@elastic/distillate 0.0.0 → 0.1.0

package/dist/instance.d.ts

@@ -0,0 +1,16 @@
+/** `globalThis` key for the loaded copy's identity. See the README. */
+export declare const INSTANCE_KEY: unique symbol;
+/** Object that may hold the Distillate instance identity, normally `globalThis`. */
+export interface InstanceHost {
+    /** Identity token of the first Distillate copy that registered. */
+    [INSTANCE_KEY]?: string;
+}
+/**
+ * Records this copy's identity and warns if a different token is already registered.
+ *
+ * @param host Object carrying the marker, normally `globalThis`.
+ * @param instanceId This copy's identity token.
+ * @param warn Injected so tests need not intercept the console.
+ */
+export declare const registerDistillateInstance: (host: InstanceHost, instanceId: string, warn?: (message: string) => void) => void;
+//# sourceMappingURL=instance.d.ts.map

package/dist/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAOA,uEAAuE;AACvE,eAAO,MAAM,YAAY,EAAE,OAAO,MAEjC,CAAC;AAEF,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,MAAM,YAAY,EAClB,YAAY,MAAM,EAClB,OAAM,CAAC,OAAO,EAAE,MAAM,KAAK,IAAyC,KACnE,IAcF,CAAC"}

package/dist/instance.js

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

package/dist/instance.js.map

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

package/dist/local_vars.d.ts

@@ -0,0 +1,75 @@
+import type { ContextualVarPath, CssValue } from './styles/types.js';
+/** Reference to a local CSS variable. Stringifies to `var(--...)`. */
+export interface LocalVarRef {
+    /** Brand distinguishing a local-var ref from other interpolations. */
+    readonly __kind: 'local-var-ref';
+    /** Canonical group/key path. */
+    readonly path: ContextualVarPath;
+    /** Actual emitted CSS custom property name. */
+    readonly propName: `--${string}`;
+    /** Usable CSS `var(...)` reference string. */
+    readonly ref: `var(--${string})`;
+    /** Stringifies to {@link LocalVarRef.ref}. */
+    toString(): string;
+    /** Template interpolation; same as {@link LocalVarRef.toString}. */
+    [Symbol.toPrimitive](hint: string): string;
+}
+/** Interpolation marker representing `.set(...)` overrides. */
+export interface LocalVarOverrideMarker {
+    /** Brand distinguishing a `.set(...)` override marker. */
+    readonly __kind: 'local-var-override-marker';
+    /** Unique ID for the group. */
+    readonly groupId: string;
+    /** Ordered list of variable overrides. */
+    readonly overrides: ReadonlyArray<{
+        /** Variable key within the group. */
+        readonly key: string;
+        /** Canonical group/key path. */
+        readonly path: ContextualVarPath;
+        /** Actual emitted CSS custom property name. */
+        readonly propName: `--${string}`;
+        /** Override value written at this interpolation site. */
+        readonly value: CssValue;
+    }>;
+}
+/** Interpolation marker representing `${group}` defaults. */
+export interface LocalVarDefaultMarker {
+    /** Brand distinguishing a `${group}` default marker. */
+    readonly __kind: 'local-var-default-marker';
+    /** Unique ID for the group. */
+    readonly groupId: string;
+    /** Group prefix path. */
+    readonly groupPath: `vars/${string}`;
+    /** Ordered list of variable defaults. */
+    readonly defaults: ReadonlyArray<{
+        /** Variable key within the group. */
+        readonly key: string;
+        /** Canonical group/key path. */
+        readonly path: ContextualVarPath;
+        /** Actual emitted CSS custom property name. */
+        readonly propName: `--${string}`;
+        /** Default value emitted when this key is reachable. */
+        readonly value: CssValue;
+    }>;
+}
+/** Interpolation marker: `${group}` defaults or `${group.set(...)}` overrides. */
+export type LocalVarMarker = LocalVarOverrideMarker | LocalVarDefaultMarker;
+/**
+ * Value returned by `t.vars(...)`. Interpolate `${group}`, `${group.key}`, or `${group.set({...})}`.
+ */
+export type LocalVarGroup<TKey extends string> = {
+    readonly [P in TKey]: LocalVarRef;
+} & {
+    /** Builds a marker that writes the given keys at the interpolation site. */
+    set(overrides: Partial<Record<TKey, CssValue>>): LocalVarOverrideMarker;
+};
+/** `true` when `value` is a {@link LocalVarRef}. */
+export declare const isLocalVarRef: (value: unknown) => value is LocalVarRef;
+/** `true` when `value` is a {@link LocalVarDefaultMarker}. */
+export declare const isLocalVarDefaultMarker: (value: unknown) => value is LocalVarDefaultMarker;
+/** `true` when `value` is a {@link LocalVarOverrideMarker}. */
+export declare const isLocalVarOverrideMarker: (value: unknown) => value is LocalVarOverrideMarker;
+/** `true` when `value` is a {@link LocalVarDefaultMarker} or {@link LocalVarOverrideMarker}. */
+export declare const isLocalVarMarker: (value: unknown) => value is LocalVarMarker;
+export declare const createLocalVarGroup: <TKey extends string>(prefix: string, moduleName: string, group: string, defaults: Record<TKey, CssValue>) => LocalVarGroup<TKey>;
+//# sourceMappingURL=local_vars.d.ts.map

