@syntrologie/runtime-sdk 2.1.0 → 2.2.0-canary.1

package/dist/state/StateStore.d.ts

@@ -1,4 +1,4 @@
-import type { ScopedStorage, DismissalStore, CooldownStore, FrequencyStore } from './types';
+import type { CooldownStore, DismissalStore, FrequencyStore, ScopedStorage } from './types';
 export interface StateStoreOptions {
     /** Namespace prefix for storage keys */
     namespace?: string;

package/dist/state/helpers/cooldowns.d.ts

@@ -3,5 +3,5 @@
  *
  * Tracks time-based cooldowns to prevent items from showing too frequently.
  */
-import type { ScopedStorage, CooldownStore } from '../types';
+import type { CooldownStore, ScopedStorage } from '../types';
 export declare function createCooldownStore(storage: ScopedStorage): CooldownStore;

package/dist/state/helpers/dismissals.d.ts

@@ -3,5 +3,5 @@
  *
  * Tracks dismissed items in session or user storage.
  */
-import type { ScopedStorage, DismissalStore } from '../types';
+import type { DismissalStore, ScopedStorage } from '../types';
 export declare function createDismissalStore(sessionStorage: ScopedStorage, userStorage: ScopedStorage): DismissalStore;

package/dist/state/helpers/frequency.d.ts

@@ -4,5 +4,5 @@
  * Tracks how many times items have been shown or actions taken,
  * optionally resetting after a time window.
  */
-import type { ScopedStorage, FrequencyStore } from '../types';
+import type { FrequencyStore, ScopedStorage } from '../types';
 export declare function createFrequencyStore(storage: ScopedStorage): FrequencyStore;

package/dist/state/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * State module exports.
  */
-export * from './types';
-export * from './schema';
-export { StateStore, createStateStore } from './StateStore';
 export type { StateStoreOptions } from './StateStore';
+export { createStateStore, StateStore } from './StateStore';
+export * from './schema';
+export * from './types';

package/dist/surfaces/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Managed surface system for rendering UI into named slots.
  */
+export { ANIMATION_KEYFRAMES, applyStaticSlotStyles, createSurfaceContainer, getSlotZIndex, playEnterAnimation, playExitAnimation, STATIC_SLOT_STYLES, setupAdjacentPositioning, setupInlinePositioning, } from './positioning';
 export { createSurfaces } from './Surfaces';
-export type { Surfaces, SurfacesOptions, SurfacesWidgetRegistry, MountHandle, SurfaceState, SurfaceChangeCallback, SurfaceSlot, StaticSurfaceSlot, InlineSurfaceSlot, AdjacentSurfaceSlot, RenderableContent, ReactContent, HtmlContent, WidgetContent, CustomContent, MountOptions, PositionConfig, MountConstraints, AnimationType, } from './types';
-export { getSlotType, getSlotAnchorId } from './types';
-export { STATIC_SLOT_STYLES, ANIMATION_KEYFRAMES, applyStaticSlotStyles, setupAdjacentPositioning, setupInlinePositioning, playEnterAnimation, playExitAnimation, createSurfaceContainer, getSlotZIndex, } from './positioning';
+export type { AdjacentSurfaceSlot, AnimationType, CustomContent, HtmlContent, InlineSurfaceSlot, MountConstraints, MountHandle, MountOptions, PositionConfig, ReactContent, RenderableContent, StaticSurfaceSlot, SurfaceChangeCallback, SurfaceSlot, SurfaceState, Surfaces, SurfacesOptions, SurfacesWidgetRegistry, WidgetContent, } from './types';
+export { getSlotAnchorId, getSlotType } from './types';

package/dist/surfaces/positioning.d.ts

@@ -4,7 +4,7 @@
  * Handles positioning for different slot types using CSS for static slots
  * and Floating UI for adjacent slots.
  */
-import type { SurfaceSlot, StaticSurfaceSlot, PositionConfig, MountConstraints, AnimationType } from './types';
+import type { AnimationType, MountConstraints, PositionConfig, StaticSurfaceSlot, SurfaceSlot } from './types';
 /**
  * CSS styles for static surface slots.
  */

package/dist/telemetry/adapters/posthog.d.ts

@@ -5,7 +5,7 @@
  * and use the TelemetryClient interface.
  */
 import type { PostHog, Properties } from 'posthog-js';
-import type { TelemetryClient, CanvasSurface } from '../types';
+import type { CanvasSurface, TelemetryClient } from '../types';
 export interface PostHogAdapterOptions {
     /**
      * PostHog API key.
@@ -67,7 +67,7 @@ interface CanvasAnalyticsPayload extends Properties {
  * Internal adapter that implements TelemetryClient using PostHog.
  */
 export declare class PostHogAdapter implements TelemetryClient {
-    private readonly options;
+    readonly options: PostHogAdapterOptions;
     private client?;
     private featureFlagsCallback?;
     private captureCallback?;

package/dist/telemetry/index.d.ts

@@ -1,4 +1,4 @@
-export type { TelemetryClient, CanvasSurface } from './types';
-export { createPostHogClient } from './adapters/posthog';
-export type { PostHogAdapterOptions } from './adapters/posthog';
 export { createNoopClient } from './adapters/noop';
+export type { PostHogAdapterOptions } from './adapters/posthog';
+export { createPostHogClient } from './adapters/posthog';
+export type { CanvasSurface, TelemetryClient } from './types';

package/dist/telemetry/registry.d.ts

@@ -1,4 +1,4 @@
-import { PostHogAdapterOptions } from './adapters/posthog';
+import { type PostHogAdapterOptions } from './adapters/posthog';
 import type { TelemetryClient } from './types';
 /**
  * Create a telemetry client for the specified provider.

package/dist/theme/ThemeProvider.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import type { CanvasThemeTokens, ThemeAppearance, ThemeMode } from './types';
 interface ThemeContextValue {
     theme: CanvasThemeTokens;

package/dist/theme/extractHostTheme.d.ts

@@ -1,4 +1,4 @@
-import type { ExtractedTheme, CanvasThemeTokens } from './types';
+import type { CanvasThemeTokens, ExtractedTheme } from './types';
 /**
  * Extract theme information from the host page
  */

package/dist/theme/index.d.ts

@@ -1,5 +1,5 @@
-export type { CanvasThemeTokens, ExtractedTheme, ThemeMode, ThemeAppearance } from './types';
-export { darkTheme, lightTheme, getDefaultTheme, themeToCssVariables, withAlpha } from './defaultTheme';
-export { extractHostTheme, mergeWithExtractedTheme, autoDetectTheme } from './extractHostTheme';
-export { ThemeProvider, useTheme, useThemeToken, useThemeVar } from './ThemeProvider';
+export { darkTheme, getDefaultTheme, lightTheme, themeToCssVariables, withAlpha, } from './defaultTheme';
+export { autoDetectTheme, extractHostTheme, mergeWithExtractedTheme } from './extractHostTheme';
 export type { ThemeProviderProps } from './ThemeProvider';
+export { ThemeProvider, useTheme, useThemeToken, useThemeVar } from './ThemeProvider';
+export type { CanvasThemeTokens, ExtractedTheme, ThemeAppearance, ThemeMode } from './types';

package/dist/types-only.d.ts

@@ -29,4 +29,4 @@ export interface EditorPanelProps {
     /** Platform client for API calls (optional) */
     platformClient?: unknown;
 }
-export type { StaticSurfaceSlot, InlineSurfaceSlot, AdjacentSurfaceSlot, SurfaceSlot, HighlightStyle, BadgePosition, TooltipContent, TooltipTrigger, InsertPosition, WidgetConfig, HighlightAction, PulseAction, BadgeAction, TooltipAction, InsertHtmlAction, SetTextAction, SetAttrAction, AddClassAction, RemoveClassAction, SetStyleAction, MountWidgetAction, ScrollToAction, NavigateAction, ActionStep, ActionKind, ActionState, ActionHandle, BatchActionHandle, ActiveAction, ValidationError, ValidationWarning, ValidationResult, ExecutorCleanup, ExecutorUpdate, ExecutorResult, ActionExecutor, ExecutorContext, } from './actions/types';
+export type { ActionExecutor, ActionHandle, ActionKind, ActionState, ActionStep, ActiveAction, AddClassAction, AdjacentSurfaceSlot, BadgeAction, BadgePosition, BatchActionHandle, ExecutorCleanup, ExecutorContext, ExecutorResult, ExecutorUpdate, HighlightAction, HighlightStyle, InlineSurfaceSlot, InsertHtmlAction, InsertPosition, MountWidgetAction, NavigateAction, PulseAction, RemoveClassAction, ScrollToAction, SetAttrAction, SetStyleAction, SetTextAction, StaticSurfaceSlot, SurfaceSlot, TooltipAction, TooltipContent, TooltipTrigger, ValidationError, ValidationResult, ValidationWarning, WidgetConfig, } from './actions/types';

package/dist/types-only.js

@@ -1,11 +1 @@
-/**
- * Types-only export for app packages.
- *
- * This file re-exports action types without importing any runtime code,
- * allowing app packages to import types without circular dependency issues.
- *
- * Apps should import from "@syntrologie/runtime-sdk/types" instead of
- * the main entry point when they only need type definitions.
- */
-export {};
-//# sourceMappingURL=types-only.js.map
+//# sourceMappingURL=types-only.js.map

package/dist/types-only.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"types-only.js","sourceRoot":"","sources":["../src/types-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/types.d.ts

@@ -204,7 +204,7 @@ export interface TableContent {
     maxHeight?: string;
 }
 export type DataContent = StatsContent | ComparisonContent | ChartContent | TableContent;
-export type { ActivationConfig, RouteFilter, DecisionStrategy } from './decisions/types';
+export type { ActivationConfig, DecisionStrategy, RouteFilter } from './decisions/types';
 /**
  * Full tile configuration.
  *

package/dist/version.d.ts

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

package/dist/widgets/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Extensible widget registry for mountable components.
  */
+export type { MountableWidget, MountedWidgetHandle, WidgetCleanup, WidgetRegistration, } from './WidgetRegistry';
 export { WidgetRegistry, widgetRegistry } from './WidgetRegistry';
-export type { MountableWidget, WidgetRegistration, MountedWidgetHandle, WidgetCleanup, } from './WidgetRegistry';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syntrologie/runtime-sdk",
-  "version": "2.1.0",
+  "version": "2.2.0-canary.1",
   "description": "Syntrologie Runtime SDK for web experimentation and analytics",
   "license": "Proprietary",
   "private": false,
@@ -8,7 +8,7 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/SyntropyForge/amazing-demos.git",
-    "directory": "tech-core/sdks/runtime-sdk"
+    "directory": "packages/runtime-sdk"
   },
   "publishConfig": {
     "access": "public"
@@ -46,44 +46,51 @@
   "scripts": {
     "clean": "rm -rf dist",
     "aggregate-capabilities": "node ./scripts/aggregate-capabilities.mjs",
-    "build": "npm run aggregate-capabilities && npm run build:lib && npm run build:cdn",
-    "build:lib": "tsc --project tsconfig.build.json",
+    "generate-schema": "node ./scripts/generate-unified-schema.mjs",
+    "generate-schema:check": "node ./scripts/generate-unified-schema.mjs --check",
+    "build": "npm run aggregate-capabilities && npm run build:types && npm run build:lib && npm run generate-schema && npm run build:cdn",
+    "build:types": "tsc --project tsconfig.build.json",
+    "build:lib": "node ./scripts/build-lib.mjs",
     "build:cdn": "node ./scripts/build-cdn.js",
     "dev:adaptives": "node ./scripts/build-adaptives-only.js --watch",
     "validate-config": "node ./scripts/validate-config.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
     "test": "vitest run",
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
     "@floating-ui/dom": "^1.7.5",
     "@growthbook/growthbook": "~1.6.2",
-    "@growthbook/growthbook-react": "~1.6.2",
-    "@syntro/design-system": "*",
-    "@syntrologie/adapt-content": "2.1.0",
-    "@syntrologie/adapt-overlays": "2.1.0",
+    "@growthbook/growthbook-react": "^1.6.4",
+    "@syntrologie/adapt-content": "2.2.0-canary.1",
+    "@syntrologie/adapt-overlays": "2.2.0-canary.1",
     "posthog-js": "~1.302.2",
-    "zod": "~3.25.0"
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
     "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",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
-    "@types/node": "^25.2.0",
-    "@types/react": "^19.1.0",
-    "@types/react-dom": "^19.1.0",
+    "@types/node": "^22.19.7",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
     "esbuild": "^0.27.2",
-    "jsdom": "^25.0.1",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "jsdom": "^26.1.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "semantic-release": "~25.0.3",
-    "typescript": "~5.7.0",
-    "vitest": "^4.0.18"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "zod-to-json-schema": "^3.25.1"
   }
 }

package/schema/canvas-config.base.schema.json

@@ -0,0 +1,351 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://syntropyforge.com/schemas/smart-canvas-config.json",
+  "title": "Smart Canvas Configuration",
+  "description": "Action-based configuration for Smart Canvas. All interventions are unified as ActionStep.",
+  "type": "object",
+  "required": ["fetchedAt", "tiles", "actions"],
+  "properties": {
+    "fetchedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the config was fetched"
+    },
+    "configVersion": {
+      "type": "string",
+      "description": "Version string for cache invalidation"
+    },
+    "canvasTitle": {
+      "type": "string",
+      "description": "Display title for the canvas"
+    },
+    "tiles": {
+      "type": "array",
+      "description": "Tiles to display in the canvas drawer",
+      "items": { "$ref": "#/$defs/tile" }
+    },
+    "actions": {
+      "type": "array",
+      "description": "Actions to execute. This is the unified intervention format - every DOM change, tooltip, highlight, or modal is an ActionStep.",
+      "items": { "$ref": "#/$defs/actionStep" }
+    },
+    "theme": {
+      "$ref": "#/$defs/themeConfig",
+      "description": "Theme configuration"
+    },
+    "launcher": {
+      "$ref": "#/$defs/launcherConfig",
+      "description": "Launcher button configuration"
+    },
+    "routes": {
+      "$ref": "#/$defs/routesConfig",
+      "description": "Route filtering"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "tile": {
+      "type": "object",
+      "required": ["id", "widget"],
+      "properties": {
+        "id": { "type": "string" },
+        "title": { "type": "string" },
+        "priority": { "type": "number" },
+        "widget": { "type": "string" },
+        "props": { "type": "object" },
+        "notifications": {
+          "type": "array",
+          "description": "Declarative rules mapping EventBus events to toast notifications",
+          "items": {
+            "type": "object",
+            "required": ["on", "title"],
+            "properties": {
+              "on": { "type": "string", "description": "EventBus event name (exact or regex)" },
+              "title": { "type": "string", "description": "Toast title (supports {{props.x}})" },
+              "body": { "type": "string", "description": "Toast body (supports {{props.x}})" },
+              "icon": { "type": "string", "description": "Icon name or emoji" },
+              "ttl": {
+                "type": "number",
+                "description": "Auto-dismiss ms (default 8000)",
+                "default": 8000
+              },
+              "cooldown": {
+                "type": "number",
+                "description": "Cooldown ms (default 30000)",
+                "default": 30000
+              },
+              "deepLink": {
+                "type": "object",
+                "properties": {
+                  "tileId": { "type": "string" },
+                  "itemId": { "type": "string", "description": "Supports {{props.x}}" }
+                },
+                "required": ["tileId"]
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "actionStep": {
+      "oneOf": []
+    },
+    "themeConfig": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "mode": { "type": "string", "enum": ["dark", "light"] },
+        "position": { "type": "string", "enum": ["left", "right"] },
+        "colorPrimary": { "type": "string" },
+        "colorBackground": { "type": "string" },
+        "colorText": { "type": "string" },
+        "borderRadius": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "launcherConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "label": { "type": "string" },
+        "position": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "routesConfig": {
+      "type": "object",
+      "properties": {
+        "exclude": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "include": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "activationConfig": {
+      "type": "object",
+      "description": "Activation configuration for conditional tile rendering",
+      "properties": {
+        "routes": { "$ref": "#/$defs/routeFilter" },
+        "strategy": { "$ref": "#/$defs/decisionStrategy" }
+      },
+      "additionalProperties": false
+    },
+    "routeFilter": {
+      "type": "object",
+      "properties": {
+        "include": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Routes where the tile should appear"
+        },
+        "exclude": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Routes where the tile should NOT appear"
+        }
+      },
+      "additionalProperties": false
+    },
+    "decisionStrategy": {
+      "oneOf": [
+        { "$ref": "#/$defs/ruleStrategy" },
+        { "$ref": "#/$defs/scoreStrategy" },
+        { "$ref": "#/$defs/modelStrategy" },
+        { "$ref": "#/$defs/externalStrategy" }
+      ]
+    },
+    "ruleStrategy": {
+      "type": "object",
+      "required": ["type", "rules", "default"],
+      "properties": {
+        "type": { "const": "rules" },
+        "rules": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/rule" }
+        },
+        "default": {}
+      },
+      "additionalProperties": false
+    },
+    "scoreStrategy": {
+      "type": "object",
+      "required": ["type", "field", "threshold", "above", "below"],
+      "properties": {
+        "type": { "const": "score" },
+        "field": { "type": "string" },
+        "threshold": { "type": "number" },
+        "above": {},
+        "below": {}
+      },
+      "additionalProperties": false
+    },
+    "modelStrategy": {
+      "type": "object",
+      "required": ["type", "modelId", "inputs", "outputMapping", "default"],
+      "properties": {
+        "type": { "const": "model" },
+        "modelId": { "type": "string" },
+        "inputs": { "type": "array", "items": { "type": "string" } },
+        "outputMapping": { "type": "object" },
+        "default": {}
+      },
+      "additionalProperties": false
+    },
+    "externalStrategy": {
+      "type": "object",
+      "required": ["type", "endpoint", "default"],
+      "properties": {
+        "type": { "const": "external" },
+        "endpoint": { "type": "string" },
+        "method": { "enum": ["GET", "POST"] },
+        "default": {},
+        "timeoutMs": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "rule": {
+      "type": "object",
+      "required": ["conditions", "value"],
+      "properties": {
+        "conditions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/condition" }
+        },
+        "value": {}
+      },
+      "additionalProperties": false
+    },
+    "condition": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["type", "url"],
+          "properties": {
+            "type": { "const": "page_url" },
+            "url": { "type": "string" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "routeId"],
+          "properties": {
+            "type": { "const": "route" },
+            "routeId": { "type": "string" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "anchorId", "state"],
+          "properties": {
+            "type": { "const": "anchor_visible" },
+            "anchorId": { "type": "string" },
+            "state": { "enum": ["visible", "present", "absent"] }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "eventName"],
+          "properties": {
+            "type": { "const": "event_occurred" },
+            "eventName": { "type": "string" },
+            "withinMs": { "type": "number" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "key"],
+          "properties": {
+            "type": { "const": "state_equals" },
+            "key": { "type": "string" },
+            "value": {}
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type"],
+          "properties": {
+            "type": { "const": "viewport" },
+            "minWidth": { "type": "number" },
+            "maxWidth": { "type": "number" },
+            "minHeight": { "type": "number" },
+            "maxHeight": { "type": "number" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "key", "operator", "threshold"],
+          "properties": {
+            "type": { "const": "session_metric" },
+            "key": { "type": "string" },
+            "operator": { "enum": ["gte", "lte", "eq", "gt", "lt"] },
+            "threshold": { "type": "number" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "key"],
+          "properties": {
+            "type": { "const": "dismissed" },
+            "key": { "type": "string" },
+            "inverted": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "key"],
+          "properties": {
+            "type": { "const": "cooldown_active" },
+            "key": { "type": "string" },
+            "inverted": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "key", "limit"],
+          "properties": {
+            "type": { "const": "frequency_limit" },
+            "key": { "type": "string" },
+            "limit": { "type": "number" },
+            "inverted": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["type", "key", "operator", "count"],
+          "properties": {
+            "type": { "const": "event_count" },
+            "key": {
+              "type": "string",
+              "description": "Key referencing a callback registered by the adaptive via accumulator.register()"
+            },
+            "operator": { "enum": ["gte", "lte", "eq", "gt", "lt"] },
+            "count": { "type": "integer", "minimum": 0 },
+            "withinMs": {
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "description": "Only count events within this time window (ms). Omit = session lifetime."
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
+}