feat: 法语词汇学习应用

- Vue 3 + TypeScript + Tailwind CSS
- 词汇学习和管理功能
- 支持生词本和复习
This commit is contained in:
likingcode
2026-03-07 05:42:32 +00:00
commit 71232cf489
28 changed files with 9561 additions and 0 deletions

24
.gitignore vendored Normal file
View File

@@ -0,0 +1,24 @@
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*
node_modules
dist
dist-ssr
*.local
# Editor directories and files
.vscode/*
!.vscode/extensions.json
.idea
.DS_Store
*.suo
*.ntvs*
*.njsproj
*.sln
*.sw?

73
README.md Normal file
View File

@@ -0,0 +1,73 @@
# React + TypeScript + Vite
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
Currently, two official plugins are available:
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
## React Compiler
The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
## Expanding the ESLint configuration
If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
```js
export default defineConfig([
globalIgnores(['dist']),
{
files: ['**/*.{ts,tsx}'],
extends: [
// Other configs...
// Remove tseslint.configs.recommended and replace with this
tseslint.configs.recommendedTypeChecked,
// Alternatively, use this for stricter rules
tseslint.configs.strictTypeChecked,
// Optionally, add this for stylistic rules
tseslint.configs.stylisticTypeChecked,
// Other configs...
],
languageOptions: {
parserOptions: {
project: ['./tsconfig.node.json', './tsconfig.app.json'],
tsconfigRootDir: import.meta.dirname,
},
// other options...
},
},
])
```
You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
```js
// eslint.config.js
import reactX from 'eslint-plugin-react-x'
import reactDom from 'eslint-plugin-react-dom'
export default defineConfig([
globalIgnores(['dist']),
{
files: ['**/*.{ts,tsx}'],
extends: [
// Other configs...
// Enable lint rules for React
reactX.configs['recommended-typescript'],
// Enable lint rules for React DOM
reactDom.configs.recommended,
],
languageOptions: {
parserOptions: {
project: ['./tsconfig.node.json', './tsconfig.app.json'],
tsconfigRootDir: import.meta.dirname,
},
// other options...
},
},
])
```

23
eslint.config.js Normal file
View File

@@ -0,0 +1,23 @@
import js from '@eslint/js'
import globals from 'globals'
import reactHooks from 'eslint-plugin-react-hooks'
import reactRefresh from 'eslint-plugin-react-refresh'
import tseslint from 'typescript-eslint'
import { defineConfig, globalIgnores } from 'eslint/config'
export default defineConfig([
globalIgnores(['dist']),
{
files: ['**/*.{ts,tsx}'],
extends: [
js.configs.recommended,
tseslint.configs.recommended,
reactHooks.configs.flat.recommended,
reactRefresh.configs.vite,
],
languageOptions: {
ecmaVersion: 2020,
globals: globals.browser,
},
},
])

22
index.html Normal file
View File

@@ -0,0 +1,22 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="theme-color" content="#3b82f6" />
<link rel="manifest" href="/manifest.json" />
<title>French Vocabulary</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
<script>
if ('serviceWorker' in navigator) {
window.addEventListener('load', () => {
navigator.serviceWorker.register('/sw.js').catch(console.error);
});
}
</script>
</body>
</html>

8278
package-lock.json generated Normal file

File diff suppressed because it is too large Load Diff

37
package.json Normal file
View File

@@ -0,0 +1,37 @@
{
"name": "french-vocab",
"private": true,
"version": "0.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build",
"lint": "eslint .",
"preview": "vite preview"
},
"dependencies": {
"dexie": "^4.3.0",
"react": "^19.2.0",
"react-dom": "^19.2.0",
"zustand": "^5.0.11"
},
"devDependencies": {
"@eslint/js": "^9.39.1",
"@tailwindcss/postcss": "^4.2.1",
"@types/node": "^24.10.1",
"@types/react": "^19.2.7",
"@types/react-dom": "^19.2.3",
"@vitejs/plugin-react": "^5.1.1",
"autoprefixer": "^10.4.27",
"eslint": "^9.39.1",
"eslint-plugin-react-hooks": "^7.0.1",
"eslint-plugin-react-refresh": "^0.4.24",
"globals": "^16.5.0",
"postcss": "^8.5.8",
"tailwindcss": "^4.2.1",
"typescript": "~5.9.3",
"typescript-eslint": "^8.48.0",
"vite": "^7.3.1",
"vite-plugin-pwa": "^1.2.0"
}
}

5
postcss.config.js Normal file
View File

@@ -0,0 +1,5 @@
export default {
plugins: {
'@tailwindcss/postcss': {},
},
}

21
public/manifest.json Normal file
View File

@@ -0,0 +1,21 @@
{
"name": "French Vocabulary",
"short_name": "FrenchVocab",
"description": "Master French with spaced repetition",
"start_url": "/",
"display": "standalone",
"background_color":="#ffffff",
"theme_color": "#3b82f6",
"icons": [
{
"src": "/icon-192.png",
"sizes": "192x192",
"type": "image/png"
},
{
"src": "/icon-512.png",
"sizes": "512x512",
"type": "image/png"
}
]
}

24
public/sw.js Normal file
View File

@@ -0,0 +1,24 @@
const CACHE_NAME = 'french-vocab-v1';
const urlsToCache = [
'/',
'/index.html',
'/assets/index.css',
'/assets/index.js'
];
self.addEventListener('install', (event) => {
event.waitUntil(
caches.open(CACHE_NAME)
.then((cache) => cache.addAll(urlsToCache))
);
});
self.addEventListener('fetch', (event) => {
event.respondWith(
caches.match(event.request)
.then((response) => {
if (response) return response;
return fetch(event.request);
})
);
});

1
public/vite.svg Normal file
View File

@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

After

Width:  |  Height:  |  Size: 1.5 KiB

42
src/App.css Normal file
View File

@@ -0,0 +1,42 @@
#root {
max-width: 1280px;
margin: 0 auto;
padding: 2rem;
text-align: center;
}
.logo {
height: 6em;
padding: 1.5em;
will-change: filter;
transition: filter 300ms;
}
.logo:hover {
filter: drop-shadow(0 0 2em #646cffaa);
}
.logo.react:hover {
filter: drop-shadow(0 0 2em #61dafbaa);
}
@keyframes logo-spin {
from {
transform: rotate(0deg);
}
to {
transform: rotate(360deg);
}
}
@media (prefers-reduced-motion: no-preference) {
a:nth-of-type(2) .logo {
animation: logo-spin infinite 20s linear;
}
}
.card {
padding: 2em;
}
.read-the-docs {
color: #888;
}

206
src/App.tsx Normal file
View File

@@ -0,0 +1,206 @@
import { useEffect, useState } from 'react';
import { FlashCard } from './components/FlashCard';
import { RatingButtons } from './components/RatingButtons';
import { ProgressBar } from './components/ProgressBar';
import { ImportModal } from './components/ImportModal';
import { useAppStore } from './stores/appStore';
function App() {
const [showImport, setShowImport] = useState(false);
// Export functionality handled by direct download
const {
init,
getCurrentWord,
rateWord,
flipCard,
isFlipped,
stats,
getDueWords,
addWords,
exportData,
speak,
isLoading,
} = useAppStore();
useEffect(() => {
init();
}, [init]);
const currentWord = getCurrentWord();
const dueWords = getDueWords();
const handleExport = async () => {
const data = await exportData();
const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = `french-vocab-backup-${new Date().toISOString().split('T')[0]}.json`;
a.click();
URL.revokeObjectURL(url);
};
if (isLoading) {
return (
<div className="min-h-screen bg-gradient-to-br from-blue-50 to-indigo-100 flex items-center justify-center">
<div className="flex items-center gap-3 text-indigo-600">
<div className="w-8 h-8 border-4 border-indigo-200 border-t-indigo-600 rounded-full animate-spin" />
<span className="text-xl font-semibold">Loading...</span>
</div>
</div>
);
}
if (!currentWord) {
return (
<div className="min-h-screen bg-gradient-to-br from-emerald-50 to-teal-100 flex flex-col items-center justify-center p-4">
<div className="bg-white rounded-3xl shadow-2xl p-10 max-w-md w-full text-center">
<div className="w-20 h-20 bg-gradient-to-br from-yellow-400 to-orange-500 rounded-full flex items-center justify-center mx-auto mb-6 shadow-lg">
<svg className="w-10 h-10 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
</svg>
</div>
<h2 className="text-3xl font-bold text-gray-800 mb-3">Well Done!</h2>
<p className="text-gray-600 mb-8">You have completed all due words for today.</p>
<div className="grid grid-cols-2 gap-4 mb-8">
<div className="bg-gradient-to-br from-blue-50 to-blue-100 p-4 rounded-2xl">
<div className="text-3xl font-bold text-blue-600">{stats.todayStudied}</div>
<div className="text-sm text-gray-500 mt-1">Studied Today</div>
</div>
<div className="bg-gradient-to-br from-emerald-50 to-emerald-100 p-4 rounded-2xl">
<div className="text-3xl font-bold text-emerald-600">{stats.totalWords}</div>
<div className="text-sm text-gray-500 mt-1">Total Words</div>
</div>
</div>
<div className="flex gap-3">
<button
onClick={() => window.location.reload()}
className="flex-1 bg-gradient-to-r from-blue-500 to-indigo-600 text-white font-bold py-3 rounded-2xl shadow-lg hover:shadow-xl transition-all"
>
Continue
</button>
<button
onClick={() => setShowImport(true)}
className="px-4 py-3 border-2 border-blue-500 text-blue-600 rounded-2xl hover:bg-blue-50 transition-colors"
>
Import
</button>
</div>
</div>
<ImportModal
isOpen={showImport}
onClose={() => setShowImport(false)}
onImport={addWords}
/>
</div>
);
}
return (
<div className="min-h-screen bg-gradient-to-br from-sky-50 via-blue-50 to-indigo-100 py-8 px-4">
<div className="max-w-2xl mx-auto">
{/* Header */}
<header className="mb-8">
<div className="flex items-center justify-between mb-4">
<div className="inline-flex items-center gap-2 bg-white/80 backdrop-blur-sm px-4 py-2 rounded-full shadow-sm">
<span className="text-2xl">🇫🇷</span>
<span className="text-gray-600 font-medium">French Vocabulary</span>
</div>
<div className="flex gap-2">
<button
onClick={() => setShowImport(true)}
className="p-2 bg-white/80 rounded-full shadow-sm hover:bg-white transition-colors"
title="导入词库"
>
<svg className="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-8l-4-4m0 0L8 8m4-4v12" />
</svg>
</button>
<button
onClick={handleExport}
className="p-2 bg-white/80 rounded-full shadow-sm hover:bg-white transition-colors"
title="导出备份"
>
<svg className="w-5 h-5 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
</svg>
</button>
</div>
</div>
<h1 className="text-4xl font-bold text-gray-800 mb-2">Master French</h1>
<p className="text-gray-500">Learn with spaced repetition</p>
</header>
{/* Stats */}
<div className="grid grid-cols-3 gap-4 mb-6">
<div className="bg-white rounded-2xl p-4 shadow-lg text-center">
<div className="text-3xl font-bold text-blue-500">{stats.todayStudied}</div>
<div className="text-xs text-gray-400 uppercase tracking-wide mt-1">Today</div>
</div>
<div className="bg-white rounded-2xl p-4 shadow-lg text-center">
<div className="text-3xl font-bold text-emerald-500">{dueWords.length}</div>
<div className="text-xs text-gray-400 uppercase tracking-wide mt-1">Due</div>
</div>
<div className="bg-white rounded-2xl p-4 shadow-lg text-center">
<div className="text-3xl font-bold text-purple-500">{stats.totalWords}</div>
<div className="text-xs text-gray-400 uppercase tracking-wide mt-1">Total</div>
</div>
</div>
{/* Progress */}
<div className="mb-8">
<ProgressBar
current={stats.todayStudied}
total={20}
label="Daily Goal"
/>
</div>
{/* Flash Card */}
<div className="mb-6">
<FlashCard
word={currentWord}
onFlip={flipCard}
onSpeak={speak}
/>
</div>
{/* Instructions */}
{!isFlipped && (
<div className="text-center mb-6">
<span className="inline-flex items-center gap-2 bg-white/70 backdrop-blur-sm px-4 py-2 rounded-full text-gray-500 text-sm">
<svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 15l-2 5L9 9l11 4-5 2zm0 0l5 5M7.188 2.239l.777 2.897M5.136 7.965l-2.898-.777M13.95 4.05l-2.122 2.122m-5.657 5.656l-2.12 2.122" />
</svg>
Click card to reveal answer
</span>
</div>
)}
{/* Rating Buttons */}
{isFlipped && (
<RatingButtons onRate={rateWord} />
)}
{/* Footer */}
<footer className="mt-12 text-center">
<div className="inline-flex items-center gap-2 bg-white/60 backdrop-blur-sm px-4 py-2 rounded-full text-sm text-gray-400">
<svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 10V3L4 14h7v7l9-11h-7z" />
</svg>
Powered by SM-2 Algorithm Data persisted locally
</div>
</footer>
</div>
<ImportModal
isOpen={showImport}
onClose={() => setShowImport(false)}
onImport={addWords}
/>
</div>
);
}
export default App;

1
src/assets/react.svg Normal file
View File

@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

After

Width:  |  Height:  |  Size: 4.0 KiB

View File

@@ -0,0 +1,98 @@
import { useState } from 'react';
import type { Word } from '../types/vocabulary';
interface FlashCardProps {
word: Word;
onFlip?: (isFlipped: boolean) => void;
onSpeak?: (text: string) => void;
}
export function FlashCard({ word, onFlip, onSpeak }: FlashCardProps) {
const [isFlipped, setIsFlipped] = useState(false);
const handleFlip = () => {
const newState = !isFlipped;
setIsFlipped(newState);
onFlip?.(newState);
};
const handleSpeak = (e: React.MouseEvent) => {
e.stopPropagation();
onSpeak?.(word.french);
};
return (
<div
className="relative w-full h-96 cursor-pointer group"
style={{ perspective: '1000px' }}
onClick={handleFlip}
>
<div
className="relative w-full h-full transition-all duration-500 ease-out"
style={{
transformStyle: 'preserve-3d',
transform: isFlipped ? 'rotateY(180deg)' : 'rotateY(0deg)'
}}
>
{/* Front */}
<div
className="absolute inset-0 bg-gradient-to-br from-sky-400 via-blue-500 to-indigo-600 rounded-3xl shadow-2xl flex flex-col items-center justify-center p-8 text-white border-4 border-white/30"
style={{ backfaceVisibility: 'hidden' }}
>
<div className="absolute top-4 right-4">
<span className="bg-white/20 backdrop-blur-sm px-3 py-1 rounded-full text-xs font-medium">
{word.category}
</span>
</div>
{/* Speak Button */}
<button
onClick={handleSpeak}
className="absolute top-4 left-4 p-2 bg-white/20 backdrop-blur-sm rounded-full hover:bg-white/30 transition-colors"
title="播放发音"
>
<svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15.536 8.464a5 5 0 010 7.072m2.828-9.9a9 9 0 010 12.728M5.586 15H4a1 1 0 01-1-1v-4a1 1 0 011-1h1.586l4.707-4.707C10.923 3.663 12 4.109 12 5v14c0 .891-1.077 1.337-1.707.707L5.586 15z" />
</svg>
</button>
<div className="text-center">
<h2 className="text-6xl font-bold mb-4 drop-shadow-lg">{word.french}</h2>
{word.pronunciation && (
<span className="text-xl opacity-90 font-light tracking-wide">/{word.pronunciation}/</span>
)}
</div>
<div className="absolute bottom-8 flex items-center gap-2 text-white/70">
<svg className="w-5 h-5 animate-bounce" fill="none" stroke="currentColor" viewBox="0 0 24 24">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M15 15l-2 5L9 9l11 4-5 2zm0 0l5 5M7.188 2.239l.777 2.897M5.136 7.965l-2.898-.777M13.95 4.05l-2.122 2.122m-5.657 5.656l-2.12 2.122" />
</svg>
<span className="text-sm font-medium"></span>
</div>
</div>
{/* Back */}
<div
className="absolute inset-0 bg-gradient-to-br from-emerald-400 via-teal-500 to-cyan-600 rounded-3xl shadow-2xl flex flex-col items-center justify-center p-8 text-white border-4 border-white/30"
style={{
backfaceVisibility: 'hidden',
transform: 'rotateY(180deg)'
}}
>
<div className="text-center space-y-4">
<h3 className="text-4xl font-bold drop-shadow-lg">{word.english}</h3>
{word.example && (
<div className="mt-6 bg-white/10 backdrop-blur-sm rounded-2xl p-6 max-w-md">
<p className="text-lg italic mb-3 leading-relaxed">&quot;{word.example}&quot;</p>
{word.exampleTranslation && (
<p className="text-sm opacity-80 border-t border-white/20 pt-3">{word.exampleTranslation}</p>
)}
</div>
)}
</div>
</div>
</div>
</div>
);
}

View File

@@ -0,0 +1,137 @@
import { useState, useRef } from 'react';
interface ImportModalProps {
isOpen: boolean;
onClose: () => void;
onImport: (words: any[]) => void;
}
export function ImportModal({ isOpen, onClose, onImport }: ImportModalProps) {
const [content, setContent] = useState('');
const [error, setError] = useState('');
const fileInputRef = useRef<HTMLInputElement>(null);
if (!isOpen) return null;
const handleFileUpload = (e: React.ChangeEvent<HTMLInputElement>) => {
const file = e.target.files?.[0];
if (!file) return;
const reader = new FileReader();
reader.onload = (event) => {
const text = event.target?.result as string;
setContent(text);
parseContent(text);
};
reader.readAsText(file);
};
const parseContent = (text: string) => {
try {
// Try JSON first
const json = JSON.parse(text);
if (Array.isArray(json)) {
onImport(json);
onClose();
return;
}
if (json.words && Array.isArray(json.words)) {
onImport(json.words);
onClose();
return;
}
} catch {
// Not JSON, try CSV
const lines = text.trim().split('\n');
const words = lines.map((line, index) => {
const parts = line.split(',').map(p => p.trim());
return {
id: `imported-${Date.now()}-${index}`,
french: parts[0] || '',
english: parts[1] || '',
pronunciation: parts[2] || '',
category: parts[3] || 'General',
difficulty: 'beginner',
};
}).filter(w => w.french && w.english);
if (words.length > 0) {
onImport(words);
onClose();
} else {
setError('无法解析文件格式');
}
}
};
const handleSubmit = () => {
if (!content.trim()) {
setError('请输入内容');
return;
}
parseContent(content);
};
return (
<div className="fixed inset-0 bg-black/50 backdrop-blur-sm flex items-center justify-center z-50 p-4">
<div className="bg-white rounded-3xl shadow-2xl max-w-lg w-full p-6">
<h2 className="text-2xl font-bold text-gray-800 mb-4"></h2>
<div className="space-y-4">
<div>
<label className="block text-sm font-medium text-gray-600 mb-2">
(CSV JSON)
</label>
<input
ref={fileInputRef}
type="file"
accept=".csv,.json"
onChange={handleFileUpload}
className="w-full px-4 py-2 border border-gray-200 rounded-xl focus:outline-none focus:ring-2 focus:ring-blue-500"
/>
</div>
<div className="relative">
<div className="absolute inset-0 flex items-center">
<div className="w-full border-t border-gray-200"></div>
</div>
<div className="relative flex justify-center text-sm">
<span className="px-2 bg-white text-gray-500"></span>
</div>
</div>
<textarea
value={content}
onChange={(e) => setContent(e.target.value)}
placeholder={`CSV 格式:
french,english,pronunciation,category
Bonjour,Hello,bɔ̃ʒuʁ,Greetings
JSON 格式:
[{"french": "Bonjour", "english": "Hello"}]`}
className="w-full h-40 px-4 py-3 border border-gray-200 rounded-xl focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono text-sm"
/>
{error && (
<p className="text-red-500 text-sm">{error}</p>
)}
<div className="flex gap-3 pt-2">
<button
onClick={onClose}
className="flex-1 px-4 py-3 border border-gray-200 rounded-xl text-gray-600 hover:bg-gray-50 transition-colors"
>
</button>
<button
onClick={handleSubmit}
className="flex-1 px-4 py-3 bg-gradient-to-r from-blue-500 to-indigo-600 text-white rounded-xl hover:shadow-lg transition-all"
>
</button>
</div>
</div>
</div>
</div>
);
}

View File

@@ -0,0 +1,31 @@
interface ProgressBarProps {
current: number;
total: number;
label?: string;
}
export function ProgressBar({ current, total, label }: ProgressBarProps) {
const percentage = Math.min(Math.round((current / total) * 100), 100);
return (
<div className="bg-white rounded-2xl p-4 shadow-lg">
<div className="flex justify-between items-center mb-3">
{label && (
<span className="text-gray-600 font-medium">{label}</span>
)}
<span className="text-2xl font-bold text-indigo-600">
{current}<span className="text-gray-400 text-lg">/{total}</span>
</span>
</div>
<div className="w-full bg-gray-100 rounded-full h-4 overflow-hidden">
<div
className="h-full bg-gradient-to-r from-blue-400 via-indigo-500 to-purple-500 rounded-full transition-all duration-500 ease-out"
style={{ width: `${percentage}%` }}
/>
</div>
<div className="text-right mt-2">
<span className="text-sm font-medium text-indigo-500">{percentage}%</span>
</div>
</div>
);
}

View File

@@ -0,0 +1,58 @@
import type { DifficultyRating } from '../types/vocabulary';
interface RatingButtonsProps {
onRate: (rating: DifficultyRating) => void;
disabled?: boolean;
}
export function RatingButtons({ onRate, disabled }: RatingButtonsProps) {
const buttons = [
{
rating: 'again' as DifficultyRating,
label: '重来',
sublabel: '< 1 min',
color: 'from-rose-400 to-red-500',
shadow: 'shadow-rose-200'
},
{
rating: 'hard' as DifficultyRating,
label: '困难',
sublabel: '~ 2 days',
color: 'from-orange-400 to-amber-500',
shadow: 'shadow-orange-200'
},
{
rating: 'good' as DifficultyRating,
label: '良好',
sublabel: '~ 4 days',
color: 'from-blue-400 to-indigo-500',
shadow: 'shadow-blue-200'
},
{
rating: 'easy' as DifficultyRating,
label: '简单',
sublabel: '~ 7 days',
color: 'from-emerald-400 to-teal-500',
shadow: 'shadow-emerald-200'
},
];
return (
<div className="grid grid-cols-4 gap-3 mt-8">
{buttons.map(({ rating, label, sublabel, color, shadow }) => (
<button
key={rating}
onClick={() => onRate(rating)}
disabled={disabled}
className={`group relative overflow-hidden bg-gradient-to-b ${color} ${shadow} shadow-lg hover:shadow-xl text-white rounded-2xl py-4 px-2 transition-all duration-200 hover:-translate-y-1 disabled:opacity-50 disabled:cursor-not-allowed disabled:hover:translate-y-0`}
>
<div className="relative z-10 flex flex-col items-center">
<span className="text-lg font-bold">{label}</span>
<span className="text-xs opacity-80 mt-1">{sublabel}</span>
</div>
<div className="absolute inset-0 bg-white/20 opacity-0 group-hover:opacity-100 transition-opacity" />
</button>
))}
</div>
);
}

91
src/db/database.ts Normal file
View File

@@ -0,0 +1,91 @@
import Dexie, { type Table } from 'dexie';
import type { Word, StudyProgress, StudyStats } from '../types/vocabulary';
export interface WordEntry extends Word {
addedAt: Date;
}
export interface ProgressEntry extends StudyProgress {
syncedAt?: Date;
}
export class FrenchVocabDB extends Dexie {
words!: Table<WordEntry>;
progress!: Table<ProgressEntry>;
stats!: Table<StudyStats & { id: string }>;
settings!: Table<{ key: string; value: any }>;
constructor() {
super('FrenchVocabDB');
this.version(1).stores({
words: '++id, category, difficulty, addedAt',
progress: 'wordId, nextReviewDate, lastStudiedDate',
stats: 'id',
settings: 'key',
});
}
}
export const db = new FrenchVocabDB();
// 初始化默认数据
export async function initDatabase() {
const count = await db.words.count();
if (count === 0) {
// 添加示例单词
const defaultWords: WordEntry[] = [
{
id: '1',
french: 'Bonjour',
pronunciation: 'bɔ̃ʒuʁ',
english: 'Hello',
example: 'Bonjour, comment allez-vous?',
exampleTranslation: 'Hello, how are you?',
category: 'Greetings',
difficulty: 'beginner',
addedAt: new Date(),
},
{
id: '2',
french: 'Merci',
pronunciation: 'mɛʁsi',
english: 'Thank you',
example: 'Merci beaucoup pour votre aide.',
exampleTranslation: 'Thank you very much for your help.',
category: 'Greetings',
difficulty: 'beginner',
addedAt: new Date(),
},
];
await db.words.bulkAdd(defaultWords);
}
}
// 导出数据
export async function exportData() {
const words = await db.words.toArray();
const progress = await db.progress.toArray();
const stats = await db.stats.get('main');
return {
words,
progress,
stats,
exportedAt: new Date().toISOString(),
};
}
// 导入数据
export async function importData(data: any) {
if (data.words) {
await db.words.clear();
await db.words.bulkAdd(data.words);
}
if (data.progress) {
await db.progress.clear();
await db.progress.bulkAdd(data.progress);
}
if (data.stats) {
await db.stats.put({ ...data.stats, id: 'main' });
}
}

17
src/index.css Normal file
View File

@@ -0,0 +1,17 @@
@import "tailwindcss";
:root {
--primary: #3b82f6;
--primary-light: #60a5fa;
--secondary: #8b5cf6;
--accent: #f59e0b;
--success: #10b981;
--warning: #fbbf24;
--danger: #ef4444;
--bg-warm: #fffbeb;
--bg-cool: #eff6ff;
}
body {
font-family: 'Inter', system-ui, -apple-system, sans-serif;
}

10
src/main.tsx Normal file
View File

@@ -0,0 +1,10 @@
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.tsx'
createRoot(document.getElementById('root')!).render(
<StrictMode>
<App />
</StrictMode>,
)

182
src/stores/appStore.ts Normal file
View File

@@ -0,0 +1,182 @@
import { create } from 'zustand';
import type { Word, StudyProgress, StudyStats, DifficultyRating } from '../types/vocabulary';
import { calculateNextReview } from '../utils/srs';
import { db, initDatabase, exportData, importData } from '../db/database';
interface AppState {
words: Word[];
progress: Map<string, StudyProgress>;
stats: StudyStats;
currentWordIndex: number;
isFlipped: boolean;
isLoading: boolean;
// Actions
init: () => Promise<void>;
setWords: (words: Word[]) => void;
addWords: (words: Word[]) => Promise<void>;
flipCard: () => void;
rateWord: (rating: DifficultyRating) => Promise<void>;
nextWord: () => void;
getCurrentWord: () => Word | null;
getDueWords: () => Word[];
exportData: () => Promise<any>;
importData: (data: any) => Promise<void>;
speak: (text: string) => void;
}
export const useAppStore = create<AppState>((set, get) => ({
words: [],
progress: new Map(),
stats: {
totalWords: 0,
masteredWords: 0,
studyingWords: 0,
streakDays: 0,
todayStudied: 0,
todayNewWords: 0,
},
currentWordIndex: 0,
isFlipped: false,
isLoading: true,
init: async () => {
await initDatabase();
// Load words from DB
const wordsFromDB = await db.words.toArray();
// Load progress from DB
const progressFromDB = await db.progress.toArray();
const progressMap = new Map<string, StudyProgress>();
progressFromDB.forEach(p => progressMap.set(p.wordId, p));
// Load stats from DB
const statsFromDB = await db.stats.get('main');
set({
words: wordsFromDB,
progress: progressMap,
stats: statsFromDB || {
totalWords: wordsFromDB.length,
masteredWords: 0,
studyingWords: 0,
streakDays: 0,
todayStudied: 0,
todayNewWords: 0,
},
isLoading: false,
});
},
setWords: (words) => set({
words,
stats: { ...get().stats, totalWords: words.length }
}),
addWords: async (newWords) => {
const wordsWithDate = newWords.map(w => ({ ...w, addedAt: new Date() }));
await db.words.bulkAdd(wordsWithDate);
const allWords = await db.words.toArray();
set({
words: allWords,
stats: { ...get().stats, totalWords: allWords.length }
});
},
flipCard: () => set((state) => ({ isFlipped: !state.isFlipped })),
rateWord: async (rating) => {
const state = get();
const currentWord = state.getCurrentWord();
if (!currentWord) return;
const existingProgress = state.progress.get(currentWord.id);
const newProgress = calculateNextReview(
existingProgress || {
wordId: currentWord.id,
interval: 0,
repetitions: 0,
easeFactor: 2.5,
nextReviewDate: new Date(),
lastStudiedDate: new Date(),
},
rating
);
// Save to IndexedDB
await db.progress.put(newProgress);
const newProgressMap = new Map(state.progress);
newProgressMap.set(currentWord.id, newProgress);
const newStats = {
...state.stats,
todayStudied: state.stats.todayStudied + 1,
};
await db.stats.put({ ...newStats, id: 'main' });
set({
progress: newProgressMap,
isFlipped: false,
stats: newStats,
});
setTimeout(() => get().nextWord(), 300);
},
nextWord: () => {
const state = get();
const dueWords = state.getDueWords();
if (dueWords.length === 0) {
set({ currentWordIndex: -1 });
return;
}
const nextIndex = state.words.findIndex(w => w.id === dueWords[0].id);
set({
currentWordIndex: nextIndex,
isFlipped: false
});
},
getCurrentWord: () => {
const state = get();
if (state.currentWordIndex < 0 || state.currentWordIndex >= state.words.length) {
return null;
}
return state.words[state.currentWordIndex];
},
getDueWords: () => {
const state = get();
const now = new Date();
return state.words.filter((word) => {
const progress = state.progress.get(word.id);
if (!progress) return true;
return new Date(progress.nextReviewDate) <= now;
});
},
exportData: async () => {
return await exportData();
},
importData: async (data) => {
await importData(data);
await get().init();
},
speak: (text: string) => {
if ('speechSynthesis' in window) {
const utterance = new SpeechSynthesisUtterance(text);
utterance.lang = 'fr-FR';
utterance.rate = 0.8;
window.speechSynthesis.speak(utterance);
}
},
}));

30
src/types/vocabulary.ts Normal file
View File

@@ -0,0 +1,30 @@
export interface Word {
id: string;
french: string;
pronunciation?: string;
english: string;
example?: string;
exampleTranslation?: string;
category: string;
difficulty: 'beginner' | 'intermediate' | 'advanced';
}
export interface StudyProgress {
wordId: string;
interval: number;
repetitions: number;
easeFactor: number;
nextReviewDate: Date;
lastStudiedDate: Date;
}
export interface StudyStats {
totalWords: number;
masteredWords: number;
studyingWords: number;
streakDays: number;
todayStudied: number;
todayNewWords: number;
}
export type DifficultyRating = 'again' | 'hard' | 'good' | 'easy';

46
src/utils/srs.ts Normal file
View File

@@ -0,0 +1,46 @@
import type { StudyProgress, DifficultyRating } from '../types/vocabulary';
export function calculateNextReview(
progress: StudyProgress,
rating: DifficultyRating
): StudyProgress {
const newProgress = { ...progress };
switch (rating) {
case 'again':
newProgress.interval = 1;
newProgress.repetitions = 0;
newProgress.easeFactor = Math.max(1.3, progress.easeFactor - 0.2);
break;
case 'hard':
newProgress.interval = Math.round(progress.interval * 1.2);
newProgress.repetitions += 1;
newProgress.easeFactor = Math.max(1.3, progress.easeFactor - 0.15);
break;
case 'good':
if (progress.repetitions === 0) {
newProgress.interval = 1;
} else if (progress.repetitions === 1) {
newProgress.interval = 6;
} else {
newProgress.interval = Math.round(progress.interval * progress.easeFactor);
}
newProgress.repetitions += 1;
break;
case 'easy':
if (progress.repetitions === 0) {
newProgress.interval = 4;
} else {
newProgress.interval = Math.round(progress.interval * progress.easeFactor * 1.3);
}
newProgress.repetitions += 1;
newProgress.easeFactor += 0.15;
break;
}
const now = new Date();
newProgress.nextReviewDate = new Date(now.getTime() + newProgress.interval * 24 * 60 * 60 * 1000);
newProgress.lastStudiedDate = now;
return newProgress;
}

11
tailwind.config.js Normal file
View File

@@ -0,0 +1,11 @@
/** @type {import('tailwindcss').Config} */
export default {
content: [
"./index.html",
"./src/**/*.{js,ts,jsx,tsx}",
],
theme: {
extend: {},
},
plugins: [],
}

28
tsconfig.app.json Normal file
View File

@@ -0,0 +1,28 @@
{
"compilerOptions": {
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
"target": "ES2022",
"useDefineForClassFields": true,
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"module": "ESNext",
"types": ["vite/client"],
"skipLibCheck": true,
/* Bundler mode */
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"verbatimModuleSyntax": true,
"moduleDetection": "force",
"noEmit": true,
"jsx": "react-jsx",
/* Linting */
"strict": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"erasableSyntaxOnly": true,
"noFallthroughCasesInSwitch": true,
"noUncheckedSideEffectImports": true
},
"include": ["src"]
}

7
tsconfig.json Normal file
View File

@@ -0,0 +1,7 @@
{
"files": [],
"references": [
{ "path": "./tsconfig.app.json" },
{ "path": "./tsconfig.node.json" }
]
}

26
tsconfig.node.json Normal file
View File

@@ -0,0 +1,26 @@
{
"compilerOptions": {
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
"target": "ES2023",
"lib": ["ES2023"],
"module": "ESNext",
"types": ["node"],
"skipLibCheck": true,
/* Bundler mode */
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"verbatimModuleSyntax": true,
"moduleDetection": "force",
"noEmit": true,
/* Linting */
"strict": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"erasableSyntaxOnly": true,
"noFallthroughCasesInSwitch": true,
"noUncheckedSideEffectImports": true
},
"include": ["vite.config.ts"]
}

32
vite.config.ts Normal file
View File

@@ -0,0 +1,32 @@
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import { VitePWA } from 'vite-plugin-pwa'
export default defineConfig({
plugins: [
react(),
VitePWA({
registerType: 'autoUpdate',
manifest: {
name: 'French Vocabulary',
short_name: 'FrenchVocab',
description: 'Master French with spaced repetition',
theme_color: '#3b82f6',
background_color: '#ffffff',
display: 'standalone',
icons: [
{
src: '/icon-192.png',
sizes: '192x192',
type: 'image/png'
},
{
src: '/icon-512.png',
sizes: '512x512',
type: 'image/png'
}
]
}
})
],
})