Update docs

Author: nukeop

.github/copilot-instructions.md

@@ -90,6 +90,7 @@ pnpm storybook      # run Storybook
 - Snapshot tests: **basic rendering only**. Start names with `(Snapshot)`.
 - Extract DOM querying into wrappers; assertions stay in tests.
 - Coverage: enabled across packages with V8-based coverage and CI reporting.
+- Use the test runner tool instead of running tests in the terminal manually.
 
 ### Design & UX Philosophy
 
@@ -109,4 +110,5 @@ pnpm storybook      # run Storybook
 - Treat this as **production code from day one**. No shortcuts, no placeholders.
 - Prioritize long-term maintainability.
 - Work with me iteratively: pause, summarize, ask.
-- Above all: **be reliable, disciplined, and clear.**
+- Above all: **be reliable, disciplined, and clear.**
+- Use Serena tools wherever possible for searches, lookups, replacements, and file operations.

packages/docs/SUMMARY.md

@@ -6,6 +6,7 @@
 * [Plugin system](plugins/plugin-system.md)
 * [Settings](plugins/settings.md)
 * [Queue](plugins/queue.md)
+* [Providers](plugins/providers.md)
 
 ## Theming
 

packages/docs/plugins/providers.md

@@ -0,0 +1,28 @@
+---
+description: Extend Nuclear with custom metadata providers through the Providers API.
+---
+
+# Providers
+
+## Providers API for Plugins
+
+The Providers API allows plugins to register custom providers that supply metadata for tracks, albums, and artists. This enables Nuclear to integrate with any music service or database.
+
+{% hint style="info" %}
+Access providers via `NuclearAPI.Providers.*` in your plugin's lifecycle hooks. Only metadata providers are supported.
+{% endhint %}
+
+---
+
+## Core concepts
+
+### What are providers?
+
+Providers are modules that fulfill specific data requests from Nuclear. When the app needs information (like album art, track metadata, or artist details), it queries the selected provider.
+
+### Provider types
+
+**Metadata Providers** (current)
+- Supply information about tracks, albums, and artists
+- Examples: MusicBrainz, Last.fm, Discogs
+- Used for search, library management, and display

packages/docs/themes/themes-advanced.md

@@ -41,10 +41,11 @@ Here's the basic structure to get you started:
 
 **Typography**
 - font-family (example: "'Inter', system-ui, -apple-system, sans-serif")
-- font-weight-normal, font-weight-bold
+- font-family-heading
+- font-weight-normal, font-weight-bold, font-weight-extra-bold
 
 **Shape & visual effects**
-- radius, radius-sm, radius-lg
+- radius-sm, radius-md, radius-lg
 - shadow-color, shadow-x, shadow-y, shadow-blur
 
 ## A few helpful notes
@@ -90,11 +91,13 @@ Here's a complete template with Nuclear's default values that you can copy and c
     "shadow-blur": "0px",
 
     "font-family": "'DM Sans', system-ui, -apple-system, sans-serif",
+    "font-family-heading": "'Bricolage Grotesque', 'DM Sans', system-ui, sans-serif",
     "font-weight-normal": "400",
     "font-weight-bold": "700",
+    "font-weight-extra-bold": "800",
 
-    "radius": "8px",
     "radius-sm": "4px",
