@elastic/distillate 0.1.0 → 0.2.0

package/dist/dom_sink.d.ts

@@ -1,27 +1,23 @@
-import type { StyleSink } from './emotion.js';
-/** Minimal interface for a DOM `<style>` element. */
-export interface StyleElementLike {
-    /** Current stylesheet text, or `null` before the first flush. */
-    textContent: string | null;
-}
+import type { StyleElementLike, StyleParentLike, StyleSink } from './sink.js';
+export type { StyleElementLike, StyleParentLike } from './sink.js';
 /** Minimal interface for a DOM `Document` able to create and append style tags. */
 export interface DocumentLike {
     /** Creates a `<style>` element. */
     createElement(tagName: 'style'): StyleElementLike;
-    /** Node that receives the created style element. */
-    readonly head: {
-        appendChild(node: StyleElementLike): void;
-    };
+    /** Default parent for the created style element. */
+    readonly head: StyleParentLike;
 }
 /** Host document and optional flush scheduler for a `<style>` sink. */
 export interface CreateDomSinkOptions {
-    /** The host document where the style element will be appended. */
+    /** Document that creates the style element. */
     document: DocumentLike;
+    /** Node that receives the style element, e.g. a `ShadowRoot`. Defaults to `document.head`. */
+    parent?: StyleParentLike;
     /** Defers the flush. Defaults to `queueMicrotask`. */
     schedule?: (flush: () => void) => void;
 }
 /**
  * One managed `<style>` element, rewritten on each flush.
  */
-export declare const createDomSink: ({ document, schedule, }: CreateDomSinkOptions) => StyleSink;
+export declare const createDomSink: ({ document, parent, schedule, }: CreateDomSinkOptions) => StyleSink;
 //# sourceMappingURL=dom_sink.d.ts.map

