@12-apps/ui 6.39.20 → 6.40.0

package/dist/types-native/tokens/theme.d.ts

@@ -1,7 +1,9 @@
 import { contrastText, inkOver } from './ink-over';
 export { contrastText, inkOver };
+import { type DensityLevel, type ResolvedDensity } from './density.core';
 import { type HeadingLevel } from './heading-scale';
 import type { SizeValue } from './vocabulary';
+export type { DensityLevel, ResolvedDensity };
 /**
  * THE THEME BOTH RENDERERS READ.
  *
@@ -113,6 +115,14 @@ export interface UiTheme {
      * (`./field-height.core`) is the dp a field of `size` lays out at.
      */
     fieldHeight: number;
+    /**
+     * The resolved density (FUT-2764): `factor` scales the type scale, the
+     * spacing unit and `fieldHeight` together (see `./density.core`); `level`
+     * is present only when a NAMED level was given, absent for a raw numeric
+     * `density`. Always resolved — `factor` is never optional. Unset resolves
+     * to `{ level: 'normal', factor: 1 }`, today's numbers exactly.
+     */
+    density: ResolvedDensity;
     typography: UiTypography;
     zIndex: {
         appBar: number;
@@ -136,6 +146,26 @@ export interface UiThemeOptions {
         background: Partial<UiPalette['background']>;
     }>;
     typography?: Partial<Pick<UiTypography, 'fontFamily' | 'monospaceFontFamily'>>;
+    /**
+     * `spacingUnit` and `fieldHeight` below still win over EVERYTHING, including
+     * this — density only supplies THEIR fallback, the same `??` pattern those
+     * two already use. Precedence, highest first: an explicit `spacingUnit` /
+     * `fieldHeight` option > a numeric `density` (used as the factor directly,
+     * no table lookup) > `densityFactors[level]` (below) > the built-in table
+     * (`compact` 0.9 / `normal` 1 / `comfortable` 1.1). No `density` at all is
+     * `'normal'`, factor `1` — today, byte-for-byte. A numeric `density` that is
+     * not a positive, finite number (`0`, negative, `NaN`, `Infinity`) falls back
+     * to `'normal'` the same way; a `densityFactors` entry that isn't falls back
+     * to the built-in table's value for that level (see `./density.core`).
+     *
+     * A named level (`density: 'compact'`, e.g. a backoffice app), no
+     * `density` at all (`'normal'`, e.g. a storefront), or a raw factor
+     * (`density: 1.15`, e.g. a kiosk app whose own hardware needs a value
+     * none of the three names fit).
+     */
+    density?: DensityLevel | number;
+    /** A repository's own factor for a named level, overriding the built-in table above. */
+    densityFactors?: Partial<Record<DensityLevel, number>>;
     spacingUnit?: number;
     /** The radius every field is drawn with, in dp. Defaults to {@link DEFAULT_FIELD_RADIUS}. */
     fieldRadius?: number;

package/dist/types-native/tokens/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tokens/theme.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/tokens/theme.ts"],"names":[],"mappings":"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"}

package/dist/typography/Heading.js

@@ -1,17 +1,18 @@
 import "../chunk-6GP2DOOO.js";
 import {
   Heading
-} from "../chunk-IWEUSZY3.js";
-import "../chunk-RB3X6CEE.js";
-import "../chunk-CYZZHWNK.js";
+} from "../chunk-X66E5WSX.js";
+import "../chunk-IWGW2E35.js";
+import "../chunk-CJ45OL7L.js";
 import "../chunk-TYJR4GOF.js";
 import "../chunk-PT6TCWIW.js";
-import "../chunk-BLW6KLDR.js";
+import "../chunk-YFODI4KT.js";
+import "../chunk-VBP46YP4.js";
 import "../chunk-2BYKTBDL.js";
 import "../chunk-AG66JBNH.js";
 import "../chunk-FZXKH2ZT.js";
 import "../chunk-26X4CZVR.js";
-import "../chunk-PZBK3F52.js";
+import "../chunk-O6MJWHU5.js";
 import "../chunk-FQ6UW7IY.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-N3GAFIXG.js";

package/dist/typography/Text.js

@@ -1,15 +1,16 @@
 import "../chunk-VUHLNYAE.js";
 import {
   Text
-} from "../chunk-URHX4FAQ.js";
-import "../chunk-ZN6YATOG.js";
+} from "../chunk-MKLIMY3D.js";
+import "../chunk-PAT2BQOQ.js";
 import "../chunk-TYJR4GOF.js";
