@uni-design-system/uni-core 7.2.0 → 8.0.0

package/dist/types/concepts/animation/duration.helpers.d.ts

@@ -0,0 +1,25 @@
+/** Duration (seconds) the default theme assigns `expand`'s `transitionSpeed`. */
+export declare const EXPAND_DEFAULT_SPEED = 0.35;
+/**
+ * Content height (px) at which a reveal runs at exactly its `transitionSpeed`.
+ * Roughly a few lines of card content — the size the default 0.35s was tuned on.
+ */
+export declare const EXPAND_REFERENCE_HEIGHT = 240;
+/**
+ * Duration envelope at the default speed. A tiny region never blinks past
+ * faster than the min; a full-page region never drags longer than the max.
+ * Expressed at `EXPAND_DEFAULT_SPEED` and applied as scale-factor clamps, so a
+ * theme that slows `transitionSpeed` down widens its envelope proportionally
+ * instead of being capped back to the stock feel.
+ */
+export declare const EXPAND_MIN_DURATION = 0.15;
+export declare const EXPAND_MAX_DURATION = 0.6;
+/**
+ * Size-aware reveal duration: `speed × √(height ÷ reference)`, clamped.
+ *
+ * A fixed duration reads as sluggish on a short region and rushed on a tall
+ * one; scaling by the square root of height keeps perceived speed steady —
+ * bigger reveals get more time, but sublinearly.
+ */
+export declare const expandDuration: (contentHeight: number, speed?: number) => number;
+//# sourceMappingURL=duration.helpers.d.ts.map

package/dist/types/concepts/animation/duration.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.helpers.d.ts","sourceRoot":"","sources":["../../../../src/concepts/animation/duration.helpers.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAKvC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GACzB,eAAe,MAAM,EACrB,QAAO,MAA6B,KACnC,MAIF,CAAC"}

package/dist/types/concepts/animation/duration.helpers.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=duration.helpers.spec.d.ts.map

package/dist/types/concepts/animation/duration.helpers.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.helpers.spec.d.ts","sourceRoot":"","sources":["../../../../src/concepts/animation/duration.helpers.spec.ts"],"names":[],"mappings":""}

package/dist/types/concepts/animation/index.d.ts

@@ -1,2 +1,3 @@
+export * from './duration.helpers';
 export * from './keyframes.constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/concepts/animation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/concepts/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/concepts/animation/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/types/concepts/component/component.types.d.ts

@@ -1,7 +1,7 @@
 import { Size } from '../size';
 import { Variant } from '../theme';
 import { StyleExpression } from '../style';
