@czap/astro 0.1.0

package/dist/runtime/boundary.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Client-runtime helpers for parsing serialized boundaries out of
+ * `data-czap-boundary` attributes, attaching viewport observers,
+ * evaluating boundaries live, and applying the resulting state to a
+ * satellite element.
+ *
+ * Consumed by the Astro `client:satellite` / `client:worker` directives
+ * when they hydrate a server-rendered `<div data-czap-boundary="...">`.
+ *
+ * @module
+ */
+import { Boundary } from '@czap/core';
+/**
+ * JSON shape produced on the server by `satelliteAttrs()` and read back
+ * on the client via {@link parseBoundary}. Every field corresponds
+ * directly to a {@link Boundary.Shape} input.
+ */
+export interface SerializedBoundary {
+    /** Optional stable boundary id (becomes the runtime `name`). */
+    readonly id?: string;
+    /** Signal key this boundary consumes (e.g. `"viewport.width"`). */
+    readonly input: string;
+    /** Ordered ascending thresholds (`thresholds[i]` lower bound of `states[i]`). */
+    readonly thresholds: readonly number[];
+    /** Non-empty ordered state labels. */
+    readonly states: readonly [string, ...string[]];
+    /** Optional hysteresis band applied during evaluation. */
+    readonly hysteresis?: number;
+}
+/**
+ * Client-side representation of a parsed boundary plus its resolved
+ * runtime name, ready to be evaluated against a live signal.
+ */
+export interface RuntimeBoundary {
+    /** Resolved boundary name (defaults to `"default"`). */
+    readonly name: string;
+    /** Signal key this boundary consumes. */
+    readonly input: string;
+    /** Fully-constructed `Boundary.Shape` ready for evaluation. */
+    readonly boundary: Boundary.Shape<string, readonly [string, ...string[]]>;
+}
+/**
+ * Normalised boundary-state payload used for `CustomEvent` dispatch and
+ * DOM application. CSS keys are filtered to `--czap-*`; ARIA keys to
+ * `role` / `aria-*`.
+ */
+export interface BoundaryStateDetail {
+    /** Discrete state per quantizer name. */
+    readonly discrete: Record<string, string>;
+    /** Whitelisted `--czap-*` CSS variable map. */
+    readonly css: Record<string, string | number>;
+    /** GLSL uniform map (`u_*`). */
+    readonly glsl: Record<string, number>;
+    /** Whitelisted ARIA attribute map. */
+    readonly aria: Record<string, string>;
+}
+/**
+ * Parse a JSON-serialised boundary (as produced by
+ * `satelliteAttrs()`) into a {@link RuntimeBoundary}. Returns `null`
+ * for malformed or structurally invalid payloads so callers can fall
+ * back cleanly rather than throwing mid-hydration.
+ */
+export declare function parseBoundary(boundaryJson: string | null): RuntimeBoundary | null;
+/**
+ * Attach a ResizeObserver on `document.documentElement` that calls `callback`
+ * whenever the viewport resizes, but only when `input` is a viewport signal
+ * (i.e. starts with `"viewport."`) and `ResizeObserver` is available.
+ *
+ * Returns a cleanup function that disconnects the observer, or `null` when no
+ * observer was attached (non-viewport input or no ResizeObserver support).
+ *
+ * Centralises the identical `observeIfNeeded` blocks that previously lived in
+ * satellite.ts and worker.ts.
+ */
+export declare function attachViewportObserver(input: string, callback: () => void): (() => void) | null;
+/**
+ * Read the current numeric value for a signal `input` (e.g.
+ * `"viewport.width"`). Returns `undefined` for unknown inputs; returns
+ * `0` in non-DOM environments so callers can treat SSR and malformed
+ * signals uniformly.
+ */
+export declare function readSignalValue(input: string): number | undefined;
+/**
+ * Evaluate a {@link RuntimeBoundary} against a signal value, applying
+ * hysteresis when `previousState` is provided and the boundary has a
+ * hysteresis band.
+ */
+export declare function evaluateBoundary(boundary: RuntimeBoundary, value: number, previousState?: string): string;
+/**
+ * Merge `state.*` and `state.outputs.*` fields into a single
+ * {@link BoundaryStateDetail}, filtering CSS keys to `--czap-*` and
+ * ARIA keys to `role` / `aria-*`. Used as the `detail` of the
+ * `czap:state` custom event.
+ */
+export declare function normalizeBoundaryState(state: {
+    readonly discrete?: Record<string, string>;
+    readonly css?: Record<string, string | number>;
+    readonly glsl?: Record<string, number>;
+    readonly aria?: Record<string, string>;
+    readonly outputs?: {
+        readonly css?: Record<string, string | number>;
+        readonly glsl?: Record<string, number>;
+        readonly aria?: Record<string, string>;
+    };
+}): BoundaryStateDetail;
+/**
+ * Apply a normalised state to a satellite element: sets
+ * `data-czap-state`, writes whitelisted CSS variables and ARIA
+ * attributes, and dispatches `eventName` + `czap:uniform-update`
+ * custom events for downstream listeners (GPU/WASM runtimes).
+ */
+export declare function applyBoundaryState(element: HTMLElement, boundary: RuntimeBoundary, state: {
+    readonly discrete?: Record<string, string>;
+    readonly css?: Record<string, string | number>;
+    readonly glsl?: Record<string, number>;
+    readonly aria?: Record<string, string>;
+    readonly outputs?: {
+        readonly css?: Record<string, string | number>;
+        readonly glsl?: Record<string, number>;
+        readonly aria?: Record<string, string>;
+    };
+}, eventName: string): void;
+//# sourceMappingURL=boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../src/runtime/boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3E;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AA+BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAoCjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAQ/F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;CACH,GAAG,mBAAmB,CAUtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACL,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC,CAAC;CACH,EACD,SAAS,EAAE,MAAM,GAChB,IAAI,CA6BN"}

