@elastic/distillate 0.0.0 → 0.2.0

package/dist/cjs/hash.js

@@ -0,0 +1,86 @@
+"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.contentHash64 = void 0;
+const local_vars_1 = require("./local_vars");
+const local_vars_2 = require("./local_vars");
+const nesting_1 = require("./nesting");
+const tokens_1 = require("./tokens");
+const FNV_PRIME = 0x01000193;
+const FNV_OFFSET_A = 0x811c9dc5;
+// A second basis derived from the golden-ratio constant so the two passes
+// disagree, widening the effective hash to 64 bits.
+const FNV_OFFSET_B = (0x811c9dc5 ^ 0x9e3779b9) >>> 0;
+const fnv1a = (input, offset) => {
+    let hash = offset;
+    for (let i = 0; i < input.length; i += 1) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, FNV_PRIME);
+    }
+    return hash >>> 0;
+};
+const base36 = (value) => value.toString(36).padStart(7, '0');
+const contentHash64 = (strings, values) => {
+    const canonical = canonicalize(strings, values);
+    return (base36(fnv1a(canonical, FNV_OFFSET_A)) +
+        base36(fnv1a(canonical, FNV_OFFSET_B)));
+};
+exports.contentHash64 = contentHash64;
+// Canonical, injective-enough serialization. Template strings and tagged
+// values are interleaved and joined with a NUL sentinel that cannot appear in
+// authored CSS, so distinct templates cannot collide by concatenation.
+const canonicalize = (strings, values) => {
+    const segments = [];
+    strings.forEach((part, index) => {
+        segments.push(part);
+        if (index < values.length) {
+            segments.push(tagValue(values[index]));
+        }
+    });
+    return segments.join('\u0000');
+};
+const tagValue = (value) => {
+    if (typeof value === 'string' || typeof value === 'number') {
+        return `r:${value}`;
+    }
+    if ((0, tokens_1.isCssToken)(value)) {
+        return `t:${value.path}`;
+    }
+    if ((0, tokens_1.isContextualCssVar)(value)) {
+        return `v:${value.path}`;
+    }
+    if ((0, tokens_1.isContextualCssVarName)(value)) {
+        return `n:${value.path}`;
+    }
+    if ((0, local_vars_2.isLocalVarRef)(value)) {
+        return `l:${value.path}`;
+    }
+    if ((0, tokens_1.isScaleToken)(value)) {
+        return `s:${value.value}`;
+    }
+    if ((0, local_vars_1.isLocalVarMarker)(value)) {
+        return tagMarker(value);
+    }
+    if ((0, nesting_1.isHandleLike)(value)) {
+        return `h:${value.key}`;
+    }
+    throw new Error(`Unsupported interpolation in css template. Interpolate a theme token, scale token, contextual var, local var (ref/marker), string, number, or a style handle.`);
+};
+const tagMarker = (marker) => {
+    if (marker.__kind === 'local-var-default-marker') {
+        const entries = marker.defaults
+            .map((item) => `${item.key}=${tagValue(item.value)}`)
+            .sort();
+        return `m:default:${marker.groupId}:${entries.join(',')}`;
+    }
+    const entries = marker.overrides
+        .map((item) => `${item.key}=${tagValue(item.value)}`)
+        .sort();
+    return `m:override:${marker.groupId}:${entries.join(',')}`;
+};
+//# sourceMappingURL=hash.js.map

package/dist/cjs/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/hash.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\n// Content hashing for anonymous emotion `css`/`injectGlobal` modules.\n//\n// Deterministic 64-bit FNV-1a (two 32-bit passes with distinct offset bases)\n// over a canonical serialization of the authored template. Determinism lets\n// server-rendered and client-rendered class names agree without coordination.\n\nimport type { LocalVarMarker } from './local_vars';\nimport { isLocalVarMarker } from './local_vars';\nimport { isLocalVarRef } from './local_vars';\nimport { isHandleLike } from './nesting';\nimport {\n  isContextualCssVar,\n  isContextualCssVarName,\n  isCssToken,\n  isScaleToken,\n} from './tokens';\n\nconst FNV_PRIME = 0x01000193;\nconst FNV_OFFSET_A = 0x811c9dc5;\n// A second basis derived from the golden-ratio constant so the two passes\n// disagree, widening the effective hash to 64 bits.\nconst FNV_OFFSET_B = (0x811c9dc5 ^ 0x9e3779b9) >>> 0;\n\nconst fnv1a = (input: string, offset: number): number => {\n  let hash = offset;\n  for (let i = 0; i < input.length; i += 1) {\n    hash ^= input.charCodeAt(i);\n    hash = Math.imul(hash, FNV_PRIME);\n  }\n  return hash >>> 0;\n};\n\nconst base36 = (value: number): string => value.toString(36).padStart(7, '0');\n\nexport const contentHash64 = (\n  strings: readonly string[],\n  values: readonly unknown[]\n): string => {\n  const canonical = canonicalize(strings, values);\n  return (\n    base36(fnv1a(canonical, FNV_OFFSET_A)) +\n    base36(fnv1a(canonical, FNV_OFFSET_B))\n  );\n};\n\n// Canonical, injective-enough serialization. Template strings and tagged\n// values are interleaved and joined with a NUL sentinel that cannot appear in\n// authored CSS, so distinct templates cannot collide by concatenation.\nconst canonicalize = (\n  strings: readonly string[],\n  values: readonly unknown[]\n): string => {\n  const segments: string[] = [];\n  strings.forEach((part, index) => {\n    segments.push(part);\n    if (index < values.length) {\n      segments.push(tagValue(values[index]));\n    }\n  });\n  return segments.join('\\u0000');\n};\n\nconst tagValue = (value: unknown): string => {\n  if (typeof value === 'string' || typeof value === 'number') {\n    return `r:${value}`;\n  }\n  if (isCssToken(value)) {\n    return `t:${value.path}`;\n  }\n  if (isContextualCssVar(value)) {\n    return `v:${value.path}`;\n  }\n  if (isContextualCssVarName(value)) {\n    return `n:${value.path}`;\n  }\n  if (isLocalVarRef(value)) {\n    return `l:${value.path}`;\n  }\n  if (isScaleToken(value)) {\n    return `s:${value.value}`;\n  }\n  if (isLocalVarMarker(value)) {\n    return tagMarker(value);\n  }\n  if (isHandleLike(value)) {\n    return `h:${value.key}`;\n  }\n  throw new Error(\n    `Unsupported interpolation in css template. Interpolate a theme token, scale token, contextual var, local var (ref/marker), string, number, or a style handle.`\n  );\n};\n\nconst tagMarker = (marker: LocalVarMarker): string => {\n  if (marker.__kind === 'local-var-default-marker') {\n    const entries = marker.defaults\n      .map((item) => `${item.key}=${tagValue(item.value)}`)\n      .sort();\n    return `m:default:${marker.groupId}:${entries.join(',')}`;\n  }\n  const entries = marker.overrides\n    .map((item) => `${item.key}=${tagValue(item.value)}`)\n    .sort();\n  return `m:override:${marker.groupId}:${entries.join(',')}`;\n};\n"]}

