@uni-design-system/uni-mcp 4.6.0 → 4.7.0

package/dist/{chunk-GT3T5DVX.js → chunk-JOMMURY6.js}

@@ -7,16 +7,16 @@ import { z } from "zod";
 // src/data/uni-index.json
 var uni_index_default = {
   meta: {
-    version: "8.0.0",
-    builtAt: "2026-08-11T20:20:04.699Z",
+    version: "8.2.0",
+    builtAt: "2026-08-20T22:58:33.744Z",
     frameworks: [
       "angular"
     ],
     counts: {
-      components: 72,
-      tokens: 331,
+      components: 76,
+      tokens: 353,
       themes: 2,
-      examples: 150
+      examples: 168
     }
   },
   components: [
@@ -27,7 +27,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -98,10 +98,10 @@ var uni_index_default = {
       id: "app-bar",
       name: "AppBar",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Horizontal application bar: project leading controls (menu button, logo) with the `leading` attribute, actions with `trailing` (pushed to the far edge), and either pass `title` or project custom center content.",
+      description: "Horizontal application bar: project leading controls (menu button, logo) with the `leading` attribute, actions with `trailing` (pushed to the far edge), and either pass `title` or project custom center content. Surface, divider, height, typography and spacing all resolve from `appBar` tokens. Place it inside your page's `<header>` landmark.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -155,10 +155,10 @@ var uni_index_default = {
       id: "avatar",
       name: "Avatar",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Identity avatar with a graceful fallback chain: image \u2192 initials from `name` \u2192 themed symbol.",
+      description: "Identity avatar with a graceful fallback chain: image \u2192 initials from `name` \u2192 themed symbol. Coloring, radius, typeface and sizes all resolve from `avatar` theme tokens; `variant` picks the container palette.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -234,10 +234,10 @@ var uni_index_default = {
       id: "avatar-group",
       name: "AvatarGroup",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Overlapping stack of avatars.",
+      description: "Overlapping stack of avatars. `max` collapses the overflow into a themed \u201C+N\u201D chip (itself a `uni-avatar`). Overlap and separator ring resolve from `avatarGroup` theme tokens.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -270,7 +270,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -351,7 +351,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -432,7 +432,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "directives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -453,10 +453,10 @@ var uni_index_default = {
       id: "box",
       name: "Box",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: 'The base layout primitive, applied as an attribute to any element so semantics stay yours: `<main box-layout [grow]="1" padding="md">`.',
+      description: 'The base layout primitive, applied as an attribute to any element so semantics stay yours: `<main box-layout [grow]="1" padding="md">`. Exception: other components\' host elements (`<uni-card box-layout>` would put two components on one element) \u2014 wrap those in a `<div box-layout>`. Sizing convention (height/width/min/max/inset): a **number is px and needs a binding** \u2014 `[height]="420"`; a **plain attribute is a CSS length string** \u2014 `height="420px"`. Spacing/radius/color inputs take theme tokens.',
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -816,10 +816,10 @@ var uni_index_default = {
       id: "breadcrumb",
       name: "Breadcrumb",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: 'WAI-ARIA breadcrumb: a `nav` landmark wrapping an ordered list; the last item is the current page (`aria-current="page"`), separators are decorative.',
+      description: 'WAI-ARIA breadcrumb: a `nav` landmark wrapping an ordered list; the last item is the current page (`aria-current="page"`), separators are decorative. Items with `href` render as real links; without one they render as link-styled buttons emitting `itemClicked` \u2014 wire that to your router.',
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -888,7 +888,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1031,7 +1031,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1056,6 +1056,232 @@ var uni_index_default = {
       },
       relatedTokens: []
     },
+    {
+      id: "calendar",
+      name: "Calendar",
+      status: "stable",
+      summary: "Inline month calendar: single-date or start\u2013end range selection, day markers (availability dots), min/max fences and disabled dates.",
+      description: "Inline month calendar: single-date or start\u2013end range selection, day markers (availability dots), min/max fences and disabled dates. One tab stop with a roving-tabindex `role=\"grid\"`; every day is a real button named with its full date. Values are plain ISO strings (`'YYYY-MM-DD'`), never `Date` objects, so bindings are timezone-free and serializable. Selection and today colours come from the theme's `primary` role pair; geometry and glyphs come from the `calendar` theme entry.",
+      category: "forms",
+      version: "8.2.0",
+      bindings: {
+        angular: {
+          importPath: "@uni-design-system/uni-angular",
+          selectorOrTag: "uni-calendar, Calendar",
+          api: [
+            {
+              name: "value",
+              kind: "model",
+              type: "UniCalendarValue",
+              required: false,
+              description: ""
+            },
+            {
+              name: "disabled",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "touched",
+              kind: "model",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "invalid",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "dirty",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "required",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "ariaDescribedBy",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: ""
+            },
+            {
+              name: "mode",
+              kind: "input",
+              type: "UniCalendarMode",
+              required: false,
+              default: "'single'",
+              description: "`'single'` reads/writes a `UniDate`; `'range'` a `UniDateRange`."
+            },
+            {
+              name: "month",
+              kind: "model",
+              type: "string",
+              required: false,
+              description: "Shown month, `'YYYY-MM'` \u2014 two-way, so an app can drive \"jump to June\"."
+            },
+            {
+              name: "minDate",
+              kind: "input",
+              type: "UniDate",
+              required: false,
+              description: "Earliest selectable date (inclusive)."
+            },
+            {
+              name: "maxDate",
+              kind: "input",
+              type: "UniDate",
+              required: false,
+              description: "Latest selectable date (inclusive)."
+            },
+            {
+              name: "markers",
+              kind: "input",
+              type: "UniCalendarMarker[]",
+              required: false,
+              default: "[]",
+              description: "Availability dots; `label` extends the day's accessible name."
+            },
+            {
+              name: "locale",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "BCP 47 tag; defaults to the document language, then the browser's."
+            },
+            {
+              name: "weekStart",
+              kind: "input",
+              type: "0 | 1 | 2 | 3 | 4 | 5 | 6",
+              required: false,
+              description: "First day of week, 0 = Sunday; defaults from the locale's week info."
+            },
+            {
+              name: "ariaLabel",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "Names the grid when it stands alone (otherwise the heading names it)."
+            },
+            {
+              name: "size",
+              kind: "input",
+              type: "Size",
+              required: false,
+              default: "'md'",
+              description: "Day geometry token; `sm`/`md`/`lg` map to the theme's `calendar` sizes."
+            },
+            {
+              name: "selected",
+              kind: "output",
+              type: "UniDate",
+              required: false,
+              description: "Each committed day, including both ends of a range."
+            }
+          ]
+        }
+      },
+      examples: [
+        {
+          title: "Primary",
+          framework: "angular",
+          code: '<!-- Storybook story: Primary -->\n<uni-calendar size="sm" ariaLabel="Small" month="${MONTH}" />\n<uni-calendar size="md" ariaLabel="Medium" month="${MONTH}" />\n<uni-calendar size="lg" ariaLabel="Large" month="${MONTH}" />\n<!-- args:\n{ value: dayIn(12), month: MONTH }\n-->'
+        },
+        {
+          title: "Range",
+          framework: "angular",
+          code: '<!-- Storybook story: Range -->\n<uni-calendar size="sm" ariaLabel="Small" month="${MONTH}" />\n<uni-calendar size="md" ariaLabel="Medium" month="${MONTH}" />\n<uni-calendar size="lg" ariaLabel="Large" month="${MONTH}" />\n<!-- args:\n{ mode: \'range\', value: { start: dayIn(3), end: dayIn(7) }, month: MONTH }\n-->'
+        },
+        {
+          title: "Markers",
+          framework: "angular",
+          code: `<!-- Storybook story: Markers -->
+<uni-calendar size="sm" ariaLabel="Small" month="\${MONTH}" />
+<uni-calendar size="md" ariaLabel="Medium" month="\${MONTH}" />
+<uni-calendar size="lg" ariaLabel="Large" month="\${MONTH}" />
+<!-- args:
+{
+    month: MONTH,
+    markers: [
+      { date: dayIn(4), variant: 'success', label: '3 slots open' },
+      { date: dayIn(4), variant: 'primary' },
+      { date: dayIn(16), variant: 'warn', label: '1 slot open' },
+      { date: dayIn(24), variant: 'secondary' },
+    ],
+  }
+-->`
+        },
+        {
+          title: "Fenced And Disabled",
+          framework: "angular",
+          code: '<!-- Storybook story: Fenced And Disabled -->\n<uni-calendar size="sm" ariaLabel="Small" month="${MONTH}" />\n<uni-calendar size="md" ariaLabel="Medium" month="${MONTH}" />\n<uni-calendar size="lg" ariaLabel="Large" month="${MONTH}" />\n<!-- args:\n{\n    month: MONTH,\n    minDate: dayIn(5),\n    maxDate: dayIn(25),\n    disabledDates: (date: string) => [0, 6].includes(new Date(`${date}T00:00:00Z`).getUTCDay()),\n  }\n-->'
+        },
+        {
+          title: "Sizes",
+          framework: "angular",
+          code: '<!-- Storybook story: Sizes -->\n<uni-calendar size="sm" ariaLabel="Small" month="${MONTH}" />\n<uni-calendar size="md" ariaLabel="Medium" month="${MONTH}" />\n<uni-calendar size="lg" ariaLabel="Large" month="${MONTH}" />\n<!-- args:\n{ locale: \'de-DE\', weekStart: 1, month: MONTH, value: dayIn(12) }\n-->'
+        },
+        {
+          title: "Locale And Week Start",
+          framework: "angular",
+          code: '<!-- Storybook story: Locale And Week Start -->\n<uni-calendar size="sm" ariaLabel="Small" month="${MONTH}" />\n<uni-calendar size="md" ariaLabel="Medium" month="${MONTH}" />\n<uni-calendar size="lg" ariaLabel="Large" month="${MONTH}" />\n<!-- args:\n{ locale: \'de-DE\', weekStart: 1, month: MONTH, value: dayIn(12) }\n-->'
+        },
+        {
+          title: "Scheduling",
+          framework: "angular",
+          code: '<!-- Storybook story: Scheduling -->\n<uni-calendar size="sm" ariaLabel="Small" month="${MONTH}" />\n<uni-calendar size="md" ariaLabel="Medium" month="${MONTH}" />\n<uni-calendar size="lg" ariaLabel="Large" month="${MONTH}" />'
+        }
+      ],
+      guidelines: {
+        whenToUse: "An inline month calendar \u2014 a form control in its own right, not just the\ninside of a date picker. It selects a single date or a start\u2013end range, marks\ndays with app-driven availability dots, and fences selection with\n`minDate`/`maxDate`/`disabledDates`. Values are plain ISO strings\n(`'2026-08-20'`, `{ start, end }`), never `Date` objects, so bindings are\ntimezone-free, serializable and sortable with `<`.\nReach for it directly when the calendar should stay on screen \u2014 scheduling\npages, availability dashboards, booking flows. For a text field with this\ngrid in a popup, use `uni-date-input`; both render the same component, so it\nis one grid to learn, test and theme.",
+        dos: [
+          "Bind ISO strings: `[value]=\"'2026-08-20'\"` is a complete, correct binding.",
+          "Drive availability through `markers` and `disabledDates` from app data.",
+          "Give a standalone calendar an `ariaLabel` naming the question it answers."
+        ],
+        donts: [
+          "Don't convert to `Date` objects at the edge of the component \u2014 midnight-UTC",
+          "Don't restyle selection colours per instance; retheme the `primary` pair.",
+          "Don't build a popup date field from this yourself \u2014 `uni-date-input`"
+        ],
+        accessibility: [
+          'The month grid is `role="grid"` labelled by the month heading (or',
+          'Every day is a real `<button>` in a `role="gridcell"`, named with its full',
+          "One tab stop: roving `tabindex` inside the grid; \u2190/\u2192 move a day, \u2191/\u2193 a",
+          'Today is `aria-current="date"` with an outline; selection is a fill;',
+          'Selections and range progress announce through one `role="status"` region;',
+          "`aria-invalid` is gated on `invalid && (touched || dirty)`, per the"
+        ]
+      },
+      relatedTokens: [
+        "calendar.behavior.dayBorderRadius",
+        "calendar.behavior.typeface",
+        "calendar.behavior.gap",
+        "calendar.behavior.navPrevSymbol",
+        "calendar.behavior.navNextSymbol",
+        "calendar.behavior.weekdayFormat",
+        "calendar.behavior.showOutsideDays",
+        "calendar.behavior.todayStyle"
+      ]
+    },
     {
       id: "card",
       name: "Card",
@@ -1063,7 +1289,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1108,7 +1334,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1132,7 +1358,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1173,7 +1399,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1228,7 +1454,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1355,7 +1581,9 @@ var uni_index_default = {
       },
       relatedTokens: [
         "checkbox.behavior.size",
-        "checkbox.behavior.boxColor"
+        "checkbox.behavior.boxColor",
+        "checkbox.behavior.borderRadius",
+        "checkbox.behavior.focusRingGap"
       ]
     },
     {
@@ -1365,7 +1593,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1412,7 +1640,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1495,7 +1723,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "data",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1590,179 +1818,344 @@ var uni_index_default = {
       relatedTokens: []
     },
     {
-      id: "debounce-input",
-      name: "DebounceInput",
+      id: "date-input",
+      name: "DateInput",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Date field with free-typed parsing and a popup calendar.",
+      description: "Date field with free-typed parsing and a popup calendar. Type `aug 20`, `8/20/2026` or `2026-08-20`, or pick from the grid \u2014 the form gets the same canonical `'YYYY-MM-DD'` string either way. Parsing is `Intl`-driven (locale digit order and month names, never hardcoded); unreadable text stays in the field, flagged, with a `rejected` event. The popup is a native popover hosting the same `uni-calendar` an app could render inline.",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
-          selectorOrTag: "uni-debounce-input",
+          selectorOrTag: "uni-date-input, DateInput",
           api: [
             {
-              name: "inputName",
+              name: "value",
+              kind: "model",
+              type: "UniDate | undefined",
+              required: false,
+              description: ""
+            },
+            {
+              name: "disabled",
               kind: "input",
-              type: "string",
+              type: "boolean",
               required: false,
+              default: "false",
               description: ""
             },
             {
-              name: "inputId",
+              name: "touched",
+              kind: "model",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "invalid",
               kind: "input",
-              type: "string",
+              type: "boolean",
               required: false,
+              default: "false",
               description: ""
             },
             {
-              name: "debounceTime",
+              name: "dirty",
               kind: "input",
-              type: "number",
+              type: "boolean",
               required: false,
-              default: "400",
+              default: "false",
               description: ""
             },
             {
-              name: "label",
+              name: "required",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "ariaDescribedBy",
               kind: "input",
               type: "string",
               required: false,
-              description: "Accessible name for the input."
+              description: ""
+            },
+            {
+              name: "label",
+              kind: "input",
+              type: "string",
+              required: true,
+              description: 'Accessible name for the field, e.g. "Appointment date".'
             },
             {
               name: "placeholder",
               kind: "input",
               type: "string",
               required: false,
-              default: "''",
+              description: "Defaults to the locale's digit pattern, e.g. `MM/DD/YYYY`."
+            },
+            {
+              name: "displayFormat",
+              kind: "input",
+              type: "Intl.DateTimeFormatOptions",
+              required: false,
+              default: "{ dateStyle: 'medium' }",
+              description: "How the committed value renders, e.g. `{ dateStyle: 'long' }`."
+            },
+            {
+              name: "locale",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "BCP 47 tag; defaults to the document language, then the browser's."
+            },
+            {
+              name: "commitOnBlur",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "true",
               description: ""
             },
             {
-              name: "disabled",
+              name: "embedded",
               kind: "input",
               type: "boolean",
               required: false,
               default: "false",
-              description: ""
+              description: "Renders without its own input-box chrome, for composers like uni-date-time-input."
             },
             {
-              name: "role",
+              name: "minDate",
               kind: "input",
-              type: "string",
+              type: "UniDate",
               required: false,
               description: ""
             },
             {
-              name: "ariaExpanded",
+              name: "maxDate",
               kind: "input",
-              type: "boolean | undefined",
+              type: "UniDate",
               required: false,
-              default: "undefined",
               description: ""
             },
             {
-              name: "ariaControls",
+              name: "markers",
               kind: "input",
-              type: "string",
+              type: "UniCalendarMarker[]",
               required: false,
+              default: "[]",
               description: ""
             },
             {
-              name: "ariaActivedescendant",
+              name: "weekStart",
               kind: "input",
-              type: "string",
+              type: "0 | 1 | 2 | 3 | 4 | 5 | 6",
               required: false,
               description: ""
             },
             {
-              name: "change",
+              name: "opened",
               kind: "output",
-              type: "string",
+              type: "void",
               required: false,
-              description: ""
-            }
-          ]
-        }
-      },
-      examples: [
-        {
-          title: "Primary",
+              description: "Popup shown."
+            },
+            {
+              name: "closed",
+              kind: "output",
+              type: "void",
+              required: false,
+              description: "Popup hidden."
+            },
+            {
+              name: "rejected",
+              kind: "output",
+              type: "UniDateInputRejection",
+              required: false,
+              description: "A typed commit was refused; the raw text stays in the field."
+            }
+          ]
+        }
+      },
+      examples: [
+        {
+          title: "Primary",
           framework: "angular",
-          code: `<!-- Storybook story: Primary -->
-<uni-debounce-input \${argsToTemplate(props)} (change)="lastEmitted = $event" #debounce />
-<div box-layout paddingTop="md">
-  <div>Live value: {{ debounce.value() }}</div>
-  <div>Debounced value: {{ lastEmitted }}</div>
-</div>
-<!-- args:
-{
-    inputName: 'search',
-    debounceTime: 400,
-  }
--->`
+          code: "<!-- Storybook story: Primary -->\n<!-- args:\n{ value: dayIn(12) }\n-->"
+        },
+        {
+          title: "With Calendar Constraints",
+          framework: "angular",
+          code: "<!-- Storybook story: With Calendar Constraints -->\n<!-- args:\n{\n    label: 'Appointment date',\n    minDate: TODAY,\n    maxDate: addDays(TODAY, 45),\n    disabledDates: (date: string) => [0, 6].includes(new Date(`${date}T00:00:00Z`).getUTCDay()),\n    markers: [\n      { date: addDays(TODAY, 1), variant: 'success', label: '3 slots open' },\n      { date: addDays(TODAY, 3), variant: 'primary', label: '1 slot open' },\n    ],\n  }\n-->"
+        },
+        {
+          title: "Display Format",
+          framework: "angular",
+          code: "<!-- Storybook story: Display Format -->\n<!-- args:\n{ value: dayIn(12), displayFormat: { dateStyle: 'full' } }\n-->"
+        },
+        {
+          title: "Disabled",
+          framework: "angular",
+          code: "<!-- Storybook story: Disabled -->\n<!-- args:\n{ value: dayIn(12), disabled: true }\n-->"
         }
       ],
       guidelines: {
-        whenToUse: "A themed text input that emits its `change` output only after the user pauses typing\n(400&nbsp;ms by default) and only when the value actually changed \u2014 a signal-based\ndebounce with no rxjs involved. The live value is exposed as the `value` signal, and\n`clear()` empties the field immediately (cancelling any pending emit).\nIt wears the shared input chrome (color, border, typeface, focus ring) via the input\nbox, and offers `pre-input` / `post-input` attribute slots for adornments plus ARIA\npassthrough inputs (`role`, `ariaExpanded`, `ariaControls`, `ariaActivedescendant`)\nso composite widgets can annotate the real input element.\nUsed by the [Search Input](?path=/docs/components-forms-search-input--search-input), which\nprojects its magnifier and clear button through the slots and drives the combobox\nARIA through the passthroughs.",
-        dos: [],
-        donts: [],
+        whenToUse: "A date field with free-typed parsing and a popup calendar. Type `aug 20`,\n`8/20/2026` or `2026-08-20`, or pick from the grid \u2014 the form gets the same\ncanonical `'YYYY-MM-DD'` string either way. There is no input mask: masks\nfight paste, IMEs and screen-reader echo, and hard-code one digit order in a\nlocale-aware library. Text parses on Enter or blur, then re-renders in\n`displayFormat`.\nThe popup is a native popover hosting the same `uni-calendar` an app could\nrender inline, so fences, disabled days and markers forward untouched. Field\nchrome comes from `uni-input-box` \u2014 error, disabled and focus states stay\nconsistent with every other field.",
+        dos: [
+          "Feed fences and availability (`minDate`, `disabledDates`, `markers`)",
+          "Listen to `(rejected)` when the app should explain a refusal in its own UI."
+        ],
+        donts: [
+          "Don't add an input mask on top; the field is free text by design.",
+          "Don't parse dates yourself before binding \u2014 pass what the user typed and",
+          "Don't use it for a time \u2014 that is `uni-time-input`; for one combined value"
+        ],
         accessibility: [
-          "Set `label` \u2014 it becomes the accessible name (`aria-label`) of the inner input.",
-          "The ARIA passthrough inputs (`role`, `ariaExpanded`, `ariaControls`,"
+          "The text input is a **plain input, not a combobox** \u2014 there is no",
+          'The toggle is a real icon-button named from the value \u2014 *"Choose date"* /',
+          'The popup is a native popover with `role="dialog"`; light-dismiss is the',
+          'Commits, steps and rejections announce through `role="status"` \u2014 the',
+          "A refused draft shows invalid styling and `aria-invalid` immediately (it"
         ]
       },
       relatedTokens: []
     },
     {
-      id: "dialog",
-      name: "Dialog",
+      id: "date-time-input",
+      name: "DateTimeInput",
       status: "stable",
-      summary: "",
-      description: "",
-      category: "feedback",
-      version: "8.0.0",
+      summary: "One field for a date and a time: a thin composer seating a uni-date-input and a uni-time-input in one input-box chrome under one label, yielding one combined `'YYYY-MM-DDTHH:mm'` value.",
+      description: "One field for a date and a time: a thin composer seating a uni-date-input and a uni-time-input in one input-box chrome under one label, yielding one combined `'YYYY-MM-DDTHH:mm'` value. The value emits only when both parts are set \u2014 a time without a day is not an answer \u2014 and clearing the date clears it. With `slotsFor`, the time part stays disabled until a day is chosen and offers exactly that day's slots: the scheduling flow in one attribute. Two honest tab stops (it is two questions); apps needing a different arrangement compose the primitives directly.",
+      category: "forms",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
-          selectorOrTag: "dialog[uni-dialog]",
+          selectorOrTag: "uni-date-time-input, DateTimeInput",
           api: [
             {
-              name: "show",
+              name: "value",
               kind: "model",
+              type: "UniDateTime | undefined",
+              required: false,
+              description: ""
+            },
+            {
+              name: "disabled",
+              kind: "input",
               type: "boolean",
               required: false,
               default: "false",
-              description: "Two-way bindable open state: [(show)]."
+              description: ""
             },
             {
-              name: "ariaLabel",
+              name: "touched",
+              kind: "model",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "invalid",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "dirty",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "required",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "ariaDescribedBy",
               kind: "input",
               type: "string",
               required: false,
-              description: "Accessible name for dialogs without a DialogHeader. When a DialogHeader is present it labels the dialog automatically via aria-labelledby."
+              description: ""
             },
             {
-              name: "initialFocus",
+              name: "label",
               kind: "input",
               type: "string",
+              required: true,
+              description: 'Names the group; the parts are announced as "Date" and "Time" under it.'
+            },
+            {
+              name: "minDateTime",
+              kind: "input",
+              type: "UniDateTime",
               required: false,
-              description: "CSS selector for the element to focus when the dialog opens. Defaults to the browser's native behavior (first focusable element)."
+              description: "Earliest allowed moment; the date and time fences are split from it."
             },
             {
-              name: "defaultCloseButton",
+              name: "maxDateTime",
               kind: "input",
-              type: "boolean",
+              type: "UniDateTime",
+              required: false,
+              description: "Latest allowed moment; the date and time fences are split from it."
+            },
+            {
+              name: "markers",
+              kind: "input",
+              type: "UniCalendarMarker[]",
               required: false,
+              default: "[]",
               description: ""
             },
             {
-              name: "showing",
-              kind: "output",
+              name: "slots",
+              kind: "input",
+              type: "UniTime[]",
+              required: false,
+              description: "Fixed time choices; superseded per-day by `slotsFor` when that is set."
+            },
+            {
+              name: "minuteStep",
+              kind: "input",
+              type: "number",
+              required: false,
+              default: "30",
+              description: ""
+            },
+            {
+              name: "hour12",
+              kind: "input",
               type: "boolean",
               required: false,
-              description: "Emits true once opened and false once the closing animation finishes."
+              description: ""
+            },
+            {
+              name: "weekStart",
+              kind: "input",
+              type: "0 | 1 | 2 | 3 | 4 | 5 | 6",
+              required: false,
+              description: ""
+            },
+            {
+              name: "locale",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: ""
             }
           ]
         }
@@ -1771,124 +2164,337 @@ var uni_index_default = {
         {
           title: "Primary",
           framework: "angular",
-          code: '<!-- Storybook story: Primary -->\n<button text-button (click)="dialog.open()">Open Dialog</button>\n<dialog uni-dialog #dialog>\n  <header uni-dialog-header color="primary">Sample Dialog</header>\n  <div center-layout [width]="300" [height]="200">\n    <span uni-text>Dialog</span>\n  </div>\n  <footer dialog-buttons></footer>\n</dialog>\n<!-- args:\n{}\n-->'
+          code: '<!-- Storybook story: Primary -->\n<uni-date-time-input\n  label="Appointment"\n  [disabledDates]="isFullyBooked"\n  [markers]="markers"\n  [slotsFor]="slotsFor"\n/>\n<!-- args:\n{ value: `${addDays(TODAY, 1)}T15:00` }\n-->'
+        },
+        {
+          title: "Scheduling",
+          framework: "angular",
+          code: '<!-- Storybook story: Scheduling -->\n<uni-date-time-input\n  label="Appointment"\n  [disabledDates]="isFullyBooked"\n  [markers]="markers"\n  [slotsFor]="slotsFor"\n/>\n<!-- args:\n{ value: `${addDays(TODAY, 1)}T15:00`, disabled: true }\n-->'
+        },
+        {
+          title: "Disabled",
+          framework: "angular",
+          code: '<!-- Storybook story: Disabled -->\n<uni-date-time-input\n  label="Appointment"\n  [disabledDates]="isFullyBooked"\n  [markers]="markers"\n  [slotsFor]="slotsFor"\n/>\n<!-- args:\n{ value: `${addDays(TODAY, 1)}T15:00`, disabled: true }\n-->'
         }
       ],
       guidelines: {
-        whenToUse: "Enhanced modal dialog that extends the native HTML `<dialog>` element with built-in animations, composition components, and accessibility features.\n### Features\n- **Native HTML Dialog**: Built on the standard dialog element with full semantic support\n- **Smooth Animations**: Automatic fade transitions for open/close states\n- **Composition Components**: Optional `DialogHeader` and `DialogButtons` for consistent layouts\n- **Programmatic Control**: Open/close methods plus show property binding\n- **Backdrop Handling**: Click-outside-to-close with customizable behavior\n- **Accessibility**: Full keyboard navigation, focus trapping, and screen reader support",
-        dos: [],
-        donts: [],
+        whenToUse: "One field for a date and a time: a thin composer seating a `uni-date-input`\nand a `uni-time-input` in one `uni-input-box` chrome under one label, and\nmapping the two part-values to one combined `'YYYY-MM-DDTHH:mm'` value. The\nvalue emits only when **both** parts are set \u2014 a time without a day is not an\nanswer \u2014 and clearing the date clears it.\nIt is a convenience, not the only door: apps that need a different\narrangement (calendar always inline, slot buttons instead of a time field)\ncompose the primitives directly.",
+        dos: [
+          "Use `slotsFor` for availability-driven scheduling; it gates and supplies",
+          "Treat the combined value as the only form value; the parts are internal."
+        ],
+        donts: [
+          "Don't wire separate date and time form fields through this component \u2014",
+          "Don't expect a value while either part is empty; partial states are"
+        ],
         accessibility: [
-          "Focus trapping and keyboard navigation (Tab, Escape, Enter)",
-          "Screen reader announcements",
-          "Semantic dialog roles"
+          'One `role="group"` named by `label`; the parts are named *"Date"* and',
+          "Tab order: date field \u2192 time field. Two tab stops, honestly \u2014 it *is* two",
+          "Each part keeps its own contract: the date part's popup dialog and status"
         ]
       },
-      relatedTokens: [
-        "dialog.behavior.borderRadius",
-        "dialog.behavior.color",
-        "dialog.behavior.border",
-        "dialog.behavior.padding",
-        "dialog.behavior.elevation",
-        "dialog.behavior.backdrop"
-      ]
+      relatedTokens: []
     },
     {
-      id: "dialog-buttons",
-      name: "DialogButtons",
+      id: "debounce-input",
+      name: "DebounceInput",
       status: "stable",
-      summary: "",
-      description: "",
-      category: "feedback",
-      version: "8.0.0",
+      summary: "Text input that emits `change` only after the user pauses typing.",
+      description: "Text input that emits `change` only after the user pauses typing. Wears the shared input chrome (themed color, border, typeface, focus ring) via `uni-input-box`; project adornments with the `pre-input` / `post-input` slots, matching `uni-input`'s convention. The ARIA passthrough inputs let a wrapping composite (e.g. SearchInput's combobox) annotate the real input element.",
+      category: "forms",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
-          selectorOrTag: "[uni-dialog-buttons], [dialog-buttons]",
+          selectorOrTag: "uni-debounce-input",
           api: [
             {
-              name: "confirmButtonText",
+              name: "inputName",
               kind: "input",
               type: "string",
               required: false,
               description: ""
             },
             {
-              name: "confirmButtonVariant",
+              name: "inputId",
               kind: "input",
-              type: "Variant",
+              type: "string",
               required: false,
               description: ""
             },
             {
-              name: "cancelButtonText",
+              name: "debounceTime",
               kind: "input",
-              type: "string",
+              type: "number",
               required: false,
+              default: "400",
               description: ""
             },
             {
-              name: "cancelButtonVariant",
+              name: "label",
               kind: "input",
-              type: "Variant",
+              type: "string",
               required: false,
+              description: "Accessible name for the input."
+            },
+            {
+              name: "placeholder",
+              kind: "input",
+              type: "string",
+              required: false,
+              default: "''",
               description: ""
             },
             {
-              name: "disableConfirm",
+              name: "disabled",
               kind: "input",
               type: "boolean",
               required: false,
+              default: "false",
               description: ""
             },
             {
-              name: "padding",
+              name: "role",
               kind: "input",
-              type: "NullableSize",
+              type: "string",
               required: false,
               description: ""
             },
             {
-              name: "paddingBottom",
+              name: "ariaExpanded",
               kind: "input",
-              type: "NullableSize",
+              type: "boolean | undefined",
               required: false,
+              default: "undefined",
               description: ""
             },
             {
-              name: "justifyContent",
+              name: "ariaControls",
               kind: "input",
-              type: "JustifyContent",
+              type: "string",
               required: false,
               description: ""
             },
             {
-              name: "confirmed",
+              name: "ariaActivedescendant",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: ""
+            },
+            {
+              name: "change",
               kind: "output",
-              type: "unknown",
+              type: "string",
               required: false,
               description: ""
             }
           ]
         }
       },
