wimui 0.24.4 → 0.26.0

package/dist/llms-full.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.24.4 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
+**wimui** v0.26.0 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
 
 ## Install & required setup
 
@@ -981,7 +981,7 @@ Useful for using the button styles with Link components (e.g. from React Router
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **ColorPicker** — Color selection picker
     - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
@@ -1009,7 +1009,7 @@ so the unit does not have to be repeated in the label.
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **Combobox** — Select with search
     - `options: ComboboxOption[]` = [] — List of suggestion options
@@ -1080,7 +1080,7 @@ so the unit does not have to be repeated in the label.
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
 - **DatePicker** — Date selection
     - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
     - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
@@ -1200,6 +1200,17 @@ SCSS には誰も付けない `.default_intent` が「temporary name」のまま
 - **IconButton** — Icon-only button
     - `iconName: React.ComponentProps<typeof Icon>["name"]` (required) — Icon name to display
     - `aria-label: string` (required) — Accessible label for the icon-only button
+    - `backgroundColor: T | (string & {})` — Overrides the button background color with a design token. Usually the `variant` prop is enough; use this prop only as a last resort.
+    - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
+    - `variant: "solid" | "outline" | "ghost"` = "outline" — Visual style variant of the button
+    - `intent: ButtonIntent` = "default" — Design intent of the button (visual / semantic state). Unrelated to the ARIA role attribute.
+    - `icon: React.ComponentProps<typeof Icon>["name"] | React.ReactNode` — Icon name or custom icon element
+    - `loading: boolean` = false — Whether to show a loading indicator and disable interaction
+    - `justify: "start" | "center" | "end" | "between"` = "center" — Horizontal alignment of the button content
+    - `animateWidth: boolean` = false — Whether to animate the width change when label changes
+    - `fullWidth: boolean` = false — Whether the button should take up the full width of its container
+    - `styles: { root?: string; loader?: string; icon?: string; }` — Custom styles for internal parts
+    - `className: string` — Additional class names
 - **ImageCropper** — Front-end image crop and rotate tool
     - `src: string` — URL or data URL of the image to crop
     - `aspectRatio: number` = 1 — Aspect ratio (width / height); 1 produces a square
@@ -1247,7 +1258,7 @@ SCSS には誰も付けない `.default_intent` が「temporary name」のまま
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **InputBase** — Standardizes the visual container, icon slots (Prefix/Suffix), and clear button behavior for text-based inputs.
     - `children: React.ReactNode` (required) — Inner form control element(s) wrapped by the shell
@@ -1303,7 +1314,7 @@ make room rather than running underneath it.
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **LinkButton** — Anchor styled as button
     - `iconPosition: "left" | "right"` = "left" — Position of the icon relative to the label
@@ -1379,7 +1390,7 @@ box and receives a **1-based** position — the first box is `1`, not `0`.
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **PasswordStrength** — Visual meter to indicate password security level (aka Strength Meter)
     - `password: string` = "" — Password string to evaluate
@@ -1533,7 +1544,7 @@ so the unit does not have to be repeated in the label.
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **SegmentedControl** — Button-style controls for switching between a small set of mutually exclusive options (aka Segmented Buttons, Segmented Picker)
     - `options: Option[]` (required) — List of segment options
@@ -1605,7 +1616,7 @@ so the unit does not have to be repeated in the label.
     - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
     - `id: string` — Custom ID
     - `asChild: boolean` = false — Whether to render as a child element.
-    - `styles: React.ComponentPropsWithoutRef<typeof FieldTemplate>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; labelWrapper?: string; label?: string; content?: string; error?: string; }` — Custom styles for internal parts
 - **SmartSearchInput** — Smart search input enabling both traditional search and AI prompting.
     - `intent: FieldIntent` = "default" — Semantic intent of the field (e.g. error state)
     - `variant: "outline" | "ghost"` = "outline" — Visual style variant of the field
@@ -1715,7 +1726,7 @@ but the toggle only shows a chevron, so it needs one of its own.
     - `suffix: React.ReactNode` — Static text shown after the field, inside the same shell — a unit such as
 `kg`, `%` or `円`. It is announced with the field via `aria-describedby`,
 so the unit does not have to be repeated in the label.
-    - `styles: React.ComponentProps<typeof InputBase>["styles"]` — Custom styles for internal parts
+    - `styles: { root?: string; inner?: string; icon?: string; icons?: string; iconItem?: string; iconButton?: string; }` — Custom styles for internal parts
     - `asChild: boolean` = false — Whether to render as a child element.
 - **ToggleGroup** — Toggleable buttons
     - `options: Option[]` (required) — List of toggle options
@@ -1880,7 +1891,43 @@ origin while the card it was meant to cover was 1248x75.
     - `className: string` — Additional class name
 - **Progress** — Progress bar
   - ⚠️ Not the same as elsewhere: Material's "Progress Indicator" covers indeterminate spinners as well. WIM's `Progress` is determinate and linear only — for the indeterminate case use `Spinner`.
+    - `value: number` = 0 — Current value of the progress bar.
+@default 0
+    - `max: number` = 100 — Maximum value of the progress bar.
+@default 100
+    - `intent: IndicatorIntent` = "primary" — Intent (semantic color) of the bar.
+@default "primary"
+    - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the bar.
+@default "md"
+    - `label: string` — Text label displayed above the bar. Also used as the accessible name unless
+`aria-label` / `aria-labelledby` is given.
+
+A progress bar always carries `role="progressbar"`, and a progressbar with no
+accessible name is a WCAG failure (axe `aria-progressbar-name`, serious). The
+type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
+    - `showValue: boolean` = false — Whether to display the current value as a percentage.
+@default false
+    - `indeterminate: boolean` = false — If true, shows an indeterminate animation instead of a value.
+@default false
 - **ProgressRing** — ProgressRing description.
+    - `value: number` = 0 — Current value of the progress ring.
+@default 0
+    - `max: number` = 100 — Maximum value of the progress ring.
+@default 100
+    - `intent: IndicatorIntent` = "primary" — Intent (semantic color) of the ring.
+@default "primary"
+    - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the ring.
+@default "md"
+    - `label: string` — Text label displayed below the ring. Also used as the accessible name unless
+`aria-label` / `aria-labelledby` is given.
+
+A progress ring always carries `role="progressbar"`, and a progressbar with no
+accessible name is a WCAG failure (axe `aria-progressbar-name`, serious). The
+type therefore requires one of `label` / `aria-label` / `aria-labelledby`.
+    - `showValue: boolean` = false — Whether to display the current value as a percentage inside the ring.
+@default false
+    - `indeterminate: boolean` = false — If true, shows an indeterminate animation instead of a value.
+@default false
 - **Result** — Task status indicator
     - `intent: Extract< WimIntent, "default" | "success" | "danger" | "info" | "warning" >` = "default" — Semantic intent — determines the icon and color.
 @default "default"
@@ -2010,6 +2057,13 @@ follows the theme and never needs a hand-mixed colour.
 - **KeyboardShortcuts** — Display a structured list of keyboard shortcuts
     - `shortcuts: ShortcutItem[]` (required) — List of shortcuts to display
     - `title: string` — Section title
+    - `titleLevel: 2 | 3 | 4 | 5 | 6` — `title` を見出しとして描くときの段（T211）。渡さなければ見出しにならず `p` のまま。
+
+ショートカット一覧は「編集」「移動」のように節ごとに積んで使うので、段で辿れると
+効く。ただし既定を見出しにはしない ── 段を決め打つとページに `h1` / `h2` がある
+場合に段が飛び、axe の `heading-order` が鳴る（T191 で `Footer` が実際に踏んだ）。
+段を決めるのはページ側の構造を知っている呼び出し元の仕事で、`Alert` の `titleTag`
+（既定 `div`）と同じ形。
     - `separator: string` = "+" — Separator displayed between keys
 @default "+"
     - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the list
@@ -2053,7 +2107,16 @@ Useful for URL-based pagination (e.g. wrap with a Link via PaginationPage asChil
     - `actions: SpeedDialAction[]` (required) — Actions to display when SpeedDial is open
     - `icon: keyof typeof ALL_ICONS` = "PlusIcon" — Icon name for the main button when closed
     - `activeIcon: keyof typeof ALL_ICONS` = "CloseIcon" — Icon name for the main button when open
-    - `direction: "up" | "down" | "left" | "right"` = "up" — Direction in which actions expand
+    - `direction: "up" | "down" | "left" | "right"` = "up" — Direction in which actions expand.
+
+**The caller picks a direction that has room.** Actions are placed with
+plain CSS (`left: 100%` and friends) and are never measured, so this
+component does not flip when the viewport runs out — a `right` dial placed
+near the right edge pushes the page into a horizontal scroll. Anchor a
+`right` dial to the leading edge (and a `left` one to the trailing edge);
+`up` / `down` already grow inward from the trailing corner (T175).
+
+@default "up"
     - `trigger: "hover" | "click"` = "hover" — Trigger mode to open the SpeedDial
     - `open: boolean` — Controlled open state
     - `onOpenChange: (open: boolean) => void` — Callback when open state changes
@@ -2857,6 +2920,9 @@ the value, so cutting the axis lies about the ratio between them.
 @default true
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **BarChart** — Bar charts
     - `data: ChartDataPoint[]` (required) — Data to display in the chart.
     - `keys: string[]` (required) — Keys in the data objects to render as bars (series).
@@ -2874,6 +2940,9 @@ the value, so cutting the axis lies about the ratio between them.
     - `title: string` — Optional title displayed above the chart.
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **FunnelChart** — Process stage abandonment chart
     - `data: ChartDataPoint[]` (required) — Data to display in the chart. Each entry represents one funnel stage.
     - `dataKey: string` (required) — The key in the data objects that represents the value of each stage.
@@ -2885,6 +2954,9 @@ the value, so cutting the axis lies about the ratio between them.
     - `title: string` — Optional title displayed above the chart.
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **GanttChart** — Project schedule and timeline visualization
     - `tasks: GanttTask[]` (required) — Tasks to render as bars in the chart.
     - `startDate: Date` — Start of the visible date range. Defaults to the earliest task start date.
@@ -2912,6 +2984,9 @@ the value, so cutting the axis lies about the ratio between them.
     - `color: string` — Color of the gauge arc. Defaults to the first chart color.
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **Heatmap** — Graphical representation of data where individual values are contained in a matrix as colors.
     - `data: { x: string; y: string; value: number }[]` (required) — Cells to display. Each entry maps an x/y category pair to a value.
     - `xAxisKey: string[]` (required) — Ordered list of X axis category labels.
@@ -2925,6 +3000,9 @@ the value, so cutting the axis lies about the ratio between them.
 @default ["var(--wim-color-surface-variant)", "var(--wim-color-chart-primary)"]
     - `animated: boolean` = false — Whether to animate the cells on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **LineChart** — Line charts
     - `data: ChartDataPoint[]` (required) — Data to display in the chart.
     - `keys: string[]` (required) — Keys in the data objects to render as lines (series).
@@ -2942,6 +3020,9 @@ line on a 0–100 axis).
 @default [0, "auto"]
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **PieChart** — Proportional parts of a whole chart
     - `data: { name: string; value: number }[]` (required) — Slices to display. Each entry has a name (label) and a value.
     - `height: number` = 300 — The height of the chart in pixels.
@@ -2953,6 +3034,9 @@ line on a 0–100 axis).
 @default false
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **RadarChart** — Multivariate data on concentric axes chart
     - `data: ChartDataPoint[]` (required) — Data to display in the chart.
     - `keys: string[]` (required) — Keys in the data objects to render as radar areas (series).
