@teacss/engine 0.8.5-alpha.4 → 0.9.0-alpha.3

package/dist/facade/transformer.d.ts

@@ -0,0 +1,44 @@
+import type { HighlightAnnotation, TransformResult } from "../../contract.js";
+import { ENGINE_INSTANCE } from "./constants.js";
+interface EditTarget {
+    update(start: number, end: number, text: string): unknown;
+    appendLeft(index: number, text: string): unknown;
+}
+/** The part of the native `Engine` the transformer calls. */
+interface TransformEngine {
+    transformSource(id: string, code: string): TransformResult | null;
+    clearModuleDefinitions(id: string): boolean;
+}
+/** The runtime's transformer context; only the fields the transformer reads. */
+interface TransformContext {
+    generator?: {
+        [ENGINE_INSTANCE]?: TransformEngine;
+    };
+    tokens?: Set<string>;
+    invalidate?: () => void;
+}
+/**
+ * Replays v02.2 `TransformResult.edits` on the host MagicString. A zero-length range is an insert:
+ * magic-string throws on a zero-length `update`.
+ */
+export declare function replayEdits(s: EditTarget, edits: ReadonlyArray<{
+    start: number;
+    end: number;
+    text: string;
+}>): void;
+/**
+ * The object shape of preset-standard/transformers/compile-class.ts:178-274, backed by Rust
+ * `transformSource`. It has no `idFilter`: the runtime's pipeline filter picks the modules.
+ */
+export declare function createCompileClassTransformer(): {
+    name: "@teacss/transformer-compile-class";
+    enforce: "pre";
+    transform(s: EditTarget & {
+        original: string;
+    }, id: string, ctx: TransformContext): Promise<{
+        highlightAnnotations: HighlightAnnotation[];
+    } | undefined>;
+    onModuleRemoved(id: string, ctx: TransformContext): void;
+};
+export {};
+//# sourceMappingURL=transformer.d.ts.map

package/dist/facade/transformer.js

@@ -0,0 +1,59 @@
+import { ENGINE_INSTANCE } from "./constants.js";
+/**
+ * Replays v02.2 `TransformResult.edits` on the host MagicString. A zero-length range is an insert:
+ * magic-string throws on a zero-length `update`.
+ */
+export function replayEdits(s, edits) {
+    for (const { start, end, text } of edits) {
+        if (start === end)
+            s.appendLeft(start, text);
+        else
+            s.update(start, end, text);
+    }
+}
+const engineOf = (ctx) => ctx?.generator?.[ENGINE_INSTANCE] ?? null;
+/**
+ * The object shape of preset-standard/transformers/compile-class.ts:178-274, backed by Rust
+ * `transformSource`. It has no `idFilter`: the runtime's pipeline filter picks the modules.
+ */
+export function createCompileClassTransformer() {
+    return {
+        name: "@teacss/transformer-compile-class",
+        enforce: "pre",
+        async transform(s, id, ctx) {
+            const engine = engineOf(ctx);
+            if (!engine)
+                return;
+            const result = engine.transformSource(id, s.original);
+            if (!result)
+                return;
+            replayEdits(s, result.edits);
+            if (ctx.tokens)
+                for (const name of result.compiledClasses)
+                    ctx.tokens.add(name);
+            if (result.definitionsChanged)
+                ctx.invalidate?.();
+            return { highlightAnnotations: result.highlightAnnotations };
+        },
+        /**
+         * Releases the module's definitions only: the runtime also calls this when a module stays
+         * (context switches, failed transforms), so its tokens are kept (v02.9 §6.1 step 8).
+         */
+        onModuleRemoved(id, ctx) {
+            const engine = engineOf(ctx);
+            if (!engine)
+                return;
+            let changed = false;
+            try {
+                changed = engine.clearModuleDefinitions(id);
+            }
+            catch (error) {
+                if (error?.code !== "E_DISPOSED")
+                    throw error;
+            }
+            if (changed)
+                ctx.invalidate?.();
+        },
+    };
+}
+//# sourceMappingURL=transformer.js.map

