@nocoo/basalt 2.1.8 → 3.0.0

package/dist/providers/accent.js.map

@@ -1 +1 @@
-{"version":3,"file":"accent.js","names":[],"sources":["../../src/providers/accent.tsx"],"sourcesContent":["import {\n\tcreateContext,\n\ttype ReactNode,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseState,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { createPreferenceStore } from \"../utils/preference-store\";\n\nexport type AccentSwatch = {\n\tid: string;\n\tlabel: string;\n\ttoken: string;\n\tlight: string;\n\tdark: string;\n};\n\n/** Twelve candy accents inspired by the translucent iMac and iPhone 5C finishes. */\nexport const ACCENT_SWATCHES: readonly AccentSwatch[] = [\n\t{\n\t\tid: \"primary\",\n\t\tlabel: \"Blue\",\n\t\ttoken: \"--basalt-accent-1\",\n\t\tlight: \"204 88% 62%\",\n\t\tdark: \"204 90% 70%\",\n\t},\n\t{\n\t\tid: \"sky\",\n\t\tlabel: \"Ice\",\n\t\ttoken: \"--basalt-accent-2\",\n\t\tlight: \"191 79% 70%\",\n\t\tdark: \"191 79% 74%\",\n\t},\n\t{\n\t\tid: \"teal\",\n\t\tlabel: \"Bondi\",\n\t\ttoken: \"--basalt-accent-3\",\n\t\tlight: \"182 62% 47%\",\n\t\tdark: \"182 62% 63%\",\n\t},\n\t{\n\t\tid: \"green\",\n\t\tlabel: \"Green\",\n\t\ttoken: \"--basalt-accent-4\",\n\t\tlight: \"113 58% 62%\",\n\t\tdark: \"113 58% 70%\",\n\t},\n\t{\n\t\tid: \"lime\",\n\t\tlabel: \"Lime\",\n\t\ttoken: \"--basalt-accent-5\",\n\t\tlight: \"79 70% 64%\",\n\t\tdark: \"79 70% 70%\",\n\t},\n\t{\n\t\tid: \"amber\",\n\t\tlabel: \"Yellow\",\n\t\ttoken: \"--basalt-accent-6\",\n\t\tlight: \"49 100% 69%\",\n\t\tdark: \"49 100% 73%\",\n\t},\n\t{\n\t\tid: \"orange\",\n\t\tlabel: \"Tangerine\",\n\t\ttoken: \"--basalt-accent-7\",\n\t\tlight: \"27 95% 65%\",\n\t\tdark: \"27 95% 72%\",\n\t},\n\t{\n\t\tid: \"red\",\n\t\tlabel: \"Strawberry\",\n\t\ttoken: \"--basalt-accent-8\",\n\t\tlight: \"5 85% 66%\",\n\t\tdark: \"5 85% 73%\",\n\t},\n\t{\n\t\tid: \"rose\",\n\t\tlabel: \"Pink\",\n\t\ttoken: \"--basalt-accent-9\",\n\t\tlight: \"345 88% 72%\",\n\t\tdark: \"345 88% 77%\",\n\t},\n\t{\n\t\tid: \"purple\",\n\t\tlabel: \"Grape\",\n\t\ttoken: \"--basalt-accent-10\",\n\t\tlight: \"280 53% 71%\",\n\t\tdark: \"280 53% 77%\",\n\t},\n\t{\n\t\tid: \"indigo\",\n\t\tlabel: \"Blueberry\",\n\t\ttoken: \"--basalt-accent-11\",\n\t\tlight: \"237 66% 69%\",\n\t\tdark: \"237 66% 77%\",\n\t},\n\t{\n\t\tid: \"gray\",\n\t\tlabel: \"Pearl\",\n\t\ttoken: \"--basalt-accent-12\",\n\t\tlight: \"210 20% 87%\",\n\t\tdark: \"210 20% 88%\",\n\t},\n];\n\nconst LEGACY_ACCENT_IDS = new Map<string, string>([\n\t[\"jade\", \"teal\"],\n\t[\"vermilion\", \"red\"],\n\t[\"magenta\", \"rose\"],\n\t[\"orchid\", \"purple\"],\n\t[\"cobalt\", \"indigo\"],\n\t[\"steel\", \"primary\"],\n\t[\"cadet\", \"sky\"],\n\t[\"seafoam\", \"teal\"],\n\t[\"olive\", \"lime\"],\n\t[\"gold\", \"amber\"],\n\t[\"tangerine\", \"orange\"],\n\t[\"crimson\", \"red\"],\n]);\n\nexport const DEFAULT_ACCENT_ID = \"primary\";\nconst STORAGE_KEY = \"basalt-accent\";\n\ntype AccentContextValue = {\n\taccent: string;\n\tsetAccent: (id: string) => void;\n\tswatches: readonly AccentSwatch[];\n};\n\nconst AccentContext = createContext<AccentContextValue | null>(null);\n\nexport function accentSwatchById(id: string | null | undefined): AccentSwatch {\n\tconst normalized = LEGACY_ACCENT_IDS.get(id ?? \"\") ?? id;\n\treturn ACCENT_SWATCHES.find((swatch) => swatch.id === normalized) ?? ACCENT_SWATCHES[0];\n}\n\nfunction channel(c: number) {\n\treturn c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;\n}\n\nfunction parseHslChannels(hsl: string): [number, number, number] {\n\tconst [hue, sat, light] = hsl.trim().split(/\\s+/);\n\tconst h = Number(hue);\n\tconst s = Number(sat.replace(\"%\", \"\")) / 100;\n\tconst l = Number(light.replace(\"%\", \"\")) / 100;\n\treturn [h, s, l];\n}\n\nfunction hslToRgbChannels(h: number, s: number, l: number): [number, number, number] {\n\tconst k = (n: number) => (n + h / 30) % 12;\n\tconst a = s * Math.min(l, 1 - l);\n\tconst f = (n: number) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));\n\treturn [255 * f(0), 255 * f(8), 255 * f(4)];\n}\n\nfunction relativeLuminance(rgb: [number, number, number]): number {\n\treturn (\n\t\t0.2126 * channel(rgb[0] / 255) + 0.7152 * channel(rgb[1] / 255) + 0.0722 * channel(rgb[2] / 255)\n\t);\n}\n\nfunction wcagContrast(rgbA: [number, number, number], rgbB: [number, number, number]): number {\n\tconst lA = relativeLuminance(rgbA);\n\tconst lB = relativeLuminance(rgbB);\n\treturn (Math.max(lA, lB) + 0.05) / (Math.min(lA, lB) + 0.05);\n}\n\nconst DARK_TEXT_RGB: [number, number, number] = [26, 26, 26]; // 0 0% 10%\nconst WHITE_TEXT_RGB: [number, number, number] = [255, 255, 255]; // 0 0% 100%\n\nconst LIGHT_SURFACES_RGB: [number, number, number][] = [\n\t[238, 239, 242], // background\n\t[246, 247, 248], // card\n\t[252, 252, 253], // secondary\n\t[255, 255, 255], // bright\n];\n\nconst DARK_SURFACES_RGB: [number, number, number][] = [\n\t[23, 23, 23], // background\n\t[27, 27, 27], // card\n\t[31, 31, 31], // secondary\n\t[36, 36, 36], // bright\n];\n\nfunction compositeRgb(\n\ttop: [number, number, number, number],\n\tbottom: [number, number, number],\n): [number, number, number] {\n\treturn [\n\t\ttop[0] * top[3] + bottom[0] * (1 - top[3]),\n\t\ttop[1] * top[3] + bottom[1] * (1 - top[3]),\n\t\ttop[2] * top[3] + bottom[2] * (1 - top[3]),\n\t];\n}\n\nfunction deriveSemanticPrimary(swatch: AccentSwatch, dark: boolean): string {\n\tconst [h, s, origL] = parseHslChannels(dark ? swatch.dark : swatch.light);\n\tconst targetSurfaces = dark ? DARK_SURFACES_RGB : LIGHT_SURFACES_RGB;\n\tconst foreground = dark ? DARK_TEXT_RGB : WHITE_TEXT_RGB;\n\tconst start = dark\n\t\t? Math.max(Math.round(origL * 100), 45)\n\t\t: Math.min(Math.round(origL * 100), 60);\n\n\tfor (let l = start; dark ? l <= 85 : l >= 15; l += dark ? 1 : -1) {\n\t\tconst rgb = hslToRgbChannels(h, s, l / 100);\n\t\tconst minTextR = Math.min(...targetSurfaces.map((bg) => wcagContrast(rgb, bg)));\n\t\tif (minTextR < 4.55) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (wcagContrast(rgb, foreground) < 4.55) {\n\t\t\tcontinue;\n\t\t}\n\t\tlet hoverOk = true;\n\t\tfor (const bg of targetSurfaces) {\n\t\t\tconst hoverBg = compositeRgb([...rgb, 0.9], bg);\n\t\t\tif (wcagContrast(hoverBg, foreground) < 4.55) {\n\t\t\t\thoverOk = false;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tif (hoverOk) {\n\t\t\treturn `${h} ${Math.round(s * 100)}% ${l}%`;\n\t\t}\n\t}\n\treturn dark ? swatch.dark : swatch.light;\n}\n\nexport function accentForeground(hsl: string) {\n\tconst [h, s, l] = parseHslChannels(hsl);\n\tconst rgb = hslToRgbChannels(h, s, l);\n\tconst contrastWhite = wcagContrast(rgb, WHITE_TEXT_RGB);\n\tconst contrastDark = wcagContrast(rgb, DARK_TEXT_RGB);\n\treturn contrastDark >= contrastWhite ? (\"0 0% 10%\" as const) : (\"0 0% 100%\" as const);\n}\n\nexport function applyAccent(id: string, dark = false) {\n\tif (typeof document === \"undefined\") {\n\t\treturn;\n\t}\n\tapplySwatch(accentSwatchById(id), dark);\n}\n\nfunction applySwatch(swatch: AccentSwatch, dark: boolean) {\n\tconst semanticPrimary = deriveSemanticPrimary(swatch, dark);\n\tconst root = document.documentElement;\n\troot.style.setProperty(\"--basalt-primary\", semanticPrimary);\n\troot.style.setProperty(\"--basalt-primary-foreground\", accentForeground(semanticPrimary));\n\troot.style.setProperty(\"--basalt-ring\", semanticPrimary);\n\troot.dataset.accent = swatch.id;\n}\n\nexport interface AccentProviderProps {\n\t/** Color overrides for the twelve preset IDs, using HSL channels (for example `204 88% 62%`).\n\t * Invalid pairs and unknown IDs are ignored. Persistence belongs to the application.\n\t * Chart colors remain fixed. */\n\tpaletteOverrides?: Readonly<Record<string, { light: string; dark: string }>>;\n\t/**\n\t * Application components wrapped by the accent context.\n\t */\n\tchildren: ReactNode;\n\t/**\n\t * Storage key used for accent persistence.\n\t * @default \"basalt-accent\"\n\t */\n\tstorageKey?: string;\n\t/**\n\t * Initial accent identifier used when no stored preference exists or during SSR.\n\t * @default \"primary\"\n\t */\n\tdefaultAccent?: string;\n\t/**\n\t * Whether to persist accent changes to localStorage.\n\t * If false, localStorage is never read or written.\n\t * @default true\n\t */\n\tpersist?: boolean;\n\t/**\n\t * Controlled accent identifier. When provided, the provider acts as a controlled component\n\t * and internal state is driven by this prop.\n\t */\n\taccent?: string;\n\t/**\n\t * Callback fired when accent change is requested.\n\t * In controlled mode, callers are responsible for updating `accent`.\n\t */\n\tonAccentChange?: (accent: string) => void;\n\t/**\n\t * Whether to apply accent CSS variables and data-accent attribute to document.documentElement.\n\t * Set to false when a host theme system manages CSS variables directly.\n\t * @default true\n\t */\n\tapplyToDocument?: boolean;\n}\n\nfunction isValidAccentId(value: unknown): value is string {\n\treturn (\n\t\ttypeof value === \"string\" &&\n\t\t(ACCENT_SWATCHES.some((s) => s.id === value) || LEGACY_ACCENT_IDS.has(value))\n\t);\n}\n\nfunction validHsl(value: unknown): value is string {\n\tif (typeof value !== \"string\" || !/^\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?%\\s+\\d+(?:\\.\\d+)?%$/.test(value))\n\t\treturn false;\n\tconst [h, s, l] = parseHslChannels(value);\n\treturn h <= 360 && s <= 1 && l <= 1;\n}\n\nfunction isDarkMode(): boolean {\n\tif (typeof document === \"undefined\") {\n\t\treturn false;\n\t}\n\treturn document.documentElement.classList.contains(\"dark\");\n}\n\nexport function AccentProvider({\n\tchildren,\n\tpaletteOverrides,\n\tstorageKey = STORAGE_KEY,\n\tdefaultAccent = DEFAULT_ACCENT_ID,\n\tpersist = true,\n\taccent: controlledAccent,\n\tonAccentChange,\n\tapplyToDocument = true,\n}: AccentProviderProps) {\n\tconst isControlled = controlledAccent !== undefined;\n\tconst swatches = useMemo(\n\t\t() =>\n\t\t\tACCENT_SWATCHES.map((swatch) => {\n\t\t\t\tconst override = paletteOverrides?.[swatch.id];\n\t\t\t\treturn override && validHsl(override.light) && validHsl(override.dark)\n\t\t\t\t\t? { ...swatch, light: override.light, dark: override.dark }\n\t\t\t\t\t: swatch;\n\t\t\t}),\n\t\t[paletteOverrides],\n\t);\n\n\tconst [store] = useState(() =>\n\t\tcreatePreferenceStore({\n\t\t\tstorageKey,\n\t\t\tdefaultValue: defaultAccent,\n\t\t\tpersist,\n\t\t\tisValid: isValidAccentId,\n\t\t\tnormalize: (value) => accentSwatchById(value).id,\n\t\t\teventName: \"basalt:accent-change\",\n\t\t}),\n\t);\n\n\tuseEffect(() => {\n\t\tstore.updateConfig({ storageKey, defaultValue: defaultAccent, persist });\n\t}, [store, storageKey, defaultAccent, persist]);\n\n\tconst getServerSnapshot = useCallback(() => accentSwatchById(defaultAccent).id, [defaultAccent]);\n\n\tconst storeAccent = useSyncExternalStore(store.subscribe, store.getSnapshot, getServerSnapshot);\n\n\tconst currentAccent = isControlled ? accentSwatchById(controlledAccent).id : storeAccent;\n\n\tuseEffect(() => {\n\t\tif (!applyToDocument || typeof document === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tconst apply = () => {\n\t\t\tconst dark = isDarkMode();\n\t\t\tfor (const swatch of swatches)\n\t\t\t\tdocument.documentElement.style.setProperty(swatch.token, dark ? swatch.dark : swatch.light);\n\t\t\tapplySwatch(swatches.find((swatch) => swatch.id === currentAccent) ?? swatches[0], dark);\n\t\t};\n\t\tapply();\n\t\tconst observer = new MutationObserver(apply);\n\t\tobserver.observe(document.documentElement, { attributes: true, attributeFilter: [\"class\"] });\n\t\treturn () => observer.disconnect();\n\t}, [currentAccent, applyToDocument, swatches]);\n\n\tconst setAccent = useCallback(\n\t\t(next: string) => {\n\t\t\tconst validId = accentSwatchById(next).id;\n\t\t\tif (isControlled) {\n\t\t\t\tonAccentChange?.(validId);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tstore.setValue(validId);\n\t\t\tonAccentChange?.(validId);\n\t\t},\n\t\t[isControlled, onAccentChange, store],\n\t);\n\n\tconst value = useMemo(\n\t\t() => ({ accent: currentAccent, setAccent, swatches }),\n\t\t[currentAccent, setAccent, swatches],\n\t);\n\treturn <AccentContext.Provider value={value}>{children}</AccentContext.Provider>;\n}\n\nexport function useAccent() {\n\tconst ctx = useContext(AccentContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useAccent must be used within AccentProvider\");\n\t}\n\treturn ctx;\n}\n"],"mappings":"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"}
+{"version":3,"file":"accent.js","names":["ACCENT_SWATCHES","LEGACY_ACCENT_IDS","DEFAULT_ACCENT_ID","STORAGE_KEY","AccentContext","createContext","accentSwatchById","normalized","id","swatch","channel","c","parseHslChannels","hue","sat","light","hsl","hslToRgbChannels","k","n","h","a","s","l","f","relativeLuminance","rgb","wcagContrast","lA","rgbA","lB","rgbB","DARK_TEXT_RGB","WHITE_TEXT_RGB","LIGHT_SURFACES_RGB","DARK_SURFACES_RGB","compositeRgb","top","bottom","deriveSemanticPrimary","origL","dark","targetSurfaces","foreground","start","bg","hoverOk","accentForeground","contrastWhite","applyAccent","applySwatch","semanticPrimary","root","isValidAccentId","value","validHsl","isDarkMode","AccentProvider","controlledAccent","isControlled","swatches","useMemo","override","paletteOverrides","store","useState","createPreferenceStore","defaultAccent","storageKey","persist","getServerSnapshot","useCallback","storeAccent","useSyncExternalStore","currentAccent","applyToDocument","apply","observer","setAccent","validId","next","onAccentChange","useAccent","ctx","useContext"],"sources":["../../src/providers/accent.tsx"],"sourcesContent":["import {\n\tcreateContext,\n\ttype ReactNode,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseState,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { createPreferenceStore } from \"../utils/preference-store\";\n\nexport type AccentSwatch = {\n\tid: string;\n\tlabel: string;\n\ttoken: string;\n\tlight: string;\n\tdark: string;\n};\n\n/** Twelve candy accents inspired by the translucent iMac and iPhone 5C finishes. */\nexport const ACCENT_SWATCHES: readonly AccentSwatch[] = [\n\t{\n\t\tid: \"primary\",\n\t\tlabel: \"Blue\",\n\t\ttoken: \"--basalt-accent-1\",\n\t\tlight: \"204 88% 62%\",\n\t\tdark: \"204 90% 70%\",\n\t},\n\t{\n\t\tid: \"sky\",\n\t\tlabel: \"Ice\",\n\t\ttoken: \"--basalt-accent-2\",\n\t\tlight: \"191 79% 70%\",\n\t\tdark: \"191 79% 74%\",\n\t},\n\t{\n\t\tid: \"teal\",\n\t\tlabel: \"Bondi\",\n\t\ttoken: \"--basalt-accent-3\",\n\t\tlight: \"182 62% 47%\",\n\t\tdark: \"182 62% 63%\",\n\t},\n\t{\n\t\tid: \"green\",\n\t\tlabel: \"Green\",\n\t\ttoken: \"--basalt-accent-4\",\n\t\tlight: \"113 58% 62%\",\n\t\tdark: \"113 58% 70%\",\n\t},\n\t{\n\t\tid: \"lime\",\n\t\tlabel: \"Lime\",\n\t\ttoken: \"--basalt-accent-5\",\n\t\tlight: \"79 70% 64%\",\n\t\tdark: \"79 70% 70%\",\n\t},\n\t{\n\t\tid: \"amber\",\n\t\tlabel: \"Yellow\",\n\t\ttoken: \"--basalt-accent-6\",\n\t\tlight: \"49 100% 69%\",\n\t\tdark: \"49 100% 73%\",\n\t},\n\t{\n\t\tid: \"orange\",\n\t\tlabel: \"Tangerine\",\n\t\ttoken: \"--basalt-accent-7\",\n\t\tlight: \"27 95% 65%\",\n\t\tdark: \"27 95% 72%\",\n\t},\n\t{\n\t\tid: \"red\",\n\t\tlabel: \"Strawberry\",\n\t\ttoken: \"--basalt-accent-8\",\n\t\tlight: \"5 85% 66%\",\n\t\tdark: \"5 85% 73%\",\n\t},\n\t{\n\t\tid: \"rose\",\n\t\tlabel: \"Pink\",\n\t\ttoken: \"--basalt-accent-9\",\n\t\tlight: \"345 88% 72%\",\n\t\tdark: \"345 88% 77%\",\n\t},\n\t{\n\t\tid: \"purple\",\n\t\tlabel: \"Grape\",\n\t\ttoken: \"--basalt-accent-10\",\n\t\tlight: \"280 53% 71%\",\n\t\tdark: \"280 53% 77%\",\n\t},\n\t{\n\t\tid: \"indigo\",\n\t\tlabel: \"Blueberry\",\n\t\ttoken: \"--basalt-accent-11\",\n\t\tlight: \"237 66% 69%\",\n\t\tdark: \"237 66% 77%\",\n\t},\n\t{\n\t\tid: \"gray\",\n\t\tlabel: \"Pearl\",\n\t\ttoken: \"--basalt-accent-12\",\n\t\tlight: \"210 20% 87%\",\n\t\tdark: \"210 20% 88%\",\n\t},\n];\n\nconst LEGACY_ACCENT_IDS = new Map<string, string>([\n\t[\"jade\", \"teal\"],\n\t[\"vermilion\", \"red\"],\n\t[\"magenta\", \"rose\"],\n\t[\"orchid\", \"purple\"],\n\t[\"cobalt\", \"indigo\"],\n\t[\"steel\", \"primary\"],\n\t[\"cadet\", \"sky\"],\n\t[\"seafoam\", \"teal\"],\n\t[\"olive\", \"lime\"],\n\t[\"gold\", \"amber\"],\n\t[\"tangerine\", \"orange\"],\n\t[\"crimson\", \"red\"],\n]);\n\nexport const DEFAULT_ACCENT_ID = \"primary\";\nconst STORAGE_KEY = \"basalt-accent\";\n\ntype AccentContextValue = {\n\taccent: string;\n\tsetAccent: (id: string) => void;\n\tswatches: readonly AccentSwatch[];\n};\n\nconst AccentContext = createContext<AccentContextValue | null>(null);\n\nexport function accentSwatchById(id: string | null | undefined): AccentSwatch {\n\tconst normalized = LEGACY_ACCENT_IDS.get(id ?? \"\") ?? id;\n\treturn ACCENT_SWATCHES.find((swatch) => swatch.id === normalized) ?? ACCENT_SWATCHES[0];\n}\n\nfunction channel(c: number) {\n\treturn c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;\n}\n\nfunction parseHslChannels(hsl: string): [number, number, number] {\n\tconst [hue, sat, light] = hsl.trim().split(/\\s+/);\n\tconst h = Number(hue);\n\tconst s = Number(sat.replace(\"%\", \"\")) / 100;\n\tconst l = Number(light.replace(\"%\", \"\")) / 100;\n\treturn [h, s, l];\n}\n\nfunction hslToRgbChannels(h: number, s: number, l: number): [number, number, number] {\n\tconst k = (n: number) => (n + h / 30) % 12;\n\tconst a = s * Math.min(l, 1 - l);\n\tconst f = (n: number) => l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)));\n\treturn [255 * f(0), 255 * f(8), 255 * f(4)];\n}\n\nfunction relativeLuminance(rgb: [number, number, number]): number {\n\treturn (\n\t\t0.2126 * channel(rgb[0] / 255) + 0.7152 * channel(rgb[1] / 255) + 0.0722 * channel(rgb[2] / 255)\n\t);\n}\n\nfunction wcagContrast(rgbA: [number, number, number], rgbB: [number, number, number]): number {\n\tconst lA = relativeLuminance(rgbA);\n\tconst lB = relativeLuminance(rgbB);\n\treturn (Math.max(lA, lB) + 0.05) / (Math.min(lA, lB) + 0.05);\n}\n\nconst DARK_TEXT_RGB: [number, number, number] = [26, 26, 26]; // 0 0% 10%\nconst WHITE_TEXT_RGB: [number, number, number] = [255, 255, 255]; // 0 0% 100%\n\nconst LIGHT_SURFACES_RGB: [number, number, number][] = [\n\t[238, 239, 242], // background\n\t[246, 247, 248], // card\n\t[252, 252, 253], // secondary\n\t[255, 255, 255], // bright\n];\n\nconst DARK_SURFACES_RGB: [number, number, number][] = [\n\t[23, 23, 23], // background\n\t[27, 27, 27], // card\n\t[31, 31, 31], // secondary\n\t[36, 36, 36], // bright\n];\n\nfunction compositeRgb(\n\ttop: [number, number, number, number],\n\tbottom: [number, number, number],\n): [number, number, number] {\n\treturn [\n\t\ttop[0] * top[3] + bottom[0] * (1 - top[3]),\n\t\ttop[1] * top[3] + bottom[1] * (1 - top[3]),\n\t\ttop[2] * top[3] + bottom[2] * (1 - top[3]),\n\t];\n}\n\nfunction deriveSemanticPrimary(swatch: AccentSwatch, dark: boolean): string {\n\tconst [h, s, origL] = parseHslChannels(dark ? swatch.dark : swatch.light);\n\tconst targetSurfaces = dark ? DARK_SURFACES_RGB : LIGHT_SURFACES_RGB;\n\tconst foreground = dark ? DARK_TEXT_RGB : WHITE_TEXT_RGB;\n\tconst start = dark\n\t\t? Math.max(Math.round(origL * 100), 45)\n\t\t: Math.min(Math.round(origL * 100), 60);\n\n\tfor (let l = start; dark ? l <= 85 : l >= 15; l += dark ? 1 : -1) {\n\t\tconst rgb = hslToRgbChannels(h, s, l / 100);\n\t\tconst minTextR = Math.min(...targetSurfaces.map((bg) => wcagContrast(rgb, bg)));\n\t\tif (minTextR < 4.55) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (wcagContrast(rgb, foreground) < 4.55) {\n\t\t\tcontinue;\n\t\t}\n\t\tlet hoverOk = true;\n\t\tfor (const bg of targetSurfaces) {\n\t\t\tconst hoverBg = compositeRgb([...rgb, 0.9], bg);\n\t\t\tif (wcagContrast(hoverBg, foreground) < 4.55) {\n\t\t\t\thoverOk = false;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tif (hoverOk) {\n\t\t\treturn `${h} ${Math.round(s * 100)}% ${l}%`;\n\t\t}\n\t}\n\treturn dark ? swatch.dark : swatch.light;\n}\n\nexport function accentForeground(hsl: string) {\n\tconst [h, s, l] = parseHslChannels(hsl);\n\tconst rgb = hslToRgbChannels(h, s, l);\n\tconst contrastWhite = wcagContrast(rgb, WHITE_TEXT_RGB);\n\tconst contrastDark = wcagContrast(rgb, DARK_TEXT_RGB);\n\treturn contrastDark >= contrastWhite ? (\"0 0% 10%\" as const) : (\"0 0% 100%\" as const);\n}\n\nexport function applyAccent(id: string, dark = false) {\n\tif (typeof document === \"undefined\") {\n\t\treturn;\n\t}\n\tapplySwatch(accentSwatchById(id), dark);\n}\n\nfunction applySwatch(swatch: AccentSwatch, dark: boolean) {\n\tconst semanticPrimary = deriveSemanticPrimary(swatch, dark);\n\tconst root = document.documentElement;\n\troot.style.setProperty(\"--basalt-primary\", semanticPrimary);\n\troot.style.setProperty(\"--basalt-primary-foreground\", accentForeground(semanticPrimary));\n\troot.style.setProperty(\"--basalt-ring\", semanticPrimary);\n\troot.dataset.accent = swatch.id;\n}\n\nexport interface AccentProviderProps {\n\t/** Color overrides for the twelve preset IDs, using HSL channels (for example `204 88% 62%`).\n\t * Invalid pairs and unknown IDs are ignored. Persistence belongs to the application.\n\t * Chart colors remain fixed. */\n\tpaletteOverrides?: Readonly<Record<string, { light: string; dark: string }>>;\n\t/**\n\t * Application components wrapped by the accent context.\n\t */\n\tchildren: ReactNode;\n\t/**\n\t * Storage key used for accent persistence.\n\t * @default \"basalt-accent\"\n\t */\n\tstorageKey?: string;\n\t/**\n\t * Initial accent identifier used when no stored preference exists or during SSR.\n\t * @default \"primary\"\n\t */\n\tdefaultAccent?: string;\n\t/**\n\t * Whether to persist accent changes to localStorage.\n\t * If false, localStorage is never read or written.\n\t * @default true\n\t */\n\tpersist?: boolean;\n\t/**\n\t * Controlled accent identifier. When provided, the provider acts as a controlled component\n\t * and internal state is driven by this prop.\n\t */\n\taccent?: string;\n\t/**\n\t * Callback fired when accent change is requested.\n\t * In controlled mode, callers are responsible for updating `accent`.\n\t */\n\tonAccentChange?: (accent: string) => void;\n\t/**\n\t * Whether to apply accent CSS variables and data-accent attribute to document.documentElement.\n\t * Set to false when a host theme system manages CSS variables directly.\n\t * @default true\n\t */\n\tapplyToDocument?: boolean;\n}\n\nfunction isValidAccentId(value: unknown): value is string {\n\treturn (\n\t\ttypeof value === \"string\" &&\n\t\t(ACCENT_SWATCHES.some((s) => s.id === value) || LEGACY_ACCENT_IDS.has(value))\n\t);\n}\n\nfunction validHsl(value: unknown): value is string {\n\tif (typeof value !== \"string\" || !/^\\d+(?:\\.\\d+)?\\s+\\d+(?:\\.\\d+)?%\\s+\\d+(?:\\.\\d+)?%$/.test(value))\n\t\treturn false;\n\tconst [h, s, l] = parseHslChannels(value);\n\treturn h <= 360 && s <= 1 && l <= 1;\n}\n\nfunction isDarkMode(): boolean {\n\tif (typeof document === \"undefined\") {\n\t\treturn false;\n\t}\n\treturn document.documentElement.classList.contains(\"dark\");\n}\n\nexport function AccentProvider({\n\tchildren,\n\tpaletteOverrides,\n\tstorageKey = STORAGE_KEY,\n\tdefaultAccent = DEFAULT_ACCENT_ID,\n\tpersist = true,\n\taccent: controlledAccent,\n\tonAccentChange,\n\tapplyToDocument = true,\n}: AccentProviderProps) {\n\tconst isControlled = controlledAccent !== undefined;\n\tconst swatches = useMemo(\n\t\t() =>\n\t\t\tACCENT_SWATCHES.map((swatch) => {\n\t\t\t\tconst override = paletteOverrides?.[swatch.id];\n\t\t\t\treturn override && validHsl(override.light) && validHsl(override.dark)\n\t\t\t\t\t? { ...swatch, light: override.light, dark: override.dark }\n\t\t\t\t\t: swatch;\n\t\t\t}),\n\t\t[paletteOverrides],\n\t);\n\n\tconst [store] = useState(() =>\n\t\tcreatePreferenceStore({\n\t\t\tstorageKey,\n\t\t\tdefaultValue: defaultAccent,\n\t\t\tpersist,\n\t\t\tisValid: isValidAccentId,\n\t\t\tnormalize: (value) => accentSwatchById(value).id,\n\t\t\teventName: \"basalt:accent-change\",\n\t\t}),\n\t);\n\n\tuseEffect(() => {\n\t\tstore.updateConfig({ storageKey, defaultValue: defaultAccent, persist });\n\t}, [store, storageKey, defaultAccent, persist]);\n\n\tconst getServerSnapshot = useCallback(() => accentSwatchById(defaultAccent).id, [defaultAccent]);\n\n\tconst storeAccent = useSyncExternalStore(store.subscribe, store.getSnapshot, getServerSnapshot);\n\n\tconst currentAccent = isControlled ? accentSwatchById(controlledAccent).id : storeAccent;\n\n\tuseEffect(() => {\n\t\tif (!applyToDocument || typeof document === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tconst apply = () => {\n\t\t\tconst dark = isDarkMode();\n\t\t\tfor (const swatch of swatches)\n\t\t\t\tdocument.documentElement.style.setProperty(swatch.token, dark ? swatch.dark : swatch.light);\n\t\t\tapplySwatch(swatches.find((swatch) => swatch.id === currentAccent) ?? swatches[0], dark);\n\t\t};\n\t\tapply();\n\t\tconst observer = new MutationObserver(apply);\n\t\tobserver.observe(document.documentElement, { attributes: true, attributeFilter: [\"class\"] });\n\t\treturn () => observer.disconnect();\n\t}, [currentAccent, applyToDocument, swatches]);\n\n\tconst setAccent = useCallback(\n\t\t(next: string) => {\n\t\t\tconst validId = accentSwatchById(next).id;\n\t\t\tif (isControlled) {\n\t\t\t\tonAccentChange?.(validId);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tstore.setValue(validId);\n\t\t\tonAccentChange?.(validId);\n\t\t},\n\t\t[isControlled, onAccentChange, store],\n\t);\n\n\tconst value = useMemo(\n\t\t() => ({ accent: currentAccent, setAccent, swatches }),\n\t\t[currentAccent, setAccent, swatches],\n\t);\n\treturn <AccentContext.Provider value={value}>{children}</AccentContext.Provider>;\n}\n\nexport function useAccent() {\n\tconst ctx = useContext(AccentContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useAccent must be used within AccentProvider\");\n\t}\n\treturn ctx;\n}\n"],"mappings":"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"}