@@ -2964,6 +3048,9 @@ line on a 0–100 axis).
     - `title: string` — Optional title displayed above the chart.
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **ScatterChart** — Scatter plots
     - `data: { x: number; y: number; z?: number; name: string }[]` (required) — Points to plot. `z` optionally controls the point size.
     - `xAxisName: string` = "X" — Name of the X axis, shown in the tooltip.
@@ -2981,6 +3068,9 @@ line on a 0–100 axis).
     - `title: string` — Optional title displayed above the chart.
     - `animated: boolean` = false — If true, animates the chart on mount.
 @default false
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 - **Sparkline** — Tiny inline trend chart
     - `data: number[]` (required) — Sequence of values to plot, in order
     - `type: "line" | "area" | "bar"` = "line" — Visual form of the sparkline
@@ -3003,6 +3093,9 @@ line on a 0–100 axis).
     - `width: string | number` = "100%" — The width of the chart (e.g., "100%", 500).
 @default "100%"
     - `title: string` — Optional title displayed above the chart.
+    - `aria-label: string` — Accessible name for the chart. Defaults to `title` when omitted; pass this
+when the chart has no visible title, or when the title is not descriptive
+enough on its own.
 
 ### ai — `import { … } from "wimui/ai"`
 

package/dist/llms.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.24.4 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
+**wimui** v0.26.0 — a React 19 component library: 218 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
 
 ## Install & required setup
 

