@nightshadeui/palette-generator 3.2.0 → 3.4.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/README.md CHANGED
@@ -13,4 +13,4 @@ const spec = PaletteSpecSchema.decode(JSON.parse(input));
13
13
  const css = generatePaletteCss(spec, ':root');
14
14
  ```
15
15
 
16
- A spec has twelve-step `lightnessCurve` and `chromaCurve`, and `ramps` of `{ name, hue, chroma, lightness }`. It must keep `base`, `primary` and `secondary`: the styles read them by name.
16
+ A spec has twelve-step `lightnessCurve` and `chromaCurve`, and `ramps` of `{ name, hue, chroma, lightness }`. A ramp may bring its own `lightnessCurve` or `chromaCurve` in place of the palette's; its multipliers apply to either. The spec must keep `base`, `primary` and `secondary`: the styles read them by name.
@@ -4,12 +4,13 @@ import { PaletteRampSpec, PaletteSpec, RampStep } from './types.js';
4
4
  * The dark ramp is the light ramp mirrored, so a step keeps its meaning in both schemes:
5
5
  * `0` is always the canvas end, `950` always the ink end.
6
6
  * Throws when the palette lacks a ramp the styles read by name, names a ramp twice or takes a reserved name,
7
- * or has a curve without one value per step.
7
+ * or has a curve (its own or a ramp's) without one value per step.
8
8
  */
9
9
  export declare function generatePaletteOklch(palette?: PaletteSpec): Record<string, string>;
10
10
  export declare function generateRampOklch(ramp: PaletteRampSpec, palette?: PaletteSpec): Record<string, string>;
11
11
  /**
12
- * Samples one ramp along the curves, as the light scheme sees it.
12
+ * Samples one ramp along its curves, as the light scheme sees it.
13
+ * A ramp's own curve takes the place of the palette's; the multipliers apply to either.
13
14
  */
14
15
  export declare function generateRampSteps(ramp: PaletteRampSpec, palette?: PaletteSpec): RampStep[];
15
16
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,WAAgB,0BAQ7D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,WAAgB,0BAgBjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,WAAgB,GAAG,QAAQ,EAAE,CAW9F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,UAM3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,WAAgB,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAc,UAQ9F;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,mBAE5D"}
1
+ {"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,WAAgB,0BAQ7D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,WAAgB,0BAgBjF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE,WAAgB,GAAG,QAAQ,EAAE,CAW9F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,UAM3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,WAAgB,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAc,UAQ9F;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,mBAE5D"}
package/dist/generate.js CHANGED
@@ -4,11 +4,11 @@ import { DEFAULT_CHROMA_CURVE, DEFAULT_LIGHTNESS_CURVE, DEFAULT_RAMPS, RAMP_ANCH
4
4
  * The dark ramp is the light ramp mirrored, so a step keeps its meaning in both schemes:
5
5
  * `0` is always the canvas end, `950` always the ink end.
6
6
  * Throws when the palette lacks a ramp the styles read by name, names a ramp twice or takes a reserved name,
7
- * or has a curve without one value per step.
7
+ * or has a curve (its own or a ramp's) without one value per step.
8
8
  */
9
9
  export function generatePaletteOklch(palette = {}) {
10
10
  const ramps = palette.ramps ?? DEFAULT_RAMPS;
11
- checkPalette(palette, ramps.map(ramp => ramp.name));
11
+ checkPalette(palette, ramps);
12
12
  const out = {};
13
13
  for (const ramp of ramps) {
14
14
  Object.assign(out, generateRampOklch(ramp, palette));
@@ -27,11 +27,12 @@ export function generateRampOklch(ramp, palette = {}) {
27
27
  return variables;
28
28
  }
29
29
  /**
30
- * Samples one ramp along the curves, as the light scheme sees it.
30
+ * Samples one ramp along its curves, as the light scheme sees it.
31
+ * A ramp's own curve takes the place of the palette's; the multipliers apply to either.
31
32
  */
32
33
  export function generateRampSteps(ramp, palette = {}) {
33
- const lightnessCurve = palette.lightnessCurve ?? DEFAULT_LIGHTNESS_CURVE;
34
- const chromaCurve = palette.chromaCurve ?? DEFAULT_CHROMA_CURVE;
34
+ const lightnessCurve = ramp.lightnessCurve ?? palette.lightnessCurve ?? DEFAULT_LIGHTNESS_CURVE;
35
+ const chromaCurve = ramp.chromaCurve ?? palette.chromaCurve ?? DEFAULT_CHROMA_CURVE;
35
36
  return RAMP_STEPS.map((step, index) => {
36
37
  return {
37
38
  step,
@@ -80,7 +81,8 @@ function wrapDeclarations(selector, lines) {
80
81
  function round(value) {
81
82
  return Math.round(value * 10000) / 10000;
82
83
  }
83
- function checkPalette(palette, names) {
84
+ function checkPalette(palette, ramps) {
85
+ const names = ramps.map(ramp => ramp.name);
84
86
  const missing = REQUIRED_RAMPS.filter(name => !names.includes(name));
85
87
  if (missing.length > 0) {
86
88
  throw new Error(`A palette needs these ramps, which the styles read by name: ${missing.join(', ')}.`);
@@ -93,9 +95,9 @@ function checkPalette(palette, names) {
93
95
  if (reserved.length > 0) {
94
96
  throw new Error(`These ramp names are reserved: ${reserved.join(', ')}.`);
95
97
  }
96
- const curves = [palette.lightnessCurve, palette.chromaCurve];
98
+ const curves = [palette, ...ramps].flatMap(owner => [owner.lightnessCurve, owner.chromaCurve]);
97
99
  if (curves.some(curve => curve && curve.length !== RAMP_STEPS.length)) {
98
- throw new Error(`A palette's curves have one value per step: ${RAMP_STEPS.length} values each.`);
100
+ throw new Error(`A palette's curves, and its ramps' own, have one value per step: ${RAMP_STEPS.length} values each.`);
99
101
  }
