@mndw/palette-core 0.0.0-stage → 0.1.2

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,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Eralde
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
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,6 @@
1
- # Temporary Holding Version
1
+ # @mndw/palette-core
2
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.
3
+ Shared TypeScript palette math and contract metadata for mndw packages.
4
+
5
+ The package exports palette contrast helpers, CSS conversion, palette generation, and palette
6
+ metadata. It is used by `@mndw/sdk` and the repository's palette build tooling.
@@ -0,0 +1,21 @@
1
+ import { type ThemeName, type TokenName } from './metadata.js';
2
+ export interface Seed {
3
+ primary: string;
4
+ danger: string;
5
+ success?: string;
6
+ warning?: string;
7
+ info?: string;
8
+ bg: Record<ThemeName, string>;
9
+ text: Record<ThemeName, string>;
10
+ steps: number;
11
+ }
12
+ export declare const SEED: Seed;
13
+ export declare const PAIRS: readonly import("./metadata.js").PaletteContrastPair[];
14
+ export declare function buildPalette(theme: ThemeName, seed?: Seed): Record<TokenName, string>;
15
+ export declare function validatePalette(palette: Record<TokenName, string>): {
16
+ pair: string;
17
+ ratio: number;
18
+ min: number;
19
+ pass: boolean;
20
+ }[];
21
+ //# sourceMappingURL=build-palette.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-palette.d.ts","sourceRoot":"","sources":["../src/build-palette.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAC,MAAM,eAAe,CAAC;AAGrF,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,IAAI,EAAE,IAMlB,CAAC;AAEF,eAAO,MAAM,KAAK,wDAAyB,CAAC;AAkE5C,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,IAAW,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CA0D3F;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GACjC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,EAAE,CAW7D"}
@@ -0,0 +1,120 @@
1
+ import { contrastRatio } from './contrast.js';
2
+ import { PALETTE_CONTRAST_PAIRS } from './metadata.js';
3
+ import { nudgeHexForContrast, oklchOf, oklchToHex, rampBetween, shiftLightness, withAlpha } from './ramp.js';
4
+ export const SEED = {
5
+ primary: '#016ca5',
6
+ danger: '#c5001b',
7
+ bg: { dark: '#030405', light: '#f7fcfd' },
8
+ text: { dark: '#eaf3fb', light: '#0c1217' },
9
+ steps: 12,
10
+ };
11
+ export const PAIRS = PALETTE_CONTRAST_PAIRS;
12
+ const SURFACE_SHIFT = {
13
+ dark: { surface: 0.06, raised: 0.1 },
14
+ light: { surface: -0.03, raised: -0.015 },
15
+ };
16
+ const STATUS_BG_LIGHTNESS = { dark: 0.22, light: 0.95 };
17
+ const STATUS_BG_CHROMA = 0.4;
18
+ const STATUS_DEFAULTS = {
19
+ success: { c: 0.13, h: 150, l: { dark: 0.7, light: 0.5 } },
20
+ warning: { c: 0.15, h: 75, l: { dark: 0.78, light: 0.62 } },
21
+ };
22
+ const ACCENT_SHIFT = {
23
+ hover: { dark: 0.08, light: -0.08 },
24
+ focus: { dark: 0.1, light: -0.1 },
25
+ };
26
+ const SURFACE_HOVER_SHIFT = { dark: 0.04, light: -0.03 };
27
+ const SHADOW = {
28
+ shift: { dark: -0.02, light: -0.6 },
29
+ alpha: { dark: 0.55, light: 0.18 },
30
+ };
31
+ const TEXT_INDEX = { border: 5, textSubtle: 9, textMuted: 10 };
32
+ function statusBg(color, theme) {
33
+ const { c, h } = oklchOf(color);
34
+ return oklchToHex(STATUS_BG_LIGHTNESS[theme], c * STATUS_BG_CHROMA, h);
35
+ }
36
+ function statusDefault(name, theme) {
37
+ const { c, h, l } = STATUS_DEFAULTS[name];
38
+ return oklchToHex(l[theme], c, h);
39
+ }
40
+ function enforceContrast(palette) {
41
+ const nudge = (token, against, min) => {
42
+ if (contrastRatio(palette[token], palette[against]) < min) {
43
+ palette[token] = nudgeHexForContrast(palette[token], palette[against], min);
44
+ }
45
+ };
46
+ nudge('surfaceRaised', 'text', 4.5);
47
+ nudge('surfaceHover', 'text', 4.5);
48
+ const worseSurface = (token) => contrastRatio(palette[token], palette.surface) <= contrastRatio(palette[token], palette.surfaceRaised)
49
+ ? 'surface'
50
+ : 'surfaceRaised';
51
+ nudge('textMuted', worseSurface('textMuted'), 4.5);
52
+ nudge('textSubtle', worseSurface('textSubtle'), 4.5);
53
+ nudge('border', worseSurface('border'), 3);
54
+ nudge('focusRing', 'surfaceRaised', 3);
55
+ nudge('dangerBg', 'danger', 4.5);
56
+ nudge('successBg', 'success', 4.5);
57
+ nudge('warningBg', 'warning', 4.5);
58
+ nudge('infoBg', 'info', 4.5);
59
+ }
60
+ export function buildPalette(theme, seed = SEED) {
61
+ const neutral = rampBetween(seed.bg[theme], seed.text[theme], seed.steps);
62
+ const bg = neutral[0];
63
+ const surface = shiftLightness(bg, SURFACE_SHIFT[theme].surface);
64
+ const surfaceRaised = shiftLightness(bg, SURFACE_SHIFT[theme].raised);
65
+ const border = neutral[TEXT_INDEX.border];
66
+ const textSubtle = neutral[TEXT_INDEX.textSubtle];
67
+ const textMuted = neutral[TEXT_INDEX.textMuted];
68
+ const text = neutral[seed.steps - 1];
69
+ const accent = seed.primary;
70
+ const accentHover = shiftLightness(accent, ACCENT_SHIFT.hover[theme]);
71
+ const accentContrast = contrastRatio('#ffffff', accent) >= contrastRatio('#111111', accent) ? '#ffffff' : '#111111';
72
+ const danger = seed.danger;
73
+ const dangerBg = statusBg(danger, theme);
74
+ const success = seed.success ?? statusDefault('success', theme);
75
+ const successBg = statusBg(success, theme);
76
+ const warning = seed.warning ?? statusDefault('warning', theme);
77
+ const warningBg = statusBg(warning, theme);
78
+ const info = seed.info ?? seed.primary;
79
+ const infoBg = statusBg(info, theme);
80
+ const focusRing = shiftLightness(accent, ACCENT_SHIFT.focus[theme]);
81
+ const surfaceHover = shiftLightness(surfaceRaised, SURFACE_HOVER_SHIFT[theme]);
82
+ const shadowColor = withAlpha(shiftLightness(bg, SHADOW.shift[theme]), SHADOW.alpha[theme]);
83
+ const palette = {
84
+ bg,
85
+ surface,
86
+ surfaceRaised,
87
+ border,
88
+ textSubtle,
89
+ textMuted,
90
+ text,
91
+ accent,
92
+ accentHover,
93
+ accentContrast,
94
+ danger,
95
+ dangerBg,
96
+ success,
97
+ successBg,
98
+ warning,
99
+ warningBg,
100
+ info,
101
+ infoBg,
102
+ focusRing,
103
+ surfaceHover,
104
+ shadowColor,
105
+ };
106
+ enforceContrast(palette);
107
+ return palette;
108
+ }
109
+ export function validatePalette(palette) {
110
+ return PAIRS.map((pair) => {
111
+ const ratio = contrastRatio(palette[pair.fg], palette[pair.bg]);
112
+ return {
113
+ pair: `${pair.fg} on ${pair.bg}`,
114
+ ratio: Math.round(ratio * 100) / 100,
115
+ min: pair.min,
116
+ pass: ratio >= pair.min,
117
+ };
118
+ });
119
+ }
120
+ //# sourceMappingURL=build-palette.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build-palette.js","sourceRoot":"","sources":["../src/build-palette.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export declare function contrastRatio(fgHex: string, bgHex: string): number;
2
+ export declare function meetsContrast(fgHex: string, bgHex: string, target: number): boolean;
3
+ //# sourceMappingURL=contrast.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AA0BA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnF"}
@@ -0,0 +1,31 @@
1
+ function hexToChannels(hex) {
2
+ const normalized = hex.replace('#', '');
3
+ const value = normalized.length === 3
4
+ ? normalized.split('').map((channel) => channel + channel)
5
+ .join('')
6
+ : normalized;
7
+ return [
8
+ parseInt(value.slice(0, 2), 16),
9
+ parseInt(value.slice(2, 4), 16),
10
+ parseInt(value.slice(4, 6), 16),
11
+ ];
12
+ }
13
+ function linearize(channel) {
14
+ const c = channel / 255;
15
+ return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
16
+ }
17
+ function relativeLuminance(hex) {
18
+ const [r, g, b] = hexToChannels(hex);
19
+ return 0.2126 * linearize(r) + 0.7152 * linearize(g) + 0.0722 * linearize(b);
20
+ }
21
+ export function contrastRatio(fgHex, bgHex) {
22
+ const l1 = relativeLuminance(fgHex);
23
+ const l2 = relativeLuminance(bgHex);
24
+ const lighter = Math.max(l1, l2);
25
+ const darker = Math.min(l1, l2);
26
+ return (lighter + 0.05) / (darker + 0.05);
27
+ }
28
+ export function meetsContrast(fgHex, bgHex, target) {
29
+ return contrastRatio(fgHex, bgHex) >= target;
30
+ }
31
+ //# sourceMappingURL=contrast.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contrast.js","sourceRoot":"","sources":["../src/contrast.ts"],"names":[],"mappings":"AAAA,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC;QACnC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC;aACvD,IAAI,CAAC,EAAE,CAAC;QACX,CAAC,CAAC,UAAU,CAAC;IAEf,OAAO;QACL,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/B,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/B,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC;IAExB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AACjE,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAErC,OAAO,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAa;IACxD,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAa,EAAE,MAAc;IACxE,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC;AAC/C,CAAC"}
package/dist/css.d.ts ADDED
@@ -0,0 +1,5 @@
1
+ import { type PaletteTokenMap } from './metadata.js';
2
+ export declare function paletteToCss(map: PaletteTokenMap, options?: {
3
+ selector?: string;
4
+ }): string;
5
+ //# sourceMappingURL=css.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,eAAe,EAAiB,MAAM,eAAe,CAAC;AAE1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,GAAE;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,MAAM,CAc5F"}
package/dist/css.js ADDED
@@ -0,0 +1,15 @@
1
+ import { PALETTE_CSS_VARIABLES } from './metadata.js';
2
+ export function paletteToCss(map, options = {}) {
3
+ const selector = options.selector ?? ':root';
4
+ const block = (theme) => PALETTE_CSS_VARIABLES.map((entry) => ` ${entry.cssVar}: ${map[theme][entry.token]};`).join('\n');
5
+ return `${selector},
6
+ ${selector}[data-theme='dark'] {
7
+ ${block('dark')}
8
+ }
9
+
10
+ ${selector}[data-theme='light'] {
11
+ ${block('light')}
12
+ }
13
+ `;
14
+ }
15
+ //# sourceMappingURL=css.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"css.js","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,qBAAqB,EAAuC,MAAM,eAAe,CAAC;AAE1F,MAAM,UAAU,YAAY,CAAC,GAAoB,EAAE,UAA+B,EAAE;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC7C,MAAM,KAAK,GAAG,CAAC,KAAgB,EAAU,EAAE,CACzC,qBAAqB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEpG,OAAO,GAAG,QAAQ;EAClB,QAAQ;EACR,KAAK,CAAC,MAAM,CAAC;;;EAGb,QAAQ;EACR,KAAK,CAAC,OAAO,CAAC;;CAEf,CAAC;AACF,CAAC"}
@@ -0,0 +1,9 @@
1
+ export { contrastRatio, meetsContrast } from './contrast.js';
2
+ export { paletteToCss } from './css.js';
3
+ export { buildPalette, PAIRS, SEED, validatePalette } from './build-palette.js';
4
+ export type { Seed } from './build-palette.js';
5
+ export { PALETTE_CONTRAST_PAIRS, PALETTE_CSS_VARIABLES } from './metadata.js';
6
+ export type { PaletteContrastPair, PaletteCssVariable, PaletteTokenMap, ThemeName, TokenName } from './metadata.js';
7
+ export { buildRamp, nudgeForContrast, nudgeHexForContrast, oklchOf, oklchToHex, rampBetween, shiftLightness, withAlpha, } from './ramp.js';
8
+ export type { Oklch } from './ramp.js';
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AACtC,OAAO,EAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAC,IAAI,EAAC,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAC,sBAAsB,EAAE,qBAAqB,EAAC,MAAM,eAAe,CAAC;AAC5E,YAAY,EAAC,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAC,MAAM,eAAe,CAAC;AAClH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EAAC,KAAK,EAAC,MAAM,WAAW,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,6 @@
1
+ export { contrastRatio, meetsContrast } from './contrast.js';
2
+ export { paletteToCss } from './css.js';
3
+ export { buildPalette, PAIRS, SEED, validatePalette } from './build-palette.js';
4
+ export { PALETTE_CONTRAST_PAIRS, PALETTE_CSS_VARIABLES } from './metadata.js';
5
+ export { buildRamp, nudgeForContrast, nudgeHexForContrast, oklchOf, oklchToHex, rampBetween, shiftLightness, withAlpha, } from './ramp.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AACtC,OAAO,EAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EAAC,sBAAsB,EAAE,qBAAqB,EAAC,MAAM,eAAe,CAAC;AAE5E,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC"}
@@ -0,0 +1,15 @@
1
+ export type ThemeName = 'light' | 'dark';
2
+ export type TokenName = 'bg' | 'surface' | 'surfaceRaised' | 'border' | 'textSubtle' | 'textMuted' | 'text' | 'accent' | 'accentHover' | 'accentContrast' | 'danger' | 'dangerBg' | 'success' | 'successBg' | 'warning' | 'warningBg' | 'info' | 'infoBg' | 'focusRing' | 'surfaceHover' | 'shadowColor';
3
+ export type PaletteTokenMap = Record<ThemeName, Record<TokenName, string>>;
4
+ export interface PaletteCssVariable {
5
+ token: TokenName;
6
+ cssVar: string;
7
+ }
8
+ export declare const PALETTE_CSS_VARIABLES: readonly PaletteCssVariable[];
9
+ export interface PaletteContrastPair {
10
+ fg: TokenName;
11
+ bg: TokenName;
12
+ min: number;
13
+ }
14
+ export declare const PALETTE_CONTRAST_PAIRS: readonly PaletteContrastPair[];
15
+ //# sourceMappingURL=metadata.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,SAAS,GACT,eAAe,GACf,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,MAAM,GACN,QAAQ,GACR,aAAa,GACb,gBAAgB,GAChB,QAAQ,GACR,UAAU,GACV,SAAS,GACT,WAAW,GACX,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,WAAW,GACX,cAAc,GACd,aAAa,CAAC;AAElB,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAsBrD,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,SAAS,CAAC;IACd,EAAE,EAAE,SAAS,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAiBvD,CAAC"}
@@ -0,0 +1,42 @@
1
+ export const PALETTE_CSS_VARIABLES = [
2
+ { token: 'bg', cssVar: '--mndw-bg' },
3
+ { token: 'surface', cssVar: '--mndw-surface' },
4
+ { token: 'surfaceRaised', cssVar: '--mndw-surface-raised' },
5
+ { token: 'border', cssVar: '--mndw-border' },
6
+ { token: 'textSubtle', cssVar: '--mndw-text-subtle' },
7
+ { token: 'textMuted', cssVar: '--mndw-text-muted' },
8
+ { token: 'text', cssVar: '--mndw-text' },
9
+ { token: 'accent', cssVar: '--mndw-accent' },
10
+ { token: 'accentHover', cssVar: '--mndw-accent-hover' },
11
+ { token: 'accentContrast', cssVar: '--mndw-accent-contrast' },
12
+ { token: 'danger', cssVar: '--mndw-danger' },
13
+ { token: 'dangerBg', cssVar: '--mndw-danger-bg' },
14
+ { token: 'success', cssVar: '--mndw-success' },
15
+ { token: 'successBg', cssVar: '--mndw-success-bg' },
16
+ { token: 'warning', cssVar: '--mndw-warning' },
17
+ { token: 'warningBg', cssVar: '--mndw-warning-bg' },
18
+ { token: 'info', cssVar: '--mndw-info' },
19
+ { token: 'infoBg', cssVar: '--mndw-info-bg' },
20
+ { token: 'focusRing', cssVar: '--mndw-focus-ring' },
21
+ { token: 'surfaceHover', cssVar: '--mndw-surface-hover' },
22
+ { token: 'shadowColor', cssVar: '--mndw-shadow-color' },
23
+ ];
24
+ export const PALETTE_CONTRAST_PAIRS = [
25
+ { fg: 'text', bg: 'surface', min: 4.5 },
26
+ { fg: 'text', bg: 'bg', min: 4.5 },
27
+ { fg: 'textMuted', bg: 'surface', min: 4.5 },
28
+ { fg: 'textSubtle', bg: 'surface', min: 4.5 },
29
+ { fg: 'border', bg: 'surface', min: 3 },
30
+ { fg: 'accentContrast', bg: 'accent', min: 4.5 },
31
+ { fg: 'danger', bg: 'dangerBg', min: 4.5 },
32
+ { fg: 'text', bg: 'surfaceRaised', min: 4.5 },
33
+ { fg: 'text', bg: 'surfaceHover', min: 4.5 },
34
+ { fg: 'textSubtle', bg: 'surfaceRaised', min: 4.5 },
35
+ { fg: 'textMuted', bg: 'surfaceRaised', min: 4.5 },
36
+ { fg: 'border', bg: 'surfaceRaised', min: 3 },
37
+ { fg: 'focusRing', bg: 'surfaceRaised', min: 3 },
38
+ { fg: 'success', bg: 'successBg', min: 4.5 },
39
+ { fg: 'warning', bg: 'warningBg', min: 4.5 },
40
+ { fg: 'info', bg: 'infoBg', min: 4.5 },
41
+ ];
42
+ //# sourceMappingURL=metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"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"}
package/dist/ramp.d.ts ADDED
@@ -0,0 +1,26 @@
1
+ export interface Oklch {
2
+ l: number;
3
+ c: number;
4
+ h: number;
5
+ }
6
+ export declare function oklchToHex(l: number, c: number, h: number): string;
7
+ export declare function oklchOf(hex: string): Oklch;
8
+ export declare function shiftLightness(hex: string, delta: number): string;
9
+ export declare function withAlpha(hex: string, alpha: number): string;
10
+ export declare function rampBetween(fromHex: string, toHex: string, steps: number): string[];
11
+ export declare function buildRamp(opts: {
12
+ hue: number;
13
+ chroma: number;
14
+ steps: number;
15
+ lMin: number;
16
+ lMax: number;
17
+ }): string[];
18
+ export declare function nudgeForContrast(opts: {
19
+ hue: number;
20
+ chroma: number;
21
+ l: number;
22
+ bgHex: string;
23
+ target: number;
24
+ }): string;
25
+ export declare function nudgeHexForContrast(fgHex: string, bgHex: string, target: number): string;
26
+ //# sourceMappingURL=ramp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ramp.d.ts","sourceRoot":"","sources":["../src/ramp.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAQ1C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAa5D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBnF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAAG,MAAM,EAAE,CAYlH;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAC5E,MAAM,CAkBR;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxF"}
package/dist/ramp.js ADDED
@@ -0,0 +1,78 @@
1
+ import { clampChroma, formatHex, oklch } from 'culori';
2
+ import { contrastRatio } from './contrast.js';
3
+ export function oklchToHex(l, c, h) {
4
+ const clamped = clampChroma({ mode: 'oklch', l, c, h }, 'oklch');
5
+ return formatHex(clamped ?? { mode: 'oklch', l, c: 0, h });
6
+ }
7
+ export function oklchOf(hex) {
8
+ const parsed = oklch(hex);
9
+ if (!parsed) {
10
+ return { l: 0, c: 0, h: 0 };
11
+ }
12
+ return { l: parsed.l, c: parsed.c, h: parsed.h ?? 0 };
13
+ }
14
+ export function shiftLightness(hex, delta) {
15
+ const { l, c, h } = oklchOf(hex);
16
+ return oklchToHex(Math.min(1, Math.max(0, l + delta)), c, h);
17
+ }
18
+ export function withAlpha(hex, alpha) {
19
+ const normalized = hex.replace('#', '');
20
+ const rgb = normalized.length === 3
21
+ ? normalized.split('')
22
+ .map((channel) => channel + channel)
23
+ .join('')
24
+ : normalized.slice(0, 6);
25
+ const alphaByte = Math.round(Math.min(1, Math.max(0, alpha)) * 255).toString(16)
26
+ .padStart(2, '0');
27
+ return `#${rgb}${alphaByte}`;
28
+ }
29
+ export function rampBetween(fromHex, toHex, steps) {
30
+ const from = oklchOf(fromHex);
31
+ const to = oklchOf(toHex);
32
+ const ramp = [];
33
+ for (let i = 0; i < steps; i++) {
34
+ if (i === 0) {
35
+ ramp.push(fromHex);
36
+ continue;
37
+ }
38
+ if (i === steps - 1) {
39
+ ramp.push(toHex);
40
+ continue;
41
+ }
42
+ const t = i / (steps - 1);
43
+ const l = from.l + (to.l - from.l) * t;
44
+ const c = from.c + (to.c - from.c) * t;
45
+ const h = from.h + (to.h - from.h) * t;
46
+ ramp.push(oklchToHex(l, c, h));
47
+ }
48
+ return ramp;
49
+ }
50
+ export function buildRamp(opts) {
51
+ const { hue, chroma, steps, lMin, lMax } = opts;
52
+ const ramp = [];
53
+ for (let i = 0; i < steps; i++) {
54
+ const t = steps === 1 ? 0 : i / (steps - 1);
55
+ const l = lMin + (lMax - lMin) * t;
56
+ ramp.push(oklchToHex(l, chroma, hue));
57
+ }
58
+ return ramp;
59
+ }
60
+ export function nudgeForContrast(opts) {
61
+ const { hue, chroma, bgHex, target } = opts;
62
+ const step = 0.01;
63
+ let l = opts.l;
64
+ const towardLight = contrastRatio(oklchToHex(1, 0, hue), bgHex);
65
+ const towardDark = contrastRatio(oklchToHex(0, 0, hue), bgHex);
66
+ const direction = towardLight >= towardDark ? step : -step;
67
+ let hex = oklchToHex(l, chroma, hue);
68
+ while (contrastRatio(hex, bgHex) < target && l > 0 && l < 1) {
69
+ l = Math.min(1, Math.max(0, l + direction));
70
+ hex = oklchToHex(l, chroma, hue);
71
+ }
72
+ return hex;
73
+ }
74
+ export function nudgeHexForContrast(fgHex, bgHex, target) {
75
+ const { l, c, h } = oklchOf(fgHex);
76
+ return nudgeForContrast({ hue: h, chroma: c, l, bgHex, target });
77
+ }
78
+ //# sourceMappingURL=ramp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ramp.js","sourceRoot":"","sources":["../src/ramp.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,55 @@
1
1
  {
2
2
  "name": "@mndw/palette-core",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.2",
4
+ "license": "MIT",
5
+ "homepage": "https://eralde.github.io/mndw/",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/Eralde/mndw.git",
9
+ "directory": "tooling/palette-core"
10
+ },
11
+ "type": "module",
12
+ "description": "Shared TypeScript palette math and contract metadata.",
13
+ "exports": {
14
+ ".": {
15
+ "types": "./dist/index.d.ts",
16
+ "default": "./dist/index.js"
17
+ },
18
+ "./contrast": {
19
+ "types": "./dist/contrast.d.ts",
20
+ "default": "./dist/contrast.js"
21
+ },
22
+ "./metadata": {
23
+ "types": "./dist/metadata.d.ts",
24
+ "default": "./dist/metadata.js"
25
+ },
26
+ "./build-palette": {
27
+ "types": "./dist/build-palette.d.ts",
28
+ "default": "./dist/build-palette.js"
29
+ }
30
+ },
31
+ "files": [
32
+ "dist",
33
+ "README.md"
34
+ ],
35
+ "engines": {
36
+ "node": ">=20.19"
37
+ },
38
+ "publishConfig": {
39
+ "access": "public"
40
+ },
41
+ "dependencies": {
42
+ "culori": "^4.0.2"
43
+ },
44
+ "devDependencies": {
45
+ "@types/culori": "^4.0.1",
46
+ "typescript": "^5.7.0",
47
+ "vitest": "^3.2.7"
48
+ },
49
+ "scripts": {
50
+ "test": "vitest run",
51
+ "build": "tsc -p tsconfig.build.json"
52
+ },
53
+ "main": "./dist/index.js",
54
+ "types": "./dist/index.d.ts"
6
55
  }