@wow-two-beta/ui 0.0.64 → 0.0.66

package/dist/display/index.js

@@ -1,4 +1,4 @@
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, ActivityFeed, ActivityItem, AnimatedNumber, AnnotationMarker, AudioPlayer, AudioWaveform, Avatar, AvatarGroup, Badge, BadgeOverlay, Card, Carousel, CarouselDot, CarouselDots, CarouselNext, CarouselPrev, CarouselSlide, CarouselSlides, CarouselViewport, ChatBubble, Code, Collapsible, CollapsibleContent, CollapsibleTrigger, Comment, CommentThread, Confetti, CountBadge, CountUp, DataGrid, DataTable, DaySeparator, DescriptionList, DiffViewer, EmptyState, EventCalendar, Eyebrow, FeatureCard, Gantt, GradientText, Heading, HeatmapCalendar, Highlight, Image, InfoRow, KeyboardShortcut, List, ListItem, Mark, Marquee, MessageList, MetaInline, MetricChip, NodeEditor, NotificationDot, PDFViewer, PricingCard, Quote, ReactionBar, ScheduleView, ScrollReveal, SectionHeader, Separator, Snippet, Sortable, Sparkline, Stat, Status, StepCard, SwipeActions, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeaderCell, TableRow, Tabs, TabsList, TabsPanel, TabsTab, Text, ThreadView, Tilt, Timeline, TimelineDescription, TimelineItem, TimelineTitle, Tree, TreeGroup, TreeItem, Typewriter, VideoPlayer, avatarVariants, badgeVariants, codeVariants, headingVariants, textVariants } from '../chunk-RDRFXVNX.js';
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, ActivityFeed, ActivityItem, AnimatedNumber, AnnotationMarker, AudioPlayer, AudioWaveform, Avatar, AvatarGroup, Badge, BadgeOverlay, Card, Carousel, CarouselDot, CarouselDots, CarouselNext, CarouselPrev, CarouselSlide, CarouselSlides, CarouselViewport, ChatBubble, Code, Collapsible, CollapsibleContent, CollapsibleTrigger, Comment, CommentThread, Confetti, CountBadge, CountUp, DataGrid, DataTable, DaySeparator, DescriptionList, DiffViewer, EmptyState, EventCalendar, Eyebrow, FeatureCard, Gantt, GradientText, Heading, HeatmapCalendar, Highlight, Image, InfoRow, KeyboardShortcut, List, ListItem, Mark, Marquee, MessageList, MetaInline, MetricChip, NodeEditor, NotificationDot, PDFViewer, PricingCard, Quote, ReactionBar, ScheduleView, ScrollReveal, SectionHeader, Separator, Snippet, Sortable, Sparkline, Stat, Status, StepCard, SwipeActions, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeaderCell, TableRow, Tabs, TabsList, TabsPanel, TabsTab, Text, ThreadView, Tilt, Timeline, TimelineDescription, TimelineItem, TimelineTitle, Tree, TreeGroup, TreeItem, Typewriter, VideoPlayer, avatarVariants, badgeVariants, codeVariants, headingVariants, textVariants } from '../chunk-FXYEMUV6.js';
 export { Kbd, Tag, tagVariants } from '../chunk-3SWPYYRQ.js';
 import '../chunk-4XWLEKH2.js';
 export { Tooltip } from '../chunk-YQGEF43L.js';