package/dist/facade/ts-fallback.d.ts

@@ -0,0 +1,32 @@
+/** A TypeScript generator from `@teacss/core`; the facade only forwards to it. */
+export type TsGenerator = any;
+export interface CoreBinding {
+    version: string;
+    createGenerator: (config?: object, defaults?: object) => Promise<TsGenerator>;
+    createTsGenerator?: (config?: object, defaults?: object) => Promise<TsGenerator>;
+    extractorSplit: object;
+}
+/** Test seam that replaces the dynamic import of `@teacss/core`. */
+export declare const coreLoader: {
+    load: (() => Promise<CoreBinding>) | null;
+};
+/** Rejects with `E_TS_REQUIRED` when the peer is missing. */
+export declare function importCore(member: string): Promise<CoreBinding>;
+export interface TsFallback {
+    invalidate(userConfig: object, defaults: object): void;
+    generator(member?: string): Promise<TsGenerator>;
+    peek(): TsGenerator | null;
+    create(userConfig: object, defaults: object): Promise<TsGenerator>;
+}
+/**
+ * `engine: "ts"` goes into the defaults, which take precedence over `config.engine`, so the TS
+ * generator does not enter the hook again. `committed` is the configuration committed at
+ * construction.
+ */
+export declare function createTsFallback(host: {
+    core?: CoreBinding | undefined;
+}, committed: {
+    userConfig: object;
+    defaults: object;
+}): TsFallback;
+//# sourceMappingURL=ts-fallback.d.ts.map

package/dist/facade/ts-fallback.js

@@ -0,0 +1,78 @@
+// The lazily created TypeScript generator behind the facade (v02.9 §3.3).
+import { ENGINE_INSTANCE } from "./constants.js";
+import { tsRequiredError } from "./errors.js";
+/** Test seam that replaces the dynamic import of `@teacss/core`. */
+export const coreLoader = {
+    load: null,
+};
+/** Rejects with `E_TS_REQUIRED` when the peer is missing. */
+export async function importCore(member) {
+    try {
+        // biome-ignore lint/suspicious/noTsIgnore: the optional peer may or may not be installed
+        // @ts-ignore optional peer: @teacss/core may be absent at compile time
+        return await (coreLoader.load ? coreLoader.load() : import("@teacss/core"));
+    }
+    catch {
+        throw tsRequiredError(member);
+    }
+}
+/**
+ * `engine: "ts"` goes into the defaults, which take precedence over `config.engine`, so the TS
+ * generator does not enter the hook again. `committed` is the configuration committed at
+ * construction.
+ */
+export function createTsFallback(host, committed) {
+    let generatorPromise = null;
+    let resolved = null;
+    const core = (member) => (host.core ? Promise.resolve(host.core) : importCore(member));
+    /**
+     * A TypeScript generator. The hook's `createTsGenerator` bypasses it; `createGenerator` (an older
+     * core, or `@teacss/core` imported without a hook) re-enters it when TEACSS_ENGINE overrides
+     * `engine: "ts"`, and returns a facade for a configuration Rust can serve.
+     */
+    const createTs = (binding, userConfig, defaults) => {
+        const tsDefaults = { ...defaults, engine: "ts" };
+        return typeof binding.createTsGenerator === "function" ? binding.createTsGenerator(userConfig, tsDefaults) : binding.createGenerator(userConfig, tsDefaults);
+    };
+    return {
+        /** Called after a successful `commitConfig`; drops the lazy instance. */
+        invalidate(userConfig, defaults) {
+            committed = { userConfig, defaults };
+            generatorPromise = null;
+            resolved = null;
+        },
+        /** The lazy TS generator; a rejection is not cached. */
+        generator(member = "materialize") {
+            generatorPromise ??= (async () => {
+                const binding = await core(member);
+                const generator = await createTs(binding, committed.userConfig, committed.defaults);
+                resolved = generator;
+                return generator;
+            })().catch((error) => {
+                generatorPromise = null;
+                throw error;
+            });
+            return generatorPromise;
+        },
+        /** The ready instance, or `null` before `generator()` resolves. */
+        peek() {
+            return resolved;
+        },
+        /**
+         * A TS candidate for a configuration (v02.9 §5.2), made by the TS generator's own
+         * `prepareConfig` so it tracks in-place edits of its config as an oracle candidate does
+         * (generator.ts:1986-2011). The lazy instance is untouched.
+         */
+        async create(userConfig, defaults) {
+            const binding = await core("prepareConfig");
+            const tsDefaults = { ...defaults, engine: "ts" };
+            // Without `createTsGenerator` the base is built from the configuration itself: Rust cannot
+            // translate it, so `createGenerator` resolves to TS and creates no Engine.
+            const base = await createTs(binding, typeof binding.createTsGenerator === "function" ? {} : userConfig, defaults);
+            if (ENGINE_INSTANCE in Object(base) || typeof base?.prepareConfig !== "function")
+                return base;
+            return (await base.prepareConfig(userConfig, tsDefaults)).generator;
+        },
+    };
+}
+//# sourceMappingURL=ts-fallback.js.map

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "../binding.js";
+export type * from "../contract.js";
+export * from "./facade/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "../binding.js";
+export * from "./facade/index.js";
+//# sourceMappingURL=index.js.map

