mlform 0.1.2 → 0.1.4

package/dist/types/src/design-system/constants.d.ts

@@ -0,0 +1,34 @@
+export declare const designSystemEventNames: {
+    readonly change: "ml-design-system-change";
+};
+export declare const designSystemMediaQueries: {
+    readonly prefersDarkScheme: "(prefers-color-scheme: dark)";
+    readonly prefersReducedMotion: "(prefers-reduced-motion: reduce)";
+    readonly prefersMoreContrast: "(prefers-contrast: more)";
+    readonly forcedColors: "(forced-colors: active)";
+};
+export declare const designSystemHostAttributeNames: {
+    readonly explicitScheme: "data-color-scheme";
+    readonly inheritedScheme: "data-mlf-scheme";
+    readonly effectiveScheme: "data-mlf-effective-scheme";
+    readonly themeId: "data-mlf-theme-id";
+    readonly variantId: "data-mlf-variant-id";
+    readonly recipeId: "data-mlf-recipe-id";
+    readonly density: "data-mlf-density";
+    readonly motion: "data-mlf-motion";
+    readonly signature: "data-mlf-signature";
+    readonly style: "style";
+    readonly class: "class";
+};
+/**
+ * Attributes observed on the HOST element — only externally-controlled scheme
+ * attributes. Excludes `style` and our own `data-mlf-*` writes to prevent
+ * self-triggering the MutationObserver on every `applyResolvedDesignSystem` call.
+ */
+export declare const designSystemHostObservedAttributeFilter: readonly ["data-color-scheme"];
+/**
+ * Attributes observed on ANCESTOR elements for inherited scheme detection.
+ * Includes `style` and `class` because an ancestor may set `color-scheme`
+ * via CSS or a class selector.
+ */
+export declare const designSystemAncestorObservedAttributeFilter: readonly ["data-mlf-scheme", "data-mlf-effective-scheme", "data-color-scheme", "style", "class"];

package/dist/types/src/design-system/contract/component-keys.d.ts

@@ -0,0 +1,2 @@
+export declare const componentKeys: readonly ["shell", "hero", "field", "report", "input", "submit", "error", "toggle", "status", "chart"];
+export type ComponentKey = (typeof componentKeys)[number];

package/dist/types/src/design-system/contract/component-tokens.d.ts

@@ -0,0 +1,5 @@
+import { ComponentKey } from './component-keys';
+export type ComponentTokenManifest = {
+    tokens: Record<string, string>;
+};
+export declare const componentTokenDefaults: Record<ComponentKey, ComponentTokenManifest>;

package/dist/types/src/design-system/contract/global-tokens.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Canonical neutral-light color values. Single source of truth shared by
+ * `globalTokenDefaults` (fallback layer) and `neutralTheme.schemes.light`.
+ * Edit here; both consumers update automatically.
+ */
+export declare const neutralLightColorTokens: Record<string, string>;
+export declare const globalTokenDefaults: Record<string, string>;

package/dist/types/src/design-system/contract/index.d.ts

@@ -0,0 +1,4 @@
+export { componentKeys, type ComponentKey } from './component-keys';
+export { componentTokenDefaults, type ComponentTokenManifest } from './component-tokens';
+export { globalTokenDefaults } from './global-tokens';
+export { mlfTokenKeys, type MlfTokenKey } from './token-keys';

package/dist/types/src/design-system/contract/token-keys.d.ts