package/dist/runtime/boundary.js

@@ -0,0 +1,164 @@
+/**
+ * Client-runtime helpers for parsing serialized boundaries out of
+ * `data-czap-boundary` attributes, attaching viewport observers,
+ * evaluating boundaries live, and applying the resulting state to a
+ * satellite element.
+ *
+ * Consumed by the Astro `client:satellite` / `client:worker` directives
+ * when they hydrate a server-rendered `<div data-czap-boundary="...">`.
+ *
+ * @module
+ */
+import { Boundary } from '@czap/core';
+function isAllowedBoundaryCssProperty(property) {
+    return property.startsWith('--czap-');
+}
+// NOTE: This logic is intentionally duplicated from `isValidAriaKey` in
+// packages/compiler/src/aria.ts. @czap/astro does not depend on @czap/compiler,
+// so the check cannot be shared without introducing a new dependency. Keep the
+// two implementations in sync if either changes.
+function isAllowedBoundaryAttribute(attribute) {
+    return attribute === 'role' || attribute.startsWith('aria-');
+}
+function parseBoundaryPayload(boundaryJson) {
+    let parsed = null;
+    let malformed = false;
+    try {
+        parsed = JSON.parse(boundaryJson);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            malformed = true;
+        }
+        else {
+            throw error;
+        }
+    }
+    return malformed ? null : parsed;
+}
+/**
+ * Parse a JSON-serialised boundary (as produced by
+ * `satelliteAttrs()`) into a {@link RuntimeBoundary}. Returns `null`
+ * for malformed or structurally invalid payloads so callers can fall
+ * back cleanly rather than throwing mid-hydration.
+ */
+export function parseBoundary(boundaryJson) {
+    if (!boundaryJson) {
+        return null;
+    }
+    const parsed = parseBoundaryPayload(boundaryJson);
+    if (!parsed) {
+        return null;
+    }
+    if (typeof parsed.input !== 'string' ||
+        !Array.isArray(parsed.thresholds) ||
+        parsed.thresholds.length === 0 ||
+        !Array.isArray(parsed.states) ||
+        parsed.states.length === 0 ||
+        !parsed.thresholds.every((value) => typeof value === 'number') ||
+        !parsed.states.every((value) => typeof value === 'string')) {
+        return null;
+    }
+    const states = parsed.states;
+    const first = [parsed.thresholds[0], states[0]];
+    const rest = parsed.thresholds.slice(1).map((threshold, index) => [threshold, states[index + 1]]);
+    const at = [first, ...rest];
+    return {
+        name: parsed.id ?? 'default',
+        input: parsed.input,
+        boundary: Boundary.make({
+            input: parsed.input,
+            at,
+            ...(typeof parsed.hysteresis === 'number' ? { hysteresis: parsed.hysteresis } : {}),
+        }),
+    };
+}
+/**
+ * Attach a ResizeObserver on `document.documentElement` that calls `callback`
+ * whenever the viewport resizes, but only when `input` is a viewport signal
+ * (i.e. starts with `"viewport."`) and `ResizeObserver` is available.
+ *
+ * Returns a cleanup function that disconnects the observer, or `null` when no
+ * observer was attached (non-viewport input or no ResizeObserver support).
+ *
+ * Centralises the identical `observeIfNeeded` blocks that previously lived in
+ * satellite.ts and worker.ts.
+ */
+export function attachViewportObserver(input, callback) {
+    if (!input.startsWith('viewport.') || typeof ResizeObserver === 'undefined') {
+        return null;
+    }
+    const observer = new ResizeObserver(callback);
+    observer.observe(document.documentElement);
+    return () => observer.disconnect();
+}
+/**
+ * Read the current numeric value for a signal `input` (e.g.
+ * `"viewport.width"`). Returns `undefined` for unknown inputs; returns
+ * `0` in non-DOM environments so callers can treat SSR and malformed
+ * signals uniformly.
+ */
+export function readSignalValue(input) {
+    if (typeof window === 'undefined')
+        return 0;
+    if (!input.startsWith('viewport.')) {
+        return undefined;
+    }
+    const axis = input.slice('viewport.'.length);
+    return axis === 'height' ? window.innerHeight : window.innerWidth;
+}
+/**
+ * Evaluate a {@link RuntimeBoundary} against a signal value, applying
+ * hysteresis when `previousState` is provided and the boundary has a
+ * hysteresis band.
+ */
+export function evaluateBoundary(boundary, value, previousState) {
+    if (previousState && boundary.boundary.hysteresis) {
+        return Boundary.evaluateWithHysteresis(boundary.boundary, value, previousState);
+    }
+    return Boundary.evaluate(boundary.boundary, value);
+}
+/**
+ * Merge `state.*` and `state.outputs.*` fields into a single
+ * {@link BoundaryStateDetail}, filtering CSS keys to `--czap-*` and
+ * ARIA keys to `role` / `aria-*`. Used as the `detail` of the
+ * `czap:state` custom event.
+ */
+export function normalizeBoundaryState(state) {
+    const css = { ...(state.outputs?.css ?? {}), ...(state.css ?? {}) };
+    const aria = { ...(state.outputs?.aria ?? {}), ...(state.aria ?? {}) };
+    return {
+        discrete: { ...(state.discrete ?? {}) },
+        css: Object.fromEntries(Object.entries(css).filter(([property]) => isAllowedBoundaryCssProperty(property))),
+        glsl: { ...(state.outputs?.glsl ?? {}), ...(state.glsl ?? {}) },
+        aria: Object.fromEntries(Object.entries(aria).filter(([attribute]) => isAllowedBoundaryAttribute(attribute))),
+    };
+}
+/**
+ * Apply a normalised state to a satellite element: sets
+ * `data-czap-state`, writes whitelisted CSS variables and ARIA
+ * attributes, and dispatches `eventName` + `czap:uniform-update`
+ * custom events for downstream listeners (GPU/WASM runtimes).
+ */
+export function applyBoundaryState(element, boundary, state, eventName) {
+    const detail = normalizeBoundaryState(state);
+    const stateName = detail.discrete[boundary.name];
+    if (stateName && element.getAttribute('data-czap-state') !== stateName) {
+        element.setAttribute('data-czap-state', stateName);
+    }
+    for (const [property, value] of Object.entries(detail.css)) {
+        element.style.setProperty(property, String(value));
+    }
+    for (const [attribute, value] of Object.entries(detail.aria)) {
+        element.setAttribute(attribute, value);
+    }
+    element.dispatchEvent(new CustomEvent(eventName, {
+        detail,
+        bubbles: true,
+    }));
+    element.dispatchEvent(new CustomEvent('czap:uniform-update', {
+        detail,
+        bubbles: true,
+    }));
+}
+//# sourceMappingURL=boundary.js.map

