feat(bead-inventory): 虚拟豆仓——扣豆/补货/换色 + /my-beads 页面 + 三语言

- 豆仓数据层:localStorage CRUD + 加减/补货纯函数(bead-inventory.ts, 17 单测)
- 换色算法:CIEDE2000 就近换色(bead-replacement.ts, 8 单测)
- 扣豆模式开关:下载时扣(默认)/ 生成时扣,localStorage 持久化
- MyBeadsPage:瓶子卡片 + 水位/粒子动画 + 空仓引导 + 统计
- BeadSettlementModal:缺口列表 / 确认扣豆 / 一键补货 / 换色
- App 集成:下载/生成拦截 + 换色联动 + /my-beads 路由
- i18n:新增繁体 zh-TW 全量翻译 + 简/英豆仓文案
- 修复 LangSwitcher 语言按钮缺失 key prop 的 React warning
This commit is contained in:
Sisyphus committed 2026-08-20 18:27:27 +08:00
1 parent a87c25da4a
commit e690194643
18 files changed
+2998 -42

No files matched your search

+227 -20
View File
@@ -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<string, number>();
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<string | null>(null);
const [modal, setModal] = useState<ModalState>(null);
// 豆仓结算拦击:settle 非空时显示结算弹窗(下载/生成模式共用)。
const [settle, setSettle] = useState<SettleState | null>(null);
// 换色记录(作用于 editedResult,预览/导出/清单自动跟随)。
const [replacements, setReplacements] = useState<readonly Replacement[]>([]);
// 换色成功提示。
const [replaceToast, setReplaceToast] = useState<string | null>(null);
// 豆仓库存(consume / ensure 供结算确认与补货使用)。
const beadInventory = useBeadInventory();
// T-067 分享:?share= 分享码解码出的图纸(绕过上传直接渲染)。
const [sharedPattern, setSharedPattern] = useState<SharedPattern | null>(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<ProcessResult | null>(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 && (
<BeadSettlementModal
open
entries={paletteToUsage(editedResult)}
brandId={settings.brandId}
onClose={() => setSettle(null)}
onConfirm={handleSettleConfirm}
onRestock={handleSettleRestock}
onReplace={handleReplace}
/>
)}
{/* 换色成功提示 */}
{replaceToast && (
<div
className="bd-replace-toast"
role="status"
aria-live="polite"
>
{replaceToast}
</div>
)}
</div>
);
}
@@ -359,6 +563,9 @@ export default function App() {
if (path === '/help' || path.startsWith('/help/')) {
return <HelpPage />;
}
if (path === '/my-beads' || path.startsWith('/my-beads/')) {
return <MyBeadsPage />;
}
if (path === '/privacy-policy' || path.startsWith('/privacy-policy/')) {
return <PrivacyPolicyPage />;
}
+19 -15
View File
@@ -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 => (
<button
type="button"
className={locale === target ? `${btn} ${active}` : btn}
aria-pressed={locale === target}
onClick={() => setLocale(target)}
>
{label}
</button>
);
return (
<div className={base} role="group" aria-label={t('nav.lang')}>
{renderButton('zh-CN', '中文')}
{renderButton('en', 'EN')}
{LOCALE_BUTTONS.map((b) => (
<button
key={b.target}
type="button"
className={locale === b.target ? `${btn} ${active}` : btn}
aria-pressed={locale === b.target}
onClick={() => setLocale(b.target)}
>
{b.label}
</button>
))}
</div>
);
}
+3
View File
@@ -29,6 +29,9 @@ export default function Nav({ onAgencyClick }: NavProps) {
<a className="nav-link" href="/color-chart">
{t('nav.colorChart')}
</a>
<a className="nav-link" href="/my-beads">
{t('nav.beads')}
</a>
</nav>
<div className="nav-right">
+3 -1
View File
@@ -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' },
];
/**
+4 -3
View File
@@ -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', () => {
+2
View File
@@ -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<Locale, Messages> = {
'zh-CN': zhCN,
'zh-TW': zhTW,
en,
};
+6 -3
View File
@@ -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';
}
+36
View File
@@ -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',
};
+36
View File
@@ -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 };
+523
View File
@@ -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': '添加',
};
@@ -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<string, number>,
updatedAt = 1234567890,
): BeadInventory {
return { version: 1, brandId, bottles, updatedAt };
}
/** 内存版 Storage 替身(完整实现 Storage 接口)。 */
function createStorageMock(): Storage {
const store = new Map<string, string>();
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<BeadInventory>;
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);
});
});
@@ -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<string, number>,
updatedAt = 1234567890,
): BeadInventory {
return { version: 1, brandId, bottles, updatedAt };
}
/** 该品牌色号 → 标准色 rgb。 */
function rgbByCode(brandId: string): Map<string, [number, number, number]> {
const map = new Map<string, [number, number, number]>();
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<string, number> = { 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');
});
});
+30
View File
@@ -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 {
// 静默失败
}
}
+175
View File
@@ -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<string, number>; // 色号 → 剩余颗数(恒 ≥ 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<string, unknown>;
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<BeadInventory>(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<string, number> = { ...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<string, number> = { ...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<string, number> = { ...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;
}
+56
View File
@@ -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<string, [number, number, number]> {
const map = new Map<string, [number, number, number]>();
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;
}
+86
View File
@@ -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<BeadInventory>(() => loadInventory());
const inventoryRef = useRef<BeadInventory>(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 };
}
+551
View File
@@ -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<string, string> {
const map = new Map<string, string>();
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<HTMLDivElement>(null);
const popupInputRef = useRef<HTMLInputElement>(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 (
<div
className={`bd-bottle${isOutOfStock ? ' is-out-of-stock' : ''}${isLowStock ? ' is-low-stock' : ''}`}
ref={containerRef}
>
{/* 粒子动画容器 */}
<div className="bd-particle-container" />
{/* 色块 + 色号 */}
<div className="bd-bottle-header">
<div className="bd-bottle-swatch" style={{ background: hex }} aria-hidden="true" />
<span className="bd-bottle-code">{code}</span>
{isOutOfStock && <span className="bd-bottle-empty-badge">{t('beads.bottle.outOfStock')}</span>}
{isLowStock && <span className="bd-bottle-warning">{t('beads.bottle.low')}</span>}
</div>
{/* 垂直水位条 */}
<div className="bd-bottle-level-wrap">
<div
className={`bd-bottle-level${isOutOfStock ? ' is-empty' : ''}`}
style={{ height: `${waterPct}%`, background: isOutOfStock ? undefined : hex }}
/>
</div>
{/* 剩余颗数 */}
<div className={`bd-bottle-count${isOutOfStock ? ' is-empty' : ''}${isLowStock ? ' is-low' : ''}`}>
{displayCount.toLocaleString()}
</div>
{/* 补货按钮 */}
<button
type="button"
className="bd-bottle-add"
onClick={() => setShowPopup((v) => !v)}
>
{t('beads.bottle.add')}
</button>
{/* 行内补货弹窗 */}
{showPopup && (
<div className="bd-add-popup" onKeyDown={handleKeyDown}>
<input
ref={popupInputRef}
className="bd-add-popup-input"
type="number"
min={1}
step={1}
value={amount}
onChange={(e) => setAmount(e.target.value)}
placeholder={t('beads.add.count')}
/>
<div className="bd-add-popup-actions">
<button
type="button"
className="bd-add-popup-btn bd-add-popup-btn--confirm"
onClick={handleConfirm}
>
{t('beads.bottle.add')}
</button>
<button
type="button"
className="bd-add-popup-btn bd-add-popup-btn--cancel"
onClick={() => { setShowPopup(false); setAmount(''); }}
>
{t('modal.close')}
</button>
</div>
</div>
)}
</div>
);
}
// ─── 添加豆子弹窗 ────────────────────────────────────────────────────────
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 (
<div className="bd-modal-overlay" onClick={onClose} onKeyDown={handleKeyDown}>
<div className="bd-modal bd-add-modal" onClick={(e) => e.stopPropagation()} role="dialog" aria-modal="true" aria-label={t('beads.add.title')}>
{/* 标题 */}
<div className="bd-modal-header">
<span className="bd-modal-title">{t('beads.add.title')}</span>
<button type="button" className="bd-modal-close" onClick={onClose} aria-label={t('modal.close')}>
✕
</button>
</div>
<form className="bd-add-form" onSubmit={handleSubmit}>
{/* 品牌选择 */}
<div className="bd-add-field">
<label className="bd-add-label">{t('ctrl.brand')}</label>
<div className="bd-settings-options">
{BRANDS.map((b) => (
<button
key={b.id}
type="button"
className={`bd-settings-btn${selectedBrand === b.id ? ' is-active' : ''}`}
onClick={() => { setSelectedBrand(b.id); setShowColorGrid(true); }}
>
{b.id}
</button>
))}
</div>
</div>
{/* 色板点选 */}
{showColorGrid && (
<div className="bd-add-field">
<label className="bd-add-label">{t('beads.replace.pick')}</label>
<div className="bd-replace-grid" style={{ maxHeight: 180, overflowY: 'auto' }}>
{palette.map((c) => (
<button
key={c.code}
type="button"
className="bd-replace-color"
style={{ borderColor: code === c.code ? 'var(--accent)' : 'transparent' }}
onClick={() => setCode(c.code)}
>
<span className="bd-replace-swatch" style={{ background: c.hex }} />
<span className="bd-replace-code">{c.code}</span>
</button>
))}
</div>
</div>
)}
{/* 色号输入 */}
<div className="bd-add-field">
<label className="bd-add-label">{t('beads.add.code')}</label>
<input
className="bd-add-input"
type="text"
value={code}
onChange={(e) => setCode(e.target.value.toUpperCase())}
placeholder="M001"
/>
<span className="bd-add-brand-hint">{selectedBrand}</span>
</div>
{/* 数量输入 */}
<div className="bd-add-field">
<label className="bd-add-label">{t('beads.add.count')}</label>
<input
className="bd-add-input"
type="number"
min={1}
step={1}
value={count}
onChange={(e) => setCount(e.target.value)}
placeholder="100"
/>
</div>
{/* 提交 */}
<button type="submit" className="bd-empty-btn bd-empty-btn--primary" style={{ alignSelf: 'flex-end' }}>
{t('beads.add.submit')}
</button>
</form>
</div>
</div>
);
}
// ─── 主页面 ──────────────────────────────────────────────────────────────
export default function MyBeadsPage() {
const { t } = useT();
const { inventory, add } = useBeadInventory();
const [deductMode, setDeductMode] = useState<BeadDeductMode>(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 (
<div className="pl-page">
<SubNav active="beads" />
<main className="pl-main">
{/* 标题区 */}
<header className="pl-hero">
<h1 className="pl-h1">{t('beads.pageTitle')}</h1>
<p className="pl-sub">{t('beads.pageDesc')}</p>
</header>
{/* 扣豆模式开关 */}
<div className="bd-settings">
<span className="bd-settings-label">{t('beads.settings.title')}</span>
<div className="bd-settings-options">
<button
type="button"
className={`bd-settings-btn${deductMode === 'download' ? ' is-active' : ''}`}
aria-pressed={deductMode === 'download'}
onClick={() => handleModeChange('download')}
>
{t('beads.settings.modeDownload')}
</button>
<button
type="button"
className={`bd-settings-btn${deductMode === 'generate' ? ' is-active' : ''}`}
aria-pressed={deductMode === 'generate'}
onClick={() => handleModeChange('generate')}
>
{t('beads.settings.modeGenerate')}
</button>
</div>
<span className="bd-settings-desc">{t('beads.settings.desc')}</span>
</div>
{/* 库存总览 */}
<div className="bd-stats">
<div className="bd-stat-card">
<span className="bd-stat-value">{totalColors}</span>
<span className="bd-stat-label">{t('beads.stats.colors')}</span>
</div>
<div className="bd-stat-card">
<span className="bd-stat-value">{totalBeads.toLocaleString()}</span>
<span className="bd-stat-label">{t('beads.stats.total')}</span>
</div>
<div className="bd-stat-card">
<span className={`bd-stat-value${outOfStockCount > 0 ? ' bd-stat-warn' : ''}`}>
{outOfStockCount}
</span>
<span className="bd-stat-label">{t('beads.stats.outOfStock')}</span>
</div>
</div>
{/* 空仓引导 */}
{isEmpty ? (
<div className="bd-empty">
<span className="bd-empty-title">{t('beads.empty.title')}</span>
<p className="bd-empty-desc">{t('beads.empty.desc')}</p>
<div className="bd-empty-actions">
<button
type="button"
className="bd-empty-btn bd-empty-btn--primary"
onClick={() => setAddModalOpen(true)}
>
{t('beads.empty.addBtn')}
</button>
<a className="bd-empty-btn bd-empty-btn--outline" href="/">
{t('beads.empty.restockBtn')}
</a>
</div>
</div>
) : (
/* 瓶子网格 */
<div className="bd-grid">
{bottleEntries
.sort(([a], [b]) => a.localeCompare(b))
.map(([code, count]) => {
const hex = HEX_MAP.get(code) ?? '#ccc';
return (
<BottleCard
key={code}
code={code}
hex={hex}
count={count}
onAdd={handleAdd}
/>
);
})}
</div>
)}
</main>
<footer className="pl-footer">
<div className="pl-footer-inner">
<span className="pl-footer-text">{t('footer.slogan')}</span>
</div>
</footer>
{/* 添加豆子弹窗 */}
<AddBeadsModal
open={addModalOpen}
onClose={() => setAddModalOpen(false)}
onAdd={handleAdd}
/>
</div>
);
}
+873
View File
@@ -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);
}
}