@nxds/core 0.12.0 → 0.14.0

package/dist/runtime/{surface-ladder-tv7B_RKy.d.cts → surface-ladder-DQ9Yfwie.d.cts}

@@ -1,5 +1,42 @@
 import { N as NxdsSurfaceTone } from './palette-BKTIQ0WC.cjs';
 
+/**
+ * Each UI scale, as factors of the Default scale. `spacing` multiplies every
+ * density and radius step and the page widths, `text` every type size, and
+ * `icon` every icon glyph. `text: 12 / 14` turns 14px label text into 12px.
+ */
+declare const UI_SCALES: {
+    readonly small: {
+        readonly spacing: 0.9;
+        readonly text: number;
+        readonly icon: number;
+    };
+    readonly default: {
+        readonly spacing: 1;
+        readonly text: 1;
+        readonly icon: 1;
+    };
+    readonly large: {
+        readonly spacing: 1.1;
+        readonly text: number;
+        readonly icon: number;
+    };
+    readonly larger: {
+        readonly spacing: 1.25;
+        readonly text: number;
+        readonly icon: number;
+    };
+};
+type UiScale = keyof typeof UI_SCALES;
+/**
+ * The label text sizes a person can pick, in px at the Default scale. 14 is
+ * the Default label size, and writes no block of its own.
+ */
+declare const TEXT_SIZES: readonly [12, 13, 14, 15, 16];
+type TextSize = (typeof TEXT_SIZES)[number];
+/** The label text size, in px, that `textSize` shows at `scale`. */
+declare function textSizePx(textSize: TextSize, scale: UiScale): number;
+
 interface ThemeSeeds {
     /** Drives the primary family ramp. */
     accent: string;
@@ -43,6 +80,9 @@ declare function themeToCss(derived: DerivedTheme): string;
 
 type ModeSeeds = Pick<ThemeSeeds, 'background' | 'foreground'>;
 type NxdsAppearanceMode = 'light' | 'dark' | 'system';
+type NxdsUiScale = UiScale;
+/** The label text size, in px at the Default UI scale. */
+type NxdsTextSize = TextSize;
 type NxdsDensity = 'tight' | 'compact' | 'default' | 'comfortable' | 'relaxed' | 'spacious';
 type NxdsCorners = 'square' | 'subtle' | 'smooth' | 'round' | 'extra-round';
 type NxdsElevation = 'flat' | 'quiet' | 'soft' | 'standard' | 'strong';
@@ -52,7 +92,6 @@ interface NxdsAppearancePrefs {
     /** The heading `font-family` stack. `null` follows `uiFont`. */
     headingFont: string | null;
     codeFont: string;
-    uiFontSize: number;
     codeFontSize: number;
     reduceMotion: boolean;
     pointerCursors: boolean;
@@ -64,6 +103,8 @@ interface NxdsAppearanceState {
     surfaceTone: NxdsSurfaceTone;
     lightContrast: number;
     darkContrast: number;
+    uiScale: NxdsUiScale;
+    textSize: NxdsTextSize;
     density: NxdsDensity;
     corners: NxdsCorners;
     elevation: NxdsElevation;
@@ -98,6 +139,24 @@ declare const BASE_TONE_SEEDS: Record<NxdsSurfaceTone, {
     light: ModeSeeds;
     dark: ModeSeeds;
 }>;
+declare const UI_SCALE_OPTIONS: readonly [{
+    readonly value: "small";
+    readonly label: "Small";
+}, {
+    readonly value: "default";
+    readonly label: "Default";
+}, {
+    readonly value: "large";
+    readonly label: "Large";
+}, {
+    readonly value: "larger";
+    readonly label: "Larger";
+}];
+/** The text sizes, each labelled with its label size at the Default UI scale. */
+declare const TEXT_SIZE_OPTIONS: readonly {
+    readonly value: NxdsTextSize;
+    readonly label: string;
+}[];
 declare const DENSITY_OPTIONS: readonly [{
     readonly value: "tight";
     readonly label: "Tight";
@@ -166,7 +225,9 @@ declare const FONT_SIZE_PX_MAX = 32;
 declare function normalizeAppearanceModeIds(raw: unknown): unknown;
 declare function sanitizeNxdsAppearancePrefs(raw: unknown): NxdsAppearancePrefs;
 declare function sanitizeNxdsAppearance(rawInput: unknown): NxdsAppearanceState;
-declare function createNxdsThemeContract(state: NxdsAppearanceState): ThemeDerivationInput;
+/** The appearance fields runtime colours derive from. */
+type NxdsColorAppearance = Pick<NxdsAppearanceState, 'brandColor' | 'surfaceTone' | 'lightContrast' | 'darkContrast'>;
+declare function createNxdsThemeContract(state: NxdsColorAppearance): ThemeDerivationInput;
 declare function appearancePrefsToCss(prefs: NxdsAppearancePrefs): string;
 
 /**
@@ -259,4 +320,4 @@ declare const DARK_SURFACE_LADDER: {
     };
 };
 
-export { BASE_TONE_OPTIONS as B, CORNER_OPTIONS as C, DARK_SURFACE_LADDER as D, ELEVATION_OPTIONS as E, FONT_SIZE_PX_MAX as F, LIGHT_SURFACE_LADDER as L, type NxdsPresetField as N, SURFACE_TOKENS as S, type ThemeDerivationInput as T, type NxdsAppearancePrefs as a, type NxdsAppearanceState as b, type ShadeAnchor as c, type DerivedTheme as d, BASE_TONE_SEEDS as e, DEFAULT_BRAND_COLOR as f, DEFAULT_NXDS_APPEARANCE as g, DENSITY_OPTIONS as h, FONT_SIZE_PX_MIN as i, type NxdsAppearanceMode as j, type NxdsCorners as k, type NxdsDensity as l, type NxdsElevation as m, type NxdsStroke as n, type NxdsThemeContract as o, STROKE_OPTIONS as p, type SurfaceToken as q, type ThemeSeeds as r, type TokenMap as s, appearancePrefsToCss as t, createNxdsThemeContract as u, deriveTheme as v, normalizeAppearanceModeIds as w, sanitizeNxdsAppearance as x, sanitizeNxdsAppearancePrefs as y, themeToCss as z };
+export { normalizeAppearanceModeIds as A, BASE_TONE_OPTIONS as B, CORNER_OPTIONS as C, DARK_SURFACE_LADDER as D, ELEVATION_OPTIONS as E, FONT_SIZE_PX_MAX as F, sanitizeNxdsAppearance as G, sanitizeNxdsAppearancePrefs as H, textSizePx as I, themeToCss as J, LIGHT_SURFACE_LADDER as L, type NxdsColorAppearance as N, SURFACE_TOKENS as S, TEXT_SIZE_OPTIONS as T, UI_SCALE_OPTIONS as U, type NxdsUiScale as a, type NxdsTextSize as b, type NxdsAppearancePrefs as c, type NxdsPresetField as d, type ShadeAnchor as e, type NxdsAppearanceState as f, type DerivedTheme as g, BASE_TONE_SEEDS as h, DEFAULT_BRAND_COLOR as i, DEFAULT_NXDS_APPEARANCE as j, DENSITY_OPTIONS as k, FONT_SIZE_PX_MIN as l, type NxdsAppearanceMode as m, type NxdsCorners as n, type NxdsDensity as o, type NxdsElevation as p, type NxdsStroke as q, type NxdsThemeContract as r, STROKE_OPTIONS as s, type SurfaceToken as t, type ThemeDerivationInput as u, type ThemeSeeds as v, type TokenMap as w, appearancePrefsToCss as x, createNxdsThemeContract as y, deriveTheme as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxds/core",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "type": "module",
   "description": "nxds theme engine: a framework-agnostic appearance model, runtime theme derivation and first-paint snapshots.",
   "keywords": [