epos 1.7.1 → 1.7.3

package/dist/epos/epos.d.ts

@@ -5,164 +5,159 @@ 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';
-type Fn<T = any> = (...args: any[]) => T;
-type Cls<T = any> = new (...args: any[]) => T;
-type State = Record<string, StateValue>;
-type Versioner = Record<number, (state: State) => void>;
-type ClassName = string | null | boolean | undefined | ClassName[];
-type StateValue = undefined | null | boolean | number | string | Unit | StateValue[] | {
-    [key: string]: StateValue;
+export type Fn<T = any> = (...args: any[]) => T;
+export type Obj = Record<string, 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 ConnectOptions<T extends Obj> = {
+    initial?: () => T;
+    models?: Record<string, ModelClass>;
+    versioner?: Versioner;
 };
 type Storage = {
-    /** Get value from storage. */
+    /** Get value from the storage. */
     get<T = unknown>(key: string): Promise<T>;
-    /** Set value in storage. */
+    /** Set value in the storage. */
     set<T = unknown>(key: string, value: T): Promise<void>;
-    /** Delete value from storage. */
+    /** Delete value from the storage. */
     delete(key: string): Promise<void>;
-    /** Get all keys from storage. */
+    /** Get all keys from the storage. */
     keys(): Promise<string[]>;
-    /** Clear storage. Deletes all keys and storage itself. */
+    /** Clear the storage. Deletes all keys and storage itself. */
     clear(): Promise<void>;
 };
-declare class Unit<TRoot = unknown> {
-    /** Reference to the root unit. */
-    $: TRoot;
-    log: Fn<void> & {
-        warn: Fn<void>;
-        error: Fn<void>;
-    };
-    constructor(parent?: Unit<TRoot> | null);
-    /** Find ancestor unit by its class. */
-    up<T extends Unit<TRoot>>(Ancestor: Cls<T>): T | null;
-    up<T extends Unit<TRoot>, K extends keyof T>(Ancestor: Cls<T>, key: K): T[K] | null;
-    autorun: typeof mobx.autorun;
-    reaction: typeof mobx.reaction;
-    setTimeout: typeof self.setTimeout;
-    setInterval: typeof self.setInterval;
-}
 export interface Epos {
-    /** Listen for an event. */
-    on(eventName: string, callback: Fn, thisValue?: unknown): void;
-    /** Remove event listener. */
-    off(eventName: string, callback?: Fn): void;
-    /** Listen for an event once. */
-    once(eventName: string, callback: Fn, thisValue?: unknown): void;
-    /** Send an event to all remote listeners (local listeners are ignored). */
-    send<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
-    /** Emit event locally (calls local listeners only). */
-    emit<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
-    /** Connect to the state. */
-    connect: {
-        <T extends State = {}>(): Promise<T>;
-        <T extends State = {}>(initial: () => T): Promise<T>;
-        <T extends State = {}>(initial: () => T, versioner: Versioner): Promise<T>;
-        <T extends State = {}>(name: string): Promise<T>;
-        <T extends State = {}>(name: string, initial: () => T): Promise<T>;
-        <T extends State = {}>(name: string, initial: () => T, versioner: Versioner): Promise<T>;
-    };
-    /** Disconnect from the state. */
-    disconnect(name?: string): void;
-    /** Performs any state changes in a batch. */
-    transaction: (fn: () => void) => void;
-    /** Create local state (no sync). */
-    local<T extends State = {}>(state?: T): T;
-    /** Get the list of all state names. */
-    states(opts?: {
-        connected?: boolean;
-    }): Promise<Array<{
-        name: string | null;
-    }>>;
-    /** Destroy state. */
-    destroy(name?: string): Promise<void>;
-    element: HTMLElement;
+    fetch: typeof window.fetch;
+    browser: typeof chrome;
+    element: HTMLDivElement;
+    render(node: react.ReactNode, container?: reactDomClient.Container): void;
     component: {
         <P>(Component: react.FC<P>): typeof Component;
         <P>(name: string, Component: react.FC<P>): typeof Component;
     };
-    render(node: react.ReactNode, container?: reactDomClient.Container): void;
-    portal: typeof reactDom.createPortal;
-    useState: typeof mobxReactLite.useLocalObservable;
-    useAutorun(...args: Parameters<typeof mobx.autorun>): void;
-    useReaction(...args: Parameters<typeof mobx.reaction>): void;
-    Unit: typeof Unit;
-    /** Register unit class. */
-    register(Unit: Cls<Unit>): void;
-    units(): {
-        [name: string]: typeof Unit;
+    bus: {
+        /** Listen for an event. */
+        on(eventName: string, callback: Fn, thisValue?: unknown): void;
+        /** Remove event listener. */
+        off(eventName: string, callback?: Fn): void;
+        /** Listen for an event once. */
+        once(eventName: string, callback: Fn, thisValue?: unknown): void;
+        /** Send an event to all remote listeners (local listeners are ignored). */
+        send<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
+        /** Emit event locally (calls local listeners only). */
+        emit<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
     };
-    fetch: typeof window.fetch;
-    browser: typeof chrome;
-    /** @see https://mobx.js.org/reactions.html#autorun */
-    autorun: typeof mobx.autorun;
-    /** @see https://mobx.js.org/reactions.html#reaction */
-    reaction: typeof mobx.reaction;
-    /** Get value from the storage. */
-    get<T = unknown>(key: string, storageName?: string): Promise<T>;
-    /** Set value in the storage. */
-    set<T = unknown>(key: string, value: T, storageName?: string): Promise<void>;
-    /** Delete value from the storage. */
-    delete(key: string, storageName?: string): Promise<void>;
-    /** Get all keys from the storage. */
-    keys(storageName?: string): Promise<string[]>;
-    /** Clear storage. Removes all keys and storage itself. */
-    clear(storageName?: string): Promise<void>;
-    /** Create storage API. */
-    storage(name: string): Promise<Storage>;
-    /** Get list of all storage names. */
-    storages(): Promise<Array<{
-        name: string | null;
-    }>>;
-    /** Get asset URL. Asset must be loaded first. */
-    url(path: string): Promise<string>;
-    /** Load asset to memory. Pass '*' to load all assets. */
-    load(path: string): Promise<void>;
-    /** Unload asset from memory. Pass '*' to unload all assets.*/
-    unload(path: string): void;
-    /** Get list of all available asset paths. */
-    assets(opts?: {
-        loaded?: boolean;
-    }): Promise<Array<{
-        path: string;
-        loaded: boolean;
-    }>>;
-    /** Current tab ID. */
-    tabId: number;
-    is: {
-        /** True if running in a tab. */
-        tab: boolean;
-        /** True if running on a hub page (<hub>). */
-        hub: boolean;
-        /** True if running on any page except hub. */
-        page: boolean;
-        /** True if running in a popup or side panel (`<popup>` or `<panel>`). */
-        shell: boolean;
+    state: {
+        /** Connect state. */
+        connect: {
+            <T extends Obj>(name?: string, options?: ConnectOptions<T>): Promise<T>;
+            <T extends Obj>(options?: ConnectOptions<T>): Promise<T>;
+        };
+        /** Disconnect state. */
+        disconnect(name?: string): void;
+        /** Run any state changes in a batch. */
+        transaction: (fn: () => void) => void;
+        /** Create local state (no sync). */
+        local<T extends Obj = {}>(state?: T): T;
+        /** Get the list of all state names. */
+        list(filter?: {
+            connected?: boolean;
+        }): Promise<Array<{
+            name: string | null;
+        }>>;
+        /** Remove state and all its data. */
+        destroy(name?: string): Promise<void>;
+        /** Dynamically register models for all states. */
+        registerGlobalModels(models: Record<string, ModelClass>): void;
+        symbols: {
+            model: {
+                readonly init: unique symbol;
+                readonly cleanup: unique symbol;
+                readonly versioner: unique symbol;
+                readonly parent: unique symbol;
+            };
+        };
+    };
+    storage: {
+        /** Get value from the storage. */
+        get<T = unknown>(key: string, storageName?: string): Promise<T>;
+        /** Set value in the storage. */
+        set<T = unknown>(key: string, value: T, storageName?: string): Promise<void>;
+        /** Delete value from the storage. */
+        delete(key: string, storageName?: string): Promise<void>;
+        /** Get all keys from the storage. */
+        keys(storageName?: string): Promise<string[]>;
+        /** Clear storage. Removes all keys and storage itself. */
+        clear(storageName?: string): Promise<void>;
+        /** Create storage API. */
+        use(name: string): Promise<Storage>;
+        /** Get list of all storage names. */
+        list(): Promise<Array<{
+            name: string | null;
+        }>>;
+    };
+    assets: {
+        /** Get asset URL. Asset must be loaded first. */
+        url(path: string): Promise<string>;
+        /** Load asset to memory. Pass '*' to load all assets. */
+        load(path: string): Promise<void>;
+        /** Unload asset from memory. Pass '*' to unload all assets.*/
+        unload(path: string): void;
+        /** Get list of all available asset paths. */
+        list(filter?: {
+            loaded?: boolean;
+        }): Array<{
+            path: string;
+            loaded: boolean;
+        }>;
+    };
+    frames: {
+        /** Create a new frame. */
+        create(name: string, url: string, attributes?: Record<string, unknown>): Promise<void>;
+        /** Remove frame by name. */
+        remove(name: string): Promise<void>;
+        /** Get list of all created frames. */
+        list(): Promise<Array<{
+            name: string;
+            url: string;
+        }>>;
+    };
+    env: {
+        /** Current tab ID. */
+        tabId: number;
+        /** True if running in a tab (top-level, not iframe). */
+        isTab: boolean;
+        /** True if running in an iframe. */
+        isFrame: boolean;
+        /** True if running in a popup or side panel (`<popup>` or `<sidePanel>`). */
+        isShell: boolean;
         /** True if running in a popup (`<popup>`). */
-        popup: boolean;
-        /** True if running in a side panel (`<panel>`). */
-        panel: boolean;
+        isPopup: boolean;
+        /** True if running in a side panel (`<sidePanel>`). */
+        isSidePanel: boolean;
         /** True if running in the background (`<background>`). */
-        background: boolean;
-        /** True if running in the foreground. */
-        foreground: boolean;
+        isBackground: boolean;
+        /** True if running in the foreground (not `<background>` and not inside iframe). */
+        isForeground: boolean;
+    };
+    libs: {
+        mobx: typeof mobx;
+        mobxReactLite: typeof mobxReactLite;
+        react: typeof react;
+        reactDom: typeof reactDom;
+        reactDomClient: typeof reactDomClient;
+        reactJsxRuntime: typeof reactJsxRuntime;
+        yjs: typeof yjs;
     };
-    mobx: typeof mobx;
-    mobxReactLite: typeof mobxReactLite;
-    react: typeof react;
-    reactDom: typeof reactDom;
-    reactDomClient: typeof reactDomClient;
-    reactJsxRuntime: typeof reactJsxRuntime;
-    yjs: typeof yjs;
 }
 declare global {
     var epos: Epos;
     namespace React {
         interface HTMLAttributes<T> {
             class?: ClassName;
-            [key: `$${string}`]: boolean;
         }
     }
 }
 declare const _epos: Epos;
 export { _epos as epos };
-export default _epos;

package/dist/epos/epos.js

@@ -1,3 +1,2 @@
 const _epos = epos;
 export { _epos as epos };
-export default _epos;

package/dist/epos/index.d.ts

@@ -0,0 +1,3 @@
+import { epos } from './epos';
+export { epos };
+export default epos;

package/dist/epos/index.js

@@ -0,0 +1,3 @@
+import { epos } from './epos';
+export { epos };
+export default epos;

package/dist/plugin/lib/lib-mobx-react-lite.js

@@ -1 +1 @@
-export const { enableStaticRendering, isUsingStaticRendering, observer, Observer, observerBatching, useAsObservableSource, useLocalObservable, useLocalStore, useObserver, useStaticRendering, } = epos.mobxReactLite;
+export const { enableStaticRendering, isUsingStaticRendering, observer, Observer, observerBatching, useAsObservableSource, useLocalObservable, useLocalStore, useObserver, useStaticRendering, } = epos.libs.mobxReactLite;

package/dist/plugin/lib/lib-mobx.js

@@ -1 +1 @@
-export const { _allowStateChanges, _allowStateChangesInsideComputed, _allowStateReadsEnd, _allowStateReadsStart, _autoAction, _endAction, _getAdministration, _getGlobalState, _interceptReads, _isComputingDerivation, _resetGlobalState, _startAction, $mobx, action, autorun, comparer, computed, configure, createAtom, defineProperty, entries, extendObservable, FlowCancellationError, flowResult, get, getAtom, getDebugName, getDependencyTree, getObserverTree, has, intercept, isAction, isBoxedObservable, isComputed, isComputedProp, isFlow, isFlowCancellationError, isObservable, isObservableArray, isObservableMap, isObservableObject, isObservableProp, isObservableSet, keys, makeAutoObservable, makeObservable, observable, ObservableMap, ObservableSet, observe, onBecomeObserved, onBecomeUnobserved, onReactionError, override, ownKeys, reaction, Reaction, remove, runInAction, set, spy, toJS, trace, transaction, untracked, values, when, } = epos.mobx;
+export const { _allowStateChanges, _allowStateChangesInsideComputed, _allowStateReadsEnd, _allowStateReadsStart, _autoAction, _endAction, _getAdministration, _getGlobalState, _interceptReads, _isComputingDerivation, _resetGlobalState, _startAction, $mobx, action, autorun, comparer, computed, configure, createAtom, defineProperty, entries, extendObservable, FlowCancellationError, flowResult, get, getAtom, getDebugName, getDependencyTree, getObserverTree, has, intercept, isAction, isBoxedObservable, isComputed, isComputedProp, isFlow, isFlowCancellationError, isObservable, isObservableArray, isObservableMap, isObservableObject, isObservableProp, isObservableSet, keys, makeAutoObservable, makeObservable, observable, ObservableMap, ObservableSet, observe, onBecomeObserved, onBecomeUnobserved, onReactionError, override, ownKeys, reaction, Reaction, remove, runInAction, set, spy, toJS, trace, transaction, untracked, values, when, } = epos.libs.mobx;

package/dist/plugin/lib/lib-react-dom-client.js

@@ -1,2 +1,2 @@
-export default epos.reactDomClient;
-export const { createRoot, hydrateRoot } = epos.reactDomClient;
+export default epos.libs.reactDomClient;
+export const { createRoot, hydrateRoot } = epos.libs.reactDomClient;

package/dist/plugin/lib/lib-react-dom.js

@@ -1,2 +1,2 @@
-export default epos.reactDom;
-export const { createPortal, flushSync, preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule, requestFormReset, unstable_batchedUpdates, useFormState, useFormStatus, version, } = epos.reactDom;
+export default epos.libs.reactDom;
+export const { createPortal, flushSync, preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule, requestFormReset, unstable_batchedUpdates, useFormState, useFormStatus, version, } = epos.libs.reactDom;

package/dist/plugin/lib/lib-react-jsx-runtime.js

@@ -1,2 +1,2 @@
-export default epos.reactJsxRuntime;
-export const { Fragment, jsx, jsxs } = epos.reactJsxRuntime;
+export default epos.libs.reactJsxRuntime;
+export const { Fragment, jsx, jsxs } = epos.libs.reactJsxRuntime;

package/dist/plugin/lib/lib-react.js

@@ -1,2 +1,2 @@
-export default epos.react;
-export const { act, cache, Children, cloneElement, Component, createContext, createElement, createRef, forwardRef, Fragment, isValidElement, lazy, memo, Profiler, PureComponent, startTransition, StrictMode, Suspense, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, version, } = epos.react;
+export default epos.libs.react;
+export const { act, cache, Children, cloneElement, Component, createContext, createElement, createRef, forwardRef, Fragment, isValidElement, lazy, memo, Profiler, PureComponent, startTransition, StrictMode, Suspense, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, version, } = epos.libs.react;

package/epos.schema.json

@@ -13,7 +13,8 @@
     "targets": { "$ref": "#/definitions/Targets" },
     "matches": { "$ref": "#/definitions/Matches" },
     "load": { "$ref": "#/definitions/Load" },
-    "mode": { "$ref": "#/definitions/Mode" }
+    "mode": { "$ref": "#/definitions/Mode" },
+    "manifest": { "$ref": "#/definitions/Manifest" }
   },
   "required": ["name"],
   "additionalProperties": false,
@@ -97,6 +98,10 @@
     "Mode": {
       "type": "string",
       "enum": ["normal", "shadow", "lite"]
+    },
+
+    "Manifest": {
+      "$ref": "https://json.schemastore.org/chrome-manifest.json"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epos",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
@@ -14,7 +14,7 @@
   },
   "exports": {
     ".": {
-      "import": "./dist/epos/epos.js"
+      "import": "./dist/epos/index.js"
     },
     "./vite": {
       "import": "./dist/plugin/plugin-vite.js"
@@ -28,8 +28,8 @@
     "epos.schema.json"
   ],
   "dependencies": {
-    "@types/chrome": "^0.1.6",
-    "@types/react": "^19.1.12",
+    "@types/chrome": "^0.1.11",
+    "@types/react": "^19.1.13",
     "@types/react-dom": "^19.1.9",
     "mobx": "^6.13.7",
     "mobx-react-lite": "^4.1.0",
@@ -38,7 +38,7 @@
   },
   "devDependencies": {
     "esbuild": "^0.25.9",
-    "vite": "^7.1.4"
+    "vite": "^7.1.5"
   },
   "peerDependencies": {
     "esbuild": "^0.25.9",