@@ -0,0 +1,12 @@
+/**
+ * All `--mlf-*` CSS custom property keys defined by the design system.
+ *
+ * Use with `(string & {})` to get IDE autocompletion while still accepting
+ * arbitrary custom properties:
+ *
+ * ```ts
+ * const tokens: Record<MlfTokenKey | (string & {}), string> = { ... };
+ * ```
+ */
+export declare const mlfTokenKeys: readonly ["--mlf-font-family-body", "--mlf-font-family-heading", "--mlf-font-family-ui", "--mlf-font-family-mono", "--mlf-font-size-xs", "--mlf-font-size-sm", "--mlf-font-size-md", "--mlf-font-size-lg", "--mlf-font-size-xl", "--mlf-font-size-2xl", "--mlf-line-height-tight", "--mlf-line-height-normal", "--mlf-space-1", "--mlf-space-2", "--mlf-space-3", "--mlf-space-4", "--mlf-space-5", "--mlf-space-6", "--mlf-space-7", "--mlf-space-8", "--mlf-radius-sm", "--mlf-radius-md", "--mlf-radius-lg", "--mlf-radius-xl", "--mlf-radius-pill", "--mlf-border-width", "--mlf-ring-width", "--mlf-shadow-sm", "--mlf-shadow-md", "--mlf-shadow-lg", "--mlf-motion-fast", "--mlf-motion-base", "--mlf-motion-slow", "--mlf-transition-duration", "--mlf-transition-easing", "--mlf-layout-gap", "--mlf-section-gap", "--mlf-pane-gap", "--mlf-shell-gap", "--mlf-control-height", "--mlf-control-padding-inline", "--mlf-control-padding-block", "--mlf-pane-min-width", "--mlf-color-bg", "--mlf-color-surface", "--mlf-color-surface-muted", "--mlf-color-surface-elevated", "--mlf-color-text", "--mlf-color-text-muted", "--mlf-color-text-inverse", "--mlf-color-border", "--mlf-color-border-strong", "--mlf-color-accent", "--mlf-color-accent-hover", "--mlf-color-accent-soft", "--mlf-color-success", "--mlf-color-warning", "--mlf-color-danger", "--mlf-color-danger-soft", "--mlf-color-focus-ring", "--mlf-color-overlay", "--mlf-color-hover-surface", "--mlf-color-chart-track", "--mlf-shell-color", "--mlf-shell-bg", "--mlf-shell-overlay", "--mlf-shell-panel-bg", "--mlf-shell-panel-border", "--mlf-shell-panel-shadow-soft", "--mlf-shell-panel-shadow", "--mlf-shell-header-bg", "--mlf-shell-header-blur", "--mlf-shell-action-bg", "--mlf-shell-left-min-width", "--mlf-shell-left-max-width", "--mlf-shell-right-min-width", "--mlf-hero-bg", "--mlf-hero-border", "--mlf-hero-shadow", "--mlf-hero-radius", "--mlf-hero-eyebrow-color", "--mlf-hero-status-bg", "--mlf-field-bg", "--mlf-field-border", "--mlf-field-border-invalid", "--mlf-field-shadow", "--mlf-field-radius", "--mlf-field-label-color", "--mlf-field-description-color", "--mlf-field-meta-bg", "--mlf-field-meta-color", "--mlf-field-error-bg", "--mlf-field-error-color", "--mlf-report-bg", "--mlf-report-border", "--mlf-report-shadow", "--mlf-report-radius", "--mlf-report-label-color", "--mlf-report-description-color", "--mlf-report-meta-bg", "--mlf-report-meta-color", "--mlf-report-empty-bg", "--mlf-report-empty-color", "--mlf-report-hero-bg", "--mlf-report-error-bg", "--mlf-report-error-color", "--mlf-input-bg", "--mlf-input-bg-disabled", "--mlf-input-border", "--mlf-input-border-focus", "--mlf-input-text", "--mlf-input-placeholder", "--mlf-input-radius", "--mlf-input-shadow-focus", "--mlf-submit-bg", "--mlf-submit-bg-hover", "--mlf-submit-color", "--mlf-submit-shadow", "--mlf-submit-shadow-hover", "--mlf-submit-radius", "--mlf-submit-focus-ring", "--mlf-error-bg", "--mlf-error-border", "--mlf-error-color", "--mlf-toggle-bg", "--mlf-toggle-border", "--mlf-toggle-text", "--mlf-toggle-accent", "--mlf-status-bg", "--mlf-status-color", "--mlf-chart-track-bg", "--mlf-chart-fill-bg"];
+export type MlfTokenKey = (typeof mlfTokenKeys)[number];

package/dist/types/src/design-system/index.d.ts

