@canonical/terrazzo-plugin-css 0.1.0 → 0.3.0

package/dist/types/build/constants/surfaceSelectorMap.d.ts

@@ -0,0 +1,3 @@
+/** Surface selector compounding by context depth. */
+export declare const SURFACE_SELECTOR_MAP: Record<string, string>;
+//# sourceMappingURL=surfaceSelectorMap.d.ts.map

package/dist/types/build/constants/surfaceSelectorMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceSelectorMap.d.ts","sourceRoot":"","sources":["../../../../src/build/constants/surfaceSelectorMap.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIvD,CAAC"}

package/dist/types/build/context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Build context — shared state threaded through all build-phase helpers.
+ *
+ * The plugin's `build()` hook constructs this once, then passes it
+ * (or a subset) to each build helper.
+ */
+import type { Artifact } from "../artifact/types.js";
+import type { ResolvedLayerConfig } from "../layers/types.js";
+import type { GetTransformsFn, OutputFileFn, ResolverLike, TokenMap } from "./shims.js";
+/** Shared build context passed to every build helper. */
+export interface BuildContext {
+    /** Registered token transforms. */
+    tokens: TokenMap;
+    /** Query transforms by format / id / type / input. */
+    getTransforms: GetTransformsFn;
+    /** Resolver for applying modifier permutations. */
+    resolver: ResolverLike;
+    /** Resolved @layer configuration. */
+    layers: ResolvedLayerConfig;
+    /** Mutable artifact map — populated by build helpers. */
+    artifact: Artifact;
+    /** Write an output file. */
+    outputFile: OutputFileFn;
+    /** Base directory for DTCG token source files. */
+    tokensDir: string;
+    /** Modifier family names. */
+    families: string[];
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/build/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/build/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,sDAAsD;IACtD,aAAa,EAAE,eAAe,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,EAAE,QAAQ,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,YAAY,CAAC;IACzB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types/build/deltas.d.ts

@@ -0,0 +1,3 @@
+/** Legacy placeholder. Delta helpers now live in concrete build modules. */
+export {};
+//# sourceMappingURL=deltas.d.ts.map

package/dist/types/build/deltas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.d.ts","sourceRoot":"","sources":["../../../src/build/deltas.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,CAAC"}

package/dist/types/build/extractOklchL.d.ts

@@ -0,0 +1,2 @@
+export declare function extractOklchL(value: unknown): number | null;
+//# sourceMappingURL=extractOklchL.d.ts.map

package/dist/types/build/extractOklchL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractOklchL.d.ts","sourceRoot":"","sources":["../../../src/build/extractOklchL.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAa3D"}

package/dist/types/build/filterExtensions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Filter DTCG $extensions: strip internal `com.canonical.*` keys,
+ * returning only third-party / user-defined extensions for artifact output.
+ *
+ * Returns `undefined` when no passthrough keys remain, so callers can
+ * use it directly in the spread-based construction without adding empty objects.
+ */
+export declare function filterExtensions(raw: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=filterExtensions.d.ts.map

package/dist/types/build/filterExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterExtensions.d.ts","sourceRoot":"","sources":["../../../src/build/filterExtensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAcrC"}

package/dist/types/build/formatDelta.d.ts

@@ -0,0 +1,2 @@
+export declare function formatDelta(delta: number): string;
+//# sourceMappingURL=formatDelta.d.ts.map

package/dist/types/build/formatDelta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDelta.d.ts","sourceRoot":"","sources":["../../../src/build/formatDelta.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/dist/types/build/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Build module barrel — re-exports all build helpers.
+ */
+export { annotateDeclarations } from "./annotation.js";
+export { buildDescriptionLookup, buildFallbackChain, buildModifierFamily, buildSetsPrimitive, buildSetsSemantic, buildStates, buildSurfaces, buildTheme, buildTypography, convertCssValueToString, emitTypographyDecls, } from "./builders/index.js";
+export { isPrimitive, isSemanticColor, isSemanticTypography, } from "./classification.js";
+export { computeDeltas } from "./computeDeltas.js";
+export { FORMAT } from "./constants/format.js";
+export { HEADER } from "./constants/header.js";
+export { interactiveRoles } from "./constants/interactiveRoles.js";
+export { SURFACE_SELECTOR_MAP } from "./constants/surfaceSelectorMap.js";
+export type { BuildContext } from "./context.js";
+export { extractOklchL } from "./extractOklchL.js";
+export { formatDelta } from "./formatDelta.js";
+export type { ModifierFileData } from "./modifierIo.js";
+export { extractModifierFileData, loadModifierData, walkTokenTree, } from "./modifierIo.js";
+export { recoverPrimitiveRef } from "./recoverPrimitiveRef.js";
+export type { BaseTokenLike, ColorTokenLike, GetTransformsFn, MultiValueTransformResult, OutputFileFn, ResolvedTokenMap, ResolverLike, SetTransformFn, SetTransformParams, SingleValueTransformResult, TokenLike, TokenMap, TokenSourceLike, TransformResult, TransformValue, TypographyTokenLike, UnknownTypedTokenLike, } from "./shims.js";
+export { isColorTokenLike, isSingleValueTransformResult } from "./shims.js";
+export type { DeltaDeclarations, InteractiveRole, OklchColorValue, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/build/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,yBAAyB,EACzB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,SAAS,EACT,QAAQ,EACR,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC5E,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/types/build/modifierIo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Data extracted from a DTCG modifier source file.
+ *
+ * Contains both the alias map (token ID → aliasOf target) and the
+ * description map (token ID → `$description` text).
+ */
+export interface ModifierFileData {
+    aliases: Record<string, string>;
+    descriptions: Record<string, string>;
+}
+/**
+ * Walk a DTCG token JSON tree and collect alias targets (from `$value` alias
+ * strings) and `$description` values, keyed by the dot-separated token ID path.
+ *
+ * @note Performs synchronous file I/O (readFileSync).
+ */
+export declare function extractModifierFileData(filePath: string): ModifierFileData;
+/**
+ * Recursively walk a DTCG token tree, collecting alias targets and
+ * `$description` values.
+ *
+ * Alias targets are extracted from DTCG `$value` strings matching the
+ * `"{token.path}"` pattern. When `$root` is encountered, the token ID
+ * is the parent path (the `$root` marker is stripped per DTCG spec).
+ */
+export declare function walkTokenTree(node: unknown, path: string[], aliases: Record<string, string>, descriptions: Record<string, string>): void;
+/**
+ * Load modifier file data for a specific family context by reading the raw
+ * token source files referenced in the resolver JSON.
+ *
+ * Returns both the alias map (token ID → aliasOf target) and the
+ * description map (token ID → `$description` text).
+ *
+ * @note Performs synchronous file I/O (readFileSync + JSON.parse on the resolver).
+ * @param tokensDir  - Base directory for token sources (e.g. "./tokens/canonical")
+ * @param family     - Modifier family name (e.g. "anticipation")
+ * @param context    - Context name (e.g. "constructive")
+ */
+export declare function loadModifierData(tokensDir: string, family: string, context: string): ModifierFileData;
+//# sourceMappingURL=modifierIo.d.ts.map

package/dist/types/build/modifierIo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifierIo.d.ts","sourceRoot":"","sources":["../../../src/build/modifierIo.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAc1E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,IAAI,CAiCN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,gBAAgB,CAyBlB"}

package/dist/types/build/recoverPrimitiveRef.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Primitive reference recovery.
+ *
+ * Terrazzo resolves component-level `$ref` aliases to literal values during
+ * `transformCSSValue`. This restores the semantic → primitive relationship
+ * so the CSS output and artifact both reference the primitive custom property
+ * instead of duplicating the raw value.
+ */
+/**
+ * Replace a resolved literal value with a `var()` reference to the matching
+ * primitive token when one exists.
+ *
+ * Values that are already `var()` references (whole-token aliases preserved
+ * by Terrazzo) are returned unchanged. Self-references are also skipped.
+ */
+export declare function recoverPrimitiveRef(value: string, selfCssVar: string, primitiveByValue: Map<string, string>): string;
+//# sourceMappingURL=recoverPrimitiveRef.d.ts.map

package/dist/types/build/recoverPrimitiveRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recoverPrimitiveRef.d.ts","sourceRoot":"","sources":["../../../src/build/recoverPrimitiveRef.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAQR"}

package/dist/types/build/shims.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Internal type shims — avoid coupling to @terrazzo/parser internal types.
+ *
+ * These lightweight interfaces match the shape that the Terrazzo plugin
+ * runtime passes into `transform()` and `build()` hooks, without importing
+ * from @terrazzo/parser directly.
+ */
+/** Primitive transform payload value. */
+export type TransformValue = string | Record<string, string>;
+/** Source location metadata attached by the resolver. */
+export interface TokenSourceLike {
+    loc?: unknown;
+    filename?: string;
+}
+/** Shared token metadata for resolver and transform hooks. */
+export interface BaseTokenLike {
+    $type?: string;
+    $value?: unknown;
+    $description?: string;
+    $extensions?: Record<string, unknown>;
+    id?: string;
+    source?: TokenSourceLike;
+    aliasOf?: string;
+    aliasChain?: string[];
+}
+/** Color token shape used by theme and state logic. */
+export interface ColorTokenLike extends BaseTokenLike {
+    $type: "color";
+}
+/** Typography token shape used by typography transforms. */
+export interface TypographyTokenLike extends BaseTokenLike {
+    $type: "typography";
+}
+/** Generic token shape used when the exact type is not yet known. */
+export interface UnknownTypedTokenLike extends BaseTokenLike {
+    $type?: Exclude<string, "color" | "typography">;
+}
+/** Minimal token shape for classification and transform hooks. */
+export type TokenLike = BaseTokenLike | ColorTokenLike | TypographyTokenLike | UnknownTypedTokenLike;
+/** Token dictionary threaded through transform/build hooks. */
+export type TokenMap = Record<string, TokenLike>;
+/** Resolved token dictionary returned by the resolver. */
+export type ResolvedTokenMap = Record<string, TokenLike>;
+/** Callback signature for registering per-token transforms. */
+export interface SetTransformParams {
+    format: string;
+    localID?: string;
+    value: TransformValue;
+    input?: Record<string, string>;
+    meta?: Record<string, unknown>;
+}
+/** Callback signature for registering per-token transforms. */
+export type SetTransformFn = (id: string, params: SetTransformParams) => void;
+/** Shared fields carried by all transform results. */
+export interface BaseTransformResult<TToken extends TokenLike = TokenLike> {
+    id: string;
+    localID?: string;
+    input: Record<string, string>;
+    token: TToken;
+}
+/** A single-value transform result returned by `getTransforms()`. */
+export interface SingleValueTransformResult<TToken extends TokenLike = TokenLike> extends BaseTransformResult<TToken> {
+    type: "SINGLE_VALUE";
+    value: string;
+}
+/** A multi-value transform result returned by `getTransforms()`. */
+export interface MultiValueTransformResult<TToken extends TokenLike = TokenLike> extends BaseTransformResult<TToken> {
+    type: "MULTI_VALUE";
+    value: Record<string, string>;
+}
+/** Any transform result returned by `getTransforms()`. */
+export type TransformResult<TToken extends TokenLike = TokenLike> = SingleValueTransformResult<TToken> | MultiValueTransformResult<TToken>;
+/** Query-style callback for retrieving registered transforms. */
+export type GetTransformsFn = (params: {
+    format: string;
+    id?: string | string[];
+    $type?: string | string[];
+    input?: Record<string, string>;
+}) => TransformResult[];
+/** Minimal resolver shape used by build helpers. */
+export interface ResolverLike {
+    apply(input: Record<string, string>): ResolvedTokenMap;
+    source?: {
+        modifiers?: Record<string, {
+            contexts?: Record<string, unknown[]>;
+        }>;
+    };
+}
+/** Callback for writing output files. */
+export type OutputFileFn = (filename: string, contents: string | Uint8Array) => void;
+/** Narrow a token to the color-token shape. */
+export declare function isColorTokenLike(token: TokenLike): token is ColorTokenLike;
+/** Narrow a transform result to a single-value payload. */
+export declare function isSingleValueTransformResult(result: TransformResult): result is SingleValueTransformResult;
+//# sourceMappingURL=shims.d.ts.map

package/dist/types/build/shims.d.ts.map

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

package/dist/types/build/types.d.ts

@@ -0,0 +1,51 @@
+import type { CSSDeclaration } from "../css-ast/types.js";
+/** Set-level filtering. */
+export interface SetConfig {
+    /** Glob patterns to exclude from the set output. */
+    exclude?: string[];
+}
+/** Typography modifier configuration. */
+export interface TypographyConfig {
+    /** Resolver modifier name. */
+    modifier: string;
+}
+/** NativeState derivation layer configuration. */
+export interface StatesConfig {
+    /** CSS selector for the derivation block. @default "*" */
+    selector: string;
+}
+/** Per-role delta values for NativeState derivation. */
+export interface StateDelta {
+    /** Semantic role (e.g. "color-foreground-primary"). */
+    role: string;
+    /** State kind (e.g. "hover", "active"). */
+    state: string;
+    /** Light-mode oklch L delta. */
+    lightDelta: number;
+    /** Dark-mode oklch L delta. */
+    darkDelta: number;
+}
+/** Interactive role metadata used by state and delta generation. */
+export interface InteractiveRole {
+    /** Semantic token id for the interactive role. */
+    role: string;
+    /** State variants emitted for the role. */
+    states: string[];
+    /** Whether the role participates in surface fallback chaining. */
+    hasSurface: boolean;
+    /** Whether the role participates in modifier fallback chaining. */
+    hasModifier: boolean;
+}
+/** Minimal object shape for an oklch token value. */
+export interface OklchColorValue {
+    colorSpace: "oklch";
+    components: number[];
+}
+/** Delta declaration groups emitted for theme generation. */
+export interface DeltaDeclarations {
+    /** Default light-mode delta declarations emitted on `:root`. */
+    lightDeltaDecls: CSSDeclaration[];
+    /** Dark-mode override delta declarations emitted in dark contexts. */
+    darkDeltaDecls: CSSDeclaration[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/build/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,sEAAsE;IACtE,cAAc,EAAE,cAAc,EAAE,CAAC;CAClC"}

package/dist/types/css-ast/addDeclarationUnique.d.ts

@@ -0,0 +1,3 @@
+import type { CSSDeclaration, CSSNode } from "./types.js";
+export default function addDeclarationUnique(nodes: CSSNode[], decl: CSSDeclaration): void;
+//# sourceMappingURL=addDeclarationUnique.d.ts.map

package/dist/types/css-ast/addDeclarationUnique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addDeclarationUnique.d.ts","sourceRoot":"","sources":["../../../src/css-ast/addDeclarationUnique.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,EAAE,cAAc,GACnB,IAAI,CAIN"}

package/dist/types/css-ast/createDeclaration.d.ts

@@ -0,0 +1,4 @@
+/** Create a CSS declaration node. */
+import type { CSSDeclaration } from "./types.js";
+export default function createDeclaration(property: string, value: string, comment?: string): CSSDeclaration;
+//# sourceMappingURL=createDeclaration.d.ts.map

package/dist/types/css-ast/createDeclaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDeclaration.d.ts","sourceRoot":"","sources":["../../../src/css-ast/createDeclaration.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAEhB"}

package/dist/types/css-ast/decl.d.ts

@@ -1,4 +1,4 @@
 /** Create a CSS declaration node. */
 import type { CSSDeclaration } from "../types.js";
-export default function decl(property: string, value: string, comment?: string): CSSDeclaration;
+export default function createDecl(property: string, value: string, comment?: string): CSSDeclaration;
 //# sourceMappingURL=decl.d.ts.map

package/dist/types/css-ast/decl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decl.d.ts","sourceRoot":"","sources":["../../../src/css-ast/decl.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,IAAI,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAEhB"}
+{"version":3,"file":"decl.d.ts","sourceRoot":"","sources":["../../../src/css-ast/decl.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,cAAc,CAEhB"}

package/dist/types/css-ast/hasDeclaration.d.ts

@@ -0,0 +1,3 @@
+import type { CSSNode } from "./types.js";
+export default function hasDeclaration(nodes: CSSNode[], property: string): boolean;
+//# sourceMappingURL=hasDeclaration.d.ts.map

package/dist/types/css-ast/hasDeclaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasDeclaration.d.ts","sourceRoot":"","sources":["../../../src/css-ast/hasDeclaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAIT"}

package/dist/types/css-ast/index.d.ts

@@ -1,7 +1,7 @@
-export { default as addDeclUnique } from "./addDeclUnique.js";
-export { default as decl } from "./decl.js";
-export { default as hasDecl } from "./hasDecl.js";
+export { default as addDeclarationUnique } from "./addDeclarationUnique.js";
+export { default as createDeclaration } from "./createDeclaration.js";
+export { default as hasDeclaration } from "./hasDeclaration.js";
 export { default as printNode } from "./printNode.js";
 export { default as printRules } from "./printRules.js";
-export { default as rule } from "./rule.js";
+export { default as createRule } from "./rule.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/css-ast/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/css-ast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/css-ast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/types/css-ast/printNode.d.ts

@@ -1,5 +1,5 @@
 /** Print a single CSS AST node. */
-import type { CSSNode } from "../types.js";
+import type { CSSNode } from "./types.js";
 export default function printNode(node: CSSNode, { indentChar, indentLv }: {
     indentChar: string;
     indentLv: number;

package/dist/types/css-ast/printNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"printNode.d.ts","sourceRoot":"","sources":["../../../src/css-ast/printNode.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,IAAI,EAAE,OAAO,EACb,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjE,MAAM,CA8BR"}
+{"version":3,"file":"printNode.d.ts","sourceRoot":"","sources":["../../../src/css-ast/printNode.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,IAAI,EAAE,OAAO,EACb,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjE,MAAM,CA8BR"}

package/dist/types/css-ast/printRules.d.ts

@@ -1,4 +1,4 @@
 /** Print an array of CSS AST nodes into a formatted CSS string. */
-import type { CSSNode, PrintOptions } from "../types.js";
+import type { CSSNode, PrintOptions } from "./types.js";
 export default function printRules(nodes: CSSNode[], opts?: PrintOptions): string;
 //# sourceMappingURL=printRules.d.ts.map

package/dist/types/css-ast/printRules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"printRules.d.ts","sourceRoot":"","sources":["../../../src/css-ast/printRules.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,GAAE,YAAiB,GACtB,MAAM,CAUR"}
+{"version":3,"file":"printRules.d.ts","sourceRoot":"","sources":["../../../src/css-ast/printRules.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAGnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,GAAE,YAAiB,GACtB,MAAM,CAUR"}

package/dist/types/css-ast/rule.d.ts

@@ -1,4 +1,4 @@
 /** Create a CSS rule node. */
-import type { CSSNode, CSSRule } from "../types.js";
-export default function rule(prelude: string[], children?: CSSNode[]): CSSRule;
+import type { CSSNode, CSSRule } from "./types.js";
+export default function createRule(prelude: string[], children?: CSSNode[]): CSSRule;
 //# sourceMappingURL=rule.d.ts.map

package/dist/types/css-ast/rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../src/css-ast/rule.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,CAAC,OAAO,UAAU,IAAI,CAC1B,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,GAAE,OAAO,EAAO,GACvB,OAAO,CAET"}
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../src/css-ast/rule.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,CAAC,OAAO,UAAU,UAAU,CAChC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,GAAE,OAAO,EAAO,GACvB,OAAO,CAET"}

package/dist/types/css-ast/types.d.ts

@@ -0,0 +1,21 @@
+/** A CSS declaration node. */
+export interface CSSDeclaration {
+    type: "Declaration";
+    property: string;
+    value: string;
+    comment?: string;
+}
+/** A CSS rule node with nested children. */
+export interface CSSRule {
+    type: "Rule";
+    prelude: string[];
+    children: (CSSRule | CSSDeclaration)[];
+}
+/** Any CSS AST node handled by the printer helpers. */
+export type CSSNode = CSSRule | CSSDeclaration;
+/** Printer options for CSS AST serialization. */
+export interface PrintOptions {
+    indentChar?: string;
+    indentLv?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/css-ast/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/css-ast/types.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,CAAC,OAAO,GAAG,cAAc,CAAC,EAAE,CAAC;CACxC;AAED,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,cAAc,CAAC;AAE/C,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/index.d.ts

@@ -5,11 +5,11 @@
  * Modifier contracts, light-dark pairing, layer wrapping, artifact emission.
  */
 export { classifyTier, makeArtifactToken, makeDerivedArtifactToken, serializeArtifact, } from "./artifact/index.js";
-export { addDeclUnique, decl, hasDecl, printNode, printRules, rule, } from "./css-ast/index.js";
+export { addDeclarationUnique, createDeclaration, createRule, hasDeclaration, printNode, printRules, } from "./css-ast/index.js";
 export { resolveLayerConfig, wrapInLayer } from "./layers/index.js";
 export { buildLightDarkDeclarations, wrapLightDark, } from "./light-dark/index.js";
 export { buildModifierContextCSS, computeModifierContext, getAliasTarget, } from "./modifiers/index.js";
-export { prefixVar, tokenIdToCssVar } from "./naming.js";
-export { canonicalPlugin } from "./plugin.js";
-export type { Artifact, ArtifactToken, CanonicalPluginOptions, CSSDeclaration, CSSNode, CSSRule, DerivationKind, LayerConfig, LightDarkPair, MediaModifierConfig, ModifierContext, OverlayToken, PrintOptions, ResolvedLayerConfig, ResolvedThemeConfig, SetConfig, StateDelta, StatesConfig, ThemeColorScheme, ThemeConfig, ThemeSelectors, TokenTier, TypographyConfig, } from "./types.js";
+export { convertTokenIdToCssVar, prefixVar } from "./naming.js";
+export { default as canonicalPlugin } from "./plugin/index.js";
+export type { Artifact, ArtifactTier, ArtifactToken, ArtifactTokenInit, CanonicalPluginOptions, CSSDeclaration, CSSNode, CSSRule, DerivationKind, DerivedArtifactTokenInit, DtcgTokenType, KnownDtcgTokenType, KnownTokenTier, LayerConfig, LightDarkPair, MediaModifierConfig, ModifierContext, OverlayToken, PrintOptions, ResolvedLayerConfig, ResolvedThemeConfig, SetConfig, StateDelta, StatesConfig, SurfaceConfig, ThemeColorScheme, ThemeConfig, ThemeSelectors, TokenTier, TypographyConfig, WrappedArtifactEnvelope, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,IAAI,EACJ,OAAO,EACP,SAAS,EACT,UAAU,EACV,IAAI,GACL,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,QAAQ,EACR,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,OAAO,EACP,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,0BAA0B,EAC1B,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,OAAO,EACP,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/types/layers/resolveLayerConfig.d.ts

@@ -1,6 +1,6 @@
 /**
  * Resolve partial layer config to a full config with defaults.
  */
-import type { ResolvedLayerConfig } from "../types.js";
+import type { ResolvedLayerConfig } from "./types.js";
 export default function resolveLayerConfig(partial?: Partial<ResolvedLayerConfig>): ResolvedLayerConfig;
 //# sourceMappingURL=resolveLayerConfig.d.ts.map

package/dist/types/layers/resolveLayerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveLayerConfig.d.ts","sourceRoot":"","sources":["../../../src/layers/resolveLayerConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASvD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,mBAAmB,CAErB"}
+{"version":3,"file":"resolveLayerConfig.d.ts","sourceRoot":"","sources":["../../../src/layers/resolveLayerConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAStD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,mBAAmB,CAErB"}

package/dist/types/layers/types.d.ts

@@ -0,0 +1,19 @@
+/** CSS @layer names. Set a value to `null` to omit the layer wrapper. */
+export interface LayerConfig {
+    /** Wraps sets (primitive, semantic). @default "ds.tokens" */
+    tokens: string | null;
+    /** Wraps modifier outputs (theme, typography, families). @default "ds.modifiers" */
+    modifiers: string | null;
+    /** Wraps surface class output. @default "ds.surfaces" */
+    surfaces: string | null;
+    /** Wraps derivation layer (states.css). @default "ds.states" */
+    states: string | null;
+}
+/** Fully resolved layer config with defaults applied. */
+export interface ResolvedLayerConfig {
+    tokens: string | null;
+    modifiers: string | null;
+    surfaces: string | null;
+    states: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/layers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/layers/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/types/layers/wrapInLayer.d.ts

@@ -1,3 +1,3 @@
-import type { CSSNode } from "../types.js";
+import type { CSSNode } from "../css-ast/types.js";
 export default function wrapInLayer(layerName: string | null, children: CSSNode[]): CSSNode[];
 //# sourceMappingURL=wrapInLayer.d.ts.map

package/dist/types/layers/wrapInLayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapInLayer.d.ts","sourceRoot":"","sources":["../../../src/layers/wrapInLayer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,OAAO,EAAE,GAClB,OAAO,EAAE,CAKX"}
+{"version":3,"file":"wrapInLayer.d.ts","sourceRoot":"","sources":["../../../src/layers/wrapInLayer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,OAAO,UAAU,WAAW,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,OAAO,EAAE,GAClB,OAAO,EAAE,CAKX"}

package/dist/types/light-dark/buildLightDarkDeclarations.d.ts

@@ -1,3 +1,4 @@
-import type { CSSNode, LightDarkPair } from "../types.js";
+import type { CSSNode } from "../css-ast/types.js";
+import type { LightDarkPair } from "./types.js";
 export default function buildLightDarkDeclarations(pairs: LightDarkPair[]): CSSNode[];
 //# sourceMappingURL=buildLightDarkDeclarations.d.ts.map

package/dist/types/light-dark/buildLightDarkDeclarations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildLightDarkDeclarations.d.ts","sourceRoot":"","sources":["../../../src/light-dark/buildLightDarkDeclarations.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,EAAE,CAIX"}
+{"version":3,"file":"buildLightDarkDeclarations.d.ts","sourceRoot":"","sources":["../../../src/light-dark/buildLightDarkDeclarations.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,EAAE,CAIX"}

package/dist/types/light-dark/types.d.ts

@@ -0,0 +1,50 @@
+/** Color-scheme mapping for the theme modifier. */
+export interface ThemeColorScheme {
+    /** Resolver context name that maps to CSS `color-scheme: light`. */
+    light: string;
+    /** Resolver context name that maps to CSS `color-scheme: dark`. */
+    dark: string;
+    /** Which context is the default. @default "light" */
+    default: string;
+}
+/** CSS selectors for theme output. */
+export interface ThemeSelectors {
+    /** Merged `light-dark()` block selector. @default ":root" */
+    root?: string;
+    /** `color-scheme: light` override selector. @default ".light" */
+    light?: string;
+    /** `color-scheme: dark` override selector. @default ".dark" */
+    dark?: string;
+}
+/** Theme modifier configuration. */
+export interface ThemeConfig {
+    /** Resolver modifier name. */
+    modifier: string;
+    /** Color-scheme mapping. */
+    colorScheme: ThemeColorScheme;
+    /** Override CSS selectors. */
+    selectors?: ThemeSelectors;
+    /** Media query feature name, or `false` to omit. @default "prefers-color-scheme" */
+    media?: string | false;
+}
+/** Fully resolved theme config with defaults applied. */
+export interface ResolvedThemeConfig {
+    modifier: string;
+    light: string;
+    dark: string;
+    defaultScheme: string;
+    rootSelector: string;
+    lightSelector: string;
+    darkSelector: string;
+    media: string | false;
+}
+/** A light/dark value pair for theme-aware tokens. */
+export interface LightDarkPair {
+    /** CSS variable name (without `var()`). */
+    property: string;
+    /** Light-mode CSS value. */
+    light: string;
+    /** Dark-mode CSS value. */
+    dark: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/light-dark/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/light-dark/types.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;CACvB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd"}