@czap/astro 0.1.0

package/dist/runtime/runtime-session.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Generic runtime-session lifecycle used by every `@czap/astro` client
+ * directive. Owns a microtask scheduler, a set of pending timers, and
+ * a state machine (`idle` / `active` / `reconnecting` / `disposed`)
+ * that every concrete session (stream, llm, gpu, ...) composes.
+ *
+ * @module
+ */
+/** Lifecycle states a runtime session progresses through. */
+export type RuntimeSessionState = 'idle' | 'active' | 'reconnecting' | 'disposed';
+/**
+ * Shared lifecycle surface shared by every runtime-session kind.
+ *
+ * `schedule` batches callbacks into a single microtask flush;
+ * `setTimer` / `clearTimer` mirror `setTimeout` but participate in
+ * `dispose()` so no task outlives the session.
+ */
+export interface RuntimeSessionShape {
+    readonly state: RuntimeSessionState;
+    activate(): void;
+    beginReconnect(): void;
+    schedule(task: () => void): Promise<void>;
+    setTimer(callback: () => void, delay: number): ReturnType<typeof setTimeout> | null;
+    clearTimer(handle: ReturnType<typeof setTimeout> | null | undefined): null;
+    isDisposed(): boolean;
+    dispose(): void;
+}
+/**
+ * Build a fresh runtime session. Every session starts in the `idle`
+ * state and must be explicitly `activate()`d before tasks are allowed
+ * to run.
+ */
+export declare function createRuntimeSession(): RuntimeSessionShape;
+//# sourceMappingURL=runtime-session.d.ts.map

package/dist/runtime/runtime-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc,IAAI,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACpF,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IAC3E,UAAU,IAAI,OAAO,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,CAuG1D"}

package/dist/runtime/runtime-session.js

@@ -0,0 +1,102 @@
+/**
+ * Generic runtime-session lifecycle used by every `@czap/astro` client
+ * directive. Owns a microtask scheduler, a set of pending timers, and
+ * a state machine (`idle` / `active` / `reconnecting` / `disposed`)
+ * that every concrete session (stream, llm, gpu, ...) composes.
+ *
+ * @module
+ */
+/**
+ * Build a fresh runtime session. Every session starts in the `idle`
+ * state and must be explicitly `activate()`d before tasks are allowed
+ * to run.
+ */
+export function createRuntimeSession() {
+    let state = 'idle';
+    let scheduled = false;
+    let tasks = null;
+    let resolvers = null;
+    let timers = null;
+    const resolvePending = (pendingResolvers) => {
+        for (const resolve of pendingResolvers) {
+            resolve();
+        }
+    };
+    const flush = () => {
+        scheduled = false;
+        const pendingTasks = tasks ?? [];
+        tasks = null;
+        const pendingResolvers = resolvers ?? [];
+        resolvers = null;
+        if (state === 'disposed') {
+            resolvePending(pendingResolvers);
+            return;
+        }
+        for (const task of pendingTasks) {
+            task();
+        }
+        resolvePending(pendingResolvers);
+    };
+    return {
+        get state() {
+            return state;
+        },
+        activate() {
+            if (state !== 'disposed') {
+                state = 'active';
+            }
+        },
+        beginReconnect() {
+            if (state !== 'disposed') {
+                state = 'reconnecting';
+            }
+        },
+        schedule(task) {
+            if (state === 'disposed') {
+                return Promise.resolve();
+            }
+            (tasks ??= []).push(task);
+            if (!scheduled) {
+                scheduled = true;
+                queueMicrotask(flush);
+            }
+            return new Promise((resolve) => {
+                (resolvers ??= []).push(resolve);
+            });
+        },
+        setTimer(callback, delay) {
+            if (state === 'disposed') {
+                return null;
+            }
+            const handle = setTimeout(() => {
+                timers?.delete(handle);
+                callback();
+            }, delay);
+            (timers ??= new Set()).add(handle);
+            return handle;
+        },
+        clearTimer(handle) {
+            if (!handle) {
+                return null;
+            }
+            clearTimeout(handle);
+            timers?.delete(handle);
+            return null;
+        },
+        isDisposed() {
+            return state === 'disposed';
+        },
+        dispose() {
+            state = 'disposed';
+            for (const handle of timers ?? []) {
+                clearTimeout(handle);
+            }
+            timers = null;
+            tasks = null;
+            const pendingResolvers = resolvers ?? [];
+            resolvers = null;
+            resolvePending(pendingResolvers);
+        },
+    };
+}
+//# sourceMappingURL=runtime-session.js.map

