@pandacss/compiler-wasm 2.0.0-beta.5 → 2.0.0-beta.6

package/dist/{chunk-R2J25HLY.js → chunk-5E5JPQ3B.js}

@@ -2,8 +2,12 @@
 import {
   assertProjectCallbacks,
   assertProjectHooks,
+  BuildInfo,
+  DesignSystem,
+  createUsageReport,
   getTokenCategoryValues,
-  makeBuildInfoApi,
+  inspectFile,
+  inspectFiles,
   mergeCallbacks,
   prepareCompilerConfig
 } from "@pandacss/compiler-shared";
@@ -78,13 +82,40 @@ function build(mod, config, callbacks, hooks) {
   const prepared = prepareCompilerConfig(config);
   const compiler = mod.WasmCompiler.fromConfig(fs, prepared, buildFromConfigOptions(callbacks));
   registerCallbacks(compiler, callbacks, hooks, compiler.token_dictionary?.());
-  compiler.fs = fs;
-  Object.defineProperty(compiler, "buildInfo", {
-    value: makeBuildInfoApi(compiler),
+  Object.defineProperty(compiler, "fs", { value: fs, enumerable: false });
+  Object.defineProperty(compiler, "path", { value: wasmPathSystem(compiler), enumerable: false });
+  const buildInfo = new BuildInfo(compiler);
+  Object.defineProperty(compiler, "buildInfo", { value: buildInfo, enumerable: false });
+  Object.defineProperty(compiler, "designSystem", {
+    // `load` reuses the `buildInfo` namespace just wired above.
+    value: new DesignSystem(toDesignSystemBinding(compiler), buildInfo),
+    enumerable: false
+  });
+  Object.defineProperty(compiler, "inspectFile", {
+    value: (input) => inspectFile(compiler, input),
+    enumerable: false
+  });
+  Object.defineProperty(compiler, "inspectFiles", {
+    value: (files) => inspectFiles(compiler, files),
     enumerable: false
   });
   return compiler;
 }
+function wasmPathSystem(compiler) {
+  return {
+    realpath: (path) => compiler.realpath(path),
+    resolve: (path, cwd) => compiler.resolvePath(path, cwd),
+    join: (parts) => compiler.joinPath(parts),
+    dirname: (path) => compiler.dirname(path)
+  };
+}
+function toDesignSystemBinding(compiler) {
+  return {
+    createManifest: (input) => compiler.createDesignSystemManifest(input),
+    manifestSchemaVersion: () => compiler.designSystemManifestSchemaVersion(),
+    resolveChain: (manifests) => compiler.resolveDesignSystemChain(manifests)
+  };
+}
 function buildFromConfigOptions(callbacks) {
   const utilityValues = callbacks["utility.values"];
   if (!utilityValues || Object.keys(utilityValues).length === 0) return void 0;
@@ -101,6 +132,7 @@ function buildFromConfigOptions(callbacks) {
 }
 
 export {
+  createUsageReport,
   mergeCallbacks,
   createCompilerFromWasmModule,
   build,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { ParseFileReport, ScanOptions, LayerNames, Spec, SourceEntry, FileInspectionResult, ResolveUtilityValueInput, ResolvedUtilityValue, WriteArtifactsOptions, WriteCssOptions, WriteCssResult, WriteSplitCssOptions, WriteFilesResult, SerializedHookFilter, Atom, RecipeEntry, EncodedRecipeStyles, ProjectSummary, CompileOptions, CompileOutput, LayerCssOptions, SplitCssOptions, CssFile, GenerateArtifactOptions, CodegenArtifact, CodegenArtifactId, CodegenDependency, Diagnostic, CompileFileManifest, ParsedFileView, StaticPatternResult, BuildInfo, SerializedConfig, CompilerOptions, Compiler, ProjectCallbacks, ProjectHooks, ConfigSnapshot, Driver } from '@pandacss/compiler-shared';
+import { ParseFileReport, ScanOptions, LayerNames, Spec, SourceEntry, FileInspectionResult, ResolveUtilityValueInput, ResolvedUtilityValue, TokenSuggestion, WriteArtifactsOptions, WriteCssOptions, WriteCssResult, WriteLayerCssOptions, WriteSplitCssOptions, WriteFilesResult, SerializedHookFilter, Atom, RecipeEntry, EncodedRecipeStyles, ProjectSummary, CompileOptions, CompileOutput, LayerCssOptions, SplitCssOptions, CssFile, GenerateArtifactOptions, CodegenArtifact, CodegenArtifactId, CodegenDependency, Diagnostic, CompileFileManifest, ParsedFileView, StaticPatternResult, BuildInfoArtifact, DesignSystemManifestInput, DesignSystemManifest, DesignSystemChainPlan, SerializedConfig, CompilerOptions, Compiler, ProjectCallbacks, ProjectHooks, ConfigSnapshot, Driver } from '@pandacss/compiler-shared';
 export * from '@pandacss/compiler-shared';
-export { PatternHelpers, mergeCallbacks } from '@pandacss/compiler-shared';
+export { PatternHelpers, createUsageReport, mergeCallbacks } from '@pandacss/compiler-shared';
 
 /**
  * TS-facing types that mirror the wasm-bindgen generated interfaces.
@@ -86,10 +86,12 @@ declare class WasmCompiler {
     hasLayerDeclaration(css: string): boolean;
     spec(): Spec;
     sources(): SourceEntry[];
-    inspectFileSource(path: string, source: string): FileInspectionResult;
+    inspectFileSource(path: string, source: string): Omit<FileInspectionResult, 'path'>;
     resolveUtilityValue(input: ResolveUtilityValueInput): ResolvedUtilityValue | null;
+    suggestTokens(prop: string, value: string): TokenSuggestion[];
     writeArtifacts(options: WriteArtifactsOptions): string[];
     writeCss(options: WriteCssOptions): WriteCssResult;
+    writeLayerCss(options: WriteLayerCssOptions): WriteCssResult;
     writeSplitCss(options: WriteSplitCssOptions): WriteFilesResult;
     isEmpty(): boolean;
     registerUtilityTransform?(id: string, callback: (resolved: unknown, original: unknown) => unknown): void;
@@ -111,10 +113,13 @@ declare class WasmCompiler {
     /** Per-file view, or `null` when `path` isn't known. */
     getFile(path: string): ParsedFileView | null;
     staticPatternAtoms(): StaticPatternResult;
-    serializeBuildInfo(panda: string): BuildInfo;
-    applyBuildInfo(name: string, buildInfo: BuildInfo, only?: string[]): boolean;
+    serializeBuildInfo(panda: string): BuildInfoArtifact;
+    applyBuildInfo(name: string, buildInfo: BuildInfoArtifact, only?: string[]): boolean;
     buildInfoSchemaVersion(): number;
     configFingerprint(): string;
+    createDesignSystemManifest(input: DesignSystemManifestInput): DesignSystemManifest;
+    designSystemManifestSchemaVersion(): number;
+    resolveDesignSystemChain(manifests: DesignSystemManifest[]): DesignSystemChainPlan;
 }
 
 /**
@@ -136,14 +141,18 @@ declare class WasmCompiler {
  * ```
  */
 
-/** `configCallbacks` carry construction-time `utility.values` resolvers. */
+/**
+ * `configCallbacks` carry construction-time `utility.values` resolvers.
+ */
 interface WasmFromConfigOptions {
     configCallbacks?: {
         utilityValues?: Record<string, (tokenDictionary: TokenDictionaryInput | undefined) => unknown>;
     };
 }
-/** The raw wasm instance — superset of {@link Compiler} carrying the internal
- *  `token_dictionary` the facade hides. */
+/**
+ * The raw wasm instance - superset of {@link Compiler} carrying the internal
+ * `token_dictionary` the facade hides.
+ */
 interface RawWasmCompiler extends WasmCompiler {
     token_dictionary?(): TokenDictionaryInput | undefined;
 }

package/dist/index.js

@@ -2,8 +2,9 @@ import {
   build,
   buildFromConfigOptions,
   createCompilerFromWasmModule,
+  createUsageReport,
   mergeCallbacks
-} from "./chunk-R2J25HLY.js";
+} from "./chunk-5E5JPQ3B.js";
 
 // src/index.ts
 import { createRequire } from "module";
@@ -20,7 +21,7 @@ async function createBrowserDriver(options) {
   }) : await createCompilerFromSnapshot(options.snapshot);
   if (options.sources) {
     for (const [path, content] of Object.entries(options.sources)) {
-      compiler.fs?.addFile(path, content);
+      compiler.fs.addFile?.(path, content);
     }
   }
   return new BrowserDriver(compiler, options.snapshot.config);
@@ -47,16 +48,16 @@ var BrowserDriver = class extends BaseDriver {
   }
   applyChange(change) {
     if (change.kind === "unlink") {
-      this.compiler.fs?.removeFile(change.path);
+      this.compiler.fs.removeFile?.(change.path);
       return this.compiler.removeFile(change.path);
     }
     if (change.content == null) return false;
-    this.compiler.fs?.addFile(change.path, change.content);
+    this.compiler.fs.addFile?.(change.path, change.content);
     this.compiler.parseFileSource(change.path, change.content);
     return true;
   }
   getOutdir(outdir) {
-    return this.compiler.resolvePath(this.getConfiguredOutdir(outdir));
+    return this.compiler.path.resolve(this.getConfiguredOutdir(outdir));
   }
 };
 
