@czap/vite 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/vite
+
+Vite 8 plugin: @token/@theme/@style/@quantize CSS transforms + HMR.
+
+## Docs
+
+- [Naming & vocabulary](../../docs/GLOSSARY.md) — LiteShip, CZAP, `@czap/*`
+
+- [API reference](https://github.com/heyoub/LiteShip/tree/main/docs/api/vite/) — 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/vite
+```
+
+## Part of [LiteShip](https://github.com/heyoub/LiteShip#readme)

package/dist/css-quantize.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `@quantize` CSS block parser and compiler.
+ *
+ * Parses custom `@quantize boundaryName { state { prop: value } }` blocks
+ * from CSS source and compiles them into native `@container` queries using
+ * resolved `BoundaryDef` thresholds.
+ *
+ * @module
+ */
+import type { Boundary } from '@czap/core';
+/**
+ * A single parsed `@quantize` block: the boundary being quantised, the
+ * per-state property bag, and provenance info so HMR can emit
+ * source-mapped warnings.
+ */
+export interface QuantizeBlock {
+    /** Boundary name referenced in the at-rule preamble. */
+    readonly boundaryName: string;
+    /** `{ stateName: { cssProp: value } }` mapping. */
+    readonly states: Record<string, Record<string, string>>;
+    /** Absolute path of the CSS source file. */
+    readonly sourceFile: string;
+    /** 1-based source line where the block begins. */
+    readonly line: number;
+}
+/**
+ * Parse every `@quantize` block from CSS source text.
+ *
+ * Grammar:
+ *
+ * ```css
+ * @quantize boundaryName {
+ *   stateName {
+ *     property: value;
+ *   }
+ * }
+ * ```
+ *
+ * The outer `@quantize` and state-name matching is line-based for
+ * simplicity; property declarations inside state blocks use a
+ * character-level parser so that multi-line values (e.g.
+ * `linear-gradient` spread across lines) are collected correctly
+ * before being matched.
+ */
+export declare function parseQuantizeBlocks(css: string, sourceFile: string): readonly QuantizeBlock[];
+/**
+ * Compile a parsed {@link QuantizeBlock} plus its resolved
+ * {@link Boundary.Shape} into CSS `@container` query rules. Delegates
+ * to the canonical `CSSCompiler` to avoid duplicating threshold-to-query
+ * logic.
+ */
+export declare function compileQuantizeBlock(block: QuantizeBlock, boundary: Boundary.Shape): string;
+//# sourceMappingURL=css-quantize.d.ts.map

package/dist/css-quantize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-quantize.d.ts","sourceRoot":"","sources":["../src/css-quantize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAsJD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CA6E7F;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,GAAG,MAAM,CAG3F"}

package/dist/css-quantize.js

@@ -0,0 +1,247 @@
+/**
+ * `@quantize` CSS block parser and compiler.
+ *
+ * Parses custom `@quantize boundaryName { state { prop: value } }` blocks
+ * from CSS source and compiles them into native `@container` queries using
+ * resolved `BoundaryDef` thresholds.
+ *
+ * @module
+ */
+import { CSSCompiler } from '@czap/compiler';
+import { normalizeCssLineEndings } from './normalize-css-eol.js';
+// ---------------------------------------------------------------------------
+// Parser helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse all property declarations inside a state block starting at `pos`
+ * (the character immediately after the opening `{` of the state block).
+ *
+ * Uses character-level scanning so multi-line values -- e.g.
+ *   background: linear-gradient(
+ *     to bottom,
+ *     red,
+ *     blue
+ *   );
+ * -- are collected as a single declaration before matching.
+ *
+ * Tracks paren depth so commas/semicolons inside functional notation
+ * (var(), calc(), linear-gradient(), etc.) are not treated as delimiters.
+ * Tracks brace depth so values containing braces (e.g. `var(--x, empty)`)
+ * do not prematurely close the state block.
+ *
+ * Returns the parsed properties and the position immediately after the
+ * closing `}` of the state block.
+ */
+function parseStateDeclarations(css, pos) {
+    const props = {};
+    let braceDepth = 0;
+    while (pos < css.length) {
+        // Skip whitespace between declarations
+        while (pos < css.length && /\s/.test(css[pos]))
+            pos++;
+        if (pos >= css.length)
+            break;
+        const ch = css[pos];
+        // Skip block comments
+        if (ch === '/' && css[pos + 1] === '*') {
+            pos += 2;
+            while (pos < css.length - 1 && !(css[pos] === '*' && css[pos + 1] === '/'))
+                pos++;
+            pos += 2;
+            continue;
+        }
+        // Closing brace of the state block
+        if (ch === '}' && braceDepth === 0) {
+            pos++;
+            return { props, end: pos };
+        }
+        // Opening brace nested inside a value (e.g. var(--x, {}))
+        if (ch === '{') {
+            braceDepth++;
+            pos++;
+            continue;
+        }
+        if (ch === '}') {
+            braceDepth--;
+            pos++;
+            continue;
+        }
+        // Accumulate a full declaration: collect until `;` at paren-depth 0,
+        // or until `}` that closes this state block, whichever comes first.
+        let declBuf = '';
+        let parenDepth = 0;
+        while (pos < css.length) {
+            const dc = css[pos];
+            // Skip block comments inside declaration
+            if (dc === '/' && css[pos + 1] === '*') {
+                pos += 2;
+                while (pos < css.length - 1 && !(css[pos] === '*' && css[pos + 1] === '/'))
+                    pos++;
+                pos += 2;
+                continue;
+            }
+            // Skip quoted strings
+            if (dc === '"' || dc === "'") {
+                const quote = dc;
+                declBuf += dc;
+                pos++;
+                while (pos < css.length && css[pos] !== quote) {
+                    if (css[pos] === '\\') {
+                        declBuf += css[pos];
+                        pos++;
+                    }
+                    declBuf += css[pos];
+                    pos++;
+                }
+                if (pos < css.length) {
+                    declBuf += css[pos];
+                    pos++;
+                }
+                continue;
+            }
+            if (dc === '(') {
+                parenDepth++;
+                declBuf += dc;
+                pos++;
+                continue;
+            }
+            if (dc === ')') {
+                parenDepth--;
+                declBuf += dc;
+                pos++;
+                continue;
+            }
+            // Semicolon at paren-depth 0 ends the declaration
+            if (dc === ';' && parenDepth === 0) {
+                pos++;
+                break;
+            }
+            // Unmatched `}` at paren-depth 0 closes the state block --
+            // do NOT consume it here; the outer loop will handle it.
+            if (dc === '}' && parenDepth === 0) {
+                break;
+            }
+            declBuf += dc;
+            pos++;
+        }
+        const decl = declBuf.trim();
+        if (decl.length === 0)
+            continue;
+        // Match `property-name: value` (property names are [a-zA-Z-][a-zA-Z0-9-]*)
+        const colonIdx = decl.indexOf(':');
+        if (colonIdx > 0) {
+            const propName = decl.slice(0, colonIdx).trim();
+            const propValue = decl.slice(colonIdx + 1).trim();
+            if (/^[a-zA-Z-][a-zA-Z0-9-]*$/.test(propName) && propValue.length > 0) {
+                props[propName] = propValue;
+            }
+        }
+    }
+    return { props, end: pos };
+}
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse every `@quantize` block from CSS source text.
+ *
+ * Grammar:
+ *
+ * ```css
+ * @quantize boundaryName {
+ *   stateName {
+ *     property: value;
+ *   }
+ * }
+ * ```
+ *
+ * The outer `@quantize` and state-name matching is line-based for
+ * simplicity; property declarations inside state blocks use a
+ * character-level parser so that multi-line values (e.g.
+ * `linear-gradient` spread across lines) are collected correctly
+ * before being matched.
+ */
+export function parseQuantizeBlocks(css, sourceFile) {
+    const normalized = normalizeCssLineEndings(css);
+    const blocks = [];
+    const lines = normalized.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const atMatch = line.match(/^\s*@quantize\s+([a-zA-Z_][a-zA-Z0-9_-]*)\s*\{/);
+        if (atMatch) {
+            const boundaryName = atMatch[1];
+            const blockStartLine = i + 1; // 1-indexed
+            const states = {};
+            i++; // advance past @quantize line
+            let braceDepth = 1;
+            while (i < lines.length && braceDepth > 0) {
+                const currentLine = lines[i];
+                const trimmed = currentLine.trim();
+                if (braceDepth === 1) {
+                    // Look for a state block opening: `stateName {`
+                    const stateMatch = trimmed.match(/^([a-zA-Z_][a-zA-Z0-9_-]*)\s*\{/);
+                    if (stateMatch) {
+                        const stateName = stateMatch[1];
+                        // Compute the character offset of the `{` that opens this state
+                        // block inside the full CSS string so we can hand off to the
+                        // character-level parser.
+                        const lineOffset = normalized.split('\n').slice(0, i).join('\n').length + 1;
+                        const openBrace = lineOffset + currentLine.indexOf('{') + 1;
+                        const { props, end } = parseStateDeclarations(normalized, openBrace);
+                        states[stateName] = props;
+                        // Advance the line cursor to the line that contains `end`
+                        let charCount = 0;
+                        let lineIdx = 0;
+                        for (const l of normalized.split('\n')) {
+                            charCount += l.length + 1; // +1 for the '\n'
+                            lineIdx++;
+                            if (charCount >= end)
+                                break;
+                        }
+                        i = lineIdx;
+                        continue;
+                    }
+                    // Closing brace for the @quantize block
+                    if (trimmed === '}') {
+                        braceDepth--;
+                        i++;
+                        continue;
+                    }
+                }
+                // Track nested braces outside of state blocks for robustness
+                for (const ch of trimmed) {
+                    if (ch === '{')
+                        braceDepth++;
+                    if (ch === '}')
+                        braceDepth--;
+                }
+                i++;
+            }
+            blocks.push({
+                boundaryName,
+                states,
+                sourceFile,
+                line: blockStartLine,
+            });
+        }
+        else {
+            i++;
+        }
+    }
+    return blocks;
+}
+// ---------------------------------------------------------------------------
+// Compiler (delegates to @czap/compiler CSSCompiler)
+// ---------------------------------------------------------------------------
+/**
+ * Compile a parsed {@link QuantizeBlock} plus its resolved
+ * {@link Boundary.Shape} into CSS `@container` query rules. Delegates
+ * to the canonical `CSSCompiler` to avoid duplicating threshold-to-query
+ * logic.
+ */
+export function compileQuantizeBlock(block, boundary) {
+    const result = CSSCompiler.compile(boundary, block.states);
+    return CSSCompiler.serialize(result);
+}
+//# sourceMappingURL=css-quantize.js.map

package/dist/css-quantize.js.map

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

package/dist/environments.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Vite 8 Environment API configuration.
+ *
+ * Provides environment-specific resolve conditions and optimisation
+ * settings for browser, server, and shader build targets.
+ *
+ * @module
+ */
+/** Named czap build environment. */
+export type CzapEnvironmentName = 'browser' | 'server' | 'shader';
+/**
+ * Subset of a Vite `Environment` config that czap touches: resolve
+ * conditions plus `optimizeDeps` include/exclude lists. Returned by
+ * {@link getEnvironmentConfig} and merged into the host Vite config
+ * via {@link buildEnvironments}.
+ */
+export interface CzapEnvironmentConfig {
+    readonly resolve: {
+        readonly conditions: string[];
+        readonly extensions: string[];
+    };
+    readonly optimizeDeps: {
+        readonly include: string[];
+        readonly exclude: string[];
+    };
+}
+/**
+ * Get the Vite environment configuration for a specific czap target.
+ */
+export declare function getEnvironmentConfig(name: CzapEnvironmentName): CzapEnvironmentConfig;
+/**
+ * Build the Vite environments configuration object from a list of
+ * requested environment names.
+ */
+export declare function buildEnvironments(names: readonly CzapEnvironmentName[]): Record<string, CzapEnvironmentConfig>;
+//# sourceMappingURL=environments.d.ts.map

package/dist/environments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,oCAAoC;AACpC,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAiDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,qBAAqB,CAErF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAM9G"}

package/dist/environments.js

@@ -0,0 +1,67 @@
+/**
+ * Vite 8 Environment API configuration.
+ *
+ * Provides environment-specific resolve conditions and optimisation
+ * settings for browser, server, and shader build targets.
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Environment Definitions
+// ---------------------------------------------------------------------------
+const BROWSER_ENV = {
+    resolve: {
+        conditions: ['browser', 'import', 'module', 'default'],
+        extensions: ['.ts', '.tsx', '.js', '.jsx', '.css'],
+    },
+    optimizeDeps: {
+        include: ['@czap/core', '@czap/detect'],
+        exclude: [],
+    },
+};
+const SERVER_ENV = {
+    resolve: {
+        conditions: ['node', 'import', 'module', 'default'],
+        extensions: ['.ts', '.tsx', '.js', '.jsx'],
+    },
+    optimizeDeps: {
+        include: [],
+        exclude: ['@czap/core', '@czap/detect'],
+    },
+};
+const SHADER_ENV = {
+    resolve: {
+        conditions: ['browser', 'import', 'module', 'default'],
+        extensions: ['.ts', '.js', '.glsl', '.wgsl', '.vert', '.frag'],
+    },
+    optimizeDeps: {
+        include: ['@czap/core'],
+        exclude: ['@czap/detect'],
+    },
+};
+const ENVIRONMENT_MAP = {
+    browser: BROWSER_ENV,
+    server: SERVER_ENV,
+    shader: SHADER_ENV,
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Get the Vite environment configuration for a specific czap target.
+ */
+export function getEnvironmentConfig(name) {
+    return ENVIRONMENT_MAP[name];
+}
+/**
+ * Build the Vite environments configuration object from a list of
+ * requested environment names.
+ */
+export function buildEnvironments(names) {
+    const result = {};
+    for (const name of names) {
+        result[name] = getEnvironmentConfig(name);
+    }
+    return result;
+}
+//# sourceMappingURL=environments.js.map

package/dist/environments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.js","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,WAAW,GAA0B;IACzC,OAAO,EAAE;QACP,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;QACtD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;KACnD;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;QACvC,OAAO,EAAE,EAAE;KACZ;CACO,CAAC;AAEX,MAAM,UAAU,GAA0B;IACxC,OAAO,EAAE;QACP,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;QACnD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;KAC3C;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;KACxC;CACO,CAAC;AAEX,MAAM,UAAU,GAA0B;IACxC,OAAO,EAAE;QACP,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;QACtD,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;KAC/D;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,CAAC,YAAY,CAAC;QACvB,OAAO,EAAE,CAAC,cAAc,CAAC;KAC1B;CACO,CAAC;AAEX,MAAM,eAAe,GAAuD;IAC1E,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;CACV,CAAC;AAEX,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAyB;IAC5D,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqC;IACrE,MAAM,MAAM,GAA0C,EAAE,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/hmr.d.ts

@@ -0,0 +1,37 @@
+/**
+ * HMR handler for `czap:update` messages.
+ *
+ * Performs surgical DOM updates when `@quantize` CSS or shader
+ * uniforms change during development, avoiding full page reloads.
+ *
+ * @module
+ */
+declare global {
+    interface HTMLCanvasElement {
+        /**
+         * czap runtime-attached WebGL program for HMR uniform updates.
+         * Set by the shader directive when a program is linked.
+         */
+        __czapProgram?: WebGLProgram;
+    }
+}
+/**
+ * Shape of the HMR payload the czap Vite plugin ships over the Vite
+ * dev-server WebSocket. Handled by {@link handleHMR} on the client.
+ */
+export interface HMRPayload {
+    /** Message discriminator. Always `'czap:update'`. */
+    readonly type: 'czap:update';
+    /** Boundary id whose compiled output changed. */
+    readonly boundary: string;
+    /** New compiled CSS (omitted when only uniforms changed). */
+    readonly css?: string;
+    /** New shader-uniform values (omitted when only CSS changed). */
+    readonly uniforms?: Record<string, number>;
+}
+/**
+ * Handle a czap:update HMR payload.
+ * Dispatches to CSS replacement or shader uniform updates based on payload content.
+ */
+export declare function handleHMR(payload: HMRPayload): void;
+//# sourceMappingURL=hmr.d.ts.map

package/dist/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,iBAAiB;QACzB;;;WAGG;QACH,aAAa,CAAC,EAAE,YAAY,CAAC;KAC9B;CACF;AAMD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAsED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAUnD"}

package/dist/hmr.js

@@ -0,0 +1,84 @@
+/**
+ * HMR handler for `czap:update` messages.
+ *
+ * Performs surgical DOM updates when `@quantize` CSS or shader
+ * uniforms change during development, avoiding full page reloads.
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// CSS Hot Update
+// ---------------------------------------------------------------------------
+/**
+ * Find or create a <style> element for a specific boundary's compiled CSS.
+ * Uses a data attribute for identification across HMR cycles.
+ */
+function getOrCreateStyleElement(boundaryId) {
+    const selector = `style[data-czap-boundary="${boundaryId}"]`;
+    const existing = document.querySelector(selector);
+    if (existing instanceof HTMLStyleElement)
+        return existing;
+    const el = document.createElement('style');
+    el.setAttribute('data-czap-boundary', boundaryId);
+    document.head.appendChild(el);
+    return el;
+}
+/**
+ * Apply CSS updates by replacing the boundary's style element content.
+ */
+function applyCSSUpdate(boundary, css) {
+    const el = getOrCreateStyleElement(boundary);
+    el.textContent = css;
+}
+// ---------------------------------------------------------------------------
+// Shader Uniform Hot Update
+// ---------------------------------------------------------------------------
+/**
+ * Update shader uniform values on all canvases that have a czap-boundary
+ * attribute matching the boundary name.
+ *
+ * This works by dispatching a custom event that the czap runtime shader
+ * system listens for, passing the uniform map for in-place updates.
+ */
+function applyUniformUpdate(boundary, uniforms) {
+    const event = new CustomEvent('czap:uniform-update', {
+        detail: { boundary, uniforms },
+        bubbles: true,
+    });
+    document.dispatchEvent(event);
+    // Direct update: find canvas elements with matching boundary data attribute
+    const canvases = Array.from(document.querySelectorAll(`canvas[data-czap-boundary="${boundary}"]`));
+    for (const canvas of canvases) {
+        const gl = canvas.getContext('webgl2') ?? canvas.getContext('webgl');
+        if (!gl)
+            continue;
+        // Look up the program stored on the canvas element via a custom property
+        const program = canvas.__czapProgram;
+        if (!program)
+            continue;
+        for (const [name, value] of Object.entries(uniforms)) {
+            const location = gl.getUniformLocation(program, name);
+            if (location !== null) {
+                gl.uniform1f(location, value);
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Handle a czap:update HMR payload.
+ * Dispatches to CSS replacement or shader uniform updates based on payload content.
+ */
+export function handleHMR(payload) {
+    if (typeof document === 'undefined')
+        return;
+    if (payload.css !== undefined) {
+        applyCSSUpdate(payload.boundary, payload.css);
+    }
+    if (payload.uniforms !== undefined) {
+        applyUniformUpdate(payload.boundary, payload.uniforms);
+    }
+}
+//# sourceMappingURL=hmr.js.map

package/dist/hmr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.js","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,uBAAuB,CAAC,UAAkB;IACjD,MAAM,QAAQ,GAAG,6BAA6B,UAAU,IAAI,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,QAAQ,YAAY,gBAAgB;QAAE,OAAO,QAAQ,CAAC;IAE1D,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAgB,EAAE,GAAW;IACnD,MAAM,EAAE,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC7C,EAAE,CAAC,WAAW,GAAG,GAAG,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,QAAgC;IAC5E,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,qBAAqB,EAAE;QACnD,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC9B,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IACH,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAE9B,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAoB,8BAA8B,QAAQ,IAAI,CAAC,CAAC,CAAC;IACtH,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,EAAE;YAAE,SAAS;QAElB,yEAAyE;QACzE,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;QACrC,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACtD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAmB;IAC3C,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAE5C,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/html-transform.d.ts

@@ -0,0 +1,19 @@
+/**
+ * HTML transform -- resolves `data-czap="name"` to boundary JSON.
+ *
+ * Scans HTML/Astro source for `data-czap="..."` attributes, resolves
+ * the named boundary via the existing boundary resolution infrastructure,
+ * and replaces with `data-czap-boundary='...'` containing serialized JSON.
+ *
+ * @module
+ */
+/**
+ * Transform HTML source, replacing `data-czap="name"` with resolved boundary JSON.
+ *
+ * @param source - The HTML/Astro source string
+ * @param fromFile - The file path of the source (for resolution context)
+ * @param projectRoot - The project root directory
+ * @returns The transformed source, or the original if no transforms needed
+ */
+export declare function transformHTML(source: string, fromFile: string, projectRoot: string): Promise<string>;
+//# sourceMappingURL=html-transform.d.ts.map

package/dist/html-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-transform.d.ts","sourceRoot":"","sources":["../src/html-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC1G"}