themelia-react-ui 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,6 +1,195 @@
 # Changelog
 
-## 1.0.0 — initial release, unpublished
+## Unreleased
+
+- Increase the shared surface-x/y defaults to 1.25rem: ordinary Card insets are
+  20px, compact surfaces 10px and large surfaces/page gutters 36px at default
+  scale. Preserve independent row padding, control heights, copy gaps and radii.
+- Keep UsageCard period tabs on the shared scrollable track in narrow cards,
+  preventing wrapped labels from escaping the header into usage figures.
+
+## 1.0.2 — 2026-10-15
+
+- Raise the default outer radius from 8px to 12px. Inputs, buttons, select/facet
+  triggers, collection highlights and navigation rows share a bounded 0.75× inner
+  role (normally 9px), derived from the same public root. The height/density bound
+  prevents short controls becoming capsules under large radius overrides.
+- Enforce outer/inner ownership in repository and optional consumer checks;
+  verify painted corners, focus/selection, scoped portals and independent action/
+  field heights on desktop/mobile in both themes and densities. Preserve bounded
+  image-removal buttons and inner media-list focus targets while Card hit areas
+  retain outer corners.
+- Explain the radius roles throughout consumer/maintainer skills and catalogue
+  guides. Route border-radius, page-padding and Card-anatomy searches to their
+  actual owners, declarations and focused composition references.
+
+- Repair post-remediation findings at shared owners: independent media sizing,
+  complete directional spacing CSS/merge vocabulary, sRGB default colors,
+  dark sunken/sidebar roles, host-colored outline buttons and active feedback.
+- Restore KPI and page-title hierarchy, square heatmap cells and grouped legend,
+  gift-card balances and strip layering. Align table/code/message/image insets
+  with their actual spacing roles and preserve standalone shell/Card fonts.
+- Make calendar events compact and readable, retain mobile Today, portal tag
+  suggestions, and share compact inline actions across filters, products and
+  comments. Date pickers now inherit provider scale and accept an explicit size.
+- Add typed Card region padding, remove caller inset overrides, improve real
+  flagship analytics examples, and strengthen discovery/consumer composition
+  checks with exact imports and practical skill examples.
+- Close .ts recipe, Card-slot and SVG-embedded HTML lint gaps. Add focused
+  desktop/mobile light/dark checks and a finding-by-finding verification ledger.
+- Pair Tooltip shell/arrow with inverse text in both themes. Wrap rich search
+  metadata without clipping currency or duplicating the wide value column.
+- Consolidate corners under the single public shadcn radius root. Anchored
+  borders use the shared semantic boundary.
+
+- Align ordinary controls and menu/command highlights through their shared
+  inner role. Keep compound fields and segmented toolbars within one sized
+  border; preserve provider sizing through filters, search and calendar controls.
+- Tighten shared title/description defaults to normal 4px and dense 2px. Remove
+  typography margins and redundant Card region spacing without adding tokens.
+- Make native inputs, navigation, color pickers, provider links and framed icons
+  own their box sizing independently of consumer resets. Keep search height and
+  keyboard focus stable when clearing; preserve inline collapsed activity metadata.
+- Reject semantic-but-wrong radius/height overrides and copy margins. Route
+  consumer geometry discovery to focused references, and verify installed
+  package geometry across provider sizes, independent scales and both themes.
+
+- Retire the final 87 spacing/control debt expressions through shared row,
+  surface, control and navigation owners; reject restored lint allowances.
+  Preserve fixed chart/illustration geometry with native SVG drawings.
+- Align message continuations to actual media tracks, preserving rich avatar
+  slots, empty states, RTL and focus. Keep compact navigation text readable,
+  selected Item titles theme-aware, and documentation guides logically indented.
+- Keep avatar removal reachable outside image clipping, preserve disabled
+  Sidebar targets through tooltips, retain heatmap civil dates across timezones,
+  and announce localized comment attachment rejection with safe reset/retry.
+- Adapt auth split columns and panel visibility to the shell's own width;
+  keep feature copy shrinkable in narrow parents and scoped themes.
+
+- Repair multiline/BEM class merging and derive property-aware merge namespaces
+  from actual CSS aliases. Verify utility emission alongside generated freshness.
+- Close internal-import, static-template, passive-anatomy and omitted/default-gap
+  lint/checker gaps; improve component discovery without inventing unsupported APIs.
+- Restore Button solid/tonal states, unreset field/list/font ownership, and
+  combined trailing-action geometry. Add concurrency and state-combination regressions.
+- Add an optional Heading visual scale without changing semantic/default sizing;
+  restore prominent KPI values and native Metric navigation/actions.
+- Consolidate table scroll/focus ownership, prioritize calendar titles by available
+  parent width, and review status foreground/elevation roles in both themes.
+- Wire grouped/individual table resizing with real pointer/keyboard sizing,
+  inherited RTL direction and nonoverlapping sticky header rows. Strengthen
+  semantic focus contrast, including native field clear/reveal actions.
+- Follow Slider's actual native input focus and attach the calendar day-button
+  ref, preserving arrow-key focus and visible indicators inside date pickers.
+- Measure both field addon tracks naturally under independent scales; preserve
+  caller padding overrides without adding public theme variables.
+- Add a finding-led drift guide with concrete reproductions, shared-owner
+  repairs, image review and executed behavior checks.
+
+- Page owns larger `lg` inline/block insets, with `padding` and a centered
+  `narrow` resource-page mode; explicit width and gutter choices remain supported.
+  StackedLayout's contained measure owns the same large inline inset once.
+- Page and workspace record headers default to dense supporting-copy rhythm.
+  Standard back controls remain beside the title while wrapped page commands
+  retain the full header width. Workspace content/header/footer share token insets.
+  Workspace regions adapt to parent width; narrow workspaces scroll long headers
+  with their body, while wide regions retain independent main scrolling.
+- Add UIProvider card footer-divider defaults and the matching theme-editor
+  setting, preserving explicit overrides and one empty-body boundary. Ordinary
+  Card padding remains md.
+- AppSidebar adds pinned headerStart/headerEnd slots, uses a separated footer,
+  and inherits compact navigation spacing from LayoutSidebarProvider by default.
+- Enrich shell/account/workspace discovery, ship a complete shell recipe with
+  provider defaults, and add contextual compact-card/page-gutter review warnings.
+  Consumer guidance explicitly distinguishes Page padding from PageViewport scrolling.
+- Card headers wrap by available content space rather than a named-container
+  breakpoint. App shell variants retain their width inside the sidebar provider;
+  UsageCard period headers no longer retain a vertical flex basis after wrapping.
+- Preserve MetadataList primary value size in compact density. Separate framed
+  Card peers in provider/metadata examples and verify visible ring clearance.
+  Document card surface policy, header icon/placement and metadata hierarchy.
+- Route KPI, revenue, statistics and quota discovery to the supported analytics
+  owners. Finder results link relevant symbols, focused references and recipe
+  exports; ship analytics and centered-resource recipes with installed checks.
+- MonthYearPicker uses public Select menus for both nested selectors. Repair
+  confidence-dial centering, narrow table feedback, centered EmptyState copy,
+  floating email dismissal and responsive custom calendar event rendering.
+- MediaLibrary adds titleSuffix and an optional onItemReplace request callback
+  for the inspected asset; unsupported replacement actions remain hidden.
+- Pending overlay confirmations disable generated actions/dismissal and retain
+  modal keyboard focus; rejection restores retry. FormField no longer duplicates
+  a nested control's id onto a passive wrapper. Coupon/voucher previews exercise
+  validation, accepted results and removal through public callbacks.
+- Dialog, confirmation and sheet title/description wrappers reset native margins,
+  keeping shared copy gaps correct without a consuming app's global preflight.
+- Input and Textarea preserve loading when disabled is explicitly false, prevent
+  read-only clear actions, and clear registered/native values as well as form data.
+- HeaderSearch truncates long placeholders within narrow parents; responsive
+  HeaderUserMenu triggers retain the signed-in user's full accessible name.
+  TaskCard retains its disclosure control beside wrapping header content.
+- Add public-website discovery and a typed Container/Section service-page recipe,
+  preserving freedom to compose content without application chrome or KPI anatomy.
+- InventorySection delegates responsive header wrapping to Card, preventing a
+  vertical flex basis from creating a large blank header on narrow screens.
+- Analytics drawing follows live reduced-motion preferences with stable server
+  markup. Metric loading uses the shared Skeleton owner, and micro progress
+  disables its width transition when reduced motion is requested.
+- Item owns border-box sizing, keeping padded Attachment rows inside Message
+  content even when an application has no global CSS reset.
+
+## 1.0.1 — 2026-10-12
+
+- Consumer guidance now assigns task, scope, information priority and command
+  ownership before composition, with focused decision tables and review criteria.
+- Expand the consumer entrypoint with explicit typography/content, responsive
+  layout, localization/RTL, controlled-state and verification routing. Document
+  RichText's block container and sanitization boundaries in composition guidance.
+- Add a scoped directory recipe using Page, ResourceCell, native table query
+  slots and fixed-scope callbacks; detail facts use MetadataList.
+- Curated responsibility discovery ranks exact intent aliases beneath explicit
+  symbols/imports. Authored catalogue guidance refreshes into shipped metadata
+  and is checked for drift.
+- Ship an opt-in, read-only composition checker using the app's TypeScript dev
+  dependency. Known import/anatomy errors fail; contextual warnings and unresolved
+  dynamic values remain review evidence. Popup policy is shared with repo lint.
+- Copied-skill setup compares every installed guidance asset, including prose.
+  Installed-package checks exercise the checker and scoped directory; maintainers
+  have a separate rubric for authorized independent agent evaluations.
+- No public component APIs, theme roots or runtime dependencies change.
+- Container and DataTable explicitly own border-box sizing so page gutters and
+  framed tables stay within narrow parents without consumer preflight.
+
+## 1.0.0 — initial release
+
+### Added compositions and controls
+
+- `TaskCard` (`blocks/planning`): compact and expanded task summaries, segmented
+  animated completion, tightly spaced checked/struck-through subtasks, assignees
+  and application-owned saving/errors. Passive header clicks and the native
+  keyboard caret share controlled/uncontrolled expansion; subtask and footer
+  actions remain independent.
+- `UsageCard` (`blocks/analytics/usage-card`): quota, category, daily and resource
+  analytics, controlled periods, loading/error/retry/empty presentation and
+  explicit missing/unlimited/over-limit states. Its leaf import isolates
+  unrelated analytics peers.
+- `InlineEdit` (`base/inline-edit`): native Input/Textarea editing with shared
+  control styling and state props, typed native editor options, validation,
+  cancellable async persistence and committed native-form values. Small centered
+  actions and the persistent width/fade transition honor reduced motion.
+
+### Shared refinements
+
+- Card gains an additive semantic `gap` prop for its regions, preserving default
+  insets and spacing. Normal/dense supporting-copy rhythm remains independent.
+- Avatar sizes and overlap follow scoped avatar/space roots in all sizes and
+  RTL, including overflow-only counts.
+- Field-shaped triggers share Input's focus offset and transparent hover recipe.
+- Public entrypoints, catalogue examples, packaged discovery, consumer recipes
+  and installed-runtime coverage include the new owners. Existing typography,
+  control, row and surface recipes are reused; no dependencies or public theme
+  roots are added.
+
+### Initial release scope
 
 The npm package and all consumer imports use `themelia-react-ui`, branded
 Themelia React UI. The GitHub repository remains `themelia-react-ui`. The

