@svadmin/core 0.30.0 → 0.32.0

package/src/mutation-hooks.svelte.ts

@@ -1,7 +1,8 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import { createMutation, useQueryClient } from '@tanstack/svelte-query';
 import { getAdminOptions } from './options.svelte';
-import { getDataProviderForResource, getResource, getLiveProvider } from './context.svelte';
+import { captureAdminContext } from './context.svelte';
+import type { AdminContextAccessor } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
 import { audit } from './audit';
 import { UndoError } from './types';
@@ -12,9 +13,14 @@ import { toast } from './toast.svelte';
 
 // ─── Helper: publish live events after mutations ────────────────
 
-export function publishLiveEvent(resource: string, type: 'created' | 'updated' | 'deleted', ids?: (string | number)[]) {
+export function publishLiveEvent(
+  resource: string,
+  type: 'created' | 'updated' | 'deleted',
+  ids?: (string | number)[],
+  adminContext: AdminContextAccessor = captureAdminContext(),
+) {
   try {
-    const liveProvider = getLiveProvider();
+    const liveProvider = adminContext.liveProvider;
     if (liveProvider?.publish) {
       liveProvider.publish({
         type: type === 'created' ? 'INSERT' : type === 'updated' ? 'UPDATE' : 'DELETE',
@@ -42,7 +48,9 @@ export function invalidateByScopes(
 ): void {
   if (scopes === false) return;
   const effectiveScopes = (scopes && scopes.length > 0) ? scopes : defaults;
-  const dpMatch = (q: { queryKey: readonly unknown[] }) => q.queryKey[0] === dataProviderName;
+  const dpMatch = dataProviderName === undefined
+    ? () => true
+    : (q: { queryKey: readonly unknown[] }) => q.queryKey[0] === dataProviderName;
   for (const scope of effectiveScopes) {
     if (scope === 'list') queryClient.invalidateQueries({ predicate: (q) => dpMatch(q) && q.queryKey[1] === resource && (q.queryKey[2] === 'list' || q.queryKey[2] === 'infiniteList' || q.queryKey[2] === 'select' || q.queryKey[2] === 'select-defaults') });
     else if (scope === 'many') queryClient.invalidateQueries({ predicate: (q) => dpMatch(q) && q.queryKey[1] === resource && q.queryKey[2] === 'many' });
@@ -99,6 +107,7 @@ export interface UseCreateMutateParams<TVariables> {
 }
 
 export function useCreate<TData extends BaseRecord = BaseRecord, TError = HttpError, TVariables = Record<string, unknown>>(options: UseCreateOptions = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const defaultResource = options.resource ?? parsed.resource ?? '';
   const adminOptions = getAdminOptions();
@@ -114,7 +123,7 @@ export function useCreate<TData extends BaseRecord = BaseRecord, TError = HttpEr
     ...options.mutationOptions,
     mutationFn: async (params) => {
       const resName = params.resource ?? defaultResource;
-      const provider = getDataProviderForResource(resName, params.dataProviderName);
+      const provider = adminContext.getDataProviderForResource(resName, params.dataProviderName);
       return await provider.create<TData, TVariables>({
           resource: resName,
           variables: params.variables,
@@ -125,11 +134,11 @@ export function useCreate<TData extends BaseRecord = BaseRecord, TError = HttpEr
     onSuccess: (data, params, context) => {
       const resName = params.resource ?? defaultResource;
       fireSuccessNotification(params.successNotification, 'Created successfully', data.data, params.variables, resName);
-      const res = getResource(resName);
+      const res = adminContext.getResource(resName);
       const pk = res.primaryKey ?? 'id';
       const newId = (data.data as Record<string, unknown>)[pk];
       audit({ action: 'create', resource: resName, recordId: String(newId) });
-      publishLiveEvent(resName, 'created', newId != null ? [newId as string | number] : undefined);
+      publishLiveEvent(resName, 'created', newId != null ? [newId as string | number] : undefined, adminContext);
       // Invalidation in onSuccess for create (refine pattern — no optimistic data to reconcile on error)
       invalidateByScopes(queryClient, resName, params.invalidates, ['list', 'many'], undefined, params.dataProviderName);
       if (typeof options.mutationOptions?.onSuccess === 'function') {
@@ -137,7 +146,7 @@ export function useCreate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       }
     },
     onError: (error, params, context) => {
-      checkError(error);
+      checkError(error, adminContext);
       fireErrorNotification(params.errorNotification, 'Create failed', error, params.resource ?? defaultResource);
       if (typeof options.mutationOptions?.onError === 'function') {
         (options.mutationOptions.onError as (...a: unknown[]) => unknown)(error, params, context);
@@ -177,6 +186,7 @@ export interface UseUpdateMutateParams<TVariables> {
 }
 
 export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpError, TVariables = Record<string, unknown>>(options: UseUpdateOptions = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const defaultResource = options.resource ?? parsed.resource ?? '';
   const defaultId = options.id ?? parsed.id;
@@ -207,7 +217,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
         });
       }
 
-      const provider = getDataProviderForResource(resName, params.dataProviderName);
+      const provider = adminContext.getDataProviderForResource(resName, params.dataProviderName);
       return await provider.update<TData, TVariables>({
           resource: resName,
           id: targetId,
@@ -229,7 +239,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
 
       const previousQueries = queryClient.getQueriesData({ predicate: (q) => dp(q) && q.queryKey[1] === resName });
       
-      const pk = getResource(resName).primaryKey ?? 'id';
+      const pk = adminContext.getResource(resName).primaryKey ?? 'id';
       const updater = params.optimisticUpdateMap ?? { list: true, many: true, detail: true };
       
       if (updater.detail !== false) {
@@ -267,7 +277,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       const targetId = params.id ?? defaultId;
       fireSuccessNotification(params.successNotification, 'Updated successfully', data.data, params.variables, resName);
       audit({ action: 'update', resource: resName, recordId: String(targetId) });
-      publishLiveEvent(resName, 'updated', targetId != null ? [targetId] : undefined);
+      publishLiveEvent(resName, 'updated', targetId != null ? [targetId] : undefined, adminContext);
       if (typeof options.mutationOptions?.onSuccess === 'function') {
         (options.mutationOptions.onSuccess as (...a: unknown[]) => unknown)(data, params, extractedCtx);
       }
@@ -289,7 +299,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
         }
       }
       if (error instanceof UndoError) return;
-      checkError(error);
+      checkError(error, adminContext);
       const extractedCtx = ctx?._svadmin_ctx ? ctx.userContext : context;
       fireErrorNotification(params.errorNotification, 'Update failed', error, params.resource ?? defaultResource);
       if (typeof options.mutationOptions?.onError === 'function') {
@@ -325,6 +335,7 @@ export interface UseDeleteMutateParams<TVariables> {
 }
 
 export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpError, TVariables = Record<string, unknown>>(options: UseDeleteOptions = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const defaultResource = options.resource ?? parsed.resource ?? '';
   const defaultId = options.id ?? parsed.id;
@@ -355,7 +366,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
         });
       }
 
-      const provider = getDataProviderForResource(resName, params.dataProviderName);
+      const provider = adminContext.getDataProviderForResource(resName, params.dataProviderName);
       return await provider.deleteOne<TData, TVariables>({
           resource: resName,
           id: targetId,
@@ -377,7 +388,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
 
       const previousQueries = queryClient.getQueriesData({ predicate: (q) => dp(q) && q.queryKey[1] === resName });
       
-      const pk = getResource(resName).primaryKey ?? 'id';
+      const pk = adminContext.getResource(resName).primaryKey ?? 'id';
       
       if (targetId != null) queryClient.removeQueries({ predicate: (q) => dp(q) && q.queryKey[1] === resName && q.queryKey[2] === 'one' && q.queryKey[3] === targetId });
 
@@ -408,7 +419,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
 
       fireSuccessNotification(params.successNotification, 'Deleted successfully', data.data, params.variables, resName);
       audit({ action: 'delete', resource: resName, recordId: String(targetId) });
-      publishLiveEvent(resName, 'deleted', targetId != null ? [targetId] : undefined);
+      publishLiveEvent(resName, 'deleted', targetId != null ? [targetId] : undefined, adminContext);
       if (typeof options.mutationOptions?.onSuccess === 'function') {
         (options.mutationOptions.onSuccess as (...a: unknown[]) => unknown)(data, params, extractedCtx);
       }
@@ -430,7 +441,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
         }
       }
       if (error instanceof UndoError) return;
-      checkError(error);
+      checkError(error, adminContext);
       const extractedCtx = ctx?._svadmin_ctx ? ctx.userContext : context;
       fireErrorNotification(params.errorNotification, 'Delete failed', error, params.resource ?? defaultResource);
       if (typeof options.mutationOptions?.onError === 'function') {

package/src/permissions.svelte.ts

@@ -9,6 +9,7 @@ export interface CanParams {
   resource: string;
   action: Action;
   params?: { id?: string | number; [key: string]: unknown };
+  meta?: Record<string, unknown>;
 }
 
 export interface CanResult {
@@ -81,8 +82,8 @@ export function getAccessControlOptions() {
  * Supports both single capability requests or an array of batched checks.
  */
 export async function canAccessAsync(params: CanParams[]): Promise<CanResult[]>;
-export async function canAccessAsync(resource: string, action: Action, params?: Record<string, unknown>): Promise<CanResult>;
-export async function canAccessAsync(resourceOrBatch: string | CanParams[], action?: Action, params?: Record<string, unknown>): Promise<CanResult | CanResult[]> {
+export async function canAccessAsync(resource: string, action: Action, params?: Record<string, unknown>, meta?: Record<string, unknown>): Promise<CanResult>;
+export async function canAccessAsync(resourceOrBatch: string | CanParams[], action?: Action, params?: Record<string, unknown>, meta?: Record<string, unknown>): Promise<CanResult | CanResult[]> {
   if (!provider) {
     return Array.isArray(resourceOrBatch)
       ? resourceOrBatch.map(() => ({ can: true }))
@@ -93,7 +94,7 @@ export async function canAccessAsync(resourceOrBatch: string | CanParams[], acti
     return provider.can(resourceOrBatch);
   }
   
-  return provider.can({ resource: resourceOrBatch, action: action as string, params }) as Promise<CanResult>;
+  return provider.can({ resource: resourceOrBatch, action: action as string, params, meta }) as Promise<CanResult>;
 }
 
 // ─── Feature Gate ─────────────────────────────────────────────

package/src/query-hooks.svelte.ts

@@ -1,6 +1,6 @@
 import { createQuery } from '@tanstack/svelte-query';
 import { getAdminOptions } from './options.svelte';
-import { getDataProviderForResource, getDataProvider, getLiveProvider } from './context.svelte';
+import { captureAdminContext } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
 import {
   checkError,
@@ -11,8 +11,8 @@ import {
 } from './hook-utils.svelte';
 import type { NotificationConfig, OvertimeOptions, LiveSubscriptionParams } from './hook-utils.svelte';
 import type {
-  GetListParams, GetListResult, Pagination, Sort, Filter, BaseRecord, HttpError,
-  GetOneParams, GetOneResult, GetManyParams, GetManyResult, CustomParams, CustomResult,
+  GetListResult, Pagination, Sort, Filter, BaseRecord, HttpError,
+  GetOneResult, GetManyResult,
   KnownResources,
 } from './types';
 import type { LiveMode, LiveEvent } from './live.svelte';
@@ -74,6 +74,7 @@ export interface UseListOptions<_TData extends BaseRecord = BaseRecord, _TError
 }
 
 export function useList<TData extends BaseRecord = BaseRecord, TError = HttpError>(optionsOrGetter: MaybeGetter<UseListOptions<TData, TError>> = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const adminOptions = getAdminOptions();
   
@@ -83,13 +84,30 @@ export function useList<TData extends BaseRecord = BaseRecord, TError = HttpErro
   const query = createQuery<GetListResult<TData>, TError>(() => {
     const opts = getOptions();
     const resource = getResource();
-    const provider = getDataProviderForResource(resource, opts.dataProviderName);
+    const provider = adminContext.getDataProviderForResource(resource, opts.dataProviderName);
     const queryOptions = opts.queryOptions;
     const pagination = cloneQueryKeyPart(opts.pagination);
     const sorters = cloneQueryKeyPart(opts.sorters);
-    const filters = cloneQueryKeyPart(opts.filters);
+    const explicitFilters = cloneQueryKeyPart(opts.filters);
     const meta = cloneQueryKeyPart(opts.meta);
-    
+
+    // 自动注入嵌套资源 parent filter
+    // 仅消费路径解析出的 parentParams（如 /teams/123/users 的 teamId），
+    // 不再从 query params 中误取，避免 ?tenantId=1 等被静默转成 filter。
+    //
+    // 安全边界：仅在 useList 未显式指定 resource（回退到 parsed.resource），
+    // 或显式 resource 与当前路由资源一致时注入。
+    const parentFilters: typeof explicitFilters = [];
+    const injectParent = !opts.resource || opts.resource === parsed.resource;
+    if (injectParent && parsed.parentParams) {
+      for (const [paramKey, paramVal] of Object.entries(parsed.parentParams)) {
+        if (paramKey.endsWith('Id') && paramVal) {
+          parentFilters.push({ field: paramKey, operator: 'eq' as const, value: paramVal });
+        }
+      }
+    }
+    const filters = [...parentFilters, ...(explicitFilters ?? [])];
+
     return {
       queryKey: [opts.dataProviderName, resource, 'list', pagination, sorters, filters, meta],
       queryFn: async () => provider.getList<TData>({
@@ -112,7 +130,7 @@ export function useList<TData extends BaseRecord = BaseRecord, TError = HttpErro
     const opts = getOptions();
     return {
       resource: getResource(),
-      liveProvider: getLiveProvider(),
+      liveProvider: adminContext.liveProvider,
       liveMode: opts.liveMode ?? adminOptions.liveMode,
       onLiveEvent: (e: LiveEvent) => {
         opts.onLiveEvent?.(e);
@@ -136,7 +154,7 @@ export function useList<TData extends BaseRecord = BaseRecord, TError = HttpErro
       }
     } else if (query.isError && query.errorUpdatedAt > lastErrorAt) {
       lastErrorAt = query.errorUpdatedAt;
-      checkError(query.error);
+      checkError(query.error, adminContext);
       fireErrorNotification(opts.errorNotification, 'Fetch failed', query.error, getResource());
     }
   });
@@ -161,6 +179,7 @@ export interface UseOneOptions<_TData extends BaseRecord = BaseRecord, _TError =
 }
 
 export function useOne<TData extends BaseRecord = BaseRecord, TError = HttpError>(optionsOrGetter: MaybeGetter<UseOneOptions<TData, TError>> = {}) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
   const adminOptions = getAdminOptions();
   
@@ -172,7 +191,7 @@ export function useOne<TData extends BaseRecord = BaseRecord, TError = HttpError
     const opts = getOptions();
     const resource = getResource();
     const id = getId();
-    const provider = getDataProviderForResource(resource, opts.dataProviderName);
+    const provider = adminContext.getDataProviderForResource(resource, opts.dataProviderName);
     const queryOptions = opts.queryOptions;
 
     return {
@@ -200,7 +219,7 @@ export function useOne<TData extends BaseRecord = BaseRecord, TError = HttpError
     const resource = getResource();
     return {
       resource,
-      liveProvider: getLiveProvider(),
+      liveProvider: adminContext.liveProvider,
       liveMode: opts.liveMode ?? adminOptions.liveMode,
       onLiveEvent: (e: LiveEvent) => {
         opts.onLiveEvent?.(e);
@@ -223,7 +242,7 @@ export function useOne<TData extends BaseRecord = BaseRecord, TError = HttpError
       }
     } else if (query.isError && query.errorUpdatedAt > lastErrorAt) {
       lastErrorAt = query.errorUpdatedAt;
-      checkError(query.error);
+      checkError(query.error, adminContext);
       fireErrorNotification(opts.errorNotification, 'Fetch failed', query.error, getResource());
     }
   });
@@ -271,13 +290,14 @@ export interface UseManyOptions<_TData extends BaseRecord = BaseRecord, _TError
 }
 
 export function useMany<TData extends BaseRecord = BaseRecord, TError = HttpError>(optionsOrGetter: MaybeGetter<UseManyOptions<TData, TError>>) {
+  const adminContext = captureAdminContext();
   const adminOptions = getAdminOptions();
   const getOptions = () => typeof optionsOrGetter === 'function' ? optionsOrGetter() : optionsOrGetter;
 
   const query = createQuery<GetManyResult<TData>, TError>(() => {
     const opts = getOptions();
     const { resource, ids, meta, dataProviderName, queryOptions } = opts;
-    const provider = getDataProviderForResource(resource, dataProviderName);
+    const provider = adminContext.getDataProviderForResource(resource, dataProviderName);
 
     return {
       queryKey: [dataProviderName, resource, 'many', ids, meta],
@@ -302,7 +322,7 @@ export function useMany<TData extends BaseRecord = BaseRecord, TError = HttpErro
     const opts = getOptions();
     return {
       resource: opts.resource,
-      liveProvider: getLiveProvider(),
+      liveProvider: adminContext.liveProvider,
       liveMode: opts.liveMode ?? adminOptions.liveMode,
       onLiveEvent: (e: LiveEvent) => {
         opts.onLiveEvent?.(e);
@@ -325,7 +345,7 @@ export function useMany<TData extends BaseRecord = BaseRecord, TError = HttpErro
       }
     } else if (query.isError && query.errorUpdatedAt > lastErrorAt) {
       lastErrorAt = query.errorUpdatedAt;
-      checkError(query.error);
+      checkError(query.error, adminContext);
       fireErrorNotification(opts.errorNotification, 'Fetch failed', query.error, opts.resource);
     }
   });
@@ -334,5 +354,5 @@ export function useMany<TData extends BaseRecord = BaseRecord, TError = HttpErro
 }
 
 export function useApiUrl(dataProviderName?: string): string {
-  return getDataProvider(dataProviderName).getApiUrl();
+  return captureAdminContext().getDataProvider(dataProviderName).getApiUrl();
 }

package/src/router.ts

@@ -67,14 +67,22 @@ export function matchRoute(
   return null;
 }
 
-export async function navigate(path: string, options?: { replaceState?: boolean }): Promise<void> {
-  const from = currentPath();
+/**
+ * Navigate with an explicit tree-scoped provider while preserving the same
+ * guards, path synchronization, and after hooks as the legacy active router.
+ */
+export async function navigateWithProvider(
+  provider: RouterProvider | undefined,
+  path: string,
+  options?: { replaceState?: boolean },
+): Promise<void> {
+  const from = currentPathWithProvider(provider);
   for (const guard of _beforeGuards) {
     const allowed = await guard(path, from);
     if (!allowed) return;
   }
-  if (_routerProvider) {
-    _routerProvider.go({ to: path, type: options?.replaceState ? 'replace' : 'push' });
+  if (provider) {
+    provider.go({ to: path, type: options?.replaceState ? 'replace' : 'push' });
   } else if (typeof window !== 'undefined') {
     window.location.hash = '#' + path.replace(/^#/, '');
   }
@@ -84,19 +92,31 @@ export async function navigate(path: string, options?: { replaceState?: boolean
   }
 }
 
+export async function navigate(path: string, options?: { replaceState?: boolean }): Promise<void> {
+  await navigateWithProvider(_routerProvider, path, options);
+}
+
 /**
  * Format a path into an href suitable for <a> tags.
  */
 export function formatLink(path: string): string {
-  if (_routerProvider?.formatLink) {
-    return _routerProvider.formatLink(path);
+  return formatLinkWithProvider(_routerProvider, path);
+}
+
+export function formatLinkWithProvider(provider: RouterProvider | undefined, path: string): string {
+  if (provider?.formatLink) {
+    return provider.formatLink(path);
   }
   return '#' + path.replace(/^#/, '');
 }
 
 export function currentPath(): string {
-  if (_routerProvider) {
-    const parsed = _routerProvider.parse();
+  return currentPathWithProvider(_routerProvider);
+}
+
+export function currentPathWithProvider(provider: RouterProvider | undefined): string {
+  if (provider) {
+    const parsed = provider.parse();
     const pathname = parsed.pathname || '/';
     let qs = '';
     if (parsed.params && Object.keys(parsed.params).length > 0) {

package/src/routing-hooks.svelte.ts

@@ -1,12 +1,10 @@
-/* eslint-disable svelte/prefer-svelte-reactivity */
-import { navigate } from './router';
-import { getResource, getResources, getRouterProvider } from './context.svelte';
+import { captureAdminContext } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
 
 // ─── routing-hooks.svelte.ts ───────────────────────────────────
 
 export function useGetToPath() {
-  const routerProvider = getRouterProvider();
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
 
   return (options: { resource?: string; action?: 'list' | 'create' | 'edit' | 'show' | 'clone'; id?: string | number; meta?: Record<string, unknown> }) => {
@@ -31,7 +29,7 @@ export function useGetToPath() {
     else if (action === 'clone' && id) path += `/clone/${id}`;
 
     // Apply router mapping if the router provider defines custom path transformers
-    if (routerProvider?.go) {
+    if (adminContext.routerProvider?.go) {
       // SvelteKit path generation can be injected here.
     }
     return path;
@@ -39,6 +37,7 @@ export function useGetToPath() {
 }
 
 export function useGo() {
+  const adminContext = captureAdminContext();
   const getToPath = useGetToPath();
 
   return (options: { to?: string; query?: Record<string, unknown>; type?: 'push' | 'replace'; resource?: string; action?: 'list' | 'create' | 'edit' | 'show' | 'clone'; id?: string | number }) => {
@@ -55,19 +54,13 @@ export function useGo() {
       }
     }
 
-    navigate(targetUrl, options.type === 'replace' ? { replaceState: true } : undefined);
+    void adminContext.navigate(targetUrl, options.type === 'replace' ? { replaceState: true } : undefined);
   };
 }
 
 export function useBack() {
-  return () => {
-    const routerProvider = getRouterProvider();
-    if (routerProvider?.back) {
-      routerProvider.back();
-    } else if (typeof window !== 'undefined') {
-      window.history.back();
-    }
-  };
+  const adminContext = captureAdminContext();
+  return () => adminContext.back();
 }
 
 /**
@@ -75,13 +68,15 @@ export function useBack() {
  * (to avoid full page reloads in SSR apps)
  */
 export function useLink() {
+  const adminContext = captureAdminContext();
   return () => {
-    const routerProvider = getRouterProvider() as Record<string, unknown> | undefined;
+    const routerProvider = adminContext.routerProvider as unknown as Record<string, unknown> | undefined;
     return (routerProvider?.Link as string) ?? 'a';
   };
 }
 
 export function useResource(resourceName?: string) {
+  const adminContext = captureAdminContext();
   const parsed = useParsed();
 
   // Derived resource — re-evaluates when parsed.resource or resourceName changes
@@ -89,7 +84,7 @@ export function useResource(resourceName?: string) {
     const target = resourceName ?? parsed.resource;
     if (!target) return undefined;
     try {
-      return getResource(target);
+      return adminContext.getResource(target);
     } catch {
       return undefined;
     }
@@ -97,12 +92,21 @@ export function useResource(resourceName?: string) {
 
   return {
     get resource() { return resolvedResource; },
-    get resources() { return getResources(); },
+    get resources() { return adminContext.resources; },
     get identifier() { return resolvedResource?.identifier ?? resolvedResource?.name; },
+    /** 当前 URL 解析出的 parent 资源信息（嵌套资源路由） */
+    get parent() {
+      const parentParams: Record<string, string> = {};
+      // 只取路径解析出的 parent params，排除 query params 的误判
+      for (const [k, v] of Object.entries(parsed.parentParams)) {
+        if (v) parentParams[k] = v;
+      }
+      return Object.keys(parentParams).length > 0 ? parentParams : undefined;
+    },
     /** Resolve a resource by name — useful for dynamic lookups inside callbacks */
     select: (name: string) => {
       try {
-        const res = getResource(name);
+        const res = adminContext.getResource(name);
         return { resource: res, identifier: res.identifier ?? res.name };
       } catch {
         return { resource: undefined, identifier: undefined };

package/src/table-hooks.svelte.ts

@@ -1,6 +1,7 @@
 import { useParsed } from './useParsed.svelte';
 import { useList } from './query-hooks.svelte';
 import { readURLState, writeURLState } from './url-sync';
+import { captureAdminContext } from './context.svelte';
 import { getAdminOptions } from './options.svelte';
 import type { Pagination, Sort, Filter, BaseRecord, HttpError, KnownResources, GetListResult } from './types';
 import type { UseListOptions, MaybeGetter } from './query-hooks.svelte';
@@ -29,6 +30,7 @@ export function useTable<
   TError = HttpError,
   TSearchVariables = Record<string, unknown>
 >(optionsOrGetter: MaybeGetter<UseTableOptions<TQueryFnData, TError, TSearchVariables>> = {}) {
+  const adminContext = captureAdminContext();
   const getOptions = () => typeof optionsOrGetter === 'function' ? optionsOrGetter() : optionsOrGetter;
   const parsed = useParsed();
   
@@ -50,7 +52,7 @@ export function useTable<
   let initFilters = initialOpts.filters?.initial ?? [];
 
   if (syncWithLocation && typeof window !== 'undefined') {
-    const urlState = readURLState();
+    const urlState = readURLState(adminContext);
     if (urlState.page || urlState.pageSize) {
       initPagination = {
         current: urlState.page ?? initPagination.current,
@@ -128,12 +130,12 @@ export function useTable<
         sortField: currentSorters[0]?.field,
         sortOrder: currentSorters[0]?.order,
         filters: currentFilters,
-      });
+      }, adminContext);
     });
 
     $effect(() => {
       const handler = () => {
-        const urlState = readURLState();
+        const urlState = readURLState(adminContext);
         const newPage = urlState.page ?? 1;
         if (newPage !== pagination.current) {
           pagination = { ...pagination, current: newPage };

package/src/table-state.svelte.ts

@@ -1,10 +1,11 @@
-/* eslint-disable svelte/prefer-svelte-reactivity */
 // TableState — Svelte 5 Class State Pattern for table data management
 // Reactive class that encapsulates all table state with fine-grained $state/$derived
 
 import { useParsed } from './useParsed.svelte';
 import { useList } from './query-hooks.svelte';
 import { readURLState, writeURLState } from './url-sync';
+import { captureAdminContext } from './context.svelte';
+import type { AdminContextAccessor } from './context.svelte';
 import type { Pagination, Sort, Filter, BaseRecord, HttpError, KnownResources, GetListResult } from './types';
 import type { UseListOptions } from './query-hooks.svelte';
 
@@ -53,11 +54,13 @@ export class TableState<TData extends BaseRecord = BaseRecord, TError = HttpErro
   private filterDefaultBehavior: FilterSetMode;
   private syncWithLocation: boolean;
   private paginationMode: string;
+  private adminContext: AdminContextAccessor;
 
   // ─── Query result ─────────────────────────────────────────────
   private _queryResult;
 
   constructor(options: TableStateOptions<TData, TError> = {}) {
+    this.adminContext = captureAdminContext();
     const parsed = useParsed();
     const resource = options.resource ?? parsed.resource ?? '';
 
@@ -75,7 +78,7 @@ export class TableState<TData extends BaseRecord = BaseRecord, TError = HttpErro
     let initFilters = options.filters?.initial ?? [];
 
     if (this.syncWithLocation && typeof window !== 'undefined') {
-      const urlState = readURLState();
+      const urlState = readURLState(this.adminContext);
       if (urlState.page || urlState.pageSize) {
         initPagination = {
           current: urlState.page ?? initPagination.current,
@@ -116,7 +119,7 @@ export class TableState<TData extends BaseRecord = BaseRecord, TError = HttpErro
           sortField: this.currentSorters[0]?.field,
           sortOrder: this.currentSorters[0]?.order,
           filters: this.currentFilters,
-        });
+        }, this.adminContext);
       });
     }
   }