@teacss/engine 0.9.3 → 0.10.2

package/dist/result.d.ts

@@ -1,83 +0,0 @@
-export interface RustUtil {
-    index: number;
-    selector: string | null;
-    body: string;
-    parent: string | null;
-    meta: Record<string, unknown> | null;
-    noMerge: boolean | null;
-}
-export interface RustGenerateResult {
-    css: string;
-    layers: Array<{
-        name: string;
-        css: string;
-    }>;
-    /** The matched tokens joined with `"\0"`, `""` when none (v02.2 §3). */
-    matched: string;
-    matchedInfo: Array<{
-        token: string;
-        data: RustUtil[];
-        count: number;
-    }> | null;
-    programKey: string;
-    /** Present only when a shortcut left a warning (v02.2 §6.8). */
-    shortcutWarnings?: RustShortcutWarning[];
-}
-export type RustShortcutWarning = {
-    shortcut: string;
-    unmatched: string[];
-} | {
-    shortcut: string;
-    leafLimit: number;
-};
-/** The `stringifyShortcuts` warnings (generator.ts:3445) and the leaf-limit warning, in order. */
-export declare function shortcutWarningMessages(warnings: RustShortcutWarning[]): string[];
-/** `rust.matched` as the token list, split once at the boundary. */
-export declare function splitMatched(rust: RustGenerateResult): string[];
-export interface UnmatchedEntry {
-    token: string;
-    suggestions: string[];
-}
-/** The oracle `StringifiedUtil` 7-tuple; the context slot is always `undefined`. */
-export type UtilTuple = [number, string | undefined, string, string | undefined, Record<string, unknown> | undefined, undefined, boolean | undefined];
-export declare function uniq(items: string[]): string[];
-/** By `configuredLayers[name] ?? 0`, ties by UTF-16 code units (generator.ts:1310-1312). */
-export declare function sortLayerNames(names: string[], configuredLayers: Record<string, number>): string[];
-/** A v02.2 `StringifiedUtil` as the oracle 7-tuple; `null` meta values are dropped. */
-export declare function toTuple(util: RustUtil): UtilTuple;
-export declare function buildMatched({ rust, matched, extendedInfo, countOf }: {
-    rust: RustGenerateResult;
-    matched: string[];
-    extendedInfo: boolean;
-    countOf?: (token: string, rustCount: number) => number;
-}): Set<string> | Map<string, {
-    data: UtilTuple[];
-    count: number;
-}>;
-export declare function describeUnmatched({ token, suggestions }: UnmatchedEntry): string;
-/** The `unmatched: "error"` message (generator.ts:2574). */
-export declare function formatUnmatchedError(diagnosed: UnmatchedEntry[]): string;
-/** `isTokenShaped` (unmatched-diagnostics.ts:59-70), for when no `@teacss/core` host is present. */
-export declare function fallbackIsTokenShaped(token: string): boolean;
-export interface FacadeResult {
-    readonly css: string;
-    layers: string[];
-    matched: Set<string> | Map<string, unknown>;
-    getLayers: (includes?: string[], excludes?: string[]) => string;
-    getLayer: (layer?: string) => string;
-    setLayer: (layer: string, callback: (content: string) => string | Promise<string>) => Promise<string>;
-    readonly diagnostics: {
-        unmatched: UnmatchedEntry[];
-    };
-}
-export declare function createFacadeResult({ rust, matched, minify, outputToCssLayers, configuredLayers, resolveUnmatched, }: {
-    rust: RustGenerateResult;
-    matched: Set<string> | Map<string, unknown>;
-    minify: boolean;
-    outputToCssLayers: boolean | {
-        allLayers?: boolean;
-    } | null | undefined;
-    configuredLayers: Record<string, number>;
-    resolveUnmatched: () => UnmatchedEntry[];
-}): FacadeResult;
-//# sourceMappingURL=result.d.ts.map

package/dist/result.js

