@teacss/engine 0.9.3 → 0.10.2

package/dist/generator.d.ts

@@ -1,163 +0,0 @@
-import { ENGINE_INSTANCE, ENGINE_MATERIALIZE } from "./constants.js";
-/** Port of core/utils/events.ts:84-112. */
-export declare function createNanoEvents(): {
-    events: any;
-    emit(event: string, ...args: unknown[]): void;
-    on(event: string, cb: Function): () => void;
-};
-/** Port of core/utils/escape.ts:10-72 (CSSOM "serialize an identifier"). */
-export declare function escapeSelector(str: string): string;
-/** generator.ts:3722. */
-export declare function toEscapedSelector(raw: string): string;
-/**
- * v02.9 §8.1: the process-wide counters, the same object the teacss-ts hook updates.
- */
-export declare function engineStats(): {
-    rust: number;
-    ts: number;
-    fallbacks: Record<string, number>;
-};
-/**
- * v02.9 §9: each reason and path prints once per process; the counter grows on every call. A
- * host `report(reason, path, level)` (core's `reportFallback`) gets every call and does both
- * itself, so the counter is not touched here.
- */
-export declare function reportFallback(reason: string, path: string, host?: FacadeHost, level?: "info" | "warn"): void;
-export declare class FacadeGenerator {
-    #private;
-    /** The facade's own emitter; a TS backend's `events` are not forwarded. */
-    events: {
-        events: any;
-        emit(event: string, ...args: unknown[]): void;
-        on(event: string, cb: Function): () => void;
-    };
-    userConfig: Record<string, unknown>;
-    defaults: Record<string, unknown>;
-    /**
-     * An `engine` gives a Rust backend and `ts` a TypeScript one.
-     */
-    constructor({ engine, request, presets, transformers, ts, userConfig, defaults, host, transformer, }: {
-        engine?: any;
-        request?: object;
-        presets?: object[];
-        transformers?: object[];
-        ts?: any;
-        userConfig?: Record<string, unknown>;
-        defaults?: Record<string, unknown>;
-        host?: {
-            core?: any;
-        };
-        transformer?: object | null;
-    });
-    get version(): any;
-    get config(): any;
-    get cache(): any;
-    get blocked(): any;
-    get parentOrders(): any;
-    get activatedRules(): any;
-    set cache(value: any);
-    set blocked(value: any);
-    set parentOrders(value: any);
-    set activatedRules(value: any);
-    get [ENGINE_INSTANCE](): any;
-    /**
-     * The two overloads of generator.ts:2037-2040. With an `id` the Engine records the module's
-     * tokens; a counted set adds each token's occurrences.
-     */
-    applyExtractors(code: string, id?: string, extracted?: Set<string>): Promise<any>;
-    /**
-     * The overloads of generator.ts:2316-2318. String input is extracted here, as Rust's
-     * `{ kind: "code" }` would, so its tokens reach the cache and the unmatched check (the oracle
-     * runs `applyExtractors` on it, generator.ts:2378).
-     */
-    generate(input: string | string[] | Set<string>, options?: Record<string, any>): Promise<any>;
-    /**
-     * generator.ts:2113-2286. A tuple array, or `undefined` for a miss or a blocked token; a miss
-     * already cached reads back as `null`. With an `alias` nothing is cached.
-     */
-    parseToken(raw: string, alias?: string): Promise<any>;
-    /** generator.ts:3611. */
-    isBlocked(raw: string): any;
-    /** generator.ts:3623; the blocklist holds strings only (anything else falls back). */
-    getBlocked(raw: string): [string, undefined] | undefined;
-    /** generator.ts:2304-2314: cached tokens that emit the same output as `raw`. */
-    getCachedEquivalentTokens(raw: string): string[];
-    /** The TypeScript generator behind the tooling members, created on first call; a TS backend returns itself. */
-    [ENGINE_MATERIALIZE](): Promise<any>;
-    /** generator.ts:2105. */
-    makeContext(raw: string, applied: unknown): any;
-    /** generator.ts:2809. */
-    constructCustomCSS(context: unknown, body: unknown, overrideSelector?: string): any;
-    /** generator.ts:3160. */
-    stringifyUtil(parsed?: unknown, context?: unknown): any;
-    /** generator.ts:2635. */
-    matchVariants(raw: string, current?: string): Promise<any>;
-    /** generator.ts:2866. */
-    parseUtil(input: unknown, context: unknown, internal?: boolean, shortcutPrefix?: string | string[]): Promise<any>;
-    /** generator.ts:3208. */
-    expandShortcut(input: string, context: unknown, depth?: number): Promise<any>;
-    /** generator.ts:3409. */
-    stringifyShortcuts(parent: unknown, context: unknown, expanded: unknown[], meta?: unknown, matchedPrefixes?: unknown): Promise<any>;
-    /** generator.ts:1976-1980: a falsy config keeps the current one. */
-    setConfig(userConfig?: Record<string, unknown>, defaults?: Record<string, unknown>): Promise<void>;
-    /**
-     * generator.ts:1983-2008: a candidate generator for the configuration, without touching this
-     * one. A configuration Rust cannot serve gets a TypeScript candidate.
-     */
-    prepareConfig(userConfig: Record<string, unknown>, defaults?: Record<string, unknown>): Promise<Readonly<{
-        config: any;
-        defaults: Record<string, unknown>;
-        generator: FacadeGenerator;
-        userConfig: Record<string, unknown>;
-        version: number;
-    }>>;
-    /**
-     * generator.ts:2010-2035: switch to the prepared backend if no newer request superseded it. A
-     * superseded Rust candidate is disposed; so is the previous Engine once it is replaced.
-     */
-    commitConfig(prepared: {
-        config: unknown;
-        defaults: Record<string, unknown>;
-        generator: FacadeGenerator;
-        userConfig: Record<string, unknown>;
-        version: number;
-    }): boolean;
-    /**
-     * Releases the Engine this generator owns; later `generate`, `parseToken`, `applyExtractors`,
-     * `prepareConfig` and `commitConfig` throw `E_DISPOSED`, and a second call does nothing. A
-     * candidate committed into another generator handed its Engine over and leaves it alone.
-     */
-    dispose(): void;
-    [Symbol.dispose](): void;
-}
-/**
- * v02.9 §3.1: a Rust facade, or the reason the configuration needs TypeScript. Errors from
- * `loadProject` (`E_*`) are thrown as they are, not turned into a fallback. The hook counts the
- * initial creation, so this does not.
- */
-export interface FacadeHost {
-    /** 挂钩注入的 @teacss/core 绑定；缺省时 facade 按需动态 import。 */
-    core?: {
-        version: string;
-        createGenerator: (config?: object, defaults?: object) => Promise<object>;
-        createTsGenerator?: (config?: object, defaults?: object) => Promise<object>;
-        extractorSplit: object;
-        isCountableSet?: (value: unknown) => boolean;
-        isTokenShaped?: (token: string) => boolean;
-        toEscapedSelector?: (raw: string) => string;
-        /** core/utils/warn.ts 的 warnOnce；传入时 shortcut 警告与 TS 引擎共用一个去重集合。 */
-        warnOnce?: (message: string) => void;
-    } | undefined;
-    /** 挂钩注入的回退出口（core 的 reportFallback）：每次回退都调用，由它计数并按 reason 与 path 去重打印；缺省时 facade 自己计数并写 process.stderr。 */
-    report?: (reason: string, path: string, level: "info" | "warn") => void;
-}
-export type FacadeCreateResult = {
-    ok: true;
-    generator: FacadeGenerator;
-} | {
-    ok: false;
-    reason: string;
-    path: string;
-};
-export declare function createGenerator(config?: Record<string, unknown>, defaults?: Record<string, unknown>, host?: FacadeHost): Promise<FacadeCreateResult>;
-//# sourceMappingURL=generator.d.ts.map