@vuetify/v0 1.2.0 → 1.2.2

package/dist/{index-Cx0cWGlx.d.mts → index-Ct0Pmzpx.d.mts}

@@ -1,18 +1,21 @@
-import { a as ID, i as Extensible, o as MaybeArray } from "./index-DtiaWx5U.mjs";
-import { t as ContextTrinity } from "./index-H_hl6-4b.mjs";
-import { a as RegistryEventName, c as RegistryTicketInput, o as RegistryOptions, r as RegistryEventCallback, s as RegistryTicket, t as RegistryContext } from "./index-DSPkZ0ql.mjs";
-import { i as PopoverPlacement, n as PopoverAdapterContext, t as PopoverAdapter } from "./adapter-ClB-53_F.mjs";
-import { _ as FilterMode } from "./adapter-PDTe5nFT.mjs";
-import { _ as ColumnNode, c as DataTableOptions, n as DataTableColumnTicketInput, r as DataTableContext, t as DataTableColumnTicket } from "./index-Di9e8sOm.mjs";
-import { c as TokenTicket, i as TokenContext, o as TokenOptions, r as TokenCollection } from "./index-D0ub61GV.mjs";
-import { A as MatchRange, k as IgnoreAccents } from "./index-DjRE4lLl.mjs";
-import { t as DateAdapter } from "./adapter-D5nT3bLw.mjs";
-import { n as FeaturesAdapterFlags, t as FeaturesAdapter } from "./adapter-BXunW_mw.mjs";
-import { t as LocaleAdapter } from "./adapter-CqS8xexO.mjs";
-import { t as LoggerAdapter } from "./adapter-ryk5H6YZ.mjs";
-import { n as StorageAdapter } from "./memory-B7z1RR9r.mjs";
+import { a as ID, i as Extensible, o as MaybeArray } from "./index-XNZrgWCq.mjs";
+import { t as ContextTrinity } from "./index-ClUa0Bl7.mjs";
+import { a as RegistryEventName, c as RegistryTicketInput, o as RegistryOptions, r as RegistryEventCallback, s as RegistryTicket, t as RegistryContext } from "./index-Y6VfllT2.mjs";
+import { i as PopoverPlacement, n as PopoverAdapterContext, t as PopoverAdapter } from "./adapter-CbkRdMju.mjs";
+import { _ as FilterMode } from "./adapter-BP7jNtvH.mjs";
+import { _ as ColumnNode, c as DataTableOptions, n as DataTableColumnTicketInput, r as DataTableContext, t as DataTableColumnTicket } from "./index-DDwX_0Um.mjs";
+import { c as TokenTicket, i as TokenContext, o as TokenOptions, r as TokenCollection } from "./index-Dlr9_rf1.mjs";
+import { A as MatchRange, k as IgnoreAccents } from "./index-DMQv04YO.mjs";
+import { t as DateAdapter } from "./adapter-BC1VWu0H.mjs";
+import { n as FeaturesAdapterFlags, t as FeaturesAdapter } from "./adapter-w8SEWO2v.mjs";
+import "./flagsmith-BA8q5LAx.mjs";
+import "./launchdarkly-CWhPi3lZ.mjs";
+import "./posthog-Bzaj2Jbd.mjs";
+import { t as LocaleAdapter } from "./adapter-Bi799Zn7.mjs";
+import "./index-h87SNntw.mjs";
+import { t as LoggerAdapter } from "./adapter-CHvvxw4c.mjs";
+import { n as StorageAdapter } from "./memory-DyA22X2q.mjs";
 import { App, ComponentPublicInstance, ComputedRef, InjectionKey, MaybeRef, MaybeRefOrGetter, Reactive, Ref, ShallowReactive, ShallowRef, UnwrapNestedRefs, WatchSource, WritableComputedRef } from "vue";