package/dist/cjs/idents.js

@@ -0,0 +1,23 @@
+"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.assertCssIdentSegment = void 0;
+/**
+ * Throws if `segment` is not a valid CSS identifier segment.
+ *
+ * @param segment Value to validate.
+ * @param role Human-readable label for the error message (e.g. `'Distillery prefix'`).
+ * @throws If `segment` contains characters outside `[A-Za-z_][A-Za-z0-9_-]*`.
+ */
+const assertCssIdentSegment = (segment, role) => {
+    if (!/^[A-Za-z_][A-Za-z0-9_-]*$/.test(segment)) {
+        throw new Error(`${role} "${segment}" is not a CSS identifier segment. Use a letter or underscore, then letters, digits, hyphens, or underscores.`);
+    }
+};
+exports.assertCssIdentSegment = assertCssIdentSegment;
+//# sourceMappingURL=idents.js.map

package/dist/cjs/idents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idents.js","sourceRoot":"","sources":["../../src/idents.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;GAMG;AACI,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAE,IAAY,EAAQ,EAAE;IAC3E,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,KAAK,OAAO,+GAA+G,CACnI,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AANW,QAAA,qBAAqB,yBAMhC","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\n/**\n * Throws if `segment` is not a valid CSS identifier segment.\n *\n * @param segment Value to validate.\n * @param role Human-readable label for the error message (e.g. `'Distillery prefix'`).\n * @throws If `segment` contains characters outside `[A-Za-z_][A-Za-z0-9_-]*`.\n */\nexport const assertCssIdentSegment = (segment: string, role: string): void => {\n  if (!/^[A-Za-z_][A-Za-z0-9_-]*$/.test(segment)) {\n    throw new Error(\n      `${role} \"${segment}\" is not a CSS identifier segment. Use a letter or underscore, then letters, digits, hyphens, or underscores.`\n    );\n  }\n};\n"]}

package/dist/cjs/index.js

