@syntrologie/runtime-sdk 2.4.1 → 2.6.0-canary.1

package/dist/surfaces/types.d.ts

@@ -5,6 +5,7 @@
  * Surfaces handles layout, stacking, animations, and priority-based arbitration.
  */
 import type { Placement } from '@floating-ui/dom';
+import type { AnchorId } from '../actions/types.js';
 /** Static surface slots with fixed positioning */
 export type StaticSurfaceSlot = 'drawer_right' | 'drawer_left' | 'drawer_bottom' | 'overlay_center' | 'overlay_corner_br' | 'overlay_corner_bl' | 'toast_top' | 'toast_bottom';
 /** Dynamic inline slot (rendered inside anchor) */
@@ -122,7 +123,7 @@ export interface SurfacesOptions {
         publish: (name: string, props?: Record<string, unknown>) => void;
     };
     /** Function to resolve anchor IDs to elements (for inline/adjacent slots) */
-    anchorResolver?: (anchorId: string) => HTMLElement | null;
+    anchorResolver?: (anchorId: AnchorId) => HTMLElement | null;
     /** Default animation type */
     defaultAnimation?: AnimationType;
     /** Widget registry for resolving widget content */

package/dist/theme/ThemeProvider.d.ts

@@ -1,31 +1,26 @@
 import { type ReactNode } from 'react';
-import type { CanvasThemeTokens, ThemeAppearance, ThemeMode } from './types';
+import type { CanvasThemeConfig } from './types';
 interface ThemeContextValue {
-    theme: CanvasThemeTokens;
-    mode: ThemeMode;
+    config: Required<CanvasThemeConfig>;
+    mode: 'light' | 'dark';
     cssVariables: Record<string, string>;
-    setMode: (mode: ThemeMode) => void;
 }
 export interface ThemeProviderProps {
     children: ReactNode;
-    appearance?: ThemeAppearance;
-    autoDetect?: boolean;
+    /** Customer theme overrides (nested by visual element) */
+    themeConfig?: CanvasThemeConfig;
+    /** Workspace-level theme (applied between defaults and config overrides) */
+    workspaceTheme?: CanvasThemeConfig;
     shadowRoot?: ShadowRoot | null;
 }
 /**
- * Theme provider component that injects CSS variables into shadow DOM
+ * Theme provider: config → merge with defaults → flatten to CSS vars → inject into shadow root.
+ * When workspaceTheme is provided, uses 3-layer merge: defaults → workspace → config.
+ * No auto-detection. Fully deterministic.
  */
