@elastic/distillate 0.0.0 → 0.1.0

package/dist/cjs/runtime.js

@@ -0,0 +1,257 @@
+"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.composeThemeSelector = exports.renderStyles = void 0;
+const css_scan_1 = require("./css_scan");
+const local_vars_1 = require("./local_vars");
+const minify_1 = require("./minify");
+const names_1 = require("./names");
+const theme_1 = require("./theme");
+/**
+ * Emits collected CSS: theme block, then entries, minified.
+ *
+ * @param environment Theme vars, prefix, and scope for this render.
+ * @param collector Reachable entries and deps.
+ * @param resolver Defaults to `collector.createResolver()`.
+ */
+const renderStyles = (environment, collector, resolver = collector.createResolver(), options = {}) => {
+    const ctx = { environment, collector, resolver, options };
+    const bodyFragments = collector.collectedEntries.map((entry) => {
+        if (entry.kind === 'handle') {
+            return renderHandle(entry, ctx);
+        }
+        if (entry.kind === 'rule') {
+            return renderRule(entry, ctx);
+        }
+        const inner = entry.rules
+            .map((rule) => renderRule(rule, ctx))
+            .filter((fragment) => fragment.length > 0);
+        return inner.length > 0
+            ? `@${entry.atRule ?? 'media'} ${entry.query}{${inner.join('')}}`
+            : '';
+    });
+    const bodyCss = bodyFragments.join('');
+    const fragments = [renderThemeVars(ctx), bodyCss];
+    return (0, minify_1.minifyCss)(fragments.join(''));
+};
+exports.renderStyles = renderStyles;
+const renderThemeVars = (ctx) => {
+    const { environment, options } = ctx;
+    const selected = options.flatten
+        ? themeVariation(environment, options.flatten)
+        : undefined;
+    const primaryVars = selected && !selected.media ? selected.themeVars : environment.themeVars;
+    const blocks = [renderVarBlock(ctx, environment.themeScope, primaryVars)];
+    if (selected?.media) {
+        blocks.push(wrapMedia(selected.media, renderVarBlock(ctx, environment.themeScope, selected.diffs)));
+    }
+    for (const alternate of options.alternates ?? []) {
+        blocks.push(renderAlternate(ctx, alternate));
+    }
+    return blocks.join('');
+};
+const renderAlternate = (ctx, alternate) => {
+    const resolved = themeVariation(ctx.environment, alternate.variation);
+    const selector = alternate.selector
+        ? (0, exports.composeThemeSelector)(ctx.environment.themeScope, alternate.selector)
+        : resolved.media
+            ? ctx.environment.themeScope
+            : undefined;
+    if (!selector) {
+        throw new Error(`Alternate variation "${alternate.variation}" needs a selector (media-conditioned variations may omit one).`);
+    }
+    const block = renderVarBlock(ctx, selector, resolved.diffs);
+    return resolved.media ? wrapMedia(resolved.media, block) : block;
+};
+const themeVariation = (environment, name) => (0, theme_1.requireThemeVariation)(environment.variations, name);
+const renderVarBlock = (ctx, selector, vars) => {
+    const declarations = [...ctx.collector.collectedThemeDeps]
+        .sort()
+        .flatMap((path) => {
+        const definition = vars[path];
+        if (!definition) {
+            return [];
+        }
+        return [
+            `${ctx.resolver.cssVar(path)}:${formatThemeValue(definition, ctx.options.themeValueOverrides?.[path], ctx.options.scheme)}`,
+        ];
+    });
+    return declarations.length > 0
+        ? `${selector}{${declarations.join(';')}}`
+        : '';
+};
+const wrapMedia = (query, block) => block.length > 0 ? `@media ${query}{${block}}` : '';
+/** Composes `themeScope` with a per-render alternate selector. */
+const composeThemeSelector = (themeScope, selector) => {
+    const scope = themeScope.trim();
+    const extra = selector.trim();
+    if (extra.length === 0) {
+        throw new Error('Alternate selector must be non-empty.');
+    }
+    if (scope === ':host') {
+        return extra.startsWith(':host') ? extra : `:host(${extra})`;
+    }
+    if (/^[.#[:]/.test(extra)) {
+        return `${scope}${extra}`;
+    }
+    return `${scope} ${extra}`;
+};
+exports.composeThemeSelector = composeThemeSelector;
+const formatThemeValue = (definition, override, scheme) => override ?? (scheme ? definition[scheme] : (0, theme_1.serializedThemeValue)(definition));
+const renderHandle = (handle, ctx) => {
+    const body = renderDeclarations(handle.declarations, { handle }, ctx);
+    if ((0, css_scan_1.isBlankCss)(body)) {
+        return '';
+    }
+    const className = ctx.resolver.className(handle.key, handle.readableName);
+    return `.${className}{${body}}`;
+};
+const renderRule = (rule, ctx) => {
+    // Rules don't have a host handle for per-handle reachability — default
+    // markers in a rule's declaration emit every listed key. In practice
+    // authors place default markers on handle declarations; this branch keeps
+    // the runtime well-defined if a rule ever does carry one.
+    const body = renderDeclarations(rule.declarations, {}, ctx);
+    if ((0, css_scan_1.isBlankCss)(body)) {
+        return '';
+    }
+    const selector = rule.selector(createSelectorResolver(rule, ctx));
+    return `${selector}{${body}}`;
+};
+const renderDeclarations = (declarations, host, ctx) => {
+    const out = [];
+    for (const segment of declarations.css) {
+        out.push(renderSegment(segment, host, ctx));
+    }
+    return out.join('');
+};
+const renderSegment = (segment, host, ctx) => {
+    if (typeof segment === 'string') {
+        return resolveStringSegment(segment, ctx);
+    }
+    if ((0, local_vars_1.isLocalVarDefaultMarker)(segment)) {
+        return renderDefaultMarker(segment, host, ctx);
+    }
+    if ((0, local_vars_1.isLocalVarOverrideMarker)(segment)) {
+        return renderOverrideMarker(segment, ctx);
+    }
+    return '';
+};
+const renderDefaultMarker = (marker, host, ctx) => {
+    const reachable = host.handle
+        ? ctx.collector.reachableDefaults(host.handle, marker.groupPath)
+        : null;
+    const declarations = [];
+    for (const { key, path, value } of marker.defaults) {
+        if (reachable && !reachable.has(key)) {
+            continue;
+        }
+        const stringified = stringifyMarkerValue(value);
+        const resolvedValue = resolveStringSegment(stringified, ctx);
+        const propIdentifier = ctx.resolver.cssVar(path);
+        declarations.push(`${propIdentifier}:${resolvedValue}`);
+    }
+    return declarations.length > 0 ? `${declarations.join(';')};` : '';
+};
+const renderOverrideMarker = (marker, ctx) => {
+    const declarations = [];
+    for (const { path, value } of marker.overrides) {
+        const stringified = stringifyMarkerValue(value);
+        const resolvedValue = resolveStringSegment(stringified, ctx);
+        const propIdentifier = ctx.resolver.cssVar(path);
+        declarations.push(`${propIdentifier}:${resolvedValue}`);
+    }
+    return declarations.length > 0 ? `${declarations.join(';')};` : '';
+};
+const stringifyMarkerValue = (value) => {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    if (value !== null &&
+        typeof value === 'object' &&
+        typeof value.toString === 'function' &&
+        value.toString !== Object.prototype.toString) {
+        return value.toString();
+    }
+    throw new Error(`t.vars(...) value must be a string, number, theme token, contextual var, scale token, or local var ref; received ${describeValue(value)}.`);
+};
+const describeValue = (value) => {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'object') {
+        return '[object Object]';
+    }
+    return `${typeof value}`;
+};
+const createSelectorResolver = (rule, ctx) => {
+    const { resolver } = ctx;
+    const selectorResolver = ((handle) => resolver.className(handle.key, handle.readableName));
+    const module = ctx.collector.registry.module(rule.moduleName);
+    for (const handle of module?.handleList ?? []) {
+        defineSelectorAlias(selectorResolver, handle.localName, handle, resolver);
+        const leafName = handle.localName.split('/').at(-1);
+        if (leafName && leafName !== handle.localName) {
+            defineSelectorAlias(selectorResolver, leafName, handle, resolver);
+        }
+    }
+    return selectorResolver;
+};
+const defineSelectorAlias = (selectorResolver, name, handle, resolver) => {
+    if (!/^[A-Za-z_$][\w$]*$/.test(name) || name in selectorResolver) {
+        return;
+    }
+    Object.defineProperty(selectorResolver, name, {
+        configurable: true,
+        enumerable: true,
+        get: () => `.${resolver.className(handle.key, handle.readableName)}`,
+    });
+};
+const resolveStringSegment = (cssText, ctx) => {
+    return (0, css_scan_1.scanCss)(cssText)
+        .map((span) => (0, css_scan_1.isOpaque)(span) ? span.text : resolveCodeSpan(span.text, ctx))
+        .join('');
+};
+const resolveCodeSpan = (cssText, ctx) => {
+    let result = cssText;
+    const paths = new Set([
+        ...Object.keys(ctx.environment.themeVars),
+        ...(ctx.environment.sharedVars ?? []),
+        ...ctx.collector.collectedVarDeps,
+    ]);
+    for (const path of paths) {
+        result = substituteReadableVar(result, path, ctx);
+    }
+    return result;
+};
+const substituteReadableVar = (cssText, path, ctx) => {
+    const readableName = (0, names_1.cssVarName)(ctx.environment.prefix, path);
+    const readableRef = `var(${readableName})`;
+    let result = cssText;
+    if (result.includes(readableRef)) {
+        result = replaceAll(result, readableRef, ctx.resolver.cssVarRef(path));
+    }
+    if (containsCssIdentifier(result, readableName)) {
+        result = replaceCssIdentifier(result, readableName, ctx.resolver.cssVar(path));
+    }
+    return result;
+};
+const replaceAll = (value, search, replacement) => value.split(search).join(replacement);
+const replaceCssIdentifier = (value, search, replacement) => 
+// Authored and generated CSS only contains valid custom property identifiers.
+// Since every searched token starts with "--", the trailing boundary is enough.
+value.replace(new RegExp(`${escapeRegExp(search)}(?![_a-zA-Z0-9-])`, 'g'), replacement);
+const containsCssIdentifier = (value, search) => new RegExp(`${escapeRegExp(search)}(?![_a-zA-Z0-9-])`).test(value);
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+//# sourceMappingURL=runtime.js.map

