@svadmin/ui 0.88.1 → 0.91.0

package/dist/components/FilterBuilder.svelte

@@ -206,6 +206,7 @@
         {@const allowed = filterOperators(editorFields.find(item => item.key === node.field))}
         {@const collection = isCollectionOperator(node.operator)}
         {@const invalid = issues.some((issue) => issue.path === node.id)}
+        {@const describedby = issues.flatMap((issue, index) => issue.path === node.id ? [`${uid}-issue-${index}`] : []).join(' ') || undefined}
         <div class="filter-rule" data-testid="filter-builder-rule" data-filter-rule={node.id}>
           {#if node.readonly}
             <output aria-label={i18n.t('filter.readonly')}>{node.field} {node.operator} {JSON.stringify(node.value)}</output>
@@ -225,15 +226,20 @@
             </Select>
           </div>
           <div>
-            <label for={`${uid}-${node.id}-value`}>{collection ? (chinese ? '值（JSON 数组）' : 'Value (JSON array)') : (chinese ? '值' : 'Value')}</label>
+            {#if collection && field}
+              <span id={`${uid}-${node.id}-value-label`}>{chinese ? '值' : 'Value'}</span>
+            {:else}
+              <label for={`${uid}-${node.id}-value`}>{collection ? (chinese ? '值（JSON 数组）' : 'Value (JSON array)') : (chinese ? '值' : 'Value')}</label>
+            {/if}
             {#if isNullOperator(node.operator)}
               <Input id={`${uid}-${node.id}-value`} value={chinese ? '无需填值' : 'No value required'} disabled />
             {:else if collection && field}
               <FilterCollectionInput {field} value={node.value}
+                {invalid} {describedby} labelledby={`${uid}-${node.id}-value-label`}
                 range={node.operator === 'between' || node.operator === 'nbetween'}
                 onchange={(value) => { if (!disabled && !node.readonly) node.value = value; }} />
             {:else if !collection && field?.options?.length}
-              <Select id={`${uid}-${node.id}-value`} aria-invalid={invalid}
+              <Select id={`${uid}-${node.id}-value`} aria-invalid={invalid} aria-describedby={describedby}
                 value={field.options.findIndex((option) => option.value === node.value) < 0 ? '' : String(field.options.findIndex((option) => option.value === node.value))}
                 onchange={(event: Event) => {
                   if (disabled || node.readonly || !(event.currentTarget instanceof HTMLSelectElement)) return;
@@ -247,15 +253,15 @@
                 {#each field.options as option, index (index)}<option value={String(index)} disabled={option.disabled}>{option.label}</option>{/each}
               </Select>
             {:else if !collection && field?.type === 'boolean'}
-              <Select id={`${uid}-${node.id}-value`} aria-invalid={invalid} value={valueText(node.value)}
+              <Select id={`${uid}-${node.id}-value`} aria-invalid={invalid} aria-describedby={describedby} value={valueText(node.value)}
                 onchange={(event: Event) => { if (event.currentTarget instanceof HTMLSelectElement) changeValue(node, event.currentTarget.value); }}>
                 <option value="">{chinese ? '请选择' : 'Choose'}</option><option value="true">true</option><option value="false">false</option>
               </Select>
             {:else if !collection && isNumericField(field)}
-              <Input id={`${uid}-${node.id}-value`} type="number" step="any" aria-invalid={invalid} value={typeof node.value === 'number' ? node.value : undefined}
+              <Input id={`${uid}-${node.id}-value`} type="number" step="any" aria-invalid={invalid} aria-describedby={describedby} value={typeof node.value === 'number' ? node.value : undefined}
                 oninput={(event: Event) => { if (event.currentTarget instanceof HTMLInputElement) changeValue(node, event.currentTarget.value); }} />
             {:else}
-              <Input id={`${uid}-${node.id}-value`} type="text" aria-invalid={invalid} value={valueText(node.value)} placeholder={collection ? '[1, 2]' : ''}
+              <Input id={`${uid}-${node.id}-value`} type="text" aria-invalid={invalid} aria-describedby={describedby} value={valueText(node.value)} placeholder={collection ? '[1, 2]' : ''}
                 oninput={(event: Event) => { if (event.currentTarget instanceof HTMLInputElement) changeValue(node, event.currentTarget.value); }} />
             {/if}
           </div>
@@ -277,7 +283,7 @@
       <Button type="button" size="sm" disabled={disabled} data-testid="filter-builder-apply" onclick={apply}><Check size={14} aria-hidden="true" />{i18n.t('common.confirm')}</Button>
     </div>
   </div>
-  {#if issues.length}<div role="alert" class="errors" data-testid="filter-builder-errors">{#each issues as issue, index (`${issue.path}-${issue.code}-${index}`)}<p>{issue.path}: {message(issue.code)}</p>{/each}</div>{/if}
+  {#if issues.length}<div role="alert" class="errors" data-testid="filter-builder-errors">{#each issues as issue, index (`${issue.path}-${issue.code}-${index}`)}<p id={`${uid}-issue-${index}`}>{issue.path}: {message(issue.code)}</p>{/each}</div>{/if}
   {#if !loadIssues.length}{@render groupEditor(root, root.wrapped || logicalOperator === 'or' ? 1 : 0, true)}{/if}
 </div>
 
@@ -292,7 +298,7 @@
   .filter-rule { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr) minmax(0, 2fr) auto; align-items: end; gap: .5rem; margin-block-start: .75rem; }
   .filter-rule > div { min-width: 0; }
   .filter-rule > output { grid-column: 1 / -2; overflow-wrap: anywhere; }
-  .filter-rule label { display: block; margin-block-end: .25rem; color: var(--muted-foreground); }
+  .filter-rule label, .filter-rule > div > span { display: block; margin-block-end: .25rem; color: var(--muted-foreground); }
   .empty { padding-block: .75rem; color: var(--muted-foreground); }
   .errors { color: var(--destructive); overflow-wrap: anywhere; }
   .nested-group { align-items: flex-start; }

package/dist/components/FilterCollectionInput.svelte

@@ -6,8 +6,10 @@
   import { Input } from './ui/input/index.js';
   import { Select } from './ui/select/index.js';
 
-  let { field, value, range = false, onchange }: {
-    field: FieldDefinition; value: unknown; range?: boolean; onchange: (value: unknown[]) => void;
+  let { field, value, range = false, labelledby, describedby, invalid = false, onchange }: {
+    field: FieldDefinition; value: unknown; range?: boolean;
+    labelledby?: string | undefined; describedby?: string | undefined; invalid?: boolean;
+    onchange: (value: unknown[]) => void;
   } = $props();
   const i18n = useTranslation();
   const values = $derived<unknown[]>(Array.isArray(value) ? value : range ? [null, null] : [null]);
@@ -17,14 +19,14 @@
   }
 </script>
 
-<div class="filter-collection">
+<div class="filter-collection" role="group" aria-labelledby={labelledby} aria-describedby={describedby}>
   {#each values as item, index (index)}
     {@const label = range
       ? i18n.t(index === 0 ? 'filter.rangeStart' : 'filter.rangeEnd')
       : i18n.t('filter.collectionItem', { number: String(index + 1) })}
     <div class="filter-collection-item">
       {#if field.type === 'select'}
-        <Select aria-label={label} value={String(field.options?.findIndex(option => option.value === item) ?? -1)}
+        <Select aria-label={label} aria-invalid={invalid} aria-describedby={describedby} value={String(field.options?.findIndex(option => option.value === item) ?? -1)}
           onchange={(event: Event) => {
             if (!(event.currentTarget instanceof HTMLSelectElement)) return;
             const option = field.options?.[Number(event.currentTarget.value)];
@@ -36,7 +38,7 @@
           {/each}
         </Select>
       {:else if field.type === 'boolean'}
-        <Select aria-label={label} value={typeof item === 'boolean' ? String(item) : ''}
+        <Select aria-label={label} aria-invalid={invalid} aria-describedby={describedby} value={typeof item === 'boolean' ? String(item) : ''}
           onchange={(event: Event) => {
             if (!(event.currentTarget instanceof HTMLSelectElement)) return;
             update(index, event.currentTarget.value === 'true' ? true : event.currentTarget.value === 'false' ? false : null);
@@ -46,12 +48,12 @@
           <option value="false">{i18n.t('common.no')}</option>
         </Select>
       {:else if isNumericFilterField(field)}
-        <Input type="number" step="any" aria-label={label} value={typeof item === 'number' ? item : undefined}
+        <Input type="number" step="any" aria-label={label} aria-invalid={invalid} aria-describedby={describedby} value={typeof item === 'number' ? item : undefined}
           oninput={(event: Event) => {
             if (event.currentTarget instanceof HTMLInputElement) update(index, event.currentTarget.value === '' ? null : event.currentTarget.valueAsNumber);
           }} />
       {:else}
-        <Input type="text" aria-label={label} value={typeof item === 'string' ? item : ''}
+        <Input type="text" aria-label={label} aria-invalid={invalid} aria-describedby={describedby} value={typeof item === 'string' ? item : ''}
           oninput={(event: Event) => {
             if (event.currentTarget instanceof HTMLInputElement) update(index, event.currentTarget.value);
           }} />

package/dist/components/FilterCollectionInput.svelte.d.ts

@@ -3,6 +3,9 @@ type $$ComponentProps = {
     field: FieldDefinition;
     value: unknown;
     range?: boolean;
+    labelledby?: string | undefined;
+    describedby?: string | undefined;
+    invalid?: boolean;
     onchange: (value: unknown[]) => void;
 };
 declare const FilterCollectionInput: import("svelte").Component<$$ComponentProps, {}, "">;

package/dist/components/ForgotPasswordPage.svelte

@@ -32,7 +32,7 @@
     if (result.success) {
       sent = true;
     } else {
-      error = result.error?.message ?? i18n.t('common.operationFailed');
+      error = i18n.t('common.operationFailed');
     }
   }
 </script>

package/dist/components/Header.svelte

@@ -71,7 +71,7 @@
       <Button variant="outline" size="sm" onclick={onSearchClick} aria-label={i18n.t('common.search')} class="svadmin-header-search svadmin-u-77a2a20e90d4 svadmin-u-bfa603190748 svadmin-u-e7a768f922d2 svadmin-u-0e17f2bd9074 svadmin-u-5f22e64f2282 svadmin-u-05faf5c801ff">
         <Search class="svadmin-u-7fc7f732bf7e svadmin-u-bf600f8e029c" />
         <span class="svadmin-u-99d72c7fc3e2 svadmin-u-ee3c1259a368 svadmin-u-359090c2d529">{i18n.t('common.search')}</span>
-        <kbd class="svadmin-u-99d72c7fc3e2 svadmin-u-e3fd07f96126 svadmin-u-3960ffc248d9 svadmin-u-a3899220f90e svadmin-u-07389a777c1f svadmin-u-ca6bcd4b6f3f svadmin-u-706701550477 svadmin-u-45d828117213 svadmin-u-465609a240a8 svadmin-u-1dc571a3609f svadmin-u-2689f3958069 svadmin-u-0e65706bcccd svadmin-u-bfa603190748">
+        <kbd style="flex-shrink: 0; white-space: nowrap" class="whitespace-nowrap svadmin-u-99d72c7fc3e2 svadmin-u-e3fd07f96126 svadmin-u-3960ffc248d9 svadmin-u-a3899220f90e svadmin-u-07389a777c1f svadmin-u-ca6bcd4b6f3f svadmin-u-706701550477 svadmin-u-45d828117213 svadmin-u-465609a240a8 svadmin-u-1dc571a3609f svadmin-u-2689f3958069 svadmin-u-0e65706bcccd svadmin-u-bfa603190748">
           <span class="svadmin-u-359090c2d529">⌘</span>K
         </kbd>
       </Button>

package/dist/components/ImportWizard.svelte

@@ -1,10 +1,10 @@
 <script lang="ts">
-  import { captureAdminContext, captureAuthSession, IMPORT_LIMITS, snapshotImportArtifact, snapshotImportTaskResult, useCan, useImport, useResourceContract, useSubmitTask, useTask } from '@svadmin/core';
+  import { captureAdminContext, captureAuthSession, IMPORT_LIMITS, invalidImportPreviewFailure, snapshotImportArtifact, snapshotImportTaskResult, useCan, useImport, useResourceContract, useSubmitTask, useTask } from '@svadmin/core';
   import { untrack } from 'svelte';
   import { definedReactiveOptions } from '@svadmin/core/options';
   import { useTranslation } from '@svadmin/core/i18n';
   import { parseContractCreateInput } from '@svadmin/core/resource-contract';
-  import type { ImportArtifactProvider, TaskProvider } from '@svadmin/core';
+  import type { ImportArtifactProvider, ImportPreviewResult, TaskProvider } from '@svadmin/core';
   import { normalizeTaskStatus, resolveTaskProgress, canCancelTask } from './task-utils.js';
   import TaskStatusBadge from './TaskStatusBadge.svelte';
   import CancelTaskButton from './CancelTaskButton.svelte';
@@ -15,6 +15,9 @@
   import { Badge } from './ui/badge/index.js';
   import { Upload, ArrowRight, ArrowLeft, AlertCircle, Download, FileSpreadsheet, Loader2, RotateCw } from '@lucide/svelte';
 
+  /** 仅用于标记文件读取或 JSON 语法异常，避免把浏览器原始诊断展示给用户。 */
+  class ImportFileReadError extends Error {}
+
   interface Props {
     resourceName: string;
     open?: boolean;
@@ -30,6 +33,10 @@
     initialTaskId?: string;
     onTaskSubmitted?: (taskId: string) => void;
     onSuccess?: (result: { succeeded: number; failed: number }) => void;
+    /** 只做本地解析、映射和逐行校验，不调用 Provider 写入，也不提交、轮询或取消任务。 */
+    dryRun?: boolean;
+    /** 预览结果回调；接收隔离的只读快照，失败原因与失败报告一样只含安全通用文本。 */
+    onPreview?: (result: ImportPreviewResult) => void;
   }
 
   let {
@@ -46,6 +53,8 @@
     initialTaskId,
     onTaskSubmitted,
     onSuccess,
+    dryRun = false,
+    onPreview,
   }: Props = $props();
 
   const i18n = useTranslation();
@@ -78,14 +87,14 @@
   let parseToken = 0;
   let mounted = true;
   let cancelled = $state(false);
-  let durableTaskId = $state<string | undefined>(untrack(() => initialTaskId));
-  let durableTaskScope = $state.raw<typeof scope | undefined>(untrack(() => scope));
-  const ownedTaskId = $derived(durableTaskScope && sameScope(durableTaskScope, scope) ? durableTaskId : undefined);
+  let durableTaskId = $state<string | undefined>(untrack(() => dryRun ? undefined : initialTaskId));
+  let durableTaskScope = $state.raw<typeof scope | undefined>(untrack(() => dryRun ? undefined : scope));
+  const ownedTaskId = $derived(!dryRun && durableTaskScope && sameScope(durableTaskScope, scope) ? durableTaskId : undefined);
   let durableHandledTaskId = $state<string | undefined>();
   let durableSubmitAttempt = $state.raw<object | undefined>();
   let artifactUploadController: AbortController | undefined;
   let durablePolling = $state(true);
-  const durableMode = $derived(taskName !== undefined);
+  const durableMode = $derived(!dryRun && taskName !== undefined);
   const submitTask = useSubmitTask();
   const taskQuery = useTask(definedReactiveOptions({
     get taskId() { return ownedTaskId; },
@@ -101,12 +110,13 @@
   const durableStatus = $derived(normalizeTaskStatus(taskQuery.data?.status));
   const retryReceipt = $derived(durableStatus === 'completed'
     ? snapshotImportTaskResult(taskQuery.data?.result ?? taskQuery.data?.result_data)?.retry : undefined);
-  const durableActive = $derived(durableStatus === 'queued' || durableStatus === 'processing'
-    || !!durableSubmitAttempt);
+  const durableActive = $derived(!dryRun && (durableStatus === 'queued' || durableStatus === 'processing'
+    || !!durableSubmitAttempt));
 
   let importResult = $state<{ succeeded: number; failed: number } | null>(null);
   let succeededCount = $state(0);
   let failedRecords = $state<Array<{ row: Record<string, unknown>; error: string }>>([]);
+  let previewResult = $state.raw<ImportPreviewResult | null>(null);
 
   const importer = useImport(definedReactiveOptions({
     get resource() { return binding.resource; },
@@ -133,6 +143,7 @@
     durableTaskId = undefined;
     durableHandledTaskId = undefined;
     durableSubmitAttempt = undefined;
+    previewResult = null;
     selectedFile = null;
     fileName = file.name;
     rawHeaders = [];
@@ -144,13 +155,13 @@
         throw new Error(i18n.t('import.invalidLimits'));
       }
       if (file.size > maxBytes) throw new Error(i18n.t('import.limit'));
-      const text = await file.text();
+      const text = await readFileText(file);
       if (!current(origin, token)) return;
       if (text.length > maxBytes) throw new Error(i18n.t('import.limit'));
       const cleanText = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
 
       if (file.name.toLowerCase().endsWith('.json')) {
-        const json: unknown = JSON.parse(cleanText);
+        const json: unknown = parseImportJson(cleanText);
         if (Array.isArray(json) && json.length > maxRows) throw new Error(i18n.t('import.limit'));
         if (!Array.isArray(json) || json.length === 0 || json.some((item) => (
           typeof item !== 'object' || item === null || Array.isArray(item)
@@ -201,11 +212,29 @@
       currentStep = 2;
     } catch (error) {
       if (!current(origin, token)) return;
-      fileError = error instanceof Error ? error.message : 'Unable to read the import file.';
+      fileError = error instanceof ImportFileReadError
+        ? i18n.t('import.fileReadFailed')
+        : error instanceof Error ? error.message : i18n.t('import.fileReadFailed');
       currentStep = 1;
     }
   }
 
+  async function readFileText(file: File): Promise<string> {
+    try {
+      return await file.text();
+    } catch {
+      throw new ImportFileReadError();
+    }
+  }
+
+  function parseImportJson(text: string): unknown {
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new ImportFileReadError();
+    }
+  }
+
   function handleDrop(e: DragEvent) {
     e.preventDefault();
     if (e.dataTransfer?.files?.[0]) {
@@ -244,20 +273,78 @@
     return record;
   }
 
-  function validateMappedRows(): string | null {
+  function mapSourceRow(source: unknown[]): Record<string, unknown> {
+    return mapRow(Object.fromEntries(rawHeaders.map((header, column) => [header, source[column]])));
+  }
+
+  function snapshotPreviewResult(result: ImportPreviewResult): ImportPreviewResult {
+    const failedRows = result.failedRows.map(failure => Object.freeze({
+      row: failure.row,
+      error: failure.error,
+    }));
+    Object.freeze(failedRows);
+    return Object.freeze({
+      totalRows: result.totalRows,
+      importableRows: result.importableRows,
+      failedRows,
+    });
+  }
+
+  function evaluateMappedRows(): ImportPreviewResult {
+    const failedRows: ImportPreviewResult['failedRows'] = [];
+    for (const [index, source] of rawRows.entries()) {
+      try {
+        parseContractCreateInput(binding.resource, mapSourceRow(source));
+      } catch {
+        failedRows.push(invalidImportPreviewFailure(index + 1));
+      }
+    }
+    return snapshotPreviewResult({
+      totalRows: rawRows.length,
+      importableRows: rawRows.length - failedRows.length,
+      failedRows,
+    });
+  }
+
+  function firstInvalidMappedRow(): number | undefined {
     for (const [index, source] of rawRows.entries()) {
       try {
-        const mapped = mapRow(Object.fromEntries(rawHeaders.map((header, column) => [header, source[column]])));
-        parseContractCreateInput(binding.resource, mapped);
+        parseContractCreateInput(binding.resource, mapSourceRow(source));
       } catch {
-        return i18n.t('import.invalidRow', { row: index + 1 });
+        return index + 1;
       }
     }
-    return null;
+    return undefined;
+  }
+
+  function validateMappedRows(): string | null {
+    const row = firstInvalidMappedRow();
+    return row === undefined ? null : i18n.t('import.invalidRow', { row });
+  }
+
+  function previewImport() {
+    if (!selectedFile || rawRows.length === 0 || isImporting || !open || !allowed) return;
+    if (!dryRun && !onPreview) return;
+    const targets = Object.values(columnMapping).filter(Boolean);
+    if (targets.length === 0 || new Set(targets).size !== targets.length) {
+      fileError = 'Map at least one column, and use each target field only once.';
+      previewResult = null;
+      return;
+    }
+    fileError = null;
+    importError = null;
+    previewResult = evaluateMappedRows();
+    currentStep = 3;
+    try {
+      // 观察者只拿到隔离的只读快照；同步抛错或异步拒绝都不能改变已完成的本地预览。
+      const observerSnapshot = snapshotPreviewResult(previewResult);
+      void Promise.resolve(onPreview?.(observerSnapshot)).catch(() => {});
+    } catch { /* 观察者失败不能改变已完成的本地预览结果。 */ }
   }
 
   async function startImport() {
     if (!selectedFile || rawRows.length === 0 || isImporting || !open || !allowed) return;
+    if (dryRun) { previewImport(); return; }
     if (durableMode && (!activeTaskProvider || !taskName?.trim() || !taskIdempotencyKey?.trim())) {
       fileError = i18n.t('import.taskConfiguration');
       return;
@@ -275,6 +362,7 @@
     const origin = scope;
     const token = parseToken;
     const notifySuccess = onSuccess;
+    previewResult = null;
     currentStep = 3;
     succeededCount = 0;
     failedRecords = [];
@@ -292,8 +380,7 @@
           throw new Error(i18n.t('import.taskConfiguration'));
         }
         const records = taskArtifactProvider ? undefined : rawRows.map((source, index) => {
-          const mapped = mapRow(Object.fromEntries(rawHeaders.map((header, column) => [header, source[column]])));
-          try { return parseContractCreateInput(binding.resource, mapped); }
+          try { return parseContractCreateInput(binding.resource, mapSourceRow(source)); }
           catch { throw new Error(i18n.t('import.invalidRow', { row: index + 1 })); }
         });
         const uploaded = taskArtifactProvider
@@ -363,12 +450,12 @@
       succeededCount = result.succeeded.length;
       failedRecords = result.errored.map(item => ({
         row: item.request as Record<string, unknown>,
-        error: item.error.message,
+        error: importFailureMessage(item.error, item.row),
       }));
       importResult = { succeeded: succeededCount, failed: failedRecords.length };
     } catch (error) {
       if (!current(origin, token)) return;
-      importError = error instanceof Error ? error.message : 'Import failed.';
+      importError = importFailureMessage(error);
       importResult = null;
     }
     if (importResult) {
@@ -391,6 +478,33 @@
       left.taskIdempotencyKey === right.taskIdempotencyKey;
   }
 
+  /** Core 的 HttpError.message 只用于诊断；界面仅按安全 code 选择本地化文案。 */
+  function importFailureMessage(error: unknown, row?: number): string {
+    let code: unknown;
+    try {
+      if (typeof error === 'object' && error !== null) {
+        code = Object.getOwnPropertyDescriptor(error, 'code')?.value;
+      }
+    } catch { /* 错误对象属于不可信诊断来源。 */ }
+    if (code === 'IMPORT_LIMIT_EXCEEDED') return i18n.t('import.limit');
+    if (code === 'INVALID_RESOURCE_INPUT') {
+      const failedRow = row ?? failureRow(error);
+      if (failedRow !== undefined) return i18n.t('import.invalidRow', { row: failedRow });
+    }
+    return i18n.t('common.operationFailed', { defaultValue: 'Import failed' });
+  }
+
+  function failureRow(error: unknown): number | undefined {
+    try {
+      if (typeof error !== 'object' || error === null) return undefined;
+      const details: unknown = Object.getOwnPropertyDescriptor(error, 'details')?.value;
+      if (typeof details !== 'object' || details === null) return undefined;
+      const row: unknown = Object.getOwnPropertyDescriptor(details, 'row')?.value;
+      return typeof row === 'number' && Number.isSafeInteger(row) && row >= 1 && row <= maxRows
+        ? row : undefined;
+    } catch { return undefined; }
+  }
+
   async function retryFailedRows(): Promise<void> {
     const receipt = retryReceipt;
     const parentTaskId = ownedTaskId;
@@ -472,6 +586,7 @@
     succeededCount = 0;
     failedRecords = [];
     importResult = null;
+    previewResult = null;
     fileError = null;
     importError = null;
     cancelled = false;
@@ -497,20 +612,27 @@
 
   let observedScope = untrack(() => scope);
   let observedOpen = untrack(() => open);
+  let observedDryRun = untrack(() => dryRun);
   $effect.pre(() => {
-    const changed = !sameScope(observedScope, scope) || (observedScope.allowed && !allowed);
+    const changed = !sameScope(observedScope, scope) || (observedScope.allowed && !allowed)
+      || observedDryRun !== dryRun;
     if (changed) {
       durableTaskId = undefined;
       durableTaskScope = undefined;
       durableHandledTaskId = undefined;
+      durableSubmitAttempt = undefined;
+      artifactUploadController?.abort();
+      artifactUploadController = undefined;
+      durablePolling = true;
     }
     if (changed || observedOpen !== open) untrack(reset);
     observedScope = scope;
     observedOpen = open;
+    observedDryRun = dryRun;
   });
   $effect(() => {
     const task = taskQuery.data;
-    if (!open || !allowed || !durableTaskId || !task || durableHandledTaskId === durableTaskId) return;
+    if (dryRun || !open || !allowed || !durableTaskId || !task || durableHandledTaskId === durableTaskId) return;
     if (!['completed', 'failed', 'cancelled'].includes(durableStatus)) return;
     durableHandledTaskId = durableTaskId;
     durablePolling = false;
@@ -555,7 +677,41 @@
       {#if !allowed}
         <p role="status">{i18n.t('common.operationFailed', { defaultValue: 'Import is unavailable.' })}</p>
       {/if}
-      {#if durableMode && (durableTaskId || durableSubmitAttempt || currentStep === 3)}
+      {#if currentStep === 3 && previewResult}
+        <div class="svadmin-u-b43b4c086d9a svadmin-u-03b4dd7f172b">
+          <div class="svadmin-u-60fbb7713999 svadmin-u-3960ffc248d9 svadmin-u-77a2a20e90d4">
+            <FileSpreadsheet class="svadmin-u-cd0d9c512cdc svadmin-u-72470489ff4e" />
+            <span>{i18n.t('import.preview')}</span>
+          </div>
+          <p role="status">
+            {i18n.t('import.previewSummary', {
+              total: previewResult.totalRows,
+              importable: previewResult.importableRows,
+              failed: previewResult.failedRows.length,
+            })}
+          </p>
+          <p>{i18n.t('import.previewHint')}</p>
+          {#if previewResult.failedRows.length > 0}
+            <div class="svadmin-u-60fbb7713999 svadmin-u-3960ffc248d9 svadmin-u-77a2a20e90d4 svadmin-u-811148b13d1e">
+              <AlertCircle class="svadmin-u-11e59c6d5f6b svadmin-u-dc7972ebf3f3" />
+              <span>{i18n.t('import.previewFailed')}</span>
+            </div>
+            <ul>
+              {#each previewResult.failedRows.slice(0, 20) as failure (failure.row)}
+                <li>{i18n.t('import.previewFailedRow', { row: failure.row, error: failure.error })}</li>
+              {/each}
+            </ul>
+          {/if}
+          <div class="svadmin-u-60fbb7713999 svadmin-u-3960ffc248d9 svadmin-u-77c08e015d14 svadmin-u-77a2a20e90d4">
+            <Button variant="outline" size="sm" onclick={() => { previewResult = null; currentStep = 2; }}>
+              {i18n.t('import.backToImport')}
+            </Button>
+            <Button variant="outline" size="sm" onclick={reset}>
+              {i18n.t('common.importAnother', { defaultValue: 'Import Another' })}
+            </Button>
+          </div>
+        </div>
+      {:else if durableMode && (durableTaskId || durableSubmitAttempt || currentStep === 3)}
         {#if durableTaskId}
           <p>{durableTaskId}</p>
           {#if taskQuery.isError}
@@ -672,16 +828,29 @@
               <ArrowLeft class="svadmin-u-7fc7f732bf7e svadmin-u-bf600f8e029c svadmin-u-618162408e7a" />
               {i18n.t('common.back', { defaultValue: 'Back' })}
             </Button>
-            <Button size="sm" disabled={!allowed || isImporting} onclick={startImport}>
-              {i18n.t('common.startImport', { defaultValue: 'Start Import' })}
-              <ArrowRight class="svadmin-u-7fc7f732bf7e svadmin-u-bf600f8e029c svadmin-u-f58b02572ab2" />
-            </Button>
+            {#if dryRun}
+              <Button size="sm" disabled={!allowed || isImporting} onclick={previewImport}>
+                {i18n.t('import.preview')}
+                <ArrowRight class="svadmin-u-7fc7f732bf7e svadmin-u-bf600f8e029c svadmin-u-f58b02572ab2" />
+              </Button>
+            {:else if onPreview}
+              <Button variant="outline" size="sm" disabled={!allowed || isImporting} onclick={previewImport}>
+                {i18n.t('common.preview')}
+                <ArrowRight class="svadmin-u-7fc7f732bf7e svadmin-u-bf600f8e029c svadmin-u-f58b02572ab2" />
+              </Button>
+            {/if}
+            {#if !dryRun}
+              <Button size="sm" disabled={!allowed || isImporting} onclick={startImport}>
+                {i18n.t('common.startImport', { defaultValue: 'Start Import' })}
+                <ArrowRight class="svadmin-u-7fc7f732bf7e svadmin-u-bf600f8e029c svadmin-u-f58b02572ab2" />
+              </Button>
+            {/if}
           </div>
         </div>
       {/if}
 
       <!-- Step 3: Progress & Summary -->
-      {#if currentStep === 3 && !durableMode}
+      {#if currentStep === 3 && !durableMode && !previewResult}
         <div class="svadmin-u-b43b4c086d9a svadmin-u-03b4dd7f172b">
           <div class="svadmin-u-6f7e013d6499">
             <div class="svadmin-u-60fbb7713999 svadmin-u-3960ffc248d9 svadmin-u-8ef2268efbbc svadmin-u-359090c2d529">

package/dist/components/ImportWizard.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { ImportArtifactProvider, TaskProvider } from '@svadmin/core';
+import type { ImportArtifactProvider, ImportPreviewResult, TaskProvider } from '@svadmin/core';
 interface Props {
     resourceName: string;
     open?: boolean;
@@ -17,6 +17,10 @@ interface Props {
         succeeded: number;
         failed: number;
     }) => void;
+    /** 只做本地解析、映射和逐行校验，不调用 Provider 写入，也不提交、轮询或取消任务。 */
+    dryRun?: boolean;
+    /** 预览结果回调；接收隔离的只读快照，失败原因与失败报告一样只含安全通用文本。 */
+    onPreview?: (result: ImportPreviewResult) => void;
 }
 declare const ImportWizard: import("svelte").Component<Props, {}, "open">;
 type ImportWizard = ReturnType<typeof ImportWizard>;

package/dist/components/InferencerPanel.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
  
   import { captureAdminContext, inferResource } from '@svadmin/core';
+  import { useTranslation } from '@svadmin/core/i18n';
   import type { InferResult } from '@svadmin/core';
   import { Button } from './ui/button/index.js';
   import { Input } from './ui/input/index.js';
@@ -14,6 +15,7 @@
   import { Wand2, Copy, Check, RefreshCw, Loader2, AlertCircle } from '@lucide/svelte';
 
   const adminContext = captureAdminContext();
+  const i18n = useTranslation();
   const resources = $derived(adminContext.resources);
 
   let selectedResource = $state('');
@@ -70,9 +72,9 @@
         resourceName,
         response.data as Record<string, unknown>[],
       );
-    } catch (e: unknown) {
+    } catch {
       if (epoch === inferenceEpoch) {
-        error = e instanceof Error ? e.message : 'Failed to fetch data for inference.';
+        error = i18n.t('common.error') ?? 'Something went wrong';
       }
     } finally {
       if (epoch === inferenceEpoch) loading = false;