@syntrologie/runtime-sdk 1.0.1 → 2.0.0

package/dist/store/example.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/store/example.js

@@ -0,0 +1,43 @@
+/**
+ * Example usage of mini-effector
+ */
+import { createEvent, createStore, createEffect, sample } from "./mini-effector";
+// Events
+const tooltipDismissed = createEvent();
+const tourStepCompleted = createEvent();
+const pageViewed = createEvent();
+// Stores
+const $dismissedTooltips = createStore([]);
+const $tourProgress = createStore({});
+// Connect events → stores
+$dismissedTooltips.on(tooltipDismissed, (list, { anchorId }) => [...list, anchorId]);
+$tourProgress.on(tourStepCompleted, (progress, { tourId, step }) => ({
+    ...progress,
+    [tourId]: step,
+}));
+// Effect (async side effect)
+const saveProgressFx = createEffect(async (data) => {
+    console.log("Saving progress:", data);
+    // await api.saveProgress(data);
+    return { saved: true };
+});
+// Wire event → effect with filter
+sample({
+    clock: tourStepCompleted,
+    filter: ({ step }) => step > 0, // Only save after first step
+    fn: ({ tourId, step }) => ({ tourId, step }),
+    target: saveProgressFx,
+});
+// Watch for debugging
+$dismissedTooltips.watch(list => console.log("Dismissed:", list));
+$tourProgress.watch(progress => console.log("Progress:", progress));
+saveProgressFx.done.watch(({ result }) => console.log("Saved:", result));
+// Test it
+console.log("--- Testing mini-effector ---");
+tooltipDismissed({ anchorId: "#hero" });
+tooltipDismissed({ anchorId: "#cta" });
+tourStepCompleted({ tourId: "onboarding", step: 1 });
+tourStepCompleted({ tourId: "onboarding", step: 2 });
+console.log("Final dismissed:", $dismissedTooltips.getState());
+console.log("Final progress:", $tourProgress.getState());
+//# sourceMappingURL=example.js.map

package/dist/store/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/store/example.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEjF,SAAS;AACT,MAAM,gBAAgB,GAAG,WAAW,EAAwB,CAAC;AAC7D,MAAM,iBAAiB,GAAG,WAAW,EAAoC,CAAC;AAC1E,MAAM,UAAU,GAAG,WAAW,EAAmB,CAAC;AAElD,SAAS;AACT,MAAM,kBAAkB,GAAG,WAAW,CAAW,EAAE,CAAC,CAAC;AACrD,MAAM,aAAa,GAAG,WAAW,CAAyB,EAAE,CAAC,CAAC;AAE9D,0BAA0B;AAC1B,kBAAkB,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AAErF,aAAa,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACnE,GAAG,QAAQ;IACX,CAAC,MAAM,CAAC,EAAE,IAAI;CACf,CAAC,CAAC,CAAC;AAEJ,6BAA6B;AAC7B,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,EAAE,IAAsC,EAAE,EAAE;IACnF,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACtC,gCAAgC;IAChC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC,CAAC,CAAC;AAEH,kCAAkC;AAClC,MAAM,CAAC;IACL,KAAK,EAAE,iBAAiB;IACxB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,EAAE,6BAA6B;IAC7D,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC5C,MAAM,EAAE,cAAc;CACvB,CAAC,CAAC;AAEH,sBAAsB;AACtB,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;AAClE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzE,UAAU;AACV,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC7C,gBAAgB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACvC,iBAAiB,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AACrD,iBAAiB,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAErD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/D,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC"}