100
102
  }
101
103
  //# sourceMappingURL=generate.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"PaletteSpecSchema.d.ts","sourceRoot":"","sources":["../../src/schema/PaletteSpecSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qBAwC5B,CAAC"}
1
+ {"version":3,"file":"PaletteSpecSchema.d.ts","sourceRoot":"","sources":["../../src/schema/PaletteSpecSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qBAkD5B,CAAC"}
@@ -39,6 +39,16 @@ export const PaletteSpecSchema = new Schema({
39
39
  type: 'number',
40
40
  minimum: 0,
41
41
  },
42
+ lightnessCurve: {
43
+ type: 'array',
44
+ items: { type: 'number' },
45
+ optional: true,
46
+ },
47
+ chromaCurve: {
48
+ type: 'array',
49
+ items: { type: 'number' },
50
+ optional: true,
51
+ },
42
52
  },
43
53
  },
44
54
  optional: true,
@@ -1 +1 @@
1
- {"version":3,"file":"PaletteSpecSchema.js","sourceRoot":"","sources":["../../src/schema/PaletteSpecSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAc;IACrD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,cAAc,EAAE;YACZ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,QAAQ,EAAE,IAAI;SACjB;QACD,WAAW,EAAE;YACT,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,QAAQ,EAAE,IAAI;SACjB;QACD,KAAK,EAAE;YACH,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,KAAK,EAAE,iBAAiB;qBAC3B;oBACD,GAAG,EAAE;wBACD,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;qBACf;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;qBACb;oBACD,SAAS,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;qBACb;iBACJ;aACJ;YACD,QAAQ,EAAE,IAAI;SACjB;KACJ;CACJ,CAAC,CAAC"}
1
+ {"version":3,"file":"PaletteSpecSchema.js","sourceRoot":"","sources":["../../src/schema/PaletteSpecSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAc;IACrD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,cAAc,EAAE;YACZ,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,QAAQ,EAAE,IAAI;SACjB;QACD,WAAW,EAAE;YACT,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,QAAQ,EAAE,IAAI;SACjB;QACD,KAAK,EAAE;YACH,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,KAAK,EAAE,iBAAiB;qBAC3B;oBACD,GAAG,EAAE;wBACD,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;qBACf;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;qBACb;oBACD,SAAS,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;qBACb;oBACD,cAAc,EAAE;wBACZ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,QAAQ,EAAE,IAAI;qBACjB;oBACD,WAAW,EAAE;wBACT,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,QAAQ,EAAE,IAAI;qBACjB;iBACJ;aACJ;YACD,QAAQ,EAAE,IAAI;SACjB;KACJ;CACJ,CAAC,CAAC"}
package/dist/types.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * One color ramp: a hue sampled along the shared lightness and chroma curves.
2
+ * One color ramp: a hue sampled along the palette's lightness and chroma curves, or its own.
3
3
  * Every ramp is also a tone: the generator emits a `.tone-<name>` context for it.
4
4
  */
5
5
  export interface PaletteRampSpec {
@@ -9,6 +9,10 @@ export interface PaletteRampSpec {
9
9
  chroma: number;
10
10
  /** Multiplier applied to the lightness curve (1 = curve as is). */
11
11
  lightness: number;
12
+ /** This ramp's own lightness curve, in place of the palette's. */
13
+ lightnessCurve?: number[];
14
+ /** This ramp's own chroma curve, in place of the palette's. */
15
+ chromaCurve?: number[];
12
16
  }
13
17
  export interface PaletteSpec {
14
18
  lightnessCurve?: number[];
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACf"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACf"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nightshadeui/palette-generator",
3
- "version": "3.2.0",
3
+ "version": "3.4.0",
4
4
  "description": "OKLCH palette CSS variable generator for Nightshade",
5
5
  "author": "Boris Okunskiy",
6
6
  "license": "ISC",
package/src/generate.ts CHANGED
@@ -14,11 +14,11 @@ import { PaletteRampSpec, PaletteSpec, RampStep } from './types.js';
14
14
  * The dark ramp is the light ramp mirrored, so a step keeps its meaning in both schemes:
15
15
  * `0` is always the canvas end, `950` always the ink end.
16
16
  * Throws when the palette lacks a ramp the styles read by name, names a ramp twice or takes a reserved name,
17
- * or has a curve without one value per step.
17
+ * or has a curve (its own or a ramp's) without one value per step.
18
18
  */
19
19
  export function generatePaletteOklch(palette: PaletteSpec = {}) {
20
20
  const ramps = palette.ramps ?? DEFAULT_RAMPS;
21
- checkPalette(palette, ramps.map(ramp => ramp.name));
21
+ checkPalette(palette, ramps);
22
22
  const out: Record<string, string> = {};
23
23
  for (const ramp of ramps) {
24
24
  Object.assign(out, generateRampOklch(ramp, palette));
@@ -45,11 +45,12 @@ export function generateRampOklch(ramp: PaletteRampSpec, palette: PaletteSpec =
45
45
  }
46
46
 
47
47
  /**
48
- * Samples one ramp along the curves, as the light scheme sees it.
48
+ * Samples one ramp along its curves, as the light scheme sees it.
49
+ * A ramp's own curve takes the place of the palette's; the multipliers apply to either.
49
50
  */
50
51
  export function generateRampSteps(ramp: PaletteRampSpec, palette: PaletteSpec = {}): RampStep[] {
51
- const lightnessCurve = palette.lightnessCurve ?? DEFAULT_LIGHTNESS_CURVE;
52
- const chromaCurve = palette.chromaCurve ?? DEFAULT_CHROMA_CURVE;
52
+ const lightnessCurve = ramp.lightnessCurve ?? palette.lightnessCurve ?? DEFAULT_LIGHTNESS_CURVE;
53
+ const chromaCurve = ramp.chromaCurve ?? palette.chromaCurve ?? DEFAULT_CHROMA_CURVE;
53
54
  return RAMP_STEPS.map((step, index) => {
54
55
  return {
55
56
  step,
@@ -106,7 +107,8 @@ function round(value: number) {
106
107
  return Math.round(value * 10000) / 10000;
107
108
  }
108
109
 
109
- function checkPalette(palette: PaletteSpec, names: string[]) {
110
+ function checkPalette(palette: PaletteSpec, ramps: PaletteRampSpec[]) {
111
+ const names = ramps.map(ramp => ramp.name);
110
112
  const missing = REQUIRED_RAMPS.filter(name => !names.includes(name));
111
113
  if (missing.length > 0) {
112
114
  throw new Error(`A palette needs these ramps, which the styles read by name: ${missing.join(', ')}.`);
@@ -119,8 +121,8 @@ function checkPalette(palette: PaletteSpec, names: string[]) {
119
121
  if (reserved.length > 0) {
120
122
  throw new Error(`These ramp names are reserved: ${reserved.join(', ')}.`);
121
123
  }
122
- const curves = [palette.lightnessCurve, palette.chromaCurve];
124
+ const curves = [palette, ...ramps].flatMap(owner => [owner.lightnessCurve, owner.chromaCurve]);
123
125
  if (curves.some(curve => curve && curve.length !== RAMP_STEPS.length)) {
124
- throw new Error(`A palette's curves have one value per step: ${RAMP_STEPS.length} values each.`);
126
+ throw new Error(`A palette's curves, and its ramps' own, have one value per step: ${RAMP_STEPS.length} values each.`);
125
127
  }
126
128
  }
@@ -42,6 +42,16 @@ export const PaletteSpecSchema = new Schema<PaletteSpec>({
42
42
  type: 'number',
43
43
  minimum: 0,
44
44
  },
45
+ lightnessCurve: {
46
+ type: 'array',
47
+ items: { type: 'number' },
48
+ optional: true,
49
+ },
50
+ chromaCurve: {
51
+ type: 'array',
52
+ items: { type: 'number' },
53
+ optional: true,
54
+ },
45
55
  },
46
56
  },
47
57
  optional: true,
package/src/types.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * One color ramp: a hue sampled along the shared lightness and chroma curves.
2
+ * One color ramp: a hue sampled along the palette's lightness and chroma curves, or its own.
3
3
  * Every ramp is also a tone: the generator emits a `.tone-<name>` context for it.
4
4
  */
5
5
  export interface PaletteRampSpec {
@@ -9,6 +9,10 @@ export interface PaletteRampSpec {
9
9
  chroma: number;
10
10
  /** Multiplier applied to the lightness curve (1 = curve as is). */
11
11
  lightness: number;
12
+ /** This ramp's own lightness curve, in place of the palette's. */
13
+ lightnessCurve?: number[];
14
+ /** This ramp's own chroma curve, in place of the palette's. */
15
+ chromaCurve?: number[];
12
16
  }
13
17
 
14
18
  export interface PaletteSpec {