@pulsesync/addon-sdk 0.1.0

package/README.md

@@ -0,0 +1,119 @@
+# PulseSync Addon SDK
+
+Публичный TypeScript/React SDK для аддонов, которые запускаются через PulseSync WebHost.
+
+WebHost владеет единственным React root и предоставляет аддонам React `19.2.4`. Аддон экспортирует компоненты и не вызывает `createRoot()` самостоятельно.
+
+## Установка
+
+```bash
+npm install @pulsesync/addon-sdk react@19.2.4
+npm install -D vite @vitejs/plugin-react typescript @types/react
+```
+
+## Обычный компонент
+
+```tsx
+import { defineAddon } from '@pulsesync/addon-sdk'
+
+function App() {
+    return <div>PulseSync addon</div>
+}
+
+export default defineAddon({
+    id: 'example-addon',
+    name: 'Example Addon',
+    component: App,
+})
+```
+
+## Стандартные точки интерфейса
+
+Имена slots задаёт WebHost. Аддон только отдаёт React-компонент для нужной точки.
+
+```tsx
+export default defineAddon({
+    id: 'player-actions',
+    slots: {
+        playerBarButton: PlayerButton,
+        contextMenuActions: ContextMenuActions,
+    },
+})
+```
+
+## Произвольная точка
+
+Если стандартного slot нет, автор может указать DOM-цель самостоятельно.
+
+```tsx
+export default defineAddon({
+    id: 'custom-target',
+    mounts: [
+        {
+            target: '[data-test-id="PLAYERBAR_DESKTOP"]',
+            component: PlayerButton,
+        },
+    ],
+})
+```
+
+`target` также принимает `Element`, функцию `() => Element | null`, `{ selector }` или `{ slot }`.
+
+## Lifecycle
+
+```tsx
+export default defineAddon({
+    id: 'lifecycle-example',
+    start(api) {
+        api.logger.info('Started')
+        return () => api.logger.info('Start cleanup')
+    },
+    stop(api) {
+        api.logger.info('Stopped')
+    },
+})
+```
+
+## Настройки
+
+Схема живёт рядом с кодом аддона и остаётся типизированной:
+
+```tsx
+import { defineSettings, type PulseSyncAddonComponentProps } from '@pulsesync/addon-sdk'
+
+export const settings = defineSettings({
+    enabled: {
+        type: 'boolean',
+        name: 'Включить аддон',
+        default: true,
+    },
+})
+
+function App({ api }: PulseSyncAddonComponentProps) {
+    const { enabled } = settings.use(api)
+    return enabled ? <div>PulseSync addon</div> : null
+}
+```
+
+Передай `settings` в `pulseSyncAddon({ manifest, settings })`. Сборщик запишет схему в `metadata.json`; отдельный `handleEvents.json` для WebHost-аддона не нужен.
+
+## Vite
+
+```ts
+import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
+import { defineAddonManifest, pulseSyncAddon } from '@pulsesync/addon-sdk/vite'
+
+const manifest = defineAddonManifest({
+    id: 'example-addon',
+    directoryName: 'example-addon',
+    name: 'Example Addon',
+    version: '0.1.0',
+})
+
+export default defineConfig({
+    plugins: [react(), pulseSyncAddon({ manifest })],
+})
+```
+
+Плагин собирает `script.js`, `script.css` и `metadata.json`, помечает аддон как `web-addon`, исключает React из бандла и запрещает импорт `react-dom`.

package/dist/defineAddon.d.ts

@@ -0,0 +1,4 @@
+import type { PulseSyncAddonDefinition, PulseSyncAddonOptions } from './types.js';
+export declare function defineAddon(options: PulseSyncAddonOptions): PulseSyncAddonDefinition;
+export default defineAddon;
+//# sourceMappingURL=defineAddon.d.ts.map

package/dist/defineAddon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineAddon.d.ts","sourceRoot":"","sources":["../src/defineAddon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGR,wBAAwB,EAExB,qBAAqB,EAExB,MAAM,YAAY,CAAA;AAkCnB,wBAAgB,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,wBAAwB,CAcpF;eAEc,WAAW"}