package/dist/store/mini-effector.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mini Effector - Minimal event→state implementation
+ *
+ * Core concepts from Effector in ~100 lines:
+ * - createEvent: callable + subscribable
+ * - createStore: reactive state with .on() for event connections
+ * - sample: connect clock → source → filter → target
+ */
+type Subscriber<T> = (payload: T) => void;
+export interface Event<T> {
+    (payload: T): void;
+    watch(fn: Subscriber<T>): () => void;
+    /** Internal: get subscribers for sample() */
+    _subscribers: Set<Subscriber<T>>;
+}
+export declare function createEvent<T = void>(): Event<T>;
+export interface Store<T> {
+    getState(): T;
+    watch(fn: Subscriber<T>): () => void;
+    on<E>(event: Event<E>, reducer: (state: T, payload: E) => T): Store<T>;
+    /** Internal: update state */
+    _setState(value: T): void;
+}
+export declare function createStore<T>(initialState: T): Store<T>;
+export interface Effect<T, R> {
+    (payload: T): Promise<R>;
+    done: Event<{
+        params: T;
+        result: R;
+    }>;
+    fail: Event<{
+        params: T;
+        error: Error;
+    }>;
+    pending: Store<boolean>;
+}
+export declare function createEffect<T, R>(handler: (payload: T) => Promise<R>): Effect<T, R>;
+interface SampleConfig<Clock, Source, Target, EffectResult = unknown> {
+    clock: Event<Clock>;
+    source?: Store<Source>;
+    filter?: (clockPayload: Clock, sourceState?: Source) => boolean;
+    fn?: (clockPayload: Clock, sourceState?: Source) => Target;
+    target?: Event<Target> | Effect<Target, EffectResult>;
+}
+export declare function sample<Clock, Source, Target, EffectResult = unknown>(config: SampleConfig<Clock, Source, Target, EffectResult>): void;
+export {};

package/dist/store/mini-effector.js

@@ -0,0 +1,90 @@
+/**
+ * Mini Effector - Minimal event→state implementation
+ *
+ * Core concepts from Effector in ~100 lines:
+ * - createEvent: callable + subscribable
+ * - createStore: reactive state with .on() for event connections
+ * - sample: connect clock → source → filter → target
+ */
+export function createEvent() {
+    const subscribers = new Set();
+    const event = ((payload) => {
+        subscribers.forEach(fn => fn(payload));
+    });
+    event.watch = (fn) => {
+        subscribers.add(fn);
+        return () => subscribers.delete(fn);
+    };
+    event._subscribers = subscribers;
+    return event;
+}
+export function createStore(initialState) {
+    let state = initialState;
+    const subscribers = new Set();
+    const store = {
+        getState: () => state,
+        watch: (fn) => {
+            subscribers.add(fn);
+            return () => subscribers.delete(fn);
+        },
+        on: (event, reducer) => {
+            event.watch(payload => {
+                const nextState = reducer(state, payload);
+                if (nextState !== state) {
+                    state = nextState;
+                    subscribers.forEach(fn => fn(state));
+                }
+            });
+            return store;
+        },
+        _setState: (value) => {
+            if (value !== state) {
+                state = value;
+                subscribers.forEach(fn => fn(state));
+            }
+        },
+    };
+    return store;
+}
+export function createEffect(handler) {
+    const done = createEvent();
+    const fail = createEvent();
+    const pending = createStore(false);
+    pending.on(done, () => false);
+    pending.on(fail, () => false);
+    const effect = (async (payload) => {
+        pending._setState(true);
+        try {
+            const result = await handler(payload);
+            done({ params: payload, result });
+            return result;
+        }
+        catch (err) {
+            fail({ params: payload, error: err });
+            throw err;
+        }
+    });
+    effect.done = done;
+    effect.fail = fail;
+    effect.pending = pending;
+    return effect;
+}
+export function sample(config) {
+    const { clock, source, filter, fn, target } = config;
+    clock.watch(clockPayload => {
+        const sourceState = source === null || source === void 0 ? void 0 : source.getState();
+        // Check filter
+        if (filter && !filter(clockPayload, sourceState)) {
+            return;
+        }
+        // Transform
+        const result = fn
+            ? fn(clockPayload, sourceState)
+            : clockPayload;
+        // Send to target
+        if (target) {
+            target(result);
+        }
+    });
+}
+//# sourceMappingURL=mini-effector.js.map

package/dist/store/mini-effector.js.map

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

package/dist/surfaces/Surfaces.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Surfaces
+ *
+ * Managed surface system for rendering UI into named slots.
+ * Handles layout, stacking, animations, and priority-based arbitration.
+ */
+import type { Surfaces, SurfacesOptions } from "./types";
+/**
+ * Create a Surfaces instance.
+ */
+export declare function createSurfaces(options: SurfacesOptions): Surfaces;

