bitboss-ui 3.0.0-beta.63 → 3.0.0-beta.64

package/dist/ai/source/BbTabsRoot.md

@@ -76,8 +76,14 @@ import type {
 	PtMap,
 	PtNoInfer,
 	PtValue,
+	PtVariantAttrs,
 } from '@/types/passthrough';
-import type { TabsVariantType } from '@/types/TabsVariant';
+import {
+	TABS_VARIANTS,
+	type TabsVariantBuiltIn,
+	type TabsVariantRegistry,
+	type TabsVariantType,
+} from '@/types/TabsVariant';
 /**
  * Inertia-specific options shared between `BbTabsProps` (component-level defaults)
  * and `BbTabsItem` (per-item overrides). Item values always win over component values.
@@ -200,7 +206,7 @@ export type BbTabsItem<K extends string = string> = BbTabsInertiaOptions & {
  * Passthrough parts of `BbTabs` (plans/passthrough/BbTabs.md). Tabs do not
  * "open", so there is no `open` state.
  *
- * Per-item functions: on the instance, `item` also accepts `({ item, active, … }) => PtValue | false | null | undefined` — `item` is the tab's descriptor (the element of `items`: its `value`, `label`, anything else you put on it), and every state a boolean beside it, on for it (`active`, `disabled`, …) — in the `pt` object or the `:pt:item` attribute, never on a `item:<state>` key and never in the global map or a scope (they ship as JSON). Its result is merged last, after every state entry, through the same deduper; a falsy result leaves the trigger as it was. No other part takes a function. See the passthrough guide, _Per-item functions_.
+ * Per-item functions: on the instance, `item` also accepts `({ item, active, … }) => PtValue | false | null | undefined` — `item` is the tab's descriptor (the element of `items`: its `value`, `label`, anything else you put on it), every state a boolean beside it, on for it (`active`, `disabled`, …), and the strip's `variant` as a string — in the `pt` object or the `:pt:item` attribute, never on a `item:<state>` key and never in the global map or a scope (they ship as JSON). Its result is merged last, after every state entry, through the same deduper; a falsy result leaves the trigger as it was. No other part takes a function. See the passthrough guide, _Per-item functions_.
  *
  * @part root - The tabs' outer element, around the strip and the panels.
  * @part wrapper - The strip's outer element: the `wrapper:prepend` slot, the
@@ -240,10 +246,23 @@ export type BbTabsPtState = 'active' | 'disabled';
 export const BB_TABS_PT = {
 	parts: ['root', 'wrapper', 'list', 'item', 'indicator', 'panels', 'panel'],
 	states: ['disabled', 'active'],
+	// The `variant` is a state on the strip's parts (Q76.7), below the real ones.
+	variant: {
+		names: TABS_VARIANTS,
+		option: 'tabsVariants',
+		parts: ['wrapper', 'list', 'item', 'indicator'],
+	},
 } as const satisfies {
 	parts: readonly BbTabsPtPart[];
 	states: readonly BbTabsPtState[];
+	variant: {
+		names: readonly TabsVariantBuiltIn[];
+		option: string;
+		parts: readonly BbTabsStripPtPart[];
+	};
 };
+/** The strip's parts on `BbTabs`: the ones its `variant` styles. Spelled flat (T20). */
+export type BbTabsStripPtPart = 'wrapper' | 'list' | 'item' | 'indicator';
 
 /**
  * Passthrough parts of `BbTabsList` — the strip of a split layout. The same
@@ -269,9 +288,12 @@ export type BbTabsListPtState = BbTabsPtState;
 export const BB_TABS_LIST_PT = {
 	parts: ['root', 'list', 'item', 'indicator'],
 	states: ['disabled', 'active'],
+	// The strip's `variant` is a state on every part (Q76.7).
+	variant: { names: TABS_VARIANTS, option: 'tabsVariants' },
 } as const satisfies {
 	parts: readonly BbTabsListPtPart[];
 	states: readonly BbTabsListPtState[];
+	variant: { names: readonly TabsVariantBuiltIn[]; option: string };
 };
 /** Where each `BbTabsList` part reads a `BbTabs` global / scope entry. */
 export const BB_TABS_LIST_HOST_PARTS = {
@@ -313,21 +335,39 @@ export const BB_TABS_PANELS_HOST_PARTS = {
 export type BbTabsProps<K extends string = string> = {
 	[K2 in
 		| `pt:${BbTabsSurfacePtPart}`
-		| `pt:${BbTabsPtPart}:${BbTabsPtState}`]?: PtValue;
-} & {
-	// `item` also takes a per-item function, called with the tab descriptor.
-	// A literal function type, not `PtItemFn` (PASSTHROUGH.md T23).
-	'pt:item'?:
-		| PtValue
-		| ((
-				ctx: PtItemCtx<BbTabsItem<PtNoInfer<K>>, BbTabsPtState>
-		  ) => PtItemResult);
-	/**
-	 * Passthrough, object form: the same keys as the `pt:*` attributes
-	 * without the prefix. See the `pt:<part>` row.
-	 */
-	pt?: PtItemMap<BbTabsPtPart, 'item', BbTabsPtState, BbTabsItem<PtNoInfer<K>>>;
-} & BbTabsRootProps<K>;
+		| `pt:${BbTabsPtPart}:${BbTabsPtState}`
+		| `pt:${BbTabsStripPtPart}:${TabsVariantBuiltIn}`]?: PtValue;
+} & /* @vue-ignore */ PtVariantAttrs<
+	BbTabsStripPtPart,
+	keyof TabsVariantRegistry
+> & {
+		// `item` also takes a per-item function, called with the tab descriptor.
+		// A literal function type, not `PtItemFn` (PASSTHROUGH.md T23).
+		'pt:item'?:
+			| PtValue
+			| ((
+					ctx: PtItemCtx<
+						BbTabsItem<PtNoInfer<K>>,
+						BbTabsPtState,
+						TabsVariantBuiltIn | keyof TabsVariantRegistry
+					>
+			  ) => PtItemResult);
+		/**
+		 * Passthrough, object form: the same keys as the `pt:*` attributes
+		 * without the prefix. See the `pt:<part>` row.
+		 */
+		/* eslint-disable @typescript-eslint/consistent-indexed-object-style -- mapped, never Record (T23) */
+		pt?: PtItemMap<
+			BbTabsPtPart,
+			'item',
+			BbTabsPtState,
+			BbTabsItem<PtNoInfer<K>>,
+			TabsVariantBuiltIn | keyof TabsVariantRegistry
+		> & {
+			[K2 in `${BbTabsStripPtPart}:${TabsVariantBuiltIn | keyof TabsVariantRegistry}`]?: PtValue;
+		};
+		/* eslint-enable @typescript-eslint/consistent-indexed-object-style */
+	} & BbTabsRootProps<K>;
 
 /**
  * Props of `BbTabsRoot` — `BbTabsProps` without `pt`. The root owns the whole
@@ -443,25 +483,45 @@ export type BbTabsRootProps<K extends string = string> =
 export type BbTabsListProps = {
 	[K2 in
 		| `pt:${BbTabsListSurfacePtPart}`
-		| `pt:${BbTabsListPtPart}:${BbTabsListPtState}`]?: PtValue;
-} & {
-	// `item` also takes a per-item function, called with the tab descriptor.
-	// A literal function type, not `PtItemFn` (PASSTHROUGH.md T23).
-	'pt:item'?:
-		| PtValue
-		| ((ctx: PtItemCtx<BbTabsItem, BbTabsListPtState>) => PtItemResult);
-	/**
-	 * Passthrough, object form: the same keys as the `pt:*` attributes
-	 * without the prefix. See the `pt:<part>` row.
-	 */
-	pt?: PtItemMap<BbTabsListPtPart, 'item', BbTabsListPtState, BbTabsItem>;
-} & {
-	/**
-	 * Look of this strip — the `variant` of the owning `BbTabs` / `BbTabsRoot`
-	 * unless set here. See `BbTabsProps.variant` for the values.
-	 */
-	variant?: TabsVariantType;
-};
+		| `pt:${BbTabsListPtPart}:${BbTabsListPtState}`
+		| `pt:${BbTabsListPtPart}:${TabsVariantBuiltIn}`]?: PtValue;
+} & /* @vue-ignore */ PtVariantAttrs<
+	BbTabsListPtPart,
+	keyof TabsVariantRegistry
+> & {
+		// `item` also takes a per-item function, called with the tab descriptor.
+		// A literal function type, not `PtItemFn` (PASSTHROUGH.md T23).
+		'pt:item'?:
+			| PtValue
+			| ((
+					ctx: PtItemCtx<
+						BbTabsItem,
+						BbTabsListPtState,
+						TabsVariantBuiltIn | keyof TabsVariantRegistry
+					>
+			  ) => PtItemResult);
+		/**
+		 * Passthrough, object form: the same keys as the `pt:*` attributes
+		 * without the prefix. See the `pt:<part>` row.
+		 */
+		/* eslint-disable @typescript-eslint/consistent-indexed-object-style -- mapped, never Record (T23) */
+		pt?: PtItemMap<
+			BbTabsListPtPart,
+			'item',
+			BbTabsListPtState,
+			BbTabsItem,
+			TabsVariantBuiltIn | keyof TabsVariantRegistry
+		> & {
+			[K2 in `${BbTabsListPtPart}:${TabsVariantBuiltIn | keyof TabsVariantRegistry}`]?: PtValue;
+		};
+		/* eslint-enable @typescript-eslint/consistent-indexed-object-style */
+	} & {
+		/**
+		 * Look of this strip — the `variant` of the owning `BbTabs` / `BbTabsRoot`
+		 * unless set here. See `BbTabsProps.variant` for the values.
+		 */
+		variant?: TabsVariantType;
+	};
 
 /**
  * Props of `BbTabsPanels`: its `pt` only. Everything else — items,