@@ -0,0 +1,8 @@
+export type { AttachDesignSystemOptions, AttachedDesignSystem, ComponentManifest, Density, DesignSystemConfig, DesignSystemControllerOptions, DesignSystemMode, DesignSystemRegistry, DesignSystemRegistryChangeEvent, DesignSystemRegistryChangeListener, DesignSystemRegistryChangeType, DesignSystemScheme, DesignSystemTransitionContext, DesignSystemTransition, DesignSystemWarning, DesignSystemWarningCode, EffectiveModeSource, Motion, GlobalTokenKey, GlobalTokenMap, ComponentTokenKey, ComponentTokenMap, RecipeManifest, ResolvedComponentConfig, ResolvedDesignSystem, ResolveDesignSystemRuntimeOptions, ThemeManifest, ThemeScheme, ThemeVariant, TokenMap, } from './types';
+export { componentKeys, componentTokenDefaults, globalTokenDefaults, mlfTokenKeys, } from './contract';
+export type { MlfTokenKey } from './contract';
+export { builtinRecipes, builtinThemes, builtinDesignSystemRegistry, createBuiltinDesignSystemRegistry, createDesignSystemRegistry, defineComponentTokens, defineGlobalTokens, defineRecipe, defineTheme, } from './registry';
+export { mergeDesignSystemConfig, migrateTokens, migrateThemeTokens, resolveDesignSystem, } from './resolve';
+export type { TokenMigration, TokenMigrationConflict } from './resolve';
+export { attachDesignSystem, applyResolvedDesignSystem, createDesignSystemStylesheet, createResolvedDesignSystemSignature, DesignSystemController, getResolvedDesignSystemHostAttributes, hydrateDesignSystem, writeDesignSystemTokenDeclarations, } from './runtime';
+export type { CreateDesignSystemStylesheetOptions } from './runtime';

package/dist/types/src/design-system/recipes/contrast.d.ts

@@ -0,0 +1,2 @@
+import { RecipeManifest } from '../types';
+export declare const contrastRecipe: RecipeManifest;

package/dist/types/src/design-system/recipes/default.d.ts

@@ -0,0 +1,2 @@
+import { RecipeManifest } from '../types';
+export declare const defaultRecipe: RecipeManifest;

package/dist/types/src/design-system/recipes/index.d.ts

@@ -0,0 +1,4 @@
+export { contrastRecipe } from './contrast';
+export { defaultRecipe } from './default';
+export { minimalRecipe } from './minimal';
+export { softRecipe } from './soft';

package/dist/types/src/design-system/recipes/minimal.d.ts

@@ -0,0 +1,2 @@
+import { RecipeManifest } from '../types';
+export declare const minimalRecipe: RecipeManifest;

package/dist/types/src/design-system/recipes/soft.d.ts

@@ -0,0 +1,2 @@
+import { RecipeManifest } from '../types';
+export declare const softRecipe: RecipeManifest;

package/dist/types/src/design-system/registry/builtins.d.ts

@@ -0,0 +1,5 @@
+import { RecipeManifest, ThemeManifest } from '../types';
+export declare const builtinThemes: ThemeManifest[];
+export declare const builtinRecipes: RecipeManifest[];
+export declare const createBuiltinDesignSystemRegistry: () => import('..').DesignSystemRegistry;
+export declare const builtinDesignSystemRegistry: import('..').DesignSystemRegistry;

package/dist/types/src/design-system/registry/create-registry.d.ts

@@ -0,0 +1,2 @@
+import { DesignSystemRegistry } from '../types';
+export declare const createDesignSystemRegistry: () => DesignSystemRegistry;

package/dist/types/src/design-system/registry/deep-freeze.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Recursively freezes an object and all nested plain objects/arrays.
+ * Returns the same reference typed as readonly.
+ */
+export declare const deepFreeze: <T>(value: T) => T;

package/dist/types/src/design-system/registry/define-recipe.d.ts

@@ -0,0 +1,2 @@
+import { RecipeManifest } from '../types';
+export declare const defineRecipe: (recipe: RecipeManifest) => RecipeManifest;

package/dist/types/src/design-system/registry/define-theme.d.ts

@@ -0,0 +1,2 @@
+import { ThemeManifest } from '../types';
+export declare const defineTheme: (theme: ThemeManifest) => ThemeManifest;

package/dist/types/src/design-system/registry/define-token-maps.d.ts