package/dist/local_vars.d.ts.map

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

package/dist/local_vars.js

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

package/dist/local_vars.js.map

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

package/dist/minify.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Strips comments and insignificant whitespace from CSS.
+ *
+ * Strings, unquoted `url(…)` tokens, and backslash escapes pass through
+ * untouched: their contents are literal, so a `/*` or a `;` inside one is data
+ * rather than syntax.
+ *
+ * @param value Raw CSS text.
+ */
+export declare const minifyCss: (value: string) => string;
+//# sourceMappingURL=minify.d.ts.map

package/dist/minify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minify.d.ts","sourceRoot":"","sources":["../src/minify.ts"],"names":[],"mappings":"AAkCA;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MA2CzC,CAAC"}

package/dist/minify.js

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

package/dist/minify.js.map

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

package/dist/names.d.ts

@@ -0,0 +1,39 @@
+/** Naming scheme: `compact` assigns sequential identifiers by sorted key index, `readable` emits descriptive ones. */
+export type StyleNameMode = 'compact' | 'readable';
+/** Destination format for the CSS collection. */
+export type StyleTarget = 'artifact' | 'stylesheet';
+/** Context for resolving keys into final class or custom-property names. */
+export interface StyleNameResolver {
+    /** The naming mode used by this resolver. */
+    readonly names: StyleNameMode;
+    /** Resolves a handle key into a CSS class name. */
+    className(key: string, readableName?: string): string;
+    /** Resolves a variable key into a custom property name. */
+    cssVar(key: string): `--${string}`;
+    /** Resolves a variable key into a `var(...)` reference. */
+    cssVarRef(key: string): `var(--${string})`;
+}
+/** Inputs for {@link createStyleNameResolver}. */
+export interface StyleNameResolverOptions {
+    /** Naming strategy (`compact` or `readable`). */
+    names: StyleNameMode;
+    /** Brand prefix for readable names (`<prefix>-<key>` / `--<prefix>-<key>`), e.g. `'aui'`. */
+    prefix: string;
+    /** Keys defining the compact class-name domain. */
+    classKeys?: Iterable<string>;
+    /** Keys defining the compact custom-property domain. */
+    cssVarKeys?: Iterable<string>;
+}
+export declare const compactNameForIndex: (index: number) => string;
+/** Compact names are assigned from sorted keys so emission is deterministic. */
+export declare const createCompactNameMap: (keys: Iterable<string>) => ReadonlyMap<string, string>;
+/**
+ * Readable custom-property name: `--${prefix}-${path}` with `/` joined on `-` and a leading `vars/` stripped.
+ *
+ * @param prefix Brand prefix (e.g. `'eui'`).
+ * @param path Theme or contextual-var path (e.g. `'colors/ink'`, `'vars/chip/look/bg'`).
+ */
+export declare const cssVarName: (prefix: string, path: string) => `--${string}`;
+/** Maps semantic keys to readable (`<prefix>-<key>`) or compact (`a`, `b`, …) names. */
+export declare const createStyleNameResolver: ({ names, prefix, classKeys, cssVarKeys, }: StyleNameResolverOptions) => StyleNameResolver;
+//# sourceMappingURL=names.d.ts.map

