@slipstream-ui/themes 0.0.0-stage → 0.5.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/LICENSE ADDED
@@ -0,0 +1,25 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2021 Michael McShinsky
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ <<<<<<< HEAD
22
+ SOFTWARE.
23
+ =======
24
+ SOFTWARE.
25
+ >>>>>>> origin/main
@@ -0,0 +1,146 @@
1
+ /**
2
+ * Theme Types
3
+ *
4
+ * Type definitions for the theming system
5
+ */
6
+ type ThemeColors = {
7
+ background: string;
8
+ foreground: string;
9
+ primary: string;
10
+ 'primary-foreground': string;
11
+ secondary: string;
12
+ 'secondary-foreground': string;
13
+ muted: string;
14
+ 'muted-foreground': string;
15
+ accent: string;
16
+ 'accent-foreground': string;
17
+ destructive: string;
18
+ 'destructive-foreground': string;
19
+ success: string;
20
+ 'success-foreground': string;
21
+ warning: string;
22
+ 'warning-foreground': string;
23
+ /** Status label/text colour that clears AA on a neutral surface. */
24
+ 'warning-ink': string;
25
+ info: string;
26
+ 'info-foreground': string;
27
+ 'info-ink': string;
28
+ border: string;
29
+ input: string;
30
+ ring: string;
31
+ card: string;
32
+ 'card-foreground': string;
33
+ popover: string;
34
+ 'popover-foreground': string;
35
+ };
36
+ type Theme = {
37
+ name: string;
38
+ colors: ThemeColors;
39
+ borderRadius?: string;
40
+ radius?: {
41
+ lg: string;
42
+ md: string;
43
+ sm: string;
44
+ };
45
+ /** Spacing density: controls padding/height of interactive elements. */
46
+ density?: {
47
+ /** Vertical padding token (default '0.5rem'). */
48
+ space: string;
49
+ /** Control height token (default '2.25rem'). */
50
+ controlHeight: string;
51
+ };
52
+ /** Motion tokens for transitions and animations. */
53
+ motion?: {
54
+ /** Fast transition duration (default '150ms'). */
55
+ fast: string;
56
+ /** Normal transition duration (default '250ms'). */
57
+ normal: string;
58
+ /** Slow transition duration (default '400ms'). */
59
+ slow: string;
60
+ /** Standard easing curve (default 'cubic-bezier(0.4, 0, 0.2, 1)'). */
61
+ ease: string;
62
+ /** Entrance/exit easing curve (default 'cubic-bezier(0.0, 0, 0.2, 1)'). */
63
+ easeIn: string;
64
+ /** Spring-like easing for emphasis (default 'cubic-bezier(0.34, 1.56, 0.64, 1)'). */
65
+ easeOut: string;
66
+ };
67
+ };
68
+ type ThemeConfig = {
69
+ /**
70
+ * Brand color in HSL format (e.g., "224 89% 58%")
71
+ */
72
+ brandColor?: string;
73
+ /**
74
+ * Border radius in rem
75
+ */
76
+ borderRadius?: string;
77
+ /**
78
+ * Whether to use dark mode as default
79
+ */
80
+ darkMode?: boolean;
81
+ /**
82
+ * Spacing density: 'compact' | 'normal' | 'relaxed'
83
+ */
84
+ density?: 'compact' | 'normal' | 'relaxed';
85
+ };
86
+
87
+ /**
88
+ * Creates a custom theme from brand colors and configuration.
89
+ *
90
+ * The light/dark palettes follow the Axial-inspired house style (shared
91
+ * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink
92
+ * in light mode; a navy-tinted surface ladder (background < card < popover)
93
+ * with crisp borders and a *lightened* primary in dark mode so links AND
94
+ * buttons both clear WCAG AA on dark backgrounds.
95
+ *
96
+ * Hue values are unitless — percent hues invalidate the whole hsl()
97
+ * declaration and silently drop the color.
98
+ *
99
+ * @example
100
+ * ```ts
101
+ * const theme = createTheme({
102
+ * brandColor: '224 89% 53%',
103
+ * borderRadius: '0.375rem',
104
+ * darkMode: true
105
+ * })
106
+ * ```
107
+ */
108
+ declare function createTheme(config?: ThemeConfig): Theme;
109
+ /**
110
+ * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets
111
+ *
112
+ * @param theme - The theme object
113
+ * @returns A string of CSS variable declarations
114
+ *
115
+ * @example
116
+ * ```ts
117
+ * const theme = createTheme({ brandColor: '224 89% 53%' });
118
+ * const cssVars = themeToCssVariables(theme);
119
+ * // Returns: "--background: 0 0% 100%; --foreground: 222 85% 7%; ..."
120
+ * ```
121
+ */
122
+ declare function themeToCssVariables(theme: Theme): string;
123
+
124
+ /**
125
+ * Default theme with a blue brand color
126
+ */
127
+ declare const defaultTheme: Theme;
128
+
129
+ /**
130
+ * Dark theme with a blue brand color
131
+ */
132
+ declare const darkTheme: Theme;
133
+
134
+ /**
135
+ * Zinc theme - neutral gray tones
136
+ */
137
+ declare const zincTheme: Theme;
138
+ declare const zincDarkTheme: Theme;
139
+
140
+ /**
141
+ * Violet theme - purple tones
142
+ */
143
+ declare const violetTheme: Theme;
144
+ declare const violetDarkTheme: Theme;
145
+
146
+ export { type Theme, type ThemeColors, type ThemeConfig, createTheme, darkTheme, defaultTheme, themeToCssVariables, violetDarkTheme, violetTheme, zincDarkTheme, zincTheme };
@@ -0,0 +1,146 @@
1
+ /**
2
+ * Theme Types
3
+ *
4
+ * Type definitions for the theming system
5
+ */
6
+ type ThemeColors = {
7
+ background: string;
8
+ foreground: string;
9
+ primary: string;
10
+ 'primary-foreground': string;
11
+ secondary: string;
12
+ 'secondary-foreground': string;
13
+ muted: string;
14
+ 'muted-foreground': string;
15
+ accent: string;
16
+ 'accent-foreground': string;
17
+ destructive: string;
18
+ 'destructive-foreground': string;
19
+ success: string;
20
+ 'success-foreground': string;
21
+ warning: string;
22
+ 'warning-foreground': string;
23
+ /** Status label/text colour that clears AA on a neutral surface. */
24
+ 'warning-ink': string;
25
+ info: string;
26
+ 'info-foreground': string;
27
+ 'info-ink': string;
28
+ border: string;
29
+ input: string;
30
+ ring: string;
31
+ card: string;
32
+ 'card-foreground': string;
33
+ popover: string;
34
+ 'popover-foreground': string;
35
+ };
36
+ type Theme = {
37
+ name: string;
38
+ colors: ThemeColors;
39
+ borderRadius?: string;
40
+ radius?: {
41
+ lg: string;
42
+ md: string;
43
+ sm: string;
44
+ };
45
+ /** Spacing density: controls padding/height of interactive elements. */
46
+ density?: {
47
+ /** Vertical padding token (default '0.5rem'). */
48
+ space: string;
49
+ /** Control height token (default '2.25rem'). */
50
+ controlHeight: string;
51
+ };
52
+ /** Motion tokens for transitions and animations. */
53
+ motion?: {
54
+ /** Fast transition duration (default '150ms'). */
55
+ fast: string;
56
+ /** Normal transition duration (default '250ms'). */
57
+ normal: string;
58
+ /** Slow transition duration (default '400ms'). */
59
+ slow: string;
60
+ /** Standard easing curve (default 'cubic-bezier(0.4, 0, 0.2, 1)'). */
61
+ ease: string;
62
+ /** Entrance/exit easing curve (default 'cubic-bezier(0.0, 0, 0.2, 1)'). */
63
+ easeIn: string;
64
+ /** Spring-like easing for emphasis (default 'cubic-bezier(0.34, 1.56, 0.64, 1)'). */
65
+ easeOut: string;
66
+ };
67
+ };
68
+ type ThemeConfig = {
69
+ /**
70
+ * Brand color in HSL format (e.g., "224 89% 58%")
71
+ */
72
+ brandColor?: string;
73
+ /**
74
+ * Border radius in rem
75
+ */
76
+ borderRadius?: string;
77
+ /**
78
+ * Whether to use dark mode as default
79
+ */
80
+ darkMode?: boolean;
81
+ /**
82
+ * Spacing density: 'compact' | 'normal' | 'relaxed'
83
+ */
84
+ density?: 'compact' | 'normal' | 'relaxed';
85
+ };
86
+
87
+ /**
88
+ * Creates a custom theme from brand colors and configuration.
89
+ *
90
+ * The light/dark palettes follow the Axial-inspired house style (shared
91
+ * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink
92
+ * in light mode; a navy-tinted surface ladder (background < card < popover)
93
+ * with crisp borders and a *lightened* primary in dark mode so links AND
94
+ * buttons both clear WCAG AA on dark backgrounds.
95
+ *
96
+ * Hue values are unitless — percent hues invalidate the whole hsl()
97
+ * declaration and silently drop the color.
98
+ *
99
+ * @example
100
+ * ```ts
101
+ * const theme = createTheme({
102
+ * brandColor: '224 89% 53%',
103
+ * borderRadius: '0.375rem',
104
+ * darkMode: true
105
+ * })
106
+ * ```
107
+ */
108
+ declare function createTheme(config?: ThemeConfig): Theme;
109
+ /**
110
+ * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets
111
+ *
112
+ * @param theme - The theme object
113
+ * @returns A string of CSS variable declarations
114
+ *
115
+ * @example
116
+ * ```ts
117
+ * const theme = createTheme({ brandColor: '224 89% 53%' });
118
+ * const cssVars = themeToCssVariables(theme);
119
+ * // Returns: "--background: 0 0% 100%; --foreground: 222 85% 7%; ..."
120
+ * ```
121
+ */
122
+ declare function themeToCssVariables(theme: Theme): string;
123
+
124
+ /**
125
+ * Default theme with a blue brand color
126
+ */
127
+ declare const defaultTheme: Theme;
128
+
129
+ /**
130
+ * Dark theme with a blue brand color
131
+ */
132
+ declare const darkTheme: Theme;
133
+
134
+ /**
135
+ * Zinc theme - neutral gray tones
136
+ */
137
+ declare const zincTheme: Theme;
138
+ declare const zincDarkTheme: Theme;
139
+
140
+ /**
141
+ * Violet theme - purple tones
142
+ */
143
+ declare const violetTheme: Theme;
144
+ declare const violetDarkTheme: Theme;
145
+
146
+ export { type Theme, type ThemeColors, type ThemeConfig, createTheme, darkTheme, defaultTheme, themeToCssVariables, violetDarkTheme, violetTheme, zincDarkTheme, zincTheme };
package/dist/index.js ADDED
@@ -0,0 +1,206 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/index.ts
21
+ var index_exports = {};
22
+ __export(index_exports, {
23
+ createTheme: () => createTheme,
24
+ darkTheme: () => darkTheme,
25
+ defaultTheme: () => defaultTheme,
26
+ themeToCssVariables: () => themeToCssVariables,
27
+ violetDarkTheme: () => violetDarkTheme,
28
+ violetTheme: () => violetTheme,
29
+ zincDarkTheme: () => zincDarkTheme,
30
+ zincTheme: () => zincTheme
31
+ });
32
+ module.exports = __toCommonJS(index_exports);
33
+
34
+ // src/create-theme.ts
35
+ function createTheme(config = {}) {
36
+ const {
37
+ brandColor = "224 89% 53%",
38
+ borderRadius = "0.375rem",
39
+ darkMode = false
40
+ } = config;
41
+ const baseColor = brandColor;
42
+ const colors = {
43
+ // Surfaces
44
+ background: darkMode ? "222 42% 5%" : "0 0% 100%",
45
+ foreground: darkMode ? "210 40% 96%" : "222 85% 7%",
46
+ // Primary (brand-based; derived for dark so light-blue + navy ink
47
+ // passes AA both as button background and as link text)
48
+ primary: darkMode ? lightenForDark(baseColor) : baseColor,
49
+ "primary-foreground": darkMode ? inkForDark(baseColor) : "0 0% 100%",
50
+ // Secondary / muted / accent
51
+ secondary: darkMode ? "217 24% 17%" : "214 45% 96%",
52
+ "secondary-foreground": darkMode ? "210 40% 96%" : "222 47% 11%",
53
+ muted: darkMode ? "217 24% 17%" : "214 40% 96%",
54
+ "muted-foreground": darkMode ? "215 16% 68%" : "219 12% 42%",
55
+ accent: darkMode ? "217 24% 17%" : "214 45% 96%",
56
+ "accent-foreground": darkMode ? "210 40% 96%" : "222 47% 11%",
57
+ // Destructive — dark text carries AA on bg and card; solid fills take ink
58
+ destructive: darkMode ? "0 76% 64%" : "348 68% 44%",
59
+ "destructive-foreground": darkMode ? "222 75% 10%" : "0 0% 100%",
60
+ // Status colors (success / warning / info) — unitless hues.
61
+ // Solid semantic fills carry navy-ink foregrounds: mid-luminance
62
+ // colors cannot hold 4.5:1 against white, and ink-on-color is the
63
+ // Axial house style anyway. Text usage (tints) is the primary path.
64
+ success: darkMode ? "142 62% 52%" : "142 63% 32%",
65
+ "success-foreground": darkMode ? "222 75% 10%" : "0 0% 100%",
66
+ warning: darkMode ? "38 92% 60%" : "38 92% 50%",
67
+ "warning-foreground": "26 83% 14%",
68
+ "warning-ink": darkMode ? "38 92% 62%" : "32 90% 32%",
69
+ info: darkMode ? "190 80% 58%" : "190 76% 38%",
70
+ "info-foreground": "222 75% 10%",
71
+ "info-ink": darkMode ? "190 80% 62%" : "190 90% 28%",
72
+ // Borders: dark gets a crisp 30% navy line; inputs read brighter (36%)
73
+ border: darkMode ? "217 20% 30%" : "214 28% 89%",
74
+ input: darkMode ? "217 18% 36%" : "214 28% 89%",
75
+ ring: darkMode ? lightenForDark(baseColor) : baseColor,
76
+ // Card / popover: elevated steps above the dark background
77
+ card: darkMode ? "222 34% 11%" : "0 0% 100%",
78
+ "card-foreground": darkMode ? "210 40% 96%" : "222 85% 7%",
79
+ popover: darkMode ? "222 34% 14%" : "0 0% 100%",
80
+ "popover-foreground": darkMode ? "210 40% 96%" : "222 85% 7%"
81
+ };
82
+ return {
83
+ name: "custom",
84
+ colors,
85
+ borderRadius,
86
+ radius: {
87
+ lg: borderRadius,
88
+ md: `calc(${borderRadius} - 2px)`,
89
+ sm: `calc(${borderRadius} - 4px)`
90
+ },
91
+ density: {
92
+ space: config.density === "compact" ? "0.375rem" : config.density === "relaxed" ? "0.75rem" : "0.5rem",
93
+ controlHeight: config.density === "compact" ? "2rem" : config.density === "relaxed" ? "2.5rem" : "2.25rem"
94
+ },
95
+ motion: {
96
+ fast: "150ms",
97
+ normal: "250ms",
98
+ slow: "400ms",
99
+ ease: "cubic-bezier(0.4, 0, 0.2, 1)",
100
+ easeIn: "cubic-bezier(0.0, 0, 0.2, 1)",
101
+ easeOut: "cubic-bezier(0.34, 1.56, 0.64, 1)"
102
+ }
103
+ };
104
+ }
105
+ function parseHsl(value) {
106
+ const parts = value.trim().split(/\s+/);
107
+ if (parts.length !== 3) return null;
108
+ const [h, s, l] = parts.map((part) => parseFloat(part));
109
+ if ([h, s, l].some((n) => Number.isNaN(n))) return null;
110
+ return { h, s, l };
111
+ }
112
+ function lightenForDark(hsl) {
113
+ const parsed = parseHsl(hsl);
114
+ if (!parsed) return hsl;
115
+ const light = Math.max(parsed.l, 70);
116
+ const sat = Math.min(95, Math.max(parsed.s, 60));
117
+ return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;
118
+ }
119
+ function inkForDark(hsl) {
120
+ const parsed = parseHsl(hsl);
121
+ if (!parsed) return "210 40% 98%";
122
+ return `${Math.round(parsed.h)} 75% 10%`;
123
+ }
124
+ function themeToCssVariables(theme) {
125
+ const vars = Object.entries(theme.colors).map(([key, value]) => {
126
+ const cssVarName = key.replace(/([A-Z])/g, "-$1").toLowerCase();
127
+ return `--${cssVarName}: ${value};`;
128
+ });
129
+ const radius = theme.radius ?? {
130
+ lg: theme.borderRadius,
131
+ md: `calc(${theme.borderRadius} - 2px)`,
132
+ sm: `calc(${theme.borderRadius} - 4px)`
133
+ };
134
+ vars.push(`--radius: ${theme.borderRadius};`);
135
+ vars.push(`--radius-lg: ${radius.lg};`);
136
+ vars.push(`--radius-md: ${radius.md};`);
137
+ vars.push(`--radius-sm: ${radius.sm};`);
138
+ const density = theme.density ?? { space: "0.5rem", controlHeight: "2.25rem" };
139
+ vars.push(`--density-space: ${density.space};`);
140
+ vars.push(`--density-control-height: ${density.controlHeight};`);
141
+ const motion = theme.motion ?? {
142
+ fast: "150ms",
143
+ normal: "250ms",
144
+ slow: "400ms",
145
+ ease: "cubic-bezier(0.4, 0, 0.2, 1)",
146
+ easeIn: "cubic-bezier(0.0, 0, 0.2, 1)",
147
+ easeOut: "cubic-bezier(0.34, 1.56, 0.64, 1)"
148
+ };
149
+ vars.push(`--motion-fast: ${motion.fast};`);
150
+ vars.push(`--motion-normal: ${motion.normal};`);
151
+ vars.push(`--motion-slow: ${motion.slow};`);
152
+ vars.push(`--motion-ease: ${motion.ease};`);
153
+ vars.push(`--motion-ease-in: ${motion.easeIn};`);
154
+ vars.push(`--motion-ease-out: ${motion.easeOut};`);
155
+ return vars.join("\n ");
156
+ }
157
+
158
+ // src/presets/default.ts
159
+ var defaultTheme = createTheme({
160
+ brandColor: "224 89% 53%",
161
+ borderRadius: "0.375rem",
162
+ darkMode: false
163
+ });
164
+
165
+ // src/presets/dark.ts
166
+ var darkTheme = createTheme({
167
+ brandColor: "224 89% 53%",
168
+ borderRadius: "0.375rem",
169
+ darkMode: true
170
+ });
171
+
172
+ // src/presets/zinc.ts
173
+ var zincTheme = createTheme({
174
+ brandColor: "240 5% 65%",
175
+ borderRadius: "0.375rem",
176
+ darkMode: false
177
+ });
178
+ var zincDarkTheme = createTheme({
179
+ brandColor: "240 5% 65%",
180
+ borderRadius: "0.375rem",
181
+ darkMode: true
182
+ });
183
+
184
+ // src/presets/violet.ts
185
+ var violetTheme = createTheme({
186
+ brandColor: "263 70% 50%",
187
+ borderRadius: "0.375rem",
188
+ darkMode: false
189
+ });
190
+ var violetDarkTheme = createTheme({
191
+ brandColor: "263 70% 50%",
192
+ borderRadius: "0.375rem",
193
+ darkMode: true
194
+ });
195
+ // Annotate the CommonJS export names for ESM import in node:
196
+ 0 && (module.exports = {
197
+ createTheme,
198
+ darkTheme,
199
+ defaultTheme,
200
+ themeToCssVariables,
201
+ violetDarkTheme,
202
+ violetTheme,
203
+ zincDarkTheme,
204
+ zincTheme
205
+ });
206
+ //# sourceMappingURL=index.js.map
@@ -0,0 +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 navy-tinted surface ladder (background < card < popover)\n * with crisp borders and a *lightened* primary in dark mode so links AND\n * buttons both clear WCAG AA 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 ? '222 42% 5%' : '0 0% 100%',\n foreground: darkMode ? '210 40% 96%' : '222 85% 7%',\n\n // Primary (brand-based; derived for dark so light-blue + navy 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 ? '217 24% 17%' : '214 45% 96%',\n 'secondary-foreground': darkMode ? '210 40% 96%' : '222 47% 11%',\n muted: darkMode ? '217 24% 17%' : '214 40% 96%',\n 'muted-foreground': darkMode ? '215 16% 68%' : '219 12% 42%',\n accent: darkMode ? '217 24% 17%' : '214 45% 96%',\n 'accent-foreground': darkMode ? '210 40% 96%' : '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 ? '222 75% 10%' : '0 0% 100%',\n\n // Status colors (success / warning / info) — unitless hues.\n // Solid semantic fills carry navy-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 ? '222 75% 10%' : '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': '222 75% 10%',\n 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',\n\n // Borders: dark gets a crisp 30% navy line; inputs read brighter (36%)\n border: darkMode ? '217 20% 30%' : '214 28% 89%',\n input: darkMode ? '217 18% 36%' : '214 28% 89%',\n ring: darkMode ? lightenForDark(baseColor) : baseColor,\n\n // Card / popover: elevated steps above the dark background\n card: darkMode ? '222 34% 11%' : '0 0% 100%',\n 'card-foreground': darkMode ? '210 40% 96%' : '222 85% 7%',\n popover: darkMode ? '222 34% 14%' : '0 0% 100%',\n 'popover-foreground': darkMode ? '210 40% 96%' : '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 (navy-tinted dark) foreground for the light-blue primary. */\nfunction inkForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '210 40% 98%';\n return `${Math.round(parsed.h)} 75% 10%`;\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":[]}
package/dist/index.mjs ADDED
@@ -0,0 +1,172 @@
1
+ // src/create-theme.ts
2
+ function createTheme(config = {}) {
3
+ const {
4
+ brandColor = "224 89% 53%",
5
+ borderRadius = "0.375rem",
6
+ darkMode = false
7
+ } = config;
8
+ const baseColor = brandColor;
9
+ const colors = {
10
+ // Surfaces
11
+ background: darkMode ? "222 42% 5%" : "0 0% 100%",
12
+ foreground: darkMode ? "210 40% 96%" : "222 85% 7%",
13
+ // Primary (brand-based; derived for dark so light-blue + navy ink
14
+ // passes AA both as button background and as link text)
15
+ primary: darkMode ? lightenForDark(baseColor) : baseColor,
16
+ "primary-foreground": darkMode ? inkForDark(baseColor) : "0 0% 100%",
17
+ // Secondary / muted / accent
18
+ secondary: darkMode ? "217 24% 17%" : "214 45% 96%",
19
+ "secondary-foreground": darkMode ? "210 40% 96%" : "222 47% 11%",
20
+ muted: darkMode ? "217 24% 17%" : "214 40% 96%",
21
+ "muted-foreground": darkMode ? "215 16% 68%" : "219 12% 42%",
22
+ accent: darkMode ? "217 24% 17%" : "214 45% 96%",
23
+ "accent-foreground": darkMode ? "210 40% 96%" : "222 47% 11%",
24
+ // Destructive — dark text carries AA on bg and card; solid fills take ink
25
+ destructive: darkMode ? "0 76% 64%" : "348 68% 44%",
26
+ "destructive-foreground": darkMode ? "222 75% 10%" : "0 0% 100%",
27
+ // Status colors (success / warning / info) — unitless hues.
28
+ // Solid semantic fills carry navy-ink foregrounds: mid-luminance
29
+ // colors cannot hold 4.5:1 against white, and ink-on-color is the
30
+ // Axial house style anyway. Text usage (tints) is the primary path.
31
+ success: darkMode ? "142 62% 52%" : "142 63% 32%",
32
+ "success-foreground": darkMode ? "222 75% 10%" : "0 0% 100%",
33
+ warning: darkMode ? "38 92% 60%" : "38 92% 50%",
34
+ "warning-foreground": "26 83% 14%",
35
+ "warning-ink": darkMode ? "38 92% 62%" : "32 90% 32%",
36
+ info: darkMode ? "190 80% 58%" : "190 76% 38%",
37
+ "info-foreground": "222 75% 10%",
38
+ "info-ink": darkMode ? "190 80% 62%" : "190 90% 28%",
39
+ // Borders: dark gets a crisp 30% navy line; inputs read brighter (36%)
40
+ border: darkMode ? "217 20% 30%" : "214 28% 89%",
41
+ input: darkMode ? "217 18% 36%" : "214 28% 89%",
42
+ ring: darkMode ? lightenForDark(baseColor) : baseColor,
43
+ // Card / popover: elevated steps above the dark background
44
+ card: darkMode ? "222 34% 11%" : "0 0% 100%",
45
+ "card-foreground": darkMode ? "210 40% 96%" : "222 85% 7%",
46
+ popover: darkMode ? "222 34% 14%" : "0 0% 100%",
47
+ "popover-foreground": darkMode ? "210 40% 96%" : "222 85% 7%"
48
+ };
49
+ return {
50
+ name: "custom",
51
+ colors,
52
+ borderRadius,
53
+ radius: {
54
+ lg: borderRadius,
55
+ md: `calc(${borderRadius} - 2px)`,
56
+ sm: `calc(${borderRadius} - 4px)`
57
+ },
58
+ density: {
59
+ space: config.density === "compact" ? "0.375rem" : config.density === "relaxed" ? "0.75rem" : "0.5rem",
60
+ controlHeight: config.density === "compact" ? "2rem" : config.density === "relaxed" ? "2.5rem" : "2.25rem"
61
+ },
62
+ motion: {
63
+ fast: "150ms",
64
+ normal: "250ms",
65
+ slow: "400ms",
66
+ ease: "cubic-bezier(0.4, 0, 0.2, 1)",
67
+ easeIn: "cubic-bezier(0.0, 0, 0.2, 1)",
68
+ easeOut: "cubic-bezier(0.34, 1.56, 0.64, 1)"
69
+ }
70
+ };
71
+ }
72
+ function parseHsl(value) {
73
+ const parts = value.trim().split(/\s+/);
74
+ if (parts.length !== 3) return null;
75
+ const [h, s, l] = parts.map((part) => parseFloat(part));
76
+ if ([h, s, l].some((n) => Number.isNaN(n))) return null;
77
+ return { h, s, l };
78
+ }
79
+ function lightenForDark(hsl) {
80
+ const parsed = parseHsl(hsl);
81
+ if (!parsed) return hsl;
82
+ const light = Math.max(parsed.l, 70);
83
+ const sat = Math.min(95, Math.max(parsed.s, 60));
84
+ return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;
85
+ }
86
+ function inkForDark(hsl) {
87
+ const parsed = parseHsl(hsl);
88
+ if (!parsed) return "210 40% 98%";
89
+ return `${Math.round(parsed.h)} 75% 10%`;
90
+ }
91
+ function themeToCssVariables(theme) {
92
+ const vars = Object.entries(theme.colors).map(([key, value]) => {
93
+ const cssVarName = key.replace(/([A-Z])/g, "-$1").toLowerCase();
94
+ return `--${cssVarName}: ${value};`;
95
+ });
96
+ const radius = theme.radius ?? {
97
+ lg: theme.borderRadius,
98
+ md: `calc(${theme.borderRadius} - 2px)`,
99
+ sm: `calc(${theme.borderRadius} - 4px)`
100
+ };
101
+ vars.push(`--radius: ${theme.borderRadius};`);
102
+ vars.push(`--radius-lg: ${radius.lg};`);
103
+ vars.push(`--radius-md: ${radius.md};`);
104
+ vars.push(`--radius-sm: ${radius.sm};`);
105
+ const density = theme.density ?? { space: "0.5rem", controlHeight: "2.25rem" };
106
+ vars.push(`--density-space: ${density.space};`);
107
+ vars.push(`--density-control-height: ${density.controlHeight};`);
108
+ const motion = theme.motion ?? {
109
+ fast: "150ms",
110
+ normal: "250ms",
111
+ slow: "400ms",
112
+ ease: "cubic-bezier(0.4, 0, 0.2, 1)",
113
+ easeIn: "cubic-bezier(0.0, 0, 0.2, 1)",
114
+ easeOut: "cubic-bezier(0.34, 1.56, 0.64, 1)"
115
+ };
116
+ vars.push(`--motion-fast: ${motion.fast};`);
117
+ vars.push(`--motion-normal: ${motion.normal};`);
118
+ vars.push(`--motion-slow: ${motion.slow};`);
119
+ vars.push(`--motion-ease: ${motion.ease};`);
120
+ vars.push(`--motion-ease-in: ${motion.easeIn};`);
121
+ vars.push(`--motion-ease-out: ${motion.easeOut};`);
122
+ return vars.join("\n ");
123
+ }
124
+
125
+ // src/presets/default.ts
126
+ var defaultTheme = createTheme({
127
+ brandColor: "224 89% 53%",
128
+ borderRadius: "0.375rem",
129
+ darkMode: false
130
+ });
131
+
132
+ // src/presets/dark.ts
133
+ var darkTheme = createTheme({
134
+ brandColor: "224 89% 53%",
135
+ borderRadius: "0.375rem",
136
+ darkMode: true
137
+ });
138
+
139
+ // src/presets/zinc.ts
140
+ var zincTheme = createTheme({
141
+ brandColor: "240 5% 65%",
142
+ borderRadius: "0.375rem",
143
+ darkMode: false
144
+ });
145
+ var zincDarkTheme = createTheme({
146
+ brandColor: "240 5% 65%",
147
+ borderRadius: "0.375rem",
148
+ darkMode: true
149
+ });
150
+
151
+ // src/presets/violet.ts
152
+ var violetTheme = createTheme({
153
+ brandColor: "263 70% 50%",
154
+ borderRadius: "0.375rem",
155
+ darkMode: false
156
+ });
157
+ var violetDarkTheme = createTheme({
158
+ brandColor: "263 70% 50%",
159
+ borderRadius: "0.375rem",
160
+ darkMode: true
161
+ });
162
+ export {
163
+ createTheme,
164
+ darkTheme,
165
+ defaultTheme,
166
+ themeToCssVariables,
167
+ violetDarkTheme,
168
+ violetTheme,
169
+ zincDarkTheme,
170
+ zincTheme
171
+ };
172
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +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 navy-tinted surface ladder (background < card < popover)\n * with crisp borders and a *lightened* primary in dark mode so links AND\n * buttons both clear WCAG AA 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 ? '222 42% 5%' : '0 0% 100%',\n foreground: darkMode ? '210 40% 96%' : '222 85% 7%',\n\n // Primary (brand-based; derived for dark so light-blue + navy 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 ? '217 24% 17%' : '214 45% 96%',\n 'secondary-foreground': darkMode ? '210 40% 96%' : '222 47% 11%',\n muted: darkMode ? '217 24% 17%' : '214 40% 96%',\n 'muted-foreground': darkMode ? '215 16% 68%' : '219 12% 42%',\n accent: darkMode ? '217 24% 17%' : '214 45% 96%',\n 'accent-foreground': darkMode ? '210 40% 96%' : '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 ? '222 75% 10%' : '0 0% 100%',\n\n // Status colors (success / warning / info) — unitless hues.\n // Solid semantic fills carry navy-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 ? '222 75% 10%' : '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': '222 75% 10%',\n 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',\n\n // Borders: dark gets a crisp 30% navy line; inputs read brighter (36%)\n border: darkMode ? '217 20% 30%' : '214 28% 89%',\n input: darkMode ? '217 18% 36%' : '214 28% 89%',\n ring: darkMode ? lightenForDark(baseColor) : baseColor,\n\n // Card / popover: elevated steps above the dark background\n card: darkMode ? '222 34% 11%' : '0 0% 100%',\n 'card-foreground': darkMode ? '210 40% 96%' : '222 85% 7%',\n popover: darkMode ? '222 34% 14%' : '0 0% 100%',\n 'popover-foreground': darkMode ? '210 40% 96%' : '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 (navy-tinted dark) foreground for the light-blue primary. */\nfunction inkForDark(hsl: string): string {\n const parsed = parseHsl(hsl);\n if (!parsed) return '210 40% 98%';\n return `${Math.round(parsed.h)} 75% 10%`;\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":[]}
package/package.json CHANGED
@@ -1,6 +1,44 @@
1
1
  {
2
2
  "name": "@slipstream-ui/themes",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.5.0",
4
+ "repository": {
5
+ "type": "git",
6
+ "url": "git+https://github.com/michaelmcshinsky/slipstream-ui.git",
7
+ "directory": "packages/themes"
8
+ },
9
+ "description": "Theming system for Slipstream UI with createTheme() and presets",
10
+ "main": "./dist/index.js",
11
+ "module": "./dist/index.mjs",
12
+ "types": "./dist/index.d.ts",
13
+ "exports": {
14
+ ".": {
15
+ "types": "./dist/index.d.ts",
16
+ "import": "./dist/index.mjs",
17
+ "require": "./dist/index.js"
18
+ },
19
+ "./tailwind-v4.css": "./tailwind-v4.css"
20
+ },
21
+ "files": [
22
+ "dist",
23
+ "src",
24
+ "tailwind-v4.css"
25
+ ],
26
+ "publishConfig": {
27
+ "access": "public",
28
+ "provenance": true
29
+ },
30
+ "dependencies": {},
31
+ "devDependencies": {
32
+ "eslint": "^8.56.0",
33
+ "tsup": "^8.0.0",
34
+ "typescript": "^5.3.3",
35
+ "@slipstream-ui/eslint-config": "0.0.1",
36
+ "@slipstream-ui/typescript-config": "0.0.1"
37
+ },
38
+ "scripts": {
39
+ "build": "tsup",
40
+ "dev": "tsup --watch",
41
+ "typecheck": "tsc --noEmit",
42
+ "lint": "eslint src --ext .ts,.tsx"
43
+ }
6
44
  }
