@wippy-fe/types-global-proxy 0.0.12 → 0.0.14

package/index.d.ts

@@ -402,7 +402,7 @@ interface WsMessage_Upload extends WsMessageBase {
 }
 type WsMessage = WsMessage_Welcome | WsMessage_Pages | WsMessage_Page | WsMessage_SessionMessage | WsMessage_Session | WsMessage_SessionClosed | WsMessage_Error | WsMessage_Artifact | WsMessage_SessionOpen | WsMessage_Action | WsMessage_Registry | WsMessage_RegistryEntry | WsMessage_Upload;
 
-type KnownTopics = '@history' | '@visibility' | '@message';
+type KnownTopics = '@history' | '@visibility' | '@message' | '@state-error';
 type Events = {
     /** Emitted when pages are updated */
     '@history': (data: {
@@ -410,11 +410,27 @@ type Events = {
     }) => void;
     '@visibility': (visible: boolean) => void;
     '@message': (data: WsMessage) => void;
+    '@state-error': (data: {
+        error: string;
+        key?: string;
+    }) => void;
 } & {
     [K in string as K extends KnownTopics ? never : K]: (data: WsMessage) => void;
 };
 declare function createEvents(): <T extends string>(topicPattern: T, callback: T extends KnownTopics ? Events[T] : Events["@message"]) => nanoevents.Unsubscribe;
 
+interface StateApiOptions {
+    /** Override the default page-level scope. Used by web components with persist-key or nested artifacts. */
+    scope?: string;
+}
+interface StateApi {
+    get: <T = unknown>(key: string, options?: StateApiOptions) => Promise<T | null>;
+    set: (key: string, value: unknown, options?: StateApiOptions) => Promise<void>;
+    remove: (key: string, options?: StateApiOptions) => Promise<void>;
+    clear: (options?: StateApiOptions) => Promise<void>;
+    getAll: (options?: StateApiOptions) => Promise<Record<string, unknown>>;
+}
+
 var session = {
 	type: "non-persistent"
 };
@@ -632,6 +648,22 @@ interface AppFeatures extends I18NFeatureTypes {
         };
     };
     apiRoutes?: ApiRoutesOverride;
+    /**
+     * Additional HTML tags to whitelist in the sanitizer.
+     * Map of tag name to allowed attribute names.
+     * 'class' is always implicitly allowed for every tag.
+     */
+    allowAdditionalTags?: Record<string, string[]>;
+    /**
+     * LRU cache configuration for child iframe state preservation.
+     * @default { maxPages: 50, maxSizePerPage: 2097152 }
+     */
+    stateCache?: {
+        /** Maximum number of page/artifact state buckets to keep. @default 50 */
+        maxPages?: number;
+        /** Maximum JSON-serialized size per page in bytes. @default 2097152 (2 MB) */
+        maxSizePerPage?: number;
+    };
 }
 interface AppAuthConfig {
     token: string;
@@ -736,6 +768,7 @@ interface ProxyApiInstance {
         submit: (data: FormData | Record<string, unknown>) => Promise<FormResult>;
     };
     on: ReturnType<typeof createEvents>;
+    state: StateApi;
     loadWebComponent: (componentId: string, tagName?: string) => Promise<void>;
 }
 
@@ -783,19 +816,13 @@ declare const _default: {
         theme: {
             extend: {
                 colors: {
-                    secondary: {
-                        50: string;
-                        100: string;
-                        200: string;
-                        300: string;
-                        400: string;
-                        500: string;
-                        600: string;
-                        700: string;
-                        800: string;
-                        900: string;
-                        950: string;
-                    };
+                    secondary: Record<string, string>;
+                    danger: Record<string, string>;
+                    success: Record<string, string>;
+                    warn: Record<string, string>;
+                    info: Record<string, string>;
+                    help: Record<string, string>;
+                    accent: Record<string, string>;
                 };
             };
         };
@@ -822,6 +849,7 @@ declare global {
             host: () => Promise<ProxyApiInstance['host']>;
             iframe: () => Promise<ProxyApiInstance['iframe']>;
             on: () => Promise<ProxyApiInstance['on']>;
+            state: () => Promise<ProxyApiInstance['state']>;
             loadWebComponent: () => Promise<ProxyApiInstance['loadWebComponent']>;
         };
         tailwind?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wippy-fe/types-global-proxy",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Global type declarations for Wippy iframe proxy (window.getWippyApi, $W, etc.)",
   "types": "index.d.ts"
 }