package/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAOA,sHAAsH;AACtH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AACnD,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpD,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,mDAAmD;IACnD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtD,2DAA2D;IAC3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAAC;IACnC,2DAA2D;IAC3D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,GAAG,CAAC;CAC5C;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,KAAK,EAAE,aAAa,CAAC;IACrB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,wDAAwD;IACxD,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC/B;AAID,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,MAuBnD,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,QAAQ,CAAC,MAAM,CAAC,KACrB,WAAW,CAAC,MAAM,EAAE,MAAM,CAK5B,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,KAAK,MAAM,EACF,CAAC;AAcpE,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,GAAI,2CAKrC,wBAAwB,KAAG,iBAsB7B,CAAC"}

package/dist/names.js

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

package/dist/names.js.map

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

package/dist/nesting.d.ts

@@ -0,0 +1,59 @@
+import type { StyleHandle } from './styles/types.js';
+/** Rebuilt template fragment in tagged-template shape (`strings.length === values.length + 1`). */
+export interface TemplateSlice {
+    /** Literal pieces between interpolations. */
+    readonly strings: readonly string[];
+    /** Interpolated values, one per hole. */
+    readonly values: readonly unknown[];
+}
+/** `&`-relative selector fragment: literal text or a cross-class {@link StyleHandle}. */
+export type SelectorPart = string | StyleHandle;
+/** One comma alternative; parts concatenate into a selector. */
+export type SelectorAlternative = readonly SelectorPart[];
+/** Flattened nested rule: selector alternatives plus declaration slice. */
+export interface FlattenedRule {
+    /** Discriminant for {@link FlattenedEntry}. */
+    readonly kind: 'rule';
+    /** Comma alternatives relative to the parent handle. */
+    readonly alternatives: readonly SelectorAlternative[];
+    /** Declaration template for this rule. */
+    readonly slice: TemplateSlice;
+}
+/** Flattened `@media` block: query, optional self declarations, nested rules. */
+export interface FlattenedMedia {
+    /** Discriminant for {@link FlattenedEntry}. */
+    readonly kind: 'media';
+    /** Media query text. */
+    readonly query: string;
+    /** Bare declarations inside the block, applied to the self handle. */
+    readonly self?: TemplateSlice;
+    /** Nested `&` rules inside this media block. */
+    readonly rules: readonly FlattenedRule[];
+}
+/** Nested rule or `@media` produced by flattening. */
+export type FlattenedEntry = FlattenedRule | FlattenedMedia;
+/** Flattened `css` template: self declarations plus nested entries. */
+export interface FlattenedTemplate {
+    /** Self-handle declarations. `null` in global mode. */
+    readonly self: TemplateSlice | null;
+    /** Sibling nested rules and media blocks. */
+    readonly nested: readonly FlattenedEntry[];
+}
+/** `self` keeps a host handle; `global` does not. */
+export type FlattenMode = 'self' | 'global';
+/** Mode and optional inlining hook for {@link flattenTemplate}. */
+export interface FlattenOptions {
+    /** Whether the template authors a host handle or global rules. */
+    readonly mode: FlattenMode;
+    /**
+     * Optional splice of a value's source slice before compilation.
+     * Return `null`/`undefined` to serialize the value as a sentinel.
+     */
+    readonly inlineValue?: (value: unknown, position: InterpolationPosition) => TemplateSlice | null | undefined;
+}
+/** Where an interpolation sits in the serialized template. */
+export type InterpolationPosition = 'selector' | 'statement';
+export declare const hasNestedSyntax: (strings: readonly string[]) => boolean;
+export declare const flattenTemplate: (strings: readonly string[], values: readonly unknown[], options: FlattenOptions) => FlattenedTemplate;
+export declare const isHandleLike: (value: unknown) => value is StyleHandle;
+//# sourceMappingURL=nesting.d.ts.map

package/dist/nesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nesting.d.ts","sourceRoot":"","sources":["../src/nesting.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQlD,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAChD,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,SAAS,YAAY,EAAE,CAAC;AAE1D,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,CAAC;AAE5D,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,qBAAqB,KAC5B,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC;AAED,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,WAAW,CAAC;AAO7D,eAAO,MAAM,eAAe,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,OACK,CAAC;AAEnE,eAAO,MAAM,eAAe,GAC1B,SAAS,SAAS,MAAM,EAAE,EAC1B,QAAQ,SAAS,OAAO,EAAE,EAC1B,SAAS,cAAc,KACtB,iBAcF,CAAC;AAkcF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAKpD,CAAC"}