@syntrologie/runtime-sdk 0.2.21 → 1.0.0

package/dist/widgets/WidgetRegistry.js

@@ -0,0 +1,191 @@
+/**
+ * Widget Registry
+ *
+ * Extensible registry for mountable widget components.
+ * Apps can register custom widgets that can be rendered via mountWidget actions.
+ */
+/**
+ * Extensible registry for widget components.
+ *
+ * Allows apps to register custom widgets that can be rendered via
+ * mountWidget actions or directly through the Surfaces system.
+ */
+export class WidgetRegistry {
+    constructor() {
+        this.widgets = new Map();
+        this.mountedWidgets = new Map();
+        this.mountIdCounter = 0;
+        // Built-in widgets can be registered here if needed
+    }
+    /**
+     * Bind a runtime reference so it can be injected into widget mount() calls.
+     * Uses `unknown` to avoid circular imports (WidgetRegistry ← runtime.ts).
+     */
+    bindRuntime(runtime) {
+        this.runtimeRef = runtime;
+    }
+    /**
+     * Register a widget.
+     *
+     * @param id - The widget ID (e.g., "gamification:leaderboard")
+     * @param widget - The widget component
+     * @param source - The source app ID (for tracking)
+     * @param metadata - Optional metadata about the widget
+     */
+    register(id, widget, source = 'custom', metadata) {
+        if (this.widgets.has(id)) {
+            const existing = this.widgets.get(id);
+            if (existing.source === 'built-in') {
+                throw new Error(`Cannot override built-in widget: ${id}`);
+            }
+            console.warn(`[WidgetRegistry] Overriding widget: ${id}`);
+        }
+        this.widgets.set(id, {
+            id,
+            widget,
+            source,
+            metadata,
+        });
+    }
+    /**
+     * Unregister a widget.
+     *
+     * @param id - The widget ID to unregister
+     * @returns true if the widget was unregistered, false if not found or built-in
+     */
+    unregister(id) {
+        const existing = this.widgets.get(id);
+        if (!existing) {
+            return false;
+        }
+        if (existing.source === 'built-in') {
+            console.warn(`[WidgetRegistry] Cannot unregister built-in widget: ${id}`);
+            return false;
+        }
+        this.widgets.delete(id);
+        return true;
+    }
+    /**
+     * Unregister all widgets from a specific source.
+     *
+     * @param source - The source app ID
+     */
+    unregisterBySource(source) {
+        for (const [id, registration] of this.widgets.entries()) {
+            if (registration.source === source) {
+                this.widgets.delete(id);
+            }
+        }
+    }
+    /**
+     * Get a widget by ID.
+     */
+    get(id) {
+        var _a;
+        return (_a = this.widgets.get(id)) === null || _a === void 0 ? void 0 : _a.widget;
+    }
+    /**
+     * Get the full registration for a widget.
+     */
+    getRegistration(id) {
+        return this.widgets.get(id);
+    }
+    /**
+     * Check if a widget exists.
+     */
+    has(id) {
+        return this.widgets.has(id);
+    }
+    /**
+     * Mount a widget into a container.
+     *
+     * @param id - The widget ID
+     * @param container - The DOM element to mount into
+     * @param config - Configuration/props for the widget
+     * @returns A handle for managing the mounted widget
+     */
+    mount(id, container, config) {
+        const registration = this.widgets.get(id);
+        if (!registration) {
+            throw new Error(`Widget not found: ${id}`);
+        }
+        const mountId = `widget-mount-${++this.mountIdCounter}`;
+        container.setAttribute('data-widget-mount-id', mountId);
+        container.setAttribute('data-widget-id', id);
+        // Mount the widget — inject runtime so widgets can render as React components
+        const enrichedConfig = { ...config, runtime: this.runtimeRef };
+        const cleanup = registration.widget.mount(container, enrichedConfig);
+        // Track the mounted widget
+        this.mountedWidgets.set(mountId, {
+            cleanup: cleanup !== null && cleanup !== void 0 ? cleanup : undefined,
+            container,
+        });
+        const handle = {
+            widgetId: id,
+            container,
+            unmount: () => {
+                var _a;
+                const mounted = this.mountedWidgets.get(mountId);
+                if (mounted) {
+                    (_a = mounted.cleanup) === null || _a === void 0 ? void 0 : _a.call(mounted);
+                    this.mountedWidgets.delete(mountId);
+                    container.removeAttribute('data-widget-mount-id');
+                    container.removeAttribute('data-widget-id');
+                    container.innerHTML = '';
+                }
+            },
+            update: (newConfig) => {
+                var _a;
+                if (registration.widget.update) {
+                    registration.widget.update(container, newConfig);
+                }
+                else {
+                    // Unmount and remount with new config
+                    const mounted = this.mountedWidgets.get(mountId);
+                    if (mounted) {
+                        (_a = mounted.cleanup) === null || _a === void 0 ? void 0 : _a.call(mounted);
+                        container.innerHTML = '';
+                        const enrichedNewConfig = { ...newConfig, runtime: this.runtimeRef };
+                        const newCleanup = registration.widget.mount(container, enrichedNewConfig);
+                        mounted.cleanup = newCleanup !== null && newCleanup !== void 0 ? newCleanup : undefined;
+                    }
+                }
+            },
+        };
+        return handle;
+    }
+    /**
+     * List all registered widget IDs.
+     */
+    list() {
+        return Array.from(this.widgets.keys());
+    }
+    /**
+     * List all registrations.
+     */
+    listRegistrations() {
+        return Array.from(this.widgets.values());
+    }
+    /**
+     * Get all widgets from a specific source.
+     */
+    getBySource(source) {
+        return Array.from(this.widgets.values()).filter((registration) => registration.source === source);
+    }
+    /**
+     * Clean up all mounted widgets.
+     */
+    destroy() {
+        var _a;
+        for (const [_mountId, mounted] of this.mountedWidgets.entries()) {
+            (_a = mounted.cleanup) === null || _a === void 0 ? void 0 : _a.call(mounted);
+            mounted.container.innerHTML = '';
+        }
+        this.mountedWidgets.clear();
+    }
+}
+/**
+ * Default singleton instance of WidgetRegistry.
+ */
+export const widgetRegistry = new WidgetRegistry();
+//# sourceMappingURL=WidgetRegistry.js.map