@@ -0,0 +1,6 @@
+import { ComponentKey } from '../contract';
+import { ComponentTokenMap, GlobalTokenMap } from '../types';
+export declare const defineGlobalTokens: <const T extends GlobalTokenMap>(tokens: T) => T;
+export declare const defineComponentTokens: <K extends ComponentKey, const T extends ComponentTokenMap<K>>(component: K, tokens: T) => {
+    tokens: T;
+};

package/dist/types/src/design-system/registry/index.d.ts

@@ -0,0 +1,5 @@
+export { builtinDesignSystemRegistry, builtinRecipes, builtinThemes, createBuiltinDesignSystemRegistry, } from './builtins';
+export { createDesignSystemRegistry } from './create-registry';
+export { defineRecipe } from './define-recipe';
+export { defineComponentTokens, defineGlobalTokens } from './define-token-maps';
+export { defineTheme } from './define-theme';

package/dist/types/src/design-system/resolve/diagnostics.d.ts

@@ -0,0 +1,9 @@
+import { DesignSystemConfig, DesignSystemScheme, DesignSystemRegistry, DesignSystemWarning, RecipeManifest, ThemeManifest } from '../types';
+export declare const collectDesignSystemWarnings: (config: DesignSystemConfig, registry: DesignSystemRegistry, theme: ThemeManifest, recipe: RecipeManifest) => DesignSystemWarning[];
+export declare const collectThemeVariantWarnings: (config: DesignSystemConfig, theme: ThemeManifest, effectiveScheme: DesignSystemScheme) => DesignSystemWarning[];
+/**
+ * Post-resolution check: validates that `var(--mlf-*)` references in resolved
+ * token values point to tokens that actually exist in the resolved set.
+ */
+export declare const collectBrokenReferenceWarnings: (resolvedTokens: Record<string, string>) => DesignSystemWarning[];
+export declare const assertDesignSystemWarnings: (config: DesignSystemConfig, warnings: DesignSystemWarning[]) => void;

package/dist/types/src/design-system/resolve/index.d.ts

@@ -0,0 +1,5 @@
+import { DesignSystemConfig, DesignSystemRegistry, ResolveDesignSystemRuntimeOptions, ResolvedDesignSystem } from '../types';
+export declare const resolveDesignSystem: (config?: DesignSystemConfig, registry?: DesignSystemRegistry, runtimeOptions?: ResolveDesignSystemRuntimeOptions) => ResolvedDesignSystem;
+export { mergeDesignSystemConfig } from './merge-config';
+export { migrateTokens, migrateThemeTokens } from './migrate-tokens';
+export type { TokenMigration, TokenMigrationConflict } from './migrate-tokens';

package/dist/types/src/design-system/resolve/merge-config.d.ts

@@ -0,0 +1,2 @@
+import { DesignSystemConfig } from '../types';
+export declare const mergeDesignSystemConfig: (...configs: Array<DesignSystemConfig | undefined>) => DesignSystemConfig;

package/dist/types/src/design-system/resolve/migrate-tokens.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A single token rename: `from` → `to`. When applied, any occurrence of
+ * `from` in a token map is rewritten to `to`, preserving the value.
+ */
+export interface TokenMigration {
+    from: string;
+    to: string;
+}
+/**
+ * Strategy when both `from` (renamed to `to`) and `to` already exist:
+ *
+ * - `"source-wins"` — the migrated (renamed) value overwrites the existing `to` value.
+ *   Use when the old key's value is the authoritative one.
+ * - `"target-wins"` — the existing `to` value is kept; the migrated value is dropped.
+ *   Use when the new key's value should take precedence.
+ * - A custom function receives both values and returns the winner.
+ */
+export type TokenMigrationConflict = "source-wins" | "target-wins" | ((sourceValue: string, targetValue: string, key: string) => string);
+/**
+ * Apply a list of token migrations to a token map. Renames keys in-place
+ * (by returning a new map).
+ *
+ * @param tokens    - The token map to migrate.
+ * @param migrations - List of `{ from, to }` renames.
+ * @param onConflict - Strategy when both `from` and `to` exist. Defaults to `"source-wins"`.
+ *
+ * ```ts
+ * const v2Migrations: TokenMigration[] = [
+ *   { from: "--mlf-color-primary", to: "--mlf-color-accent" },
+ * ];
+ * const upgraded = migrateTokens(legacyTokens, v2Migrations, "target-wins");
+ * ```
+ */
+export declare const migrateTokens: (tokens: Record<string, string>, migrations: TokenMigration[], onConflict?: TokenMigrationConflict) => Record<string, string>;
+/**
+ * Apply token migrations to all token maps inside a theme manifest.
+ * Returns a new plain object (not frozen — pass through `defineTheme` to freeze).
+ */
+export declare const migrateThemeTokens: <T extends {
+    schemes: Record<string, {
+        tokens: Record<string, string>;
+    } | undefined>;
+    sharedTokens?: Record<string, string>;
+}>(theme: T, migrations: TokenMigration[]) => T;

