@svadmin/core 0.26.0 → 0.27.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/core",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "author": "zuohuadong",
   "repository": {
     "type": "git",
@@ -9,16 +9,16 @@
   },
   "main": "src/index.ts",
   "devDependencies": {
-    "@happy-dom/global-registrator": "^20.8.9",
-    "@sveltejs/vite-plugin-svelte": "^7.0.0",
+    "@happy-dom/global-registrator": "^20.10.0",
+    "@sveltejs/vite-plugin-svelte": "^7.1.2",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/svelte": "^5.3.1",
     "@testing-library/user-event": "^14.6.1",
-    "@types/bun": "^1.3.11",
-    "@types/jsdom": "^28.0.1",
-    "happy-dom": "^20.8.9",
-    "jsdom": "^29.0.2",
-    "vitest": "^4.1.4"
+    "@types/bun": "^1.3.14",
+    "@types/jsdom": "^28.0.3",
+    "happy-dom": "^20.10.0",
+    "jsdom": "^29.1.1",
+    "vitest": "^4.1.8"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",

package/src/adapters/casl.ts

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * CASL adapter for svadmin AccessControlProvider.
  *

package/src/auth-hooks.svelte.ts

@@ -79,7 +79,7 @@ export function useLogout() {
       try {
         const queryClient = useQueryClient();
         queryClient.clear();
-      } catch {}
+      } catch { /* intentional */}
       navigate(result.redirectTo ?? '/login');
     }
   });

package/src/data-transfer.svelte.ts

@@ -1,6 +1,6 @@
 import { getDataProviderForResource } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