-      examples: [],
+      examples: [
+        {
+          title: "Primary",
+          framework: "angular",
+          code: `<!-- Storybook story: Primary -->
+<uni-debounce-input \${argsToTemplate(props)} (change)="lastEmitted = $event" #debounce />
+<div box-layout paddingTop="md">
+  <div>Live value: {{ debounce.value() }}</div>
+  <div>Debounced value: {{ lastEmitted }}</div>
+</div>
+<!-- args:
+{
+    inputName: 'search',
+    debounceTime: 400,
+  }
+-->`
+        }
+      ],
       guidelines: {
-        whenToUse: "",
+        whenToUse: "A themed text input that emits its `change` output only after the user pauses typing\n(400&nbsp;ms by default) and only when the value actually changed \u2014 a signal-based\ndebounce with no rxjs involved. The live value is exposed as the `value` signal, and\n`clear()` empties the field immediately (cancelling any pending emit).\nIt wears the shared input chrome (color, border, typeface, focus ring) via the input\nbox, and offers `pre-input` / `post-input` attribute slots for adornments plus ARIA\npassthrough inputs (`role`, `ariaExpanded`, `ariaControls`, `ariaActivedescendant`)\nso composite widgets can annotate the real input element.\nUsed by the [Search Input](?path=/docs/components-forms-search-input--search-input), which\nprojects its magnifier and clear button through the slots and drives the combobox\nARIA through the passthroughs.",
         dos: [],
         donts: [],
-        accessibility: []
+        accessibility: [
+          "Set `label` \u2014 it becomes the accessible name (`aria-label`) of the inner input.",
+          "The ARIA passthrough inputs (`role`, `ariaExpanded`, `ariaControls`,"
+        ]
       },
       relatedTokens: []
     },
     {
-      id: "dialog-header",
-      name: "DialogHeader",
-      status: "stable",
+      id: "dialog",
+      name: "Dialog",
+      status: "stable",
+      summary: "",
+      description: "",
+      category: "feedback",
+      version: "8.2.0",
+      bindings: {
+        angular: {
+          importPath: "@uni-design-system/uni-angular",
+          selectorOrTag: "dialog[uni-dialog]",
+          api: [
+            {
+              name: "show",
+              kind: "model",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: "Two-way bindable open state: [(show)]."
+            },
+            {
+              name: "ariaLabel",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "Accessible name for dialogs without a DialogHeader. When a DialogHeader is present it labels the dialog automatically via aria-labelledby."
+            },
+            {
+              name: "initialFocus",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "CSS selector for the element to focus when the dialog opens. Defaults to the browser's native behavior (first focusable element)."
+            },
+            {
+              name: "defaultCloseButton",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              description: ""
+            },
+            {
+              name: "showing",
+              kind: "output",
+              type: "boolean",
+              required: false,
+              description: "Emits true once opened and false once the closing animation finishes."
+            }
+          ]
+        }
+      },
+      examples: [
+        {
+          title: "Primary",
+          framework: "angular",
+          code: '<!-- Storybook story: Primary -->\n<button text-button (click)="dialog.open()">Open Dialog</button>\n<dialog uni-dialog #dialog>\n  <header uni-dialog-header color="primary">Sample Dialog</header>\n  <div center-layout [width]="300" [height]="200">\n    <span uni-text>Dialog</span>\n  </div>\n  <footer dialog-buttons></footer>\n</dialog>\n<!-- args:\n{}\n-->'
+        }
+      ],
+      guidelines: {
+        whenToUse: "Enhanced modal dialog that extends the native HTML `<dialog>` element with built-in animations, composition components, and accessibility features.\n### Features\n- **Native HTML Dialog**: Built on the standard dialog element with full semantic support\n- **Smooth Animations**: Automatic fade transitions for open/close states\n- **Composition Components**: Optional `DialogHeader` and `DialogButtons` for consistent layouts\n- **Programmatic Control**: Open/close methods plus show property binding\n- **Backdrop Handling**: Click-outside-to-close with customizable behavior\n- **Accessibility**: Full keyboard navigation, focus trapping, and screen reader support",
+        dos: [],
+        donts: [],
+        accessibility: [
+          "Focus trapping and keyboard navigation (Tab, Escape, Enter)",
+          "Screen reader announcements",
+          "Semantic dialog roles"
+        ]
+      },
+      relatedTokens: [
+        "dialog.behavior.borderRadius",
+        "dialog.behavior.color",
+        "dialog.behavior.border",
+        "dialog.behavior.padding",
+        "dialog.behavior.elevation",
+        "dialog.behavior.backdrop"
+      ]
+    },
+    {
+      id: "dialog-buttons",
+      name: "DialogButtons",
+      status: "stable",
+      summary: "",
+      description: "",
+      category: "feedback",
+      version: "8.2.0",
+      bindings: {
+        angular: {
+          importPath: "@uni-design-system/uni-angular",
+          selectorOrTag: "[uni-dialog-buttons], [dialog-buttons]",
+          api: [
+            {
+              name: "confirmButtonText",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: ""
+            },
+            {
+              name: "confirmButtonVariant",
+              kind: "input",
+              type: "Variant",
+              required: false,
+              description: ""
+            },
+            {
+              name: "cancelButtonText",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: ""
+            },
+            {
+              name: "cancelButtonVariant",
+              kind: "input",
+              type: "Variant",
+              required: false,
+              description: ""
+            },
+            {
+              name: "disableConfirm",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              description: ""
+            },
+            {
+              name: "padding",
+              kind: "input",
+              type: "NullableSize",
+              required: false,
+              description: ""
+            },
+            {
+              name: "paddingBottom",
+              kind: "input",
+              type: "NullableSize",
+              required: false,
+              description: ""
+            },
+            {
+              name: "justifyContent",
+              kind: "input",
+              type: "JustifyContent",
+              required: false,
+              description: ""
+            },
+            {
+              name: "confirmed",
+              kind: "output",
+              type: "unknown",
+              required: false,
+              description: ""
+            }
+          ]
+        }
+      },
+      examples: [],
+      guidelines: {
+        whenToUse: "",
+        dos: [],
+        donts: [],
+        accessibility: []
+      },
+      relatedTokens: []
+    },
+    {
+      id: "dialog-header",
+      name: "DialogHeader",
+      status: "stable",
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1912,7 +2518,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1968,7 +2574,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "directives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -1997,10 +2603,10 @@ var uni_index_default = {
       id: "drawer",
       name: "Drawer",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Navigation drawer with two modes sharing one content slot: - `side` \u2014 an in-flow `<aside>` that pushes content (dashboard sidenav); opening/closing animates its width, and the divider border primitive separates it from the page.",
+      description: "Navigation drawer with two modes sharing one content slot: - `side` \u2014 an in-flow `<aside>` that pushes content (dashboard sidenav); opening/closing animates its width, and the divider border primitive separates it from the page. - `over` \u2014 a native `<dialog>` in the top layer: focus trap, Escape and scrim backdrop come from the platform (same machinery as `uni-dialog`), sliding in from its edge. Surface, width, divider, elevation, padding and backdrop all resolve from `drawer` theme tokens.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2079,7 +2685,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2196,7 +2802,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2284,7 +2890,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2352,10 +2958,10 @@ var uni_index_default = {
       id: "expand-toggle",
       name: "ExpandToggle",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Trigger for a {@link UniExpandComponent} region.",
+      description: "Trigger for a {@link UniExpandComponent} region. Two shapes, chosen by whether `label` is set: - **Icon only** (default) \u2014 the bare chevron, sized for a Card Header. - **Labelled** \u2014 chevron plus a label and optional muted sublabel, as a single full-width button. Most real disclosures need a name for the section, and building that row by hand is the thing this saves; it also makes the label the button's accessible name rather than adjacent text.",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2440,7 +3046,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2598,7 +3204,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2695,7 +3301,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2727,7 +3333,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2787,7 +3393,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -2890,7 +3496,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3013,7 +3619,7 @@ var uni_index_default = {
         ]
       },
       relatedTokens: [
-        "input.behavior.typeFace",
+        "input.behavior.typeface",
         "input.behavior.color",
         "input.behavior.textColor",
         "input.behavior.disabledColor",
@@ -3035,7 +3641,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3108,7 +3714,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3178,7 +3784,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3282,7 +3888,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3364,7 +3970,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3452,7 +4058,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3602,7 +4208,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3846,7 +4452,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3870,7 +4476,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "data",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -3955,7 +4561,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4004,7 +4610,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4068,7 +4674,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4124,7 +4730,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4265,7 +4871,8 @@ var uni_index_default = {
       relatedTokens: [
         "radio.behavior.size",
         "radio.behavior.ringColor",
-        "radio.behavior.fillColor"
+        "radio.behavior.fillColor",
+        "radio.behavior.transitionSpeed"
       ]
     },
     {
@@ -4275,7 +4882,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "directives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4299,7 +4906,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4351,10 +4958,10 @@ var uni_index_default = {
       id: "scroll-area",
       name: "ScrollArea",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Native scroll area with theme-driven scrollbar styling.",
+      description: "Native scroll area with theme-driven scrollbar styling. Scrollbars are styled entirely through Emotion-generated CSS: `::-webkit-scrollbar` rules cover Chromium/Safari, with a `scrollbar-width`/`scrollbar-color` fallback for Firefox.",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4498,10 +5105,10 @@ var uni_index_default = {
       id: "search-input",
       name: "SearchInput",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Generic search field: shared input chrome with a leading magnifier, a clear button while there's a query, Enter to submit, and optional type-ahead \u2014 pass `suggestions` (refresh them from `change`) and the field becomes an ARIA combobox with a keyboard-navigable listbox.",
+      description: "Generic search field: shared input chrome with a leading magnifier, a clear button while there's a query, Enter to submit, and optional type-ahead \u2014 pass `suggestions` (refresh them from `change`) and the field becomes an ARIA combobox with a keyboard-navigable listbox. Escape closes the list first, then clears the query.",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4612,7 +5219,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4745,10 +5352,10 @@ var uni_index_default = {
       id: "skeleton",
       name: "Skeleton",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Loading placeholder painted with surface tokens.",
+      description: "Loading placeholder painted with surface tokens. `text` renders one or more lines (the last line shortened, as real text would be), `rect` and `circle` render fixed shapes. The shimmer only animates when the user allows motion; it degrades to static blocks under `prefers-reduced-motion`.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4841,10 +5448,10 @@ var uni_index_default = {
       id: "slider",
       name: "Slider",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: 'Range slider on a native `<input type="range">` \u2014 keyboard interaction and the ARIA slider contract come from the platform.',
+      description: 'Range slider on a native `<input type="range">` \u2014 keyboard interaction and the ARIA slider contract come from the platform. Fill, track, thumb and radii resolve from `slider` theme tokens; the fill percentage rides a CSS custom property so dragging never regenerates styles.',
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -4981,7 +5588,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5073,7 +5680,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "data",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5132,7 +5739,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5184,10 +5791,10 @@ var uni_index_default = {
       id: "stat",
       name: "Stat",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: 'KPI stat tile: muted label, large value (numbers auto-compact: 48234 \u2192 "48.2K"), an optional delta whose ink is decided by *direction \xD7 whether up is good* (never direction alone \u2014 churn going down is good news), and an optional decorative sparkline.',
+      description: 'KPI stat tile: muted label, large value (numbers auto-compact: 48234 \u2192 "48.2K"), an optional delta whose ink is decided by *direction \xD7 whether up is good* (never direction alone \u2014 churn going down is good news), and an optional decorative sparkline. Frame, typography and inks are all `stat` theme tokens.',
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5289,7 +5896,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5359,10 +5966,10 @@ var uni_index_default = {
       id: "tab",
       name: "Tab",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "One tab inside `uni-tabs`: a label for the tablist plus projected panel content.",
+      description: "One tab inside `uni-tabs`: a label for the tablist plus projected panel content. Content is captured in a template and only instantiated while the tab is selected, so inactive panels cost nothing.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5399,10 +6006,10 @@ var uni_index_default = {
       id: "tabs",
       name: "Tabs",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "WAI-ARIA tabs: roving tabindex, automatic activation (arrow keys move focus and select), Home/End, disabled tabs skipped.",
+      description: "WAI-ARIA tabs: roving tabindex, automatic activation (arrow keys move focus and select), Home/End, disabled tabs skipped. Only the selected panel is instantiated. All styling resolves from `tabs` theme option tokens.",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5463,10 +6070,10 @@ var uni_index_default = {
       id: "tag",
       name: "Tag",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Compact chip for categories, states, filters and tokens.",
+      description: "Compact chip for categories, states, filters and tokens. Two orthogonal style axes: `variant` picks the colour role and `tone` picks the archetype (soft / solid / outline). Both live in the theme's `tag` entry, so a theme restyles every chip in the app without touching markup. Structurally a chip is **body + trailing action as siblings**, never nested buttons: an interactive chip whose body is a `<button>` cannot contain the remove `<button>` (invalid HTML, and the inner control becomes unreachable for keyboard users). Both stay independently operable.",
       category: "data",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -5828,7 +6435,7 @@ var uni_index_default = {
       summary: "",
       description: "",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -6142,10 +6749,10 @@ placeholder="Name or address\u2026"
       id: "text",
       name: "Text",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "The typography primitive, applied as an attribute to any element so semantics stay yours.",
+      description: 'The typography primitive, applied as an attribute to any element so semantics stay yours. The attribute value is the typeface: `<h1 uni-text="display-small">`, `<span uni-text="caption">`, dynamic via `[uni-text]="role()"`. With no value, the typeface is inferred from the host element (h1 \u2192 headline-large, p \u2192 body-1-long, \u2026), falling back to `title-small`; the `typeface` input remains as an explicit override.',
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -6247,7 +6854,7 @@ placeholder="Name or address\u2026"
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -6377,7 +6984,7 @@ placeholder="Name or address\u2026"
       summary: "",
       description: "",
       category: "primitives",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -6404,10 +7011,10 @@ placeholder="Name or address\u2026"
       id: "theme-switch",
       name: "ThemeSwitch",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Drop-in switcher for the themes registered via `UNI_THEMES`: a select over `ThemeService.themeOptions` that applies the choice through `selectTheme` (so it persists across reloads like any other theme selection).",
+      description: "Drop-in switcher for the themes registered via `UNI_THEMES`: a select over `ThemeService.themeOptions` that applies the choice through `selectTheme` (so it persists across reloads like any other theme selection).",
       category: "components",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -6459,24 +7066,23 @@ placeholder="Name or address\u2026"
       relatedTokens: []
     },
     {
-      id: "toggle",
-      name: "Toggle",
+      id: "time-input",
+      name: "TimeInput",
       status: "stable",
-      summary: "",
-      description: "",
+      summary: "Time field: a combobox over time options \u2014 the same listbox contract as uni-search-input and uni-tag-input.",
+      description: "Time field: a combobox over time options \u2014 the same listbox contract as uni-search-input and uni-tag-input. Type `3p`, `930` or `15:00`, or pick `3:00 PM` from the list; the form always gets 24-hour `'HH:mm'` (`hour12` affects display only). The list is assistive, not exhaustive: any parseable time commits, unless `slots` pins the choices (a slot picker) \u2014 then a typed time must match one. Unreadable or unavailable text stays in the field, flagged, with a `rejected` event.",
       category: "forms",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
-          selectorOrTag: "uni-toggle",
+          selectorOrTag: "uni-time-input, TimeInput",
           api: [
             {
-              name: "checked",
+              name: "value",
               kind: "model",
-              type: "boolean",
+              type: "UniTime | undefined",
               required: false,
-              default: "false",
               description: ""
             },
             {
@@ -6517,14 +7123,207 @@ placeholder="Name or address\u2026"
               type: "boolean",
               required: false,
               default: "false",
-              description: "Synced from required() validators by the Signal Forms [field] directive."
+              description: ""
             },
             {
               name: "ariaDescribedBy",
               kind: "input",
               type: "string",
               required: false,
-              description: "Id(s) of external element(s) describing this control \u2014 typically your app-rendered error message \u2014 exposed as aria-describedby."
+              description: ""
+            },
+            {
+              name: "label",
+              kind: "input",
+              type: "string",
+              required: true,
+              description: 'Accessible name for the field, e.g. "Start time".'
+            },
+            {
+              name: "placeholder",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: ""
+            },
+            {
+              name: "minuteStep",
+              kind: "input",
+              type: "number",
+              required: false,
+              default: "30",
+              description: "Generated list granularity, in minutes."
+            },
+            {
+              name: "minTime",
+              kind: "input",
+              type: "UniTime",
+              required: false,
+              description: "Earliest allowed time (inclusive), `'09:00'`."
+            },
+            {
+              name: "maxTime",
+              kind: "input",
+              type: "UniTime",
+              required: false,
+              description: "Latest allowed time (inclusive), `'17:00'`."
+            },
+            {
+              name: "slots",
+              kind: "input",
+              type: "UniTime[]",
+              required: false,
+              description: "Exact allowed times (scheduling). When set, typed entry must match one."
+            },
+            {
+              name: "hour12",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              description: "12-hour display; defaults from the locale. The value stays 24-hour."
+            },
+            {
+              name: "locale",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "BCP 47 tag for the display format; defaults to the document language."
+            },
+            {
+              name: "commitOnBlur",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "true",
+              description: ""
+            },
+            {
+              name: "embedded",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: "Renders without its own input-box chrome, for composers like uni-date-time-input."
+            },
+            {
+              name: "rejected",
+              kind: "output",
+              type: "UniTimeInputRejection",
+              required: false,
+              description: "A typed commit was refused; the raw text stays in the field."
+            }
+          ]
+        }
+      },
+      examples: [
+        {
+          title: "Primary",
+          framework: "angular",
+          code: "<!-- Storybook story: Primary -->\n<!-- args:\n{ minTime: '09:00', maxTime: '17:00', minuteStep: 30, value: '09:30' }\n-->"
+        },
+        {
+          title: "Slots",
+          framework: "angular",
+          code: "<!-- Storybook story: Slots -->\n<!-- args:\n{ label: 'Slot time', slots: ['09:00', '09:30', '11:00', '14:30'] }\n-->"
+        },
+        {
+          title: "Twenty Four Hour",
+          framework: "angular",
+          code: "<!-- Storybook story: Twenty Four Hour -->\n<!-- args:\n{ hour12: false, minTime: '08:00', maxTime: '18:00', value: '15:00' }\n-->"
+        },
+        {
+          title: "Disabled",
+          framework: "angular",
+          code: "<!-- Storybook story: Disabled -->\n<!-- args:\n{ value: '09:30', disabled: true }\n-->"
+        }
+      ],
+      guidelines: {
+        whenToUse: "A time field: a combobox over time options, sharing the exact listbox\ncontract of `uni-search-input` and `uni-tag-input`. Type `3p`, `930` or\n`15:00`, or pick `3:00 PM` from the list \u2014 the form always gets 24-hour\n`'HH:mm'` (`hour12` affects display only). The list is **assistive, not\nexhaustive**: any parseable time commits even if it isn't listed, unless\n`slots` pins the choices.\nTyped shorthand does what an appointment field should: `9` \u2192 09:00,\n`930` \u2192 09:30, `3p` \u2192 15:00, and a bare `3` leans PM in a 12-hour field \u2014\ntyping 3 into an appointment field means 15:00, not 03:00 (the bias yields\nif `minTime`/`maxTime` say otherwise). Unreadable or unavailable text stays\nin the field, flagged, with a `(rejected)` event.",
+        dos: [
+          "Pin `slots` for scheduling; leave them off for free time entry fenced by",
+          "Keep values 24-hour everywhere in app state; let `hour12` handle display."
+        ],
+        donts: [
+          'Don\'t use `<input type="time">` alongside it \u2014 the platform control brings',
+          "Don't filter the option list as the user types; the list is a picker, not"
+        ],
+        accessibility: [
+          'The input is `role="combobox"` with `aria-expanded`, `aria-controls` and',
+          'Options are named in the display format (*"3:00 PM"*); the committed one',
+          'Commits and rejections announce through `role="status"`.',
+          "Typing never selects an option \u2014 Enter commits the draft, not whatever",
+          "`aria-invalid` is gated on `invalid && (touched || dirty)`; a refused"
+        ]
+      },
+      relatedTokens: []
+    },
+    {
+      id: "toggle",
+      name: "Toggle",
+      status: "stable",
+      summary: "",
+      description: "",
+      category: "forms",
+      version: "8.2.0",
+      bindings: {
+        angular: {
+          importPath: "@uni-design-system/uni-angular",
+          selectorOrTag: "uni-toggle",
+          api: [
+            {
+              name: "checked",
+              kind: "model",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "disabled",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "touched",
+              kind: "model",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "invalid",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "dirty",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: ""
+            },
+            {
+              name: "required",
+              kind: "input",
+              type: "boolean",
+              required: false,
+              default: "false",
+              description: "Synced from required() validators by the Signal Forms [field] directive."
+            },
+            {
+              name: "ariaDescribedBy",
+              kind: "input",
+              type: "string",
+              required: false,
+              description: "Id(s) of external element(s) describing this control \u2014 typically your app-rendered error message \u2014 exposed as aria-describedby."
             },
             {
               name: "label",
@@ -6595,7 +7394,7 @@ placeholder="Name or address\u2026"
       summary: "",
       description: "",
       category: "feedback",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -6674,7 +7473,7 @@ placeholder="Name or address\u2026"
       summary: "",
       description: "",
       category: "layout",
-      version: "8.0.0",
+      version: "8.2.0",
       bindings: {
         angular: {
           importPath: "@uni-design-system/uni-angular",
@@ -8588,6 +9387,30 @@ placeholder="Name or address\u2026"
         DarkTheme: "surface"
       }
     },
+    {
+      id: "checkbox.behavior.borderRadius",
+      value: 2,
+      type: "number",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "checkbox",
+      themeValues: {
+        LightTheme: 2,
+        DarkTheme: 2
+      }
+    },
+    {
+      id: "checkbox.behavior.focusRingGap",
+      value: 2,
+      type: "number",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "checkbox",
+      themeValues: {
+        LightTheme: 2,
+        DarkTheme: 2
+      }
+    },
     {
       id: "radio.behavior.size",
       value: 20,
@@ -8624,6 +9447,18 @@ placeholder="Name or address\u2026"
         DarkTheme: "surface"
       }
     },
+    {
+      id: "radio.behavior.transitionSpeed",
+      value: 0.3,
+      type: "number",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "radio",
+      themeValues: {
+        LightTheme: 0.3,
+        DarkTheme: 0.3
+      }
+    },
     {
       id: "dialog.behavior.borderRadius",
       value: "lg",
@@ -9153,7 +9988,7 @@ placeholder="Name or address\u2026"
       }
     },
     {
-      id: "input.behavior.typeFace",
+      id: "input.behavior.typeface",
       value: "input",
       type: "string",
       kind: "behavioral",
@@ -9681,224 +10516,452 @@ placeholder="Name or address\u2026"
       }
     },
     {
-      id: "button.behavior.borderRadius",
+      id: "calendar.behavior.dayBorderRadius",
       value: "max",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "button",
+      appliesTo: "calendar",
       themeValues: {
         LightTheme: "max",
         DarkTheme: "max"
       }
     },
     {
-      id: "button.behavior.typeface",
-      value: "button",
+      id: "calendar.behavior.typeface",
+      value: "label",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "button",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "button",
-        DarkTheme: "button"
+        LightTheme: "label",
+        DarkTheme: "label"
       }
     },
     {
-      id: "iconButton.behavior.borderRadius",
-      value: "max",
+      id: "calendar.behavior.gap",
+      value: "xxs",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "iconButton",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "max",
-        DarkTheme: "max"
+        LightTheme: "xxs",
+        DarkTheme: "xxs"
       }
     },
     {
-      id: "card.behavior.borderRadius",
-      value: "xs",
+      id: "calendar.behavior.navPrevSymbol",
+      value: "chevron_left",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "card",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "xs",
-        DarkTheme: "xs"
+        LightTheme: "chevron_left",
+        DarkTheme: "chevron_left"
       }
     },
     {
-      id: "dataSearch.behavior.border",
-      value: "light",
+      id: "calendar.behavior.navNextSymbol",
+      value: "chevron_right",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataSearch",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "light",
-        DarkTheme: "light"
+        LightTheme: "chevron_right",
+        DarkTheme: "chevron_right"
       }
     },
     {
-      id: "dataSearch.behavior.borderRadius",
-      value: "xs",
+      id: "calendar.behavior.weekdayFormat",
+      value: "short",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataSearch",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "xs",
-        DarkTheme: "xs"
+        LightTheme: "short",
+        DarkTheme: "short"
       }
     },
     {
-      id: "dataSearch.behavior.color",
-      value: "primary-surface",
-      type: "string",
+      id: "calendar.behavior.showOutsideDays",
+      value: false,
+      type: "boolean",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataSearch",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "primary-surface",
-        DarkTheme: "primary-surface"
+        LightTheme: false,
+        DarkTheme: false
       }
     },
     {
-      id: "dataSearch.behavior.placeholderColor",
-      value: "disabled",
+      id: "calendar.behavior.todayStyle",
+      value: "outline",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataSearch",
+      appliesTo: "calendar",
       themeValues: {
-        LightTheme: "disabled",
-        DarkTheme: "disabled"
+        LightTheme: "outline",
+        DarkTheme: "outline"
       }
     },
     {
-      id: "dataTable.behavior.color",
-      value: "primary-surface",
+      id: "dateInput.behavior.toggleSymbol",
+      value: "calendar_month",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "dateInput",
       themeValues: {
-        LightTheme: "primary-surface",
-        DarkTheme: "primary-surface"
+        LightTheme: "calendar_month",
+        DarkTheme: "calendar_month"
       }
     },
     {
-      id: "dataTable.behavior.border",
-      value: "light",
+      id: "dateInput.behavior.popupShadow",
+      value: "menu",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "dateInput",
       themeValues: {
-        LightTheme: "light",
-        DarkTheme: "light"
+        LightTheme: "menu",
+        DarkTheme: "menu"
       }
     },
     {
-      id: "dataTable.behavior.borderRadius",
-      value: "sm",
+      id: "dateInput.behavior.popupBorderRadius",
+      value: "xs",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "dateInput",
       themeValues: {
-        LightTheme: "sm",
-        DarkTheme: "sm"
+        LightTheme: "xs",
+        DarkTheme: "xs"
       }
     },
     {
-      id: "dataTable.behavior.headerPadding",
-      value: "sm",
+      id: "dateInput.behavior.popupColor",
+      value: "primary-surface",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "dateInput",
       themeValues: {
-        LightTheme: "sm",
-        DarkTheme: "sm"
+        LightTheme: "primary-surface",
+        DarkTheme: "primary-surface"
       }
     },
     {
-      id: "dataTable.behavior.footerPadding",
-      value: "sm",
+      id: "timeInput.behavior.toggleSymbol",
+      value: "schedule",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "timeInput",
       themeValues: {
-        LightTheme: "sm",
-        DarkTheme: "sm"
+        LightTheme: "schedule",
+        DarkTheme: "schedule"
       }
     },
     {
-      id: "dataTable.behavior.thTextRole",
-      value: "headline-small",
+      id: "timeInput.behavior.listColor",
+      value: "primary-surface",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "timeInput",
       themeValues: {
-        LightTheme: "headline-small",
-        DarkTheme: "headline-small"
+        LightTheme: "primary-surface",
+        DarkTheme: "primary-surface"
       }
     },
     {
-      id: "dataTable.behavior.thColor",
-      value: "primary-container",
+      id: "timeInput.behavior.listShadow",
+      value: "menu",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "timeInput",
       themeValues: {
-        LightTheme: "primary-container",
-        DarkTheme: "primary-container"
+        LightTheme: "menu",
+        DarkTheme: "menu"
       }
     },
     {
-      id: "dataTable.behavior.thVerticalBorder",
-      value: "dotted",
+      id: "timeInput.behavior.listBorderRadius",
+      value: "xs",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "timeInput",
       themeValues: {
-        LightTheme: "dotted",
-        DarkTheme: "dotted"
+        LightTheme: "xs",
+        DarkTheme: "xs"
       }
     },
     {
-      id: "dataTable.behavior.thHorizontalBorder",
-      value: "light",
-      type: "string",
+      id: "timeInput.behavior.maxVisibleOptions",
+      value: 7,
+      type: "number",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "timeInput",
       themeValues: {
-        LightTheme: "light",
-        DarkTheme: "light"
+        LightTheme: 7,
+        DarkTheme: 7
       }
     },
     {
-      id: "dataTable.behavior.thPadding",
+      id: "dateTimeInput.behavior.partGap",
       value: "sm",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
-      appliesTo: "dataTable",
+      appliesTo: "dateTimeInput",
       themeValues: {
         LightTheme: "sm",
         DarkTheme: "sm"
       }
     },
     {
-      id: "dataTable.behavior.tdTextRole",
-      value: "title-small",
+      id: "dateTimeInput.behavior.dividerColor",
+      value: "outline",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dateTimeInput",
+      themeValues: {
+        LightTheme: "outline",
+        DarkTheme: "outline"
+      }
+    },
+    {
+      id: "button.behavior.borderRadius",
+      value: "max",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "button",
+      themeValues: {
+        LightTheme: "max",
+        DarkTheme: "max"
+      }
+    },
+    {
+      id: "button.behavior.typeface",
+      value: "button",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "button",
+      themeValues: {
+        LightTheme: "button",
+        DarkTheme: "button"
+      }
+    },
+    {
+      id: "iconButton.behavior.borderRadius",
+      value: "max",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "iconButton",
+      themeValues: {
+        LightTheme: "max",
+        DarkTheme: "max"
+      }
+    },
+    {
+      id: "card.behavior.borderRadius",
+      value: "xs",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "card",
+      themeValues: {
+        LightTheme: "xs",
+        DarkTheme: "xs"
+      }
+    },
+    {
+      id: "dataSearch.behavior.border",
+      value: "light",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataSearch",
+      themeValues: {
+        LightTheme: "light",
+        DarkTheme: "light"
+      }
+    },
+    {
+      id: "dataSearch.behavior.borderRadius",
+      value: "xs",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataSearch",
+      themeValues: {
+        LightTheme: "xs",
+        DarkTheme: "xs"
+      }
+    },
+    {
+      id: "dataSearch.behavior.color",
+      value: "primary-surface",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataSearch",
+      themeValues: {
+        LightTheme: "primary-surface",
+        DarkTheme: "primary-surface"
+      }
+    },
+    {
+      id: "dataSearch.behavior.placeholderColor",
+      value: "disabled",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataSearch",
+      themeValues: {
+        LightTheme: "disabled",
+        DarkTheme: "disabled"
+      }
+    },
+    {
+      id: "dataTable.behavior.color",
+      value: "primary-surface",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "primary-surface",
+        DarkTheme: "primary-surface"
+      }
+    },
+    {
+      id: "dataTable.behavior.border",
+      value: "light",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "light",
+        DarkTheme: "light"
+      }
+    },
+    {
+      id: "dataTable.behavior.borderRadius",
+      value: "sm",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "sm",
+        DarkTheme: "sm"
+      }
+    },
+    {
+      id: "dataTable.behavior.headerPadding",
+      value: "sm",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "sm",
+        DarkTheme: "sm"
+      }
+    },
+    {
+      id: "dataTable.behavior.footerPadding",
+      value: "sm",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "sm",
+        DarkTheme: "sm"
+      }
+    },
+    {
+      id: "dataTable.behavior.thTextRole",
+      value: "headline-small",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "headline-small",
+        DarkTheme: "headline-small"
+      }
+    },
+    {
+      id: "dataTable.behavior.thColor",
+      value: "primary-container",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "primary-container",
+        DarkTheme: "primary-container"
+      }
+    },
+    {
+      id: "dataTable.behavior.thVerticalBorder",
+      value: "dotted",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "dotted",
+        DarkTheme: "dotted"
+      }
+    },
+    {
+      id: "dataTable.behavior.thHorizontalBorder",
+      value: "light",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "light",
+        DarkTheme: "light"
+      }
+    },
+    {
+      id: "dataTable.behavior.thPadding",
+      value: "sm",
+      type: "string",
+      kind: "behavioral",
+      target: "component-prop",
+      appliesTo: "dataTable",
+      themeValues: {
+        LightTheme: "sm",
+        DarkTheme: "sm"
+      }
+    },
+    {
+      id: "dataTable.behavior.tdTextRole",
+      value: "title-small",
       type: "string",
       kind: "behavioral",
       target: "component-prop",
@@ -10746,12 +11809,15 @@ placeholder="Name or address\u2026"
         },
         checkbox: {
           size: 20,
-          boxColor: "surface"
+          boxColor: "surface",
+          borderRadius: 2,
+          focusRingGap: 2
         },
         radio: {
           size: 20,
           ringColor: "outline",
-          fillColor: "surface"
+          fillColor: "surface",
+          transitionSpeed: 0.3
         },
         dialog: {
           borderRadius: "lg",
@@ -10814,7 +11880,7 @@ placeholder="Name or address\u2026"
           logoPadding: "md"
         },
         input: {
-          typeFace: "input",
+          typeface: "input",
           color: "primary-surface",
           textColor: "on-primary-surface",
           disabledColor: "disabled-surface",
@@ -10871,6 +11937,33 @@ placeholder="Name or address\u2026"
           listBorderRadius: "xs",
           maxSuggestions: 8
         },
