@svadmin/ui 0.88.1 → 0.91.0

package/dist/components/ui/sheet/sheet.svelte

@@ -35,8 +35,11 @@
 	import { tick } from "svelte";
 	import { Portal } from "bits-ui";
 	import { cn, type WithElementRef } from "../../../utils.js";
+	import { useTranslation } from "@svadmin/core/i18n";
 	import type { HTMLAttributes } from "svelte/elements";
 
+	const i18n = useTranslation();
+
 	const focusableSelector = [
 		'a[href]',
 		'button',
@@ -61,7 +64,7 @@
 		side = "right",
 		onClose,
 		onCloseRequest,
-		closeLabel = "Close",
+		closeLabel = i18n.t("common.close"),
 		class: className,
 		tabindex = -1,
 		children,

package/dist/components/version-history.d.ts

@@ -0,0 +1,14 @@
+import type { DetailWorkspaceVersionData } from './detail-workspace';
+/** 显式存储的记录版本。快照必须是普通 JSON 对象，不包含恢复或合并动作。 */
+export interface StoredRecordVersion {
+    id: string;
+    version: number;
+    title?: string;
+    snapshot: Record<string, unknown>;
+}
+/**
+ * 把已选版本映射成详情区现有的 old/new 载荷。
+ * 选中项是 newValue，按版本号紧邻的上一条是 oldValue；没有上一条时旧值为空对象。
+ * 未知选择、重复版本号或非普通对象快照都返回 null，不猜测差异。
+ */
+export declare function selectRecordVersion(versions: readonly StoredRecordVersion[], selectedId: string): DetailWorkspaceVersionData | null;

package/dist/components/version-history.js

@@ -0,0 +1,32 @@
+function plainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 把已选版本映射成详情区现有的 old/new 载荷。
+ * 选中项是 newValue，按版本号紧邻的上一条是 oldValue；没有上一条时旧值为空对象。
+ * 未知选择、重复版本号或非普通对象快照都返回 null，不猜测差异。
+ */
+export function selectRecordVersion(versions, selectedId) {
+    if (selectedId.length === 0)
+        return null;
+    const versionNumbers = new Set();
+    for (const item of versions) {
+        if (!Number.isInteger(item.version) || versionNumbers.has(item.version) || !plainRecord(item.snapshot))
+            return null;
+        versionNumbers.add(item.version);
+    }
+    const ordered = [...versions].sort((left, right) => left.version - right.version);
+    const index = ordered.findIndex(item => item.id === selectedId);
+    if (index < 0)
+        return null;
+    const selected = ordered[index];
+    const previous = index > 0 ? ordered[index - 1] : undefined;
+    if (!selected || !plainRecord(selected.snapshot))
+        return null;
+    return {
+        oldValue: previous?.snapshot ?? {},
+        newValue: selected.snapshot,
+        ...(previous?.title === undefined ? {} : { oldTitle: previous.title }),
+        ...(selected.title === undefined ? {} : { newTitle: selected.title }),
+    };
+}

package/dist/components/workspace-tab-state.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 多标签工作区的状态适配器。
+ *
+ * 组件 `MultiTabKeepAlive` 只负责标签栏交互与关闭保护；路由、查询、滚动和草稿
+ * 属于真实消费者。本适配器提供显式、可测试的快照契约：
+ * - 以“租户 + 标签 id”为内存键，恢复时再校验 path，避免同 id 不同路由串状态；
+ * - 持久化是可选注入的 storage，默认仅在内存中保存，不擅自写 localStorage；
+ * - 快照带版本、租户、标签和路径，非法或过期数据按未保存处理。
+ */
+export interface WorkspaceTabRef {
+    id: string;
+}
+export interface WorkspaceTabIdentity extends WorkspaceTabRef {
+    path: string;
+}
+/** 可安全序列化为 JSON 的草稿值。 */
+export type WorkspaceDraftJsonValue = null | boolean | string | number | WorkspaceDraftJsonValue[] | WorkspaceDraftJsonObject;
+/** 草稿载荷的顶层只接受普通对象。 */
+export interface WorkspaceDraftJsonObject {
+    [key: string]: WorkspaceDraftJsonValue;
+}
+export interface WorkspaceTabViewState {
+    /** 规范化后的查询串，不包含开头的 `?`。 */
+    query: string;
+    scrollTop: number;
+    scrollLeft: number;
+    draft: boolean;
+    /** 仅当显式配置 userId、draftFields 和 storage 后才会持久化的草稿字段。 */
+    draftData?: WorkspaceDraftJsonObject | undefined;
+}
+export interface WorkspaceTabStateStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface WorkspaceTabClearResult {
+    /** 当前实例的内存快照是否已移除。 */
+    memoryCleared: boolean;
+    /**
+     * 持久化清理结果。`failed` 表示 removeItem 失败或未能真正删除；适配器会尝试
+     * 写入跨实例关闭标记，并保证同一运行时的其它 adapter 使用同一 storage 对象时
+     * 不再回读旧快照。若 storage 连关闭标记也无法写入，刷新或跨运行时的新实例仍
+     * 可能读到旧快照，调用方不能据此声称持久化已删除。
+     */
+    storage: 'cleared' | 'failed' | 'not-configured';
+}
+export interface WorkspaceTabStateAdapter {
+    /** 保存标签快照；未提供的字段沿用已有快照或默认值。 */
+    capture(tab: WorkspaceTabIdentity, state?: Partial<WorkspaceTabViewState>): WorkspaceTabViewState;
+    /** 仅当租户、标签 id 和 path 都匹配时返回快照。 */
+    restore(tab: WorkspaceTabIdentity): WorkspaceTabViewState | undefined;
+    markDraft(tab: WorkspaceTabIdentity, draft: boolean): void;
+    hasDraft(tab: WorkspaceTabIdentity): boolean;
+    /** 标签关闭后清理，并显式报告持久化删除是否成功。 */
+    clear(tab: WorkspaceTabRef): WorkspaceTabClearResult;
+    /** 卸载清理只释放内存快照；持久化数据由 storage 的所有者决定。 */
+    dispose(): void;
+    /**
+     * 最近一次草稿载荷处理结果。`capture` 的返回状态不携带诊断，避免改变既有
+     * 返回契约；调用方需要区分“未尝试草稿”和“草稿被拒绝”时读取此方法。
+     */
+    getLastDraftDataIssue(): WorkspaceDraftDataIssue | undefined;
+}
+export type WorkspaceDraftDataIssue = 'disabled' | 'empty-allowlist' | 'invalid' | 'too-large' | 'storage-failed';
+export interface WorkspaceTabStateAdapterOptions {
+    /** 租户隔离键；不同租户即使标签 id/path 相同也不共享快照。 */
+    tenantId: string;
+    /** 可选持久化；传入 sessionStorage 等实现即可跨刷新恢复。 */
+    storage?: WorkspaceTabStateStorage | null;
+    keyPrefix?: string;
+    /** 草稿数据所属用户；未提供时使用固定 anonymous 仅维持旧视图快照。 */
+    userId?: string;
+    /** 草稿顶层字段白名单；空数组或缺省都不会保存 draftData。 */
+    draftFields?: readonly string[];
+    /** draftData 序列化后的 UTF-8 字节上限，默认 65536。 */
+    maxDraftBytes?: number;
+}
+export declare function createWorkspaceTabStateAdapter(options: WorkspaceTabStateAdapterOptions): WorkspaceTabStateAdapter;