package/dist/forms/colorPicker/ColorPicker.d.ts

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import { type ColorSwatchVariants } from '../colorSwatch';
 export interface ColorPickerProps {
     value?: string | null;
@@ -10,5 +11,7 @@ export interface ColorPickerProps {
     name?: string;
     className?: string;
     'aria-label'?: string;
+    /** Custom trigger element; when set, replaces the default swatch + hex-value button. Must be a single focusable element (it becomes the popover trigger via `asChild`). */
+    trigger?: ReactNode;
 }
 export declare const ColorPicker: import("react").ForwardRefExoticComponent<ColorPickerProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/forms/index.js

@@ -1,11 +1,11 @@
-export { ADDRESS_COUNTRIES, AddressForm, BUILT_IN_EMOJI, BUILT_IN_FONTS, Calendar, CharacterCount, ChatComposer, Checkbox, CheckboxField, CheckboxGroup, ChoiceCard, CodeEditor, ColorArea, ColorField, ColorPicker, ColorSlider, ColorSwatch, ColorSwatchPicker, ColorWheel, Combobox, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxSeparator, CronInput, CurrencyInput, DateField, DatePicker, DateRangePicker, Editable, EditableCancel, EditableInput, EditablePreview, EditableSubmit, EmailInput, EmojiPicker, Fieldset, FilePicker, FileUpload, FontPicker, FormErrorMessage, FormField, FormHelperText, GradientPicker, IconPicker, InputAddon, InputGroup, JSONEditor, KeyboardShortcutPicker, Knob, Label, LabeledInput, Legend, Listbox, ListboxEmpty, ListboxGroup, ListboxItem, ListboxSeparator, MarkdownEditor, MaskedInput, MultiSelect, MultiSelectContent, MultiSelectItem, MultiSelectTags, MultiSelectTrigger, NumberInput, PHONE_COUNTRIES, PasswordInput, PasswordStrength, PercentInput, PhoneInput, PinInput, Radio, RadioField, RadioGroup, RangeCalendar, ReactionPicker, RecurrenceEditor, SearchInput, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Slider, Stepper, StepperList, StepperPanel, StepperStep, Switch, SwitchField, TagsInput, TelInput, TextInput, Textarea, TimeField, TimePicker, UrlInput, Wizard, WizardFooter, WizardStep, WizardSteps, colorSwatchVariants, gradientToCss, useWizard } from '../chunk-5YT7XRTW.js';
+export { ADDRESS_COUNTRIES, AddressForm, BUILT_IN_EMOJI, BUILT_IN_FONTS, Calendar, CharacterCount, ChatComposer, Checkbox, CheckboxField, CheckboxGroup, ChoiceCard, CodeEditor, ColorArea, ColorField, ColorPicker, ColorSlider, ColorSwatch, ColorSwatchPicker, ColorWheel, Combobox, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxSeparator, CronInput, CurrencyInput, DateField, DatePicker, DateRangePicker, Editable, EditableCancel, EditableInput, EditablePreview, EditableSubmit, EmailInput, EmojiPicker, Fieldset, FilePicker, FileUpload, FontPicker, FormErrorMessage, FormField, FormHelperText, GradientPicker, IconPicker, InputAddon, InputGroup, JSONEditor, KeyboardShortcutPicker, Knob, Label, LabeledInput, Legend, Listbox, ListboxEmpty, ListboxGroup, ListboxItem, ListboxSeparator, MarkdownEditor, MaskedInput, MultiSelect, MultiSelectContent, MultiSelectItem, MultiSelectTags, MultiSelectTrigger, NumberInput, PHONE_COUNTRIES, PasswordInput, PasswordStrength, PercentInput, PhoneInput, PinInput, Radio, RadioField, RadioGroup, RangeCalendar, ReactionPicker, RecurrenceEditor, SearchInput, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Slider, Stepper, StepperList, StepperPanel, StepperStep, Switch, SwitchField, TagsInput, TelInput, TextInput, Textarea, TimeField, TimePicker, UrlInput, Wizard, WizardFooter, WizardStep, WizardSteps, colorSwatchVariants, gradientToCss, useWizard } from '../chunk-ZTK5ZQIL.js';
 import '../chunk-FMTBJJP6.js';
 import '../chunk-GTBNVI77.js';
 import '../chunk-ZC4H4PIN.js';
 import '../chunk-MZZKA3ZS.js';
 import '../chunk-NOOKDXIZ.js';
-import '../chunk-3SWPYYRQ.js';
 import '../chunk-NW7ULTYL.js';
+import '../chunk-3SWPYYRQ.js';
 import '../chunk-V267IMBH.js';
 import '../chunk-MVMDDGW7.js';
 import '../chunk-DX7FYAKY.js';

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * as utils from './utils';
 export * as hooks from './hooks';
 export * as icons from './icons';
 export * as primitives from './primitives';
+export * as themes from './themes';
 export * from './actions';
 export * from './display';
 export * from './feedback';

package/dist/index.js

@@ -1,19 +1,20 @@
-export { ADDRESS_COUNTRIES, AddressForm, BUILT_IN_EMOJI, BUILT_IN_FONTS, Calendar, CharacterCount, ChatComposer, Checkbox, CheckboxField, CheckboxGroup, ChoiceCard, CodeEditor, ColorArea, ColorField, ColorPicker, ColorSlider, ColorSwatch, ColorSwatchPicker, ColorWheel, Combobox, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxSeparator, CronInput, CurrencyInput, DateField, DatePicker, DateRangePicker, Editable, EditableCancel, EditableInput, EditablePreview, EditableSubmit, EmailInput, EmojiPicker, Fieldset, FilePicker, FileUpload, FontPicker, FormErrorMessage, FormField, FormHelperText, GradientPicker, IconPicker, InputAddon, InputGroup, JSONEditor, KeyboardShortcutPicker, Knob, Label, LabeledInput, Legend, Listbox, ListboxEmpty, ListboxGroup, ListboxItem, ListboxSeparator, MarkdownEditor, MaskedInput, MultiSelect, MultiSelectContent, MultiSelectItem, MultiSelectTags, MultiSelectTrigger, NumberInput, PHONE_COUNTRIES, PasswordInput, PasswordStrength, PercentInput, PhoneInput, PinInput, Radio, RadioField, RadioGroup, RangeCalendar, ReactionPicker, RecurrenceEditor, SearchInput, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Slider, Stepper, StepperList, StepperPanel, StepperStep, Switch, SwitchField, TagsInput, TelInput, TextInput, Textarea, TimeField, TimePicker, UrlInput, Wizard, WizardFooter, WizardStep, WizardSteps, colorSwatchVariants, gradientToCss, useWizard } from './chunk-5YT7XRTW.js';
-export { AppShell, AppShellAside, AppShellContent, AppShellFooter, AppShellHeader, AppShellMain, AppShellSidebar, AspectRatio, Box, Center, Cluster, Container, Divider, Flex, Frame, Grid, HStack, Navbar, Overlay, PullToRefresh, ResizablePanel, ResizablePanels, ResizableSeparator, ScrollArea, Section, Spacer, Stack, Surface, TwoColumn, VStack, containerVariants, dividerVariants, gridVariants, navbarVariants, resolveGridColumns, resolveGridGap, sectionVariants, stackVariants, useAppShell } from './chunk-NIFL35PJ.js';
+export { Alert, AlertSimple, Banner, BannerSimple, Callout, InlineSpinner, LiveCursor, LoadingOverlay, LoadingState, MeterBar, NotificationCenter, NotificationItem, OnboardingChecklist, OnboardingChecklistTask, PresenceIndicator, ProgressBar, ProgressCircle, ProgressSteps, Skeleton, StatusIndicator, Toast, ToastSimple, Toaster, Tour, TrendIndicator, TypingIndicator, UndoBar, alertSimpleVariants, bannerSimpleVariants, progressFillVariants, progressTrackVariants, skeletonVariants, toastSimpleVariants, toaster, useOnboardingChecklist, useToaster } from './chunk-NEH4ITXL.js';
+export { ADDRESS_COUNTRIES, AddressForm, BUILT_IN_EMOJI, BUILT_IN_FONTS, Calendar, CharacterCount, ChatComposer, Checkbox, CheckboxField, CheckboxGroup, ChoiceCard, CodeEditor, ColorArea, ColorField, ColorPicker, ColorSlider, ColorSwatch, ColorSwatchPicker, ColorWheel, Combobox, ComboboxContent, ComboboxEmpty, ComboboxGroup, ComboboxInput, ComboboxItem, ComboboxSeparator, CronInput, CurrencyInput, DateField, DatePicker, DateRangePicker, Editable, EditableCancel, EditableInput, EditablePreview, EditableSubmit, EmailInput, EmojiPicker, Fieldset, FilePicker, FileUpload, FontPicker, FormErrorMessage, FormField, FormHelperText, GradientPicker, IconPicker, InputAddon, InputGroup, JSONEditor, KeyboardShortcutPicker, Knob, Label, LabeledInput, Legend, Listbox, ListboxEmpty, ListboxGroup, ListboxItem, ListboxSeparator, MarkdownEditor, MaskedInput, MultiSelect, MultiSelectContent, MultiSelectItem, MultiSelectTags, MultiSelectTrigger, NumberInput, PHONE_COUNTRIES, PasswordInput, PasswordStrength, PercentInput, PhoneInput, PinInput, Radio, RadioField, RadioGroup, RangeCalendar, ReactionPicker, RecurrenceEditor, SearchInput, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Slider, Stepper, StepperList, StepperPanel, StepperStep, Switch, SwitchField, TagsInput, TelInput, TextInput, Textarea, TimeField, TimePicker, UrlInput, Wizard, WizardFooter, WizardStep, WizardSteps, colorSwatchVariants, gradientToCss, useWizard } from './chunk-ZTK5ZQIL.js';
+export { AppShell, AppShellAside, AppShellContent, AppShellFooter, AppShellHeader, AppShellMain, AppShellSidebar, AspectRatio, Box, Center, Cluster, Container, Divider, Flex, Frame, Grid, HStack, Navbar, Overlay, PullToRefresh, ResizablePanel, ResizablePanels, ResizableSeparator, ScrollArea, Section, Spacer, Stack, Surface, TwoColumn, VStack, containerVariants, dividerVariants, gridVariants, navbarVariants, resolveGridColumns, resolveGridGap, sectionVariants, stackVariants, useAppShell } from './chunk-3BNEDKMS.js';
+export { Spinner, spinnerVariants } from './chunk-7ZDLUNAY.js';
 export { Breadcrumb, CommandPalette, CommandPaletteContent, CommandPaletteEmpty, CommandPaletteGroup, CommandPaletteInput, CommandPaletteItem, CommandPaletteList, CommandPaletteSeparator, ContextMenu, ContextMenuContent, ContextMenuTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuTrigger, Menu, MenuGroup, MenuItem, MenuLabel, MenuSeparator, Menubar, MenubarContent, MenubarMenu, MenubarTrigger, NavItem, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, Pagination, ScrollSpy, TableOfContents, menuItemVariants, menuLabelVariants, menuSeparatorVariants, menuVariants, useScrollSpy } from './chunk-H3WC7KRX.js';
 import './chunk-FMTBJJP6.js';
 export { ActionSheet, ActionSheetAction, ActionSheetCancel, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, BottomSheet, BottomSheetDescription, BottomSheetTitle, HoverCard, HoverCardArrow, HoverCardContent, HoverCardTrigger, Popover, PopoverArrow, PopoverContent, PopoverTrigger, useBottomSheet } from './chunk-GTBNVI77.js';
 export { Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from './chunk-ZC4H4PIN.js';
 export { Dialog, DialogBody, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger } from './chunk-MZZKA3ZS.js';
 import './chunk-NOOKDXIZ.js';
+export { Backdrop } from './chunk-NW7ULTYL.js';
+export { themes_exports as themes } from './chunk-LS4EGKUK.js';
 export { BackToTopButton, Button, ButtonGroup, CopyButton, DisclosureButton, FAB, Link, SegmentedControl, SpeedDial, SpeedDialAction, SpeedDialTrigger, ToggleButton, ToggleButtonGroup, Toolbar, ToolbarButton, ToolbarLink, ToolbarSeparator, buttonVariants, fabVariants, linkVariants, toggleButtonVariants } from './chunk-O4Y52ERR.js';
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, ActivityFeed, ActivityItem, AnimatedNumber, AnnotationMarker, AudioPlayer, AudioWaveform, Avatar, AvatarGroup, Badge, BadgeOverlay, Card, Carousel, CarouselDot, CarouselDots, CarouselNext, CarouselPrev, CarouselSlide, CarouselSlides, CarouselViewport, ChatBubble, Code, Collapsible, CollapsibleContent, CollapsibleTrigger, Comment, CommentThread, Confetti, CountBadge, CountUp, DataGrid, DataTable, DaySeparator, DescriptionList, DiffViewer, EmptyState, EventCalendar, Eyebrow, FeatureCard, Gantt, GradientText, Heading, HeatmapCalendar, Highlight, Image, InfoRow, KeyboardShortcut, List, ListItem, Mark, Marquee, MessageList, MetaInline, MetricChip, NodeEditor, NotificationDot, PDFViewer, PricingCard, Quote, ReactionBar, ScheduleView, ScrollReveal, SectionHeader, Separator, Snippet, Sortable, Sparkline, Stat, Status, StepCard, SwipeActions, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeaderCell, TableRow, Tabs, TabsList, TabsPanel, TabsTab, Text, ThreadView, Tilt, Timeline, TimelineDescription, TimelineItem, TimelineTitle, Tree, TreeGroup, TreeItem, Typewriter, VideoPlayer, avatarVariants, badgeVariants, codeVariants, headingVariants, textVariants } from './chunk-RDRFXVNX.js';
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, ActivityFeed, ActivityItem, AnimatedNumber, AnnotationMarker, AudioPlayer, AudioWaveform, Avatar, AvatarGroup, Badge, BadgeOverlay, Card, Carousel, CarouselDot, CarouselDots, CarouselNext, CarouselPrev, CarouselSlide, CarouselSlides, CarouselViewport, ChatBubble, Code, Collapsible, CollapsibleContent, CollapsibleTrigger, Comment, CommentThread, Confetti, CountBadge, CountUp, DataGrid, DataTable, DaySeparator, DescriptionList, DiffViewer, EmptyState, EventCalendar, Eyebrow, FeatureCard, Gantt, GradientText, Heading, HeatmapCalendar, Highlight, Image, InfoRow, KeyboardShortcut, List, ListItem, Mark, Marquee, MessageList, MetaInline, MetricChip, NodeEditor, NotificationDot, PDFViewer, PricingCard, Quote, ReactionBar, ScheduleView, ScrollReveal, SectionHeader, Separator, Snippet, Sortable, Sparkline, Stat, Status, StepCard, SwipeActions, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeaderCell, TableRow, Tabs, TabsList, TabsPanel, TabsTab, Text, ThreadView, Tilt, Timeline, TimelineDescription, TimelineItem, TimelineTitle, Tree, TreeGroup, TreeItem, Typewriter, VideoPlayer, avatarVariants, badgeVariants, codeVariants, headingVariants, textVariants } from './chunk-FXYEMUV6.js';
 export { Kbd, Tag, tagVariants } from './chunk-3SWPYYRQ.js';
 export { Inline } from './chunk-4XWLEKH2.js';
 export { Tooltip } from './chunk-YQGEF43L.js';
