@czap/astro 0.1.0

package/dist/runtime/worker.js

@@ -0,0 +1,249 @@
+import { Diagnostics } from '@czap/core';
+import { WorkerHost } from '@czap/worker';
+import { applyBoundaryState, attachViewportObserver, evaluateBoundary, normalizeBoundaryState, parseBoundary, readSignalValue, } from './boundary.js';
+function sameStringRecord(left, right) {
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    for (const key of leftKeys) {
+        if (left[key] !== right[key]) {
+            return false;
+        }
+    }
+    return true;
+}
+function sameNumberRecord(left, right) {
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    for (const key of leftKeys) {
+        if (left[key] !== right[key]) {
+            return false;
+        }
+    }
+    return true;
+}
+function sameBoundaryDetail(left, right) {
+    if (!left) {
+        return false;
+    }
+    return (sameStringRecord(left.discrete, right.discrete) &&
+        sameStringRecord(left.aria, right.aria) &&
+        sameStringRecord(Object.fromEntries(Object.entries(left.css).map(([key, value]) => [key, String(value)])), Object.fromEntries(Object.entries(right.css).map(([key, value]) => [key, String(value)]))) &&
+        sameNumberRecord(left.glsl, right.glsl));
+}
+function canUseWorkerRuntime() {
+    return typeof Worker !== 'undefined' && typeof SharedArrayBuffer !== 'undefined' && globalThis.crossOriginIsolated;
+}
+/**
+ * Entry point used by the `client:worker` directive.
+ *
+ * Parses the serialised boundary off `element`, spins up (or reuses)
+ * a {@link WorkerHost.Shape} from `@czap/worker`, bootstraps the
+ * boundary in the worker, and streams resolved state back into DOM
+ * via {@link applyBoundaryState}. Falls back to an inline evaluation
+ * when `SharedArrayBuffer` / cross-origin isolation is unavailable.
+ */
+export function initWorkerDirective(load, element) {
+    let runtimeBoundary = parseBoundary(element.getAttribute('data-czap-boundary'));
+    if (!runtimeBoundary) {
+        return;
+    }
+    let cleanupObserver = null;
+    let host = null;
+    let unsubscribe = null;
+    let ackUnsubscribe = null;
+    let workerMessageHandler = null;
+    let workerRef = null;
+    let previousState = element.getAttribute('data-czap-state') ?? '';
+    let lastAppliedDetail = null;
+    let seededGeneration = 0;
+    let lastAppliedGeneration = 0;
+    let pendingWorkerSeedAgreement = false;
+    const cleanup = () => {
+        cleanupObserver?.();
+        cleanupObserver = null;
+        unsubscribe?.();
+        unsubscribe = null;
+        ackUnsubscribe?.();
+        ackUnsubscribe = null;
+        if (workerMessageHandler && workerRef && typeof workerRef.removeEventListener === 'function') {
+            workerRef.removeEventListener('message', workerMessageHandler);
+        }
+        workerMessageHandler = null;
+        workerRef = null;
+        host?.dispose();
+        host = null;
+    };
+    const readValue = () => {
+        return readSignalValue(runtimeBoundary.input);
+    };
+    const initFallback = () => {
+        const update = (reset = false) => {
+            if (!runtimeBoundary) {
+                return;
+            }
+            const value = readValue();
+            if (value === undefined) {
+                return;
+            }
+            const nextState = reset
+                ? evaluateBoundary(runtimeBoundary, value)
+                : evaluateBoundary(runtimeBoundary, value, previousState);
+            if (nextState === previousState) {
+                return;
+            }
+            previousState = nextState;
+            applyBoundaryState(element, runtimeBoundary, {
+                discrete: { [runtimeBoundary.name]: nextState },
+            }, 'czap:worker-state');
+        };
+        update(true);
+        if (runtimeBoundary) {
+            cleanupObserver = attachViewportObserver(runtimeBoundary.input, () => update(false));
+        }
+    };
+    const initWorkerHost = () => {
+        if (!runtimeBoundary) {
+            return;
+        }
+        const boundary = runtimeBoundary;
+        const workerHost = WorkerHost.create();
+        host = workerHost;
+        const syncResolvedState = (stateName, generation, bootstrap = false) => {
+            const payload = [
+                {
+                    name: boundary.name,
+                    state: stateName,
+                    generation,
+                },
+            ];
+            pendingWorkerSeedAgreement = true;
+            seededGeneration = generation;
+            lastAppliedGeneration = generation;
+            if (bootstrap) {
+                workerHost.compositor.bootstrapResolvedState(payload);
+                return;
+            }
+            workerHost.compositor.applyResolvedState(payload);
+        };
+        const applyHostResolvedState = (stateName, generation) => {
+            const payload = {
+                discrete: { [boundary.name]: stateName },
+            };
+            applyBoundaryState(element, boundary, payload, 'czap:worker-state');
+            previousState = stateName;
+            lastAppliedDetail = normalizeBoundaryState(payload);
+            lastAppliedGeneration = generation;
+        };
+        workerHost.compositor.addQuantizer(boundary.name, {
+            id: boundary.boundary.id,
+            states: boundary.boundary.states,
+            thresholds: boundary.boundary.thresholds,
+        });
+        const onWorkerMessage = (event) => {
+            if (event.data?.type === 'ready') {
+                element.dispatchEvent(new CustomEvent('czap:worker-ready', { bubbles: true }));
+            }
+        };
+        workerMessageHandler = onWorkerMessage;
+        workerRef = workerHost.compositor.worker;
+        workerHost.compositor.worker.addEventListener('message', onWorkerMessage);
+        ackUnsubscribe = workerHost.compositor.onResolvedStateAck((ack) => {
+            if (host !== workerHost || runtimeBoundary !== boundary) {
+                return;
+            }
+            const ackState = ack.states.find((state) => state.name === boundary.name)?.state;
+            if (pendingWorkerSeedAgreement &&
+                ack.additionalOutputsChanged === false &&
+                ack.generation === seededGeneration &&
+                ackState !== undefined &&
+                ackState === previousState) {
+                pendingWorkerSeedAgreement = false;
+            }
+        });
+        unsubscribe = workerHost.onState((state) => {
+            const currentState = state.discrete?.[boundary.name];
+            if (currentState) {
+                previousState = currentState;
+            }
+            const normalized = normalizeBoundaryState(state);
+            const workerGeneration = state.resolvedStateGenerations?.[boundary.name];
+            if (pendingWorkerSeedAgreement &&
+                workerGeneration !== undefined &&
+                workerGeneration === seededGeneration &&
+                currentState === lastAppliedDetail?.discrete[boundary.name] &&
+                sameBoundaryDetail(lastAppliedDetail, normalized)) {
+                pendingWorkerSeedAgreement = false;
+                return;
+            }
+            applyBoundaryState(element, boundary, state, 'czap:worker-state');
+            lastAppliedDetail = normalized;
+            if (workerGeneration !== undefined) {
+                lastAppliedGeneration = workerGeneration;
+                pendingWorkerSeedAgreement = false;
+            }
+        });
+        const update = () => {
+            if (host !== workerHost || runtimeBoundary !== boundary) {
+                return;
+            }
+            const value = readValue();
+            if (value === undefined) {
+                return;
+            }
+            const nextState = evaluateBoundary(boundary, value, previousState || undefined);
+            if (nextState === previousState) {
+                return;
+            }
+            const nextGeneration = lastAppliedGeneration + 1;
+            applyHostResolvedState(nextState, nextGeneration);
+            syncResolvedState(nextState, nextGeneration);
+        };
+        const initialValue = readValue();
+        if (initialValue !== undefined) {
+            const initialState = evaluateBoundary(boundary, initialValue, previousState || undefined);
+            applyHostResolvedState(initialState, 1);
+            syncResolvedState(initialState, 1, true);
+        }
+        cleanupObserver = attachViewportObserver(boundary.input, update);
+    };
+    const init = () => {
+        if (canUseWorkerRuntime()) {
+            try {
+                initWorkerHost();
+                return;
+            }
+            catch (error) {
+                Diagnostics.warn({
+                    source: 'czap/astro.worker',
+                    code: 'worker-host-fallback',
+                    message: 'WorkerHost could not initialize, falling back to main-thread evaluation.',
+                    detail: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        initFallback();
+    };
+    element.addEventListener('czap:reinit', () => {
+        cleanup();
+        runtimeBoundary = parseBoundary(element.getAttribute('data-czap-boundary'));
+        previousState = element.getAttribute('data-czap-state') ?? '';
+        lastAppliedDetail = null;
+        seededGeneration = 0;
+        lastAppliedGeneration = 0;
+        pendingWorkerSeedAgreement = false;
+        ackUnsubscribe = null;
+        init();
+    });
+    element.addEventListener('czap:dispose', () => {
+        cleanup();
+    });
+    init();
+    load();
+}
+//# sourceMappingURL=worker.js.map

package/dist/runtime/worker.js.map

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

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@czap/astro",
+  "version": "0.1.0",
+  "description": "Astro 6 integration with adaptive directives",
+  "license": "MIT",
+  "author": "Eassa Ayoub <eassa@heyoub.dev>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heyoub/LiteShip",
+    "directory": "packages/astro"
+  },
+  "bugs": "https://github.com/heyoub/LiteShip/issues",
+  "homepage": "https://github.com/heyoub/LiteShip#readme",
+  "keywords": [
+    "czap",
+    "astro",
+    "astro-integration",
+    "ssr",
+    "satellite",
+    "client-directives",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "development": "./src/index.ts"
+    },
+    "./client-directives/satellite": {
+      "types": "./dist/client-directives/satellite.d.ts",
+      "import": "./dist/client-directives/satellite.js",
+      "development": "./src/client-directives/satellite.ts"
+    },
+    "./client-directives/stream": {
+      "types": "./dist/client-directives/stream.d.ts",
+      "import": "./dist/client-directives/stream.js",
+      "development": "./src/client-directives/stream.ts"
+    },
+    "./client-directives/llm": {
+      "types": "./dist/client-directives/llm.d.ts",
+      "import": "./dist/client-directives/llm.js",
+      "development": "./src/client-directives/llm.ts"
+    },
+    "./client-directives/worker": {
+      "types": "./dist/client-directives/worker.d.ts",
+      "import": "./dist/client-directives/worker.js",
+      "development": "./src/client-directives/worker.ts"
+    },
+    "./client-directives/gpu": {
+      "types": "./dist/client-directives/gpu.d.ts",
+      "import": "./dist/client-directives/gpu.js",
+      "development": "./src/client-directives/gpu.ts"
+    },
+    "./client-directives/wasm": {
+      "types": "./dist/client-directives/wasm.d.ts",
+      "import": "./dist/client-directives/wasm.js",
+      "development": "./src/client-directives/wasm.ts"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js",
+      "development": "./src/middleware.ts"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "development": "./src/runtime/index.ts"
+    },
+    "./Satellite": "./src/Satellite.astro",
+    "./Satellite.astro": "./src/Satellite.astro"
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@czap/core": "0.1.0",
+    "@czap/vite": "0.1.0",
+    "@czap/detect": "0.1.0",
+    "@czap/edge": "0.1.0",
+    "@czap/web": "0.1.0",
+    "@czap/worker": "0.1.0"
+  },
+  "peerDependencies": {
+    "astro": ">=6.0.0",
+    "effect": ">=4.0.0-beta.0"
+  },
+  "devDependencies": {
+    "astro": "^6.0.0",
+    "effect": "4.0.0-beta.32"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/src/Satellite.astro

@@ -0,0 +1,39 @@
+---
+/**
+ * Satellite -- the canonical adaptive shell for an Astro page.
+ *
+ * Wraps a `<div>` with `data-czap-*` attributes derived from a Boundary
+ * (and optionally a Component or initial state), so the `client:satellite`
+ * directive can hydrate the boundary evaluator on the client. CSS
+ * transitions handle visual changes; the directive's only runtime job
+ * is to evaluate live signals and update `data-czap-state`.
+ *
+ * @example
+ * ```astro
+ * ---
+ * import Satellite from '@czap/astro/Satellite';
+ * import { heroLayout } from '../boundaries.js';
+ * ---
+ *
+ * <Satellite boundary={heroLayout} client:satellite>
+ *   <section class="hero">...</section>
+ * </Satellite>
+ * ```
+ *
+ * Composition note: this component is a thin shell over `satelliteAttrs()`
+ * (`packages/astro/src/Satellite.ts`). When you need to attach satellite
+ * attributes to an element other than a `<div>` (e.g. a `<section>` or
+ * `<main>`), import `satelliteAttrs` directly and spread it onto your
+ * element of choice.
+ */
+
+import { satelliteAttrs, type SatelliteProps } from './Satellite.js';
+
+export interface Props extends SatelliteProps {}
+
+const attrs = satelliteAttrs(Astro.props);
+---
+
+<div {...attrs}>
+  <slot />
+</div>

package/src/Satellite.ts

@@ -0,0 +1,84 @@
+/**
+ * Satellite -- server-side helper for rendering adaptive container divs.
+ *
+ * A satellite is czap's island primitive: a plain div annotated with
+ * data-czap-* attributes that the client directive hydrates by evaluating
+ * live signals and updating `data-czap-state`. CSS transitions handle
+ * the visual changes -- zero JS layout work.
+ *
+ * @module
+ */
+
+import type { Boundary, Component } from '@czap/core';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/**
+ * Server-render props for a satellite container. Astro components
+ * typically destructure these and pass them to {@link satelliteAttrs}.
+ */
+export interface SatelliteProps {
+  /** Boundary whose state the satellite tracks. */
+  readonly boundary?: Boundary.Shape;
+  /** Component definition used to identify the satellite on the client. */
+  readonly component?: Component.Shape;
+  /** Extra CSS class names to merge with `czap-satellite`. */
+  readonly class?: string;
+  /** Server-side initial state (serialised into `data-czap-state`). */
+  readonly initialState?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Attribute Generation
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate the HTML attributes for a satellite container div.
+ * Used by framework integrations (Astro, etc.) to render the satellite wrapper.
+ *
+ * The returned record maps directly to DOM attributes -- spread it onto your
+ * container element and the client directive picks up the rest.
+ */
+export function satelliteAttrs(props: SatelliteProps): Record<string, string> {
+  const attrs: Record<string, string> = {};
+
+  attrs['class'] = ['czap-satellite', props.class].filter(Boolean).join(' ');
+
+  if (props.component) {
+    attrs['data-czap-satellite'] = props.component.name;
+  }
+
+  if (props.boundary) {
+    attrs['data-czap-boundary'] = JSON.stringify({
+      id: props.boundary.id,
+      input: props.boundary.input,
+      thresholds: props.boundary.thresholds,
+      states: props.boundary.states,
+      hysteresis: props.boundary.hysteresis,
+    });
+  }
+
+  if (props.initialState) {
+    attrs['data-czap-state'] = props.initialState;
+  }
+
+  return attrs;
+}
+
+// ---------------------------------------------------------------------------
+// SSR State Resolution
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve initial state from a boundary for SSR.
+ *
+ * Uses a first-state heuristic since the server has no live signal value.
+ * For smarter resolution with client hints and user agent parsing, use
+ * `resolveInitialState` from `./quantize.js` instead.
+ */
+export function resolveInitialStateFallback(boundary: Boundary.Shape): string {
+  // Boundary.make() guarantees at least one state for every Boundary.Shape.
+  return boundary.states[0]!;
+}

package/src/client-directives/gpu.ts

@@ -0,0 +1,5 @@
+import { initGPUDirective } from '../runtime/gpu.js';
+
+export default (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => {
+  initGPUDirective(load, el);
+};

package/src/client-directives/llm.ts

@@ -0,0 +1,5 @@
+import { initLLMDirective } from '../runtime/llm.js';
+
+export default (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => {
+  initLLMDirective(load, el);
+};

package/src/client-directives/satellite.ts

@@ -0,0 +1,5 @@
+import { initSatelliteDirective } from '../runtime/satellite.js';
+
+export default (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => {
+  initSatelliteDirective(load, el);
+};

package/src/client-directives/stream.ts

@@ -0,0 +1,5 @@
+import { initStreamDirective } from '../runtime/stream.js';
+
+export default (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => {
+  initStreamDirective(load, el);
+};

package/src/client-directives/wasm.ts

@@ -0,0 +1,6 @@
+import { loadWasmRuntime } from '../runtime/wasm.js';
+
+export default (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => {
+  void loadWasmRuntime(el);
+  load();
+};

package/src/client-directives/worker.ts

@@ -0,0 +1,5 @@
+import { initWorkerDirective } from '../runtime/worker.js';
+
+export default (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => {
+  initWorkerDirective(load, el);
+};

package/src/detect-upgrade.ts

@@ -0,0 +1,105 @@
+/**
+ * GPU probe upgrade -- replaces provisional tier with full detection.
+ *
+ * Runs after DOMContentLoaded (not render-blocking). Creates a throwaway
+ * WebGL context, reads the GPU renderer string, classifies the GPU tier
+ * using the same heuristics as `@czap/detect`, and updates the HTML element
+ * attributes.
+ *
+ * @module
+ */
+
+/**
+ * Inline script that performs full GPU tier detection.
+ * Deferred to DOMContentLoaded to avoid blocking rendering.
+ */
+export const DETECT_UPGRADE_SCRIPT = `
+(function(){
+  function writeDetectState(next) {
+    var safe = Object.freeze(Object.assign({}, next));
+    try {
+      Object.defineProperty(window, '__CZAP_DETECT__', {
+        value: safe,
+        configurable: true,
+        enumerable: false,
+        writable: false
+      });
+    } catch (_) {
+      try {
+        window.__CZAP_DETECT__ = safe;
+      } catch (_) {}
+    }
+  }
+
+  function upgrade() {
+    try {
+      var h = document.documentElement;
+      var tier = 1;
+      var renderer = '';
+      var webgpu = false;
+
+      // WebGL renderer probe
+      var c = document.createElement('canvas');
+      var gl = c.getContext('webgl2') || c.getContext('webgl');
+      if (gl) {
+        var ext = gl.getExtension('WEBGL_debug_renderer_info');
+        if (ext) {
+          renderer = gl.getParameter(ext.UNMASKED_RENDERER_WEBGL) || '';
+        }
+        // Classify GPU tier from renderer string
+        var r = renderer.toLowerCase();
+        if (/swiftshader|llvmpipe|virtualbox|vmware/.test(r)) {
+          tier = 0; // software
+        } else if (/rtx|radeon rx [67]|apple m[3-9]|adreno 7/.test(r)) {
+          tier = 3; // high
+        } else if (/geforce|radeon rx [45]|adreno [56]|mali-g7|apple m[12]|intel arc/.test(r)) {
+          tier = 2; // mid
+        } else if (/intel|mali|adreno [1-4]|powervr|apple gpu/.test(r)) {
+          tier = 1; // integrated
+        }
+        gl.getExtension('WEBGL_lose_context')?.loseContext();
+      }
+
+      // WebGPU check
+      if (typeof navigator !== 'undefined' && navigator.gpu) {
+        webgpu = true;
+      }
+
+      // Compute final tier using GPU + cores + memory
+      var cores = navigator.hardwareConcurrency || 2;
+      var mem = navigator.deviceMemory || 4;
+      var motion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+
+      var capLevel = 'reactive';
+      if (motion) capLevel = 'static';
+      else if (tier === 0 || cores <= 2 || mem <= 2) capLevel = 'styled';
+      else if (tier >= 3 && cores >= 4 && webgpu) capLevel = 'gpu';
+      else if (tier >= 2 && cores >= 4) capLevel = 'animated';
+
+      var motionTier = 'animations';
+      if (motion) motionTier = 'none';
+      else if (tier === 0 || cores <= 2) motionTier = 'transitions';
+      else if (tier >= 3 && webgpu) motionTier = 'compute';
+      else if (tier >= 2) motionTier = 'physics';
+
+      h.setAttribute('data-czap-tier', capLevel);
+      h.setAttribute('data-czap-gpu-tier', String(tier));
+      if (webgpu) h.setAttribute('data-czap-webgpu', 'true');
+      h.removeAttribute('data-czap-tier-provisional');
+
+      // Update a minimal runtime snapshot instead of exposing the full probe payload.
+      writeDetectState({
+        tier: capLevel,
+        gpuTier: tier,
+        webgpu: webgpu,
+        motionTier: motionTier
+      });
+    } catch(e) { try { document.documentElement.setAttribute('data-czap-tier-probe-error', 'true'); } catch(_) {} }
+  }
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', upgrade);
+  } else {
+    upgrade();
+  }
+})();
+`.trim();