@pulsesync/yamusic-types 0.0.5 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 PulseSync
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 PulseSync
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,12 @@
-# `@pulsesync/yamusic-types`
+# @pulsesync/yamusic-types
 
-TypeScript declaration package for PulseSync YaMusic addons.
+Типы TypeScript для API PulseSync и Яндекс Музыки. Для React-аддонов WebHost используйте [@pulsesync/addon-sdk](https://www.npmjs.com/package/@pulsesync/addon-sdk).
+
+## Установка
+
+```bash
+yarn add --dev @pulsesync/yamusic-types
+```
 
 ## Использование
 
@@ -8,36 +14,22 @@ TypeScript declaration package for PulseSync YaMusic addons.
 import type { PulseSyncApi, SonataState } from '@pulsesync/yamusic-types'
 ```
 
+Для типизации глобальных объектов `window` подключите отдельный модуль:
+
 ```ts
 import '@pulsesync/yamusic-types/global'
-```
-
-## Уведомления
-
-`showToast(message, options?)` показывает верхний тост ЯМ. `showNotification(message, 'info' | 'error', options?)` использует нижние нативные контейнеры. `NotificationOptions` и `PulseSyncToastOptions` принимают `durationMs` (по умолчанию 4000, от 1500 до 10000 мс).
 
-В SDK используйте `api.toasts.show()` и `api.notifications.info()` / `error()`: WebHost сам связывает уведомления с аддоном. Нижние уведомления требуют обновлённого мода с подключёнными нативными контейнерами.
-
-`NotificationOptions` также принимает `icon` или `coverUrl` и `link: { label, href }`. Ссылки и обложки допускают HTTP(S) либо путь приложения. Для SDK имя иконки типизировано каталогом.
-
-## Модалки
-
-`showModal('alert' | 'confirm', options)` показывает нативную модалку ЯМ. `ModalOptions` содержит обязательные `title` (до 200 символов) и `message` (до 5000), а также необязательные `confirmLabel` и `cancelLabel` (до 80). В `alert` показывается одна основная кнопка, в `confirm` — основная и отмена. HTML не обрабатывается.
+const api = window.pulsesyncApi
+```
 
-Promise возвращает `true` при подтверждении и `false` при отмене, закрытии крестиком, Escape или клике снаружи. В SDK используйте `api.modals.alert(options)` / `api.modals.confirm(options)`: WebHost привязывает диалог к аддону и отменяет ожидание при его отключении. Незавершённые диалоги разных аддонов образуют очередь; второй одновременный вызов одного аддона отклоняется.
+Пакет описывает API, но не устанавливает мод и не создаёт объекты во время выполнения. Доступность методов зависит от версии PulseSync и окружения; глобальные объекты могут отсутствовать.
 
 ## Разработка
 
 ```bash
-npm install
-npm run check
-npm run build
-```
-
-## Публикация
-
-```bash
-npm run publish:public
+yarn install
+yarn run check
+yarn build
 ```
 
-Нужен `.env` с `NPM_TOKEN=...`.
+Лицензия: GPL-3.0-or-later.

package/dist/addonModules.d.ts

@@ -0,0 +1,63 @@
+export type AddonModuleKind = 'javascript' | 'wasm';
+export type AddonModuleAccess = 'public' | 'protected';
+export type AddonModuleStatus = 'draft' | 'pending' | 'accepted' | 'rejected' | 'revoked';
+export type AddonModuleChannel = 'stable' | 'dev';
+export type AddonModuleReference = Readonly<{
+    moduleId: string;
+    apiMajor: number;
+    optional?: boolean;
+} & ({
+    channel: AddonModuleChannel;
+    version?: never;
+} | {
+    version: string;
+    channel?: never;
+})>;
+export type AddonModuleReferences = Readonly<Record<string, AddonModuleReference>>;
+export type AddonModuleErrorCode = 'unsupported-host' | 'undeclared-module' | 'unavailable' | 'revoked' | 'access-denied' | 'incompatible-api' | 'integrity-mismatch' | 'aborted' | 'initialization-failed' | 'reload-required';
+export interface AddonModuleDescriptor {
+    readonly formatVersion: 1;
+    readonly moduleId: string;
+    readonly versionId: string;
+    readonly version: string;
+    readonly apiMajor: number;
+    readonly kind: AddonModuleKind;
+    readonly access: AddonModuleAccess;
+    readonly sha256: string;
+    readonly size: number;
+}
+export interface AddonModuleSecurityManifest {
+    readonly formatVersion: 1;
+    readonly runtime: 'isolated';
+    readonly kind: 'web-addon';
+    readonly apiVersion: number;
+    readonly capabilities: readonly ['modules-v1'];
+    readonly allowedUrls: readonly string[];
+    readonly modules: AddonModuleReferences;
+}
+export interface AddonModuleReleaseBinding {
+    readonly formatVersion: 1;
+    readonly catalogAddonId: string;
+    readonly releaseId: string;
+    readonly runtimeId: string;
+    readonly codeHash: string;
+    readonly manifestHash: string;
+}
+export interface AddonModuleResolution {
+    readonly activationId: string;
+    readonly releaseBinding: string;
+    readonly descriptors: Readonly<Record<string, AddonModuleDescriptor>>;
+    readonly errors: Readonly<Record<string, AddonModuleErrorCode>>;
+}
+export interface AddonModuleChallenge {
+    readonly challenge: string;
+    readonly moduleVersionId: string;
+    readonly expiresAt: number;
+}
+export interface AddonModuleLoadOptions {
+    readonly authorize?: (challenge: AddonModuleChallenge) => Promise<string>;
+}
+export interface AddonModules {
+    load<T = unknown>(alias: string, options?: AddonModuleLoadOptions): Promise<T>;
+    instantiateWasm<T = Readonly<Record<string, (...args: never[]) => unknown>>>(alias: string, options?: AddonModuleLoadOptions): Promise<T>;
+}

package/dist/addonModules.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export type * from './addonModules.js';
 export type AddonSettingValue<T> = {
     value?: T;
     default?: T;

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@pulsesync/yamusic-types",
-  "version": "0.0.5",
+  "version": "0.2.0",
   "description": "TypeScript declaration package for PulseSync YaMusic addon development",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PulseSync-LLC/PulseSync-yamusic-types.git"
+  },
   "license": "GPL-3.0-or-later",
   "type": "module",
+  "packageManager": "yarn@1.22.22",
   "sideEffects": false,
   "types": "./dist/index.d.ts",
   "exports": {