package/dist/locales/en/common.json

@@ -23,7 +23,6 @@
     "go_to_next_page": "Go to next page",
     "go_to_page": "Go to page {{page}}",
     "go_to_prev_page": "Go to previous page",
-    "guideline_desc": "Consider assistive technologies and diverse viewing environments.",
     "hide_password": "Hide password",
     "icon_fallback": "Icon: {{name}}",
     "items_per_page": "Items per page",
@@ -207,29 +206,6 @@
     "description": "Description",
     "design_intent_title": "Design Intent",
     "fieldTemplate_a11y_desc": "Connects the label to the input via id, and the error message via aria-describedby.",
-    "fieldTemplate_anatomy_content_desc": "The actual component slot (Input, Select, etc.).",
-    "fieldTemplate_anatomy_content_label": "Field Area",
-    "fieldTemplate_anatomy_error_desc": "Validation feedback text displayed below the field.",
-    "fieldTemplate_anatomy_error_label": "Error Message",
-    "fieldTemplate_anatomy_label_desc": "The name of the field displayed above or beside the input.",
-    "fieldTemplate_anatomy_label_label": "Label",
-    "fieldTemplate_anatomy_required_desc": "An asterisk or (required) text appended to the label.",
-    "fieldTemplate_anatomy_required_label": "Required Indicator",
-    "fieldTemplate_best_practice_1": "Use horizontal layout for dense desktop forms.",
-    "fieldTemplate_best_practice_2": "Clearly highlight required fields to reduce user errors.",
-    "fieldTemplate_choice_alt_when": "Use InputBase directly for internal controls or dense UIs where a label is not required.",
-    "fieldTemplate_choice_matrix_desc": "Comparing FieldTemplate against using InputBase directly.",
-    "fieldTemplate_choice_use_when": "Use for virtually all user-facing form fields that require a label, error message, or required indicator.",
-    "fieldTemplate_content_guideline_1": "Keep labels short and descriptive.",
-    "fieldTemplate_content_guideline_2": "Error messages should be specific and actionable.",
-    "fieldTemplate_design_intent": "Standardizes label and error presentation to ensure consistent form layout across the product.",
-    "fieldTemplate_i18n_desc": "Label and error text are provided by the consumer; the component itself has no hardcoded strings.",
-    "fieldTemplate_keyboard_desc": "Focus management follows the wrapped input component behavior.",
-    "fieldTemplate_motion_desc": "Error messages fade in to draw attention without being disruptive.",
-    "fieldTemplate_scenario_1": "A standard user registration form.",
-    "fieldTemplate_scenario_2": "A settings page with vertical or horizontal field layouts.",
-    "label_title": "Descriptive text for input fields, including required/optional marks",
-    "label_long_desc": "A component for displaying descriptions or captions for form elements.",
     "label_design_intent": "Provides clear, accessible labels for form controls to guide user input.",
     "label_choice_self_when": "Use when you need to provide a text label for a single form input.",
     "label_choice_alt_when": "Use Heading for section titles or FieldTemplate for a complete field wrapper with error handling.",
