@vuetify/v0 0.1.2 → 0.1.3

package/dist/index-qSuLpob3.d.mts

@@ -1,1544 +0,0 @@
-import { a as ID } from "./index-DlxrzbvZ.mjs";
-import { App, ComputedRef, MaybeRef, MaybeRefOrGetter, Reactive, Ref, ShallowRef } from "vue";
-
-//#region src/composables/createTrinity/index.d.ts
-
-type ContextTrinity<Z = unknown> = readonly [() => Z, (context?: Z, app?: App) => Z, Z];
-/**
- * Creates a new trinity for a context composable and its provider.
- *
- * @param useContext The function that retrieves/uses the context (typically named `useContext`).
- * @param provideContext The function that provides the context to descendants.
- * @param context The default context instance to use when no custom context is provided.
- * @template Z The type of the context.
- * @returns A readonly tuple containing: [useContext function, provideContext wrapper function, default context instance].
- *
- * @remarks The trinity pattern is a foundational pattern used throughout the codebase for creating reusable context systems. It provides three related elements:
- *
- * 1. A function to retrieve/use the context
- * 2. A function to provide the context (with default value support)
- * 3. The default context instance
- *
- * The returned tuple is readonly (using `as const`) to ensure proper type inference.
- *
- * @see https://0.vuetifyjs.com/composables/foundation/create-trinity#create-trinity
- *
- * @example
- * ```ts
- * interface MyContext {
- *   foo: string
- *   bar: number
- * }
- *
- * export function createMyFeature<E extends MyContext = MyContext>() {
- *   const [useContext, _provideContext] = createContext<E>('my-context')
- *
- *   const context = { foo: 'hello', bar: 42 }
- *
- *   function provideContext (_context: E = context, app?: App): E {
- *     return _provideContext(_context, app)
- *   }
- *
- *   return createTrinity<E>(useContext, provideContext, context)
- * }
- * ```
- */
-declare function createTrinity<Z = unknown>(useContext: () => Z, provideContext: (_context?: Z, app?: App) => Z, context: Z): ContextTrinity<Z>;
-//#endregion
-//#region src/composables/createRegistry/index.d.ts
-interface RegistryTicket<V = unknown> {
-  /** The unique identifier. Is randomly generated if not provided. */
-  id: ID;
-  /**
-   * The index of the ticket in the registry.
-   *
-   * @remarks Automatically managed by the registry. Updated during reindexing. It's not recommended to manually set this.
-   */
-  index: number;
-  /** The value associated with the ticket. If not provided, it defaults to the index. */
-  value: V;
-  /**
-   * Whether the value is derived from index.
-   *
-   * @remarks Set to true when no explicit value is provided during registration. It's not recommended to manually set this.
-   */
-  valueIsIndex: boolean;
-}
-/** Callback signature for registry event listeners */
-type RegistryEventCallback = (data: unknown) => void;
-interface RegistryContext<Z extends RegistryTicket = RegistryTicket> {
-  /**
-   * The collection of tickets in the registry
-   *
-   * @template ID The type of the ticket ID.
-   * @template Z The type of the registry ticket.
-   *
-   * @remarks Read-only view of the internal collection. Use `register`, `unregister`, `upsert`, and `clear` methods to modify.
-   */
-  collection: ReadonlyMap<ID, Z>;
-  /**
-   * Clear the entire registry
-   *
-   * @remarks Removes all tickets from the registry. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#clear
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1' })
-   * registry.register({ id: 'ticket-2' })
-   *
-   * console.log(registry.size) // 2
-   *
-   * registry.clear()
-   *
-   * console.log(registry.size) // 0
-   * ```
-   */
-  clear: () => void;
-  /**
-   * Check if a ticket exists by ID
-   *
-   * @param id The ID of the ticket to check.
-   * @remarks Calls `collection.has` internally.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#has
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-id' })
-   *
-   * const exists = registry.has('ticket-id') // true
-   * ```
-   */
-  has: (id: ID) => boolean;
-  /**
-   * Get all registered IDs
-   *
-   * @remarks Calls `collection.keys` internally with caching. First call is O(n), subsequent calls are O(1) until cache invalidation.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#keys
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1' })
-   * registry.register({ id: 'ticket-2' })
-   *
-   * const ids = registry.keys() // ['ticket-1', 'ticket-2']
-   * ```
-   */
-  keys: () => ID[];
-  /**
-   * Browse for an ID(s) by value
-   *
-   * @param value The value to browse for.
-   * @remarks Returns a single ID or an array of IDs if multiple tickets share the same value.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#browse
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1', value: 'common-value' })
-   * registry.register({ id: 'ticket-2', value: 'common-value' })
-   * registry.register({ id: 'ticket-3', value: 'unique-value' })
-   *
-   * const common = registry.browse('common-value') // ['ticket-1', 'ticket-2']
-   * const unique = registry.browse('unique-value') // ['ticket-3']
-   * ```
-   */
-  browse: (value: unknown) => ID[] | undefined;
-  /**
-   * lookup a ticket by index number
-   *
-   * @param index The index number to lookup.
-   * @remarks Maps do not support indexing by default, this method provides a way to retrieve an ID based on its index in the registry.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#lookup
-   *
-   * @example
-   * ```ts
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1' })
-   * registry.register({ id: 'ticket-2' })
-   *
-   * const ticket1 = registry.lookup(0) // 'ticket-1'
-   * const ticket2 = registry.lookup(1) // 'ticket-2'
-   * ```
-   */
-  lookup: (index: number) => ID | undefined;
-  /**
-   * Get a ticket by ID
-   *
-   * @param id The ID of the ticket to retrieve.
-   * @remarks Calls `collection.get` internally.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#get
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-id', value: 'some-value' })
-   *
-   * const ticket = registry.get('ticket-id') // { id: 'ticket-id', index: 0, value: 'some-value', ... }
-   * ```
-   */
-  get: (id: ID) => Z | undefined;
-  /**
-   * Update or insert a ticket by ID
-   *
-   * @param id The ID of the ticket to upsert.
-   * @param ticket The partial ticket data to update or insert.
-   * @remarks If the ticket exists, it will be updated with the provided data. If it doesn't exist, a new ticket will be created with the given ID and data. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#upsert
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * // Insert a new ticket
-   * const ticket = registry.upsert('ticket-id', { value: 'initial-value' })
-   *
-   * // Update the existing ticket
-   * const patched = registry.upsert('ticket-id', { value: 'updated-value' })
-   * ```
-  */
-  upsert: (id: ID, ticket?: Partial<Z>) => Z;
-  /**
-   * Get all values of registered tickets
-   *
-   * @remarks Calls `collection.values` internally with caching. First call is O(n), subsequent calls are O(1) until cache invalidation.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#values
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1', value: 'value-1' })
-   * registry.register({ id: 'ticket-2', value: 'value-2' })
-   *
-   * const values = registry.values() // [{ id: 'ticket-1', ... }, { id: 'ticket-2', ... }]
-   * ```
-   */
-  values: () => Z[];
-  /**
-   * Get all entries of registered tickets
-   *
-   * @remarks Calls `collection.entries` internally with caching. First call is O(n), subsequent calls are O(1) until cache invalidation.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#entries
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1', value: 'value-1' })
-   * registry.register({ id: 'ticket-2', value: 'value-2' })
-   *
-   * const entries = registry.entries() // [['ticket-1', { id: 'ticket-1', ... }], ['ticket-2', { id: 'ticket-2', ... }]]
-   * ```
-  */
-  entries: () => [ID, Z][];
-  /**
-   * Register a new ticket
-   *
-   * @param ticket The partial ticket data to register.
-   * @remarks If no ID is provided, a unique ID will be generated automatically. If no value is provided, it defaults to the ticket's index. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#register
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * const ticket = registry.register()
-   *
-   * console.log(ticket) // { id: 'generated-id', index: 0, value: 0, valueIsIndex: true }
-   * ```
-  */
-  register: (ticket?: Partial<Z>) => Z;
-  /**
-   * Unregister an ticket by ID
-   *
-   * @param id The ID of the ticket to unregister.
-   * @remarks Removes the ticket from the registry and reindexes the remaining tickets. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#unregister
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-id' })
-   *
-   * registry.unregister('ticket-id')
-   * ```
-  */
-  unregister: (id: ID) => void;
-  /**
-   * Reset the index directory and update all tickets
-   *
-   * @remarks Rebuilds the internal index mapping and ensures all tickets have correct index values. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#reindex
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1' })
-   * registry.register({ id: 'ticket-2' })
-   *
-   * // After some operations that may affect indexing
-   * registry.reindex()
-   * ```
-  */
-  reindex: () => void;
-  /**
-   * Seek for a ticket based on direction and optional predicate
-   *
-   * @param direction The direction to seek ('first' or 'last'). Defaults to 'first'.
-   * @param from The index to start seeking from. Defaults to the beginning or end based on direction.
-   * @param predicate An optional function to test each ticket. The first ticket that satisfies the predicate will be returned.
-   * @remarks This method allows for flexible searching within the registry, either from the start or end, and can filter tickets based on custom criteria.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#seek
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1', value: 'apple' })
-   * registry.register({ id: 'ticket-2', value: 'banana' })
-   * registry.register({ id: 'ticket-3', value: 'cherry' })
-   *
-   * // Seek the first ticket
-   * const first = registry.seek('first')
-   *
-   * // Seek the last ticket
-   * const last = registry.seek('last')
-   *
-   * // Seek the first ticket with value 'banana'
-   * const banana = registry.seek('first', undefined, ticket => ticket.value === 'banana')
-   *
-   * // Seek from index 1 to find the next ticket with value starting with 'c'
-   * const cherry = registry.seek('first', 1, ticket => (ticket.value as string).startsWith('c'))
-   * ```
-  */
-  seek: (direction?: 'first' | 'last', from?: number, predicate?: (ticket: Z) => boolean) => Z | undefined;
-  /**
-   * Listen for registry events
-   *
-   * @param event The name of the event to listen for.
-   * @param cb The callback function to invoke when the event is emitted.
-   * @remarks Must be enabled via the `events` option when creating the registry.
-   * Supported events:
-   * - `register:ticket` - Emitted when a ticket is registered, receives the ticket as argument
-   * - `unregister:ticket` - Emitted when a ticket is unregistered, receives the ticket as argument
-   * - `update:ticket` - Emitted when a ticket is updated, receives the updated ticket as argument
-   * - `clear:registry` - Emitted when the registry is cleared
-   * - `reindex:registry` - Emitted when the registry is reindexed
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#on
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ events: true })
-   *
-   * registry.on('register:ticket', (ticket) => {
-   *   console.log('Ticket registered:', ticket)
-   * })
-   *
-   * registry.register({ id: 'ticket-id' }) // Console: Ticket registered: { id: 'ticket-id', ... }
-   * ```
-  */
-  on: (event: string, cb: RegistryEventCallback) => void;
-  /**
-   * Stop listening for registry events
-   *
-   * @param event The name of the event to stop listening for.
-   * @param cb The callback function to remove.
-   * @remarks Must be enabled via the `events` option when creating the registry.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#off
-   *
-   * @example
-   * ```ts
-   * import { onScopeDispose } from 'vue'
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ events: true })
-   *
-   * function onRegister(ticket) {
-   *   console.log('Ticket registered:', ticket)
-   * }
-   *
-   * registry.on('register:ticket', onRegister)
-   *
-   * registry.register({ id: 'ticket-id' }) // Console: Ticket registered: { id: 'ticket-id', ... }
-   *
-   * onScopeDispose(() => {
-   *   registry.off('register:ticket', onRegister)
-   * })
-   * ```
-  */
-  off: (event: string, cb: RegistryEventCallback) => void;
-  /**
-   * Emit an event with data
-   *
-   * @param event The name of the event to emit.
-   * @param data The data to pass to event listeners.
-   * @remarks Must be enabled via the `events` option when creating the registry.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#emit
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ events: true })
-   *
-   * registry.on('custom-event', (data) => {
-   *   console.log('Custom event received:', data)
-   * })
-   *
-   * registry.emit('custom-event', { message: 'Hello, World!' }) // Console: Custom event received: { message: 'Hello, World!' }
-   * ```
-  */
-  emit: (event: string, data: unknown) => void;
-  /**
-   * Clears the registry and removes all listeners
-   *
-   * @remarks Disposes of the registry by clearing all tickets and removing all event listeners.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#dispose
-   *
-   * @example
-   * ```ts
-   * import { onScopeDispose } from 'vue'
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ events: true })
-   *
-   * registry.register({ id: 'ticket-id' })
-   *
-   * onScopeDispose(() => {
-   *   registry.dispose()
-   * })
-   * ```
-  */
-  dispose: () => void;
-  /**
-   * Onboard multiple tickets at once
-   *
-   * @param registrations An array of partial ticket data to register.
-   * @remarks Registers multiple tickets in a single operation and returns the array of registered tickets.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#onboard
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * const tickets = registry.onboard([
-   *   { id: 'ticket-1', value: 'value-1' },
-   *   { id: 'ticket-2', value: 'value-2' },
-   * ])
-   *
-   * console.log(tickets) // [{ id: 'ticket-1', ... }, { id: 'ticket-2', ... }]
-   * ```
-  */
-  onboard: (registrations: Partial<Z>[]) => Z[];
-  /**
-   * Offboard multiple tickets at once
-   *
-   * @param ids An array of ticket IDs to unregister.
-   * @remarks Unregisters multiple tickets in a single operation with optimized reindexing.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#offboard
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.onboard([
-   *   { id: 'ticket-1', value: 'value-1' },
-   *   { id: 'ticket-2', value: 'value-2' },
-   *   { id: 'ticket-3', value: 'value-3' },
-   * ])
-   *
-   * registry.offboard(['ticket-1', 'ticket-3'])
-   *
-   * console.log(registry.size) // 1
-   * ```
-  */
-  offboard: (ids: ID[]) => void;
-  /**
-   * The number of tickets in the registry
-   *
-   * @remarks Reflects the current size of the internal ticket collection.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#size
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry()
-   *
-   * registry.register({ id: 'ticket-1' })
-   * registry.register({ id: 'ticket-2' })
-   *
-   * console.log(registry.size) // 2
-   * ```
-  */
-  size: number;
-  /**
-   * Execute operations in a batch, deferring cache invalidation and event emission until complete
-   *
-   * @param fn The function containing batch operations.
-   * @returns The return value of the batch function.
-   * @remarks Useful for bulk operations like onboard(). Invalidation and events happen once at the end, not after each operation.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/use-registry#batch
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ events: true })
-   *
-   * // Without batch: N invalidations + N events
-   * // With batch: 1 invalidation + N events (after all registrations)
-   * const tickets = registry.batch(() => {
-   *   return [
-   *     registry.register({ id: 'a' }),
-   *     registry.register({ id: 'b' }),
-   *     registry.register({ id: 'c' }),
-   *   ]
-   * })
-   * ```
-  */
-  batch: <R>(fn: () => R) => R;
-}
-interface RegistryOptions {
-  /**
-   * Enable event emission for registry operations
-   *
-   * @default false
-   * @remarks When enabled, the registry will emit events for operations like registration and unregistration. Listeners can be added using the `on` method.
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ events: true })
-   *
-   * registry.on('register:ticket', (ticket) => {
-   *   console.log('Ticket registered:', ticket)
-   * })
-   *
-   * registry.register({ id: 'ticket-id' }) // Console: Ticket registered: { id: 'ticket-id', ... }
-   * ```
-  */
-  events?: boolean;
-  /**
-   * Enable reactive behavior for registry operations
-   *
-   * @default false
-   * @remarks When enabled, the registry will use Vue's shallowReactive to track changes. This is useful for scenarios where you want to reactively update the registry state in response to changes.
-   *
-   * @example
-   * ```ts
-   * import { createRegistry } from '@vuetify/v0'
-   *
-   * const registry = createRegistry({ reactive: true })
-   *
-   * registry.register({ id: 'ticket-id' })
-   *
-   * console.log(registry.size) // 1
-   * ```
-  */
-  reactive?: boolean;
-}
-interface RegistryContextOptions extends RegistryOptions {
-  namespace?: string;
-}
-/**
- * Creates a new registry instance.
- *
- * @param options The options for the registry instance.
- * @template Z The type of registry ticket that extends RegistryTicket. Use this to add custom properties to tickets.
- * @template E The type of registry context that extends RegistryContext<Z>. Use this when extending the registry with additional methods.
- * @returns A new registry instance.
- *
- * @see https://0.vuetifyjs.com/composables/registration/create-registry#create-registry
- *
- * @example
- * ```ts
- * import { createRegistry } from '@vuetify/v0'
- *
- * const registry = createRegistry()
- *
- * const ticket1 = registry.register({ id: 'user-1', value: { name: 'John' } })
- * const ticket2 = registry.register({ id: 'user-2', value: { name: 'Jane' } })
- *
- * console.log(registry.size) // 2
- * console.log(registry.get('user-1')) // { id: 'user-1', index: 0, value: { name: 'John' }, ... }
- * ```
- */
-declare function createRegistry<Z extends RegistryTicket = RegistryTicket, E extends RegistryContext<Z> = RegistryContext<Z>>(options?: RegistryOptions): E;
-/**
- * Creates a new registry context.
- *
- * @param options The options for the registry context, including `namespace` (defaults to `'v0:registry'`) and `events`.
- * @template Z The type of registry ticket that extends RegistryTicket. Use this to add custom properties to tickets.
- * @template E The type of registry context that extends RegistryContext<Z>. Use this when extending the registry with additional methods.
- * @returns A new registry context.
- *
- * @see https://0.vuetifyjs.com/composables/registration/create-registry#create-registry-context
- *
- * @example
- * ```ts
- * import { createRegistryContext } from '@vuetify/v0'
- *
- * // With default namespace 'v0:registry'
- * export const [useItems, provideItems, items] = createRegistryContext()
- *
- * // Or with custom namespace
- * export const [useItems, provideItems, items] = createRegistryContext({ namespace: 'my-items' })
- *
- * // In a parent component:
- * provideItems()
- *
- * // In a child component:
- * const items = useItems()
- * items.register({ id: 'item-1', value: 'Value 1' })
- * ```
- */
-declare function createRegistryContext<Z extends RegistryTicket = RegistryTicket, E extends RegistryContext<Z> = RegistryContext<Z>>(_options?: RegistryContextOptions): ContextTrinity<E>;
-//#endregion
-//#region src/composables/createSelection/index.d.ts
-/**
- * Input type for selection tickets - what users provide to register().
- * Custom ticket types should extend this interface.
- *
- * @template V The type of the ticket value.
- *
- * @example
- * ```ts
- * interface MyTicket extends SelectionTicketInput {
- *   label: string
- *   disabled?: boolean
- *   metadata?: Record<string, unknown>
- * }
- *
- * const selection = createSelection<MyTicket>()
- * selection.register({ label: 'Item 1' })
- * ```
- */
-interface SelectionTicketInput<V = unknown> extends RegistryTicket<V> {
-  /** Disabled state of the ticket (optional on input, defaults to false) */
-  disabled?: MaybeRef<boolean>;
-}
-/**
- * Output type for selection tickets - what users receive from get().
- * Includes registry-added methods for self-selection.
- *
- * @template Z The input ticket type that extends SelectionTicketInput.
- *
- * @remarks
- * The following properties are automatically added by the registry:
- * - `disabled` - Defaults to `false` if not provided
- * - `isSelected` - Reactive boolean indicating selection state
- * - `select()` - Method to select this ticket
- * - `unselect()` - Method to unselect this ticket
- * - `toggle()` - Method to toggle selection state
- */
-type SelectionTicket<Z extends SelectionTicketInput = SelectionTicketInput> = Z & {
-  /** Disabled state of the ticket (guaranteed to exist on output) */
-  disabled: MaybeRef<boolean>;
-  /** Whether the ticket is currently selected */
-  isSelected: Readonly<Ref<boolean, boolean>>;
-  /** Select self */
-  select: () => void;
-  /** Unselect self */
-  unselect: () => void;
-  /** Toggle self on and off */
-  toggle: () => void;
-};
-/**
- * Context returned by createSelection.
- *
- * @template Z The input ticket type (what users provide to register).
- * @template E The output ticket type (what users receive from get). Defaults to SelectionTicket<Z>.
- */
-interface SelectionContext<Z extends SelectionTicketInput = SelectionTicketInput, E extends SelectionTicket<Z> = SelectionTicket<Z>> extends Omit<RegistryContext<E>, 'register' | 'onboard'> {
-  /** Set of selected ticket IDs */
-  selectedIds: Reactive<Set<ID>>;
-  /** Set of selected ticket instances */
-  selectedItems: ComputedRef<Set<E>>;
-  /** Set of selected ticket values */
-  selectedValues: ComputedRef<Set<unknown>>;
-  /** Disable state for the entire selection instance */
-  disabled: MaybeRef<boolean>;
-  /** Clear all selected IDs and reindexes */
-  reset: () => void;
-  /** Select a ticket by ID (Toggle ON) */
-  select: (id: ID) => void;
-  /** Unselect a ticket by ID (Toggle OFF) */
-  unselect: (id: ID) => void;
-  /** Toggles a ticket ON and OFF by ID */
-  toggle: (id: ID) => void;
-  /** Check if a ticket is selected by ID */
-  selected: (id: ID) => boolean;
-  /** Mandates selected ID based on "mandatory" Option */
-  mandate: () => void;
-  /** Register a new ticket (accepts input type, returns output type) */
-  register: (ticket?: Partial<Z>) => E;
-  /** Onboard multiple tickets at once */
-  onboard: (registrations: Partial<Z>[]) => E[];
-}
-interface SelectionOptions extends RegistryOptions {
-  /** When true, the entire selection instance is disabled. */
-  disabled?: MaybeRefOrGetter<boolean>;
-  /**
-   * When true, newly registered items are automatically selected if not disabled.
-   * Useful for pre-selecting items in multi-select scenarios.
-   */
-  enroll?: MaybeRefOrGetter<boolean>;
-  /**
-   * Controls mandatory selection behavior:
-   * - `false` (default): No mandatory selection enforcement
-   * - `true`: Prevents deselecting the last selected item (user must always have one selected)
-   * - `'force'`: Automatically selects the first non-disabled item on registration
-   */
-  mandatory?: MaybeRefOrGetter<boolean | 'force'>;
-  /** When true, treats the selection as an array */
-  multiple?: MaybeRefOrGetter<boolean>;
-}
-interface SelectionContextOptions extends SelectionOptions {
-  namespace?: string;
-}
-/**
- * Creates a new selection instance for managing multiple selected items.
- *
- * Extends `useRegistry` with selection tracking via a reactive `Set` of selected IDs.
- * Supports disabled items, mandatory selection enforcement, and auto-enrollment.
- *
- * @param options The options for the selection instance.
- * @template Z The input ticket type - what users provide to register(). Extend SelectionTicketInput to add custom properties.
- * @template E The output ticket type - what users receive from get(). Automatically includes selection methods.
- * @template R The context type. Defaults to SelectionContext<Z, E>.
- * @returns A new selection instance with selection management methods.
- *
- * @remarks
- * **Key Features:**
- * - Multi-selection support (unlike `useSingle` which enforces single selection)
- * - Set-based `selectedIds` tracking for efficient lookups
- * - Computed `selectedItems` and `selectedValues` for reactive access
- * - Each ticket gets `isSelected`, `select()`, `unselect()`, and `toggle()` methods
- * - Disabled items cannot be selected
- * - Mandatory mode prevents deselecting the last item
- * - Force mode auto-selects first non-disabled item on registration
- * - Enroll option auto-selects all non-disabled items on registration
- *
- * **Inheritance Chain:**
- * `useRegistry` → `createSelection` → `createSingle`/`createGroup` → `createStep`
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-selection
- *
- * @example
- * ```ts
- * import { createSelection } from '@vuetify/v0'
- *
- * // Basic usage
- * const selection = createSelection({ mandatory: true })
- *
- * selection.onboard([
- *   { id: 'item-1', value: 'Item 1' },
- *   { id: 'item-2', value: 'Item 2', disabled: true },
- *   { id: 'item-3', value: 'Item 3' },
- * ])
- *
- * selection.select('item-1')
- * selection.select('item-3')
- *
- * console.log(selection.selectedIds) // Set { 'item-1', 'item-3' }
- * console.log(Array.from(selection.selectedValues.value)) // ['Item 1', 'Item 3']
- * ```
- *
- * @example
- * ```ts
- * // With custom ticket type
- * interface MyTicket extends SelectionTicketInput {
- *   label: string
- *   icon?: string
- * }
- *
- * const tabs = createSelection<MyTicket>()
- *
- * tabs.register({ label: 'Home', icon: 'mdi-home' })
- * tabs.register({ label: 'Settings' })
- *
- * const ticket = tabs.get('...')
- * // ticket has: label, icon, isSelected, select(), unselect(), toggle()
- * ```
- */
-declare function createSelection<Z extends SelectionTicketInput = SelectionTicketInput, E extends SelectionTicket<Z> = SelectionTicket<Z>, R extends SelectionContext<Z, E> = SelectionContext<Z, E>>(_options?: SelectionOptions): R;
-/**
- * Creates a new selection context.
- *
- * @param options The options for the selection context.
- * @template Z The input ticket type - what users provide to register().
- * @template E The output ticket type - what users receive from get().
- * @template R The context type. Defaults to SelectionContext<Z, E>.
- * @returns A new selection context.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-selection
- *
- * @example
- * ```ts
- * import { createSelectionContext } from '@vuetify/v0'
- *
- * // With default namespace 'v0:selection'
- * export const [useCheckboxes, provideCheckboxes, checkboxes] = createSelectionContext()
- *
- * // Or with custom namespace
- * export const [useCheckboxes, provideCheckboxes, checkboxes] = createSelectionContext({ namespace: 'checkboxes' })
- *
- * // In a parent component:
- * provideCheckboxes()
- *
- * // In a child component:
- * const checkboxes = useCheckboxes()
- * checkboxes.select('checkbox-1')
- * ```
- *
- * @example
- * ```ts
- * // With custom ticket type
- * interface TabTicket extends SelectionTicketInput {
- *   label: string
- *   icon?: string
- * }
- *
- * export const [useTabs, provideTabs, tabs] = createSelectionContext<TabTicket>()
- * ```
- */
-declare function createSelectionContext<Z extends SelectionTicketInput = SelectionTicketInput, E extends SelectionTicket<Z> = SelectionTicket<Z>, R extends SelectionContext<Z, E> = SelectionContext<Z, E>>(_options?: SelectionContextOptions): ContextTrinity<R>;
-/**
- * Returns the current selection instance.
- *
- * @param namespace The namespace for the selection context. Defaults to `'v0:selection'`.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns The current selection instance.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-selection
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- *   import { useSelection } from '@vuetify/v0'
- *
- *   const selection = useSelection()
- * </script>
- *
- * <template>
- *   <div>
- *     <p>Selected: {{ selection.selectedIds.size }}</p>
- *   </div>
- * </template>
- * ```
- */
-declare function useSelection<Z extends SelectionTicketInput = SelectionTicketInput, E extends SelectionTicket<Z> = SelectionTicket<Z>, R extends SelectionContext<Z, E> = SelectionContext<Z, E>>(namespace?: string): R;
-//#endregion
-//#region src/composables/createGroup/index.d.ts
-/**
- * Input type for group tickets.
- * Extend this interface to add custom properties.
- */
-interface GroupTicketInput<V = unknown> extends SelectionTicketInput<V> {
-  /** Whether the ticket should start in mixed/indeterminate state */
-  indeterminate?: MaybeRef<boolean>;
-}
-/**
- * Output type for group tickets.
- * Includes all input properties plus selection and tri-state methods.
- */
-type GroupTicket<Z extends GroupTicketInput = GroupTicketInput> = SelectionTicket<Z> & {
-  /** Whether the ticket is in a mixed/indeterminate state */
-  isMixed: Readonly<Ref<boolean>>;
-  /** Set self to mixed/indeterminate state */
-  mix: () => void;
-  /** Clear mixed/indeterminate state from self */
-  unmix: () => void;
-};
-/**
- * Context returned by createGroup.
- *
- * @template Z The input ticket type.
- * @template E The output ticket type.
- */
-interface GroupContext<Z extends GroupTicketInput = GroupTicketInput, E extends GroupTicket<Z> = GroupTicket<Z>> extends Omit<SelectionContext<Z, E>, 'register' | 'onboard' | 'select' | 'unselect' | 'toggle'> {
-  selectedIndexes: ComputedRef<Set<number>>;
-  /** Select one or more Tickets by ID */
-  select: (ids: ID | ID[]) => void;
-  /** Unselect one or more Tickets by ID */
-  unselect: (ids: ID | ID[]) => void;
-  /** Toggle one or more Tickets ON and OFF by ID */
-  toggle: (ids: ID | ID[]) => void;
-  /** Set of mixed/indeterminate ticket IDs */
-  mixedIds: Reactive<Set<ID>>;
-  /** Set of mixed/indeterminate ticket instances */
-  mixedItems: ComputedRef<Set<E>>;
-  /** Set one or more Tickets to mixed/indeterminate state by ID */
-  mix: (ids: ID | ID[]) => void;
-  /** Clear mixed/indeterminate state from one or more Tickets by ID */
-  unmix: (ids: ID | ID[]) => void;
-  /** Check if a ticket is in mixed/indeterminate state by ID */
-  mixed: (id: ID) => boolean;
-  /** Whether no items are currently selected */
-  isNoneSelected: ComputedRef<boolean>;
-  /** Whether all selectable (non-disabled) items are selected */
-  isAllSelected: ComputedRef<boolean>;
-  /** Whether some but not all selectable items are selected */
-  isMixed: ComputedRef<boolean>;
-  /** Select all selectable (non-disabled) items */
-  selectAll: () => void;
-  /** Unselect all items (respects mandatory option) */
-  unselectAll: () => void;
-  /** Toggle between all selected and none selected */
-  toggleAll: () => void;
-  /** Register a new ticket (accepts input type, returns output type) */
-  register: (ticket?: Partial<Z>) => E;
-  /** Onboard multiple tickets at once */
-  onboard: (registrations: Partial<Z>[]) => E[];
-}
-interface GroupOptions extends SelectionOptions {}
-interface GroupContextOptions extends SelectionContextOptions {}
-/**
- * Creates a new group instance with batch selection and tri-state support.
- *
- * Extends `createSelection` to support selecting, unselecting, and toggling multiple items
- * at once by passing an array of IDs. Adds tri-state (mixed/indeterminate) support for
- * checkbox trees and similar use cases.
- *
- * @param options The options for the group instance.
- * @template Z The type of the group ticket.
- * @template E The type of the group context.
- * @returns A new group instance with batch selection and tri-state support.
- *
- * @remarks
- * **Key Differences from `createSelection`:**
- * - `select()` accepts `ID | ID[]` for batch operations
- * - `unselect()` accepts `ID | ID[]` for batch operations
- * - `toggle()` accepts `ID | ID[]` for batch operations
- * - Adds `selectedIndexes` computed Set for getting selected item indexes
- * - Adds tri-state support via `mix()`, `unmix()`, `mixed()`, `mixedIds`, `mixedItems`
- * - Perfect for checkbox trees, multi-select dropdowns, and bulk operations
- *
- * **Tri-State Support:**
- * - Items can be in one of three states: selected, mixed (indeterminate), or unselected
- * - `mix(id)` sets item to mixed state (clears selected if set)
- * - `unmix(id)` clears mixed state
- * - `select(id)` clears mixed state before selecting
- * - `toggle(id)` on a mixed item selects it (resolves the indeterminate state positively)
- * - Mixed state works on disabled items (it's a computed state, not user action)
- *
- * **Batch Operations:**
- * - Single ID: `group.select('item-1')`
- * - Array of IDs: `group.select(['item-1', 'item-2', 'item-3'])`
- * - Uses `toArray()` utility internally to normalize input
- * - Disabled items are automatically skipped in select operations
- * - Non-existent IDs are silently ignored
- *
- * **Inheritance Chain:**
- * `useRegistry` → `createSelection` → `createGroup`
- *
- * **Used By:**
- * - `createFeatures` for feature flag management with multiple selections
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-group
- *
- * @example
- * ```ts
- * import { createGroup } from '@vuetify/v0'
- *
- * const checkboxes = createGroup()
- *
- * checkboxes.onboard([
- *   { id: 'option-a', value: 'Option A' },
- *   { id: 'option-b', value: 'Option B' },
- *   { id: 'option-c', value: 'Option C' },
- * ])
- *
- * // Select multiple items at once
- * checkboxes.select(['option-a', 'option-c'])
- *
- * console.log(checkboxes.selectedIds) // Set { 'option-a', 'option-c' }
- * console.log(Array.from(checkboxes.selectedIndexes.value)) // [0, 2]
- *
- * // Set item to mixed/indeterminate state
- * checkboxes.mix('option-a')
- * console.log(checkboxes.mixedIds) // Set { 'option-a' }
- * console.log(checkboxes.selectedIds) // Set { 'option-c' } (option-a removed)
- *
- * // Toggle a mixed item selects it
- * checkboxes.toggle('option-a')
- * console.log(checkboxes.selectedIds) // Set { 'option-a', 'option-c' }
- * console.log(checkboxes.mixedIds) // Set {} (cleared)
- * ```
- */
-declare function createGroup<Z extends GroupTicketInput = GroupTicketInput, E extends GroupTicket<Z> = GroupTicket<Z>, R extends GroupContext<Z, E> = GroupContext<Z, E>>(_options?: GroupOptions): R;
-/**
- * Creates a new group context.
- *
- * @param options The options for the group context.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns A new group context.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-group
- *
- * @example
- * ```ts
- * import { createGroupContext } from '@vuetify/v0'
- *
- * // With default namespace 'v0:group'
- * export const [useMyGroup, provideMyGroup, myGroup] = createGroupContext()
- *
- * // Or with custom namespace
- * export const [useMyGroup, provideMyGroup, myGroup] = createGroupContext({ namespace: 'my-group' })
- *
- * // In a parent component:
- * provideMyGroup()
- *
- * // In a child component:
- * const group = useMyGroup()
- * ```
- */
-declare function createGroupContext<Z extends GroupTicketInput = GroupTicketInput, E extends GroupTicket<Z> = GroupTicket<Z>, R extends GroupContext<Z, E> = GroupContext<Z, E>>(_options?: GroupContextOptions): ContextTrinity<R>;
-/**
- * Returns the current group instance.
- *
- * @param namespace The namespace for the group context. Defaults to `'v0:group'`.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns The current group instance.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-group
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- *   import { useGroup } from '@vuetify/v0'
- *
- *   const group = useGroup()
- * </script>
- *
- * <template>
- *   <div>
- *     <p>Selected: {{ group.selectedIds.size }}</p>
- *   </div>
- * </template>
- * ```
- */
-declare function useGroup<Z extends GroupTicketInput = GroupTicketInput, E extends GroupTicket<Z> = GroupTicket<Z>, R extends GroupContext<Z, E> = GroupContext<Z, E>>(namespace?: string): R;
-//#endregion
-//#region src/composables/usePagination/index.d.ts
-type PaginationTicket = {
-  type: 'page';
-  value: number;
-} | {
-  type: 'ellipsis';
-  value: string;
-};
-interface PaginationContext {
-  /** Current page (1-indexed) */
-  page: ShallowRef<number>;
-  /** Items per page */
-  itemsPerPage: number;
-  /** Total number of items */
-  size: number;
-  /** Total number of pages (computed from size / itemsPerPage) */
-  pages: number;
-  /** Ellipsis character, or false if disabled */
-  ellipsis: string | false;
-  /** Visible page numbers and ellipsis for rendering */
-  items: ComputedRef<PaginationTicket[]>;
-  /** Start index of items on current page (0-indexed) */
-  pageStart: ComputedRef<number>;
-  /** End index of items on current page (exclusive, 0-indexed) */
-  pageStop: ComputedRef<number>;
-  /** Whether current page is the first page */
-  isFirst: ComputedRef<boolean>;
-  /** Whether current page is the last page */
-  isLast: ComputedRef<boolean>;
-  /** Go to first page */
-  first: () => void;
-  /** Go to last page */
-  last: () => void;
-  /** Go to next page */
-  next: () => void;
-  /** Go to previous page */
-  prev: () => void;
-  /** Go to specific page */
-  select: (value: number) => void;
-}
-interface PaginationOptions {
-  /** Initial page or ref for v-model (1-indexed). @default 1 */
-  page?: number | ShallowRef<number>;
-  /** Items per page. @default 10 */
-  itemsPerPage?: MaybeRefOrGetter<number>;
-  /** Total number of items. @default 0 */
-  size?: MaybeRefOrGetter<number>;
-  /** Maximum visible page buttons. @default 5 */
-  visible?: MaybeRefOrGetter<number>;
-  /** Ellipsis character. @default '…' */
-  ellipsis?: string | false;
-}
-interface PaginationContextOptions extends PaginationOptions {
-  /** Namespace for dependency injection */
-  namespace?: string;
-}
-/**
- * Creates a pagination instance.
- *
- * @param options The options for the pagination instance.
- * @returns A pagination context with navigation methods.
- *
- * @example
- * ```ts
- * import { createPagination } from '@vuetify/v0'
- *
- * // Basic usage
- * const pagination = createPagination({ size: 100 })
- * pagination.next()
- * pagination.items.value // [{ type: 'page', value: 1 }, { type: 'page', value: 2 }, ...]
- *
- * // With v-model (pass a ref)
- * const page = ref(1)
- * const pagination = createPagination({ page, size: 100 })
- * // Mutating pagination.page or the passed ref syncs both
- * ```
- */
-declare function createPagination(_options?: PaginationOptions): PaginationContext;
-/**
- * Creates a pagination context for dependency injection.
- *
- * @param options The options including namespace.
- * @returns A trinity: [usePagination, providePagination, defaultContext]
- *
- * @example
- * ```ts
- * // With default namespace 'v0:pagination'
- * const [usePagination, providePaginationContext] = createPaginationContext({ size: 50 })
- *
- * // Or with custom namespace
- * const [usePagination, providePaginationContext] = createPaginationContext({
- *   namespace: 'my-pagination',
- *   size: 50,
- * })
- *
- * // Parent component
- * providePaginationContext()
- *
- * // Child component
- * const pagination = usePagination()
- * pagination.next()
- * ```
- */
-declare function createPaginationContext(_options?: PaginationContextOptions): ContextTrinity<PaginationContext>;
-/**
- * Returns the current pagination instance from context.
- *
- * @param namespace The namespace. @default 'v0:pagination'
- * @returns The pagination context.
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- *  import { usePagination } from '@vuetify/v0'
- *
- *  const pagination = usePagination()
- * </script>
- *
- * <template>
- *   <button @click="pagination.prev()" :disabled="pagination.isFirst.value">Prev</button>
- *   <button @click="pagination.next()" :disabled="pagination.isLast.value">Next</button>
- * </template>
- * ```
- */
-declare function usePagination(namespace?: string): PaginationContext;
-//#endregion
-//#region src/composables/createSingle/index.d.ts
-/**
- * Input type for single selection tickets.
- * Extend this interface to add custom properties.
- */
-interface SingleTicketInput<V = unknown> extends SelectionTicketInput<V> {}
-/**
- * Output type for single selection tickets.
- * Includes all input properties plus selection methods.
- */
-type SingleTicket<Z extends SingleTicketInput = SingleTicketInput> = SelectionTicket<Z>;
-/**
- * Context returned by createSingle.
- *
- * @template Z The input ticket type.
- * @template E The output ticket type.
- */
-interface SingleContext<Z extends SingleTicketInput = SingleTicketInput, E extends SingleTicket<Z> = SingleTicket<Z>> extends Omit<SelectionContext<Z, E>, 'register' | 'onboard'> {
-  selectedId: ComputedRef<ID | undefined>;
-  selectedIndex: ComputedRef<number>;
-  selectedItem: ComputedRef<E | undefined>;
-  selectedValue: ComputedRef<E['value'] | undefined>;
-  /** Register a new ticket (accepts input type, returns output type) */
-  register: (ticket?: Partial<Z>) => E;
-  /** Onboard multiple tickets at once */
-  onboard: (registrations: Partial<Z>[]) => E[];
-}
-interface SingleOptions extends SelectionOptions {}
-interface SingleContextOptions extends SelectionContextOptions {}
-/**
- * Creates a new single selection instance that enforces only one selected item at a time.
- *
- * Extends `createSelection` by automatically clearing previous selections when a new item is selected.
- * Adds computed singular properties: `selectedId`, `selectedItem`, `selectedIndex`, `selectedValue`.
- *
- * @param options The options for the single selection instance.
- * @template Z The input ticket type - what users provide to register().
- * @template E The output ticket type - what users receive from get().
- * @template R The context type.
- * @returns A new single selection instance with single-selection enforcement.
- *
- * @remarks
- * **Key Differences from `createSelection`:**
- * - Automatically clears `selectedIds` before selecting a new item (enforces single selection)
- * - Provides singular computed properties instead of plural sets
- * - Perfect for tabs, radio buttons, theme selectors, and other single-choice UI components
- *
- * **Computed Properties:**
- * - `selectedId`: The ID of the selected item (undefined if none selected)
- * - `selectedItem`: The selected ticket object (undefined if none selected)
- * - `selectedIndex`: The index of the selected item (-1 if none selected)
- * - `selectedValue`: The value of the selected item (undefined if none selected)
- *
- * **Inheritance Chain:**
- * `useRegistry` → `createSelection` → `createSingle` → `createStep`
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-single
- *
- * @example
- * ```ts
- * import { createSingle } from '@vuetify/v0'
- *
- * const tabs = createSingle({ mandatory: true })
- *
- * tabs.onboard([
- *   { id: 'home', value: 'Home' },
- *   { id: 'about', value: 'About' },
- *   { id: 'contact', value: 'Contact' },
- * ])
- *
- * tabs.first() // Select first tab
- *
- * console.log(tabs.selectedId.value) // 'home'
- * console.log(tabs.selectedIndex.value) // 0
- *
- * tabs.select('about') // Switch to about tab
- * console.log(tabs.selectedId.value) // 'about'
- * console.log(tabs.selectedIds.size) // 1 (always enforces single selection)
- * ```
- *
- * @example
- * ```ts
- * // With custom ticket type
- * interface TabTicket extends SingleTicketInput {
- *   label: string
- *   icon?: string
- * }
- *
- * const tabs = createSingle<TabTicket>()
- * tabs.register({ label: 'Home', icon: 'mdi-home' })
- * ```
- */
-declare function createSingle<Z extends SingleTicketInput = SingleTicketInput, E extends SingleTicket<Z> = SingleTicket<Z>, R extends SingleContext<Z, E> = SingleContext<Z, E>>(_options?: SingleOptions): R;
-/**
- * Creates a new single selection context.
- *
- * @param options The options for the single selection context.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns A new single selection context.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-single
- *
- * @example
- * ```ts
- * import { createSingleContext } from '@vuetify/v0'
- *
- * // With default namespace 'v0:single'
- * export const [useSingle, provideSingle, context] = createSingleContext()
- *
- * // In a parent component:
- * provideSingle()
- *
- * // In a child component:
- * const single = useSingle()
- * single.select('tab-1')
- * ```
- */
-declare function createSingleContext<Z extends SingleTicketInput = SingleTicketInput, E extends SingleTicket<Z> = SingleTicket<Z>, R extends SingleContext<Z, E> = SingleContext<Z, E>>(_options?: SingleContextOptions): ContextTrinity<R>;
-/**
- * Returns the current single selection instance.
- *
- * @param namespace The namespace for the single selection context. Defaults to `'v0:single'`.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns The current single selection instance.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-single
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- *   import { useSingle } from '@vuetify/v0'
- *
- *   const tabs = useSingle()
- * </script>
- *
- * <template>
- *   <div>
- *     <p>Selected: {{ tabs.selectedId }}</p>
- *   </div>
- * </template>
- * ```
- */
-declare function useSingle<Z extends SingleTicketInput = SingleTicketInput, E extends SingleTicket<Z> = SingleTicket<Z>, R extends SingleContext<Z, E> = SingleContext<Z, E>>(namespace?: string): R;
-//#endregion
-//#region src/composables/createStep/index.d.ts
-/**
- * Input type for step tickets.
- * Extend this interface to add custom properties.
- */
-interface StepTicketInput<V = unknown> extends SingleTicketInput<V> {}
-/**
- * Output type for step tickets.
- * Includes all input properties plus selection methods.
- */
-type StepTicket<Z extends StepTicketInput = StepTicketInput> = SingleTicket<Z>;
-/**
- * Context returned by createStep.
- *
- * @template Z The input ticket type.
- * @template E The output ticket type.
- */
-interface StepContext<Z extends StepTicketInput = StepTicketInput, E extends StepTicket<Z> = StepTicket<Z>> extends Omit<SingleContext<Z, E>, 'register' | 'onboard'> {
-  /** Select the first Ticket in the collection */
-  first: () => void;
-  /** Select the last Ticket in the collection */
-  last: () => void;
-  /** Select the next Ticket based on current index */
-  next: () => void;
-  /** Select the previous Ticket based on current index */
-  prev: () => void;
-  /** Step through the collection by a given count */
-  step: (count: number) => void;
-  /** Register a new ticket (accepts input type, returns output type) */
-  register: (ticket?: Partial<Z>) => E;
-  /** Onboard multiple tickets at once */
-  onboard: (registrations: Partial<Z>[]) => E[];
-}
-interface StepOptions extends SingleOptions {
-  /**
-   * Enable circular navigation (wrapping at boundaries).
-   * - true: Navigation wraps around (carousel behavior)
-   * - false: Navigation stops at boundaries (pagination behavior)
-   * @default false
-   */
-  circular?: boolean;
-}
-interface StepContextOptions extends SingleContextOptions {
-  /**
-   * Enable circular navigation (wrapping at boundaries).
-   * - true: Navigation wraps around (carousel behavior)
-   * - false: Navigation stops at boundaries (pagination behavior)
-   * @default false
-   */
-  circular?: boolean;
-}
-/**
- * Creates a new step instance with navigation through items.
- *
- * Extends `createSingle` with `first()`, `last()`, `next()`, `prev()`, and `step(count)` methods
- * for sequential navigation. Supports both circular (wrapping) and bounded (stopping at edges) modes.
- *
- * @param options The options for the step instance.
- * @template Z The type of the step ticket.
- * @template E The type of the step context.
- * @returns A new step instance with navigation methods.
- *
- * @remarks
- * **Key Features:**
- * - **Configurable Navigation**: `circular: true` for wrapping, `false` for bounded (default: false)
- * - **Disabled Item Skipping**: Automatically skips disabled items during navigation
- * - **Bidirectional**: Forward (`next`, positive `step`) and backward (`prev`, negative `step`)
- * - **Safe Edge Cases**: Handles empty registries and all-disabled scenarios gracefully
- *
- * **Navigation Methods:**
- * - `first()`: Select first non-disabled item
- * - `last()`: Select last non-disabled item
- * - `next()`: Move to next item (wraps if circular, stops at end if bounded)
- * - `prev()`: Move to previous item (wraps if circular, stops at start if bounded)
- * - `step(count)`: Move by `count` positions (negative for backward)
- *
- * **Circular Mode (`circular: true`):**
- * - Uses modulo arithmetic for wrapping: `((index % length) + length) % length`
- * - Works correctly with negative indexes and large step counts
- * - Perfect for carousels, theme switchers, infinite scrolling
- *
- * **Bounded Mode (`circular: false`, default):**
- * - Navigation stops at boundaries (no wrapping)
- * - `next()` on last item does nothing
- * - `prev()` on first item does nothing
- * - Perfect for pagination, wizards with explicit completion, forms
- *
- * **Inheritance Chain:**
- * `useRegistry` → `createSelection` → `createSingle` → `createStep`
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-step
- *
- * @example
- * ```ts
- * import { createStep } from '@vuetify/v0'
- *
- * // Bounded navigation (default) - for pagination
- * const pagination = createStep({ circular: false })
- * pagination.onboard([
- *   { id: 'page-1', value: 1 },
- *   { id: 'page-2', value: 2 },
- *   { id: 'page-3', value: 3 },
- * ])
- * pagination.first() // Select page 1
- * pagination.prev() // Does nothing (already at first)
- * pagination.next() // Select page 2
- *
- * // Circular navigation - for carousels
- * const carousel = createStep({ circular: true })
- * carousel.onboard([
- *   { id: 'slide-1', value: 'First' },
- *   { id: 'slide-2', value: 'Second' },
- *   { id: 'slide-3', value: 'Third' },
- * ])
- * carousel.first()
- * carousel.prev() // Wraps to 'slide-3'
- * carousel.next() // Wraps to 'slide-1'
- * ```
- */
-declare function createStep<Z extends StepTicketInput = StepTicketInput, E extends StepTicket<Z> = StepTicket<Z>, R extends StepContext<Z, E> = StepContext<Z, E>>(_options?: StepOptions): R;
-/**
- * Creates a new step context.
- *
- * @param options The options for the step context.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns A new step context.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-step
- *
- * @example
- * ```ts
- * import { createStepContext } from '@vuetify/v0'
- *
- * // With default namespace 'v0:step'
- * export const [useStep, provideStep, context] = createStepContext()
- *
- * // In a parent component:
- * provideStep()
- *
- * // In a child component:
- * const context = useStep()
- * context.next() // Progress to next step
- * ```
- */
-declare function createStepContext<Z extends StepTicketInput = StepTicketInput, E extends StepTicket<Z> = StepTicket<Z>, R extends StepContext<Z, E> = StepContext<Z, E>>(_options?: StepContextOptions): ContextTrinity<R>;
-/**
- * Returns the current step instance.
- *
- * @param namespace The namespace for the step context. Defaults to `'v0:step'`.
- * @template Z The input ticket type.
- * @template E The output ticket type.
- * @template R The context type.
- * @returns The current step instance.
- *
- * @see https://0.vuetifyjs.com/composables/selection/use-step
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- *   import { useStep } from '@vuetify/v0'
- *
- *   const wizard = useStep()
- * </script>
- *
- * <template>
- *   <div>
- *     <p>Current step: {{ wizard.selectedIndex }}</p>
- *     <button @click="wizard.next()">Next</button>
- *   </div>
- * </template>
- * ```
- */
-declare function useStep<Z extends StepTicketInput = StepTicketInput, E extends StepTicket<Z> = StepTicket<Z>, R extends StepContext<Z, E> = StepContext<Z, E>>(namespace?: string): R;
-//#endregion
-export { createGroupContext as A, RegistryContext as B, usePagination as C, GroupTicket as D, GroupOptions as E, SelectionTicket as F, createRegistry as G, RegistryEventCallback as H, SelectionTicketInput as I, createTrinity as J, createRegistryContext as K, createSelection as L, SelectionContext as M, SelectionContextOptions as N, GroupTicketInput as O, SelectionOptions as P, createSelectionContext as R, createPaginationContext as S, GroupContextOptions as T, RegistryOptions as U, RegistryContextOptions as V, RegistryTicket as W, PaginationContext as _, StepTicketInput as a, PaginationTicket as b, useStep as c, SingleOptions as d, SingleTicket as f, useSingle as g, createSingleContext as h, StepTicket as i, useGroup as j, createGroup as k, SingleContext as l, createSingle as m, StepContextOptions as n, createStep as o, SingleTicketInput as p, ContextTrinity as q, StepOptions as r, createStepContext as s, StepContext as t, SingleContextOptions as u, PaginationContextOptions as v, GroupContext as w, createPagination as x, PaginationOptions as y, useSelection as z };