From d94db238c5af33811d4235de5ce360e43c454f92 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 8 Mar 2026 22:16:40 +0000 Subject: [PATCH] =?UTF-8?q?feat:=20add=20device=20sync=20=E2=80=94=20expor?= =?UTF-8?q?t/import=20build=20presets=20across=20devices?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - New deviceSync.ts with versioned JSON payload format, merge + replace strategies, clipboard/file/Web Share API helpers, and SyncProvider interface outline for future cloud relay - ImportPresetsModal.svelte with paste, file upload, merge/replace actions - Device Sync section added to Settings (between Build and Node) - 68 tests pass (14 new deviceSync unit tests added) - Locale strings added for en, ja, zh Co-authored-by: Shilo --- src/lib/ModalHost.svelte | 13 + src/lib/deviceSync.ts | 232 ++++++++++++ src/lib/modalStore.ts | 2 +- src/lib/modals/ImportPresetsModal.svelte | 337 ++++++++++++++++++ .../sideMenuPages/SideMenuSettingsPage.svelte | 83 +++++ src/locales/en.json | 26 ++ src/locales/ja.json | 37 +- src/locales/zh.json | 71 +++- test/deviceSync.test.ts | 204 +++++++++++ test/index.ts | 61 ++-- 10 files changed, 1014 insertions(+), 52 deletions(-) create mode 100644 src/lib/deviceSync.ts create mode 100644 src/lib/modals/ImportPresetsModal.svelte create mode 100644 test/deviceSync.test.ts diff --git a/src/lib/ModalHost.svelte b/src/lib/ModalHost.svelte index 7abac054..9fb410e1 100644 --- a/src/lib/ModalHost.svelte +++ b/src/lib/ModalHost.svelte @@ -4,6 +4,7 @@ import InputModal from "./modals/InputModal.svelte"; import TextInputModal from "./modals/TextInputModal.svelte"; import LoadBuildModal from "./modals/LoadBuildModal.svelte"; + import ImportPresetsModal from "./modals/ImportPresetsModal.svelte"; import { get } from "svelte/store"; import { closeModal, modalStore } from "./modalStore"; import { triggerHaptic } from "./hapticsStore"; @@ -245,6 +246,18 @@ onLoaded={() => handleConfirm()} onCancel={handleCancel} /> + {:else if $modalStore.type === "importPresets"} + handleConfirm()} + onCancel={handleCancel} + /> {/if} diff --git a/src/lib/deviceSync.ts b/src/lib/deviceSync.ts new file mode 100644 index 00000000..8bc169cd --- /dev/null +++ b/src/lib/deviceSync.ts @@ -0,0 +1,232 @@ +/** + * Device sync — export / import build presets across devices. + * + * Presets travel as a self-describing JSON payload (version-tagged). + * Settings are intentionally excluded: they are device-specific. + * + * Architecture note: + * The `SyncProvider` interface below outlines the contract for a future + * cloud-relay backend (Cloudflare Workers KV, Firebase RTDB, etc.). + * The current implementation is manual (clipboard + file) and requires + * no server. When a relay is added, swap in a `CloudSyncProvider` and + * wire the store subscription to `push()` on every preset mutation for + * automatic sync. + */ + +import { + buildPresetsStore, + type BuildPreset, + type BuildPresetsData, +} from "./buildPresetsStore"; +import { decodeBuildData } from "./buildData/encoder"; +import { get } from "svelte/store"; + +// ─── Sync payload ──────────────────────────────────────────────── + +export const SYNC_FORMAT_VERSION = 1; + +export interface SyncPreset { + name: string; + build: string; +} + +export interface SyncPayload { + v: number; + presets: SyncPreset[]; +} + +// ─── Encode / decode ───────────────────────────────────────────── + +export function encodePresetsForSync(data: BuildPresetsData): string { + const payload: SyncPayload = { + v: SYNC_FORMAT_VERSION, + presets: data.presets.map((p) => ({ name: p.name, build: p.buildCode })), + }; + return JSON.stringify(payload); +} + +export function decodeSyncPayload(raw: string): SyncPreset[] | null { + try { + const parsed = JSON.parse(raw) as unknown; + if (!parsed || typeof parsed !== "object") return null; + const obj = parsed as Record; + if (typeof obj.v !== "number" || !Array.isArray(obj.presets)) return null; + + const presets: SyncPreset[] = []; + for (const entry of obj.presets) { + if (!entry || typeof entry !== "object") continue; + const e = entry as Record; + if (typeof e.name !== "string" || typeof e.build !== "string") continue; + if (!decodeBuildData(e.build)) continue; + presets.push({ name: e.name.trim() || "Build", build: e.build }); + } + return presets.length > 0 ? presets : null; + } catch { + return null; + } +} + +// ─── Merge strategies ──────────────────────────────────────────── + +function generatePresetId(): string { + if (typeof crypto !== "undefined" && crypto.randomUUID) { + return crypto.randomUUID(); + } + return `preset-${Date.now().toString(36)}`; +} + +function syncPresetToBuildPreset(sp: SyncPreset): BuildPreset { + return { id: generatePresetId(), name: sp.name, buildCode: sp.build }; +} + +/** + * Replace all local presets with incoming ones. + * Active is set to the first preset. + */ +export function replaceAllPresets(incoming: SyncPreset[]): BuildPresetsData { + const presets = incoming.map(syncPresetToBuildPreset); + return { active: presets[0].id, presets }; +} + +function makeUniqueName(desired: string, takenNames: Set): string { + if (!takenNames.has(desired.toLowerCase())) return desired; + const match = desired.match(/^(.+?)\s+(\d+)$/); + const prefix = match ? match[1] : desired; + let counter = match ? parseInt(match[2], 10) : 2; + let candidate = `${prefix} ${counter}`; + while (takenNames.has(candidate.toLowerCase())) { + counter++; + candidate = `${prefix} ${counter}`; + } + return candidate; +} + +/** + * Merge incoming presets into local data. + * Presets whose name AND build code already exist locally are skipped. + * New presets get a unique name if there is a name collision with a different build. + */ +export function mergePresets( + local: BuildPresetsData, + incoming: SyncPreset[], +): BuildPresetsData { + const existingNames = new Set( + local.presets.map((p) => p.name.toLowerCase()), + ); + const existingCodes = new Set(local.presets.map((p) => p.buildCode)); + + const added: BuildPreset[] = []; + for (const sp of incoming) { + if (existingNames.has(sp.name.toLowerCase()) && existingCodes.has(sp.build)) { + continue; + } + + const name = existingNames.has(sp.name.toLowerCase()) + ? makeUniqueName(sp.name, existingNames) + : sp.name; + + added.push({ id: generatePresetId(), name, buildCode: sp.build }); + existingNames.add(name.toLowerCase()); + existingCodes.add(sp.build); + } + + if (added.length === 0) return local; + return { active: local.active, presets: [...local.presets, ...added] }; +} + +// ─── Clipboard helpers ─────────────────────────────────────────── + +export async function exportPresetsToClipboard(): Promise { + if (typeof navigator === "undefined" || !navigator.clipboard?.writeText) { + return false; + } + try { + const json = encodePresetsForSync(get(buildPresetsStore)); + await navigator.clipboard.writeText(json); + return true; + } catch { + return false; + } +} + +// ─── File helpers ──────────────────────────────────────────────── + +export function exportPresetsToFile(): void { + const json = encodePresetsForSync(get(buildPresetsStore)); + const blob = new Blob([json], { type: "application/json" }); + const url = URL.createObjectURL(blob); + const a = document.createElement("a"); + a.href = url; + a.download = "backpack-presets.json"; + a.click(); + URL.revokeObjectURL(url); +} + +export function importPresetsFromFile(): Promise { + return new Promise((resolve) => { + const input = document.createElement("input"); + input.type = "file"; + input.accept = ".json,application/json"; + input.onchange = async () => { + const file = input.files?.[0]; + if (!file) { resolve(null); return; } + try { + const text = await file.text(); + resolve(decodeSyncPayload(text)); + } catch { + resolve(null); + } + }; + input.oncancel = () => resolve(null); + input.click(); + }); +} + +// ─── Web Share API ─────────────────────────────────────────────── + +export type SharePresetsResult = "shared" | "copied" | "cancelled" | "failed"; + +export async function sharePresetsNative(): Promise { + if (typeof window === "undefined" || typeof navigator === "undefined") { + return "failed"; + } + + const json = encodePresetsForSync(get(buildPresetsStore)); + + if (typeof navigator.share === "function") { + try { + const file = new File([json], "backpack-presets.json", { + type: "application/json", + }); + await navigator.share({ files: [file] }); + return "shared"; + } catch (error: unknown) { + const err = error as { name?: string }; + if (err?.name === "AbortError") return "cancelled"; + } + } + + if (navigator.clipboard?.writeText) { + try { + await navigator.clipboard.writeText(json); + return "copied"; + } catch { + return "failed"; + } + } + + return "failed"; +} + +// ─── SyncProvider interface (future cloud relay) ───────────────── +// +// export interface SyncProvider { +// push(payload: SyncPayload): Promise; +// pull(): Promise; +// } +// +// A CloudSyncProvider would: +// 1. push() on every buildPresetsStore mutation +// 2. pull() on app start and/or on a periodic timer +// 3. Use a user-chosen passphrase or generated room code as the key +// 4. Store data in Cloudflare Workers KV, Firebase RTDB, or similar diff --git a/src/lib/modalStore.ts b/src/lib/modalStore.ts index 9dc23e2a..9e530d8a 100644 --- a/src/lib/modalStore.ts +++ b/src/lib/modalStore.ts @@ -2,7 +2,7 @@ import type { Component } from "svelte"; import type { IconWeight } from "phosphor-svelte"; import { writable } from "svelte/store"; -export type ModalType = "confirm" | "input" | "textInput" | "loadBuild"; +export type ModalType = "confirm" | "input" | "textInput" | "loadBuild" | "importPresets"; export type ModalInputConfig = { label: string; diff --git a/src/lib/modals/ImportPresetsModal.svelte b/src/lib/modals/ImportPresetsModal.svelte new file mode 100644 index 00000000..2b0a4131 --- /dev/null +++ b/src/lib/modals/ImportPresetsModal.svelte @@ -0,0 +1,337 @@ + + +
+
+
+ {#if titleIcon} + + {/if} +

{resolvedTitle}

+
+
+ {#if resolvedMessage} +

{resolvedMessage}

+ {/if} + + +
+ + +
+ + {#if parsedPresets} +

+ {$t("deviceSync.foundPresets", { count: parsedPresets.length })} +

+ {/if} + + + +
+ + + +
+
+ + diff --git a/src/lib/sideMenuPages/SideMenuSettingsPage.svelte b/src/lib/sideMenuPages/SideMenuSettingsPage.svelte index 6b585a80..2401e9a0 100644 --- a/src/lib/sideMenuPages/SideMenuSettingsPage.svelte +++ b/src/lib/sideMenuPages/SideMenuSettingsPage.svelte @@ -10,6 +10,9 @@ TrashSimpleIcon, EyeIcon, GraphIcon, + ExportIcon, + DownloadSimpleIcon, + UploadSimpleIcon, } from "phosphor-svelte"; import { fade } from "svelte/transition"; import type { Component } from "svelte"; @@ -54,6 +57,11 @@ import { textSize } from "../textSizeStore"; import { showToast } from "../toast"; import { clearAll } from "../storage"; + import { + exportPresetsToClipboard, + exportPresetsToFile, + sharePresetsNative, + } from "../deviceSync"; import type { TreeViewState } from "../Tree.svelte"; import { treeLevels } from "../treeLevelsStore"; import { onMount } from "svelte"; @@ -246,6 +254,40 @@ }); } + async function handleExportPresets() { + triggerHaptic(); + const result = await sharePresetsNative(); + if (result === "shared") { + showToast($t("deviceSync.exportedToast")); + } else if (result === "copied") { + showToast($t("deviceSync.copiedToast")); + } else if (result === "cancelled") { + // User dismissed share dialog + } else { + showToast($t("deviceSync.exportFailedToast"), { tone: "negative" }); + } + } + + function handleDownloadPresets() { + triggerHaptic(); + exportPresetsToFile(); + showToast($t("deviceSync.downloadedToast")); + } + + function handleImportPresets() { + triggerHaptic(); + openModal({ + type: "importPresets", + title: $t("deviceSync.importModalTitle"), + titleIcon: UploadSimpleIcon as unknown as Component, + message: $t("deviceSync.importModalMessage"), + cancelLabel: $t("common.cancel"), + onConfirm: () => { + onClose?.(); + }, + }); + } + function handlePreviewDropdownClick() { if (!previewButtonElement) return; const rect = previewButtonElement.getBoundingClientRect(); @@ -283,6 +325,35 @@ + +
+ +
+ + + :global(:first-child) { + border-right: none; + } + + .sync-row > :global(.dropdown-button) { + border-left: var(--border-width) solid var(--border); + } + .build-share-row :global(.button) { flex: 1 1 auto; } diff --git a/src/locales/en.json b/src/locales/en.json index ef4ca5f9..bbdb4ad1 100644 --- a/src/locales/en.json +++ b/src/locales/en.json @@ -45,6 +45,7 @@ "node": "Node", "view": "View", "tree": "Tree", + "deviceSync": "Device Sync", "lookAndFeel": "Look and feel", "application": "Application", "statistics": "Statistics", @@ -432,6 +433,31 @@ "tooltip": "Install {appName} app on {osName}", "buttonLabel": "Install app on {osName}" }, + "deviceSync": { + "exportButton": "Export Presets", + "exportTooltip": "Share all build presets to another device via clipboard or share", + "downloadTooltip": "Download presets as a backup file", + "importButton": "Import Presets", + "importTooltip": "Import build presets from another device or backup file", + "importModalTitle": "IMPORT BUILD PRESETS", + "importModalMessage": "Paste exported preset data or import from a backup file. Settings are device-specific and will not be affected.", + "inputLabel": "Exported preset data", + "inputPlaceholder": "{\"v\":1,\"presets\":[...]}", + "importFromFile": "Import from file", + "importFromFileTooltip": "Import presets from a JSON backup file", + "foundPresets": "Found {count} preset(s) ready to import", + "replaceAll": "Replace All", + "replaceAllTooltip": "Remove all local presets and import these instead", + "merge": "Merge", + "mergeTooltip": "Add new presets alongside existing ones", + "exportedToast": "Presets shared", + "copiedToast": "Presets copied to clipboard", + "exportFailedToast": "Unable to export presets", + "downloadedToast": "Presets file downloaded", + "importedToast": "Imported {count} preset(s)", + "invalidDataToast": "Invalid preset data", + "invalidFileToast": "Invalid preset file" + }, "toast": { "copied": "Copied", "unableToCopy": "Unable to copy", diff --git a/src/locales/ja.json b/src/locales/ja.json index 5b1dfe18..1a93ba7f 100644 --- a/src/locales/ja.json +++ b/src/locales/ja.json @@ -52,6 +52,7 @@ "mouse": "マウス", "keyboard": "キーボード", "hud": "HUD (ヘッドアップディスプレイ)", + "deviceSync": "デバイス同期", "controlsTab": "サイドメニューの操作タブ" } }, @@ -76,7 +77,7 @@ "pierce_resistance": "貫通耐性", "stun": "スタン", "pierce_damage": "貫通ダメージ", - "counterattack_resistance": "Counter Resist", + "counterattack_resistance": "反撃耐性", "critical_hit": "会心", "skill_crit_resistance": "スキル会心耐性", "ignore_stun": "スタン無視", @@ -95,7 +96,7 @@ "pierce_resistance": "貫通耐性", "stun": "スタン", "pierce_damage": "貫通ダメ", - "counterattack_resistance": "Counter Resist", + "counterattack_resistance": "反撃耐性", "critical_hit": "会心", "skill_crit_resistance": "スキル会心耐性", "ignore_stun": "スタン無視", @@ -108,14 +109,21 @@ "nodePrimaryActionTitle": "ノードの {primaryAction} アクション", "nodePrimaryActionLeftClick": "左クリック", "nodePrimaryActionTouch": "タッチ", + "nodePrimaryActionTooltip": "ノードタップ時に+1、+10、+ティアを選択", "nodeLevelBehavior": "ノードレベルの動作", "nodeLevelBehaviorSolo": "ソロのみ", "nodeLevelBehaviorSync": "系列同期", + "nodeLevelBehaviorTooltip": "ソロ: 単一ノード。同期: ノードとその系列を一緒に変更", "showTier": "ティアバッジを表示", + "showTierTooltip": "各ノードのティアバッジを表示または非表示", "showSkillName": "スキル名バッジを表示", + "showSkillNameTooltip": "各ノードのスキル名を表示または非表示", "haptics": "触覚フィードバック", + "hapticsTooltip": "デバイスが対応している場合に振動", "textSize": "フォントサイズ", + "textSizeTooltip": "ラベルやUIのフォントサイズを調整", "treeZoom": "ツリーのズーム", + "treeZoomTooltip": "ツリー全体を表示するか、拡大表示で大きなノードを見る", "treeZoomFitOption": "全体に合わせる ({scale})", "treeZoomCloseUpOption": "拡大 ({scale})", "focusTreeInView": "ツリーを画面に合わせる", @@ -425,6 +433,31 @@ "tooltip": "{osName} に {appName} アプリをインストール", "buttonLabel": "{osName} にアプリをインストール" }, + "deviceSync": { + "exportButton": "プリセットをエクスポート", + "exportTooltip": "すべてのビルドプリセットをクリップボードまたは共有で別のデバイスに送る", + "downloadTooltip": "プリセットをバックアップファイルとしてダウンロード", + "importButton": "プリセットをインポート", + "importTooltip": "別のデバイスやバックアップファイルからビルドプリセットをインポート", + "importModalTitle": "ビルドプリセットのインポート", + "importModalMessage": "エクスポートされたプリセットデータを貼り付けるか、バックアップファイルからインポートします。設定はデバイス固有のため影響を受けません。", + "inputLabel": "エクスポートされたプリセットデータ", + "inputPlaceholder": "{\"v\":1,\"presets\":[...]}", + "importFromFile": "ファイルからインポート", + "importFromFileTooltip": "JSONバックアップファイルからプリセットをインポート", + "foundPresets": "インポート可能なプリセットが {count} 件見つかりました", + "replaceAll": "すべて置換", + "replaceAllTooltip": "ローカルのプリセットをすべて削除して、これらをインポート", + "merge": "マージ", + "mergeTooltip": "既存のプリセットと並べて新しいプリセットを追加", + "exportedToast": "プリセットを共有しました", + "copiedToast": "プリセットをクリップボードにコピーしました", + "exportFailedToast": "プリセットのエクスポートに失敗しました", + "downloadedToast": "プリセットファイルをダウンロードしました", + "importedToast": "{count} 件のプリセットをインポートしました", + "invalidDataToast": "プリセットデータが無効です", + "invalidFileToast": "プリセットファイルが無効です" + }, "toast": { "copied": "コピーしました", "unableToCopy": "コピーできません", diff --git a/src/locales/zh.json b/src/locales/zh.json index d64733f7..074bcaab 100644 --- a/src/locales/zh.json +++ b/src/locales/zh.json @@ -45,6 +45,7 @@ "node": "节点", "view": "视图", "tree": "树", + "deviceSync": "设备同步", "lookAndFeel": "外观与触感", "application": "应用", "statistics": "统计", @@ -76,7 +77,7 @@ "pierce_resistance": "穿透抗性", "stun": "眩晕", "pierce_damage": "穿透伤害", - "counterattack_resistance": "Counter Resist", + "counterattack_resistance": "反击抗性", "critical_hit": "暴击", "skill_crit_resistance": "技能暴击抗性", "ignore_stun": "无视眩晕", @@ -95,7 +96,7 @@ "pierce_resistance": "穿透抗性", "stun": "眩晕", "pierce_damage": "穿透伤", - "counterattack_resistance": "Counter Resist", + "counterattack_resistance": "反击抗性", "critical_hit": "暴击", "skill_crit_resistance": "技能暴击抗性", "ignore_stun": "无视眩晕", @@ -108,20 +109,27 @@ "nodePrimaryActionTitle": "节点 {primaryAction} 动作", "nodePrimaryActionLeftClick": "左键点击", "nodePrimaryActionTouch": "触摸", + "nodePrimaryActionTooltip": "点击节点时选择 +1、+10 或 +阶级", "nodeLevelBehavior": "节点等级行为", "nodeLevelBehaviorSolo": "仅单项", "nodeLevelBehaviorSync": "同步血统", + "nodeLevelBehaviorTooltip": "单项：仅操作单个节点。同步：节点与血统一起操作", "showTier": "显示阶级徽章", + "showTierTooltip": "显示或隐藏每个节点上的阶级徽章", "showSkillName": "显示技能名称徽章", + "showSkillNameTooltip": "显示或隐藏每个节点上的技能名称", "haptics": "触觉反馈", + "hapticsTooltip": "设备支持时提供震动反馈", "textSize": "字体大小", - "treeZoom": "缩放", + "textSizeTooltip": "调整标签和界面的字体大小", + "treeZoom": "技能树缩放", + "treeZoomTooltip": "适应整棵树或特写放大节点", "treeZoomFitOption": "适应 ({scale})", "treeZoomCloseUpOption": "特写 ({scale})", "focusTreeInView": "聚焦技能树", "focusTreeInViewLower": "聚焦技能树", - "focusTreeInViewTooltip": "重置缩放和平移以适应所有节点", - "themeModeTooltip": "切换深色/浅色模式", + "focusTreeInViewTooltip": "重置缩放和平移以将技能树完整显示在视图中", + "themeModeTooltip": "切换深色/浅色主题", "reloadWindow": "重新加载窗口", "reloadWindowTooltip": "刷新页面并加载最新版本", "resetSettings": "重置设置", @@ -129,7 +137,7 @@ "clearAllData": "清空所有数据", "clearAllDataTooltip": "删除所有数据并重新加载应用", "previewButton": "预览", - "previewButtonTooltip": "预览可分享的链接/代码或预设构建", + "previewButtonTooltip": "预览分享链接、代码或预设构建", "shareButton": "分享" }, "contextMenu": { @@ -144,7 +152,7 @@ "nextLevelCost": "下一级消耗", "totalSpent": "累计消耗", "level": "等级", - "tier": "阶级 (Tier)", + "tier": "阶级", "max": "最高", "incrementOne": "+1", "incrementTen": "+10", @@ -221,7 +229,7 @@ "shareTooltip": "分享 {subject} 构建", "shareViaAppsTooltip": "通过已安装的应用分享", "shareTo": "分享到...", - "copyLinkTooltip": "复制带有构建数据的文件链接", + "copyLinkTooltip": "复制带有构建数据的可分享链接", "copyLink": "复制链接", "copyScreenshotTooltip": "预览并分享技能树截图", "copyScreenshot": "分享截图", @@ -274,7 +282,7 @@ "clonedBuildToast": "已克隆构建至 \"{name}\"", "clonedPreviewBuildToast": "已克隆预览构建", "loadModalTitle": "预览可分享构建", - "loadModalMessage": "输入链接或构建代码。(预览是临时的，不会影响您当前的构建。)", + "loadModalMessage": "输入链接或构建代码。（预览是临时的，不会影响您当前的构建。）", "loadModalConfirmLabel": "预览构建" }, "modal": { @@ -338,12 +346,12 @@ "custom": "自定义", "customEllipsis": "自定义...", "preset": { - "cyan": "青色 (Cyan)", - "blue": "蓝色 (Blue)", - "green": "绿色 (Green)", - "rose": "玫瑰色 (Rose)", - "amber": "琥珀色 (Amber)", - "neutral": "中性 (Neutral)" + "cyan": "青色", + "blue": "蓝色", + "green": "绿色", + "rose": "玫瑰色", + "amber": "琥珀色", + "neutral": "中性色" }, "colorNames": { "red": "红色", @@ -367,8 +375,8 @@ }, "statistics": { "noData": "暂无数据", - "header": "构建统计", - "backpackBonus": "技能奖励", + "header": "背包统计", + "backpackBonus": "技能加成", "backpackNodeLevels": "节点等级", "techCrystalsSpent": "科技水晶消耗", "total": "总计", @@ -422,13 +430,38 @@ "controlsTabInstallDescription": "在 {osName} 上安装渐进式 Web 应用 (PWA)" }, "install": { - "tooltip": "在 {osName} 上安装 {appName}", + "tooltip": "在 {osName} 上安装 {appName} 应用", "buttonLabel": "在 {osName} 上安装应用" }, + "deviceSync": { + "exportButton": "导出预设", + "exportTooltip": "通过剪贴板或分享将所有构建预设同步到其他设备", + "downloadTooltip": "下载预设作为备份文件", + "importButton": "导入预设", + "importTooltip": "从其他设备或备份文件导入构建预设", + "importModalTitle": "导入构建预设", + "importModalMessage": "粘贴导出的预设数据或从备份文件导入。设置是设备专属的，不会受到影响。", + "inputLabel": "导出的预设数据", + "inputPlaceholder": "{\"v\":1,\"presets\":[...]}", + "importFromFile": "从文件导入", + "importFromFileTooltip": "从 JSON 备份文件导入预设", + "foundPresets": "发现 {count} 个预设可导入", + "replaceAll": "全部替换", + "replaceAllTooltip": "删除所有本地预设并用导入的预设替换", + "merge": "合并", + "mergeTooltip": "在现有预设基础上添加新预设", + "exportedToast": "预设已分享", + "copiedToast": "预设已复制到剪贴板", + "exportFailedToast": "无法导出预设", + "downloadedToast": "预设文件已下载", + "importedToast": "已导入 {count} 个预设", + "invalidDataToast": "预设数据无效", + "invalidFileToast": "预设文件无效" + }, "toast": { "copied": "已复制", "unableToCopy": "无法复制", "updatingToast": "正在更新...", "updatedVersionToast": "已更新至 v{version}" } -} \ No newline at end of file +} diff --git a/test/deviceSync.test.ts b/test/deviceSync.test.ts new file mode 100644 index 00000000..dade49e8 --- /dev/null +++ b/test/deviceSync.test.ts @@ -0,0 +1,204 @@ +import { encodeBuildData } from "../src/lib/buildData/encoder.ts"; +import { + encodePresetsForSync, + decodeSyncPayload, + replaceAllPresets, + mergePresets, + SYNC_FORMAT_VERSION, + type SyncPreset, +} from "../src/lib/deviceSync.ts"; +import type { BuildPresetsData } from "../src/lib/buildPresetsStore.ts"; + +function assertEqual(actual: unknown, expected: unknown, message: string): void { + const actualJson = JSON.stringify(actual); + const expectedJson = JSON.stringify(expected); + if (actualJson !== expectedJson) { + throw new Error( + `${message}. Expected ${expectedJson}, got ${actualJson}`, + ); + } +} + +function assert(condition: boolean, message: string): void { + if (!condition) throw new Error(message); +} + +const emptyCode = encodeBuildData({ trees: [[], [], []], owned: 0 }); +const buildCode1 = encodeBuildData({ trees: [[1]], owned: 0 }); +const buildCode2 = encodeBuildData({ trees: [[2]], owned: 0 }); + +// ─── encodePresetsForSync ──────────────────────────────────────── + +{ + const data: BuildPresetsData = { + active: "a", + presets: [ + { id: "a", name: "Alpha", buildCode: buildCode1 }, + { id: "b", name: "Beta", buildCode: buildCode2 }, + ], + }; + const json = encodePresetsForSync(data); + const parsed = JSON.parse(json); + assertEqual(parsed.v, SYNC_FORMAT_VERSION, "Version should match"); + assertEqual(parsed.presets.length, 2, "Should encode both presets"); + assertEqual(parsed.presets[0].name, "Alpha", "Name preserved"); + assertEqual(parsed.presets[0].build, buildCode1, "Build code preserved"); + assert(!("id" in parsed.presets[0]), "ID should NOT be included in sync payload"); + assert(!("active" in parsed), "Active should NOT be included in sync payload"); +} + +// ─── decodeSyncPayload ─────────────────────────────────────────── + +{ + // Valid payload + const payload = JSON.stringify({ + v: 1, + presets: [ + { name: "One", build: buildCode1 }, + { name: "Two", build: buildCode2 }, + ], + }); + const result = decodeSyncPayload(payload); + assert(result !== null, "Valid payload should decode"); + assertEqual(result!.length, 2, "Should decode both presets"); + assertEqual(result![0].name, "One", "Name decoded"); + assertEqual(result![0].build, buildCode1, "Build decoded"); +} + +{ + // Invalid JSON + assertEqual(decodeSyncPayload("not json"), null, "Invalid JSON returns null"); +} + +{ + // Missing version + assertEqual( + decodeSyncPayload(JSON.stringify({ presets: [] })), + null, + "Missing version returns null", + ); +} + +{ + // Invalid build code skipped + const payload = JSON.stringify({ + v: 1, + presets: [ + { name: "Good", build: buildCode1 }, + { name: "Bad", build: "totally-invalid" }, + ], + }); + const result = decodeSyncPayload(payload); + assert(result !== null, "Should still decode valid entries"); + assertEqual(result!.length, 1, "Invalid build codes skipped"); + assertEqual(result![0].name, "Good", "Good preset kept"); +} + +{ + // Empty presets array + assertEqual( + decodeSyncPayload(JSON.stringify({ v: 1, presets: [] })), + null, + "Empty presets returns null", + ); +} + +{ + // Whitespace name normalized + const payload = JSON.stringify({ + v: 1, + presets: [{ name: " ", build: emptyCode }], + }); + const result = decodeSyncPayload(payload); + assert(result !== null, "Whitespace name should decode"); + assertEqual(result![0].name, "Build", "Whitespace name becomes 'Build'"); +} + +// ─── replaceAllPresets ─────────────────────────────────────────── + +{ + const incoming: SyncPreset[] = [ + { name: "Imported A", build: buildCode1 }, + { name: "Imported B", build: buildCode2 }, + ]; + const result = replaceAllPresets(incoming); + assertEqual(result.presets.length, 2, "Replace should have 2 presets"); + assertEqual(result.presets[0].name, "Imported A", "First preset name"); + assertEqual(result.presets[0].buildCode, buildCode1, "First preset code"); + assertEqual(result.active, result.presets[0].id, "Active = first preset"); + assert(result.presets[0].id !== result.presets[1].id, "IDs should be unique"); +} + +// ─── mergePresets ──────────────────────────────────────────────── + +{ + // Merge adds new, skips exact duplicates (same name + same code) + const local: BuildPresetsData = { + active: "loc-1", + presets: [ + { id: "loc-1", name: "Existing", buildCode: buildCode1 }, + ], + }; + const incoming: SyncPreset[] = [ + { name: "Existing", build: buildCode1 }, + { name: "New One", build: buildCode2 }, + ]; + const result = mergePresets(local, incoming); + assertEqual(result.presets.length, 2, "Should have 2 presets after merge"); + assertEqual(result.presets[0].name, "Existing", "Original kept"); + assertEqual(result.presets[0].id, "loc-1", "Original ID preserved"); + assertEqual(result.presets[1].name, "New One", "New preset added"); + assertEqual(result.active, "loc-1", "Active unchanged"); +} + +{ + // Merge renames on name collision with different code + const local: BuildPresetsData = { + active: "loc-1", + presets: [ + { id: "loc-1", name: "Build", buildCode: buildCode1 }, + ], + }; + const incoming: SyncPreset[] = [ + { name: "Build", build: buildCode2 }, + ]; + const result = mergePresets(local, incoming); + assertEqual(result.presets.length, 2, "Both presets present"); + assert( + result.presets[1].name !== "Build", + "Renamed to avoid collision: " + result.presets[1].name, + ); +} + +{ + // Merge with no new presets returns same reference + const local: BuildPresetsData = { + active: "loc-1", + presets: [ + { id: "loc-1", name: "Only", buildCode: buildCode1 }, + ], + }; + const incoming: SyncPreset[] = [ + { name: "Only", build: buildCode1 }, + ]; + const result = mergePresets(local, incoming); + assert(result === local, "No changes should return same object"); +} + +// ─── Round-trip test ───────────────────────────────────────────── + +{ + const original: BuildPresetsData = { + active: "x", + presets: [ + { id: "x", name: "Round Trip", buildCode: buildCode1 }, + { id: "y", name: "Another", buildCode: buildCode2 }, + ], + }; + const encoded = encodePresetsForSync(original); + const decoded = decodeSyncPayload(encoded); + assert(decoded !== null, "Round-trip should decode"); + assertEqual(decoded!.length, 2, "Round-trip count"); + assertEqual(decoded![0].name, "Round Trip", "Round-trip name"); + assertEqual(decoded![0].build, buildCode1, "Round-trip code"); +} diff --git a/test/index.ts b/test/index.ts index 02904e0f..5daba3cc 100644 --- a/test/index.ts +++ b/test/index.ts @@ -28,6 +28,7 @@ const TEST_FILES = [ // 4. Features (Presets & Sharing) "buildPresets.test.ts", + "deviceSync.test.ts", "shareUrl.test.ts", "shareBuild.lazy.test.ts", @@ -40,43 +41,43 @@ const TEST_FILES = [ "nodeContentMenuTierAction.test.ts", "nodeFocusStyle.test.ts", "appHotkeys.test.ts", - "shareBuildButtonComposeOpen.test.ts", - "composeFilename.test.ts", - "composeScreenshotHost.test.ts", - "composeScreenshotStaticLoadingIndicator.test.ts", - "mobileTextSizeAdjust.test.ts", - "tabLabelAutoFitStyles.test.ts", - "bottomNavTabBarLayoutGuard.test.ts", - "composeAllTabIconVisible.test.ts", - "composeScreenshotTabsAndFilename.test.ts", - "captureServiceBadgeBounds.test.ts", - "captureServiceCenteredBounds.test.ts", - "captureServiceBadgeTypographyStyles.test.ts", - "captureServiceRenderStability.test.ts", - "captureServiceTransformFallbacks.test.ts", - "sideMenuComposeScreenshotClose.test.ts", + "shareBuildButtonComposeOpen.test.ts", + "composeFilename.test.ts", + "composeScreenshotHost.test.ts", + "composeScreenshotStaticLoadingIndicator.test.ts", + "mobileTextSizeAdjust.test.ts", + "tabLabelAutoFitStyles.test.ts", + "bottomNavTabBarLayoutGuard.test.ts", + "composeAllTabIconVisible.test.ts", + "composeScreenshotTabsAndFilename.test.ts", + "captureServiceBadgeBounds.test.ts", + "captureServiceCenteredBounds.test.ts", + "captureServiceBadgeTypographyStyles.test.ts", + "captureServiceRenderStability.test.ts", + "captureServiceTransformFallbacks.test.ts", + "sideMenuComposeScreenshotClose.test.ts", "modalHostKeyboardBackdropGuard.test.ts", "colorPickerDialogKeyboardBackdropGuard.test.ts", "colorPickerDialogBackdropInteraction.test.ts", "backdropKeyboardOpenHeuristic.test.ts", - "treeZoomSetting.test.ts", - "treePinchTapCancellation.test.ts", - "treeFocusBoundsStability.test.ts", - "treeInitialFocusConsistency.test.ts", - "treeTextSizeBoundsReactivity.test.ts", - "treeLocaleBoundsReactivity.test.ts", - "treeBottomInsetRefocus.test.ts", - "treeBadgeVisibilityBoundsReactivity.test.ts", - "treeReactiveFocusGuard.test.ts", - "treeFocusViewStateReactivity.test.ts", - "nodePrimaryActionSetting.test.ts", + "treeZoomSetting.test.ts", + "treePinchTapCancellation.test.ts", + "treeFocusBoundsStability.test.ts", + "treeInitialFocusConsistency.test.ts", + "treeTextSizeBoundsReactivity.test.ts", + "treeLocaleBoundsReactivity.test.ts", + "treeBottomInsetRefocus.test.ts", + "treeBadgeVisibilityBoundsReactivity.test.ts", + "treeReactiveFocusGuard.test.ts", + "treeFocusViewStateReactivity.test.ts", + "nodePrimaryActionSetting.test.ts", "nodeLevelBehaviorSetting.test.ts", "showTierSetting.test.ts", "treeLinkParentLevelColor.test.ts", - "fullscreenModalBackground.test.ts", - "imageViewerLayout.test.ts", - "imageViewerClampAtFit.test.ts", - "imageViewerResizeReset.test.ts", + "fullscreenModalBackground.test.ts", + "imageViewerLayout.test.ts", + "imageViewerClampAtFit.test.ts", + "imageViewerResizeReset.test.ts", "imageViewerInteractions.test.ts", "serviceWorkerAutoUpdateModule.test.ts", "serviceWorkerUpdateToast.test.ts",