@@ -73,7 +74,7 @@ async function loadWasm() {
   return mod;
 }
 async function createCompiler(config, options) {
-  const { createCompilerFromWasmModule: createCompilerFromWasmModule2 } = await import("./web-Z44NGLTK.js");
+  const { createCompilerFromWasmModule: createCompilerFromWasmModule2 } = await import("./web-2ZQDOLGS.js");
   return createCompilerFromWasmModule2(await loadWasm(), config, options);
 }
 async function createCompilerFromSnapshot(snapshot, options) {
@@ -88,6 +89,7 @@ export {
   createCompiler,
   createCompilerFromSnapshot,
   createCompilerFromWasmModule,
+  createUsageReport,
   loadWasm,
   mergeCallbacks
 };

package/dist/{web-Z44NGLTK.js → web-2ZQDOLGS.js}

@@ -2,11 +2,13 @@ import {
   build,
   buildFromConfigOptions,
   createCompilerFromWasmModule,
+  createUsageReport,
   mergeCallbacks
-} from "./chunk-R2J25HLY.js";
+} from "./chunk-5E5JPQ3B.js";
 export {
   build,
   buildFromConfigOptions,
   createCompilerFromWasmModule,
+  createUsageReport,
   mergeCallbacks
 };

package/dist/web.d.ts

