@tenphi/glaze 0.10.1 → 0.11.1

package/dist/index.d.cts

@@ -376,16 +376,17 @@ interface GlazeColorOverrides {
   /** Saturation multiplier on the seed (0–1). Default: 1. */
   saturationFactor?: number;
   /**
-   * Adaptation mode. Defaults vary by input form:
-   * - String inputs (`'#1a1a1a'`, `'rgb(...)'`, etc.): `'auto'` (Möbius
-   *   curve — pairs with the extended dark window to invert
-   *   `#000` ↔ `#fff` between light and dark).
-   * - `OkhslColor` and `[r, g, b]` tuple inputs: `'fixed'` (linear,
-   *   preserves light lightness exactly).
+   * Adaptation mode. Defaults to `'auto'` for every input form, so
+   * colors automatically adapt between light and dark like an ordinary
+   * theme color. The default *scaling* snapshot differs by input form:
+   * string inputs preserve their light lightness and extend the dark
+   * window to `[lo, 100]` (`#000` ↔ `#fff` flip), while `OkhslColor`
+   * and `[r, g, b]` tuple inputs snapshot the full `globalConfig.
+   * lightLightness` / `globalConfig.darkLightness` windows.
    *
-   * Pass `'fixed'` explicitly to opt a string input back into the
-   * linear, non-inverting mapping; pass `'static'` to pin the same
-   * lightness across every variant.
+   * Pass `'fixed'` explicitly to opt back into the legacy linear, non-
+   * inverting mapping; pass `'static'` to pin the same lightness
+   * across every variant.
    */
   mode?: AdaptationMode;
   /**
@@ -442,8 +443,9 @@ interface GlazeColorOverrides {
  *     the way up to white.
  *
  * - **`OkhslColor` / `[r, g, b]` tuple / structured inputs**:
- *   - `lightLightness: false` — preserve input exactly.
- *   - `darkLightness: globalConfig.darkLightness` — same window
+ *   - `lightLightness: globalConfig.lightLightness` — same light window
+ *     theme colors use, snapshotted at create time.
+ *   - `darkLightness: globalConfig.darkLightness` — same dark window
  *     theme colors use, snapshotted at create time.
  *
  * Passing this object replaces both fields at once. To keep one
@@ -451,7 +453,12 @@ interface GlazeColorOverrides {
  * explicitly.
  */
 interface GlazeColorScaling {
-  /** Light-mode lightness window. `false` (default) preserves input. */
+  /**
+   * Light-mode lightness window. Snapshotted from `globalConfig` at
+   * create time: `false` (preserve input) for string inputs, plain
+   * `globalConfig.lightLightness` for object / tuple / structured
+   * inputs. Pass `false` to preserve input lightness in light mode.
+   */
   lightLightness?: false | [number, number];
   /**
    * Dark-mode lightness window. Snapshotted from `globalConfig` at
@@ -714,14 +721,7 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => {
-    tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
-    tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
-    json(options?: GlazeJsonOptions & {
-      prefix?: boolean | Record<string, string>;
-    }): Record<string, Record<string, Record<string, string>>>;
-    css(options?: GlazeCssOptions & GlazePaletteExportOptions): GlazeCssResult;
-  };
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => GlazePalette;
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: {
     (input: GlazeColorInput, scaling?: GlazeColorScaling): GlazeColorToken;

package/dist/index.d.mts

@@ -376,16 +376,17 @@ interface GlazeColorOverrides {
   /** Saturation multiplier on the seed (0–1). Default: 1. */
   saturationFactor?: number;
   /**
-   * Adaptation mode. Defaults vary by input form:
-   * - String inputs (`'#1a1a1a'`, `'rgb(...)'`, etc.): `'auto'` (Möbius
-   *   curve — pairs with the extended dark window to invert
-   *   `#000` ↔ `#fff` between light and dark).
-   * - `OkhslColor` and `[r, g, b]` tuple inputs: `'fixed'` (linear,
-   *   preserves light lightness exactly).
+   * Adaptation mode. Defaults to `'auto'` for every input form, so
+   * colors automatically adapt between light and dark like an ordinary
+   * theme color. The default *scaling* snapshot differs by input form:
+   * string inputs preserve their light lightness and extend the dark
+   * window to `[lo, 100]` (`#000` ↔ `#fff` flip), while `OkhslColor`
+   * and `[r, g, b]` tuple inputs snapshot the full `globalConfig.
+   * lightLightness` / `globalConfig.darkLightness` windows.
    *
-   * Pass `'fixed'` explicitly to opt a string input back into the
-   * linear, non-inverting mapping; pass `'static'` to pin the same
-   * lightness across every variant.
+   * Pass `'fixed'` explicitly to opt back into the legacy linear, non-
+   * inverting mapping; pass `'static'` to pin the same lightness
+   * across every variant.
    */
   mode?: AdaptationMode;
   /**
@@ -442,8 +443,9 @@ interface GlazeColorOverrides {
  *     the way up to white.
  *
  * - **`OkhslColor` / `[r, g, b]` tuple / structured inputs**:
- *   - `lightLightness: false` — preserve input exactly.
- *   - `darkLightness: globalConfig.darkLightness` — same window
+ *   - `lightLightness: globalConfig.lightLightness` — same light window
+ *     theme colors use, snapshotted at create time.
+ *   - `darkLightness: globalConfig.darkLightness` — same dark window
  *     theme colors use, snapshotted at create time.
  *
  * Passing this object replaces both fields at once. To keep one
@@ -451,7 +453,12 @@ interface GlazeColorOverrides {
  * explicitly.
  */
 interface GlazeColorScaling {
-  /** Light-mode lightness window. `false` (default) preserves input. */
+  /**
+   * Light-mode lightness window. Snapshotted from `globalConfig` at
+   * create time: `false` (preserve input) for string inputs, plain
+   * `globalConfig.lightLightness` for object / tuple / structured
+   * inputs. Pass `false` to preserve input lightness in light mode.
+   */
   lightLightness?: false | [number, number];
   /**
    * Dark-mode lightness window. Snapshotted from `globalConfig` at
@@ -714,14 +721,7 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => {
-    tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
-    tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
-    json(options?: GlazeJsonOptions & {
-      prefix?: boolean | Record<string, string>;
-    }): Record<string, Record<string, Record<string, string>>>;
-    css(options?: GlazeCssOptions & GlazePaletteExportOptions): GlazeCssResult;
-  };
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => GlazePalette;
   var from: (data: GlazeThemeExport) => GlazeTheme;
   var color: {
     (input: GlazeColorInput, scaling?: GlazeColorScaling): GlazeColorToken;