+        calendar: {
+          dayBorderRadius: "max",
+          typeface: "label",
+          gap: "xxs",
+          navPrevSymbol: "chevron_left",
+          navNextSymbol: "chevron_right",
+          weekdayFormat: "short",
+          showOutsideDays: false,
+          todayStyle: "outline"
+        },
+        dateInput: {
+          toggleSymbol: "calendar_month",
+          popupShadow: "menu",
+          popupBorderRadius: "xs",
+          popupColor: "primary-surface"
+        },
+        timeInput: {
+          toggleSymbol: "schedule",
+          listColor: "primary-surface",
+          listShadow: "menu",
+          listBorderRadius: "xs",
+          maxVisibleOptions: 7
+        },
+        dateTimeInput: {
+          partGap: "sm",
+          dividerColor: "outline"
+        },
         button: {
           borderRadius: "max",
           typeface: "button"
@@ -11163,12 +12256,15 @@ placeholder="Name or address\u2026"
         },
         checkbox: {
           size: 20,
-          boxColor: "surface"
+          boxColor: "surface",
+          borderRadius: 2,
+          focusRingGap: 2
         },
         radio: {
           size: 20,
           ringColor: "outline",
-          fillColor: "surface"
+          fillColor: "surface",
+          transitionSpeed: 0.3
         },
         dialog: {
           borderRadius: "lg",
@@ -11231,7 +12327,7 @@ placeholder="Name or address\u2026"
           logoPadding: "md"
         },
         input: {
-          typeFace: "input",
+          typeface: "input",
           color: "primary-surface",
           textColor: "on-primary-surface",
           disabledColor: "disabled-surface",
@@ -11269,128 +12365,1309 @@ placeholder="Name or address\u2026"
           focusOutline: "2px solid #AFB5D8",
           focusOutlineOffset: 2
         },
