diff --git a/perler-lab/src/App.tsx b/perler-lab/src/App.tsx index 9417067..ed6ca83 100644 --- a/perler-lab/src/App.tsx +++ b/perler-lab/src/App.tsx @@ -5,6 +5,7 @@ import ShowcasePage from './pages/ShowcasePage'; import LibraryPage from './pages/LibraryPage'; import HelpPage from './pages/HelpPage'; import WorkDetailPage from './pages/WorkDetailPage'; +import MyBeadsPage from './pages/MyBeadsPage'; import PrivacyPolicyPage from './pages/legal/PrivacyPolicyPage'; import TermsOfServicePage from './pages/legal/TermsOfServicePage'; import AboutPage from './pages/legal/AboutPage'; @@ -20,6 +21,7 @@ import EditToolbar from './components/EditToolbar'; import RedeemModal from './components/RedeemModal'; import AgencyModal from './components/AgencyModal'; import OrderModal from './components/OrderModal'; +import BeadSettlementModal from './components/BeadSettlementModal'; import { loadImageFromFile, usePattern, @@ -38,8 +40,13 @@ import { import { buildExportCanvas, downloadCanvas } from './lib/drawPattern'; import { consumeCode, redeemCode } from './lib/api'; import { decodePattern } from './lib/share-codec'; -import { BRANDS } from './lib/brand-palettes'; -import type { ProcessResult } from './lib/image-processor'; +import { BRANDS, getBrandPalette, STANDARD_COLORS } from './lib/brand-palettes'; +import { COLOR_CHART_BRANDS } from './lib/color-chart-data'; +import type { ProcessResult, ProcessedCell, ProcessedPaletteEntry } from './lib/image-processor'; +import type { BeadUsage } from './lib/bead-inventory'; +import { useBeadInventory } from './lib/useBeadInventory'; +import { readDeductMode } from './lib/bead-deduct-mode'; +import './pages/beads.css'; import ShareButton from './components/ShareButton'; import { useT } from './i18n'; @@ -74,6 +81,102 @@ interface SharedPattern { brandId: string; } +/** 豆仓结算弹窗的状态:打开时记录结算后续动作(下载 / 生成)。 */ +interface SettleState { + /** 结算确认后的后续动作(下载模式=继续下载;生成模式=空操作)。 */ + followUp: () => void; +} + +/** 换色记录:将图纸中 old 色号替换为 new 色号。 */ +interface Replacement { + old: string; + next: string; +} + +/** + * 色号 → { hex, rgb, lab? } 解析: + * 1. 优先查品牌色板(getBrandPalette,覆盖 MARD/COCO/漫漫/盼盼/咪小窝 五品牌); + * 2. 回退到 291 标准色中间层(STANDARD_COLORS); + * 3. 最后回退到色号表(COLOR_CHART_BRANDS,覆盖 Artkal-C/Perler/Hama/Pyssla/Nabbi)。 + */ +function resolveReplacementColor( + brandId: string, + code: string, +): { hex: string; rgb: readonly [number, number, number]; lab: readonly [number, number, number] } | null { + const fromBrand = getBrandPalette(brandId).find((c) => c.code === code); + if (fromBrand) { + return { hex: fromBrand.hex, rgb: fromBrand.rgb, lab: fromBrand.lab }; + } + for (const standard of STANDARD_COLORS) { + if (standard.brands[brandId] === code) { + return { hex: standard.hex, rgb: standard.rgb, lab: standard.lab }; + } + } + for (const chartBrand of COLOR_CHART_BRANDS) { + const found = chartBrand.colors.find((c) => c.code === code); + if (found) { + return { hex: found.hex, rgb: found.rgb, lab: [0, 0, 0] as const }; + } + } + return null; +} + +/** + * 将 result 中的 oldCode 全部替换为 nextCode,并重算 palette。 + * newCode 的 rgb/lab 取自色板;palette 按新 code 合并用量。 + */ +function applyReplacement( + brandId: string, + result: ProcessResult, + oldCode: string, + nextCode: string, +): ProcessResult { + if (oldCode === nextCode) return result; + const colorInfo = resolveReplacementColor(brandId, nextCode); + if (!colorInfo) return result; + + const grid: ProcessedCell[] = result.grid.map((cell) => { + if (cell.empty || cell.code !== oldCode) return cell; + return { + ...cell, + code: nextCode, + rgb: colorInfo.rgb, + lab: Array.isArray(cell.lab) ? [...colorInfo.lab] : colorInfo.lab, + }; + }); + + const countByCode = new Map(); + for (const cell of grid) { + if (cell.empty) continue; + const c = cell.code; + countByCode.set(c, (countByCode.get(c) ?? 0) + 1); + } + +const palette: ProcessedPaletteEntry[] = [...countByCode.entries()] + .map(([code, count]) => { + // 优先取原 palette 里的 hex/rgb,避免 fallback 色无数据; + // 被替换进来的新色用 colorInfo 的 hex/rgb。 + const existing = result.palette.find((p) => p.code === code); + const isReplacement = code === nextCode; + const hex = isReplacement ? colorInfo.hex : (existing?.hex ?? '#fff'); + const rgb = isReplacement ? colorInfo.rgb : (existing?.rgb ?? colorInfo.rgb); + return { code, hex, rgb, count }; + }) + .sort((a, b) => b.count - a.count); + + return { + grid, + palette, + totalBeads: grid.filter((c) => !c.empty).length, + }; +} + +/** 图纸 → 豆仓结算用量列表(palette 映射 {code, count})。 */ +function paletteToUsage(result: ProcessResult | null): BeadUsage[] { + if (!result) return []; + return result.palette.map((p) => ({ code: p.code, count: p.count })); +} + /** Homepage: NAV → HERO → DOWNLOAD PASS → 工作区三栏 → FOOTER. */ function HomePage() { const { t } = useT(); @@ -85,6 +188,15 @@ function HomePage() { const [uploadError, setUploadError] = useState(null); const [modal, setModal] = useState(null); + // 豆仓结算拦击:settle 非空时显示结算弹窗(下载/生成模式共用)。 + const [settle, setSettle] = useState(null); + // 换色记录(作用于 editedResult,预览/导出/清单自动跟随)。 + const [replacements, setReplacements] = useState([]); + // 换色成功提示。 + const [replaceToast, setReplaceToast] = useState(null); + // 豆仓库存(consume / ensure 供结算确认与补货使用)。 + const beadInventory = useBeadInventory(); + // T-067 分享:?share= 分享码解码出的图纸(绕过上传直接渲染)。 const [sharedPattern, setSharedPattern] = useState(null); @@ -125,6 +237,21 @@ function HomePage() { const effectiveResult = sharedPattern !== null ? sharedPattern.result : result; const effectiveSize = sharedPattern !== null ? sharedPattern.size : settings.gridSize; + // 生成模式拦截:result 非空且非首次变化时弹结算弹窗。 + const prevResultRef = useRef(null); + useEffect(() => { + if (readDeductMode() !== 'generate') return; + const r = effectiveResult; + if (!r) return; + if (prevResultRef.current === null) { + prevResultRef.current = r; + return; + } + if (prevResultRef.current === r) return; + prevResultRef.current = r; + setSettle({ followUp: () => undefined }); + }, [effectiveResult]); + // 新的管线结果到达时,重置编辑状态(历史不跨图纸保留)。 useEffect(() => { history.clear(); @@ -133,11 +260,16 @@ function HomePage() { // 预览/清单/下载统一使用「编辑后的网格」重建的 ProcessResult; // 结果尚未同步进 state 的首帧直接由原始 result 派生,避免闪烁。 + // 换色记录在重建后按序应用,预览/导出/清单自动跟随。 const editedResult = useMemo(() => { if (!effectiveResult) return null; const base = gridState ?? resultToGridState(effectiveResult, effectiveSize); - return gridStateToProcessResult(base); - }, [gridState, effectiveResult, effectiveSize]); + let rebuilt = gridStateToProcessResult(base); + for (const rep of replacements) { + rebuilt = applyReplacement(settings.brandId, rebuilt, rep.old, rep.next); + } + return rebuilt; + }, [gridState, effectiveResult, effectiveSize, replacements, settings.brandId]); // Revoke object URLs when the source is replaced. useEffect(() => { @@ -176,26 +308,46 @@ function HomePage() { setRunId((n) => n + 1); }, []); - const handleDownload = useCallback(async () => { + /** 实际的下载动作(结算弹窗确认/补货后调用)。 */ +const performDownload = useCallback( + async (result: ProcessResult, baseName: string) => { + try { + await consumeCode({ + code: redeemedCode!, + fileName: `${baseName}.png`, + downloadGrant: '', + }); + setDownloadError(null); + const canvas = buildExportCanvas(result, settings.gridSize, baseName, settings.brandId); + downloadCanvas( + canvas, + `${baseName}-${settings.gridSize}x${settings.gridSize}-${settings.brandId}${t('app.downloadSuffix')}.png`, + ); + } catch (err) { + setDownloadError(err instanceof Error ? err.message : t('app.downloadFail')); + } + }, + [settings.gridSize, settings.brandId, redeemedCode, t], + ); + +const handleDownload = useCallback(async () => { if (!editedResult || !source || !redeemedCode) return; const baseName = source.name.replace(/\.[^.]+$/, '') || t('app.downloadBaseName'); - try { - // 下载消耗 1 次权益(首次免费),成功后再触发本地图纸导出 - await consumeCode({ - code: redeemedCode, - fileName: `${baseName}.png`, - downloadGrant: '', + + // 扣豆模式拦截:若 deduct-mode === 'download',弹结算弹窗 + if (readDeductMode() === 'download') { + setSettle({ + followUp: () => { + void (async () => { + await performDownload(editedResult, baseName); + })(); + }, }); - setDownloadError(null); - const canvas = buildExportCanvas(editedResult, settings.gridSize, baseName, settings.brandId); - downloadCanvas( - canvas, - `${baseName}-${settings.gridSize}x${settings.gridSize}-${settings.brandId}${t('app.downloadSuffix')}.png`, - ); - } catch (err) { - setDownloadError(err instanceof Error ? err.message : t('app.downloadFail')); + return; } - }, [editedResult, source, settings.gridSize, settings.brandId, redeemedCode, t]); + + await performDownload(editedResult, baseName); + }, [editedResult, source, redeemedCode, settings.gridSize, settings.brandId, t, performDownload]); // 编辑工具:在历史中记录新状态后再应用变换(撤销/重做走历史栈)。 const applyEdit = useCallback( @@ -218,6 +370,34 @@ function HomePage() { if (next) setGridState(next); }, [history]); + /** 换色:记录 replacement,editedResult 自动重算(预览/导出/清单跟随)。 */ + const handleReplace = useCallback( + (oldCode: string, newCode: string) => { + setReplacements((prev) => [...prev, { old: oldCode, next: newCode }]); + setReplaceToast(t('beads.replace.done', { oldCode, newCode })); + window.setTimeout(() => setReplaceToast(null), 2500); + }, + [t], + ); + + /** 结算确认:从豆仓扣豆(忽略缺口继续),然后执行后续动作(下载/生成)。 */ + const handleSettleConfirm = useCallback(() => { + if (settle) { + beadInventory.consume(paletteToUsage(editedResult)); + settle.followUp(); + } + setSettle(null); + }, [settle, editedResult, beadInventory]); + + /** 一键补货:补齐缺口后再执行后续动作。 */ + const handleSettleRestock = useCallback(() => { + if (settle) { + beadInventory.ensure(paletteToUsage(editedResult)); + settle.followUp(); + } + setSettle(null); + }, [settle, editedResult, beadInventory]); + const beadCount = effectiveResult?.totalBeads ?? 0; const colorCount = effectiveResult?.palette.length ?? 0; const orderPlan = modal?.kind === 'order' ? modal.plan : null; @@ -317,6 +497,30 @@ function HomePage() { }} /> )} + + {/* 豆仓结算弹窗(下载/生成拦截共用) */} + {settle && editedResult && ( + setSettle(null)} + onConfirm={handleSettleConfirm} + onRestock={handleSettleRestock} + onReplace={handleReplace} + /> + )} + + {/* 换色成功提示 */} + {replaceToast && ( +
+ {replaceToast} +
+ )} ); } @@ -359,6 +563,9 @@ export default function App() { if (path === '/help' || path.startsWith('/help/')) { return ; } + if (path === '/my-beads' || path.startsWith('/my-beads/')) { + return ; + } if (path === '/privacy-policy' || path.startsWith('/privacy-policy/')) { return ; } diff --git a/perler-lab/src/components/LangSwitcher.tsx b/perler-lab/src/components/LangSwitcher.tsx index ddc0d22..2cd5056 100644 --- a/perler-lab/src/components/LangSwitcher.tsx +++ b/perler-lab/src/components/LangSwitcher.tsx @@ -1,31 +1,35 @@ -import { useT } from '../i18n'; +import { useT, type Locale } from '../i18n'; interface LangSwitcherProps { /** CSS class prefix: 'nav-lang' (homepage nav) or 'chibi-nav-lang' (AI studio nav). */ base?: string; } -/** 语言切换器(zh/EN):按钮文案为通用符号,两种语言下均可自解释。 */ +const LOCALE_BUTTONS: readonly { target: Locale; label: string }[] = [ + { target: 'zh-CN', label: '简体' }, + { target: 'zh-TW', label: '繁體' }, + { target: 'en', label: 'EN' }, +]; + +/** 語言切換器(简/繁/EN):按鈕文案為通用符號,三種語言下均可自解釋。 */ export default function LangSwitcher({ base = 'nav-lang' }: LangSwitcherProps) { const { locale, setLocale, t } = useT(); const btn = `${base}-btn`; const active = `${btn}--active`; - const renderButton = (target: 'zh-CN' | 'en', label: string): React.ReactNode => ( - - ); - return (
- {renderButton('zh-CN', '中文')} - {renderButton('en', 'EN')} + {LOCALE_BUTTONS.map((b) => ( + + ))}
); } diff --git a/perler-lab/src/components/Nav.tsx b/perler-lab/src/components/Nav.tsx index 3395707..d068bea 100644 --- a/perler-lab/src/components/Nav.tsx +++ b/perler-lab/src/components/Nav.tsx @@ -29,6 +29,9 @@ export default function Nav({ onAgencyClick }: NavProps) { {t('nav.colorChart')} + + {t('nav.beads')} +
diff --git a/perler-lab/src/components/SubNav.tsx b/perler-lab/src/components/SubNav.tsx index ac605b3..a8e9f0a 100644 --- a/perler-lab/src/components/SubNav.tsx +++ b/perler-lab/src/components/SubNav.tsx @@ -7,6 +7,7 @@ export type SubNavActive = | 'showcase' | 'library' | 'help' + | 'beads' /** 合规内容页(/privacy-policy /terms-of-service /about /contact):不在主导航中高亮。 */ | 'legal'; @@ -17,7 +18,7 @@ interface SubNavProps { interface LinkItem { key: SubNavActive; href: string; - labelKey: 'nav.home' | 'nav.toPattern' | 'nav.chibi' | 'nav.showcase' | 'nav.library' | 'nav.help'; + labelKey: 'nav.home' | 'nav.toPattern' | 'nav.chibi' | 'nav.showcase' | 'nav.library' | 'nav.help' | 'nav.beads'; pro?: boolean; } @@ -27,6 +28,7 @@ const LINKS: readonly LinkItem[] = [ { key: 'showcase', href: '/showcase', labelKey: 'nav.showcase' }, { key: 'library', href: '/library', labelKey: 'nav.library' }, { key: 'help', href: '/help', labelKey: 'nav.help' }, + { key: 'beads', href: '/my-beads', labelKey: 'nav.beads' }, ]; /** diff --git a/perler-lab/src/i18n/__tests__/i18n.test.ts b/perler-lab/src/i18n/__tests__/i18n.test.ts index 905e5b6..d92d03d 100644 --- a/perler-lab/src/i18n/__tests__/i18n.test.ts +++ b/perler-lab/src/i18n/__tests__/i18n.test.ts @@ -103,13 +103,14 @@ describe('resolveLocale / detectLocale', () => { it('invalid stored values are ignored (falls through to detection)', () => { expect(resolveLocale('fr', 'en-US')).toBe('en'); - expect(resolveLocale('fr', 'zh-TW')).toBe('zh-CN'); + expect(resolveLocale('fr', 'zh-TW')).toBe('zh-TW'); }); - it('detects zh-* navigator languages as zh-CN', () => { + it('detects zh-* navigator languages as zh-CN (zh-TW/zh-HK → zh-TW)', () => { expect(resolveLocale(null, 'zh-CN')).toBe('zh-CN'); expect(resolveLocale(null, 'zh')).toBe('zh-CN'); - expect(resolveLocale(null, 'zh-TW')).toBe('zh-CN'); + expect(resolveLocale(null, 'zh-TW')).toBe('zh-TW'); + expect(resolveLocale(null, 'zh-HK')).toBe('zh-TW'); }); it('any non-Chinese language falls back to en', () => { diff --git a/perler-lab/src/i18n/index.tsx b/perler-lab/src/i18n/index.tsx index 3606677..4ea5e9a 100644 --- a/perler-lab/src/i18n/index.tsx +++ b/perler-lab/src/i18n/index.tsx @@ -20,6 +20,7 @@ import { } from 'react'; import { zhCN, type MessageKey, type Messages } from './messages/zh-CN'; import { en } from './messages/en'; +import { zhTW } from './messages/zh-TW'; import { DEFAULT_LOCALE, LOCALE_STORAGE_KEY, @@ -40,6 +41,7 @@ export { export const MESSAGES: Record = { 'zh-CN': zhCN, + 'zh-TW': zhTW, en, }; diff --git a/perler-lab/src/i18n/locale.ts b/perler-lab/src/i18n/locale.ts index 45f8a8c..3240aae 100644 --- a/perler-lab/src/i18n/locale.ts +++ b/perler-lab/src/i18n/locale.ts @@ -1,14 +1,14 @@ /** * Locale registry for PERLER LAB. * - * Only two locales are fully translated (zh-CN, en); any other browser + * Three locales are fully translated (zh-CN, zh-TW, en); any other browser * language falls back to English via `resolveLocale`. */ -export type Locale = 'zh-CN' | 'en'; +export type Locale = 'zh-CN' | 'zh-TW' | 'en'; /** All supported locales (order = display order in the language switcher). */ -export const LOCALES: readonly Locale[] = ['zh-CN', 'en'] as const; +export const LOCALES: readonly Locale[] = ['zh-CN', 'zh-TW', 'en'] as const; /** Fallback locale used when nothing is stored/detected. */ export const DEFAULT_LOCALE: Locale = 'zh-CN'; @@ -32,6 +32,9 @@ export function resolveLocale(stored: string | null, navLanguage: string | null) } if (navLanguage !== null) { const base = navLanguage.toLowerCase(); + if (base === 'zh-tw' || base === 'zh-hk' || base === 'zh-mo') { + return 'zh-TW'; + } if (base === 'zh' || base.startsWith('zh-')) { return 'zh-CN'; } diff --git a/perler-lab/src/i18n/messages/en.ts b/perler-lab/src/i18n/messages/en.ts index 4a28db3..cdfc011 100644 --- a/perler-lab/src/i18n/messages/en.ts +++ b/perler-lab/src/i18n/messages/en.ts @@ -496,4 +496,40 @@ export const en: Messages = { 'detail.error.load': 'Failed to load, please try again later', 'detail.error.retry': 'Retry', 'detail.back.showcase': '← Back to Showcase', + + /* ── MyBeadsPage virtual bead warehouse ── */ + 'nav.beads': 'My Beads', + 'beads.pageTitle': 'My Beads', + 'beads.pageDesc': 'Manage your bead inventory — auto-settle when generating patterns', + 'beads.empty.title': 'No beads yet', + 'beads.empty.desc': 'Add your bead inventory first, then patterns will auto-settle against your stock', + 'beads.empty.addBtn': 'Add Beads', + 'beads.empty.restockBtn': 'Restock from Pattern', + 'beads.stats.colors': 'Colors', + 'beads.stats.total': 'Total Beads', + 'beads.stats.outOfStock': 'Out of Stock', + 'beads.bottle.add': 'Restock', + 'beads.bottle.count': '{count} beads', + 'beads.bottle.outOfStock': 'Out of Stock', + 'beads.bottle.low': 'Low Stock', + 'beads.settings.title': 'Deduct Mode', + 'beads.settings.modeDownload': 'Deduct on download', + 'beads.settings.modeGenerate': 'Deduct on generate', + 'beads.settings.desc': 'Choose when to automatically deduct from your bead inventory', + 'beads.modal.title': 'Bead Settlement', + 'beads.modal.needed': 'Needed', + 'beads.modal.stock': 'Stock', + 'beads.modal.missing': 'Short', + 'beads.modal.ok': 'Sufficient', + 'beads.modal.restock': 'Restock All', + 'beads.modal.cancel': 'Cancel', + 'beads.modal.shortageWarn': 'Insufficient stock — please restock or replace colors', + 'beads.modal.confirmConsume': 'Confirm Deduct', + 'beads.replace.title': 'Replace Color', + 'beads.replace.pick': 'Pick a replacement color', + 'beads.replace.done': 'Replaced: {oldCode} → {newCode}', + 'beads.add.title': 'Add Beads', + 'beads.add.code': 'Code', + 'beads.add.count': 'Count', + 'beads.add.submit': 'Add', }; diff --git a/perler-lab/src/i18n/messages/zh-CN.ts b/perler-lab/src/i18n/messages/zh-CN.ts index 5d8dfa2..c097a55 100644 --- a/perler-lab/src/i18n/messages/zh-CN.ts +++ b/perler-lab/src/i18n/messages/zh-CN.ts @@ -484,6 +484,42 @@ export const zhCN = { 'detail.error.load': '加载失败,请稍后重试', 'detail.error.retry': '重试', 'detail.back.showcase': '← 返回作品展示', + + /* ── MyBeadsPage 拼豆虚拟豆仓 ── */ + 'nav.beads': '我的豆仓', + 'beads.pageTitle': '我的豆仓', + 'beads.pageDesc': '管理你的拼豆库存,生成图纸时自动结算', + 'beads.empty.title': '还没有豆子', + 'beads.empty.desc': '先添加你手头已有的拼豆,生成图纸后才能自动结算库存', + 'beads.empty.addBtn': '添加豆子', + 'beads.empty.restockBtn': '按图纸补货', + 'beads.stats.colors': '色号数', + 'beads.stats.total': '总颗数', + 'beads.stats.outOfStock': '缺货色号', + 'beads.bottle.add': '补货', + 'beads.bottle.count': '{count} 颗', + 'beads.bottle.outOfStock': '缺货', + 'beads.bottle.low': '低库存', + 'beads.settings.title': '扣豆模式', + 'beads.settings.modeDownload': '下载图纸时扣豆', + 'beads.settings.modeGenerate': '生成图纸时扣豆', + 'beads.settings.desc': '选择何时自动从豆仓扣减库存', + 'beads.modal.title': '豆仓结算', + 'beads.modal.needed': '需要', + 'beads.modal.stock': '库存', + 'beads.modal.missing': '差', + 'beads.modal.ok': '充足', + 'beads.modal.restock': '一键补货', + 'beads.modal.cancel': '取消', + 'beads.modal.shortageWarn': '库存不足,请补货或换色', + 'beads.modal.confirmConsume': '确认扣豆', + 'beads.replace.title': '换色选择', + 'beads.replace.pick': '选择一个颜色替换', + 'beads.replace.done': '已替换:{oldCode} → {newCode}', + 'beads.add.title': '添加豆子', + 'beads.add.code': '色号', + 'beads.add.count': '数量', + 'beads.add.submit': '添加', } as const; export type Messages = { [K in keyof typeof zhCN]: string }; diff --git a/perler-lab/src/i18n/messages/zh-TW.ts b/perler-lab/src/i18n/messages/zh-TW.ts new file mode 100644 index 0000000..d5c1098 --- /dev/null +++ b/perler-lab/src/i18n/messages/zh-TW.ts @@ -0,0 +1,523 @@ +/** + * PERLER LAB — 中文(繁體)UI 文案。 + * + * 與 zh-CN 完全一致的鍵集合(`Messages` 類型約束),保留體系化命名。 + * 參數插值:模板中使用 `{name}`,由 translate() 以參數替換。 + */ + +import type { Messages } from './zh-CN'; + +export const zhTW: Messages = { + /* ── Nav ── */ + 'nav.toPattern': '圖片轉拼豆', + 'nav.chibi': 'AI拼豆專區', + 'nav.agency': '代理合作', + 'nav.status': '普通預覽免費 · AI生成按次付費', + 'nav.lang': '語言', + 'nav.home': '首頁', + 'nav.showcase': '作品展示', + 'nav.library': '圖紙庫', + 'nav.colorChart': '色號表', + 'nav.help': '幫助', + + /* ── Hero ── */ + 'hero.title.prefix': '把喜歡的圖片,', + 'hero.title.accent': '變成一顆顆拼豆。', + 'hero.sub': '免費上傳、生成和調整圖紙,滿意後使用兌換碼下載完整高清圖紙與用豆清單。', + 'hero.stat.beads': '顆拼豆', + 'hero.stat.colors': '種顏色', + + /* ── PassSection(權益套餐) ── */ + 'pass.aria': '權益套餐', + 'pass.title': 'AI生成權益', + 'pass.sub': '購買 / 兌換後解鎖完整圖紙與備料清單', + 'pass.badge': '推薦', + 'pass.cta': '購買 / 兌換 →', + 'pass.benefit': '成功生成 1 張作品,消耗 1 次 · 該作品轉拼豆圖紙及首次高清下載免費', + 'pass.plan.basic.name': '體驗包', + 'pass.plan.basic.count': '3 次', + 'pass.plan.basic.desc': '適合先體驗 AI 拼豆效果', + 'pass.plan.standard.name': '常用包', + 'pass.plan.standard.count': '10 次', + 'pass.plan.standard.desc': '適合個人多次創作(推薦)', + 'pass.plan.pro.name': '進階包', + 'pass.plan.pro.count': '30 次', + 'pass.plan.pro.desc': '適合接單與持續出圖', + + /* ── ControlsPanel(01 生成設置) ── */ + 'ctrl.aria': '01 生成設置', + 'ctrl.title': '生成設置', + 'ctrl.upload.aria': '上傳一張圖片', + 'ctrl.upload.title': '上傳一張圖片', + 'ctrl.upload.sub': '支援 JPG、PNG、WEBP', + 'ctrl.uploaded': '已上傳', + 'ctrl.reset': '重置', + 'ctrl.brand': '品牌色板', + 'ctrl.brand.hint': '圖紙色號與備料清單將按所選品牌編碼', + 'ctrl.grid': '圖紙尺寸', + 'ctrl.grid.hint': '成品約 {size} × {size} cm(按 5mm 豆計算)', + 'ctrl.colors': '最大顏色數', + 'ctrl.colors.hint': '顏色越多,還原度越高;預設推薦 24 色', + 'ctrl.removeBg': '一鍵去除背景', + 'ctrl.removeBg.desc': '只保留人物或主體,不計算背景豆', + 'ctrl.showGrid': '顯示輔助網格', + 'ctrl.showGrid.desc': '方便逐格定位拼豆', + 'ctrl.processing': '圖片處理中…', + 'ctrl.regen': '↻ 重新生成圖紙', + + /* ── PreviewPanel(02 即時預覽) ── */ + 'prev.aria': '02 即時預覽', + 'prev.title': '即時預覽', + 'prev.ruler': '每5格加粗 · 每10格標號', + 'prev.unnamed': '未命名', + 'prev.canvas.aria': '拼豆圖紙預覽', + 'prev.empty': '上傳圖片後,這裡會即時顯示拼豆圖紙。', + 'prev.empty.ruler': '標尺:每5格加粗 · 每10格標號', + 'prev.beads': '實際使用 {count} 顆', + 'prev.download': '↓ 兌換後下載完整圖紙', + 'prev.download.note': '首次下載免費 / 下載普通圖紙 · 消耗 1 次', + 'prev.sharedName': '來自分享的圖紙', + 'prev.sharedBanner': '來自分享的圖紙 · 重新上傳圖片可生成新圖紙', + + /* ── InventoryPanel(03 備料清單) ── */ + 'inv.aria': '03 {brand} 備料清單', + 'inv.title': '{brand} 備料清單', + 'inv.unlocked': '已解鎖', + 'inv.locked': '🔒 受保護', + 'inv.total': '實際總顆數', + 'inv.colors': '使用顏色', + 'inv.perColor': '{count} 顆', + 'inv.empty': '上傳圖片並生成圖紙後,這裡會顯示 {brand} 色號清單。', + 'inv.extra': '建議多備 10% · 約', + 'inv.beads': ' 顆', + 'inv.ghost.hidden': '完整色號已隱藏', + 'inv.lock.title': '完整備料清單已鎖定', + 'inv.lock.desc': '兌換後可查看全部 {brand} 色號、每色顆數、總顆數及 10% 備豆建議', + 'inv.unlock': '輸入兌換碼解鎖', + + /* ── 彈窗通用 / RedeemModal ── */ + 'modal.close': '關閉', + 'modal.redeem.aria': '輸入兌換碼', + 'modal.redeem.title': '輸入兌換碼', + 'modal.redeem.placeholder': '請輸入兌換碼', + 'modal.redeem.empty': '兌換失敗 / 兌換碼不存在,請檢查後重試', + 'modal.redeem.fail': '兌換失敗,請稍後重試', + 'modal.redeem.processing': '兌換中…', + 'modal.redeem.submit': '兌換', + + /* ── OrderModal ── */ + 'modal.order.aria': '購買 AI 生成次數', + 'modal.order.title': '購買 AI 生成次數', + 'modal.order.amountDue': '應付金額 · ¥{price} · {count} 生成', + 'modal.order.method.wechat': '微信收款碼', + 'modal.order.method.alipay': '支付寶收款碼', + 'modal.order.goPay': '去支付', + 'modal.order.creating': '下單中…', + 'modal.order.note': '截圖或長按儲存收款碼,再開啟對應支付應用掃碼支付 · 付款金額請與上方一致', + 'modal.order.no': '訂單號', + 'modal.order.amount': '應付金額', + 'modal.order.payHint': '請使用{method}掃碼支付(或長按識別收款碼),付款金額請與上方一致', + 'modal.order.payUrl': '支付連結:{url}', + 'modal.order.qr': ' · 收款碼:{qr}', + 'modal.order.simulate': '模擬支付完成', + 'modal.order.confirming': '確認中…', + 'modal.order.simNote': '模擬環境:點擊後直接標記訂單已支付並發放兌換碼', + 'modal.order.success': '支付成功 · 權益兌換碼', + 'modal.order.redeemed': '已自動兌換成功,AI 生成權益已到帳', + 'modal.order.redeemFailed': '自動兌換失敗,可複製兌換碼後在「輸入兌換碼」中手動兌換', + 'modal.order.done': '完成', + 'modal.order.createFail': '下單失敗,請稍後重試', + 'modal.order.payFail': '支付確認失敗,請稍後重試', + 'modal.order.methodLabel.wechat': '微信', + 'modal.order.methodLabel.alipay': '支付寶', + + /* ── AgencyModal ── */ + 'agency.aria': '代理合作', + 'agency.title': '代理合作', + 'agency.plan.basic.name': '初級代理', + 'agency.plan.basic.count': '200 次', + 'agency.plan.standard.name': '標準代理', + 'agency.plan.standard.count': '500 次', + 'agency.plan.core.name': '核心代理', + 'agency.plan.core.count': '1000 次', + + /* ── EditToolbar ── */ + 'edit.aria': '編輯工具', + 'edit.undo': '撤銷', + 'edit.undo.title': '撤銷上一步', + 'edit.redo': '重做', + 'edit.redo.title': '重做下一步', + 'edit.rotate': '旋轉90°', + 'edit.rotate.title': '順時針旋轉 90°', + 'edit.mirrorV': '左右鏡像', + 'edit.mirrorV.title': '左右鏡像(左右對調)', + 'edit.mirrorH': '上下鏡像', + 'edit.mirrorH.title': '上下鏡像(上下對調)', + 'edit.flip': '對角翻轉', + 'edit.flip.title': '對角翻轉(主對角線對稱,可做對稱圖紙)', + + /* ── Footer ── */ + 'footer.slogan': 'PERLER LAB · 讓每一顆顏色都有位置', + 'footer.note': '圖紙僅供個人手作參考', + + /* ── App(首頁外殼 / 下載 / 錯誤兜底) ── */ + 'app.title': 'PERLER LAB · 拼豆圖紙產生器', + 'app.mobileCta': '購買 / 兌換 →', + 'app.uploadFail': '圖片讀取失敗,請換一張重試', + 'app.downloadFail': '下載失敗,請稍後重試', + 'app.downloadBaseName': '拼豆圖紙', + 'app.downloadSuffix': '拼豆圖紙', + + /* ── ShareButton(T-067 分享) ── */ + 'share.button': '分享', + 'share.title': '拼豆圖紙分享', + 'share.text': '看看這張拼豆圖紙!', + 'share.copied': '分享連結已複製', + 'share.failed': '分享失敗,請稍後重試', + + /* ── ChibiPage(AI 拼豆專區) ── */ + 'chibi.nav.back': '← 普通拼豆', + 'chibi.nav.badge': '每次生成消耗 1 次權益', + 'chibi.hero.title.prefix': '先選大類,再定細節,', + 'chibi.hero.title.accent': '產生結果先儲存。', + 'chibi.hero.sub': + '每次 AI 成功生成扣 1 次;該作品轉成正式拼豆圖紙並首次下載免費。只有重新生成新作品才再次扣費。', + 'chibi.card.aria': '拼豆生成設定', + 'chibi.step.category': '選擇拼豆大類', + 'chibi.tabs.aria': '拼豆大類', + 'chibi.compare.original': '原圖', + 'chibi.compare.result': '像素拼豆效果', + 'chibi.subtype.title': '細分選擇 · 同一種類下不同畫風', + 'chibi.step.grid': '圖紙格數', + 'chibi.step.colors': '最大顏色數', + 'chibi.step.colors.note': '顏色越多還原度越高', + 'chibi.step.composition': '主體構圖', + 'chibi.step.tags': '細節提示詞', + 'chibi.tags.max': '最多選 {max} 項', + 'chibi.tags.selected': '已選 {selected}/{max}', + 'chibi.recommend': '推薦', + 'chibi.grid.simple': '簡單', + 'chibi.grid.recommended': '推薦', + 'chibi.grid.fine': '精細', + 'chibi.grid.hd': '高清', + 'chibi.colors.save': '省豆', + 'chibi.colors.balanced': '均衡', + 'chibi.colors.fine': '細膩', + 'chibi.colors.high': '高還原', + 'chibi.composition.closeup': '主體特寫', + 'chibi.composition.half': '半幅構圖', + 'chibi.composition.full': '完整構圖', + 'chibi.prompt.label': '補充描述(選填)', + 'chibi.prompt.placeholder': '想保留的細節、不想要的元素…', + 'chibi.reference.label': '上傳風格示例圖(可選)', + 'chibi.reference.title': '上傳風格示例圖', + 'chibi.reference.hint': '不會照搬示例主體', + 'chibi.confirm.aria': '生成前確認', + 'chibi.confirm.title': '生成前確認', + 'chibi.sample': '範例', + 'chibi.sample.desc': '預設像素效果', + 'chibi.spec.category': '類別', + 'chibi.spec.subtype': '細分', + 'chibi.spec.grid': '圖紙', + 'chibi.spec.beads': '預計顆數', + 'chibi.spec.beads.value': '約 {count} 顆', + 'chibi.upload.original.title': '上傳需要轉換的原圖', + 'chibi.upload.original.hint': '主體清楚、光線自然效果更好 · 不超過 12MB', + 'chibi.payNote.title': 'AI 生成屬於付費功能。', + 'chibi.payNote.body': '成功生成扣 1 次;本作品轉圖紙和首次下載免費,失敗不扣。', + 'chibi.cta.generating': 'AI 生成中…', + 'chibi.cta.generate': '生成 →', + 'chibi.cta.redeemFirst': '兌換後生成 →', + 'chibi.codeLink': '輸入兌換碼', + 'chibi.result.aria': '生成結果', + 'chibi.result.title': '生成結果', + 'chibi.result.alt': 'AI 拼豆生成結果', + 'chibi.result.withGrant': '圖紙已生成 · 首次下載免費(下載憑據已儲存)', + 'chibi.result.plain': '圖紙已生成', + 'chibi.promise.aria': '服務承諾', + 'chibi.promise.classify': '分類更準確', + 'chibi.promise.classify.desc': '不同主體使用不同提示詞,風景、寵物和食物不再套用人物的規則。', + 'chibi.promise.pay': '生成按次計費', + 'chibi.promise.pay.desc': '每次成功生成扣 1 次權益,失敗不扣,避免無限消耗模型費用。', + 'chibi.promise.safe': '結果防遺失', + 'chibi.promise.safe.desc': '未儲存時鎖住所有切換操作,並在關閉頁面前再次提醒。', + 'chibi.footer': 'PERLER LAB · AI 拼豆專區', + 'chibi.footer.back': '返回圖片轉拼豆 →', + 'chibi.modal.aria': '輸入兌換碼', + 'chibi.modal.title': '輸入兌換碼', + 'chibi.modal.placeholder': '請輸入兌換碼', + 'chibi.modal.empty': '請輸入兌換碼', + 'chibi.modal.fail': '兌換失敗,請稍後重試', + 'chibi.modal.processing': '兌換中…', + 'chibi.modal.submit': '兌換', + 'chibi.upload.tooBig': '圖片不能超過 12MB', + 'chibi.upload.readFail': '圖片讀取失敗,請換一張重試', + 'chibi.upload.ready': '已就緒', + 'chibi.upload.reset': '重置', + 'chibi.error.noImage': '請先上傳需要轉換的原圖', + 'chibi.error.generateFail': '生成失敗,請稍後重試', + 'chibi.tags.hint': '最多選 {max} 項', + + /* ── ChibiPage 資料:五大類 ── */ + 'chibi.cat.landscape.name': '風景', + 'chibi.cat.landscape.note': '山川、城市和旅行紀念', + 'chibi.cat.landscape.nature': '自然山川', + 'chibi.cat.landscape.nature.note': '', + 'chibi.cat.landscape.city': '城市夜景', + 'chibi.cat.landscape.city.note': '', + 'chibi.cat.landscape.landmark': '地標建築', + 'chibi.cat.landscape.landmark.note': '', + 'chibi.cat.people.name': '人物', + 'chibi.cat.people.note': '五官、髮型和穿搭清楚', + 'chibi.cat.people.bigeye': '萌系大眼', + 'chibi.cat.people.bigeye.note': '大眼、圓臉、粗輪廓', + 'chibi.cat.people.youth': '清爽少年', + 'chibi.cat.people.youth.note': '自然五官、利落穿搭', + 'chibi.cat.people.retro': '復古像素', + 'chibi.cat.people.retro.note': '懷舊配色、遊戲感', + 'chibi.cat.pet.name': '寵物', + 'chibi.cat.pet.note': '毛色、表情和品種特徵', + 'chibi.cat.pet.cat': '貓咪頭像', + 'chibi.cat.pet.cat.note': '圓潤臉型與花紋', + 'chibi.cat.pet.dog': '狗狗全身', + 'chibi.cat.pet.dog.note': '耳朵、四肢和毛色', + 'chibi.cat.pet.duo': '雙寵互動', + 'chibi.cat.pet.duo.note': '兩隻寵物同框', + 'chibi.cat.item.name': '物品', + 'chibi.cat.item.note': '手辦、禮物和紀念物', + 'chibi.cat.item.toy': '手辦玩具', + 'chibi.cat.item.toy.note': '造型輪廓優先', + 'chibi.cat.item.daily': '生活用品', + 'chibi.cat.item.daily.note': '保留結構與材質', + 'chibi.cat.item.gift': '禮物紀念', + 'chibi.cat.item.gift.note': '突出包裝和裝飾', + 'chibi.cat.food.name': '食物', + 'chibi.cat.food.note': '甜品、飲品和特色美食', + 'chibi.cat.food.dessert': '甜品蛋糕', + 'chibi.cat.food.dessert.note': '奶油與裝飾清晰', + 'chibi.cat.food.drink': '咖啡飲品', + 'chibi.cat.food.drink.note': '杯型、分層和配料', + 'chibi.cat.food.meal': '家常美食', + 'chibi.cat.food.meal.note': '主食材清晰可辨', + + /* ── ChibiPage 資料:提示詞標籤 ── */ + 'chibi.tag.buildings': '突出主體建築', + 'chibi.tag.texture': '減少零碎紋理', + 'chibi.tag.light': '保留光影氛圍', + 'chibi.tag.border': '純色邊框', + 'chibi.tag.contrast': '高對比輪廓', + 'chibi.tag.clouds': '雲端與遠山', + 'chibi.tag.face': '五官更清晰', + 'chibi.tag.clothes': '保留衣服細節', + 'chibi.tag.hair': '保留髮型', + 'chibi.tag.accessory': '保留配飾', + 'chibi.tag.pet': '包含寵物', + 'chibi.tag.bg': '純色背景', + 'chibi.tag.eyes': '眼睛更有神', + 'chibi.tag.fur': '保留毛色花紋', + 'chibi.tag.ears': '突出耳朵輪廓', + 'chibi.tag.collar': '保留項圈配飾', + 'chibi.tag.limbs': '完整四肢', + 'chibi.tag.shape': '保留品牌外形', + 'chibi.tag.structure': '突出結構輪廓', + 'chibi.tag.gloss': '減少反光漸層', + 'chibi.tag.details': '保留小配件', + 'chibi.tag.center': '居中構圖', + 'chibi.tag.foodMain': '突出食物主體', + 'chibi.tag.layers': '保留食材層次', + 'chibi.tag.decor': '減少細碎裝飾', + 'chibi.tag.saturation': '增強色彩對比', + 'chibi.tag.topdown': '俯拍構圖', + + /* ── ColorChartPage(品牌色號表 · T-091/T-092) ── */ + 'chart.nav.back': '← 返回主頁', + 'chart.hero.title': '品牌色號表', + 'chart.hero.sub': '六品牌拼豆色號速查:MARD / Artkal-C / Perler / Hama / Pyssla / Nabbi', + 'chart.hero.badge': '色號速查', + 'chart.tabs.aria': '選擇品牌', + 'chart.count': '{count} 色', + 'chart.countUnit': '色', + 'chart.col.code': '色號', + 'chart.col.hex': 'HEX', + 'chart.col.name': '名稱', + 'chart.table.aria': '{brand} 色號表,共 {count} 色', + 'chart.empty': '暫無色號資料', + 'chart.footer': '色號與 HEX 來自社群實測數據 · 僅供參考,以實物為準', + 'chart.brand.mard': 'MARD', + 'chart.brand.artkalC': 'Artkal C', + 'chart.brand.perler': 'Perler', + 'chart.brand.hama': 'Hama', + 'chart.brand.pyssla': 'IKEA Pyssla', + 'chart.brand.nabbi': 'Nabbi', + 'chart.series.mard': 'MARD 拼豆', + 'chart.series.artkalC': '2.6mm mini', + 'chart.series.perler': 'Midi 5mm', + 'chart.series.hama': 'Midi 5mm', + 'chart.series.pyssla': '5mm(含 8 色 Pastell)', + 'chart.series.nabbi': 'Midi 5mm', + 'chart.crosslinks.title': '其他品牌色號表', + 'chart.crosslinks.home': '← 返回首頁', + + /* ── Showcase 作品展示(T-097/T-098) ── */ + 'showcase.eyebrow': 'COMMUNITY SHOWCASE', + 'showcase.title.prefix': '看看大家的', + 'showcase.title.accent': '拼豆作品。', + 'showcase.sub': + '探索社群裡受歡迎的拼豆作品,找到靈感;在 AI 專區生成的作品也可以發佈到這裡分享給大家。', + 'showcase.filter.aria': '按標籤篩選作品', + 'showcase.filter.all': '全部', + 'showcase.count': '共 {count} 個作品', + 'showcase.empty.title': '暫無作品', + 'showcase.empty.desc': '換一個標籤看看,或去生成你自己的第一份作品。', + 'showcase.publish': '投稿你的作品 →', + 'showcase.aiBadge': 'AI 生成', + 'showcase.likesAria': '{count} 次點讚', + 'showcase.viewsAria': '{count} 次瀏覽', + 'showcase.tag.landscape': '風景', + 'showcase.tag.people': '人物', + 'showcase.tag.pet': '寵物', + 'showcase.tag.item': '物品', + 'showcase.tag.food': '食物', + + /* ── Library 圖紙庫(T-108) ── */ + 'library.aria': '圖紙列表', + 'library.eyebrow': 'PATTERN LIBRARY', + 'library.title': '圖紙庫', + 'library.title.accent': '· 精選', + 'library.sub': '精選圖紙合集,可預覽與下載;在 AI 專區生成的作品發佈後也會出現在這裡。', + 'library.grid': '{size}', + 'library.brand': '{brand} 色號', + 'library.preview': '預覽', + 'library.download': '下載圖紙', + 'library.empty': '圖紙庫建置中', + 'library.empty.desc': '收藏的圖紙和已發佈的 AI 作品之後會出現在這裡。', + + /* ── Help 幫助中心 FAQ(T-106) ── */ + 'help.eyebrow': 'HELP CENTER', + 'help.title': '幫助中心', + 'help.title.accent': '· FAQ', + 'help.sub': '常見問題速查:選豆、配色、列印、熨燙、裱框,以及兌換碼與 AI 專區使用說明。', + 'help.aria': '常見問題', + 'help.back': '← 返回主頁', + + /* ── Legal 合規內容頁(T-126~T-129) ── */ + 'legal.eyebrow': '信任與合規', + 'legal.updated': '最後更新', + 'legal.effective': '生效日期', + 'legal.back': '← 返回主頁', + 'legal.related': '相關頁面', + + /* ── ChibiPage 發佈到展示(T-102) ── */ + 'chibi.publish.title': '發佈到作品展示', + 'chibi.publish.desc': '把這張作品分享到社群作品展示,讓更多人看到。', + 'chibi.publish.placeholder': '給作品起個名字(選填)', + 'chibi.publish.button': '發佈到展示', + 'chibi.publish.publishing': '發佈中…', + 'chibi.publish.success': '已發佈到作品展示', + 'chibi.publish.view': '去作品展示看看 →', + 'chibi.publish.fail': '發佈失敗,請稍後重試', + 'chibi.publish.published': '已發佈 · {id}', + + /* ── WorkDetail 作品詳情頁(T-132~T-135) ── */ + 'detail.breadcrumb.home': '首頁', + 'detail.breadcrumb.showcase': '作品展示', + 'detail.summary': '下載「{title}」的拼豆圖紙與用料清單,跟著製作指南開始吧。', + 'detail.meta.size': '尺寸', + 'detail.meta.colors': '用色數', + 'detail.meta.beads': '總豆數', + 'detail.meta.brand': '色板', + 'detail.meta.author': '作者', + 'detail.meta.date': '時間', + 'detail.meta.sizeValue': '{width} × {height}', + 'detail.meta.beadsValue': '{count} 顆', + 'detail.meta.colorsValue': '{count} 色', + 'detail.meta.unknown': '未知', + 'detail.preview.title': '圖紙預覽', + 'detail.preview.alt': '{title} 拼豆圖紙預覽', + 'detail.export.title': '匯出圖紙', + 'detail.export.sub': '儲存這張圖紙,開始製作。', + 'detail.export.pdf': '匯出 PDF(推薦)', + 'detail.export.png': '匯出 PNG', + 'detail.export.pdfSoon': 'PDF 匯出即將上線,可先用 PNG 下載預覽圖。', + 'detail.materials.title': '用料清單', + 'detail.materials.sub': '按用量從高到低整理,備料更省心。', + 'detail.materials.empty': '暫無用料清單', + 'detail.materials.empty.desc': '發佈者暫未提供該作品的色號與用量明細。', + 'detail.materials.col.code': '色號', + 'detail.materials.col.name': '名稱', + 'detail.materials.col.count': '數量', + 'detail.materials.highUse': '高用量 · 優先準備', + 'detail.materials.lowUse': '低用量(≤10 顆)共 {count} 種', + 'detail.materials.all': '全部 {count} 色', + 'detail.stats.beads': '總豆數', + 'detail.stats.colors': '用色數', + 'detail.stats.size': '尺寸', + 'detail.guide.title': '製作指南', + 'detail.guide.sub': '從拼板到熨燙,6 步完成作品。', + 'detail.guide.1.title': '規劃拼板', + 'detail.guide.1.desc': '確認需要的拼板數量與擺放方向。', + 'detail.guide.2.title': '準備材料', + 'detail.guide.2.desc': '按用料清單分揀色號與數量,高用量顏色優先。', + 'detail.guide.3.title': '逐格擺放', + 'detail.guide.3.desc': '從一角開始,按圖紙逐格放置拼豆。', + 'detail.guide.4.title': '檢查圖案', + 'detail.guide.4.desc': '斜線處放慢速度,每行結束核對一次。', + 'detail.guide.5.title': '儲存進度', + 'detail.guide.5.desc': '中途休息時儲存進度,拍照記錄當前狀態。', + 'detail.guide.6.title': '均勻熨燙', + 'detail.guide.6.desc': '蓋上熨燙紙,中溫均勻熨燙,冷卻後再揭起。', + 'detail.related.title': '相關作品', + 'detail.related.sub': '你可能也喜歡', + 'detail.faq.title': '常見問題', + 'detail.faq.1.q': '可以用其他品牌的拼豆嗎?', + 'detail.faq.1.a': '不建議混用。不同品牌在色號、材質和熱縮率上存在差異,混用容易導致顏色不一致或熨燙變形。', + 'detail.faq.2.q': '成品尺寸是多大?', + 'detail.faq.2.a': '以單顆 5mm 拼豆估算,成品尺寸約為「格數 × 0.5cm」。', + 'detail.faq.3.q': '熨燙有什麼注意事項?', + 'detail.faq.3.a': '墊上熨燙紙,中溫均勻熨燙,避免局部過熱;完全冷卻後再揭起。', + 'detail.faq.4.q': '圖紙可以免費下載嗎?', + 'detail.faq.4.a': '可以。圖紙與用料清單均可免費查看與下載,僅供個人手作參考。', + 'detail.viewDetail': '查看詳情', + 'detail.loading': '作品載入中…', + 'detail.notFound.title': '作品不存在', + 'detail.notFound.desc': '該作品可能已被刪除,或連結有誤。', + 'detail.error.load': '載入失敗,請稍後重試', + 'detail.error.retry': '重試', + 'detail.back.showcase': '← 返回作品展示', + + /* ── MyBeadsPage 拼豆虛擬豆倉 ── */ + 'nav.beads': '我的豆倉', + 'beads.pageTitle': '我的豆倉', + 'beads.pageDesc': '管理你的拼豆庫存,產生圖紙時自動結算', + 'beads.empty.title': '還沒有豆子', + 'beads.empty.desc': '先添加你手頭已有的拼豆,產生圖紙後才能自動結算庫存', + 'beads.empty.addBtn': '添加豆子', + 'beads.empty.restockBtn': '按圖紙補貨', + 'beads.stats.colors': '色號數', + 'beads.stats.total': '總顆數', + 'beads.stats.outOfStock': '缺貨色號', + 'beads.bottle.add': '補貨', + 'beads.bottle.count': '{count} 顆', + 'beads.bottle.outOfStock': '缺貨', + 'beads.bottle.low': '低庫存', + 'beads.settings.title': '扣豆模式', + 'beads.settings.modeDownload': '下載圖紙時扣豆', + 'beads.settings.modeGenerate': '產生圖紙時扣豆', + 'beads.settings.desc': '選擇何時自動從豆倉扣減庫存', + 'beads.modal.title': '豆倉結算', + 'beads.modal.needed': '需要', + 'beads.modal.stock': '庫存', + 'beads.modal.missing': '差', + 'beads.modal.ok': '充足', + 'beads.modal.restock': '一鍵補貨', + 'beads.modal.cancel': '取消', + 'beads.modal.shortageWarn': '庫存不足,請補貨或換色', + 'beads.modal.confirmConsume': '確認扣豆', + 'beads.replace.title': '換色選擇', + 'beads.replace.pick': '選擇一個顏色替換', + 'beads.replace.done': '已替換:{oldCode} → {newCode}', + 'beads.add.title': '添加豆子', + 'beads.add.code': '色號', + 'beads.add.count': '數量', + 'beads.add.submit': '添加', +}; \ No newline at end of file diff --git a/perler-lab/src/lib/__tests__/bead-inventory.test.ts b/perler-lab/src/lib/__tests__/bead-inventory.test.ts new file mode 100644 index 0000000..e7aa1e2 --- /dev/null +++ b/perler-lab/src/lib/__tests__/bead-inventory.test.ts @@ -0,0 +1,255 @@ +/** + * 拼豆虚拟豆仓(bead-inventory.ts)测试。 + * + * 覆盖:addBeads 增量/换品牌清仓(重建仓库)、consumeBeads 充足/部分不足/完全不足、 + * ensureStock 补齐、getBeadCount、loadInventory 空仓与损坏 JSON 回退、 + * saveInventory + load round-trip 与跨组件事件派发。 + */ + +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; + +import { + BEAD_INVENTORY_EVENT, + BEAD_INVENTORY_KEY, + addBeads, + consumeBeads, + ensureStock, + getBeadCount, + loadInventory, + saveInventory, + type BeadInventory, + type BeadUsage, +} from '../bead-inventory.js'; + +// --------------------------------------------------------------------------- +// 辅助 +// --------------------------------------------------------------------------- + +function makeInventory( + brandId: string, + bottles: Record, + updatedAt = 1234567890, +): BeadInventory { + return { version: 1, brandId, bottles, updatedAt }; +} + +/** 内存版 Storage 替身(完整实现 Storage 接口)。 */ +function createStorageMock(): Storage { + const store = new Map(); + return { + get length() { + return store.size; + }, + clear: (): void => { + store.clear(); + }, + getItem: (key: string): string | null => store.get(key) ?? null, + key: (index: number): string | null => [...store.keys()][index] ?? null, + removeItem: (key: string): void => { + store.delete(key); + }, + setItem: (key: string, value: string): void => { + store.set(key, String(value)); + }, + }; +} + +// --------------------------------------------------------------------------- +// 测试环境 +// --------------------------------------------------------------------------- + +let storage: Storage; +let windowTarget: EventTarget; + +beforeEach(() => { + storage = createStorageMock(); + windowTarget = new EventTarget(); + vi.stubGlobal('localStorage', storage); + vi.stubGlobal('window', windowTarget); +}); + +afterEach(() => { + vi.unstubAllGlobals(); +}); + +// --------------------------------------------------------------------------- +// addBeads +// --------------------------------------------------------------------------- + +describe('addBeads', () => { + it('增量叠加且为纯函数(不改入参)', () => { + const inv = makeInventory('MARD', { A01: 3, B01: 10 }); + const next = addBeads(inv, 'A01', 5); + expect(next).not.toBe(inv); + expect(next.bottles).toEqual({ A01: 8, B01: 10 }); + expect(next.brandId).toBe('MARD'); + expect(next.updatedAt).toBe(inv.updatedAt); + expect(inv.bottles).toEqual({ A01: 3, B01: 10 }); // 入参未被修改 + }); + + it('新增色号从 0 起算', () => { + const inv = makeInventory('MARD', {}); + expect(addBeads(inv, 'C01', 7).bottles).toEqual({ C01: 7 }); + }); + + it('count ≤ 0 或非有限数时原样返回(同一引用)', () => { + const inv = makeInventory('MARD', { A01: 3 }); + for (const bad of [0, -5, Number.NaN, Number.POSITIVE_INFINITY]) { + expect(addBeads(inv, 'A01', bad)).toBe(inv); + } + }); + + it('换品牌清仓:重建空仓后加豆,旧品牌豆全部清零', () => { + const old = makeInventory('MARD', { A01: 50, B01: 30 }); + // 换品牌 = 重建空仓(UI 层约束):brandId 变更时 bottles 重置为空。 + const switched: BeadInventory = { ...old, brandId: 'COCO', bottles: {} }; + const next = addBeads(switched, 'E01', 20); + expect(next.brandId).toBe('COCO'); + expect(next.bottles).toEqual({ E01: 20 }); // 旧品牌 A01/B01 未被带入 + expect(old.bottles).toEqual({ A01: 50, B01: 30 }); + }); +}); + +// --------------------------------------------------------------------------- +// consumeBeads +// --------------------------------------------------------------------------- + +describe('consumeBeads', () => { + it('库存充足时不产生 shortage,扣到剩余', () => { + const inv = makeInventory('MARD', { A01: 10, B01: 5 }); + const entries: readonly BeadUsage[] = [ + { code: 'A01', count: 3 }, + { code: 'A01', count: 4 }, // 同色号多次扣减 + { code: 'B01', count: 2 }, + ]; + const result = consumeBeads(inv, entries); + expect(result.inv.bottles).toEqual({ A01: 3, B01: 3 }); + expect(result.shortages).toEqual([]); + expect(inv.bottles).toEqual({ A01: 10, B01: 5 }); // 纯函数 + }); + + it('部分不足 → 扣到 0 并记录缺口', () => { + const inv = makeInventory('MARD', { A01: 5 }); + const result = consumeBeads(inv, [{ code: 'A01', count: 8 }]); + expect(result.inv.bottles).toEqual({ A01: 0 }); + expect(result.shortages).toEqual([{ code: 'A01', count: 8, missing: 3 }]); + }); + + it('完全不足 → 不产生负库存,缺口记全量', () => { + const inv = makeInventory('MARD', { A01: 0 }); + const result = consumeBeads(inv, [{ code: 'B01', count: 6 }]); + expect(result.inv.bottles).toEqual({ A01: 0 }); // B01 不存在则不新建 0 条目 + expect(result.shortages).toEqual([{ code: 'B01', count: 6, missing: 6 }]); + for (const v of Object.values(result.inv.bottles)) { + expect(v).toBeGreaterThanOrEqual(0); + } + }); + + it('count 非正/非有限条目被忽略', () => { + const inv = makeInventory('MARD', { A01: 4 }); + const result = consumeBeads(inv, [ + { code: 'A01', count: 0 }, + { code: 'A01', count: -2 }, + { code: 'A01', count: Number.NaN }, + ]); + expect(result.inv.bottles).toEqual({ A01: 4 }); + expect(result.shortages).toEqual([]); + }); +}); + +// --------------------------------------------------------------------------- +// ensureStock +// --------------------------------------------------------------------------- + +describe('ensureStock', () => { + it('缺口色号补齐到恰好满足用量', () => { + const inv = makeInventory('MARD', { A01: 2 }); + const next = ensureStock(inv, [ + { code: 'A01', count: 5 }, + { code: 'B01', count: 4 }, + ]); + expect(next.bottles).toEqual({ A01: 5, B01: 4 }); + expect(next).not.toBe(inv); + expect(inv.bottles).toEqual({ A01: 2 }); // 纯函数 + }); + + it('已有库存不少于用量时不改动', () => { + const inv = makeInventory('MARD', { A01: 9 }); + expect(ensureStock(inv, [{ code: 'A01', count: 5 }]).bottles).toEqual({ A01: 9 }); + }); +}); + +// --------------------------------------------------------------------------- +// getBeadCount +// --------------------------------------------------------------------------- + +describe('getBeadCount', () => { + it('有库存返回数量,无此色号返回 0', () => { + const inv = makeInventory('MARD', { A01: 12 }); + expect(getBeadCount(inv, 'A01')).toBe(12); + expect(getBeadCount(inv, 'ZZZ')).toBe(0); + }); +}); + +// --------------------------------------------------------------------------- +// loadInventory +// --------------------------------------------------------------------------- + +describe('loadInventory 读取', () => { + it('无数据时返回空仓(MARD + 空 bottles)', () => { + const inv = loadInventory(); + expect(inv.version).toBe(1); + expect(inv.brandId).toBe('MARD'); + expect(inv.bottles).toEqual({}); + expect(Number.isFinite(inv.updatedAt)).toBe(true); + }); + + it('损坏 JSON 回退空仓', () => { + storage.setItem(BEAD_INVENTORY_KEY, '{oops: 这不是合法JSON'); + const inv = loadInventory(); + expect(inv.brandId).toBe('MARD'); + expect(inv.bottles).toEqual({}); + }); + + it('形状不合法(缺字段/版本不符)也回退空仓', () => { + storage.setItem(BEAD_INVENTORY_KEY, JSON.stringify({ brandId: 'COCO', bottles: {} })); + const inv = loadInventory(); + expect(inv.brandId).toBe('MARD'); + expect(inv.bottles).toEqual({}); + }); +}); + +// --------------------------------------------------------------------------- +// saveInventory + round-trip +// --------------------------------------------------------------------------- + +describe('saveInventory 持久化', () => { + it('saveInventory → loadInventory round-trip 数据一致', () => { + const inv = makeInventory('COCO', { E01: 24, E02: 6 }, 1700000000000); + saveInventory(inv); + const loaded = loadInventory(); + expect(loaded).toEqual(inv); + }); + + it('派发 bead-inventory-changed 事件且 detail 为仓库对象', () => { + const inv = makeInventory('MARD', { A01: 15 }); + const listener = vi.fn(); + windowTarget.addEventListener(BEAD_INVENTORY_EVENT, listener); + saveInventory(inv); + expect(listener).toHaveBeenCalledTimes(1); + const event = listener.mock.calls[0]![0] as CustomEvent; + expect(event.detail).toEqual(inv); + expect(storage.getItem(BEAD_INVENTORY_KEY)).toBe(JSON.stringify(inv)); + }); + + it('localStorage 写入异常时静默降级但仍派发事件', () => { + storage.setItem = vi.fn().mockImplementation(() => { + throw new Error('quota exceeded'); + }); + const listener = vi.fn(); + windowTarget.addEventListener(BEAD_INVENTORY_EVENT, listener); + const inv = makeInventory('MARD', { A01: 1 }); + expect(() => saveInventory(inv)).not.toThrow(); + expect(listener).toHaveBeenCalledTimes(1); + }); +}); \ No newline at end of file diff --git a/perler-lab/src/lib/__tests__/bead-replacement.test.ts b/perler-lab/src/lib/__tests__/bead-replacement.test.ts new file mode 100644 index 0000000..3b50b6d --- /dev/null +++ b/perler-lab/src/lib/__tests__/bead-replacement.test.ts @@ -0,0 +1,113 @@ +/** + * 缺货替换算法(bead-replacement.ts)测试。 + * + * 覆盖:CIEDE2000 最近色命中、等价于对候选集逐一计算取最小、 + * 空库存全空返回 null、只剩自身返回 null、排除零库存色号、 + * 目标不在品牌映射返回 null、库存中品牌映射外的色号被跳过。 + */ + +import { describe, expect, it } from 'vitest'; + +import { findReplacement } from '../bead-replacement.js'; +import { STANDARD_COLORS } from '../brand-palettes.js'; +import { srgbToLab } from '../lab.js'; +import { colorDistance } from '../color-matching.js'; +import type { BeadInventory } from '../bead-inventory.js'; + +// --------------------------------------------------------------------------- +// 辅助 +// --------------------------------------------------------------------------- + +function makeInventory( + brandId: string, + bottles: Record, + updatedAt = 1234567890, +): BeadInventory { + return { version: 1, brandId, bottles, updatedAt }; +} + +/** 该品牌色号 → 标准色 rgb。 */ +function rgbByCode(brandId: string): Map { + const map = new Map(); + for (const s of STANDARD_COLORS) { + const code = s.brands[brandId]; + if (code && code !== '-') { + map.set(code, s.rgb); + } + } + return map; +} + +// --------------------------------------------------------------------------- +// 测试 +// --------------------------------------------------------------------------- + +describe('findReplacement', () => { + it('返回 CIEDE2000 距离最近的库存色号', () => { + // MARD 白 T01(#FFFFFF),候选 H03(#B6B1BA 浅灰) 与 H07(#000000 纯黑) + // 浅灰 < 纯黑,预期 H03 + const inv = makeInventory('MARD', { T01: 4, H03: 10, H07: 5 }); + expect(findReplacement(inv, 'T01', 'MARD')).toBe('H03'); + }); + + it('等价于对候选集逐一计算 CIEDE2000 取最小', () => { + const brandId = 'MARD'; + const bottles: Record = { A04: 8, D05: 3, E13: 6, H07: 2 }; + const inv = makeInventory(brandId, bottles); + const targetCode = 'A03'; // 亮黄 #FEFF8B + const targetRgb = rgbByCode(brandId).get(targetCode)!; + const targetLab = srgbToLab(targetRgb); + + // 手工在所有候选上计算最小距离 + let bestCode: string | null = null; + let bestDistance = Number.POSITIVE_INFINITY; + for (const [code, stock] of Object.entries(bottles)) { + if (stock <= 0) continue; + const rgb = rgbByCode(brandId).get(code); + if (!rgb) continue; + const d = colorDistance('ciede2000', targetLab, srgbToLab(rgb)); + if (d < bestDistance) { + bestDistance = d; + bestCode = code; + } + } + + expect(findReplacement(inv, targetCode, brandId)).toBe(bestCode); + }); + + it('库存全空返回 null', () => { + expect(findReplacement(makeInventory('MARD', {}), 'A01', 'MARD')).toBeNull(); + expect( + findReplacement(makeInventory('MARD', { A01: 0, B01: 0 }), 'A01', 'MARD'), + ).toBeNull(); + }); + + it('只剩自身有库存时返回 null', () => { + expect(findReplacement(makeInventory('MARD', { A01: 100 }), 'A01', 'MARD')).toBeNull(); + }); + + it('排除零库存色号', () => { + // T01(白) 目标,H01(近白) 零库存,H07(黑) 有库存 + const inv = makeInventory('MARD', { T01: 1, H01: 0, H07: 3 }); + // H01 是距 T01 最近色但零库存 → 跳过,应选 H07 + expect(findReplacement(inv, 'T01', 'MARD')).toBe('H07'); + }); + + it('目标色号不在该品牌色板内返回 null', () => { + const inv = makeInventory('MARD', { A01: 5, B01: 5 }); + expect(findReplacement(inv, 'NO_SUCH_CODE', 'MARD')).toBeNull(); + }); + + it('库存中品牌映射外的色号被跳过', () => { + const inv = makeInventory('MARD', { FOREIGN: 9, H07: 3 }); + // T01(白) 目标,FOREIGN 无映射 → 跳过,剩下 H07 + expect(findReplacement(inv, 'T01', 'MARD')).toBe('H07'); + }); + + it('非 MARD 品牌(漫漫)同样工作', () => { + // 漫漫 L6(#FFFFFF) 目标,E1(#FDD3CC 浅肤粉) 有库存,F7(#000000 纯黑) 有库存 + // 白 → 浅粉 < 黑,预期 E1 + const inv = makeInventory('漫漫', { E1: 4, F7: 6 }); + expect(findReplacement(inv, 'L6', '漫漫')).toBe('E1'); + }); +}); \ No newline at end of file diff --git a/perler-lab/src/lib/bead-deduct-mode.ts b/perler-lab/src/lib/bead-deduct-mode.ts new file mode 100644 index 0000000..335b8e0 --- /dev/null +++ b/perler-lab/src/lib/bead-deduct-mode.ts @@ -0,0 +1,30 @@ +/** + * 扣豆模式开关:localStorage key 'perler-bead-deduct-mode'。 + * 值 'download'(默认)| 'generate',决定下载或生成图纸时自动弹结算弹窗。 + */ + +export type BeadDeductMode = 'download' | 'generate'; + +export const BEAD_DEDUCT_MODE_KEY = 'perler-bead-deduct-mode'; + +const DEFAULT_MODE: BeadDeductMode = 'download'; + +export function readDeductMode(): BeadDeductMode { + if (typeof window === 'undefined') return DEFAULT_MODE; + try { + const raw = window.localStorage.getItem(BEAD_DEDUCT_MODE_KEY); + if (raw === 'download' || raw === 'generate') return raw; + } catch { + // 存储不可用时静默回退 + } + return DEFAULT_MODE; +} + +export function writeDeductMode(mode: BeadDeductMode): void { + if (typeof window === 'undefined') return; + try { + window.localStorage.setItem(BEAD_DEDUCT_MODE_KEY, mode); + } catch { + // 静默失败 + } +} \ No newline at end of file diff --git a/perler-lab/src/lib/bead-inventory.ts b/perler-lab/src/lib/bead-inventory.ts new file mode 100644 index 0000000..8e0aaf3 --- /dev/null +++ b/perler-lab/src/lib/bead-inventory.ts @@ -0,0 +1,175 @@ +/** + * 拼豆虚拟豆仓数据层 —— beaning 库存模型 + localStorage 持久化 + 加减/补货纯函数。 + * + * 设计约定: + * - `addBeads`/`consumeBeads`/`ensureStock` 均为纯函数:绝不修改入参, + * 返回新对象。`version`/`brandId`/`updatedAt` 保持不变,仅由调用方在 + * 更换品牌(清仓重建)或需要刷新时间戳时自行更新。 + * - 更换品牌 = 以新 brandId + 空 bottles 重建仓库(`{ ...old, brandId: 新品牌, bottles: {} }`)。 + * - localStorage 持久化 + 同页跨组件同步:`saveInventory` 写库后派发 + * `bead-inventory-changed` 自定义事件;`loadInventory` 兜底空仓(损坏 JSON 回退)。 + */ + +// --------------------------------------------------------------------------- +// 类型定义 +// --------------------------------------------------------------------------- + +export interface BeadUsage { + code: string; + count: number; +} + +export interface BeadInventory { + version: 1; + brandId: string; + bottles: Record; // 色号 → 剩余颗数(恒 ≥ 0) + updatedAt: number; +} + +export interface Shortage { + code: string; + count: number; // 图纸需要 + missing: number; // 缺口(> 0) +} + +export interface ConsumeResult { + inv: BeadInventory; + shortages: Shortage[]; +} + +// --------------------------------------------------------------------------- +// 常量 +// --------------------------------------------------------------------------- + +export const BEAD_INVENTORY_KEY = 'perler-bead-inventory'; +export const BEAD_INVENTORY_EVENT = 'bead-inventory-changed'; + +// --------------------------------------------------------------------------- +// 内部工具 +// --------------------------------------------------------------------------- + +function fallbackInventory(): BeadInventory { + return { version: 1, brandId: 'MARD', bottles: {}, updatedAt: Date.now() }; +} + +/** 浅层形状校验:确保 JSON.parse 产物符合 BeadInventory 结构。 */ +function isBeadInventory(value: unknown): value is BeadInventory { + if (typeof value !== 'object' || value === null) return false; + const v = value as Record; + return ( + v['version'] === 1 && + typeof v['brandId'] === 'string' && + v['brandId'].length > 0 && + typeof v['bottles'] === 'object' && + v['bottles'] !== null && + !Array.isArray(v['bottles']) && + typeof v['updatedAt'] === 'number' && + Number.isFinite(v['updatedAt']) + ); +} + +// --------------------------------------------------------------------------- +// 持久化 +// --------------------------------------------------------------------------- + +/** + * 从 localStorage 读取仓库。无数据或 JSON 损坏时返回空仓。 + */ +export function loadInventory(): BeadInventory { + try { + const raw = globalThis.localStorage?.getItem(BEAD_INVENTORY_KEY); + if (!raw) return fallbackInventory(); + const parsed: unknown = JSON.parse(raw); + return isBeadInventory(parsed) ? parsed : fallbackInventory(); + } catch { + return fallbackInventory(); + } +} + +/** + * 写入 localStorage 并派发跨组件同步事件。 + * 写入失败(隐私模式/配额耗尽)时静默忽略,事件仍派发确保组件同步。 + */ +export function saveInventory(inv: BeadInventory): void { + try { + globalThis.localStorage?.setItem(BEAD_INVENTORY_KEY, JSON.stringify(inv)); + } catch { + // 写入失败时静默忽略 + } + const target = typeof window !== 'undefined' ? window : undefined; + target?.dispatchEvent(new CustomEvent(BEAD_INVENTORY_EVENT, { detail: inv })); +} + +// --------------------------------------------------------------------------- +// 纯函数 — 加减/补货 +// --------------------------------------------------------------------------- + +/** + * 纯函数:向仓库添加指定色号的豆量。 + * count ≤ 0 或非有限数时原样返回入参(同一引用)。 + */ +export function addBeads(inv: BeadInventory, code: string, count: number): BeadInventory { + if (count <= 0 || !Number.isFinite(count)) return inv; + const bottles: Record = { ...inv.bottles }; + bottles[code] = (bottles[code] ?? 0) + count; + return { ...inv, bottles }; +} + +/** + * 纯函数:按 entries 扣减库存,每色号扣到 0 为止。 + * 缺口(需要量 > 实际拥有)记录进 `shortages`,bottles 不出现负数。 + */ +export function consumeBeads(inv: BeadInventory, entries: readonly BeadUsage[]): ConsumeResult { + const bottles: Record = { ...inv.bottles }; + const shortages: Shortage[] = []; + + for (const entry of entries) { + const { code, count } = entry; + if (count <= 0 || !Number.isFinite(count)) continue; + + const have = code in bottles ? (bottles[code] ?? 0) : 0; + const actual = Math.min(have, count); + const remaining = have - actual; + + if (remaining > 0) { + bottles[code] = remaining; + } else if (code in bottles) { + // 原来有库存,扣到 0 后标记为 0(不删除键) + bottles[code] = 0; + } + // 若原来无库存,不创建 0 条目 + + const missing = count - actual; + if (missing > 0) { + shortages.push({ code, count, missing }); + } + } + + return { inv: { ...inv, bottles }, shortages }; +} + +/** + * 纯函数:缺口色号补齐到恰好满足 entries 用量(补齐到 count,不是多加)。 + * 已有库存 ≥ 用量时不动。 + */ +export function ensureStock(inv: BeadInventory, entries: readonly BeadUsage[]): BeadInventory { + const bottles: Record = { ...inv.bottles }; + + for (const entry of entries) { + const { code, count } = entry; + if (count <= 0 || !Number.isFinite(count)) continue; + const have = bottles[code] ?? 0; + if (have < count) { + bottles[code] = count; + } + } + + return { ...inv, bottles }; +} + +/** + * 纯函数:查询指定色号的库存量,无此色号返回 0。 + */ +export function getBeadCount(inv: BeadInventory, code: string): number { + return inv.bottles[code] ?? 0; +} \ No newline at end of file diff --git a/perler-lab/src/lib/bead-replacement.ts b/perler-lab/src/lib/bead-replacement.ts new file mode 100644 index 0000000..c97d6b7 --- /dev/null +++ b/perler-lab/src/lib/bead-replacement.ts @@ -0,0 +1,56 @@ +/** + * 缺货替换算法 —— 在豆仓内按 CIEDE2000 色差寻找最近的可替代库存色号。 + * + * 色号→rgb 映射来自 brand-palettes.ts 的 STANDARD_COLORS(各品牌色号 + 标准色 rgb), + * 目标与候选均统一转换到 CIE LAB 后用 CIEDE2000(colorDistance('ciede2000'))比较。 + */ + +import type { BeadInventory } from './bead-inventory.js'; +import { STANDARD_COLORS } from './brand-palettes.js'; +import { srgbToLab, type Lab } from './lab.js'; +import { colorDistance } from './color-matching.js'; + +/** 构建「品牌色号 → sRGB」映射(跳过 "-" 无映射项)。 */ +function buildRgbMap(brandId: string): Map { + const map = new Map(); + for (const entry of STANDARD_COLORS) { + const code = entry.brands[brandId]; + if (code && code !== '-') { + map.set(code, entry.rgb); + } + } + return map; +} + +/** + * 从 inv.bottles 中拥有库存(count > 0)的色号里,按 CIEDE2000 色差找与 `code` 最接近的色号。 + * + * 规则: + * - 排除自身(`code` 本身有库存时跳过); + * - 色号在 brandId 品牌映射中找不到 rgb 的候选被跳过; + * - 无候选(库存全空 / 只剩自身)或目标色号不在品牌色板内时返回 null。 + */ +export function findReplacement(inv: BeadInventory, code: string, brandId: string): string | null { + const rgbByCode = buildRgbMap(brandId); + + const targetRgb = rgbByCode.get(code); + if (!targetRgb) return null; + const targetLab: Lab = srgbToLab(targetRgb); + + let best: string | null = null; + let bestDistance = Number.POSITIVE_INFINITY; + + for (const [candidate, stock] of Object.entries(inv.bottles)) { + if (candidate === code) continue; // 排除自身 + if (stock <= 0) continue; // 排除零库存色号 + const rgb = rgbByCode.get(candidate); + if (!rgb) continue; // 找不到色号 → 跳过该候选 + const distance = colorDistance('ciede2000', targetLab, srgbToLab(rgb)); + if (distance < bestDistance) { + bestDistance = distance; + best = candidate; + } + } + + return best; +} \ No newline at end of file diff --git a/perler-lab/src/lib/useBeadInventory.ts b/perler-lab/src/lib/useBeadInventory.ts new file mode 100644 index 0000000..6b78943 --- /dev/null +++ b/perler-lab/src/lib/useBeadInventory.ts @@ -0,0 +1,86 @@ +/** + * 豆仓 React hook —— 订阅 localStorage + 跨组件同步。 + * + * `useBeadInventory` 以 `useState` 初始化 `loadInventory()`, + * 通过 `useEffect` 监听 `window` 上的 `bead-inventory-changed` 与 `storage` 事件 + * 实现多组件 / 多标签页间的库存状态同步。 + * + * 内部维护 `inventoryRef` 确保 `add`/`consume`/`ensure` 在同步调用序列中 + * 始终基于最新库存计算,避免 React 批次更新导致的闭包过期。 + */ + +import { useCallback, useEffect, useRef, useState } from 'react'; +import { + addBeads, + consumeBeads, + ensureStock, + loadInventory, + saveInventory, + type BeadInventory, + type BeadUsage, + type Shortage, +} from './bead-inventory.js'; + +export interface UseBeadInventory { + inventory: BeadInventory; + add(code: string, count: number): void; + consume(entries: readonly BeadUsage[]): Shortage[]; + ensure(entries: readonly BeadUsage[]): void; + refresh(): void; +} + +export function useBeadInventory(): UseBeadInventory { + const [inventory, setInventory] = useState(() => loadInventory()); + const inventoryRef = useRef(inventory); + + /** 同步更新 ref + state,确保后续调用始终读取最新值。 */ + const applyInventory = useCallback((next: BeadInventory): void => { + inventoryRef.current = next; + setInventory(next); + }, []); + + // 订阅外部变更(同一页面的 saveInventory 事件 / 其他标签页的 storage 事件) + useEffect(() => { + const sync = (): void => applyInventory(loadInventory()); + window.addEventListener('bead-inventory-changed', sync); + window.addEventListener('storage', sync); + return () => { + window.removeEventListener('bead-inventory-changed', sync); + window.removeEventListener('storage', sync); + }; + }, [applyInventory]); + + const add = useCallback( + (code: string, count: number): void => { + const next = addBeads(inventoryRef.current, code, count); + saveInventory(next); + applyInventory(next); + }, + [applyInventory], + ); + + const consume = useCallback( + (entries: readonly BeadUsage[]): Shortage[] => { + const result = consumeBeads(inventoryRef.current, entries); + saveInventory(result.inv); + applyInventory(result.inv); + return result.shortages; + }, + [applyInventory], + ); + + const ensure = useCallback( + (entries: readonly BeadUsage[]): void => { + const next = ensureStock(inventoryRef.current, entries); + saveInventory(next); + applyInventory(next); + }, + [applyInventory], + ); + + const refresh = useCallback((): void => { + applyInventory(loadInventory()); + }, [applyInventory]); + + return { inventory, add, consume, ensure, refresh }; +} \ No newline at end of file diff --git a/perler-lab/src/pages/MyBeadsPage.tsx b/perler-lab/src/pages/MyBeadsPage.tsx new file mode 100644 index 0000000..2cc7e30 --- /dev/null +++ b/perler-lab/src/pages/MyBeadsPage.tsx @@ -0,0 +1,551 @@ +/** + * MyBeadsPage — 拼豆虚拟豆仓 (/my-beads) + * + * 瓶子网格 + 补货粒子动画 + 空仓引导 + 扣豆模式开关 + 库存总览统计。 + * 使用 useBeadInventory() 管理本地库存(localStorage),零后端依赖。 + */ + +import { useCallback, useEffect, useRef, useState, type FormEvent } from 'react'; +import './pages.css'; +import './beads.css'; +import SubNav from '../components/SubNav'; +import { useT } from '../i18n'; +import { useBeadInventory } from '../lib/useBeadInventory'; +import { getBrandPalette, BRANDS } from '../lib/brand-palettes'; +import { readDeductMode, writeDeductMode, type BeadDeductMode } from '../lib/bead-deduct-mode'; + +// ─── 常量 ──────────────────────────────────────────────────────────────── + +/** 瓶子水位条的「合理上限」—— 库存/水位 = count / CAP (max 100%)。 */ +const BOTTLE_CAP = 500; + +/** 低库存阈值(低于此值时显示低库存提示)。 */ +const LOW_STOCK_THRESHOLD = 100; + +// ─── 类型 ──────────────────────────────────────────────────────────────── + +interface Particle { + x: number; + y: number; + vx: number; + vy: number; + duration: number; + landed: boolean; + elapsed: number; +} + +// ─── 帮助函数 ──────────────────────────────────────────────────────────── + +/** 为所有 Pattern 品牌构建 { code → hex } 查询表。 */ +function buildHexMap(): ReadonlyMap { + const map = new Map(); + for (const brand of BRANDS) { + for (const c of getBrandPalette(brand.id)) { + if (!map.has(c.code)) map.set(c.code, c.hex); + } + } + return map; +} + +const HEX_MAP = buildHexMap(); + +/** 动画数字滚动。 */ +function animateNumber(from: number, to: number, setter: (v: number) => void): void { + const start = performance.now(); + const duration = 450; + const step = (now: number) => { + const p = Math.min((now - start) / duration, 1); + const eased = 1 - Math.pow(1 - p, 3); // easeOutCubic + setter(Math.round(from + (to - from) * eased)); + if (p < 1) requestAnimationFrame(step); + }; + requestAnimationFrame(step); +} + +// ─── 粒子动画 ──────────────────────────────────────────────────────────── + +const GRAVITY = 1600; +const PARTICLE_DURATION_MIN = 600; +const PARTICLE_DURATION_MAX = 900; +const PARTICLE_COUNT_MIN = 10; +const PARTICLE_COUNT_MAX = 16; + +function startParticleAnimation( + container: HTMLElement, + hex: string, + onDone: () => void, +): () => void { + const count = PARTICLE_COUNT_MIN + Math.floor(Math.random() * (PARTICLE_COUNT_MAX - PARTICLE_COUNT_MIN + 1)); + const w = container.clientWidth; + const h = container.clientHeight; + const maxY = h * 0.78; + + const particles: Particle[] = []; + const nodes: HTMLDivElement[] = []; + + for (let i = 0; i < count; i++) { + particles.push({ + x: Math.random() * w, + y: -6 - Math.random() * 10, + vx: (Math.random() - 0.5) * 100, + vy: 60 + Math.random() * 80, + duration: PARTICLE_DURATION_MIN + Math.random() * (PARTICLE_DURATION_MAX - PARTICLE_DURATION_MIN), + landed: false, + elapsed: 0, + }); + + const node = document.createElement('div'); + node.className = 'bd-particle'; + node.style.background = hex; + node.style.width = `${6 + Math.random() * 4}px`; + node.style.height = node.style.width; + node.style.transform = `translate3d(${particles[i]!.x}px, ${particles[i]!.y}px, 0)`; + container.appendChild(node); + nodes.push(node); + } + + let last = performance.now(); + let rafId = 0; + + const step = (now: number) => { + const dt = Math.min((now - last) / 1000, 0.033); + last = now; + let allDone = true; + + for (let i = 0; i < particles.length; i++) { + const p = particles[i]!; + const node = nodes[i]!; + + if (p.landed) continue; + + p.elapsed += dt; + p.vy += GRAVITY * dt; + p.x += p.vx * dt; + p.y += p.vy * dt; + + if (p.y >= maxY || p.elapsed >= p.duration) { + p.y = maxY; + p.landed = true; + } else { + allDone = false; + } + + node.style.transform = `translate3d(${p.x}px, ${p.y}px, 0)`; + } + + if (allDone) { + nodes.forEach((n) => n.remove()); + onDone(); + return; + } + + rafId = requestAnimationFrame(step); + }; + + rafId = requestAnimationFrame(step); + + return () => { + cancelAnimationFrame(rafId); + nodes.forEach((n) => n.remove()); + }; +} + +// ─── BottleCard 子组件 ─────────────────────────────────────────────────── + +interface BottleCardProps { + code: string; + hex: string; + count: number; + onAdd: (code: string, amount: number) => void; +} + +function BottleCard({ code, hex, count, onAdd }: BottleCardProps) { + const { t } = useT(); + const [showPopup, setShowPopup] = useState(false); + const [amount, setAmount] = useState(''); + const containerRef = useRef(null); + const popupInputRef = useRef(null); + const prevCountRef = useRef(count); + const [displayCount, setDisplayCount] = useState(count); + const inFlightRef = useRef(false); + + // 库存变化 → 数字滚动动画(从旧值滚动到新值)。 + useEffect(() => { + if (count === prevCountRef.current) return; + const from = prevCountRef.current; + prevCountRef.current = count; + animateNumber(from, count, setDisplayCount); + }, [count]); + + // 打开弹窗时聚焦输入框 + useEffect(() => { + if (showPopup && popupInputRef.current) { + popupInputRef.current.focus(); + } + }, [showPopup]); + + const handleConfirm = useCallback(() => { + const n = Number.parseInt(amount, 10); + if (!isFinite(n) || n <= 0 || inFlightRef.current) return; + const container = containerRef.current; + if (!container) return; + inFlightRef.current = true; + setShowPopup(false); + setAmount(''); + // 粒子动画(600~900ms)结束后:调用 onAdd 触发外部库存更新, + // 水位条随之 transition 上升、数字滚动。 + startParticleAnimation(container, hex, () => { + inFlightRef.current = false; + onAdd(code, n); + }); + }, [amount, hex, code, onAdd]); + + const handleKeyDown = useCallback( + (e: React.KeyboardEvent) => { + if (e.key === 'Escape') setShowPopup(false); + if (e.key === 'Enter') handleConfirm(); + }, + [handleConfirm], + ); + + const isOutOfStock = count === 0; + const isLowStock = count > 0 && count < LOW_STOCK_THRESHOLD; + const waterPct = Math.min((displayCount / BOTTLE_CAP) * 100, 100); + + return ( +
+ {/* 粒子动画容器 */} +
+ + {/* 色块 + 色号 */} +
+ + + {/* 垂直水位条 */} +
+
+
+ + {/* 剩余颗数 */} +
+ {displayCount.toLocaleString()} +
+ + {/* 补货按钮 */} + + + {/* 行内补货弹窗 */} + {showPopup && ( +
+ setAmount(e.target.value)} + placeholder={t('beads.add.count')} + /> +
+ + +
+
+ )} +
+ ); +} + +// ─── 添加豆子弹窗 ──────────────────────────────────────────────────────── + +interface AddBeadsModalProps { + open: boolean; + onClose: () => void; + onAdd: (code: string, count: number) => void; +} + +function AddBeadsModal({ open, onClose, onAdd }: AddBeadsModalProps) { + const { t } = useT(); + const [code, setCode] = useState(''); + const [count, setCount] = useState(''); + const [selectedBrand, setSelectedBrand] = useState('MARD'); + const [showColorGrid, setShowColorGrid] = useState(false); + + const palette = getBrandPalette(selectedBrand); + + const handleSubmit = useCallback( + (e: FormEvent) => { + e.preventDefault(); + const n = Number.parseInt(count, 10); + if (!code.trim() || !isFinite(n) || n <= 0) return; + onAdd(code.trim().toUpperCase(), n); + setCode(''); + setCount(''); + onClose(); + }, + [code, count, onAdd, onClose], + ); + + const handleKeyDown = useCallback( + (e: React.KeyboardEvent) => { + if (e.key === 'Escape') onClose(); + }, + [onClose], + ); + + if (!open) return null; + + return ( +
+
e.stopPropagation()} role="dialog" aria-modal="true" aria-label={t('beads.add.title')}> + {/* 标题 */} +
+ {t('beads.add.title')} + +
+ +
+ {/* 品牌选择 */} +
+ +
+ {BRANDS.map((b) => ( + + ))} +
+
+ + {/* 色板点选 */} + {showColorGrid && ( +
+ +
+ {palette.map((c) => ( + + ))} +
+
+ )} + + {/* 色号输入 */} +
+ + setCode(e.target.value.toUpperCase())} + placeholder="M001" + /> + {selectedBrand} +
+ + {/* 数量输入 */} +
+ + setCount(e.target.value)} + placeholder="100" + /> +
+ + {/* 提交 */} + +
+
+
+ ); +} + +// ─── 主页面 ────────────────────────────────────────────────────────────── + +export default function MyBeadsPage() { + const { t } = useT(); + const { inventory, add } = useBeadInventory(); + const [deductMode, setDeductMode] = useState(readDeductMode); + const [addModalOpen, setAddModalOpen] = useState(false); + + const bottles = inventory?.bottles ?? {}; + const bottleEntries = Object.entries(bottles); + + const totalColors = bottleEntries.length; + const totalBeads = bottleEntries.reduce((sum, [, c]) => sum + c, 0); + const outOfStockCount = bottleEntries.filter(([, c]) => c === 0).length; + + const isEmpty = totalColors === 0; + + // 切换扣豆模式 + const handleModeChange = useCallback((mode: BeadDeductMode) => { + setDeductMode(mode); + writeDeductMode(mode); + }, []); + + // 补货 + const handleAdd = useCallback( + (code: string, count: number) => { + add(code, count); + }, + [add], + ); + + return ( +
+ + +
+ {/* 标题区 */} +
+

