@pulsesync/yamusic-types 0.0.3 → 0.0.5

package/README.md

@@ -12,6 +12,20 @@ import type { PulseSyncApi, SonataState } from '@pulsesync/yamusic-types'
 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 не обрабатывается.
+
+Promise возвращает `true` при подтверждении и `false` при отмене, закрытии крестиком, Escape или клике снаружи. В SDK используйте `api.modals.alert(options)` / `api.modals.confirm(options)`: WebHost привязывает диалог к аддону и отменяет ожидание при его отключении. Незавершённые диалоги разных аддонов образуют очередь; второй одновременный вызов одного аддона отклоняется.
+
 ## Разработка
 
 ```bash

package/dist/index.d.ts

@@ -17,6 +17,56 @@ export interface PulseSyncTrackSelector {
     from?: string;
     position?: 'next' | 'last' | string;
 }
+export interface PulseSyncToastOptions {
+    durationMs?: number;
+}
+export interface NotificationOptions {
+    durationMs?: number;
+    icon?: string;
+    coverUrl?: string;
+    link?: {
+        label: string;
+        href: string;
+    };
+}
+export interface ModalOptions {
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+export type NativeField = {
+    name: string;
+    label: string;
+    disabled?: boolean;
+    required?: boolean;
+} & ({
+    type: 'text';
+    value?: string;
+    placeholder?: string;
+    minLength?: number;
+    maxLength?: number;
+} | {
+    type: 'switch';
+    value?: boolean;
+} | {
+    type: 'slider';
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+} | {
+    type: 'select';
+    value?: string;
+    options: readonly {
+        value: string;
+        label: string;
+    }[];
+});
+export type FormValues = Record<string, string | boolean | number>;
+export interface FormModalOptions extends ModalOptions {
+    fields: readonly NativeField[];
+}
 export interface PulseSyncTrackArtist {
     id?: string | number;
     name?: string;
@@ -320,11 +370,16 @@ export interface PulseSyncApi {
     getDisplayMaxFps: () => number;
     getPlatform: () => string;
     getPremiumStatus: () => Promise<boolean>;
+    showToast: (message: string, options?: PulseSyncToastOptions, ownerId?: string) => Promise<void>;
+    showNotification: (message: string, kind: 'info' | 'error', options?: NotificationOptions, ownerId?: string) => Promise<void>;
+    showModal: (kind: 'alert' | 'confirm', options: ModalOptions, ownerId?: string, requestId?: string) => Promise<boolean>;
+    closeModal: (requestId: string, ownerId?: string) => Promise<boolean>;
+    showFormModal: (options: FormModalOptions, ownerId?: string, requestId?: string) => Promise<FormValues | null>;
     refreshPlayerBar: () => void;
     getSettings: <TSettings extends AddonSettings = AddonSettings>(addonId: string) => AddonSettingsStore<TSettings>;
 }
 export declare const PULSESYNC_WEB_HOST_API_VERSION: 1;
-export declare const PULSESYNC_WEB_HOST_API_V1_RPC_METHODS: readonly ["playVibe", "play", "pause", "togglePlayPause", "next", "previous", "setRepeatMode", "toggleShuffle", "setVolume", "setProgress", "playTrackById", "playPlaylistById", "addTrackToQueueById", "likeTrack", "unlikeTrack", "dislikeTrack", "undislikeTrack", "isTrackLiked", "isTrackDisliked", "isPlaying", "getPlayerSnapshot", "getQueueSnapshot", "getRouteSnapshot", "getCurrentTrack", "getQueue", "getProgress", "getDuration", "getVolume", "getRepeatMode", "isShuffle", "getDisplayMaxFps", "getPlatform", "getPremiumStatus", "refreshPlayerBar", "getPageEntity", "setTrackReplacement", "setTrackReplacements", "removeTrackReplacement", "clearTrackReplacements"];
+export declare const PULSESYNC_WEB_HOST_API_V1_RPC_METHODS: readonly ["playVibe", "play", "pause", "togglePlayPause", "next", "previous", "setRepeatMode", "toggleShuffle", "setVolume", "setProgress", "playTrackById", "playPlaylistById", "addTrackToQueueById", "likeTrack", "unlikeTrack", "dislikeTrack", "undislikeTrack", "isTrackLiked", "isTrackDisliked", "isPlaying", "getPlayerSnapshot", "getQueueSnapshot", "getRouteSnapshot", "getCurrentTrack", "getQueue", "getProgress", "getDuration", "getVolume", "getRepeatMode", "isShuffle", "getDisplayMaxFps", "getPlatform", "getPremiumStatus", "showToast", "showNotification", "showModal", "closeModal", "showFormModal", "refreshPlayerBar", "getPageEntity", "setTrackReplacement", "setTrackReplacements", "removeTrackReplacement", "clearTrackReplacements"];
 export type PulseSyncWebHostApiV1RpcMethod = (typeof PULSESYNC_WEB_HOST_API_V1_RPC_METHODS)[number];
 export type PulseSyncWebHostRpcApiV1 = {
     readonly [TMethod in PulseSyncWebHostApiV1RpcMethod]: PulseSyncApi[TMethod] extends (...args: infer TArgs) => infer TResult ? (...args: TArgs) => Promise<Awaited<TResult>> : never;

package/dist/index.js

@@ -33,6 +33,11 @@ export const PULSESYNC_WEB_HOST_API_V1_RPC_METHODS = Object.freeze([
     'getDisplayMaxFps',
     'getPlatform',
     'getPremiumStatus',
+    'showToast',
+    'showNotification',
+    'showModal',
+    'closeModal',
+    'showFormModal',
     'refreshPlayerBar',
     'getPageEntity',
     'setTrackReplacement',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulsesync/yamusic-types",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "TypeScript declaration package for PulseSync YaMusic addon development",
   "license": "GPL-3.0-or-later",
   "type": "module",
@@ -23,13 +23,14 @@
     "LICENSE"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",
     "pack": "npm run build && npm pack --cache ./.npm-cache",
-    "publish:public": "npm run build && dotenv -e .env -- npm publish --access public --cache ./.npm-cache"
+    "publish:public": "yarn run check && yarn build && npm publish --access public --registry=https://registry.npmjs.org/ --cache ./.npm-cache"
   },
   "devDependencies": {
     "dotenv-cli": "^11.0.0",