epos 1.5.1 → 1.6.0

package/dist/epos/epos.d.ts

@@ -1,71 +1,155 @@
-import type * as Mobx from 'mobx';
-import type * as MobxReactLite from 'mobx-react-lite';
-import type * as React from 'react';
-import type * as ReactDom from 'react-dom';
-import type * as ReactDomClient from 'react-dom/client';
-import type * as ReactJsxRuntime from 'react/jsx-runtime';
-type Fn = (...args: unknown[]) => unknown;
-export type Epos = {
-    on(name: string, callback: Fn, thisValue?: unknown): void;
-    off(name: string, callback?: Fn): void;
-    once(name: string, callback: Fn, thisValue?: unknown): void;
-    send(name: string, ...args: unknown[]): Promise<unknown>;
-    call(name: string, ...args: unknown[]): Promise<unknown>;
-    connect(): void;
-    disconnect(): void;
-    transaction(): void;
-    autorun(): void;
-    reaction(): void;
-    root: HTMLElement;
-    shadow: ShadowRoot;
-    component(): void;
-    render(): void;
-    portal(): void;
-    useState(): void;
-    useAutorun(): void;
-    useReaction(): void;
-    fetch(): void;
-    browser(): void;
-    storage: {
-        get(): void;
-        set(): void;
-        delete(): void;
-        keys(): void;
-        clear(): void;
-        connect(): void;
+import type * as mobx from 'mobx';
+import type * as mobxReactLite from 'mobx-react-lite';
+import type * as react from 'react';
+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 | Blob | Unit | StateValue[] | {
+    [key: string]: StateValue;
+};
+type Storage = {
+    /** Get value from storage. */
+    get<T = unknown>(key: string): Promise<T>;
+    /** Set value in storage. */
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    /** Delete value from storage. */
+    delete(key: string): Promise<void>;
+    /** Get all keys from storage. */
+    keys(): Promise<string[]>;
+    /** Clear 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;
+    static v: Record<number, (this: Unit, unit: Unit) => void>;
+}
+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>;
     };
-    assets: {
-        use(): void;
-        useUrl(): void;
-        get(): void;
-        getUrl(): void;
-        load(): void;
-        offload(): void;
-        list(): void;
+    /** Disconnect from the state. */
+    disconnect(name?: string): void;
+    /** Create local state (no sync). */
+    local<T extends State = {}>(state?: T): T;
+    /** Get the list of all state names. */
+    states(): Promise<string[]>;
+    /** Destroy state. */
+    destroy(name?: string): Promise<void>;
+    /** Performs any state changes in a batch. */
+    transaction: (fn: () => void) => void;
+    /** @see https://mobx.js.org/reactions.html#autorun */
+    autorun: typeof mobx.autorun;
+    /** @see https://mobx.js.org/reactions.html#reaction */
+    reaction: typeof mobx.reaction;
+    root: HTMLElement;
+    shadow: HTMLElement;
+    component: {
+        <P>(fn: react.FC<P>): typeof fn;
+        <P>(name: string, fn: react.FC<P>): typeof fn;
     };
-    env: {
-        name: string;
-        tabId: number;
-        is: {
-            tab: boolean;
-            hub: boolean;
-            web: boolean;
-            view: boolean;
-            popup: boolean;
-            panel: boolean;
-            background: boolean;
-            foreground: boolean;
-        };
+    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;
+    fetch: typeof window.fetch;
+    browser: typeof chrome;
+    /** 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<string[]>;
+    /** 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(): Promise<string[]>;
+    /** Current tab ID. */
+    tabId: number;
+    is: {
+        /** True if running in a tab. */
+        tab: boolean;
+        /** True if running on on a hub page (<hub>). */
+        hub: boolean;
+        /** True if running on any page except hub. */
+        web: boolean;
+        /** True if running in a popup or in side panel (<popup> or <panel>). */
+        shell: boolean;
+        /** True if running in a popup (<popup>). */
+        popup: boolean;
+        /** True if running in a side panel (<panel>). */
+        panel: boolean;
+        /** True if running in background (<background>). */
+        background: boolean;
+        /** True if running in foreground */
+        foreground: boolean;
     };
-    mobx: typeof Mobx;
-    mobxReactLite: typeof MobxReactLite;
-    react: typeof React;
-    reactDom: typeof ReactDom;
-    reactDomClient: typeof ReactDomClient;
-    reactJsxRuntime: typeof ReactJsxRuntime;
-};
+    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 };

package/dist/plugin/lib/lib-react-dom-client.d.ts

@@ -1,3 +1,3 @@
-declare const _default: any;
+declare const _default: typeof import("react-dom/client");
 export default _default;
-export declare const createRoot: any, hydrateRoot: any;
+export declare const createRoot: typeof import("react-dom/client").createRoot, hydrateRoot: typeof import("react-dom/client").hydrateRoot;

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.reactDomClient;
+export const { createRoot, hydrateRoot } = epos.reactDomClient;

package/dist/plugin/lib/lib-react-dom.d.ts

@@ -1,3 +1,3 @@
-declare const _default: any;
+declare const _default: typeof import("react-dom");
 export default _default;
-export declare const createPortal: any, flushSync: any, preconnect: any, prefetchDNS: any, preinit: any, preinitModule: any, preload: any, preloadModule: any, requestFormReset: any, unstable_batchedUpdates: any, useFormState: any, useFormStatus: any, version: any;
+export declare const createPortal: typeof import("react-dom").createPortal, flushSync: typeof import("react-dom").flushSync, preconnect: typeof import("react-dom").preconnect, prefetchDNS: typeof import("react-dom").prefetchDNS, preinit: typeof import("react-dom").preinit, preinitModule: typeof import("react-dom").preinitModule, preload: typeof import("react-dom").preload, preloadModule: typeof import("react-dom").preloadModule, requestFormReset: typeof import("react-dom").requestFormReset, unstable_batchedUpdates: typeof import("react-dom").unstable_batchedUpdates, useFormState: typeof import("react-dom").useFormState, useFormStatus: typeof import("react-dom").useFormStatus, version: string;

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.reactDom;
+export const { createPortal, flushSync, preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule, requestFormReset, unstable_batchedUpdates, useFormState, useFormStatus, version, } = epos.reactDom;

package/dist/plugin/lib/lib-react-jsx-runtime.d.ts

@@ -1,3 +1,3 @@
 declare const _default: typeof import("react/jsx-runtime");
 export default _default;
-export declare const Fragment: import("react").ExoticComponent<import("react").FragmentProps>, jsx: typeof import("react/jsx-runtime").jsx, jsxs: typeof import("react/jsx-runtime").jsxs;
+export declare const Fragment: React.ExoticComponent<React.FragmentProps>, jsx: typeof import("react/jsx-runtime").jsx, jsxs: typeof import("react/jsx-runtime").jsxs;

package/dist/plugin/lib/lib-react.d.ts

@@ -1,11 +1,11 @@
-declare const _default: typeof import("react");
+declare const _default: typeof React;
 export default _default;
-export declare const act: typeof import("react").act, cache: typeof import("react").cache, Children: {
+export declare const act: typeof React.act, cache: typeof React.cache, Children: {
     map<T, C>(children: C | readonly C[], fn: (child: C, index: number) => T): C extends null | undefined ? C : Array<Exclude<T, boolean | null | undefined>>;
     forEach<C>(children: C | readonly C[], fn: (child: C, index: number) => void): void;
     count(children: any): number;
     only<C>(children: C): C extends any[] ? never : C;
-    toArray(children: import("react").ReactNode | import("react").ReactNode[]): Array<Exclude<import("react").ReactNode, boolean | null | undefined>>;
-}, cloneElement: typeof import("react").cloneElement, Component: typeof import("react").Component, createContext: typeof import("react").createContext, createElement: typeof import("react").createElement, createRef: typeof import("react").createRef, forwardRef: typeof import("react").forwardRef, Fragment: import("react").ExoticComponent<import("react").FragmentProps>, isValidElement: typeof import("react").isValidElement, lazy: typeof import("react").lazy, memo: typeof import("react").memo, Profiler: import("react").ExoticComponent<import("react").ProfilerProps>, PureComponent: typeof import("react").PureComponent, startTransition: typeof import("react").startTransition, StrictMode: import("react").ExoticComponent<{
-    children?: import("react").ReactNode | undefined;
-}>, Suspense: import("react").ExoticComponent<import("react").SuspenseProps>, use: typeof import("react").use, useActionState: typeof import("react").useActionState, useCallback: typeof import("react").useCallback, useContext: typeof import("react").useContext, useDebugValue: typeof import("react").useDebugValue, useDeferredValue: typeof import("react").useDeferredValue, useEffect: typeof import("react").useEffect, useId: typeof import("react").useId, useImperativeHandle: typeof import("react").useImperativeHandle, useInsertionEffect: typeof import("react").useInsertionEffect, useLayoutEffect: typeof import("react").useLayoutEffect, useMemo: typeof import("react").useMemo, useOptimistic: typeof import("react").useOptimistic, useReducer: typeof import("react").useReducer, useRef: typeof import("react").useRef, useState: typeof import("react").useState, useSyncExternalStore: typeof import("react").useSyncExternalStore, useTransition: typeof import("react").useTransition, version: string;
+    toArray(children: React.ReactNode | React.ReactNode[]): Array<Exclude<React.ReactNode, boolean | null | undefined>>;
+}, cloneElement: typeof React.cloneElement, Component: typeof React.Component, createContext: typeof React.createContext, createElement: typeof React.createElement, createRef: typeof React.createRef, forwardRef: typeof React.forwardRef, Fragment: React.ExoticComponent<React.FragmentProps>, isValidElement: typeof React.isValidElement, lazy: typeof React.lazy, memo: typeof React.memo, Profiler: React.ExoticComponent<React.ProfilerProps>, PureComponent: typeof React.PureComponent, startTransition: typeof React.startTransition, StrictMode: React.ExoticComponent<{
+    children?: React.ReactNode | undefined;
+}>, Suspense: React.ExoticComponent<React.SuspenseProps>, use: typeof React.use, useActionState: typeof React.useActionState, useCallback: typeof React.useCallback, useContext: typeof React.useContext, useDebugValue: typeof React.useDebugValue, useDeferredValue: typeof React.useDeferredValue, useEffect: typeof React.useEffect, useId: typeof React.useId, useImperativeHandle: typeof React.useImperativeHandle, useInsertionEffect: typeof React.useInsertionEffect, useLayoutEffect: typeof React.useLayoutEffect, useMemo: typeof React.useMemo, useOptimistic: typeof React.useOptimistic, useReducer: typeof React.useReducer, useRef: typeof React.useRef, useState: typeof React.useState, useSyncExternalStore: typeof React.useSyncExternalStore, useTransition: typeof React.useTransition, version: string;

package/dist/plugin/plugin-vite.js

@@ -5,22 +5,22 @@ export function epos() {
         enforce: 'pre',
         resolveId(source) {
             if (source === 'react') {
-                return path.resolve(import.meta.dirname, './lib-react.js');
+                return path.resolve(import.meta.dirname, './lib/lib-react.js');
             }
             if (source === 'react/jsx-runtime') {
-                return path.resolve(import.meta.dirname, './lib-react-jsx-runtime.js');
+                return path.resolve(import.meta.dirname, './lib/lib-react-jsx-runtime.js');
             }
             if (source === 'react-dom') {
-                return path.resolve(import.meta.dirname, './lib-react-dom.js');
+                return path.resolve(import.meta.dirname, './lib/lib-react-dom.js');
             }
             if (source === 'react-dom/client') {
-                return path.resolve(import.meta.dirname, './lib-react-dom-client.js');
+                return path.resolve(import.meta.dirname, './lib/lib-react-dom-client.js');
             }
             if (source === 'mobx') {
-                return path.resolve(import.meta.dirname, './lib-mobx.js');
+                return path.resolve(import.meta.dirname, './lib/lib-mobx.js');
             }
             if (source === 'mobx-react') {
-                return path.resolve(import.meta.dirname, './lib-mobx-react.js');
+                return path.resolve(import.meta.dirname, './lib/lib-mobx-react.js');
             }
             return null;
         },

package/package.json

@@ -1,29 +1,27 @@
 {
   "name": "epos",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "type": "module",
   "author": "imkost",
   "description": "",
   "keywords": [],
   "license": "MIT",
   "scripts": {
-    "dev": "rimraf dist; tsc --watch",
-    "build": "rimraf dist; tsc",
+    "dev": "dropcap tsc -w",
+    "build": "dropcap tsc",
     "lint": "eslint ./src",
-    "release": "npm version patch && npm publish"
+    "release": "npm run build && npm publish",
+    "release:patch": "npm version patch && npm run release"
   },
   "exports": {
     ".": {
       "import": "./dist/epos/epos.js"
     },
-    "./vite": {
+    "./plugin-vite": {
       "import": "./dist/plugin/plugin-vite.js"
     },
-    "./esbuild": {
+    "./plugin-esbuild": {
       "import": "./dist/plugin/plugin-esbuild.js"
-    },
-    "./manifest": {
-      "import": "./dist/manifest/manifest.js"
     }
   },
   "files": [
@@ -31,14 +29,16 @@
     "epos.schema.json"
   ],
   "devDependencies": {
-    "@types/chrome": "^0.1.1",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
+    "@types/chrome": "^0.1.3",
+    "@types/react": "^19.1.10",
+    "@types/react-dom": "^19.1.7",
+    "dropcap": "^1.0.15",
     "esbuild": "^0.25.8",
     "mobx": "^6.13.7",
     "mobx-react-lite": "^4.1.0",
-    "react": "^19.1.0",
+    "react": "^19.1.1",
     "rimraf": "^6.0.1",
-    "vite": "^7.0.6"
+    "vite": "^7.1.2",
+    "yjs": "^13.6.27"
   }
 }

package/dist/manifest/manifest.d.ts

@@ -1,6 +0,0 @@
-export type Manifest = {
-    name: string;
-    [key: string]: any;
-};
-export declare function defineManifest(manifest: Manifest): Manifest;
-export default defineManifest;

package/dist/manifest/manifest.js

@@ -1,4 +0,0 @@
-export function defineManifest(manifest) {
-    return manifest;
-}
-export default defineManifest;