package/index.d.ts

@@ -1,387 +1 @@
-// Mirror of docs/specs/v02.2-engine-contract.md §3 (spec-revision 2). Do not edit without bumping the spec revision.
-/** 原生绑定的 crate 版本（Cargo.toml 的 version）。 */
-export declare function version(): string;
-
-export declare class Engine {
-  constructor();
-
-  /** 读入口 CSS 与本地 @import 图，返回 JS 完成预设与 @source 枚举所需的信息。不改变实例状态。 */
-  inspectEntry(request: InspectEntryRequest): InspectEntryResult;
-
-  /** 解析配置、构建 program。可重复调用以重载；返回 programKey 是否变化。 */
-  loadProject(request: LoadProjectRequest): LoadProjectResult;
-
-  /** 当前 program key；未 loadProject 时抛 E_PROJECT_NOT_LOADED。 */
-  programKey(): string;
-
-  /** 0.8.2 `ResolvedConfig` 的只读视图（§5）。 */
-  configView(): ResolvedConfigView;
-
-  /** 入口、本地 @import、declaration CSS 的绝对路径，供宿主 watch。顺序：入口、import（深度优先）、declarationFiles（v02.5 §6 归一化后的顺序）。 */
-  configFiles(): string[];
-
-  /** 当前 program 允许的 @custom 命名空间键（oracle `scaleThemeKeys` 的结果），供 facade 的 `diagnoseCustom` 调用。 */
-  customThemeKeys(): string[];
-
-  /** 对宿主模块抽取 token 并记录所有权。code 为宿主交付的（已转换的）代码。 */
-  updateModule(id: string, code: string): ModuleUpdateResult;
-
-  /** 删除模块及其 token、compile-class 定义。返回是否存在。 */
-  removeModule(id: string): boolean;
-
-  /** 只清除该模块登记的 compile-class 定义，保留 token（facade 的 `onModuleRemoved` 使用，v02.9 §6）。返回是否有定义被清除。 */
-  clearModuleDefinitions(id: string): boolean;
-  /** 转换器登记的 compile-class shortcut，按登记顺序；即 oracle 追加到 `config.shortcuts` 的条目，转换器设了 `layer` 时带 `{ layer }`。 */
-  compileClassShortcuts(): Array<[string, string] | [string, string, { layer: string }]>;
-
-  /** 模块当前 token（去重，首次出现顺序）；不存在返回 null。 */
-  moduleTokens(id: string): string[] | null;
-
-  /** 所有模块 token 的并集，顺序为模块 id 的字典序，再模块内顺序。 */
-  allTokens(): string[];
-
-  /** 无状态抽取，等价 oracle `generator.applyExtractors(code, id, new Set())`。 */
-  extract(code: string, id?: string | undefined | null): string[];
-
-  /** 无状态抽取并计数，等价 oracle 以 `CountableSet` 调用 `applyExtractors`；顺序同 extract。 */
-  extractCounted(code: string, id?: string | undefined | null): Array<{ token: string; count: number }>;
-
-  /** 读取并抽取磁盘文件；允许并行读取，结果按输入顺序。读失败的文件给出 error 字段。 */
-  extractFiles(paths: string[]): ExtractFileResult[];
-
-  /** JS/TS/JSX/TSX 源码的 compileClass 转换。无改动返回 null。有状态：登记该模块的 compile-class 定义。 */
-  transformSource(id: string, code: string): TransformResult | null;
-
-  /** CSS 的 @apply / --at-apply / @screen / theme() / icon() 转换。无改动返回 null。 */
-  transformStylesheet(id: string, code: string): TransformResult | null;
-
-  /** 生成 CSS。 */
-  generate(input: GenerateInput, options?: GenerateOptions | undefined | null): GenerateResult;
-
-  /** 等价 oracle `generator.parseToken(raw, alias)`：null = 未匹配或被 blocklist 拦截（见 §6.6）。 */
-  parseToken(raw: string, alias?: string | undefined | null): StringifiedUtil[] | null;
-
-  /** 等价 oracle `generator.isBlocked(raw)`。 */
-  isBlocked(raw: string): boolean;
-
-  /** 对未匹配 token 计算近似建议，等价 oracle `diagnoseUnmatchedToken`。 */
-  diagnoseUnmatched(tokens: string[]): UnmatchedDiagnostic[];
-
-  /** theme("a.b.c") 的取值；不存在返回 null。 */
-  themeValue(path: string): string | null;
-
-  /** 释放状态；之后任何方法抛 E_DISPOSED。 */
-  dispose(): void;
-}
-
-/** 等价 config `parseEntry(css, file)`。 */
-export declare function parseEntry(css: string, file?: string | undefined | null): EntryConfig;
-/** 等价 config `diagnoseEntry(css)`。 */
-export declare function diagnoseEntry(css: string): EntryDiagnostic[];
-/** 等价 config `diagnoseCustom(css, themeKeys)`。 */
-export declare function diagnoseCustom(css: string, themeKeys: string[]): CustomDiagnostic[];
-/** 等价 core `expandClassGroups(code)`。 */
-export declare function expandClassGroups(code: string): string;
-/** 等价 core `splitClassTokens(body)`。 */
-export declare function splitClassTokens(body: string): string[];
-/** 等价 core `hash(str)`（compileClass 类名哈希）。 */
-export declare function hash(input: string): string;
-
-export interface InspectEntryRequest {
-  /** 项目根（绝对路径）。相对 @source 以声明它的文件所在目录为基准。 */
-  root: string;
-  /** 入口 CSS 绝对路径。 */
-  entryPath: string;
-  /** 若宿主已持有入口内容（未保存的编辑器缓冲等），传入以替代磁盘读取。 */
-  entryCss?: string | undefined | null;
-}
-
-export interface InspectEntryResult {
-  /** @presets 列表，按声明顺序、去重（oracle resolvePresetGraph 的输入）。 */
-  presets: string[];
-  /** @source 声明；glob 已按声明文件目录解析为相对 root 的形式，exclude 以 `!` 前缀表示。 */
-  sources: string[];
-  /** 入口与本地 @import 图中读取过的文件（绝对路径，深度优先）。 */
-  configFiles: string[];
-  hasTeacss: boolean;
-  /** 入口语法诊断；非空时 loadProject 会以 E_ENTRY_INVALID 失败。 */
-  diagnostics: EntryDiagnostic[];
-}
-
-export interface LoadProjectRequest {
-  root: string;
-  /** null 表示没有入口文件（oracle loadConfig 找不到 entry 的情形）。 */
-  entry: { path: string; css?: string | undefined | null } | null;
-  /** 已解析顺序的预设（oracle 排序规则：pre、normal、post，见 core/config.ts:209）。 */
-  presets: PresetSpec[];
-  /** @source 匹配到的 .css 文件（绝对路径），只贡献 @shortcut/@safelist。由 JS 枚举。 */
-  declarationFiles: string[];
-  /** 内联 UserConfig / defaults 中可静态表示的部分。 */
-  inline?: StaticConfig | undefined | null;
-  envMode: "dev" | "build";
-  unmatched: "warn" | "error" | "off";
-  /** 对应 UserConfig.outputToCssLayers；函数形式由 facade 判定回退。 */
-  outputToCssLayers?: boolean | { allLayers?: boolean } | undefined | null;
-  shortcutsLayer?: string | undefined | null;
-  virtualModulePrefix?: string | undefined | null;
-}
-
-export interface LoadProjectResult {
-  programKey: string;
-  /** 与上一次 loadProject 相比 programKey 是否变化；首次为 true。 */
-  changed: boolean;
-  /** 声明文件中解析失败的位置（不阻止加载，oracle 行为相同）。 */
-  warnings: EntryDiagnostic[];
-  /** @custom 中不属于任何命名空间的属性名（oracle `ResolveEntryResult.unknown`），facade 的 `resolveEntryConfig` 透传。 */
-  unknownCustom: string[];
-}
-
-export type PresetSpec =
-  | { kind: "standard"; options?: PresetStandardOptions | undefined | null }
-  | { kind: "official" }
-  | { kind: "icons"; options?: PresetIconsOptions | undefined | null }
-  | { kind: "static"; preset: StaticPreset };
-
-export interface PresetStandardOptions {
-  modeSelectors?: { dark?: string; light?: string } | undefined | null;
-  containers?: Record<string, string> | undefined | null;
-  preflight?: boolean | "on-demand" | undefined | null;
-  variablePrefix?: string | undefined | null;
-  compileClass?: boolean | CompileClassOptions | undefined | null;
-}
-
-export interface CompileClassOptions {
-  classPrefix?: string | undefined | null;
-  alwaysHash?: boolean | undefined | null;
-  keepUnknown?: boolean | undefined | null;
-  layer?: string | undefined | null;
-}
-
-export interface PresetIconsOptions {
-  scale?: number | undefined | null;
-  mode?: "mask" | "bg" | "auto" | undefined | null;
-  extraProperties?: Record<string, string> | undefined | null;
-  warn?: boolean | undefined | null;
-  layer?: string | undefined | null;
-  unit?: string | undefined | null;
-  /** 只允许内置集合名；其他集合由 facade 判定回退。 */
-  collections?: string[] | undefined | null;
-}
-
-/** 本地/第三方 preset 的可静态表示部分。任何不能表示的字段都由 facade 判定回退，不进入这里。 */
-export interface StaticPreset {
-  name: string;
-  enforce?: "pre" | "post" | undefined | null;
-  layer?: string | undefined | null;
-  layers?: Record<string, number> | undefined | null;
-  shortcuts?: Array<[string, string]> | undefined | null;
-  safelist?: string[] | undefined | null;
-  blocklist?: string[] | undefined | null;
-  /** 只接受 oracle `Theme` 中的标量叶子；对象按点路径展平后传入。 */
-  theme?: Record<string, string> | undefined | null;
-}
-
-export interface StaticConfig {
-  shortcuts?: Array<[string, string]> | undefined | null;
-  safelist?: string[] | undefined | null;
-  blocklist?: string[] | undefined | null;
-  layers?: Record<string, number> | undefined | null;
-  theme?: Record<string, string> | undefined | null;
-  content?: { filesystem?: string[] | undefined | null } | undefined | null;
-}
-
-export interface ModuleUpdateResult {
-  tokens: string[];
-  /** 该模块 token 集或 compile-class 定义相对上一次是否变化。 */
-  changed: boolean;
-}
-
-export interface ExtractFileResult {
-  path: string;
-  tokens: string[];
-  /** 读取失败时的错误码（E_IO）；成功为 null。 */
-  error: string | null;
-}
-
-export interface TransformResult {
-  code: string;
-  /** 从原文到 code 的替换序列，UTF-16 code unit 偏移，按 (start, end) 升序且互不重叠。facade 在宿主的 MagicString 上按顺序回放：`start === end ? s.appendLeft(start, text) : s.update(start, end, text)`（magic-string 1.x 的 `update` 与 `overwrite` 除 `storeName` 默认值外相同），使 runtime 生成的 source map 与 0.8.2 完全一致（v02.8 §7）。 */
-  edits: Array<{ start: number; end: number; text: string }>;
-  /** 独立使用者（无 MagicString）用的 Source Map v3：sources = [id]，sourcesContent = [原文]。 */
-  map: SourceMap;
-  /** oracle SourceCodeTransformer 返回的高亮区间（compileClass 提供）。 */
-  highlightAnnotations: HighlightAnnotation[];
-  /** transformSource：本次登记的 compile-class 类名（facade 并入 `ctx.tokens`，v02.9 §6）；transformStylesheet 为空数组。 */
-  compiledClasses: string[];
-  /** transformSource：该模块的定义集相对上一次是否变化（facade 据此调用 `ctx.invalidate()`）；transformStylesheet 为 false。 */
-  definitionsChanged: boolean;
-}
-
-export interface SourceMap {
-  version: 3;
-  file: string | null;
-  sources: string[];
-  sourcesContent: string[];
-  names: string[];
-  mappings: string;
-}
-
-export interface HighlightAnnotation { offset: number; length: number; className: string }
-
-export type GenerateInput =
-  | { kind: "tokens"; tokens: string[] }
-  | { kind: "code"; code: string; id?: string | undefined | null }
-  | { kind: "all" };
-
-export interface GenerateOptions {
-  id?: string | undefined | null;
-  /** 默认 true */
-  preflights?: boolean | undefined | null;
-  /** 默认 true */
-  safelist?: boolean | undefined | null;
-  /** 默认 false */
-  minify?: boolean | undefined | null;
-  /** 默认 false；为 true 时填充 matchedInfo */
-  extendedInfo?: boolean | undefined | null;
-  scope?: string | undefined | null;
-}
-
-export interface GenerateResult {
-  /** 与 oracle `result.css` 逐字节相同。 */
-  css: string;
-  /** 有序层；oracle `result.layers` 与 `getLayer(name)` 的来源。 */
-  layers: Array<{ name: string; css: string }>;
-  /** oracle `result.matched`（Set）按首次出现顺序。 */
-  matched: string[];
-  /** extendedInfo 时填充。input 为 {kind:"code"} 时 count 是该 token 在抽取结果中的出现次数（oracle CountableSet 语义）；tokens/all 输入时为 -1（oracle 对不可计数输入的语义）。 */
-  matchedInfo: Array<{ token: string; data: StringifiedUtil[]; count: number }> | null;
-  programKey: string;
-}
-
-/** oracle `StringifiedUtil` 元组的对象形式；`context` 字段不跨边界，facade 以 undefined 填充。 */
-export interface StringifiedUtil {
-  index: number;
-  selector: string | null;
-  body: string;
-  parent: string | null;
-  meta: RuleMeta | null;
-  noMerge: boolean | null;
-}
-
-export interface RuleMeta {
-  layer?: string | undefined | null;
-  noMerge?: boolean | undefined | null;
-  noScope?: boolean | undefined | null;
-  sort?: number | undefined | null;
-  prefix?: string | string[] | undefined | null;
-  internal?: boolean | undefined | null;
-}
-
-export interface UnmatchedDiagnostic { token: string; suggestions: string[] }
-
-export interface EntryConfig {
-  presets: string[];
-  rolePalettes: Partial<Record<"primary" | "neutral" | "success" | "warning" | "failure" | "general" | "focused", string[]>> | null;
-  sources: Array<{ glob: string; exclude: boolean }>;
-  custom: Array<{
-    alias: { name: string; family: string } | null;
-    mode: string | null;
-    declarations: Array<{ property: string; value: string }>;
-  }>;
-  shortcuts: Array<{ name: string; expansion: string }>;
-  safelist: string[];
-  hasTeacss: boolean;
-}
-
-export interface EntryDiagnostic { file: string | null; start: number; end: number; message: string }
-
-export interface CustomDiagnostic {
-  property: string;
-  start: number;
-  end: number;
-  reason: "unknown-prefix" | "illegal-color-step" | "removed-theme";
-  message: string;
-}
-
-export interface ResolvedConfigView {
-  presets: Array<{ name: string; enforce: "pre" | "post" | null; layer: string | null }>;
-  layers: Record<string, number>;
-  content: { filesystem: string[] } | null;
-  /** 合并后的 theme（oracle `config.theme`）；嵌套对象原样。 */
-  theme: Record<string, unknown>;
-  shortcuts: Array<[string, string]>;
-  safelist: string[];
-  blocklist: string[];
-  separators: string[];
-  envMode: "dev" | "build";
-  unmatched: "warn" | "error" | "off";
-  shortcutsLayer: string;
-  virtualModulePrefix: string;
-  mergeSelectors: boolean;
-  warn: boolean;
-  details: boolean;
-  outputToCssLayers: boolean | { allLayers: boolean } | false;
-  rulesSize: number;
-  transformers: Array<{ name: string; enforce: "pre" | "post" | "default" }>;
-  extractors: Array<{ name: string }>;
-  standard: { preflight: boolean | "on-demand"; variablePrefix: string; compileClass: boolean } | null;
-  icons: { collections: string[]; mode: "mask" | "bg" | "auto"; layer: string } | null;
-}
-
-// ---- facade (v02.9) ----
-export interface FacadeHost {
-  /** 挂钩注入的 @teacss/core 绑定；缺省时 facade 按需动态 import。 */
-  core?: { version: string; createGenerator: (config?: object, defaults?: object) => Promise<object>; extractorSplit: object; isCountableSet?: (value: unknown) => boolean; isTokenShaped?: (token: string) => boolean; toEscapedSelector?: (raw: string) => string } | undefined;
-  /** 挂钩注入的日志出口；缺省时写 process.stderr。 */
-  report?: (reason: string, path: string, level: "info" | "warn") => void;
-}
-export type FacadeCreateResult = { ok: true; generator: FacadeGenerator } | { ok: false; reason: string; path: string };
-/** 0.8.2 TeacssGenerator 的结构子集；成员语义见 v02.9 §3。实例由 createGenerator 创建。 */
-export declare class FacadeGenerator {
-  private constructor();
-  readonly version: string;
-  readonly events: { events: Record<string, Array<(...args: unknown[]) => unknown>>; on(event: "config", cb: (config: object) => unknown): () => void; emit(event: "config", config: object): void };
-  readonly config: object;
-  readonly cache: Map<string, unknown[] | null>;
-  readonly blocked: Set<string>;
-  readonly parentOrders: Map<string, number>;
-  readonly activatedRules: Set<unknown>;
-  userConfig: object;
-  defaults: object;
-  setConfig(userConfig?: object, defaults?: object): Promise<void>;
-  prepareConfig(userConfig: object, defaults?: object): Promise<{ readonly config: object; readonly defaults: object; readonly generator: FacadeGenerator; readonly userConfig: object; readonly version: number }>;
-  commitConfig(prepared: object): boolean;
-  applyExtractors<T extends Set<string>>(code: string, id?: string, extracted?: T): Promise<T>;
-  makeContext(raw: string, applied: unknown): unknown;
-  parseToken(raw: string, alias?: string): Promise<unknown[] | undefined | null>;
-  getCachedEquivalentTokens(raw: string): string[];
-  generate(input: string | string[] | Set<string>, options?: GenerateOptions & { isInputCurrent?: () => boolean; tokenConcurrency?: number }): Promise<{ readonly css: string; layers: string[]; matched: Set<string> | Map<string, { data: unknown[]; count: number }>; getLayer(name?: string): string; getLayers(includes?: string[], excludes?: string[]): string; setLayer(layer: string, callback: (content: string) => string | Promise<string>): Promise<string>; readonly diagnostics: { unmatched: UnmatchedDiagnostic[] } }>;
-  matchVariants(raw: string, current?: string): Promise<unknown>;
-  constructCustomCSS(context: unknown, body: unknown, overrideSelector?: string): string;
-  parseUtil(input: unknown, context: unknown, internal?: boolean, shortcutPrefix?: unknown): Promise<unknown>;
-  stringifyUtil(parsed?: unknown, context?: unknown): unknown;
-  expandShortcut(input: string, context: unknown, depth?: number): Promise<unknown>;
-  stringifyShortcuts(parent: unknown, context: unknown, expanded: unknown, meta?: unknown, matchedPrefixes?: unknown): Promise<unknown>;
-  isBlocked(raw: string): boolean;
-  getBlocked(raw: string): [string, undefined] | undefined;
-}
-export declare function createGenerator(config?: object, defaults?: object, host?: FacadeHost): Promise<FacadeCreateResult>;
-export type TranslateResult = { ok: true; request: LoadProjectRequest; presets: object[]; transformers: object[] } | { ok: false; reason: string; path: string };
-export declare function translateConfig(config: object, defaults: object): Promise<TranslateResult>;
-export declare function selectEngineRequest(args: { hostCoreVersion?: string; option?: unknown; env?: string; compat?: { core?: string; defaultMode?: "opt-in" | "auto" } }): { engine: "rust" | "ts"; mode: "auto" | "rust" | "ts"; source: "env" | "option" | "default"; invalidEnv?: string; resolvedBy?: "opt-in"; reason?: string; path?: string; detail?: { hostCoreVersion: string; engineVersion: string; range: string } };
-/** SemVer 2.0 precedence, prereleases included (`0.9.0-alpha.1 < 0.9.0`); an invalid version throws TypeError (v02.11 §7.3). */
-export declare function compareSemver(a: string, b: string): -1 | 0 | 1;
-/** Only the `>=A <B` form of `engineCompat.core`; any other range throws TypeError. */
-export declare function satisfiesRange(version: string, range: string): boolean;
-export declare function createCompileClassTransformer(): { name: "@teacss/transformer-compile-class"; enforce: "pre"; transform(s: object, id: string, ctx: object): Promise<{ highlightAnnotations: HighlightAnnotation[] } | undefined>; onModuleRemoved(id: string, ctx: object): void };
-export declare function engineStats(): { rust: number; ts: number; fallbacks: Record<string, number> };
-export declare function reportFallback(reason: string, path: string, host?: FacadeHost, level?: "info" | "warn"): void;
-export declare class TeacssEngineError extends Error { code: string; details: Record<string, unknown> }
-export declare const ENGINE_PACKAGE_VERSION: string;
-export declare const ENGINE_COMPAT: { core: string | undefined; defaultMode: "opt-in" | "auto"; oracle: { teacssTs: string; commit: string } | undefined };
-export declare const ENGINE_INSTANCE: unique symbol;
-export declare const ENGINE_MATERIALIZE: unique symbol;
-export declare const ENGINE_STATS: unique symbol;
-export declare const PRESET_OPTIONS: { readonly standard: unique symbol; readonly icons: unique symbol; readonly official: unique symbol };
-export declare const CONFIG_SOURCE_DECLARATIONS: unique symbol;
-export declare const CONFIG_ENTRY_PROVENANCE: unique symbol;
+export * from "./dist/index.js";

package/index.js

@@ -1,2 +1,2 @@
 export * from "./binding.js";
-export * from "./src/facade/index.mjs";
+export * from "./dist/facade/index.js";