package/dist/types/src/design-system/resolve/resolve-mode.d.ts

@@ -0,0 +1,6 @@
+import { DesignSystemConfig, EffectiveModeSource, ResolveDesignSystemRuntimeOptions, ThemeManifest } from '../types';
+export declare const resolveMode: (config: DesignSystemConfig, theme: ThemeManifest, options?: ResolveDesignSystemRuntimeOptions) => {
+    requestedMode: NonNullable<DesignSystemConfig["mode"]>;
+    effectiveScheme: "light" | "dark";
+    effectiveModeSource: EffectiveModeSource;
+};

package/dist/types/src/design-system/resolve/resolve-recipe.d.ts

@@ -0,0 +1,2 @@
+import { DesignSystemConfig, DesignSystemRegistry, RecipeManifest } from '../types';
+export declare const resolveRecipe: (config: DesignSystemConfig, registry: DesignSystemRegistry) => RecipeManifest;

package/dist/types/src/design-system/resolve/resolve-theme.d.ts

@@ -0,0 +1,2 @@
+import { DesignSystemConfig, DesignSystemRegistry, ThemeManifest } from '../types';
+export declare const resolveTheme: (config: DesignSystemConfig, registry: DesignSystemRegistry) => ThemeManifest;

package/dist/types/src/design-system/resolve/resolve-tokens.d.ts

@@ -0,0 +1,2 @@
+import { DesignSystemConfig, DesignSystemWarning, RecipeManifest, ResolveDesignSystemRuntimeOptions, ResolvedDesignSystem, ThemeManifest } from '../types';
+export declare const resolveTokens: (config: DesignSystemConfig, theme: ThemeManifest, recipe: RecipeManifest, effectiveScheme: "light" | "dark", requestedMode: ResolvedDesignSystem["requestedMode"], effectiveModeSource: ResolvedDesignSystem["effectiveModeSource"], warnings: DesignSystemWarning[], runtimeOptions?: ResolveDesignSystemRuntimeOptions) => ResolvedDesignSystem;

package/dist/types/src/design-system/runtime/apply-tokens.d.ts

@@ -0,0 +1,4 @@
+import { DesignSystemTransition, ResolvedDesignSystem } from '../types';
+export declare const managedDesignSystemAttributes: readonly ["data-mlf-theme-id", "data-mlf-variant-id", "data-mlf-recipe-id", "data-mlf-effective-scheme", "data-mlf-scheme", "data-mlf-density", "data-mlf-motion", "data-mlf-signature"];
+export declare const applyResolvedDesignSystem: (host: HTMLElement, resolved: ResolvedDesignSystem, transition?: DesignSystemTransition) => Set<string>;
+export declare const restoreManagedDesignSystem: (host: HTMLElement, tokens: Iterable<string>, originalAttributes: ReadonlyMap<string, string | null>, originalTokenValues: ReadonlyMap<string, string | null>, originalColorScheme: string | null) => void;

package/dist/types/src/design-system/runtime/attach-design-system.d.ts

