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

package/contract.d.ts

@@ -0,0 +1,290 @@
+// Mirror of docs/specs/v02.2-engine-contract.md §3 (spec-revision 11). Do not edit without bumping the spec revision.
+export interface InspectEntryRequest {
+  /** 项目根（绝对路径）。相对 @source 以声明它的文件所在目录为基准。 */
+  root: string;
+  /** 入口 CSS 绝对路径。 */
+  entryPath: string;
+  /** 若宿主已持有入口内容（未保存的编辑器缓冲等），传入以替代磁盘读取。 */
+  entryCss?: string | undefined | null;
+}
+
+export interface InspectEntryResult {
+  /** @presets 列表，按声明顺序、去重（oracle resolvePresetGraph 的输入）。 */
+  presets: string[];
+  /** @source 声明；glob 已按声明文件目录解析为相对 root 的形式，exclude 以 `!` 前缀表示。 */
+  sources: string[];
+  /** 入口与本地 @import 图中读取过的文件（绝对路径，深度优先）。 */
+  configFiles: string[];
+  hasTeacss: boolean;
+  /** 入口语法诊断；非空时 loadProject 会以 E_ENTRY_INVALID 失败。 */
+  diagnostics: EntryDiagnostic[];
+}
+
+export interface LoadProjectRequest {
+  root: string;
+  /** null 表示没有入口文件（oracle loadConfig 找不到 entry 的情形）。 */
+  entry: { path: string; css?: string | undefined | null } | null;
+  /** 已解析顺序的预设（oracle 排序规则：pre、normal、post，见 core/config.ts:209）。 */
+  presets: PresetSpec[];
+  /** @source 匹配到的 .css 文件（绝对路径），只贡献 @shortcut/@safelist。由 JS 枚举。 */
+  declarationFiles: string[];
+  /** 内联 UserConfig / defaults 中可静态表示的部分。 */
+  inline?: StaticConfig | undefined | null;
+  envMode: "dev" | "build";
+  unmatched: "warn" | "error" | "off";
+  /** 对应 UserConfig.outputToCssLayers；函数形式由 facade 判定回退。 */
+  outputToCssLayers?: boolean | { allLayers?: boolean } | undefined | null;
+  shortcutsLayer?: string | undefined | null;
+  virtualModulePrefix?: string | undefined | null;
+}
+
+export interface LoadProjectResult {
+  programKey: string;
+  /** 与上一次 loadProject 相比 programKey 是否变化；首次为 true。 */
+  changed: boolean;
+  /** 声明文件中解析失败的位置（不阻止加载，oracle 行为相同）。 */
+  warnings: EntryDiagnostic[];
+  /** @custom 中不属于任何命名空间的属性名（oracle `ResolveEntryResult.unknown`），facade 的 `resolveEntryConfig` 透传。 */
+  unknownCustom: string[];
+}
+
+export type PresetSpec = { kind: "standard"; options?: PresetStandardOptions | undefined | null } | { kind: "official" } | { kind: "icons"; options?: PresetIconsOptions | undefined | null } | { kind: "static"; preset: StaticPreset };
+
+export interface PresetStandardOptions {
+  modeSelectors?: { dark?: string; light?: string } | undefined | null;
+  containers?: Record<string, string> | undefined | null;
+  preflight?: boolean | "on-demand" | undefined | null;
+  variablePrefix?: string | undefined | null;
+  compileClass?: boolean | CompileClassOptions | undefined | null;
+}
+
+export interface CompileClassOptions {
+  classPrefix?: string | undefined | null;
+  alwaysHash?: boolean | undefined | null;
+  keepUnknown?: boolean | undefined | null;
+  layer?: string | undefined | null;
+}
+
+export interface PresetIconsOptions {
+  scale?: number | undefined | null;
+  mode?: "mask" | "bg" | "auto" | undefined | null;
+  extraProperties?: Record<string, string> | undefined | null;
+  warn?: boolean | undefined | null;
+  layer?: string | undefined | null;
+  unit?: string | undefined | null;
+  /** 只允许内置集合名；其他集合由 facade 判定回退。 */
+  collections?: string[] | undefined | null;
+}
+
+/** 本地/第三方 preset 的可静态表示部分。任何不能表示的字段都由 facade 判定回退，不进入这里。 */
+export interface StaticPreset {
+  name: string;
+  enforce?: "pre" | "post" | undefined | null;
+  layer?: string | undefined | null;
+  layers?: Record<string, number> | undefined | null;
+  shortcuts?: Array<[string, string]> | undefined | null;
+  safelist?: string[] | undefined | null;
+  blocklist?: string[] | undefined | null;
+  /** 只接受 oracle `Theme` 中的标量叶子；对象按点路径展平后传入。 */
+  theme?: Record<string, string> | undefined | null;
+}
+
+export interface StaticConfig {
+  shortcuts?: Array<[string, string]> | undefined | null;
+  safelist?: string[] | undefined | null;
+  blocklist?: string[] | undefined | null;
+  layers?: Record<string, number> | undefined | null;
+  theme?: Record<string, string> | undefined | null;
+  content?: { filesystem?: string[] | undefined | null } | undefined | null;
+}
+
+export interface ModuleUpdateResult {
+  tokens: string[];
+  /** 该模块 token 集或 compile-class 定义相对上一次是否变化。 */
+  changed: boolean;
+}
+
+export interface ExtractFileResult {
+  path: string;
+  tokens: string[];
+  /** 读取失败时的错误码（E_IO）；成功为 null。 */
+  error: string | null;
+}
+
+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）。 */
+  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 为空数组。 */
+  compiledClasses: string[];
+  /** transformSource：该模块的定义集相对上一次是否变化（facade 据此调用 `ctx.invalidate()`）；transformStylesheet 为 false。 */
+  definitionsChanged: boolean;
+}
+
+export interface SourceMap {
+  version: 3;
+  file: string | null;
+  sources: string[];
+  sourcesContent: string[];
+  names: string[];
+  mappings: string;
+}
+
+export interface HighlightAnnotation {
+  offset: number;
+  length: number;
+  className: string;
+}
+
+export type GenerateInput = { kind: "tokens"; tokens: string[] } | { kind: "code"; code: string; id?: string | undefined | null } | { kind: "all" };
+
+export interface GenerateOptions {
+  id?: string | undefined | null;
+  /** 默认 true */
+  preflights?: boolean | undefined | null;
+  /** 默认 true */
+  safelist?: boolean | undefined | null;
+  /** 默认 false */
+  minify?: boolean | undefined | null;
+  /** 默认 false；为 true 时填充 matchedInfo */
+  extendedInfo?: boolean | undefined | null;
+  scope?: string | undefined | null;
+  /** 默认 true；false 时不拼、不传整表 css，result.css 为 ""。facade 传 false，它用 layers 重建。 */
+  css?: boolean | undefined | null;
+}
+
+export interface GenerateResult {
+  /** 与 oracle `result.css` 逐字节相同；`options.css` 为 false 时为 ""。 */
+  css: string;
+  /** 有序层；oracle `result.layers` 与 `getLayer(name)` 的来源。 */
+  layers: Array<{ name: string; css: string }>;
+  /** oracle `result.matched`（Set）按首次出现顺序，以 "\0" 分隔；没有时为 ""。 */
+  matched: string;
+  /** 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）。 */
+  shortcutWarnings?: ShortcutWarning[];
+}
+
+/**
+ * 一个 shortcut token 留下的警告。`shortcut` 是去掉 token 自身条件与 `!` 后的名（oracle `parent[1]`）。
+ * `unmatched`：不匹配任何规则的成员（blocklist 不作用于成员），按叶子顺序每个名一次，不带 token 自身的修饰；
+ * `leafLimit`：展开后成员超过该上限（§8），token 不匹配，成员不再报告。
+ */
+export type ShortcutWarning = { shortcut: string; unmatched: string[] } | { shortcut: string; leafLimit: number };
+
+/** oracle `StringifiedUtil` 元组的对象形式；`context` 字段不跨边界，facade 以 undefined 填充。 */
+export interface StringifiedUtil {
+  index: number;
+  selector: string | null;
+  body: string;
+  parent: string | null;
+  meta: RuleMeta | null;
+  noMerge: boolean | null;
+}
+
+export interface RuleMeta {
+  layer?: string | undefined | null;
+  noMerge?: boolean | undefined | null;
+  noScope?: boolean | undefined | null;
+  sort?: number | undefined | null;
+  prefix?: string | string[] | undefined | null;
+  internal?: boolean | undefined | null;
+}
+
+export interface UnmatchedDiagnostic {
+  token: string;
+  suggestions: string[];
+}
+
+export interface EntryConfig {
+  presets: string[];
+  rolePalettes: Partial<Record<"primary" | "neutral" | "success" | "warning" | "failure" | "general" | "focused", string[]>> | null;
+  sources: Array<{ glob: string; exclude: boolean }>;
+  custom: Array<{
+    alias: { name: string; family: string } | null;
+    mode: string | null;
+    declarations: Array<{ property: string; value: string }>;
+  }>;
+  shortcuts: Array<{ name: string; expansion: string }>;
+  safelist: string[];
+  hasTeacss: boolean;
+}
+
+export interface EntryDiagnostic {
+  file: string | null;
+  start: number;
+  end: number;
+  message: string;
+}
+
+export interface CustomDiagnostic {
+  property: string;
+  start: number;
+  end: number;
+  reason: "unknown-prefix" | "illegal-color-step" | "removed-theme";
+  message: string;
+}
+
+export interface ResolvedConfigView {
+  presets: Array<{ name: string; enforce: "pre" | "post" | null; layer: string | null }>;
+  layers: Record<string, number>;
+  content: { filesystem: string[] } | null;
+  /** 合并后的 theme（oracle `config.theme`）；嵌套对象原样。 */
+  theme: Record<string, unknown>;
+  shortcuts: Array<[string, string]>;
+  safelist: string[];
+  blocklist: string[];
+  separators: string[];
+  envMode: "dev" | "build";
+  unmatched: "warn" | "error" | "off";
+  shortcutsLayer: string;
+  virtualModulePrefix: string;
+  mergeSelectors: boolean;
+  warn: boolean;
+  details: boolean;
+  outputToCssLayers: boolean | { allLayers: boolean } | false;
+  rulesSize: number;
+  transformers: Array<{ name: string; enforce: "pre" | "post" | "default" }>;
+  extractors: Array<{ name: string }>;
+  standard: { preflight: boolean | "on-demand"; variablePrefix: string; compileClass: boolean } | null;
+  icons: { collections: string[]; mode: "mask" | "bg" | "auto"; layer: string } | null;
+}
+
+export interface RuleInfo {
+  /** `RuleDescriptor` 的 id（如 "standard.spacing.p"）；shortcut 为 "shortcut:<name>"。 */
+  id: string;
+  /** `RuleMeta.layer`。 */
+  layer: string | null;
+  /** `RuleDescriptor` 的 priority；shortcut 为 0。 */
+  priority: number;
+  /** `MatcherKey` 的变体：Property、PropertyPrefix、Keyword；shortcut 按名作 keyword。 */
+  matcher: { kind: "property" | "prefix" | "keyword"; value: string };
+  source: "standard" | "official" | "icons" | "shortcut";
+}
+
+export interface VariantInfo {
+  /** 用户写在 `@` 之后的名字：表项按名，开放族为 `prefix-*`，括号参数为 `[…]`。 */
+  name: string;
+  /** 接受它的解析器：pseudo、relational、attribute、language、media、at-rule、container、breakpoint、arbitrary。 */
+  kind: string;
+  source: RuleInfo["source"];
+}
+
+export interface EngineStats {
+  moduleCount: number;
+  /** 所有模块 token 的总数（含跨模块重复）。 */
+  tokenCount: number;
+  distinctTokens: number;
+  /** fragment 缓存条数，含未匹配或被 blocklist 拦截的负条目。 */
+  fragmentEntries: number;
+  /** 估算：每条键的 token 字节 + 每个 util 的 selector、body、parent 字节 + 结构体大小。 */
+  fragmentBytes: number;
+  /** 上一次 generate 结果：css、各层 css、matched 的字节和；没有时为 0。 */
+  memoBytes: number;
+}

