@elastic/distillate 0.0.0 → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/styles/registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,oCAAsC;AAUtC;;GAEG;AACH,MAAa,aAAa;IAKL;IACA;IACA;IANF,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;IACzD,YAAY,CAA0B;IAE9C,YACmB,MAAc,EACd,oBAAiD,IAAI,GAAG,EAAE,EAC1D,iBAAsC,IAAI,GAAG,EAAE;QAF/C,WAAM,GAAN,MAAM,CAAQ;QACd,sBAAiB,GAAjB,iBAAiB,CAAyC;QAC1D,mBAAc,GAAd,cAAc,CAAiC;IAC/D,CAAC;IAEJ;;;;OAIG;IACH,cAAc,CAAC,MAAoB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,IAAI,0BAA0B,CAAC,CAAC;QAC1E,CAAC;QACD,4BAA4B,CAC1B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAC3B,MAAM,CACP,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAEO,kBAAkB;QACxB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClD,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAClC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBAChC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACpD,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7B,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,iFAAiF;IACjF,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACrC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAC9C,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,UAAU;QACZ,MAAM,IAAI,GAAG,IAAI,GAAG,EAAc,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACnD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,MAAM,CACJ,UAKI,EAAE;QAEN,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CACtB,YAAY,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,CAClD;YACD,UAAU,EAAE,MAAM,CAAC,MAAM,CACvB,YAAY,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,CACpD;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAlHD,sCAkHC;AAED,MAAM,YAAY,GAAG,CACnB,MAAwB,EACL,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAEpD,MAAM,gBAAgB,GAAG,CACvB,MAA2B,EAC3B,IAAY,EACZ,KAAa,EACP,EAAE;IACR,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,sBAAsB,KAAK,QAAQ,KAAK,GAAG,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC,CAAC;AAUF,oFAAoF;AAC7E,MAAM,gCAAgC,GAAG,CAC9C,WAGC,EAC4B,EAAE;IAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,gBAAgB,CAAC,MAAM,EAAE,IAAA,kBAAU,EAAC,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,IAAI,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAChD,gBAAgB,CAAC,MAAM,EAAE,IAAA,kBAAU,EAAC,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,IAAI,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAfW,QAAA,gCAAgC,oCAe3C;AAEF,MAAM,4BAA4B,GAAG,CACnC,MAAc,EACd,iBAA8C,EAC9C,cAAmC,EACnC,QAAgC,EAChC,QAAsB,EAChB,EAAE;IACR,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiC,CAAC;IAChE,MAAM,KAAK,GAAG,CAAC,MAAoB,EAAQ,EAAE;QAC3C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACnD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,YAAY,sBAAsB,KAAK,gBAAgB,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,SAAS,IAAI,CACnI,CAAC;YACJ,CAAC;YACD,WAAW,CAAC,GAAG,CACb,MAAM,CAAC,YAAY,EACnB,WAAW,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,SAAS,GAAG,CACvD,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,WAAW,MAAM,CAAC,IAAI,UAAU,IAAI,GAAG,CAAC;YACtD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,sBAAsB,QAAQ,QAAQ,KAAK,GAAG,CAC7E,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,sBAAsB,KAAK,CAAC,KAAK,QAAQ,KAAK,GAAG,CAChF,CAAC;YACJ,CAAC;YACD,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,iFAAiF;AACjF,0EAA0E;AAC1E,gFAAgF;AAChF,+EAA+E;AAC/E,uDAAuD;AACvD,MAAM,eAAe,GAAG,CACtB,MAAoB,EACpB,cAAmC,EACL,EAAE;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,YAA0B,EAAQ,EAAE;QACnD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC,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\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

package/dist/cjs/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAAoD;AAEpD,iDAIyB;AAHvB,8HAAA,6BAA6B,OAAA;AAC7B,qHAAA,oBAAoB,OAAA;AAItB;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAC1B,QAAgB,EAChB,IAAY,EACZ,QAAQ,GAAG,iBAAiB,EACpB,EAAE,CAAC,aAAa,QAAQ,IAAI,eAAe,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;AAJ9D,QAAA,YAAY,gBAIkD;AAE3E,MAAM,eAAe,GAAG,CACtB,KAAa,EACb,MAAc,EACd,QAAgB,EACR,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,GAAG,CAChE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACf,IAAI,IAAA,mBAAU,EAAC,KAAK,CAAC,IAAI,IAAA,qBAAY,EAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,KAAK,YAAY,GAAG,KAAK,QAAQ,GAAG,CAAC;QACjD,CAAC;QACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,GAAG,KAAK,YAAY,GAAG,KAAK,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC;QACrF,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,GAAG,CAAC,CAAC;IAC/D,CAAC,CACF,CAAC;IACF,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;AAC3C,CAAC,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\nimport { isCssToken, isScaleToken } from './tokens';\n\nexport {\n  assertVarRefsHaveDeclarations,\n  findVarRefViolations,\n  type VarInvariantViolation,\n} from './var_invariant';\n\n/**\n * Emits a TypeScript `interface` for a derived token tree, for Monaco extraLib text.\n *\n * @param typeName Interface identifier.\n * @param tree Derived {@link CssToken} / {@link ScaleToken} tree.\n * @param leafType Identifier used for every leaf. Defaults to `CssInterpolable`.\n */\nexport const tokenTreeDts = (\n  typeName: string,\n  tree: object,\n  leafType = 'CssInterpolable'\n): string => `interface ${typeName} ${emitTokenObject(tree, 0, leafType)}`;\n\nconst emitTokenObject = (\n  value: object,\n  indent: number,\n  leafType: string\n): string => {\n  const pad = '  '.repeat(indent);\n  const inner = '  '.repeat(indent + 1);\n  const lines = Object.entries(value as Record<string, unknown>).map(\n    ([key, child]) => {\n      if (isCssToken(child) || isScaleToken(child)) {\n        return `${inner}readonly ${key}: ${leafType};`;\n      }\n      if (child && typeof child === 'object') {\n        return `${inner}readonly ${key}: ${emitTokenObject(child, indent + 1, leafType)};`;\n      }\n      throw new Error(`tokenTreeDts: unexpected leaf at \"${key}\"`);\n    }\n  );\n  return `{\\n${lines.join('\\n')}\\n${pad}}`;\n};\n"]}