@@ -0,0 +1,44 @@
+"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.variants = exports.StyleRegistry = exports.rule = exports.media = exports.mapDomain = exports.decls = exports.css = exports.container = exports.combineClassNames = exports.renderStyles = exports.StylesCollector = exports.cssVarName = exports.createStyleNameResolver = exports.themeToken = exports.scaleToken = exports.lightDark = exports.isScaleToken = exports.isCssToken = exports.isContextualCssVarName = exports.isContextualCssVar = exports.cq = exports.contextualVar = exports.zipSchemes = exports.resolveThemeValues = exports.createDomSink = exports.createDistillery = void 0;
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "createDistillery", { enumerable: true, get: function () { return engine_1.createDistillery; } });
+var dom_sink_1 = require("./dom_sink");
+Object.defineProperty(exports, "createDomSink", { enumerable: true, get: function () { return dom_sink_1.createDomSink; } });
+var theme_1 = require("./theme");
+Object.defineProperty(exports, "resolveThemeValues", { enumerable: true, get: function () { return theme_1.resolveThemeValues; } });
+Object.defineProperty(exports, "zipSchemes", { enumerable: true, get: function () { return theme_1.zipSchemes; } });
+var tokens_1 = require("./tokens");
+Object.defineProperty(exports, "contextualVar", { enumerable: true, get: function () { return tokens_1.contextualVar; } });
+Object.defineProperty(exports, "cq", { enumerable: true, get: function () { return tokens_1.cq; } });
+Object.defineProperty(exports, "isContextualCssVar", { enumerable: true, get: function () { return tokens_1.isContextualCssVar; } });
+Object.defineProperty(exports, "isContextualCssVarName", { enumerable: true, get: function () { return tokens_1.isContextualCssVarName; } });
+Object.defineProperty(exports, "isCssToken", { enumerable: true, get: function () { return tokens_1.isCssToken; } });
+Object.defineProperty(exports, "isScaleToken", { enumerable: true, get: function () { return tokens_1.isScaleToken; } });
+Object.defineProperty(exports, "lightDark", { enumerable: true, get: function () { return tokens_1.lightDark; } });
+Object.defineProperty(exports, "scaleToken", { enumerable: true, get: function () { return tokens_1.scaleToken; } });
+Object.defineProperty(exports, "themeToken", { enumerable: true, get: function () { return tokens_1.themeToken; } });
+var names_1 = require("./names");
+Object.defineProperty(exports, "createStyleNameResolver", { enumerable: true, get: function () { return names_1.createStyleNameResolver; } });
+Object.defineProperty(exports, "cssVarName", { enumerable: true, get: function () { return names_1.cssVarName; } });
+var collector_1 = require("./collector");
+Object.defineProperty(exports, "StylesCollector", { enumerable: true, get: function () { return collector_1.StylesCollector; } });
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "renderStyles", { enumerable: true, get: function () { return runtime_1.renderStyles; } });
+var styles_1 = require("./styles");
+Object.defineProperty(exports, "combineClassNames", { enumerable: true, get: function () { return styles_1.combineClassNames; } });
+Object.defineProperty(exports, "container", { enumerable: true, get: function () { return styles_1.container; } });
+Object.defineProperty(exports, "css", { enumerable: true, get: function () { return styles_1.css; } });
+Object.defineProperty(exports, "decls", { enumerable: true, get: function () { return styles_1.decls; } });
+Object.defineProperty(exports, "mapDomain", { enumerable: true, get: function () { return styles_1.mapDomain; } });
+Object.defineProperty(exports, "media", { enumerable: true, get: function () { return styles_1.media; } });
+Object.defineProperty(exports, "rule", { enumerable: true, get: function () { return styles_1.rule; } });
+Object.defineProperty(exports, "StyleRegistry", { enumerable: true, get: function () { return styles_1.StyleRegistry; } });
+Object.defineProperty(exports, "variants", { enumerable: true, get: function () { return styles_1.variants; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mCAKkB;AAJhB,0GAAA,gBAAgB,OAAA;AAKlB,uCAMoB;AALlB,yGAAA,aAAa,OAAA;AAYf,iCAaiB;AAZf,2GAAA,kBAAkB,OAAA;AAClB,mGAAA,UAAU,OAAA;AAYZ,mCAekB;AAdhB,uGAAA,aAAa,OAAA;AACb,4FAAA,EAAE,OAAA;AACF,4GAAA,kBAAkB,OAAA;AAClB,gHAAA,sBAAsB,OAAA;AACtB,oGAAA,UAAU,OAAA;AACV,sGAAA,YAAY,OAAA;AACZ,mGAAA,SAAS,OAAA;AACT,oGAAA,UAAU,OAAA;AACV,oGAAA,UAAU,OAAA;AAOZ,iCAOiB;AANf,gHAAA,uBAAuB,OAAA;AACvB,mGAAA,UAAU,OAAA;AAMZ,yCAA2E;AAAlE,4GAAA,eAAe,OAAA;AACxB,qCAImB;AAHjB,uGAAA,YAAY,OAAA;AAId,mCAmCkB;AAlChB,2GAAA,iBAAiB,OAAA;AACjB,mGAAA,SAAS,OAAA;AACT,6FAAA,GAAG,OAAA;AACH,+FAAA,KAAK,OAAA;AACL,mGAAA,SAAS,OAAA;AACT,+FAAA,KAAK,OAAA;AACL,8FAAA,IAAI,OAAA;AACJ,uGAAA,aAAa,OAAA;AACb,kGAAA,QAAQ,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\nexport {\n  createDistillery,\n  type Distillery,\n  type LiveCollection,\n  type LiveCollectionOptions,\n} from './engine';\nexport {\n  createDomSink,\n  type CreateDomSinkOptions,\n  type DocumentLike,\n  type StyleElementLike,\n  type StyleParentLike,\n} from './dom_sink';\nexport type { StyleSink } from './sink';\nexport {\n  type DistilleryEnvironment,\n  type DistilleryOptions,\n  type ThemeVarDefinition,\n} from './environment';\nexport {\n  resolveThemeValues,\n  zipSchemes,\n  type DeepPartialTheme,\n  type MediaThemeVariation,\n  type PathsOf,\n  type ResolvedThemeVariation,\n  type SchemeValueTree,\n  type ThemeTree,\n  type ThemeVariation,\n  type TokensOf,\n  type ValuesOf,\n  type Zipped,\n} from './theme';\nexport {\n  contextualVar,\n  cq,\n  isContextualCssVar,\n  isContextualCssVarName,\n  isCssToken,\n  isScaleToken,\n  lightDark,\n  scaleToken,\n  themeToken,\n  type ContextualCssVar,\n  type ContextualCssVarName,\n  type CssToken,\n  type ScaleToken,\n  type SchemePair,\n} from './tokens';\nexport {\n  createStyleNameResolver,\n  cssVarName,\n  type StyleNameMode,\n  type StyleNameResolver,\n  type StyleNameResolverOptions,\n  type StyleTarget,\n} from './names';\nexport { StylesCollector, type StylesCollectorOptions } from './collector';\nexport {\n  renderStyles,\n  type RenderStylesOptions,\n  type ThemeAlternate,\n} from './runtime';\nexport {\n  combineClassNames,\n  container,\n  css,\n  decls,\n  mapDomain,\n  media,\n  rule,\n  StyleRegistry,\n  variants,\n  type ContextualVarPath,\n  type CssValue,\n  type CssVarPath,\n  type Declarations,\n  type DeclarationSegment,\n  type DefaultGroupDeps,\n  type DefaultKeyDeps,\n  type LocalVarDefaultMarker,\n  type LocalVarGroup,\n  type LocalVarMarker,\n  type LocalVarOverrideMarker,\n  type LocalVarRef,\n  type PrimitiveStyleAuthoringApi,\n  type ResolvedStyles,\n  type RuleOptions,\n  type StyleAuthoringApi,\n  type StyleDeps,\n  type StyleEntry,\n  type StyleHandle,\n  type StyleMedia,\n  type StyleRegistrySnapshot,\n  type StyleRule,\n  type StylesModule,\n  type StylesObject,\n  type StyleSelectorResolver,\n} from './styles';\n"]}

package/dist/cjs/instance.js

@@ -0,0 +1,34 @@
+"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.registerDistillateInstance = exports.INSTANCE_KEY = void 0;
+/** `globalThis` key for the loaded copy's identity. See the README. */
+exports.INSTANCE_KEY = Symbol.for('elastic.distillate.instance');
+/**
+ * Records this copy's identity and warns if a different token is already registered.
+ *
+ * @param host Object carrying the marker, normally `globalThis`.
+ * @param instanceId This copy's identity token.
+ * @param warn Injected so tests need not intercept the console.
+ */
+const registerDistillateInstance = (host, instanceId, warn = (message) => console.warn(message)) => {
+    const registered = host[exports.INSTANCE_KEY];
+    if (registered === undefined) {
+        host[exports.INSTANCE_KEY] = instanceId;
+        return;
+    }
+    if (registered === instanceId) {
+        return;
+    }
+    warn(`@elastic/distillate: a second copy loaded (${instanceId}; already registered ${registered}). ` +
+        'The engine keeps module-scope state, so two copies silently break `variants(...)` tree-shaking ' +
+        'and inflate emitted CSS. Externalize @elastic/distillate in your bundler so exactly one copy loads.');
+};
+exports.registerDistillateInstance = registerDistillateInstance;
+(0, exports.registerDistillateInstance)(globalThis, `@elastic/distillate/instance#${Math.random().toString(36).slice(2)}`);
+//# sourceMappingURL=instance.js.map

package/dist/cjs/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../src/instance.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uEAAuE;AAC1D,QAAA,YAAY,GAAkB,MAAM,CAAC,GAAG,CACnD,6BAA6B,CAC9B,CAAC;AAQF;;;;;;GAMG;AACI,MAAM,0BAA0B,GAAG,CACxC,IAAkB,EAClB,UAAkB,EAClB,OAAkC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAC9D,EAAE;IACR,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAY,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,oBAAY,CAAC,GAAG,UAAU,CAAC;QAChC,OAAO;IACT,CAAC;IACD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,IAAI,CACF,8CAA8C,UAAU,wBAAwB,UAAU,KAAK;QAC7F,iGAAiG;QACjG,qGAAqG,CACxG,CAAC;AACJ,CAAC,CAAC;AAlBW,QAAA,0BAA0B,8BAkBrC;AAEF,IAAA,kCAA0B,EACxB,UAA0B,EAC1B,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACtE,CAAC","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\n/** `globalThis` key for the loaded copy's identity. See the README. */\nexport const INSTANCE_KEY: unique symbol = Symbol.for(\n  'elastic.distillate.instance'\n);\n\n/** Object that may hold the Distillate instance identity, normally `globalThis`. */\nexport interface InstanceHost {\n  /** Identity token of the first Distillate copy that registered. */\n  [INSTANCE_KEY]?: string;\n}\n\n/**\n * Records this copy's identity and warns if a different token is already registered.\n *\n * @param host Object carrying the marker, normally `globalThis`.\n * @param instanceId This copy's identity token.\n * @param warn Injected so tests need not intercept the console.\n */\nexport const registerDistillateInstance = (\n  host: InstanceHost,\n  instanceId: string,\n  warn: (message: string) => void = (message) => console.warn(message)\n): void => {\n  const registered = host[INSTANCE_KEY];\n  if (registered === undefined) {\n    host[INSTANCE_KEY] = instanceId;\n    return;\n  }\n  if (registered === instanceId) {\n    return;\n  }\n  warn(\n    `@elastic/distillate: a second copy loaded (${instanceId}; already registered ${registered}). ` +\n      'The engine keeps module-scope state, so two copies silently break `variants(...)` tree-shaking ' +\n      'and inflate emitted CSS. Externalize @elastic/distillate in your bundler so exactly one copy loads.'\n  );\n};\n\nregisterDistillateInstance(\n  globalThis as InstanceHost,\n  `@elastic/distillate/instance#${Math.random().toString(36).slice(2)}`\n);\n"]}

package/dist/cjs/local_vars.js

@@ -0,0 +1,100 @@
+"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.createLocalVarGroup = exports.isLocalVarMarker = exports.isLocalVarOverrideMarker = exports.isLocalVarDefaultMarker = exports.isLocalVarRef = void 0;
+const idents_1 = require("./idents");
+const names_1 = require("./names");
+const RESERVED_DEFAULT_KEYS = new Set(['set', 'toString', 'valueOf', 'toJSON']);
+const isReservedKey = (key) => RESERVED_DEFAULT_KEYS.has(key) || key.startsWith('__');
+/** `true` when `value` is a {@link LocalVarRef}. */
+const isLocalVarRef = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    value.__kind === 'local-var-ref');
+exports.isLocalVarRef = isLocalVarRef;
+/** `true` when `value` is a {@link LocalVarDefaultMarker}. */
+const isLocalVarDefaultMarker = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    value.__kind === 'local-var-default-marker');
+exports.isLocalVarDefaultMarker = isLocalVarDefaultMarker;
+/** `true` when `value` is a {@link LocalVarOverrideMarker}. */
+const isLocalVarOverrideMarker = (value) => Boolean(value &&
+    typeof value === 'object' &&
+    value.__kind === 'local-var-override-marker');
+exports.isLocalVarOverrideMarker = isLocalVarOverrideMarker;
+/** `true` when `value` is a {@link LocalVarDefaultMarker} or {@link LocalVarOverrideMarker}. */
+const isLocalVarMarker = (value) => (0, exports.isLocalVarDefaultMarker)(value) || (0, exports.isLocalVarOverrideMarker)(value);
+exports.isLocalVarMarker = isLocalVarMarker;
+const cssVarPath = (moduleName, group, key) => `vars/${moduleName}/${group}/${key}`;
+const buildLocalVarRef = (path, propName) => {
+    const ref = `var(${propName})`;
+    const refToString = () => ref;
+    return {
+        __kind: 'local-var-ref',
+        path,
+        propName,
+        ref,
+        toString: refToString,
+        [Symbol.toPrimitive]: refToString,
+    };
+};
+const reservedKeyError = (key) => new Error(`t.vars(...) defaults key "${key}" is reserved. Reserved: ${[...RESERVED_DEFAULT_KEYS].join(', ')} plus any "__"-prefixed key.`);
+const createLocalVarGroup = (prefix, moduleName, group, defaults) => {
+    (0, idents_1.assertCssIdentSegment)(group, 't.vars(...) group');
+    const groupId = `${moduleName}/${group}`;
+    const groupPath = `vars/${groupId}`;
+    const refs = new Map();
+    const defaultsList = [];
+    for (const [key, value] of Object.entries(defaults)) {
+        if (isReservedKey(key)) {
+            throw reservedKeyError(key);
+        }
+        (0, idents_1.assertCssIdentSegment)(key, `t.vars("${group}") key`);
+        const path = cssVarPath(moduleName, group, key);
+        const propName = (0, names_1.cssVarName)(prefix, path);
+        refs.set(key, buildLocalVarRef(path, propName));
+        defaultsList.push({ key, path, propName, value });
+    }
+    const setOverrides = (overrides) => {
+        const list = [];
+        for (const [key, value] of Object.entries(overrides)) {
+            if (value === undefined) {
+                continue;
+            }
+            const ref = refs.get(key);
+            if (!ref) {
+                throw new Error(`t.vars("${group}").set: unknown key "${key}". Declared keys: ${defaultsList
+                    .map((entry) => entry.key)
+                    .join(', ')}.`);
+            }
+            list.push({ key, path: ref.path, propName: ref.propName, value });
+        }
+        return {
+            __kind: 'local-var-override-marker',
+            groupId,
+            overrides: list,
+        };
+    };
+    const group_ = {
+        __kind: 'local-var-default-marker',
+        groupId,
+        groupPath,
+        defaults: defaultsList,
+        set: setOverrides,
+    };
+    for (const [key, ref] of refs) {
+        Object.defineProperty(group_, key, {
+            value: ref,
+            enumerable: true,
+            writable: false,
+            configurable: false,
+        });
+    }
+    return group_;
+};
+exports.createLocalVarGroup = createLocalVarGroup;
+//# sourceMappingURL=local_vars.js.map

package/dist/cjs/local_vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_vars.js","sourceRoot":"","sources":["../../src/local_vars.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 { assertCssIdentSegment } from './idents';\nimport { cssVarName } from './names';\nimport type { ContextualVarPath, CssValue } from './styles/types';\n\nconst RESERVED_DEFAULT_KEYS = new Set(['set', 'toString', 'valueOf', 'toJSON']);\n\nconst isReservedKey = (key: string): boolean =>\n  RESERVED_DEFAULT_KEYS.has(key) || key.startsWith('__');\n\n/** Reference to a local CSS variable. Stringifies to `var(--...)`. */\nexport interface LocalVarRef {\n  /** Brand distinguishing a local-var ref from other interpolations. */\n  readonly __kind: 'local-var-ref';\n  /** Canonical group/key path. */\n  readonly path: ContextualVarPath;\n  /** Actual emitted CSS custom property name. */\n  readonly propName: `--${string}`;\n  /** Usable CSS `var(...)` reference string. */\n  readonly ref: `var(--${string})`;\n  /** Stringifies to {@link LocalVarRef.ref}. */\n  toString(): string;\n  /** Template interpolation; same as {@link LocalVarRef.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** Interpolation marker representing `.set(...)` overrides. */\nexport interface LocalVarOverrideMarker {\n  /** Brand distinguishing a `.set(...)` override marker. */\n  readonly __kind: 'local-var-override-marker';\n  /** Unique ID for the group. */\n  readonly groupId: string;\n  /** Ordered list of variable overrides. */\n  readonly overrides: ReadonlyArray<{\n    /** Variable key within the group. */\n    readonly key: string;\n    /** Canonical group/key path. */\n    readonly path: ContextualVarPath;\n    /** Actual emitted CSS custom property name. */\n    readonly propName: `--${string}`;\n    /** Override value written at this interpolation site. */\n    readonly value: CssValue;\n  }>;\n}\n\n/** Interpolation marker representing `${group}` defaults. */\nexport interface LocalVarDefaultMarker {\n  /** Brand distinguishing a `${group}` default marker. */\n  readonly __kind: 'local-var-default-marker';\n  /** Unique ID for the group. */\n  readonly groupId: string;\n  /** Group prefix path. */\n  readonly groupPath: `vars/${string}`;\n  /** Ordered list of variable defaults. */\n  readonly defaults: ReadonlyArray<{\n    /** Variable key within the group. */\n    readonly key: string;\n    /** Canonical group/key path. */\n    readonly path: ContextualVarPath;\n    /** Actual emitted CSS custom property name. */\n    readonly propName: `--${string}`;\n    /** Default value emitted when this key is reachable. */\n    readonly value: CssValue;\n  }>;\n}\n\n/** Interpolation marker: `${group}` defaults or `${group.set(...)}` overrides. */\nexport type LocalVarMarker = LocalVarOverrideMarker | LocalVarDefaultMarker;\n\n/**\n * Value returned by `t.vars(...)`. Interpolate `${group}`, `${group.key}`, or `${group.set({...})}`.\n */\nexport type LocalVarGroup<TKey extends string> = {\n  readonly [P in TKey]: LocalVarRef;\n} & {\n  /** Builds a marker that writes the given keys at the interpolation site. */\n  set(overrides: Partial<Record<TKey, CssValue>>): LocalVarOverrideMarker;\n};\n\n/** `true` when `value` is a {@link LocalVarRef}. */\nexport const isLocalVarRef = (value: unknown): value is LocalVarRef =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as { __kind?: string }).__kind === 'local-var-ref'\n  );\n\n/** `true` when `value` is a {@link LocalVarDefaultMarker}. */\nexport const isLocalVarDefaultMarker = (\n  value: unknown\n): value is LocalVarDefaultMarker =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as { __kind?: string }).__kind === 'local-var-default-marker'\n  );\n\n/** `true` when `value` is a {@link LocalVarOverrideMarker}. */\nexport const isLocalVarOverrideMarker = (\n  value: unknown\n): value is LocalVarOverrideMarker =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as { __kind?: string }).__kind === 'local-var-override-marker'\n  );\n\n/** `true` when `value` is a {@link LocalVarDefaultMarker} or {@link LocalVarOverrideMarker}. */\nexport const isLocalVarMarker = (value: unknown): value is LocalVarMarker =>\n  isLocalVarDefaultMarker(value) || isLocalVarOverrideMarker(value);\n\nconst cssVarPath = (\n  moduleName: string,\n  group: string,\n  key: string\n): ContextualVarPath => `vars/${moduleName}/${group}/${key}`;\n\nconst buildLocalVarRef = (\n  path: ContextualVarPath,\n  propName: `--${string}`\n): LocalVarRef => {\n  const ref: `var(--${string})` = `var(${propName})`;\n  const refToString = (): string => ref;\n  return {\n    __kind: 'local-var-ref',\n    path,\n    propName,\n    ref,\n    toString: refToString,\n    [Symbol.toPrimitive]: refToString,\n  };\n};\n\nconst reservedKeyError = (key: string): Error =>\n  new Error(\n    `t.vars(...) defaults key \"${key}\" is reserved. Reserved: ${[...RESERVED_DEFAULT_KEYS].join(', ')} plus any \"__\"-prefixed key.`\n  );\n\nexport const createLocalVarGroup = <TKey extends string>(\n  prefix: string,\n  moduleName: string,\n  group: string,\n  defaults: Record<TKey, CssValue>\n): LocalVarGroup<TKey> => {\n  assertCssIdentSegment(group, 't.vars(...) group');\n  const groupId = `${moduleName}/${group}`;\n  const groupPath = `vars/${groupId}`;\n  const refs = new Map<TKey, LocalVarRef>();\n  const defaultsList: Array<{\n    readonly key: string;\n    readonly path: ContextualVarPath;\n    readonly propName: `--${string}`;\n    readonly value: CssValue;\n  }> = [];\n\n  for (const [key, value] of Object.entries(defaults) as Array<\n    [TKey, CssValue]\n  >) {\n    if (isReservedKey(key)) {\n      throw reservedKeyError(key);\n    }\n    assertCssIdentSegment(key, `t.vars(\"${group}\") key`);\n    const path = cssVarPath(moduleName, group, key);\n    const propName = cssVarName(prefix, path);\n    refs.set(key, buildLocalVarRef(path, propName));\n    defaultsList.push({ key, path, propName, value });\n  }\n\n  const setOverrides = (\n    overrides: Partial<Record<TKey, CssValue>>\n  ): LocalVarOverrideMarker => {\n    const list: Array<LocalVarOverrideMarker['overrides'][number]> = [];\n    for (const [key, value] of Object.entries(overrides) as Array<\n      [TKey, CssValue | undefined]\n    >) {\n      if (value === undefined) {\n        continue;\n      }\n      const ref = refs.get(key);\n      if (!ref) {\n        throw new Error(\n          `t.vars(\"${group}\").set: unknown key \"${key}\". Declared keys: ${defaultsList\n            .map((entry) => entry.key)\n            .join(', ')}.`\n        );\n      }\n      list.push({ key, path: ref.path, propName: ref.propName, value });\n    }\n    return {\n      __kind: 'local-var-override-marker',\n      groupId,\n      overrides: list,\n    };\n  };\n\n  const group_ = {\n    __kind: 'local-var-default-marker',\n    groupId,\n    groupPath,\n    defaults: defaultsList,\n    set: setOverrides,\n  } as unknown as LocalVarGroup<TKey>;\n\n  for (const [key, ref] of refs) {\n    Object.defineProperty(group_, key, {\n      value: ref,\n      enumerable: true,\n      writable: false,\n      configurable: false,\n    });\n  }\n\n  return group_;\n};\n"]}

