epos 1.19.0 → 1.21.0

package/dist/epos.d.ts

@@ -13,6 +13,9 @@ 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 StateConfig = {
+    allowMissingModels?: boolean | string[];
+};
 type Storage = {
     /** Get value from the storage. */
     get<T = unknown>(key: string): Promise<T>;
@@ -46,7 +49,7 @@ interface Epos {
         /** Emit event locally (calls local listeners only). */
         emit<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>;
         setSignal(name: string, value?: unknown): void;
-        waitSignal(name: string, timeout?: number): Promise<void>;
+        waitSignal<T>(name: string, timeout?: number): Promise<T>;
     };
     state: {
         /** Connect state. */
@@ -60,6 +63,8 @@ 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;
@@ -74,6 +79,7 @@ interface Epos {
             readonly parent: unique symbol;
             readonly modelInit: unique symbol;
             readonly modelCleanup: unique symbol;
+            readonly modelStrict: unique symbol;
             readonly modelVersioner: unique symbol;
         };
     };
@@ -96,7 +102,7 @@ interface Epos {
         }[]>;
     };
     frame: {
-        /** Open frame in the background. */
+        /** 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>;
@@ -104,7 +110,7 @@ interface Epos {
         exists(name: string): Promise<boolean>;
         /** Get list of all open background frames. */
         list(): Promise<{
-            name: string;
+            name: string | null;
             url: string;
         }[]>;
     };
@@ -155,4 +161,4 @@ declare global {
 declare const _epos: Epos;
 var epos$1 = epos;
 
-export { type ClassName, type Epos, type Fn, type Initial, type Model, type ModelClass, type Obj, type Storage, type Versioner, epos$1 as default, _epos as epos };
+export { type ClassName, type Epos, type Fn, type Initial, type Model, type ModelClass, type Obj, type StateConfig, type Storage, type Versioner, epos$1 as default, _epos as epos };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epos",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
@@ -29,9 +29,9 @@
     "dist"
   ],
   "dependencies": {
-    "@types/chrome": "^0.1.21",
-    "@types/react": "^19.2.0",
-    "@types/react-dom": "^19.2.0",
+    "@types/chrome": "^0.1.22",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.1",
     "mobx": "^6.15.0",
     "mobx-react-lite": "^4.1.1",
     "react": "^19.2.0",

package/src/epos.ts

@@ -1,3 +1,5 @@
+/// <reference types="chrome"/>
+
 import type * as mobx from 'mobx'
 import type * as mobxReactLite from 'mobx-react-lite'
 import type * as react from 'react'
@@ -14,6 +16,10 @@ export type ModelClass = new (...args: any[]) => any
 export type Model = InstanceType<ModelClass>
 export type Initial<T extends Obj | Model> = T | (() => T)
 
+export type StateConfig = {
+  allowMissingModels?: boolean | string[]
+}
+
 export type Storage = {
   /** Get value from the storage. */
   get<T = unknown>(key: string): Promise<T>
@@ -51,7 +57,7 @@ export interface Epos {
     /** Emit event locally (calls local listeners only). */
     emit<T = unknown>(eventName: string, ...args: unknown[]): Promise<T>
     setSignal(name: string, value?: unknown): void
-    waitSignal(name: string, timeout?: number): Promise<void>
+    waitSignal<T>(name: string, timeout?: number): Promise<T>
   }
 
   // State
@@ -67,6 +73,8 @@ 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. */
@@ -77,6 +85,7 @@ export interface Epos {
       readonly parent: unique symbol
       readonly modelInit: unique symbol
       readonly modelCleanup: unique symbol
+      readonly modelStrict: unique symbol
       readonly modelVersioner: unique symbol
     }
   }
@@ -101,14 +110,14 @@ export interface Epos {
 
   // Frame
   frame: {
-    /** Open frame in the background. */
+    /** 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>
     /** Check if background frame with the given name exists. */
     exists(name: string): Promise<boolean>
     /** Get list of all open background frames. */
-    list(): Promise<{ name: string; url: string }[]>
+    list(): Promise<{ name: string | null; url: string }[]>
   }
 
   // Static