@vuetify/v0 1.0.0-alpha.3 → 1.0.0-alpha.5

package/dist/{index-DE3bWw11.d.mts → index-C0ewabdY.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
    *
@@ -697,170 +741,4 @@ declare function createRegistryContext<Z extends RegistryTicketInput = RegistryT
  */
 declare function useRegistry<Z extends RegistryTicketInput = RegistryTicketInput, E extends RegistryTicket & Z = RegistryTicket & Z>(namespace?: string): RegistryContext<Z, E>;
 //#endregion
-//#region src/composables/createTokens/index.d.ts
-interface TokenAlias<T = unknown> {
-  [key: string]: unknown;
-  $value: T;
-  $type?: string;
-  $description?: string;
-  $extensions?: Record<string, unknown>;
-  $deprecated?: boolean | string;
-}
-type TokenPrimitive = string | number | boolean | null | Function;
-type TokenValue = TokenPrimitive | TokenAlias;
-interface TokenCollection {
-  [key: string]: TokenValue | TokenCollection;
-}
-type FlatTokenCollection = {
-  id: string;
-  value: TokenValue;
-};
-interface TokenTicket<Z extends TokenValue = TokenValue> extends RegistryTicket<Z> {}
-interface TokenContext<Z extends TokenTicket> extends RegistryContext<Z> {
-  /**
-   * Checks if a token is an alias
-   *
-   * @param token The token to check.
-   * @returns True if the token is an alias, false otherwise.
-   * @remarks An alias is a string that starts with "{" and ends with "}".
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/create-tokens
-   *
-   * @example
-   * ```ts
-   * const tokens = createTokens({
-   *   colors: {
-   *     primary: '#3b82f6',
-   *     secondary: '{colors.primary}', // Alias reference
-   *   },
-   * })
-   *
-   * console.log(tokens.isAlias('{colors.primary}')) // true
-   * console.log(tokens.isAlias('#3b82f6')) // false
-   * ```
-   */
-  isAlias: (token: unknown) => token is string;
-  /**
-   * Resolves a token or alias to its value.
-   *
-   * @param token The token or alias to resolve.
-   * @returns The resolved value of the token or alias, or undefined if not found.
-   * @remarks This function can resolve nested aliases and supports token paths using dot notation.
-   *
-   * @see https://0.vuetifyjs.com/composables/registration/create-tokens
-   *
-   * @example
-   * ```ts
-   * const tokens = createTokens({
-   *   colors: {
-   *     primary: '#3b82f6',
-   *     secondary: '{colors.primary}', // Alias reference
-   *   },
-   * })
-   *
-   * console.log(tokens.resolve('{colors.primary}')) // '#3b82f6'
-   * console.log(tokens.resolve('{colors.secondary}')) // '#3b82f6'
-   * ```
-   */
-  resolve: (token: string | TokenAlias) => unknown | undefined;
-}
-interface TokenOptions extends RegistryOptions {
-  /**
-   * Whether to flatten nested token structures.
-   *
-   * @default false
-   */
-  flat?: boolean;
-  /**
-   * An optional prefix to prepend to each token ID during registration.
-   *
-   * @remarks This is useful for namespacing tokens.
-   */
-  prefix?: string;
-}
-interface TokenContextOptions extends TokenOptions, RegistryContextOptions {
-  tokens?: TokenCollection;
-}
-/**
- * Creates a new token instance.
- *
- * @param tokens The tokens to use.
- * @param options The options for the token instance.
- * @template Z The type of the token ticket.
- * @template E The type of the token context.
- * @returns A new token instance.
- *
- * @see https://www.designtokens.org/tr/drafts/format/
- * @see https://0.vuetifyjs.com/composables/registration/create-tokens
- *
- * @example
- * ```ts
- * import { createTokens } from '@vuetify/v0'
- *
- * const tokens = createTokens({
- *   colors: {
- *     primary: '#3b82f6',
- *     secondary: '{colors.primary}', // Alias reference
- *   },
- * })
- *
- * console.log(tokens.resolve('{colors.primary}')) // '#3b82f6'
- * console.log(tokens.resolve('{colors.secondary}')) // '#3b82f6'
- * ```
- */
-declare function createTokens<Z extends TokenTicket = TokenTicket, E extends TokenContext<Z> = TokenContext<Z>>(tokens?: TokenCollection, options?: TokenOptions): E;
-/**
- * Creates a new token context.
- *
- * @param namespace The namespace for the token context.
- * @param tokens The tokens to use.
- * @template Z The type of the token ticket.
- * @template E The type of the token context.
- * @returns A new token context.
- *
- * @see https://0.vuetifyjs.com/composables/registration/create-tokens
- *
- * @example
- * ```ts
- * import { createTokensContext } from '@vuetify/v0'
- *
- * export const [useTokens, provideTokens, context] = createTokensContext({
- *  namespace: 'v0:tokens',
- *  tokens: {
- *    colors: {
- *      primary: '#3b82f6',
- *      secondary: '{colors.primary}', // Alias reference
- *    },
- *  },
- * })
- * ```
- */
-declare function createTokensContext<Z extends TokenTicket = TokenTicket, E extends TokenContext<Z> = TokenContext<Z>>(_options: TokenContextOptions): ContextTrinity<E>;
-/**
- * Returns the current tokens instance.
- *
- * @param namespace The namespace for the tokens context. Defaults to `'v0:tokens'`.
- * @returns The current tokens instance.
- *
- * @see https://0.vuetifyjs.com/composables/registration/create-tokens
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- *   import { useTokens } from '@vuetify/v0'
- *
- *   const tokens = useTokens()
- * </script>
- * ```
- */
-declare function useTokens<Z extends TokenTicket = TokenTicket, E extends TokenContext<Z> = TokenContext<Z>>(namespace?: string): E;
-/**
- * Flattens a nested collection of tokens into a flat array of tokens.
- * Each token is represented by an object containing its ID & value.
- * @param tokens The collection of tokens to flatten.
- * @param prefix An optional prefix to prepend to each token ID.
- * @returns An array of flattened tokens, each with an ID and value.
- */
-declare function flatten(tokens: TokenCollection, prefix?: string, flat?: boolean): FlatTokenCollection[];
-//#endregion
-export { createRegistryContext as C, createRegistry as S, RegistryEventMap as _, TokenContextOptions as a, RegistryTicket as b, TokenTicket as c, createTokensContext as d, flatten as f, RegistryEventCallback as g, RegistryContextOptions as h, TokenContext as i, TokenValue as l, RegistryContext as m, TokenAlias as n, TokenOptions as o, useTokens as p, TokenCollection as r, TokenPrimitive as s, FlatTokenCollection as t, createTokens as u, RegistryEventName as v, useRegistry as w, RegistryTicketInput as x, RegistryOptions as y };
+export { RegistryEventName as a, RegistryTicketInput as c, useRegistry as d, RegistryEventMap as i, createRegistry as l, RegistryContextOptions as n, RegistryOptions as o, RegistryEventCallback as r, RegistryTicket as s, RegistryContext as t, createRegistryContext as u };

package/dist/index-C6NnIuDv.d.mts

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