-import "../chunk-BLW6KLDR.js";
+import "../chunk-YFODI4KT.js";
+import "../chunk-VBP46YP4.js";
 import "../chunk-2BYKTBDL.js";
 import "../chunk-AG66JBNH.js";
 import "../chunk-FZXKH2ZT.js";
 import "../chunk-26X4CZVR.js";
-import "../chunk-PZBK3F52.js";
+import "../chunk-O6MJWHU5.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-YKCAJ2TN.js";
 import "../chunk-PZ5AY32C.js";

package/dist/user-avatar.js

@@ -1,37 +1,38 @@
 import {
   UserAvatar,
   UserMenu
-} from "./chunk-ZWCYSAI5.js";
+} from "./chunk-V7A5ZAAF.js";
 import "./chunk-UDQSIRAP.js";
-import "./chunk-66O55OZI.js";
+import "./chunk-NYFGFELX.js";
 import "./chunk-3ZVUNSFF.js";
-import "./chunk-Y6C4MYZE.js";
-import "./chunk-MTEQEPNY.js";
+import "./chunk-TNQDSTIA.js";
 import "./chunk-6ZZGK5DT.js";
+import "./chunk-MTEQEPNY.js";
 import "./chunk-VUHLNYAE.js";
 import "./chunk-2GSIEDGN.js";
-import "./chunk-WN5PNP6F.js";
-import "./chunk-FKUYRQSP.js";
+import "./chunk-OTWMG7B2.js";
 import "./chunk-76X6JRVI.js";
 import "./chunk-JH7EEJEQ.js";
+import "./chunk-FKUYRQSP.js";
 import "./chunk-BA4RHQ3B.js";
-import "./chunk-HM2JJNUE.js";
-import "./chunk-TAMIZE4Q.js";
-import "./chunk-4WNFOBTH.js";
+import "./chunk-BLUURKCY.js";
+import "./chunk-KOX2AEFW.js";
 import "./chunk-LN46DSMF.js";
-import "./chunk-URHX4FAQ.js";
-import "./chunk-ZN6YATOG.js";
+import "./chunk-TAMIZE4Q.js";
+import "./chunk-MKLIMY3D.js";
+import "./chunk-PAT2BQOQ.js";
 import "./chunk-TYJR4GOF.js";
-import "./chunk-CGO452DC.js";
+import "./chunk-EXFX3JRN.js";
 import "./chunk-GDN2LUTZ.js";
 import "./chunk-7FDU3FIN.js";
 import "./chunk-EPEJMTCQ.js";
-import "./chunk-BLW6KLDR.js";
+import "./chunk-YFODI4KT.js";
+import "./chunk-VBP46YP4.js";
 import "./chunk-2BYKTBDL.js";
 import "./chunk-AG66JBNH.js";
 import "./chunk-FZXKH2ZT.js";
 import "./chunk-26X4CZVR.js";
-import "./chunk-PZBK3F52.js";
+import "./chunk-O6MJWHU5.js";
 import "./chunk-FQ6UW7IY.js";
 import "./chunk-6JAIFIPW.js";
 import "./chunk-N3GAFIXG.js";

package/dist/utility/InstallPrompt.js