-export type ComponentName = 'undefined' | 'alert' | 'appBar' | 'avatar' | 'avatarGroup' | 'badge' | 'breadcrumb' | 'button' | 'buttonGroup' | 'card' | 'cardContent' | 'cardHeader' | 'checkbox' | 'dataSearch' | 'dataTable' | 'dialog' | 'dialogButtons' | 'dialogHeader' | 'drawer' | 'dropdown' | 'footer' | 'iconButton' | 'input' | 'multiSelectDropdown' | 'notificationBadge' | 'paginator' | 'radio' | 'searchInput' | 'select' | 'skeleton' | 'slider' | 'snackbar' | 'stat' | 'symbol' | 'progressBar' | 'progressGauge' | 'tabs' | 'textarea' | 'textButton' | 'toggle' | 'tooltip';
+export type ComponentName = 'undefined' | 'alert' | 'appBar' | 'avatar' | 'avatarGroup' | 'badge' | 'breadcrumb' | 'button' | 'buttonGroup' | 'card' | 'cardContent' | 'cardHeader' | 'checkbox' | 'dataSearch' | 'dataTable' | 'dialog' | 'dialogButtons' | 'dialogHeader' | 'drawer' | 'dropdown' | 'expand' | 'footer' | 'iconButton' | 'input' | 'menu' | 'menuItem' | 'multiSelectDropdown' | 'notificationBadge' | 'paginator' | 'radio' | 'searchInput' | 'select' | 'skeleton' | 'slider' | 'snackbar' | 'stat' | 'symbol' | 'tag' | 'tagInput' | 'progressBar' | 'progressGauge' | 'tabs' | 'textarea' | 'textButton' | 'toggle' | 'tooltip';
 export interface ComponentTheme<T = object> {
     /** Style applied to every instance regardless of variant/size. */
     fixed?: StyleExpression;

package/dist/types/concepts/component/component.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.types.d.ts","sourceRoot":"","sources":["../../../../src/concepts/component/component.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,MAAM,GACN,aAAa,GACb,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,eAAe,GACf,cAAc,GACd,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,qBAAqB,GACrB,mBAAmB,GACnB,WAAW,GACX,OAAO,GACP,aAAa,GACb,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,GACR,aAAa,GACb,eAAe,GACf,MAAM,GACN,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM;IACxC,kEAAkE;IAClE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC"}
+{"version":3,"file":"component.types.d.ts","sourceRoot":"","sources":["../../../../src/concepts/component/component.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,MAAM,GACN,aAAa,GACb,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,eAAe,GACf,cAAc,GACd,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,MAAM,GACN,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,WAAW,GACX,OAAO,GACP,aAAa,GACb,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,GACR,KAAK,GACL,UAAU,GACV,aAAa,GACb,eAAe,GACf,MAAM,GACN,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM;IACxC,kEAAkE;IAClE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC"}

package/dist/types/concepts/generation/theme-file.emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-file.emitter.d.ts","sourceRoot":"","sources":["../../../../src/concepts/generation/theme-file.emitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAwDD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,cAAc,KAAG,gBAsIrD,CAAC"}
+{"version":3,"file":"theme-file.emitter.d.ts","sourceRoot":"","sources":["../../../../src/concepts/generation/theme-file.emitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAwDD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,cAAc,KAAG,gBAoIrD,CAAC"}

package/dist/types/concepts/generation/theme.generator.d.ts

@@ -1,6 +1,6 @@
 import { ColorCategory, ColorScheme } from '../color/color.types';
 import { Radii, UniTheme } from '../theme/theme.model';
-import { GeneratedThemeConfig, GenerationInput, ThemeShape } from './generation.types';
+import { ContrastReport, GeneratedThemeConfig, GenerationInput, ThemeShape } from './generation.types';
 /** Radii presets per shape language (PRD §3.5.A). Same keys as `BaseRadii`. */
 export declare const ShapeRadii: Record<ThemeShape, Radii>;
 /**
@@ -19,12 +19,19 @@ export declare const inferCategory: (seedHex: string) => ColorCategory;
  * Pure and deterministic — identical input yields identical output.
  */
 export declare const generateThemes: (input: GenerationInput) => GeneratedThemeConfig;
+/**
+ * One-line human summary of a {@link ContrastReport}. Shared so the generated
+ * theme file's header and the MCP's theme tools report identical wording.
+ */
+export declare const summarizeContrast: (report: ContrastReport) => string;
 /**
  * Convenience wrapper: {@link generateThemes} piped through `createTheme()`,
- * returning a registration-ready light/dark {@link UniTheme} pair.
+ * returning a registration-ready light/dark {@link UniTheme} pair alongside
+ * the contrast report the colors were audited against.
  */
 export declare const generateUniThemes: (input: GenerationInput) => {
     light: UniTheme;
     dark: UniTheme;
+    report: ContrastReport;
 };
 //# sourceMappingURL=theme.generator.d.ts.map

package/dist/types/concepts/generation/theme.generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.generator.d.ts","sourceRoot":"","sources":["../../../../src/concepts/generation/theme.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAM5D,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EACf,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,CAIhD,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,EAAE,WAAW,MAAM,EAAE,KAAG,WAQxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,aAM/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,eAAe,KAAG,oBAmCvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,eAAe,KAAG;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAoB3F,CAAC"}
+{"version":3,"file":"theme.generator.d.ts","sourceRoot":"","sources":["../../../../src/concepts/generation/theme.generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAM5D,OAAO,KAAK,EAEV,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,UAAU,EACX,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,CAIhD,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,EAAE,WAAW,MAAM,EAAE,KAAG,WAQxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,aAM/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,eAAe,KAAG,oBAmCvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,cAAc,KAAG,MAGvD,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,eAAe,KACrB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAsB3D,CAAC"}

package/dist/types/concepts/style/index.d.ts

@@ -1,3 +1,4 @@
 export * from './style.types';
 export * from './inputs.constants';
+export * from './selectors.constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/concepts/style/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/concepts/style/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/concepts/style/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/types/concepts/style/selectors.constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The highlight state for roving-focus composites (menus, and any other widget
+ * that moves focus programmatically): pointer hover, or focus the user drove
+ * from the keyboard.
+ *
+ * Why not plain `:focus` — a roving-focus composite calls `.focus()` on an item
+ * every time it opens, including pointer opens, and `:focus` would paint that
+ * as a highlight the mouse user never asked for, reading as a preselected
+ * item. `:focus-visible` excludes programmatic focus that follows a click while
+ * still matching keyboard navigation.
+ *
+ * Shared as a constant because Emotion merges styles by **exact selector
+ * text**: a component's base rule and any theme variant restyling that rule
+ * must key both with this value, or the variant silently fails to override and
+ * reintroduces the phantom highlight.
+ */
+export declare const HOVER_OR_KEYBOARD_FOCUS = "&:hover, &:focus-visible";
+//# sourceMappingURL=selectors.constants.d.ts.map

package/dist/types/concepts/style/selectors.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.constants.d.ts","sourceRoot":"","sources":["../../../../src/concepts/style/selectors.constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC"}

package/dist/types/concepts/theme/index.d.ts

@@ -1,6 +1,7 @@
 export * from './theme.model';
 export * from './theme.records';
 export * from './theme.types';
+export * from './theme.validation';
 export * from './themes/base.theme';
 export * from './themes/dark.theme';
 export * from './themes/light.theme';

package/dist/types/concepts/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/concepts/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/concepts/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/types/concepts/theme/theme.types.d.ts

@@ -2,4 +2,11 @@ import { ContentColorToken } from '../color';
 export type themes = 'uni' | 'carbon' | 'material' | 'bootstrap';
 export type Variant = 'ghost' | 'primary' | 'secondary' | 'tertiary' | 'quaternary' | 'warn' | 'success' | 'disabled' | 'light' | 'onLight' | 'dark' | 'onDark';
 export type TextColor = ContentColorToken | Variant;
+/**
+ * A tag's style archetype, orthogonal to its {@link Variant} colour role: the
+ * variant says *which* colour, the tone says *how* it is applied. Themes express
+ * tones as nested `&.tone-*` selectors inside each variant, so both axes stay in
+ * one place.
+ */
+export type TagTone = 'soft' | 'solid' | 'outline';
 //# sourceMappingURL=theme.types.d.ts.map

package/dist/types/concepts/theme/theme.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.types.d.ts","sourceRoot":"","sources":["../../../../src/concepts/theme/theme.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,OAAO,GACf,OAAO,GACP,SAAS,GACT,WAAW,GACX,UAAU,GACV,YAAY,GACZ,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,GACP,SAAS,GACT,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,OAAO,CAAC"}
+{"version":3,"file":"theme.types.d.ts","sourceRoot":"","sources":["../../../../src/concepts/theme/theme.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,OAAO,GACf,OAAO,GACP,SAAS,GACT,WAAW,GACX,UAAU,GACV,YAAY,GACZ,MAAM,GACN,SAAS,GACT,UAAU,GACV,OAAO,GACP,SAAS,GACT,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,OAAO,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/dist/types/concepts/theme/theme.validation.d.ts

@@ -0,0 +1,51 @@
+import { UniTheme } from './theme.model';
+import { TextRole } from '../typography';
+/**
+ * Dependency-free structural validation for {@link UniTheme}.
+ *
+ * Every theme scale is `Partial<Record<…>>`, so a malformed theme — hand
+ * written, generated, or fetched as JSON — renders as silent `undefined` CSS.
+ * `parseTheme` is the acceptance/rejection-with-reasons contract that every
+ * theme write funnels through: the Angular `ThemeService`, the MCP theme
+ * tools, and any future runtime registry all share these rules. It collects
+ * every issue rather than failing fast, so a rejected theme comes back with
+ * the complete repair list.
+ */
+/** One reason a candidate theme was rejected, anchored to a dotted path. */
+export interface ThemeIssue {
+    /** Dotted location, e.g. `colors.primary` or `typography.label.fontSize`. */
+    path: string;
+    message: string;
+}
+export type ThemeParseResult = {
+    success: true;
+    theme: UniTheme;
+    issues: [];
+} | {
+    success: false;
+    theme?: undefined;
+    issues: ThemeIssue[];
+};
+/**
+ * Color tokens components cannot render without: the default variant pairs,
+ * the base surfaces, and the disabled/warn states. Themes may define any
+ * further tokens; these must exist.
+ */
+export declare const REQUIRED_COLOR_TOKENS: readonly ["primary", "on-primary", "primary-container", "on-primary-container", "primary-surface", "on-primary-surface", "surface", "on-surface", "background", "on-background", "warn", "on-warn", "disabled", "on-disabled", "outline", "transparent"];
+/** The canonical type scale; every theme must style each role. */
+export declare const REQUIRED_TEXT_ROLES: readonly TextRole[];
+export declare const REQUIRED_SPACING_SIZES: readonly ["none", "xxs", "xs", "sm", "md", "lg", "xl"];
+export declare const REQUIRED_RADII_SIZES: readonly ["none", "xxs", "xs", "sm", "md", "lg", "max"];
+export declare const REQUIRED_SHADOWS: readonly ["raised", "menu", "dialog", "warn"];
+export declare const REQUIRED_THICKNESSES: readonly ["thin", "standard", "thick"];
+/**
+ * Validate a candidate theme, collecting every structural issue. Never
+ * throws; a failed result carries the complete repair list.
+ */
+export declare const parseTheme: (input: unknown) => ThemeParseResult;
+/** Format issues for logs and error messages. */
+export declare const formatThemeIssues: (issues: ThemeIssue[]) => string;
+/** Validate or throw, with every reason in the error message. */
+export declare const assertTheme: (input: unknown) => UniTheme;
+export declare const isUniTheme: (input: unknown) => input is UniTheme;
+//# sourceMappingURL=theme.validation.d.ts.map

package/dist/types/concepts/theme/theme.validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.validation.d.ts","sourceRoot":"","sources":["../../../../src/concepts/theme/theme.validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;;;;GAUG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,EAAE,CAAA;CAAE,GAC9C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,0PAiBxB,CAAC;AAEX,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,EAAE,SAAS,QAAQ,EAuBzC,CAAC;AAEX,eAAO,MAAM,sBAAsB,wDAAyD,CAAC;AAC7F,eAAO,MAAM,oBAAoB,yDAA0D,CAAC;AAC5F,eAAO,MAAM,gBAAgB,+CAAgD,CAAC;AAC9E,eAAO,MAAM,oBAAoB,wCAAyC,CAAC;AA2G3E;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,gBA0B3C,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,GAAI,QAAQ,UAAU,EAAE,KAAG,MAC8B,CAAC;AAExF,iEAAiE;AACjE,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,QAM5C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,QAAqC,CAAC"}

package/dist/types/concepts/theme/theme.validation.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.validation.spec.d.ts.map

package/dist/types/concepts/theme/theme.validation.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.validation.spec.d.ts","sourceRoot":"","sources":["../../../../src/concepts/theme/theme.validation.spec.ts"],"names":[],"mappings":""}

package/dist/types/concepts/theme/themes/base.theme.d.ts

@@ -30,6 +30,22 @@ export interface ThemeConfig {
     components?: ComponentThemes;
 }
 export declare const createTheme: ({ id, name, colors, icons, radii, shadows, borders, components, }: ThemeConfig) => UniTheme;
+/**
+ * Re-attach the built-in icon set to a theme that traveled without it.
+ *
+ * A serialized theme is ~50 KB, ~71% of which is {@link BaseIcons} — bytes
+ * every uni-core consumer already ships. Transports (MCP tool results, theme
+ * JSON over HTTP) send the {@link dehydrateTheme} form and the receiver
+ * hydrates, applying exactly the `{...BaseIcons, ...icons}` contract
+ * {@link createTheme} applies at construction: the theme's own icons win,
+ * built-ins fill the rest.
+ */
+export declare const hydrateTheme: (theme: UniTheme) => UniTheme;
+/**
+ * The wire form of a theme: icons identical to the built-in set are dropped,
+ * so only genuine overrides travel. Reverse with {@link hydrateTheme}.
+ */
+export declare const dehydrateTheme: (theme: UniTheme) => UniTheme;
 /**
  * Build a full {@link UniTheme} straight from a {@link PaletteConfig} — the
  * one-call path a theme builder uses to turn a brand color (or a seed +

package/dist/types/concepts/theme/themes/base.theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.theme.d.ts","sourceRoot":"","sources":["../../../../../src/concepts/theme/themes/base.theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAI7E,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAK,EACL,OAAO,EAIP,QAAQ,EACT,MAAM,gBAAgB,CAAC;AA0hBxB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAcD,eAAO,MAAM,WAAW,GAAI,mEASzB,WAAW,KAAG,QAYf,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,oBAAoB,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,KAC1F,QAUF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAInF,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAmE,CAAC;AAE9F,eAAO,MAAM,SAAS,EAAE,QAItB,CAAC"}
+{"version":3,"file":"base.theme.d.ts","sourceRoot":"","sources":["../../../../../src/concepts/theme/themes/base.theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAK7E,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACN,KAAK,EACL,KAAK,EACL,OAAO,EAIP,QAAQ,EACT,MAAM,gBAAgB,CAAC;AA+pBxB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAcD,eAAO,MAAM,WAAW,GAAI,mEASzB,WAAW,KAAG,QAYf,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,QAAQ,KAAG,QAG7C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,QAAQ,KAAG,QAK/C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,oBAAoB,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,KAC1F,QAUF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAInF,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAmE,CAAC;AAE9F,eAAO,MAAM,SAAS,EAAE,QAItB,CAAC"}

package/dist/types/concepts/typography/typeface.helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeface.helpers.d.ts","sourceRoot":"","sources":["../../../../src/concepts/typography/typeface.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,SAAS,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAI7E;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,KAAG,kBAQ5C,CAAC;AAEH,eAAO,MAAM,WAAW,GACtB,YAAY,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KACpC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAC8D,CAAC"}
+{"version":3,"file":"typeface.helpers.d.ts","sourceRoot":"","sources":["../../../../src/concepts/typography/typeface.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,SAAS,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAW7E;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,KAAG,kBAQ5C,CAAC;AAEH,eAAO,MAAM,WAAW,GACtB,YAAY,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KACpC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAC8D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uni-design-system/uni-core",
-  "version": "7.2.0",
+  "version": "8.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",