@nightshadeui/palette-generator 3.0.0 → 3.1.1

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.
@@ -7,6 +7,10 @@ export declare const RAMP_ANCHOR_INDEX = 6;
7
7
  * `primary` and `secondary` for brand accents (neutral controls focus in `secondary`).
8
8
  */
9
9
  export declare const REQUIRED_RAMPS: string[];
10
+ /** Ramp names the generator won't take: `inverse` is the mirrored `base` tone the styles define. */
11
+ export declare const RESERVED_RAMPS: string[];
12
+ /** Ramp names are lowercase kebab-case, so each one makes a valid `.tone-<name>` class. */
13
+ export declare const RAMP_NAME_PATTERN = "^[a-z][a-z0-9]*(-[a-z0-9]+)*$";
10
14
  export declare const DEFAULT_LIGHTNESS_CURVE: number[];
11
15
  export declare const DEFAULT_CHROMA_CURVE: number[];
12
16
  export declare const DEFAULT_RAMPS: PaletteRampSpec[];
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,UAAU,UAEtB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAmC,CAAC;AAE/D,eAAO,MAAM,uBAAuB,UAEnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,UAEhC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EA2C1C,CAAC"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,UAAU,UAEtB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAmC,CAAC;AAE/D,oGAAoG;AACpG,eAAO,MAAM,cAAc,UAAc,CAAC;AAE1C,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AAEjE,eAAO,MAAM,uBAAuB,UAEnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,UAEhC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EA2C1C,CAAC"}
package/dist/constants.js CHANGED
@@ -8,6 +8,10 @@ export const RAMP_ANCHOR_INDEX = 6;
8
8
  * `primary` and `secondary` for brand accents (neutral controls focus in `secondary`).
9
9
  */
10
10
  export const REQUIRED_RAMPS = ['base', 'primary', 'secondary'];
11
+ /** Ramp names the generator won't take: `inverse` is the mirrored `base` tone the styles define. */
12
+ export const RESERVED_RAMPS = ['inverse'];
13
+ /** Ramp names are lowercase kebab-case, so each one makes a valid `.tone-<name>` class. */
14
+ export const RAMP_NAME_PATTERN = '^[a-z][a-z0-9]*(-[a-z0-9]+)*$';
11
15
  export const DEFAULT_LIGHTNESS_CURVE = [
12
16
  1, 0.98, 0.94, 0.88, 0.80, 0.72, 0.64, 0.56, 0.48, 0.42, 0.36, 0.32,
13
17
  ];
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC1D,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACzE,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC5C;QACI,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;KAClB;IACD;QACI,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;KACjB;CACJ,CAAC"}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAC1D,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAE/D,oGAAoG;AACpG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,CAAC,CAAC;AAE1C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAEjE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACzE,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC5C;QACI,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,CAAC;KACf;IACD;QACI,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;KAClB;IACD;QACI,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,GAAG;KACjB;CACJ,CAAC"}
@@ -3,7 +3,8 @@ import { PaletteRampSpec, PaletteSpec, RampStep } from './types.js';
3
3
  * Emits every ramp as scheme-aware CSS values: `light-dark(<light>, <dark>)`.
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
- * Throws when the palette lacks a ramp the styles read by name.
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
8
  */
8
9
  export declare function generatePaletteOklch(palette?: PaletteSpec): Record<string, string>;
9
10
  export declare function generateRampOklch(ramp: PaletteRampSpec, palette?: PaletteSpec): Record<string, string>;
@@ -1 +1 @@
1
- {"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,WAAgB,0BAW7D;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;;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"}
package/dist/generate.js CHANGED
@@ -1,16 +1,14 @@
1
- import { DEFAULT_CHROMA_CURVE, DEFAULT_LIGHTNESS_CURVE, DEFAULT_RAMPS, RAMP_ANCHOR_INDEX, RAMP_STEPS, REQUIRED_RAMPS, } from './constants.js';
1
+ import { DEFAULT_CHROMA_CURVE, DEFAULT_LIGHTNESS_CURVE, DEFAULT_RAMPS, RAMP_ANCHOR_INDEX, RAMP_STEPS, REQUIRED_RAMPS, RESERVED_RAMPS, } from './constants.js';
2
2
  /**
3
3
  * Emits every ramp as scheme-aware CSS values: `light-dark(<light>, <dark>)`.
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
- * Throws when the palette lacks a ramp the styles read by name.
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
8
  */
