vunor 0.1.2 → 0.1.4

package/dist/theme.d.mts

@@ -121,6 +121,12 @@ interface TVunorPaletteColor {
     dark?: number;
     light?: number;
   };
+  /**
+   * Per-color override for perceptual flatness.
+   *
+   * See {@link TVunorPaletteOptions.flatness}.
+   */
+  flatness?: number;
 }
 interface TVunorPaletteOptions {
   colors?: {
@@ -150,6 +156,23 @@ interface TVunorPaletteOptions {
    * @default 0.08
    */
   layersDepth?: number;
+  /**
+   * Controls how strongly shades are normalized for perceptual uniformity.
+   *
+   * Forwarded to `@prostojs/palitra`'s `flatness` option and used as the
+   * default for both the main palette and the layer palette (each can override
+   * via `mainPalette.flatness` / `layerPalette.flatness`, and individual colors
+   * can override via `colors.<name>.flatness`).
+   *
+   * - `1` — fully flat: every shade hits its target perceptual brightness
+   *   exactly, so steps feel evenly spaced across any hue.
+   * - `0` — no normalization: shades follow a raw HSL ramp and each hue keeps
+   *   its natural perceptual weight (yellows read bright, blues read dark).
+   * - Values in between blend the two.
+   *
+   * @default 1
+   */
+  flatness?: number;
   /**
    * Advanced main palette configuration
    */
@@ -176,6 +199,12 @@ interface TVunorMainPaletteAdvanced {
    * @default false
    */
   preserveInputColor?: boolean;
+  /**
+   * Override perceptual flatness for the main palette only.
+   *
+   * Falls back to the top-level {@link TVunorPaletteOptions.flatness}.
+   */
+  flatness?: number;
   /**
    * Luminance options
    */
@@ -243,6 +272,12 @@ interface TVunorLayerPaletteAdvanced {
    * @default 0.2
    */
   desaturate?: number;
+  /**
+   * Override perceptual flatness for the layer palette only.
+   *
+   * Falls back to the top-level {@link TVunorPaletteOptions.flatness}.
+   */
+  flatness?: number;
   /**
    * Luminance options
    */