package/dist/config-view.d.ts

@@ -0,0 +1,27 @@
+/** Fields the TypeScript generator provides; reading one before materialize throws `E_TS_REQUIRED`. */
+export declare const TS_ONLY_FIELDS: readonly string[];
+/** Fields copied from the Rust `ResolvedConfigView`. */
+export declare const VIEW_FIELDS: readonly string[];
+export interface ConfigViewArgs {
+    view: Record<string, any>;
+    request: object;
+    presets: object[];
+    /** The merged config (`mergeDefinedConfig(defaults, userConfig)`, config.ts:210) the oracle spreads. */
+    merged: Record<string, unknown>;
+    transformers: object[];
+    host: {
+        core?: {
+            extractorSplit: object;
+        } | undefined;
+    };
+    fallback: {
+        peek(): {
+            config: Record<string, unknown>;
+        } | null;
+    };
+    engine?: {
+        compileClassShortcuts(): unknown[];
+    };
+}
+export declare function createConfigView({ view, presets, merged, transformers, host, fallback, engine }: ConfigViewArgs): Record<string, unknown>;
+//# sourceMappingURL=config-view.d.ts.map

package/dist/config-view.js

@@ -0,0 +1,98 @@
+// 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.js";
+/** 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",
+]);
+export function createConfigView({ view, presets, merged, transformers, host, fallback, engine }) {
+    const config = {};
+    const data = (key, value) => Object.defineProperty(config, key, { value, enumerable: true, configurable: true, writable: true });
+    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" }];
+    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", (layers) => layers),
+    };
+    for (const key of VIEW_FIELDS)
+        fields[key] = () => data(key, view[key]);
+    // config.ts:263. Rust never warns, so its view does not carry the option.
+    fields.warn = () => data("warn", (Object.hasOwn(merged, "warn") ? merged.warn : undefined) ?? true);
+    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(merged)) {
+        if (key === "engine")
+            continue;
+        if (Object.hasOwn(fields, key))
+            fields[key]();
+        else
+            data(key, merged[key]);
+    }
+    // Redefining a spread key keeps its position, as the object literal does.
+    for (const key of RESOLVED_KEYS)
+        fields[key]();
+    return config;
+}
+//# sourceMappingURL=config-view.js.map

package/dist/constants.d.ts

@@ -0,0 +1,22 @@
+/** `@teacss/engine`'s own package.json version; the facade `generator.version` without a host. */
+export declare const ENGINE_PACKAGE_VERSION: string;
+/** `package.json#engineCompat` (v02.11 §7.3); without it `core` is unrestricted and `defaultMode` is `"auto"`. */
+export declare const ENGINE_COMPAT: Readonly<{
+    core: string | undefined;
+    defaultMode: "opt-in" | "auto";
+    oracle: {
+        teacssTs: string;
+        commit: string;
+    } | undefined;
+}>;
+export declare const ENGINE_INSTANCE: unique symbol;
+export declare const ENGINE_MATERIALIZE: unique symbol;
+export declare const ENGINE_STATS: unique symbol;
+export declare const PRESET_OPTIONS: Readonly<{
+    standard: symbol;
+    icons: symbol;
+    official: symbol;
+}>;
+export declare const CONFIG_SOURCE_DECLARATIONS: unique symbol;
+export declare const CONFIG_ENTRY_PROVENANCE: unique symbol;
+//# sourceMappingURL=constants.d.ts.map

