@nightshadeui/palette-generator 3.3.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 +1 -1
- package/dist/generate.d.ts +3 -2
- package/dist/generate.d.ts.map +1 -1
- package/dist/generate.js +10 -8
- package/dist/generate.js.map +1 -1
- package/dist/schema/PaletteSpecSchema.d.ts.map +1 -1
- package/dist/schema/PaletteSpecSchema.js +10 -0
- package/dist/schema/PaletteSpecSchema.js.map +1 -1
- package/dist/types.d.ts +5 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/generate.ts +10 -8
- package/src/schema/PaletteSpecSchema.ts +10 -0
- package/src/types.ts +5 -1
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 }`.
|
|
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.
|
package/dist/generate.d.ts
CHANGED
|
@@ -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
|
|
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
|
/**
|
package/dist/generate.d.ts.map
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
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,
|
|
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,
|
|
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
|
package/dist/generate.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,GACjB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAuB,EAAE;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,
|
|
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,
|
|
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
|
|
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[];
|
package/dist/types.d.ts.map
CHANGED
|
@@ -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;
|
|
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
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
|
|
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
|
|
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,
|
|
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,
|
|
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
|
|
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 {
|