@@ -240,7 +216,7 @@
     "label_anatomy_content": "The actual descriptive text for the form element.",
     "label_content_guideline": "Keep labels short, descriptive, and avoid using them for help text.",
     "label_motion_desc": "No specific interactions or animations.",
-    "label_a11y_desc": "Ensure the Label is associated with an input via htmlFor/id.",
+    "label_a11y_desc": "This renders a real <label>, so passing htmlFor is what connects it to its control — that association is what lets a click on the text focus the field and what gives the field its accessible name. When asChild is used the element is replaced but the same attributes are merged onto the child, so the association must still be maintained by the caller. The required and optional markers are drawn by FieldLabelContent and are aria-hidden, because the requirement belongs on the control itself (aria-required) rather than being read as part of the label text.",
     "label_scenario_1": "A standard contact form.",
     "label_scenario_2": "An admin dashboard settings panel.",
     "label_best_practice_1": "Keep labels visible at all times.",
@@ -253,25 +229,6 @@
     "i18n_docgen_none": "This component renders no text of its own — localize any content you pass into it.",
     "i18n_title": "Internationalization (i18n)",
     "inputBase_a11y_desc": "Ensures interactive icons have correct roles and labels.",
-    "inputBase_anatomy_content_desc": "Space for the actual input value or selected value.",
-    "inputBase_anatomy_content_label": "Content Area",
-    "inputBase_anatomy_root_desc": "The main wrapper that defines the border and background.",
-    "inputBase_anatomy_root_label": "Container",
-    "inputBase_best_practice_1": "Use semantic colors for validation states.",
-    "inputBase_best_practice_2": "Always provide a visible label externally (via FieldTemplate).",
-    "inputBase_choice_alt_when": "Use FieldTemplate when you need to wrap an existing input component with a label or error message.",
-    "inputBase_choice_matrix_desc": "Deciding between InputBase and FieldTemplate.",
-    "inputBase_choice_use_when": "Use when building a custom input field (e.g., Search, Select) that needs uniform border and icon styling.",
-    "inputBase_content_guideline_1": "Keep icon usage minimal to avoid visual clutter.",
-    "inputBase_content_guideline_2": "Ensure the focus ring is clearly visible.",
-    "inputBase_design_intent": "InputBase provides a consistent UI shell for text-based inputs, managing icon placement, clear button, and semantic state styling.",
-    "inputBase_i18n_desc": "All visible text is provided by the consumer; InputBase itself has no hardcoded strings.",
-    "inputBase_keyboard_desc": "Delegates keyboard behavior to the wrapped native input element.",
-    "inputBase_motion_desc": "Subtle transitions on border color and clear button visibility.",
-    "inputBase_responsive_desc": "The container scales with its parent; icon widths remain fixed.",
-    "inputBase_scenario_1": "A custom search box with an action icon.",
-    "inputBase_scenario_2": "A complex input wrapper for specialized data entry.",
-    "inputBase_tokens_desc": "Border, background, and spacing tokens control the visual container styling.",
     "recommendation": "Recommendation",
     "scenario": "Scenario",
     "summary": "Summary",
