@tenphi/glaze 0.0.0-snapshot.718119b → 0.0.0-snapshot.78261ef

package/dist/index.d.cts

@@ -133,6 +133,11 @@ interface RegularColorDef {
    * should not be combined (a console.warn is emitted).
    */
   opacity?: number;
+  /**
+   * Whether this color is inherited by child themes created via `extend()`.
+   * Default: true. Set to false to make this color local to the current theme.
+   */
+  inherit?: boolean;
 }
 /** Shadow tuning knobs. All values use the 0–1 scale (OKHSL). */
 interface ShadowTuning {
@@ -156,6 +161,12 @@ interface ShadowTuning {
    * 0 = pure fg hue, 1 = pure bg hue. Default: 0.2.
    */
   bgHueBlend?: number;
+  /**
+   * Power curve for dark-scheme shadow alpha (0-1). Default: 0.4.
+   * Lower values compress low/mid-intensity shadows more aggressively.
+   * 1.0 = no dampening (identity).
+   */
+  darkShadowCurve?: number;
 }
 interface ShadowColorDef {
   type: 'shadow';
@@ -177,6 +188,11 @@ interface ShadowColorDef {
   intensity: HCPair<number>;
   /** Override default tuning. Merged field-by-field with global `shadowTuning`. */
   tuning?: ShadowTuning;
+  /**
+   * Whether this color is inherited by child themes created via `extend()`.
+   * Default: true. Set to false to make this color local to the current theme.
+   */
+  inherit?: boolean;
 }
 interface MixColorDef {
   type: 'mix';
@@ -211,6 +227,11 @@ interface MixColorDef {
    * Supports [normal, highContrast] pair.
    */
   contrast?: HCPair<MinContrast>;
+  /**
+   * Whether this color is inherited by child themes created via `extend()`.
+   * Default: true. Set to false to make this color local to the current theme.
+   */
+  inherit?: boolean;
 }
 type ColorDef = RegularColorDef | ShadowColorDef | MixColorDef;
 type ColorMap = Record<string, ColorDef>;
@@ -242,6 +263,13 @@ interface GlazeConfig {
   darkLightness?: [number, number];
   /** Saturation reduction factor for dark scheme (0–1). Default: 0.1. */
   darkDesaturation?: number;
+  /**
+   * Möbius beta for dark auto-inversion (0–1).
+   * Lower values expand subtle near-white distinctions in dark mode.
+   * Set to 1 for linear (legacy) behavior. Default: 0.5.
+   * Accepts [normal, highContrast] pair for separate HC tuning.
+   */
+  darkCurve?: HCPair<number>;
   /** State alias names for token export. */
   states?: {
     dark?: string;
@@ -256,6 +284,7 @@ interface GlazeConfigResolved {
   lightLightness: [number, number];
   darkLightness: [number, number];
   darkDesaturation: number;
+  darkCurve: HCPair<number>;
   states: {
     dark: string;
     highContrast: string;
@@ -278,6 +307,8 @@ interface GlazeShadowInput {
   /** Intensity 0-100. */
   intensity: number;
   tuning?: ShadowTuning;
+  /** Whether to apply dark-scheme dampening. Default: false. */
+  dark?: boolean;
 }
 /** Input for `glaze.color()` standalone factory. */
 interface GlazeColorInput {
@@ -385,35 +416,47 @@ interface GlazeCssResult {
   lightContrast: string;
   darkContrast: string;
 }
-/** Options shared by palette `tokens()`, `tasty()`, and `css()` exports. */
-interface GlazePaletteExportOptions {
-  /**
-   * Prefix mode. `true` uses `"<themeName>-"`, or provide a custom map.
-   * Defaults to `true` for palette export methods.
-   * Set to `false` explicitly to disable prefixing (last-write-wins on collisions).
-   */
-  prefix?: boolean | Record<string, string>;
+/** Options for `glaze.palette()` creation. */
+interface GlazePaletteOptions {
   /**
    * Name of the primary theme. The primary theme's tokens are duplicated
-   * without prefix, providing convenient short aliases alongside the
-   * prefixed versions.
+   * without prefix in all exports, providing convenient short aliases
+   * alongside the prefixed versions. Can be overridden per-export.
    *
    * @example
    * ```ts
-   * palette.tokens({ primary: 'brand' })
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
    * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
    * ```
    */
   primary?: string;
 }
+/** Options shared by palette `tokens()`, `tasty()`, and `css()` exports. */
+interface GlazePaletteExportOptions {
+  /**
+   * Prefix mode. `true` uses `"<themeName>-"`, or provide a custom map.
+   * Defaults to `true` for palette export methods.
+   * Set to `false` explicitly to disable prefixing. Colliding keys
+   * produce a console.warn and the first-written value wins.
+   */
+  prefix?: boolean | Record<string, string>;
+  /**
+   * Override the palette-level primary theme for this export.
+   * Pass a theme name to set/change the primary, or `false` to disable it.
+   * When omitted, inherits the palette-level `primary`.
+   */
+  primary?: string | false;
+}
 interface GlazePalette {
   /**
    * Export all themes as a flat token map grouped by scheme variant.
    * Prefix defaults to `true` — all tokens are prefixed with the theme name.
-   * Use `primary` to duplicate one theme's tokens without prefix.
+   * Inherits the palette-level `primary`; override per-call or pass `false` to disable.
    *
    * ```ts
-   * palette.tokens({ primary: 'brand' })
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
    * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
    * ```
    */
@@ -421,12 +464,10 @@ interface GlazePalette {
   /**
    * Export all themes as tasty style-to-state bindings.
    * Uses `#name` color token keys and state aliases (`''`, `@dark`, etc.).
-   * Prefix defaults to `true`. Use `primary` to duplicate one theme without prefix.
+   * Prefix defaults to `true`. Inherits the palette-level `primary`.
    * @see https://cube-ui-kit.vercel.app/?path=/docs/tasty-documentation--docs
    */
-  tasty(options?: GlazeTokenOptions & {
-    primary?: string;
-  }): Record<string, Record<string, string>>;
+  tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
   /** Export all themes as plain JSON grouped by theme name. */
   json(options?: GlazeJsonOptions & {
     prefix?: boolean | Record<string, string>;
@@ -453,11 +494,9 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  var palette: (themes: PaletteInput) => {
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => {
     tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
-    tasty(options?: GlazeTokenOptions & {
-      primary?: string;
-    }): 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>>>;
@@ -541,5 +580,5 @@ declare function formatHsl(h: number, s: number, l: number): string;
  */
 declare function formatOklch(h: number, s: number, l: number): string;
 //#endregion
-export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazePaletteOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -133,6 +133,11 @@ interface RegularColorDef {
    * should not be combined (a console.warn is emitted).
    */
   opacity?: number;
+  /**
+   * Whether this color is inherited by child themes created via `extend()`.
+   * Default: true. Set to false to make this color local to the current theme.
+   */
+  inherit?: boolean;
 }
 /** Shadow tuning knobs. All values use the 0–1 scale (OKHSL). */
 interface ShadowTuning {
@@ -156,6 +161,12 @@ interface ShadowTuning {
    * 0 = pure fg hue, 1 = pure bg hue. Default: 0.2.
    */
   bgHueBlend?: number;
+  /**
+   * Power curve for dark-scheme shadow alpha (0-1). Default: 0.4.
+   * Lower values compress low/mid-intensity shadows more aggressively.
+   * 1.0 = no dampening (identity).
+   */
+  darkShadowCurve?: number;
 }
 interface ShadowColorDef {
   type: 'shadow';
@@ -177,6 +188,11 @@ interface ShadowColorDef {
   intensity: HCPair<number>;
   /** Override default tuning. Merged field-by-field with global `shadowTuning`. */
   tuning?: ShadowTuning;
+  /**
+   * Whether this color is inherited by child themes created via `extend()`.
+   * Default: true. Set to false to make this color local to the current theme.
+   */
+  inherit?: boolean;
 }
 interface MixColorDef {
   type: 'mix';
@@ -211,6 +227,11 @@ interface MixColorDef {
    * Supports [normal, highContrast] pair.
    */
   contrast?: HCPair<MinContrast>;
+  /**
+   * Whether this color is inherited by child themes created via `extend()`.
+   * Default: true. Set to false to make this color local to the current theme.
+   */
+  inherit?: boolean;
 }
 type ColorDef = RegularColorDef | ShadowColorDef | MixColorDef;
 type ColorMap = Record<string, ColorDef>;
@@ -242,6 +263,13 @@ interface GlazeConfig {
   darkLightness?: [number, number];
   /** Saturation reduction factor for dark scheme (0–1). Default: 0.1. */
   darkDesaturation?: number;
+  /**
+   * Möbius beta for dark auto-inversion (0–1).
+   * Lower values expand subtle near-white distinctions in dark mode.
+   * Set to 1 for linear (legacy) behavior. Default: 0.5.
+   * Accepts [normal, highContrast] pair for separate HC tuning.
+   */
+  darkCurve?: HCPair<number>;
   /** State alias names for token export. */
   states?: {
     dark?: string;
@@ -256,6 +284,7 @@ interface GlazeConfigResolved {
   lightLightness: [number, number];
   darkLightness: [number, number];
   darkDesaturation: number;
+  darkCurve: HCPair<number>;
   states: {
     dark: string;
     highContrast: string;
@@ -278,6 +307,8 @@ interface GlazeShadowInput {
   /** Intensity 0-100. */
   intensity: number;
   tuning?: ShadowTuning;
+  /** Whether to apply dark-scheme dampening. Default: false. */
+  dark?: boolean;
 }
 /** Input for `glaze.color()` standalone factory. */
 interface GlazeColorInput {
@@ -385,35 +416,47 @@ interface GlazeCssResult {
   lightContrast: string;
   darkContrast: string;
 }
-/** Options shared by palette `tokens()`, `tasty()`, and `css()` exports. */
-interface GlazePaletteExportOptions {
-  /**
-   * Prefix mode. `true` uses `"<themeName>-"`, or provide a custom map.
-   * Defaults to `true` for palette export methods.
-   * Set to `false` explicitly to disable prefixing (last-write-wins on collisions).
-   */
-  prefix?: boolean | Record<string, string>;
+/** Options for `glaze.palette()` creation. */
+interface GlazePaletteOptions {
   /**
    * Name of the primary theme. The primary theme's tokens are duplicated
-   * without prefix, providing convenient short aliases alongside the
-   * prefixed versions.
+   * without prefix in all exports, providing convenient short aliases
+   * alongside the prefixed versions. Can be overridden per-export.
    *
    * @example
    * ```ts
-   * palette.tokens({ primary: 'brand' })
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
    * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
    * ```
    */
   primary?: string;
 }
+/** Options shared by palette `tokens()`, `tasty()`, and `css()` exports. */
+interface GlazePaletteExportOptions {
+  /**
+   * Prefix mode. `true` uses `"<themeName>-"`, or provide a custom map.
+   * Defaults to `true` for palette export methods.
+   * Set to `false` explicitly to disable prefixing. Colliding keys
+   * produce a console.warn and the first-written value wins.
+   */
+  prefix?: boolean | Record<string, string>;
+  /**
+   * Override the palette-level primary theme for this export.
+   * Pass a theme name to set/change the primary, or `false` to disable it.
+   * When omitted, inherits the palette-level `primary`.
+   */
+  primary?: string | false;
+}
 interface GlazePalette {
   /**
    * Export all themes as a flat token map grouped by scheme variant.
    * Prefix defaults to `true` — all tokens are prefixed with the theme name.
-   * Use `primary` to duplicate one theme's tokens without prefix.
+   * Inherits the palette-level `primary`; override per-call or pass `false` to disable.
    *
    * ```ts
-   * palette.tokens({ primary: 'brand' })
+   * const palette = glaze.palette({ brand, accent }, { primary: 'brand' });
+   * palette.tokens()
    * // → { light: { 'brand-surface': '...', 'surface': '...', 'accent-surface': '...' } }
    * ```
    */
@@ -421,12 +464,10 @@ interface GlazePalette {
   /**
    * Export all themes as tasty style-to-state bindings.
    * Uses `#name` color token keys and state aliases (`''`, `@dark`, etc.).
-   * Prefix defaults to `true`. Use `primary` to duplicate one theme without prefix.
+   * Prefix defaults to `true`. Inherits the palette-level `primary`.
    * @see https://cube-ui-kit.vercel.app/?path=/docs/tasty-documentation--docs
    */
-  tasty(options?: GlazeTokenOptions & {
-    primary?: string;
-  }): Record<string, Record<string, string>>;
+  tasty(options?: GlazeTokenOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
   /** Export all themes as plain JSON grouped by theme name. */
   json(options?: GlazeJsonOptions & {
     prefix?: boolean | Record<string, string>;
@@ -453,11 +494,9 @@ declare function glaze(hueOrOptions: number | {
 }, saturation?: number): GlazeTheme;
 declare namespace glaze {
   var configure: (config: GlazeConfig) => void;
-  var palette: (themes: PaletteInput) => {
+  var palette: (themes: PaletteInput, options?: GlazePaletteOptions) => {
     tokens(options?: GlazeJsonOptions & GlazePaletteExportOptions): Record<string, Record<string, string>>;
-    tasty(options?: GlazeTokenOptions & {
-      primary?: string;
-    }): 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>>>;
@@ -541,5 +580,5 @@ declare function formatHsl(h: number, s: number, l: number): string;
  */
 declare function formatOklch(h: number, s: number, l: number): string;
 //#endregion
-export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
+export { type AdaptationMode, type ColorDef, type ColorMap, type ContrastPreset, type FindLightnessForContrastOptions, type FindLightnessForContrastResult, type FindValueForMixContrastOptions, type FindValueForMixContrastResult, type GlazeColorFormat, type GlazeColorInput, type GlazeColorToken, type GlazeConfig, type GlazeCssOptions, type GlazeCssResult, type GlazeExtendOptions, type GlazeJsonOptions, type GlazeOutputModes, type GlazePalette, type GlazePaletteExportOptions, type GlazePaletteOptions, type GlazeShadowInput, type GlazeTheme, type GlazeThemeExport, type GlazeTokenOptions, type HCPair, type HexColor, type MinContrast, type MixColorDef, type OkhslColor, type RegularColorDef, type RelativeValue, type ResolvedColor, type ResolvedColorVariant, type ShadowColorDef, type ShadowTuning, contrastRatioFromLuminance, findLightnessForContrast, findValueForMixContrast, formatHsl, formatOkhsl, formatOklch, formatRgb, gamutClampedLuminance, glaze, okhslToLinearSrgb, okhslToOklab, okhslToSrgb, parseHex, relativeLuminanceFromLinearRgb, resolveMinContrast, srgbToOkhsl };
 //# sourceMappingURL=index.d.mts.map