package/dist/runtime/boundary.js.map

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

package/dist/runtime/globals.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Safe read/write helpers for named `window` globals used as runtime
+ * handshake points between inline detect scripts and the hydrated
+ * runtime (e.g. `__CZAP_DETECT__`, `__CZAP_SLOTS__`). Works on both
+ * client and server entry paths -- returns `undefined` under SSR.
+ *
+ * @module
+ */
+declare global {
+    interface Window {
+        [key: string]: unknown;
+    }
+}
+/**
+ * Read a named `window` global, narrowed through `guard`. Returns
+ * `undefined` under SSR or when the guard rejects the runtime value.
+ */
+export declare function readRuntimeGlobal<T>(name: string, guard: (v: unknown) => v is T): T | undefined;
+/**
+ * Write a named `window` global as a non-enumerable property.
+ *
+ * `options.writable` defaults to `false` so the value is lock-down by default.
+ * `options.configurable` defaults to `true` so HMR and bootstrap re-runs can
+ * replace the global; security-critical globals (e.g. `__CZAP_RUNTIME_POLICY__`)
+ * should pass `configurable: false` to prevent post-install redefinition by
+ * any later script on the page.
+ */
+export declare function writeRuntimeGlobal<T>(name: string, value: T, options?: {
+    readonly writable?: boolean;
+    readonly configurable?: boolean;
+}): T;
+//# sourceMappingURL=globals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../src/runtime/globals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB;CACF;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAK/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACzE,CAAC,CAaH"}