package/README.md

@@ -2,14 +2,14 @@
 
 A publishable React UI package built on Base UI and Tailwind, with shadcn-compatible themes and Themelia's public APIs. Routing, persistence, permissions and translations remain consumer-owned.
 
-Package: **`themelia-react-ui`** · initial release: **`1.0.0`** · MIT licensed.
+Package: **`themelia-react-ui`** · current version: **`1.0.2`** · MIT licensed.
 The GitHub repository is `themelia-react-ui`; npm imports use `themelia-react-ui`.
 
 Consuming apps start with [consumer setup](#consumer-setup) and the packaged
 [consumer skill](docs/consumer-skill/SKILL.md). The Development section and
 repository check commands below apply to this checkout.
 
-The source port covers typography, semantic value primitives, 40 base families, 10 layout families, eight block families and 25 feature families. Products include option matrices, option editing, variant generation, managers, detail/editor surfaces, bulk selection/actions, readiness, policies and quote previews. Features contain their actual callback-driven implementations; the playground uses the same public entrypoints.
+The source port covers typography, semantic value primitives, 41 base families, 10 layout families, nine block families and 25 feature families. Products include option matrices, option editing, variant generation, managers, detail/editor surfaces, bulk selection/actions, readiness, policies and quote previews. Features contain their actual callback-driven implementations; the playground uses the same public entrypoints.
 
 Commerce blocks include `Receipt` and `ReceiptItems` from `themelia-react-ui/blocks/commerce/receipt`. Receipt owns the paper surface and delegates insets to Card; compose MetadataList, Money, separators and an optional QRCode slot. Currency/locale follow the shared formatter contract; accounting totals and verification destinations remain app-owned. See the packaged [receipt recipe](docs/consumer-skill/examples/receipt.tsx).
 
@@ -31,7 +31,11 @@ The Vite React playground has foundations, a complete searchable catalogue, and
 
 `check` runs source/documentation checks, lint/design/types/unit checks, one library build, built declaration/skill and source-map checks, the installed package harness, then one preview build, in order. `check:all` adds the curated browser regression suite against that fresh static output, with zero retries. `test:browser` rebuilds the preview and runs those regressions independently. Exactly `deep-visual-audit.spec.ts` and `deep-audit-slices.spec.ts` are evidence collectors: `collect:browser` runs them separately, and their successful collection does not establish visual acceptance. Regression screenshots use per-test Playwright output paths. Set `THEMELIA_EVIDENCE_OUTPUT` to an explicit durable directory only when preserving a review; collectors also accept `AUDIT_OUTPUT`.
 
-Documentation refreshes are explicit: `docs:sync-preview` owns only catalog public symbols, `docs:sync-props` owns local prop names/types/required flags and branch constraints, and `docs:sync-skill` owns consumer references. Checks never refresh them. Existing props prose and defaults remain reviewed metadata; native fields and undisplayed historical nonpublic records remain imported evidence. Catalog digest fields retain their historical imported scope and are not freshness checks.
+For quality reviews, reproduce each finding, repair its shared owner, inspect the
+rendered result and execute the relevant behavior. Record those results in a
+finding ledger using the [drift review guide](docs/maintainer-skills/themelia-cn-quality/drift-audit.md).
+
+Documentation refreshes are explicit: `docs:sync-preview` owns catalogue public symbols and authored literal selection guidance, `docs:sync-props` owns local prop names/types/required flags and branch constraints, and `docs:sync-skill` owns consumer references. Checks never refresh them. Existing props prose and defaults remain reviewed metadata; native fields and undisplayed historical nonpublic records remain imported evidence. Catalog digest fields retain their historical imported scope and are not freshness checks.
 
 Browser verification requires Playwright Chromium. An existing executable can be supplied through `PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH`.
 
@@ -136,15 +140,15 @@ The common geometry controls are:
 :root {
   --space-scale: 1;
   --density-scale: 1;
-  --gap-normal: 0.5rem;
-  --gap-dense: 0.25rem;
+  --gap-normal: 0.25rem;
+  --gap-dense: 0.125rem;
   --height-action: 2.25rem;
   --height-control: 2.25rem;
   --control-x: 0.75rem;
   --row-x: 0.75rem;
   --row-y: 0.5rem;
-  --surface-x: 1rem;
-  --surface-y: 1rem;
+  --surface-x: 1.25rem;
+  --surface-y: 1.25rem;
 }
 ```
 
@@ -153,7 +157,7 @@ The remaining roots cover icons/avatars, shell dimensions, content widths and ad
 Each default has one owner. There is no legacy token pipeline, JavaScript style engine, underscore prefix, or button-specific palette. Shared action/control, row, surface and text recipes prevent components from acquiring unrelated spacing or color systems.
 
 The additive copy-gap contract replaces scattered title/description gaps with
-`--gap-normal` (8px) and `--gap-dense` (4px), scaled once by `--space-scale`.
+`--gap-normal` (4px) and `--gap-dense` (2px), scaled once by `--space-scale`.
 Headed surfaces accept `textGap`, and Stack/Grid accept the same semantic gap
 values. Existing spacing tiers and public roots remain available.
 
@@ -175,7 +179,7 @@ previous independent row tint. Existing explicit `indent` values are supported.
 - Children override `Text.content`, including zero. Inverse text uses the inverse foreground pair across themes; primary text uses the readable brand accent.
 - Primary button labels use the shared `text-sm` role across control sizes. Secondary buttons use the shadcn secondary surface/foreground pair.
 - Filter presets and saved views retain the `FilterTabs`/`SavedViewTabs` APIs but expose pressed buttons rather than tabs without panels. Arrow/Home/End navigation selects presets; use `aria-pressed` instead of `aria-selected` when querying this control.
-- Framed surfaces use their shared semantic border and outer-ring recipe; the `framed` variant and provider defaults remain available. Card header actions stay on the trailing side in wide containers and move below the full-width identity in narrow containers. Translated titles and suffix badges wrap within the leading region.
+- Framed surfaces use their shared semantic border and outer-ring recipe; the `framed` variant and provider defaults remain available. Card headers wrap naturally when their title/copy and actions need more space, including inside differently named containers. Translated titles and suffix badges wrap within the leading region.
 - PopoverMenu matches plain labels/descriptions by default, preserves explicit `searchValue` overrides, and accepts `contentLabel`/`contentLabelledBy` for its popup name. Custom rows receive actual highlight state and own their structured markup.
 - AI copy feedback waits for a successful write. `onCopyError` and optional `strings.copyError` expose denied/unavailable writes; `onCopy` fires after success.
 - Card, badge, overlay and form geometry follows canonical shared recipes instead of obsolete source CSS module defaults. Typography has no incidental margins; structures own layout spacing.
@@ -199,15 +203,43 @@ Use `titleSuffix` for card status, count and version badges. `headerStart` is fu
 
 Application drawers use `ActionDrawer` and `useOverlayVisibility` from `themelia-react-ui/features/overlays`. Sheet is the structural foundation and remains available for lower-layer infrastructure and compatibility.
 
+Page owns inline and block padding, defaulting to the large surface role;
+PageViewport owns scrolling and supplies no inset. Use `Page narrow` for a
+centered single resource; explicit `maxWidth` wins. Page headers use dense copy
+gaps. Ordinary cards retain default `md` padding; configure header/footer rules
+through UIProvider's `card.defaultHeaderDivider` and `card.defaultFooterDivider`.
+AppSidebar offers pinned `slots.headerStart`/`headerEnd` around its workspace
+region, compact navigation and a separated footer. The
+[complete shell recipe](docs/consumer-skill/examples/app-layout.tsx) demonstrates
+public workspace/account controls and application-owned callbacks.
+
+Choose one ordinary card surface through `card.defaultSurface`; explicit per-card
+surfaces win. Use Card's `icon` slot for routine header icons and `headerPlacement`
+to choose inside/frame composition independently. Independent framed peers
+usually use `gap="xl"`, since outer rings consume a smaller DOM gap.
+MetadataList retains medium labels and normal primary values in both densities.
+Dashboard KPIs use Metric/MetricGrid/MetricBar; quotas use the focused UsageCard
+owner. See [analytics selection](docs/consumer-skill/references/analytics.md) and
+the [resource page recipe](docs/consumer-skill/examples/detail.tsx).
+
+The dated [whole-library review](docs/verification/2026-10-14-whole-library-review.md)
+records repaired owners, rendered/interaction evidence and remaining coverage
+limits separately from package checks.
+
 Consumer integration guidance is available in [the package consumer skill](docs/consumer-skill/SKILL.md). The token contract budgets 23 structural roots and 77 package-owned roots; derived utilities are implementation recipes, not additional customization settings.
 
+Content-led websites can compose Container, Section, Stack/Grid, shared typography
+and ordinary Card subjects without app chrome. The packaged
+[website recipe](docs/consumer-skill/examples/website.tsx) demonstrates service
+offers and real navigation links using the same theme and inset owners.
+
 
-Popover content uses `type="display"` for substantive content and `type="menu"` for collections. Mixed searchable menus use flush shells and compact region insets. `rounded-radius` is the package-wide default for cards, controls and popup shells. `rounded-inner` is opt-in for nested bodies or collection items, using the existing smaller tier. No separate surface radius or new public theme variable is introduced.
+Popover content uses `type="display"` for substantive content and `type="menu"` for collections. Mixed searchable menus use flush shells and compact region insets. `--radius` defaults to 12px. Cards and popup/command shells use `rounded-radius`; controls, collection/navigation rows and nested bodies use the shared, height-bounded `rounded-inner` role (normally 9px). Both derive from the same public root. Consumers inherit these recipes; see the [theme contract](docs/consumer-skill/references/theming.md) for scaling and custom roots. No separate surface/control radius setting is introduced.
 
 
 ## Agent skill and consumer references
 
-The npm tarball ships the complete [consumer skill](docs/consumer-skill/SKILL.md), [discovery](docs/consumer-skill/references/discovery.md), [composition](docs/consumer-skill/references/composition.md), [integration](docs/consumer-skill/references/integration.md), [theme extension](docs/consumer-skill/references/theming.md) and [workflow](docs/consumer-skill/references/workflows.md) references. Its generated [public index](docs/consumer-skill/references/public-api.json) records exact imports, symbols, declarations and peer requirements; [the recipe manifest](docs/consumer-skill/examples/manifest.json) identifies all ten runnable examples and their basic/optional phases. It contains no preview source or maintainer audit screenshots.
+The npm tarball ships the complete [consumer skill](docs/consumer-skill/SKILL.md), [discovery](docs/consumer-skill/references/discovery.md), [composition](docs/consumer-skill/references/composition.md), [integration](docs/consumer-skill/references/integration.md), [theme extension](docs/consumer-skill/references/theming.md) and [workflow](docs/consumer-skill/references/workflows.md) references. Its generated [public index](docs/consumer-skill/references/public-api.json) records exact imports, symbols, declarations and peer requirements; [the recipe manifest](docs/consumer-skill/examples/manifest.json) identifies all runnable recipes and their basic/optional phases. It contains no preview source or maintainer audit screenshots.
 
 After installing the package, find a family using its real portable script:
 
@@ -219,9 +251,27 @@ Resolve the installed package and compare copied guidance using the [installed s
 
 Repository work uses the scoped [maintainer](docs/maintainer-skills/themelia-cn-maintainer/SKILL.md), [tokens](docs/maintainer-skills/themelia-cn-tokens/SKILL.md) and [quality](docs/maintainer-skills/themelia-cn-quality/SKILL.md) skills routed by [AGENTS.md](AGENTS.md). These repo-owned guides are excluded from the consumer package and do not replace separately installed skills.
 
-Maintainers run `npm run docs:sync-skill` after changes to exports, types, selection guidance, peers or tokens. `npm run check:skill` requires a fresh library build and rejects stale source-backed references, built declaration exports and broken reference links. `prepack` checks source-backed references without rebuilding; `prepublishOnly` builds fresh assets and verifies built guidance. `check:package` verifies the complete shipped skill, then strictly compiles the seven basic recipes without optional peers and all ten with their needed peers, alongside its installed runtime checks.
+There is one packaged consumer skill with nine focused prose references, two
+generated indexes, fourteen typed recipe files and five helper scripts. Repository
+maintainer skills remain separate. The consumer entrypoint starts from task,
+context, information priority and command ownership and routes typography,
+layouts, theming, state/integration and verification detail to the relevant owner.
+Its [scoped directory recipe](docs/consumer-skill/examples/scoped-directory.tsx)
+shows one route heading, fixed parent context, integrated queries and record
+navigation. [Review and checks](docs/consumer-skill/references/review.md) describes
+the opt-in `check-composition.mjs` source checker and its TypeScript dev requirement.
+It shares popup anatomy policy with repository enforcement; ambiguous composition
+is a warning and dynamic/external styling needs review. `check:agent` verifies
+deterministic guidance infrastructure, not aesthetic judgment or new-task agent
+performance. Keep app-specific policy separate from the versioned package skill.
+
+Finder results include relevant symbols and focused next reads for declarations,
+references and exported recipes. This reduces the need to infer a component's
+purpose from its name or read every document before starting a screen.
+
+Maintainers run `npm run docs:sync-skill` after changes to exports, types, selection guidance, peers or tokens. `npm run check:skill` requires a fresh library build and rejects stale source-backed references, built declaration exports and broken reference links. `prepack` checks source-backed references without rebuilding; `prepublishOnly` builds fresh assets and verifies built guidance. `check:package` verifies the complete shipped skill, strictly compiles the basic recipes without optional peers and every recipe with its required peers, and executes installed shell/resource-page and workflow checks.
 
-Build portable consumer documentation with `npm run build` followed by `npm run build:docs`. The generated [static entry](dist-docs/index.html) links to `dist-docs/1.0.0/` for the current version. Each version preserves the complete skill and all declaration files, supports search with the same finder, and uses relative links under any hosting subdirectory. Serve the entire artifact over HTTP; it needs no external CDN. Run `npm run check:static-docs` to check generated asset paths. The future hosting destination remains pending.
+Build portable consumer documentation with `npm run build` followed by `npm run build:docs`. The generated [static entry](dist-docs/index.html) links to `dist-docs/1.0.2/` for the current version. Each version preserves the complete skill and all declaration files, supports search with the same finder, and uses relative links under any hosting subdirectory. Serve the entire artifact over HTTP; it needs no external CDN. Run `npm run check:static-docs` to check generated asset paths. The future hosting destination remains pending.
 
 `npm run check:agent` runs focused agent-consumption fixtures and built skill alignment. `npm run check:release` performs the real serial local build/package/browser/agent/static-documentation gate; it does not publish or deploy. See the [release guide](docs/releasing.md), [draft changelog](CHANGELOG.md) and [future GitHub Actions template](.github/workflows/ci.yml) for browser installation and explicit cold-cache handling. These commands verify locally; publication and deployment remain separate actions.
 
@@ -234,6 +284,25 @@ Server-side rendering, validation and delivery helpers have a separate `themelia
 Empty recipient groups show an input immediately, with an inline plus for additional addresses and Cc/Bcc input disclosure. Templates, recipient groups and variable definitions accept application-owned loading, error and retry state. Template loading leaves ordinary composing available; unavailable required recipient/variable data blocks preparation and delivery. The catalogue includes lazy template loading and failure/retry examples.
 
 
+### Task summaries, usage and inline editing
+
+- `themelia-react-ui/blocks/planning`: TaskCard composes Card, an accessible
+  disclosure and controlled checklist, with animated segmented progress, due
+  metadata and assignees. Click the header or use the keyboard caret; completion
+  persistence and Open navigation stay with the app.
+- `themelia-react-ui/blocks/analytics/usage-card`: UsageCard supplies quota,
+  category/daily/resource analytics and controlled period/request states without
+  unrelated chart peers. Missing, unlimited and over-quota data remain distinct.
+- `themelia-react-ui/base/inline-edit`: InlineEdit supplies native Input/Textarea
+  styling and options, validation, async save/cancel, focus restoration and
+  committed form values, with compact actions and reduced-motion transitions.
+
+These additions reuse the existing token roots and public composition owners.
+See the [workflow contracts](docs/consumer-skill/references/workflows.md#task-summaries-usage-and-inline-editing)
+and [typed workspace recipe](docs/consumer-skill/examples/planning-usage-edit.tsx).
+Card also accepts a semantic `gap` between its regions while preserving its
+default insets and independent title/description `textGap`.
+
 ### Hierarchies, capture and reusable content
 
 - `themelia-react-ui/base/tree`: data-driven accessible hierarchy selection and expansion.
@@ -248,3 +317,13 @@ These families add no runtime dependencies or public token roots. AppSidebar's
 `searchable` option and controlled branch expansion extend the existing sidebar;
 routing and persistence remain consumer-owned. See the catalogue and packaged
 consumer recipes for the exact contracts.
+
+Heading keeps semantic `tag` separate from optional visual `size` (`sm`, `base`,
+`lg`, `xl`, `2xl`, `3xl`, `4xl`), using existing typography variables. The admin
+default remains `base`; website examples opt into larger emphasis. Metric card,
+bordered, accent and colored values use that shared scale. A card metric's `href`
+is a native link; `onClick` without `href` is a native action.
+
+Base Table exposes `containerProps` for the single scroll/focus wrapper;
+`className` and other native table attributes still apply to the table itself.
+DataTable uses that same wrapper for its localized scroll-region name.

package/dist/{accordion-BRWh3BM1.js → accordion-BRTcsp8J.js}

@@ -1,11 +1,11 @@
 "use client";
 import { useStrings as e } from "./lib/strings.js";
-import { t } from "./utils-C2EKeIw3.js";
-import { a as n } from "./typography-Cv8MT-82.js";
+import { t } from "./utils-BvH9PSmq.js";
+import { a as n } from "./typography-BxQgiZyw.js";
 import { t as r } from "./motion-recipes-B6jKXEcN.js";
-import { t as i } from "./structure-BvW4vG4H.js";
+import { t as i } from "./structure-CRdqVawd.js";
 import { t as a } from "./disclosure-panel-B0HFNZ9x.js";
-import { t as o } from "./icon-badge-Dv0RYQwj.js";
+import { t as o } from "./icon-badge-Btc6pQrp.js";
 import * as s from "react";
 import { forwardRef as c } from "react";
 import { jsx as l, jsxs as u } from "react/jsx-runtime";
@@ -59,7 +59,7 @@ function g({ className: e, children: n, render: i, ...o }) {
 var _ = s.forwardRef(function({ className: e, ...n }, r) {
 	return /* @__PURE__ */ l(p, {
 		ref: r,
-		className: t("accordion--component rounded-radius-lg border-border bg-card", e),
+		className: t("accordion--component rounded-radius border-border bg-card", e),
 		...n
 	});
 });
@@ -76,7 +76,7 @@ var y = s.forwardRef(function({ className: e, children: r, ...i }, a) {
 	let o = typeof r == "string" || typeof r == "number" || typeof r == "bigint";
 	return /* @__PURE__ */ l(h, {
 		ref: a,
-		className: t("accordion-trigger--component min-h-action items-center gap-space-lg px-row-x py-row-y", "text-left text-sm font-medium transition-colors hover:bg-muted/40 hover:no-underline", "focus-visible:z-10 focus-visible:ring-2 focus-visible:ring-ring/50", e),
+		className: t("accordion-trigger--component min-h-action items-center gap-space-lg px-row-x py-row-y", "text-left text-sm font-medium transition-colors hover:bg-muted/40 hover:no-underline", "focus-visible:z-10 focus-visible:ring-2 focus-visible:ring-ring", e),
 		...i,
 		children: o ? /* @__PURE__ */ l(n, {
 			tag: "span",
@@ -109,7 +109,7 @@ b.displayName = "AccordionContent";
 //#region src/components/base/accordion/accordion-variants.ts
 var x = {
 	card: "gap-space-md border-0 rounded-none bg-transparent overflow-visible",
-	bordered: "rounded-radius-lg border border-border bg-card overflow-hidden",
+	bordered: "rounded-radius border border-border bg-card overflow-hidden",
 	flat: "border-0 rounded-none bg-transparent overflow-visible"
 }, S = {
 	card: "border border-border bg-card rounded-radius data-open:bg-muted/25",
@@ -202,4 +202,4 @@ function O({ iconStyle: e, icon: n, reserveSpace: r }) {
 //#endregion
 export { x as a, b as c, S as i, v as l, T as n, C as o, w as r, _ as s, E as t, y as u };
 
-//# sourceMappingURL=accordion-BRWh3BM1.js.map
+//# sourceMappingURL=accordion-BRTcsp8J.js.map

package/dist/accordion-BRTcsp8J.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-BRTcsp8J.js","names":["Accordion","AccordionPrimitive","AccordionItem","AccordionTrigger","AccordionContent","Accordion","React","PrimitiveAccordion","PrimitiveAccordionItem","PrimitiveAccordionTrigger","PrimitiveAccordionContent","Accordion","Text","motionRecipes","Stack","DisclosurePanelElement","IconBadge","React$1","Accordion$2","props","Accordion","cn","className","AccordionItem$1","AccordionTrigger$1","children","ChevronDownIcon","AccordionContent$1","panelProps","Accordion$1","AccordionItem","AccordionTrigger","isSimpleText","AccordionContent","ACCORDION_ROOT_VARIANT_CLASS","ACCORDION_ITEM_VARIANT_CLASS","ACCORDION_TRIGGER_BASE","ACCORDION_CONTENT_PADDING","defaultSmartAccordionStrings","SmartAccordion","forwardRef","stringsProp","strings","useStrings","hasIconColumn","iconStyle","items","item","contentPadding","triggerGridClass","onValueChange","next","variant","itemClassName","triggerClassName","SmartAccordionIcon","isSimpleContent","contentClassName","content","reserveSpace","icon"],"sources":["../src/components/ui/accordion.tsx","../src/components/base/accordion/accordion.tsx","../src/components/base/accordion/accordion-variants.ts","../src/components/base/accordion/accordion.strings.ts","../src/components/base/accordion/smart-accordion.tsx"],"sourcesContent":["import { DisclosurePanelElement } from './disclosure-panel';\nimport { motionRecipes } from '../../lib/motion-recipes';\nimport { Accordion as AccordionPrimitive } from \"@base-ui/react/accordion\"\n\nimport { cn } from \"../../lib/utils\"\nimport { ChevronDownIcon } from \"lucide-react\"\n\nfunction Accordion({ className, ...props }: AccordionPrimitive.Root.Props) {\n  return (\n    <AccordionPrimitive.Root\n      data-slot=\"accordion\"\n      className={cn(\"border-border accordion--component flex w-full flex-col border box-border overflow-hidden\", className)}\n      {...props}\n    />\n  )\n}\n\nfunction AccordionItem({ className, ...props }: AccordionPrimitive.Item.Props) {\n  return (\n    <AccordionPrimitive.Item\n      data-slot=\"accordion-item\"\n      className={cn(\"border-border accordion-item--component border-b last:border-b-0\", className)}\n      {...props}\n    />\n  )\n}\n\nfunction AccordionTrigger({\n  className,\n  children,\n  ...props\n}: AccordionPrimitive.Trigger.Props) {\n  return (\n    <AccordionPrimitive.Header className=\"accordion-header m-0\">\n      <AccordionPrimitive.Trigger\n        data-slot=\"accordion-trigger\"\n        className={cn(\"accordion-trigger--component flex w-full items-center justify-between border-0 bg-transparent outline-none cursor-pointer box-border\", className)}\n        {...props}\n      >\n        {children}\n        <ChevronDownIcon data-slot=\"accordion-trigger-icon\" className={cn(\"accordion-trigger--icon size-icon text-muted-foreground shrink-0 [[aria-expanded=true]_&]:rotate-180\", motionRecipes.chevron)} />\n      </AccordionPrimitive.Trigger>\n    </AccordionPrimitive.Header>\n  )\n}\n\nfunction AccordionContent({\n  className,\n  children,\n  render,\n  ...props\n}: AccordionPrimitive.Panel.Props) {\n  return (\n    <AccordionPrimitive.Panel\n      data-slot=\"accordion-content\"\n      className={cn(\"accordion-content--component box-border text-foreground h-(--accordion-panel-height)\", motionRecipes.disclosure, className)}\n      {...props}\n      render={(panelProps, state) => <DisclosurePanelElement props={panelProps} state={state} render={render} heightVariable=\"--accordion-panel-height\" />}\n    >\n      {children}\n    </AccordionPrimitive.Panel>\n  )\n}\n\nexport { Accordion, AccordionItem, AccordionTrigger, AccordionContent }\n\n","/**\n * Accordion — tokenized base wrapper around the shadcn/Base UI primitive.\n *\n * The internal primitive intentionally keeps shadcn's roomy defaults. This\n * public layer calibrates them for admin surfaces: radius tokens, 12px row\n * insets, density-aware vertical rhythm, quiet hover/focus treatments, and\n * matching trigger/content columns. Consumers retain the complete compound\n * API and can override any treatment with `className`.\n */\nimport * as React from 'react';\n\nimport {\n\tAccordion as PrimitiveAccordion,\n\tAccordionContent as PrimitiveAccordionContent,\n\tAccordionItem as PrimitiveAccordionItem,\n\tAccordionTrigger as PrimitiveAccordionTrigger,\n} from '../../ui/accordion';\nimport { Text } from '../../typography';\nimport { cn } from '../../../lib/utils';\n\nexport type AccordionProps = React.ComponentPropsWithoutRef<typeof PrimitiveAccordion>;\nexport type AccordionItemProps = React.ComponentPropsWithoutRef<typeof PrimitiveAccordionItem>;\nexport type AccordionTriggerProps = React.ComponentPropsWithoutRef<typeof PrimitiveAccordionTrigger>;\nexport type AccordionContentProps = React.ComponentPropsWithoutRef<typeof PrimitiveAccordionContent>;\n\nconst Accordion = React.forwardRef<React.ElementRef<typeof PrimitiveAccordion>, AccordionProps>(\n\tfunction Accordion({ className, ...props }, ref) {\n\t\treturn (\n\t\t\t<PrimitiveAccordion\n\t\t\t\tref={ref}\n\t\t\t\tclassName={cn(\n\t\t\t\t\t'accordion--component rounded-radius border-border bg-card',\n\t\t\t\t\tclassName,\n\t\t\t\t)}\n\t\t\t\t{...props}\n\t\t\t/>\n\t\t);\n\t},\n);\nAccordion.displayName = 'Accordion';\n\nconst AccordionItem = React.forwardRef<React.ElementRef<typeof PrimitiveAccordionItem>, AccordionItemProps>(\n\tfunction AccordionItem({ className, ...props }, ref) {\n\t\treturn (\n\t\t\t<PrimitiveAccordionItem\n\t\t\t\tref={ref}\n\t\t\t\tclassName={cn(\n\t\t\t\t\t'accordion-item--component border-border data-open:bg-muted/30',\n\t\t\t\t\tclassName,\n\t\t\t\t)}\n\t\t\t\t{...props}\n\t\t\t/>\n\t\t);\n\t},\n);\nAccordionItem.displayName = 'AccordionItem';\n\nconst AccordionTrigger = React.forwardRef<React.ElementRef<typeof PrimitiveAccordionTrigger>, AccordionTriggerProps>(\n\tfunction AccordionTrigger({ className, children, ...props }, ref) {\n\t\tconst isSimpleText = typeof children === 'string' || typeof children === 'number' || typeof children === 'bigint';\n\t\treturn (\n\t\t\t<PrimitiveAccordionTrigger\n\t\t\t\tref={ref}\n\t\t\t\tclassName={cn(\n\t\t\t\t\t'accordion-trigger--component min-h-action items-center gap-space-lg px-row-x py-row-y',\n\t\t\t\t\t'text-left text-sm font-medium transition-colors hover:bg-muted/40 hover:no-underline',\n\t\t\t\t\t'focus-visible:z-10 focus-visible:ring-2 focus-visible:ring-ring',\n\t\t\t\t\tclassName,\n\t\t\t\t)}\n\t\t\t\t{...props}\n\t\t\t>\n\t\t\t\t{isSimpleText ? (\n\t\t\t\t\t<Text tag=\"span\" size=\"inherit\" weight=\"medium\" lineHeight=\"tight\" className=\"text-inherit\">\n\t\t\t\t\t\t{children}\n\t\t\t\t\t</Text>\n\t\t\t\t) : children}\n\t\t\t</PrimitiveAccordionTrigger>\n\t\t);\n\t},\n);\nAccordionTrigger.displayName = 'AccordionTrigger';\n\nconst AccordionContent = React.forwardRef<React.ElementRef<typeof PrimitiveAccordionContent>, AccordionContentProps>(\n\tfunction AccordionContent({ className, children, ...props }, ref) {\n\t\tconst isSimpleText = typeof children === 'string' || typeof children === 'number' || typeof children === 'bigint';\n\t\treturn (\n\t\t\t<PrimitiveAccordionContent\n\t\t\t\tref={ref}\n\t\t\t\tclassName={cn(\n\t\t\t\t\t'accordion-content--component px-row-x pb-space-lg text-sm',\n\t\t\t\t\tclassName,\n\t\t\t\t)}\n\t\t\t\t{...props}\n\t\t\t>\n\t\t\t\t{isSimpleText ? (\n\t\t\t\t\t<Text tag=\"div\" size=\"inherit\" lineHeight=\"relaxed\" className=\"text-inherit\">\n\t\t\t\t\t\t{children}\n\t\t\t\t\t</Text>\n\t\t\t\t) : children}\n\t\t\t</PrimitiveAccordionContent>\n\t\t);\n\t},\n);\nAccordionContent.displayName = 'AccordionContent';\n\nexport {\n\tAccordion,\n\tAccordionItem,\n\tAccordionTrigger,\n\tAccordionContent,\n};\n","/**\n * Shared accordion-shell variant classes — used by both `SmartAccordion`\n * and any blocks surface that builds on `base/accordion` directly\n * (e.g. `blocks/onboarding/checklist`).\n *\n * Exported because two consumers already keep it in lockstep; a third\n * one will copy this exact map. Centralising means a future tweak\n * (e.g. tighten `card` items to `border-border/70`) propagates.\n *\n * Padding tokens for trigger / content live alongside so the rhythm\n * is shared too:\n *\n * - Trigger: `gap-space-lg px-row-x py-row-y` — density-driven,\n *   `<UIProvider>`\n *   override flows through.\n * - Content padding accounts for the base panel's `px-row-x`.\n *   Medallion and inline rows use shared media/spacing tokens, and\n *   no-icon rows add no extra left padding so body copy tracks the\n *   trigger text column instead of drifting.\n */\nimport type { DisclosureSurface } from '../../../lib/component-vocabulary';\n\nexport type AccordionShellVariant = DisclosureSurface;\n\nexport const ACCORDION_ROOT_VARIANT_CLASS: Record<AccordionShellVariant, string> = {\n\tcard: 'gap-space-md border-0 rounded-none bg-transparent overflow-visible',\n\tbordered: 'rounded-radius border border-border bg-card overflow-hidden',\n\tflat: 'border-0 rounded-none bg-transparent overflow-visible',\n};\n\nexport const ACCORDION_ITEM_VARIANT_CLASS: Record<AccordionShellVariant, string> = {\n\tcard: 'border border-border bg-card rounded-radius data-open:bg-muted/25',\n\tbordered: 'bg-transparent not-last:border-b border-border data-open:bg-muted/30',\n\tflat: 'border-0 not-last:border-b-0 bg-transparent data-open:bg-muted/30 rounded-radius',\n};\n\nexport const ACCORDION_TRIGGER_BASE =\n\t'items-center gap-space-lg px-row-x py-row-y text-left hover:no-underline';\n\n/**\n * Content-padding presets keyed off the leading-icon width. Use\n * `withMedallion` when the trigger renders a default `IconBadge`\n * plus the shared row gap so body text aligns under the title at every\n * consumer density.\n */\nexport const ACCORDION_CONTENT_PADDING = {\n\twithMedallion: 'pl-[calc(var(--spacing-row-x)+var(--spacing-avatar)+var(--spacing-space-lg))] pr-row-x pt-0',\n\twithInline: 'pl-[calc(var(--spacing-row-x)+var(--spacing-icon-lg)+var(--spacing-space-lg))] pr-row-x pt-0',\n\twithoutIcon: 'px-row-x pt-0',\n} as const;\n","/**\n * Strings for `SmartAccordion`. There aren't many — Radix handles the\n * trigger ARIA states automatically, so the only library-owned copy is\n * the optional landmark label on the wrapping nav region. Consumers\n * override per-item `title` / `badge` / `content` directly via\n * `SmartAccordionItem` props (the strings live in the data, not here).\n */\nexport interface SmartAccordionStrings {\n\t/**\n\t * Sets `aria-label` on the wrapping element so screen readers can name\n\t * the accordion region. Optional — when absent, no aria-label is set.\n\t */\n\tregionAriaLabel?: string;\n}\n\nexport const defaultSmartAccordionStrings: SmartAccordionStrings = {\n\tregionAriaLabel: undefined,\n};\n","/**\n * SmartAccordion — the canonical \"icon + title + optional badge + body\"\n * accordion pattern, with three visual variants for the surface chrome\n * (`card` | `bordered` | `flat`) and three icon framings (`medallion` |\n * `inline` | `none`).\n *\n * Composes the wrapped `base/accordion` parts (rule 2 — blocks-style\n * convenience built from re-exports, not the raw shadcn primitive).\n *\n * For richer rows (multi-line metadata, custom layouts), drop down to\n * the compound API:\n *\n *     import { Accordion, AccordionItem, AccordionTrigger, AccordionContent }\n *       from '.';\n */\nimport { forwardRef, type ReactNode } from 'react';\n\nimport { IconBadge } from '../display/icon-badge';\nimport { Stack } from '../structure';\nimport { Text } from '../../typography';\nimport { useStrings } from '../../../lib/strings';\nimport { cn } from '../../../lib/utils';\n\nimport { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from './accordion';\nimport {\n\tACCORDION_CONTENT_PADDING,\n\tACCORDION_ITEM_VARIANT_CLASS,\n\tACCORDION_ROOT_VARIANT_CLASS,\n\tACCORDION_TRIGGER_BASE,\n} from './accordion-variants';\nimport { defaultSmartAccordionStrings } from './accordion.strings';\nimport type {\n\tSmartAccordionIconStyle,\n\tSmartAccordionProps,\n} from './accordion.types';\n\n/**\n * Bounded accordion composition for repeated icon, title, description, badge,\n * and body sections. Use the compound Accordion parts when row structure or\n * per-item presentation differs.\n */\nexport const SmartAccordion = forwardRef<HTMLDivElement, SmartAccordionProps>(function SmartAccordion({\n\titems,\n\tmultiple = false,\n\tdefaultValue,\n\tvalue,\n\tonValueChange,\n\tvariant = 'bordered',\n\ticonStyle = 'inline',\n\tclassName,\n\titemClassName,\n\ttriggerClassName,\n\tcontentClassName,\n\tstrings: stringsProp,\n}, ref) {\n\tconst strings = useStrings(defaultSmartAccordionStrings, stringsProp);\n\tconst hasIconColumn = iconStyle !== 'none' && items.some((item) => item.icon != null);\n\tconst contentPadding =\n\t\t!hasIconColumn\n\t\t\t? ACCORDION_CONTENT_PADDING.withoutIcon\n\t\t\t: iconStyle === 'medallion'\n\t\t\t? ACCORDION_CONTENT_PADDING.withMedallion\n\t\t\t: ACCORDION_CONTENT_PADDING.withInline;\n\tconst triggerGridClass = !hasIconColumn\n\t\t? 'grid-cols-[minmax(0,1fr)]'\n\t\t: 'grid-cols-[auto_minmax(0,1fr)]';\n\treturn (\n\t\t<Accordion\n\t\t\tref={ref}\n\t\t\tmultiple={multiple}\n\t\t\tdefaultValue={defaultValue}\n\t\t\tvalue={value}\n\t\t\tonValueChange={\n\t\t\t\tonValueChange\n\t\t\t\t\t? (next) => onValueChange(next as string[])\n\t\t\t\t\t: undefined\n\t\t\t}\n\t\t\taria-label={strings.regionAriaLabel}\n\t\t\tdata-variant={variant}\n\t\t\tdata-icon-style={iconStyle}\n\t\t\tclassName={cn('smart-accordion--component', ACCORDION_ROOT_VARIANT_CLASS[variant], className)}\n\t\t>\n\t\t\t{items.map((item) => (\n\t\t\t\t<AccordionItem\n\t\t\t\t\tkey={item.value}\n\t\t\t\t\tvalue={item.value}\n\t\t\t\t\tclassName={cn('smart-accordion--item', ACCORDION_ITEM_VARIANT_CLASS[variant], itemClassName)}\n\t\t\t\t>\n\t\t\t\t\t<AccordionTrigger\n\t\t\t\t\t\tclassName={cn('smart-accordion--trigger', ACCORDION_TRIGGER_BASE, triggerClassName)}\n\t\t\t\t\t\tdisabled={item.disabled}\n\t\t\t\t\t>\n\t\t\t\t\t\t<div className={cn('grid min-w-0 flex-1 items-center gap-x-space-lg', triggerGridClass)}>\n\t\t\t\t\t\t\t<SmartAccordionIcon\n\t\t\t\t\t\t\t\ticonStyle={iconStyle}\n\t\t\t\t\t\t\t\ticon={item.icon}\n\t\t\t\t\t\t\t\treserveSpace={hasIconColumn}\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<Stack render={<span />} gap=\"dense\" className=\"smart-accordion--heading flex-1\">\n\t\t\t\t\t\t\t\t<span className=\"flex min-w-0 flex-wrap items-center gap-x-space-md gap-y-space-xs\">\n\t\t\t\t\t\t\t\t\t{isSimpleContent(item.title) ? (\n\t\t\t\t\t\t\t\t\t\t<Text tag=\"span\" weight=\"semibold\" className=\"smart-accordion--title min-w-0\">\n\t\t\t\t\t\t\t\t\t\t\t{item.title}\n\t\t\t\t\t\t\t\t\t\t</Text>\n\t\t\t\t\t\t\t\t\t) : item.title}\n\t\t\t\t\t\t\t\t\t{item.badge != null && (\n\t\t\t\t\t\t\t\t\t\t<span className=\"smart-accordion--badge inline-flex shrink-0\">{item.badge}</span>\n\t\t\t\t\t\t\t\t\t)}\n\t\t\t\t\t\t\t\t</span>\n\t\t\t\t\t\t\t\t{!!item.description && (\n\t\t\t\t\t\t\t\t\tisSimpleContent(item.description) ? (\n\t\t\t\t\t\t\t\t\t\t<Text tag=\"span\" type=\"secondary\" className=\"smart-accordion--description min-w-0\">\n\t\t\t\t\t\t\t\t\t\t\t{item.description}\n\t\t\t\t\t\t\t\t\t\t</Text>\n\t\t\t\t\t\t\t\t\t) : item.description\n\t\t\t\t\t\t\t\t)}\n\t\t\t\t\t\t\t</Stack>\n\t\t\t\t\t\t</div>\n\t\t\t\t\t</AccordionTrigger>\n\t\t\t\t\t<AccordionContent\n\t\t\t\t\t\tclassName={cn(\n\t\t\t\t\t\t\t'smart-accordion--content',\n\t\t\t\t\t\t\tcontentPadding,\n\t\t\t\t\t\t\tcontentClassName,\n\t\t\t\t\t\t)}\n\t\t\t\t\t>\n\t\t\t\t\t\t{isSimpleContent(item.content) ? (\n\t\t\t\t\t\t\t<Text tag=\"div\" type=\"secondary\" lineHeight=\"relaxed\">\n\t\t\t\t\t\t\t\t{item.content}\n\t\t\t\t\t\t\t</Text>\n\t\t\t\t\t\t) : item.content}\n\t\t\t\t\t</AccordionContent>\n\t\t\t\t</AccordionItem>\n\t\t\t))}\n\t\t</Accordion>\n\t);\n});\n\nSmartAccordion.displayName = 'SmartAccordion';\n\nfunction isSimpleContent(content: ReactNode): content is string | number | bigint {\n\treturn typeof content === 'string' || typeof content === 'number' || typeof content === 'bigint';\n}\n\nfunction SmartAccordionIcon({\n\ticonStyle,\n\ticon,\n\treserveSpace,\n}: {\n\ticonStyle: SmartAccordionIconStyle;\n\ticon?: ReactNode;\n\treserveSpace: boolean;\n}) {\n\tif (iconStyle === 'none' || !reserveSpace) return null;\n\tif (!icon) {\n\t\treturn (\n\t\t\t<span\n\t\t\t\taria-hidden=\"true\"\n\t\t\t\tclassName={cn(\n\t\t\t\t\t'smart-accordion--icon inline-flex shrink-0',\n\t\t\t\t\ticonStyle === 'inline' ? 'size-icon-lg' : 'size-avatar',\n\t\t\t\t)}\n\t\t\t/>\n\t\t);\n\t}\n\tif (iconStyle === 'inline') {\n\t\treturn (\n\t\t\t<span\n\t\t\t\taria-hidden=\"true\"\n\t\t\t\tclassName=\"smart-accordion--icon inline-flex size-icon-lg shrink-0 self-center text-muted-foreground [&>svg]:size-icon\"\n\t\t\t>\n\t\t\t\t{icon}\n\t\t\t</span>\n\t\t);\n\t}\n\treturn (\n\t\t<IconBadge size=\"md\" tone=\"neutral\" shape=\"circle\" aria-hidden=\"true\" className=\"smart-accordion--icon self-center\">\n\t\t\t{icon}\n\t\t</IconBadge>\n\t);\n}\n"],"mappings":"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"}