+    "radius-md": "8px",
     "radius-lg": "12px"
   },
   "dark": {

packages/player/src/integration-tests/settings.test.tsx

@@ -43,22 +43,15 @@ describe('Settings integration', () => {
     );
     const api = new NuclearAPI({ settingsHost: pluginHost });
 
-    await api.Settings.register(
-      [
-        {
-          id: 'example.enabled',
-          category: 'Example',
-          title: 'Enabled',
-          kind: 'boolean',
-          default: true,
-        },
-      ],
+    await api.Settings.register([
       {
-        type: 'plugin',
-        pluginId: 'itest',
-        pluginName: 'Integration Test Plugin',
+        id: 'example.enabled',
+        category: 'Example',
+        title: 'Enabled',
+        kind: 'boolean',
+        default: true,
       },
-    );
+    ]);
 
     const definitions = useSettingsStore.getState().definitions;
     expect(definitions['plugin.itest.example.enabled']).toBeTruthy();
@@ -74,18 +67,15 @@ describe('Settings integration', () => {
     );
     const api = new NuclearAPI({ settingsHost: pluginHost });
 
-    await api.Settings.register(
-      [
-        {
-          id: 'example.enabled',
-          category: 'Example',
-          title: 'Enabled',
-          kind: 'boolean',
-          default: false,
-        },
-      ],
-      { type: 'plugin', pluginId: 'itest' },
-    );
+    await api.Settings.register([
+      {
+        id: 'example.enabled',
+        category: 'Example',
+        title: 'Enabled',
+        kind: 'boolean',
+        default: false,
+      },
+    ]);
 
     const initial = await api.Settings.get<boolean>('example.enabled');
     expect(initial).toBe(false);

packages/player/src/services/settingsHost.ts

@@ -20,11 +20,7 @@ export const createPluginSettingsHost = (
 ): SettingsHost => {
   const pluginSource: SettingSource = { type: 'plugin', pluginId, pluginName };
   return {
-    register: async (
-      definitions: SettingDefinition[],
-      _source: SettingSource,
-    ) => {
-      void _source;
+    register: async (definitions: SettingDefinition[]) => {
       const registeredIds = useSettingsStore
         .getState()
         .register(definitions, pluginSource);
@@ -64,7 +60,7 @@ export const createPluginSettingsHost = (
 export const createCoreSettingsHost = (): SettingsHost => {
   const coreSource: SettingSource = { type: 'core' };
   return {
-    register: async (definitions) => {
+    register: async (definitions: SettingDefinition[]) => {
       const registeredIds = useSettingsStore
         .getState()
         .register(definitions, coreSource);

packages/player/src/stores/settingsStore.test.ts

@@ -78,31 +78,25 @@ describe('useSettingsStore', () => {
       const hostA = createPluginSettingsHost('p1', 'Plugin One');
       const hostB = createPluginSettingsHost('p2', 'Plugin Two');
 
-      await hostA.register(
-        [
-          {
-            id: 'feature.enabled',
-            title: 'Enabled',
-            category: 'Example',
-            kind: 'boolean',
-            default: false,
-          },
-        ],
-        { type: 'plugin', pluginId: 'p1' },
-      );
+      await hostA.register([
+        {
+          id: 'feature.enabled',
+          title: 'Enabled',
+          category: 'Example',
+          kind: 'boolean',
+          default: false,
+        },
+      ]);
 
-      await hostB.register(
-        [
-          {
-            id: 'feature.enabled',
-            title: 'Enabled',
-            category: 'Example',
-            kind: 'boolean',
-            default: true,
-          },
-        ],
-        { type: 'plugin', pluginId: 'p2' },
-      );
+      await hostB.register([
+        {
+          id: 'feature.enabled',
+          title: 'Enabled',
+          category: 'Example',
+          kind: 'boolean',
+          default: true,
+        },
+      ]);
 
       expect(
         useSettingsStore.getState().definitions['plugin.p1.feature.enabled'],

packages/plugin-sdk/src/api/settings.test.ts

@@ -19,10 +19,7 @@ describe('Settings (SDK)', () => {
       },
     ];
 
-    const res = await api.Settings.register(definitions, {
-      type: 'plugin',
-      pluginId: 'p1',
-    });
+    const res = await api.Settings.register(definitions);
     expect(res.registered).toContain('plugin.p1.feature.enabled');
 
     const initial = await api.Settings.get<boolean>('feature.enabled');
@@ -50,7 +47,7 @@ describe('Settings (SDK)', () => {
     expect(() => api.Settings.set('x', 'y')).toThrow(
       'Settings host not available',
     );
-    expect(() => api.Settings.register([], { type: 'core' })).toThrow(
+    expect(() => api.Settings.register([])).toThrow(
       'Settings host not available',
     );
     expect(() => api.Settings.subscribe('x', () => {})).toThrow(

packages/plugin-sdk/src/api/settings.ts

@@ -1,7 +1,6 @@
 import type {
   SettingDefinition,
   SettingsHost,
-  SettingSource,
   SettingValue,
 } from '../types/settings';
 
@@ -20,8 +19,8 @@ export class Settings {
     return fn(host);
   }
 
-  register(defs: SettingDefinition[], source: SettingSource) {
-    return this.#withHost((h) => h.register(defs, source));
+  register(defs: SettingDefinition[]) {
+    return this.#withHost((h) => h.register(defs));
   }
 
   get<T extends SettingValue = SettingValue>(id: string) {

packages/plugin-sdk/src/test/utils/inMemorySettingsHost.ts

@@ -25,8 +25,7 @@ export class InMemorySettingsHost implements SettingsHost {
     return `core.${id}`;
   }
 
-  async register(definitions: SettingDefinition[], _source: SettingSource) {
-    void _source;
+  async register(definitions: SettingDefinition[]) {
     const registered: string[] = [];
     for (const definition of definitions) {
       const fullyQualifiedId = this.fullyQualified(definition.id);