package/dist/cjs/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime.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 { StylesCollector } from './collector';\nimport { isBlankCss, isOpaque, scanCss } from './css_scan';\nimport type { DistilleryEnvironment, ThemeVarDefinition } from './environment';\nimport {\n  isLocalVarDefaultMarker,\n  isLocalVarOverrideMarker,\n  type LocalVarDefaultMarker,\n  type LocalVarOverrideMarker,\n} from './local_vars';\nimport { minifyCss } from './minify';\nimport { cssVarName, type StyleNameResolver } from './names';\nimport type {\n  Declarations,\n  DeclarationSegment,\n  StyleHandle,\n  StyleRule,\n  StyleSelectorResolver,\n} from './styles';\nimport {\n  requireThemeVariation,\n  type ResolvedThemeVariation,\n  serializedThemeValue,\n} from './theme';\n\n/**\n * Emits collected CSS: theme block, then entries, minified.\n *\n * @param environment Theme vars, prefix, and scope for this render.\n * @param collector Reachable entries and deps.\n * @param resolver Defaults to `collector.createResolver()`.\n */\nexport const renderStyles = (\n  environment: DistilleryEnvironment<unknown>,\n  collector: StylesCollector,\n  resolver: StyleNameResolver = collector.createResolver(),\n  options: RenderStylesOptions = {}\n): string => {\n  const ctx: RenderContext = { environment, collector, resolver, options };\n  const bodyFragments = collector.collectedEntries.map((entry) => {\n    if (entry.kind === 'handle') {\n      return renderHandle(entry, ctx);\n    }\n    if (entry.kind === 'rule') {\n      return renderRule(entry, ctx);\n    }\n    const inner = entry.rules\n      .map((rule) => renderRule(rule, ctx))\n      .filter((fragment) => fragment.length > 0);\n    return inner.length > 0\n      ? `@${entry.atRule ?? 'media'} ${entry.query}{${inner.join('')}}`\n      : '';\n  });\n  const bodyCss = bodyFragments.join('');\n  const fragments = [renderThemeVars(ctx), bodyCss];\n\n  return minifyCss(fragments.join(''));\n};\n\n/** Per-render variation selection, scheme flatten, alternate blocks, and value overrides. */\nexport interface RenderStylesOptions {\n  /** Flatten this declared variation into `themeScope`. Default is the base. A media variation does not replace the primary block; it wraps its diffs in `@media`. */\n  flatten?: string;\n  /**\n   * Emit one scheme's literal instead of `light-dark(...)`.\n   *\n   * For a target with no color scheme to resolve the function against — an image or PDF backend, email HTML, an older browser.\n   */\n  scheme?: 'light' | 'dark';\n  /** Extra blocks for runtime switching. Each entry emits only the variation's diff. */\n  alternates?: readonly ThemeAlternate[];\n  /** Override a theme token's emitted value. */\n  themeValueOverrides?: Partial<Record<string, string>>;\n}\n\n/** One runtime-switched variation. `selector` is required unless the variation declares `media`. */\nexport interface ThemeAlternate {\n  /** Name passed in `DistilleryOptions.variations`. */\n  readonly variation: string;\n  /** Consuming page selector, composed with `themeScope`. */\n  readonly selector?: string;\n}\n\ninterface RenderContext {\n  /** Environment supplying theme vars, prefix, and scope. */\n  environment: DistilleryEnvironment<unknown>;\n  /** Reachable entries and deps for this render. */\n  collector: StylesCollector;\n  /** Class and CSS-var name resolver for this render. */\n  resolver: StyleNameResolver;\n  /** Per-render theme value overrides. */\n  options: RenderStylesOptions;\n}\n\nconst renderThemeVars = (ctx: RenderContext): string => {\n  const { environment, options } = ctx;\n  const selected = options.flatten\n    ? themeVariation(environment, options.flatten)\n    : undefined;\n  const primaryVars =\n    selected && !selected.media ? selected.themeVars : environment.themeVars;\n  const blocks = [renderVarBlock(ctx, environment.themeScope, primaryVars)];\n  if (selected?.media) {\n    blocks.push(\n      wrapMedia(\n        selected.media,\n        renderVarBlock(ctx, environment.themeScope, selected.diffs)\n      )\n    );\n  }\n  for (const alternate of options.alternates ?? []) {\n    blocks.push(renderAlternate(ctx, alternate));\n  }\n  return blocks.join('');\n};\n\nconst renderAlternate = (\n  ctx: RenderContext,\n  alternate: ThemeAlternate\n): string => {\n  const resolved = themeVariation(ctx.environment, alternate.variation);\n  const selector = alternate.selector\n    ? composeThemeSelector(ctx.environment.themeScope, alternate.selector)\n    : resolved.media\n      ? ctx.environment.themeScope\n      : undefined;\n  if (!selector) {\n    throw new Error(\n      `Alternate variation \"${alternate.variation}\" needs a selector (media-conditioned variations may omit one).`\n    );\n  }\n  const block = renderVarBlock(ctx, selector, resolved.diffs);\n  return resolved.media ? wrapMedia(resolved.media, block) : block;\n};\n\nconst themeVariation = (\n  environment: DistilleryEnvironment<unknown>,\n  name: string\n): ResolvedThemeVariation =>\n  requireThemeVariation(environment.variations, name);\n\nconst renderVarBlock = (\n  ctx: RenderContext,\n  selector: string,\n  vars: Readonly<Record<string, ThemeVarDefinition>>\n): string => {\n  const declarations = [...ctx.collector.collectedThemeDeps]\n    .sort()\n    .flatMap((path) => {\n      const definition = vars[path];\n      if (!definition) {\n        return [];\n      }\n      return [\n        `${ctx.resolver.cssVar(path)}:${formatThemeValue(\n          definition,\n          ctx.options.themeValueOverrides?.[path],\n          ctx.options.scheme\n        )}`,\n      ];\n    });\n  return declarations.length > 0\n    ? `${selector}{${declarations.join(';')}}`\n    : '';\n};\n\nconst wrapMedia = (query: string, block: string): string =>\n  block.length > 0 ? `@media ${query}{${block}}` : '';\n\n/** Composes `themeScope` with a per-render alternate selector. */\nexport const composeThemeSelector = (\n  themeScope: string,\n  selector: string\n): string => {\n  const scope = themeScope.trim();\n  const extra = selector.trim();\n  if (extra.length === 0) {\n    throw new Error('Alternate selector must be non-empty.');\n  }\n  if (scope === ':host') {\n    return extra.startsWith(':host') ? extra : `:host(${extra})`;\n  }\n  if (/^[.#[:]/.test(extra)) {\n    return `${scope}${extra}`;\n  }\n  return `${scope} ${extra}`;\n};\n\nconst formatThemeValue = (\n  definition: ThemeVarDefinition,\n  override: string | undefined,\n  scheme: 'light' | 'dark' | undefined\n): string =>\n  override ?? (scheme ? definition[scheme] : serializedThemeValue(definition));\n\nconst renderHandle = (handle: StyleHandle, ctx: RenderContext): string => {\n  const body = renderDeclarations(handle.declarations, { handle }, ctx);\n  if (isBlankCss(body)) {\n    return '';\n  }\n  const className = ctx.resolver.className(handle.key, handle.readableName);\n  return `.${className}{${body}}`;\n};\n\nconst renderRule = (rule: StyleRule, ctx: RenderContext): string => {\n  // Rules don't have a host handle for per-handle reachability — default\n  // markers in a rule's declaration emit every listed key. In practice\n  // authors place default markers on handle declarations; this branch keeps\n  // the runtime well-defined if a rule ever does carry one.\n  const body = renderDeclarations(rule.declarations, {}, ctx);\n  if (isBlankCss(body)) {\n    return '';\n  }\n  const selector = rule.selector(createSelectorResolver(rule, ctx));\n  return `${selector}{${body}}`;\n};\n\n/** Host for default-marker emission: a handle enables per-handle reachability. */\ninterface DeclarationHostContext {\n  /** Host handle whose refs narrow default-marker keys. Omitted for rules. */\n  handle?: StyleHandle;\n}\n\nconst renderDeclarations = (\n  declarations: Declarations,\n  host: DeclarationHostContext,\n  ctx: RenderContext\n): string => {\n  const out: string[] = [];\n  for (const segment of declarations.css) {\n    out.push(renderSegment(segment, host, ctx));\n  }\n  return out.join('');\n};\n\nconst renderSegment = (\n  segment: DeclarationSegment,\n  host: DeclarationHostContext,\n  ctx: RenderContext\n): string => {\n  if (typeof segment === 'string') {\n    return resolveStringSegment(segment, ctx);\n  }\n  if (isLocalVarDefaultMarker(segment)) {\n    return renderDefaultMarker(segment, host, ctx);\n  }\n  if (isLocalVarOverrideMarker(segment)) {\n    return renderOverrideMarker(segment, ctx);\n  }\n  return '';\n};\n\nconst renderDefaultMarker = (\n  marker: LocalVarDefaultMarker,\n  host: DeclarationHostContext,\n  ctx: RenderContext\n): string => {\n  const reachable = host.handle\n    ? ctx.collector.reachableDefaults(host.handle, marker.groupPath)\n    : null;\n  const declarations: string[] = [];\n  for (const { key, path, value } of marker.defaults) {\n    if (reachable && !reachable.has(key)) {\n      continue;\n    }\n    const stringified = stringifyMarkerValue(value);\n    const resolvedValue = resolveStringSegment(stringified, ctx);\n    const propIdentifier = ctx.resolver.cssVar(path);\n    declarations.push(`${propIdentifier}:${resolvedValue}`);\n  }\n  return declarations.length > 0 ? `${declarations.join(';')};` : '';\n};\n\nconst renderOverrideMarker = (\n  marker: LocalVarOverrideMarker,\n  ctx: RenderContext\n): string => {\n  const declarations: string[] = [];\n  for (const { path, value } of marker.overrides) {\n    const stringified = stringifyMarkerValue(value);\n    const resolvedValue = resolveStringSegment(stringified, ctx);\n    const propIdentifier = ctx.resolver.cssVar(path);\n    declarations.push(`${propIdentifier}:${resolvedValue}`);\n  }\n  return declarations.length > 0 ? `${declarations.join(';')};` : '';\n};\n\nconst stringifyMarkerValue = (value: unknown): string => {\n  if (typeof value === 'string') {\n    return value;\n  }\n  if (typeof value === 'number') {\n    return String(value);\n  }\n  if (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as { toString?: () => string }).toString === 'function' &&\n    (value as { toString: () => string }).toString !== Object.prototype.toString\n  ) {\n    return (value as { toString: () => string }).toString();\n  }\n  throw new Error(\n    `t.vars(...) value must be a string, number, theme token, contextual var, scale token, or local var ref; received ${describeValue(value)}.`\n  );\n};\n\nconst describeValue = (value: unknown): string => {\n  if (value === null) {\n    return 'null';\n  }\n  if (value === undefined) {\n    return 'undefined';\n  }\n  if (typeof value === 'object') {\n    return '[object Object]';\n  }\n  return `${typeof value}`;\n};\n\nconst createSelectorResolver = (\n  rule: StyleRule,\n  ctx: RenderContext\n): StyleSelectorResolver => {\n  const { resolver } = ctx;\n  const selectorResolver = ((handle: StyleHandle) =>\n    resolver.className(\n      handle.key,\n      handle.readableName\n    )) as StyleSelectorResolver;\n  const module = ctx.collector.registry.module(rule.moduleName);\n  for (const handle of module?.handleList ?? []) {\n    defineSelectorAlias(selectorResolver, handle.localName, handle, resolver);\n    const leafName = handle.localName.split('/').at(-1);\n    if (leafName && leafName !== handle.localName) {\n      defineSelectorAlias(selectorResolver, leafName, handle, resolver);\n    }\n  }\n  return selectorResolver;\n};\n\nconst defineSelectorAlias = (\n  selectorResolver: StyleSelectorResolver,\n  name: string,\n  handle: StyleHandle,\n  resolver: StyleNameResolver\n): void => {\n  if (!/^[A-Za-z_$][\\w$]*$/.test(name) || name in selectorResolver) {\n    return;\n  }\n  Object.defineProperty(selectorResolver, name, {\n    configurable: true,\n    enumerable: true,\n    get: () => `.${resolver.className(handle.key, handle.readableName)}`,\n  });\n};\n\nconst resolveStringSegment = (cssText: string, ctx: RenderContext): string => {\n  return scanCss(cssText)\n    .map((span) =>\n      isOpaque(span) ? span.text : resolveCodeSpan(span.text, ctx)\n    )\n    .join('');\n};\n\nconst resolveCodeSpan = (cssText: string, ctx: RenderContext): string => {\n  let result = cssText;\n  const paths = new Set<string>([\n    ...Object.keys(ctx.environment.themeVars),\n    ...(ctx.environment.sharedVars ?? []),\n    ...ctx.collector.collectedVarDeps,\n  ]);\n  for (const path of paths) {\n    result = substituteReadableVar(result, path, ctx);\n  }\n  return result;\n};\n\nconst substituteReadableVar = (\n  cssText: string,\n  path: string,\n  ctx: RenderContext\n): string => {\n  const readableName = cssVarName(ctx.environment.prefix, path);\n  const readableRef = `var(${readableName})`;\n  let result = cssText;\n  if (result.includes(readableRef)) {\n    result = replaceAll(result, readableRef, ctx.resolver.cssVarRef(path));\n  }\n  if (containsCssIdentifier(result, readableName)) {\n    result = replaceCssIdentifier(\n      result,\n      readableName,\n      ctx.resolver.cssVar(path)\n    );\n  }\n  return result;\n};\n\nconst replaceAll = (\n  value: string,\n  search: string,\n  replacement: string\n): string => value.split(search).join(replacement);\n\nconst replaceCssIdentifier = (\n  value: string,\n  search: string,\n  replacement: string\n): string =>\n  // Authored and generated CSS only contains valid custom property identifiers.\n  // Since every searched token starts with \"--\", the trailing boundary is enough.\n  value.replace(\n    new RegExp(`${escapeRegExp(search)}(?![_a-zA-Z0-9-])`, 'g'),\n    replacement\n  );\n\nconst containsCssIdentifier = (value: string, search: string): boolean =>\n  new RegExp(`${escapeRegExp(search)}(?![_a-zA-Z0-9-])`).test(value);\n\nconst escapeRegExp = (value: string): string =>\n  value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n"]}

package/dist/cjs/styles/authoring.js

@@ -0,0 +1,169 @@
+"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.globalStylesFromFlattened = exports.combineClassNames = exports.variants = exports.mapDomain = exports.isVariantMarked = exports.container = exports.media = exports.rule = exports.pendingHandleFromFlattened = exports.css = exports.decls = exports.EMPTY_DEPS = void 0;
+const nesting_1 = require("../nesting");
+const declarations_1 = require("./declarations");
+/** Shared empty `dependsOn` until module construction fills the real set. */
+exports.EMPTY_DEPS = new Set();
+/** Declaration-block template. Interpolations stringify; local-var markers stay until render. */
+const decls = (strings, ...values) => (0, declarations_1.buildDeclarations)(strings, values);
+exports.decls = decls;
+/** Handle template. Nested `&` / `@media` flatten into sibling rules. */
+const css = (strings, ...values) => {
+    if (!(0, nesting_1.hasNestedSyntax)(strings)) {
+        return {
+            kind: 'pending-handle',
+            declarations: (0, declarations_1.buildDeclarations)(strings, values),
+        };
+    }
+    return (0, exports.pendingHandleFromFlattened)((0, nesting_1.flattenTemplate)(strings, values, { mode: 'self' }));
+};
+exports.css = css;
+/** Builds a pending handle (plus nested sibling descriptors) from a flattened template. */
+const pendingHandleFromFlattened = (flat) => {
+    const selfSlice = flat.self ?? { strings: [''], values: [] };
+    return {
+        kind: 'pending-handle',
+        declarations: (0, declarations_1.buildDeclarations)(selfSlice.strings, selfSlice.values),
+        nested: flat.nested.map((entry) => {
+            if (entry.kind === 'rule') {
+                return {
+                    kind: 'nested-rule',
+                    alternatives: entry.alternatives,
+                    declarations: (0, declarations_1.buildDeclarations)(entry.slice.strings, entry.slice.values),
+                };
+            }
+            return {
+                kind: 'nested-media',
+                query: entry.query,
+                ...(entry.self
+                    ? { self: (0, declarations_1.buildDeclarations)(entry.self.strings, entry.self.values) }
+                    : {}),
+                rules: entry.rules.map((rule) => ({
+                    kind: 'nested-rule',
+                    alternatives: rule.alternatives,
+                    declarations: (0, declarations_1.buildDeclarations)(rule.slice.strings, rule.slice.values),
+                })),
+            };
+        }),
+    };
+};
+exports.pendingHandleFromFlattened = pendingHandleFromFlattened;
+/**
+ * Selector plus declarations. `dependsOn` is filled when the module is constructed.
+ *
+ * @param selector Factory receiving a {@link StyleSelectorResolver}; uses `&` and handle aliases.
+ * @param declarations CSS properties for this rule.
+ * @param options `auto` controls whether the rule self-collects when its handle dependencies are met.
+ */
+const rule = (selector, declarations, options = {}) => ({
+    kind: 'rule',
+    moduleName: '',
+    key: '',
+    selector,
+    declarations,
+    // `dependsOn` is computed in `assignEntries` once the module's handles are
+    // known. Authors construct rules outside that scope, so the placeholder is
+    // an empty set until `assignEntries` rewrites the entry.
+    dependsOn: exports.EMPTY_DEPS,
+    auto: options.auto ?? true,
+    variant: false,
+});
+exports.rule = rule;
+/**
+ * `@media` block wrapping rules.
+ *
+ * @param query Media query string (e.g. `(min-width: 600px)`).
+ * @param rules Inner rules scoped to this block.
+ */
+const media = (query, rules) => ({
+    kind: 'media',
+    atRule: 'media',
+    key: '',
+    moduleName: '',
+    query,
+    rules,
+    variant: false,
+});
+exports.media = media;
+/**
+ * `@container` block. `kind` stays `'media'` so emission rank matches {@link media}.
+ *
+ * @param query Container query string (e.g. `(min-width: 400px)`).
+ * @param rules Inner rules scoped to this block.
+ */
+const container = (query, rules) => ({
+    kind: 'media',
+    atRule: 'container',
+    key: '',
+    moduleName: '',
+    query,
+    rules,
+    variant: false,
+});
+exports.container = container;
+const variantMarkers = new WeakSet();
+const isVariantMarked = (value) => Boolean(value && typeof value === 'object' && variantMarkers.has(value));
+exports.isVariantMarked = isVariantMarked;
+const markVariant = (value) => {
+    if (!value || typeof value !== 'object') {
+        return;
+    }
+    variantMarkers.add(value);
+};
+/**
+ * Builds a record keyed by `domain`. No CSS-collection side effect.
+ *
+ * @param domain All valid keys (e.g. `['primary', 'secondary']`).
+ * @param factory Called once per key.
+ */
+const mapDomain = (domain, factory) => Object.fromEntries(domain.map((key) => [key, factory(key)]));
+exports.mapDomain = mapDomain;
+/**
+ * Builds a record of styles keyed by `domain`. Each value is marked `variant` so {@link index.StylesCollector#use | StylesCollector.use} skips it.
+ *
+ * @param domain All valid variant keys (e.g. `['primary', 'secondary']`).
+ * @param factory Called once per key; returns the handle or nested style object for that variant.
+ */
+const variants = (domain, factory) => {
+    const record = (0, exports.mapDomain)(domain, factory);
+    for (const value of Object.values(record)) {
+        markVariant(value);
+    }
+    return record;
+};
+exports.variants = variants;
+/**
+ * Resolves handles through the collector's class-name resolver.
+ *
+ * @param context Object exposing `resolveClassName` (e.g. a React render context).
+ * @param handles One or more handles to resolve and join.
+ */
+const combineClassNames = (context, ...handles) => context.resolveClassName(...handles);
+exports.combineClassNames = combineClassNames;
+const composeAbsoluteSelector = (alternatives) => (h) => alternatives
+    .map((parts) => parts
+    .map((part) => (typeof part === 'string' ? part : `.${h(part)}`))
+    .join(''))
+    .join(',');
+/** Authored `rule()`/`media()` entries from a global-mode flattened template. */
+const globalStylesFromFlattened = (flat) => {
+    const styles = {};
+    flat.nested.forEach((entry, index) => {
+        const localKey = `g${String(index).padStart(3, '0')}`;
+        if (entry.kind === 'rule') {
+            styles[localKey] = (0, exports.rule)(composeAbsoluteSelector(entry.alternatives), (0, declarations_1.buildDeclarations)(entry.slice.strings, entry.slice.values));
+            return;
+        }
+        styles[localKey] = (0, exports.media)(entry.query, entry.rules.map((nested) => (0, exports.rule)(composeAbsoluteSelector(nested.alternatives), (0, declarations_1.buildDeclarations)(nested.slice.strings, nested.slice.values))));
+    });
+    return styles;
+};
+exports.globalStylesFromFlattened = globalStylesFromFlattened;
+//# sourceMappingURL=authoring.js.map

package/dist/cjs/styles/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../../../src/styles/authoring.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 {\n  type FlattenedTemplate,\n  flattenTemplate,\n  hasNestedSyntax,\n  type SelectorAlternative,\n} from '../nesting';\n\nimport { buildDeclarations } from './declarations';\nimport type {\n  Declarations,\n  PendingStyleHandle,\n  RuleOptions,\n  StyleHandle,\n  StyleMedia,\n  StyleRule,\n  StyleSelectorResolver,\n  StylesObject,\n} from './types';\n\n/** Shared empty `dependsOn` until module construction fills the real set. */\nexport const EMPTY_DEPS: ReadonlySet<string> = new Set();\n\n/** Declaration-block template. Interpolations stringify; local-var markers stay until render. */\nexport const decls = (\n  strings: TemplateStringsArray,\n  ...values: readonly unknown[]\n): Declarations => buildDeclarations(strings, values);\n\n/** Handle template. Nested `&` / `@media` flatten into sibling rules. */\nexport const css = (\n  strings: TemplateStringsArray,\n  ...values: readonly unknown[]\n): PendingStyleHandle => {\n  if (!hasNestedSyntax(strings)) {\n    return {\n      kind: 'pending-handle',\n      declarations: buildDeclarations(strings, values),\n    };\n  }\n  return pendingHandleFromFlattened(\n    flattenTemplate(strings, values, { mode: 'self' })\n  );\n};\n\n/** Builds a pending handle (plus nested sibling descriptors) from a flattened template. */\nexport const pendingHandleFromFlattened = (\n  flat: FlattenedTemplate\n): PendingStyleHandle => {\n  const selfSlice = flat.self ?? { strings: [''], values: [] };\n  return {\n    kind: 'pending-handle',\n    declarations: buildDeclarations(selfSlice.strings, selfSlice.values),\n    nested: flat.nested.map((entry) => {\n      if (entry.kind === 'rule') {\n        return {\n          kind: 'nested-rule',\n          alternatives: entry.alternatives,\n          declarations: buildDeclarations(\n            entry.slice.strings,\n            entry.slice.values\n          ),\n        };\n      }\n      return {\n        kind: 'nested-media',\n        query: entry.query,\n        ...(entry.self\n          ? { self: buildDeclarations(entry.self.strings, entry.self.values) }\n          : {}),\n        rules: entry.rules.map((rule) => ({\n          kind: 'nested-rule',\n          alternatives: rule.alternatives,\n          declarations: buildDeclarations(\n            rule.slice.strings,\n            rule.slice.values\n          ),\n        })),\n      };\n    }),\n  };\n};\n\n/**\n * Selector plus declarations. `dependsOn` is filled when the module is constructed.\n *\n * @param selector Factory receiving a {@link StyleSelectorResolver}; uses `&` and handle aliases.\n * @param declarations CSS properties for this rule.\n * @param options `auto` controls whether the rule self-collects when its handle dependencies are met.\n */\nexport const rule = (\n  selector: (h: StyleSelectorResolver) => string,\n  declarations: Declarations,\n  options: RuleOptions = {}\n): StyleRule => ({\n  kind: 'rule',\n  moduleName: '',\n  key: '',\n  selector,\n  declarations,\n  // `dependsOn` is computed in `assignEntries` once the module's handles are\n  // known. Authors construct rules outside that scope, so the placeholder is\n  // an empty set until `assignEntries` rewrites the entry.\n  dependsOn: EMPTY_DEPS,\n  auto: options.auto ?? true,\n  variant: false,\n});\n\n/**\n * `@media` block wrapping rules.\n *\n * @param query Media query string (e.g. `(min-width: 600px)`).\n * @param rules Inner rules scoped to this block.\n */\nexport const media = (\n  query: string,\n  rules: readonly StyleRule[]\n): StyleMedia => ({\n  kind: 'media',\n  atRule: 'media',\n  key: '',\n  moduleName: '',\n  query,\n  rules,\n  variant: false,\n});\n\n/**\n * `@container` block. `kind` stays `'media'` so emission rank matches {@link media}.\n *\n * @param query Container query string (e.g. `(min-width: 400px)`).\n * @param rules Inner rules scoped to this block.\n */\nexport const container = (\n  query: string,\n  rules: readonly StyleRule[]\n): StyleMedia => ({\n  kind: 'media',\n  atRule: 'container',\n  key: '',\n  moduleName: '',\n  query,\n  rules,\n  variant: false,\n});\n\nconst variantMarkers = new WeakSet<object>();\n\nexport const isVariantMarked = (value: unknown): boolean =>\n  Boolean(value && typeof value === 'object' && variantMarkers.has(value));\n\nconst markVariant = (value: unknown): void => {\n  if (!value || typeof value !== 'object') {\n    return;\n  }\n  variantMarkers.add(value);\n};\n\n/**\n * Builds a record keyed by `domain`. No CSS-collection side effect.\n *\n * @param domain All valid keys (e.g. `['primary', 'secondary']`).\n * @param factory Called once per key.\n */\nexport const mapDomain = <TKey extends string, TValue>(\n  domain: readonly TKey[],\n  factory: (value: TKey) => TValue\n): Record<TKey, TValue> =>\n  Object.fromEntries(domain.map((key) => [key, factory(key)])) as Record<\n    TKey,\n    TValue\n  >;\n\n/**\n * Builds a record of styles keyed by `domain`. Each value is marked `variant` so {@link index.StylesCollector#use | StylesCollector.use} skips it.\n *\n * @param domain All valid variant keys (e.g. `['primary', 'secondary']`).\n * @param factory Called once per key; returns the handle or nested style object for that variant.\n */\nexport const variants = <TKey extends string, TValue>(\n  domain: readonly TKey[],\n  factory: (value: TKey) => TValue\n): Record<TKey, TValue> => {\n  const record = mapDomain(domain, factory);\n  for (const value of Object.values(record)) {\n    markVariant(value);\n  }\n  return record;\n};\n\n/**\n * Resolves handles through the collector's class-name resolver.\n *\n * @param context Object exposing `resolveClassName` (e.g. a React render context).\n * @param handles One or more handles to resolve and join.\n */\nexport const combineClassNames = (\n  context: { resolveClassName: (...handles: StyleHandle[]) => string },\n  ...handles: readonly StyleHandle[]\n): string => context.resolveClassName(...handles);\n\nconst composeAbsoluteSelector =\n  (alternatives: readonly SelectorAlternative[]) =>\n  (h: StyleSelectorResolver): string =>\n    alternatives\n      .map((parts) =>\n        parts\n          .map((part) => (typeof part === 'string' ? part : `.${h(part)}`))\n          .join('')\n      )\n      .join(',');\n\n/** Authored `rule()`/`media()` entries from a global-mode flattened template. */\nexport const globalStylesFromFlattened = (\n  flat: FlattenedTemplate\n): StylesObject => {\n  const styles: Record<string, StyleRule | StyleMedia> = {};\n  flat.nested.forEach((entry, index) => {\n    const localKey = `g${String(index).padStart(3, '0')}`;\n    if (entry.kind === 'rule') {\n      styles[localKey] = rule(\n        composeAbsoluteSelector(entry.alternatives),\n        buildDeclarations(entry.slice.strings, entry.slice.values)\n      );\n      return;\n    }\n    styles[localKey] = media(\n      entry.query,\n      entry.rules.map((nested) =>\n        rule(\n          composeAbsoluteSelector(nested.alternatives),\n          buildDeclarations(nested.slice.strings, nested.slice.values)\n        )\n      )\n    );\n  });\n  return styles;\n};\n"]}

package/dist/cjs/styles/declarations.js

@@ -0,0 +1,139 @@
+"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.isEmptyDeclarations = exports.stringifyCssValue = exports.computeValueDeps = exports.buildDeclarations = void 0;
+const css_scan_1 = require("../css_scan");
+const local_vars_1 = require("../local_vars");
+const nesting_1 = require("../nesting");
+const tokens_1 = require("../tokens");
+/** Builds a declaration block: interpolations stringify; local-var markers stay until render. */
+const buildDeclarations = (strings, values) => {
+    const deps = {
+        theme: new Set(),
+        vars: new Set(),
+        refs: new Set(),
+        defaults: [],
+    };
+    const segments = [];
+    let pending = '';
+    const flushPending = () => {
+        if (pending.length > 0) {
+            segments.push(pending);
+            pending = '';
+        }
+    };
+    strings.forEach((part, index) => {
+        pending += part;
+        if (index < values.length) {
+            const value = values[index];
+            if ((0, local_vars_1.isLocalVarMarker)(value)) {
+                flushPending();
+                // Both default-emission and override-emission markers may carry
+                // theme tokens or shared contextual var refs as values. Walk those
+                // values and record any nested deps onto the host declaration so
+                // tree-shaking and registry registration include them.
+                recordMarkerDeps(value, deps);
+                segments.push(value);
+            }
+            else {
+                pending += (0, exports.stringifyCssValue)(value, deps);
+            }
+        }
+    });
+    flushPending();
+    assertDeclarationBlock(segments);
+    return {
+        css: segments,
+        deps,
+    };
+};
+exports.buildDeclarations = buildDeclarations;
+const recordMarkerDeps = (marker, deps) => {
+    if (marker.__kind === 'local-var-default-marker') {
+        // Default markers contribute their var paths and per-value deps only
+        // through the collector's reachability pass at resolver creation. We
+        // capture per-key value deps here so the collector can fold them in
+        // verbatim when the key survives reachability — and skip them entirely
+        // when it doesn't.
+        deps.defaults.push({
+            groupPath: marker.groupPath,
+            keys: marker.defaults.map((item) => ({
+                key: item.key,
+                path: item.path,
+                valueDeps: (0, exports.computeValueDeps)(item.value),
+            })),
+        });
+        return;
+    }
+    for (const item of marker.overrides) {
+        deps.vars.add(item.path);
+        // Stringify each value once to capture nested theme/var deps. The
+        // string return is discarded — the runtime re-stringifies at render
+        // time so compaction sees the same readable refs we record here.
+        (0, exports.stringifyCssValue)(item.value, deps);
+    }
+};
+/** Theme/var deps recorded while stringifying one declaration value. */
+const computeValueDeps = (value) => {
+    const local = {
+        theme: new Set(),
+        vars: new Set(),
+        refs: new Set(),
+        defaults: [],
+    };
+    (0, exports.stringifyCssValue)(value, local);
+    return { theme: local.theme, vars: local.vars };
+};
+exports.computeValueDeps = computeValueDeps;
+/** Stringifies one interpolable CSS value and records theme/var deps onto `deps`. */
+const stringifyCssValue = (value, deps) => {
+    if ((0, nesting_1.isHandleLike)(value)) {
+        throw new Error('A style handle cannot be interpolated into a declaration value; compose with the emotion compat css instead.');
+    }
+    if ((0, tokens_1.isCssToken)(value)) {
+        deps.theme.add(value.path);
+        return value.ref;
+    }
+    if ((0, tokens_1.isContextualCssVar)(value)) {
+        deps.vars.add(value.path);
+        deps.refs.add(value.path);
+        return value.ref;
+    }
+    if ((0, tokens_1.isContextualCssVarName)(value)) {
+        // `.name` interpolations are left-hand-side custom-property
+        // identifiers, not `var(...)` references — they belong in `vars` for
+        // registry coverage but not in `refs` (which feeds reachability).
+        deps.vars.add(value.path);
+        return value.name;
+    }
+    if ((0, local_vars_1.isLocalVarRef)(value)) {
+        deps.vars.add(value.path);
+        deps.refs.add(value.path);
+        return value.ref;
+    }
+    if ((0, tokens_1.isScaleToken)(value)) {
+        return value.value;
+    }
+    return String(value);
+};
+exports.stringifyCssValue = stringifyCssValue;
+/** True when every segment is comments, whitespace, or bare `;`. A local-var marker counts as content. */
+const isEmptyDeclarations = ({ css }) => css.every((segment) => typeof segment === 'string' && (0, css_scan_1.isBlankCss)(segment));
+exports.isEmptyDeclarations = isEmptyDeclarations;
+const assertDeclarationBlock = (segments) => {
+    for (const segment of segments) {
+        if (typeof segment !== 'string') {
+            continue;
+        }
+        if (/[{}]/.test(segment) ||
+            /(^|[\s;])@(?:media|supports|container)\b/i.test(segment)) {
+            throw new Error('css and decls accept declaration blocks only.');
+        }
+    }
+};
+//# sourceMappingURL=declarations.js.map