bitboss-ui 3.0.0-beta.48 → 3.0.0-beta.49

package/dist/ai/manifest/types.advanced.json

@@ -8,20 +8,21 @@
 		{"name":"BbDateDirectiveValue","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDateDirectiveValue = Omit<Partial<BbDatePickerProps>, 'activator' | 'modelValue'> & { modelValue: string | string[] | null; 'onUpdate:modelValue'?: (value: string | string[] | null) => void; 'onUpdate:time'?: (value: string | string[] | null) => void; };"},
 		{"name":"BbDatePickerSegment","usage":"advanced","component":"BbDatePicker","usedBy":[],"definition":"type BbDatePickerSegment = BbCalendarSegment;","values":["start","end"]},
 		{"name":"BbDropdownContext","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownContext = { isReady: ComputedRef<boolean>; open: ComputedRef<boolean>; groups: ComputedRef<Record<string, BbDropdownContextGroup>>; };"},
-		{"name":"BbDropdownContextGroup","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownContextGroup = Omit<InternalGroup, 'items' | 'multiple' | 'selectable'> & { value: unknown; selectedOptions: BbDropdownContextOption[]; multiple: boolean; loading: boolean; selectable: boolean; };","fields":["text?: undefined","label?: string","onClick?: ((...args: any[]) => any)","itemText?: string | ((item: any) => string)","key?: string","max?: number","prepend:icon?: string","append:icon?: string","dependencies?: unknown[]","keyless?: true","meta?: any","variant?: keyof DropdownItemVariantRegistry","depsDebounceTime?: number","enforceCoherence?: boolean","filterBy?: string[]","group?: true","itemProps?: BbDropdownItemProps<any>","itemValue?: string | ((item: any) => any)","loadingText?: string","maxHeight?: string | number","clearable?: boolean","emptyText?: string","failedText?: string","prefill?: boolean | \"interaction\"","searchable?: boolean","searchPlaceholder?: string","stash?: boolean","hideLabel?: boolean","value: unknown","selectedOptions: BbDropdownContextOption[]","multiple: boolean","loading: boolean","selectable: boolean"]},
-		{"name":"BbDropdownContextOption","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownContextOption = { text?: string; description?: string; original?: unknown; value?: unknown; };"},
+		{"name":"BbDropdownContextGroup","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownContextGroup = Omit<InternalGroup, 'items' | 'multiple' | 'selectable' | 'value' | 'key'> & { value: unknown; selectedOptions: BbDropdownContextOption[]; multiple: boolean; loading: boolean; selectable: boolean; };","fields":["text?: undefined","label?: string","id?: string","onClick?: ((...args: any[]) => any)","itemText?: string | ((item: any) => string)","max?: number","prepend:icon?: string","append:icon?: string","dependencies?: unknown[]","meta?: any","variant?: keyof DropdownItemVariantRegistry","depsDebounceTime?: number","enforceCoherence?: boolean","filterBy?: string[]","group?: true","itemProps?: BbDropdownItemProps<any>","itemValue?: string | ((item: any) => any)","loadingText?: string","maxHeight?: string | number","clearable?: boolean","emptyText?: string","failedText?: string","prefill?: boolean | \"interaction\"","searchable?: boolean","searchPlaceholder?: string","stash?: boolean","hideLabel?: boolean","value: unknown","selectedOptions: BbDropdownContextOption[]","multiple: boolean","loading: boolean","selectable: boolean"]},
+		{"name":"BbDropdownContextOption","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownContextOption = { label?: string; description?: string; original?: unknown; value?: unknown; };"},
 		{"name":"BbDropdownDirectiveValue","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownDirectiveValue = BbDropdownItem[] | (Partial<Omit<BbDropdownProps, 'items'>> & { items: BbDropdownItem[]; });"},
 		{"name":"BbDropdownGroupItemsContext","usage":"advanced","component":null,"usedBy":[],"definition":"type BbDropdownGroupItemsContext<M = any> = BbItemsProviderContext<M> & { query?: string; reason: 'initial' | 'search' | 'dependencies'; };"},
-		{"name":"BbDropdownGroupModel","usage":"advanced","component":"BbDropdown","usedBy":[],"definition":"type BbDropdownGroupModel<T = any> = T[] | T | string[] | string | null;"},
-		{"name":"BbDropdownSlotGroup","usage":"advanced","component":"BbDropdown","usedBy":[],"definition":"type BbDropdownSlotGroup = { key?: string; label?: string; meta?: any; multiple: boolean; selectable: boolean; };"},
+		{"name":"BbDropdownGroupModel","usage":"advanced","component":"BbDropdown","usedBy":[],"definition":"type BbDropdownGroupModel<T = any> = T[] | T | null;"},
+		{"name":"BbDropdownSlotGroup","usage":"advanced","component":"BbDropdown","usedBy":[],"definition":"type BbDropdownSlotGroup = { id?: string; label?: string; meta?: any; multiple: boolean; selectable: boolean; };"},
 		{"name":"BbFormContextHandle","usage":"advanced","component":null,"usedBy":[],"definition":"type BbFormContextHandle = { isReady: ComputedRef<boolean>; valid: ComputedRef<boolean>; dirty: ComputedRef<boolean>; touched: ComputedRef<boolean>; pending: ComputedRef<boolean>; submitting: ComputedRef<boolean>; submitCount: ComputedRef<number>; values: ComputedRef<Record<string, unknown>>; errors: ComputedRef<Record<string, string[]>>; fields: ComputedRef<Record<string, BbFormFieldEntry>>; unmatchedErrors: ComputedRef<Record<string, string[]>>; submit: () => void; reset: () => void; snapshot: (values?: Record<string, unknown>) => void; validate: () => Promise<boolean>; setErrors: (errors: BbFormServerErrors, options?: BbFormSetErrorsOptions) => void; removeField: (path: string) => void; };"},
 		{"name":"BbFormContextState","usage":"advanced","component":null,"usedBy":[],"definition":"type BbFormContextState = { valid: boolean; dirty: boolean; touched: boolean; pending: boolean; submitting: boolean; submitCount: number; values: Record<string, unknown>; errors: Record<string, string[]>; fields: Record<string, BbFormFieldEntry>; unmatchedErrors: Record<string, string[]>; };"},
-		{"name":"BbFormFieldHandle","usage":"advanced","component":null,"usedBy":[],"definition":"type BbFormFieldHandle<T> = { value: WritableComputedRef<T | undefined>; errors: ComputedRef<string[]>; validate: () => Promise<boolean>; controlAttrs: ComputedRef<Record<string, string | undefined>>; errorAttrs: { id: string; }; };"},
+		{"name":"BbFormFieldHandle","usage":"advanced","component":null,"usedBy":[],"definition":"type BbFormFieldHandle<T> = { value: WritableComputedRef<T | undefined>; errors: ComputedRef<string[]>; validate: () => Promise<boolean>; controlAttrs: ComputedRef<Record<string, string | undefined>>; errorAttrs: { id: string; }; readonly: ComputedRef<boolean>; };"},
 		{"name":"BbFormFieldOptions","usage":"advanced","component":null,"usedBy":[],"definition":"type BbFormFieldOptions = { name: string; validationLabel?: string; rules?: unknown; };"},
 		{"name":"BbHoverCardDirectiveValue","usage":"advanced","component":null,"usedBy":[],"definition":"type BbHoverCardDirectiveValue = string | DirectivePortalComponent | (Partial<Omit<BbHoverCardProps, 'activator'>> & DirectivePortalOptions);"},
 		{"name":"BbIconSize","usage":"advanced","component":"BbIcon","usedBy":[],"definition":"type BbIconSize = BbDialogSizes;"},
 		{"name":"BbItemsProviderContext","usage":"advanced","component":null,"usedBy":[],"definition":"type BbItemsProviderContext<M = any> = { reason: BbItemsProviderReason; modelValue: M; signal: AbortSignal; };"},
 		{"name":"BbItemsProviderReason","usage":"advanced","component":null,"usedBy":[],"definition":"type BbItemsProviderReason = 'search' | 'initial' | 'dependencies' | 'model' | 'reopen' | 'pagination';","values":["search","initial","dependencies","model","reopen","pagination"]},