package/dist/runtime/runtime-session.js.map

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

package/dist/runtime/satellite.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Entry point used by the `client:satellite` directive. Parses the
+ * serialised boundary off `element`, attaches a viewport observer
+ * (when the signal is viewport-backed), and recomputes
+ * `data-czap-state` plus CSS variables whenever the signal crosses a
+ * threshold. Honors `czap:reinit` and `czap:dispose` custom events to
+ * re-read / tear down without remounting the island.
+ *
+ * @param load - Dynamic-import factory the directive passes in.
+ * @param element - Satellite root carrying `data-czap-boundary`.
+ */
+export declare function initSatelliteDirective(load: () => Promise<unknown>, element: HTMLElement): void;
+//# sourceMappingURL=satellite.d.ts.map

package/dist/runtime/satellite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satellite.d.ts","sourceRoot":"","sources":["../../src/runtime/satellite.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CA4D/F"}

package/dist/runtime/satellite.js

@@ -0,0 +1,59 @@
+import { applyBoundaryState, attachViewportObserver, evaluateBoundary, parseBoundary, readSignalValue, } from './boundary.js';
+/**
+ * Entry point used by the `client:satellite` directive. Parses the
+ * serialised boundary off `element`, attaches a viewport observer
+ * (when the signal is viewport-backed), and recomputes
+ * `data-czap-state` plus CSS variables whenever the signal crosses a
+ * threshold. Honors `czap:reinit` and `czap:dispose` custom events to
+ * re-read / tear down without remounting the island.
+ *
+ * @param load - Dynamic-import factory the directive passes in.
+ * @param element - Satellite root carrying `data-czap-boundary`.
+ */
+export function initSatelliteDirective(load, element) {
+    let runtimeBoundary = parseBoundary(element.getAttribute('data-czap-boundary'));
+    if (!runtimeBoundary) {
+        return;
+    }
+    let previousState = element.getAttribute('data-czap-state') ?? '';
+    let cleanupObserver = null;
+    const updateState = () => {
+        if (!runtimeBoundary) {
+            return;
+        }
+        const value = readSignalValue(runtimeBoundary.input);
+        if (value === undefined) {
+            return;
+        }
+        const state = evaluateBoundary(runtimeBoundary, value, previousState || undefined);
+        if (state === previousState) {
+            return;
+        }
+        previousState = state;
+        applyBoundaryState(element, runtimeBoundary, {
+            discrete: { [runtimeBoundary.name]: state },
+        }, 'czap:satellite-state');
+    };
+    const cleanup = () => {
+        cleanupObserver?.();
+        cleanupObserver = null;
+    };
+    const init = () => {
+        updateState();
+        if (runtimeBoundary) {
+            cleanupObserver = attachViewportObserver(runtimeBoundary.input, updateState);
+        }
+    };
+    element.addEventListener('czap:reinit', () => {
+        cleanup();
+        runtimeBoundary = parseBoundary(element.getAttribute('data-czap-boundary'));
+        previousState = element.getAttribute('data-czap-state') ?? '';
+        init();
+    });
+    element.addEventListener('czap:dispose', () => {
+        cleanup();
+    });
+    init();
+    load();
+}
+//# sourceMappingURL=satellite.js.map