-import type { GetListResult, Sort, Filter, BaseRecord } from './types';
+import type { Sort, Filter, BaseRecord } from './types';
 
 export interface UseExportOptions<TData extends BaseRecord = BaseRecord> {
   resource?: string;

package/src/form-hooks.svelte.ts

@@ -1,3 +1,4 @@
+/* eslint-disable svelte/prefer-svelte-reactivity */
 import { useQueryClient } from '@tanstack/svelte-query';
 import { useParsed } from './useParsed.svelte';
 import { getAdminOptions } from './options.svelte';
@@ -17,8 +18,8 @@ import { deepMerge, invalidateByScopes } from './mutation-hooks.svelte';
 
 export interface UseFormOptions<
   TVariables extends Record<string, unknown> = Record<string, unknown>,
-  TData extends BaseRecord = BaseRecord,
-  TError = HttpError,
+  _TData extends BaseRecord = BaseRecord,
+  _TError = HttpError,
 > {
   resource?: KnownResources;
   action?: 'create' | 'edit' | 'clone' | 'show';
@@ -44,7 +45,7 @@ export interface UseFormOptions<
   /** Called every time a field value changes. */
   onChange?: (event: { field: string; value: unknown; values: TVariables }) => void;
   /** Called before mutation. Return false or call cancel() to prevent submission. */
-  onSubmit?: (ctx: { values: TVariables; action: 'create' | 'edit' | 'clone' | 'show'; cancel: () => void }) => void | boolean;
+  onSubmit?: (ctx: { values: TVariables; action: 'create' | 'edit' | 'clone' | 'show'; cancel: () => void }) => boolean | undefined;
 
   // ─── Meta ─────────────────────────────────────────────────────
   meta?: Record<string, unknown>;
@@ -85,7 +86,7 @@ export interface UseFormOptions<
 
 export interface UseFormReturn<
   TVariables extends Record<string, unknown> = Record<string, unknown>,
-  TData extends BaseRecord = BaseRecord,
+  _TData extends BaseRecord = BaseRecord,
 > {
   // ─── Form values (single source of truth) ─────────────────────
   /** Reactive form values. Read/write directly. */
@@ -213,8 +214,7 @@ export function useForm<
   function setFieldError(field: string, message: string) { errors = { ...errors, [field]: message }; }
   function clearErrors() { errors = {}; }
   function clearFieldError(field: string) {
-    const next = { ...errors };
-    delete next[field];
+    const { [field]: _, ...next } = errors;
     errors = next;
   }
 
@@ -270,7 +270,7 @@ export function useForm<
   const query = createQuery(() => ({
     queryKey: [options.dataProviderName, resource, 'one', currentId, queryMeta],
     queryFn: async () => {
-      const result = await provider.getOne<BaseRecord>({ resource, id: currentId!, meta: queryMeta });
+      const result = await provider.getOne<BaseRecord>({ resource, id: currentId as string, meta: queryMeta });
       return result;
     },
     enabled: (queryOptions?.enabled ?? true) && (action === 'edit' || action === 'clone' || action === 'show') && currentId != null,
@@ -345,7 +345,7 @@ export function useForm<
   const updateMut = createMutation<{ data: TData }, unknown, TVariables>(() => ({
     ...options.updateMutationOptions,
     mutationFn: async (variables: TVariables) => {
-      const targetId = currentId!;
+      const targetId = currentId as string;
       const targetResource = resource;
       const targetMeta = mutationMeta;
       if (mutationMode === 'undoable') {

package/src/helpers-pure.ts

@@ -50,7 +50,7 @@ export function unionFilters(
     return false;
   };
 
-  let result = [...prevFilters];
+  const result = [...prevFilters];
 
   for (const newFilter of newFilters) {
     const idx = result.findIndex((f) => compareFilters(f, newFilter));

package/src/helpers.ts

@@ -1,6 +1,5 @@
 // Refine v5 compatible utility helpers
 
-import type { Filter, Sort, CrudOperator } from './types';
 import { t } from './i18n.svelte';
 import { getTextTransformers } from './options.svelte';
 

package/src/hooks.svelte.ts

@@ -1,3 +1,4 @@
+/* eslint-disable svelte/prefer-svelte-reactivity */
 // @svadmin/core — Core Data and Hook APIs (Modularized for v0.2.29+)
 
 // ─── Re-exports from modular hook files ─────────────────────────────
@@ -30,13 +31,11 @@ import { invalidateByScopes, publishLiveEvent } from './mutation-hooks.svelte';
 import type { NotificationConfig, OvertimeOptions, LiveSubscriptionParams } from './hook-utils.svelte';
 import type { BaseRecord, HttpError, Pagination, Sort, Filter, DataProvider, KnownResources } from './types';
 import type { LiveMode, LiveEvent } from './live.svelte';
-import { useList } from './query-hooks.svelte';
-import type { UseListOptions } from './query-hooks.svelte';
 import { audit } from './audit';
 
 // ─── useInfiniteList ────────────────────────────────────────────────
 
-export interface UseInfiniteListOptions<TData extends BaseRecord = BaseRecord, TError = HttpError> {
+export interface UseInfiniteListOptions<_TData extends BaseRecord = BaseRecord, _TError = HttpError> {
   resource?: KnownResources;
   pagination?: Pagination;
   sorters?: Sort[];
@@ -113,7 +112,7 @@ export function useInfiniteList<TData extends BaseRecord = BaseRecord, TError =
 
 // ─── useSelect ──────────────────────────────────────────────────────
 
-export interface UseSelectOptions<TData extends BaseRecord = BaseRecord, TOption = { label: string; value: string | number }> {
+export interface UseSelectOptions<TData extends BaseRecord = BaseRecord, _TOption = { label: string; value: string | number }> {
   resource: KnownResources;
   optionLabel?: string | ((item: TData) => string);
   optionValue?: string | ((item: TData) => string | number);
@@ -231,7 +230,7 @@ export function useSelect<TData extends BaseRecord = BaseRecord, TOption = { lab
 
 // ─── useCustom ──────────────────────────────────────────────────────
 
-export interface UseCustomOptions<TData = unknown, TError = HttpError> {
+export interface UseCustomOptions<_TData = unknown, _TError = HttpError> {
   url: string;
   method: 'get' | 'post' | 'put' | 'patch' | 'delete';
   config?: { payload?: unknown; query?: Record<string, unknown>; headers?: Record<string, string>; sorters?: Sort[]; filters?: Filter[] };

package/src/live-sse.ts

@@ -123,7 +123,7 @@ export function createSSELiveProvider(options: SSELiveProviderOptions): LiveProv
         subscribers.set(resource, new Set());
         isNewResource = true;
       }
-      subscribers.get(resource)!.add(callback);
+      subscribers.get(resource)?.add(callback);
 
       if (!eventSource && typeof EventSource !== 'undefined') {
         connect();

package/src/live-websocket.ts

@@ -121,7 +121,7 @@ export function createWebSocketLiveProvider(options: WebSocketLiveProviderOption
       if (!subscribers.has(resource)) {
         subscribers.set(resource, new Set());
       }
-      subscribers.get(resource)!.add(callback);
+      subscribers.get(resource)?.add(callback);
       lastParams.set(resource, liveParams);
 
       // Ensure connection is open

package/src/mutation-hooks.svelte.ts

@@ -1,10 +1,11 @@
+/* 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 { useParsed } from './useParsed.svelte';
 import { audit } from './audit';
 import { UndoError } from './types';
-import type { BaseRecord, HttpError, CreateParams, UpdateParams, DeleteParams, KnownResources } from './types';
+import type { BaseRecord, HttpError, KnownResources } from './types';
 import { checkError, createOvertimeTracker, fireSuccessNotification, fireErrorNotification } from './hook-utils.svelte';
 import type { NotificationConfig, OvertimeOptions } from './hook-utils.svelte';
 import { toast } from './toast.svelte';
@@ -132,14 +133,14 @@ export function useCreate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       // 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') {
-        (options.mutationOptions.onSuccess as Function)(data, params, context);
+        (options.mutationOptions.onSuccess as (...a: unknown[]) => unknown)(data, params, context);
       }
     },
     onError: (error, params, context) => {
       checkError(error);
       fireErrorNotification(params.errorNotification, 'Create failed', error, params.resource ?? defaultResource);
       if (typeof options.mutationOptions?.onError === 'function') {
-        (options.mutationOptions.onError as Function)(error, params, context);
+        (options.mutationOptions.onError as (...a: unknown[]) => unknown)(error, params, context);
       }
     },
   }));
@@ -242,7 +243,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       
       if (updater.list !== false) {
         queryClient.setQueriesData({ predicate: (q) => dp(q) && q.queryKey[1] === resName && q.queryKey[2] === 'list' }, (old: unknown) => {
-          if (typeof updater.list === 'function') return updater.list!(old, params.variables, targetId);
+          if (typeof updater.list === 'function') return updater.list(old, params.variables, targetId);
           if (!old || typeof old !== 'object' || !('data' in old)) return old;
           const o = old as { data: Record<string, unknown>[] };
           return { ...o, data: o.data.map((item) => String(item[pk]) === String(targetId) ? deepMerge(item, params.variables) : item) };
@@ -251,7 +252,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
 
       if (updater.many !== false) {
         queryClient.setQueriesData({ predicate: (q) => dp(q) && q.queryKey[1] === resName && q.queryKey[2] === 'many' }, (old: unknown) => {
-          if (typeof updater.many === 'function') return updater.many!(old, params.variables, targetId);
+          if (typeof updater.many === 'function') return updater.many(old, params.variables, targetId);
           if (!old || typeof old !== 'object' || !('data' in old)) return old;
           const o = old as { data: Record<string, unknown>[] };
           return { ...o, data: o.data.map((item) => String(item[pk]) === String(targetId) ? deepMerge(item, params.variables) : item) };
@@ -268,7 +269,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       audit({ action: 'update', resource: resName, recordId: String(targetId) });
       publishLiveEvent(resName, 'updated', targetId != null ? [targetId] : undefined);
       if (typeof options.mutationOptions?.onSuccess === 'function') {
-        (options.mutationOptions.onSuccess as Function)(data, params, extractedCtx);
+        (options.mutationOptions.onSuccess as (...a: unknown[]) => unknown)(data, params, extractedCtx);
       }
     },
     onSettled: (_data, error, params) => {
@@ -277,7 +278,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       const targetId = params.id ?? defaultId;
       invalidateByScopes(queryClient, resName, params.invalidates, ['list', 'many', 'detail'], targetId != null ? targetId : undefined, params.dataProviderName);
       if (typeof options.mutationOptions?.onSettled === 'function') {
-        (options.mutationOptions.onSettled as Function)(_data, error, params, undefined);
+        (options.mutationOptions.onSettled as (...a: unknown[]) => unknown)(_data, error, params, undefined);
       }
     },
     onError: (error, params, context: unknown) => {
@@ -292,7 +293,7 @@ export function useUpdate<TData extends BaseRecord = BaseRecord, TError = HttpEr
       const extractedCtx = ctx?._svadmin_ctx ? ctx.userContext : context;
       fireErrorNotification(params.errorNotification, 'Update failed', error, params.resource ?? defaultResource);
       if (typeof options.mutationOptions?.onError === 'function') {
-        (options.mutationOptions.onError as Function)(error, params, extractedCtx);
+        (options.mutationOptions.onError as (...a: unknown[]) => unknown)(error, params, extractedCtx);
       }
     },
   }));
@@ -409,7 +410,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
       audit({ action: 'delete', resource: resName, recordId: String(targetId) });
       publishLiveEvent(resName, 'deleted', targetId != null ? [targetId] : undefined);
       if (typeof options.mutationOptions?.onSuccess === 'function') {
-        (options.mutationOptions.onSuccess as Function)(data, params, extractedCtx);
+        (options.mutationOptions.onSuccess as (...a: unknown[]) => unknown)(data, params, extractedCtx);
       }
     },
     onSettled: (_data, error, params) => {
@@ -418,7 +419,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
       const targetId = params.id ?? defaultId;
       invalidateByScopes(queryClient, resName, params.invalidates, ['list', 'many'], targetId != null ? targetId : undefined, params.dataProviderName);
       if (typeof options.mutationOptions?.onSettled === 'function') {
-        (options.mutationOptions.onSettled as Function)(_data, error, params, undefined);
+        (options.mutationOptions.onSettled as (...a: unknown[]) => unknown)(_data, error, params, undefined);
       }
     },
     onError: (error, params, context: unknown) => {
@@ -433,7 +434,7 @@ export function useDelete<TData extends BaseRecord = BaseRecord, TError = HttpEr
       const extractedCtx = ctx?._svadmin_ctx ? ctx.userContext : context;
       fireErrorNotification(params.errorNotification, 'Delete failed', error, params.resource ?? defaultResource);
       if (typeof options.mutationOptions?.onError === 'function') {
-        (options.mutationOptions.onError as Function)(error, params, extractedCtx);
+        (options.mutationOptions.onError as (...a: unknown[]) => unknown)(error, params, extractedCtx);
       }
     },
   }));

package/src/permissions.svelte.ts

@@ -93,21 +93,24 @@ export async function canAccessAsync(resourceOrBatch: string | CanParams[], acti
     return provider.can(resourceOrBatch);
   }
   
-  return provider.can({ resource: resourceOrBatch, action: action!, params }) as Promise<CanResult>;
+  return provider.can({ resource: resourceOrBatch, action: action as string, params }) as Promise<CanResult>;
 }
 
 // ─── Feature Gate ─────────────────────────────────────────────
 
-/**
- * 角色层级定义 (高权 → 低权)
- */
-const ROLE_HIERARCHY = ["superadmin", "admin", "manager", "user", "viewer", "guest"];
-
 export interface FeatureGateConfig {
   /** 允许访问的角色列表 */
   roles?: string[];
-  /** 需要的最低角色 (含以上所有角色) */
+  /**
+   * 需要的最低角色 (含以上所有角色)。
+   * 使用 minRole 时必须同时提供 roleHierarchy。
+   */
   minRole?: string;
+  /**
+   * 角色层级定义 (高权 → 低权)，用于 minRole 比较。
+   * 由调用方按自身业务定义，框架不预设任何角色。
+   */
+  roleHierarchy?: string[];
   /** 需要的权限列表 (全部匹配) */
   permissions?: string[];
 }
@@ -119,34 +122,39 @@ export interface FeatureGateUser {
 
 /**
  * 创建功能门控函数 — 基于角色和权限判断用户是否可访问某功能。
+ * 不预设任何角色层级，由调用方完全定义。
  *
  * @example
  * ```ts
- * const canUseCode = createFeatureGate({
- *   minRole: 'manager',
- *   permissions: ['code:execute'],
+ * const HIERARCHY = ['admin', 'editor', 'viewer'];
+ * const canEdit = createFeatureGate({
+ *   minRole: 'editor',
+ *   roleHierarchy: HIERARCHY,
+ *   permissions: ['content:write'],
  * });
  *
- * if (canUseCode(user)) { ... }
+ * if (canEdit(user)) { ... }
  * ```
  */
 export function createFeatureGate(config: FeatureGateConfig): (user: FeatureGateUser) => boolean {
   return (user: FeatureGateUser): boolean => {
-    // 角色白名单
     if (config.roles && !config.roles.includes(user.role)) {
       return false;
     }
 
-    // 最低角色层级检查
     if (config.minRole) {
-      const userIndex = ROLE_HIERARCHY.indexOf(user.role);
-      const minIndex = ROLE_HIERARCHY.indexOf(config.minRole);
-      if (userIndex === -1 || minIndex === -1 || userIndex > minIndex) {
-        return false;
+      const hierarchy = config.roleHierarchy;
+      if (!hierarchy || hierarchy.length === 0) {
+        if (user.role !== config.minRole) return false;
+      } else {
+        const userIndex = hierarchy.indexOf(user.role);
+        const minIndex = hierarchy.indexOf(config.minRole);
+        if (userIndex === -1 || minIndex === -1 || userIndex > minIndex) {
+          return false;
+        }
       }
     }
 
-    // 权限检查 (全部匹配)
     if (config.permissions && config.permissions.length > 0) {
       const hasAll = config.permissions.every((permission) => {
         if (user.permissions.includes("*")) return true;

package/src/query-hooks.svelte.ts

@@ -1,4 +1,4 @@
-import { createQuery, createInfiniteQuery } from '@tanstack/svelte-query';
+import { createQuery } from '@tanstack/svelte-query';
 import { getAdminOptions } from './options.svelte';
 import { getDataProviderForResource, getDataProvider, getLiveProvider } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
@@ -57,7 +57,7 @@ function cloneQueryKeyPart<T>(value: T): T {
   return value;
 }
 
-export interface UseListOptions<TData extends BaseRecord = BaseRecord, TError = HttpError> {
+export interface UseListOptions<_TData extends BaseRecord = BaseRecord, _TError = HttpError> {
   resource?: KnownResources;
   pagination?: Pagination;
   sorters?: Sort[];
@@ -146,7 +146,7 @@ export function useList<TData extends BaseRecord = BaseRecord, TError = HttpErro
 
 // ─── useOne ────────────────────────────────────────────────────
 
-export interface UseOneOptions<TData extends BaseRecord = BaseRecord, TError = HttpError> {
+export interface UseOneOptions<_TData extends BaseRecord = BaseRecord, _TError = HttpError> {
   resource?: KnownResources;
   id?: string | number;
   meta?: Record<string, unknown>;
@@ -256,7 +256,7 @@ export function useShow<TData extends BaseRecord = BaseRecord, TError = HttpErro
 
 // ─── useMany ───────────────────────────────────────────────────
 
-export interface UseManyOptions<TData extends BaseRecord = BaseRecord, TError = HttpError> {
+export interface UseManyOptions<_TData extends BaseRecord = BaseRecord, _TError = HttpError> {
   resource: KnownResources;
   ids: (string | number)[];
   meta?: Record<string, unknown>;

package/src/routing-hooks.svelte.ts

@@ -1,4 +1,5 @@
-import { currentPath, navigate } from './router';
+/* eslint-disable svelte/prefer-svelte-reactivity */
+import { navigate } from './router';
 import { getResource, getResources, getRouterProvider } from './context.svelte';
 import { useParsed } from './useParsed.svelte';
 

package/src/table-hooks.svelte.ts

@@ -7,7 +7,7 @@ import type { UseListOptions, MaybeGetter } from './query-hooks.svelte';
 
 export type FilterSetMode = 'merge' | 'replace';
 
-export interface UseTableOptions<TQueryFnData extends BaseRecord = BaseRecord, TError = HttpError, TSearchVariables = Record<string, unknown>> extends Omit<UseListOptions<TQueryFnData, TError>, 'pagination' | 'sorters' | 'filters'> {
+export interface UseTableOptions<TQueryFnData extends BaseRecord = BaseRecord, TError = HttpError, _TSearchVariables = Record<string, unknown>> extends Omit<UseListOptions<TQueryFnData, TError>, 'pagination' | 'sorters' | 'filters'> {
   resource?: KnownResources;
   pagination?: Pagination;
   sorters?: {
@@ -80,7 +80,7 @@ export function useTable<
 
   const tableQueryInfo = useList<TQueryFnData, TError>(() => {
     const currentOpts = getOptions();
-    const { meta, syncWithLocation, dataProviderName, pagination: _p, sorters: _s, filters: _f, ...restOptions } = currentOpts;
+    const { meta, syncWithLocation: _swl, dataProviderName, pagination: _p, sorters: _s, filters: _f, ...restOptions } = currentOpts;
     return {
       resource: currentOpts.resource ?? parsed.resource ?? '',
       pagination: queryPagination,
@@ -209,6 +209,7 @@ export function useTable<
             if (vb == null && va != null) return -1;
             if (va == null && vb == null) continue;
             
+            // eslint-disable-next-line no-useless-assignment
             let cmp = 0;
             if (typeof va === 'number' && typeof vb === 'number') cmp = va - vb;
             else if (va instanceof Date && vb instanceof Date) cmp = va.getTime() - vb.getTime();

package/src/table-state.svelte.ts

@@ -1,3 +1,4 @@
+/* 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
 
@@ -94,7 +95,7 @@ export class TableState<TData extends BaseRecord = BaseRecord, TError = HttpErro
     this.currentFilters = initFilters;
 
     // Create query
-    const _this = this;
+    const _this = this; // eslint-disable-line @typescript-eslint/no-this-alias
     const { meta, syncWithLocation: _s, dataProviderName, pagination: _p, sorters: _sr, filters: _f, ...restOptions } = options;
     this._queryResult = useList<TData, TError>({
       resource,
@@ -226,7 +227,7 @@ export class TableState<TData extends BaseRecord = BaseRecord, TError = HttpErro
   get clientData(): TData[] {
     if (this.paginationMode === 'server') return [];
     const allData = this.data;
-    let sorted = [...allData];
+    const sorted = [...allData];
     const activeSorters = this.sortersMode === 'off' ? this.effectiveSorters : [];
     if (activeSorters.length > 0) {
       sorted.sort((a, b) => {

package/src/task-hooks.svelte.ts

@@ -74,7 +74,7 @@ export function useSubmitTask<
   return { mutation, get overtime() { return overtime; } };
 }
 
-export interface UseTaskOptions<TTask extends TaskRecord = TaskRecord, TError = HttpError> {
+export interface UseTaskOptions<TTask extends TaskRecord = TaskRecord, _TError = HttpError> {
   taskId?: string;
   taskProvider?: TaskProvider<TTask>;
   queryOptions?: {
@@ -138,7 +138,7 @@ export function useTask<TTask extends TaskRecord = TaskRecord, TError = HttpErro
   }) as typeof query & { overtime: typeof overtime };
 }
 
-export interface UseTaskListOptions<TTask extends TaskRecord = TaskRecord, TError = HttpError> {
+export interface UseTaskListOptions<TTask extends TaskRecord = TaskRecord, _TError = HttpError> {
   params?: Record<string, unknown>;
   dlq?: boolean;
   taskProvider?: TaskProvider<TTask>;

package/src/theme.svelte.ts

@@ -255,7 +255,7 @@ export function configureTheme(config: ThemeConfig): void {
     if (preset) {
       colorTheme = preset.name as ColorTheme;
       if (typeof window !== 'undefined') {
-        try { localStorage.setItem(COLOR_STORAGE_KEY, preset.name); } catch {}
+        try { localStorage.setItem(COLOR_STORAGE_KEY, preset.name); } catch { /* intentional */}
       }
       applyColorTheme(preset.name as ColorTheme);
       applyColorPreset(preset);
@@ -369,7 +369,7 @@ export function getTheme(): ThemeMode {
 export function setTheme(newMode: ThemeMode): void {
   mode = newMode;
   if (typeof window !== 'undefined') {
-    try { localStorage.setItem(STORAGE_KEY, newMode); } catch {}
+    try { localStorage.setItem(STORAGE_KEY, newMode); } catch { /* intentional */}
   }
   applyTheme(newMode);
   // Re-apply color preset — light/dark CSS variable overrides differ
@@ -416,7 +416,7 @@ export function getColorTheme(): ColorTheme {
 export function setColorTheme(ct: ColorTheme): void {
   colorTheme = ct;
   if (typeof window !== 'undefined') {
-    try { localStorage.setItem(COLOR_STORAGE_KEY, ct); } catch {}
+    try { localStorage.setItem(COLOR_STORAGE_KEY, ct); } catch { /* intentional */}
   }
   applyColorTheme(ct);
   const preset = builtinPresets[ct];

package/src/toast.svelte.ts

@@ -1,3 +1,4 @@
+/* eslint-disable svelte/prefer-svelte-reactivity */
 export type ToastType = 'success' | 'error' | 'info' | 'warning' | 'undoable';
 
 export interface ToastItem {

package/src/types.ts

@@ -256,7 +256,7 @@ export interface TaskSubscription {
 export interface TaskHandle<TTask extends TaskRecord = TaskRecord> {
   id?: string;
   wait(): Promise<TTask>;
-  subscribe?(callback: (task: TTask) => void): TaskSubscription | (() => void) | void;
+  subscribe?(callback: (task: TTask) => void): TaskSubscription | (() => void) | undefined;
   cancel?(): Promise<unknown>;
   retry?(): Promise<unknown>;
 }
@@ -273,7 +273,7 @@ export interface TaskProvider<TTask extends TaskRecord = TaskRecord> {
   listDlq?(params?: Record<string, unknown>): Promise<TaskListResult<TTask>>;
   cancel?(taskId: string): Promise<unknown>;
   retry?(taskId: string): Promise<unknown>;
-  subscribe?(taskId: string, callback: (task: TTask) => void): TaskSubscription | (() => void) | void;
+  subscribe?(taskId: string, callback: (task: TTask) => void): TaskSubscription | (() => void) | undefined;
 }
 
 // ─── AuthProvider ─────────────────────────────────────────────
@@ -448,6 +448,7 @@ export interface FieldDefinition {
  * // list.data → { id: string; name: string; email: string }[]
  * ```
  */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface ResourceTypeMap {}
 
 /** When ResourceTypeMap is empty → string; otherwise → registered keys */

package/src/unsaved-changes.svelte.ts

@@ -1,3 +1,4 @@
+/* eslint-disable svelte/prefer-svelte-reactivity */
 // UnsavedChangesNotifier — guards against accidental navigation with dirty forms
 // Supports: browser tab close, hash-based SPA routing, and framework router interception
 
@@ -14,7 +15,7 @@ export function resetUnsavedChanges(): void {
   dirty = false;
   _unsavedChangesCleanup?.();
   _unsavedChangesCleanup = null;
-  _navigationGuard = null;
+  __navigationGuard = null;
 }
 
 export function getUnsavedChanges(): boolean {
@@ -30,7 +31,7 @@ interface NavigationGuard {
   (opts: { cancel: () => void }): void;
 }
 
-let _navigationGuard: NavigationGuard | null = null;
+let __navigationGuard: NavigationGuard | null = null;
 
 /**
  * Register a framework-level navigation guard.
@@ -51,7 +52,7 @@ let _navigationGuard: NavigationGuard | null = null;
  * and pass a `beforeNavigate` callback.
  */
 export function registerNavigationGuard(guard: NavigationGuard): void {
-  _navigationGuard = guard;
+  __navigationGuard = guard;
 }
 
 /**

package/src/useParsed.svelte.ts

@@ -1,3 +1,5 @@
+/* eslint-disable svelte/prefer-svelte-reactivity */
+/* eslint-disable @typescript-eslint/no-explicit-any */
 // useParsed — parse current URL hash into structured route info
 
 import { currentPath, registerRouterSync } from './router';

package/src/utility-hooks.svelte.ts

@@ -1,9 +1,9 @@
+/* eslint-disable svelte/prefer-svelte-reactivity */
 import { useForm, type UseFormOptions, type UseFormReturn } from './form-hooks.svelte';
 import { useQueryClient } from '@tanstack/svelte-query';
 import { useParsed } from './useParsed.svelte';
 import { getResource, getResources } from './context.svelte';
 import { getAdminOptions } from './options.svelte';
-import { navigate } from './router';
 import { t } from './i18n.svelte';
 import type { BaseRecord, HttpError, Filter, KnownResources, ResourceDefinition } from './types';
 import { useList, type UseListOptions } from './query-hooks.svelte';
@@ -162,7 +162,7 @@ export function useBreadcrumb() {
 
 // ─── useRelation ───────────────────────────────────────────
 
-export interface UseRelationOptions<TData extends BaseRecord = BaseRecord, TError = HttpError> {
+export interface UseRelationOptions<_TData extends BaseRecord = BaseRecord, _TError = HttpError> {
   resource: KnownResources;
   id?: string | number;
   pagination?: { current?: number; pageSize?: number };