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

package/src/facade/index.mjs

@@ -1,19 +0,0 @@
-// @ts-check
-// Facade modules import `Engine`, `expandClassGroups`, `splitClassTokens` and `version` from
-// `../../binding.js`, never from `index.js`, which re-exports this file (a cycle otherwise).
-// This file imports no peer (`@teacss/core`, `@teacss/config`).
-export {
-  CONFIG_ENTRY_PROVENANCE,
-  CONFIG_SOURCE_DECLARATIONS,
-  ENGINE_COMPAT,
-  ENGINE_INSTANCE,
-  ENGINE_MATERIALIZE,
-  ENGINE_PACKAGE_VERSION,
-  ENGINE_STATS,
-  PRESET_OPTIONS,
-} from "./constants.mjs";
-export { translateConfig } from "./select.mjs";
-export { TeacssEngineError } from "./errors.mjs";
-export { selectEngineRequest } from "./select.mjs";
-export { createGenerator, FacadeGenerator, engineStats, reportFallback } from "./generator.mjs";
-export { createCompileClassTransformer } from "./transformer.mjs";

package/src/facade/result.mjs

@@ -1,157 +0,0 @@
-// @ts-check
-// The facade's `generate` result, shaped like the 0.8.2 `GenerateResult` (core/generator.ts:1540-1575).
-
-/** @typedef {{ index: number, selector: string | null, body: string, parent: string | null, meta: Record<string, unknown> | null, noMerge: boolean | null }} RustUtil */
-/** @typedef {{ css: string, layers: Array<{ name: string, css: string }>, matched: string[], matchedInfo: Array<{ token: string, data: RustUtil[], count: number }> | null, programKey: string }} RustGenerateResult */
-
-/** @param {string[]} items */
-export function uniq(items) {
-  return [...new Set(items)];
-}
-
-/**
- * By `configuredLayers[name] ?? 0`, ties by UTF-16 code units (generator.ts:1310-1312).
- * @param {string[]} names @param {Record<string, number>} configuredLayers
- */
-export function sortLayerNames(names, configuredLayers) {
-  /** @param {string} layer */
-  const order = (layer) => (Object.hasOwn(configuredLayers, layer) ? (configuredLayers[layer] ?? 0) : 0);
-  return [...names].sort((a, b) => order(a) - order(b) || (a < b ? -1 : a > b ? 1 : 0));
-}
-
-/**
- * A v02.2 `StringifiedUtil` as the oracle 7-tuple; `null` meta values are dropped and the
- * context slot is always `undefined`.
- * @param {RustUtil} util
- */
-export function toTuple(util) {
-  /** @type {Record<string, unknown> | undefined} */
-  let meta;
-  if (util.meta) {
-    meta = {};
-    for (const [key, value] of Object.entries(util.meta)) if (value !== null && value !== undefined) meta[key] = value;
-  }
-  return [util.index, util.selector ?? undefined, util.body, util.parent ?? undefined, meta, undefined, util.noMerge ?? undefined];
-}
-
-/** @param {{ rust: RustGenerateResult, extendedInfo: boolean, countOf?: (token: string, rustCount: number) => number }} args */
-export function buildMatched({ rust, extendedInfo, countOf }) {
-  if (!extendedInfo) return new Set(rust.matched);
-  return new Map((rust.matchedInfo ?? []).map(({ token, data, count }) => [token, { data: data.map(toTuple), count: countOf ? countOf(token, count) : count }]));
-}
-
-/** @param {{ token: string, suggestions: string[] }} diagnostic */
-export function describeUnmatched({ token, suggestions }) {
-  return suggestions.length ? `"${token}" (did you mean ${suggestions.map((s) => `"${s}"`).join(", ")}?)` : `"${token}"`;
-}
-
-/** The `unmatched: "error"` message (generator.ts:2574). @param {Array<{ token: string, suggestions: string[] }>} diagnosed */
-export function formatUnmatchedError(diagnosed) {
-  return `[@teacss/core] ${diagnosed.length} token${diagnosed.length === 1 ? "" : "s"} matched no rule: ${diagnosed.map(describeUnmatched).join("; ")}`;
-}
-
-const TOKEN_PREFIX_RE = /^[a-z][a-z0-9-]*$/;
-const NON_TOKEN_SCHEMES = new Set(["about", "blob", "bun", "chrome", "data", "deno", "file", "ftp", "http", "https", "jsr", "mailto", "node", "npm", "tel", "urn", "vscode", "virtual", "ws", "wss"]);
-
-/**
- * `tokenConditionBase` (unmatched-diagnostics.ts:49): the token before its first depth-0 `@`, the
- * `!` kept. As in `parseClassToken` (token.ts:54), only `()` and `[]` nest, and quotes, escapes
- * and comments count inside them; an unclosed comment ends the scan.
- * @param {string} raw
- */
-function tokenConditionBase(raw) {
-  let closers = "";
-  /** @type {string | undefined} */
-  let quote;
-  for (let index = 0; index < raw.length; index++) {
-    const character = raw[index];
-    if (quote) {
-      if (character === "\\") index++;
-      else if (character === quote) quote = undefined;
-      continue;
-    }
-    if (closers.length > 0) {
-      if (character === "\\") {
-        index++;
-        continue;
-      }
-      if (character === '"' || character === "'") {
-        quote = character;
-        continue;
-      }
-      if (character === "/" && raw[index + 1] === "*") {
-        const close = raw.indexOf("*/", index + 2);
-        if (close < 0) break;
-        index = close + 1;
-        continue;
-      }
-    }
-    if (character === "(" || character === "[") closers += character === "(" ? ")" : "]";
-    else if (character === closers.at(-1)) closers = closers.slice(0, -1);
-    else if (closers.length === 0 && character === "@") return raw.slice(0, index);
-  }
-  return raw;
-}
-
-/**
- * `isTokenShaped` (unmatched-diagnostics.ts:59-70), for when no `@teacss/core` host is present.
- * @param {string} token
- */
-export function fallbackIsTokenShaped(token) {
-  const base = tokenConditionBase(token);
-  if (!base || base.startsWith("$") || base.startsWith("[")) return false;
-  const separator = base.indexOf(":");
-  if (separator <= 0 || separator === base.length - 1) return false;
-  const prefix = base.slice(0, separator);
-  if (!TOKEN_PREFIX_RE.test(prefix)) return false;
-  if (base.startsWith("//", separator + 1)) return false;
-  return !NON_TOKEN_SCHEMES.has(prefix);
-}
-
-/**
- * @param {{ rust: RustGenerateResult, matched: Set<string> | Map<string, unknown>, minify: boolean, outputToCssLayers: boolean | { allLayers?: boolean } | null | undefined, configuredLayers: Record<string, number>, resolveUnmatched: () => Array<{ token: string, suggestions: string[] }> }} args
- */
-export function createFacadeResult({ rust, matched, minify, outputToCssLayers, configuredLayers, resolveUnmatched }) {
-  const nl = minify ? "" : "\n";
-  const orderedLayers = rust.layers.map((layer) => layer.name);
-  /** @type {Record<string, string>} */
-  const layerCache = Object.create(null);
-  for (const layer of rust.layers) layerCache[layer.name] = layer.css;
-  const allCssLayers = typeof outputToCssLayers === "object" && outputToCssLayers !== null && outputToCssLayers.allLayers ? sortLayerNames(uniq([...Object.keys(configuredLayers), ...orderedLayers]), configuredLayers) : undefined;
-
-  const getLayer = (layer = "utilities") => (Object.hasOwn(layerCache, layer) ? layerCache[layer] : "");
-  /** @param {string[]} [includes] @param {string[]} [excludes] */
-  const getLayers = (includes = orderedLayers, excludes) => {
-    const excluded = new Set(excludes ?? []);
-    const selected = [...includes].filter((layer) => !excluded.has(layer));
-    const css = selected.map((layer) => getLayer(layer)).filter(Boolean);
-    if (outputToCssLayers) {
-      const names = uniq(allCssLayers ?? selected);
-      if (names.length > 0) css.unshift(`@layer ${names.join(", ")};`);
-    }
-    return css.join(nl);
-  };
-  /** @param {string} layer @param {(content: string) => string | Promise<string>} callback */
-  const setLayer = async (layer, callback) => {
-    const content = await callback(getLayer(layer));
-    layerCache[layer] = content;
-    return content;
-  };
-
-  /** @type {{ unmatched: Array<{ token: string, suggestions: string[] }> } | undefined} */
-  let diagnostics;
-  return {
-    get css() {
-      return getLayers();
-    },
-    layers: [...orderedLayers],
-    matched,
-    getLayers,
-    getLayer,
-    setLayer,
-    get diagnostics() {
-      diagnostics ??= { unmatched: resolveUnmatched() };
-      return diagnostics;
-    },
-  };
-}