{t('beads.pageTitle')}

+

{t('beads.pageDesc')}

+
+ + {/* 扣豆模式开关 */} +
+ {t('beads.settings.title')} +
+ + +
+ {t('beads.settings.desc')} +
+ + {/* 库存总览 */} +
+
+ {totalColors} + {t('beads.stats.colors')} +
+
+ {totalBeads.toLocaleString()} + {t('beads.stats.total')} +
+
+ 0 ? ' bd-stat-warn' : ''}`}> + {outOfStockCount} + + {t('beads.stats.outOfStock')} +
+
+ + {/* 空仓引导 */} + {isEmpty ? ( +
+ {t('beads.empty.title')} +

{t('beads.empty.desc')}

+
+ + + {t('beads.empty.restockBtn')} + +
+
+ ) : ( + /* 瓶子网格 */ +
+ {bottleEntries + .sort(([a], [b]) => a.localeCompare(b)) + .map(([code, count]) => { + const hex = HEX_MAP.get(code) ?? '#ccc'; + return ( + + ); + })} +
+ )} +
+ +
+
+ {t('footer.slogan')} +
+
+ + {/* 添加豆子弹窗 */} + setAddModalOpen(false)} + onAdd={handleAdd} + /> +
+ ); +} \ No newline at end of file diff --git a/perler-lab/src/pages/beads.css b/perler-lab/src/pages/beads.css new file mode 100644 index 0000000..4dcab88 --- /dev/null +++ b/perler-lab/src/pages/beads.css @@ -0,0 +1,873 @@ +/* ============================================================================= + * PERLER LAB — MyBeadsPage 拼豆虚拟豆仓 (/my-beads) + * 复用 pages.css 的 CSS 变量(--bg-page 等),服从相同设计令牌体系。 + * ========================================================================= */ + +/* ═══════════════════════ 库存总览统计卡 ═══════════════════════ */ + +.bd-stats { + display: grid; + grid-template-columns: repeat(3, 1fr); + gap: var(--space-3); + margin-bottom: var(--space-5); +} + +.bd-stat-card { + display: flex; + flex-direction: column; + gap: var(--space-1); + background: var(--bg-card); + border: 1px solid var(--border); + border-radius: var(--radius-md); + box-shadow: var(--shadow-card); + padding: var(--space-4); +} + +.bd-stat-value { + font-size: 24px; + font-weight: 700; + line-height: 1.2; + color: var(--text-primary); +} + +.bd-stat-label { + font-size: var(--text-xs); + color: var(--text-tertiary); + letter-spacing: .04em; +} + +.bd-stat-warn { + color: var(--danger); +} + +/* ═══════════════════════ 扣豆模式开关 ═══════════════════════ */ + +.bd-settings { + display: flex; + align-items: center; + flex-wrap: wrap; + gap: var(--space-4); + padding: var(--space-4); + margin-bottom: var(--space-5); + background: var(--bg-card); + border: 1px solid var(--border); + border-radius: var(--radius-lg); + box-shadow: var(--shadow-card); +} + +.bd-settings-label { + font-size: var(--text-sm); + font-weight: 600; + color: var(--text-primary); + white-space: nowrap; +} + +.bd-settings-options { + display: flex; + gap: var(--space-2); +} + +.bd-settings-btn { + display: inline-flex; + align-items: center; + gap: var(--space-2); + min-height: var(--touch-min-sm); + padding: 0 var(--space-4); + border-radius: var(--radius-full); + background: var(--bg-subtle); + border: 1px solid var(--border-strong); + color: var(--text-secondary); + font-size: var(--text-sm); + font-weight: 500; + cursor: pointer; + transition: border-color .15s ease, color .15s ease, background .15s ease; +} + +.bd-settings-btn:hover { + border-color: var(--accent); + color: var(--text-primary); +} + +.bd-settings-btn.is-active { + background: var(--accent); + border-color: var(--accent); + color: var(--text-on-dark); +} + +.bd-settings-desc { + width: 100%; + font-size: var(--text-xs); + color: var(--text-tertiary); + margin-top: var(--space-1); +} + +/* ═══════════════════════ 瓶子网格 ═══════════════════════ */ + +.bd-grid { + display: grid; + grid-template-columns: repeat(6, 1fr); + gap: var(--space-3); +} + +.bd-bottle { + display: flex; + flex-direction: column; + gap: var(--space-2); + background: var(--bg-card); + border: 1px solid var(--border); + border-radius: var(--radius-lg); + box-shadow: var(--shadow-card); + padding: var(--space-3); + transition: border-color .15s ease, box-shadow .15s ease; + position: relative; + overflow: hidden; +} + +.bd-bottle:hover { + border-color: var(--border-strong); + box-shadow: var(--shadow-float); +} + +.bd-bottle.is-out-of-stock { + opacity: .6; +} + +.bd-bottle.is-low-stock { + border-color: var(--danger); +} + +.bd-bottle-swatch { + width: 28px; + height: 28px; + border-radius: var(--radius-sm); + border: 1px solid var(--border); + flex-shrink: 0; +} + +.bd-bottle-header { + display: flex; + align-items: center; + gap: var(--space-2); +} + +.bd-bottle-code { + font-family: ui-monospace, 'Cascadia Code', Consolas, monospace; + font-size: var(--text-xs); + font-weight: 600; + color: var(--text-primary); +} + +.bd-bottle-warning { + margin-left: auto; + font-size: 9px; + font-weight: 700; + color: var(--text-on-dark); + background: var(--danger); + border-radius: var(--radius-full); + padding: 1px 6px; + letter-spacing: .3px; + white-space: nowrap; +} + +.bd-bottle-empty-badge { + margin-left: auto; + font-size: 9px; + font-weight: 700; + color: var(--text-tertiary); + background: var(--bg-subtle); + border-radius: var(--radius-full); + padding: 1px 6px; + letter-spacing: .3px; + white-space: nowrap; +} + +/* ── 水位条(垂直:div 高度百分比 = 库存/合理上限) ── */ + +.bd-bottle-level-wrap { + position: relative; + height: 120px; + border-radius: var(--radius-md); + background: var(--bg-subtle); + overflow: hidden; + border: 1px solid var(--border); +} + +.bd-bottle-level { + position: absolute; + left: 0; + right: 0; + bottom: 0; + height: 0; + border-radius: 0 0 var(--radius-md) var(--radius-md); + transition: height .4s ease; +} + +.bd-bottle-level.is-empty { + background: var(--border-strong) !important; + height: 0 !important; +} + +/* ── 剩余颗数 ── */ + +.bd-bottle-count { + font-size: 20px; + font-weight: 700; + line-height: 1.2; + color: var(--text-primary); + font-variant-numeric: tabular-nums; +} + +.bd-bottle-count.is-empty { + color: var(--text-disabled); +} + +.bd-bottle-count.is-low { + color: var(--danger); +} + +/* ── 补货按钮 ── */ + +.bd-bottle-add { + display: inline-flex; + align-items: center; + justify-content: center; + min-height: var(--touch-min-sm); + padding: 0 var(--space-3); + border-radius: var(--radius-md); + background: var(--accent-soft); + border: 1px solid var(--accent); + color: var(--accent-hover); + font-size: var(--text-xs); + font-weight: 700; + cursor: pointer; + transition: background .15s ease, color .15s ease; + align-self: flex-start; +} + +.bd-bottle-add:hover { + background: var(--accent); + color: var(--text-on-dark); +} + +/* ═══════════════════════ 补货粒子动画容器 ═══════════════════════ */ + +.bd-particle-container { + position: absolute; + inset: 0; + pointer-events: none; + overflow: hidden; + z-index: 2; +} + +.bd-particle { + position: absolute; + width: 8px; + height: 8px; + border-radius: 50%; + opacity: .9; + will-change: transform; +} + +/* ═══════════════════════ 空仓引导 ═══════════════════════ */ + +.bd-empty { + display: flex; + flex-direction: column; + align-items: center; + text-align: center; + padding: var(--space-6) var(--space-4); + background: var(--bg-card); + border: 1px dashed var(--border-dashed); + border-radius: var(--radius-lg); + color: var(--text-tertiary); + font-size: var(--text-sm); + gap: var(--space-3); +} + +.bd-empty-title { + font-size: var(--text-lg); + font-weight: 700; + color: var(--text-primary); +} + +.bd-empty-desc { + max-width: 400px; + line-height: 1.6; + color: var(--text-secondary); +} + +.bd-empty-actions { + display: flex; + gap: var(--space-3); + margin-top: var(--space-2); +} + +.bd-empty-btn { + display: inline-flex; + align-items: center; + gap: var(--space-2); + min-height: var(--touch-min); + padding: 0 var(--space-5); + border-radius: var(--radius-md); + font-size: var(--text-md); + font-weight: 700; + cursor: pointer; + transition: background .15s ease, border-color .15s ease; +} + +.bd-empty-btn--primary { + background: var(--accent); + color: var(--text-on-dark); + border: none; +} + +.bd-empty-btn--primary:hover { + background: var(--accent-hover); +} + +.bd-empty-btn--outline { + background: var(--bg-card); + border: 1px solid var(--border-strong); + color: var(--text-secondary); +} + +.bd-empty-btn--outline:hover { + border-color: var(--accent); + color: var(--text-primary); +} + +/* ═══════════════════════ 补货弹出表单(小弹窗) ═══════════════════════ */ + +.bd-add-popup { + position: absolute; + top: 100%; + right: 0; + z-index: 10; + display: flex; + flex-direction: column; + gap: var(--space-2); + min-width: 180px; + padding: var(--space-3); + background: var(--bg-card); + border: 1px solid var(--border-strong); + border-radius: var(--radius-md); + box-shadow: var(--shadow-float); + margin-top: var(--space-1); +} + +.bd-add-popup-input { + width: 100%; + min-height: var(--touch-min-sm); + padding: 0 var(--space-3); + border: 1px solid var(--border-strong); + border-radius: var(--radius-sm); + font-size: var(--text-md); + font-family: inherit; + color: var(--text-primary); + background: var(--bg-page); + outline: none; + transition: border-color .15s ease; + box-sizing: border-box; +} + +.bd-add-popup-input:focus { + border-color: var(--accent); +} + +.bd-add-popup-actions { + display: flex; + gap: var(--space-2); +} + +.bd-add-popup-btn { + flex: 1; + display: inline-flex; + align-items: center; + justify-content: center; + min-height: var(--touch-min-sm); + padding: 0 var(--space-3); + border-radius: var(--radius-sm); + font-size: var(--text-xs); + font-weight: 600; + cursor: pointer; + transition: background .15s ease; + border: none; +} + +.bd-add-popup-btn--confirm { + background: var(--accent); + color: var(--text-on-dark); +} + +.bd-add-popup-btn--confirm:hover { + background: var(--accent-hover); +} + +.bd-add-popup-btn--cancel { + background: var(--bg-subtle); + color: var(--text-secondary); +} + +.bd-add-popup-btn--cancel:hover { + background: var(--border); +} + +/* ═══════════════════════ 结算弹窗(BeadSettlementModal) ═══════════════════════ */ + +.bd-modal-overlay { + position: fixed; + inset: 0; + z-index: 200; + display: flex; + align-items: center; + justify-content: center; + background: rgba(23, 23, 19, .5); + backdrop-filter: blur(2px); + padding: var(--space-4); +} + +.bd-modal { + display: flex; + flex-direction: column; + width: 100%; + max-width: 520px; + max-height: 80vh; + background: var(--bg-card); + border: 1px solid var(--border); + border-radius: var(--radius-lg); + box-shadow: 0 8px 32px rgba(23, 23, 19, .16); + overflow: hidden; +} + +.bd-modal-header { + display: flex; + align-items: center; + justify-content: space-between; + padding: var(--space-4) var(--space-5); + border-bottom: 1px solid var(--border); +} + +.bd-modal-title { + font-size: var(--text-lg); + font-weight: 700; + color: var(--text-primary); +} + +.bd-modal-close { + display: inline-flex; + align-items: center; + justify-content: center; + width: 32px; + height: 32px; + border-radius: var(--radius-sm); + border: none; + background: none; + color: var(--text-tertiary); + font-size: 18px; + cursor: pointer; + transition: background .15s ease, color .15s ease; +} + +.bd-modal-close:hover { + background: var(--bg-subtle); + color: var(--text-primary); +} + +.bd-modal-sub { + padding: var(--space-2) var(--space-5); + font-size: var(--text-sm); + color: var(--text-tertiary); + border-bottom: 1px solid var(--border); +} + +.bd-modal-body { + flex: 1; + overflow-y: auto; + padding: var(--space-3) var(--space-5); +} + +.bd-modal-list { + display: flex; + flex-direction: column; + gap: var(--space-2); +} + +.bd-modal-row { + display: flex; + align-items: center; + gap: var(--space-3); + padding: var(--space-2) 0; + border-bottom: 1px solid var(--border); +} + +.bd-modal-row:last-child { + border-bottom: none; +} + +.bd-modal-swatch { + width: 20px; + height: 20px; + border-radius: 4px; + border: 1px solid var(--border); + flex-shrink: 0; +} + +.bd-modal-code { + font-family: ui-monospace, 'Cascadia Code', Consolas, monospace; + font-size: var(--text-xs); + font-weight: 600; + color: var(--text-primary); + min-width: 50px; +} + +.bd-modal-detail { + display: flex; + align-items: center; + gap: var(--space-2); + margin-left: auto; + font-size: var(--text-xs); + font-variant-numeric: tabular-nums; + color: var(--text-secondary); +} + +.bd-modal-detail b { + font-weight: 600; +} + +.bd-modal-detail-ok { + color: var(--success); + font-weight: 600; +} + +.bd-modal-detail-missing { + color: var(--danger); + font-weight: 600; +} + +.bd-modal-replace-btn { + font-size: var(--text-xs); + font-weight: 600; + color: var(--info); + border: 1px solid var(--info); + border-radius: var(--radius-full); + padding: 1px 10px; + background: none; + cursor: pointer; + transition: background .15s ease, color .15s ease; + white-space: nowrap; +} + +.bd-modal-replace-btn:hover { + background: var(--info); + color: var(--text-on-dark); +} + +.bd-modal-footer { + display: flex; + align-items: center; + gap: var(--space-3); + padding: var(--space-4) var(--space-5); + border-top: 1px solid var(--border); + background: var(--bg-hover); +} + +.bd-modal-footer-note { + flex: 1; + font-size: var(--text-xs); + color: var(--danger); + font-weight: 500; +} + +.bd-modal-btn { + display: inline-flex; + align-items: center; + justify-content: center; + min-height: var(--touch-min); + padding: 0 var(--space-5); + border-radius: var(--radius-md); + font-size: var(--text-sm); + font-weight: 700; + cursor: pointer; + transition: background .15s ease, border-color .15s ease; + border: none; + white-space: nowrap; +} + +.bd-modal-btn--primary { + background: var(--accent); + color: var(--text-on-dark); +} + +.bd-modal-btn--primary:hover { + background: var(--accent-hover); +} + +.bd-modal-btn--primary:disabled { + opacity: .4; + cursor: not-allowed; +} + +.bd-modal-btn--success { + background: var(--success); + color: var(--text-on-dark); +} + +.bd-modal-btn--success:hover { + filter: brightness(1.1); +} + +.bd-modal-btn--outline { + background: var(--bg-card); + border: 1px solid var(--border-strong); + color: var(--text-secondary); +} + +.bd-modal-btn--outline:hover { + border-color: var(--accent); + color: var(--text-primary); +} + +/* ═══════════════════════ 换色选择面板(弹层) ═══════════════════════ */ + +.bd-replace-overlay { + position: absolute; + inset: 0; + z-index: 5; + display: flex; + align-items: center; + justify-content: center; + background: rgba(23, 23, 19, .3); + backdrop-filter: blur(1px); + border-radius: var(--radius-lg); +} + +.bd-replace-panel { + width: 90%; + max-width: 360px; + max-height: 70%; + background: var(--bg-card); + border: 1px solid var(--border-strong); + border-radius: var(--radius-md); + box-shadow: var(--shadow-float); + overflow: hidden; + display: flex; + flex-direction: column; +} + +.bd-replace-header { + display: flex; + align-items: center; + justify-content: space-between; + padding: var(--space-3) var(--space-4); + border-bottom: 1px solid var(--border); +} + +.bd-replace-title { + font-size: var(--text-sm); + font-weight: 700; + color: var(--text-primary); +} + +.bd-replace-close { + display: inline-flex; + align-items: center; + justify-content: center; + width: 28px; + height: 28px; + border-radius: var(--radius-sm); + border: none; + background: none; + color: var(--text-tertiary); + font-size: 16px; + cursor: pointer; +} + +.bd-replace-close:hover { + background: var(--bg-subtle); + color: var(--text-primary); +} + +.bd-replace-grid { + display: grid; + grid-template-columns: repeat(6, 1fr); + gap: var(--space-2); + padding: var(--space-3); + overflow-y: auto; +} + +/* ── 换色提示 Toast(首页/App 层使用) ── */ + +.bd-replace-toast { + position: fixed; + bottom: 24px; + left: 50%; + transform: translateX(-50%); + z-index: 300; + padding: 10px 24px; + border-radius: var(--radius-md); + background: var(--success); + color: var(--text-on-dark); + font-size: var(--text-sm); + font-weight: 600; + white-space: nowrap; + box-shadow: 0 4px 16px rgba(23, 23, 19, .16); + animation: bd-toast-in .3s ease; + pointer-events: none; +} + +@keyframes bd-toast-in { + from { + opacity: 0; + transform: translateX(-50%) translateY(12px); + } + to { + opacity: 1; + transform: translateX(-50%) translateY(0); + } +} + +.bd-replace-color { + display: flex; + flex-direction: column; + align-items: center; + gap: 2px; + padding: var(--space-1); + border-radius: var(--radius-sm); + border: 2px solid transparent; + cursor: pointer; + transition: border-color .15s ease, background .15s ease; +} + +.bd-replace-color:hover { + border-color: var(--accent); + background: var(--bg-hover); +} + +.bd-replace-swatch { + width: 24px; + height: 24px; + border-radius: 4px; + border: 1px solid var(--border); +} + +.bd-replace-code { + font-family: ui-monospace, 'Cascadia Code', Consolas, monospace; + font-size: 9px; + color: var(--text-tertiary); + line-height: 1; +} + +/* ═══════════════════════ 添加豆子全屏弹窗 ═══════════════════════ */ + +.bd-add-modal { + max-width: 420px; +} + +.bd-add-form { + display: flex; + flex-direction: column; + gap: var(--space-4); + padding: var(--space-4) var(--space-5); +} + +.bd-add-field { + display: flex; + flex-direction: column; + gap: var(--space-1); +} + +.bd-add-label { + font-size: var(--text-sm); + font-weight: 600; + color: var(--text-primary); +} + +.bd-add-input { + min-height: var(--touch-min); + padding: 0 var(--space-3); + border: 1px solid var(--border-strong); + border-radius: var(--radius-sm); + font-size: var(--text-md); + font-family: inherit; + color: var(--text-primary); + background: var(--bg-page); + outline: none; + transition: border-color .15s ease; +} + +.bd-add-input:focus { + border-color: var(--accent); +} + +.bd-add-brand-hint { + font-size: var(--text-xs); + color: var(--text-tertiary); + margin-top: var(--space-1); +} + +/* ═══════════════════════ 响应式 ═══════════════════════ */ + +@media (max-width: 1023px) { + .bd-grid { + grid-template-columns: repeat(4, 1fr); + } +} + +@media (max-width: 767px) { + .bd-grid { + grid-template-columns: repeat(2, 1fr); + gap: var(--space-2); + } + + .bd-stats { + grid-template-columns: 1fr; + gap: var(--space-2); + } + + .bd-stat-card { + flex-direction: row; + align-items: baseline; + justify-content: space-between; + padding: var(--space-3); + } + + .bd-settings { + flex-direction: column; + align-items: stretch; + gap: var(--space-3); + } + + .bd-bottle { + padding: var(--space-2); + } + + .bd-bottle-count { + font-size: 18px; + } + + .bd-modal { + max-height: 90vh; + } + + .bd-modal-header { + padding: var(--space-3) var(--space-4); + } + + .bd-modal-body { + padding: var(--space-2) var(--space-4); + } + + .bd-modal-footer { + flex-direction: column; + gap: var(--space-2); + padding: var(--space-3) var(--space-4); + } + + .bd-modal-footer-note { + text-align: center; + } + + .bd-replace-grid { + grid-template-columns: repeat(5, 1fr); + } +} \ No newline at end of file