banhaten 0.1.2 → 0.1.3

package/docs/design-system/components/menubar.md

@@ -0,0 +1,45 @@
+# Menubar
+
+Menubar wraps Radix Menubar for application-style top menus.
+
+## API
+
+```tsx
+<Menubar>
+  <MenubarMenu>
+    <MenubarTrigger>File</MenubarTrigger>
+    <MenubarContent>
+      <MenubarItem>New</MenubarItem>
+    </MenubarContent>
+  </MenubarMenu>
+</Menubar>
+```
+
+## Token Contract
+
+Menubar uses Banhaten menu, surface, border, shadow, hover, spacing, and body typography tokens.
+
+## RTL
+
+Triggers, menu items, and shortcuts use logical spacing and inherited direction.
+
+## Accessibility
+
+Radix provides menubar roles, keyboard navigation, open state, and submenu behavior.
+
+## Install
+
+```bash
+npx banhaten add menubar
+```
+
+## Examples
+
+Primary registry example: `examples/menubar-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs menubar` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `spacing`: Triggers, items, and shortcuts use logical spacing.

package/docs/design-system/components/modal.md

@@ -0,0 +1,98 @@
+# Modal
+
+`Modal` presents a focused dialog surface for decisions and blocking workflows. `ConfirmModal` adds the constrained alert-dialog/confirm pattern for consequential actions.
+
+Figma reference: `Design system 3.0 Copy / Modal`, node `227:5480`.
+
+## Variants
+
+The implementation covers the six-node Modal matrix from Figma:
+
+| Prop | Values |
+| --- | --- |
+| `size` | `sm`, `default`, `lg` |
+| `dir` | `ltr`, `rtl` |
+
+## API
+
+```tsx
+<Modal size="default" />
+<Modal dir="rtl" size="lg" />
+<ConfirmModal intent="danger" confirmLabel="Delete project" />
+```
+
+| Prop | Default |
+| --- | --- |
+| `size` | `sm` |
+| `dir` | inherited |
+| `title` | localized demo title |
+| `description` | localized demo description |
+| `showIcon` | `true` |
+| `showCloseButton` | `true` |
+| `showDivider` | `true` |
+| `showFooter` | `true` |
+| `showCheckbox` | `true` |
+| `footer` | none |
+
+`ConfirmModal` also accepts:
+
+| Prop | Default |
+| --- | --- |
+| `intent` | `danger` |
+| `confirmLabel` / `cancelLabel` | localized |
+| `confirmLoading` | `false` |
+| `confirmDisabled` | `false` |
+| `preventOutsideDismiss` | `true` |
+| `closeOnConfirm` / `closeOnCancel` | `true` |
+| `onConfirm` / `onCancel` | none |
+
+## Pixel Rules
+
+- Small, Default, and Large modal widths are `440px`, `560px`, and `700px`.
+- The shell uses `--bh-radius-2xl-12`.
+- Header padding is `20px 20px 8px`, with logical end padding reserved for the close button.
+- Body padding is `10px 20px 20px`.
+- Footer padding is `16px 20px`, with a `10px` gap.
+- Actions reuse `Button` with `size="sm"`, `variant="soft"` for the secondary action, and the default variant for the primary action.
+- Confirm actions reuse `Button` with `variant="danger"`, `variant="warning"`, or `variant="default"` from the selected intent.
+- The opt-out control reuses `Checkbox`.
+- Loading confirm actions reuse the Banhaten `Spinner` component.
+
+## Token Contract
+
+The component consumes existing Banhaten variables:
+
+- Surface: `--bh-bg-raised`, `--bh-bg-backdrop`, `--bh-bg-danger-subtle`, `--bh-bg-warning-subtle`
+- Border: `--bh-border-subtle`
+- Content: `--bh-content-default`, `--bh-content-subtle`, `--bh-content-danger-default`, `--bh-content-warning-default`
+- Shape: `--bh-radius-2xl-12`, `--bh-radius-full`
+- Space: `--bh-space-xs-4`, `--bh-space-sm-6`, `--bh-space-md-8`, `--bh-space-lg-10`, `--bh-space-3xl-16`, `--bh-space-4xl-20`, `--bh-space-5xl-24`, `--bh-space-6xl-32`, `--bh-space-8xl-48`, `--bh-space-9xl-64`
+- Type: `--bh-text-heading-sm-semibold-*`, `--bh-text-body-md-regular-*`
+- Elevation: `--shadow-component-default`, `--shadow-button-focus`, `--shadow-button-danger-focus`
+
+## Accessibility
+
+- `ModalContent` is backed by Radix Dialog for focus trap, Escape, outside-click dismissal, and ARIA dialog semantics.
+- `ModalTitle` and `ModalDescription` map to Radix dialog title and description primitives.
+- The close affordance is a real button through `ModalCloseButton`.
+- `ConfirmModal` sets `role="alertdialog"`, focuses the cancel action first when present, disables outside-pointer dismissal by default, and can optionally prevent Escape dismissal.
+- `ModalSurface` is presentational and intended for static documentation or visual comparison, not live modal behavior.
+
+## Install
+
+```bash
+npx banhaten add modal
+```
+
+## Examples
+
+Primary registry example: `examples/modal-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs modal` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `closePlacement`: Close uses logical inline-end placement so it moves to the left side in RTL.
+- `footerOrder`: The checkbox and action cluster use inherited direction and logical gaps so their order mirrors naturally.
+- `textDirection`: Title, description, checkbox label, confirm labels, and actions use dir="auto" for Arabic and English copy.

