@czap/astro 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Eassa Ayoub <eassa@heyoub.dev>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @czap/astro
+
+Astro 6 integration: Satellite component + client:satellite directive.
+
+## Docs
+
+- [Naming & vocabulary](../../docs/GLOSSARY.md) — LiteShip, CZAP, `@czap/*`
+
+- [API reference](https://github.com/heyoub/LiteShip/tree/main/docs/api/astro/) — generated from source TSDoc
+- [Architecture index](https://github.com/heyoub/LiteShip/blob/main/docs/ARCHITECTURE.md)
+- [ADRs](https://github.com/heyoub/LiteShip/tree/main/docs/adr/)
+
+## Install
+
+```bash
+pnpm add @czap/astro
+```
+
+## Part of [LiteShip](https://github.com/heyoub/LiteShip#readme)

package/dist/Satellite.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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';
+/**
+ * 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;
+}
+/**
+ * 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 declare function satelliteAttrs(props: SatelliteProps): Record<string, string>;
+/**
+ * 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 declare function resolveInitialStateFallback(boundary: Boundary.Shape): string;
+//# sourceMappingURL=Satellite.d.ts.map

package/dist/Satellite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Satellite.d.ts","sourceRoot":"","sources":["../src/Satellite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMtD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwB5E;AAMD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,GAAG,MAAM,CAG5E"}

package/dist/Satellite.js

@@ -0,0 +1,55 @@
+/**
+ * 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
+ */
+// ---------------------------------------------------------------------------
+// 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) {
+    const attrs = {};
+    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.make() guarantees at least one state for every Boundary.Shape.
+    return boundary.states[0];
+}
+//# sourceMappingURL=Satellite.js.map

package/dist/Satellite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Satellite.js","sourceRoot":"","sources":["../src/Satellite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE3E,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,KAAK,CAAC,qBAAqB,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3C,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;YACrB,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;YAC3B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;YACrC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC7B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;SACtC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAwB;IAClE,0EAA0E;IAC1E,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;AAC7B,CAAC"}

package/dist/client-directives/gpu.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => void;
+export default _default;
+//# sourceMappingURL=gpu.d.ts.map

package/dist/client-directives/gpu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu.d.ts","sourceRoot":"","sources":["../../src/client-directives/gpu.ts"],"names":[],"mappings":"yBAEgB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW;AAA7F,wBAEE"}

package/dist/client-directives/gpu.js

@@ -0,0 +1,5 @@
+import { initGPUDirective } from '../runtime/gpu.js';
+export default (load, _opts, el) => {
+    initGPUDirective(load, el);
+};
+//# sourceMappingURL=gpu.js.map

package/dist/client-directives/gpu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu.js","sourceRoot":"","sources":["../../src/client-directives/gpu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAe,CAAC,IAA4B,EAAE,KAA8B,EAAE,EAAe,EAAE,EAAE;IAC/F,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC"}

package/dist/client-directives/llm.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => void;
+export default _default;
+//# sourceMappingURL=llm.d.ts.map

package/dist/client-directives/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/client-directives/llm.ts"],"names":[],"mappings":"yBAEgB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW;AAA7F,wBAEE"}

package/dist/client-directives/llm.js

@@ -0,0 +1,5 @@
+import { initLLMDirective } from '../runtime/llm.js';
+export default (load, _opts, el) => {
+    initLLMDirective(load, el);
+};
+//# sourceMappingURL=llm.js.map

package/dist/client-directives/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/client-directives/llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAe,CAAC,IAA4B,EAAE,KAA8B,EAAE,EAAe,EAAE,EAAE;IAC/F,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC,CAAC"}

package/dist/client-directives/satellite.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => void;
+export default _default;
+//# sourceMappingURL=satellite.d.ts.map

package/dist/client-directives/satellite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"satellite.d.ts","sourceRoot":"","sources":["../../src/client-directives/satellite.ts"],"names":[],"mappings":"yBAEgB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW;AAA7F,wBAEE"}

package/dist/client-directives/satellite.js

@@ -0,0 +1,5 @@
+import { initSatelliteDirective } from '../runtime/satellite.js';
+export default (load, _opts, el) => {
+    initSatelliteDirective(load, el);
+};
+//# sourceMappingURL=satellite.js.map

package/dist/client-directives/satellite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"satellite.js","sourceRoot":"","sources":["../../src/client-directives/satellite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,eAAe,CAAC,IAA4B,EAAE,KAA8B,EAAE,EAAe,EAAE,EAAE;IAC/F,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC"}

package/dist/client-directives/stream.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => void;
+export default _default;
+//# sourceMappingURL=stream.d.ts.map

package/dist/client-directives/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/client-directives/stream.ts"],"names":[],"mappings":"yBAEgB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW;AAA7F,wBAEE"}

package/dist/client-directives/stream.js

@@ -0,0 +1,5 @@
+import { initStreamDirective } from '../runtime/stream.js';
+export default (load, _opts, el) => {
+    initStreamDirective(load, el);
+};
+//# sourceMappingURL=stream.js.map

package/dist/client-directives/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/client-directives/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAe,CAAC,IAA4B,EAAE,KAA8B,EAAE,EAAe,EAAE,EAAE;IAC/F,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC"}

package/dist/client-directives/wasm.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => void;
+export default _default;
+//# sourceMappingURL=wasm.d.ts.map

package/dist/client-directives/wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../../src/client-directives/wasm.ts"],"names":[],"mappings":"yBAEgB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW;AAA7F,wBAGE"}

package/dist/client-directives/wasm.js

@@ -0,0 +1,6 @@
+import { loadWasmRuntime } from '../runtime/wasm.js';
+export default (load, _opts, el) => {
+    void loadWasmRuntime(el);
+    load();
+};
+//# sourceMappingURL=wasm.js.map

package/dist/client-directives/wasm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.js","sourceRoot":"","sources":["../../src/client-directives/wasm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAe,CAAC,IAA4B,EAAE,KAA8B,EAAE,EAAe,EAAE,EAAE;IAC/F,KAAK,eAAe,CAAC,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC;AACT,CAAC,CAAC"}

package/dist/client-directives/worker.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (load: () => Promise<unknown>, _opts: Record<string, unknown>, el: HTMLElement) => void;
+export default _default;
+//# sourceMappingURL=worker.d.ts.map

package/dist/client-directives/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/client-directives/worker.ts"],"names":[],"mappings":"yBAEgB,MAAM,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW;AAA7F,wBAEE"}

package/dist/client-directives/worker.js

@@ -0,0 +1,5 @@
+import { initWorkerDirective } from '../runtime/worker.js';
+export default (load, _opts, el) => {
+    initWorkerDirective(load, el);
+};
+//# sourceMappingURL=worker.js.map

package/dist/client-directives/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/client-directives/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAe,CAAC,IAA4B,EAAE,KAA8B,EAAE,EAAe,EAAE,EAAE;IAC/F,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC"}

package/dist/detect-upgrade.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 declare const DETECT_UPGRADE_SCRIPT: string;
+//# sourceMappingURL=detect-upgrade.d.ts.map

package/dist/detect-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-upgrade.d.ts","sourceRoot":"","sources":["../src/detect-upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAyF1B,CAAC"}

package/dist/detect-upgrade.js

@@ -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();
+//# sourceMappingURL=detect-upgrade.js.map

package/dist/detect-upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-upgrade.js","sourceRoot":"","sources":["../src/detect-upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFpC,CAAC,IAAI,EAAE,CAAC"}

package/dist/headers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * HTTP header helpers shipped by `@czap/astro`.
+ *
+ * Encodes the two concerns the integration cares about: asking browsers
+ * for the Client Hints czap uses (tier detection), and shipping the
+ * COOP/COEP pair required by `SharedArrayBuffer`-backed workers.
+ *
+ * @module
+ */
+/**
+ * Default `Accept-CH` / `Critical-CH` response headers czap requests
+ * so the browser sends viewport width, device memory, motion
+ * preference, and DPR on the next navigation.
+ */
+export declare const CLIENT_HINTS_HEADERS: Record<string, string>;
+/**
+ * COOP/COEP header pair required for `SharedArrayBuffer` (used by
+ * `@czap/worker`'s SPSC ring). Applied only when the integration is
+ * configured with `workers: { enabled: true }`.
+ */
+export declare const CROSS_ORIGIN_HEADERS: Record<string, string>;
+/**
+ * Build the `[header, value]` entries czap wants to emit for a given
+ * feature toggle set. Used by dev-server middleware and edge adapters
+ * that prefer tuple iteration over the `Headers` API.
+ */
+export declare function getCzapHeaderEntries(options: {
+    readonly detectEnabled: boolean;
+    readonly workersEnabled: boolean;
+    readonly acceptCH?: string;
+    readonly criticalCH?: string;
+}): Array<readonly [string, string]>;
+/**
+ * Apply the czap header set to an existing {@link Headers} bag and
+ * return it (for chaining). Convenience wrapper over
+ * {@link getCzapHeaderEntries} for middleware that already has a
+ * `Headers` object in hand.
+ */
+export declare function applyCzapHeaders(headers: Headers, options: {
+    readonly detectEnabled: boolean;
+    readonly workersEnabled: boolean;
+    readonly acceptCH?: string;
+    readonly criticalCH?: string;
+}): Headers;
+//# sourceMappingURL=headers.d.ts.map

package/dist/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGvD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBnC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IACP,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GACA,OAAO,CAMT"}

package/dist/headers.js

@@ -0,0 +1,64 @@
+/**
+ * HTTP header helpers shipped by `@czap/astro`.
+ *
+ * Encodes the two concerns the integration cares about: asking browsers
+ * for the Client Hints czap uses (tier detection), and shipping the
+ * COOP/COEP pair required by `SharedArrayBuffer`-backed workers.
+ *
+ * @module
+ */
+/**
+ * Default `Accept-CH` / `Critical-CH` response headers czap requests
+ * so the browser sends viewport width, device memory, motion
+ * preference, and DPR on the next navigation.
+ */
+export const CLIENT_HINTS_HEADERS = {
+    'Accept-CH': 'Sec-CH-Viewport-Width, Sec-CH-Device-Memory, Sec-CH-Prefers-Reduced-Motion, Sec-CH-DPR',
+    'Critical-CH': 'Sec-CH-Viewport-Width',
+};
+/**
+ * COOP/COEP header pair required for `SharedArrayBuffer` (used by
+ * `@czap/worker`'s SPSC ring). Applied only when the integration is
+ * configured with `workers: { enabled: true }`.
+ */
+export const CROSS_ORIGIN_HEADERS = {
+    'Cross-Origin-Opener-Policy': 'same-origin',
+    'Cross-Origin-Embedder-Policy': 'require-corp',
+};
+/**
+ * Build the `[header, value]` entries czap wants to emit for a given
+ * feature toggle set. Used by dev-server middleware and edge adapters
+ * that prefer tuple iteration over the `Headers` API.
+ */
+export function getCzapHeaderEntries(options) {
+    const entries = [];
+    if (options.detectEnabled) {
+        const acceptCH = options.acceptCH ?? CLIENT_HINTS_HEADERS['Accept-CH'];
+        const criticalCH = options.criticalCH ?? CLIENT_HINTS_HEADERS['Critical-CH'];
+        if (acceptCH) {
+            entries.push(['Accept-CH', acceptCH]);
+        }
+        if (criticalCH) {
+            entries.push(['Critical-CH', criticalCH]);
+        }
+    }
+    if (options.workersEnabled) {
+        for (const [header, value] of Object.entries(CROSS_ORIGIN_HEADERS)) {
+            entries.push([header, value]);
+        }
+    }
+    return entries;
+}
+/**
+ * Apply the czap header set to an existing {@link Headers} bag and
+ * return it (for chaining). Convenience wrapper over
+ * {@link getCzapHeaderEntries} for middleware that already has a
+ * `Headers` object in hand.
+ */
+export function applyCzapHeaders(headers, options) {
+    for (const [header, value] of getCzapHeaderEntries(options)) {
+        headers.set(header, value);
+    }
+    return headers;
+}
+//# sourceMappingURL=headers.js.map

package/dist/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,WAAW,EAAE,wFAAwF;IACrG,aAAa,EAAE,uBAAuB;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,4BAA4B,EAAE,aAAa;IAC3C,8BAA8B,EAAE,cAAc;CAC/C,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAKpC;IACC,MAAM,OAAO,GAAqC,EAAE,CAAC;IAErD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,oBAAoB,CAAC,aAAa,CAAC,CAAC;QAC7E,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgB,EAChB,OAKC;IAED,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `@czap/astro` — **LiteShip** on Astro 6: constraint-shaped adaptive
+ * projection hosted as islands and directives.
+ *
+ * Provides the Astro `Integration` that registers `@czap/vite`,
+ * injects client tier detection, **rigs** the `client:satellite` directive,
+ * and exposes `Satellite` for shells with server-resolved bearings.
+ *
+ * @example
+ * ```ts
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import { integration as czap } from '@czap/astro';
+ *
+ * const config = defineConfig({
+ *   integrations: [czap({ themes: ['./themes/default.ts'] })],
+ * });
+ * ```
+ *
+ * @module
+ */
+export type { IntegrationConfig } from './integration.js';
+export { integration } from './integration.js';
+export type { ServerIslandContext, QuantizeProps } from './quantize.js';
+export { resolveInitialState } from './quantize.js';
+export { satelliteAttrs, resolveInitialStateFallback } from './Satellite.js';
+export type { SatelliteProps } from './Satellite.js';
+export { czapMiddleware } from './middleware.js';
+export type { CzapLocals, CzapMiddlewareConfig } from './middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * `@czap/astro` — **LiteShip** on Astro 6: constraint-shaped adaptive
+ * projection hosted as islands and directives.
+ *
+ * Provides the Astro `Integration` that registers `@czap/vite`,
+ * injects client tier detection, **rigs** the `client:satellite` directive,
+ * and exposes `Satellite` for shells with server-resolved bearings.
+ *
+ * @example
+ * ```ts
+ * // astro.config.mjs
+ * import { defineConfig } from 'astro/config';
+ * import { integration as czap } from '@czap/astro';
+ *
+ * const config = defineConfig({
+ *   integrations: [czap({ themes: ['./themes/default.ts'] })],
+ * });
+ * ```
+ *
+ * @module
+ */
+export { integration } from './integration.js';
+export { resolveInitialState } from './quantize.js';
+export { satelliteAttrs, resolveInitialStateFallback } from './Satellite.js';
+export { czapMiddleware } from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}