-export { Alert, AlertSimple, Banner, BannerSimple, Callout, InlineSpinner, LiveCursor, LoadingOverlay, LoadingState, MeterBar, NotificationCenter, NotificationItem, OnboardingChecklist, OnboardingChecklistTask, PresenceIndicator, ProgressBar, ProgressCircle, ProgressSteps, Skeleton, StatusIndicator, Toast, ToastSimple, Toaster, Tour, TrendIndicator, TypingIndicator, UndoBar, alertSimpleVariants, bannerSimpleVariants, progressFillVariants, progressTrackVariants, skeletonVariants, toastSimpleVariants, toaster, useOnboardingChecklist, useToaster } from './chunk-NEH4ITXL.js';
-export { Spinner, spinnerVariants } from './chunk-7ZDLUNAY.js';
-export { Backdrop } from './chunk-NW7ULTYL.js';
 export { hooks_exports as hooks } from './chunk-V267IMBH.js';
 export { icons_exports as icons } from './chunk-MVMDDGW7.js';
 export { utils_exports as utils } from './chunk-DX7FYAKY.js';

package/dist/layout/index.js

@@ -1,9 +1,9 @@
-export { AppShell, AppShellAside, AppShellContent, AppShellFooter, AppShellHeader, AppShellMain, AppShellSidebar, AspectRatio, Box, Center, Cluster, Container, Divider, Flex, Frame, Grid, HStack, Navbar, Overlay, PullToRefresh, ResizablePanel, ResizablePanels, ResizableSeparator, ScrollArea, Section, Spacer, Stack, Surface, TwoColumn, VStack, containerVariants, dividerVariants, gridVariants, navbarVariants, resolveGridColumns, resolveGridGap, sectionVariants, stackVariants, useAppShell } from '../chunk-NIFL35PJ.js';
+export { AppShell, AppShellAside, AppShellContent, AppShellFooter, AppShellHeader, AppShellMain, AppShellSidebar, AspectRatio, Box, Center, Cluster, Container, Divider, Flex, Frame, Grid, HStack, Navbar, Overlay, PullToRefresh, ResizablePanel, ResizablePanels, ResizableSeparator, ScrollArea, Section, Spacer, Stack, Surface, TwoColumn, VStack, containerVariants, dividerVariants, gridVariants, navbarVariants, resolveGridColumns, resolveGridGap, sectionVariants, stackVariants, useAppShell } from '../chunk-3BNEDKMS.js';
+import '../chunk-7ZDLUNAY.js';
 import '../chunk-ZC4H4PIN.js';
 import '../chunk-NOOKDXIZ.js';