@@ -0,0 +1,184 @@
1
+ import type { Theme, ThemeConfig, ThemeColors } from './types';
2
+
3
+ /**
4
+ * Creates a custom theme from brand colors and configuration.
5
+ *
6
+ * The light/dark palettes follow the Axial-inspired house style (shared
7
+ * spec with apps/docs/app/globals.css): pure-white surfaces and navy ink
8
+ * in light mode; a navy-tinted surface ladder (background < card < popover)
9
+ * with crisp borders and a *lightened* primary in dark mode so links AND
10
+ * buttons both clear WCAG AA on dark backgrounds.
11
+ *
12
+ * Hue values are unitless — percent hues invalidate the whole hsl()
13
+ * declaration and silently drop the color.
14
+ *
15
+ * @example
16
+ * ```ts
17
+ * const theme = createTheme({
18
+ * brandColor: '224 89% 53%',
19
+ * borderRadius: '0.375rem',
20
+ * darkMode: true
21
+ * })
22
+ * ```
23
+ */
24
+ export function createTheme(config: ThemeConfig = {}): Theme {
25
+ const {
26
+ brandColor = '224 89% 53%',
27
+ borderRadius = '0.375rem',
28
+ darkMode = false,
29
+ } = config;
30
+
31
+ const baseColor = brandColor;
32
+
33
+ const colors: ThemeColors = {
34
+ // Surfaces
35
+ background: darkMode ? '222 42% 5%' : '0 0% 100%',
36
+ foreground: darkMode ? '210 40% 96%' : '222 85% 7%',
37
+
38
+ // Primary (brand-based; derived for dark so light-blue + navy ink
39
+ // passes AA both as button background and as link text)
40
+ primary: darkMode ? lightenForDark(baseColor) : baseColor,
41
+ 'primary-foreground': darkMode ? inkForDark(baseColor) : '0 0% 100%',
42
+
43
+ // Secondary / muted / accent
44
+ secondary: darkMode ? '217 24% 17%' : '214 45% 96%',
45
+ 'secondary-foreground': darkMode ? '210 40% 96%' : '222 47% 11%',
46
+ muted: darkMode ? '217 24% 17%' : '214 40% 96%',
47
+ 'muted-foreground': darkMode ? '215 16% 68%' : '219 12% 42%',
48
+ accent: darkMode ? '217 24% 17%' : '214 45% 96%',
49
+ 'accent-foreground': darkMode ? '210 40% 96%' : '222 47% 11%',
50
+
51
+ // Destructive — dark text carries AA on bg and card; solid fills take ink
52
+ destructive: darkMode ? '0 76% 64%' : '348 68% 44%',
53
+ 'destructive-foreground': darkMode ? '222 75% 10%' : '0 0% 100%',
54
+
55
+ // Status colors (success / warning / info) — unitless hues.
56
+ // Solid semantic fills carry navy-ink foregrounds: mid-luminance
57
+ // colors cannot hold 4.5:1 against white, and ink-on-color is the
58
+ // Axial house style anyway. Text usage (tints) is the primary path.
59
+ success: darkMode ? '142 62% 52%' : '142 63% 32%',
60
+ 'success-foreground': darkMode ? '222 75% 10%' : '0 0% 100%',
61
+ warning: darkMode ? '38 92% 60%' : '38 92% 50%',
62
+ 'warning-foreground': '26 83% 14%',
63
+ 'warning-ink': darkMode ? '38 92% 62%' : '32 90% 32%',
64
+ info: darkMode ? '190 80% 58%' : '190 76% 38%',
65
+ 'info-foreground': '222 75% 10%',
66
+ 'info-ink': darkMode ? '190 80% 62%' : '190 90% 28%',
67
+
68
+ // Borders: dark gets a crisp 30% navy line; inputs read brighter (36%)
69
+ border: darkMode ? '217 20% 30%' : '214 28% 89%',
70
+ input: darkMode ? '217 18% 36%' : '214 28% 89%',
71
+ ring: darkMode ? lightenForDark(baseColor) : baseColor,
72
+
73
+ // Card / popover: elevated steps above the dark background
74
+ card: darkMode ? '222 34% 11%' : '0 0% 100%',
75
+ 'card-foreground': darkMode ? '210 40% 96%' : '222 85% 7%',
76
+ popover: darkMode ? '222 34% 14%' : '0 0% 100%',
77
+ 'popover-foreground': darkMode ? '210 40% 96%' : '222 85% 7%',
78
+ };
79
+
80
+ return {
81
+ name: 'custom',
82
+ colors,
83
+ borderRadius,
84
+ radius: {
85
+ lg: borderRadius,
86
+ md: `calc(${borderRadius} - 2px)`,
87
+ sm: `calc(${borderRadius} - 4px)`,
88
+ },
89
+ density: {
90
+ space: config.density === 'compact' ? '0.375rem' : config.density === 'relaxed' ? '0.75rem' : '0.5rem',
91
+ controlHeight: config.density === 'compact' ? '2rem' : config.density === 'relaxed' ? '2.5rem' : '2.25rem',
92
+ },
93
+ motion: {
94
+ fast: '150ms',
95
+ normal: '250ms',
96
+ slow: '400ms',
97
+ ease: 'cubic-bezier(0.4, 0, 0.2, 1)',
98
+ easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',
99
+ easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',
100
+ },
101
+ };
102
+ }
103
+
104
+ /** Parse a `H S% L%` triplet; null when the input is not a plain HSL triple. */
105
+ function parseHsl(value: string): { h: number; s: number; l: number } | null {
106
+ const parts = value.trim().split(/\s+/);
107
+ if (parts.length !== 3) return null;
108
+ const [h, s, l] = parts.map((part) => parseFloat(part));
109
+ if ([h, s, l].some((n) => Number.isNaN(n))) return null;
110
+ return { h, s, l };
111
+ }
112
+
113
+ /**
114
+ * Dark surfaces need a lighter primary (light-blue) so it works as link
115
+ * text on near-black backgrounds; saturation is floored so it stays vivid.
116
+ */
117
+ function lightenForDark(hsl: string): string {
118
+ const parsed = parseHsl(hsl);
119
+ if (!parsed) return hsl;
120
+ const light = Math.max(parsed.l, 70);
121
+ const sat = Math.min(95, Math.max(parsed.s, 60));
122
+ return `${Math.round(parsed.h)} ${Math.round(sat)}% ${Math.round(light)}%`;
123
+ }
124
+
125
+ /** Matching ink (navy-tinted dark) foreground for the light-blue primary. */
126
+ function inkForDark(hsl: string): string {
127
+ const parsed = parseHsl(hsl);
128
+ if (!parsed) return '210 40% 98%';
129
+ return `${Math.round(parsed.h)} 75% 10%`;
130
+ }
131
+
132
+ /**
133
+ * Generates CSS variables from a theme for use in CSS-in-JS or stylesheets
134
+ *
135
+ * @param theme - The theme object
136
+ * @returns A string of CSS variable declarations
137
+ *
138
+ * @example
139
+ * ```ts
140
+ * const theme = createTheme({ brandColor: '224 89% 53%' });
141
+ * const cssVars = themeToCssVariables(theme);
142
+ * // Returns: "--background: 0 0% 100%; --foreground: 222 85% 7%; ..."
143
+ * ```
144
+ */
145
+ export function themeToCssVariables(theme: Theme): string {
146
+ const vars = Object.entries(theme.colors).map(([key, value]) => {
147
+ const cssVarName = key.replace(/([A-Z])/g, '-$1').toLowerCase();
148
+ return `--${cssVarName}: ${value};`;
149
+ });
150
+
151
+ // Multi-token radius: Tailwind maps rounded-{sm,md,lg} to these variables.
152
+ const radius = theme.radius ?? {
153
+ lg: theme.borderRadius,
154
+ md: `calc(${theme.borderRadius} - 2px)`,
155
+ sm: `calc(${theme.borderRadius} - 4px)`,
156
+ };
157
+ vars.push(`--radius: ${theme.borderRadius};`);
158
+ vars.push(`--radius-lg: ${radius.lg};`);
159
+ vars.push(`--radius-md: ${radius.md};`);
160
+ vars.push(`--radius-sm: ${radius.sm};`);
161
+
162
+ // Density tokens: spacing and control sizing.
163
+ const density = theme.density ?? { space: '0.5rem', controlHeight: '2.25rem' };
164
+ vars.push(`--density-space: ${density.space};`);
165
+ vars.push(`--density-control-height: ${density.controlHeight};`);
166
+
167
+ // Motion tokens: durations and easing curves.
168
+ const motion = theme.motion ?? {
169
+ fast: '150ms',
170
+ normal: '250ms',
171
+ slow: '400ms',
172
+ ease: 'cubic-bezier(0.4, 0, 0.2, 1)',
173
+ easeIn: 'cubic-bezier(0.0, 0, 0.2, 1)',
174
+ easeOut: 'cubic-bezier(0.34, 1.56, 0.64, 1)',
175
+ };
176
+ vars.push(`--motion-fast: ${motion.fast};`);
177
+ vars.push(`--motion-normal: ${motion.normal};`);
178
+ vars.push(`--motion-slow: ${motion.slow};`);
179
+ vars.push(`--motion-ease: ${motion.ease};`);
180
+ vars.push(`--motion-ease-in: ${motion.easeIn};`);
181
+ vars.push(`--motion-ease-out: ${motion.easeOut};`);
182
+
183
+ return vars.join('\n ');
184
+ }
package/src/index.ts ADDED
@@ -0,0 +1,3 @@
1
+ export * from './types';
2
+ export * from './create-theme';
3
+ export * from './presets';
@@ -0,0 +1,10 @@
1
+ import { createTheme } from '../create-theme';
2
+
3
+ /**
4
+ * Dark theme with a blue brand color
5
+ */
6
+ export const darkTheme = createTheme({
7
+ brandColor: '224 89% 53%',
8
+ borderRadius: '0.375rem',
9
+ darkMode: true,
10
+ });
@@ -0,0 +1,10 @@
1
+ import { createTheme } from '../create-theme';
2
+
3
+ /**
4
+ * Default theme with a blue brand color
5
+ */
6
+ export const defaultTheme = createTheme({
7
+ brandColor: '224 89% 53%',
8
+ borderRadius: '0.375rem',
9
+ darkMode: false,
10
+ });
@@ -0,0 +1,4 @@
1
+ export { defaultTheme } from './default';
2
+ export { darkTheme } from './dark';
3
+ export { zincTheme, zincDarkTheme } from './zinc';
4
+ export { violetTheme, violetDarkTheme } from './violet';
@@ -0,0 +1,16 @@
1
+ import { createTheme } from '../create-theme';
2
+
3
+ /**
4
+ * Violet theme - purple tones
5
+ */
6
+ export const violetTheme = createTheme({
7
+ brandColor: '263 70% 50%',
8
+ borderRadius: '0.375rem',
9
+ darkMode: false,
10
+ });
11
+
12
+ export const violetDarkTheme = createTheme({
13
+ brandColor: '263 70% 50%',
14
+ borderRadius: '0.375rem',
15
+ darkMode: true,
16
+ });
@@ -0,0 +1,16 @@
1
+ import { createTheme } from '../create-theme';
2
+
3
+ /**
4
+ * Zinc theme - neutral gray tones
5
+ */
6
+ export const zincTheme = createTheme({
7
+ brandColor: '240 5% 65%',
8
+ borderRadius: '0.375rem',
9
+ darkMode: false,
10
+ });
11
+
12
+ export const zincDarkTheme = createTheme({
13
+ brandColor: '240 5% 65%',
14
+ borderRadius: '0.375rem',
15
+ darkMode: true,
16
+ });
package/src/types.ts ADDED
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Theme Types
3
+ *
4
+ * Type definitions for the theming system
5
+ */
6
+
7
+ export type ThemeColors = {
8
+ background: string;
9
+ foreground: string;
10
+ primary: string;
11
+ 'primary-foreground': string;
12
+ secondary: string;
13
+ 'secondary-foreground': string;
14
+ muted: string;
15
+ 'muted-foreground': string;
16
+ accent: string;
17
+ 'accent-foreground': string;
18
+ destructive: string;
19
+ 'destructive-foreground': string;
20
+ success: string;
21
+ 'success-foreground': string;
22
+ warning: string;
23
+ 'warning-foreground': string;
24
+ /** Status label/text colour that clears AA on a neutral surface. */
25
+ 'warning-ink': string;
26
+ info: string;
27
+ 'info-foreground': string;
28
+ 'info-ink': string;
29
+ border: string;
30
+ input: string;
31
+ ring: string;
32
+ card: string;
33
+ 'card-foreground': string;
34
+ popover: string;
35
+ 'popover-foreground': string;
36
+ };
37
+
38
+ export type Theme = {
39
+ name: string;
40
+ colors: ThemeColors;
41
+ borderRadius?: string;
42
+ radius?: {
43
+ lg: string;
44
+ md: string;
45
+ sm: string;
46
+ };
47
+ /** Spacing density: controls padding/height of interactive elements. */
48
+ density?: {
49
+ /** Vertical padding token (default '0.5rem'). */
50
+ space: string;
51
+ /** Control height token (default '2.25rem'). */
52
+ controlHeight: string;
53
+ };
54
+ /** Motion tokens for transitions and animations. */
55
+ motion?: {
56
+ /** Fast transition duration (default '150ms'). */
57
+ fast: string;
58
+ /** Normal transition duration (default '250ms'). */
59
+ normal: string;
60
+ /** Slow transition duration (default '400ms'). */
61
+ slow: string;
62
+ /** Standard easing curve (default 'cubic-bezier(0.4, 0, 0.2, 1)'). */
63
+ ease: string;
64
+ /** Entrance/exit easing curve (default 'cubic-bezier(0.0, 0, 0.2, 1)'). */
65
+ easeIn: string;
66
+ /** Spring-like easing for emphasis (default 'cubic-bezier(0.34, 1.56, 0.64, 1)'). */
67
+ easeOut: string;
68
+ };
69
+ };
70
+
71
+ export type ThemeConfig = {
72
+ /**
73
+ * Brand color in HSL format (e.g., "224 89% 58%")
74
+ */
75
+ brandColor?: string;
76
+ /**
77
+ * Border radius in rem
78
+ */
79
+ borderRadius?: string;
80
+ /**
81
+ * Whether to use dark mode as default
82
+ */
83
+ darkMode?: boolean;
84
+ /**
85
+ * Spacing density: 'compact' | 'normal' | 'relaxed'
86
+ */
87
+ density?: 'compact' | 'normal' | 'relaxed';
88
+ };
@@ -0,0 +1,100 @@
1
+ /*
2
+ * Slipstream UI — Tailwind CSS v4 theme contract.
3
+ *
4
+ * Usage (v4, CSS-first):
5
+ *
6
+ * @import "tailwindcss";
7
+ * @import "@slipstream-ui/themes/tailwind-v4.css";
8
+ * @source "../../node_modules/@slipstream-ui/core/dist";
9
+ * @source "../../node_modules/@slipstream-ui/ai/dist";
10
+ *
11
+ * The `--color-*` mappings read the same HSL channel variables that
12
+ * `createTheme()` emits, so presets, dark mode and runtime theme switching
13
+ * keep working without a tailwind.config.js.
14
+ *
15
+ * Animated overlays use the `tailwindcss-animate` utilities
16
+ * (`animate-in`, `fade-in-0`, `slide-in-from-*`, …). With v4, load the
17
+ * plugin with `@plugin "tailwindcss-animate";` or import `tw-animate-css`
18
+ * before this file. Overlays still render without it; only motion is lost.
19
+ */
20
+
21
+ @custom-variant dark (&:where(.dark, .dark *));
22
+
23
+ @theme inline {
24
+ --color-background: hsl(var(--background));
25
+ --color-foreground: hsl(var(--foreground));
26
+
27
+ --color-primary: hsl(var(--primary));
28
+ --color-primary-foreground: hsl(var(--primary-foreground));
29
+
30
+ --color-secondary: hsl(var(--secondary));
31
+ --color-secondary-foreground: hsl(var(--secondary-foreground));
32
+
33
+ --color-muted: hsl(var(--muted));
34
+ --color-muted-foreground: hsl(var(--muted-foreground));
35
+
36
+ --color-accent: hsl(var(--accent));
37
+ --color-accent-foreground: hsl(var(--accent-foreground));
38
+
39
+ --color-destructive: hsl(var(--destructive));
40
+ --color-destructive-foreground: hsl(var(--destructive-foreground));
41
+
42
+ --color-success: hsl(var(--success));
43
+ --color-success-foreground: hsl(var(--success-foreground));
44
+
45
+ --color-warning: hsl(var(--warning));
46
+ --color-warning-foreground: hsl(var(--warning-foreground));
47
+ --color-warning-ink: hsl(var(--warning-ink));
48
+
49
+ --color-info: hsl(var(--info));
50
+ --color-info-foreground: hsl(var(--info-foreground));
51
+ --color-info-ink: hsl(var(--info-ink));
52
+
53
+ --color-border: hsl(var(--border));
54
+ --color-input: hsl(var(--input));
55
+ --color-ring: hsl(var(--ring));
56
+
57
+ --color-card: hsl(var(--card));
58
+ --color-card-foreground: hsl(var(--card-foreground));
59
+
60
+ --color-popover: hsl(var(--popover));
61
+ --color-popover-foreground: hsl(var(--popover-foreground));
62
+
63
+ --radius-lg: var(--radius-lg);
64
+ --radius-md: var(--radius-md);
65
+ --radius-sm: var(--radius-sm);
66
+
67
+ --spacing-density: var(--density-space);
68
+ --spacing-control-height: var(--density-control-height);
69
+
70
+ --transition-duration-fast: var(--motion-fast);
71
+ --transition-duration-normal: var(--motion-normal);
72
+ --transition-duration-slow: var(--motion-slow);
73
+
74
+ --ease-standard: var(--motion-ease);
75
+ --ease-in: var(--motion-ease-in);
76
+ --ease-out: var(--motion-ease-out);
77
+ }
78
+
79
+ @theme {
80
+ --animate-accordion-down: accordion-down 0.2s ease-out;
81
+ --animate-accordion-up: accordion-up 0.2s ease-out;
82
+
83
+ @keyframes accordion-down {
84
+ from {
85
+ height: 0;
86
+ }
87
+ to {
88
+ height: var(--radix-accordion-content-height);
89
+ }
90
+ }
91
+
92
+ @keyframes accordion-up {
93
+ from {
94
+ height: var(--radix-accordion-content-height);
95
+ }
96
+ to {
97
+ height: 0;
98
+ }
99
+ }
100
+ }
package/README.md DELETED
@@ -1,3 +0,0 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.