banhaten 0.5.0 → 0.6.0

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

@@ -1,79 +1,79 @@
-# 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.
-
+# 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.
+
 <!-- registry-contract:start -->
 ## Registry Contract
 

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

@@ -1,53 +1,53 @@
-# 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.
-
+# 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.
+
 <!-- registry-contract:start -->
 ## Registry Contract
 

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

@@ -1,59 +1,59 @@
-# Radio Group
-
-Radio Group is the native-input single-choice primitive. It includes `Radio`, `RadioField`, `RadioGroup`, and `RadioGroupItem` for grouped labels, descriptions, errors, disabled state, controlled or uncontrolled values, and horizontal or vertical layout.
-
-## API
-
-```tsx
-<RadioGroup
-  label="Billing interval"
-  defaultValue="monthly"
-  orientation="vertical"
->
-  <RadioGroupItem value="monthly" label="Monthly" />
-  <RadioGroupItem value="annual" label="Annual" />
-</RadioGroup>
-```
-
-| Prop | Values |
-| --- | --- |
-| `value`, `defaultValue` | controlled or uncontrolled value |
-| `orientation` | `vertical`, `horizontal` |
-| `state` | `default`, `error`, `disabled` |
-| `label`, `description`, `errorMessage` | `ReactNode` |
-| `controlPosition` | `start`, `end` on field/item rows |
-
-## Token Contract
-
-Radio Group uses Banhaten radio control, field gap, group spacing, text, helper, error, disabled, border, and focus tokens.
-
-## RTL
-
-`RadioField` and `RadioGroupItem` use logical start/end control placement. Labels, descriptions, and error text use `dir="auto"` and tokenized typography.
-
-## Accessibility
-
-The group uses `fieldset`, shared native radio names, label wrapping, and platform keyboard behavior. Provide visible error text when the group is invalid.
-
-## Install
-
-```bash
-npx banhaten add radio-group
-```
-
-## Examples
-
-Primary registry example: `examples/radio-group-demo.tsx`.
-
-Open the live component page or run `npx banhaten docs radio-group` to inspect source files, install command, and examples.
-
-## RTL Rules
-
-- `inheritsDirection`: true
-- `controlPlacement`: RadioField and RadioGroupItem use start/end control placement so the radio mirrors correctly in RTL.
-- `textDirection`: Group labels, item labels, descriptions, and error text use dir="auto" with tokenized body typography.
-- `semantics`: Uses native radio inputs with a shared group name, fieldset grouping, and label wrapping for platform keyboard and form behavior.
-
+# Radio Group
+
+Radio Group is the native-input single-choice primitive. It includes `Radio`, `RadioField`, `RadioGroup`, and `RadioGroupItem` for grouped labels, descriptions, errors, disabled state, controlled or uncontrolled values, and horizontal or vertical layout.
+
+## API
+
+```tsx
+<RadioGroup
+  label="Billing interval"
+  defaultValue="monthly"
+  orientation="vertical"
+>
+  <RadioGroupItem value="monthly" label="Monthly" />
+  <RadioGroupItem value="annual" label="Annual" />
+</RadioGroup>
+```
+
+| Prop | Values |
+| --- | --- |
+| `value`, `defaultValue` | controlled or uncontrolled value |
+| `orientation` | `vertical`, `horizontal` |
+| `state` | `default`, `error`, `disabled` |
+| `label`, `description`, `errorMessage` | `ReactNode` |
+| `controlPosition` | `start`, `end` on field/item rows |
+
+## Token Contract
+
+Radio Group uses Banhaten radio control, field gap, group spacing, text, helper, error, disabled, border, and focus tokens.
+
+## RTL
+
+`RadioField` and `RadioGroupItem` use logical start/end control placement. Labels, descriptions, and error text use `dir="auto"` and tokenized typography.
+
+## Accessibility
+
+The group uses `fieldset`, shared native radio names, label wrapping, and platform keyboard behavior. Provide visible error text when the group is invalid.
+
+## Install
+
+```bash
+npx banhaten add radio-group
+```
+
+## Examples
+
+Primary registry example: `examples/radio-group-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs radio-group` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `controlPlacement`: RadioField and RadioGroupItem use start/end control placement so the radio mirrors correctly in RTL.
+- `textDirection`: Group labels, item labels, descriptions, and error text use dir="auto" with tokenized body typography.
+- `semantics`: Uses native radio inputs with a shared group name, fieldset grouping, and label wrapping for platform keyboard and form behavior.
+
 <!-- registry-contract:start -->
 ## Registry Contract
 

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