package/dist/defineAddon.js

@@ -0,0 +1,49 @@
+import { PULSESYNC_WEB_HOST_API_VERSION } from './version.js';
+function normalizeId(id) {
+    const normalizedId = String(id ?? '').trim();
+    if (!normalizedId)
+        throw new TypeError('PulseSync addon id is required');
+    return normalizedId;
+}
+function createActivation(options) {
+    if (!options.start && !options.stop)
+        return undefined;
+    return (api) => {
+        const cleanup = options.start?.(api);
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            try {
+                if (typeof cleanup === 'function')
+                    cleanup();
+            }
+            finally {
+                options.stop?.(api);
+            }
+        };
+    };
+}
+function enqueue(factory) {
+    if (typeof window === 'undefined')
+        return;
+    const queue = (window.__PULSESYNC_ADDON_QUEUE__ ??= []);
+    queue.push(factory);
+}
+export function defineAddon(options) {
+    const activate = createActivation(options);
+    const definition = Object.freeze({
+        id: normalizeId(options.id),
+        apiVersion: PULSESYNC_WEB_HOST_API_VERSION,
+        ...(options.name ? { name: options.name } : {}),
+        ...(options.component ? { component: options.component } : {}),
+        ...(options.slots ? { slots: Object.freeze({ ...options.slots }) } : {}),
+        ...(options.mounts ? { mounts: Object.freeze([...options.mounts]) } : {}),
+        ...(activate ? { activate } : {}),
+    });
+    enqueue((_host) => definition);
+    return definition;
+}
+export default defineAddon;
+//# sourceMappingURL=defineAddon.js.map

package/dist/defineAddon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineAddon.js","sourceRoot":"","sources":["../src/defineAddon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA;AAU7D,SAAS,WAAW,CAAC,EAAU;IAC3B,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5C,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAA;IACxE,OAAO,YAAY,CAAA;AACvB,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA8B;IACpD,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAErD,OAAO,CAAC,GAAsB,EAAyB,EAAE;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;QACpC,IAAI,MAAM,GAAG,IAAI,CAAA;QAEjB,OAAO,GAAG,EAAE;YACR,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,MAAM,GAAG,KAAK,CAAA;YAEd,IAAI,CAAC;gBACD,IAAI,OAAO,OAAO,KAAK,UAAU;oBAAE,OAAO,EAAE,CAAA;YAChD,CAAC;oBAAS,CAAC;gBACP,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;YACvB,CAAC;QACL,CAAC,CAAA;IACL,CAAC,CAAA;AACL,CAAC;AAED,SAAS,OAAO,CAAC,OAA8B;IAC3C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAM;IACzC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAA;IACvD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA8B;IACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC1C,MAAM,UAAU,GAA6B,MAAM,CAAC,MAAM,CAAC;QACvD,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,UAAU,EAAE,8BAA8B;QAC1C,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC,CAAA;IAEF,OAAO,CAAC,CAAC,KAA0B,EAAE,EAAE,CAAC,UAAU,CAAC,CAAA;IACnD,OAAO,UAAU,CAAA;AACrB,CAAC;AAED,eAAe,WAAW,CAAA"}

package/dist/globals.d.ts

@@ -0,0 +1,9 @@
+import type { PulseSyncAddonFactory, PulseSyncWebHostApi } from './types.js';
+declare global {
+    interface Window {
+        __PULSESYNC_WEB_HOST__?: PulseSyncWebHostApi;
+        __PULSESYNC_ADDON_QUEUE__?: PulseSyncAddonFactory[];
+    }
+}
+export {};
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAE5E,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,sBAAsB,CAAC,EAAE,mBAAmB,CAAA;QAC5C,yBAAyB,CAAC,EAAE,qBAAqB,EAAE,CAAA;KACtD;CACJ;AAED,OAAO,EAAE,CAAA"}