package/{src/facade/constants.mjs → dist/constants.js}

@@ -1,24 +1,23 @@
-// @ts-check
 // The facade's symbols and package constants. It imports nothing from the facade, so every
-// facade module can import it without a cycle through `index.mjs`.
+// facade module can import it without a cycle through `index.ts`.
 import { createRequire } from "node:module";
-
-/** @type {{ version: string, engineCompat?: { core?: string, defaultMode?: "opt-in" | "auto" } }} */
-const pkg = createRequire(import.meta.url)("../../package.json");
-
+const pkg = createRequire(import.meta.url)("../package.json");
 /** `@teacss/engine`'s own package.json version; the facade `generator.version` without a host. */
 export const ENGINE_PACKAGE_VERSION = pkg.version;
-
 /** `package.json#engineCompat` (v02.11 §7.3); without it `core` is unrestricted and `defaultMode` is `"auto"`. */
-export const ENGINE_COMPAT = Object.freeze({ core: pkg.engineCompat?.core, defaultMode: pkg.engineCompat?.defaultMode ?? "auto", oracle: /** @type {any} */ (pkg.engineCompat)?.oracle });
-
+export const ENGINE_COMPAT = Object.freeze({
+    core: pkg.engineCompat?.core,
+    defaultMode: pkg.engineCompat?.defaultMode ?? "auto",
+    oracle: pkg.engineCompat?.oracle,
+});
 export const ENGINE_INSTANCE = Symbol.for("@teacss/engine/instance");
 export const ENGINE_MATERIALIZE = Symbol.for("@teacss/engine/materialize");
 export const ENGINE_STATS = Symbol.for("@teacss/engine/stats");
 export const PRESET_OPTIONS = Object.freeze({
-  standard: Symbol.for("@teacss/preset-standard/options"),
-  icons: Symbol.for("@teacss/preset-icons/options"),
-  official: Symbol.for("@teacss/preset-official/options"),
+    standard: Symbol.for("@teacss/preset-standard/options"),
+    icons: Symbol.for("@teacss/preset-icons/options"),
+    official: Symbol.for("@teacss/preset-official/options"),
 });
 export const CONFIG_SOURCE_DECLARATIONS = Symbol.for("@teacss/config/source-declarations");
 export const CONFIG_ENTRY_PROVENANCE = Symbol.for("@teacss/config/entry-provenance");