package/dist/dom_sink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom_sink.d.ts","sourceRoot":"","sources":["../src/dom_sink.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAClD,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE;QAAE,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAAE,CAAC;CAC9D;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,QAAQ,EAAE,YAAY,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,yBAG3B,oBAAoB,KAAG,SA2BzB,CAAC"}
+{"version":3,"file":"dom_sink.d.ts","sourceRoot":"","sources":["../src/dom_sink.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE3E,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEhE,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAClD,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,QAAQ,EAAE,YAAY,CAAC;IACvB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,iCAI3B,oBAAoB,KAAG,SA2BzB,CAAC"}

package/dist/dom_sink.js

@@ -7,7 +7,7 @@
 /**
  * One managed `<style>` element, rewritten on each flush.
  */
-export const createDomSink = ({ document, schedule = queueMicrotask, }) => {
+export const createDomSink = ({ document, parent, schedule = queueMicrotask, }) => {
     let element = null;
     let dirty = false;
     let latestRender = null;
@@ -18,7 +18,7 @@ export const createDomSink = ({ document, schedule = queueMicrotask, }) => {
         }
         if (!element) {
             element = document.createElement('style');
-            document.head.appendChild(element);
+            (parent ?? document.head).appendChild(element);
         }
         element.textContent = latestRender();
     };

package/dist/dom_sink.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom_sink.js","sourceRoot":"","sources":["../src/dom_sink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,QAAQ,EACR,QAAQ,GAAG,cAAc,GACJ,EAAa,EAAE;IACpC,IAAI,OAAO,GAA4B,IAAI,CAAC;IAC5C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,YAAY,GAA0B,IAAI,CAAC;IAE/C,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,KAAK,GAAG,KAAK,CAAC;QACd,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;IACvC,CAAC,CAAC;IAEF,OAAO;QACL,UAAU,CAAC,MAAM;YACf,YAAY,GAAG,MAAM,CAAC;YACtB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;YACb,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,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 { StyleSink } from './emotion';\n\n/** Minimal interface for a DOM `<style>` element. */\nexport interface StyleElementLike {\n  /** Current stylesheet text, or `null` before the first flush. */\n  textContent: string | null;\n}\n\n/** Minimal interface for a DOM `Document` able to create and append style tags. */\nexport interface DocumentLike {\n  /** Creates a `<style>` element. */\n  createElement(tagName: 'style'): StyleElementLike;\n  /** Node that receives the created style element. */\n  readonly head: { appendChild(node: StyleElementLike): void };\n}\n\n/** Host document and optional flush scheduler for a `<style>` sink. */\nexport interface CreateDomSinkOptions {\n  /** The host document where the style element will be appended. */\n  document: DocumentLike;\n  /** Defers the flush. Defaults to `queueMicrotask`. */\n  schedule?: (flush: () => void) => void;\n}\n\n/**\n * One managed `<style>` element, rewritten on each flush.\n */\nexport const createDomSink = ({\n  document,\n  schedule = queueMicrotask,\n}: CreateDomSinkOptions): StyleSink => {\n  let element: StyleElementLike | null = null;\n  let dirty = false;\n  let latestRender: (() => string) | null = null;\n\n  const flush = (): void => {\n    dirty = false;\n    if (!latestRender) {\n      return;\n    }\n    if (!element) {\n      element = document.createElement('style');\n      document.head.appendChild(element);\n    }\n    element.textContent = latestRender();\n  };\n\n  return {\n    invalidate(render) {\n      latestRender = render;\n      if (dirty) {\n        return;\n      }\n      dirty = true;\n      schedule(flush);\n    },\n  };\n};\n"]}
+{"version":3,"file":"dom_sink.js","sourceRoot":"","sources":["../src/dom_sink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,QAAQ,EACR,MAAM,EACN,QAAQ,GAAG,cAAc,GACJ,EAAa,EAAE;IACpC,IAAI,OAAO,GAA4B,IAAI,CAAC;IAC5C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,YAAY,GAA0B,IAAI,CAAC;IAE/C,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,KAAK,GAAG,KAAK,CAAC;QACd,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;IACvC,CAAC,CAAC;IAEF,OAAO;QACL,UAAU,CAAC,MAAM;YACf,YAAY,GAAG,MAAM,CAAC;YACtB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,KAAK,GAAG,IAAI,CAAC;YACb,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,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 { StyleElementLike, StyleParentLike, StyleSink } from './sink';\n\nexport type { StyleElementLike, StyleParentLike } from './sink';\n\n/** Minimal interface for a DOM `Document` able to create and append style tags. */\nexport interface DocumentLike {\n  /** Creates a `<style>` element. */\n  createElement(tagName: 'style'): StyleElementLike;\n  /** Default parent for the created style element. */\n  readonly head: StyleParentLike;\n}\n\n/** Host document and optional flush scheduler for a `<style>` sink. */\nexport interface CreateDomSinkOptions {\n  /** Document that creates the style element. */\n  document: DocumentLike;\n  /** Node that receives the style element, e.g. a `ShadowRoot`. Defaults to `document.head`. */\n  parent?: StyleParentLike;\n  /** Defers the flush. Defaults to `queueMicrotask`. */\n  schedule?: (flush: () => void) => void;\n}\n\n/**\n * One managed `<style>` element, rewritten on each flush.\n */\nexport const createDomSink = ({\n  document,\n  parent,\n  schedule = queueMicrotask,\n}: CreateDomSinkOptions): StyleSink => {\n  let element: StyleElementLike | null = null;\n  let dirty = false;\n  let latestRender: (() => string) | null = null;\n\n  const flush = (): void => {\n    dirty = false;\n    if (!latestRender) {\n      return;\n    }\n    if (!element) {\n      element = document.createElement('style');\n      (parent ?? document.head).appendChild(element);\n    }\n    element.textContent = latestRender();\n  };\n\n  return {\n    invalidate(render) {\n      latestRender = render;\n      if (dirty) {\n        return;\n      }\n      dirty = true;\n      schedule(flush);\n    },\n  };\n};\n"]}

package/dist/emotion.d.ts

@@ -1,11 +1,8 @@
 import type { Distillery } from './engine.js';
+import type { StyleSink } from './sink.js';
 import { type StyleHandle, type StylesModule } from './styles/index.js';
-export { createDomSink, type CreateDomSinkOptions, type DocumentLike, type StyleElementLike, } from './dom_sink.js';
-/** Receives stylesheet invalidation from Emotion compat modules. */
-export interface StyleSink {
-    /** Marks the sink dirty. `render` produces the current stylesheet when it flushes. */
-    invalidate(render: () => string): void;
-}
+export { createDomSink, type CreateDomSinkOptions, type DocumentLike, type StyleElementLike, type StyleParentLike, } from './dom_sink.js';
+export type { StyleSink } from './sink.js';
 /** Shared sink for Emotion compat modules on one registry. */
 export interface CreateEmotionOptions {
     /** Notified when a compat module registers. Shared across `createEmotion` calls on the same registry. */

package/dist/emotion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emotion.d.ts","sourceRoot":"","sources":["../src/emotion.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,yGAAyG;IACzG,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,8CAA8C;IAC9C,QAAQ,IAAI,MAAM,CAAC;IACnB,mEAAmE;IACnE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,KAAK,GACL,IAAI,GACJ,SAAS,GACT,UAAU,GACV,WAAW,GACX,YAAY,EAAE,GACd;IAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9C,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,uFAAuF;IACvF,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,UAAU,CAAC;IAC9E,8FAA8F;IAC9F,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC;IAC7C,gEAAgE;IAChE,YAAY,CACV,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,SAAS,OAAO,EAAE,GAC5B,IAAI,CAAC;IACR,2DAA2D;IAC3D,UAAU,IAAI,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,IAAI,SAAS,YAAY,EAAE,CAAC;CAC1C;AAoCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,EACnC,YAAY,UAAU,CAAC,OAAO,CAAC,EAC/B,UAAS,oBAAyB,KACjC,OAwIF,CAAC"}
+{"version":3,"file":"emotion.d.ts","sourceRoot":"","sources":["../src/emotion.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,yGAAyG;IACzG,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,8CAA8C;IAC9C,QAAQ,IAAI,MAAM,CAAC;IACnB,mEAAmE;IACnE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,KAAK,GACL,IAAI,GACJ,SAAS,GACT,UAAU,GACV,WAAW,GACX,YAAY,EAAE,GACd;IAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9C,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,uFAAuF;IACvF,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,UAAU,CAAC;IAC9E,8FAA8F;IAC9F,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAAC;IAC7C,gEAAgE;IAChE,YAAY,CACV,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,SAAS,OAAO,EAAE,GAC5B,IAAI,CAAC;IACR,2DAA2D;IAC3D,UAAU,IAAI,MAAM,CAAC;IACrB,mEAAmE;IACnE,aAAa,IAAI,SAAS,YAAY,EAAE,CAAC;CAC1C;AAoCD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,EACnC,YAAY,UAAU,CAAC,OAAO,CAAC,EAC/B,UAAS,oBAAyB,KACjC,OAwIF,CAAC"}

package/dist/emotion.js.map

@@ -1 +1 @@
-{"version":3,"file":"emotion.js","sourceRoot":"","sources":["../src/emotion.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 { Distillery } from './engine';\nimport { contentHash64 } from './hash';\nimport { flattenTemplate, isHandleLike, type TemplateSlice } from './nesting';\nimport {\n  globalStylesFromFlattened,\n  pendingHandleFromFlattened,\n  type StyleHandle,\n  type StyleRegistry,\n  type StylesModule,\n} from './styles';\n\nexport {\n  createDomSink,\n  type CreateDomSinkOptions,\n  type DocumentLike,\n  type StyleElementLike,\n} from './dom_sink';\n\n/** Receives stylesheet invalidation from Emotion compat modules. */\nexport interface StyleSink {\n  /** Marks the sink dirty. `render` produces the current stylesheet when it flushes. */\n  invalidate(render: () => string): void;\n}\n\n/** Shared sink for Emotion compat modules on one registry. */\nexport interface CreateEmotionOptions {\n  /** Notified when a compat module registers. Shared across `createEmotion` calls on the same registry. */\n  sink?: StyleSink;\n}\n\n/** Style handle that stringifies to its readable class name. */\nexport interface EmotionCss extends StyleHandle {\n  /** Stringifies to the readable class name. */\n  toString(): string;\n  /** Template interpolation; same as {@link EmotionCss.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** One `cx(...)` argument: a class, handle, list, or truthy map. */\nexport type ClassNameArg =\n  | string\n  | number\n  | false\n  | null\n  | undefined\n  | EmotionCss\n  | StyleHandle\n  | ClassNameArg[]\n  | { readonly [className: string]: boolean };\n\n/** Emotion-shaped authoring API bound to one Distillery registry. */\nexport interface Emotion {\n  /** Authors styles and returns a handle that can be used directly or passed to `cx`. */\n  css(strings: TemplateStringsArray, ...values: readonly unknown[]): EmotionCss;\n  /** Combines handles, conditional classes, and plain strings into a space-separated string. */\n  cx(...args: readonly ClassNameArg[]): string;\n  /** Defines styles that apply globally (e.g. `body`, `html`). */\n  injectGlobal(\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ): void;\n  /** Emits the full CSS for all generated emotion styles. */\n  stylesheet(): string;\n  /** Returns the underlying modules backing `injectGlobal` calls. */\n  globalModules(): readonly StylesModule[];\n}\n\n/** Per-registry Emotion compat cache. */\ninterface EmotionState {\n  /** `css` handles keyed by source hash. */\n  readonly wrappers: Map<string, EmotionCss>;\n  /** Original templates for inlining nested compat handles. */\n  readonly rawSources: Map<string, TemplateSlice>;\n  /** Module name → canonical source hash. */\n  readonly canonicalByModule: Map<string, string>;\n  /** Modules produced by `injectGlobal`. */\n  readonly globals: StylesModule[];\n  /** Handles created by this registry's Emotion instance. */\n  readonly brand: WeakSet<object>;\n  /** Sinks notified when a compat module registers. */\n  readonly sinks: Set<StyleSink>;\n}\n\nconst stateByRegistry = new WeakMap<StyleRegistry, EmotionState>();\n\nconst stateFor = (registry: StyleRegistry): EmotionState => {\n  let state = stateByRegistry.get(registry);\n  if (!state) {\n    state = {\n      wrappers: new Map(),\n      rawSources: new Map(),\n      canonicalByModule: new Map(),\n      globals: [],\n      brand: new WeakSet(),\n      sinks: new Set(),\n    };\n    stateByRegistry.set(registry, state);\n  }\n  return state;\n};\n\n/**\n * `@emotion/css`-shaped API over a distillery.\n *\n * `String(css\\`...\\`)` is the readable class name and does not collect. Passing the wrapper through `resolveClassName` collects and compacts like a native handle.\n *\n * @param distillery Bound distillery that owns the underlying registry.\n * @param options Optional sink for DOM injection.\n */\nexport const createEmotion = <TTokens>(\n  distillery: Distillery<TTokens>,\n  options: CreateEmotionOptions = {}\n): Emotion => {\n  const { registry } = distillery;\n  const state = stateFor(registry);\n\n  const stylesheet = (): string =>\n    distillery.renderStyles(distillery.stylesheetCollector('readable'));\n\n  const invalidateSinks = (): void => {\n    for (const sink of state.sinks) {\n      sink.invalidate(stylesheet);\n    }\n  };\n\n  if (options.sink) {\n    state.sinks.add(options.sink);\n    // Catch a late-attached sink up to styles already registered on this\n    // registry: cached `css`/`injectGlobal` calls return early without\n    // invalidating, so without this the managed `<style>` would miss every\n    // style registered before the sink was attached.\n    options.sink.invalidate(stylesheet);\n  }\n\n  const inlineValue = (\n    value: unknown,\n    position: 'selector' | 'statement'\n  ): TemplateSlice | null => {\n    if (position !== 'statement' || !isBranded(state, value)) {\n      return null;\n    }\n    return state.rawSources.get((value as StyleHandle).key) ?? null;\n  };\n\n  const css = (\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ): EmotionCss => {\n    assertTemplate(strings, 'css');\n    const hash = contentHash64(strings, values);\n    const cached = state.wrappers.get(hash);\n    if (cached) {\n      return cached;\n    }\n    const moduleName = `css-${hash}`;\n    const canonical = canonicalKey(strings, values);\n    detectCollision(state, moduleName, canonical);\n\n    const flat = flattenTemplate(strings, values, {\n      mode: 'self',\n      inlineValue,\n    });\n    const pending = pendingHandleFromFlattened(flat);\n    const module = distillery.createStyleModule(moduleName, () => ({\n      root: pending,\n    }));\n    const handle = module.handles.root;\n\n    state.rawSources.set(handle.key, {\n      strings: [...strings],\n      values: [...values],\n    });\n    const wrapper = makeWrapper(handle);\n    state.brand.add(wrapper);\n    state.wrappers.set(hash, wrapper);\n    state.canonicalByModule.set(moduleName, canonical);\n    invalidateSinks();\n    return wrapper;\n  };\n\n  const injectGlobal = (\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ): void => {\n    assertTemplate(strings, 'injectGlobal');\n    const hash = contentHash64(strings, values);\n    const moduleName = `global-${hash}`;\n    if (registry.module(moduleName)) {\n      return;\n    }\n    const canonical = canonicalKey(strings, values);\n    detectCollision(state, moduleName, canonical);\n\n    const flat = flattenTemplate(strings, values, {\n      mode: 'global',\n      inlineValue,\n    });\n    const module = distillery.createStyleModule(moduleName, () =>\n      globalStylesFromFlattened(flat)\n    );\n    state.canonicalByModule.set(moduleName, canonical);\n    state.globals.push(module);\n    invalidateSinks();\n  };\n\n  const cx = (...args: readonly ClassNameArg[]): string => {\n    const classes: string[] = [];\n    const walk = (arg: ClassNameArg): void => {\n      if (!arg) {\n        return;\n      }\n      if (typeof arg === 'string') {\n        classes.push(arg);\n        return;\n      }\n      if (typeof arg === 'number') {\n        classes.push(String(arg));\n        return;\n      }\n      if (Array.isArray(arg)) {\n        arg.forEach(walk);\n        return;\n      }\n      if (isBranded(state, arg)) {\n        classes.push(String(arg));\n        return;\n      }\n      if (isHandleLike(arg)) {\n        classes.push(arg.readableName);\n        return;\n      }\n      for (const [className, enabled] of Object.entries(arg)) {\n        if (enabled) {\n          classes.push(className);\n        }\n      }\n    };\n    args.forEach(walk);\n    return classes.join(' ');\n  };\n\n  return {\n    css,\n    cx,\n    injectGlobal,\n    stylesheet,\n    globalModules: () => [...state.globals],\n  };\n};\n\nconst makeWrapper = (handle: StyleHandle): EmotionCss => {\n  const readable = handle.readableName;\n  const asString = (): string => readable;\n  // Spread copy keeps `resolveClassName` (closed over the original handle) and\n  // `key` intact so collector dedupe and compaction work unchanged.\n  const wrapper = { ...handle } as EmotionCss & {\n    toString: () => string;\n    [Symbol.toPrimitive]: () => string;\n  };\n  wrapper.toString = asString;\n  wrapper[Symbol.toPrimitive] = asString;\n  return wrapper;\n};\n\nconst isBranded = (state: EmotionState, value: unknown): value is EmotionCss =>\n  Boolean(value && typeof value === 'object' && state.brand.has(value));\n\nconst assertTemplate = (strings: unknown, fn: string): void => {\n  if (!Array.isArray(strings) || !('raw' in (strings as object))) {\n    throw new Error(\n      `${fn} is a template tag; object styles (${fn}({...})) are not supported.`\n    );\n  }\n};\n\nconst detectCollision = (\n  state: EmotionState,\n  moduleName: string,\n  canonical: string\n): void => {\n  const prior = state.canonicalByModule.get(moduleName);\n  if (prior !== undefined && prior !== canonical) {\n    throw new Error(\n      `Content-hash collision for \"${moduleName}\"; two distinct templates hashed to the same name.`\n    );\n  }\n};\n\n// A cheap, exact collision tripwire independent of the (lossy) hash. NUL-joins\n// strings and String()s values — good enough because it is only ever compared\n// against another canonical string for the same module name.\nconst canonicalKey = (\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(String(values[index]));\n    }\n  });\n  return segments.join('\\u0000');\n};\n"]}
+{"version":3,"file":"emotion.js","sourceRoot":"","sources":["../src/emotion.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 { Distillery } from './engine';\nimport { contentHash64 } from './hash';\nimport { flattenTemplate, isHandleLike, type TemplateSlice } from './nesting';\nimport type { StyleSink } from './sink';\nimport {\n  globalStylesFromFlattened,\n  pendingHandleFromFlattened,\n  type StyleHandle,\n  type StyleRegistry,\n  type StylesModule,\n} from './styles';\n\nexport {\n  createDomSink,\n  type CreateDomSinkOptions,\n  type DocumentLike,\n  type StyleElementLike,\n  type StyleParentLike,\n} from './dom_sink';\nexport type { StyleSink } from './sink';\n\n/** Shared sink for Emotion compat modules on one registry. */\nexport interface CreateEmotionOptions {\n  /** Notified when a compat module registers. Shared across `createEmotion` calls on the same registry. */\n  sink?: StyleSink;\n}\n\n/** Style handle that stringifies to its readable class name. */\nexport interface EmotionCss extends StyleHandle {\n  /** Stringifies to the readable class name. */\n  toString(): string;\n  /** Template interpolation; same as {@link EmotionCss.toString}. */\n  [Symbol.toPrimitive](hint: string): string;\n}\n\n/** One `cx(...)` argument: a class, handle, list, or truthy map. */\nexport type ClassNameArg =\n  | string\n  | number\n  | false\n  | null\n  | undefined\n  | EmotionCss\n  | StyleHandle\n  | ClassNameArg[]\n  | { readonly [className: string]: boolean };\n\n/** Emotion-shaped authoring API bound to one Distillery registry. */\nexport interface Emotion {\n  /** Authors styles and returns a handle that can be used directly or passed to `cx`. */\n  css(strings: TemplateStringsArray, ...values: readonly unknown[]): EmotionCss;\n  /** Combines handles, conditional classes, and plain strings into a space-separated string. */\n  cx(...args: readonly ClassNameArg[]): string;\n  /** Defines styles that apply globally (e.g. `body`, `html`). */\n  injectGlobal(\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ): void;\n  /** Emits the full CSS for all generated emotion styles. */\n  stylesheet(): string;\n  /** Returns the underlying modules backing `injectGlobal` calls. */\n  globalModules(): readonly StylesModule[];\n}\n\n/** Per-registry Emotion compat cache. */\ninterface EmotionState {\n  /** `css` handles keyed by source hash. */\n  readonly wrappers: Map<string, EmotionCss>;\n  /** Original templates for inlining nested compat handles. */\n  readonly rawSources: Map<string, TemplateSlice>;\n  /** Module name → canonical source hash. */\n  readonly canonicalByModule: Map<string, string>;\n  /** Modules produced by `injectGlobal`. */\n  readonly globals: StylesModule[];\n  /** Handles created by this registry's Emotion instance. */\n  readonly brand: WeakSet<object>;\n  /** Sinks notified when a compat module registers. */\n  readonly sinks: Set<StyleSink>;\n}\n\nconst stateByRegistry = new WeakMap<StyleRegistry, EmotionState>();\n\nconst stateFor = (registry: StyleRegistry): EmotionState => {\n  let state = stateByRegistry.get(registry);\n  if (!state) {\n    state = {\n      wrappers: new Map(),\n      rawSources: new Map(),\n      canonicalByModule: new Map(),\n      globals: [],\n      brand: new WeakSet(),\n      sinks: new Set(),\n    };\n    stateByRegistry.set(registry, state);\n  }\n  return state;\n};\n\n/**\n * `@emotion/css`-shaped API over a distillery.\n *\n * `String(css\\`...\\`)` is the readable class name and does not collect. Passing the wrapper through `resolveClassName` collects and compacts like a native handle.\n *\n * @param distillery Bound distillery that owns the underlying registry.\n * @param options Optional sink for DOM injection.\n */\nexport const createEmotion = <TTokens>(\n  distillery: Distillery<TTokens>,\n  options: CreateEmotionOptions = {}\n): Emotion => {\n  const { registry } = distillery;\n  const state = stateFor(registry);\n\n  const stylesheet = (): string =>\n    distillery.renderStyles(distillery.stylesheetCollector('readable'));\n\n  const invalidateSinks = (): void => {\n    for (const sink of state.sinks) {\n      sink.invalidate(stylesheet);\n    }\n  };\n\n  if (options.sink) {\n    state.sinks.add(options.sink);\n    // Catch a late-attached sink up to styles already registered on this\n    // registry: cached `css`/`injectGlobal` calls return early without\n    // invalidating, so without this the managed `<style>` would miss every\n    // style registered before the sink was attached.\n    options.sink.invalidate(stylesheet);\n  }\n\n  const inlineValue = (\n    value: unknown,\n    position: 'selector' | 'statement'\n  ): TemplateSlice | null => {\n    if (position !== 'statement' || !isBranded(state, value)) {\n      return null;\n    }\n    return state.rawSources.get((value as StyleHandle).key) ?? null;\n  };\n\n  const css = (\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ): EmotionCss => {\n    assertTemplate(strings, 'css');\n    const hash = contentHash64(strings, values);\n    const cached = state.wrappers.get(hash);\n    if (cached) {\n      return cached;\n    }\n    const moduleName = `css-${hash}`;\n    const canonical = canonicalKey(strings, values);\n    detectCollision(state, moduleName, canonical);\n\n    const flat = flattenTemplate(strings, values, {\n      mode: 'self',\n      inlineValue,\n    });\n    const pending = pendingHandleFromFlattened(flat);\n    const module = distillery.createStyleModule(moduleName, () => ({\n      root: pending,\n    }));\n    const handle = module.handles.root;\n\n    state.rawSources.set(handle.key, {\n      strings: [...strings],\n      values: [...values],\n    });\n    const wrapper = makeWrapper(handle);\n    state.brand.add(wrapper);\n    state.wrappers.set(hash, wrapper);\n    state.canonicalByModule.set(moduleName, canonical);\n    invalidateSinks();\n    return wrapper;\n  };\n\n  const injectGlobal = (\n    strings: TemplateStringsArray,\n    ...values: readonly unknown[]\n  ): void => {\n    assertTemplate(strings, 'injectGlobal');\n    const hash = contentHash64(strings, values);\n    const moduleName = `global-${hash}`;\n    if (registry.module(moduleName)) {\n      return;\n    }\n    const canonical = canonicalKey(strings, values);\n    detectCollision(state, moduleName, canonical);\n\n    const flat = flattenTemplate(strings, values, {\n      mode: 'global',\n      inlineValue,\n    });\n    const module = distillery.createStyleModule(moduleName, () =>\n      globalStylesFromFlattened(flat)\n    );\n    state.canonicalByModule.set(moduleName, canonical);\n    state.globals.push(module);\n    invalidateSinks();\n  };\n\n  const cx = (...args: readonly ClassNameArg[]): string => {\n    const classes: string[] = [];\n    const walk = (arg: ClassNameArg): void => {\n      if (!arg) {\n        return;\n      }\n      if (typeof arg === 'string') {\n        classes.push(arg);\n        return;\n      }\n      if (typeof arg === 'number') {\n        classes.push(String(arg));\n        return;\n      }\n      if (Array.isArray(arg)) {\n        arg.forEach(walk);\n        return;\n      }\n      if (isBranded(state, arg)) {\n        classes.push(String(arg));\n        return;\n      }\n      if (isHandleLike(arg)) {\n        classes.push(arg.readableName);\n        return;\n      }\n      for (const [className, enabled] of Object.entries(arg)) {\n        if (enabled) {\n          classes.push(className);\n        }\n      }\n    };\n    args.forEach(walk);\n    return classes.join(' ');\n  };\n\n  return {\n    css,\n    cx,\n    injectGlobal,\n    stylesheet,\n    globalModules: () => [...state.globals],\n  };\n};\n\nconst makeWrapper = (handle: StyleHandle): EmotionCss => {\n  const readable = handle.readableName;\n  const asString = (): string => readable;\n  // Spread copy keeps `resolveClassName` (closed over the original handle) and\n  // `key` intact so collector dedupe and compaction work unchanged.\n  const wrapper = { ...handle } as EmotionCss & {\n    toString: () => string;\n    [Symbol.toPrimitive]: () => string;\n  };\n  wrapper.toString = asString;\n  wrapper[Symbol.toPrimitive] = asString;\n  return wrapper;\n};\n\nconst isBranded = (state: EmotionState, value: unknown): value is EmotionCss =>\n  Boolean(value && typeof value === 'object' && state.brand.has(value));\n\nconst assertTemplate = (strings: unknown, fn: string): void => {\n  if (!Array.isArray(strings) || !('raw' in (strings as object))) {\n    throw new Error(\n      `${fn} is a template tag; object styles (${fn}({...})) are not supported.`\n    );\n  }\n};\n\nconst detectCollision = (\n  state: EmotionState,\n  moduleName: string,\n  canonical: string\n): void => {\n  const prior = state.canonicalByModule.get(moduleName);\n  if (prior !== undefined && prior !== canonical) {\n    throw new Error(\n      `Content-hash collision for \"${moduleName}\"; two distinct templates hashed to the same name.`\n    );\n  }\n};\n\n// A cheap, exact collision tripwire independent of the (lossy) hash. NUL-joins\n// strings and String()s values — good enough because it is only ever compared\n// against another canonical string for the same module name.\nconst canonicalKey = (\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(String(values[index]));\n    }\n  });\n  return segments.join('\\u0000');\n};\n"]}

package/dist/engine.d.ts

@@ -2,8 +2,31 @@ import { StylesCollector, type StylesCollectorOptions } from './collector.js';
 import type { DistilleryEnvironment, DistilleryOptions, ThemeVarDefinition } from './environment.js';
 import { type StyleNameMode, type StyleNameResolver, type StyleNameResolverOptions } from './names.js';
 import { type RenderStylesOptions } from './runtime.js';
-import { type PrimitiveStyleAuthoringApi, type ResolvedStyles, type StyleAuthoringApi, StyleRegistry, type StylesModule, type StylesObject } from './styles/index.js';
+import type { StyleSink } from './sink.js';
+import { type PrimitiveStyleAuthoringApi, type ResolvedStyles, type StyleAuthoringApi, type StyleHandle, StyleRegistry, type StylesModule, type StylesObject } from './styles/index.js';
 import { type ThemeTree, type TokensOf, type ValuesOf } from './theme.js';
+/** Sink, render options, and warning sink for {@link Distillery.liveCollection}. */
+export interface LiveCollectionOptions {
+    /** Invalidated whenever the collection grows. Nothing is written before the first handle. */
+    sink?: StyleSink;
+    /** Options forwarded to `renderStyles` by `css()`. */
+    render?: RenderStylesOptions;
+    /** Warning sink for no-op handles. Used only when the distillery has `dev: true`. */
+    warn?: (message: string) => void;
+}
+/**
+ * Readable collection filled by one live render.
+ *
+ * Readable only: compact names depend on the complete collected set and need two passes.
+ */
+export interface LiveCollection {
+    /** Underlying readable artifact collector. Mutations here (e.g. `use(globalModule)`, `useThemeVar`) also invalidate the sink. */
+    readonly collector: StylesCollector;
+    /** Collects `handles` and returns their readable class names, space-separated. */
+    readonly resolveClassName: (...handles: StyleHandle[]) => string;
+    /** Renders the CSS collected so far. */
+    readonly css: () => string;
+}
 /** One component library's binding: environment, registry, and pre-bound operations. Destructure-safe (no `this`). */
 export interface Distillery<TTokens = unknown, TTheme extends ThemeTree = ThemeTree> {
     /** Resolved environment (tokens, prefix, derived theme vars). */
@@ -26,6 +49,8 @@ export interface Distillery<TTokens = unknown, TTheme extends ThemeTree = ThemeT
     readonly artifactCollector: (names: StyleNameMode, options?: Pick<StylesCollectorOptions, 'warn'>) => StylesCollector;
     /** Collector preloaded with every registered module. No-op warnings require `dev: true`; pass `{ warn }` to capture them. */
     readonly stylesheetCollector: (names?: StyleNameMode, options?: Pick<StylesCollectorOptions, 'warn'>) => StylesCollector;
+    /** Readable collection for one live render; keeps `sink` current as handles resolve. */
+    readonly liveCollection: (options?: LiveCollectionOptions) => LiveCollection;
     /** Emits collected CSS for this environment. */
     readonly renderStyles: (collector: StylesCollector, resolver?: StyleNameResolver, options?: RenderStylesOptions) => string;
     /** Creates a standalone name resolver using this distillery's prefix. */

package/dist/engine.d.ts.map

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

package/dist/engine.js

@@ -35,6 +35,14 @@ export const createDistillery = (options) => {
             : {}),
     };
     const registry = new StyleRegistry(prefix, readableVarOwnersFromEnvironment(environment), sharedVars ?? new Set());
+    const artifactCollector = (names, collectorOptions) => new StylesCollector({
+        target: 'artifact',
+        names,
+        registry,
+        prefix,
+        dev,
+        ...(collectorOptions?.warn ? { warn: collectorOptions.warn } : {}),
+    });
     return {
         environment,
         tokens,
@@ -46,14 +54,7 @@ export const createDistillery = (options) => {
         dev,
         createStyleModule: (name, factory) => createStyleModuleWithEnvironment(environment, registry, name, factory),
         primitiveStyles: (name, factory) => createStyleModuleWithEnvironment(environment, registry, name, ({ css: style, tokens: moduleTokens }) => factory({ style, tokens: moduleTokens })),
-        artifactCollector: (names, options) => new StylesCollector({
-            target: 'artifact',
-            names,
-            registry,
-            prefix,
-            dev,
-            ...(options?.warn ? { warn: options.warn } : {}),
-        }),
+        artifactCollector,
         stylesheetCollector: (names = 'readable', options) => {
             const collector = new StylesCollector({
                 target: 'stylesheet',
@@ -68,6 +69,21 @@ export const createDistillery = (options) => {
             }
             return collector;
         },
+        liveCollection: ({ sink, render, warn } = {}) => {
+            const collector = artifactCollector('readable', warn ? { warn } : {});
+            const css = () => renderStyles(environment, collector, undefined, render);
+            if (sink) {
+                collector.subscribe(() => sink.invalidate(css));
+            }
+            return {
+                collector,
+                resolveClassName: (...handles) => collector
+                    .useHandles(handles)
+                    .map((handle) => handle.readableName)
+                    .join(' '),
+                css,
+            };
+        },
         renderStyles: (collector, resolver, renderOptions) => renderStyles(environment, collector, resolver, renderOptions),
         createNameResolver: (resolverOptions) => createStyleNameResolver({ ...resolverOptions, prefix }),
     };

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.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 { StylesCollector, type StylesCollectorOptions } from './collector';\nimport type {\n  DistilleryEnvironment,\n  DistilleryOptions,\n  ThemeVarDefinition,\n} from './environment';\nimport { assertCssIdentSegment } from './idents';\nimport {\n  createStyleNameResolver,\n  type StyleNameMode,\n  type StyleNameResolver,\n  type StyleNameResolverOptions,\n} from './names';\nimport { renderStyles, type RenderStylesOptions } from './runtime';\nimport {\n  createStyleModuleWithEnvironment,\n  type PrimitiveStyleAuthoringApi,\n  readableVarOwnersFromEnvironment,\n  type ResolvedStyles,\n  type StyleAuthoringApi,\n  StyleRegistry,\n  type StylesModule,\n  type StylesObject,\n} from './styles';\nimport {\n  deriveTheme,\n  requireThemeVariation,\n  resolveThemeValues,\n  resolveThemeVariations,\n  type ThemeTree,\n  type TokensOf,\n  type ValuesOf,\n} from './theme';\n\n/** One component library's binding: environment, registry, and pre-bound operations. Destructure-safe (no `this`). */\nexport interface Distillery<\n  TTokens = unknown,\n  TTheme extends ThemeTree = ThemeTree,\n> {\n  /** Resolved environment (tokens, prefix, derived theme vars). */\n  readonly environment: DistilleryEnvironment<TTokens>;\n  /** Derived token tree, same object as `environment.tokens`. */\n  readonly tokens: TTokens;\n  /** Derived theme-var registry, same object as `environment.themeVars`. */\n  readonly themeVars: Readonly<Record<string, ThemeVarDefinition>>;\n  /** Nested literal values for one scheme. Optional `variation` is a name from `variations`. */\n  readonly resolveValues: (\n    scheme: 'light' | 'dark',\n    variation?: string\n  ) => ValuesOf<TTheme>;\n  /** The module registry accumulating collected handles and rules. */\n  readonly registry: StyleRegistry;\n  /** When `true`, collectors warn about no-op handles. */\n  readonly dev: boolean;\n  /** Named handle tree plus tokens. */\n  readonly createStyleModule: <TStyles extends StylesObject>(\n    name: string,\n    factory: (api: StyleAuthoringApi<TTokens>) => TStyles\n  ) => StylesModule<ResolvedStyles<TStyles>>;\n  /** Named handles plus tokens only. */\n  readonly primitiveStyles: <TStyles extends StylesObject>(\n    name: string,\n    factory: (api: PrimitiveStyleAuthoringApi<TTokens>) => TStyles\n  ) => StylesModule<ResolvedStyles<TStyles>>;\n  /** Collector for one render. Class-name resolution collects as a side effect. No-op warnings require `dev: true`; pass `{ warn }` to capture them. */\n  readonly artifactCollector: (\n    names: StyleNameMode,\n    options?: Pick<StylesCollectorOptions, 'warn'>\n  ) => StylesCollector;\n  /** Collector preloaded with every registered module. No-op warnings require `dev: true`; pass `{ warn }` to capture them. */\n  readonly stylesheetCollector: (\n    names?: StyleNameMode,\n    options?: Pick<StylesCollectorOptions, 'warn'>\n  ) => StylesCollector;\n  /** Emits collected CSS for this environment. */\n  readonly renderStyles: (\n    collector: StylesCollector,\n    resolver?: StyleNameResolver,\n    options?: RenderStylesOptions\n  ) => string;\n  /** Creates a standalone name resolver using this distillery's prefix. */\n  readonly createNameResolver: (\n    options: Omit<StyleNameResolverOptions, 'prefix'>\n  ) => StyleNameResolver;\n}\n\n/**\n * Binds the engine to one library's prefix and theme tree.\n *\n * @param options Brand prefix, theme scope, and authoring theme tree.\n * @throws If `prefix` is not a CSS identifier segment, if a theme key contains a hyphen, if a `lightDark` value is not a CSS `<color>`, if a named variation disagrees with the base, or if `themeVars` / `sharedVars` claim the same readable custom-property name.\n */\nexport const createDistillery = <const TTheme extends ThemeTree>(\n  options: DistilleryOptions<TTheme>\n): Distillery<TokensOf<TTheme>, TTheme> => {\n  const {\n    prefix,\n    themeScope,\n    theme,\n    sharedVars: sharedVarList,\n    variations,\n    dev = false,\n  } = options;\n  assertCssIdentSegment(prefix, 'Distillery prefix');\n  const { tokens, themeVars } = deriveTheme(prefix, theme);\n  const sharedVars = sharedVarList\n    ? Object.freeze(new Set(sharedVarList))\n    : undefined;\n  const resolvedVariations = resolveThemeVariations(\n    prefix,\n    theme,\n    themeVars,\n    variations\n  );\n  const environment: DistilleryEnvironment<TokensOf<TTheme>> = {\n    prefix,\n    themeScope,\n    themeVars: Object.freeze(themeVars),\n    tokens,\n    ...(sharedVars ? { sharedVars } : {}),\n    ...(Object.keys(resolvedVariations).length > 0\n      ? { variations: resolvedVariations }\n      : {}),\n  };\n  const registry = new StyleRegistry(\n    prefix,\n    readableVarOwnersFromEnvironment(environment),\n    sharedVars ?? new Set()\n  );\n\n  return {\n    environment,\n    tokens,\n    themeVars: environment.themeVars,\n    resolveValues: (scheme, variation) =>\n      resolveThemeValues(\n        theme,\n        themeVars,\n        scheme,\n        variation === undefined\n          ? undefined\n          : requireThemeVariation(environment.variations, variation)\n      ),\n    registry,\n    dev,\n    createStyleModule: (name, factory) =>\n      createStyleModuleWithEnvironment(environment, registry, name, factory),\n    primitiveStyles: (name, factory) =>\n      createStyleModuleWithEnvironment(\n        environment,\n        registry,\n        name,\n        ({ css: style, tokens: moduleTokens }) =>\n          factory({ style, tokens: moduleTokens })\n      ),\n    artifactCollector: (names, options) =>\n      new StylesCollector({\n        target: 'artifact',\n        names,\n        registry,\n        prefix,\n        dev,\n        ...(options?.warn ? { warn: options.warn } : {}),\n      }),\n    stylesheetCollector: (names = 'readable', options) => {\n      const collector = new StylesCollector({\n        target: 'stylesheet',\n        names,\n        registry,\n        prefix,\n        dev,\n        ...(options?.warn ? { warn: options.warn } : {}),\n      });\n      for (const module of registry.modules) {\n        collector.useAllEntries(module);\n      }\n      return collector;\n    },\n    renderStyles: (collector, resolver, renderOptions) =>\n      renderStyles(environment, collector, resolver, renderOptions),\n    createNameResolver: (resolverOptions) =>\n      createStyleNameResolver({ ...resolverOptions, prefix }),\n  };\n};\n"]}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.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 { StylesCollector, type StylesCollectorOptions } from './collector';\nimport type {\n  DistilleryEnvironment,\n  DistilleryOptions,\n  ThemeVarDefinition,\n} from './environment';\nimport { assertCssIdentSegment } from './idents';\nimport {\n  createStyleNameResolver,\n  type StyleNameMode,\n  type StyleNameResolver,\n  type StyleNameResolverOptions,\n} from './names';\nimport { renderStyles, type RenderStylesOptions } from './runtime';\nimport type { StyleSink } from './sink';\nimport {\n  createStyleModuleWithEnvironment,\n  type PrimitiveStyleAuthoringApi,\n  readableVarOwnersFromEnvironment,\n  type ResolvedStyles,\n  type StyleAuthoringApi,\n  type StyleHandle,\n  StyleRegistry,\n  type StylesModule,\n  type StylesObject,\n} from './styles';\nimport {\n  deriveTheme,\n  requireThemeVariation,\n  resolveThemeValues,\n  resolveThemeVariations,\n  type ThemeTree,\n  type TokensOf,\n  type ValuesOf,\n} from './theme';\n\n/** Sink, render options, and warning sink for {@link Distillery.liveCollection}. */\nexport interface LiveCollectionOptions {\n  /** Invalidated whenever the collection grows. Nothing is written before the first handle. */\n  sink?: StyleSink;\n  /** Options forwarded to `renderStyles` by `css()`. */\n  render?: RenderStylesOptions;\n  /** Warning sink for no-op handles. Used only when the distillery has `dev: true`. */\n  warn?: (message: string) => void;\n}\n\n/**\n * Readable collection filled by one live render.\n *\n * Readable only: compact names depend on the complete collected set and need two passes.\n */\nexport interface LiveCollection {\n  /** Underlying readable artifact collector. Mutations here (e.g. `use(globalModule)`, `useThemeVar`) also invalidate the sink. */\n  readonly collector: StylesCollector;\n  /** Collects `handles` and returns their readable class names, space-separated. */\n  readonly resolveClassName: (...handles: StyleHandle[]) => string;\n  /** Renders the CSS collected so far. */\n  readonly css: () => string;\n}\n\n/** One component library's binding: environment, registry, and pre-bound operations. Destructure-safe (no `this`). */\nexport interface Distillery<\n  TTokens = unknown,\n  TTheme extends ThemeTree = ThemeTree,\n> {\n  /** Resolved environment (tokens, prefix, derived theme vars). */\n  readonly environment: DistilleryEnvironment<TTokens>;\n  /** Derived token tree, same object as `environment.tokens`. */\n  readonly tokens: TTokens;\n  /** Derived theme-var registry, same object as `environment.themeVars`. */\n  readonly themeVars: Readonly<Record<string, ThemeVarDefinition>>;\n  /** Nested literal values for one scheme. Optional `variation` is a name from `variations`. */\n  readonly resolveValues: (\n    scheme: 'light' | 'dark',\n    variation?: string\n  ) => ValuesOf<TTheme>;\n  /** The module registry accumulating collected handles and rules. */\n  readonly registry: StyleRegistry;\n  /** When `true`, collectors warn about no-op handles. */\n  readonly dev: boolean;\n  /** Named handle tree plus tokens. */\n  readonly createStyleModule: <TStyles extends StylesObject>(\n    name: string,\n    factory: (api: StyleAuthoringApi<TTokens>) => TStyles\n  ) => StylesModule<ResolvedStyles<TStyles>>;\n  /** Named handles plus tokens only. */\n  readonly primitiveStyles: <TStyles extends StylesObject>(\n    name: string,\n    factory: (api: PrimitiveStyleAuthoringApi<TTokens>) => TStyles\n  ) => StylesModule<ResolvedStyles<TStyles>>;\n  /** Collector for one render. Class-name resolution collects as a side effect. No-op warnings require `dev: true`; pass `{ warn }` to capture them. */\n  readonly artifactCollector: (\n    names: StyleNameMode,\n    options?: Pick<StylesCollectorOptions, 'warn'>\n  ) => StylesCollector;\n  /** Collector preloaded with every registered module. No-op warnings require `dev: true`; pass `{ warn }` to capture them. */\n  readonly stylesheetCollector: (\n    names?: StyleNameMode,\n    options?: Pick<StylesCollectorOptions, 'warn'>\n  ) => StylesCollector;\n  /** Readable collection for one live render; keeps `sink` current as handles resolve. */\n  readonly liveCollection: (options?: LiveCollectionOptions) => LiveCollection;\n  /** Emits collected CSS for this environment. */\n  readonly renderStyles: (\n    collector: StylesCollector,\n    resolver?: StyleNameResolver,\n    options?: RenderStylesOptions\n  ) => string;\n  /** Creates a standalone name resolver using this distillery's prefix. */\n  readonly createNameResolver: (\n    options: Omit<StyleNameResolverOptions, 'prefix'>\n  ) => StyleNameResolver;\n}\n\n/**\n * Binds the engine to one library's prefix and theme tree.\n *\n * @param options Brand prefix, theme scope, and authoring theme tree.\n * @throws If `prefix` is not a CSS identifier segment, if a theme key contains a hyphen, if a `lightDark` value is not a CSS `<color>`, if a named variation disagrees with the base, or if `themeVars` / `sharedVars` claim the same readable custom-property name.\n */\nexport const createDistillery = <const TTheme extends ThemeTree>(\n  options: DistilleryOptions<TTheme>\n): Distillery<TokensOf<TTheme>, TTheme> => {\n  const {\n    prefix,\n    themeScope,\n    theme,\n    sharedVars: sharedVarList,\n    variations,\n    dev = false,\n  } = options;\n  assertCssIdentSegment(prefix, 'Distillery prefix');\n  const { tokens, themeVars } = deriveTheme(prefix, theme);\n  const sharedVars = sharedVarList\n    ? Object.freeze(new Set(sharedVarList))\n    : undefined;\n  const resolvedVariations = resolveThemeVariations(\n    prefix,\n    theme,\n    themeVars,\n    variations\n  );\n  const environment: DistilleryEnvironment<TokensOf<TTheme>> = {\n    prefix,\n    themeScope,\n    themeVars: Object.freeze(themeVars),\n    tokens,\n    ...(sharedVars ? { sharedVars } : {}),\n    ...(Object.keys(resolvedVariations).length > 0\n      ? { variations: resolvedVariations }\n      : {}),\n  };\n  const registry = new StyleRegistry(\n    prefix,\n    readableVarOwnersFromEnvironment(environment),\n    sharedVars ?? new Set()\n  );\n\n  const artifactCollector = (\n    names: StyleNameMode,\n    collectorOptions?: Pick<StylesCollectorOptions, 'warn'>\n  ): StylesCollector =>\n    new StylesCollector({\n      target: 'artifact',\n      names,\n      registry,\n      prefix,\n      dev,\n      ...(collectorOptions?.warn ? { warn: collectorOptions.warn } : {}),\n    });\n\n  return {\n    environment,\n    tokens,\n    themeVars: environment.themeVars,\n    resolveValues: (scheme, variation) =>\n      resolveThemeValues(\n        theme,\n        themeVars,\n        scheme,\n        variation === undefined\n          ? undefined\n          : requireThemeVariation(environment.variations, variation)\n      ),\n    registry,\n    dev,\n    createStyleModule: (name, factory) =>\n      createStyleModuleWithEnvironment(environment, registry, name, factory),\n    primitiveStyles: (name, factory) =>\n      createStyleModuleWithEnvironment(\n        environment,\n        registry,\n        name,\n        ({ css: style, tokens: moduleTokens }) =>\n          factory({ style, tokens: moduleTokens })\n      ),\n    artifactCollector,\n    stylesheetCollector: (names = 'readable', options) => {\n      const collector = new StylesCollector({\n        target: 'stylesheet',\n        names,\n        registry,\n        prefix,\n        dev,\n        ...(options?.warn ? { warn: options.warn } : {}),\n      });\n      for (const module of registry.modules) {\n        collector.useAllEntries(module);\n      }\n      return collector;\n    },\n    liveCollection: ({ sink, render, warn } = {}) => {\n      const collector = artifactCollector('readable', warn ? { warn } : {});\n      const css = (): string =>\n        renderStyles(environment, collector, undefined, render);\n      if (sink) {\n        collector.subscribe(() => sink.invalidate(css));\n      }\n      return {\n        collector,\n        resolveClassName: (...handles) =>\n          collector\n            .useHandles(handles)\n            .map((handle) => handle.readableName)\n            .join(' '),\n        css,\n      };\n    },\n    renderStyles: (collector, resolver, renderOptions) =>\n      renderStyles(environment, collector, resolver, renderOptions),\n    createNameResolver: (resolverOptions) =>\n      createStyleNameResolver({ ...resolverOptions, prefix }),\n  };\n};\n"]}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-export { createDistillery, type Distillery } from './engine.js';
+export { createDistillery, type Distillery, type LiveCollection, type LiveCollectionOptions, } from './engine.js';
+export { createDomSink, type CreateDomSinkOptions, type DocumentLike, type StyleElementLike, type StyleParentLike, } from './dom_sink.js';
+export type { StyleSink } from './sink.js';
 export { type DistilleryEnvironment, type DistilleryOptions, type ThemeVarDefinition, } from './environment.js';
 export { resolveThemeValues, zipSchemes, type DeepPartialTheme, type MediaThemeVariation, type PathsOf, type ResolvedThemeVariation, type SchemeValueTree, type ThemeTree, type ThemeVariation, type TokensOf, type ValuesOf, type Zipped, } from './theme.js';
 export { contextualVar, cq, isContextualCssVar, isContextualCssVarName, isCssToken, isScaleToken, lightDark, scaleToken, themeToken, type ContextualCssVar, type ContextualCssVarName, type CssToken, type ScaleToken, type SchemePair, } from './tokens/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,OAAO,EACZ,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,MAAM,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,EAAE,EACF,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,aAAa,EACb,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,OAAO,EACZ,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,MAAM,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,EAAE,EACF,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,aAAa,EACb,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -4,7 +4,8 @@
  * 2.0; you may not use this file except in compliance with the Elastic License
  * 2.0.
  */
-export { createDistillery } from './engine.js';
+export { createDistillery, } from './engine.js';
+export { createDomSink, } from './dom_sink.js';
 export { resolveThemeValues, zipSchemes, } from './theme.js';
 export { contextualVar, cq, isContextualCssVar, isContextualCssVarName, isCssToken, isScaleToken, lightDark, scaleToken, themeToken, } from './tokens/index.js';
 export { createStyleNameResolver, cssVarName, } from './names.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAmB,MAAM,UAAU,CAAC;AAM7D,OAAO,EACL,kBAAkB,EAClB,UAAU,GAWX,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,EAAE,EACF,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,GAMX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,UAAU,GAKX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,aAAa,EACb,QAAQ,GA0BT,MAAM,UAAU,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\nexport { createDistillery, type Distillery } from './engine';\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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,GAIjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,GAKd,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,kBAAkB,EAClB,UAAU,GAWX,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,EAAE,EACF,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,GAMX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,uBAAuB,EACvB,UAAU,GAKX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAC3E,OAAO,EACL,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,aAAa,EACb,QAAQ,GA0BT,MAAM,UAAU,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\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/sink.d.ts

@@ -0,0 +1,16 @@
+/** Receives stylesheet invalidation from a live collection or Emotion compat modules. */
+export interface StyleSink {
+    /** Marks the sink dirty. `render` produces the current stylesheet when it flushes. */
+    invalidate(render: () => string): void;
+}
+/** Minimal interface for a DOM `<style>` element. */
+export interface StyleElementLike {
+    /** Current stylesheet text, or `null` before the first flush. */
+    textContent: string | null;
+}
+/** Node that receives a managed `<style>` element, e.g. `document.head` or a `ShadowRoot`. */
+export interface StyleParentLike {
+    /** Appends the managed style element. */
+    appendChild(node: StyleElementLike): void;
+}
+//# sourceMappingURL=sink.d.ts.map

package/dist/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../src/sink.ts"],"names":[],"mappings":"AAOA,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAE9B,yCAAyC;IACzC,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C"}

package/dist/sink.js

@@ -0,0 +1,8 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=sink.js.map

package/dist/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../src/sink.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\n/** Receives stylesheet invalidation from a live collection or Emotion compat modules. */\nexport interface StyleSink {\n  /** Marks the sink dirty. `render` produces the current stylesheet when it flushes. */\n  invalidate(render: () => string): void;\n}\n\n/** Minimal interface for a DOM `<style>` element. */\nexport interface StyleElementLike {\n  /** Current stylesheet text, or `null` before the first flush. */\n  textContent: string | null;\n}\n\n/** Node that receives a managed `<style>` element, e.g. `document.head` or a `ShadowRoot`. */\nexport interface StyleParentLike {\n  // Method syntax (bivariant) so DOM `Node.appendChild<T extends Node>` assigns.\n  /** Appends the managed style element. */\n  appendChild(node: StyleElementLike): void;\n}\n"]}

package/docs/concepts/collection.md

@@ -23,7 +23,7 @@ const css = distillery.renderStyles(collector);
 | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
 | `use(module)`           | Non-variant entries on the module. Variants stay out.                                                                                        |
 | `use(entry)`            | One handle, rule, or media block.                                                                                                            |
-| `useHandles(handles)`   | Those handles, then any `auto` rule or media-inner-rule whose selector deps are all present. Media blocks include only the live inner rules. |
+| `useHandles(handles)`   | Those handles, then any `auto` rule or media-inner-rule whose deps are all present. Media blocks keep inner rules collected earlier.         |
 | `useAllEntries(module)` | Every entry, including variants. Used by the stylesheet target.                                                                              |
 | `useThemeVar(path)`     | Marks a theme token path reachable even if no collected declaration reads it.                                                                |
 

package/docs/getting-started/installation.md

@@ -17,11 +17,11 @@ The primary build is ESM (`"type": "module"`), reached through the `import` expo
 
 ## Entry points
 
-| Specifier                     | Use                                              |
-| ----------------------------- | ------------------------------------------------ |
-| `@elastic/distillate`         | Engine, authoring, tokens, collector, renderer.  |
-| `@elastic/distillate/emotion` | `createEmotion`, `createDomSink`.                |
-| `@elastic/distillate/testing` | Var-invariant helpers. Does not import `stylis`. |
+| Specifier                     | Use                                                              |
+| ----------------------------- | ---------------------------------------------------------------- |
+| `@elastic/distillate`         | Engine, authoring, tokens, collector, renderer, `createDomSink`. |
+| `@elastic/distillate/emotion` | `createEmotion`, `createDomSink`.                                |
+| `@elastic/distillate/testing` | Var-invariant helpers. Does not import `stylis`.                 |
 
 The root and emotion entries both reach `stylis@4.4.0`. Do not hoist a different stylis version; nested templates walk a pinned `compile()` tree shape.
 

package/docs/guides/react-renderer.md

@@ -135,7 +135,7 @@ export const renderArtifact = (
 renderArtifact(<Button>Hello</Button>, distillery);
 ```
 
-A readable artifact (`artifactCollector('readable')`) can skip the emitting pass because `handle.readableName` does not depend on the collected set. See [Ship a compact artifact](compact-artifacts.md).
+A readable artifact can skip the emitting pass because `handle.readableName` does not depend on the collected set. For a live tree, use [a live readable collection](#live-readable-collection-shadow-root). See [Ship a compact artifact](compact-artifacts.md).
 
 ### Include `injectGlobal` styles
 
@@ -156,3 +156,47 @@ renderArtifact(<Button>Hello</Button>, distillery, globalModules());
 ```
 
 Do not mix a compact stylesheet with markup that used `readableName`. The DOM will carry `.button-root` while the `<style>` contains `.a`.
+
+## Live readable collection (shadow root)
+
+A host that renders into a shadow root, or any isolated root, needs only the CSS that tree resolves. Readable names do not depend on the collected set, so one live render is enough. `distillery.liveCollection()` returns `{ resolveClassName, css, collector }`, which already fits the class-name context above:
+
+```tsx
+import { createDomSink } from '@elastic/distillate';
+import { useState } from 'react';
+import { createPortal } from 'react-dom';
+
+export const ShadowStyles = ({
+  root,
+  children,
+}: {
+  root: ShadowRoot;
+  children: ReactNode;
+}) => {
+  const [live] = useState(() =>
+    distillery.liveCollection({
+      sink: createDomSink({ document: root.ownerDocument, parent: root }),
+    })
+  );
+  return (
+    <StyleContext.Provider value={live}>
+      {createPortal(children, root)}
+    </StyleContext.Provider>
+  );
+};
+```
+
+Every handle, rule, or theme var the collection has not seen invalidates the sink. The sink rewrites its one `<style>` in a microtask, which lands before paint. A subtree that suspends and resolves later adds its handles and triggers another flush, so there is no "collection finished" moment to guess.
+
+Add globals and extra theme vars through `live.collector`; they invalidate the sink the same way:
+
+```tsx
+for (const module of globalModules()) {
+  live.collector.use(module);
+}
+live.collector.useThemeVar('colors/ink');
+```
+
+`css()` returns the CSS collected so far, for a host that writes it elsewhere. Pass `{ render }` to forward `renderStyles` options such as `scheme` or `alternates`.
+
+The collection only grows. A render React discards may leave extra CSS, never missing CSS. Compact names depend on the complete collected set, so a live collection is readable only; compact artifacts still [render twice](#render-twice).