@@ -1,142 +0,0 @@
-// The facade's `generate` result, shaped like the 0.8.2 `GenerateResult` (core/generator.ts:1540-1575).
-/** The `stringifyShortcuts` warnings (generator.ts:3445) and the leaf-limit warning, in order. */
-export function shortcutWarningMessages(warnings) {
-    return warnings.flatMap((warning) => ("unmatched" in warning ? warning.unmatched.map((member) => `unmatched utility "${member}" in shortcut "${warning.shortcut}"`) : [`shortcut "${warning.shortcut}" expands to more than ${warning.leafLimit} members (repeats included) and matches nothing`]));
-}
-/** `rust.matched` as the token list, split once at the boundary. */
-export function splitMatched(rust) {
-    return rust.matched === "" ? [] : rust.matched.split("\0");
-}
-export function uniq(items) {
-    return [...new Set(items)];
-}
-/** By `configuredLayers[name] ?? 0`, ties by UTF-16 code units (generator.ts:1310-1312). */
-export function sortLayerNames(names, configuredLayers) {
-    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. */
-export function toTuple(util) {
-    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];
-}
-export function buildMatched({ rust, matched, extendedInfo, countOf }) {
-    if (!extendedInfo)
-        return new Set(matched);
-    return new Map((rust.matchedInfo ?? []).map(({ token, data, count }) => [token, { data: data.map(toTuple), count: countOf ? countOf(token, count) : count }]));
-}
-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). */
-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.
- */
-function tokenConditionBase(raw) {
-    let closers = "";
-    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. */
-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);
-}
-export function createFacadeResult({ rust, matched, minify, outputToCssLayers, configuredLayers, resolveUnmatched, }) {
-    const nl = minify ? "" : "\n";
-    const orderedLayers = rust.layers.map((layer) => layer.name);
-    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;
-    // `hasOwn` guarantees the entry, which `noUncheckedIndexedAccess` cannot see.
-    const getLayer = (layer = "utilities") => (Object.hasOwn(layerCache, layer) ? layerCache[layer] : "");
-    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);
-    };
-    const setLayer = async (layer, callback) => {
-        const content = await callback(getLayer(layer));
-        layerCache[layer] = content;
-        return content;
-    };
-    let diagnostics;
-    return {
-        get css() {
-            return getLayers();
-        },
-        layers: [...orderedLayers],
-        matched,
-        getLayers,
-        getLayer,
-        setLayer,
-        get diagnostics() {
-            diagnostics ??= { unmatched: resolveUnmatched() };
-            return diagnostics;
-        },
-    };
-}
-//# sourceMappingURL=result.js.map

package/dist/select.d.ts