@@ -0,0 +1,11 @@
+import { AttachDesignSystemOptions, AttachedDesignSystem } from '../types';
+/**
+ * Attach a design system to a host element.
+ *
+ * **DOM required.** This function accesses `HTMLElement`, `MutationObserver`,
+ * and `window.matchMedia` and must run in a browser environment. It is not
+ * suitable for SSR / Node.js contexts. Use `resolveDesignSystem` directly for
+ * server-side token resolution without DOM side effects.
+ */
+export declare const createAttachedDesignSystem: (host: HTMLElement, options?: AttachDesignSystemOptions, hydrate?: boolean) => AttachedDesignSystem;
+export declare const attachDesignSystem: (host: HTMLElement, options?: AttachDesignSystemOptions) => AttachedDesignSystem;

package/dist/types/src/design-system/runtime/create-stylesheet.d.ts

@@ -0,0 +1,11 @@
+import { ResolvedDesignSystem } from '../types';
+export interface CreateDesignSystemStylesheetOptions {
+    /** CSS selector for the rule block. Defaults to `":host"`. */
+    selector?: string;
+    /**
+     * When set, wraps the output in a `@layer <name> { ... }` block for
+     * cascade layer control.
+     */
+    layer?: string;
+}
+export declare const createDesignSystemStylesheet: (resolved: ResolvedDesignSystem, selectorOrOptions?: string | CreateDesignSystemStylesheetOptions) => string;

package/dist/types/src/design-system/runtime/declarations.d.ts

@@ -0,0 +1,5 @@
+import { ResolvedDesignSystem } from '../types';
+export type StyleDeclarationTarget = Pick<CSSStyleDeclaration, "setProperty">;
+export declare const validateDesignSystemSelector: (selector: string) => void;
+export declare const getDesignSystemTokenEntries: (resolved: ResolvedDesignSystem) => Array<[string, string]>;
+export declare const writeDesignSystemTokenDeclarations: (target: StyleDeclarationTarget, resolved: ResolvedDesignSystem) => Set<string>;

package/dist/types/src/design-system/runtime/design-system-controller.d.ts

@@ -0,0 +1,9 @@
+import { DesignSystemControllerOptions, ResolvedDesignSystem } from '../types';
+export declare class DesignSystemController {
+    #private;
+    constructor({ host, registry, getConfig, onChange, transition, hydrate, }: DesignSystemControllerOptions);
+    get resolved(): ResolvedDesignSystem | null;
+    connect(): void;
+    disconnect(): void;
+    refresh(): void;
+}

package/dist/types/src/design-system/runtime/host-state.d.ts

@@ -0,0 +1,3 @@
+import { ResolvedDesignSystem } from '../types';
+export declare const createResolvedDesignSystemSignature: (resolved: ResolvedDesignSystem) => string;
+export declare const getResolvedDesignSystemHostAttributes: (resolved: ResolvedDesignSystem) => Record<string, string>;

package/dist/types/src/design-system/runtime/hydrate-design-system.d.ts

@@ -0,0 +1,25 @@
+import { AttachDesignSystemOptions, AttachedDesignSystem } from '../types';
+/**
+ * Hydrate a server-rendered design system onto a host element.
+ *
+ * Call this on the client after the server has rendered a `<style>` block
+ * (via `createDesignSystemStylesheet`) and set `data-mlf-*` attributes on
+ * the host. The controller attaches, reads the current DOM state, and takes
+ * over reactivity (media queries, inherited scheme, config updates) without
+ * a visible flash — the SSR tokens are already applied.
+ *
+ * Usage:
+ * ```ts
+ * // Server: resolve + render stylesheet into <head> or shadow root
+ * const resolved = resolveDesignSystem(config, registry, { systemScheme: "light" });
+ * const css = createDesignSystemStylesheet(resolved, { selector: "#form-host" });
+ * const attrs = getResolvedDesignSystemHostAttributes(resolved);
+ *
+ * // Client: hydrate — controller picks up where SSR left off
+ * const ds = hydrateDesignSystem(document.getElementById("form-host")!, {
+ *   config,
+ *   registry,
+ * });
+ * ```
+ */
+export declare const hydrateDesignSystem: (host: HTMLElement, options?: AttachDesignSystemOptions) => AttachedDesignSystem;

package/dist/types/src/design-system/runtime/index.d.ts