package/docs/design-system/components/native-select.md

@@ -0,0 +1,52 @@
+# Native Select
+
+Native Select is a tokenized native `<select>` field for platform forms, mobile fallback, and lightweight option sets.
+
+## API
+
+```tsx
+<NativeSelect
+  label="Workspace"
+  options={[
+    { label: "Design", value: "design" },
+    { label: "Engineering", value: "engineering" },
+  ]}
+/>
+```
+
+| Prop | Values |
+| --- | --- |
+| `size` | `md`, `lg` |
+| `variant` | `default`, `soft` |
+| `state` | `default`, `filled`, `error`, `disabled` |
+| `options` | array of `{ label, value, disabled }` |
+
+## Token Contract
+
+Native Select reuses Banhaten select width, label, helper, trigger, border, focus, icon, and validation tokens.
+
+## RTL
+
+Native Select accepts `dir` and uses logical padding plus an inline-end chevron.
+
+## Accessibility
+
+Prefer `label` or an external `<Label htmlFor>` and use helper or error copy for validation context.
+
+## Install
+
+```bash
+npx banhaten add native-select
+```
+
+## Examples
+
+Primary registry example: `examples/native-select-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs native-select` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `spacing`: Uses logical padding and inline-end chevron placement.
+- `textDirection`: Label and helper copy use dir="auto" through Label and helper text.

package/docs/design-system/components/navigation-menu.md

@@ -0,0 +1,48 @@
+# Navigation Menu
+
+Navigation Menu wraps Radix NavigationMenu for top navigation with trigger, content, link, viewport, and indicator parts.
+
+## API
+
+```tsx
+<NavigationMenu>
+  <NavigationMenuList>
+    <NavigationMenuItem>
+      <NavigationMenuTrigger>Product</NavigationMenuTrigger>
+      <NavigationMenuContent>
+        <NavigationMenuLink href="#">Components</NavigationMenuLink>
+      </NavigationMenuContent>
+    </NavigationMenuItem>
+  </NavigationMenuList>
+  <NavigationMenuViewport />
+</NavigationMenu>
+```
+
+## Token Contract
+
+Navigation Menu uses Banhaten ghost hover, soft active state, raised content, popover shadow, radius, and body typography tokens.
+
+## RTL
+
+The list and content inherit direction. Links use logical text alignment.
+
+## Accessibility
+
+Radix handles trigger relationships, viewport sizing, keyboard navigation, and focus.
+
+## Install
+
+```bash
+npx banhaten add navigation-menu
+```
+
+## Examples
+
+Primary registry example: `examples/navigation-menu-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs navigation-menu` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `spacing`: Triggers, links, and content use logical layout and inherited direction.