package/dist/surfaces/Surfaces.js

@@ -0,0 +1,361 @@
+/**
+ * Surfaces
+ *
+ * Managed surface system for rendering UI into named slots.
+ * Handles layout, stacking, animations, and priority-based arbitration.
+ */
+import { getSlotType, getSlotAnchorId } from "./types";
+import { sanitizeWithFallback } from "../hostPatcher/core/sanitizer";
+import { applyStaticSlotStyles, setupAdjacentPositioning, setupInlinePositioning, playEnterAnimation, playExitAnimation, createSurfaceContainer, getSlotZIndex, } from "./positioning";
+/** Counter for generating unique mount IDs */
+let mountIdCounter = 0;
+/**
+ * Create a Surfaces instance.
+ */
+export function createSurfaces(options) {
+    const { overlayRoot, eventBus, anchorResolver, defaultAnimation = "fade", widgetRegistry, } = options;
+    /** Map of current mounts by slot */
+    const mounts = new Map();
+    /** Map of mount counts by slot (for stats) */
+    const mountCounts = new Map();
+    /** Map of state change callbacks by slot */
+    const stateCallbacks = new Map();
+    /**
+     * Generate a unique mount ID.
+     */
+    function generateMountId() {
+        return `mount-${++mountIdCounter}`;
+    }
+    /**
+     * Publish an event to the EventBus if available.
+     */
+    function publishEvent(name, props) {
+        if (eventBus) {
+            eventBus.publish(name, props);
+        }
+    }
+    /**
+     * Notify state change callbacks for a slot.
+     */
+    function notifyStateChange(slot) {
+        const callbacks = stateCallbacks.get(slot);
+        if (callbacks) {
+            const state = getState(slot);
+            for (const callback of callbacks) {
+                try {
+                    callback(state);
+                }
+                catch (error) {
+                    console.error("[Surfaces] State callback error:", error);
+                }
+            }
+        }
+    }
+    /** Track mounted widget handles for cleanup */
+    const widgetHandles = new Map();
+    /**
+     * Render content into a container.
+     */
+    function renderContent(container, content, mountId) {
+        switch (content.type) {
+            case "html":
+                container.innerHTML = sanitizeWithFallback(content.content);
+                return undefined;
+            case "widget": {
+                // Use widget registry if available
+                if (widgetRegistry && widgetRegistry.has(content.widgetId)) {
+                    const handle = widgetRegistry.mount(content.widgetId, container, content.config);
+                    if (mountId) {
+                        widgetHandles.set(mountId, handle);
+                    }
+                    return () => {
+                        handle.unmount();
+                        if (mountId) {
+                            widgetHandles.delete(mountId);
+                        }
+                    };
+                }
+                // Fallback: create a placeholder if widget not found
+                console.warn(`[Surfaces] Widget not found: ${content.widgetId}`);
+                container.innerHTML = `<div data-widget-id="${content.widgetId}" data-widget-missing="true">Widget: ${content.widgetId}</div>`;
+                return undefined;
+            }
+            case "custom":
+                return content.mount(container);
+            case "react":
+                // React rendering would require ReactDOM
+                // For now, create a placeholder
+                container.innerHTML = `<div data-react-component>React Component</div>`;
+                return undefined;
+            default:
+                console.warn("[Surfaces] Unknown content type");
+                return undefined;
+        }
+    }
+    /**
+     * Mount content to a surface slot.
+     */
+    function mount(slot, content, opts) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const id = generateMountId();
+        const slotType = getSlotType(slot);
+        const priority = (_a = opts === null || opts === void 0 ? void 0 : opts.priority) !== null && _a !== void 0 ? _a : 0;
+        const animation = (_b = opts === null || opts === void 0 ? void 0 : opts.animation) !== null && _b !== void 0 ? _b : defaultAnimation;
+        const exclusive = (_c = opts === null || opts === void 0 ? void 0 : opts.exclusive) !== null && _c !== void 0 ? _c : true;
+        // Check for existing mount
+        const existingMount = mounts.get(slot);
+        if (existingMount) {
+            if (exclusive) {
+                // Priority-based arbitration
+                if (existingMount.options.priority > priority) {
+                    throw new Error(`Slot ${slot} is occupied by higher priority content (${existingMount.options.priority} > ${priority})`);
+                }
+                // Unmount existing content
+                unmountEntry(existingMount);
+            }
+        }
+        // Create container
+        const container = createSurfaceContainer(slot, id);
+        container.style.zIndex = String(getSlotZIndex(slot));
+        // Set up positioning based on slot type
+        let positionCleanup;
+        if (slotType === "static") {
+            applyStaticSlotStyles(container, slot, opts === null || opts === void 0 ? void 0 : opts.constraints);
+            overlayRoot.appendChild(container);
+        }
+        else if (slotType === "inline") {
+            const anchorId = getSlotAnchorId(slot);
+            if (!anchorId) {
+                throw new Error(`Invalid inline slot: ${slot}`);
+            }
+            if (!anchorResolver) {
+                throw new Error("Anchor resolver required for inline slots");
+            }
+            const anchorEl = anchorResolver(anchorId);
+            if (!anchorEl) {
+                throw new Error(`Anchor not found for inline slot: ${anchorId}`);
+            }
+            positionCleanup = setupInlinePositioning(container, anchorEl);
+        }
+        else if (slotType === "adjacent") {
+            const anchorId = getSlotAnchorId(slot);
+            if (!anchorId) {
+                throw new Error(`Invalid adjacent slot: ${slot}`);
+            }
+            if (!anchorResolver) {
+                throw new Error("Anchor resolver required for adjacent slots");
+            }
+            const anchorEl = anchorResolver(anchorId);
+            if (!anchorEl) {
+                throw new Error(`Anchor not found for adjacent slot: ${anchorId}`);
+            }
+            overlayRoot.appendChild(container);
+            positionCleanup = setupAdjacentPositioning(container, anchorEl, (_d = opts === null || opts === void 0 ? void 0 : opts.position) !== null && _d !== void 0 ? _d : { placement: "bottom" });
+        }
+        // Render content
+        const contentCleanup = renderContent(container, content, id);
+        // Play enter animation
+        playEnterAnimation(container, animation);
+        // Create internal entry
+        const entry = {
+            id,
+            slot,
+            content,
+            options: {
+                priority,
+                exclusive,
+                animation,
+                position: (_e = opts === null || opts === void 0 ? void 0 : opts.position) !== null && _e !== void 0 ? _e : { placement: "auto" },
+                constraints: (_f = opts === null || opts === void 0 ? void 0 : opts.constraints) !== null && _f !== void 0 ? _f : {},
+                adaptiveId: opts === null || opts === void 0 ? void 0 : opts.adaptiveId,
+                autoUnmountOnRouteChange: (_g = opts === null || opts === void 0 ? void 0 : opts.autoUnmountOnRouteChange) !== null && _g !== void 0 ? _g : true,
+            },
+            container,
+            cleanup: () => {
+                positionCleanup === null || positionCleanup === void 0 ? void 0 : positionCleanup();
+                contentCleanup === null || contentCleanup === void 0 ? void 0 : contentCleanup();
+            },
+            mountedAt: Date.now(),
+        };
+        // Store mount
+        mounts.set(slot, entry);
+        // Update mount count
+        mountCounts.set(slot, ((_h = mountCounts.get(slot)) !== null && _h !== void 0 ? _h : 0) + 1);
+        // Publish event
+        publishEvent("surface.mounted", {
+            slot,
+            id,
+            adaptiveId: opts === null || opts === void 0 ? void 0 : opts.adaptiveId,
+        });
+        // Notify state change
+        notifyStateChange(slot);
+        // Create and return handle
+        const handle = {
+            id,
+            update(newContent) {
+                const entry = mounts.get(slot);
+                if (!entry || entry.id !== id) {
+                    throw new Error("Mount no longer active");
+                }
+                // Clean up existing widget handle if present
+                const existingWidgetHandle = widgetHandles.get(id);
+                if (existingWidgetHandle) {
+                    // If content is a widget and we have an update method, use it
+                    if (newContent.type === "widget") {
+                        existingWidgetHandle.update(newContent.config);
+                        entry.content = newContent;
+                        return;
+                    }
+                    // Otherwise, unmount the old widget
+                    existingWidgetHandle.unmount();
+                    widgetHandles.delete(id);
+                }
+                // Clear existing content
+                entry.container.innerHTML = "";
+                // Render new content
+                const newCleanup = renderContent(entry.container, newContent, id);
+                entry.content = newContent;
+                // Update cleanup if needed
+                if (newCleanup) {
+                    const oldCleanup = entry.cleanup;
+                    entry.cleanup = () => {
+                        oldCleanup === null || oldCleanup === void 0 ? void 0 : oldCleanup();
+                        newCleanup();
+                    };
+                }
+            },
+            setOptions(newOpts) {
+                const entry = mounts.get(slot);
+                if (!entry || entry.id !== id) {
+                    throw new Error("Mount no longer active");
+                }
+                // Update options
+                if (newOpts.priority !== undefined) {
+                    entry.options.priority = newOpts.priority;
+                }
+                if (newOpts.animation !== undefined) {
+                    entry.options.animation = newOpts.animation;
+                }
+                // Re-apply constraints if changed
+                if (newOpts.constraints && slotType === "static") {
+                    if (newOpts.constraints.maxWidth)
+                        entry.container.style.maxWidth = newOpts.constraints.maxWidth;
+                    if (newOpts.constraints.maxHeight)
+                        entry.container.style.maxHeight = newOpts.constraints.maxHeight;
+                    if (newOpts.constraints.minWidth)
+                        entry.container.style.minWidth = newOpts.constraints.minWidth;
+                    if (newOpts.constraints.minHeight)
+                        entry.container.style.minHeight = newOpts.constraints.minHeight;
+                }
+                notifyStateChange(slot);
+            },
+            async unmount() {
+                const entry = mounts.get(slot);
+                if (!entry || entry.id !== id)
+                    return;
+                await unmountEntry(entry);
+            },
+            isMounted() {
+                const entry = mounts.get(slot);
+                return (entry === null || entry === void 0 ? void 0 : entry.id) === id;
+            },
+            getContainer() {
+                const entry = mounts.get(slot);
+                return (entry === null || entry === void 0 ? void 0 : entry.id) === id ? entry.container : null;
+            },
+        };
+        return handle;
+    }
+    /**
+     * Unmount an entry with animation.
+     */
+    async function unmountEntry(entry) {
+        var _a;
+        // Play exit animation
+        await playExitAnimation(entry.container, entry.options.animation);
+        // Run cleanup
+        (_a = entry.cleanup) === null || _a === void 0 ? void 0 : _a.call(entry);
+        // Remove container
+        entry.container.remove();
+        // Remove from mounts
+        mounts.delete(entry.slot);
+        // Publish event
+        publishEvent("surface.unmounted", {
+            slot: entry.slot,
+            id: entry.id,
+        });
+        // Notify state change
+        notifyStateChange(entry.slot);
+    }
+    /**
+     * Get the current state of a slot.
+     */
+    function getState(slot) {
+        var _a;
+        const entry = mounts.get(slot);
+        return {
+            slot,
+            occupied: !!entry,
+            currentPriority: entry === null || entry === void 0 ? void 0 : entry.options.priority,
+            currentAdaptiveId: entry === null || entry === void 0 ? void 0 : entry.options.adaptiveId,
+            mountCount: (_a = mountCounts.get(slot)) !== null && _a !== void 0 ? _a : 0,
+            currentMountId: entry === null || entry === void 0 ? void 0 : entry.id,
+        };
+    }
+    /**
+     * Subscribe to state changes for a slot.
+     */
+    function onStateChange(slot, fn) {
+        let callbacks = stateCallbacks.get(slot);
+        if (!callbacks) {
+            callbacks = new Set();
+            stateCallbacks.set(slot, callbacks);
+        }
+        callbacks.add(fn);
+        return () => {
+            callbacks === null || callbacks === void 0 ? void 0 : callbacks.delete(fn);
+            if ((callbacks === null || callbacks === void 0 ? void 0 : callbacks.size) === 0) {
+                stateCallbacks.delete(slot);
+            }
+        };
+    }
+    /**
+     * Check if content can be mounted to a slot.
+     */
+    function canMount(slot, priority) {
+        const existingMount = mounts.get(slot);
+        if (!existingMount)
+            return true;
+        // Check priority if provided
+        if (priority !== undefined) {
+            return priority >= existingMount.options.priority;
+        }
+        return false;
+    }
+    /**
+     * Clean up all mounted surfaces.
+     */
+    function destroy() {
+        var _a;
+        // Unmount all surfaces
+        for (const entry of mounts.values()) {
+            try {
+                (_a = entry.cleanup) === null || _a === void 0 ? void 0 : _a.call(entry);
+                entry.container.remove();
+            }
+            catch (error) {
+                console.error("[Surfaces] Error during cleanup:", error);
+            }
+        }
+        mounts.clear();
+        stateCallbacks.clear();
+    }
+    return {
+        mount,
+        getState,
+        onStateChange,
+        canMount,
+        destroy,
+    };
+}
+//# sourceMappingURL=Surfaces.js.map