-        badge: {
-          borderRadius: "xxs"
+        badge: {
+          borderRadius: "xxs"
+        },
+        tag: {
+          borderRadius: "max",
+          typeface: "tag",
+          gap: "xs",
+          removeIcon: "close",
+          selectedIcon: "check"
+        },
+        tagInput: {
+          chipGap: "xs",
+          chipSize: "md",
+          minInputWidth: "12ch",
+          listColor: "primary-surface",
+          listShadow: "menu",
+          listBorderRadius: "xs",
+          maxSuggestions: 8
+        },
+        calendar: {
+          dayBorderRadius: "max",
+          typeface: "label",
+          gap: "xxs",
+          navPrevSymbol: "chevron_left",
+          navNextSymbol: "chevron_right",
+          weekdayFormat: "short",
+          showOutsideDays: false,
+          todayStyle: "outline"
+        },
+        dateInput: {
+          toggleSymbol: "calendar_month",
+          popupShadow: "menu",
+          popupBorderRadius: "xs",
+          popupColor: "primary-surface"
+        },
+        timeInput: {
+          toggleSymbol: "schedule",
+          listColor: "primary-surface",
+          listShadow: "menu",
+          listBorderRadius: "xs",
+          maxVisibleOptions: 7
+        },
+        dateTimeInput: {
+          partGap: "sm",
+          dividerColor: "outline"
+        },
+        button: {
+          borderRadius: "max",
+          typeface: "button"
+        },
+        iconButton: {
+          borderRadius: "max"
+        },
+        card: {
+          borderRadius: "xs"
+        },
+        dataSearch: {
+          border: "light",
+          borderRadius: "xs",
+          color: "primary-surface",
+          placeholderColor: "disabled"
+        },
+        dataTable: {
+          color: "primary-surface",
+          border: "light",
+          borderRadius: "sm",
+          headerPadding: "sm",
+          footerPadding: "sm",
+          thTextRole: "headline-small",
+          thColor: "primary-container",
+          thVerticalBorder: "dotted",
+          thHorizontalBorder: "light",
+          thPadding: "sm",
+          tdTextRole: "title-small",
+          tdColor: "primary-surface",
+          tdStickyColor: "primary-container",
+          tdPadding: "sm",
+          tdVerticalBorder: "dotted",
+          tdHorizontalBorder: "light",
+          rowHoverColor: "primary-container",
+          loadingOverlayColor: "scrim",
+          loadingSpinnerColor: "primary",
+          loadingSpinnerSize: 40
+        },
+        notificationBadge: {
+          borderRadius: "sm",
+          offset: -10
+        },
+        paginator: {
+          gap: "xs",
+          textRole: "label",
+          inputBorder: "light",
+          inputBorderRadius: "xs",
+          pageBorderRadius: "xs",
+          currentPageBorder: "light",
+          currentPageBorderRadius: "xs"
+        },
+        stat: {
+          labelTypeface: "label",
+          valueTypeface: "stat",
+          color: "surface",
+          border: "light",
+          borderRadius: "xs",
+          positiveColor: "success",
+          negativeColor: "error",
+          trendColor: "outline",
+          trendAccent: "primary",
+          padding: "md",
+          gap: "xxs"
+        },
+        slider: {
+          color: "primary",
+          trackColor: "surface-variant",
+          borderRadius: "max",
+          trackHeight: 4,
+          thumbSize: 16
+        },
+        skeleton: {
+          color: "surface-variant",
+          highlightColor: "surface",
+          borderRadius: "xs",
+          animation: "shimmer",
+          duration: 1.4,
+          gap: "sm"
+        },
+        snackbar: {
+          bottomPosition: 40,
+          transitionDelay: "0.35s",
+          autoCloseDelay: 35e3
+        },
+        symbol: {
+          fill: 0,
+          weight: 400,
+          grade: 0,
+          opticalSize: 24
+        },
+        toggle: {
+          size: 20,
+          trackColor: "surface-variant",
+          knobColor: "surface"
+        },
+        tooltip: {
+          borderRadius: "xs",
+          shadow: "raised",
+          color: "inverse-surface",
+          typeface: "label"
+        }
+      },
+      usage: "Apply style overrides through the Emotion theme provider (the `UniTheme` object), and pass component options as component inputs/props. Import the theme from `@uni-design-system/uni-core` (`DarkTheme`)."
+    }
+  ],
+  changelogs: [
+    {
+      package: "@uni-design-system/uni-angular",
+      releases: [
+        {
+          version: "8.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Input options: `typeFace` \u2192 `typeface`, matching the tooltip/button/tabs casing. The base theme now writes `typeface`, and the input box reads the new key with the old one as a deprecated fallback, so themes that still set `typeFace` render unchanged. The `typeFace` key is deprecated and will be removed in the next major.",
+              body: "",
+              commit: "57a8c4c"
+            },
+            {
+              bump: "minor",
+              title: "`uni-select`: `compareWith` input for object values.",
+              body: "The select matched `value` against option values with `===`, so an object value that was structurally but not referentially equal \u2014 a saved record matched against options from a fresh fetch \u2014 never matched, and the native select silently rendered the first option (or the placeholder) instead of the preselection. The new `compareWith` input, called as `compareWith(optionValue, value)` and defaulting to reference equality, lets object-valued selects pass a key comparison like `(a, b) => a?.id === b?.id`. Primitive values were and remain unaffected.",
+              commit: "96113ee"
+            },
+            {
+              bump: "patch",
+              title: "`uni-notification-badge`: a theme that omits the `offset` option no longer breaks badge positioning \u2014 the position values serialized as the invalid length `'undefinedpx'` and the badge lost its corner placement. Missing `offset` now falls back to `0`.",
+              body: "",
+              commit: "57a8c4c"
+            },
+            {
+              bump: "patch",
+              title: "`uni-calendar` / `uni-date-input`: a bound `''` now counts as \"no value\".",
+              body: "An empty string \u2014 the only typeable empty for a string-typed model, and the natural \"no value yet\" in consumer code \u2014 slipped past the month path's nullish (`??`) guards into the grid math: `viewMonth` became `''`, the month heading threw `RangeError: Invalid time value` from `Intl.format` on every change-detection pass, and the grid rendered zero weeks. This hit on first render (the popup content projects eagerly), not just on open. The guards are now falsy, matching how `displayText`, `splitDateTime`, and the rest of the datetime path already treat `''`, so a calendar or date-input bound to `''` renders the current month exactly like `undefined`. `uni-time-input` and `uni-date-time-input` were already safe. Consumers no longer need to normalize `''` to `undefined` before binding \u2014 and note the `value` models were always typed `UniDate | undefined`, so no `$any()` cast is needed for a `string | undefined` draft signal.",
+              commit: "92e5d5e"
+            },
+            {
+              bump: "patch",
+              title: "Ship `CHANGELOG.md` in the published packages. The release notes existed only in the repo; an installed package carried no record of what changed, so upgrade questions couldn't be answered from `node_modules`. uni-angular copies it into the ng-packagr `dist` via `assets`; the rest add it to `files`.",
+              body: "",
+              commit: "e706e38"
+            },
+            {
+              bump: "patch",
+              title: "`uni-menu`, `uni-multi-select`, `uni-data-table`: stop tracking loop collections by identity (NG0956).",
+              body: '`uni-menu` items, `uni-multi-select` options, and `uni-data-table` records tracked by object identity, so a consumer rebuilding the array each change-detection pass \u2014 the natural way to write `[menuItems]="[...]"` or re-fetch table rows \u2014 recreated every DOM node and tripped NG0956. They now track by `$index` (none of these collections carries a stable key: menu items may be templates or dividers, option values may be objects, records are arbitrary), and data-table columns track by their unique `columnDef`. Consumers no longer need to memoize a stable array; DOM nodes \u2014 including a focused menu item \u2014 survive a rebuild.',
+              commit: "96113ee"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "8.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Calendar, date & time entry: `uni-calendar`, `uni-date-input`, `uni-time-input` and `uni-date-time-input`, plus a pure datetime helper layer in the cdk.",
+              body: "The most-requested form control family anywhere, built native-platform-first with zero runtime dependencies: `Intl` does all formatting and parsing (no date library), the popup rides the native popover top layer with CSS anchor positioning, and every day in the grid is a real `<button>`.\n- **Values are plain ISO strings, never `Date`s** \u2014 `UniDate` (`'YYYY-MM-DD'`), `UniTime` (`'HH:mm'`, always 24-hour), `UniDateTime` (`'YYYY-MM-DDTHH:mm'`), `UniDateRange` (`{ start, end }`). A `Date` is a timestamp with a timezone problem; a calendar date is a label on a wall calendar. Strings are timezone-free, JSON-serializable and sortable with `<`, and `[value]=\"'2026-08-20'\"` is a complete, correct binding.\n- **`uni-calendar`** is an inline month grid and a form control in its own right: single and range modes in one component (the value shape switches with `mode`), availability **markers** with screen-reader labels, `minDate`/`maxDate` fences, `disabledDates` as a list or predicate, and a two-way `month` model so an app can drive \"jump to June\". One tab stop with a roving-tabindex `role=\"grid\"`; the full APG keyboard map (arrows, week `Home`/`End`, `PageUp`/`PageDown` with `Shift` for years) crosses month edges, skips disabled days directionally, and stops at fences without wrapping. Range selection paints a live preview band, swaps a backwards commit instead of erroring, and narrates every step through a `role=\"status\"` region.\n- **`uni-date-input`** is free-typed date entry \u2014 no input mask (masks fight paste, IMEs and screen-reader echo). The parser accepts ISO, locale-numeric text with the digit order read from `Intl.DateTimeFormat(locale).formatToParts()`, and the locale's own month names; a missing year resolves to the next occurrence and two-digit years are refused rather than guessed. Unreadable, fenced or unavailable text **stays in the field**, flagged, with a `rejected` event. The popup is the same `uni-calendar`, hosted in a `role=\"dialog\"` popover via the shared `uni-dropdown`; `\u2191`/`\u2193` on a committed value step \xB11 day.\n- **`uni-time-input`** is a combobox over time slots \u2014 byte-for-byte the search-input/tag-input listbox contract via the CDK's `ListboxNavigation`. `9` \u2192 09:00, `930` \u2192 09:30, `3p` \u2192 15:00, and a bare `3` leans PM in a 12-hour field (the bias yields when `minTime`/`maxTime` say otherwise). `slots` pins the choices for scheduling, refusing a typed `5pm` as `'unavailable'`; `\u2191`/`\u2193` on a committed value step \xB1`minuteStep`.\n- **`uni-date-time-input`** seats both parts in one `uni-input-box` chrome under one `role=\"group\"` label, emitting one combined value only when both parts are set. `slotsFor` is the scheduling flow in one attribute: the time part stays disabled until a day is chosen, then offers exactly that day's slots, and changing the day clears a slot that no longer exists. The parts gained an `embedded` input so the composer renders one shared box instead of nested chrome.\n- **cdk `datetime` module** (public export): the string-math and `Intl` layer \u2014 `addDays`/`addMonths`/`buildMonthGrid`/`parseDateText`/`parseTimeText`/`timeSlots`/`localeWeekStart` and friends \u2014 pure functions, unit-tested hard, usable by apps directly.\n- **uni-core**: `'calendar'`, `'dateInput'`, `'timeInput'`, `'dateTimeInput'` join `ComponentName` with base-theme entries (day geometry per size token, `dayBorderRadius: 'xxs'` for the square look, toggle glyphs, popup/list chrome). Selection, range and today colours are deliberately not options \u2014 they are the `primary` role pair, so themes restyle them by restyling the palette.\n- **Naming note:** the fences are `minDate`/`maxDate`/`minTime`/`maxTime`/`minDateTime`/`maxDateTime` rather than the platform's `min`/`max`, because Signal Forms' `FormUiControl` reserves `min`/`max` as numeric signals on form controls.",
+              commit: "71bc74c"
+            },
+            {
+              bump: "minor",
+              title: "Themable focus chrome: a shared `focusRing` primitive for every control, plus `focusBorder`/`focusShadow`/`focusColor` options for input boxes.",
+              body: "**Shared focus ring.** A theme can now restyle the keyboard-focus indicator across the whole library by defining `focusRing` **border** and/or **shadow** primitives: `ThemeService.focusRing()` (and the new selector-less `focusRingStyle()`) replaces its default 2px outline with that border \u2014 drawn as an outline hugging the control \u2014 plus the ring shadow. A `focusRing` **thickness** primitive sets the ring's outline offset (negative values overlay the control's resting border, reading as a border-color change). Checkbox, radio, toggle and slider now route their hand-rolled focus styles through the shared helper (calendar days and tag chips already did), so one primitive trio gives every control the same focus language. Themes without the primitives render exactly as before.\n\n**uni-core:** `Thicknesses` is now an open record like `Borders`/`Shadows` (extra named primitives allowed), and `createTheme` accepts a sparse `thicknesses` override merged over the base scale.\n\n**Also in this release:**\n- Radio and toggle scope their transitions (border/background/transform) instead of `all`, so the focus ring's outline and shadow apply instantly \u2014 `transition: all` interpolated the outline from a stale color, flashing a dark ring before the themed ring color landed.\n- The radio's dot grow/retract animation is a token \u2014 `radio.options.transitionSpeed` (seconds, default 0.3 preserving the current feel; 0 switches instantly).\n- The checkbox focus ring rounds proportionally again (box radius plus its gap) and the gap itself is a new `checkbox.options.focusRingGap` option; a `focusRingStyle` call's explicit gap wins over the theme's `focusRing` thickness, then the branch defaults.\n\nThe `input` component options could previously restyle focus only through `focusOutline`/`focusOutlineOffset`. The new optional trio mirrors the error-state trio (`errorBorder`/`errorShadow`/`errorColor`) and applies while any projected control has focus: `focusBorder` swaps the border primitive, `focusShadow` draws a ring (e.g. a soft `0 0 0 3px` spread), and `focusColor` swaps the background. All three default to `undefined`, so existing themes render exactly as before, and they yield to the error state so a flagged field stays visibly flagged while being corrected.\n\nThe Wellsourced showcase theme now defines the `focusRing` pair for its app's `.search-input:focus` look \u2014 an ochre (`secondary`) 1px border with a 10% ring of the same hue, tinted per palette in light and dark \u2014 so text fields (which rest on a canvas tint and snap to the clean surface on focus), checkboxes, radios, toggles, sliders, calendar days and tag chips all share one focus treatment.",
+              commit: "1a6b382"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "8.0.0",
+          entries: [
+            {
+              bump: "major",
+              title: "`uni-tag` v2: themable, opt-in removal, two style axes",
+              body: "v1 was a single hardcoded look with the palette welded into its template, an\nunconditional remove button, and no theme entry \u2014 a filter chip, a status pill\nand a recipient token all rendered identically. v2 makes the chip a real themed\ncomponent and the building block `uni-tag-input` composes.\n\n**Breaking (uni-angular)**\n- **`(close)` is now `(removed)`.** The old name shadowed the native `close`\n  event and needed an eslint suppression to compile.\n- **The remove button is opt-in** \u2014 set `[removable]=\"true\"`. Previously every\n  tag, including a plain category label, shipped a \"Remove \u2026\" button into the\n  accessibility tree.\n- Codemod: rename `(close)` \u2192 `(removed)` and add `[removable]=\"true\"` wherever\n  a `(close)` handler exists.\n\n**Fixed**\n- **A falsy value can now be removed.** `handleClose` guarded with `if (v)`, so\n  a tag keyed `''` or `0` silently could not be dismissed. Every defined value\n  emits, and a tag with no value emits `undefined`.\n- The remove control now sizes from the chip instead of the icon-button's own\n  `sm` size \u2014 it was 22px inside a 24px chip, and taller than an `sm` chip\n  entirely.\n\n**New**\n- **Two orthogonal style axes**: `variant` picks the colour role, `tone` picks\n  the archetype (`soft` / `solid` / `outline`). Both resolve from the new `tag`\n  theme entry, with tones as nested `&.tone-*` selectors inside each variant so\n  a theme author restyles both axes in one place.\n- **`'tag'` joins core's `ComponentName`**, with a `TagTone` type and a full\n  theme entry (`options` for radius/typeface/gap/symbols, `variants` per colour\n  role, `sizes` carrying geometry only).\n- **`interactive`** turns the chip body into a `<button>` with `selected` mapped\n  to `aria-pressed`, keeping the remove control a sibling \u2014 nesting them would\n  be invalid HTML and would strand the inner control for keyboard users.\n- **Lead slot**: `avatarSrc`, `avatarName` (initials fallback), `iconName`,\n  `symbolName` and `dot` convenience inputs, plus a `[tag-lead]` slot for\n  anything richer. Lead elements size from the chip height, and all are\n  `aria-hidden` so the chip's text stays its accessible name.\n- **Glyphs are theme icon primitives, not Material ligatures.** The remove and\n  selected affordances resolve through the new `removeIcon` / `selectedIcon`\n  theme options (defaulting to the built-in `close` and `check`), so they mask\n  `currentColor`, recolour with the chip's tone, and can be swapped per theme.\n  They also contribute no text to the DOM, which a ligature does \u2014 one less way\n  for an accessible name to be polluted. `symbolName` remains as the escape\n  hatch for glyphs the theme's icon set doesn't carry.\n- **`invalid`** sets `aria-invalid` and a dashed underline, so the state does\n  not rely on colour alone (WCAG 1.4.1); `disabled`, `maxWidth` truncation with\n  a `title`, and `removeLabel` for overriding the remove button's name.\n- The component ships with 21 specs, having previously had none.",
+              commit: "760b761"
+            },
+            {
+              bump: "major",
+              title: "`ThemeService`: validated writes, runtime theme registration, live options",
+              body: 'The theme registry was bootstrap-frozen and nothing validated theme writes \u2014\nand a brand theme applied via `applyPalette` never appeared in\n`uni-theme-switch`, leaving the select on a bogus value with no way back.\n\n**Breaking**\n- `ThemeService.theme` is now a **readonly signal**. Direct `theme.set(...)`\n  calls (already discouraged in the docs) must move to `setTheme(input)`,\n  which validates and returns `ThemeParseResult` \u2014 acceptance or the complete\n  list of rejection reasons \u2014 leaving the active theme untouched on rejection.\n- `selectTheme(name)` now returns `boolean` and, for an unknown name, **does\n  nothing** \u2014 previously it silently kept the old theme while still recording\n  the bad key in `selectedThemeKey` and localStorage.\n- `themeOptions` is now a `computed` (was a once-written writable signal).\n\n**New**\n- **`registerTheme(input, { select? })`** validates and adds a theme to the\n  live registry \u2014 it appears in `themeOptions`/`uni-theme-switch` immediately.\n  **`unregisterTheme(id)`** removes it, falling back to the first remaining\n  theme when it was active. Themes injected via `UNI_THEMES` are validated at\n  startup; malformed entries are excluded with a console warning listing every\n  reason.\n- **`applyPalette` registers the generated theme under `CustomTheme`**, so\n  "Your Brand" is an ordinary, selectable option: it shows in the switcher,\n  survives switching away and back, and `clearCustomPalette` unregisters it.\n- **`uni-select` fix:** a selection pointing at an option added in the same\n  change-detection pass now applies (per-option `[selected]` binding; the\n  select-level `[value]` write landed before new options existed and was\n  ignored by the browser) \u2014 any consumer with a growing options list was\n  affected.',
+              commit: "6a4c7da"
+            },
+            {
+              bump: "minor",
+              title: "`uni-multi-select-dropdown`: a real accessible name, keyboard navigation, debounced filtering \u2014 and its first specs",
+              body: 'This was the weakest component in the library on exactly the axes the roadmap\'s\ncombobox item names, and it had **no spec file at all**, which is why the\nmissing accessible name survived since it was written.\n- **New `label` input, and the trigger finally names the field.** Its\n  accessible name now reads "Fruits, 2 selected, Apple, Cherry". Previously it\n  announced only the current selection \u2014 a screen reader user heard\n  "Option 1, Option 3" with no way to tell which field it belonged to. The\n  selection count comes along, so "how many did I pick" is not left to counting\n  commas.\n- **Arrow keys, Home and End walk the options** from anywhere in the panel,\n  including the filter box. Reaching the last of thirty options previously\n  meant thirty `Tab` presses. Wrapping and the index arithmetic come from the\n  CDK\'s shared `ListboxNavigation`, so the keys behave exactly as they do in\n  `uni-search-input` and `uni-tag-input`.\n- **The filter is debounced** (new `debounceTime`, default 200ms) instead of\n  re-filtering on every keystroke \u2014 the open item in TODO.md.\n- **An empty filter result says so** through `role="status"`, rather than\n  leaving the panel blank.\n- **The options are grouped** as a `role="group"` labelled from `label`.\n- **20 specs**, covering the accessible name, selection and toggling, disabled\n  behaviour, filtering and debounce, keyboard navigation, and the form-control\n  contract.\n\n**A deliberate non-change:** the options stay real checkboxes rather than\nbecoming a multi-selectable `listbox`. APG notes that multi-select listboxes are\nhandled inconsistently across screen readers and suggests a checkbox group\ninstead, and real checkboxes keep each option\'s state announced natively \u2014 so\nconverting would have traded a well-supported pattern for a fashionable one,\nand duplicated the checkbox\'s animated visual into this component where it\nwould drift.',
+              commit: "970c36d"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-tag-input`, plus a shared listbox contract in the CDK",
+              body: 'The type-to-add chip field \u2014 recipients, filters, labels. It is the **open-set**\ncontrol: anything typed can become a token, whether or not it matches a\nsuggestion. Closed-set picking stays with `uni-select` /\n`uni-multi-select-dropdown`, which is the deliberate split \u2014 the two look alike\nbut differ on the one thing that decides the value type, so a single component\nwould force one of them to carry an API it can never use.\n- **`FormValueControl<UniTagItem[]>`.** `{ value: \'a@b.com\' }` is a complete\n  item; `label`, `avatarSrc`, `invalid` and `disabled` are optional enrichment.\n- **Invalid entries stay in the value, flagged**, rather than being dropped \u2014 a\n  field that silently swallows a typo\'d address is worse than one that shows it\n  in red, and Enter on the chip lifts it back into the input to fix. Duplicates\n  and over-`max` entries are refused through `(rejected)` with a reason.\n- **Full keyboard contract**: separators commit, Tab commits without trapping,\n  Backspace on an empty field _focuses_ the last chip rather than deleting it\n  blind, and on a chip Backspace and Delete both remove but move focus in\n  opposite directions \u2014 what makes pruning a list feel right.\n- **The whole field is one tab stop.** Chips carry `tabindex="-1"`, so Tab never\n  walks through eight recipients to reach the next control.\n- **Announces through a `role="status"` live region** on every add, remove and\n  rejection; the removal route is described once per field rather than by every\n  chip.\n- **`preset="email"`** wires an address validator, a paste parser that unwraps\n  `Name <a@b.com>` and keeps an unterminated tail in the field, and Space as a\n  separator.\n- **`\'tagInput\'` joins core\'s `ComponentName`** with a theme entry for the chip\n  field\'s own tokens. Field chrome is not duplicated \u2014 it comes from `input` via\n  `uni-input-box`, so a tag input restyles with every other field.\n\n**Also in this release**\n- **`ListboxNavigation` in the CDK** (`createListboxNavigation`) owns the\n  combobox bookkeeping every type-ahead control needs: open state, active\n  option, wrap-around arithmetic, Home/End, and `aria-activedescendant` wiring\n  that can never point at an option a narrowing filter has removed.\n  `uni-search-input` now uses it \u2014 behaviour unchanged, and it gains Home/End\n  for free \u2014 and the multi-select combobox upgrade will too. Three hand-rolled\n  copies of one keyboard contract is how they drift.\n- **`uni-tag` gains `controlTabIndex`**, so a composite that owns its own roving\n  focus can take its chips out of the tab order, and **`selected` is now\n  optional**: an interactive chip carries `aria-pressed` only when it is\n  genuinely a toggle. Announcing "not pressed" on a recipient chip is worse than\n  announcing nothing.',
+              commit: "de83fe4"
+            },
+            {
+              bump: "minor",
+              title: "Themes registered from JSON get the built-in icons back",
+              body: "`registerTheme` and `setTheme` now hydrate a theme's icons on the way in: the\nbuilt-in set is merged _under_ whatever icons the payload carries, so the\ntheme's own icons still win.\n\nThis is what makes a theme fetched as JSON usable. Transports elide `BaseIcons`\n\u2014 roughly 71% of a serialized theme, and bytes the consumer already ships \u2014 so\nwithout hydration a fetched theme would validate cleanly and then render no\nicons at all. The rule is the same one `createTheme` already applies at\nconstruction (`{...BaseIcons, ...icons}`), so a theme behaves identically\nwhether it was built in-process or arrived over the wire.\n\nThemes provided through `UNI_THEMES` are unaffected: they already carry the full\nset, so hydration is a no-op.",
+              commit: "5414517"
+            },
+            {
+              bump: "patch",
+              title: "Menu items no longer look preselected when opened with the mouse",
+              body: "Opening a `uni-menu` by click left the first item highlighted before the\npointer had touched it, reading as a preselected default. Two correct\nbehaviours combined badly: `onOpened()` implements ARIA roving focus by calling\n`.focus()` on an item every open, and the item styles deliberately painted\n`:focus` the same as `:hover`. Nothing was wrong with the focus itself \u2014 only\nwith painting it after a pointer open.\n- **The highlight now keys on `:focus-visible`.** Programmatic focus following a\n  click doesn't match it, while keyboard-driven focus does \u2014 so mouse users get\n  no phantom highlight, and keyboard users keep the focus cursor. Roving-focus\n  bookkeeping is untouched: a mouse open still moves focus to the first item, so\n  screen readers announce it exactly as before.\n- **New `HOVER_OR_KEYBOARD_FOCUS` constant exported from uni-core**, holding\n  that selector. Emotion merges styles by _exact selector text_, so a component's\n  base rule and any theme variant restyling it have to agree character for\n  character \u2014 a variant keyed `'&:hover, &:focus'` would both fail to override\n  and reintroduce the phantom highlight. Naming the selector once removes the\n  trap; the base theme's `menuItem.warn` tone and the Carbon/Wellsourced\n  showcase themes now use it.\n\nThemes with their own `menuItem` variants should key the highlight with\n`HOVER_OR_KEYBOARD_FOCUS`. Note that `:focus-visible` is a browser heuristic:\nafter a user has been navigating by keyboard, a subsequent click may still show\nthe highlight, which is the intended \"this person is using the keyboard\"\nbehaviour rather than a regression.",
+              commit: "3279186"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@8.0.0"
+          ]
+        },
+        {
+          version: "7.3.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "`expand` gains a themable, size-aware speed",
+              body: "The reveal/collapse duration was hardcoded at 350ms, so a consumer wanting a\nsnappier disclosure \u2014 or wanting adjacent styling to fade on the same clock \u2014\nhad nothing to reference. A fixed duration also reads differently at different\nsizes: sluggish on a two-line region, rushed on a full-page one.\n- **New `transitionSpeed` option in the `expand` theme options** (seconds,\n  default `0.35`, matching alert/card `transitionSpeed`) sets the base\n  duration. `'expand'` joins core's `ComponentName` union, so custom and\n  derived themes can type an `expand` entry.\n- **Duration scales with content height.** The actual duration is\n  `transitionSpeed \xD7 \u221A(height \xF7 240px)`, clamped to ~0.15\u20130.6s at the default\n  speed (the envelope scales proportionally with a themed speed), so perceived\n  speed stays steady across region sizes. The curve and its constants\n  (`expandDuration`, `EXPAND_DEFAULT_SPEED`, `EXPAND_MIN_DURATION`,\n  `EXPAND_MAX_DURATION`, `EXPAND_REFERENCE_HEIGHT`) are exported from\n  uni-core.\n- **New per-instance `transitionSpeed` input** sets an exact duration for one\n  region, bypassing the scaling: `<uni-expand [transitionSpeed]=\"0.15\">`.\n- **The resolved duration is exposed as the public `duration` signal** on\n  `uni-expand`, so adjacent styling can move on the reveal's clock with a\n  plain binding \u2014 `[style.transition-duration]=\"expand.duration() + 's'\"` \u2014\n  keeping all timing in the theme/signal pipeline, with no custom CSS.\n- **`expand-toggle` gains a matching `transitionSpeed` input** and otherwise\n  follows the theme token instead of its own hardcoded 350ms. Expand Area\n  binds the region's resolved `duration` to its toggle, keeping chevron and\n  reveal on one clock even when size-scaled or overridden.\n- **Speed is theme-reactive**: swapping themes at runtime retimes regions and\n  chevrons live.\n- **Enter/leave easing is now `ease-in-out`** (was `ease-in`), matching the\n  chevron rotation so trigger and region decelerate together.\n- **`UniExpandOptions` is exported** from uni-angular for\n  `getComponentOptions<UniExpandOptions>('expand')` consumers.",
+              commit: "c828982"
+            },
+            {
+              bump: "minor",
+              title: "Menus join the theme model: `menu` + `menuItem` component options, item tones, and dividers",
+              body: "The menu was the only composite component with no theme surface of its own \u2014\npanel chrome came from the shared `dropdown` entry and every item-level knob\n(height 38, `primary-container` hover, `check` active symbol, `label` type\nrole) was hardcoded. Every Uni menu therefore looked identical, and the gaps a\nreal product hits first (a red Delete, a separator before it, disabled rows)\nwere only reachable via `::ng-deep`.\n- **New `menu` theme options** (`'menu'` joins core's `ComponentName` union):\n  `minWidth`, panel `color`/`border`/`borderRadius`/`shadow` (each falling\n  back to the `dropdown` options when unset, so menus follow generic popovers\n  until a theme deliberately splits them), `paddingVertical`/\n  `paddingHorizontal` (panel inset \u2014 `xs` inset plus item `borderRadius`\n  yields the \"hover pill\" look; `none` yields full-bleed rows), and\n  `dividerBorder`/`dividerSpacing` for separators.\n- **New `menuItem` theme options + variants** (`'menuItem'` joins\n  `ComponentName`): `height`, `paddingHorizontal`, `gap`, `borderRadius`,\n  `typeface`, `textColor`, `hoverColor`, `activeSymbol` (undefined removes the\n  trailing check), and `transitionSpeed`. Theme `variants` on `menuItem` carry\n  tones \u2014 the base theme ships a `warn` tone for destructive actions.\n- **`MenuItem` grows `variant`, `disabled`, and `{ divider: true }`.**\n  `variant: 'warn'` routes through the theme's `menuItem` variants; `disabled`\n  items render in the disabled color, carry `aria-disabled`, and are skipped\n  by keyboard navigation; dividers render as `role=\"separator\"` rules styled\n  by the `menu` options. `isDivider` and the `UniMenuOptions`/\n  `UniMenuItemOptions` interfaces are exported from uni-angular.\n- **`uni-dropdown` panel chrome is now input-overridable**\n  (`border`/`borderRadius`/`shadow`/`color`), falling back to the `dropdown`\n  theme options \u2014 this is the mechanism `uni-menu` uses; other consumers are\n  unchanged.\n- **Default-rendering change:** menus now have `minWidth: 184` from the base\n  theme (previously they sized to the widest item). All other defaults\n  reproduce the previous look, including the 0.35s hover transition.\n- **The Carbon experiment themes gain menu styling** (sharp full-bleed 40px\n  rows, IBM Plex, `$layer-hover`, red danger option, ~110ms motion) with a new\n  Carbon Menu story demonstrating that the same component renders both\n  aesthetics untouched.",
+              commit: "6e8b429"
+            },
+            {
+              bump: "patch",
+              title: "Tooltip no longer blinks after activating a wrapped control",
+              body: 'Clicking a button inside `uni-tooltip` used to fall through to the bubble\'s\ntap-to-toggle handler and then re-show on the still-hovering pointer \u2014 a\nstate-flipping label ("Expand" \u2192 "Collapse") visibly blinked off and back on\nafter the click.\n- **Activating an interactive element inside the host now hides the bubble\n  and suppresses it** until the pointer leaves and returns (or focus moves\n  away). Tap-to-toggle is unchanged for non-interactive hosts (inline text).\n- **`expand-toggle` drops its icon-only tooltip.** The rotating chevron plus\n  `aria-expanded` and the button\'s accessible name already say everything the\n  bubble restated; use the `label` input when a disclosure needs a visible\n  name.',
+              commit: "ba4e38d"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Centre `icon-button`'s glyph, fix `expand-toggle`'s rotation, make `expand`",
+              body: "block-level and motion-safe, and give `expand-toggle` a label\n\nGaps found while building collapsible sections in a consuming app, where each\none had to be worked around locally.\n- **`icon-button` centres its glyph.** Sizing `iconName` from the size token\n  (shipped in the previous release) made the glyph smaller than the button \u2014\n  an `sm` button is a 22px box around an 18px icon \u2014 but the button was\n  `display: block`, so the glyph sat in the top-left corner with all the slack\n  on its right and bottom. It is now a centring flex box; flex is still\n  block-level, so the button's own layout is unchanged, and the\n  absolutely-positioned accessible-name span stays out of the flex flow.\n  **Visual change** for every `icon-button`: glyphs shift to the middle of the\n  box. `symbolName` ligatures centre too, which also means the known\n  oversized-ligature case (a 24px glyph in a 22px `sm` box) now clips evenly on\n  all sides instead of only bottom-right. Covered by a test.\n- **`expand-toggle` rotates the glyph instead of its host.** This is a fix to\n  existing behaviour, visible in 7.1.0 and earlier: the 180\xB0 turn was applied to\n  the component host, which is both the tooltip's positioning box (`uni-tooltip`\n  sets `anchor-name` on its own element, nested inside the host) and taller than\n  the glyph, since an inline-level box reserves baseline descender space. So the\n  bubble bobbed along an arc as the chevron turned, and the chevron itself\n  drifted off-centre rather than spinning in place. The transform now lands on\n  `uni-icon` \u2014 a centred square sized to the glyph, and the only box here that\n  rotates symmetrically. The host keeps its `toggled` attribute, so any consumer\n  styling keyed on it still works.\n- **`uni-expand` is now `display: block`.** As a custom element it defaulted to\n  `display: inline`, so its animated grid laid out as a block-in-inline box and\n  the revealed content's spacing came out subtly wrong. Every consumer was\n  writing `uni-expand { display: block }` by hand. **Visual change** for anyone\n  who was relying on the inline default or already shipping that override \u2014 the\n  override is now redundant and can be deleted.\n- **The reveal respects `prefers-reduced-motion`** (WCAG 2.3.3). The\n  expand/collapse keyframes ran unconditionally; they're now wrapped in\n  `motionSafe`, as is `expand-toggle`'s chevron rotation. Under reduced motion\n  the region appears and disappears instantly. `overflow: hidden` moved inside\n  the guard deliberately: it exists to clip the box mid-animation, and leaving\n  it applied at rest would crop decorations that legitimately paint outside the\n  region (focus rings, offset outlines). Angular removes a leaving node on the\n  next frame when it detects no animation, so nothing hangs.\n- **`expand-toggle` takes `label` and `sublabel`.** It was chevron-only, so any\n  disclosure that names its section \u2014 most of them \u2014 had to hand-roll the whole\n  trigger row and its styles, which is how consumers end up with a private\n  copy of this component. With `label` set the toggle renders a full-width row\n  (chevron, label, muted qualifier) as a single button whose accessible name is\n  the label, instead of an icon button sitting next to unrelated text. Only the\n  chevron rotates, so the label stays upright. Omit `label` and the icon-only\n  shape is unchanged, tooltip and all \u2014 `uni-expand-area` is unaffected.",
+              commit: "8d77ed7"
+            },
+            {
+              bump: "minor",
+              title: "Size `icon-button`'s `iconName` glyph from its size token",
+              body: "`icon-button` rendered a `symbolName` ligature at a font size, but an `iconName`\nmask with no size at all \u2014 and the base `iconButton` size tokens carry no\npadding, so the icon filled the entire button box edge to edge. That made\n`symbolName` \u2192 `iconName` a visual regression rather than a like-for-like swap,\nwhich matters now that `uni-icon` is the preferred path (a mask paints on the\nfirst frame, where a ligature waits on the variable font).\n- `iconName` is now sized from the size token's `fontSize` \u2014 the same value that\n  scales the rest of the control \u2014 so the glyph sits inside the button and grows\n  with `size`. Concretely, `size=\"sm\"` renders an 18px glyph in a 22px button\n  instead of a 22px one.\n- **Visual change** for existing `iconName` call sites: glyphs get slightly\n  smaller and gain breathing room. Themes that size icon-buttons with padding\n  (e.g. the Carbon example) set a matching `fontSize`, so they land on the same\n  glyph size either way and are unaffected.\n- Known gap, now covered by a test that documents rather than blesses it:\n  `uni-symbol` takes its size from `opticalSize` (default 24) and ignores the\n  button's size token, so a `sm` button renders a 24px ligature in a 22px box.\n  Masked icons do not have that problem \u2014 one more reason to prefer `iconName`.",
+              commit: "c532c95"
+            },
+            {
+              bump: "patch",
+              title: 'Fix `uni-icon` ignoring `size="24"` written as a static attribute',
+              body: '`size` appended `px` only to numbers, but a static template attribute arrives as\na string \u2014 so `<uni-icon name="mail" size="24" />` emitted the invalid\n`width: 24`. Browsers drop an invalid declaration, which silently fell back to\nthe stylesheet\'s `width: 100%; height: 100%`.\n\nThat failed in two different ways depending on the container, neither of them\nobvious: inside a fixed box the icon quietly filled it (a 16px glyph rendering\nat 30px), and inside a content-sized flex row `height: 100%` collapsed to zero,\nso the icon vanished while still occupying full width and pushing its label\nacross the row.\n\nA bare numeric string is now treated as px, matching the number form. Genuine\nCSS lengths (`\'1.25rem\'`, `\'50%\'`, `calc(\u2026)`) still pass through untouched.\n`[size]="24"` was unaffected throughout, since property binding passes a real\nnumber.',
+              commit: "c532c95"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Expand `BaseIcons` to 59 icons and add `uni-icon` sizing",
+              body: "The 34-icon set shipped in 7.0.0 covered the library's own components but not a\nreal application \u2014 an app migrating off inline `<svg>` (or off `uni-symbol`, in\nAngular) ran out of names almost immediately. Everything here is additive; all\n34 existing names are unchanged.\n- **25 new icons**, same Material Symbols Outlined 300 source and the same\n  `0 -960 960 960` grid as the rest of the set: navigation (`link`, `expand`,\n  `gridView`, `listView`), actions (`moreHorizontal`, `copy`, `send`,\n  `refresh`, `dragHandle`, `qrCode`), feedback (`star`, `verified`) and\n  user/system (`group`, `shieldPerson`, `clock`, `mail`, `chat`, `image`,\n  `document`, `payment`, `bank`, `trendingUp`, `extension`, `webhook`,\n  `logout`).\n  - `moreHorizontal` ships alongside `more` because that one is `more_vert` and\n    row-aligned menus need the horizontal kebab.\n  - `star` is separate from `favorite`, which is the heart.\n- **`uni-icon` gains an optional `size` input** (`CssLength` \u2014 bare numbers are\n  px, strings pass through, so `20` and `'1.25rem'` both work). Left unset,\n  behaviour is unchanged: the icon fills its container, which is what lets a\n  themed control size its own glyph through padding. Set, it applies\n  width/height as inline styles, so an explicit size wins over the\n  fill-the-container rule regardless of style injection order. This removes the\n  per-call-site `width`/`height` CSS rule that replacing an inline `<svg>` with\n  `<uni-icon>` would otherwise need.\n- The MCP `create-icon-tokens` tool now lists the built-in icon names above the\n  token map it returns. Apps routinely hand-draw their own `close`, `check` or\n  `plus`; encoding those into theme tokens works but adds redundant artwork on a\n  foreign grid when the theme already ships the glyph. The tool cannot recognise\n  a shape, so it hands the caller the list to check against before adding\n  anything.",
+              commit: "c2421c0"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Replace `BaseIcons` with a normalized 34-icon Material Symbols set",
+              body: "The built-in icon set was 11 glyphs drawn from four different grids\n(`0 0 24 24`, `0 0 50 50`, `0 0 64 64`, `0 -960 960 960`), so `checkCircle` and\n`xCircle` rendered as solid filled discs next to a hairline `alertCircle` and an\noversized `close` \u2014 three optical weights in one set.\n- `BaseIcons` is now Material Symbols Outlined at weight 300, every glyph on a\n  single `0 -960 960 960` grid, grouped by intent: navigation (`menu`,\n  `chevronUp/Down/Left/Right`, `arrowLeft/Right`, `home`, `externalLink`),\n  actions (`search`, `close`, `plus`, `minus`, `more`, `delete`, `edit`,\n  `download`, `upload`, `share`, `filter`), feedback (`check`, `checkCircle`,\n  `xCircle`, `alertCircle`, `info`, `warning`, `lock`) and user/system\n  (`profile`, `settings`, `notification`, `favorite`, `help`, `calendar`).\n- All 11 previously shipped names are preserved, so existing `<uni-icon>` call\n  sites and theme overrides keep working. Their **appearance changes**: the\n  filled `checkCircle`/`xCircle` are now outlined, and the set reads lighter\n  overall. `spinner` is carried over verbatim, keyframes intact.\n- New `IconName` and `BaseIconName` types. `IconName` is\n  `BaseIconName | (string & {})`, so built-ins autocomplete and typos surface\n  while themes can still register arbitrary names via `createTheme({ icons })`.\n  `uni-icon`'s `name` input is typed with it instead of `keyof Icons`.\n- **Breaking**: removes the unused `IconToken`, `IconStyle`, `ToggleableIcon`\n  and `IconConfig` exports. Nothing in the library referenced them and\n  `IconToken`'s 60-name union contradicted the actual `BaseIcons` keys. Use\n  `IconName` instead.\n- New exported `svgToIconUri(svg, options?)` \u2014 the supported way to bring your\n  own icons (a brand set, a designer handoff) into a theme. It normalizes the\n  source (drops the xml declaration, comments and fixed `width`/`height` so the\n  mask scales), percent-encodes it, and **rejects artwork that cannot survive\n  masking**: no `viewBox`, an embedded raster `<image>`, an external reference,\n  a gradient/pattern fill, or more than one paint color. That last one is the\n  trap worth naming \u2014 masks use the alpha channel, so a multi-color logo\n  flattens to a silhouette in `currentColor`; pass `{ allowMultiColor: true }`\n  when that is intended. `createTheme({ icons })` merges the result over\n  `BaseIcons` per name, so a built-in name reskins and a new name is added.\n- New MCP tool `create-icon-tokens`, the agent-facing front end to\n  `svgToIconUri`: hand it a project's inline `<svg>` (or a brand set) and it\n  returns a paste-ready `icons` map for `uni-theme.ts`. It encodes via the same\n  helper, so tokens are byte-identical to the built-in set, and adds the\n  set-level checks a per-icon helper cannot make \u2014 which names override\n  built-ins, and whether the artwork mixes viewBox grids. Bad artwork is\n  reported per icon rather than failing the batch, and re-running is safe\n  (already-encoded URIs pass through). The server instructions now point agents\n  at it whenever they encounter inline SVG.\n- `BaseIcons` is generated by `scripts/generate-icons.mjs` (`pnpm icons:generate`),\n  which fetches from the canonical Material Symbols source and validates every\n  glyph before writing \u2014 a malformed path, an off-grid viewBox or geometry\n  outside the grid aborts the run. `pnpm icons:check` verifies the committed\n  file without writing. Add or change icons in that script's manifest and\n  regenerate; the file is not hand-edited. `icon.records.spec.ts` asserts the\n  same invariants against the committed output.",
+              commit: "f7727aa"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@7.0.0"
+          ]
+        },
+        {
+          version: "6.1.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "6.0.1",
+          entries: [
+            {
+              bump: "patch",
+              title: "Canonical MDX docs structure across the entire library",
+              body: "- Component docs pages now follow one flow (spec in AGENTS.md): imports \u2192 Overview \u2192\n  Usage (the compact playground: story + source + knobs) \u2192 named variation examples \u2192\n  **Theme options** \u2192 Accessibility \u2192 Do/Don't. Property/API/Methods/Events tables are\n  retired \u2014 the playground's controls are the API reference.\n- New `ThemeOptions` docs block renders a component's per-theme option tokens live from\n  the active Storybook theme (with color swatches), distinguishing per-theme options\n  from per-instance inputs; data-table's raw `ThemeDataBlock` dump is replaced.\n- All ~55 component pages conform: the 7 form-control pages (200\u2013390 lines of legacy\n  API tables) rewritten; empty Overviews authored (card, tag, icon-button, scroll-area,\n  expand-area, data-table); accessibility bullets added across navigation, feedback,\n  and form components.\n- The MCP index now carries when-to-use guidance for 55 of 70 components (was 41) and\n  accessibility guidance for 36 (was 21) \u2014 the remainder are subcomponents documented\n  on their parent pages and internal directives.",
+              commit: "4bfb057"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "6.0.0",
+          entries: [
+            {
+              bump: "major",
+              title: "Layout components are attribute-only, on any element",
+              body: '**Breaking:** the shorthand element selectors `Box`, `Stack`, `Row`, `Grid`, `Wrap`,\nand `GridArea` are removed \u2014 a concept inherited from another library that conflicted\nwith semantic HTML. Migrate to the attribute form: `<Box padding="md">` \u2192\n`<div box-layout padding="md">` (GridArea \u2192 `grid-area-layout`).\n\nIn exchange, the attribute selectors now apply to **any element**, not just `div` \u2014\nlayout and semantics compose: `<main box-layout [grow]="1" padding="md">`,\n`<nav stack-layout gap="sm">`, `<section stack-layout>`.\n\nAlso documented, unchanged in behavior: the sizing convention (number = px via\nbinding, `[height]="420"`; plain attribute = CSS length, `height="420px"`) and\nStack/Row\'s `fit-content` min-size defaults (set `[minHeight]="0"` / `[minWidth]="0"`\nfor scroll containment). All internal usages, stories, and docs are migrated \u2014\nincluding the Divider story\'s `<Center>`, which had silently never rendered (Center\nnever had an element selector).',
+              commit: "a02afee"
+            },
+            {
+              bump: "major",
+              title: "Selector unification: one form per component",
+              body: "**Breaking:** every PascalCase alias selector is removed (`Card`, `Menu`, `Symbol`,\n`Icon`, `Dialog`, `Button`, `Tabs`, `Snackbar`, `SelectInput`, `Confirmation`, \u2026 \u2014 a\nconcept inherited from another library). Each component now has exactly one canonical\nform, chosen by what the component is:\n- **Widgets and content-renderers** keep their `uni-*` element: `<uni-card>`,\n  `<uni-menu>`, `<uni-symbol>`, `<uni-icon>`, `<uni-tabs>`, `<uni-select>`,\n  `<uni-confirmation-dialog>`, \u2026\n- **Decorators of native elements** are attribute-only, and their `div`-locks are\n  lifted: `[uni-badge]`, `[uni-dialog-header]` (e.g. on `<header>`),\n  `[uni-dialog-buttons]`/`[dialog-buttons]` (e.g. on `<footer>`),\n  `[uni-scroll-area]`/`[scroll-area]`, `[uni-menu-item]`/`[menu-item]` (e.g. on\n  `<li>`).\n- **Host-locked selectors stay host-locked** where the native element carries the\n  behavior: `dialog[uni-dialog]`, `button[uni-text-button]`/`button[text-button]`,\n  `button[uni-icon-button]`/`button[icon-button]`.\n\nMigration is mechanical: `<Card>` \u2192 `<uni-card>`, `<Button \u2026>` \u2192\n`<button text-button \u2026>`, `<Dialog \u2026>` \u2192 `<dialog uni-dialog \u2026>`, `<Badge \u2026>` \u2192\n`<div uni-badge \u2026>`, `<ScrollArea \u2026>` \u2192 `<div scroll-area \u2026>`. All internal usages,\nstories, and docs are migrated; `llms.txt` and the MCP index reflect the canonical\nforms.",
+              commit: "f1796fb"
+            },
+            {
+              bump: "major",
+              title: "Text is attribute-only, with a value shorthand and element-aware defaults",
+              body: '**Breaking:** the `uni-text` and `Text` element selectors are removed. Text is now the\nattribute `[uni-text]` on any element, keeping your HTML semantics:\n- **Value shorthand** \u2014 the attribute value is the typeface:\n  `<h1 uni-text="display-small">`, `<span uni-text="caption">`, dynamic via\n  `[uni-text]="role()"`. The explicit `typeface` input still works (the attribute\n  value wins when both are set).\n- **Element-aware defaults** \u2014 with no value, the typeface is inferred from the host:\n  `h1`\u2192headline-large, `h2`\u2192headline-medium, `h3`\u2192headline-small, `h4`\u2192title-large,\n  `p`\u2192body-1-long, `small`/`figcaption`\u2192caption, `blockquote`\u2192quote, `label`\u2192label,\n  else title-small. Plain semantic markup is correctly set with zero configuration.\n\nMigrate `<uni-text typeface="body-1-long">\u2026</uni-text>` \u2192\n`<p uni-text>\u2026</p>` (or `<span uni-text="body-1-long">` where no semantic element\nfits). All internal usages, stories, and docs are migrated.',
+              commit: "a62e9b1"
+            },
+            {
+              bump: "minor",
+              title: "Search input stripped back and made generic; debounce input dressed in the shared chrome",
+              body: "- **`uni-debounce-input`** now wears the themed input chrome via `uni-input-box`\n  (color, border, typeface, focus ring) and gains `label` (accessible name),\n  `placeholder`, `disabled`, `pre-input`/`post-input` attribute slots for adornments,\n  ARIA passthroughs (`role`, `ariaExpanded`, `ariaControls`, `ariaActivedescendant`)\n  for composite widgets, and `clear()`/`focus()` methods. Debounce behavior unchanged.\n- **`uni-search-input` redesigned**: the opinionated solid-primary pill bar with the\n  embedded `title-large` label is gone. It's now a standard themed field \u2014 decorative\n  leading magnifier, clear button while a query exists (refocusing on clear), Enter\n  emits `search`, Escape closes/clears.\n- **Type-ahead added**: pass `suggestions` (refresh from `change`) and the field\n  becomes an ARIA combobox \u2014 keyboard-navigable listbox (ArrowUp/Down, Enter selects,\n  emitting `suggestionSelected` + `search`), `aria-activedescendant` wiring, focus-out\n  closing. New `searchInput` theme options: `searchSymbol`, `clearSymbol`, suggestion\n  list `listColor`/`listShadow`/`listBorderRadius`, `maxSuggestions`.\n- Visual breaking change for SearchInput consumers (deliberate strip-back); code API\n  is compatible (`label`/`width`/`change`/`search` retained; `label` is now the\n  accessible name + placeholder fallback rather than displayed text).",
+              commit: "5a6fc60"
+            },
+            {
+              bump: "minor",
+              title: "Checkbox, radio, and toggle conform to theme tokens",
+              body: "- The last hardcoded control colors (`#FFF`, `#ccc`, `#d0d0d0`, `#e0e0e0`,\n  `rgba(0,0,0,0.2)`) are gone. Chrome now resolves from new option tokens \u2014\n  checkbox `boxColor: 'surface'`; radio `ringColor: 'outline'` / `fillColor:\n  correctly on dark and brand themes.\n- The checkbox's check/dash strokes wear the variant's paired on-color\n  (`on-primary`, `on-warn`, \u2026) instead of assuming white; disabled states use the\n  `disabled`/`on-disabled` tokens; the toggle knob's shadow is the theme's\n  brand-tinted `raised` stack, and its hover uses the button convention's\n  brightness filter instead of a fixed grey.",
+              commit: "8953d59"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-stat` KPI tile",
+              body: '- Muted label + large headline value (numbers auto-compact via\n  `Intl.NumberFormat`: `48234` \u2192 "48.2K") set in a new `stat` type-scale role\n  (32px semibold, proportional figures).\n- Optional signed `delta` whose ink is decided by direction \xD7 `upIsGood` \u2014 churn\n  going down reads green, tickets going up reads red \u2014 with the arrow glyph\n  accompanied by screen-reader "up"/"down" text so state never rides color alone;\n  `caption` names the comparison period.\n- Optional decorative 12-point sparkline (`trend` input): stroke in the outline hue,\n  endpoint dotted in the accent, `aria-hidden`.\n- Fully token-driven via `stat.options`: card-recipe frame (`color`/`border`/\n  `borderRadius`), `labelTypeface`/`valueTypeface`, `positiveColor`/`negativeColor`\n  (the semantic inks, AA-guaranteed on surface), `trendColor`/`trendAccent`, spacing.',
+              commit: "7a6da4f"
+            },
+            {
+              bump: "minor",
+              title: "Fix invisible icons; icons become first-class theme primitives",
+              body: "- **Bug**: `uni-icon` resolves icons from `theme.icons`, but every theme shipped\n  `icons: {}` \u2014 the icon record was never wired in, so all icons (dialog close, button\n  spinner, search/clear affordances) rendered nothing.\n- **Fix + pattern**: the default icon set now lives in core (`BaseIcons`, in\n  `concepts/iconography`) and `createTheme` merges a theme's `icons` over it \u2014 themes\n  can override or add icons under any name (inline SVG data URIs, masked with\n  `currentColor` so they recolor with the theme). The angular `icons` record re-exports\n  `BaseIcons` (deprecated).\n- `uni-icon` also sets the standard `mask-image` (was webkit-only, so icons were\n  invisible in Firefox regardless) and renders nothing for unknown names instead of a\n  broken `url(\"undefined\")`.\n- The emitted `uni-theme.ts` gains an editable `icons` section, and the MCP's\n  `generate-uni-theme` guidance instructs agents: never inline SVG in components \u2014\n  define an icon once in the theme's `icons` map and render it via `<uni-icon>`.",
+              commit: "fea0b2e"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@6.0.0"
+          ]
+        },
+        {
+          version: "5.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "New `uni-avatar` and `uni-avatar-group` components",
+              body: '- Graceful fallback chain: image \u2192 initials derived from `name` (first + last) \u2192\n  themed symbol. Accessible by default: `role="img"` + `aria-label` from the name,\n  `aria-hidden` when purely decorative.\n- Fully token-driven: variants color from the role\'s `*-container` tokens, sizes from\n  the theme\'s `avatar` size records, corner radius from `options.borderRadius`\n  (`max` = circles; a `sharp` theme gets square avatars), initials typeface from\n  `options.typeface`, fallback symbol from `options.fallbackSymbol`.\n- `uni-avatar-group` stacks avatars with a token-driven overlap (spacing token) and\n  separator ring (`ringColor`/`ringWidth` options); `max` collapses the overflow into\n  a themed "+N" chip that is itself a `uni-avatar` (verbatim `text` input).',
+              commit: "1f5ee1d"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-breadcrumb` component",
+              body: '- WAI-ARIA breadcrumb: labelled `nav` landmark wrapping an ordered list, the last item\n  marked `aria-current="page"`, separators decorative (`aria-hidden`).\n- Data-driven `items` (root first). Items with `href` render as real anchors; without\n  one they render as link-styled buttons emitting `itemClicked` for SPA routing.\n- Token-driven via `breadcrumb.options`: `typeface`, link `color`, `currentColor`,\n  `separatorSymbol` (material symbol), and `gap` spacing.',
+              commit: "dca84b1"
+            },
+            {
+              bump: "minor",
+              title: "Button corner rounding and typography conform to component-options tokens",
+              body: "- `button` and `iconButton` themes gain `options: { borderRadius: 'max' }`; the hardcoded\n  per-size pixel radii (11/13/18/24) and the icon button's inline `borderRadius: 999` are\n  removed. Components resolve the token through `theme.radius()`, so the theme's radii\n  scale \u2014 shape languages (`sharp` \u2192 square, `playful` \u2192 pill) and custom radii\n  primitives \u2014 now restyles buttons like every other tokened component.\n- Back-compat: the options radius is applied before theme `sizes`/`fixed` styles, so\n  hand-authored themes that still set a size-level `borderRadius` keep winning; icon\n  buttons fall back to the legacy circle when a theme predates iconButton options.\n- `button` themes also gain `options: { typeface: 'button' }`: the hardcoded\n  `fontFamily: 'Euphemia'` (a font no theme loads) is removed from `fixed` and the sizes;\n  labels now render the type scale's `button` role (Red Hat Display, medium, capitalize),\n  with per-size `fontSize` still applied by `sizes`. Point the token at any typography\n  role \u2014 including custom ones \u2014 to restyle every button label.\n- New `UniButtonOptions` interface (`borderRadius`, `typeface`) exported from the button\n  model.",
+              commit: "7844dde"
+            },
+            {
+              bump: "minor",
+              title: "Card frame conforms to token primitives",
+              body: "- The card theme's hardcoded frame (`borderStyle`/`borderWidth`/`borderRadius: '8px'` in\n  `fixed`, `borderColor` per variant) is replaced by tokens: the card resolves its border\n  from the **border primitive named by its variant** (`borders.primary` \u2026\n  `borders.success`), its corner radius from the radii scale (`options.borderRadius:\n- `UniCardOptions` gains `border` (pin every card to one primitive \u2014 including a custom\n  one \u2014 instead of variant-following) and documents the existing `borderRadius`/\n  `elevation`; redefining a border primitive in a theme now restyles cards and every\n  other component sharing that token.\n- Token styles apply under the merged theme style, so hand-authored themes that still\n  set card `fixed`/`variants` frame styles keep winning. No visual change for default\n  themes \u2014 this is pure tokenization.",
+              commit: "7844dde"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-drawer` and `uni-app-bar` \u2014 the dashboard shell",
+              body: '- **`uni-drawer`** has two modes sharing one content slot: `side` renders an in-flow\n  `<aside>` that pushes content (width-animated open/close, divider border primitive at\n  its edge, `aria-hidden` while closed); `over` renders a native `<dialog>` in the top\n  layer \u2014 focus trap, Escape, and scrim backdrop come from the platform, sliding in\n  from `position` (`start`/`end`). `open` is a two-way `model()`; Escape and backdrop\n  clicks keep it in sync. Tokens: `drawer.options` (`color`, `width`, `divider`,\n  `elevation`, `padding`, `backdrop`).\n- **`uni-app-bar`**: leading/trailing content projection slots around a `title` (or\n  custom center content), trailing pushed to the far edge; optional `sticky`. Tokens:\n  `appBar.options` (`color`, `height`, `divider`, `typeface`, `padding`, `gap`,\n  optional `elevation`).\n- The Drawer "DashboardShell" story documents the composition recipe: app bar with a\n  menu toggle + side drawer + content.',
+              commit: "17cf662"
+            },
+            {
+              bump: "minor",
+              title: "Progress gauge derives from the palette instead of hardcoded pastels",
+              body: "The gauge's track colors were fixed pastel hexes (`#b3d4ea`, `#b3e7c2`, \u2026) that ignored\nthe active theme entirely \u2014 secondary and success even shared the same green. Tracks now\nuse the role's `*-container` token (the palette's soft tint of that role) and arcs the\nrole base, so gauges follow any brand palette, in both light and dark modes.",
+              commit: "7844dde"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-skeleton` loading placeholder",
+              body: "- Three shapes: `text` (multi-line, ending on a short line like real copy), `rect`,\n  and `circle`; explicit `width`/`height` accept CSS strings or px numbers.\n- Painted with surface tokens (`skeleton.options`: `color`, `highlightColor`,\n  `borderRadius`, `gap`) so placeholders sit naturally on light and dark themes; the\n  shimmer sweep (`animation`/`duration` options) only runs when the user allows motion\n  and degrades to static blocks under `prefers-reduced-motion`.\n- `aria-hidden` \u2014 placeholders are invisible to assistive tech by design.",
+              commit: "4ccf18b"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-slider` component \u2014 clears the declared-but-unbuilt `ComponentName` entry",
+              body: '- Native `<input type="range">` under the hood: platform keyboard interaction\n  (arrows, Home/End, Page Up/Down) and ARIA slider semantics for free; Signal Forms\n  contract (`FormValueControl<number>`) matching Input/Textarea.\n- `min`/`max`/`step` inputs (fractional steps supported), required accessible `label`.\n- Token-driven via `slider.options`: fill/thumb `color`, `trackColor`, `borderRadius`,\n  and geometry (`trackHeight`, `thumbSize`). The fill level rides a CSS custom\n  property, so dragging never regenerates Emotion styles; Firefox uses the native\n  `::-moz-range-progress`, WebKit a gradient stop.',
+              commit: "5d9062a"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-tabs` / `uni-tab` components",
+              body: "- Full WAI-ARIA tabs pattern: `tablist`/`tab`/`tabpanel` roles with wired\n  `aria-selected`/`aria-controls`/`aria-labelledby`, roving tabindex, automatic\n  activation on ArrowLeft/ArrowRight (wrapping, disabled tabs skipped), Home/End,\n  and motion-safe transitions.\n- `selectedIndex` is a two-way `model()`; selection snaps to the nearest enabled tab.\n  Panel content is captured per-tab and only the selected panel is instantiated.\n- Every visual knob is a theme option token (`tabs.options`): `typeface`, `textColor`,\n  `activeTextColor`, `indicatorColor`, `indicatorThickness` (thickness token),\n  `divider` (border primitive), `gap`/`padding` (spacing tokens), `borderRadius`, and\n  optional `activeColor` \u2014 the defaults render underline tabs; `borderRadius: 'max'` +\n  `activeColor` turns them into segmented pills with no component changes.",
+              commit: "15a8f73"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-textarea` component",
+              body: "- Multi-line text field with the same Signal Forms contract as `uni-input`\n  (`FormValueControl<string>`: `value` model, `disabled`/`invalid`/`dirty`/`required`,\n  touched-aware error styling, `aria-*` wiring).\n- Reuses `uni-input-box` for its chrome, so it inherits the input's themed color,\n  border, typeface, focus outline, and disabled treatment automatically; the box's\n  field selectors now cover `textarea` (with auto height and vertical padding), and\n  the box accepts a `height` override.\n- Theme options follow the token pattern: `textarea: { options: { rows: 3, resize:\n  instance.",
+              commit: "b04b97b"
+            },
+            {
+              bump: "minor",
+              title: "Theme Builder becomes the full playground (PRD \xA75.2)",
+              body: "- **Light & dark side by side**: both palettes generate on every input change,\n  independent of the storybook-wide mode toggle, each rendered in its own panel.\n- **Contrast report panel**: live pass/fail matrix over all checked pairs (summary +\n  failing rows always visible, full detail on demand). Failures only occur with hard\n  brand pins; the panel says so and points at soft targets.\n- **Shape language input** (`sharp`/`modern`/`playful`): applies `ShapeRadii` live via\n  the new `radii` pass-through on `BrandPaletteConfig`/`createThemeFromPalette`.\n- **Export paths**: copy the static `uni-theme.ts` (via `emitThemeFile`), copy a\n  pre-encoded `ng add` command, or copy W3C DTCG JSON for both modes via the new\n  `emitDtcgTokens()` interop emitter in uni-core (Style Dictionary compatible).",
+              commit: "8f55b4c"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "5.1.0",
+          entries: [
+            {
+              bump: "patch",
+              title: "Fix `ng add` against real published packages (found by fresh `ng new` e2e):",
+              body: '- The schematic bundle is CJS, but ng-packagr stamps `"type": "module"` into the\n  published package.json, so Node loaded it as ESM and the CLI reported "no ng add\n  actions". A nested `schematics/package.json` (`"type": "commonjs"`) scopes the\n  bundle back to CJS.\n- The emitted `uni-theme.ts` used dot access on `Colors` (which has an index\n  signature), failing under `ng new`\'s strict `noPropertyAccessFromIndexSignature`.\n  The emitter (and the MCP tool\'s guidance) now uses bracket access throughout.\n- `uni-angular`\'s peer range on `uni-core` is now `workspace:^` (publishes as `^5.x`)\n  instead of `workspace:*` (published as an exact pin). Alongside changesets\'\n  `onlyUpdatePeerDependentsWhenOutOfRange`, this stops minor releases from being\n  inflated to majors by the peer-dependents rule \u2014 the cause of the 4.0.0 and 5.0.0\n  version jumps.',
+              commit: "f2951db"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "5.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "OKLCH theme generation engine (`concepts/generation`)",
+              body: "- New `generateThemes(input)` / `generateUniThemes(input)`: brand seed(s) in, complete\n  WCAG-AA light+dark `Colors` pair out, with a machine-readable `ContrastReport`\n  (110 checked pairs per theme pair). Pure and deterministic.\n- All palette math moved from HSL to perceptual OKLCH: uniform lightness slots across\n  hues, per-category chroma model (`CategoryChroma`), dark-mode accent chroma decoupling\n  (C \u2264 0.16), and a contrast guard-rail that adjusts lightness only \u2014 never hue.\n- Brand colors ride as soft `targets` (kept verbatim when already AA, lightness-adjusted\n  when not) alongside the existing hard `brand` pins; accepted by `generatePalette`,\n  `createThemeFromPalette`, and Angular's `BrandPaletteConfig`.\n- Semantic inks re-tuned per role: error 27\xB0/C 0.20, warn 55\xB0/C 0.18 (rotated off amber \u2014\n  dark yellow reads brown), success 152\xB0/C 0.16.\n- `createTheme` accepts optional `radii`/`shadows` overrides; `ShapeRadii` presets\n  (`sharp` / `modern` / `playful`) emitted via the `shape` generation input.\n- Theme Builder ships nine curated AA-clean presets built on soft targets.\n- Deprecated (thin wrappers/tables retained): `uniColor`, `randomRangeValue`,\n  `CategorySaturation`, `CategoryLightness`. `schemeHues` moved to `color.utils`.\n- `createTheme` deep-merges optional `borders` and `components` overrides over its\n  derived defaults \u2014 themes can define custom named primitives and rewire per-component\n  options without restating untouched sections.\n- New `emitThemeFile()` renders a static `uni-theme.ts` \u2014 literal colors, visible border\n  primitives, sparse component overrides \u2014 the editable source of truth; the engine\n  never ships to the browser.\n- New `ng add @uni-design-system/uni-angular` schematic: installs the peer set, writes\n  the generated theme file, registers `UNI_THEMES` in `app.config.ts`, adds typeface\n  links, scaffolds a themed smoke test, and prints the contrast summary.\n- New MCP tool `generate-uni-theme`: returns the static theme file content, provider\n  snippet, and contrast report, with agent guidance to edit the file for restyling.\n- `uni-core` gains its first Vitest suite, including a 1,080-seed contrast property\n  corpus with zero tolerance in both modes; the schematic gets its own spec suite.",
+              commit: "f7f0bdd"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@5.0.0"
+          ]
+        },
+        {
+          version: "4.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Porting Components",
+              body: "",
+              commit: "ef9b3b5"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@4.0.0"
+          ]
+        },
+        {
+          version: "3.0.2",
+          entries: [
+            {
+              bump: "patch",
+              title: "Extending the Symbol component to support theme options.",
+              body: "",
+              commit: "dcaf166"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@3.0.2"
+          ]
+        },
+        {
+          version: "3.0.1",
+          entries: [
+            {
+              bump: "patch",
+              title: "Exporting new components and formatting.",
+              body: "",
+              commit: "fabbb73"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@3.0.1"
+          ]
+        },
+        {
+          version: "3.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Exporting Components, Themes, and CDK",
+              body: "",
+              commit: "54a945c"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@3.0.0"
+          ]
+        },
+        {
+          version: "2.0.4",
+          entries: [
+            {
+              bump: "patch",
+              title: "Exporting multiple Angular Components",
+              body: "",
+              commit: "ad5dd15"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.4"
+          ]
+        },
+        {
+          version: "2.0.3",
+          entries: [
+            {
+              bump: "patch",
+              title: "fix: setting dist directory in publishConfig",
+              body: "",
+              commit: "eb80cff"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.3"
+          ]
+        },
+        {
+          version: "2.0.2",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.2"
+          ]
+        },
+        {
+          version: "2.0.1",
+          entries: [
+            {
+              bump: "patch",
+              title: "Setting Fixed Versioning for all packages.",
+              body: "",
+              commit: "be0fb26"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.1"
+          ]
+        },
+        {
+          version: "2.0.0",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@1.1.0"
+          ]
+        },
+        {
+          version: "1.0.0",
+          entries: [
+            {
+              bump: "major",
+              title: "init release",
+              body: "",
+              commit: "7d18157"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@1.0.0"
+          ]
+        }
+      ]
+    },
+    {
+      package: "@uni-design-system/uni-core",
+      releases: [
+        {
+          version: "8.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "`createTheme` accepts a sparse `typography` override, deep-merged over the base type scale \u2014 restate only the roles (or the individual `TextStyle` fields within a role) that change, and add product-specific roles under any name. Closes the gap where a derived theme (e.g. the Carbon experiment) had to spread `typography` over the created theme by hand.",
+              body: "",
+              commit: "57a8c4c"
+            },
+            {
+              bump: "minor",
+              title: "Input options: `typeFace` \u2192 `typeface`, matching the tooltip/button/tabs casing. The base theme now writes `typeface`, and the input box reads the new key with the old one as a deprecated fallback, so themes that still set `typeFace` render unchanged. The `typeFace` key is deprecated and will be removed in the next major.",
+              body: "",
+              commit: "57a8c4c"
+            },
+            {
+              bump: "patch",
+              title: "Ship `CHANGELOG.md` in the published packages. The release notes existed only in the repo; an installed package carried no record of what changed, so upgrade questions couldn't be answered from `node_modules`. uni-angular copies it into the ng-packagr `dist` via `assets`; the rest add it to `files`.",
+              body: "",
+              commit: "e706e38"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "8.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Calendar, date & time entry: `uni-calendar`, `uni-date-input`, `uni-time-input` and `uni-date-time-input`, plus a pure datetime helper layer in the cdk.",
+              body: "The most-requested form control family anywhere, built native-platform-first with zero runtime dependencies: `Intl` does all formatting and parsing (no date library), the popup rides the native popover top layer with CSS anchor positioning, and every day in the grid is a real `<button>`.\n- **Values are plain ISO strings, never `Date`s** \u2014 `UniDate` (`'YYYY-MM-DD'`), `UniTime` (`'HH:mm'`, always 24-hour), `UniDateTime` (`'YYYY-MM-DDTHH:mm'`), `UniDateRange` (`{ start, end }`). A `Date` is a timestamp with a timezone problem; a calendar date is a label on a wall calendar. Strings are timezone-free, JSON-serializable and sortable with `<`, and `[value]=\"'2026-08-20'\"` is a complete, correct binding.\n- **`uni-calendar`** is an inline month grid and a form control in its own right: single and range modes in one component (the value shape switches with `mode`), availability **markers** with screen-reader labels, `minDate`/`maxDate` fences, `disabledDates` as a list or predicate, and a two-way `month` model so an app can drive \"jump to June\". One tab stop with a roving-tabindex `role=\"grid\"`; the full APG keyboard map (arrows, week `Home`/`End`, `PageUp`/`PageDown` with `Shift` for years) crosses month edges, skips disabled days directionally, and stops at fences without wrapping. Range selection paints a live preview band, swaps a backwards commit instead of erroring, and narrates every step through a `role=\"status\"` region.\n- **`uni-date-input`** is free-typed date entry \u2014 no input mask (masks fight paste, IMEs and screen-reader echo). The parser accepts ISO, locale-numeric text with the digit order read from `Intl.DateTimeFormat(locale).formatToParts()`, and the locale's own month names; a missing year resolves to the next occurrence and two-digit years are refused rather than guessed. Unreadable, fenced or unavailable text **stays in the field**, flagged, with a `rejected` event. The popup is the same `uni-calendar`, hosted in a `role=\"dialog\"` popover via the shared `uni-dropdown`; `\u2191`/`\u2193` on a committed value step \xB11 day.\n- **`uni-time-input`** is a combobox over time slots \u2014 byte-for-byte the search-input/tag-input listbox contract via the CDK's `ListboxNavigation`. `9` \u2192 09:00, `930` \u2192 09:30, `3p` \u2192 15:00, and a bare `3` leans PM in a 12-hour field (the bias yields when `minTime`/`maxTime` say otherwise). `slots` pins the choices for scheduling, refusing a typed `5pm` as `'unavailable'`; `\u2191`/`\u2193` on a committed value step \xB1`minuteStep`.\n- **`uni-date-time-input`** seats both parts in one `uni-input-box` chrome under one `role=\"group\"` label, emitting one combined value only when both parts are set. `slotsFor` is the scheduling flow in one attribute: the time part stays disabled until a day is chosen, then offers exactly that day's slots, and changing the day clears a slot that no longer exists. The parts gained an `embedded` input so the composer renders one shared box instead of nested chrome.\n- **cdk `datetime` module** (public export): the string-math and `Intl` layer \u2014 `addDays`/`addMonths`/`buildMonthGrid`/`parseDateText`/`parseTimeText`/`timeSlots`/`localeWeekStart` and friends \u2014 pure functions, unit-tested hard, usable by apps directly.\n- **uni-core**: `'calendar'`, `'dateInput'`, `'timeInput'`, `'dateTimeInput'` join `ComponentName` with base-theme entries (day geometry per size token, `dayBorderRadius: 'xxs'` for the square look, toggle glyphs, popup/list chrome). Selection, range and today colours are deliberately not options \u2014 they are the `primary` role pair, so themes restyle them by restyling the palette.\n- **Naming note:** the fences are `minDate`/`maxDate`/`minTime`/`maxTime`/`minDateTime`/`maxDateTime` rather than the platform's `min`/`max`, because Signal Forms' `FormUiControl` reserves `min`/`max` as numeric signals on form controls.",
+              commit: "71bc74c"
+            },
+            {
+              bump: "minor",
+              title: "Themable focus chrome: a shared `focusRing` primitive for every control, plus `focusBorder`/`focusShadow`/`focusColor` options for input boxes.",
+              body: "**Shared focus ring.** A theme can now restyle the keyboard-focus indicator across the whole library by defining `focusRing` **border** and/or **shadow** primitives: `ThemeService.focusRing()` (and the new selector-less `focusRingStyle()`) replaces its default 2px outline with that border \u2014 drawn as an outline hugging the control \u2014 plus the ring shadow. A `focusRing` **thickness** primitive sets the ring's outline offset (negative values overlay the control's resting border, reading as a border-color change). Checkbox, radio, toggle and slider now route their hand-rolled focus styles through the shared helper (calendar days and tag chips already did), so one primitive trio gives every control the same focus language. Themes without the primitives render exactly as before.\n\n**uni-core:** `Thicknesses` is now an open record like `Borders`/`Shadows` (extra named primitives allowed), and `createTheme` accepts a sparse `thicknesses` override merged over the base scale.\n\n**Also in this release:**\n- Radio and toggle scope their transitions (border/background/transform) instead of `all`, so the focus ring's outline and shadow apply instantly \u2014 `transition: all` interpolated the outline from a stale color, flashing a dark ring before the themed ring color landed.\n- The radio's dot grow/retract animation is a token \u2014 `radio.options.transitionSpeed` (seconds, default 0.3 preserving the current feel; 0 switches instantly).\n- The checkbox focus ring rounds proportionally again (box radius plus its gap) and the gap itself is a new `checkbox.options.focusRingGap` option; a `focusRingStyle` call's explicit gap wins over the theme's `focusRing` thickness, then the branch defaults.\n\nThe `input` component options could previously restyle focus only through `focusOutline`/`focusOutlineOffset`. The new optional trio mirrors the error-state trio (`errorBorder`/`errorShadow`/`errorColor`) and applies while any projected control has focus: `focusBorder` swaps the border primitive, `focusShadow` draws a ring (e.g. a soft `0 0 0 3px` spread), and `focusColor` swaps the background. All three default to `undefined`, so existing themes render exactly as before, and they yield to the error state so a flagged field stays visibly flagged while being corrected.\n\nThe Wellsourced showcase theme now defines the `focusRing` pair for its app's `.search-input:focus` look \u2014 an ochre (`secondary`) 1px border with a 10% ring of the same hue, tinted per palette in light and dark \u2014 so text fields (which rest on a canvas tint and snap to the clean surface on focus), checkboxes, radios, toggles, sliders, calendar days and tag chips all share one focus treatment.",
+              commit: "1a6b382"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "8.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Menu items no longer look preselected when opened with the mouse",
+              body: "Opening a `uni-menu` by click left the first item highlighted before the\npointer had touched it, reading as a preselected default. Two correct\nbehaviours combined badly: `onOpened()` implements ARIA roving focus by calling\n`.focus()` on an item every open, and the item styles deliberately painted\n`:focus` the same as `:hover`. Nothing was wrong with the focus itself \u2014 only\nwith painting it after a pointer open.\n- **The highlight now keys on `:focus-visible`.** Programmatic focus following a\n  click doesn't match it, while keyboard-driven focus does \u2014 so mouse users get\n  no phantom highlight, and keyboard users keep the focus cursor. Roving-focus\n  bookkeeping is untouched: a mouse open still moves focus to the first item, so\n  screen readers announce it exactly as before.\n- **New `HOVER_OR_KEYBOARD_FOCUS` constant exported from uni-core**, holding\n  that selector. Emotion merges styles by _exact selector text_, so a component's\n  base rule and any theme variant restyling it have to agree character for\n  character \u2014 a variant keyed `'&:hover, &:focus'` would both fail to override\n  and reintroduce the phantom highlight. Naming the selector once removes the\n  trap; the base theme's `menuItem.warn` tone and the Carbon/Wellsourced\n  showcase themes now use it.\n\nThemes with their own `menuItem` variants should key the highlight with\n`HOVER_OR_KEYBOARD_FOCUS`. Note that `:focus-visible` is a browser heuristic:\nafter a user has been navigating by keyboard, a subsequent click may still show\nthe highlight, which is the intended \"this person is using the keyboard\"\nbehaviour rather than a regression.",
+              commit: "3279186"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-tag-input`, plus a shared listbox contract in the CDK",
+              body: 'The type-to-add chip field \u2014 recipients, filters, labels. It is the **open-set**\ncontrol: anything typed can become a token, whether or not it matches a\nsuggestion. Closed-set picking stays with `uni-select` /\n`uni-multi-select-dropdown`, which is the deliberate split \u2014 the two look alike\nbut differ on the one thing that decides the value type, so a single component\nwould force one of them to carry an API it can never use.\n- **`FormValueControl<UniTagItem[]>`.** `{ value: \'a@b.com\' }` is a complete\n  item; `label`, `avatarSrc`, `invalid` and `disabled` are optional enrichment.\n- **Invalid entries stay in the value, flagged**, rather than being dropped \u2014 a\n  field that silently swallows a typo\'d address is worse than one that shows it\n  in red, and Enter on the chip lifts it back into the input to fix. Duplicates\n  and over-`max` entries are refused through `(rejected)` with a reason.\n- **Full keyboard contract**: separators commit, Tab commits without trapping,\n  Backspace on an empty field _focuses_ the last chip rather than deleting it\n  blind, and on a chip Backspace and Delete both remove but move focus in\n  opposite directions \u2014 what makes pruning a list feel right.\n- **The whole field is one tab stop.** Chips carry `tabindex="-1"`, so Tab never\n  walks through eight recipients to reach the next control.\n- **Announces through a `role="status"` live region** on every add, remove and\n  rejection; the removal route is described once per field rather than by every\n  chip.\n- **`preset="email"`** wires an address validator, a paste parser that unwraps\n  `Name <a@b.com>` and keeps an unterminated tail in the field, and Space as a\n  separator.\n- **`\'tagInput\'` joins core\'s `ComponentName`** with a theme entry for the chip\n  field\'s own tokens. Field chrome is not duplicated \u2014 it comes from `input` via\n  `uni-input-box`, so a tag input restyles with every other field.\n\n**Also in this release**\n- **`ListboxNavigation` in the CDK** (`createListboxNavigation`) owns the\n  combobox bookkeeping every type-ahead control needs: open state, active\n  option, wrap-around arithmetic, Home/End, and `aria-activedescendant` wiring\n  that can never point at an option a narrowing filter has removed.\n  `uni-search-input` now uses it \u2014 behaviour unchanged, and it gains Home/End\n  for free \u2014 and the multi-select combobox upgrade will too. Three hand-rolled\n  copies of one keyboard contract is how they drift.\n- **`uni-tag` gains `controlTabIndex`**, so a composite that owns its own roving\n  focus can take its chips out of the tab order, and **`selected` is now\n  optional**: an interactive chip carries `aria-pressed` only when it is\n  genuinely a toggle. Announcing "not pressed" on a recipient chip is worse than\n  announcing nothing.',
+              commit: "de83fe4"
+            },
+            {
+              bump: "minor",
+              title: "`uni-tag` v2: themable, opt-in removal, two style axes",
+              body: "v1 was a single hardcoded look with the palette welded into its template, an\nunconditional remove button, and no theme entry \u2014 a filter chip, a status pill\nand a recipient token all rendered identically. v2 makes the chip a real themed\ncomponent and the building block `uni-tag-input` composes.\n\n**Breaking (uni-angular)**\n- **`(close)` is now `(removed)`.** The old name shadowed the native `close`\n  event and needed an eslint suppression to compile.\n- **The remove button is opt-in** \u2014 set `[removable]=\"true\"`. Previously every\n  tag, including a plain category label, shipped a \"Remove \u2026\" button into the\n  accessibility tree.\n- Codemod: rename `(close)` \u2192 `(removed)` and add `[removable]=\"true\"` wherever\n  a `(close)` handler exists.\n\n**Fixed**\n- **A falsy value can now be removed.** `handleClose` guarded with `if (v)`, so\n  a tag keyed `''` or `0` silently could not be dismissed. Every defined value\n  emits, and a tag with no value emits `undefined`.\n- The remove control now sizes from the chip instead of the icon-button's own\n  `sm` size \u2014 it was 22px inside a 24px chip, and taller than an `sm` chip\n  entirely.\n\n**New**\n- **Two orthogonal style axes**: `variant` picks the colour role, `tone` picks\n  the archetype (`soft` / `solid` / `outline`). Both resolve from the new `tag`\n  theme entry, with tones as nested `&.tone-*` selectors inside each variant so\n  a theme author restyles both axes in one place.\n- **`'tag'` joins core's `ComponentName`**, with a `TagTone` type and a full\n  theme entry (`options` for radius/typeface/gap/symbols, `variants` per colour\n  role, `sizes` carrying geometry only).\n- **`interactive`** turns the chip body into a `<button>` with `selected` mapped\n  to `aria-pressed`, keeping the remove control a sibling \u2014 nesting them would\n  be invalid HTML and would strand the inner control for keyboard users.\n- **Lead slot**: `avatarSrc`, `avatarName` (initials fallback), `iconName`,\n  `symbolName` and `dot` convenience inputs, plus a `[tag-lead]` slot for\n  anything richer. Lead elements size from the chip height, and all are\n  `aria-hidden` so the chip's text stays its accessible name.\n- **Glyphs are theme icon primitives, not Material ligatures.** The remove and\n  selected affordances resolve through the new `removeIcon` / `selectedIcon`\n  theme options (defaulting to the built-in `close` and `check`), so they mask\n  `currentColor`, recolour with the chip's tone, and can be swapped per theme.\n  They also contribute no text to the DOM, which a ligature does \u2014 one less way\n  for an accessible name to be polluted. `symbolName` remains as the escape\n  hatch for glyphs the theme's icon set doesn't carry.\n- **`invalid`** sets `aria-invalid` and a dashed underline, so the state does\n  not rely on colour alone (WCAG 1.4.1); `disabled`, `maxWidth` truncation with\n  a `title`, and `removeLabel` for overriding the remove button's name.\n- The component ships with 21 specs, having previously had none.",
+              commit: "760b761"
+            },
+            {
+              bump: "minor",
+              title: "Theme validation contract: `parseTheme` / `assertTheme` / `isUniTheme`",
+              body: "Every theme scale is `Partial<Record<\u2026>>`, so a malformed theme \u2014 hand\nwritten, generated, or fetched as JSON \u2014 rendered as silent `undefined` CSS\nwith no diagnosis. Core now ships a **dependency-free** structural validator\n(core stays zero-dep; no zod outside the MCP):\n- **`parseTheme(input): ThemeParseResult`** collects every issue rather than\n  failing fast: `{ success, theme?, issues: [{ path, message }] }` with dotted\n  paths like `colors.primary` or `typography.label.fontSize`. Acceptance /\n  rejection **with reasons** is the API.\n- **`assertTheme(input)`** throws with all reasons; **`isUniTheme`** is the\n  type-guard form; **`formatThemeIssues`** renders issues for logs.\n- The contract requires what components can't render without: 16\n  `REQUIRED_COLOR_TOKENS`, all 22 canonical `REQUIRED_TEXT_ROLES` (with\n  `fontFamily`/`fontSize`/`lineHeight`), the spacing/radii/shadow/thickness\n  scale keys, and recursively-valid component style expressions. All\n  `REQUIRED_*` sets are exported for tooling (MCP, docs, registries). Themes\n  remain free to add arbitrary named primitives on every scale.\n- Because a `UniTheme` is plain serializable data, the same contract\n  validates JSON round-trips \u2014 the foundation for theme distribution and\n  runtime theme registries (ROADMAP Track 1).",
+              commit: "6a4c7da"
+            },
+            {
+              bump: "minor",
+              title: "A wire format for themes: `hydrateTheme` / `dehydrateTheme`",
+              body: "A `UniTheme` is plain serializable data, which makes JSON the natural transport\nfor distributing themes \u2014 but a serialized theme is ~50 KB and **~71% of that is\nthe 61 built-in icon data URIs that every uni-core consumer already ships**.\n- **`dehydrateTheme(theme)`** returns the wire form: icons identical to\n  `BaseIcons` are dropped, genuine overrides kept. A theme goes from ~50 KB to\n  ~14 KB, and still passes `parseTheme`.\n- **`hydrateTheme(theme)`** restores the built-in set on the way in, applying\n  the same `{...BaseIcons, ...icons}` contract `createTheme` applies at\n  construction \u2014 the theme's own icons win, built-ins fill the rest.\n- **`generateUniThemes` now returns the `ContrastReport`** alongside the\n  light/dark pair, so a caller can generate registration-ready themes and their\n  WCAG audit in one call instead of falling back to `emitThemeFile` (which\n  returns TypeScript source) just to see the report.\n- **`summarizeContrast(report)`** is extracted and exported, so the generated\n  theme file's header and every other consumer word the audit identically.",
+              commit: "5414517"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.3.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "`expand` gains a themable, size-aware speed",
+              body: "The reveal/collapse duration was hardcoded at 350ms, so a consumer wanting a\nsnappier disclosure \u2014 or wanting adjacent styling to fade on the same clock \u2014\nhad nothing to reference. A fixed duration also reads differently at different\nsizes: sluggish on a two-line region, rushed on a full-page one.\n- **New `transitionSpeed` option in the `expand` theme options** (seconds,\n  default `0.35`, matching alert/card `transitionSpeed`) sets the base\n  duration. `'expand'` joins core's `ComponentName` union, so custom and\n  derived themes can type an `expand` entry.\n- **Duration scales with content height.** The actual duration is\n  `transitionSpeed \xD7 \u221A(height \xF7 240px)`, clamped to ~0.15\u20130.6s at the default\n  speed (the envelope scales proportionally with a themed speed), so perceived\n  speed stays steady across region sizes. The curve and its constants\n  (`expandDuration`, `EXPAND_DEFAULT_SPEED`, `EXPAND_MIN_DURATION`,\n  `EXPAND_MAX_DURATION`, `EXPAND_REFERENCE_HEIGHT`) are exported from\n  uni-core.\n- **New per-instance `transitionSpeed` input** sets an exact duration for one\n  region, bypassing the scaling: `<uni-expand [transitionSpeed]=\"0.15\">`.\n- **The resolved duration is exposed as the public `duration` signal** on\n  `uni-expand`, so adjacent styling can move on the reveal's clock with a\n  plain binding \u2014 `[style.transition-duration]=\"expand.duration() + 's'\"` \u2014\n  keeping all timing in the theme/signal pipeline, with no custom CSS.\n- **`expand-toggle` gains a matching `transitionSpeed` input** and otherwise\n  follows the theme token instead of its own hardcoded 350ms. Expand Area\n  binds the region's resolved `duration` to its toggle, keeping chevron and\n  reveal on one clock even when size-scaled or overridden.\n- **Speed is theme-reactive**: swapping themes at runtime retimes regions and\n  chevrons live.\n- **Enter/leave easing is now `ease-in-out`** (was `ease-in`), matching the\n  chevron rotation so trigger and region decelerate together.\n- **`UniExpandOptions` is exported** from uni-angular for\n  `getComponentOptions<UniExpandOptions>('expand')` consumers.",
+              commit: "c828982"
+            },
+            {
+              bump: "minor",
+              title: "Menus join the theme model: `menu` + `menuItem` component options, item tones, and dividers",
+              body: "The menu was the only composite component with no theme surface of its own \u2014\npanel chrome came from the shared `dropdown` entry and every item-level knob\n(height 38, `primary-container` hover, `check` active symbol, `label` type\nrole) was hardcoded. Every Uni menu therefore looked identical, and the gaps a\nreal product hits first (a red Delete, a separator before it, disabled rows)\nwere only reachable via `::ng-deep`.\n- **New `menu` theme options** (`'menu'` joins core's `ComponentName` union):\n  `minWidth`, panel `color`/`border`/`borderRadius`/`shadow` (each falling\n  back to the `dropdown` options when unset, so menus follow generic popovers\n  until a theme deliberately splits them), `paddingVertical`/\n  `paddingHorizontal` (panel inset \u2014 `xs` inset plus item `borderRadius`\n  yields the \"hover pill\" look; `none` yields full-bleed rows), and\n  `dividerBorder`/`dividerSpacing` for separators.\n- **New `menuItem` theme options + variants** (`'menuItem'` joins\n  `ComponentName`): `height`, `paddingHorizontal`, `gap`, `borderRadius`,\n  `typeface`, `textColor`, `hoverColor`, `activeSymbol` (undefined removes the\n  trailing check), and `transitionSpeed`. Theme `variants` on `menuItem` carry\n  tones \u2014 the base theme ships a `warn` tone for destructive actions.\n- **`MenuItem` grows `variant`, `disabled`, and `{ divider: true }`.**\n  `variant: 'warn'` routes through the theme's `menuItem` variants; `disabled`\n  items render in the disabled color, carry `aria-disabled`, and are skipped\n  by keyboard navigation; dividers render as `role=\"separator\"` rules styled\n  by the `menu` options. `isDivider` and the `UniMenuOptions`/\n  `UniMenuItemOptions` interfaces are exported from uni-angular.\n- **`uni-dropdown` panel chrome is now input-overridable**\n  (`border`/`borderRadius`/`shadow`/`color`), falling back to the `dropdown`\n  theme options \u2014 this is the mechanism `uni-menu` uses; other consumers are\n  unchanged.\n- **Default-rendering change:** menus now have `minWidth: 184` from the base\n  theme (previously they sized to the widest item). All other defaults\n  reproduce the previous look, including the 0.35s hover transition.\n- **The Carbon experiment themes gain menu styling** (sharp full-bleed 40px\n  rows, IBM Plex, `$layer-hover`, red danger option, ~110ms motion) with a new\n  Carbon Menu story demonstrating that the same component renders both\n  aesthetics untouched.",
+              commit: "6e8b429"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Add `funnel` and `building` icons",
+              body: 'Two gaps found while migrating a real app off inline SVG \u2014 both cases where the\nexisting set forced the app to keep hand-drawn artwork.\n- **`funnel`** (`filter_alt`) \u2014 `filter` is `filter_list`, the stacked-lines\n  metaphor. Apps that name the feature itself a funnel ("Funnel Analytics") draw\n  the shape, and substituting stacked lines loses the reference.\n- **`building`** (`apartment`) \u2014 pairs with `home` for residential-vs-commercial\n  distinctions, which had no built-in counterpart.\n\nBoth are Material Symbols Outlined 300 on the shared `0 -960 960 960` grid, so\nthe set is now 61 icons. Note `building` carries more internal detail than most\nof the set; it reads well from ~14px but goes muddy below ~12px, so prefer a\nlarger size or `home`\'s simpler silhouette in very small badges.',
+              commit: "e72ec94"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Expand `BaseIcons` to 59 icons and add `uni-icon` sizing",
+              body: "The 34-icon set shipped in 7.0.0 covered the library's own components but not a\nreal application \u2014 an app migrating off inline `<svg>` (or off `uni-symbol`, in\nAngular) ran out of names almost immediately. Everything here is additive; all\n34 existing names are unchanged.\n- **25 new icons**, same Material Symbols Outlined 300 source and the same\n  `0 -960 960 960` grid as the rest of the set: navigation (`link`, `expand`,\n  `gridView`, `listView`), actions (`moreHorizontal`, `copy`, `send`,\n  `refresh`, `dragHandle`, `qrCode`), feedback (`star`, `verified`) and\n  user/system (`group`, `shieldPerson`, `clock`, `mail`, `chat`, `image`,\n  `document`, `payment`, `bank`, `trendingUp`, `extension`, `webhook`,\n  `logout`).\n  - `moreHorizontal` ships alongside `more` because that one is `more_vert` and\n    row-aligned menus need the horizontal kebab.\n  - `star` is separate from `favorite`, which is the heart.\n- **`uni-icon` gains an optional `size` input** (`CssLength` \u2014 bare numbers are\n  px, strings pass through, so `20` and `'1.25rem'` both work). Left unset,\n  behaviour is unchanged: the icon fills its container, which is what lets a\n  themed control size its own glyph through padding. Set, it applies\n  width/height as inline styles, so an explicit size wins over the\n  fill-the-container rule regardless of style injection order. This removes the\n  per-call-site `width`/`height` CSS rule that replacing an inline `<svg>` with\n  `<uni-icon>` would otherwise need.\n- The MCP `create-icon-tokens` tool now lists the built-in icon names above the\n  token map it returns. Apps routinely hand-draw their own `close`, `check` or\n  `plus`; encoding those into theme tokens works but adds redundant artwork on a\n  foreign grid when the theme already ships the glyph. The tool cannot recognise\n  a shape, so it hands the caller the list to check against before adding\n  anything.",
+              commit: "c2421c0"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "7.0.0",
+          entries: [
+            {
+              bump: "major",
+              title: "Replace `BaseIcons` with a normalized 34-icon Material Symbols set",
+              body: "The built-in icon set was 11 glyphs drawn from four different grids\n(`0 0 24 24`, `0 0 50 50`, `0 0 64 64`, `0 -960 960 960`), so `checkCircle` and\n`xCircle` rendered as solid filled discs next to a hairline `alertCircle` and an\noversized `close` \u2014 three optical weights in one set.\n- `BaseIcons` is now Material Symbols Outlined at weight 300, every glyph on a\n  single `0 -960 960 960` grid, grouped by intent: navigation (`menu`,\n  `chevronUp/Down/Left/Right`, `arrowLeft/Right`, `home`, `externalLink`),\n  actions (`search`, `close`, `plus`, `minus`, `more`, `delete`, `edit`,\n  `download`, `upload`, `share`, `filter`), feedback (`check`, `checkCircle`,\n  `xCircle`, `alertCircle`, `info`, `warning`, `lock`) and user/system\n  (`profile`, `settings`, `notification`, `favorite`, `help`, `calendar`).\n- All 11 previously shipped names are preserved, so existing `<uni-icon>` call\n  sites and theme overrides keep working. Their **appearance changes**: the\n  filled `checkCircle`/`xCircle` are now outlined, and the set reads lighter\n  overall. `spinner` is carried over verbatim, keyframes intact.\n- New `IconName` and `BaseIconName` types. `IconName` is\n  `BaseIconName | (string & {})`, so built-ins autocomplete and typos surface\n  while themes can still register arbitrary names via `createTheme({ icons })`.\n  `uni-icon`'s `name` input is typed with it instead of `keyof Icons`.\n- **Breaking**: removes the unused `IconToken`, `IconStyle`, `ToggleableIcon`\n  and `IconConfig` exports. Nothing in the library referenced them and\n  `IconToken`'s 60-name union contradicted the actual `BaseIcons` keys. Use\n  `IconName` instead.\n- New exported `svgToIconUri(svg, options?)` \u2014 the supported way to bring your\n  own icons (a brand set, a designer handoff) into a theme. It normalizes the\n  source (drops the xml declaration, comments and fixed `width`/`height` so the\n  mask scales), percent-encodes it, and **rejects artwork that cannot survive\n  masking**: no `viewBox`, an embedded raster `<image>`, an external reference,\n  a gradient/pattern fill, or more than one paint color. That last one is the\n  trap worth naming \u2014 masks use the alpha channel, so a multi-color logo\n  flattens to a silhouette in `currentColor`; pass `{ allowMultiColor: true }`\n  when that is intended. `createTheme({ icons })` merges the result over\n  `BaseIcons` per name, so a built-in name reskins and a new name is added.\n- New MCP tool `create-icon-tokens`, the agent-facing front end to\n  `svgToIconUri`: hand it a project's inline `<svg>` (or a brand set) and it\n  returns a paste-ready `icons` map for `uni-theme.ts`. It encodes via the same\n  helper, so tokens are byte-identical to the built-in set, and adds the\n  set-level checks a per-icon helper cannot make \u2014 which names override\n  built-ins, and whether the artwork mixes viewBox grids. Bad artwork is\n  reported per icon rather than failing the batch, and re-running is safe\n  (already-encoded URIs pass through). The server instructions now point agents\n  at it whenever they encounter inline SVG.\n- `BaseIcons` is generated by `scripts/generate-icons.mjs` (`pnpm icons:generate`),\n  which fetches from the canonical Material Symbols source and validates every\n  glyph before writing \u2014 a malformed path, an off-grid viewBox or geometry\n  outside the grid aborts the run. `pnpm icons:check` verifies the committed\n  file without writing. Add or change icons in that script's manifest and\n  regenerate; the file is not hand-edited. `icon.records.spec.ts` asserts the\n  same invariants against the committed output.",
+              commit: "f7727aa"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "6.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "TextStyle now accepts CSS length strings, not just px numbers",
+              body: "- `fontSize`, `lineHeight`, `letterSpacing`, `textIndent`, and `wordSpacing` on\n  `TextStyle` are widened from `number` to the new exported `CssLength`\n  (`number | string`). Bare numbers still mean px, matching Emotion's own\n  convention; strings pass through verbatim, so any unit the CSS engine accepts\n  works \u2014 `'1.2rem'`, `'2em'`, `'clamp(1rem, 2vw, 1.5rem)'`, unitless\n  line-height multipliers like `'1.5'`, etc.\n- `toTypeface` no longer blindly appends `px`: numbers are converted, strings\n  are passed through untouched. Existing numeric themes are unaffected.",
+              commit: "28323ec"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "6.0.1",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "6.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Search input stripped back and made generic; debounce input dressed in the shared chrome",
+              body: "- **`uni-debounce-input`** now wears the themed input chrome via `uni-input-box`\n  (color, border, typeface, focus ring) and gains `label` (accessible name),\n  `placeholder`, `disabled`, `pre-input`/`post-input` attribute slots for adornments,\n  ARIA passthroughs (`role`, `ariaExpanded`, `ariaControls`, `ariaActivedescendant`)\n  for composite widgets, and `clear()`/`focus()` methods. Debounce behavior unchanged.\n- **`uni-search-input` redesigned**: the opinionated solid-primary pill bar with the\n  embedded `title-large` label is gone. It's now a standard themed field \u2014 decorative\n  leading magnifier, clear button while a query exists (refocusing on clear), Enter\n  emits `search`, Escape closes/clears.\n- **Type-ahead added**: pass `suggestions` (refresh from `change`) and the field\n  becomes an ARIA combobox \u2014 keyboard-navigable listbox (ArrowUp/Down, Enter selects,\n  emitting `suggestionSelected` + `search`), `aria-activedescendant` wiring, focus-out\n  closing. New `searchInput` theme options: `searchSymbol`, `clearSymbol`, suggestion\n  list `listColor`/`listShadow`/`listBorderRadius`, `maxSuggestions`.\n- Visual breaking change for SearchInput consumers (deliberate strip-back); code API\n  is compatible (`label`/`width`/`change`/`search` retained; `label` is now the\n  accessible name + placeholder fallback rather than displayed text).",
+              commit: "5a6fc60"
+            },
+            {
+              bump: "minor",
+              title: "Checkbox, radio, and toggle conform to theme tokens",
+              body: "- The last hardcoded control colors (`#FFF`, `#ccc`, `#d0d0d0`, `#e0e0e0`,\n  `rgba(0,0,0,0.2)`) are gone. Chrome now resolves from new option tokens \u2014\n  checkbox `boxColor: 'surface'`; radio `ringColor: 'outline'` / `fillColor:\n  correctly on dark and brand themes.\n- The checkbox's check/dash strokes wear the variant's paired on-color\n  (`on-primary`, `on-warn`, \u2026) instead of assuming white; disabled states use the\n  `disabled`/`on-disabled` tokens; the toggle knob's shadow is the theme's\n  brand-tinted `raised` stack, and its hover uses the button convention's\n  brightness filter instead of a fixed grey.",
+              commit: "8953d59"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-stat` KPI tile",
+              body: '- Muted label + large headline value (numbers auto-compact via\n  `Intl.NumberFormat`: `48234` \u2192 "48.2K") set in a new `stat` type-scale role\n  (32px semibold, proportional figures).\n- Optional signed `delta` whose ink is decided by direction \xD7 `upIsGood` \u2014 churn\n  going down reads green, tickets going up reads red \u2014 with the arrow glyph\n  accompanied by screen-reader "up"/"down" text so state never rides color alone;\n  `caption` names the comparison period.\n- Optional decorative 12-point sparkline (`trend` input): stroke in the outline hue,\n  endpoint dotted in the accent, `aria-hidden`.\n- Fully token-driven via `stat.options`: card-recipe frame (`color`/`border`/\n  `borderRadius`), `labelTypeface`/`valueTypeface`, `positiveColor`/`negativeColor`\n  (the semantic inks, AA-guaranteed on surface), `trendColor`/`trendAccent`, spacing.',
+              commit: "7a6da4f"
+            },
+            {
+              bump: "minor",
+              title: "Fix invisible icons; icons become first-class theme primitives",
+              body: "- **Bug**: `uni-icon` resolves icons from `theme.icons`, but every theme shipped\n  `icons: {}` \u2014 the icon record was never wired in, so all icons (dialog close, button\n  spinner, search/clear affordances) rendered nothing.\n- **Fix + pattern**: the default icon set now lives in core (`BaseIcons`, in\n  `concepts/iconography`) and `createTheme` merges a theme's `icons` over it \u2014 themes\n  can override or add icons under any name (inline SVG data URIs, masked with\n  `currentColor` so they recolor with the theme). The angular `icons` record re-exports\n  `BaseIcons` (deprecated).\n- `uni-icon` also sets the standard `mask-image` (was webkit-only, so icons were\n  invisible in Firefox regardless) and renders nothing for unknown names instead of a\n  broken `url(\"undefined\")`.\n- The emitted `uni-theme.ts` gains an editable `icons` section, and the MCP's\n  `generate-uni-theme` guidance instructs agents: never inline SVG in components \u2014\n  define an icon once in the theme's `icons` map and render it via `<uni-icon>`.",
+              commit: "fea0b2e"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "5.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "New `uni-avatar` and `uni-avatar-group` components",
+              body: '- Graceful fallback chain: image \u2192 initials derived from `name` (first + last) \u2192\n  themed symbol. Accessible by default: `role="img"` + `aria-label` from the name,\n  `aria-hidden` when purely decorative.\n- Fully token-driven: variants color from the role\'s `*-container` tokens, sizes from\n  the theme\'s `avatar` size records, corner radius from `options.borderRadius`\n  (`max` = circles; a `sharp` theme gets square avatars), initials typeface from\n  `options.typeface`, fallback symbol from `options.fallbackSymbol`.\n- `uni-avatar-group` stacks avatars with a token-driven overlap (spacing token) and\n  separator ring (`ringColor`/`ringWidth` options); `max` collapses the overflow into\n  a themed "+N" chip that is itself a `uni-avatar` (verbatim `text` input).',
+              commit: "1f5ee1d"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-breadcrumb` component",
+              body: '- WAI-ARIA breadcrumb: labelled `nav` landmark wrapping an ordered list, the last item\n  marked `aria-current="page"`, separators decorative (`aria-hidden`).\n- Data-driven `items` (root first). Items with `href` render as real anchors; without\n  one they render as link-styled buttons emitting `itemClicked` for SPA routing.\n- Token-driven via `breadcrumb.options`: `typeface`, link `color`, `currentColor`,\n  `separatorSymbol` (material symbol), and `gap` spacing.',
+              commit: "dca84b1"
+            },
+            {
+              bump: "minor",
+              title: "Button corner rounding and typography conform to component-options tokens",
+              body: "- `button` and `iconButton` themes gain `options: { borderRadius: 'max' }`; the hardcoded\n  per-size pixel radii (11/13/18/24) and the icon button's inline `borderRadius: 999` are\n  removed. Components resolve the token through `theme.radius()`, so the theme's radii\n  scale \u2014 shape languages (`sharp` \u2192 square, `playful` \u2192 pill) and custom radii\n  primitives \u2014 now restyles buttons like every other tokened component.\n- Back-compat: the options radius is applied before theme `sizes`/`fixed` styles, so\n  hand-authored themes that still set a size-level `borderRadius` keep winning; icon\n  buttons fall back to the legacy circle when a theme predates iconButton options.\n- `button` themes also gain `options: { typeface: 'button' }`: the hardcoded\n  `fontFamily: 'Euphemia'` (a font no theme loads) is removed from `fixed` and the sizes;\n  labels now render the type scale's `button` role (Red Hat Display, medium, capitalize),\n  with per-size `fontSize` still applied by `sizes`. Point the token at any typography\n  role \u2014 including custom ones \u2014 to restyle every button label.\n- New `UniButtonOptions` interface (`borderRadius`, `typeface`) exported from the button\n  model.",
+              commit: "7844dde"
+            },
+            {
+              bump: "minor",
+              title: "Card frame conforms to token primitives",
+              body: "- The card theme's hardcoded frame (`borderStyle`/`borderWidth`/`borderRadius: '8px'` in\n  `fixed`, `borderColor` per variant) is replaced by tokens: the card resolves its border\n  from the **border primitive named by its variant** (`borders.primary` \u2026\n  `borders.success`), its corner radius from the radii scale (`options.borderRadius:\n- `UniCardOptions` gains `border` (pin every card to one primitive \u2014 including a custom\n  one \u2014 instead of variant-following) and documents the existing `borderRadius`/\n  `elevation`; redefining a border primitive in a theme now restyles cards and every\n  other component sharing that token.\n- Token styles apply under the merged theme style, so hand-authored themes that still\n  set card `fixed`/`variants` frame styles keep winning. No visual change for default\n  themes \u2014 this is pure tokenization.",
+              commit: "7844dde"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-drawer` and `uni-app-bar` \u2014 the dashboard shell",
+              body: '- **`uni-drawer`** has two modes sharing one content slot: `side` renders an in-flow\n  `<aside>` that pushes content (width-animated open/close, divider border primitive at\n  its edge, `aria-hidden` while closed); `over` renders a native `<dialog>` in the top\n  layer \u2014 focus trap, Escape, and scrim backdrop come from the platform, sliding in\n  from `position` (`start`/`end`). `open` is a two-way `model()`; Escape and backdrop\n  clicks keep it in sync. Tokens: `drawer.options` (`color`, `width`, `divider`,\n  `elevation`, `padding`, `backdrop`).\n- **`uni-app-bar`**: leading/trailing content projection slots around a `title` (or\n  custom center content), trailing pushed to the far edge; optional `sticky`. Tokens:\n  `appBar.options` (`color`, `height`, `divider`, `typeface`, `padding`, `gap`,\n  optional `elevation`).\n- The Drawer "DashboardShell" story documents the composition recipe: app bar with a\n  menu toggle + side drawer + content.',
+              commit: "17cf662"
+            },
+            {
+              bump: "minor",
+              title: "Progress gauge derives from the palette instead of hardcoded pastels",
+              body: "The gauge's track colors were fixed pastel hexes (`#b3d4ea`, `#b3e7c2`, \u2026) that ignored\nthe active theme entirely \u2014 secondary and success even shared the same green. Tracks now\nuse the role's `*-container` token (the palette's soft tint of that role) and arcs the\nrole base, so gauges follow any brand palette, in both light and dark modes.",
+              commit: "7844dde"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-skeleton` loading placeholder",
+              body: "- Three shapes: `text` (multi-line, ending on a short line like real copy), `rect`,\n  and `circle`; explicit `width`/`height` accept CSS strings or px numbers.\n- Painted with surface tokens (`skeleton.options`: `color`, `highlightColor`,\n  `borderRadius`, `gap`) so placeholders sit naturally on light and dark themes; the\n  shimmer sweep (`animation`/`duration` options) only runs when the user allows motion\n  and degrades to static blocks under `prefers-reduced-motion`.\n- `aria-hidden` \u2014 placeholders are invisible to assistive tech by design.",
+              commit: "4ccf18b"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-slider` component \u2014 clears the declared-but-unbuilt `ComponentName` entry",
+              body: '- Native `<input type="range">` under the hood: platform keyboard interaction\n  (arrows, Home/End, Page Up/Down) and ARIA slider semantics for free; Signal Forms\n  contract (`FormValueControl<number>`) matching Input/Textarea.\n- `min`/`max`/`step` inputs (fractional steps supported), required accessible `label`.\n- Token-driven via `slider.options`: fill/thumb `color`, `trackColor`, `borderRadius`,\n  and geometry (`trackHeight`, `thumbSize`). The fill level rides a CSS custom\n  property, so dragging never regenerates Emotion styles; Firefox uses the native\n  `::-moz-range-progress`, WebKit a gradient stop.',
+              commit: "5d9062a"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-tabs` / `uni-tab` components",
+              body: "- Full WAI-ARIA tabs pattern: `tablist`/`tab`/`tabpanel` roles with wired\n  `aria-selected`/`aria-controls`/`aria-labelledby`, roving tabindex, automatic\n  activation on ArrowLeft/ArrowRight (wrapping, disabled tabs skipped), Home/End,\n  and motion-safe transitions.\n- `selectedIndex` is a two-way `model()`; selection snaps to the nearest enabled tab.\n  Panel content is captured per-tab and only the selected panel is instantiated.\n- Every visual knob is a theme option token (`tabs.options`): `typeface`, `textColor`,\n  `activeTextColor`, `indicatorColor`, `indicatorThickness` (thickness token),\n  `divider` (border primitive), `gap`/`padding` (spacing tokens), `borderRadius`, and\n  optional `activeColor` \u2014 the defaults render underline tabs; `borderRadius: 'max'` +\n  `activeColor` turns them into segmented pills with no component changes.",
+              commit: "15a8f73"
+            },
+            {
+              bump: "minor",
+              title: "New `uni-textarea` component",
+              body: "- Multi-line text field with the same Signal Forms contract as `uni-input`\n  (`FormValueControl<string>`: `value` model, `disabled`/`invalid`/`dirty`/`required`,\n  touched-aware error styling, `aria-*` wiring).\n- Reuses `uni-input-box` for its chrome, so it inherits the input's themed color,\n  border, typeface, focus outline, and disabled treatment automatically; the box's\n  field selectors now cover `textarea` (with auto height and vertical padding), and\n  the box accepts a `height` override.\n- Theme options follow the token pattern: `textarea: { options: { rows: 3, resize:\n  instance.",
+              commit: "b04b97b"
+            },
+            {
+              bump: "minor",
+              title: "Theme Builder becomes the full playground (PRD \xA75.2)",
+              body: "- **Light & dark side by side**: both palettes generate on every input change,\n  independent of the storybook-wide mode toggle, each rendered in its own panel.\n- **Contrast report panel**: live pass/fail matrix over all checked pairs (summary +\n  failing rows always visible, full detail on demand). Failures only occur with hard\n  brand pins; the panel says so and points at soft targets.\n- **Shape language input** (`sharp`/`modern`/`playful`): applies `ShapeRadii` live via\n  the new `radii` pass-through on `BrandPaletteConfig`/`createThemeFromPalette`.\n- **Export paths**: copy the static `uni-theme.ts` (via `emitThemeFile`), copy a\n  pre-encoded `ng add` command, or copy W3C DTCG JSON for both modes via the new\n  `emitDtcgTokens()` interop emitter in uni-core (Style Dictionary compatible).",
+              commit: "8f55b4c"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "5.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Brand-tinted, theme-scoped elevation shadows (PRD \xA73.5.C)",
+              body: "- New `generateShadows(colors, mode)`: light themes replace the dead-neutral\n  `rgba(0,0,0,\u2026)` stacks with a shadow ink pulled toward the brand hue; dark themes go\n  near-zero (`raised: none`) with only a faint veil on floating overlays \u2014 elevation\n  reads from the surface lightness steps instead. The `warn` glow is tinted with the\n  theme's own error color in both modes.\n- `generateThemes` now returns `lightShadows`/`darkShadows`; `generateUniThemes`,\n  `createThemeFromPalette` (Theme Builder), the emitted `uni-theme.ts`, and the shipped\n  stock Light/Dark themes all carry them.",
+              commit: "c1dc853"
+            },
+            {
+              bump: "patch",
+              title: "Fix `ng add` against real published packages (found by fresh `ng new` e2e):",
+              body: '- The schematic bundle is CJS, but ng-packagr stamps `"type": "module"` into the\n  published package.json, so Node loaded it as ESM and the CLI reported "no ng add\n  actions". A nested `schematics/package.json` (`"type": "commonjs"`) scopes the\n  bundle back to CJS.\n- The emitted `uni-theme.ts` used dot access on `Colors` (which has an index\n  signature), failing under `ng new`\'s strict `noPropertyAccessFromIndexSignature`.\n  The emitter (and the MCP tool\'s guidance) now uses bracket access throughout.\n- `uni-angular`\'s peer range on `uni-core` is now `workspace:^` (publishes as `^5.x`)\n  instead of `workspace:*` (published as an exact pin). Alongside changesets\'\n  `onlyUpdatePeerDependentsWhenOutOfRange`, this stops minor releases from being\n  inflated to majors by the peer-dependents rule \u2014 the cause of the 4.0.0 and 5.0.0\n  version jumps.',
+              commit: "f2951db"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "5.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "OKLCH theme generation engine (`concepts/generation`)",
+              body: "- New `generateThemes(input)` / `generateUniThemes(input)`: brand seed(s) in, complete\n  WCAG-AA light+dark `Colors` pair out, with a machine-readable `ContrastReport`\n  (110 checked pairs per theme pair). Pure and deterministic.\n- All palette math moved from HSL to perceptual OKLCH: uniform lightness slots across\n  hues, per-category chroma model (`CategoryChroma`), dark-mode accent chroma decoupling\n  (C \u2264 0.16), and a contrast guard-rail that adjusts lightness only \u2014 never hue.\n- Brand colors ride as soft `targets` (kept verbatim when already AA, lightness-adjusted\n  when not) alongside the existing hard `brand` pins; accepted by `generatePalette`,\n  `createThemeFromPalette`, and Angular's `BrandPaletteConfig`.\n- Semantic inks re-tuned per role: error 27\xB0/C 0.20, warn 55\xB0/C 0.18 (rotated off amber \u2014\n  dark yellow reads brown), success 152\xB0/C 0.16.\n- `createTheme` accepts optional `radii`/`shadows` overrides; `ShapeRadii` presets\n  (`sharp` / `modern` / `playful`) emitted via the `shape` generation input.\n- Theme Builder ships nine curated AA-clean presets built on soft targets.\n- Deprecated (thin wrappers/tables retained): `uniColor`, `randomRangeValue`,\n  `CategorySaturation`, `CategoryLightness`. `schemeHues` moved to `color.utils`.\n- `createTheme` deep-merges optional `borders` and `components` overrides over its\n  derived defaults \u2014 themes can define custom named primitives and rewire per-component\n  options without restating untouched sections.\n- New `emitThemeFile()` renders a static `uni-theme.ts` \u2014 literal colors, visible border\n  primitives, sparse component overrides \u2014 the editable source of truth; the engine\n  never ships to the browser.\n- New `ng add @uni-design-system/uni-angular` schematic: installs the peer set, writes\n  the generated theme file, registers `UNI_THEMES` in `app.config.ts`, adds typeface\n  links, scaffolds a themed smoke test, and prints the contrast summary.\n- New MCP tool `generate-uni-theme`: returns the static theme file content, provider\n  snippet, and contrast report, with agent guidance to edit the file for restyling.\n- `uni-core` gains its first Vitest suite, including a 1,080-seed contrast property\n  corpus with zero tolerance in both modes; the schematic gets its own spec suite.",
+              commit: "f7f0bdd"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "4.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Porting Components",
+              body: "",
+              commit: "ef9b3b5"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "3.0.2",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "3.0.1",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "3.0.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "2.0.4",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "2.0.3",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "2.0.2",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "2.0.1",
+          entries: [
+            {
+              bump: "patch",
+              title: "Fix: switch to bundled dual-package distribution via Vite to resolve strict ESM relative path failures",
+              body: "",
+              commit: "e2cad74"
+            },
+            {
+              bump: "patch",
+              title: "Setting Fixed Versioning for all packages.",
+              body: "",
+              commit: "be0fb26"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "1.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Adding cjs support",
+              body: "",
+              commit: "4a049de"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "1.0.0",
+          entries: [
+            {
+              bump: "major",
+              title: "init release",
+              body: "",
+              commit: "7d18157"
+            }
+          ],
+          dependencyBumps: []
+        }
+      ]
+    },
+    {
+      package: "@uni-design-system/uni-react",
+      releases: [
+        {
+          version: "8.2.0",
+          entries: [
+            {
+              bump: "patch",
+              title: "Ship `CHANGELOG.md` in the published packages. The release notes existed only in the repo; an installed package carried no record of what changed, so upgrade questions couldn't be answered from `node_modules`. uni-angular copies it into the ng-packagr `dist` via `assets`; the rest add it to `files`.",
+              body: "",
+              commit: "e706e38"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "8.1.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "8.0.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "7.3.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "7.2.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "7.1.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "7.0.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "6.1.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "6.0.1",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "6.0.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "5.2.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "5.1.0",
+          entries: [],
+          dependencyBumps: []
+        },
+        {
+          version: "5.0.0",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@5.0.0"
+          ]
+        },
+        {
+          version: "4.0.0",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@4.0.0"
+          ]
         },
-        tag: {
-          borderRadius: "max",
-          typeface: "tag",
-          gap: "xs",
-          removeIcon: "close",
-          selectedIcon: "check"
+        {
+          version: "3.0.2",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@3.0.2"
+          ]
         },
-        tagInput: {
-          chipGap: "xs",
-          chipSize: "md",
-          minInputWidth: "12ch",
-          listColor: "primary-surface",
-          listShadow: "menu",
-          listBorderRadius: "xs",
-          maxSuggestions: 8
+        {
+          version: "3.0.1",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@3.0.1"
+          ]
         },
-        button: {
-          borderRadius: "max",
-          typeface: "button"
+        {
+          version: "3.0.0",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@3.0.0"
+          ]
         },
-        iconButton: {
-          borderRadius: "max"
+        {
+          version: "2.0.4",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.4"
+          ]
         },
-        card: {
-          borderRadius: "xs"
+        {
+          version: "2.0.3",
+          entries: [],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.3"
+          ]
         },
-        dataSearch: {
-          border: "light",
-          borderRadius: "xs",
-          color: "primary-surface",
-          placeholderColor: "disabled"
+        {
+          version: "2.0.2",
+          entries: [
+            {
+              bump: "patch",
+              title: "Fix: switch React package distribution to bundled multi-format outputs via Vite to resolve strict ESM runtime and source compilation issues inside consumers.",
+              body: "",
+              commit: "c5c552a"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.2"
+          ]
         },
-        dataTable: {
-          color: "primary-surface",
-          border: "light",
-          borderRadius: "sm",
-          headerPadding: "sm",
-          footerPadding: "sm",
-          thTextRole: "headline-small",
-          thColor: "primary-container",
-          thVerticalBorder: "dotted",
-          thHorizontalBorder: "light",
-          thPadding: "sm",
-          tdTextRole: "title-small",
-          tdColor: "primary-surface",
-          tdStickyColor: "primary-container",
-          tdPadding: "sm",
-          tdVerticalBorder: "dotted",
-          tdHorizontalBorder: "light",
-          rowHoverColor: "primary-container",
-          loadingOverlayColor: "scrim",
-          loadingSpinnerColor: "primary",
-          loadingSpinnerSize: 40
+        {
+          version: "2.0.1",
+          entries: [
+            {
+              bump: "patch",
+              title: "Setting Fixed Versioning for all packages.",
+              body: "",
+              commit: "be0fb26"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@2.0.1"
+          ]
         },
-        notificationBadge: {
-          borderRadius: "sm",
-          offset: -10
+        {
+          version: "2.0.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Adding cjs support",
+              body: "",
+              commit: "4a049de"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@1.1.0"
+          ]
         },
-        paginator: {
-          gap: "xs",
-          textRole: "label",
-          inputBorder: "light",
-          inputBorderRadius: "xs",
-          pageBorderRadius: "xs",
-          currentPageBorder: "light",
-          currentPageBorderRadius: "xs"
+        {
+          version: "1.0.0",
+          entries: [
+            {
+              bump: "major",
+              title: "init release",
+              body: "",
+              commit: "7d18157"
+            }
+          ],
+          dependencyBumps: [
+            "@uni-design-system/uni-core@1.0.0"
+          ]
+        }
+      ]
+    },
+    {
+      package: "@uni-design-system/uni-mcp",
+      releases: [
+        {
+          version: "4.7.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "`get-changelog`: release notes as a first-class MCP tool, plus a `uni://changelog/{package}` resource.",
+              body: 'The index now ingests every published package\'s changesets `CHANGELOG.md` (a new build adapter parses them into structured releases \u2014 bump level, headline, full body, commit, dependency bumps). The tool answers "what changed in X?" and "what do I get by upgrading?": `version` returns one release\'s full notes (`"8.1"` matches every 8.1.x), `since` returns the full notes of every release after an installed version, and no scope returns a compact release digest. `package` accepts npm or short names (`uni-angular` is the default).',
+              commit: "e706e38"
+            },
+            {
+              bump: "minor",
+              title: "`export-dtcg-tokens`: W3C DTCG JSON (Style Dictionary compatible) for a built-in theme's color, radius, and spacing scales, named with Uni token ids \u2014 exposing core's existing `emitDtcgTokens` as an MCP tool for external token pipelines. The `UniTheme` JSON from the theme tools remains the lossless primary format.",
+              body: "",
+              commit: "57a8c4c"
+            },
+            {
+              bump: "patch",
+              title: "Ship `CHANGELOG.md` in the published packages. The release notes existed only in the repo; an installed package carried no record of what changed, so upgrade questions couldn't be answered from `node_modules`. uni-angular copies it into the ng-packagr `dist` via `assets`; the rest add it to `files`.",
+              body: "",
+              commit: "e706e38"
+            }
+          ],
+          dependencyBumps: []
         },
-        stat: {
-          labelTypeface: "label",
-          valueTypeface: "stat",
-          color: "surface",
-          border: "light",
-          borderRadius: "xs",
-          positiveColor: "success",
-          negativeColor: "error",
-          trendColor: "outline",
-          trendAccent: "primary",
-          padding: "md",
-          gap: "xxs"
+        {
+          version: "4.6.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Runtime theme JSON: `generate-runtime-theme`, `get-runtime-theme`, and a theme registry endpoint",
+              body: "`generate-uni-theme` returns `uni-theme.ts` **source** \u2014 codegen by design, and\nthe right answer for branding an app permanently. It is the wrong answer when a\ntheme needs to apply _now_: an agent had to write a file and rebuild. These tools\nclose that gap (ROADMAP Track 1 item 4).\n- **`generate-runtime-theme`** \u2014 brand hex color(s) in, a WCAG-AA light+dark pair\n  out as validated JSON, ready for `ThemeService.registerTheme(theme, { select:\n- **`get-runtime-theme`** \u2014 a theme that ships with Uni as a registerable\n  `UniTheme`. Distinct from `get-theme-template`, which returns a flat read-only\n  projection of token values rather than the theme object itself.\n- **Both validate before returning.** Every theme is run through uni-core's\n  `parseTheme`, so \"validated\" is checked rather than claimed; a failure comes\n  back as a tool error listing every reason.\n- **First tools with an MCP `outputSchema`**, so agents get a machine-readable\n  contract instead of parsing prose (opens ROADMAP Track 1 item 6). The theme\n  itself is typed as an opaque validated object on purpose \u2014 uni-core's\n  `parseTheme` stays the single source of truth for theme shape, and a mirrored\n  schema here would drift from it.\n- **Payloads elide the built-in icon set** (`dehydrateTheme`), taking a\n  light+dark result from ~100 KB to ~30 KB \u2014 roughly 7.6k tokens instead of 25k\n  per call. Consumers restore them on registration.\n- **New registry endpoint on the HTTP server**: `GET /themes` lists the ids and\n  `GET /themes/{id}.json` returns one registerable theme, for apps that fetch a\n  theme without speaking MCP. These routes are public, read-only and\n  CORS-enabled so a browser can fetch them directly; `/mcp` stays token-guarded\n  and same-origin.\n- The server's instructions now carry a routing rule for the four theme tools\n  (brand permanently / apply now / inspect values), and the README tool table\n  lists `create-icon-tokens`, which shipped undocumented.",
+              commit: "5414517"
+            }
+          ],
+          dependencyBumps: []
         },
-        slider: {
-          color: "primary",
-          trackColor: "surface-variant",
-          borderRadius: "max",
-          trackHeight: 4,
-          thumbSize: 16
+        {
+          version: "4.5.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Expand `BaseIcons` to 59 icons and add `uni-icon` sizing",
+              body: "The 34-icon set shipped in 7.0.0 covered the library's own components but not a\nreal application \u2014 an app migrating off inline `<svg>` (or off `uni-symbol`, in\nAngular) ran out of names almost immediately. Everything here is additive; all\n34 existing names are unchanged.\n- **25 new icons**, same Material Symbols Outlined 300 source and the same\n  `0 -960 960 960` grid as the rest of the set: navigation (`link`, `expand`,\n  `gridView`, `listView`), actions (`moreHorizontal`, `copy`, `send`,\n  `refresh`, `dragHandle`, `qrCode`), feedback (`star`, `verified`) and\n  user/system (`group`, `shieldPerson`, `clock`, `mail`, `chat`, `image`,\n  `document`, `payment`, `bank`, `trendingUp`, `extension`, `webhook`,\n  `logout`).\n  - `moreHorizontal` ships alongside `more` because that one is `more_vert` and\n    row-aligned menus need the horizontal kebab.\n  - `star` is separate from `favorite`, which is the heart.\n- **`uni-icon` gains an optional `size` input** (`CssLength` \u2014 bare numbers are\n  px, strings pass through, so `20` and `'1.25rem'` both work). Left unset,\n  behaviour is unchanged: the icon fills its container, which is what lets a\n  themed control size its own glyph through padding. Set, it applies\n  width/height as inline styles, so an explicit size wins over the\n  fill-the-container rule regardless of style injection order. This removes the\n  per-call-site `width`/`height` CSS rule that replacing an inline `<svg>` with\n  `<uni-icon>` would otherwise need.\n- The MCP `create-icon-tokens` tool now lists the built-in icon names above the\n  token map it returns. Apps routinely hand-draw their own `close`, `check` or\n  `plus`; encoding those into theme tokens works but adds redundant artwork on a\n  foreign grid when the theme already ships the glyph. The tool cannot recognise\n  a shape, so it hands the caller the list to check against before adding\n  anything.",
+              commit: "c2421c0"
+            }
+          ],
+          dependencyBumps: []
         },
-        skeleton: {
-          color: "surface-variant",
-          highlightColor: "surface",
-          borderRadius: "xs",
-          animation: "shimmer",
-          duration: 1.4,
-          gap: "sm"
+        {
+          version: "4.4.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Replace `BaseIcons` with a normalized 34-icon Material Symbols set",
+              body: "The built-in icon set was 11 glyphs drawn from four different grids\n(`0 0 24 24`, `0 0 50 50`, `0 0 64 64`, `0 -960 960 960`), so `checkCircle` and\n`xCircle` rendered as solid filled discs next to a hairline `alertCircle` and an\noversized `close` \u2014 three optical weights in one set.\n- `BaseIcons` is now Material Symbols Outlined at weight 300, every glyph on a\n  single `0 -960 960 960` grid, grouped by intent: navigation (`menu`,\n  `chevronUp/Down/Left/Right`, `arrowLeft/Right`, `home`, `externalLink`),\n  actions (`search`, `close`, `plus`, `minus`, `more`, `delete`, `edit`,\n  `download`, `upload`, `share`, `filter`), feedback (`check`, `checkCircle`,\n  `xCircle`, `alertCircle`, `info`, `warning`, `lock`) and user/system\n  (`profile`, `settings`, `notification`, `favorite`, `help`, `calendar`).\n- All 11 previously shipped names are preserved, so existing `<uni-icon>` call\n  sites and theme overrides keep working. Their **appearance changes**: the\n  filled `checkCircle`/`xCircle` are now outlined, and the set reads lighter\n  overall. `spinner` is carried over verbatim, keyframes intact.\n- New `IconName` and `BaseIconName` types. `IconName` is\n  `BaseIconName | (string & {})`, so built-ins autocomplete and typos surface\n  while themes can still register arbitrary names via `createTheme({ icons })`.\n  `uni-icon`'s `name` input is typed with it instead of `keyof Icons`.\n- **Breaking**: removes the unused `IconToken`, `IconStyle`, `ToggleableIcon`\n  and `IconConfig` exports. Nothing in the library referenced them and\n  `IconToken`'s 60-name union contradicted the actual `BaseIcons` keys. Use\n  `IconName` instead.\n- New exported `svgToIconUri(svg, options?)` \u2014 the supported way to bring your\n  own icons (a brand set, a designer handoff) into a theme. It normalizes the\n  source (drops the xml declaration, comments and fixed `width`/`height` so the\n  mask scales), percent-encodes it, and **rejects artwork that cannot survive\n  masking**: no `viewBox`, an embedded raster `<image>`, an external reference,\n  a gradient/pattern fill, or more than one paint color. That last one is the\n  trap worth naming \u2014 masks use the alpha channel, so a multi-color logo\n  flattens to a silhouette in `currentColor`; pass `{ allowMultiColor: true }`\n  when that is intended. `createTheme({ icons })` merges the result over\n  `BaseIcons` per name, so a built-in name reskins and a new name is added.\n- New MCP tool `create-icon-tokens`, the agent-facing front end to\n  `svgToIconUri`: hand it a project's inline `<svg>` (or a brand set) and it\n  returns a paste-ready `icons` map for `uni-theme.ts`. It encodes via the same\n  helper, so tokens are byte-identical to the built-in set, and adds the\n  set-level checks a per-icon helper cannot make \u2014 which names override\n  built-ins, and whether the artwork mixes viewBox grids. Bad artwork is\n  reported per icon rather than failing the batch, and re-running is safe\n  (already-encoded URIs pass through). The server instructions now point agents\n  at it whenever they encounter inline SVG.\n- `BaseIcons` is generated by `scripts/generate-icons.mjs` (`pnpm icons:generate`),\n  which fetches from the canonical Material Symbols source and validates every\n  glyph before writing \u2014 a malformed path, an off-grid viewBox or geometry\n  outside the grid aborts the run. `pnpm icons:check` verifies the committed\n  file without writing. Add or change icons in that script's manifest and\n  regenerate; the file is not hand-edited. `icon.records.spec.ts` asserts the\n  same invariants against the committed output.",
+              commit: "f7727aa"
+            }
+          ],
+          dependencyBumps: []
         },
-        snackbar: {
-          bottomPosition: 40,
-          transitionDelay: "0.35s",
-          autoCloseDelay: 35e3
+        {
+          version: "4.3.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "MDX guidelines adapter \u2014 authored docs now reach AI agents",
+              body: "- New build adapter parses each component's co-located `.mdx` docs page into the\n  index's previously-empty `guidelines` field: the `## Overview` prose becomes\n  `whenToUse`, and optional `## Do` / `## Don't` / `## Accessibility` bullet sections\n  map to their fields \u2014 so guidelines are authored in the same file the Storybook\n  sidebar shows, with JSX/import scaffolding stripped.\n- 48 components gain guidelines immediately; `get-guidelines` and `uni://guidelines/*`\n  now answer with real when-to-use guidance (including the canonical selector forms\n  from the 6.0 unification).\n- MDX\u2194component matching: shared basename first (`tabs.mdx` \u2192 `tabs.component.ts`),\n  same-directory fallback for group docs.",
+              commit: "076202d"
+            },
+            {
+              bump: "patch",
+              title: "Canonical MDX docs structure across the entire library",
+              body: "- Component docs pages now follow one flow (spec in AGENTS.md): imports \u2192 Overview \u2192\n  Usage (the compact playground: story + source + knobs) \u2192 named variation examples \u2192\n  **Theme options** \u2192 Accessibility \u2192 Do/Don't. Property/API/Methods/Events tables are\n  retired \u2014 the playground's controls are the API reference.\n- New `ThemeOptions` docs block renders a component's per-theme option tokens live from\n  the active Storybook theme (with color swatches), distinguishing per-theme options\n  from per-instance inputs; data-table's raw `ThemeDataBlock` dump is replaced.\n- All ~55 component pages conform: the 7 form-control pages (200\u2013390 lines of legacy\n  API tables) rewritten; empty Overviews authored (card, tag, icon-button, scroll-area,\n  expand-area, data-table); accessibility bullets added across navigation, feedback,\n  and form components.\n- The MCP index now carries when-to-use guidance for 55 of 70 components (was 41) and\n  accessibility guidance for 36 (was 21) \u2014 the remainder are subcomponents documented\n  on their parent pages and internal directives.",
+              commit: "4bfb057"
+            }
+          ],
+          dependencyBumps: []
         },
-        symbol: {
-          fill: 0,
-          weight: 400,
-          grade: 0,
-          opticalSize: 24
+        {
+          version: "4.2.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "Fix invisible icons; icons become first-class theme primitives",
+              body: "- **Bug**: `uni-icon` resolves icons from `theme.icons`, but every theme shipped\n  `icons: {}` \u2014 the icon record was never wired in, so all icons (dialog close, button\n  spinner, search/clear affordances) rendered nothing.\n- **Fix + pattern**: the default icon set now lives in core (`BaseIcons`, in\n  `concepts/iconography`) and `createTheme` merges a theme's `icons` over it \u2014 themes\n  can override or add icons under any name (inline SVG data URIs, masked with\n  `currentColor` so they recolor with the theme). The angular `icons` record re-exports\n  `BaseIcons` (deprecated).\n- `uni-icon` also sets the standard `mask-image` (was webkit-only, so icons were\n  invisible in Firefox regardless) and renders nothing for unknown names instead of a\n  broken `url(\"undefined\")`.\n- The emitted `uni-theme.ts` gains an editable `icons` section, and the MCP's\n  `generate-uni-theme` guidance instructs agents: never inline SVG in components \u2014\n  define an icon once in the theme's `icons` map and render it via `<uni-icon>`.",
+              commit: "fea0b2e"
+            }
+          ],
+          dependencyBumps: []
         },
-        toggle: {
-          size: 20,
-          trackColor: "surface-variant",
-          knobColor: "surface"
+        {
+          version: "4.1.2",
+          entries: [
+            {
+              bump: "patch",
+              title: "Fix published index losing its Storybook examples, and keep the index in sync",
+              body: "- `uni-mcp@4.1.x` shipped with **0 examples**: the package build regenerated the index in\n  CI, where `storybook-static` (gitignored) doesn't exist, silently overwriting the\n  committed 107-example index before bundling. `build` is now `tsup` only \u2014 the committed\n  `uni-index.json` is the single source of truth and is bundled as-is.\n- The index is regenerated once per release instead: the changesets `version` step\n  (`pnpm version-packages`) builds Storybook and reruns `build-index` after the version\n  bump, so the refreshed index lands reviewably in the Version Packages PR.\n- `build-index` now fails loudly when it finds zero examples, so an example-less index\n  can never ship silently again.\n- Index refreshed to v5.1.0: includes the new component option tokens\n  (`button.behavior.borderRadius`/`typeface`, `card.behavior.borderRadius`), the nine\n  Theme Builder presets' generation updates, and all 107 examples.",
+              commit: "ffb9692"
+            }
+          ],
+          dependencyBumps: []
         },
-        tooltip: {
-          borderRadius: "xs",
-          shadow: "raised",
-          color: "inverse-surface",
-          typeface: "label"
+        {
+          version: "4.1.1",
+          entries: [
+            {
+              bump: "patch",
+              title: "Fix `ng add` against real published packages (found by fresh `ng new` e2e):",
+              body: '- The schematic bundle is CJS, but ng-packagr stamps `"type": "module"` into the\n  published package.json, so Node loaded it as ESM and the CLI reported "no ng add\n  actions". A nested `schematics/package.json` (`"type": "commonjs"`) scopes the\n  bundle back to CJS.\n- The emitted `uni-theme.ts` used dot access on `Colors` (which has an index\n  signature), failing under `ng new`\'s strict `noPropertyAccessFromIndexSignature`.\n  The emitter (and the MCP tool\'s guidance) now uses bracket access throughout.\n- `uni-angular`\'s peer range on `uni-core` is now `workspace:^` (publishes as `^5.x`)\n  instead of `workspace:*` (published as an exact pin). Alongside changesets\'\n  `onlyUpdatePeerDependentsWhenOutOfRange`, this stops minor releases from being\n  inflated to majors by the peer-dependents rule \u2014 the cause of the 4.0.0 and 5.0.0\n  version jumps.',
+              commit: "f2951db"
+            }
+          ],
+          dependencyBumps: []
+        },
+        {
+          version: "4.1.0",
+          entries: [
+            {
+              bump: "minor",
+              title: "OKLCH theme generation engine (`concepts/generation`)",
+              body: "- New `generateThemes(input)` / `generateUniThemes(input)`: brand seed(s) in, complete\n  WCAG-AA light+dark `Colors` pair out, with a machine-readable `ContrastReport`\n  (110 checked pairs per theme pair). Pure and deterministic.\n- All palette math moved from HSL to perceptual OKLCH: uniform lightness slots across\n  hues, per-category chroma model (`CategoryChroma`), dark-mode accent chroma decoupling\n  (C \u2264 0.16), and a contrast guard-rail that adjusts lightness only \u2014 never hue.\n- Brand colors ride as soft `targets` (kept verbatim when already AA, lightness-adjusted\n  when not) alongside the existing hard `brand` pins; accepted by `generatePalette`,\n  `createThemeFromPalette`, and Angular's `BrandPaletteConfig`.\n- Semantic inks re-tuned per role: error 27\xB0/C 0.20, warn 55\xB0/C 0.18 (rotated off amber \u2014\n  dark yellow reads brown), success 152\xB0/C 0.16.\n- `createTheme` accepts optional `radii`/`shadows` overrides; `ShapeRadii` presets\n  (`sharp` / `modern` / `playful`) emitted via the `shape` generation input.\n- Theme Builder ships nine curated AA-clean presets built on soft targets.\n- Deprecated (thin wrappers/tables retained): `uniColor`, `randomRangeValue`,\n  `CategorySaturation`, `CategoryLightness`. `schemeHues` moved to `color.utils`.\n- `createTheme` deep-merges optional `borders` and `components` overrides over its\n  derived defaults \u2014 themes can define custom named primitives and rewire per-component\n  options without restating untouched sections.\n- New `emitThemeFile()` renders a static `uni-theme.ts` \u2014 literal colors, visible border\n  primitives, sparse component overrides \u2014 the editable source of truth; the engine\n  never ships to the browser.\n- New `ng add @uni-design-system/uni-angular` schematic: installs the peer set, writes\n  the generated theme file, registers `UNI_THEMES` in `app.config.ts`, adds typeface\n  links, scaffolds a themed smoke test, and prints the contrast summary.\n- New MCP tool `generate-uni-theme`: returns the static theme file content, provider\n  snippet, and contrast report, with agent guidance to edit the file for restyling.\n- `uni-core` gains its first Vitest suite, including a 1,080-seed contrast property\n  corpus with zero tolerance in both modes; the schematic gets its own spec suite.",
+              commit: "f7f0bdd"
+            }
+          ],
+          dependencyBumps: []
         }
-      },
-      usage: "Apply style overrides through the Emotion theme provider (the `UniTheme` object), and pass component options as component inputs/props. Import the theme from `@uni-design-system/uni-core` (`DarkTheme`)."
+      ]
     }
   ]
 };
@@ -11429,6 +13706,36 @@ function listThemes() {
 function getTheme(id) {
   return index.themes.find((t) => t.id === id);
 }
+function listChangelogs() {
+  return index.changelogs ?? [];
+}
+function getChangelog(pkg = "uni-angular") {
+  const q = pkg.trim().toLowerCase();
+  return listChangelogs().find((c) => {
+    const name = c.package.toLowerCase();
+    const short = name.split("/").pop() ?? name;
+    return name === q || short === q || short.replace(/^uni-/, "") === q;
+  });
+}
+function compareVersions(a, b) {
+  const nums = (v) => v.trim().replace(/^v/, "").split(".").map((s) => parseInt(s, 10) || 0);
+  const [pa, pb] = [nums(a), nums(b)];
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (d) return d;
+  }
+  return 0;
+}
+function matchesVersion(version, query) {
+  const v = version.split(".");
+  const q = query.trim().replace(/^v/, "").split(".");
+  return q.every((seg, i) => v[i] === seg);
+}
+function selectReleases(cl, scope) {
+  if (scope.version) return cl.releases.filter((r) => matchesVersion(r.version, scope.version));
+  if (scope.since) return cl.releases.filter((r) => compareVersions(r.version, scope.since) > 0);
+  return cl.releases;
+}
 function search(query, kind) {
   const q = query.toLowerCase().trim();
   if (!q) return [];
@@ -11604,6 +13911,43 @@ ${g.donts.map((d) => `- ${d}`).join("\n")}`);
 ${g.accessibility.map((a) => `- ${a}`).join("\n")}`);
   return out.join("\n");
 }
+function formatRelease(r, full) {
+  const out = [`## ${r.version}`];
+  for (const bump of ["major", "minor", "patch"]) {
+    const entries = r.entries.filter((e) => e.bump === bump);
+    if (!entries.length) continue;
+    out.push(`
+### ${bump[0].toUpperCase()}${bump.slice(1)} changes`);
+    for (const e of entries) {
+      const commit = e.commit ? ` _(${e.commit.slice(0, 7)})_` : "";
+      if (full && e.body) out.push(`
+**${e.title}**${commit}
+
+${e.body}`);
+      else out.push(`- ${e.title}${commit}`);
+    }
+  }
+  if (r.dependencyBumps.length) {
+    out.push(`
+_Dependency bumps: ${r.dependencyBumps.map((d) => `\`${d}\``).join(", ")}_`);
+  }
+  if (!r.entries.length && !r.dependencyBumps.length) out.push("_No entries._");
+  return out.join("\n");
+}
+function formatChangelog(cl, scope = {}) {
+  const releases = selectReleases(cl, scope);
+  if (!releases.length) {
+    const wanted = scope.version ? `release matching \`${scope.version}\`` : `releases after \`${scope.since}\``;
+    return `No ${wanted} found for ${cl.package}. Latest release: ${cl.releases[0]?.version ?? "none"}.`;
+  }
+  const full = Boolean(scope.version || scope.since);
+  const shown = full ? releases : releases.slice(0, 15);
+  const out = [`# ${cl.package} \u2014 release notes`, ...shown.map((r) => formatRelease(r, full))];
+  if (shown.length < releases.length) {
+    out.push(`_...and ${releases.length - shown.length} older releases. Pass \`version\` or \`since\` to scope._`);
+  }
+  return out.join("\n\n");
+}
 function formatSearch(query, hits) {
   if (!hits.length) return `No results for "${query}".`;
   const rows = hits.slice(0, 40).map((h) => `- _[${h.kind}]_ **${h.label}** \`${h.id}\` - ${h.snippet}`);
@@ -12098,6 +14442,20 @@ var generateColors = (config) => {
   };
 };
 var generatePalette = (config) => generateColors(config);
+var dimensionEntries = (record) => Object.fromEntries(Object.entries(record ?? {}).filter(([, value]) => value !== void 0 && value !== "none").map(([key, value]) => [key, {
+  $value: String(value),
+  $type: "dimension"
+}]));
+var emitDtcgTokens = (input) => ({
+  color: Object.fromEntries(Object.entries(input.colors).filter(([, value]) => value !== void 0).map(([key, value]) => [key, {
+    $value: value,
+    $type: "color"
+  }])),
+  size: {
+    radius: dimensionEntries(input.radii),
+    spacing: dimensionEntries(input.spacing)
+  }
+});
 var rgba = (hex, alpha) => {
   const { red, green, blue } = hexToRgb(hex);
   return `rgba(${red}, ${green}, ${blue}, ${alpha})`;
@@ -12497,12 +14855,15 @@ var buildComponents = (c) => ({
   } },
   checkbox: { options: {
     size: 20,
-    boxColor: "surface"
+    boxColor: "surface",
+    borderRadius: 2,
+    focusRingGap: 2
   } },
   radio: { options: {
     size: 20,
     ringColor: "outline",
-    fillColor: "surface"
+    fillColor: "surface",
+    transitionSpeed: 0.3
   } },
   dialog: { options: {
     borderRadius: "lg",
@@ -12580,7 +14941,7 @@ var buildComponents = (c) => ({
     logoPadding: "md"
   } },
   input: { options: {
-    typeFace: "input",
+    typeface: "input",
     color: "primary-surface",
     textColor: "on-primary-surface",
     disabledColor: "disabled-surface",
@@ -12693,6 +15054,56 @@ var buildComponents = (c) => ({
     listBorderRadius: "xs",
     maxSuggestions: 8
   } },
+  calendar: {
+    options: {
+      dayBorderRadius: "max",
+      typeface: "label",
+      gap: "xxs",
+      navPrevSymbol: "chevron_left",
+      navNextSymbol: "chevron_right",
+      weekdayFormat: "short",
+      showOutsideDays: false,
+      todayStyle: "outline"
+    },
+    fixed: {
+      display: "inline-block",
+      userSelect: "none"
+    },
+    sizes: {
+      sm: {
+        width: 28,
+        height: 28,
+        fontSize: 12
+      },
+      md: {
+        width: 34,
+        height: 34,
+        fontSize: 13
+      },
+      lg: {
+        width: 40,
+        height: 40,
+        fontSize: 15
+      }
+    }
+  },
+  dateInput: { options: {
+    toggleSymbol: "calendar_month",
+    popupShadow: "menu",
+    popupBorderRadius: "xs",
+    popupColor: "primary-surface"
+  } },
+  timeInput: { options: {
+    toggleSymbol: "schedule",
+    listColor: "primary-surface",
+    listShadow: "menu",
+    listBorderRadius: "xs",
+    maxVisibleOptions: 7
+  } },
+  dateTimeInput: { options: {
+    partGap: "sm",
+    dividerColor: "outline"
+  } },
   button: {
     options: {
       borderRadius: "max",
@@ -13003,16 +15414,19 @@ var deepMerge = (base, override) => {
   for (const [key, value] of Object.entries(override)) out[key] = isRecord$1(value) && isRecord$1(out[key]) ? deepMerge(out[key], value) : value;
   return out;
 };
-var createTheme = ({ id, name, colors, icons = {}, radii = BaseRadii, shadows = BaseShadows, borders, components }) => ({
+var createTheme = ({ id, name, colors, icons = {}, radii = BaseRadii, shadows = BaseShadows, typography, borders, thicknesses, components }) => ({
   id,
   name,
   colors,
-  typography: BaseTypography,
+  typography: deepMerge(BaseTypography, typography),
   borders: deepMerge(buildBorders(colors), borders),
   radii,
   shadows,
   spacing: BaseSpacing,
-  thicknesses: BaseThicknesses,
+  thicknesses: {
+    ...BaseThicknesses,
+    ...thicknesses
+  },
   icons: {
     ...BaseIcons,
     ...icons
@@ -13880,6 +16294,19 @@ function buildStoredTheme(id) {
     { id: theme.id, name: theme.name, mode: modeOf(id), theme: dehydrateTheme(theme) }
   ]);
 }
+function buildDtcgTokens(id) {
+  const theme = UniThemes[id];
+  if (!theme) {
+    const ids = Object.keys(UniThemes).join(", ");
+    return { ok: false, error: `No theme found with id \`${id}\`. Available: ${ids}.` };
+  }
+  const tokens = emitDtcgTokens({
+    colors: theme.colors,
+    radii: theme.radii,
+    spacing: theme.spacing
+  });
+  return { ok: true, json: JSON.stringify(tokens, null, 2) };
+}
 function summarizeEnvelope(env) {
   const list = env.themes.map((t) => `\`${t.id}\` (${t.mode})`).join(", ");
   const failing = env.contrast?.failing.length ? `
@@ -13957,7 +16384,7 @@ function createUniServer() {
   const server = new McpServer(
     { name: "uni-design-system", version: meta.version },
     {
-      instructions: "Authoritative interface to the Uni Design System. Prefer these tools over recalling component APIs or token values from memory: names, props, and tokens here match the exact Uni release the developer installed. Start with `list-components` or `search`, then `get-component` / `get-component-examples`. Use real token ids (via `list-tokens`) instead of raw hex. Theming has four tools, split by what you need: to brand an app permanently, call `generate-uni-theme` once and write the returned static `uni-theme.ts` \u2014 then change look and feel by editing that file's tokens directly, since shared tokens propagate everywhere; to apply a theme immediately with no build step (previews, per-tenant theming, generated UI), call `generate-runtime-theme` or `get-runtime-theme` and register the JSON they return; to read a theme's token values without applying one, use `get-theme-template`. Never inline `<svg>` in a component: when you meet inline SVG, or a brand icon set to import, call `create-icon-tokens` to convert it into theme icon tokens, add them to `uni-theme.ts`, and render with `<uni-icon name=\"\u2026\" />`."
+      instructions: 'Authoritative interface to the Uni Design System. Prefer these tools over recalling component APIs or token values from memory: names, props, and tokens here match the exact Uni release the developer installed. Start with `list-components` or `search`, then `get-component` / `get-component-examples`. Use real token ids (via `list-tokens`) instead of raw hex. Theming has four tools, split by what you need: to brand an app permanently, call `generate-uni-theme` once and write the returned static `uni-theme.ts` \u2014 then change look and feel by editing that file\'s tokens directly, since shared tokens propagate everywhere; to apply a theme immediately with no build step (previews, per-tenant theming, generated UI), call `generate-runtime-theme` or `get-runtime-theme` and register the JSON they return; to read a theme\'s token values without applying one, use `get-theme-template`. Never inline `<svg>` in a component: when you meet inline SVG, or a brand icon set to import, call `create-icon-tokens` to convert it into theme icon tokens, add them to `uni-theme.ts`, and render with `<uni-icon name="\u2026" />`. For release questions ("what changed in 8.1?", "what does upgrading get me?"), call `get-changelog`.'
     }
   );
   server.registerTool(
@@ -14099,6 +16526,21 @@ function createUniServer() {
     },
     async ({ id }) => runtimeTheme(buildStoredTheme(id))
   );
+  server.registerTool(
+    "export-dtcg-tokens",
+    {
+      title: "Export DTCG design tokens",
+      description: "W3C DTCG JSON (Style Dictionary compatible) for a built-in Uni theme \u2014 the color, radius, and spacing scales, named with Uni token ids. Use this to feed external token pipelines; the `UniTheme` JSON from the theme tools remains the lossless primary format.",
+      inputSchema: {
+        theme: z.string().describe('Theme id, e.g. "LightTheme" or "DarkTheme".')
+      }
+    },
+    async ({ theme }) => {
+      const result = buildDtcgTokens(theme);
+      if (!result.ok) return { content: [{ type: "text", text: result.error }], isError: true };
+      return text("```json\n" + result.json + "\n```");
+    }
+  );
   server.registerTool(
     "create-icon-tokens",
     {
@@ -14118,6 +16560,26 @@ function createUniServer() {
     },
     async ({ icons }) => text(formatIconTokens(icons))
   );
+  server.registerTool(
+    "get-changelog",
+    {
+      title: "Get release notes",
+      description: 'Release notes for the Uni packages, from their changesets changelogs. Answers "what changed in X?" and "what do I get by upgrading?". Pass `version` for one release\'s full notes ("8.1" matches every 8.1.x), `since` for the full notes of every release after an installed version (an upgrade diff), or neither for a compact release list.',
+      inputSchema: {
+        package: z.string().optional().describe('npm name or short name, e.g. "uni-angular" (default), "uni-core", "uni-react", "uni-mcp".'),
+        version: z.string().optional().describe('One release, e.g. "8.1.0" or "8.1".'),
+        since: z.string().optional().describe('Every release newer than this version, e.g. the installed "8.0.0".')
+      }
+    },
+    async ({ package: pkg, version, since }) => {
+      const cl = getChangelog(pkg);
+      if (!cl) {
+        const known = listChangelogs().map((c) => `\`${c.package}\``).join(", ");
+        return text(`No changelog for \`${pkg}\`. Known packages: ${known}.`);
+      }
+      return text(formatChangelog(cl, { version, since }));
+    }
+  );
   server.registerTool(
     "search",
     {
@@ -14223,6 +16685,35 @@ function registerResources(server) {
       };
     }
   );
+  server.registerResource(
+    "changelog",
+    new ResourceTemplate("uni://changelog/{package}", {
+      list: async () => ({
+        resources: listChangelogs().map((c) => ({
+          uri: `uni://changelog/${c.package.split("/").pop()}`,
+          name: `${c.package} changelog`,
+          description: `Release notes, latest ${c.releases[0]?.version ?? "none"}.`
+        }))
+      })
+    }),
+    {
+      title: "Uni changelog",
+      description: "A package's release notes (compact digest).",
+      mimeType: "text/markdown"
+    },
+    async (uri, { package: pkg }) => {
+      const cl = getChangelog(String(pkg));
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            mimeType: "text/markdown",
+            text: cl ? formatChangelog(cl) : `Unknown package: ${pkg}`
+          }
+        ]
+      };
+    }
+  );
   server.registerResource(
     "guidelines",
     new ResourceTemplate("uni://guidelines/{id}", {
@@ -14260,4 +16751,4 @@ export {
   buildStoredTheme,
   createUniServer
 };
-//# sourceMappingURL=chunk-GT3T5DVX.js.map
+//# sourceMappingURL=chunk-JOMMURY6.js.map