@primitiv-ui/harmoni-wasm 0.1.32 → 0.1.34

package/harmoni_wasm.d.ts

@@ -216,8 +216,33 @@ export function generate_alpha_ramp(anchor: string): AlphaRamp;
  */
 export function generate_alpha_ramp_with_steps(anchor: string, steps: number): AlphaRamp;
 
+/**
+ * A neutral ramp in both modes from anchors that are **already** tinted, for a
+ * caller that did its own tinting (or wants none).
+ *
+ * [`generate_tinted_neutral_pair`] is the one to reach for. This is the seam
+ * underneath it, kept public because the anchors are a legitimate thing to hold
+ * directly — the Harmoni project stores its own `SoftNeutrals`.
+ */
+export function generate_neutral_pair(white: string, black: string, tint: TintMode, bow: number, steps: number): PaletteSet;
+
 export function generate_neutral_ramp(white: string, black: string, tint: TintMode, bow: number): Palette;
 
+/**
+ * Builds a neutral ramp of `steps` steps, so the neutral ramp can match the
+ * length of the solid ramps it sits beside — a ten-step neutral against a
+ * seven-step brand would otherwise carry two different label sets for one
+ * palette. Labels come from the same ladder `generate_palette_with_steps`
+ * walks. `steps` outside the range `supported_step_range` reports is rejected
+ * rather than clamped.
+ *
+ * Like every `palette_to_js` entry point, this has no native test:
+ * `serde_wasm_bindgen::to_value` needs a JS runtime, so the whole function is
+ * unreachable off-target. The step-count and label decisions it forwards are
+ * covered where they are actually made — `api::neutral_tests`.
+ */
+export function generate_neutral_ramp_with_steps(white: string, black: string, tint: TintMode, bow: number, steps: number): Palette;
+
 export function generate_palette(hex: string, light_padding: number, dark_padding: number): Palette;
 
 export function generate_palette_pair(hex: string, light_lightness: Array<any>, dark_lightness: Array<any>, light_padding: number, dark_padding: number): PaletteSet;
