@canonical/terrazzo-plugin-css 0.0.2 → 0.2.0

package/dist/types/plugin/src/light-dark/wrapLightDark.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Wrap two values in `light-dark()`. Returns the plain value if both are identical.
+ *
+ * @example wrapLightDark("oklch(0.5 0.1 200)", "oklch(0.8 0.1 200)") => "light-dark(oklch(0.5 0.1 200), oklch(0.8 0.1 200))"
+ * @example wrapLightDark("#000", "#000") => "#000"
+ */
+export default function wrapLightDark(light: string, dark: string): string;
+//# sourceMappingURL=wrapLightDark.d.ts.map

package/dist/types/plugin/src/light-dark/wrapLightDark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapLightDark.d.ts","sourceRoot":"","sources":["../../../../../src/light-dark/wrapLightDark.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzE"}

package/dist/types/plugin/src/modifiers/buildModifierContextCSS.d.ts

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

package/dist/types/plugin/src/modifiers/buildModifierContextCSS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildModifierContextCSS.d.ts","sourceRoot":"","sources":["../../../../../src/modifiers/buildModifierContextCSS.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,GAAG,EAAE,eAAe,GACnB,OAAO,EAAE,CAKX"}

package/dist/types/plugin/src/modifiers/computeModifierContext.d.ts

@@ -0,0 +1,3 @@
+import type { ModifierContext, OverlayToken } from "../types.js";
+export default function computeModifierContext(family: string, context: string, baseTokens: Record<string, OverlayToken>, overlayTokens: Record<string, OverlayToken>, prefix?: string, aliasMap?: Record<string, string>, selectorOverride?: string): ModifierContext;
+//# sourceMappingURL=computeModifierContext.d.ts.map

package/dist/types/plugin/src/modifiers/computeModifierContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeModifierContext.d.ts","sourceRoot":"","sources":["../../../../../src/modifiers/computeModifierContext.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAqBjE,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACxC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC3C,MAAM,SAAa,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,gBAAgB,CAAC,EAAE,MAAM,GACxB,eAAe,CA8BjB"}

package/dist/types/plugin/src/modifiers/getAliasTarget.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract the alias target from a token via the standard DTCG `aliasOf` field.
+ */
+import type { OverlayToken } from "../types.js";
+export default function getAliasTarget(token: OverlayToken): string | undefined;
+//# sourceMappingURL=getAliasTarget.d.ts.map

package/dist/types/plugin/src/modifiers/getAliasTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAliasTarget.d.ts","sourceRoot":"","sources":["../../../../../src/modifiers/getAliasTarget.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,KAAK,EAAE,YAAY,GAClB,MAAM,GAAG,SAAS,CAEpB"}

package/dist/types/plugin/src/modifiers/index.d.ts

@@ -0,0 +1,4 @@
+export { default as buildModifierContextCSS } from "./buildModifierContextCSS.js";
+export { default as computeModifierContext } from "./computeModifierContext.js";
+export { default as getAliasTarget } from "./getAliasTarget.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugin/src/modifiers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modifiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/plugin/src/modifiers/types.d.ts