package/dist/cjs/theme.js

@@ -0,0 +1,249 @@
+"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.resolveThemeVariations = exports.serializedThemeValue = exports.requireThemeVariation = exports.resolveThemeValues = exports.deriveTheme = exports.zipSchemes = void 0;
+const names_1 = require("./names");
+const tokens_1 = require("./tokens");
+/** Theme-tree keys omit `-` so hyphen-joined custom properties reverse uniquely. */
+const THEME_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * Folds two per-scheme trees into one authoring tree. Equal string leaves stay bare; differing strings become {@link lightDark}. {@link ScaleToken} leaves must agree.
+ *
+ * @param light Light-scheme value tree.
+ * @param dark Dark-scheme value tree.
+ * @throws If shapes, leaf kinds, or scale values disagree, or if a differing string pair is not a CSS `<color>`.
+ */
+const zipSchemes = (light, dark) => zipNode(light, dark, '');
+exports.zipSchemes = zipSchemes;
+/** Walks `theme` into a {@link CssToken} / {@link ScaleToken} tree and a `themeVars` registry. */
+const deriveTheme = (prefix, theme) => {
+    const themeVars = dict();
+    const tokens = walk(theme, '', prefix, themeVars);
+    return { tokens, themeVars };
+};
+exports.deriveTheme = deriveTheme;
+/**
+ * Nested literal values for one scheme. Walks `theme` so {@link ScaleToken} leaves resolve to `.value`.
+ *
+ * @param theme Authoring tree that produced `themeVars`.
+ * @param themeVars Base registry from {@link Distillery.themeVars}.
+ * @param scheme Which side of each {@link ThemeVarDefinition} to read.
+ * @param variation When set, overridden paths come from `variation.diffs`; everything else stays on `themeVars`.
+ */
+const resolveThemeValues = (theme, themeVars, scheme, variation) => {
+    const vars = variation
+        ? Object.assign(dict(), themeVars, variation.diffs)
+        : themeVars;
+    return walkValues(theme, '', vars, scheme);
+};
+exports.resolveThemeValues = resolveThemeValues;
+/** Looks up a declared variation. @throws If `name` is not in `variations`. */
+const requireThemeVariation = (variations, name) => {
+    const resolved = variations && Object.hasOwn(variations, name)
+        ? variations[name]
+        : undefined;
+    if (!resolved) {
+        const declared = Object.keys(variations ?? {});
+        const suffix = declared.length > 0
+            ? ` Declared: ${declared.join(', ')}.`
+            : ' No variations were declared.';
+        throw new Error(`Unknown variation "${name}".${suffix}`);
+    }
+    return resolved;
+};
+exports.requireThemeVariation = requireThemeVariation;
+/** Serialized `light` / `light-dark(light, dark)` form used in emission and diffs. */
+const serializedThemeValue = ({ light, dark, }) => light === dark ? light : `light-dark(${light},${dark})`;
+exports.serializedThemeValue = serializedThemeValue;
+/**
+ * Resolves named `variations` against `base`. Variations extend the base only (no chains).
+ *
+ * @throws If a variation introduces an unknown path, a leaf-kind mismatch, or a diverging {@link ScaleToken}.
+ */
+const resolveThemeVariations = (prefix, base, baseVars, variations) => {
+    if (!variations) {
+        return {};
+    }
+    const out = dict();
+    for (const [name, declaration] of Object.entries(variations)) {
+        const { media, variation } = unwrapThemeVariation(declaration, name);
+        const merged = applyVariation(base, variation, name, '');
+        const { themeVars } = (0, exports.deriveTheme)(prefix, merged);
+        const diffs = dict();
+        for (const [path, definition] of Object.entries(themeVars)) {
+            const baseDefinition = baseVars[path];
+            if (!baseDefinition ||
+                (0, exports.serializedThemeValue)(definition) !==
+                    (0, exports.serializedThemeValue)(baseDefinition)) {
+                diffs[path] = definition;
+            }
+        }
+        out[name] = Object.freeze({
+            name,
+            themeVars: Object.freeze(themeVars),
+            diffs: Object.freeze(diffs),
+            ...(media ? { media } : {}),
+        });
+    }
+    return Object.freeze(out);
+};
+exports.resolveThemeVariations = resolveThemeVariations;
+const unwrapThemeVariation = (declaration, name) => {
+    if (!isMediaThemeVariation(declaration)) {
+        return { variation: declaration };
+    }
+    const extra = Object.keys(declaration).filter((key) => key !== 'media' && key !== 'variation');
+    if (extra.length > 0) {
+        throw new Error(`Variation "${name}" media declaration cannot include keys ${extra.map((key) => `"${key}"`).join(', ')}.`);
+    }
+    if (declaration.media.trim().length === 0) {
+        throw new Error(`Variation "${name}" has an empty media query.`);
+    }
+    return { media: declaration.media, variation: declaration.variation };
+};
+const isMediaThemeVariation = (value) => {
+    if (!isPlainObject(value)) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.media === 'string' && isPlainObject(candidate.variation));
+};
+const applyVariation = (base, variation, variationName, path) => {
+    if (variation === undefined) {
+        return base;
+    }
+    if ((0, tokens_1.isScaleToken)(base) || (0, tokens_1.isScaleToken)(variation)) {
+        if (!(0, tokens_1.isScaleToken)(base) || !(0, tokens_1.isScaleToken)(variation)) {
+            throw new Error(`Variation "${variationName}": "${path}" is a ScaleToken in one tree and not the other.`);
+        }
+        if (base.value !== variation.value || base.cq !== variation.cq) {
+            throw new Error(`Variation "${variationName}": ScaleToken at "${path}" disagrees with the base (scale tokens inline and cannot vary by variation).`);
+        }
+        return base;
+    }
+    if ((0, tokens_1.isSchemePair)(variation) || typeof variation === 'string') {
+        if (typeof base !== 'string' && !(0, tokens_1.isSchemePair)(base)) {
+            throw new Error(`Variation "${variationName}": "${path}" is a leaf in the variation and a group in the base.`);
+        }
+        return variation;
+    }
+    if (isThemeGroup(variation) && isThemeGroup(base)) {
+        const out = Object.assign(dict(), base);
+        for (const [key, child] of Object.entries(variation)) {
+            if (!Object.hasOwn(base, key)) {
+                throw new Error(`Variation "${variationName}": unknown path "${childPath(path, key)}".`);
+            }
+            out[key] = applyVariation(base[key], child, variationName, childPath(path, key));
+        }
+        return out;
+    }
+    throw new Error(`Variation "${variationName}": "${path || '(root)'}" is not a valid partial.`);
+};
+const isThemeGroup = (value) => isPlainObject(value) && !(0, tokens_1.isSchemePair)(value) && !(0, tokens_1.isScaleToken)(value);
+const walkValues = (node, path, themeVars, scheme) => {
+    if ((0, tokens_1.isScaleToken)(node)) {
+        assertNotRoot(path);
+        return node.value;
+    }
+    if ((0, tokens_1.isSchemePair)(node) || typeof node === 'string') {
+        assertNotRoot(path);
+        const definition = themeVars[path];
+        if (!definition) {
+            throw new Error(`No theme var for "${path}".`);
+        }
+        return definition[scheme];
+    }
+    if (isPlainObject(node)) {
+        const out = dict();
+        for (const [key, child] of Object.entries(node)) {
+            out[key] = walkValues(child, childPath(path, key), themeVars, scheme);
+        }
+        return Object.freeze(out);
+    }
+    const label = path === '' ? 'theme root' : `"${path}"`;
+    throw new Error(`Theme leaf at ${label} must be a string, lightDark(...), or ScaleToken.`);
+};
+const walk = (node, path, prefix, themeVars) => {
+    if ((0, tokens_1.isScaleToken)(node)) {
+        assertNotRoot(path);
+        return node;
+    }
+    if ((0, tokens_1.isSchemePair)(node)) {
+        assertNotRoot(path);
+        return registerCssToken(path, prefix, node.light, node.dark, themeVars);
+    }
+    if (typeof node === 'string') {
+        assertNotRoot(path);
+        return registerCssToken(path, prefix, node, node, themeVars);
+    }
+    if (isPlainObject(node)) {
+        const out = dict();
+        for (const [key, child] of Object.entries(node)) {
+            assertThemeKey(key);
+            const childPath = path === '' ? key : `${path}/${key}`;
+            out[key] = walk(child, childPath, prefix, themeVars);
+        }
+        return Object.freeze(out);
+    }
+    const label = path === '' ? 'theme root' : `"${path}"`;
+    throw new Error(`Theme leaf at ${label} must be a string, lightDark(...), or ScaleToken.`);
+};
+const registerCssToken = (path, prefix, light, dark, themeVars) => {
+    const cssVar = (0, names_1.cssVarName)(prefix, path);
+    themeVars[path] = { path, cssVar, light, dark };
+    return (0, tokens_1.themeToken)(path, cssVar);
+};
+const zipNode = (light, dark, path) => {
+    if ((0, tokens_1.isScaleToken)(light) || (0, tokens_1.isScaleToken)(dark)) {
+        if (!(0, tokens_1.isScaleToken)(light) || !(0, tokens_1.isScaleToken)(dark)) {
+            throw new Error(`zipSchemes: "${path}" is a ScaleToken in one scheme and not the other.`);
+        }
+        if (light.value !== dark.value || light.cq !== dark.cq) {
+            throw new Error(`zipSchemes: ScaleToken at "${path}" disagrees across schemes.`);
+        }
+        return light;
+    }
+    if (typeof light === 'string' || typeof dark === 'string') {
+        if (typeof light !== 'string' || typeof dark !== 'string') {
+            throw new Error(`zipSchemes: "${path}" is a string in one scheme and not the other.`);
+        }
+        return light === dark ? light : (0, tokens_1.lightDark)(light, dark);
+    }
+    if (isPlainObject(light) && isPlainObject(dark)) {
+        for (const key of Object.keys(light)) {
+            if (!Object.hasOwn(dark, key)) {
+                throw new Error(`zipSchemes: "${childPath(path, key)}" is missing in the dark tree.`);
+            }
+        }
+        for (const key of Object.keys(dark)) {
+            if (!Object.hasOwn(light, key)) {
+                throw new Error(`zipSchemes: "${childPath(path, key)}" is missing in the light tree.`);
+            }
+        }
+        const out = dict();
+        for (const key of Object.keys(light)) {
+            out[key] = zipNode(light[key], dark[key], childPath(path, key));
+        }
+        return out;
+    }
+    throw new Error(`zipSchemes: "${path || '(root)'}" must be a string, ScaleToken, or nested object.`);
+};
+const childPath = (path, key) => path === '' ? key : `${path}/${key}`;
+const assertNotRoot = (path) => {
+    if (path === '') {
+        throw new Error('Theme root must be an object.');
+    }
+};
+const assertThemeKey = (key) => {
+    if (!THEME_KEY_RE.test(key)) {
+        throw new Error(`Theme key "${key}" must match /^[A-Za-z_][A-Za-z0-9_]*$/ (hyphens are rejected so path segments reverse uniquely).`);
+    }
+};
+const dict = () => Object.create(null);
+const isPlainObject = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+//# sourceMappingURL=theme.js.map