@@ -1,46 +1,46 @@
-# Resizable
-
-Resizable wraps `react-resizable-panels` for split panes and workbench layouts.
-
-## API
-
-```tsx
-<ResizablePanelGroup direction="horizontal">
-  <ResizablePanel defaultSize={30}>Sidebar</ResizablePanel>
-  <ResizableHandle withHandle />
-  <ResizablePanel defaultSize={70}>Content</ResizablePanel>
-</ResizablePanelGroup>
-```
-
-## Token Contract
-
-Resizable uses Banhaten border, focus, raised surface, radius, and icon sizing tokens.
-
-## RTL
-
-Panel order follows DOM order. Use logical layout around the panel group for RTL shells.
-
-## Accessibility
-
-`react-resizable-panels` provides keyboard-adjustable resize handles.
-
-## Install
-
-```bash
-npx banhaten add resizable
-```
-
-## Examples
-
-Primary registry example: `examples/resizable-demo.tsx`.
-
-Open the live component page or run `npx banhaten docs resizable` to inspect source files, install command, and examples.
-
-## RTL Rules
-
-- `inheritsDirection`: true
-- `layout`: Panel order follows DOM order; use logical shell layout for RTL workspaces.
-
+# Resizable
+
+Resizable wraps `react-resizable-panels` for split panes and workbench layouts.
+
+## API
+
+```tsx
+<ResizablePanelGroup direction="horizontal">
+  <ResizablePanel defaultSize={30}>Sidebar</ResizablePanel>
+  <ResizableHandle withHandle />
+  <ResizablePanel defaultSize={70}>Content</ResizablePanel>
+</ResizablePanelGroup>
+```
+
+## Token Contract
+
+Resizable uses Banhaten border, focus, raised surface, radius, and icon sizing tokens.
+
+## RTL
+
+Panel order follows DOM order. Use logical layout around the panel group for RTL shells.
+
+## Accessibility
+
+`react-resizable-panels` provides keyboard-adjustable resize handles.
+
+## Install
+
+```bash
+npx banhaten add resizable
+```
+
+## Examples
+
+Primary registry example: `examples/resizable-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs resizable` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `layout`: Panel order follows DOM order; use logical shell layout for RTL workspaces.
+
 <!-- registry-contract:start -->
 ## Registry Contract
 

package/docs/design-system/components/scroll-area.md

@@ -1,53 +1,53 @@
-# Scroll Area
-
-Scroll Area wraps Radix ScrollArea with tokenized viewport, scrollbar, thumb, and corner styling.
-
-## API
-
-```tsx
-<ScrollArea className="h-48">
-  <div>Scrollable content</div>
-</ScrollArea>
-
-<ScrollArea className="h-48" orientation="both">
-  <div className="h-max w-max">Two-axis content</div>
-</ScrollArea>
-```
-
-| Part | Purpose |
-| --- | --- |
-| `ScrollArea` | root and viewport; `orientation` accepts `vertical`, `horizontal`, or `both` |
-| `ScrollBar` | vertical or horizontal scrollbar |
-
-## Token Contract
-
-Scroll Area uses Banhaten radius, border, and neutral thumb tokens.
-
-## RTL
-
-Scroll Area inherits direction from its parent. Use logical padding inside the viewport content.
-
-## Accessibility
-
-Use Scroll Area for visual scrollbars around already accessible content, not for hiding essential controls.
-
-## Install
-
-```bash
-npx banhaten add scroll-area
-```
-
-## Examples
-
-Primary registry example: `examples/scroll-area-demo.tsx`.
-
-Open the live component page or run `npx banhaten docs scroll-area` to inspect source files, install command, and examples.
-
-## RTL Rules
-
-- `inheritsDirection`: true
-- `spacing`: Viewport content should use logical padding so scrollable regions mirror with document direction.
-
+# Scroll Area
+
+Scroll Area wraps Radix ScrollArea with tokenized viewport, scrollbar, thumb, and corner styling.
+
+## API
+
+```tsx
+<ScrollArea className="h-48">
+  <div>Scrollable content</div>
+</ScrollArea>
+
+<ScrollArea className="h-48" orientation="both">
+  <div className="h-max w-max">Two-axis content</div>
+</ScrollArea>
+```
+
+| Part | Purpose |
+| --- | --- |
+| `ScrollArea` | root and viewport; `orientation` accepts `vertical`, `horizontal`, or `both` |
+| `ScrollBar` | vertical or horizontal scrollbar |
+
+## Token Contract
+
+Scroll Area uses Banhaten radius, border, and neutral thumb tokens.
+
+## RTL
+
+Scroll Area inherits direction from its parent. Use logical padding inside the viewport content.
+
+## Accessibility
+
+Use Scroll Area for visual scrollbars around already accessible content, not for hiding essential controls.
+
+## Install
+
+```bash
+npx banhaten add scroll-area
+```
+
+## Examples
+
+Primary registry example: `examples/scroll-area-demo.tsx`.
+
+Open the live component page or run `npx banhaten docs scroll-area` to inspect source files, install command, and examples.
+
+## RTL Rules
+
+- `inheritsDirection`: true
+- `spacing`: Viewport content should use logical padding so scrollable regions mirror with document direction.
+
 <!-- registry-contract:start -->
 ## Registry Contract