+//# sourceMappingURL=constants.js.map

package/dist/countable-set.d.ts

@@ -0,0 +1,57 @@
+export declare const MAX_RUNTIME_CACHE_ENTRIES = 10000;
+export declare class CountableSet<K> extends Set<K> {
+    _map: Map<K, number>;
+    constructor(values?: Iterable<K>);
+    add(key: K): this;
+    delete(key: K): boolean;
+    clear(): void;
+    getCount(key: K): number;
+    setCount(key: K, count: number): this;
+}
+export declare function isCountableSet(value: unknown): value is CountableSet<string>;
+export declare function copyCountableSet<K>(input: CountableSet<K>): CountableSet<K>;
+/**
+ * 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.
+ */
+export declare function expandInputGroups<T extends Set<string>>(tokens: T): T;
+/**
+ * The part of the oracle `BoundedMap` the facade uses: ordinary keys are evicted oldest first,
+ * retained keys never count toward the limit. An entry can be pending (`setPending`,
+ * `replaceRetainedPending`): its value is `resolve(token)`, computed on the first read through
+ * `get`, `forEach` or iteration and kept in place; `has`, `size`, `delete` and eviction never
+ * resolve.
+ */
+export declare class BoundedTokenCache<V> extends Map<string, V> {
+    #private;
+    maxEntries: number;
+    retained: Set<string>;
+    /** Ordinary keys in insertion order, the order the native map iterates them. */
+    order: Set<string>;
+    /** The value of a pending entry, called once per entry on its first read. */
+    resolve: (token: string) => V;
+    constructor(maxEntries?: number, resolve?: (token: string) => V);
+    get retainedSize(): number;
+    isRetained(key: string): boolean;
+    get(key: string): V | undefined;
+    entries(): MapIterator<[string, V]>;
+    values(): MapIterator<V>;
+    [Symbol.iterator](): MapIterator<[string, V]>;
+    forEach(callback: (value: V, key: string, map: Map<string, V>) => void, thisArg?: unknown): void;
+    set(key: string, value: V): this;
+    /** Caches `key` with the value `resolve` supplies on its first read. */
+    setPending(key: string): this;
+    delete(key: string): boolean;
+    clear(): void;
+    /** Replaces the retained entries (bounded-cache.ts:188-205 without the revision check). */
+    replaceRetained(entries: Iterable<readonly [string, V]>): void;
+    /** `replaceRetained` with every value pending. */
+    replaceRetainedPending(keys: Iterable<string>): void;
+}
+/** FIFO bounded Set (the oracle `BoundedSet` without its `assumeNoPrototypeBypass` fast path). */
+export declare class BoundedSet extends Set<string> {
+    maxEntries: number;
+    constructor(maxEntries?: number, values?: Iterable<string>);
+    add(value: string): this;
+}
+//# sourceMappingURL=countable-set.d.ts.map