-
 //#region src/composables/createModel/index.d.ts
 /**
  * Input type for model tickets - what users provide to register().
@@ -29,7 +32,9 @@ interface ModelTicketInput<V = unknown> extends RegistryTicketInput<V> {
  * @template Z The input ticket type that extends ModelTicketInput.
  */
 type ModelTicket<Z extends ModelTicketInput = ModelTicketInput> = RegistryTicket & Z & {
-  /** Disabled state of the ticket (guaranteed to exist on output) */disabled: MaybeRefOrGetter<boolean>; /** Whether the ticket is currently selected */
+  /** Disabled state of the ticket (guaranteed to exist on output) */
+  disabled: MaybeRefOrGetter<boolean>;
+  /** Whether the ticket is currently selected */
   isSelected: Readonly<Ref<boolean, boolean>>;
 };
 /**
@@ -366,8 +371,11 @@ interface SelectionTicketInput<V = unknown> extends ModelTicketInput<V> {}
  * - `toggle()` - Method to toggle selection state
  */
 type SelectionTicket<Z extends SelectionTicketInput = SelectionTicketInput> = ModelTicket<Z> & {
-  /** Select self */select: () => void; /** Unselect self */
-  unselect: () => void; /** Toggle self on and off */
+  /** Select self */
+  select: () => void;
+  /** Unselect self */
+  unselect: () => void;
+  /** Toggle self on and off */
   toggle: () => void;
 };
 /**
@@ -641,9 +649,12 @@ interface OverflowOptions {
   /**
    * Container element to track. Can be a ref, getter, or MaybeRefOrGetter.
    * When provided, useOverflow tracks this element's width automatically.
-   * Accepts null for compatibility with Vue's useTemplateRef.
+   * Also accepts Vue `useTemplateRef` — Vue 3.5.42 wraps that in a deep
+   * `Readonly<Ref>` that is not assignable to `MaybeRefOrGetter`.
    */
-  container?: MaybeRefOrGetter<Element | null | undefined>;
+  container?: MaybeRefOrGetter<Element | null | undefined> | {
+    readonly value: unknown;
+  };
   /** Gap between items in pixels */
   gap?: MaybeRefOrGetter<number>;
   /** Reserved space in pixels (for nav buttons, ellipsis, etc) */
@@ -1044,8 +1055,11 @@ interface GroupTicketInput<V = unknown> extends SelectionTicketInput<V> {
  * 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 */
+  /** 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;
 };
 /**
@@ -1604,17 +1618,18 @@ declare function createPopoverFallback(): PopoverPluginContext;
  * import { FloatingUIPopoverAdapter } from '@vuetify/v0/popover/adapters/floating-ui'
  *
  * export const [useAppPopover, provideAppPopover, appPopover] = createPopoverContext({
- *   namespace: 'app:popover-plugin',
+ *   namespace: 'app:popover',
  *   adapter: new FloatingUIPopoverAdapter(),
  * })
  * ```
  *
  * Plugin trinity for an app-wide popover positioning adapter.
  *
- * Namespace is `v0:popover-plugin` — not `v0:popover`, which `Popover.Root`
- * already owns for compound context. The generated consumer is module-private;
- * `usePopover()` consults it internally. Fallback is `{ adapter: undefined }`,
- * so zero-config matches today's `V0PopoverAdapter` default.
+ * Namespace is `v0:popover`. Compound `Popover.Root` context lives at
+ * `v0:popover:root` so the two do not collide. The generated consumer is
+ * module-private; `usePopover()` consults it internally. Fallback is
+ * `{ adapter: undefined }`, so zero-config matches today's `V0PopoverAdapter`
+ * default.
  *
  * @example
  * ```ts
@@ -1689,7 +1704,7 @@ interface ClientComboboxAdapterOptions {
   /** Filter matching mode */
   mode?: FilterMode;
   /** Object keys to match against (for object values) */
-  keys?: string[];
+  keys?: MaybeRefOrGetter<readonly string[]>;
   /** Custom filter function — overrides default matching */
   filter?: (query: string, value: unknown) => boolean;
 }