-export { Inline } from '../chunk-4XWLEKH2.js';
-import '../chunk-7ZDLUNAY.js';
 import '../chunk-NW7ULTYL.js';
+export { Inline } from '../chunk-4XWLEKH2.js';
 import '../chunk-V267IMBH.js';
 import '../chunk-DX7FYAKY.js';
 import '../chunk-XLYJF3HC.js';

package/dist/themes/Oklch.d.ts

@@ -0,0 +1,42 @@
+/** Cylindrical OKLab color: L ∈ [0,1], C ≥ 0, H ∈ [0,360). */
+export interface Oklch {
+    l: number;
+    c: number;
+    h: number;
+}
+/** Wrap a hue into [0,360). */
+export declare function normalizeHue(h: number): number;
+/** True when the OKLCH color maps inside the sRGB gamut (no channel clipping). */
+export declare function isInSrgbGamut(color: Oklch): boolean;
+/**
+ * Reduce chroma (keeping L and H) until the color fits the sRGB gamut.
+ * Binary search on chroma — cheap, deterministic, good enough for tokens.
+ */
+export declare function clampChromaToGamut(color: Oklch): Oklch;
+/** Convert OKLCH → `#rrggbb`. Chroma is gamut-clamped first so output is always valid sRGB. */
+export declare function oklchToHex(color: Oklch): string;
+/**
+ * Format OKLCH as a CSS `oklch(L% C H)` string.
+ * Rounded for compact, stable output (L→0.1%, C→4dp, H→0.1°).
+ */
+export declare function oklchToCss(color: Oklch): string;
+/** WCAG relative luminance for an OKLCH color (via its in-gamut sRGB mapping). */
+export declare function relativeLuminance(color: Oklch): number;
+/** WCAG 2.1 contrast ratio (1–21) between two OKLCH colors. Symmetric. */
+export declare function contrastRatio(a: Oklch, b: Oklch): number;
+/** WCAG 2.1 contrast ratio between two CSS color strings. Supports `oklch(...)` and hex. */
+export declare function contrastRatioCss(a: string, b: string): number;
+/** Parse a token color string (`oklch(L% C H)` or hex) back into OKLCH. Returns null if unparseable. */
+export declare function parseColor(value: string): Oklch | null;
+/** Grouped namespace export (mirrors `ColorExtensions` style elsewhere in the lib). */
+export declare const Oklch: {
+    readonly normalizeHue: typeof normalizeHue;
+    readonly isInSrgbGamut: typeof isInSrgbGamut;
+    readonly clampChromaToGamut: typeof clampChromaToGamut;
+    readonly oklchToHex: typeof oklchToHex;
+    readonly oklchToCss: typeof oklchToCss;
+    readonly parseColor: typeof parseColor;
+    readonly relativeLuminance: typeof relativeLuminance;
+    readonly contrastRatio: typeof contrastRatio;
+    readonly contrastRatioCss: typeof contrastRatioCss;
+};