@@ -352,7 +309,6 @@
     "anatomy_module_note": "This component uses CSS Modules; the class names above are local names that are hashed at build time. To override styles, use the design token CSS variables instead of targeting these classes.",
     "test_title": "Testing",
     "test_description": "You can run the unit tests for this component by executing the following command:",
-    "tokens_title": "Design Tokens",
     "usage": "Usage",
     "usage_scenario": "Usage Scenario",
     "transfer_i18n_desc": "Full support for localizing labels, placeholders, and status messages.",
@@ -412,10 +368,6 @@
     "json_viewer_responsive_desc": "Responsive container with horizontal scrolling for deep nesting.",
     "json_viewer_keyboard_desc": "Full keyboard support for tree navigation and copying.",
     "json_viewer_i18n_desc": "Toolbar labels and counts are localized.",
-    "fieldTemplate_long_desc": "A wrapper that adds a label, error message, and required indicator to any input field.",
-    "fieldTemplate_usage_desc": "Wrap any form control to provide a standardized label and error layout.",
-    "inputBase_long_desc": "Internal primitive that underlies all text-based input components.",
-    "inputBase_usage_desc": "Used mainly to build other components. Owns the input-container styling such as border, background, and icon placement.",
     "baseListItem_long_desc": "Internal list-row primitive for building selectable list behaviors.",
     "baseListItem_usage_desc": "Use as a primitive when composing list item interactions.",
     "std_column_component": "Component",

package/dist/locales/en/form.json

@@ -26,26 +26,7 @@
     "close": "Close",
     "dismiss": "Dismiss",
     "label": "Button",