package/docs/design-system/components/onboarding-step-list-item.md

@@ -0,0 +1,80 @@
+# Onboarding Step List Item
+
+`OnboardingStepListItem` renders one vertical progress-list row for onboarding, setup, or guided task flows. It should be composed into a list by the parent flow, which controls line visibility for first and last items.
+
+Figma reference: `OnboardingStepListItem`, node `587:27227`.
+
+## Variants
+
+The Figma component defines these variants:
+
+| State | Direction |
+| --- | --- |
+| `Finished` | LTR and RTL |
+| `Active` | LTR and RTL |
+| `inactive` | LTR and RTL |
+
+Code uses lowercase semantic state values: `finished`, `active`, and `inactive`.
+
+## API
+
+```tsx
+<OnboardingStepListItem
+  state="finished"
+  label="Label"
+  dir="ltr"
+  showLeadingLine
+  showTrailingLine
+/>
+```
+
+| Prop | Values | Default |
+| --- | --- | --- |
+| `state` | `finished`, `active`, `inactive` | `finished` |
+| `label` | `string` | `Label` |
+| `dir` | `ltr`, `rtl` | `ltr` |
+| `showLeadingLine` | `boolean` | `true` |
+| `showTrailingLine` | `boolean` | `true` |
+
+## Token Contract
+
+The component consumes Banhaten semantic tokens and component aliases. Do not hard-code Figma fallback literals in component source; promote any Figma value into `registry/styles/globals.css` as a `--bh-*` token or alias first.
+
+- Backgrounds: `--bh-bg-raised`
+- Borders: `--bh-border-brand-strong`, `--bh-border-default`
+- Content: `--bh-content-brand-default`, `--bh-content-default`, `--bh-content-subtle`, `--bh-content-success-default`
+- Shape: `--bh-control-default`
+- Space: `--bh-space-lg-10`, `--bh-space-xl-12`
+
+## Pixel Rules
+
+- The row is `280px` wide and `40px` tall.
+- Padding is `8px 12px` with a `10px` gap between the line wrap and label.
+- Text uses Inter Medium `15px / 24px` with zero letter spacing.
+- The line wrap is `24px` square.
+- Finished uses a `20px` success check-circle icon with `2px` default connector lines.
+- Active uses a `2px x 20px` brand line, a default border, white raised fill, `8px` radius, and component shadow.
+- Inactive uses a `2px x 40px` default connector line and subtle content color.
+- RTL mirrors visual order through `dir="rtl"` and right-aligns the label.
+
+## Accessibility
+
+- Connector lines and the finished icon are decorative in this primitive and are hidden from assistive technology.
+- Parent onboarding lists should expose the overall progress semantics, current step, and completion status.
+- Keep labels as real text and avoid using this row as the only status announcement.
+
+## Install
+
+```bash
+npx banhaten add onboarding-step
+```
+
+## Examples
+
+Primary registry example: `examples/expanded/onboarding-step-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs onboarding-step` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+This component has no special RTL contract beyond inherited document direction and logical spacing.

package/docs/design-system/components/page-header.md