package/dist/providers/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","names":[],"sources":["../../src/providers/link.tsx"],"sourcesContent":["import { type ComponentType, createContext, type ReactNode, useContext } from \"react\";\n\nexport type LinkComponent = ComponentType<{\n\thref: string;\n\tclassName?: string;\n\tchildren?: ReactNode;\n}>;\n\nexport interface LinkProviderProps {\n\t/**\n\t * Custom link renderer component injected into Basalt Link.\n\t * When omitted (undefined), Basalt Link internally falls back to a standard HTML \"a\" element.\n\t * Note: this prop only accepts a custom React component (ComponentType<{ href: string; className?: string; children?: ReactNode }>); string literals like \"a\" are not accepted.\n\t * useLinkComponent() returns the custom LinkComponent or \"a\" when no custom renderer is configured, and safely returns \"a\" even without LinkProvider without throwing.\n\t * Component renders a React context provider without native HTML rest attribute forwarding or forwarded ref.\n\t */\n\trender?: LinkComponent;\n\t/**\n\t * Application components wrapped by the link routing context.\n\t */\n\tchildren: ReactNode;\n}\n\nconst LinkContext = createContext<LinkComponent | \"a\">(\"a\");\n\nexport function LinkProvider({ render, children }: LinkProviderProps) {\n\treturn <LinkContext.Provider value={render ?? \"a\"}>{children}</LinkContext.Provider>;\n}\n\nexport function useLinkComponent() {\n\treturn useContext(LinkContext);\n}\n"],"mappings":";;;;AAuBA,IAAM,IAAc,EAAmC,GAAG;AAE1D,SAAgB,EAAa,EAAE,WAAQ,eAA+B;CACrE,OAAO,kBAAC,EAAY,UAAb;EAAsB,OAAO,KAAU;EAAM;CAA+B,CAAA;AACpF;AAEA,SAAgB,IAAmB;CAClC,OAAO,EAAW,CAAW;AAC9B"}
+{"version":3,"file":"link.js","names":["LinkContext","createContext","LinkProvider","render","useLinkComponent","useContext"],"sources":["../../src/providers/link.tsx"],"sourcesContent":["import { type ComponentType, createContext, type ReactNode, useContext } from \"react\";\n\nexport type LinkComponent = ComponentType<{\n\thref: string;\n\tclassName?: string;\n\tchildren?: ReactNode;\n}>;\n\nexport interface LinkProviderProps {\n\t/**\n\t * Custom link renderer component injected into Basalt Link.\n\t * When omitted (undefined), Basalt Link internally falls back to a standard HTML \"a\" element.\n\t * Note: this prop only accepts a custom React component (ComponentType<{ href: string; className?: string; children?: ReactNode }>); string literals like \"a\" are not accepted.\n\t * useLinkComponent() returns the custom LinkComponent or \"a\" when no custom renderer is configured, and safely returns \"a\" even without LinkProvider without throwing.\n\t * Component renders a React context provider without native HTML rest attribute forwarding or forwarded ref.\n\t */\n\trender?: LinkComponent;\n\t/**\n\t * Application components wrapped by the link routing context.\n\t */\n\tchildren: ReactNode;\n}\n\nconst LinkContext = createContext<LinkComponent | \"a\">(\"a\");\n\nexport function LinkProvider({ render, children }: LinkProviderProps) {\n\treturn <LinkContext.Provider value={render ?? \"a\"}>{children}</LinkContext.Provider>;\n}\n\nexport function useLinkComponent() {\n\treturn useContext(LinkContext);\n}\n"],"mappings":";;;;AAuBA,IAAMA,IAAcC,EAAmC,GAAG;AAE1D,SAAgBC,EAAa,EAAE,WAAQ,eAA+B;CACrE,OAAO,kBAACF,EAAY,UAAb;EAAsB,OAAOG,KAAU;EAAM;CAA+B,CAAA;AACpF;AAEA,SAAgBC,IAAmB;CAClC,OAAOC,EAAWL,CAAW;AAC9B"}