8
9
  export function generatePaletteOklch(palette = {}) {
9
10
  const ramps = palette.ramps ?? DEFAULT_RAMPS;
10
- const missing = REQUIRED_RAMPS.filter(name => !ramps.some(ramp => ramp.name === name));
11
- if (missing.length > 0) {
12
- throw new Error(`A palette needs these ramps, which the styles read by name: ${missing.join(', ')}.`);
13
- }
11
+ checkPalette(palette, ramps.map(ramp => ramp.name));
14
12
  const out = {};
15
13
  for (const ramp of ramps) {
16
14
  Object.assign(out, generateRampOklch(ramp, palette));
@@ -82,4 +80,22 @@ function wrapDeclarations(selector, lines) {
82
80
  function round(value) {
83
81
  return Math.round(value * 10000) / 10000;
84
82
  }
83
+ function checkPalette(palette, names) {
84
+ const missing = REQUIRED_RAMPS.filter(name => !names.includes(name));
85
+ if (missing.length > 0) {
86
+ throw new Error(`A palette needs these ramps, which the styles read by name: ${missing.join(', ')}.`);
87
+ }
88
+ const repeated = names.filter((name, index) => names.indexOf(name) !== index);
89
+ if (repeated.length > 0) {
90
+ throw new Error(`A palette names each ramp once: ${repeated.join(', ')}.`);
91
+ }
92
+ const reserved = names.filter(name => RESERVED_RAMPS.includes(name));
93
+ if (reserved.length > 0) {
94
+ throw new Error(`These ramp names are reserved: ${reserved.join(', ')}.`);
95
+ }
96
+ const curves = [palette.lightnessCurve, palette.chromaCurve];
97
+ 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.`);
99
+ }
100
+ }
85
101
  //# 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,7 +1,8 @@
1
1
  import { Schema } from 'airtight';
2
2
  import { PaletteSpec } from '../types.js';
3
3
  /**
4
- * Decodes palette specs from untrusted JSON (files, stdin, browser storage).
4
+ * Decodes palette specs from untrusted JSON (files, stdin, browser storage): shapes, ramp names and ranges.
5
+ * What spans the whole spec (curve lengths, unique, required and reserved names) the generator checks.
5
6
  */
6
7
  export declare const PaletteSpecSchema: Schema<PaletteSpec>;
7
8
  //# sourceMappingURL=PaletteSpecSchema.d.ts.map
@@ -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;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,iBAAiB,qBA2B5B,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,qBAwC5B,CAAC"}
@@ -1,6 +1,8 @@
1
1
  import { Schema } from 'airtight';
2
+ import { RAMP_NAME_PATTERN } from '../constants.js';
2
3
  /**
3
- * Decodes palette specs from untrusted JSON (files, stdin, browser storage).
4
+ * Decodes palette specs from untrusted JSON (files, stdin, browser storage): shapes, ramp names and ranges.
5
+ * What spans the whole spec (curve lengths, unique, required and reserved names) the generator checks.
4
6
  */
5
7
  export const PaletteSpecSchema = new Schema({
6
8
  type: 'object',
@@ -20,10 +22,23 @@ export const PaletteSpecSchema = new Schema({
20
22
  items: {
21
23
  type: 'object',
22
24
  properties: {
23
- name: { type: 'string' },
24
- hue: { type: 'number' },
25
- chroma: { type: 'number' },
26
- lightness: { type: 'number' },
25
+ name: {
26
+ type: 'string',
27
+ regex: RAMP_NAME_PATTERN,
28
+ },
29
+ hue: {
30
+ type: 'number',
31
+ minimum: 0,
32
+ maximum: 360,
33
+ },
34
+ chroma: {
35
+ type: 'number',
36
+ minimum: 0,
37
+ },
38
+ lightness: {
39
+ type: 'number',
40
+ minimum: 0,
41
+ },
27
42
  },
28
43
  },
29
44
  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;AAIlC;;GAEG;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,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACvB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAChC;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;iBACJ;aACJ;YACD,QAAQ,EAAE,IAAI;SACjB;KACJ;CACJ,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nightshadeui/palette-generator",
3
- "version": "3.0.0",
3
+ "version": "3.1.1",
4
4
  "description": "OKLCH palette CSS variable generator for Nightshade",
5
5
  "author": "Boris Okunskiy",
6
6
  "license": "ISC",
package/src/constants.ts CHANGED
@@ -13,6 +13,12 @@ export const RAMP_ANCHOR_INDEX = 6;
13
13
  */
14
14
  export const REQUIRED_RAMPS = ['base', 'primary', 'secondary'];
15
15
 
16
+ /** Ramp names the generator won't take: `inverse` is the mirrored `base` tone the styles define. */
17
+ export const RESERVED_RAMPS = ['inverse'];
18
+
19
+ /** Ramp names are lowercase kebab-case, so each one makes a valid `.tone-<name>` class. */
20
+ export const RAMP_NAME_PATTERN = '^[a-z][a-z0-9]*(-[a-z0-9]+)*$';
21
+
16
22
  export const DEFAULT_LIGHTNESS_CURVE = [
17
23
  1, 0.98, 0.94, 0.88, 0.80, 0.72, 0.64, 0.56, 0.48, 0.42, 0.36, 0.32,
18
24
  ];
package/src/generate.ts CHANGED
@@ -5,6 +5,7 @@ import {
5
5
  RAMP_ANCHOR_INDEX,
6
6
  RAMP_STEPS,
7
7
  REQUIRED_RAMPS,
8
+ RESERVED_RAMPS,
8
9
  } from './constants.js';
9
10
  import { PaletteRampSpec, PaletteSpec, RampStep } from './types.js';
10
11
 
@@ -12,14 +13,12 @@ import { PaletteRampSpec, PaletteSpec, RampStep } from './types.js';
12
13
  * Emits every ramp as scheme-aware CSS values: `light-dark(<light>, <dark>)`.
13
14
  * The dark ramp is the light ramp mirrored, so a step keeps its meaning in both schemes:
14
15
  * `0` is always the canvas end, `950` always the ink end.
15
- * Throws when the palette lacks a ramp the styles read by name.
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.
16
18
  */
17
19
  export function generatePaletteOklch(palette: PaletteSpec = {}) {
18
20
  const ramps = palette.ramps ?? DEFAULT_RAMPS;
19
- const missing = REQUIRED_RAMPS.filter(name => !ramps.some(ramp => ramp.name === name));
20
- if (missing.length > 0) {
21
- throw new Error(`A palette needs these ramps, which the styles read by name: ${missing.join(', ')}.`);
22
- }
21
+ checkPalette(palette, ramps.map(ramp => ramp.name));
23
22
  const out: Record<string, string> = {};
24
23
  for (const ramp of ramps) {
25
24
  Object.assign(out, generateRampOklch(ramp, palette));
@@ -106,3 +105,22 @@ function wrapDeclarations(selector: string, lines: string[]) {
106
105
  function round(value: number) {
107
106
  return Math.round(value * 10000) / 10000;
108
107
  }
108
+
109
+ function checkPalette(palette: PaletteSpec, names: string[]) {
110
+ const missing = REQUIRED_RAMPS.filter(name => !names.includes(name));
111
+ if (missing.length > 0) {
112
+ throw new Error(`A palette needs these ramps, which the styles read by name: ${missing.join(', ')}.`);
113
+ }
114
+ const repeated = names.filter((name, index) => names.indexOf(name) !== index);
115
+ if (repeated.length > 0) {
116
+ throw new Error(`A palette names each ramp once: ${repeated.join(', ')}.`);
117
+ }
118
+ const reserved = names.filter(name => RESERVED_RAMPS.includes(name));
119
+ if (reserved.length > 0) {
120
+ throw new Error(`These ramp names are reserved: ${reserved.join(', ')}.`);
121
+ }
122
+ const curves = [palette.lightnessCurve, palette.chromaCurve];
123
+ 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.`);
125
+ }
126
+ }
@@ -1,9 +1,11 @@
1
1
  import { Schema } from 'airtight';
2
2
 
3
+ import { RAMP_NAME_PATTERN } from '../constants.js';
3
4
  import { PaletteSpec } from '../types.js';
4
5
 
5
6
  /**
6
- * Decodes palette specs from untrusted JSON (files, stdin, browser storage).
7
+ * Decodes palette specs from untrusted JSON (files, stdin, browser storage): shapes, ramp names and ranges.
8
+ * What spans the whole spec (curve lengths, unique, required and reserved names) the generator checks.
7
9
  */
8
10
  export const PaletteSpecSchema = new Schema<PaletteSpec>({
9
11
  type: 'object',
@@ -23,10 +25,23 @@ export const PaletteSpecSchema = new Schema<PaletteSpec>({
23
25
  items: {
24
26
  type: 'object',
25
27
  properties: {
26
- name: { type: 'string' },
27
- hue: { type: 'number' },
28
- chroma: { type: 'number' },
29
- lightness: { type: 'number' },
28
+ name: {
29
+ type: 'string',
30
+ regex: RAMP_NAME_PATTERN,
31
+ },
32
+ hue: {
33
+ type: 'number',
34
+ minimum: 0,
35
+ maximum: 360,
36
+ },
37
+ chroma: {
38
+ type: 'number',
39
+ minimum: 0,
40
+ },
41
+ lightness: {
42
+ type: 'number',
43
+ minimum: 0,
44
+ },
30
45
  },
31
46
  },
32
47
  optional: true,