@@ -0,0 +1,84 @@
+# Page Header
+
+Page headers introduce a page or section with optional hierarchy, title metadata, actions, description, and local tabs.
+
+Figma reference: `Page Header`, node `1154:2816` in `Design system 3.0 Copy`.
+
+## API
+
+```tsx
+<PageHeader
+  title="Section Tile"
+  metaInfo="Meta info"
+  description="Section description"
+  breadcrumbs={[{ label: "Home" }, { label: "Home" }]}
+  actions={[{ label: "Button" }, { label: "Button" }]}
+  tabs={{ items: ["Tab item", "Tab item", "Tab item"] }}
+/>
+```
+
+| Prop | Type | Default |
+| --- | --- | --- |
+| `title` | `string` | `Section Tile` |
+| `metaInfo` | `string` | `Meta info` |
+| `description` | `string` | `Section description` |
+| `icon` | `ReactNode` or `false` | home icon |
+| `breadcrumbs` | `PageHeaderBreadcrumb[]` or `false` | four `Home` items |
+| `actions` | `PageHeaderAction[]` or `false` | four `Button` actions |
+| `tabs` | `PageHeaderTabs` or `false` | underline `Tabs` |
+| `dir` | `ltr` or `rtl` | `ltr` |
+
+## Structure
+
+The implementation follows the Figma hierarchy:
+
+- Breadcrumb navigation above the section body.
+- Title row with optional icon, title, and meta text.
+- Action group aligned to the end of the title row.
+- Optional body description below the title row.
+- Underline `Tabs` spanning the full header width.
+
+`PageHeader` reuses the existing `Tabs` component instead of duplicating tab behavior.
+
+## Token Contract
+
+The component consumes Banhaten semantic tokens and component aliases. Do not hard-code Figma fallback literals in component source; promote any Figma value into `registry/styles/globals.css` as a `--bh-*` token or alias first.
+
+- Borders: `--bh-border-default`
+- Content: `--bh-content-brand-default`, `--bh-content-default`, `--bh-content-heading`, `--bh-content-muted`, `--bh-content-subtle`
+- Interactive: `--bh-interactive-secondary-default`
+- Shape: `--bh-control-default`
+
+## Pixel Rules
+
+- Header root is vertically padded by `20px`.
+- Breadcrumb and body text use `15px / 24px`.
+- Title uses `24px / 28px` at weight `600`.
+- Meta text uses `12px / 16px`.
+- Title row and action group are separated by `40px`.
+- Action buttons are `36px` high with an `8px` radius, subtle border, drop shadow, and inner bottom shadow.
+- Tabs use the existing `underline`, `md`, `fullWidth` tab treatment.
+
+## Accessibility
+
+- Breadcrumbs render as `<nav aria-label="Breadcrumb">` with an ordered list.
+- Mark the current breadcrumb with `current: true` so it receives `aria-current="page"`.
+- Separators are decorative and hidden from assistive technology.
+- Action items render as real buttons or anchors.
+- Focus states use the brand token and remain visible for keyboard users.
+
+## Install
+
+```bash
+npx banhaten add page-header
+```
+
+## Examples
+
+Primary registry example: `examples/expanded/page-header-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs page-header` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+This component has no special RTL contract beyond inherited document direction and logical spacing.

package/docs/design-system/components/pagination.md

@@ -0,0 +1,49 @@
+# Pagination
+
+Pagination navigates paged result sets, tables, and long lists. It supports numeric, simple, and summary layouts, soft and ghost styles, exact control geometry, captions, and RTL labels.
+
+## API
+
+```tsx
+<Pagination page={3} totalPages={12} type="numeric" />
+<Pagination dir="rtl" page={2} totalPages={8} type="summary" />
+```
+
+| Prop | Values | Default |
+| --- | --- | --- |
+| `type` | `numeric`, `simple`, `summary` | `numeric` |
+| `variant` | `soft`, `ghost` | `soft` |
+| `page` | number | `1` |
+| `totalPages` | number | required |
+| `labels` | localized label overrides | direction-aware defaults |
+
+## Token Contract
+
+Pagination uses Banhaten control height, radius, border, background, content, focus, icon, caption, and shadow tokens.
+
+## RTL
+
+Passing `dir="rtl"` switches default labels to Arabic and mirrors previous/next directional icons with `data-rtl-flip="true"`.
+
+## Accessibility
+
+Wrap pagination in a navigation landmark with a descriptive label. Current page controls should expose current state, and previous/next buttons should have readable labels.
+
+## Install
+
+```bash
+npx banhaten add pagination
+```
+
+## Examples
+
+Primary registry example: `examples/pagination-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs pagination` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `labels`: Defaults to Arabic labels when dir="rtl" is provided or the document direction is RTL.
+- `directionalIconFlip`: Inline Figma arrow vectors use data-rtl-flip="true" so previous and next controls mirror in RTL.
+- `spacing`: Uses logical flex direction, gap, and text direction so English and Arabic captions align naturally.

package/docs/design-system/components/popover.md

