@svadmin/ui 0.88.1 → 0.92.0

package/dist/components/content/FileListRow.svelte.d.ts

@@ -0,0 +1,11 @@
+import type { FileItem } from './FileList.svelte';
+type Handler = (file: FileItem) => void;
+interface Props {
+    file: FileItem;
+    ondownload?: Handler;
+    onpreview?: Handler;
+    onremove?: Handler;
+}
+declare const FileListRow: import("svelte").Component<Props, {}, "">;
+type FileListRow = ReturnType<typeof FileListRow>;
+export default FileListRow;

package/dist/components/content/ImportDropzone.svelte

@@ -1,19 +1,116 @@
 <script lang="ts">
-  import { UploadCloud } from '@lucide/svelte';
+  import { onDestroy, untrack } from 'svelte';
+  import { RotateCw, UploadCloud } from '@lucide/svelte';
+  import { useTranslation } from '@svadmin/core/i18n';
   import { Button } from '../ui/button/index.js';
   import { Input } from '../ui/input/index.js';
-  interface Props { accept?: string; loading?: boolean; status?: string; onimport?: (files: FileList | null) => void; class?: string; }
-  let { accept = '.csv,.xlsx', loading = false, status = '', onimport, class: className = '' }: Props = $props();
-  let files = $state<FileList | null>(null);
-  function choose(event: Event) {
-    files = (event.currentTarget as HTMLInputElement).files;
-    if (files?.length) onimport?.(files);
+
+  interface Props {
+    accept?: string;
+    multiple?: boolean;
+    loading?: boolean;
+    status?: string;
+    onimport?: (files: FileList | null) => void;
+    class?: string;
+  }
+  let { accept = '.csv,.xlsx', multiple = false, loading = false, status = '', onimport, class: className = '' }: Props = $props();
+  const i18n = useTranslation();
+  let nativeFiles = $state<FileList>();
+  let retryFiles = $state<FileList>();
+  let pending = $state(false);
+  let failure = $state<'type' | 'count' | 'import'>();
+  let attempt = 0;
+  let destroyed = false;
+  let observedImport = untrack(() => onimport);
+  const busy = $derived(loading || pending);
+  const errorMessage = $derived(failure === 'type'
+    ? i18n.t('common.fileTypeNotAccepted')
+    : failure === 'count'
+      ? i18n.t('common.singleFileOnly')
+      : i18n.t('common.error'));
+
+  $effect.pre(() => {
+    if (onimport === observedImport) return;
+    observedImport = onimport;
+    attempt += 1;
+    pending = false;
+    failure = undefined;
+    retryFiles = undefined;
+    nativeFiles = new DataTransfer().files;
+  });
+
+  onDestroy(() => {
+    destroyed = true;
+    attempt += 1;
+  });
+
+  function accepts(file: File): boolean {
+    if (!accept.trim()) return true;
+    return accept.split(',').map(token => token.trim().toLowerCase()).filter(Boolean).some(token =>
+      token === file.type.toLowerCase()
+      || (token.endsWith('/*') && file.type.toLowerCase().startsWith(token.slice(0, -1)))
+      || (token.startsWith('.') && file.name.toLowerCase().endsWith(token)),
+    );
+  }
+
+  async function receive(next: FileList | null | undefined): Promise<void> {
+    if (destroyed || busy || !onimport || !next?.length) return;
+    failure = undefined;
+    retryFiles = undefined;
+    nativeFiles = new DataTransfer().files;
+    if (!multiple && next.length > 1) {
+      failure = 'count';
+      return;
+    }
+    if (Array.from(next).some(file => !accepts(file))) {
+      failure = 'type';
+      return;
+    }
+    // 拖放数据只在事件处理期间可读，异步处理与重试持有独立快照。
+    const transfer = new DataTransfer();
+    for (const file of Array.from(next)) transfer.items.add(file);
+    const selected = transfer.files;
+    const current = ++attempt;
+    const handler = onimport;
+    const isCurrent = () => !destroyed && current === attempt && onimport === handler;
+    pending = true;
+    nativeFiles = selected;
+    try {
+      await handler(selected);
+    } catch {
+      if (isCurrent()) {
+        failure = 'import';
+        retryFiles = selected;
+      }
+    } finally {
+      if (isCurrent()) {
+        pending = false;
+        nativeFiles = new DataTransfer().files;
+      }
+    }
+  }
+
+  function choose(event: Event): void {
+    const target = event.currentTarget;
+    if (target instanceof HTMLInputElement) void receive(target.files);
   }
 </script>
-<div class={'svadmin-u-5f22e64f2282 svadmin-u-ca6bcd4b6f3f svadmin-u-a29b7a649c77 svadmin-u-18049387f0af svadmin-u-cd0ad9a56558 svadmin-u-0478c89a150f svadmin-u-ca6bf63030aa ' + className} data-svadmin-import-dropzone>
-  <UploadCloud class="svadmin-u-0e12dc7de920 svadmin-u-d8f5213f0fe0 svadmin-u-bfa603190748" /><p class="svadmin-u-eccd13ef4f2f svadmin-u-fc7473ca09eb svadmin-u-2689f3958069 svadmin-u-d4108abe6359">Import records</p><p class="svadmin-u-b6b02c0ebef6 svadmin-u-359090c2d529 svadmin-u-bfa603190748">CSV or spreadsheet files are accepted.</p>
-  <Input class="svadmin-u-0e12dc7de920 svadmin-u-0ab8667228fd svadmin-u-2472e9b81a97" type="file" {accept} onchange={choose} disabled={loading} />
-  {#if loading}<p class="svadmin-u-eccd13ef4f2f svadmin-u-359090c2d529 svadmin-u-bfa603190748" aria-live="polite">Importing...</p>{/if}
+
+<div class={'svadmin-u-5f22e64f2282 svadmin-u-ca6bcd4b6f3f svadmin-u-a29b7a649c77 svadmin-u-18049387f0af svadmin-u-cd0ad9a56558 svadmin-u-0478c89a150f svadmin-u-ca6bf63030aa ' + className}
+  data-svadmin-import-dropzone role="group" aria-label={i18n.t('common.importData')} aria-busy={busy}
+  ondragover={event => event.preventDefault()}
+  ondrop={event => { event.preventDefault(); void receive(event.dataTransfer?.files); }}>
+  <UploadCloud aria-hidden="true" class="svadmin-u-0e12dc7de920 svadmin-u-d8f5213f0fe0 svadmin-u-bfa603190748" />
+  <p class="svadmin-u-eccd13ef4f2f svadmin-u-fc7473ca09eb svadmin-u-2689f3958069 svadmin-u-d4108abe6359">{i18n.t('common.importData')}</p>
+  {#if accept}<p class="svadmin-u-b6b02c0ebef6 svadmin-u-359090c2d529 svadmin-u-bfa603190748">{accept}</p>{/if}
+  <Input class="svadmin-u-0e12dc7de920 svadmin-u-0ab8667228fd svadmin-u-2472e9b81a97" type="file"
+    {accept} {multiple} bind:files={nativeFiles} aria-label={i18n.t('common.chooseFile')}
+    onchange={choose} disabled={busy || !onimport} />
+  {#if busy}<p class="svadmin-u-eccd13ef4f2f svadmin-u-359090c2d529 svadmin-u-bfa603190748" role="status">{i18n.t('common.importing')}</p>{/if}
+  {#if failure}<p class="svadmin-u-eccd13ef4f2f svadmin-u-359090c2d529 svadmin-u-76747e5e02ff" role="alert">{errorMessage}</p>{/if}
+  {#if failure === 'import' && retryFiles}
+    <Button type="button" class="svadmin-u-0ab8667228fd" size="sm" disabled={busy || !onimport}
+      onclick={() => { void receive(retryFiles); }}><RotateCw aria-hidden="true" />{i18n.t('common.retry')}</Button>
+  {/if}
   {#if status}<p class="svadmin-u-eccd13ef4f2f svadmin-u-359090c2d529 svadmin-u-76747e5e02ff" role="status">{status}</p>{/if}
-  {#if !loading && files?.length}<Button class="svadmin-u-0ab8667228fd" size="sm" onclick={() => onimport?.(files)}>Import {files.length} file{files.length === 1 ? '' : 's'}</Button>{/if}
 </div>

package/dist/components/content/ImportDropzone.svelte.d.ts

@@ -1,5 +1,6 @@
 interface Props {
     accept?: string;
+    multiple?: boolean;
     loading?: boolean;
     status?: string;
     onimport?: (files: FileList | null) => void;

package/dist/components/content/IntegrationCard.svelte

@@ -4,13 +4,13 @@
   import { Badge } from '../ui/badge/index.js';
   import * as Card from '../ui/card/index.js';
   export interface IntegrationSummary { id: string; name: string; description?: string; account?: string; connected?: boolean; }
-  interface Props { integration: IntegrationSummary; onconnect?: () => void; class?: string; }
-  let { integration, onconnect, class: className = '' }: Props = $props();
+  interface Props { integration: IntegrationSummary; onconnect?: () => void; actionLabel?: string; disabled?: boolean; class?: string; }
+  let { integration, onconnect, actionLabel, disabled = false, class: className = '' }: Props = $props();
 </script>
 <Card.Card class={className}>
   <Card.CardContent class="svadmin-u-60fbb7713999 svadmin-u-60541e1e26f8 svadmin-u-1004c0c3954c svadmin-u-8e63407b5ceb">
     <span class="svadmin-u-60fbb7713999 svadmin-u-665f07fe73cc svadmin-u-012fbd121f37 svadmin-u-3960ffc248d9 svadmin-u-86843cf1e227 svadmin-u-421ac2be5045 svadmin-u-2ef11f1cb219 svadmin-u-bfa603190748"><PlugZap class="svadmin-u-f7b5fa971871" /></span>
     <div class="svadmin-u-7e0b7cdf1a94 svadmin-u-36e579c0b41c"><div class="svadmin-u-60fbb7713999 svadmin-u-1eb5c6df38c1 svadmin-u-3960ffc248d9 svadmin-u-77a2a20e90d4"><h3 class="svadmin-u-fc7473ca09eb svadmin-u-e83a7042bc91 svadmin-u-d4108abe6359">{integration.name}</h3>{#if integration.connected}<Badge variant="outline" class="svadmin-u-18a6e7a36f29 svadmin-u-17a9f7af2265 svadmin-u-76747e5e02ff"><Check class="svadmin-u-ef2d6f74d3d0" />Connected</Badge>{/if}</div><p class="svadmin-u-b6b02c0ebef6 svadmin-u-fc7473ca09eb svadmin-u-bfa603190748">{integration.description ?? 'Connect this provider to unlock synchronized workflows.'}</p>{#if integration.account}<p class="svadmin-u-50d0d216a2f8 svadmin-u-359090c2d529 svadmin-u-bfa603190748">{integration.account}</p>{/if}</div>
-    {#if onconnect}<Button variant={integration.connected ? 'outline' : 'default'} size="sm" onclick={onconnect}>{integration.connected ? 'Manage' : 'Connect'}{#if !integration.connected}<ExternalLink class="svadmin-u-783b0d9d1e2c" />{/if}</Button>{/if}
+    {#if onconnect}<Button variant={integration.connected ? 'outline' : 'default'} size="sm" {disabled} onclick={onconnect}>{actionLabel ?? (integration.connected ? 'Manage' : 'Connect')}{#if !integration.connected && !actionLabel}<ExternalLink class="svadmin-u-783b0d9d1e2c" />{/if}</Button>{/if}
   </Card.CardContent>
 </Card.Card>

package/dist/components/content/IntegrationCard.svelte.d.ts

@@ -8,6 +8,8 @@ export interface IntegrationSummary {
 interface Props {
     integration: IntegrationSummary;
     onconnect?: () => void;
+    actionLabel?: string;
+    disabled?: boolean;
     class?: string;
 }
 declare const IntegrationCard: import("svelte").Component<Props, {}, "">;

package/dist/components/content/MediaThumbnail.svelte

@@ -2,6 +2,7 @@
   import { Eye, FileText, ImageOff, Loader2 } from '@lucide/svelte';
   import * as Dialog from '../ui/dialog/index.js';
   import { cn } from '../../utils.js';
+  import { useTranslation } from '@svadmin/core/i18n';
 
   export type MediaThumbnailSize = 'sm' | 'md' | 'lg' | 'full';
   export type MediaThumbnailFit = 'contain' | 'cover';
@@ -37,11 +38,14 @@
     overlayText = 'View',
     emptyLabel = 'No media',
     loadingLabel = 'Loading media',
-    errorLabel = 'Image unavailable',
+    errorLabel,
     onopen,
     class: className = '',
   }: Props = $props();
 
+  const i18n = useTranslation();
+  const resolvedErrorLabel = $derived(errorLabel ?? i18n.t('common.error'));
+
   const isImage = $derived(Boolean(
     (mimeType && mimeType.startsWith('image/'))
     || (src && /\.(png|jpe?g|webp|gif|svg|bmp|avif)(\?.*)?$/i.test(src))
@@ -85,7 +89,7 @@
     {#if imageState === 'loading'}
       <div class="svadmin-u-da4dbfbc4fdc svadmin-u-7b7df0449b80 svadmin-u-60fbb7713999 svadmin-u-3960ffc248d9 svadmin-u-86843cf1e227 svadmin-u-b00f43c30c2b" role="status" aria-label={loadingLabel}><Loader2 class="svadmin-u-f7b5fa971871 svadmin-u-afbdd13a380e svadmin-u-bfa603190748" aria-hidden="true" /></div>
     {:else if imageState === 'error'}
-      <div class="svadmin-u-da4dbfbc4fdc svadmin-u-7b7df0449b80 svadmin-u-60fbb7713999 svadmin-u-8dddea0773ed svadmin-u-3960ffc248d9 svadmin-u-86843cf1e227 svadmin-u-44ee8ba0a421 svadmin-u-eb6e8b881acd svadmin-u-ca6bf63030aa svadmin-u-359090c2d529 svadmin-u-bfa603190748" role="img" aria-label={errorLabel} data-slot="media-thumbnail-error"><ImageOff class="svadmin-u-add63bc6753d" aria-hidden="true" /><span class="svadmin-u-4bfac3b6a99f svadmin-u-f283ea9bea0e svadmin-u-d058ca6de60f">{errorLabel}</span></div>
+      <div class="svadmin-u-da4dbfbc4fdc svadmin-u-7b7df0449b80 svadmin-u-60fbb7713999 svadmin-u-8dddea0773ed svadmin-u-3960ffc248d9 svadmin-u-86843cf1e227 svadmin-u-44ee8ba0a421 svadmin-u-eb6e8b881acd svadmin-u-ca6bf63030aa svadmin-u-359090c2d529 svadmin-u-bfa603190748" role="img" aria-label={resolvedErrorLabel} data-slot="media-thumbnail-error"><ImageOff class="svadmin-u-add63bc6753d" aria-hidden="true" /><span class="svadmin-u-4bfac3b6a99f svadmin-u-f283ea9bea0e svadmin-u-d058ca6de60f">{resolvedErrorLabel}</span></div>
     {:else if showOverlay}
       <Dialog.Root bind:open={previewOpen}>
         <button type="button" class="group svadmin-u-da4dbfbc4fdc svadmin-u-7b7df0449b80 svadmin-u-3bbc8c13feec svadmin-u-df37b1fd9495 svadmin-u-793c80e97ffb svadmin-u-9c1295a6914a svadmin-u-77923ba6606a" onclick={openMedia} aria-label={alt ? `Preview ${alt}` : overlayText}>

package/dist/components/detail-workspace.d.ts

@@ -0,0 +1,60 @@
+import type { Snippet } from 'svelte';
+import type { AuditEntry } from '@svadmin/core';
+import type { TimelineItem } from './content/AuditTimeline.svelte';
+import type { FileItem } from './content/FileList.svelte';
+/** The record identity every detail workspace section is bound to. */
+export interface DetailWorkspaceScope {
+    readonly resourceName: string;
+    readonly recordId: string | number;
+    /** Tenant/provider metadata resolved through `AdminContextAccessor.getProviderMeta`. */
+    readonly meta?: Record<string, unknown> | undefined;
+}
+/**
+ * A section provider is an explicit, optional data contract. It is never called
+ * without a concrete resourceName/recordId, and the consumer aborts it when the
+ * section is destroyed.
+ */
+export interface DetailWorkspaceProvider<T> {
+    load(scope: DetailWorkspaceScope, signal: AbortSignal): Promise<T>;
+}
+export type DetailWorkspaceSnippet = Snippet<[DetailWorkspaceScope]>;
+export interface DetailWorkspaceAsyncSection<T> {
+    provider: DetailWorkspaceProvider<T>;
+    /** Optional custom renderer; the component falls back to its matching display component. */
+    render?: Snippet<[DetailWorkspaceScope & {
+        data: T;
+    }]>;
+    /** Optional predicate for an explicit empty result. */
+    empty?: (data: T) => boolean;
+    emptyTitle?: string;
+    errorTitle?: string;
+}
+/**
+ * A section is either a provider-backed section or an explicit snippet provider.
+ * Snippet providers receive the same resourceName/recordId scope and are rebuilt
+ * when that scope changes.
+ */
+export type DetailWorkspaceSection<T> = DetailWorkspaceSnippet | DetailWorkspaceAsyncSection<T>;
+export interface DetailWorkspaceVersionData {
+    oldValue: Record<string, unknown>;
+    newValue: Record<string, unknown>;
+    oldTitle?: string;
+    newTitle?: string;
+    fieldLabels?: Record<string, string>;
+}
+/**
+ * Detail workspace configuration for the real AutoTable detail drawer.
+ *
+ * Audit uses the existing AuditLogProvider by default. Relations, attachments,
+ * activity and versions have no core provider contract yet, so they must be
+ * supplied explicitly as provider or snippet sections. Missing sections fail
+ * closed instead of rendering placeholder business data.
+ */
+export interface DetailWorkspaceSectionsConfig {
+    relations?: DetailWorkspaceSnippet;
+    attachments?: DetailWorkspaceSection<FileItem[]>;
+    activity?: DetailWorkspaceSection<TimelineItem[]>;
+    audit?: DetailWorkspaceSection<AuditEntry[]>;
+    versions?: DetailWorkspaceSection<DetailWorkspaceVersionData>;
+}
+export declare function isDetailWorkspaceSnippet<T>(section: DetailWorkspaceSection<T> | undefined): section is DetailWorkspaceSnippet;

package/dist/components/detail-workspace.js

@@ -0,0 +1,3 @@
+export function isDetailWorkspaceSnippet(section) {
+    return typeof section === 'function';
+}

package/dist/components/enterprise/json-schema-form.d.ts

@@ -1,6 +1,6 @@
 /** JsonSchemaForm 当前支持的标量子集。未知断言必须显式拒绝，不能假装已校验。 */
 export type JsonScalar = string | number | boolean | null;
-export type SchemaIssueCode = 'unsupported-schema' | 'invalid-schema' | 'required' | 'type' | 'enum' | 'minimum' | 'maximum' | 'multipleOf' | 'minLength' | 'maxLength' | 'additionalProperties' | 'invalid-value' | 'minItems' | 'maxItems';
+export type SchemaIssueCode = 'unsupported-schema' | 'invalid-schema' | 'ref-invalid' | 'ref-cycle' | 'ref-limit' | 'oneOf-invalid' | 'oneOf-unsupported' | 'oneOf-unselected' | 'oneOf-ambiguous' | 'required' | 'type' | 'enum' | 'minimum' | 'maximum' | 'multipleOf' | 'minLength' | 'maxLength' | 'additionalProperties' | 'invalid-value' | 'minItems' | 'maxItems';
 export interface SchemaFormIssue {
     path: string;
     code: SchemaIssueCode;

package/dist/components/enterprise/recursive-schema-form.d.ts

@@ -1,4 +1,4 @@
-import { type SchemaFormModel, type SchemaFormIssue } from './json-schema-form.js';
+import { type JsonScalar, type SchemaFormModel, type SchemaFormIssue } from './json-schema-form.js';
 type Node = {
     kind: 'object';
     properties: Record<string, Node>;
@@ -11,10 +11,18 @@ type Node = {
     min: number | undefined;
     max: number | undefined;
     nullable: boolean;
+} | {
+    kind: 'oneOf';
+    branches: Node[];
+    propertyName: string;
+    values: JsonScalar[][];
+    nullable: boolean;
 } | {
     kind: 'scalar';
     model: SchemaFormModel;
 };
+export type RecursiveSchemaFormNode = Node;
+export type OneOfSelection = number | 'oneOf-unselected' | 'oneOf-ambiguous';
 export interface RecursiveSchemaFormModel {
     node: Node | undefined;
     issues: SchemaFormIssue[];
@@ -25,6 +33,12 @@ export declare const schemaFormPointer: (path: readonly string[]) => string;
  * TypeBox's symbol annotations are not JSON assertion keywords and are not executed.
  */
 export declare function readRecursiveSchemaForm(schema: unknown): RecursiveSchemaFormModel;
+/** Return the unique branch selected by data; missing or overlapping values never fall back to first match. */
+export declare function selectRecursiveOneOfBranch(node: RecursiveSchemaFormNode, current: unknown): OneOfSelection;
+/** Switch the explicit discriminator and drop keys that exist only on unselected branches. */
+export declare function switchRecursiveOneOfBranch(node: RecursiveSchemaFormNode, current: unknown, index: number, preferred?: JsonScalar): Record<string, unknown> | undefined;
+/** Return a detached payload with stale unselected `oneOf` branch keys removed. */
+export declare function pruneRecursiveSchemaFormValue(model: RecursiveSchemaFormModel, value: unknown): Record<string, unknown>;
 /** Validate a detached JSON payload without defaults, coercion, cleaning or partial acceptance. */
 export declare function validateRecursiveSchemaForm(model: RecursiveSchemaFormModel, value: unknown): SchemaFormIssue[];
 export {};