package/dist/cjs/minify.js

@@ -0,0 +1,77 @@
+"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.minifyCss = void 0;
+const css_scan_1 = require("./css_scan");
+/**
+ * A space between two non-structural spans is significant wherever it sits: a
+ * descendant combinator in a selector (`.a .b`), a token separator in a value
+ * (`margin:0 auto`). Beside a structural character it is noise, except before
+ * a pseudo-class colon in a rules block — `.menu :hover` is not `.menu:hover`,
+ * while `color : red` is `color:red`.
+ */
+const spaceIsSignificant = (before, after) => {
+    if (!before || !after) {
+        return false;
+    }
+    if (before.kind === 'structural') {
+        return false;
+    }
+    if (after.kind === 'structural') {
+        // Only a pseudo-class colon in a selector keeps the space in front of it.
+        // Space before `{`, `}`, `;`, `,`, or `>` is never significant.
+        return after.text === ':' && after.block === 'rules';
+    }
+    return true;
+};
+/**
+ * Strips comments and insignificant whitespace from CSS.
+ *
+ * Strings, unquoted `url(…)` tokens, and backslash escapes pass through
+ * untouched: their contents are literal, so a `/*` or a `;` inside one is data
+ * rather than syntax.
+ *
+ * @param value Raw CSS text.
+ */
+const minifyCss = (value) => {
+    // Dropping comments can leave two whitespace spans adjacent — `.a /*c*/ .b`
+    // — and emitting one space per span would keep both. Coalescing after the
+    // filter makes the run a single decision.
+    const spans = (0, css_scan_1.scanCss)(value)
+        .filter((span) => span.kind !== 'comment')
+        .filter((span, index, all) => span.kind !== 'whitespace' || all[index - 1]?.kind !== 'whitespace');
+    const out = [];
+    // Indices into `spans` of what has been emitted, so lookaround skips the
+    // whitespace being decided about.
+    const significant = spans.filter((span) => span.kind !== 'whitespace');
+    let significantIndex = 0;
+    spans.forEach((span) => {
+        if (span.kind === 'whitespace') {
+            const before = significant[significantIndex - 1];
+            const after = significant[significantIndex];
+            if (spaceIsSignificant(before, after)) {
+                out.push(' ');
+            }
+            return;
+        }
+        // A declaration's terminator is redundant against the block's own close.
+        // Only a bare `;` qualifies: an escaped one is part of a value, and it
+        // arrives as an `escape` span rather than a structural `;`.
+        if (span.kind === 'structural' &&
+            span.text === '}' &&
+            significant[significantIndex - 1]?.kind === 'structural' &&
+            significant[significantIndex - 1]?.text === ';') {
+            out.pop();
+        }
+        out.push(span.text);
+        significantIndex += 1;
+    });
+    return out.join('').trim();
+};
+exports.minifyCss = minifyCss;
+//# sourceMappingURL=minify.js.map