@@ -0,0 +1,58 @@
+# Popover
+
+Popover presents contextual controls, filters, actions, settings, and short help content near a trigger. It supports controlled and uncontrolled state, click, focus, and hover-capable triggers, positioned content, optional arrow, alignment, offsets, sizes, close affordance, and RTL-safe composition.
+
+## API
+
+```tsx
+<Popover>
+  <PopoverTrigger>Filters</PopoverTrigger>
+  <PopoverContent side="bottom" align="start">
+    <PopoverHeader>
+      <PopoverTitle>Filters</PopoverTitle>
+      <PopoverClose />
+    </PopoverHeader>
+    <PopoverBody>Filter controls go here.</PopoverBody>
+  </PopoverContent>
+</Popover>
+```
+
+| Prop | Values |
+| --- | --- |
+| `open`, `defaultOpen`, `onOpenChange` | controlled or uncontrolled state |
+| `side` | `top`, `right`, `bottom`, `left` |
+| `align` | `start`, `center`, `end` |
+| `size` | `sm`, `md`, `lg`, `auto` |
+| `offset` | `tight`, `default`, `loose` |
+| `showArrow` | `boolean` |
+
+## Token Contract
+
+Popover uses Banhaten popover width, padding, arrow, offset, surface, border, radius, shadow, trigger, typography, and z-index tokens.
+
+## RTL
+
+Top and bottom alignment use logical start/end behavior. Title and description slots use `dir="auto"` and product content can inherit the nearest direction.
+
+## Accessibility
+
+Use popovers for non-modal contextual content. Use Dialog or Sheet for workflows that require focus trapping or stronger dismissal semantics.
+
+## Install
+
+```bash
+npx banhaten add popover
+```
+
+## Examples
+
+Primary registry example: `examples/popover-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs popover` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `alignment`: Top and bottom alignments use logical start/end so the panel edge and arrow align correctly in LTR and RTL.
+- `spacing`: Uses logical layout and Banhaten spacing tokens for headers, bodies, footers, arrows, and trigger gaps.
+- `textDirection`: Title and description slots use dir="auto" while product content can inherit the nearest direction.

package/docs/design-system/components/progress-slider.md

@@ -0,0 +1,48 @@
+# Progress Slider
+
+Progress Slider is an adjustable, start-anchored progress control. It is built on Radix Slider and keeps the filled surface growing from the logical start edge while the grip handle remains at the active value edge.
+
+## API
+
+```tsx
+<ProgressSlider value={[45]} aria-label="Upload progress" />
+<ProgressSlider defaultValue={[70]} tone="success" showTicks />
+```
+
+| Prop | Values |
+| --- | --- |
+| `value`, `defaultValue` | Radix slider value array |
+| `size` | `default`, `lg` |
+| `tone` | `brand`, `neutral`, `success`, `warning`, `danger` |
+| `disabled` | `boolean` |
+| `showTicks` | `boolean` |
+
+## Token Contract
+
+Progress Slider uses Banhaten slider, progress, semantic tone, track, handle, pill radius, focus, and disabled tokens. Keep tone styling semantic so alert and status palettes can theme consistently.
+
+## RTL
+
+Radix receives the inherited `dir` attribute for keyboard and value direction. The fill stays anchored to the logical start edge in both LTR and RTL.
+
+## Accessibility
+
+Provide an accessible name through `aria-label` or `aria-labelledby`. Use `aria-valuetext` when the numeric value needs domain-specific phrasing.
+
+## Install
+
+```bash
+npx banhaten add progress-slider
+```
+
+## Examples
+
+Primary registry example: `examples/progress-slider-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs progress-slider` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `valueDirection`: Radix Slider handles direction and keyboard behavior through the inherited dir attribute; the fill stays anchored to the logical start edge.
+- `spacing`: Uses tokenized pill geometry and logical direction through Radix.

package/docs/design-system/components/progress.md

