@teacss/engine 0.9.4 → 0.10.2

package/contract.d.ts

@@ -1,4 +1,4 @@
-// Mirror of docs/specs/v02.2-engine-contract.md §3 (spec-revision 13). Do not edit without bumping the spec revision.
+// Mirror of notes/specs/v02.2-engine-contract.md §3 (spec-revision 24). Do not edit without bumping the spec revision.
 export interface InspectEntryRequest {
   /** 项目根（绝对路径）。相对 @source 以声明它的文件所在目录为基准。 */
   root: string;
@@ -32,10 +32,9 @@ export interface LoadProjectRequest {
   inline?: StaticConfig | undefined | null;
   envMode: "dev" | "build";
   unmatched: "warn" | "error" | "off";
-  /** 对应 UserConfig.outputToCssLayers；函数形式由 facade 判定回退。 */
-  outputToCssLayers?: boolean | { allLayers?: boolean } | undefined | null;
+  /** 对应 UserConfig.outputToCssLayers；cssLayerName 只有静态表的形状（v10.2 §2.1）。 */
+  outputToCssLayers?: boolean | OutputToCssLayersOptions | undefined | null;
   shortcutsLayer?: string | undefined | null;
-  virtualModulePrefix?: string | undefined | null;
 }
 
 export interface LoadProjectResult {
@@ -44,10 +43,47 @@ export interface LoadProjectResult {
   changed: boolean;
   /** 声明文件中解析失败的位置（不阻止加载，oracle 行为相同）。 */
   warnings: EntryDiagnostic[];
-  /** @custom 中不属于任何命名空间的属性名（oracle `ResolveEntryResult.unknown`），facade 的 `resolveEntryConfig` 透传。 */
+  /** @custom 中不属于任何命名空间的属性名（oracle `ResolveEntryResult.unknown`），调用方原样透传。 */
   unknownCustom: string[];
 }
 
+/** 修订 18：未知键报 E_INVALID_ARGUMENT（details.path 为 "request"）。 */
+export interface LoadProjectFromRootRequest {
+  /** 项目根（绝对路径）。 */
+  root: string;
+  /** 入口文件（绝对路径）或 null：null 时按 v10.1 §4.1 发现；找不到入口时 entry 为 null、presets 为空。 */
+  entry?: string | undefined | null;
+  /** 入口内容（未保存的编辑器缓冲等），只在 entry 给定时有意义。 */
+  entryCss?: string | undefined | null;
+  /** 与 LoadProjectRequest 相同；presets 不能传，由入口的 @presets 决定。 */
+  inline?: StaticConfig | undefined | null;
+  envMode: "dev" | "build";
+  unmatched: "warn" | "error" | "off";
+  outputToCssLayers?: boolean | OutputToCssLayersOptions | undefined | null;
+  shortcutsLayer?: string | undefined | null;
+  /** 覆盖内置预设的选项（没有入口的项目也能开 Standard）：键是预设名。 */
+  presetOptions?: { standard?: PresetStandardOptions; icons?: PresetIconsOptions } | undefined | null;
+}
+
+export interface LoadProjectFromRootResult extends LoadProjectResult {
+  /** 实际用的入口；null 表示没有入口。 */
+  entryPath: string | null;
+  /** @presets 展开后的 PresetSpec 的名字，顺序即加载顺序。 */
+  presets: string[];
+  /** @source 枚举得到并归一化后的声明文件（architecture §5）。 */
+  declarationFiles: string[];
+  /** 入口、import、声明文件之外，@source 的 glob 匹配到的全部文件（绝对路径，排序），供壳子的 watch 与 extractFilesUnion 用。 */
+  sourceFiles: string[];
+  /** @source 的 glob 起点下列不出内容的目录（绝对路径，排序）：里面的文件不在 sourceFiles 里，壳子像读不了的文件一样警告。 */
+  unreadableDirectories: string[];
+}
+
+export interface OutputToCssLayersOptions {
+  allLayers?: boolean | undefined | null;
+  /** 内部层名 → 输出的 @layer 名；null 表示该层不写 @layer；没列出的层用内部名。 */
+  cssLayerName?: Record<string, string | null> | undefined | null;
+}
+
 export type PresetSpec = { kind: "standard"; options?: PresetStandardOptions | undefined | null } | { kind: "official" } | { kind: "icons"; options?: PresetIconsOptions | undefined | null } | { kind: "static"; preset: StaticPreset };
 
 export interface PresetStandardOptions {
@@ -72,11 +108,14 @@ export interface PresetIconsOptions {
   warn?: boolean | undefined | null;
   layer?: string | undefined | null;
   unit?: string | undefined | null;
-  /** 只允许内置集合名；其他集合由 facade 判定回退。 */
-  collections?: string[] | undefined | null;
+  /** 内置集合名列表（每项视为 true），或对象：内置集合名为 true，自定义集合的值是 Iconify JSON 对象或 .json 文件的绝对路径。 */
+  collections?: string[] | Record<string, true | string | IconifyJson> | undefined | null;
 }
 
-/** 本地/第三方 preset 的可静态表示部分。任何不能表示的字段都由 facade 判定回退，不进入这里。 */
+/** 一个 Iconify JSON 集合（`IconifyJSON`）；字段以 Iconify JSON 规范为准，合同不展开。 */
+export type IconifyJson = Record<string, unknown>;
+
+/** 本地/第三方 preset 的可静态表示部分；不能静态表示的字段没有形状，不进入这里。v10.2 起壳子不传 preset 对象，只有 `loadProject` 的直接调用方用到它。 */
 export interface StaticPreset {
   name: string;
   enforce?: "pre" | "post" | undefined | null;
@@ -95,7 +134,16 @@ export interface StaticConfig {
   blocklist?: string[] | undefined | null;
   layers?: Record<string, number> | undefined | null;
   theme?: Record<string, string> | undefined | null;
-  content?: { filesystem?: string[] | undefined | null } | undefined | null;
+  /** 变体与 token 的分隔符；省略为 [":", "-"]。每项非空、互不为前缀。 */
+  separators?: string[] | undefined | null;
+  content?:
+    | {
+        filesystem?: string[] | undefined | null;
+        /** 内联内容：字符串即代码，id 省略时为 "inline:<序号>"。 */
+        inline?: Array<string | { code: string; id?: string | undefined | null }> | undefined | null;
+      }
+    | undefined
+    | null;
 }
 
 export interface ModuleUpdateResult {
@@ -120,15 +168,15 @@ export interface ExtractFilesUnionResult {
 
 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）。 */
+  /** 从原文到 code 的替换序列，UTF-16 code unit 偏移，按 (start, end) 升序且互不重叠。自己持有字符串的宿主按顺序回放（`replayEdits`，或 MagicString 的 `start === end ? s.appendLeft(start, text) : s.update(start, end, text)`；magic-string 1.x 的 `update` 与 `overwrite` 除 `storeName` 默认值外相同），使宿主生成的 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 为空数组。 */
+  /** transformSource：本次登记的 compile-class 类名（已进该模块的 token 集，v02.9 §6）；transformStylesheet 为空数组。 */
   compiledClasses: string[];
-  /** transformSource：该模块的定义集相对上一次是否变化（facade 据此调用 `ctx.invalidate()`）；transformStylesheet 为 false。 */
+  /** transformSource：该模块的定义集相对上一次是否变化（壳子据此失效生成的样式表）；transformStylesheet 为 false。 */
   definitionsChanged: boolean;
 }
 
@@ -160,7 +208,7 @@ export interface GenerateOptions {
   /** 默认 false；为 true 时填充 matchedInfo */
   extendedInfo?: boolean | undefined | null;
   scope?: string | undefined | null;
-  /** 默认 true；false 时不拼、不传整表 css，result.css 为 ""。facade 传 false，它用 layers 重建。 */
+  /** 默认 true；false 时不拼、不传整表 css，result.css 为 ""。自己用 layers 拼样式表的调用方传 false。 */
   css?: boolean | undefined | null;
 }
 
@@ -174,7 +222,7 @@ export interface GenerateResult {
   /** extendedInfo 时填充。input 为 {kind:"code"} 时 count 是该 token 在抽取结果中的出现次数（oracle CountableSet 语义）；tokens/all 输入时为 -1（oracle 对不可计数输入的语义）。 */
   matchedInfo: Array<{ token: string; data: StringifiedUtil[]; count: number }> | null;
   programKey: string;
-  /** 有 shortcut 留下警告时才有这个键，按 token 的访问顺序（输入，再 safelist），每个 token 至多一项。facade 据此打印 oracle `stringifyShortcuts` 的警告（§6.8）。 */
+  /** 有 shortcut 留下警告时才有这个键，按 token 的访问顺序（输入，再 safelist），每个 token 至多一项。调用方据此打印 oracle `stringifyShortcuts` 文本的警告（§6.8）。 */
   shortcutWarnings?: ShortcutWarning[];
 }
 
@@ -185,7 +233,7 @@ export interface GenerateResult {
  */
 export type ShortcutWarning = { shortcut: string; unmatched: string[] } | { shortcut: string; leafLimit: number };
 
-/** oracle `StringifiedUtil` 元组的对象形式；`context` 字段不跨边界，facade 以 undefined 填充。 */
+/** oracle `StringifiedUtil` 元组的对象形式；`context` 字段不跨边界，需要时由调用方以 undefined 填充。 */
 export interface StringifiedUtil {
   index: number;
   selector: string | null;
@@ -251,7 +299,6 @@ export interface ResolvedConfigView {
   envMode: "dev" | "build";
   unmatched: "warn" | "error" | "off";
   shortcutsLayer: string;
-  virtualModulePrefix: string;
   mergeSelectors: boolean;
   warn: boolean;
   details: boolean;
@@ -273,6 +320,8 @@ export interface RuleInfo {
   /** `MatcherKey` 的变体：Property、PropertyPrefix、Keyword；shortcut 按名作 keyword。 */
   matcher: { kind: "property" | "prefix" | "keyword"; value: string };
   source: "standard" | "official" | "icons" | "shortcut";
+  /** `RuleDescriptor` 的补全模板（teacss-ts `parseAutocomplete` 语法，v10.3 §2.1）；一条 teacss-ts 规则拆成多个描述符时只在第一个上，shortcut 与没有模板的规则为空数组。 */
+  autocomplete: string[];
 }
 
 export interface VariantInfo {
@@ -281,6 +330,8 @@ export interface VariantInfo {
   /** 接受它的解析器：pseudo、relational、attribute、language、media、at-rule、container、breakpoint、arbitrary。 */
   kind: string;
   source: RuleInfo["source"];
+  /** 变体的补全模板；teacss-ts 0.9.4 没有声明任何变体模板，今天全为空数组。 */
+  autocomplete: string[];
 }
 
 export interface EngineStats {
@@ -295,3 +346,50 @@ export interface EngineStats {
   /** 上一次 generate 结果：css、各层 css、matched 的字节和；没有时为 0。 */
   memoBytes: number;
 }
+
+/** 修订 21：`Engine.suggest` 的选项；未知键报 E_INVALID_ARGUMENT（details.path 为 "options"）。 */
+export interface SuggestOptions {
+  /** 默认 "prefix"：候选以输入开头（无匹配时两边去掉 `-` 再比）；"fuzzy" 用 nucleo-matcher 对整个输入打分。 */
+  matchType?: "prefix" | "fuzzy" | undefined | null;
+  /** 默认 false；true 只留引擎能编译的候选（`alc:$`、`alc:[]` 这类占位候选不出现）。 */
+  strict?: boolean | undefined | null;
+  /** 截断条数，默认 1000（LSP 设置 `autocomplete.maxItems` 的默认值）；0 返回空；负数或非整数报 E_INVALID_ARGUMENT。 */
+  limit?: number | undefined | null;
+}
+
+/** 修订 21：一条补全候选（v10.3 §2.2）。 */
+export interface Suggestion {
+  /** 要插入的完整文本，输入里剥掉的变体（`@hover`、结尾 `!`）已接回。 */
+  text: string;
+  /** utility：规则模板展开、静态规则 token 或输入本身；shortcut：配置的 shortcut 名；variant：补全最后一个 `@` 段的条件名；themeValue：`$theme.path` 模板部分贡献的展开。 */
+  kind: "utility" | "shortcut" | "variant" | "themeValue";
+  /** themeValue 给主题值，variant 给解析器种类，其余 null。 */
+  detail: string | null;
+}
+
+/** 修订 21：sRGB 颜色，各通道 0–1。 */
+export interface Rgba {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+}
+
+/** 修订 21：一个匹配的 token 在编辑器里展示的信息（v10.3 §2.2）。 */
+export interface TokenInfo {
+  /** `generate({kind:"tokens"})` 只对这一个 token 的输出：不出 preflight、不包 `@layer`、不加 scope，每层去掉 `/* layer: … *\/` 注释后以 `\n` 连接。 */
+  css: string;
+  /** 第一个 util 的层（规则没写时为 "utilities"）。 */
+  layer: string;
+  /** 第一个 util 的 parent at-rule 链（如 "@media (min-width: 1024px)"）；没有为 null。 */
+  parent: string | null;
+  /** 声明里解析出的第一个颜色（经 util 的自定义属性与主题取值），没有为 null。 */
+  color: Rgba | null;
+}
+
+/** 修订 21：源码里一个被抽取 token 的 UTF-16 区间与它是否匹配当前 program（v10.3 §2.2）。 */
+export interface MatchedPosition {
+  start: number;
+  end: number;
+  matched: boolean;
+}

package/dist/entry.d.ts

@@ -0,0 +1,20 @@
+import type { SourceMap } from "../contract.js";
+/** `css` with its first top-level `@teacss;` replaced by `generate()` and the entry directives removed; null when it has no `@teacss;`. */
+export declare function replaceEntry(css: string, generate: () => string): string | null;
+export interface EntrySource {
+    /** The id the map names as its source. */
+    id: string;
+    /** The stylesheet as read, before the transform that produced the `css` handed to `replaceEntryWithMap`. */
+    original: string;
+    /** The transform's map from `original` to that `css`; null when the transform left it unchanged. */
+    map: SourceMap | null;
+}
+/**
+ * `replaceEntry` with a source map back to `source.original`: hand-written CSS keeps its original lines and
+ * columns, and every line of the generated CSS maps to the `@teacss;` it replaced.
+ */
+export declare function replaceEntryWithMap(css: string, generate: () => string, source: EntrySource): {
+    code: string;
+    map: SourceMap;
+} | null;
+//# sourceMappingURL=entry.d.ts.map

package/dist/entry.js

@@ -0,0 +1,279 @@
+// Statement-form entry directives the engine consumed from the entry file; the Rust side
+// (`teacss-transform/src/entry_strip.rs`) leaves an entry that carries `@teacss;` to its shell.
+const ENTRY_STATEMENTS = new Set(["presets", "source", "shortcut", "safelist", "primary", "neutral", "success", "warning", "failure", "general"]);
+function skipComment(css, index) {
+    const close = css.indexOf("*/", index + 2);
+    return close < 0 ? css.length : close + 2;
+}
+function skipString(css, index) {
+    const quote = css[index];
+    for (let cursor = index + 1; cursor < css.length;) {
+        if (css[cursor] === "\\")
+            cursor += 2;
+        else if (css[cursor] === quote)
+            return cursor + 1;
+        else
+            cursor++;
+    }
+    return css.length;
+}
+/** The index after the comment, string or backslash escape that starts at `index`, or `index` when none does. */
+function skipOpaque(css, index) {
+    if (css.startsWith("/*", index))
+        return skipComment(css, index);
+    const char = css[index];
+    if (char === '"' || char === "'")
+        return skipString(css, index);
+    if (char === "\\")
+        return Math.min(index + 2, css.length);
+    return index;
+}
+function findClosingBrace(css, open) {
+    let depth = 1;
+    for (let cursor = open + 1; cursor < css.length;) {
+        const skipped = skipOpaque(css, cursor);
+        if (skipped !== cursor) {
+            cursor = skipped;
+            continue;
+        }
+        if (css[cursor] === "{")
+            depth++;
+        else if (css[cursor] === "}" && --depth === 0)
+            return cursor;
+        cursor++;
+    }
+    return null;
+}
+/** The prelude text with each comment read as one space and strings kept as written, trimmed. */
+function cleanPrelude(css, start, end) {
+    let out = "";
+    let segment = start;
+    for (let cursor = start; cursor < end;) {
+        if (css.startsWith("/*", cursor) && cursor + 1 < end) {
+            out += `${css.slice(segment, cursor)} `;
+            cursor = Math.min(skipComment(css, cursor), end);
+            segment = cursor;
+        }
+        else if (css[cursor] === '"' || css[cursor] === "'") {
+            cursor = Math.min(skipString(css, cursor), end);
+        }
+        else
+            cursor++;
+    }
+    return (out + css.slice(segment, end)).trim();
+}
+function atRuleAt(css, start, name) {
+    const nameEnd = start + 1 + name.length;
+    const closers = [];
+    for (let cursor = nameEnd; cursor < css.length;) {
+        const skipped = skipOpaque(css, cursor);
+        if (skipped !== cursor) {
+            cursor = skipped;
+            continue;
+        }
+        const char = css[cursor];
+        if (closers.length === 0 && char === "{") {
+            const close = findClosingBrace(css, cursor);
+            if (close !== null)
+                return { name, prelude: cleanPrelude(css, nameEnd, cursor), start, end: close + 1, block: true };
+        }
+        if (char === "(")
+            closers.push(")");
+        else if (char === "[")
+            closers.push("]");
+        else if (char === "{")
+            closers.push("}");
+        else if (closers.at(-1) === char)
+            closers.pop();
+        if (closers.length === 0 && char === ";")
+            return { name, prelude: cleanPrelude(css, nameEnd, cursor), start, end: cursor + 1, block: false };
+        cursor++;
+    }
+    return { name, prelude: cleanPrelude(css, nameEnd, css.length), start, end: css.length, block: false };
+}
+/**
+ * Top-level at-rules exactly as `teacss-config`'s `scan_top_level_at_rules` finds them: comments, strings and
+ * backslash escapes skipped, nested rules ignored, comments in a prelude read as a space.
+ */
+function topLevelAtRules(css) {
+    const rules = [];
+    let depth = 0;
+    for (let index = 0; index < css.length;) {
+        const skipped = skipOpaque(css, index);
+        if (skipped !== index) {
+            index = skipped;
+            continue;
+        }
+        const char = css[index];
+        if (char === "{")
+            depth++;
+        else if (char === "}")
+            depth = Math.max(0, depth - 1);
+        else if (char === "@" && depth === 0) {
+            const name = /^[\w-]+/.exec(css.slice(index + 1))?.[0];
+            if (name) {
+                const rule = atRuleAt(css, index, name);
+                rules.push(rule);
+                index = rule.end;
+                continue;
+            }
+        }
+        index++;
+    }
+    return rules;
+}
+function entryPieces(css, generate) {
+    const rules = topLevelAtRules(css);
+    const entry = rules.find((rule) => rule.name === "teacss" && !rule.block && rule.prelude === "");
+    if (!entry)
+        return null;
+    const pieces = [];
+    let cursor = 0;
+    for (const rule of rules) {
+        const remove = rule.name === "teacss" || rule.name === "custom" || (ENTRY_STATEMENTS.has(rule.name) && !rule.block);
+        if (!remove)
+            continue;
+        pieces.push({ from: cursor, to: rule.start });
+        if (rule === entry)
+            pieces.push({ generated: generate(), at: rule.start });
+        cursor = rule.end;
+    }
+    pieces.push({ from: cursor, to: css.length });
+    return pieces;
+}
+/** `css` with its first top-level `@teacss;` replaced by `generate()` and the entry directives removed; null when it has no `@teacss;`. */
+export function replaceEntry(css, generate) {
+    const pieces = entryPieces(css, generate);
+    return pieces && pieces.map((piece) => ("generated" in piece ? piece.generated : css.slice(piece.from, piece.to))).join("");
+}
+/**
+ * `replaceEntry` with a source map back to `source.original`: hand-written CSS keeps its original lines and
+ * columns, and every line of the generated CSS maps to the `@teacss;` it replaced.
+ */
+export function replaceEntryWithMap(css, generate, source) {
+    const pieces = entryPieces(css, generate);
+    if (!pieces)
+        return null;
+    const points = source.map ? decodePoints(css, source.map.mappings) : identityPoints(css);
+    const out = [];
+    let code = "";
+    for (const piece of pieces) {
+        if ("generated" in piece) {
+            const original = originalAt(css, points, piece.at);
+            for (const start of lineStarts(piece.generated))
+                out.push({ offset: code.length + start, original });
+            code += piece.generated;
+            continue;
+        }
+        if (piece.from === piece.to)
+            continue;
+        out.push({ offset: code.length, original: originalAt(css, points, piece.from) });
+        for (const point of points) {
+            if (point.offset > piece.from && point.offset < piece.to)
+                out.push({ offset: point.offset - piece.from + code.length, original: point.original });
+        }
+        code += css.slice(piece.from, piece.to);
+    }
+    const map = { version: 3, file: source.map?.file ?? null, sources: [source.id], sourcesContent: [source.original], names: [], mappings: encodePoints(code, out) };
+    return { code, map };
+}
+function lineStarts(text) {
+    const starts = [0];
+    for (let index = text.indexOf("\n"); index >= 0; index = text.indexOf("\n", index + 1))
+        starts.push(index + 1);
+    return starts;
+}
+function identityPoints(css) {
+    return lineStarts(css).map((offset, line) => ({ offset, original: [line, 0] }));
+}
+/** Where `offset` came from: the last point at or before it on the same line, moved by the columns between them. */
+function originalAt(css, points, offset) {
+    let last;
+    for (const point of points) {
+        if (point.offset > offset)
+            break;
+        last = point;
+    }
+    if (!last?.original || css.slice(last.offset, offset).includes("\n"))
+        return null;
+    return [last.original[0], last.original[1] + offset - last.offset];
+}
+const BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function decodeVlq(segment) {
+    const values = [];
+    let value = 0;
+    let shift = 0;
+    for (const char of segment) {
+        const digit = BASE64.indexOf(char);
+        value += (digit & 31) << shift;
+        if (digit & 32)
+            shift += 5;
+        else {
+            values.push(value & 1 ? -(value >>> 1) : value >>> 1);
+            value = 0;
+            shift = 0;
+        }
+    }
+    return values;
+}
+function encodeVlq(value) {
+    let rest = value < 0 ? (-value << 1) | 1 : value << 1;
+    let out = "";
+    do {
+        const digit = rest & 31;
+        rest >>>= 5;
+        out += BASE64[rest > 0 ? digit | 32 : digit];
+    } while (rest > 0);
+    return out;
+}
+/** The points of a single-source map's `mappings` over `generated`, in order. */
+function decodePoints(generated, mappings) {
+    const starts = lineStarts(generated);
+    const points = [];
+    let line = 0;
+    let column = 0;
+    for (const [index, group] of mappings.split(";").entries()) {
+        let generatedColumn = 0;
+        for (const segment of group.split(",")) {
+            if (segment === "")
+                continue;
+            const [deltaColumn = 0, , deltaLine, deltaOriginalColumn] = decodeVlq(segment);
+            generatedColumn += deltaColumn;
+            let original = null;
+            if (deltaLine !== undefined && deltaOriginalColumn !== undefined) {
+                line += deltaLine;
+                column += deltaOriginalColumn;
+                original = [line, column];
+            }
+            points.push({ offset: (starts[index] ?? generated.length) + generatedColumn, original });
+        }
+    }
+    return points;
+}
+function encodePoints(code, points) {
+    const starts = lineStarts(code);
+    const lines = starts.map(() => []);
+    const kept = points.filter((point, index) => points[index + 1]?.offset !== point.offset);
+    let line = 0;
+    let previousColumn = 0;
+    let previousLine = 0;
+    let previousOriginalColumn = 0;
+    for (const point of kept) {
+        while (line + 1 < starts.length && starts[line + 1] <= point.offset) {
+            line++;
+            previousColumn = 0;
+        }
+        const column = point.offset - starts[line];
+        let segment = encodeVlq(column - previousColumn);
+        previousColumn = column;
+        if (point.original) {
+            const [originalLine, originalColumn] = point.original;
+            segment += encodeVlq(0) + encodeVlq(originalLine - previousLine) + encodeVlq(originalColumn - previousOriginalColumn);
+            previousLine = originalLine;
+            previousOriginalColumn = originalColumn;
+        }
+        lines[line]?.push(segment);
+    }
+    return lines.map((segments) => segments.join(",")).join(";");
+}
+//# sourceMappingURL=entry.js.map

package/dist/errors.d.ts

@@ -1,13 +1,7 @@
-/** Errors the facade raises itself; an `Error` from napi (code `E_*`) passes through unwrapped. */
+/** Errors the TypeScript side raises itself; an `Error` from napi (code `E_*`) passes through unwrapped. */
 export declare class TeacssEngineError extends Error {
     code: string;
     details: Record<string, unknown>;
     constructor(code: string, message: string, details?: Record<string, unknown>);
 }
-/** v02.9 §2.1: the member needs `@teacss/core`, which is not installed. */
-export declare function tsRequiredError(member: string): TeacssEngineError;
-/** The generator was disposed; the native Engine reports the same code after its own `dispose()`. */
-export declare function disposedError(member: string): TeacssEngineError;
-/** v02.9 §3.3: the member needs the TypeScript engine, which has not been materialized. */
-export declare function tsNotReadyError(member: string): TeacssEngineError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.js

@@ -1,4 +1,4 @@
-/** Errors the facade raises itself; an `Error` from napi (code `E_*`) passes through unwrapped. */
+/** Errors the TypeScript side raises itself; an `Error` from napi (code `E_*`) passes through unwrapped. */
 export class TeacssEngineError extends Error {
     constructor(code, message, details = {}) {
         super(message);
@@ -7,16 +7,4 @@ export class TeacssEngineError extends Error {
         this.details = details;
     }
 }
-/** v02.9 §2.1: the member needs `@teacss/core`, which is not installed. */
-export function tsRequiredError(member) {
-    return new TeacssEngineError("E_TS_REQUIRED", `[@teacss/engine] ${member} requires @teacss/core (optional peer) to be installed`, { member });
-}
-/** The generator was disposed; the native Engine reports the same code after its own `dispose()`. */
-export function disposedError(member) {
-    return new TeacssEngineError("E_DISPOSED", `[@teacss/engine] ${member} called after dispose()`);
-}
-/** v02.9 §3.3: the member needs the TypeScript engine, which has not been materialized. */
-export function tsNotReadyError(member) {
-    return new TeacssEngineError("E_TS_REQUIRED", `[@teacss/engine] ${member} needs the TypeScript engine; await generator[Symbol.for('@teacss/engine/materialize')]() first or set engine: 'ts'`, { member });
-}
 //# sourceMappingURL=errors.js.map

package/dist/fonts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The Standard preset's preflight inlines its fonts as data URLs branded with the sha256 of the bytes
+ * (`crates/teacss-standard/src/preflight_fonts.rs`); only TeaCSS writes this URL. Groups: quote, digest, base64.
+ */
+export declare const BUNDLED_FONT_URL: RegExp;
+export interface BundledFont {
+    digest: string;
+    bytes: Uint8Array;
+    /** What `pathFor` returned for the digest: the URL every `url()` of this font now carries. */
+    path: string;
+}
+/**
+ * Moves every bundled font out of `css`: each distinct digest is decoded once, checked against its bytes
+ * (a mismatch is `E_INVALID_ARGUMENT`) and handed to `pathFor`, whose result replaces the data URL.
+ * CSS without a bundled font comes back as the same string with no fonts.
+ */
+export declare function extractBundledFonts(css: string, pathFor: (digest: string, bytes: Uint8Array) => string): {
+    css: string;
+    fonts: BundledFont[];
+};
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.js

@@ -0,0 +1,32 @@
+import { createHash } from "node:crypto";
+import { TeacssEngineError } from "./errors.js";
+/**
+ * The Standard preset's preflight inlines its fonts as data URLs branded with the sha256 of the bytes
+ * (`crates/teacss-standard/src/preflight_fonts.rs`); only TeaCSS writes this URL. Groups: quote, digest, base64.
+ */
+export const BUNDLED_FONT_URL = /url\(\s*(["']?)data:font\/woff2;teacss=v1-([a-f0-9]{64});base64,([A-Za-z0-9+/]*={0,2})\1\s*\)/g;
+/**
+ * Moves every bundled font out of `css`: each distinct digest is decoded once, checked against its bytes
+ * (a mismatch is `E_INVALID_ARGUMENT`) and handed to `pathFor`, whose result replaces the data URL.
+ * CSS without a bundled font comes back as the same string with no fonts.
+ */
+export function extractBundledFonts(css, pathFor) {
+    if (!css.includes(";teacss=v1-"))
+        return { css, fonts: [] };
+    const fonts = new Map();
+    const out = css.replace(BUNDLED_FONT_URL, (_, _quote, digest, base64) => {
+        let font = fonts.get(digest);
+        if (font === undefined) {
+            const bytes = Buffer.from(base64, "base64");
+            const actual = createHash("sha256").update(bytes).digest("hex");
+            if (actual !== digest) {
+                throw new TeacssEngineError("E_INVALID_ARGUMENT", `[@teacss/engine] bundled font ${digest} does not match its bytes (sha256 ${actual})`, { path: `teacss=v1-${digest}`, expected: digest, actual });
+            }
+            font = { digest, bytes, path: pathFor(digest, bytes) };
+            fonts.set(digest, font);
+        }
+        return `url(${JSON.stringify(font.path)})`;
+    });
+    return { css: out, fonts: [...fonts.values()] };
+}
+//# sourceMappingURL=fonts.js.map

package/dist/index.d.ts

@@ -1,8 +1,7 @@
 export * from "../binding.js";
 export type * from "../contract.js";
-export { CONFIG_ENTRY_PROVENANCE, CONFIG_SOURCE_DECLARATIONS, ENGINE_COMPAT, ENGINE_INSTANCE, ENGINE_MATERIALIZE, ENGINE_PACKAGE_VERSION, ENGINE_STATS, PRESET_OPTIONS, } from "./constants.js";
+export { type EntrySource, replaceEntry, replaceEntryWithMap } from "./entry.js";
 export { TeacssEngineError } from "./errors.js";
-export { createGenerator, engineStats, type FacadeCreateResult, FacadeGenerator, type FacadeHost, reportFallback } from "./generator.js";
-export { selectEngineRequest, type TranslateResult, translateConfig } from "./select.js";
-export { createCompileClassTransformer } from "./transformer.js";
+export { BUNDLED_FONT_URL, type BundledFont, extractBundledFonts } from "./fonts.js";
+export { CSS_PLACEHOLDER, createProject, type Edit, isCssId, type Project, replayEdits, type ShellOptions, type SourceDirectory, type UnmatchedReport } from "./project.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,10 +1,7 @@
-// Facade modules import `Engine`, `expandClassGroups`, `splitClassTokens` and `version` from
-// `../binding.js`, never from `index.js`, which re-exports them (a cycle otherwise).
-// This file imports no peer (`@teacss/core`, `@teacss/config`).
+// The package has no runtime dependency beyond the binding.
 export * from "../binding.js";
-export { CONFIG_ENTRY_PROVENANCE, CONFIG_SOURCE_DECLARATIONS, ENGINE_COMPAT, ENGINE_INSTANCE, ENGINE_MATERIALIZE, ENGINE_PACKAGE_VERSION, ENGINE_STATS, PRESET_OPTIONS, } from "./constants.js";
+export { replaceEntry, replaceEntryWithMap } from "./entry.js";
 export { TeacssEngineError } from "./errors.js";
-export { createGenerator, engineStats, FacadeGenerator, reportFallback } from "./generator.js";
-export { selectEngineRequest, translateConfig } from "./select.js";
-export { createCompileClassTransformer } from "./transformer.js";
+export { BUNDLED_FONT_URL, extractBundledFonts } from "./fonts.js";
+export { CSS_PLACEHOLDER, createProject, isCssId, replayEdits } from "./project.js";
 //# sourceMappingURL=index.js.map