package/dist/cjs/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/theme.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 { ThemeVarDefinition } from './environment';\nimport { cssVarName } from './names';\nimport {\n  type CssToken,\n  isScaleToken,\n  isSchemePair,\n  lightDark,\n  type ScaleToken,\n  type SchemePair,\n  themeToken,\n} from './tokens';\n\n/** Theme-tree keys omit `-` so hyphen-joined custom properties reverse uniquely. */\nconst THEME_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** One authoring leaf: invariant string, {@link lightDark} pair, or {@link ScaleToken}. */\nexport type ThemeLeaf = string | SchemePair | ScaleToken;\n\n/** Nested authoring tree. Keys must match `/^[A-Za-z_][A-Za-z0-9_]*$/`. */\nexport type ThemeTree = {\n  readonly [key: string]: ThemeLeaf | ThemeTree;\n};\n\n/** Per-scheme value tree accepted by {@link zipSchemes}. */\nexport type SchemeValueTree = {\n  readonly [key: string]: string | ScaleToken | SchemeValueTree;\n};\n\n/** Token tree derived from an authoring {@link ThemeTree}. */\nexport type TokensOf<T> = T extends ScaleToken\n  ? ScaleToken\n  : T extends SchemePair | string\n    ? CssToken\n    : T extends object\n      ? { readonly [K in keyof T]: TokensOf<T[K]> }\n      : never;\n\n/** Literal-value tree for one scheme. {@link ScaleToken} leaves use `.value`. */\nexport type ValuesOf<T> = T extends ScaleToken\n  ? string\n  : T extends SchemePair | string\n    ? string\n    : T extends object\n      ? { readonly [K in keyof T]: ValuesOf<T[K]> }\n      : never;\n\n/** Slash-delimited theme-var paths (excludes {@link ScaleToken} leaves). */\nexport type PathsOf<T, Prefix extends string = ''> = T extends ScaleToken\n  ? never\n  : T extends SchemePair | string\n    ? Prefix extends ''\n      ? never\n      : Prefix\n    : T extends object\n      ? {\n          [K in keyof T & string]: PathsOf<\n            T[K],\n            Prefix extends '' ? K : `${Prefix}/${K}`\n          >;\n        }[keyof T & string]\n      : never;\n\n/** {@link zipSchemes} output: equal strings collapse; differing strings become {@link SchemePair}. */\nexport type Zipped<T> = T extends ScaleToken\n  ? ScaleToken\n  : T extends string\n    ? string | SchemePair\n    : T extends object\n      ? { readonly [K in keyof T]: Zipped<T[K]> }\n      : never;\n\n/** Partial variation of a {@link ThemeTree}. Leaves may change kind between `string` and {@link SchemePair}. */\nexport type DeepPartialTheme<T> = T extends ScaleToken\n  ? ScaleToken\n  : T extends SchemePair | string\n    ? string | SchemePair\n    : T extends object\n      ? { readonly [K in keyof T]?: DeepPartialTheme<T[K]> }\n      : never;\n\n/** Media-conditioned variation. `media` is intrinsic; it is not a selector. */\nexport interface MediaThemeVariation<T extends ThemeTree = ThemeTree> {\n  /** Media query wrapping this variation's emitted diffs. */\n  readonly media: string;\n  /** Partial variation of the base theme. */\n  readonly variation: DeepPartialTheme<T>;\n}\n\n/** Named variation: a partial of the base, or a media-conditioned partial. */\nexport type ThemeVariation<T extends ThemeTree = ThemeTree> =\n  DeepPartialTheme<T> | MediaThemeVariation<T>;\n\n/** One named variation resolved against the base at construction. */\nexport interface ResolvedThemeVariation {\n  /** Name passed in `variations`. */\n  readonly name: string;\n  /** Intrinsic media query, when declared. */\n  readonly media?: string;\n  /** Base theme vars with this variation applied. */\n  readonly themeVars: Readonly<Record<string, ThemeVarDefinition>>;\n  /** Paths whose serialized value differs from the base. */\n  readonly diffs: Readonly<Record<string, ThemeVarDefinition>>;\n}\n\n/**\n * Folds two per-scheme trees into one authoring tree. Equal string leaves stay bare; differing strings become {@link lightDark}. {@link ScaleToken} leaves must agree.\n *\n * @param light Light-scheme value tree.\n * @param dark Dark-scheme value tree.\n * @throws If shapes, leaf kinds, or scale values disagree, or if a differing string pair is not a CSS `<color>`.\n */\nexport const zipSchemes = <T extends SchemeValueTree>(\n  light: T,\n  dark: T\n): Zipped<T> => zipNode(light, dark, '') as Zipped<T>;\n\n/** Walks `theme` into a {@link CssToken} / {@link ScaleToken} tree and a `themeVars` registry. */\nexport const deriveTheme = <T extends ThemeTree>(\n  prefix: string,\n  theme: T\n): { tokens: TokensOf<T>; themeVars: Record<string, ThemeVarDefinition> } => {\n  const themeVars = dict<ThemeVarDefinition>();\n  const tokens = walk(theme, '', prefix, themeVars) as TokensOf<T>;\n  return { tokens, themeVars };\n};\n\n/**\n * Nested literal values for one scheme. Walks `theme` so {@link ScaleToken} leaves resolve to `.value`.\n *\n * @param theme Authoring tree that produced `themeVars`.\n * @param themeVars Base registry from {@link Distillery.themeVars}.\n * @param scheme Which side of each {@link ThemeVarDefinition} to read.\n * @param variation When set, overridden paths come from `variation.diffs`; everything else stays on `themeVars`.\n */\nexport const resolveThemeValues = <T extends ThemeTree>(\n  theme: T,\n  themeVars: Readonly<Record<string, ThemeVarDefinition>>,\n  scheme: 'light' | 'dark',\n  variation?: ResolvedThemeVariation\n): ValuesOf<T> => {\n  const vars = variation\n    ? Object.assign(dict<ThemeVarDefinition>(), themeVars, variation.diffs)\n    : themeVars;\n  return walkValues(theme, '', vars, scheme) as ValuesOf<T>;\n};\n\n/** Looks up a declared variation. @throws If `name` is not in `variations`. */\nexport const requireThemeVariation = (\n  variations: Readonly<Record<string, ResolvedThemeVariation>> | undefined,\n  name: string\n): ResolvedThemeVariation => {\n  const resolved =\n    variations && Object.hasOwn(variations, name)\n      ? variations[name]\n      : undefined;\n  if (!resolved) {\n    const declared = Object.keys(variations ?? {});\n    const suffix =\n      declared.length > 0\n        ? ` Declared: ${declared.join(', ')}.`\n        : ' No variations were declared.';\n    throw new Error(`Unknown variation \"${name}\".${suffix}`);\n  }\n  return resolved;\n};\n\n/** Serialized `light` / `light-dark(light, dark)` form used in emission and diffs. */\nexport const serializedThemeValue = ({\n  light,\n  dark,\n}: ThemeVarDefinition): string =>\n  light === dark ? light : `light-dark(${light},${dark})`;\n\n/**\n * Resolves named `variations` against `base`. Variations extend the base only (no chains).\n *\n * @throws If a variation introduces an unknown path, a leaf-kind mismatch, or a diverging {@link ScaleToken}.\n */\nexport const resolveThemeVariations = (\n  prefix: string,\n  base: ThemeTree,\n  baseVars: Readonly<Record<string, ThemeVarDefinition>>,\n  variations: Readonly<Record<string, ThemeVariation>> | undefined\n): Readonly<Record<string, ResolvedThemeVariation>> => {\n  if (!variations) {\n    return {};\n  }\n  const out = dict<ResolvedThemeVariation>();\n  for (const [name, declaration] of Object.entries(variations)) {\n    const { media, variation } = unwrapThemeVariation(declaration, name);\n    const merged = applyVariation(base, variation, name, '') as ThemeTree;\n    const { themeVars } = deriveTheme(prefix, merged);\n    const diffs = dict<ThemeVarDefinition>();\n    for (const [path, definition] of Object.entries(themeVars)) {\n      const baseDefinition = baseVars[path];\n      if (\n        !baseDefinition ||\n        serializedThemeValue(definition) !==\n          serializedThemeValue(baseDefinition)\n      ) {\n        diffs[path] = definition;\n      }\n    }\n    out[name] = Object.freeze({\n      name,\n      themeVars: Object.freeze(themeVars),\n      diffs: Object.freeze(diffs),\n      ...(media ? { media } : {}),\n    });\n  }\n  return Object.freeze(out);\n};\n\nconst unwrapThemeVariation = (\n  declaration: ThemeVariation,\n  name: string\n): { media?: string; variation: DeepPartialTheme<ThemeTree> } => {\n  if (!isMediaThemeVariation(declaration)) {\n    return { variation: declaration };\n  }\n  const extra = Object.keys(declaration).filter(\n    (key) => key !== 'media' && key !== 'variation'\n  );\n  if (extra.length > 0) {\n    throw new Error(\n      `Variation \"${name}\" media declaration cannot include keys ${extra.map((key) => `\"${key}\"`).join(', ')}.`\n    );\n  }\n  if (declaration.media.trim().length === 0) {\n    throw new Error(`Variation \"${name}\" has an empty media query.`);\n  }\n  return { media: declaration.media, variation: declaration.variation };\n};\n\nconst isMediaThemeVariation = (\n  value: ThemeVariation\n): value is MediaThemeVariation => {\n  if (!isPlainObject(value)) {\n    return false;\n  }\n  const candidate = value;\n  return (\n    typeof candidate.media === 'string' && isPlainObject(candidate.variation)\n  );\n};\n\nconst applyVariation = (\n  base: unknown,\n  variation: unknown,\n  variationName: string,\n  path: string\n): unknown => {\n  if (variation === undefined) {\n    return base;\n  }\n  if (isScaleToken(base) || isScaleToken(variation)) {\n    if (!isScaleToken(base) || !isScaleToken(variation)) {\n      throw new Error(\n        `Variation \"${variationName}\": \"${path}\" is a ScaleToken in one tree and not the other.`\n      );\n    }\n    if (base.value !== variation.value || base.cq !== variation.cq) {\n      throw new Error(\n        `Variation \"${variationName}\": ScaleToken at \"${path}\" disagrees with the base (scale tokens inline and cannot vary by variation).`\n      );\n    }\n    return base;\n  }\n  if (isSchemePair(variation) || typeof variation === 'string') {\n    if (typeof base !== 'string' && !isSchemePair(base)) {\n      throw new Error(\n        `Variation \"${variationName}\": \"${path}\" is a leaf in the variation and a group in the base.`\n      );\n    }\n    return variation;\n  }\n  if (isThemeGroup(variation) && isThemeGroup(base)) {\n    const out = Object.assign(dict<unknown>(), base);\n    for (const [key, child] of Object.entries(variation)) {\n      if (!Object.hasOwn(base, key)) {\n        throw new Error(\n          `Variation \"${variationName}\": unknown path \"${childPath(path, key)}\".`\n        );\n      }\n      out[key] = applyVariation(\n        base[key],\n        child,\n        variationName,\n        childPath(path, key)\n      );\n    }\n    return out;\n  }\n  throw new Error(\n    `Variation \"${variationName}\": \"${path || '(root)'}\" is not a valid partial.`\n  );\n};\n\nconst isThemeGroup = (value: unknown): value is Record<string, unknown> =>\n  isPlainObject(value) && !isSchemePair(value) && !isScaleToken(value);\n\nconst walkValues = (\n  node: unknown,\n  path: string,\n  themeVars: Readonly<Record<string, ThemeVarDefinition>>,\n  scheme: 'light' | 'dark'\n): unknown => {\n  if (isScaleToken(node)) {\n    assertNotRoot(path);\n    return node.value;\n  }\n  if (isSchemePair(node) || typeof node === 'string') {\n    assertNotRoot(path);\n    const definition = themeVars[path];\n    if (!definition) {\n      throw new Error(`No theme var for \"${path}\".`);\n    }\n    return definition[scheme];\n  }\n  if (isPlainObject(node)) {\n    const out = dict<unknown>();\n    for (const [key, child] of Object.entries(node)) {\n      out[key] = walkValues(child, childPath(path, key), themeVars, scheme);\n    }\n    return Object.freeze(out);\n  }\n  const label = path === '' ? 'theme root' : `\"${path}\"`;\n  throw new Error(\n    `Theme leaf at ${label} must be a string, lightDark(...), or ScaleToken.`\n  );\n};\n\nconst walk = (\n  node: unknown,\n  path: string,\n  prefix: string,\n  themeVars: Record<string, ThemeVarDefinition>\n): unknown => {\n  if (isScaleToken(node)) {\n    assertNotRoot(path);\n    return node;\n  }\n  if (isSchemePair(node)) {\n    assertNotRoot(path);\n    return registerCssToken(path, prefix, node.light, node.dark, themeVars);\n  }\n  if (typeof node === 'string') {\n    assertNotRoot(path);\n    return registerCssToken(path, prefix, node, node, themeVars);\n  }\n  if (isPlainObject(node)) {\n    const out = dict<unknown>();\n    for (const [key, child] of Object.entries(node)) {\n      assertThemeKey(key);\n      const childPath = path === '' ? key : `${path}/${key}`;\n      out[key] = walk(child, childPath, prefix, themeVars);\n    }\n    return Object.freeze(out);\n  }\n  const label = path === '' ? 'theme root' : `\"${path}\"`;\n  throw new Error(\n    `Theme leaf at ${label} must be a string, lightDark(...), or ScaleToken.`\n  );\n};\n\nconst registerCssToken = (\n  path: string,\n  prefix: string,\n  light: string,\n  dark: string,\n  themeVars: Record<string, ThemeVarDefinition>\n): CssToken => {\n  const cssVar = cssVarName(prefix, path);\n  themeVars[path] = { path, cssVar, light, dark };\n  return themeToken(path, cssVar);\n};\n\nconst zipNode = (light: unknown, dark: unknown, path: string): unknown => {\n  if (isScaleToken(light) || isScaleToken(dark)) {\n    if (!isScaleToken(light) || !isScaleToken(dark)) {\n      throw new Error(\n        `zipSchemes: \"${path}\" is a ScaleToken in one scheme and not the other.`\n      );\n    }\n    if (light.value !== dark.value || light.cq !== dark.cq) {\n      throw new Error(\n        `zipSchemes: ScaleToken at \"${path}\" disagrees across schemes.`\n      );\n    }\n    return light;\n  }\n  if (typeof light === 'string' || typeof dark === 'string') {\n    if (typeof light !== 'string' || typeof dark !== 'string') {\n      throw new Error(\n        `zipSchemes: \"${path}\" is a string in one scheme and not the other.`\n      );\n    }\n    return light === dark ? light : lightDark(light, dark);\n  }\n  if (isPlainObject(light) && isPlainObject(dark)) {\n    for (const key of Object.keys(light)) {\n      if (!Object.hasOwn(dark, key)) {\n        throw new Error(\n          `zipSchemes: \"${childPath(path, key)}\" is missing in the dark tree.`\n        );\n      }\n    }\n    for (const key of Object.keys(dark)) {\n      if (!Object.hasOwn(light, key)) {\n        throw new Error(\n          `zipSchemes: \"${childPath(path, key)}\" is missing in the light tree.`\n        );\n      }\n    }\n    const out = dict<unknown>();\n    for (const key of Object.keys(light)) {\n      out[key] = zipNode(light[key], dark[key], childPath(path, key));\n    }\n    return out;\n  }\n  throw new Error(\n    `zipSchemes: \"${path || '(root)'}\" must be a string, ScaleToken, or nested object.`\n  );\n};\n\nconst childPath = (path: string, key: string): string =>\n  path === '' ? key : `${path}/${key}`;\n\nconst assertNotRoot = (path: string): void => {\n  if (path === '') {\n    throw new Error('Theme root must be an object.');\n  }\n};\n\nconst assertThemeKey = (key: string): void => {\n  if (!THEME_KEY_RE.test(key)) {\n    throw new Error(\n      `Theme key \"${key}\" must match /^[A-Za-z_][A-Za-z0-9_]*$/ (hyphens are rejected so path segments reverse uniquely).`\n    );\n  }\n};\n\nconst dict = <T>(): Record<string, T> =>\n  Object.create(null) as Record<string, T>;\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n"]}

package/dist/cjs/tokens/contextual_var.js

@@ -0,0 +1,39 @@
+"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.isContextualCssVarName = exports.isContextualCssVar = exports.contextualVar = void 0;
+const kind_1 = require("./kind");
+/** Shared contextual var. Stringifies to `var(<prop>)`; `.name` is the ident. */
+const contextualVar = (path, prop) => {
+    const ref = `var(${prop})`;
+    const propToString = () => prop;
+    const refToString = () => ref;
+    const name = {
+        __kind: 'contextual-var-name',
+        path,
+        name: prop,
+        toString: propToString,
+        [Symbol.toPrimitive]: propToString,
+    };
+    return {
+        __kind: 'contextual-var',
+        path,
+        name,
+        ref,
+        toString: refToString,
+        [Symbol.toPrimitive]: refToString,
+    };
+};
+exports.contextualVar = contextualVar;
+/** `true` when `value` is a {@link ContextualCssVar}. @param value Value to test. */
+const isContextualCssVar = (value) => (0, kind_1.hasKind)(value, 'contextual-var');
+exports.isContextualCssVar = isContextualCssVar;
+/** `true` when `value` is a {@link ContextualCssVarName}. @param value Value to test. */
+const isContextualCssVarName = (value) => (0, kind_1.hasKind)(value, 'contextual-var-name');
+exports.isContextualCssVarName = isContextualCssVarName;
+//# sourceMappingURL=contextual_var.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextual_var.js","sourceRoot":"","sources":["../../../src/tokens/contextual_var.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAAiC;AAgCjC,iFAAiF;AAC1E,MAAM,aAAa,GAAG,CAC3B,IAAsB,EACtB,IAAmB,EACD,EAAE;IACpB,MAAM,GAAG,GAAuB,OAAO,IAAI,GAAG,CAAC;IAC/C,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC;IACxC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,GAAG,CAAC;IACtC,MAAM,IAAI,GAAyB;QACjC,MAAM,EAAE,qBAAqB;QAC7B,IAAI;QACJ,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,YAAY;QACtB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,YAAY;KACnC,CAAC;IACF,OAAO;QACL,MAAM,EAAE,gBAAgB;QACxB,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,QAAQ,EAAE,WAAW;QACrB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,WAAW;KAClC,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,aAAa,iBAsBxB;AAEF,qFAAqF;AAC9E,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC9E,IAAA,cAAO,EAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;AADtB,QAAA,kBAAkB,sBACI;AAEnC,yFAAyF;AAClF,MAAM,sBAAsB,GAAG,CACpC,KAAc,EACiB,EAAE,CAAC,IAAA,cAAO,EAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;AAF7D,QAAA,sBAAsB,0BAEuC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { hasKind } from './kind';\n\n/** Represents a contextual CSS variable name. Stringifies to its custom property name. */\nexport interface ContextualCssVarName {\n  /** Brand for {@link isContextualCssVarName}. */\n  readonly __kind: 'contextual-var-name';\n  /** Group/key path for this variable. */\n  readonly path: `vars/${string}`;\n  /** Actual emitted CSS custom property name. */\n  readonly name: `--${string}`;\n  /** Stringifies to {@link ContextualCssVarName.name}. */\n  toString(): string;\n  /** Template interpolation; same as {@link ContextualCssVarName.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** Represents a contextual CSS variable. Stringifies to `var(--...)`. */\nexport interface ContextualCssVar {\n  /** Brand for {@link isContextualCssVar}. */\n  readonly __kind: 'contextual-var';\n  /** Group/key path for this variable. */\n  readonly path: `vars/${string}`;\n  /** Wrapper yielding just the custom property name. */\n  readonly name: ContextualCssVarName;\n  /** Usable CSS `var(...)` reference string. */\n  readonly ref: `var(--${string})`;\n  /** Stringifies to {@link ContextualCssVar.ref}. */\n  toString(): string;\n  /** Template interpolation; same as {@link ContextualCssVar.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** Shared contextual var. Stringifies to `var(<prop>)`; `.name` is the ident. */\nexport const contextualVar = (\n  path: `vars/${string}`,\n  prop: `--${string}`\n): ContextualCssVar => {\n  const ref: `var(--${string})` = `var(${prop})`;\n  const propToString = (): string => prop;\n  const refToString = (): string => ref;\n  const name: ContextualCssVarName = {\n    __kind: 'contextual-var-name',\n    path,\n    name: prop,\n    toString: propToString,\n    [Symbol.toPrimitive]: propToString,\n  };\n  return {\n    __kind: 'contextual-var',\n    path,\n    name,\n    ref,\n    toString: refToString,\n    [Symbol.toPrimitive]: refToString,\n  };\n};\n\n/** `true` when `value` is a {@link ContextualCssVar}. @param value Value to test. */\nexport const isContextualCssVar = (value: unknown): value is ContextualCssVar =>\n  hasKind(value, 'contextual-var');\n\n/** `true` when `value` is a {@link ContextualCssVarName}. @param value Value to test. */\nexport const isContextualCssVarName = (\n  value: unknown\n): value is ContextualCssVarName => hasKind(value, 'contextual-var-name');\n"]}

package/dist/cjs/tokens/index.js

@@ -0,0 +1,24 @@
+"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.themeToken = exports.isCssToken = exports.scaleToken = exports.isScaleToken = exports.cq = exports.lightDark = exports.isSchemePair = exports.isContextualCssVarName = exports.isContextualCssVar = exports.contextualVar = void 0;
+var contextual_var_1 = require("./contextual_var");
+Object.defineProperty(exports, "contextualVar", { enumerable: true, get: function () { return contextual_var_1.contextualVar; } });
+Object.defineProperty(exports, "isContextualCssVar", { enumerable: true, get: function () { return contextual_var_1.isContextualCssVar; } });
+Object.defineProperty(exports, "isContextualCssVarName", { enumerable: true, get: function () { return contextual_var_1.isContextualCssVarName; } });
+var light_dark_1 = require("./light_dark");
+Object.defineProperty(exports, "isSchemePair", { enumerable: true, get: function () { return light_dark_1.isSchemePair; } });
+Object.defineProperty(exports, "lightDark", { enumerable: true, get: function () { return light_dark_1.lightDark; } });
+var scale_token_1 = require("./scale_token");
+Object.defineProperty(exports, "cq", { enumerable: true, get: function () { return scale_token_1.cq; } });
+Object.defineProperty(exports, "isScaleToken", { enumerable: true, get: function () { return scale_token_1.isScaleToken; } });
+Object.defineProperty(exports, "scaleToken", { enumerable: true, get: function () { return scale_token_1.scaleToken; } });
+var theme_token_1 = require("./theme_token");
+Object.defineProperty(exports, "isCssToken", { enumerable: true, get: function () { return theme_token_1.isCssToken; } });
+Object.defineProperty(exports, "themeToken", { enumerable: true, get: function () { return theme_token_1.themeToken; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tokens/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mDAM0B;AAHxB,+GAAA,aAAa,OAAA;AACb,oHAAA,kBAAkB,OAAA;AAClB,wHAAA,sBAAsB,OAAA;AAExB,2CAAwE;AAA9C,0GAAA,YAAY,OAAA;AAAE,uGAAA,SAAS,OAAA;AACjD,6CAA8E;AAApD,iGAAA,EAAE,OAAA;AAAE,2GAAA,YAAY,OAAA;AAAE,yGAAA,UAAU,OAAA;AACtD,6CAAsE;AAA9C,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,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  type ContextualCssVar,\n  type ContextualCssVarName,\n  contextualVar,\n  isContextualCssVar,\n  isContextualCssVarName,\n} from './contextual_var';\nexport { type SchemePair, isSchemePair, lightDark } from './light_dark';\nexport { type ScaleToken, cq, isScaleToken, scaleToken } from './scale_token';\nexport { type CssToken, isCssToken, themeToken } from './theme_token';\n"]}

package/dist/cjs/tokens/kind.js

@@ -0,0 +1,14 @@
+"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.hasKind = void 0;
+const hasKind = (value, kind) => Boolean(value &&
+    typeof value === 'object' &&
+    value.__kind === kind);
+exports.hasKind = hasKind;
+//# sourceMappingURL=kind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kind.js","sourceRoot":"","sources":["../../../src/tokens/kind.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEI,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,IAAY,EAAW,EAAE,CAC/D,OAAO,CACL,KAAK;IACL,OAAO,KAAK,KAAK,QAAQ;IACxB,KAA6B,CAAC,MAAM,KAAK,IAAI,CAC/C,CAAC;AALS,QAAA,OAAO,WAKhB","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 const hasKind = (value: unknown, kind: string): boolean =>\n  Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as { __kind?: string }).__kind === kind\n  );\n"]}

package/dist/cjs/tokens/light_dark.js

@@ -0,0 +1,42 @@
+"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.lightDark = exports.isSchemePair = void 0;
+const kind_1 = require("./kind");
+/** `true` when `value` is a {@link SchemePair}. @param value Value to test. */
+const isSchemePair = (value) => (0, kind_1.hasKind)(value, 'scheme-pair');
+exports.isSchemePair = isSchemePair;
+/**
+ * Scheme-varying color pair. Both sides must be CSS `<color>` values.
+ *
+ * @param light Light color-scheme value.
+ * @param dark Dark color-scheme value.
+ * @throws If either value is not a CSS `<color>`.
+ */
+const lightDark = (light, dark) => {
+    assertCssColor(light, 'light');
+    assertCssColor(dark, 'dark');
+    return { __kind: 'scheme-pair', light, dark };
+};
+exports.lightDark = lightDark;
+const isCssColor = (value) => {
+    const trimmed = value.trim();
+    if (/^#(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(trimmed)) {
+        return true;
+    }
+    if (/^(?:transparent|currentcolor)$/i.test(trimmed)) {
+        return true;
+    }
+    return (/^(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color-mix|color)\(/i.test(trimmed) && trimmed.endsWith(')'));
+};
+const assertCssColor = (value, side) => {
+    if (!isCssColor(value)) {
+        throw new Error(`lightDark() ${side} value "${value}" is not a CSS <color>; light-dark() would be dropped by the browser.`);
+    }
+};
+//# sourceMappingURL=light_dark.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"light_dark.js","sourceRoot":"","sources":["../../../src/tokens/light_dark.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAAiC;AAYjC,+EAA+E;AACxE,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE,CAClE,IAAA,cAAO,EAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AADnB,QAAA,YAAY,gBACO;AAEhC;;;;;;GAMG;AACI,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,IAAY,EAAc,EAAE;IACnE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC,CAAC;AAJW,QAAA,SAAS,aAIpB;AAEF,MAAM,UAAU,GAAG,CAAC,KAAa,EAAW,EAAE;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,qDAAqD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,iCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,6DAA6D,CAAC,IAAI,CAChE,OAAO,CACR,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC3B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,IAAsB,EAAQ,EAAE;IACrE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,WAAW,KAAK,uEAAuE,CAC3G,CAAC;IACJ,CAAC;AACH,CAAC,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\nimport { hasKind } from './kind';\n\n/** Scheme-varying color pair. Compiles to `light-dark(light, dark)`. */\nexport interface SchemePair {\n  /** Brand for {@link isSchemePair}. */\n  readonly __kind: 'scheme-pair';\n  /** Light color-scheme value. Must be a CSS `<color>`. */\n  readonly light: string;\n  /** Dark color-scheme value. Must be a CSS `<color>`. */\n  readonly dark: string;\n}\n\n/** `true` when `value` is a {@link SchemePair}. @param value Value to test. */\nexport const isSchemePair = (value: unknown): value is SchemePair =>\n  hasKind(value, 'scheme-pair');\n\n/**\n * Scheme-varying color pair. Both sides must be CSS `<color>` values.\n *\n * @param light Light color-scheme value.\n * @param dark Dark color-scheme value.\n * @throws If either value is not a CSS `<color>`.\n */\nexport const lightDark = (light: string, dark: string): SchemePair => {\n  assertCssColor(light, 'light');\n  assertCssColor(dark, 'dark');\n  return { __kind: 'scheme-pair', light, dark };\n};\n\nconst isCssColor = (value: string): boolean => {\n  const trimmed = value.trim();\n  if (/^#(?:[\\da-f]{3}|[\\da-f]{4}|[\\da-f]{6}|[\\da-f]{8})$/i.test(trimmed)) {\n    return true;\n  }\n  if (/^(?:transparent|currentcolor)$/i.test(trimmed)) {\n    return true;\n  }\n  return (\n    /^(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color-mix|color)\\(/i.test(\n      trimmed\n    ) && trimmed.endsWith(')')\n  );\n};\n\nconst assertCssColor = (value: string, side: 'light' | 'dark'): void => {\n  if (!isCssColor(value)) {\n    throw new Error(\n      `lightDark() ${side} value \"${value}\" is not a CSS <color>; light-dark() would be dropped by the browser.`\n    );\n  }\n};\n"]}

package/dist/cjs/tokens/scale_token.js

@@ -0,0 +1,28 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isScaleToken = exports.cq = exports.scaleToken = void 0;
+const kind_1 = require("./kind");
+/** Literal size token. Stringifies to `value`; `cq` is the container-relative variant. */
+const scaleToken = (value, cq) => {
+    const valueToString = () => value;
+    return {
+        __kind: 'scale-token',
+        value,
+        cq,
+        toString: valueToString,
+        [Symbol.toPrimitive]: valueToString,
+    };
+};
+exports.scaleToken = scaleToken;
+/** Alias of {@link scaleToken} for theme-tree authoring. */
+exports.cq = exports.scaleToken;
+/** `true` when `value` is a {@link ScaleToken}. @param value Value to test. */
+const isScaleToken = (value) => (0, kind_1.hasKind)(value, 'scale-token');
+exports.isScaleToken = isScaleToken;
+//# sourceMappingURL=scale_token.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scale_token.js","sourceRoot":"","sources":["../../../src/tokens/scale_token.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAAiC;AAgBjC,0FAA0F;AACnF,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAU,EAAc,EAAE;IAClE,MAAM,aAAa,GAAG,GAAW,EAAE,CAAC,KAAK,CAAC;IAC1C,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,KAAK;QACL,EAAE;QACF,QAAQ,EAAE,aAAa;QACvB,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,aAAa;KACpC,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,UAAU,cASrB;AAEF,4DAA4D;AAC/C,QAAA,EAAE,GAAG,kBAAU,CAAC;AAE7B,+EAA+E;AACxE,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE,CAClE,IAAA,cAAO,EAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AADnB,QAAA,YAAY,gBACO","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { hasKind } from './kind';\n\n/** Represents a CSS scale size token. Stringifies to its literal value. */\nexport interface ScaleToken {\n  /** Brand for {@link isScaleToken}. */\n  readonly __kind: 'scale-token';\n  /** Literal CSS value, inlined into declarations. */\n  readonly value: string;\n  /** Container-query-relative variant of `value`. */\n  readonly cq: string;\n  /** Stringifies to {@link ScaleToken.value}. */\n  toString(): string;\n  /** Template interpolation; same as {@link ScaleToken.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** Literal size token. Stringifies to `value`; `cq` is the container-relative variant. */\nexport const scaleToken = (value: string, cq: string): ScaleToken => {\n  const valueToString = (): string => value;\n  return {\n    __kind: 'scale-token',\n    value,\n    cq,\n    toString: valueToString,\n    [Symbol.toPrimitive]: valueToString,\n  };\n};\n\n/** Alias of {@link scaleToken} for theme-tree authoring. */\nexport const cq = scaleToken;\n\n/** `true` when `value` is a {@link ScaleToken}. @param value Value to test. */\nexport const isScaleToken = (value: unknown): value is ScaleToken =>\n  hasKind(value, 'scale-token');\n"]}