@recursica/adapter-mantine-v8 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,688 @@
+# @recursica/adapter-mantine-v8
+
+## 0.55.2
+
+### Patch Changes
+
+- 46b123a: Breadcrumb now marks its last child `aria-current="page"` and, if it looks interactive (has `href`/`onClick`), strips both and drops it from the tab order — best-effort, not a guarantee for custom Link components with their own internal navigation. Backed by a CSS reset (no color/underline/pointer-events) and the current item now picks up Link's font-family. New shared `markCurrentPageItem` util in adapter-common. mui-adapter's story also gets parity with adapter-mantine-v8's: the last crumb renders as plain text, not a `Link`.
+- 39de7b2: mui-adapter: Dropdown now renders its `placeholder` prop and gains a matching `.placeholder` style; Autocomplete's open menu now has the same input-to-menu gap as mantine; TimePicker's leading icon is no longer offset too far right.
+  adapter-mantine-v8: DatePicker's read-only value is now formatted via `valueFormat` instead of a raw `Date.toString()`; TimePicker's leading icon no longer overlaps the field text.
+- 46b123a: Link now replaces the browser's native focus outline with the recursica focus ring (`--recursica_brand_states_focus_*`), matching Button/every other interactive component instead of falling back to the browser default. Fixes the same incorrect ring on Breadcrumb, since its items are typically Links.
+- 39de7b2: Breadcrumb story: last crumb is now plain text instead of a `Link` — it represents the current page and shouldn't be clickable.
+- 39de7b2: mui-adapter: Stepper's connector gap, description content, and button spacing now match mantine; Stepper vertical spacing now matches mantine; Timeline's connector now reaches the next bullet; Tree's chevron-to-label gap now uses the right token; Pagination is now fully wired up (circle size/colors/outline, chevron colors/hover, ripple removed, ellipsis centering, text labels).
+  adapter-mantine-v8: Stepper's completed/current label and description colors now apply (were silently falling back to Mantine's own default gray/black).
+- 39de7b2: mui-adapter: Switch's read-only label and static-variations spacing now match mantine; Label's right-alignment and optional-text parentheses now work; Button's loading state shows only a centered loader (no label); Text's static-variations spacing matches mantine; Tabs' `inverted` variant now actually renders the tab list below the content.
+  adapter-mantine-v8: Button's loader color now matches its label text color; Tabs' `inverted` variant now actually renders the tab list below the content; Grid gains a `ResponsiveSizes` story mirroring mui-adapter's.
+- Updated dependencies [46b123a]
+  - @recursica/adapter-common@0.28.2
+
+## 0.55.1
+
+### Patch Changes
+
+- a104e8a: Removed `searchable` from `Dropdown`'s shared contract — not a supported feature (that's `AutoComplete`'s job). adapter-mantine-v8 now strips it at runtime like its other unsupported native props; mui-adapter never wired it up.
+- a104e8a: Fixed `Panel`'s `wrapHeaderText` default (was `false`, contract documents `true`) in both adapters.
+- Updated dependencies [a104e8a]
+- Updated dependencies [a104e8a]
+  - @recursica/adapter-common@0.28.1
+
+## 0.55.0
+
+### Minor Changes
+
+- cb3796a: Added an `animate` prop to `Loader` (default `true`) — set `false` to freeze its CSS animation for a deterministic render, e.g. a visual-regression snapshot. The `Static*` Loader stories now use it, and the animated `Default`/`LayerTwoOval` stories are excluded from adapter-tester's visual regression.
+
+### Patch Changes
+
+- cb3796a: Wired up unused design tokens (Accordion open state, Modal header/footer background, stacked Label width, TimePicker leading icon + placeholder opacity) and added `recursica-ignore` exemptions for tokens confirmed inapplicable by design.
+- cb3796a: Fixed `Table` currency columns so header and footer cells right-align to match value cells. `Table.Th`/`Table.Cell` header context now supports `variant="currency"`.
+- Updated dependencies [cb3796a]
+- Updated dependencies [cb3796a]
+- Updated dependencies [cb3796a]
+  - @recursica/adapter-common@0.28.0
+
+## 0.54.0
+
+### Minor Changes
+
+- c31d5ae: Added an `animate` prop to `Loader` (default `true`) — set `false` to freeze its CSS animation for a deterministic render, e.g. a visual-regression snapshot. The `Static*` Loader stories now use it, and the animated `Default`/`LayerTwoOval` stories are excluded from adapter-tester's visual regression.
+
+### Patch Changes
+
+- c31d5ae: Wired up unused design tokens (Accordion open state, Modal header/footer background, stacked Label width, TimePicker leading icon + placeholder opacity) and added `recursica-ignore` exemptions for tokens confirmed inapplicable by design.
+- c31d5ae: Fixed `Table` currency columns so header and footer cells right-align to match value cells. `Table.Th`/`Table.Cell` header context now supports `variant="currency"`.
+- Updated dependencies [c31d5ae]
+- Updated dependencies [c31d5ae]
+- Updated dependencies [c31d5ae]
+  - @recursica/adapter-common@0.27.0
+
+## 0.53.0
+
+### Minor Changes
+
+- 786d870: Version bumped
+
+## 0.52.0
+
+### Minor Changes
+
+- f618b38: Renamed the `Title` component to `Heading` (and `RecursicaTitleProps` to `RecursicaHeadingProps`) to match designers' semantic vocabulary. `Text` is unchanged. Breaking: update imports from `Title`/`TitleProps` to `Heading`/`HeadingProps`.
+
+### Patch Changes
+
+- Updated dependencies [f618b38]
+  - @recursica/adapter-common@0.26.0
+
+## 0.51.0
+
+### Minor Changes
+
+- ae939ef: Latest adapters and tester
+
+### Patch Changes
+
+- ae939ef: Fixed descender clipping (e.g. the "g" in a long label) on single-line ellipsis truncation across Accordion, AutoComplete/Autocomplete, Button, Dropdown, Modal, and Panel — switched `overflow: hidden` to `overflow: clip; overflow-clip-margin: 0.35em`.
+- ae939ef: Added `text-wrap: balance` to `Text` and `Title` so wrapped multi-line text (headings and paragraphs) gets more even line lengths.
+
+## 0.50.6
+
+### Patch Changes
+
+- 9f00386: Fix `FormControlWrapper`: label now uses `htmlFor` instead of `id`, and the field's `id` is cloned onto the child, so `label.control` resolves and clicking the label focuses the field.
+
+## 0.50.5
+
+### Patch Changes
+
+- d48149c: Chip's selected checkmark now overlays the leading icon instead of sitting to its left, matching MUI's native behavior (mui-adapter already did this; adapter-mantine-v8 now matches).
+
+## 0.50.4
+
+### Patch Changes
+
+- d0e6275: Fixed stories to remove layer
+- 662c591: Layout components (Flex, Stack, Group, Grid) no longer share a formal Recursica prop contract from `adapter-common` — removed `RecursicaFlexProps`/`RecursicaStackProps`/`RecursicaGroupProps`/`RecursicaGridProps`/`RecursicaGridColProps`. Each adapter's layout components now simply pass through the underlying kit's own props, plus `rec-*` spacing token support.
+
+  - adapter-mantine-v8: Flex/Stack/Group unchanged at the API level (Mantine's own props already matched). **Grid's `gap` prop reverts to Mantine's native `gutter`**; `Grid.Col`'s responsive breakpoint objects use Mantine's own `xs` (not the invented `base`) as the smallest key.
+  - mui-adapter: Flex/Group keep their Mantine-shaped props (MUI has no native equivalent). **Stack now passes through MUI's own `spacing`/`alignItems`/`justifyContent` directly** (fixes a bug where passing native `alignItems`/`justifyContent` was silently clobbered). **Grid is rebuilt on MUI's own vocabulary** (`spacing`, `size`, `offset`, `order`, `xs`/`sm`/`md`/`lg`/`xl`) instead of mirroring Mantine's `gap`/`span`/`base`; container-level `grow` is dropped in favor of MUI's native per-column `size="grow"`.
+
+- 4fdd1af: Wired vitest into `npm test` (unit tests for utils). Added a Button/kit CSS-isolation DOM test, run separately via `npm run test:dom` (not part of `npm test`/CI). Added empty test scaffolds per component.
+- Updated dependencies [662c591]
+  - @recursica/adapter-common@0.25.1
+
+## 0.50.3
+
+### Patch Changes
+
+- df9d189: Fixed Button ignoring a constraining parent width — it now shrinks and truncates the label with an ellipsis instead of overflowing.
+
+## 0.50.2
+
+### Patch Changes
+
+- f34665a: Modal close button now matches the Button component's styling (radius, padding, color tokens, hover/focus states, icon sizing).
+- f34665a: Modal title now truncates with an ellipsis instead of wrapping when it's too long, and adapter-mantine-v8's Modal width scales with content again instead of being pinned at 440px. Added an open-by-default `LongTitle` story to both adapters.
+
+## 0.50.1
+
+### Patch Changes
+
+- a41c9ce: Fix DatePicker calendar day focus ring using the browser's default blue outline instead of a Recursica token.
+
+## 0.50.0
+
+### Minor Changes
+
+- 2369301: Add optional `maxHeight` prop to Menu, overriding the token-driven dropdown max-height with an explicit pixel value.
+
+### Patch Changes
+
+- Updated dependencies [2369301]
+  - @recursica/adapter-common@0.25.0
+
+## 0.49.0
+
+### Minor Changes
+
+- bc70636: Add optional `leadingIcon`/`supportingText` fields to Autocomplete/Dropdown `data` items, rendered inside the option row by default. Add a `wrapItemText` prop (default `false`) to wrap label/supportingText instead of truncating with an ellipsis.
+
+### Patch Changes
+
+- bc70636: Fix Dropdown/Autocomplete selected-option background highlight. adapter-mantine-v8 was keying off `data-combobox-selected` (Mantine's transient keyboard-nav highlight) instead of `data-combobox-active` (the real "matches current value" attribute), so the highlight only showed while arrow-key navigating. mui-adapter's Autocomplete had no selected-state rule at all; now keys off MUI's own `aria-selected`.
+- Updated dependencies [bc70636]
+  - @recursica/adapter-common@0.24.0
+
+## 0.48.1
+
+### Patch Changes
+
+- 5369e5b: Hide the FileInput chip row's native horizontal scrollbar while keeping it scrollable.
+
+## 0.48.0
+
+### Minor Changes
+
+- b7f76d8: Slider: added two-thumb range mode via a `[number, number]` value/onChange, fixed `trailingIcon` rendering after the numeric input instead of before it, and fixed marks (mantine) and mark labels (mantine, mui) rendering off Mantine/MUI internal defaults instead of recursica tokens, leaving marks vertically off-center and label spacing too tight.
+
+### Patch Changes
+
+- d8a0da1: Fix Tree's chevron button stealing DOM focus on click while `aria-hidden`, which browsers flag as an accessibility violation.
+- Updated dependencies [b7f76d8]
+  - @recursica/adapter-common@0.23.0
+
+## 0.47.0
+
+### Minor Changes
+
+- e4759d1: Slider: fixed the raw numeric value duplicating next to the track when `tooltipLabel` is a formatter (now reuses the same formatter), added `minLabel`/`maxLabel` overrides for the track's end labels, and added a `trailingIcon` prop alongside the existing leading `icon`.
+
+### Patch Changes
+
+- Updated dependencies [e4759d1]
+  - @recursica/adapter-common@0.22.0
+
+## 0.46.0
+
+### Minor Changes
+
+- 0bb2dab: **Breaking:** `Chip`'s `onRemove` prop is renamed to `onDelete` in both adapters, matching MUI's own `onDelete` naming and removing the previous internal aliasing between the two. Update any `Chip` usage passing `onRemove` to `onDelete` — the behavior (rendering the remove/X icon and firing on click or Enter/Space) is unchanged. `FileInput` and `FileUpload`'s own public props are unaffected; they only consume `Chip` internally.
+- 0bb2dab: Updated props with breaking changes
+
+### Patch Changes
+
+- Updated dependencies [0bb2dab]
+- Updated dependencies [0bb2dab]
+  - @recursica/adapter-common@0.21.0
+
+## 0.45.0
+
+### Minor Changes
+
+- bcac5c7: Updated to latest css and fixed link
+- 40832c5: Updated Table
+
+### Patch Changes
+
+- 8376651: Pin internal `@recursica/*` dependencies to real semver ranges instead of `*`. Published packages previously depended on internal packages (e.g. `@recursica/adapter-common`, `@recursica/official-release`, `@recursica/schemas`, `@recursica/recursica-postcss-vars`) with an unconstrained `*` version range, meaning a fresh install could pull in any future major version, including breaking changes. These now use `^<current-version>` ranges, which Changesets will keep in sync automatically via `updateInternalDependencies: "patch"` on future releases. No effect on local monorepo development — npm workspaces links sibling packages by name regardless of the declared range.
+- Updated dependencies [bcac5c7]
+- Updated dependencies [bcac5c7]
+- Updated dependencies [40832c5]
+  - @recursica/official-release@2.8.0
+  - @recursica/adapter-common@0.20.0
+
+## 0.44.0
+
+### Minor Changes
+
+- adab23c: Revised Dropwdown, Menu, Breadcrumb
+
+## 0.43.0
+
+### Minor Changes
+
+- d171a96: Update revision to latest
+
+### Patch Changes
+
+- Updated dependencies [d171a96]
+  - @recursica/adapter-common@0.19.0
+
+## 0.42.1
+
+### Patch Changes
+
+- 015c809: DatePicker's calendar (hover, today, weekend, disabled/outside days, in-range, header nav/month-label as Recursica text buttons, popover border/shadow) is now fully token-driven. Default value format is `MM/DD/YY`, `highlightToday` defaults to `true`, a default calendar icon is provided (overridable via `leftSection`), and the field no longer wraps its value/placeholder to a second line. Default placeholder is `"MM / DD / YY"` (overridable via `placeholder`).
+- 56e0d63: Remove all `recursica-ignore` exemption comments so the token analyzer report reflects true unused/unimplemented Figma variables. No runtime behavior change.
+
+## 0.42.0
+
+### Minor Changes
+
+- e0f5643: Implement `TransferList` (dual listbox) in both adapters, replacing the "coming soon" stub. Composes `FormControlWrapper`, `TextField`, `Checkbox`/`CheckboxGroup`, `Badge`, and `Button` — supports controlled/uncontrolled `data`, per-item grouping, per-pane search, and `stacked`/`side-by-side` form layout.
+- 2fb7069: Fix `Slider`'s `Disabled` story (was passing `disabled: false` in both adapters). In `mui-adapter`, also fix the disabled track showing red instead of grey, make the thumb focus ring keyboard-only (no glow on click/drag) to match Mantine, render assistive text as a `<span>`, and align mark label color/position with Mantine (which now applies its own mark label color token too).
+- 2fb7069: Fix `TextArea`: error state border now uses the recursica error color (was never triggering in either adapter). MUI disabled background/border, focus ring color, and default height now match Mantine instead of MUI's own defaults.
+
+### Patch Changes
+
+- 1616144: Fix `FileInput`'s clear-all button: pressing Enter or Space while it was focused opened the native file picker instead of clearing the selection (a regression from switching the control to the shared `Button` component, which dropped the keydown handler the previous bespoke element had).
+- 3ff5821: Fix `TransferList` checkboxes not toggling/showing checked state in either adapter (grouping-for-layout was silently overriding item selection). Add `readOnly` support and a `ReadOnly` story.
+- Updated dependencies [e0f5643]
+- Updated dependencies [1616144]
+- Updated dependencies [3ff5821]
+  - @recursica/adapter-common@0.18.0
+
+## 0.41.0
+
+### Minor Changes
+
+- 3d75770: Implement the `FileInput` component (single-line, `TextField`-shaped file picker with a native drag-and-drop drop target, single- and multiple-file modes, and a trailing clear icon) in `adapter-mantine-v8` and `mui-adapter`, replacing the "coming soon" stub, with a shared `RecursicaFileInputProps` contract in `adapter-common` reusing `FileUpload`'s `RecursicaFileUploadItem`/validation interface (`accept`/`maxSize`/`maxFiles`/`readOnly`). Also adds `FileInput` to `RECURSICA_COMPONENTS` and moves `mui-adapter`'s export of it into the standard `wrapComponent` set (it was previously exported unwrapped, alongside the polymorphic layout primitives, as a leftover from its stub form).
+
+### Patch Changes
+
+- b86ca2b: `FileInput` now renders every selected file as a removable `Chip` in a horizontally scrollable row, in both single- and multiple-file mode (previously single-file mode showed plain filename text with no remove affordance). The trailing clear-all control is now a real shared `Button` (icon-only, "text" variant) instead of a bespoke `<span role="button">`.
+- Updated dependencies [3d75770]
+- Updated dependencies [b86ca2b]
+  - @recursica/adapter-common@0.17.0
+
+## 0.40.0
+
+### Minor Changes
+
+- 1c317a3: Implement the `FileUpload` component (drag-and-drop dropzone, browse-button fallback, removable file-chip list) in `adapter-mantine-v8` and `mui-adapter`, replacing the "coming soon" stub, with a shared `RecursicaFileUploadProps`/`RecursicaFileUploadItem` contract in `adapter-common`. Also fixes `mui-adapter`'s `Chip` component's public type to allow `children` (a pre-existing type-only gap; the component already accepted them at runtime).
+
+### Patch Changes
+
+- 1c317a3: `FileUpload` now surfaces a built-in error message ("File type not accepted", overridable via the new `invalidFileTypeMessage` prop) when a dropped/picked file doesn't match `accept`, shown through the standard assistive-text error slot instead of requiring the integrator to wire up `onFilesRejected` themselves. Also reverts `FileUpload`'s assistive/error rendering back to `FormControlWrapper` (file list renders above the assistive/error text again, matching every other form control).
+
+  Fixes `Chip` clipping the descender (e.g. the "g" in "image.png") off long labels — `overflow: hidden` was clipping vertically as well as horizontally, cutting off glyph ink whenever the line-height token was tighter than the font's natural ascent+descent.
+
+- 1c317a3: `FileUpload` now supports a `maxFiles` prop (with an overridable `maxFilesMessage`, defaulting to "Maximum of {maxFiles} files allowed") that rejects files past a total-count cap the same way `accept`/`maxSize` already do.
+
+  Fixes `Chip` rendered without a real handler (`onRemove`/`onClick`/`onChange`) — such as `FileUpload`'s `readOnly` file list — still showing a pointer cursor on hover and picking up a phantom, un-styled keyboard Tab stop on its truncated label text. Both were general `Chip` bugs, not specific to `FileUpload`.
+
+- 1c317a3: Fix `Button` showing the native browser focus outline instead of the recursica focus ring, and fix `Chip` losing its remove (X) icon behind an overflowing long label instead of truncating with an ellipsis. Adds optional `removeTabIndex`/`removeIconRef` props to `Chip` for building keyboard-navigable chip groups. Also fixes the remove icon's own focus ring rendering in the chip's neutral border color instead of the recursica focus-ring color, making it barely visible.
+- 1c317a3: Fix `TimePicker`'s AM/PM dropdown showing blank until an hour is typed; it now defaults to "AM", matching `mui-adapter`.
+- Updated dependencies [1c317a3]
+- Updated dependencies [1c317a3]
+- Updated dependencies [1c317a3]
+- Updated dependencies [1c317a3]
+  - @recursica/adapter-common@0.16.0
+
+## 0.39.0
+
+### Minor Changes
+
+- 106bc34: Accordion: closed silent prop-contract conflicts where native `expanded`/`onChange`/`expandIcon`/`icon` could override Recursica's own computed state, made `variant` a real predefined union instead of a bare string, and formally supported a per-item `disabled` prop in both adapters.
+  Also documented `children` across all Accordion sub-components in `RecursicaAccordionProps.ts`, including a new `RecursicaAccordionPanelProps` interface for the Panel.
+- 106bc34: AssistiveElement: `assistiveVariant="error"` now defaults `role="alert"` in both adapters so
+  error text is announced by assistive tech as it appears or changes (an explicit `role` still
+  wins). Also (MUI only) closed a prop-contract conflict where native `error`/`component` could
+  silently override Recursica's own computed values, added the missing `RecursicaOverStyled`
+  wrapper, and hardened a CSS specificity tie against MUI's own `.Mui-error` color. Documented
+  `children` in `RecursicaAssistiveElementProps.ts` and added implementation notes to both adapters.
+
+### Patch Changes
+
+- 106bc34: AutoComplete (Mantine): fixed error state not turning the border red — the `wrapperProps` `data-error` hack (copied from `Input`-based components) targets Mantine's `Input.Wrapper` for `InputBase`-based components like `Autocomplete`, not the input's own root box, so it never reached the CSS. Now passes `error` as a boolean directly to Mantine's `Autocomplete`, which sets the border-triggering attribute natively without duplicating the assistive error text.
+- 106bc34: Avatar (MUI): fixed `variant` being fed into MUI's native shape prop instead of a color treatment, making it a silent no-op. Also documented `children` in the shared prop types and added missing mui-adapter implementation notes.
+- 106bc34: Switch: attached `SwitchGroup` as the `Switch.Group` compound export (it existed standalone but was never attached), and tightened `RecursicaSwitchGroupProps` value types from `unknown[]` to `string[]`.
+- 106bc34: SwitchGroup: fixed `side-by-side` layout always rendering as if stacked — the group was capped to the switch-item label's own 200px max-width, narrower than the mandatory 224px label column, guaranteeing a wrap.
+- 106bc34: Switch (Mantine): fixed the focus ring rendering Mantine's default blue instead of Recursica's focus token — suppressed the native outline and drew the real ring on the track.
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+  - @recursica/adapter-common@0.15.0
+
+## 0.38.1
+
+### Patch Changes
+
+- 778151b: Bundle `@recursica/adapter-common`'s types into each adapter's published `.d.ts` (via `vite-plugin-dts`'s `rollupTypes` + `bundledPackages`). Previously the generated declaration files re-exported and referenced `@recursica/adapter-common` by bare package specifier, which meant consumers' TypeScript needed `@recursica/adapter-common` resolvable even though the runtime JS and CSS were already fully self-contained. No public API changes — type names and shapes are unchanged, they're just inlined now instead of imported from the dependency.
+
+## 0.38.0
+
+### Minor Changes
+
+- 8322c0a: Updated Tree component
+
+### Patch Changes
+
+- Updated dependencies [8322c0a]
+  - @recursica/adapter-common@0.14.0
+
+## 0.37.0
+
+### Minor Changes
+
+- a4a45ff: Implement `TimePicker` (previously a stub) in both adapters, using `@mantine/dates`'s own `TimePicker` and `@mui/x-date-pickers`'s `TimePicker` respectively. Defaults to 12-hour format with a dedicated AM/PM selector (Recursica-specific); pass the new `hideAmPm` prop for a plain 24-hour input.
+
+### Patch Changes
+
+- Updated dependencies [a4a45ff]
+  - @recursica/adapter-common@0.13.1
+
+## 0.36.1
+
+### Patch Changes
+
+- 5c10166: Split shared contributor docs (`COMPONENT_DEV_GUIDE.md`, `COMPONENT_STORYBOOK_GUIDE.md`) into a canonical version in `adapter-common` plus thin per-adapter deltas, and publish `docs/PHILOSOPHY.md` to npm.
+
+## 0.36.0
+
+### Minor Changes
+
+- 6e99afc: Versioned all for refresh
+- 560874f: Updated to latest JSON and updated adaper
+- dc583f5: Add the `Tree` component (adapter-mantine-v8 wraps `@mantine/core`'s `Tree`; mui-adapter wraps the new `@mui/x-tree-view` peer dependency). Adds shared `RecursicaTreeProps`/`RecursicaTreeNode` to adapter-common.
+
+### Patch Changes
+
+- Updated dependencies [560874f]
+- Updated dependencies [6e99afc]
+- Updated dependencies [560874f]
+- Updated dependencies [dc583f5]
+  - @recursica/official-release@2.7.0
+  - @recursica/adapter-common@0.13.0
+
+## 0.35.1
+
+### Patch Changes
+
+- 70ad4df: Fixed AssistiveElement not being exported from the package's public entry point (it existed as a component but was missing from both the internal component barrel and the top-level package export, making it unreachable via `import { AssistiveElement } from "@recursica/adapter-mantine-v8"`).
+- 70ad4df: `RecursicaThemeProvider` now automatically wraps its children in a base `<Layer layer={0}>` by default (new `initLayer0` prop, defaults to `true`), so page-level surface/border/elevation CSS variables resolve out of the box instead of requiring an undocumented manual `<Layer layer={0}>` wrapper. Opt out with `initLayer0={false}` to place the base layer yourself. Also documented `Layer` and `RecursicaThemeProvider` (previously referenced by nearly every other component's USAGE.md but undocumented themselves) with dedicated USAGE.md pages and llms.txt entries in both adapters, and updated the shared Storybook theme decorator to opt out of the new default (each adapter's preview already places its own configurable per-story Layer).
+- Updated dependencies [70ad4df]
+  - @recursica/adapter-common@0.12.0
+
+## 0.35.0
+
+### Minor Changes
+
+- c49adb9: Added a Grid component (Grid, Grid.Col) to both the adapter-mantine-v8 and mui-adapter, sharing RecursicaGridProps/RecursicaGridColProps from adapter-common so both adapters expose the exact same prop API. adapter-mantine-v8 wraps Mantine's native Grid/Grid.Col directly; mui-adapter hand-composes the same API from MUI's single merged Grid component, since MUI has no separate container/item split.
+
+### Patch Changes
+
+- Updated dependencies [c49adb9]
+  - @recursica/adapter-common@0.11.0
+
+## 0.34.0
+
+### Minor Changes
+
+- f52662b: Updated docs and layout. Added Table
+
+## 0.33.0
+
+### Minor Changes
+
+- db7701f: Updated layout of docs and mcp
+
+## 0.32.0
+
+### Minor Changes
+
+- e0f2fc5: Update to latest official version
+
+### Patch Changes
+
+- Updated dependencies [e0f2fc5]
+  - @recursica/official-release@2.6.0
+
+## 0.31.0
+
+### Minor Changes
+
+- 584208e: Updated official release
+
+## 0.30.0
+
+### Minor Changes
+
+- c7051d2: Fixed official release and rev'd all package
+
+### Patch Changes
+
+- Updated dependencies [c7051d2]
+  - @recursica/adapter-common@0.10.0
+  - @recursica/official-release@2.3.0
+
+## 0.29.0
+
+### Minor Changes
+
+- f4036cf: Updated official release and added Tree component
+
+### Patch Changes
+
+- f45006a: Fixed linting and typescript errors
+- Updated dependencies [f4036cf]
+- Updated dependencies [f4036cf]
+- Updated dependencies [f45006a]
+  - @recursica/official-release@2.2.0
+  - @recursica/adapter-common@0.9.1
+
+## 0.28.0
+
+### Minor Changes
+
+- 8a1ecc5: Updated overStyled and fixed exports
+
+### Patch Changes
+
+- Updated dependencies [8a1ecc5]
+  - @recursica/adapter-common@0.9.0
+
+## 0.27.0
+
+### Minor Changes
+
+- 2f237f7: Revised component props with integration issues
+
+### Patch Changes
+
+- Updated dependencies [2f237f7]
+  - @recursica/adapter-common@0.8.0
+
+## 0.26.1
+
+### Patch Changes
+
+- 8151cb1: Fixed export of adapter-common from adapters
+
+## 0.26.0
+
+### Minor Changes
+
+- ccf7d19: Updated to cause a new version release
+
+### Patch Changes
+
+- Updated dependencies [ccf7d19]
+  - @recursica/official-release@0.3.0
+
+## 0.25.0
+
+### Minor Changes
+
+- 4329756: Added official release and update mcp
+
+### Patch Changes
+
+- 8897f92: Updated agent instructions for MCP
+- 4329756: Initialize `@recursica/official-release` package to version and distribute design tokens, configure automatic postinstall copying logic, and integrate fallback setup checks.
+- Updated dependencies [4329756]
+- Updated dependencies [4329756]
+  - @recursica/official-release@0.2.0
+
+## 0.24.0
+
+### Minor Changes
+
+- 0271678: Fix Button loading state loader offset caused by brand line-height
+- 4031b12: Updated docs and finalized MCP
+
+## 0.23.0
+
+### Minor Changes
+
+- 3cb6f89: Added Slider component
+- fe9d24a: Added adapter tester and updated adapters
+
+### Patch Changes
+
+- 639ac9a: Fixed loader border issues
+
+## 0.22.0
+
+### Minor Changes
+
+- 0ead0d7: Updated to latest version of JSON and CSS
+- 0ead0d7: Updated with mui-adapter changes
+
+## 0.21.0
+
+### Minor Changes
+
+- 53682cb: Updated Button to support loading
+
+## 0.20.0
+
+### Minor Changes
+
+- 3756d7b: Cleaned up stories and added layout stories to mui-adapter
+
+## 0.19.0
+
+### Minor Changes
+
+- f37c089: Added Modal, Timeline, and Toast
+
+## 0.18.0
+
+### Minor Changes
+
+- 72174fc: Add MUI adapter, reworked storybook for adapter switching
+
+### Patch Changes
+
+- 72174fc: Updated docs and README.md links
+
+## 0.17.0
+
+### Minor Changes
+
+- 687043f: Added Tabs and Stepper components
+
+## 0.16.0
+
+### Minor Changes
+
+- 2666672: Added Link and Pagination
+
+## 0.15.0
+
+### Minor Changes
+
+- 2c26c89: Updated to latest recursica export and fixed theme import
+
+## 0.14.0
+
+### Minor Changes
+
+- 8f7ee70: Added NumberInput and Panel
+
+## 0.13.1
+
+### Patch Changes
+
+- 13b567a: Updated all documentation for better README and AGENT.md
+
+## 0.13.0
+
+### Minor Changes
+
+- b5bacdb: Added polymorphic support
+
+## 0.12.0
+
+### Minor Changes
+
+- d8f8580: Implemented menu component
+
+### Patch Changes
+
+- 9c6e275: Updated documentation
+
+## 0.11.0
+
+### Minor Changes
+
+- 7898170: Updated read-only states for all components
+
+## 0.10.0
+
+### Minor Changes
+
+- 928f346: Added switch and radio
+- cb90751: Updated container and docs
+
+## 0.9.0
+
+### Minor Changes
+
+- 7d4af9c: Updated accordion
+
+## 0.8.0
+
+### Minor Changes
+
+- 6e6256b: Updated with latest components
+
+## 0.7.0
+
+### Minor Changes
+
+- bce74c3: Updated mantine storybook config
+- a4cf78b: Updates storybook controls and added chip
+
+## 0.6.0
+
+### Minor Changes
+
+- 9e31278: Added more mantine adapter components
+
+## 0.5.0
+
+### Minor Changes
+
+- a1067c9: Implemented stories in construction and over styling
+
+## 0.4.0
+
+### Minor Changes
+
+- eb5561b: Restructured and moved new adapter-common package
+- 6df88b7: Updated storybook layout and consolidated storybook release
+- eb5561b: Updated for latest CSS config and postcss processing
+
+## 0.3.0
+
+### Minor Changes
+
+- ea86688: Updated for latest CSS config and postcss processing
+
+## 0.2.0
+
+### Minor Changes
+
+- 5e0c31f: Fixed dependency so it will import correctly
+
+### Patch Changes
+
+- 5e0c31f: Updated link to readme in package.json
+
+## 0.1.0
+
+### Minor Changes
+
+- be88cfc: Updated README and structure and provided Storybook builds
+
+## 0.0.4
+
+### Patch Changes
+
+- cec0db5: Renamed ui-kit to adapter-mantine-v8 to signal proper peer reference to Mantine
+- cec0db5: Added peer dependency for mantine in the plugin
+
+## 0.0.3
+
+### Patch Changes
+
+- 9aab210: update docs
+
+## 0.0.2
+
+### Patch Changes
+
+- c6973c2: first publish