-    "guide_title": "Button Overview",
-    "guide_desc": "Guidelines for choosing and implementing the correct button type for your interface.",
-    "priority_weighting": "A matrix describing when to use Primary, Secondary, or Tertiary buttons.",
-    "semantics_desc": "Buttons trigger actions, while Links change page location or scroll position.",
-    "semantics_guide_ref": "Refer to the Link vs Button guide for more detailed information.",
-    "standard_desc": "Standard rectangular button for general actions.",
-    "standard_usage": "Main CTAs like Submit, Save, or Add Item.",
-    "icon_usage": "Dense toolbars, media controls, or social sharing.",
-    "link_desc": "A button styled like a text link for secondary navigating actions.",
-    "group_desc": "A container that groups multiple logically related buttons together.",
-    "group_usage": "Filter bars, pagination, or multi-step form actions.",
-    "copy_desc": "A specialized button for copying text to the clipboard with visual feedback.",
-    "copy_usage": "API keys, transaction IDs, or sharing links.",
-    "guideline_principle": "Principle",
-    "guideline_detail": "Detail",
-    "consistency": "Consistency",
-    "consistency_desc": "Maintain identical label casing (Sentence case) and icon placement across all buttons.",
-    "placement_desc": "Buttons should be grouped at the bottom-right for modals or bottom-left for forms.",
-    "placement_conflict": "Placement Conflict",
-    "placement_conflict_desc": "Avoid placing multiple primary buttons on the same view."
+    "consistency": "Consistency"
   },
   "btn": {
     "page_transition": "Standard page transitions or footer links."

package/dist/locales/ja/common.json

@@ -23,7 +23,6 @@
     "go_to_next_page": "次のページへ",
     "go_to_page": "{{page}}ページへ移動",
     "go_to_prev_page": "前のページへ",
-    "guideline_desc": "支援技術や多様な閲覧環境に配慮します。",
     "hide_password": "パスワードを隠す",
     "icon_fallback": "アイコン: {{name}}",
     "items_per_page": "1ページあたりの件数",
@@ -208,55 +207,11 @@
     "description": "説明",
     "design_intent_title": "デザインの意図",
     "fieldTemplate_a11y_desc": "IDを介してラベルを入力に、aria-describedby を介してエラーを入力に接続します。",
-    "fieldTemplate_anatomy_content_desc": "実際のコンポーネント（Input、Selectなど）。",
-    "fieldTemplate_anatomy_content_label": "フィールドエリア",
-    "fieldTemplate_anatomy_error_desc": "バリデーションのフィードバックテキスト。",
-    "fieldTemplate_anatomy_error_label": "エラーメッセージ",
-    "fieldTemplate_anatomy_label_desc": "フィールドの名前。",
-    "fieldTemplate_anatomy_label_label": "ラベル",
-    "fieldTemplate_anatomy_required_desc": "アスタリスクまたは（必須）のテキスト。",
-    "fieldTemplate_anatomy_required_label": "必須インジケーター",
-    "fieldTemplate_best_practice_1": "デスクトップの高密度なフォームには水平レイアウトを使用してください。",
-    "fieldTemplate_best_practice_2": "必須フィールドを明確に強調してください。",
-    "fieldTemplate_choice_alt_when": "内部コントロールや、ラベルが不要な高密度な UI の場合。",
-    "fieldTemplate_choice_matrix_desc": "FieldTemplate と直接使用の比較。",
-    "fieldTemplate_choice_use_when": "ほぼすべてのユーザー向けフォームフィールドにおいて使用します。",
-    "fieldTemplate_content_guideline_1": "ラベルは短く簡潔にしてください。",
-    "fieldTemplate_content_guideline_2": "エラーメッセージは具体的で、次のアクションを促すものにしてください。",
-    "fieldTemplate_design_intent": "ラベルとエラーの表示方法を標準化することで、フォームレイアウトの一貫性を保ちます。",
-    "fieldTemplate_i18n_desc": "ラベルとエラーテキストはコンシューマーが提供します。コンポーネント自体にハードコードされた文字列はありません。",
-    "fieldTemplate_keyboard_desc": "フォーカス管理はラップされた入力コンポーネントの動作に従います。",
-    "fieldTemplate_long_desc": "任意の入力フィールドにラベル、エラーメッセージ、および必須インジケーターを追加するラッパーコンポーネントです。",
-    "fieldTemplate_motion_desc": "エラーメッセージはフェードインして注意を引きます。",
-    "fieldTemplate_scenario_1": "標準的な登録フォーム。",
-    "fieldTemplate_scenario_2": "垂直または水平レイアウトの設定ページ。",
-    "fieldTemplate_usage_desc": "任意のフォームコンポーネントをラップして、標準化されたラベルとエラー処理のレイアウトを提供します。",
     "i18n_docgen_intro": "ユーザーに表示されるテキストはすべて props 経由で渡します。翻訳済みの文字列を i18n レイヤーから次の props に渡してください:",
     "i18n_docgen_none": "このコンポーネント自体は固有のテキストを描画しません。渡すコンテンツ側でローカライズしてください。",
     "i18n_title": "多言語化（i18n）の対応",
     "iconButton_desc": "テキストラベルのないアイコンのみを含む正方形のボタン。",
     "inputBase_a11y_desc": "インタラクティブなアイコンが正しいロールとラベルを持つことを保証します。",
-    "inputBase_anatomy_content_desc": "実際の入力値または選択された値のためのスペース。",
-    "inputBase_anatomy_content_label": "コンテンツエリア",
-    "inputBase_anatomy_root_desc": "境界線と背景を定義するメインのラッパー。",
-    "inputBase_anatomy_root_label": "コンテナ",
-    "inputBase_best_practice_1": "バリデーション状態にはセマンティックカラーを使用してください。",
-    "inputBase_best_practice_2": "常に外部から（FieldTemplate経由で）明確なラベルを提供してください。",
-    "inputBase_choice_alt_when": "既存の入力コンポーネントをラベルやエラーメッセージでラップする必要がある場合。",
-    "inputBase_choice_matrix_desc": "InputBase と FieldTemplate のどちらを使用するかを決定します。",
-    "inputBase_choice_use_when": "境界線やアイコンに同一のスタイリングが必要なカスタム入力フィールド（SearchやSelectなど）を作成する場合。",
-    "inputBase_content_guideline_1": "煩雑さを避けるため、アイコンの使用は最小限に抑えてください。",
-    "inputBase_content_guideline_2": "フォーカスリングが明確に見えるようにしてください。",
-    "inputBase_design_intent": "InputBase は、入力フィールドに一貫した UI を提供し、アイコン、クリアボタン、およびセマンティック状態のレイアウトを管理します。",
-    "inputBase_i18n_desc": "表示されるテキストはすべてコンシューマーが提供します。InputBase 自体にハードコードされた文字列はありません。",
-    "inputBase_keyboard_desc": "キーボード動作はラップされたネイティブ入力要素に委譲されます。",
-    "inputBase_long_desc": "すべてのテキストベースの入力コンポーネントの基礎となる内部コンポーネントです。",
-    "inputBase_motion_desc": "境界線の色やクリアボタンの表示に関する微妙なトランジション。",
-    "inputBase_responsive_desc": "コンテナは親に合わせてスケールします。アイコンの幅は固定のままです。",
-    "inputBase_scenario_1": "アクションアイコン付きのカスタム検索ボックス。",
-    "inputBase_scenario_2": "専門的なデータ入力のための複雑な入力ラッパー。",
-    "inputBase_tokens_desc": "ボーダー、背景、スペーシングトークンがビジュアルコンテナのスタイリングを制御します。",
-    "inputBase_usage_desc": "主に他のコンポーネントを構築するために使用されます。境界線、背景、アイコンの配置など、「入力コンテナー」のスタイリングを処理します。",
     "json_viewer_a11y_desc": "キーボードで操作可能なツリーナビゲーション（矢印キーでの移動と切り替え）。",
     "json_viewer_best_practice_1": "巨大なJSONオブジェクトのために、検索やフィルタ機能を含めることを検討してください。",
     "json_viewer_best_practice_2": "クリップボードへのコピー機能をショートカットとして提供してください。",
@@ -273,7 +228,7 @@
     "json_viewer_scenario_2": "システム管理パネルでの設定ファイルの編集。",
     "keyboard_nav_title": "キーボードナビゲーション",
     "label": "ラベル",
-    "label_a11y_desc": "htmlFor/id を使用して Label が入力に関連付けられていることを確認してください。",
+    "label_a11y_desc": "描画されるのは本物の <label> なので、コントロールとの結びつきは htmlFor を渡すことで成立します。この関連付けがあるからこそ、テキストのクリックでフィールドにフォーカスが移り、フィールドがアクセシブル名を得ます。asChild を使うと要素は差し替わりますが同じ属性は子へマージされるため、関連付けの維持は呼び出し側の責任のままです。必須・任意の印は FieldLabelContent が描き、aria-hidden にしています ── 必須であることはラベル文の一部として読ませるのではなく、コントロール側（aria-required）が持つべき情報だからです。",
     "label_anatomy_content": "フォーム要素の実際の説明テキスト。",
     "label_anatomy_content_label": "ラベルテキスト",
     "label_anatomy_root": "テキストとインジケーターをラップするルート要素。",
@@ -287,12 +242,10 @@
     "label_design_intent": "ユーザー入力をガイドするために、フォームコントロールに対して明確でアクセシブルなラベルを提供します。",
     "label_i18n_desc": "ラベルはコンシューマーによって提供されます。コンポーネントにはハードコードされた文字列はありません。",
     "label_keyboard_desc": "ラベル自体はインタラクティブではなく、フォーカスを受け取りません。",
-    "label_long_desc": "フォーム要素の説明やキャプションを表示するためのコンポーネントです。",
     "label_motion_desc": "特定のインタラクションやアニメーションはありません。",
     "label_responsive_desc": "ラベルはすべてのブレークポイントで読み取り可能なままです。視覚的階層を維持するため、フォントサイズは固定されています。",
     "label_scenario_1": "標準的なお問い合わせフォーム。",
     "label_scenario_2": "管理ダッシュボードの設定パネル。",
-    "label_title": "入力フィールドの説明テキスト（必須・任意マークを含む）",
     "label_tokens_desc": "フォントサイズ、ウェイト、テキストカラーにタイポグラフィとカラートークンが使用されています。",
     "location": "場所",
     "motion_spec_title": "モーション仕様",
@@ -425,7 +378,6 @@
     "tag_deletable_desc": "onDelete プロップが渡されると、削除用アイコンが表示され、クリック時にコールバックが実行されます。",
     "test_description": "以下のコマンドを実行して、このコンポーネントの単体テストを実行できます。",
     "test_title": "テストの実行方法",
-    "tokens_title": "デザイントークンの活用",
     "transfer_i18n_desc": "ラベル、プレースホルダー、ステータスメッセージのローカライズを完全にサポートします。",
     "transition": "トランジション",
     "usage": "使用法",

package/dist/locales/ja/form.json

@@ -24,27 +24,8 @@
     "clear": "クリア",
     "close": "閉じる",
     "consistency": "一貫性",
-    "consistency_desc": "すべてのボタンで同一のラベルのケーシング（文の最初の文字のみ大文字）とアイコンの配置を維持します。",
-    "copy_desc": "視覚的なフィードバックを伴ってテキストをクリップボードにコピーするための専用ボタン。",
-    "copy_usage": "APIキー、トランザションID、または共有リンク。",
     "dismiss": "閉じる",
-    "group_desc": "論理的に関連する複数のボタンをグループ化するコンテナ。",
-    "group_usage": "フィルターバー、ページネーション、または複数ステップのフォームアクション。",
-    "guide_desc": "インターフェースに適切なボタンタイプを選択し、実装するためのガイドライン。",
-    "guide_title": "ボタンの概要",
-    "guideline_detail": "詳細",
-    "guideline_principle": "原則",
-    "icon_usage": "高密度のツールバー、メディアコントロール、またはソーシャル共有。",
-    "label": "ボタン",
-    "link_desc": "二次的なナビゲーションアクション用のテキストリンクのようにスタイル設定されたボタン。",
-    "placement_conflict": "配置の競合",
-    "placement_conflict_desc": "同じビューに複数のプライマリボタンを配置しないでください。",
-    "placement_desc": "ボタンは、モーダルの場合は右下に、フォームの場合は左下にグループ化する必要があります。",
-    "priority_weighting": "プライマリ、セカンダリ、またはターシャリボタンを使用するタイミングを説明するマトリックス。",
-    "semantics_desc": "ボタンはアクションをトリガーし、リンクはページの場所やスクロール位置を変更します。",
-    "semantics_guide_ref": "詳細については、リンクとボタンの対比ガイドを参照してください。",
-    "standard_desc": "一般的なアクション用の標準的な長方形ボタン。",
-    "standard_usage": "送信、保存、アイテムの追加などの主要なCTA。"
+    "label": "ボタン"
   },
   "code_block": {
     "collapse_label": "折りたたむ",