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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teacss/engine",
-  "version": "0.8.5-alpha.4",
+  "version": "0.9.0-alpha.3",
   "description": "In-process Rust engine for TeaCSS 0.9 (napi-rs binding and 0.8.x-compatible facade)",
   "license": "MIT",
   "type": "module",
@@ -22,22 +22,27 @@
       "default": "./binding.js"
     },
     "./facade": {
-      "types": "./index.d.ts",
-      "default": "./src/facade/index.mjs"
+      "types": "./dist/facade/index.d.ts",
+      "default": "./dist/facade/index.js"
     },
     "./select": {
-      "types": "./index.d.ts",
-      "default": "./src/facade/select.mjs"
+      "types": "./dist/facade/select.d.ts",
+      "default": "./dist/facade/select.js"
     },
     "./package.json": "./package.json"
   },
+  "imports": {
+    "#facade/*": "./dist/facade/*"
+  },
   "files": [
     "index.js",
     "index.d.ts",
+    "contract.d.ts",
     "binding.js",
     "binding.d.ts",
-    "src/**/*.mjs",
-    "src/**/*.d.ts",
+    "binding-header.d.ts",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
     "README.md"
   ],
   "sideEffects": false,
@@ -47,6 +52,7 @@
   "napi": {
     "binaryName": "teacss-engine",
     "packageName": "@teacss/engine",
+    "dtsHeaderFile": "binding-header.d.ts",
     "targets": [
       "aarch64-apple-darwin",
       "x86_64-apple-darwin",
@@ -68,18 +74,18 @@
     }
   },
   "optionalDependencies": {
-    "@teacss/engine-darwin-arm64": "0.8.5-alpha.4",
-    "@teacss/engine-darwin-x64": "0.8.5-alpha.4",
-    "@teacss/engine-linux-x64-gnu": "0.8.5-alpha.4",
-    "@teacss/engine-linux-x64-musl": "0.8.5-alpha.4",
-    "@teacss/engine-linux-arm64-gnu": "0.8.5-alpha.4",
-    "@teacss/engine-linux-arm64-musl": "0.8.5-alpha.4",
-    "@teacss/engine-win32-x64-msvc": "0.8.5-alpha.4",
-    "@teacss/engine-win32-arm64-msvc": "0.8.5-alpha.4"
+    "@teacss/engine-darwin-arm64": "0.9.0-alpha.3",
+    "@teacss/engine-darwin-x64": "0.9.0-alpha.3",
+    "@teacss/engine-linux-arm64-gnu": "0.9.0-alpha.3",
+    "@teacss/engine-linux-arm64-musl": "0.9.0-alpha.3",
+    "@teacss/engine-linux-x64-gnu": "0.9.0-alpha.3",
+    "@teacss/engine-linux-x64-musl": "0.9.0-alpha.3",
+    "@teacss/engine-win32-arm64-msvc": "0.9.0-alpha.3",
+    "@teacss/engine-win32-x64-msvc": "0.9.0-alpha.3"
   },
   "peerDependencies": {
-    "@teacss/core": ">=0.8.5 <0.10.0",
-    "@teacss/config": ">=0.8.5 <0.10.0"
+    "@teacss/config": ">=0.8.5 <0.10.0 || >=0.9.0-alpha.0 <0.10.0",
+    "@teacss/core": ">=0.8.5 <0.10.0 || >=0.9.0-alpha.0 <0.10.0"
   },
   "peerDependenciesMeta": {
     "@teacss/core": {
@@ -91,6 +97,7 @@
   },
   "devDependencies": {
     "@napi-rs/cli": "3.10.8",
+    "@types/node": "^22.20.5",
     "emnapi": "1.11.3",
     "magic-string": "^0.30.17",
     "typescript": "^5.9.3"
@@ -101,12 +108,24 @@
     "build:debug": "napi build --platform --esm --js binding.js --dts binding.d.ts --output-dir . --manifest-path ../../crates/teacss-napi/Cargo.toml -- --locked",
     "artifacts": "napi artifacts --output-dir ../../artifacts --npm-dir npm",
     "create-npm-dirs": "napi create-npm-dirs",
-    "prepublishOnly": "node scripts/check-publish.mjs",
-    "test": "npm run check:dts && node --expose-gc --test \"test/**/*.test.mjs\"",
-    "check:dts": "node scripts/check-dts.mjs",
-    "check:version": "node scripts/sync-version.mjs --check",
-    "check:size": "node scripts/size-budget.mjs",
-    "version": "napi version && node scripts/sync-version.mjs --write && git add npm/*/package.json ../../Cargo.toml ../../Cargo.lock"
+    "prepublishOnly": "npm run build:ts && node build/scripts/check-publish.js",
+    "test": "npm run build:ts && npm run check:types && node --expose-gc --test \"build/test/**/*.test.js\"",
+    "check:version": "npm run build:ts && node build/scripts/sync-version.js --check",
+    "check:size": "node build/scripts/size-budget.js",
+    "version": "napi version && npm run build:ts && node build/scripts/sync-version.js --write && git add npm/*/package.json ../../Cargo.toml ../../Cargo.lock",
+    "build:ts": "tsc -p tsconfig.json && tsc -p tsconfig.test.json",
+    "check:types": "tsc -p test/consumer/tsconfig.json --noEmit",
+    "check:publish": "node build/scripts/check-publish.js",
+    "check:tag": "node build/scripts/check-tag.js",
+    "inspect-binding": "node build/scripts/inspect-binding.js",
+    "collect-artifacts": "node build/scripts/collect-artifacts.js",
+    "release:bundle": "node build/scripts/release-bundle.js",
+    "release:notes": "node build/scripts/release-notes.js",
+    "release:evidence": "node build/scripts/release-evidence.js",
+    "publish:npm": "node build/scripts/publish.js",
+    "dist-tag": "node build/scripts/dist-tag.js",
+    "qualify": "node build/scripts/qualify.js",
+    "setup-wasi-sdk": "node build/scripts/setup-wasi-sdk.js"
   },
   "publishConfig": {
     "access": "public",

package/src/facade/config-view.mjs

@@ -1,82 +0,0 @@
-// @ts-check
-// The facade's `generator.config`: a plain object whose keys follow the oracle `resolveConfig`
-// (core/config.ts:260-288), which spreads the merged config and then sets its own fields.
-
-import { tsNotReadyError } from "./errors.mjs";
-
-/** Fields the TypeScript generator provides; reading one before materialize throws `E_TS_REQUIRED`. */
-export const TS_ONLY_FIELDS = Object.freeze(["configResolved", "extendTheme", "preprocess", "postprocess", "preflights", "autocomplete", "rules", "rulesDynamic", "rulesStaticMap", "variants"]);
-/** Fields copied from the Rust `ResolvedConfigView`. */
-export const VIEW_FIELDS = Object.freeze(["layers", "theme", "shortcuts", "safelist", "blocklist", "separators", "envMode", "unmatched", "shortcutsLayer", "virtualModulePrefix", "mergeSelectors", "warn", "details", "outputToCssLayers", "rulesSize"]);
-
-/**
- * The keys `resolveConfig` always sets, in its order (config.ts:262-288); `configResolved`,
- * `extendTheme`, `extractorDefault` and `virtualModulePrefix` appear only through the spread.
- */
-const RESOLVED_KEYS = Object.freeze([
-  "mergeSelectors", "warn", "unmatched", "outputToCssLayers", "sortLayers", "blocklist", "presets", "envMode", "shortcutsLayer", "layers", "theme", "rules", "rulesSize",
-  "rulesDynamic", "rulesStaticMap", "preprocess", "postprocess", "preflights", "autocomplete", "variants", "shortcuts", "extractors", "safelist", "separators", "details",
-  "content", "transformers",
-]);
-
-/**
- * @param {{ view: Record<string, any>, request: object, presets: object[], userConfig: Record<string, unknown>, transformers: object[], host: { core?: { extractorSplit: object } | undefined }, fallback: { peek(): { config: Record<string, unknown> } | null }, engine?: { compileClassShortcuts(): unknown[] } }} args
- *   `userConfig` is the merged config (`mergeDefinedConfig(defaults, userConfig)`) the oracle spreads.
- * @returns {Record<string, unknown>}
- */
-export function createConfigView({ view, presets, userConfig, transformers, host, fallback, engine }) {
-  /** @type {Record<string, unknown>} */
-  const config = {};
-  /** @param {string} key @param {unknown} value */
-  const data = (key, value) => Object.defineProperty(config, key, { value, enumerable: true, configurable: true, writable: true });
-  /** @param {string} key */
-  const tsOnly = (key) =>
-    Object.defineProperty(config, key, {
-      enumerable: true,
-      configurable: true,
-      get() {
-        const ts = fallback.peek();
-        if (!ts) throw tsNotReadyError(`config.${key}`);
-        return ts.config[key];
-      },
-    });
-
-  const extractors = host.core ? [host.core.extractorSplit] : [{ name: view.extractors?.[0]?.name ?? "@teacss/core/extractor-split" }];
-  /** @type {Record<string, () => void>} */
-  const fields = {
-    presets: () => data("presets", presets),
-    content: () => data("content", view.content ?? {}),
-    transformers: () => data("transformers", transformers),
-    extractors: () => data("extractors", extractors),
-    extractorDefault: () => data("extractorDefault", extractors[0]),
-    sortLayers: () => data("sortLayers", (/** @type {string[]} */ layers) => layers),
-  };
-  for (const key of VIEW_FIELDS) fields[key] = () => data(key, view[key]);
-  if (engine) {
-    // compile-class.ts:84-106 pushes each definition onto `config.shortcuts` and splices it out
-    // when its last module drops it; the definitions live in the Engine, so one array is kept in
-    // step on every read.
-    const shortcuts = [...(view.shortcuts ?? [])];
-    const configured = shortcuts.length;
-    fields.shortcuts = () =>
-      Object.defineProperty(config, "shortcuts", {
-        enumerable: true,
-        configurable: true,
-        get() {
-          shortcuts.length = configured;
-          shortcuts.push(...engine.compileClassShortcuts());
-          return shortcuts;
-        },
-      });
-  }
-  for (const key of TS_ONLY_FIELDS) fields[key] = () => tsOnly(key);
-
-  for (const key of Object.keys(userConfig ?? {})) {
-    if (key === "engine") continue;
-    if (Object.hasOwn(fields, key)) fields[key]();
-    else data(key, userConfig[key]);
-  }
-  // Redefining a spread key keeps its position, as the object literal does.
-  for (const key of RESOLVED_KEYS) fields[key]();
-  return config;
-}

package/src/facade/countable-set.mjs

@@ -1,179 +0,0 @@
-// @ts-check
-// Token collections the facade shares with `@teacss/core`: CountableSet (core/utils/countable-set.ts),
-// expandInputGroups (core/generator.ts:517-535) and the FIFO caches of core/bounded-cache.ts.
-
-import { expandClassGroups, splitClassTokens } from "../../binding.js";
-
-export const MAX_RUNTIME_CACHE_ENTRIES = 10_000;
-
-/** @template K @extends {Set<K>} */
-export class CountableSet extends Set {
-  /** @type {Map<K, number>} */
-  _map = new Map();
-
-  /** @param {Iterable<K>} [values] */
-  constructor(values) {
-    super();
-    if (values) for (const key of values) this.add(key);
-  }
-
-  /** @param {K} key */
-  add(key) {
-    this._map.set(key, (this._map.get(key) ?? 0) + 1);
-    return super.add(key);
-  }
-
-  /** @param {K} key */
-  delete(key) {
-    if (!this._map.has(key)) return false;
-    this._map.delete(key);
-    return super.delete(key);
-  }
-
-  clear() {
-    this._map.clear();
-    super.clear();
-  }
-
-  /** @param {K} key */
-  getCount(key) {
-    return this._map.get(key) ?? 0;
-  }
-
-  /** @param {K} key @param {number} count */
-  setCount(key, count) {
-    this._map.set(key, count);
-    return super.add(key);
-  }
-}
-
-/** @param {unknown} value @returns {value is CountableSet<string>} */
-export function isCountableSet(value) {
-  return value instanceof CountableSet;
-}
-
-/** @template K @param {CountableSet<K>} input */
-export function copyCountableSet(input) {
-  const copied = new CountableSet();
-  for (const key of input) copied.setCount(key, input.getCount(key));
-  return copied;
-}
-
-/**
- * Expands the tokens holding a `{…}` group in place; the parts go to the end, and a counted
- * group's count carries over to each part.
- * @template {Set<string>} T @param {T} tokens @returns {T}
- */
-export function expandInputGroups(tokens) {
-  const expanded = [...tokens].filter((token) => token.includes("{"));
-  if (expanded.length === 0) return tokens;
-  for (const token of expanded) {
-    const parts = splitClassTokens(expandClassGroups(token));
-    if (parts.length === 1 && parts[0] === token) continue;
-    const count = isCountableSet(tokens) ? tokens.getCount(token) : 1;
-    tokens.delete(token);
-    for (const part of parts) {
-      if (isCountableSet(tokens)) tokens.setCount(part, tokens.getCount(part) + count);
-      else tokens.add(part);
-    }
-  }
-  return tokens;
-}
-
-/**
- * The part of the oracle `BoundedMap` the facade uses: ordinary keys are evicted oldest first,
- * retained keys never count toward the limit.
- * @template V @extends {Map<string, V>}
- */
-export class BoundedTokenCache extends Map {
-  /** @param {number} [maxEntries] */
-  constructor(maxEntries = MAX_RUNTIME_CACHE_ENTRIES) {
-    super();
-    this.maxEntries = maxEntries;
-    /** @type {Set<string>} */
-    this.retained = new Set();
-    /** Ordinary keys in insertion order, the order the native map iterates them. @type {Set<string>} */
-    this.order = new Set();
-  }
-
-  get retainedSize() {
-    return this.retained.size;
-  }
-
-  /** @param {string} key */
-  isRetained(key) {
-    return this.retained.has(key);
-  }
-
-  /** @param {string} key @param {V} value */
-  set(key, value) {
-    const exists = super.has(key);
-    super.set(key, value);
-    if (!exists && !this.retained.has(key)) this.order.add(key);
-    this.#enforceLimit();
-    return this;
-  }
-
-  /** @param {string} key */
-  delete(key) {
-    const deleted = super.delete(key);
-    this.order.delete(key);
-    this.retained.delete(key);
-    return deleted;
-  }
-
-  clear() {
-    super.clear();
-    this.order.clear();
-    this.retained.clear();
-  }
-
-  /**
-   * Replaces the retained entries (bounded-cache.ts:188-205 without the revision check).
-   * @param {Iterable<readonly [string, V]>} entries
-   */
-  replaceRetained(entries) {
-    const next = new Map(entries);
-    for (const key of this.retained) {
-      if (next.has(key)) continue;
-      super.delete(key);
-      this.retained.delete(key);
-    }
-    for (const [key, value] of next) {
-      this.order.delete(key);
-      super.set(key, value);
-      this.retained.add(key);
-    }
-    this.#enforceLimit();
-  }
-
-  #enforceLimit() {
-    while (this.size - this.retained.size > this.maxEntries) {
-      const oldest = this.order.values().next();
-      if (oldest.done) break;
-      this.order.delete(oldest.value);
-      super.delete(oldest.value);
-    }
-  }
-}
-
-/** FIFO bounded Set (the oracle `BoundedSet` without its `assumeNoPrototypeBypass` fast path). @extends {Set<string>} */
-export class BoundedSet extends Set {
-  /** @param {number} [maxEntries] @param {Iterable<string>} [values] */
-  constructor(maxEntries = MAX_RUNTIME_CACHE_ENTRIES, values) {
-    super();
-    this.maxEntries = maxEntries;
-    if (values) for (const value of values) this.add(value);
-  }
-
-  /** @param {string} value */
-  add(value) {
-    super.add(value);
-    while (this.size > this.maxEntries) {
-      const oldest = this.values().next();
-      if (oldest.done) break;
-      super.delete(oldest.value);
-    }
-    return this;
-  }
-}

package/src/facade/errors.mjs

@@ -1,22 +0,0 @@
-// @ts-check
-
-/** Errors the facade raises itself; an `Error` from napi (code `E_*`) passes through unwrapped. */
-export class TeacssEngineError extends Error {
-  /** @param {string} code @param {string} message @param {Record<string, unknown>} [details] */
-  constructor(code, message, details = {}) {
-    super(message);
-    this.name = "TeacssEngineError";
-    this.code = code;
-    this.details = details;
-  }
-}
-
-/** v02.9 §2.1: the member needs `@teacss/core`, which is not installed. @param {string} member */
-export function tsRequiredError(member) {
-  return new TeacssEngineError("E_TS_REQUIRED", `[@teacss/engine] ${member} requires @teacss/core (optional peer) to be installed`, { member });
-}
-
-/** v02.9 §3.3: the member needs the TypeScript engine, which has not been materialized. @param {string} member */
-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 });
-}