@@ -0,0 +1,42 @@
+/** Media-driven modifier configuration (motion, contrast). */
+export interface MediaModifierConfig {
+    /** Resolver modifier name. */
+    modifier: string;
+    /** Media feature name (e.g. "prefers-reduced-motion"). */
+    media: string;
+    /** Class-based override selectors, keyed by context name. */
+    selectors?: Record<string, string>;
+}
+/**
+ * Surface layer configuration.
+ *
+ * Overrides the default depth-based `.surface` selector mapping used
+ * for surface modifier contexts (layer1, layer2, layer3).
+ */
+export interface SurfaceConfig {
+    /**
+     * Map of resolver context names to CSS selectors.
+     * @default { layer1: ".surface", layer2: ".surface .surface", layer3: ".surface .surface .surface" }
+     */
+    selectors?: Record<string, string>;
+}
+/** Minimal token shape for overlay detection. */
+export interface OverlayToken {
+    source?: {
+        loc?: unknown;
+    };
+    $value?: unknown;
+    aliasOf?: string;
+}
+/** A modifier family context with its resolved CSS class declarations. */
+export interface ModifierContext {
+    /** Family name (e.g. "anticipation"). */
+    family: string;
+    /** Context name (e.g. "constructive"). */
+    context: string;
+    /** CSS class selector (e.g. ".constructive"). */
+    selector: string;
+    /** Declarations: --modifier-{role}: var(--{aliasTarget}). */
+    declarations: import("../css-ast/types.js").CSSDeclaration[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/plugin/src/modifiers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/modifiers/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,qBAAqB,EAAE,cAAc,EAAE,CAAC;CAC9D"}

package/dist/types/plugin/src/naming.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Convert a DTCG token ID to a CSS custom property name.
+ *
+ * Rules:
+ * 1. Strip the `.$root` terminal if present
+ * 2. Replace every `.` with `-`
+ * 3. Prepend `--`
+ *
+ * @example convertTokenIdToCssVar("color.foreground.primary.$root") => "--color-foreground-primary"
+ * @example convertTokenIdToCssVar("typography.heading.1.fontSize") => "--typography-heading-1-fontSize"
+ */
+export declare function convertTokenIdToCssVar(id: string): string;
+/**
+ * Add a channel prefix to a CSS variable name.
+ *
+ * @example prefixVar("--color-foreground-primary", "modifier") => "--modifier-color-foreground-primary"
+ */
+export declare function prefixVar(cssVar: string, prefix: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/types/plugin/src/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../src/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/types/plugin/src/plugin/canonicalPlugin.d.ts

@@ -0,0 +1,18 @@
+import type { GetTransformsFn, OutputFileFn, ResolverLike, SetTransformFn, TokenMap } from "../build/shims.js";
+import type { CanonicalPluginOptions } from "./types.js";
+/** Create the Canonical CSS plugin for Terrazzo. */
+export default function canonicalPlugin(options?: CanonicalPluginOptions): {
+    name: string;
+    transform({ tokens, setTransform, resolver, }: {
+        tokens: TokenMap;
+        setTransform: SetTransformFn;
+        resolver: ResolverLike;
+    }): Promise<void>;
+    build({ tokens, getTransforms, resolver, outputFile, }: {
+        tokens: TokenMap;
+        getTransforms: GetTransformsFn;
+        resolver: ResolverLike;
+        outputFile: OutputFileFn;
+    }): Promise<void>;
+};
+//# sourceMappingURL=canonicalPlugin.d.ts.map

package/dist/types/plugin/src/plugin/canonicalPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalPlugin.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/canonicalPlugin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,oDAAoD;AACpD,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,GAAE,sBAA2B;;mDAiBrE;QACD,MAAM,EAAE,QAAQ,CAAC;QACjB,YAAY,EAAE,cAAc,CAAC;QAC7B,QAAQ,EAAE,YAAY,CAAC;KACxB;4DAWE;QACD,MAAM,EAAE,QAAQ,CAAC;QACjB,aAAa,EAAE,eAAe,CAAC;QAC/B,QAAQ,EAAE,YAAY,CAAC;QACvB,UAAU,EAAE,YAAY,CAAC;KAC1B;EA8BJ"}

package/dist/types/plugin/src/plugin/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @module
+ * Public plugin exports.
+ */
+export { default } from "./canonicalPlugin.js";
+export type { CanonicalPluginOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/types/plugin/src/plugin/types.d.ts

@@ -0,0 +1,36 @@
+import type { SetConfig, StatesConfig, TypographyConfig } from "../build/types.js";
+import type { LayerConfig } from "../layers/types.js";
+import type { LightDarkPair, ResolvedThemeConfig, ThemeColorScheme, ThemeConfig, ThemeSelectors } from "../light-dark/types.js";
+import type { MediaModifierConfig, ModifierContext, OverlayToken, SurfaceConfig } from "../modifiers/types.js";
+export type { LayerConfig, LightDarkPair, MediaModifierConfig, ModifierContext, OverlayToken, ResolvedThemeConfig, SetConfig, StatesConfig, SurfaceConfig, ThemeColorScheme, ThemeConfig, ThemeSelectors, TypographyConfig, };
+/** Top-level plugin options. */
+export interface CanonicalPluginOptions {
+    /** CSS @layer names. */
+    layers?: Partial<LayerConfig>;
+    /** Set configurations (primitive, semantic). */
+    sets?: {
+        primitive?: SetConfig;
+        semantic?: SetConfig;
+    };
+    /** Theme modifier (light/dark with light-dark()). */
+    theme?: ThemeConfig;
+    /** Typography modifier. */
+    typography?: TypographyConfig;
+    /** Modifier family names (e.g. ["anticipation", "criticality"]). */
+    families?: string[];
+    /** Motion preference modifier. */
+    motion?: MediaModifierConfig;
+    /** Contrast preference modifier. */
+    contrast?: MediaModifierConfig;
+    /** Surface configuration. Maps resolver context names to CSS selectors. */
+    surfaces?: SurfaceConfig;
+    /** NativeState derivation layer. */
+    states?: StatesConfig;
+    /**
+     * Base directory for token source files.
+     * Used to locate modifier source files and read DTCG alias targets.
+     * @default "./tokens/canonical"
+     */
+    tokensDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/plugin/src/plugin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF,gCAAgC;AAChC,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9B,gDAAgD;IAChD,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB,CAAC;IAEF,qDAAqD;IACrD,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/plugin/src/plugin.d.ts

@@ -0,0 +1,18 @@
+import type { GetTransformsFn, OutputFileFn, ResolverLike, SetTransformFn, TokenLike } from "./build/shims.js";
+import type { CanonicalPluginOptions } from "./types.js";
+/** Create the Canonical CSS plugin for Terrazzo. */
+export declare function canonicalPlugin(options?: CanonicalPluginOptions): {
+    name: string;
+    transform({ tokens, setTransform, resolver, }: {
+        tokens: Record<string, TokenLike>;
+        setTransform: SetTransformFn;
+        resolver: ResolverLike;
+    }): Promise<void>;
+    build({ tokens, getTransforms, resolver, outputFile, }: {
+        tokens: Record<string, TokenLike>;
+        getTransforms: GetTransformsFn;
+        resolver: ResolverLike;
+        outputFile: OutputFileFn;
+    }): Promise<void>;
+};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugin.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAY,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEnE,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B;;mDAiB7D;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClC,YAAY,EAAE,cAAc,CAAC;QAC7B,QAAQ,EAAE,YAAY,CAAC;KACxB;4DAWE;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClC,aAAa,EAAE,eAAe,CAAC;QAC/B,QAAQ,EAAE,YAAY,CAAC;QACvB,UAAU,EAAE,YAAY,CAAC;KAC1B;EAoBJ"}

package/dist/types/plugin/src/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Type definitions for @canonical/terrazzo-plugin-css.
+ *
+ * Types-first: every public contract is defined here before any
+ * implementation code exists.
+ */
+/** 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;
+}
+/** 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;
+}
+/** 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;
+}
+/** Media-driven modifier configuration (motion, contrast). */
+export interface MediaModifierConfig {
+    /** Resolver modifier name. */
+    modifier: string;
+    /** Media feature name (e.g. "prefers-reduced-motion"). */
+    media: string;
+    /** Class-based override selectors, keyed by context name. */
+    selectors?: Record<string, string>;
+}
+/** NativeState derivation layer configuration. */
+export interface StatesConfig {
+    /** CSS selector for the derivation block. @default "*" */
+    selector: string;
+}
+/**
+ * Surface layer configuration.
+ *
+ * Overrides the default depth-based `.surface` selector mapping used
+ * for surface modifier contexts (layer1, layer2, layer3).
+ */
+export interface SurfaceConfig {
+    /**
+     * Map of resolver context names to CSS selectors.
+     * @default { layer1: ".surface", layer2: ".surface .surface", layer3: ".surface .surface .surface" }
+     */
+    selectors?: Record<string, string>;
+}
+/** Top-level plugin options. */
+export interface CanonicalPluginOptions {
+    /** CSS @layer names. */
+    layers?: Partial<LayerConfig>;
+    /** Set configurations (primitive, semantic). */
+    sets?: {
+        primitive?: SetConfig;
+        semantic?: SetConfig;
+    };
+    /** Theme modifier (light/dark with light-dark()). */
+    theme?: ThemeConfig;
+    /** Typography modifier. */
+    typography?: TypographyConfig;
+    /** Modifier family names (e.g. ["anticipation", "criticality"]). */
+    families?: string[];
+    /** Motion preference modifier. */
+    motion?: MediaModifierConfig;
+    /** Contrast preference modifier. */
+    contrast?: MediaModifierConfig;
+    /** Surface configuration. Maps resolver context names to CSS selectors. */
+    surfaces?: SurfaceConfig;
+    /** NativeState derivation layer. */
+    states?: StatesConfig;
+    /**
+     * Base directory for token source files.
+     * Used to locate modifier source files and read DTCG alias targets.
+     * @default "./tokens/canonical"
+     */
+    tokensDir?: string;
+}
+/** Fully resolved layer config with defaults applied. */
+export interface ResolvedLayerConfig {
+    tokens: string | null;
+    modifiers: string | null;
+    surfaces: string | null;
+    states: string | null;
+}
+/** 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;
+}
+export interface CSSDeclaration {
+    type: "Declaration";
+    property: string;
+    value: string;
+    comment?: string;
+}
+export interface CSSRule {
+    type: "Rule";
+    prelude: string[];
+    children: (CSSRule | CSSDeclaration)[];
+}
+export type CSSNode = CSSRule | CSSDeclaration;
+export interface PrintOptions {
+    indentChar?: string;
+    indentLv?: number;
+}
+export type { Artifact, ArtifactAtRule, ArtifactDeclaration, ArtifactToken, ArtifactTokenInit, DerivationKind, DerivedArtifactTokenInit, DtcgTokenType, KnownDtcgTokenType, TokenTier, } from "@canonical/token-types";
+/** 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;
+}
+/** 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;
+}
+/** Minimal token shape for overlay detection. */
+export interface OverlayToken {
+    source?: {
+        loc?: unknown;
+    };
+    $value?: unknown;
+    aliasOf?: string;
+}
+/** A modifier family context with its resolved CSS class declarations. */
+export interface ModifierContext {
+    /** Family name (e.g. "anticipation"). */
+    family: string;
+    /** Context name (e.g. "constructive"). */
+    context: string;
+    /** CSS class selector (e.g. ".constructive"). */
+    selector: string;
+    /** Declarations: --modifier-{role}: var(--{aliasTarget}). */
+    declarations: CSSDeclaration[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/plugin/src/types.d.ts.map

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

package/dist/types/plugin/types.d.ts

@@ -0,0 +1,36 @@
+import type { SetConfig, StatesConfig, TypographyConfig } from "../build/types.js";
+import type { LayerConfig } from "../layers/types.js";
+import type { LightDarkPair, ResolvedThemeConfig, ThemeColorScheme, ThemeConfig, ThemeSelectors } from "../light-dark/types.js";
+import type { MediaModifierConfig, ModifierContext, OverlayToken, SurfaceConfig } from "../modifiers/types.js";
+export type { LayerConfig, LightDarkPair, MediaModifierConfig, ModifierContext, OverlayToken, ResolvedThemeConfig, SetConfig, StatesConfig, SurfaceConfig, ThemeColorScheme, ThemeConfig, ThemeSelectors, TypographyConfig, };
+/** Top-level plugin options. */
+export interface CanonicalPluginOptions {
+    /** CSS @layer names. */
+    layers?: Partial<LayerConfig>;
+    /** Set configurations (primitive, semantic). */
+    sets?: {
+        primitive?: SetConfig;
+        semantic?: SetConfig;
+    };
+    /** Theme modifier (light/dark with light-dark()). */
+    theme?: ThemeConfig;
+    /** Typography modifier. */
+    typography?: TypographyConfig;
+    /** Modifier family names (e.g. ["anticipation", "criticality"]). */
+    families?: string[];
+    /** Motion preference modifier. */
+    motion?: MediaModifierConfig;
+    /** Contrast preference modifier. */
+    contrast?: MediaModifierConfig;
+    /** Surface configuration. Maps resolver context names to CSS selectors. */
+    surfaces?: SurfaceConfig;
+    /** NativeState derivation layer. */
+    states?: StatesConfig;
+    /**
+     * Base directory for token source files.
+     * Used to locate modifier source files and read DTCG alias targets.
+     * @default "./tokens/canonical"
+     */
+    tokensDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF,gCAAgC;AAChC,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9B,gDAAgD;IAChD,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB,CAAC;IAEF,qDAAqD;IACrD,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB,oCAAoC;IACpC,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/plugin.d.ts

@@ -1,73 +1,9 @@
-import type { CanonicalPluginOptions } from "./types.js";
 /**
- * Create the Canonical CSS plugin for Terrazzo.
+ * Plugin composition-root shim.
  *
- * @example
- * ```ts
- * import { defineConfig } from "@terrazzo/cli";
- * import { canonicalPlugin } from "./src/plugin/plugin.js";
- *
- * export default defineConfig({
- *   tokens: ["./tokens/canonical/canonical.resolver.json"],
- *   plugins: [canonicalPlugin()],
- * });
- * ```
+ * Keeps the historical `plugin.ts` entry point while the implementation,
+ * its sidecar tests, and its option types live together under `plugin/`.
  */
-export declare function canonicalPlugin(options?: CanonicalPluginOptions): {
-    name: string;
-    transform({ tokens, setTransform, resolver, }: {
-        tokens: Record<string, TokenLike>;
-        setTransform: SetTransformFn;
-        resolver: ResolverLike;
-    }): Promise<void>;
-    build({ tokens, getTransforms, resolver, outputFile, }: {
-        tokens: Record<string, TokenLike>;
-        getTransforms: GetTransformsFn;
-        resolver: ResolverLike;
-        outputFile: (filename: string, contents: string | Uint8Array) => void;
-    }): Promise<void>;
-};
-interface TokenLike {
-    $type?: string;
-    $value?: unknown;
-    $description?: string;
-    $extensions?: Record<string, unknown>;
-    id?: string;
-    source?: {
-        loc?: unknown;
-        filename?: string;
-    };
-    aliasOf?: string;
-    aliasChain?: string[];
-}
-type SetTransformFn = (id: string, params: {
-    format: string;
-    localID?: string;
-    value: string | Record<string, string>;
-    input?: Record<string, string>;
-    meta?: Record<string, unknown>;
-}) => void;
-interface TransformResult {
-    id: string;
-    localID?: string;
-    type: "SINGLE_VALUE" | "MULTI_VALUE";
-    value: string & Record<string, string>;
-    input: Record<string, string>;
-    token: TokenLike;
-}
-type GetTransformsFn = (params: {
-    format: string;
-    id?: string | string[];
-    $type?: string | string[];
-    input?: Record<string, string>;
-}) => TransformResult[];
-interface ResolverLike {
-    apply(input: Record<string, string>): Record<string, unknown>;
-    source?: {
-        modifiers?: Record<string, {
-            contexts?: Record<string, unknown[]>;
-        }>;
-    };
-}
-export {};
+export { default } from "./plugin/index.js";
+export type { CanonicalPluginOptions } from "./plugin/types.js";
 //# sourceMappingURL=plugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAEV,sBAAsB,EAKvB,MAAM,YAAY,CAAC;AA8LpB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B;;mDAkB7D;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClC,YAAY,EAAE,cAAc,CAAC;QAC7B,QAAQ,EAAE,YAAY,CAAC;KACxB;4DAiFE;QACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClC,aAAa,EAAE,eAAe,CAAC;QAC/B,QAAQ,EAAE,YAAY,CAAC;QACvB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,CAAC;KACvE;EAwDJ;AAwzBD,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,KAAK,cAAc,GAAG,CACpB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,KACE,IAAI,CAAC;AAEV,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,GAAG,aAAa,CAAC;IACrC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,KAAK,eAAe,GAAG,CAAC,MAAM,EAAE;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,KAAK,eAAe,EAAE,CAAC;AAExB,UAAU,YAAY;IACpB,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;SAAE,CAAC,CAAC;KACtE,CAAC;CACH"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}