themelia-ui 2.0.1 → 3.0.0

package/.agents/skills/themelia-ui/references/components/features--products.md

@@ -1,1492 +0,0 @@
-<!-- GENERATED by scripts/gen-consumer-docs.mjs — do not edit. -->
-
-# `features/products`
-
-Presenting catalogue records — options, readiness, policies and quotes — in the admin profile.
-
-## Selection
-
-- **Use when:** Presenting catalogue records — options, readiness, policies and quotes — in the admin profile.
-- **Avoid when:** The record is an order, invoice or shipment.
-- **Consider instead:** `admin/patterns/commerce`, `features/resource`
-- **Stability:** stable.
-
-## Import
-
-```tsx fragment — import-only example
-import { ProductContractOverview } from "themelia-ui/features/products"
-import "themelia-ui/features/products.css"
-```
-
-## Optional peers
-
-Install these only when importing this family:
-
-```bash
-npm install @tanstack/react-table
-```
-
-## Composition
-
-This family composes `base/action-menu`, `base/badge`, `base/batch-action-bar`, `base/buttons`, `base/choice-inputs`, `base/display`, `base/feedback`, `base/forms`, `base/item`, `base/repeaters`, `base/structure`, `base/table`, `base/text-inputs`, `base/typography`, `base/upload`, `features/overlays`, `features/table`.
-
-Application policy—routing, fetching, persistence, permissions, and translation—stays
-outside the package and arrives through the public props, callbacks, slots, or accessors below.
-
-## Public declarations
-
-### `clampProductPercent`
-
-Kind: callable.
-
-A bar cannot show 140%, and a NaN would render as an empty track.
-
-```text
-(value: number) => number
-```
-
-### `defaultProductContractOverviewStrings`
-
-Kind: const.
-
-```text
-ProductContractOverviewStrings
-```
-
-### `defaultProductDetailsCardStrings`
-
-Kind: const.
-
-```text
-ProductDetailsCardStrings
-```
-
-### `defaultProductOperationsCardStrings`
-
-Kind: const.
-
-```text
-ProductOperationsCardStrings
-```
-
-### `defaultProductOptionActionMenuStrings`
-
-Kind: const.
-
-```text
-ProductOptionActionMenuStrings
-```
-
-### `defaultProductOptionsMatrixStrings`
-
-Kind: const.
-
-```text
-ProductOptionsMatrixStrings
-```
-
-### `defaultProductOptionsSummaryStrings`
-
-Kind: const.
-
-```text
-ProductOptionsSummaryStrings
-```
-
-### `defaultProductOverviewStrings`
-
-Kind: const.
-
-```text
-ProductOverviewStrings
-```
-
-### `defaultProductPoliciesCardStrings`
-
-Kind: const.
-
-```text
-ProductPoliciesCardStrings
-```
-
-### `defaultProductQuotePreviewCardStrings`
-
-Kind: const.
-
-```text
-ProductQuotePreviewCardStrings
-```
-
-### `defaultProductReadinessCardStrings`
-
-Kind: const.
-
-```text
-ProductReadinessCardStrings
-```
-
-### `defaultProductStructureCardStrings`
-
-Kind: const.
-
-```text
-ProductStructureCardStrings
-```
-
-### `defaultProductVariantActionMenuStrings`
-
-Kind: const.
-
-```text
-ProductVariantActionMenuStrings
-```
-
-### `defaultProductVariantBulkTableStrings`
-
-Kind: const.
-
-```text
-ProductVariantBulkTableStrings
-```
-
-### `defaultProductVariantDetailsStrings`
-
-Kind: const.
-
-```text
-ProductVariantDetailsStrings
-```
-
-### `defaultProductVariantEditorStrings`
-
-Kind: const.
-
-```text
-ProductVariantEditorStrings
-```
-
-### `defaultProductVariantsManagerStrings`
-
-Kind: const.
-
-```text
-ProductVariantsManagerStrings
-```
-
-### `defaultProductVariantsTableStrings`
-
-Kind: const.
-
-```text
-ProductVariantsTableStrings
-```
-
-### `PRODUCT_EMPTY_VALUE`
-
-Kind: const.
-
-```text
-unknown
-```
-
-### `PRODUCT_TONE_BADGE`
-
-Kind: const.
-
-```text
-Record<ProductTone, BadgeTone>
-```
-
-### `ProductChoice`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `value` | yes | `string` |  |
-| `label` | yes | `string` |  |
-| `description` | no | `ReactNode` |  |
-| `disabled` | no | `boolean` |  |
-
-### `ProductContractOverview`
-
-Kind: callable.
-
-```text
-({ metricColumns, metrics, terms, rules, onOpenContract, onEditContract, onCreateRule, onSelectRule, onEditRule, onDeleteRule, renderRuleActions, actions, footerSlot, empty, className, strings, }: ProductContractOverviewProps) => import("react").JSX.Element
-```
-
-### `ProductContractOverviewProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `metrics` | no | `ProductMetricSummary[]` |  |
-| `terms` | no | `MetadataListItem[]` |  |
-| `rules` | no | `ProductPolicySummary[]` |  |
-| `onOpenContract` | no | `() => void` |  |
-| `onEditContract` | no | `() => void` |  |
-| `onCreateRule` | no | `() => void` |  |
-| `onSelectRule` | no | `(rule: ProductPolicySummary) => void` |  |
-| `onEditRule` | no | `(rule: ProductPolicySummary) => void` |  |
-| `onDeleteRule` | no | `(rule: ProductPolicySummary) => void` |  |
-| `renderRuleActions` | no | `(rule: ProductPolicySummary, context: ProductRowActionContext) => ReactNode` |  |
-| `metricColumns` | no | `MetadataColumns` | How wide the metric row is allowed to get. Drop it for a card in a rail. |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductContractOverviewStrings>` |  |
-
-### `ProductContractOverviewStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `termsTitle` | yes | `string` |  |
-| `rulesTitle` | yes | `string` |  |
-| `openLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `createRuleLabel` | yes | `string` |  |
-| `editRuleLabel` | yes | `string` |  |
-| `deleteRuleLabel` | yes | `string` |  |
-| `ruleActionsLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductDetailsCard`
-
-Kind: callable.
-
-```text
-({ title, description, metadata, media, onEditDetails, actions, headerEnd: end, footerSlot, empty, className, strings, }: ProductDetailsCardProps) => import("react").JSX.Element
-```
-
-### `ProductDetailsCardProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | no | `ReactNode` |  |
-| `description` | no | `ReactNode \| false` | `false` suppresses the default description rather than showing it empty. |
-| `metadata` | no | `MetadataListItem[]` |  |
-| `media` | no | `ReactNode` |  |
-| `onEditDetails` | no | `() => void` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `headerEnd` | no | `ReactNode` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductDetailsCardStrings>` |  |
-
-### `ProductDetailsCardStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductEmptyState`
-
-Kind: callable.
-
-```text
-({ title, description, action, className, }: { title: ReactNode; description: ReactNode; action?: ReactNode; className?: string; }) => import("react").JSX.Element
-```
-
-### `ProductMetricSummary`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `value` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-
-### `ProductOperationRow`
-
-Kind: callable.
-
-```text
-({ item, actionFallback, onSelect, actions, }: { item: ProductOperationsItem; actionFallback: ReactNode; onSelect?: () => void; actions?: ReactNode; }) => import("react").JSX.Element
-```
-
-### `ProductOperationsCard`
-
-Kind: callable.
-
-```text
-({ items, onCreateOperation, onSelectOperation, onEditOperation, onDeleteOperation, renderOperationActions, actions, footerSlot, renderItem, empty, className, strings, }: ProductOperationsCardProps) => import("react").JSX.Element
-```
-
-### `ProductOperationsCardProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `items` | no | `ProductOperationsItem[]` |  |
-| `onCreateOperation` | no | `() => void` |  |
-| `onSelectOperation` | no | `(item: ProductOperationsItem) => void` |  |
-| `onEditOperation` | no | `(item: ProductOperationsItem) => void` |  |
-| `onDeleteOperation` | no | `(item: ProductOperationsItem) => void` |  |
-| `renderOperationActions` | no | `(item: ProductOperationsItem, context: ProductRowActionContext) => ReactNode` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `renderItem` | no | `(item: ProductOperationsItem, index: number) => ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductOperationsCardStrings>` |  |
-
-### `ProductOperationsCardStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductOperationsItem`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `value` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-| `actionLabel` | no | `ReactNode` |  |
-| `onSelect` | no | `() => void` |  |
-
-### `ProductOptionActionContext`
-
-Kind: interface.
-
-Extends: `ProductRowActionContext`.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `onDuplicate` | no | `() => void` | Present so the option and variant menus hand their render prop the same shape. |
-
-### `ProductOptionActionMenu`
-
-Kind: callable.
-
-The per-option overflow menu, exported for screens that lay out options themselves and
-want the same verbs and labels as the summary card.
-
-```text
-({ option, index, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, menuLabel, className, strings, }: ProductOptionActionMenuProps) => import("react").JSX.Element
-```
-
-### `ProductOptionActionMenuProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `option` | yes | `ProductOptionSummary` |  |
-| `index` | no | `number` |  |
-| `onSelectOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `onEditOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `onDeleteOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `renderOptionActions` | no | `(option: ProductOptionSummary, context: ProductRowActionContext) => ReactNode` |  |
-| `menuLabel` | no | `string` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductOptionActionMenuStrings>` |  |
-
-### `ProductOptionActionMenuStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `viewLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-
-### `ProductOptionEditDraft`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `name` | yes | `string` |  |
-| `values` | yes | `ProductOptionValue[]` |  |
-
-### `ProductOptionGroup`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `name` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `values` | no | `readonly ProductOptionValue[]` |  |
-| `usedForVariants` | no | `boolean` | Whether this option takes part in generating variants. |
-| `position` | no | `number` |  |
-| `badge` | no | `ReactNode` |  |
-
-### `ProductOptionsMatrix`
-
-Kind: callable.
-
-```text
-({ optionGroups, surface, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, confirmDelete, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onSaveEditingOption, onCancelEditingOption, onToggleUsedForVariants, onReorderOptions, actions, footerSlot, empty, className, strings, }: ProductOptionsMatrixProps) => import("react").JSX.Element
-```
-
-### `ProductOptionsMatrixProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `optionGroups` | no | `ProductOptionGroup[]` |  |
-| `surface` | no | `ProductSurface` |  |
-| `editingOptionId` | no | `string \| null` |  |
-| `defaultEditingOptionId` | no | `string \| null` |  |
-| `onEditingOptionIdChange` | no | `(optionId: string \| null, option?: ProductOptionGroup) => void` |  |
-| `onCreateOption` | no | `() => void` |  |
-| `onEditOption` | no | `(option: ProductOptionGroup) => void` |  |
-| `onDeleteOption` | no | `(option: ProductOptionGroup) => void` |  |
-| `confirmDelete` | no | `boolean` | Off when the app already confirms, so nobody is asked twice. |
-| `onAddValue` | no | `(option: ProductOptionGroup) => void` |  |
-| `onDeleteValue` | no | `(option: ProductOptionGroup, value: ProductOptionValue) => void` |  |
-| `onOptionNameChange` | no | `(option: ProductOptionGroup, value: string) => void` |  |
-| `onValueLabelChange` | no | `(option: ProductOptionGroup, value: ProductOptionValue, label: string) => void` |  |
-| `onSaveEditingOption` | no | `(option: ProductOptionGroup, draft: ProductOptionEditDraft) => void` |  |
-| `onCancelEditingOption` | no | `(option: ProductOptionGroup, draft: ProductOptionEditDraft) => void` |  |
-| `onToggleUsedForVariants` | no | `(option: ProductOptionGroup, used: boolean) => void` |  |
-| `onReorderOptions` | no | `(options: ProductOptionGroup[]) => void` | Enables the grip. Without it the list keeps its order and shows no handle. |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductOptionsMatrixStrings>` |  |
-
-### `ProductOptionsMatrixStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-| `nameLabel` | yes | `string` |  |
-| `namePlaceholder` | yes | `string` |  |
-| `valuesLabel` | yes | `string` |  |
-| `valuePlaceholder` | yes | `string` |  |
-| `addValueLabel` | yes | `string` |  |
-| `removeValueLabel` | yes | `string` |  |
-| `usedForVariantsLabel` | yes | `string` |  |
-| `usedForVariantsDescription` | yes | `string` |  |
-| `saveLabel` | yes | `string` |  |
-| `cancelLabel` | yes | `string` |  |
-| `doneLabel` | yes | `string` |  |
-| `noValues` | yes | `string` |  |
-| `confirmDeleteTitle` | yes | `string` |  |
-| `confirmDeleteDescription` | yes | `(name: string) => string` |  |
-| `confirmDeleteConfirm` | yes | `string` |  |
-| `confirmDeleteCancel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductOptionsSummary`
-
-Kind: callable.
-
-```text
-({ options, onManageOptions, onCreateOption, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, actions, footerSlot, empty, className, strings, }: ProductOptionsSummaryProps) => import("react").JSX.Element
-```
-
-### `ProductOptionsSummaryProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `options` | no | `ProductOptionSummary[]` |  |
-| `onManageOptions` | no | `() => void` |  |
-| `onCreateOption` | no | `() => void` |  |
-| `onSelectOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `onEditOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `onDeleteOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `renderOptionActions` | no | `(option: ProductOptionSummary, context: ProductRowActionContext) => ReactNode` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductOptionsSummaryStrings>` |  |
-
-### `ProductOptionsSummaryStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `manageLabel` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductOptionSummary`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `values` | no | `readonly ReactNode[]` |  |
-| `value` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-| `badge` | no | `ReactNode` |  |
-
-### `ProductOptionValue`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `disabled` | no | `boolean` |  |
-| `badge` | no | `ReactNode` |  |
-
-### `ProductOverview`
-
-Kind: callable.
-
-```text
-({ metricColumns, title, description, metrics, media, status, statusTone, actions, headerEnd: end, footerSlot, className, strings, }: ProductOverviewProps) => import("react").JSX.Element
-```
-
-### `ProductOverviewProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | no | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `metrics` | no | `ProductMetricSummary[]` |  |
-| `media` | no | `ReactNode` |  |
-| `status` | no | `ReactNode` |  |
-| `statusTone` | no | `BadgeTone` |  |
-| `metricColumns` | no | `MetadataColumns` | How wide the metric row is allowed to get. Drop it for a card in a rail. |
-| `actions` | no | `ActionDefinition[]` |  |
-| `headerEnd` | no | `ReactNode` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductOverviewStrings>` |  |
-
-### `ProductOverviewStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-
-### `ProductPoliciesCard`
-
-Kind: callable.
-
-```text
-({ policies, onCreatePolicy, onSelectPolicy, onEditPolicy, onDeletePolicy, renderPolicyActions, actions, footerSlot, empty, className, strings, }: ProductPoliciesCardProps) => import("react").JSX.Element
-```
-
-### `ProductPoliciesCardProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `policies` | no | `ProductPolicySummary[]` |  |
-| `onCreatePolicy` | no | `() => void` |  |
-| `onSelectPolicy` | no | `(policy: ProductPolicySummary) => void` |  |
-| `onEditPolicy` | no | `(policy: ProductPolicySummary) => void` |  |
-| `onDeletePolicy` | no | `(policy: ProductPolicySummary) => void` |  |
-| `renderPolicyActions` | no | `(policy: ProductPolicySummary, context: ProductRowActionContext) => ReactNode` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductPoliciesCardStrings>` |  |
-
-### `ProductPoliciesCardStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductPolicySummary`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `value` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-| `badge` | no | `ReactNode` |  |
-
-### `ProductQuotePreviewCard`
-
-Kind: callable.
-
-```text
-({ lines, summary, note, onRecalculate, actions, footerSlot, empty, className, strings, }: ProductQuotePreviewCardProps) => import("react").JSX.Element
-```
-
-### `ProductQuotePreviewCardProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `lines` | no | `ProductQuotePreviewLine[]` |  |
-| `summary` | no | `ReactNode` |  |
-| `note` | no | `ReactNode` |  |
-| `onRecalculate` | no | `() => void` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductQuotePreviewCardStrings>` |  |
-
-### `ProductQuotePreviewCardStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `recalculateLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductQuotePreviewLine`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `value` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-| `emphasis` | no | `boolean` | Ruled off and emphasised: the line the rest add up to. |
-
-### `ProductReadinessCard`
-
-Kind: callable.
-
-```text
-({ items, score, scoreLabel, summary, onCreateReadinessItem, onSelectReadinessItem, onEditReadinessItem, onDeleteReadinessItem, renderReadinessItemActions, actions, footerSlot, renderItem, empty, className, strings, }: ProductReadinessCardProps) => import("react").JSX.Element
-```
-
-### `ProductReadinessCardProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `items` | no | `ProductReadinessItem[]` |  |
-| `score` | no | `number` | 0–100, clamped. |
-| `scoreLabel` | no | `ReactNode` |  |
-| `summary` | no | `ReactNode` |  |
-| `onCreateReadinessItem` | no | `() => void` |  |
-| `onSelectReadinessItem` | no | `(item: ProductReadinessItem) => void` |  |
-| `onEditReadinessItem` | no | `(item: ProductReadinessItem) => void` |  |
-| `onDeleteReadinessItem` | no | `(item: ProductReadinessItem) => void` |  |
-| `renderReadinessItemActions` | no | `(item: ProductReadinessItem, context: ProductRowActionContext) => ReactNode` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `renderItem` | no | `(item: ProductReadinessItem, index: number) => ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductReadinessCardStrings>` |  |
-
-### `ProductReadinessCardStrings`
-
-Kind: interface.
-
-Products copy: one strings object per surface, since the cards are used independently.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `scoreLabel` | yes | `string` |  |
-| `progressLabel` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductReadinessItem`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `value` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-| `completed` | no | `boolean` |  |
-| `actionLabel` | no | `ReactNode` |  |
-| `onSelect` | no | `() => void` |  |
-
-### `ProductReadinessRow`
-
-Kind: callable.
-
-```text
-({ item, actionFallback, onSelect, actions, }: { item: ProductReadinessItem; actionFallback: ReactNode; onSelect?: () => void; actions?: ReactNode; }) => import("react").JSX.Element
-```
-
-### `ProductRowActionContext`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `index` | yes | `number` |  |
-| `onSelect` | no | `() => void` |  |
-| `onEdit` | no | `() => void` |  |
-| `onDelete` | no | `() => void` |  |
-
-### `ProductRowActions`
-
-Kind: callable.
-
-```text
-({ item, actions, menuLabel, className, }: { item: TItem; actions: TableAction<TItem>[]; menuLabel: string; className?: string; }) => import("react").JSX.Element | null
-```
-
-### `ProductStructureCard`
-
-Kind: callable.
-
-```text
-({ metrics, onCreateMetric, onSelectMetric, onEditMetric, onDeleteMetric, renderMetricActions, actions, footerSlot, empty, className, strings, }: ProductStructureCardProps) => import("react").JSX.Element
-```
-
-### `ProductStructureCardProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `metrics` | no | `ProductStructureMetric[]` |  |
-| `onCreateMetric` | no | `() => void` |  |
-| `onSelectMetric` | no | `(metric: ProductStructureMetric) => void` |  |
-| `onEditMetric` | no | `(metric: ProductStructureMetric) => void` |  |
-| `onDeleteMetric` | no | `(metric: ProductStructureMetric) => void` |  |
-| `renderMetricActions` | no | `(metric: ProductStructureMetric, context: ProductRowActionContext) => ReactNode` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductStructureCardStrings>` |  |
-
-### `ProductStructureCardStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `actionsLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductStructureMetric`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `ReactNode` |  |
-| `value` | yes | `ReactNode` |  |
-| `description` | no | `ReactNode` |  |
-| `tone` | no | `ProductTone` |  |
-| `icon` | no | `ReactNode` |  |
-
-### `ProductStructureMetricRow`
-
-Kind: callable.
-
-```text
-({ metric, actions, }: { metric: ProductStructureMetric; actions?: ReactNode; }) => import("react").JSX.Element
-```
-
-### `ProductSummaryRow`
-
-Kind: callable.
-
-```text
-({ item, actionLabel, onSelect, actions, }: { item: ProductOptionSummary | ProductPolicySummary; actionLabel?: ReactNode; onSelect?: () => void; actions?: ReactNode; }) => import("react").JSX.Element
-```
-
-### `ProductSurface`
-
-Kind: type.
-
-`card` frames the surface; `embedded` renders it bare inside one that already exists.
-
-```text
-"card" | "embedded"
-```
-
-### `ProductThumbnail`
-
-Kind: callable.
-
-A variant's picture, or a dashed slot where one would go (a grey square reads as a
-failed image). Only a button with `onSelect`; otherwise the slot is inert and muted.
-
-```text
-({ src, alt, media, onSelect, label, className, }: { src?: string; alt?: string; media?: ReactNode; onSelect?: () => void; label?: string; className?: string; }) => import("react").JSX.Element
-```
-
-### `ProductTone`
-
-Kind: type.
-
-No `secondary`: it means "not this one" rather than a state a product can be in.
-
-```text
-Exclude<SemanticTone, "secondary">
-```
-
-### `ProductToneDot`
-
-Kind: callable.
-
-```text
-({ tone }: { tone?: ProductTone; }) => import("react").JSX.Element
-```
-
-### `ProductVariantActionContext`
-
-Kind: interface.
-
-Extends: `ProductRowActionContext`.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `onDuplicate` | no | `() => void` |  |
-| `isSelected` | no | `boolean` |  |
-| `onToggleSelected` | no | `(checked: boolean) => void` |  |
-
-### `ProductVariantActionMenu`
-
-Kind: callable.
-
-```text
-({ variant, index, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, menuLabel, className, strings, }: ProductVariantActionMenuProps) => import("react").JSX.Element | null
-```
-
-### `ProductVariantActionMenuProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `variant` | yes | `ProductVariantSummary` |  |
-| `index` | no | `number` |  |
-| `onSelectVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onEditVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onDuplicateVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onDeleteVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `renderVariantActions` | no | `(variant: ProductVariantSummary, context: ProductVariantActionContext) => ReactNode` |  |
-| `menuLabel` | no | `string` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductVariantActionMenuStrings>` |  |
-
-### `ProductVariantActionMenuStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `menuLabel` | yes | `string` |  |
-| `openLabel` | yes | `string` |  |
-| `editLabel` | yes | `string` |  |
-| `duplicateLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-
-### `ProductVariantBulkActionContext`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `selectedRows` | yes | `ProductVariantRow[]` |  |
-| `selectedIds` | yes | `string[]` |  |
-| `allRows` | yes | `ProductVariantRow[]` |  |
-| `selectedCount` | yes | `number` |  |
-| `totalCount` | yes | `number` |  |
-| `allRowsSelected` | yes | `boolean` |  |
-| `clearSelection` | yes | `() => void` |  |
-| `setSelectedIds` | yes | `(variantIds: string[]) => void` |  |
-
-### `ProductVariantBulkTableStrings`
-
-Kind: interface.
-
-Extends: `ProductVariantsTableStrings`.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `generateLabel` | yes | `string` |  |
-| `selectAllLabel` | yes | `string` |  |
-| `selectRowLabel` | yes | `(name: string) => string` |  |
-| `selectedCount` | yes | `(count: number, total: number) => string` |  |
-| `clearSelection` | yes | `string` |  |
-| `bulkEditLabel` | yes | `string` |  |
-| `bulkDeleteLabel` | yes | `string` |  |
-| `groupLabel` | yes | `(option: string, value: string) => string` |  |
-| `ungrouped` | yes | `string` |  |
-| `groupCount` | yes | `(count: number) => string` |  |
-| `selectGroupLabel` | yes | `(group: string) => string` |  |
-| `expandGroup` | yes | `string` |  |
-| `collapseGroup` | yes | `string` |  |
-| `setImageLabel` | yes | `(name: string) => string` |  |
-
-### `ProductVariantCell`
-
-Kind: callable.
-
-A label/value pair whose label is visually hidden while a column heading names the value,
-and shown once the table collapses at narrow widths.
-
-```text
-({ label, weight, className, children, }: { label: ReactNode; weight?: "normal" | "medium" | "semibold" | "bold"; className?: string; children: ReactNode; }) => import("react").JSX.Element
-```
-
-### `ProductVariantCellDisplay`
-
-Kind: type.
-
-`text` shows the value; `field` makes it editable in place.
-
-```text
-"text" | "field"
-```
-
-### `ProductVariantCellDisplayConfig`
-
-Kind: type.
-
-```text
-ProductVariantCellDisplay | Partial<Record<ProductVariantEditableField, ProductVariantCellDisplay>>
-```
-
-### `ProductVariantDetails`
-
-Kind: callable.
-
-```text
-({ variant, metadata, optionItems, media, onBack, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onSelectOption, actions, headerEnd, footerSlot, empty, renderActions, renderMetadata, renderOption, className, strings, }: ProductVariantDetailsProps) => import("react").JSX.Element
-```
-
-### `ProductVariantDetailsProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `variant` | no | `ProductVariantSummary` | Absent renders the empty state (this surface is often bound to a selection). |
-| `metadata` | no | `MetadataListItem[]` | Replaces the derived facts. The default is built from the variant's own fields. |
-| `optionItems` | no | `ProductOptionSummary[]` |  |
-| `media` | no | `ReactNode` |  |
-| `onBack` | no | `() => void` |  |
-| `onSelectVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onEditVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onDuplicateVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onDeleteVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onSelectOption` | no | `(option: ProductOptionSummary) => void` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `headerEnd` | no | `ReactNode` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `renderActions` | no | `ProductVariantActionMenuProps["renderVariantActions"]` |  |
-| `renderMetadata` | no | `(variant: ProductVariantSummary) => ReactNode` |  |
-| `renderOption` | no | `(option: ProductOptionSummary, index: number) => ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductVariantDetailsStrings>` |  |
-
-### `ProductVariantDetailsStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `backLabel` | yes | `string` |  |
-| `factsTitle` | yes | `string` |  |
-| `selectedOptionsTitle` | yes | `string` |  |
-| `relatedOptionsTitle` | yes | `string` |  |
-| `viewOptionLabel` | yes | `string` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-| `metadata` | yes | `{ price: string; inventory: string; sku: string; channels: string; updated: string; }` |  |
-
-### `ProductVariantEditableField`
-
-Kind: type.
-
-```text
-"sku" | "price" | "inventory"
-```
-
-### `ProductVariantEditor`
-
-Kind: callable.
-
-```text
-({ value: valueProp, defaultValue, optionFields, statusOptions, onValueChange, onSubmit, onError, onCancel, onDelete, actions, headerEnd, footerSlot, disabled, submitting, className, strings, }: ProductVariantEditorProps) => import("react").JSX.Element
-```
-
-### `ProductVariantEditorProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `value` | no | `ProductVariantEditorValues` |  |
-| `defaultValue` | no | `ProductVariantEditorValues` |  |
-| `optionFields` | no | `ProductVariantOptionField[]` |  |
-| `statusOptions` | no | `ProductChoice[]` |  |
-| `onValueChange` | no | `(value: ProductVariantEditorValues) => void` |  |
-| `onSubmit` | no | `(value: ProductVariantEditorValues) => void \| Promise<void>` |  |
-| `onError` | no | `(error: unknown) => void` | Receives a rejected submit. Persistence and the message stay with the consumer. |
-| `onCancel` | no | `() => void` |  |
-| `onDelete` | no | `(value: ProductVariantEditorValues) => void` |  |
-| `actions` | no | `ActionDefinition[]` |  |
-| `headerEnd` | no | `ReactNode` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `disabled` | no | `boolean` |  |
-| `submitting` | no | `boolean` | Shows the pending state and blocks a repeat submit. |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductVariantEditorStrings>` |  |
-
-### `ProductVariantEditorStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `identityTitle` | yes | `string` |  |
-| `commercialTitle` | yes | `string` |  |
-| `optionsTitle` | yes | `string` |  |
-| `saveLabel` | yes | `string` |  |
-| `savingLabel` | yes | `string` |  |
-| `cancelLabel` | yes | `string` |  |
-| `deleteLabel` | yes | `string` |  |
-| `statusPlaceholder` | yes | `string` |  |
-| `optionPlaceholder` | yes | `string` |  |
-| `fields` | yes | `{ name: string; description: string; sku: string; price: string; inventory: string; status: string; channels: string; }` |  |
-| `placeholders` | yes | `{ name: string; description: string; sku: string; price: string; inventory: string; status: string; channels: string; }` |  |
-
-### `ProductVariantEditorValues`
-
-Kind: interface.
-
-Every field is a string: this is a form, and a form's value is what was typed.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `name` | no | `string` |  |
-| `description` | no | `string` |  |
-| `sku` | no | `string` |  |
-| `price` | no | `string` |  |
-| `inventory` | no | `string` |  |
-| `status` | no | `string` |  |
-| `channels` | no | `string` |  |
-| `options` | no | `Record<string, string \| undefined>` | Keyed by option group id. |
-
-### `ProductVariantFieldChangeContext`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `index` | yes | `number` |  |
-| `field` | yes | `ProductVariantEditableField` |  |
-| `previousValue` | no | `ReactNode` |  |
-| `value` | yes | `string` |  |
-
-### `ProductVariantOptionCombinationDisplay`
-
-Kind: type.
-
-```text
-"text" | "tags" | "none"
-```
-
-### `ProductVariantOptionField`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `label` | yes | `string` |  |
-| `value` | no | `string` | Overrides the value held under this field's id. |
-| `choices` | no | `ProductChoice[]` | With choices it is a select; without, a text field. |
-| `placeholder` | no | `string` |  |
-| `helperText` | no | `string` |  |
-
-### `ProductVariantRow`
-
-Kind: interface.
-
-Extends: `ProductVariantSummary`.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `optionValues` | no | `Record<string, ReactNode>` | Rendered value per option group id, shown in the combination column. |
-| `optionValueIds` | no | `Record<string, string \| undefined>` | The chosen value's id per option group, for grouping rows by an option. |
-
-### `ProductVariantsBulkTable`
-
-Kind: callable.
-
-```text
-({ variants, optionGroups, groupByOptionId, visibleColumns, optionCombinationDisplay, cellDisplay, selectionMode, renderOptionCombination, selectedVariantIds, defaultSelectedVariantIds, onSelectedVariantIdsChange, onVariantFieldChange, onVariantFieldBlur, onCreateVariant, onGenerateVariants, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onSetVariantImage, onBulkEdit, onBulkDelete, renderVariantActions, renderBulkActions, actions, headerEnd, footerSlot, empty, surface, className, strings, }: ProductVariantsBulkTableProps) => import("react").JSX.Element
-```
-
-### `ProductVariantsBulkTableColumn`
-
-Kind: type.
-
-```text
-"variant" | "sku" | "price" | "inventory" | "status" | "updated"
-```
-
-### `ProductVariantsBulkTableProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `variants` | no | `ProductVariantRow[]` |  |
-| `optionGroups` | no | `ProductOptionGroup[]` |  |
-| `groupByOptionId` | no | `string \| null` | Groups rows under the values of this option. `null` leaves the list flat. |
-| `visibleColumns` | no | `readonly ProductVariantsBulkTableColumn[]` |  |
-| `optionCombinationDisplay` | no | `ProductVariantOptionCombinationDisplay` |  |
-| `cellDisplay` | no | `ProductVariantCellDisplayConfig` |  |
-| `selectionMode` | no | `ProductVariantSelectionMode` |  |
-| `renderOptionCombination` | no | `(variant: ProductVariantRow, values: ReactNode[]) => ReactNode` |  |
-| `selectedVariantIds` | no | `string[]` |  |
-| `defaultSelectedVariantIds` | no | `string[]` |  |
-| `onSelectedVariantIdsChange` | no | `(variantIds: string[], variants: ProductVariantRow[]) => void` |  |
-| `onVariantFieldChange` | no | `(variant: ProductVariantRow, field: ProductVariantEditableField, value: string, context: ProductVariantFieldChangeContext) => void` |  |
-| `onVariantFieldBlur` | no | `(variant: ProductVariantRow, field: ProductVariantEditableField, value: string, context: ProductVariantFieldChangeContext) => void` |  |
-| `onCreateVariant` | no | `() => void` |  |
-| `onGenerateVariants` | no | `() => void` |  |
-| `onSelectVariant` | no | `(variant: ProductVariantRow) => void` |  |
-| `onEditVariant` | no | `(variant: ProductVariantRow) => void` |  |
-| `onDuplicateVariant` | no | `(variant: ProductVariantRow) => void` |  |
-| `onDeleteVariant` | no | `(variant: ProductVariantRow) => void` |  |
-| `onBulkEdit` | no | `(variants: ProductVariantRow[]) => void` |  |
-| `onBulkDelete` | no | `(variants: ProductVariantRow[]) => void` |  |
-| `renderVariantActions` | no | `(variant: ProductVariantRow, context: ProductVariantActionContext) => ReactNode` |  |
-| `renderBulkActions` | no | `(context: ProductVariantBulkActionContext) => ReactNode` |  |
-| `onSetVariantImage` | no | `(variant: ProductVariantRow) => void` | Makes the picture slot pressable. Without it the slot is inert. |
-| `actions` | no | `ActionDefinition[]` |  |
-| `headerEnd` | no | `ReactNode` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `surface` | no | `ProductSurface` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductVariantBulkTableStrings>` |  |
-
-### `ProductVariantSelectionMode`
-
-Kind: type.
-
-```text
-"multiple" | "none"
-```
-
-### `ProductVariantsManager`
-
-Kind: callable.
-
-The options and the variants they generate, in one card: the variant grid is a
-consequence of the options above it. The grouping control sits between the two halves
-because it is a question about the options that changes the grid.
-
-```text
-({ className, strings, optionsStrings, variantsStrings, optionGroups, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onSaveEditingOption, onCancelEditingOption, onToggleUsedForVariants, onReorderOptions, confirmDelete, groupByOptionId: groupByProp, defaultGroupByOptionId, onGroupByOptionIdChange, showGroupBy, ...variantProps }: ProductVariantsManagerProps) => import("react").JSX.Element
-```
-
-### `ProductVariantsManagerProps`
-
-Kind: interface.
-
-Extends: `Pick<ProductOptionsMatrixProps, "optionGroups" | "editingOptionId" | "defaultEditingOptionId" | "onEditingOptionIdChange" | "onCreateOption" | "onEditOption" | "onDeleteOption" | "onAddValue" | "onDeleteValue" | "onOptionNameChange" | "onValueLabelChange" | "onSaveEditingOption" | "onCancelEditingOption" | "onToggleUsedForVariants" | "onReorderOptions" | "confirmDelete">`, `Pick<ProductVariantsBulkTableProps, "variants" | "visibleColumns" | "optionCombinationDisplay" | "cellDisplay" | "selectionMode" | "selectedVariantIds" | "defaultSelectedVariantIds" | "onSelectedVariantIdsChange" | "onVariantFieldChange" | "onVariantFieldBlur" | "onCreateVariant" | "onGenerateVariants" | "onSelectVariant" | "onEditVariant" | "onDuplicateVariant" | "onDeleteVariant" | "onBulkEdit" | "onBulkDelete" | "renderVariantActions" | "renderBulkActions">`.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `groupByOptionId` | no | `string \| null` | Controlled grouping. Uncontrolled, the manager's own Select drives it. |
-| `defaultGroupByOptionId` | no | `string \| null` |  |
-| `onGroupByOptionIdChange` | no | `(optionId: string \| null) => void` |  |
-| `showGroupBy` | no | `boolean` | Hides the grouping control, for a surface that drives it from elsewhere. |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductVariantsManagerStrings>` |  |
-| `optionsStrings` | no | `Partial<Strings.ProductOptionsMatrixStrings>` |  |
-| `variantsStrings` | no | `Partial<Strings.ProductVariantBulkTableStrings>` |  |
-
-### `ProductVariantsManagerStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `groupByLabel` | yes | `string` |  |
-| `groupByNone` | yes | `string` |  |
-
-### `ProductVariantsTable`
-
-Kind: callable.
-
-```text
-({ variants, onCreateVariant, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, actions, footerSlot, empty, className, strings, }: ProductVariantsTableProps) => import("react").JSX.Element
-```
-
-### `ProductVariantsTableProps`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `variants` | no | `ProductVariantSummary[]` |  |
-| `onCreateVariant` | no | `() => void` |  |
-| `onSelectVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onEditVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onDuplicateVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `onDeleteVariant` | no | `(variant: ProductVariantSummary) => void` |  |
-| `renderVariantActions` | no | `(variant: ProductVariantSummary, context: ProductVariantActionContext) => ReactNode` |  |
-| `onSetVariantImage` | no | `(variant: ProductVariantSummary) => void` | Makes the picture slot pressable. Without it the slot is inert. |
-| `actions` | no | `ActionDefinition[]` |  |
-| `footerSlot` | no | `ReactNode` |  |
-| `empty` | no | `ReactNode` |  |
-| `className` | no | `string` |  |
-| `strings` | no | `Partial<Strings.ProductVariantsTableStrings>` |  |
-
-### `ProductVariantsTableStrings`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `title` | yes | `string` |  |
-| `description` | yes | `string` |  |
-| `createLabel` | yes | `string` |  |
-| `columns` | yes | `{ variant: string; sku: string; price: string; inventory: string; channels: string; status: string; updated: string; actions: string; }` |  |
-| `emptyTitle` | yes | `string` |  |
-| `emptyDescription` | yes | `string` |  |
-
-### `ProductVariantSummary`
-
-Kind: interface.
-
-| member | required | type | description / documented default |
-| --- | :-: | --- | --- |
-| `id` | yes | `string` |  |
-| `name` | yes | `ReactNode` |  |
-| `image` | no | `string` | The variant's picture. Absent draws the empty slot. |
-| `imageAlt` | no | `string` |  |
-| `media` | no | `ReactNode` | Replaces the image entirely: a swatch, a video still, a monogram. |
-| `description` | no | `ReactNode` |  |
-| `options` | no | `readonly ReactNode[]` |  |
-| `sku` | no | `ReactNode` |  |
-| `price` | no | `ReactNode` |  |
-| `inventory` | no | `ReactNode` |  |
-| `channels` | no | `ReactNode` |  |
-| `updatedAt` | no | `ReactNode` |  |
-| `status` | no | `ReactNode` |  |
-| `statusTone` | no | `BadgeTone` |  |
-
-## Preview recipes
-
-Preview route: Options & variants — `/product-variants`
-
-### Options and variants together
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductVariantsManager
-  optionGroups={options}
-  variants={variants}
-  groupByOptionId="size"
-  cellDisplay="field"
-  onCreateOption={createOption}
-  onSaveEditingOption={(option, draft) => save(option.id, draft)}
-  onAddValue={addValue}
-  onGenerateVariants={generate}
-  onVariantFieldBlur={(variant, field, value) => patch(variant.id, field, value)}
-/>
-```
-
-### The two option surfaces
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductOptionsSummary options={summary} onManageOptions={openMatrix} />
-
-<ProductOptionsMatrix
-  optionGroups={groups}
-  onSaveEditingOption={(option, draft) => save(option.id, draft)}
-  onAddValue={addValue}
-  onDeleteOption={remove}
-  confirmDelete            // on by default — removing an option removes its variants
-/>
-```
-
-### Variants
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductVariantsBulkTable
-  variants={variants}
-  optionGroups={groups}
-  groupByOptionId="size"
-  cellDisplay={{ sku: "field", price: "field", inventory: "text" }}
-  onVariantFieldBlur={(variant, field, value) => api.patch(variant.id, { [field]: value })}
-  onBulkDelete={(rows) => api.removeMany(rows.map((row) => row.id))}
-/>
-```
-
-### One variant, read and edited
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductVariantDetails
-  variant={selected}
-  optionItems={options}
-  onBack={() => setSelected(null)}
-  onEditVariant={(variant) => setEditing(variant)}
-/>
-
-<ProductVariantEditor
-  defaultValue={{ name: "M · Trail", sku: "TRL-29-M-TR", price: "€1,850" }}
-  optionFields={[{ id: "size", label: "Frame size", choices: sizes }]}
-  statusOptions={statuses}
-  onSubmit={(values) => api.save(values)}
-  onDelete={(values) => api.remove(values)}
-/>
-```
-
-### Nothing yet
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductVariantsBulkTable
-  variants={[]}
-  onGenerateVariants={() => api.generate(productId)}
-/>
-```
-
-### Overview and quote
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductOverview
-  title="Trailhead 29er"
-  status="Live"
-  statusTone="success"
-  metrics={[{ id: "variants", label: "Variants", value: "18" }]}
-/>
-
-<ProductQuotePreviewCard
-  lines={[…, { id: "total", label: "Total", value: "€2,268", emphasis: true }]}
-  onRecalculate={() => api.quote(id)}
-/>
-```
-
-### Readiness, structure, operations
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductReadinessCard
-  score={72}
-  items={[{ id: "price", label: "Pricing", tone: "warning", value: "1 missing" }]}
-  onSelectReadinessItem={(item) => open(item.id)}
-/>
-```
-
-### Details, contract, policies
-
-```tsx fragment — excerpt from the live preview; surrounding values are supplied by the application
-<ProductContractOverview
-  metrics={metrics}
-  terms={terms}          // MetadataListItem[]
-  rules={rules}
-  onCreateRule={() => …}
-/>
-```