@primitiv-ui/harmoni-wasm 0.1.31 → 0.1.33

package/harmoni_wasm.d.ts

@@ -11,6 +11,8 @@ export interface AlphaSwatch {
     alpha: number;
     step: number;
     oklch: string;
+    hex: string;
+    rgb: Rgb;
 }
 
 export interface ChromaHeadroom {
@@ -205,8 +207,32 @@ export function describe_oklch(l: number, c: number, h: number): OklchTriple;
  */
 export function generate_alpha_ramp(anchor: string): AlphaRamp;
 
+/**
+ * Builds an alpha ramp of `steps` steps, so an alpha ramp can match the
+ * length of the solid ramp it accompanies — a seven-step ramp and a ten-step
+ * alpha companion would otherwise carry two different label sets for one
+ * ramp. `steps` outside the range `supported_step_range` reports is rejected
+ * rather than clamped.
+ */
+export function generate_alpha_ramp_with_steps(anchor: string, steps: number): AlphaRamp;
+
 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;
@@ -338,7 +364,9 @@ export interface InitOutput {
     readonly derive_soft_neutrals: (a: number, b: number, c: number) => [number, number, number];
     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_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];

package/harmoni_wasm.js

@@ -120,6 +120,26 @@ export function generate_alpha_ramp(anchor) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+/**
+ * Builds an alpha ramp of `steps` steps, so an alpha ramp can match the
+ * length of the solid ramp it accompanies — a seven-step ramp and a ten-step
+ * alpha companion would otherwise carry two different label sets for one
+ * ramp. `steps` outside the range `supported_step_range` reports is rejected
+ * rather than clamped.
+ * @param {string} anchor
+ * @param {number} steps
+ * @returns {AlphaRamp}
+ */
+export function generate_alpha_ramp_with_steps(anchor, steps) {
+    const ptr0 = passStringToWasm0(anchor, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.generate_alpha_ramp_with_steps(ptr0, len0, steps);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * @param {string} white
  * @param {string} black
@@ -139,6 +159,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

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.31",
+  "version": "0.1.33",
   "license": "MIT",
   "repository": {
     "type": "git",