package/dist/runtime/satellite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"satellite.js","sourceRoot":"","sources":["../../src/runtime/satellite.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA4B,EAAE,OAAoB;IACvF,IAAI,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,eAAe,GAAwB,IAAI,CAAC;IAEhD,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,eAAe,EAAE,KAAK,EAAE,aAAa,IAAI,SAAS,CAAC,CAAC;QACnF,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,aAAa,GAAG,KAAK,CAAC;QACtB,kBAAkB,CAChB,OAAO,EACP,eAAe,EACf;YACE,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE;SAC5C,EACD,sBAAsB,CACvB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,eAAe,EAAE,EAAE,CAAC;QACpB,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,WAAW,EAAE,CAAC;QACd,IAAI,eAAe,EAAE,CAAC;YACpB,eAAe,GAAG,sBAAsB,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3C,OAAO,EAAE,CAAC;QACV,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC5E,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAC9D,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/runtime/slots.d.ts

@@ -0,0 +1,34 @@
+import { SlotRegistry } from '@czap/web';
+/**
+ * Return the document-scoped {@link SlotRegistry.Shape}, creating and
+ * persisting one on `window.__CZAP_SLOT_REGISTRY__` the first time
+ * it's requested. Returns a detached registry under SSR.
+ */
+export declare function getSlotRegistry(): SlotRegistry.Shape;
+/**
+ * Clear and rebuild the slot registry by scanning `root` for
+ * `data-czap-slot` elements. Also writes a serialised
+ * `__CZAP_SLOTS__` snapshot for devtools / diagnostics consumers.
+ */
+export declare function rescanSlots(root?: ParentNode): SlotRegistry.Shape;
+/**
+ * One-shot bootstrap: arm a slot-registry scan on
+ * `DOMContentLoaded` (or immediately if the document is already
+ * ready) and re-scan after every Astro View Transitions `after-swap`
+ * event. Idempotent -- subsequent calls return the same registry.
+ */
+export declare function bootstrapSlots(): SlotRegistry.Shape;
+/**
+ * Dispatch `czap:dispose` + `czap:reinit` on every known directive
+ * root. Used after Astro View Transitions `after-swap` so directives
+ * can re-read fresh `data-czap-*` attributes without remounting.
+ */
+export declare function reinitializeDirectives(): void;
+/**
+ * Install a one-time listener that fires
+ * {@link reinitializeDirectives} on every Astro `after-swap`.
+ * Guarded by `window.__CZAP_SWAP_REINIT__` so repeated module loads
+ * do not stack listeners.
+ */
+export declare function installSwapReinit(): void;
+//# sourceMappingURL=slots.d.ts.map

package/dist/runtime/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/runtime/slots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA6BzC;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAAC,KAAK,CAYpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,UAAqB,GAAG,YAAY,CAAC,KAAK,CAqB3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAAC,KAAK,CAuBnD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC"}

package/dist/runtime/slots.js

@@ -0,0 +1,108 @@
+import { SlotRegistry } from '@czap/web';
+import { readRuntimeGlobal, writeRuntimeGlobal } from './globals.js';
+const REINIT_SELECTOR = '[data-czap-boundary],[data-czap-stream-url],[data-czap-llm-url],[data-czap-wasm]';
+function isSlotRegistryShape(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (!('get' in value) || !('register' in value) || !('entries' in value))
+        return false;
+    return typeof value.get === 'function' && typeof value.register === 'function' && typeof value.entries === 'function';
+}
+function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+function runtimeWindow() {
+    return typeof window === 'undefined' ? null : window;
+}
+/**
+ * Return the document-scoped {@link SlotRegistry.Shape}, creating and
+ * persisting one on `window.__CZAP_SLOT_REGISTRY__` the first time
+ * it's requested. Returns a detached registry under SSR.
+ */
+export function getSlotRegistry() {
+    const win = runtimeWindow();
+    if (!win) {
+        return SlotRegistry.create();
+    }
+    const existingRegistry = readRuntimeGlobal('__CZAP_SLOT_REGISTRY__', isSlotRegistryShape);
+    if (!existingRegistry) {
+        return writeRuntimeGlobal('__CZAP_SLOT_REGISTRY__', SlotRegistry.create());
+    }
+    return existingRegistry;
+}
+/**
+ * Clear and rebuild the slot registry by scanning `root` for
+ * `data-czap-slot` elements. Also writes a serialised
+ * `__CZAP_SLOTS__` snapshot for devtools / diagnostics consumers.
+ */
+export function rescanSlots(root = document) {
+    const registry = getSlotRegistry();
+    const existingPaths = Array.from(registry.entries().keys());
+    for (const path of existingPaths) {
+        registry.unregister(path);
+    }
+    const scanRoot = root instanceof Element ? root : document.documentElement;
+    SlotRegistry.scanDOM(registry, scanRoot);
+    const win = runtimeWindow();
+    if (win) {
+        writeRuntimeGlobal('__CZAP_SLOTS__', {
+            registry,
+            entries: Object.fromEntries(Array.from(registry.entries().entries()).map(([path, entry]) => [path, { path, mode: entry.mode }])),
+        });
+    }
+    return registry;
+}
+/**
+ * One-shot bootstrap: arm a slot-registry scan on
+ * `DOMContentLoaded` (or immediately if the document is already
+ * ready) and re-scan after every Astro View Transitions `after-swap`
+ * event. Idempotent -- subsequent calls return the same registry.
+ */
+export function bootstrapSlots() {
+    const win = runtimeWindow();
+    if (!win) {
+        return SlotRegistry.create();
+    }
+    const scan = () => {
+        rescanSlots(document.documentElement);
+    };
+    if (!readRuntimeGlobal('__CZAP_SLOT_BOOTSTRAPPED__', isBoolean)) {
+        writeRuntimeGlobal('__CZAP_SLOT_BOOTSTRAPPED__', true);
+        if (document.readyState === 'loading') {
+            document.addEventListener('DOMContentLoaded', scan, { once: true });
+        }
+        else {
+            scan();
+        }
+        document.addEventListener('astro:after-swap', scan);
+    }
+    return getSlotRegistry();
+}
+/**
+ * Dispatch `czap:dispose` + `czap:reinit` on every known directive
+ * root. Used after Astro View Transitions `after-swap` so directives
+ * can re-read fresh `data-czap-*` attributes without remounting.
+ */
+export function reinitializeDirectives() {
+    document.querySelectorAll(REINIT_SELECTOR).forEach((element) => {
+        element.dispatchEvent(new CustomEvent('czap:dispose', { bubbles: true }));
+        element.dispatchEvent(new CustomEvent('czap:reinit', { bubbles: true }));
+    });
+}
+/**
+ * Install a one-time listener that fires
+ * {@link reinitializeDirectives} on every Astro `after-swap`.
+ * Guarded by `window.__CZAP_SWAP_REINIT__` so repeated module loads
+ * do not stack listeners.
+ */
+export function installSwapReinit() {
+    const win = runtimeWindow();
+    if (!win || readRuntimeGlobal('__CZAP_SWAP_REINIT__', isBoolean)) {
+        return;
+    }
+    writeRuntimeGlobal('__CZAP_SWAP_REINIT__', true);
+    document.addEventListener('astro:after-swap', () => {
+        reinitializeDirectives();
+    });
+}
+//# sourceMappingURL=slots.js.map

package/dist/runtime/slots.js.map

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

package/dist/runtime/stream-session.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Stream-patch scheduler backing the `client:stream` directive.
+ *
+ * Batches incoming HTML patches into a single DOM write per microtask
+ * and reports whether any of the coalesced patches requires a slot
+ * rescan. Delegates lifecycle (activate / dispose / reconnect timer)
+ * to a shared {@link createRuntimeSession}.
+ *
+ * @module
+ */
+import { type RuntimeSessionState } from './runtime-session.js';
+/**
+ * A single HTML patch pulled off the stream. `requiresRescan` flags
+ * patches that inserted or removed slot-bearing elements.
+ */
+export interface StreamPatch {
+    readonly html: string;
+    readonly requiresRescan: boolean;
+}
+/** Callbacks the scheduler invokes when it writes a batch. */
+export interface StreamSchedulerConfig {
+    /** Write a coalesced HTML patch into the live document. */
+    readonly applyHtml: (html: string) => void;
+    /** Observer fired after each flush with batch metadata. */
+    readonly onFlush: (context: {
+        readonly patchCount: number;
+        readonly requiresRescan: boolean;
+    }) => void;
+}
+/** Host surface of a stream scheduler. */
+export interface StreamSchedulerShape {
+    readonly state: RuntimeSessionState;
+    activate(): void;
+    beginReconnect(): void;
+    enqueue(patch: StreamPatch): Promise<void>;
+    enqueueBatch(patches: readonly StreamPatch[]): Promise<void>;
+    setReconnectTimer(callback: () => void, delay: number): ReturnType<typeof setTimeout> | null;
+    clearReconnectTimer(handle: ReturnType<typeof setTimeout> | null | undefined): null;
+    dispose(): void;
+}
+/**
+ * Build a new stream scheduler. The scheduler coalesces patches into a
+ * single microtask-flushed DOM write and calls `config.onFlush` once
+ * per batch.
+ */
+export declare function createStreamScheduler(config: StreamSchedulerConfig): StreamSchedulerShape;
+//# sourceMappingURL=stream-session.d.ts.map

package/dist/runtime/stream-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-session.d.ts","sourceRoot":"","sources":["../../src/runtime/stream-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEtF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CACxG;AAED,0CAA0C;AAC1C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc,IAAI,IAAI,CAAC;IACvB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,YAAY,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAC7F,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IACpF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,oBAAoB,CA8EzF"}

package/dist/runtime/stream-session.js

@@ -0,0 +1,82 @@
+/**
+ * Stream-patch scheduler backing the `client:stream` directive.
+ *
+ * Batches incoming HTML patches into a single DOM write per microtask
+ * and reports whether any of the coalesced patches requires a slot
+ * rescan. Delegates lifecycle (activate / dispose / reconnect timer)
+ * to a shared {@link createRuntimeSession}.
+ *
+ * @module
+ */
+import { createRuntimeSession } from './runtime-session.js';
+/**
+ * Build a new stream scheduler. The scheduler coalesces patches into a
+ * single microtask-flushed DOM write and calls `config.onFlush` once
+ * per batch.
+ */
+export function createStreamScheduler(config) {
+    const runtime = createRuntimeSession();
+    let queue = [];
+    let resolvers = [];
+    const flush = () => {
+        const patches = queue;
+        queue = [];
+        const pendingResolvers = resolvers;
+        resolvers = [];
+        let requiresRescan = false;
+        for (const patch of patches) {
+            requiresRescan ||= patch.requiresRescan;
+            config.applyHtml(patch.html);
+        }
+        if (patches.length > 0) {
+            config.onFlush({ patchCount: patches.length, requiresRescan });
+        }
+        for (const resolve of pendingResolvers) {
+            resolve();
+        }
+    };
+    const schedule = () => {
+        return new Promise((resolve) => {
+            resolvers.push(resolve);
+            void runtime.schedule(flush);
+        });
+    };
+    return {
+        get state() {
+            return runtime.state;
+        },
+        activate() {
+            runtime.activate();
+        },
+        beginReconnect() {
+            runtime.beginReconnect();
+        },
+        enqueue(patch) {
+            queue.push(patch);
+            return schedule();
+        },
+        enqueueBatch(patches) {
+            if (patches.length === 0) {
+                return Promise.resolve();
+            }
+            queue.push(...patches);
+            return schedule();
+        },
+        setReconnectTimer(callback, delay) {
+            return runtime.setTimer(callback, delay);
+        },
+        clearReconnectTimer(handle) {
+            return runtime.clearTimer(handle);
+        },
+        dispose() {
+            queue = [];
+            const pendingResolvers = resolvers;
+            resolvers = [];
+            for (const resolve of pendingResolvers) {
+                resolve();
+            }
+            runtime.dispose();
+        },
+    };
+}
+//# sourceMappingURL=stream-session.js.map

package/dist/runtime/stream-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-session.js","sourceRoot":"","sources":["../../src/runtime/stream-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,oBAAoB,EAA4B,MAAM,sBAAsB,CAAC;AA+BtF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,IAAI,KAAK,GAAkB,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAsB,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC;QACtB,KAAK,GAAG,EAAE,CAAC;QACX,MAAM,gBAAgB,GAAG,SAAS,CAAC;QACnC,SAAS,GAAG,EAAE,CAAC;QAEf,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,cAAc,KAAK,KAAK,CAAC,cAAc,CAAC;YACxC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAkB,EAAE;QACnC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,KAAK,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,KAAK;YACP,OAAO,OAAO,CAAC,KAAK,CAAC;QACvB,CAAC;QAED,QAAQ;YACN,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,CAAC;QAED,cAAc;YACZ,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,CAAC;QAED,OAAO,CAAC,KAAK;YACX,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;QAED,YAAY,CAAC,OAAO;YAClB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;YACvB,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;QAED,iBAAiB,CAAC,QAAQ,EAAE,KAAK;YAC/B,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QAED,mBAAmB,CAAC,MAAM;YACxB,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO;YACL,KAAK,GAAG,EAAE,CAAC;YACX,MAAM,gBAAgB,GAAG,SAAS,CAAC;YACnC,SAAS,GAAG,EAAE,CAAC;YACf,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;gBACvC,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/stream.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Entry point for the `client:stream` directive. Opens an SSE client
+ * to the `data-czap-stream-url` endpoint, funnels incoming HTML
+ * patches through a {@link createStreamScheduler}, and triggers slot
+ * rescans when necessary. Honors `czap:reinit` / `czap:dispose` to
+ * survive Astro view transitions.
+ */
+export declare function initStreamDirective(load: () => Promise<unknown>, element: HTMLElement): void;
+//# sourceMappingURL=stream.d.ts.map

package/dist/runtime/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/runtime/stream.ts"],"names":[],"mappings":"AA8IA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAiQ5F"}