-export declare function ThemeProvider({ children, appearance, autoDetect, shadowRoot, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThemeProvider({ children, themeConfig, workspaceTheme, shadowRoot, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook to access theme context
  */
 export declare function useTheme(): ThemeContextValue;
-/**
- * Hook to get specific theme token with CSS variable fallback
- */
-export declare function useThemeToken<K extends keyof CanvasThemeTokens>(token: K): string;
-/**
- * Hook to get CSS variable name for a token
- */
-export declare function useThemeVar(token: keyof CanvasThemeTokens): string;
 export {};

package/dist/theme/defaultTheme.d.ts

@@ -1,4 +1,4 @@
-import type { CanvasThemeTokens } from './types';
+import type { CanvasThemeConfig, CanvasThemeTokens } from './types';
 /**
  * Apply alpha transparency to a hex color.
  * Converts a 0-1 alpha value to a 2-digit hex suffix.
@@ -20,3 +20,8 @@ export declare function getDefaultTheme(mode?: 'light' | 'dark'): CanvasThemeTok
  * Convert theme tokens to CSS custom properties
  */
 export declare function themeToCssVariables(theme: CanvasThemeTokens): Record<string, string>;
+export declare const darkDefaults: Required<CanvasThemeConfig>;
+export declare const lightDefaults: Required<CanvasThemeConfig>;
+export declare function mergeThemeConfig(customer: CanvasThemeConfig): Required<CanvasThemeConfig>;
+export declare function mergeThemeWithWorkspace(workspaceTheme: CanvasThemeConfig, configTheme: CanvasThemeConfig): Required<CanvasThemeConfig>;
+export declare function flattenThemeConfig(config: Required<CanvasThemeConfig>): Record<string, string>;

package/dist/theme/index.d.ts

@@ -1,5 +1,4 @@
-export { darkTheme, getDefaultTheme, lightTheme, themeToCssVariables, withAlpha, } from './defaultTheme';
-export { autoDetectTheme, extractHostTheme, mergeWithExtractedTheme } from './extractHostTheme';
+export { darkDefaults, darkTheme, flattenThemeConfig, getDefaultTheme, lightDefaults, lightTheme, mergeThemeConfig, mergeThemeWithWorkspace, themeToCssVariables, withAlpha, } from './defaultTheme';
 export type { ThemeProviderProps } from './ThemeProvider';
-export { ThemeProvider, useTheme, useThemeToken, useThemeVar } from './ThemeProvider';
-export type { CanvasThemeTokens, ExtractedTheme, ThemeAppearance, ThemeMode } from './types';
+export { ThemeProvider, useTheme } from './ThemeProvider';
+export type { CanvasElementConfig, CanvasThemeConfig, CanvasThemeTokens, LauncherElementConfig, NotificationElementConfig, OverlayElementConfig, ThemeAppearance, ThemeMode, TileElementConfig, } from './types';

package/dist/theme/types.d.ts

@@ -2,8 +2,18 @@
  * Theme token definitions for Smart Canvas
  * Inspired by macOS design language and react.email aesthetics
  */
+import type { z } from 'zod';
+import type { CanvasElementConfigZ, ContentElementConfigZ, LauncherElementConfigZ, NotificationElementConfigZ, OverlayElementConfigZ, TileElementConfigZ } from '../config/schema';
+export type CanvasElementConfig = z.infer<typeof CanvasElementConfigZ>;
+export type LauncherElementConfig = z.infer<typeof LauncherElementConfigZ>;
+export type TileElementConfig = z.infer<typeof TileElementConfigZ>;
+export type OverlayElementConfig = z.infer<typeof OverlayElementConfigZ>;
+export type NotificationElementConfig = z.infer<typeof NotificationElementConfigZ>;
+export type ContentElementConfig = z.infer<typeof ContentElementConfigZ>;
+export type { CanvasThemeConfig } from '../types';
 /**
  * Complete theme token interface
+ * @deprecated Use CanvasThemeConfig instead
  */
 export interface CanvasThemeTokens {
     colorPrimary: string;
@@ -72,6 +82,7 @@ export interface CanvasThemeTokens {
 }
 /**
  * Theme extracted from host page CSS variables
+ * @deprecated Use CanvasThemeConfig instead
  */
 export interface ExtractedTheme {
     primaryColor: string | null;

package/dist/version.d.ts

@@ -10,4 +10,4 @@
  *
  * @since 2.0.0
  */
-export declare const SDK_VERSION = "2.4.1";
+export declare const SDK_VERSION = "2.6.0-canary.1";

package/dist/widgets/WidgetRegistry.d.ts

@@ -47,6 +47,7 @@ export interface WidgetRegistration {
         name?: string;
         description?: string;
         icon?: string;
+        subtitle?: string;
     };
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntrologie/runtime-sdk",
-  "version": "2.4.1",
+  "version": "2.6.0-canary.1",
   "description": "Syntrologie Runtime SDK for web experimentation and analytics",
   "license": "Proprietary",
   "private": false,
@@ -67,12 +67,13 @@
     "@floating-ui/dom": "^1.7.5",
     "@growthbook/growthbook": "~1.6.2",
     "@growthbook/growthbook-react": "^1.6.4",
-    "@syntrologie/adapt-chatbot": "2.4.1",
-    "@syntrologie/adapt-content": "2.4.1",
-    "@syntrologie/adapt-faq": "2.4.1",
-    "@syntrologie/adapt-gamification": "2.4.1",
-    "@syntrologie/adapt-nav": "2.4.1",
-    "@syntrologie/adapt-overlays": "2.4.1",
+    "@syntrologie/adapt-chatbot": "2.6.0-canary.1",
+    "@syntrologie/adapt-content": "2.6.0-canary.1",
+    "@syntrologie/adapt-faq": "2.6.0-canary.1",
+    "@syntrologie/adapt-gamification": "2.6.0-canary.1",
+    "@syntrologie/adapt-nav": "2.6.0-canary.1",
+    "@syntrologie/adapt-overlays": "2.6.0-canary.1",
+    "lucide-react": "^0.576.0",
     "posthog-js": "~1.302.2",
     "zod": "^3.25.76"
   },
@@ -81,10 +82,10 @@
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
-    "@syntro/design-system": "*",
     "@semantic-release/exec": "~7.1.0",
     "@semantic-release/github": "~12.0.3",
     "@semantic-release/npm": "~13.1.3",
+    "@syntro/design-system": "*",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",