+		{"name":"BbNumberSimpleUnit","usage":"advanced","component":"BbNumberInput","usedBy":[],"definition":"type BbNumberSimpleUnit = 'acre' | 'bit' | 'byte' | 'celsius' | 'centimeter' | 'day' | 'degree' | 'fahrenheit' | 'fluid-ounce' | 'foot' | 'gallon' | 'gigabit' | 'gigabyte' | 'gram' | 'hectare' | 'hour' | 'inch' | 'kilobit' | 'kilobyte' | 'kilogram' | 'kilometer' | 'liter' | 'megabit' | 'megabyte' | 'meter' | 'microsecond' | 'mile' | 'mile-scandinavian' | 'milliliter' | 'millimeter' | 'millisecond' | 'minute' | 'month' | 'nanosecond' | 'ounce' | 'percent' | 'petabyte' | 'pound' | 'second' | 'stone' | 'terabit' | 'terabyte' | 'week' | 'yard' | 'year';","values":["month","year","day","acre","bit","byte","celsius","centimeter","degree","fahrenheit","fluid-ounce","foot","gallon","gigabit","gigabyte","gram","hectare","hour","inch","kilobit","kilobyte","kilogram","kilometer","liter","megabit","megabyte","meter","microsecond","mile","mile-scandinavian","milliliter","millimeter","millisecond","minute","nanosecond","ounce","percent","petabyte","pound","second","stone","terabit","terabyte","week","yard"]},
 		{"name":"BbPopoverDirectiveValue","usage":"advanced","component":null,"usedBy":[],"definition":"type BbPopoverDirectiveValue = string | DirectivePortalComponent | (Partial<Omit<BbPopoverProps, 'activator'>> & DirectivePortalOptions);"},
 		{"name":"BbSelectResolvedOption","usage":"advanced","component":"BbSelectPopover","usedBy":[],"definition":"type BbSelectResolvedOption<Item = any> = { item: Item; text: string; value: any; selected: boolean; disabled: boolean; };"},
 		{"name":"BbSpinnerSizes","usage":"advanced","component":"BbSpinner","usedBy":[],"definition":"type BbSpinnerSizes = BbIconSize;"},
@@ -34,7 +35,7 @@
 		{"name":"BbTooltipDirectiveValue","usage":"advanced","component":null,"usedBy":[],"definition":"type BbTooltipDirectiveValue = string | number | (Partial<BbTooltipProps> & { text: string; });"},
 		{"name":"BbTooltipVariant","usage":"advanced","component":"BbTooltip","usedBy":[],"definition":"type BbTooltipVariant = TooltipVariantType;","values":["default","destructive"],"extensibleVia":"TooltipVariantRegistry"},
 		{"name":"Breakpoint","usage":"advanced","component":null,"usedBy":[],"definition":"type Breakpoint = 'sm' | 'md' | 'lg' | 'xl' | '2xl';","values":["sm","md","lg","xl","2xl"]},
-		{"name":"BuiltinLocaleKey","usage":"advanced","component":null,"usedBy":[],"definition":"type BuiltinLocaleKey = (typeof BUILTIN_LOCALE_KEYS)[number];","values":["pt","cs","da","de","el","en","es","fi","fr","hu","it","ja","ko","nb","nl","pl","ro","ru","sv","tr","uk","zh-cn"]},
+		{"name":"BuiltinLocaleKey","usage":"advanced","component":null,"usedBy":[],"definition":"type BuiltinLocaleKey = keyof typeof LOCALE_TABLE;","values":["cs","da","de","de-CH","el","en","en-GB","es","es-MX","fi","fr","hu","it","ja","ko","nb","nl","pl","pt-BR","pt-PT","ro","ru","sv","tr","uk","zh-CN","zh-HK","zh-TW","de-AT","en-AU","en-CA","en-IE","fr-BE","fr-CA","fr-CH","it-CH","nl-BE","sv-FI"]},
 		{"name":"ButtonVariantRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface ButtonVariantRegistry { primary: true; outline: true; secondary: true; ghost: true; destructive: true; link: true; }","values":["primary","outline","secondary","ghost","destructive","link"],"extensibleVia":"ButtonVariantRegistry"},
 		{"name":"ConfirmButtonConfig","usage":"advanced","component":null,"usedBy":[],"definition":"type ConfirmButtonConfig = ActionButtonConfig;"},
 		{"name":"ConfirmVariantRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface ConfirmVariantRegistry { default: true; destructive: true; }","values":["default","destructive"],"extensibleVia":"ConfirmVariantRegistry"},
@@ -45,13 +46,13 @@
 		{"name":"DropdownGroupItemsGetter","usage":"advanced","component":"BbDropdown","usedBy":[],"definition":"type DropdownGroupItemsGetter = ((context: BbDropdownGroupItemsContext) => any[] | Promise<any[]>) | ((context: BbDropdownGroupItemsContext & { query: string; }) => any[] | Promise<any[]>);"},
 		{"name":"DropdownItemVariantRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface DropdownItemVariantRegistry { default: true; destructive: true; }","values":["default","destructive"],"extensibleVia":"DropdownItemVariantRegistry"},
 		{"name":"DropdownItemVariantType","usage":"advanced","component":null,"usedBy":[],"definition":"type DropdownItemVariantType = DropdownItemVariantFromRegistry;","values":["default","destructive"],"extensibleVia":"DropdownItemVariantRegistry"},
-		{"name":"DynamicConfig","usage":"advanced","component":null,"usedBy":[],"definition":"type DynamicConfig = Pick<EditableConfig, 'locale'>;","fields":["locale: \"pt\" | \"cs\" | \"da\" | \"de\" | \"el\" | \"en\" | \"es\" | \"fi\" | \"fr\" | \"hu\" | \"it\" | \"ja\" | \"ko\" | \"nb\" | \"nl\" | \"pl\" | \"ro\" | \"ru\" | \"sv\" | \"tr\" | \"uk\" | \"zh-cn\""]},
+		{"name":"DynamicConfig","usage":"advanced","component":null,"usedBy":[],"definition":"type DynamicConfig = Pick<EditableConfig, 'locale'>;","fields":["locale: BuiltinLocaleInput"]},
 		{"name":"EmptyStringControlRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface EmptyStringControlRegistry { }","extensibleVia":"EmptyStringControlRegistry"},
 		{"name":"IconType","usage":"advanced","component":null,"usedBy":[],"definition":"type IconType = string;"},
 		{"name":"IndicatorVariantType","usage":"advanced","component":null,"usedBy":[],"definition":"type IndicatorVariantType = IndicatorVariantFromRegistry;","values":["default","success","info","warning","destructive"],"extensibleVia":"IndicatorVariantRegistry"},
 		{"name":"InputVariantRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface InputVariantRegistry { outline: true; secondary: true; ghost: true; }","values":["outline","secondary","ghost"],"extensibleVia":"InputVariantRegistry"},