@@ -1,6 +1,6 @@
-import { ParseFileReport, ScanOptions, LayerNames, Spec, SourceEntry, FileInspectionResult, ResolveUtilityValueInput, ResolvedUtilityValue, WriteArtifactsOptions, WriteCssOptions, WriteCssResult, WriteSplitCssOptions, WriteFilesResult, SerializedHookFilter, Atom, RecipeEntry, EncodedRecipeStyles, ProjectSummary, CompileOptions, CompileOutput, LayerCssOptions, SplitCssOptions, CssFile, GenerateArtifactOptions, CodegenArtifact, CodegenArtifactId, CodegenDependency, Diagnostic, CompileFileManifest, ParsedFileView, StaticPatternResult, BuildInfo, SerializedConfig, CompilerOptions, Compiler, ProjectCallbacks, ProjectHooks } from '@pandacss/compiler-shared';
+import { ParseFileReport, ScanOptions, LayerNames, Spec, SourceEntry, FileInspectionResult, ResolveUtilityValueInput, ResolvedUtilityValue, TokenSuggestion, WriteArtifactsOptions, WriteCssOptions, WriteCssResult, WriteLayerCssOptions, WriteSplitCssOptions, WriteFilesResult, SerializedHookFilter, Atom, RecipeEntry, EncodedRecipeStyles, ProjectSummary, CompileOptions, CompileOutput, LayerCssOptions, SplitCssOptions, CssFile, GenerateArtifactOptions, CodegenArtifact, CodegenArtifactId, CodegenDependency, Diagnostic, CompileFileManifest, ParsedFileView, StaticPatternResult, BuildInfoArtifact, DesignSystemManifestInput, DesignSystemManifest, DesignSystemChainPlan, SerializedConfig, CompilerOptions, Compiler, ProjectCallbacks, ProjectHooks } from '@pandacss/compiler-shared';
 export * from '@pandacss/compiler-shared';
-export { PatternHelpers, mergeCallbacks } from '@pandacss/compiler-shared';
+export { PatternHelpers, createUsageReport, mergeCallbacks } from '@pandacss/compiler-shared';
 
 /**
  * TS-facing types that mirror the wasm-bindgen generated interfaces.
@@ -86,10 +86,12 @@ declare class WasmCompiler {
     hasLayerDeclaration(css: string): boolean;
     spec(): Spec;
     sources(): SourceEntry[];
-    inspectFileSource(path: string, source: string): FileInspectionResult;
+    inspectFileSource(path: string, source: string): Omit<FileInspectionResult, 'path'>;
     resolveUtilityValue(input: ResolveUtilityValueInput): ResolvedUtilityValue | null;
+    suggestTokens(prop: string, value: string): TokenSuggestion[];
     writeArtifacts(options: WriteArtifactsOptions): string[];
     writeCss(options: WriteCssOptions): WriteCssResult;
+    writeLayerCss(options: WriteLayerCssOptions): WriteCssResult;
     writeSplitCss(options: WriteSplitCssOptions): WriteFilesResult;
     isEmpty(): boolean;
     registerUtilityTransform?(id: string, callback: (resolved: unknown, original: unknown) => unknown): void;
@@ -111,10 +113,13 @@ declare class WasmCompiler {
     /** Per-file view, or `null` when `path` isn't known. */
     getFile(path: string): ParsedFileView | null;
     staticPatternAtoms(): StaticPatternResult;
-    serializeBuildInfo(panda: string): BuildInfo;
-    applyBuildInfo(name: string, buildInfo: BuildInfo, only?: string[]): boolean;
+    serializeBuildInfo(panda: string): BuildInfoArtifact;
+    applyBuildInfo(name: string, buildInfo: BuildInfoArtifact, only?: string[]): boolean;
     buildInfoSchemaVersion(): number;
     configFingerprint(): string;
+    createDesignSystemManifest(input: DesignSystemManifestInput): DesignSystemManifest;
+    designSystemManifestSchemaVersion(): number;
+    resolveDesignSystemChain(manifests: DesignSystemManifest[]): DesignSystemChainPlan;
 }
 
 /**
@@ -136,14 +141,18 @@ declare class WasmCompiler {
  * ```
  */
 
-/** `configCallbacks` carry construction-time `utility.values` resolvers. */
+/**
+ * `configCallbacks` carry construction-time `utility.values` resolvers.
+ */
 interface WasmFromConfigOptions {
     configCallbacks?: {
         utilityValues?: Record<string, (tokenDictionary: TokenDictionaryInput | undefined) => unknown>;
     };
 }
