@vuetify/v0 1.0.0-alpha.2 → 1.0.0-alpha.4

package/dist/{index-DE3bWw11.d.mts → index-Cw04PFVO.d.mts}

@@ -1,5 +1,5 @@
-import { a as ID, i as Extensible } from "./index-DuddF-NR.mjs";
-import { t as ContextTrinity } from "./index-DTvqw22G.mjs";
+import { a as ID, i as Extensible } from "./index-CLR1QMM3.mjs";
+import { t as ContextTrinity } from "./index-H_hl6-4b.mjs";
 
 //#region src/composables/createRegistry/index.d.ts
 /**
@@ -47,10 +47,13 @@ type RegistryEventMap<Z extends RegistryTicket> = {
   'clear:registry': undefined;
   'reindex:registry': undefined;
 };
-/** Callback signature for registry event listeners */
-type RegistryEventCallback<Z extends RegistryTicket = RegistryTicket, K extends RegistryEventName = RegistryEventName> = (data: RegistryEventMap<Z>[K]) => void;
-/** Resolves callback type: typed for known events, unknown for custom events */
-type EventHandler<Z extends RegistryTicket, K extends string> = K extends RegistryEventName ? (data: RegistryEventMap<Z>[K]) => void : (data: unknown) => void;
+/**
+ * Callback signature for registry event listeners.
+ *
+ * Resolves to a typed payload for known {@link RegistryEventName} keys, and
+ * `(data: unknown) => void` for custom events.
+ */
+type RegistryEventCallback<Z extends RegistryTicket = RegistryTicket, K extends Extensible<RegistryEventName> = Extensible<RegistryEventName>> = K extends RegistryEventName ? (data: RegistryEventMap<Z>[K]) => void : (data: unknown) => void;
 /** Resolves payload type: typed for known events, unknown for custom events */
 type EventPayload<Z extends RegistryTicket, K extends string> = K extends RegistryEventName ? RegistryEventMap<Z>[K] : unknown;
 interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E extends RegistryTicket & Z = RegistryTicket & Z> {
@@ -149,9 +152,9 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    * const unique = registry.browse('unique-value') // ['ticket-3']
    * ```
    */
-  browse: (value: E['value']) => ID[] | undefined;
+  browse: (value: E['value']) => readonly ID[] | undefined;
   /**
-   * lookup a ticket by index number
+   * 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.
@@ -195,7 +198,8 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    *
    * @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()`.
+   * @param event Optional custom event name to emit alongside `update:ticket`. The patched ticket is dispatched as the event payload.
+   * @remarks If the ticket exists, it will be updated in place — the ticket reference returned by `register()` remains valid and reactive (when `reactive: true`). 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/create-registry
    *
@@ -203,13 +207,16 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    * ```ts
    * import { createRegistry } from '@vuetify/v0'
    *
-   * const registry = createRegistry()
+   * const registry = createRegistry({ events: true })
    *
    * // 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' })
+   *
+   * // Emit a custom event with the patched ticket as payload
+   * registry.upsert('ticket-id', { value: 'final' }, 'ticket:final')
    * ```
   */
   upsert: (id: ID, ticket?: Partial<Z>, event?: string) => E;
@@ -315,12 +322,13 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
   */
   reindex: () => void;
   /**
-   * Seek for a ticket based on direction and optional predicate
+   * Move a ticket to a new index position
    *
-   * @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.
+   * @param id The ID of the ticket to move.
+   * @param toIndex The target index position. Clamped to valid range.
+   * @returns The moved ticket, or undefined if the ticket was not found.
+   *
+   * @remarks Rebuilds the internal collection order by removing and reinserting the entry at the target position. Triggers a full reindex after the move. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
    *
    * @see https://0.vuetifyjs.com/composables/registration/create-registry
    *
@@ -330,31 +338,49 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    *
    * 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')
+   * registry.onboard([
+   *   { id: 'a', value: 'alpha' },
+   *   { id: 'b', value: 'beta' },
+   *   { id: 'c', value: 'gamma' },
+   * ])
    *
-   * // Seek the first ticket with value 'banana'
-   * const banana = registry.seek('first', undefined, ticket => ticket.value === 'banana')
+   * // Move 'a' from index 0 to index 2
+   * registry.move('a', 2)
    *
-   * // 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'))
+   * console.log(registry.keys()) // ['b', 'c', 'a']
    * ```
   */
+  move: (id: ID, toIndex: number) => E | undefined;
   /**
-   * Move a ticket to a new index position
+   * Reorder the registry to match a canonical permutation of ids in one pass.
    *
-   * @param id The ID of the ticket to move.
-   * @param toIndex The target index position. Clamped to valid range.
-   * @returns The moved ticket, or undefined if the ticket was not found.
+   * @param ids A full permutation of the currently-registered ticket ids.
    *
-   * @remarks Rebuilds the internal collection order by removing and reinserting the entry at the target position. Triggers a full reindex after the move. This operation invalidates cached results from `keys()`, `values()`, and `entries()`.
+   * @remarks
+   * Bulk equivalent of calling `move` n times, but does the rebuild once
+   * (O(n) total rather than O(n²)). Silently no-ops when `ids.length !== size`,
+   * when any id is unknown, or when `ids` contains duplicates — caller is
+   * responsible for validation and warnings. Emits `reindex:registry` once on
+   * completion; does not emit per-ticket `update:ticket` events.
+   *
+   * @example
+   * ```ts
+   * const registry = createRegistry()
+   * registry.onboard([{ id: 'a' }, { id: 'b' }, { id: 'c' }])
+   *
+   * registry.reorder(['c', 'a', 'b'])
+   *
+   * console.log(registry.keys()) // ['c', 'a', 'b']
+   * ```
+   */
+  reorder: (ids: ID[]) => void;
+  /**
+   * Seek for a ticket based on direction and optional predicate
+   *
+   * @param direction The scan direction (`'first'` = forward, `'last'` = backward). Defaults to `'first'`.
+   * @param from The index to start scanning from. With `'first'` the scan moves forward from `from`; with `'last'` the scan moves backward from `from`. Defaults to `0` for `'first'` and `size - 1` for `'last'`.
+   * @param predicate An optional function to test each ticket. The first ticket reached in scan order that satisfies the predicate is 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/create-registry
    *
@@ -364,19 +390,23 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    *
    * const registry = createRegistry()
    *
-   * registry.onboard([
-   *   { id: 'a', value: 'alpha' },
-   *   { id: 'b', value: 'beta' },
-   *   { id: 'c', value: 'gamma' },
-   * ])
+   * registry.register({ id: 'ticket-1', value: 'apple' })
+   * registry.register({ id: 'ticket-2', value: 'banana' })
+   * registry.register({ id: 'ticket-3', value: 'cherry' })
    *
-   * // Move 'a' from index 0 to index 2
-   * registry.move('a', 2)
+   * // Seek the first ticket
+   * const first = registry.seek('first')
    *
-   * console.log(registry.keys()) // ['b', 'c', 'a']
+   * // 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'))
    * ```
   */
-  move: (id: ID, toIndex: number) => E | undefined;
   seek: (direction?: 'first' | 'last', from?: number, predicate?: (ticket: E) => boolean) => E | undefined;
   /**
    * Listen for registry events
@@ -406,7 +436,7 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    * registry.register({ id: 'ticket-id' }) // Console: Ticket registered: { id: 'ticket-id', ... }
    * ```
   */
-  on: <K extends Extensible<RegistryEventName>>(event: K, cb: EventHandler<E, K>) => void;
+  on: <K extends Extensible<RegistryEventName>>(event: K, cb: RegistryEventCallback<E, K>) => void;
   /**
    * Stop listening for registry events
    *
@@ -436,7 +466,7 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    * })
    * ```
   */
-  off: <K extends Extensible<RegistryEventName>>(event: K, cb: EventHandler<E, K>) => void;
+  off: <K extends Extensible<RegistryEventName>>(event: K, cb: RegistryEventCallback<E, K>) => void;
   /**
    * Emit an event with data
    *
@@ -506,10 +536,19 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
   */
   onboard: (registrations: Partial<Z & RegistryTicket>[]) => E[];
   /**
-   * Offboard multiple tickets at once
+   * Offboard multiple tickets at once, returning the input shapes that were removed.
    *
    * @param ids An array of ticket IDs to unregister.
-   * @remarks Unregisters multiple tickets in a single operation with optimized reindexing.
+   * @returns An array of `Partial<Z>` — the inputs that were registered, with
+   * registry-managed fields (`index`, `valueIsIndex`, `unregister`) stripped.
+   * The `id` is preserved only when `valueIsIndex` was false (i.e. the user
+   * supplied a meaningful value); otherwise the id is stripped so the receiving
+   * registry can assign a fresh one. Order matches the input `ids` array. Missing
+   * ids are silently skipped — the returned array may be shorter than `ids`.
+   * @remarks Unregisters multiple tickets in a single operation with optimized
+   * reindexing. The inverse of `onboard`: onboard takes inputs and returns outputs;
+   * offboard takes ids and returns the inputs back. Pair with `onboard` on a
+   * different registry to move tickets across registries.
    *
    * @see https://0.vuetifyjs.com/composables/registration/create-registry
    *
@@ -525,12 +564,17 @@ interface RegistryContext<Z extends RegistryTicketInput = RegistryTicketInput, E
    *   { id: 'ticket-3', value: 'value-3' },
    * ])
    *
-   * registry.offboard(['ticket-1', 'ticket-3'])
+   * const removed = registry.offboard(['ticket-1', 'ticket-3'])
    *
    * console.log(registry.size) // 1
+   * console.log(removed) // [{ id: 'ticket-1', value: 'value-1' }, { id: 'ticket-3', value: 'value-3' }]
+   *
+   * // Move to another registry
+   * const other = createRegistry()
+   * other.onboard(removed)
    * ```
   */
-  offboard: (ids: ID[]) => void;
+  offboard: (ids: ID[]) => Partial<Z>[];
   /**
    * The number of tickets in the registry
    *

package/dist/index-DewYtDsc.d.mts

@@ -0,0 +1,4 @@
+//#region src/composables/useStorage/adapters/index.d.ts
+type StorageType = 'localStorage' | 'sessionStorage' | 'memory';
+//#endregion
+export { StorageType as t };