@elastic/distillate 0.0.0 → 0.2.0

package/dist/cjs/tokens/theme_token.js

@@ -0,0 +1,28 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCssToken = exports.themeToken = void 0;
+const kind_1 = require("./kind");
+/** Theme token that stringifies to `var(<cssVar>)`. */
+const themeToken = (path, cssVar) => {
+    const ref = `var(${cssVar})`;
+    const refToString = () => ref;
+    return {
+        __kind: 'theme-token',
+        path,
+        cssVar,
+        ref,
+        toString: refToString,
+        [Symbol.toPrimitive]: refToString,
+    };
+};
+exports.themeToken = themeToken;
+/** `true` when `value` is a {@link CssToken}. @param value Value to test. */
+const isCssToken = (value) => (0, kind_1.hasKind)(value, 'theme-token');
+exports.isCssToken = isCssToken;
+//# sourceMappingURL=theme_token.js.map

package/dist/cjs/tokens/theme_token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme_token.js","sourceRoot":"","sources":["../../../src/tokens/theme_token.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAAiC;AAkBjC,uDAAuD;AAChD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,MAAqB,EAAY,EAAE;IAC1E,MAAM,GAAG,GAAuB,OAAO,MAAM,GAAG,CAAC;IACjD,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,GAAG,CAAC;IACtC,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,IAAI;QACJ,MAAM;QACN,GAAG;QACH,QAAQ,EAAE,WAAW;QACrB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,WAAW;KAClC,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,UAAU,cAWrB;AAEF,6EAA6E;AACtE,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CAC9D,IAAA,cAAO,EAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AADnB,QAAA,UAAU,cACS","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { hasKind } from './kind';\n\n/** Represents a CSS theme token. Stringifies to `var(--...)`. */\nexport interface CssToken {\n  /** Brand for {@link isCssToken}. */\n  readonly __kind: 'theme-token';\n  /** Path string mapping to this token in the environment. */\n  readonly path: string;\n  /** Actual emitted CSS custom property name. */\n  readonly cssVar: `--${string}`;\n  /** Usable CSS `var(...)` reference string. */\n  readonly ref: `var(--${string})`;\n  /** Stringifies to {@link CssToken.ref}. */\n  toString(): string;\n  /** Template interpolation; same as {@link CssToken.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** Theme token that stringifies to `var(<cssVar>)`. */\nexport const themeToken = (path: string, cssVar: `--${string}`): CssToken => {\n  const ref: `var(--${string})` = `var(${cssVar})`;\n  const refToString = (): string => ref;\n  return {\n    __kind: 'theme-token',\n    path,\n    cssVar,\n    ref,\n    toString: refToString,\n    [Symbol.toPrimitive]: refToString,\n  };\n};\n\n/** `true` when `value` is a {@link CssToken}. @param value Value to test. */\nexport const isCssToken = (value: unknown): value is CssToken =>\n  hasKind(value, 'theme-token');\n"]}

package/dist/cjs/var_invariant.js

@@ -0,0 +1,115 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertVarRefsHaveDeclarations = exports.findVarRefViolations = exports.collectReferencedCustomProperties = exports.collectDeclaredCustomProperties = void 0;
+const css_scan_1 = require("./css_scan");
+const DECLARATION_RE = /(--[A-Za-z_][\w-]*)\s*:/g;
+const REFERENCE_RE = /var\(\s*(--[A-Za-z_][\w-]*)/g;
+const scan = (css) => {
+    const masked = [];
+    const blockAt = [];
+    for (const span of (0, css_scan_1.scanCss)(css)) {
+        const blank = (0, css_scan_1.isOpaque)(span);
+        for (let offset = 0; offset < span.text.length; offset += 1) {
+            masked.push(blank ? ' ' : (span.text[offset] ?? ''));
+            blockAt.push(span.block);
+        }
+    }
+    return { masked: masked.join(''), blockAt };
+};
+/**
+ * A custom property is declared where a declaration can start: inside a
+ * declarations block, as the first thing after `{` or `;`. A selector carrying
+ * a BEM-style modifier and a pseudo-class (`.button--active:hover`) matches the
+ * same characters and declares nothing.
+ */
+const isDeclarationStart = ({ masked, blockAt }, index) => {
+    if (blockAt[index] !== 'declarations') {
+        return false;
+    }
+    for (let cursor = index - 1; cursor >= 0; cursor -= 1) {
+        const char = masked[cursor];
+        if (char === undefined || !/\s/.test(char)) {
+            return char === '{' || char === ';';
+        }
+    }
+    return false;
+};
+/**
+ * `var` has to open a function token rather than end a longer identifier:
+ * `--expr:myvar(--x)` names some other function.
+ */
+const isFunctionTokenStart = (masked, index) => {
+    const before = masked[index - 1];
+    return before === undefined || !/[\w\\-]/.test(before);
+};
+/** Collects every custom property declared in a declaration position in `css`. */
+const collectDeclaredCustomProperties = (css) => {
+    const scanned = scan(css);
+    const declared = new Set();
+    for (const match of scanned.masked.matchAll(DECLARATION_RE)) {
+        const name = match[1];
+        if (name && isDeclarationStart(scanned, match.index ?? 0)) {
+            declared.add(name);
+        }
+    }
+    return declared;
+};
+exports.collectDeclaredCustomProperties = collectDeclaredCustomProperties;
+/** Collects all custom property names referenced inside `var(...)` calls in `css`. */
+const collectReferencedCustomProperties = (css) => {
+    const { masked } = scan(css);
+    const names = [];
+    for (const match of masked.matchAll(REFERENCE_RE)) {
+        const name = match[1];
+        if (name && isFunctionTokenStart(masked, match.index ?? 0)) {
+            names.push(name);
+        }
+    }
+    return names;
+};
+exports.collectReferencedCustomProperties = collectReferencedCustomProperties;
+/**
+ * Returns all `var(...)` references whose custom property is never declared in `css`.
+ *
+ * @param css Full CSS text to scan.
+ */
+const findVarRefViolations = (css) => {
+    const { masked } = scan(css);
+    const declared = (0, exports.collectDeclaredCustomProperties)(css);
+    const violations = [];
+    for (const match of masked.matchAll(REFERENCE_RE)) {
+        const ref = match[1];
+        const index = match.index ?? 0;
+        if (!ref || declared.has(ref) || !isFunctionTokenStart(masked, index)) {
+            continue;
+        }
+        violations.push({
+            reference: ref,
+            context: css.slice(Math.max(0, index - 40), index + ref.length + 8),
+        });
+    }
+    return violations;
+};
+exports.findVarRefViolations = findVarRefViolations;
+/**
+ * Throws if any `var(...)` in `css` has no matching custom-property declaration.
+ *
+ * @param css Full CSS text to scan.
+ * @throws If any reference has no declaration in the same text.
+ */
+const assertVarRefsHaveDeclarations = (css) => {
+    const violations = (0, exports.findVarRefViolations)(css);
+    if (violations.length === 0) {
+        return;
+    }
+    const lines = violations.map(({ reference, context }) => `- ${reference} referenced near "${context.replace(/\s+/g, ' ')}"`);
+    throw new Error(`${violations.length} var(...) reference(s) without a matching declaration:\n${lines.join('\n')}`);
+};
+exports.assertVarRefsHaveDeclarations = assertVarRefsHaveDeclarations;
+//# sourceMappingURL=var_invariant.js.map

package/dist/cjs/var_invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"var_invariant.js","sourceRoot":"","sources":["../../src/var_invariant.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { type CssBlockKind, isOpaque, scanCss } from './css_scan';\n\nconst DECLARATION_RE = /(--[A-Za-z_][\\w-]*)\\s*:/g;\nconst REFERENCE_RE = /var\\(\\s*(--[A-Za-z_][\\w-]*)/g;\n\n/** A `var(...)` whose custom property is never declared in the same CSS text. */\nexport interface VarInvariantViolation {\n  /** The undeclared custom property name (e.g. `--aui-color-bg`). */\n  readonly reference: string;\n  /** Surrounding CSS text for error reporting. */\n  readonly context: string;\n}\n\ninterface ScannedCss {\n  /**\n   * `css` with comments, strings, `url(...)` tokens, and escapes blanked to\n   * spaces, positions preserved. A `var(` inside a string is text, a `;`\n   * inside an escape is part of a value, and neither should match here.\n   */\n  readonly masked: string;\n  /** The enclosing block kind at each character offset. */\n  readonly blockAt: readonly CssBlockKind[];\n}\n\nconst scan = (css: string): ScannedCss => {\n  const masked: string[] = [];\n  const blockAt: CssBlockKind[] = [];\n  for (const span of scanCss(css)) {\n    const blank = isOpaque(span);\n    for (let offset = 0; offset < span.text.length; offset += 1) {\n      masked.push(blank ? ' ' : (span.text[offset] ?? ''));\n      blockAt.push(span.block);\n    }\n  }\n  return { masked: masked.join(''), blockAt };\n};\n\n/**\n * A custom property is declared where a declaration can start: inside a\n * declarations block, as the first thing after `{` or `;`. A selector carrying\n * a BEM-style modifier and a pseudo-class (`.button--active:hover`) matches the\n * same characters and declares nothing.\n */\nconst isDeclarationStart = (\n  { masked, blockAt }: ScannedCss,\n  index: number\n): boolean => {\n  if (blockAt[index] !== 'declarations') {\n    return false;\n  }\n  for (let cursor = index - 1; cursor >= 0; cursor -= 1) {\n    const char = masked[cursor];\n    if (char === undefined || !/\\s/.test(char)) {\n      return char === '{' || char === ';';\n    }\n  }\n  return false;\n};\n\n/**\n * `var` has to open a function token rather than end a longer identifier:\n * `--expr:myvar(--x)` names some other function.\n */\nconst isFunctionTokenStart = (masked: string, index: number): boolean => {\n  const before = masked[index - 1];\n  return before === undefined || !/[\\w\\\\-]/.test(before);\n};\n\n/** Collects every custom property declared in a declaration position in `css`. */\nexport const collectDeclaredCustomProperties = (css: string): Set<string> => {\n  const scanned = scan(css);\n  const declared = new Set<string>();\n  for (const match of scanned.masked.matchAll(DECLARATION_RE)) {\n    const name = match[1];\n    if (name && isDeclarationStart(scanned, match.index ?? 0)) {\n      declared.add(name);\n    }\n  }\n  return declared;\n};\n\n/** Collects all custom property names referenced inside `var(...)` calls in `css`. */\nexport const collectReferencedCustomProperties = (\n  css: string\n): readonly string[] => {\n  const { masked } = scan(css);\n  const names: string[] = [];\n  for (const match of masked.matchAll(REFERENCE_RE)) {\n    const name = match[1];\n    if (name && isFunctionTokenStart(masked, match.index ?? 0)) {\n      names.push(name);\n    }\n  }\n  return names;\n};\n\n/**\n * Returns all `var(...)` references whose custom property is never declared in `css`.\n *\n * @param css Full CSS text to scan.\n */\nexport const findVarRefViolations = (\n  css: string\n): readonly VarInvariantViolation[] => {\n  const { masked } = scan(css);\n  const declared = collectDeclaredCustomProperties(css);\n  const violations: VarInvariantViolation[] = [];\n  for (const match of masked.matchAll(REFERENCE_RE)) {\n    const ref = match[1];\n    const index = match.index ?? 0;\n    if (!ref || declared.has(ref) || !isFunctionTokenStart(masked, index)) {\n      continue;\n    }\n    violations.push({\n      reference: ref,\n      context: css.slice(Math.max(0, index - 40), index + ref.length + 8),\n    });\n  }\n  return violations;\n};\n\n/**\n * Throws if any `var(...)` in `css` has no matching custom-property declaration.\n *\n * @param css Full CSS text to scan.\n * @throws If any reference has no declaration in the same text.\n */\nexport const assertVarRefsHaveDeclarations = (css: string): void => {\n  const violations = findVarRefViolations(css);\n  if (violations.length === 0) {\n    return;\n  }\n  const lines = violations.map(\n    ({ reference, context }) =>\n      `- ${reference} referenced near \"${context.replace(/\\s+/g, ' ')}\"`\n  );\n  throw new Error(\n    `${violations.length} var(...) reference(s) without a matching declaration:\\n${lines.join('\\n')}`\n  );\n};\n"]}

package/dist/collector.d.ts

@@ -0,0 +1,101 @@
+import { type StyleNameMode, type StyleNameResolver, type StyleTarget } from './names.js';
+import type { ContextualVarPath, StyleEntry, StyleHandle, StyleRegistry, StylesModule } from './styles/index.js';
+/** Target, naming mode, registry, and prefix for one {@link StylesCollector}. */
+export interface StylesCollectorOptions {
+    /** Target context (e.g. `artifact` or `stylesheet`). */
+    target: StyleTarget;
+    /** Desired name mode (`compact` or `readable`). */
+    names: StyleNameMode;
+    /** Registry modules were authored against; used for auto-collection and compact-name snapshots. */
+    registry: StyleRegistry;
+    /** Brand prefix forwarded to the name resolver. */
+    prefix: string;
+    /** When `true`, emit no-op-handle warnings through `warn`. Inherited from `createDistillery({ dev })`. */
+    dev?: boolean;
+    /** Warning sink for no-op handles. Used only when `dev` is `true`. Defaults to `console.warn`. */
+    warn?: (message: string) => void;
+}
+/** Reachable entries for one render or one stylesheet. */
+export declare class StylesCollector {
+    /** The target collection mode. */
+    readonly target: StyleTarget;
+    /** The naming mode (compact vs readable). */
+    readonly names: StyleNameMode;
+    /** Associated registry. */
+    readonly registry: StyleRegistry;
+    /** Emitted class name prefix. */
+    readonly prefix: string;
+    private readonly dev;
+    private readonly warn;
+    private readonly entries;
+    private readonly handles;
+    private readonly themeDeps;
+    private readonly varDeps;
+    private readonly listeners;
+    private depth;
+    private dirty;
+    constructor({ target, names, registry, prefix, dev, warn, }: StylesCollectorOptions);
+    /**
+     * Collects a module's non-variant entries, or one explicit entry.
+     *
+     * Variant entries stay off this path; collect them via `useHandles`.
+     *
+     * @param value Module (all non-variant entries), a single entry, or an array of entries.
+     */
+    use(value: StylesModule | StyleEntry | readonly StyleEntry[]): void;
+    private useValue;
+    /**
+     * Collects every entry on `module`, including variants. Used by the stylesheet target.
+     *
+     * @param module Module whose entries should all be collected.
+     */
+    useAllEntries(module: StylesModule): void;
+    /**
+     * Collects handles and auto-includes rules whose selector deps are all present.
+     *
+     * Media blocks gain inner rules whose deps are met and keep rules already collected.
+     *
+     * @param handles Handles resolved during this render pass (e.g. from `resolveClassName`).
+     * @returns Handles that were retained. Empty untargeted handles are omitted in compact mode.
+     */
+    useHandles(handles: readonly StyleHandle[]): readonly StyleHandle[];
+    /** Collects `auto` rules on `module` whose every selector dependency is already collected. */
+    useRulesWhenDepsMet(module: StylesModule): void;
+    /**
+     * Calls `listener` after a public mutation adds an entry, handle, theme var, or contextual var.
+     *
+     * Fires at most once per outermost call; nested calls such as `use([a, b])` batch into it.
+     *
+     * @param listener Called with no arguments after the collection grows.
+     * @returns Unsubscribes `listener`.
+     */
+    subscribe(listener: () => void): () => void;
+    private tryActivateDependent;
+    private allDepsMet;
+    /** Marks a theme token path as reachable so it appears in the emitted theme block, even if no collected declaration reads it. */
+    useThemeVar(path: string): void;
+    /** Creates a {@link StyleNameResolver} scoped to this collector's current dep set. */
+    createResolver(): StyleNameResolver;
+    /** Collected style entries sorted for emission (base rules before all `@media`/`@container` blocks). */
+    get collectedEntries(): readonly StyleEntry[];
+    /** Theme token paths that survive reachability; emitted in the theme scope block. */
+    get collectedThemeDeps(): ReadonlySet<string>;
+    /** Contextual var paths that survive reachability; used by the runtime for compact-name substitution. */
+    get collectedVarDeps(): ReadonlySet<ContextualVarPath>;
+    /**
+     * Returns the variable keys within `groupPath` that are reachable from `handle` or from any collected rule targeting it.
+     *
+     * @param handle Handle whose declaration refs and dependent rules are consulted.
+     * @param groupPath Group prefix path (e.g. `vars/chip/look`).
+     */
+    reachableDefaults(handle: StyleHandle, groupPath: `vars/${string}`): ReadonlySet<string>;
+    private finalizeDeps;
+    private retainHandle;
+    private addEntry;
+    private addDeclarationDeps;
+    private addDeps;
+    private setEntry;
+    private setHandle;
+    private batch;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"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"}