-/** The raw wasm instance — superset of {@link Compiler} carrying the internal
- *  `token_dictionary` the facade hides. */
+/**
+ * The raw wasm instance - superset of {@link Compiler} carrying the internal
+ * `token_dictionary` the facade hides.
+ */
 interface RawWasmCompiler extends WasmCompiler {
     token_dictionary?(): TokenDictionaryInput | undefined;
 }

package/dist/web.js

@@ -2,8 +2,12 @@
 import {
   assertProjectCallbacks,
   assertProjectHooks,
+  BuildInfo,
+  DesignSystem,
+  createUsageReport,
   getTokenCategoryValues,
-  makeBuildInfoApi,
+  inspectFile,
+  inspectFiles,
   mergeCallbacks,
   prepareCompilerConfig
 } from "@pandacss/compiler-shared";
@@ -78,13 +82,40 @@ function build(mod, config, callbacks, hooks) {
   const prepared = prepareCompilerConfig(config);
   const compiler = mod.WasmCompiler.fromConfig(fs, prepared, buildFromConfigOptions(callbacks));
   registerCallbacks(compiler, callbacks, hooks, compiler.token_dictionary?.());
-  compiler.fs = fs;
-  Object.defineProperty(compiler, "buildInfo", {
-    value: makeBuildInfoApi(compiler),
+  Object.defineProperty(compiler, "fs", { value: fs, enumerable: false });
+  Object.defineProperty(compiler, "path", { value: wasmPathSystem(compiler), enumerable: false });
+  const buildInfo = new BuildInfo(compiler);
+  Object.defineProperty(compiler, "buildInfo", { value: buildInfo, enumerable: false });
+  Object.defineProperty(compiler, "designSystem", {
+    // `load` reuses the `buildInfo` namespace just wired above.
+    value: new DesignSystem(toDesignSystemBinding(compiler), buildInfo),
+    enumerable: false
+  });
+  Object.defineProperty(compiler, "inspectFile", {
+    value: (input) => inspectFile(compiler, input),
+    enumerable: false
+  });
+  Object.defineProperty(compiler, "inspectFiles", {
+    value: (files) => inspectFiles(compiler, files),
     enumerable: false
   });
   return compiler;
 }
+function wasmPathSystem(compiler) {
+  return {
+    realpath: (path) => compiler.realpath(path),
+    resolve: (path, cwd) => compiler.resolvePath(path, cwd),
+    join: (parts) => compiler.joinPath(parts),
+    dirname: (path) => compiler.dirname(path)
+  };
+}
+function toDesignSystemBinding(compiler) {
+  return {
+    createManifest: (input) => compiler.createDesignSystemManifest(input),
+    manifestSchemaVersion: () => compiler.designSystemManifestSchemaVersion(),
+    resolveChain: (manifests) => compiler.resolveDesignSystemChain(manifests)
+  };
+}
 function buildFromConfigOptions(callbacks) {
   const utilityValues = callbacks["utility.values"];
   if (!utilityValues || Object.keys(utilityValues).length === 0) return void 0;
@@ -103,5 +134,6 @@ export {
   build,
   buildFromConfigOptions,
   createCompilerFromWasmModule,
+  createUsageReport,
   mergeCallbacks
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/compiler-wasm",
-  "version": "2.0.0-beta.5",
+  "version": "2.0.0-beta.6",
   "description": "WebAssembly binding for the Panda compiler engine (browser/playground target)",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,10 +38,10 @@
     "pkg-web"
   ],
   "dependencies": {
-    "@pandacss/compiler-shared": "2.0.0-beta.5"
+    "@pandacss/compiler-shared": "2.0.0-beta.6"
   },
   "devDependencies": {
-    "@pandacss/config": "2.0.0-beta.5"
+    "@pandacss/config": "2.0.0-beta.6"
   },
   "engines": {
     "node": ">=22"

package/pkg-node/compiler_wasm.d.ts

@@ -65,6 +65,18 @@ export class WasmCompiler {
      * stamped into build info as `configFingerprint`.
      */
     configFingerprint(): string;
+    /**
+     * Build a `panda.lib.json` value from host-supplied fields, stamping the
+     * engine-owned schema version. Backs the `designSystem.create` JS namespace.
+     *
+     * # Errors
+     * Returns a JS error if `input` is invalid or the manifest fails to serialize.
+     */
+    createDesignSystemManifest(input: any): any;
+    /**
+     * The manifest wire-format version this binding reads/writes.
+     */
+    designSystemManifestSchemaVersion(): number;
     /**
      * Config validation diagnostics from construction.
      *
@@ -220,24 +232,30 @@ export class WasmCompiler {
      */
     refreshFileSource(path: string, source: string): boolean;
     /**
-     * Register a JS-backed pattern transform callback. The wrapper package
-     * installs callbacks referenced by the serialized config snapshot.
+     * Register a JS-backed pattern transform callback.
      */
     registerPatternTransform(id: string, callback: Function): void;
     /**
-     * Register a JS-backed `parser:before` source transform with a Rust-side
-     * filter. The filter is evaluated before calling into JS.
+     * Register a JS-backed `parser:before` source transform.
      */
     registerSourceTransform(id: string, filter: any, callback: Function): void;
     /**
-     * Register a JS-backed utility transform callback. The JS package wraps
-     * the user callback so Rust only has to pass the raw value.
+     * Register a JS-backed utility transform callback.
      */
     registerUtilityTransform(id: string, callback: Function): void;
     /**
      * Drop a file's contribution. Returns `true` if the path was known.
      */
     removeFile(path: string): boolean;
+    /**
+     * Order already-read manifests by their `designSystem` parent links into a
+     * root-first hydrate/merge plan (or report a cycle). Backs the
+     * `designSystem.resolveChain` JS namespace. Pure — the host did the reads.
+     *
+     * # Errors
+     * Returns a JS error if `manifests` is invalid or the plan fails to serialize.
+     */
+    resolveDesignSystemChain(manifests: any): any;
     resolvePath(path: string, cwd?: string | null): string;
     /**
      * Resolve selector and CSS metadata for one utility value.
@@ -292,6 +310,13 @@ export class WasmCompiler {
      * Returns a JS error if serializing fails.
      */
     staticPatternAtoms(): any;
+    /**
+     * Tokens that carry a hardcoded value, ranked (safe equivalents first).
+     *
+     * # Errors
+     * Returns a JS error if serialization fails.
+     */
+    suggestTokens(prop: string, value: string): any;
     /**
      * Aggregate counts.
      *
@@ -304,14 +329,14 @@ export class WasmCompiler {
      */
     token_dictionary(): any;
     /**
-     * Generate artifacts and write them under `outdir` via the in-memory fs.
-     * Returns the written paths.
+     * Generate artifacts and write them under `outdir`.
      *
      * # Errors
-     * Returns a JS error if a file fails to write or results fail to serialize.
+     * Returns a JS error if writing or serializing fails.
      */
     writeArtifacts(options: any): any;
     writeCss(options: any): any;
+    writeLayerCss(options: any): any;
     writeSplitCss(options: any): any;
 }
 

package/pkg-node/compiler_wasm.js

@@ -165,6 +165,38 @@ class WasmCompiler {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Build a `panda.lib.json` value from host-supplied fields, stamping the
+     * engine-owned schema version. Backs the `designSystem.create` JS namespace.
+     *
+     * # Errors
+     * Returns a JS error if `input` is invalid or the manifest fails to serialize.
+     * @param {any} input
+     * @returns {any}
+     */
+    createDesignSystemManifest(input) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmcompiler_createDesignSystemManifest(retptr, this.__wbg_ptr, addHeapObject(input));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The manifest wire-format version this binding reads/writes.
+     * @returns {number}
+     */
+    designSystemManifestSchemaVersion() {
+        const ret = wasm.wasmcompiler_designSystemManifestSchemaVersion(this.__wbg_ptr);
+        return ret >>> 0;
+    }
     /**
      * Config validation diagnostics from construction.
      *
@@ -730,8 +762,7 @@ class WasmCompiler {
         return ret !== 0;
     }
     /**
-     * Register a JS-backed pattern transform callback. The wrapper package
-     * installs callbacks referenced by the serialized config snapshot.
+     * Register a JS-backed pattern transform callback.
      * @param {string} id
      * @param {Function} callback
      */
@@ -741,8 +772,7 @@ class WasmCompiler {
         wasm.wasmcompiler_registerPatternTransform(this.__wbg_ptr, ptr0, len0, addHeapObject(callback));
     }
     /**
-     * Register a JS-backed `parser:before` source transform with a Rust-side
-     * filter. The filter is evaluated before calling into JS.
+     * Register a JS-backed `parser:before` source transform.
      * @param {string} id
      * @param {any} filter
      * @param {Function} callback
@@ -763,8 +793,7 @@ class WasmCompiler {
         }
     }
     /**
-     * Register a JS-backed utility transform callback. The JS package wraps
-     * the user callback so Rust only has to pass the raw value.
+     * Register a JS-backed utility transform callback.
      * @param {string} id
      * @param {Function} callback
      */
@@ -784,6 +813,31 @@ class WasmCompiler {
         const ret = wasm.wasmcompiler_removeFile(this.__wbg_ptr, ptr0, len0);
         return ret !== 0;
     }
+    /**
+     * Order already-read manifests by their `designSystem` parent links into a
+     * root-first hydrate/merge plan (or report a cycle). Backs the
+     * `designSystem.resolveChain` JS namespace. Pure — the host did the reads.
+     *
+     * # Errors
+     * Returns a JS error if `manifests` is invalid or the plan fails to serialize.
+     * @param {any} manifests
+     * @returns {any}
+     */
+    resolveDesignSystemChain(manifests) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmcompiler_resolveDesignSystemChain(retptr, this.__wbg_ptr, addHeapObject(manifests));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @param {string} path
      * @param {string | null} [cwd]
@@ -972,6 +1026,34 @@ class WasmCompiler {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Tokens that carry a hardcoded value, ranked (safe equivalents first).
+     *
+     * # Errors
+     * Returns a JS error if serialization fails.
+     * @param {string} prop
+     * @param {string} value
+     * @returns {any}
+     */
+    suggestTokens(prop, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(prop, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(value, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.wasmcompiler_suggestTokens(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Aggregate counts.
      *
@@ -1014,11 +1096,10 @@ class WasmCompiler {
         }
     }
     /**
-     * Generate artifacts and write them under `outdir` via the in-memory fs.
-     * Returns the written paths.
+     * Generate artifacts and write them under `outdir`.
      *
      * # Errors
-     * Returns a JS error if a file fails to write or results fail to serialize.
+     * Returns a JS error if writing or serializing fails.
      * @param {any} options
      * @returns {any}
      */
@@ -1056,6 +1137,25 @@ class WasmCompiler {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * @param {any} options
+     * @returns {any}
+     */
+    writeLayerCss(options) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmcompiler_writeLayerCss(retptr, this.__wbg_ptr, addHeapObject(options));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @param {any} options
      * @returns {any}

package/pkg-node/compiler_wasm_bg.wasm.d.ts

@@ -11,6 +11,8 @@ export const wasmcompiler_clear: (a: number) => void;
 export const wasmcompiler_compile: (a: number, b: number, c: number) => void;
 export const wasmcompiler_config: (a: number, b: number) => void;
 export const wasmcompiler_configFingerprint: (a: number, b: number) => void;
+export const wasmcompiler_createDesignSystemManifest: (a: number, b: number, c: number) => void;
+export const wasmcompiler_designSystemManifestSchemaVersion: (a: number) => number;
 export const wasmcompiler_diagnostics: (a: number, b: number) => void;
 export const wasmcompiler_dirname: (a: number, b: number, c: number, d: number) => void;
 export const wasmcompiler_encodedRecipes: (a: number, b: number) => void;
@@ -40,6 +42,7 @@ export const wasmcompiler_registerPatternTransform: (a: number, b: number, c: nu
 export const wasmcompiler_registerSourceTransform: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmcompiler_registerUtilityTransform: (a: number, b: number, c: number, d: number) => void;
 export const wasmcompiler_removeFile: (a: number, b: number, c: number) => number;
+export const wasmcompiler_resolveDesignSystemChain: (a: number, b: number, c: number) => void;
 export const wasmcompiler_resolvePath: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmcompiler_resolveUtilityValue: (a: number, b: number, c: number) => void;
 export const wasmcompiler_scan: (a: number, b: number, c: number) => void;
@@ -48,10 +51,12 @@ export const wasmcompiler_slotRecipes: (a: number, b: number) => void;
 export const wasmcompiler_sources: (a: number, b: number) => void;
 export const wasmcompiler_spec: (a: number, b: number) => void;
 export const wasmcompiler_staticPatternAtoms: (a: number, b: number) => void;
+export const wasmcompiler_suggestTokens: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmcompiler_summary: (a: number, b: number) => void;
 export const wasmcompiler_token_dictionary: (a: number, b: number) => void;
 export const wasmcompiler_writeArtifacts: (a: number, b: number, c: number) => void;
 export const wasmcompiler_writeCss: (a: number, b: number, c: number) => void;
+export const wasmcompiler_writeLayerCss: (a: number, b: number, c: number) => void;
 export const wasmcompiler_writeSplitCss: (a: number, b: number, c: number) => void;
 export const wasmextractor_new: (a: number, b: number, c: number) => void;
 export const wasmextractor_parseFile: (a: number, b: number, c: number, d: number, e: number, f: number) => void;

package/pkg-web/compiler_wasm.d.ts

@@ -65,6 +65,18 @@ export class WasmCompiler {
      * stamped into build info as `configFingerprint`.
      */
     configFingerprint(): string;
+    /**
+     * Build a `panda.lib.json` value from host-supplied fields, stamping the
+     * engine-owned schema version. Backs the `designSystem.create` JS namespace.
+     *
+     * # Errors
+     * Returns a JS error if `input` is invalid or the manifest fails to serialize.
+     */
+    createDesignSystemManifest(input: any): any;
+    /**
+     * The manifest wire-format version this binding reads/writes.
+     */
+    designSystemManifestSchemaVersion(): number;
     /**
      * Config validation diagnostics from construction.
      *
@@ -220,24 +232,30 @@ export class WasmCompiler {
      */
     refreshFileSource(path: string, source: string): boolean;
     /**
-     * Register a JS-backed pattern transform callback. The wrapper package
-     * installs callbacks referenced by the serialized config snapshot.
+     * Register a JS-backed pattern transform callback.
      */
     registerPatternTransform(id: string, callback: Function): void;
     /**
-     * Register a JS-backed `parser:before` source transform with a Rust-side
-     * filter. The filter is evaluated before calling into JS.
+     * Register a JS-backed `parser:before` source transform.
      */
     registerSourceTransform(id: string, filter: any, callback: Function): void;
     /**
-     * Register a JS-backed utility transform callback. The JS package wraps
-     * the user callback so Rust only has to pass the raw value.
+     * Register a JS-backed utility transform callback.
      */
     registerUtilityTransform(id: string, callback: Function): void;
     /**
      * Drop a file's contribution. Returns `true` if the path was known.
      */
     removeFile(path: string): boolean;
+    /**
+     * Order already-read manifests by their `designSystem` parent links into a
+     * root-first hydrate/merge plan (or report a cycle). Backs the
+     * `designSystem.resolveChain` JS namespace. Pure — the host did the reads.
+     *
+     * # Errors
+     * Returns a JS error if `manifests` is invalid or the plan fails to serialize.
+     */
+    resolveDesignSystemChain(manifests: any): any;
     resolvePath(path: string, cwd?: string | null): string;
     /**
      * Resolve selector and CSS metadata for one utility value.
@@ -292,6 +310,13 @@ export class WasmCompiler {
      * Returns a JS error if serializing fails.
      */
     staticPatternAtoms(): any;
+    /**
+     * Tokens that carry a hardcoded value, ranked (safe equivalents first).
+     *
+     * # Errors
+     * Returns a JS error if serialization fails.
+     */
+    suggestTokens(prop: string, value: string): any;
     /**
      * Aggregate counts.
      *
@@ -304,14 +329,14 @@ export class WasmCompiler {
      */
     token_dictionary(): any;
     /**
-     * Generate artifacts and write them under `outdir` via the in-memory fs.
-     * Returns the written paths.
+     * Generate artifacts and write them under `outdir`.
      *
      * # Errors
-     * Returns a JS error if a file fails to write or results fail to serialize.
+     * Returns a JS error if writing or serializing fails.
      */
     writeArtifacts(options: any): any;
     writeCss(options: any): any;
+    writeLayerCss(options: any): any;
     writeSplitCss(options: any): any;
 }
 
@@ -401,6 +426,8 @@ export interface InitOutput {
     readonly wasmcompiler_compile: (a: number, b: number, c: number) => void;
     readonly wasmcompiler_config: (a: number, b: number) => void;
     readonly wasmcompiler_configFingerprint: (a: number, b: number) => void;
+    readonly wasmcompiler_createDesignSystemManifest: (a: number, b: number, c: number) => void;
+    readonly wasmcompiler_designSystemManifestSchemaVersion: (a: number) => number;
     readonly wasmcompiler_diagnostics: (a: number, b: number) => void;
     readonly wasmcompiler_dirname: (a: number, b: number, c: number, d: number) => void;
     readonly wasmcompiler_encodedRecipes: (a: number, b: number) => void;
@@ -430,6 +457,7 @@ export interface InitOutput {
     readonly wasmcompiler_registerSourceTransform: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly wasmcompiler_registerUtilityTransform: (a: number, b: number, c: number, d: number) => void;
     readonly wasmcompiler_removeFile: (a: number, b: number, c: number) => number;
+    readonly wasmcompiler_resolveDesignSystemChain: (a: number, b: number, c: number) => void;
     readonly wasmcompiler_resolvePath: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly wasmcompiler_resolveUtilityValue: (a: number, b: number, c: number) => void;
     readonly wasmcompiler_scan: (a: number, b: number, c: number) => void;
@@ -438,10 +466,12 @@ export interface InitOutput {
     readonly wasmcompiler_sources: (a: number, b: number) => void;
     readonly wasmcompiler_spec: (a: number, b: number) => void;
     readonly wasmcompiler_staticPatternAtoms: (a: number, b: number) => void;
+    readonly wasmcompiler_suggestTokens: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly wasmcompiler_summary: (a: number, b: number) => void;
     readonly wasmcompiler_token_dictionary: (a: number, b: number) => void;
     readonly wasmcompiler_writeArtifacts: (a: number, b: number, c: number) => void;
     readonly wasmcompiler_writeCss: (a: number, b: number, c: number) => void;
+    readonly wasmcompiler_writeLayerCss: (a: number, b: number, c: number) => void;
     readonly wasmcompiler_writeSplitCss: (a: number, b: number, c: number) => void;
     readonly wasmextractor_new: (a: number, b: number, c: number) => void;
     readonly wasmextractor_parseFile: (a: number, b: number, c: number, d: number, e: number, f: number) => void;

package/pkg-web/compiler_wasm.js

@@ -165,6 +165,38 @@ export class WasmCompiler {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Build a `panda.lib.json` value from host-supplied fields, stamping the
+     * engine-owned schema version. Backs the `designSystem.create` JS namespace.
+     *
+     * # Errors
+     * Returns a JS error if `input` is invalid or the manifest fails to serialize.
+     * @param {any} input
+     * @returns {any}
+     */
+    createDesignSystemManifest(input) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmcompiler_createDesignSystemManifest(retptr, this.__wbg_ptr, addHeapObject(input));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * The manifest wire-format version this binding reads/writes.
+     * @returns {number}
+     */
+    designSystemManifestSchemaVersion() {
+        const ret = wasm.wasmcompiler_designSystemManifestSchemaVersion(this.__wbg_ptr);
+        return ret >>> 0;
+    }
     /**
      * Config validation diagnostics from construction.
      *
@@ -730,8 +762,7 @@ export class WasmCompiler {
         return ret !== 0;
     }
     /**
-     * Register a JS-backed pattern transform callback. The wrapper package
-     * installs callbacks referenced by the serialized config snapshot.
+     * Register a JS-backed pattern transform callback.
      * @param {string} id
      * @param {Function} callback
      */
@@ -741,8 +772,7 @@ export class WasmCompiler {
         wasm.wasmcompiler_registerPatternTransform(this.__wbg_ptr, ptr0, len0, addHeapObject(callback));
     }
     /**
-     * Register a JS-backed `parser:before` source transform with a Rust-side
-     * filter. The filter is evaluated before calling into JS.
+     * Register a JS-backed `parser:before` source transform.
      * @param {string} id
      * @param {any} filter
      * @param {Function} callback
@@ -763,8 +793,7 @@ export class WasmCompiler {
         }
     }
     /**
-     * Register a JS-backed utility transform callback. The JS package wraps
-     * the user callback so Rust only has to pass the raw value.
+     * Register a JS-backed utility transform callback.
      * @param {string} id
      * @param {Function} callback
      */
@@ -784,6 +813,31 @@ export class WasmCompiler {
         const ret = wasm.wasmcompiler_removeFile(this.__wbg_ptr, ptr0, len0);
         return ret !== 0;
     }
+    /**
+     * Order already-read manifests by their `designSystem` parent links into a
+     * root-first hydrate/merge plan (or report a cycle). Backs the
+     * `designSystem.resolveChain` JS namespace. Pure — the host did the reads.
+     *
+     * # Errors
+     * Returns a JS error if `manifests` is invalid or the plan fails to serialize.
+     * @param {any} manifests
+     * @returns {any}
+     */
+    resolveDesignSystemChain(manifests) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmcompiler_resolveDesignSystemChain(retptr, this.__wbg_ptr, addHeapObject(manifests));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @param {string} path
      * @param {string | null} [cwd]
@@ -972,6 +1026,34 @@ export class WasmCompiler {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Tokens that carry a hardcoded value, ranked (safe equivalents first).
+     *
+     * # Errors
+     * Returns a JS error if serialization fails.
+     * @param {string} prop
+     * @param {string} value
+     * @returns {any}
+     */
+    suggestTokens(prop, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(prop, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            const ptr1 = passStringToWasm0(value, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len1 = WASM_VECTOR_LEN;
+            wasm.wasmcompiler_suggestTokens(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Aggregate counts.
      *
@@ -1014,11 +1096,10 @@ export class WasmCompiler {
         }
     }
     /**
-     * Generate artifacts and write them under `outdir` via the in-memory fs.
-     * Returns the written paths.
+     * Generate artifacts and write them under `outdir`.
      *
      * # Errors
-     * Returns a JS error if a file fails to write or results fail to serialize.
+     * Returns a JS error if writing or serializing fails.
      * @param {any} options
      * @returns {any}
      */
@@ -1056,6 +1137,25 @@ export class WasmCompiler {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * @param {any} options
+     * @returns {any}
+     */
+    writeLayerCss(options) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmcompiler_writeLayerCss(retptr, this.__wbg_ptr, addHeapObject(options));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @param {any} options
      * @returns {any}

package/pkg-web/compiler_wasm_bg.wasm.d.ts

@@ -11,6 +11,8 @@ export const wasmcompiler_clear: (a: number) => void;
 export const wasmcompiler_compile: (a: number, b: number, c: number) => void;
 export const wasmcompiler_config: (a: number, b: number) => void;
 export const wasmcompiler_configFingerprint: (a: number, b: number) => void;
+export const wasmcompiler_createDesignSystemManifest: (a: number, b: number, c: number) => void;
+export const wasmcompiler_designSystemManifestSchemaVersion: (a: number) => number;
 export const wasmcompiler_diagnostics: (a: number, b: number) => void;
 export const wasmcompiler_dirname: (a: number, b: number, c: number, d: number) => void;
 export const wasmcompiler_encodedRecipes: (a: number, b: number) => void;
@@ -40,6 +42,7 @@ export const wasmcompiler_registerPatternTransform: (a: number, b: number, c: nu
 export const wasmcompiler_registerSourceTransform: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmcompiler_registerUtilityTransform: (a: number, b: number, c: number, d: number) => void;
 export const wasmcompiler_removeFile: (a: number, b: number, c: number) => number;
+export const wasmcompiler_resolveDesignSystemChain: (a: number, b: number, c: number) => void;
 export const wasmcompiler_resolvePath: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmcompiler_resolveUtilityValue: (a: number, b: number, c: number) => void;
 export const wasmcompiler_scan: (a: number, b: number, c: number) => void;
@@ -48,10 +51,12 @@ export const wasmcompiler_slotRecipes: (a: number, b: number) => void;
 export const wasmcompiler_sources: (a: number, b: number) => void;
 export const wasmcompiler_spec: (a: number, b: number) => void;
 export const wasmcompiler_staticPatternAtoms: (a: number, b: number) => void;
+export const wasmcompiler_suggestTokens: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmcompiler_summary: (a: number, b: number) => void;
 export const wasmcompiler_token_dictionary: (a: number, b: number) => void;
 export const wasmcompiler_writeArtifacts: (a: number, b: number, c: number) => void;
 export const wasmcompiler_writeCss: (a: number, b: number, c: number) => void;
+export const wasmcompiler_writeLayerCss: (a: number, b: number, c: number) => void;
 export const wasmcompiler_writeSplitCss: (a: number, b: number, c: number) => void;
 export const wasmextractor_new: (a: number, b: number, c: number) => void;
 export const wasmextractor_parseFile: (a: number, b: number, c: number, d: number, e: number, f: number) => void;