package/dist/widgets/WidgetRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetRegistry.js","sourceRoot":"","sources":["../../src/widgets/WidgetRegistry.ts"],"names":[],"mappings":"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"}

package/dist/widgets/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Widgets Module
+ *
+ * Extensible widget registry for mountable components.
+ */
+export { WidgetRegistry, widgetRegistry } from './WidgetRegistry';
+export type { MountableWidget, WidgetRegistration, MountedWidgetHandle, WidgetCleanup, } from './WidgetRegistry';

package/dist/widgets/index.js

@@ -0,0 +1,7 @@
+/**
+ * Widgets Module
+ *
+ * Extensible widget registry for mountable components.
+ */
+export { WidgetRegistry, widgetRegistry } from './WidgetRegistry';
+//# sourceMappingURL=index.js.map

package/dist/widgets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@syntrologie/runtime-sdk",
-  "version": "0.2.21",
+  "version": "1.0.0",
   "description": "Syntrologie Runtime SDK for web experimentation and analytics",
-  "license": "UNLICENSED",
+  "license": "Proprietary",
   "private": false,
-  "author": "Syntrologie Team <team@syntrologie.com>",
+  "author": "Syntrologie <eng@syntrologie.com>",
   "repository": {
     "type": "git",
-    "url": "https://github.com/syntrologie/tech-core.git",
-    "directory": "sdks/runtime-sdk"
+    "url": "https://github.com/SyntropyForge/amazing-demos.git",
+    "directory": "tech-core/sdks/runtime-sdk"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "type": "module",
   "main": "dist/index.js",
@@ -20,6 +23,10 @@
       "import": "./dist/index.js",
       "require": "./dist/index.js"
     },
+    "./types": {
+      "types": "./dist/types-only.d.ts",
+      "import": "./dist/types-only.js"
+    },
     "./react": {
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js",
@@ -34,24 +41,26 @@
     "dist",
     "schema",
     "scripts/validate-config.mjs",
-    "README.md",
     "CAPABILITIES.md"
   ],
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run build:lib && npm run build:cdn",
+    "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",
     "build:cdn": "node ./scripts/build-cdn.js",
     "validate-config": "node ./scripts/validate-config.mjs",
+    "test": "vitest run",
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@floating-ui/dom": "~1.6.13",
+    "@floating-ui/dom": "^1.7.5",
     "@growthbook/growthbook": "~1.6.2",
     "@growthbook/growthbook-react": "~1.6.2",
+    "@syntro/design-system": "*",
+    "@syntrologie/adapt-content": "1.0.0",
+    "@syntrologie/adapt-overlays": "1.0.0",
     "posthog-js": "~1.302.2",
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
     "zod": "~3.25.0"
   },
   "peerDependencies": {
@@ -59,10 +68,21 @@
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.0.9",
-    "@types/react": "~18.3.0",
-    "@types/react-dom": "~18.3.0",
-    "esbuild": "~0.25.0",
-    "typescript": "~5.7.0"
+    "@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",
+    "esbuild": "^0.27.2",
+    "jsdom": "^25.0.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "semantic-release": "~25.0.3",
+    "typescript": "~5.7.0",
+    "vitest": "^4.0.18"
   }
 }