@@ -0,0 +1,8 @@
+export { attachDesignSystem } from './attach-design-system';
+export { applyResolvedDesignSystem } from './apply-tokens';
+export { createDesignSystemStylesheet } from './create-stylesheet';
+export type { CreateDesignSystemStylesheetOptions } from './create-stylesheet';
+export { writeDesignSystemTokenDeclarations } from './declarations';
+export { DesignSystemController } from './design-system-controller';
+export { hydrateDesignSystem } from './hydrate-design-system';
+export { createResolvedDesignSystemSignature, getResolvedDesignSystemHostAttributes, } from './host-state';

package/dist/types/src/design-system/themes/cobalt.d.ts

@@ -0,0 +1,2 @@
+import { ThemeManifest } from '../types';
+export declare const cobaltTheme: ThemeManifest;

package/dist/types/src/design-system/themes/graphite.d.ts

@@ -0,0 +1,2 @@
+import { ThemeManifest } from '../types';
+export declare const graphiteTheme: ThemeManifest;

package/dist/types/src/design-system/themes/index.d.ts

@@ -0,0 +1,5 @@
+export { cobaltTheme } from './cobalt';
+export { graphiteTheme } from './graphite';
+export { neutralTheme } from './neutral';
+export { sageTheme } from './sage';
+export { sunsetTheme } from './sunset';

package/dist/types/src/design-system/themes/neutral.d.ts

@@ -0,0 +1,2 @@
+import { ThemeManifest } from '../types';
+export declare const neutralTheme: ThemeManifest;

package/dist/types/src/design-system/themes/sage.d.ts

@@ -0,0 +1,2 @@
+import { ThemeManifest } from '../types';
+export declare const sageTheme: ThemeManifest;

package/dist/types/src/design-system/themes/sunset.d.ts

@@ -0,0 +1,2 @@
+import { ThemeManifest } from '../types';
+export declare const sunsetTheme: ThemeManifest;

package/dist/types/src/design-system/tokens/base.d.ts

@@ -0,0 +1,5 @@
+import { componentKeys } from '../contract';
+export declare const flattenComponentTokens: (components: Partial<Record<(typeof componentKeys)[number], {
+    tokens?: Record<string, string>;
+}>>) => Record<string, string>;
+export declare const baseTokenBundle: Record<string, string>;

package/dist/types/src/design-system/tokens/contrast.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Token overrides applied when `prefers-contrast: more` is active and
+ * the consumer has not explicitly set contrast-sensitive tokens.
+ *
+ * These increase border widths, strengthen border colors, and remove
+ * semi-transparent backgrounds that reduce legibility under high contrast.
+ */
+export declare const contrastTokenOverrides: Record<string, string>;

package/dist/types/src/design-system/tokens/density.d.ts

@@ -0,0 +1,9 @@
+import { Density } from '../types';
+/**
+ * Density token overrides for each density level. All three levels are
+ * explicit so readers can compare values without cross-referencing
+ * `globalTokenDefaults`. The `comfortable` values intentionally mirror
+ * the baseline in `globalTokenDefaults` — they are authoritative here,
+ * and `globalTokenDefaults` inherits the same values.
+ */
+export declare const densityTokenScales: Record<Density, Record<string, string>>;

package/dist/types/src/design-system/tokens/forced-colors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Token overrides applied when `forced-colors: active` is detected (e.g.
+ * Windows High Contrast Mode). Maps semantic tokens to CSS system colors
+ * so the browser's forced-color palette is respected.
+ *
+ * Component tokens that normally use gradients are flattened to solid
+ * system colors — gradients cannot render system colors reliably in all
+ * forced-colors implementations.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/system-color
+ */
+export declare const forcedColorsTokenOverrides: Record<string, string>;

package/dist/types/src/design-system/tokens/index.d.ts

@@ -0,0 +1,5 @@
+export { baseTokenBundle, flattenComponentTokens } from './base';
+export { contrastTokenOverrides } from './contrast';
+export { densityTokenScales } from './density';
+export { forcedColorsTokenOverrides } from './forced-colors';
+export { motionTokenScales } from './motion';

package/dist/types/src/design-system/tokens/motion.d.ts

@@ -0,0 +1,2 @@
+import { Motion } from '../types';
+export declare const motionTokenScales: Record<Motion, Record<string, string>>;