@@ -248,6 +273,23 @@ export function generate_palette_with_lightness(hex: string, lightness: Array<an
  */
 export function generate_palette_with_steps(hex: string, steps: number, light_padding: number, dark_padding: number): Palette;
 
+/**
+ * A neutral ramp in **both modes**, with its tint applied — the plugin's whole
+ * neutral generation in one call.
+ *
+ * This exists to take work away from TypeScript. The plugin's adapter was
+ * choosing between `tint_neutrals` and `tint_neutrals_duotone`, splitting the
+ * source hue by the spread, zeroing `bow` when untinted, and calling the
+ * generator twice with the anchors swapped. Every one of those is a colour
+ * decision, and colour decisions belong to the engine — the adapter's job is to
+ * marshal input in and results out, nothing else.
+ *
+ * `tint_source` of `None` is an untinted grey, which is what `tint === null` has
+ * always meant on the plugin side. `strength`, `spread` and `bow` are ignored in
+ * that case rather than shaping nothing.
+ */
+export function generate_tinted_neutral_pair(white: string, black: string, tint_source: string | null | undefined, strength: number, spread: number, bow: number, steps: number): PaletteSet;
+
 export function get_contrast_rating(bg: string, fg: string): ContrastResult;
 
 /**
@@ -350,7 +392,9 @@ export interface InitOutput {
     readonly describe_oklch: (a: number, b: number, c: number) => any;
     readonly generate_alpha_ramp: (a: number, b: number) => [number, number, number];
     readonly generate_alpha_ramp_with_steps: (a: number, b: number, c: number) => [number, number, number];
+    readonly generate_neutral_pair: (a: number, b: number, c: number, d: number, e: any, f: number, g: number) => [number, number, number];
     readonly generate_neutral_ramp: (a: number, b: number, c: number, d: number, e: any, f: number) => [number, number, number];
+    readonly generate_neutral_ramp_with_steps: (a: number, b: number, c: number, d: number, e: any, f: number, g: number) => [number, number, number];
     readonly generate_palette: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly generate_palette_pair: (a: number, b: number, c: any, d: any, e: number, f: number) => [number, number, number];
     readonly generate_palette_pair_with_curve: (a: number, b: number, c: number, d: number, e: number, f: any) => [number, number, number];
@@ -358,6 +402,7 @@ export interface InitOutput {
     readonly generate_palette_with_light_padding: (a: number, b: number, c: number) => [number, number, number];
     readonly generate_palette_with_lightness: (a: number, b: number, c: any, d: number, e: number) => [number, number, number];
     readonly generate_palette_with_steps: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly generate_tinted_neutral_pair: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => [number, number, number];
     readonly get_contrast_rating: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly grade: (a: number, b: any) => any;
     readonly max_in_gamut_chroma: (a: number, b: number, c: any) => number;

package/harmoni_wasm.js

@@ -140,6 +140,32 @@ export function generate_alpha_ramp_with_steps(anchor, steps) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * A neutral ramp in both modes from anchors that are **already** tinted, for a
+ * caller that did its own tinting (or wants none).
+ *
+ * [`generate_tinted_neutral_pair`] is the one to reach for. This is the seam
+ * underneath it, kept public because the anchors are a legitimate thing to hold
+ * directly — the Harmoni project stores its own `SoftNeutrals`.
+ * @param {string} white
+ * @param {string} black
+ * @param {TintMode} tint
+ * @param {number} bow
+ * @param {number} steps
+ * @returns {PaletteSet}
+ */
+export function generate_neutral_pair(white, black, tint, bow, steps) {
+    const ptr0 = passStringToWasm0(white, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(black, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.generate_neutral_pair(ptr0, len0, ptr1, len1, tint, bow, steps);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {string} white
  * @param {string} black
@@ -159,6 +185,37 @@ export function generate_neutral_ramp(white, black, tint, bow) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Builds a neutral ramp of `steps` steps, so the neutral ramp can match the
+ * length of the solid ramps it sits beside — a ten-step neutral against a
+ * seven-step brand would otherwise carry two different label sets for one
+ * palette. Labels come from the same ladder `generate_palette_with_steps`
+ * walks. `steps` outside the range `supported_step_range` reports is rejected
+ * rather than clamped.
+ *
+ * Like every `palette_to_js` entry point, this has no native test:
+ * `serde_wasm_bindgen::to_value` needs a JS runtime, so the whole function is
+ * unreachable off-target. The step-count and label decisions it forwards are
+ * covered where they are actually made — `api::neutral_tests`.
+ * @param {string} white
+ * @param {string} black
+ * @param {TintMode} tint
+ * @param {number} bow
+ * @param {number} steps
+ * @returns {Palette}
+ */
+export function generate_neutral_ramp_with_steps(white, black, tint, bow, steps) {
+    const ptr0 = passStringToWasm0(white, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(black, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.generate_neutral_ramp_with_steps(ptr0, len0, ptr1, len1, tint, bow, steps);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {string} hex
  * @param {number} light_padding
@@ -287,6 +344,43 @@ export function generate_palette_with_steps(hex, steps, light_padding, dark_padd
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * A neutral ramp in **both modes**, with its tint applied — the plugin's whole
+ * neutral generation in one call.
+ *
+ * This exists to take work away from TypeScript. The plugin's adapter was
+ * choosing between `tint_neutrals` and `tint_neutrals_duotone`, splitting the
+ * source hue by the spread, zeroing `bow` when untinted, and calling the
+ * generator twice with the anchors swapped. Every one of those is a colour
+ * decision, and colour decisions belong to the engine — the adapter's job is to
+ * marshal input in and results out, nothing else.
+ *
+ * `tint_source` of `None` is an untinted grey, which is what `tint === null` has
+ * always meant on the plugin side. `strength`, `spread` and `bow` are ignored in
+ * that case rather than shaping nothing.
+ * @param {string} white
+ * @param {string} black
+ * @param {string | null | undefined} tint_source
+ * @param {number} strength
+ * @param {number} spread
+ * @param {number} bow
+ * @param {number} steps
+ * @returns {PaletteSet}
+ */
+export function generate_tinted_neutral_pair(white, black, tint_source, strength, spread, bow, steps) {
+    const ptr0 = passStringToWasm0(white, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passStringToWasm0(black, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    var ptr2 = isLikeNone(tint_source) ? 0 : passStringToWasm0(tint_source, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len2 = WASM_VECTOR_LEN;
+    const ret = wasm.generate_tinted_neutral_pair(ptr0, len0, ptr1, len1, ptr2, len2, strength, spread, bow, steps);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {string} bg
  * @param {string} fg

package/package.json

@@ -2,7 +2,7 @@
   "name": "@primitiv-ui/harmoni-wasm",
   "type": "module",
   "description": "Public wasm-pack build of harmoni-core, the Primitiv palette engine.",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "license": "MIT",
   "repository": {
     "type": "git",