package/dist/themes/Theme.d.ts

@@ -0,0 +1,76 @@
+import type { TokenSet } from './Tokens';
+/**
+ * Theme lifecycle status.
+ *
+ * - `validated` — hand-authored from real, visually-verified app tokens; the
+ *   colors are locked (never auto-nudged), proven in a shipping product.
+ * - `candidate` — generated/curated and AA-proven by the engine, but not yet
+ *   validated against a real app surface.
+ */
+export declare const ThemeStatus: {
+    readonly Validated: "validated";
+    readonly Candidate: "candidate";
+};
+/** A theme's lifecycle status value (`"validated"` | `"candidate"`). */
+export type ThemeStatus = (typeof ThemeStatus)[keyof typeof ThemeStatus];
+/** Contrast / "is this theme proven" metadata, produced by the validator. */
+export interface ThemeMeta {
+    /** True iff every foreground↔surface pair clears its WCAG AA threshold in BOTH modes. */
+    contrastAA: boolean;
+    /**
+     * Human-readable pair failures (empty when `contrastAA` is true).
+     * Each entry: `"<mode>: <fg> on <bg> = <ratio> (need <threshold>)"`.
+     */
+    failures?: string[];
+}
+/** A named, validated theme — the unit the registry stores and the emitter renders. */
+export interface Theme {
+    /** Stable kebab-case id; drives the `.theme-{id}` class. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** One-line description. */
+    description: string;
+    /** Free-form tags for filtering/search (e.g. `["dark","cool","brand"]`). */
+    tags: string[];
+    /** Light-mode token values. */
+    light: TokenSet;
+    /** Dark-mode token values. */
+    dark: TokenSet;
+    /** Border-radius scale knob (maps to the lib's `--radius-*`). Optional. */
+    radius?: 'sm' | 'md' | 'lg';
+    /** Lifecycle status — `validated` (real-app proven, locked) or `candidate` (engine-proven). */
+    status: ThemeStatus;
+    /** Validation result — `meta.contrastAA === true` ⇒ the theme is "proven". */
+    meta: ThemeMeta;
+}
+/** Neutral surface temperature — biases the grey ramp warm/cool/neutral. */
+export type NeutralTemp = 'cool' | 'neutral' | 'warm';
+/** How the accent hue is derived from the primary hue. */
+export type AccentMode = 'complementary' | 'analogous' | 'triadic' | 'mono';
+/** Surface character — `soft` = gentle low-contrast surfaces, `crisp` = punchier separation. */
+export type SurfaceStyle = 'soft' | 'crisp';
+/**
+ * The recipe a theme is generated from. Pure inputs → deterministic `Theme`
+ * (no randomness; identical seeds always yield identical themes).
+ */
+export interface ThemeSeed {
+    /** Stable kebab-case id for the produced theme. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** One-line description (optional — a sensible default is derived from the seed). */
+    description?: string;
+    /** Tags to attach (generator also auto-tags temp/mode/scheme). */
+    tags?: string[];
+    /** Primary brand hue in degrees, 0–360. */
+    primaryHue: number;
+    /** Neutral ramp temperature. Default `neutral`. */
+    neutralTemp?: NeutralTemp;
+    /** Accent derivation. Default `complementary`. */
+    accentMode?: AccentMode;
+    /** Surface character. Default `crisp`. */
+    surface?: SurfaceStyle;
+    /** Radius knob to carry through. Optional. */
+    radius?: 'sm' | 'md' | 'lg';
+}