@@ -0,0 +1,75 @@
+# Progress
+
+Progress is a read-only progress meter for upload, setup, usage, and completion states. It supports top label, bottom label, helper-only, and inline indicator layouts, two track sizes, helper text, optional label text, an information icon, a spinner indicator, and inherited LTR/RTL direction.
+
+The implementation follows the Figma progress components at `Design system 3.0 Copy / Progress` (`177:7992`) and `Progress Label` (`177:8141`).
+
+## API
+
+```tsx
+<Progress
+  aria-label="Upload progress"
+  helperText="Preparing the final file"
+  label="Upload"
+  optional="(Optional)"
+  showInfo
+  showSpinner
+  value={40}
+/>
+```
+
+## Variants
+
+| Prop | Values |
+| --- | --- |
+| `size` | `lg`, `sm` |
+| `labelPosition` | `top`, `bottom`, `none`, `inline` |
+| `value` | number clamped between `min` and `max` |
+| `showIndicator` | `boolean` |
+| `showInfo` | `boolean` |
+| `showSpinner` | `boolean` |
+
+## Tokens
+
+Progress uses existing Banhaten tokens only:
+
+| Part | Token |
+| --- | --- |
+| Fill | `--bh-interactive-indicator-default` |
+| Track | `--bh-bg-neutral-soft` |
+| Radius | `--bh-radius-full` |
+| Label | `--bh-text-body-xs-medium-*`, `--bh-content-default` |
+| Optional and indicator | `--bh-text-body-xs-regular-*`, `--bh-text-body-2xs-regular-*`, `--bh-content-subtle` |
+| Track height | `--bh-space-md-8`, `--bh-space-xs-4` |
+
+## RTL
+
+Progress inherits `dir` from its parent. The fill is anchored to the logical start edge, so LTR fills from the left and RTL fills from the right. Text nodes use `dir="auto"` and tokenized body styles.
+
+## Install
+
+```bash
+npx banhaten add progress
+```
+
+## Examples
+
+Primary registry example: `examples/progress-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs progress` to inspect source files, install command, and examples.
+
+## Token Contract
+
+Component styles must resolve through Banhaten semantic tokens, component aliases, or documented exception-ledger values.
+Do not add raw colors, pixel values, opacity utilities, z-index values, durations, or shadow literals directly to component source.
+Covered source files: `components/progress.tsx`.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `valueDirection`: The fill is anchored with logical start positioning, so LTR fills from left and RTL fills from right.
+- `spacing`: Label, optional text, indicator, and helper copy use inherited direction, logical text alignment, and tokenized gaps.
+
+## Accessibility
+
+Keep native semantics, accessible names, keyboard reachability, focus-visible treatment, and status/error announcements intact when composing this component.

package/docs/design-system/components/radio-card.md

@@ -0,0 +1,49 @@
+# Radio Card
+
+Radio Card is a Figma-matched option card for richer single-choice selections. It supports icon, payment, avatar, company, support-label, icon-radio-left, icon-radio-right, and label-only layouts across default, active, disabled, LTR, and RTL states.
+
+## API
+
+```tsx
+<RadioCard
+  title="Business"
+  description="For teams and advanced permissions."
+  type="with-icon"
+/>
+```
+
+| Prop | Values |
+| --- | --- |
+| `type` | `with-icon`, `icon-radio-right`, `payment`, `with-avatar`, `company-icon`, `icon-radio-left`, `radio-label` |
+| `state` | `default`, `active`, `disabled` |
+| `dir` | `ltr`, `rtl` |
+
+## Token Contract
+
+Radio Card consumes Banhaten card spacing, border, radius, shadow, typography, radio-control, hover, active, disabled, and semantic content tokens.
+
+## RTL
+
+Radio Card follows the explicit Figma RTL ordering for each card type. Text nodes render in RTL and right alignment where the variant requires physical RTL composition.
+
+## Accessibility
+
+Use Radio Card inside a semantic radio group or connect it to a native radio input in product code. Do not rely on the visual active state alone for form submission.
+
+## Install
+
+```bash
+npx banhaten add radio-card
+```
+
+## Examples
+
+Primary registry example: `examples/radio-card-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs radio-card` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: false
+- `layout`: Uses the explicit Figma RTL physical order while text nodes use RTL direction and right alignment.
+- `spacing`: Company icon and icon-radio-left RTL variants use the Figma 12px card gap; other variants use the 10px card gap.