package/dist/globals.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=globals.js.map

package/dist/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import './globals.js';
+export { default, defineAddon } from './defineAddon.js';
+export { defineSettings } from './settings.js';
+export { PULSESYNC_WEB_HOST_API_VERSION } from './version.js';
+export type { AddonSettings, AddonSettingsStore, AddonSettingValue, PulseSyncApi } from '@pulsesync/yamusic-types';
+export type { PulseSyncAddonApi, PulseSyncAddonCleanup, PulseSyncAddonComponent, PulseSyncAddonComponentProps, PulseSyncAddonDefinition, PulseSyncAddonFactory, PulseSyncAddonLogger, PulseSyncAddonMount, PulseSyncAddonMountTarget, PulseSyncAddonOptions, PulseSyncWebHostApi, } from './types.js';
+export type { DefineSettingsOptions, InferPulseSyncSettings, PulseSyncSetting, PulseSyncSettingsConfig, PulseSyncSettingsDefinition, PulseSyncSettingsSchema, } from './settings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAA;AAErB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA;AAC7D,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAClH,YAAY,EACR,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,YAAY,CAAA;AACnB,YAAY,EACR,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import './globals.js';
+export { default, defineAddon } from './defineAddon.js';
+export { defineSettings } from './settings.js';
+export { PULSESYNC_WEB_HOST_API_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAA;AAErB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA"}

package/dist/settings.d.ts

@@ -0,0 +1,39 @@
+import type { PulseSyncAddonApi } from './types.js';
+type SettingBase<TType extends string, TValue> = {
+    readonly type: TType;
+    readonly name: string;
+    readonly description?: string;
+    readonly default: TValue;
+};
+export type PulseSyncSetting = SettingBase<'boolean', boolean> | SettingBase<'color', string> | SettingBase<'text', string> | SettingBase<'file', string> | (SettingBase<'number', number> & {
+    readonly min: number;
+    readonly max: number;
+    readonly step?: number;
+}) | (SettingBase<'select', string | number> & {
+    readonly options: readonly {
+        readonly label: string;
+        readonly value: string | number;
+    }[];
+});
+export type PulseSyncSettingsSchema = Readonly<Record<string, PulseSyncSetting>>;
+export type InferPulseSyncSettings<TSchema extends PulseSyncSettingsSchema> = {
+    readonly [TKey in keyof TSchema]: TSchema[TKey]['default'];
+};
+export type PulseSyncSettingsConfig = {
+    readonly sections: readonly {
+        readonly title: string;
+        readonly items: readonly Record<string, unknown>[];
+    }[];
+};
+export type PulseSyncSettingsDefinition<TSchema extends PulseSyncSettingsSchema = PulseSyncSettingsSchema> = {
+    readonly schema: TSchema;
+    readonly defaults: InferPulseSyncSettings<TSchema>;
+    use: (api: PulseSyncAddonApi) => InferPulseSyncSettings<TSchema>;
+    toConfig: () => PulseSyncSettingsConfig;
+};
+export type DefineSettingsOptions = {
+    readonly title?: string;
+};
+export declare function defineSettings<const TSchema extends PulseSyncSettingsSchema>(schema: TSchema, options?: DefineSettingsOptions): PulseSyncSettingsDefinition<TSchema>;
+export {};
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,KAAK,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,MAAM,IAAI;IAC7C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,gBAAgB,GACtB,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,GAC/B,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GAC5B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACzB,CAAC,GACF,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;KAClC,EAAE,CAAA;CACN,CAAC,CAAA;AAER,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAEhF,MAAM,MAAM,sBAAsB,CAAC,OAAO,SAAS,uBAAuB,IAAI;IAC1E,QAAQ,EAAE,IAAI,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;CAC7D,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KACrD,EAAE,CAAA;CACN,CAAA;AAED,MAAM,MAAM,2BAA2B,CAAC,OAAO,SAAS,uBAAuB,GAAG,uBAAuB,IAAI;IACzG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAClD,GAAG,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,sBAAsB,CAAC,OAAO,CAAC,CAAA;IAChE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAoDD,wBAAgB,cAAc,CAAC,KAAK,CAAC,OAAO,SAAS,uBAAuB,EACxE,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,qBAA0B,GACpC,2BAA2B,CAAC,OAAO,CAAC,CA6BtC"}

package/dist/settings.js

@@ -0,0 +1,68 @@
+import { useEffect, useState } from 'react';
+function readSettingValue(entry, fallback) {
+    if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
+        const setting = entry;
+        if (typeof setting.value !== 'undefined')
+            return setting.value;
+        if (typeof setting.default !== 'undefined')
+            return setting.default;
+    }
+    return typeof entry === 'undefined' ? fallback : entry;
+}
+function createDefaults(schema) {
+    return Object.fromEntries(Object.entries(schema).map(([id, setting]) => [id, setting.default]));
+}
+function resolveValues(schema, current) {
+    return Object.fromEntries(Object.entries(schema).map(([id, setting]) => [id, readSettingValue(current[id], setting.default)]));
+}
+function settingToConfig(id, setting) {
+    const common = {
+        id,
+        name: setting.name,
+        ...(setting.description ? { description: setting.description } : {}),
+        value: setting.default,
+        defaultValue: setting.default,
+    };
+    switch (setting.type) {
+        case 'boolean':
+            return { ...common, type: 'button' };
+        case 'number':
+            return { ...common, type: 'slider', min: setting.min, max: setting.max, step: setting.step ?? 1 };
+        case 'select':
+            return {
+                ...common,
+                type: 'selector',
+                options: Object.fromEntries(setting.options.map(option => [String(option.value), { event: String(option.value), name: option.label }])),
+            };
+        default:
+            return { ...common, type: setting.type };
+    }
+}
+export function defineSettings(schema, options = {}) {
+    const defaults = Object.freeze(createDefaults(schema));
+    const frozenSchema = Object.freeze({ ...schema });
+    return Object.freeze({
+        schema: frozenSchema,
+        defaults,
+        use(api) {
+            const [values, setValues] = useState(defaults);
+            useEffect(() => {
+                const store = api.pulsesyncApi?.getSettings(api.addonId);
+                if (!store)
+                    return;
+                setValues(resolveValues(frozenSchema, store.getCurrent()));
+                return store.onChange(current => setValues(resolveValues(frozenSchema, current)));
+            }, [api]);
+            return values;
+        },
+        toConfig: () => ({
+            sections: [
+                {
+                    title: options.title ?? 'Settings',
+                    items: Object.entries(frozenSchema).map(([id, setting]) => settingToConfig(id, setting)),
+                },
+            ],
+        }),
+    });
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+import type { ComponentType } from 'react';
+import type { PulseSyncApi } from '@pulsesync/yamusic-types';
+export type PulseSyncAddonCleanup = () => void;
+export type PulseSyncAddonLogger = {
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+export type PulseSyncAddonApi = {
+    readonly addonId: string;
+    readonly pulsesyncApi: PulseSyncApi | undefined;
+    readonly logger: PulseSyncAddonLogger;
+};
+export type PulseSyncAddonComponentProps = {
+    readonly addonId: string;
+    readonly api: PulseSyncAddonApi;
+};
+export type PulseSyncAddonComponent = ComponentType<PulseSyncAddonComponentProps>;
+export type PulseSyncAddonMountTarget = Element | string | (() => Element | null) | {
+    readonly selector: string;
+} | {
+    readonly slot: string;
+};
+export type PulseSyncAddonMount = {
+    readonly target: PulseSyncAddonMountTarget;
+    readonly component: PulseSyncAddonComponent;
+};
+export type PulseSyncAddonOptions = {
+    readonly id: string;
+    readonly name?: string;
+    readonly component?: PulseSyncAddonComponent;
+    readonly slots?: Readonly<Record<string, PulseSyncAddonComponent>>;
+    readonly mounts?: readonly PulseSyncAddonMount[];
+    readonly start?: (api: PulseSyncAddonApi) => void | PulseSyncAddonCleanup;
+    readonly stop?: (api: PulseSyncAddonApi) => void;
+};
+export type PulseSyncAddonDefinition = Omit<PulseSyncAddonOptions, 'start' | 'stop'> & {
+    readonly apiVersion: number;
+    readonly activate?: (api: PulseSyncAddonApi) => void | PulseSyncAddonCleanup;
+};
+export type PulseSyncAddonFactory = (host: PulseSyncWebHostApi) => void | PulseSyncAddonDefinition | Promise<void | PulseSyncAddonDefinition>;
+export type PulseSyncWebHostApi = {
+    readonly apiVersion: number;
+    readonly React: typeof import('react');
+    readonly jsxRuntime: typeof import('react/jsx-runtime');
+    readonly jsxDevRuntime?: typeof import('react/jsx-dev-runtime');
+    installAddon: (factory: PulseSyncAddonFactory) => Promise<PulseSyncAddonCleanup | undefined>;
+    registerAddon: (definition: PulseSyncAddonDefinition) => PulseSyncAddonCleanup;
+    unregisterAddon: (addonId: string) => boolean;
+    getPulseSyncApi: () => PulseSyncApi | undefined;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const PULSESYNC_WEB_HOST_API_VERSION: 1;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAA"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const PULSESYNC_WEB_HOST_API_VERSION = 1;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAA"}

package/dist/vite.d.ts

@@ -0,0 +1,31 @@
+import type { Plugin } from 'vite';
+import type { PulseSyncSettingsDefinition } from './settings.js';
+export type PulseSyncAddonManifest = {
+    readonly id: string;
+    readonly directoryName: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly version: string;
+    readonly author?: string | readonly string[];
+    readonly image?: string;
+    readonly banner?: string;
+    readonly libraryLogo?: string;
+    readonly tags?: readonly string[];
+    readonly dependencies?: readonly string[];
+    readonly allowedUrls?: readonly string[];
+    readonly supportedVersions?: readonly string[];
+};
+export type PulseSyncAddonViteOptions = {
+    readonly manifest: PulseSyncAddonManifest;
+    readonly settings?: PulseSyncSettingsDefinition;
+    readonly entry?: string;
+    readonly staticDir?: string | false;
+    readonly outDir?: string;
+    readonly globalName?: string;
+    readonly minify?: boolean | 'esbuild' | 'oxc' | 'terser';
+    readonly sourcemap?: boolean;
+    readonly target?: string;
+};
+export declare function defineAddonManifest<const T extends PulseSyncAddonManifest>(manifest: T): T;
+export declare function pulseSyncAddon(options: PulseSyncAddonViteOptions): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,MAAM,CAAA;AAE9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAEhE,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjD,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAA;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAA;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,sBAAsB,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAE1F;AA2BD,wBAAgB,cAAc,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CA8EzE"}

package/dist/vite.js

@@ -0,0 +1,98 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+export function defineAddonManifest(manifest) {
+    return manifest;
+}
+function cleanManifestValue(value) {
+    if (Array.isArray(value))
+        return value.map(item => String(item).trim()).filter(Boolean);
+    return typeof value === 'string' ? value.trim() : '';
+}
+function createMetadata(manifest) {
+    return {
+        id: manifest.id,
+        name: manifest.name,
+        description: manifest.description ?? '',
+        version: manifest.version,
+        author: cleanManifestValue(manifest.author),
+        type: 'web-addon',
+        image: manifest.image ?? '',
+        banner: manifest.banner ?? '',
+        libraryLogo: manifest.libraryLogo ?? '',
+        css: 'script.css',
+        script: 'script.js',
+        tags: manifest.tags ?? [],
+        dependencies: manifest.dependencies ?? [],
+        allowedUrls: manifest.allowedUrls ?? [],
+        supportedVersions: manifest.supportedVersions ?? [],
+    };
+}
+export function pulseSyncAddon(options) {
+    let resolvedConfig;
+    let outputDirectory = '';
+    return {
+        name: 'pulsesync-addon',
+        enforce: 'pre',
+        config(currentConfig) {
+            const root = path.resolve(currentConfig.root ?? process.cwd());
+            outputDirectory = options.outDir
+                ? path.resolve(root, options.outDir)
+                : path.resolve(root, 'dist', options.manifest.directoryName);
+            return {
+                build: {
+                    target: options.target ?? 'chrome140',
+                    outDir: outputDirectory,
+                    emptyOutDir: true,
+                    minify: options.minify ?? 'oxc',
+                    sourcemap: options.sourcemap ?? false,
+                    cssCodeSplit: false,
+                    lib: {
+                        entry: path.resolve(root, options.entry ?? 'src/main.tsx'),
+                        formats: ['iife'],
+                        name: options.globalName ?? 'PulseSyncAddon',
+                        fileName: () => 'script.js',
+                        cssFileName: 'script',
+                    },
+                    rollupOptions: {
+                        external: ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime'],
+                        output: {
+                            globals: {
+                                react: 'window.__PULSESYNC_WEB_HOST__.React',
+                                'react/jsx-runtime': 'window.__PULSESYNC_WEB_HOST__.jsxRuntime',
+                                'react/jsx-dev-runtime': 'window.__PULSESYNC_WEB_HOST__.jsxDevRuntime',
+                            },
+                            assetFileNames: assetInfo => assetInfo.names.some(name => name.endsWith('.css')) ? '[name][extname]' : 'Assets/[name][extname]',
+                        },
+                    },
+                },
+            };
+        },
+        configResolved(config) {
+            resolvedConfig = config;
+            outputDirectory ||= path.resolve(config.root, 'dist', options.manifest.directoryName);
+        },
+        resolveId(source) {
+            if (source === 'react-dom' || source.startsWith('react-dom/')) {
+                throw new Error('PulseSync WebHost owns the React root. Export components from defineAddon instead of importing react-dom.');
+            }
+        },
+        async closeBundle() {
+            await fs.mkdir(outputDirectory, { recursive: true });
+            if (options.staticDir !== false) {
+                const staticDirectory = path.resolve(resolvedConfig.root, options.staticDir ?? 'addon');
+                try {
+                    await fs.cp(staticDirectory, outputDirectory, { recursive: true, force: true });
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                }
+            }
+            await fs.writeFile(path.join(outputDirectory, 'metadata.json'), `${JSON.stringify({
+                ...createMetadata(options.manifest),
+                ...(options.settings ? { settings: options.settings.toConfig() } : {}),
+            }, null, 4)}\n`, 'utf8');
+        },
+    };
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+    "name": "@pulsesync/addon-sdk",
+    "version": "0.1.0",
+    "description": "Public SDK for building PulseSync WebHost addons",
+    "license": "GPL-3.0-or-later",
+    "type": "module",
+    "sideEffects": false,
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./vite": {
+            "types": "./dist/vite.d.ts",
+            "import": "./dist/vite.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "check": "tsc -p tsconfig.json --noEmit",
+        "lint": "oxlint src",
+        "pack:local": "npm run build && npm pack",
+        "prepublishOnly": "npm run check && npm run lint && npm run build"
+    },
+    "dependencies": {
+        "@pulsesync/yamusic-types": "^0.0.1"
+    },
+    "peerDependencies": {
+        "react": "19.2.4",
+        "vite": "^8.2.0"
+    },
+    "peerDependenciesMeta": {
+        "vite": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@types/node": "26.1.2",
+        "@types/react": "19.2.17",
+        "oxlint": "1.76.0",
+        "react": "19.2.4",
+        "typescript": "7.0.2",
+        "vite": "8.2.0"
+    },
+    "engines": {
+        "node": ">=20"
+    },
+    "keywords": [
+        "pulsesync",
+        "addon",
+        "plugin",
+        "react",
+        "sdk"
+    ]
+}