package/dist/themes/Tokens.d.ts

@@ -0,0 +1,40 @@
+/** The six tone families that each carry base / -foreground / -soft / -soft-foreground. */
+export declare const TONE_FAMILIES: readonly ["primary", "accent", "destructive", "info", "success", "warning"];
+export type ToneFamilyName = (typeof TONE_FAMILIES)[number];
+/** Surface + chrome tokens (everything that isn't one of the tone families). */
+export declare const SURFACE_TOKENS: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "muted", "muted-foreground", "subtle-foreground", "inverse", "inverse-foreground", "border", "border-strong", "input", "ring"];
+/** The four slot suffixes every tone family expands into. */
+type ToneSlotSuffix = '' | '-foreground' | '-soft' | '-soft-foreground';
+/** A single tone family expanded to its four token keys, e.g. `primary | primary-foreground | …`. */
+type ToneFamilyTokens<F extends string> = F extends string ? `${F}${ToneSlotSuffix}` : never;
+/**
+ * Every semantic token key (the part after `--color-`).
+ *
+ * = surface/chrome tokens ∪ (each tone family × {base,-foreground,-soft,-soft-foreground}).
+ * 15 surface + 6×4 tone = 39 keys total.
+ */
+export type SemanticToken = (typeof SURFACE_TOKENS)[number] | ToneFamilyTokens<ToneFamilyName>;
+/** A complete set of color values — one CSS color string per semantic token. */
+export type TokenSet = Record<SemanticToken, string>;
+/** Optional radius scale a theme may carry (maps to `--radius-{md,lg,xl}`). */
+export interface RadiusScale {
+    md: string;
+    lg: string;
+    xl: string;
+}
+/** The four slots of one tone family. */
+export interface ToneSlots {
+    base: string;
+    foreground: string;
+    soft: string;
+    softForeground: string;
+}
+/**
+ * The full, ordered list of every semantic token key — derived from the same
+ * constants the type is built from, so it can never drift from `SemanticToken`.
+ * Used by the validator/emitter to iterate exhaustively.
+ */
+export declare const SEMANTIC_TOKENS: readonly SemanticToken[];
+/** Write a tone family's four slots into a partial token set under the family's keys. */
+export declare function applyToneSlots(target: Partial<TokenSet>, family: ToneFamilyName, slots: ToneSlots): void;
+export {};