package/dist/runtime/globals.js

@@ -0,0 +1,45 @@
+/**
+ * Safe read/write helpers for named `window` globals used as runtime
+ * handshake points between inline detect scripts and the hydrated
+ * runtime (e.g. `__CZAP_DETECT__`, `__CZAP_SLOTS__`). Works on both
+ * client and server entry paths -- returns `undefined` under SSR.
+ *
+ * @module
+ */
+function runtimeWindow() {
+    return typeof window === 'undefined' ? null : window;
+}
+/**
+ * Read a named `window` global, narrowed through `guard`. Returns
+ * `undefined` under SSR or when the guard rejects the runtime value.
+ */
+export function readRuntimeGlobal(name, guard) {
+    const win = runtimeWindow();
+    if (!win)
+        return undefined;
+    const raw = win[name];
+    return guard(raw) ? raw : undefined;
+}
+/**
+ * Write a named `window` global as a non-enumerable property.
+ *
+ * `options.writable` defaults to `false` so the value is lock-down by default.
+ * `options.configurable` defaults to `true` so HMR and bootstrap re-runs can
+ * replace the global; security-critical globals (e.g. `__CZAP_RUNTIME_POLICY__`)
+ * should pass `configurable: false` to prevent post-install redefinition by
+ * any later script on the page.
+ */
+export function writeRuntimeGlobal(name, value, options) {
+    const win = runtimeWindow();
+    if (!win) {
+        return value;
+    }
+    Object.defineProperty(win, name, {
+        value,
+        configurable: options?.configurable ?? true,
+        enumerable: false,
+        writable: options?.writable ?? false,
+    });
+    return value;
+}
+//# sourceMappingURL=globals.js.map