@@ -1,183 +0,0 @@
-import type { LoadProjectRequest } from "../contract.js";
-export type Failure = {
-    ok: false;
-    reason: string;
-    path: string;
-};
-export type Success<T> = {
-    ok: true;
-    value: T;
-};
-export declare function fail(reason: string, path: string): Failure;
-export declare function ok<T>(value: T): Success<T>;
-/**
- * Port of core/config.ts:48-59: `defaults` underneath, then the user config's own enumerable keys
- * whose value is not `undefined`. Only string keys are copied (v02.9 §4.4); values are defined
- * rather than assigned so a `__proto__` key stays a plain property.
- */
-export declare function mergeDefinedConfig(defaults: object, userConfig: object): Record<string, unknown>;
-export declare const KNOWN_KEYS: Set<string>;
-/** Keys whose presence with a non-empty value means fallback; `transformers` is checked by name (F7.09). */
-export declare const DYNAMIC_KEYS: readonly string[];
-/** A function, a non-empty array or object, or any other defined non-null value. */
-export declare function isNonEmpty(value: unknown): boolean;
-/**
- * v02.9 §4.2 step 2: unknown keys, then the dynamic keys in order, then the static options only
- * the TypeScript engine honours. `engine` is a hook option and its value is not checked here.
- */
-export declare function checkTopLevelKeys(merged: Record<string, unknown>): Success<null> | Failure;
-/**
- * The first own accessor property of `object`. Translation reads every field, so a getter would
- * run before TS reads it again (presets.test.ts "snapshots an own preset name exactly once"); an
- * object with accessors falls back without invoking them.
- */
-export declare function ownAccessor(object: object): string | undefined;
-/**
- * v02.9 §4.2 step 3: nested presets flattened depth first, deduplicated by name keeping the first
- * (core/config.ts:26-36 — a missing name is a name too), then ordered pre, normal, post
- * (config.ts:216-220; any other `enforce` value drops the preset, as there).
- */
-export declare function flattenPresets(presetsValue: unknown): Success<object[]> | Failure;
-/** The oracle's `PresetOptions` base (types.ts:53) has no named fields, so these five are Standard's whole option set. */
-export declare const STANDARD_OPTION_KEYS: Set<string>;
-export declare const COMPILE_CLASS_KEYS: string[];
-export declare const ICONS_OPTION_KEYS: string[];
-export declare const BUNDLED_ICON_COLLECTIONS: Set<string>;
-export declare const ROLE_PALETTES_PRESET = "@teacss/config/role-palettes";
-export declare function pick(obj: Record<string, unknown>, keys: Iterable<string>): Record<string, unknown>;
-/**
- * v02.9 §4.2 step 4, first four items: the marked built-in presets and the role-palettes marker.
- * `ok(null)` means the preset yields no `PresetSpec`; `undefined` means it is not one of these
- * (unmarked presets go to F7.08's static translation).
- * such as `presets[1]`
- */
-export declare function translateTaggedPreset(preset: object, path: string, ctx: {
-    hasEntry: boolean;
-}): Success<object | null> | Failure | undefined;
-/** Keys of an unmarked preset whose non-empty value means fallback; `content` is checked by `hasContentBeyondPipeline`. */
-export declare const PRESET_DYNAMIC_KEYS: readonly string[];
-/**
- * v02.9 §4.5: the static shortcut forms as `[name, expansion]` pairs. A shortcut meta (`[n, e, meta]`)
- * has no place in `StaticPreset.shortcuts`, so any meta key falls back.
- *
- */
-export declare function translateShortcuts(value: unknown, path: string, reasonOnFail: string): Success<Array<[string, string]> | undefined> | Failure;
-/**
- * v02.9 §4.5: a theme as dotted keys to string leaves (numbers stringified); empty objects vanish.
- *
- */
-export declare function flattenTheme(theme: unknown, path: string, reasonOnFail: string): Success<Record<string, string> | undefined> | Failure;
-export declare function translateStringList(list: unknown, path: string, reasonOnFail: string): Success<string[] | undefined> | Failure;
-export declare function translateLayers(layers: unknown, path: string, reasonOnFail: string): Success<Record<string, number> | undefined> | Failure;
-/**
- * v02.9 §4.2 step 4, "other objects": an unmarked preset as a `StaticPreset`.
- */
-export declare function translateStaticPreset(preset: Record<string, any>, path: string): Success<{
-    kind: "static";
-    preset: object;
-}> | Failure;
-/**
- * v02.9 §4.2 step 5: the merged config's static fields as a `StaticConfig` (possibly empty).
- */
-export declare function translateInline(merged: Record<string, any>): Success<object> | Failure;
-export declare const ALLOWED_TRANSFORMER_NAMES: Set<string>;
-/**
- * v02.2 §4: allow-listed transformers stay with the host (kept in the facade's `config.transformers`)
- * and never reach Rust; any other name falls back. Repeated names are kept in order; the config view
- * applies `uniqueNamed` later (F7.20). `@teacss/directives` options live in its closure and are
- * checked per call (v02.9 §6.3), so none are read here.
- */
-export declare function translateTransformers(list: unknown): Success<object[]> | Failure;
-/**
- * A config's own `transformerCompileClass(options)` keeps its options in a closure the facade
- * cannot read, and it registers classes by pushing onto `config.shortcuts`, which never reaches
- * the Engine. It is harmless only when the last Standard preset enables compileClass: the facade's
- * Rust transformer then comes first and `uniqueNamed` drops it, as the oracle drops it after the
- * preset's own. Otherwise it would run and its classes would generate no CSS, so it falls back.
- */
-export declare function hostCompileClass(transformers: readonly object[], presetSpecs: readonly object[]): Failure | undefined;
-export type EntryProvenance = {
-    base: string;
-    entryFile: string | undefined;
-    entryCss: string | undefined;
-    derivedKeys: string[];
-};
-export type EntrySource = {
-    root: string;
-    entry: {
-        path: string;
-        css: string | null;
-    } | null;
-    declarationFiles: string[];
-    derivedKeys: string[];
-};
-/** Test seam for the scanner; the default dynamically imports `@teacss/config/internal/source-scan`. */
-type SourceScanner = {
-    scanSourceFiles: (patterns: readonly string[], options: {
-        cwd: string;
-        ignore?: readonly string[];
-        expandDirectories: boolean;
-    }) => Promise<string[]>;
-};
-export declare const scanners: {
-    load: (() => Promise<SourceScanner>) | null;
-};
-/**
- * Entry source and declaration files (v02.9 §4.4). The symbols are read from `userConfig`, not
- * `merged`: `mergeDefinedConfig` copies no symbols.
- */
-export declare function resolveEntrySource(userConfig: object, merged: Record<string, unknown>): Promise<Success<EntrySource> | Failure>;
-/**
- * v02.9 §4: `UserConfig` → `LoadProjectRequest`; the first item that cannot be translated is
- * returned as a `Failure`.
- *
- */
-export type TranslateResult = {
-    ok: true;
-    request: LoadProjectRequest;
-    presets: object[];
-    transformers: object[];
-} | Failure;
-export declare function translateConfig(userConfig?: object, defaults?: object): Promise<TranslateResult>;
-/**
- * v02.9 §9: with `TEACSS_ENGINE_DEBUG=1`, the request or the failure goes to stderr.
- */
-export declare function debugTranslate(outcome: {
-    ok: true;
-    request: Record<string, any>;
-} | Failure, userConfig: object): void;
-export declare const VALID_MODES: Set<string>;
-/**
- * SemVer 2.0 precedence: the numeric triple, then a release above any of its prereleases, then
- * the prerelease identifiers in order (numeric ones by value and below alphanumeric ones, a shorter
- * list first when one is a prefix of the other).
- */
-export declare function compareSemver(a: string, b: string): -1 | 0 | 1;
-/** Only the `>=A <B` form `engineCompat.core` uses (v02.11 §7.3). */
-export declare function satisfiesRange(version: string, range: string): boolean;
-/**
- * v02.9 §8.1: `TEACSS_ENGINE` over the hook option over `"ts"`; an `"auto"` option stays on TS while
- * `defaultMode` is `"opt-in"`; a host core outside `engineCompat.core` keeps TS, or throws when
- * Rust was asked for.
- *
- */
-export declare function selectEngineRequest({ hostCoreVersion, option, env, compat }: {
-    hostCoreVersion?: string | undefined;
-    option?: unknown;
-    env?: string | undefined;
-    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?: Record<string, unknown>;
-};
-export {};
-//# sourceMappingURL=select.d.ts.map