-		{"name":"Locale","usage":"advanced","component":null,"usedBy":[],"definition":"type Locale = EnJson extends { default: infer D; } ? D : EnJson;","fields":["common: { closeLabel: string; loadingText: string; emptyText: string; failedText: string; clearLabel: string; fieldLabel: string; }","colorInput: { dialogLabel: string; openPicker: string; openPickerSelected: string; paletteLabel: string; mainCanvasDesc: string; mainCanvasSelectedColor: string; hueCanvasDesc: string; hueCanvasSelectedHue: string; alphaSliderDesc: string; eyeDropper: string; }","datePicker: { monthLabel: string; yearLabel: string; previousMonthLabel: string; nextMonthLabel: string; previousYearLabel: string; nextYearLabel: string; calendarLabel: string; monthSelectorLabel: string; yearSelectorLabel: string; selectingMonth: string; selectingYear: string; selectedLabel: string; hoursLabel: string; minutesLabel: string; secondsLabel: string; selectEndDate: string; openPicker: string; }","datePickerInput: { dateFormat: string; dateFormatSingle: string; dateFormatRange: string; monthFormatSingle: string; monthFormatRange: string; yearFormatSingle: string; yearFormatRange: string; emptyRange: string; changeSelectionRange: string; changeSelection: string; emptySelection: string; dayField: string; monthField: string; yearField: string; hourField: string; minuteField: string; secondField: string; startFieldLabel: string; endFieldLabel: string; timeFormat: string; timeFormatSeconds: string; meridiemField: string; meridiemAm: string; meridiemPm: string; }","dialog: { closeLabel: string; }","dropdown: { back: string; }","dropdownButton: { open: string; close: string; }","dropzone: { selectFiles: string; serverFiles: string; }","rating: { singleStar: string; multipleStars: string; clearHint: string; }","select: { multipleMaxReached: string; searchLabel: string; searchToStart: string; triggerLabel: string; }","slider: { minimumThumb: string; maximumThumb: string; }","badge: { clearLabel: string; }","breadcrumbs: { label: string; openHiddenLabelCount: string; }","pagination: { label: string; previous: string; next: string; }","confirm: { ok: string; cancel: string; }","offCanvas: { closeLabel: string; }","table: { actionsText: string; selectAllLabel: string; selectText: string; select: string; selectableLegend: string; reorderInstructions: string; columnMoved: string; resizeInstructions: string; }","timePickerInput: { emptySelection: string; emptyRange: string; changeSelection: string; changeSelectionRange: string; openPicker: string; start: string; end: string; }","counter: { count: string; countOfMax: string; remaining: string; limitReached: string; }"]},
-		{"name":"LocaleKey","usage":"advanced","component":null,"usedBy":[],"definition":"type LocaleKey = RegistryKey<LocaleRegistry, BuiltinLocaleKey>;","extensibleVia":"LocaleRegistry"},
+		{"name":"Locale","usage":"advanced","component":null,"usedBy":[],"definition":"type Locale = EnJson extends { default: infer D; } ? D : EnJson;","fields":["common: { closeLabel: string; loadingText: string; emptyText: string; failedText: string; clearLabel: string; fieldLabel: string; }","colorInput: { dialogLabel: string; openPicker: string; openPickerSelected: string; mainCanvasDesc: string; mainCanvasSelectedColor: string; hueCanvasDesc: string; alphaSliderDesc: string; eyeDropper: string; }","datePicker: { monthLabel: string; yearLabel: string; previousMonthLabel: string; nextMonthLabel: string; previousYearLabel: string; nextYearLabel: string; calendarLabel: string; monthSelectorLabel: string; yearSelectorLabel: string; selectingMonth: string; selectingYear: string; selectedLabel: string; hoursLabel: string; minutesLabel: string; secondsLabel: string; selectEndDate: string; openPicker: string; }","datePickerInput: { dateFormat: string; dateFormatSingle: string; dateFormatRange: string; monthFormatSingle: string; monthFormatRange: string; yearFormatSingle: string; yearFormatRange: string; emptyRange: string; changeSelectionRange: string; changeSelection: string; emptySelection: string; dayField: string; monthField: string; yearField: string; hourField: string; minuteField: string; secondField: string; startFieldLabel: string; endFieldLabel: string; timeFormat: string; timeFormatSeconds: string; meridiemField: string; meridiemAm: string; meridiemPm: string; }","dialog: { closeLabel: string; }","dropdown: { back: string; }","dropdownButton: { open: string; }","dropzone: { selectFiles: string; serverFiles: string; }","rating: { singleStar: string; multipleStars: string; clearHint: string; }","select: { multipleMaxReached: string; searchLabel: string; searchToStart: string; triggerLabel: string; }","slider: { minimumThumb: string; maximumThumb: string; }","badge: { clearLabel: string; }","breadcrumbs: { label: string; openHiddenLabelCount: string; }","pagination: { label: string; previous: string; next: string; }","confirm: { ok: string; cancel: string; }","offCanvas: { closeLabel: string; }","table: { actionsText: string; selectAllLabel: string; selectText: string; select: string; selectableLegend: string; reorderInstructions: string; columnMoved: string; resizeInstructions: string; }","timePickerInput: { emptySelection: string; emptyRange: string; changeSelection: string; changeSelectionRange: string; openPicker: string; start: string; end: string; }","counter: { count: string; countOfMax: string; remaining: string; limitReached: string; }"]},
+		{"name":"LocaleKey","usage":"advanced","component":null,"usedBy":[],"definition":"type LocaleKey = RegistryKey<LocaleRegistry, BuiltinLocaleInput>;","extensibleVia":"LocaleRegistry"},
 		{"name":"LocaleRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface LocaleRegistry { }","extensibleVia":"LocaleRegistry"},
 		{"name":"PtScopeRegistry","usage":"advanced","component":null,"usedBy":[],"definition":"interface PtScopeRegistry { }","extensibleVia":"PtScopeRegistry"},
 		{"name":"SafeAreaSide","usage":"advanced","component":null,"usedBy":[],"definition":"type SafeAreaSide = 'top' | 'right' | 'bottom' | 'left';","values":["top","bottom","left","right"]},

package/dist/ai/manifest/types.api.json

