@czap/vite 0.1.0

package/dist/theme-transform.js

@@ -0,0 +1,85 @@
+/**
+ * `@theme` CSS block parser and compiler.
+ *
+ * Parses custom `@theme name { token: value; ... }` blocks from CSS
+ * source and compiles them into `html[data-theme]` selector blocks
+ * plus transition declarations using resolved `ThemeDef` definitions.
+ *
+ * @module
+ */
+import { ThemeCSSCompiler } from '@czap/compiler';
+import { normalizeCssLineEndings } from './normalize-css-eol.js';
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse every `@theme` block from CSS source text.
+ *
+ * Grammar:
+ *
+ * ```css
+ * @theme name {
+ *   tokenName: value;
+ * }
+ * ```
+ */
+export function parseThemeBlocks(css, sourceFile) {
+    const blocks = [];
+    const lines = normalizeCssLineEndings(css).split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const atMatch = line.match(/^\s*@theme\s+([a-zA-Z_][a-zA-Z0-9_-]*)\s*\{/);
+        if (atMatch) {
+            const themeName = atMatch[1];
+            const blockStartLine = i + 1; // 1-indexed
+            const declarations = {};
+            i++; // advance past @theme line
+            while (i < lines.length) {
+                const currentLine = lines[i].trim();
+                // Closing brace for @theme block
+                if (currentLine === '}') {
+                    i++;
+                    break;
+                }
+                const propMatch = currentLine.match(/^([a-zA-Z-][a-zA-Z0-9_-]*)\s*:\s*(.+?)\s*;?\s*$/);
+                if (propMatch) {
+                    declarations[propMatch[1]] = propMatch[2].replace(/;$/, '').trim();
+                }
+                i++;
+            }
+            blocks.push({ themeName, declarations, sourceFile, line: blockStartLine });
+        }
+        else {
+            i++;
+        }
+    }
+    return blocks;
+}
+// ---------------------------------------------------------------------------
+// Compiler (delegates to @czap/compiler ThemeCSSCompiler)
+// ---------------------------------------------------------------------------
+/**
+ * Compile a parsed {@link ThemeBlock} plus a resolved `ThemeDef` into
+ * `html[data-theme]` selector blocks and transition declarations.
+ * Delegates to the canonical `ThemeCSSCompiler` to avoid duplicating
+ * theme-to-CSS logic.
+ */
+export function compileThemeBlock(block, theme) {
+    const result = ThemeCSSCompiler.compile(theme);
+    const parts = [];
+    if (result.selectors) {
+        parts.push(result.selectors);
+    }
+    if (result.transitions) {
+        parts.push(result.transitions);
+    }
+    if (Object.keys(block.declarations).length > 0) {
+        const overrides = Object.entries(block.declarations)
+            .map(([prop, value]) => `  ${prop}: ${value};`)
+            .join('\n');
+        parts.push(`html {\n${overrides}\n}`);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=theme-transform.js.map

package/dist/theme-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-transform.js","sourceRoot":"","sources":["../src/theme-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAqBjE,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,UAAkB;IAC9D,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAE1E,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAC9B,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;YAC1C,MAAM,YAAY,GAA2B,EAAE,CAAC;YAEhD,CAAC,EAAE,CAAC,CAAC,2BAA2B;YAEhC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;gBAErC,iCAAiC;gBACjC,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;oBACxB,CAAC,EAAE,CAAC;oBACJ,MAAM;gBACR,CAAC;gBAED,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACvF,IAAI,SAAS,EAAE,CAAC;oBACd,YAAY,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvE,CAAC;gBACD,CAAC,EAAE,CAAC;YACN,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,KAAkB;IACrE,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,KAAK,GAAG,CAAC;aAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,WAAW,SAAS,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/token-transform.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `@token` CSS block parser and compiler.
+ *
+ * Parses custom `@token name { prop: value; ... }` blocks from CSS
+ * source and compiles them into CSS custom properties plus
+ * `@property` registrations using resolved `TokenDef` definitions.
+ *
+ * @module
+ */
+import type { Token } from '@czap/core';
+/**
+ * Parsed `@token` block: the token to emit and any inline overrides.
+ */
+export interface TokenBlock {
+    /** Named token (resolved against exported `TokenDef` values). */
+    readonly tokenName: string;
+    /** Inline overrides (`{ cssProp: value }`). */
+    readonly declarations: Record<string, string>;
+    /** Absolute source file path. */
+    readonly sourceFile: string;
+    /** 1-based line where the block begins. */
+    readonly line: number;
+}
+/**
+ * Parse every `@token` block from CSS source text.
+ *
+ * Grammar:
+ *
+ * ```css
+ * @token name {
+ *   property: value;
+ * }
+ * ```
+ */
+export declare function parseTokenBlocks(css: string, sourceFile: string): readonly TokenBlock[];
+/**
+ * Compile a parsed {@link TokenBlock} plus a resolved `TokenDef` into
+ * CSS custom property declarations. Delegates to the canonical
+ * `TokenCSSCompiler` to avoid duplicating token-to-CSS logic.
+ */
+export declare function compileTokenBlock(block: TokenBlock, token: Token.Shape): string;
+//# sourceMappingURL=token-transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token-transform.d.ts","sourceRoot":"","sources":["../src/token-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQxC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAuCvF;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAmB/E"}

package/dist/token-transform.js

@@ -0,0 +1,84 @@
+/**
+ * `@token` CSS block parser and compiler.
+ *
+ * Parses custom `@token name { prop: value; ... }` blocks from CSS
+ * source and compiles them into CSS custom properties plus
+ * `@property` registrations using resolved `TokenDef` definitions.
+ *
+ * @module
+ */
+import { TokenCSSCompiler } from '@czap/compiler';
+import { normalizeCssLineEndings } from './normalize-css-eol.js';
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse every `@token` block from CSS source text.
+ *
+ * Grammar:
+ *
+ * ```css
+ * @token name {
+ *   property: value;
+ * }
+ * ```
+ */
+export function parseTokenBlocks(css, sourceFile) {
+    const blocks = [];
+    const lines = normalizeCssLineEndings(css).split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const atMatch = line.match(/^\s*@token\s+([a-zA-Z_][a-zA-Z0-9_-]*)\s*\{/);
+        if (atMatch) {
+            const tokenName = atMatch[1];
+            const blockStartLine = i + 1; // 1-indexed
+            const declarations = {};
+            i++; // advance past @token line
+            while (i < lines.length) {
+                const currentLine = lines[i].trim();
+                // Closing brace for @token block
+                if (currentLine === '}') {
+                    i++;
+                    break;
+                }
+                const propMatch = currentLine.match(/^([a-zA-Z-][a-zA-Z0-9-]*)\s*:\s*(.+?)\s*;?\s*$/);
+                if (propMatch) {
+                    declarations[propMatch[1]] = propMatch[2].replace(/;$/, '').trim();
+                }
+                i++;
+            }
+            blocks.push({ tokenName, declarations, sourceFile, line: blockStartLine });
+        }
+        else {
+            i++;
+        }
+    }
+    return blocks;
+}
+// ---------------------------------------------------------------------------
+// Compiler (delegates to @czap/compiler TokenCSSCompiler)
+// ---------------------------------------------------------------------------
+/**
+ * Compile a parsed {@link TokenBlock} plus a resolved `TokenDef` into
+ * CSS custom property declarations. Delegates to the canonical
+ * `TokenCSSCompiler` to avoid duplicating token-to-CSS logic.
+ */
+export function compileTokenBlock(block, token) {
+    const result = TokenCSSCompiler.compile(token);
+    const parts = [];
+    if (result.customProperties) {
+        parts.push(result.customProperties);
+    }
+    if (result.themed) {
+        parts.push(result.themed);
+    }
+    if (Object.keys(block.declarations).length > 0) {
+        const overrides = Object.entries(block.declarations)
+            .map(([prop, value]) => `  ${prop}: ${value};`)
+            .join('\n');
+        parts.push(`:root {\n${overrides}\n}`);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=token-transform.js.map

package/dist/token-transform.js.map

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

package/dist/virtual-modules.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Virtual module resolution and loading for czap design primitives.
+ *
+ * Handles Vite's `resolveId` and `load` for virtual module specifiers
+ * that provide runtime access to token, boundary, and theme
+ * definitions. The modules export placeholder content that the
+ * transform pipeline later replaces inline.
+ *
+ * Virtual IDs:
+ *
+ * - `virtual:czap/tokens` -- JS exports of token definitions.
+ * - `virtual:czap/tokens.css` -- CSS custom properties from tokens.
+ * - `virtual:czap/boundaries` -- JS exports of boundary definitions.
+ * - `virtual:czap/themes` -- JS exports of theme definitions.
+ * - `virtual:czap/hmr-client` -- Client-side HMR handler for
+ *   `czap:update` events.
+ * - `virtual:czap/wasm-url` -- Resolved WASM runtime URL (or `null`).
+ * - `virtual:czap/config` -- Typed handle for the workspace
+ *   `czap.config.ts` hub.
+ *
+ * @module
+ */
+declare const VIRTUAL_IDS: readonly ["virtual:czap/tokens", "virtual:czap/tokens.css", "virtual:czap/boundaries", "virtual:czap/themes", "virtual:czap/hmr-client", "virtual:czap/wasm-url", "virtual:czap/config"];
+/** Recognised virtual module specifiers. */
+export type VirtualModuleId = (typeof VIRTUAL_IDS)[number];
+/**
+ * Resolve a virtual module ID to its internal null-byte-prefixed form
+ * (as expected by Vite's module graph). Returns `undefined` when `id`
+ * is not a recognised czap virtual module.
+ */
+export declare function resolveVirtualId(id: string): string | undefined;
+/**
+ * Return `true` when `id` is a fully-resolved czap virtual module
+ * (null-byte-prefixed). Callers use this to gate `load` handler
+ * dispatch.
+ */
+export declare function isVirtualId(id: string): boolean;
+/**
+ * Return the source for a resolved virtual module ID.
+ *
+ * Data modules (tokens, boundaries, themes) return empty-object stubs
+ * that provide valid JS/CSS so downstream tooling (type-checkers,
+ * bundlers) can operate without the full transform pipeline running.
+ * Their real content flows through the CSS transform hooks in the
+ * plugin -- at build time the transform replaces token, theme, and
+ * quantize blocks inline, so these stubs are only hit when a consumer
+ * explicitly imports the virtual module (e.g. for runtime JS access
+ * to definitions).
+ *
+ * The `hmr-client` module is the client-side HMR handler that the
+ * plugin injects into the page via `transformIndexHtml`.
+ */
+export declare function loadVirtualModule(id: string): string | undefined;
+export {};
+//# sourceMappingURL=virtual-modules.d.ts.map

package/dist/virtual-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-modules.d.ts","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,QAAA,MAAM,WAAW,0LAQP,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAM3D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkChE"}

package/dist/virtual-modules.js

@@ -0,0 +1,141 @@
+/**
+ * Virtual module resolution and loading for czap design primitives.
+ *
+ * Handles Vite's `resolveId` and `load` for virtual module specifiers
+ * that provide runtime access to token, boundary, and theme
+ * definitions. The modules export placeholder content that the
+ * transform pipeline later replaces inline.
+ *
+ * Virtual IDs:
+ *
+ * - `virtual:czap/tokens` -- JS exports of token definitions.
+ * - `virtual:czap/tokens.css` -- CSS custom properties from tokens.
+ * - `virtual:czap/boundaries` -- JS exports of boundary definitions.
+ * - `virtual:czap/themes` -- JS exports of theme definitions.
+ * - `virtual:czap/hmr-client` -- Client-side HMR handler for
+ *   `czap:update` events.
+ * - `virtual:czap/wasm-url` -- Resolved WASM runtime URL (or `null`).
+ * - `virtual:czap/config` -- Typed handle for the workspace
+ *   `czap.config.ts` hub.
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const VIRTUAL_PREFIX = '\0virtual:czap/';
+const VIRTUAL_IDS = [
+    'virtual:czap/tokens',
+    'virtual:czap/tokens.css',
+    'virtual:czap/boundaries',
+    'virtual:czap/themes',
+    'virtual:czap/hmr-client',
+    'virtual:czap/wasm-url',
+    'virtual:czap/config',
+];
+// ---------------------------------------------------------------------------
+// Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a virtual module ID to its internal null-byte-prefixed form
+ * (as expected by Vite's module graph). Returns `undefined` when `id`
+ * is not a recognised czap virtual module.
+ */
+export function resolveVirtualId(id) {
+    if (VIRTUAL_IDS.includes(id)) {
+        return VIRTUAL_PREFIX + id.slice('virtual:czap/'.length);
+    }
+    return undefined;
+}
+/**
+ * Return `true` when `id` is a fully-resolved czap virtual module
+ * (null-byte-prefixed). Callers use this to gate `load` handler
+ * dispatch.
+ */
+export function isVirtualId(id) {
+    return id.startsWith(VIRTUAL_PREFIX);
+}
+// ---------------------------------------------------------------------------
+// Loading
+// ---------------------------------------------------------------------------
+/**
+ * Return the source for a resolved virtual module ID.
+ *
+ * Data modules (tokens, boundaries, themes) return empty-object stubs
+ * that provide valid JS/CSS so downstream tooling (type-checkers,
+ * bundlers) can operate without the full transform pipeline running.
+ * Their real content flows through the CSS transform hooks in the
+ * plugin -- at build time the transform replaces token, theme, and
+ * quantize blocks inline, so these stubs are only hit when a consumer
+ * explicitly imports the virtual module (e.g. for runtime JS access
+ * to definitions).
+ *
+ * The `hmr-client` module is the client-side HMR handler that the
+ * plugin injects into the page via `transformIndexHtml`.
+ */
+export function loadVirtualModule(id) {
+    if (!id.startsWith(VIRTUAL_PREFIX))
+        return undefined;
+    const name = id.slice(VIRTUAL_PREFIX.length);
+    switch (name) {
+        case 'tokens':
+            return 'export const tokens = {};';
+        case 'tokens.css':
+            return ':root {}';
+        case 'boundaries':
+            return 'export const boundaries = {};';
+        case 'themes':
+            return 'export const themes = {};';
+        case 'hmr-client':
+            return HMR_CLIENT_SOURCE;
+        case 'wasm-url':
+            return 'export const wasmUrl = null;';
+        case 'config':
+            return [
+                '/** czap/config virtual module -- typed stub served by czap/vite */',
+                '/** Full config is available via czap.config.ts at the workspace root */',
+                'export const config = null;',
+            ].join('\n');
+        default:
+            return undefined;
+    }
+}
+/**
+ * Client-side HMR handler injected via virtual module.
+ * Listens for czap:update events on import.meta.hot and applies
+ * CSS or shader uniform updates surgically without full reload.
+ */
+const HMR_CLIENT_SOURCE = `
+if (import.meta.hot) {
+  import.meta.hot.on('czap:update', (payload) => {
+    if (typeof document === 'undefined') return;
+    if (payload.css !== undefined) {
+      const sel = 'style[data-czap-boundary="' + payload.boundary + '"]';
+      let el = document.querySelector(sel);
+      if (!el) {
+        el = document.createElement('style');
+        el.setAttribute('data-czap-boundary', payload.boundary);
+        document.head.appendChild(el);
+      }
+      el.textContent = payload.css;
+    }
+    if (payload.uniforms !== undefined) {
+      document.dispatchEvent(new CustomEvent('czap:uniform-update', {
+        detail: { boundary: payload.boundary, uniforms: payload.uniforms },
+        bubbles: true,
+      }));
+      document.querySelectorAll('canvas[data-czap-boundary="' + payload.boundary + '"]').forEach((canvas) => {
+        const gl = canvas.getContext('webgl2') ?? canvas.getContext('webgl');
+        if (!gl) return;
+        const program = canvas.__czapProgram;
+        if (!program) return;
+        Object.entries(payload.uniforms).forEach(([name, value]) => {
+          const loc = gl.getUniformLocation(program, name);
+          if (loc !== null) gl.uniform1f(loc, value);
+        });
+      });
+    }
+  });
+}
+`.trim();
+//# sourceMappingURL=virtual-modules.js.map

package/dist/virtual-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-modules.js","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEzC,MAAM,WAAW,GAAG;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,yBAAyB;IACzB,qBAAqB;IACrB,yBAAyB;IACzB,uBAAuB;IACvB,qBAAqB;CACb,CAAC;AAKX,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAqB,CAAC,EAAE,CAAC;QAChD,OAAO,cAAc,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,SAAS,CAAC;IAErD,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAE7C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,2BAA2B,CAAC;QAErC,KAAK,YAAY;YACf,OAAO,UAAU,CAAC;QAEpB,KAAK,YAAY;YACf,OAAO,+BAA+B,CAAC;QAEzC,KAAK,QAAQ;YACX,OAAO,2BAA2B,CAAC;QAErC,KAAK,YAAY;YACf,OAAO,iBAAiB,CAAC;QAE3B,KAAK,UAAU;YACb,OAAO,8BAA8B,CAAC;QAExC,KAAK,QAAQ;YACX,OAAO;gBACL,qEAAqE;gBACrE,0EAA0E;gBAC1E,6BAA6B;aAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEf;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCzB,CAAC,IAAI,EAAE,CAAC"}

package/dist/wasm-resolve.d.ts

@@ -0,0 +1,25 @@
+/**
+ * WASM binary resolution -- locates the czap-compute .wasm file.
+ *
+ * Searches for the compiled WASM binary in conventional locations:
+ * 1. Configured path (if provided)
+ * 2. crates/czap-compute/target/wasm32-unknown-unknown/release/czap_compute.wasm
+ * 3. public/czap-compute.wasm (pre-copied)
+ *
+ * @module
+ */
+/**
+ * Successful WASM-resolution result: the absolute binary path plus the
+ * search step that found it (useful for diagnostics).
+ */
+export interface WASMResolution {
+    /** Absolute filesystem path to the WASM binary. */
+    readonly filePath: string;
+    /** Which search step matched (`'config'`, `'crate'`, or `'public'`). */
+    readonly source: 'config' | 'crate' | 'public';
+}
+/**
+ * Resolve the czap-compute WASM binary path.
+ */
+export declare function resolveWASM(projectRoot: string, configPath?: string): WASMResolution | null;
+//# sourceMappingURL=wasm-resolve.d.ts.map

package/dist/wasm-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-resolve.d.ts","sourceRoot":"","sources":["../src/wasm-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAyB3F"}

package/dist/wasm-resolve.js

@@ -0,0 +1,36 @@
+/**
+ * WASM binary resolution -- locates the czap-compute .wasm file.
+ *
+ * Searches for the compiled WASM binary in conventional locations:
+ * 1. Configured path (if provided)
+ * 2. crates/czap-compute/target/wasm32-unknown-unknown/release/czap_compute.wasm
+ * 3. public/czap-compute.wasm (pre-copied)
+ *
+ * @module
+ */
+import { fileExists } from './resolve-fs.js';
+import * as path from 'node:path';
+/**
+ * Resolve the czap-compute WASM binary path.
+ */
+export function resolveWASM(projectRoot, configPath) {
+    // 1. Configured path
+    if (configPath) {
+        const resolved = path.isAbsolute(configPath) ? configPath : path.join(projectRoot, configPath);
+        if (fileExists(resolved, 'czap/vite.wasm-resolve')) {
+            return { filePath: resolved, source: 'config' };
+        }
+    }
+    // 2. Rust crate build output
+    const crateOutput = path.join(projectRoot, 'crates/czap-compute/target/wasm32-unknown-unknown/release/czap_compute.wasm');
+    if (fileExists(crateOutput, 'czap/vite.wasm-resolve')) {
+        return { filePath: crateOutput, source: 'crate' };
+    }
+    // 3. Public directory (pre-copied)
+    const publicPath = path.join(projectRoot, 'public/czap-compute.wasm');
+    if (fileExists(publicPath, 'czap/vite.wasm-resolve')) {
+        return { filePath: publicPath, source: 'public' };
+    }
+    return null;
+}
+//# sourceMappingURL=wasm-resolve.js.map

package/dist/wasm-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-resolve.js","sourceRoot":"","sources":["../src/wasm-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAalC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,UAAmB;IAClE,qBAAqB;IACrB,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC/F,IAAI,UAAU,CAAC,QAAQ,EAAE,wBAAwB,CAAC,EAAE,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,WAAW,EACX,6EAA6E,CAC9E,CAAC;IACF,IAAI,UAAU,CAAC,WAAW,EAAE,wBAAwB,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACpD,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;IACtE,IAAI,UAAU,CAAC,UAAU,EAAE,wBAAwB,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@czap/vite",
+  "version": "0.1.0",
+  "description": "Vite 8 plugin for czap CSS/shader transforms and HMR",
+  "license": "MIT",
+  "author": "Eassa Ayoub <eassa@heyoub.dev>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heyoub/LiteShip",
+    "directory": "packages/vite"
+  },
+  "bugs": "https://github.com/heyoub/LiteShip/issues",
+  "homepage": "https://github.com/heyoub/LiteShip#readme",
+  "keywords": [
+    "czap",
+    "vite",
+    "vite-plugin",
+    "css-transform",
+    "hmr",
+    "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"
+    },
+    "./html-transform": {
+      "types": "./dist/html-transform.d.ts",
+      "import": "./dist/html-transform.js",
+      "development": "./src/html-transform.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@czap/core": "0.1.0",
+    "@czap/compiler": "0.1.0"
+  },
+  "peerDependencies": {
+    "vite": ">=8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "vite": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}