@slipstream-ui/themes 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -8,6 +8,13 @@ type ThemeColors = {
8
8
  foreground: string;
9
9
  primary: string;
10
10
  'primary-foreground': string;
11
+ /**
12
+ * Readable primary for text roles (links, active nav, eyebrows) on light
13
+ * surfaces and primary/10 tints. `primary` itself stays a fill colour:
14
+ * a brand hue bright enough for a button background is too light for
15
+ * normal-size text on white.
16
+ */
17
+ 'primary-ink': string;
11
18
  secondary: string;
12
19
  'secondary-foreground': string;
13
20
  muted: string;
@@ -18,6 +25,7 @@ type ThemeColors = {
18
25
  'destructive-foreground': string;
19
26
  success: string;
20
27
  'success-foreground': string;
28
+ 'success-ink': string;
21
29
  warning: string;
22
30
  'warning-foreground': string;
23
31
  /** Status label/text colour that clears AA on a neutral surface. */
@@ -50,6 +58,12 @@ type ThemeColors = {
50
58
  type Theme = {
51
59
  name: string;
52
60
  colors: ThemeColors;
61
+ /**
62
+ * UA color scheme for this theme. Emitted as `color-scheme` so native
63
+ * chrome (scrollbars, form controls, date pickers) follows the theme
64
+ * instead of the operating system preference.
65
+ */
66
+ colorScheme?: 'light' | 'dark';
53
67
  borderRadius?: string;
54
68
  radius?: {
55
69
  lg: string;
package/dist/index.d.ts CHANGED
@@ -8,6 +8,13 @@ type ThemeColors = {
8
8
  foreground: string;
9
9
  primary: string;
10
10
  'primary-foreground': string;
11
+ /**
12
+ * Readable primary for text roles (links, active nav, eyebrows) on light
13
+ * surfaces and primary/10 tints. `primary` itself stays a fill colour:
14
+ * a brand hue bright enough for a button background is too light for
15
+ * normal-size text on white.
16
+ */
17
+ 'primary-ink': string;
11
18
  secondary: string;
12
19
  'secondary-foreground': string;
13
20
  muted: string;
@@ -18,6 +25,7 @@ type ThemeColors = {
18
25
  'destructive-foreground': string;
19
26
  success: string;
20
27
  'success-foreground': string;
28
+ 'success-ink': string;
21
29
  warning: string;
22
30
  'warning-foreground': string;
23
31
  /** Status label/text colour that clears AA on a neutral surface. */
@@ -50,6 +58,12 @@ type ThemeColors = {
50
58
  type Theme = {
51
59
  name: string;
52
60
  colors: ThemeColors;
61
+ /**
62
+ * UA color scheme for this theme. Emitted as `color-scheme` so native
63
+ * chrome (scrollbars, form controls, date pickers) follows the theme
64
+ * instead of the operating system preference.
65
+ */
66
+ colorScheme?: 'light' | 'dark';
53
67
  borderRadius?: string;
54
68
  radius?: {
55
69
  lg: string;
package/dist/index.js CHANGED
@@ -47,6 +47,9 @@ function createTheme(config = {}) {
47
47
  // passes AA both as button background and as link text)
48
48
  primary: darkMode ? lightenForDark(baseColor) : baseColor,
49
49
  "primary-foreground": darkMode ? inkForDark(baseColor) : "0 0% 100%",
50
+ // Text-safe primary: darker on light surfaces (4.5:1 on white and on a
51
+ // primary/10 tint), the already-lightened primary on dark surfaces.
52
+ "primary-ink": darkMode ? lightenForDark(baseColor) : darkenForInk(baseColor),
50
53
  // Secondary / muted / accent
51
54
  secondary: darkMode ? "220 5% 16%" : "214 45% 96%",
52
55
  "secondary-foreground": darkMode ? "220 9% 95%" : "222 47% 11%",
@@ -55,7 +58,7 @@ function createTheme(config = {}) {
55
58
  accent: darkMode ? "220 5% 16%" : "214 45% 96%",
56
59
  "accent-foreground": darkMode ? "220 9% 95%" : "222 47% 11%",
57
60
  // Destructive — dark text carries AA on bg and card; solid fills take ink
58
- destructive: darkMode ? "0 76% 64%" : "348 68% 44%",
61
+ destructive: darkMode ? "0 80% 68%" : "348 68% 43%",
59
62
  "destructive-foreground": darkMode ? "220 30% 8%" : "0 0% 100%",
60
63
  // Status colors (success / warning / info) — unitless hues.
61
64
  // Solid semantic fills carry near-black ink foregrounds: mid-luminance
@@ -63,6 +66,8 @@ function createTheme(config = {}) {
63
66
  // Axial house style anyway. Text usage (tints) is the primary path.
64
67
  success: darkMode ? "142 62% 52%" : "142 63% 32%",
65
68
  "success-foreground": darkMode ? "220 30% 8%" : "0 0% 100%",
69
+ // Ink for success text on a 10% tint: 5.6:1 on light, 7.9:1 on dark card.
70
+ "success-ink": darkMode ? "142 60% 62%" : "142 70% 26%",
66
71
  warning: darkMode ? "38 92% 60%" : "38 92% 50%",
67
72
  "warning-foreground": "26 83% 14%",
68
73
  "warning-ink": darkMode ? "38 92% 62%" : "32 90% 32%",
@@ -95,6 +100,7 @@ function createTheme(config = {}) {
95
100
  return {
96
101
  name: "custom",
97
102
  colors,
103
+ colorScheme: darkMode ? "dark" : "light",
98
104
  borderRadius,
99
105
  radius: {
100
106
  lg: borderRadius,
@@ -129,6 +135,12 @@ function lightenForDark(hsl) {
129
135
  const sat = Math.min(95, Math.max(parsed.s, 60));
130
136
  return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;
131
137
  }
138
+ function darkenForInk(hsl) {
139
+ const parsed = parseHsl(hsl);
140
+ if (!parsed) return "224 89% 40%";
141
+ const light = Math.min(45, Math.max(30, parsed.l - 18));
142
+ return `${Math.round(parsed.h)} ${Math.round(parsed.s)}% ${Math.round(light)}%`;
143
+ }
132
144
  function inkForDark(hsl) {
133
145
  const parsed = parseHsl(hsl);
134
146
  if (!parsed) return "220 30% 8%";
@@ -139,6 +151,9 @@ function themeToCssVariables(theme) {
139
151
  const cssVarName = key.replace(/([A-Z])/g, "-$1").toLowerCase();
140
152
  return `--${cssVarName}: ${value};`;
141
153
  });
154
+ if (theme.colorScheme) {
155
+ vars.unshift(`color-scheme: ${theme.colorScheme};`);
156
+ }
142
157
  const radius = theme.radius ?? {
143
158
  lg: theme.borderRadius,
144
159
  md: `calc(${theme.borderRadius} - 2px)`,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/create-theme.ts","../src/presets/default.ts","../src/presets/dark.ts","../src/presets/zinc.ts","../src/presets/violet.ts"],"sourcesContent":["export * from './types';\nexport * from './create-theme';\nexport * from './presets';\n","import type { Theme, ThemeConfig, ThemeColors } from './types';\n\n/**\n * Creates a custom theme from brand colors and configuration.\n *\n * The light/dark palettes follow the Axial-inspired house style (shared\n * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink\n * in light mode; a neutral graphite surface ladder (background < card <\n * popover, matching OpenWork / Open WebUI dark) with crisp borders and a\n * *lightened* primary in dark mode so links AND buttons both clear WCAG AA\n * on dark backgrounds.\n *\n * Hue values are unitless — percent hues invalidate the whole hsl()\n * declaration and silently drop the color.\n *\n * @example\n * ```ts\n * const theme = createTheme({\n * brandColor: '224 89% 53%',\n * borderRadius: '0.375rem',\n * darkMode: true\n * })\n * ```\n */\nexport function createTheme(config: ThemeConfig = {}): Theme {\n const {\n brandColor = '224 89% 53%',\n borderRadius = '0.375rem',\n darkMode = false,\n } = config;\n\n const baseColor = brandColor;\n\n const colors: ThemeColors = {\n // Surfaces\n background: darkMode ? '220 6% 7%' : '0 0% 100%',\n foreground: darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Primary (brand-based; derived for dark so light-blue + near-black ink\n // passes AA both as button background and as link text)\n primary: darkMode ? lightenForDark(baseColor) : baseColor,\n 'primary-foreground': darkMode ? inkForDark(baseColor) : '0 0% 100%',\n\n // Secondary / muted / accent\n secondary: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'secondary-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n muted: darkMode ? '220 5% 16%' : '214 40% 96%',\n 'muted-foreground': darkMode ? '220 6% 68%' : '219 12% 42%',\n accent: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'accent-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n\n // Destructive — dark text carries AA on bg and card; solid fills take ink\n destructive: darkMode ? '0 76% 64%' : '348 68% 44%',\n 'destructive-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n\n // Status colors (success / warning / info) — unitless hues.\n // Solid semantic fills carry near-black ink foregrounds: mid-luminance\n // colors cannot hold 4.5:1 against white, and ink-on-color is the\n // Axial house style anyway. Text usage (tints) is the primary path.\n success: darkMode ? '142 62% 52%' : '142 63% 32%',\n 'success-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n warning: darkMode ? '38 92% 60%' : '38 92% 50%',\n 'warning-foreground': '26 83% 14%',\n 'warning-ink': darkMode ? '38 92% 62%' : '32 90% 32%',\n info: darkMode ? '190 80% 58%' : '190 76% 38%',\n 'info-foreground': darkMode ? '220 30% 8%' : '222 75% 10%',\n 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',\n\n // Borders: dark gets a crisp neutral line; inputs read brighter\n border: darkMode ? '220 6% 22%' : '214 28% 89%',\n input: darkMode ? '220 6% 28%' : '214 28% 89%',\n ring: darkMode ? lightenForDark(baseColor) : baseColor,\n\n // Card / popover: elevated steps above the dark background\n card: darkMode ? '220 5% 12%' : '0 0% 100%',\n 'card-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n popover: darkMode ? '220 5% 15%' : '0 0% 100%',\n 'popover-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Inverse sections flip the surface ladder: navy in light mode, white in\n // dark mode. Section scopes these tokens onto its subtree.\n inverse: darkMode ? '0 0% 100%' : '222 85% 7%',\n 'inverse-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n 'inverse-muted': darkMode ? '214 40% 94%' : '222 45% 16%',\n 'inverse-muted-foreground': darkMode ? '219 12% 38%' : '215 20% 72%',\n 'inverse-border': darkMode ? '214 28% 82%' : '222 35% 24%',\n 'inverse-card': darkMode ? '0 0% 98%' : '222 45% 12%',\n 'inverse-card-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n // On an inverse band the normal primary is too dark in light mode; use a\n // lighter brand blue with navy ink so links and filled buttons both pass.\n 'inverse-primary': darkMode ? '224 89% 53%' : '224 92% 72%',\n 'inverse-primary-foreground': darkMode ? '0 0% 100%' : '222 85% 7%',\n };\n\n return {\n name: 'custom',\n colors,\n borderRadius,\n radius: {\n lg: borderRadius,\n md: `calc(${borderRadius} - 2px)`,\n sm: `calc(${borderRadius} - 4px)`,\n },\n density: {\n space: config.density === 'compact' ? '0.375rem' : config.density === 'relaxed' ? '0.75rem' : '0.5rem',\n controlHeight: config.density === 'compact' ? '2rem' : config.density === 'relaxed' ? '2.5rem' : '2.25rem',\n },\n motion: {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n },\n };\n}\n\n/** Parse a `H S% L%` triplet; null when the input is not a plain HSL triple. */\nfunction parseHsl(value: string): { h: number; s: number; l: number } | null {\n const parts = value.trim().split(/\\s+/);\n if (parts.length !== 3) return null;\n const [h, s, l] = parts.map((part) => parseFloat(part));\n if ([h, s, l].some((n) => Number.isNaN(n))) return null;\n return { h, s, l };\n}\n\n/**\n * Dark surfaces need a lighter primary (light-blue) so it works as link\n * text on near-black backgrounds; saturation is floored so it stays vivid.\n */\nfunction lightenForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return hsl;\n const light = Math.max(parsed.l, 70);\n const sat = Math.min(95, Math.max(parsed.s, 60));\n return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;\n}\n\n/** Matching ink (near-black, lightly tinted) for the light-blue primary. */\nfunction inkForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '220 30% 8%';\n return `${Math.round(parsed.h)} 30% 8%`;\n}\n\n/**\n * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets\n *\n * @param theme - The theme object\n * @returns A string of CSS variable declarations\n *\n * @example\n * ```ts\n * const theme = createTheme({ brandColor: '224 89% 53%' });\n * const cssVars = themeToCssVariables(theme);\n * // Returns: \"--background: 0 0% 100%; --foreground: 222 85% 7%; ...\"\n * ```\n */\nexport function themeToCssVariables(theme: Theme): string {\n const vars = Object.entries(theme.colors).map(([key, value]) => {\n const cssVarName = key.replace(/([A-Z])/g, '-$1').toLowerCase();\n return `--${cssVarName}: ${value};`;\n });\n\n // Multi-token radius: Tailwind maps rounded-{sm,md,lg} to these variables.\n const radius = theme.radius ?? {\n lg: theme.borderRadius,\n md: `calc(${theme.borderRadius} - 2px)`,\n sm: `calc(${theme.borderRadius} - 4px)`,\n };\n vars.push(`--radius: ${theme.borderRadius};`);\n vars.push(`--radius-lg: ${radius.lg};`);\n vars.push(`--radius-md: ${radius.md};`);\n vars.push(`--radius-sm: ${radius.sm};`);\n\n // Density tokens: spacing and control sizing.\n const density = theme.density ?? { space: '0.5rem', controlHeight: '2.25rem' };\n vars.push(`--density-space: ${density.space};`);\n vars.push(`--density-control-height: ${density.controlHeight};`);\n\n // Motion tokens: durations and easing curves.\n const motion = theme.motion ?? {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n };\n vars.push(`--motion-fast: ${motion.fast};`);\n vars.push(`--motion-normal: ${motion.normal};`);\n vars.push(`--motion-slow: ${motion.slow};`);\n vars.push(`--motion-ease: ${motion.ease};`);\n vars.push(`--motion-ease-in: ${motion.easeIn};`);\n vars.push(`--motion-ease-out: ${motion.easeOut};`);\n\n return vars.join('\\n ');\n}\n","import { createTheme } from '../create-theme';\n\n/**\n * Default theme with a blue brand color\n */\nexport const defaultTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Dark theme with a blue brand color\n */\nexport const darkTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Zinc theme - neutral gray tones\n */\nexport const zincTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const zincDarkTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Violet theme - purple tones\n */\nexport const violetTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const violetDarkTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/index.ts","../src/create-theme.ts","../src/presets/default.ts","../src/presets/dark.ts","../src/presets/zinc.ts","../src/presets/violet.ts"],"sourcesContent":["export * from './types';\nexport * from './create-theme';\nexport * from './presets';\n","import type { Theme, ThemeConfig, ThemeColors } from './types';\n\n/**\n * Creates a custom theme from brand colors and configuration.\n *\n * The light/dark palettes follow the Axial-inspired house style (shared\n * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink\n * in light mode; a neutral graphite surface ladder (background < card <\n * popover, matching OpenWork / Open WebUI dark) with crisp borders and a\n * *lightened* primary in dark mode so links AND buttons both clear WCAG AA\n * on dark backgrounds.\n *\n * Hue values are unitless — percent hues invalidate the whole hsl()\n * declaration and silently drop the color.\n *\n * @example\n * ```ts\n * const theme = createTheme({\n * brandColor: '224 89% 53%',\n * borderRadius: '0.375rem',\n * darkMode: true\n * })\n * ```\n */\nexport function createTheme(config: ThemeConfig = {}): Theme {\n const {\n brandColor = '224 89% 53%',\n borderRadius = '0.375rem',\n darkMode = false,\n } = config;\n\n const baseColor = brandColor;\n\n const colors: ThemeColors = {\n // Surfaces\n background: darkMode ? '220 6% 7%' : '0 0% 100%',\n foreground: darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Primary (brand-based; derived for dark so light-blue + near-black ink\n // passes AA both as button background and as link text)\n primary: darkMode ? lightenForDark(baseColor) : baseColor,\n 'primary-foreground': darkMode ? inkForDark(baseColor) : '0 0% 100%',\n // Text-safe primary: darker on light surfaces (4.5:1 on white and on a\n // primary/10 tint), the already-lightened primary on dark surfaces.\n 'primary-ink': darkMode ? lightenForDark(baseColor) : darkenForInk(baseColor),\n\n // Secondary / muted / accent\n secondary: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'secondary-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n muted: darkMode ? '220 5% 16%' : '214 40% 96%',\n 'muted-foreground': darkMode ? '220 6% 68%' : '219 12% 42%',\n accent: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'accent-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n\n // Destructive — dark text carries AA on bg and card; solid fills take ink\n destructive: darkMode ? '0 80% 68%' : '348 68% 43%',\n 'destructive-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n\n // Status colors (success / warning / info) — unitless hues.\n // Solid semantic fills carry near-black ink foregrounds: mid-luminance\n // colors cannot hold 4.5:1 against white, and ink-on-color is the\n // Axial house style anyway. Text usage (tints) is the primary path.\n success: darkMode ? '142 62% 52%' : '142 63% 32%',\n 'success-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n // Ink for success text on a 10% tint: 5.6:1 on light, 7.9:1 on dark card.\n 'success-ink': darkMode ? '142 60% 62%' : '142 70% 26%',\n warning: darkMode ? '38 92% 60%' : '38 92% 50%',\n 'warning-foreground': '26 83% 14%',\n 'warning-ink': darkMode ? '38 92% 62%' : '32 90% 32%',\n info: darkMode ? '190 80% 58%' : '190 76% 38%',\n 'info-foreground': darkMode ? '220 30% 8%' : '222 75% 10%',\n 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',\n\n // Borders: dark gets a crisp neutral line; inputs read brighter\n border: darkMode ? '220 6% 22%' : '214 28% 89%',\n input: darkMode ? '220 6% 28%' : '214 28% 89%',\n ring: darkMode ? lightenForDark(baseColor) : baseColor,\n\n // Card / popover: elevated steps above the dark background\n card: darkMode ? '220 5% 12%' : '0 0% 100%',\n 'card-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n popover: darkMode ? '220 5% 15%' : '0 0% 100%',\n 'popover-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Inverse sections flip the surface ladder: navy in light mode, white in\n // dark mode. Section scopes these tokens onto its subtree.\n inverse: darkMode ? '0 0% 100%' : '222 85% 7%',\n 'inverse-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n 'inverse-muted': darkMode ? '214 40% 94%' : '222 45% 16%',\n 'inverse-muted-foreground': darkMode ? '219 12% 38%' : '215 20% 72%',\n 'inverse-border': darkMode ? '214 28% 82%' : '222 35% 24%',\n 'inverse-card': darkMode ? '0 0% 98%' : '222 45% 12%',\n 'inverse-card-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n // On an inverse band the normal primary is too dark in light mode; use a\n // lighter brand blue with navy ink so links and filled buttons both pass.\n 'inverse-primary': darkMode ? '224 89% 53%' : '224 92% 72%',\n 'inverse-primary-foreground': darkMode ? '0 0% 100%' : '222 85% 7%',\n };\n\n return {\n name: 'custom',\n colors,\n colorScheme: darkMode ? 'dark' : 'light',\n borderRadius,\n radius: {\n lg: borderRadius,\n md: `calc(${borderRadius} - 2px)`,\n sm: `calc(${borderRadius} - 4px)`,\n },\n density: {\n space: config.density === 'compact' ? '0.375rem' : config.density === 'relaxed' ? '0.75rem' : '0.5rem',\n controlHeight: config.density === 'compact' ? '2rem' : config.density === 'relaxed' ? '2.5rem' : '2.25rem',\n },\n motion: {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n },\n };\n}\n\n/** Parse a `H S% L%` triplet; null when the input is not a plain HSL triple. */\nfunction parseHsl(value: string): { h: number; s: number; l: number } | null {\n const parts = value.trim().split(/\\s+/);\n if (parts.length !== 3) return null;\n const [h, s, l] = parts.map((part) => parseFloat(part));\n if ([h, s, l].some((n) => Number.isNaN(n))) return null;\n return { h, s, l };\n}\n\n/**\n * Dark surfaces need a lighter primary (light-blue) so it works as link\n * text on near-black backgrounds; saturation is floored so it stays vivid.\n */\nfunction lightenForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return hsl;\n const light = Math.max(parsed.l, 70);\n const sat = Math.min(95, Math.max(parsed.s, 60));\n return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;\n}\n\n/**\n * Light surfaces need a darker primary for text. Eighteen points below the\n * fill colour clears 4.5:1 on white and on a 10% brand tint for the Utah\n * blue (58% -> 40%); the floor keeps very light brands readable.\n */\nfunction darkenForInk(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '224 89% 40%';\n const light = Math.min(45, Math.max(30, parsed.l - 18));\n return `${Math.round(parsed.h)} ${Math.round(parsed.s)}% ${Math.round(light)}%`;\n}\n\n/** Matching ink (near-black, lightly tinted) for the light-blue primary. */\nfunction inkForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '220 30% 8%';\n return `${Math.round(parsed.h)} 30% 8%`;\n}\n\n/**\n * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets\n *\n * @param theme - The theme object\n * @returns A string of CSS variable declarations\n *\n * @example\n * ```ts\n * const theme = createTheme({ brandColor: '224 89% 53%' });\n * const cssVars = themeToCssVariables(theme);\n * // Returns: \"--background: 0 0% 100%; --foreground: 222 85% 7%; ...\"\n * ```\n */\nexport function themeToCssVariables(theme: Theme): string {\n const vars = Object.entries(theme.colors).map(([key, value]) => {\n const cssVarName = key.replace(/([A-Z])/g, '-$1').toLowerCase();\n return `--${cssVarName}: ${value};`;\n });\n\n // Native chrome follows the theme, not the OS: an unset color-scheme lets a\n // dark OS preference paint dark scrollbars and form controls in light mode.\n if (theme.colorScheme) {\n vars.unshift(`color-scheme: ${theme.colorScheme};`);\n }\n\n // Multi-token radius: Tailwind maps rounded-{sm,md,lg} to these variables.\n const radius = theme.radius ?? {\n lg: theme.borderRadius,\n md: `calc(${theme.borderRadius} - 2px)`,\n sm: `calc(${theme.borderRadius} - 4px)`,\n };\n vars.push(`--radius: ${theme.borderRadius};`);\n vars.push(`--radius-lg: ${radius.lg};`);\n vars.push(`--radius-md: ${radius.md};`);\n vars.push(`--radius-sm: ${radius.sm};`);\n\n // Density tokens: spacing and control sizing.\n const density = theme.density ?? { space: '0.5rem', controlHeight: '2.25rem' };\n vars.push(`--density-space: ${density.space};`);\n vars.push(`--density-control-height: ${density.controlHeight};`);\n\n // Motion tokens: durations and easing curves.\n const motion = theme.motion ?? {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n };\n vars.push(`--motion-fast: ${motion.fast};`);\n vars.push(`--motion-normal: ${motion.normal};`);\n vars.push(`--motion-slow: ${motion.slow};`);\n vars.push(`--motion-ease: ${motion.ease};`);\n vars.push(`--motion-ease-in: ${motion.easeIn};`);\n vars.push(`--motion-ease-out: ${motion.easeOut};`);\n\n return vars.join('\\n ');\n}\n","import { createTheme } from '../create-theme';\n\n/**\n * Default theme with a blue brand color\n */\nexport const defaultTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Dark theme with a blue brand color\n */\nexport const darkTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Zinc theme - neutral gray tones\n */\nexport const zincTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const zincDarkTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Violet theme - purple tones\n */\nexport const violetTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const violetDarkTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n"],"mappings":"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","names":[]}
package/dist/index.mjs CHANGED
@@ -14,6 +14,9 @@ function createTheme(config = {}) {
14
14
  // passes AA both as button background and as link text)
15
15
  primary: darkMode ? lightenForDark(baseColor) : baseColor,
16
16
  "primary-foreground": darkMode ? inkForDark(baseColor) : "0 0% 100%",
17
+ // Text-safe primary: darker on light surfaces (4.5:1 on white and on a
18
+ // primary/10 tint), the already-lightened primary on dark surfaces.
19
+ "primary-ink": darkMode ? lightenForDark(baseColor) : darkenForInk(baseColor),
17
20
  // Secondary / muted / accent
18
21
  secondary: darkMode ? "220 5% 16%" : "214 45% 96%",
19
22
  "secondary-foreground": darkMode ? "220 9% 95%" : "222 47% 11%",
@@ -22,7 +25,7 @@ function createTheme(config = {}) {
22
25
  accent: darkMode ? "220 5% 16%" : "214 45% 96%",
23
26
  "accent-foreground": darkMode ? "220 9% 95%" : "222 47% 11%",
24
27
  // Destructive — dark text carries AA on bg and card; solid fills take ink
25
- destructive: darkMode ? "0 76% 64%" : "348 68% 44%",
28
+ destructive: darkMode ? "0 80% 68%" : "348 68% 43%",
26
29
  "destructive-foreground": darkMode ? "220 30% 8%" : "0 0% 100%",
27
30
  // Status colors (success / warning / info) — unitless hues.
28
31
  // Solid semantic fills carry near-black ink foregrounds: mid-luminance
@@ -30,6 +33,8 @@ function createTheme(config = {}) {
30
33
  // Axial house style anyway. Text usage (tints) is the primary path.
31
34
  success: darkMode ? "142 62% 52%" : "142 63% 32%",
32
35
  "success-foreground": darkMode ? "220 30% 8%" : "0 0% 100%",
36
+ // Ink for success text on a 10% tint: 5.6:1 on light, 7.9:1 on dark card.
37
+ "success-ink": darkMode ? "142 60% 62%" : "142 70% 26%",
33
38
  warning: darkMode ? "38 92% 60%" : "38 92% 50%",
34
39
  "warning-foreground": "26 83% 14%",
35
40
  "warning-ink": darkMode ? "38 92% 62%" : "32 90% 32%",
@@ -62,6 +67,7 @@ function createTheme(config = {}) {
62
67
  return {
63
68
  name: "custom",
64
69
  colors,
70
+ colorScheme: darkMode ? "dark" : "light",
65
71
  borderRadius,
66
72
  radius: {
67
73
  lg: borderRadius,
@@ -96,6 +102,12 @@ function lightenForDark(hsl) {
96
102
  const sat = Math.min(95, Math.max(parsed.s, 60));
97
103
  return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;
98
104
  }
105
+ function darkenForInk(hsl) {
106
+ const parsed = parseHsl(hsl);
107
+ if (!parsed) return "224 89% 40%";
108
+ const light = Math.min(45, Math.max(30, parsed.l - 18));
109
+ return `${Math.round(parsed.h)} ${Math.round(parsed.s)}% ${Math.round(light)}%`;
110
+ }
99
111
  function inkForDark(hsl) {
100
112
  const parsed = parseHsl(hsl);
101
113
  if (!parsed) return "220 30% 8%";
@@ -106,6 +118,9 @@ function themeToCssVariables(theme) {
106
118
  const cssVarName = key.replace(/([A-Z])/g, "-$1").toLowerCase();
107
119
  return `--${cssVarName}: ${value};`;
108
120
  });
121
+ if (theme.colorScheme) {
122
+ vars.unshift(`color-scheme: ${theme.colorScheme};`);
123
+ }
109
124
  const radius = theme.radius ?? {
110
125
  lg: theme.borderRadius,
111
126
  md: `calc(${theme.borderRadius} - 2px)`,
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/create-theme.ts","../src/presets/default.ts","../src/presets/dark.ts","../src/presets/zinc.ts","../src/presets/violet.ts"],"sourcesContent":["import type { Theme, ThemeConfig, ThemeColors } from './types';\n\n/**\n * Creates a custom theme from brand colors and configuration.\n *\n * The light/dark palettes follow the Axial-inspired house style (shared\n * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink\n * in light mode; a neutral graphite surface ladder (background < card <\n * popover, matching OpenWork / Open WebUI dark) with crisp borders and a\n * *lightened* primary in dark mode so links AND buttons both clear WCAG AA\n * on dark backgrounds.\n *\n * Hue values are unitless — percent hues invalidate the whole hsl()\n * declaration and silently drop the color.\n *\n * @example\n * ```ts\n * const theme = createTheme({\n * brandColor: '224 89% 53%',\n * borderRadius: '0.375rem',\n * darkMode: true\n * })\n * ```\n */\nexport function createTheme(config: ThemeConfig = {}): Theme {\n const {\n brandColor = '224 89% 53%',\n borderRadius = '0.375rem',\n darkMode = false,\n } = config;\n\n const baseColor = brandColor;\n\n const colors: ThemeColors = {\n // Surfaces\n background: darkMode ? '220 6% 7%' : '0 0% 100%',\n foreground: darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Primary (brand-based; derived for dark so light-blue + near-black ink\n // passes AA both as button background and as link text)\n primary: darkMode ? lightenForDark(baseColor) : baseColor,\n 'primary-foreground': darkMode ? inkForDark(baseColor) : '0 0% 100%',\n\n // Secondary / muted / accent\n secondary: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'secondary-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n muted: darkMode ? '220 5% 16%' : '214 40% 96%',\n 'muted-foreground': darkMode ? '220 6% 68%' : '219 12% 42%',\n accent: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'accent-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n\n // Destructive — dark text carries AA on bg and card; solid fills take ink\n destructive: darkMode ? '0 76% 64%' : '348 68% 44%',\n 'destructive-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n\n // Status colors (success / warning / info) — unitless hues.\n // Solid semantic fills carry near-black ink foregrounds: mid-luminance\n // colors cannot hold 4.5:1 against white, and ink-on-color is the\n // Axial house style anyway. Text usage (tints) is the primary path.\n success: darkMode ? '142 62% 52%' : '142 63% 32%',\n 'success-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n warning: darkMode ? '38 92% 60%' : '38 92% 50%',\n 'warning-foreground': '26 83% 14%',\n 'warning-ink': darkMode ? '38 92% 62%' : '32 90% 32%',\n info: darkMode ? '190 80% 58%' : '190 76% 38%',\n 'info-foreground': darkMode ? '220 30% 8%' : '222 75% 10%',\n 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',\n\n // Borders: dark gets a crisp neutral line; inputs read brighter\n border: darkMode ? '220 6% 22%' : '214 28% 89%',\n input: darkMode ? '220 6% 28%' : '214 28% 89%',\n ring: darkMode ? lightenForDark(baseColor) : baseColor,\n\n // Card / popover: elevated steps above the dark background\n card: darkMode ? '220 5% 12%' : '0 0% 100%',\n 'card-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n popover: darkMode ? '220 5% 15%' : '0 0% 100%',\n 'popover-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Inverse sections flip the surface ladder: navy in light mode, white in\n // dark mode. Section scopes these tokens onto its subtree.\n inverse: darkMode ? '0 0% 100%' : '222 85% 7%',\n 'inverse-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n 'inverse-muted': darkMode ? '214 40% 94%' : '222 45% 16%',\n 'inverse-muted-foreground': darkMode ? '219 12% 38%' : '215 20% 72%',\n 'inverse-border': darkMode ? '214 28% 82%' : '222 35% 24%',\n 'inverse-card': darkMode ? '0 0% 98%' : '222 45% 12%',\n 'inverse-card-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n // On an inverse band the normal primary is too dark in light mode; use a\n // lighter brand blue with navy ink so links and filled buttons both pass.\n 'inverse-primary': darkMode ? '224 89% 53%' : '224 92% 72%',\n 'inverse-primary-foreground': darkMode ? '0 0% 100%' : '222 85% 7%',\n };\n\n return {\n name: 'custom',\n colors,\n borderRadius,\n radius: {\n lg: borderRadius,\n md: `calc(${borderRadius} - 2px)`,\n sm: `calc(${borderRadius} - 4px)`,\n },\n density: {\n space: config.density === 'compact' ? '0.375rem' : config.density === 'relaxed' ? '0.75rem' : '0.5rem',\n controlHeight: config.density === 'compact' ? '2rem' : config.density === 'relaxed' ? '2.5rem' : '2.25rem',\n },\n motion: {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n },\n };\n}\n\n/** Parse a `H S% L%` triplet; null when the input is not a plain HSL triple. */\nfunction parseHsl(value: string): { h: number; s: number; l: number } | null {\n const parts = value.trim().split(/\\s+/);\n if (parts.length !== 3) return null;\n const [h, s, l] = parts.map((part) => parseFloat(part));\n if ([h, s, l].some((n) => Number.isNaN(n))) return null;\n return { h, s, l };\n}\n\n/**\n * Dark surfaces need a lighter primary (light-blue) so it works as link\n * text on near-black backgrounds; saturation is floored so it stays vivid.\n */\nfunction lightenForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return hsl;\n const light = Math.max(parsed.l, 70);\n const sat = Math.min(95, Math.max(parsed.s, 60));\n return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;\n}\n\n/** Matching ink (near-black, lightly tinted) for the light-blue primary. */\nfunction inkForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '220 30% 8%';\n return `${Math.round(parsed.h)} 30% 8%`;\n}\n\n/**\n * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets\n *\n * @param theme - The theme object\n * @returns A string of CSS variable declarations\n *\n * @example\n * ```ts\n * const theme = createTheme({ brandColor: '224 89% 53%' });\n * const cssVars = themeToCssVariables(theme);\n * // Returns: \"--background: 0 0% 100%; --foreground: 222 85% 7%; ...\"\n * ```\n */\nexport function themeToCssVariables(theme: Theme): string {\n const vars = Object.entries(theme.colors).map(([key, value]) => {\n const cssVarName = key.replace(/([A-Z])/g, '-$1').toLowerCase();\n return `--${cssVarName}: ${value};`;\n });\n\n // Multi-token radius: Tailwind maps rounded-{sm,md,lg} to these variables.\n const radius = theme.radius ?? {\n lg: theme.borderRadius,\n md: `calc(${theme.borderRadius} - 2px)`,\n sm: `calc(${theme.borderRadius} - 4px)`,\n };\n vars.push(`--radius: ${theme.borderRadius};`);\n vars.push(`--radius-lg: ${radius.lg};`);\n vars.push(`--radius-md: ${radius.md};`);\n vars.push(`--radius-sm: ${radius.sm};`);\n\n // Density tokens: spacing and control sizing.\n const density = theme.density ?? { space: '0.5rem', controlHeight: '2.25rem' };\n vars.push(`--density-space: ${density.space};`);\n vars.push(`--density-control-height: ${density.controlHeight};`);\n\n // Motion tokens: durations and easing curves.\n const motion = theme.motion ?? {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n };\n vars.push(`--motion-fast: ${motion.fast};`);\n vars.push(`--motion-normal: ${motion.normal};`);\n vars.push(`--motion-slow: ${motion.slow};`);\n vars.push(`--motion-ease: ${motion.ease};`);\n vars.push(`--motion-ease-in: ${motion.easeIn};`);\n vars.push(`--motion-ease-out: ${motion.easeOut};`);\n\n return vars.join('\\n ');\n}\n","import { createTheme } from '../create-theme';\n\n/**\n * Default theme with a blue brand color\n */\nexport const defaultTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Dark theme with a blue brand color\n */\nexport const darkTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Zinc theme - neutral gray tones\n */\nexport const zincTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const zincDarkTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Violet theme - purple tones\n */\nexport const violetTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const violetDarkTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/create-theme.ts","../src/presets/default.ts","../src/presets/dark.ts","../src/presets/zinc.ts","../src/presets/violet.ts"],"sourcesContent":["import type { Theme, ThemeConfig, ThemeColors } from './types';\n\n/**\n * Creates a custom theme from brand colors and configuration.\n *\n * The light/dark palettes follow the Axial-inspired house style (shared\n * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink\n * in light mode; a neutral graphite surface ladder (background < card <\n * popover, matching OpenWork / Open WebUI dark) with crisp borders and a\n * *lightened* primary in dark mode so links AND buttons both clear WCAG AA\n * on dark backgrounds.\n *\n * Hue values are unitless — percent hues invalidate the whole hsl()\n * declaration and silently drop the color.\n *\n * @example\n * ```ts\n * const theme = createTheme({\n * brandColor: '224 89% 53%',\n * borderRadius: '0.375rem',\n * darkMode: true\n * })\n * ```\n */\nexport function createTheme(config: ThemeConfig = {}): Theme {\n const {\n brandColor = '224 89% 53%',\n borderRadius = '0.375rem',\n darkMode = false,\n } = config;\n\n const baseColor = brandColor;\n\n const colors: ThemeColors = {\n // Surfaces\n background: darkMode ? '220 6% 7%' : '0 0% 100%',\n foreground: darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Primary (brand-based; derived for dark so light-blue + near-black ink\n // passes AA both as button background and as link text)\n primary: darkMode ? lightenForDark(baseColor) : baseColor,\n 'primary-foreground': darkMode ? inkForDark(baseColor) : '0 0% 100%',\n // Text-safe primary: darker on light surfaces (4.5:1 on white and on a\n // primary/10 tint), the already-lightened primary on dark surfaces.\n 'primary-ink': darkMode ? lightenForDark(baseColor) : darkenForInk(baseColor),\n\n // Secondary / muted / accent\n secondary: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'secondary-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n muted: darkMode ? '220 5% 16%' : '214 40% 96%',\n 'muted-foreground': darkMode ? '220 6% 68%' : '219 12% 42%',\n accent: darkMode ? '220 5% 16%' : '214 45% 96%',\n 'accent-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',\n\n // Destructive — dark text carries AA on bg and card; solid fills take ink\n destructive: darkMode ? '0 80% 68%' : '348 68% 43%',\n 'destructive-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n\n // Status colors (success / warning / info) — unitless hues.\n // Solid semantic fills carry near-black ink foregrounds: mid-luminance\n // colors cannot hold 4.5:1 against white, and ink-on-color is the\n // Axial house style anyway. Text usage (tints) is the primary path.\n success: darkMode ? '142 62% 52%' : '142 63% 32%',\n 'success-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',\n // Ink for success text on a 10% tint: 5.6:1 on light, 7.9:1 on dark card.\n 'success-ink': darkMode ? '142 60% 62%' : '142 70% 26%',\n warning: darkMode ? '38 92% 60%' : '38 92% 50%',\n 'warning-foreground': '26 83% 14%',\n 'warning-ink': darkMode ? '38 92% 62%' : '32 90% 32%',\n info: darkMode ? '190 80% 58%' : '190 76% 38%',\n 'info-foreground': darkMode ? '220 30% 8%' : '222 75% 10%',\n 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',\n\n // Borders: dark gets a crisp neutral line; inputs read brighter\n border: darkMode ? '220 6% 22%' : '214 28% 89%',\n input: darkMode ? '220 6% 28%' : '214 28% 89%',\n ring: darkMode ? lightenForDark(baseColor) : baseColor,\n\n // Card / popover: elevated steps above the dark background\n card: darkMode ? '220 5% 12%' : '0 0% 100%',\n 'card-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n popover: darkMode ? '220 5% 15%' : '0 0% 100%',\n 'popover-foreground': darkMode ? '220 9% 95%' : '222 85% 7%',\n\n // Inverse sections flip the surface ladder: navy in light mode, white in\n // dark mode. Section scopes these tokens onto its subtree.\n inverse: darkMode ? '0 0% 100%' : '222 85% 7%',\n 'inverse-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n 'inverse-muted': darkMode ? '214 40% 94%' : '222 45% 16%',\n 'inverse-muted-foreground': darkMode ? '219 12% 38%' : '215 20% 72%',\n 'inverse-border': darkMode ? '214 28% 82%' : '222 35% 24%',\n 'inverse-card': darkMode ? '0 0% 98%' : '222 45% 12%',\n 'inverse-card-foreground': darkMode ? '222 85% 7%' : '0 0% 100%',\n // On an inverse band the normal primary is too dark in light mode; use a\n // lighter brand blue with navy ink so links and filled buttons both pass.\n 'inverse-primary': darkMode ? '224 89% 53%' : '224 92% 72%',\n 'inverse-primary-foreground': darkMode ? '0 0% 100%' : '222 85% 7%',\n };\n\n return {\n name: 'custom',\n colors,\n colorScheme: darkMode ? 'dark' : 'light',\n borderRadius,\n radius: {\n lg: borderRadius,\n md: `calc(${borderRadius} - 2px)`,\n sm: `calc(${borderRadius} - 4px)`,\n },\n density: {\n space: config.density === 'compact' ? '0.375rem' : config.density === 'relaxed' ? '0.75rem' : '0.5rem',\n controlHeight: config.density === 'compact' ? '2rem' : config.density === 'relaxed' ? '2.5rem' : '2.25rem',\n },\n motion: {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n },\n };\n}\n\n/** Parse a `H S% L%` triplet; null when the input is not a plain HSL triple. */\nfunction parseHsl(value: string): { h: number; s: number; l: number } | null {\n const parts = value.trim().split(/\\s+/);\n if (parts.length !== 3) return null;\n const [h, s, l] = parts.map((part) => parseFloat(part));\n if ([h, s, l].some((n) => Number.isNaN(n))) return null;\n return { h, s, l };\n}\n\n/**\n * Dark surfaces need a lighter primary (light-blue) so it works as link\n * text on near-black backgrounds; saturation is floored so it stays vivid.\n */\nfunction lightenForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return hsl;\n const light = Math.max(parsed.l, 70);\n const sat = Math.min(95, Math.max(parsed.s, 60));\n return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;\n}\n\n/**\n * Light surfaces need a darker primary for text. Eighteen points below the\n * fill colour clears 4.5:1 on white and on a 10% brand tint for the Utah\n * blue (58% -> 40%); the floor keeps very light brands readable.\n */\nfunction darkenForInk(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '224 89% 40%';\n const light = Math.min(45, Math.max(30, parsed.l - 18));\n return `${Math.round(parsed.h)} ${Math.round(parsed.s)}% ${Math.round(light)}%`;\n}\n\n/** Matching ink (near-black, lightly tinted) for the light-blue primary. */\nfunction inkForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '220 30% 8%';\n return `${Math.round(parsed.h)} 30% 8%`;\n}\n\n/**\n * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets\n *\n * @param theme - The theme object\n * @returns A string of CSS variable declarations\n *\n * @example\n * ```ts\n * const theme = createTheme({ brandColor: '224 89% 53%' });\n * const cssVars = themeToCssVariables(theme);\n * // Returns: \"--background: 0 0% 100%; --foreground: 222 85% 7%; ...\"\n * ```\n */\nexport function themeToCssVariables(theme: Theme): string {\n const vars = Object.entries(theme.colors).map(([key, value]) => {\n const cssVarName = key.replace(/([A-Z])/g, '-$1').toLowerCase();\n return `--${cssVarName}: ${value};`;\n });\n\n // Native chrome follows the theme, not the OS: an unset color-scheme lets a\n // dark OS preference paint dark scrollbars and form controls in light mode.\n if (theme.colorScheme) {\n vars.unshift(`color-scheme: ${theme.colorScheme};`);\n }\n\n // Multi-token radius: Tailwind maps rounded-{sm,md,lg} to these variables.\n const radius = theme.radius ?? {\n lg: theme.borderRadius,\n md: `calc(${theme.borderRadius} - 2px)`,\n sm: `calc(${theme.borderRadius} - 4px)`,\n };\n vars.push(`--radius: ${theme.borderRadius};`);\n vars.push(`--radius-lg: ${radius.lg};`);\n vars.push(`--radius-md: ${radius.md};`);\n vars.push(`--radius-sm: ${radius.sm};`);\n\n // Density tokens: spacing and control sizing.\n const density = theme.density ?? { space: '0.5rem', controlHeight: '2.25rem' };\n vars.push(`--density-space: ${density.space};`);\n vars.push(`--density-control-height: ${density.controlHeight};`);\n\n // Motion tokens: durations and easing curves.\n const motion = theme.motion ?? {\n fast: '150ms',\n normal: '250ms',\n slow: '400ms',\n ease: 'cubic-bezier(0.4, 0, 0.2, 1)',\n easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',\n easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',\n };\n vars.push(`--motion-fast: ${motion.fast};`);\n vars.push(`--motion-normal: ${motion.normal};`);\n vars.push(`--motion-slow: ${motion.slow};`);\n vars.push(`--motion-ease: ${motion.ease};`);\n vars.push(`--motion-ease-in: ${motion.easeIn};`);\n vars.push(`--motion-ease-out: ${motion.easeOut};`);\n\n return vars.join('\\n ');\n}\n","import { createTheme } from '../create-theme';\n\n/**\n * Default theme with a blue brand color\n */\nexport const defaultTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Dark theme with a blue brand color\n */\nexport const darkTheme = createTheme({\n brandColor: '224 89% 53%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Zinc theme - neutral gray tones\n */\nexport const zincTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const zincDarkTheme = createTheme({\n brandColor: '240 5% 65%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n","import { createTheme } from '../create-theme';\n\n/**\n * Violet theme - purple tones\n */\nexport const violetTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: false,\n});\n\nexport const violetDarkTheme = createTheme({\n brandColor: '263 70% 50%',\n borderRadius: '0.375rem',\n darkMode: true,\n});\n"],"mappings":"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","names":[]}
package/dist/styles.css CHANGED
@@ -3,20 +3,23 @@
3
3
  * Generated by packages/themes/scripts/build-css.mjs - do not edit by hand.
4
4
  */
5
5
  :root {
6
- --background: 0 0% 100%;
6
+ color-scheme: light;
7
+ --background: 0 0% 100%;
7
8
  --foreground: 222 85% 7%;
8
9
  --primary: 224 89% 53%;
9
10
  --primary-foreground: 0 0% 100%;
11
+ --primary-ink: 224 89% 35%;
10
12
  --secondary: 214 45% 96%;
11
13
  --secondary-foreground: 222 47% 11%;
12
14
  --muted: 214 40% 96%;
13
15
  --muted-foreground: 219 12% 42%;
14
16
  --accent: 214 45% 96%;
15
17
  --accent-foreground: 222 47% 11%;
16
- --destructive: 348 68% 44%;
18
+ --destructive: 348 68% 43%;
17
19
  --destructive-foreground: 0 0% 100%;
18
20
  --success: 142 63% 32%;
19
21
  --success-foreground: 0 0% 100%;
22
+ --success-ink: 142 70% 26%;
20
23
  --warning: 38 92% 50%;
21
24
  --warning-foreground: 26 83% 14%;
22
25
  --warning-ink: 32 90% 32%;
@@ -55,20 +58,23 @@
55
58
 
56
59
  .dark,
57
60
  [data-theme='dark'] {
58
- --background: 220 6% 7%;
61
+ color-scheme: dark;
62
+ --background: 220 6% 7%;
59
63
  --foreground: 220 9% 95%;
60
64
  --primary: 224 89% 70%;
61
65
  --primary-foreground: 224 30% 8%;
66
+ --primary-ink: 224 89% 70%;
62
67
  --secondary: 220 5% 16%;
63
68
  --secondary-foreground: 220 9% 95%;
64
69
  --muted: 220 5% 16%;
65
70
  --muted-foreground: 220 6% 68%;
66
71
  --accent: 220 5% 16%;
67
72
  --accent-foreground: 220 9% 95%;
68
- --destructive: 0 76% 64%;
73
+ --destructive: 0 80% 68%;
69
74
  --destructive-foreground: 220 30% 8%;
70
75
  --success: 142 62% 52%;
71
76
  --success-foreground: 220 30% 8%;
77
+ --success-ink: 142 60% 62%;
72
78
  --warning: 38 92% 60%;
73
79
  --warning-foreground: 26 83% 14%;
74
80
  --warning-ink: 38 92% 62%;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@slipstream-ui/themes",
3
- "version": "0.8.0",
3
+ "version": "0.10.0",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/michaelmcshinsky/slipstream-ui.git",
@@ -42,13 +42,16 @@
42
42
  "eslint": "^8.56.0",
43
43
  "tsup": "^9.0.0",
44
44
  "typescript": "^5.3.3",
45
+ "vitest": "^5.0.5",
45
46
  "@slipstream-ui/eslint-config": "0.0.1",
46
- "@slipstream-ui/typescript-config": "0.0.1"
47
+ "@slipstream-ui/typescript-config": "0.0.1",
48
+ "@slipstream-ui/vitest-config": "0.0.1"
47
49
  },
48
50
  "scripts": {
49
51
  "build": "tsup && node scripts/build-css.mjs",
50
52
  "dev": "tsup --watch",
51
53
  "typecheck": "tsc --noEmit",
52
- "lint": "eslint src --ext .ts,.tsx"
54
+ "lint": "eslint src --ext .ts,.tsx",
55
+ "test": "vitest run"
53
56
  }
54
57
  }
@@ -0,0 +1,112 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { createTheme } from './create-theme';
3
+
4
+ type Rgb = [number, number, number];
5
+
6
+ /** Parses the theme's unitless "H S% L%" strings. */
7
+ function parseHsl(value: string): [number, number, number] {
8
+ const [h, s, l] = value.trim().split(/\s+/);
9
+ return [Number(h), Number(s.replace('%', '')) / 100, Number(l.replace('%', '')) / 100];
10
+ }
11
+
12
+ function hslToRgb(value: string): Rgb {
13
+ const [h, s, l] = parseHsl(value);
14
+ const c = (1 - Math.abs(2 * l - 1)) * s;
15
+ const hp = h / 60;
16
+ const x = c * (1 - Math.abs((hp % 2) - 1));
17
+ const m = l - c / 2;
18
+ let rgb: Rgb;
19
+ if (hp < 1) rgb = [c, x, 0];
20
+ else if (hp < 2) rgb = [x, c, 0];
21
+ else if (hp < 3) rgb = [0, c, x];
22
+ else if (hp < 4) rgb = [0, x, c];
23
+ else if (hp < 5) rgb = [x, 0, c];
24
+ else rgb = [c, 0, x];
25
+ return rgb.map((channel) => channel + m) as Rgb;
26
+ }
27
+
28
+ function luminance([r, g, b]: Rgb): number {
29
+ const linear = (channel: number) =>
30
+ channel <= 0.03928 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
31
+ return 0.2126 * linear(r) + 0.7152 * linear(g) + 0.0722 * linear(b);
32
+ }
33
+
34
+ function contrast(a: Rgb, b: Rgb): number {
35
+ const [light, dark] = [luminance(a), luminance(b)].sort((x, y) => y - x);
36
+ return (light + 0.05) / (dark + 0.05);
37
+ }
38
+
39
+ /** Composites a colour at `alpha` over an opaque background. */
40
+ function over(foreground: string, background: Rgb, alpha: number): Rgb {
41
+ const fg = hslToRgb(foreground);
42
+ return fg.map((channel, index) => channel * alpha + background[index] * (1 - alpha)) as Rgb;
43
+ }
44
+
45
+ const WHITE: Rgb = [1, 1, 1];
46
+
47
+ describe('semantic ink tokens', () => {
48
+ it('success ink clears 4.5:1 on a 10% success tint over white', () => {
49
+ const theme = createTheme();
50
+ const tint = over(theme.colors.success, WHITE, 0.1);
51
+ expect(contrast(hslToRgb(theme.colors['success-ink']), tint)).toBeGreaterThanOrEqual(4.5);
52
+ });
53
+
54
+ it('plain success text does not clear 4.5:1 on that tint', () => {
55
+ const theme = createTheme();
56
+ const tint = over(theme.colors.success, WHITE, 0.1);
57
+ // The reason the ink token exists; if this ever passes, revisit the token.
58
+ expect(contrast(hslToRgb(theme.colors.success), tint)).toBeLessThan(4.5);
59
+ });
60
+
61
+ it('success ink clears 4.5:1 on a 10% tint over the dark card', () => {
62
+ const theme = createTheme({ darkMode: true });
63
+ const card = hslToRgb(theme.colors.card);
64
+ const tint = over(theme.colors.success, card, 0.1);
65
+ expect(contrast(hslToRgb(theme.colors['success-ink']), tint)).toBeGreaterThanOrEqual(4.5);
66
+ });
67
+
68
+ it('warning and info inks keep their 4.5:1 contract on tints', () => {
69
+ for (const mode of [false, true]) {
70
+ const theme = createTheme({ darkMode: mode });
71
+ const surface = mode ? hslToRgb(theme.colors.card) : WHITE;
72
+ for (const token of ['warning', 'info'] as const) {
73
+ const tint = over(theme.colors[token], surface, 0.1);
74
+ const ink = theme.colors[`${token}-ink` as 'warning-ink' | 'info-ink'];
75
+ expect(contrast(hslToRgb(ink), tint)).toBeGreaterThanOrEqual(4.5);
76
+ }
77
+ }
78
+ });
79
+
80
+
81
+ it('destructive text clears 4.5:1 on the popover surface', () => {
82
+ for (const mode of [false, true]) {
83
+ const theme = createTheme({ darkMode: mode });
84
+ expect(
85
+ contrast(hslToRgb(theme.colors.destructive), hslToRgb(theme.colors.popover))
86
+ ).toBeGreaterThanOrEqual(4.5);
87
+ }
88
+ });
89
+
90
+ it('primary ink clears 4.5:1 on white and on a primary tint', () => {
91
+ const theme = createTheme({ brandColor: '224 89% 58%' });
92
+ const tint = over(theme.colors.primary, WHITE, 0.1);
93
+ expect(contrast(hslToRgb(theme.colors['primary-ink']), WHITE)).toBeGreaterThanOrEqual(4.5);
94
+ expect(contrast(hslToRgb(theme.colors['primary-ink']), tint)).toBeGreaterThanOrEqual(4.5);
95
+ });
96
+
97
+ it('dark-mode primary ink clears 4.5:1 on the dark card', () => {
98
+ const theme = createTheme({ brandColor: '224 89% 58%', darkMode: true });
99
+ expect(
100
+ contrast(hslToRgb(theme.colors['primary-ink']), hslToRgb(theme.colors.card))
101
+ ).toBeGreaterThanOrEqual(4.5);
102
+ });
103
+
104
+ it('every theme colour parses as unitless HSL', () => {
105
+ for (const mode of [false, true]) {
106
+ const theme = createTheme({ darkMode: mode });
107
+ for (const [name, value] of Object.entries(theme.colors)) {
108
+ expect(value, name).toMatch(/^\d+(\.\d+)? \d+(\.\d+)?% \d+(\.\d+)?%$/);
109
+ }
110
+ }
111
+ });
112
+ });
@@ -0,0 +1,19 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { createTheme, themeToCssVariables } from './create-theme';
3
+
4
+ describe('themeToCssVariables', () => {
5
+ it('emits color-scheme so native chrome follows the theme', () => {
6
+ expect(themeToCssVariables(createTheme())).toContain('color-scheme: light;');
7
+ expect(themeToCssVariables(createTheme({ darkMode: true }))).toContain('color-scheme: dark;');
8
+ });
9
+
10
+ it('puts color-scheme first so it applies to the selector', () => {
11
+ expect(themeToCssVariables(createTheme()).startsWith('color-scheme: light;')).toBe(true);
12
+ });
13
+
14
+ it('still emits the token variables', () => {
15
+ const css = themeToCssVariables(createTheme());
16
+ expect(css).toContain('--background:');
17
+ expect(css).toContain('--primary:');
18
+ });
19
+ });
@@ -40,6 +40,9 @@ export function createTheme(config: ThemeConfig = {}): Theme {
40
40
  // passes AA both as button background and as link text)
41
41
  primary: darkMode ? lightenForDark(baseColor) : baseColor,
42
42
  'primary-foreground': darkMode ? inkForDark(baseColor) : '0 0% 100%',
43
+ // Text-safe primary: darker on light surfaces (4.5:1 on white and on a
44
+ // primary/10 tint), the already-lightened primary on dark surfaces.
45
+ 'primary-ink': darkMode ? lightenForDark(baseColor) : darkenForInk(baseColor),
43
46
 
44
47
  // Secondary / muted / accent
45
48
  secondary: darkMode ? '220 5% 16%' : '214 45% 96%',
@@ -50,7 +53,7 @@ export function createTheme(config: ThemeConfig = {}): Theme {
50
53
  'accent-foreground': darkMode ? '220 9% 95%' : '222 47% 11%',
51
54
 
52
55
  // Destructive — dark text carries AA on bg and card; solid fills take ink
53
- destructive: darkMode ? '0 76% 64%' : '348 68% 44%',
56
+ destructive: darkMode ? '0 80% 68%' : '348 68% 43%',
54
57
  'destructive-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',
55
58
 
56
59
  // Status colors (success / warning / info) — unitless hues.
@@ -59,6 +62,8 @@ export function createTheme(config: ThemeConfig = {}): Theme {
59
62
  // Axial house style anyway. Text usage (tints) is the primary path.
60
63
  success: darkMode ? '142 62% 52%' : '142 63% 32%',
61
64
  'success-foreground': darkMode ? '220 30% 8%' : '0 0% 100%',
65
+ // Ink for success text on a 10% tint: 5.6:1 on light, 7.9:1 on dark card.
66
+ 'success-ink': darkMode ? '142 60% 62%' : '142 70% 26%',
62
67
  warning: darkMode ? '38 92% 60%' : '38 92% 50%',
63
68
  'warning-foreground': '26 83% 14%',
64
69
  'warning-ink': darkMode ? '38 92% 62%' : '32 90% 32%',
@@ -95,6 +100,7 @@ export function createTheme(config: ThemeConfig = {}): Theme {
95
100
  return {
96
101
  name: 'custom',
97
102
  colors,
103
+ colorScheme: darkMode ? 'dark' : 'light',
98
104
  borderRadius,
99
105
  radius: {
100
106
  lg: borderRadius,
@@ -137,6 +143,18 @@ function lightenForDark(hsl: string): string {
137
143
  return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;
138
144
  }
139
145
 
146
+ /**
147
+ * Light surfaces need a darker primary for text. Eighteen points below the
148
+ * fill colour clears 4.5:1 on white and on a 10% brand tint for the Utah
149
+ * blue (58% -> 40%); the floor keeps very light brands readable.
150
+ */
151
+ function darkenForInk(hsl: string): string {
152
+ const parsed = parseHsl(hsl);
153
+ if (!parsed) return '224 89% 40%';
154
+ const light = Math.min(45, Math.max(30, parsed.l - 18));
155
+ return `${Math.round(parsed.h)} ${Math.round(parsed.s)}% ${Math.round(light)}%`;
156
+ }
157
+
140
158
  /** Matching ink (near-black, lightly tinted) for the light-blue primary. */
141
159
  function inkForDark(hsl: string): string {
142
160
  const parsed = parseHsl(hsl);
@@ -163,6 +181,12 @@ export function themeToCssVariables(theme: Theme): string {
163
181
  return `--${cssVarName}: ${value};`;
164
182
  });
165
183
 
184
+ // Native chrome follows the theme, not the OS: an unset color-scheme lets a
185
+ // dark OS preference paint dark scrollbars and form controls in light mode.
186
+ if (theme.colorScheme) {
187
+ vars.unshift(`color-scheme: ${theme.colorScheme};`);
188
+ }
189
+
166
190
  // Multi-token radius: Tailwind maps rounded-{sm,md,lg} to these variables.
167
191
  const radius = theme.radius ?? {
168
192
  lg: theme.borderRadius,
package/src/types.ts CHANGED
@@ -9,6 +9,13 @@ export type ThemeColors = {
9
9
  foreground: string;
10
10
  primary: string;
11
11
  'primary-foreground': string;
12
+ /**
13
+ * Readable primary for text roles (links, active nav, eyebrows) on light
14
+ * surfaces and primary/10 tints. `primary` itself stays a fill colour:
15
+ * a brand hue bright enough for a button background is too light for
16
+ * normal-size text on white.
17
+ */
18
+ 'primary-ink': string;
12
19
  secondary: string;
13
20
  'secondary-foreground': string;
14
21
  muted: string;
@@ -19,6 +26,7 @@ export type ThemeColors = {
19
26
  'destructive-foreground': string;
20
27
  success: string;
21
28
  'success-foreground': string;
29
+ 'success-ink': string;
22
30
  warning: string;
23
31
  'warning-foreground': string;
24
32
  /** Status label/text colour that clears AA on a neutral surface. */
@@ -53,6 +61,12 @@ export type ThemeColors = {
53
61
  export type Theme = {
54
62
  name: string;
55
63
  colors: ThemeColors;
64
+ /**
65
+ * UA color scheme for this theme. Emitted as `color-scheme` so native
66
+ * chrome (scrollbars, form controls, date pickers) follows the theme
67
+ * instead of the operating system preference.
68
+ */
69
+ colorScheme?: 'light' | 'dark';
56
70
  borderRadius?: string;
57
71
  radius?: {
58
72
  lg: string;
package/tailwind-v4.css CHANGED
@@ -26,6 +26,7 @@
26
26
 
27
27
  --color-primary: hsl(var(--primary));
28
28
  --color-primary-foreground: hsl(var(--primary-foreground));
29
+ --color-primary-ink: hsl(var(--primary-ink));
29
30
 
30
31
  --color-secondary: hsl(var(--secondary));
31
32
  --color-secondary-foreground: hsl(var(--secondary-foreground));
@@ -41,6 +42,7 @@
41
42
 
42
43
  --color-success: hsl(var(--success));
43
44
  --color-success-foreground: hsl(var(--success-foreground));
45
+ --color-success-ink: hsl(var(--success-ink));
44
46
 
45
47
  --color-warning: hsl(var(--warning));
46
48
  --color-warning-foreground: hsl(var(--warning-foreground));