@elastic/distillate 0.0.0 → 0.1.0

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

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

package/dist/cjs/styles/index.js

@@ -0,0 +1,32 @@
+"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.StyleRegistry = exports.readableVarOwnersFromEnvironment = exports.createStyleModuleWithEnvironment = exports.stringifyCssValue = exports.isEmptyDeclarations = exports.computeValueDeps = exports.variants = exports.rule = exports.pendingHandleFromFlattened = exports.media = exports.mapDomain = exports.isVariantMarked = exports.globalStylesFromFlattened = exports.decls = exports.css = exports.container = exports.combineClassNames = void 0;
+require("../instance");
+var authoring_1 = require("./authoring");
+Object.defineProperty(exports, "combineClassNames", { enumerable: true, get: function () { return authoring_1.combineClassNames; } });
+Object.defineProperty(exports, "container", { enumerable: true, get: function () { return authoring_1.container; } });
+Object.defineProperty(exports, "css", { enumerable: true, get: function () { return authoring_1.css; } });
+Object.defineProperty(exports, "decls", { enumerable: true, get: function () { return authoring_1.decls; } });
+Object.defineProperty(exports, "globalStylesFromFlattened", { enumerable: true, get: function () { return authoring_1.globalStylesFromFlattened; } });
+Object.defineProperty(exports, "isVariantMarked", { enumerable: true, get: function () { return authoring_1.isVariantMarked; } });
+Object.defineProperty(exports, "mapDomain", { enumerable: true, get: function () { return authoring_1.mapDomain; } });
+Object.defineProperty(exports, "media", { enumerable: true, get: function () { return authoring_1.media; } });
+Object.defineProperty(exports, "pendingHandleFromFlattened", { enumerable: true, get: function () { return authoring_1.pendingHandleFromFlattened; } });
+Object.defineProperty(exports, "rule", { enumerable: true, get: function () { return authoring_1.rule; } });
+Object.defineProperty(exports, "variants", { enumerable: true, get: function () { return authoring_1.variants; } });
+var declarations_1 = require("./declarations");
+Object.defineProperty(exports, "computeValueDeps", { enumerable: true, get: function () { return declarations_1.computeValueDeps; } });
+Object.defineProperty(exports, "isEmptyDeclarations", { enumerable: true, get: function () { return declarations_1.isEmptyDeclarations; } });
+Object.defineProperty(exports, "stringifyCssValue", { enumerable: true, get: function () { return declarations_1.stringifyCssValue; } });
+var module_1 = require("./module");
+Object.defineProperty(exports, "createStyleModuleWithEnvironment", { enumerable: true, get: function () { return module_1.createStyleModuleWithEnvironment; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "readableVarOwnersFromEnvironment", { enumerable: true, get: function () { return registry_1.readableVarOwnersFromEnvironment; } });
+Object.defineProperty(exports, "StyleRegistry", { enumerable: true, get: function () { return registry_1.StyleRegistry; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/styles/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uBAAqB;AAErB,yCAYqB;AAXnB,8GAAA,iBAAiB,OAAA;AACjB,sGAAA,SAAS,OAAA;AACT,gGAAA,GAAG,OAAA;AACH,kGAAA,KAAK,OAAA;AACL,sHAAA,yBAAyB,OAAA;AACzB,4GAAA,eAAe,OAAA;AACf,sGAAA,SAAS,OAAA;AACT,kGAAA,KAAK,OAAA;AACL,uHAAA,0BAA0B,OAAA;AAC1B,iGAAA,IAAI,OAAA;AACJ,qGAAA,QAAQ,OAAA;AAEV,+CAIwB;AAHtB,gHAAA,gBAAgB,OAAA;AAChB,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AAEnB,mCAA4D;AAAnD,0HAAA,gCAAgC,OAAA;AACzC,uCAA6E;AAApE,4HAAA,gCAAgC,OAAA;AAAE,yGAAA,aAAa,OAAA","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 '../instance';\n\nexport {\n  combineClassNames,\n  container,\n  css,\n  decls,\n  globalStylesFromFlattened,\n  isVariantMarked,\n  mapDomain,\n  media,\n  pendingHandleFromFlattened,\n  rule,\n  variants,\n} from './authoring';\nexport {\n  computeValueDeps,\n  isEmptyDeclarations,\n  stringifyCssValue,\n} from './declarations';\nexport { createStyleModuleWithEnvironment } from './module';\nexport { readableVarOwnersFromEnvironment, StyleRegistry } from './registry';\nexport type {\n  ContextualVarPath,\n  CssValue,\n  CssVarPath,\n  DeclarationSegment,\n  Declarations,\n  DefaultGroupDeps,\n  DefaultKeyDeps,\n  LocalVarDefaultMarker,\n  LocalVarGroup,\n  LocalVarMarker,\n  LocalVarOverrideMarker,\n  LocalVarRef,\n  MutableStyleDeps,\n  PendingStyleHandle,\n  PrimitiveStyleAuthoringApi,\n  ResolvedStyles,\n  RuleOptions,\n  StyleAuthoringApi,\n  StyleDeps,\n  StyleEntry,\n  StyleHandle,\n  StyleMedia,\n  StyleRegistrySnapshot,\n  StyleRule,\n  StylesModule,\n  StylesObject,\n  StyleSelectorResolver,\n} from './types';\n"]}

package/dist/cjs/styles/module.js

@@ -0,0 +1,233 @@
+"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.createStyleModuleWithEnvironment = void 0;
+const idents_1 = require("../idents");
+const local_vars_1 = require("../local_vars");
+const authoring_1 = require("./authoring");
+const createStyleModuleWithEnvironment = (environment, registry, name, factory) => {
+    (0, idents_1.assertCssIdentSegment)(name, 'Style module name');
+    const t = createAuthoringApi(environment, name);
+    const authored = factory(t);
+    const entries = [];
+    const handleList = [];
+    const themeDeps = new Set();
+    const varDeps = new Set();
+    assignEntries(name, authored, [], entries, handleList, themeDeps, varDeps);
+    recordRuleDeps(entries, handleList);
+    const module = {
+        name,
+        handles: authored,
+        entries,
+        handleList,
+        themeDeps,
+        varDeps,
+    };
+    registry.registerModule(module);
+    return module;
+};
+exports.createStyleModuleWithEnvironment = createStyleModuleWithEnvironment;
+const createAuthoringApi = (environment, moduleName) => ({
+    css: authoring_1.css,
+    decls: authoring_1.decls,
+    vars: (group, defaults) => (0, local_vars_1.createLocalVarGroup)(environment.prefix, moduleName, group, defaults),
+    tokens: environment.tokens,
+});
+const assignEntries = (moduleName, value, path, entries, handles, themeDeps, varDeps, inheritedVariant = false) => {
+    // A value is considered "variant" when either the immediate node was
+    // produced inside a `variants(...)` factory, or it sits beneath a parent
+    // `variants(...)` record (covers nested handles inside a per-variant
+    // object literal). The flag is sticky once set during the walk.
+    const variantHere = inheritedVariant || (0, authoring_1.isVariantMarked)(value);
+    if (isPendingHandle(value)) {
+        const localName = path.join('/');
+        const handle = {
+            kind: 'handle',
+            moduleName,
+            localName,
+            key: `${moduleName}/${localName}`,
+            readableName: `${moduleName}-${path.join('-')}`,
+            declarations: value.declarations,
+            variant: variantHere,
+            resolveClassName: (context) => context.resolveClassName(handle),
+        };
+        entries.push(handle);
+        handles.push(handle);
+        copyDeps(value.declarations.deps, themeDeps, varDeps);
+        if (value.nested && value.nested.length > 0) {
+            expandNestedEntries(moduleName, handle, value.nested, variantHere, entries, themeDeps, varDeps);
+        }
+        return handle;
+    }
+    if (isRule(value)) {
+        const keyedRule = {
+            ...value,
+            moduleName,
+            key: `${moduleName}/${path.join('/')}`,
+            variant: variantHere,
+        };
+        entries.push(keyedRule);
+        copyDeps(value.declarations.deps, themeDeps, varDeps);
+        return keyedRule;
+    }
+    if (isMedia(value)) {
+        const mediaKey = `${moduleName}/${path.join('/')}`;
+        const keyedMedia = {
+            ...value,
+            key: mediaKey,
+            moduleName,
+            variant: variantHere,
+            rules: value.rules.map((child, index) => ({
+                ...child,
+                moduleName,
+                key: `${mediaKey}/${index}`,
+                variant: variantHere,
+            })),
+        };
+        entries.push(keyedMedia);
+        for (const child of keyedMedia.rules) {
+            copyDeps(child.declarations.deps, themeDeps, varDeps);
+        }
+        return keyedMedia;
+    }
+    if (value && typeof value === 'object') {
+        for (const [key, child] of Object.entries(value)) {
+            (0, idents_1.assertCssIdentSegment)(key, `Style module "${moduleName}" key`);
+            const assigned = assignEntries(moduleName, child, [...path, key], entries, handles, themeDeps, varDeps, variantHere);
+            if (assigned) {
+                value[key] = assigned;
+            }
+        }
+    }
+    return value;
+};
+const MAX_NESTED_SIBLINGS = 1000;
+// Zero-padded so `collectedEntries` (lexicographic sort) preserves source order past 9 siblings.
+const paddedIndex = (index) => {
+    if (index >= MAX_NESTED_SIBLINGS) {
+        throw new Error(`A single css template cannot have more than ${MAX_NESTED_SIBLINGS} nested blocks.`);
+    }
+    return String(index).padStart(3, '0');
+};
+const composeNestedSelector = (self, alternatives) => (h) => alternatives
+    .map((parts) => parts
+    .map((part) => typeof part === 'string'
+    ? part.replaceAll('&', `.${h(self)}`)
+    : `.${h(part)}`)
+    .join(''))
+    .join(',');
+const expandNestedEntries = (moduleName, self, nested, variant, entries, themeDeps, varDeps) => {
+    nested.forEach((entry, index) => {
+        const key = `${self.key}/&/${paddedIndex(index)}`;
+        if (entry.kind === 'nested-rule') {
+            entries.push(makeNestedRule(moduleName, key, self, entry, variant, themeDeps, varDeps));
+            return;
+        }
+        const rules = [];
+        if (entry.self) {
+            rules.push(makeNestedRule(moduleName, `${key}/${paddedIndex(0)}`, self, {
+                kind: 'nested-rule',
+                alternatives: [['&']],
+                declarations: entry.self,
+            }, variant, themeDeps, varDeps));
+        }
+        entry.rules.forEach((rule, ruleIndex) => {
+            rules.push(makeNestedRule(moduleName, `${key}/${paddedIndex(ruleIndex + (entry.self ? 1 : 0))}`, self, rule, variant, themeDeps, varDeps));
+        });
+        entries.push({
+            kind: 'media',
+            key,
+            moduleName,
+            query: entry.query,
+            rules,
+            variant,
+        });
+    });
+};
+const makeNestedRule = (moduleName, key, self, rule, variant, themeDeps, varDeps) => {
+    copyDeps(rule.declarations.deps, themeDeps, varDeps);
+    return {
+        kind: 'rule',
+        moduleName,
+        key,
+        selector: composeNestedSelector(self, rule.alternatives),
+        declarations: rule.declarations,
+        dependsOn: authoring_1.EMPTY_DEPS,
+        auto: true,
+        variant,
+    };
+};
+const recordRuleDeps = (entries, handles) => {
+    if (entries.length === 0) {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.kind === 'rule') {
+            assignDependsOn(entry, computeRuleDeps(entry, handles));
+            continue;
+        }
+        if (entry.kind === 'media') {
+            for (const nested of entry.rules) {
+                assignDependsOn(nested, computeRuleDeps(nested, handles));
+            }
+        }
+    }
+};
+const assignDependsOn = (rule, dependsOn) => {
+    rule.dependsOn = dependsOn;
+};
+const computeRuleDeps = (rule, handles) => {
+    const accessed = new Set();
+    const trackingResolver = ((handle) => {
+        accessed.add(handle.key);
+        return `.${handle.readableName}`;
+    });
+    for (const handle of handles) {
+        defineTrackingAlias(trackingResolver, handle.localName, handle, accessed);
+        const leafName = handle.localName.split('/').at(-1);
+        if (leafName && leafName !== handle.localName) {
+            defineTrackingAlias(trackingResolver, leafName, handle, accessed);
+        }
+    }
+    try {
+        rule.selector(trackingResolver);
+    }
+    catch {
+        // Selector factories are expected to be pure string-builders, but a
+        // factory that throws on dummy input shouldn't break module construction.
+        // The dep set stays whatever was recorded before the throw.
+    }
+    return accessed;
+};
+const defineTrackingAlias = (resolver, name, handle, accessed) => {
+    if (!/^[A-Za-z_$][\w$]*$/.test(name) || name in resolver) {
+        return;
+    }
+    Object.defineProperty(resolver, name, {
+        configurable: true,
+        enumerable: true,
+        get: () => {
+            accessed.add(handle.key);
+            return `.${handle.readableName}`;
+        },
+    });
+};
+const copyDeps = (deps, themeDeps, varDeps) => {
+    deps.theme.forEach((path) => themeDeps.add(path));
+    deps.vars.forEach((path) => varDeps.add(path));
+};
+const isPendingHandle = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    value.kind === 'pending-handle');
+const isRule = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    value.kind === 'rule');
+const isMedia = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    value.kind === 'media');
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/styles/module.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 { DistilleryEnvironment } from '../environment';\nimport { assertCssIdentSegment } from '../idents';\nimport { createLocalVarGroup, type LocalVarGroup } from '../local_vars';\nimport type { SelectorAlternative } from '../nesting';\n\nimport { css, decls, EMPTY_DEPS, isVariantMarked } from './authoring';\nimport type { StyleRegistry } from './registry';\nimport type {\n  ContextualVarPath,\n  CssValue,\n  PendingEntry,\n  PendingNested,\n  PendingNestedRule,\n  PendingStyleHandle,\n  ResolvedStyles,\n  StyleAuthoringApi,\n  StyleDeps,\n  StyleEntry,\n  StyleHandle,\n  StyleMedia,\n  StyleRule,\n  StyleSelectorResolver,\n  StylesModule,\n  StylesObject,\n} from './types';\n\nexport const createStyleModuleWithEnvironment = <\n  TTokens,\n  TStyles extends StylesObject,\n>(\n  environment: DistilleryEnvironment<TTokens>,\n  registry: StyleRegistry,\n  name: string,\n  factory: (t: StyleAuthoringApi<TTokens>) => TStyles\n): StylesModule<ResolvedStyles<TStyles>> => {\n  assertCssIdentSegment(name, 'Style module name');\n  const t = createAuthoringApi(environment, name);\n  const authored = factory(t);\n  const entries: StyleEntry[] = [];\n  const handleList: StyleHandle[] = [];\n  const themeDeps = new Set<string>();\n  const varDeps = new Set<ContextualVarPath>();\n\n  assignEntries(name, authored, [], entries, handleList, themeDeps, varDeps);\n  recordRuleDeps(entries, handleList);\n\n  const module: StylesModule<ResolvedStyles<TStyles>> = {\n    name,\n    handles: authored as ResolvedStyles<TStyles>,\n    entries,\n    handleList,\n    themeDeps,\n    varDeps,\n  };\n  registry.registerModule(module);\n  return module;\n};\n\nconst createAuthoringApi = <TTokens>(\n  environment: DistilleryEnvironment<TTokens>,\n  moduleName: string\n): StyleAuthoringApi<TTokens> => ({\n  css,\n  decls,\n  vars: <TKey extends string>(\n    group: string,\n    defaults: Record<TKey, CssValue>\n  ): LocalVarGroup<TKey> =>\n    createLocalVarGroup(environment.prefix, moduleName, group, defaults),\n  tokens: environment.tokens,\n});\n\nconst assignEntries = (\n  moduleName: string,\n  value: unknown,\n  path: readonly string[],\n  entries: StyleEntry[],\n  handles: StyleHandle[],\n  themeDeps: Set<string>,\n  varDeps: Set<ContextualVarPath>,\n  inheritedVariant = false\n): unknown => {\n  // A value is considered \"variant\" when either the immediate node was\n  // produced inside a `variants(...)` factory, or it sits beneath a parent\n  // `variants(...)` record (covers nested handles inside a per-variant\n  // object literal). The flag is sticky once set during the walk.\n  const variantHere = inheritedVariant || isVariantMarked(value);\n\n  if (isPendingHandle(value)) {\n    const localName = path.join('/');\n    const handle: StyleHandle = {\n      kind: 'handle',\n      moduleName,\n      localName,\n      key: `${moduleName}/${localName}`,\n      readableName: `${moduleName}-${path.join('-')}`,\n      declarations: value.declarations,\n      variant: variantHere,\n      resolveClassName: (context) => context.resolveClassName(handle),\n    };\n    entries.push(handle);\n    handles.push(handle);\n    copyDeps(value.declarations.deps, themeDeps, varDeps);\n    if (value.nested && value.nested.length > 0) {\n      expandNestedEntries(\n        moduleName,\n        handle,\n        value.nested,\n        variantHere,\n        entries,\n        themeDeps,\n        varDeps\n      );\n    }\n    return handle;\n  }\n\n  if (isRule(value)) {\n    const keyedRule: StyleRule = {\n      ...value,\n      moduleName,\n      key: `${moduleName}/${path.join('/')}`,\n      variant: variantHere,\n    };\n    entries.push(keyedRule);\n    copyDeps(value.declarations.deps, themeDeps, varDeps);\n    return keyedRule;\n  }\n\n  if (isMedia(value)) {\n    const mediaKey = `${moduleName}/${path.join('/')}`;\n    const keyedMedia: StyleMedia = {\n      ...value,\n      key: mediaKey,\n      moduleName,\n      variant: variantHere,\n      rules: value.rules.map((child, index) => ({\n        ...child,\n        moduleName,\n        key: `${mediaKey}/${index}`,\n        variant: variantHere,\n      })),\n    };\n    entries.push(keyedMedia);\n    for (const child of keyedMedia.rules) {\n      copyDeps(child.declarations.deps, themeDeps, varDeps);\n    }\n    return keyedMedia;\n  }\n\n  if (value && typeof value === 'object') {\n    for (const [key, child] of Object.entries(value)) {\n      assertCssIdentSegment(key, `Style module \"${moduleName}\" key`);\n      const assigned = assignEntries(\n        moduleName,\n        child,\n        [...path, key],\n        entries,\n        handles,\n        themeDeps,\n        varDeps,\n        variantHere\n      );\n      if (assigned) {\n        (value as Record<string, unknown>)[key] = assigned;\n      }\n    }\n  }\n\n  return value;\n};\n\nconst MAX_NESTED_SIBLINGS = 1000;\n\n// Zero-padded so `collectedEntries` (lexicographic sort) preserves source order past 9 siblings.\nconst paddedIndex = (index: number): string => {\n  if (index >= MAX_NESTED_SIBLINGS) {\n    throw new Error(\n      `A single css template cannot have more than ${MAX_NESTED_SIBLINGS} nested blocks.`\n    );\n  }\n  return String(index).padStart(3, '0');\n};\n\nconst composeNestedSelector =\n  (self: StyleHandle, alternatives: readonly SelectorAlternative[]) =>\n  (h: StyleSelectorResolver): string =>\n    alternatives\n      .map((parts) =>\n        parts\n          .map((part) =>\n            typeof part === 'string'\n              ? part.replaceAll('&', `.${h(self)}`)\n              : `.${h(part)}`\n          )\n          .join('')\n      )\n      .join(',');\n\nconst expandNestedEntries = (\n  moduleName: string,\n  self: StyleHandle,\n  nested: readonly PendingNested[],\n  variant: boolean,\n  entries: StyleEntry[],\n  themeDeps: Set<string>,\n  varDeps: Set<ContextualVarPath>\n): void => {\n  nested.forEach((entry, index) => {\n    const key = `${self.key}/&/${paddedIndex(index)}`;\n    if (entry.kind === 'nested-rule') {\n      entries.push(\n        makeNestedRule(\n          moduleName,\n          key,\n          self,\n          entry,\n          variant,\n          themeDeps,\n          varDeps\n        )\n      );\n      return;\n    }\n    const rules: StyleRule[] = [];\n    if (entry.self) {\n      rules.push(\n        makeNestedRule(\n          moduleName,\n          `${key}/${paddedIndex(0)}`,\n          self,\n          {\n            kind: 'nested-rule',\n            alternatives: [['&']],\n            declarations: entry.self,\n          },\n          variant,\n          themeDeps,\n          varDeps\n        )\n      );\n    }\n    entry.rules.forEach((rule, ruleIndex) => {\n      rules.push(\n        makeNestedRule(\n          moduleName,\n          `${key}/${paddedIndex(ruleIndex + (entry.self ? 1 : 0))}`,\n          self,\n          rule,\n          variant,\n          themeDeps,\n          varDeps\n        )\n      );\n    });\n    entries.push({\n      kind: 'media',\n      key,\n      moduleName,\n      query: entry.query,\n      rules,\n      variant,\n    });\n  });\n};\n\nconst makeNestedRule = (\n  moduleName: string,\n  key: string,\n  self: StyleHandle,\n  rule: PendingNestedRule,\n  variant: boolean,\n  themeDeps: Set<string>,\n  varDeps: Set<ContextualVarPath>\n): StyleRule => {\n  copyDeps(rule.declarations.deps, themeDeps, varDeps);\n  return {\n    kind: 'rule',\n    moduleName,\n    key,\n    selector: composeNestedSelector(self, rule.alternatives),\n    declarations: rule.declarations,\n    dependsOn: EMPTY_DEPS,\n    auto: true,\n    variant,\n  };\n};\n\nconst recordRuleDeps = (\n  entries: readonly StyleEntry[],\n  handles: readonly StyleHandle[]\n): void => {\n  if (entries.length === 0) {\n    return;\n  }\n  for (const entry of entries) {\n    if (entry.kind === 'rule') {\n      assignDependsOn(entry, computeRuleDeps(entry, handles));\n      continue;\n    }\n    if (entry.kind === 'media') {\n      for (const nested of entry.rules) {\n        assignDependsOn(nested, computeRuleDeps(nested, handles));\n      }\n    }\n  }\n};\n\nconst assignDependsOn = (\n  rule: StyleRule,\n  dependsOn: ReadonlySet<string>\n): void => {\n  (rule as { dependsOn: ReadonlySet<string> }).dependsOn = dependsOn;\n};\n\nconst computeRuleDeps = (\n  rule: StyleRule,\n  handles: readonly StyleHandle[]\n): ReadonlySet<string> => {\n  const accessed = new Set<string>();\n  const trackingResolver = ((handle: StyleHandle) => {\n    accessed.add(handle.key);\n    return `.${handle.readableName}`;\n  }) as StyleSelectorResolver;\n  for (const handle of handles) {\n    defineTrackingAlias(trackingResolver, handle.localName, handle, accessed);\n    const leafName = handle.localName.split('/').at(-1);\n    if (leafName && leafName !== handle.localName) {\n      defineTrackingAlias(trackingResolver, leafName, handle, accessed);\n    }\n  }\n  try {\n    rule.selector(trackingResolver);\n  } catch {\n    // Selector factories are expected to be pure string-builders, but a\n    // factory that throws on dummy input shouldn't break module construction.\n    // The dep set stays whatever was recorded before the throw.\n  }\n  return accessed;\n};\n\nconst defineTrackingAlias = (\n  resolver: StyleSelectorResolver,\n  name: string,\n  handle: StyleHandle,\n  accessed: Set<string>\n): void => {\n  if (!/^[A-Za-z_$][\\w$]*$/.test(name) || name in resolver) {\n    return;\n  }\n  Object.defineProperty(resolver, name, {\n    configurable: true,\n    enumerable: true,\n    get: () => {\n      accessed.add(handle.key);\n      return `.${handle.readableName}`;\n    },\n  });\n};\n\nconst copyDeps = (\n  deps: StyleDeps,\n  themeDeps: Set<string>,\n  varDeps: Set<ContextualVarPath>\n): void => {\n  deps.theme.forEach((path) => themeDeps.add(path));\n  deps.vars.forEach((path) => varDeps.add(path));\n};\n\nconst isPendingHandle = (value: unknown): value is PendingStyleHandle =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as PendingEntry).kind === 'pending-handle'\n  );\n\nconst isRule = (value: unknown): value is StyleRule =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as PendingEntry).kind === 'rule'\n  );\n\nconst isMedia = (value: unknown): value is StyleMedia =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as PendingEntry).kind === 'media'\n  );\n"]}

package/dist/cjs/styles/registry.js

@@ -0,0 +1,187 @@
+"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.readableVarOwnersFromEnvironment = exports.StyleRegistry = void 0;
+const names_1 = require("../names");
+/**
+ * Registered style modules for one distillery. Throws on duplicate module names or colliding readable class/var names.
+ */
+class StyleRegistry {
+    prefix;
+    reservedVarOwners;
+    sharedVarPaths;
+    modulesByName = new Map();
+    targetedKeys;
+    constructor(prefix, reservedVarOwners = new Map(), sharedVarPaths = new Set()) {
+        this.prefix = prefix;
+        this.reservedVarOwners = reservedVarOwners;
+        this.sharedVarPaths = sharedVarPaths;
+    }
+    /**
+     * Adds `module` to this registry.
+     *
+     * @throws If another module already uses this name, or if a readable class or CSS-variable name collides (including `themeVars` and `sharedVars`).
+     */
+    registerModule(module) {
+        const existing = this.modulesByName.get(module.name);
+        if (existing === module) {
+            return;
+        }
+        if (existing) {
+            throw new Error(`Style module "${module.name}" is already registered.`);
+        }
+        assertReadableNameCollisions(this.prefix, this.reservedVarOwners, this.sharedVarPaths, this.modulesByName.values(), module);
+        this.modulesByName.set(module.name, module);
+        this.targetedKeys = undefined;
+    }
+    /**
+     * True when some rule, or some inner rule of an `@media` / `@container` block, reads `key` in its selector.
+     *
+     * A nested `&` rule records its owning handle through `recordRuleDeps`, so a handle with an empty self block but real nested rules is targeted. A rule-less nested block targets nothing.
+     */
+    targetsHandle(key) {
+        return this.targetedHandleKeys().has(key);
+    }
+    targetedHandleKeys() {
+        if (this.targetedKeys) {
+            return this.targetedKeys;
+        }
+        const keys = new Set();
+        for (const module of this.modulesByName.values()) {
+            for (const entry of module.entries) {
+                if (entry.kind === 'rule') {
+                    entry.dependsOn.forEach((dep) => keys.add(dep));
+                }
+                else if (entry.kind === 'media') {
+                    for (const inner of entry.rules) {
+                        inner.dependsOn.forEach((dep) => keys.add(dep));
+                    }
+                }
+            }
+        }
+        this.targetedKeys = keys;
+        return keys;
+    }
+    /** Registered modules, sorted by name. */
+    get modules() {
+        return [...this.modulesByName.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /** Looks up a module by the name passed to `createStyleModule`. */
+    module(name) {
+        return this.modulesByName.get(name);
+    }
+    /** Handle keys across all modules. Compact-name domain for a full stylesheet. */
+    get classKeys() {
+        return this.modules.flatMap((module) => module.handleList.map((handle) => handle.key));
+    }
+    /** Theme and contextual-var keys across all modules. */
+    get cssVarKeys() {
+        const keys = new Set();
+        for (const module of this.modules) {
+            module.themeDeps.forEach((path) => keys.add(path));
+            module.varDeps.forEach((path) => keys.add(path));
+        }
+        return [...keys].sort();
+    }
+    /**
+     * Frozen class and CSS-var keys for a {@link StyleNameResolver}.
+     *
+     * @param options Overrides the registry-wide key sets when compact-naming a subset.
+     */
+    freeze(options = {}) {
+        return Object.freeze({
+            classKeys: Object.freeze(sortedUnique(options.classKeys ?? this.classKeys)),
+            cssVarKeys: Object.freeze(sortedUnique(options.cssVarKeys ?? this.cssVarKeys)),
+        });
+    }
+}
+exports.StyleRegistry = StyleRegistry;
+const sortedUnique = (values) => [...new Set(values)].sort();
+const claimReadableVar = (owners, name, owner) => {
+    const prior = owners.get(name);
+    if (prior) {
+        throw new Error(`Readable CSS variable "${name}" collides between ${prior} and ${owner}.`);
+    }
+    owners.set(name, owner);
+};
+/** Readable custom-property names already claimed by `themeVars` / `sharedVars`. */
+const readableVarOwnersFromEnvironment = (environment) => {
+    const owners = new Map();
+    const { prefix } = environment;
+    for (const path of Object.keys(environment.themeVars)) {
+        claimReadableVar(owners, (0, names_1.cssVarName)(prefix, path), `theme var "${path}"`);
+    }
+    for (const path of environment.sharedVars ?? []) {
+        claimReadableVar(owners, (0, names_1.cssVarName)(prefix, path), `shared var "${path}"`);
+    }
+    return owners;
+};
+exports.readableVarOwnersFromEnvironment = readableVarOwnersFromEnvironment;
+const assertReadableNameCollisions = (prefix, reservedVarOwners, sharedVarPaths, existing, incoming) => {
+    const classOwners = new Map();
+    const reservedOwners = new Map(reservedVarOwners);
+    const localVarOwners = new Map();
+    const index = (module) => {
+        for (const handle of module.handleList) {
+            const prior = classOwners.get(handle.readableName);
+            if (prior) {
+                throw new Error(`Readable class name "${handle.readableName}" collides between ${prior} and module "${module.name}" handle "${handle.localName}".`);
+            }
+            classOwners.set(handle.readableName, `module "${module.name}" handle "${handle.localName}"`);
+        }
+        for (const path of localVarPathsOf(module, sharedVarPaths)) {
+            const name = (0, names_1.cssVarName)(prefix, path);
+            const owner = `module "${module.name}" var "${path}"`;
+            const reserved = reservedOwners.get(name);
+            if (reserved) {
+                throw new Error(`Readable CSS variable "${name}" collides between ${reserved} and ${owner}.`);
+            }
+            const prior = localVarOwners.get(name);
+            if (prior && prior.path !== path) {
+                throw new Error(`Readable CSS variable "${name}" collides between ${prior.owner} and ${owner}.`);
+            }
+            localVarOwners.set(name, { path, owner });
+        }
+    };
+    for (const module of existing) {
+        index(module);
+    }
+    index(incoming);
+};
+// `deps.vars` records every contextual var a module *references*, which includes
+// shared ones the module does not own. A shared path synthesizes the same
+// readable name as a local var would, so leaving them in makes two modules that
+// merely reference one shared var collide on it. The same exclusion is applied
+// when compaction maps readable names to compact ones.
+const localVarPathsOf = (module, sharedVarPaths) => {
+    const paths = new Set();
+    const addFrom = (declarations) => {
+        declarations.deps.vars.forEach((path) => {
+            if (!sharedVarPaths.has(path)) {
+                paths.add(path);
+            }
+        });
+        for (const group of declarations.deps.defaults) {
+            for (const item of group.keys) {
+                paths.add(item.path);
+            }
+        }
+    };
+    for (const entry of module.entries) {
+        if (entry.kind === 'handle' || entry.kind === 'rule') {
+            addFrom(entry.declarations);
+        }
+        else {
+            for (const nested of entry.rules) {
+                addFrom(nested.declarations);
+            }
+        }
+    }
+    return [...paths];
+};
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/styles/registry.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 { DistilleryEnvironment } from '../environment';\nimport { cssVarName } from '../names';\n\nimport type {\n  ContextualVarPath,\n  CssVarPath,\n  Declarations,\n  StyleRegistrySnapshot,\n  StylesModule,\n} from './types';\n\n/**\n * Registered style modules for one distillery. Throws on duplicate module names or colliding readable class/var names.\n */\nexport class StyleRegistry {\n  private readonly modulesByName = new Map<string, StylesModule>();\n  private targetedKeys: Set<string> | undefined;\n\n  constructor(\n    private readonly prefix: string,\n    private readonly reservedVarOwners: ReadonlyMap<string, string> = new Map(),\n    private readonly sharedVarPaths: ReadonlySet<string> = new Set()\n  ) {}\n\n  /**\n   * Adds `module` to this registry.\n   *\n   * @throws If another module already uses this name, or if a readable class or CSS-variable name collides (including `themeVars` and `sharedVars`).\n   */\n  registerModule(module: StylesModule): void {\n    const existing = this.modulesByName.get(module.name);\n    if (existing === module) {\n      return;\n    }\n    if (existing) {\n      throw new Error(`Style module \"${module.name}\" is already registered.`);\n    }\n    assertReadableNameCollisions(\n      this.prefix,\n      this.reservedVarOwners,\n      this.sharedVarPaths,\n      this.modulesByName.values(),\n      module\n    );\n    this.modulesByName.set(module.name, module);\n    this.targetedKeys = undefined;\n  }\n\n  /**\n   * True when some rule, or some inner rule of an `@media` / `@container` block, reads `key` in its selector.\n   *\n   * A nested `&` rule records its owning handle through `recordRuleDeps`, so a handle with an empty self block but real nested rules is targeted. A rule-less nested block targets nothing.\n   */\n  targetsHandle(key: string): boolean {\n    return this.targetedHandleKeys().has(key);\n  }\n\n  private targetedHandleKeys(): Set<string> {\n    if (this.targetedKeys) {\n      return this.targetedKeys;\n    }\n    const keys = new Set<string>();\n    for (const module of this.modulesByName.values()) {\n      for (const entry of module.entries) {\n        if (entry.kind === 'rule') {\n          entry.dependsOn.forEach((dep) => keys.add(dep));\n        } else if (entry.kind === 'media') {\n          for (const inner of entry.rules) {\n            inner.dependsOn.forEach((dep) => keys.add(dep));\n          }\n        }\n      }\n    }\n    this.targetedKeys = keys;\n    return keys;\n  }\n\n  /** Registered modules, sorted by name. */\n  get modules(): readonly StylesModule[] {\n    return [...this.modulesByName.values()].sort((a, b) =>\n      a.name.localeCompare(b.name)\n    );\n  }\n\n  /** Looks up a module by the name passed to `createStyleModule`. */\n  module(name: string): StylesModule | undefined {\n    return this.modulesByName.get(name);\n  }\n\n  /** Handle keys across all modules. Compact-name domain for a full stylesheet. */\n  get classKeys(): readonly string[] {\n    return this.modules.flatMap((module) =>\n      module.handleList.map((handle) => handle.key)\n    );\n  }\n\n  /** Theme and contextual-var keys across all modules. */\n  get cssVarKeys(): readonly CssVarPath[] {\n    const keys = new Set<CssVarPath>();\n    for (const module of this.modules) {\n      module.themeDeps.forEach((path) => keys.add(path));\n      module.varDeps.forEach((path) => keys.add(path));\n    }\n    return [...keys].sort();\n  }\n\n  /**\n   * Frozen class and CSS-var keys for a {@link StyleNameResolver}.\n   *\n   * @param options Overrides the registry-wide key sets when compact-naming a subset.\n   */\n  freeze(\n    options: {\n      /** Compact class-name domain override. */\n      classKeys?: Iterable<string>;\n      /** Compact CSS-var domain override. */\n      cssVarKeys?: Iterable<CssVarPath>;\n    } = {}\n  ): StyleRegistrySnapshot {\n    return Object.freeze({\n      classKeys: Object.freeze(\n        sortedUnique(options.classKeys ?? this.classKeys)\n      ),\n      cssVarKeys: Object.freeze(\n        sortedUnique(options.cssVarKeys ?? this.cssVarKeys)\n      ),\n    });\n  }\n}\n\nconst sortedUnique = <TValue extends string>(\n  values: Iterable<TValue>\n): readonly TValue[] => [...new Set(values)].sort();\n\nconst claimReadableVar = (\n  owners: Map<string, string>,\n  name: string,\n  owner: string\n): void => {\n  const prior = owners.get(name);\n  if (prior) {\n    throw new Error(\n      `Readable CSS variable \"${name}\" collides between ${prior} and ${owner}.`\n    );\n  }\n  owners.set(name, owner);\n};\n\n/** Claimed readable custom-property name and the owner that registered it. */\ninterface ReadableLocalVarOwner {\n  /** Canonical variable path. */\n  readonly path: ContextualVarPath;\n  /** Human-readable owner used in collision errors. */\n  readonly owner: string;\n}\n\n/** Readable custom-property names already claimed by `themeVars` / `sharedVars`. */\nexport const readableVarOwnersFromEnvironment = (\n  environment: Pick<\n    DistilleryEnvironment,\n    'prefix' | 'themeVars' | 'sharedVars'\n  >\n): ReadonlyMap<string, string> => {\n  const owners = new Map<string, string>();\n  const { prefix } = environment;\n  for (const path of Object.keys(environment.themeVars)) {\n    claimReadableVar(owners, cssVarName(prefix, path), `theme var \"${path}\"`);\n  }\n  for (const path of environment.sharedVars ?? []) {\n    claimReadableVar(owners, cssVarName(prefix, path), `shared var \"${path}\"`);\n  }\n  return owners;\n};\n\nconst assertReadableNameCollisions = (\n  prefix: string,\n  reservedVarOwners: ReadonlyMap<string, string>,\n  sharedVarPaths: ReadonlySet<string>,\n  existing: Iterable<StylesModule>,\n  incoming: StylesModule\n): void => {\n  const classOwners = new Map<string, string>();\n  const reservedOwners = new Map(reservedVarOwners);\n  const localVarOwners = new Map<string, ReadableLocalVarOwner>();\n  const index = (module: StylesModule): void => {\n    for (const handle of module.handleList) {\n      const prior = classOwners.get(handle.readableName);\n      if (prior) {\n        throw new Error(\n          `Readable class name \"${handle.readableName}\" collides between ${prior} and module \"${module.name}\" handle \"${handle.localName}\".`\n        );\n      }\n      classOwners.set(\n        handle.readableName,\n        `module \"${module.name}\" handle \"${handle.localName}\"`\n      );\n    }\n    for (const path of localVarPathsOf(module, sharedVarPaths)) {\n      const name = cssVarName(prefix, path);\n      const owner = `module \"${module.name}\" var \"${path}\"`;\n      const reserved = reservedOwners.get(name);\n      if (reserved) {\n        throw new Error(\n          `Readable CSS variable \"${name}\" collides between ${reserved} and ${owner}.`\n        );\n      }\n      const prior = localVarOwners.get(name);\n      if (prior && prior.path !== path) {\n        throw new Error(\n          `Readable CSS variable \"${name}\" collides between ${prior.owner} and ${owner}.`\n        );\n      }\n      localVarOwners.set(name, { path, owner });\n    }\n  };\n  for (const module of existing) {\n    index(module);\n  }\n  index(incoming);\n};\n\n// `deps.vars` records every contextual var a module *references*, which includes\n// shared ones the module does not own. A shared path synthesizes the same\n// readable name as a local var would, so leaving them in makes two modules that\n// merely reference one shared var collide on it. The same exclusion is applied\n// when compaction maps readable names to compact ones.\nconst localVarPathsOf = (\n  module: StylesModule,\n  sharedVarPaths: ReadonlySet<string>\n): readonly ContextualVarPath[] => {\n  const paths = new Set<ContextualVarPath>();\n  const addFrom = (declarations: Declarations): void => {\n    declarations.deps.vars.forEach((path) => {\n      if (!sharedVarPaths.has(path)) {\n        paths.add(path);\n      }\n    });\n    for (const group of declarations.deps.defaults) {\n      for (const item of group.keys) {\n        paths.add(item.path);\n      }\n    }\n  };\n  for (const entry of module.entries) {\n    if (entry.kind === 'handle' || entry.kind === 'rule') {\n      addFrom(entry.declarations);\n    } else {\n      for (const nested of entry.rules) {\n        addFrom(nested.declarations);\n      }\n    }\n  }\n  return [...paths];\n};\n"]}

package/dist/cjs/styles/types.js

@@ -0,0 +1,9 @@
+"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 });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/styles/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG","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 {\n  LocalVarDefaultMarker,\n  LocalVarGroup,\n  LocalVarMarker,\n  LocalVarOverrideMarker,\n  LocalVarRef,\n} from '../local_vars';\nimport type { SelectorAlternative } from '../nesting';\nimport type {\n  ContextualCssVar,\n  ContextualCssVarName,\n  CssToken,\n  ScaleToken,\n} from '../tokens';\n\nexport type {\n  LocalVarDefaultMarker,\n  LocalVarGroup,\n  LocalVarMarker,\n  LocalVarOverrideMarker,\n  LocalVarRef,\n};\n\n/** Canonical `vars/<group>/<key>` path for a contextual or module-local CSS variable. */\nexport type ContextualVarPath = `vars/${string}`;\n/** Theme-token path or any other CSS-var key the resolver knows. */\nexport type CssVarPath = string;\n\n/** Values accepted by `t.vars(...)` defaults and `.set(...)`. */\nexport type CssValue =\n  | string\n  | number\n  | CssToken\n  | ContextualCssVar\n  | ContextualCssVarName\n  | ScaleToken\n  | LocalVarRef;\n\n/** Reachability sets captured while authoring a declaration block. */\nexport interface StyleDeps {\n  /** Theme-token paths interpolated into this block. */\n  readonly theme: ReadonlySet<string>;\n  /** Unconditional writes and reads. Default-marker keys land here only when reachable. */\n  readonly vars: ReadonlySet<ContextualVarPath>;\n  /** Read-side `var(...)` paths. Drives default-emission reachability. */\n  readonly refs: ReadonlySet<ContextualVarPath>;\n  /** `t.vars(...)` default-emission sites, resolved after collection. */\n  readonly defaults: ReadonlyArray<DefaultGroupDeps>;\n}\n\n/** One `t.vars(...)` group's default-emission metadata. */\nexport interface DefaultGroupDeps {\n  /** Target variable namespace group. */\n  readonly groupPath: `vars/${string}`;\n  /** Defaults registered within this group. */\n  readonly keys: ReadonlyArray<DefaultKeyDeps>;\n}\n\n/** One key inside a {@link DefaultGroupDeps} group. */\nexport interface DefaultKeyDeps {\n  /** The specific variable key within the group. */\n  readonly key: string;\n  /** Full CSS variable path (e.g. `vars/group/key`). */\n  readonly path: ContextualVarPath;\n  /** Theme/var paths referenced by the default value. Kept if the key is reachable. */\n  readonly valueDeps: {\n    /** Theme-token paths the default value interpolates. */\n    readonly theme: ReadonlySet<string>;\n    /** Contextual-var paths the default value interpolates. */\n    readonly vars: ReadonlySet<ContextualVarPath>;\n  };\n}\n\n/** Mutable twin of {@link StyleDeps} used while scanning interpolations. */\nexport interface MutableStyleDeps {\n  /** Theme-token paths interpolated into this block. */\n  theme: Set<string>;\n  /** Unconditional writes and reads. */\n  vars: Set<ContextualVarPath>;\n  /** Read-side `var(...)` paths. */\n  refs: Set<ContextualVarPath>;\n  /** `t.vars(...)` default-emission sites. */\n  defaults: DefaultGroupDeps[];\n}\n\n/** Literal CSS text or a local-var interpolation marker. */\nexport type DeclarationSegment = string | LocalVarMarker;\n\n/** Authored CSS plus the deps the collector uses for reachability. */\nexport interface Declarations {\n  /** Interleaved literal CSS and local variable markers. */\n  readonly css: readonly DeclarationSegment[];\n  /** Reachability tracking dependencies. */\n  readonly deps: StyleDeps;\n}\n\n/** A named class: readable name, declarations, and collection identity. */\nexport interface StyleHandle {\n  /** Discriminant for {@link StyleEntry}. */\n  readonly kind: 'handle';\n  /** The registered module name this handle belongs to. */\n  readonly moduleName: string;\n  /** Leaf key if at root, or composed path for nested handles. */\n  readonly localName: string;\n  /** Full path joined by dots. */\n  readonly key: string;\n  /** Predictable name used for output CSS classes. */\n  readonly readableName: string;\n  /** CSS properties for this handle. */\n  readonly declarations: Declarations;\n  /** `true` when produced inside `variants(...)`. Skipped by {@link index.StylesCollector#use | StylesCollector.use}. */\n  readonly variant: boolean;\n  /** Produces the final class name via the provided resolver context. */\n  resolveClassName(context: {\n    /** Joins one or more handles into a class-name string. */\n    resolveClassName: (...handles: StyleHandle[]) => string;\n  }): string;\n}\n\n/** A selector plus declarations, optionally auto-collected from handle deps. */\nexport interface StyleRule {\n  /** Discriminant for {@link StyleEntry}. */\n  readonly kind: 'rule';\n  /** The registered module name this rule belongs to. */\n  readonly moduleName: string;\n  /** Unique key for this rule within the module. */\n  readonly key: string;\n  /** Selector string factory receiving a resolver for `&` and other handles. */\n  readonly selector: (h: StyleSelectorResolver) => string;\n  /** CSS properties for this rule. */\n  readonly declarations: Declarations;\n  /** `true` when produced inside `variants(...)`. */\n  readonly variant: boolean;\n  /** Handle keys this selector reads. Empty until `assignEntries` fills it. */\n  readonly dependsOn: ReadonlySet<string>;\n  /** When `false`, skip auto-collection; the caller must `use` the rule. */\n  readonly auto: boolean;\n}\n\n/** Options for {@link rule}. */\nexport interface RuleOptions {\n  /** When `false`, the collector must `use` this rule explicitly. Defaults to `true`. */\n  auto?: boolean;\n}\n\n/** `@media` or `@container` block wrapping inner {@link StyleRule}s. */\nexport interface StyleMedia {\n  /** Discriminant for {@link StyleEntry}. */\n  readonly kind: 'media';\n  /**\n   * At-rule this entry emits. `kind` stays `'media'` so collector rank and deps apply uniformly; see finding `media-block-ordering`.\n   */\n  readonly atRule?: 'media' | 'container';\n  /** Stable identity for deduplication across multiple renders. */\n  readonly key: string;\n  /** The registered module name this media block belongs to. */\n  readonly moduleName: string;\n  /** The conditional query (e.g. `(min-width: 600px)`). */\n  readonly query: string;\n  /** Inner rules collected inside this block. */\n  readonly rules: readonly StyleRule[];\n  /** `true` when produced inside `variants(...)`. */\n  readonly variant: boolean;\n}\n\n/** One registered handle, selector rule, or at-rule block. */\nexport type StyleEntry = StyleHandle | StyleRule | StyleMedia;\n/** Selector factory: call with a handle, or read sibling local names as `.class` strings. */\nexport type StyleSelectorResolver = ((handle: StyleHandle) => string) &\n  Record<string, string>;\n\n/** Named handle tree plus flat entries after `createStyleModule`. */\nexport interface StylesModule<TStyles = StylesObject> {\n  /** The unique registered name of the module. */\n  readonly name: string;\n  /** Authored tree of handles, rules, and media; variants nest as records. */\n  readonly handles: TStyles;\n  /** Flat list of style entries (handles, rules, media) defined in this module. */\n  readonly entries: readonly StyleEntry[];\n  /** Flat list of just the style handles defined in this module. */\n  readonly handleList: readonly StyleHandle[];\n  /** Aggregated theme dependencies across all entries. */\n  readonly themeDeps: ReadonlySet<string>;\n  /** Aggregated variable dependencies across all entries. */\n  readonly varDeps: ReadonlySet<ContextualVarPath>;\n}\n\n/** Authored module tree before {@link ResolvedStyles} substitution. */\nexport type StylesObject = Record<string, unknown>;\n/** Class and CSS-var key snapshot used to build a {@link StyleNameResolver}. */\nexport interface StyleRegistrySnapshot {\n  /** Collected readable class names from registered modules. */\n  readonly classKeys: readonly string[];\n  /** Collected custom property (CSS variable) keys. */\n  readonly cssVarKeys: readonly CssVarPath[];\n}\n\n/** Resolves nested pending handles, rules, and medias into their runtime types. */\nexport type ResolvedStyles<TValue> = TValue extends PendingStyleHandle\n  ? StyleHandle\n  : TValue extends StyleRule\n    ? StyleRule\n    : TValue extends StyleMedia\n      ? StyleMedia\n      : TValue extends readonly (infer TItem)[]\n        ? readonly ResolvedStyles<TItem>[]\n        : TValue extends Record<string, unknown>\n          ? { [TKey in keyof TValue]: ResolvedStyles<TValue[TKey]> }\n          : TValue;\n\n/** Authoring API passed to `createStyleModule` factories. */\nexport interface StyleAuthoringApi<TTokens = unknown> {\n  /** Creates a handle template where nested `&` and `@media` flatten into sibling rules. */\n  css: (\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ) => PendingStyleHandle;\n  /** Creates a declaration block template for direct CSS properties. */\n  decls: (\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ) => Declarations;\n  /** Module-local CSS variable group. Interpolate `${group}`, `${group.key}`, or `${group.set({...})}`. */\n  vars: <TKey extends string>(\n    group: string,\n    defaults: Record<TKey, CssValue>\n  ) => LocalVarGroup<TKey>;\n  /** Environment token tree. */\n  tokens: TTokens;\n}\n\n/** Authoring-time handle before module registration rewrites it to a {@link StyleHandle}. */\nexport interface PendingStyleHandle {\n  /** Discriminant for pending templates. */\n  readonly kind: 'pending-handle';\n  /** Declaration properties authored on this pending handle. */\n  readonly declarations: Declarations;\n  /** Nested `&` / `@media` rules expanded into sibling entries at registration. */\n  readonly nested?: readonly PendingNested[];\n}\n\n/** Nested `&` rule captured on a pending handle. */\nexport interface PendingNestedRule {\n  /** Discriminant for pending nested entries. */\n  readonly kind: 'nested-rule';\n  /** Comma alternatives relative to the parent handle. */\n  readonly alternatives: readonly SelectorAlternative[];\n  /** CSS properties for this nested rule. */\n  readonly declarations: Declarations;\n}\n\n/** Nested `@media` captured on a pending handle. */\nexport interface PendingNestedMedia {\n  /** Discriminant for pending nested entries. */\n  readonly kind: 'nested-media';\n  /** Media query text. */\n  readonly query: string;\n  /** Bare declarations inside the block, applied to the parent handle. */\n  readonly self?: Declarations;\n  /** Nested `&` rules inside this media block. */\n  readonly rules: readonly PendingNestedRule[];\n}\n\n/** Nested `&` rule or `@media` on a pending handle. */\nexport type PendingNested = PendingNestedRule | PendingNestedMedia;\n\n/** Pending handle or already-resolved rule/media during registration. */\nexport type PendingEntry = PendingStyleHandle | StyleRule | StyleMedia;\n\n/** Narrow `t` for `primitiveStyles`: handles and tokens only. */\nexport interface PrimitiveStyleAuthoringApi<TTokens = unknown> {\n  /** Creates named style handles using the same template tag as `css`. */\n  style: StyleAuthoringApi<TTokens>['css'];\n  /** Environment token tree. */\n  tokens: TTokens;\n}\n"]}

package/dist/cjs/testing.js

@@ -0,0 +1,37 @@
+"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.tokenTreeDts = exports.findVarRefViolations = exports.assertVarRefsHaveDeclarations = void 0;
+const tokens_1 = require("./tokens");
+var var_invariant_1 = require("./var_invariant");
+Object.defineProperty(exports, "assertVarRefsHaveDeclarations", { enumerable: true, get: function () { return var_invariant_1.assertVarRefsHaveDeclarations; } });
+Object.defineProperty(exports, "findVarRefViolations", { enumerable: true, get: function () { return var_invariant_1.findVarRefViolations; } });
+/**
+ * Emits a TypeScript `interface` for a derived token tree, for Monaco extraLib text.
+ *
+ * @param typeName Interface identifier.
+ * @param tree Derived {@link CssToken} / {@link ScaleToken} tree.
+ * @param leafType Identifier used for every leaf. Defaults to `CssInterpolable`.
+ */
+const tokenTreeDts = (typeName, tree, leafType = 'CssInterpolable') => `interface ${typeName} ${emitTokenObject(tree, 0, leafType)}`;
+exports.tokenTreeDts = tokenTreeDts;
+const emitTokenObject = (value, indent, leafType) => {
+    const pad = '  '.repeat(indent);
+    const inner = '  '.repeat(indent + 1);
+    const lines = Object.entries(value).map(([key, child]) => {
+        if ((0, tokens_1.isCssToken)(child) || (0, tokens_1.isScaleToken)(child)) {
+            return `${inner}readonly ${key}: ${leafType};`;
+        }
+        if (child && typeof child === 'object') {
+            return `${inner}readonly ${key}: ${emitTokenObject(child, indent + 1, leafType)};`;
+        }
+        throw new Error(`tokenTreeDts: unexpected leaf at "${key}"`);
+    });
+    return `{\n${lines.join('\n')}\n${pad}}`;
+};
+//# sourceMappingURL=testing.js.map