package/dist/cjs/minify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minify.js","sourceRoot":"","sources":["../../src/minify.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yCAAmD;AAEnD;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,CACzB,MAA2B,EAC3B,KAA0B,EACjB,EAAE;IACX,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,0EAA0E;QAC1E,gEAAgE;QAChE,OAAO,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACI,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE;IACjD,4EAA4E;IAC5E,0EAA0E;IAC1E,0CAA0C;IAC1C,MAAM,KAAK,GAAG,IAAA,kBAAO,EAAC,KAAK,CAAC;SACzB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;SACzC,MAAM,CACL,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CACnB,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,IAAI,KAAK,YAAY,CACtE,CAAC;IACJ,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,yEAAyE;IACzE,kCAAkC;IAClC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IACvE,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,WAAW,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;YAC5C,IAAI,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;gBACtC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,OAAO;QACT,CAAC;QAED,yEAAyE;QACzE,uEAAuE;QACvE,4DAA4D;QAC5D,IACE,IAAI,CAAC,IAAI,KAAK,YAAY;YAC1B,IAAI,CAAC,IAAI,KAAK,GAAG;YACjB,WAAW,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,KAAK,YAAY;YACxD,WAAW,CAAC,gBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,KAAK,GAAG,EAC/C,CAAC;YACD,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,gBAAgB,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC,CAAC;AA3CW,QAAA,SAAS,aA2CpB","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 CssSpan, scanCss } from './css_scan';\n\n/**\n * A space between two non-structural spans is significant wherever it sits: a\n * descendant combinator in a selector (`.a .b`), a token separator in a value\n * (`margin:0 auto`). Beside a structural character it is noise, except before\n * a pseudo-class colon in a rules block — `.menu :hover` is not `.menu:hover`,\n * while `color : red` is `color:red`.\n */\nconst spaceIsSignificant = (\n  before: CssSpan | undefined,\n  after: CssSpan | undefined\n): boolean => {\n  if (!before || !after) {\n    return false;\n  }\n  if (before.kind === 'structural') {\n    return false;\n  }\n  if (after.kind === 'structural') {\n    // Only a pseudo-class colon in a selector keeps the space in front of it.\n    // Space before `{`, `}`, `;`, `,`, or `>` is never significant.\n    return after.text === ':' && after.block === 'rules';\n  }\n  return true;\n};\n\n/**\n * Strips comments and insignificant whitespace from CSS.\n *\n * Strings, unquoted `url(…)` tokens, and backslash escapes pass through\n * untouched: their contents are literal, so a `/*` or a `;` inside one is data\n * rather than syntax.\n *\n * @param value Raw CSS text.\n */\nexport const minifyCss = (value: string): string => {\n  // Dropping comments can leave two whitespace spans adjacent — `.a /*c*/ .b`\n  // — and emitting one space per span would keep both. Coalescing after the\n  // filter makes the run a single decision.\n  const spans = scanCss(value)\n    .filter((span) => span.kind !== 'comment')\n    .filter(\n      (span, index, all) =>\n        span.kind !== 'whitespace' || all[index - 1]?.kind !== 'whitespace'\n    );\n  const out: string[] = [];\n  // Indices into `spans` of what has been emitted, so lookaround skips the\n  // whitespace being decided about.\n  const significant = spans.filter((span) => span.kind !== 'whitespace');\n  let significantIndex = 0;\n\n  spans.forEach((span) => {\n    if (span.kind === 'whitespace') {\n      const before = significant[significantIndex - 1];\n      const after = significant[significantIndex];\n      if (spaceIsSignificant(before, after)) {\n        out.push(' ');\n      }\n      return;\n    }\n\n    // A declaration's terminator is redundant against the block's own close.\n    // Only a bare `;` qualifies: an escaped one is part of a value, and it\n    // arrives as an `escape` span rather than a structural `;`.\n    if (\n      span.kind === 'structural' &&\n      span.text === '}' &&\n      significant[significantIndex - 1]?.kind === 'structural' &&\n      significant[significantIndex - 1]?.text === ';'\n    ) {\n      out.pop();\n    }\n\n    out.push(span.text);\n    significantIndex += 1;\n  });\n\n  return out.join('').trim();\n};\n"]}

package/dist/cjs/names.js

@@ -0,0 +1,77 @@
+"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.createStyleNameResolver = exports.cssVarName = exports.createCompactNameMap = exports.compactNameForIndex = void 0;
+const compactAlphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const compactNameForIndex = (index) => {
+    if (!Number.isInteger(index) || index < 0) {
+        throw new Error(`Compact name index must be a non-negative integer.`);
+    }
+    const base = compactAlphabet.length;
+    let remaining = index;
+    let length = 1;
+    while (remaining >= base ** length) {
+        remaining -= base ** length;
+        length += 1;
+    }
+    let name = '';
+    for (let position = length - 1; position >= 0; position -= 1) {
+        const divisor = base ** position;
+        const digit = Math.floor(remaining / divisor);
+        name += compactAlphabet[digit] ?? '';
+        remaining %= divisor;
+    }
+    return name;
+};
+exports.compactNameForIndex = compactNameForIndex;
+/** Compact names are assigned from sorted keys so emission is deterministic. */
+const createCompactNameMap = (keys) => {
+    const uniqueKeys = [...new Set(keys)].sort();
+    return new Map(uniqueKeys.map((key, index) => [key, (0, exports.compactNameForIndex)(index)]));
+};
+exports.createCompactNameMap = createCompactNameMap;
+const readableClassName = (prefix, key, fallback) => fallback ?? `${prefix}-${key.replaceAll('/', '-')}`;
+/**
+ * Readable custom-property name: `--${prefix}-${path}` with `/` joined on `-` and a leading `vars/` stripped.
+ *
+ * @param prefix Brand prefix (e.g. `'eui'`).
+ * @param path Theme or contextual-var path (e.g. `'colors/ink'`, `'vars/chip/look/bg'`).
+ */
+const cssVarName = (prefix, path) => `--${prefix}-${path.replace(/^vars\//, '').replaceAll('/', '-')}`;
+exports.cssVarName = cssVarName;
+const compactLookup = (map, key, kind) => {
+    const name = map.get(key);
+    if (!name) {
+        throw new Error(`No compact ${kind} name registered for "${key}".`);
+    }
+    return name;
+};
+/** Maps semantic keys to readable (`<prefix>-<key>`) or compact (`a`, `b`, …) names. */
+const createStyleNameResolver = ({ names, prefix, classKeys = [], cssVarKeys = [], }) => {
+    const classMap = (0, exports.createCompactNameMap)(classKeys);
+    const cssVarMap = (0, exports.createCompactNameMap)(cssVarKeys);
+    const cssVar = (key) => {
+        if (names === 'readable') {
+            return (0, exports.cssVarName)(prefix, key);
+        }
+        return `--${compactLookup(cssVarMap, key, 'CSS variable')}`;
+    };
+    return {
+        names,
+        className: (key, fallback) => {
+            if (names === 'readable') {
+                return readableClassName(prefix, key, fallback);
+            }
+            return compactLookup(classMap, key, 'class');
+        },
+        cssVar,
+        cssVarRef: (key) => `var(${cssVar(key)})`,
+    };
+};
+exports.createStyleNameResolver = createStyleNameResolver;
+//# sourceMappingURL=names.js.map

package/dist/cjs/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/names.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\n/** Naming scheme: `compact` assigns sequential identifiers by sorted key index, `readable` emits descriptive ones. */\nexport type StyleNameMode = 'compact' | 'readable';\n/** Destination format for the CSS collection. */\nexport type StyleTarget = 'artifact' | 'stylesheet';\n\n/** Context for resolving keys into final class or custom-property names. */\nexport interface StyleNameResolver {\n  /** The naming mode used by this resolver. */\n  readonly names: StyleNameMode;\n  /** Resolves a handle key into a CSS class name. */\n  className(key: string, readableName?: string): string;\n  /** Resolves a variable key into a custom property name. */\n  cssVar(key: string): `--${string}`;\n  /** Resolves a variable key into a `var(...)` reference. */\n  cssVarRef(key: string): `var(--${string})`;\n}\n\n/** Inputs for {@link createStyleNameResolver}. */\nexport interface StyleNameResolverOptions {\n  /** Naming strategy (`compact` or `readable`). */\n  names: StyleNameMode;\n  /** Brand prefix for readable names (`<prefix>-<key>` / `--<prefix>-<key>`), e.g. `'aui'`. */\n  prefix: string;\n  /** Keys defining the compact class-name domain. */\n  classKeys?: Iterable<string>;\n  /** Keys defining the compact custom-property domain. */\n  cssVarKeys?: Iterable<string>;\n}\n\nconst compactAlphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';\n\nexport const compactNameForIndex = (index: number): string => {\n  if (!Number.isInteger(index) || index < 0) {\n    throw new Error(`Compact name index must be a non-negative integer.`);\n  }\n\n  const base = compactAlphabet.length;\n  let remaining = index;\n  let length = 1;\n\n  while (remaining >= base ** length) {\n    remaining -= base ** length;\n    length += 1;\n  }\n\n  let name = '';\n  for (let position = length - 1; position >= 0; position -= 1) {\n    const divisor = base ** position;\n    const digit = Math.floor(remaining / divisor);\n    name += compactAlphabet[digit] ?? '';\n    remaining %= divisor;\n  }\n\n  return name;\n};\n\n/** Compact names are assigned from sorted keys so emission is deterministic. */\nexport const createCompactNameMap = (\n  keys: Iterable<string>\n): ReadonlyMap<string, string> => {\n  const uniqueKeys = [...new Set(keys)].sort();\n  return new Map(\n    uniqueKeys.map((key, index) => [key, compactNameForIndex(index)])\n  );\n};\n\nconst readableClassName = (\n  prefix: string,\n  key: string,\n  fallback?: string\n): string => fallback ?? `${prefix}-${key.replaceAll('/', '-')}`;\n\n/**\n * Readable custom-property name: `--${prefix}-${path}` with `/` joined on `-` and a leading `vars/` stripped.\n *\n * @param prefix Brand prefix (e.g. `'eui'`).\n * @param path Theme or contextual-var path (e.g. `'colors/ink'`, `'vars/chip/look/bg'`).\n */\nexport const cssVarName = (prefix: string, path: string): `--${string}` =>\n  `--${prefix}-${path.replace(/^vars\\//, '').replaceAll('/', '-')}`;\n\nconst compactLookup = (\n  map: ReadonlyMap<string, string>,\n  key: string,\n  kind: 'class' | 'CSS variable'\n): string => {\n  const name = map.get(key);\n  if (!name) {\n    throw new Error(`No compact ${kind} name registered for \"${key}\".`);\n  }\n  return name;\n};\n\n/** Maps semantic keys to readable (`<prefix>-<key>`) or compact (`a`, `b`, …) names. */\nexport const createStyleNameResolver = ({\n  names,\n  prefix,\n  classKeys = [],\n  cssVarKeys = [],\n}: StyleNameResolverOptions): StyleNameResolver => {\n  const classMap = createCompactNameMap(classKeys);\n  const cssVarMap = createCompactNameMap(cssVarKeys);\n\n  const cssVar = (key: string): `--${string}` => {\n    if (names === 'readable') {\n      return cssVarName(prefix, key);\n    }\n    return `--${compactLookup(cssVarMap, key, 'CSS variable')}`;\n  };\n\n  return {\n    names,\n    className: (key, fallback) => {\n      if (names === 'readable') {\n        return readableClassName(prefix, key, fallback);\n      }\n      return compactLookup(classMap, key, 'class');\n    },\n    cssVar,\n    cssVarRef: (key) => `var(${cssVar(key)})`,\n  };\n};\n"]}