@wippy-fe/types-global-proxy 0.0.37 → 0.0.38

package/index.d.ts

@@ -498,6 +498,7 @@ interface AppEnv {
     APP_AUTH_API_URL: string;
     APP_WEBSOCKET_URL: string;
 }
+type ThemeMode = 'auto' | 'light' | 'dark';
 interface AppConfig {
     $schema: string;
     auth: AppAuthConfig;
@@ -505,6 +506,7 @@ interface AppConfig {
     axiosDefaults?: Partial<AxiosDefaults>;
     routePrefix?: string;
     apiRoutes?: ApiRoutesOverride;
+    themeMode?: ThemeMode;
     theming: {
         global?: ThemingScope;
         host?: HostThemingScope;
@@ -531,6 +533,7 @@ interface AppConfigOverrides {
     axiosDefaults?: Partial<AxiosDefaults>;
     routePrefix?: string;
     apiRoutes?: ApiRoutesOverride;
+    themeMode?: ThemeMode;
 }
 
 /**
@@ -1151,7 +1154,7 @@ interface LayoutApi {
     on: (channel: string, handler: (env: BroadcastEnvelope) => void) => () => void;
 }
 
-type KnownTopics = '@history' | '@visibility' | '@message' | '@state-error' | '@layout-change' | '@layout-breakpoint';
+type KnownTopics = '@history' | '@visibility' | '@message' | '@state-error' | '@layout-change' | '@layout-breakpoint' | '@theme';
 type Events = {
     /** Emitted when pages are updated */
     '@history': (data: {
@@ -1169,6 +1172,8 @@ type Events = {
         name: string;
         width: number;
     }) => void;
+    /** Forced theme mode changed (broadcast via SetConfig from the host). */
+    '@theme': (mode: 'auto' | 'light' | 'dark') => void;
 } & {
     [K in string as K extends KnownTopics ? never : K]: (data: WsMessage) => void;
 };
@@ -1344,6 +1349,14 @@ interface ProxyApiInstance {
         layout: LayoutApi;
         bridge: ProxyBridgeApi;
         logout: () => void;
+        /**
+         * Force the host theme mode ('auto' follows the OS; 'light'/'dark' force a
+         * theme). Propagates to the host, all sibling/child iframes, and the parent
+         * website. Subscribe to changes with `on('@theme', mode => ...)`.
+         */
+        setThemeMode: (mode: 'auto' | 'light' | 'dark') => void;
+        /** Current forced theme mode (defaults to 'auto'). */
+        getThemeMode: () => 'auto' | 'light' | 'dark';
     };
     api: AxiosInstance;
     /** @deprecated, use api calls instead */
@@ -1407,6 +1420,7 @@ declare global {
 /** @type {import('tailwindcss').Config} */
 declare const _default: {
     presets: {
+        darkMode: ["variant", string[]];
         theme: {
             extend: {
                 colors: {

package/package.json

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