package/dist/themes/css.d.ts

@@ -0,0 +1,20 @@
+import type { Theme, ThemeStatus } from './Theme';
+/**
+ * Emit the CSS for a single theme: a light `.theme-{id}` block + a
+ * `.dark.theme-{id}` block. Returns a string (no trailing newline).
+ */
+export declare function themeToCss(theme: Theme): string;
+/** Emit a full stylesheet for many themes, with a generated-file banner. */
+export declare function emitAllThemesCss(themes: Theme[]): string;
+/** Machine-readable manifest entry for one theme (no token payload — index only). */
+export interface ThemeManifestEntry {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    /** Lifecycle status — `validated` (real-app proven) or `candidate` (engine-proven). */
+    status: ThemeStatus;
+    contrastAA: boolean;
+}
+/** Build the `themes.json` manifest payload from the registry. */
+export declare function emitThemesManifest(themes: Theme[]): ThemeManifestEntry[];

package/dist/themes/generate.d.ts

@@ -0,0 +1,6 @@
+import type { Theme, ThemeSeed } from './Theme';
+/**
+ * Expand a {@link ThemeSeed} into a validated {@link Theme}.
+ * Deterministic: same seed in → identical theme out.
+ */
+export declare function generateTheme(seed: ThemeSeed): Theme;