package/dist/runtime/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../src/runtime/globals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,SAAS,aAAa;IACpB,OAAO,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAI,IAAY,EAAE,KAA6B;IAC9E,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,GAAG,GAAY,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAAQ,EACR,OAA0E;IAE1E,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE;QAC/B,KAAK;QACL,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI;QAC3C,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,KAAK;KACrC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/runtime/gpu.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Entry point used by the `client:gpu` directive to wire a
+ * satellite element to a WebGL shader.
+ *
+ * Reads `data-czap-shader-type` / `data-czap-shader-src` off the
+ * element, fetches and compiles the program, then subscribes to
+ * `czap:uniform-update` events so each boundary transition updates the
+ * shader uniforms.
+ *
+ * @param load - Dynamic-import factory the directive passes in (kept
+ *   async so the expensive GPU module is code-split).
+ * @param el - Satellite element carrying the shader attributes.
+ */
+export declare function initGPUDirective(load: () => Promise<unknown>, el: HTMLElement): void;
+//# sourceMappingURL=gpu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gpu.d.ts","sourceRoot":"","sources":["../../src/runtime/gpu.ts"],"names":[],"mappings":"AA0DA;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CA2NpF"}

package/dist/runtime/gpu.js

@@ -0,0 +1,266 @@
+import { Diagnostics, CANVAS_FALLBACK_WIDTH, CANVAS_FALLBACK_HEIGHT } from '@czap/core';
+import { readRuntimeEndpointPolicy } from './policy.js';
+import { allowRuntimeEndpointUrl } from './url-policy.js';
+const DEFAULT_VERTEX_SHADER = `#version 300 es
+precision mediump float;
+in vec2 a_position;
+out vec2 v_uv;
+void main() {
+  v_uv = a_position * 0.5 + 0.5;
+  gl_Position = vec4(a_position, 0.0, 1.0);
+}`;
+const FULLSCREEN_QUAD = new Float32Array([-1, -1, 1, -1, -1, 1, -1, 1, 1, -1, 1, 1]);
+function compileShader(gl, type, source) {
+    const shader = gl.createShader(type);
+    if (!shader)
+        return null;
+    gl.shaderSource(shader, source);
+    gl.compileShader(shader);
+    if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
+        Diagnostics.warn({
+            source: 'czap/astro.gpu',
+            code: 'shader-compile-failed',
+            message: 'Shader compilation failed.',
+            detail: gl.getShaderInfoLog(shader),
+        });
+        gl.deleteShader(shader);
+        return null;
+    }
+    return shader;
+}
+function createProgram(gl, vertSrc, fragSrc) {
+    const vert = compileShader(gl, gl.VERTEX_SHADER, vertSrc);
+    const frag = compileShader(gl, gl.FRAGMENT_SHADER, fragSrc);
+    if (!vert || !frag)
+        return null;
+    const program = gl.createProgram();
+    if (!program)
+        return null;
+    gl.attachShader(program, vert);
+    gl.attachShader(program, frag);
+    gl.linkProgram(program);
+    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+        Diagnostics.warn({
+            source: 'czap/astro.gpu',
+            code: 'program-link-failed',
+            message: 'Shader program linking failed.',
+            detail: gl.getProgramInfoLog(program),
+        });
+        gl.deleteProgram(program);
+        return null;
+    }
+    return program;
+}
+/**
+ * Entry point used by the `client:gpu` directive to wire a
+ * satellite element to a WebGL shader.
+ *
+ * Reads `data-czap-shader-type` / `data-czap-shader-src` off the
+ * element, fetches and compiles the program, then subscribes to
+ * `czap:uniform-update` events so each boundary transition updates the
+ * shader uniforms.
+ *
+ * @param load - Dynamic-import factory the directive passes in (kept
+ *   async so the expensive GPU module is code-split).
+ * @param el - Satellite element carrying the shader attributes.
+ */
+export function initGPUDirective(load, el) {
+    const shaderType = el.getAttribute('data-czap-shader-type') ?? 'glsl';
+    const shaderSrc = allowRuntimeEndpointUrl(el.getAttribute('data-czap-shader-src'), 'gpu-shader', 'czap/astro.gpu', {
+        crossOriginRejected: 'shader-cross-origin-url-rejected',
+        malformedUrl: 'shader-malformed-url-rejected',
+        originNotAllowed: 'shader-origin-not-allowed',
+        endpointKindNotPermitted: 'shader-endpoint-kind-not-permitted',
+    }, readRuntimeEndpointPolicy());
+    const tier = document.documentElement.getAttribute('data-czap-tier') ?? 'reactive';
+    if (tier === 'static' || tier === 'styled') {
+        load();
+        return;
+    }
+    if (shaderType === 'wgsl') {
+        Diagnostics.warnOnce({
+            source: 'czap/astro.gpu',
+            code: 'wgsl-not-yet-supported',
+            message: 'WGSL shader directives are not yet wired into the Astro GPU runtime. Use WGSLCompiler directly for WGSL output.',
+        });
+        load();
+        return;
+    }
+    let canvas;
+    if (el instanceof HTMLCanvasElement) {
+        canvas = el;
+    }
+    else {
+        canvas = document.createElement('canvas');
+        canvas.width = el.clientWidth || CANVAS_FALLBACK_WIDTH;
+        canvas.height = el.clientHeight || CANVAS_FALLBACK_HEIGHT;
+        canvas.style.width = '100%';
+        canvas.style.height = '100%';
+        el.appendChild(canvas);
+    }
+    const gl = canvas.getContext('webgl2');
+    if (!gl) {
+        Diagnostics.warnOnce({
+            source: 'czap/astro.gpu',
+            code: 'webgl2-unavailable',
+            message: 'WebGL2 is unavailable; falling back to CSS rendering.',
+        });
+        load();
+        return;
+    }
+    const webgl = gl;
+    async function initShader() {
+        let fragSource;
+        if (shaderSrc && (shaderSrc.startsWith('/') || shaderSrc.startsWith('http'))) {
+            try {
+                const response = await fetch(shaderSrc);
+                if (!response.ok) {
+                    Diagnostics.warn({
+                        source: 'czap/astro.gpu',
+                        code: 'shader-fetch-failed',
+                        message: 'Failed to fetch shader source.',
+                        detail: response.statusText,
+                    });
+                    return;
+                }
+                fragSource = await response.text();
+            }
+            catch (err) {
+                Diagnostics.warn({
+                    source: 'czap/astro.gpu',
+                    code: 'shader-fetch-threw',
+                    message: 'Fetching shader source threw an error.',
+                    cause: err,
+                });
+                return;
+            }
+        }
+        else if (shaderSrc) {
+            fragSource = shaderSrc;
+        }
+        else {
+            fragSource = `#version 300 es
+precision mediump float;
+in vec2 v_uv;
+out vec4 fragColor;
+uniform float u_state;
+uniform float u_time;
+void main() {
+  vec3 color = mix(vec3(0.2, 0.3, 0.8), vec3(0.8, 0.3, 0.2), u_state);
+  float bands = 4.0;
+  color = floor(color * bands) / bands;
+  fragColor = vec4(color, 1.0);
+}`;
+        }
+        const program = createProgram(webgl, DEFAULT_VERTEX_SHADER, fragSource);
+        if (!program)
+            return;
+        webgl.useProgram(program);
+        const vao = webgl.createVertexArray();
+        webgl.bindVertexArray(vao);
+        const buffer = webgl.createBuffer();
+        webgl.bindBuffer(webgl.ARRAY_BUFFER, buffer);
+        webgl.bufferData(webgl.ARRAY_BUFFER, FULLSCREEN_QUAD, webgl.STATIC_DRAW);
+        const posLoc = webgl.getAttribLocation(program, 'a_position');
+        webgl.enableVertexAttribArray(posLoc);
+        webgl.vertexAttribPointer(posLoc, 2, webgl.FLOAT, false, 0, 0);
+        const uniforms = new Map();
+        const numUniforms = webgl.getProgramParameter(program, webgl.ACTIVE_UNIFORMS);
+        for (let i = 0; i < numUniforms; i++) {
+            const info = webgl.getActiveUniform(program, i);
+            if (info) {
+                const loc = webgl.getUniformLocation(program, info.name);
+                if (loc)
+                    uniforms.set(info.name, loc);
+            }
+        }
+        const startTime = performance.now();
+        let animFrame = 0;
+        function render() {
+            const w = canvas.clientWidth;
+            const h = canvas.clientHeight;
+            if (canvas.width !== w || canvas.height !== h) {
+                canvas.width = w;
+                canvas.height = h;
+                webgl.viewport(0, 0, w, h);
+            }
+            const timeLoc = uniforms.get('u_time');
+            if (timeLoc) {
+                webgl.uniform1f(timeLoc, (performance.now() - startTime) / 1000);
+            }
+            const resLoc = uniforms.get('u_resolution');
+            if (resLoc) {
+                webgl.uniform2f(resLoc, w, h);
+            }
+            webgl.drawArrays(webgl.TRIANGLES, 0, 6);
+            animFrame = requestAnimationFrame(render);
+        }
+        const onElementUniformUpdate = (event) => {
+            /* v8 ignore next — `czap:uniform-update` is always dispatched via `new CustomEvent(...)`;
+               the guard narrows the generic `Event` parameter for TypeScript's typed `.detail` access. */
+            if (!(event instanceof CustomEvent))
+                return;
+            const detail = event.detail;
+            if (!detail)
+                return;
+            const boundaryJson = el.getAttribute('data-czap-boundary');
+            if (boundaryJson && detail.discrete) {
+                try {
+                    const boundary = JSON.parse(boundaryJson);
+                    const stateName = detail.discrete[boundary.id ?? 'default'];
+                    if (stateName) {
+                        const idx = boundary.states.indexOf(stateName);
+                        const stateLoc = uniforms.get('u_state');
+                        if (stateLoc && idx >= 0) {
+                            webgl.uniform1f(stateLoc, idx / Math.max(1, boundary.states.length - 1));
+                        }
+                    }
+                }
+                catch {
+                    Diagnostics.warnOnce({
+                        source: 'czap/astro.gpu',
+                        code: 'uniform-update-parse-failed',
+                        message: 'Failed to parse boundary JSON during uniform update.',
+                    });
+                }
+            }
+            if (detail.css) {
+                for (const [key, value] of Object.entries(detail.css)) {
+                    const uniformName = key.replace('--czap-', 'u_').replace(/-/g, '_');
+                    const loc = uniforms.get(uniformName);
+                    if (loc && typeof value === 'string') {
+                        const num = parseFloat(value);
+                        if (!Number.isNaN(num)) {
+                            webgl.uniform1f(loc, num);
+                        }
+                    }
+                }
+            }
+        };
+        const onDocumentUniformUpdate = (event) => {
+            /* v8 ignore next — `czap:uniform-update` is always dispatched via `new CustomEvent(...)`;
+               the guard narrows the generic `Event` parameter for TypeScript's typed `.detail` access. */
+            if (!(event instanceof CustomEvent))
+                return;
+            if (event.detail?.uniform && event.detail?.value !== undefined) {
+                const loc = uniforms.get(event.detail.uniform);
+                if (loc) {
+                    webgl.uniform1f(loc, event.detail.value);
+                }
+            }
+        };
+        el.addEventListener('czap:uniform-update', onElementUniformUpdate);
+        document.addEventListener('czap:uniform-update', onDocumentUniformUpdate);
+        el.dispatchEvent(new CustomEvent('czap:gpu-ready', { bubbles: true }));
+        render();
+        el.addEventListener('czap:reinit', () => {
+            cancelAnimationFrame(animFrame);
+            el.removeEventListener('czap:uniform-update', onElementUniformUpdate);
+            document.removeEventListener('czap:uniform-update', onDocumentUniformUpdate);
+            webgl.deleteProgram(program);
+        });
+    }
+    void initShader();
+    load();
+}
+//# sourceMappingURL=gpu.js.map