npm - @wow-two-beta/ui-vue - Versions diffs - 0.0.5 → 0.0.6 - Mend

@wow-two-beta/ui-vue 0.0.5 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2101) hide show

package/dist/query/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sources":["../../src/query/ToApiError.ts","../../src/query/CreateQueryClient.ts","../../src/query/QueryProvider.vue","../../src/query/Endpoints.ts","../../src/query/UseAppQuery.ts","../../src/query/UseAppInfiniteQuery.ts","../../src/query/UseAppMutation.ts","../../src/query/UseOptimisticMutation.ts","../../src/query/UseAppQueries.ts","../../src/query/UseAppPaginatedQuery.ts","../../src/query/PageHelpers.ts","../../src/query/UseAppLazyQuery.ts","../../src/query/UseQueryCache.ts","../../src/query/UsePrefetchQuery.ts","../../src/query/UseAppSuspenseQuery.ts","../../src/query/QueryProgressBridge.ts","../../src/query/Devtools.vue","../../src/query/Persistence.ts"],"sourcesContent":["import { getErrorMessage } from '../foundation/errors';\nimport { ApiError } from '../foundation/http';\n\n/*\n Coerces any thrown value into the SDK `ApiError` — passes through an `ApiError`, wraps everything\n * else as status `0` (network / unknown) with the message `getErrorMessage` reads off it, so an\n * `Error` from another realm (iframe · worker) keeps its message instead of failing `instanceof`.\n /\nexport function toApiError(error: unknown): ApiError {\n if (error instanceof ApiError) return error;\n return new ApiError(0, null, getErrorMessage(error, 'Unknown error'));\n}\n","import { CancelledError, MutationCache, QueryCache, QueryClient } from '@tanstack/vue-query';\n\nimport { isAbortError } from '../foundation/errors';\nimport type { ApiError } from '../foundation/http';\n\nimport { computeRetryDelay, DefaultRetryPolicy, shouldRetry, type RetryPolicy } from '../foundation/resilience';\n\nimport { toApiError } from './ToApiError';\n\nconst StaleTimeMs = 30_000;\nconst GcTimeMs = 5 60_000;\n\n/*\n Checks for a cancellation — TanStack's own `CancelledError`, or the native `AbortError` a queryFn\n * rethrows when its signal aborts outside the library (the transport client deliberately never wraps\n * aborts). A cancellation is intent, not failure: it must neither retry (`toApiError` maps it to\n * status `0`, which the transient set would otherwise retry) nor reach the global `onError` toast.\n /\nfunction isCancellation(error: unknown): boolean {\n return error instanceof CancelledError \|\| isAbortError(error);\n}\n\n/* The metadata bag a hook's `meta` option attaches to its query/mutation — free-form keys, read back by the global error seam. `suppressGlobalError: true` keeps that call's failures out of the global `onError` (per-query opt-out for polling / boundary-handled errors). /\nexport type AppQueryMeta = Record<string, unknown>;\n\n/* Carries the failing query's / mutation's context into the global `onError`. /\nexport interface QueryErrorContext {\n /* The `meta` attached at the call site, or `undefined` when none was set. /\n readonly meta: AppQueryMeta \| undefined;\n}\n\n/* Defines options for `createQueryClient`. /\nexport interface CreateQueryClientOptions {\n /* Emits a coerced `ApiError` whenever any query or mutation fails — wire a toast here (`feedbackQueryErrors()` from `/feedback` fits directly). Cancellations and calls whose `meta` sets `suppressGlobalError: true` are skipped; `context.meta` carries the call's `meta` for app-side filtering. /\n readonly onError?: (error: ApiError, context: QueryErrorContext) => void;\n\n /* The retry policy for transient query failures (backoff · jitter · retryable statuses). Default `DefaultRetryPolicy`. Mutations never retry; `onRetry` is transport-level only — the TanStack retry seam has no pre-retry hook, so it is not invoked here. /\n readonly retry?: RetryPolicy;\n}\n\n/* Creates the app `QueryClient` — house defaults (30s stale · 5m gc · no focus-refetch · mutations no-retry) + a configurable `RetryPolicy` + global error coercion to `ApiError`. /\nexport function createQueryClient(options: CreateQueryClientOptions = {}): QueryClient {\n const handleError = (error: unknown, meta: AppQueryMeta \| undefined): void => {\n if (isCancellation(error)) return;\n if (meta?.suppressGlobalError === true) return;\n options.onError?.(toApiError(error), { meta });\n };\n const policy = options.retry ?? DefaultRetryPolicy;\n\n return new QueryClient({\n queryCache: new QueryCache({ onError: (error, query) => handleError(error, query.meta) }),\n mutationCache: new MutationCache({\n onError: (error, _variables, _context, mutation) => handleError(error, mutation.meta),\n }),\n defaultOptions: {\n queries: {\n staleTime: StaleTimeMs,\n gcTime: GcTimeMs,\n refetchOnWindowFocus: false,\n retry: (failureCount, error) =>\n !isCancellation(error) && shouldRetry(policy, failureCount, toApiError(error).status),\n retryDelay: (attemptIndex) => computeRetryDelay(policy, attemptIndex + 1),\n },\n mutations: { retry: 0 },\n },\n });\n}\n","<script lang=\"ts\">\nimport type { QueryClient } from '@tanstack/vue-query';\n\n/* Defines the props for {@link QueryProvider}. /\nexport interface QueryProviderProps {\n /* The app `QueryClient` (from `createQueryClient`). /\n client: QueryClient;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { onMounted, onUnmounted, provide } from 'vue';\n// `QueryClient` is already imported as a TYPE by the plain `<script>` block above — the two blocks\n// compile into ONE module, so only the injection-key VALUE comes in here.\nimport { VUE_QUERY_CLIENT } from '@tanstack/vue-query';\n\n/\n Mounts the app `QueryClient` above its subtree.\n \n `@tanstack/vue-query` ships no `QueryClientProvider` component — it installs as an app plugin\n * (`queryPlugin`). This is the component form React had, rebuilt on the same injection key the\n * library's own `useQueryClient()` reads, so every hook in this module works underneath it. Use it\n * when a SUBTREE (or a test) needs its own client; use `queryPlugin` for the whole app.\n \n `client.mount()` runs from `onMounted`, which never executes on the server — the plugin skips it\n * there for the same reason: mounting subscribes the focus / online managers to browser globals.\n \n Renders no element of its own — the slot passes straight through.\n /\ndefineOptions({ name: 'QueryProvider' });\n\ndefineSlots<{\n /* The subtree with access to the client. /\n default(): unknown;\n}>();\n\nconst props = defineProps<QueryProviderProps>();\n\nprovide(VUE_QUERY_CLIENT, props.client);\n\nonMounted(() => props.client.mount());\nonUnmounted(() => props.client.unmount());\n</script>\n\n<template>\n <slot />\n</template>\n","// Typed endpoint definitions — the generic core of a query-factory registry (the data-layer\n// `definePath`). An app declares per-resource factories over `defineEndpoint`\n// (`const codesApi = { list: (q?: string) => defineEndpoint({ key: …, queryFn: … }) }`); this module\n// owns only the typing core — key + fetcher declared once, together, so the pairing can never desync.\n// A def is a plain `{ key, queryFn }`: it spreads into `useAppQuery` / `useAppSuspenseQuery` /\n// `useAppLazyQuery`, feeds `usePrefetchQuery` / `prefetchProps` / `useQueryCache().prefetch` whole,\n// and pairs with a bare `QueryClient` (`fetchQuery({ queryKey: def.key, queryFn: def.queryFn })`).\n// Mutations stay plain client calls into `useAppMutation` — no def shape for writes (an\n// `useOptimisticMutation` target may reuse a def's `key` to locate the cached read it patches).\n\nimport type { QueryKey } from '@tanstack/vue-query';\n\n/* Defines a typed endpoint — a query key fused with the fetcher that fills it. /\nexport interface Endpoint<TRaw> {\n /* The query key this endpoint caches under — the same key every consuming surface reads. /\n readonly key: QueryKey;\n\n /* Fetches the raw payload; receives the abort signal so the request cancels with the query. /\n readonly queryFn: (context: { signal: AbortSignal }) => Promise<TRaw>;\n}\n\n/* Defines a parameterized endpoint factory — call with the endpoint's args for a def keyed to them. /\nexport type EndpointFn<TArgs extends readonly unknown[], TRaw> = (...args: TArgs) => Endpoint<TRaw>;\n\n/* Creates a typed endpoint definition — constrains the shape, infers `TRaw` from the fetcher, and returns the def unchanged (pure typing; deleting the call leaves valid code). /\nexport function defineEndpoint<TRaw>(endpoint: Endpoint<TRaw>): Endpoint<TRaw> {\n return endpoint;\n}\n","import { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQuery, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiError } from '../foundation/http';\n\nimport type { AppQueryMeta } from './CreateQueryClient';\nimport { toApiError } from './ToApiError';\n\n/* Defines options for `useAppQuery` — `TRaw` first so it infers from `queryFn` (a spread def) and `TData` defaults to it when `map` is absent. /\nexport interface UseAppQueryOptions<TRaw, TData = TRaw> {\n /* The cache key (from `queryKeys`). A ref or getter re-keys the query reactively — React re-ran the hook instead. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches the raw payload; receives the `AbortSignal` so the request cancels on unmount. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<TRaw>;\n\n /* Maps the raw payload to the domain shape — identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n\n /* Gates the query — skips fetching while `false`. A ref or getter toggles it reactively. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n\n /* Metadata surfaced to the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out of it. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a single-resource query's slice — every member reactive. /\nexport interface UseAppQueryReturn<TData> {\n /* The mapped domain payload, or `undefined` until it resolves. /\n readonly data: Ref<TData \| undefined>;\n\n /* True while there is no data yet and a fetch is in flight. /\n readonly loading: ComputedRef<boolean>;\n\n /* The failure coerced to `ApiError`, or `null`. /\n readonly error: ComputedRef<ApiError \| null>;\n\n /* Refetches the query. /\n readonly refetch: () => unknown;\n}\n\n/\n Manages a single-resource query — wraps `useQuery`, maps raw→domain via `select`, and coerces\n * failures to `ApiError`.\n \n Returns REFS, not values: `@tanstack/vue-query` hands back a ref per field, and a composable that\n * unwrapped them would freeze at the first render. Read `data.value` (or bind `data` in a template).\n /\nexport function useAppQuery<TRaw, TData = TRaw>({\n key,\n queryFn,\n map,\n enabled,\n meta,\n}: UseAppQueryOptions<TRaw, TData>): UseAppQueryReturn<TData> {\n // A getter for the WHOLE options object: `key` and `enabled` are `MaybeRefOrGetter`, and this is\n // the one form that re-evaluates every one of them together on each dependency change.\n const query = useQuery<TRaw, Error, TData, QueryKey>(() => ({\n queryKey: toValue(key),\n queryFn: ({ signal }) => queryFn({ signal }),\n select: map ?? ((raw: TRaw) => raw as unknown as TData),\n enabled: toValue(enabled),\n meta,\n }));\n\n return {\n data: query.data,\n loading: computed(() => query.isPending.value && query.isFetching.value),\n error: computed(() => (query.error.value ? toApiError(query.error.value) : null)),\n refetch: query.refetch,\n };\n}\n","import { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useInfiniteQuery, type InfiniteData, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiError } from '../foundation/http';\n\nimport type { AppQueryMeta } from './CreateQueryClient';\nimport { toApiError } from './ToApiError';\n\n/* Defines options for `useAppInfiniteQuery`. /\nexport interface UseAppInfiniteQueryOptions<TItem, TPage> {\n /* The cache key (from `queryKeys`). /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches one page for `pageParam`; receives the `AbortSignal`. /\n readonly queryFn: (ctx: { pageParam: unknown; signal: AbortSignal }) => Promise<TPage>;\n\n /* Derives the next page's param from the last page — return `undefined`/`null` to stop. /\n readonly getNextPageParam: (lastPage: TPage, allPages: readonly TPage[]) => unknown;\n\n /* The param for the first page. /\n readonly initialPageParam: unknown;\n\n /* Extracts items from a page — the page itself is the item array when omitted. /\n readonly mapPage?: (page: TPage) => readonly TItem[];\n\n /* Poll interval in ms, or a fn of the current items → ms / `false` (poll-while-running). /\n readonly refetchInterval?: number \| ((items: readonly TItem[]) => number \| false);\n\n /* Gates the query — skips fetching while `false`. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n\n /* Metadata surfaced to the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out of it (e.g. polls that would otherwise toast per failed refetch). /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents an infinite query's slice — every member reactive. /\nexport interface UseAppInfiniteQueryReturn<TItem> {\n /* Every fetched page flattened to items. /\n readonly items: ComputedRef<readonly TItem[]>;\n\n /* True while there is no page yet and a fetch is in flight. /\n readonly loading: ComputedRef<boolean>;\n\n /* The failure coerced to `ApiError`, or `null`. /\n readonly error: ComputedRef<ApiError \| null>;\n\n /* Whether another page can be fetched. /\n readonly hasNextPage: Ref<boolean>;\n\n /* Fetches the next page. /\n readonly fetchNextPage: (...args: never[]) => unknown;\n\n /* True while the next page is in flight. /\n readonly isFetchingNextPage: Ref<boolean>;\n\n /* Refetches every fetched page. /\n readonly refetch: () => unknown;\n}\n\n/* Manages a paginated resource — wraps `useInfiniteQuery`, flattens pages to items, and supports poll-while-running. /\nexport function useAppInfiniteQuery<TItem, TPage>({\n key,\n queryFn,\n getNextPageParam,\n initialPageParam,\n mapPage,\n refetchInterval,\n enabled,\n meta,\n}: UseAppInfiniteQueryOptions<TItem, TPage>): UseAppInfiniteQueryReturn<TItem> {\n // React memoized this with `useCallback` so the `useMemo` below did not re-run each render; Vue\n // recomputes only when a tracked dependency changes, so a plain closure is enough.\n const extract = (page: TPage): readonly TItem[] =>\n mapPage ? mapPage(page) : (page as unknown as readonly TItem[]);\n\n const query = useInfiniteQuery<TPage, Error, InfiniteData<TPage, unknown>, QueryKey, unknown>(() => ({\n queryKey: toValue(key),\n queryFn: ({ pageParam, signal }) => queryFn({ pageParam, signal }),\n getNextPageParam,\n initialPageParam,\n enabled: toValue(enabled),\n meta,\n refetchInterval:\n refetchInterval === undefined\n ? undefined\n : (query_) => {\n if (typeof refetchInterval === 'number') return refetchInterval;\n const current = (query_.state.data?.pages ?? []).flatMap((page) => [...extract(page)]);\n return refetchInterval(current);\n },\n }));\n\n return {\n items: computed(() => (query.data.value?.pages ?? []).flatMap((page) => [...extract(page)])),\n loading: computed(() => query.isPending.value && query.isFetching.value),\n error: computed(() => (query.error.value ? toApiError(query.error.value) : null)),\n hasNextPage: query.hasNextPage,\n fetchNextPage: query.fetchNextPage,\n isFetchingNextPage: query.isFetchingNextPage,\n refetch: query.refetch,\n };\n}\n","import { computed, type ComputedRef, type Ref } from 'vue';\nimport { useMutation, useQueryClient, type QueryClient, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiError } from '../foundation/http';\n\nimport type { AppQueryMeta } from './CreateQueryClient';\nimport { toApiError } from './ToApiError';\n\n/* Defines options for `useAppMutation`. /\nexport interface UseAppMutationOptions<TData, TVars> {\n /* Performs the mutation against the backend. /\n readonly mutationFn: (vars: TVars) => Promise<TData>;\n\n /* Query keys to invalidate on success — derived from the vars and the server's returned value. /\n readonly invalidates?: (vars: TVars, data: TData) => readonly QueryKey[];\n\n /* Reconciles the cache from the server's confirmed result (e.g. `setQueryData`) after invalidation. /\n readonly onConfirmed?: (data: TData, vars: TVars, queryClient: QueryClient) => void;\n\n /* Metadata surfaced to the global `onError` seam — `suppressGlobalError: true` keeps this mutation's failures out of it. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a mutation's slice — state as refs, commands as plain functions. /\nexport interface UseAppMutationReturn<TData, TVars> {\n /* Fires the mutation, fire-and-forget. /\n readonly mutate: (vars: TVars) => void;\n\n /* Fires the mutation and resolves with its result. /\n readonly mutateAsync: (vars: TVars) => Promise<TData>;\n\n /* The last successful result. /\n readonly data: Ref<TData \| undefined>;\n\n /* True while the mutation is in flight. /\n readonly loading: Ref<boolean>;\n\n /* The failure coerced to `ApiError`, or `null`. /\n readonly error: ComputedRef<ApiError \| null>;\n\n /* Clears the mutation back to idle. /\n readonly reset: () => void;\n}\n\n/* Manages a passive mutation — reconciles the cache only from the backend-confirmed result; no optimistic update, no rollback. /\nexport function useAppMutation<TData, TVars>({\n mutationFn,\n invalidates,\n onConfirmed,\n meta,\n}: UseAppMutationOptions<TData, TVars>): UseAppMutationReturn<TData, TVars> {\n const queryClient = useQueryClient();\n\n const mutation = useMutation<TData, Error, TVars>({\n mutationFn,\n meta,\n onSuccess: async (data, vars) => {\n const keys = invalidates?.(vars, data) ?? [];\n await Promise.all(keys.map((queryKey) => queryClient.invalidateQueries({ queryKey })));\n onConfirmed?.(data, vars, queryClient);\n },\n });\n\n return {\n mutate: mutation.mutate,\n mutateAsync: mutation.mutateAsync,\n data: mutation.data,\n loading: mutation.isPending,\n error: computed(() => (mutation.error.value ? toApiError(mutation.error.value) : null)),\n reset: mutation.reset,\n };\n}\n","import { computed } from 'vue';\nimport { useMutation, useQueryClient, type QueryKey } from '@tanstack/vue-query';\n\nimport type { Endpoint } from './Endpoints';\nimport { toApiError } from './ToApiError';\nimport type { UseAppMutationReturn } from './UseAppMutation';\n\n/* Defines one cached query an optimistic mutation patches — where it lives and how it changes. /\nexport interface OptimisticTarget<TVars, TCached = unknown> {\n /* Locates the cached entry to patch — a query key, or an endpoint def (patched at its `key`). /\n readonly key: QueryKey \| Endpoint<TCached>;\n\n /\n Produces the next cached value from the current one and the mutation vars — pure, no side effects.\n * `current` is `undefined` when the key holds no data yet; returning a value then seeds the entry\n * (and rollback removes the seed).\n /\n // Method syntax on purpose: its bivariant parameters let targets of different `TCached` shapes\n // (each annotating its own `current`) share one `targets` array typed `OptimisticTarget<TVars>[]`.\n apply(current: TCached \| undefined, vars: TVars): TCached;\n}\n\n/* Defines options for `useOptimisticMutation`. /\nexport interface UseOptimisticMutationOptions<TData, TVars> {\n /* Performs the mutation against the backend. /\n readonly mutationFn: (vars: TVars) => Promise<TData>;\n\n /* The cached queries this mutation patches — each is cancelled, snapshotted, and applied before the request fires, then rolled back on error. /\n readonly targets: readonly OptimisticTarget<TVars>[];\n\n /* Invalidates every target key once the mutation settles (success or error) so the server truth reconciles the patch — `true` when omitted. /\n readonly invalidateOnSettle?: boolean;\n}\n\n/* A per-target snapshot taken before the patch — the unit of rollback. /\ninterface TargetSnapshot {\n readonly queryKey: QueryKey;\n readonly previous: unknown;\n}\n\n/* Resolves a target locator to its query key — unwraps an endpoint def, passes a bare key through. /\nfunction resolveKey(key: QueryKey \| Endpoint<unknown>): QueryKey {\n return 'queryFn' in key ? key.key : key;\n}\n\n/* Manages an optimistic mutation — the canonical TanStack v5 flow in the house shape: cancel + snapshot + patch every target on mutate, roll the patches back on error, reconcile with the server on settle. `useAppMutation` stays the passive default. /\nexport function useOptimisticMutation<TData, TVars>({\n mutationFn,\n targets,\n invalidateOnSettle = true,\n}: UseOptimisticMutationOptions<TData, TVars>): UseAppMutationReturn<TData, TVars> {\n const queryClient = useQueryClient();\n\n const mutation = useMutation<TData, Error, TVars, readonly TargetSnapshot[]>({\n mutationFn,\n onMutate: async (vars) => {\n // Cancel in-flight fetches first so a late server response can't clobber the patch.\n await Promise.all(\n targets.map((target) => queryClient.cancelQueries({ queryKey: resolveKey(target.key) })),\n );\n\n // Snapshot, then patch. A later mutation on the same key snapshots this patch — rollbacks chain.\n return targets.map((target) => {\n const queryKey = resolveKey(target.key);\n const previous = queryClient.getQueryData(queryKey);\n queryClient.setQueryData(queryKey, () => target.apply(previous, vars));\n return { queryKey, previous };\n });\n },\n onError: (_error, _vars, snapshots) => {\n // Restore each target exactly — a seeded entry (no previous) is removed, since `setQueryData(key, undefined)` is ignored.\n for (const { queryKey, previous } of snapshots ?? []) {\n if (previous === undefined) queryClient.removeQueries({ queryKey, exact: true });\n else queryClient.setQueryData(queryKey, () => previous);\n }\n },\n onSettled: async () => {\n if (!invalidateOnSettle) return;\n await Promise.all(\n targets.map((target) => queryClient.invalidateQueries({ queryKey: resolveKey(target.key) })),\n );\n },\n });\n\n return {\n mutate: mutation.mutate,\n mutateAsync: mutation.mutateAsync,\n data: mutation.data,\n loading: mutation.isPending,\n error: computed(() => (mutation.error.value ? toApiError(mutation.error.value) : null)),\n reset: mutation.reset,\n };\n}\n","import { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQueries, type QueryKey, type QueryObserverResult } from '@tanstack/vue-query';\n\nimport type { ApiError } from '../foundation/http';\n\nimport { toApiError } from './ToApiError';\n\n/* Defines one entry in a parallel `useAppQueries` batch — `TRaw` first so it infers from `queryFn` (a spread def) and `TData` defaults to it when `map` is absent. /\nexport interface AppQueriesEntry<TRaw, TData = TRaw> {\n /* The cache key (from `queryKeys`). /\n readonly key: QueryKey;\n\n /* Fetches this entry's raw payload; receives the `AbortSignal` so the request cancels on unmount. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<TRaw>;\n\n /* Maps the raw payload to the domain shape — identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n}\n\n/* Represents one entry's slice of a `useAppQueries` batch. /\nexport interface AppQueryResult<TData> {\n /* The mapped domain payload, or `undefined` until this entry resolves. /\n readonly data: TData \| undefined;\n\n /* True while this entry has no data yet and a fetch is in flight. /\n readonly loading: boolean;\n\n /* This entry's failure coerced to `ApiError`, or `null`. /\n readonly error: ApiError \| null;\n}\n\n/* Defines options for `useAppQueries`. /\nexport interface UseAppQueriesOptions<TRaw, TData = TRaw> {\n /* The queries to run in parallel — the count may vary. A ref or getter re-builds the batch reactively. /\n readonly queries: MaybeRefOrGetter<readonly AppQueriesEntry<TRaw, TData>[]>;\n\n /* Gates the whole batch — skips fetching every entry while `false`. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n}\n\n/* Represents a parallel batch's aggregated slice — every member reactive. /\nexport interface UseAppQueriesReturn<TData> {\n /* One slice per entry, in the order they were given. /\n readonly results: ComputedRef<readonly AppQueryResult<TData>[]>;\n\n /* Just the payloads, positionally aligned with the entries. /\n readonly data: ComputedRef<readonly (TData \| undefined)[]>;\n\n /* True while any entry is still loading. /\n readonly loading: ComputedRef<boolean>;\n\n /* Every entry's failure, coerced. /\n readonly errors: ComputedRef<readonly ApiError[]>;\n}\n\n/* Manages a dynamic batch of parallel queries — wraps `useQueries`, maps each raw→domain, and aggregates loading/errors. /\nexport function useAppQueries<TRaw, TData = TRaw>({\n queries,\n enabled,\n}: UseAppQueriesOptions<TRaw, TData>): UseAppQueriesReturn<TData> {\n // `useQueries` types its result off a tuple of per-entry option types; a homogeneous, run-time\n // sized array cannot be expressed that way, so the result is asserted — the same widening the\n // React original applied to `UseQueryResult<TData, Error>[]`.\n const results = useQueries({\n queries: computed(() =>\n toValue(queries).map((entry) => ({\n queryKey: entry.key,\n queryFn: ({ signal }: { signal: AbortSignal }) => entry.queryFn({ signal }),\n select: entry.map ?? ((raw: TRaw) => raw as unknown as TData),\n enabled: toValue(enabled),\n })),\n ),\n }) as unknown as Ref<readonly QueryObserverResult<TData, Error>[]>;\n\n const mapped = computed<readonly AppQueryResult<TData>[]>(() =>\n results.value.map((query) => ({\n data: query.data,\n loading: query.isPending && query.isFetching,\n error: query.error ? toApiError(query.error) : null,\n })),\n );\n\n return {\n results: mapped,\n data: computed(() => mapped.value.map((result) => result.data)),\n loading: computed(() => mapped.value.some((result) => result.loading)),\n errors: computed(() => mapped.value.flatMap((result) => (result.error ? [result.error] : []))),\n };\n}\n","import { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { keepPreviousData, useQuery, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiError } from '../foundation/http';\n\nimport type { AppQueryMeta } from './CreateQueryClient';\nimport { toApiError } from './ToApiError';\n\n/* Defines options for `useAppPaginatedQuery`. /\nexport interface UseAppPaginatedQueryOptions<TItem, TPage> {\n /* The base cache key (from `queryKeys`) — the active `page` is appended to form the per-page key. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches one page; receives the controlled `page` and the `AbortSignal`. /\n readonly queryFn: (ctx: { page: number; signal: AbortSignal }) => Promise<TPage>;\n\n /* The controlled page index — the caller owns it; changing it loads that page. A ref or getter drives it reactively (React re-rendered instead). /\n readonly page: MaybeRefOrGetter<number>;\n\n /* Extracts items from a page — the page itself is the item array when omitted. /\n readonly mapPage?: (page: TPage) => readonly TItem[];\n\n /* Gates the query — skips fetching while `false`. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n\n /* Metadata surfaced to the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out of it. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a page/offset paginated query's slice — every member reactive. /\nexport interface UseAppPaginatedQueryReturn<TItem, TPage> {\n /* The current page's items. /\n readonly items: ComputedRef<readonly TItem[]>;\n\n /* The raw page as fetched (`TPage`) — total count / page count / `hasMore` live here; `undefined` until the first page resolves. While `isPlaceholder`, it is the held previous page. /\n readonly page: Ref<TPage \| undefined>;\n\n /* True while there is no page yet and a fetch is in flight. /\n readonly loading: ComputedRef<boolean>;\n\n /* The failure coerced to `ApiError`, or `null`. /\n readonly error: ComputedRef<ApiError \| null>;\n\n /* True while the held previous page is being shown during a page change. /\n readonly isPlaceholder: Ref<boolean>;\n\n /* Refetches the active page. /\n readonly refetch: () => unknown;\n}\n\n/* Manages page/offset pagination — wraps `useQuery` with `keepPreviousData` so the list holds steady between pages. /\nexport function useAppPaginatedQuery<TItem, TPage>({\n key,\n queryFn,\n page,\n mapPage,\n enabled,\n meta,\n}: UseAppPaginatedQueryOptions<TItem, TPage>): UseAppPaginatedQueryReturn<TItem, TPage> {\n const query = useQuery<TPage, Error, TPage, QueryKey>(() => ({\n queryKey: [...toValue(key), toValue(page)],\n queryFn: ({ signal }) => queryFn({ page: toValue(page), signal }),\n placeholderData: keepPreviousData,\n enabled: toValue(enabled),\n meta,\n }));\n\n const items = computed<readonly TItem[]>(() => {\n const data = query.data.value;\n if (data === undefined) return [];\n return mapPage ? mapPage(data) : (data as unknown as readonly TItem[]);\n });\n\n return {\n items,\n page: query.data,\n loading: computed(() => query.isPending.value && query.isFetching.value),\n error: computed(() => (query.error.value ? toApiError(query.error.value) : null)),\n isPlaceholder: query.isPlaceholderData,\n refetch: query.refetch,\n };\n}\n","import type { IHasItems, TokenPage } from '../foundation/http';\n\n// Ergonomic glue between the `foundation/http` pagination contracts (`Page` / `TokenPage`) and the\n// paging hooks — fully additive, so a product binding `TPage = Page<T>` / `TokenPage<T>` drops the\n// hand-written `getNextPageParam` / `mapPage` boilerplate.\n\n/\n A ready `getNextPageParam` for `useAppInfiniteQuery` over `TokenPage` pages — reads `nextPageToken`,\n * returning `undefined` on the last page (an absent token stops paging).\n \n `useAppInfiniteQuery<TItem, TokenPage<TItem>>({ getNextPageParam: byPageToken<TItem>(), … })`\n /\nexport function byPageToken<TItem, TToken = string>(): (lastPage: TokenPage<TItem, TToken>) => TToken \| undefined {\n return (lastPage) => lastPage.nextPageToken;\n}\n\n/* A ready `mapPage` for any `IHasItems` page — pass `mapPage: pageItems` instead of `(p) => p.items`. /\nexport function pageItems<T>(page: IHasItems<T>): readonly T[] {\n return page.items;\n}\n","import { shallowRef, toValue, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQueryClient, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiError } from '../foundation/http';\n\nimport type { AppQueryMeta } from './CreateQueryClient';\nimport { toApiError } from './ToApiError';\n\n/* Defines options for `useAppLazyQuery` — `TRaw` first so it infers from `queryFn` (a spread def) and `TData` defaults to it when `map` is absent. /\nexport interface UseAppLazyQueryOptions<TRaw, TData = TRaw> {\n /* The cache key (from `queryKeys`) — read at each `fetch()`, so a ref or getter re-keys the next call. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches the raw payload; receives the `AbortSignal`. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<TRaw>;\n\n /* Maps the raw payload to the domain shape — identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n\n /* Metadata surfaced to the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out of it. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents an imperative query's slice — state as refs, plus the two commands. /\nexport interface UseAppLazyQueryReturn<TData> {\n /* The mapped payload from the latest settled `fetch()`, or `undefined` while idle. /\n readonly data: Ref<TData \| undefined>;\n\n /* True while a `fetch()` is in flight. /\n readonly loading: Ref<boolean>;\n\n /* The latest failure coerced to `ApiError`, or `null`. /\n readonly error: Ref<ApiError \| null>;\n\n /* Runs the request on demand; resolves the mapped data and rejects with the raw error. /\n readonly fetch: () => Promise<TData>;\n\n /* Returns the hook to its idle state and orphans any in-flight call. /\n readonly reset: () => void;\n}\n\n/\n Manages an imperative query — does not fetch on mount; `fetch()` runs the request on demand,\n * caching by key via the client (which dedupes concurrent calls and serves a still-fresh cache entry\n * without refetching — the client's `staleTime` window applies). Drives local `data`/`loading`/`error`\n * state with latest-call-wins semantics: a slower earlier `fetch()` (or one orphaned by `reset`) never\n * overwrites newer state, though every call's promise still settles with its own outcome. `fetch()`\n * resolves the mapped data and rejects with the raw error, while `error` holds the coerced `ApiError`.\n * For fetch-on-submit / export-on-click flows. `reset` returns it to the idle state.\n /\nexport function useAppLazyQuery<TRaw, TData = TRaw>({\n key,\n queryFn,\n map,\n meta,\n}: UseAppLazyQueryOptions<TRaw, TData>): UseAppLazyQueryReturn<TData> {\n const client = useQueryClient();\n\n const data = shallowRef<TData \| undefined>(undefined);\n const loading = shallowRef(false);\n const error = shallowRef<ApiError \| null>(null);\n\n // Sequences fetches so only the LATEST call writes state — a slow earlier fetch (or one orphaned\n // by `reset`) settling late must not clobber newer data or resurrect a reset hook. The returned\n // promise still resolves/rejects with its own outcome for every caller. A plain local: never\n // rendered, so reactivity would be waste.\n let sequence = 0;\n\n const fetch = async (): Promise<TData> => {\n const current = ++sequence;\n loading.value = true;\n error.value = null;\n try {\n const raw = await client.fetchQuery<TRaw, Error, TRaw, QueryKey>({\n queryKey: toValue(key),\n queryFn: ({ signal }) => queryFn({ signal }),\n meta,\n });\n const mapped = map ? map(raw) : (raw as unknown as TData);\n if (current === sequence) {\n data.value = mapped;\n loading.value = false;\n }\n return mapped;\n } catch (caught) {\n if (current === sequence) {\n error.value = toApiError(caught);\n loading.value = false;\n }\n throw caught;\n }\n };\n\n const reset = (): void => {\n sequence += 1; // orphan any in-flight fetch — its late settle no longer writes state\n data.value = undefined;\n error.value = null;\n loading.value = false;\n };\n\n return { data, loading, error, fetch, reset };\n}\n","import { useQueryClient, type QueryKey } from '@tanstack/vue-query';\n\n/* Defines a prefetch target for the query cache — a key paired with its fetcher. /\nexport interface QueryCachePrefetch {\n /* The query key to warm — the same key the live query reads. /\n readonly key: QueryKey;\n\n /* Fetches the data to cache; receives the `AbortSignal`. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<unknown>;\n}\n\n/* Defines the imperative cache accessor returned by `useQueryCache`. /\nexport interface QueryCacheApi {\n /* Reads the cached value at `key`, or `undefined` when absent. /\n readonly get: <TData>(key: QueryKey) => TData \| undefined;\n\n /* Writes `key` — a value, or an updater `(previous) => next` (the TanStack setter form). /\n readonly set: <TData>(key: QueryKey, data: TData \| ((previous: TData \| undefined) => TData)) => void;\n\n /* Marks the queries under `key` stale and refetches the active ones. /\n readonly invalidate: (key: QueryKey) => Promise<void>;\n\n /* Removes the queries under `key` from the cache. /\n readonly remove: (key: QueryKey) => void;\n\n /* Warms `key` in the background — deduped against a live query. /\n readonly prefetch: (target: QueryCachePrefetch) => Promise<void>;\n}\n\n/\n Provides access to the query cache — imperative get/set/invalidate/remove/prefetch by key,\n * wrapping the active `QueryClient`.\n \n Returns a plain object, as React did. There is nothing reactive here: every member is a command,\n * and the client is stable for the component's lifetime, so React's `useMemo` has no counterpart.\n /\nexport function useQueryCache(): QueryCacheApi {\n const client = useQueryClient();\n\n return {\n get: <TData>(key: QueryKey): TData \| undefined => client.getQueryData<TData>(key),\n set: <TData>(key: QueryKey, data: TData \| ((previous: TData \| undefined) => TData)): void => {\n client.setQueryData<TData>(key, data);\n },\n invalidate: (key: QueryKey): Promise<void> => client.invalidateQueries({ queryKey: key }),\n remove: (key: QueryKey): void => {\n client.removeQueries({ queryKey: key });\n },\n prefetch: ({ key, queryFn }: QueryCachePrefetch): Promise<void> =>\n client.prefetchQuery({ queryKey: key, queryFn: ({ signal }) => queryFn({ signal }) }),\n };\n}\n","import { onScopeDispose } from 'vue';\nimport { useQueryClient, type QueryClient, type QueryKey } from '@tanstack/vue-query';\n\n/\n The app client bound by the most recently mounted `usePrefetchQuery`. Powers the standalone\n * `prefetchProps`, mirroring the router's module-level prefetch registry — data prefetch needs a\n * client, so the composable binds it here.\n /\nlet activeClient: QueryClient \| undefined;\n\n/* Defines a prefetch target — a query key paired with its fetcher. /\nexport interface PrefetchTarget {\n /* The query key to warm — the same key the live query reads. /\n readonly key: QueryKey;\n\n /* Fetches the data to cache; receives the abort signal the library manages. /\n readonly queryFn: (context: { signal: AbortSignal }) => Promise<unknown>;\n}\n\n/\n Defines the hover/focus listeners to `v-bind` onto a link for data prefetch.\n \n `onMouseenter`, not React's `onMouseEnter`: Vue derives the DOM event name with `hyphenate()`, so\n * a camel-humped `onMouseEnter` key would bind a `mouse-enter` event that never fires.\n /\nexport interface PrefetchProps {\n /* Warms the target query when the pointer enters the link. /\n readonly onMouseenter: () => void;\n\n /* Warms the target query when the link gains focus. /\n readonly onFocus: () => void;\n}\n\n/* Warms a query's data against a client — a background fetch deduped against the live query. /\nfunction warm(client: QueryClient, { key, queryFn }: PrefetchTarget): void {\n void client.prefetchQuery({ queryKey: key, queryFn });\n}\n\n/* Manages intent-based data prefetch — returns a `prefetch(target)` that warms a query on hover/focus. /\nexport function usePrefetchQuery(): (target: PrefetchTarget) => void {\n const client = useQueryClient();\n\n // Bind the client for the standalone `prefetchProps`, mirroring the router's registry. React did\n // this in an effect; the scope teardown is the Vue counterpart of that effect's cleanup.\n activeClient = client;\n onScopeDispose(() => {\n if (activeClient === client) activeClient = undefined;\n });\n\n return (target: PrefetchTarget) => warm(client, target);\n}\n\n/* Builds hover/focus listeners that warm a query's data on intent — `v-bind` onto a link beside the router's `prefetchProps`. Requires a mounted `usePrefetchQuery`. /\nexport function prefetchProps(target: PrefetchTarget): PrefetchProps {\n const run = (): void => {\n if (activeClient) warm(activeClient, target);\n };\n return { onMouseenter: run, onFocus: run };\n}\n","import { toValue, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQuery, type QueryKey } from '@tanstack/vue-query';\n\nimport type { AppQueryMeta } from './CreateQueryClient';\n\n/* Defines a suspenseful query — a key, a fetcher, and an optional raw→view mapper. `TRaw` first so it infers from `queryFn` (a spread def); `TData` defaults to it when `map` is absent. /\nexport interface AppSuspenseQueryOptions<TRaw, TData = TRaw> {\n /* The query key that identifies and caches this query. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches the raw data; receives the abort signal the library manages. /\n readonly queryFn: (context: { signal: AbortSignal }) => Promise<TRaw>;\n\n /* Maps the raw fetched shape to the view shape; identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n\n /* Metadata surfaced to the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out of it (boundary-handled errors would otherwise double-surface). /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a resolved suspenseful query — `data` is already filled when the composable resolves. /\nexport interface AppSuspenseQueryReturn<TData> {\n /* The resolved payload. Defined on resolve, and kept live afterwards. /\n readonly data: Ref<TData>;\n\n /* Refetches the query. /\n readonly refetch: () => unknown;\n}\n\n/\n Manages a suspenseful query — the composable AWAITS the first resolution, so a `<script setup>`\n * that awaits it suspends until data is there.\n \n ```vue\n * <script setup lang=\"ts\">\n * const { data } = await useAppSuspenseQuery({ key: ['user'], queryFn });\n * </script>\n * ```\n \n `@tanstack/vue-query` ships no `useSuspenseQuery` — Vue suspends on an async `setup()` rather than\n * on a thrown promise, so the library exposes `suspense()` on the query result and this awaits it.\n * That makes this composable ASYNC where React's was synchronous, the one shape change the two\n * suspense models force.\n \n The caller still owns both boundaries: a `<Suspense>` for loading, and an error boundary for\n * failure — a rejected query rejects this promise and bubbles past the hook.\n /\nexport async function useAppSuspenseQuery<TRaw, TData = TRaw>({\n key,\n queryFn,\n map,\n meta,\n}: AppSuspenseQueryOptions<TRaw, TData>): Promise<AppSuspenseQueryReturn<TData>> {\n const query = useQuery<TRaw, Error, TData, QueryKey>(() => ({\n queryKey: toValue(key),\n queryFn: ({ signal }) => queryFn({ signal }),\n select: map,\n meta,\n }));\n\n const result = await query.suspense();\n if (result.error) throw result.error; // `suspense()` settles on failure too — rethrow for the boundary\n\n // `data` is `Ref<TData \| undefined>` in general; the await above is what makes it defined here.\n return { data: query.data as Ref<TData>, refetch: query.refetch };\n}\n","import { defineComponent, onScopeDispose, watch } from 'vue';\nimport { useIsFetching, useIsMutating } from '@tanstack/vue-query';\n\n// Deep import (not the `../router` barrel): the barrel statically imports vue-router, and a barrel\n// import here would merge the whole router graph into the shared chunk `/query` loads — breaking\n// `/query`'s isolation from the OPTIONAL vue-router peer. `UseNavigationProgress` is plain Vue.\nimport { useNavigationProgress } from '../router/UseNavigationProgress';\n\n/\n Lights the router's manual heartbeat while the query layer has any fetch or mutation in flight.\n \n Call inside BOTH a query client scope (`queryPlugin` / `<QueryProvider>`) and a `<ProgressProvider>`\n * — `useNavigationProgress` THROWS outside one. Wires effects only; it drives\n * `<NavigationProgress variant=\"heartbeat\" mode=\"manual\" />`.\n /\nexport function useQueryProgressBridge(): void {\n const fetching = useIsFetching();\n const mutating = useIsMutating();\n const { begin } = useNavigationProgress();\n\n let end: (() => void) \| null = null;\n\n // Open a manual busy span on 0→>0, close it on >0→0. `flush: 'sync'` is deliberately NOT used —\n // the default pre-flush is enough, and the callback touches no browser global, so it is SSR-safe\n // even though `immediate` runs it on the server.\n watch(\n () => fetching.value + mutating.value,\n (activity) => {\n if (activity > 0 && end === null) end = begin();\n else if (activity === 0 && end !== null) {\n end();\n end = null;\n }\n },\n { immediate: true },\n );\n\n // Close any still-open span when the bridge's scope is disposed mid-request.\n onScopeDispose(() => {\n end?.();\n end = null;\n });\n}\n\n/\n Renders nothing; wires `useQueryProgressBridge`.\n \n The component form React shipped, kept so an app can drop `<QueryProgressBridge />` into its\n * shell unchanged. Authored as a `defineComponent` rather than an SFC — it has no template.\n /\nexport const QueryProgressBridge = defineComponent({\n name: 'QueryProgressBridge',\n setup() {\n useQueryProgressBridge();\n return () => null;\n },\n});\n","<script lang=\"ts\">\n/* Defines the props for {@link QueryDevtools}. /\nexport interface QueryDevtoolsProps {\n /* Whether the panel starts open. Default `false`. /\n initialIsOpen?: boolean;\n}\n\n/\n * The devtools specifier, assembled at runtime.\n \n `@tanstack/vue-query-devtools` is NOT a dependency of this package — devtools are the app's\n * choice, and a library must not force one. A literal specifier would make the bundler resolve\n * (and therefore require) it at build time even inside a dead `import.meta.env.DEV` branch, so the\n * string is built here and the import stays opaque. The app installs the package to get the panel;\n * without it the component renders nothing and says nothing.\n /\nconst DevtoolsPackage = ['@tanstack', 'vue-query-devtools'].join('/');\n</script>\n\n<script setup lang=\"ts\">\nimport { onMounted, shallowRef, type Component } from 'vue';\n\n/* Renders the TanStack Query devtools in dev only, when the optional devtools package is installed. /\ndefineOptions({ name: 'QueryDevtools' });\n\nconst props = withDefaults(defineProps<QueryDevtoolsProps>(), { initialIsOpen: false });\n\nconst devtools = shallowRef<Component \| null>(null);\n\n// `onMounted` never runs on the server, and the import is dev-only — production tree-shakes the\n// branch away because `import.meta.env.DEV` is statically false there.\nonMounted(async () => {\n if (!import.meta.env.DEV) return;\n try {\n const module = (await import(/ @vite-ignore / DevtoolsPackage)) as { VueQueryDevtools?: Component };\n devtools.value = module.VueQueryDevtools ?? null;\n } catch {\n // Devtools not installed — the normal case for an app that never opted in.\n }\n});\n</script>\n\n<template>\n <component :is=\"devtools\" v-if=\"devtools\" :initial-is-open=\"props.initialIsOpen\" />\n</template>\n","import { dehydrate, hydrate, type DehydratedState, type QueryClient } from '@tanstack/vue-query';\n\nconst DefaultStorageKey = 'app:query-cache';\nconst DefaultMaxAgeMs = 24 60 * 60_000; // 24h\nconst WriteThrottleMs = 1_000;\n\n/** The envelope written to storage — the dehydrated cache plus what restore has to validate before trusting it. /\ninterface PersistedSnapshot {\n readonly buster: string;\n readonly timestamp: number;\n readonly state: DehydratedState;\n}\n\n/* Defines options for `setupQueryPersistence`. /\nexport interface SetupQueryPersistenceOptions {\n /* The `localStorage` key the dehydrated cache is written under. /\n readonly storageKey?: string;\n /* The max age of a restored cache in ms; an older cache is discarded on restore. /\n readonly maxAgeMs?: number;\n /* A cache-busting string; a mismatch discards the persisted cache. /\n readonly buster?: string;\n}\n\n/* Represents the handles returned by `setupQueryPersistence`. /\nexport interface QueryPersistenceHandle {\n /* Stops persisting further cache changes. /\n readonly unsubscribe: () => void;\n /* Resolves once the persisted cache has been restored into the client. /\n readonly restored: Promise<void>;\n}\n\n/\n Wires `localStorage` persistence for the query cache (opt-in — call from `main.ts`); returns null\n * when there is no `window` (SSR-safe).\n \n Built on `dehydrate` / `hydrate` straight out of `@tanstack/vue-query` rather than on the\n * `persist-client` + `sync-storage-persister` package pair the React version used: those two are\n * separate installs, and the whole of what they add over this is an async persister interface this\n * synchronous store does not need. The restore is therefore SYNCHRONOUS — the cache is already\n * hydrated when the call returns, and `restored` is an already-settled promise kept for API parity.\n \n Caveats to weigh before opting in:\n * - Sensitive data — every successful query dehydrates into `localStorage` in plain text,\n * including authenticated user data; any script on the origin can read it. Do not enable on apps\n * whose cache holds secrets/PII, or scope what queries cache to begin with.\n * - Version busting — pass `buster` (e.g. the app version) whenever a release changes cached\n * shapes; a restored stale shape otherwise flows into typed hooks unchecked.\n * - Quota — a full `localStorage` makes the write silently fail (no retry strategy is wired);\n * the app keeps working, persistence just lags.\n * - Temporal revive — payloads parsed via `reviveTemporal` serialize to ISO strings and are\n * restored WITHOUT re-reviving: restored entries hold plain strings where live fetches hold\n * `Temporal.` objects. Don't combine persistence with `reviveTemporal` yet.\n /\nexport function setupQueryPersistence(\n client: QueryClient,\n options: SetupQueryPersistenceOptions = {},\n): QueryPersistenceHandle \| null {\n if (typeof window === 'undefined') return null;\n\n const { storageKey = DefaultStorageKey, maxAgeMs = DefaultMaxAgeMs, buster = '' } = options;\n\n restore(client, storageKey, maxAgeMs, buster);\n\n // Throttled: a burst of cache events (one query settling touches the cache several times) must not\n // serialize the whole cache once per event.\n let timer: ReturnType<typeof setTimeout> \| null = null;\n const schedule = (): void => {\n if (timer !== null) return;\n timer = setTimeout(() => {\n timer = null;\n write(client, storageKey, buster);\n }, WriteThrottleMs);\n };\n\n const unsubscribeQueries = client.getQueryCache().subscribe(schedule);\n const unsubscribeMutations = client.getMutationCache().subscribe(schedule);\n\n return {\n unsubscribe: () => {\n unsubscribeQueries();\n unsubscribeMutations();\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n },\n restored: Promise.resolve(),\n };\n}\n\n/** Hydrates the client from storage when the snapshot is present, current, and matches the buster. /\nfunction restore(client: QueryClient, storageKey: string, maxAgeMs: number, buster: string): void {\n try {\n const raw = window.localStorage.getItem(storageKey);\n if (!raw) return;\n\n const snapshot = JSON.parse(raw) as PersistedSnapshot;\n const isStale = Date.now() - snapshot.timestamp > maxAgeMs;\n if (snapshot.buster !== buster \|\| isStale) {\n window.localStorage.removeItem(storageKey);\n return;\n }\n\n hydrate(client, snapshot.state);\n } catch {\n // Unreadable / unparseable / storage unavailable — a missing cache is always a valid state.\n }\n}\n\n/* Serializes the dehydrated cache into storage, tolerating storage being unavailable (private mode / quota). */\nfunction write(client: QueryClient, storageKey: string, buster: string): void {\n try {\n const snapshot: PersistedSnapshot = { buster, timestamp: Date.now(), state: dehydrate(client) };\n window.localStorage.setItem(storageKey, JSON.stringify(snapshot));\n } catch {\n // Persistence is best-effort — swallow.\n }\n}\n"],"names":["_renderSlot","_openBlock","_createBlock","_resolveDynamicComponent"],"mappings":"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"}
1	+ {"version":3,"file":"index.js","sources":["../../src/query/adapters/tanstack/QueryOutcome.ts","../../src/query/adapters/tanstack/CreateQueryClient.ts","../../src/query/adapters/tanstack/QueryProvider.vue","../../src/query/adapters/tanstack/Endpoints.ts","../../src/query/adapters/tanstack/hooks/UseAppQuery.ts","../../src/query/adapters/tanstack/hooks/UseAppInfiniteQuery.ts","../../src/query/adapters/tanstack/hooks/UseAppMutation.ts","../../src/query/adapters/tanstack/OptimisticTransactions.ts","../../src/query/adapters/tanstack/hooks/UseOptimisticMutation.ts","../../src/query/adapters/tanstack/hooks/UseAppQueries.ts","../../src/query/adapters/tanstack/hooks/UseAppPaginatedQuery.ts","../../src/query/PageExtensions.ts","../../src/query/adapters/tanstack/hooks/UseAppLazyQuery.ts","../../src/query/adapters/tanstack/hooks/UseQueryCache.ts","../../src/query/adapters/tanstack/hooks/UsePrefetchQuery.ts","../../src/query/adapters/tanstack/hooks/UseAppSuspenseQuery.ts","../../src/query/adapters/tanstack/QueryProgressBridge.ts","../../src/query/adapters/tanstack/queryDevtools/QueryDevtools.vue","../../src/query/adapters/tanstack/Persistence.ts"],"sourcesContent":["import { CancelledError } from '@tanstack/vue-query';\nimport { ApiError, ApiFailureFactory, type ApiFailure } from '../../../foundation/http';\nimport { isAbortError, isTimeoutError } from '../../../foundation/errors';\nimport { ResultExtensions, type Result } from '../../../foundation/results';\n\n/** Unwraps only at the vendor boundary, where query failure requires rejection. /\nexport async function resolveQueryResult<T>(pending: Promise<Result<T, ApiFailure>>): Promise<T> {\n const outcome = await pending;\n if (!outcome.ok) throw new ApiError(outcome.failure);\n return outcome.value;\n}\n\n/* Returns safe display state; programmer exceptions are never mislabeled as network failures. /\nexport function toApiFailure(error: unknown): ApiFailure {\n if (error instanceof ApiError) return error.failure;\n if (isTimeoutError(error)) return ApiFailureFactory.create('timeout');\n if (error instanceof CancelledError \|\| isAbortError(error)) return ApiFailureFactory.create('cancelled');\n return ApiFailureFactory.create('protocol');\n}\n\n/* Restores expected outcomes after a vendor command, preserving programmer-error rejection. /\nexport async function queryOutcome<T>(run: () => Promise<T>): Promise<Result<T, ApiFailure>> {\n try {\n return ResultExtensions.ok(await run());\n } catch (error) {\n if (error instanceof ApiError \|\| error instanceof CancelledError \|\| isAbortError(error) \|\| isTimeoutError(error)) {\n return ResultExtensions.fail(toApiFailure(error));\n }\n throw error;\n }\n}\n","import { CancelledError, MutationCache, QueryCache, QueryClient } from '@tanstack/vue-query';\n\nimport { isAbortError } from '../../../foundation/errors';\nimport { ApiError, type ApiFailure } from '../../../foundation/http';\n\nimport { computeRetryDelay, DefaultRetryPolicy, shouldRetry, type RetryPolicy } from '../../../foundation/resilience';\n\nimport { toApiFailure } from './QueryOutcome';\n\nconst StaleTimeMs = 30_000;\nconst GcTimeMs = 5 60_000;\n\n/** Recognizes vendor cancellation and the transport cancellation failure bridge. /\nfunction isCancellation(error: unknown): boolean {\n return (\n error instanceof CancelledError \|\|\n isAbortError(error) \|\|\n (error instanceof ApiError && error.failure.code === 'cancelled')\n );\n}\n\n/\n The metadata bag a hook's `meta` option attaches to its query/mutation — free-form keys read back\n * by the global error seam. `suppressGlobalError: true` keeps that call's failures out of the\n * global `onError` (per-query opt-out for polling / boundary-handled errors).\n /\nexport type AppQueryMeta = Record<string, unknown>;\n\n/* Carries the failing query's / mutation's context into the global `onError`. /\nexport interface QueryErrorContext {\n /* The `meta` attached at the call site, or `undefined` when none was set. /\n readonly meta: AppQueryMeta \| undefined;\n}\n\n/* Defines options for `createQueryClient`. /\nexport interface CreateQueryClientOptions {\n /\n Emits a coerced `ApiFailure` whenever any query or mutation fails. Cancellations and calls whose\n * `meta` sets `suppressGlobalError: true` are skipped; `context.meta` carries the call's `meta`.\n /\n readonly onError?: (error: ApiFailure, context: QueryErrorContext) => void;\n\n /\n The retry policy for transient query failures (backoff · jitter · retryable statuses). Default\n * `DefaultRetryPolicy`. Mutations never retry; `onRetry` is transport-level only — the TanStack\n * retry seam has no pre-retry hook, so it is not invoked here.\n /\n readonly retry?: RetryPolicy;\n}\n\n/\n Creates the app `QueryClient` — house defaults (30s stale · 5m gc · no focus-refetch · mutations\n * no-retry) + a configurable `RetryPolicy` + global error coercion to `ApiFailure`.\n /\nexport function createQueryClient(options: CreateQueryClientOptions = {}): QueryClient {\n const handleError = (error: unknown, meta: AppQueryMeta \| undefined): void => {\n if (isCancellation(error)) return;\n if (meta?.suppressGlobalError === true) return;\n options.onError?.(toApiFailure(error), { meta });\n };\n const policy = options.retry ?? DefaultRetryPolicy;\n\n return new QueryClient({\n queryCache: new QueryCache({ onError: (error, query) => handleError(error, query.meta) }),\n mutationCache: new MutationCache({\n onError: (error, _variables, _context, mutation) => handleError(error, mutation.meta),\n }),\n defaultOptions: {\n queries: {\n staleTime: StaleTimeMs,\n gcTime: GcTimeMs,\n refetchOnWindowFocus: false,\n retry: (failureCount, error) =>\n error instanceof ApiError &&\n ['http', 'transport'].includes(error.failure.code) &&\n shouldRetry(policy, failureCount, error.status),\n retryDelay: (attemptIndex) => computeRetryDelay(policy, attemptIndex + 1),\n },\n mutations: { retry: 0 },\n },\n });\n}\n","<script lang=\"ts\">\nimport type { QueryClient } from '@tanstack/vue-query';\n\n/* Defines the props for {@link QueryProvider}. /\nexport interface QueryProviderProps {\n /* The app client captured at mount; remount the provider to replace its query scope. /\n readonly client: QueryClient;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { onMounted, onUnmounted, provide } from 'vue';\n// `QueryClient` is already imported as a TYPE by the plain `<script>` block above — the two blocks\n// compile into ONE module, so only the injection-key VALUE comes in here.\nimport { VUE_QUERY_CLIENT } from '@tanstack/vue-query';\n\n/\n Renders no element of its own — the slot passes straight through — while mounting the app `QueryClient`\n * above that subtree.\n \n `@tanstack/vue-query` ships no `QueryClientProvider` component — it installs as an app plugin\n * (`queryPlugin`). This is the component form, built on the same injection key the library's own\n * `useQueryClient()` reads, so every hook in this module works underneath it. Use it when a SUBTREE\n * (or a test) needs its own client; use `queryPlugin` for the whole app.\n \n `client.mount()` runs from `onMounted`, which never executes on the server — the plugin skips it\n * there for the same reason: mounting subscribes the focus / online managers to browser globals.\n /\ndefineOptions({ name: 'QueryProvider' });\n\ndefineSlots<{\n /* The subtree with access to the client. /\n default(): unknown;\n}>();\n\nconst props = defineProps<QueryProviderProps>();\nconst client = props.client;\n\nprovide(VUE_QUERY_CLIENT, client);\n\nonMounted(() => client.mount());\nonUnmounted(() => client.unmount());\n</script>\n\n<template>\n <slot />\n</template>\n","import type { ApiFailure } from '../../../foundation/http';\nimport type { Result } from '../../../foundation/results';\n// Typed endpoint definitions — the generic core of a query-factory registry (the data-layer\n// `definePath`). An app declares per-resource factories over `defineEndpoint`\n// (`const codesApi = { list: (q?: string) => defineEndpoint({ key: …, queryFn: … }) }`); this module\n// owns only the typing core — key + fetcher declared once, together, so the pairing can never desync.\n// A def is a plain `{ key, queryFn }`: it spreads into `useAppQuery` / `useAppSuspenseQuery` /\n// `useAppLazyQuery`, feeds `usePrefetchQuery` / `prefetchProps` / `useQueryCache().prefetch` whole,\n// The house query adapters unwrap Result at the TanStack rejection boundary; raw vendor fetchers\n// must explicitly adapt the outcome rather than cache the Result object as payload.\n// Mutations stay plain client calls into `useAppMutation` — no def shape for writes (an\n// `useOptimisticMutation` target may reuse a def's `key` to locate the cached read it patches).\n\nimport type { QueryKey } from '@tanstack/vue-query';\n\n/* Defines a typed endpoint — a query key fused with the fetcher that fills it. /\nexport interface Endpoint<TRaw> {\n /* The query key this endpoint caches under — the same key every consuming surface reads. /\n readonly key: QueryKey;\n\n /* Fetches the raw payload; receives the abort signal so the request cancels with the query. /\n readonly queryFn: (context: { signal: AbortSignal }) => Promise<Result<TRaw, ApiFailure>>;\n}\n\n/* Defines a parameterized endpoint factory — call with the endpoint's args for a def keyed to them. /\nexport type EndpointFn<TArgs extends ReadonlyArray<unknown>, TRaw> = (...args: TArgs) => Endpoint<TRaw>;\n\n/\n Creates a typed endpoint definition — constrains the shape, infers `TRaw` from the fetcher, and\n * returns the def unchanged (pure typing; deleting the call leaves valid code).\n /\nexport function defineEndpoint<TRaw>(endpoint: Endpoint<TRaw>): Endpoint<TRaw> {\n return endpoint;\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { Result } from '../../../../foundation/results';\nimport { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQuery, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiFailure } from '../../../../foundation/http';\n\nimport type { AppQueryMeta } from '../CreateQueryClient';\nimport { toApiFailure } from '../QueryOutcome';\n\n/\n Defines options for `useAppQuery` — `TRaw` first so it infers from `queryFn` (a spread def) and\n * `TData` defaults to it when `map` is absent.\n /\nexport interface UseAppQueryOptions<TRaw, TData = TRaw> {\n /* The cache key (from `queryKeys`). A ref or getter re-keys the query reactively. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches the raw payload; receives the `AbortSignal` so the request cancels on unmount. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<Result<TRaw, ApiFailure>>;\n\n /* Maps the raw payload to the domain shape — identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n\n /* Gates the query — skips fetching while `false`. A ref or getter toggles it reactively. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n\n /* Metadata for the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a single-resource query's slice — every member reactive. /\nexport interface UseAppQueryReturn<TData> {\n /* The mapped domain payload, or `undefined` until it resolves. /\n readonly data: Ref<TData \| undefined>;\n\n /* True while there is no data yet and a fetch is in flight. /\n readonly loading: ComputedRef<boolean>;\n\n /* The failure coerced to `ApiFailure`, or `null`. /\n readonly error: ComputedRef<ApiFailure \| null>;\n\n /* Refetches the query. /\n readonly refetch: () => unknown;\n}\n\n/\n Manages a single-resource query — wraps `useQuery`, maps raw→domain via `select`, and coerces\n * failures to `ApiFailure`.\n \n Returns REFS, not values: `@tanstack/vue-query` hands back a ref per field, and a composable that\n * unwrapped them would freeze at the first render. Read `data.value` (or bind `data` in a template).\n /\nexport function useAppQuery<TRaw, TData = TRaw>({\n key,\n queryFn,\n map,\n enabled,\n meta,\n}: UseAppQueryOptions<TRaw, TData>): UseAppQueryReturn<TData> {\n // A getter for the WHOLE options object: `key` and `enabled` are `MaybeRefOrGetter`, and this is\n // the one form that re-evaluates every one of them together on each dependency change.\n const query = useQuery<TRaw, Error, TData, QueryKey>(() => ({\n queryKey: toValue(key),\n queryFn: ({ signal }) => resolveQueryResult(queryFn({ signal })),\n select: map ?? ((raw: TRaw) => raw as unknown as TData),\n enabled: toValue(enabled),\n meta,\n }));\n\n return {\n data: query.data,\n loading: computed(() => query.isPending.value && query.isFetching.value),\n error: computed(() => (query.error.value ? toApiFailure(query.error.value) : null)),\n refetch: query.refetch,\n };\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { Result } from '../../../../foundation/results';\nimport { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useInfiniteQuery, type InfiniteData, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiFailure } from '../../../../foundation/http';\n\nimport type { AppQueryMeta } from '../CreateQueryClient';\nimport { toApiFailure } from '../QueryOutcome';\n\n/* Defines options for `useAppInfiniteQuery`. /\nexport interface UseAppInfiniteQueryOptions<TItem, TPage> {\n /* The cache key (from `queryKeys`). /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches one page for `pageParam`; receives the `AbortSignal`. /\n readonly queryFn: (ctx: { pageParam: unknown; signal: AbortSignal }) => Promise<Result<TPage, ApiFailure>>;\n\n /* Derives the next page's param from the last page — return `undefined`/`null` to stop. /\n readonly getNextPageParam: (lastPage: TPage, allPages: ReadonlyArray<TPage>) => unknown;\n\n /* The param for the first page. /\n readonly initialPageParam: unknown;\n\n /* Extracts items from a page — the page itself is the item array when omitted. /\n readonly mapPage?: (page: TPage) => ReadonlyArray<TItem>;\n\n /* Poll interval in ms, or a fn of the current items → ms / `false` (poll-while-running). /\n readonly refetchInterval?: number \| ((items: ReadonlyArray<TItem>) => number \| false);\n\n /* Gates the query — skips fetching while `false`. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n\n /\n Metadata for the global `onError` seam — `suppressGlobalError: true` keeps this query's failures\n * out (e.g. polls that would otherwise toast per failed refetch).\n /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents an infinite query's slice — every member reactive. /\nexport interface UseAppInfiniteQueryReturn<TItem> {\n /* Every fetched page flattened to items. /\n readonly items: ComputedRef<ReadonlyArray<TItem>>;\n\n /* True while there is no page yet and a fetch is in flight. /\n readonly loading: ComputedRef<boolean>;\n\n /* The failure coerced to `ApiFailure`, or `null`. /\n readonly error: ComputedRef<ApiFailure \| null>;\n\n /* Whether another page can be fetched. /\n readonly hasNextPage: Ref<boolean>;\n\n /* Fetches the next page. /\n readonly fetchNextPage: (...args: never[]) => unknown;\n\n /* True while the next page is in flight. /\n readonly isFetchingNextPage: Ref<boolean>;\n\n /* Refetches every fetched page. /\n readonly refetch: () => unknown;\n}\n\n/* Manages a paginated resource — wraps `useInfiniteQuery`, flattens pages to items, supports poll-while-running. /\nexport function useAppInfiniteQuery<TItem, TPage>({\n key,\n queryFn,\n getNextPageParam,\n initialPageParam,\n mapPage,\n refetchInterval,\n enabled,\n meta,\n}: UseAppInfiniteQueryOptions<TItem, TPage>): UseAppInfiniteQueryReturn<TItem> {\n // A plain closure is enough — Vue recomputes only when a tracked dependency changes.\n const extract = (page: TPage): ReadonlyArray<TItem> =>\n mapPage ? mapPage(page) : (page as unknown as ReadonlyArray<TItem>);\n\n const query = useInfiniteQuery<TPage, Error, InfiniteData<TPage, unknown>, QueryKey, unknown>(() => ({\n queryKey: toValue(key),\n queryFn: ({ pageParam, signal }) => resolveQueryResult(queryFn({ pageParam, signal })),\n getNextPageParam,\n initialPageParam,\n enabled: toValue(enabled),\n meta,\n refetchInterval:\n refetchInterval === undefined\n ? undefined\n : (query_) => {\n if (typeof refetchInterval === 'number') return refetchInterval;\n const current = (query_.state.data?.pages ?? []).flatMap((page) => [...extract(page)]);\n return refetchInterval(current);\n },\n }));\n\n return {\n items: computed(() => (query.data.value?.pages ?? []).flatMap((page) => [...extract(page)])),\n loading: computed(() => query.isPending.value && query.isFetching.value),\n error: computed(() => (query.error.value ? toApiFailure(query.error.value) : null)),\n hasNextPage: query.hasNextPage,\n fetchNextPage: query.fetchNextPage,\n isFetchingNextPage: query.isFetchingNextPage,\n refetch: query.refetch,\n };\n}\n","import { queryOutcome } from '../QueryOutcome';\nimport { resolveQueryResult } from '../QueryOutcome';\nimport type { Result } from '../../../../foundation/results';\nimport { computed, type ComputedRef, type Ref } from 'vue';\nimport { useMutation, useQueryClient, type QueryClient, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiFailure } from '../../../../foundation/http';\n\nimport type { AppQueryMeta } from '../CreateQueryClient';\nimport { toApiFailure } from '../QueryOutcome';\n\n/* Defines options for `useAppMutation`. /\nexport interface UseAppMutationOptions<TData, TVars> {\n /* Performs the mutation against the backend. /\n readonly mutationFn: (vars: TVars) => Promise<Result<TData, ApiFailure>>;\n\n /* Query keys to invalidate on success — derived from the vars and the server's returned value. /\n readonly invalidates?: (vars: TVars, data: TData) => ReadonlyArray<QueryKey>;\n\n /* Reconciles the cache from the server's confirmed result (e.g. `setQueryData`) after invalidation. /\n readonly onConfirmed?: (data: TData, vars: TVars, queryClient: QueryClient) => void;\n\n /* Metadata for the global `onError` seam — `suppressGlobalError: true` keeps this mutation's failures out. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a mutation's slice — state as refs, commands as plain functions. /\nexport interface UseAppMutationReturn<TData, TVars> {\n /* Fires the mutation, fire-and-forget. /\n readonly mutate: (vars: TVars) => void;\n\n /* Fires the mutation and resolves with its result. /\n readonly mutateAsync: (vars: TVars) => Promise<Result<TData, ApiFailure>>;\n\n /* The last successful result. /\n readonly data: Ref<TData \| undefined>;\n\n /* True while the mutation is in flight. /\n readonly loading: Ref<boolean>;\n\n /* The failure coerced to `ApiFailure`, or `null`. /\n readonly error: ComputedRef<ApiFailure \| null>;\n\n /* Clears the mutation back to idle. /\n readonly reset: () => void;\n}\n\n/\n Manages a passive mutation — reconciles the cache only from the backend-confirmed result; no\n * optimistic update, no rollback.\n /\nexport function useAppMutation<TData, TVars>({\n mutationFn,\n invalidates,\n onConfirmed,\n meta,\n}: UseAppMutationOptions<TData, TVars>): UseAppMutationReturn<TData, TVars> {\n const queryClient = useQueryClient();\n\n const mutation = useMutation<TData, Error, TVars>({\n mutationFn: (vars) => resolveQueryResult(mutationFn(vars)),\n meta,\n onSuccess: async (data, vars) => {\n const keys = invalidates?.(vars, data) ?? [];\n await Promise.all(keys.map((queryKey) => queryClient.invalidateQueries({ queryKey })));\n onConfirmed?.(data, vars, queryClient);\n },\n });\n\n return {\n mutate: mutation.mutate,\n mutateAsync: (vars) => queryOutcome(() => mutation.mutateAsync(vars)),\n data: mutation.data,\n loading: mutation.isPending,\n error: computed(() => (mutation.error.value ? toApiFailure(mutation.error.value) : null)),\n reset: mutation.reset,\n };\n}\n","import type { QueryClient } from '@tanstack/vue-query';\n\nconst tails = new WeakMap<QueryClient, Promise<void>>();\n\n/* Serializes optimistic cache transactions per client so rollback never erases a later write. /\nexport async function runOptimisticTransaction<T>(client: QueryClient, run: () => Promise<T>): Promise<T> {\n const previous = tails.get(client) ?? Promise.resolve();\n let release!: () => void;\n const current = new Promise<void>((resolve) => {\n release = resolve;\n });\n tails.set(client, current);\n await previous;\n try {\n return await run();\n } finally {\n release();\n if (tails.get(client) === current) tails.delete(client);\n }\n}\n","import { runOptimisticTransaction } from '../OptimisticTransactions';\nimport { queryOutcome } from '../QueryOutcome';\nimport { resolveQueryResult } from '../QueryOutcome';\nimport type { ApiFailure } from '../../../../foundation/http';\nimport type { Result } from '../../../../foundation/results';\nimport { computed } from 'vue';\nimport { useMutation, useQueryClient, type QueryKey } from '@tanstack/vue-query';\n\nimport type { Endpoint } from '../Endpoints';\nimport { toApiFailure } from '../QueryOutcome';\nimport type { UseAppMutationReturn } from './UseAppMutation';\n\n/* Defines one cached query an optimistic mutation patches — where it lives and how it changes. /\nexport interface OptimisticTarget<TVars, TCached = unknown> {\n /* Locates the cached entry to patch — a query key, or an endpoint def (patched at its `key`). /\n readonly key: QueryKey \| Endpoint<TCached>;\n\n /\n Produces the next cached value from the current one and the mutation vars — pure, no side effects.\n * `current` is `undefined` when the key holds no data yet; returning a value then seeds the entry\n * (and rollback removes the seed).\n /\n // Method syntax on purpose: its bivariant parameters let targets of different `TCached` shapes\n // (each annotating its own `current`) share one `targets` array typed `ReadonlyArray<OptimisticTarget<TVars>>`.\n apply(current: TCached \| undefined, vars: TVars): TCached;\n}\n\n/* Defines options for `useOptimisticMutation`. /\nexport interface UseOptimisticMutationOptions<TData, TVars> {\n /* Performs the mutation against the backend. /\n readonly mutationFn: (vars: TVars) => Promise<Result<TData, ApiFailure>>;\n\n /\n The cached queries this mutation patches — each is cancelled, snapshotted, and applied before\n * the request fires, then rolled back on error.\n /\n readonly targets: ReadonlyArray<OptimisticTarget<TVars>>;\n\n /\n Invalidates every target key once the mutation settles (success or error) so the server truth\n * reconciles the patch — `true` when omitted.\n /\n readonly invalidateOnSettle?: boolean;\n}\n\n/* A per-target snapshot taken before the patch — the unit of rollback. /\ninterface TargetSnapshot {\n readonly queryKey: QueryKey;\n readonly previous: unknown;\n}\n\n/* Resolves a target locator to its query key — unwraps an endpoint def, passes a bare key through. /\nfunction resolveKey(key: QueryKey \| Endpoint<unknown>): QueryKey {\n return 'queryFn' in key ? key.key : key;\n}\n\n/\n Manages an optimistic mutation — cancel + snapshot + patch every target on mutate, roll the\n * patches back on error, reconcile with the server on settle. Transactions serialize per client\n * through reconciliation, preventing an older rollback from erasing a later write. Independent\n * clients remain independent. Target apply functions must be pure; `useAppMutation` is the passive default.\n /\nexport function useOptimisticMutation<TData, TVars>({\n mutationFn,\n targets,\n invalidateOnSettle = true,\n}: UseOptimisticMutationOptions<TData, TVars>): UseAppMutationReturn<TData, TVars> {\n const queryClient = useQueryClient();\n\n const mutation = useMutation<TData, Error, TVars>({\n mutationFn: (vars) =>\n runOptimisticTransaction(queryClient, async () => {\n const keys = targets.map((target) => resolveKey(target.key));\n await Promise.all(keys.map((queryKey) => queryClient.cancelQueries({ queryKey, exact: true })));\n const snapshots: TargetSnapshot[] = [];\n try {\n for (const target of targets) {\n const queryKey = resolveKey(target.key);\n const previous = queryClient.getQueryData(queryKey);\n snapshots.push({ queryKey, previous });\n queryClient.setQueryData(queryKey, () => target.apply(previous, vars));\n }\n return await resolveQueryResult(mutationFn(vars));\n } catch (error) {\n // Reverse order also restores duplicate targets to the transaction's initial value.\n for (const { queryKey, previous } of [...snapshots].reverse()) {\n if (previous === undefined) queryClient.removeQueries({ queryKey, exact: true });\n else queryClient.setQueryData(queryKey, () => previous);\n }\n throw error;\n } finally {\n // The transaction stays locked through reconciliation; the next snapshot sees settled data.\n if (invalidateOnSettle)\n await Promise.all(keys.map((queryKey) => queryClient.invalidateQueries({ queryKey, exact: true })));\n }\n }),\n });\n\n return {\n mutate: mutation.mutate,\n mutateAsync: (vars) => queryOutcome(() => mutation.mutateAsync(vars)),\n data: mutation.data,\n loading: mutation.isPending,\n error: computed(() => (mutation.error.value ? toApiFailure(mutation.error.value) : null)),\n reset: mutation.reset,\n };\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { Result } from '../../../../foundation/results';\nimport { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQueries, type QueryKey, type QueryObserverResult } from '@tanstack/vue-query';\n\nimport type { ApiFailure } from '../../../../foundation/http';\n\nimport { toApiFailure } from '../QueryOutcome';\n\n/\n Defines one entry in a parallel `useAppQueries` batch — `TRaw` first so it infers from `queryFn`\n * (a spread def) and `TData` defaults to it when `map` is absent.\n /\nexport interface AppQueriesEntry<TRaw, TData = TRaw> {\n /* The cache key (from `queryKeys`). /\n readonly key: QueryKey;\n\n /* Fetches this entry's raw payload; receives the `AbortSignal` so the request cancels on unmount. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<Result<TRaw, ApiFailure>>;\n\n /* Maps the raw payload to the domain shape — identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n}\n\n/* Represents one entry's slice of a `useAppQueries` batch. /\nexport interface AppQueryState<TData> {\n /* The mapped domain payload, or `undefined` until this entry resolves. /\n readonly data: TData \| undefined;\n\n /* True while this entry has no data yet and a fetch is in flight. /\n readonly loading: boolean;\n\n /* This entry's failure coerced to `ApiFailure`, or `null`. /\n readonly error: ApiFailure \| null;\n}\n\n/* Defines options for `useAppQueries`. /\nexport interface UseAppQueriesOptions<TRaw, TData = TRaw> {\n /* The queries to run in parallel — the count may vary. A ref or getter re-builds the batch reactively. /\n readonly queries: MaybeRefOrGetter<ReadonlyArray<AppQueriesEntry<TRaw, TData>>>;\n\n /* Gates the whole batch — skips fetching every entry while `false`. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n}\n\n/* Represents a parallel batch's aggregated slice — every member reactive. /\nexport interface UseAppQueriesReturn<TData> {\n /* One slice per entry, in the order they were given. /\n readonly results: ComputedRef<ReadonlyArray<AppQueryState<TData>>>;\n\n /* Just the payloads, positionally aligned with the entries. /\n readonly data: ComputedRef<ReadonlyArray<TData \| undefined>>;\n\n /* True while any entry is still loading. /\n readonly loading: ComputedRef<boolean>;\n\n /* Every entry's failure, coerced. /\n readonly errors: ComputedRef<ReadonlyArray<ApiFailure>>;\n}\n\n/\n Manages a dynamic batch of parallel queries — wraps `useQueries`, maps each raw→domain, and\n * aggregates loading/errors.\n /\nexport function useAppQueries<TRaw, TData = TRaw>({\n queries,\n enabled,\n}: UseAppQueriesOptions<TRaw, TData>): UseAppQueriesReturn<TData> {\n // `useQueries` types its result off a tuple of per-entry option types; a homogeneous, run-time\n // sized array cannot be expressed that way, so the result is asserted — the same widening the\n // React original applied to `UseQueryResult<TData, Error>[]`.\n const results = useQueries({\n queries: computed(() =>\n toValue(queries).map((entry) => ({\n queryKey: entry.key,\n queryFn: ({ signal }: { signal: AbortSignal }) => resolveQueryResult(entry.queryFn({ signal })),\n select: entry.map ?? ((raw: TRaw) => raw as unknown as TData),\n enabled: toValue(enabled),\n })),\n ),\n }) as unknown as Ref<ReadonlyArray<QueryObserverResult<TData, Error>>>;\n\n const mapped = computed<ReadonlyArray<AppQueryState<TData>>>(() =>\n results.value.map((query) => ({\n data: query.data,\n loading: query.isPending && query.isFetching,\n error: query.error ? toApiFailure(query.error) : null,\n })),\n );\n\n return {\n results: mapped,\n data: computed(() => mapped.value.map((result) => result.data)),\n loading: computed(() => mapped.value.some((result) => result.loading)),\n errors: computed(() => mapped.value.flatMap((result) => (result.error ? [result.error] : []))),\n };\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { Result } from '../../../../foundation/results';\nimport { computed, toValue, type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { keepPreviousData, useQuery, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiFailure } from '../../../../foundation/http';\n\nimport type { AppQueryMeta } from '../CreateQueryClient';\nimport { toApiFailure } from '../QueryOutcome';\n\n/* Defines options for `useAppPaginatedQuery`. /\nexport interface UseAppPaginatedQueryOptions<TItem, TPage> {\n /* The base cache key (from `queryKeys`) — the active `page` is appended to form the per-page key. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches one page; receives the controlled `page` and the `AbortSignal`. /\n readonly queryFn: (ctx: { page: number; signal: AbortSignal }) => Promise<Result<TPage, ApiFailure>>;\n\n /\n The controlled page index — the caller owns it; changing it loads that page. A ref or getter\n * drives it reactively.\n /\n readonly page: MaybeRefOrGetter<number>;\n\n /* Extracts items from a page — the page itself is the item array when omitted. /\n readonly mapPage?: (page: TPage) => ReadonlyArray<TItem>;\n\n /* Gates the query — skips fetching while `false`. /\n readonly enabled?: MaybeRefOrGetter<boolean>;\n\n /* Metadata for the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a page/offset paginated query's slice — every member reactive. /\nexport interface UseAppPaginatedQueryReturn<TItem, TPage> {\n /* The current page's items. /\n readonly items: ComputedRef<ReadonlyArray<TItem>>;\n\n /\n The raw page as fetched (`TPage`) — total count / page count / `hasMore` live here; `undefined`\n * until the first page resolves. While `isPlaceholder`, it is the held previous page.\n /\n readonly page: Ref<TPage \| undefined>;\n\n /* True while there is no page yet and a fetch is in flight. /\n readonly loading: ComputedRef<boolean>;\n\n /* The failure coerced to `ApiFailure`, or `null`. /\n readonly error: ComputedRef<ApiFailure \| null>;\n\n /* True while the held previous page is being shown during a page change. /\n readonly isPlaceholder: Ref<boolean>;\n\n /* Refetches the active page. /\n readonly refetch: () => unknown;\n}\n\n/\n Manages page/offset pagination — wraps `useQuery` with `keepPreviousData` so the list holds\n * steady between pages.\n /\nexport function useAppPaginatedQuery<TItem, TPage>({\n key,\n queryFn,\n page,\n mapPage,\n enabled,\n meta,\n}: UseAppPaginatedQueryOptions<TItem, TPage>): UseAppPaginatedQueryReturn<TItem, TPage> {\n const query = useQuery<TPage, Error, TPage, QueryKey>(() => {\n const currentPage = toValue(page);\n return {\n queryKey: [...toValue(key), currentPage],\n queryFn: ({ signal }) => resolveQueryResult(queryFn({ page: currentPage, signal })),\n placeholderData: keepPreviousData,\n enabled: toValue(enabled),\n meta,\n };\n });\n\n const items = computed<ReadonlyArray<TItem>>(() => {\n const data = query.data.value;\n if (data === undefined) return [];\n return mapPage ? mapPage(data) : (data as unknown as ReadonlyArray<TItem>);\n });\n\n return {\n items,\n page: query.data,\n loading: computed(() => query.isPending.value && query.isFetching.value),\n error: computed(() => (query.error.value ? toApiFailure(query.error.value) : null)),\n isPlaceholder: query.isPlaceholderData,\n refetch: query.refetch,\n };\n}\n","import type { IHasItems, TokenPage } from '../foundation/http';\n\n// Ergonomic glue between the `foundation/http` pagination contracts (`Page` / `TokenPage`) and the\n// paging hooks — fully additive, so a product binding `TPage = Page<T>` / `TokenPage<T>` drops the\n// hand-written `getNextPageParam` / `mapPage` boilerplate.\n\n/* Extends the `foundation/http` page contracts for the paging hooks (`getNextPageParam` / `mapPage`). /\nexport const PageExtensions = {\n /\n A ready `getNextPageParam` for `useAppInfiniteQuery` over `TokenPage` pages — reads `nextPageToken`,\n * returning `undefined` on the last page (an absent token stops paging).\n \n `useAppInfiniteQuery<TItem, TokenPage<TItem>>({ getNextPageParam: PageExtensions.byPageToken<TItem>() })`\n /\n byPageToken<TItem, TToken = string>(): (lastPage: TokenPage<TItem, TToken>) => TToken \| undefined {\n return (lastPage) => lastPage.nextPageToken;\n },\n\n /\n A ready `mapPage` for any `IHasItems` page — pass `mapPage: PageExtensions.pageItems` instead of\n * `(p) => p.items`.\n /\n pageItems<T>(page: IHasItems<T>): ReadonlyArray<T> {\n return page.items;\n },\n} as const;\n","import { resolveQueryResult } from '../QueryOutcome';\nimport { ResultExtensions, type Result } from '../../../../foundation/results';\nimport { onScopeDispose, shallowRef, toValue, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQueryClient, type QueryKey } from '@tanstack/vue-query';\n\nimport type { ApiFailure } from '../../../../foundation/http';\n\nimport type { AppQueryMeta } from '../CreateQueryClient';\nimport { toApiFailure, queryOutcome } from '../QueryOutcome';\n\n/\n Defines options for `useAppLazyQuery` — `TRaw` first so it infers from `queryFn` (a spread def)\n * and `TData` defaults to it when `map` is absent.\n /\nexport interface UseAppLazyQueryOptions<TRaw, TData = TRaw> {\n /* The cache key (from `queryKeys`) — read at each `fetch()`, so a ref or getter re-keys the next call. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches the raw payload; receives the `AbortSignal`. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<Result<TRaw, ApiFailure>>;\n\n /* Maps the raw payload to the domain shape — identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n\n /* Metadata for the global `onError` seam — `suppressGlobalError: true` keeps this query's failures out. /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents an imperative query's slice — state as refs, plus the two commands. /\nexport interface UseAppLazyQueryReturn<TData> {\n /* The mapped payload from the latest settled `fetch()`, or `undefined` while idle. /\n readonly data: Ref<TData \| undefined>;\n\n /* True while a `fetch()` is in flight. /\n readonly loading: Ref<boolean>;\n\n /* The latest failure coerced to `ApiFailure`, or `null`. /\n readonly error: Ref<ApiFailure \| null>;\n\n /* Runs the request on demand; returns the mapped success or expected failure. /\n readonly fetch: () => Promise<Result<TData, ApiFailure>>;\n\n /* Returns the hook to its idle state and orphans any in-flight call. /\n readonly reset: () => void;\n}\n\n/\n Manages an imperative query — does not fetch on mount; `fetch()` runs the request on demand,\n * caching by key via the client (which dedupes concurrent calls and serves a still-fresh cache entry\n * without refetching — the client's `staleTime` window applies). Drives local `data`/`loading`/`error`\n * state with latest-call-wins semantics: a slower earlier `fetch()` (or one orphaned by `reset`) never\n * overwrites newer state, though every call's promise still settles with its own outcome. `fetch()`\n * returns the mapped success or expected failure, while `error` holds the coerced `ApiFailure`.\n * For fetch-on-submit / export-on-click flows. `reset` returns it to the idle state.\n /\nexport function useAppLazyQuery<TRaw, TData = TRaw>({\n key,\n queryFn,\n map,\n meta,\n}: UseAppLazyQueryOptions<TRaw, TData>): UseAppLazyQueryReturn<TData> {\n const client = useQueryClient();\n\n const data = shallowRef<TData \| undefined>(undefined);\n const loading = shallowRef(false);\n const error = shallowRef<ApiFailure \| null>(null);\n\n // Sequences fetches so only the LATEST call writes state — a slow earlier fetch (or one orphaned\n // by `reset`) settling late must not clobber newer data or resurrect a reset hook. The returned\n // promise still settles with its own outcome for every caller. A plain local: never\n // rendered, so reactivity would be waste.\n let sequence = 0;\n\n const fetch = async (): Promise<Result<TData, ApiFailure>> => {\n const current = ++sequence;\n loading.value = true;\n error.value = null;\n try {\n const outcome = await queryOutcome(() =>\n client.fetchQuery<TRaw, Error, TRaw, QueryKey>({\n queryKey: toValue(key),\n queryFn: ({ signal }) => resolveQueryResult(queryFn({ signal })),\n meta,\n }),\n );\n if (!outcome.ok) {\n if (current === sequence) {\n error.value = outcome.failure;\n loading.value = false;\n }\n return outcome;\n }\n const raw = outcome.value;\n const mapped = map ? map(raw) : (raw as unknown as TData);\n if (current === sequence) {\n data.value = mapped;\n loading.value = false;\n }\n return ResultExtensions.ok(mapped);\n } catch (caught) {\n if (current === sequence) {\n error.value = toApiFailure(caught);\n loading.value = false;\n }\n throw caught;\n }\n };\n\n const reset = (): void => {\n sequence += 1; // orphan any in-flight fetch — its late settle no longer writes state\n data.value = undefined;\n error.value = null;\n loading.value = false;\n };\n\n onScopeDispose(reset);\n return { data, loading, error, fetch, reset };\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { ApiFailure } from '../../../../foundation/http';\nimport type { Result } from '../../../../foundation/results';\nimport { useQueryClient, type QueryKey } from '@tanstack/vue-query';\n\n/* Defines a prefetch target for the query cache — a key paired with its fetcher. /\nexport interface QueryCachePrefetch {\n /* The query key to warm — the same key the live query reads. /\n readonly key: QueryKey;\n\n /* Fetches the data to cache; receives the `AbortSignal`. /\n readonly queryFn: (ctx: { signal: AbortSignal }) => Promise<Result<unknown, ApiFailure>>;\n}\n\n/* Defines the imperative cache accessor returned by `useQueryCache`. /\nexport interface QueryCacheApi {\n /* Reads the cached value at `key`, or `undefined` when absent. /\n readonly get: <TData>(key: QueryKey) => TData \| undefined;\n\n /* Writes `key` — a value, or an updater `(previous) => next` (the TanStack setter form). /\n readonly set: <TData>(key: QueryKey, data: TData \| ((previous: TData \| undefined) => TData)) => void;\n\n /* Marks the queries under `key` stale and refetches the active ones. /\n readonly invalidate: (key: QueryKey) => Promise<void>;\n\n /* Removes the queries under `key` from the cache. /\n readonly remove: (key: QueryKey) => void;\n\n /* Warms `key` in the background — deduped against a live query. /\n readonly prefetch: (target: QueryCachePrefetch) => Promise<void>;\n}\n\n/\n Provides access to the query cache — imperative get/set/invalidate/remove/prefetch by key,\n * wrapping the active `QueryClient`.\n \n Returns a plain object. There is nothing reactive here: every member is a command, and the client\n * is stable for the component's lifetime.\n /\nexport function useQueryCache(): QueryCacheApi {\n const client = useQueryClient();\n\n return {\n get: <TData>(key: QueryKey): TData \| undefined => client.getQueryData<TData>(key),\n set: <TData>(key: QueryKey, data: TData \| ((previous: TData \| undefined) => TData)): void => {\n client.setQueryData<TData>(key, data);\n },\n invalidate: (key: QueryKey): Promise<void> => client.invalidateQueries({ queryKey: key }),\n remove: (key: QueryKey): void => {\n client.removeQueries({ queryKey: key });\n },\n prefetch: ({ key, queryFn }: QueryCachePrefetch): Promise<void> =>\n client.prefetchQuery({ queryKey: key, queryFn: ({ signal }) => resolveQueryResult(queryFn({ signal })) }),\n };\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { ApiFailure } from '../../../../foundation/http';\nimport type { Result } from '../../../../foundation/results';\nimport { useQueryClient, type QueryClient, type QueryKey } from '@tanstack/vue-query';\n\n/* Defines a prefetch target — a query key paired with its fetcher. /\nexport interface PrefetchTarget {\n /* The query key to warm — the same key the live query reads. /\n readonly key: QueryKey;\n\n /* Fetches the data to cache; receives the abort signal the library manages. /\n readonly queryFn: (context: { signal: AbortSignal }) => Promise<Result<unknown, ApiFailure>>;\n}\n\n/\n Defines the hover/focus listeners to `v-bind` onto a link for data prefetch.\n \n `onMouseenter`, not `onMouseEnter`: Vue derives the DOM event name with `hyphenate()`, so a\n * camel-humped `onMouseEnter` key would bind a `mouse-enter` event that never fires.\n /\nexport interface PrefetchProps {\n /* Warms the target query when the pointer enters the link. /\n readonly onMouseenter: () => void;\n\n /* Warms the target query when the link gains focus. /\n readonly onFocus: () => void;\n}\n\n/* Warms a query's data against a client — a background fetch deduped against the live query. /\nfunction warm(client: QueryClient, { key, queryFn }: PrefetchTarget): void {\n void client.prefetchQuery({ queryKey: key, queryFn: ({ signal }) => resolveQueryResult(queryFn({ signal })) });\n}\n\n/* Manages intent-based data prefetch — returns a `prefetch(target)` that warms a query on hover/focus. /\nexport function usePrefetchQuery(): (target: PrefetchTarget) => void {\n const client = useQueryClient();\n\n return (target: PrefetchTarget) => warm(client, target);\n}\n\n/* Builds hover/focus prefetch listeners. The explicit client isolates app roots and server requests. /\nexport function prefetchProps(target: PrefetchTarget, client: QueryClient): PrefetchProps {\n const run = (): void => {\n warm(client, target);\n };\n return { onMouseenter: run, onFocus: run };\n}\n","import { resolveQueryResult } from '../QueryOutcome';\nimport type { ApiFailure } from '../../../../foundation/http';\nimport type { Result } from '../../../../foundation/results';\nimport { toValue, type MaybeRefOrGetter, type Ref } from 'vue';\nimport { useQuery, type QueryKey } from '@tanstack/vue-query';\n\nimport type { AppQueryMeta } from '../CreateQueryClient';\n\n/\n Defines a suspenseful query — a key, a fetcher, and an optional raw→view mapper. `TRaw` first so\n * it infers from `queryFn` (a spread def); `TData` defaults to it when `map` is absent.\n /\nexport interface AppSuspenseQueryOptions<TRaw, TData = TRaw> {\n /* The query key that identifies and caches this query. /\n readonly key: MaybeRefOrGetter<QueryKey>;\n\n /* Fetches the raw data; receives the abort signal the library manages. /\n readonly queryFn: (context: { signal: AbortSignal }) => Promise<Result<TRaw, ApiFailure>>;\n\n /* Maps the raw fetched shape to the view shape; identity when omitted. /\n readonly map?: (raw: TRaw) => TData;\n\n /\n Metadata for the global `onError` seam — `suppressGlobalError: true` keeps this query's failures\n * out (boundary-handled errors would otherwise double-surface).\n /\n readonly meta?: AppQueryMeta;\n}\n\n/* Represents a resolved suspenseful query — `data` is already filled when the composable resolves. /\nexport interface AppSuspenseQueryReturn<TData> {\n /* The resolved payload. Defined on resolve, and kept live afterwards. /\n readonly data: Ref<TData>;\n\n /* Refetches the query. /\n readonly refetch: () => unknown;\n}\n\n/\n Manages a suspenseful query — the composable AWAITS the first resolution, so a `<script setup>`\n * that awaits it suspends until data is there.\n \n ```vue\n * <script setup lang=\"ts\">\n * const { data } = await useAppSuspenseQuery({ key: ['user'], queryFn });\n * </script>\n * ```\n \n `@tanstack/vue-query` ships no `useSuspenseQuery` — Vue suspends on an async `setup()` rather than\n * on a thrown promise, so the library exposes `suspense()` on the query result and this awaits it.\n * That makes this composable ASYNC where React's was synchronous, the one shape change the two\n * suspense models force.\n \n The caller still owns both boundaries: a `<Suspense>` for loading, and an error boundary for\n * failure — a rejected query rejects this promise and bubbles past the hook.\n /\nexport async function useAppSuspenseQuery<TRaw, TData = TRaw>({\n key,\n queryFn,\n map,\n meta,\n}: AppSuspenseQueryOptions<TRaw, TData>): Promise<AppSuspenseQueryReturn<TData>> {\n const query = useQuery<TRaw, Error, TData, QueryKey>(() => ({\n queryKey: toValue(key),\n queryFn: ({ signal }) => resolveQueryResult(queryFn({ signal })),\n select: map,\n meta,\n }));\n\n const result = await query.suspense();\n if (result.error) throw result.error; // `suspense()` settles on failure too — rethrow for the boundary\n\n // `data` is `Ref<TData \| undefined>` in general; the await above is what makes it defined here.\n return { data: query.data as Ref<TData>, refetch: query.refetch };\n}\n","import { defineComponent, onScopeDispose, watch } from 'vue';\nimport { useIsFetching, useIsMutating } from '@tanstack/vue-query';\n\n// Deep import (not the `../router` barrel): the barrel statically imports vue-router, and a barrel\n// import here would merge the whole router graph into the shared chunk `/query` loads — breaking\n// `/query`'s isolation from the OPTIONAL vue-router peer. `UseNavigationProgress` is plain Vue.\nimport { useNavigationProgress } from '../../../router/hooks/UseNavigationProgress';\n\n/\n Lights the router's manual heartbeat while the query layer has any fetch or mutation in flight.\n \n Call inside BOTH a query client scope (`queryPlugin` / `<QueryProvider>`) and a `<ProgressProvider>`\n * — `useNavigationProgress` THROWS outside one. Wires effects only; it drives\n * `<NavigationProgress variant=\"heartbeat\" mode=\"manual\" />`.\n /\nexport function useQueryProgressBridge(): void {\n const fetching = useIsFetching();\n const mutating = useIsMutating();\n const { begin } = useNavigationProgress();\n\n let end: (() => void) \| null = null;\n\n // Open a manual busy span on 0→>0, close it on >0→0. `flush: 'sync'` is deliberately NOT used —\n // the default pre-flush is enough, and the callback touches no browser global, so it is SSR-safe\n // even though `immediate` runs it on the server.\n watch(\n () => fetching.value + mutating.value,\n (activity) => {\n if (activity > 0 && end === null) end = begin();\n else if (activity === 0 && end !== null) {\n end();\n end = null;\n }\n },\n { immediate: true },\n );\n\n // Close any still-open span when the bridge's scope is disposed mid-request.\n onScopeDispose(() => {\n end?.();\n end = null;\n });\n}\n\n/\n Renders nothing; wires `useQueryProgressBridge`.\n \n The component form React shipped, kept so an app can drop `<QueryProgressBridge />` into its\n * shell unchanged. Authored as a `defineComponent` rather than an SFC — it has no template.\n /\nexport const QueryProgressBridge = defineComponent({\n name: 'QueryProgressBridge',\n setup() {\n useQueryProgressBridge();\n return () => null;\n },\n});\n","<script lang=\"ts\">\n/* Defines the props for {@link QueryDevtools}. /\nexport interface QueryDevtoolsProps {\n /* Whether the panel starts open. Default `false`. /\n readonly initialIsOpen?: boolean;\n}\n\n/\n * The devtools specifier, assembled at runtime.\n \n `@tanstack/vue-query-devtools` is NOT a dependency of this package — devtools are the app's\n * choice, and a library must not force one. A literal specifier would make the bundler resolve\n * (and therefore require) it at build time even inside a dead `import.meta.env.DEV` branch, so the\n * string is built here and the import stays opaque. The app installs the package to get the panel;\n * without it the component renders nothing and says nothing.\n /\nconst DevtoolsPackage = ['@tanstack', 'vue-query-devtools'].join('/');\n</script>\n\n<script setup lang=\"ts\">\nimport { onMounted, shallowRef, type Component } from 'vue';\n\n/* Renders the TanStack Query devtools in dev only, when the optional devtools package is installed. /\ndefineOptions({ name: 'QueryDevtools' });\n\nconst props = withDefaults(defineProps<QueryDevtoolsProps>(), { initialIsOpen: false });\n\nconst devtools = shallowRef<Component \| null>(null);\n\n// `onMounted` never runs on the server, and the import is dev-only — production tree-shakes the\n// branch away because `import.meta.env.DEV` is statically false there.\nonMounted(async () => {\n if (!import.meta.env.DEV) return;\n try {\n const module = (await import(/ @vite-ignore / DevtoolsPackage)) as { VueQueryDevtools?: Component };\n devtools.value = module.VueQueryDevtools ?? null;\n } catch {\n // Devtools not installed — the normal case for an app that never opted in.\n }\n});\n</script>\n\n<template>\n <component :is=\"devtools\" v-if=\"devtools\" :initial-is-open=\"props.initialIsOpen\" />\n</template>\n","import { dehydrate, hydrate, type DehydratedState, type QueryClient, type QueryKey } from '@tanstack/vue-query';\n\nconst DefaultStorageKey = 'app:query-cache';\nconst DefaultMaxAgeMs = 24 60 * 60_000; // 24h\nconst WriteThrottleMs = 1_000;\n\n/** The envelope written to storage — the dehydrated cache plus what restore has to validate before trusting it. /\ninterface PersistedSnapshot {\n readonly buster: string;\n readonly timestamp: number;\n readonly state: DehydratedState;\n}\n\n/* Defines options for `setupQueryPersistence`. /\nexport interface SetupQueryPersistenceOptions {\n /* Explicit allowlist predicate, used on both write and restore. Scope keys to this identity/tenant. /\n readonly includes: (key: QueryKey) => boolean;\n /* The `localStorage` key the dehydrated cache is written under. /\n readonly storageKey?: string;\n /* The max age of a restored cache in ms; an older cache is discarded on restore. /\n readonly maxAgeMs?: number;\n /* A cache-busting string; a mismatch discards the persisted cache. /\n readonly buster?: string;\n}\n\n/* Represents the handles returned by `setupQueryPersistence`. /\nexport interface QueryPersistenceHandle {\n /* Stops persisting further cache changes. /\n readonly unsubscribe: () => void;\n /* Resolves once the persisted cache has been restored into the client. /\n readonly restored: Promise<void>;\n}\n\n/\n Wires `localStorage` persistence for the query cache (opt-in — call from `main.ts`); returns null\n * when there is no `window` (SSR-safe).\n \n Built on `dehydrate` / `hydrate` straight out of `@tanstack/vue-query` rather than on the\n * `persist-client` + `sync-storage-persister` package pair: those two are separate installs, and the\n * whole of what they add over this is an async persister interface this synchronous store does not\n * need. The restore is therefore SYNCHRONOUS — the cache is already hydrated when the call returns,\n * and `restored` is an already-settled promise kept for API parity.\n \n Caveats to weigh before opting in:\n * - Sensitive data — every allowlisted successful query dehydrates into `localStorage` in plain text,\n * including authenticated user data; any script on the origin can read it. Do not enable on apps\n * whose cache holds secrets/PII, or scope what queries cache to begin with.\n * - Version busting — pass `buster` (e.g. the app version) whenever a release changes cached\n * shapes; a restored stale shape otherwise flows into typed hooks unchecked.\n * - Quota — a full `localStorage` makes the write silently fail (no retry strategy is wired);\n * the app keeps working, persistence just lags.\n * - Rich values — this JSON persistence does not preserve Temporal objects or class instances.\n * Allowlist only JSON payload caches; keep decoded rich values in computed presentation mappings.\n /\nexport function setupQueryPersistence(\n client: QueryClient,\n options: SetupQueryPersistenceOptions,\n): QueryPersistenceHandle \| null {\n if (typeof window === 'undefined') return null;\n\n const { storageKey = DefaultStorageKey, maxAgeMs = DefaultMaxAgeMs, buster = '', includes } = options;\n\n restore(client, storageKey, maxAgeMs, buster, includes);\n\n // Throttled: a burst of cache events (one query settling touches the cache several times) must not\n // serialize the whole cache once per event.\n let timer: ReturnType<typeof setTimeout> \| null = null;\n const schedule = (): void => {\n if (timer !== null) return;\n timer = setTimeout(() => {\n timer = null;\n write(client, storageKey, buster, includes);\n }, WriteThrottleMs);\n };\n\n const unsubscribeQueries = client.getQueryCache().subscribe(schedule);\n const unsubscribeMutations = client.getMutationCache().subscribe(schedule);\n\n return {\n unsubscribe: () => {\n unsubscribeQueries();\n unsubscribeMutations();\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n },\n restored: Promise.resolve(),\n };\n}\n\n/* Hydrates the client from storage when the snapshot is present, current, and matches the buster. /\nfunction restore(\n client: QueryClient,\n storageKey: string,\n maxAgeMs: number,\n buster: string,\n includes: (key: QueryKey) => boolean,\n): void {\n try {\n const raw = window.localStorage.getItem(storageKey);\n if (!raw) return;\n\n const snapshot = JSON.parse(raw) as PersistedSnapshot;\n const isStale =\n !Number.isFinite(snapshot.timestamp) \|\|\n snapshot.timestamp > Date.now() \|\|\n Date.now() - snapshot.timestamp > maxAgeMs;\n if (snapshot.buster !== buster \|\| isStale) {\n window.localStorage.removeItem(storageKey);\n return;\n }\n\n if (!snapshot.state \|\| !Array.isArray(snapshot.state.queries)) return;\n // Mutations are never persisted. Recheck the allowlist before hydration touches the client.\n const queries = snapshot.state.queries.filter((query) => Array.isArray(query.queryKey) && includes(query.queryKey));\n hydrate(client, { queries, mutations: [] });\n } catch {\n // Unreadable / unparseable / storage unavailable — a missing cache is always a valid state.\n }\n}\n\n/* Serializes the dehydrated cache into storage, tolerating storage being unavailable (private mode / quota). */\nfunction write(client: QueryClient, storageKey: string, buster: string, includes: (key: QueryKey) => boolean): void {\n try {\n const snapshot: PersistedSnapshot = {\n buster,\n timestamp: Date.now(),\n state: dehydrate(client, {\n shouldDehydrateQuery: (query) => query.state.status === 'success' && includes(query.queryKey),\n shouldDehydrateMutation: () => false,\n }),\n };\n window.localStorage.setItem(storageKey, JSON.stringify(snapshot));\n } catch {\n // Persistence is best-effort — swallow.\n }\n}\n"],"names":["_renderSlot","_openBlock","_createBlock","_resolveDynamicComponent"],"mappings":"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"}

package/dist/router/Paths.d.ts CHANGED Viewed

@@ -4,15 +4,13 @@ export type PathParamName<Template extends string> = Template extends `${string}
 export type PathParams<Template extends string> = {
     readonly [Key in PathParamName<Template>]: string;
 };
-/** Defines a path builder's argument tuple — empty when the template declares no `:params`, else one required params object. */
-export type PathBuilderArgs<Template extends string> = [
-    PathParamName<Template>
-] extends [never] ? [] : [params: PathParams<Template>];
-/** Defines a typed path builder — call with the template's params for the concrete href; `.pattern` is the route-table template. */
+/** Defines a path builder's argument tuple — empty when the template has no `:params`, else one params object. */
+export type PathBuilderArgs<Template extends string> = [PathParamName<Template>] extends [never] ? [] : [params: PathParams<Template>];
+/** Defines a typed path builder — call with the template's params for the href; `.pattern` is the route template. */
 export interface PathBuilder<Template extends string> {
     (...args: PathBuilderArgs<Template>): string;
     /** The route pattern template (e.g. `/projects/:id`) — used as the route table's `path`. */
     readonly pattern: Template;
 }
-/** Creates a typed path builder from a route template — substitutes + URL-encodes each `:param`, and carries the template as `.pattern`. */
+/** Creates a typed path builder — substitutes + URL-encodes each `:param`, and carries the template as `.pattern`. */
 export declare function definePath<const Template extends string>(template: Template): PathBuilder<Template>;

package/dist/router/ProgressProvider.vue.d.ts CHANGED Viewed

@@ -1,13 +1,12 @@
-import { NavigationProgressState } from './UseNavigationProgress';
-import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { NavigationProgressState } from './hooks/UseNavigationProgress';
 /** Defines the props for {@link ProgressProvider}. */
 export interface ProgressProviderProps {
     /** An externally created state to provide (from `createNavigationProgress()`); a fresh one when omitted. */
-    state?: NavigationProgressState;
+    readonly state?: NavigationProgressState;
 }
-declare const _default: __VLS_WithSlots< DefineComponent<ProgressProviderProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ProgressProviderProps> & Readonly<{}>, {
-    state: NavigationProgressState;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+declare const _default: __VLS_WithSlots<import('vue').DefineComponent<ProgressProviderProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<ProgressProviderProps> & Readonly<{}>, {
+    readonly state: NavigationProgressState;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>, {
     /** The subtree that can drive and observe the shared manual busy state. */
     default(): unknown;
 }>;

package/dist/router/adapters/vueRouter/CreateAppRouter.d.ts ADDED Viewed

@@ -0,0 +1,65 @@
+import { Component } from 'vue';
+import { Router } from 'vue-router';
+import { PageView } from './PageViewTracker';
+import { RouteConfig } from './RouteConfig';
+import { RoutePersistenceOptions } from './RoutePersistence';
+/**
+ * Defines the history strategy the router uses.
+ *
+ * Named `RouterHistoryMode`, not `RouterHistory`: vue-router exports a `RouterHistory` TYPE for the
+ * history object itself, and one name for two things in the same import graph is a trap.
+ * `RouterHistory` stays exported as an alias so existing call sites keep compiling.
+ */
+export declare const RouterHistoryMode: {
+    /** Refers to the HTML5 History API — clean URLs (default). */
+    readonly Browser: "browser";
+    /** Refers to hash-based history — static hosting / file protocol. */
+    readonly Hash: "hash";
+    /** Refers to in-memory history — SSR and tests; no URL bar involvement. */
+    readonly Memory: "memory";
+};
+export type RouterHistoryMode = (typeof RouterHistoryMode)[keyof typeof RouterHistoryMode];
+/** @deprecated Alias for {@link RouterHistoryMode} — collides with vue-router's own `RouterHistory` type. */
+export declare const RouterHistory: {
+    /** Refers to the HTML5 History API — clean URLs (default). */
+    readonly Browser: "browser";
+    /** Refers to hash-based history — static hosting / file protocol. */
+    readonly Hash: "hash";
+    /** Refers to in-memory history — SSR and tests; no URL bar involvement. */
+    readonly Memory: "memory";
+};
+/** @deprecated Alias for {@link RouterHistoryMode} — collides with vue-router's own `RouterHistory` type. */
+export type RouterHistory = RouterHistoryMode;
+/** Options for `createAppRouter` — every field defaults sensibly; apps usually pass none. */
+export interface CreateAppRouterOptions {
+    /** A leading path prefix for every route — vue-router's history `base`. */
+    readonly basename?: string;
+    /** Overrides the built-in `*` catch-all page. */
+    readonly notFound?: Component;
+    /** Whether to restore scroll position across navigations. Default `true`. */
+    readonly scrollRestoration?: boolean;
+    /** The document-title suffix (usually the app name) applied on every navigation. */
+    readonly titleSuffix?: string;
+    /** The history strategy. Default `RouterHistoryMode.Browser` — and always memory history without a `window`. */
+    readonly history?: RouterHistoryMode;
+    /** Emits a page-view on each navigation — an analytics sink; when set, installs a page-view tracker. */
+    readonly onPageView?: (view: PageView) => void;
+    /** Route persistence settings, or `false` to install none. Default: installed (persist on, restore off). */
+    readonly routePersistence?: RoutePersistenceOptions | false;
+}
+/**
+ * Builds the app's router from a declarative `RouteConfig`. The app declares its routes; this wrapper
+ * owns the vue-router machinery — scroll behavior, the catch-all, and the root-mounted behaviors
+ * (title · meta tags · route persistence · page views). vue-router installs as a plugin and has no
+ * root element, so those behaviors are router hooks registered here; each is separately exported as
+ * an `install*` function.
+ *
+ * It is the single extension point: cross-cutting routing behavior is added here, every consumer
+ * inherits it.
+ *
+ * ```ts
+ * const router = createAppRouter(routes, { titleSuffix: 'Acme' });
+ * createApp(App).use(router).mount('#app');
+ * ```
+ */
+export declare function createAppRouter(config: RouteConfig, options?: CreateAppRouterOptions): Router;

package/dist/router/adapters/vueRouter/DocumentMeta.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { Router } from 'vue-router';
+/**
+ * Syncs document `<meta>` tags to the deepest matched route's `handle.meta` (description, `og:*`, and
+ * arbitrary keys). Returns the unregister function.
+ *
+ * `handle.meta` may be a literal or a `RouteHandleResolver` — the resolver form is what gives a
+ * `:slug` route a title and description derived from its params, since a static handle cannot know
+ * them. A resolver returning `undefined` falls through to the next-shallowest match.
+ *
+ * React's null-rendering `<DocumentMeta>` becomes an `afterEach` hook, for the same reason
+ * `installDocumentTitle` does; `createAppRouter` wires it for you. No-op without a `document` (SSR).
+ */
+export declare function installDocumentMeta(router: Router): () => void;

package/dist/router/adapters/vueRouter/Guards.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+import { LocationQuery } from 'vue-router';
+import { RouteGuard } from './RouteConfig';
+/** The shapes `resolveReturnTo` reads a `returnTo` out of — a query string, parsed params, or `route.query`. */
+export type ReturnToSource = URLSearchParams | string | LocationQuery;
+/**
+ * Builds a route guard that allows activation when authenticated, else redirects to `loginPath`
+ * with the attempted path+search captured as a `returnTo` query param for post-login restore.
+ *
+ * Takes an `isAuthenticated` callback so the check stays app-owned — pass a stub today, swap the
+ * real one in later without touching any route.
+ *
+ * @example
+ * const isAuthenticated = () => Boolean(localStorage.getItem('token'));
+ * // { path: '/library', guard: requireAuth(isAuthenticated), lazy: … }
+ */
+export declare function requireAuth(isAuthenticated: () => boolean | Promise<boolean>, loginPath?: string): RouteGuard;
+/**
+ * Builds a login redirect (`{loginPath}?returnTo=…`) encoding the attempted path+search.
+ * `from` accepts a full URL or a root-relative `fullPath`.
+ */
+export declare function buildReturnTo(loginPath: string, from: string): string;
+/** Resolves the safe same-origin return path from a `returnTo` param, rejecting open-redirect targets → `fallback`. */
+export declare function resolveReturnTo(search: ReturnToSource, fallback?: string): string;
+/**
+ * Provides access to the safe post-login return path read from the current URL's `returnTo` param.
+ *
+ * Returns a `ComputedRef`, not a bare string — the value has to track `route.query`.
+ */
+export declare function useReturnTo(fallback?: MaybeRefOrGetter<string>): ComputedRef<string>;
+/** @internal Reports whether a target is a same-origin root-relative path — the open-redirect guard. */
+export declare function isSafeInternalPath(target: string): boolean;

package/dist/router/adapters/vueRouter/LazyRoute.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import { Component } from 'vue';
+import { LazyRoute } from './RouteConfig';
+/**
+ * Forces a full reload to fetch the current deploy's chunk manifest — a last resort for a persistent
+ * chunk-load failure. No-op without a `window` (SSR).
+ */
+export declare function reloadOnChunkError(): void;
+/**
+ * Wraps a code-split importer so a transient chunk-load failure — typically a stale deploy whose
+ * hashed chunk no longer exists after a redeploy — retries once after a short delay before
+ * rejecting. A persistent failure rejects so the router's error handling catches it. Stays
+ * type-compatible with `LazyRoute`.
+ */
+export declare function lazyRoute(importer: LazyRoute): LazyRoute;
+/**
+ * @internal Normalizes a `default | Component` lazy module into the single component vue-router's
+ * async `component` loader expects.
+ */
+export declare function toAsyncComponent(lazy: LazyRoute): () => Promise<Component>;

package/dist/router/adapters/vueRouter/RouteConfig.d.ts ADDED Viewed

@@ -0,0 +1,97 @@
+import { Component, VNode } from 'vue';
+import { RouteLocationNormalized, RouteLocationRaw, RouteParamsGeneric } from 'vue-router';
+/** Defines a breadcrumb label. */
+export type CrumbNode = string | VNode;
+/**
+ * Defines per-route meta tags surfaced to the document head (read off the deepest match's `meta.meta`).
+ *
+ * A key beginning `og:` is written as `<meta property="…">`, which the Open Graph spec requires and
+ * scrapers key on; every other key is written as `<meta name="…">`, the form Twitter cards and
+ * `description` use. The prefix IS the discriminator — there is no second field to set.
+ */
+export interface RouteMeta {
+    /** The meta description for this route. */
+    readonly description?: string;
+    readonly [key: string]: string | undefined;
+}
+/**
+ * Defines a per-route value computed from the active location — the escape hatch for anything a
+ * static handle cannot know, a `:slug` page's title being the case that forces it.
+ *
+ * Runs on every navigation, so it must stay synchronous and cheap: read `route.params` / `route.query`
+ * and a module-scope lookup, never fetch. A page whose title only exists after a request sets it from
+ * the component instead, once the data lands.
+ */
+export type RouteHandleResolver<TValue> = (route: RouteLocationNormalized) => TValue | undefined;
+/** Defines the outcome of a route guard — `true` to allow activation, or a location to redirect to. */
+export type GuardDecision = true | {
+    readonly redirect: RouteLocationRaw;
+};
+/**
+ * Defines the context a route guard receives.
+ *
+ * React's guards ran inside a react-router loader and read a `Request`; vue-router guards run as
+ * `beforeEnter` and receive the two normalized locations instead. `params` is `to.params`, kept
+ * under React's name because guards read it constantly.
+ */
+export interface GuardContext {
+    /** The location being navigated to. */
+    readonly to: RouteLocationNormalized;
+    /** The location being navigated from. */
+    readonly from: RouteLocationNormalized;
+    /** The matched path params — the same object as `to.params`. */
+    readonly params: RouteParamsGeneric;
+}
+/** Defines a route guard — runs before the route activates; returns allow (`true`) or a redirect. */
+export type RouteGuard = (context: GuardContext) => GuardDecision | Promise<GuardDecision>;
+/**
+ * Defines per-route metadata surfaced to breadcrumbs / title / analytics — app keys pass through
+ * untouched. Compiles into the route record's native vue-router `meta`, so `route.meta.title`
+ * reads it without any helper.
+ */
+export interface RouteHandle {
+    /** The breadcrumb label for this route. */
+    readonly crumb?: CrumbNode;
+    /** The document title for this route, or a resolver against the active location. */
+    readonly title?: string | RouteHandleResolver<string>;
+    /** The per-route meta tags (description / og) for the document head, or a resolver against the active location. */
+    readonly meta?: RouteMeta | RouteHandleResolver<RouteMeta>;
+    readonly [key: string]: unknown;
+}
+/** Defines a code-split route module — resolves to a `default` or a named `Component` export. */
+export type LazyRoute = () => Promise<{
+    default: Component;
+} | {
+    Component: Component;
+}>;
+/**
+ * Defines the declarative route unit an app authors — a curated subset of vue-router's
+ * `RouteRecordRaw`. `createAppRouter` compiles it: guards become `beforeEnter`, `handle` becomes
+ * `meta`, `id` becomes `name`, and the `*` catch-all is appended for you.
+ */
+export interface AppRoute {
+    /** The path segment, relative to the parent. Omit for a pathless layout route. */
+    readonly path?: string;
+    /** Renders in the parent's `<RouterView>` — compiles to a child with `path: ''`. Mutually exclusive with `path`. */
+    readonly index?: boolean;
+    /** The eager component. Use `lazy` to code-split instead. */
+    readonly component?: Component;
+    /** A `*Layout` rendering a `<RouterView>`; an alias of `component`, kept for the React authoring shape. */
+    readonly layout?: Component;
+    /** A code-split module for this route — preferred for pages. */
+    readonly lazy?: LazyRoute;
+    /** Redirect this route to another location. Combined with `guard`, the guards run first (React's ordering). */
+    readonly redirect?: RouteLocationRaw;
+    /** A guard (or chain) run before activation — compiles to the record's `beforeEnter`. */
+    readonly guard?: RouteGuard | ReadonlyArray<RouteGuard>;
+    /** Per-route metadata (crumb / title / meta / app keys) — compiles to the record's `meta`. */
+    readonly handle?: RouteHandle;
+    /** A route-scoped error component; `AppErrorBoundary` renders it instead of its own fallback. */
+    readonly errorComponent?: Component;
+    /** Nested child routes. */
+    readonly children?: ReadonlyArray<AppRoute>;
+    /** A stable id — compiles to the record's `name`, vue-router's stable identity. */
+    readonly id?: string;
+}
+/** Defines the full route tree an app passes to `createAppRouter`. */
+export type RouteConfig = ReadonlyArray<AppRoute>;