package/dist/themes/index.d.ts

@@ -0,0 +1,11 @@
+export { Oklch } from './Oklch';
+export type { Oklch as OklchColor } from './Oklch';
+export { normalizeHue, isInSrgbGamut, clampChromaToGamut, oklchToHex, oklchToCss, parseColor, relativeLuminance, contrastRatio, contrastRatioCss, } from './Oklch';
+export type { SemanticToken, TokenSet, RadiusScale, ToneFamilyName, ToneSlots, } from './Tokens';
+export { SEMANTIC_TOKENS, SURFACE_TOKENS, TONE_FAMILIES, applyToneSlots, } from './Tokens';
+export type { Theme, ThemeMeta, ThemeSeed, NeutralTemp, AccentMode, SurfaceStyle, } from './Theme';
+export { ThemeStatus } from './Theme';
+export { generateTheme } from './generate';
+export { validateTheme, contrastPairs, AA_TEXT, AA_UI } from './validate';
+export { themeToCss, emitAllThemesCss, emitThemesManifest, type ThemeManifestEntry, } from './css';
+export { THEMES, THEME_SEEDS, THEME_IDS, getTheme, validatedThemes, candidateThemes, } from './registry';

package/dist/themes/index.js

@@ -0,0 +1,4 @@
+export { AA_TEXT, AA_UI, Oklch, SEMANTIC_TOKENS, SURFACE_TOKENS, THEMES, THEME_IDS, THEME_SEEDS, TONE_FAMILIES, ThemeStatus, applyToneSlots, candidateThemes, clampChromaToGamut, contrastPairs, contrastRatio, contrastRatioCss, emitAllThemesCss, emitThemesManifest, generateTheme, getTheme, isInSrgbGamut, normalizeHue, oklchToCss, oklchToHex, parseColor, relativeLuminance, themeToCss, validateTheme, validatedThemes } from '../chunk-LS4EGKUK.js';
+import '../chunk-DCHYNTHI.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/themes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/themes/pool.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeSeed } from './Theme';
+/** The full candidate pool seeds (named editor/brand palettes + hue sweep). */
+export declare const POOL_SEEDS: ThemeSeed[];

package/dist/themes/registry.d.ts

@@ -0,0 +1,16 @@
+import type { Theme, ThemeSeed } from './Theme';
+/** The authoring seeds. Order here = order in `THEMES` and the emitted stylesheet. */
+export declare const THEME_SEEDS: ThemeSeed[];
+/**
+ * The full registry: validated (real-app-proven) themes FIRST, then the curated
+ * candidate presets. Order here = order in the emitted stylesheet / manifest.
+ */
+export declare const THEMES: Theme[];
+/** Look up a theme by id. Returns `undefined` when absent. */
+export declare function getTheme(id: string): Theme | undefined;
+/** Themes proven against a real app surface (`status === "validated"`). */
+export declare function validatedThemes(): Theme[];
+/** Engine-proven curated presets not yet app-validated (`status === "candidate"`). */
+export declare function candidateThemes(): Theme[];
+/** Ids of all curated themes, in registry order. */
+export declare const THEME_IDS: string[];

package/dist/themes/validate.d.ts

@@ -0,0 +1,25 @@
+import type { Theme, ThemeMeta } from './Theme';
+import { type SemanticToken } from './Tokens';
+/** WCAG AA thresholds. Text = normal-size body text; UI = non-text affordances. */
+export declare const AA_TEXT = 4.5;
+export declare const AA_UI = 3;
+/** One foreground↔background pair to verify, with its required ratio. */
+interface ContrastPair {
+    /** Foreground token (text/icon/affordance color). */
+    fg: SemanticToken;
+    /** Background token the fg sits on. */
+    bg: SemanticToken;
+    /** Required minimum ratio (AA_TEXT or AA_UI). */
+    min: number;
+}
+/**
+ * The canonical set of pairs every theme must satisfy.
+ * Surface text pairs + each tone family's solid/soft foreground pairs + ring.
+ */
+export declare function contrastPairs(): ContrastPair[];
+/**
+ * Validate a theme's light AND dark token sets.
+ * `contrastAA` is true only when both modes pass every pair.
+ */
+export declare function validateTheme(theme: Pick<Theme, 'light' | 'dark'>): ThemeMeta;
+export {};

package/dist/themes/validated.d.ts

@@ -0,0 +1,3 @@
+import type { Theme } from './Theme';
+/** Validated themes, merged FIRST into the curated `THEMES` array. */
+export declare const VALIDATED_THEMES: Theme[];