@@ -5,7 +5,6 @@ import {
 import {
   usePwaInstall
 } from "../chunk-5GMHJ7Y5.js";
-import "../chunk-GY62N32G.js";
 import "../chunk-WXYLH3QZ.js";
 import {
   PWA_INSTALL_AVAILABLE_EVENT,
@@ -14,6 +13,7 @@ import {
   readPwaInstallStash,
   resetPwaInstallStash
 } from "../chunk-UUL44SUX.js";
+import "../chunk-GY62N32G.js";
 import "../chunk-PZ5AY32C.js";
 export {
   InstallPrompt,

package/dist/utility/WorkflowStep.js

@@ -5,19 +5,21 @@ import {
 import "../chunk-7OO3BELX.js";
 import "../chunk-KJID4PRD.js";
 import "../chunk-RXNIOPOA.js";
-import "../chunk-TCAQOUIB.js";
+import "../chunk-ZSTSISM6.js";
+import "../chunk-TRTX4BDI.js";
 import "../chunk-7ZPUN7TV.js";
 import "../chunk-PT6TCWIW.js";
-import "../chunk-CGO452DC.js";
+import "../chunk-EXFX3JRN.js";
 import "../chunk-GDN2LUTZ.js";
 import "../chunk-7FDU3FIN.js";
 import "../chunk-EPEJMTCQ.js";
-import "../chunk-BLW6KLDR.js";
+import "../chunk-YFODI4KT.js";
+import "../chunk-VBP46YP4.js";
 import "../chunk-2BYKTBDL.js";
 import "../chunk-AG66JBNH.js";
 import "../chunk-FZXKH2ZT.js";
 import "../chunk-26X4CZVR.js";
-import "../chunk-PZBK3F52.js";
+import "../chunk-O6MJWHU5.js";
 import "../chunk-FQ6UW7IY.js";
 import "../chunk-6JAIFIPW.js";
 import "../chunk-N3GAFIXG.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/ui",
-  "version": "6.39.20",
+  "version": "6.40.0",
   "license": "MIT",
   "packageManager": "pnpm@10.34.5",
   "type": "module",

package/src/provider/mui-bridge.ts

@@ -1,8 +1,9 @@
 import type { PaletteColor, Theme, ThemeOptions } from '@mui/material/styles/index.js';
 
 import { cssLengthToPx, cssTrackingToEm } from '../tokens/css-units';
+import { densityFontSize, resolveDensityFactor } from '../tokens/density';
 import { resolveFieldHeight } from '../tokens/field-height.core';
-import { fieldOverrides } from '../tokens/field-height';
+import { fieldOverrides, mergeMuiComponents } from '../tokens/field-height';
 import { fieldRadius } from '../tokens/field-radius';
 import { accentFor } from '../tokens/scales';
 import {
@@ -102,6 +103,9 @@ export function uiThemeFromMui(theme: Theme): UiTheme {
     spacingUnit: unit,
     radius: { sm: md / 2, md, lg: md * 2, xl: md * 4, full: 9999, field: fieldRadius(theme) },
     fieldHeight: resolveFieldHeight(theme.fieldHeight),
+    // A bare MUI theme (never built through `createUiTheme`/`muiThemeOptionsFrom`)
+    // carries no `theme.density` — read back as `'normal'`, factor `1`.
+    density: theme.density ?? resolveDensityFactor(),
     typography: {
       fontFamily: theme.typography.fontFamily ?? WEB_FONT_FAMILY,
       monospaceFontFamily: WEB_MONOSPACE_FONT_FAMILY,
@@ -140,9 +144,19 @@ export function muiThemeOptionsFrom(ui: UiTheme): ThemeOptions {
     shape: { borderRadius: ui.radius.md },
     fieldRadius: ui.radius.field,
     fieldHeight: ui.fieldHeight,
-    components: fieldOverrides(ui.radius.field, ui.fieldHeight),
+    // Additive: children 2–4 (FUT-2766–2768) each add one more source here as
+    // their own geometry overrides land — this PR wires the merge helper to
+    // `fieldOverrides` alone, since no geometry override exists yet.
+    components: mergeMuiComponents(fieldOverrides(ui.radius.field, ui.fieldHeight)),
     spacing: ui.spacingUnit,
-    typography: { fontFamily: ui.typography.fontFamily ?? WEB_FONT_FAMILY },
+    density: ui.density,
+    typography: {
+      fontFamily: ui.typography.fontFamily ?? WEB_FONT_FAMILY,
+      // MUI multiplies every `pxToRem` size by `fontSize / 14` — the lever a
+      // density mode moves (`./tokens/relative.ts`). `htmlFontSize` stays
+      // untouched: that is a reader's own zoom/accessibility setting, not this.
+      fontSize: densityFontSize(ui.density.factor),
+    },
     zIndex: { ...ui.zIndex },
   };
 }

package/src/tokens/density.core.ts

@@ -0,0 +1,118 @@
+/**
+ * THE ONE DENSITY KNOB, WITH NO RENDERER BEHIND IT.
+ *
+ * A host that wants a compact admin or a roomy kiosk should say so once, in
+ * the theme — not hunt through every component's own numbers. Because every
+ * size already goes through `rem(theme, px)` / `theme.spacing()` / `fieldHeight()`
+ * (FUT-2585, `./relative.ts`), moving the type scale, the spacing unit and the
+ * field height BY THE SAME FACTOR is enough to make the whole package denser
+ * or roomier — no `size` step is rewritten, no component is touched (FUT-2764
+ * Decision 3).
+ *
+ * Three named levels, or a raw factor for a repository the three names don't
+ * fit (a kiosk app, say). A repository can also redefine what a named level
+ * itself means (`densityFactors`). Precedence, highest first, ABOVE
+ * `resolveDensityFactor` itself — this file's own resolver has no notion of an
+ * "explicit option" to defer to, that is each CALLER's job:
+ *
+ * - On the `createUiTheme` path (`./theme.ts`): an explicit `spacingUnit` /
+ *   `fieldHeight` option (`UiThemeOptions` carries no `typography.fontSize` —
+ *   only `fontFamily`/`monospaceFontFamily`) still wins over EVERYTHING below,
+ *   unchanged.
+ * - On the MUI-native path (`densityThemeOptions`'s output, or a host's own
+ *   `createTheme()` options merged around it): whichever `typography.fontSize`
+ *   / `spacing` a host's OWN object literal states last wins — plain
+ *   JavaScript object-spread order, not a rule this package enforces. See
+ *   `./density.ts` for exactly where to put it.
+ *
+ * Below that: a numeric `density` (used as the factor directly, no table
+ * lookup, and only when it is a USABLE one — see `resolveDensityFactor`) >
+ * `densityFactors[level]` (a repository's own override for a named level,
+ * same usability rule) > the built-in table below. No `density` at all
+ * resolves to `{ level: 'normal', factor: 1 }` — today, byte-for-byte.
+ *
+ * This file is the resolver alone, so the native renderer and `./theme.ts`
+ * read it without importing MUI. The web reader — `useDensity()`, the MUI
+ * theme channel, and the standalone `densityThemeOptions()` — is in
+ * `./density.ts`.
+ */
+
+export type DensityLevel = 'compact' | 'normal' | 'comfortable';
+
+export const DEFAULT_DENSITY: DensityLevel = 'normal';
+
+/**
+ * The built-in factor table — the LOWEST-precedence source. A repository's
+ * own `densityFactors` entry for a level wins over it; a numeric `density`
+ * bypasses it entirely. Confirmed against screenshots before this PR merges
+ * (see the ticket's Done when) — `compact` 0.9, `normal` 1 (no-op),
+ * `comfortable` 1.1.
+ */
+export const DENSITY_FACTOR: Record<DensityLevel, number> = {
+  compact: 0.9,
+  normal: 1,
+  comfortable: 1.1,
+};
+
+export interface ResolvedDensity {
+  /** Present only when a NAMED level was given; a raw numeric `density` has no name. */
+  level?: DensityLevel;
+  factor: number;
+}
+
+/**
+ * A usable factor — a positive, finite number. The same shape
+ * `resolveFieldHeight` (`./field-height.core`) already accepts for a `height`;
+ * a numeric `density` and a `densityFactors` entry are held to the same rule
+ * so an unusable one falls back exactly the way an unusable `fieldHeight`
+ * option already does, rather than baking a `0`, a negative or a `NaN`/
+ * `Infinity` into `spacingUnit`/`fieldHeight`/`typography.fontSize`.
+ */
+function isUsableFactor(value: unknown): value is number {
+  return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+
+/**
+ * Precedence (highest first): a numeric `density` IS the factor, no table lookup —
+ * but only when it is a usable one (a positive, finite number); `0`, a negative
+ * number, `NaN` or `Infinity` are not a density anyone meant, so they fall back
+ * to `'normal'`, factor `1`, exactly as no `density` at all does. A named
+ * `density` resolves through `factors?.[level] ?? DENSITY_FACTOR[level]` — a
+ * repository's own `densityFactors` override wins over the built-in table, but
+ * only when IT is usable too; an unusable entry falls back to the BUILT-IN
+ * table's value for that same level (not to `'normal'` — the level itself is
+ * still the one asked for, only its factor is unusable). No `density` at all
+ * resolves to `{ level: 'normal', factor: 1 }`.
+ */
+export function resolveDensityFactor(
+  density?: DensityLevel | number,
+  factors?: Partial<Record<DensityLevel, number>>,
+): ResolvedDensity {
+  if (typeof density === 'number') {
+    if (isUsableFactor(density)) return { factor: density };
+    density = undefined; // not usable — fall through to 'normal', below
+  }
+  const level = density ?? DEFAULT_DENSITY;
+  const override = factors?.[level];
+  const factor = isUsableFactor(override) ? override : DENSITY_FACTOR[level];
+  return { level, factor };
+}
+
+const BASE_FONT_SIZE = 14; // MUI's own typography.fontSize baseline
+const BASE_SPACING_UNIT = 8; // theme.ts's literal default
+const BASE_FIELD_HEIGHT = 2.5; // field-height.core.ts's DEFAULT_FIELD_HEIGHT
+
+/** MUI's own `typography.fontSize` at this factor. `htmlFontSize` is never touched. */
+export function densityFontSize(factor: number): number {
+  return BASE_FONT_SIZE * factor;
+}
+
+/** The theme's `spacingUnit` at this factor. */
+export function densitySpacingUnit(factor: number): number {
+  return BASE_SPACING_UNIT * factor;
+}
+
+/** The standard field height (multiples of the default font size) at this factor. */
+export function densityFieldHeight(factor: number): number {
+  return BASE_FIELD_HEIGHT * factor;
+}

package/src/tokens/density.ts

@@ -0,0 +1,134 @@
+import { useTheme } from '@mui/material/styles/index.js';
+import type { ThemeOptions } from '@mui/material/styles/index.js';
+
+import {
+  densityFieldHeight,
+  densityFontSize,
+  densitySpacingUnit,
+  resolveDensityFactor,
+  type DensityLevel,
+  type ResolvedDensity,
+} from './density.core';
+import { fieldOverrides, mergeMuiComponents } from './field-height';
+import { DEFAULT_FIELD_RADIUS } from './field-radius.core';
+
+/**
+ * DENSITY ON THE WEB: the MUI theme channel, the reader, and the standalone
+ * entry point for a host that never calls `createUiTheme`/`UiProvider`.
+ *
+ * The argument for one density knob, the factor table and its precedence are
+ * in `./density.core.ts`.
+ */
+
+export {
+  DEFAULT_DENSITY,
+  DENSITY_FACTOR,
+  densityFieldHeight,
+  densityFontSize,
+  densitySpacingUnit,
+  resolveDensityFactor,
+  type DensityLevel,
+  type ResolvedDensity,
+} from './density.core';
+
+declare module '@mui/material/styles' {
+  interface Theme {
+    /** The density this theme renders at. See `@12-apps/ui/tokens`' `useDensity`. */
+    density?: ResolvedDensity;
+  }
+  interface ThemeOptions {
+    /** The density this theme renders at. See `@12-apps/ui/tokens`' `useDensity`. */
+    density?: ResolvedDensity;
+  }
+}
+
+/**
+ * The theme's resolved density — a plain theme read, not a step-shifting
+ * resolver (`size` stays hierarchy; see `./density.core.ts`). A `styleOverrides`
+ * callback already gets `{ theme }` and can read `theme.density` directly;
+ * this is for a component that needs the level in its own render logic
+ * (`Table`/`DataGrid`/`DataViews` each read it once to source their own
+ * `density` prop's default).
+ *
+ * Falls back to `resolveDensityFactor()` (`'normal'`, factor `1`) for a bare
+ * MUI theme built without `createUiTheme`/`muiThemeOptionsFrom`.
+ */
+export function useDensity(): ResolvedDensity {
+  return useTheme().density ?? resolveDensityFactor();
+}
+
+/**
+ * The density factor as a MUI `ThemeOptions` fragment, for a host that builds
+ * `createTheme()` directly and never calls `createUiTheme`/`UiProvider` — the
+ * same precedence `resolveDensityFactor` gives `createUiTheme`, so the two
+ * consumption paths agree on `typography`/`spacing`/`fieldHeight`/`components`
+ * (FUT-2764's Design section), not just the first two. `fieldHeight` matters
+ * on its own: `Input`/`Select`/`Button` each read `theme.fieldHeight` directly
+ * (`Input.tsx`, `Select.tsx`, `Button.styles.ts`'s `buttonSize`), so a fragment
+ * that carried only `typography`/`spacing` left every field standing at the
+ * DEFAULT height (2.5) at every density on this path — the two paths would
+ * agree on the type scale and disagree on the one number three components key
+ * their own layout off.
+ *
+ * `components` is the matching MUI-native override (`fieldOverrides`) for a
+ * HOST's own bare `TextField`/`Select`, mirroring `muiThemeOptionsFrom`'s own
+ * `components: mergeMuiComponents(fieldOverrides(...))`. It carries ONLY the
+ * field overrides this function knows about (`MuiOutlinedInput`'s `root`,
+ * `input` and `notchedOutline`; `MuiInputLabel`'s `outlined`) — a host with
+ * ITS OWN overrides for OTHER components merges them in with
+ * `mergeMuiComponents(densityThemeOptions(density).components, hostOverrides)`,
+ * which keeps a component only ONE side touches untouched. For a component
+ * BOTH sides style, the merge is by INNER key (`root`/`input`/…): a key only
+ * one side sets survives from that side, but a key BOTH set is replaced
+ * WHOLESALE by whichever source is passed LAST — not deep-merged — so a host
+ * wanting to ADD to, say, `MuiOutlinedInput`'s `root` alongside the radius
+ * override needs to write that one key's object out in full itself.
+ *
+ * `fieldRadius` (3rd argument, optional) exists because density does NOT touch
+ * the field's CORNER — this is only for a host that already draws its OWN,
+ * non-default radius and wants `components` to match it instead of clashing;
+ * it defaults
+ * to the same {@link DEFAULT_FIELD_RADIUS} `createUiTheme` itself falls back
+ * to when a host names no `fieldRadius`, so the two paths still agree with no
+ * argument passed at all — the existing 2-argument call keeps working
+ * unchanged.
+ *
+ * **Where to spread it — the first `createTheme()` call, not a later layering
+ * one.** `createTheme(options, ...args)` (`createThemeNoVars.js`) only runs
+ * `createSpacing`/`createTypography` on `options`, the FIRST argument; every
+ * later argument is deep-merged onto the theme those two already built, with
+ * no such reprocessing. So a host with a base theme and a SECOND, layering
+ * `createTheme()` call on top of it — exactly the shape a two-theme host uses,
+ * `createTheme(outer, { palette: { ... } })` — must apply density at the
+ * FIRST call (where the base itself is built), never spread onto `outer` in
+ * the second one:
+ *
+ * ```ts
+ * // RIGHT — density goes into the base's OWN construction. The second,
+ * // layering call is unaffected: it never restates spacing/typography/
+ * // fieldHeight/components itself, so `theme.spacing`/`pxToRem`/`fieldHeight`
+ * // carry over from `base` UNCHANGED, already correctly scaled.
+ * const base = createTheme({ palette: { primary: { main }, ... }, ...densityThemeOptions('compact') });
+ * const themed = createTheme(base, { palette: { primary: { main: brand } } });
+ *
+ * // WRONG — a second, layering argument onto an ALREADY-BUILT theme is
+ * // deepmerged with no reprocessing: `spacing`/`typography.fontSize` would
+ * // overwrite the already-resolved `theme.spacing` function/`pxToRem` ratio
+ * // instead of rescaling them.
+ * createTheme(outer, { ...densityThemeOptions('compact') });
+ * ```
+ */
+export function densityThemeOptions(
+  density: DensityLevel | number,
+  factors?: Partial<Record<DensityLevel, number>>,
+  fieldRadius: number = DEFAULT_FIELD_RADIUS,
+): Pick<ThemeOptions, 'typography' | 'spacing' | 'fieldHeight' | 'components'> {
+  const { factor } = resolveDensityFactor(density, factors);
+  const fieldHeight = densityFieldHeight(factor);
+  return {
+    typography: { fontSize: densityFontSize(factor) },
+    spacing: densitySpacingUnit(factor),
+    fieldHeight,
+    components: mergeMuiComponents(fieldOverrides(fieldRadius, fieldHeight)),
+  };
+}

package/src/tokens/field-height.core.ts

@@ -44,9 +44,14 @@ export const FIELD_HEIGHT_SCALE: Record<SizeValue, number> = {
   xl: 1.4,
 };
 
-/** A usable standard height: the given one when it is a positive number, the default otherwise. */
-export function resolveFieldHeight(height: unknown): number {
-  return typeof height === 'number' && Number.isFinite(height) && height > 0 ? height : DEFAULT_FIELD_HEIGHT;
+/**
+ * A usable standard height: the given one when it is a positive number, a
+ * caller's own `fallback` otherwise — {@link DEFAULT_FIELD_HEIGHT} unless a
+ * density factor (`./density.core`) already worked out a denser or roomier
+ * one to fall back to instead.
+ */
+export function resolveFieldHeight(height: unknown, fallback: number = DEFAULT_FIELD_HEIGHT): number {
+  return typeof height === 'number' && Number.isFinite(height) && height > 0 ? height : fallback;
 }
 
 /** A field's height for a size, in multiples of the default font size (`rem`). */

package/src/tokens/field-height.ts

@@ -120,23 +120,34 @@ export function fieldHeightOverrides(height: number = DEFAULT_FIELD_HEIGHT): Com
 }
 
 /**
- * Both field overrides — the corner and the height — merged per component.
- * They meet on `MuiOutlinedInput` (`root` from the radius, `input` from the
- * height), so a plain spread would lose one of them.
+ * Several `Components<Theme>` override sets, merged per component name — a
+ * later source's `styleOverrides` win over an earlier one's for the SAME
+ * inner key, but neither erases the other's keys. A plain spread of the
+ * top-level objects would drop every override but the last source's for a
+ * component two sources both style (`fieldOverrides` below merges exactly
+ * two; density's geometry overrides, FUT-2766–2768, add more).
  */
-export function fieldOverrides(radius: number | undefined, height: number | undefined): Components<Theme> {
+export function mergeMuiComponents(...sources: Components<Theme>[]): Components<Theme> {
   type Entry = { styleOverrides?: Record<string, unknown> };
-  const corner = fieldRadiusOverrides(radius) as Record<string, Entry>;
-  const tall = fieldHeightOverrides(height) as Record<string, Entry>;
-  const names = new Set([...Object.keys(corner), ...Object.keys(tall)]);
+  const maps = sources as unknown as Record<string, Entry>[];
+  const names = new Set(maps.flatMap((map) => Object.keys(map)));
   return Object.fromEntries(
     [...names].map((name) => [
       name,
-      { styleOverrides: { ...corner[name]?.styleOverrides, ...tall[name]?.styleOverrides } },
+      { styleOverrides: Object.assign({}, ...maps.map((map) => map[name]?.styleOverrides)) },
     ]),
   ) as Components<Theme>;
 }
 
+/**
+ * Both field overrides — the corner and the height — merged per component.
+ * They meet on `MuiOutlinedInput` (`root` from the radius, `input` from the
+ * height), so a plain spread would lose one of them.
+ */
+export function fieldOverrides(radius: number | undefined, height: number | undefined): Components<Theme> {
+  return mergeMuiComponents(fieldRadiusOverrides(radius), fieldHeightOverrides(height));
+}
+
 /**
  * THE field standard on a MUI `TextField` / `Select` / `Autocomplete`, for a
  * composite that renders MUI's own: the field radius, the field height for

package/src/tokens/index.native.ts

@@ -15,5 +15,16 @@ export {
   fieldHeightPx,
   fieldHeightRem,
 } from './field-height.core';
+// The density knob's factor table and resolver (FUT-2764); `DensityLevel`/
+// `ResolvedDensity` are already exported above, through `./theme`. NOT
+// `useDensity`, which reads a MUI theme and belongs to the web build.
+export {
+  DEFAULT_DENSITY,
+  DENSITY_FACTOR,
+  densityFieldHeight,
+  densityFontSize,
+  densitySpacingUnit,
+  resolveDensityFactor,
+} from './density.core';
 // The named colour sets a *.metrics.ts table reads (FUT-2593); no MUI behind them.
 export * from './ink.core';

package/src/tokens/scales.ts

@@ -33,7 +33,22 @@ export {
   fieldHeightRem,
   fieldOverrides,
   fieldTextFieldStyles,
+  mergeMuiComponents,
 } from './field-height';
+// The theme's density knob (FUT-2764): the factor table, the resolver, the
+// per-repository override and the standalone entry for a host that builds
+// `createTheme()` directly. `DensityLevel`/`ResolvedDensity` are already
+// exported above, through `./theme`.
+export {
+  DEFAULT_DENSITY,
+  DENSITY_FACTOR,
+  densityFieldHeight,
+  densityFontSize,
+  densitySpacingUnit,
+  densityThemeOptions,
+  resolveDensityFactor,
+  useDensity,
+} from './density';
 
 export interface Accent {
   main: string;