package/dist/surfaces/Surfaces.js.map

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

package/dist/surfaces/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Surfaces Module
+ *
+ * Managed surface system for rendering UI into named slots.
+ */
+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";

package/dist/surfaces/index.js

@@ -0,0 +1,12 @@
+/**
+ * Surfaces Module
+ *
+ * Managed surface system for rendering UI into named slots.
+ */
+// Main factory
+export { createSurfaces } from "./Surfaces";
+// Utilities
+export { getSlotType, getSlotAnchorId } from "./types";
+// Positioning (for advanced usage)
+export { STATIC_SLOT_STYLES, ANIMATION_KEYFRAMES, applyStaticSlotStyles, setupAdjacentPositioning, setupInlinePositioning, playEnterAnimation, playExitAnimation, createSurfaceContainer, getSlotZIndex, } from "./positioning";
+//# sourceMappingURL=index.js.map

package/dist/surfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgC5C,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/surfaces/positioning.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Surfaces Positioning
+ *
+ * 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";
+/**
+ * CSS styles for static surface slots.
+ */
+export declare const STATIC_SLOT_STYLES: Record<StaticSurfaceSlot, Record<string, string>>;
+/**
+ * Animation keyframes for different animation types.
+ */
+export declare const ANIMATION_KEYFRAMES: Record<AnimationType, Keyframe[]>;
+/**
+ * Animation options.
+ */
+export declare const ANIMATION_OPTIONS: KeyframeAnimationOptions;
+/**
+ * Apply static slot positioning to an element.
+ */
+export declare function applyStaticSlotStyles(element: HTMLElement, slot: StaticSurfaceSlot, constraints?: MountConstraints): void;
+/**
+ * Set up adjacent slot positioning using Floating UI.
+ * Returns a cleanup function.
+ */
+export declare function setupAdjacentPositioning(container: HTMLElement, anchorEl: HTMLElement, config: PositionConfig): () => void;
+/**
+ * Set up inline slot positioning.
+ * Inline slots render content inside the anchor element.
+ */
+export declare function setupInlinePositioning(container: HTMLElement, anchorEl: HTMLElement, position?: "prepend" | "append"): () => void;
+/**
+ * Play enter animation on an element.
+ */
+export declare function playEnterAnimation(element: HTMLElement, animationType: AnimationType): Animation | null;
+/**
+ * Play exit animation on an element.
+ * Returns a promise that resolves when the animation completes.
+ */
+export declare function playExitAnimation(element: HTMLElement, animationType: AnimationType): Promise<void>;
+/**
+ * Create and style a surface container element.
+ */
+export declare function createSurfaceContainer(slot: SurfaceSlot, id: string): HTMLElement;
+/**
+ * Get the z-index for a slot type.
+ */
+export declare function getSlotZIndex(slot: SurfaceSlot): number;