package/dist/providers/theme.js

@@ -41,7 +41,7 @@ function p({ children: t, storageKey: r = l, defaultTheme: p = "system", persist
 	]);
 	let b = n(() => p, [p]), x = s(y.subscribe, y.getSnapshot, b), S = v ? h : x;
 	i(() => {
-		if (!(!_ || typeof window > "u") && (d(S), S === "system")) try {
+		if (_ && typeof window < "u" && (d(S), S === "system")) try {
 			let e = window.matchMedia("(prefers-color-scheme: dark)"), t = () => d("system");
 			return e.addEventListener("change", t), () => e.removeEventListener("change", t);
 		} catch {

package/dist/providers/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","names":[],"sources":["../../src/providers/theme.tsx"],"sourcesContent":["import {\n\tcreateContext,\n\ttype ReactNode,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseState,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { createPreferenceStore } from \"../utils/preference-store\";\n\nexport type BasaltTheme = \"light\" | \"dark\" | \"system\";\n\nconst STORAGE_KEY = \"theme\";\n\ntype ThemeContextValue = {\n\ttheme: BasaltTheme;\n\tsetTheme: (theme: BasaltTheme) => void;\n};\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nfunction applyTheme(theme: BasaltTheme) {\n\tif (typeof document === \"undefined\") {\n\t\treturn;\n\t}\n\tconst root = document.documentElement;\n\tlet systemDark = false;\n\ttry {\n\t\tif (typeof window !== \"undefined\" && typeof window.matchMedia === \"function\") {\n\t\t\tsystemDark = window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n\t\t}\n\t} catch {\n\t\tsystemDark = false;\n\t}\n\tconst dark = theme === \"dark\" || (theme === \"system\" && systemDark);\n\troot.classList.toggle(\"dark\", dark);\n\troot.classList.toggle(\"light\", !dark);\n\troot.dataset.mode = dark ? \"dark\" : \"light\";\n}\n\nexport interface ThemeProviderProps {\n\t/**\n\t * Application components wrapped by the theme context.\n\t */\n\tchildren: ReactNode;\n\t/**\n\t * Storage key used for theme persistence.\n\t * @default \"theme\"\n\t */\n\tstorageKey?: string;\n\t/**\n\t * Initial theme used when no stored preference exists or during SSR.\n\t * @default \"system\"\n\t */\n\tdefaultTheme?: BasaltTheme;\n\t/**\n\t * Whether to persist theme changes to localStorage.\n\t * If false, localStorage is never read or written.\n\t * @default true\n\t */\n\tpersist?: boolean;\n\t/**\n\t * Controlled theme value. When provided, the provider acts as a controlled component\n\t * and internal state is driven by this prop.\n\t */\n\ttheme?: BasaltTheme;\n\t/**\n\t * Callback fired when theme change is requested.\n\t * In controlled mode, callers are responsible for updating `theme`.\n\t */\n\tonThemeChange?: (theme: BasaltTheme) => void;\n\t/**\n\t * Whether to apply mode classes and data-mode attribute to document.documentElement.\n\t * Set to false when a host theme system manages the document root.\n\t * @default true\n\t */\n\tapplyToDocument?: boolean;\n}\n\nfunction isValidTheme(value: unknown): value is BasaltTheme {\n\treturn value === \"light\" || value === \"dark\" || value === \"system\";\n}\n\nexport function ThemeProvider({\n\tchildren,\n\tstorageKey = STORAGE_KEY,\n\tdefaultTheme = \"system\",\n\tpersist = true,\n\ttheme: controlledTheme,\n\tonThemeChange,\n\tapplyToDocument = true,\n}: ThemeProviderProps) {\n\tconst isControlled = controlledTheme !== undefined;\n\n\tconst [store] = useState(() =>\n\t\tcreatePreferenceStore({\n\t\t\tstorageKey,\n\t\t\tdefaultValue: defaultTheme,\n\t\t\tpersist,\n\t\t\tisValid: isValidTheme,\n\t\t\tnormalize: (value) => value,\n\t\t\teventName: \"basalt:theme-change\",\n\t\t}),\n\t);\n\n\tuseEffect(() => {\n\t\tstore.updateConfig({ storageKey, defaultValue: defaultTheme, persist });\n\t}, [store, storageKey, defaultTheme, persist]);\n\n\tconst getServerSnapshot = useCallback(() => defaultTheme, [defaultTheme]);\n\n\tconst storeTheme = useSyncExternalStore(store.subscribe, store.getSnapshot, getServerSnapshot);\n\n\tconst currentTheme = isControlled ? controlledTheme : storeTheme;\n\n\tuseEffect(() => {\n\t\tif (!applyToDocument || typeof window === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tapplyTheme(currentTheme);\n\t\tif (currentTheme !== \"system\") {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\t\t\tconst onChange = () => applyTheme(\"system\");\n\t\t\tmq.addEventListener(\"change\", onChange);\n\t\t\treturn () => mq.removeEventListener(\"change\", onChange);\n\t\t} catch {\n\t\t\t// matchMedia not supported or restricted\n\t\t\treturn;\n\t\t}\n\t}, [currentTheme, applyToDocument]);\n\n\tconst setTheme = useCallback(\n\t\t(next: BasaltTheme) => {\n\t\t\tif (isControlled) {\n\t\t\t\tonThemeChange?.(next);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tstore.setValue(next);\n\t\t\tonThemeChange?.(next);\n\t\t},\n\t\t[isControlled, onThemeChange, store],\n\t);\n\n\tconst value = useMemo(() => ({ theme: currentTheme, setTheme }), [currentTheme, setTheme]);\n\n\treturn <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\nexport function useTheme() {\n\tconst ctx = useContext(ThemeContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useTheme must be used within ThemeProvider\");\n\t}\n\treturn ctx;\n}\n"],"mappings":";;;;;AAcA,IAAM,IAAc,SAOd,IAAe,EAAwC,IAAI;AAEjE,SAAS,EAAW,GAAoB;CACvC,IAAI,OAAO,WAAa,KACvB;CAED,IAAM,IAAO,SAAS,iBAClB,IAAa;CACjB,IAAI;EACH,AAAI,OAAO,SAAW,OAAe,OAAO,OAAO,cAAe,eACjE,IAAa,OAAO,WAAW,8BAA8B,CAAC,CAAC;CAEjE,QAAQ;EACP,IAAa;CACd;CACA,IAAM,IAAO,MAAU,UAAW,MAAU,YAAY;CAGxD,AAFA,EAAK,UAAU,OAAO,QAAQ,CAAI,GAClC,EAAK,UAAU,OAAO,SAAS,CAAC,CAAI,GACpC,EAAK,QAAQ,OAAO,IAAO,SAAS;AACrC;AAyCA,SAAS,EAAa,GAAsC;CAC3D,OAAO,MAAU,WAAW,MAAU,UAAU,MAAU;AAC3D;AAEA,SAAgB,EAAc,EAC7B,aACA,gBAAa,GACb,kBAAe,UACf,aAAU,IACV,OAAO,GACP,kBACA,qBAAkB,MACI;CACtB,IAAM,IAAe,MAAoB,KAAA,GAEnC,CAAC,KAAS,QACf,EAAsB;EACrB;EACA,cAAc;EACd;EACA,SAAS;EACT,YAAY,MAAU;EACtB,WAAW;CACZ,CAAC,CACF;CAEA,QAAgB;EACf,EAAM,aAAa;GAAE;GAAY,cAAc;GAAc;EAAQ,CAAC;CACvE,GAAG;EAAC;EAAO;EAAY;EAAc;CAAO,CAAC;CAE7C,IAAM,IAAoB,QAAkB,GAAc,CAAC,CAAY,CAAC,GAElE,IAAa,EAAqB,EAAM,WAAW,EAAM,aAAa,CAAiB,GAEvF,IAAe,IAAe,IAAkB;CAEtD,QAAgB;EACX,OAAC,KAAmB,OAAO,SAAW,SAG1C,EAAW,CAAY,GACnB,MAAiB,WAGrB,IAAI;GACH,IAAM,IAAK,OAAO,WAAW,8BAA8B,GACrD,UAAiB,EAAW,QAAQ;GAE1C,OADA,EAAG,iBAAiB,UAAU,CAAQ,SACzB,EAAG,oBAAoB,UAAU,CAAQ;EACvD,QAAQ;GAEP;EACD;CACD,GAAG,CAAC,GAAc,CAAe,CAAC;CAElC,IAAM,IAAW,GACf,MAAsB;EACtB,IAAI,GAAc;GACjB,IAAgB,CAAI;GACpB;EACD;EAEA,AADA,EAAM,SAAS,CAAI,GACnB,IAAgB,CAAI;CACrB,GACA;EAAC;EAAc;EAAe;CAAK,CACpC,GAEM,IAAQ,SAAe;EAAE,OAAO;EAAc;CAAS,IAAI,CAAC,GAAc,CAAQ,CAAC;CAEzF,OAAO,kBAAC,EAAa,UAAd;EAA8B;EAAQ;CAAgC,CAAA;AAC9E;AAEA,SAAgB,IAAW;CAC1B,IAAM,IAAM,EAAW,CAAY;CACnC,IAAI,CAAC,GACJ,MAAU,MAAM,4CAA4C;CAE7D,OAAO;AACR"}
+{"version":3,"file":"theme.js","names":["STORAGE_KEY","ThemeContext","createContext","applyTheme","root","systemDark","dark","theme","isValidTheme","value","ThemeProvider","controlledTheme","isControlled","store","useState","createPreferenceStore","defaultTheme","storageKey","persist","getServerSnapshot","useCallback","storeTheme","useSyncExternalStore","currentTheme","applyToDocument","mq","onChange","setTheme","next","onThemeChange","useMemo","useTheme","ctx","useContext"],"sources":["../../src/providers/theme.tsx"],"sourcesContent":["import {\n\tcreateContext,\n\ttype ReactNode,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseState,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { createPreferenceStore } from \"../utils/preference-store\";\n\nexport type BasaltTheme = \"light\" | \"dark\" | \"system\";\n\nconst STORAGE_KEY = \"theme\";\n\ntype ThemeContextValue = {\n\ttheme: BasaltTheme;\n\tsetTheme: (theme: BasaltTheme) => void;\n};\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nfunction applyTheme(theme: BasaltTheme) {\n\tif (typeof document === \"undefined\") {\n\t\treturn;\n\t}\n\tconst root = document.documentElement;\n\tlet systemDark = false;\n\ttry {\n\t\tif (typeof window !== \"undefined\" && typeof window.matchMedia === \"function\") {\n\t\t\tsystemDark = window.matchMedia(\"(prefers-color-scheme: dark)\").matches;\n\t\t}\n\t} catch {\n\t\tsystemDark = false;\n\t}\n\tconst dark = theme === \"dark\" || (theme === \"system\" && systemDark);\n\troot.classList.toggle(\"dark\", dark);\n\troot.classList.toggle(\"light\", !dark);\n\troot.dataset.mode = dark ? \"dark\" : \"light\";\n}\n\nexport interface ThemeProviderProps {\n\t/**\n\t * Application components wrapped by the theme context.\n\t */\n\tchildren: ReactNode;\n\t/**\n\t * Storage key used for theme persistence.\n\t * @default \"theme\"\n\t */\n\tstorageKey?: string;\n\t/**\n\t * Initial theme used when no stored preference exists or during SSR.\n\t * @default \"system\"\n\t */\n\tdefaultTheme?: BasaltTheme;\n\t/**\n\t * Whether to persist theme changes to localStorage.\n\t * If false, localStorage is never read or written.\n\t * @default true\n\t */\n\tpersist?: boolean;\n\t/**\n\t * Controlled theme value. When provided, the provider acts as a controlled component\n\t * and internal state is driven by this prop.\n\t */\n\ttheme?: BasaltTheme;\n\t/**\n\t * Callback fired when theme change is requested.\n\t * In controlled mode, callers are responsible for updating `theme`.\n\t */\n\tonThemeChange?: (theme: BasaltTheme) => void;\n\t/**\n\t * Whether to apply mode classes and data-mode attribute to document.documentElement.\n\t * Set to false when a host theme system manages the document root.\n\t * @default true\n\t */\n\tapplyToDocument?: boolean;\n}\n\nfunction isValidTheme(value: unknown): value is BasaltTheme {\n\treturn value === \"light\" || value === \"dark\" || value === \"system\";\n}\n\nexport function ThemeProvider({\n\tchildren,\n\tstorageKey = STORAGE_KEY,\n\tdefaultTheme = \"system\",\n\tpersist = true,\n\ttheme: controlledTheme,\n\tonThemeChange,\n\tapplyToDocument = true,\n}: ThemeProviderProps) {\n\tconst isControlled = controlledTheme !== undefined;\n\n\tconst [store] = useState(() =>\n\t\tcreatePreferenceStore({\n\t\t\tstorageKey,\n\t\t\tdefaultValue: defaultTheme,\n\t\t\tpersist,\n\t\t\tisValid: isValidTheme,\n\t\t\tnormalize: (value) => value,\n\t\t\teventName: \"basalt:theme-change\",\n\t\t}),\n\t);\n\n\tuseEffect(() => {\n\t\tstore.updateConfig({ storageKey, defaultValue: defaultTheme, persist });\n\t}, [store, storageKey, defaultTheme, persist]);\n\n\tconst getServerSnapshot = useCallback(() => defaultTheme, [defaultTheme]);\n\n\tconst storeTheme = useSyncExternalStore(store.subscribe, store.getSnapshot, getServerSnapshot);\n\n\tconst currentTheme = isControlled ? controlledTheme : storeTheme;\n\n\tuseEffect(() => {\n\t\tif (!applyToDocument || typeof window === \"undefined\") {\n\t\t\treturn;\n\t\t}\n\t\tapplyTheme(currentTheme);\n\t\tif (currentTheme !== \"system\") {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tconst mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n\t\t\tconst onChange = () => applyTheme(\"system\");\n\t\t\tmq.addEventListener(\"change\", onChange);\n\t\t\treturn () => mq.removeEventListener(\"change\", onChange);\n\t\t} catch {\n\t\t\t// matchMedia not supported or restricted\n\t\t\treturn;\n\t\t}\n\t}, [currentTheme, applyToDocument]);\n\n\tconst setTheme = useCallback(\n\t\t(next: BasaltTheme) => {\n\t\t\tif (isControlled) {\n\t\t\t\tonThemeChange?.(next);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tstore.setValue(next);\n\t\t\tonThemeChange?.(next);\n\t\t},\n\t\t[isControlled, onThemeChange, store],\n\t);\n\n\tconst value = useMemo(() => ({ theme: currentTheme, setTheme }), [currentTheme, setTheme]);\n\n\treturn <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\nexport function useTheme() {\n\tconst ctx = useContext(ThemeContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useTheme must be used within ThemeProvider\");\n\t}\n\treturn ctx;\n}\n"],"mappings":";;;;;AAcA,IAAMA,IAAc,SAOdC,IAAeC,EAAwC,IAAI;AAEjE,SAASC,EAAW,GAAoB;CACvC,IAAI,OAAO,WAAa,KACvB;CAED,IAAMC,IAAO,SAAS,iBAClBC,IAAa;CACjB,IAAI;EACH,AAAI,OAAO,SAAW,OAAe,OAAO,OAAO,cAAe,eACjE,IAAa,OAAO,WAAW,8BAA8B,CAAC,CAAC;CAEjE,QAAQ;EACP,IAAa;CACd;CACA,IAAMC,IAAOC,MAAU,UAAWA,MAAU,YAAYF;CAGxD,AAFAD,EAAK,UAAU,OAAO,QAAQE,CAAI,GAClCF,EAAK,UAAU,OAAO,SAAS,CAACE,CAAI,GACpC,EAAK,QAAQ,OAAOA,IAAO,SAAS;AACrC;AAyCA,SAASE,EAAa,GAAsC;CAC3D,OAAOC,MAAU,WAAWA,MAAU,UAAUA,MAAU;AAC3D;AAEA,SAAgBC,EAAc,EAC7B,aACA,gBAAaV,GACb,kBAAe,UACf,aAAU,IACV,OAAOW,GACP,kBACA,qBAAkB,MACI;CACtB,IAAMC,IAAeD,MAAoB,KAAA,GAEnC,CAACE,KAASC,QACfC,EAAsB;EACrB;EACA,cAAcC;EACd;EACA,SAASR;EACT,YAAY,MAAUC;EACtB,WAAW;CACZ,CAAC,CACF;CAEA,QAAgB;EACf,EAAM,aAAa;GAAE;GAAY,cAAcO;GAAc;EAAQ,CAAC;CACvE,GAAG;EAACH;EAAOI;EAAYD;EAAcE;CAAO,CAAC;CAE7C,IAAMC,IAAoBC,QAAkBJ,GAAc,CAACA,CAAY,CAAC,GAElEK,IAAaC,EAAqBT,EAAM,WAAWA,EAAM,aAAaM,CAAiB,GAEvFI,IAAeX,IAAeD,IAAkBU;CAEtD,QAAgB;EACf,IAAKG,KAAmB,OAAO,SAAW,QAG1CrB,EAAWoB,CAAY,GACnBA,MAAiB,WAGrB,IAAI;GACH,IAAME,IAAK,OAAO,WAAW,8BAA8B,GACrDC,UAAiBvB,EAAW,QAAQ;GAE1C,OADAsB,EAAG,iBAAiB,UAAUC,CAAQ,SACzBD,EAAG,oBAAoB,UAAUC,CAAQ;EACvD,QAAQ;GAEP;EACD;CACD,GAAG,CAACH,GAAcC,CAAe,CAAC;CAElC,IAAMG,IAAWP,GACf,MAAsB;EACtB,IAAIR,GAAc;GACjB,IAAgBgB,CAAI;GACpB;EACD;EAEA,AADAf,EAAM,SAASe,CAAI,GACnBC,IAAgBD,CAAI;CACrB,GACA;EAAChB;EAAciB;EAAehB;CAAK,CACpC,GAEMJ,IAAQqB,SAAe;EAAE,OAAOP;EAAc;CAAS,IAAI,CAACA,GAAcI,CAAQ,CAAC;CAEzF,OAAO,kBAAC1B,EAAa,UAAd;EAA8B;EAAQ;CAAgC,CAAA;AAC9E;AAEA,SAAgB8B,IAAW;CAC1B,IAAMC,IAAMC,EAAWhC,CAAY;CACnC,IAAI,CAAC+B,GACJ,MAAU,MAAM,4CAA4C;CAE7D,OAAOA;AACR"}

package/dist/styles/base.css

@@ -69,6 +69,16 @@
 		margin-left: 0;
 	}
 
+	:where(.basalt-ui:is(fieldset), .basalt-ui fieldset) {
+		min-width: 0;
+		margin: 0;
+		padding: 0;
+	}
+
+	:where(.basalt-ui:is(legend), .basalt-ui legend) {
+		padding: 0;
+	}
+
 	:where(.basalt-ui:is(ol, ul, menu), .basalt-ui :is(ol, ul, menu)) {
 		list-style: none;
 		margin: 0;
@@ -81,3 +91,121 @@
 		border-collapse: collapse;
 	}
 }
+
+@layer base {
+	[data-basalt-shell] {
+		--basalt-safe-top: env(safe-area-inset-top, 0px);
+		--basalt-sticky-top: 0px;
+		--basalt-main-height: 100%;
+		--basalt-main-overflow: hidden;
+		--basalt-island-overflow: auto;
+		--basalt-island-overscroll: contain;
+		--basalt-sidebar-height: 100%;
+		box-sizing: border-box;
+		height: 100dvh;
+		max-height: 100dvh;
+		overflow: hidden;
+		overscroll-behavior: none;
+		padding: var(--basalt-safe-top) env(safe-area-inset-right, 0px) env(safe-area-inset-bottom, 0px)
+			env(safe-area-inset-left, 0px);
+	}
+
+	[data-basalt-shell="document"] {
+		--basalt-sticky-top: var(--basalt-safe-top);
+		--basalt-main-height: auto;
+		--basalt-main-overflow: visible;
+		--basalt-island-overflow: visible;
+		--basalt-island-overscroll: auto;
+		--basalt-sidebar-height: calc(
+			100dvh -
+			var(--basalt-safe-top) -
+			env(safe-area-inset-bottom, 0px)
+		);
+		height: auto;
+		min-height: 100dvh;
+		max-height: none;
+		overflow: visible;
+		overscroll-behavior: auto;
+	}
+
+	@media (width < 768px) {
+		[data-basalt-shell="responsive"] {
+			--basalt-sticky-top: var(--basalt-safe-top);
+			--basalt-main-height: auto;
+			--basalt-main-overflow: visible;
+			--basalt-island-overflow: visible;
+			--basalt-island-overscroll: auto;
+			--basalt-sidebar-height: calc(
+				100dvh -
+				var(--basalt-safe-top) -
+				env(safe-area-inset-bottom, 0px)
+			);
+			height: auto;
+			min-height: 100dvh;
+			max-height: none;
+			overflow: visible;
+			overscroll-behavior: auto;
+		}
+	}
+
+	[data-basalt-main] {
+		height: var(--basalt-main-height, 100%);
+		overflow: var(--basalt-main-overflow, hidden);
+	}
+
+	[data-basalt-island] {
+		overflow-y: var(--basalt-island-overflow, auto);
+		overscroll-behavior-y: var(--basalt-island-overscroll, contain);
+	}
+
+	[data-basalt-sidebar] {
+		height: var(--basalt-sidebar-height, 100dvh);
+		max-height: 100dvh;
+	}
+
+	[data-basalt-sidebar]:not([data-overlay]) {
+		top: var(--basalt-sticky-top, 0px);
+	}
+}
+
+@layer base {
+	[data-basalt-sheet] {
+		--basalt-sidebar-height: 100%;
+		max-height: 100dvh;
+	}
+
+	[data-basalt-sheet] [data-basalt-sidebar],
+	[data-basalt-sidebar][data-overlay] {
+		box-sizing: border-box;
+		padding: env(safe-area-inset-top, 0px) env(safe-area-inset-right, 0px)
+			env(safe-area-inset-bottom, 0px) env(safe-area-inset-left, 0px);
+	}
+}
+
+@layer base {
+	[data-basalt-header][data-sticky] {
+		position: sticky;
+		top: var(--basalt-sticky-top, 0px);
+		z-index: 20;
+		background-color: hsl(var(--basalt-card));
+	}
+
+	[data-basalt-header][data-sticky]::before {
+		content: "";
+		position: absolute;
+		inset-inline: 0;
+		bottom: 100%;
+		height: var(--basalt-sticky-top, 0px);
+		background: inherit;
+		pointer-events: none;
+	}
+}
+
+@layer components {
+	[data-basalt-header][data-density="compact"]
+		:where([data-basalt-header-leading], [data-basalt-header-actions])
+		:where(button, a, [role="button"]) {
+		min-height: var(--basalt-size-touch);
+		min-width: var(--basalt-size-touch);
+	}
+}