@@ -2416,6 +2431,17 @@ interface ValidationOptions extends GroupOptions {
   rules?: RuleInput[];
   /** Value source for validate() when called without arguments. */
   value?: MaybeRefOrGetter<unknown>;
+  /**
+   * Form injection key. Must match the parent Form's `namespace`.
+   *
+   * @default 'v0:form'
+   *
+   * @example
+   * ```ts
+   * createValidation({ formNamespace: 'v0:billing' })
+   * ```
+   */
+  formNamespace?: string;
 }
 /**
  * Creates a per-input validation instance.
@@ -2578,7 +2604,16 @@ interface InputOptions<T = string> {
   name?: string;
   /** Associate with form by ID. */
   form?: string;
-  /** Whether required. */
+  /**
+   * Form injection key. Must match the parent Form's `namespace`.
+   *
+   * @default 'v0:form'
+   */
+  formNamespace?: string;
+  /**
+   * Whether required. When true, a presence rule is registered so Form
+   * submit fails on empty values even with `novalidate`.
+   */
   required?: boolean;
   /** Disabled state. */
   disabled?: MaybeRefOrGetter<boolean>;
@@ -3138,24 +3173,43 @@ interface NestedTicketInput<V = unknown> extends GroupTicketInput<V> {
  * @template Z The input ticket type that extends NestedTicketInput.
  */
 type NestedTicket<Z extends NestedTicketInput = NestedTicketInput> = GroupTicket<Z> & {
-  /** ID of the parent ticket, or undefined if this is a root item. Static — set at registration time. */parentId: ID | undefined; /** Reference to the DOM element for focus management */
-  el: MaybeRefOrGetter<Element | null | undefined> | undefined; /** Whether this ticket is currently open/expanded */
-  isOpen: Readonly<Ref<boolean>>; /** Whether this ticket is currently active/highlighted */
-  isActive: Readonly<Ref<boolean>>; /** Whether this ticket is a leaf node (has no children) */
-  isLeaf: Readonly<Ref<boolean>>; /** Depth in tree (0 = root) */
-  depth: Readonly<Ref<number>>; /** Open/expand this ticket */
-  open: () => void; /** Close/collapse this ticket */
-  close: () => void; /** Flip this ticket's open/closed state */
-  flip: () => void; /** Reveal this ticket by opening all ancestors */
-  reveal: () => void; /** Activate/highlight this ticket */
-  activate: () => void; /** Deactivate/unhighlight this ticket */
-  deactivate: () => void; /** Get path from root to self (includes self) */
-  getPath: () => ID[]; /** Get ancestors excluding self */
-  getAncestors: () => ID[]; /** Get all descendants */
-  getDescendants: () => ID[]; /** Check if this ticket is an ancestor of the given ID */
-  isAncestorOf: (descendantId: ID) => boolean; /** Check if this ticket has the given ID as an ancestor */
-  hasAncestor: (ancestorId: ID) => boolean; /** Get sibling IDs (including self) */
-  siblings: () => ID[]; /** Get 1-indexed position among siblings (for aria-posinset) */
+  /** ID of the parent ticket, or undefined if this is a root item. Static — set at registration time. */
+  parentId: ID | undefined;
+  /** Reference to the DOM element for focus management */
+  el: MaybeRefOrGetter<Element | null | undefined> | undefined;
+  /** Whether this ticket is currently open/expanded */
+  isOpen: Readonly<Ref<boolean>>;
+  /** Whether this ticket is currently active/highlighted */
+  isActive: Readonly<Ref<boolean>>;
+  /** Whether this ticket is a leaf node (has no children) */
+  isLeaf: Readonly<Ref<boolean>>;
+  /** Depth in tree (0 = root) */
+  depth: Readonly<Ref<number>>;
+  /** Open/expand this ticket */
+  open: () => void;
+  /** Close/collapse this ticket */
+  close: () => void;
+  /** Flip this ticket's open/closed state */
+  flip: () => void;
+  /** Reveal this ticket by opening all ancestors */
+  reveal: () => void;
+  /** Activate/highlight this ticket */
+  activate: () => void;
+  /** Deactivate/unhighlight this ticket */
+  deactivate: () => void;
+  /** Get path from root to self (includes self) */
+  getPath: () => ID[];
+  /** Get ancestors excluding self */
+  getAncestors: () => ID[];
+  /** Get all descendants */
+  getDescendants: () => ID[];
+  /** Check if this ticket is an ancestor of the given ID */
+  isAncestorOf: (descendantId: ID) => boolean;
+  /** Check if this ticket has the given ID as an ancestor */
+  hasAncestor: (ancestorId: ID) => boolean;
+  /** Get sibling IDs (including self) */
+  siblings: () => ID[];
+  /** Get 1-indexed position among siblings (for aria-posinset) */
   position: () => number;
 };
 /**
@@ -3165,7 +3219,8 @@ type NestedTicket<Z extends NestedTicketInput = NestedTicketInput> = GroupTicket
  * @template Z The input ticket type that extends NestedTicketInput.
  */
 type NestedRegistration<Z extends NestedTicketInput = NestedTicketInput> = Partial<Z> & {
-  /** Inline children to register with this item as parent */children?: NestedRegistration<Z>[];
+  /** Inline children to register with this item as parent */
+  children?: NestedRegistration<Z>[];
 };
 /**
  * Context for managing nested/hierarchical item collections.
@@ -3514,6 +3569,17 @@ interface NumberFieldOptions extends NumericOptions {
   label?: string;
   /** Form field name. */
   name?: string;
+  /**
+   * Form injection key. Must match the parent Form's `namespace`.
+   *
+   * @default 'v0:form'
+   */
+  formNamespace?: string;
+  /**
+   * Whether required. When true, a presence rule is registered so Form
+   * submit fails on empty values even with `novalidate`.
+   */
+  required?: boolean;
   /** Validation rules. */
   rules?: InputOptions<number | null>['rules'];
   /** Manual error state override — forces invalid. */
@@ -5761,6 +5827,14 @@ declare class KeyboardAdapter<Z extends DragType = DragType> extends DragDropAda
  * Layout axis a drop zone resolves indices along.
  */
 type Orientation = 'vertical' | 'horizontal';
+/**
+ * `MaybeRefOrGetter<T>` plus Vue 3.5.42 `useTemplateRef` / `shallowReadonly`
+ * results. Those wrap in a deep `Readonly<Ref<T>>` that is not assignable
+ * to `Ref<T>`.
+ */
+type MaybeReadonlyRefOrGetter<T> = MaybeRefOrGetter<T> | {
+  readonly value: unknown;
+};
 /**
  * Discriminated payload describing what is being dragged. Consumers extend
  * this with concrete `type` literals plus a matching `value`.
@@ -5903,8 +5977,8 @@ type ActiveDrag<Z extends DragType = DragType> = Z extends DragType ? {
 type DraggableTicketInput<Z extends DragType = DragType> = Z extends DragType ? RegistryTicketInput & {
   type: Z['type'];
   value: Z['value'];
-  el: MaybeRefOrGetter<HTMLElement | null>;
-  disabled?: MaybeRefOrGetter<boolean>;
+  el: MaybeReadonlyRefOrGetter<HTMLElement | null>;
+  disabled?: MaybeReadonlyRefOrGetter<boolean>;
   onBeforeStart?: (drag: ActiveDrag<Z>) => boolean | void;
   onMove?: (drag: ActiveDrag<Z>) => void;
   onCancel?: (drag: ActiveDrag<Z>, reason: 'cancel' | 'reject') => void;
@@ -5949,11 +6023,11 @@ type DraggableTicket<Z extends DragType = DragType> = Z extends DragType ? Regis
  * ```
  */
 interface DropZoneTicketInput<Z extends DragType = DragType> extends RegistryTicketInput {
-  el: MaybeRefOrGetter<HTMLElement | null>;
+  el: MaybeReadonlyRefOrGetter<HTMLElement | null>;
   /** Allowed drag types or a synchronous predicate. Async predicates (Promise / thenable returns) are rejected with a warning — `accept` must return synchronously. */
   accept?: Z['type'][] | ((drag: ActiveDrag<Z>) => boolean);
   orientation?: Orientation;
-  disabled?: MaybeRefOrGetter<boolean>;
+  disabled?: MaybeReadonlyRefOrGetter<boolean>;
   onEnter?: (drag: ActiveDrag<Z>) => void;
   onLeave?: (drag: ActiveDrag<Z>) => void;
   onBeforeDrop?: (drag: ActiveDrag<Z>, position: DropPosition) => boolean | void;
@@ -7041,18 +7115,31 @@ interface NotificationTicketInput extends RegistryTicketInput {
  * Returned by {@link send}, {@link register}, and {@link onboard}.
  */
 type NotificationTicket<Z extends NotificationTicketInput = NotificationTicketInput> = RegistryTicket & Z & {
-  /** When the notification was created. */createdAt: Date; /** When the notification was marked as read, or `null` if unread. */
-  readAt: Date | null; /** When the notification was seen in the viewport, or `null` if unseen. */
-  seenAt: Date | null; /** When the notification was archived, or `null` if active. */
-  archivedAt: Date | null; /** Snooze expiry, or `null` if not snoozed. */
-  snoozedUntil: Date | null; /** Mark as read. Sets `readAt` to now. */
-  read: () => void; /** Mark as unread. Clears `readAt`. */
-  unread: () => void; /** Mark as seen. Sets `seenAt` to now. */
-  seen: () => void; /** Archive. Sets `archivedAt` to now. */
-  archive: () => void; /** Restore from archive. Clears `archivedAt`. */
-  unarchive: () => void; /** Snooze until the given time. */
-  snooze: (until: Date) => void; /** Cancel snooze. Clears `snoozedUntil`. */
-  wake: () => void; /** Remove from the display queue only. Registry entry is preserved for inbox/history. Use `ticket.unregister()` for full removal. */
+  /** When the notification was created. */
+  createdAt: Date;
+  /** When the notification was marked as read, or `null` if unread. */
+  readAt: Date | null;
+  /** When the notification was seen in the viewport, or `null` if unseen. */
+  seenAt: Date | null;
+  /** When the notification was archived, or `null` if active. */
+  archivedAt: Date | null;
+  /** Snooze expiry, or `null` if not snoozed. */
+  snoozedUntil: Date | null;
+  /** Mark as read. Sets `readAt` to now. */
+  read: () => void;
+  /** Mark as unread. Clears `readAt`. */
+  unread: () => void;
+  /** Mark as seen. Sets `seenAt` to now. */
+  seen: () => void;
+  /** Archive. Sets `archivedAt` to now. */
+  archive: () => void;
+  /** Restore from archive. Clears `archivedAt`. */
+  unarchive: () => void;
+  /** Snooze until the given time. */
+  snooze: (until: Date) => void;
+  /** Cancel snooze. Clears `snoozedUntil`. */
+  wake: () => void;
+  /** Remove from the display queue only. Registry entry is preserved for inbox/history. Use `ticket.unregister()` for full removal. */
   dismiss: () => void;
 };
 /**
@@ -7189,6 +7276,36 @@ interface PermissionPluginOptions extends PermissionContextOptions {}
  */
 declare function createPermissions(_options?: PermissionOptions): PermissionContext;
 declare const createPermissionsContext: <_E extends PermissionContext<PermissionTicket> = PermissionContext<PermissionTicket>>(_options?: PermissionContextOptions | undefined) => ContextTrinity<_E>, createPermissionsPlugin: (_options?: PermissionContextOptions | undefined) => Plugin, usePermissions: <_E extends PermissionContext<PermissionTicket> = PermissionContext<PermissionTicket>>(namespace?: string) => _E;
+/**
+ * Creates a new permissions plugin.
+ *
+ * @param options The options for the permissions plugin.
+ * @template Z The type of the permission ticket.
+ * @template E The type of the permission context.
+ * @returns A new permissions plugin.
+ *
+ * @see https://0.vuetifyjs.com/composables/plugins/use-permissions
+ *
+ * @example
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { createPermissionsPlugin } from '@vuetify/v0'
+ * import App from './App.vue'
+ *
+ * const app = createApp(App)
+ *
+ * app.use(
+ *   createPermissionsPlugin({
+ *     permissions: {
+ *       admin: [['read', 'users']],
+ *       editor: [['edit', 'posts']],
+ *     },
+ *   })
+ * )
+ *
+ * app.mount('#app')
+ * ```
+ */
 //#endregion
 //#region src/composables/usePresence/index.d.ts
 type PresenceState = 'unmounted' | 'mounted' | 'present' | 'leaving';
@@ -7747,7 +7864,8 @@ type StackTicket<Z extends StackTicketInput = StackTicketInput> = SelectionTicke
   /**
    * Whether this overlay is backed by a scrim/backdrop
    */
-  scrim: Readonly<Ref<boolean>>; /** The overlay's DOM element, if provided at registration. */
+  scrim: Readonly<Ref<boolean>>;
+  /** The overlay's DOM element, if provided at registration. */
   el?: MaybeRefOrGetter<Element | null | undefined>;
   /**
    * The calculated z-index for this overlay

package/dist/{index-Di9e8sOm.d.mts → index-DDwX_0Um.d.mts}

@@ -1,9 +1,9 @@
-import { a as ID, i as Extensible } from "./index-DtiaWx5U.mjs";
-import { t as ContextTrinity } from "./index-H_hl6-4b.mjs";
-import { c as RegistryTicketInput, s as RegistryTicket, t as RegistryContext } from "./index-DSPkZ0ql.mjs";
-import { a as SortEntry, c as PaginationOptions, i as SortDirection, o as PaginationContext, t as DataTableAdapter, v as FilterOptions } from "./adapter-PDTe5nFT.mjs";
+import { a as ID, i as Extensible } from "./index-XNZrgWCq.mjs";
+import { t as ContextTrinity } from "./index-ClUa0Bl7.mjs";
+import { c as RegistryTicketInput, s as RegistryTicket, t as RegistryContext } from "./index-Y6VfllT2.mjs";
+import { a as SortEntry, c as PaginationOptions, i as SortDirection, o as PaginationContext, t as DataTableAdapter, v as FilterOptions } from "./adapter-BP7jNtvH.mjs";
+import "./index-DmDf_FmM.mjs";
 import { MaybeRefOrGetter, Ref, ShallowRef } from "vue";
-
 //#region src/composables/createDataTable/columns.d.ts
 /**
  * @module createDataTable/columns
@@ -222,7 +222,7 @@ interface DataTableOptions<T extends object> {
   openAll?: boolean;
   /** Allow multiple rows expanded simultaneously. @default true */
   expandMultiple?: boolean;
-  /** Locale for sorting (defaults to useLocale's selected locale or browser default) */
+  /** Locale for sorting. When set, wins over useLocale; otherwise useLocale or the browser default. */
   locale?: string;
   /** Pipeline adapter. @default ClientDataTableAdapter */
   adapter?: DataTableAdapter<T>;

package/dist/{index-DjRE4lLl.d.mts → index-DMQv04YO.d.mts}

@@ -1,5 +1,4 @@
-import { a as ID, c as V0ErrorCode, l as V0ErrorDetails, r as DeepPartial } from "./index-DtiaWx5U.mjs";
-
+import { a as ID, c as V0ErrorCode, l as V0ErrorDetails, r as DeepPartial } from "./index-XNZrgWCq.mjs";
 //#region src/utilities/color.d.ts
 interface RGB {
   r: number;
@@ -8,12 +7,7 @@ interface RGB {
   a?: number;
 }
 declare function hexToRgb(hex: string): RGB;
-declare function rgbToHex({
-  r,
-  g,
-  b,
-  a
-}: RGB): string;
+declare function rgbToHex({ r, g, b, a }: RGB): string;
 //#endregion
 //#region src/utilities/apca.d.ts
 declare function apca(text: RGB, background: RGB): number;
@@ -43,10 +37,15 @@ type MatchRange = readonly [number, number];
 /**
  * Which side of a comparison has its accents folded before matching.
  *
- * - `'query'` — only the query, so typing `café` finds plain `cafe`
- * - `'target'` — only the text, so typing `cafe` finds accented `café`
- * - `true` — both sides
- * - `false` — neither
+ * - `'query'` — folds the query, so typing `café` finds plain `cafe`
+ * - `'target'` — folds the text, so typing `cafe` finds accented `café`
+ * - `true` — both sides fold, so any accent variant matches any other
+ * - `false` — neither folds, exact match only
+ *
+ * `'query'` and `'target'` fold only one side, but a spelling that already
+ * agrees on both sides still matches verbatim — folding one side never
+ * hides a match the other side already has. They still don't fold each
+ * other's accents together, so `café` won't match `cafè` under either.
  */
 type IgnoreAccents = boolean | 'query' | 'target';
 interface FindMatchRangesOptions {
@@ -59,6 +58,11 @@ interface FindMatchRangesOptions {
  * folding accents on either side. Returned indices always address the original
  * `text`, even when folding or case-conversion changed its length.
  *
+ * Directional folding (`'query'` or `'target'`) only transforms one side, but
+ * a spelling that's already identical on both sides — accents and all — is
+ * merged in verbatim, so folding one side never hides a match the other side
+ * already has.
+ *
  * @param text The string to search.
  * @param query The term to look for. An empty query yields no ranges.
  * @param options Optional `ignoreCase`, `ignoreAccents`, `matchAll`.
@@ -73,6 +77,9 @@ interface FindMatchRangesOptions {
  *
  * findMatchRanges('Łódź', 'Lo', { ignoreAccents: 'target' })
  * // [[0, 2]]
+ *
+ * findMatchRanges('… Kraków …', 'Kraków', { ignoreAccents: 'query' })
+ * // [[2, 8]] — typing the exact accented name always finds itself
  * ```
  */
 declare function findMatchRanges(text: string, query: string, options?: FindMatchRangesOptions): MatchRange[];

package/dist/{index-D0ub61GV.d.mts → index-Dlr9_rf1.d.mts}

@@ -1,6 +1,5 @@
-import { t as ContextTrinity } from "./index-H_hl6-4b.mjs";
-import { n as RegistryContextOptions, o as RegistryOptions, s as RegistryTicket, t as RegistryContext } from "./index-DSPkZ0ql.mjs";
-
+import { t as ContextTrinity } from "./index-ClUa0Bl7.mjs";
+import { n as RegistryContextOptions, o as RegistryOptions, s as RegistryTicket, t as RegistryContext } from "./index-Y6VfllT2.mjs";
 //#region src/composables/createTokens/index.d.ts
 interface TokenAlias<T = unknown> {
   [key: string]: unknown;

package/dist/index-DmDf_FmM.d.mts

@@ -0,0 +1,4 @@
+import "./adapter-BP7jNtvH.mjs";
+import "./server-bE0UxPFS.mjs";
+import "./v0-CMqoGujd.mjs";
+import "./virtual-DrLIdUr1.mjs";