epos 1.26.0 → 1.29.0

package/dist/chrome.d.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="chrome" />
+type Chrome = typeof chrome
+
+export type { Chrome };

package/dist/epos.d.ts

@@ -5,29 +5,57 @@ import * as reactDom from 'react-dom';
 import * as reactDomClient from 'react-dom/client';
 import * as reactJsxRuntime from 'react/jsx-runtime';
 import * as yjs from 'yjs';
+import { Chrome } from './chrome.d.js';
 
 type Fn<T = any> = (...args: any[]) => T;
 type Obj = Record<string, unknown>;
+type Arr = unknown[];
 type Versioner = Record<number, (this: any, state: any) => void>;
-type ClassName = string | null | boolean | undefined | ClassName[];
 type ModelClass = new (...args: any[]) => any;
 type Model = InstanceType<ModelClass>;
 type Initial<T extends Obj | Model> = T | (() => T);
+type Attrs = Record<string, string | number>;
+type FnArgsOrArr<T> = T extends Fn ? Parameters<T> : Arr;
+type FnResultOrValue<T> = T extends Fn ? ReturnType<T> : T;
 type StateConfig = {
     allowMissingModels?: boolean | string[];
 };
-type ReqInit = Pick<RequestInit, 'body' | 'cache' | 'credentials' | 'headers' | 'integrity' | 'keepalive' | 'method' | 'mode' | 'priority' | 'redirect' | 'referrer' | 'referrerPolicy'>;
-type Res = Pick<Response, 'ok' | 'url' | 'type' | 'status' | 'statusText' | 'redirected' | 'text' | 'json' | 'blob'> & {
-    headers: Pick<Response['headers'], 'get' | 'has'> & {
+type ReqInit = {
+    body: RequestInit['body'];
+    cache: RequestInit['cache'];
+    credentials: RequestInit['credentials'];
+    headers: RequestInit['headers'];
+    integrity: RequestInit['integrity'];
+    keepalive: RequestInit['keepalive'];
+    method: RequestInit['method'];
+    mode: RequestInit['mode'];
+    priority: RequestInit['priority'];
+    redirect: RequestInit['redirect'];
+    referrer: RequestInit['referrer'];
+    referrerPolicy: RequestInit['referrerPolicy'];
+};
+type Res = {
+    ok: Response['ok'];
+    url: Response['url'];
+    type: Response['type'];
+    status: Response['status'];
+    statusText: Response['statusText'];
+    redirected: Response['redirected'];
+    text: Response['text'];
+    json: Response['json'];
+    blob: Response['blob'];
+    headers: {
+        get: Response['headers']['get'];
+        has: Response['headers']['has'];
         /** Get list of all header keys. */
         keys: () => string[];
     };
 };
 type Storage = {
     /** Get value from the storage. */
-    get<T = unknown>(key: string): Promise<T>;
+    get<T = unknown>(key: string): Promise<T | null>;
     /** Set value in the storage. */
-    set<T = unknown>(key: string, value: T): Promise<void>;
+    set(key: string, value: unknown): Promise<void>;
     /** Delete value from the storage. */
     delete(key: string): Promise<void>;
     /** Get all keys from the storage. */
@@ -37,23 +65,23 @@ type Storage = {
 };
 interface Epos {
     fetch: (url: string | URL, init?: ReqInit) => Promise<Res>;
-    browser: typeof chrome;
-    element: HTMLDivElement;
+    browser: Chrome;
     render(node: react.ReactNode, container?: reactDomClient.Container): void;
     component<T>(Component: react.FC<T>): typeof Component;
+    element: HTMLDivElement;
     bus: {
         /** Listen for an event. */
-        on(eventName: string, callback: Fn, thisValue?: unknown): void;
+        on<T extends Fn>(name: string, callback: T, thisArg?: unknown): void;
         /** Remove event listener. */
-        off(eventName: string, callback?: Fn): void;
+        off<T extends Fn>(name: string, callback?: T): void;
         /** Listen for an event once. */
-        once(eventName: string, callback: Fn, thisValue?: unknown): void;
+        once<T extends Fn>(name: string, callback: T, thisArg?: unknown): void;
         /** Send an event to all remote listeners (local listeners are ignored). */
-        send<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
+        send<T = unknown>(name: string, ...args: FnArgsOrArr<T>): Promise<FnResultOrValue<T>>;
         /** Emit event locally (calls local listeners only). */
-        emit<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
+        emit<T = unknown>(name: string, ...args: FnArgsOrArr<T>): Promise<FnResultOrValue<T>>;
         setSignal(name: string, value?: unknown): void;
-        waitSignal<T>(name: string, timeout?: number): Promise<T>;
+        waitSignal<T = unknown>(name: string, timeout?: number): Promise<T>;
     };
     state: {
         /** Connect state. */
@@ -67,8 +95,6 @@ interface Epos {
         transaction: (fn: () => void) => void;
         /** Create local state (no sync). */
         local<T extends Obj = {}>(state?: T): T;
-        /** Configure state. */
-        configure: (config: StateConfig) => void;
         /** Get the list of all state names. */
         list(filter?: {
             connected?: boolean;
@@ -76,30 +102,32 @@ interface Epos {
             name: string | null;
         }[]>;
         /** Remove state and all its data. */
-        destroy(name?: string): Promise<void>;
-        /** Register models for all states. */
-        registerModels(models: Record<string, ModelClass>): void;
-        symbols: {
-            readonly parent: unique symbol;
-            readonly modelInit: unique symbol;
-            readonly modelCleanup: unique symbol;
-            readonly modelStrict: unique symbol;
-            readonly modelVersioner: unique symbol;
-        };
+        remove(name?: string): Promise<void>;
+        /** Register models to be used by all states. */
+        register(models: Record<string, ModelClass>): void;
     };
     storage: {
         /** Get value from the storage. */
-        get<T = unknown>(key: string, storageName?: string): Promise<T>;
+        get: {
+            <T = unknown>(key: string): Promise<T | null>;
+            <T = unknown>(name: string, key: string): Promise<T | null>;
+        };
         /** Set value in the storage. */
-        set<T = unknown>(key: string, value: T, storageName?: string): Promise<void>;
+        set: {
+            <T = unknown>(key: string, value: T): Promise<void>;
+            <T = unknown>(name: string, key: string, value: T): Promise<void>;
+        };
         /** Delete value from the storage. */
-        delete(key: string, storageName?: string): Promise<void>;
+        delete: {
+            (key: string): Promise<void>;
+            (name: string, key: string): Promise<void>;
+        };
         /** Get all keys from the storage. */
-        keys(storageName?: string): Promise<string[]>;
+        keys(name?: string): Promise<string[]>;
         /** Clear storage. Removes all keys and storage itself. */
-        clear(storageName?: string): Promise<void>;
+        clear(name?: string): Promise<void>;
         /** Get storage API for a specific storage. */
-        use(storageName: string): Promise<Storage>;
+        use(name?: string): Storage;
         /** Get this list of all storages. */
         list(): Promise<{
             name: string | null;
@@ -107,34 +135,41 @@ interface Epos {
     };
     frame: {
         /** Open background frame. */
-        open(name: string, url: string, attributes?: Record<string, unknown>): Promise<void>;
-        /** Close background frame by its name. */
-        close(name: string): Promise<void>;
+        open: {
+            open(url: string): Promise<void>;
+            open(url: string, attrs: Attrs): Promise<void>;
+            open(name: string, url: string): Promise<void>;
+            open(name: string, url: string, attrs: Attrs): Promise<void>;
+        };
+        /** Close background frame. */
+        close(name?: string): Promise<void>;
         /** Check if background frame with the given name exists. */
-        exists(name: string): Promise<boolean>;
+        exists(name?: string): Promise<boolean>;
         /** Get list of all open background frames. */
         list(): Promise<{
             name: string | null;
             url: string;
         }[]>;
     };
-    assets: {
-        /** Get asset URL. The asset must be loaded first via `epos.assets.load`. */
-        url(path: string): string;
-        /** Load either all assets or a specific asset by its path. */
+    asset: {
+        /** Load either all assets to the memory or a specific asset by its path. */
         load: {
             /** Load all assets. */
             (): Promise<void>;
             /** Load asset by path. */
-            (path: string): Promise<Blob>;
+            (path: string): Promise<void>;
         };
-        /** Unload either all assets from memory or a specific asset by its path. */
+        /** Unload either all assets from the memory or a specific asset by its path. */
         unload: {
-            /** Unload all assets from memory. */
+            /** Unload all assets. */
             (): void;
             /** Unload asset by path. */
             (path: string): void;
         };
+        /** Get asset URL. The asset must be loaded first via `epos.asset.load`. */
+        url(path: string): string;
+        /** Get asset as Blob. */
+        get(path: string): Promise<Blob | null>;
         /** Get list of all available asset files. */
         list(filter?: {
             loaded?: boolean;
@@ -145,7 +180,7 @@ interface Epos {
     };
     env: {
         tabId: number;
-        isWeb: boolean;
+        project: string;
         isPopup: boolean;
         isSidePanel: boolean;
         isBackground: boolean;
@@ -159,15 +194,17 @@ interface Epos {
         reactJsxRuntime: typeof reactJsxRuntime;
         yjs: typeof yjs;
     };
+    symbols: {
+        readonly stateParent: symbol;
+        readonly stateModelInit: symbol;
+        readonly stateModelDispose: symbol;
+        readonly stateModelStrict: symbol;
+        readonly stateModelVersioner: symbol;
+    };
 }
 declare global {
     var epos: Epos;
-    namespace React {
-        interface HTMLAttributes<T> {
-            class?: ClassName;
-        }
-    }
 }
 declare const _epos: Epos;
 
-export { type ClassName, type Epos, type Fn, type Initial, type Model, type ModelClass, type Obj, type ReqInit, type Res, type StateConfig, type Storage, type Versioner, _epos as default, _epos as epos };
+export { type Arr, type Attrs, type Epos, type Fn, type FnArgsOrArr, type FnResultOrValue, type Initial, type Model, type ModelClass, type Obj, type ReqInit, type Res, type StateConfig, type Storage, type Versioner, _epos as default, _epos as epos };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "epos",
-  "version": "1.26.0",
+  "version": "1.29.0",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
   "description": "",
   "keywords": [],
   "scripts": {
-    "dev": "tsup --config ../tsup.config.ts --watch",
-    "build": "tsup --config ../tsup.config.ts",
+    "dev": "tsup --config ../../tsup.config.ts --watch --dts-resolve",
+    "build": "tsup --config ../../tsup.config.ts --dts-resolve",
     "lint": "tsc --noEmit",
     "release": "sh -c 'npm version ${1:-minor} && npm run build && npm publish' --"
   },
@@ -33,20 +33,20 @@
   ],
   "dependencies": {
     "@parcel/watcher": "^2.5.1",
-    "@types/chrome": "^0.1.24",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
+    "@types/chrome": "^0.1.32",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
     "mobx": "^6.15.0",
     "mobx-react-lite": "^4.1.1",
     "portfinder": "^1.0.38",
-    "react": "^19.2.0",
+    "react": "^19.2.3",
     "ws": "^8.18.3",
     "yjs": "^13.6.27"
   },
   "devDependencies": {
-    "vite": "^7.1.12"
+    "vite": "^7.3.0"
   },
   "peerDependencies": {
-    "vite": "^7.1.9"
+    "vite": "^7.3.0"
   }
 }

package/src/chrome.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="chrome"/>
+
+export type Chrome = typeof chrome

package/src/epos.ts

@@ -5,41 +5,51 @@ import type * as reactDom from 'react-dom'
 import type * as reactDomClient from 'react-dom/client'
 import type * as reactJsxRuntime from 'react/jsx-runtime'
 import type * as yjs from 'yjs'
-import './chrome-types.d.ts'
+import type { Chrome } from './chrome.ts'
 
 export type Fn<T = any> = (...args: any[]) => T
 export type Obj = Record<string, unknown>
+export type Arr = unknown[]
 export type Versioner = Record<number, (this: any, state: any) => void>
-export type ClassName = string | null | boolean | undefined | ClassName[]
 export type ModelClass = new (...args: any[]) => any
 export type Model = InstanceType<ModelClass>
 export type Initial<T extends Obj | Model> = T | (() => T)
+export type Attrs = Record<string, string | number>
+export type FnArgsOrArr<T> = T extends Fn ? Parameters<T> : Arr
+export type FnResultOrValue<T> = T extends Fn ? ReturnType<T> : T
 
 export type StateConfig = {
   allowMissingModels?: boolean | string[]
 }
 
-export type ReqInit = Pick<
-  RequestInit,
-  | 'body'
-  | 'cache'
-  | 'credentials'
-  | 'headers'
-  | 'integrity'
-  | 'keepalive'
-  | 'method'
-  | 'mode'
-  | 'priority'
-  | 'redirect'
-  | 'referrer'
-  | 'referrerPolicy'
->
-
-export type Res = Pick<
-  Response,
-  'ok' | 'url' | 'type' | 'status' | 'statusText' | 'redirected' | 'text' | 'json' | 'blob'
-> & {
-  headers: Pick<Response['headers'], 'get' | 'has'> & {
+export type ReqInit = {
+  body: RequestInit['body']
+  cache: RequestInit['cache']
+  credentials: RequestInit['credentials']
+  headers: RequestInit['headers']
+  integrity: RequestInit['integrity']
+  keepalive: RequestInit['keepalive']
+  method: RequestInit['method']
+  mode: RequestInit['mode']
+  priority: RequestInit['priority']
+  redirect: RequestInit['redirect']
+  referrer: RequestInit['referrer']
+  referrerPolicy: RequestInit['referrerPolicy']
+}
+
+export type Res = {
+  ok: Response['ok']
+  url: Response['url']
+  type: Response['type']
+  status: Response['status']
+  statusText: Response['statusText']
+  redirected: Response['redirected']
+  text: Response['text']
+  json: Response['json']
+  blob: Response['blob']
+  headers: {
+    get: Response['headers']['get']
+    has: Response['headers']['has']
     /** Get list of all header keys. */
     keys: () => string[]
   }
@@ -47,9 +57,9 @@ export type Res = Pick<
 
 export type Storage = {
   /** Get value from the storage. */
-  get<T = unknown>(key: string): Promise<T>
+  get<T = unknown>(key: string): Promise<T | null>
   /** Set value in the storage. */
-  set<T = unknown>(key: string, value: T): Promise<void>
+  set(key: string, value: unknown): Promise<void>
   /** Delete value from the storage. */
   delete(key: string): Promise<void>
   /** Get all keys from the storage. */
@@ -61,25 +71,25 @@ export type Storage = {
 export interface Epos {
   // General
   fetch: (url: string | URL, init?: ReqInit) => Promise<Res>
-  browser: typeof chrome
-  element: HTMLDivElement
+  browser: Chrome
   render(node: react.ReactNode, container?: reactDomClient.Container): void
   component<T>(Component: react.FC<T>): typeof Component
+  element: HTMLDivElement
 
   // Bus
   bus: {
     /** Listen for an event. */
-    on(eventName: string, callback: Fn, thisValue?: unknown): void
+    on<T extends Fn>(name: string, callback: T, thisArg?: unknown): void
     /** Remove event listener. */
-    off(eventName: string, callback?: Fn): void
+    off<T extends Fn>(name: string, callback?: T): void
     /** Listen for an event once. */
-    once(eventName: string, callback: Fn, thisValue?: unknown): void
+    once<T extends Fn>(name: string, callback: T, thisArg?: unknown): void
     /** Send an event to all remote listeners (local listeners are ignored). */
-    send<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>
+    send<T = unknown>(name: string, ...args: FnArgsOrArr<T>): Promise<FnResultOrValue<T>>
     /** Emit event locally (calls local listeners only). */
-    emit<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>
+    emit<T = unknown>(name: string, ...args: FnArgsOrArr<T>): Promise<FnResultOrValue<T>>
     setSignal(name: string, value?: unknown): void
-    waitSignal<T>(name: string, timeout?: number): Promise<T>
+    waitSignal<T = unknown>(name: string, timeout?: number): Promise<T>
   }
 
   // State
@@ -95,37 +105,37 @@ export interface Epos {
     transaction: (fn: () => void) => void
     /** Create local state (no sync). */
     local<T extends Obj = {}>(state?: T): T
-    /** Configure state. */
-    configure: (config: StateConfig) => void
     /** Get the list of all state names. */
     list(filter?: { connected?: boolean }): Promise<{ name: string | null }[]>
     /** Remove state and all its data. */
-    destroy(name?: string): Promise<void>
-    /** Register models for all states. */
-    registerModels(models: Record<string, ModelClass>): void
-    symbols: {
-      readonly parent: unique symbol
-      readonly modelInit: unique symbol
-      readonly modelCleanup: unique symbol
-      readonly modelStrict: unique symbol
-      readonly modelVersioner: unique symbol
-    }
+    remove(name?: string): Promise<void>
+    /** Register models to be used by all states. */
+    register(models: Record<string, ModelClass>): void
   }
 
   // Storage
   storage: {
     /** Get value from the storage. */
-    get<T = unknown>(key: string, storageName?: string): Promise<T>
+    get: {
+      <T = unknown>(key: string): Promise<T | null>
+      <T = unknown>(name: string, key: string): Promise<T | null>
+    }
     /** Set value in the storage. */
-    set<T = unknown>(key: string, value: T, storageName?: string): Promise<void>
+    set: {
+      <T = unknown>(key: string, value: T): Promise<void>
+      <T = unknown>(name: string, key: string, value: T): Promise<void>
+    }
     /** Delete value from the storage. */
-    delete(key: string, storageName?: string): Promise<void>
+    delete: {
+      (key: string): Promise<void>
+      (name: string, key: string): Promise<void>
+    }
     /** Get all keys from the storage. */
-    keys(storageName?: string): Promise<string[]>
+    keys(name?: string): Promise<string[]>
     /** Clear storage. Removes all keys and storage itself. */
-    clear(storageName?: string): Promise<void>
+    clear(name?: string): Promise<void>
     /** Get storage API for a specific storage. */
-    use(storageName: string): Promise<Storage>
+    use(name?: string): Storage
     /** Get this list of all storages. */
     list(): Promise<{ name: string | null }[]>
   }
@@ -133,33 +143,40 @@ export interface Epos {
   // Frame
   frame: {
     /** Open background frame. */
-    open(name: string, url: string, attributes?: Record<string, unknown>): Promise<void>
-    /** Close background frame by its name. */
-    close(name: string): Promise<void>
+    open: {
+      open(url: string): Promise<void>
+      open(url: string, attrs: Attrs): Promise<void>
+      open(name: string, url: string): Promise<void>
+      open(name: string, url: string, attrs: Attrs): Promise<void>
+    }
+    /** Close background frame. */
+    close(name?: string): Promise<void>
     /** Check if background frame with the given name exists. */
-    exists(name: string): Promise<boolean>
+    exists(name?: string): Promise<boolean>
     /** Get list of all open background frames. */
     list(): Promise<{ name: string | null; url: string }[]>
   }
 
-  // Assets
-  assets: {
-    /** Get asset URL. The asset must be loaded first via `epos.assets.load`. */
-    url(path: string): string
-    /** Load either all assets or a specific asset by its path. */
+  // Asset
+  asset: {
+    /** Load either all assets to the memory or a specific asset by its path. */
     load: {
       /** Load all assets. */
       (): Promise<void>
       /** Load asset by path. */
-      (path: string): Promise<Blob>
+      (path: string): Promise<void>
     }
-    /** Unload either all assets from memory or a specific asset by its path. */
+    /** Unload either all assets from the memory or a specific asset by its path. */
     unload: {
-      /** Unload all assets from memory. */
+      /** Unload all assets. */
       (): void
       /** Unload asset by path. */
       (path: string): void
     }
+    /** Get asset URL. The asset must be loaded first via `epos.asset.load`. */
+    url(path: string): string
+    /** Get asset as Blob. */
+    get(path: string): Promise<Blob | null>
     /** Get list of all available asset files. */
     list(filter?: { loaded?: boolean }): { path: string; loaded: boolean }[]
   }
@@ -167,7 +184,7 @@ export interface Epos {
   // Env
   env: {
     tabId: number
-    isWeb: boolean
+    project: string
     isPopup: boolean
     isSidePanel: boolean
     isBackground: boolean
@@ -183,16 +200,19 @@ export interface Epos {
     reactJsxRuntime: typeof reactJsxRuntime
     yjs: typeof yjs
   }
+
+  // Internal symbols
+  symbols: {
+    readonly stateParent: symbol
+    readonly stateModelInit: symbol
+    readonly stateModelDispose: symbol
+    readonly stateModelStrict: symbol
+    readonly stateModelVersioner: symbol
+  }
 }
 
 declare global {
   var epos: Epos
-
-  namespace React {
-    interface HTMLAttributes<T> {
-      class?: ClassName
-    }
-  }
 }
 
 const _epos = epos

package/dist/chrome-types.d.d.ts

@@ -1 +0,0 @@
-/// <reference types="chrome" />

package/src/chrome-types.d.ts

@@ -1,2 +0,0 @@
-/// <reference types="chrome" />
-export {}