@@ -2,18 +2,19 @@
 	"types": [
 		{"name":"AlertVariantRegistry","usage":"api","component":null,"usedBy":[{"component":"BbAlert","surface":"prop","name":"variant"}],"definition":"interface AlertVariantRegistry { outline: true; primary: true; destructive: true; warning: true; }","values":["outline","primary","destructive","warning"],"extensibleVia":"AlertVariantRegistry"},
 		{"name":"BadgeVariantType","usage":"api","component":null,"usedBy":[{"component":"BbBadge","surface":"prop","name":"variant"}],"definition":"type BadgeVariantType = BadgeVariantFromRegistry | 'none';","values":["primary","secondary","destructive","outline","none"],"extensibleVia":"BadgeVariantRegistry"},
-		{"name":"BbBreadcrumbsItem","usage":"api","component":"BbBreadcrumbs","usedBy":[{"component":"BbBreadcrumbs","surface":"prop","name":"items"}],"definition":"type BbBreadcrumbsItem = Omit<BbBaseButtonProps, 'block' | 'tag' | 'type'> & { onClick?: (event: MouseEvent) => void | Promise<void>; key?: string; 'prepend:icon'?: IconType; 'append:icon'?: IconType; };"},
+		{"name":"BbBreadcrumbsItem","usage":"api","component":"BbBreadcrumbs","usedBy":[{"component":"BbBreadcrumbs","surface":"prop","name":"items"}],"definition":"type BbBreadcrumbsItem = Omit<BbBaseButtonProps, 'block' | 'tag' | 'type' | 'text'> & { onClick?: (event: MouseEvent) => void | Promise<void>; label?: string; value?: string; key?: never; text?: never; 'prepend:icon'?: IconType; 'append:icon'?: IconType; };"},
 		{"name":"BbCalendarSegment","usage":"api","component":"BbCalendar","usedBy":[{"component":"BbCalendar","surface":"prop","name":"activeSegment"},{"component":"BbCalendar","surface":"event","name":"update:activeSegment"},{"component":"BbDatePicker","surface":"prop","name":"activeSegment"},{"component":"BbDatePicker","surface":"event","name":"update:activeSegment"}],"definition":"type BbCalendarSegment = 'start' | 'end';","values":["start","end"]},
 		{"name":"BbCheckboxGroupItemsContext","usage":"api","component":null,"usedBy":[{"component":"BbCheckboxGroup","surface":"prop","name":"items"},{"component":"BbSwitchGroup","surface":"prop","name":"items"}],"definition":"type BbCheckboxGroupItemsContext<M = any> = BbItemsProviderContext<M> & { reason: 'initial' | 'dependencies' | 'model'; };"},
 		{"name":"BbConfirmPortalSlotProps","usage":"api","component":"BbConfirm","usedBy":[{"component":"BbConfirmPortal","surface":"slot","name":"default"}],"definition":"type BbConfirmPortalSlotProps<P = any> = { props: P; yes: () => void; no: () => void; };"},
 		{"name":"BbDialogSizes","usage":"api","component":"BbDialog","usedBy":[{"component":"BbDialog","surface":"prop","name":"size"}],"definition":"type BbDialogSizes = { xs: number; sm: number; md: number; lg: number; xl: number; '2xl': number; };"},
-		{"name":"BbDropdownItem","usage":"api","component":"BbDropdown","usedBy":[{"component":"BbDropdown","surface":"prop","name":"items"},{"component":"BbDropdownButton","surface":"prop","name":"items"}],"definition":"type BbDropdownItem = InternalItem | InternalGroup | BbDropdownItem[];","members":{"InternalItem":["text: string","disabled?: boolean","href?: string","rel?: string","target?: string","activeClass?: string","ariaCurrentValue?: \"page\" | \"step\" | \"location\" | \"date\" | \"time\" | \"true\" | \"false\"","data?: object","exactActiveClass?: string","headers?: object","download?: string | boolean","external?: boolean","method?: \"get\" | \"post\" | \"put\" | \"patch\" | \"delete\"","onBefore?: (() => void)","onCancel?: (() => void)","onCancelToken?: ((cancelToken: unknown) => void)","onFinish?: (() => void)","only?: string[]","onProgress?: ((progress: { percentage: number | undefined; }) => void)","onStart?: (() => void)","onSuccess?: (() => void)","preserveScroll?: boolean | ((props: Record<string, unknown>) => boolean)","preserveState?: boolean | ((props: Record<string, unknown>) => boolean) | null","queryStringArrayFormat?: \"brackets\" | \"indices\"","replace?: boolean","to?: string | RouteLocationAsRelativeGeneric | RouteLocationAsPathGeneric","async?: boolean","cacheFor?: string | number | (string | number)[]","cacheTags?: string | string[]","component?: string","except?: string[]","instant?: boolean","onError?: ((errors: Record<string, string>) => void)","onPrefetched?: (() => void)","onPrefetching?: (() => void)","pageProps?: Record<string, unknown> | ((currentProps: Record<string, unknown>, sharedProps: Record<string, unknown>) => Record<string, unknown>) | null","prefetch?: string | boolean | string[]","preserveUrl?: boolean","viewTransition?: boolean","items?: BbDropdownItem[]","onClick?: ((...args: any[]) => any)","append:icon?: string","key?: string","keyless?: true","meta?: any","prepend:icon?: string","variant?: keyof DropdownItemVariantRegistry","description?: string","placeholder?: \"loading\" | \"empty\" | \"failed\"","error?: unknown","fetched?: true","slotKey?: string"],"InternalGroup":["append:icon?: string","key?: string","keyless?: true","meta?: any","onClick?: ((...args: any[]) => any)","prepend:icon?: string","variant?: keyof DropdownItemVariantRegistry","dependencies?: unknown[]","depsDebounceTime?: number","enforceCoherence?: boolean","filterBy?: string[]","group?: true","items: any[] | DropdownGroupItemsGetter | (InternalItem | InternalItem[])[]","itemText?: string | ((item: any) => string)","itemProps?: BbDropdownItemProps<any>","itemValue?: string | ((item: any) => any)","loadingText?: string","max?: number","maxHeight?: string | number","multiple?: boolean","clearable?: boolean","emptyText?: string","failedText?: string","prefill?: boolean | \"interaction\"","searchable?: boolean","searchPlaceholder?: string","selectable?: boolean | ((item: any) => boolean)","stash?: boolean","label?: string","hideLabel?: boolean"]}},
-		{"name":"BbDropdownItemSlotProps","usage":"api","component":"BbDropdown","usedBy":[{"component":"BbDropdown","surface":"slot","name":"item:append"},{"component":"BbDropdown","surface":"slot","name":"item:prepend"},{"component":"BbDropdown","surface":"slot","name":"<key>"},{"component":"BbDropdown","surface":"slot","name":"<key>:prepend"},{"component":"BbDropdown","surface":"slot","name":"<key>:append"},{"component":"BbDropdown","surface":"slot","name":"<groupKey>:item"},{"component":"BbDropdown","surface":"slot","name":"<groupKey>:item:prepend"},{"component":"BbDropdown","surface":"slot","name":"<groupKey>:item:append"},{"component":"BbDropdown","surface":"slot","name":"<groupKey>"},{"component":"BbDropdown","surface":"slot","name":"<groupKey>:prepend"},{"component":"BbDropdown","surface":"slot","name":"<groupKey>:append"},{"component":"BbDropdownButton","surface":"slot","name":"<key>"},{"component":"BbDropdownButton","surface":"slot","name":"<key>:prepend"},{"component":"BbDropdownButton","surface":"slot","name":"<key>:append"},{"component":"BbDropdownButton","surface":"slot","name":"<groupKey>:item"},{"component":"BbDropdownButton","surface":"slot","name":"<groupKey>:item:prepend"},{"component":"BbDropdownButton","surface":"slot","name":"<groupKey>:item:append"},{"component":"BbDropdownButton","surface":"slot","name":"<groupKey>"},{"component":"BbDropdownButton","surface":"slot","name":"<groupKey>:prepend"},{"component":"BbDropdownButton","surface":"slot","name":"<groupKey>:append"}],"definition":"type BbDropdownItemSlotProps = { description?: InternalItem['description']; disabled?: InternalItem['disabled']; group: BbDropdownSlotGroup; groupTitle: boolean; level: number; index: number; item: InternalItem; loading: boolean; open: boolean; placement: BbDropdownProps['placement']; selected: boolean; text: InternalItem['text']; };","fields":["description?: string","disabled?: boolean","group: BbDropdownSlotGroup","groupTitle: boolean","level: number","index: number","item: InternalItem","loading: boolean","open: boolean","placement: Placement | \"cursor\"","selected: boolean","text: string"]},
+		{"name":"BbDropdownItem","usage":"api","component":"BbDropdown","usedBy":[{"component":"BbDropdown","surface":"prop","name":"items"},{"component":"BbDropdownButton","surface":"prop","name":"items"}],"definition":"type BbDropdownItem = InternalItem | InternalGroup | BbDropdownItem[];","members":{"InternalItem":["disabled?: boolean","href?: string","rel?: string","target?: string","activeClass?: string","ariaCurrentValue?: \"page\" | \"step\" | \"location\" | \"date\" | \"time\" | \"true\" | \"false\"","data?: object","exactActiveClass?: string","headers?: object","download?: string | boolean","external?: boolean","method?: \"get\" | \"post\" | \"put\" | \"patch\" | \"delete\"","onBefore?: (() => void)","onCancel?: (() => void)","onCancelToken?: ((cancelToken: unknown) => void)","onFinish?: (() => void)","only?: string[]","onProgress?: ((progress: { percentage: number | undefined; }) => void)","onStart?: (() => void)","onSuccess?: (() => void)","preserveScroll?: boolean | ((props: Record<string, unknown>) => boolean)","preserveState?: boolean | ((props: Record<string, unknown>) => boolean) | null","queryStringArrayFormat?: \"brackets\" | \"indices\"","replace?: boolean","to?: string | RouteLocationAsRelativeGeneric | RouteLocationAsPathGeneric","async?: boolean","cacheFor?: string | number | (string | number)[]","cacheTags?: string | string[]","component?: string","except?: string[]","instant?: boolean","onError?: ((errors: Record<string, string>) => void)","onPrefetched?: (() => void)","onPrefetching?: (() => void)","pageProps?: Record<string, unknown> | ((currentProps: Record<string, unknown>, sharedProps: Record<string, unknown>) => Record<string, unknown>) | null","prefetch?: string | boolean | string[]","preserveUrl?: boolean","viewTransition?: boolean","items?: BbDropdownItem[]","onClick?: ((...args: any[]) => any)","append:icon?: string","meta?: any","prepend:icon?: string","variant?: keyof DropdownItemVariantRegistry","label: string","value?: unknown","keyless?: true","rowKey?: string","domKey?: string","description?: string","placeholder?: \"loading\" | \"empty\" | \"failed\"","error?: unknown","fetched?: true","slotKey?: string"],"InternalGroup":["append:icon?: string","meta?: any","onClick?: ((...args: any[]) => any)","prepend:icon?: string","variant?: keyof DropdownItemVariantRegistry","id?: string","dependencies?: unknown[]","depsDebounceTime?: number","enforceCoherence?: boolean","filterBy?: string[]","group?: true","items: any[] | DropdownGroupItemsGetter | (InternalItem | InternalItem[])[]","itemText?: string | ((item: any) => string)","itemProps?: BbDropdownItemProps<any>","itemValue?: string | ((item: any) => any)","loadingText?: string","max?: number","maxHeight?: string | number","multiple?: boolean","clearable?: boolean","emptyText?: string","failedText?: string","prefill?: boolean | \"interaction\"","searchable?: boolean","searchPlaceholder?: string","selectable?: boolean | ((item: any) => boolean)","stash?: boolean","label?: string","hideLabel?: boolean"]}},
+		{"name":"BbDropdownItemSlotProps","usage":"api","component":"BbDropdown","usedBy":[{"component":"BbDropdown","surface":"slot","name":"item:append"},{"component":"BbDropdown","surface":"slot","name":"item:prepend"},{"component":"BbDropdown","surface":"slot","name":"<value>"},{"component":"BbDropdown","surface":"slot","name":"<value>:prepend"},{"component":"BbDropdown","surface":"slot","name":"<value>:append"},{"component":"BbDropdown","surface":"slot","name":"<groupId>:item"},{"component":"BbDropdown","surface":"slot","name":"<groupId>:item:prepend"},{"component":"BbDropdown","surface":"slot","name":"<groupId>:item:append"},{"component":"BbDropdown","surface":"slot","name":"<groupId>"},{"component":"BbDropdown","surface":"slot","name":"<groupId>:prepend"},{"component":"BbDropdown","surface":"slot","name":"<groupId>:append"},{"component":"BbDropdownButton","surface":"slot","name":"<value>"},{"component":"BbDropdownButton","surface":"slot","name":"<value>:prepend"},{"component":"BbDropdownButton","surface":"slot","name":"<value>:append"},{"component":"BbDropdownButton","surface":"slot","name":"<groupId>:item"},{"component":"BbDropdownButton","surface":"slot","name":"<groupId>:item:prepend"},{"component":"BbDropdownButton","surface":"slot","name":"<groupId>:item:append"},{"component":"BbDropdownButton","surface":"slot","name":"<groupId>"},{"component":"BbDropdownButton","surface":"slot","name":"<groupId>:prepend"},{"component":"BbDropdownButton","surface":"slot","name":"<groupId>:append"}],"definition":"type BbDropdownItemSlotProps = { description?: InternalItem['description']; disabled?: InternalItem['disabled']; group: BbDropdownSlotGroup; groupTitle: boolean; level: number; index: number; item: InternalItem; loading: boolean; open: boolean; placement: BbDropdownProps['placement']; selected: boolean; label: InternalItem['label']; };","fields":["description?: string","disabled?: boolean","group: BbDropdownSlotGroup","groupTitle: boolean","level: number","index: number","item: InternalItem","loading: boolean","open: boolean","placement: Placement | \"cursor\"","selected: boolean","label: string"]},
 		{"name":"BbFormFieldEntry","usage":"api","component":null,"usedBy":[{"component":"BbForm","surface":"slot","name":"default"}],"definition":"type BbFormFieldEntry = { mounted: boolean; label: string | undefined; validationLabel: string | undefined; errors: string[]; dirty: boolean; touched: boolean; };"},
 		{"name":"BbFormInvalidPayload","usage":"api","component":null,"usedBy":[{"component":"BbForm","surface":"event","name":"invalid"}],"definition":"type BbFormInvalidPayload = { errors: Record<string, string[]>; values: Record<string, unknown>; };"},
 		{"name":"BbFormServerErrors","usage":"api","component":null,"usedBy":[{"component":"BbForm","surface":"slot","name":"default"}],"definition":"type BbFormServerErrors = Record<string, string | readonly string[] | null | undefined>;"},
 		{"name":"BbFormSetErrorsOptions","usage":"api","component":null,"usedBy":[{"component":"BbForm","surface":"slot","name":"default"}],"definition":"type BbFormSetErrorsOptions = { focus?: boolean; };"},
 		{"name":"BbHoverCardPortalSlotProps","usage":"api","component":"BbHoverCard","usedBy":[{"component":"BbHoverCardPortal","surface":"slot","name":"default"}],"definition":"type BbHoverCardPortalSlotProps<P = any> = { props: P; close: () => void; };"},
+		{"name":"BbNumberUnit","usage":"api","component":"BbNumberInput","usedBy":[{"component":"BbNumberInput","surface":"prop","name":"unit"}],"definition":"type BbNumberUnit = BbNumberSimpleUnit | `${string}-per-${string}`;"},
 		{"name":"BbOffCanvasProps","usage":"api","component":"BbOffCanvas","usedBy":[{"component":"BbColorInput","surface":"prop","name":"offCanvasProps"},{"component":"BbColorPalette","surface":"prop","name":"offCanvasProps"},{"component":"BbDatePicker","surface":"prop","name":"offCanvasProps"},{"component":"BbDatePickerInput","surface":"prop","name":"offCanvasProps"},{"component":"BbDialog","surface":"prop","name":"offCanvasProps"},{"component":"BbDropdown","surface":"prop","name":"offCanvasProps"},{"component":"BbDropdownButton","surface":"prop","name":"offCanvasProps"},{"component":"BbPopover","surface":"prop","name":"offCanvasProps"},{"component":"BbSelect","surface":"prop","name":"offCanvasProps"},{"component":"BbSelectPopover","surface":"prop","name":"offCanvasProps"},{"component":"BbTimePicker","surface":"prop","name":"offCanvasProps"},{"component":"BbTimePickerInput","surface":"prop","name":"offCanvasProps"}],"definition":"type BbOffCanvasProps = { [K in `pt:${BbOffCanvasPtPart}` | `pt:${BbOffCanvasPtPart}:${BbOffCanvasPtState}`]?: PtValue; } & { pt?: PtMap<BbOffCanvasPtPart, BbOffCanvasPtState>; description?: string; disabled?: boolean; eager?: boolean; focusTarget?: string; fullscreen?: boolean | 'mobile'; draggable?: boolean; stack?: string; stackGap?: number; persistent?: boolean; hideClose?: boolean; size?: Responsive<OffCanvasSize>; title?: string; transitionDuration?: number; side?: 'left' | 'top' | 'right' | 'bottom'; };","fields":["description?: string","disabled?: boolean","eager?: boolean","focusTarget?: string","fullscreen?: boolean | \"mobile\"","draggable?: boolean","stack?: string","stackGap?: number","persistent?: boolean","hideClose?: boolean","size?: Responsive<OffCanvasSize>","title?: string","transitionDuration?: number","side?: \"top\" | \"bottom\" | \"left\" | \"right\""]},
 		{"name":"BbOptionGroupItemProps","usage":"api","component":null,"usedBy":[{"component":"BbCheckboxGroup","surface":"prop","name":"itemProps"},{"component":"BbRadioGroup","surface":"prop","name":"itemProps"},{"component":"BbSwitchGroup","surface":"prop","name":"itemProps"}],"definition":"type BbOptionGroupItemProps<T = any> = ItemProps<T, OptionGroupItemFields>;","fields":["description?: ItemAccessor<T, string | null | undefined>"]},
 		{"name":"BbPopoverPortalSlotProps","usage":"api","component":"BbPopover","usedBy":[{"component":"BbPopoverPortal","surface":"slot","name":"default"}],"definition":"type BbPopoverPortalSlotProps<P = any> = { props: P; close: () => void; };"},
@@ -27,7 +28,7 @@
 		{"name":"BbTableItemsContext","usage":"api","component":null,"usedBy":[{"component":"BbTable","surface":"prop","name":"items"}],"definition":"type BbTableItemsContext<M = any> = BbItemsProviderContext<M> & { reason: 'initial' | 'dependencies' | 'pagination'; };"},
 		{"name":"BbTableRowClasses","usage":"api","component":"BbTable","usedBy":[{"component":"BbTable","surface":"prop","name":"rowClass"}],"definition":"type BbTableRowClasses<Item = any> = Classes | ((item: Item) => Classes | undefined);"},
 		{"name":"BbTableSortEntry","usage":"api","component":"BbTable","usedBy":[{"component":"BbTable","surface":"prop","name":"sort"},{"component":"BbTable","surface":"event","name":"update:sort"}],"definition":"type BbTableSortEntry = [ key: string, direction: 'asc' | 'desc' ];"},
-		{"name":"BbTabsItem","usage":"api","component":"BbTabs","usedBy":[{"component":"BbTabs","surface":"prop","name":"items"},{"component":"BbTabs","surface":"prop","name":"pt"},{"component":"BbTabs","surface":"prop","name":"pt:item"},{"component":"BbTabsList","surface":"prop","name":"pt"},{"component":"BbTabsList","surface":"prop","name":"pt:item"},{"component":"BbTabsRoot","surface":"prop","name":"items"}],"definition":"type BbTabsItem<K extends string = string> = BbTabsInertiaOptions & { disabled?: boolean; eager?: boolean; href?: string; key: K; label?: string; server?: boolean; };"},
+		{"name":"BbTabsItem","usage":"api","component":"BbTabs","usedBy":[{"component":"BbTabs","surface":"prop","name":"items"},{"component":"BbTabs","surface":"prop","name":"pt"},{"component":"BbTabs","surface":"prop","name":"pt:item"},{"component":"BbTabsList","surface":"prop","name":"pt"},{"component":"BbTabsList","surface":"prop","name":"pt:item"},{"component":"BbTabsRoot","surface":"prop","name":"items"}],"definition":"type BbTabsItem<K extends string = string> = BbTabsInertiaOptions & { disabled?: boolean; eager?: boolean; href?: string; value: K; key?: never; label?: string; server?: boolean; };"},
 		{"name":"BbTimePickerSegment","usage":"api","component":"BbTimePicker","usedBy":[{"component":"BbTimePicker","surface":"prop","name":"activeSegment"},{"component":"BbTimePicker","surface":"event","name":"update:activeSegment"}],"definition":"type BbTimePickerSegment = 'start' | 'end';","values":["start","end"]},
 		{"name":"BbToastPosition","usage":"api","component":"BbToast","usedBy":[{"component":"BbToast","surface":"prop","name":"position"}],"definition":"type BbToastPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';","values":["top-left","top-center","top-right","bottom-left","bottom-center","bottom-right"]},
 		{"name":"BbTreeItem","usage":"api","component":"BbTree","usedBy":[{"component":"BbTree","surface":"prop","name":"items"}],"definition":"type BbTreeItem<Meta = any> = { meta: Meta; children?: Array<BbTreeItem<Meta>>; expanded?: boolean; expandable?: BbTreeExpandable<Meta>; };","fields":["meta: Meta","children?: BbTreeItem<Meta>[]","expanded?: boolean","expandable?: BbTreeExpandable<Meta>"]},

package/dist/ai/recipes/inertia/approvals-inbox.md

@@ -35,9 +35,8 @@ Sibling recipes: [Vue](../vue/approvals-inbox.md) ·
   the peek stack, the close semantics and the sidebar's out-of-flow
   behaviour are all load-bearing here.
 - `<BbConfirm />` and `<BbToast />` mounted once in the `createInertiaApp` render root — never in a page.
-- From the [Inertia Helpers](../../guides/inertia-helpers.md) toolkit:
-  `useTableContext`, `useQueryObject`, `useResourceContext`, `useProp`,
-  `useQuery`.
+- From the [Inertia Helpers](../../guides/inertia-helpers.md) toolkit, installed with
+  `npx bitboss-ui add useProp useQuery useQueryObject useResourceContext useTableContext`.
 - Controller: `Inertia::render('Approvals/Index', ['expenses' =>
 ExpensePaginator::make(...), 'tabCounts' => [...]])` — `expenses` is a
   standard Laravel paginator (`PaginatedResponse<Expense>`) and `tabCounts`
@@ -188,10 +187,10 @@ import {
 import {
 	useTableContext,
 	type TableContext,
-} from '@/composables/useTableContext';
-import { useQueryObject } from '@/composables/useQueryObject';
-import { useProp } from '@/composables/useProp';
-import { useQuery } from '@/composables/useQuery';
+} from '@/composables/inertia-helpers/useTableContext';
+import { useQueryObject } from '@/composables/inertia-helpers/useQueryObject';
+import { useProp } from '@/composables/inertia-helpers/useProp';
+import { useQuery } from '@/composables/inertia-helpers/useQuery';
 import type { Expense, ExpenseCategory, ExpenseStatus } from '@/types';
 
 /** What the stacked sidebar can show. Clicking a name pushes one of these. */
@@ -578,9 +577,9 @@ export function useApprovalsInbox(): ApprovalsInboxContext {
 				<BbBreadcrumbs
 					class="min-w-0 flex-auto"
 					:items="[
-						{ key: 'dashboard', text: 'Dashboard', href: '/dashboard' },
-						{ key: 'finance', text: 'Finance', href: '/finance' },
-						{ key: 'approvals', text: 'Approvals' },
+						{ value: 'dashboard', label: 'Dashboard', href: '/dashboard' },
+						{ value: 'finance', label: 'Finance', href: '/finance' },
+						{ value: 'approvals', label: 'Approvals' },
 					]"
 				/>
 				<BbTextInput
@@ -614,28 +613,28 @@ export function useApprovalsInbox(): ApprovalsInboxContext {
 					compact
 					:items="[
 						{
-							key: 'needsApproval',
+							value: 'needsApproval',
 							label: `Needs approval · ${ctx.tabCounts.value.needsApproval}`,
 							href: tabHref('needsApproval'),
 							server: true,
 							only: ['expenses', 'tabCounts'],
 						},
 						{
-							key: 'approved',
+							value: 'approved',
 							label: `Approved · ${ctx.tabCounts.value.approved}`,
 							href: tabHref('approved'),
 							server: true,
 							only: ['expenses', 'tabCounts'],
 						},
 						{
-							key: 'rejected',
+							value: 'rejected',
 							label: `Rejected · ${ctx.tabCounts.value.rejected}`,
 							href: tabHref('rejected'),
 							server: true,
 							only: ['expenses', 'tabCounts'],
 						},
 						{
-							key: 'all',
+							value: 'all',
 							label: `All · ${ctx.tabCounts.value.all}`,
 							href: tabHref('all'),
 							server: true,
@@ -762,7 +761,7 @@ import {
 } from 'bitboss-ui';
 import qs from 'query-string';
 import PageShell from '@/components/layout/PageShell.vue';
-import { useQuery } from '@/composables/useQuery';
+import { useQuery } from '@/composables/inertia-helpers/useQuery';
 import {
 	type ApprovalsTab,
 	CATEGORY_LABEL,
@@ -856,7 +855,6 @@ const rowClass = (item: Expense) =>
 		<BbSelectPopover
 			v-model="ctx.filters.categories"
 			item-text="text"
-			item-value="value"
 			:items="CATEGORY_OPTIONS"
 			multiple
 		>
@@ -1483,7 +1481,7 @@ const ctx = useApprovalsInbox();
 <script setup lang="ts">
 import { computed, watch } from 'vue';
 import { BbBadge, BbBaseButton, BbButton, BbIcon, BbSpinner } from 'bitboss-ui';
-import { useResourceContext } from '@/composables/useResourceContext';
+import { useResourceContext } from '@/composables/inertia-helpers/useResourceContext';
 import { CATEGORY_LABEL, STATUS_LABEL, useApprovalsInbox } from './context';
 import type { ExpenseDetail } from '@/types';
 
@@ -1606,7 +1604,7 @@ import {
 	BbButton,
 	BbSpinner,
 } from 'bitboss-ui';
-import { useResourceContext } from '@/composables/useResourceContext';
+import { useResourceContext } from '@/composables/inertia-helpers/useResourceContext';
 import { STATUS_LABEL, useApprovalsInbox } from './context';
 import type { SubmitterDetail } from '@/types';
 

package/dist/ai/recipes/inertia/inline-edit-workspace.md

@@ -46,9 +46,9 @@ recipe assumes) ·
 label state) · [Page Shell](../../guides/page-shell.md) ·
 [Floating Bottom Panel](../../guides/floating-bottom-panel.md).
 
-From the [Inertia Helpers](../../guides/inertia-helpers.md) toolkit:
-`useTableContext`, `useQueryObject`, `useQuery`, `useProp`,
-`useResourceContext`. `<BbConfirm />` and `<BbToast />` mounted once in the
+From the [Inertia Helpers](../../guides/inertia-helpers.md) toolkit, installed
+with `npx bitboss-ui add useProp useQuery useQueryObject useResourceContext useTableContext`.
+`<BbConfirm />` and `<BbToast />` mounted once in the
 `createInertiaApp` render root — never in a page.
 
 Controller: `Inertia::render('BacklogWorkspace/Index', ['issues' => …, 'tabCounts'
@@ -267,10 +267,10 @@ import {
 import {
 	useTableContext,
 	type TableContext,
-} from '@/composables/useTableContext';
-import { useQueryObject } from '@/composables/useQueryObject';
-import { useQuery } from '@/composables/useQuery';
-import { useProp } from '@/composables/useProp';
+} from '@/composables/inertia-helpers/useTableContext';
+import { useQueryObject } from '@/composables/inertia-helpers/useQueryObject';
+import { useQuery } from '@/composables/inertia-helpers/useQuery';
+import { useProp } from '@/composables/inertia-helpers/useProp';
 import type { Issue, IssuePriority, IssueStatus, Member } from '@/types';
 
 /**
@@ -786,9 +786,9 @@ export function useBacklogWorkspace(): BacklogWorkspaceContext {
 				<BbBreadcrumbs
 					class="min-w-0 flex-auto"
 					:items="[
-						{ key: 'product', text: 'Product', href: '/product' },
-						{ key: 'sprints', text: 'Sprints', href: '/sprints' },
-						{ key: 'sprint-24', text: 'Sprint 24' },
+						{ value: 'product', label: 'Product', href: '/product' },
+						{ value: 'sprints', label: 'Sprints', href: '/sprints' },
+						{ value: 'sprint-24', label: 'Sprint 24' },
 					]"
 				/>
 				<div class="flex shrink-0 items-center gap-2">
@@ -832,21 +832,21 @@ export function useBacklogWorkspace(): BacklogWorkspaceContext {
 				compact
 				:items="[
 					{
-						key: 'backlog',
+						value: 'backlog',
 						label: `Backlog · ${ctx.tabCounts.value.backlog}`,
 						href: tabHref('backlog'),
 						server: true,
 						only: ['issues', 'tabCounts'],
 					},
 					{
-						key: 'current',
+						value: 'current',
 						label: `Current sprint · ${ctx.tabCounts.value.current}`,
 						href: tabHref('current'),
 						server: true,
 						only: ['issues', 'tabCounts'],
 					},
 					{
-						key: 'done',
+						value: 'done',
 						label: `Done · ${ctx.tabCounts.value.done}`,
 						href: tabHref('done'),
 						server: true,
@@ -999,7 +999,7 @@ import {
 } from 'bitboss-ui';
 import qs from 'query-string';
 import PageShell from '@/components/layout/PageShell.vue';
-import { useQuery } from '@/composables/useQuery';
+import { useQuery } from '@/composables/inertia-helpers/useQuery';
 import { provideBacklogWorkspace, type SprintTab } from './context';
 import AssigneeCell from './AssigneeCell.vue';
 import EditableTitleCell from './EditableTitleCell.vue';
@@ -1068,8 +1068,6 @@ const rowClass = (item: Issue) =>
 			<BbSelectPopover
 				v-model="ctx.filters.status"
 				disable-writing
-				item-text="label"
-				item-value="value"
 				:items="STATUS_OPTIONS"
 				multiple
 			>
@@ -1102,8 +1100,6 @@ const rowClass = (item: Issue) =>
 			<BbSelectPopover
 				v-model="ctx.filters.priority"
 				disable-writing
-				item-text="label"
-				item-value="value"
 				:items="PRIORITY_OPTIONS"
 				multiple
 			>
@@ -1269,8 +1265,6 @@ const commit = (event: Event) => {
 	<BbSelectPopover
 		compact
 		disable-writing
-		item-text="label"
-		item-value="value"
 		:items="STATUS_OPTIONS"
 		:model-value="status"
 		width="180px"
@@ -1347,8 +1341,6 @@ const label = computed(
 	<BbSelectPopover
 		compact
 		disable-writing
-		item-text="label"
-		item-value="value"
 		:items="PRIORITY_OPTIONS"
 		:model-value="priority"
 		width="160px"
@@ -1413,8 +1405,8 @@ const label = computed(
 <template>
 	<!-- Provider-backed people picker. The provider is the ONE shared
 	`searchMembers` — lazy per instance, so a row nobody opens never resolves.
-	The whole member is the value (no item-value), matching how the row
-	stores it. -->
+	The whole member is the value (no item-value, and a Member has no `value`
+	of its own), matching how the row stores it. -->
 	<BbSelectPopover
 		compact
 		item-text="name"
@@ -1480,20 +1472,20 @@ const assignee = computed(() => ctx.valueOf(props.issue, 'assignee'));
 		:boundary="boundary"
 		:items="[
 			{
-				key: 'duplicate',
-				text: 'Duplicate',
+				value: 'duplicate',
+				label: 'Duplicate',
 				'prepend:icon': 'lucide:copy',
 				onClick: () => ctx.duplicateIssue(issue),
 			},
 			{
-				key: 'next-sprint',
-				text: 'Move to next sprint',
+				value: 'next-sprint',
+				label: 'Move to next sprint',
 				'prepend:icon': 'lucide:arrow-right',
 				onClick: () => ctx.moveToNextSprint(issue),
 			},
 			{
-				key: 'delete',
-				text: 'Delete',
+				value: 'delete',
+				label: 'Delete',
 				'prepend:icon': 'lucide:trash-2',
 				variant: 'destructive',
 				onClick: () => ctx.deleteIssue(issue),
@@ -1538,8 +1530,6 @@ const ctx = useBacklogWorkspace();
 		menu clears the bar. -->
 		<BbSelectPopover
 			disable-writing
-			item-text="label"
-			item-value="value"
 			:items="STATUS_OPTIONS"
 			:model-value="null"
 			:offset="8"
@@ -1722,7 +1712,7 @@ const ctx = useBacklogWorkspace();
 <script setup lang="ts">
 import { watch } from 'vue';
 import { BbButton, BbIcon, BbSpinner } from 'bitboss-ui';
-import { useResourceContext } from '@/composables/useResourceContext';
+import { useResourceContext } from '@/composables/inertia-helpers/useResourceContext';
 import AssigneeCell from './AssigneeCell.vue';
 import PriorityCell from './PriorityCell.vue';
 import StatusCell from './StatusCell.vue';

package/dist/ai/recipes/inertia/layout-scaffold.md

@@ -587,36 +587,36 @@ const warehouseId = ref('denver');
 
 const accountMenuItems: BbDropdownItem[] = [
 	{
-		key: 'theme',
-		text: 'Theme',
+		value: 'theme',
+		label: 'Theme',
 		'prepend:icon': 'lucide:sun-moon',
 		// A submenu opener (`items`) whose own `items` is one selectable
 		// group — `selectable: true` gives single-choice radio semantics and a
 		// check on the picked row, with no bordered field anywhere.
 		items: [
 			{
-				key: 'theme-opts',
+				id: 'theme-opts',
 				selectable: true,
 				items: [
-					{ key: 'system', text: 'System' },
-					{ key: 'light', text: 'Light' },
-					{ key: 'dark', text: 'Dark' },
+					{ value: 'system', label: 'System' },
+					{ value: 'light', label: 'Light' },
+					{ value: 'dark', label: 'Dark' },
 				],
 			},
 		],
 	},
 	{
-		key: 'warehouse',
-		text: 'Warehouse',
+		value: 'warehouse',
+		label: 'Warehouse',
 		'prepend:icon': 'lucide:warehouse',
 		items: [
 			{
-				key: 'warehouse-opts',
+				id: 'warehouse-opts',
 				selectable: true,
 				items: [
-					{ key: 'denver', text: 'Denver DC' },
-					{ key: 'reno', text: 'Reno DC' },
-					{ key: 'columbus', text: 'Columbus DC' },
+					{ value: 'denver', label: 'Denver DC' },
+					{ value: 'reno', label: 'Reno DC' },
+					{ value: 'columbus', label: 'Columbus DC' },
 				],
 			},
 		],
@@ -624,14 +624,14 @@ const accountMenuItems: BbDropdownItem[] = [
 	// A trailing separator section (a nested array) for plain navigation rows.
 	[
 		{
-			key: 'settings',
-			text: 'Settings',
+			value: 'settings',
+			label: 'Settings',
 			'prepend:icon': 'lucide:settings',
 			href: '/settings',
 		},
 		{
-			key: 'signout',
-			text: 'Sign out',
+			value: 'signout',
+			label: 'Sign out',
 			'prepend:icon': 'lucide:log-out',
 			href: '/logout',
 			method: 'post',

package/dist/ai/recipes/inertia/onboarding.md

@@ -28,8 +28,8 @@ Sibling recipes: [Vue](../vue/onboarding.md) · [Nuxt](../nuxt/onboarding.md).
   the peek stack, the close semantics and the sidebar's out-of-flow
   behaviour are all load-bearing here.
 - `<BbConfirm />` and `<BbToast />` mounted once in the `createInertiaApp` render root — never in a page.
-- From the [Inertia Helpers](../../guides/inertia-helpers.md) toolkit:
-  `useProp`, `usePromiseForm`.
+- From the [Inertia Helpers](../../guides/inertia-helpers.md) toolkit, installed with
+  `npx bitboss-ui add usePromiseForm useProp`.
 - Controller: `Inertia::render('Onboarding/Index', ['onboarding' => [
 'steps' => [...], 'connectedIntegrations' => [...], 'workspace' => ...,
 'invites' => [...], 'firstProject' => ..., 'importedCustomers' => ...,
@@ -156,8 +156,8 @@ import {
 	usePageShellContext,
 	type PageShellContext,
 } from '@/components/layout/usePageShellContext';
-import { useProp } from '@/composables/useProp';
-import { usePromiseForm } from '@/composables/usePromiseForm';
+import { useProp } from '@/composables/inertia-helpers/useProp';
+import { usePromiseForm } from '@/composables/inertia-helpers/usePromiseForm';
 import type {
 	InviteRole,
 	PendingInvite,
@@ -697,8 +697,8 @@ export function useOnboardingWorkspace(): OnboardingWorkspaceContext {
 				<BbBreadcrumbs
 					class="min-w-0 flex-auto"
 					:items="[
-						{ key: 'dashboard', text: 'Dashboard', href: '/dashboard' },
-						{ key: 'getting-started', text: 'Getting started' },
+						{ value: 'dashboard', label: 'Dashboard', href: '/dashboard' },
+						{ value: 'getting-started', label: 'Getting started' },
 					]"
 				/>
 				<BbButton
@@ -1063,8 +1063,6 @@ const ctx = useOnboardingWorkspace();
 				v-model="role"
 				class="w-44"
 				compact
-				item-text="label"
-				item-value="value"
 				:items="roles"
 				label="Role"
 				label-mode="outside"
@@ -1427,8 +1425,6 @@ import { BbButton } from 'bitboss-ui';
 			v-if="ctx.reminders.enabled"
 			class="max-w-72"
 			compact
-			item-text="label"
-			item-value="value"
 			:items="cadences"
 			label="Reminder schedule"
 			label-mode="outside"