@12-apps/ui 6.39.20 → 6.40.0

package/dist/social-login-button.js

@@ -4,40 +4,41 @@ import {
   GoogleIcon,
   SocialLoginButton,
   SocialLoginContainer
-} from "./chunk-SLDSWQVE.js";
+} from "./chunk-4SSWJRC4.js";
 import "./chunk-INGPH3YQ.js";
 import "./chunk-6GP2DOOO.js";
-import "./chunk-IWEUSZY3.js";
-import "./chunk-RB3X6CEE.js";
-import "./chunk-CYZZHWNK.js";
+import "./chunk-X66E5WSX.js";
+import "./chunk-IWGW2E35.js";
+import "./chunk-CJ45OL7L.js";
 import "./chunk-CMMPGAMJ.js";
-import "./chunk-X53F33KA.js";
-import "./chunk-35443PF6.js";
+import "./chunk-RWXYND4H.js";
+import "./chunk-JIRZ27RI.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-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/dist/tokens.js

@@ -1,6 +1,10 @@
 import {
   accentFor
-} from "./chunk-TCAQOUIB.js";
+} from "./chunk-ZSTSISM6.js";
+import {
+  densityThemeOptions,
+  useDensity
+} from "./chunk-TRTX4BDI.js";
 import {
   COLOR_VALUES,
   SIZE_VALUES,
@@ -18,8 +22,9 @@ import {
   fieldHeight,
   fieldHeightOverrides,
   fieldOverrides,
-  fieldTextFieldStyles
-} from "./chunk-CGO452DC.js";
+  fieldTextFieldStyles,
+  mergeMuiComponents
+} from "./chunk-EXFX3JRN.js";
 import {
   fieldRadius,
   fieldRadiusOverrides,
@@ -40,7 +45,15 @@ import {
   augmentColor,
   createUiTheme,
   px
-} from "./chunk-BLW6KLDR.js";
+} from "./chunk-YFODI4KT.js";
+import {
+  DEFAULT_DENSITY,
+  DENSITY_FACTOR,
+  densityFieldHeight,
+  densityFontSize,
+  densitySpacingUnit,
+  resolveDensityFactor
+} from "./chunk-VBP46YP4.js";
 import {
   contrastText,
   inkOver
@@ -59,7 +72,7 @@ import {
   FIELD_HEIGHT_SCALE,
   fieldHeightPx,
   fieldHeightRem
-} from "./chunk-PZBK3F52.js";
+} from "./chunk-O6MJWHU5.js";
 import {
   DEFAULT_UI_INK,
   absoluteInk,
@@ -117,10 +130,12 @@ export {
   COLOR_VALUES,
   DATA_VIZ_NEON,
   DEFAULT_BRAND,
+  DEFAULT_DENSITY,
   DEFAULT_FIELD_HEIGHT,
   DEFAULT_FIELD_RADIUS,
   DEFAULT_UI_INK,
   DEFAULT_UI_THEME,
+  DENSITY_FACTOR,
   EFFECT_GLOW,
   ELEVATION_SHADOWS,
   FIELD_BORDER_WIDTH,
@@ -151,6 +166,10 @@ export {
   createUiTheme,
   darken,
   decomposeColor,
+  densityFieldHeight,
+  densityFontSize,
+  densitySpacingUnit,
+  densityThemeOptions,
   emphasize,
   fieldBorder,
   fieldControlStyles,
@@ -171,6 +190,7 @@ export {
   hslToRgb,
   inkOver,
   lighten,
+  mergeMuiComponents,
   modeInk,
   muiColor,
   muiSize,
@@ -183,11 +203,13 @@ export {
   remPx,
   rems,
   resetRootFontCache,
+  resolveDensityFactor,
   scrim,
   shadowInk,
   sheen,
   softNeutral,
   sxRem,
-  uiInk
+  uiInk,
+  useDensity
 };
 //# sourceMappingURL=tokens.js.map

package/dist/types/provider/mui-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mui-bridge.d.ts","sourceRoot":"","sources":["../../../src/provider/mui-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAOvF,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AAwCzB,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CA+DpD;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,OAAO,GAAG,YAAY,CAyB7D"}
+{"version":3,"file":"mui-bridge.d.ts","sourceRoot":"","sources":["../../../src/provider/mui-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAQvF,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AAwCzB,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAkEpD;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,OAAO,GAAG,YAAY,CAmC7D"}

package/dist/types/tokens/density.core.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 declare const DEFAULT_DENSITY: DensityLevel;
+/**
+ * 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 declare const DENSITY_FACTOR: Record<DensityLevel, number>;
+export interface ResolvedDensity {
+    /** Present only when a NAMED level was given; a raw numeric `density` has no name. */
+    level?: DensityLevel;
+    factor: number;
+}
+/**
+ * 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 declare function resolveDensityFactor(density?: DensityLevel | number, factors?: Partial<Record<DensityLevel, number>>): ResolvedDensity;
+/** MUI's own `typography.fontSize` at this factor. `htmlFontSize` is never touched. */
+export declare function densityFontSize(factor: number): number;
+/** The theme's `spacingUnit` at this factor. */
+export declare function densitySpacingUnit(factor: number): number;
+/** The standard field height (multiples of the default font size) at this factor. */
+export declare function densityFieldHeight(factor: number): number;
+//# sourceMappingURL=density.core.d.ts.map

package/dist/types/tokens/density.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.core.d.ts","sourceRoot":"","sources":["../../../src/tokens/density.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEhE,eAAO,MAAM,eAAe,EAAE,YAAuB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIvD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,EAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC9C,eAAe,CASjB;AAMD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/types/tokens/density.d.ts

@@ -0,0 +1,95 @@
+import type { ThemeOptions } from '@mui/material/styles/index.js';
+import { type DensityLevel, type ResolvedDensity } from './density.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 declare function useDensity(): ResolvedDensity;
+/**
+ * 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 declare function densityThemeOptions(density: DensityLevel | number, factors?: Partial<Record<DensityLevel, number>>, fieldRadius?: number): Pick<ThemeOptions, 'typography' | 'spacing' | 'fieldHeight' | 'components'>;
+//# sourceMappingURL=density.d.ts.map

package/dist/types/tokens/density.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.d.ts","sourceRoot":"","sources":["../../../src/tokens/density.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAIxB;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,KAAK;QACb,iFAAiF;QACjF,OAAO,CAAC,EAAE,eAAe,CAAC;KAC3B;IACD,UAAU,YAAY;QACpB,iFAAiF;QACjF,OAAO,CAAC,EAAE,eAAe,CAAC;KAC3B;CACF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAE5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,GAAG,MAAM,EAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,EAC/C,WAAW,GAAE,MAA6B,GACzC,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC,CAS7E"}

package/dist/types/tokens/field-height.core.d.ts

@@ -33,8 +33,13 @@ export declare const FIELD_HEIGHT_FONT_PX = 16;
  * the roomy ones. All of them stay multiples of the font size.
  */
 export declare const FIELD_HEIGHT_SCALE: Record<SizeValue, number>;
-/** A usable standard height: the given one when it is a positive number, the default otherwise. */
-export declare function resolveFieldHeight(height: unknown): number;
+/**
+ * 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 declare function resolveFieldHeight(height: unknown, fallback?: number): number;
 /** A field's height for a size, in multiples of the default font size (`rem`). */
 export declare function fieldHeightRem(height: number, size?: SizeValue): number;
 /** A field's height for a size in px (dp) — what the native renderer lays out. */

package/dist/types/tokens/field-height.core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-height.core.d.ts","sourceRoot":"","sources":["../../../src/tokens/field-height.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMxD,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAI7E;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC"}
+{"version":3,"file":"field-height.core.d.ts","sourceRoot":"","sources":["../../../src/tokens/field-height.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMxD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAE,MAA6B,GAAG,MAAM,CAEnG;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAI7E;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC"}

package/dist/types/tokens/field-height.d.ts

@@ -42,6 +42,15 @@ export declare function fieldControlStyles(theme: Theme, size?: SizeValue): CSSO
  * a host that wants another density asks this package's fields for a `size`.
  */
 export declare function fieldHeightOverrides(height?: number): Components<Theme>;
+/**
+ * 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 declare function mergeMuiComponents(...sources: Components<Theme>[]): Components<Theme>;
 /**
  * Both field overrides — the corner and the height — merged per component.
  * They meet on `MuiOutlinedInput` (`root` from the radius, `input` from the

package/dist/types/tokens/field-height.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-height.d.ts","sourceRoot":"","sources":["../../../src/tokens/field-height.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAYlF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;GAOG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,KAAK;QACb,iHAAiH;QACjH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IACD,UAAU,YAAY;QACpB,kHAAkH;QAClH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;CACF;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE/D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAExE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAAgB,GAAG,SAAS,CAgBlF;AASD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAA6B,GAAG,UAAU,CAAC,KAAK,CAAC,CAgB7F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAWxG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAAgB,GAAG,SAAS,CAMpF"}
+{"version":3,"file":"field-height.d.ts","sourceRoot":"","sources":["../../../src/tokens/field-height.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAYlF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;GAOG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,KAAK;QACb,iHAAiH;QACjH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IACD,UAAU,YAAY;QACpB,kHAAkH;QAClH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;CACF;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE/D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAExE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAQD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAAgB,GAAG,SAAS,CAgBlF;AASD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAA6B,GAAG,UAAU,CAAC,KAAK,CAAC,CAgB7F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAUrF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAExG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,SAAgB,GAAG,SAAS,CAMpF"}

package/dist/types/tokens/scales.d.ts

@@ -14,7 +14,8 @@ export { rem, rems, remPx, resetRootFontCache, sxRem } from './relative';
 export * from './ink';
 export * from './ink.core';
 export { DEFAULT_FIELD_RADIUS, fieldRadius, fieldRadiusOverrides, fieldRadiusPx, fieldRootStyles } from './field-radius';
-export { asFieldSize, DEFAULT_FIELD_HEIGHT, FIELD_BORDER_WIDTH, FIELD_HEIGHT_SCALE, fieldBorder, fieldControlStyles, fieldHeight, fieldHeightOverrides, fieldHeightPx, fieldHeightRem, fieldOverrides, fieldTextFieldStyles, } from './field-height';
+export { asFieldSize, DEFAULT_FIELD_HEIGHT, FIELD_BORDER_WIDTH, FIELD_HEIGHT_SCALE, fieldBorder, fieldControlStyles, fieldHeight, fieldHeightOverrides, fieldHeightPx, fieldHeightRem, fieldOverrides, fieldTextFieldStyles, mergeMuiComponents, } from './field-height';
+export { DEFAULT_DENSITY, DENSITY_FACTOR, densityFieldHeight, densityFontSize, densitySpacingUnit, densityThemeOptions, resolveDensityFactor, useDensity, } from './density';
 export interface Accent {
     main: string;
     light: string;

package/dist/types/tokens/scales.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../src/tokens/scales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,cAAc,CAAC;AAEzD;;;;;GAKG;AACH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEzE,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzH,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAmBjE"}
+{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../src/tokens/scales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,cAAc,CAAC;AAEzD;;;;;GAKG;AACH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEzE,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzH,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAmBjE"}

package/dist/types/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/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/types-native/tokens/density.core.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 declare const DEFAULT_DENSITY: DensityLevel;
+/**
+ * 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 declare const DENSITY_FACTOR: Record<DensityLevel, number>;
+export interface ResolvedDensity {
+    /** Present only when a NAMED level was given; a raw numeric `density` has no name. */
+    level?: DensityLevel;
+    factor: number;
+}
+/**
+ * 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 declare function resolveDensityFactor(density?: DensityLevel | number, factors?: Partial<Record<DensityLevel, number>>): ResolvedDensity;
+/** MUI's own `typography.fontSize` at this factor. `htmlFontSize` is never touched. */
+export declare function densityFontSize(factor: number): number;
+/** The theme's `spacingUnit` at this factor. */
+export declare function densitySpacingUnit(factor: number): number;
+/** The standard field height (multiples of the default font size) at this factor. */
+export declare function densityFieldHeight(factor: number): number;
+//# sourceMappingURL=density.core.d.ts.map

package/dist/types-native/tokens/density.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.core.d.ts","sourceRoot":"","sources":["../../../src/tokens/density.core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEhE,eAAO,MAAM,eAAe,EAAE,YAAuB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIvD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,EAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC9C,eAAe,CASjB;AAMD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/types-native/tokens/field-height.core.d.ts

@@ -33,8 +33,13 @@ export declare const FIELD_HEIGHT_FONT_PX = 16;
  * the roomy ones. All of them stay multiples of the font size.
  */
 export declare const FIELD_HEIGHT_SCALE: Record<SizeValue, number>;
-/** A usable standard height: the given one when it is a positive number, the default otherwise. */
-export declare function resolveFieldHeight(height: unknown): number;
+/**
+ * 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 declare function resolveFieldHeight(height: unknown, fallback?: number): number;
 /** A field's height for a size, in multiples of the default font size (`rem`). */
 export declare function fieldHeightRem(height: number, size?: SizeValue): number;
 /** A field's height for a size in px (dp) — what the native renderer lays out. */

package/dist/types-native/tokens/field-height.core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-height.core.d.ts","sourceRoot":"","sources":["../../../src/tokens/field-height.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMxD,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAI7E;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC"}
+{"version":3,"file":"field-height.core.d.ts","sourceRoot":"","sources":["../../../src/tokens/field-height.core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMxD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAE,MAA6B,GAAG,MAAM,CAEnG;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAI7E;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,SAAgB,GAAG,MAAM,CAE5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC"}

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

@@ -9,5 +9,6 @@ export * from './theme';
 export * from './color';
 export { DEFAULT_FIELD_RADIUS } from './field-radius.core';
 export { DEFAULT_FIELD_HEIGHT, FIELD_BORDER_WIDTH, FIELD_HEIGHT_SCALE, fieldHeightPx, fieldHeightRem, } from './field-height.core';
+export { DEFAULT_DENSITY, DENSITY_FACTOR, densityFieldHeight, densityFontSize, densitySpacingUnit, resolveDensityFactor, } from './density.core';
 export * from './ink.core';
 //# sourceMappingURL=index.native.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../../src/tokens/index.native.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../../src/tokens/index.native.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,cAAc,YAAY,CAAC"}