@sugarcube-org/core 0.0.1-alpha.15 → 0.0.1-alpha.17

package/dist/index.d.ts

@@ -1,5 +1,22 @@
 import { z } from 'zod';
 
+declare const DEFAULT_CONFIG: {
+    readonly output: {
+        readonly css: "src/styles";
+        readonly components: "src/components/ui";
+        readonly themeAttribute: "data-theme";
+    };
+    readonly transforms: {
+        readonly fluid: {
+            readonly min: 320;
+            readonly max: 1200;
+        };
+        readonly colorFallbackStrategy: "native";
+    };
+};
+
+declare const DEFAULT_STYLES_PATH = "src/styles";
+
 type DirectionalVariant = "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all";
 type PropertyUtilityConfig = {
     /** Token path pattern (e.g., "space.*", "color.primary.*"). */
@@ -106,6 +123,76 @@ interface InternalConfig {
     utilities?: UtilitiesConfig;
 }
 
+/**
+ * Result of loading a sugarcube configuration file.
+ * Contains the validated, normalized configuration and its source path.
+ */
+type LoadedConfig = {
+    /** The validated and normalized configuration with defaults applied. */
+    config: InternalConfig;
+    /** The absolute path to the config file that was loaded. */
+    configPath: string;
+};
+/**
+ * Checks if a sugarcube configuration file exists.
+ *
+ * @param basePath - Base path without extension (default: "sugarcube.config")
+ * @returns True if a .ts or .js config file exists
+ */
+declare function configFileExists(basePath?: string): boolean;
+/**
+ * Loads and validates a sugarcube configuration file.
+ * Returns the user-facing config without internal defaults applied.
+ *
+ * @param configPath - Optional path to config file. If omitted, searches for sugarcube.config.ts/js
+ * @returns The validated config and its resolved path
+ * @throws Error if config file not found or invalid
+ */
+declare function loadSugarcubeConfig(configPath?: string): Promise<{
+    config: SugarcubeConfig;
+    configPath: string;
+}>;
+/**
+ * Loads, validates, and normalizes a sugarcube configuration file.
+ * Returns a complete internal config with all defaults applied.
+ *
+ * @param configPath - Optional path to config file. If omitted, searches for sugarcube.config.ts/js
+ * @returns The normalized config with defaults and its resolved path
+ * @throws Error if config file not found or invalid
+ */
+declare function loadInternalConfig(configPath?: string): Promise<LoadedConfig>;
+
+/**
+ * Validates a user configuration object against the schema and fills in defaults.
+ *
+ * @param config - The user configuration object to validate
+ * @returns The validated configuration with defaults filled in
+ * @throws Error if the configuration is invalid
+ *
+ * @example
+ * const config = { resolver: "./tokens.resolver.json" };
+ * const validatedConfig = validateConfig(config);
+ */
+declare function validateConfig(config: Partial<SugarcubeConfig>): InternalConfig;
+
+/**
+ * Fills in default values for any omitted fields in a user configuration.
+ *
+ * This function takes a user config (with optional fields) and
+ * returns a complete internal config (with all required fields filled in).
+ *
+ * @param userConfig - The user configuration with optional fields
+ * @returns A complete configuration with all defaults filled in
+ *
+ * @example
+ * const userConfig = {
+ *   resolver: "./tokens.resolver.json"
+ * };
+ * const completeConfig = fillDefaults(userConfig);
+ * // completeConfig.output.css === "src/styles"
+ */
+declare function fillDefaults(userConfig: SugarcubeConfig): InternalConfig;
+
 type BaseError = {
     message: string;
 };
@@ -231,6 +318,35 @@ type TokenTree = {
     sourcePath: string;
 };
 
+type FlattenError = BaseError & {
+    path: string;
+    source: TokenSource;
+};
+
+/**
+ * A generated CSS file with its output path and content.
+ */
+type CSSFile = {
+    /** The file path where the CSS will be written. */
+    path: string;
+    /** The generated CSS content. */
+    css: string;
+};
+/**
+ * Array of generated CSS files from the pipeline.
+ * Each file contains a path and the CSS content to write.
+ */
+type CSSFileOutput = CSSFile[];
+
+/** In-memory token data keyed by file path. */
+type TokenMemoryData = Record<string, {
+    context?: string;
+    content: string;
+}>;
+type LoadError = BaseError & {
+    file: string;
+};
+
 /**
  * A token with all references resolved to their final values.
  * Contains both the original value (which may include references)
@@ -264,78 +380,6 @@ type ResolutionError = BaseError & {
     source: TokenSource;
 };
 
-type ConvertedToken<T extends TokenType = TokenType> = ResolvedToken<T> & {
-    $cssProperties: CSSProperties<T>;
-};
-type ConvertedTokens = {
-    [lookupKey: string]: ConvertedToken | NodeMetadata;
-};
-/**
- * Tokens that have been converted to CSS properties, organized by context.
- * Each context (e.g., "default", "dark") maps to its converted tokens.
- */
-type NormalizedConvertedTokens = {
-    [context: string]: ConvertedTokens;
-};
-type CSSProperties<T extends TokenType> = T extends SimpleTokenType ? SimpleCSSProperties : T extends AlwaysDecomposedType ? AlwaysDecomposedProperties : T extends "border" ? CSSBorderProperties : T extends "shadow" ? CSSShadowProperties : T extends "gradient" ? CSSGradientProperties : T extends "transition" ? CSSTransitionProperties : T extends StructuralCompositeType ? SimpleCSSProperties : never;
-type SimpleCSSProperties = {
-    value: string | number;
-    /** Feature queries for progressive enhancement (e.g., P3 colors). */
-    featureValues?: Array<{
-        query: string;
-        value: string;
-    }>;
-};
-type AlwaysDecomposedProperties = CSSTypographyProperties;
-type CSSTypographyProperties = {
-    "font-family": string;
-    "font-size": string;
-    "font-weight"?: number | string;
-    "letter-spacing"?: string;
-    "line-height"?: number | string;
-};
-type CSSBorderProperties = {
-    value: string;
-};
-type CSSShadowProperties = {
-    value: string;
-};
-type CSSGradientProperties = {
-    value: string;
-};
-type CSSTransitionProperties = {
-    value: string;
-};
-
-/**
- * A generated CSS file with its output path and content.
- */
-type CSSFile = {
-    /** The file path where the CSS will be written. */
-    path: string;
-    /** The generated CSS content. */
-    css: string;
-};
-/**
- * Array of generated CSS files from the pipeline.
- * Each file contains a path and the CSS content to write.
- */
-type CSSFileOutput = CSSFile[];
-
-type FlattenError = BaseError & {
-    path: string;
-    source: TokenSource;
-};
-
-/** In-memory token data keyed by file path. */
-type TokenMemoryData = Record<string, {
-    context?: string;
-    content: string;
-}>;
-type LoadError = BaseError & {
-    file: string;
-};
-
 type ValidationError = BaseError & {
     path: string;
     source: TokenSource;
@@ -345,7 +389,7 @@ type ValidationError = BaseError & {
  * Metadata about a modifier (e.g., theme, density) for CSS generation.
  * Used to build attribute selectors like [data-theme="dark"].
  */
-type ModifierMeta$1 = {
+type ModifierMeta = {
     /** The modifier name (e.g., "theme", "density"). */
     name: string;
     /** The HTML attribute name (e.g., "data-theme", "data-density"). */
@@ -365,7 +409,7 @@ type PipelineResult = {
     /** The loaded and processed token trees. */
     trees: TokenTree[];
     /** Modifier metadata for CSS selector generation. */
-    modifiers?: ModifierMeta$1[];
+    modifiers?: ModifierMeta[];
     /** Any errors that occurred during pipeline execution. */
     errors: PipelineErrors;
 };
@@ -415,16 +459,6 @@ type TokenPipelineSource = {
     config: InternalConfig;
 };
 
-/**
- * Generate CSS variable files from converted tokens.
- *
- * @param convertedTokens - The normalized and converted tokens
- * @param config - The configuration object
- * @param modifiers - Optional modifier metadata for generating per-modifier attribute selectors
- * @returns Array of CSS file outputs
- */
-declare function generateCSSVariables(convertedTokens: NormalizedConvertedTokens, config: InternalConfig, modifiers?: ModifierMeta$1[]): Promise<CSSFileOutput>;
-
 /**
  * Result of loading and resolving tokens.
  */
@@ -434,7 +468,7 @@ type LoadAndResolveResult = {
     /** Resolved tokens after reference resolution */
     resolved: ResolvedTokens;
     /** Modifier metadata for CSS selector generation */
-    modifiers: ModifierMeta$1[];
+    modifiers: ModifierMeta[];
     /** Any errors that occurred */
     errors: PipelineResult["errors"];
 };
@@ -464,41 +498,48 @@ type LoadAndResolveResult = {
  */
 declare function loadAndResolveTokens(source: TokenPipelineSource): Promise<LoadAndResolveResult>;
 
-/**
- * Resolved tokens organized by context name.
- * Each key is a context (e.g., "default", "dark", "light")
- * and the value is the resolved tokens for that context.
- */
-type NormalizedTokens = Record<string, ResolvedTokens>;
-/**
- * Result of the normalization process.
- * Contains tokens organized by context and the default context name.
- */
-type NormalizeResult = {
-    /** Tokens organized by context name. */
-    tokens: NormalizedTokens;
-    /** The context that should use :root selector in CSS output. */
-    defaultContext?: string;
+type ConvertedToken<T extends TokenType = TokenType> = ResolvedToken<T> & {
+    $cssProperties: CSSProperties<T>;
+};
+type ConvertedTokens = {
+    [lookupKey: string]: ConvertedToken | NodeMetadata;
 };
-
 /**
- * Result of loading a sugarcube configuration file.
- * Contains the validated, normalized configuration and its source path.
+ * Tokens that have been converted to CSS properties, organized by context.
+ * Each context (e.g., "default", "dark") maps to its converted tokens.
  */
-type LoadedConfig = {
-    /** The validated and normalized configuration with defaults applied. */
-    config: InternalConfig;
-    /** The absolute path to the config file that was loaded. */
-    configPath: string;
+type NormalizedConvertedTokens = {
+    [context: string]: ConvertedTokens;
+};
+type CSSProperties<T extends TokenType> = T extends SimpleTokenType ? SimpleCSSProperties : T extends AlwaysDecomposedType ? AlwaysDecomposedProperties : T extends "border" ? CSSBorderProperties : T extends "shadow" ? CSSShadowProperties : T extends "gradient" ? CSSGradientProperties : T extends "transition" ? CSSTransitionProperties : T extends StructuralCompositeType ? SimpleCSSProperties : never;
+type SimpleCSSProperties = {
+    value: string | number;
+    /** Feature queries for progressive enhancement (e.g., P3 colors). */
+    featureValues?: Array<{
+        query: string;
+        value: string;
+    }>;
+};
+type AlwaysDecomposedProperties = CSSTypographyProperties;
+type CSSTypographyProperties = {
+    "font-family": string;
+    "font-size": string;
+    "font-weight"?: number | string;
+    "letter-spacing"?: string;
+    "line-height"?: number | string;
+};
+type CSSBorderProperties = {
+    value: string;
+};
+type CSSShadowProperties = {
+    value: string;
+};
+type CSSGradientProperties = {
+    value: string;
+};
+type CSSTransitionProperties = {
+    value: string;
 };
-declare function findConfigFile(basePath?: string): string | null;
-declare function configFileExists(basePath?: string): boolean;
-declare function loadTSConfig(configPath: string): Promise<unknown>;
-declare function loadSugarcubeConfig(configPath?: string): Promise<{
-    config: SugarcubeConfig;
-    configPath: string;
-}>;
-declare function loadInternalConfig(configPath?: string): Promise<LoadedConfig>;
 
 /**
  * Processes and converts token trees into CSS-ready format.
@@ -521,38 +562,62 @@ declare function loadInternalConfig(configPath?: string): Promise<LoadedConfig>;
 declare function processAndConvertTokens(trees: TokenTree[], resolved: ResolvedTokens, config: InternalConfig, validationErrors?: ValidationError[]): Promise<NormalizedConvertedTokens>;
 
 /**
- * Modifier metadata for CSS generation.
- * Used to build selectors like [data-theme="dark"].
+ * Generate CSS variable files from converted tokens.
+ *
+ * @param convertedTokens - The normalized and converted tokens
+ * @param config - The configuration object
+ * @param modifiers - Optional modifier metadata for generating per-modifier attribute selectors
+ * @returns Array of CSS file outputs
  */
-type ModifierMeta = {
-    /** The modifier name (e.g., "theme", "density") */
-    name: string;
-    /** Auto-derived CSS attribute (e.g., "data-theme", "data-density") */
-    attribute: string;
-    /** The default context name */
-    defaultContext: string;
-    /** Available non-default context names */
-    contexts: string[];
-};
-/**
- * Result of loading tokens from a resolver document.
+declare function generateCSSVariables(convertedTokens: NormalizedConvertedTokens, config: InternalConfig, modifiers?: ModifierMeta[]): Promise<CSSFileOutput>;
+
+type CSSObject = Record<string, string | number | undefined>;
+/**
+ * Clears the token matching cache.
+ * Call this when tokens change (e.g., on hot reload in dev mode).
  */
-type ResolverLoadResult = {
-    /** Token trees for pipeline processing (base + all modifier contexts) */
-    trees: TokenTree[];
-    /** Modifier metadata for CSS selector generation */
-    modifiers: ModifierMeta[];
-    /** Any errors encountered during loading */
-    errors: LoadError[];
-};
+declare function clearMatchCache(): void;
 /**
- * Load tokens from a resolver document.
+ * Converts a utilities configuration into UnoCSS dynamic rules.
  *
- * Returns TokenTree[] with compound context keys for modifier contexts:
- * - Base tokens: context = undefined (maps to :root)
- * - Modifier contexts: context = "modifierName:contextName" (e.g., "theme:dark")
+ * @param utilitiesConfig - The utilities configuration from sugarcube.config
+ * @param tokens - The converted tokens to generate rules for
+ * @returns Array of UnoCSS dynamic rules [pattern, handler]
+ */
+declare function convertConfigToUnoRules(utilitiesConfig: UtilitiesConfig, tokens: NormalizedConvertedTokens): Array<[RegExp, (m: RegExpMatchArray) => CSSObject]>;
+
+/**
+ * Performance monitor for tracking memory usage and watcher events.
+ * Only active when SUGARCUBE_PERF=true environment variable is set.
+ */
+declare class PerfMonitor implements Disposable {
+    #private;
+    private defaultFlush;
+    constructor(defaultFlush?: (message: string) => undefined);
+    log(message: string, data?: Record<string, unknown>): void;
+    trackWatcherEvent(file: string, moduleGraphSize: number): void;
+    logWatcherSetup(pattern: string, dir: string): void;
+    logModuleGraphStats(modules: number, urls: number, context: string): void;
+    startMemoryMonitor(): void;
+    stopMemoryMonitor(): void;
+    [Symbol.dispose](): void;
+}
+
+/**
+ * Instrumentation for tracking function call counts and execution times.
+ * Only active when DEBUG=true environment variable is set.
+ * Inspired by Tailwind CSS instrumentation.
  */
-declare function loadFromResolver(resolverPath: string): Promise<ResolverLoadResult>;
+declare class Instrumentation implements Disposable {
+    #private;
+    private defaultFlush;
+    constructor(defaultFlush?: (message: string) => undefined);
+    hit(label: string): void;
+    start(label: string): void;
+    end(label: string): void;
+    report(flush?: (message: string) => undefined): void;
+    [Symbol.dispose](): void;
+}
 
 /**
  * Writes CSS files to disk, creating directories as needed.
@@ -594,227 +659,6 @@ declare function writeCSSVariablesToDisk(output: CSSFileOutput): Promise<CSSFile
  */
 declare function writeCSSUtilitiesToDisk(output: CSSFileOutput): Promise<CSSFileOutput>;
 
-/**
- * Validates a user configuration object against the user schema.
- *
- * @param config - The user configuration object to validate
- * @returns The validated user configuration
- * @throws Error if the configuration is invalid
- */
-declare function validateSugarcubeConfig(config: Partial<SugarcubeConfig>): SugarcubeConfig;
-/**
- * Validates an internal configuration object against the internal schema.
- *
- * @param config - The internal configuration object to validate
- * @returns The validated internal configuration
- * @throws Error if the configuration is invalid
- */
-declare function validateInternalConfig(config: InternalConfig): InternalConfig;
-/**
- * Validates a user configuration object against the schema and fills in defaults.
- *
- * @param config - The user configuration object to validate
- * @returns The validated configuration with defaults filled in
- * @throws Error if the configuration is invalid
- *
- * @example
- * const config = { resolver: "./tokens.resolver.json" };
- * const validatedConfig = validateConfig(config);
- */
-declare function validateConfig(config: Partial<SugarcubeConfig>): InternalConfig;
-/**
- * Parses and validates a JSON configuration string.
- *
- * @param configString - The JSON configuration string to parse and validate
- * @returns The validated and normalized configuration
- * @throws Error if the JSON is invalid or the configuration is invalid
- */
-declare function parseAndValidateConfig(configString: string): InternalConfig;
-
-/**
- * Fills in default values for any omitted fields in a user configuration.
- *
- * This function takes a user config (with optional fields) and
- * returns a complete internal config (with all required fields filled in).
- *
- * @param userConfig - The user configuration with optional fields
- * @returns A complete configuration with all defaults filled in
- *
- * @example
- * const userConfig = {
- *   resolver: "./tokens.resolver.json"
- * };
- * const completeConfig = fillDefaults(userConfig);
- * // completeConfig.output.css === "src/styles"
- */
-declare function fillDefaults(userConfig: SugarcubeConfig): InternalConfig;
-
-interface CSSImport {
-    path: string;
-    layer: string;
-    relativePath: string;
-}
-declare function discoverAllFiles(stylesDir: string, config: InternalConfig): Promise<CSSImport[]>;
-
-declare function generateIndexContent(files: CSSImport[]): string;
-
-declare class Instrumentation implements Disposable {
-    #private;
-    private defaultFlush;
-    constructor(defaultFlush?: (message: string) => undefined);
-    hit(label: string): void;
-    start(label: string): void;
-    end(label: string): void;
-    report(flush?: (message: string) => undefined): void;
-    [Symbol.dispose](): void;
-}
-
-declare class PerfMonitor implements Disposable {
-    #private;
-    private defaultFlush;
-    constructor(defaultFlush?: (message: string) => undefined);
-    log(message: string, data?: Record<string, unknown>): void;
-    trackWatcherEvent(file: string, moduleGraphSize: number): void;
-    logWatcherSetup(pattern: string, dir: string): void;
-    logModuleGraphStats(modules: number, urls: number, context: string): void;
-    startMemoryMonitor(): void;
-    stopMemoryMonitor(): void;
-    [Symbol.dispose](): void;
-}
-
-type CSSObject = Record<string, string | number | undefined>;
-declare function clearMatchCache(): void;
-declare function convertConfigToUnoRules(utilitiesConfig: UtilitiesConfig, tokens: NormalizedConvertedTokens): Array<[RegExp, (m: RegExpMatchArray) => CSSObject]>;
-
-declare const SUGARCUBE_FILE = "_sugarcube.css";
-declare const GLOBAL_DIR = "global";
-declare const UTILITIES_DIR = "utilities";
-declare const VARIABLES_FILE_SUFFIX = ".variables.gen.css";
-declare const DEFAULT_VARIABLES_FILENAME = "tokens";
-declare const DEFAULT_UTILITIES_FILENAME = "utilities.gen.css";
-declare const DEFAULT_STYLES_PATH = "src/styles";
-declare const DEFAULT_DESIGN_TOKENS_PATH = "src/design-tokens";
-declare const SUGARCUBE_CONFIG_FILE = "sugarcube.config.ts";
-
-declare const DEFAULT_CONFIG: {
-    readonly output: {
-        readonly css: "src/styles";
-        readonly components: "src/components/ui";
-        readonly themeAttribute: "data-theme";
-    };
-    readonly transforms: {
-        readonly fluid: {
-            readonly min: 320;
-            readonly max: 1200;
-        };
-        readonly colorFallbackStrategy: "native";
-    };
-};
-
-declare const DEFAULT_COLLECTION = "default";
-declare const DEFAULT_CONTEXT = "default";
-
-declare const ErrorMessages: {
-    readonly LOAD: {
-        readonly NO_FILES_FOUND: (pattern: string) => string;
-        readonly INVALID_JSON: (path: string, message: string) => string;
-        readonly GLOB_ERROR: (pattern: string, error: string) => string;
-    };
-    readonly FLATTEN: {
-        readonly INVALID_TOKEN_NAME: (name: string) => string;
-        readonly MISSING_DOLLAR_PREFIX: (path: string) => string;
-        readonly INVALID_TOKEN_NESTING: (path: string) => string;
-        readonly COMPOSITE_TOKEN_MISSING_TYPE: (path: string) => string;
-        readonly CONFLICT_TOKEN_VS_GROUP: (path: string) => string;
-        readonly CONFLICT_INCOMPATIBLE_TYPES: (expected: string, received: string, path: string) => string;
-    };
-    readonly METADATA: {
-        readonly COLLECTION_ERROR: (message: string) => string;
-        readonly INVALID_EXTENSIONS: (path: string) => string;
-        readonly INVALID_DESCRIPTION: (path: string) => string;
-    };
-    readonly VALIDATE: {
-        readonly MISSING_TYPE: (path: string) => string;
-        readonly UNKNOWN_TOKEN_TYPE: (type: string, path: string) => string;
-        readonly INVALID_COLOR: (value: unknown, path: string) => string;
-        readonly INVALID_DIMENSION: (value: unknown, path: string) => string;
-        readonly INVALID_DIMENSION_UNIT: (unit: unknown, path: string) => string;
-        readonly INVALID_FONT_FAMILY: (value: unknown, path: string) => string;
-        readonly INVALID_FONT_WEIGHT: (value: unknown, path: string) => string;
-        readonly INVALID_DURATION: (value: unknown, path: string) => string;
-        readonly INVALID_DURATION_UNIT: (unit: unknown, path: string) => string;
-        readonly INVALID_CUBIC_BEZIER: (value: unknown, path: string) => string;
-        readonly INVALID_STROKE_STYLE: (value: unknown, path: string) => string;
-        readonly INVALID_STROKE_LINE_CAP: (value: unknown, path: string) => string;
-        readonly INVALID_BORDER: (value: unknown, path: string) => string;
-        readonly INVALID_SHADOW: (value: unknown, path: string) => string;
-        readonly INVALID_SHADOW_INSET: (value: unknown, path: string) => string;
-        readonly INVALID_TRANSITION: (value: unknown, path: string) => string;
-        readonly INVALID_GRADIENT: (value: unknown, path: string) => string;
-        readonly INVALID_GRADIENT_STOP_POSITION: (value: unknown, path: string) => string;
-        readonly INVALID_TYPOGRAPHY: (value: unknown, path: string) => string;
-        readonly MISSING_REQUIRED_PROPERTY: (prop: string, path: string) => string;
-        readonly INVALID_NUMBER: (value: unknown, path: string) => string;
-        readonly INVALID_ARRAY: (value: unknown, path: string) => string;
-        readonly MISSING_FLUID_CONFIG: (path: string) => string;
-        readonly INVALID_FLUID_DIMENSION: (value: unknown, path: string) => string;
-        readonly INVALID_VIEWPORT_CONFIG: (value: unknown, path: string) => string;
-        readonly MISMATCHED_UNITS: (unit1: unknown, unit2: unknown, path: string) => string;
-        readonly INVALID_FLUID_VALUE_RANGE: (path: string) => string;
-        readonly INVALID_TOKEN_TYPE: (expected: string, received: string, path: string) => string;
-        readonly INVALID_TYPE: (expected: string, value: unknown, path: string) => string;
-        readonly INVALID_ENUM_VALUE: (enumValues: unknown[], value: unknown, path: string) => string;
-    };
-    readonly RESOLVE: {
-        readonly CIRCULAR_REFERENCE: (path: string, ref: string) => string;
-        readonly REFERENCE_NOT_FOUND: (ref: string, path: string) => string;
-        readonly TYPE_MISMATCH: (path: string) => string;
-    };
-    readonly GENERATE: {
-        readonly INVALID_CSS_VALUE: (key: string, value: unknown) => string;
-        readonly INVALID_VARIABLE_NAME: (path: string, name: string) => string;
-    };
-    readonly CONFIG: {
-        readonly INVALID_JSON: (error: string) => string;
-        readonly INVALID_CONFIG: (path: string, message: string) => string;
-        readonly DUPLICATE_FILENAMES: (filename: string, paths: string[]) => string;
-        readonly FILE_NOT_FOUND: (path: string) => string;
-    };
-    readonly UTILITIES: {
-        readonly RESERVED_PREFIX: (prefix: string, tokenType: string) => string;
-        readonly DUPLICATE_CLASS_NAME: (className: string, paths: string[]) => string;
-        readonly INVALID_PROPERTY_MAPPING: (tokenType: string) => string;
-        readonly DUPLICATE_PREFIX: (prefix: string, tokenType: string) => string;
-        readonly MISSING_SOURCE: (property: string) => string;
-        readonly INVALID_SOURCE_PATTERN: (property: string, source: string) => string;
-        readonly INVALID_DIRECTIONS: (property: string) => string;
-        readonly INVALID_CONFIG_OBJECT: "utilitiesConfig must be an object";
-        readonly INVALID_TOKENS_OBJECT: "tokens must be an object";
-    };
-    readonly RESOLVER: {
-        readonly FILE_NOT_FOUND: (path: string) => string;
-        readonly INVALID_JSON: (message: string) => string;
-        readonly INVALID_REFERENCE: (ref: string) => string;
-        readonly INVALID_SOURCE_REFERENCE: (ref: string) => string;
-        readonly UNDEFINED_SET: (name: string) => string;
-        readonly UNDEFINED_MODIFIER: (name: string) => string;
-        readonly CIRCULAR_REFERENCE: (ref: string) => string;
-        readonly EXTERNAL_FILE_NOT_FOUND: (path: string) => string;
-        readonly EXTERNAL_FILE_ERROR: (path: string, message: string) => string;
-        readonly INVALID_JSON_POINTER: (pointer: string, reason: string) => string;
-        readonly DUPLICATE_NAME: (name: string) => string;
-        readonly MODIFIER_NEEDS_CONTEXTS: "Modifier must have at least one context defined.";
-        readonly MODIFIER_SINGLE_CONTEXT: "Modifier has only one context. Consider using a set instead, or add more contexts.";
-        readonly INVALID_DEFAULT: (name: string, contexts: string[]) => string;
-        readonly UNKNOWN_MODIFIER: (name: string) => string;
-        readonly INVALID_CONTEXT: (context: string, modifier: string, valid: string[]) => string;
-        readonly MISSING_REQUIRED_INPUT: (name: string) => string;
-        readonly INVALID_INPUT_TYPE: (name: string) => string;
-        readonly MALFORMED_REFERENCE: (key: string, value: string) => string;
-        readonly RESOLVER_AS_TOKEN_SOURCE: (path: string) => string;
-    };
-};
-
 declare const userConfigSchema: z.ZodObject<{
     resolver: z.ZodOptional<z.ZodString>;
     transforms: z.ZodOptional<z.ZodObject<{
@@ -890,24 +734,7 @@ declare const userConfigSchema: z.ZodObject<{
         stripDuplicates?: boolean | undefined;
     }>, "many">]>>>;
 }, "strip", z.ZodTypeAny, {
-    utilities?: Record<string, {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    } | {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    }[]> | undefined;
     resolver?: string | undefined;
-    output?: {
-        components?: string | undefined;
-        css?: string | undefined;
-        themeAttribute?: string | undefined;
-        defaultContext?: string | undefined;
-    } | undefined;
     transforms?: {
         fluid?: {
             min: number;
@@ -915,7 +742,12 @@ declare const userConfigSchema: z.ZodObject<{
         } | undefined;
         colorFallbackStrategy?: "native" | "polyfill" | undefined;
     } | undefined;
-}, {
+    output?: {
+        components?: string | undefined;
+        css?: string | undefined;
+        themeAttribute?: string | undefined;
+        defaultContext?: string | undefined;
+    } | undefined;
     utilities?: Record<string, {
         source: string;
         directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
@@ -927,13 +759,8 @@ declare const userConfigSchema: z.ZodObject<{
         prefix?: string | undefined;
         stripDuplicates?: boolean | undefined;
     }[]> | undefined;
+}, {
     resolver?: string | undefined;
-    output?: {
-        components?: string | undefined;
-        css?: string | undefined;
-        themeAttribute?: string | undefined;
-        defaultContext?: string | undefined;
-    } | undefined;
     transforms?: {
         fluid?: {
             min: number;
@@ -941,121 +768,12 @@ declare const userConfigSchema: z.ZodObject<{
         } | undefined;
         colorFallbackStrategy?: "native" | "polyfill" | undefined;
     } | undefined;
-}>;
-declare const internalConfigSchema: z.ZodObject<{
-    resolver: z.ZodOptional<z.ZodString>;
-    transforms: z.ZodObject<{
-        fluid: z.ZodObject<{
-            min: z.ZodNumber;
-            max: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            min: number;
-            max: number;
-        }, {
-            min: number;
-            max: number;
-        }>;
-        colorFallbackStrategy: z.ZodEnum<["native", "polyfill"]>;
-    }, "strip", z.ZodTypeAny, {
-        fluid: {
-            min: number;
-            max: number;
-        };
-        colorFallbackStrategy: "native" | "polyfill";
-    }, {
-        fluid: {
-            min: number;
-            max: number;
-        };
-        colorFallbackStrategy: "native" | "polyfill";
-    }>;
-    output: z.ZodObject<{
-        css: z.ZodString;
-        components: z.ZodOptional<z.ZodString>;
-        themeAttribute: z.ZodString;
-        defaultContext: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        css: string;
-        themeAttribute: string;
-        components?: string | undefined;
-        defaultContext?: string | undefined;
-    }, {
-        css: string;
-        themeAttribute: string;
-        components?: string | undefined;
-        defaultContext?: string | undefined;
-    }>;
-    utilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
-        source: z.ZodString;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, "many">]>>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripDuplicates: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    }, {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    }>, z.ZodArray<z.ZodObject<{
-        source: z.ZodString;
-        directions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, z.ZodArray<z.ZodEnum<["top", "right", "bottom", "left", "x", "y", "full", "all"]>, "many">]>>;
-        prefix: z.ZodOptional<z.ZodString>;
-        stripDuplicates: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    }, {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    }>, "many">]>>>;
-}, "strip", z.ZodTypeAny, {
-    output: {
-        css: string;
-        themeAttribute: string;
-        components?: string | undefined;
-        defaultContext?: string | undefined;
-    };
-    transforms: {
-        fluid: {
-            min: number;
-            max: number;
-        };
-        colorFallbackStrategy: "native" | "polyfill";
-    };
-    utilities?: Record<string, {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    } | {
-        source: string;
-        directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
-        prefix?: string | undefined;
-        stripDuplicates?: boolean | undefined;
-    }[]> | undefined;
-    resolver?: string | undefined;
-}, {
-    output: {
-        css: string;
-        themeAttribute: string;
+    output?: {
         components?: string | undefined;
+        css?: string | undefined;
+        themeAttribute?: string | undefined;
         defaultContext?: string | undefined;
-    };
-    transforms: {
-        fluid: {
-            min: number;
-            max: number;
-        };
-        colorFallbackStrategy: "native" | "polyfill";
-    };
+    } | undefined;
     utilities?: Record<string, {
         source: string;
         directions?: "top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all" | ("top" | "right" | "bottom" | "left" | "x" | "y" | "full" | "all")[] | undefined;
@@ -1067,628 +785,6 @@ declare const internalConfigSchema: z.ZodObject<{
         prefix?: string | undefined;
         stripDuplicates?: boolean | undefined;
     }[]> | undefined;
-    resolver?: string | undefined;
 }>;
 
-/**
- * Name schema for sets, modifiers, and contexts.
- * Names MUST NOT:
- * - Start with '$' (reserved prefix per DTCG spec)
- * - Contain '{' or '}' (used in reference syntax)
- * - Contain '.' (used as path separator in references)
- */
-declare const nameSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-/**
- * Reference object schema.
- * The $ref property uses JSON Pointer syntax for same-document references
- * or file paths for external references.
- */
-declare const referenceObjectSchema: z.ZodObject<{
-    $ref: z.ZodString;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">>;
-/**
- * Source schema - either a reference or inline token group.
- * We use z.unknown() for inline tokens since we don't need to validate
- * token structure at the resolver level.
- */
-declare const sourceSchema: z.ZodUnion<[z.ZodObject<{
-    $ref: z.ZodString;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
-/**
- * Set definition schema for root-level sets map.
- */
-declare const setDefinitionSchema: z.ZodObject<{
-    description: z.ZodOptional<z.ZodString>;
-    sources: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    sources: (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    sources: (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>;
-/**
- * Modifier contexts schema.
- * Each key is a context name, value is an array of sources.
- */
-declare const modifierContextsSchema: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-    $ref: z.ZodString;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-/**
- * Modifier definition schema for root-level modifiers map.
- */
-declare const modifierDefinitionSchema: z.ZodEffects<z.ZodObject<{
-    description: z.ZodOptional<z.ZodString>;
-    contexts: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-    default: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>, {
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>;
-/**
- * Inline set schema for resolutionOrder.
- */
-declare const inlineSetSchema: z.ZodObject<{
-    type: z.ZodLiteral<"set">;
-    name: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-    sources: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">;
-    description: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "set";
-    sources: (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    name: string;
-    type: "set";
-    sources: (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>;
-/**
- * Inline modifier schema for resolutionOrder.
- */
-declare const inlineModifierSchema: z.ZodEffects<z.ZodObject<{
-    type: z.ZodLiteral<"modifier">;
-    name: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-    contexts: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-    description: z.ZodOptional<z.ZodString>;
-    default: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>;
-/**
- * Resolution order item schema.
- * Can be a reference, inline set, or inline modifier.
- */
-declare const resolutionOrderItemSchema: z.ZodUnion<[z.ZodObject<{
-    $ref: z.ZodString;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    $ref: z.ZodString;
-}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
-    type: z.ZodLiteral<"set">;
-    name: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-    sources: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">;
-    description: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "set";
-    sources: (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    name: string;
-    type: "set";
-    sources: (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>, z.ZodEffects<z.ZodObject<{
-    type: z.ZodLiteral<"modifier">;
-    name: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-    contexts: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-    description: z.ZodOptional<z.ZodString>;
-    default: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    name: string;
-    type: "modifier";
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>]>;
-/**
- * Root-level sets map schema.
- */
-declare const setsMapSchema: z.ZodRecord<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>, z.ZodObject<{
-    description: z.ZodOptional<z.ZodString>;
-    sources: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    sources: (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    sources: (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>>;
-/**
- * Root-level modifiers map schema.
- */
-declare const modifiersMapSchema: z.ZodRecord<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>, z.ZodEffects<z.ZodObject<{
-    description: z.ZodOptional<z.ZodString>;
-    contexts: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-    default: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>, {
-    contexts: Record<string, (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}, {
-    contexts: Record<string, (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-    default?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-}>>;
-declare const resolverDocumentSchema: z.ZodObject<{
-    version: z.ZodLiteral<"2025.10">;
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    sets: z.ZodOptional<z.ZodRecord<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>, z.ZodObject<{
-        description: z.ZodOptional<z.ZodString>;
-        sources: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-            $ref: z.ZodString;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">;
-        $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        sources: (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }, {
-        sources: (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }>>>;
-    modifiers: z.ZodOptional<z.ZodRecord<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>, z.ZodEffects<z.ZodObject<{
-        description: z.ZodOptional<z.ZodString>;
-        contexts: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-            $ref: z.ZodString;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-        default: z.ZodOptional<z.ZodString>;
-        $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        contexts: Record<string, (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }, {
-        contexts: Record<string, (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }>, {
-        contexts: Record<string, (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }, {
-        contexts: Record<string, (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }>>>;
-    resolutionOrder: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-        $ref: z.ZodString;
-    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
-        type: z.ZodLiteral<"set">;
-        name: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-        sources: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-            $ref: z.ZodString;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">;
-        description: z.ZodOptional<z.ZodString>;
-        $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "set";
-        sources: (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }, {
-        name: string;
-        type: "set";
-        sources: (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }>, z.ZodEffects<z.ZodObject<{
-        type: z.ZodLiteral<"modifier">;
-        name: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>;
-        contexts: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodObject<{
-            $ref: z.ZodString;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>, "many">>;
-        description: z.ZodOptional<z.ZodString>;
-        default: z.ZodOptional<z.ZodString>;
-        $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "modifier";
-        contexts: Record<string, (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }, {
-        name: string;
-        type: "modifier";
-        contexts: Record<string, (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }>, {
-        name: string;
-        type: "modifier";
-        contexts: Record<string, (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }, {
-        name: string;
-        type: "modifier";
-        contexts: Record<string, (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }>]>, "many">;
-    $schema: z.ZodOptional<z.ZodString>;
-    $extensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    $defs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, "strip", z.ZodTypeAny, {
-    version: "2025.10";
-    resolutionOrder: (z.objectOutputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | {
-        name: string;
-        type: "set";
-        sources: (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    } | {
-        name: string;
-        type: "modifier";
-        contexts: Record<string, (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    })[];
-    name?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-    sets?: Record<string, {
-        sources: (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }> | undefined;
-    modifiers?: Record<string, {
-        contexts: Record<string, (z.objectOutputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }> | undefined;
-    $schema?: string | undefined;
-    $defs?: Record<string, unknown> | undefined;
-}, {
-    version: "2025.10";
-    resolutionOrder: (z.objectInputType<{
-        $ref: z.ZodString;
-    }, z.ZodTypeAny, "passthrough"> | {
-        name: string;
-        type: "set";
-        sources: (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    } | {
-        name: string;
-        type: "modifier";
-        contexts: Record<string, (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    })[];
-    name?: string | undefined;
-    $extensions?: Record<string, unknown> | undefined;
-    description?: string | undefined;
-    sets?: Record<string, {
-        sources: (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[];
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }> | undefined;
-    modifiers?: Record<string, {
-        contexts: Record<string, (z.objectInputType<{
-            $ref: z.ZodString;
-        }, z.ZodTypeAny, "passthrough"> | Record<string, unknown>)[]>;
-        default?: string | undefined;
-        $extensions?: Record<string, unknown> | undefined;
-        description?: string | undefined;
-    }> | undefined;
-    $schema?: string | undefined;
-    $defs?: Record<string, unknown> | undefined;
-}>;
-
-declare function isResolvedToken(token: unknown): token is ResolvedToken;
-declare function isResolvedTokenOfType<T extends TokenType>(token: unknown, type: T): token is ResolvedToken<T>;
-
-/**
- * Check if an object is a reference (has $ref property).
- */
-declare function isReference(value: unknown): value is {
-    $ref: string;
-};
-/**
- * Type guard for inline set in resolutionOrder.
- */
-declare function isInlineSet(item: unknown): item is {
-    type: "set";
-    name: string;
-    sources: unknown[];
-};
-/**
- * Type guard for inline modifier in resolutionOrder.
- */
-declare function isInlineModifier(item: unknown): item is {
-    type: "modifier";
-    name: string;
-    contexts: Record<string, unknown[]>;
-    default?: string;
-};
-
-export { type CSSFileOutput, DEFAULT_COLLECTION, DEFAULT_CONFIG, DEFAULT_CONTEXT, DEFAULT_DESIGN_TOKENS_PATH, DEFAULT_STYLES_PATH, DEFAULT_UTILITIES_FILENAME, DEFAULT_VARIABLES_FILENAME, ErrorMessages, GLOBAL_DIR, Instrumentation, type InternalConfig, type LoadAndResolveResult, type LoadedConfig, type ModifierMeta, type NormalizeResult, type NormalizedConvertedTokens, type NormalizedTokens, type OutputConfig, PerfMonitor, type ModifierMeta$1 as PipelineModifierMeta, type PipelineResult, type ResolvedToken, type ResolvedTokens, type ResolverLoadResult, SUGARCUBE_CONFIG_FILE, SUGARCUBE_FILE, type SugarcubeConfig, type TokenPipelineSource, type TokenTree, UTILITIES_DIR, type UtilitiesConfig, VARIABLES_FILE_SUFFIX, clearMatchCache, configFileExists, convertConfigToUnoRules, discoverAllFiles, fillDefaults, findConfigFile, generateCSSVariables, generateIndexContent, inlineModifierSchema, inlineSetSchema, internalConfigSchema, isInlineModifier, isInlineSet, isReference, isResolvedToken, isResolvedTokenOfType, loadAndResolveTokens, loadFromResolver, loadInternalConfig, loadSugarcubeConfig, loadTSConfig, modifierContextsSchema, modifierDefinitionSchema, modifiersMapSchema, nameSchema, parseAndValidateConfig, processAndConvertTokens, referenceObjectSchema, resolutionOrderItemSchema, resolverDocumentSchema, setDefinitionSchema, setsMapSchema, sourceSchema, userConfigSchema, validateConfig, validateInternalConfig, validateSugarcubeConfig, writeCSSUtilitiesToDisk, writeCSSVariablesToDisk };
+export { type CSSFileOutput, DEFAULT_CONFIG, DEFAULT_STYLES_PATH, Instrumentation, type InternalConfig, type ModifierMeta, type NormalizedConvertedTokens, PerfMonitor, type ResolvedTokens, type SugarcubeConfig, type TokenPipelineSource, type TokenTree, clearMatchCache, configFileExists, convertConfigToUnoRules, fillDefaults, generateCSSVariables, loadAndResolveTokens, loadInternalConfig, loadSugarcubeConfig, processAndConvertTokens, userConfigSchema, validateConfig, writeCSSUtilitiesToDisk, writeCSSVariablesToDisk };