Compare commits

...
33 Commits
Author SHA1 Message Date
poli0981 61281c5815 Merge pull request #102 from poli0981/claude/v0.28.0
feat(legal): first-run consent gate + Windows installer license — v0.28.0
2026-06-13 21:28:18 +07:00
poli0981andClaude Opus 4.8 7caf4180e9 chore(release): bump manifests to 0.28.0
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 21:26:37 +07:00
poli0981andClaude Opus 4.8 521ca559d5 docs(legal): document consent gate in CHANGELOG, FEATURES, PACKAGING, PRIVACY
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 21:26:36 +07:00
poli0981andClaude Opus 4.8 2f84586cf1 feat(legal): add first-run consent gate + Windows installer license
Render a full-screen, non-dismissible consent gate in place of the router
until the user reviews the legal docs (Terms/Privacy/Disclaimer/License,
linked to the GitHub copies) and ticks one 'I agree' box. Acceptance is
recorded in the settings store (legalConsentVersion + timestamp) — no
cookie, no new storage key — and re-prompts only when CURRENT_TERMS_VERSION
is raised, so it is one-time in normal use and re-appears in fresh/incognito
storage.

Also: surface all four docs in About -> Legal (only License was linked
before); add a Windows MSI/NSIS installer license page via bundle.licenseFile;
add an accessible Checkbox primitive; and apply the persisted theme on boot
in main.tsx (fixes a pre-existing dark flash for light-theme users, and makes
the gate render in the right theme before the app shell mounts).

Consent state is additive (no persist version bump); healSettings coerces a
malformed value to 0 so a corrupt file re-shows the gate. 60 new locale
strings (10 keys x 6 languages); validator now 937 ui keys. +9 tests (500 ->
509).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 21:26:00 +07:00
poli0981 6f95d292e6 Merge pull request #100 from poli0981/claude/hopeful-mirzakhani-8581d4
chore(deps): upgrade vite 7→8 to patch esbuild advisories (v0.27.1)
2026-06-13 19:46:49 +07:00
poli0981andClaude Opus 4.8 9554dcc7af chore(deps): upgrade vite 7->8 to patch esbuild advisories (v0.27.1)
Resolves the 4 high-severity esbuild advisories (GHSA-gv7w-rqvm-qjhr,
GHSA-g7r4-m6w7-qqqr) deferred from v0.27.0. esbuild 0.17.0-0.28.0 is
vulnerable; the fix (0.28.1) is only reachable via vite 8 -- vite 7.3.3
pins esbuild ^0.27.0 and cannot reach it. Dev-server-only; the shipped
static bundle was never affected. npm audit: 4 high -> 0.

- vite ^7.3.3 -> ^8.0.16, @vitejs/plugin-react ^4.3.0 -> ^5.2.0,
  tsx ^4.16.0 -> ^4.22.4 (vitest 4.1.8 already supports vite 8)
- vite 8 bundles with Rolldown: manualChunks object form -> function
  form (vite.config.ts) is the only source change required
- Full gate chain green (typecheck, lint, knip, validate:locales,
  500/500 tests, build); dev/preview + Tauri-context build verified
- Bump 5 manifests 0.27.0 -> 0.27.1; CHANGELOG + stack-version docs

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:43:39 +07:00
poli0981 3c667fa8d3 Merge pull request #98 from poli0981/claude/adoring-wilbur-9b3de5
feat(errors): error pages (404/403/419/500) + offline detection — v0.27.0
2026-06-13 19:06:50 +07:00
poli0981andClaude Opus 4.8 03d430d49a chore(release): bump manifests to 0.27.0
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:04:41 +07:00
poli0981andClaude Opus 4.8 114c8d1ec6 docs(errors): document error pages in CHANGELOG, FEATURES, ARCHITECTURE
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:04:33 +07:00
poli0981andClaude Opus 4.8 12b17dbed0 feat(errors): add internationalized error pages + offline detection
Add a reusable, router-agnostic ErrorPage (404/403/419/500/offline/runtime)
driven by a pure config/error-pages.ts kind->meta map. Wire standalone
error routes (/403, /419, /500, /offline) plus a catch-all '*' -> 404 as
siblings of the AppShell group, so they render full-screen with no shell —
closing the long-standing gap where unknown hash routes rendered blank.

Add a navigator.onLine hook + non-blocking, dismissible OfflineBanner (the
app works fully offline, so it never blocks input). Redesign the
ErrorBoundary fallback to reuse ErrorPage's 'contained' runtime variant, so
render crashes share the same localized visual language.

120 new locale strings (20 keys x 6 languages) + _schema.json; validator
now expects 927 ui keys per locale. +6 pure config tests (494 -> 500).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:04:02 +07:00
poli0981 10ac1764b4 Merge pull request #94 from poli0981/claude/fervent-feynman-42a586
ci(dependabot): ignore unfixable transitive cargo advisories (rand, glib)
2026-06-12 13:35:28 +07:00
poli0981 107efcb0fa Merge pull request #96 from poli0981/claude/clever-wing-ce2a1f
ci(node): bump workflows from EOL Node 20 to Node 22 LTS
2026-06-12 08:52:10 +07:00
poli0981andClaude Fable 5 12c2fcd01c ci(node): bump workflows from EOL Node 20 to Node 22 LTS
Node 20 reached end-of-life in April 2026 and GitHub is removing it
from runner images (actions/runner-images#14029), so setup-node now
downloads it on every run. Node 22 satisfies Vite 7's engine range
(^20.19 || >=22.12) and matches the docs/TECH-SPEC.md snippets.
Also sync the two doc mentions of CI's Node version.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:49:20 +07:00
poli0981 9faa192ec4 Merge pull request #95 from poli0981/claude/admiring-snyder-a5292f
ci(actions): bump workflow actions to Node 24 majors before June 16 forced migration
2026-06-12 08:43:34 +07:00
poli0981andClaude Fable 5 211d2d8364 ci(test): drop temporary vs2026 build check, record verification
Build-only run 27388695090 on windows-2025-vs2026 produced both MSI
and NSIS bundles cleanly, so windows-latest stays unpinned.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:42:25 +07:00
poli0981andClaude Fable 5 2f50658d89 docs(tech-spec): sync workflow snippets with Node 24 action majors
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:35:17 +07:00
poli0981andClaude Fable 5 bbeae33506 ci(test): temporary build-only check on windows-2025-vs2026
windows-latest redirects to this image from June 15, 2026. Build-only
(no tagName), so no release is touched. Reverted before merge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:33:33 +07:00
poli0981andClaude Fable 5 0d4f1c7800 ci(actions): bump checkout/setup-node/pages actions to Node 24 majors
GitHub forces the Node 24 runtime for actions on June 16, 2026 and
removes Node 20 from runners September 16, 2026. checkout v4,
setup-node v4, configure-pages v5, upload-pages-artifact v3 and
deploy-pages v4 all declare node20; their current majors (v6/v6/v6/
v5/v5) declare node24. tauri-action@v0 already runs node24 and
dtolnay/rust-toolchain is composite, so both stay.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:33:33 +07:00
poli0981andClaude Fable 5 7ae5da629a ci(dependabot): ignore unfixable transitive cargo advisories (rand, glib)
Dependabot cargo security-update jobs for rand and glib fail with
security_update_not_possible every time Cargo.lock changes on main
(runs 27387346373, 27387346324). Both are transitive deps of tauri:
rand 0.7.3 is pinned to ^0.7 by phf_generator 0.8 (via kuchikiki),
fix is 0.8.6; glib 0.18.5 is pinned by the gtk-rs 0.18 stack, fix is
0.20.0. Cargo cannot resolve the patched versions until tauri bumps
those subtrees, so ignore both to stop the recurring red runs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:31:52 +07:00
poli0981 c02464cafb Merge pull request #92 from poli0981/claude/v0.26.0
feat(v0.26.0): lazy-load locale bundles per language
2026-06-12 07:55:15 +07:00
poli0981andClaude Fable 5 c78e49d08b chore(release): bump manifests to 0.26.0
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:53:20 +07:00
poli0981andClaude Fable 5 6f87dfc254 docs(i18n): document lazy-loaded locales in CHANGELOG, I18N, ARCHITECTURE, DEVELOPMENT
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:53:19 +07:00
poli0981andClaude Fable 5 820bbb9369 feat(i18n): lazy-load locale bundles per language
Only English ships in the main chunk (fallbackLng + the engine's
bilingual tEn must resolve synchronously); the 10 non-English locale
JSONs become Vite async chunks fetched on first use via
i18next-resources-to-backend. Main chunk: 594.0 -> 264.0 kB min
(204.3 -> 82.0 kB gzip), back under the 500 kB warning threshold.

Every reactive getFixedT site gates on the new useLanguagesReady hook
(an unloaded language would silently render English — and OutputPage
would save that as a wrong-language history entry); Batch/Social bulk
handlers preload all selected languages before their loops; main.tsx
preloads the persisted UI + output languages before first paint. A
failed chunk fetch is retried once via direct import (i18next pins
failed languages permanently), then logged, degrading to English.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:52:27 +07:00
poli0981 b522540614 Merge pull request #90 from poli0981/claude/v0.25.0
feat(v0.25.0): +41 content warnings (dialogue + internet/digital groups), inventory docs backfill
2026-06-10 21:47:21 +07:00
poli0981andClaude Fable 5 b8317c2151 feat(v0.25.0): +41 content warnings (dialogue + internet/digital groups), inventory docs backfill
Two new warning groups — Dialogue / Language (10) and Internet / Digital
life (18) — plus 5 color phobias, 5 suggestive-imagery disclosures, 2
body-image phenomena, and an educational/PSA-purpose disclosure: 207 -> 248
ids across 12 groups. 504 new locale strings (84 keys x 6 locales), VI
flag-prone labels masked per the v0.21.0 precedent. Backfills the
content-inventory docs (audio group + v0.23.0 VFX items were never
documented) and replaces the stale v0.7 warning lines in FEATURES.md.
Adds 8 tests incl. a CONTENT_WARNINGS <-> groups parity guard. Five
manifests bumped 0.24.2 -> 0.25.0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 21:44:45 +07:00
poli0981 69ede56493 Merge pull request #88 from poli0981/claude/v0.24.2
ci(v0.24.2): harden Linux AppImage build, rebuild to ship Linux binaries
2026-06-08 14:21:24 +07:00
poli0981andClaude Opus 4.8 8569e1f81b ci(v0.24.2): harden Linux AppImage build, rebuild to ship Linux binaries
v0.24.1's Linux job failed on a sustained upstream GitHub-CDN 504 while the AppImage bundler fetched linuxdeploy, so v0.24.1 shipped with only Windows + macOS binaries. Set APPIMAGE_EXTRACT_AND_RUN=1 + NO_STRIP=true on the tauri-action step (fixes the linuxdeploy FUSE run-failure mode + future resilience; no-op on Win/macOS) and bump to 0.24.2 to re-run the full matrix. No application code changes — identical app to v0.24.1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 14:20:26 +07:00
poli0981 7a5b1f9e87 Merge pull request #85 from poli0981/claude/v0.24.1
chore(v0.24.1): clear npm audit, drop unused Cargo deps, document cross-post generator
2026-06-08 13:27:34 +07:00
poli0981andClaude Opus 4.8 c29e04b15f chore(v0.24.1): clear npm audit, drop unused Cargo deps, document cross-post generator
Security/deps: react-router 6.30.3→6.30.4 (moderate open-redirect patch, non-breaking) and vitest 3.2.4→4.1.8 (clears the dev-only critical Vitest-UI advisory); all 482 tests pass unchanged on the new major. npm audit now reports 0 vulnerabilities. Removed unused serde/serde_json from src-tauri/Cargo.toml (no refs in src-tauri/src/; cargo check confirms the crate still compiles). Documented the cross-post caption generator (Social tab) in README + docs/FEATURES.md. Five manifests bumped 0.24.0→0.24.1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 13:26:47 +07:00
poli0981 23bec5fbda Merge pull request #83 from poli0981/claude/v0.24.0
feat(v0.24.0): cross-post captions, theme toggle, translation notice, Telegram
2026-06-08 12:30:13 +07:00
poli0981andClaude Opus 4.8 f86469485f feat(v0.24.0): cross-post captions, theme toggle, translation notice, Telegram
Adds a cross-post caption generator (TikTok 4000 / Instagram Reels 2200 / Facebook Reels 2200) with single + bulk modes and JSON import/export, a header dark/light theme toggle synced with Settings, an opt-in translation-quality notice for non-trusted (non EN/VI) output languages, and a Telegram social link. Fixes a stray 'Pick a DDR generation' warning on the OS Rig field via a pure validateCompositeField helper. Extracts a shared buildBilingualBulletSection helper reused across content warnings, tech notes, the translation notice, and the social-post builder. +28 tests (482 total). Gates green: typecheck, lint, validate:locales, knip, build.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 12:28:42 +07:00
poli0981 3783c2b1a5 Merge pull request #79 from poli0981/claude/v0.23.0
feat(v0.23.0): +8 VFX warnings, macOS/Linux OS rig support, CHANGELOG catch-up
2026-05-28 08:04:53 +07:00
poli0981andClaude Opus 4.7 6796c78b7e feat(v0.23.0): +8 VFX warnings, macOS/Linux OS rig support, CHANGELOG catch-up
Three concerns bundled per the per-version plan:

1. CHANGELOG catch-up — v0.22.0 was shipped without a `CHANGELOG.md`
   entry. Backfilled the missing section (Added / Changed / Removed /
   Under the hood) matching v0.21.0's structure.

2. +8 VFX warnings in the `photosensitive` group. New IDs:
   `lens_flare_intense`, `bloom_excessive`, `particle_effects_dense`,
   `screen_overlay_flashing`, `color_saturation_extreme`,
   `motion_blur_heavy`, `depth_of_field_aggressive`,
   `post_processing_intense`. Closes the gap between blanket
   flashing-lights / strobe warnings and AAA / horror games that ship
   intense VFX passes (bloom, particles, post-processing) without ever
   triggering a strobe-style flash. Total warnings 187 → 195;
   photosensitive group 5 → 13. Engine renders each automatically.

3. macOS + Linux in the OS Rig field. `CompositePart.options` widened
   from a static array to a union with `(previousParts) =>
   RigFieldOption[]`, plus new optional `labelKeyResolver` (swap
   "Version" ↔ "Distro") and `hiddenWhen` (macOS has no Edition slot)
   per-part predicates. macOS: 7 versions (10 Mojave-era through 26
   Tahoe — the 15 → 26 jump is intentional, matching Apple's 2025
   year-aligned numbering). Linux: 7 distros gameplay creators
   actually use via Proton (Ubuntu / Fedora / Debian / Arch /
   Manjaro / Pop!_OS / Mint) with per-distro version cascading. RAM
   (the existing 2-part static composite) is unaffected — the union
   accepts arrays unchanged. `RigEditor.renderComposite` walks parts
   with a `previousValues` accumulator and resets all downstream
   parts on parent change so the form can't end up in an invalid
   state (e.g. macOS 11 Pro).

Stats: ui.json 835 → 844 keys (+9 = 8 VFX + 1 os_distro), templates
487 → 495 keys (+8 VFX). 6 locales updated in parallel.
454 tests pass (was 445, +9: 7 OS cascading cases + 1 empty-name
fallback + 1 RAM regression check). Gates green: lint, typecheck,
validate:locales (12/12), test, build. Five manifests bumped
0.22.0 → 0.23.0.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 08:02:50 +07:00
85 changed files with 5340 additions and 963 deletions

No files matched your search

+31
View File
@@ -0,0 +1,31 @@
# Dependabot configuration.
#
# This file exists only to configure SECURITY updates for cargo in /src-tauri.
# Version updates stay disabled (open-pull-requests-limit: 0); npm and
# GitHub Actions keep GitHub's default security-update behavior.
#
# Why the ignores: `rand` and `glib` are transitive dependencies of tauri,
# and their security fixes require semver-major bumps that the dependency
# tree does not allow, so every Dependabot security-update job for them
# fails with `security_update_not_possible` (runs 27387346373, 27387346324):
#
# rand 0.7.3 (fix: 0.8.6) pinned by
# tauri -> tauri-utils -> kuchikiki -> selectors -> phf_codegen 0.8
# -> phf_generator 0.8 (requires rand ^0.7)
# glib 0.18.5 (fix: 0.20.0) pinned by
# tauri's gtk-rs 0.18 Linux stack (gtk/gdk/gio 0.18 require glib 0.18)
#
# Remove these ignores once tauri updates kuchikiki / the gtk-rs bindings
# (re-check with: cargo update -p rand@0.7.3 --precise 0.8.6 --dry-run).
version: 2
updates:
- package-ecosystem: "cargo"
directory: "/src-tauri"
schedule:
interval: "weekly"
# No version-update PRs; this entry only feeds ignore rules to security updates.
open-pull-requests-limit: 0
ignore:
- dependency-name: "rand"
- dependency-name: "glib"
+3 -3
View File
@@ -10,10 +10,10 @@ jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: 20
node-version: 22
cache: npm
- run: npm ci
- run: npm run typecheck
+6 -6
View File
@@ -16,16 +16,16 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: 20
node-version: 22
cache: npm
- run: npm ci
- run: npm run build
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
- uses: actions/configure-pages@v6
- uses: actions/upload-pages-artifact@v5
with:
path: dist
- id: deployment
uses: actions/deploy-pages@v4
uses: actions/deploy-pages@v5
+15 -3
View File
@@ -23,6 +23,10 @@ jobs:
fail-fast: false
matrix:
include:
# windows-latest serves the windows-2025-vs2026 image (VS 2026
# toolchain) from June 15, 2026. Tauri build (MSI + NSIS)
# verified on that exact image 2026-06-12, actions run
# 27388695090 — no runner pin needed.
- os: windows-latest
target: x86_64-pc-windows-msvc
# Default Windows bundles: MSI + NSIS (.exe). Both ship.
@@ -48,14 +52,14 @@ jobs:
bundleArgs: ""
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions/checkout@v6
with:
# On `workflow_dispatch` checkout the requested tag; on a
# tag push we already get the tag commit by default.
ref: ${{ github.event.inputs.tag || github.ref }}
- uses: actions/setup-node@v4
- uses: actions/setup-node@v6
with:
node-version: 20
node-version: 22
cache: npm
- uses: dtolnay/rust-toolchain@stable
with:
@@ -74,6 +78,14 @@ jobs:
- uses: tauri-apps/tauri-action@v0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# AppImage bundling on hosted runners flakes: linuxdeploy (itself
# an AppImage) needs FUSE to mount, which GitHub runners don't
# reliably provide → "failed to run linuxdeploy". Extract-and-run
# avoids FUSE; NO_STRIP skips a strip pass that also intermittently
# fails. (No-op on Windows / macOS.) Transient CDN 504s while
# *fetching* linuxdeploy are handled by re-running the job.
APPIMAGE_EXTRACT_AND_RUN: 1
NO_STRIP: true
with:
tagName: ${{ github.event.inputs.tag || 'v__VERSION__' }}
releaseName: "YTDescGen ${{ github.event.inputs.tag || 'v__VERSION__' }}"
+273
View File
@@ -2,6 +2,279 @@
All notable changes to YTDescGen ship as tagged releases on `main`.
## v0.28.0 — 2026-06-13
Adds a first-run **legal consent gate**. Before the app is usable, the user
reviews the Terms of Use, Privacy Policy, Disclaimer, and License (all already
published at the repo root) and ticks a single "I agree" box. Acceptance is
recorded and only re-prompts when the terms version changes — so it is a
one-time step in normal use, and naturally re-appears in a fresh / incognito
browser. On Windows desktop, the installer additionally shows a license page.
### Added
- **Legal consent gate** ([src/components/ConsentGate.tsx](src/components/ConsentGate.tsx), [src/config/legal.ts](src/config/legal.ts)) — a full-screen, non-dismissible screen rendered in place of the router until consent is recorded. Lists the four legal docs as links (open in the browser) + one combined agree checkbox; Continue is disabled until checked. Version-based re-prompt via `CURRENT_TERMS_VERSION` + `needsConsent()`; acceptance persists in the existing settings record (`legalConsentVersion` + timestamp) — **no cookie, no new storage key**.
- **About → Legal section** ([src/pages/AboutPage.tsx](src/pages/AboutPage.tsx)) — the License/Terms/Privacy/Disclaimer docs are now linked in-app (previously only the License was), reusing the shared `LEGAL_DOCS` list.
- **Windows installer license page** ([src-tauri/tauri.conf.json](src-tauri/tauri.conf.json), [src-tauri/installer-license.txt](src-tauri/installer-license.txt)) — `bundle.licenseFile` shows an "accept the terms" page in the MSI/NSIS installers. (macOS `.app`/Linux packages have no interactive license step — they rely on the in-app gate.)
- **Accessible `Checkbox` primitive** ([src/components/ui/Checkbox.tsx](src/components/ui/Checkbox.tsx)) — a real `<input type="checkbox">` styled with theme tokens, distinct from the existing on/off `Toggle`.
- **60 new locale strings** (10 keys × 6 languages: `consentGate.*` + `about.legalHeading`) + [`_schema.json`](src/i18n/locales/_schema.json); validator now expects 937 ui keys per locale (927 → 937).
### Fixed
- **Persisted theme is now applied on boot** ([src/main.tsx](src/main.tsx)) — `index.html` hardcodes `class="dark"`, and previously only the Header toggle wrote the theme class, so a light-theme user saw a brief dark flash on every cold start (and the new gate, which renders before the app shell, would have shown in the wrong theme). The persisted theme is now applied synchronously before first paint.
### Under the hood
- **+9 tests (500 → 509)** — [tests/config/legal.test.ts](tests/config/legal.test.ts) (the `needsConsent` version logic + `LEGAL_DOCS` shape; a `NaN`/Infinity version re-shows the gate) and two `legalConsentVersion` back-fill / coercion cases in [tests/store/settings-heal.test.ts](tests/store/settings-heal.test.ts).
- Consent state is **additive** — `legalConsentVersion` / `legalConsentAt` join `SettingsData`, `initialSettings`, `extractData`, and `healSettings` (which coerces a malformed value to `0` so a corrupt file re-shows the gate, never skips it). **No persist version bump** (stays at 10).
- The gate is a boot-time blocker but stays inside the root `ErrorBoundary`, behind a single boolean — a render error degrades to the designed error page, not a black screen.
- Web bundle: the gate + Checkbox + legal config + English strings add ~4 kB min to the main chunk (local Rollup measure); the shipped size comes from CI's vite 8 / Rolldown build.
- Five manifests bumped 0.27.1 → 0.28.0.
## v0.27.1 — 2026-06-13
Security/dependency release. Resolves the 4 high-severity `esbuild` advisories
deferred from v0.27.0 by upgrading `vite` 7 → 8. The advisories
([GHSA-gv7w-rqvm-qjhr](https://github.com/advisories/GHSA-gv7w-rqvm-qjhr),
[GHSA-g7r4-m6w7-qqqr](https://github.com/advisories/GHSA-g7r4-m6w7-qqqr)) affect
`esbuild` `0.17.0 – 0.28.0`; the fix lives in `esbuild` 0.28.1, which only
`vite` 8 pulls (`vite` 7.3.3 pins `esbuild ^0.27.0` and cannot reach it). They
only ever affected the local dev server, never the shipped static bundle. No
feature or behaviour changes — `npm audit` now reports **0 vulnerabilities**.
### Security / dependencies
- **`vite` `^7.3.3` → `^8.0.16`** — the only release line whose `esbuild`
constraint reaches the patched 0.28.1.
- **`@vitejs/plugin-react` `^4.3.0` → `^5.2.0`** — the vite-8-compatible major.
Stays on the 5.x line (peer `vite: ^4 || ^5 || ^6 || ^7 || ^8`); 6.x is the
Rolldown/react-compiler variant and would pull extra peers, so it was avoided.
- **`tsx` `^4.16.0` → `^4.22.4`** — 4.22+ is the first `tsx` on patched
`esbuild ~0.28.0` (resolves to 0.28.1). Used only by `validate:locales` /
`generate:locale`.
- `vitest` 4.1.8 already supports `vite` 8 (peer `^6 || ^7 || ^8`) — unchanged.
- The tree now hoists a single `esbuild@0.28.1`; `npm audit` → 0 high.
### Changed
- **`manualChunks` object form → function form** ([vite.config.ts](vite.config.ts))
— **vite 8 bundles with Rolldown** (replacing Rollup), which only accepts the
function form of `manualChunks` (the object form was a Rollup-only API). The
same three vendor chunks (`react`, `router`, `i18n`) are reproduced via
anchored `[\\/]node_modules[\\/]…` regexes so `react-router*` and
`react-i18next` don't get swept into the `react` chunk. This is the only
source change the upgrade required.
### Under the hood
- Full gate chain green on vite 8: `typecheck`, `lint`, `knip`,
`validate:locales` (927/542), `test:run` (**500/500**), `build`. `npm run dev`
(port 5173, matching the Tauri `devUrl`) and `npm run preview` (4173) both
serve. The Tauri-context frontend build (`TAURI_ENV_PLATFORM` set) still
switches `base` to `/` correctly; `tauri.conf.json` `devUrl`/`frontendDist`
are unchanged and compatible.
- Web bundle (Rolldown): entry chunk 165.3 kB / 46.3 kB gzip, `react` 133.4 kB,
`i18n` 57.9 kB, `router` 23.4 kB — all well under the 500 kB budget. Chunk
sizes are not directly comparable to the v0.27.0 Rollup numbers (different
bundler, different chunking heuristics).
- Five manifests bumped 0.27.0 → 0.27.1.
## v0.27.0 — 2026-06-13
Adds a designed, internationalized **error-page system**. A mistyped hash
route used to render a blank screen; now any unknown route shows a full-screen
404, and a non-blocking banner signals lost connectivity (the app is fully
offline-capable, so it never blocks input). The render-crash boundary adopts
the same visual language, and `403 / 419 / 500` pages are route-reachable and
ready for future triggers (a Tauri command failure, a future sync backend).
### Added
- **Error-page system** ([src/components/errors/ErrorPage.tsx](src/components/errors/ErrorPage.tsx), [src/config/error-pages.ts](src/config/error-pages.ts)) — one reusable, router-agnostic component covering six kinds (`notFound`, `forbidden`, `expired`, `serverError`, `offline`, `runtime`) driven by a pure kind→meta config (HTTP code, lucide icon, severity colour, i18n key prefix). Renders a `fullscreen` variant for standalone routes and a `contained` variant for the crash boundary.
- **Standalone error routes + live 404** ([src/App.tsx](src/App.tsx)) — `/#/403`, `/#/419`, `/#/500`, `/#/offline`, plus a catch-all `*` → 404, all rendered **outside** the `AppShell` group so they fill the screen with no Sidebar/Header. The catch-all closes a long-standing gap where unknown hash routes rendered nothing.
- **Offline detection** ([src/hooks/use-online-status.ts](src/hooks/use-online-status.ts), [src/components/errors/OfflineBanner.tsx](src/components/errors/OfflineBanner.tsx)) — a `navigator.onLine` hook (SSR/Tauri-safe) drives a dismissible, non-blocking bottom banner; dismissal hides only the current offline episode, and a toast confirms when the connection returns. The app keeps working offline throughout.
- **120 new locale strings** (20 keys × 6 languages) + [`_schema.json`](src/i18n/locales/_schema.json) — per-kind titles/descriptions, shared action labels, and offline-banner copy across en/vi/ja/es/ko/zh. Validator now expects 927 ui keys per locale (907 → 927).
### Changed
- **ErrorBoundary fallback** ([src/components/ErrorBoundary.tsx](src/components/ErrorBoundary.tsx)) now renders `<ErrorPage kind="runtime" variant="contained" />` instead of a bespoke hardcoded-English card — render crashes share the error-page look and are localized. The boundary still logs the crashing subtree's `label` for bug reports; only the visible copy went generic.
### Under the hood
- **+6 tests (494 → 500)** — [tests/config/error-pages.test.ts](tests/config/error-pages.test.ts) guards the pure config: exactly six kinds, correct HTTP codes, unique key prefixes, the resolver / severity-token mappings, and that every kind's `title` + `description` exists in `en/ui.json` (so the config can't point at a missing key — complements `validate:locales`, which only proves cross-locale key parity).
- `ErrorPage` is **router-agnostic by design** — the root boundary in [src/main.tsx](src/main.tsx) mounts *outside* `<HashRouter>`, so it navigates via `#/` anchors + `history.back()` rather than `useNavigate()`, which would throw in that crash path.
- Web bundle: main chunk 264.0 → 270.8 kB minified (82.0 → 84.2 kB gzip) — the eagerly-bundled ErrorPage + config + icons (must render synchronously in the crash path) and the English error strings account for the delta; still well under Rollup's 500 kB threshold.
- Five manifests bumped 0.26.0 → 0.27.0.
### Security / dependencies
- `npm audit` reports 4 high-severity advisories in **dev-only** `esbuild` (transitive via `vite` / `tsx` / `@vitejs/plugin-react`); the only remedy is a `vite` 7 → 8 major upgrade. They affect the local dev server, not the shipped static bundle. Deferred to a dedicated dependency-upgrade release rather than bundling a breaking change into a feature release.
## v0.26.0 — 2026-06-11
Performance release: locale bundles are now lazy-loaded per language, so
visitors only download the languages they actually use. **Main chunk drops
594.0 → 264.0 kB minified (204.3 → 82.0 kB gzip)** — back under Rollup's
500 kB warning threshold (outstanding since ~v0.23) and the project's
bundle budget. No feature changes.
### Changed
- **Lazy-loaded locale bundles** ([src/i18n/index.ts](src/i18n/index.ts)) — the 10 non-English locale JSONs (5 languages × `ui`/`templates`) left the main chunk and are fetched on first use as Vite async chunks (~27–40 kB min / ~12–17 kB gzip each) via [`i18next-resources-to-backend`](https://github.com/i18next/i18next-resources-to-backend) + a statically-analysable dynamic `import()`. English stays eagerly bundled (`partialBundledLanguages`): it is the `fallbackLng` and the engine's bilingual `tEn` translator, both of which must work synchronously.
- **Generation is gated on bundle readiness** — `getFixedT` for an unloaded language silently serves English fallback strings, which would have let the Output page auto-save a *wrong-language history entry*. A new [`useLanguagesReady`](src/hooks/use-languages-ready.ts) hook holds every reactive generator (output preview, multi-language tabs, social captions, playlist, pinned-comment template, title variants) on a placeholder until the bundle is in memory, and the Batch / Social bulk handlers `await ensureLanguagesLoaded(selectedLangs)` before their multi-language loops.
- **Cold-start preload** ([src/main.tsx](src/main.tsx)) — the persisted UI + output languages are fetched before first paint (capped at 2 s), so a non-English user never sees an English flash; `react: { useSuspense: false }` keeps lazily-ready namespaces from suspending the app shell, which has no Suspense boundary.
- **Failure degrades, never hangs** — a locale chunk that cannot be fetched (offline, stale deploy HTML) is retried once by importing the chunk directly into the resource store (i18next marks a failed language permanently and both `loadLanguages` and `reloadResources` skip it forever after), then logged to the in-app Log page, and the UI falls back to English.
### Under the hood
- **+4 tests (490 → 494)** — [tests/i18n/lazy-locales.test.ts](tests/i18n/lazy-locales.test.ts) pins the contract: `en` available synchronously at import, non-English absent until `ensureLanguagesLoaded`, real strings served after, idempotent reloads.
- [src/utils/platform.ts](src/utils/platform.ts) — `IS_TAURI` now guards `typeof window`, keeping the i18n module importable in vitest's node environment.
- Adding a language no longer touches `src/i18n/index.ts` imports — drop `ui.json`/`templates.json` into `locales/<code>/` and register the code in `SUPPORTED_LANGUAGES` ([docs/I18N.md](docs/I18N.md) checklist simplified).
- Five manifests bumped 0.25.0 → 0.26.0.
## v0.25.0 — 2026-06-10
Adds 41 content warnings, including two new groups — **Dialogue / Language**
and **Internet / Digital life** — plus color phobias, suggestive-imagery
disclosures, body-image phenomena, and an educational-purpose disclosure.
Also backfills the content-inventory docs to the real warning baseline.
### Added
- **2 new content-warning groups + 41 new warnings (207 → 248 across 12 groups)** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)):
- **Dialogue / Language (10)** — what characters *say*, ESRB-descriptor style: `profanity_frequent`, `sexual_innuendo`, `inflammatory_speech`, `verbal_abuse`, `threatening_language`, `slurs_derogatory`, `crude_humor`, `mature_humor`, `dark_humor`, `drug_references`.
- **Internet / Digital life (18)** — 21st-century online phenomena: `cyberbullying`, `doxxing`, `trolling_griefing`, `cancel_culture`, `social_media_addiction`, `doomscrolling`, `fomo`, `fake_news`, `online_scams`, `catfishing`, `deepfake_themes`, `cyberstalking`, `internet_challenges`, `influencer_culture`, `online_radicalization`, `loot_boxes`, `ai_themes`, `data_privacy`.
- **Phobias +5 color phobias (51 → 56)** — `chromophobia` plus per-color `erythrophobia` (all-red rooms), `xanthophobia`, `leukophobia` (stark-white spaces), `melanophobia`.
- **Social phenomena +2 (20 → 22)** — `body_shaming`, `beauty_standards`.
- **Mature / Sensitive +5 suggestive-imagery (61 → 66)** — visuals unsuitable for minors short of explicit content, placed beside `mature_18plus`: `revealing_outfits`, `partial_nudity`, `sexualized_characters`, `fanservice`, `suggestive_poses`.
- **Gameplay disclosure +1 (4 → 5)** — `educational_purpose_only` for games made for education / PSA / propaganda purposes.
- The engine renders all of these automatically (selection-order bullets, bilingual `EN · LOCAL`); cross-post captions inherit them via the shared bullet helper. Vietnamese flag-prone labels follow the v0.21.0 asterisk/euphemism precedent (`t*nh d*c`, `Kh*a th*n`). 504 new locale strings (84 keys × 6 locales) + [`_schema.json`](src/i18n/locales/_schema.json) — validator now expects 907 ui / 542 template keys per locale.
### Docs
- **Content-inventory backfill** ([docs/CONTENT-INVENTORY.md](docs/CONTENT-INVENTORY.md), [docs/i18n/vi/CONTENT-INVENTORY.md](docs/i18n/vi/CONTENT-INVENTORY.md), [README.md](README.md)) — the docs still claimed "187 across 9 groups": the v0.22.0 Audio / Sensory group and the v0.23.0 VFX items were never added (the v0.23.0 entry's "187 → 195" total repeated that stale baseline; the actual progression was 199 → 207). Backfilled to the true 207 baseline, then updated to the new 248 / 12-group totals.
- [docs/FEATURES.md](docs/FEATURES.md) — replaced the stale v0.7-era "Spoiler Warning / 18+ Warning" description-structure lines with the unified Content Warnings block (v0.11+).
### Under the hood
- **+8 tests (482 → 490)** — render/bilingual/VI-masking cases for the new warnings ([tests/engine/description-builder.test.ts](tests/engine/description-builder.test.ts)) and a new `CONTENT_WARNINGS` ↔ groups parity guard ([tests/config/content-warning-groups.test.ts](tests/config/content-warning-groups.test.ts)) that fails if an id is added to the engine list but forgotten from every UI group.
- Five manifests bumped 0.24.2 → 0.25.0. First *published* tag carrying the v0.24.2 Linux AppImage hardening (`APPIMAGE_EXTRACT_AND_RUN=1`, `NO_STRIP=true`) — the v0.24.2 tag itself was never released due to the upstream CDN incident.
- Web bundle: main chunk 568.5 → 594.0 kB minified (191.5 → 204.3 kB gzip) — the 504 statically-imported locale strings account for the whole delta; Rollup's >500 kB chunk warning predates this release.
## v0.24.2 — 2026-06-08
CI-only patch to recover the Linux desktop binaries. **No application code
changes** — identical app to v0.24.1.
### CI
- **Hardened the Linux AppImage build** ([.github/workflows/release-desktop.yml](.github/workflows/release-desktop.yml)) — set `APPIMAGE_EXTRACT_AND_RUN=1` and `NO_STRIP=true` on the `tauri-action` step. `linuxdeploy` (itself an AppImage) needs FUSE to mount, which GitHub-hosted runners don't reliably provide → intermittent `failed to run linuxdeploy`. Extract-and-run sidesteps FUSE; `NO_STRIP` skips a strip pass that also flakes. No-op on Windows / macOS.
- **Rebuilt to ship the Linux binaries** (`.deb` / `.AppImage` / `.rpm`) that v0.24.1 missed when the AppImage tooling download hit a sustained upstream GitHub-CDN `http status: 504` during bundling. v0.24.1 published with Windows + macOS binaries; this tag re-runs the full matrix once the transient outage cleared.
## v0.24.1 — 2026-06-08
Maintenance patch: clears all `npm audit` advisories, drops unused Rust
dependencies, and documents the v0.24.0 cross-post caption generator.
### Security / dependencies
- **react-router / react-router-dom 6.30.3 → 6.30.4** — patches the moderate open-redirect advisory ([GHSA-2j2x-hqr9-3h42](https://github.com/advisories/GHSA-2j2x-hqr9-3h42)). Non-breaking; a HashRouter SPA on static hosting was low-exposure, but patched for hygiene.
- **vitest 3.2.4 → 4.1.8** — clears the critical Vitest-UI-server advisory ([GHSA-5xrq-8626-4rwp](https://github.com/advisories/GHSA-5xrq-8626-4rwp), dev-only — never in a shipped artifact). All 482 tests pass unchanged on the new major; no test or config code needed adjusting. `npm audit` now reports **0 vulnerabilities**.
### Removed
- **Unused `serde` / `serde_json` from `src-tauri/Cargo.toml`** — neither was referenced anywhere in `src-tauri/src/` (Tauri scaffolding leftovers; the `#[tauri::command]` functions only use `String` / `Result`). `cargo check` confirms the crate still compiles without them; `Cargo.lock`'s `yt-desc-gen` entry no longer lists them.
### Docs
- Documented the **cross-post caption generator** (Social tab — TikTok / Instagram Reels / Facebook Reels) in [README.md](README.md) and [docs/FEATURES.md](docs/FEATURES.md).
### Under the hood
- Five manifests bumped 0.24.0 → 0.24.1 (`package.json`, `package-lock.json` root + self-reference, `src-tauri/Cargo.toml`, `src-tauri/Cargo.lock` self-entry, `src-tauri/tauri.conf.json`). Gates green: typecheck, lint, validate:locales, knip, build, 482 tests, `npm audit` clean.
## v0.24.0 — 2026-06-08
Adds a **cross-post caption generator** that re-packages the YouTube
source into TikTok / Instagram Reels / Facebook Reels captions, a
navigation **theme toggle**, an opt-in **translation-quality notice**, and
a **Telegram** social link — plus a fix for a stray validation warning on
the OS Rig field.
### Added
- **Cross-Post Captions** — a new **Social** tab ([src/pages/SocialPage.tsx](src/pages/SocialPage.tsx), [src/engine/social-post-builder.ts](src/engine/social-post-builder.ts), [src/config/social-platforms.ts](src/config/social-platforms.ts), [src/hooks/use-social-posts.ts](src/hooks/use-social-posts.ts)). Re-packages the same editor source that drives the YouTube description into short-form captions for **TikTok (4000)**, **Instagram Reels (2200)**, and **Facebook Reels (2200)**. Each caption pulls Title (badge suppressed), 💻 MY RIG, ⚠️ Content Warnings, 🎁 Thanks, © Copyright, and hashtags (game + primary genre + a curated per-platform popular-hashtag set, deduped case-insensitively). Per-platform char counter + over-limit warning; when a caption overflows, optional blocks are dropped in priority order (warnings → copyright → thanks → rig) — Title + hashtags are never dropped, and there's no mid-string truncation. **Single** mode (platform tabs) and **Bulk** mode (part range × selected languages, reusing the Batch loop) with Copy-All. **JSON import/export** of the generated captions via a new `social` envelope type ([src/utils/file-schema.ts](src/utils/file-schema.ts) `ExportType` / `SCHEMA_VERSIONS` / `isExportType`); import is display-only since captions are derived artifacts. New `tabs.social` + `socialPost.*` locale block across all 6 locales (no new `templates.json` keys — captions reuse existing description/title strings).
- **Dark/Light theme toggle in the header** ([src/components/layout/Header.tsx](src/components/layout/Header.tsx)). A Sun/Moon icon button next to the language picker, reusing the existing `settings.setTheme` action so it stays in sync with the Settings toggle both ways. New `header.toggleTheme` key across 6 locales. No store/persist change — the theme field + setter already existed.
- **Translation-quality notice** ([src/engine/description-builder.ts](src/engine/description-builder.ts), [src/pages/SettingsPage.tsx](src/pages/SettingsPage.tsx)). New opt-in `showTranslationQuality` setting. When on, descriptions generated in a language **outside the trusted set (English / Vietnamese, which are human-reviewed)** get a bilingual `▸ 🌐 ABOUT THIS TRANSLATION` block: an intro naming the trusted languages + caveat bullets (accuracy not 100%, phrasing may be literal/stiff, may not match local style, corrections welcome). English/Vietnamese descriptions skip it. New `description.translationQuality.{header,intro,items.*}` template keys + `settings.showTranslationQuality{,Hint}` UI keys across 6 locales. Additive setting — `healSettings` back-fills the default, so no persist bump.
- **Telegram social link** ([src/config/social-fields.ts](src/config/social-fields.ts)). New `telegram` field (`https://t.me/` prefix, ✈️ icon) in the Social category. `social` is a generic record, so no profile migration. New `social.telegram` label across 6 locales.
### Fixed
- **"Pick a DDR generation" no longer appears on the OS Rig field** ([src/components/editor/RigEditor.tsx](src/components/editor/RigEditor.tsx), [src/utils/rig-validation.ts](src/utils/rig-validation.ts)). `renderComposite` hard-coded the RAM validator for **every** composite dropdown, so selecting an OS — also a composite — ran the RAM check (`"windows||"` parses as size=`"windows"`, ddr=`""`, tripping `ramMissingDdr`). Validator selection moved into a pure `validateCompositeField(fieldId, raw)` helper that only validates RAM; the OS composite (and any future one) shows no spurious badge.
### Under the hood
- **Shared `buildBilingualBulletSection` helper** ([src/engine/description-builder.ts](src/engine/description-builder.ts)). The inline Content-Warnings render block and the standalone Tech-Notes function were collapsed into one exported pure helper (header + intro + `• EN · LOCAL` bullets, U+00B7 separator) — reused by Content Warnings, Tech Notes, the new Translation-Quality notice, and the social-post builder. Description output is byte-for-byte unchanged, guarded by the existing description tests.
- **28 new tests** (454 → 482): 12 in [tests/utils/rig-validation.test.ts](tests/utils/rig-validation.test.ts) (new — RAM/GPU validators + `validateCompositeField` OS-vs-RAM guard), 13 in [tests/engine/social-post-builder.test.ts](tests/engine/social-post-builder.test.ts) (new — hashtag derivation/dedupe/sanitization, rig, bilingual warnings, copyright/sponsor gating, overflow drop-order), 3 translation-quality cases in [tests/engine/description-builder.test.ts](tests/engine/description-builder.test.ts), plus the `settings-heal` complete-payload guard updated for the new field.
- Five manifests bumped 0.23.0 → 0.24.0 (`package.json`, `package-lock.json` root + self-reference, `src-tauri/Cargo.toml`, `src-tauri/Cargo.lock` self-entry, `src-tauri/tauri.conf.json`).
- Pre-release gates run green: lint, typecheck, validate:locales (12/12 files complete; 864 ui + 501 template keys per locale), 482 tests, knip, build.
## v0.23.0 — 2026-05-27
Extends audience-protection coverage with eight VFX-intensity warnings
and unlocks the new OS Rig field (introduced in v0.22.0) for macOS and
Linux creators via a cascading dropdown that adapts its slot semantics
to the chosen OS family.
### Added
- **8 new VFX content warnings in the `photosensitive` group** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)). New IDs: `lens_flare_intense`, `bloom_excessive`, `particle_effects_dense`, `screen_overlay_flashing`, `color_saturation_extreme`, `motion_blur_heavy`, `depth_of_field_aggressive`, `post_processing_intense`. Closes the gap between blanket `flashing_lights` / `strobe_effects` and the AAA / horror games that ship intense visual-effects passes (bloom, particles, lens flares, post-processing) without ever triggering a strobe-style flash. Total content warnings 187 → 195 across 10 groups (no new group; `photosensitive` 5 → 13). Purely additive — engine renders each warning automatically; existing profiles round-trip unchanged. Fully translated across all 6 locales (`ui.json` short labels + `templates.json` description phrases) with `_schema.json` updated.
- **macOS support in the OS Rig field** ([src/config/rig-fields.ts](src/config/rig-fields.ts) `MACOS_VERSION_OPTIONS`). 7 macOS major versions: `10` (Mojave era), `11 Big Sur`, `12 Monterey`, `13 Ventura`, `14 Sonoma`, `15 Sequoia`, `26 Tahoe`. The intentional 15 → 26 jump matches Apple's 2025 year-aligned marketing-number reset. Stored values carry the human label (e.g. `"macos|15 Sequoia|"`) so the description output reads as a single recognisable string. macOS has no Edition tier, so the third dropdown is hidden when macOS is selected.
- **Linux support in the OS Rig field** ([src/config/rig-fields.ts](src/config/rig-fields.ts) `LINUX_DISTRO_OPTIONS`, `LINUX_VERSION_BY_DISTRO`). 7 distros gameplay creators actually use via Proton: Ubuntu (`20.04 / 22.04 / 24.04 / 26.04 LTS`), Fedora (`40 / 41 / 42`), Debian (`12 Bookworm / 13 Trixie`), Arch (`rolling`), Manjaro (`latest`), Pop!_OS (`22.04 / 24.04 LTS`), Linux Mint (`21 / 22`). When Linux is selected the second slot re-labels to "Distro" and the third slot re-labels to "Version" with a per-distro option list — so Ubuntu's versions don't bleed into Fedora's dropdown.
- **Cascading composite dropdown** ([src/config/rig-fields.ts](src/config/rig-fields.ts) `CompositePart`, `resolveCompositeOptions`, `resolveCompositeLabelKey`). `CompositePart.options` widened from `RigFieldOption[]` to a union with `(previousParts) => RigFieldOption[]` so a part can resolve its option list from previously-selected siblings. New optional `labelKeyResolver` lets a single part swap its i18n key (Version / Distro), and `hiddenWhen` removes a part from both the editor form and the description output. RAM (the existing 2-part static composite) is unaffected — the union accepts arrays unchanged.
- **`editor.os_distro` locale key** across all 6 locales (`Distro` / `Distro` / `ディストリ` / `Distro` / `배포판` / `发行版`) — the new Linux-only second-slot label.
### Changed
- **Editor form resets downstream parts on parent change** ([src/components/editor/RigEditor.tsx](src/components/editor/RigEditor.tsx) `renderComposite`). When a user switches OS name from Windows to macOS, any previously-selected version / edition values are cleared so the form can't end up in an invalid state (e.g. `macOS 11 Pro`). The new `setPart` clears all indices `>` the changed one, so the cascading dropdown is always self-consistent.
### Under the hood
- Composite dropdown `formatRigValue` walks parts with a `previousValues` accumulator now, calls `hiddenWhen` first to skip hidden parts entirely (so they don't leak empty tokens into the joined output), then resolves the option list with the accumulator. Stored shapes are unchanged — v0.22.0's `"windows|11|pro"` round-trips byte-for-byte.
- 9 new tests in [tests/engine/rig-fields.test.ts](tests/engine/rig-fields.test.ts) (24 → 33): 7 OS cascading cases (macOS Sequoia / Tahoe, Linux Ubuntu / Arch / Fedora / Debian, hidden macOS edition fallback, Windows backward-compat guard), 1 empty-name fallback (degenerate input), 1 RAM regression check that confirms the static-array path still works after the union widening.
- Five manifests bumped 0.22.0 → 0.23.0 (`package.json`, `package-lock.json` root + self-reference, `src-tauri/Cargo.toml`, `src-tauri/tauri.conf.json`).
- Pre-release gates run green: lint, typecheck, validate:locales (12/12 files complete; 844 ui + 495 template keys per locale), 454 tests, build.
## v0.22.0 — 2026-05-27
Adds a dedicated **Audio / Sensory** content-warning group, introduces an
opt-in video-style era credit that combines with the rig's Video Editor
field, surfaces a structured **Operating System** dropdown in My Rig, and
drops two stale Settings/About items (Default Genre, Dev Environment).
### Added
- **12 new audio content warnings in a new `audio` group** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)). Splits audio-sensitive triggers out of the `photosensitive` group where they never quite fit. New IDs: `ear_piercing`, `jumpscare_audio`, `sudden_volume_changes`, `distorted_audio`, `screeching_metallic`, `persistent_high_pitch`, `audio_glitches`, `heavy_bass_rumble`, `screaming_audio`, `glass_breaking_audio`, `microphone_pops`, `white_noise_static`. `loud_noises` migrated out of `photosensitive` into this group. Total content warnings 175 → 187 across 9 → 10 groups. Purely additive; engine renders each warning automatically. Fully translated across all 6 locales (`ui.json` short labels + `templates.json` description phrases) with `_schema.json` updated.
- **Video-style era toggle** ([src/config/video-styles.ts](src/config/video-styles.ts), [src/components/editor/VideoSettingsForm.tsx](src/components/editor/VideoSettingsForm.tsx), [src/engine/description-builder.ts](src/engine/description-builder.ts)). New per-video opt-in field `videoStyleEra` on `EditorData` — empty string sentinel for "off", 12 valid eras: `1980s`/`1990s`/`2000s`/`2010s`/`2020s` + `modern`/`cinematic`/`retro`/`vhs`/`film_noir`/`anime_mv`/`documentary`. When set, the description renderer emits a single line at the end of the Video Settings section combining the era with the rig's video editor: `"Edited in 1990s VHS style using DaVinci Resolve 19.1"`. Falls back to an editor-less template (`"Edited in 1990s VHS style"`) when `rig.video_editor` is empty. **Renders even when `skipGraphicsSettings` is on** — 2D / pixel-art creators still edit their footage, so the style credit survives as a standalone one-line section under the same header. New file exports `VIDEO_STYLE_ERAS` literal union + `isVideoStyleEra` type guard. Field shape mirrors the existing `artStyle` / `playthroughStatus` / `difficulty` per-video sentinels — no parallel boolean toggle.
- **Operating System field in My Rig** ([src/config/rig-fields.ts](src/config/rig-fields.ts) `OS_COMPOSITE`). New `composite_dropdown` entry at the top of `RIG_FIELDS` modelled on the existing RAM pattern. Three parts: name → version → edition. Stored as `"windows|11|pro"` → renders `"Windows 11 Pro"` via `formatRigValue`. Windows 10 / 11 + Home / Pro / Enterprise / Education / IoT Enterprise. Pre-v0.22 profiles with no `rig.os` key pass through the existing empty-value filter chain in `description-builder.ts` — no migration needed. New schema keys `editor.os_name`, `editor.os_version`, `editor.os_edition` + `rig.os` across 6 locales.
### Removed
- **Default Genre setting** ([src/pages/SettingsPage.tsx](src/pages/SettingsPage.tsx), [src/store/settings-heal.ts](src/store/settings-heal.ts), [src/store/settings-store.ts](src/store/settings-store.ts), [src/config/defaults.ts](src/config/defaults.ts)). The `ChipGroup` never wired through to the editor — orphan field. Removed UI, `SettingsData.defaultGenres`, `setDefaultGenres` action, `initialSettings.defaultGenres`, `SettingsDefaults.defaultGenres`, `DEFAULTS.settings.defaultGenres`, `extractData` entry, and the v1→v2 migration block in `healSettings` (replaced by a single `delete incoming.defaultGenres` + `delete incoming.defaultGenre` so persisted blobs don't leak the dead field). Two migration tests removed from `settings-heal.test.ts`. `settings.defaultGenre` key removed from 6 `ui.json` + `_schema.json`.
- **Dev Environment section from About** ([src/pages/AboutPage.tsx](src/pages/AboutPage.tsx), [src/config/about.ts](src/config/about.ts)). Hardcoded specs drift on every box upgrade. Removed the entire `<section>` block (~33 lines of JSX + `devEnvRows` constant), `Cpu`/`Monitor` icon imports, `ABOUT.pcSpecDocUrl` and `ABOUT.devEnvDocUrl`, and all `about.devEnvHeading` / `devEnvHelp` / `devEnv.{os,cpu,gpu,ram,ide,toolchains,fullSpecLink,fullDevEnvLink}` keys from 6 `ui.json` + `_schema.json` (10 keys per locale).
### Changed
- **`loud_noises` migrated from `photosensitive` to `audio`.** Sudden-volume / high-frequency triggers affect a different audience than strobe / motion-sickness triggers, so the group split is cleaner. Stored ID unchanged — existing profiles using `loud_noises` round-trip without any per-warning migration.
### Under the hood
- **Editor-store persist version 13 → 14.** Adds `videoStyleEra` field with defensive coercion: unknown / hand-edited / future-downgrade values are coerced back to `""` via the `isVideoStyleEra` type guard so the form `Select` never lands on a missing option. Additive — pre-v0.22 drafts round-trip through the migration with `videoStyleEra` defaulting to off.
- **`healSettings` strips both legacy keys.** Whether the persisted blob carries the v1 shape (`defaultGenre: string`) or the v2 shape (`defaultGenres: GenreId[]`), the heal step now deletes both before the final `{ ...initialSettings, ...incoming }` spread — guarantees the field never resurfaces.
- **B3 "Localize My Rig labels" was a phantom task.** Initial planning assumed the `rig.{cpu,gpu,ram,storage,monitor,capture,motherboard,controller,video_editor}` locale keys didn't exist anywhere; verification showed all 6 locales already had them with proper translations. Only the new `rig.os` key was actually missing — folded into the OS-field work.
- Five manifests bumped 0.21.0 → 0.22.0 (`package.json`, `package-lock.json` root + self-reference, `src-tauri/Cargo.toml`, `src-tauri/tauri.conf.json`).
- Pre-release gates run green: lint, typecheck, validate:locales (12/12 files complete; 835 ui + 487 template keys per locale), 445 tests (was 416 — +5 video-style line render cases in `description-builder.test.ts`, +6 OS composite cases in `rig-fields.test.ts`, –2 deleted default-genre migration tests, plus pre-existing growth), build.
## v0.21.0 — 2026-05-27
Reduces YouTube auto-flag risk on Vietnamese descriptions, adds twelve
+2 -2
View File
@@ -7,7 +7,7 @@
- **Repository**: `github.com/poli0981/youtube-generator`
- **License**: Apache-2.0 (see `LICENSE` + `NOTICE`)
- **Primary Language**: TypeScript
- **Stack**: React 18 + Vite 7 + Tailwind CSS 3 + Zustand + Tauri 2 (desktop)
- **Stack**: React 18 + Vite 8 + Tailwind CSS 3 + Zustand + Tauri 2 (desktop)
- **Target Platforms**: Web (GitHub Pages), Desktop (Windows/macOS/Linux via Tauri)
## Tech Stack
@@ -15,7 +15,7 @@
| Layer | Technology | Why |
|-------|-----------|-----|
| Framework | React 18 | Familiar from F2P tracker dashboard |
| Build | Vite 5 | Fast HMR, clean config |
| Build | Vite 8 | Fast HMR, Rolldown bundler |
| Language | TypeScript (strict) | Type safety for template engine |
| Styling | Tailwind CSS 3 | Utility-first, fast iteration |
| State | Zustand + persist middleware | Simple, localStorage/file persistence |
+2
View File
@@ -50,6 +50,8 @@ YouTube oEmbed, the Steam store API, Twitch helix, and similar services are **no
The web version uses **`localStorage`**, not cookies. No cookie is set by the application. GitHub Pages itself may issue a session cookie at the platform level — that is GitHub's, not ours, and is governed by [GitHub's Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement).
The first-run consent acknowledgement (added in v0.28.0) is recorded **inside the existing settings record** — a `legalConsentVersion` number plus a local timestamp — not as a separate cookie or storage key. It never leaves your device.
## Children's Privacy
This application is not directed at children under 13 and does not knowingly process any personal data from anyone.
+4 -3
View File
@@ -24,14 +24,15 @@ Built for the gameplay no-commentary niche — especially horror / scary games
- **20 video types** — Full Gameplay, Part, Boss Fight, Boss No-Hit, Ending, Speedrun, 100%, DLC, NG+, Challenge, Side Quest, Secret, Comparison, Guide, Mods, Collectibles, Livestream, Gacha Quest, Demo, Demo Part.
- **6 UI languages** — English, Vietnamese, Japanese, Spanish, Korean, Chinese. *(VI authored by a native speaker; JA / ES / KO / ZH AI-translated — see [DISCLAIMER.md](./DISCLAIMER.md).)*
- **40+ game genres** — across action, RPG, FPS, horror, soulslike, indie, simulation, fighting, and more.
- **187 content-warning IDs** across 9 groups — spoilers, photosensitive, phobias, mental health, social phenomena, sensitive themes (incl. method-specific death/violence), horror-specific, playstyle, and gameplay disclosure (mods / cheats / glitches / guide-assisted). Sets viewer expectations before they hit play.
- **248 content-warning IDs** across 12 groups — spoilers, photosensitive/VFX, audio, dialogue/language, phobias (incl. color phobias), mental health, social phenomena, internet/digital life, sensitive themes (incl. method-specific death/violence and suggestive imagery), horror-specific, playstyle, and gameplay disclosure (mods / cheats / glitches / guide-assisted / educational purpose). Sets viewer expectations before they hit play.
- **Profile system** — save channel / social / rig info once, reuse across every video.
- **Game presets** — save game name + store links once, reuse across the entire part series.
- **Snapshot templates** — save full-form configurations and recall in one click.
- **Smart tag generation** — combines genre pool, platform, quality tier, multilingual hooks, and trending terms; auto-dedup and 500-char-limit aware.
- **Character counters** — real-time limits for title (100), description (5000), tags (500).
- **Batch mode** — generate metadata for all parts of a series in one pass.
- **Desktop app** — Windows & macOS native binaries via Tauri (~8 MB).
- **Cross-post captions** — a dedicated **Social** tab re-packages the same YouTube source into short-form captions for **TikTok** (4,000-char), **Instagram Reels**, and **Facebook Reels** — title, rig, content warnings, copyright, thanks, and hashtags (game + genre + curated per-platform popular tags). Single + bulk modes, per-platform character limits with smart overflow trimming, and JSON import/export.
- **Desktop app** — Windows, macOS & Linux native binaries via Tauri (~8 MB).
- **Mobile-responsive web** — drawer navigation, touch-sized controls, iOS-safe text-input behavior. Tested down to 360 × 640.
- **100% offline** — no server, no telemetry, no account. See [PRIVACY.md](./PRIVACY.md).
@@ -67,7 +68,7 @@ Nothing leaves your device. No analytics, no telemetry, no tracking. The web ver
## Tech Stack
React 18 · TypeScript (strict) · Vite 7 · Tailwind CSS 3 · Zustand · i18next · Tauri 2 (Rust stable).
React 18 · TypeScript (strict) · Vite 8 · Tailwind CSS 3 · Zustand · i18next · Tauri 2 (Rust stable).
Architecture overview: [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
+11 -1
View File
@@ -46,6 +46,14 @@
└──────────────────────────────────────────────────────────────┘
```
**Error pages (v0.27):** `components/errors/` holds a reusable `ErrorPage`
(404/403/419/500/offline/runtime) driven by the pure `config/error-pages.ts`
map. The dedicated error routes (`/403`, `/419`, `/500`, `/offline`, catch-all
`*`) are declared as **siblings of the `AppShell` route group** in `App.tsx`, so
they render full-screen with no Sidebar/Header. `ErrorPage` is router-agnostic
(hash anchors + `history.back()`) so the root `ErrorBoundary` — mounted outside
`HashRouter` in `main.tsx` — can reuse it as its crash fallback.
## 2. Core Engine Design
Engine module chứa toàn bộ logic generate — **zero framework dependency**. Mọi function đều pure: input → string.
@@ -278,6 +286,8 @@ i18n/locales/
**Adding a new language** = 2 JSON files + 1 line registration. See docs/I18N.md.
**Lazy loading (v0.26+)**: only English is bundled into the main chunk — it is the `fallbackLng` and the engine's bilingual `tEn` translator, both of which must resolve synchronously. Every other language is fetched on first use as a Vite async chunk via `i18next-resources-to-backend` + dynamic `import()`. Generation paths gate on bundle readiness (`useLanguagesReady` hook / `ensureLanguagesLoaded`): an unloaded language would otherwise silently render English fallback output. A chunk that fails to fetch degrades to English and logs to the in-app Log page — it never hangs the UI.
**UI language vs Output language**: These are independent. User can browse the app in English but generate descriptions in Japanese. UI language follows `SettingsStore.defaultLanguage`, output language follows `EditorStore.language`.
## 5. Desktop Packaging (Tauri)
@@ -313,7 +323,7 @@ Tauri advantages over Electron:
| What | How to Extend | Files to Touch |
|------|--------------|----------------|
| New language | Add `locales/{code}/ui.json` + `templates.json`, register in `i18n/index.ts` | 3 files |
| New language | Add `locales/{code}/ui.json` + `templates.json`, register in `SUPPORTED_LANGUAGES` (lazy-loaded automatically) | 3 files |
| New genre | Add entry to `config/genres.ts`, add tag pool to `engine/tag-generator.ts` | 2 files |
| New video type | Add to `config/video-types.ts`, add patterns to all `templates.json` | 1 + N locale files |
| New platform/store | Add entry to `config/platforms.ts` | 1 file |
+23 -11
View File
@@ -95,7 +95,7 @@ Bulk-select groups available in the editor: **All RPGs** (rpg + jrpg + action_rp
---
## 3. Content warnings (187, grouped)
## 3. Content warnings (248, grouped)
Selected warnings are appended to a `⚠ CONTENT WARNINGS` block in the description, ahead of timestamps. Each group is collapsible in the editor; warnings render in description order = user's selection order.
@@ -103,25 +103,37 @@ Selected warnings are appended to a `⚠ CONTENT WARNINGS` block in the descript
Story / ending spoilers · Ending spoilers · True-ending spoilers · Post-game / NG+ spoilers · Secret-ending spoilers · DLC story spoilers
### Photosensitive / Health (6)
### Photosensitive / Health (13)
Flashing lights · Motion sickness · Migraine trigger · Loud / sudden sounds · Strobe lighting · Heavy screen shake
Flashing lights · Motion sickness · Migraine trigger · Strobe lighting · Heavy screen shake · Lens flare / sun glare · Excessive bloom / overblown highlights · Dense particle effects · Flashing HUD / UI overlays · Extreme color saturation · Heavy motion blur · Aggressive depth of field · Intense post-processing
### Phobias (51)
### Audio / Sensory (13)
Jumpscares · Heights (acrophobia) · Holes / clusters (trypophobia) · Deep water (thalassophobia) · Confined spaces (claustrophobia) · Spiders (arachnophobia) · Insects (entomophobia) · Snakes (ophidiophobia) · Dogs (cynophobia) · Darkness (nyctophobia) · Fire (pyrophobia) · Dolls (pediophobia) · Blood (hemophobia) · Clowns (coulrophobia) · Drowning / water immersion (ablutophobia) · Live burial (taphophobia) · Animatronics / mannequins (automatonophobia) · Large objects (megalophobia) · Submerged man-made objects (submechanophobia) · Corpses (necrophobia) · Ghosts (spectrophobia) · Demons (demonophobia) · Sharks (selachophobia) · Germs / contamination (mysophobia) · Vomiting (emetophobia) · Being watched (scopophobia) · Isolation (monophobia) · Mice / rats (musophobia) · Bats (chiroptophobia) · Birds (ornithophobia) · Fish (ichthyophobia) · Reptiles (herpetophobia) · Cockroaches (katsaridaphobia) · Bees / wasps (apiphobia) · Thunder / lightning (astraphobia) · Open spaces (agoraphobia) · Crowds (enochlophobia) · Snow / extreme cold (chionophobia) · Hospitals (nosocomephobia) · Sharp objects (aichmophobia) · Choking / suffocation (pnigophobia) · Fog / mist (homichlophobia) · Tornadoes / hurricanes (lilapsophobia) · Heavy rain (ombrophobia) · Clouds (nephophobia) · Strong wind (ancraophobia) · Extreme cold (cryophobia) · Sunlight (heliophobia) · Large waves (cymophobia) · Lakes / still water (limnophobia) · Rivers / currents (potamophobia)
Loud / sudden sounds · Ear-piercing / high-pitched · Audio jumpscares · Sudden volume changes · Distorted / clipping audio · Screeching / metallic sounds · Persistent high-pitched tones · Audio glitches / artifacts · Heavy bass / sub-bass rumble · Sustained screaming · Glass breaking / shattering · Mic pops / breath noise · White noise / static
### Dialogue / Language (10)
Frequent profanity · Sexual innuendo / suggestive dialogue · Inflammatory / inciting dialogue · Verbal abuse · Threats / intimidation · Slurs / derogatory terms · Crude / toilet humor · Mature / adult humor · Dark / morbid humor · Drug / alcohol references
### Phobias (56)
Jumpscares · Heights (acrophobia) · Holes / clusters (trypophobia) · Deep water (thalassophobia) · Confined spaces (claustrophobia) · Spiders (arachnophobia) · Insects (entomophobia) · Snakes (ophidiophobia) · Dogs (cynophobia) · Darkness (nyctophobia) · Fire (pyrophobia) · Dolls (pediophobia) · Blood (hemophobia) · Clowns (coulrophobia) · Drowning / water immersion (ablutophobia) · Live burial (taphophobia) · Animatronics / mannequins (automatonophobia) · Large objects (megalophobia) · Submerged man-made objects (submechanophobia) · Corpses (necrophobia) · Ghosts (spectrophobia) · Demons (demonophobia) · Sharks (selachophobia) · Germs / contamination (mysophobia) · Vomiting (emetophobia) · Being watched (scopophobia) · Isolation (monophobia) · Mice / rats (musophobia) · Bats (chiroptophobia) · Birds (ornithophobia) · Fish (ichthyophobia) · Reptiles (herpetophobia) · Cockroaches (katsaridaphobia) · Bees / wasps (apiphobia) · Thunder / lightning (astraphobia) · Open spaces (agoraphobia) · Crowds (enochlophobia) · Snow / extreme cold (chionophobia) · Hospitals (nosocomephobia) · Sharp objects (aichmophobia) · Choking / suffocation (pnigophobia) · Fog / mist (homichlophobia) · Tornadoes / hurricanes (lilapsophobia) · Heavy rain (ombrophobia) · Clouds (nephophobia) · Strong wind (ancraophobia) · Extreme cold (cryophobia) · Sunlight (heliophobia) · Large waves (cymophobia) · Lakes / still water (limnophobia) · Rivers / currents (potamophobia) · Colors / vivid color scenes (chromophobia) · Red / all-red scenes (erythrophobia) · Yellow color (xanthophobia) · White / all-white spaces (leukophobia) · Black color (melanophobia)
### Mental health (17)
Anxiety-inducing scenes · Depression themes · Eating disorders · Substance use · Self-harm / suicide · PTSD content · Needles · Body fluids · Pregnancy / birth horror · Illness / infection · Bipolar themes · OCD themes · Panic attacks · Dissociation · Paranoia · Intrusive thoughts · Medical horror
### Social phenomena (20)
### Social phenomena (22)
Autism / neurodivergence themes · ADHD / executive dysfunction · Hikikomori / social withdrawal · NEET themes · Social anxiety themes · Social isolation / loneliness · Schizophrenia / psychosis · Burnout / overwork · Survivor guilt · Abandonment themes · Parasocial relationships · Gaslighting · Stockholm syndrome · Gaming / gambling addiction · Existential / nihilistic themes · Impostor syndrome · Midlife crisis · Quarter-life crisis · Workplace harassment · Gender-role pressure
Autism / neurodivergence themes · ADHD / executive dysfunction · Hikikomori / social withdrawal · NEET themes · Social anxiety themes · Social isolation / loneliness · Schizophrenia / psychosis · Burnout / overwork · Survivor guilt · Abandonment themes · Parasocial relationships · Gaslighting · Stockholm syndrome · Gaming / gambling addiction · Existential / nihilistic themes · Impostor syndrome · Midlife crisis · Quarter-life crisis · Workplace harassment · Gender-role pressure · Body shaming / appearance mockery · Unrealistic beauty standards
### Mature / Sensitive content (61)
### Internet / Digital life (18)
Blood and gore · Mature 18+ · Disturbing imagery · Animal cruelty · Violence against minors · Domestic violence · Sexual assault references · Torture · Religious themes · War violence · Discrimination · State / police violence · Smoking / drinking · Detailed killing · Cult / occult · Psychological manipulation · Loss / grief · Kidnapping · Hate speech · Historical atrocities · Slavery themes · Terrorism themes · Bullying themes · Human experimentation · Cannibalism · Nuclear / radiation · Homophobia / anti-LGBTQ+ · Transphobia / anti-trans · Xenophobia / anti-foreigner · Political extremism · Religious extremism / fundamentalism · Genocide / ethnic cleansing · Holy war / sectarian conflict · Holocaust themes · Civil war · Mass / school shootings · Colonialism / imperialism · State propaganda · Surveillance / dystopian state · Conspiracy theories · Censorship themes · Ethnic / racial conflict · Refugee crisis · Revolution / uprising · Political assassination · Coup d'état · Inquisition / religious persecution · Forced labor · Ultranationalism · Hanging / strangulation · Drowning scene · Burning alive / immolation · Asphyxiation / suffocation · Bound / restrained victim · Public execution · Decapitation · Impalement · Mass-casualty event · Vehicular violence · Overdose scene · Falling from height (intentional)
Cyberbullying / online harassment · Doxxing / privacy exposure · Trolling / griefing · Cancel culture / public shaming · Social media addiction · Doomscrolling · FOMO (fear of missing out) · Fake news / misinformation · Online scams / phishing · Catfishing / fake identity · Deepfakes / synthetic media · Cyberstalking · Dangerous viral challenges · Influencer culture / clout chasing · Online radicalization / echo chambers · Loot boxes / gacha mechanics · AI / artificial intelligence themes · Data privacy / mass surveillance
### Mature / Sensitive content (66)
Blood and gore · Mature 18+ · Revealing / skimpy outfits · Partial nudity · Sexualized character designs · Fan service / ecchi · Suggestive poses / camera angles · Disturbing imagery · Animal cruelty · Violence against minors · Domestic violence · Sexual assault references · Torture · Religious themes · War violence · Discrimination · State / police violence · Smoking / drinking · Detailed killing · Cult / occult · Psychological manipulation · Loss / grief · Kidnapping · Hate speech · Historical atrocities · Slavery themes · Terrorism themes · Bullying themes · Human experimentation · Cannibalism · Nuclear / radiation · Homophobia / anti-LGBTQ+ · Transphobia / anti-trans · Xenophobia / anti-foreigner · Political extremism · Religious extremism / fundamentalism · Genocide / ethnic cleansing · Holy war / sectarian conflict · Holocaust themes · Civil war · Mass / school shootings · Colonialism / imperialism · State propaganda · Surveillance / dystopian state · Conspiracy theories · Censorship themes · Ethnic / racial conflict · Refugee crisis · Revolution / uprising · Political assassination · Coup d'état · Inquisition / religious persecution · Forced labor · Ultranationalism · Hanging / strangulation · Drowning scene · Burning alive / immolation · Asphyxiation / suffocation · Bound / restrained victim · Public execution · Decapitation · Impalement · Mass-casualty event · Vehicular violence · Overdose scene · Falling from height (intentional)
### Heavy horror (12)
@@ -131,9 +143,9 @@ Eyes / eyeball clusters · Body horror (flesh distortion) · Distorted / mutilat
Blind playthrough · No spoilers in chat · Casual / story mode · Hardcore / max difficulty · Permadeath / Iron Man · Speedrun attempt · 100% completionist · Still learning mechanics · First time playing · Returning / NG+
### Gameplay disclosure (4)
### Gameplay disclosure (5)
Mods used · Cheats / debug · Glitches used · Guide-assisted
Mods used · Cheats / debug · Glitches used · Guide-assisted · Educational / PSA purpose
---
+5 -1
View File
@@ -23,7 +23,7 @@ Install in this order:
| Tool | Version | Why |
| --- | --- | --- |
| **Node.js** | `>= 22.0.0` | Vite 7 dropped support for older Node. Use [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/Schniz/fnm). |
| **Node.js** | `>= 22.12.0` | Vite 8 requires Node `^20.19` or `>= 22.12`. Use [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/Schniz/fnm). |
| **npm** | bundled with Node 22 | The project uses npm; `pnpm` and `yarn` are not tested. |
| **Rust** | stable, `>= 1.78` | Required for the Tauri desktop build. Install via [rustup](https://rustup.rs/). |
| **Python** | `3.12` | Optional — only needed for some Tauri platform tooling on Windows. |
@@ -130,6 +130,10 @@ Disable corporate VPNs / proxies that block the npm registry. The lock file is c
Locale JSON is bundled at build time, not watched. Restart the dev server after editing `src/i18n/locales/*`.
Since v0.26, only English ships in the main chunk; the other languages are
lazy-loaded async chunks fetched on first use (see `src/i18n/index.ts` and
docs/I18N.md). The restart advice above still applies to all of them.
### Pre-commit hook fails on `validate:locales` but I didn't touch locales
You probably added a new key to `_schema.json` indirectly via the engine types (`src/engine/types.ts` → `CONTENT_WARNINGS`). New IDs require translations in all 6 locales.
+71 -8
View File
@@ -99,16 +99,44 @@ Mỗi ngôn ngữ có description structure như sau (tất cả sections option
4. ─── Store Links ─── (if any platform link provided)
5. ─── Video Settings ─── (resolution / FPS / graphics)
6. ─── My Rig ─── (if any rig field provided)
7. ─── Spoiler Warning ─── (if toggled)
8. ─── 18+ Warning ─── (if toggled)
9. ─── Donate Links ─── (if any provided)
10. ─── Social Links ─── (if any provided)
11. ─── Playlist Link ─── (if provided)
12. ─── Contact Email ─── (if provided)
13. CTA line (Like / Subscribe / Share)
14. Hashtags (3 max, auto-generated)
7. ─── Content Warnings ─── (if any selected — 248 IDs across 12 groups)
8. ─── Donate Links ─── (if any provided)
9. ─── Social Links ─── (if any provided)
10. ─── Playlist Link ─── (if provided)
11. ─── Contact Email ─── (if provided)
12. CTA line (Like / Subscribe / Share)
13. Hashtags (3 max, auto-generated)
```
## 🔁 Cross-Post Captions (Social tab)
A dedicated **Social** tab re-packages the same editor source that drives the
YouTube description into short-form captions for other platforms — no
re-typing. Each caption is derived live from the current form.
| Platform | Caption limit | Popular hashtags appended |
|----------|--------------|----------------------------|
| TikTok | 4,000 | `#fyp #foryou #foryoupage #gaming #gamingtiktok #gameplay #gamer` |
| Instagram Reels | 2,200 | `#reels #reelsinstagram #gaming #gamingreels #gamer #instagaming #videogames` |
| Facebook Reels | 2,200 | `#reels #facebookreels #fbreels #gaming #gameplay #gamingcommunity #videogames` |
Each caption pulls, in order: **Title** (quality badge suppressed for
short-form), **My Rig**, **Content Warnings**, **Thanks / sponsor credit**,
**Copyright**, and **hashtags** (game + primary genre + the curated
per-platform popular set, deduplicated case-insensitively).
- **Overflow handling** — when a caption exceeds the platform limit, optional
blocks are dropped in priority order (warnings → copyright → thanks → rig).
The title and the hashtag line are never dropped, and there is no
mid-string truncation.
- **Single mode** — platform tabs with a live character counter and
over-limit warning.
- **Bulk mode** — generate a part range (e.g. Parts 1–10) across selected
languages in one pass, reusing the Batch loop.
- **Import / Export** — round-trip the generated captions as a typed JSON
bundle (`_type: "social"`); import is display-only since captions are
derived artifacts (the source round-trips via Profiles / Presets).
## 🏷 Tag Generation
### Tag Pools by Category
@@ -222,6 +250,41 @@ interface HistoryEntry {
| Offline | Full functionality without internet |
| Global Hotkey | System-wide hotkey to open app (optional) |
## 🚦 Error Pages & Offline (v0.27)
A single reusable, fully-localized `ErrorPage` component (`src/components/errors/`)
backed by a pure kind→meta config (`src/config/error-pages.ts`). All copy ships
in every locale (en/vi/ja/es/ko/zh).
| Kind | Route | Trigger |
|------|-------|---------|
| 404 Not found | catch-all `*` | A mistyped / dead hash route (live — was a blank screen before) |
| 403 Forbidden | `/#/403` | Designed page, route-reachable for future triggers |
| 419 Expired | `/#/419` | Designed page, route-reachable for future triggers |
| 500 Server error | `/#/500` | Designed page (covers 408/5xx), route-reachable for future triggers |
| Offline | `/#/offline` + banner | `navigator.onLine` flips false |
| Runtime crash | — | A render error caught by `ErrorBoundary` (shared `contained` variant) |
- **Full-screen, no shell** — dedicated error routes render outside `AppShell`
(no Sidebar/Header), with Home / Back / (Reload) / Report-a-bug actions.
- **Non-blocking offline banner** — a dismissible bottom strip; the app stays
fully usable offline, and a toast confirms when the connection returns.
## ⚖️ Legal & Consent (v0.28)
A first-run **consent gate** (`src/components/ConsentGate.tsx`, backed by the
pure `src/config/legal.ts`) blocks the app until the user reviews the legal
documents and ticks one "I agree" checkbox.
| Aspect | Behaviour |
|--------|-----------|
| Documents | Terms of Use, Privacy Policy, Disclaimer, License — linked to the GitHub-hosted copies (open in the browser); also surfaced in About → Legal |
| Acceptance | One combined checkbox; Continue disabled until checked |
| Persistence | Stored in the existing settings record (`legalConsentVersion` + timestamp) — **no cookie, no new storage key** |
| Re-prompt | Version-based — only when `CURRENT_TERMS_VERSION` is raised (terms changed); also re-shows in fresh / incognito storage |
| Desktop | Same in-app gate on Windows/macOS/Linux, **plus** a license-acceptance page in the Windows MSI/NSIS installer (`bundle.licenseFile`) |
| Layout | Full-screen, non-dismissible, theme- and locale-aware (all 6 languages) |
## 🔌 Future Extension Points
| Extension | Description | Effort |
+10 -12
View File
@@ -17,7 +17,7 @@ These are independent: a Vietnamese user can browse the app in Vietnamese (UI) w
```
src/i18n/
├── index.ts # i18next initialization + language registration
├── index.ts # i18next init + SUPPORTED_LANGUAGES (en eager, others lazy-loaded)
├── locales/
│ ├── _schema.json # JSON Schema defining all required keys
│ ├── en/
@@ -206,25 +206,23 @@ cp -r src/i18n/locales/en src/i18n/locales/es
### Step 4: Register the language
```typescript
// src/i18n/index.ts — add to SUPPORTED_LANGUAGES
// src/i18n/index.ts — add to SUPPORTED_LANGUAGES (the only registration step)
export const SUPPORTED_LANGUAGES = [
{ id: "en", label: "English", flag: "🇬🇧", nativeName: "English" },
{ id: "vi", label: "Vietnamese", flag: "🇻🇳", nativeName: "Tiếng Việt" },
{ id: "ja", label: "Japanese", flag: "🇯🇵", nativeName: "日本語" },
{ id: "es", label: "Spanish", flag: "🇪🇸", nativeName: "Español" }, // ← Add here
] as const;
// Add resource import
import esUI from "./locales/es/ui.json";
import esTemplates from "./locales/es/templates.json";
// Add to i18next resources
resources: {
// ...existing
es: { ui: esUI, templates: esTemplates },
}
```
No import or `resources` edits needed (v0.26+): locales are lazy-loaded
through a dynamic `import("./locales/<code>/<ns>.json")`, so Vite picks the
new files up automatically as async chunks — **the file names must stay
exactly `ui.json` and `templates.json`**. Only English is eagerly bundled
(it's the `fallbackLng` and the engine's bilingual `tEn` source); don't add
static imports for other languages, that would drag them back into the
main chunk.
### Step 5: Add multilingual tag pool
```typescript
+10 -1
View File
@@ -27,7 +27,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Tauri CLI
cargo install tauri-cli
# Node.js 20+
# Node.js 22+
# npm already installed from web development
# Platform-specific
@@ -108,6 +108,15 @@ This creates `src-tauri/` directory.
}
```
> **Installer license page (v0.28).** The real `src-tauri/tauri.conf.json`
> sets `bundle.licenseFile: "installer-license.txt"` (path relative to
> `src-tauri/`). Tauri shows that file as an "accept the terms" page in the
> **Windows MSI/NSIS** installers. macOS `.app`/`.dmg` and the Linux packages
> have no interactive license step, so they rely on the app's first-run
> consent gate instead. If a WiX/MSI build ever rejects the `.txt`, switch to
> the per-bundler keys (`bundle.windows.wix.licenseFile` wants `.rtf`,
> `bundle.windows.nsis.licenseFile` accepts `.txt`).
### 3. Rust Backend (src-tauri/src/main.rs)
```rust
+7 -7
View File
@@ -317,8 +317,8 @@ jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: 22
cache: npm
@@ -350,19 +350,19 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm run build
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
- uses: actions/configure-pages@v6
- uses: actions/upload-pages-artifact@v5
with:
path: dist
- id: deployment
uses: actions/deploy-pages@v4
uses: actions/deploy-pages@v5
```
## 5. Testing Strategy
+23 -11
View File
@@ -95,7 +95,7 @@ Các nhóm bulk-select trong editor: **All RPGs** (rpg + jrpg + action_rpg + crp
---
## 3. Cảnh báo nội dung (187, chia nhóm)
## 3. Cảnh báo nội dung (248, chia nhóm)
Cảnh báo được chọn sẽ thêm vào khối `⚠ CONTENT WARNINGS` trong description, trước phần timestamp. Mỗi nhóm có thể thu gọn trong editor; cảnh báo hiển thị theo thứ tự người dùng chọn.
@@ -103,25 +103,37 @@ Cảnh báo được chọn sẽ thêm vào khối `⚠ CONTENT WARNINGS` trong
Spoiler cốt truyện / ending · Spoiler ending · Spoiler ending thật · Spoiler hậu game / NG+ · Spoiler ending bí mật · Spoiler cốt truyện DLC
### Sức khỏe / Quang nhạy (6)
### Sức khỏe / Quang nhạy (13)
Đèn nháy · Say tàu xe · Kích thích migraine · Âm thanh lớn / đột ngột · Hiệu ứng strobe · Rung hình mạnh
Hiệu ứng chớp sáng · Say game / camera nhanh · Có thể đau nửa đầu · Đèn nhấp nháy · Rung màn hình mạnh · Loé sáng / lens flare · Bloom quá đà / sáng cháy · Hiệu ứng hạt dày đặc · HUD / overlay nhấp nháy · Màu sắc quá rực / loè loẹt · Motion blur nặng · Depth of field gắt · Post-processing đậm đặc
### Ám ảnh / Phobia (51)
### Âm thanh / Cảm âm (13)
Jumpscare · Sợ độ cao (acrophobia) · Sợ lỗ / cụm (trypophobia) · Sợ nước sâu (thalassophobia) · Sợ không gian kín (claustrophobia) · Sợ nhện (arachnophobia) · Sợ côn trùng (entomophobia) · Sợ rắn (ophidiophobia) · Sợ chó (cynophobia) · Sợ bóng tối (nyctophobia) · Sợ lửa (pyrophobia) · Sợ búp bê (pediophobia) · Sợ máu (hemophobia) · Sợ chú hề (coulrophobia) · Sợ chết đuối (ablutophobia) · Sợ bị chôn sống (taphophobia) · Hình nhân máy (automatonophobia) · Vật thể khổng lồ (megalophobia) · Vật nhân tạo dưới nước (submechanophobia) · Xác chết (necrophobia) · Ma quỷ (spectrophobia) · Quỷ dữ (demonophobia) · Cá mập (selachophobia) · Vi trùng / ô nhiễm (mysophobia) · Nôn mửa (emetophobia) · Bị nhìn chằm chằm (scopophobia) · Cô lập (monophobia) · Chuột (musophobia) · Dơi (chiroptophobia) · Chim (ornithophobia) · Cá (ichthyophobia) · Bò sát (herpetophobia) · Gián (katsaridaphobia) · Ong (apiphobia) · Sấm sét (astraphobia) · Không gian rộng (agoraphobia) · Đám đông (enochlophobia) · Tuyết / giá lạnh (chionophobia) · Bệnh viện (nosocomephobia) · Vật sắc nhọn (aichmophobia) · Nghẹt thở (pnigophobia) · Sương mù (homichlophobia) · Lốc xoáy / bão (lilapsophobia) · Mưa lớn (ombrophobia) · Mây / trời u ám (nephophobia) · Gió mạnh (ancraophobia) · Cực lạnh (cryophobia) · Ánh nắng gay gắt (heliophobia) · Sóng lớn (cymophobia) · Hồ / nước tĩnh (limnophobia) · Sông / dòng chảy (potamophobia)
Âm thanh đột ngột · Âm chói tai / tần số cao · Jumpscare bằng âm thanh · Thay đổi âm lượng đột ngột · Âm thanh méo / vỡ · Tiếng ken két / kim loại · Tiếng cao kéo dài · Lỗi âm thanh / glitch · Bass nặng / sub-bass rung · Tiếng la hét kéo dài · Tiếng kính vỡ / va đập · Tạp âm mic / tiếng thở · Tiếng nhiễu / tĩnh điện
### Lời thoại / Ngôn từ (10)
Văng tục dày đặc · Lời thoại ẩn ý t*nh d*c · Lời thoại kích động · Lăng mạ / sỉ nhục bằng lời · Lời đe dọa / uy hiếp · Từ ngữ miệt thị / xúc phạm · Hài thô tục · Hài người lớn · Hài đen / u tối · Nhắc đến chất kích thích / đồ có cồn
### Ám ảnh / Phobia (56)
Jumpscare · Sợ độ cao (acrophobia) · Sợ lỗ / cụm (trypophobia) · Sợ nước sâu (thalassophobia) · Sợ không gian kín (claustrophobia) · Sợ nhện (arachnophobia) · Sợ côn trùng (entomophobia) · Sợ rắn (ophidiophobia) · Sợ chó (cynophobia) · Sợ bóng tối (nyctophobia) · Sợ lửa (pyrophobia) · Sợ búp bê (pediophobia) · Sợ máu (hemophobia) · Sợ chú hề (coulrophobia) · Sợ chết đuối (ablutophobia) · Sợ bị chôn sống (taphophobia) · Hình nhân máy (automatonophobia) · Vật thể khổng lồ (megalophobia) · Vật nhân tạo dưới nước (submechanophobia) · Xác chết (necrophobia) · Ma quỷ (spectrophobia) · Quỷ dữ (demonophobia) · Cá mập (selachophobia) · Vi trùng / ô nhiễm (mysophobia) · Nôn mửa (emetophobia) · Bị nhìn chằm chằm (scopophobia) · Cô lập (monophobia) · Chuột (musophobia) · Dơi (chiroptophobia) · Chim (ornithophobia) · Cá (ichthyophobia) · Bò sát (herpetophobia) · Gián (katsaridaphobia) · Ong (apiphobia) · Sấm sét (astraphobia) · Không gian rộng (agoraphobia) · Đám đông (enochlophobia) · Tuyết / giá lạnh (chionophobia) · Bệnh viện (nosocomephobia) · Vật sắc nhọn (aichmophobia) · Nghẹt thở (pnigophobia) · Sương mù (homichlophobia) · Lốc xoáy / bão (lilapsophobia) · Mưa lớn (ombrophobia) · Mây / trời u ám (nephophobia) · Gió mạnh (ancraophobia) · Cực lạnh (cryophobia) · Ánh nắng gay gắt (heliophobia) · Sóng lớn (cymophobia) · Hồ / nước tĩnh (limnophobia) · Sông / dòng chảy (potamophobia) · Sợ màu sắc / cảnh màu chói (chromophobia) · Sợ màu đỏ / cảnh toàn đỏ (erythrophobia) · Sợ màu vàng (xanthophobia) · Sợ màu trắng / không gian toàn trắng (leukophobia) · Sợ màu đen (melanophobia)
### Sức khỏe tâm thần (17)
Cảnh gây lo âu · Trầm cảm · Rối loạn ăn uống · Sử dụng chất kích thích · Tự hại / tự tử · PTSD · Kim tiêm · Dịch cơ thể · Mang thai / sinh nở kinh dị · Bệnh tật / nhiễm trùng · Lưỡng cực · OCD · Hoảng loạn · Phân ly · Hoang tưởng · Suy nghĩ xâm nhập · Y khoa kinh dị
### Hiện tượng tâm lý — xã hội (20)
### Hiện tượng tâm lý — xã hội (22)
Tự kỷ / thần kinh đa dạng · ADHD / rối loạn tập trung · Hikikomori / ẩn dật xã hội · NEET (không học không làm) · Lo âu xã hội · Cô lập xã hội / cô đơn · Tâm thần phân liệt / loạn thần · Burnout / kiệt sức · Mặc cảm sống sót · Bị bỏ rơi / sang chấn · Quan hệ parasocial · Gaslighting / thao túng · Hội chứng Stockholm · Nghiện game / cờ bạc · Khủng hoảng hiện sinh · Hội chứng kẻ mạo danh · Khủng hoảng tuổi trung niên · Khủng hoảng tuổi 1/4 · Quấy rối nơi làm việc · Áp lực vai trò giới
Tự kỷ / thần kinh đa dạng · ADHD / rối loạn tập trung · Hikikomori / ẩn dật xã hội · NEET (không học không làm) · Lo âu xã hội · Cô lập xã hội / cô đơn · Tâm thần phân liệt / loạn thần · Burnout / kiệt sức · Mặc cảm sống sót · Bị bỏ rơi / sang chấn · Quan hệ parasocial · Gaslighting / thao túng · Hội chứng Stockholm · Nghiện game / cờ bạc · Khủng hoảng hiện sinh · Hội chứng kẻ mạo danh · Khủng hoảng tuổi trung niên · Khủng hoảng tuổi 1/4 · Quấy rối nơi làm việc · Áp lực vai trò giới · Miệt thị ngoại hình (body shaming) · Chuẩn mực ngoại hình phi thực tế
### Nội dung nhạy cảm / 18+ (61)
### Internet / Đời sống số (18)
Máu me · 18+ · Hình ảnh gây khó chịu · B*o h*nh động vật · Trẻ em chịu tác động · B*o h*nh gia đình · Tham chiếu x*m h*i t*nh d*c · Tra tấn · Tôn giáo · Tác động vật lý chiến tranh · Phân biệt đối xử · Tác động vật lý từ chính quyền · Hút thuốc / uống rượu · G*ết người chi tiết · Tà giáo / huyền bí · Thao túng tâm lý · Mất mát / đau buồn · Bắt cóc · Phát ngôn thù hận · Tội ác lịch sử · Nô lệ · Khủng bố · Bắt nạt · Thử nghiệm trên người · Ăn thịt người · Hạt nhân / phóng xạ · Kỳ thị người đồng tính / LGBTQ+ (homophobia) · Kỳ thị người chuyển giới (transphobia) · Bài ngoại (xenophobia) · Cực đoan chính trị · Cực đoan tôn giáo / cuồng tín · Diệt chủng / thanh trừng sắc tộc · Thánh chiến / xung đột tôn giáo · Đại nạn Holocaust · Nội chiến · Xả súng hàng loạt / xả súng trường học · Chủ nghĩa thực dân / đế quốc · Tuyên truyền nhà nước · Nhà nước giám sát / dystopia · Thuyết âm mưu · Kiểm duyệt / cấm phát ngôn · Xung đột sắc tộc / chủng tộc · Khủng hoảng tị nạn · Cách mạng / nổi dậy · Ám sát chính trị · Đảo chính · Toà án dị giáo / săn phù thủy · Lao động cưỡng bức · Chủ nghĩa dân tộc cực đoan · Treo c* / siết c* · Cảnh ch*t đuối · Cảnh thiêu s*ng · Cảnh ngạt th* · Bị trói / cầm tù tra tấn · Cảnh hành quyết công khai · Cảnh chặt đầu · Cảnh đâm xuyên cơ thể · Thương vong hàng loạt · Tác động vật lý bằng phương tiện · Cảnh sử dụng quá liều · Ngã / nhảy từ trên cao
Bắt nạt / quấy rối qua mạng · Doxxing / phơi bày thông tin cá nhân · Trolling / phá game · Văn hóa tẩy chay / bêu rếu công khai · Nghiện mạng xã hội · Lướt tin tiêu cực vô độ (doomscrolling) · Hội chứng sợ bỏ lỡ (FOMO) · Tin giả / thông tin sai lệch · Lừa đảo trực tuyến / phishing · Giả mạo danh tính trên mạng (catfishing) · Deepfake / nội dung giả mạo bằng AI · Theo dõi / rình rập qua mạng · Trào lưu / thử thách nguy hiểm trên mạng · Văn hóa influencer / câu tương tác · Cực đoan hóa qua mạng / buồng vang thông tin · Loot box / cơ chế gacha · Chủ đề AI / trí tuệ nhân tạo · Riêng tư dữ liệu / giám sát diện rộng
### Nội dung nhạy cảm / 18+ (66)
Máu me · 18+ · Trang phục hở hang · Kh*a th*n một phần · Tạo hình nhân vật bị t*nh d*c hóa · Yếu tố fan service · Tư thế / góc quay gợi cảm · Hình ảnh gây khó chịu · B*o h*nh động vật · Trẻ em chịu tác động · B*o h*nh gia đình · Tham chiếu x*m h*i t*nh d*c · Tra tấn · Tôn giáo · Tác động vật lý chiến tranh · Phân biệt đối xử · Tác động vật lý từ chính quyền · Hút thuốc / uống rượu · G*ết người chi tiết · Tà giáo / huyền bí · Thao túng tâm lý · Mất mát / đau buồn · Bắt cóc · Phát ngôn thù hận · Tội ác lịch sử · Nô lệ · Khủng bố · Bắt nạt · Thử nghiệm trên người · Ăn thịt người · Hạt nhân / phóng xạ · Kỳ thị người đồng tính / LGBTQ+ (homophobia) · Kỳ thị người chuyển giới (transphobia) · Bài ngoại (xenophobia) · Cực đoan chính trị · Cực đoan tôn giáo / cuồng tín · Diệt chủng / thanh trừng sắc tộc · Thánh chiến / xung đột tôn giáo · Đại nạn Holocaust · Nội chiến · Xả súng hàng loạt / xả súng trường học · Chủ nghĩa thực dân / đế quốc · Tuyên truyền nhà nước · Nhà nước giám sát / dystopia · Thuyết âm mưu · Kiểm duyệt / cấm phát ngôn · Xung đột sắc tộc / chủng tộc · Khủng hoảng tị nạn · Cách mạng / nổi dậy · Ám sát chính trị · Đảo chính · Toà án dị giáo / săn phù thủy · Lao động cưỡng bức · Chủ nghĩa dân tộc cực đoan · Treo c* / siết c* · Cảnh ch*t đuối · Cảnh thiêu s*ng · Cảnh ngạt th* · Bị trói / cầm tù tra tấn · Cảnh hành quyết công khai · Cảnh chặt đầu · Cảnh đâm xuyên cơ thể · Thương vong hàng loạt · Tác động vật lý bằng phương tiện · Cảnh sử dụng quá liều · Ngã / nhảy từ trên cao
### Kinh dị nặng (12)
@@ -131,9 +143,9 @@ Mắt / cụm mắt · Body horror (biến dạng cơ thể) · Mặt biến d
Lần đầu chơi (blind) · Không spoiler trong chat · Chế độ easy / story · Chế độ khó cao · Permadeath / Iron Man · Thử speedrun · 100% completionist · Đang học cơ chế · Chơi lần đầu · Chơi lại / NG+
### Thông tin về gameplay (4)
### Thông tin về gameplay (5)
Dùng mod · Bật cheat / debug · Dùng glitch · Có guide hỗ trợ
Dùng mod · Bật cheat / debug · Dùng glitch · Có guide hỗ trợ · Game mục đích giáo dục / tuyên truyền
---
+5 -1
View File
@@ -25,7 +25,7 @@ Cài theo thứ tự:
| Công cụ | Phiên bản | Lý do |
| --- | --- | --- |
| **Node.js** | `>= 22.0.0` | Vite 7 đã bỏ hỗ trợ Node cũ. Dùng [nvm](https://github.com/nvm-sh/nvm) hoặc [fnm](https://github.com/Schniz/fnm). |
| **Node.js** | `>= 22.12.0` | Vite 8 yêu cầu Node `^20.19` hoặc `>= 22.12`. Dùng [nvm](https://github.com/nvm-sh/nvm) hoặc [fnm](https://github.com/Schniz/fnm). |
| **npm** | đi kèm Node 22 | Dự án dùng npm; `pnpm` và `yarn` chưa test. |
| **Rust** | stable, `>= 1.78` | Bắt buộc cho build Tauri. Cài qua [rustup](https://rustup.rs/). |
| **Python** | `3.12` | Tùy chọn — chỉ cần cho một số tooling Tauri trên Windows. |
@@ -132,6 +132,10 @@ Tắt VPN/proxy doanh nghiệp chặn npm registry. Lock file đã commit; insta
Locale JSON bundle vào lúc build, không được watch. Restart dev server sau khi sửa `src/i18n/locales/*`.
Từ v0.26, chỉ tiếng Anh nằm trong main chunk; các ngôn ngữ khác là async
chunk lazy-load, tải khi dùng lần đầu (xem `src/i18n/index.ts` và
docs/I18N.md). Lời khuyên restart ở trên vẫn áp dụng cho tất cả.
### Pre-commit hook fail ở `validate:locales` mà mình không động đến locale
Có thể bạn vô tình thêm key mới vào `_schema.json` thông qua `src/engine/types.ts` → `CONTENT_WARNINGS`. ID mới cần dịch ở cả 6 locale.
+771 -641
View File
File diff suppressed because it is too large. Load diff
+6 -5
View File
@@ -1,6 +1,6 @@
{
"name": "yt-desc-gen",
"version": "0.22.0",
"version": "0.28.0",
"private": true,
"license": "Apache-2.0",
"type": "module",
@@ -30,6 +30,7 @@
"@tauri-apps/plugin-shell": "^2.0.0",
"clsx": "^2.1.0",
"i18next": "^23.15.0",
"i18next-resources-to-backend": "^1.2.1",
"lucide-react": "^0.400.0",
"react": "^18.3.0",
"react-dom": "^18.3.0",
@@ -44,7 +45,7 @@
"@testing-library/react": "^16.0.0",
"@types/react": "^18.3.0",
"@types/react-dom": "^18.3.0",
"@vitejs/plugin-react": "^4.3.0",
"@vitejs/plugin-react": "^5.2.0",
"autoprefixer": "^10.4.0",
"eslint": "^9.0.0",
"eslint-plugin-react-hooks": "^5.0.0",
@@ -53,10 +54,10 @@
"prettier": "^3.3.0",
"prettier-plugin-tailwindcss": "^0.6.0",
"tailwindcss": "^3.4.0",
"tsx": "^4.16.0",
"tsx": "^4.22.4",
"typescript": "^5.5.0",
"typescript-eslint": "^8.0.0",
"vite": "^7.3.3",
"vitest": "^3.2.4"
"vite": "^8.0.16",
"vitest": "^4.1.8"
}
}
+1 -3
View File
@@ -5535,10 +5535,8 @@ dependencies = [
[[package]]
name = "yt-desc-gen"
version = "0.21.0"
version = "0.28.0"
dependencies = [
"serde",
"serde_json",
"tauri",
"tauri-build",
"tauri-plugin-dialog",
+1 -3
View File
@@ -1,6 +1,6 @@
[package]
name = "yt-desc-gen"
version = "0.22.0"
version = "0.28.0"
description = "YouTube Gameplay Description Generator"
authors = ["poli0981"]
edition = "2021"
@@ -20,5 +20,3 @@ tauri-plugin-fs = "2"
tauri-plugin-opener = "2"
tauri-plugin-shell = "2"
tauri-plugin-single-instance = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
+30
View File
@@ -0,0 +1,30 @@
YTDescGen — Installation & Terms Notice
=======================================
By installing and using YTDescGen, you confirm that you have read and agree
to the following documents:
Terms of Use: https://github.com/poli0981/youtube-generator/blob/main/TERMS.md
Privacy Policy: https://github.com/poli0981/youtube-generator/blob/main/PRIVACY.md
Disclaimer: https://github.com/poli0981/youtube-generator/blob/main/DISCLAIMER.md
License: https://github.com/poli0981/youtube-generator/blob/main/LICENSE
In short:
* YTDescGen is free, open-source software, provided AS IS, WITHOUT WARRANTY
OF ANY KIND. You use it at your own risk (see the Disclaimer and License
sections 7-8).
* It works fully offline. It does not collect, transmit, or sell any
personal data; your profiles, history, and generated text stay on your
device (see the Privacy Policy).
* You are responsible for ensuring the titles, descriptions, and tags you
generate comply with YouTube's policies and applicable law (see the
Terms of Use).
* YTDescGen is an independent project and is not affiliated with, endorsed
by, or sponsored by YouTube, Google, or any game publisher.
The software itself is licensed under the Apache License, Version 2.0. The
full license text is included with this distribution and is available at the
License URL above.
If you do not agree to these terms, do not install or use the software.
+2 -1
View File
@@ -1,7 +1,7 @@
{
"$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-cli/schema.json",
"productName": "YTDescGen",
"version": "0.22.0",
"version": "0.28.0",
"identifier": "com.skullmute.ytdescgen",
"build": {
"beforeBuildCommand": "npm run build",
@@ -35,6 +35,7 @@
},
"bundle": {
"active": true,
"licenseFile": "installer-license.txt",
"icon": [
"icons/32x32.png",
"icons/128x128.png",
+45
View File
@@ -4,6 +4,10 @@ import { Toaster } from "react-hot-toast";
import toast from "react-hot-toast";
import { AppShell } from "@components/layout/AppShell";
import { ErrorBoundary } from "@components/ErrorBoundary";
import { ErrorPage } from "@components/errors/ErrorPage";
import { OfflineBanner } from "@components/errors/OfflineBanner";
import { ConsentGate } from "@components/ConsentGate";
import { needsConsent } from "@config/legal";
import { EditorPage } from "@pages/EditorPage";
import { OutputPage } from "@pages/OutputPage";
import { checkDataFileHealth } from "@utils/storage-adapter";
@@ -23,6 +27,9 @@ const SettingsPage = lazy(() =>
const BatchPage = lazy(() =>
import("@pages/BatchPage").then((m) => ({ default: m.BatchPage })),
);
const SocialPage = lazy(() =>
import("@pages/SocialPage").then((m) => ({ default: m.SocialPage })),
);
const PlaylistPage = lazy(() =>
import("@pages/PlaylistPage").then((m) => ({ default: m.PlaylistPage })),
);
@@ -98,6 +105,30 @@ export default function App() {
return () => unsub();
}, []);
// v0.28.0: first-run legal consent gate. Until the user accepts the current
// terms version, render the gate INSTEAD of the router so nothing in the app
// is reachable. The whole tree stays inside the root ErrorBoundary
// (main.tsx), so a gate render error still degrades to the error page.
const legalConsentVersion = useSettingsStore((s) => s.legalConsentVersion);
if (needsConsent(legalConsentVersion)) {
return (
<>
<ConsentGate />
<Toaster
position="bottom-right"
toastOptions={{
style: {
background: "var(--surface-2)",
color: "var(--text-primary)",
border: "1px solid var(--border)",
},
}}
/>
</>
);
}
return (
<>
<HashRouter>
@@ -135,6 +166,10 @@ export default function App() {
path="batch"
element={<PageBoundary label="Batch"><BatchPage /></PageBoundary>}
/>
<Route
path="social"
element={<PageBoundary label="Social"><SocialPage /></PageBoundary>}
/>
<Route
path="playlist"
element={<PageBoundary label="Playlist"><PlaylistPage /></PageBoundary>}
@@ -148,7 +183,17 @@ export default function App() {
element={<PageBoundary label="About"><AboutPage /></PageBoundary>}
/>
</Route>
{/* Designed error pages — siblings of the AppShell group so they
render full-screen with no Sidebar/Header. `403/419/500` are
route-reachable for future triggers; `*` is the live 404 for
any mistyped hash path. */}
<Route path="/403" element={<ErrorPage kind="forbidden" />} />
<Route path="/419" element={<ErrorPage kind="expired" />} />
<Route path="/500" element={<ErrorPage kind="serverError" />} />
<Route path="/offline" element={<ErrorPage kind="offline" />} />
<Route path="*" element={<ErrorPage kind="notFound" />} />
</Routes>
<OfflineBanner />
</HashRouter>
<Toaster
position="bottom-right"
+74
View File
@@ -0,0 +1,74 @@
import { useState } from "react";
import { useTranslation } from "react-i18next";
import { ExternalLink, ShieldCheck } from "lucide-react";
import { Button } from "@components/ui/Button";
import { Checkbox } from "@components/ui/Checkbox";
import { useDocumentTitle } from "@hooks/use-document-title";
import { useSettingsStore } from "@store/settings-store";
import { LEGAL_DOCS } from "@config/legal";
/**
* First-run legal consent gate. Rendered full-screen and **non-dismissible**
* (no ESC / backdrop / X — deliberately NOT the {@link import("@components/ui/Modal").Modal})
* in place of the router until the user accepts the current terms version.
*
* Layout mirrors the v0.27.0 ErrorPage fullscreen pattern. Acceptance is
* recorded in the settings store (`acceptLegalConsent`), which dual-writes to
* localStorage + the Tauri settings file; the gate then yields to the app.
* Re-shows automatically when CURRENT_TERMS_VERSION is bumped, and in fresh /
* incognito storage.
*/
export function ConsentGate() {
const { t } = useTranslation("ui");
const [agreed, setAgreed] = useState(false);
useDocumentTitle(t("consentGate.title"));
const onContinue = (): void => {
if (!agreed) return;
useSettingsStore.getState().acceptLegalConsent();
};
return (
<div
role="dialog"
aria-modal="true"
aria-labelledby="consent-title"
className="flex min-h-screen flex-col items-center justify-center gap-6 bg-surface-0 px-6 py-12 text-center"
>
<ShieldCheck className="h-14 w-14 text-accent" aria-hidden />
<div className="max-w-md space-y-2">
<h1 id="consent-title" className="text-2xl font-semibold text-text-primary">
{t("consentGate.title")}
</h1>
<p className="text-sm text-text-secondary">{t("consentGate.intro")}</p>
</div>
<div className="grid w-full max-w-md gap-2 sm:grid-cols-2">
{LEGAL_DOCS.map((doc) => (
<a
key={doc.id}
href={doc.url}
target="_blank"
rel="noopener noreferrer"
className="flex items-center gap-3 rounded-lg border border-border bg-surface-1 px-3 py-2.5 text-sm text-text-primary transition-colors hover:border-accent hover:bg-surface-2"
>
<span className="flex-1 truncate text-left">{t(doc.labelKey)}</span>
<ExternalLink className="h-3.5 w-3.5 shrink-0 text-text-muted" />
</a>
))}
</div>
<div className="w-full max-w-md rounded-lg border border-border bg-surface-1 p-4">
<Checkbox checked={agreed} onChange={setAgreed} label={t("consentGate.agreeLabel")} />
</div>
<div className="flex flex-col items-center gap-2">
<Button variant="primary" onClick={onContinue} disabled={!agreed}>
{t("consentGate.continue")}
</Button>
{!agreed && <p className="text-xs text-text-muted">{t("consentGate.mustAgree")}</p>}
</div>
</div>
);
}
+10 -42
View File
@@ -1,5 +1,5 @@
import { Component, type ErrorInfo, type ReactNode } from "react";
import { AlertTriangle, RotateCcw } from "lucide-react";
import { ErrorPage } from "@components/errors/ErrorPage";
interface ErrorBoundaryProps {
/** Children to render normally. The boundary only kicks in on render
@@ -77,51 +77,19 @@ export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundarySt
this.setState({ error: null });
};
private handleReload = (): void => {
window.location.reload();
};
render(): ReactNode {
if (!this.state.error) return this.props.children;
const label = this.props.label ?? "this section";
// The visible copy is now generic + localized via the shared ErrorPage
// (contained variant). The `label` is still logged in componentDidCatch
// so bug reports keep the "which subtree crashed" context.
return (
<div className="flex min-h-[200px] items-center justify-center p-6">
<div className="w-full max-w-md rounded-lg border border-danger/40 bg-surface-2 p-5 shadow-md shadow-black/10">
<div className="mb-3 flex items-center gap-2 text-danger">
<AlertTriangle className="h-4 w-4" />
<h2 className="text-sm font-semibold">
Something went wrong in {label}
</h2>
</div>
<p className="mb-3 text-xs text-text-secondary">
The app caught a render error before it could crash the page.
Your data is safe — the error has been logged to the Logs
tab.
</p>
<pre className="mb-4 max-h-32 overflow-auto whitespace-pre-wrap rounded bg-surface-3 p-2 text-[11px] text-text-muted">
{this.state.error.message}
</pre>
<div className="flex flex-wrap gap-2">
<button
type="button"
onClick={this.handleReset}
className="inline-flex items-center gap-1.5 rounded bg-accent px-3 py-1.5 text-xs font-semibold text-white hover:bg-accent-hover"
>
<RotateCcw className="h-3.5 w-3.5" />
Try again
</button>
<button
type="button"
onClick={this.handleReload}
className="inline-flex items-center gap-1.5 rounded border border-border bg-surface-2 px-3 py-1.5 text-xs font-semibold text-text-primary hover:bg-surface-3"
>
Reload page
</button>
</div>
</div>
</div>
<ErrorPage
kind="runtime"
variant="contained"
onReset={this.handleReset}
detail={this.state.error.message}
/>
);
}
}
+57 -16
View File
@@ -6,6 +6,8 @@ import {
RIG_FIELDS,
parseCascadingValue,
parseCompositeValue,
resolveCompositeOptions,
resolveCompositeLabelKey,
type RigField,
type CompositePart,
} from "@config/rig-fields";
@@ -13,7 +15,7 @@ import { GPU_CUSTOM_BRAND_ID, findGpuBrand } from "@config/gpu-catalog";
import { useEditorStore } from "@store/editor-store";
import {
validateGpuValue,
validateRamValue,
validateCompositeField,
type RigValidationIssue,
} from "@utils/rig-validation";
@@ -136,22 +138,71 @@ export function RigEditor() {
if (!field.composite) return null;
const raw = rig[field.id] ?? "";
const { parts: storedParts } = parseCompositeValue(raw);
const issue = validateRamValue(raw);
// Validate per field — only RAM has size/DDR semantics. Running the
// RAM validator on the OS composite mis-fired "Pick a DDR generation."
const issue = validateCompositeField(field.id, raw);
const partValues = field.composite.parts.map(
(_p, i) => storedParts[i] ?? "",
);
// v0.23.0: setting a part also resets all downstream parts to "" so
// a cascading parent change can't leave the form with a stale child
// value that no longer exists in the new option list (e.g. switching
// OS name from Windows to macOS clears any leftover "11" / "Pro").
const setPart = (index: number, next: string) => {
const updated = [...partValues];
updated[index] = next;
for (let j = index + 1; j < updated.length; j++) {
updated[j] = "";
}
setNested("rig", field.id, joinComposite(updated));
};
const renderPart = (part: CompositePart, index: number) => {
// Walk parts in declaration order; each part's resolvers see the
// previously-rendered values so cascading option lists / dynamic
// labels / hidden-when predicates work cleanly.
const previousValues: string[] = [];
const renderedParts: React.ReactNode[] = [];
field.composite.parts.forEach((part, index) => {
const stored = partValues[index] ?? "";
// hiddenWhen short-circuits BEFORE we render — and we still push
// the stored value into previousValues so a later visible part
// sees the full history (though in practice, parts after a
// hidden one are rare).
if (part.hiddenWhen?.(previousValues)) {
previousValues.push(stored);
return;
}
renderedParts.push(renderPart(part, index, previousValues, setPart));
previousValues.push(stored);
});
return (
<div key={field.id} className="col-span-2 flex flex-col gap-2">
<span className="text-sm font-medium text-text-secondary">{t(field.labelKey)}</span>
<div className="grid grid-cols-2 gap-2">
{renderedParts}
</div>
{renderValidationBadge(issue)}
</div>
);
// Inner closure — needs access to `t`, `partValues`, and the part-
// local mutators. Defined as a function so the forEach above stays
// readable; not hoisted out because it captures lexical state.
function renderPart(
part: CompositePart,
index: number,
previousValues: readonly string[],
setPart: (index: number, next: string) => void,
) {
const stored = partValues[index] ?? "";
const isCustom = part.allowCustom && stored.startsWith(CUSTOM_PREFIX);
const customText = isCustom ? stored.slice(CUSTOM_PREFIX.length) : "";
const selectValue = isCustom ? "custom" : stored;
const options = resolveCompositeOptions(part.options, previousValues);
const labelKey = resolveCompositeLabelKey(part, previousValues);
const onSelectChange = (next: string) => {
if (next === "custom" && part.allowCustom) {
@@ -167,9 +218,9 @@ export function RigEditor() {
return (
<div key={part.id} className="flex flex-col gap-1">
<Select
label={t(part.labelKey)}
label={t(labelKey)}
value={selectValue}
options={part.options}
options={options}
onChange={onSelectChange}
/>
{isCustom && part.allowCustom && (
@@ -187,17 +238,7 @@ export function RigEditor() {
)}
</div>
);
};
return (
<div key={field.id} className="col-span-2 flex flex-col gap-2">
<span className="text-sm font-medium text-text-secondary">{t(field.labelKey)}</span>
<div className="grid grid-cols-2 gap-2">
{field.composite.parts.map((p, i) => renderPart(p, i))}
</div>
{renderValidationBadge(issue)}
</div>
);
}
};
const renderDropdownWithVersion = (field: RigField) => {
+151
View File
@@ -0,0 +1,151 @@
import { useTranslation } from "react-i18next";
import { House, ArrowLeft, RotateCw, RotateCcw, Bug } from "lucide-react";
import clsx from "clsx";
import { Button } from "@components/ui/Button";
import { useDocumentTitle } from "@hooks/use-document-title";
import { ABOUT } from "@config/about";
import { resolveErrorMeta, severityTextClass, type ErrorKind } from "@config/error-pages";
interface ErrorPageProps {
/** Which designed error to render. */
kind: ErrorKind;
/** `fullscreen` (default) for standalone routes — no app shell. `contained`
* for the in-place {@link import("@components/ErrorBoundary").ErrorBoundary}
* fallback card. */
variant?: "fullscreen" | "contained";
/** Reset handler for the `contained` boundary fallback ("Try again"). */
onReset?: () => void;
/** Optional technical detail (error message) shown in the contained card. */
detail?: string;
}
/**
* Shared presentational error page, dispatching to a full-screen route page or
* the contained boundary card.
*
* Intentionally **router-agnostic**: the root ErrorBoundary in `main.tsx`
* mounts *outside* `<HashRouter>`, so calling `useNavigate()` here would throw
* "useNavigate may be used only in the context of a Router" inside the very
* crash path it is meant to handle. Navigation is therefore plain hash anchors
* (`#/`) + `history.back()`, which work whether or not a Router is above.
*
* The dispatcher itself calls no hooks, so each variant component owns its own
* unconditional hook calls (no hook-order hazard across the branch).
*/
export function ErrorPage(props: ErrorPageProps) {
return props.variant === "contained" ? (
<ContainedError {...props} />
) : (
<FullscreenError {...props} />
);
}
function FullscreenError({ kind }: ErrorPageProps) {
const { t } = useTranslation("ui");
const meta = resolveErrorMeta(kind);
const Icon = meta.icon;
const colour = severityTextClass(meta.severity);
const title = t(`errorPages.${meta.keyPrefix}.title`);
const description = t(`errorPages.${meta.keyPrefix}.description`);
const canReload = kind === "serverError" || kind === "runtime";
useDocumentTitle(title);
return (
<div className="flex min-h-screen flex-col items-center justify-center gap-6 bg-surface-0 px-6 py-12 text-center">
<Icon className={clsx("h-16 w-16", colour)} aria-hidden />
{meta.code !== null && (
<p className={clsx("font-mono text-6xl font-bold leading-none tabular-nums", colour)}>
{meta.code}
</p>
)}
<div className="max-w-md space-y-2">
<h1 className="text-2xl font-semibold text-text-primary">{title}</h1>
<p className="text-sm text-text-secondary">{description}</p>
</div>
<div className="flex flex-wrap items-center justify-center gap-3">
<Button
variant="primary"
onClick={() => {
window.location.hash = "#/";
}}
>
<House className="h-4 w-4" />
{t("errorPages.actions.home")}
</Button>
<Button variant="secondary" onClick={() => window.history.back()}>
<ArrowLeft className="h-4 w-4" />
{t("errorPages.actions.back")}
</Button>
{canReload && (
<Button variant="secondary" onClick={() => window.location.reload()}>
<RotateCw className="h-4 w-4" />
{t("errorPages.actions.reload")}
</Button>
)}
<ReportBugLink />
</div>
</div>
);
}
function ContainedError({ kind, onReset, detail }: ErrorPageProps) {
const { t } = useTranslation("ui");
const meta = resolveErrorMeta(kind);
const Icon = meta.icon;
const colour = severityTextClass(meta.severity);
const title = t(`errorPages.${meta.keyPrefix}.title`);
const description = t(`errorPages.${meta.keyPrefix}.description`);
return (
<div className="flex min-h-[200px] items-center justify-center p-6">
<div className="w-full max-w-md rounded-lg border border-danger/40 bg-surface-2 p-5 shadow-md shadow-black/10">
<div className={clsx("mb-3 flex items-center gap-2", colour)}>
<Icon className="h-4 w-4" />
<h2 className="text-sm font-semibold">{title}</h2>
</div>
<p className="mb-3 text-xs text-text-secondary">{description}</p>
{detail && (
<pre className="mb-4 max-h-32 overflow-auto whitespace-pre-wrap rounded bg-surface-3 p-2 text-[11px] text-text-muted">
{detail}
</pre>
)}
<div className="flex flex-wrap items-center gap-2">
{onReset && (
<Button variant="primary" size="sm" onClick={onReset}>
<RotateCcw className="h-3.5 w-3.5" />
{t("errorPages.actions.retry")}
</Button>
)}
<Button variant="secondary" size="sm" onClick={() => window.location.reload()}>
<RotateCw className="h-3.5 w-3.5" />
{t("errorPages.actions.reload")}
</Button>
<ReportBugLink size="sm" />
</div>
</div>
</div>
);
}
/** External "report a bug" link, styled to match the `ghost` Button. */
function ReportBugLink({ size = "md" }: { size?: "sm" | "md" }) {
const { t } = useTranslation("ui");
const sizeClass =
size === "sm" ? "min-h-[36px] px-2.5 py-1 text-xs" : "min-h-touch px-4 py-2 text-sm";
const iconClass = size === "sm" ? "h-3.5 w-3.5" : "h-4 w-4";
return (
<a
href={ABOUT.bugReportUrl}
target="_blank"
rel="noopener noreferrer"
className={clsx(
"inline-flex items-center justify-center gap-2 rounded-lg font-medium text-text-secondary transition-colors hover:bg-surface-2 hover:text-text-primary focus:outline-none focus:ring-2 focus:ring-accent/50",
sizeClass,
)}
>
<Bug className={iconClass} />
{t("errorPages.actions.reportBug")}
</a>
);
}
+55
View File
@@ -0,0 +1,55 @@
import { useEffect, useRef, useState } from "react";
import { Link } from "react-router-dom";
import toast from "react-hot-toast";
import { useTranslation } from "react-i18next";
import { WifiOff, X } from "lucide-react";
import { useOnlineStatus } from "@hooks/use-online-status";
/**
* Non-blocking offline indicator.
*
* The app works fully offline (everything is client-side), so losing the
* network must never block input — this is a dismissible bottom strip, not a
* takeover page. Dismiss only hides the *current* offline episode; the next
* online→offline transition shows it again. A transient toast confirms when
* the connection returns (reusing the app-level `<Toaster/>`).
*/
export function OfflineBanner() {
const { t } = useTranslation("ui");
const online = useOnlineStatus();
const [dismissed, setDismissed] = useState(false);
const wasOnline = useRef(online);
useEffect(() => {
if (!wasOnline.current && online) {
toast.success(t("errorPages.offlineBanner.backOnline"));
}
if (wasOnline.current && !online) {
setDismissed(false);
}
wasOnline.current = online;
}, [online, t]);
if (online || dismissed) return null;
return (
<div
role="status"
className="fixed inset-x-0 bottom-0 z-50 flex items-center justify-center gap-3 border-t border-warning/40 bg-surface-2 px-4 py-2 text-sm text-text-primary shadow-md shadow-black/20"
>
<WifiOff className="h-4 w-4 shrink-0 text-warning" aria-hidden />
<span>{t("errorPages.offlineBanner.message")}</span>
<Link to="/offline" className="font-medium text-accent hover:text-accent-hover">
{t("errorPages.offlineBanner.details")}
</Link>
<button
type="button"
onClick={() => setDismissed(true)}
aria-label={t("common.dismiss")}
className="ml-1 rounded p-1 text-text-muted transition-colors hover:bg-surface-3 hover:text-text-primary"
>
<X className="h-4 w-4" />
</button>
</div>
);
}
+15 -2
View File
@@ -1,6 +1,6 @@
import { useState, useRef, useEffect } from "react";
import { useTranslation } from "react-i18next";
import { ChevronDown, Heart, Menu } from "lucide-react";
import { ChevronDown, Heart, Menu, Moon, Sun } from "lucide-react";
import { SUPPORTED_LANGUAGES } from "@i18n/index";
import { useSettingsStore } from "@store/settings-store";
import { PRIMARY_DONATE_URL } from "@config/donate";
@@ -13,7 +13,7 @@ interface HeaderProps {
export function Header({ onOpenMobileNav }: HeaderProps) {
const { t, i18n } = useTranslation("ui");
const { appLanguage, setAppLanguage } = useSettingsStore();
const { appLanguage, setAppLanguage, theme, setTheme } = useSettingsStore();
const [open, setOpen] = useState(false);
const dropdownRef = useRef<HTMLDivElement>(null);
@@ -72,6 +72,19 @@ export function Header({ onOpenMobileNav }: HeaderProps) {
<Heart className="h-4 w-4 sm:h-3.5 sm:w-3.5" />
<span className="hidden md:inline">{t("header.donate")}</span>
</a>
<button
type="button"
onClick={() => setTheme(theme === "dark" ? "light" : "dark")}
className="rounded-lg p-2 text-text-secondary transition-colors hover:bg-surface-2 hover:text-text-primary"
title={t("header.toggleTheme")}
aria-label={t("header.toggleTheme")}
>
{theme === "dark" ? (
<Moon className="h-4 w-4" />
) : (
<Sun className="h-4 w-4" />
)}
</button>
<div className="relative" ref={dropdownRef}>
<button
onClick={() => setOpen(!open)}
+2
View File
@@ -7,6 +7,7 @@ import {
Clock,
Settings,
Layers,
Share2,
ListVideo,
ScrollText,
Info,
@@ -30,6 +31,7 @@ const tabs: readonly TabItem[] = [
{ to: "/", labelKey: "tabs.editor", icon: Pencil },
{ to: "/output", labelKey: "tabs.output", icon: FileText },
{ to: "/batch", labelKey: "tabs.batch", icon: Layers },
{ to: "/social", labelKey: "tabs.social", icon: Share2 },
{ to: "/profiles", labelKey: "tabs.profiles", icon: User },
{ to: "/history", labelKey: "tabs.history", icon: Clock },
{ to: "/playlist", labelKey: "tabs.playlist", icon: ListVideo },
+8 -1
View File
@@ -4,6 +4,7 @@ import i18n from "i18next";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { useCurrentGeneratorInput } from "@hooks/use-current-generator-input";
import { useLanguagesReady } from "@hooks/use-languages-ready";
import { buildPinnedComment } from "@engine/pinned-comment-builder";
import { GENRES } from "@config/genres";
import type { Genre } from "@engine/types";
@@ -40,8 +41,13 @@ export function OutputExtras() {
return map;
}, [t]);
// Lazy-loaded locales (v0.26): the OutputPage flow normally has this
// language loaded already, but the component is standalone by design —
// gate it rather than rely on the page.
const ready = useLanguagesReady([input.language]);
const templateText = useMemo(() => {
if (!showPinnedCommentTemplate) return "";
if (!ready || !showPinnedCommentTemplate) return "";
const tFn = i18n.getFixedT(input.language, "templates");
return buildPinnedComment(input, tFn, {
includeAskNextGame,
@@ -50,6 +56,7 @@ export function OutputExtras() {
genreLabels,
});
}, [
ready,
showPinnedCommentTemplate,
input,
includeAskNextGame,
+7 -1
View File
@@ -5,6 +5,7 @@ import { Modal } from "@components/ui/Modal";
import { CopyButton } from "./CopyButton";
import { CharCounter } from "./CharCounter";
import { buildTitleVariants } from "@engine/title-variants";
import { useLanguagesReady } from "@hooks/use-languages-ready";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { YT_LIMITS, type GeneratorInput } from "@engine/types";
@@ -24,8 +25,12 @@ export function VariantPicker({ open, onClose }: VariantPickerProps) {
const state = useEditorStore();
const showQualityBadge = useSettingsStore((s) => s.showQualityBadge);
// Lazy-loaded locales (v0.26): only request the bundle while the modal
// is actually open; the list fills in on the ready flip.
const ready = useLanguagesReady(open ? [state.language] : []);
const variants = useMemo(() => {
if (!open) return [];
if (!open || !ready) return [];
const input: GeneratorInput = {
videoType: state.videoType,
language: state.language,
@@ -52,6 +57,7 @@ export function VariantPicker({ open, onClose }: VariantPickerProps) {
return buildTitleVariants(input, tFn, showQualityBadge);
}, [
open,
ready,
showQualityBadge,
state.videoType,
state.language,
+52
View File
@@ -0,0 +1,52 @@
import { type ReactNode, useId } from "react";
import { Check } from "lucide-react";
import clsx from "clsx";
interface CheckboxProps {
checked: boolean;
onChange: (checked: boolean) => void;
/** Visible label — accepts rich content (e.g. inline links). */
label: ReactNode;
className?: string;
id?: string;
}
/**
* Accessible square checkbox. A real `<input type="checkbox">` (visually
* hidden as a `peer`) keeps native keyboard + screen-reader semantics, while
* the styled box mirrors its state. Tailwind tokens only, so it tracks the
* dark/light theme. Distinct from {@link import("./Toggle").Toggle}, which is
* a `role="switch"` on/off pill — a checkbox is the right control for a
* one-time "I agree" acknowledgement.
*/
export function Checkbox({ checked, onChange, label, className, id }: CheckboxProps) {
const autoId = useId();
const inputId = id ?? autoId;
return (
<label
htmlFor={inputId}
className={clsx("group flex min-h-touch cursor-pointer items-start gap-3 text-left", className)}
>
<input
id={inputId}
type="checkbox"
checked={checked}
onChange={(e) => onChange(e.target.checked)}
className="peer sr-only"
/>
<span
aria-hidden
className={clsx(
"mt-0.5 flex h-5 w-5 shrink-0 items-center justify-center rounded border transition-colors",
"peer-focus-visible:ring-2 peer-focus-visible:ring-accent/50",
checked
? "border-accent bg-accent text-white"
: "border-border bg-surface-1 text-transparent group-hover:border-border-strong",
)}
>
<Check className="h-3.5 w-3.5" strokeWidth={3} />
</span>
<span className="text-sm leading-snug text-text-primary">{label}</span>
</label>
);
}
+68 -1
View File
@@ -41,6 +41,15 @@ export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
"migraine_trigger",
"strobe_effects",
"screen_shake_intense",
// v0.23.0: VFX intensity — share the photosensitive audience.
"lens_flare_intense",
"bloom_excessive",
"particle_effects_dense",
"screen_overlay_flashing",
"color_saturation_extreme",
"motion_blur_heavy",
"depth_of_field_aggressive",
"post_processing_intense",
],
},
{
@@ -62,6 +71,22 @@ export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
"white_noise_static",
],
},
{
id: "dialogue",
labelKey: "editor.contentWarningGroups.dialogue",
items: [
"profanity_frequent",
"sexual_innuendo",
"inflammatory_speech",
"verbal_abuse",
"threatening_language",
"slurs_derogatory",
"crude_humor",
"mature_humor",
"dark_humor",
"drug_references",
],
},
{
id: "phobias",
labelKey: "editor.contentWarningGroups.phobias",
@@ -117,6 +142,11 @@ export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
"cymophobia",
"limnophobia",
"potamophobia",
"chromophobia",
"erythrophobia",
"xanthophobia",
"leukophobia",
"melanophobia",
],
},
{
@@ -166,6 +196,32 @@ export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
"quarter_life_crisis",
"workplace_harassment",
"masculinity_pressure",
"body_shaming",
"beauty_standards",
],
},
{
id: "internet_digital",
labelKey: "editor.contentWarningGroups.internet_digital",
items: [
"cyberbullying",
"doxxing",
"trolling_griefing",
"cancel_culture",
"social_media_addiction",
"doomscrolling",
"fomo",
"fake_news",
"online_scams",
"catfishing",
"deepfake_themes",
"cyberstalking",
"internet_challenges",
"influencer_culture",
"online_radicalization",
"loot_boxes",
"ai_themes",
"data_privacy",
],
},
{
@@ -174,6 +230,11 @@ export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
items: [
"blood_gore",
"mature_18plus",
"revealing_outfits",
"partial_nudity",
"sexualized_characters",
"fanservice",
"suggestive_poses",
"disturbing_imagery",
"animal_abuse",
"child_harm",
@@ -272,6 +333,12 @@ export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
{
id: "gameplay_disclosure",
labelKey: "editor.contentWarningGroups.gameplay_disclosure",
items: ["mods_used", "cheats_enabled", "glitch_exploits", "assisted_run"],
items: [
"mods_used",
"cheats_enabled",
"glitch_exploits",
"assisted_run",
"educational_purpose_only",
],
},
] as const;
+71
View File
@@ -0,0 +1,71 @@
import {
SearchX,
ShieldX,
Clock,
ServerCrash,
WifiOff,
TriangleAlert,
type LucideIcon,
} from "lucide-react";
/**
* The set of error "kinds" the app can present.
*
* YTDescGen is a pure-client SPA (HashRouter, no backend), so `forbidden` /
* `expired` / `serverError` never arise from the app's own logic today — they
* exist as designed, route-reachable pages (`/#/403`, `/#/419`, `/#/500`)
* ready to be wired to future triggers (a Tauri command failure, a future
* sync backend). The kinds that *do* fire:
* - `notFound` — the catch-all `*` route (a mistyped hash path)
* - `offline` — `navigator.onLine` flips false (see use-online-status)
* - `runtime` — a render crash caught by ErrorBoundary
*/
export type ErrorKind =
| "notFound"
| "forbidden"
| "expired"
| "serverError"
| "offline"
| "runtime";
type ErrorSeverity = "accent" | "danger" | "warning";
export interface ErrorPageMeta {
/** HTTP-style status shown large on the page, or `null` for the non-HTTP
* states (offline / runtime crash) that have no meaningful code. */
readonly code: number | null;
/** lucide icon rendered above the code. */
readonly icon: LucideIcon;
/** i18n key prefix under `ui:errorPages.*` for `.title` / `.description`. */
readonly keyPrefix: string;
/** Drives the icon/code colour token — see {@link severityTextClass}. */
readonly severity: ErrorSeverity;
}
/**
* `serverError` deliberately covers 408 + the whole 5xx family — one design,
* one locale set. Kept exhaustive over {@link ErrorKind} via `satisfies` so a
* newly-added kind fails the build until it is mapped here.
*/
export const ERROR_PAGES = {
notFound: { code: 404, icon: SearchX, keyPrefix: "notFound", severity: "accent" },
forbidden: { code: 403, icon: ShieldX, keyPrefix: "forbidden", severity: "danger" },
expired: { code: 419, icon: Clock, keyPrefix: "expired", severity: "warning" },
serverError: { code: 500, icon: ServerCrash, keyPrefix: "serverError", severity: "danger" },
offline: { code: null, icon: WifiOff, keyPrefix: "offline", severity: "warning" },
runtime: { code: null, icon: TriangleAlert, keyPrefix: "runtime", severity: "danger" },
} as const satisfies Record<ErrorKind, ErrorPageMeta>;
/** Look up the presentation metadata for an error kind. */
export function resolveErrorMeta(kind: ErrorKind): ErrorPageMeta {
return ERROR_PAGES[kind];
}
/** Map a severity to its Tailwind text-colour token. */
export function severityTextClass(severity: ErrorPageMeta["severity"]): string {
return severity === "danger"
? "text-danger"
: severity === "warning"
? "text-warning"
: "text-accent";
}
+41
View File
@@ -0,0 +1,41 @@
const DOC_BASE = "https://github.com/poli0981/youtube-generator/blob/main";
export interface LegalDoc {
readonly id: "terms" | "privacy" | "disclaimer" | "license";
/** i18n key under the `consentGate` ui section. */
readonly labelKey: string;
/** Absolute GitHub blob URL — opens in the system browser via target="_blank". */
readonly url: string;
}
/**
* The legal-terms version the user must accept. Bump this whenever the
* Terms / Privacy / Disclaimer change materially — every user whose stored
* `legalConsentVersion` is below this re-sees the first-run consent gate.
*
* v0.28.0 ships the first gate at version 1 (docs dated 2026-05-14).
*/
export const CURRENT_TERMS_VERSION = 1;
/**
* The documents surfaced on the consent gate and the About → Legal section.
* Stored at the repo root and served from GitHub so they are always current;
* the in-app links open them in the browser (Tauri routes target="_blank" to
* the system browser). Order = display order.
*/
export const LEGAL_DOCS: readonly LegalDoc[] = [
{ id: "terms", labelKey: "consentGate.docTerms", url: `${DOC_BASE}/TERMS.md` },
{ id: "privacy", labelKey: "consentGate.docPrivacy", url: `${DOC_BASE}/PRIVACY.md` },
{ id: "disclaimer", labelKey: "consentGate.docDisclaimer", url: `${DOC_BASE}/DISCLAIMER.md` },
{ id: "license", labelKey: "consentGate.docLicense", url: `${DOC_BASE}/LICENSE` },
];
/**
* True when the consent gate must be shown — the user has not yet accepted the
* current terms version. A non-finite value (NaN / Infinity / non-number from a
* corrupt or legacy payload) is treated as "not accepted" so a bad value
* re-shows the gate rather than slipping past `<` comparison.
*/
export function needsConsent(acceptedVersion: number): boolean {
return !Number.isFinite(acceptedVersion) || acceptedVersion < CURRENT_TERMS_VERSION;
}
+188 -14
View File
@@ -37,17 +37,65 @@ interface RigFieldOption {
readonly label: string;
}
/**
* v0.23.0: a composite part's options can now either be a static array
* (the original RAM-style shape) OR a function that resolves the option
* list based on previously-selected parts (the OS cascading shape, where
* version-or-distro depends on OS name and the third slot depends on
* both). Existing static-array call sites continue to work unchanged.
*/
type RigFieldOptionResolver =
| readonly RigFieldOption[]
| ((previousParts: readonly string[]) => readonly RigFieldOption[]);
export interface CompositePart {
/** Stable id, used to assemble the storage tuple in declaration order. */
readonly id: string;
readonly labelKey: string;
readonly options: readonly RigFieldOption[];
readonly options: RigFieldOptionResolver;
/** When true, the part renders an extra free-text input when value === `"custom"`. */
readonly allowCustom?: boolean;
/** Suffix shown after the custom numeric input (e.g. " GB"). */
readonly customSuffix?: string;
/** Optional placeholder for the custom input. */
readonly customPlaceholder?: string;
/**
* v0.23.0: dynamic label key override. Lets a single part show
* "Distro" when OS = Linux but "Version" when OS = Windows / macOS.
* Receives previously-selected parts; returns an i18n key.
*/
readonly labelKeyResolver?: (previousParts: readonly string[]) => string;
/**
* v0.23.0: hide this part entirely when the resolver returns `true`
* (e.g. macOS has no Edition slot). `formatRigValue` also skips the
* hidden part so it doesn't leak an empty token into the joined
* output, and the editor doesn't render the dropdown.
*/
readonly hiddenWhen?: (previousParts: readonly string[]) => boolean;
}
/**
* Helper for {@link CompositePart.options} — call sites get a plain
* `RigFieldOption[]` whether the part declares a static array or a
* function-of-previous-parts resolver. Pure; exported for {@link RigEditor}.
*/
export function resolveCompositeOptions(
opts: RigFieldOptionResolver,
previousParts: readonly string[],
): readonly RigFieldOption[] {
return typeof opts === "function" ? opts(previousParts) : opts;
}
/**
* Helper for {@link CompositePart.labelKey} / {@link CompositePart.labelKeyResolver}.
* Returns the dynamic label when present, falling back to the static
* key on the part. Pure; exported for {@link RigEditor}.
*/
export function resolveCompositeLabelKey(
part: CompositePart,
previousParts: readonly string[],
): string {
return part.labelKeyResolver?.(previousParts) ?? part.labelKey;
}
interface CompositeFieldSpec {
@@ -148,24 +196,105 @@ const RAM_COMPOSITE: CompositeFieldSpec = {
};
/**
* OS composite (v0.22.0). Three dropdowns combined into one logical
* field — OS name → version → edition. Stored pipe-delimited as
* `"windows|11|pro"` → renders as `"Windows 11 Pro"`. Edition is
* optional, so `"windows|11|"` → `"Windows 11"`. Only Windows 10/11 is
* surfaced for now; macOS / Linux can be added later by extending the
* option arrays without changing storage or format logic.
* OS composite (v0.22.0, extended v0.23.0). Three dropdowns combined
* into one logical field. The slot semantics now adapt to the chosen
* OS family:
*
* - Windows: name → version (10/11) → edition (Home/Pro/…)
* - macOS: name → version (10/11/12/13/14/15/26) → (hidden — Apple has no editions)
* - Linux: name → distro (Ubuntu/Fedora/…) → version (per-distro)
*
* Stored pipe-delimited; format function joins all non-empty parts
* with single spaces. v0.22.0 stored values like `"windows|11|pro"`
* round-trip unchanged through the new resolver because the static
* Windows path remains the default for `name === "windows"`.
*/
const OS_NAME_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "windows", label: "Windows" },
{ value: "macos", label: "macOS" },
{ value: "linux", label: "Linux" },
];
const OS_VERSION_OPTIONS: readonly RigFieldOption[] = [
const WINDOWS_VERSION_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "10", label: "10" },
{ value: "11", label: "11" },
];
/**
* macOS major versions. Apple jumped from 15 (Sequoia, 2024) to 26
* (Tahoe, 2025) to year-align the marketing number, so the list is
* intentionally non-contiguous.
*/
const MACOS_VERSION_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "10", label: "10 (Mojave era)" },
{ value: "11 Big Sur", label: "11 Big Sur" },
{ value: "12 Monterey", label: "12 Monterey" },
{ value: "13 Ventura", label: "13 Ventura" },
{ value: "14 Sonoma", label: "14 Sonoma" },
{ value: "15 Sequoia", label: "15 Sequoia" },
{ value: "26 Tahoe", label: "26 Tahoe" },
];
/** Linux distros gameplay creators actually use via Proton. */
const LINUX_DISTRO_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "ubuntu", label: "Ubuntu" },
{ value: "fedora", label: "Fedora" },
{ value: "debian", label: "Debian" },
{ value: "arch", label: "Arch" },
{ value: "manjaro", label: "Manjaro" },
{ value: "popos", label: "Pop!_OS" },
{ value: "mint", label: "Linux Mint" },
];
/**
* Per-distro version lists. The map key matches the distro id from
* {@link LINUX_DISTRO_OPTIONS}; values are stored verbatim (e.g. the
* stored Ubuntu version is "22.04 LTS"). Rolling distros surface a
* single "rolling" / "latest" placeholder so the dropdown isn't empty.
*/
const LINUX_VERSION_BY_DISTRO: Record<string, readonly RigFieldOption[]> = {
ubuntu: [
{ value: "", label: "—" },
{ value: "20.04 LTS", label: "20.04 LTS" },
{ value: "22.04 LTS", label: "22.04 LTS" },
{ value: "24.04 LTS", label: "24.04 LTS" },
{ value: "26.04 LTS", label: "26.04 LTS" },
],
fedora: [
{ value: "", label: "—" },
{ value: "40", label: "40" },
{ value: "41", label: "41" },
{ value: "42", label: "42" },
],
debian: [
{ value: "", label: "—" },
{ value: "12 Bookworm", label: "12 Bookworm" },
{ value: "13 Trixie", label: "13 Trixie" },
],
arch: [
{ value: "", label: "—" },
{ value: "rolling", label: "rolling" },
],
manjaro: [
{ value: "", label: "—" },
{ value: "latest", label: "latest stable" },
],
popos: [
{ value: "", label: "—" },
{ value: "22.04 LTS", label: "22.04 LTS" },
{ value: "24.04 LTS", label: "24.04 LTS" },
],
mint: [
{ value: "", label: "—" },
{ value: "21", label: "21" },
{ value: "22", label: "22" },
],
};
const OS_EDITION_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "home", label: "Home" },
@@ -175,11 +304,40 @@ const OS_EDITION_OPTIONS: readonly RigFieldOption[] = [
{ value: "iot", label: "IoT Enterprise" },
];
const EMPTY_OPTIONS: readonly RigFieldOption[] = [{ value: "", label: "—" }];
const OS_COMPOSITE: CompositeFieldSpec = {
parts: [
{ id: "name", labelKey: "editor.os_name", options: OS_NAME_OPTIONS },
{ id: "version", labelKey: "editor.os_version", options: OS_VERSION_OPTIONS },
{ id: "edition", labelKey: "editor.os_edition", options: OS_EDITION_OPTIONS },
{
// Slot 2: Windows/macOS use this as "Version", Linux re-purposes it
// as "Distro". The labelKeyResolver swaps the label so the editor
// form reads naturally for each OS family.
id: "version_or_distro",
labelKey: "editor.os_version",
labelKeyResolver: ([name = ""]) =>
name === "linux" ? "editor.os_distro" : "editor.os_version",
options: ([name = ""]) => {
if (name === "windows") return WINDOWS_VERSION_OPTIONS;
if (name === "macos") return MACOS_VERSION_OPTIONS;
if (name === "linux") return LINUX_DISTRO_OPTIONS;
return EMPTY_OPTIONS;
},
},
{
// Slot 3: Windows uses "Edition"; Linux re-purposes it as "Version"
// (per-distro). macOS doesn't have a third slot at all — hidden.
id: "edition_or_linux_version",
labelKey: "editor.os_edition",
labelKeyResolver: ([name = ""]) =>
name === "linux" ? "editor.os_version" : "editor.os_edition",
hiddenWhen: ([name = ""]) => name === "macos",
options: ([name = "", distro = ""]) => {
if (name === "windows") return OS_EDITION_OPTIONS;
if (name === "linux") return LINUX_VERSION_BY_DISTRO[distro] ?? EMPTY_OPTIONS;
return EMPTY_OPTIONS;
},
},
],
format: (parts) => parts.filter((p) => p.trim() !== "").join(" "),
};
@@ -297,16 +455,32 @@ export function formatRigValue(fieldId: string, raw: string): string {
if (isLegacy) return raw;
if (parts.length === 0) return "";
// Resolve each declared part. `custom:<value>` segments collapse to
// the free-text payload (without the `custom:` prefix).
// Resolve each declared part. v0.23.0: parts may declare a dynamic
// option resolver and/or a `hiddenWhen` predicate (used by the OS
// composite where macOS has no third slot). We walk parts in order
// so each resolver sees the previously-stored values, and we skip
// hidden parts entirely so they don't leak an empty token into the
// `composite.format` join. `custom:<value>` segments still collapse
// to the free-text payload (without the `custom:` prefix).
const previousStored: string[] = [];
const resolved = field.composite.parts.map((spec, i) => {
const stored = (parts[i] ?? "").trim();
if (!stored) return "";
if (spec.hiddenWhen?.(previousStored)) {
previousStored.push("");
return "";
}
if (!stored) {
previousStored.push("");
return "";
}
if (spec.allowCustom && stored.startsWith("custom:")) {
const txt = stored.slice("custom:".length).trim();
previousStored.push(stored);
return txt ? `${txt}${spec.customSuffix ?? ""}` : "";
}
const opt = spec.options.find((o) => o.value === stored);
const opts = resolveCompositeOptions(spec.options, previousStored);
const opt = opts.find((o) => o.value === stored);
previousStored.push(stored);
return opt?.label ?? stored;
});
+1
View File
@@ -17,5 +17,6 @@ export const SOCIAL_FIELDS = [
{ id: "facebook", label: "Facebook", labelKey: "social.facebook", urlPrefix: "https://facebook.com/", category: "social" },
{ id: "fb_page", label: "Facebook Page", labelKey: "social.fb_page", urlPrefix: "https://facebook.com/", category: "social" },
{ id: "fb_group", label: "Facebook Group", labelKey: "social.fb_group", urlPrefix: "https://facebook.com/groups/", category: "social" },
{ id: "telegram", label: "Telegram", labelKey: "social.telegram", urlPrefix: "https://t.me/", category: "social" },
{ id: "website", label: "Website", labelKey: "social.website", urlPrefix: "", category: "social" },
] as const;
+74
View File
@@ -0,0 +1,74 @@
import { Music2, Instagram, Facebook, type LucideIcon } from "lucide-react";
/**
* A short-form platform the cross-post generator targets (v0.24.0). Each
* one re-packages the same YouTube source (title, rig, content warnings,
* copyright, thanks, hashtags) under its own character ceiling and a
* curated set of platform-popular hashtags.
*
* Add a platform here and the Social page + bulk loop pick it up
* automatically — same data-driven pattern as `@config/platforms` and
* `@config/social-fields`.
*/
export interface SocialPlatform {
readonly id: "tiktok" | "instagram_reels" | "facebook_reels";
/** i18n key under `socialPost.platforms.<id>`. */
readonly labelKey: string;
/** Caption character ceiling enforced by the platform. */
readonly charLimit: number;
readonly icon: LucideIcon;
/**
* Platform-popular hashtags appended after the game / genre hashtags.
* Stored with the leading `#`; deduped case-insensitively against the
* derived hashtags at build time.
*/
readonly popularHashtags: readonly string[];
}
export const SOCIAL_PLATFORMS: readonly SocialPlatform[] = [
{
id: "tiktok",
labelKey: "socialPost.platforms.tiktok",
charLimit: 4000,
icon: Music2, // lucide has no TikTok glyph; Music2 is the established stand-in
popularHashtags: [
"#fyp",
"#foryou",
"#foryoupage",
"#gaming",
"#gamingtiktok",
"#gameplay",
"#gamer",
],
},
{
id: "instagram_reels",
labelKey: "socialPost.platforms.instagram_reels",
charLimit: 2200,
icon: Instagram,
popularHashtags: [
"#reels",
"#reelsinstagram",
"#gaming",
"#gamingreels",
"#gamer",
"#instagaming",
"#videogames",
],
},
{
id: "facebook_reels",
labelKey: "socialPost.platforms.facebook_reels",
charLimit: 2200,
icon: Facebook,
popularHashtags: [
"#reels",
"#facebookreels",
"#fbreels",
"#gaming",
"#gameplay",
"#gamingcommunity",
"#videogames",
],
},
] as const;
+89 -61
View File
@@ -26,9 +26,27 @@ const SOCIAL_ICONS: Record<string, string> = {
facebook: "👤",
fb_page: "📄",
fb_group: "👥",
telegram: "✈️",
website: "🌐",
};
/**
* Output languages whose descriptions are human-reviewed — the
* AI-translation notice is skipped for them (v0.24.0). Typed as
* `readonly string[]` so `.includes(input.language)` accepts any
* SupportedLanguage without a cast.
*/
const TRANSLATION_TRUSTED: readonly string[] = ["vi", "en"];
/** Caveat bullet ids for the Translation Quality section, resolved against
* `description.translationQuality.items.<id>` (v0.24.0). */
const TRANSLATION_QUALITY_ITEMS = [
"accuracy",
"phrasing",
"localStyle",
"corrections",
] as const;
function hasEntries(obj: Partial<Record<string, string>>): boolean {
return Object.values(obj).some((v) => v && v.trim() !== "");
}
@@ -233,6 +251,10 @@ export interface BuildDescriptionOptions {
/** When true and the active profile's `thirdPartyAdText` is non-empty,
* emits a "🤝 SPONSORS & PARTNERS" block (v0.11). */
showThirdPartyAds?: boolean;
/** When true, appends an AI-translation disclaimer block for output
* languages outside the trusted set ({@link TRANSLATION_TRUSTED} —
* English / Vietnamese, which are human-reviewed). v0.24.0. */
showTranslationQuality?: boolean;
/** Optional English-fixed translation function used by the unified
* content-warnings block (v0.11) to render bilingual lines
* `EN · output-language`. When omitted, the warnings block falls
@@ -252,6 +274,7 @@ export function buildDescription(
showSponsorCredit = false,
showThirdPartyAds = false,
showGameCopyright = false,
showTranslationQuality = false,
tEn,
} = options;
const sections: string[] = [];
@@ -474,51 +497,49 @@ export function buildDescription(
);
}
// 7. Content warnings — unified bilingual checklist (v0.11). Replaces
// the v0.7 trio of separate spoiler / generic-content-warnings /
// mature blocks. Renders header + intro + bulleted list. When the
// output language is not English, each piece is paired with its
// English equivalent: header `EN / LOCAL`, intro on two lines,
// bullets `• EN · LOCAL` (separator is U+00B7 MIDDLE DOT). When
// `tEn` is omitted (e.g. legacy callers / unit tests that haven't
// migrated), falls back to single-language output via `t` — degraded
// but never broken.
const cw = input.contentWarnings ?? [];
if (cw.length > 0) {
const isEn = input.language === "en";
const renderBilingual = !isEn && Boolean(tEn);
const tEnUse: TranslationFn = tEn ?? t;
const headerEn = tEnUse("description.contentWarnings.header");
const headerLocal = t("description.contentWarnings.header");
const introEn = tEnUse("description.contentWarnings.intro");
const introLocal = t("description.contentWarnings.intro");
const headerLine = renderBilingual ? `${headerEn} / ${headerLocal}` : headerEn;
const introLines = renderBilingual ? `${introEn}\n${introLocal}` : introEn;
const bullets = cw
.map((id) => {
const key = `description.contentWarnings.items.${id}`;
const enLabel = tEnUse(key);
const localLabel = t(key);
if (!enLabel || enLabel === key || !enLabel.trim()) return null;
return renderBilingual ? `• ${enLabel} · ${localLabel}` : `• ${enLabel}`;
})
.filter((line): line is string => Boolean(line))
.join("\n");
if (bullets) {
sections.push(`${headerLine}\n${introLines}\n\n${bullets}`);
}
}
// 7. Content warnings — unified bilingual checklist (v0.11). Header +
// intro + `• EN · LOCAL` bullets (separator U+00B7 MIDDLE DOT);
// degrades to single-language when the output is English or `tEn` is
// omitted. The shared shape was extracted to buildBilingualBulletSection
// (v0.24.0) and is reused by Tech Notes, the Translation Quality notice,
// and the social-post builder.
const cwSection = buildBilingualBulletSection(
input.contentWarnings ?? [],
"description.contentWarnings",
input.language,
t,
tEn,
);
if (cwSection) sections.push(cwSection);
// 7.5 Tech Notes — v0.12 production / playstyle disclaimer checklist.
// Sits next to Content Warnings because both are transparency blocks;
// grouping them keeps disclaimers visually together. Same bilingual
// render pattern as the content-warnings block above.
const tnBlock = buildTechNotesSection(input, t, tEn);
if (tnBlock) sections.push(tnBlock);
// checklist shape.
const tnSection = buildBilingualBulletSection(
input.techNotes ?? [],
"description.techNotes",
input.language,
t,
tEn,
);
if (tnSection) sections.push(tnSection);
// 7.6 Translation Quality — opt-in AI-translation disclaimer (v0.24.0).
// Shown only for output languages outside the trusted set (EN / VI are
// human-reviewed, so they don't need the caveat). Self-contained:
// header + intro naming the trusted languages + caveat bullets, in the
// same bilingual checklist shape as the blocks above.
if (showTranslationQuality && !TRANSLATION_TRUSTED.includes(input.language)) {
const tqSection = buildBilingualBulletSection(
TRANSLATION_QUALITY_ITEMS,
"description.translationQuality",
input.language,
t,
tEn,
);
if (tqSection) sections.push(tqSection);
}
// 8.3. Sponsor credit — appears above the music / donate block so the
// "thanks to X" line stands out. Only renders when both the toggle is
@@ -873,38 +894,45 @@ function buildPlaythroughNotesSection(
}
/**
* Builds the `▸ 🛠 TECH NOTES` block (v0.12). Renders selected items
* from {@link GeneratorInput.techNotes} as bulleted bilingual lines —
* the rendering logic mirrors the v0.11 content-warnings block exactly,
* just with a different header, intro, and items namespace.
* Render a bilingual checklist section — header + intro + `• EN · LOCAL`
* bullets — from a list of item ids resolved against
* `${namespace}.items.<id>` (plus `${namespace}.header` / `.intro`).
*
* Returns "" when no items are selected. Items whose translation key
* doesn't resolve are filtered out so a stale id from a hand-edited
* persistent blob doesn't render as a bare key.
* This is the shared shape behind Content Warnings (v0.11), Tech Notes
* (v0.12), and the Translation Quality notice (v0.24.0). When the output
* language is English (or `tEn` is omitted) it degrades to single-language
* output; otherwise each piece is paired with its English equivalent
* (header `EN / LOCAL`, intro on two lines, bullets `• EN · LOCAL` with a
* U+00B7 MIDDLE DOT separator). Items whose key doesn't resolve are
* dropped; returns `null` when nothing renders so the caller skips the
* section instead of emitting a header with no body.
*
* Pure — exported for reuse by the social-post builder.
*/
function buildTechNotesSection(
input: GeneratorInput,
export function buildBilingualBulletSection(
itemIds: readonly string[],
namespace: string,
language: string,
t: TranslationFn,
tEn?: TranslationFn,
): string {
const tn = input.techNotes ?? [];
if (tn.length === 0) return "";
): string | null {
if (itemIds.length === 0) return null;
const isEn = input.language === "en";
const isEn = language === "en";
const renderBilingual = !isEn && Boolean(tEn);
const tEnUse: TranslationFn = tEn ?? t;
const headerEn = tEnUse("description.techNotes.header");
const headerLocal = t("description.techNotes.header");
const introEn = tEnUse("description.techNotes.intro");
const introLocal = t("description.techNotes.intro");
const headerEn = tEnUse(`${namespace}.header`);
const headerLocal = t(`${namespace}.header`);
const introEn = tEnUse(`${namespace}.intro`);
const introLocal = t(`${namespace}.intro`);
const headerLine = renderBilingual ? `${headerEn} / ${headerLocal}` : headerEn;
const introLines = renderBilingual ? `${introEn}\n${introLocal}` : introEn;
const bullets = tn
const bullets = itemIds
.map((id) => {
const key = `description.techNotes.items.${id}`;
const key = `${namespace}.items.${id}`;
const enLabel = tEnUse(key);
const localLabel = t(key);
if (!enLabel || enLabel === key || !enLabel.trim()) return null;
@@ -913,7 +941,7 @@ function buildTechNotesSection(
.filter((line): line is string => Boolean(line))
.join("\n");
if (!bullets) return "";
if (!bullets) return null;
return `${headerLine}\n${introLines}\n\n${bullets}`;
}
+193
View File
@@ -0,0 +1,193 @@
import type { GeneratorInput, TranslationFn } from "./types";
import type { SocialPlatform } from "@config/social-platforms";
import { buildTitle } from "./title-builder";
import { buildBilingualBulletSection } from "./description-builder";
import { formatRigValue } from "@config/rig-fields";
import { sanitizeHashtag } from "@utils/sanitize";
/**
* Cross-post caption builder (v0.24.0). Re-packages the same
* {@link GeneratorInput} that drives the YouTube description into a
* short-form caption for TikTok / Instagram Reels / Facebook Reels.
*
* Reuses leaf engine pieces rather than the full description renderer:
* {@link buildTitle} (badge suppressed), {@link formatRigValue}, the
* shared {@link buildBilingualBulletSection} (content warnings), the
* `description.sections.*` copyright / sponsor templates, and
* {@link sanitizeHashtag}. The YouTube description output is therefore
* untouched — captions are a parallel renderer, not a fork of it.
*/
export interface SocialPostOptions {
/** Platform character ceiling. The caption never silently exceeds it;
* optional blocks are dropped first, then `isOver` flags any residual
* overflow for the UI. */
charLimit: number;
/** Platform-popular hashtags appended after the derived game / genre
* hashtags (deduped case-insensitively). */
popularHashtags: readonly string[];
/** Append the `© year channel` line (mirrors the description toggle). */
showCopyright?: boolean;
/** Append the `🎁 Thanks to …` line when both sponsor fields are set. */
showSponsorCredit?: boolean;
/** English-fixed `t` for the bilingual content-warnings block. */
tEn?: TranslationFn;
}
export interface SocialPostOutput {
text: string;
charCount: number;
isOver: boolean;
/** Ids of optional blocks dropped to fit the limit, in the order
* dropped (empty when everything fit). */
droppedBlocks: string[];
}
/** Optional blocks listed in display order (Title is always first,
* hashtags always last — neither is in this list). */
const DISPLAY_ORDER = ["rig", "warnings", "thanks", "copyright"] as const;
type BlockId = (typeof DISPLAY_ORDER)[number];
/** Drop priority when the caption overflows: warnings go first (longest,
* least essential for a short clip), the rig credit goes last. */
const DROP_ORDER: readonly BlockId[] = ["warnings", "copyright", "thanks", "rig"];
function buildRigBlock(input: GeneratorInput, t: TranslationFn): string {
// Mirrors the description-builder rig block: id → formatted value,
// skipping empties, `KEY: value` per line under the localized header.
const rigLines = Object.entries(input.rig ?? {})
.map(([k, v]) => [k, formatRigValue(k, v ?? "")] as const)
.filter(([, v]) => v && v.trim() !== "")
.map(([k, v]) => `${k.replace(/_/g, " ").toUpperCase()}: ${v}`)
.join("\n");
return rigLines ? `${t("description.sections.rig")}\n${rigLines}` : "";
}
function dedupeHashtags(tags: readonly string[]): string[] {
const seen = new Set<string>();
const out: string[] = [];
for (const tag of tags) {
const key = tag.toLowerCase();
if (!tag || seen.has(key)) continue;
seen.add(key);
out.push(tag);
}
return out;
}
function buildHashtagLine(
input: GeneratorInput,
popular: readonly string[],
): string {
const gameName = input.gameNameLocalized?.[input.language] ?? input.gameName;
const primaryGenre = input.genres[0];
const derived = [
`#${sanitizeHashtag(gameName)}`,
"#GameplayNoCommentary",
...(primaryGenre ? [`#${sanitizeHashtag(primaryGenre)}`] : []),
];
return dedupeHashtags([...derived, ...popular]).join(" ");
}
export function buildSocialPost(
input: GeneratorInput,
t: TranslationFn,
options: SocialPostOptions,
): SocialPostOutput {
const { charLimit, popularHashtags, showCopyright, showSponsorCredit, tEn } =
options;
// Title — short-form, so the `[2K 60FPS]` badge is suppressed.
const title = buildTitle(input, t, { showQualityBadge: false });
const blocks: Record<BlockId, string> = {
rig: buildRigBlock(input, t),
warnings:
buildBilingualBulletSection(
input.contentWarnings ?? [],
"description.contentWarnings",
input.language,
t,
tEn,
) ?? "",
thanks:
showSponsorCredit &&
input.sponsorName?.trim() &&
input.sponsorPlatform?.trim()
? t("description.sections.sponsorCredit", {
sponsor: input.sponsorName.trim(),
platform: input.sponsorPlatform.trim(),
})
: "",
copyright:
showCopyright && input.channelName.trim()
? t("description.sections.copyright", {
year: String(new Date().getFullYear()),
channelName: input.channelName.trim(),
})
: "",
};
const hashtags = buildHashtagLine(input, popularHashtags);
// Track which optional blocks are still present; drop in priority order
// until the caption fits. Title + hashtags are always kept.
const present = new Set<BlockId>(
DISPLAY_ORDER.filter((id) => blocks[id].trim() !== ""),
);
const assemble = (): string => {
const parts: string[] = [title];
for (const id of DISPLAY_ORDER) {
if (present.has(id)) parts.push(blocks[id]);
}
if (hashtags) parts.push(hashtags);
return parts.filter((p) => p.trim() !== "").join("\n\n");
};
const droppedBlocks: string[] = [];
let text = assemble();
for (const id of DROP_ORDER) {
if (text.length <= charLimit) break;
if (present.has(id)) {
present.delete(id);
droppedBlocks.push(id);
text = assemble();
}
}
return {
text,
charCount: text.length,
isOver: text.length > charLimit,
droppedBlocks,
};
}
/**
* Build a caption for every platform in `platforms`, keyed by platform id.
* `shared` carries the description-level toggles + the English-fixed `t`
* so each platform renders consistently.
*/
export function buildAllSocialPosts(
input: GeneratorInput,
t: TranslationFn,
platforms: readonly SocialPlatform[],
shared: {
showCopyright?: boolean;
showSponsorCredit?: boolean;
tEn?: TranslationFn;
},
): Record<string, SocialPostOutput> {
const out: Record<string, SocialPostOutput> = {};
for (const p of platforms) {
out[p.id] = buildSocialPost(input, t, {
charLimit: p.charLimit,
popularHashtags: p.popularHashtags,
showCopyright: shared.showCopyright,
showSponsorCredit: shared.showSponsorCredit,
tEn: shared.tEn,
});
}
return out;
}
+7
View File
@@ -54,6 +54,12 @@ export interface RenderOptions extends TagOptions {
* dev/publisher contractually requires attribution in the description.
*/
showGameCopyright?: boolean;
/**
* When true, the description appends an AI-translation disclaimer block
* for output languages outside the trusted set (English / Vietnamese).
* v0.24.0.
*/
showTranslationQuality?: boolean;
/**
* Optional English-fixed translation function. Used by the v0.11
* unified content-warnings block to render bilingual lines
@@ -81,6 +87,7 @@ export function renderAll(
showSponsorCredit: options?.showSponsorCredit,
showThirdPartyAds: options?.showThirdPartyAds,
showGameCopyright: options?.showGameCopyright,
showTranslationQuality: options?.showTranslationQuality,
tEn: options?.tEn,
});
const tags = generateTags(input, options);
+84
View File
@@ -267,6 +267,18 @@ export const CONTENT_WARNINGS = [
"migraine_trigger",
"strobe_effects",
"screen_shake_intense",
// Photosensitive — VFX intensity (v0.23.0). Modern AAA / horror games
// ship visual-effects passes (bloom, particles, post-processing) that
// strain the same audience as flashing-lights / strobe but no existing
// warning surfaced them. Same group placement, no new group needed.
"lens_flare_intense",
"bloom_excessive",
"particle_effects_dense",
"screen_overlay_flashing",
"color_saturation_extreme",
"motion_blur_heavy",
"depth_of_field_aggressive",
"post_processing_intense",
// Audio / sensory (v0.22.0). `loud_noises` migrated here from the
// photosensitive block where it never quite fit — sudden volume changes
// and high-pitched tones affect a different (audio-sensitive) audience
@@ -284,6 +296,20 @@ export const CONTENT_WARNINGS = [
"glass_breaking_audio",
"microphone_pops",
"white_noise_static",
// Dialogue / language (v0.25.0). What characters *say* — profanity,
// innuendo, slurs, humor tone, substance references — is judged by
// YouTube and viewers separately from what's *shown*, so spoken/written
// content gets its own disclosure block (ESRB-style descriptors).
"profanity_frequent",
"sexual_innuendo",
"inflammatory_speech",
"verbal_abuse",
"threatening_language",
"slurs_derogatory",
"crude_humor",
"mature_humor",
"dark_humor",
"drug_references",
// Phobias
"jump_scares",
"acrophobia",
@@ -338,6 +364,14 @@ export const CONTENT_WARNINGS = [
"cymophobia",
"limnophobia",
"potamophobia",
// Phobias — colors (v0.25.0). Chromophobia and per-color variants:
// monochrome set pieces (all-red rooms, stark-white liminal halls)
// are a recurring horror device that triggers this audience.
"chromophobia",
"erythrophobia",
"xanthophobia",
"leukophobia",
"melanophobia",
// Mental health
"anxiety_inducing",
"depression_themes",
@@ -377,9 +411,41 @@ export const CONTENT_WARNINGS = [
"quarter_life_crisis",
"workplace_harassment",
"masculinity_pressure",
// Social phenomena — body image (v0.25.0)
"body_shaming",
"beauty_standards",
// Internet / digital life (v0.25.0). 21st-century online phenomena —
// cyberbullying, viral misinformation, scams, parasocial economies —
// increasingly drive game narratives but had no disclosure ids.
"cyberbullying",
"doxxing",
"trolling_griefing",
"cancel_culture",
"social_media_addiction",
"doomscrolling",
"fomo",
"fake_news",
"online_scams",
"catfishing",
"deepfake_themes",
"cyberstalking",
"internet_challenges",
"influencer_culture",
"online_radicalization",
"loot_boxes",
"ai_themes",
"data_privacy",
// Mature / sensitive
"blood_gore",
"mature_18plus",
// Sensitive — suggestive imagery (v0.25.0). Visuals unsuitable for
// minors that fall short of explicit content: skimpy outfits,
// partial nudity, sexualized designs, fan-service shots.
"revealing_outfits",
"partial_nudity",
"sexualized_characters",
"fanservice",
"suggestive_poses",
"disturbing_imagery",
"animal_abuse",
"child_harm",
@@ -474,6 +540,9 @@ export const CONTENT_WARNINGS = [
"cheats_enabled",
"glitch_exploits",
"assisted_run",
// v0.25.0: the game itself is educational / PSA / propaganda material —
// a nature-of-content disclosure, not a playthrough disclosure.
"educational_purpose_only",
] as const;
export type ContentWarning = (typeof CONTENT_WARNINGS)[number];
@@ -767,6 +836,21 @@ export interface GeneratorOutput {
warnings: CharLimitWarning[];
}
/**
* Pending/placeholder output rendered while a locale bundle is still being
* fetched (v0.26 lazy-loaded locales). `title === ""` doubles as the gate
* for OutputPage's history-save effect, so no wrong-language entry can be
* recorded from a not-yet-loaded translator.
*/
export const EMPTY_GENERATOR_OUTPUT: GeneratorOutput = {
title: "",
description: "",
tags: [],
tagString: "",
charCounts: { title: 0, description: 0, tags: 0 },
warnings: [],
};
export interface CharLimitWarning {
field: "title" | "description" | "tags";
current: number;
+28 -15
View File
@@ -2,8 +2,9 @@ import { useMemo } from "react";
import i18n from "i18next";
import { useSettingsStore } from "@store/settings-store";
import { renderAll } from "@engine/template-renderer";
import type { GeneratorOutput } from "@engine/types";
import { EMPTY_GENERATOR_OUTPUT, type GeneratorOutput } from "@engine/types";
import { useCurrentGeneratorInput } from "./use-current-generator-input";
import { useLanguagesReady } from "./use-languages-ready";
export function useGeneratedOutput(): GeneratorOutput {
const input = useCurrentGeneratorInput();
@@ -17,31 +18,42 @@ export function useGeneratedOutput(): GeneratorOutput {
showSponsorCredit,
showGameCopyright,
showThirdPartyAds,
showTranslationQuality,
titleFormat,
} = useSettingsStore();
// Lazy-loaded locales (v0.26): block generation until the output
// language's bundle is in memory — getFixedT would otherwise silently
// render English, and OutputPage would save that as a history entry.
const ready = useLanguagesReady([input.language]);
const t = useMemo(() => i18n.getFixedT(input.language, "templates"), [input.language]);
// Always-English `t` for the v0.11 bilingual content-warning block.
// Built once per render so the engine receives a stable function ref;
// the engine falls back to `t` when this is undefined.
// the engine falls back to `t` when this is undefined. `en` is eagerly
// bundled, so it never needs the readiness gate.
const tEn = useMemo(() => i18n.getFixedT("en", "templates"), []);
return useMemo(
() =>
renderAll(input, t, {
includeMultilingualTags,
includeTrendingTags,
hashtagCount,
showQualityBadge,
showCopyright,
showUsagePolicy,
showSponsorCredit,
showGameCopyright,
showThirdPartyAds,
titleFormat,
tEn,
}),
!ready
? EMPTY_GENERATOR_OUTPUT
: renderAll(input, t, {
includeMultilingualTags,
includeTrendingTags,
hashtagCount,
showQualityBadge,
showCopyright,
showUsagePolicy,
showSponsorCredit,
showGameCopyright,
showThirdPartyAds,
showTranslationQuality,
titleFormat,
tEn,
}),
[
ready,
input,
t,
tEn,
@@ -54,6 +66,7 @@ export function useGeneratedOutput(): GeneratorOutput {
showSponsorCredit,
showGameCopyright,
showThirdPartyAds,
showTranslationQuality,
titleFormat,
],
);
+47
View File
@@ -0,0 +1,47 @@
import { useEffect, useMemo, useState } from "react";
import { ensureLanguagesLoaded, hasLanguageBundles } from "@i18n/index";
import type { SupportedLanguage } from "@engine/types";
/**
* Returns true once every requested language has its locale bundles in
* memory (v0.26 lazy-loaded locales). Until then the caller must render a
* pending placeholder instead of generating — an unloaded language would
* otherwise silently produce English fallback output.
*
* Resolves to true even when a bundle fails to fetch (offline, stale
* deploy): `ensureLanguagesLoaded` logs the failure and the app degrades
* to English rather than hanging the UI.
*/
export function useLanguagesReady(
langs: readonly SupportedLanguage[],
): boolean {
const joined = langs.join(",");
// Stable identity for the requested set — callers pass fresh array
// literals on every render.
const key = useMemo(
() => [...new Set(joined ? joined.split(",") : [])].sort().join(","),
[joined],
);
const [readyKey, setReadyKey] = useState<string | null>(() =>
langs.every(hasLanguageBundles) ? key : null,
);
useEffect(() => {
const wanted = (key ? key.split(",") : []) as SupportedLanguage[];
if (wanted.every(hasLanguageBundles)) {
setReadyKey(key);
return;
}
let cancelled = false;
void ensureLanguagesLoaded(wanted).finally(() => {
if (!cancelled) setReadyKey(key);
});
return () => {
cancelled = true;
};
}, [key]);
// Comparing against the current key means a late resolve for a
// superseded language set can never mark the new set ready.
return readyKey === key;
}
+7
View File
@@ -4,11 +4,16 @@ import { useSettingsStore } from "@store/settings-store";
import { renderAll } from "@engine/template-renderer";
import type { GeneratorOutput, SupportedLanguage } from "@engine/types";
import { useCurrentGeneratorInput } from "./use-current-generator-input";
import { useLanguagesReady } from "./use-languages-ready";
export function useMultilangOutput(
languages: SupportedLanguage[],
): Record<string, GeneratorOutput> {
const baseInput = useCurrentGeneratorInput();
// Lazy-loaded locales (v0.26): all-or-nothing gate — OutputPage already
// renders nothing for an absent tab entry, and the per-language chunks
// load in parallel, so partial results aren't worth the complexity.
const ready = useLanguagesReady(languages);
const {
includeMultilingualTags,
includeTrendingTags,
@@ -23,6 +28,7 @@ export function useMultilangOutput(
return useMemo(() => {
const results: Record<string, GeneratorOutput> = {};
if (!ready) return results;
for (const lang of languages) {
const tFn = i18n.getFixedT(lang, "templates");
const input = { ...baseInput, language: lang };
@@ -40,6 +46,7 @@ export function useMultilangOutput(
}
return results;
}, [
ready,
languages,
baseInput,
includeMultilingualTags,
+37
View File
@@ -0,0 +1,37 @@
import { useEffect, useState } from "react";
function readOnline(): boolean {
return typeof navigator === "undefined" ? true : navigator.onLine;
}
/**
* Track the browser's connectivity. Returns `true` when online.
*
* SSR/Tauri-safe (guards `navigator` / `window`). Re-syncs once on mount in
* case the status flipped between the initial `useState` read and the effect
* attaching. Mirrors the add/remove-listener shape of
* {@link import("@hooks/use-global-error-handler").useGlobalErrorHandler}.
*
* Note: `navigator.onLine` only reports the OS/browser link state, not whether
* the wider internet is reachable — which is exactly right here, since the app
* is fully client-side and "online" only gates lazy locale fetches + external
* links, never core functionality.
*/
export function useOnlineStatus(): boolean {
const [online, setOnline] = useState(readOnline);
useEffect(() => {
if (typeof window === "undefined") return;
const goOnline = () => setOnline(true);
const goOffline = () => setOnline(false);
window.addEventListener("online", goOnline);
window.addEventListener("offline", goOffline);
setOnline(readOnline());
return () => {
window.removeEventListener("online", goOnline);
window.removeEventListener("offline", goOffline);
};
}, []);
return online;
}
+49
View File
@@ -0,0 +1,49 @@
import { useMemo } from "react";
import i18n from "i18next";
import { useSettingsStore } from "@store/settings-store";
import {
buildAllSocialPosts,
type SocialPostOutput,
} from "@engine/social-post-builder";
import { SOCIAL_PLATFORMS } from "@config/social-platforms";
import type { SupportedLanguage } from "@engine/types";
import { useCurrentGeneratorInput } from "./use-current-generator-input";
import { useLanguagesReady } from "./use-languages-ready";
/**
* Memoised editor-state → cross-post captions hook (v0.24.0). Mirrors
* {@link useGeneratedOutput}: assembles the same {@link GeneratorInput},
* pulls the relevant description toggles, and renders one caption per
* platform. Takes an optional language override so the Social page's bulk
* mode can reuse it the way Batch reuses the generator input.
*/
export function useSocialPosts(
languageOverride?: SupportedLanguage,
): Record<string, SocialPostOutput> {
const input = useCurrentGeneratorInput(languageOverride);
const { showCopyright, showSponsorCredit } = useSettingsStore();
// Lazy-loaded locales (v0.26): no caption until the output language's
// bundle is in memory — SocialPage renders nothing for an empty record.
const ready = useLanguagesReady([input.language]);
const t = useMemo(
() => i18n.getFixedT(input.language, "templates"),
[input.language],
);
// Always-English `t` for the bilingual content-warnings block, built
// once so the engine receives a stable ref.
const tEn = useMemo(() => i18n.getFixedT("en", "templates"), []);
return useMemo(
() =>
!ready
? {}
: buildAllSocialPosts(input, t, SOCIAL_PLATFORMS, {
showCopyright,
showSponsorCredit,
tEn,
}),
[ready, input, t, tEn, showCopyright, showSponsorCredit],
);
}
+80 -26
View File
@@ -1,18 +1,11 @@
import i18n from "i18next";
import { initReactI18next } from "react-i18next";
import resourcesToBackend from "i18next-resources-to-backend";
import type { SupportedLanguage } from "@engine/types";
import { logger } from "@utils/logger";
import enUI from "./locales/en/ui.json";
import enTemplates from "./locales/en/templates.json";
import viUI from "./locales/vi/ui.json";
import viTemplates from "./locales/vi/templates.json";
import jaUI from "./locales/ja/ui.json";
import jaTemplates from "./locales/ja/templates.json";
import esUI from "./locales/es/ui.json";
import esTemplates from "./locales/es/templates.json";
import koUI from "./locales/ko/ui.json";
import koTemplates from "./locales/ko/templates.json";
import zhUI from "./locales/zh/ui.json";
import zhTemplates from "./locales/zh/templates.json";
export const SUPPORTED_LANGUAGES = [
{ id: "en", label: "English", flag: "🇬🇧", nativeName: "English" },
@@ -23,21 +16,82 @@ export const SUPPORTED_LANGUAGES = [
{ id: "zh", label: "Chinese", flag: "🇨🇳", nativeName: "简体中文" },
] as const;
i18n.use(initReactI18next).init({
resources: {
en: { ui: enUI, templates: enTemplates },
vi: { ui: viUI, templates: viTemplates },
ja: { ui: jaUI, templates: jaTemplates },
es: { ui: esUI, templates: esTemplates },
ko: { ui: koUI, templates: koTemplates },
zh: { ui: zhUI, templates: zhTemplates },
},
ns: ["ui", "templates"],
defaultNS: "ui",
fallbackLng: "en",
interpolation: {
escapeValue: false,
},
});
i18n
.use(initReactI18next)
.use(
// Vite statically analyses this template literal and emits one async
// chunk per locale JSON, fetched on first use. `en` is also statically
// imported above, so Rollup keeps it in the main chunk — and i18next
// never asks the backend for it because bundled namespaces are served
// from `resources` (see `partialBundledLanguages`).
resourcesToBackend(
(lng: string, ns: string) => import(`./locales/${lng}/${ns}.json`),
),
)
.init({
resources: { en: { ui: enUI, templates: enTemplates } },
partialBundledLanguages: true,
ns: ["ui", "templates"],
defaultNS: "ui",
fallbackLng: "en",
interpolation: {
escapeValue: false,
},
react: {
// react-i18next defaults this to true; with lazily-loaded bundles an
// unready namespace would suspend Header/AppShell, which sit outside
// every Suspense boundary. Readiness is handled explicitly instead
// (useLanguagesReady / ensureLanguagesLoaded).
useSuspense: false,
},
});
const NAMESPACES = ["ui", "templates"] as const;
/** Both bundles for a language are in memory. */
export function hasLanguageBundles(lang: string): boolean {
return NAMESPACES.every((ns) => i18n.hasResourceBundle(lang, ns));
}
/**
* Resolve once every requested language has its `ui` + `templates` bundles
* in memory — the contract every `getFixedT` call site relies on, since
* i18next silently serves English fallback strings for unloaded languages.
*
* Never rejects: a language whose chunk cannot be fetched (offline, stale
* deploy HTML) is logged and left to the `fallbackLng` English degrade.
*/
export async function ensureLanguagesLoaded(
langs: readonly SupportedLanguage[],
): Promise<void> {
const wanted = [...new Set(langs)].filter((l) => !hasLanguageBundles(l));
if (wanted.length === 0) return;
await i18n.loadLanguages(wanted);
// A failed fetch leaves the connector state at -1, and BOTH loadLanguages
// and reloadResources skip state<0 entries forever after — one transient
// blip would otherwise pin the whole session to English. Retry once by
// importing the chunk directly and feeding the store (public API; the
// template literal matches the backend loader's, so no extra chunks).
const failed: SupportedLanguage[] = [];
for (const lng of wanted.filter((l) => !hasLanguageBundles(l))) {
for (const ns of NAMESPACES) {
if (i18n.hasResourceBundle(lng, ns)) continue;
try {
const mod = (await import(`./locales/${lng}/${ns}.json`)) as {
default: Record<string, unknown>;
};
i18n.addResourceBundle(lng, ns, mod.default);
} catch {
if (!failed.includes(lng)) failed.push(lng);
}
}
}
if (failed.length > 0) {
logger.warn(
"i18n",
`Locale bundle load failed: ${failed.join(", ")} — falling back to English`,
);
}
}
export default i18n;
+35 -13
View File
@@ -1,15 +1,16 @@
{
"ui": {
"app": ["title", "subtitle"],
"tabs": ["editor", "output", "profiles", "history", "settings", "batch", "playlist", "logs", "about", "reportBug"],
"tabs": ["editor", "output", "profiles", "history", "settings", "batch", "social", "playlist", "logs", "about", "reportBug"],
"sidebar": ["expand", "collapse"],
"header": ["donate"],
"header": ["donate", "toggleTheme"],
"about": [
"tagline",
"repoHeading", "repoLabel", "issuesLabel", "reportBugLabel", "discussionsLabel", "authorLabel", "licenseLabel",
"donateHeading", "donateHelp",
"connectHeading",
"thirdPartyHeading", "thirdPartyHelp"
"thirdPartyHeading", "thirdPartyHelp",
"legalHeading"
],
"about.donate": ["githubSponsors", "kofi", "buyMeACoffee", "patreon", "paypal"],
"about.socials": ["youtube", "x", "bluesky", "mastodon", "discord", "discordGame", "steam", "telegramBot", "telegramUser", "email"],
@@ -29,7 +30,7 @@
"gachaVersion", "gachaVersionPlaceholder",
"gpu_brand", "gpu_series", "gpu_model", "gpu_custom",
"ram_size", "ram_ddr",
"os_name", "os_version", "os_edition",
"os_name", "os_version", "os_edition", "os_distro",
"vnDonate", "vnDonateHelp",
"vnBankName", "vnBankNamePlaceholder", "vnBankNameSelectPlaceholder", "vnBankNameOther",
"vnBankAccount", "vnBankAccountPlaceholder",
@@ -110,26 +111,30 @@
"not_no_hit_run", "not_clean_walkthrough", "casual_no_commentary", "many_deaths_patience", "slow_exploration", "puzzle_stuck_possible", "grinding_cut", "not_speedrun_relaxed",
"exploration_focus_skip_combat", "edited_for_pacing", "support_developers", "online_connectivity_issues"
],
"editor.contentWarningGroups": ["spoilers", "photosensitive", "audio", "phobias", "mental_health", "social_phenomena", "sensitive", "playstyle", "horror_specific", "gameplay_disclosure"],
"editor.contentWarningGroups": ["spoilers", "photosensitive", "audio", "dialogue", "phobias", "mental_health", "social_phenomena", "internet_digital", "sensitive", "playstyle", "horror_specific", "gameplay_disclosure"],
"editor.contentWarningOptions": [
"spoiler_story", "spoiler_ending", "spoiler_true_ending", "spoiler_post_game", "spoiler_secret_ending", "spoiler_dlc",
"flashing_lights", "motion_sickness", "migraine_trigger", "strobe_effects", "screen_shake_intense",
"lens_flare_intense", "bloom_excessive", "particle_effects_dense", "screen_overlay_flashing", "color_saturation_extreme", "motion_blur_heavy", "depth_of_field_aggressive", "post_processing_intense",
"loud_noises", "ear_piercing", "jumpscare_audio", "sudden_volume_changes", "distorted_audio", "screeching_metallic", "persistent_high_pitch", "audio_glitches", "heavy_bass_rumble", "screaming_audio", "glass_breaking_audio", "microphone_pops", "white_noise_static",
"profanity_frequent", "sexual_innuendo", "inflammatory_speech", "verbal_abuse", "threatening_language", "slurs_derogatory", "crude_humor", "mature_humor", "dark_humor", "drug_references",
"jump_scares", "acrophobia", "trypophobia", "thalassophobia", "claustrophobia", "arachnophobia", "entomophobia", "ophidiophobia",
"cynophobia", "nyctophobia", "pyrophobia", "pediophobia", "hemophobia", "coulrophobia", "ablutophobia", "taphophobia",
"automatonophobia", "megalophobia", "submechanophobia", "necrophobia", "spectrophobia", "demonophobia", "selachophobia", "mysophobia", "emetophobia", "scopophobia", "monophobia", "musophobia", "chiroptophobia", "ornithophobia", "ichthyophobia", "herpetophobia", "katsaridaphobia", "apiphobia", "astraphobia", "agoraphobia", "enochlophobia", "chionophobia", "nosocomephobia", "aichmophobia", "pnigophobia",
"homichlophobia", "lilapsophobia", "ombrophobia", "nephophobia", "ancraophobia", "cryophobia", "heliophobia", "cymophobia", "limnophobia", "potamophobia",
"chromophobia", "erythrophobia", "xanthophobia", "leukophobia", "melanophobia",
"anxiety_inducing", "depression_themes", "eating_disorders", "substance_use", "self_harm", "ptsd_themes", "needles", "body_fluids", "pregnancy_horror", "illness_themes",
"bipolar_themes", "ocd_themes", "panic_attacks", "dissociation", "paranoia_themes", "intrusive_thoughts", "medical_horror",
"autism_themes", "adhd_themes", "hikikomori", "neet_themes", "social_anxiety_themes", "social_isolation", "schizophrenia_themes", "burnout_themes", "survivor_guilt", "abandonment_themes", "parasocial_themes", "gaslighting_themes", "stockholm_syndrome", "behavioral_addiction", "existential_crisis", "impostor_syndrome", "midlife_crisis", "quarter_life_crisis", "workplace_harassment", "masculinity_pressure",
"blood_gore", "mature_18plus", "disturbing_imagery", "animal_abuse", "child_harm", "domestic_violence", "sexual_assault", "torture", "religion_themes", "war_violence", "discrimination", "police_violence", "smoking_drinking", "detailed_killing", "cult_occult", "psychological_manipulation", "grief_loss", "kidnapping",
"autism_themes", "adhd_themes", "hikikomori", "neet_themes", "social_anxiety_themes", "social_isolation", "schizophrenia_themes", "burnout_themes", "survivor_guilt", "abandonment_themes", "parasocial_themes", "gaslighting_themes", "stockholm_syndrome", "behavioral_addiction", "existential_crisis", "impostor_syndrome", "midlife_crisis", "quarter_life_crisis", "workplace_harassment", "masculinity_pressure", "body_shaming", "beauty_standards",
"cyberbullying", "doxxing", "trolling_griefing", "cancel_culture", "social_media_addiction", "doomscrolling", "fomo", "fake_news", "online_scams", "catfishing", "deepfake_themes", "cyberstalking", "internet_challenges", "influencer_culture", "online_radicalization", "loot_boxes", "ai_themes", "data_privacy",
"blood_gore", "mature_18plus", "revealing_outfits", "partial_nudity", "sexualized_characters", "fanservice", "suggestive_poses", "disturbing_imagery", "animal_abuse", "child_harm", "domestic_violence", "sexual_assault", "torture", "religion_themes", "war_violence", "discrimination", "police_violence", "smoking_drinking", "detailed_killing", "cult_occult", "psychological_manipulation", "grief_loss", "kidnapping",
"hate_speech", "historical_atrocity", "slavery_themes", "terrorism_themes", "bullying_themes", "human_experimentation", "cannibalism", "nuclear_themes",
"homophobia", "transphobia", "xenophobia",
"political_extremism", "religious_extremism", "genocide", "holy_war", "holocaust_themes", "civil_war", "mass_shooting", "colonialism", "propaganda", "dystopian_state", "conspiracy_theories", "censorship_themes", "ethnic_conflict", "refugee_crisis", "revolution_themes", "assassination", "coup_themes", "inquisition", "forced_labor", "ultranationalism",
"hanging_depiction", "drowning_depiction", "burning_alive", "asphyxiation_depiction", "restraint_torture", "public_execution", "decapitation", "impalement", "mass_casualty_event", "vehicular_violence", "overdose_depiction", "defenestration",
"blind_playthrough", "no_spoilers_chat", "casual_difficulty", "hardcore_difficulty", "permadeath_run", "speedrun_attempt", "completionist_run", "learning_mechanics", "first_time_playing", "returning_player",
"eye_horror", "body_horror", "face_horror", "cosmic_horror", "extreme_gore", "decay_rot", "mutilation", "liminal_spaces", "analog_horror", "unreality_themes", "pursuit_chase", "entity_horror",
"mods_used", "cheats_enabled", "glitch_exploits", "assisted_run"
"mods_used", "cheats_enabled", "glitch_exploits", "assisted_run", "educational_purpose_only"
],
"editor.videoStyleOptions": [
"1980s", "1990s", "2000s", "2010s", "2020s",
@@ -157,18 +162,29 @@
"output.variants": ["default", "typeFirst", "qualityFirst"],
"output.copy": ["overLimit", "fieldGeneric", "failed"],
"common": ["save", "cancel", "delete", "confirm", "export", "import", "reset", "search", "generate", "undo", "dismiss", "scrollToTop"],
"errorPages.actions": ["home", "back", "retry", "reload", "reportBug"],
"errorPages.offlineBanner": ["message", "details", "backOnline"],
"errorPages.notFound": ["title", "description"],
"errorPages.forbidden": ["title", "description"],
"errorPages.expired": ["title", "description"],
"errorPages.serverError": ["title", "description"],
"errorPages.offline": ["title", "description"],
"errorPages.runtime": ["title", "description"],
"consentGate": ["title", "intro", "agreeLabel", "continue", "mustAgree", "docTerms", "docPrivacy", "docDisclaimer", "docLicense"],
"videoTypes": ["full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles", "livestream", "gacha_quest"],
"genres": ["action", "hack_slash", "beatemup", "platformer", "horror", "survival_horror", "psychological_horror", "rpg", "jrpg", "action_rpg", "crpg", "fps", "arena_shooter", "tactical_fps", "boomer_shooter", "extraction_shooter", "shmup", "openworld", "indie", "soulslike", "racing", "story", "simulation", "city_builder", "fighting", "stealth", "survival_craft", "roguelike", "metroidvania", "mmo", "rhythm", "puzzle", "tower_defense", "card_game", "deck_builder", "auto_battler", "battle_royale", "tactical", "space", "farming", "fmv", "visual_novel"],
"rig": ["os", "cpu", "gpu", "ram", "storage", "monitor", "capture", "motherboard", "controller", "video_editor"],
"social": ["kofi", "patreon", "buymeacoffee", "paypal", "github", "twitter", "discord", "website", "twitch", "tiktok", "instagram", "streamlabs", "bluesky", "mastodon", "facebook", "fb_page", "fb_group"],
"social": ["kofi", "patreon", "buymeacoffee", "paypal", "github", "twitter", "discord", "website", "twitch", "tiktok", "instagram", "streamlabs", "bluesky", "mastodon", "facebook", "fb_page", "fb_group", "telegram"],
"resolutions": ["720p", "1080p", "1440p", "4K"],
"fpsOptions": ["30", "60", "120", "144"],
"profiles": ["title", "createNew", "editProfile", "profileName", "profileNamePlaceholder", "loadProfile", "deleteConfirm", "emptyState", "exportProfiles", "importProfiles", "thirdPartyAdText", "thirdPartyAdTextPlaceholder", "thirdPartyAdTextHelp"],
"presets": ["title", "createNew", "editPreset", "loadPreset", "deleteConfirm", "emptyState", "selectPreset", "noPresets", "exportPresets", "importPresets"],
"templates": ["title", "createNew", "saveAsTemplate", "templateName", "templateNamePlaceholder", "loadTemplate", "deleteConfirm", "emptyState", "saveHint", "savedAs", "appliedToast", "exportTemplates", "importTemplates"],
"history": ["title", "emptyState", "clearAll", "clearConfirm", "searchPlaceholder"],
"settings": ["title", "appearance", "defaults", "editorSettings", "tagSettings", "historySettings", "theme", "appLanguage", "defaultOutputLanguage", "showCharCount", "compactTagDisplay", "historyLimit", "multilingualTags", "trendingTags", "hashtagCount", "showQualityBadge", "showCopyright", "showGameCopyright", "showGameCopyrightHint", "showUsagePolicy", "showSponsorCredit", "showThirdPartyAds", "thirdPartyAdsHint", "titleFormatTitle", "descriptionSettingsTitle", "badgePosition", "badgePositionPrefix", "badgePositionMiddle", "badgePositionSuffix", "titleSeparator", "titleSeparatorEmDash", "titleSeparatorHyphen", "titleSeparatorColon", "titleSeparatorPipe", "badgeCase", "badgeCaseUpper", "badgeCaseLower", "showPinnedCommentTemplate", "pinnedCommentIncludeAskNextGame", "pinnedCommentIncludeGenrePlaylist", "genrePlaylistsTitle", "genrePlaylistsHelp", "genrePlaylistsEmptyHint", "logSettings", "logRetentionDays", "logRetentionHint"],
"settings": ["title", "appearance", "defaults", "editorSettings", "tagSettings", "historySettings", "theme", "appLanguage", "defaultOutputLanguage", "showCharCount", "compactTagDisplay", "historyLimit", "multilingualTags", "trendingTags", "hashtagCount", "showQualityBadge", "showCopyright", "showGameCopyright", "showGameCopyrightHint", "showUsagePolicy", "showSponsorCredit", "showThirdPartyAds", "thirdPartyAdsHint", "showTranslationQuality", "showTranslationQualityHint", "titleFormatTitle", "descriptionSettingsTitle", "badgePosition", "badgePositionPrefix", "badgePositionMiddle", "badgePositionSuffix", "titleSeparator", "titleSeparatorEmDash", "titleSeparatorHyphen", "titleSeparatorColon", "titleSeparatorPipe", "badgeCase", "badgeCaseUpper", "badgeCaseLower", "showPinnedCommentTemplate", "pinnedCommentIncludeAskNextGame", "pinnedCommentIncludeGenrePlaylist", "genrePlaylistsTitle", "genrePlaylistsHelp", "genrePlaylistsEmptyHint", "logSettings", "logRetentionDays", "logRetentionHint"],
"batch": ["title", "startPart", "endPart", "generateBatch", "copyAllBatch", "emptyState"],
"socialPost": ["title", "single", "bulk", "copyCaption", "emptyState", "trimmedHint", "overLimitHint", "exported", "exportFailed", "imported", "importFailed", "importedHeading"],
"socialPost.platforms": ["tiktok", "instagram_reels", "facebook_reels"],
"shortcuts": ["title", "generate", "copyAll", "saveDraft", "toggleSidebar", "help", "close", "searchPlaceholder", "noResults"],
"validation": ["emailInvalid", "emailMaxExceeded", "urlInvalid", "urlPrefixMismatch", "playlistUrlInvalid"],
"logs": ["title", "emptyState", "clearAll", "clearConfirm", "clearPersistedConfirm", "clearSession", "searchPlaceholder", "exportJson", "exportTxt", "sessionCurrent", "sessionLabel", "entriesShort"],
@@ -215,6 +231,8 @@
"description.playthroughNotes.labels": ["runType", "difficulty", "endings", "languagePatch", "gameVersion"],
"description.playthroughNotes.languagePatchOptions": ["official_en", "official_other", "fan_translation", "mtl", "custom"],
"description.playthroughNotes.gameVersionOptions": ["demo", "early_access", "beta", "prologue", "pre_release", "custom"],
"description.translationQuality": ["header", "intro"],
"description.translationQuality.items": ["accuracy", "phrasing", "localStyle", "corrections"],
"description.techNotes": ["header", "intro"],
"description.techNotes.items": [
"copyright_muted_sections", "volume_reduced_copyright", "music_replaced_copyright", "cutscene_audio_muted_only", "original_audio_kept",
@@ -227,22 +245,26 @@
"description.contentWarnings.items": [
"spoiler_story", "spoiler_ending", "spoiler_true_ending", "spoiler_post_game", "spoiler_secret_ending", "spoiler_dlc",
"flashing_lights", "motion_sickness", "migraine_trigger", "strobe_effects", "screen_shake_intense",
"lens_flare_intense", "bloom_excessive", "particle_effects_dense", "screen_overlay_flashing", "color_saturation_extreme", "motion_blur_heavy", "depth_of_field_aggressive", "post_processing_intense",
"loud_noises", "ear_piercing", "jumpscare_audio", "sudden_volume_changes", "distorted_audio", "screeching_metallic", "persistent_high_pitch", "audio_glitches", "heavy_bass_rumble", "screaming_audio", "glass_breaking_audio", "microphone_pops", "white_noise_static",
"profanity_frequent", "sexual_innuendo", "inflammatory_speech", "verbal_abuse", "threatening_language", "slurs_derogatory", "crude_humor", "mature_humor", "dark_humor", "drug_references",
"jump_scares", "acrophobia", "trypophobia", "thalassophobia", "claustrophobia", "arachnophobia", "entomophobia", "ophidiophobia",
"cynophobia", "nyctophobia", "pyrophobia", "pediophobia", "hemophobia", "coulrophobia", "ablutophobia", "taphophobia",
"automatonophobia", "megalophobia", "submechanophobia", "necrophobia", "spectrophobia", "demonophobia", "selachophobia", "mysophobia", "emetophobia", "scopophobia", "monophobia", "musophobia", "chiroptophobia", "ornithophobia", "ichthyophobia", "herpetophobia", "katsaridaphobia", "apiphobia", "astraphobia", "agoraphobia", "enochlophobia", "chionophobia", "nosocomephobia", "aichmophobia", "pnigophobia",
"homichlophobia", "lilapsophobia", "ombrophobia", "nephophobia", "ancraophobia", "cryophobia", "heliophobia", "cymophobia", "limnophobia", "potamophobia",
"chromophobia", "erythrophobia", "xanthophobia", "leukophobia", "melanophobia",
"anxiety_inducing", "depression_themes", "eating_disorders", "substance_use", "self_harm", "ptsd_themes", "needles", "body_fluids", "pregnancy_horror", "illness_themes",
"bipolar_themes", "ocd_themes", "panic_attacks", "dissociation", "paranoia_themes", "intrusive_thoughts", "medical_horror",
"autism_themes", "adhd_themes", "hikikomori", "neet_themes", "social_anxiety_themes", "social_isolation", "schizophrenia_themes", "burnout_themes", "survivor_guilt", "abandonment_themes", "parasocial_themes", "gaslighting_themes", "stockholm_syndrome", "behavioral_addiction", "existential_crisis", "impostor_syndrome", "midlife_crisis", "quarter_life_crisis", "workplace_harassment", "masculinity_pressure",
"blood_gore", "mature_18plus", "disturbing_imagery", "animal_abuse", "child_harm", "domestic_violence", "sexual_assault", "torture", "religion_themes", "war_violence", "discrimination", "police_violence", "smoking_drinking", "detailed_killing", "cult_occult", "psychological_manipulation", "grief_loss", "kidnapping",
"autism_themes", "adhd_themes", "hikikomori", "neet_themes", "social_anxiety_themes", "social_isolation", "schizophrenia_themes", "burnout_themes", "survivor_guilt", "abandonment_themes", "parasocial_themes", "gaslighting_themes", "stockholm_syndrome", "behavioral_addiction", "existential_crisis", "impostor_syndrome", "midlife_crisis", "quarter_life_crisis", "workplace_harassment", "masculinity_pressure", "body_shaming", "beauty_standards",
"cyberbullying", "doxxing", "trolling_griefing", "cancel_culture", "social_media_addiction", "doomscrolling", "fomo", "fake_news", "online_scams", "catfishing", "deepfake_themes", "cyberstalking", "internet_challenges", "influencer_culture", "online_radicalization", "loot_boxes", "ai_themes", "data_privacy",
"blood_gore", "mature_18plus", "revealing_outfits", "partial_nudity", "sexualized_characters", "fanservice", "suggestive_poses", "disturbing_imagery", "animal_abuse", "child_harm", "domestic_violence", "sexual_assault", "torture", "religion_themes", "war_violence", "discrimination", "police_violence", "smoking_drinking", "detailed_killing", "cult_occult", "psychological_manipulation", "grief_loss", "kidnapping",
"hate_speech", "historical_atrocity", "slavery_themes", "terrorism_themes", "bullying_themes", "human_experimentation", "cannibalism", "nuclear_themes",
"homophobia", "transphobia", "xenophobia",
"political_extremism", "religious_extremism", "genocide", "holy_war", "holocaust_themes", "civil_war", "mass_shooting", "colonialism", "propaganda", "dystopian_state", "conspiracy_theories", "censorship_themes", "ethnic_conflict", "refugee_crisis", "revolution_themes", "assassination", "coup_themes", "inquisition", "forced_labor", "ultranationalism",
"hanging_depiction", "drowning_depiction", "burning_alive", "asphyxiation_depiction", "restraint_torture", "public_execution", "decapitation", "impalement", "mass_casualty_event", "vehicular_violence", "overdose_depiction", "defenestration",
"blind_playthrough", "no_spoilers_chat", "casual_difficulty", "hardcore_difficulty", "permadeath_run", "speedrun_attempt", "completionist_run", "learning_mechanics", "first_time_playing", "returning_player",
"eye_horror", "body_horror", "face_horror", "cosmic_horror", "extreme_gore", "decay_rot", "mutilation", "liminal_spaces", "analog_horror", "unreality_themes", "pursuit_chase", "entity_horror",
"mods_used", "cheats_enabled", "glitch_exploits", "assisted_run"
"mods_used", "cheats_enabled", "glitch_exploits", "assisted_run", "educational_purpose_only"
],
"description.storeLinkSuffix": ["free", "demo"],
"description.graphics": ["with", "artStyle", "videoLabel", "inGameSettingLabel", "versionLabel"],
+60 -1
View File
@@ -163,6 +163,16 @@
"custom": "Custom"
}
},
"translationQuality": {
"header": "▸ 🌐 ABOUT THIS TRANSLATION",
"intro": "Apart from English and Vietnamese, the descriptions on this channel are translated with the help of AI.",
"items": {
"accuracy": "Accuracy isn't guaranteed 100% — some words or terms may be off.",
"phrasing": "Wording can be a bit literal or stiff in places.",
"localStyle": "It may not fully match the local / native writing style.",
"corrections": "Spotted a mistake? A correction in the comments is always appreciated. 🙏"
}
},
"techNotes": {
"header": "▸ 🛠 TECH NOTES",
"intro": "Production and playstyle notes for transparency.",
@@ -206,6 +216,14 @@
"flashing_lights": "Flashing lights — photosensitive viewers take care",
"motion_sickness": "Motion sickness — fast camera / FPS movement",
"migraine_trigger": "Possible migraine trigger",
"lens_flare_intense": "Intense lens flares / sun glare effects",
"bloom_excessive": "Excessive bloom / overblown highlight passes",
"particle_effects_dense": "Dense particle effects — explosions, spells, debris",
"screen_overlay_flashing": "Flashing HUD / UI overlays",
"color_saturation_extreme": "Extreme color saturation / oversaturated palette",
"motion_blur_heavy": "Heavy motion blur (camera + object)",
"depth_of_field_aggressive": "Aggressive depth of field / focus-pull effects",
"post_processing_intense": "Intense post-processing — chromatic aberration, vignette, film grain",
"loud_noises": "Loud / sudden sounds",
"ear_piercing": "Ear-piercing / high-pitched frequencies",
"jumpscare_audio": "Audio jumpscares — sudden loud stings",
@@ -395,7 +413,48 @@
"mass_casualty_event": "Mass-casualty event (attack, disaster)",
"vehicular_violence": "Vehicular violence / intentional ramming",
"overdose_depiction": "Overdose scene",
"defenestration": "Falling from height (intentional)"
"defenestration": "Falling from height (intentional)",
"profanity_frequent": "Frequent profanity / strong language",
"sexual_innuendo": "Sexually suggestive dialogue / innuendo",
"inflammatory_speech": "Inflammatory / inciting dialogue",
"verbal_abuse": "Verbal abuse / demeaning language",
"threatening_language": "Threatening / intimidating language",
"slurs_derogatory": "Slurs / derogatory terms",
"crude_humor": "Crude / toilet humor",
"mature_humor": "Mature / adult humor",
"dark_humor": "Dark / morbid humor",
"drug_references": "Drug / alcohol references in dialogue",
"chromophobia": "Vivid color scenes (chromophobia)",
"erythrophobia": "Red / all-red scenes (erythrophobia)",
"xanthophobia": "Yellow-dominant scenes (xanthophobia)",
"leukophobia": "White / all-white spaces (leukophobia)",
"melanophobia": "Black-dominant scenes (melanophobia)",
"body_shaming": "Body shaming / appearance mockery",
"beauty_standards": "Unrealistic beauty standards",
"cyberbullying": "Cyberbullying / online harassment",
"doxxing": "Doxxing / privacy exposure",
"trolling_griefing": "Trolling / griefing",
"cancel_culture": "Cancel culture / public shaming",
"social_media_addiction": "Social media addiction",
"doomscrolling": "Doomscrolling",
"fomo": "FOMO — fear of missing out",
"fake_news": "Fake news / misinformation",
"online_scams": "Online scams / phishing",
"catfishing": "Catfishing / fake online identity",
"deepfake_themes": "Deepfakes / synthetic media",
"cyberstalking": "Cyberstalking",
"internet_challenges": "Dangerous viral challenges",
"influencer_culture": "Influencer culture / clout chasing",
"online_radicalization": "Online radicalization / echo chambers",
"loot_boxes": "Loot boxes / gacha mechanics",
"ai_themes": "AI / artificial intelligence themes",
"data_privacy": "Data privacy / mass surveillance",
"revealing_outfits": "Revealing / skimpy outfits",
"partial_nudity": "Partial nudity",
"sexualized_characters": "Sexualized character designs",
"fanservice": "Fan service / ecchi content",
"suggestive_poses": "Suggestive poses / camera angles",
"educational_purpose_only": "Educational / PSA-purpose game"
}
},
"graphics": {
+129 -3
View File
@@ -10,6 +10,7 @@
"history": "History",
"settings": "Settings",
"batch": "Batch",
"social": "Social",
"playlist": "Playlist",
"logs": "Logs",
"about": "About",
@@ -20,7 +21,8 @@
"collapse": "Collapse sidebar"
},
"header": {
"donate": "Donate"
"donate": "Donate",
"toggleTheme": "Toggle theme"
},
"about": {
"tagline": "YouTube title, description, and tag generator for Gameplay No Commentary channels.",
@@ -33,6 +35,7 @@
"licenseLabel": "License",
"donateHeading": "Donate / Support",
"donateHelp": "If YTDescGen saves you time, consider buying me a coffee. Every bit helps keep the project going.",
"legalHeading": "Legal",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
@@ -131,6 +134,7 @@
"os_name": "OS",
"os_version": "Version",
"os_edition": "Edition",
"os_distro": "Distro",
"vnDonate": "Donate (Vietnam)",
"vnDonateHelp": "Only rendered into the description when output language is Vietnamese.",
"vnBankName": "Bank name",
@@ -321,9 +325,11 @@
"spoilers": "Spoilers",
"photosensitive": "Photosensitive / Health",
"audio": "Audio / Sensory",
"dialogue": "Dialogue / Language",
"phobias": "Phobias",
"mental_health": "Mental health",
"social_phenomena": "Social phenomena",
"internet_digital": "Internet / Digital life",
"sensitive": "Mature / Sensitive content",
"playstyle": "Playstyle disclosures",
"horror_specific": "Heavy horror",
@@ -339,6 +345,14 @@
"flashing_lights": "Flashing lights",
"motion_sickness": "Motion sickness",
"migraine_trigger": "Migraine trigger",
"lens_flare_intense": "Lens flare / sun glare",
"bloom_excessive": "Excessive bloom / overblown highlights",
"particle_effects_dense": "Dense particle effects",
"screen_overlay_flashing": "Flashing HUD / UI overlays",
"color_saturation_extreme": "Extreme color saturation",
"motion_blur_heavy": "Heavy motion blur",
"depth_of_field_aggressive": "Aggressive depth of field",
"post_processing_intense": "Intense post-processing",
"loud_noises": "Loud / sudden sounds",
"ear_piercing": "Ear-piercing / high-pitched",
"jumpscare_audio": "Audio jumpscares",
@@ -528,7 +542,48 @@
"mass_casualty_event": "Mass-casualty event",
"vehicular_violence": "Vehicular violence",
"overdose_depiction": "Overdose scene",
"defenestration": "Falling from height"
"defenestration": "Falling from height",
"profanity_frequent": "Frequent profanity",
"sexual_innuendo": "Sexual innuendo / suggestive dialogue",
"inflammatory_speech": "Inflammatory / inciting dialogue",
"verbal_abuse": "Verbal abuse",
"threatening_language": "Threats / intimidation",
"slurs_derogatory": "Slurs / derogatory terms",
"crude_humor": "Crude / toilet humor",
"mature_humor": "Mature / adult humor",
"dark_humor": "Dark / morbid humor",
"drug_references": "Drug / alcohol references",
"chromophobia": "Colors / vivid color scenes",
"erythrophobia": "Red / all-red scenes",
"xanthophobia": "Yellow color",
"leukophobia": "White / all-white spaces",
"melanophobia": "Black color",
"body_shaming": "Body shaming / appearance mockery",
"beauty_standards": "Unrealistic beauty standards",
"cyberbullying": "Cyberbullying / online harassment",
"doxxing": "Doxxing / privacy exposure",
"trolling_griefing": "Trolling / griefing",
"cancel_culture": "Cancel culture / public shaming",
"social_media_addiction": "Social media addiction",
"doomscrolling": "Doomscrolling",
"fomo": "FOMO (fear of missing out)",
"fake_news": "Fake news / misinformation",
"online_scams": "Online scams / phishing",
"catfishing": "Catfishing / fake identity",
"deepfake_themes": "Deepfakes / synthetic media",
"cyberstalking": "Cyberstalking",
"internet_challenges": "Dangerous viral challenges",
"influencer_culture": "Influencer culture / clout chasing",
"online_radicalization": "Online radicalization / echo chambers",
"loot_boxes": "Loot boxes / gacha mechanics",
"ai_themes": "AI / artificial intelligence themes",
"data_privacy": "Data privacy / mass surveillance",
"revealing_outfits": "Revealing / skimpy outfits",
"partial_nudity": "Partial nudity",
"sexualized_characters": "Sexualized character designs",
"fanservice": "Fan service / ecchi",
"suggestive_poses": "Suggestive poses / camera angles",
"educational_purpose_only": "Educational / PSA purpose"
},
"playthroughNotes": {
"title": "Playthrough notes",
@@ -695,6 +750,55 @@
"dismiss": "Dismiss",
"scrollToTop": "Scroll to top"
},
"errorPages": {
"actions": {
"home": "Go home",
"back": "Go back",
"retry": "Try again",
"reload": "Reload page",
"reportBug": "Report a bug"
},
"offlineBanner": {
"message": "You're offline. The app keeps working — your data is stored locally.",
"details": "Details",
"backOnline": "Back online"
},
"notFound": {
"title": "Page not found",
"description": "The page you're looking for doesn't exist or has moved. Check the address, or head back to the editor."
},
"forbidden": {
"title": "Access denied",
"description": "You don't have permission to view this page. If you think this is a mistake, please report it."
},
"expired": {
"title": "Session expired",
"description": "This page is no longer valid because your session expired. Reload to start again."
},
"serverError": {
"title": "Something went wrong",
"description": "An unexpected error occurred while loading this page. Try reloading, and report the bug if it keeps happening."
},
"offline": {
"title": "You're offline",
"description": "There's no network connection right now. YTDescGen works fully offline — your profiles, history, and generated text are all stored locally."
},
"runtime": {
"title": "Something went wrong",
"description": "The app caught a render error before it could crash the page. Your data is safe — the error was logged to the Logs tab."
}
},
"consentGate": {
"title": "Before you start",
"intro": "YTDescGen is a free, offline-first tool. Please review the documents below. By continuing, you confirm you have read and agree to them.",
"agreeLabel": "I have read and agree to the Terms of Use, Privacy Policy, Disclaimer, and License.",
"continue": "Continue",
"mustAgree": "Please check the box to continue.",
"docTerms": "Terms of Use",
"docPrivacy": "Privacy Policy",
"docDisclaimer": "Disclaimer",
"docLicense": "License (Apache-2.0)"
},
"videoTypes": {
"full": "Full Gameplay",
"part": "Gameplay Part",
@@ -790,7 +894,8 @@
"mastodon": "Mastodon",
"facebook": "Facebook",
"fb_page": "Facebook Page",
"fb_group": "Facebook Group"
"fb_group": "Facebook Group",
"telegram": "Telegram"
},
"resolutions": {
"720p": "720p",
@@ -877,6 +982,8 @@
"showSponsorCredit": "Show sponsor credit line in description (thanks for the key)",
"showThirdPartyAds": "Show third-party advertising block in description",
"thirdPartyAdsHint": "Set ad copy in your channel profile (Profiles → Edit).",
"showTranslationQuality": "Show translation-quality notice",
"showTranslationQualityHint": "Adds an AI-translation disclaimer to descriptions generated in languages other than English and Vietnamese.",
"titleFormatTitle": "Title Format",
"descriptionSettingsTitle": "Description",
"badgePosition": "Quality badge position",
@@ -901,6 +1008,25 @@
"logRetentionDays": "Log retention (days)",
"logRetentionHint": "Logs older than this are deleted at app start. Range: 1–90 days."
},
"socialPost": {
"title": "Cross-Post Captions",
"single": "Single",
"bulk": "Bulk",
"copyCaption": "Copy Caption",
"emptyState": "Enter a game name in the Editor to generate captions.",
"trimmedHint": "Trimmed {{count}} optional section(s) to fit the platform limit.",
"overLimitHint": "Over the {{platform}} character limit — trim before posting.",
"exported": "Captions exported!",
"exportFailed": "Export failed",
"imported": "Captions imported",
"importFailed": "Import failed — choose a YTDescGen social export.",
"importedHeading": "Imported captions",
"platforms": {
"tiktok": "TikTok",
"instagram_reels": "Instagram Reels",
"facebook_reels": "Facebook Reels"
}
},
"batch": {
"title": "Batch Mode",
"startPart": "Start Part",
+60 -1
View File
@@ -163,6 +163,16 @@
"custom": "Personalizada"
}
},
"translationQuality": {
"header": "▸ 🌐 SOBRE LA TRADUCCIÓN",
"intro": "Aparte del inglés y el vietnamita, las descripciones de este canal se traducen con ayuda de IA.",
"items": {
"accuracy": "La precisión no está garantizada al 100 %: algunas palabras o términos pueden ser incorrectos.",
"phrasing": "La redacción puede sonar algo literal o rígida en ciertas partes.",
"localStyle": "Es posible que no se ajuste del todo al estilo de escritura local o nativo.",
"corrections": "¿Has visto un error? Se agradece cualquier corrección en los comentarios. 🙏"
}
},
"techNotes": {
"header": "▸ 🛠 NOTAS TÉCNICAS",
"intro": "Notas de producción y estilo de juego para mayor transparencia.",
@@ -206,6 +216,14 @@
"flashing_lights": "Luces parpadeantes — cuidado con la fotosensibilidad",
"motion_sickness": "Mareo por movimiento — cámara / FPS rápidos",
"migraine_trigger": "Posible desencadenante de migraña",
"lens_flare_intense": "Destellos de lente / efectos de brillo solar intensos",
"bloom_excessive": "Bloom excesivo / luces sobreexpuestas",
"particle_effects_dense": "Efectos de partículas densos — explosiones, hechizos, escombros",
"screen_overlay_flashing": "HUD / overlays de UI parpadeantes",
"color_saturation_extreme": "Saturación de color extrema / paleta sobresaturada",
"motion_blur_heavy": "Motion blur intenso (cámara + objetos)",
"depth_of_field_aggressive": "Profundidad de campo agresiva / efectos de focus-pull",
"post_processing_intense": "Post-procesado intenso — aberración cromática, viñeteado, grano",
"loud_noises": "Sonidos fuertes / repentinos",
"ear_piercing": "Sonidos agudos / penetrantes — frecuencias altas",
"jumpscare_audio": "Sustos sonoros — golpes de audio repentinos",
@@ -395,7 +413,48 @@
"mass_casualty_event": "Evento de víctimas masivas (ataque, desastre)",
"vehicular_violence": "Violencia vehicular / embestida intencional",
"overdose_depiction": "Escena de sobredosis",
"defenestration": "Caída desde altura (intencional)"
"defenestration": "Caída desde altura (intencional)",
"profanity_frequent": "Lenguaje soez / vulgar frecuente",
"sexual_innuendo": "Diálogos con insinuaciones sexuales",
"inflammatory_speech": "Diálogos incendiarios / provocadores",
"verbal_abuse": "Abuso verbal / lenguaje denigrante",
"threatening_language": "Lenguaje amenazante / intimidatorio",
"slurs_derogatory": "Insultos / términos despectivos",
"crude_humor": "Humor vulgar / escatológico",
"mature_humor": "Humor adulto",
"dark_humor": "Humor negro / macabro",
"drug_references": "Referencias a drogas / alcohol en diálogos",
"chromophobia": "Escenas de colores intensos (cromofobia)",
"erythrophobia": "Escenas en rojo total (eritrofobia)",
"xanthophobia": "Escenas dominadas por amarillo (xantofobia)",
"leukophobia": "Espacios en blanco total (leucofobia)",
"melanophobia": "Escenas dominadas por negro (melanofobia)",
"body_shaming": "Burlas sobre el aspecto físico (body shaming)",
"beauty_standards": "Estándares de belleza irreales",
"cyberbullying": "Ciberacoso / acoso en línea",
"doxxing": "Doxxing / exposición de datos personales",
"trolling_griefing": "Trolleo / griefing",
"cancel_culture": "Cultura de la cancelación / escarnio público",
"social_media_addiction": "Adicción a las redes sociales",
"doomscrolling": "Doomscrolling",
"fomo": "FOMO — miedo a perderse algo",
"fake_news": "Noticias falsas / desinformación",
"online_scams": "Estafas en línea / phishing",
"catfishing": "Catfishing / identidad falsa en línea",
"deepfake_themes": "Deepfakes / medios sintéticos",
"cyberstalking": "Ciberacecho",
"internet_challenges": "Retos virales peligrosos",
"influencer_culture": "Cultura influencer / búsqueda de fama",
"online_radicalization": "Radicalización en línea / cámaras de eco",
"loot_boxes": "Cajas de botín / mecánicas gacha",
"ai_themes": "Temas de IA / inteligencia artificial",
"data_privacy": "Privacidad de datos / vigilancia masiva",
"revealing_outfits": "Atuendos reveladores",
"partial_nudity": "Desnudez parcial",
"sexualized_characters": "Diseños de personajes sexualizados",
"fanservice": "Fan service / contenido ecchi",
"suggestive_poses": "Poses / ángulos de cámara sugerentes",
"educational_purpose_only": "Juego con fines educativos / divulgativos"
}
},
"graphics": {
+129 -3
View File
@@ -10,6 +10,7 @@
"history": "Historial",
"settings": "Ajustes",
"batch": "Lote",
"social": "Redes",
"playlist": "Playlist",
"logs": "Registros",
"about": "Acerca de",
@@ -20,7 +21,8 @@
"collapse": "Colapsar barra lateral"
},
"header": {
"donate": "Donar"
"donate": "Donar",
"toggleTheme": "Cambiar tema"
},
"about": {
"tagline": "Generador de título, descripción y etiquetas de YouTube para canales de Gameplay sin comentarios.",
@@ -33,6 +35,7 @@
"licenseLabel": "Licencia",
"donateHeading": "Donar / Apoyar",
"donateHelp": "Si YTDescGen te ahorra tiempo, considera invitarme un café. Cada aporte ayuda al proyecto.",
"legalHeading": "Legal",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
@@ -131,6 +134,7 @@
"os_name": "SO",
"os_version": "Versión",
"os_edition": "Edición",
"os_distro": "Distro",
"vnDonate": "Donate (Vietnam)",
"vnDonateHelp": "Only rendered into the description when output language is Vietnamese.",
"vnBankName": "Bank name",
@@ -321,9 +325,11 @@
"spoilers": "Spoilers",
"photosensitive": "Fotosensibilidad / Salud",
"audio": "Audio / Sensorial",
"dialogue": "Diálogo / Lenguaje",
"phobias": "Fobias",
"mental_health": "Salud mental",
"social_phenomena": "Fenómenos sociales",
"internet_digital": "Internet / Vida digital",
"sensitive": "Adulto / Sensible",
"playstyle": "Notas de juego",
"horror_specific": "Horror intenso",
@@ -339,6 +345,14 @@
"flashing_lights": "Luces parpadeantes",
"motion_sickness": "Mareo por movimiento",
"migraine_trigger": "Posible migraña",
"lens_flare_intense": "Destello de lente / sol",
"bloom_excessive": "Bloom excesivo / sobreexposición",
"particle_effects_dense": "Partículas densas",
"screen_overlay_flashing": "HUD / overlays parpadeantes",
"color_saturation_extreme": "Saturación extrema",
"motion_blur_heavy": "Motion blur intenso",
"depth_of_field_aggressive": "Profundidad de campo agresiva",
"post_processing_intense": "Post-procesado intenso",
"loud_noises": "Sonidos repentinos",
"ear_piercing": "Sonidos agudos / penetrantes",
"jumpscare_audio": "Sustos sonoros",
@@ -528,7 +542,48 @@
"mass_casualty_event": "Víctimas masivas",
"vehicular_violence": "Violencia vehicular",
"overdose_depiction": "Escena de sobredosis",
"defenestration": "Caída desde altura"
"defenestration": "Caída desde altura",
"profanity_frequent": "Lenguaje soez frecuente",
"sexual_innuendo": "Insinuaciones sexuales en diálogos",
"inflammatory_speech": "Diálogos incendiarios",
"verbal_abuse": "Abuso verbal",
"threatening_language": "Lenguaje amenazante",
"slurs_derogatory": "Insultos / términos despectivos",
"crude_humor": "Humor vulgar",
"mature_humor": "Humor adulto",
"dark_humor": "Humor negro",
"drug_references": "Referencias a drogas / alcohol",
"chromophobia": "Colores intensos",
"erythrophobia": "Rojo / escenas en rojo",
"xanthophobia": "Color amarillo",
"leukophobia": "Blanco / espacios en blanco",
"melanophobia": "Color negro",
"body_shaming": "Burlas del aspecto físico",
"beauty_standards": "Estándares de belleza irreales",
"cyberbullying": "Ciberacoso",
"doxxing": "Doxxing / exposición de datos",
"trolling_griefing": "Trolleo / griefing",
"cancel_culture": "Cultura de la cancelación",
"social_media_addiction": "Adicción a redes sociales",
"doomscrolling": "Doomscrolling",
"fomo": "FOMO (miedo a perderse algo)",
"fake_news": "Noticias falsas / desinformación",
"online_scams": "Estafas en línea / phishing",
"catfishing": "Catfishing / identidad falsa",
"deepfake_themes": "Deepfakes / medios sintéticos",
"cyberstalking": "Ciberacecho",
"internet_challenges": "Retos virales peligrosos",
"influencer_culture": "Cultura influencer",
"online_radicalization": "Radicalización en línea",
"loot_boxes": "Cajas de botín / gacha",
"ai_themes": "Temas de IA",
"data_privacy": "Privacidad de datos / vigilancia",
"revealing_outfits": "Atuendos reveladores",
"partial_nudity": "Desnudez parcial",
"sexualized_characters": "Personajes sexualizados",
"fanservice": "Fan service / ecchi",
"suggestive_poses": "Poses / ángulos sugerentes",
"educational_purpose_only": "Fines educativos / divulgativos"
},
"playthroughNotes": {
"title": "Notas de la partida",
@@ -695,6 +750,55 @@
"dismiss": "Descartar",
"scrollToTop": "Volver arriba"
},
"errorPages": {
"actions": {
"home": "Ir al inicio",
"back": "Volver",
"retry": "Reintentar",
"reload": "Recargar página",
"reportBug": "Informar de un error"
},
"offlineBanner": {
"message": "Estás sin conexión. La aplicación sigue funcionando — tus datos se guardan localmente.",
"details": "Detalles",
"backOnline": "De nuevo en línea"
},
"notFound": {
"title": "Página no encontrada",
"description": "La página que buscas no existe o se ha movido. Comprueba la dirección o vuelve al editor."
},
"forbidden": {
"title": "Acceso denegado",
"description": "No tienes permiso para ver esta página. Si crees que es un error, infórmalo."
},
"expired": {
"title": "Sesión expirada",
"description": "Esta página ya no es válida porque tu sesión ha expirado. Recarga para empezar de nuevo."
},
"serverError": {
"title": "Algo salió mal",
"description": "Se produjo un error inesperado al cargar esta página. Intenta recargar e informa del error si persiste."
},
"offline": {
"title": "Estás sin conexión",
"description": "No hay conexión de red ahora mismo. YTDescGen funciona completamente sin conexión — tus perfiles, historial y textos generados se guardan localmente."
},
"runtime": {
"title": "Algo salió mal",
"description": "La aplicación detectó un error de renderizado antes de que la página fallara. Tus datos están a salvo — el error se registró en la pestaña Registros."
}
},
"consentGate": {
"title": "Antes de empezar",
"intro": "YTDescGen es una herramienta gratuita y con prioridad sin conexión. Revisa los documentos siguientes. Al continuar, confirmas que los has leído y los aceptas.",
"agreeLabel": "He leído y acepto los Términos de Uso, la Política de Privacidad, el Aviso Legal y la Licencia.",
"continue": "Continuar",
"mustAgree": "Marca la casilla para continuar.",
"docTerms": "Términos de Uso",
"docPrivacy": "Política de Privacidad",
"docDisclaimer": "Aviso Legal",
"docLicense": "Licencia (Apache-2.0)"
},
"videoTypes": {
"full": "Gameplay Completo",
"part": "Gameplay Parte",
@@ -790,7 +894,8 @@
"mastodon": "Mastodon",
"facebook": "Facebook",
"fb_page": "Página de Facebook",
"fb_group": "Grupo de Facebook"
"fb_group": "Grupo de Facebook",
"telegram": "Telegram"
},
"resolutions": {
"720p": "720p",
@@ -877,6 +982,8 @@
"showSponsorCredit": "Mostrar línea de agradecimiento al patrocinador (clave) en la descripción",
"showThirdPartyAds": "Mostrar bloque de anuncios de terceros en la descripción",
"thirdPartyAdsHint": "Configura el texto publicitario en el perfil del canal (Perfiles → Editar).",
"showTranslationQuality": "Mostrar aviso de calidad de traducción",
"showTranslationQualityHint": "Añade un aviso de traducción por IA a las descripciones generadas en idiomas distintos del inglés y el vietnamita.",
"titleFormatTitle": "Formato del título",
"descriptionSettingsTitle": "Descripción",
"badgePosition": "Posición de la insignia de calidad",
@@ -901,6 +1008,25 @@
"logRetentionDays": "Retención de logs (días)",
"logRetentionHint": "Los logs más antiguos se eliminan al iniciar. Rango: 1–90 días."
},
"socialPost": {
"title": "Publicaciones multiplataforma",
"single": "Individual",
"bulk": "Por lote",
"copyCaption": "Copiar texto",
"emptyState": "Escribe el nombre de un juego en el Editor para generar los textos.",
"trimmedHint": "Se recortaron {{count}} sección(es) opcional(es) para ajustarse al límite.",
"overLimitHint": "Supera el límite de caracteres de {{platform}}: recórtalo antes de publicar.",
"exported": "¡Textos exportados!",
"exportFailed": "Error al exportar",
"imported": "Textos importados",
"importFailed": "Error al importar: elige una exportación Social de YTDescGen.",
"importedHeading": "Textos importados",
"platforms": {
"tiktok": "TikTok",
"instagram_reels": "Instagram Reels",
"facebook_reels": "Facebook Reels"
}
},
"batch": {
"title": "Generación por Lote",
"startPart": "Parte Inicial",
+60 -1
View File
@@ -163,6 +163,16 @@
"custom": "カスタム"
}
},
"translationQuality": {
"header": "▸ 🌐 翻訳について",
"intro": "英語とベトナム語以外の説明は、AIの支援を受けて翻訳されています。",
"items": {
"accuracy": "正確性は100%保証されません。一部の語句や用語が誤っている場合があります。",
"phrasing": "表現が直訳的・不自然になっていることがあります。",
"localStyle": "現地の自然な表現と完全には一致しない場合があります。",
"corrections": "間違いを見つけたら、コメントで教えていただけると助かります。🙏"
}
},
"techNotes": {
"header": "▸ 🛠 技術メモ",
"intro": "制作およびプレイスタイルに関する透明性メモ。",
@@ -206,6 +216,14 @@
"flashing_lights": "光の点滅 — 光感受性のある方はご注意",
"motion_sickness": "3D酔い — カメラ / FPSの激しい動き",
"migraine_trigger": "片頭痛を誘発する可能性",
"lens_flare_intense": "強烈なレンズフレア / 太陽光のグレア",
"bloom_excessive": "過剰なブルーム / 白飛びハイライト",
"particle_effects_dense": "高密度のパーティクル — 爆発、魔法、デブリ",
"screen_overlay_flashing": "点滅するHUD / UIオーバーレイ",
"color_saturation_extreme": "極端な彩度 / 派手な配色",
"motion_blur_heavy": "強いモーションブラー(カメラ + オブジェクト)",
"depth_of_field_aggressive": "強い被写界深度 / フォーカスプル演出",
"post_processing_intense": "強いポストプロセス — 色収差、ビネット、フィルムグレイン",
"loud_noises": "大音量 / 突発的な音",
"ear_piercing": "耳に刺さる音 / 高周波音",
"jumpscare_audio": "音声ジャンプスケア — 突然の大音量",
@@ -395,7 +413,48 @@
"mass_casualty_event": "大量死傷事件(襲撃・災害)",
"vehicular_violence": "車両による暴力 / 故意の衝突",
"overdose_depiction": "薬物過剰摂取シーン",
"defenestration": "高所からの転落(意図的)"
"defenestration": "高所からの転落(意図的)",
"profanity_frequent": "頻繁な暴言・汚い言葉遣い",
"sexual_innuendo": "性的なほのめかしを含むセリフ",
"inflammatory_speech": "扇動的・挑発的なセリフ",
"verbal_abuse": "言葉による侮辱・暴言",
"threatening_language": "脅迫的・威圧的な言葉",
"slurs_derogatory": "差別用語・蔑称",
"crude_humor": "下品なユーモア",
"mature_humor": "大人向けユーモア",
"dark_humor": "ブラックユーモア",
"drug_references": "セリフ内の薬物・飲酒への言及",
"chromophobia": "鮮やかな色彩の場面(色彩恐怖症)",
"erythrophobia": "真っ赤な場面(赤色恐怖症)",
"xanthophobia": "黄色が目立つ場面(黄色恐怖症)",
"leukophobia": "真っ白な空間(白色恐怖症)",
"melanophobia": "黒一色の場面(黒色恐怖症)",
"body_shaming": "外見への侮辱(ボディシェイミング)",
"beauty_standards": "非現実的な美の基準",
"cyberbullying": "ネットいじめ・誹謗中傷",
"doxxing": "晒し行為・個人情報の暴露",
"trolling_griefing": "荒らし・グリーフィング行為",
"cancel_culture": "キャンセルカルチャー・公開非難",
"social_media_addiction": "SNS依存",
"doomscrolling": "ドゥームスクローリング",
"fomo": "FOMO — 取り残される不安",
"fake_news": "フェイクニュース・誤情報",
"online_scams": "ネット詐欺・フィッシング",
"catfishing": "ネット上のなりすまし(キャットフィッシング)",
"deepfake_themes": "ディープフェイク・合成メディア",
"cyberstalking": "ネットストーキング",
"internet_challenges": "危険なバイラルチャレンジ",
"influencer_culture": "インフルエンサー文化・注目集め",
"online_radicalization": "ネット上の過激化・エコーチェンバー",
"loot_boxes": "ルートボックス・ガチャ要素",
"ai_themes": "AI・人工知能のテーマ",
"data_privacy": "データプライバシー・大規模監視",
"revealing_outfits": "露出度の高い衣装",
"partial_nudity": "部分的なヌード",
"sexualized_characters": "性的に強調されたキャラクターデザイン",
"fanservice": "ファンサービス・お色気要素",
"suggestive_poses": "挑発的なポーズ・カメラアングル",
"educational_purpose_only": "教育・啓発目的のゲーム"
}
},
"graphics": {
+129 -3
View File
@@ -10,6 +10,7 @@
"history": "履歴",
"settings": "設定",
"batch": "一括",
"social": "ソーシャル",
"playlist": "プレイリスト",
"logs": "ログ",
"about": "情報",
@@ -20,7 +21,8 @@
"collapse": "サイドバーを折りたたむ"
},
"header": {
"donate": "寄付"
"donate": "寄付",
"toggleTheme": "テーマ切り替え"
},
"about": {
"tagline": "ゲームプレイ実況なしチャンネル向けのタイトル・説明文・タグ生成ツール。",
@@ -33,6 +35,7 @@
"licenseLabel": "ライセンス",
"donateHeading": "寄付 / サポート",
"donateHelp": "YTDescGenが時短に役立ったら、コーヒー一杯分でも支援していただけると嬉しいです。",
"legalHeading": "法的事項",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
@@ -131,6 +134,7 @@
"os_name": "OS",
"os_version": "バージョン",
"os_edition": "エディション",
"os_distro": "ディストリ",
"vnDonate": "Donate (Vietnam)",
"vnDonateHelp": "Only rendered into the description when output language is Vietnamese.",
"vnBankName": "Bank name",
@@ -321,9 +325,11 @@
"spoilers": "ネタバレ",
"photosensitive": "光感受性 / 健康",
"audio": "音声 / 感覚",
"dialogue": "セリフ / 言葉遣い",
"phobias": "恐怖症",
"mental_health": "メンタルヘルス",
"social_phenomena": "社会・心理現象",
"internet_digital": "インターネット / デジタルライフ",
"sensitive": "成人向け / センシティブ",
"playstyle": "プレイ情報",
"horror_specific": "ヘビーホラー",
@@ -339,6 +345,14 @@
"flashing_lights": "光の点滅",
"motion_sickness": "3D酔い",
"migraine_trigger": "片頭痛トリガー",
"lens_flare_intense": "レンズフレア / 強い光彩",
"bloom_excessive": "過剰なブルーム / 白飛び",
"particle_effects_dense": "高密度のパーティクル",
"screen_overlay_flashing": "点滅するHUD / UIオーバーレイ",
"color_saturation_extreme": "極端な彩度 / 派手な配色",
"motion_blur_heavy": "強いモーションブラー",
"depth_of_field_aggressive": "強い被写界深度",
"post_processing_intense": "強いポストプロセス",
"loud_noises": "突発的な音",
"ear_piercing": "耳に刺さる / 高周波音",
"jumpscare_audio": "音声ジャンプスケア",
@@ -528,7 +542,48 @@
"mass_casualty_event": "大量死傷事件",
"vehicular_violence": "車両による暴力",
"overdose_depiction": "薬物過剰摂取シーン",
"defenestration": "高所からの転落"
"defenestration": "高所からの転落",
"profanity_frequent": "頻繁な暴言・汚い言葉",
"sexual_innuendo": "性的なほのめかしのセリフ",
"inflammatory_speech": "扇動的なセリフ",
"verbal_abuse": "言葉による侮辱",
"threatening_language": "脅迫的な言葉",
"slurs_derogatory": "差別用語・蔑称",
"crude_humor": "下品なユーモア",
"mature_humor": "大人向けユーモア",
"dark_humor": "ブラックユーモア",
"drug_references": "薬物・飲酒への言及",
"chromophobia": "鮮やかな色彩",
"erythrophobia": "赤色 / 真っ赤な場面",
"xanthophobia": "黄色",
"leukophobia": "白色 / 真っ白な空間",
"melanophobia": "黒色",
"body_shaming": "ボディシェイミング(外見への侮辱)",
"beauty_standards": "非現実的な美の基準",
"cyberbullying": "ネットいじめ・誹謗中傷",
"doxxing": "晒し行為(個人情報暴露)",
"trolling_griefing": "荒らし・グリーフィング",
"cancel_culture": "キャンセルカルチャー",
"social_media_addiction": "SNS依存",
"doomscrolling": "ドゥームスクローリング",
"fomo": "FOMO(取り残される不安)",
"fake_news": "フェイクニュース・誤情報",
"online_scams": "ネット詐欺・フィッシング",
"catfishing": "なりすまし(キャットフィッシング)",
"deepfake_themes": "ディープフェイク・合成メディア",
"cyberstalking": "ネットストーキング",
"internet_challenges": "危険なバイラルチャレンジ",
"influencer_culture": "インフルエンサー文化",
"online_radicalization": "ネット上の過激化・エコーチェンバー",
"loot_boxes": "ルートボックス・ガチャ要素",
"ai_themes": "AI・人工知能テーマ",
"data_privacy": "データプライバシー・大規模監視",
"revealing_outfits": "露出度の高い衣装",
"partial_nudity": "部分的なヌード",
"sexualized_characters": "性的に強調されたキャラデザイン",
"fanservice": "ファンサービス・お色気",
"suggestive_poses": "挑発的なポーズ・アングル",
"educational_purpose_only": "教育・啓発目的のゲーム"
},
"playthroughNotes": {
"title": "プレイ情報",
@@ -695,6 +750,55 @@
"dismiss": "閉じる",
"scrollToTop": "トップへ戻る"
},
"errorPages": {
"actions": {
"home": "ホームへ",
"back": "戻る",
"retry": "再試行",
"reload": "ページを再読み込み",
"reportBug": "バグを報告"
},
"offlineBanner": {
"message": "オフラインです。アプリは引き続き使用できます — データはローカルに保存されています。",
"details": "詳細",
"backOnline": "オンラインに復帰しました"
},
"notFound": {
"title": "ページが見つかりません",
"description": "お探しのページは存在しないか、移動されました。アドレスを確認するか、エディターに戻ってください。"
},
"forbidden": {
"title": "アクセスが拒否されました",
"description": "このページを表示する権限がありません。誤りだと思われる場合は報告してください。"
},
"expired": {
"title": "セッションの有効期限が切れました",
"description": "セッションの有効期限が切れたため、このページは無効です。再読み込みしてやり直してください。"
},
"serverError": {
"title": "問題が発生しました",
"description": "ページの読み込み中に予期しないエラーが発生しました。再読み込みし、問題が続く場合は報告してください。"
},
"offline": {
"title": "オフラインです",
"description": "現在ネットワーク接続がありません。YTDescGen は完全にオフラインで動作します — プロフィール、履歴、生成したテキストはすべてローカルに保存されています。"
},
"runtime": {
"title": "問題が発生しました",
"description": "ページがクラッシュする前にレンダリングエラーを検出しました。データは安全です — エラーはログタブに記録されました。"
}
},
"consentGate": {
"title": "始める前に",
"intro": "YTDescGen は無料・オフライン優先のツールです。下記の文書をご確認ください。続行すると、これらを読み同意したことになります。",
"agreeLabel": "利用規約、プライバシーポリシー、免責事項、およびライセンスを読み、同意します。",
"continue": "続行",
"mustAgree": "続行するにはチェックを入れてください。",
"docTerms": "利用規約",
"docPrivacy": "プライバシーポリシー",
"docDisclaimer": "免責事項",
"docLicense": "ライセンス (Apache-2.0)"
},
"videoTypes": {
"full": "フルゲームプレイ",
"part": "ゲームプレイ パート",
@@ -790,7 +894,8 @@
"mastodon": "Mastodon",
"facebook": "Facebook",
"fb_page": "Facebookページ",
"fb_group": "Facebookグループ"
"fb_group": "Facebookグループ",
"telegram": "Telegram"
},
"resolutions": {
"720p": "720p",
@@ -877,6 +982,8 @@
"showSponsorCredit": "説明欄にスポンサーへの感謝行を追加 (キー提供)",
"showThirdPartyAds": "説明欄にサードパーティ広告ブロックを表示",
"thirdPartyAdsHint": "広告コピーはチャンネルプロフィールに設定してください (プロフィール → 編集)。",
"showTranslationQuality": "翻訳品質の注記を表示",
"showTranslationQualityHint": "英語とベトナム語以外の言語で生成した説明にAI翻訳の注記を追加します。",
"titleFormatTitle": "タイトル書式",
"descriptionSettingsTitle": "説明欄",
"badgePosition": "品質バッジの位置",
@@ -901,6 +1008,25 @@
"logRetentionDays": "ログ保持期間 (日)",
"logRetentionHint": "この日数より古いログは起動時に削除されます。範囲: 1–90 日。"
},
"socialPost": {
"title": "クロス投稿キャプション",
"single": "単一",
"bulk": "一括",
"copyCaption": "キャプションをコピー",
"emptyState": "エディターでゲーム名を入力するとキャプションを生成します。",
"trimmedHint": "プラットフォームの上限に合わせて任意セクションを{{count}}個削除しました。",
"overLimitHint": "{{platform}}の文字数上限を超えています。投稿前に短くしてください。",
"exported": "キャプションをエクスポートしました!",
"exportFailed": "エクスポートに失敗しました",
"imported": "キャプションをインポートしました",
"importFailed": "インポートに失敗しました。YTDescGenのSocialエクスポートを選択してください。",
"importedHeading": "インポートしたキャプション",
"platforms": {
"tiktok": "TikTok",
"instagram_reels": "Instagram Reels",
"facebook_reels": "Facebook Reels"
}
},
"batch": {
"title": "一括モード",
"startPart": "開始パート",
+60 -1
View File
@@ -163,6 +163,16 @@
"custom": "사용자 지정"
}
},
"translationQuality": {
"header": "▸ 🌐 번역 안내",
"intro": "영어와 베트남어 외의 설명은 AI의 도움을 받아 번역되었습니다.",
"items": {
"accuracy": "정확도가 100% 보장되지 않으며 일부 단어나 용어가 틀릴 수 있습니다.",
"phrasing": "표현이 다소 직역체이거나 어색할 수 있습니다.",
"localStyle": "현지의 자연스러운 문체와 완전히 일치하지 않을 수 있습니다.",
"corrections": "오류를 발견하면 댓글로 알려 주시면 감사하겠습니다. 🙏"
}
},
"techNotes": {
"header": "▸ 🛠 기술 노트",
"intro": "투명성을 위한 제작 및 플레이 스타일 노트.",
@@ -206,6 +216,14 @@
"flashing_lights": "점멸 효과 — 광과민성 시청자 주의",
"motion_sickness": "멀미 — 빠른 카메라 / FPS 움직임",
"migraine_trigger": "편두통 유발 가능",
"lens_flare_intense": "강한 렌즈 플레어 / 햇빛 글레어 효과",
"bloom_excessive": "과도한 블룸 / 하이라이트 번짐",
"particle_effects_dense": "고밀도 파티클 — 폭발, 마법, 파편",
"screen_overlay_flashing": "깜빡이는 HUD / UI 오버레이",
"color_saturation_extreme": "극단적 채도 / 과포화 팔레트",
"motion_blur_heavy": "강한 모션 블러 (카메라 + 오브젝트)",
"depth_of_field_aggressive": "강한 피사계 심도 / 포커스 풀 효과",
"post_processing_intense": "강한 포스트 프로세싱 — 색수차, 비네트, 필름 그레인",
"loud_noises": "큰 소리 / 갑작스러운 음량",
"ear_piercing": "귀를 찌르는 고주파 / 고음",
"jumpscare_audio": "사운드 점프스케어 — 갑작스러운 큰 음향",
@@ -395,7 +413,48 @@
"mass_casualty_event": "대규모 인명피해 사건 (공격·재난)",
"vehicular_violence": "차량을 이용한 폭력 / 고의적 충돌",
"overdose_depiction": "약물 과다 복용 장면",
"defenestration": "고의적 추락 / 투신"
"defenestration": "고의적 추락 / 투신",
"profanity_frequent": "잦은 욕설 / 거친 언어",
"sexual_innuendo": "성적 암시가 담긴 대사",
"inflammatory_speech": "선동적 / 도발적인 대사",
"verbal_abuse": "언어폭력 / 모욕적 발언",
"threatening_language": "위협적 / 협박성 언사",
"slurs_derogatory": "비하 / 멸칭 표현",
"crude_humor": "저속한 유머",
"mature_humor": "성인 유머",
"dark_humor": "블랙 유머",
"drug_references": "대사 중 약물 / 음주 언급",
"chromophobia": "강렬한 색채 장면 (색채 공포증)",
"erythrophobia": "온통 붉은 장면 (빨간색 공포증)",
"xanthophobia": "노란색 위주 장면 (노란색 공포증)",
"leukophobia": "온통 하얀 공간 (흰색 공포증)",
"melanophobia": "온통 검은 장면 (검은색 공포증)",
"body_shaming": "외모 비하 (바디 셰이밍)",
"beauty_standards": "비현실적인 미의 기준",
"cyberbullying": "사이버 폭력 / 온라인 괴롭힘",
"doxxing": "신상 털기 / 개인정보 노출",
"trolling_griefing": "트롤링 / 고의적 방해 행위",
"cancel_culture": "캔슬 컬처 / 공개 비난",
"social_media_addiction": "SNS 중독",
"doomscrolling": "둠스크롤링",
"fomo": "FOMO — 소외에 대한 불안",
"fake_news": "가짜 뉴스 / 허위 정보",
"online_scams": "온라인 사기 / 피싱",
"catfishing": "온라인 신분 위장 (캣피싱)",
"deepfake_themes": "딥페이크 / 합성 미디어",
"cyberstalking": "사이버 스토킹",
"internet_challenges": "위험한 바이럴 챌린지",
"influencer_culture": "인플루언서 문화 / 관심 끌기",
"online_radicalization": "온라인 급진화 / 에코 체임버",
"loot_boxes": "확률형 아이템 / 가챠 요소",
"ai_themes": "AI / 인공지능 테마",
"data_privacy": "데이터 프라이버시 / 대규모 감시",
"revealing_outfits": "노출이 심한 의상",
"partial_nudity": "부분 노출",
"sexualized_characters": "성적으로 강조된 캐릭터 디자인",
"fanservice": "팬서비스 / 에치 요소",
"suggestive_poses": "선정적인 포즈 / 카메라 구도",
"educational_purpose_only": "교육 / 공익 목적 게임"
}
},
"graphics": {
+129 -3
View File
@@ -10,6 +10,7 @@
"history": "기록",
"settings": "설정",
"batch": "일괄",
"social": "소셜",
"playlist": "플레이리스트",
"logs": "로그",
"about": "정보",
@@ -20,7 +21,8 @@
"collapse": "사이드바 접기"
},
"header": {
"donate": "후원"
"donate": "후원",
"toggleTheme": "테마 전환"
},
"about": {
"tagline": "게임플레이 무편집 채널을 위한 YouTube 제목, 설명, 태그 생성기.",
@@ -33,6 +35,7 @@
"licenseLabel": "라이선스",
"donateHeading": "후원 / 지원",
"donateHelp": "YTDescGen이 시간을 아껴드렸다면 커피 한 잔으로 응원 부탁드립니다.",
"legalHeading": "법적 고지",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
@@ -131,6 +134,7 @@
"os_name": "OS",
"os_version": "버전",
"os_edition": "에디션",
"os_distro": "배포판",
"vnDonate": "Donate (Vietnam)",
"vnDonateHelp": "Only rendered into the description when output language is Vietnamese.",
"vnBankName": "Bank name",
@@ -321,9 +325,11 @@
"spoilers": "스포일러",
"photosensitive": "광과민 / 건강",
"audio": "음향 / 청각",
"dialogue": "대사 / 언어",
"phobias": "공포증",
"mental_health": "정신 건강",
"social_phenomena": "사회·심리 현상",
"internet_digital": "인터넷 / 디지털 라이프",
"sensitive": "성인 / 민감",
"playstyle": "플레이 안내",
"horror_specific": "중증 호러",
@@ -339,6 +345,14 @@
"flashing_lights": "점멸 효과",
"motion_sickness": "멀미",
"migraine_trigger": "편두통 유발",
"lens_flare_intense": "렌즈 플레어 / 햇빛 글레어",
"bloom_excessive": "과도한 블룸 / 하이라이트 번짐",
"particle_effects_dense": "고밀도 파티클",
"screen_overlay_flashing": "깜빡이는 HUD / UI 오버레이",
"color_saturation_extreme": "극단적인 채도 / 과포화 팔레트",
"motion_blur_heavy": "강한 모션 블러",
"depth_of_field_aggressive": "강한 피사계 심도",
"post_processing_intense": "강한 포스트 프로세싱",
"loud_noises": "갑작스러운 큰 소리",
"ear_piercing": "귀를 찌르는 고음",
"jumpscare_audio": "사운드 점프스케어",
@@ -528,7 +542,48 @@
"mass_casualty_event": "대규모 인명피해",
"vehicular_violence": "차량을 이용한 폭력",
"overdose_depiction": "약물 과다 복용 장면",
"defenestration": "추락 / 투신"
"defenestration": "추락 / 투신",
"profanity_frequent": "잦은 욕설 / 거친 언어",
"sexual_innuendo": "성적 암시 대사",
"inflammatory_speech": "선동적인 대사",
"verbal_abuse": "언어폭력 / 모욕",
"threatening_language": "위협적인 언사",
"slurs_derogatory": "비하 / 멸칭 표현",
"crude_humor": "저속한 유머",
"mature_humor": "성인 유머",
"dark_humor": "블랙 유머",
"drug_references": "약물 / 음주 언급",
"chromophobia": "색채 공포",
"erythrophobia": "빨간색 / 온통 붉은 장면",
"xanthophobia": "노란색",
"leukophobia": "흰색 / 온통 하얀 공간",
"melanophobia": "검은색",
"body_shaming": "외모 비하 (바디 셰이밍)",
"beauty_standards": "비현실적인 미의 기준",
"cyberbullying": "사이버 폭력 / 온라인 괴롭힘",
"doxxing": "신상 털기 (doxxing)",
"trolling_griefing": "트롤링 / 고의적 방해",
"cancel_culture": "캔슬 컬처 / 공개 비난",
"social_media_addiction": "SNS 중독",
"doomscrolling": "둠스크롤링",
"fomo": "FOMO (소외 불안)",
"fake_news": "가짜 뉴스 / 허위 정보",
"online_scams": "온라인 사기 / 피싱",
"catfishing": "신분 위장 (캣피싱)",
"deepfake_themes": "딥페이크 / 합성 미디어",
"cyberstalking": "사이버 스토킹",
"internet_challenges": "위험한 바이럴 챌린지",
"influencer_culture": "인플루언서 문화",
"online_radicalization": "온라인 급진화 / 에코 체임버",
"loot_boxes": "확률형 아이템 / 가챠",
"ai_themes": "AI / 인공지능 테마",
"data_privacy": "데이터 프라이버시 / 감시",
"revealing_outfits": "노출이 심한 의상",
"partial_nudity": "부분 노출",
"sexualized_characters": "성적으로 강조된 캐릭터 디자인",
"fanservice": "팬서비스 / 에치 요소",
"suggestive_poses": "선정적인 포즈 / 구도",
"educational_purpose_only": "교육 / 공익 목적 게임"
},
"playthroughNotes": {
"title": "플레이 노트",
@@ -695,6 +750,55 @@
"dismiss": "닫기",
"scrollToTop": "맨 위로"
},
"errorPages": {
"actions": {
"home": "홈으로",
"back": "뒤로 가기",
"retry": "다시 시도",
"reload": "페이지 새로고침",
"reportBug": "버그 신고"
},
"offlineBanner": {
"message": "오프라인 상태입니다. 앱은 계속 작동합니다 — 데이터는 로컬에 저장됩니다.",
"details": "자세히",
"backOnline": "다시 온라인 상태입니다"
},
"notFound": {
"title": "페이지를 찾을 수 없습니다",
"description": "찾으시는 페이지가 없거나 이동되었습니다. 주소를 확인하거나 편집기로 돌아가세요."
},
"forbidden": {
"title": "접근이 거부되었습니다",
"description": "이 페이지를 볼 권한이 없습니다. 잘못된 것 같으면 신고해 주세요."
},
"expired": {
"title": "세션이 만료되었습니다",
"description": "세션이 만료되어 이 페이지가 더 이상 유효하지 않습니다. 새로고침하여 다시 시작하세요."
},
"serverError": {
"title": "문제가 발생했습니다",
"description": "이 페이지를 불러오는 중 예기치 않은 오류가 발생했습니다. 새로고침해 보고 문제가 계속되면 신고해 주세요."
},
"offline": {
"title": "오프라인 상태입니다",
"description": "현재 네트워크 연결이 없습니다. YTDescGen은 완전히 오프라인으로 작동합니다 — 프로필, 기록, 생성된 텍스트가 모두 로컬에 저장됩니다."
},
"runtime": {
"title": "문제가 발생했습니다",
"description": "페이지가 충돌하기 전에 앱이 렌더링 오류를 잡아냈습니다. 데이터는 안전합니다 — 오류는 로그 탭에 기록되었습니다."
}
},
"consentGate": {
"title": "시작하기 전에",
"intro": "YTDescGen은 무료이며 오프라인을 우선하는 도구입니다. 아래 문서를 검토해 주세요. 계속하면 문서를 읽고 동의한 것으로 간주됩니다.",
"agreeLabel": "이용약관, 개인정보 처리방침, 면책 조항 및 라이선스를 읽고 동의합니다.",
"continue": "계속",
"mustAgree": "계속하려면 체크박스를 선택하세요.",
"docTerms": "이용약관",
"docPrivacy": "개인정보 처리방침",
"docDisclaimer": "면책 조항",
"docLicense": "라이선스 (Apache-2.0)"
},
"videoTypes": {
"full": "전체 게임플레이",
"part": "게임플레이 파트",
@@ -790,7 +894,8 @@
"mastodon": "Mastodon",
"facebook": "Facebook",
"fb_page": "Facebook 페이지",
"fb_group": "Facebook 그룹"
"fb_group": "Facebook 그룹",
"telegram": "Telegram"
},
"resolutions": {
"720p": "720p",
@@ -877,6 +982,8 @@
"showSponsorCredit": "설명란에 스폰서 감사 문구 추가 (키 제공)",
"showThirdPartyAds": "설명란에 써드파티 광고 블록 표시",
"thirdPartyAdsHint": "광고 문구는 채널 프로필에 입력하세요 (프로필 → 편집).",
"showTranslationQuality": "번역 품질 안내 표시",
"showTranslationQualityHint": "영어와 베트남어 외의 언어로 생성된 설명에 AI 번역 안내를 추가합니다.",
"titleFormatTitle": "제목 형식",
"descriptionSettingsTitle": "설명",
"badgePosition": "품질 배지 위치",
@@ -901,6 +1008,25 @@
"logRetentionDays": "로그 보관 기간 (일)",
"logRetentionHint": "이 일수보다 오래된 로그는 앱 시작 시 삭제됩니다. 범위: 1–90일."
},
"socialPost": {
"title": "크로스포스트 캡션",
"single": "단일",
"bulk": "일괄",
"copyCaption": "캡션 복사",
"emptyState": "에디터에서 게임 이름을 입력하면 캡션이 생성됩니다.",
"trimmedHint": "플랫폼 제한에 맞추기 위해 선택 항목 {{count}}개를 줄였습니다.",
"overLimitHint": "{{platform}} 글자 수 제한을 초과했습니다. 게시 전에 줄이세요.",
"exported": "캡션을 내보냈습니다!",
"exportFailed": "내보내기 실패",
"imported": "캡션을 가져왔습니다",
"importFailed": "가져오기 실패 — YTDescGen Social 내보내기 파일을 선택하세요.",
"importedHeading": "가져온 캡션",
"platforms": {
"tiktok": "TikTok",
"instagram_reels": "Instagram Reels",
"facebook_reels": "Facebook Reels"
}
},
"batch": {
"title": "일괄 생성",
"startPart": "시작 파트",
+60 -1
View File
@@ -163,6 +163,16 @@
"custom": "Tùy chỉnh"
}
},
"translationQuality": {
"header": "▸ 🌐 VỀ BẢN DỊCH",
"intro": "Ngoài tiếng Việt và tiếng Anh, phần mô tả ở các ngôn ngữ khác trên kênh được dịch với sự hỗ trợ của AI.",
"items": {
"accuracy": "Độ chính xác không đảm bảo 100% — một số từ ngữ hoặc thuật ngữ có thể bị sai.",
"phrasing": "Cách diễn đạt đôi khi hơi cứng hoặc bị dịch sát nghĩa.",
"localStyle": "Có thể chưa hợp với văn phong bản địa.",
"corrections": "Phát hiện lỗi? Rất mong bạn góp ý ở phần bình luận. 🙏"
}
},
"techNotes": {
"header": "▸ 🛠 GHI CHÚ KỸ THUẬT",
"intro": "Ghi chú minh bạch về sản xuất và cách chơi.",
@@ -206,6 +216,14 @@
"flashing_lights": "Hiệu ứng chớp sáng — người nhạy sáng cẩn thận",
"motion_sickness": "Say game — camera / FPS chuyển động nhanh",
"migraine_trigger": "Có thể gây đau nửa đầu",
"lens_flare_intense": "Lens flare / loé sáng cường độ cao",
"bloom_excessive": "Bloom quá mức / vùng sáng cháy",
"particle_effects_dense": "Hiệu ứng hạt dày đặc — vụ nổ, phép thuật, mảnh vỡ",
"screen_overlay_flashing": "HUD / overlay UI nhấp nháy",
"color_saturation_extreme": "Độ bão hoà màu cực cao / bảng màu loè loẹt",
"motion_blur_heavy": "Motion blur mạnh (camera + vật thể)",
"depth_of_field_aggressive": "Depth of field gắt / hiệu ứng pull focus",
"post_processing_intense": "Post-processing nặng — chromatic aberration, vignette, film grain",
"loud_noises": "Âm thanh đột ngột / tiếng động lớn",
"ear_piercing": "Âm chói tai / tần số cao gây khó chịu",
"jumpscare_audio": "Jumpscare âm thanh — âm to đột ngột không cảnh báo",
@@ -395,7 +413,48 @@
"mass_casualty_event": "Có sự kiện thương vong hàng loạt (tấn công, thảm họa)",
"vehicular_violence": "Tác động vật lý bằng phương tiện / lao xe có chủ đích",
"overdose_depiction": "Có cảnh sử dụng quá liều",
"defenestration": "Có cảnh ngã / nhảy từ trên cao có chủ đích"
"defenestration": "Có cảnh ngã / nhảy từ trên cao có chủ đích",
"profanity_frequent": "Văng tục dày đặc / ngôn từ thô tục",
"sexual_innuendo": "Lời thoại ẩn ý t*nh d*c / gợi mở",
"inflammatory_speech": "Lời thoại mang tính kích động",
"verbal_abuse": "Lăng mạ / sỉ nhục bằng lời nói",
"threatening_language": "Lời lẽ đe dọa / uy hiếp",
"slurs_derogatory": "Từ ngữ miệt thị / xúc phạm",
"crude_humor": "Hài thô tục",
"mature_humor": "Hài người lớn",
"dark_humor": "Hài đen / u tối",
"drug_references": "Lời thoại nhắc đến chất kích thích / đồ uống có cồn",
"chromophobia": "Cảnh nhiều màu rực / chói (chromophobia)",
"erythrophobia": "Cảnh toàn màu đỏ (erythrophobia)",
"xanthophobia": "Cảnh nhiều màu vàng (xanthophobia)",
"leukophobia": "Không gian toàn màu trắng (leukophobia)",
"melanophobia": "Cảnh toàn màu đen (melanophobia)",
"body_shaming": "Miệt thị ngoại hình (body shaming)",
"beauty_standards": "Chuẩn mực ngoại hình phi thực tế",
"cyberbullying": "Bắt nạt / quấy rối qua mạng",
"doxxing": "Doxxing / phơi bày thông tin cá nhân",
"trolling_griefing": "Trolling / phá hoại trong game",
"cancel_culture": "Văn hóa tẩy chay / bêu rếu công khai",
"social_media_addiction": "Nghiện mạng xã hội",
"doomscrolling": "Lướt tin tiêu cực vô độ (doomscrolling)",
"fomo": "Hội chứng sợ bỏ lỡ (FOMO)",
"fake_news": "Tin giả / thông tin sai lệch",
"online_scams": "Lừa đảo trực tuyến / phishing",
"catfishing": "Giả mạo danh tính trên mạng (catfishing)",
"deepfake_themes": "Deepfake / nội dung giả mạo bằng AI",
"cyberstalking": "Theo dõi / rình rập qua mạng",
"internet_challenges": "Trào lưu / thử thách nguy hiểm trên mạng",
"influencer_culture": "Văn hóa influencer / chạy theo tương tác",
"online_radicalization": "Cực đoan hóa qua mạng / buồng vang thông tin",
"loot_boxes": "Loot box / cơ chế gacha",
"ai_themes": "Chủ đề AI / trí tuệ nhân tạo",
"data_privacy": "Riêng tư dữ liệu / giám sát diện rộng",
"revealing_outfits": "Trang phục hở hang",
"partial_nudity": "Kh*a th*n một phần",
"sexualized_characters": "Tạo hình nhân vật bị t*nh d*c hóa",
"fanservice": "Yếu tố fan service / ecchi",
"suggestive_poses": "Tư thế / góc quay gợi cảm",
"educational_purpose_only": "Game phục vụ mục đích giáo dục / tuyên truyền"
}
},
"graphics": {
+129 -3
View File
@@ -10,6 +10,7 @@
"history": "Lịch sử",
"settings": "Cài đặt",
"batch": "Hàng loạt",
"social": "Mạng xã hội",
"playlist": "Playlist",
"logs": "Nhật ký",
"about": "Giới thiệu",
@@ -20,7 +21,8 @@
"collapse": "Thu gọn sidebar"
},
"header": {
"donate": "Ủng hộ"
"donate": "Ủng hộ",
"toggleTheme": "Đổi giao diện sáng/tối"
},
"about": {
"tagline": "Công cụ tạo title, description, tag cho kênh YouTube Gameplay No Commentary.",
@@ -33,6 +35,7 @@
"licenseLabel": "Giấy phép",
"donateHeading": "Ủng hộ / Donate",
"donateHelp": "Nếu YTDescGen giúp bạn tiết kiệm thời gian, mời mình một ly cà phê nhé. Mọi ủng hộ đều giúp dự án tiếp tục.",
"legalHeading": "Pháp lý",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
@@ -131,6 +134,7 @@
"os_name": "Hệ điều hành",
"os_version": "Phiên bản",
"os_edition": "Bản",
"os_distro": "Distro",
"vnDonate": "Donate (Việt Nam)",
"vnDonateHelp": "Chỉ hiển thị trong description khi ngôn ngữ đầu ra là Tiếng Việt.",
"vnBankName": "Tên ngân hàng",
@@ -321,9 +325,11 @@
"spoilers": "Spoiler",
"photosensitive": "Sức khoẻ / nhạy sáng",
"audio": "Âm thanh / cảm âm",
"dialogue": "Lời thoại / ngôn từ",
"phobias": "Hội chứng sợ",
"mental_health": "Sức khoẻ tinh thần",
"social_phenomena": "Hiện tượng tâm lý — xã hội",
"internet_digital": "Internet / đời sống số",
"sensitive": "Nội dung nhạy cảm / 18+",
"playstyle": "Chú thích lối chơi",
"horror_specific": "Kinh dị nặng đô",
@@ -339,6 +345,14 @@
"flashing_lights": "Hiệu ứng chớp sáng",
"motion_sickness": "Say game / camera nhanh",
"migraine_trigger": "Có thể đau nửa đầu",
"lens_flare_intense": "Loé sáng / lens flare",
"bloom_excessive": "Bloom quá đà / sáng cháy",
"particle_effects_dense": "Hiệu ứng hạt dày đặc",
"screen_overlay_flashing": "HUD / overlay nhấp nháy",
"color_saturation_extreme": "Màu sắc quá rực / loè loẹt",
"motion_blur_heavy": "Motion blur nặng",
"depth_of_field_aggressive": "Depth of field gắt",
"post_processing_intense": "Post-processing đậm đặc",
"loud_noises": "Âm thanh đột ngột",
"ear_piercing": "Âm chói tai / tần số cao",
"jumpscare_audio": "Jumpscare bằng âm thanh",
@@ -528,7 +542,48 @@
"mass_casualty_event": "Thương vong hàng loạt",
"vehicular_violence": "Tác động vật lý bằng phương tiện",
"overdose_depiction": "Cảnh sử dụng quá liều",
"defenestration": "Ngã / nhảy từ trên cao"
"defenestration": "Ngã / nhảy từ trên cao",
"profanity_frequent": "Văng tục dày đặc",
"sexual_innuendo": "Lời thoại ẩn ý t*nh d*c",
"inflammatory_speech": "Lời thoại kích động",
"verbal_abuse": "Lăng mạ / sỉ nhục bằng lời",
"threatening_language": "Lời đe dọa / uy hiếp",
"slurs_derogatory": "Từ ngữ miệt thị / xúc phạm",
"crude_humor": "Hài thô tục",
"mature_humor": "Hài người lớn",
"dark_humor": "Hài đen / u tối",
"drug_references": "Nhắc đến chất kích thích / đồ có cồn",
"chromophobia": "Sợ màu sắc / cảnh màu chói",
"erythrophobia": "Sợ màu đỏ / cảnh toàn đỏ",
"xanthophobia": "Sợ màu vàng",
"leukophobia": "Sợ màu trắng / không gian toàn trắng",
"melanophobia": "Sợ màu đen",
"body_shaming": "Miệt thị ngoại hình (body shaming)",
"beauty_standards": "Chuẩn mực ngoại hình phi thực tế",
"cyberbullying": "Bắt nạt / quấy rối qua mạng",
"doxxing": "Doxxing / phơi bày thông tin cá nhân",
"trolling_griefing": "Trolling / phá game",
"cancel_culture": "Văn hóa tẩy chay / bêu rếu công khai",
"social_media_addiction": "Nghiện mạng xã hội",
"doomscrolling": "Lướt tin tiêu cực vô độ (doomscrolling)",
"fomo": "Hội chứng sợ bỏ lỡ (FOMO)",
"fake_news": "Tin giả / thông tin sai lệch",
"online_scams": "Lừa đảo trực tuyến / phishing",
"catfishing": "Giả mạo danh tính trên mạng (catfishing)",
"deepfake_themes": "Deepfake / nội dung giả mạo bằng AI",
"cyberstalking": "Theo dõi / rình rập qua mạng",
"internet_challenges": "Trào lưu / thử thách nguy hiểm trên mạng",
"influencer_culture": "Văn hóa influencer / câu tương tác",
"online_radicalization": "Cực đoan hóa qua mạng / buồng vang thông tin",
"loot_boxes": "Loot box / cơ chế gacha",
"ai_themes": "Chủ đề AI / trí tuệ nhân tạo",
"data_privacy": "Riêng tư dữ liệu / giám sát diện rộng",
"revealing_outfits": "Trang phục hở hang",
"partial_nudity": "Kh*a th*n một phần",
"sexualized_characters": "Tạo hình nhân vật bị t*nh d*c hóa",
"fanservice": "Yếu tố fan service",
"suggestive_poses": "Tư thế / góc quay gợi cảm",
"educational_purpose_only": "Game mục đích giáo dục / tuyên truyền"
},
"playthroughNotes": {
"title": "Ghi chú lượt chơi",
@@ -695,6 +750,55 @@
"dismiss": "Bỏ qua",
"scrollToTop": "Cuộn lên đầu trang"
},
"errorPages": {
"actions": {
"home": "Về trang chính",
"back": "Quay lại",
"retry": "Thử lại",
"reload": "Tải lại trang",
"reportBug": "Báo lỗi"
},
"offlineBanner": {
"message": "Bạn đang ngoại tuyến. Ứng dụng vẫn hoạt động — dữ liệu được lưu cục bộ.",
"details": "Chi tiết",
"backOnline": "Đã kết nối lại"
},
"notFound": {
"title": "Không tìm thấy trang",
"description": "Trang bạn tìm không tồn tại hoặc đã được di chuyển. Hãy kiểm tra địa chỉ hoặc quay về trình soạn thảo."
},
"forbidden": {
"title": "Truy cập bị từ chối",
"description": "Bạn không có quyền xem trang này. Nếu bạn cho rằng đây là nhầm lẫn, vui lòng báo lỗi."
},
"expired": {
"title": "Phiên đã hết hạn",
"description": "Trang này không còn hợp lệ vì phiên của bạn đã hết hạn. Hãy tải lại để bắt đầu lại."
},
"serverError": {
"title": "Đã xảy ra lỗi",
"description": "Có lỗi không mong muốn khi tải trang này. Hãy thử tải lại và báo lỗi nếu sự cố tiếp diễn."
},
"offline": {
"title": "Bạn đang ngoại tuyến",
"description": "Hiện không có kết nối mạng. YTDescGen hoạt động hoàn toàn ngoại tuyến — hồ sơ, lịch sử và văn bản đã tạo đều được lưu cục bộ."
},
"runtime": {
"title": "Đã xảy ra lỗi",
"description": "Ứng dụng đã bắt được lỗi hiển thị trước khi trang bị treo. Dữ liệu của bạn vẫn an toàn — lỗi đã được ghi vào tab Nhật ký."
}
},
"consentGate": {
"title": "Trước khi bắt đầu",
"intro": "YTDescGen là công cụ miễn phí, ưu tiên hoạt động ngoại tuyến. Vui lòng xem các tài liệu bên dưới. Khi tiếp tục, bạn xác nhận đã đọc và đồng ý với chúng.",
"agreeLabel": "Tôi đã đọc và đồng ý với Điều khoản Sử dụng, Chính sách Bảo mật, Tuyên bố Miễn trừ và Giấy phép.",
"continue": "Tiếp tục",
"mustAgree": "Vui lòng tích vào ô để tiếp tục.",
"docTerms": "Điều khoản Sử dụng",
"docPrivacy": "Chính sách Bảo mật",
"docDisclaimer": "Tuyên bố Miễn trừ",
"docLicense": "Giấy phép (Apache-2.0)"
},
"videoTypes": {
"full": "Full Gameplay",
"part": "Gameplay Phần",
@@ -790,7 +894,8 @@
"mastodon": "Mastodon",
"facebook": "Facebook",
"fb_page": "Facebook Page",
"fb_group": "Facebook Group"
"fb_group": "Facebook Group",
"telegram": "Telegram"
},
"resolutions": {
"720p": "720p",
@@ -877,6 +982,8 @@
"showSponsorCredit": "Hiện dòng cảm ơn sponsor (tặng key) trong description",
"showThirdPartyAds": "Hiện block quảng cáo bên thứ 3 trong description",
"thirdPartyAdsHint": "Nhập nội dung quảng cáo trong Hồ sơ kênh (Profiles → Sửa).",
"showTranslationQuality": "Hiện ghi chú chất lượng bản dịch",
"showTranslationQualityHint": "Thêm ghi chú về dịch thuật bằng AI vào mô tả ở các ngôn ngữ khác ngoài tiếng Anh và tiếng Việt.",
"titleFormatTitle": "Định dạng tiêu đề",
"descriptionSettingsTitle": "Mô tả",
"badgePosition": "Vị trí badge chất lượng",
@@ -901,6 +1008,25 @@
"logRetentionDays": "Giữ log (ngày)",
"logRetentionHint": "Log cũ hơn số ngày này sẽ tự xoá khi mở app. Phạm vi: 1–90 ngày."
},
"socialPost": {
"title": "Bài đăng đa nền tảng",
"single": "Đơn lẻ",
"bulk": "Hàng loạt",
"copyCaption": "Sao chép nội dung",
"emptyState": "Nhập tên game ở trang Editor để tạo nội dung.",
"trimmedHint": "Đã lược bớt {{count}} mục tùy chọn để vừa giới hạn nền tảng.",
"overLimitHint": "Vượt giới hạn ký tự của {{platform}} — hãy rút gọn trước khi đăng.",
"exported": "Đã xuất nội dung!",
"exportFailed": "Xuất thất bại",
"imported": "Đã nhập nội dung",
"importFailed": "Nhập thất bại — hãy chọn tệp xuất Social của YTDescGen.",
"importedHeading": "Nội dung đã nhập",
"platforms": {
"tiktok": "TikTok",
"instagram_reels": "Instagram Reels",
"facebook_reels": "Facebook Reels"
}
},
"batch": {
"title": "Chế độ hàng loạt",
"startPart": "Phần bắt đầu",
+60 -1
View File
@@ -163,6 +163,16 @@
"custom": "自定义"
}
},
"translationQuality": {
"header": "▸ 🌐 关于翻译",
"intro": "除英语和越南语外,本频道的简介均由 AI 辅助翻译。",
"items": {
"accuracy": "无法保证 100% 准确,部分词语或术语可能有误。",
"phrasing": "措辞有时可能比较生硬或偏直译。",
"localStyle": "可能不完全符合当地的自然表达习惯。",
"corrections": "发现错误?欢迎在评论区指正。🙏"
}
},
"techNotes": {
"header": "▸ 🛠 技术说明",
"intro": "为保持透明度的制作和游玩说明。",
@@ -206,6 +216,14 @@
"flashing_lights": "闪光效果 — 光敏感者请注意",
"motion_sickness": "3D晕眩 — 镜头 / FPS 快速移动",
"migraine_trigger": "可能引发偏头痛",
"lens_flare_intense": "强烈的镜头光晕 / 阳光眩光",
"bloom_excessive": "过度泛光 / 高光溢出",
"particle_effects_dense": "密集粒子特效 — 爆炸、法术、碎屑",
"screen_overlay_flashing": "闪烁的 HUD / UI 覆盖层",
"color_saturation_extreme": "极端饱和度 / 配色过艳",
"motion_blur_heavy": "强动态模糊(镜头 + 物体)",
"depth_of_field_aggressive": "强景深 / 焦点拉动效果",
"post_processing_intense": "强后期处理 — 色差、暗角、胶片颗粒",
"loud_noises": "突发的大音量",
"ear_piercing": "刺耳音 / 高频音段",
"jumpscare_audio": "音效突袭 — 突如其来的大音量",
@@ -395,7 +413,48 @@
"mass_casualty_event": "大规模伤亡事件(袭击、灾难)",
"vehicular_violence": "车辆暴力 / 蓄意撞击",
"overdose_depiction": "药物过量场景",
"defenestration": "高处坠落(蓄意)"
"defenestration": "高处坠落(蓄意)",
"profanity_frequent": "频繁脏话 / 粗俗语言",
"sexual_innuendo": "含性暗示的台词",
"inflammatory_speech": "煽动性 / 挑衅性台词",
"verbal_abuse": "言语辱骂 / 贬低",
"threatening_language": "威胁 / 恐吓性言语",
"slurs_derogatory": "侮辱性 / 歧视性用语",
"crude_humor": "低俗幽默",
"mature_humor": "成人幽默",
"dark_humor": "黑色幽默",
"drug_references": "台词中提及成瘾物质 / 酒精",
"chromophobia": "强烈色彩场景(色彩恐惧症)",
"erythrophobia": "全红场景(红色恐惧症)",
"xanthophobia": "黄色为主的场景(黄色恐惧症)",
"leukophobia": "全白空间(白色恐惧症)",
"melanophobia": "全黑场景(黑色恐惧症)",
"body_shaming": "外貌羞辱(body shaming)",
"beauty_standards": "不切实际的审美标准",
"cyberbullying": "网络霸凌 / 网络骚扰",
"doxxing": "人肉搜索 / 个人隐私曝光",
"trolling_griefing": "网络喷子 / 恶意捣乱行为",
"cancel_culture": "取消文化 / 公开羞辱",
"social_media_addiction": "社交媒体成瘾",
"doomscrolling": "无休止刷负面信息(doomscrolling)",
"fomo": "错失恐惧 — FOMO",
"fake_news": "假新闻 / 虚假信息",
"online_scams": "网络诈骗 / 钓鱼",
"catfishing": "网络身份冒充(catfishing)",
"deepfake_themes": "深度伪造 / 合成媒体",
"cyberstalking": "网络跟踪骚扰",
"internet_challenges": "危险的网络挑战",
"influencer_culture": "网红文化 / 流量至上",
"online_radicalization": "网络极端化 / 信息茧房",
"loot_boxes": "开箱 / 抽卡机制",
"ai_themes": "AI / 人工智能主题",
"data_privacy": "数据隐私 / 大规模监控",
"revealing_outfits": "暴露服装",
"partial_nudity": "部分裸露",
"sexualized_characters": "性化的角色设计",
"fanservice": "福利镜头(fan service)",
"suggestive_poses": "暗示性姿势 / 镜头角度",
"educational_purpose_only": "教育 / 公益宣传目的游戏"
}
},
"graphics": {
+129 -3
View File
@@ -10,6 +10,7 @@
"history": "历史",
"settings": "设置",
"batch": "批量",
"social": "社交",
"playlist": "播放列表",
"logs": "日志",
"about": "关于",
@@ -20,7 +21,8 @@
"collapse": "折叠侧边栏"
},
"header": {
"donate": "赞助"
"donate": "赞助",
"toggleTheme": "切换主题"
},
"about": {
"tagline": "为游戏实况无解说频道生成 YouTube 标题、描述和标签的工具。",
@@ -33,6 +35,7 @@
"licenseLabel": "许可证",
"donateHeading": "赞助 / 支持",
"donateHelp": "如果 YTDescGen 帮你省下了时间,欢迎请我喝一杯咖啡。每份支持都让项目走得更远。",
"legalHeading": "法律",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
@@ -131,6 +134,7 @@
"os_name": "系统",
"os_version": "版本",
"os_edition": "版本类型",
"os_distro": "发行版",
"vnDonate": "Donate (Vietnam)",
"vnDonateHelp": "Only rendered into the description when output language is Vietnamese.",
"vnBankName": "Bank name",
@@ -321,9 +325,11 @@
"spoilers": "剧透",
"photosensitive": "光敏感 / 健康",
"audio": "音频 / 感官",
"dialogue": "台词 / 语言",
"phobias": "恐惧症",
"mental_health": "心理健康",
"social_phenomena": "社会心理现象",
"internet_digital": "互联网 / 数字生活",
"sensitive": "成人 / 敏感",
"playstyle": "游玩说明",
"horror_specific": "重度恐怖",
@@ -339,6 +345,14 @@
"flashing_lights": "闪光效果",
"motion_sickness": "3D晕眩",
"migraine_trigger": "可能引发偏头痛",
"lens_flare_intense": "镜头光晕 / 强光眩光",
"bloom_excessive": "过度泛光 / 高光溢出",
"particle_effects_dense": "密集粒子特效",
"screen_overlay_flashing": "HUD / UI 闪烁",
"color_saturation_extreme": "极高饱和度 / 配色刺眼",
"motion_blur_heavy": "强动态模糊",
"depth_of_field_aggressive": "强景深效果",
"post_processing_intense": "强后期处理",
"loud_noises": "突发音量",
"ear_piercing": "刺耳 / 高频音",
"jumpscare_audio": "音效突袭",
@@ -528,7 +542,48 @@
"mass_casualty_event": "大规模伤亡事件",
"vehicular_violence": "车辆暴力",
"overdose_depiction": "药物过量场景",
"defenestration": "高处坠落"
"defenestration": "高处坠落",
"profanity_frequent": "频繁脏话 / 粗俗语言",
"sexual_innuendo": "含性暗示的台词",
"inflammatory_speech": "煽动性台词",
"verbal_abuse": "言语辱骂",
"threatening_language": "威胁性言语",
"slurs_derogatory": "侮辱性 / 歧视性用语",
"crude_humor": "低俗幽默",
"mature_humor": "成人幽默",
"dark_humor": "黑色幽默",
"drug_references": "提及成瘾物质 / 酒精",
"chromophobia": "色彩恐惧",
"erythrophobia": "红色恐惧 / 全红场景",
"xanthophobia": "黄色恐惧",
"leukophobia": "白色恐惧 / 全白空间",
"melanophobia": "黑色恐惧",
"body_shaming": "外貌羞辱",
"beauty_standards": "不切实际的审美标准",
"cyberbullying": "网络霸凌 / 网络骚扰",
"doxxing": "人肉搜索 / 隐私曝光",
"trolling_griefing": "网络喷子 / 恶意捣乱",
"cancel_culture": "取消文化 / 公开羞辱",
"social_media_addiction": "社交媒体成瘾",
"doomscrolling": "无休止刷负面信息",
"fomo": "错失恐惧 (FOMO)",
"fake_news": "假新闻 / 虚假信息",
"online_scams": "网络诈骗 / 钓鱼",
"catfishing": "网络身份冒充",
"deepfake_themes": "深度伪造 / 合成媒体",
"cyberstalking": "网络跟踪骚扰",
"internet_challenges": "危险的网络挑战",
"influencer_culture": "网红文化 / 流量至上",
"online_radicalization": "网络极端化 / 信息茧房",
"loot_boxes": "开箱 / 抽卡机制",
"ai_themes": "AI / 人工智能主题",
"data_privacy": "数据隐私 / 大规模监控",
"revealing_outfits": "暴露服装",
"partial_nudity": "部分裸露",
"sexualized_characters": "性化的角色设计",
"fanservice": "福利镜头 (fan service)",
"suggestive_poses": "暗示性姿势 / 镜头角度",
"educational_purpose_only": "教育 / 公益宣传目的游戏"
},
"playthroughNotes": {
"title": "本期游玩说明",
@@ -695,6 +750,55 @@
"dismiss": "关闭",
"scrollToTop": "回到顶部"
},
"errorPages": {
"actions": {
"home": "返回主页",
"back": "返回",
"retry": "重试",
"reload": "重新加载页面",
"reportBug": "报告错误"
},
"offlineBanner": {
"message": "您已离线。应用仍可正常使用 — 数据保存在本地。",
"details": "详情",
"backOnline": "已恢复在线"
},
"notFound": {
"title": "页面未找到",
"description": "您查找的页面不存在或已移动。请检查地址,或返回编辑器。"
},
"forbidden": {
"title": "访问被拒绝",
"description": "您没有权限查看此页面。如果您认为这是错误,请报告。"
},
"expired": {
"title": "会话已过期",
"description": "由于您的会话已过期,此页面不再有效。请重新加载以重新开始。"
},
"serverError": {
"title": "出现问题",
"description": "加载此页面时发生意外错误。请尝试重新加载,如果问题持续请报告。"
},
"offline": {
"title": "您已离线",
"description": "当前没有网络连接。YTDescGen 完全可离线运行 — 您的配置、历史记录和生成的文本都保存在本地。"
},
"runtime": {
"title": "出现问题",
"description": "应用在页面崩溃前捕获了一个渲染错误。您的数据是安全的 — 错误已记录到日志标签页。"
}
},
"consentGate": {
"title": "开始之前",
"intro": "YTDescGen 是一款免费、离线优先的工具。请查看以下文档。继续即表示您已阅读并同意这些文档。",
"agreeLabel": "我已阅读并同意《使用条款》《隐私政策》《免责声明》和《许可证》。",
"continue": "继续",
"mustAgree": "请勾选复选框以继续。",
"docTerms": "使用条款",
"docPrivacy": "隐私政策",
"docDisclaimer": "免责声明",
"docLicense": "许可证 (Apache-2.0)"
},
"videoTypes": {
"full": "完整游戏实况",
"part": "游戏实况分集",
@@ -790,7 +894,8 @@
"mastodon": "Mastodon",
"facebook": "Facebook",
"fb_page": "Facebook主页",
"fb_group": "Facebook群组"
"fb_group": "Facebook群组",
"telegram": "Telegram"
},
"resolutions": {
"720p": "720p",
@@ -877,6 +982,8 @@
"showSponsorCredit": "在描述中添加赞助商感谢行(提供激活码)",
"showThirdPartyAds": "在描述中显示第三方广告区块",
"thirdPartyAdsHint": "广告文案请在频道配置中设置(配置文件 → 编辑)。",
"showTranslationQuality": "显示翻译质量提示",
"showTranslationQualityHint": "为以英语和越南语以外语言生成的简介添加 AI 翻译说明。",
"titleFormatTitle": "标题格式",
"descriptionSettingsTitle": "描述",
"badgePosition": "画质徽章位置",
@@ -901,6 +1008,25 @@
"logRetentionDays": "日志保留 (天)",
"logRetentionHint": "早于此天数的日志会在启动时删除。范围:1–90 天。"
},
"socialPost": {
"title": "跨平台文案",
"single": "单条",
"bulk": "批量",
"copyCaption": "复制文案",
"emptyState": "在编辑器中输入游戏名称即可生成文案。",
"trimmedHint": "已删减 {{count}} 个可选部分以符合平台限制。",
"overLimitHint": "超出 {{platform}} 字数限制——发布前请删减。",
"exported": "文案已导出!",
"exportFailed": "导出失败",
"imported": "文案已导入",
"importFailed": "导入失败——请选择 YTDescGen 的 Social 导出文件。",
"importedHeading": "已导入的文案",
"platforms": {
"tiktok": "TikTok",
"instagram_reels": "Instagram Reels",
"facebook_reels": "Facebook Reels"
}
},
"batch": {
"title": "批量生成",
"startPart": "起始分集",
+52 -7
View File
@@ -2,20 +2,65 @@ import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import App from "./App";
import { ErrorBoundary } from "./components/ErrorBoundary";
import i18n, { ensureLanguagesLoaded } from "@i18n/index";
import { useSettingsStore } from "@store/settings-store";
import { useEditorStore } from "@store/editor-store";
import "./styles/globals.css";
const root = document.getElementById("root");
if (!root) throw new Error("Root element not found");
/**
* Lazy-loaded locales (v0.26): fetch the persisted UI + output languages
* before first paint so a non-English user never sees an English flash
* (and the Output page never renders a placeholder on cold start).
* zustand persist hydrates synchronously from localStorage, so these
* reads already hold the user's values; Tauri's async settings-file
* rehydrate is bridged later by App's store subscription.
*
* `en` resolves from the eagerly-bundled resources, so English users pay
* zero extra latency. The 2 s race cap means a dead network can delay —
* but never block — first paint; the readiness hooks re-gate after render.
*/
async function preloadLocales(): Promise<void> {
const { appLanguage, defaultOutputLanguage } = useSettingsStore.getState();
const outputLanguage = useEditorStore.getState().language;
await Promise.race([
Promise.all([
i18n.changeLanguage(appLanguage),
ensureLanguagesLoaded([defaultOutputLanguage, outputLanguage]),
]),
new Promise<void>((resolve) => setTimeout(resolve, 2000)),
]).catch(() => undefined);
}
/**
* Apply the persisted theme class to <html> at boot. `index.html` hardcodes
* `class="dark"`, and `setTheme` (the Header toggle) is the only other place
* that touches the class — so before v0.28.0 a light-theme user saw a dark
* flash until they interacted. zustand persist has already hydrated from
* localStorage at module load, so `getState().theme` is the user's value.
* Runs before first paint so the consent gate (and AppShell) render in the
* right theme.
*/
function applyPersistedTheme(): void {
const { theme } = useSettingsStore.getState();
document.documentElement.classList.toggle("dark", theme === "dark");
document.documentElement.classList.toggle("light", theme === "light");
}
// Top-level safety net. Per-route boundaries in App.tsx catch most
// errors with route-specific labels; this outer one only fires if
// something explodes *before* the router mounts (e.g. i18n init, store
// rehydrate). Without it, a top-level crash still produces a black
// page — defeating the point of per-route boundaries.
createRoot(root).render(
<StrictMode>
<ErrorBoundary label="app">
<App />
</ErrorBoundary>
</StrictMode>,
);
void preloadLocales().finally(() => {
applyPersistedTheme();
createRoot(root).render(
<StrictMode>
<ErrorBoundary label="app">
<App />
</ErrorBoundary>
</StrictMode>,
);
});
+17
View File
@@ -20,6 +20,7 @@ import {
import { ABOUT, type AboutSocialId } from "@config/about";
import { DONATE, type DonateId } from "@config/donate";
import { THIRD_PARTY } from "@config/third-party";
import { LEGAL_DOCS } from "@config/legal";
import { useDocumentTitle } from "@hooks/use-document-title";
interface SocialLinkConfig {
@@ -112,6 +113,22 @@ export function AboutPage() {
</div>
</section>
<section className="flex flex-col gap-3">
<h2 className="text-sm font-semibold uppercase tracking-wide text-text-muted">
{t("about.legalHeading")}
</h2>
<div className="grid gap-2 sm:grid-cols-2">
{LEGAL_DOCS.map((doc) => (
<ExternalLinkRow
key={doc.id}
href={doc.url}
icon={ExternalLink}
label={t(doc.labelKey)}
/>
))}
</div>
</section>
<section className="flex flex-col gap-3">
<h2 className="text-sm font-semibold uppercase tracking-wide text-text-muted">
{t("about.donateHeading")}
+22 -3
View File
@@ -8,7 +8,7 @@ import { CopyButton } from "@components/output/CopyButton";
import { CharCounter } from "@components/output/CharCounter";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { SUPPORTED_LANGUAGES } from "@i18n/index";
import { SUPPORTED_LANGUAGES, ensureLanguagesLoaded } from "@i18n/index";
import { renderAll } from "@engine/template-renderer";
import { buildPinnedComment } from "@engine/pinned-comment-builder";
import { YT_LIMITS } from "@engine/types";
@@ -42,6 +42,7 @@ export function BatchPage() {
showUsagePolicy,
showSponsorCredit,
showGameCopyright,
showTranslationQuality,
showPinnedCommentTemplate,
pinnedCommentIncludeAskNextGame,
titleFormat,
@@ -50,6 +51,7 @@ export function BatchPage() {
const [endPart, setEndPart] = useState("5");
const [selectedLangs, setSelectedLangs] = useState<SupportedLanguage[]>([state.language]);
const [results, setResults] = useState<BatchResult[]>([]);
const [generating, setGenerating] = useState(false);
const toggleLang = (lang: SupportedLanguage) => {
setSelectedLangs((prev) => {
@@ -60,7 +62,7 @@ export function BatchPage() {
});
};
const handleGenerate = () => {
const generate = () => {
const start = parseInt(startPart) || 1;
const end = parseInt(endPart) || start;
const outputs: BatchResult[] = [];
@@ -89,6 +91,7 @@ export function BatchPage() {
showUsagePolicy,
showSponsorCredit,
showGameCopyright,
showTranslationQuality,
titleFormat,
});
const pinnedComment = showPinnedCommentTemplate
@@ -103,6 +106,19 @@ export function BatchPage() {
setResults(outputs);
};
const handleGenerate = async () => {
setGenerating(true);
try {
// Lazy-loaded locales (v0.26): batch generates across multiple
// languages in one pass — every selected bundle must be in memory
// before the loop, or getFixedT silently renders English.
await ensureLanguagesLoaded(selectedLangs);
generate();
} finally {
setGenerating(false);
}
};
const allCombined = useMemo(
() =>
results
@@ -160,7 +176,10 @@ export function BatchPage() {
value={endPart}
onChange={(e) => setEndPart(e.target.value)}
/>
<Button onClick={handleGenerate} disabled={!state.gameName}>
<Button
onClick={() => void handleGenerate()}
disabled={!state.gameName || generating}
>
{t("batch.generateBatch")}
</Button>
</div>
+7 -1
View File
@@ -10,6 +10,7 @@ import { Select } from "@components/ui/Select";
import { CopyButton } from "@components/output/CopyButton";
import { useEditorStore } from "@store/editor-store";
import { SUPPORTED_LANGUAGES } from "@i18n/index";
import { useLanguagesReady } from "@hooks/use-languages-ready";
import {
buildPlaylistTitle,
buildPlaylistDescription,
@@ -66,13 +67,18 @@ export function PlaylistPage() {
[editor.gameName, editor.channelName, status, contentType, totalVideos, editor.storeLinks, customNote],
);
// Lazy-loaded locales (v0.26): the dropdown can pick a language whose
// bundle isn't fetched yet — hold the placeholder until it is.
const ready = useLanguagesReady([language]);
const output = useMemo(() => {
if (!ready) return { title: "", description: "" };
const tFn = i18n.getFixedT(language, "templates");
return {
title: buildPlaylistTitle(playlistInput, tFn),
description: buildPlaylistDescription(playlistInput, tFn),
};
}, [playlistInput, language]);
}, [ready, playlistInput, language]);
return (
<div className="mx-auto flex max-w-5xl flex-col gap-6 p-6 lg:flex-row">
+8
View File
@@ -333,6 +333,14 @@ export function SettingsPage() {
{t("settings.thirdPartyAdsHint")}
</p>
)}
<Toggle
label={t("settings.showTranslationQuality")}
checked={settings.showTranslationQuality}
onChange={(v) => settings.setSetting("showTranslationQuality", v)}
/>
<p className="-mt-1 ml-14 text-xs text-text-muted">
{t("settings.showTranslationQualityHint")}
</p>
<Toggle
label={t("settings.showPinnedCommentTemplate")}
checked={settings.showPinnedCommentTemplate}
+462
View File
@@ -0,0 +1,462 @@
import { useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import i18n from "i18next";
import { Download, Upload } from "lucide-react";
import { useDocumentTitle } from "@hooks/use-document-title";
import { Button } from "@components/ui/Button";
import { Input } from "@components/ui/Input";
import { CopyButton } from "@components/output/CopyButton";
import { CharCounter } from "@components/output/CharCounter";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { SUPPORTED_LANGUAGES, ensureLanguagesLoaded } from "@i18n/index";
import { SOCIAL_PLATFORMS } from "@config/social-platforms";
import { useSocialPosts } from "@hooks/use-social-posts";
import {
buildAllSocialPosts,
type SocialPostOutput,
} from "@engine/social-post-builder";
import { useCurrentGeneratorInput } from "@hooks/use-current-generator-input";
import {
exportTypedToJsonFile,
importTypedFromJsonFile,
} from "@utils/import-export";
import type { SupportedLanguage } from "@engine/types";
import toast from "react-hot-toast";
import { logger } from "@utils/logger";
import clsx from "clsx";
/** One platform's caption inside an exported bundle. */
interface SocialPostExport {
platform: string;
charLimit: number;
text: string;
charCount: number;
isOver: boolean;
}
/** The JSON payload written by Export / read by Import — the generated
* captions for one source (captions are derived artifacts, so import is
* display-only; there's no store to merge into). */
interface SocialExportBundle {
gameName: string;
language: SupportedLanguage;
partNumber?: string;
posts: SocialPostExport[];
}
interface BulkRow {
partNumber: string;
language: SupportedLanguage;
posts: Record<string, SocialPostOutput>;
}
export function SocialPage() {
const { t } = useTranslation("ui");
useDocumentTitle(t("tabs.social"));
const gameName = useEditorStore((s) => s.gameName);
const language = useEditorStore((s) => s.language);
const baseInput = useCurrentGeneratorInput();
const { showCopyright, showSponsorCredit } = useSettingsStore();
const posts = useSocialPosts();
const [mode, setMode] = useState<"single" | "bulk">("single");
const [activePlatform, setActivePlatform] = useState<string>(
SOCIAL_PLATFORMS[0]?.id ?? "tiktok",
);
// Bulk state
const [startPart, setStartPart] = useState("1");
const [endPart, setEndPart] = useState("5");
const [selectedLangs, setSelectedLangs] = useState<SupportedLanguage[]>([
language,
]);
const [bulkResults, setBulkResults] = useState<BulkRow[]>([]);
const [generating, setGenerating] = useState(false);
// Import display (read-only)
const [imported, setImported] = useState<SocialExportBundle | null>(null);
const activeConfig =
SOCIAL_PLATFORMS.find((p) => p.id === activePlatform) ?? SOCIAL_PLATFORMS[0];
const activePost = posts[activePlatform];
const platformLabel = (id: string) =>
t(SOCIAL_PLATFORMS.find((p) => p.id === id)?.labelKey ?? id);
const handleExport = () => {
try {
const bundle: SocialExportBundle = {
gameName: baseInput.gameName,
language: baseInput.language,
posts: SOCIAL_PLATFORMS.map((p) => ({
platform: p.id,
charLimit: p.charLimit,
text: posts[p.id]?.text ?? "",
charCount: posts[p.id]?.charCount ?? 0,
isOver: posts[p.id]?.isOver ?? false,
})),
};
const safeName = (baseInput.gameName || "captions")
.replace(/[^\p{L}\p{N}]+/gu, "-")
.toLowerCase();
exportTypedToJsonFile("social", bundle, `ytdescgen-social-${safeName}.json`);
toast.success(t("socialPost.exported"));
} catch (e) {
toast.error(t("socialPost.exportFailed"));
logger.error("social", "Failed to export captions", String(e));
}
};
const handleImport = async () => {
const result = await importTypedFromJsonFile("social");
if (!result.ok) {
if (result.failure.kind === "cancelled") return;
toast.error(t("socialPost.importFailed"));
logger.warn("social", `Import failed: ${result.failure.kind}`);
return;
}
const data = result.data as Partial<SocialExportBundle> | null;
if (!data || !Array.isArray(data.posts)) {
toast.error(t("socialPost.importFailed"));
return;
}
setImported({
gameName: typeof data.gameName === "string" ? data.gameName : "",
language: (data.language ?? "en") as SupportedLanguage,
partNumber:
typeof data.partNumber === "string" ? data.partNumber : undefined,
posts: data.posts as SocialPostExport[],
});
toast.success(t("socialPost.imported"));
};
const toggleLang = (lang: SupportedLanguage) => {
setSelectedLangs((prev) => {
if (prev.includes(lang)) {
return prev.length <= 1 ? prev : prev.filter((l) => l !== lang);
}
return [...prev, lang];
});
};
const bulkGenerate = () => {
const start = parseInt(startPart) || 1;
const end = parseInt(endPart) || start;
const rows: BulkRow[] = [];
// Loop-invariant English translator for the bilingual content-warnings
// block — `en` is eagerly bundled, so it needs no readiness gate.
const tEn = i18n.getFixedT("en", "templates");
for (let i = start; i <= Math.min(end, start + 99); i++) {
for (const lang of selectedLangs) {
const tFn = i18n.getFixedT(lang, "templates");
const input = {
...baseInput,
videoType: "part" as const,
language: lang,
partNumber: String(i),
timestamps: "",
};
rows.push({
partNumber: String(i),
language: lang,
posts: buildAllSocialPosts(input, tFn, SOCIAL_PLATFORMS, {
showCopyright,
showSponsorCredit,
tEn,
}),
});
}
}
setBulkResults(rows);
};
const handleBulkGenerate = async () => {
setGenerating(true);
try {
// Lazy-loaded locales (v0.26): bulk generates across multiple
// languages in one pass — every selected bundle must be in memory
// before the loop, or getFixedT silently renders English.
await ensureLanguagesLoaded(selectedLangs);
bulkGenerate();
} finally {
setGenerating(false);
}
};
const bulkCombined = useMemo(
() =>
bulkResults
.map((row) =>
SOCIAL_PLATFORMS.map(
(p) =>
`[${t(p.labelKey)} · ${row.language.toUpperCase()} · ${row.partNumber}]\n${row.posts[p.id]?.text ?? ""}`,
).join("\n\n---\n\n"),
)
.join("\n\n===\n\n"),
[bulkResults, t],
);
// SOCIAL_PLATFORMS is a non-empty literal, so this never fires — it just
// narrows `activeConfig` to non-undefined for the JSX below without a `!`.
if (!activeConfig) return null;
const ActiveIcon = activeConfig.icon;
return (
<div className="mx-auto max-w-4xl p-6">
<div className="mb-4 flex flex-wrap items-center justify-between gap-3">
<h1 className="text-lg font-bold text-text-primary">
{t("socialPost.title")}
</h1>
<div className="flex gap-1 rounded-lg bg-surface-1 p-1">
{(["single", "bulk"] as const).map((m) => (
<button
key={m}
onClick={() => setMode(m)}
className={clsx(
"rounded-md px-3 py-1 text-sm font-medium transition-colors",
mode === m
? "bg-accent text-white"
: "text-text-muted hover:text-text-primary",
)}
>
{t(`socialPost.${m}`)}
</button>
))}
</div>
</div>
{mode === "single" ? (
<>
{/* Platform switcher */}
<div className="mb-4 flex flex-wrap gap-1 rounded-lg bg-surface-1 p-1">
{SOCIAL_PLATFORMS.map((p) => {
const Icon = p.icon;
return (
<button
key={p.id}
onClick={() => setActivePlatform(p.id)}
className={clsx(
"flex items-center gap-1.5 rounded-md px-3 py-1.5 text-sm font-medium transition-colors",
activePlatform === p.id
? "bg-accent text-white"
: "text-text-muted hover:text-text-primary",
)}
>
<Icon className="h-3.5 w-3.5" />
{t(p.labelKey)}
</button>
);
})}
<div className="ml-auto flex gap-2">
<Button
variant="ghost"
size="sm"
onClick={handleExport}
disabled={!gameName}
>
<Download className="h-3.5 w-3.5" />
{t("common.export")}
</Button>
<Button variant="ghost" size="sm" onClick={handleImport}>
<Upload className="h-3.5 w-3.5" />
{t("common.import")}
</Button>
</div>
</div>
{!gameName ? (
<p className="rounded-lg border border-dashed border-border py-8 text-center text-sm text-text-muted">
{t("socialPost.emptyState")}
</p>
) : (
activePost && (
<div className="rounded-lg border border-border bg-surface-1 p-4">
<div className="mb-2 flex items-center justify-between">
<div className="flex items-center gap-2">
<ActiveIcon className="h-4 w-4 text-accent" />
<span className="text-sm font-semibold text-text-primary">
{t(activeConfig.labelKey)}
</span>
</div>
<div className="flex items-center gap-2">
<CharCounter
text={activePost.text}
limit={activeConfig.charLimit}
/>
<CopyButton
text={activePost.text}
label={t("socialPost.copyCaption")}
limit={activeConfig.charLimit}
fieldLabel={t(activeConfig.labelKey)}
/>
</div>
</div>
{activePost.isOver && (
<p className="mb-2 text-xs text-danger">
{t("socialPost.overLimitHint", {
platform: t(activeConfig.labelKey),
})}
</p>
)}
{activePost.droppedBlocks.length > 0 && (
<p className="mb-2 text-xs text-warning">
{t("socialPost.trimmedHint", {
count: activePost.droppedBlocks.length,
})}
</p>
)}
<pre className="whitespace-pre-wrap break-words font-sans text-sm text-text-secondary">
{activePost.text}
</pre>
</div>
)
)}
{imported && (
<div className="mt-6 rounded-lg border border-accent/40 bg-accent/5 p-4">
<div className="mb-3 flex items-center justify-between">
<h2 className="text-sm font-semibold text-text-primary">
{t("socialPost.importedHeading")}
{imported.gameName ? ` — ${imported.gameName}` : ""}
</h2>
<Button
variant="ghost"
size="sm"
onClick={() => setImported(null)}
>
{t("common.dismiss")}
</Button>
</div>
<div className="flex flex-col gap-3">
{imported.posts.map((p) => (
<div key={p.platform} className="rounded-lg bg-surface-2 p-3">
<div className="mb-1 flex items-center justify-between">
<span className="text-xs font-medium uppercase text-text-muted">
{platformLabel(p.platform)}
</span>
<CopyButton
text={p.text}
label={t("socialPost.copyCaption")}
limit={p.charLimit}
/>
</div>
<pre className="whitespace-pre-wrap break-words font-sans text-xs text-text-secondary">
{p.text}
</pre>
</div>
))}
</div>
</div>
)}
</>
) : (
<div className="flex flex-col gap-4">
{/* Language selector */}
<div>
<span className="mb-2 block text-sm font-medium text-text-secondary">
{t("output.selectLanguages")}
</span>
<div className="flex flex-wrap gap-2">
{SUPPORTED_LANGUAGES.map((lang) => (
<button
key={lang.id}
onClick={() => toggleLang(lang.id as SupportedLanguage)}
className={clsx(
"rounded-lg px-3 py-1.5 text-sm font-medium transition-colors",
selectedLangs.includes(lang.id as SupportedLanguage)
? "bg-accent text-white"
: "bg-surface-2 text-text-muted hover:text-text-primary",
)}
>
{lang.flag} {lang.nativeName}
</button>
))}
</div>
</div>
<div className="flex items-end gap-4">
<Input
label={t("batch.startPart")}
type="number"
value={startPart}
onChange={(e) => setStartPart(e.target.value)}
/>
<Input
label={t("batch.endPart")}
type="number"
value={endPart}
onChange={(e) => setEndPart(e.target.value)}
/>
<Button
onClick={() => void handleBulkGenerate()}
disabled={!gameName || generating}
>
{t("common.generate")}
</Button>
</div>
{bulkResults.length === 0 ? (
<p className="rounded-lg border border-dashed border-border py-8 text-center text-sm text-text-muted">
{t("batch.emptyState")}
</p>
) : (
<>
<div className="flex items-center justify-between">
<span className="text-sm text-text-secondary">
{bulkResults.length} × {SOCIAL_PLATFORMS.length}
</span>
<CopyButton text={bulkCombined} label={t("output.copyAll")} />
</div>
<div className="flex flex-col gap-4">
{bulkResults.map((row) => (
<div
key={`${row.partNumber}-${row.language}`}
className="rounded-lg border border-border bg-surface-1 p-4"
>
<h3 className="mb-3 text-sm font-semibold text-text-primary">
{row.partNumber} · {row.language.toUpperCase()}
</h3>
<div className="flex flex-col gap-3">
{SOCIAL_PLATFORMS.map((p) => {
const post = row.posts[p.id];
if (!post) return null;
return (
<div
key={p.id}
className="rounded-lg bg-surface-2 p-3"
>
<div className="mb-1 flex items-center justify-between">
<span className="text-xs font-medium uppercase text-text-muted">
{t(p.labelKey)}
</span>
<div className="flex items-center gap-2">
<CharCounter
text={post.text}
limit={p.charLimit}
/>
<CopyButton
text={post.text}
label={t("socialPost.copyCaption")}
limit={p.charLimit}
/>
</div>
</div>
<pre className="max-h-24 overflow-y-auto whitespace-pre-wrap break-words font-sans text-xs text-text-secondary">
{post.text}
</pre>
</div>
);
})}
</div>
</div>
))}
</div>
</>
)}
</div>
)}
</div>
);
}
+35
View File
@@ -44,6 +44,13 @@ export interface SettingsData {
* effect).
*/
showThirdPartyAds: boolean;
/**
* v0.24.0 opt-in toggle. When true, descriptions generated in a
* language outside the trusted set (English / Vietnamese, which are
* human-reviewed) get an AI-translation disclaimer block. Off by
* default so existing users don't see a new block after upgrade.
*/
showTranslationQuality: boolean;
/**
* When true, Output + Batch render a generated pinned-comment
* template alongside the user's freeform pinnedComment field. Default
@@ -90,6 +97,18 @@ export interface SettingsData {
* by `healSettings`.
*/
logRetentionDays: number;
/**
* v0.28.0 legal consent. The `CURRENT_TERMS_VERSION` (see
* `@config/legal`) the user last accepted on the first-run consent gate.
* `0` = never accepted → the gate shows. Bumped via `acceptLegalConsent`;
* re-shows whenever `CURRENT_TERMS_VERSION` is raised (terms changed).
* Persisted inside the existing `ytdescgen-settings` record — no cookie,
* no new storage key. A malformed value is coerced to `0` by
* {@link healSettings} so a corrupt file re-shows the gate, never skips it.
*/
legalConsentVersion: number;
/** ISO timestamp of the most recent acceptance, or `null`. Audit-only. */
legalConsentAt: string | null;
}
function detectBrowserLanguage(): SupportedLanguage {
@@ -119,6 +138,7 @@ export const initialSettings: SettingsData = {
showSponsorCredit: false,
showGameCopyright: false,
showThirdPartyAds: false,
showTranslationQuality: false,
showPinnedCommentTemplate: false,
pinnedCommentIncludeAskNextGame: true,
pinnedCommentIncludeGenrePlaylist: false,
@@ -140,6 +160,8 @@ export const initialSettings: SettingsData = {
},
sidebarCollapsed: false,
logRetentionDays: 7,
legalConsentVersion: 0,
legalConsentAt: null,
};
/**
@@ -194,5 +216,18 @@ export function healSettings(raw: unknown): SettingsData {
);
}
// v0.28.0: `legalConsentVersion` added. A non-number / non-finite / negative
// value must fall through to "never accepted" (0) so a corrupt or
// hand-edited file re-shows the consent gate rather than silently skipping
// it. (Additive — the trailing spread back-fills legacy payloads to 0.)
if (
typeof incoming.legalConsentVersion !== "number" ||
!Number.isFinite(incoming.legalConsentVersion)
) {
incoming.legalConsentVersion = initialSettings.legalConsentVersion;
} else {
incoming.legalConsentVersion = Math.max(0, Math.floor(incoming.legalConsentVersion));
}
return { ...initialSettings, ...incoming } as SettingsData;
}
+12
View File
@@ -1,6 +1,7 @@
import { create } from "zustand";
import { persist, createJSONStorage } from "zustand/middleware";
import type { SupportedLanguage } from "@engine/types";
import { CURRENT_TERMS_VERSION } from "@config/legal";
import { saveSettings, loadSettings } from "@utils/storage-adapter";
import {
healSettings,
@@ -19,6 +20,8 @@ interface SettingsState extends SettingsData {
setSetting: <K extends keyof SettingsData>(key: K, value: SettingsData[K]) => void;
setTitleFormat: (patch: Partial<TitleFormatConfig>) => void;
toggleEditorAccordion: (id: string) => void;
/** Record acceptance of the current legal terms (dismisses the consent gate). */
acceptLegalConsent: () => void;
}
const STORE_KEY = "ytdescgen-settings";
@@ -50,6 +53,12 @@ export const useSettingsStore = create<SettingsState>()(
[id]: !state.editorAccordionState[id],
},
})),
acceptLegalConsent: () =>
set({
legalConsentVersion: CURRENT_TERMS_VERSION,
legalConsentAt: new Date().toISOString(),
}),
}),
{
name: STORE_KEY,
@@ -107,6 +116,7 @@ export function extractData(state: SettingsData): SettingsData {
showSponsorCredit: state.showSponsorCredit,
showGameCopyright: state.showGameCopyright,
showThirdPartyAds: state.showThirdPartyAds,
showTranslationQuality: state.showTranslationQuality,
showPinnedCommentTemplate: state.showPinnedCommentTemplate,
pinnedCommentIncludeAskNextGame: state.pinnedCommentIncludeAskNextGame,
pinnedCommentIncludeGenrePlaylist: state.pinnedCommentIncludeGenrePlaylist,
@@ -115,6 +125,8 @@ export function extractData(state: SettingsData): SettingsData {
editorAccordionState: state.editorAccordionState,
sidebarCollapsed: state.sidebarCollapsed,
logRetentionDays: state.logRetentionDays,
legalConsentVersion: state.legalConsentVersion,
legalConsentAt: state.legalConsentAt,
};
}
+5 -2
View File
@@ -33,7 +33,8 @@ export type ExportType =
| "preset"
| "template"
| "settings"
| "history";
| "history"
| "social";
/** Versioned wrapper written by every v0.15+ export. */
export interface ExportEnvelope<T = unknown> {
@@ -62,6 +63,7 @@ export const SCHEMA_VERSIONS: Record<ExportType, number> = {
template: 1, // v0.11 vendor-coercion
settings: 10, // matches settings-store persist version
history: 2, // v0.5 added `genres[]` to HistoryEntry
social: 1, // v0.24.0 cross-post caption bundle (generated captions)
};
/**
@@ -145,7 +147,8 @@ function isExportType(value: string): value is ExportType {
value === "preset" ||
value === "template" ||
value === "settings" ||
value === "history"
value === "history" ||
value === "social"
);
}
+4 -1
View File
@@ -1 +1,4 @@
export const IS_TAURI = "__TAURI_INTERNALS__" in window;
// The `typeof` guard keeps this module importable outside a browser
// context (vitest's node environment) — no `window` means no Tauri.
export const IS_TAURI =
typeof window !== "undefined" && "__TAURI_INTERNALS__" in window;
+17
View File
@@ -79,3 +79,20 @@ export function validateRamValue(raw: string): RigValidationIssue | null {
}
return null;
}
/**
* Pick the right validator for a `composite_dropdown` rig field by id.
*
* v0.24.0 bug fix: the editor previously ran {@link validateRamValue}
* for EVERY composite field, so selecting an OS (also a composite) ran
* the RAM validator — `"windows||"` parses as size=`"windows"`, ddr=`""`,
* tripping `ramMissingDdr` ("Pick a DDR generation.") on the OS field.
* Only RAM has DDR/size semantics; the OS composite has no validator, so
* it (and any future composite) returns `null` until one is added here.
*/
export function validateCompositeField(
fieldId: string,
raw: string,
): RigValidationIssue | null {
return fieldId === "ram" ? validateRamValue(raw) : null;
}
@@ -0,0 +1,36 @@
import { describe, it, expect } from "vitest";
import { CONTENT_WARNING_GROUPS } from "@config/content-warning-groups";
import { CONTENT_WARNINGS } from "@engine/types";
/**
* Parity guard between the engine's flat CONTENT_WARNINGS union and the
* editor's CONTENT_WARNING_GROUPS. TypeScript already rejects a group item
* that isn't a valid ContentWarning, but nothing else catches an id added
* to the engine list and forgotten from every group — it would silently
* never appear in the UI. No hard counts asserted on purpose: the guard
* shouldn't need touching when warnings are added correctly.
*/
describe("CONTENT_WARNING_GROUPS ↔ CONTENT_WARNINGS parity", () => {
const grouped = CONTENT_WARNING_GROUPS.flatMap((g) => g.items);
it("contains no duplicate ids across groups", () => {
const seen = new Set<string>();
const dupes = grouped.filter((id) => {
if (seen.has(id)) return true;
seen.add(id);
return false;
});
expect(dupes).toEqual([]);
});
it("covers every engine warning id exactly (none missing, none extra)", () => {
const missingFromGroups = CONTENT_WARNINGS.filter(
(id) => !grouped.includes(id),
);
const unknownInGroups = grouped.filter(
(id) => !(CONTENT_WARNINGS as readonly string[]).includes(id),
);
expect(missingFromGroups).toEqual([]);
expect(unknownInGroups).toEqual([]);
});
});
+70
View File
@@ -0,0 +1,70 @@
import { describe, it, expect } from "vitest";
import {
ERROR_PAGES,
resolveErrorMeta,
severityTextClass,
type ErrorKind,
} from "@config/error-pages";
import enUI from "@i18n/locales/en/ui.json";
/**
* Guards for the pure error-page config that drives ErrorPage + the routes in
* App.tsx. TypeScript already enforces the kind→meta shape via `satisfies`;
* these catch what types can't: a code typo, a duplicate keyPrefix, or a
* keyPrefix with no matching i18n copy (which would render a raw key string).
* Complements `validate:locales`, which only proves key *parity* across
* locales, not that the config points at keys that exist.
*/
const KINDS: ErrorKind[] = [
"notFound",
"forbidden",
"expired",
"serverError",
"offline",
"runtime",
];
describe("ERROR_PAGES config", () => {
it("maps exactly the six known kinds", () => {
expect(Object.keys(ERROR_PAGES).sort()).toEqual([...KINDS].sort());
});
it("assigns the expected HTTP codes (null for non-HTTP states)", () => {
expect(ERROR_PAGES.notFound.code).toBe(404);
expect(ERROR_PAGES.forbidden.code).toBe(403);
expect(ERROR_PAGES.expired.code).toBe(419);
expect(ERROR_PAGES.serverError.code).toBe(500);
expect(ERROR_PAGES.offline.code).toBeNull();
expect(ERROR_PAGES.runtime.code).toBeNull();
});
it("has a unique keyPrefix per kind", () => {
const prefixes = KINDS.map((k) => ERROR_PAGES[k].keyPrefix);
expect(new Set(prefixes).size).toBe(prefixes.length);
});
it("resolveErrorMeta returns the matching entry", () => {
for (const k of KINDS) {
expect(resolveErrorMeta(k)).toBe(ERROR_PAGES[k]);
}
});
it("severityTextClass maps every severity to a text-colour token", () => {
expect(severityTextClass("danger")).toBe("text-danger");
expect(severityTextClass("warning")).toBe("text-warning");
expect(severityTextClass("accent")).toBe("text-accent");
});
it("every kind has a localized title + description in en/ui.json", () => {
const errorPages = (
enUI as unknown as {
errorPages: Record<string, { title?: string; description?: string }>;
}
).errorPages;
for (const k of KINDS) {
const prefix = ERROR_PAGES[k].keyPrefix;
expect(errorPages[prefix]?.title, `${prefix}.title`).toBeTruthy();
expect(errorPages[prefix]?.description, `${prefix}.description`).toBeTruthy();
}
});
});
+46
View File
@@ -0,0 +1,46 @@
import { describe, it, expect } from "vitest";
import { needsConsent, CURRENT_TERMS_VERSION, LEGAL_DOCS } from "@config/legal";
/**
* Guards for the pure legal config driving the v0.28.0 consent gate. The gate
* is a boot-time blocker, so the version logic must be exactly right: anything
* below the current version (or a non-number) re-shows the gate; the current
* version (or higher) lets the app through.
*/
describe("needsConsent", () => {
it("requires consent at version 0 (never accepted)", () => {
expect(needsConsent(0)).toBe(true);
});
it("requires consent below the current version (terms changed)", () => {
expect(needsConsent(CURRENT_TERMS_VERSION - 1)).toBe(true);
});
it("passes once the current version is accepted", () => {
expect(needsConsent(CURRENT_TERMS_VERSION)).toBe(false);
});
it("passes for a future stored version (never downgrades)", () => {
expect(needsConsent(CURRENT_TERMS_VERSION + 5)).toBe(false);
});
it("treats a non-number as needing consent", () => {
expect(needsConsent(undefined as unknown as number)).toBe(true);
expect(needsConsent(NaN)).toBe(true);
});
});
describe("LEGAL_DOCS", () => {
it("covers all four documents with absolute https GitHub URLs + consentGate label keys", () => {
expect(LEGAL_DOCS.map((d) => d.id)).toEqual(["terms", "privacy", "disclaimer", "license"]);
for (const doc of LEGAL_DOCS) {
expect(doc.url).toMatch(/^https:\/\/github\.com\/poli0981\/youtube-generator\/blob\/main\//);
expect(doc.labelKey).toMatch(/^consentGate\.doc/);
}
});
it("has a unique id and url per doc", () => {
expect(new Set(LEGAL_DOCS.map((d) => d.id)).size).toBe(LEGAL_DOCS.length);
expect(new Set(LEGAL_DOCS.map((d) => d.url)).size).toBe(LEGAL_DOCS.length);
});
});
+121
View File
@@ -1251,6 +1251,85 @@ describe("buildDescription — v0.7 content fields (legacy)", () => {
});
});
describe("buildDescription — v0.25.0 dialogue / internet / suggestive warnings", () => {
it("renders dialogue/language warnings (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["profanity_frequent", "drug_references"] }),
t,
);
expect(result).toContain("▸ ⚠️ CONTENT WARNINGS");
expect(result).toContain("• Frequent profanity / strong language");
expect(result).toContain("• Drug / alcohol references in dialogue");
});
it("renders internet/digital-life warnings (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["cyberbullying", "loot_boxes"] }),
t,
);
expect(result).toContain("• Cyberbullying / online harassment");
expect(result).toContain("• Loot boxes / gacha mechanics");
});
it("renders color phobias without dragging in siblings (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["erythrophobia"] }),
t,
);
expect(result).toContain("• Red / all-red scenes (erythrophobia)");
expect(result).not.toContain("(leukophobia)");
});
it("renders bilingual EN · VI for a new suggestive-imagery warning", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({ language: "vi", contentWarnings: ["sexualized_characters"] }),
t,
{ tEn },
);
expect(result).toContain(
"• Sexualized character designs · Tạo hình nhân vật bị t*nh d*c hóa",
);
});
it("masks YouTube-flag-prone Vietnamese terms on the new suggestive warnings", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
contentWarnings: [
"sexual_innuendo",
"partial_nudity",
"sexualized_characters",
],
}),
t,
{ tEn },
);
// Masked forms present (v0.21.0 asterisk precedent)
expect(result).toContain("Lời thoại ẩn ý t*nh d*c");
expect(result).toContain("Kh*a th*n một phần");
expect(result).toContain("t*nh d*c hóa");
// Unmasked flag-prone terms absent
expect(result).not.toContain("tình dục");
expect(result).not.toContain("Khỏa thân");
});
it("renders the educational/PSA-purpose disclosure (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["educational_purpose_only"] }),
t,
);
expect(result).toContain("• Educational / PSA-purpose game");
});
});
describe("buildDescription — gacha_quest video type (v0.9)", () => {
it("dispatches to the per-quest-type intro for main_story", () => {
const t = createMockT("en");
@@ -1377,6 +1456,48 @@ describe("video style era line (v0.22.0)", () => {
});
});
describe("buildDescription — translation quality notice (v0.24.0)", () => {
it("renders the bilingual notice for a non-trusted output language when enabled", () => {
const t = createMockT("ja");
const tEn = createMockT("en");
const result = buildDescription(makeInput({ language: "ja" }), t, {
showTranslationQuality: true,
tEn,
});
expect(result).toContain("ABOUT THIS TRANSLATION"); // English header via tEn
expect(result).toContain("翻訳について"); // Japanese header
expect(result).toContain("• Accuracy isn't guaranteed 100%"); // English caveat
expect(result).toContain("正確性は100%保証されません"); // Japanese caveat
});
it("is hidden for trusted output languages (en / vi) even when enabled", () => {
const tEn = createMockT("en");
const en = buildDescription(makeInput({ language: "en" }), createMockT("en"), {
showTranslationQuality: true,
tEn,
});
expect(en).not.toContain("ABOUT THIS TRANSLATION");
const vi = buildDescription(makeInput({ language: "vi" }), createMockT("vi"), {
showTranslationQuality: true,
tEn,
});
expect(vi).not.toContain("VỀ BẢN DỊCH");
expect(vi).not.toContain("ABOUT THIS TRANSLATION");
});
it("is hidden when the toggle is off", () => {
const t = createMockT("ja");
const tEn = createMockT("en");
const result = buildDescription(makeInput({ language: "ja" }), t, {
showTranslationQuality: false,
tEn,
});
expect(result).not.toContain("ABOUT THIS TRANSLATION");
expect(result).not.toContain("翻訳について");
});
});
describe("checkDescriptionWarning", () => {
it("returns null for description under limit", () => {
expect(checkDescriptionWarning("Short description")).toBeNull();
+60 -5
View File
@@ -106,11 +106,14 @@ describe("formatRigValue", () => {
expect(formatRigValue("os", "windows||home")).toBe("Windows Home");
});
it("formats version + edition when name is empty", () => {
// Defensive — name will always be Windows in v0.22.0, but the
// format function should still degrade cleanly if a future version
// omits the name.
expect(formatRigValue("os", "|10|enterprise")).toBe("10 Enterprise");
it("falls back to raw values when name is empty (v0.23.0 cascading change)", () => {
// Defensive — pre-v0.23 static OS_EDITION_OPTIONS resolved
// "enterprise" → "Enterprise" regardless of name. Post-v0.23 the
// option list cascades from name; an empty name means no option
// list applies, so the raw stored values pass through verbatim.
// A real editor session always sets name first, so this is purely
// a hand-edited / malformed-blob guard.
expect(formatRigValue("os", "|10|enterprise")).toBe("10 enterprise");
});
it("returns empty string when nothing is set", () => {
@@ -123,4 +126,56 @@ describe("formatRigValue", () => {
expect(RIG_FIELDS[0]?.type).toBe("composite_dropdown");
});
});
describe("composite_dropdown (OS cascading, v0.23.0)", () => {
it("renders macOS version-only — third slot hidden", () => {
expect(formatRigValue("os", "macos|15 Sequoia|")).toBe("macOS 15 Sequoia");
});
it("renders macOS Tahoe (the 2025 year-aligned jump)", () => {
expect(formatRigValue("os", "macos|26 Tahoe|")).toBe("macOS 26 Tahoe");
});
it("renders Linux distro + version with three visible parts", () => {
expect(formatRigValue("os", "linux|ubuntu|22.04 LTS")).toBe("Linux Ubuntu 22.04 LTS");
});
it("renders Linux rolling distros (Arch) with the placeholder version", () => {
expect(formatRigValue("os", "linux|arch|rolling")).toBe("Linux Arch rolling");
});
it("renders Linux Fedora with a numeric version", () => {
expect(formatRigValue("os", "linux|fedora|40")).toBe("Linux Fedora 40");
});
it("renders just distro name when version slot is empty", () => {
expect(formatRigValue("os", "linux|debian|")).toBe("Linux Debian");
});
it("falls back gracefully when macOS edition slot carries stale data", () => {
// Hand-edited / future-downgrade case: macOS with a third
// segment. Engine should skip it (hiddenWhen) rather than
// surfacing "macOS 15 Sequoia pro".
expect(formatRigValue("os", "macos|15 Sequoia|pro")).toBe("macOS 15 Sequoia");
});
it("preserves v0.22.0 Windows storage shape (backward-compat guard)", () => {
// Pre-v0.23 stored values must round-trip identically — this
// case validates the editor-store v13/v14 doesn't need a
// dedicated OS migration step.
expect(formatRigValue("os", "windows|11|pro")).toBe("Windows 11 Pro");
expect(formatRigValue("os", "windows|10|enterprise")).toBe("Windows 10 Enterprise");
});
});
describe("RAM composite — regression guard for v0.23.0 type widening", () => {
it("still resolves static option arrays after CompositePart.options widened to a union", () => {
// The v0.23.0 change made CompositePart.options accept either a
// static array (RAM-style) or a function (OS cascading). RAM uses
// the static form — re-running its formatter ensures the union
// didn't break the simpler path.
expect(formatRigValue("ram", "16|DDR5")).toBe("16 GB DDR5");
expect(formatRigValue("ram", "custom:48|DDR5")).toBe("48 GB DDR5");
});
});
});
+182
View File
@@ -0,0 +1,182 @@
import { describe, it, expect } from "vitest";
import {
buildSocialPost,
buildAllSocialPosts,
} from "@engine/social-post-builder";
import { SOCIAL_PLATFORMS } from "@config/social-platforms";
import { createMockT } from "../helpers/mock-t";
import type { GeneratorInput } from "@engine/types";
function makeInput(overrides: Partial<GeneratorInput> = {}): GeneratorInput {
return {
videoType: "full",
language: "en",
genres: ["action"],
gameName: "Elden Ring",
channelName: "TestChannel",
platform: "steam",
spoilerWarning: false,
matureWarning: false,
storeLinks: {},
social: {},
rig: {},
...overrides,
};
}
const baseOpts = {
charLimit: 4000,
popularHashtags: ["#fyp", "#gaming"],
};
describe("buildSocialPost", () => {
it("includes the title and the derived + popular hashtags", () => {
const t = createMockT("en");
const { text } = buildSocialPost(makeInput(), t, baseOpts);
expect(text).toContain("Elden Ring");
expect(text).toContain("#EldenRing");
expect(text).toContain("#GameplayNoCommentary");
expect(text).toContain("#action");
expect(text).toContain("#fyp");
expect(text).toContain("#gaming");
});
it("suppresses the quality badge (short-form title)", () => {
const t = createMockT("en");
const { text } = buildSocialPost(
makeInput({ resolution: "4K", fps: "120" }),
t,
baseOpts,
);
expect(text).not.toContain("[4K");
expect(text).not.toContain("120FPS");
});
it("sanitizes hashtags for special characters and snake_case genres", () => {
const t = createMockT("en");
const { text } = buildSocialPost(
makeInput({ gameName: "S.T.A.L.K.E.R. 2", genres: ["visual_novel"] }),
t,
baseOpts,
);
expect(text).toContain("#STALKER2");
expect(text).toContain("#visualnovel");
});
it("uses only the first genre for the hashtag", () => {
const t = createMockT("en");
const { text } = buildSocialPost(
makeInput({ genres: ["hack_slash", "action"] }),
t,
baseOpts,
);
expect(text).toContain("#hackslash");
expect(text).not.toContain("#action");
});
it("dedupes a popular hashtag that matches a derived one (case-insensitive)", () => {
const t = createMockT("en");
const { text } = buildSocialPost(makeInput({ genres: ["action"] }), t, {
charLimit: 4000,
popularHashtags: ["#Action", "#gaming"],
});
const matches = text.match(/#action/gi) ?? [];
expect(matches).toHaveLength(1);
});
it("includes the MY RIG block when rig fields are set", () => {
const t = createMockT("en");
const { text } = buildSocialPost(
makeInput({ rig: { ram: "16|DDR5", cpu: "Ryzen 9 7950X" } }),
t,
baseOpts,
);
expect(text).toContain("RAM: 16 GB DDR5");
expect(text).toContain("CPU: Ryzen 9 7950X");
});
it("omits the rig block when no rig fields are set", () => {
const t = createMockT("en");
const { text } = buildSocialPost(makeInput({ rig: {} }), t, baseOpts);
expect(text).not.toContain("MY RIG");
});
it("renders content warnings bilingually (vi + tEn)", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const { text } = buildSocialPost(
makeInput({ language: "vi", contentWarnings: ["flashing_lights"] }),
t,
{ ...baseOpts, tEn },
);
// `• EN · LOCAL` bullet — English label + middot separator.
expect(text).toContain("·");
expect(text.toLowerCase()).toContain("flashing");
});
it("adds the copyright line only when enabled and channelName is set", () => {
const t = createMockT("en");
const on = buildSocialPost(makeInput(), t, {
...baseOpts,
showCopyright: true,
});
expect(on.text).toContain("TestChannel");
const off = buildSocialPost(makeInput(), t, {
...baseOpts,
showCopyright: false,
});
expect(off.text).not.toContain("TestChannel");
});
it("adds the sponsor thanks only when enabled and both fields are set", () => {
const t = createMockT("en");
const on = buildSocialPost(
makeInput({ sponsorName: "Ubisoft", sponsorPlatform: "Steam" }),
t,
{ ...baseOpts, showSponsorCredit: true },
);
expect(on.text).toContain("Ubisoft");
const partial = buildSocialPost(
makeInput({ sponsorName: "Ubisoft", sponsorPlatform: "" }),
t,
{ ...baseOpts, showSponsorCredit: true },
);
expect(partial.text).not.toContain("Thanks to Ubisoft");
});
it("drops optional blocks (warnings first) to fit a tight limit, keeping title + hashtags", () => {
const t = createMockT("en");
const tEn = createMockT("en");
const result = buildSocialPost(
makeInput({
contentWarnings: ["flashing_lights", "loud_noises"],
rig: { cpu: "Ryzen 9 7950X" },
}),
t,
{ charLimit: 120, popularHashtags: ["#fyp"], showCopyright: true, tEn },
);
expect(result.droppedBlocks[0]).toBe("warnings");
expect(result.text).toContain("Elden Ring");
expect(result.text).toContain("#EldenRing");
});
it("flags isOver when even the minimal caption exceeds the limit", () => {
const t = createMockT("en");
const { isOver } = buildSocialPost(makeInput(), t, {
charLimit: 5,
popularHashtags: [],
});
expect(isOver).toBe(true);
});
});
describe("buildAllSocialPosts", () => {
it("returns one caption per platform, each carrying the game hashtag", () => {
const t = createMockT("en");
const all = buildAllSocialPosts(makeInput(), t, SOCIAL_PLATFORMS, {});
for (const p of SOCIAL_PLATFORMS) {
expect(all[p.id]).toBeDefined();
expect(all[p.id]!.text).toContain("#EldenRing");
}
});
});
+47
View File
@@ -0,0 +1,47 @@
import { describe, it, expect } from "vitest";
import i18n, { ensureLanguagesLoaded } from "@i18n/index";
import viTemplates from "../../src/i18n/locales/vi/templates.json";
/**
* v0.26 lazy-loaded locales: `en` ships in the main bundle (the engine's
* bilingual `tEn` fallback must work synchronously), every other language
* is fetched on demand via dynamic import. These tests pin both halves of
* that contract against the real i18next singleton.
*
* Order matters: the "not bundled at import time" assertion must run
* before anything calls `ensureLanguagesLoaded(["vi"])`.
*/
describe("lazy locale loading", () => {
it("bundles en eagerly and synchronously", () => {
expect(i18n.isInitialized).toBe(true);
expect(i18n.hasResourceBundle("en", "ui")).toBe(true);
expect(i18n.hasResourceBundle("en", "templates")).toBe(true);
expect(i18n.getFixedT("en", "templates")("title.suffix")).toBe(
"Gameplay No Commentary",
);
});
it("does not bundle non-English languages at import time", () => {
expect(i18n.hasResourceBundle("vi", "ui")).toBe(false);
expect(i18n.hasResourceBundle("vi", "templates")).toBe(false);
});
it("loads a language on demand and serves its real strings", async () => {
await ensureLanguagesLoaded(["vi"]);
expect(i18n.hasResourceBundle("vi", "ui")).toBe(true);
expect(i18n.hasResourceBundle("vi", "templates")).toBe(true);
const t = i18n.getFixedT("vi", "templates");
// Compare against the JSON on disk, not a hardcoded copy, so locale
// edits can't silently invalidate the test.
expect(t("title.videoType.part", { partNumber: "2" })).toBe(
viTemplates.title.videoType.part.replace("{{partNumber}}", "2"),
);
});
it("is idempotent for already-loaded and bundled languages", async () => {
await expect(
ensureLanguagesLoaded(["vi", "en"]),
).resolves.toBeUndefined();
expect(i18n.hasResourceBundle("vi", "templates")).toBe(true);
});
});
+20
View File
@@ -79,6 +79,7 @@ describe("healSettings", () => {
showUsagePolicy: true,
showSponsorCredit: true,
showThirdPartyAds: false,
showTranslationQuality: true,
titleFormat: {
badgePosition: "prefix" as const,
separator: "hyphen" as const,
@@ -91,6 +92,8 @@ describe("healSettings", () => {
editorAccordionState: { gameInfo: false, videoSettings: true },
sidebarCollapsed: true,
logRetentionDays: 14,
legalConsentVersion: 1,
legalConsentAt: "2026-06-13T00:00:00.000Z",
};
const healed = healSettings(complete);
expect(healed).toEqual(complete);
@@ -213,4 +216,21 @@ describe("healSettings", () => {
expect(healed.genrePlaylists).toEqual({});
}
});
it("back-fills legalConsentVersion 0 + legalConsentAt null for a legacy payload (pre-v0.28)", () => {
// A settings file written before the consent gate existed has neither
// key — it must heal to "never accepted" so the gate shows on first run.
const healed = healSettings({ theme: "dark" as const, hashtagCount: 3 });
expect(healed.legalConsentVersion).toBe(0);
expect(healed.legalConsentAt).toBeNull();
});
it("preserves a stored legalConsentVersion and coerces malformed/negative values to 0", () => {
expect(healSettings({ legalConsentVersion: 1 }).legalConsentVersion).toBe(1);
expect(
healSettings({ legalConsentVersion: "nope" as unknown as number }).legalConsentVersion,
).toBe(0);
expect(healSettings({ legalConsentVersion: -3 }).legalConsentVersion).toBe(0);
expect(healSettings({ legalConsentVersion: 2.9 }).legalConsentVersion).toBe(2);
});
});
+80
View File
@@ -0,0 +1,80 @@
import { describe, it, expect } from "vitest";
import {
validateRamValue,
validateGpuValue,
validateCompositeField,
} from "@utils/rig-validation";
describe("validateRamValue", () => {
it("flags a size with no DDR generation", () => {
expect(validateRamValue("32|")?.messageKey).toBe(
"editor.validation.ramMissingDdr",
);
});
it("flags a DDR generation with no size", () => {
expect(validateRamValue("|DDR5")?.messageKey).toBe(
"editor.validation.ramMissingSize",
);
});
it("flags an empty custom size", () => {
expect(validateRamValue("custom:|DDR5")?.messageKey).toBe(
"editor.validation.ramCustomEmpty",
);
});
it("passes a complete size + DDR", () => {
expect(validateRamValue("16|DDR5")).toBeNull();
});
it("passes a fully blank value (deliberate skip)", () => {
expect(validateRamValue("")).toBeNull();
});
it("passes legacy pipeless free-text", () => {
expect(validateRamValue("32GB DDR5-6000")).toBeNull();
});
});
describe("validateGpuValue", () => {
it("flags a brand with no series", () => {
expect(validateGpuValue("nvidia||")?.messageKey).toBe(
"editor.validation.gpuMissingSeries",
);
});
it("flags an empty custom GPU", () => {
expect(validateGpuValue("custom||")?.messageKey).toBe(
"editor.validation.gpuCustomEmpty",
);
});
it("passes a complete brand + series + model", () => {
expect(validateGpuValue("nvidia|rtx_40|RTX 4090")).toBeNull();
});
});
describe("validateCompositeField (v0.24.0 — per-field validator selection)", () => {
it("validates the RAM composite", () => {
expect(validateCompositeField("ram", "32|")?.messageKey).toBe(
"editor.validation.ramMissingDdr",
);
expect(validateCompositeField("ram", "16|DDR5")).toBeNull();
});
it("does NOT run the RAM validator on the OS composite (the bug)", () => {
// Regression guard: "windows||" (OS name selected, no version) parses
// as size="windows", ddr="" under the RAM parser → previously tripped
// "Pick a DDR generation." on the OS field. The OS composite has no
// validator, so every shape must return null.
expect(validateCompositeField("os", "windows||")).toBeNull();
expect(validateCompositeField("os", "macos|15 Sequoia|")).toBeNull();
expect(validateCompositeField("os", "linux|ubuntu|22.04 LTS")).toBeNull();
expect(validateCompositeField("os", "")).toBeNull();
});
it("returns null for any unknown composite id", () => {
expect(validateCompositeField("future_field", "a|b")).toBeNull();
});
});
+15 -4
View File
@@ -23,10 +23,21 @@ export default defineConfig({
build: {
rollupOptions: {
output: {
manualChunks: {
react: ["react", "react-dom"],
router: ["react-router-dom"],
i18n: ["i18next", "react-i18next"],
// Vite 8 bundles with Rolldown, which only accepts the function form of
// manualChunks (the object form is a Rollup-only API). Anchored [\\/]
// regexes keep each vendor in its own chunk without cross-matching —
// react-router* and react-i18next must not fall into the "react" chunk.
manualChunks(id) {
if (/[\\/]node_modules[\\/]react(-dom)?[\\/]/.test(id)) return "react";
if (/[\\/]node_modules[\\/]react-router(-dom)?[\\/]/.test(id))
return "router";
if (
/[\\/]node_modules[\\/](i18next|react-i18next|i18next-resources-to-backend)[\\/]/.test(
id,
)
)
return "i18n";
return undefined;
},
},
},
+1 -1
View File
@@ -11,7 +11,7 @@ The hardware reference and toolchain versions are documented in
## All platforms
- **Rust stable** via `rustup`. Tauri 2 currently tracks the latest stable.
- **Node.js ≥ 25.8.1**. Tauri-action in CI uses Node 20; locally we use ≥ 25
- **Node.js ≥ 25.8.1**. Tauri-action in CI uses Node 22; locally we use ≥ 25
so the JetBrains and VS Code dev tools have a single shared LTS.
```bash