Compare commits

...
101 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
poli0981 3019be0610 Merge pull request #77 from poli0981/claude/sharp-torvalds-dd5813
feat(v0.22.0): audio warnings, video-style era, OS rig field, drop Default Genre + Dev Env
2026-05-28 01:16:34 +07:00
poli0981andClaude Opus 4.7 6ba2acfd7e feat(v0.22.0): +12 audio warnings, video-style era toggle, OS rig field, drop Default Genre + Dev Env
Group A — Warnings expansion + UX cleanup:
- New "audio" content-warning group (12 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 from
  photosensitive into this dedicated group. Total warnings 175 → 187.
- Remove "Default Genre" from Settings (UI + state + legacy v1→v2
  migration + migration tests). `healSettings` now strips both
  `defaultGenre` and `defaultGenres` from persisted blobs.
- Remove "Dev Environment" block from About (locked hardcoded specs
  that drift on every box upgrade; their wiki link survives in repo).

Group B — Editor additions:
- Video Style era toggle (12 eras: 1980s/90s/00s/10s/20s + modern,
  cinematic, retro, vhs, film_noir, anime_mv, documentary). Combines
  with `rig.video_editor` to emit a one-line credit like
  "Edited in 1990s VHS style using DaVinci Resolve". Renders even
  when `skipGraphicsSettings` is on (2D/pixel-art creators still
  edit footage). New `src/config/video-styles.ts`; editor-store
  persist version bumped 13 → 14 (additive, defensive coercion).
- OS field in My Rig — composite_dropdown following the RAM pattern
  (name + version + edition → "Windows 11 Pro"). Windows 10/11 +
  Home/Pro/Enterprise/Education/IoT for now; macOS/Linux can be
  added later by extending the option arrays.
- `rig.os` locale key added across 6 locales (the rig.* namespace
  itself already existed — only the new field's label is new).

Locale stats (per locale): ui.json 816 → 835 keys (+19),
templates.json 473 → 487 keys (+14). 6 locales updated in parallel
(en/vi/ja/es/ko/zh).

Tests: 416 → 445 passing (+29 — audio warnings touch no test, but
new OS composite tests + new video style line tests + reworked
default-genre migration test).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 01:14:35 +07:00
poli0981 e4ba053951 Merge pull request #75 from poli0981/claude/sharp-keller-e87985
v0.21.0: +12 death-method warnings, video-vs-game copyright disclaimer, game-credit toggle, VI censoring sweep
2026-05-27 23:02:50 +07:00
poli0981andClaude Opus 4.7 58fce6d8d2 feat(v0.21.0): +12 death-method warnings, video-vs-game copyright disclaimer, game-credit toggle, VI censoring sweep
Reduces YouTube auto-flag risk on Vietnamese descriptions, adds twelve method-specific
death/violence warnings, rewords the channel copyright line to disambiguate video
content from game IP, and adds an opt-in toggle for crediting the game's studio/publisher
in the description.

- F1: VI censoring sweep — 2-tier policy (asterisk + euphemism) applied consistently
  across warning labels/templates; fixes malformed `b* ng*y h*i` and uncensored `Bạo lực`.
- F2: +12 warnings (hanging_depiction, drowning_depiction, burning_alive, ...,
  defenestration) extend group `sensitive` (49→61). Total 175→187 across 9 groups.
- F3: Channel copyright reworded 1 line → 2-3 sentence disclaimer in all 6 locales.
  JA/KO/ZH now ship proper translations (no more EN fallback).
- F4: New `showGameCopyright` setting (default off) renders `© {publisher}` line right
  after store links. `pubDevName` promoted to first-class field in GameInfoForm,
  persists in GamePreset, decoupled from publisher store URL.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 23:00:21 +07:00
poli0981 7b99f516ae Merge pull request #73 from poli0981/claude/gifted-goldberg-c7ade7
v0.20.0 — +50 content warnings (social/political/weather) + tag comma fix
2026-05-23 09:07:48 +07:00
poli0981andClaude Opus 4.7 b415d14f8b feat(v0.20.0): +50 content warnings (social/political/weather) + tag comma fix
Bundles two changes for the v0.20.0 release:

- Content warnings: +50 IDs across three thematic axes. The phobias
  group gains 10 weather-related fears (homichlophobia/fog,
  lilapsophobia/tornadoes, ombrophobia/rain, nephophobia/clouds,
  ancraophobia/wind, cryophobia/cold, heliophobia/sun, cymophobia/waves,
  limnophobia/lakes, potamophobia/rivers); 41 -> 51. The sensitive
  group gains 20 political/religion/war themes (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); 29 -> 49. A new
  social_phenomena group carries 20 psychological-social IDs that
  don't fit clinical mental-health framing (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).
  Total content warnings 125 -> 175 across 9 groups (was 8). Fully
  translated across all 6 locales. Purely additive.

- Tag generator: strip comma/semicolon/pipe from game names before
  they enter the tag list. New sanitizeForTag helper applied to
  rawName at generateTags entry and inside tagFriendlyGameName.
  Title/description/hashtag paths still read input.gameName verbatim
  so original punctuation survives for human copy. Fixes the case
  where a game like "Hello, World" produced YouTube-broken composite
  tags ("Hello, World gameplay" split at the comma).

Version bumped 0.19.0 -> 0.20.0 across all five manifests.

Pre-release gates green: lint, typecheck, validate:locales (12/12
files complete), 435 tests (+9 new for the tag fix), knip, build,
npm audit (0 vulnerabilities).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 09:06:36 +07:00
poli0981 4650273b43 Merge pull request #71 from poli0981/claude/adoring-maxwell-fd4d70
v0.19.0 — phobia warnings, dead-code sweep, scroll-to-top, audit fix
2026-05-20 20:25:41 +07:00
poli0981andClaude Opus 4.7 e691fc7c58 feat(v0.19.0): phobia warnings, dead-code sweep, scroll-to-top, audit fix
Bundles five changes for the v0.19.0 release:

- Content warnings: +28 IDs (25 clinical phobias in the phobias group,
  3 discrimination terms in the sensitive group); 97 -> 125 total,
  fully translated across all 6 locales. Purely additive.
- Dead-code sweep: add knip tooling (knip.json + npm run knip); remove
  the unused use-debounce.ts hook and ~13 unreferenced exports; tighten
  ~12 symbols to module-private.
- Security: npm audit fix for the brace-expansion moderate DoS
  (transitive dev dependency, 5.0.5 -> 5.0.6).
- UI: scroll-to-top floating button that scrolls the AppShell <main>.
- Docs: accuracy pass across TECH-SPEC, ROADMAP, FEATURES,
  CONTENT-INVENTORY (+ vi mirror), CHANGELOG, README.

Version bumped 0.18.0 -> 0.19.0 across all five manifests.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 20:23:26 +07:00
poli0981 753a286706 Merge pull request #69 from poli0981/feat/v0.18.0-vn-banks-persistence-fixes
feat(v0.18.0): Vietnamese bank dropdown + persistence/export fixes
2026-05-15 13:01:42 +07:00
poli0981andClaude Opus 4.7 494c3622ff chore(v0.18.0): bump lockfiles to match manifests
package-lock.json (root + "" packages entry) and src-tauri/Cargo.lock
(yt-desc-gen entry) were left at 0.17.1 in the main release commit.
Bumped to 0.18.0 so tauri-action's same-version check passes and the
binaries it uploads are labelled correctly. Per project-memory note
from v0.13.1 incident — version-bump ritual is six files, not three.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 13:01:19 +07:00
poli0981andClaude Opus 4.7 86927eea63 feat(v0.18.0): Vietnamese bank dropdown + persistence/export fixes
Bundles one new feature, two persistence-layer bug fixes, one cleanup,
and a transparency doc:

- feat: Vietnamese bank dropdown in VietnameseDonateEditor when output
  language is `vi`. 30 banks from the SBV 2026 list (Big 4 state-owned
  + top 22 joint-stock + 4 foreign), plus a "Khác (nhập tay)" option
  that reveals a free-form text input for unlisted banks. Persisted
  shape (`vnBankName: string`) is unchanged.
- fix: UI language reverted to English on every app relaunch because
  i18next initialised synchronously while the Zustand persist hydration
  was async and nothing bridged the persisted value back to i18n.
  App.tsx now reads `appLanguage` at mount and subscribes for future
  changes (covers both the synchronous localStorage path and the async
  Tauri settings.json path).
- fix: Settings JSON export was dumping the entire on-disk
  `settings.json` — which contains every Zustand store's data. The new
  exporter writes only the Settings store through the envelope-typed
  flow already used by the Profiles tab. Importer rejects pre-v0.18.0
  multi-store dumps with a friendly toast instead of silently injecting
  profile / template / history rows into the Settings store.
- cleanup: removed the "Open Folder" button from Settings (low usage,
  Tauri-only). The `ensure_dir` Rust command stays for other paths.
- docs: new `docs/CONTENT-INVENTORY.md` + Vietnamese mirror listing
  every video type (20), genre (41), and content warning (96 across 8
  groups) the editor surfaces. Linked from README's Documentation table.

Locale schema +2 keys × 6 locales (vnBankNameSelectPlaceholder,
vnBankNameOther). 720/720 ui keys per locale. 426/426 tests pass.
Bundle 427.46 kB (under 500 kB cap).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 12:35:25 +07:00
poli0981 fdeec0e913 Merge pull request #67 from poli0981/feat/v0.17.1-per-video-selector
v0.17.1: per-video Output preview selector
2026-05-15 00:16:36 +07:00
poli0981andClaude Opus 4.7 5df2ef8227 feat(editor): per-video Output preview selector (v0.17.1)
Closes the last deferred piece from the v0.16 ending redesign.
Multi-video ending playthroughs (case C) can now flip between
per-video previews of title / description / tags without leaving
the editor.

Key changes:

* `endingVideoIndex` joins `EditorData` (1-indexed, default 1).
  Stored on the editor so the creator's pick survives navigating
  away and back. Engine already respected the corresponding
  `GeneratorInput.endingVideoIndex` since v0.17.0 — this just
  persists it.

* "Preview video" Select dropdown in EndingsEditor case C.
  Renders `endingVideoCount` options labelled "Video N (X–Y)"
  with the matching ending-range bounds. Changing it pipes the
  index into the engine, which slices `endings[]` for both
  title (buildStructuredEndingLabel) and description
  (sliceEndingsForVideo).

* "Previewing Video X of Y — Endings A–B" banner at the top of
  Output page when in case C. Persistent reminder so a creator
  flipping through videos doesn't forget which slice they're
  looking at.

* `use-current-generator-input` forwards `endingVideoIndex` only
  when `endingVideoCount > 1` — single-video mode passes
  `undefined` so the slice helpers short-circuit to render the
  union. Keeps the input cleaner for tests.

* `EndingsEditor.setVideoCount` clamps `endingVideoIndex` down
  when the creator shrinks `endingVideoCount` (e.g. 6 → 2 with
  index = 4 → snaps to 2) so the preview never targets a
  non-existent video.

* Persist version 12 → 13 additive — `endingVideoIndex`
  back-fills to 1 on first rehydrate; pre-v0.17.1 drafts with a
  stale higher index get clamped to endingVideoCount by
  migrateEditorState.

* 3 new locale keys × 6 locales (editor.endings.videoIndexLabel,
  editor.endings.videoIndexHint, output.previewingVideo).
  718/718 ui per locale.

* 4 new tests for v12→v13 migration (default back-fill, valid
  preserved, clamp above max, clamp below 1). Total 426/426.

Bundle: index 473.91 KB (+3 KB). Under 500 KB cap.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 00:15:48 +07:00
poli0981 b8e8e476f5 Merge pull request #66 from poli0981/feat/v0.17.0-logging-and-ending-titles
v0.17.0: structured ending titles + log persistence + session UI
2026-05-14 23:49:08 +07:00
poli0981andClaude Opus 4.7 d0dd6bad12 feat(v0.17.0): structured ending titles + log persistence + session UI
Combined release: the deferred ending-title piece from v0.16.0 lands
alongside a full logging overhaul. Output titles now reflect the
filled-in endings; logs survive app restarts with session-grouped
navigation and JSON/TXT export.

## Structured ending titles

Title-builder reads `endings[]` + `endingVideoIndex` and picks the
video-type label from a four-tier resolver:

  1. Single entry         → formatEndingEntry()
                             ("Ending 3: Best End", "Ending 3", "Best End")
  2. Multi-entry, named   → comma-joined names
                             ("True End, Bad End, Hidden")
  3. Multi-entry, numbers → contiguous range via title.endingLabel.range
                             ("Endings 1–3" / "Kết thúc 1–3")
  4. Mixed / sparse       → title.endingLabel.count ("3 Endings")

Falls back to the legacy locale "Ending" label when no usable entries,
so pre-v0.16 single-ending creators see byte-identical output.

## Logging overhaul

* Persistence: new `src/utils/log-storage.ts`. Tauri writes
  append-only JSONL `{appData}/logs/ytdescgen-YYYYMMDD.jsonl` (daily
  rotation). Web caps localStorage at 5000 FIFO entries. Three new
  Tauri commands: `append_to_file`, `list_dir`, `delete_file`.
* Session grouping: `LogEntry.sessionId` (one per app boot). LogPage
  renders one collapsible block per session — current expanded,
  prior collapsed — with per-session "Clear" action.
* Export JSON (envelope) + TXT (one line per entry, chronological).
* Boot hydration via `hydrateLogStore(retentionDays)` in App.tsx.
* New setting `logRetentionDays` (default 7, clamped [1, 90]).
  Persist-store v9 → v10 additive.

## Locale & test churn

* 12 new locale keys × 6 locales; 715/715 ui, 370/370 templates.
* 14 new tests (408 → 422).

## Bundle

* index 470.51 KB (+7 KB), LogPage 8.37 KB (+3 KB). Under 500 KB cap.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 23:46:57 +07:00
poli0981 a685b050d9 Merge pull request #65 from poli0981/feat/v0.16.0-ending-redesign
v0.16.0: structured endings editor + multi-video split
2026-05-14 23:24:15 +07:00
poli0981andClaude Opus 4.7 25d4e9e148 feat(editor): structured endings + multi-video split (v0.16.0)
Replaces the freeform "Endings shown" Input in Playthrough Notes
with a structured editor that knows about ending numbers, names,
multi-video splits, and timeline cross-validation. The output
description bullet renders comma-joined structured entries with
fallback to the legacy freeform for migrated drafts.

Key changes:

* New `EndingsEditor` component with three logical cases:
  - 1 ending  → Number + Name pair with live preview
  - 2+ endings, 1 video → table row per ending + timeline gate
    (warns when timeline lacks `ending` markers for each row)
  - 2+ endings, 2+ videos → endings table + per-video range table
    with auto-contiguous balanced split (extras spill into the
    LAST video — climactic-final convention) and override support
    + inline overlap/gap/out-of-bounds warnings.

* Schema additions to `EditorData`:
  - `endings: EndingEntry[]` ({number, name})
  - `endingVideoCount: number`
  - `endingVideoRanges: EndingVideoRange[]` (1-indexed inclusive)
  - `endingsShown` kept on the type for migration round-trip but
    no longer surfaces in the UI.

* Engine `endings-format.ts` — pure helpers used by description
  builder + editor preview:
  - `formatEndingEntry` (4 cases: both / number-only / name-only
    / neither → null drop signal)
  - `sliceEndingsForVideo` (whole-array fallback when not multi-
    video / index out of range; targeted slice otherwise)
  - `clampRange`

* Timeline parser ending pattern now captures an optional ordinal
  so `Ending 3: Best End` parses into `{keyword: "ending",
  number: 3, rest: ": Best End"}`. Unblocks the case-B timeline
  gate. Renderer collapses trailing whitespace so a bare `Boss`
  no longer becomes `Boss `.

* Description builder reads structured `endings[]` first, falls
  back to legacy `endingsShown` only when the array is empty.
  Multi-row entries render comma-joined; sliced by
  `endingVideoIndex` when supplied.

* Migration `migrateEditorState` v11 → v12:
  - `liftLegacyEndingString` parses "Ending 3: Best End" /
    "Ending 3" / localised "Kết thúc N" / "エンディングN" / etc.
    into a single structured row. Unparseable strings fall
    through to a name-only row.
  - `computeContiguousRanges` builds the default video split.
  - Clamps `endingVideoCount` to `[1, endings.length]`.

* 19 new locale keys × 6 locales under `editor.endings.*`
  (705/705 keys, up from 686/686). Schema updated.

* 42 new tests (367 → 409): endings-format, editor-store
  migration, description-builder structured render, timeline-
  parser ending ordinal capture.

* Bundle: index 463.08 KB (+62 KB for new UI + engine). Under
  the 500 KB cap.

Migration notes:

* Persisted v0.12–v0.15 drafts auto-lift their `endingsShown`
  string into a single structured row on first rehydrate. The
  rendered description bullet is byte-identical for the common
  case ("True ending only" → "True ending only"). Numbered
  legacy strings ("Ending 3: Best End") gain structure so future
  edits via the new UI work seamlessly.

* Pre-v0.16 templates with `endings` missing still load — the
  TemplateSnapshot type makes all three new fields optional.

* Case C (multi-video) currently renders the union of all
  endings in the Output preview. Per-video output rendering is
  wired into the engine via `endingVideoIndex` but the UI
  selector for it lands in a follow-up patch.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 23:23:16 +07:00
poli0981 df7d734c74 Merge pull request #64 from poli0981/claude/ecstatic-blackwell-457818
v0.14.1 + v0.15.0: Windows AppData fix, Import Settings, ErrorBoundary, envelope import/export
2026-05-14 23:02:47 +07:00
poli0981andClaude Opus 4.7 8af06c425a feat(stability): ErrorBoundary + envelope import/export overhaul (v0.15.0)
Closes the "black-screen on bad file" class of bugs and gives every
JSON export an auto-detect header so users can no longer confuse
profile / preset / template files with each other.

Key changes:

* `ErrorBoundary` (new) wraps every <Route> in App.tsx plus a
  top-level boundary in main.tsx. Catches render-time exceptions
  that previously black-screened the app, surfaces a fallback UI
  with `Try again` + `Reload page` actions, and copies the error
  to the in-app Logs tab via the logger. Per-route boundaries mean
  a crash on Profiles cannot take down the Editor.

* File envelope format (`src/utils/file-schema.ts`) — every JSON
  export now writes `{ _app: "ytdescgen", _type, _schemaVersion,
  _exportedAt, data }`. The `_type` discriminator lets imports
  detect "you opened a Template file in Profiles importer" and
  offer to auto-switch tabs instead of failing silently. Legacy
  bare-array exports still import via shape detection.

* `importTypedFromJsonFile(expected)` returns a discriminated union
  with five distinct failure kinds (cancelled / read-failed / empty
  / parse-error / wrong-shape / newer-schema) so every error gets a
  targeted toast instead of a generic "Import failed".

* Black-screen root cause fix: null-guard the three-spread chain
  `TemplateCard.snapshot` → `editor-store.normalizeEditorPatch` →
  `ProfileCard.Object.values(profile.social)`. All three now treat
  null/undefined as no-ops. Store-level import validators in
  profile/preset/template stores filter rows with missing `id`
  before they hit the store, so a malformed file can't even reach
  the render path.

* 17 new unit tests in `tests/utils/file-schema.test.ts` cover the
  envelope round-trip plus every detection branch. Total 367/367
  pass.

Migration notes:

* No store schema bump. v0.14.x persisted state loads unchanged.
* Legacy bare-array export files still import via shape-detector.
  Re-export to get the envelope header + tab-switch hints.
* Envelope versions: profile=1, preset=2, template=1, settings=9,
  history=2. Bump per-type on a non-additive shape change.

Bundle: index 401 KB, ProfilesPage chunk 18.44 KB. Well under the
500 KB cap.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 23:01:37 +07:00
poli0981andClaude Opus 4.7 406d68b19e fix(desktop): Windows AppData open-folder + add Import Settings (v0.14.1)
Same-day patch on v0.14.0 closing two desktop-only papercuts.

* `openSettingsFolder()` now pre-creates the app-data directory via a
  new `ensure_dir` Tauri command before calling `openPath(dir)`. Fixes
  the first-run "Windows cannot find ... AppData\Roaming\
  com.skullmute.ytdescgen" Explorer error — `appDataDir()` only
  resolves the path string; the folder itself was being created lazily
  on the first `save_to_file` write, so users who clicked Open Folder
  before any setting had persisted hit the shell with a non-existent
  path. `exportSettingsToFile` gets the same guard.

* Adds a Settings → Import button (Tauri-only, next to Export). Reads
  via the existing `loadFile()` dialog wrapper, accepts both the
  multi-store dump shape that Export produces *and* a bare
  SettingsData payload, runs the input through `healSettings()` to
  back-fill any missing keys, then dispatches via setState. Five
  failure modes get their own toast (cancel, read-error, empty,
  parse-error, non-object). Theme class on <html> is re-applied
  directly because setState bypasses the setTheme action.

Auto-regenerated Tauri ACL schemas from local tauri-dev (incidental
Tauri-plugin minor versions; not behavioural). package-lock.json
version bump only.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 22:59:58 +07:00
poli0981 00d19202f4 Merge pull request #62 from poli0981/chore/v0.14.0-bump
chore(release): bump to v0.14.0
2026-05-14 15:54:14 +07:00
poli0981andClaude Opus 4.7 2ec146712b chore(release): bump to v0.14.0
Bumps the six manifest files per the established ritual:
- package.json
- package-lock.json (root version + "" packages entry)
- src-tauri/Cargo.toml
- src-tauri/Cargo.lock (yt-desc-gen entry only)
- src-tauri/tauri.conf.json

`@tauri-apps/api` stays at 2.11.0 (Rust tauri crate is at 2.11.x;
no minor cross-bump needed this cycle).

CHANGELOG.md gains a v0.14.0 section covering the Apache-2.0
license switch, 22 new content-warning IDs (new gameplay_disclosure
group), mobile-responsive layout, and the docs sweep. Also
backfills the missing v0.13.1 hotfix section that the v0.13.1
release-day churn never landed in CHANGELOG.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 15:52:22 +07:00
poli0981 966da96d1b Merge pull request #61 from poli0981/claude/bold-dhawan-e2a9f3
feat: v0.14 mobile responsive + content warnings + Apache-2.0 docs sweep
2026-05-14 15:49:22 +07:00
poli0981andClaude Opus 4.7 c9840c88a1 docs: rewrite README + Apache-2.0 policy set + merge dev guides
Inventory:
- README.md: full rewrite (~200 lines) per docs_guide.txt - badges,
  features, Use Cases (esp. horror gameplay), Privacy section,
  doc table, AI disclosure, channel/socials block (from username.txt).
- CLAUDE.md: license MIT -> Apache-2.0, project-structure tree
  updated (PRD removed, DEVELOPMENT added).

New root policy docs (per docs_guide.txt):
- SECURITY.md: private disclosure, response timeline.
- CONTRIBUTING.md: PR process, validate:locales gate, auto-ignore
  rules (malicious code = ban, off-topic rambling rejected, etc.).
- CODE_OF_CONDUCT.md: brief + Contributor Covenant 2.1 link.
- PRIVACY.md: offline-first, localStorage keys listed, GDPR/CCPA
  via clear-storage. Tauri app-data paths use the actual identifier
  `com.skullmute.ytdescgen` from tauri.conf.json.
- DISCLAIMER.md: AI-assistance disclosure (Claude Opus 4.7 1M
  context), translation-quality table (VI native, JA/ES/KO/ZH AI).
- TERMS.md: Apache-2.0 + GitHub ToS + GDPR/CCPA/PIPL/LGPD/VN
  Cybersecurity Law compliance, generated-content responsibility.
- THIRD_PARTY_NOTICES.md: full dep table (npm + Cargo) with
  versions and licenses, plus AI-Assisted Development Disclosure.
- MAINTAINERS.md: @poli0981 only.
- .github/PULL_REQUEST_TEMPLATE.md: checklist + AI-disclosure box.

New docs/:
- DEVELOPMENT.md (EN): merges deleted pc_spec.md + dev_env.md.
  Covers toolchain, JetBrains 2026.x + VS Code, build commands,
  Tauri prerequisites per OS, troubleshooting.
- i18n/vi/DEVELOPMENT.md, i18n/vi/DISCLAIMER.md: Vietnamese
  mirrors with AI-translation header note.

Deleted (consolidated into DEVELOPMENT or no longer relevant):
- docs/PRD.md (V1.0 from 2026-04-07, shipped already)
- docs/pc_spec.md + dev_env.md (merged)
- docs/i18n/vi/pc_spec.md + dev_env.md (merged)

Cross-link fixes:
- src/pages/AboutPage.tsx: comment now points to DEVELOPMENT.md.
- src/config/about.ts: license string MIT -> Apache-2.0; pcSpecDocUrl
  and devEnvDocUrl preserved by name (for layout compat) but now
  point to DEVELOPMENT.md (EN) and i18n/vi/DEVELOPMENT.md (VI).
- webapp/TAURI.md: cross-links updated to DEVELOPMENT.md.

Verification:
- npm run typecheck: clean.
- npm run lint: clean.
- Grep PRD.md|pc_spec|dev_env in repo: no stale doc references.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 15:47:33 +07:00
poli0981andClaude Opus 4.7 e6e49d329a feat(mobile): responsive layout + drawer + iOS-safe touch sizing
Web build was usable on desktop only - the editor layout flipped
to two-column at `lg` (1024px), the sidebar had no mobile drawer,
inputs lacked keyboard hints, and `text-sm` triggered iOS Safari
focus zoom (Safari zooms when font-size < 16px).

Changes:
- tailwind.config.ts: add theme.extend.spacing.touch = 44px (iOS HIG
  minimum), exposed via min-h-touch utility.
- New src/components/ui/Drawer.tsx (~80 LOC): slide-in overlay,
  body-scroll lock, Esc + tap-outside close, safe-area-inset padding.
  Reuses Modal.tsx's overlay/Esc patterns; not its centered layout.
- Sidebar.tsx: extract `<SidebarNavList>` for drawer reuse. Outer
  `<aside>` gated `hidden md:flex`.
- AppShell.tsx: wire `mobileNavOpen` state + render `<Drawer>` with
  SidebarNavList inside.
- Header.tsx: add Menu hamburger (md:hidden) wired to drawer,
  `pt-[max(0.75rem,env(safe-area-inset-top))]` for iOS notch,
  donate icon-only below md, dropdown width
  `min-w-[200px] max-w-[calc(100vw-2rem)]` so it never overflows
  at 360px.
- Button/Input/Textarea/ValidatedInput: bump heights to min-h-touch
  (sm size at min-h-[36px] iOS minimum), add `text-base sm:text-sm`
  to inputs to defeat iOS Safari focus zoom.
- EditorPage.tsx: responsive padding gap-6 p-6 lg:flex-row ->
  gap-4 p-3 sm:p-4 md:gap-6 md:p-6 lg:flex-row. Sticky preview
  wrapper sticky top-6 -> lg:sticky lg:top-6 so mobile portrait
  doesn't lock the preview.
- OutputPreview.tsx: description scroll-box max-h-[400px] ->
  max-h-[60vh] sm:max-h-[400px].
- CopyAllBar.tsx: pb safe-area-inset-bottom for iOS home indicator,
  responsive button class compaction.
- GameInfoForm.tsx + ValidatedInput call sites: autoComplete /
  enterKeyHint / inputMode hints so iOS shows the right keyboard
  (URL/email for the validated URL+email fields).

Tested with `npm run typecheck` (clean), `npm run lint` (clean),
`npm run test:run` (350/350 pass), `npm run build` (1.81s, bundle
443.55 KB raw / 136.55 KB gzip - under 500 KB cap).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 15:46:52 +07:00
poli0981andClaude Opus 4.7 bd2660e73a feat(engine): add 22 content-warning IDs across 8 groups (69 -> 91)
Expands the content-warning vocabulary toward horror-channel staples
that the existing 7-group list lacked. Adds a new 8th group
`gameplay_disclosure` for transparency about non-vanilla play.

New IDs by group:
- Phobias (+3): coulrophobia, ablutophobia, taphophobia
- Photosensitive (+2): strobe_effects, screen_shake_intense
- Mental Health (+3): paranoia_themes, intrusive_thoughts, medical_horror
- Sensitive (+3): human_experimentation, cannibalism, nuclear_themes
- Horror-Specific (+5): liminal_spaces, analog_horror, unreality_themes,
  pursuit_chase, entity_horror
- Playstyle (+2): first_time_playing, returning_player
- Gameplay Disclosure (NEW +4): mods_used, cheats_enabled,
  glitch_exploits, assisted_run

Updates src/engine/types.ts CONTENT_WARNINGS array, the UI grouping
config, the locale validator schema, and all 6 locales x 2 files
(templates.json + ui.json). EN and VI authored directly; JA/ES/KO/ZH
AI-translated with disclosure documented in DISCLAIMER.md.

`npm run validate:locales` passes at 686/686 ui + 368/368 templates
across all 6 locales. Engine logic in description-builder.ts is
unchanged - the loop already renders content warnings in user
selection order regardless of count.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 15:46:17 +07:00
poli0981andClaude Opus 4.7 f7ebd1f078 chore: switch project to Apache-2.0
Adds canonical Apache License 2.0 text as LICENSE, NOTICE asserting
copyright + AI-assisted-dev disclosure, and the `license` field on
both package.json (npm) and src-tauri/Cargo.toml (Cargo).

Repository previously claimed MIT in README/CLAUDE.md without an
actual LICENSE file. Apache-2.0 was selected for the patent grant
and NOTICE pattern; see docs_guide.txt requirement.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 15:45:16 +07:00
poli0981 4e64d5a25a Merge pull request #59 from poli0981/fix/tauri-api-version-2.11
fix(deps): bump @tauri-apps/api 2.10.1 → 2.11.0 to match Rust crate
2026-05-11 22:32:12 +07:00
poli0981andClaude Opus 4.7 a0d20617e2 fix(deps): bump @tauri-apps/api 2.10.1 → 2.11.0 to match Rust tauri 2.11.1
The v0.13.1 rebuild failed because tauri-action's same-minor-version check
caught:

    tauri (v2.11.1) : @tauri-apps/api (v2.10.1)

Dependabot's PR #51 bumped the Rust `tauri` crate to 2.11.1 but left the
npm `@tauri-apps/api` package at 2.10.1 (different ecosystem, separate
alert). The constraint `^2.0.0` allowed 2.10.x → 2.11.x but npm doesn't
auto-bump within range; needs explicit `npm install @tauri-apps/api@^2.11.0`.

The four plugin pairs were already aligned (plugin-dialog/fs/opener/shell
Rust crate versions match their npm counterparts exactly), so no other
bumps needed.

Side effect of `npm install`: package.json deps were alphabetized — that's
npm's default key-ordering on save.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 22:31:21 +07:00
poli0981 43c77c99d4 Merge pull request #58 from poli0981/chore/bump-tauri-manifests-0.13.1
chore(release): bump src-tauri manifests to 0.13.1 (recover from v0.13.1 release miss)
2026-05-11 22:11:43 +07:00
poli0981andClaude Opus 4.7 14bb517a9a chore(release): bump src-tauri manifests to 0.13.1 (missed in v0.13.1 hotfix)
When PR #50 shipped the v0.13.1 hotfix, only `package.json` got bumped from
0.13.0 → 0.13.1; the Tauri-side manifests stayed on 0.13.0. As a result the
release-desktop run on the v0.13.1 tag built binaries as 0.13.0 and the
tauri-action uploaded them to the existing v0.13.0 release object, leaving
the v0.13.1 tag without a release on GitHub.

This commit closes the gap by bumping all three Tauri-side files:
- src-tauri/Cargo.toml
- src-tauri/tauri.conf.json
- src-tauri/Cargo.lock (yt-desc-gen entry)

Recovery follow-up after merge:
1. Force-move the v0.13.1 tag from d1cc099 to this merge commit
2. Re-run release-desktop on v0.13.1 (will pick up correct version)
3. Re-run release-desktop with workflow_dispatch input `tag: v0.13.0` to
   restore the original v0.13.0 release binaries (which were clobbered)

The repo's version-bump checklist already documents this (5-file ritual:
package.json, package-lock.json, src-tauri/Cargo.toml, src-tauri/Cargo.lock
yt-desc-gen entry, src-tauri/tauri.conf.json) — see project memory note on
the v0.9.0 lockfile-bump miss.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 22:11:00 +07:00
poli0981 0b9dfcb0e6 Merge pull request #57 from poli0981/deps/cargo-rand-0.8.6
chore(deps): bump rand 0.8.5 → 0.8.6 in src-tauri/Cargo.lock
2026-05-11 22:04:18 +07:00
poli0981andClaude Opus 4.7 404efa9a92 chore(deps): bump rand 0.8.5 → 0.8.6 in src-tauri/Cargo.lock
Clears the upgradeable half of the rand Dependabot alert (GHSA-c275-2vrh-rmmc,
unsoundness with custom loggers using rand::rng()). Transitive update only —
no Cargo.toml change.

The other `rand 0.7.3` copy in the lockfile (deeply nested as
phf_codegen → selectors → kuchikiki → tauri-utils build-dependency) cannot
be bumped without a major upstream change in tauri-utils, and is build-only
(used by phf_codegen for hash-table seed generation — no runtime exposure).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 22:03:35 +07:00
poli0981 63212ef4b6 Merge pull request #56 from poli0981/deps/vite-7-security-fix
chore(deps): bump vite 5 → 7 + vitest 2 → 3 to clear security alerts
2026-05-11 21:58:12 +07:00
poli0981andClaude Opus 4.7 abb0a624d5 chore(deps): bump vite 5 → 7 and vitest 2 → 3 to clear security alerts
Resolves Dependabot alerts:
- vite (GHSA-4w7w-66w2-5vf9, path traversal in optimized deps .map handling,
  patched in 6.4.2 — jumping to vite 7 covers it cleanly)
- esbuild (GHSA-67mh-4wv8-2f99, dev server CORS allows arbitrary origins,
  pulled transitively via vite 7 / vitest 3)

Dependabot's own PR #54 tried to bump vite to 8 but broke `npm ci` because
@vitejs/plugin-react@4.7.0 caps at vite 7 in its peer-dep range. This bumps
to the latest vite/vitest pair that plugin-react still supports.

Both deps are dev-scope only — no runtime impact on shipped artifacts.
- npm run typecheck — clean
- npm run lint — clean
- npm run test:run — 350/350 pass on vitest 3.2.4
- npm run validate:locales — 663 ui + 346 templates × 6 locales
- npm run build — clean, main bundle 426 KB raw / 133 KB gzip
  (vite 7 default chunking runs a bit looser than vite 5's; still well under
  the 500 KB CLAUDE.md budget)

No version bump — dev deps don't appear in the shipped artifact.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 21:57:11 +07:00
poli0981 6fb476f7a5 Merge pull request #52 from poli0981/dependabot/npm_and_yarn/postcss-8.5.14
chore(deps-dev): bump postcss from 8.5.8 to 8.5.14
2026-05-11 21:50:30 +07:00
poli0981 9a6aafb173 Merge pull request #51 from poli0981/dependabot/cargo/src-tauri/tauri-2.11.1
chore(deps): bump tauri from 2.10.3 to 2.11.1 in /src-tauri
2026-05-11 21:50:22 +07:00
poli0981 d1cc09918b Merge pull request #50 from poli0981/claude/peaceful-morse-316568
feat(v0.13.1): workflows + donate/dev surfaces + SEO + horror warnings
2026-05-11 21:31:59 +07:00
dependabot[bot] d5c0b2439f chore(deps-dev): bump postcss from 8.5.8 to 8.5.14
Bumps [postcss](https://github.com/postcss/postcss) from 8.5.8 to 8.5.14.
- [Release notes](https://github.com/postcss/postcss/releases)
- [Changelog](https://github.com/postcss/postcss/blob/main/CHANGELOG.md)
- [Commits](https://github.com/postcss/postcss/compare/8.5.8...8.5.14)

---
updated-dependencies:
- dependency-name: postcss
  dependency-version: 8.5.14
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-05-11 14:31:50 +00:00
dependabot[bot] 760c2090ca chore(deps): bump tauri from 2.10.3 to 2.11.1 in /src-tauri
Bumps [tauri](https://github.com/tauri-apps/tauri) from 2.10.3 to 2.11.1.
- [Release notes](https://github.com/tauri-apps/tauri/releases)
- [Commits](https://github.com/tauri-apps/tauri/compare/tauri-v2.10.3...tauri-v2.11.1)

---
updated-dependencies:
- dependency-name: tauri
  dependency-version: 2.11.1
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-05-11 14:31:48 +00:00
poli0981andClaude Opus 4.7 ebb819eec9 feat(v0.13.1): hotfix bundle — workflows, donate/dev surfaces, SEO, horror warnings
- workflows: narrow notify-* triggers to specific producer names so non-matching
  workflow_run events don't instantiate a run (kills the Actions tab Skipped spam)
- workflows: auto-link each published release to a GitHub Discussion under
  Announcements via a new link-discussion job before the Discord announce
- repo: add FUNDING.yml + ISSUE_TEMPLATE/{config,bug_report,feature_request}.yml
- docs: add docs/pc_spec.md, docs/dev_env.md (+ VI mirrors) and webapp/TAURI.md
- about: restructure AboutPage with Donate / Dev Environment sections, expanded
  socials (Bluesky, Mastodon, Steam, Telegram bot+user, email, game Discord);
  Ko-fi / Patreon moved from ABOUT.socials to new @config/donate
- header: persistent Donate button (Ko-fi) left of the language switcher
- sidebar: external Report Bug item linking directly to the bug_report template
- seo: full <head> metadata (description, OG, Twitter card, JSON-LD
  WebApplication, 6 locale alternates), per-route useDocumentTitle hook applied
  to all 9 pages, robots.txt, sitemap.xml, manifest.webmanifest, placeholder
  favicon.svg
- warnings: new "horror_specific" group with 7 IDs (eye_horror, body_horror,
  face_horror, cosmic_horror, extreme_gore, decay_rot, mutilation), localized
  to en/vi/ja/es/ko/zh in both ui.json and templates.json

Additive only — no breaking changes to the engine, store schema, or persisted
content-warning IDs. _schema.json updated to reflect new keys.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 21:30:39 +07:00
poli0981 b4919d6075 Refactor announce-release workflow by removing unnecessary steps and comments 2026-05-09 01:21:39 +07:00
poli0981 3ebf3e0843 Delete .github/scripts directory 2026-05-09 00:54:34 +07:00
poli0981 c4c65d8195 Update notify-release-pipeline.yml 2026-05-09 00:50:44 +07:00
poli0981 191985d218 Refactor Discord deploy notification workflow 2026-05-09 00:48:54 +07:00
poli0981 49c0206744 Refactor CI failure notification workflow 2026-05-09 00:48:12 +07:00
poli0981 92c453ab3c up 2026-05-08 20:59:56 +07:00
poli0981 cacb1df694 deploy notify 2026-05-08 20:32:50 +07:00
poli0981 d039378862 feat: enhance discord notification helper with phase 2 commands and improved webhook handling 2026-05-08 20:11:20 +07:00
poli0981 a325a5b44e feat: add discord notification workflow 2026-05-08 18:24:54 +07:00
poli0981 6fd209e85c Merge pull request #49 from poli0981/claude/practical-davinci-ba15f8
v0.13.0: Gacha enhancements, GPU/RAM dropdowns, copy guard, locked window
2026-05-08 12:46:01 +07:00
poli0981andClaude Opus 4.7 fa3ce87f61 feat(v0.13): structured Gacha fields, GPU/RAM dropdowns, copy guard, locked window
Bug fixes:
- AppShell layout reflow (h-screen overflow-hidden) so the main pane
  scrolls without dragging the sidebar/header along
- Tauri window locked at 1100x750 (resizable=false, maximizable=false)

Gacha-quest editor:
- Anniversary year dropdown (1-20) replaces chapterName for anniversary type;
  templates render "{{anniversaryYear}}{{ordinalSuffix}} Anniversary"
- Showcase swaps Chapter/Quest/Part for characterName input;
  description matches user-requested phrasing including {{versionLabel}}
- New gachaVersion field (e.g. "1.2", "2.4"), surfaces in Gacha-specific
  intros via description.intro.versionInline; distinct from the existing
  versionInfo (driver / general game version)
- Smart placeholder per Quest Type (Day 12, Floor 12, Part 1, etc.) so
  the inputs hint at the right shape per quest pattern
- Per-quest-type field visibility map controls which inputs render

My Rig editor:
- Cascading GPU dropdown (Brand -> Series -> Model) with ~200+ models
  across NVIDIA, AMD, Intel Arc, Apple Silicon + free-text Custom brand
- Composite RAM input (size dropdown 4-256GB + custom numeric, paired
  with DDR1-DDR7 dropdown). Output: "16 GB DDR5" / "48 GB DDR5"
- formatRigValue extended for both new types; legacy free-text passes
  through unchanged so v0.12 profiles render identically
- Inline validation badges for incomplete selections (brand without
  model, RAM size without DDR, custom numeric empty)

Content warnings:
- 27 new entries: 5 phobias (cynophobia, nyctophobia, pyrophobia,
  pediophobia, hemophobia), 4 mental health (bipolar, ocd, panic,
  dissociation), 5 sensitive (hate_speech, historical_atrocity,
  slavery, terrorism, bullying)
- New "Playstyle disclosures" group (8 items): blind_playthrough,
  no_spoilers_chat, casual/hardcore difficulty, permadeath,
  speedrun_attempt, completionist_run, learning_mechanics

Copy validation:
- useClipboard().copy(text, { limit, fieldLabel }) refuses to write
  when text exceeds the limit; toast warning surfaces the count
- CopyButton renders with text-danger style and warning icon when
  over-limit so the lock state is visible before clicking
- CopyAllBar pre-validates Title and Description; combined error toast
  if either is over

Storage:
- Editor store v10 -> v11 migration: adds characterName, anniversaryYear,
  gachaVersion with safe defaults; out-of-range anniversaryYear coerces
  to null
- Storage stays Record<string, string> for rig (pipe-delimited tuples)
  so no rig migration needed

i18n:
- 6 locales (en/es/ja/ko/vi/zh) updated with new keys; schema validated
- 629 ui keys + 339 templates keys per locale
- ordinal suffix helper drops the English suffix for non-English locales
  so "周年記念" / "주년" / "Aniversario" don't get "st/nd/rd/th"

Tests: 350/350 (was 335)
- 11 new rig-fields tests (cascading + composite + legacy passthrough)
- 4 new v10 -> v11 migration tests
- Anniversary title test updated to use anniversaryYear

Bundle: 373 KB raw / 125 KB gzipped, under the 500 KB target.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-08 12:42:25 +07:00
poli0981 25f0d0705f Merge pull request #48 from poli0981/claude/hotfix-v0.12.1
fix(v0.12.1): hotfix — editor → engine pipeline drops v0.12 fields
2026-05-06 19:27:08 +07:00
poli0981andClaude Opus 4.7 3f0622ac23 fix(v0.12.1): editor → engine pipeline drops v0.12 fields
The v0.12.0 release added six new editor fields (endingsShown,
languagePatch + custom, gameVersion + custom, techNotes) but the field
mapping in src/hooks/use-current-generator-input.ts wasn't kept in sync.
Symptom: ticking a Tech Notes checkbox or filling Playthrough Notes
fields updated the editor state but never reached the description
preview, because the hook silently dropped them. The v0.12.0 unit tests
passed because they fed GeneratorInput to the engine directly,
bypassing the hook.

Also fixes the parallel TemplateSaveForm.tsx omission — saving as
template lost the same six fields, so loading a template later didn't
restore them.

Refactors the hook so the field-mapping is a pure exported helper
(buildGeneratorInputFromEditor) testable without React. Replaces the
50-entry useMemo deps list with [state, languageOverride] — the old
list was the silent-drop footgun. Adds a parity-guard test that fails
loud if any future EditorData field is added without surfacing it in
GeneratorInput.

EditorData is now \`export interface\` so the helper can reference it.
package-lock.json catches up to v0.12.x (was stuck at v0.11.0 since
the v0.12.0 PR forgot it). Test count: 335/335 (was 329/329).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 19:26:08 +07:00
poli0981 fa4c0534f4 Merge pull request #47 from poli0981/claude/practical-dewdney-af38cf
feat(v0.12): single-instance fix, Playthrough Notes, Tech Notes
2026-05-06 18:31:35 +07:00
poli0981andClaude Opus 4.7 d94e6ac024 feat(v0.12): single-instance Tauri fix, unified Playthrough Notes block, Tech Notes checklist
Fixes the duplicate-tray-icon / orphan-process bug on desktop by registering
tauri-plugin-single-instance in src-tauri/src/lib.rs — second launches refocus
the existing window instead of spawning a fresh process.

Replaces the v0.7 standalone "🎯 Playthrough" line + "🎮 DIFFICULTY" block with
a unified ▸ 🎮 PLAYTHROUGH NOTES section (Run type, Difficulty, Endings shown,
Language patch, Game version) — three new structured fields piggyback on the
existing playthroughStatus + difficulty data, keeping the editor-store v9→v10
migration purely additive. A new ▸ 🛠 TECH NOTES bilingual checklist (24 items
across 5 groups) sits next to Content Warnings for production / playstyle
disclaimers, mirroring the v0.11 CW render pattern.

All 6 locales updated; 14 new description-builder tests + 9 new migration
tests; bundle 345 KB raw / 116 KB gzip (under the 500 KB constraint).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 18:29:43 +07:00
poli0981 a1ba3e5ba0 Merge pull request #46 from poli0981/claude/zen-lamport-2b5352
feat(v0.11): vendor graphics, third-party ads, bilingual content warnings
2026-05-06 16:17:42 +07:00
poli0981andClaude Opus 4.7 4d974bbfc6 feat(v0.11): vendor-aware graphics, third-party ads block, bilingual content-warning checklist
Three independent v0.11 features in one PR:

- Vendor-aware upscaling & frame-gen options. NVIDIA exposes DLAA + 4
  quality bins and goes to x4 multi-frame-gen; AMD keeps FSR Native AA
  and caps at x3; Intel adds XeSS Ultra Quality and ships only x2.
  Description-builder uses vendor-keyed full labels ("NVIDIA DLAA",
  "AMD FSR Quality", "Intel XeSS Ultra Quality") so DLAA reads
  correctly without double-prefixing. Stale combos coerce to "none"
  on rehydrate (editor / template stores) and on profile / preset /
  template loads via normalizeEditorPatch.

- Third-party advertising block. New `showThirdPartyAds` toggle in
  Settings → Description renders a "🤝 SPONSORS & PARTNERS" section
  driven by a per-profile `thirdPartyAdText` Textarea. Multi-line
  preserved verbatim. Block gated on toggle ON AND text non-empty;
  the SettingsPage shows an inline hint pointing to Profiles → Edit
  when the toggle's on but the field's blank.

- Content-warning overhaul. Replaces the v0.7 WarningToggles (2
  booleans + 3-item checklist) with ContentWarningChecklist —
  searchable, collapsible-grouped checkboxes covering 44 items
  across Spoilers / Photosensitive / Phobias / Mental health /
  Mature & Sensitive. Description renders a unified bilingual block:
  "▸ ⚠️ CONTENT WARNINGS / CẢNH BÁO NỘI DUNG" header (bilingual
  when output language ≠ English), two-line intro, bullets paired
  via U+00B7 MIDDLE DOT (`• EN · local`). Vietnamese labels apply
  asterisk masking on YouTube-ToS-prone terms (`t* tử`,
  `x*m h*i t*nh d*c`, `g*ết người`); other locales use clinical
  wording. Selection order preserved.

Migrations:
- editor-store v8 → v9 (legacy boolean → checklist + ad text +
  vendor coercion).
- settings-store v8 → v9 (showThirdPartyAds default false).
- profile-store unversioned → v1 (thirdPartyAdText back-fill).
- template-store unversioned → v1 (vendor coercion on snapshots).

Verification:
- typecheck / lint / validate:locales clean.
- 310 / 310 tests green (9 new cases for vendor labels, bilingual
  rendering, censoring, ads gating, multi-line preservation, and
  selection order).
- Production build succeeds; main chunk 313 KB (under the 500 KB
  bundle constraint in CLAUDE.md).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 16:15:28 +07:00
poli0981andClaude Opus 4.7 da0efc6b88 chore: update version to 0.10.0 (#45)
Bumps the four release manifests that PR #44 didn't touch (package.json
itself was bumped inside that PR):
- src-tauri/tauri.conf.json
- src-tauri/Cargo.toml
- src-tauri/Cargo.lock (yt-desc-gen entry)
- package-lock.json

Also backfills CHANGELOG.md with the v0.10.0 section covering the three
features that landed via PR #44 — Pub/Dev Name → tag, GitHub Pages
white-page hotfix, and the vertical sidebar + About page.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 09:45:37 +07:00
poli0981andClaude Opus 4.7 58d7a94ca7 feat(v0.10): Pub/Dev tag, GH Pages base-path fix, vertical sidebar + About page (#44)
* fix(deploy): correct GH Pages base path to /youtube-generator/

The deployed site at https://poli0981.github.io/youtube-generator/ was
serving a blank page because Vite's base was hardcoded to /yt-desc-gen/
(an old project name). Every asset request 404'd.

The actual GitHub repo is poli0981/youtube-generator, confirmed by the
Pages deploy log: "Evaluated environment url: https://poli0981.github.io/youtube-generator/".
Aligning the Vite base unblocks the live web build.

Also adds an empty public/.nojekyll so Vite copies it into dist/ —
defensive against future bundle filenames Jekyll might skip.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(editor): add Pub/Dev Name field that emits a YouTube tag

When the Publisher / Developer site URL is filled in, a free-text
"Pub/Dev Name" input now appears underneath. Whatever the user types
becomes a bare YouTube tag (e.g. "Ubisoft", "FromSoftware") via the
tag generator — so SEO-relevant publisher names enter the tag pool
without inflating the description.

The new field is independent from the existing sponsorName/sponsorPlatform
pair, which still drive the description's "🎁 Thanks to …" line — that
flow is unchanged. Different semantic, different output.

- Schema bumped to v8 with an additive migration (empty-string default).
- Tag generator gates on a non-empty trim, reuses tagFriendlyGameName
  for the 30-char per-tag limit, and lets the existing dedup pass
  collapse case-insensitive duplicates against any future tag source.
- All 6 locales (en/vi/ja/es/ko/zh) translated; validate:locales clean.
- 4 new tag-generator tests cover emission, empty/whitespace skip,
  dedup vs sponsorName, and over-long truncation.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(v0.10): vertical collapsible sidebar + About page

Reworks the app shell from a horizontal top tab bar into a vertical
sidebar with a hamburger collapse toggle, and adds a new /about route
with app metadata, third-party credits, and configurable social links.

Sidebar
- TabBar.tsx renamed to Sidebar.tsx (vertical NavLink list, lucide
  PanelLeftClose / PanelLeftOpen, w-56 ↔ w-14 width transition).
- AppShell switched from `flex flex-col` to a left-sidebar / right-pane
  layout; Header stays at the top of the right pane.
- Collapsed state persisted via a new `sidebarCollapsed` field in the
  settings store (v7 → v8, additive — healSettings back-fills the
  default through the existing initialSettings spread).
- Ctrl+B toggles the sidebar (VS Code convention); shortcut surfaced
  in the keyboard help cheatsheet.

About page
- New `/about` lazy route. Page reads from a new `src/config/about.ts`
  (app name, version pulled live from package.json, repo + issues +
  author + license URLs, and placeholder social URLs that hide their
  rows when blank). YouTube channel left blank with a TODO marker —
  fill in before tagging the v0.10 release.
- Third-party credits sourced from a new `src/config/third-party.ts`
  with versions read from package.json deps so npm installs keep the
  list honest. License + project URL hardcoded.

i18n
- All 6 locales (en/vi/ja/es/ko/zh) updated with `tabs.about`, the
  new `sidebar.{expand,collapse}` block, the full `about.*` namespace
  including `about.socials.*`, and `shortcuts.toggleSidebar`.
  validate:locales clean at 448/448 keys.

Version bumped to 0.10.0. shadcn/ui evaluated and skipped — would have
forced a 10+ component retrofit and a token-system swap for one feature.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore(about): fill in social links (YouTube/X/Discord/Ko-fi/Patreon)

Replaces the TODO placeholders with the channel's actual URLs so the
About page's Connect section renders all five rows. Empty entries
would have hidden silently — wiring the real links is what the page
was waiting on before the v0.10 release.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 09:33:56 +07:00
poli0981 606f3109a1 fix(ci): skip macOS DMG bundling, drop macos-13, add workflow_dispatch (#43)
Three CI release fixes against the v0.9.0 first run.

(1) macos-14 (ARM) failed in the DMG bundler:
    `failed to run bundle_dmg.sh`

    Tauri's DMG bundler runs an AppleScript via `osascript` to set
    icon positions in the mounted DMG window. On hosted macOS runners
    the headless display + sandboxing causes that AppleScript to
    flake intermittently — known issue tracked in tauri-action.
    Workaround: build only the `.app` bundle (`--bundles app`).
    tauri-action tar.gzips the `.app` directory into a
    `.app.tar.gz` upload. End user expands the archive and drags
    the `.app` into /Applications.

(2) macos-13 (Intel) job sat in the queue 2h11m before being
    cancelled. The `macos-13` free runner pool has been progressively
    deprecated through 2025; jobs frequently never start. Drop the
    matrix entry. Intel macOS users have no CI binary for now —
    revisit by switching the macos-14 entry to
    `universal-apple-darwin` if Intel support becomes a priority.

(3) Add `workflow_dispatch` with a `tag` input so the workflow can be
    re-run manually against a previously-shipped tag without deleting
    + recreating it. `actions/checkout@v4` honours the input ref;
    `tauri-action` honours the `tagName` input. This is the recovery
    path for v0.9.0's missing macOS binary: after this fix merges,
    `gh workflow run release-desktop.yml --ref main -f tag=v0.9.0`
    rebuilds with the patched workflow against the v0.9.0 commit and
    uploads to the existing draft release.

Matrix is now three platforms — Windows, macOS ARM, Linux. PACKAGING.md
docs reflect the change with explicit notes on the macOS choices.
2026-05-03 12:01:48 +07:00
poli0981 9a9c51d2f5 Merge remote-tracking branch 'origin/main' 2026-05-03 09:12:11 +07:00
poli0981 fa3f8ed8ec chore: update version to 0.9.0 in package-lock.json 2026-05-03 09:11:50 +07:00
poli0981 1553a128f9 chore: update version to 0.9.0 (#42)
Bumps package.json, src-tauri/tauri.conf.json, src-tauri/Cargo.toml,
and the yt-desc-gen entry in src-tauri/Cargo.lock from 0.8.1 to 0.9.0.

CHANGELOG.md gets a v0.9.0 section covering the three feature PRs that
shipped on main this release: #37 (Phase 1 B2 — URL extractors +
name-mismatch banner), #40 (Phase 1 B1 — gacha_quest video type with
17 quest patterns), #41 (Phase 2 — QoL trio + multi-platform release
matrix). 297 tests green, main bundle 270 KB, 428 ui + 203 template
keys per locale.
2026-05-03 09:08:13 +07:00
poli0981 c8e75d7211 feat(v0.9-phase2): QoL trio + multi-platform release matrix (#41)
B3 — QoL trio:

(a) Cheatsheet modal — bare `?` key now opens the existing
ShortcutHelpModal (Ctrl+/ still works). The `?` handler skips firing
when the keydown target is an INPUT / TEXTAREA / SELECT / contentEditable
element so it doesn't hijack normal text entry. The modal grows a
search input that live-filters by translated label OR by the literal
key combo string (so "ctrl" finds every Ctrl-binding). Filter resets
on close.

(b) Genre search filter — GenreSelector now renders a search input
above the chip group. Live substring match (case-insensitive) on the
translated chip label. Empty query renders all 41 genres; empty result
set shows a localised "no matching genres" line in place of the chip
row.

(c) Bulk-toggle — three buttons above the chip group: "All RPGs", "All
Shooters", "All Horror". Clicking REPLACES the current selection with
the first MAX_GENRES (3) ids from the matching GENRE_GROUPS list — so
the cap is preserved end-to-end. Filter clears on bulk-toggle so the
new chips are always visible. Group registry lives in
src/config/genres.ts as a typed Record<GenreGroupId, readonly GenreId[]>.

i18n: 7 new keys/locale (4 in shortcuts/editor + 3 in
editor.genreGroups). All 6 locales fully translated. 428 ui keys/locale
(up from 421).

B4 — Multi-platform release matrix:

.github/workflows/release-desktop.yml grows from a Windows-only build
to a 4-entry matrix: windows-latest, macos-13 (Intel), macos-14 (ARM),
ubuntu-latest. fail-fast: false so one platform breaking doesn't
cancel the others. Each runner builds for its explicit
--target triple. Linux runner installs libwebkit2gtk-4.1-dev,
libgtk-3-dev, libayatana-appindicator3-dev, librsvg2-dev, and patchelf
(Tauri's webview + AppImage tooling).

tauri-action@v0 collects all artifacts onto a single draft GitHub
Release named "YTDescGen v__VERSION__". No code signing (open-source
project, recurring cert cost not justified) — users see the standard
unverified-publisher prompts on first launch. No git-cliff
auto-changelog; release notes come from the tag message.

Pre-workflow tags v0.8.0 and v0.8.1 will need a one-time manual
`gh release create` if multi-platform binaries are desired
retroactively. Documented in docs/PACKAGING.md.

CI: typecheck/lint clean. 297 tests pass. validate:locales 428/428 ui
+ 203/203 templates per locale. Main bundle 270 KB (≤500 KB gate).
2026-05-03 08:54:25 +07:00
poli0981 09989c6aca feat(v0.9-phase1-b1): gacha_quest video type with 17 quest patterns (#40)
Adds a first-class video type for gacha-game playthroughs. Covers the
quest taxonomy across major titles (Genshin, HSR, Wuthering Waves, ZZZ,
Honkai Impact 3rd, Reverse 1999, Nikke, Azur Lane, Granblue, …) where
the typical video is a quest-by-quest run with structured chapter /
event / side-quest metadata.

New config in src/config/gacha-quest-types.ts:
- GACHA_QUEST_TYPES: 17 literals grouped by use case
  (story / events / tutorial-trial / endgame-multiplayer / showcase)
- GACHA_QUEST_TYPE_GROUPS: display-order grouping for the dropdown
- GACHA_PART_SUFFIX_STYLES: per-quest-type partNumber style — main_story
  uses "Part N", anniversary + daily_commission use "Day N", endgame
  uses "Floor N", every other quest type drops the suffix.

GeneratorInput grows three optional fields: gachaQuestType (the enum),
chapterName (free-form chapter / story-arc label), questName (free-form
event / side-quest name). partNumber is reused as-is.

Engine wiring:
- title-builder.buildTitle dispatches on videoType === "gacha_quest" to
  the per-quest-type i18n template (`title.gachaQuestType.<id>`). The
  template already embeds gameName + chapterName / questName + the
  optional partSuffix; the standard `title.suffix` ("Gameplay No
  Commentary") still tails the result, and the quality badge respects
  badgePosition. Empty `videoTypeLabel` means a non-default badge in
  "middle" position lands as its own segment, matching the v0.6
  behaviour for `full` 4K runs.
- New helper `buildGachaPartSuffix(questType, partNumber, t)` resolves
  `title.gachaPartSuffix.{part|day|floor}` based on the per-type style.
- description-builder routes the intro through
  `description.intro.gacha_quest_<questType>` (17 distinct openings)
  while every other videoType keeps its flat key.
- tag-generator gets one shared gacha pool — quest-type-specific tags
  would balloon the pool and rarely surface in YouTube search.

UI (ExtraFieldsInput.tsx) renders a native <select> with <optgroup>
headers for the 5 quest groups, plus chapterName + questName inputs.
ExtraFields list for `gacha_quest` is
[gachaQuestType, chapterName, questName, partNumber].

Stores:
- editor-store v6 → v7: additive migration. Pre-v0.9 drafts get
  gachaQuestType="main_story", chapterName="", questName="".
- TemplateSnapshot adds the three fields as optional so legacy
  templates load cleanly via `loadProfile`'s spread.
- TemplateSaveForm + use-current-generator-input capture the new
  fields end-to-end.

i18n: 67 new keys per locale (28 ui + 39 templates). All 6 locales now
carry 421 ui + 203 template keys. en + vi fully translated; ja/es/ko/zh
seeded with English placeholders per the v0.8 polish convention.

17 new tests across title + description + part-suffix engine paths.
297 total pass. Main bundle 266 KB (≤500 KB gate).
2026-05-03 08:33:20 +07:00
poli0981 0f7a16b32b feat(v0.9-phase1-b2): Epic / Nintendo / Humble URL extractors + name-mismatch banner (#37)
Adds four new storefront extractors to PLATFORM_NAME_EXTRACTORS:

- Epic: store.epicgames.com/<locale>/p/<slug>[-<6+-hex hash>]
- Nintendo US: nintendo.com/us/store/products/<slug>[-switch[-2]]
- Nintendo EU: nintendo.com/<locale>/Games/<segment>/<slug>[-<id>].html
- Humble: humblebundle.com/store/<slug>

PlayStation, Xbox, and Amazon Luna stay unsupported — their canonical
URLs use opaque product IDs rather than name slugs. Existing Steam,
itch.io, and GOG extractors are unchanged.

New isLinkNameMismatch(gameName, url) helper applies a subset-tolerant
token comparison: the link's tokens must all appear in the typed Game
Name. Apostrophes are stripped (not spaced) so Marvel's tokenises to
marvels and matches Steam slugs like Marvels_Spider-Man_Remastered
verbatim. Returns false when the URL is unsupported or either side is
empty.

StoreLinkEditor surfaces a reactive banner above the platform grid when
any filled link points at a game name whose tokens aren't a subset of
the user's Game Name. Iteration order follows PLATFORMS; dismissed
fingerprints (gameName|url pairs) are skipped so a chain of mismatches
surfaces one at a time.

i18n: 2 new keys per locale (editor.warning.linkNameMismatch and
common.dismiss). 393 ui keys per locale, fully translated in all 6
languages.

27 new tests across all 4 extractors and the mismatch helper. 280 total
pass. Main bundle 242 KB (≤500 KB gate).
2026-05-03 07:52:40 +07:00
poli0981andClaude Opus 4.7 50bbaccee9 fix(v0.8.1): accept bare youtube.com + extra query params in playlist validator (#36)
* fix(v0.8.1): accept bare youtube.com + extra query params in playlist URL validator

The strict v0.8 regex required `www.youtube.com` and rejected any extra
query params after `list=`. Real YouTube share URLs often emit either
the bare `youtube.com` host or `&si=…`/`&pp=…` tracking suffixes, both
of which silently failed validation. ValidatedInput then called
`onChange("")` and wiped the entry from the settings store before the
user noticed — making the v0.8 phase 2 genre-playlist suggestion
feature look like it just didn't work.

The relaxed regex now accepts:
* optional `www.` (host can be `youtube.com` or `www.youtube.com`)
* `list=…` at any position in the query string, with sibling params
  before AND/OR after
* a trailing `#fragment`

`watch?v=…` URLs and `youtu.be/…` short links remain rejected because
the path must be exactly `/playlist`. 4 new tests cover the relaxed
shapes (no-www, `&si=` suffix, list= after another param, fragment).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: update version to 0.8.1

Patch release bumping all four manifest files.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(changelog): backfill v0.8.0 + add v0.8.1 entries

CHANGELOG.md was last updated for v0.7.0 — adds the v0.8.0 release
notes (PRs #32 / #33 / #34 / #35) and the v0.8.1 patch.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 23:38:38 +07:00
200 changed files with 25063 additions and 2559 deletions

No files matched your search

+6
View File
@@ -0,0 +1,6 @@
github: poli0981
ko_fi: skullmute
buy_me_a_coffee: skullmute
patreon: skullmute
custom:
- paypal.me/DungDang212
+99
View File
@@ -0,0 +1,99 @@
name: Bug report
description: Something is broken or behaving unexpectedly.
title: "[Bug]: "
labels: ["bug", "triage"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to file a bug. Please fill in as much detail as you can —
a clear reproduction is the difference between a fix today and a fix in 3 weeks.
- type: input
id: version
attributes:
label: App version
description: From the About page or the title bar. Example `v0.13.0`.
placeholder: v0.13.0
validations:
required: true
- type: dropdown
id: surface
attributes:
label: Where are you running YTDescGen?
options:
- Web (GitHub Pages)
- Desktop — Windows (Tauri)
- Desktop — macOS (Tauri)
- Desktop — Linux (Tauri)
- Local dev (npm run dev)
validations:
required: true
- type: input
id: os
attributes:
label: Operating system
description: e.g. Windows 11 25H2, macOS 14.6, Ubuntu 24.04
validations:
required: true
- type: input
id: browser
attributes:
label: Browser (web only)
description: e.g. Chrome 131, Brave 1.70, Safari 17. Leave blank for desktop.
- type: dropdown
id: language
attributes:
label: App language at the time of the bug
options:
- English (en)
- Tiếng Việt (vi)
- 日本語 (ja)
- Español (es)
- 한국어 (ko)
- 中文 (zh)
validations:
required: true
- type: textarea
id: repro
attributes:
label: Steps to reproduce
description: Numbered steps. Include the exact inputs that triggered the bug.
placeholder: |
1. Open Editor
2. Pick genre "Survival Horror"
3. Toggle "eye_horror" warning
4. Click Generate
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior
validations:
required: true
- type: textarea
id: console
attributes:
label: Console / log output
description: Open DevTools (web) or the log panel (desktop) and paste any errors. Rendered as code.
render: shell
- type: textarea
id: screenshots
attributes:
label: Screenshots / screen recording (optional)
description: Drag and drop images or videos here.
- type: checkboxes
id: checks
attributes:
label: Pre-flight checks
options:
- label: I searched existing issues and this is not a duplicate.
required: true
- label: I'm on the latest released version (or noted my older version above).
required: true
+8
View File
@@ -0,0 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: Discord — General chat
url: https://discord.gg/2aNR3aVt
about: For casual questions, gameplay chat, or quick help. Use a bug report or feature request for anything actionable.
- name: GitHub Discussions
url: https://github.com/poli0981/youtube-generator/discussions
about: Ideas, Q&A, and release announcements live here.
@@ -0,0 +1,48 @@
name: Feature request
description: Suggest a new feature or improvement.
title: "[Feature]: "
labels: ["enhancement", "triage"]
body:
- type: textarea
id: problem
attributes:
label: Problem
description: What pain point or workflow gap are you running into today?
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed solution
description: What should YTDescGen do? Be concrete — UI sketch, example output, etc.
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: Other approaches you thought about and why you ruled them out.
- type: dropdown
id: scope
attributes:
label: Scope
description: Which surfaces does this affect?
multiple: true
options:
- Editor
- Output / preview
- Profiles / presets
- Templates (description, title, tags)
- i18n / locales
- Settings
- Desktop (Tauri)
- Documentation
validations:
required: true
- type: checkboxes
id: checks
attributes:
label: Pre-flight checks
options:
- label: I searched existing issues and this is not a duplicate.
required: true
+47
View File
@@ -0,0 +1,47 @@
## Summary
<!-- 1-3 bullet points describing the change -->
-
-
## Type
- [ ] `feat` — new feature
- [ ] `fix` — bug fix
- [ ] `refactor` — code change with no behavior change
- [ ] `docs` — documentation only
- [ ] `test` — tests only
- [ ] `ci` — CI / build pipeline
- [ ] `chore` — other
## Checklist
- [ ] `npm run typecheck` passes
- [ ] `npm run lint` passes
- [ ] `npm run validate:locales` passes (required if you touched `src/i18n/locales/` or `_schema.json`)
- [ ] `npm run test:run` passes
- [ ] No secrets, credentials, or PII committed
- [ ] No new runtime dependencies without prior discussion in an issue
- [ ] Commit messages follow `type(scope): message`
## UI Changes
<!--
If this PR touches the UI, attach screenshots or short recordings at:
- Desktop (≥1024px)
- Tablet (768px)
- Mobile (390px)
Otherwise delete this section.
-->
## AI-Assisted Contribution
- [ ] Yes — AI tool used: <!-- e.g. Claude Code 4.7 Opus, Cursor, GitHub Copilot -->
- [ ] No
If yes: did you review every line of generated code/text yourself before submitting? <!-- yes/no -->
## Related Issues
<!-- Fixes #123, Closes #456 -->
+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"
+41
View File
@@ -0,0 +1,41 @@
name: Announce Release to Discord
on:
release:
types: [published]
workflow_dispatch:
inputs:
tag:
description: "Existing release tag to re-announce"
required: true
type: string
# `link-discussion` needs `contents: write` (to edit the release) and
# `discussions: write` (so GitHub auto-creates the linked Discussion under
# the configured category). The reusable announce job only needs read.
permissions:
contents: write
discussions: write
jobs:
link-discussion:
runs-on: ubuntu-latest
steps:
- name: Link release to Announcements discussion
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# Setting --discussion-category on a published release causes
# GitHub to auto-create the linked Discussion. Requires the
# repo to have Discussions enabled with an "Announcements"
# category (configured manually under repo Settings).
run: |
gh release edit "${{ github.event.release.tag_name || inputs.tag }}" \
--repo "${{ github.repository }}" \
--discussion-category "Announcements"
announce:
needs: link-discussion
uses: poli0981/.github/.github/workflows/announce-release.yml@main
with:
tag_override: ${{ inputs.tag || '' }}
secrets: inherit
+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
+19
View File
@@ -0,0 +1,19 @@
name: Notify CI Failures
on:
workflow_run:
# Match the exact `name:` of the CI workflow (.github/workflows/ci.yml).
# Renaming CI silently breaks this filter — keep them in sync.
workflows: ["CI"]
types: [completed]
# REQUIRED: declare permissions matching the reusable workflow's needs.
# Reusable needs `actions: read` to inspect workflow_run details.
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-ci-failure.yml@main
secrets: inherit
+18
View File
@@ -0,0 +1,18 @@
name: Notify Deploy Status
on:
workflow_run:
# Match the exact `name:` of the deploy workflow
# (.github/workflows/deploy-web.yml). Renaming it silently breaks this
# filter — keep them in sync.
workflows: ["Deploy to GitHub Pages"]
types: [completed]
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-deploy.yml@main
secrets: inherit
@@ -0,0 +1,18 @@
name: Notify Release Pipeline
on:
workflow_run:
# Match the exact `name:` of the release-pipeline producers
# (release-desktop.yml + announce-release.yml). Renaming either silently
# breaks this filter — keep them in sync.
workflows: ["Release Desktop", "Announce Release to Discord"]
types: [completed]
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-release-pipeline.yml@main
secrets: inherit
+64 -5
View File
@@ -3,6 +3,16 @@ name: Release Desktop
on:
push:
tags: ["v*"]
# Manual re-run hook — lets us rebuild a release without deleting +
# recreating the tag. Useful when a transient runner failure (e.g.
# the macOS DMG bundler hitting an AppleScript flake) costs us one
# arch's binary on an otherwise-shipped tag.
workflow_dispatch:
inputs:
tag:
description: "Tag to build (e.g. v0.9.0). The job still expects the manifests to already carry this version."
required: true
type: string
permissions:
contents: write
@@ -10,26 +20,75 @@ permissions:
jobs:
build:
strategy:
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.
bundleArgs: ""
- os: macos-14
target: aarch64-apple-darwin
# macOS DMG bundling on hosted runners flakes inside
# `bundle_dmg.sh` (the AppleScript that sets icon
# positions in the DMG window times out on the headless
# runner). Build only the `.app` bundle; tauri-action
# tar.gzips it into a `.app.tar.gz` for upload. Users
# expand and drag-drop into /Applications.
#
# Intel macOS (x86_64) is NOT built — the `macos-13`
# free runner queue is functionally unavailable since
# GitHub started deprecating it. Revisit with a
# `universal-apple-darwin` build on this same runner if
# Intel support becomes a priority.
bundleArgs: "--bundles app"
- os: ubuntu-latest
target: x86_64-unknown-linux-gnu
# Default Linux bundles: AppImage + deb. Both ship.
bundleArgs: ""
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
with:
node-version: 20
# 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@v6
with:
node-version: 22
cache: npm
- uses: dtolnay/rust-toolchain@stable
with:
targets: ${{ matrix.target }}
- name: Install Linux dependencies
if: matrix.os == 'ubuntu-latest'
run: |
sudo apt-get update
sudo apt-get install -y \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
patchelf
- run: npm ci
- 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: v__VERSION__
releaseName: "YTDescGen v__VERSION__"
tagName: ${{ github.event.inputs.tag || 'v__VERSION__' }}
releaseName: "YTDescGen ${{ github.event.inputs.tag || 'v__VERSION__' }}"
releaseBody: "See the assets to download the installer for your platform."
releaseDraft: true
args: ${{ matrix.bundleArgs }} --target ${{ matrix.target }}
+928
View File
@@ -2,6 +2,934 @@
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
method-specific death/violence warnings, rewords the channel copyright
line to disambiguate video content from game IP, and adds an opt-in
toggle for crediting the game's studio/publisher in the description.
### Added
- **12 new content warnings** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)). Extends the **Sensitive** group with method-specific death/violence depictions that YouTube's auto-moderation flags harder than the umbrella `blood_gore` / `war_violence` labels: `hanging_depiction`, `drowning_depiction`, `burning_alive`, `asphyxiation_depiction`, `restraint_torture`, `public_execution`, `decapitation`, `impalement`, `mass_casualty_event`, `vehicular_violence`, `overdose_depiction`, `defenestration`. Total content warnings 175 → 187 across the existing 9 groups. 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. VI labels follow the v0.21.0 censoring policy (see below).
- **Game-copyright toggle** ([src/store/settings-heal.ts](src/store/settings-heal.ts) `showGameCopyright`, [src/engine/description-builder.ts](src/engine/description-builder.ts) section 4.5, [src/pages/SettingsPage.tsx](src/pages/SettingsPage.tsx)). New Settings → Description toggle (default **off**) that, when enabled with a non-empty `pubDevName`, emits a `© {publisher}. All rights reserved.` line right after the Store Links block. Decoupled from the publisher store-URL — the credit renders based on the studio name alone. Used by creators covering games whose dev/publisher contractually requires attribution in the description. New i18n key `description.sections.gameCopyright` across all 6 locales; new UI keys `settings.showGameCopyright` + `settings.showGameCopyrightHint`. Persists in `GamePreset` so a series spanning many episodes hydrates the studio name + toggle together on preset apply.
- **`pubDevName` promoted to first-class field** ([src/components/editor/GameInfoForm.tsx](src/components/editor/GameInfoForm.tsx), [src/store/preset-store.ts](src/store/preset-store.ts) `GamePreset.pubDevName?`). Previously a side-label that only appeared under a non-empty Publisher store URL; now an always-visible "Studio / Publisher" input in Game Info that also drives the game-copyright section. Removed from [StoreLinkEditor.tsx](src/components/editor/StoreLinkEditor.tsx) lines 140–172. Optional in `GamePreset` so older presets hydrate without breaking.
### Changed
- **Channel copyright line reworded across 6 locales** ([src/i18n/locales/*/templates.json](src/i18n/locales/) `description.sections.copyright`). Old: `© {year} {channelName}. All rights reserved.` (one short line, ambiguous about whether the channel claims the game's IP). New: a 2–3 sentence disclaimer making explicit that the copyright applies only to the video recording, and that the game, characters, music, and related IP belong to their respective owners. Same `{{year}}` / `{{channelName}}` placeholders — no engine change. JA/KO/ZH now ship a proper localised translation instead of falling back to English.
- **VI censoring sweep — consistency + euphemism policy** ([src/i18n/locales/vi/ui.json](src/i18n/locales/vi/ui.json), [src/i18n/locales/vi/templates.json](src/i18n/locales/vi/templates.json)). The Vietnamese warning labels previously used asterisk censoring on some terms (`t* tử`, `b*o h*nh`, `g*ết người`) but left others uncensored (`Bạo lực liên quan chiến tranh`, `Bạo lực từ cảnh sát`) and had a malformed `b* ng*y h*i` for `child_harm`. Sweep unifies them under a 2-tier policy: asterisk for graphic verbs with no natural euphemism (`tự` → `t*`, `giết` → `g*ết`, `treo cổ` → `treo c*`, `bạo hành` → `b*o h*nh`), euphemism for words with a natural softer register (`bạo lực` → `tác động vật lý`, `nổ súng` → `khai hỏa`, `xử bắn` → `hành quyết`). Fixes `child_harm` to use the unambiguous euphemism `chịu tác động`. Proper nouns (game titles, character names) untouched. Goal is to reduce YouTube auto-flag risk on Vietnamese descriptions — purely a static i18n edit, no runtime utility.
### Under the hood
- Persist version unchanged — `showGameCopyright` is additive (`healSettings` back-fills via `{ ...initialSettings, ...incoming }`) and `pubDevName` / `showGameCopyright` on `GamePreset` are optional. No migration step needed.
- Description-builder section ordering: Store Links → **Game Copyright (new)** → Video Settings → … → Channel Copyright. The two `©` lines (channel + game) are intentional when both toggles are on; the Settings help text is explicit so creators don't mistake it for a bug.
- Three test fixtures updated for the new wording / censoring / settings shape ([tests/engine/description-builder.test.ts](tests/engine/description-builder.test.ts), [tests/store/settings-heal.test.ts](tests/store/settings-heal.test.ts)). 435 tests still green.
- Five manifests bumped 0.20.0 → 0.21.0 (`package.json`, `src-tauri/Cargo.toml`, `src-tauri/Cargo.lock` `yt-desc-gen` entry, `src-tauri/tauri.conf.json`).
- Pre-release gates run green: lint, typecheck, validate:locales (12/12 files complete, 814 ui + 461 template keys), 435 tests, build.
## v0.20.0 — 2026-05-23
Fifty new content-warning IDs across three thematic axes — political /
religion / war, social-psychological phenomena (autism, hikikomori,
parasocial, etc.), and weather-related phobias — plus a tag-engine fix
for game names containing comma / semicolon / pipe characters.
### Added
- **50 new content warnings** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)). The **Phobias** group gains 10 weather-related fears — `homichlophobia` (fog), `lilapsophobia` (tornadoes / hurricanes), `ombrophobia` (heavy rain), `nephophobia` (clouds), `ancraophobia` (strong wind), `cryophobia` (extreme cold, distinct from `chionophobia`/snow), `heliophobia` (sunlight), `cymophobia` (large waves), `limnophobia` (lakes), `potamophobia` (rivers); 41 → 51. The **Sensitive** group gains 20 political / religious / war themes — `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`; 29 → 49. A new **Social phenomena** group (inserted between *Mental health* and *Sensitive*) carries 20 psychological-social IDs that don't fit clinical mental-health framing — `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`. Total content warnings 125 → 175 across 9 groups (was 8). Purely additive — engine renders each warning automatically; existing profiles / templates round-trip unchanged. Fully translated across all 6 locales (`ui.json` short labels + `templates.json` description phrases) with `_schema.json` updated.
- **1 new locale key × 6 locales**: `editor.contentWarningGroups.social_phenomena` (the new group's heading). Initial-collapse default set in [ContentWarningChecklist.tsx](src/components/editor/ContentWarningChecklist.tsx) so the 20-item group stays scannable until expanded.
### Fixed
- **Tag generator splitting at commas / semicolons / pipes in game names** ([src/engine/tag-generator.ts](src/engine/tag-generator.ts)). YouTube treats `,` as a tag delimiter, so a game title like `Hello, World` previously produced composite tags such as `Hello, World gameplay` that YouTube split into two broken tags (`Hello` + `World gameplay`). New `sanitizeForTag` helper strips `,` `;` `|` from the game name before it enters bare / composite tags and is also called inside `tagFriendlyGameName` (idempotent). Title / description / hashtag paths still read `input.gameName` verbatim — the original punctuation is preserved for human-facing copy, only the tag list is cleaned. Nine new test cases in [tests/engine/tag-generator.test.ts](tests/engine/tag-generator.test.ts) cover the comma / semicolon / pipe paths plus idempotence.
### Under the hood
- **Documentation count sweep.** `README.md` content-warning total bumped 125 → 175 and group count 8 → 9; `docs/CONTENT-INVENTORY.md` heading updated, three group sections regenerated (Phobias 41 → 51, Sensitive 29 → 49, new Social phenomena 20), Vietnamese mirror at `docs/i18n/vi/CONTENT-INVENTORY.md` kept in lock-step.
- Persist version unchanged — this release adds no new persisted fields. Existing `contentWarnings: ContentWarning[]` profiles widen the allowed enum but reject nothing.
- Five manifests bumped 0.19.0 → 0.20.0 (`package.json`, `package-lock.json` root + self-reference, `src-tauri/Cargo.toml`, `src-tauri/Cargo.lock` `yt-desc-gen` entry, `src-tauri/tauri.conf.json`).
- Pre-release gates run green: lint, typecheck, validate:locales (12/12 files complete), 435 tests, knip, build, `npm audit` (zero vulnerabilities).
## v0.19.0 — 2026-05-20
Twenty-eight new content-warning IDs (twenty-five clinical phobias plus
three discrimination themes) + a scroll-to-top button + a moderate-severity
security patch + a dead-code sweep backed by new `knip` tooling + a
documentation accuracy pass.
### Added
- **28 new content warnings** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)). The **Phobias** group gains 25 clinically-recognised fears relevant to gameplay / horror content — automatonophobia (animatronics), megalophobia (giant objects), submechanophobia (submerged man-made objects), necrophobia, spectrophobia, demonophobia, selachophobia (sharks), mysophobia, emetophobia, scopophobia, monophobia, musophobia, chiroptophobia, ornithophobia, ichthyophobia, herpetophobia, katsaridaphobia, apiphobia, astraphobia, agoraphobia, enochlophobia, chionophobia, nosocomephobia, aichmophobia, pnigophobia — 16 → 41. The **Sensitive** group gains 3 bigotry-content warnings — `homophobia`, `transphobia`, `xenophobia` — placed next to `discrimination` / `hate_speech`. These are prejudices, not involuntary fear responses, so they are deliberately kept out of the Phobias group. Total content warnings 97 → 125. Purely additive — the engine auto-renders each warning, no persist migration. Fully translated across all 6 locales (`ui.json` short labels + `templates.json` description phrases) with `_schema.json` updated.
- **Scroll-to-top button** ([src/components/layout/ScrollToTopButton.tsx](src/components/layout/ScrollToTopButton.tsx)). A floating up-arrow fixed to the bottom-right of the viewport that fades in once the page is scrolled past 300 px and smooth-scrolls back on click. The scroll target is the `<main>` element — the app's real scroll container, not `window` — which `AppShell` now passes down as a ref. Honors `prefers-reduced-motion`, uses a 44 px touch target with a focus ring, sits at `z-40` so toasts render above it, and re-checks visibility on route change. New `common.scrollToTop` locale key across all 6 locales.
- **`knip` dead-code tooling** ([knip.json](knip.json) + `npm run knip`). Authoritative cross-file detection of unused files, exports, and dependencies — coverage TypeScript strict mode (in-file only) cannot provide. Configured so `scripts/` and `tests/` are recognised entry points.
### Fixed
- **`brace-expansion` moderate-severity DoS** ([advisory GHSA-jxxr-4gwj-5jf2](https://github.com/advisories/GHSA-jxxr-4gwj-5jf2)). `npm audit fix` bumped the transitive dependency (reached through `@typescript-eslint`) 5.0.5 → 5.0.6. A dev/lint-time dependency only — no effect on shipped web or desktop binaries. `npm audit` now reports zero vulnerabilities.
### Removed
- **Dead-code sweep** (knip-driven). Deleted the unused `use-debounce.ts` hook plus ~13 unreferenced exports across config / engine / store / utils (`findGpuSeries`, `formatSingleEndingForTitle`, `PlaylistOutput`, `loadFile`, `exportToJsonFile`, `importFromJsonFile`, `EnglishTranslationFn`, `PlatformId`, `SocialFieldId`, `SocialCategory`, `VietnameseBank`, `RigFieldId`, `SupportedLanguageId`). A further ~12 symbols were tightened from `export` to module-private and the settings layer's redundant type re-exports were trimmed. No behaviour change — all 426 tests still pass.
### Under the hood
- **Documentation accuracy pass.** `TECH-SPEC.md` package version (`0.1.0` → `0.19.0`) and CI Node version (`20` → `22`); `ROADMAP.md` corrected a never-built `TabBar` component reference to `Sidebar`; `FEATURES.md` video-type / genre / language counts refreshed, with the stale duplicate tables replaced by links to `CONTENT-INVENTORY.md` (the maintained source of truth); `CONTENT-INVENTORY.md` and its Vietnamese mirror updated for the new warning counts; `README.md` content-warning count corrected (91 → 125).
- Persist version unchanged — this release adds no new persisted fields.
- Five dependencies knip flagged as unused are intentionally kept and listed under `knip.json` `ignoreDependencies`: the three Tauri plugin packages cannot be safely verified without a desktop build, and `@testing-library/*` is documented test infrastructure.
## v0.18.0 — 2026-05-15
Vietnamese-bank dropdown for the donate form + two persistence-layer
bug fixes (UI language reverting to English after relaunch, Settings
export bundling unrelated stores) + one cleanup (Open Folder button
removed) + a new content-inventory documentation page (EN + VI).
### Added
- **Vietnamese bank dropdown** in `VietnameseDonateEditor` ([src/components/editor/VietnameseDonateEditor.tsx](src/components/editor/VietnameseDonateEditor.tsx), [src/config/vietnamese-banks.ts](src/config/vietnamese-banks.ts)). When the output language is Vietnamese, the "Bank name" field upgrades from a plain text input to a `<Select>` listing 30 of Vietnam's most-used banks (Big 4 state-owned + top 22 joint-stock commercial banks by retail presence + 4 foreign banks with the strongest Vietnam footprint). Sourced from the State Bank of Vietnam's 2026 register via [bankervn.com](https://bankervn.com/danh-sach-ngan-hang/). Picking "Khác (nhập tay)" reveals an inline text input so unlisted / digital-only / regional banks still work. Persisted shape is unchanged — `vnBankName` stays a plain string — so saved profiles and exports round-trip cleanly. When the output language is not Vietnamese, the field falls back to the legacy text input.
- **`docs/CONTENT-INVENTORY.md`** + **Vietnamese mirror** ([docs/i18n/vi/CONTENT-INVENTORY.md](docs/i18n/vi/CONTENT-INVENTORY.md)). Static, hand-maintained manifest of every video type (20), game genre (41), and content warning (96 across 8 groups) the editor surfaces. Linked from the main `README.md` Documentation table. Transparency aid for anyone evaluating the editor's coverage without reading source.
- **2 new locale keys × 6 locales**: `editor.vnBankNameSelectPlaceholder`, `editor.vnBankNameOther`. Localised for VI; left in English for JA/KO/ZH/ES to match the existing convention for VN-donate fields. Schema (`src/i18n/locales/_schema.json`) updated accordingly.
### Fixed
- **UI language reverts to English after app relaunch** ([src/App.tsx](src/App.tsx)). i18next initialises synchronously with `fallbackLng: "en"` while Zustand's persist middleware rehydrates `appLanguage` either synchronously (localStorage) or asynchronously (Tauri `settings.json`). Neither path bridged the persisted value back to i18n, so the UI rendered English even when the saved setting was Vietnamese / Japanese / etc. App.tsx now reads `appLanguage` at mount and calls `i18n.changeLanguage` once, then subscribes to subsequent store changes so the async Tauri rehydrate (and any future external mutation) propagate to i18n automatically.
- **Settings JSON export was a multi-store dump** ([src/pages/SettingsPage.tsx](src/pages/SettingsPage.tsx)). The pre-v0.18.0 "Export Settings" button copied the whole on-disk `settings.json` — which the storage adapter writes as a gross dump of every Zustand store (settings + profiles + presets + templates + history). The new exporter writes only the Settings data through `exportTypedToJsonFile("settings", …)` — the same envelope-typed flow the Profiles tab already uses. Importer is the matching `importParsedFromJsonFile` + `resolveForType("settings")` chain, with an explicit reject for the legacy multi-store dump (friendly toast instead of silent profile-store pollution). `extractData` was promoted from a private helper in `settings-store` to a named export for this. The IS_TAURI gate stays — surfacing the buttons on the web build is out of scope for this release.
### Removed
- **"Open Folder" button** in Settings → top bar ([src/pages/SettingsPage.tsx](src/pages/SettingsPage.tsx)). Niche utility — most users never opened the app-data folder, and Tauri-only meant web builds never saw it. The `ensure_dir` Tauri command stays in the Rust side for the export/import paths that still rely on it. ~25 LOC removed including the unused `FolderOpen` icon import.
### Under the hood
- `App.tsx` mount effect now subscribes to `useSettingsStore` for `appLanguage` changes — Header and SettingsPage still call `i18n.changeLanguage` directly when the user switches, which is now redundant but harmless. Cleanup deferred to a future PR.
- Persist version unchanged — this release adds no new persisted fields.
- Bundle: under the 500 KB cap. The bank list is a 33-entry static array, negligible weight; the new envelope flow is a net-negative on SettingsPage size (Tauri dialog + ensure_dir + read_from_file paths replaced with one browser-API call).
### Migration notes
- **Pre-v0.18.0 settings export files (multi-store dump)** are rejected with a friendly "Legacy export format from v0.17.x or earlier is no longer supported" toast on import. Re-export from v0.18.0+ to get a clean settings-only envelope file.
- **Profiles, presets, templates, history** export/import flows on the Profiles tab are unchanged. v0.17.x exports of those types still import unmodified.
- **Saved `vnBankName` values** that don't match any of the 30 preset banks auto-detect as "custom" on first render — the dropdown shows "Khác" and the inline text input is pre-filled with the saved value. No persisted data is lost.
## v0.17.1 — 2026-05-15
Per-video Output selector — closes the last deferred piece from the
v0.16 ending redesign. Multi-video ending playthroughs (case C) can
now flip between per-video previews of title / description / tags
without leaving the editor.
### Added
- **`endingVideoIndex` field on `EditorData`** (1-indexed, default 1). Stored on the editor (vs. recomputed per render) so the creator's pick survives navigating away and back. Engine already respected the corresponding `GeneratorInput.endingVideoIndex` since v0.17.0 — this just persists it.
- **"Preview video" Select dropdown** in `EndingsEditor` case C ([src/components/editor/EndingsEditor.tsx](src/components/editor/EndingsEditor.tsx)). Renders `endingVideoCount` options labelled `"Video N (X–Y)"` where X–Y are the matching ending-range bounds. Changing it pipes `endingVideoIndex` into the engine, which slices `endings[]` for both title (via `buildStructuredEndingLabel`) and description (via `sliceEndingsForVideo`).
- **"Previewing Video X of Y — Endings A–B" banner** at the top of the Output page when in case C ([src/pages/OutputPage.tsx](src/pages/OutputPage.tsx)). Persistent reminder so a creator flipping through videos doesn't forget which slice they're looking at.
- **3 new locale keys × 6 locales**: `editor.endings.videoIndexLabel`, `editor.endings.videoIndexHint`, `output.previewingVideo`. All 718/718 ui keys per locale (up from 715).
### Changed
- **`use-current-generator-input`** forwards `endingVideoIndex` only when `endingVideoCount > 1` — single-video mode passes `undefined` so the slice helpers short-circuit to "render the union", keeping the input cleaner for tests.
- **`EndingsEditor.setVideoCount`** now clamps `endingVideoIndex` down when the creator shrinks `endingVideoCount` (e.g. 6 → 2 with index = 4 → snaps to 2), so the preview never targets a non-existent video.
- **Persist version 12 → 13**. Additive — `endingVideoIndex` back-fills to 1 on first rehydrate; pre-v0.17.1 drafts with a stale higher index get clamped to `endingVideoCount` by `migrateEditorState`.
### Tests
- 4 new tests in `editor-store.endings.test.ts` for the v12 → v13 migration (default back-fill, valid value preserved, clamp above max, clamp below 1). Total 426/426 pass.
### Under the hood
- The banner copy is locale-aware and pluralised inline via i18next interpolation (`{{index}} / {{total}} / {{from}} / {{to}}`).
- `OutputPage` selects `endingVideoCount`, `endingVideoIndex`, `endingVideoRanges` as individual store slices so the page only re-renders when those specific fields change — no broader subscription drag.
- Bundle: index 473.91 KB (+3 KB for Select + banner + migration). Under the 500 KB cap.
## v0.17.0 — 2026-05-14
Combined release: logging overhaul + the deferred ending title piece
from v0.16.0. The Output title now reflects the structured endings
the creator filled in (case-A/B/C aware), and the Logs tab persists
entries across app restarts with session-grouped navigation and
JSON/TXT export.
### Added
- **Structured ending titles** ([src/engine/title-builder.ts](src/engine/title-builder.ts)). When `videoType === "ending"` AND `endings[]` is filled, the title's video-type segment swaps from the static `"Ending"` to a context-aware label, picked by a four-tier resolver:
1. Single entry → `formatEndingEntry()` (e.g. `"Ending 3: Best End"`, `"Ending 3"`, or `"Best End"` depending on which fields are filled).
2. Multi-entry, every entry named → comma-joined names (`"True End, Bad End, Hidden"`).
3. Multi-entry, every entry numbered + contiguous run → `title.endingLabel.range` (`"Endings 1–3"` / `"Kết thúc 1–3"`).
4. Mixed / non-contiguous → `title.endingLabel.count` (`"3 Endings"`).
Falls back to the legacy locale label when no usable entries — pre-v0.16 single-ending creators see byte-identical output. Slicing respects `endingVideoIndex` + `endingVideoRanges` so a per-video title renders only that video's slice (foundation for the v0.17.1 per-video Output selector).
- **Persistent log storage** ([src/utils/log-storage.ts](src/utils/log-storage.ts)). Logs now survive app restarts:
- Tauri: append-only JSONL file `{appData}/logs/ytdescgen-YYYYMMDD.jsonl`. Daily rotation; cleanup deletes whole files older than `logRetentionDays` so retention sweeps are O(files) not O(entries). Three new Tauri commands feed this: `append_to_file`, `list_dir`, `delete_file`.
- Web: localStorage key `ytdescgen-logs`, FIFO-capped at 5000 entries.
- Best-effort: persistence failures never throw, so a disk hiccup can't recurse into a log loop.
- **Session-grouped LogPage** ([src/pages/LogPage.tsx](src/pages/LogPage.tsx)). Each entry now carries a `sessionId` (one per app boot). The page renders one collapsible block per session — current session expanded, prior sessions collapsed — with a per-session "Clear this session" affordance. Header shows entry count + error/warning counts + time range per session.
- **Log export buttons**:
- **JSON** — envelope-wrapped via the v0.15 `exportTypedToJsonFile` (currently keyed `_type: "history"`; promote to a dedicated `log` type later when re-import becomes a use case).
- **TXT** — `[ISO time] [LEVEL] [source] message — details` one line per entry, chronological. Pastes cleanly into bug reports.
- **`logRetentionDays` setting** ([src/store/settings-store.ts](src/store/settings-store.ts), [src/store/settings-heal.ts](src/store/settings-heal.ts)). Default 7 days; clamped to `[1, 90]` by `healSettings`. New section in Settings → Logs with inline hint. Persist-store version bumped 9 → 10.
- **Boot-time log hydration** ([src/App.tsx](src/App.tsx)). `hydrateLogStore(retentionDays)` runs in the root `useEffect`, loads recent persisted entries before the UI mounts, then schedules `pruneOldLogs` so the AppData folder stays trim.
- **Locale keys (10 new × 6 locales)**: `title.endingLabel.{range,count}` (2 templates keys), `settings.{logSettings,logRetentionDays,logRetentionHint}` + `logs.{clearPersistedConfirm,clearSession,exportJson,exportTxt,sessionCurrent,sessionLabel,entriesShort}` (10 ui keys). All 715 ui + 370 templates keys per locale.
### Changed
- **`log-store` schema** — `LogEntry` gained a `sessionId` field; in-memory cap raised from 500 → 2000 with persistence in play so a current session can fully populate the accordion without pagination. New actions: `clearAllPersisted` (in-memory + disk), `clearSession(id)`.
- **LogPage "Clear All"** now clears in-memory state AND deletes persisted JSONL files / localStorage. Two-step confirm via `clearPersistedConfirm` toast.
- **File envelope** — `SCHEMA_VERSIONS.settings` bumped 9 → 10 to match the persist version. v0.15+ settings exports still import unchanged via the `healSettings` defensive merge.
### Tests
- 11 new title-builder tests covering all four ending-label tiers + Vietnamese localisation + slice + fallback. 422/422 pass overall.
- 3 new settings-heal tests for the `logRetentionDays` default and `[1, 90]` clamp.
### Under the hood
- Tauri command surface gained 3 entries (`append_to_file`, `list_dir`, `delete_file`). All stdlib — no new crates.
- `pruneOldLogs` runs *after* `loadRecentLogs` at boot, so an entry on the retention edge is read into memory before being deleted from disk (last-chance access).
- Bundle: index 470.51 KB (+7 KB for title-builder ending logic), LogPage chunk 8.37 KB (+3 KB for session accordion + export buttons). Still under the 500 KB cap.
### Migration notes
- **Settings persist version 9 → 10**. Additive — `logRetentionDays` back-fills to 7 on first rehydrate, no user action required.
- **First-run on Tauri**: app creates `%APPDATA%\com.skullmute.ytdescgen\logs\` on the first log entry. The new `append_to_file` command auto-creates the parent dir via `std::fs::create_dir_all`.
- **Web users**: persisted entries live in `localStorage["ytdescgen-logs"]`; nothing to migrate.
- **Pre-v0.16 ending creators**: title behaviour unchanged unless they fill the new structured fields. Filling triggers the new resolver immediately.
## v0.16.0 — 2026-05-14
Structured ending editor + multi-video split. The Playthrough Notes
section's free-form "Endings shown" Input is replaced with a
structured row table that knows about ending numbers, names,
multi-video splits, and timeline cross-validation.
### Added
- **`EndingsEditor` component ([src/components/editor/EndingsEditor.tsx](src/components/editor/EndingsEditor.tsx))** — three logical cases driven by ending count + video count:
- **Case A** (1 ending) — `Number` + `Name` pair with live preview. At least one of the two must be filled; otherwise an inline warning explains the bullet will be dropped.
- **Case B** (≥2 endings, 1 video) — full table row per ending. A gate inspects the Timestamps textarea — if it doesn't contain at least `endings.length` lines tagged with the `ending` keyword, a warning banner surfaces ("Timeline needs N markers; only M found").
- **Case C** (≥2 endings, ≥2 videos) — endings table + per-video range table. Default ranges are contiguous and balanced via the new `computeContiguousRanges` helper (extras spill into the *last* video for the climactic-final convention); the creator can override per-row. Overlap / gap / out-of-bounds errors surface inline.
- **Structured `endings: EndingEntry[]` schema** in `EditorData` (v0.16.0). Each entry pairs an optional `number` (1–100) with an optional `name`. Empty entries are dropped silently. Companions: `endingVideoCount`, `endingVideoRanges: EndingVideoRange[]`, `endingVideoIndex?` (engine-only — picks which video's slice to render).
- **Engine `endings-format.ts`** — pure helpers `formatEndingEntry`, `sliceEndingsForVideo`, `clampRange`. Used by both the description builder and the editor's live preview so creators see exactly what will render.
- **Ending ordinal capture in `timeline-parser.ts`** — the `ending` keyword pattern now captures an optional trailing number, so timeline lines like `1:23:45 Ending 3: Best End` parse into `{ keyword: "ending", number: 3, rest: ": Best End" }`. Unblocks the case-B timeline gate.
- **Locale keys (19 new × 6 locales)** under `editor.endings.*` covering count / video-count labels, per-row labels, the preview line, warnings (`singleEmpty`, `timelineShort`, `rangeInvalid`, `rangeGap`, `rangeOverlap`, `rangeShort`), and helper hints. Schema bumped from 686 to 705 ui keys.
- **Tests** — 42 new tests (367 → 409): `endings-format.test.ts` (15), `editor-store.endings.test.ts` (16), `description-builder.test.ts` (5 added inline), `timeline-parser.test.ts` (6 added inline).
### Changed
- **`PlaythroughNotesForm`** — the old single `<Input label="Endings shown">` is replaced by `<EndingsEditor />`. The legacy `endingsShown` freeform is kept on the editor type for migration round-trip but no longer surfaces in the UI.
- **`description-builder` endings bullet** — reads from structured `endings[]` first, falls back to legacy `endingsShown` only when the array is empty (covers migrated drafts that still carry both). Multi-row entries render as comma-joined: `Ending 1: True End, Ending 3: Bad End, Hidden`. When `endingVideoIndex` is supplied, only that video's slice renders.
- **`timeline-parser` keyword templates** — every locale's `timeline.keywords.ending` is now `"Ending {{n}}"` instead of `"Ending"`. The renderer collapses trailing whitespace so a bare `Boss` (no ordinal) still renders cleanly as `Boss` instead of `Boss `.
- **`TemplateSnapshot`** in `template-store.ts` — gained `endings?`, `endingVideoCount?`, `endingVideoRanges?` (all optional for back-compat with pre-v0.16 templates).
### Migration
- **`migrateEditorState` v11 → v12** — `liftLegacyEndingString` parses the freeform `endingsShown` into a single-row structured entry:
- `"Ending 3: Best End"` → `{ number: 3, name: "Best End" }`
- `"Ending 3"` → `{ number: 3, name: "" }`
- `"True ending only"` → `{ number: null, name: "True ending only" }`
- `""` → `[]` (no entry)
Localised "Kết thúc N", "エンディングN", etc. are also recognised. After lifting, `endingVideoCount` defaults to 1, `endingVideoRanges` to a single span; the existing `endingsShown` string is left in place but unused.
### Under the hood
- `EndingEntry` and `EndingVideoRange` types live in `src/engine/types.ts`. The 1-indexed inclusive `from/to` convention matches the user-facing "Video 1, Video 2…" labels.
- The Output preview for case C currently renders the *union* of all endings (same as case B) — per-video output rendering is wired into the engine via `endingVideoIndex` but the UI selector for it lands in a follow-up patch. Documented inline in `EndingsEditor` as `multiVideoOutputNote`.
- Bundle: index 463.08 KB (+62 KB for EndingsEditor + endings-format + table-row UI). Still under the 500 KB cap.
- 409/409 tests pass. Lint + typecheck + locale-validate all clean.
## v0.15.0 — 2026-05-14
Import / export overhaul + stability hardening. Closes the "black
screen on bad file" class of bugs and gives every JSON export an
auto-detect header so users can no longer confuse profile / preset /
template files with each other.
### Added
- **`ErrorBoundary` ([src/components/ErrorBoundary.tsx](src/components/ErrorBoundary.tsx))** wrapping every `<Route>` plus a top-level boundary in `main.tsx`. Catches render-time errors that previously black-screened the app, surfaces a fallback UI with `Try again` (remount the subtree) + `Reload page` actions, and copies the error into the Logs tab via the in-app `logger`. Per-route boundaries mean a crash on the Profiles tab doesn't take down the Editor — the user can navigate elsewhere and recover.
- **File envelope format ([src/utils/file-schema.ts](src/utils/file-schema.ts))** — every `.json` export written from this version onwards is wrapped in `{ _app: "ytdescgen", _type, _schemaVersion, _exportedAt, data }`. The `_type` discriminator (`"profile" | "preset" | "template" | "settings" | "history"`) lets imports detect "you opened a Template file in the Profiles importer" and offer to switch tabs instead of silently failing.
- **`detectShape` / `resolveForType`** — shape inspector handles envelope files (authoritative `_type`), legacy bare arrays (best-effort guess from `snapshot` / `channelName` + `social` + `rig` / `gameName` + `storeLinks` / `createdAt` + title), and the multi-store settings dump (recognised by the `ytdescgen-settings` key). 17 new unit tests in `tests/utils/file-schema.test.ts` cover the round-trip + every detection branch.
- **`importTypedFromJsonFile(expectedType)`** — high-level reader that resolves to a tagged-union `ImportResult`: either `{ ok: true; data; sourceVersion? }` or `{ ok: false; failure }` with one of five kinds (`cancelled`, `read-failed`, `empty`, `parse-error`, `wrong-shape`, `newer-schema`). Replaces the throw/catch-and-show-generic-toast pattern.
- **Auto tab-switch on wrong-type import** — when the user clicks Import on the Profiles tab but the file is detected as a Templates export, the toast says "This file looks like a Templates export. Switching tabs…" and `setTab("templates")` runs immediately. One click instead of three.
- **Import-result summary** in toasts — `Imported 5 of 7 profiles (some skipped).` when the store-level validator drops malformed rows. Previously a partial success surfaced as a plain "Imported!" even when half the file got rejected.
### Fixed
- **Black-screen crash** on loading a corrupt profile or template ("Cannot convert undefined or null to object"). Root cause was three unguarded spreads/`Object.values` chained together:
- [src/components/profiles/TemplateCard.tsx:21](src/components/profiles/TemplateCard.tsx) `loadProfile(template.snapshot)` with `snapshot: null` →
- [src/store/editor-store.ts:149](src/store/editor-store.ts) `normalizeEditorPatch` spread of `null` patch →
- [src/components/profiles/ProfileCard.tsx:34](src/components/profiles/ProfileCard.tsx) `Object.values(profile.social)` with `social: null`.
All three now null-guard. `normalizeEditorPatch` returns `{}` for a falsy patch; `loadProfile`-chain spreads degrade to a no-op; `Object.values(profile.social ?? {})` returns 0 instead of throwing. The new ErrorBoundary catches anything that still slips through.
- **Store-level import validators** in [profile-store.ts](src/store/profile-store.ts), [preset-store.ts](src/store/preset-store.ts), [template-store.ts](src/store/template-store.ts) now filter incoming arrays for rows with a string `id` of non-zero length; templates additionally require a non-null `snapshot` object. Bad rows are silently dropped (count surfaces in the import toast).
### Changed
- **`exportToJsonFile` → `exportTypedToJsonFile`** at every ProfilesPage call site. The legacy bare-value exporter is retained for back-compat but unused.
- **`importFromJsonFile<T>` → `importTypedFromJsonFile`** at every ProfilesPage handler. Legacy bare reader retained for the same reason — callers outside Profiles can migrate later.
- **`detectShape` is forward-compatible**: an envelope from a future version (whose `_schemaVersion` exceeds `SCHEMA_VERSIONS[expected]`) returns `newer-schema` instead of importing silently. Tells the user to upgrade the app.
### Under the hood
- Two layers of validation by design: `detectShape` confirms the file *kind*; per-store `importX` rejects malformed *rows*. A future tab-specific quirk in one validator can't corrupt other stores' data.
- `normalizeEditorPatch` signature widened to `Partial<EditorData> | null | undefined` so TS forces null-handling at call sites. Existing callers still work — `Partial<T>` is assignable to the new union.
- Vite reports one dynamic-import-also-statically-imported warning for `logger.ts`. Intentional: the boundary uses a dynamic import so logger init failures during the *primary* render error don't escalate into a secondary boundary crash. Bundle is not split.
- Bundle: index 401.06 KB (+2.49 KB), ProfilesPage chunk 18.44 KB (+4.38 KB for envelope + failure-toast rendering). Total still well under the 500 KB cap.
- 367/367 tests pass (350 + 17 new for file-schema).
### Migration notes
- **No store schema bump**. v0.14.x persisted state loads unchanged in v0.15.0; new envelope only affects on-disk JSON export files.
- **Legacy export files still import** via the shape-detector path. Re-export to get the envelope header + tab-switch hints.
- **Envelope schema versions**: profile=1, preset=2, template=1, settings=9, history=2. Bump per-type when introducing a non-additive change to that store's shape.
## v0.14.1 — 2026-05-14
Same-day patch on v0.14.0. Two desktop-only items closing user-reported
issues on Windows + a small Settings convenience.
### Fixed
- **Windows "cannot find ... `AppData\Roaming\com.skullmute.ytdescgen`"** when clicking *Settings → Open Folder* on a fresh install ([`src/pages/SettingsPage.tsx:25-35`](src/pages/SettingsPage.tsx)). Root cause: `appDataDir()` only resolves the path string — the directory itself is created lazily on the first `save_to_file` write, so first-run users hit the OS shell before any setting had been persisted. New Rust command `ensure_dir(path)` ([`src-tauri/src/lib.rs:18-27`](src-tauri/src/lib.rs)) wraps `std::fs::create_dir_all` and is invoked before both `openPath(dir)` and `read_from_file` in `exportSettingsToFile`, so the shell + read paths can never encounter a non-existent folder.
### Added
- **Settings → Import button** (Tauri-only, next to *Export*). Reads a `.json` settings file via the existing `loadFile()` Tauri dialog, accepts either the full multi-store dump produced by *Export* (object keyed by `ytdescgen-settings`) or a bare `SettingsData` payload, runs it through `healSettings()` to back-fill any missing keys, then dispatches via `useSettingsStore.setState`. Theme class on `<html>` is re-applied directly because `setState` bypasses the `setTheme` action. Five distinct failure modes get their own toast: dialog-cancel (silent), `read_from_file` error, empty file, JSON parse error, non-object root. Each failure logs to the in-app logger with the source `"settings"` so it surfaces in the Logs tab without leaving the UI.
### Under the hood
- New Tauri command `ensure_dir` registered in `invoke_handler!` macro alongside `save_to_file` and `read_from_file`. Pure stdlib — no new crates.
- `exportSettingsToFile` also pre-creates the data folder so *Export* works on a fresh install without first triggering any other write.
- Settings store gained no schema fields; the import path reuses the existing `healSettings` (v9) for back-fill so no `version` bump on the persist store.
- 350/350 tests still pass; lint + typecheck clean.
- Bundle: SettingsPage chunk grew ~0.18 KB raw for the new icon import + import handler; main bundle and overall gzip totals unchanged.
### Migration notes
- No store schema bump. Existing v0.14.0 installs upgrade in place.
- Web (GitHub Pages) build is unchanged — both fixes are Tauri-only by virtue of the `IS_TAURI` gate on the Settings toolbar.
## v0.14.0 — 2026-05-14
Three independent strands land together:
1. **License flip MIT → Apache-2.0.** The repo previously claimed MIT in README/CLAUDE.md but had no `LICENSE` file. Adds canonical Apache License 2.0 text, a `NOTICE` asserting copyright + AI-assisted-development disclosure, and the `license` field in `package.json` + `src-tauri/Cargo.toml`. Per the production-docs spec.
2. **Content warnings 69 → 91** across a new 8th group `gameplay_disclosure`. Adds horror-channel staples plus transparency disclosures for non-vanilla play. See "Added" below for the full ID list.
3. **Mobile-responsive web** without PWA or Tauri-mobile. The GitHub Pages build is now usable on phones (drawer nav below `md`, touch-sized form controls, iOS-safe focus behavior, safe-area-inset padding for notch/home indicator).
Plus a documentation sweep: full `README.md` rewrite, new root policy files for public release (`SECURITY`, `CONTRIBUTING`, `CODE_OF_CONDUCT`, `PRIVACY`, `DISCLAIMER`, `TERMS`, `THIRD_PARTY_NOTICES`, `MAINTAINERS`), `docs/DEVELOPMENT.md` merging the deleted `pc_spec.md` + `dev_env.md`, Vietnamese mirrors for DEVELOPMENT and DISCLAIMER, and a `.github/PULL_REQUEST_TEMPLATE.md`.
### Added
- **`LICENSE`** (root) — canonical Apache License 2.0 text. **`NOTICE`** asserting `Copyright 2026 poli0981` + Claude Code 4.7 Opus (1M context) co-authorship disclosure. `license` field added to `package.json` and `src-tauri/Cargo.toml`.
- **22 new content-warning IDs** across 8 groups ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)):
- Phobias (+3): `coulrophobia` (clowns), `ablutophobia` (drowning), `taphophobia` (live burial).
- Photosensitive (+2): `strobe_effects`, `screen_shake_intense`.
- Mental Health (+3): `paranoia_themes`, `intrusive_thoughts`, `medical_horror`.
- Sensitive (+3): `human_experimentation`, `cannibalism`, `nuclear_themes`.
- Horror-Specific (+5): `liminal_spaces`, `analog_horror`, `unreality_themes`, `pursuit_chase`, `entity_horror`.
- Playstyle (+2): `first_time_playing`, `returning_player`.
- **NEW group Gameplay Disclosure (+4)**: `mods_used`, `cheats_enabled`, `glitch_exploits`, `assisted_run`.
- **`src/components/ui/Drawer.tsx`** — slide-in mobile-nav drawer. Reuses overlay + Esc patterns from `Modal.tsx`; body-scroll lock + safe-area-inset padding; tap-outside-to-close.
- **`tailwind.config.ts`** — `theme.extend.spacing.touch = "44px"` (iOS HIG minimum), exposed via `min-h-touch` / `h-touch` utilities.
- **Mobile keyboard hints** — `inputMode` / `autoComplete` / `enterKeyHint` on game-name, channel-name, contact-email, and playlist-URL fields so iOS shows the right keyboard.
- **Root policy file set** for public release: `SECURITY.md` (private-disclosure flow), `CONTRIBUTING.md` (PR process, validate:locales gate, auto-ignore rules), `CODE_OF_CONDUCT.md` (Contributor Covenant v2.1 link), `PRIVACY.md` (offline-first, localStorage keys listed, GDPR/CCPA), `DISCLAIMER.md` (AI-assistance + translation-quality disclosure), `TERMS.md` (Apache-2.0 + GitHub ToS + GDPR/CCPA/PIPL/LGPD/VN Cybersecurity), `THIRD_PARTY_NOTICES.md` (full dep table + AI disclosure paragraph), `MAINTAINERS.md`. Plus `.github/PULL_REQUEST_TEMPLATE.md`.
- **`docs/DEVELOPMENT.md`** (EN) + **`docs/i18n/vi/DEVELOPMENT.md`** (VI) — merge of the deleted `pc_spec.md` + `dev_env.md`. Covers toolchain (Node ≥ 22, Rust stable, Tauri 2), JetBrains 2026.x + VS Code setup, build commands, per-OS Tauri prerequisites, troubleshooting.
- **`docs/i18n/vi/DISCLAIMER.md`** — VI mirror of `DISCLAIMER.md`.
### Changed
- **`Sidebar.tsx`** — extracts `<SidebarNavList collapsed onItemClick?>` so the same nav can render inside the desktop sidebar **and** the new mobile Drawer. Outer `<aside>` now `hidden md:flex`.
- **`AppShell.tsx`** — wires `mobileNavOpen` state + renders `<Drawer side="left">` containing `<SidebarNavList />` for mobile. Header gets `onOpenMobileNav` prop.
- **`Header.tsx`** — adds `Menu` hamburger (md:hidden), `pt-[max(0.75rem,env(safe-area-inset-top))]` for iOS notch, donate icon-only below md, language dropdown width `min-w-[200px] max-w-[calc(100vw-2rem)]` so it never overflows at 360px width.
- **`Button.tsx` / `Input.tsx` / `Textarea.tsx` / `ValidatedInput.tsx`** — bump heights to `min-h-touch` (44 px) for `md` / `lg`; `sm` to `min-h-[36px]` (iOS minimum). Inputs / textareas use `text-base sm:text-sm` to prevent iOS Safari focus zoom (Safari zooms when font-size < 16 px).
- **`EditorPage.tsx`** — responsive padding `gap-6 p-6 lg:flex-row` → `gap-4 p-3 sm:p-4 md:gap-6 md:p-6 lg:flex-row`. Sticky preview wrapper changed to `lg:sticky lg:top-6` so mobile portrait doesn't lock the preview.
- **`OutputPreview.tsx`** — description scroll-box `max-h-[400px]` → `max-h-[60vh] sm:max-h-[400px]`.
- **`CopyAllBar.tsx`** — `pb-[max(0.75rem,env(safe-area-inset-bottom))]` for iOS home indicator; button class compaction below `sm`.
- **`README.md`** — full rewrite (~200 lines). Badges (Apache-2.0 / Node ≥ 22 / latest release / last commit), Use Cases (esp. horror gameplay), Privacy section, full doc table, AI disclosure, channel/socials block.
- **`CLAUDE.md`** — license MIT → Apache-2.0; project-structure tree updated (`PRD.md` removed, `DEVELOPMENT.md` added with VI mirror sibling).
- **`src/config/about.ts`** — `license` MIT → Apache-2.0. `pcSpecDocUrl` / `devEnvDocUrl` field names preserved for About-page layout compat but now point to `docs/DEVELOPMENT.md` (EN) and `docs/i18n/vi/DEVELOPMENT.md` (VI) respectively.
- **`webapp/TAURI.md`** — cross-links updated to `docs/DEVELOPMENT.md`.
### Removed
- **`docs/PRD.md`** — Product Requirements Document V1.0 (2026-04-07). Shipped through v0.13.1; no longer load-bearing for public readers.
- **`docs/pc_spec.md`** + **`docs/dev_env.md`** — merged into `docs/DEVELOPMENT.md`.
- **`docs/i18n/vi/pc_spec.md`** + **`docs/i18n/vi/dev_env.md`** — merged into `docs/i18n/vi/DEVELOPMENT.md`.
### Under the hood
- **`_schema.json`** updated with the 23 new keys (1 new group label + 22 new option keys + 22 new long-description keys). All 6 locales × 2 files now at 686/686 ui + 368/368 templates.
- **No engine logic changes.** `description-builder.ts:415-431` already loops content warnings by user selection order — the new IDs are pure-data additions.
- 350/350 tests still pass — no engine math changed.
- Bundle: 443.55 KB raw / 136.55 KB gzip (under the 500 KB cap; ~+30 KB vs v0.13.1 from the docs imports being inlined).
- Repository URL canonicalized — all README / CLAUDE / DEVELOPMENT references that pointed to `github.com/poli0981/yt-desc-gen` now correctly resolve `github.com/poli0981/youtube-generator`. `src/config/about.ts` still uses the canonical name; no behavior change.
- Tauri app-data identifier (`com.skullmute.ytdescgen`) documented correctly in `PRIVACY.md`.
### Migration notes
- **License change is not a code migration** — your build environment doesn't need any action. If you redistribute the source, the new `LICENSE` + `NOTICE` apply per Apache 2.0 §§ 4(a)–4(d). Pre-v0.14 forks may continue under their snapshot's license; this is a forward change.
- **No store schema bump.** Editor / settings / profile / preset / template store versions unchanged. Persisted drafts containing the legacy `contentWarnings` array round-trip unchanged — the array just renders against the expanded ID set.
- **Mobile users** get the new layout automatically on next visit; nothing to opt in to.
## v0.13.1 — 2026-05-11
Same-day hotfix for v0.13.0. Three small but load-bearing pieces:
### Added
- **GitHub-side housekeeping** — `.github/FUNDING.yml` (mirrors `Donate.txt`), `.github/ISSUE_TEMPLATE/{config,bug_report,feature_request}.yml`, `docs/pc_spec.md` + `docs/dev_env.md` (+ VI mirrors), `webapp/TAURI.md`. Auto-link-discussion job added to `announce-release.yml` (`gh release edit --discussion-category "Announcements"`) so every future release auto-creates a linked Discussion thread.
- **AboutPage restructure** — split into Repository / Donate / Connect / Dev Environment / Third-Party sections. Ko-fi / Patreon moved out of `ABOUT.socials` into a new `@config/donate` (`PRIMARY_DONATE_URL` constant feeds the Header donate button). Socials expanded with Bluesky, Mastodon, Steam, Telegram (bot + user), email, game-server Discord.
- **Header donate button** — persistent pink Ko-fi link to the left of the language switcher.
- **Sidebar external link** — Report Bug item added to the tabs array via a new `external?: boolean` field on `TabItem`; branches render between `<NavLink>` and plain `<a target="_blank">`.
- **Basic SEO** — expanded `<head>` (description, OG, Twitter card, JSON-LD `WebApplication`, 6 locale alternates) + new `useDocumentTitle(title)` hook applied to all 9 page components + `public/{robots.txt,sitemap.xml,manifest.webmanifest,favicon.svg}` (favicon is a placeholder SVG).
- **Heavy-horror content-warning group** (7 IDs: `eye_horror`, `body_horror`, `face_horror`, `cosmic_horror`, `extreme_gore`, `decay_rot`, `mutilation`) translated to all 6 locales in both short-label and long-description forms.
### Changed
- **Workflow `workflow_run` filters narrowed** — `notify-ci-failure.yml` / `notify-deploy.yml` / `notify-release-pipeline.yml` switched from `workflows: ["*"]` to specific producer names. Eliminates Skipped-row spam in the Actions tab.
- **`@tauri-apps/api` 2.10.1 → 2.11.0** to match Rust `tauri` 2.11.1 (Dependabot bumped Rust side; tauri-action requires the npm and Rust minors to match).
### Fixed
- **Tauri-action `releaseDraft: true` is search-by-version, not search-by-tag.** The initial v0.13.1 tag push silently uploaded `0.13.0`-labelled binaries to the existing v0.13.0 release object because `src-tauri/{tauri.conf.json, Cargo.toml, Cargo.lock}` stayed at `0.13.0`. Recovered with PR #58 (Tauri-side manifests to 0.13.1), then PR #59 (`@tauri-apps/api` bump), then force-moving the signed `v0.13.1` tag twice via `git tag -fs` + `git push origin v0.13.1 --force`, finally `gh workflow run release-desktop.yml -f tag=v0.13.0` to rebuild and restore v0.13.0's binaries.
### Migration notes
- **Version-bump ritual is now SIX files**, not five: `package.json`, `package-lock.json`, `src-tauri/Cargo.toml`, `src-tauri/Cargo.lock` (the `yt-desc-gen` entry only), `src-tauri/tauri.conf.json`, and — when Rust `tauri` minor moves — `@tauri-apps/api` in `package.json` (its minor must equal Rust `tauri` crate minor).
## v0.13.0 — 2026-05-08
A scope-broadening release: two UI/Gacha bugs squashed, Gacha-quest editor extended with three structured fields (Anniversary year dropdown, Showcase character name, free-form `gachaVersion`), copy buttons hard-stop when text exceeds YouTube's title/description/tags limits, the Tauri desktop window is now locked at 1100×750 (no resize, no maximize), 27 new content warnings — including a brand-new "Playstyle disclosures" group — fill the phobia / mental-health / sensitive / playstyle gaps, and the My Rig editor's free-text GPU and RAM inputs are replaced with structured cascading dropdowns (Brand → Series → Model for GPU, Size + DDR generation for RAM) covering ~200+ GPU models across 14 series and 4 brands. Two QoL touches round it out: per-quest-type smart placeholders ("Day 12" for Daily Commission, "Floor 12" for Endgame, "Part 1" for Main Story) and inline validation badges that nudge the creator when a rig field is half-filled.
### Added
- **Anniversary year dropdown (1–20)** ([src/components/editor/ExtraFieldsInput.tsx](src/components/editor/ExtraFieldsInput.tsx)) — replaces the v0.12 `chapterName` text input for the `anniversary` quest type. Title and description templates render `"{{anniversaryYear}}{{ordinalSuffix}} Anniversary"` (e.g. "2nd Anniversary", "11th Anniversary") with a locale-aware `ordinalSuffix()` helper that returns `st/nd/rd/th` for English and an empty string for non-English locales (so "周年記念" / "주년" / "周年纪念" don't pick up an English suffix).
- **Showcase character name** — when `gachaQuestType === "showcase"`, the editor swaps Chapter/Quest/Part for a single `characterName` input. The description renders the user's exact requested phrasing: "This video showcases the skills, appearance, and details of {{characterName}} in {{gameName}}{{versionLabel}} on {{channelName}}." Title becomes "{{gameName}} — Character Showcase: {{characterName}}".
- **Gacha `gachaVersion` field** ([src/store/editor-store.ts](src/store/editor-store.ts)) — free-form game version label like "1.2", "2.4", scoped to the Gacha Quest video type. Distinct from `versionInfo` (driver/general game version, rendered in the 🖥 VIDEO SETTINGS block for any video type). Surfaces in Gacha-specific intros via a new `description.intro.versionInline` template helper that renders only when non-empty (so the parenthetical "(version 1.2)" disappears entirely when the field is blank — no "(version )" artifact).
- **Cascading GPU dropdown** ([src/config/gpu-catalog.ts](src/config/gpu-catalog.ts), [src/config/rig-fields.ts](src/config/rig-fields.ts)) — three-level Brand → Series → Model picker covering NVIDIA (GTX 700/900/10/16, RTX 20/30/40/50), AMD (HD 7000, R7/R9 200/300, RX 400/500/Vega/5000/6000/7000/9000), Intel Arc (A and B series), and Apple Silicon (M1–M4 with Pro/Max/Ultra variants). A `Custom` brand swap-in keeps free-text entry available for niche cards. Stored as pipe-delimited `"<brand>|<series>|<model>"` so the rig store stays a flat `Record<string, string>` — no schema migration vs. v0.12. `formatRigValue("gpu", …)` outputs `"NVIDIA RTX 4090"` (drops the redundant series label).
- **Composite RAM input** — two cascading dropdowns (Size + DDR) replace the free-text RAM field. Sizes: 4/6/8/12/16/32/64/96/128/256 GB plus a `Custom…` numeric input for unusual sticks. DDR generations: DDR1–DDR7. Output renders as `"32 GB DDR5"` / `"48 GB DDR5"` (custom). Same flat-string storage approach as GPU (`"<size>|<ddr>"`, with `"custom:48|DDR5"` for custom numeric).
- **27 new content warnings + Playstyle disclosures group** ([src/engine/types.ts](src/engine/types.ts), [src/config/content-warning-groups.ts](src/config/content-warning-groups.ts)) — Phobias gain `cynophobia / nyctophobia / pyrophobia / pediophobia / hemophobia` (5). Mental health gains `bipolar_themes / ocd_themes / panic_attacks / dissociation` (4). Sensitive gains `hate_speech / historical_atrocity / slavery_themes / terrorism_themes / bullying_themes` (5). A brand-new **Playstyle disclosures** group (8 items) covers `blind_playthrough / no_spoilers_chat / casual_difficulty / hardcore_difficulty / permadeath_run / speedrun_attempt / completionist_run / learning_mechanics` — disclosure-style warnings that aren't really "content" but viewers benefit from knowing (e.g. "Blind playthrough — first time" sets expectations for repeated dying).
- **Smart placeholders per Quest Type** ([src/config/gacha-quest-types.ts](src/config/gacha-quest-types.ts)) — `GACHA_QUEST_PLACEHOLDERS` map drives the Chapter / Quest / Part inputs to show context-specific hints based on the selected quest type: `"Day 12"` for Daily Commission, `"Floor 12"` for Endgame, `"Part 1"` and `"Chapter 5 Act 2"` for Main Story, etc. Placeholders only — no value clearing or auto-fill, so user input is preserved when switching types.
- **Inline rig validation badges** ([src/utils/rig-validation.ts](src/utils/rig-validation.ts)) — `validateGpuValue` / `validateRamValue` flag half-filled selections (brand picked but no model, RAM size set but DDR missing, custom numeric empty) and the rig editor renders a small ⚠️ warning under the affected field. Soft warning only — the description still renders, but the badge nudges the creator to complete the field.
- **Copy-over-limit guard** ([src/hooks/use-clipboard.ts](src/hooks/use-clipboard.ts)) — `useClipboard().copy(text, { limit, fieldLabel })` now refuses to write to the clipboard when `text.length > limit`. Surfaces a toast like "Title is too long: 117/100 chars. Trim before copying." Each output button (Title / Description / Tags) passes its respective `YT_LIMITS.*` cap; the Copy All bar pre-validates Title and Description and shows a combined error if either is over. Over-limit copy buttons render with a `text-danger` style and a ⚠️ icon so the lock state is visible before the user clicks.
### Changed
- **Editor store v10 → v11** ([src/store/editor-store.ts](src/store/editor-store.ts)) — additive only: `characterName: ""`, `anniversaryYear: null`, `gachaVersion: ""` back-fills. Out-of-range or non-integer `anniversaryYear` values coerce to `null` so a hand-edited persistent blob with `anniversaryYear: 99` doesn't render "99th Anniversary" in titles. Existing fields round-trip unchanged.
- **Tauri window locked** ([src-tauri/tauri.conf.json](src-tauri/tauri.conf.json)) — `resizable: false`, `maximizable: false`, and `minWidth = maxWidth = 1100` / `minHeight = maxHeight = 750` ensure the desktop binary opens at the design resolution and stays there. Eliminates layout drift from users dragging the window to ultra-wide ratios where the editor → preview split breaks.
- **AppShell layout reflow** ([src/components/layout/AppShell.tsx](src/components/layout/AppShell.tsx)) — root `min-h-screen` swapped for `h-screen overflow-hidden` so the outer container can't grow beyond viewport height. The `<main>` scroll container now actually constrains content, fixing the v0.12 bug where long descriptions caused the entire page (sidebar + header included) to scroll instead of just the main pane.
- **Showcase template renders character, not quest** — `gachaQuestType.showcase` title and `description.intro.gacha_quest_showcase` now consume `characterName` instead of `questName`. Pre-v0.13 drafts that picked `showcase` and filled `questName` will see `characterName` empty after upgrade — re-enter the character into the new field.
- **Anniversary template renders year + ordinal** — `gachaQuestType.anniversary` and `description.intro.gacha_quest_anniversary` consume `anniversaryYear` (number) instead of `chapterName` (free text). The English title is now `"<game> — 2nd Anniversary - Day N"` driven by the new ordinal helper; locale variants render in their native conventions ("2周年記念", "2주년 기념", "Aniversario 2", etc.).
- **`formatRigValue()` extended** — switches on `field.type` to handle the two new cascading / composite types. Pre-v0.13 free-text GPU and RAM values (no pipes) pass through unchanged so existing profiles render the same string they did before; the editor displays them under the Custom brand for further editing.
### Under the hood
- **Schema-driven locale validation** still passes with 629 ui keys + 339 templates keys across all 6 locales (en/es/ja/ko/vi/zh) — every new key is mirrored in the schema and translated where applicable. Validation errors are caught at the build / pre-merge step via `npm run validate:locales`.
- **`tests/engine/rig-fields.test.ts`** grew from 7 → 18 cases — new coverage for `cascading_dropdown` (brand+model formatting, custom-brand verbatim, brand-only fallback, legacy free-text passthrough) and `composite_dropdown` (size+DDR, custom numeric, partial values, legacy passthrough).
- **`tests/store/editor-store.migrate.test.ts`** grew from 9 → 13 cases — new v10 → v11 migration tests assert the Gacha field back-fills, the 1–20 anniversary-year range guard, and the round-trip preservation of valid persisted values.
- **`tests/engine/title-builder.test.ts`** updated — the Anniversary test now passes `anniversaryYear: 7` instead of `chapterName: "7th"` to match the new template shape.
- Test count: 350/350 (was 335/335).
### Migration notes
- v10 → v11 is automatic and additive; the migration runs once on first launch of v0.13. Existing drafts are preserved.
- **Showcase users**: the `questName` you previously typed for showcase videos won't be carried into `characterName`. Open the editor, pick Showcase, and re-enter the character — the field name change is intentional (Showcase = character, not quest).
- **Anniversary users**: the free-text `chapterName` you used to type "2nd" / "Year 2" / etc. is no longer used by the Anniversary template. Pick the year from the new dropdown instead.
- **Free-text GPU / RAM users**: existing profiles render identically. The editor will show your old free-text under the Custom brand / RAM legacy fallback; switch to the structured dropdowns when convenient.
## v0.12.1 — 2026-05-06
Hotfix for v0.12.0. Ticking a Tech Notes checkbox (or filling any of the new Playthrough Notes structured fields — Endings shown, Language patch, Game version) updated the editor state but never reached the description preview, because the editor → engine mapping in `useCurrentGeneratorInput` wasn't kept in sync when the new fields were added. The unit-test suite caught nothing because every v0.12 description-builder test passed `GeneratorInput` directly to the engine, bypassing the hook.
### Fixed
- **Editor → engine pipeline carries every v0.12 field** ([src/hooks/use-current-generator-input.ts](src/hooks/use-current-generator-input.ts)) — `endingsShown`, `languagePatch`, `languagePatchCustom`, `gameVersion`, `gameVersionCustom`, and `techNotes` are now forwarded into `GeneratorInput`. Symptom of the bug was that the description preview (and Output / Batch tabs) didn't change when the user ticked tech-note items or filled language-patch / game-version, even though the editor checkboxes / selects reflected the change correctly.
- **Save-as-template captures every v0.12 field** ([src/components/templates/TemplateSaveForm.tsx](src/components/templates/TemplateSaveForm.tsx)) — the snapshot builder explicitly enumerates each editor field and was missing the same six fields. A v0.12.0 user saving a template lost their Tech Notes / Playthrough Notes selections; loading the template later didn't restore them.
### Changed
- **Hook field-mapping extracted into a pure helper** — `buildGeneratorInputFromEditor(state, languageOverride?)` is now exported alongside the React hook. Pure function so it's directly unit-testable; the hook just wraps it in `useMemo`. Same change pattern used for `migrateEditorState` in v0.12.0 — pull the load-bearing logic out of React-coupled wrappers so tests can hit it without a render harness.
- **Hook `useMemo` deps simplified** — the previous list enumerated every field individually (50+ entries); a missing field would silently freeze that field's value in the memoised output. Replaced with a single `[state, languageOverride]` since `useEditorStore()` returns a fresh state reference on every store update — equivalent invalidation, fewer footguns.
- **`TemplateSnapshot` carries the v0.12 fields as optional** ([src/store/template-store.ts](src/store/template-store.ts)) — `endingsShown`, `languagePatch`, `languagePatchCustom`, `gameVersion`, `gameVersionCustom`, `techNotes` joined the snapshot type. Optional for back-compat with templates saved before this hotfix; the editor's `loadProfile` spread keeps existing values when the patch lacks them.
- **`EditorData` is now `export interface`** in `src/store/editor-store.ts` so the shared snapshot helper can reference it.
- **package-lock.json** synced to the v0.12 / v0.12.1 version line — was carrying a stale v0.11.0 root version since the v0.12.0 PR forgot it (the v0.9.0 lockfile-bump-miss memory note reminded us, but only after the v0.12.0 ship).
### Under the hood
- New `tests/hooks/generator-input-mapping.test.ts` (6 cases) — direct assertions that each v0.12 field reaches `GeneratorInput` (`endingsShown`, `languagePatch + custom`, `gameVersion + custom`, `techNotes` selection-order), plus a parity guard that walks every key of an `EditorData` instance and fails if any non-allowlisted field is dropped from the resulting `GeneratorInput`. The allowlist is exactly two keys (`thumbnailText`, `pinnedComment` — both feed the pinned-comment builder via a separate code path); anything else added in the future will trip the assertion immediately.
- Test count: 335/335 (was 329/329). Bundle: 345.50 KB raw / 115.52 KB gzipped (essentially flat versus v0.12.0 — only swapped a deps array for a single ref).
### Migration notes
- No state migration needed. `loadProfile` / `loadPreset` continue to spread snapshots over current state, and the new fields are all optional on `TemplateSnapshot`. A v0.12.0 user with templates saved during the bug window will see those templates load with empty Tech Notes / Playthrough Notes — re-save the template after upgrading to capture the fields properly.
## v0.12.0 — 2026-05-06
A bug fix and a description overhaul. The Tauri desktop build picks up `tauri-plugin-single-instance` so launching the app twice no longer stacks tray icons / orphan processes — second launches refocus the existing window. The description's Playthrough block consolidates the v0.7 standalone "🎯 Playthrough" line and the standalone "🎮 DIFFICULTY" block into a unified `▸ 🎮 PLAYTHROUGH NOTES` section with three new structured fields (`endingsShown`, `languagePatch`, `gameVersion`), and a new `▸ 🛠 TECH NOTES` bilingual checklist (24 items across 5 groups) sits alongside Content Warnings for production / playstyle disclaimers.
### Added
- **Single-instance enforcement (desktop)** — `src-tauri/Cargo.toml` adds `tauri-plugin-single-instance = "2"`, registered first in the `Builder` chain in `src-tauri/src/lib.rs` with a `get_webview_window("main")` → show + unminimize + focus callback. Closing-to-tray then double-clicking the launcher / start-menu shortcut surfaces the existing window instead of spawning a fresh process with its own tray icon.
- **Unified `▸ 🎮 PLAYTHROUGH NOTES` description block** — replaces the v0.7 standalone "🎯 Playthrough:" line and the v0.7 standalone "🎮 DIFFICULTY" block with one bulleted section that renders five fields: Run type (reads from existing `playthroughStatus`), Difficulty (reads from existing `difficulty` + `difficultyCustomLabel`), Endings shown (NEW free text), Language patch (NEW enum + custom slot), Game version (NEW enum + custom slot). Empty bullets are skipped; the whole block is skipped when every field is empty. Bilingual `EN · LOCAL` rendering for both label and value when `tEn` is provided and output language ≠ English. Section sits in slot 1.5 (right after the intro), matching the position of the pre-v0.12 standalone playthrough line.
- **`▸ 🛠 TECH NOTES` checklist** — a 24-item, 5-group bilingual multi-select for production / playstyle disclaimers: audio (5: copyright muting, volume reduction, music replacement, cutscene-only mute, original-audio kept), video quality (3: low resolution, low graphics, FPS drops with FPS counter pointer), recording issues (4: bug-from-game, crash kept, loading cut, OBS artifacts), playstyle (8: not no-hit, not clean walkthrough, casual no-commentary, many deaths, slow exploration, puzzle-stuck, grinding cut, not speedrun), production (4: exploration-focused, edited-for-pacing, support-developers, online-connectivity-issues). Same render pattern as v0.11 Content Warnings — header / two-line intro / `EN · LOCAL` bullets with U+00B7 MIDDLE DOT separator. Section sits right after Content Warnings; both transparency blocks group together.
- **`languagePatch` enum** with options `none / official_en / official_other / fan_translation / mtl / custom` and a paired free-form `languagePatchCustom` slot — covers the most common patch states (canonical EN release, official non-EN locale, fan TL, machine TL) plus an escape hatch for niche cases. `none` is the skip-bullet sentinel; `official_other` and `custom` both surface the free-form input under the Select.
- **`gameVersion` enum** with options `full_release / demo / early_access / beta / prologue / pre_release / custom` and a paired `gameVersionCustom` slot — `full_release` is the implicit default (no bullet rendered) so creators recording the released game don't have to fill anything; "Steam Next Fest demo" / "Kickstarter backer build" / similar niche cases go through `custom`.
- **Free-text `endingsShown` field** — captures values like "1 of 3", "True ending only", "All routes 100%", "Normal + True". Free text on purpose — the natural value space is too varied for an enum, and a `custom` escape hatch would catch 80% of selections anyway.
### Changed
- **Editor store** v9 → v10 — additive only: `endingsShown: ""`, `languagePatch: "none"`, `languagePatchCustom: ""`, `gameVersion: "full_release"`, `gameVersionCustom: ""`, `techNotes: []` back-fills. Existing `playthroughStatus` / `difficulty` / `difficultyCustomLabel` values round-trip unchanged — only the description-builder render path moves them into the unified block. Invalid persisted enum values coerce to their skip-sentinel default; unknown `techNotes` ids are filtered out (defensive against hand-edited blobs). The `migrate` function is now extracted into a named `migrateEditorState` export so the v9→v10 path can be unit-tested without going through localStorage.
- **`ContentDetailsForm.tsx`** is removed and replaced with the v0.12 `PlaythroughNotesForm.tsx` — the new component owns all five PN fields (Run type, Difficulty + custom, Endings shown, Language patch + custom, Game version + custom) in one block, with the custom-slot inputs only appearing when their parent enum carries one. The Editor page mounts `PlaythroughNotesForm` then `ContentWarningChecklist` then `TechNotesChecklist` inside the Content Details accordion.
- **`description-builder.ts`** — the v0.7 standalone playthrough conditional (`if (input.playthroughStatus !== "none") sections.push(...)`) and the standalone difficulty conditional (`if (input.difficulty !== "none") sections.push(...)`) are gone; replaced with one call to a new `buildPlaythroughNotesSection(input, t, tEn)` helper at slot 1.5. A new `buildTechNotesSection(input, t, tEn)` helper at slot 7.5 mirrors the v0.11 content-warnings render pattern.
### Removed
- **`description.sections.playthrough` / `description.sections.difficulty`** template keys — section heading is now bullet-formatted inside the `▸ 🎮 PLAYTHROUGH NOTES` block via `description.playthroughNotes.labels.*`. The per-status / per-level value labels (`description.playthrough.{blind,replay,…}`, `description.difficulty.{easy,normal,…}`) are kept — the new block reads them for the "Run type" and "Difficulty" bullet values.
- **`ContentDetailsForm.tsx`** — superseded by `PlaythroughNotesForm.tsx`.
### Under the hood
- New `src/config/tech-note-groups.ts` carries the 5-group UI structure (`audio` / `video_quality` / `recording_issues` / `playstyle` / `production`). Engine doesn't read groups — output follows selection order — but the editor uses them to render collapsible sections.
- New `src/config/playthrough-options.ts` exports `LANGUAGE_PATCH_UI_OPTIONS` / `GAME_VERSION_UI_OPTIONS` (Select-friendly `{id, labelKey}` shapes) plus `languagePatchHasCustomSlot` / `gameVersionHasCustomSlot` predicates so the editor knows when to show the paired custom-text input.
- `src/engine/types.ts` adds `LANGUAGE_PATCH_OPTIONS` / `LanguagePatch`, `GAME_VERSION_OPTIONS` / `GameVersion`, `TECH_NOTES` / `TechNote` const-and-type pairs, plus six new optional fields on `GeneratorInput`.
- All 6 locales (en / vi / ja / es / ko / zh) updated with `description.playthroughNotes.{header,intro,labels,languagePatchOptions,gameVersionOptions}` + `description.techNotes.{header,intro,items}` (24 items) + matching editor short labels (`editor.playthroughNotes.*`, `editor.techNoteOptions.*`, `editor.techNoteGroups.*`). `validate:locales` clean at 585 ui + 316 templates per locale.
- Engine tests grow by 14 cases: PN block bullet formatting (en single-language, all five filled), PN block omission when every field is empty, regression that the old standalone `🎯 Playthrough:` and `🎮 DIFFICULTY` lines no longer render, custom-difficulty label passthrough, custom-difficulty blank-label skip, PN bilingual VI mode, PN with `languagePatch: official_other` + custom slot, PN with `gameVersion: custom` + custom slot, TN selection-order preservation, TN bilingual VI / JA modes, TN single-language fallback when `tEn` omitted, TN block omission when list is empty. Plus a new `tests/store/editor-store.migrate.test.ts` with 9 cases covering the v9→v10 migration: default back-fills, preservation of existing playthrough / difficulty / contentWarnings, invalid enum coercion, unknown tech-note id filtering, idempotency on a v10 blob, and null / undefined handling. Full suite: 329 / 329 green.
- Bundle: main chunk 345.85 KB raw / 115.78 KB gzipped (under the 500 KB constraint).
### Migration notes
- No manual action required. First launch after upgrade migrates state in place: pre-v0.12 drafts gain the new PN + TN field defaults; existing `playthroughStatus` / `difficulty` keep their values, the description just renders them under the unified PN header now.
- The Tauri single-instance fix only takes effect after a fresh install of the v0.12 build; existing v0.11 desktop installs need to be uninstalled / replaced. Web builds are unaffected.
## v0.11.0 — 2026-05-06
Three independent features: vendor-aware graphics dropdowns (DLAA + XeSS Ultra Quality joined the ladder, multipliers cap per vendor), a third-party advertising block driven by a per-profile copy field, and a major content-warning overhaul — the v0.7 trio (`spoilerWarning` / `matureWarning` toggles + 3-item checklist) becomes a unified bilingual checklist of 44 items across 5 categories with `EN · output-language` rendering and asterisk-masked Vietnamese terms for YouTube ToS safety.
### Added
- **Vendor-aware upscaling & frame-gen options** — when the creator picks an FG vendor, the upscale-quality and frame-gen-multiplier dropdowns filter to that vendor's actual ladder. NVIDIA exposes DLAA + Quality / Balanced / Performance / Ultra Performance and goes up to x4 multi-frame-gen; AMD keeps FSR Native AA + 4 quality bins and caps at x3 (FSR 3.1); Intel adds XeSS Ultra Quality (its own tier) and ships only x2 (XeFG). Description-builder uses vendor-keyed full labels — `NVIDIA DLAA`, `AMD FSR Quality`, `Intel XeSS Ultra Quality`, `AMD Fluid Motion Frames x3` — instead of the old "brand prefix in code" pattern, so `dlaa` reads `NVIDIA DLAA` not `NVIDIA DLSS DLAA`. Pre-v0.11 drafts / presets / templates with stale combos (e.g. NVIDIA + `native_aa`) coerce to `none` on rehydrate via `coerceUpscaleQuality` + `coerceFrameGenMultiplier` in `src/engine/graphics-vendor.ts`.
- **Third-party advertising block** — new `showThirdPartyAds` toggle in Settings → Description renders a `🤝 SPONSORS & PARTNERS` block in the description, sourced from a new `thirdPartyAdText` Textarea on the channel Profile (multi-line preserved verbatim). Block is gated on toggle ON AND profile field non-empty; toggling on without text is a no-op and surfaces an inline hint pointing the user to Profiles → Edit. Per-profile (not per-video) — partner copy is channel-stable.
- **Bilingual content-warning checklist** — replaces `WarningToggles` with `ContentWarningChecklist`: a searchable, collapsible-grouped checkbox grid covering 44 items across Spoilers / Photosensitive / Phobias / Mental health / Mature & Sensitive. Description format becomes `▸ ⚠️ CONTENT WARNINGS / CẢNH BÁO NỘI DUNG` header (bilingual when output language ≠ English), a two-line intro, then bullets `• {EN} · {local}` separated by U+00B7 MIDDLE DOT — matches the visual format in the v0.11 spec exactly. Selection order is preserved in the rendered output. Vietnamese translations apply asterisk masking on YouTube-ToS-prone terms (`t* tử`, `x*m h*i t*nh d*c`, `g*ết người`, `b*o h*nh`, `ng*y h*i`); other locales use clinical wording (`Sexual assault references`, `Self-harm / suicide themes`, `Violence against minors`).
### Changed
- **Editor store** v8 → v9 (three concerns rolled into one bump): `thirdPartyAdText: ""` default, legacy `spoilerWarning: true` → push `"spoiler_story"` into `contentWarnings` (same for `matureWarning` → `"mature_18plus"`), and vendor-incompatible upscale-quality / multiplier combos coerce to `"none"`. `normalizeEditorPatch` runs the same coercion + boolean-merge logic on every `loadProfile` / `loadPreset` / `loadTemplate` call so legacy snapshots round-trip cleanly.
- **Settings store** v8 → v9 (additive — `showThirdPartyAds: false` default; healed via `initialSettings` spread).
- **Profile store** unversioned → v1 (additive — `thirdPartyAdText: ""` back-fill for pre-v0.11 profiles).
- **Template store** unversioned → v1 (vendor-quality coercion on persisted snapshots).
- **`UPSCALE_QUALITIES`** enum gains `"dlaa"` and `"ultra_quality"`. The flat enum stays — vendor filtering happens at the UI / engine layer via `getValidUpscaleQualities(vendor)` so storage shape doesn't fork per vendor.
- **`ContentDetailsForm`** drops its content-warning ChipGroup (the new `ContentWarningChecklist` mounted in the Editor's Content Details accordion is the new home). Playthrough + difficulty stay where they were.
- **`description-builder`** drops the v0.7 "skip brand on second mention" optimization — both halves of `upscale + framegen` now carry the brand. Worth the mild verbosity for AMD / Intel: AMD's frame-gen brand is `Fluid Motion Frames` (not `Frame Generation`), Intel's is `XeFG`; the old code emitted `Frame Generation` regardless. The 3 separate warning blocks (`spoilerWarning` header, `contentWarnings` bullet list, `matureWarning` header) collapse into one unified bilingual block, placed at the same description position.
### Removed
- **`WarningToggles.tsx`** — superseded by `ContentWarningChecklist.tsx`. Editor-state fields `spoilerWarning` / `matureWarning` stay (marked `@deprecated`) so v8-shaped persisted drafts round-trip through the migration without data loss; they're no longer exposed in the UI and no longer drive description rendering.
- **`description.sections.spoilerWarning` / `matureWarning` / `contentWarnings`** template keys — section heading lives at `description.contentWarnings.header` now. The old per-warning `description.contentWarnings.{flashing_lights,loud_noises,jump_scares}` keys moved under `description.contentWarnings.items.*` alongside 41 new entries.
### Under the hood
- New `src/engine/graphics-vendor.ts` exports `getValidUpscaleQualities` / `getValidFrameGenMultipliers` / `coerceUpscaleQuality` / `coerceFrameGenMultiplier` — pure functions reused by the editor-store migration, the template-store migration, `normalizeEditorPatch`, the `VideoSettingsForm` Select option lists, and the `handleVendorChange` reset path so changing vendors mid-edit doesn't leave the Selects stuck on a stale value.
- New `src/config/content-warning-groups.ts` carries the 5-group UI structure (`spoilers` / `photosensitive` / `phobias` / `mental_health` / `sensitive`). Engine never reads the groups — output ordering follows user selection — but the editor uses them to render collapsible sections with per-group counts so 44 items stay scannable.
- `BuildDescriptionOptions` extends with `tEn?: TranslationFn` — the engine stays framework-agnostic; the caller (`use-generated-output`) builds it via `i18next.getFixedT("en", "templates")` and passes it in alongside the locale-fixed `t`. Falls back to `t` when omitted, so existing callers / unit tests keep working.
- All 6 locales (en / vi / ja / es / ko / zh) updated with vendor-keyed `description.graphics.upscale.{vendor}.{q}` + `description.graphics.frameGen.{vendor}.{m}` maps, vendor-keyed editor short labels (`editor.upscaleQuality.{vendor}.*` / `editor.frameGenMultiplier.{vendor}.*`), 5 group headings, 44 bilingual warning items, 44 short editor labels, plus `settings.showThirdPartyAds` / `settings.thirdPartyAdsHint` and `profiles.thirdPartyAdText{,Placeholder,Help}`. `validate:locales` clean at 529 ui + 274 templates per locale.
- Engine tests grow by 9 cases: vendor-aware DLAA / XeSS Ultra Quality / AMD label rendering, content-warning bilingual EN · VI block, EN-only single-language output, single-language fallback when `tEn` is omitted, censoring snapshot for VI, third-party-ads gating (toggle on + text non-empty, toggle off + text non-empty, toggle on + text empty), multi-line preservation, and selection-order preservation. Two legacy-deprecation tests replace the old `spoilerWarning` / `matureWarning` standalone-block tests. Full suite: 310 / 310 green.
- Bundle: main chunk 313 KB (under the 500 KB constraint).
### Migration notes
- No manual action required. First launch after upgrade migrates state in place: pre-v0.11 drafts with `spoilerWarning: true` / `matureWarning: true` get the equivalent items checked in `contentWarnings`; vendor-incompatible upscale combos coerce to `none`; profile / settings stores back-fill their new defaults.
- Channel partners / affiliates: the toggle in Settings → Description does nothing until you fill `Third-party ad copy` in your profile (Profiles → Edit). The inline hint in Settings calls this out when the toggle is on but the text is empty.
## v0.10.0 — 2026-05-05
Three independent features shipped in [#44](https://github.com/poli0981/youtube-generator/pull/44): a publisher-name tag for the Store Links editor, a hotfix for the live web build that had been serving a blank page since the v0.5 scaffold, and a vertical collapsible sidebar with a new About page.
### Added
- **Pub/Dev Name → tag** ([#44](https://github.com/poli0981/youtube-generator/pull/44)) — when the `Publisher / Developer site` URL is filled in, a free-text "Pub/Dev Name" input appears underneath. Whatever the user types becomes a bare YouTube tag (e.g. `Ubisoft`, `FromSoftware`) via the existing dedup + 30-char trim pipeline. Independent from `sponsorName` / `sponsorPlatform`, which still drive the description's "🎁 Thanks to …" line — different semantic, different output.
- **Vertical collapsible sidebar** ([#44](https://github.com/poli0981/youtube-generator/pull/44)) — replaces the horizontal top tab bar. Hamburger toggle (`PanelLeftClose` / `PanelLeftOpen` from lucide), `w-56 ↔ w-14` width transition, persisted across reloads via the settings store. `Ctrl+B` shortcut wired (VS Code convention) and surfaced in the keyboard help cheatsheet.
- **About page** ([#44](https://github.com/poli0981/youtube-generator/pull/44)) — new `/about` route with app metadata (version pulled live from `package.json`), repo / issues / author / license links, configurable social links (YouTube / X / Discord / Ko-fi / Patreon — empty entries hide their row), and a third-party credits list with versions read live from `package.json` deps. shadcn/ui evaluated and skipped — would have forced a 10+ component retrofit and a token-system swap (`--background` / `--foreground` / `--primary`) for one feature.
### Fixed
- **GitHub Pages white page** ([#44](https://github.com/poli0981/youtube-generator/pull/44)) — the deployed site at `https://poli0981.github.io/youtube-generator/` was blank because Vite's `base` was hardcoded to `/yt-desc-gen/` (an old project name carried over from the v0.5 scaffold). Every asset 404'd. Aligning the base with the actual repo name unblocks the live web build. `public/.nojekyll` added defensively.
### Changed
- **Editor store** v7 → v8 (additive — `pubDevName: ""` default).
- **Settings store** v7 → v8 (additive — `sidebarCollapsed: false` default; healed automatically through `initialSettings` spread).
- **AppShell** layout changed from `flex flex-col` (`Header` / `TabBar` / `main`) to a left-sidebar / right-pane (`Sidebar` / `Header` / `main`). Header stays at the top of the right pane.
### Under the hood
- `tag-generator.ts` gains a `pubDevName` step before the dedup pass; reuses `tagFriendlyGameName(name, 30)` for the per-tag char limit. 4 new tag-generator tests cover emission, empty / whitespace skip, dedup against `sponsorName`, and over-long truncation.
- `TabBar.tsx` renamed to `Sidebar.tsx` (`git mv` to preserve blame).
- New `src/config/about.ts` (single source of truth for app metadata + socials) and `src/config/third-party.ts` (credits with versions auto-derived from `package.json`).
- All 6 locales (en / vi / ja / es / ko / zh) updated with `editor.pubDevName` + `editor.pubDevNamePlaceholder` (F1), plus `tabs.about`, `sidebar.{expand,collapse}`, the full `about.*` namespace including `about.socials.*`, and `shortcuts.toggleSidebar` (F3). `validate:locales` clean at 448 / 448 keys.
- Full suite: 301 tests green; main bundle 277 KB.
### Migration notes
- No manual action required. First launch after upgrade heals any missing keys in place.
- Pre-v0.10 drafts get `pubDevName: ""` and `sidebarCollapsed: false` by default — the fields only become visible once the user fills the publisher URL or toggles the sidebar.
## v0.9.0 — 2026-05-03
Two-phase release. Phase 1 covered the gacha video type and four new URL extractors with a typed-name-mismatch banner; phase 2 wrapped the version with a QoL trio and a four-platform CI release matrix. PRs that landed: [#37](https://github.com/poli0981/youtube-generator/pull/37) (phase 1 B2), [#40](https://github.com/poli0981/youtube-generator/pull/40) (phase 1 B1, re-ship of #38), [#41](https://github.com/poli0981/youtube-generator/pull/41) (phase 2).
### Added
- **Gacha-quest video type** ([#40](https://github.com/poli0981/youtube-generator/pull/40)) — new `VideoType: "gacha_quest"` with a 17-value `gachaQuestType` enum grouped by use case (Story / Events / Tutorial-Trial / Endgame-Multiplayer / Showcase) plus free-form `chapterName` and `questName` extras. `partNumber` is reused, with the suffix wording driven by quest type — `main_story` → `"- Part N"`, `anniversary` + `daily_commission` → `"- Day N"`, `endgame` → `"- Floor N"`, every other quest type drops the suffix. Per-quest-type title format and intro template, single shared pinned-comment greeting.
- **4 new URL extractors** ([#37](https://github.com/poli0981/youtube-generator/pull/37)) — Epic Games Store (locale-prefixed `/p/<slug>`, strips trailing 6+-char hex hash), Nintendo US (`/us/store/products/<slug>`, strips `-switch` / `-switch-2` platform suffix), Nintendo EU (`/<locale>/Games/<segment>/<slug>-<id>.html`, strips trailing numeric id), and Humble Bundle. PlayStation / Xbox / Amazon Luna stay unsupported because their canonical URLs use opaque product IDs.
- **Name-mismatch warning banner** ([#37](https://github.com/poli0981/youtube-generator/pull/37)) — `StoreLinkEditor` shows a reactive banner above the platform grid when any filled link extracts to a name whose tokens aren't a subset of the typed Game Name. New `isLinkNameMismatch(gameName, url)` helper applies a subset-tolerant token comparison; apostrophes are stripped (not spaced) so `Marvel's` matches `Marvels` in Steam slugs. Per-pair dismissal (`gameName|url` fingerprint); banner re-shows automatically when either side changes.
- **Keyboard-shortcuts cheatsheet** ([#41](https://github.com/poli0981/youtube-generator/pull/41)) — bare `?` key now opens the existing modal (Ctrl+/ still works); the `?` handler skips firing when the keydown target is an input / textarea / select / contentEditable element. The modal grows a search input that filters by translated label OR by the literal key combo string.
- **Genre selector search + bulk-toggle** ([#41](https://github.com/poli0981/youtube-generator/pull/41)) — case-insensitive substring filter above the chip group, plus three bulk-select buttons ("All RPGs" / "All Shooters" / "All Horror") that replace the current selection with the first `MAX_GENRES` (3) ids of the matching `GENRE_GROUPS` entry. Filter clears on bulk-toggle.
### Changed
- **Editor store** v6 → v7 (additive — gacha extras `gachaQuestType` / `chapterName` / `questName`).
- **TemplateSnapshot** — extends with the gacha extras as optional so legacy templates load cleanly.
### CI / Release
- **`release-desktop.yml`** ([#41](https://github.com/poli0981/youtube-generator/pull/41)) grows from a Windows-only build to a four-entry matrix: `windows-latest`, `macos-13` (Intel), `macos-14` (ARM), `ubuntu-latest`. `fail-fast: false` so one platform breaking doesn't cancel the others. Linux runner installs `libwebkit2gtk-4.1-dev` + companions for Tauri's webview + AppImage tooling. `tauri-action@v0` collects all artifacts onto a single draft GitHub Release named `YTDescGen v__VERSION__`. No code signing; release notes come from the tag message.
### Under the hood
- New `src/config/gacha-quest-types.ts` houses the 17-value enum, display-order grouping, and the per-quest-type partNumber suffix style map (`GACHA_PART_SUFFIX_STYLES`).
- New `src/config/genres.ts:GENRE_GROUPS` typed `Record<GenreGroupId, readonly GenreId[]>` drives the bulk-toggle buttons.
- All 6 locales updated: 428 ui + 203 template keys each (up from 391 + 164 in v0.8). en + vi fully translated; ja / es / ko / zh seeded with English placeholders for the new strings.
- Full suite: 297 tests green; main bundle 270 KB.
### Migration notes
- No manual action required. First launch after upgrade heals any missing keys in place.
- Pre-v0.9 drafts get `gachaQuestType: "main_story"` and empty `chapterName` / `questName` defaults. The fields only matter when `videoType === "gacha_quest"`.
## v0.8.1 — 2026-05-02
Patch release fixing a v0.8 regression in the genre-playlist suggestion feature.
### Fixed
- **Genre-playlist URL validator** ([#36](https://github.com/poli0981/youtube-generator/pull/36)) accepted only `https://www.youtube.com/playlist?list=…` with the literal `www.` subdomain and rejected any extra query parameters. Real share URLs from YouTube emit `https://youtube.com/…` (no `www.`) or `…&si=…` tracking params, both of which silently failed validation and the `ValidatedInput` component then wiped the entry from the settings store. Now accepts: optional `www.`, `list=…` at any position in the query string with sibling params before/after, and a trailing fragment. `watch?v=…` and `youtu.be/…` short URLs still rejected (path must be `/playlist`).
### Under the hood
- 4 new validation tests cover the relaxed regex (no-www, mixed query order, trailing fragment, `&si=` tracking suffix). Full suite: 253 tests green.
## v0.8.0 — 2026-05-02
Three-PR release covering graphics rebuild, livestream support, pinned-comment polish, and Vietnamese-specific donate fields. PRs that landed: [#32](https://github.com/poli0981/youtube-generator/pull/32) (phase 1), [#33](https://github.com/poli0981/youtube-generator/pull/33) (phase 2), [#34](https://github.com/poli0981/youtube-generator/pull/34) (polish), [#35](https://github.com/poli0981/youtube-generator/pull/35) (version bump).
### Added
- **Graphics Settings v2** — preset is now an enum (`Low` → `Extreme` + `Custom`) instead of free-form text, default `Medium`. New multi-select **Ray Tracing** modes (Ray Tracing / Full Ray Tracing / Path Tracing / Ray Reconstruction), **Frame Generation** vendor + multiplier (NVIDIA / AMD / Intel × x2 / x3 / x4 / x6), **Upscaling Quality** (DLSS / FSR / XeSS quality presets), **Art Style** dropdown, free-form **Driver / Game Version** field, and a **Skip-graphics toggle** for 2D / pixel-art / web games (auto-suggested when a `visual_novel` / `fmv` / `rhythm` genre is added). Description renders a labelled multi-line block: `Video: 1080p - 60 FPS` / `In-game Setting: Cinematic - NVIDIA Frame Generation x2 with Ray Tracing` / `Art Style: …` / `Version: …`.
- **Livestream** — new VideoType with `liveUrl` + `scheduledTime` extras. Title gets `🔴 LIVE` segment, description gets `🔴 LIVE on {{time}}` / `Watch / replay: {{link}}` block (locale-aware datetime via `Intl.DateTimeFormat`), tag pool gets `livestream` / `live gameplay` / `${gameName} live` / `${gameName} stream`, pinned-comment template gets a livestream-specific greeting.
- **Pinned-comment genre playlists** — Settings → Genre Playlists section configures one YouTube playlist URL per genre. When the new `pinnedCommentIncludeGenrePlaylist` toggle is on, the template auto-suggests `📺 More <genre> gameplay on the channel: <link>` for the video's primary genre.
- **Vietnamese donate** — five new editor fields (bank name, account number, account holder, MoMo, ZaloPay) in a new `VietnameseDonateEditor` component. Description block `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ (Việt Nam)` only renders when output language is `vi`; bank line drops the parens when holder is empty; e-wallet lines render independently.
- **Mod List textarea** — new `modList` field exposed alongside `modName` for the `mods` videoType. Description gets a `🧩 MOD LIST` block right after MY RIG.
- **Publisher / Developer site** — 10th store-link platform with a permissive HTTPS pattern for indie / niche releases.
- **URL paste auto-extract** — pasting a Steam / itch.io / GOG URL into a store-link input auto-fills an empty Game Name with a 5s Undo toast. Other storefronts skipped because their URL slugs aren't stable.
- **YouTube playlist URL validator** — `validatePlaylistUrl` for the editor's playlist-link field and the new Genre Playlists settings. (Note: a regression in the strict regex shipped here; corrected in v0.8.1.)
### Fixed
- **Long-game-name tag bug** ([#32](https://github.com/poli0981/youtube-generator/pull/32)) — composite tags built from a long game name (`Tony Hawk's Pro Skater 1+2 Remastered: Definitive Edition`) used to silently disappear because they exceeded YouTube's 30-char per-tag limit. New `tagFriendlyGameName` helper strips trademark marks + edition qualifiers, then composes ≤21-char form for composite tags + bare ≤30-char form. The game name now always lands in the tag list.
### Changed
- **Editor store**: v4 → v5 (graphics enum + livestream + new fields, legacy `graphicsPreset` text mapped via `legacyGraphicsPresetToEnum`); v5 → v6 (additive — VN donate fields + modList).
- **Settings store**: v6 → v7 (additive — `genrePlaylists` map + the new pinned-comment toggle).
- **TemplateSnapshot** — extended to capture the v0.7 phase 2 fields that had been missing (`playthroughStatus`, `difficulty`, `difficultyCustomLabel`, `contentWarnings`) plus all v0.8 fields. Saving a template now preserves full editor state.
- **Video Settings description block** — was a single pipe-separated line `1080p | 60 FPS | Cinematic Setting - …`, now multi-line with explicit labels matching the rig + timestamps shape.
### Under the hood
- New `src/config/graphics-settings.ts` houses every graphics-related enum + the `GENRES_WITHOUT_GRAPHICS_SETTINGS` allowlist for the auto-suggest hint.
- New `src/utils/url-extractors.ts` implements Steam / itch.io / GOG slug extraction with a shared `titleCase` helper.
- Brand-name table (`VENDOR_GFX_BRANDS`) is engine-internal and English-only across locales (DLSS / FSR / XeSS preserved verbatim for SEO).
- All 6 locales updated: 391 ui + 164 template keys each. Vietnamese fully translated; ja / es / ko / zh seeded with English defaults for the new strings.
- Full suite: 249 tests green; main bundle 239 KB.
### Migration notes
- No manual action required. First launch after upgrade heals any missing keys in place.
- Pre-v0.8 free-form `graphicsPreset` text values map automatically: known labels ("Ultra", "Very High", …) become enum values; anything else lands in the new Custom slot ("Epic" → `graphicsPreset: "custom"` + `graphicsPresetCustom: "Epic"`).
- Existing `Profile` and `TemplateSnapshot` shapes are TS-extended to the v0.8 enum types; legacy on-disk values round-trip via `normalizeEditorPatch` on `loadProfile` / `loadPreset`.
## v0.7.0 — 2026-04-24
Two-phase release. Phase 1 landed as [#30](https://github.com/poli0981/youtube-generator/pull/30); this entry is cumulative across both phases.
+8 -7
View File
@@ -4,18 +4,18 @@
**YTDescGen** is a desktop-capable web application that generates YouTube video titles, descriptions, and tags for Gameplay No Commentary channels. It supports multiple languages, game genres, and video types with a profile/preset system to eliminate repetitive data entry.
- **Repository**: `github.com/poli0981/yt-desc-gen` (private)
- **License**: MIT
- **Repository**: `github.com/poli0981/youtube-generator`
- **License**: Apache-2.0 (see `LICENSE` + `NOTICE`)
- **Primary Language**: TypeScript
- **Stack**: React 18 + Vite + Tailwind CSS + Zustand + Tauri (desktop)
- **Target Platforms**: Web (GitHub Pages), Desktop (Windows/macOS via Tauri)
- **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
| 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 |
@@ -40,13 +40,14 @@ yt-desc-gen/
├── index.html
│
├── docs/ # Project documentation
│ ├── PRD.md # Product Requirements Document
│ ├── DEVELOPMENT.md # Toolchain / IDE / build commands (EN)
│ ├── ARCHITECTURE.md # Technical architecture
│ ├── FEATURES.md # Complete feature list
│ ├── ROADMAP.md # Development phases
│ ├── TECH-SPEC.md # Technical specifications
│ ├── I18N.md # Internationalization guide
│ └── PACKAGING.md # Desktop packaging guide
│ ├── PACKAGING.md # Desktop packaging guide
│ └── i18n/vi/ # Vietnamese mirrors (DEVELOPMENT, DISCLAIMER)
│
├── src/
│ ├── main.tsx # Entry point
+22
View File
@@ -0,0 +1,22 @@
# Code of Conduct
This project adopts the **[Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)** in full.
By participating in this project — opening issues, submitting pull requests, commenting, translating locales, or any other form of contribution — you agree to abide by its terms.
## Reporting
Report violations privately to the maintainer: `lopop05905@proton.me`.
All reports are reviewed and investigated promptly and fairly. The maintainer is obligated to respect the privacy and security of the reporter.
## Enforcement
Examples of enforcement actions, in escalating order:
1. A private warning.
2. A public warning on the relevant issue / PR.
3. A temporary ban from contributing.
4. A permanent ban — applied without warning for serious violations (harassment, threats, malicious code submissions per [`CONTRIBUTING.md`](./CONTRIBUTING.md) auto-ignore rules).
For the full list of enforcement guidelines, read the [Contributor Covenant v2.1 — Enforcement Section](https://www.contributor-covenant.org/version/2/1/code_of_conduct/#enforcement).
+80
View File
@@ -0,0 +1,80 @@
# Contributing to YTDescGen
Thanks for taking the time to contribute. Read this once before opening your first PR — it saves time on both sides.
## Code of Conduct
Participation is governed by the [Code of Conduct](./CODE_OF_CONDUCT.md). By contributing, you agree to its terms.
## Getting Started
1. Read the [Development Guide](./docs/DEVELOPMENT.md) — also available in [Vietnamese](./docs/i18n/vi/DEVELOPMENT.md).
2. Install dependencies: `npm install`.
3. Start the dev server: `npm run dev`.
4. Before opening a PR run all gates:
```bash
npm run typecheck
npm run lint
npm run validate:locales
npm run test:run
```
## How to Contribute
### Issues
Use the templates in `.github/ISSUE_TEMPLATE/`:
- **Bug report** — only if you can reproduce on the latest release.
- **Feature request** — only with a concrete use case, not abstract requests.
### Pull Requests
- Branch from `dev`, not `main`.
- Commit format: `type(scope): message` — e.g. `feat(engine): add Spanish template support`. Types: `feat`, `fix`, `refactor`, `docs`, `test`, `ci`, `chore`.
- One logical change per PR. Don't bundle unrelated refactors.
- All locale files must stay in lock-step — see the i18n section below.
- AI-assisted contributions are welcome but **must be disclosed** in the PR description.
### i18n Contributions
If your change adds or removes any user-facing string:
1. Update the locale schema at `src/i18n/locales/_schema.json` first.
2. Add the key to **all 6 locales** (`en` / `vi` / `ja` / `es` / `ko` / `zh`).
3. `npm run validate:locales` must pass.
Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially welcome — see [DISCLAIMER.md](./DISCLAIMER.md) for the current translation-quality status.
## Auto-ignored Contributions
The following are closed without review and may result in a contributor ban — no exceptions:
- **Suspected malicious code.** If a PR contains code we suspect may be a supply-chain attack, obfuscation, credential harvesting, cryptominer, or any form of malware — even if CodeQL and Dependabot don't flag it, the maintainer may investigate manually. **Detection equals ban.**
- **Unverified or suspicious links** in issues, PRs, or comments (pastebin scrapers, redirect chains, unfamiliar shortlinks, link-shortener URLs without context).
- **Behavior or language violating** [GitHub's Acceptable Use Policies](https://docs.github.com/en/site-policy/acceptable-use-policies).
- **Off-topic / rambling reports** that don't get to the point. Example of what gets ignored: *"Good morning, today is a beautiful day, I was just wondering if maybe…"* — get straight to the problem.
- **PRs that touch hundreds of files for a one-line fix** (typical sign of an auto-formatter run on unrelated files).
- **Tests deleted, or `--no-verify` used to bypass pre-commit hooks.**
- **"AI rewrote my entire codebase in a different style" PRs.** AI-assisted edits are welcome (disclosed); whole-repo rewrites are not.
- **Spam, drive-by typo fixes** that don't address a real issue, and karma-farming PRs.
## What We Want
- Bug fixes with a reproduction case and a regression test.
- Locale corrections from native speakers.
- New content-warning IDs with all 6 translations and a clear rationale (especially horror-genre vocabulary).
- New video types or genres that fit the gameplay no-commentary use case.
- Accessibility and mobile-responsive improvements.
- Performance fixes with a `before/after` measurement.
## What We Don't Want
- Cosmetic refactors with no behavior change.
- Adding new runtime dependencies without first opening an issue to discuss the tradeoff.
- Renaming files without coordinating with open PRs.
- Changes to the LICENSE or NOTICE files (these are governance, not contributions).
## License
By contributing, you agree your contribution will be licensed under the [Apache License 2.0](./LICENSE), the same license as the project, and that you have the right to grant that license.
+53
View File
@@ -0,0 +1,53 @@
# Disclaimer
## Solo project, AI-assisted
YTDescGen is a personal project built by a single maintainer (`@poli0981`) for use with the [`@SkullMute`](https://www.youtube.com/@SkullMute) YouTube channel and shared publicly as open source. It is **not a commercial product** and there is no support obligation.
Code, documentation, locale translations, and design decisions in this repository were **co-authored with the assistance of Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. All commits, releases, and architectural decisions are reviewed and approved by the maintainer before merging.
This disclosure applies to:
- Source code in `src/` and `src-tauri/`.
- Documentation in `docs/` and all root markdown files.
- Locale files in `src/i18n/locales/`.
- CI/CD workflows in `.github/workflows/`.
See also: [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) § "AI-Assisted Development Disclosure".
## Translation quality
The application UI ships in six languages. Authoring quality varies:
| Locale | Authoring | Notes |
| --- | --- | --- |
| English (`en`) | Maintainer + AI | Primary working locale. Strings reviewed before commit. |
| Vietnamese (`vi`) | Maintainer (native) + AI | Reviewed by the maintainer, who is a native Vietnamese speaker. |
| Japanese (`ja`) | AI-translated | Not native-reviewed. Grammar and tone may be imperfect. |
| Spanish (`es`) | AI-translated | Not native-reviewed. Regional voice (LatAm vs. Castilian) not specifically targeted. |
| Korean (`ko`) | AI-translated | Not native-reviewed. Honorific register chosen for neutrality, not specific cultural fit. |
| Chinese (`zh`) | AI-translated | Simplified Chinese only. Not native-reviewed. |
If you're a native speaker and spot mistranslations, please open an issue or PR — see [CONTRIBUTING.md](./CONTRIBUTING.md) § "i18n Contributions".
## Voice and tone
Generated description templates use an opinionated tone tailored to the **gameplay no-commentary** YouTube niche, with extra emphasis on horror / scary games (because that's the maintainer's channel). The output may not fit every channel's voice or every country's reader expectations. The application is template-driven — you can edit any generated text before publishing.
Some Vietnamese phrasings deliberately keep loanwords and casual tone reflecting how Vietnamese gameplay creators commonly write descriptions. These are not "incorrect translations"; they are stylistic choices for the target audience.
## No warranty
This software is provided **as-is, with no warranty of any kind**. See [`LICENSE`](./LICENSE) (Apache 2.0) §§ 7 and 8 for the full disclaimer of warranty and limitation of liability.
In plain English: if the application crashes, mangles your draft, generates a description that gets your video flagged by YouTube, or causes any other harm — the maintainer is not liable. Use at your own risk; back up your drafts.
## Not affiliated with YouTube / Anthropic
YTDescGen is **not** affiliated with, endorsed by, or sponsored by YouTube, Google LLC, or Alphabet Inc. The generated output is intended to be pasted into the YouTube Studio editor; this application does not interact with the YouTube API.
Use of Claude Code during development does **not** make this an Anthropic product. Anthropic, Claude, and Claude Code are trademarks of Anthropic, PBC. This project is independent.
## Not legal or financial advice
Any mention of GDPR, CCPA, copyright law, YouTube's monetization policies, or similar topics in this repository's documentation is provided for orientation only and is **not legal advice**. Consult a qualified lawyer in your jurisdiction if you need an authoritative answer.
+201
View File
@@ -0,0 +1,201 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for describing the origin of the Work and
reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Support. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or support.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the License for the specific language governing permissions and
limitations under the License.
+28
View File
@@ -0,0 +1,28 @@
# Maintainers
## Active Maintainers
### `@poli0981`
- **GitHub**: <https://github.com/poli0981>
- **YouTube** (reference channel): <https://www.youtube.com/@SkullMute>
- **Email** (security & private contact): `lopop05905@proton.me`
- **Areas of responsibility**: all — core engine, locale management, UI, Tauri desktop shell, releases, CI/CD.
## Maintainer Responsibilities
- Triage incoming issues and PRs.
- Run the release process: `CHANGELOG.md` entry, version bump, build artifacts, signed tag.
- Enforce the [Code of Conduct](./CODE_OF_CONDUCT.md).
- Review and approve locale translation contributions.
- Coordinate security advisory disclosure per [SECURITY.md](./SECURITY.md).
## Becoming a Maintainer
There is currently no formal pathway. The project has been solo since inception. If you'd like to help maintain a specific area — most realistically, native-speaker review for one of the AI-translated locales (JA / ES / KO / ZH) — open an issue describing what you'd like to take on.
Persistent, high-quality contributions over time are the path. There is no application form.
## Past Maintainers
None — solo project since v0.1.0.
+15
View File
@@ -0,0 +1,15 @@
YTDescGen — YouTube Gameplay Description Generator
Copyright 2026 poli0981 (https://github.com/poli0981)
This product includes software developed by poli0981 and contributors.
Licensed under the Apache License, Version 2.0 (the "License");
see LICENSE for the full terms, or visit:
http://www.apache.org/licenses/LICENSE-2.0
This product was co-developed with the assistance of Anthropic's
Claude Code 4.7 Opus (1M context). See DISCLAIMER.md and
THIRD_PARTY_NOTICES.md for details.
Third-party dependencies retain their respective licenses; see
THIRD_PARTY_NOTICES.md for the complete attribution list.
+75
View File
@@ -0,0 +1,75 @@
# Privacy Policy
**Effective:** 2026-05-14
YTDescGen is an **offline-first** template engine for generating YouTube video metadata. This document describes what data the application handles, where it lives, and what it never collects.
## What We Collect
**Nothing.** The application sends no data to any server controlled by the maintainer.
There is no analytics provider, no telemetry, no crash reporter, no A/B testing, no advertising network, no behavioral tracking. There is no backend.
## What Stays on Your Device
### Web version (GitHub Pages)
The web build stores your work in your browser's **`localStorage`** only. Keys used:
| Key prefix | Purpose |
| --- | --- |
| `ytdesc:editor` | Current editor draft |
| `ytdesc:settings` | Theme, default language, accordion state, hashtag preferences |
| `ytdesc:profiles` | Saved channel / social / rig profiles |
| `ytdesc:presets` | Saved game presets |
| `ytdesc:templates` | Saved full-form snapshots |
| `ytdesc:history` | Recently generated outputs |
| `ytdesc:logs` | Application event log |
`localStorage` is scoped to the origin and never transmitted. Clearing your browser data, browsing in a private/incognito window, or signing out wipes all of it.
### Desktop version (Tauri)
The desktop build uses the operating system's standard application-data directory:
- **Windows**: `%APPDATA%\com.skullmute.ytdescgen`
- **macOS**: `~/Library/Application Support/com.skullmute.ytdescgen`
- **Linux**: `~/.config/com.skullmute.ytdescgen`
The same key set as the web version is stored as JSON files there. Uninstalling the application or deleting that directory removes everything.
## Third-Party Services
The application does **not** call third-party APIs at runtime.
Optional links you may click — donation buttons, store links you paste into a draft, social links you save to your profile — navigate **away** from the application to third-party sites. Those sites have their own privacy policies; the maintainer is not responsible for them.
YouTube oEmbed, the Steam store API, Twitch helix, and similar services are **not** fetched by this application.
## Cookies / Local Storage Distinction
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.
## GDPR / CCPA / Equivalent Rights
Because no data ever leaves your device:
- **Right to access**: your data is already accessible — open DevTools → Application → Local Storage on the web, or browse the application-data directory on desktop.
- **Right to erasure**: clear your browser's site data (web) or delete the application-data directory / uninstall the app (desktop).
- **Right to portability**: use the in-app **Export** action in `Profiles` / `Presets` / `Templates` / `History` / `Logs` to download JSON.
- **Right to object / restrict processing**: not applicable — no processing happens off-device.
- **Right to know what is sold or shared**: nothing. Nothing is sold or shared.
## Changes to This Policy
If this policy changes, the change is committed to the repository under `PRIVACY.md` with the `Effective` date updated. There is no notification mechanism because the application has no way to reach you.
## Contact
`lopop05905@proton.me`
+100 -34
View File
@@ -1,56 +1,122 @@
# 🎮 YTDescGen
**YouTube Gameplay Description Generator** — A template engine for Gameplay No Commentary channels.
**YouTube Gameplay Description Generator** — an offline-first template engine for Gameplay No Commentary YouTube channels.
Generate YouTube video titles, descriptions, and tags in multiple languages with one click.
Generate YouTube titles, descriptions, and tags in six languages with one click. Save channel, rig, and game presets to skip repetitive data entry. Works in the browser (GitHub Pages) or as a ~8 MB native desktop app (Tauri).
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
[![Node](https://img.shields.io/badge/node-%E2%89%A522-brightgreen)](./docs/DEVELOPMENT.md)
[![Latest release](https://img.shields.io/github/v/release/poli0981/youtube-generator?include_prereleases)](https://github.com/poli0981/youtube-generator/releases)
[![Last commit](https://img.shields.io/github/last-commit/poli0981/youtube-generator)](https://github.com/poli0981/youtube-generator/commits)
---
## What is YTDescGen
YTDescGen is a single-purpose template engine. It does **one** job: turn a small set of structured fields (video type, game name, genres, rig, social links, content warnings, …) into a publish-ready YouTube title + description + tag set.
It doesn't talk to the YouTube API. It doesn't upload anything. It doesn't track you. There is no server. State lives in your browser's `localStorage` (web) or your OS application-data directory (desktop) — and nowhere else.
Built for the gameplay no-commentary niche — especially horror / scary games — by someone running the [@SkullMute](https://www.youtube.com/@SkullMute) channel who got tired of pasting the same boilerplate into every video. Released under Apache 2.0 in case it's useful to anyone else.
## Features
- **14 video types** — Full Gameplay, Part, Boss Fight, Speedrun, 100%, DLC, and more
- **12 languages** — English, Vietnamese, Japanese, Spanish, Korean, Chinese, and more
- **25 game genres** — Action, Horror, RPG, FPS, Open World, Souls-like, and more
- **Profile system** — Save social/rig/channel info once, reuse forever
- **Game presets** — Save game info once, reuse for multi-part series
- **Smart tags** — Auto-generated from genre + platform + quality + multilingual
- **Character counters** — Real-time limits for title (100), description (5000), tags (500)
- **Batch mode** — Generate descriptions for multiple parts at once
- **Desktop app** — Windows & macOS via Tauri (~8MB binary)
- **Offline** — Full functionality without internet
- **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.
- **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.
- **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).
## Quick Start
```bash
# Clone
git clone https://github.com/poli0981/yt-desc-gen.git
git clone https://github.com/poli0981/youtube-generator.git
cd yt-desc-gen
# Install
npm install
# Dev
npm run dev
# Build
npm run build
npm run dev # web dev server at http://localhost:5173
```
Desktop build (Windows / macOS / Linux):
```bash
npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}
```
Full development setup, IDE config, and troubleshooting: see [`docs/DEVELOPMENT.md`](./docs/DEVELOPMENT.md). Vietnamese version: [`docs/i18n/vi/DEVELOPMENT.md`](./docs/i18n/vi/DEVELOPMENT.md).
## Use Cases
- **Gameplay no-commentary channels** — the primary target. Default templates assume no voice-over and lean on visual hooks, music attribution, and timestamps.
- **Horror / scary-game channels** — the content-warning system is especially deep here (analog horror, liminal spaces, pursuit / chase, entity / SCP-style, body horror, etc.).
- **Demo / Early Access playthroughs** — dedicated video types and language-patch / game-version disclosure fields.
- **Speedrunners and 100% completionists** — playstyle disclosures, run-type metadata, and difficulty fields.
- **Solo creators tired of copy-paste** — profiles and presets exist specifically to eliminate repetitive data entry.
## Privacy & Offline-First
Nothing leaves your device. No analytics, no telemetry, no tracking. The web version stores your work in `localStorage`; the desktop version stores it in the OS application-data directory. Clearing site data (web) or uninstalling the app (desktop) wipes everything. Full details in [PRIVACY.md](./PRIVACY.md).
## Tech Stack
React 18 • TypeScript • Vite • Tailwind CSS • Zustand • i18next • Tauri 2
React 18 · TypeScript (strict) · Vite 8 · Tailwind CSS 3 · Zustand · i18next · Tauri 2 (Rust stable).
Architecture overview: [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
## Documentation
| Document | Description |
|----------|-------------|
| [CLAUDE.md](./CLAUDE.md) | Claude Code instructions & project overview |
| [PRD](./docs/PRD.md) | Product Requirements Document |
| [Architecture](./docs/ARCHITECTURE.md) | Technical architecture & data flow |
| [Features](./docs/FEATURES.md) | Complete feature list |
| [Roadmap](./docs/ROADMAP.md) | Development phases & timeline |
| [Tech Spec](./docs/TECH-SPEC.md) | Implementation details & configs |
| [i18n Guide](./docs/I18N.md) | How to add new languages |
| [Packaging](./docs/PACKAGING.md) | Desktop app build guide |
| Document | What's in it |
| --- | --- |
| [Development Guide](./docs/DEVELOPMENT.md) | Toolchain, IDE setup, build commands, troubleshooting. *(Also: [Vietnamese](./docs/i18n/vi/DEVELOPMENT.md).)* |
| [Architecture](./docs/ARCHITECTURE.md) | Layer model, data flow, engine design. |
| [Features](./docs/FEATURES.md) | Full feature matrix. |
| [Content Inventory](./docs/CONTENT-INVENTORY.md) | Every video type, genre, and content warning the editor surfaces. *(Also: [Vietnamese](./docs/i18n/vi/CONTENT-INVENTORY.md).)* |
| [Roadmap](./docs/ROADMAP.md) | Development phases. |
| [Tech Spec](./docs/TECH-SPEC.md) | Implementation details and configs. |
| [i18n Guide](./docs/I18N.md) | Adding new locales. |
| [Packaging](./docs/PACKAGING.md) | Tauri release builds and signing. |
| [Contributing](./CONTRIBUTING.md) | PR process, commit conventions, auto-ignore rules. |
| [Security](./SECURITY.md) | Reporting vulnerabilities. |
| [Privacy](./PRIVACY.md) | Data handling (TL;DR: none). |
| [Disclaimer](./DISCLAIMER.md) | AI-assistance and translation-quality disclosure. *(Also: [Vietnamese](./docs/i18n/vi/DISCLAIMER.md).)* |
| [Terms of Use](./TERMS.md) | Acceptable use and license compliance. |
| [Code of Conduct](./CODE_OF_CONDUCT.md) | Contributor Covenant v2.1. |
| [Maintainers](./MAINTAINERS.md) | Who runs this. |
| [Third-Party Notices](./THIRD_PARTY_NOTICES.md) | Dependency attribution. |
| [Changelog](./CHANGELOG.md) | Per-release notes. |
## Contributing
PRs welcome — read [CONTRIBUTING.md](./CONTRIBUTING.md) first. Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially appreciated.
## License
MIT
Licensed under the **[Apache License 2.0](./LICENSE)**. See [`NOTICE`](./NOTICE) for the copyright statement and [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) for dependency licenses.
## AI Disclosure
This project was co-authored with **Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. Source code, locale translations, documentation, and CI workflows were generated or edited with AI assistance, then reviewed by the human maintainer (`@poli0981`) before being committed. See [DISCLAIMER.md](./DISCLAIMER.md) for the full disclosure.
## Channel & Socials
Reference channel and maintainer links:
- **YouTube**: [@SkullMute](https://www.youtube.com/@SkullMute)
- **X / Twitter**: [@SkullMute0011](https://x.com/SkullMute0011)
- **Bluesky**: [skullmute0011.bsky.social](https://bsky.app/profile/skullmute0011.bsky.social)
- **Mastodon**: [@skullmute1122@mastodon.social](https://mastodon.social/@skullmute1122)
- **Discord** (project / repo): [join](https://discord.gg/2aNR3aVt)
- **Discord** (gaming): [join](https://discord.gg/kDM9GMu5vm)
- **Steam**: [profile](https://steamcommunity.com/profiles/76561199544666292/)
- **Patreon / Ko-fi**: `skullmute`
- **Telegram**: `@SkullMute0011` (bot: `@my_skull_bot`)
- **Email** (security & private contact): `lopop05905@proton.me`
+50
View File
@@ -0,0 +1,50 @@
# Security Policy
## Supported Versions
Only the latest released version of YTDescGen receives security updates. This is a solo open-source project; there are no LTS branches.
| Version | Supported |
| ------- | --------- |
| 0.13.x | ✅ |
| < 0.13 | ❌ |
## Reporting a Vulnerability
Please report security issues **privately**. Do not open a public issue.
**Preferred channels (in order):**
1. **GitHub Security Advisory** — open a draft advisory in this repository's `Security` tab.
2. **Email** — `lopop05905@proton.me` with subject prefix `[SECURITY]`.
Include:
- A description of the issue and its potential impact.
- Steps to reproduce, ideally a minimal proof-of-concept.
- The affected version (`node -p "require('./package.json').version"`).
- Whether the issue is already public.
## Response Timeline
- **Initial reply**: within 7 days.
- **Triage + planned fix**: within 30 days for high-severity issues.
- **Disclosure**: coordinated with the reporter after a fix ships, or at most 90 days from initial reply.
## Scope
In scope:
- The web bundle deployed to GitHub Pages.
- The Tauri desktop binaries (Windows, macOS, Linux).
- CI/CD workflows in `.github/workflows/`.
Out of scope:
- Vulnerabilities in third-party dependencies — report those upstream and we'll bump.
- Issues requiring physical access to the user's device.
- Self-XSS in user-supplied template content (the app deliberately renders user input as plain text in the preview).
## No Bounty
This is a solo open-source project. Credit in release notes and a thank-you in `MAINTAINERS.md` is the only reward we can offer.
+67
View File
@@ -0,0 +1,67 @@
# Terms of Use
**Effective:** 2026-05-14
These terms govern your use of YTDescGen — both the web version hosted at the project's GitHub Pages URL and any Tauri desktop binaries distributed under this project.
## License
YTDescGen is licensed under the **[Apache License 2.0](./LICENSE)**. You may use, modify, and redistribute it under those terms.
Apache 2.0 grants a patent license (Section 3) and an irrevocable copyright license (Section 2). It does **not** grant trademark rights — see Section 6 of the LICENSE.
## Acceptable Use
You may use YTDescGen for any lawful purpose. You may **not** use it to:
- Generate content that harasses, threatens, defames, or incites violence against any person or group.
- Generate content intended to mislead or impersonate (faked attribution, false sponsor disclosure, deepfake-adjacent metadata).
- Generate content that violates any third party's intellectual-property rights (including misleading copyright or licensing claims in descriptions).
- Distribute modified versions of YTDescGen in a way that violates Apache-2.0 — e.g. stripping copyright notices, omitting the NOTICE file, falsely indicating endorsement.
- Violate applicable law in your jurisdiction, including but not limited to **GDPR** (EU), **CCPA / CPRA** (California), **PIPL** (China), **LGPD** (Brazil), the **Vietnamese Cybersecurity Law**, or equivalent data-protection / cybercrime regulation in your country.
- Bypass YouTube's policies on metadata (misleading thumbnails / titles / tags) using the application.
## GitHub Terms
If you use the web version hosted on GitHub Pages, your use is also subject to:
- [GitHub's Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service)
- [GitHub's Acceptable Use Policies](https://docs.github.com/en/site-policy/acceptable-use-policies)
These apply alongside this document; in case of conflict, GitHub's policies govern the hosted artifact.
## No Warranty
See [DISCLAIMER.md](./DISCLAIMER.md) and `LICENSE` §§ 7–8. The software is provided **as-is** with no warranty of any kind, express or implied.
## Generated Content
YTDescGen produces text intended to be pasted into YouTube descriptions. **You — the operator pasting that text — are solely responsible for**:
- Confirming the generated description complies with [YouTube's Community Guidelines](https://www.youtube.com/howyoutubeworks/policies/community-guidelines/) and [YouTube's Terms of Service](https://www.youtube.com/static?template=terms).
- Disclosing paid promotions, sponsorships, and any AI-generated portions per YouTube's monetization and disclosure rules.
- Not including misleading information, copyright-infringing material, or any prohibited content listed in YouTube's policies.
- Truthful representation of run-type, difficulty, blind status, mod / cheat usage, and similar disclosures the application optionally exposes.
## Contributions
By submitting a contribution (issue, pull request, comment, locale translation, screenshot, log dump), you agree:
1. Your contribution is licensed under Apache 2.0, the same as the project.
2. You have the right to grant that license (you wrote it, or it's compatibly licensed and credited).
3. You will not include malicious code or knowingly vulnerable dependencies.
4. You will follow the [Code of Conduct](./CODE_OF_CONDUCT.md) and [Contributing Guide](./CONTRIBUTING.md).
Violations may result in your contribution being closed and, in severe cases, a permanent ban from the repository — see `CONTRIBUTING.md` § "Auto-ignored Contributions".
## Termination
These terms remain in effect for as long as you use the software. Your rights under Apache 2.0 are perpetual subject to that license's termination clauses (notably § 3 patent retaliation).
## Changes
Updates to these terms are committed under `TERMS.md` with the `Effective` date updated. Continued use of the software after a change constitutes acceptance.
## Contact
`lopop05905@proton.me`
+79
View File
@@ -0,0 +1,79 @@
# Third-Party Notices
YTDescGen incorporates the following third-party software. Each dependency retains its own license; consult the linked project page for the full text of each license.
## Runtime Dependencies (web bundle)
| Package | Version | License | Project |
| --- | --- | --- | --- |
| `react` | ^18.3.0 | MIT | <https://github.com/facebook/react> |
| `react-dom` | ^18.3.0 | MIT | <https://github.com/facebook/react> |
| `react-router-dom` | ^6.26.0 | MIT | <https://github.com/remix-run/react-router> |
| `react-i18next` | ^15.0.0 | MIT | <https://github.com/i18next/react-i18next> |
| `i18next` | ^23.15.0 | MIT | <https://github.com/i18next/i18next> |
| `zustand` | ^4.5.0 | MIT | <https://github.com/pmndrs/zustand> |
| `react-hot-toast` | ^2.4.0 | MIT | <https://github.com/timolins/react-hot-toast> |
| `lucide-react` | ^0.400.0 | ISC | <https://github.com/lucide-icons/lucide> |
| `clsx` | ^2.1.0 | MIT | <https://github.com/lukeed/clsx> |
| `@tauri-apps/api` | ^2.11.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `@tauri-apps/plugin-dialog` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `@tauri-apps/plugin-fs` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `@tauri-apps/plugin-opener` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `@tauri-apps/plugin-shell` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
## Build / Dev Dependencies
| Package | Version | License | Project |
| --- | --- | --- | --- |
| `vite` | ^7.3.3 | MIT | <https://github.com/vitejs/vite> |
| `@vitejs/plugin-react` | ^4.3.0 | MIT | <https://github.com/vitejs/vite-plugin-react> |
| `typescript` | ^5.5.0 | Apache-2.0 | <https://github.com/microsoft/TypeScript> |
| `tsx` | ^4.16.0 | MIT | <https://github.com/privatenumber/tsx> |
| `tailwindcss` | ^3.4.0 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `prettier-plugin-tailwindcss` | ^0.6.0 | MIT | <https://github.com/tailwindlabs/prettier-plugin-tailwindcss> |
| `postcss` | ^8.5.14 | MIT | <https://github.com/postcss/postcss> |
| `autoprefixer` | ^10.4.0 | MIT | <https://github.com/postcss/autoprefixer> |
| `eslint` | ^9.0.0 | MIT | <https://github.com/eslint/eslint> |
| `@eslint/js` | ^9.0.0 | MIT | <https://github.com/eslint/eslint> |
| `eslint-plugin-react-hooks` | ^5.0.0 | MIT | <https://github.com/facebook/react> |
| `typescript-eslint` | ^8.0.0 | MIT | <https://github.com/typescript-eslint/typescript-eslint> |
| `prettier` | ^3.3.0 | MIT | <https://github.com/prettier/prettier> |
| `vitest` | ^3.2.4 | MIT | <https://github.com/vitest-dev/vitest> |
| `@testing-library/react` | ^16.0.0 | MIT | <https://github.com/testing-library/react-testing-library> |
| `@testing-library/jest-dom` | ^6.4.0 | MIT | <https://github.com/testing-library/jest-dom> |
| `@types/react` | ^18.3.0 | MIT | DefinitelyTyped |
| `@types/react-dom` | ^18.3.0 | MIT | DefinitelyTyped |
## Tauri Desktop (Rust crates)
| Crate | Version | License | Project |
| --- | --- | --- | --- |
| `tauri` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-build` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-plugin-dialog` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-fs` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-opener` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-shell` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-single-instance` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `serde` | ^1 | Apache-2.0 OR MIT | <https://github.com/serde-rs/serde> |
| `serde_json` | ^1 | Apache-2.0 OR MIT | <https://github.com/serde-rs/json> |
Transitive dependencies are not enumerated here. `cargo tree` (in `src-tauri/`) and `npm list --all` produce the exhaustive trees; this list covers the direct dependencies declared in `package.json` and `src-tauri/Cargo.toml`.
## Fonts & Icons
The application uses **system fonts** (`Inter` / `SF Pro` / `Segoe UI` / `Roboto`, fallback `sans-serif`). No custom font files are bundled in the web build.
Icons are provided by [`lucide-react`](https://github.com/lucide-icons/lucide) (ISC license — see above).
## AI-Assisted Development Disclosure
Per [`DISCLAIMER.md`](./DISCLAIMER.md), this project was co-authored with **Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. The model contributed to source code, locale translations, documentation, and CI configuration. All output was reviewed by the human maintainer (`@poli0981`) before being committed.
No third-party content was reproduced verbatim from the model's training data. Any external text quoted in this repository (notably the Apache License 2.0 in [`LICENSE`](./LICENSE) and the Contributor Covenant link in [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md)) is sourced from canonical public locations.
Claude is a product of Anthropic, PBC — <https://www.anthropic.com>. No license is granted by Anthropic to use this project; the Apache 2.0 license in `LICENSE` is granted by `@poli0981` as the project author.
## Reporting an Omission
If you believe a dependency is missing from this list, please open an issue or PR per [`CONTRIBUTING.md`](./CONTRIBUTING.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 |
+161
View File
@@ -0,0 +1,161 @@
# Content Inventory
A static manifest of every video type, game genre, and content warning surfaced in YTDescGen's editor. Maintained manually — when adding a new option to one of the source files below, **add a row here too** in the same PR.
This file exists for **transparency** — anyone curious about what the editor can describe (without installing the app or reading the source) can scan it in one minute.
**Vietnamese mirror:** [`docs/i18n/vi/CONTENT-INVENTORY.md`](./i18n/vi/CONTENT-INVENTORY.md).
**Source of truth:**
- Video types: [`src/config/video-types.ts`](../src/config/video-types.ts)
- Game genres: [`src/config/genres.ts`](../src/config/genres.ts)
- Content warnings: [`src/config/content-warning-groups.ts`](../src/config/content-warning-groups.ts)
---
## 1. Video types (20)
Each video type drives a dedicated description template + title structure + tag bias. The "Extra fields" column lists fields the editor reveals when this type is selected.
| Icon | Type | Extra fields |
|---|---|---|
| 🎮 | Full Gameplay | — |
| 📂 | Gameplay Part | Part Number |
| 🎬 | Full Demo | — |
| 🎞 | Demo Part | Part Number |
| 👹 | Boss Fight | Boss Name |
| 💀 | Boss No Hit | Boss Name |
| 🏁 | Ending / All Endings | — |
| ⚡ | Speedrun | — |
| 💯 | 100% Completion | — |
| 📦 | DLC Content | DLC Name |
| 🔄 | New Game+ | — |
| 🏆 | Challenge Run | Challenge Name |
| 📌 | Side Quests | — |
| 🔍 | Secrets / Hidden | — |
| ⚖️ | Graphics Comparison | — |
| 📘 | Silent Guide | — |
| 🧩 | Modded Gameplay | Mod Name |
| ⭐ | All Collectibles | — |
| 🔴 | Livestream | Live URL, Scheduled Time |
| 🎴 | Gacha Quest | Quest Type, Chapter Name, Quest Name, Part Number |
---
## 2. Game genres (41)
Selected genres feed the title format, the tag pool, and (when configured in Settings → Genre Playlists) the pinned-comment recommendation.
Bulk-select groups available in the editor: **All RPGs** (rpg + jrpg + action_rpg + crpg), **All Shooters** (fps + arena_shooter + tactical_fps + boomer_shooter + extraction_shooter + shmup), **All Horror** (horror + survival_horror + psychological_horror).
| Icon | Genre |
|---|---|
| ⚔️ | Action / Adventure |
| 🗡 | Hack & Slash |
| 👊 | Beat 'em Up |
| 🦘 | Platformer |
| 👻 | Horror / Survival |
| 🧟 | Survival Horror |
| 🧠 | Psychological Horror |
| 🛡 | RPG |
| 🎎 | JRPG |
| 🏹 | Action RPG |
| 📜 | CRPG / Isometric |
| 🔫 | FPS / Shooter |
| 🎯 | Arena Shooter |
| 🎖 | Tactical FPS |
| 💥 | Boomer Shooter |
| 🎒 | Extraction Shooter |
| 🛸 | SHMUP / Bullet Hell |
| 🌍 | Open World / Sandbox |
| 🕹 | Indie |
| 💀 | Souls-like |
| 🏎 | Racing / Sports |
| 📖 | Story / Narrative |
| 🏗 | Simulation / Strategy |
| 🏙 | City Builder |
| 🥊 | Fighting |
| 🥷 | Stealth / Espionage |
| ⛏ | Survival / Crafting |
| 🎲 | Roguelike / Roguelite |
| 🗺 | Metroidvania |
| 🌐 | MMO / Online |
| 🎵 | Rhythm / Music |
| 🧩 | Puzzle |
| 🏰 | Tower Defense |
| 🃏 | Card Game |
| 🎴 | Deck Builder |
| 🤖 | Auto Battler |
| 🏆 | Battle Royale |
| ♟ | Tactical / Turn-based |
| 🚀 | Space / Sci-Fi |
| 🌾 | Farming / Life Sim |
| 🎬 | FMV / Interactive Movie |
| 💬 | Visual Novel |
---
## 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.
### Spoilers (6)
Story / ending spoilers · Ending spoilers · True-ending spoilers · Post-game / NG+ spoilers · Secret-ending spoilers · DLC story spoilers
### Photosensitive / Health (13)
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
### Audio / Sensory (13)
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 (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 · Body shaming / appearance mockery · Unrealistic beauty standards
### Internet / Digital life (18)
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)
Eyes / eyeball clusters · Body horror (flesh distortion) · Distorted / mutilated faces · Cosmic / eldritch horror · Extreme gore / dismemberment · Decay, rot, maggots · Mutilation / amputation · Liminal spaces · Analog horror / VHS · Unreality / distortion · Pursuit / chase · Entity / SCP horror
### Playstyle disclosures (10)
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 (5)
Mods used · Cheats / debug · Glitches used · Guide-assisted · Educational / PSA purpose
---
## 4. Maintenance
When adding a new item to any of the source files:
1. **Video types** → append to [`src/config/video-types.ts`](../src/config/video-types.ts) AND add a row in section 1 above.
2. **Genres** → append to [`src/config/genres.ts`](../src/config/genres.ts) AND add a row in section 2.
3. **Content warnings** → append to the relevant group in [`src/config/content-warning-groups.ts`](../src/config/content-warning-groups.ts) AND add the label to the right group in section 3 — keep the group count in the heading accurate.
4. Update the Vietnamese mirror at [`docs/i18n/vi/CONTENT-INVENTORY.md`](./i18n/vi/CONTENT-INVENTORY.md) in the same PR.
Mismatch between this file and the source files is treated as a documentation bug — open an issue or PR.
+147
View File
@@ -0,0 +1,147 @@
# Development Guide
This guide covers setting up YTDescGen for local development on Windows, macOS, or Linux. The application is a Vite/React web app with an optional Tauri desktop shell.
## Reference Workstation
The reference workstation used to develop and ship this project:
| Component | Spec |
| --- | --- |
| OS | Windows 11 Pro (24H2 or newer) |
| CPU | Modern x86-64 — 6+ cores with AVX2 (Intel 11th-gen / AMD Zen 3 or newer) |
| GPU | Discrete or integrated — Tauri's WebView2 backend runs fine on iGPU |
| RAM | 16 GB minimum, 32 GB recommended for parallel typecheck + dev server |
| Storage | 5 GB free for `node_modules` + Cargo `target/` after a full Tauri build |
| Display | 1920×1080 minimum; mobile-responsive layout tested down to 360×640 |
macOS and Linux work for development. Tauri release builds are cross-compiled or run on dedicated CI runners — see [PACKAGING.md](./PACKAGING.md).
## Toolchain
Install in this order:
| Tool | Version | Why |
| --- | --- | --- |
| **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. |
| **Tauri prerequisites** | per OS | See <https://v2.tauri.app/start/prerequisites/>. |
### Windows specifics
- Install **Visual Studio Build Tools 2022** with the "Desktop development with C++" workload (required by `tauri-build`).
- Install the **WebView2 Runtime** (usually pre-installed on Windows 11).
- Long path support: `git config --global core.longpaths true`.
### macOS specifics
- Install Xcode Command Line Tools: `xcode-select --install`.
### Linux specifics
- Install per-distro Tauri prerequisites — `libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, etc. See the Tauri docs linked above.
## IDE Setup
The reference workflow uses **JetBrains 2026.x** IDEs (WebStorm or RustRover) as primary, with **VS Code** for quick edits.
### JetBrains (WebStorm / RustRover / IntelliJ Ultimate)
- Enable the **Tailwind CSS** plugin.
- Enable the **i18next** plugin (or rely on `src/i18n/locales/_schema.json` for autocomplete).
- Settings → Languages → TypeScript → "Use TypeScript from `node_modules/typescript`".
- Settings → Code Style → Prettier → Run on save (`src/**/*.{ts,tsx,json,css}`).
### VS Code
Recommended extensions (no `.vscode/extensions.json` is committed — install manually):
- `dbaeumer.vscode-eslint`
- `esbenp.prettier-vscode`
- `bradlc.vscode-tailwindcss`
- `rust-lang.rust-analyzer` (if you touch `src-tauri/`)
- `tauri-apps.tauri-vscode`
## First Run
```bash
# 1. Clone
git clone https://github.com/poli0981/youtube-generator.git
cd youtube-generator
# 2. Install web dependencies
npm install
# 3. Start the web dev server
npm run dev
# → http://localhost:5173
```
## Common Commands
| Command | What it does |
| --- | --- |
| `npm run dev` | Vite dev server, hot reload, web only. |
| `npm run build` | Production web bundle into `dist/`. |
| `npm run preview` | Serve the production bundle for sanity-testing. |
| `npm run typecheck` | `tsc --noEmit`. Run before every PR. |
| `npm run lint` | ESLint. Use `npm run lint:fix` to autofix. |
| `npm run format` | Prettier write across `src/`. |
| `npm run test` | Vitest watch mode. |
| `npm run test:run` | Vitest single-run (for CI / pre-commit). |
| `npm run test:coverage` | Coverage report into `coverage/`. |
| `npm run validate:locales` | Enforces all 6 locales match `_schema.json` exactly. **Must pass before any locale-touching PR merges.** |
| `npm run generate:locale` | Scaffold an empty locale from `_schema.json` for a new language. |
| `npm run tauri:dev` | Tauri desktop in dev mode (auto-restarts on Rust or frontend changes). |
| `npm run tauri:build` | Tauri release binary for the current platform. |
## Tauri Desktop Build
See [PACKAGING.md](./PACKAGING.md) for the full release pipeline. Quick local build:
```bash
npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}
```
The first build takes ~5–10 minutes (cold Cargo cache). Subsequent builds are incremental.
## Troubleshooting
### `validate:locales` fails after adding a key
You forgot to update `src/i18n/locales/_schema.json`. The schema is the source of truth; locales must match it exactly.
### Tauri build fails with `link.exe not found` (Windows)
Install Visual Studio Build Tools 2022 + Desktop C++ workload, then restart your shell so the new PATH is picked up.
### Tauri build fails with `pkg-config not found` (Linux)
Install the per-distro Tauri prerequisites listed at <https://v2.tauri.app/start/prerequisites/>.
### `npm install` is slow or hangs
Disable corporate VPNs / proxies that block the npm registry. The lock file is committed; offline installs work after one successful online install.
### Hot reload not picking up locale edits
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.
## See Also
- [ARCHITECTURE.md](./ARCHITECTURE.md) — layer model, data flow, engine design.
- [I18N.md](./I18N.md) — adding new languages step-by-step.
- [PACKAGING.md](./PACKAGING.md) — Tauri release builds and signing.
- [Top-level CONTRIBUTING.md](../CONTRIBUTING.md) — PR process, commit conventions, auto-ignore rules.
- [Top-level SECURITY.md](../SECURITY.md) — reporting vulnerabilities.
+93 -74
View File
@@ -4,84 +4,40 @@
---
## 🎬 Video Types (14 types)
## 🎬 Video Types (20 types)
| ID | Label (EN) | Label (VI) | Label (JA) | Extra Fields |
|----|-----------|------------|------------|--------------|
| `full` | Full Gameplay | Full Gameplay | フルゲームプレイ | — |
| `part` | Gameplay Part | Gameplay Phần | ゲームプレイ パート | `partNumber` |
| `boss` | Boss Fight | Boss Fight | ボス戦 | `bossName` |
| `boss_nohit` | Boss No Hit | Boss No Hit | ボス ノーヒット | `bossName` |
| `ending` | Ending / All Endings | Kết thúc | エンディング | — |
| `speedrun` | Speedrun | Speedrun | スピードラン | — |
| `100percent` | 100% Completion | 100% Completion | 100%クリア | — |
| `dlc` | DLC Content | Nội dung DLC | DLCコンテンツ | `dlcName` |
| `newgame_plus` | New Game+ | New Game+ | 強くてニューゲーム | — |
| `challenge` | Challenge Run | Challenge Run | チャレンジラン | `challengeName` |
| `side_quest` | Side Quests | Nhiệm vụ phụ | サブクエスト | — |
| `secret` | Secrets / Hidden | Bí mật | 隠し要素 | — |
| `comparison` | Graphics Comparison | So sánh đồ họa | グラフィック比較 | — |
| `guide` | Silent Guide | Hướng dẫn | 攻略ガイド | — |
Twenty video types, each driving a dedicated description template, title
structure, and tag bias. The complete table — every type with its icon and
the extra fields the editor reveals — is in
[Content Inventory](./CONTENT-INVENTORY.md).
## 🌐 Languages (12 languages)
## 🌐 Languages (6 shipped)
All six locales ship today — UI strings and description templates fully
translated and parity-validated by `npm run validate:locales`.
### Launch (Phase 1)
| Code | Language | Native Name | Status |
|------|----------|-------------|--------|
| `en` | English | English | ✅ Ready |
| `vi` | Vietnamese | Tiếng Việt | ✅ Ready |
| `ja` | Japanese | 日本語 | ✅ Ready |
| `en` | English | English | ✅ Shipped |
| `vi` | Vietnamese | Tiếng Việt | ✅ Shipped |
| `ja` | Japanese | 日本語 | ✅ Shipped |
| `es` | Spanish | Español | ✅ Shipped |
| `ko` | Korean | 한국어 | ✅ Shipped |
| `zh` | Chinese (Simplified) | 简体中文 | ✅ Shipped |
### Phase 2
| Code | Language | Native Name |
|------|----------|-------------|
| `es` | Spanish | Español |
| `ko` | Korean | 한국어 |
| `zh` | Chinese (Simplified) | 简体中文 |
### Phase 3+
| Code | Language | Native Name |
|------|----------|-------------|
| `fr` | French | Français |
| `de` | German | Deutsch |
| `pt` | Portuguese | Português |
| `ru` | Russian | Русский |
| `th` | Thai | ภาษาไทย |
| `ar` | Arabic | العربية |
Further locales (French, German, Portuguese, Russian, Thai, Arabic) are
tracked in [Roadmap § 5.3](./ROADMAP.md).
Each language requires:
- `ui.json` — UI labels, buttons, placeholders, error messages
- `templates.json` — Title patterns, description sections, CTA text
## 🎮 Game Genres (25 genres)
## 🎮 Game Genres (41 genres)
| ID | Label | Icon | Tag Keywords (sample) |
|----|-------|------|-----------------------|
| `action` | Action / Adventure | ⚔️ | action game, hack and slash, action adventure |
| `horror` | Horror / Survival | 👻 | horror game, survival horror, scary game, psychological horror |
| `rpg` | RPG / JRPG | 🛡 | RPG, JRPG, action RPG, turn based RPG |
| `fps` | FPS / Shooter | 🔫 | FPS, shooter, tactical shooter, third person shooter |
| `openworld` | Open World / Sandbox | 🌍 | open world, sandbox, free roam, exploration |
| `indie` | Indie / Platformer | 🕹 | indie game, platformer, pixel art |
| `soulslike` | Souls-like | 💀 | souls like, soulsborne, boss fight, no death run |
| `racing` | Racing / Sports | 🏎 | racing game, driving sim, sports game |
| `story` | Story / Visual Novel | 📖 | story game, visual novel, narrative game, interactive drama |
| `simulation` | Simulation / Strategy | 🏗 | simulation, city builder, management, tycoon |
| `fighting` | Fighting | 🥊 | fighting game, combo, versus, arcade |
| `stealth` | Stealth / Espionage | 🥷 | stealth game, stealth gameplay, infiltration |
| `survival_craft` | Survival / Crafting | 🏕 | survival game, crafting, base building |
| `mmo` | MMO / Online | 🌐 | MMO, MMORPG, online game, multiplayer |
| `rhythm` | Rhythm / Music | 🎵 | rhythm game, music game, beat game |
| `puzzle` | Puzzle | 🧩 | puzzle game, brain teaser, logic game |
| `roguelike` | Roguelike / Roguelite | 🎲 | roguelike, roguelite, procedural, permadeath |
| `metroidvania` | Metroidvania | 🗺 | metroidvania, exploration, ability unlock |
| `tower_defense` | Tower Defense | 🏰 | tower defense, TD game, strategy |
| `card_game` | Card / Deck Builder | 🃏 | card game, deck builder, TCG |
| `battle_royale` | Battle Royale | 🏆 | battle royale, last man standing, BR |
| `crpg` | CRPG / Isometric | 📜 | CRPG, isometric RPG, classic RPG |
| `tactical` | Tactical / Turn-based | ♟ | tactical, turn based strategy, XCOM-like |
| `space` | Space / Sci-Fi | 🚀 | space game, sci-fi, space exploration |
| `farming` | Farming / Life Sim | 🌾 | farming sim, life sim, cozy game |
Forty-one genres feed the title format, the tag pool, and (when configured
in Settings → Genre Playlists) the pinned-comment playlist recommendation.
The complete list — with icons and bulk-select groups — is in
[Content Inventory](./CONTENT-INVENTORY.md).
## 🛒 Store Platforms (9 platforms)
@@ -143,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
@@ -266,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
+32 -40
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
@@ -239,48 +248,31 @@ Output locations:
### GitHub Actions Release
```yaml
# .github/workflows/release-desktop.yml
name: Release Desktop
The live workflow lives at [.github/workflows/release-desktop.yml](../.github/workflows/release-desktop.yml). Pushing a `v*` tag (e.g. `v0.10.0`) triggers a three-platform matrix build (Windows, macOS ARM, Linux) and uploads each installer to a single draft GitHub Release named `YTDescGen v__VERSION__`. Publish the draft manually after smoke-testing the binaries.
on:
push:
tags: ["v*"]
Matrix entries:
permissions:
contents: write
| Runner | Target | Output |
|---|---|---|
| `windows-latest` | `x86_64-pc-windows-msvc` | `.msi`, `.exe` (NSIS) |
| `macos-14` | `aarch64-apple-darwin` | `.app.tar.gz` |
| `ubuntu-latest` | `x86_64-unknown-linux-gnu` | `.AppImage`, `.deb` |
jobs:
build:
strategy:
matrix:
include:
- os: windows-latest
target: x86_64-pc-windows-msvc
- os: macos-latest
target: aarch64-apple-darwin
- os: macos-latest
target: x86_64-apple-darwin
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
cache: npm
- uses: dtolnay/rust-toolchain@stable
with:
targets: ${{ matrix.target }}
- run: npm ci
- uses: tauri-apps/tauri-action@v0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
tagName: v__VERSION__
releaseName: "YTDescGen v__VERSION__"
releaseBody: "See CHANGELOG.md for details."
releaseDraft: true
```
Linux runners install `libwebkit2gtk-4.1-dev`, `libgtk-3-dev`, `libayatana-appindicator3-dev`, `librsvg2-dev`, and `patchelf` before building — Tauri's webview + AppImage tooling needs these.
`fail-fast: false` keeps the other platforms going if one breaks. The `bundleArgs` matrix field is concatenated with `--target ${{ matrix.target }}` and passed through to `tauri build`.
**macOS notes (v0.9.1+):**
- **DMG bundling is skipped** (`--bundles app`). Tauri's DMG bundler runs an AppleScript that flakes intermittently on hosted macOS runners (the headless display can't load Finder fast enough for `osascript` to position icons), so we ship a `.app.tar.gz` instead. Users expand the archive and drag the `.app` into `/Applications`.
- **Intel macOS (`macos-13`) is NOT built.** GitHub started deprecating the `macos-13` free runner pool in 2025; jobs queue indefinitely. If Intel support becomes a priority, switch the macos-14 entry's target to `universal-apple-darwin` (Tauri builds both archs and lipos them into one universal binary) — the runner already has the toolchain capacity.
**Code signing is intentionally skipped** for both Windows and macOS — this is an open-source personal tool, and signing certificates carry recurring cost. End users will see the standard "unverified publisher" / "unidentified developer" prompts on first launch. Document the bypass steps in the release notes if needed.
**Auto-changelog** (`git-cliff`) is out of scope; release notes come from the tag's annotated message via the default `tauri-action` behaviour. CHANGELOG.md is hand-maintained.
**Manual re-run:** the workflow accepts `workflow_dispatch` with a `tag` input — `gh workflow run release-desktop.yml -f tag=v0.9.0` rebuilds an existing release without deleting + recreating the tag. Useful when a transient runner failure costs a single arch's binary.
**Backfill for pre-workflow tags:** `v0.8.0` and `v0.8.1` predate the multi-platform matrix and only have local Windows builds. To attach binaries retroactively, build manually then `gh release create v0.8.0 --notes-file CHANGELOG.md path/to/*.msi …`.
## Auto-Update Flow
-120
View File
@@ -1,120 +0,0 @@
# Product Requirements Document (PRD)
## YTDescGen — YouTube Gameplay Description Generator
**Version**: 1.0
**Author**: Kokone (skullmute)
**Last Updated**: 2026-04-07
---
## 1. Problem Statement
Kênh YouTube Gameplay No Commentary cần tạo title, description, và tags cho mỗi video upload. Quy trình hiện tại:
1. Mở file template → copy → paste vào YouTube Studio
2. Thay thế từng placeholder bằng thông tin game cụ thể
3. Tìm và thêm tags phù hợp thể loại
4. Lặp lại toàn bộ cho mỗi ngôn ngữ
5. Lặp lại toàn bộ cho mỗi video trong series
**Pain Points:**
- Lặp lại thao tác nhập Social/Rig/Channel info mỗi lần
- Dễ quên/sai khi thay placeholder
- Tags phải nhớ hoặc tra cứu từ file Excel
- Không có cách kiểm tra character limit trước khi paste
- Multi-language phải làm riêng từng bản
- Không tái sử dụng được game info cho multi-part series
## 2. Solution
Ứng dụng web (+ desktop) với form-based UI:
- Chọn video type, ngôn ngữ, thể loại game
- Nhập thông tin một lần → lưu Profile
- Nhập game info một lần → lưu Preset cho cả series
- Tự động generate title + description + tags
- Copy trực tiếp vào clipboard, paste vào YouTube Studio
- Hỗ trợ batch mode cho nhiều video cùng game
## 3. Target Users
- **Primary**: Bản thân Kokone — kênh Gameplay No Commentary
- **Secondary**: Các YouTuber gameplay nhỏ lẻ cùng niche
- **Future**: Mở rộng cho community qua GitHub release
## 4. Core User Stories
### Must Have (P0)
| ID | Story | Acceptance Criteria |
|----|-------|-------------------|
| US-01 | Chọn loại video (Full, Part, Boss, etc.) | UI hiển thị đúng form fields theo loại video đã chọn |
| US-02 | Chọn ngôn ngữ output (EN/VI/JA) | Toàn bộ generated output chuyển sang ngôn ngữ đã chọn |
| US-03 | Chọn thể loại game | Tags được generate phù hợp thể loại |
| US-04 | Nhập game info (tên, platform, store links) | Thông tin được đưa vào title + description đúng vị trí |
| US-05 | Nhập timestamps | Timestamps xuất hiện trong description với format YouTube chapters |
| US-06 | Nhập Social/Donate links | Links xuất hiện trong description section phù hợp |
| US-07 | Nhập Rig info | Rig xuất hiện dưới dạng compact format trong description |
| US-08 | Xem preview title + description + tags | Preview cập nhật real-time khi thay đổi input |
| US-09 | Copy từng phần (title / desc / tags) | Clipboard chứa đúng nội dung, toast confirm |
| US-10 | Copy tất cả | Clipboard chứa title + desc, tags riêng |
| US-11 | Hiển thị character count | Description ≤ 5000, Tags ≤ 500, warning khi gần/vượt limit |
| US-12 | Toggle Spoiler/18+ warning | Dòng warning xuất hiện/ẩn trong description |
### Should Have (P1)
| ID | Story | Acceptance Criteria |
|----|-------|-------------------|
| US-13 | Lưu Profile (social, rig, channel) | Profile persist qua sessions, load vào form |
| US-14 | Lưu Game Preset (tên + store links) | Preset persist, selectable khi tạo video mới |
| US-15 | Xem lịch sử generated outputs | Danh sách outputs đã tạo, có thể copy lại |
| US-16 | Thêm ngôn ngữ mới dễ dàng | Chỉ cần thêm locale JSON files + register |
| US-17 | Thêm thể loại game mới | Chỉ cần thêm entry trong config + tag pool |
| US-18 | Import/Export settings | JSON export/import cho profiles + presets |
| US-19 | Multi-language output đồng thời | Generate cả 3 ngôn ngữ cùng lúc, mỗi ngôn ngữ 1 tab |
### Nice to Have (P2)
| ID | Story | Acceptance Criteria |
|----|-------|-------------------|
| US-20 | Batch mode cho multi-part series | Nhập game info 1 lần, tạo N videos khác part/timestamps |
| US-21 | Desktop app (Windows/macOS) | Tauri binary, hoạt động offline |
| US-22 | Custom template editor | Người dùng tự sửa template structure |
| US-23 | Keyboard shortcuts | Ctrl+Enter = generate, Ctrl+Shift+C = copy all |
| US-24 | Dark/Light theme toggle | Theme persist qua sessions |
| US-25 | Auto-save draft | Form state tự lưu, recover khi reload |
| US-26 | Tag suggestions từ game name | Gợi ý tag dựa trên tên game + trending |
| US-27 | YouTube API integration | Auto-fill qua YouTube Data API (future) |
| US-28 | VS Code / IDE extension | Command palette → generate description |
## 5. Non-Functional Requirements
| Requirement | Target |
|------------|--------|
| First Contentful Paint | < 1.5s |
| Bundle size (web) | < 500KB gzipped |
| Desktop binary size | < 15MB (Tauri) |
| Offline support | Full functionality without internet |
| Browser support | Chrome 90+, Firefox 90+, Edge 90+ |
| Accessibility | WCAG 2.1 Level AA |
| Persistence | localStorage (web), file system (desktop) |
## 6. Out of Scope (v1)
- YouTube API auto-upload
- Thumbnail generation
- Video editing integration
- Multi-user / team features
- Cloud sync between devices
- Analytics / tracking
- Monetization
## 7. Success Metrics
| Metric | Target |
|--------|--------|
| Time to generate 1 video description | < 2 minutes (vs ~10 minutes manual) |
| Error rate (missing fields, wrong format) | 0% — form validates before generate |
| Languages supported at launch | 3 (EN, VI, JA) |
| Genres supported at launch | 10+ |
| Video types supported | 7+ |
+1 -1
View File
@@ -51,7 +51,7 @@
- [x] editor/ components: StoreLinkEditor, RigEditor, SocialEditor, WarningToggles
- [x] editor/ components: QuickPreview
- [x] output/ components: OutputPreview, CopyButton, CharCounter, CopyAllBar
- [x] layout/ components: AppShell, Header, TabBar
- [x] layout/ components: AppShell, Header, Sidebar
1.7 Pages
- [x] EditorPage (form + quick preview)
+10 -10
View File
@@ -11,7 +11,7 @@
```jsonc
{
"name": "yt-desc-gen",
"version": "0.1.0",
"version": "0.20.0",
"private": true,
"type": "module",
"scripts": {
@@ -317,10 +317,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
@@ -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: 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
```
## 5. Testing Strategy
+161
View File
@@ -0,0 +1,161 @@
# Danh mục Nội dung
Bản kê khai tĩnh cho mọi loại video, thể loại game, và cảnh báo nội dung trong editor của YTDescGen. Cập nhật thủ công — khi thêm mục mới vào một trong các file nguồn dưới đây, **thêm dòng tương ứng vào đây** trong cùng PR.
File này tồn tại để **minh bạch** — bất kỳ ai tò mò về việc editor có thể mô tả được gì (mà không cần cài app hay đọc source) đều có thể quét trong một phút.
**Bản gốc tiếng Anh:** [`docs/CONTENT-INVENTORY.md`](../../CONTENT-INVENTORY.md).
**Nguồn tham chiếu (source of truth):**
- Loại video: [`src/config/video-types.ts`](../../../src/config/video-types.ts)
- Thể loại game: [`src/config/genres.ts`](../../../src/config/genres.ts)
- Cảnh báo nội dung: [`src/config/content-warning-groups.ts`](../../../src/config/content-warning-groups.ts)
---
## 1. Loại video (20)
Mỗi loại video kéo theo một template description, cấu trúc title, và tag bias riêng. Cột "Trường bổ sung" liệt kê các trường editor sẽ hiển thị khi chọn loại video tương ứng.
| Icon | Loại | Trường bổ sung |
|---|---|---|
| 🎮 | Gameplay đầy đủ | — |
| 📂 | Gameplay theo phần | Số phần |
| 🎬 | Demo đầy đủ | — |
| 🎞 | Demo theo phần | Số phần |
| 👹 | Đấu trùm | Tên trùm |
| 💀 | Đấu trùm không trúng đòn | Tên trùm |
| 🏁 | Kết thúc / Toàn bộ Ending | — |
| ⚡ | Speedrun | — |
| 💯 | Hoàn thành 100% | — |
| 📦 | Nội dung DLC | Tên DLC |
| 🔄 | New Game+ | — |
| 🏆 | Thử thách | Tên thử thách |
| 📌 | Nhiệm vụ phụ | — |
| 🔍 | Bí mật / Ẩn | — |
| ⚖️ | So sánh đồ họa | — |
| 📘 | Hướng dẫn không lời | — |
| 🧩 | Chơi với Mod | Tên Mod |
| ⭐ | Toàn bộ vật phẩm sưu tầm | — |
| 🔴 | Livestream | URL Live, Thời gian dự kiến |
| 🎴 | Nhiệm vụ Gacha | Loại nhiệm vụ, Tên chapter, Tên quest, Số phần |
---
## 2. Thể loại game (41)
Thể loại được chọn ảnh hưởng đến định dạng title, tag pool, và (khi cấu hình ở Settings → Genre Playlists) gợi ý playlist trong pinned comment.
Các nhóm bulk-select trong editor: **All RPGs** (rpg + jrpg + action_rpg + crpg), **All Shooters** (fps + arena_shooter + tactical_fps + boomer_shooter + extraction_shooter + shmup), **All Horror** (horror + survival_horror + psychological_horror).
| Icon | Thể loại |
|---|---|
| ⚔️ | Hành động / Phiêu lưu |
| 🗡 | Hack & Slash |
| 👊 | Beat 'em Up |
| 🦘 | Platformer |
| 👻 | Kinh dị / Sinh tồn |
| 🧟 | Kinh dị Sinh tồn |
| 🧠 | Kinh dị Tâm lý |
| 🛡 | RPG |
| 🎎 | JRPG |
| 🏹 | Action RPG |
| 📜 | CRPG / Góc nhìn từ trên |
| 🔫 | FPS / Bắn súng |
| 🎯 | Bắn súng Arena |
| 🎖 | Bắn súng Chiến thuật |
| 💥 | Boomer Shooter |
| 🎒 | Extraction Shooter |
| 🛸 | SHMUP / Bullet Hell |
| 🌍 | Thế giới mở / Sandbox |
| 🕹 | Indie |
| 💀 | Souls-like |
| 🏎 | Đua xe / Thể thao |
| 📖 | Cốt truyện |
| 🏗 | Mô phỏng / Chiến thuật |
| 🏙 | Xây thành |
| 🥊 | Đối kháng |
| 🥷 | Lén lút / Gián điệp |
| ⛏ | Sinh tồn / Chế tạo |
| 🎲 | Roguelike / Roguelite |
| 🗺 | Metroidvania |
| 🌐 | MMO / Trực tuyến |
| 🎵 | Âm nhạc / Nhịp điệu |
| 🧩 | Giải đố |
| 🏰 | Tower Defense |
| 🃏 | Bài / Card |
| 🎴 | Deck Builder |
| 🤖 | Auto Battler |
| 🏆 | Battle Royale |
| ♟ | Chiến thuật theo lượt |
| 🚀 | Không gian / Sci-Fi |
| 🌾 | Nông trại / Life Sim |
| 🎬 | FMV / Phim tương tác |
| 💬 | Visual Novel |
---
## 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.
### Spoiler (6)
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 (13)
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 thanh / Cảm âm (13)
Â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 (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 · Miệt thị ngoại hình (body shaming) · Chuẩn mực ngoại hình phi thực tế
### Internet / Đời sống số (18)
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)
Mắt / cụm mắt · Body horror (biến dạng cơ thể) · Mặt biến dạng / cắt xén · Kinh dị vũ trụ · Máu me / phân thây cực độ · Phân hủy, thối rữa, dòi bọ · Cắt xẻo / cụt chi · Liminal space · Analog horror / VHS · Phi thực tế / méo mó · Truy đuổi · Thực thể / SCP
### Thông tin về playstyle (10)
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 (5)
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
---
## 4. Bảo trì
Khi thêm mục mới vào bất kỳ file nguồn nào:
1. **Loại video** → thêm vào [`src/config/video-types.ts`](../../../src/config/video-types.ts) VÀ thêm dòng vào mục 1 ở trên.
2. **Thể loại** → thêm vào [`src/config/genres.ts`](../../../src/config/genres.ts) VÀ thêm dòng vào mục 2.
3. **Cảnh báo nội dung** → thêm vào nhóm phù hợp ở [`src/config/content-warning-groups.ts`](../../../src/config/content-warning-groups.ts) VÀ thêm label vào đúng nhóm ở mục 3 — giữ số đếm trong tiêu đề chính xác.
4. Cập nhật cả bản gốc EN tại [`docs/CONTENT-INVENTORY.md`](../../CONTENT-INVENTORY.md) trong cùng PR.
Sai lệch giữa file này và file nguồn được xem là lỗi tài liệu — mở issue hoặc PR.
+149
View File
@@ -0,0 +1,149 @@
# Hướng dẫn phát triển
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`docs/DEVELOPMENT.md`](../../DEVELOPMENT.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
Hướng dẫn này bao gồm cách cài đặt YTDescGen để phát triển cục bộ trên Windows, macOS hoặc Linux. Ứng dụng là một web app Vite/React với tùy chọn vỏ desktop Tauri.
## Cấu hình máy tham chiếu
Cấu hình máy đã dùng để phát triển và phát hành dự án:
| Thành phần | Thông số |
| --- | --- |
| OS | Windows 11 Pro (24H2 trở lên) |
| CPU | x86-64 hiện đại — 6 nhân trở lên có AVX2 (Intel gen 11 / AMD Zen 3 hoặc mới hơn) |
| GPU | Rời hoặc tích hợp — backend WebView2 của Tauri chạy thoải mái trên iGPU |
| RAM | Tối thiểu 16 GB, khuyến nghị 32 GB để chạy song song typecheck + dev server |
| Lưu trữ | 5 GB trống cho `node_modules` + `target/` Cargo sau khi build Tauri đầy đủ |
| Màn hình | Tối thiểu 1920×1080; layout mobile đã test đến 360×640 |
macOS và Linux đều dùng được để phát triển. Build release Tauri được cross-compile hoặc chạy trên CI riêng — xem [PACKAGING.md](../../PACKAGING.md).
## Toolchain
Cài theo thứ tự:
| Công cụ | Phiên bản | Lý do |
| --- | --- | --- |
| **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. |
| **Tauri prerequisites** | theo OS | Xem <https://v2.tauri.app/start/prerequisites/>. |
### Windows
- Cài **Visual Studio Build Tools 2022** với workload "Desktop development with C++" (bắt buộc cho `tauri-build`).
- Cài **WebView2 Runtime** (Windows 11 thường đã có sẵn).
- Bật long path: `git config --global core.longpaths true`.
### macOS
- Cài Xcode Command Line Tools: `xcode-select --install`.
### Linux
- Cài Tauri prerequisites theo từng distro — `libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, v.v. Xem docs Tauri ở link trên.
## Cấu hình IDE
Quy trình tham chiếu dùng **JetBrains 2026.x** (WebStorm hoặc RustRover) làm IDE chính, **VS Code** cho chỉnh sửa nhanh.
### JetBrains (WebStorm / RustRover / IntelliJ Ultimate)
- Bật plugin **Tailwind CSS**.
- Bật plugin **i18next** (hoặc dùng `src/i18n/locales/_schema.json` để autocomplete).
- Settings → Languages → TypeScript → "Use TypeScript from `node_modules/typescript`".
- Settings → Code Style → Prettier → Run on save (`src/**/*.{ts,tsx,json,css}`).
### VS Code
Extension đề xuất (không có `.vscode/extensions.json` được commit — cài thủ công):
- `dbaeumer.vscode-eslint`
- `esbenp.prettier-vscode`
- `bradlc.vscode-tailwindcss`
- `rust-lang.rust-analyzer` (nếu động vào `src-tauri/`)
- `tauri-apps.tauri-vscode`
## Chạy lần đầu
```bash
# 1. Clone
git clone https://github.com/poli0981/youtube-generator.git
cd youtube-generator
# 2. Cài web dependencies
npm install
# 3. Chạy web dev server
npm run dev
# → http://localhost:5173
```
## Lệnh thường dùng
| Lệnh | Tác dụng |
| --- | --- |
| `npm run dev` | Vite dev server, hot reload, chỉ web. |
| `npm run build` | Bundle web production vào `dist/`. |
| `npm run preview` | Phục vụ bundle production để kiểm tra. |
| `npm run typecheck` | `tsc --noEmit`. Chạy trước mỗi PR. |
| `npm run lint` | ESLint. Dùng `npm run lint:fix` để autofix. |
| `npm run format` | Chạy Prettier trên `src/`. |
| `npm run test` | Vitest chế độ watch. |
| `npm run test:run` | Vitest chạy một lần (cho CI / pre-commit). |
| `npm run test:coverage` | Báo cáo coverage vào `coverage/`. |
| `npm run validate:locales` | Bắt buộc cả 6 locale có cùng key với `_schema.json`. **Phải pass trước khi merge PR động đến locale.** |
| `npm run generate:locale` | Scaffold locale rỗng từ `_schema.json` cho ngôn ngữ mới. |
| `npm run tauri:dev` | Tauri desktop chế độ dev (tự restart khi đổi Rust hoặc frontend). |
| `npm run tauri:build` | Build binary Tauri release cho platform hiện tại. |
## Build Tauri desktop
Xem [PACKAGING.md](../../PACKAGING.md) cho pipeline release đầy đủ. Build cục bộ nhanh:
```bash
npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}
```
Build đầu tiên mất khoảng 5–10 phút (Cargo cache rỗng). Build sau đó là incremental.
## Khắc phục sự cố
### `validate:locales` fail sau khi thêm key
Bạn quên cập nhật `src/i18n/locales/_schema.json`. Schema là source of truth; locale phải khớp 100%.
### Build Tauri báo `link.exe not found` (Windows)
Cài Visual Studio Build Tools 2022 + workload Desktop C++, sau đó khởi động lại shell để PATH được cập nhật.
### Build Tauri báo `pkg-config not found` (Linux)
Cài Tauri prerequisites theo distro tại <https://v2.tauri.app/start/prerequisites/>.
### `npm install` chậm / treo
Tắt VPN/proxy doanh nghiệp chặn npm registry. Lock file đã commit; install offline chạy được sau lần install thành công đầu tiên.
### Hot reload không bắt được sửa đổi locale
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.
## Xem thêm
- [ARCHITECTURE.md](../../ARCHITECTURE.md) — mô hình layer, data flow, thiết kế engine.
- [I18N.md](../../I18N.md) — thêm ngôn ngữ mới từng bước.
- [PACKAGING.md](../../PACKAGING.md) — Tauri release build và signing.
- [CONTRIBUTING.md ở root](../../../CONTRIBUTING.md) — quy trình PR, quy ước commit, auto-ignore rules.
- [SECURITY.md ở root](../../../SECURITY.md) — báo cáo lỗ hổng bảo mật.
+55
View File
@@ -0,0 +1,55 @@
# Tuyên bố miễn trừ
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`DISCLAIMER.md` ở root](../../../DISCLAIMER.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
## Dự án cá nhân, có sự hỗ trợ của AI
YTDescGen là dự án cá nhân do một người duy trì (`@poli0981`) để dùng cho kênh YouTube [`@SkullMute`](https://www.youtube.com/@SkullMute), và chia sẻ công khai dưới dạng mã nguồn mở. Đây **không phải sản phẩm thương mại** và không có nghĩa vụ hỗ trợ.
Mã nguồn, tài liệu, bản dịch locale, và các quyết định thiết kế trong repo này được **đồng tác giả với sự hỗ trợ của Anthropic's Claude Code (model 4.7 Opus, cửa sổ context 1M)**. Tất cả commit, release, và quyết định kiến trúc được người duy trì xem xét và phê duyệt trước khi merge.
Tuyên bố này áp dụng cho:
- Mã nguồn trong `src/` và `src-tauri/`.
- Tài liệu trong `docs/` và các file markdown ở root.
- File locale trong `src/i18n/locales/`.
- Workflow CI/CD trong `.github/workflows/`.
Xem thêm: [`THIRD_PARTY_NOTICES.md`](../../../THIRD_PARTY_NOTICES.md) § "AI-Assisted Development Disclosure".
## Chất lượng bản dịch
UI ứng dụng hỗ trợ sáu ngôn ngữ. Chất lượng tác giả khác nhau:
| Locale | Tác giả | Ghi chú |
| --- | --- | --- |
| Tiếng Anh (`en`) | Người duy trì + AI | Locale làm việc chính. Chuỗi được review trước khi commit. |
| Tiếng Việt (`vi`) | Người duy trì (bản ngữ) + AI | Review bởi người duy trì là người bản ngữ tiếng Việt. |
| Tiếng Nhật (`ja`) | AI dịch | Không có review bản ngữ. Ngữ pháp và văn phong có thể chưa chuẩn. |
| Tiếng Tây Ban Nha (`es`) | AI dịch | Không có review bản ngữ. Không nhắm cụ thể vào giọng vùng miền (LatAm vs. Castilian). |
| Tiếng Hàn (`ko`) | AI dịch | Không có review bản ngữ. Honorific register chọn ở mức trung tính. |
| Tiếng Trung (`zh`) | AI dịch | Giản thể. Không có review bản ngữ. |
Nếu bạn là người bản ngữ và phát hiện dịch sai, vui lòng mở issue hoặc PR — xem [CONTRIBUTING.md](../../../CONTRIBUTING.md) § "i18n Contributions".
## Giọng văn và phong cách
Template description sinh ra dùng giọng văn được điều chỉnh cho ngách **gameplay no-commentary** trên YouTube, đặc biệt nhấn mạnh game horror / kinh dị (vì đó là nội dung kênh của người duy trì). Output có thể không hợp với mọi kênh hay mọi văn hoá đọc. Ứng dụng dùng template — bạn có thể sửa bất kỳ text sinh ra nào trước khi đăng.
Một số cụm tiếng Việt cố tình giữ từ vay mượn và giọng casual phản ánh cách các creator gameplay Việt thường viết description. Đây không phải "dịch sai" mà là lựa chọn phong cách cho đối tượng đọc.
## Không bảo hành
Phần mềm cung cấp **nguyên trạng, không có bất kỳ bảo hành nào**. Xem [`LICENSE`](../../../LICENSE) (Apache 2.0) §§ 7 và 8 cho đầy đủ điều khoản miễn trừ bảo hành và giới hạn trách nhiệm.
Nói ngắn gọn: nếu ứng dụng crash, làm hỏng draft, sinh ra description khiến video bị YouTube flag, hoặc gây bất kỳ thiệt hại nào — người duy trì không chịu trách nhiệm. Dùng tự chịu rủi ro; back up draft của bạn.
## Không liên kết với YouTube / Anthropic
YTDescGen **không** liên kết, được tài trợ, hay được YouTube, Google LLC, hay Alphabet Inc. xác nhận. Output sinh ra dành để paste vào YouTube Studio editor; ứng dụng này không tương tác với YouTube API.
Việc dùng Claude Code trong quá trình phát triển **không** biến đây thành sản phẩm của Anthropic. Anthropic, Claude, và Claude Code là nhãn hiệu của Anthropic, PBC. Dự án này độc lập.
## Không phải tư vấn pháp lý hay tài chính
Bất kỳ đề cập nào đến GDPR, CCPA, luật bản quyền, chính sách monetization của YouTube, hay các chủ đề tương tự trong tài liệu repo này chỉ để định hướng — **không phải tư vấn pháp lý**. Tham vấn luật sư có chuyên môn ở khu vực của bạn nếu cần câu trả lời chính thống.
+64 -1
View File
@@ -3,7 +3,70 @@
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>YTDescGen</title>
<meta name="color-scheme" content="dark light" />
<meta name="theme-color" content="#0a0a0a" />
<title>YTDescGen — YouTube Title, Description & Tag Generator for Gameplay Channels</title>
<meta name="description" content="Generate YouTube titles, descriptions, and tags for Gameplay No Commentary channels — multilingual templates, profile presets, and a Tauri-based desktop build." />
<meta name="keywords" content="youtube, gameplay, no commentary, description generator, tags generator, video title, vietnamese, japanese, korean, spanish, chinese, multilingual, tauri, desktop" />
<meta name="author" content="SkullMute (poli0981)" />
<meta name="robots" content="index, follow" />
<meta name="generator" content="Vite + React" />
<link rel="canonical" href="https://poli0981.github.io/youtube-generator/" />
<link rel="icon" type="image/svg+xml" href="/youtube-generator/favicon.svg" />
<link rel="apple-touch-icon" href="/youtube-generator/apple-touch-icon.png" />
<link rel="manifest" href="/youtube-generator/manifest.webmanifest" />
<!-- OpenGraph -->
<meta property="og:type" content="website" />
<meta property="og:site_name" content="YTDescGen" />
<meta property="og:title" content="YTDescGen — YouTube Title, Description & Tag Generator" />
<meta property="og:description" content="Multilingual title, description, and tag generator for Gameplay No Commentary channels." />
<meta property="og:url" content="https://poli0981.github.io/youtube-generator/" />
<meta property="og:image" content="https://poli0981.github.io/youtube-generator/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:locale" content="en_US" />
<meta property="og:locale:alternate" content="vi_VN" />
<meta property="og:locale:alternate" content="ja_JP" />
<meta property="og:locale:alternate" content="es_ES" />
<meta property="og:locale:alternate" content="ko_KR" />
<meta property="og:locale:alternate" content="zh_CN" />
<!-- Twitter / X card -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@SkullMute0011" />
<meta name="twitter:creator" content="@SkullMute0011" />
<meta name="twitter:title" content="YTDescGen — YouTube Title, Description & Tag Generator" />
<meta name="twitter:description" content="Multilingual title, description, and tag generator for Gameplay No Commentary channels." />
<meta name="twitter:image" content="https://poli0981.github.io/youtube-generator/og-image.png" />
<!-- Structured data -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebApplication",
"name": "YTDescGen",
"alternateName": "YouTube Description Generator",
"url": "https://poli0981.github.io/youtube-generator/",
"applicationCategory": "MultimediaApplication",
"operatingSystem": "Web, Windows, macOS, Linux",
"description": "Generate YouTube titles, descriptions, and tags for Gameplay No Commentary channels — multilingual templates, profile presets, and a Tauri-based desktop build.",
"inLanguage": ["en", "vi", "ja", "es", "ko", "zh"],
"offers": {
"@type": "Offer",
"price": "0",
"priceCurrency": "USD"
},
"author": {
"@type": "Person",
"name": "SkullMute",
"url": "https://github.com/poli0981"
},
"license": "https://github.com/poli0981/youtube-generator/blob/main/LICENSE"
}
</script>
</head>
<body>
<div id="root"></div>
+14
View File
@@ -0,0 +1,14 @@
{
"$schema": "https://unpkg.com/knip@6/schema.json",
"entry": ["scripts/*.ts", "tests/**/*.test.ts"],
"project": ["src/**/*.{ts,tsx}", "scripts/**/*.ts", "tests/**/*.ts"],
"ignoreExportsUsedInFile": true,
"ignoreDependencies": [
"@tauri-apps/plugin-fs",
"@tauri-apps/plugin-opener",
"@tauri-apps/plugin-shell",
"@testing-library/jest-dom",
"@testing-library/react"
],
"ignoreBinaries": ["tauri"]
}
+1776 -993
View File
File diff suppressed because it is too large. Load diff
+27 -23
View File
@@ -1,7 +1,8 @@
{
"name": "yt-desc-gen",
"version": "0.8.0",
"version": "0.28.0",
"private": true,
"license": "Apache-2.0",
"type": "module",
"scripts": {
"dev": "vite",
@@ -12,6 +13,7 @@
"test:coverage": "vitest run --coverage",
"lint": "eslint src/",
"lint:fix": "eslint src/ --fix",
"knip": "knip",
"typecheck": "tsc --noEmit",
"format": "prettier --write \"src/**/*.{ts,tsx,json,css}\"",
"validate:locales": "tsx scripts/validate-locales.ts",
@@ -21,39 +23,41 @@
"tauri:build": "tauri build"
},
"dependencies": {
"react": "^18.3.0",
"react-dom": "^18.3.0",
"react-router-dom": "^6.26.0",
"zustand": "^4.5.0",
"i18next": "^23.15.0",
"react-i18next": "^15.0.0",
"react-hot-toast": "^2.4.0",
"lucide-react": "^0.400.0",
"clsx": "^2.1.0",
"@tauri-apps/api": "^2.0.0",
"@tauri-apps/api": "^2.11.0",
"@tauri-apps/plugin-dialog": "^2.0.0",
"@tauri-apps/plugin-fs": "^2.0.0",
"@tauri-apps/plugin-opener": "^2.0.0",
"@tauri-apps/plugin-shell": "^2.0.0"
"@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",
"react-hot-toast": "^2.4.0",
"react-i18next": "^15.0.0",
"react-router-dom": "^6.26.0",
"zustand": "^4.5.0"
},
"devDependencies": {
"@eslint/js": "^9.0.0",
"@testing-library/jest-dom": "^6.4.0",
"@testing-library/react": "^16.0.0",
"@types/react": "^18.3.0",
"@types/react-dom": "^18.3.0",
"@vitejs/plugin-react": "^4.3.0",
"typescript": "^5.5.0",
"vite": "^5.4.0",
"vitest": "^2.0.0",
"@testing-library/react": "^16.0.0",
"@testing-library/jest-dom": "^6.4.0",
"tailwindcss": "^3.4.0",
"postcss": "^8.4.0",
"@vitejs/plugin-react": "^5.2.0",
"autoprefixer": "^10.4.0",
"eslint": "^9.0.0",
"@eslint/js": "^9.0.0",
"typescript-eslint": "^8.0.0",
"eslint-plugin-react-hooks": "^5.0.0",
"knip": "^6.14.1",
"postcss": "^8.5.14",
"prettier": "^3.3.0",
"prettier-plugin-tailwindcss": "^0.6.0",
"tsx": "^4.16.0"
"tailwindcss": "^3.4.0",
"tsx": "^4.22.4",
"typescript": "^5.5.0",
"typescript-eslint": "^8.0.0",
"vite": "^8.0.16",
"vitest": "^4.1.8"
}
}
View File
Whitespace-only changes.
+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
<rect width="64" height="64" rx="12" fill="#0a0a0a"/>
<rect x="14" y="14" width="36" height="36" rx="6" fill="none" stroke="#ec4899" stroke-width="3"/>
<path d="M22 22h20M22 30h20M22 38h12" stroke="#ec4899" stroke-width="3" stroke-linecap="round"/>
</svg>

After

Width:  |  Height:  |  Size: 335 B

+32
View File
@@ -0,0 +1,32 @@
{
"name": "YTDescGen",
"short_name": "YTDescGen",
"description": "YouTube title, description, and tag generator for Gameplay No Commentary channels.",
"start_url": "/youtube-generator/",
"scope": "/youtube-generator/",
"display": "standalone",
"background_color": "#0a0a0a",
"theme_color": "#0a0a0a",
"lang": "en",
"categories": ["productivity", "utilities", "multimedia"],
"icons": [
{
"src": "favicon.svg",
"sizes": "any",
"type": "image/svg+xml",
"purpose": "any"
},
{
"src": "icon-192.png",
"sizes": "192x192",
"type": "image/png",
"purpose": "any maskable"
},
{
"src": "icon-512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "any maskable"
}
]
}
+3
View File
@@ -0,0 +1,3 @@
User-agent: *
Allow: /
Sitemap: https://poli0981.github.io/youtube-generator/sitemap.xml
+8
View File
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://poli0981.github.io/youtube-generator/</loc>
<changefreq>weekly</changefreq>
<priority>1.0</priority>
</url>
</urlset>
+186 -63
View File
@@ -616,14 +616,20 @@ dependencies = [
[[package]]
name = "ctor"
version = "0.2.9"
version = "0.8.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "32a2785755761f3ddc1492979ce1e48d2c00d09311c39e4466429188f3dd6501"
checksum = "352d39c2f7bef1d6ad73db6f5160efcaed66d94ef8c6c573a8410c00bf909a98"
dependencies = [
"quote",
"syn 2.0.117",
"ctor-proc-macro",
"dtor",
]
[[package]]
name = "ctor-proc-macro"
version = "0.0.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "52560adf09603e58c9a7ee1fe1dcb95a16927b17c127f0ac02d6e768a0e25bc1"
[[package]]
name = "darling"
version = "0.23.0"
@@ -658,6 +664,17 @@ dependencies = [
"syn 2.0.117",
]
[[package]]
name = "dbus"
version = "0.9.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b942602992bb7acfd1f51c49811c58a610ef9181b6e66f3e519d79b540a3bf73"
dependencies = [
"libc",
"libdbus-sys",
"windows-sys 0.61.2",
]
[[package]]
name = "deranged"
version = "0.5.8"
@@ -818,6 +835,21 @@ dependencies = [
"dtoa",
]
[[package]]
name = "dtor"
version = "0.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f1057d6c64987086ff8ed0fd3fbf377a6b7d205cc7715868cd401705f715cbe4"
dependencies = [
"dtor-proc-macro",
]
[[package]]
name = "dtor-proc-macro"
version = "0.0.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f678cf4a922c215c63e0de95eb1ff08a958a81d47e485cf9da1e27bf6305cfa5"
[[package]]
name = "dunce"
version = "1.0.5"
@@ -1616,7 +1648,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3e795dff5605e0f04bff85ca41b51a96b83e80b281e96231bcaaf1ac35103371"
dependencies = [
"byteorder",
"png",
"png 0.17.16",
]
[[package]]
@@ -1967,6 +1999,15 @@ version = "0.2.184"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "48f5d2a454e16a5ea0f4ced81bd44e4cfc7bd3a507b61887c99fd3538b28e4af"
[[package]]
name = "libdbus-sys"
version = "0.2.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "328c4789d42200f1eeec05bd86c9c13c7f091d2ba9a6ea35acdf51f31bc0f043"
dependencies = [
"pkg-config",
]
[[package]]
name = "libloading"
version = "0.7.4"
@@ -2105,9 +2146,9 @@ dependencies = [
[[package]]
name = "muda"
version = "0.17.2"
version = "0.19.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7c9fec5a4e89860383d778d10563a605838f8f0b2f9303868937e5ff32e86177"
checksum = "0ae8844f63b5b118e334e205585b8c5c17b984121dbdb179d44aeb087ffad3cb"
dependencies = [
"crossbeam-channel",
"dpi",
@@ -2118,10 +2159,10 @@ dependencies = [
"objc2-core-foundation",
"objc2-foundation",
"once_cell",
"png",
"png 0.18.1",
"serde",
"thiserror 2.0.18",
"windows-sys 0.60.2",
"windows-sys 0.61.2",
]
[[package]]
@@ -2139,12 +2180,6 @@ dependencies = [
"thiserror 1.0.69",
]
[[package]]
name = "ndk-context"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "27b02d87554356db9e9a873add8782d4ea6e3e58ea071a9adb9a2e8ddb884a8b"
[[package]]
name = "ndk-sys"
version = "0.6.0+11769913"
@@ -2226,6 +2261,27 @@ dependencies = [
"objc2-foundation",
]
[[package]]
name = "objc2-cloud-kit"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "73ad74d880bb43877038da939b7427bba67e9dd42004a18b809ba7d87cee241c"
dependencies = [
"bitflags 2.11.0",
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-data"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0b402a653efbb5e82ce4df10683b6b28027616a2715e90009947d50b8dd298fa"
dependencies = [
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-foundation"
version = "0.3.2"
@@ -2250,6 +2306,38 @@ dependencies = [
"objc2-io-surface",
]
[[package]]
name = "objc2-core-image"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e5d563b38d2b97209f8e861173de434bd0214cf020e3423a52624cd1d989f006"
dependencies = [
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-location"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ca347214e24bc973fc025fd0d36ebb179ff30536ed1f80252706db19ee452009"
dependencies = [
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-text"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0cde0dfb48d25d2b4862161a4d5fcc0e3c24367869ad306b0c9ec0073bfed92d"
dependencies = [
"bitflags 2.11.0",
"objc2",
"objc2-core-foundation",
"objc2-core-graphics",
]
[[package]]
name = "objc2-encode"
version = "4.1.0"
@@ -2308,8 +2396,27 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d87d638e33c06f577498cbcc50491496a3ed4246998a7fbba7ccb98b1e7eab22"
dependencies = [
"bitflags 2.11.0",
"block2",
"objc2",
"objc2-cloud-kit",
"objc2-core-data",
"objc2-core-foundation",
"objc2-core-graphics",
"objc2-core-image",
"objc2-core-location",
"objc2-core-text",
"objc2-foundation",
"objc2-quartz-core",
"objc2-user-notifications",
]
[[package]]
name = "objc2-user-notifications"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9df9128cbbfef73cda168416ccf7f837b62737d748333bfe9ab71c245d76613e"
dependencies = [
"objc2",
"objc2-foundation",
]
@@ -2463,7 +2570,6 @@ version = "0.11.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fd6780a80ae0c52cc120a26a1a42c1ae51b247a253e4e06113d23d2c2edd078"
dependencies = [
"phf_macros 0.11.3",
"phf_shared 0.11.3",
]
@@ -2525,7 +2631,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5d5285893bb5eb82e6aaf5d59ee909a06a16737a8970984dd7746ba9283498d6"
dependencies = [
"phf_shared 0.10.0",
"rand 0.8.5",
"rand 0.8.6",
]
[[package]]
@@ -2535,7 +2641,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d"
dependencies = [
"phf_shared 0.11.3",
"rand 0.8.5",
"rand 0.8.6",
]
[[package]]
@@ -2562,19 +2668,6 @@ dependencies = [
"syn 1.0.109",
]
[[package]]
name = "phf_macros"
version = "0.11.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f84ac04429c13a7ff43785d75ad27569f2951ce0ffd30a3321230db2fc727216"
dependencies = [
"phf_generator 0.11.3",
"phf_shared 0.11.3",
"proc-macro2",
"quote",
"syn 2.0.117",
]
[[package]]
name = "phf_macros"
version = "0.13.1"
@@ -2673,6 +2766,19 @@ dependencies = [
"miniz_oxide",
]
[[package]]
name = "png"
version = "0.18.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "60769b8b31b2a9f263dae2776c37b1b28ae246943cf719eb6946a1db05128a61"
dependencies = [
"bitflags 2.11.0",
"crc32fast",
"fdeflate",
"flate2",
"miniz_oxide",
]
[[package]]
name = "polling"
version = "3.11.0"
@@ -2841,9 +2947,9 @@ dependencies = [
[[package]]
name = "rand"
version = "0.8.5"
version = "0.8.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"
dependencies = [
"libc",
"rand_chacha 0.3.1",
@@ -3629,15 +3735,16 @@ dependencies = [
[[package]]
name = "tao"
version = "0.34.8"
version = "0.35.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9103edf55f2da3c82aea4c7fab7c4241032bfeea0e71fa557d98e00e7ce7cc20"
checksum = "a33f7f9e486ade65fcf1e45c440f9236c904f5c1002cdc7fc6ae582777345ce4"
dependencies = [
"bitflags 2.11.0",
"block2",
"core-foundation",
"core-graphics",
"crossbeam-channel",
"dbus",
"dispatch2",
"dlopen2",
"dpi",
@@ -3648,13 +3755,14 @@ dependencies = [
"libc",
"log",
"ndk",
"ndk-context",
"ndk-sys",
"objc2",
"objc2-app-kit",
"objc2-foundation",
"objc2-ui-kit",
"once_cell",
"parking_lot",
"percent-encoding",
"raw-window-handle",
"tao-macros",
"unicode-segmentation",
@@ -3684,9 +3792,9 @@ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
[[package]]
name = "tauri"
version = "2.10.3"
version = "2.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "da77cc00fb9028caf5b5d4650f75e31f1ef3693459dfca7f7e506d1ecef0ba2d"
checksum = "b93bd86d231f0a8138f11a02a584769fe4b703dc36ae133d783228dbc4801405"
dependencies = [
"anyhow",
"bytes",
@@ -3735,9 +3843,9 @@ dependencies = [
[[package]]
name = "tauri-build"
version = "2.5.6"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4bbc990d1dbf57a8e1c7fa2327f2a614d8b757805603c1b9ba5c81bade09fd4d"
checksum = "3a318b234cc2dea65f575467bafcfb76286bce228ebc3778e337d61d03213007"
dependencies = [
"anyhow",
"cargo_toml",
@@ -3751,22 +3859,21 @@ dependencies = [
"serde_json",
"tauri-utils",
"tauri-winres",
"toml 0.9.12+spec-1.1.0",
"walkdir",
]
[[package]]
name = "tauri-codegen"
version = "2.5.5"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d4a24476afd977c5d5d169f72425868613d82747916dd29e0a357c84c4bd6d29"
checksum = "6bd11644962add2549a60b7e7c6800f17d7020156e02f516021d8103e80cc528"
dependencies = [
"base64 0.22.1",
"brotli",
"ico",
"json-patch",
"plist",
"png",
"png 0.17.16",
"proc-macro2",
"quote",
"semver",
@@ -3784,9 +3891,9 @@ dependencies = [
[[package]]
name = "tauri-macros"
version = "2.5.5"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d39b349a98dadaffebb73f0a40dcd1f23c999211e5a2e744403db384d0c33de7"
checksum = "fed9d3742a37a355d2e47c9af924e9fbc112abb76f9835d35d4780e318419502"
dependencies = [
"heck 0.5.0",
"proc-macro2",
@@ -3899,10 +4006,25 @@ dependencies = [
]
[[package]]
name = "tauri-runtime"
version = "2.10.1"
name = "tauri-plugin-single-instance"
version = "2.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2826d79a3297ed08cd6ea7f412644ef58e32969504bc4fbd8d7dbeabc4445ea2"
checksum = "5c8f29386f5e9fdc699182388a33ee80a56de436d91b67459e86afef426282af"
dependencies = [
"serde",
"serde_json",
"tauri",
"thiserror 2.0.18",
"tracing",
"windows-sys 0.60.2",
"zbus",
]
[[package]]
name = "tauri-runtime"
version = "2.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8fef478ba1d2ac21c2d528740b24d0cb315e1e8b1111aae53fafac34804371fc"
dependencies = [
"cookie",
"dpi",
@@ -3925,9 +4047,9 @@ dependencies = [
[[package]]
name = "tauri-runtime-wry"
version = "2.10.1"
version = "2.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e11ea2e6f801d275fdd890d6c9603736012742a1c33b96d0db788c9cdebf7f9e"
checksum = "a3989df2ae1c476404fe0a2e8ffc4cfbde97e51efd613c2bb5355fbc9ab52cf0"
dependencies = [
"gtk",
"http",
@@ -3951,14 +4073,15 @@ dependencies = [
[[package]]
name = "tauri-utils"
version = "2.8.3"
version = "2.9.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "219a1f983a2af3653f75b5747f76733b0da7ff03069c7a41901a5eb3ace4557d"
checksum = "d57200389a2f82b4b0a40ae29ca19b6978116e8f4d4e974c3234ce40c0ffbdec"
dependencies = [
"anyhow",
"brotli",
"cargo_metadata",
"ctor",
"dom_query",
"dunce",
"glob",
"html5ever 0.29.1",
@@ -3968,7 +4091,8 @@ dependencies = [
"kuchikiki",
"log",
"memchr",
"phf 0.11.3",
"phf 0.13.1",
"plist",
"proc-macro2",
"quote",
"regex",
@@ -4323,9 +4447,9 @@ dependencies = [
[[package]]
name = "tray-icon"
version = "0.21.3"
version = "0.23.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a5e85aa143ceb072062fc4d6356c1b520a51d636e7bc8e77ec94be3608e5e80c"
checksum = "15edbb0d80583e85ee8df283410038e17314df5cba30da2087a54a85216c0773"
dependencies = [
"crossbeam-channel",
"dirs",
@@ -4337,10 +4461,10 @@ dependencies = [
"objc2-core-graphics",
"objc2-foundation",
"once_cell",
"png",
"png 0.18.1",
"serde",
"thiserror 2.0.18",
"windows-sys 0.60.2",
"windows-sys 0.61.2",
]
[[package]]
@@ -5323,9 +5447,9 @@ checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4"
[[package]]
name = "wry"
version = "0.54.4"
version = "0.55.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e5a8135d8676225e5744de000d4dff5a082501bf7db6a1c1495034f8c314edbc"
checksum = "186f9871daa55fd9c016578b810d149de58367113db7fb72b462d2323ce19514"
dependencies = [
"base64 0.22.1",
"block2",
@@ -5411,16 +5535,15 @@ dependencies = [
[[package]]
name = "yt-desc-gen"
version = "0.8.0"
version = "0.28.0"
dependencies = [
"serde",
"serde_json",
"tauri",
"tauri-build",
"tauri-plugin-dialog",
"tauri-plugin-fs",
"tauri-plugin-opener",
"tauri-plugin-shell",
"tauri-plugin-single-instance",
]
[[package]]
+3 -3
View File
@@ -1,9 +1,10 @@
[package]
name = "yt-desc-gen"
version = "0.8.0"
version = "0.28.0"
description = "YouTube Gameplay Description Generator"
authors = ["poli0981"]
edition = "2021"
license = "Apache-2.0"
[lib]
name = "yt_desc_gen_lib"
@@ -18,5 +19,4 @@ tauri-plugin-dialog = "2"
tauri-plugin-fs = "2"
tauri-plugin-opener = "2"
tauri-plugin-shell = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
tauri-plugin-single-instance = "2"
+1 -1
View File
@@ -1 +1 @@
{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"Denies the identifier command without any pre-configured scope.","commands":{"allow":[],"deny":["identifier"]}},"deny-name":{"identifier":"deny-name","description":"Denies the name command without any pre-configured scope.","commands":{"allow":[],"deny":["name"]}},"deny-register-listener":{"identifier":"deny-register-listener","description":"Denies the register_listener command without any pre-configured scope.","commands":{"allow":[],"deny":["register_listener"]}},"deny-remove-data-store":{"identifier":"deny-remove-data-store","description":"Denies the remove_data_store command Line truncated
{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener","allow-supports-multiple-windows"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-supports-multiple-windows":{"identifier":"allow-supports-multiple-windows","description":"Enables the supports_multiple_windows command without any pre-configured scope.","commands":{"allow":["supports_multiple_windows"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"Denies the identifier command without any pre-configured scope.","commands":{"allow":[],"deny":["identifier"]}},"deny-name":{"identifier":"deny-name","description":"Denies the name command without any pre-configured scope.","commands":{"allow":[],"deny":["name"]}},"deny-register-listener":{"identifier":"deny-reLine truncated
+54 -6
View File
@@ -2385,10 +2385,10 @@
"markdownDescription": "Default core plugins set.\n#### This default permission set includes:\n\n- `core:path:default`\n- `core:event:default`\n- `core:window:default`\n- `core:webview:default`\n- `core:app:default`\n- `core:image:default`\n- `core:resources:default`\n- `core:menu:default`\n- `core:tray:default`"
},
{
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`",
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`\n- `allow-supports-multiple-windows`",
"type": "string",
"const": "core:app:default",
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`"
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`\n- `allow-supports-multiple-windows`"
},
{
"description": "Enables the app_hide command without any pre-configured scope.",
@@ -2462,6 +2462,12 @@
"const": "core:app:allow-set-dock-visibility",
"markdownDescription": "Enables the set_dock_visibility command without any pre-configured scope."
},
{
"description": "Enables the supports_multiple_windows command without any pre-configured scope.",
"type": "string",
"const": "core:app:allow-supports-multiple-windows",
"markdownDescription": "Enables the supports_multiple_windows command without any pre-configured scope."
},
{
"description": "Enables the tauri_version command without any pre-configured scope.",
"type": "string",
@@ -2546,6 +2552,12 @@
"const": "core:app:deny-set-dock-visibility",
"markdownDescription": "Denies the set_dock_visibility command without any pre-configured scope."
},
{
"description": "Denies the supports_multiple_windows command without any pre-configured scope.",
"type": "string",
"const": "core:app:deny-supports-multiple-windows",
"markdownDescription": "Denies the supports_multiple_windows command without any pre-configured scope."
},
{
"description": "Denies the tauri_version command without any pre-configured scope.",
"type": "string",
@@ -3069,10 +3081,10 @@
"markdownDescription": "Denies the close command without any pre-configured scope."
},
{
"description": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-show-menu-on-left-click`",
"description": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-icon-with-as-template`\n- `allow-set-show-menu-on-left-click`",
"type": "string",
"const": "core:tray:default",
"markdownDescription": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-show-menu-on-left-click`"
"markdownDescription": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-icon-with-as-template`\n- `allow-set-show-menu-on-left-click`"
},
{
"description": "Enables the get_by_id command without any pre-configured scope.",
@@ -3104,6 +3116,12 @@
"const": "core:tray:allow-set-icon-as-template",
"markdownDescription": "Enables the set_icon_as_template command without any pre-configured scope."
},
{
"description": "Enables the set_icon_with_as_template command without any pre-configured scope.",
"type": "string",
"const": "core:tray:allow-set-icon-with-as-template",
"markdownDescription": "Enables the set_icon_with_as_template command without any pre-configured scope."
},
{
"description": "Enables the set_menu command without any pre-configured scope.",
"type": "string",
@@ -3170,6 +3188,12 @@
"const": "core:tray:deny-set-icon-as-template",
"markdownDescription": "Denies the set_icon_as_template command without any pre-configured scope."
},
{
"description": "Denies the set_icon_with_as_template command without any pre-configured scope.",
"type": "string",
"const": "core:tray:deny-set-icon-with-as-template",
"markdownDescription": "Denies the set_icon_with_as_template command without any pre-configured scope."
},
{
"description": "Denies the set_menu command without any pre-configured scope.",
"type": "string",
@@ -3429,10 +3453,16 @@
"markdownDescription": "Denies the webview_size command without any pre-configured scope."
},
{
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-internal-toggle-maximize`",
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-activity-name`\n- `allow-scene-identifier`\n- `allow-internal-toggle-maximize`",
"type": "string",
"const": "core:window:default",
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-internal-toggle-maximize`"
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-activity-name`\n- `allow-scene-identifier`\n- `allow-internal-toggle-maximize`"
},
{
"description": "Enables the activity_name command without any pre-configured scope.",
"type": "string",
"const": "core:window:allow-activity-name",
"markdownDescription": "Enables the activity_name command without any pre-configured scope."
},
{
"description": "Enables the available_monitors command without any pre-configured scope.",
@@ -3626,6 +3656,12 @@
"const": "core:window:allow-scale-factor",
"markdownDescription": "Enables the scale_factor command without any pre-configured scope."
},
{
"description": "Enables the scene_identifier command without any pre-configured scope.",
"type": "string",
"const": "core:window:allow-scene-identifier",
"markdownDescription": "Enables the scene_identifier command without any pre-configured scope."
},
{
"description": "Enables the set_always_on_bottom command without any pre-configured scope.",
"type": "string",
@@ -3890,6 +3926,12 @@
"const": "core:window:allow-unminimize",
"markdownDescription": "Enables the unminimize command without any pre-configured scope."
},
{
"description": "Denies the activity_name command without any pre-configured scope.",
"type": "string",
"const": "core:window:deny-activity-name",
"markdownDescription": "Denies the activity_name command without any pre-configured scope."
},
{
"description": "Denies the available_monitors command without any pre-configured scope.",
"type": "string",
@@ -4082,6 +4124,12 @@
"const": "core:window:deny-scale-factor",
"markdownDescription": "Denies the scale_factor command without any pre-configured scope."
},
{
"description": "Denies the scene_identifier command without any pre-configured scope.",
"type": "string",
"const": "core:window:deny-scene-identifier",
"markdownDescription": "Denies the scene_identifier command without any pre-configured scope."
},
{
"description": "Denies the set_always_on_bottom command without any pre-configured scope.",
"type": "string",
+54 -6
View File
@@ -2385,10 +2385,10 @@
"markdownDescription": "Default core plugins set.\n#### This default permission set includes:\n\n- `core:path:default`\n- `core:event:default`\n- `core:window:default`\n- `core:webview:default`\n- `core:app:default`\n- `core:image:default`\n- `core:resources:default`\n- `core:menu:default`\n- `core:tray:default`"
},
{
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`",
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`\n- `allow-supports-multiple-windows`",
"type": "string",
"const": "core:app:default",
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`"
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-version`\n- `allow-name`\n- `allow-tauri-version`\n- `allow-identifier`\n- `allow-bundle-type`\n- `allow-register-listener`\n- `allow-remove-listener`\n- `allow-supports-multiple-windows`"
},
{
"description": "Enables the app_hide command without any pre-configured scope.",
@@ -2462,6 +2462,12 @@
"const": "core:app:allow-set-dock-visibility",
"markdownDescription": "Enables the set_dock_visibility command without any pre-configured scope."
},
{
"description": "Enables the supports_multiple_windows command without any pre-configured scope.",
"type": "string",
"const": "core:app:allow-supports-multiple-windows",
"markdownDescription": "Enables the supports_multiple_windows command without any pre-configured scope."
},
{
"description": "Enables the tauri_version command without any pre-configured scope.",
"type": "string",
@@ -2546,6 +2552,12 @@
"const": "core:app:deny-set-dock-visibility",
"markdownDescription": "Denies the set_dock_visibility command without any pre-configured scope."
},
{
"description": "Denies the supports_multiple_windows command without any pre-configured scope.",
"type": "string",
"const": "core:app:deny-supports-multiple-windows",
"markdownDescription": "Denies the supports_multiple_windows command without any pre-configured scope."
},
{
"description": "Denies the tauri_version command without any pre-configured scope.",
"type": "string",
@@ -3069,10 +3081,10 @@
"markdownDescription": "Denies the close command without any pre-configured scope."
},
{
"description": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-show-menu-on-left-click`",
"description": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-icon-with-as-template`\n- `allow-set-show-menu-on-left-click`",
"type": "string",
"const": "core:tray:default",
"markdownDescription": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-show-menu-on-left-click`"
"markdownDescription": "Default permissions for the plugin, which enables all commands.\n#### This default permission set includes:\n\n- `allow-new`\n- `allow-get-by-id`\n- `allow-remove-by-id`\n- `allow-set-icon`\n- `allow-set-menu`\n- `allow-set-tooltip`\n- `allow-set-title`\n- `allow-set-visible`\n- `allow-set-temp-dir-path`\n- `allow-set-icon-as-template`\n- `allow-set-icon-with-as-template`\n- `allow-set-show-menu-on-left-click`"
},
{
"description": "Enables the get_by_id command without any pre-configured scope.",
@@ -3104,6 +3116,12 @@
"const": "core:tray:allow-set-icon-as-template",
"markdownDescription": "Enables the set_icon_as_template command without any pre-configured scope."
},
{
"description": "Enables the set_icon_with_as_template command without any pre-configured scope.",
"type": "string",
"const": "core:tray:allow-set-icon-with-as-template",
"markdownDescription": "Enables the set_icon_with_as_template command without any pre-configured scope."
},
{
"description": "Enables the set_menu command without any pre-configured scope.",
"type": "string",
@@ -3170,6 +3188,12 @@
"const": "core:tray:deny-set-icon-as-template",
"markdownDescription": "Denies the set_icon_as_template command without any pre-configured scope."
},
{
"description": "Denies the set_icon_with_as_template command without any pre-configured scope.",
"type": "string",
"const": "core:tray:deny-set-icon-with-as-template",
"markdownDescription": "Denies the set_icon_with_as_template command without any pre-configured scope."
},
{
"description": "Denies the set_menu command without any pre-configured scope.",
"type": "string",
@@ -3429,10 +3453,16 @@
"markdownDescription": "Denies the webview_size command without any pre-configured scope."
},
{
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-internal-toggle-maximize`",
"description": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-activity-name`\n- `allow-scene-identifier`\n- `allow-internal-toggle-maximize`",
"type": "string",
"const": "core:window:default",
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-internal-toggle-maximize`"
"markdownDescription": "Default permissions for the plugin.\n#### This default permission set includes:\n\n- `allow-get-all-windows`\n- `allow-scale-factor`\n- `allow-inner-position`\n- `allow-outer-position`\n- `allow-inner-size`\n- `allow-outer-size`\n- `allow-is-fullscreen`\n- `allow-is-minimized`\n- `allow-is-maximized`\n- `allow-is-focused`\n- `allow-is-decorated`\n- `allow-is-resizable`\n- `allow-is-maximizable`\n- `allow-is-minimizable`\n- `allow-is-closable`\n- `allow-is-visible`\n- `allow-is-enabled`\n- `allow-title`\n- `allow-current-monitor`\n- `allow-primary-monitor`\n- `allow-monitor-from-point`\n- `allow-available-monitors`\n- `allow-cursor-position`\n- `allow-theme`\n- `allow-is-always-on-top`\n- `allow-activity-name`\n- `allow-scene-identifier`\n- `allow-internal-toggle-maximize`"
},
{
"description": "Enables the activity_name command without any pre-configured scope.",
"type": "string",
"const": "core:window:allow-activity-name",
"markdownDescription": "Enables the activity_name command without any pre-configured scope."
},
{
"description": "Enables the available_monitors command without any pre-configured scope.",
@@ -3626,6 +3656,12 @@
"const": "core:window:allow-scale-factor",
"markdownDescription": "Enables the scale_factor command without any pre-configured scope."
},
{
"description": "Enables the scene_identifier command without any pre-configured scope.",
"type": "string",
"const": "core:window:allow-scene-identifier",
"markdownDescription": "Enables the scene_identifier command without any pre-configured scope."
},
{
"description": "Enables the set_always_on_bottom command without any pre-configured scope.",
"type": "string",
@@ -3890,6 +3926,12 @@
"const": "core:window:allow-unminimize",
"markdownDescription": "Enables the unminimize command without any pre-configured scope."
},
{
"description": "Denies the activity_name command without any pre-configured scope.",
"type": "string",
"const": "core:window:deny-activity-name",
"markdownDescription": "Denies the activity_name command without any pre-configured scope."
},
{
"description": "Denies the available_monitors command without any pre-configured scope.",
"type": "string",
@@ -4082,6 +4124,12 @@
"const": "core:window:deny-scale-factor",
"markdownDescription": "Denies the scale_factor command without any pre-configured scope."
},
{
"description": "Denies the scene_identifier command without any pre-configured scope.",
"type": "string",
"const": "core:window:deny-scene-identifier",
"markdownDescription": "Denies the scene_identifier command without any pre-configured scope."
},
{
"description": "Denies the set_always_on_bottom command without any pre-configured scope.",
"type": "string",
+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.
+90 -1
View File
@@ -20,6 +20,75 @@ fn read_from_file(path: String) -> Result<String, String> {
std::fs::read_to_string(&path).map_err(|e| e.to_string())
}
/// Ensure a directory exists on disk, creating it (and any missing
/// parents) if necessary. No-op when the path already exists as a
/// directory. Fixes the "Windows cannot find ... AppData\Roaming\
/// com.skullmute.ytdescgen" Explorer error on first launch — see
/// `openSettingsFolder()` in `SettingsPage.tsx`, where this is called
/// before `openPath(dir)` so the OS shell never sees a non-existent
/// path. Returns the OS error string on failure (e.g. permission
/// denied) so the caller can surface it via the in-app log.
#[tauri::command]
fn ensure_dir(path: String) -> Result<(), String> {
std::fs::create_dir_all(&path).map_err(|e| e.to_string())
}
/// Append `content` to the file at `path`, creating the file (and any
/// missing parent directories) if necessary. Used by the v0.17.0 log
/// persistence pipeline to write JSONL entries one line at a time,
/// rather than rewriting the whole file on every log call. Cheap
/// enough that we can call it on every `addEntry` without batching.
/// The caller is responsible for newline termination — this is a raw
/// byte append, not a line writer.
#[tauri::command]
fn append_to_file(path: String, content: String) -> Result<(), String> {
use std::fs::OpenOptions;
use std::io::Write;
if let Some(parent) = std::path::Path::new(&path).parent() {
std::fs::create_dir_all(parent).map_err(|e| e.to_string())?;
}
let mut file = OpenOptions::new()
.append(true)
.create(true)
.open(&path)
.map_err(|e| e.to_string())?;
file.write_all(content.as_bytes()).map_err(|e| e.to_string())
}
/// List entries in a directory, returning their file names (not full
/// paths). Used by the v0.17.0 log retention sweep to find
/// `ytdescgen-*.jsonl` files older than the configured retention
/// window. Returns an empty vec if the directory doesn't exist
/// (i.e. no logs have been written yet) — first-run safe.
#[tauri::command]
fn list_dir(path: String) -> Result<Vec<String>, String> {
let dir = std::path::Path::new(&path);
if !dir.exists() {
return Ok(Vec::new());
}
let entries = std::fs::read_dir(dir).map_err(|e| e.to_string())?;
let mut names = Vec::new();
for entry in entries.flatten() {
if let Some(name) = entry.file_name().to_str() {
names.push(name.to_string());
}
}
Ok(names)
}
/// Delete a file at `path` if it exists. No-op when the file is
/// missing (used by log retention sweep — racing with another sweep
/// or a manual cleanup shouldn't error). Returns the OS error string
/// on permission failures.
#[tauri::command]
fn delete_file(path: String) -> Result<(), String> {
let p = std::path::Path::new(&path);
if !p.exists() {
return Ok(());
}
std::fs::remove_file(p).map_err(|e| e.to_string())
}
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
// Flag that signals the user has requested a full quit (via tray menu).
@@ -31,6 +100,19 @@ pub fn run() {
let quitting_run = quitting.clone();
tauri::Builder::default()
// Single-instance MUST be the first plugin registered (v0.12). Without
// it, every launch spawns a fresh process — which then builds its own
// tray icon in `setup()`, stacking duplicates in the system tray and
// leaving orphan processes in Task Manager. The callback runs in the
// *first* (already-running) instance when a second launch is attempted:
// we surface its window instead of letting the second process boot.
.plugin(tauri_plugin_single_instance::init(|app, _argv, _cwd| {
if let Some(window) = app.get_webview_window("main") {
let _ = window.show();
let _ = window.unminimize();
let _ = window.set_focus();
}
}))
.plugin(tauri_plugin_dialog::init())
.plugin(tauri_plugin_fs::init())
.plugin(tauri_plugin_opener::init())
@@ -86,7 +168,14 @@ pub fn run() {
}
}
})
.invoke_handler(tauri::generate_handler![save_to_file, read_from_file])
.invoke_handler(tauri::generate_handler![
save_to_file,
read_from_file,
ensure_dir,
append_to_file,
list_dir,
delete_file
])
.build(tauri::generate_context!())
.expect("error while building tauri application")
.run(move |_app_handle, event| {
+8 -4
View File
@@ -1,7 +1,7 @@
{
"$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-cli/schema.json",
"productName": "YTDescGen",
"version": "0.8.0",
"version": "0.28.0",
"identifier": "com.skullmute.ytdescgen",
"build": {
"beforeBuildCommand": "npm run build",
@@ -15,9 +15,12 @@
"title": "YTDescGen",
"width": 1100,
"height": 750,
"minWidth": 800,
"minHeight": 600,
"resizable": true,
"minWidth": 1100,
"minHeight": 750,
"maxWidth": 1100,
"maxHeight": 750,
"resizable": false,
"maximizable": false,
"fullscreen": false,
"center": true
}
@@ -32,6 +35,7 @@
},
"bundle": {
"active": true,
"licenseFile": "installer-license.txt",
"icon": [
"icons/32x32.png",
"icons/128x128.png",
+133 -34
View File
@@ -1,12 +1,19 @@
import { lazy, Suspense, useEffect } from "react";
import { lazy, Suspense, useEffect, type ReactNode } from "react";
import { HashRouter, Routes, Route } from "react-router-dom";
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";
import "@i18n/index";
import { hydrateLogStore } from "@store/log-store";
import { useSettingsStore } from "@store/settings-store";
import i18n from "@i18n/index";
const ProfilesPage = lazy(() =>
import("@pages/ProfilesPage").then((m) => ({ default: m.ProfilesPage })),
@@ -20,81 +27,173 @@ 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 })),
);
const LogPage = lazy(() =>
import("@pages/LogPage").then((m) => ({ default: m.LogPage })),
);
const AboutPage = lazy(() =>
import("@pages/AboutPage").then((m) => ({ default: m.AboutPage })),
);
function PageLoader() {
return <div className="flex items-center justify-center p-12 text-text-muted">Loading...</div>;
}
/**
* Wrap a lazy-loaded page in both a {@link Suspense} (for the dynamic
* import) and an {@link ErrorBoundary} (for render errors). The
* boundary sits *outside* Suspense so a thrown error during lazy
* resolution also gets caught, not just errors from rendered children.
* Each route gets its own boundary instance so a crash on one tab
* cannot black-screen the whole app — the user can navigate elsewhere
* and recover.
*/
function PageBoundary({ label, children }: { label: string; children: ReactNode }) {
return (
<ErrorBoundary label={label}>
<Suspense fallback={<PageLoader />}>{children}</Suspense>
</ErrorBoundary>
);
}
export default function App() {
useEffect(() => {
checkDataFileHealth().then((msg) => {
if (msg) toast(msg, { icon: "⚠️", duration: 5000 });
});
// v0.17.0: hydrate the log store from persisted JSONL files /
// localStorage so prior-session entries surface in the Logs tab
// accordion. Uses the current `logRetentionDays` setting — read
// directly off the store at mount time so we don't rerun on
// every settings tweak.
const retentionDays = useSettingsStore.getState().logRetentionDays;
void hydrateLogStore(retentionDays);
}, []);
// v0.18.0: bridge the persisted `appLanguage` setting back to i18next.
//
// i18n is initialised synchronously at module load with `fallbackLng:
// "en"` and no `lng` field — so on a fresh app boot the UI renders in
// English even when localStorage / settings.json contain a non-English
// preference. Zustand's persist middleware rehydrates the store
// synchronously from localStorage *before* React mounts, and the
// storage-adapter then *asynchronously* reads the Tauri `settings.json`
// and may overwrite the value again. We cover both paths:
//
// 1. Read the current `appLanguage` at mount time and push it into
// i18n — handles the synchronous localStorage hydrate.
// 2. Subscribe to subsequent changes so the async Tauri rehydrate
// (and any future user-driven switch via Header / SettingsPage)
// also propagates. The Header/SettingsPage callsites still call
// `i18n.changeLanguage` directly, which is now redundant but
// harmless — the subscribe is the single source of truth.
useEffect(() => {
const initialLang = useSettingsStore.getState().appLanguage;
if (initialLang && i18n.language !== initialLang) {
void i18n.changeLanguage(initialLang);
}
const unsub = useSettingsStore.subscribe((state, prev) => {
if (state.appLanguage !== prev.appLanguage) {
void i18n.changeLanguage(state.appLanguage);
}
});
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>
<Routes>
<Route element={<AppShell />}>
<Route index element={<EditorPage />} />
<Route path="output" element={<OutputPage />} />
<Route
index
element={
<ErrorBoundary label="Editor">
<EditorPage />
</ErrorBoundary>
}
/>
<Route
path="output"
element={
<ErrorBoundary label="Output">
<OutputPage />
</ErrorBoundary>
}
/>
<Route
path="profiles"
element={
<Suspense fallback={<PageLoader />}>
<ProfilesPage />
</Suspense>
}
element={<PageBoundary label="Profiles"><ProfilesPage /></PageBoundary>}
/>
<Route
path="history"
element={
<Suspense fallback={<PageLoader />}>
<HistoryPage />
</Suspense>
}
element={<PageBoundary label="History"><HistoryPage /></PageBoundary>}
/>
<Route
path="settings"
element={
<Suspense fallback={<PageLoader />}>
<SettingsPage />
</Suspense>
}
element={<PageBoundary label="Settings"><SettingsPage /></PageBoundary>}
/>
<Route
path="batch"
element={
<Suspense fallback={<PageLoader />}>
<BatchPage />
</Suspense>
}
element={<PageBoundary label="Batch"><BatchPage /></PageBoundary>}
/>
<Route
path="social"
element={<PageBoundary label="Social"><SocialPage /></PageBoundary>}
/>
<Route
path="playlist"
element={
<Suspense fallback={<PageLoader />}>
<PlaylistPage />
</Suspense>
}
element={<PageBoundary label="Playlist"><PlaylistPage /></PageBoundary>}
/>
<Route
path="logs"
element={
<Suspense fallback={<PageLoader />}>
<LogPage />
</Suspense>
}
element={<PageBoundary label="Logs"><LogPage /></PageBoundary>}
/>
<Route
path="about"
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>
);
}
+95
View File
@@ -0,0 +1,95 @@
import { Component, type ErrorInfo, type ReactNode } from "react";
import { ErrorPage } from "@components/errors/ErrorPage";
interface ErrorBoundaryProps {
/** Children to render normally. The boundary only kicks in on render
* errors thrown inside this subtree. */
children: ReactNode;
/** Human label that appears in the fallback UI to tell the user
* *what* crashed (e.g. "Profiles tab", "Editor"). Defaults to a
* generic "this section" copy so the boundary still degrades nicely
* if a caller forgets the prop. */
label?: string;
/** Optional callback fired on every catch — useful in tests, or to
* funnel boundary errors into a centralised reporter. The component
* also logs to `useLogStore` directly so the in-app Log tab gets a
* copy regardless. */
onError?: (error: Error, info: ErrorInfo) => void;
}
interface ErrorBoundaryState {
error: Error | null;
}
/**
* Class-based React error boundary — there is still no hook equivalent
* in React 18 (and as of React 19 only `useErrorBoundary` from external
* libraries cover the gap). Catches *render-time* exceptions from any
* descendant component and swaps in a fallback UI so the rest of the
* app keeps working.
*
* Motivation: v0.13.x had no boundary anywhere, so any render error —
* most commonly `Cannot convert undefined or null to object` when a
* malformed profile / template was loaded via Object spread — escalated
* into a black-screen crash. The boundary nets those errors at the
* route level, surfaces a recovery affordance, and writes a structured
* entry to the in-app log tab so the user can copy it into a bug
* report.
*
* Per-route boundaries (one per `<Route>`) mean a crash on the Profiles
* tab does not take down the Editor — the user can navigate away,
* adjust state, and click "Try again" to remount the broken subtree.
*
* Does NOT catch: async errors (Promise rejections), event-handler
* errors, SSR errors. For those use try/catch + the in-app logger
* directly (see `SettingsPage.importSettingsFromFile`).
*/
export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
state: ErrorBoundaryState = { error: null };
static getDerivedStateFromError(error: Error): ErrorBoundaryState {
return { error };
}
componentDidCatch(error: Error, info: ErrorInfo): void {
// Best-effort: pull the in-app logger lazily so the boundary stays
// importable from non-React entry points. We never let the logger
// itself throw a secondary error — if the log store is missing we
// fall back to the browser console.
try {
// Dynamic import dodges a circular dep with files that themselves
// import ErrorBoundary, e.g. when the boundary is mounted in
// main.tsx before the store has registered.
void import("@utils/logger").then(({ logger }) => {
logger.error(
"errorBoundary",
`[${this.props.label ?? "app"}] ${error.message}`,
info.componentStack ?? error.stack ?? "",
);
});
} catch {
console.error("ErrorBoundary caught:", error, info);
}
this.props.onError?.(error, info);
}
private handleReset = (): void => {
this.setState({ error: null });
};
render(): ReactNode {
if (!this.state.error) return this.props.children;
// 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 (
<ErrorPage
kind="runtime"
variant="contained"
onReset={this.handleReset}
detail={this.state.error.message}
/>
);
}
}
@@ -1,82 +0,0 @@
import { useTranslation } from "react-i18next";
import { Select } from "@components/ui/Select";
import { Input } from "@components/ui/Input";
import { ChipGroup } from "@components/ui/ChipGroup";
import { useEditorStore } from "@store/editor-store";
import {
PLAYTHROUGH_STATUSES,
DIFFICULTY_LEVELS,
CONTENT_WARNINGS,
type PlaythroughStatus,
type DifficultyLevel,
type ContentWarning,
} from "@engine/types";
/**
* Metadata that tells viewers "what kind of run is this and is it safe
* to watch". Lives in the Content Details accordion alongside
* timestamps + spoiler/mature toggles because all four are about
* framing, not about the capture itself.
*
* Design notes:
* - Playthrough + Difficulty default to `"none"`, which renders as "(no
* value)" in the select and suppresses the section in the generated
* description. Makes "no opinion" explicit rather than ambiguous.
* - The custom-difficulty input only appears when the creator picks
* `"custom"` — free-form text is intentionally not translated, so
* game-specific names like "Lethal" or "Blueberry" survive a locale
* switch unchanged.
* - Content warnings use the existing ChipGroup multi-select, capped at
* the full set (no `max` prop — every warning is additive).
*/
export function ContentDetailsForm() {
const { t } = useTranslation("ui");
const store = useEditorStore();
const playthroughOptions = PLAYTHROUGH_STATUSES.map((id) => ({
value: id,
label: t(`editor.playthroughOptions.${id}`),
}));
const difficultyOptions = DIFFICULTY_LEVELS.map((id) => ({
value: id,
label: t(`editor.difficultyOptions.${id}`),
}));
const contentWarningOptions = CONTENT_WARNINGS.map((id) => ({
id,
label: t(`editor.contentWarningOptions.${id}`),
}));
return (
<div className="flex flex-col gap-3">
<Select
label={t("editor.playthrough")}
options={playthroughOptions}
value={store.playthroughStatus}
onChange={(v) => store.set("playthroughStatus", v as PlaythroughStatus)}
/>
<Select
label={t("editor.difficulty")}
options={difficultyOptions}
value={store.difficulty}
onChange={(v) => store.set("difficulty", v as DifficultyLevel)}
/>
{store.difficulty === "custom" && (
<Input
label={t("editor.difficultyCustomLabel")}
placeholder={t("editor.difficultyCustomPlaceholder")}
value={store.difficultyCustomLabel}
onChange={(e) => store.set("difficultyCustomLabel", e.target.value)}
/>
)}
<ChipGroup
label={t("editor.contentWarnings")}
multiple
options={contentWarningOptions}
value={store.contentWarnings}
onChange={(next) => store.set("contentWarnings", next as ContentWarning[])}
/>
</div>
);
}
@@ -0,0 +1,172 @@
import { useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { ChevronDown, ChevronRight, Search, X } from "lucide-react";
import clsx from "clsx";
import { useEditorStore } from "@store/editor-store";
import {
CONTENT_WARNING_GROUPS,
type ContentWarningGroup,
} from "@config/content-warning-groups";
import type { ContentWarning } from "@engine/types";
/**
* Replaces the v0.7 `WarningToggles` (2 boolean toggles + small
* checklist) with a unified, searchable, grouped checklist of ~40
* content-warning items. Each item maps to an entry in the editor's
* `contentWarnings` array; checking appends, unchecking removes.
*
* Selection order is preserved — the description renders bullets in
* the order the user picked them.
*/
export function ContentWarningChecklist() {
const { t } = useTranslation("ui");
const selected = useEditorStore((s) => s.contentWarnings);
const set = useEditorStore((s) => s.set);
const [query, setQuery] = useState("");
// Groups start collapsed except the one with the most-likely-needed
// items (Spoilers). Users can search to bypass the collapse anyway.
const [openGroups, setOpenGroups] = useState<Record<string, boolean>>(() => ({
spoilers: true,
photosensitive: false,
phobias: false,
mental_health: false,
social_phenomena: false,
sensitive: false,
horror_specific: false,
}));
const trimmedQuery = query.trim().toLowerCase();
const isFiltering = trimmedQuery.length > 0;
const filteredGroups = useMemo<ContentWarningGroup[]>(() => {
if (!isFiltering) return [...CONTENT_WARNING_GROUPS];
return CONTENT_WARNING_GROUPS.map((group) => ({
...group,
items: group.items.filter((id) =>
t(`editor.contentWarningOptions.${id}`).toLowerCase().includes(trimmedQuery),
),
})).filter((group) => group.items.length > 0);
}, [t, trimmedQuery, isFiltering]);
const totalMatching = filteredGroups.reduce((acc, g) => acc + g.items.length, 0);
function toggleItem(id: ContentWarning) {
if (selected.includes(id)) {
set(
"contentWarnings",
selected.filter((x) => x !== id),
);
} else {
set("contentWarnings", [...selected, id]);
}
}
function toggleGroup(groupId: string) {
setOpenGroups((prev) => ({ ...prev, [groupId]: !prev[groupId] }));
}
return (
<div className="flex flex-col gap-2">
<div className="flex items-baseline justify-between">
<span className="text-sm font-medium text-text-secondary">
{t("editor.warnings")}
</span>
{selected.length > 0 && (
<span className="text-xs text-text-muted">
{selected.length} selected
</span>
)}
</div>
<div className="relative">
<Search className="pointer-events-none absolute left-2.5 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-text-muted" />
<input
type="text"
value={query}
onChange={(e) => setQuery(e.target.value)}
placeholder={t("editor.contentWarningSearchPlaceholder")}
className="w-full rounded-md border border-border bg-surface-1 py-1.5 pl-8 pr-7 text-sm text-text-primary placeholder:text-text-muted focus:border-accent focus:outline-none"
/>
{query && (
<button
type="button"
onClick={() => setQuery("")}
className="absolute right-2 top-1/2 -translate-y-1/2 text-text-muted hover:text-text-primary"
aria-label="Clear search"
>
<X className="h-3.5 w-3.5" />
</button>
)}
</div>
{isFiltering && totalMatching === 0 ? (
<p className="py-2 text-center text-xs text-text-muted">
{t("editor.contentWarningEmpty")}
</p>
) : (
<div className="flex flex-col gap-1">
{filteredGroups.map((group) => {
const isOpen = isFiltering || openGroups[group.id];
const groupSelectedCount = group.items.filter((id) =>
selected.includes(id),
).length;
return (
<div
key={group.id}
className="overflow-hidden rounded-md border border-border bg-surface-1"
>
<button
type="button"
onClick={() => toggleGroup(group.id)}
className="flex w-full items-center justify-between px-3 py-2 text-left text-xs font-medium text-text-secondary hover:bg-surface-2"
aria-expanded={isOpen}
>
<span className="flex items-center gap-1.5">
{isOpen ? (
<ChevronDown className="h-3.5 w-3.5" />
) : (
<ChevronRight className="h-3.5 w-3.5" />
)}
{t(group.labelKey)}
</span>
{groupSelectedCount > 0 && (
<span className="rounded-full bg-accent/15 px-2 py-0.5 text-[10px] font-medium text-accent">
{groupSelectedCount}
</span>
)}
</button>
{isOpen && (
<div className="grid grid-cols-1 gap-x-3 gap-y-1 border-t border-border bg-surface-1 px-3 py-2 sm:grid-cols-2">
{group.items.map((id) => {
const checked = selected.includes(id);
return (
<label
key={id}
className={clsx(
"flex cursor-pointer items-center gap-2 rounded px-1.5 py-1 text-xs transition-colors",
checked
? "text-text-primary"
: "text-text-secondary hover:text-text-primary",
)}
>
<input
type="checkbox"
checked={checked}
onChange={() => toggleItem(id)}
className="h-3.5 w-3.5 shrink-0 cursor-pointer rounded border-border text-accent focus:ring-1 focus:ring-accent/40"
/>
<span>{t(`editor.contentWarningOptions.${id}`)}</span>
</label>
);
})}
</div>
)}
</div>
);
})}
</div>
)}
</div>
);
}
+406
View File
@@ -0,0 +1,406 @@
import { useMemo } from "react";
import { useTranslation } from "react-i18next";
import { Plus, Minus, AlertTriangle } from "lucide-react";
import { Input } from "@components/ui/Input";
import { Button } from "@components/ui/Button";
import { Select } from "@components/ui/Select";
import {
useEditorStore,
computeContiguousRanges,
} from "@store/editor-store";
import { parseTimeline } from "@engine/timeline-parser";
import { formatEndingEntry } from "@engine/endings-format";
import type { EndingEntry, EndingVideoRange } from "@engine/types";
/** Editor cap, matching the original spec ("Giá trị từ 1 - 100"). */
const MAX_ENDINGS = 100;
/**
* Structured ending editor (v0.16.0). Replaces the freeform
* "Endings shown" single Input that used to live in
* `PlaythroughNotesForm`.
*
* Three logical cases drive the layout:
*
* • Case A — `endings.length <= 1`:
* Single Number + Name pair. At least one of the two must be
* filled; otherwise a banner explains that the entry will be
* dropped from the description bullet.
*
* • Case B — `endings.length >= 2` AND `endingVideoCount === 1`:
* Table with one row per ending. A gate inspects the
* Timestamps textarea — if it doesn't contain at least
* `endings.length` lines matching the `ending` keyword, a
* warning banner surfaces. (The actual copy-blocking is wired
* in CopyAllBar; this component just renders the banner so the
* creator sees the problem inline with the field that caused
* it.)
*
* • Case C — `endings.length >= 2` AND `endingVideoCount >= 2`:
* Endings table + a per-video range table. Default ranges are
* contiguous and balanced (extras spill into the last video);
* the creator can override per-row. Invalid overlaps /
* coverage gaps surface as inline warnings.
*
* The "Ending shown" preview line under each entry mirrors the
* formatter used by the description builder so creators see exactly
* what will land in the rendered bullet.
*/
export function EndingsEditor() {
const { t } = useTranslation("ui");
const endings = useEditorStore((s) => s.endings);
const endingVideoCount = useEditorStore((s) => s.endingVideoCount);
const endingVideoRanges = useEditorStore((s) => s.endingVideoRanges);
const endingVideoIndex = useEditorStore((s) => s.endingVideoIndex);
const timestamps = useEditorStore((s) => s.timestamps);
const set = useEditorStore((s) => s.set);
const count = endings.length;
const isMultiEnding = count >= 2;
const isMultiVideo = isMultiEnding && endingVideoCount >= 2;
/**
* Count timeline lines tagged as the "ending" keyword. Used by case
* B as a copy-time validity gate — the creator must declare at
* least as many timeline markers as the structured array claims.
*/
const timelineEndingCount = useMemo(() => {
if (!isMultiEnding || isMultiVideo) return 0;
const parsed = parseTimeline(timestamps);
return parsed.filter((e) => e.keyword === "ending").length;
}, [timestamps, isMultiEnding, isMultiVideo]);
/** Resize the structured `endings[]` array to a new length, padding
* with empty entries or truncating. Triggers a range recompute so
* case C stays in sync when going from 6→4 endings etc. */
const setEndingCount = (next: number) => {
const clamped = Math.max(0, Math.min(MAX_ENDINGS, Math.floor(next)));
const nextEndings: EndingEntry[] =
clamped <= count
? endings.slice(0, clamped)
: [...endings, ...Array.from({ length: clamped - count }, () => ({ number: null, name: "" }))];
set("endings", nextEndings);
// Re-derive endingVideoCount + ranges so the schema invariants
// (videoCount <= endings.length, ranges.length === videoCount)
// stay true after a shrink/grow.
const nextVideoCount = clamped === 0 ? 1 : Math.min(endingVideoCount, clamped);
set("endingVideoCount", nextVideoCount);
set(
"endingVideoRanges",
clamped === 0 ? [] : computeContiguousRanges(clamped, nextVideoCount),
);
};
/** Update one ending row's number / name. */
const updateEnding = (i: number, patch: Partial<EndingEntry>) => {
const next = endings.map((e, idx) => (idx === i ? { ...e, ...patch } : e));
set("endings", next);
};
/** Update the multi-video count (case C). Recomputes default ranges
* on change unless the creator has already customised them — we
* always reset on count change because a manual override at the old
* count is unlikely to make sense at the new one. Also clamps
* `endingVideoIndex` so a shrink doesn't leave us previewing a
* video that no longer exists. */
const setVideoCount = (next: number) => {
if (count === 0) return;
const clamped = Math.max(1, Math.min(count, Math.floor(next)));
set("endingVideoCount", clamped);
set("endingVideoRanges", computeContiguousRanges(count, clamped));
if (endingVideoIndex > clamped) {
set("endingVideoIndex", clamped);
}
};
/** Update one video's `from` / `to` bound (case C). Doesn't enforce
* non-overlap inline — the warning banner surfaces invalid
* configurations after the fact, since mid-edit overlaps are
* expected. */
const updateRange = (i: number, patch: Partial<EndingVideoRange>) => {
const next = endingVideoRanges.map((r, idx) =>
idx === i ? { ...r, ...patch } : r,
);
set("endingVideoRanges", next);
};
/**
* Inspect the current ranges array for overlap / gap / out-of-bounds
* errors. Returns a translation-key list that the warning banner
* iterates. Pure-ish — closes over `endingVideoRanges` + `count`.
*/
const rangeWarnings: string[] = useMemo(() => {
if (!isMultiVideo) return [];
const warnings: string[] = [];
const sorted = [...endingVideoRanges]
.map((r, idx) => ({ idx, ...r }))
.sort((a, b) => a.from - b.from);
for (const r of sorted) {
if (r.from < 1 || r.to > count || r.from > r.to) {
warnings.push(
t("editor.endings.warnings.rangeInvalid", {
video: r.idx + 1,
from: r.from,
to: r.to,
}),
);
}
}
// Coverage + overlap pass.
let covered = 0;
for (let i = 0; i < sorted.length; i++) {
const r = sorted[i];
if (!r) continue;
if (r.from > covered + 1) {
warnings.push(t("editor.endings.warnings.rangeGap", { at: covered + 1 }));
}
if (r.from <= covered) {
warnings.push(t("editor.endings.warnings.rangeOverlap", { at: r.from }));
}
if (r.to > covered) covered = r.to;
}
if (covered < count) {
warnings.push(t("editor.endings.warnings.rangeShort", { at: covered + 1, total: count }));
}
return warnings;
}, [endingVideoRanges, count, isMultiVideo, t]);
/** Build the "Ending shown" preview string for a single entry. */
const previewFor = (entry: EndingEntry): string =>
formatEndingEntry(entry) ?? t("editor.endings.previewEmpty");
return (
<div className="flex flex-col gap-3">
<div className="flex items-end gap-2">
<div className="flex-1">
<Input
label={t("editor.endings.countLabel")}
type="number"
min={0}
max={MAX_ENDINGS}
value={String(count)}
onChange={(e) => setEndingCount(Number(e.target.value) || 0)}
/>
</div>
{count > 0 && (
<div className="flex gap-1">
<Button
variant="ghost"
size="sm"
onClick={() => setEndingCount(count - 1)}
aria-label={t("editor.endings.removeLast")}
>
<Minus className="h-3.5 w-3.5" />
</Button>
<Button
variant="ghost"
size="sm"
onClick={() => setEndingCount(count + 1)}
aria-label={t("editor.endings.addOne")}
disabled={count >= MAX_ENDINGS}
>
<Plus className="h-3.5 w-3.5" />
</Button>
</div>
)}
</div>
{count === 0 && (
<p className="text-xs text-text-muted">{t("editor.endings.emptyHint")}</p>
)}
{/* CASE A: single ending — number + name pair, with preview. */}
{count === 1 && endings[0] && (
<div className="flex flex-col gap-2 rounded-lg border border-border bg-surface-1 p-3">
<div className="grid grid-cols-[100px_1fr] gap-2">
<Input
label={t("editor.endings.numberLabel")}
type="number"
min={1}
max={MAX_ENDINGS}
value={endings[0].number?.toString() ?? ""}
placeholder="3"
onChange={(e) => {
const v = e.target.value.trim();
updateEnding(0, { number: v === "" ? null : Number(v) });
}}
/>
<Input
label={t("editor.endings.nameLabel")}
placeholder={t("editor.endings.namePlaceholder")}
value={endings[0].name}
onChange={(e) => updateEnding(0, { name: e.target.value })}
/>
</div>
<p className="text-xs text-text-muted">
{t("editor.endings.previewLabel")}:{" "}
<span className="font-mono text-text-secondary">{previewFor(endings[0])}</span>
</p>
{!endings[0].number && !endings[0].name.trim() && (
<p className="flex items-center gap-1.5 text-xs text-warning">
<AlertTriangle className="h-3 w-3" />
{t("editor.endings.warnings.singleEmpty")}
</p>
)}
</div>
)}
{/* CASE B / C: multi-ending table. */}
{count >= 2 && (
<div className="flex flex-col gap-2">
<div className="overflow-hidden rounded-lg border border-border">
<table className="w-full text-sm">
<thead className="bg-surface-1 text-xs uppercase text-text-muted">
<tr>
<th className="px-2 py-1.5 text-left">#</th>
<th className="w-[100px] px-2 py-1.5 text-left">
{t("editor.endings.numberLabel")}
</th>
<th className="px-2 py-1.5 text-left">{t("editor.endings.nameLabel")}</th>
<th className="px-2 py-1.5 text-left">{t("editor.endings.previewLabel")}</th>
</tr>
</thead>
<tbody>
{endings.map((entry, i) => (
<tr key={i} className="border-t border-border">
<td className="px-2 py-1.5 text-text-muted">{i + 1}</td>
<td className="px-2 py-1.5">
<Input
type="number"
min={1}
max={MAX_ENDINGS}
value={entry.number?.toString() ?? ""}
onChange={(e) => {
const v = e.target.value.trim();
updateEnding(i, { number: v === "" ? null : Number(v) });
}}
/>
</td>
<td className="px-2 py-1.5">
<Input
placeholder={t("editor.endings.namePlaceholder")}
value={entry.name}
onChange={(e) => updateEnding(i, { name: e.target.value })}
/>
</td>
<td className="px-2 py-1.5 font-mono text-xs text-text-muted">
{previewFor(entry)}
</td>
</tr>
))}
</tbody>
</table>
</div>
</div>
)}
{/* Case B: timeline gate banner. */}
{isMultiEnding && !isMultiVideo && timelineEndingCount < count && (
<p className="flex items-start gap-1.5 rounded border border-warning/40 bg-warning/10 p-2 text-xs text-warning">
<AlertTriangle className="mt-0.5 h-3.5 w-3.5 shrink-0" />
<span>
{t("editor.endings.warnings.timelineShort", {
needed: count,
found: timelineEndingCount,
})}
</span>
</p>
)}
{/* CASE C: video-count input + per-video ranges. */}
{isMultiEnding && (
<div className="flex flex-col gap-2 rounded-lg border border-border bg-surface-1 p-3">
<Input
label={t("editor.endings.videoCountLabel")}
type="number"
min={1}
max={count}
value={String(endingVideoCount)}
onChange={(e) => setVideoCount(Number(e.target.value) || 1)}
/>
{isMultiVideo && (
<>
<p className="text-xs text-text-muted">
{t("editor.endings.videoRangeHint")}
</p>
<div className="overflow-hidden rounded border border-border">
<table className="w-full text-sm">
<thead className="bg-surface-2 text-xs uppercase text-text-muted">
<tr>
<th className="px-2 py-1.5 text-left">
{t("editor.endings.videoLabel")}
</th>
<th className="px-2 py-1.5 text-left">From</th>
<th className="px-2 py-1.5 text-left">To</th>
</tr>
</thead>
<tbody>
{endingVideoRanges.map((r, i) => (
<tr key={i} className="border-t border-border">
<td className="px-2 py-1.5">{i + 1}</td>
<td className="px-2 py-1.5">
<Input
type="number"
min={1}
max={count}
value={String(r.from)}
onChange={(e) =>
updateRange(i, { from: Number(e.target.value) || 1 })
}
/>
</td>
<td className="px-2 py-1.5">
<Input
type="number"
min={1}
max={count}
value={String(r.to)}
onChange={(e) =>
updateRange(i, { to: Number(e.target.value) || 1 })
}
/>
</td>
</tr>
))}
</tbody>
</table>
</div>
{rangeWarnings.length > 0 && (
<ul className="flex flex-col gap-1 rounded border border-warning/40 bg-warning/10 p-2 text-xs text-warning">
{rangeWarnings.map((w, i) => (
<li key={i} className="flex items-start gap-1.5">
<AlertTriangle className="mt-0.5 h-3.5 w-3.5 shrink-0" />
<span>{w}</span>
</li>
))}
</ul>
)}
{/* v0.17.1: preview-video selector. Lets the creator
* pick which video's slice the Output renders. Engine
* already respects `endingVideoIndex` for both title +
* description; this just exposes the knob. */}
<Select
label={t("editor.endings.videoIndexLabel")}
options={Array.from({ length: endingVideoCount }, (_, i) => {
const r = endingVideoRanges[i];
const rangeLabel = r ? ` (${r.from}–${r.to})` : "";
return {
value: String(i + 1),
label: `${t("editor.endings.videoLabel")} ${i + 1}${rangeLabel}`,
};
})}
value={String(Math.min(endingVideoIndex, endingVideoCount))}
onChange={(v) => set("endingVideoIndex", Number(v) || 1)}
/>
<p className="text-xs text-text-muted">
{t("editor.endings.videoIndexHint")}
</p>
</>
)}
</div>
)}
</div>
);
}
+128 -2
View File
@@ -2,8 +2,17 @@ import { useTranslation } from "react-i18next";
import { Input } from "@components/ui/Input";
import { Textarea } from "@components/ui/Textarea";
import { VIDEO_TYPES } from "@config/video-types";
import {
GACHA_QUEST_TYPE_GROUPS,
GACHA_QUEST_FIELD_VISIBILITY,
GACHA_QUEST_PLACEHOLDERS,
DEFAULT_GACHA_QUEST_TYPE,
type GachaQuestType,
} from "@config/gacha-quest-types";
import { useEditorStore } from "@store/editor-store";
const ANNIVERSARY_YEARS = Array.from({ length: 20 }, (_, i) => i + 1);
/**
* Renders inputs for the extra fields required by the currently selected
* video type — e.g. "Part Number" for `part`, "Boss Name" for `boss`,
@@ -18,16 +27,133 @@ export function ExtraFieldsInput() {
const extraFields: readonly string[] = currentVideoType?.extraFields ?? [];
if (extraFields.length === 0) return null;
const isGacha = store.videoType === "gacha_quest";
const questType = (store.gachaQuestType ?? DEFAULT_GACHA_QUEST_TYPE) as GachaQuestType;
const visibility = GACHA_QUEST_FIELD_VISIBILITY[questType];
const placeholders = GACHA_QUEST_PLACEHOLDERS[questType];
const placeholderFor = (
field: "chapterName" | "questName" | "partNumber",
): string => {
const key = `editor.placeholders.questType.${questType}.${field}`;
const localised = t(key);
if (localised && localised !== key) return localised;
const fromMap = placeholders[field];
if (fromMap) return fromMap;
return t(`editor.${field}Placeholder`);
};
// For non-gacha video types, the original visibility logic still applies
// — every extraField listed renders. Only gacha-quest gates the trio
// through `GACHA_QUEST_FIELD_VISIBILITY` plus the new char/year/version
// fields.
const showField = (id: "chapterName" | "questName" | "partNumber"): boolean => {
if (!extraFields.includes(id)) return false;
if (!isGacha) return true;
return visibility[id];
};
return (
<div className="flex flex-col gap-3">
{extraFields.includes("partNumber") && (
{extraFields.includes("gachaQuestType") && (
<div className="flex flex-col gap-1">
<label
htmlFor="gacha-quest-type"
className="text-sm font-medium text-text-secondary"
>
{t("editor.gachaQuestType")}
</label>
<select
id="gacha-quest-type"
value={store.gachaQuestType ?? "main_story"}
onChange={(e) =>
store.set("gachaQuestType", e.target.value as GachaQuestType)
}
className="rounded-lg border border-border bg-surface-1 px-3 py-2 text-sm text-text-primary transition-colors focus:border-accent focus:outline-none focus:ring-2 focus:ring-accent/50"
>
{GACHA_QUEST_TYPE_GROUPS.map((g) => (
<optgroup
key={g.group}
label={t(`editor.gachaQuestTypeGroups.${g.group}`)}
>
{g.members.map((m) => (
<option key={m} value={m}>
{t(`editor.gachaQuestTypeOptions.${m}`)}
</option>
))}
</optgroup>
))}
</select>
</div>
)}
{isGacha && visibility.characterName && (
<Input
label={t("editor.characterName")}
placeholder={t("editor.characterNamePlaceholder")}
value={store.characterName ?? ""}
onChange={(e) => store.set("characterName", e.target.value)}
/>
)}
{isGacha && visibility.anniversaryYear && (
<div className="flex flex-col gap-1">
<label
htmlFor="anniversary-year"
className="text-sm font-medium text-text-secondary"
>
{t("editor.anniversaryYear")}
</label>
<select
id="anniversary-year"
value={store.anniversaryYear ?? ""}
onChange={(e) =>
store.set(
"anniversaryYear",
e.target.value === "" ? null : Number(e.target.value),
)
}
className="rounded-lg border border-border bg-surface-1 px-3 py-2 text-sm text-text-primary transition-colors focus:border-accent focus:outline-none focus:ring-2 focus:ring-accent/50"
>
<option value="">—</option>
{ANNIVERSARY_YEARS.map((y) => (
<option key={y} value={y}>
{t("editor.anniversaryYearOption", { count: y })}
</option>
))}
</select>
</div>
)}
{showField("chapterName") && (
<Input
label={t("editor.chapterName")}
placeholder={isGacha ? placeholderFor("chapterName") : t("editor.chapterNamePlaceholder")}
value={store.chapterName ?? ""}
onChange={(e) => store.set("chapterName", e.target.value)}
/>
)}
{showField("questName") && (
<Input
label={t("editor.questName")}
placeholder={isGacha ? placeholderFor("questName") : t("editor.questNamePlaceholder")}
value={store.questName ?? ""}
onChange={(e) => store.set("questName", e.target.value)}
/>
)}
{showField("partNumber") && (
<Input
label={t("editor.partNumber")}
placeholder={t("editor.partNumberPlaceholder")}
placeholder={isGacha ? placeholderFor("partNumber") : t("editor.partNumberPlaceholder")}
value={store.partNumber ?? ""}
onChange={(e) => store.set("partNumber", e.target.value)}
/>
)}
{isGacha && (
<Input
label={t("editor.gachaVersion")}
placeholder={t("editor.gachaVersionPlaceholder")}
value={store.gachaVersion ?? ""}
onChange={(e) => store.set("gachaVersion", e.target.value)}
/>
)}
{extraFields.includes("bossName") && (
<Input
label={t("editor.bossName")}
+19
View File
@@ -22,12 +22,16 @@ export function GameInfoForm() {
placeholder={t("editor.gameNamePlaceholder")}
value={store.gameName}
onChange={(e) => store.set("gameName", e.target.value)}
autoComplete="off"
enterKeyHint="next"
/>
<Input
label={t("editor.channelName")}
placeholder={t("editor.channelNamePlaceholder")}
value={store.channelName}
onChange={(e) => store.set("channelName", e.target.value)}
autoComplete="off"
enterKeyHint="next"
/>
<Select
label={t("editor.platform")}
@@ -35,6 +39,21 @@ export function GameInfoForm() {
value={store.platform}
onChange={(v) => store.set("platform", v)}
/>
{/*
* Dev/publisher name. v0.21.0 promoted this from a side-label
* under the Publisher store link to a first-class field — it now
* drives the optional `© {publisher}` description line (Settings →
* "Show game studio copyright") and persists in GamePresets,
* which is the common case for series where the publisher
* requires credit across many episodes.
*/}
<Input
label={t("editor.pubDevName")}
placeholder={t("editor.pubDevNamePlaceholder")}
value={store.pubDevName ?? ""}
onChange={(e) => store.set("pubDevName", e.target.value)}
autoComplete="off"
/>
</div>
);
}
+70 -14
View File
@@ -1,7 +1,12 @@
import { useState } from "react";
import { useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { ChipGroup } from "@components/ui/ChipGroup";
import { GENRES } from "@config/genres";
import {
GENRES,
GENRE_GROUPS,
GENRE_GROUP_IDS,
type GenreGroupId,
} from "@config/genres";
import { GENRES_WITHOUT_GRAPHICS_SETTINGS } from "@config/graphics-settings";
import { useEditorStore } from "@store/editor-store";
import { MAX_GENRES, type Genre } from "@engine/types";
@@ -16,28 +21,79 @@ export function GenreSelector() {
// creator who flips back-and-forth between visual-novel and other genres
// benefits from being reminded once per session.
const [hintDismissed, setHintDismissed] = useState(false);
const [filter, setFilter] = useState("");
const options = GENRES.map((g) => ({
id: g.id,
label: t(g.labelKey),
icon: g.icon,
}));
const allOptions = useMemo(
() =>
GENRES.map((g) => ({
id: g.id,
label: t(g.labelKey),
icon: g.icon,
})),
[t],
);
const visibleOptions = useMemo(() => {
const trimmed = filter.trim().toLowerCase();
if (!trimmed) return allOptions;
return allOptions.filter((o) => o.label.toLowerCase().includes(trimmed));
}, [allOptions, filter]);
const matchingGenre = genres.find((g) =>
(GENRES_WITHOUT_GRAPHICS_SETTINGS as readonly string[]).includes(g),
);
const showHint = !!matchingGenre && !skipGraphicsSettings && !hintDismissed;
const applyGroup = (groupId: GenreGroupId) => {
const next = GENRE_GROUPS[groupId].slice(0, MAX_GENRES) as Genre[];
set("genres", next);
// Clear the filter so the user can see the newly-selected chips
// light up — otherwise a stale filter could hide them all.
setFilter("");
};
return (
<div className="flex flex-col gap-2">
<ChipGroup
label={t("editor.genre")}
multiple
max={MAX_GENRES}
options={options}
value={genres}
onChange={(next) => set("genres", next as Genre[])}
<div className="flex flex-wrap items-center justify-between gap-2">
<span className="text-sm font-medium text-text-secondary">
{t("editor.genre")}
</span>
<span className="text-xs text-text-muted">
{genres.length}/{MAX_GENRES}
</span>
</div>
<div className="flex flex-wrap gap-2">
{GENRE_GROUP_IDS.map((groupId) => (
<button
key={groupId}
type="button"
onClick={() => applyGroup(groupId)}
className="rounded-lg border border-border bg-surface-1 px-2.5 py-1 text-xs font-medium text-text-secondary transition-colors hover:border-accent hover:text-text-primary"
>
{t(`editor.genreGroups.${groupId}`)}
</button>
))}
</div>
<input
type="text"
value={filter}
onChange={(e) => setFilter(e.target.value)}
placeholder={t("editor.genreSearchPlaceholder")}
className="rounded-lg border border-border bg-surface-1 px-3 py-2 text-sm text-text-primary placeholder:text-text-muted transition-colors focus:border-accent focus:outline-none focus:ring-2 focus:ring-accent/50"
/>
{visibleOptions.length === 0 ? (
<p className="py-2 text-sm text-text-muted">
{t("editor.genreSearchNoResults")}
</p>
) : (
<ChipGroup
multiple
max={MAX_GENRES}
options={visibleOptions}
value={genres}
onChange={(next) => set("genres", next as Genre[])}
/>
)}
{showHint && (
<div className="flex items-center justify-between gap-3 rounded-lg border border-accent/40 bg-accent/5 px-3 py-2 text-xs text-text-secondary">
<span>{t("editor.skipGraphicsHintLabel")}</span>
@@ -0,0 +1,130 @@
import { useTranslation } from "react-i18next";
import { Select } from "@components/ui/Select";
import { Input } from "@components/ui/Input";
import { useEditorStore } from "@store/editor-store";
import { EndingsEditor } from "./EndingsEditor";
import {
PLAYTHROUGH_STATUSES,
DIFFICULTY_LEVELS,
type PlaythroughStatus,
type DifficultyLevel,
type LanguagePatch,
type GameVersion,
} from "@engine/types";
import {
LANGUAGE_PATCH_UI_OPTIONS,
GAME_VERSION_UI_OPTIONS,
languagePatchHasCustomSlot,
gameVersionHasCustomSlot,
} from "@config/playthrough-options";
/**
* v0.12 unified Playthrough Notes form. Replaces the v0.7
* `ContentDetailsForm` (deleted in v0.12 — it only carried Playthrough
* + Difficulty) with a 5-field block that maps 1:1 to the bullets of
* the `▸ 🎮 PLAYTHROUGH NOTES` description section:
*
* • Run type ← `playthroughStatus` (existing)
* • Difficulty ← `difficulty` (+ custom label, existing)
* • Endings shown ← `endingsShown` (NEW free text)
* • Language patch ← `languagePatch` (+ custom label, NEW)
* • Game version ← `gameVersion` (+ custom label, NEW)
*
* Custom-text inputs only appear when their parent enum is set to a
* custom-bearing value (`difficulty === "custom"`, language patch is
* `"official_other"` or `"custom"`, etc.) — keeps the form compact in
* the common path and surfaces the slot exactly when it's needed.
*/
export function PlaythroughNotesForm() {
const { t } = useTranslation("ui");
const store = useEditorStore();
const playthroughOptions = PLAYTHROUGH_STATUSES.map((id) => ({
value: id,
label: t(`editor.playthroughOptions.${id}`),
}));
const difficultyOptions = DIFFICULTY_LEVELS.map((id) => ({
value: id,
label: t(`editor.difficultyOptions.${id}`),
}));
const languagePatchOptions = LANGUAGE_PATCH_UI_OPTIONS.map((opt) => ({
value: opt.id,
label: t(opt.labelKey),
}));
const gameVersionOptions = GAME_VERSION_UI_OPTIONS.map((opt) => ({
value: opt.id,
label: t(opt.labelKey),
}));
return (
<div className="flex flex-col gap-3">
<div className="flex items-baseline justify-between">
<span className="text-sm font-medium text-text-secondary">
{t("editor.playthroughNotes.title")}
</span>
</div>
<Select
label={t("editor.playthroughNotes.runTypeLabel")}
options={playthroughOptions}
value={store.playthroughStatus}
onChange={(v) => store.set("playthroughStatus", v as PlaythroughStatus)}
/>
<Select
label={t("editor.playthroughNotes.difficultyLabel")}
options={difficultyOptions}
value={store.difficulty}
onChange={(v) => store.set("difficulty", v as DifficultyLevel)}
/>
{store.difficulty === "custom" && (
<Input
label={t("editor.difficultyCustomLabel")}
placeholder={t("editor.difficultyCustomPlaceholder")}
value={store.difficultyCustomLabel}
onChange={(e) => store.set("difficultyCustomLabel", e.target.value)}
/>
)}
{/* v0.16.0: free-form `endingsShown` Input replaced by the
* structured EndingsEditor — number + name pairs, optional
* multi-video split with auto-contiguous range, timeline
* cross-validation. Legacy persisted string is migrated to a
* single-row entry by editor-store v11→12 migrate. */}
<EndingsEditor />
<Select
label={t("editor.playthroughNotes.languagePatchLabel")}
options={languagePatchOptions}
value={store.languagePatch}
onChange={(v) => store.set("languagePatch", v as LanguagePatch)}
/>
{languagePatchHasCustomSlot(store.languagePatch) && (
<Input
label={t("editor.playthroughNotes.languagePatchCustomLabel")}
placeholder={t("editor.playthroughNotes.languagePatchCustomPlaceholder")}
value={store.languagePatchCustom}
onChange={(e) => store.set("languagePatchCustom", e.target.value)}
/>
)}
<Select
label={t("editor.playthroughNotes.gameVersionLabel")}
options={gameVersionOptions}
value={store.gameVersion}
onChange={(v) => store.set("gameVersion", v as GameVersion)}
/>
{gameVersionHasCustomSlot(store.gameVersion) && (
<Input
label={t("editor.playthroughNotes.gameVersionCustomLabel")}
placeholder={t("editor.playthroughNotes.gameVersionCustomPlaceholder")}
value={store.gameVersionCustom}
onChange={(e) => store.set("gameVersionCustom", e.target.value)}
/>
)}
</div>
);
}
+265 -30
View File
@@ -1,48 +1,283 @@
import { useTranslation } from "react-i18next";
import { AlertTriangle } from "lucide-react";
import { Input } from "@components/ui/Input";
import { Select } from "@components/ui/Select";
import { RIG_FIELDS } from "@config/rig-fields";
import {
RIG_FIELDS,
parseCascadingValue,
parseCompositeValue,
resolveCompositeOptions,
resolveCompositeLabelKey,
type RigField,
type CompositePart,
} from "@config/rig-fields";
import { GPU_CUSTOM_BRAND_ID, findGpuBrand } from "@config/gpu-catalog";
import { useEditorStore } from "@store/editor-store";
import {
validateGpuValue,
validateCompositeField,
type RigValidationIssue,
} from "@utils/rig-validation";
const CUSTOM_PREFIX = "custom:";
function joinCascading(brand: string, series: string, model: string): string {
if (!brand && !series && !model) return "";
return `${brand}|${series}|${model}`;
}
function joinComposite(parts: readonly string[]): string {
if (parts.every((p) => !p)) return "";
return parts.join("|");
}
export function RigEditor() {
const { t } = useTranslation("ui");
const rig = useEditorStore((s) => s.rig);
const setNested = useEditorStore((s) => s.setNested);
const renderValidationBadge = (issue: RigValidationIssue | null) => {
if (!issue) return null;
return (
<div className="flex items-center gap-1 text-xs text-warning">
<AlertTriangle className="h-3 w-3" />
<span>{t(issue.messageKey)}</span>
</div>
);
};
const renderCascading = (field: RigField) => {
const raw = rig[field.id] ?? "";
const { brand, series, model } = parseCascadingValue(raw);
const isCustom = brand === GPU_CUSTOM_BRAND_ID;
const issue = validateGpuValue(raw);
const catalog = field.catalog ?? [];
const brandOptions = [
{ value: "", label: "—" },
...catalog.map((b) => ({ value: b.id, label: b.label })),
];
const currentBrand = findGpuBrand(brand);
const seriesOptions = currentBrand
? [
{ value: "", label: "—" },
...currentBrand.series.map((s) => ({ value: s.id, label: s.label })),
]
: [{ value: "", label: "—" }];
const currentSeries = currentBrand?.series.find((s) => s.id === series);
const modelOptions = currentSeries
? [
{ value: "", label: "—" },
...currentSeries.models.map((m) => ({ value: m, label: m })),
]
: [{ value: "", label: "—" }];
const setBrand = (next: string) => {
// Switching brand resets series + model so the user can't end up
// with mismatched cascading values (NVIDIA brand + AMD series).
setNested("rig", field.id, next ? joinCascading(next, "", "") : "");
};
const setSeries = (next: string) => {
setNested("rig", field.id, joinCascading(brand, next, ""));
};
const setModel = (next: string) => {
setNested("rig", field.id, joinCascading(brand, series, next));
};
const setCustomText = (text: string) => {
setNested(
"rig",
field.id,
text ? joinCascading(GPU_CUSTOM_BRAND_ID, "", text) : "",
);
};
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-3 gap-2">
<Select
label={t("editor.gpu_brand")}
value={brand}
options={brandOptions}
onChange={setBrand}
/>
{isCustom ? (
<div className="col-span-2">
<Input
label={t("editor.gpu_custom")}
placeholder="e.g. RTX 4090 (custom OC)"
value={model}
onChange={(e) => setCustomText(e.target.value)}
/>
</div>
) : (
<>
<Select
label={t("editor.gpu_series")}
value={series}
options={seriesOptions}
onChange={setSeries}
disabled={!brand}
/>
<Select
label={t("editor.gpu_model")}
value={model}
options={modelOptions}
onChange={setModel}
disabled={!series}
/>
</>
)}
</div>
{renderValidationBadge(issue)}
</div>
);
};
const renderComposite = (field: RigField) => {
if (!field.composite) return null;
const raw = rig[field.id] ?? "";
const { parts: storedParts } = parseCompositeValue(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));
};
// 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) {
setPart(index, `${CUSTOM_PREFIX}`);
} else {
setPart(index, next);
}
};
const onCustomChange = (next: string) => {
setPart(index, `${CUSTOM_PREFIX}${next}`);
};
return (
<div key={part.id} className="flex flex-col gap-1">
<Select
label={t(labelKey)}
value={selectValue}
options={options}
onChange={onSelectChange}
/>
{isCustom && part.allowCustom && (
<div className="flex items-center gap-2">
<Input
placeholder={part.customPlaceholder}
value={customText}
inputMode="numeric"
onChange={(e) => onCustomChange(e.target.value)}
/>
{part.customSuffix && (
<span className="text-sm text-text-muted">{part.customSuffix.trim()}</span>
)}
</div>
)}
</div>
);
}
};
const renderDropdownWithVersion = (field: RigField) => {
const raw = rig[field.id] ?? "";
const [value = "", version = ""] = raw.split("|");
const commit = (nextValue: string, nextVersion: string) => {
// Keep the stored form compact: drop the pipe when empty.
const next =
!nextValue && !nextVersion ? "" : `${nextValue}|${nextVersion}`;
setNested("rig", field.id, next);
};
return (
<div key={field.id} className="col-span-2 grid grid-cols-[1fr_auto] gap-2">
<Select
label={t(field.labelKey)}
value={value}
options={field.options ?? []}
onChange={(v) => commit(v, version)}
/>
<Input
label={t("editor.version")}
placeholder={field.versionPlaceholder}
value={version}
onChange={(e) => commit(value, e.target.value)}
/>
</div>
);
};
return (
<div className="flex flex-col gap-3">
<span className="text-sm font-medium text-text-secondary">{t("editor.rig")}</span>
<div className="grid grid-cols-2 gap-2">
{RIG_FIELDS.map((field) => {
if (field.type === "dropdown_with_version") {
const raw = rig[field.id] ?? "";
const [value = "", version = ""] = raw.split("|");
const commit = (nextValue: string, nextVersion: string) => {
// Keep the stored form compact: drop the pipe when empty.
const next =
!nextValue && !nextVersion ? "" : `${nextValue}|${nextVersion}`;
setNested("rig", field.id, next);
};
return (
<div key={field.id} className="col-span-2 grid grid-cols-[1fr_auto] gap-2">
<Select
label={t(field.labelKey)}
value={value}
options={field.options ?? []}
onChange={(v) => commit(v, version)}
/>
<Input
label={t("editor.version")}
placeholder={field.versionPlaceholder}
value={version}
onChange={(e) => commit(value, e.target.value)}
/>
</div>
);
}
if (field.type === "cascading_dropdown") return renderCascading(field);
if (field.type === "composite_dropdown") return renderComposite(field);
if (field.type === "dropdown_with_version") return renderDropdownWithVersion(field);
return (
<Input
key={field.id}
+73 -2
View File
@@ -1,3 +1,4 @@
import { useMemo, useState } from "react";
import type { ClipboardEvent } from "react";
import { useTranslation } from "react-i18next";
import toast from "react-hot-toast";
@@ -6,11 +7,20 @@ import { Select } from "@components/ui/Select";
import { PLATFORMS } from "@config/platforms";
import { useEditorStore } from "@store/editor-store";
import { validateUrlWithPattern } from "@utils/validation";
import { extractGameNameFromUrl } from "@utils/url-extractors";
import {
extractGameNameFromUrl,
isLinkNameMismatch,
} from "@utils/url-extractors";
import type { StoreLinkType } from "@engine/types";
const STORE_LINK_TYPE_VALUES: readonly StoreLinkType[] = ["paid", "free", "demo"];
interface MismatchInfo {
host: string;
suggestedName: string;
fingerprint: string;
}
export function StoreLinkEditor() {
const { t } = useTranslation("ui");
const storeLinks = useEditorStore((s) => s.storeLinks);
@@ -20,11 +30,41 @@ export function StoreLinkEditor() {
const setNested = useEditorStore((s) => s.setNested);
const setStoreLinkType = useEditorStore((s) => s.setStoreLinkType);
const [dismissedFingerprints, setDismissedFingerprints] = useState<
ReadonlySet<string>
>(new Set());
const typeOptions = STORE_LINK_TYPE_VALUES.map((value) => ({
value,
label: t(`storeLinkTypes.${value}`),
}));
// Find the first store link whose extracted name doesn't fit the
// typed Game Name (subset-tolerant check). Iteration order is
// PLATFORMS order. Dismissed fingerprints are skipped so a chain of
// mismatches surfaces one at a time.
const mismatch = useMemo<MismatchInfo | null>(() => {
const trimmed = gameName.trim();
if (!trimmed) return null;
for (const platform of PLATFORMS) {
const url = (storeLinks[platform.id] ?? "").trim();
if (!url) continue;
if (!isLinkNameMismatch(trimmed, url)) continue;
const suggestedName = extractGameNameFromUrl(url);
if (!suggestedName) continue;
const fingerprint = `${trimmed}|${url}`;
if (dismissedFingerprints.has(fingerprint)) continue;
let host: string;
try {
host = new URL(url).host;
} catch {
continue;
}
return { host, suggestedName, fingerprint };
}
return null;
}, [gameName, storeLinks, dismissedFingerprints]);
// When a recognised store URL is pasted into any link input AND the
// Game Name field is still empty, auto-fill it from the URL slug. The
// toast carries an Undo action so a wrong guess is one click away from
@@ -60,9 +100,40 @@ export function StoreLinkEditor() {
return (
<div className="flex flex-col gap-3">
<span className="text-sm font-medium text-text-secondary">{t("editor.storeLinks")}</span>
{mismatch && (
<div className="flex items-start gap-2 rounded-lg border border-warning bg-surface-2 px-3 py-2 text-sm">
<span className="flex-1 text-text-primary">
{t("editor.warning.linkNameMismatch", {
host: mismatch.host,
suggestedName: mismatch.suggestedName,
gameName: gameName.trim(),
})}
</span>
<button
type="button"
aria-label={t("common.dismiss")}
className="shrink-0 rounded px-2 py-0.5 text-base leading-none text-text-secondary hover:bg-surface-1"
onClick={() =>
setDismissedFingerprints((prev) => {
const next = new Set(prev);
next.add(mismatch.fingerprint);
return next;
})
}
>
×
</button>
</div>
)}
<div className="flex flex-col gap-2">
{PLATFORMS.map((platform) => {
const currentType = storeLinkTypes[platform.id] ?? "paid";
const url = storeLinks[platform.id] ?? "";
// v0.21.0: the inline `pubDevName` input that previously
// appeared under the Publisher store link has been promoted
// to a first-class field in `GameInfoForm`, so it can drive
// the optional game-copyright description line independently
// of whether the publisher URL is filled.
return (
<div
key={platform.id}
@@ -71,7 +142,7 @@ export function StoreLinkEditor() {
<ValidatedInput
label={platform.label}
placeholder={platform.urlPrefix}
value={storeLinks[platform.id] ?? ""}
value={url}
onChange={(v) => {
const final = v && platform.normalize ? platform.normalize(v) : v;
setNested("storeLinks", platform.id, final);
@@ -0,0 +1,173 @@
import { useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { ChevronDown, ChevronRight, Search, X } from "lucide-react";
import clsx from "clsx";
import { useEditorStore } from "@store/editor-store";
import {
TECH_NOTE_GROUPS,
type TechNoteGroup,
} from "@config/tech-note-groups";
import type { TechNote } from "@engine/types";
/**
* v0.12 Tech Notes checklist — searchable, collapsible, grouped
* multi-select for the 24 production / playstyle disclaimers that feed
* the `▸ 🛠 TECH NOTES` description block. Cloned 1:1 from
* {@link ContentWarningChecklist} since both share the same UX shape;
* only the data source (`techNotes` vs `contentWarnings`), groups,
* and i18n namespace differ.
*
* Selection order is preserved so the description renders bullets in
* the order the user picked them.
*/
export function TechNotesChecklist() {
const { t } = useTranslation("ui");
const selected = useEditorStore((s) => s.techNotes);
const set = useEditorStore((s) => s.set);
const [query, setQuery] = useState("");
// Default all groups closed — 24 items across 5 groups is too tall to
// expand by default. Users with a specific note in mind use search;
// users browsing pop open the group they care about.
const [openGroups, setOpenGroups] = useState<Record<string, boolean>>(() => ({
audio: false,
video_quality: false,
recording_issues: false,
playstyle: false,
production: false,
}));
const trimmedQuery = query.trim().toLowerCase();
const isFiltering = trimmedQuery.length > 0;
const filteredGroups = useMemo<TechNoteGroup[]>(() => {
if (!isFiltering) return [...TECH_NOTE_GROUPS];
return TECH_NOTE_GROUPS.map((group) => ({
...group,
items: group.items.filter((id) =>
t(`editor.techNoteOptions.${id}`).toLowerCase().includes(trimmedQuery),
),
})).filter((group) => group.items.length > 0);
}, [t, trimmedQuery, isFiltering]);
const totalMatching = filteredGroups.reduce((acc, g) => acc + g.items.length, 0);
function toggleItem(id: TechNote) {
if (selected.includes(id)) {
set(
"techNotes",
selected.filter((x) => x !== id),
);
} else {
set("techNotes", [...selected, id]);
}
}
function toggleGroup(groupId: string) {
setOpenGroups((prev) => ({ ...prev, [groupId]: !prev[groupId] }));
}
return (
<div className="flex flex-col gap-2">
<div className="flex items-baseline justify-between">
<span className="text-sm font-medium text-text-secondary">
{t("editor.techNotes")}
</span>
{selected.length > 0 && (
<span className="text-xs text-text-muted">
{selected.length} selected
</span>
)}
</div>
<div className="relative">
<Search className="pointer-events-none absolute left-2.5 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-text-muted" />
<input
type="text"
value={query}
onChange={(e) => setQuery(e.target.value)}
placeholder={t("editor.techNoteSearchPlaceholder")}
className="w-full rounded-md border border-border bg-surface-1 py-1.5 pl-8 pr-7 text-sm text-text-primary placeholder:text-text-muted focus:border-accent focus:outline-none"
/>
{query && (
<button
type="button"
onClick={() => setQuery("")}
className="absolute right-2 top-1/2 -translate-y-1/2 text-text-muted hover:text-text-primary"
aria-label="Clear search"
>
<X className="h-3.5 w-3.5" />
</button>
)}
</div>
{isFiltering && totalMatching === 0 ? (
<p className="py-2 text-center text-xs text-text-muted">
{t("editor.techNoteEmpty")}
</p>
) : (
<div className="flex flex-col gap-1">
{filteredGroups.map((group) => {
const isOpen = isFiltering || openGroups[group.id];
const groupSelectedCount = group.items.filter((id) =>
selected.includes(id),
).length;
return (
<div
key={group.id}
className="overflow-hidden rounded-md border border-border bg-surface-1"
>
<button
type="button"
onClick={() => toggleGroup(group.id)}
className="flex w-full items-center justify-between px-3 py-2 text-left text-xs font-medium text-text-secondary hover:bg-surface-2"
aria-expanded={isOpen}
>
<span className="flex items-center gap-1.5">
{isOpen ? (
<ChevronDown className="h-3.5 w-3.5" />
) : (
<ChevronRight className="h-3.5 w-3.5" />
)}
{t(group.labelKey)}
</span>
{groupSelectedCount > 0 && (
<span className="rounded-full bg-accent/15 px-2 py-0.5 text-[10px] font-medium text-accent">
{groupSelectedCount}
</span>
)}
</button>
{isOpen && (
<div className="grid grid-cols-1 gap-x-3 gap-y-1 border-t border-border bg-surface-1 px-3 py-2 sm:grid-cols-2">
{group.items.map((id) => {
const checked = selected.includes(id);
return (
<label
key={id}
className={clsx(
"flex cursor-pointer items-center gap-2 rounded px-1.5 py-1 text-xs transition-colors",
checked
? "text-text-primary"
: "text-text-secondary hover:text-text-primary",
)}
>
<input
type="checkbox"
checked={checked}
onChange={() => toggleItem(id)}
className="h-3.5 w-3.5 shrink-0 cursor-pointer rounded border-border text-accent focus:ring-1 focus:ring-accent/40"
/>
<span>{t(`editor.techNoteOptions.${id}`)}</span>
</label>
);
})}
</div>
)}
</div>
);
})}
</div>
)}
</div>
);
}
+57 -7
View File
@@ -8,8 +8,6 @@ import {
GRAPHICS_PRESETS,
RT_MODES,
FRAMEGEN_VENDORS,
FRAMEGEN_MULTIPLIERS,
UPSCALE_QUALITIES,
ART_STYLES,
type GraphicsPreset,
type RTMode,
@@ -18,6 +16,13 @@ import {
type UpscaleQuality,
type ArtStyle,
} from "@config/graphics-settings";
import {
getValidUpscaleQualities,
getValidFrameGenMultipliers,
coerceUpscaleQuality,
coerceFrameGenMultiplier,
} from "@engine/graphics-vendor";
import { VIDEO_STYLE_ERA_IDS, type VideoStyleEra } from "@config/video-styles";
const RESOLUTION_OPTIONS = [
{ value: "720p", label: "720p" },
@@ -52,16 +57,53 @@ export function VideoSettingsForm() {
label: t(`editor.frameGenVendorOptions.${v}`),
}));
const multiplierOptions = FRAMEGEN_MULTIPLIERS.map((m) => ({
// v0.22.0 — video-style era opt-in. Renders independently of
// `skipGraphicsSettings`, so we wire it above the toggle: 2D / pixel-art
// creators still edit their footage and may want the style credit even
// when the in-game graphics block is suppressed.
const videoStyleOptions = [
{ value: "", label: t("editor.videoStyleOff") },
...VIDEO_STYLE_ERA_IDS.map((id) => ({
value: id,
label: t(`editor.videoStyleOptions.${id}`),
})),
];
// v0.11: vendor-filtered option lists. NVIDIA exposes DLAA + 4 quality
// tiers, AMD exposes FSR Native AA + 4, Intel exposes XeSS Native AA +
// Ultra Quality + 4. None falls back to the vendor-agnostic ladder so
// pre-v0.11 drafts keep their settings on rehydrate. Labels live in
// vendor-keyed `editor.upscaleQuality.{vendor}.{id}` /
// `editor.frameGenMultiplier.{vendor}.{id}` namespaces; vendor=none
// uses the legacy flat `Options` keys.
const multiplierOptions = getValidFrameGenMultipliers(store.frameGenVendor).map((m) => ({
value: m,
label: t(`editor.frameGenMultiplierOptions.${m}`),
label:
store.frameGenVendor === "none"
? t(`editor.frameGenMultiplierOptions.${m}`)
: t(`editor.frameGenMultiplier.${store.frameGenVendor}.${m}`),
}));
const upscaleOptions = UPSCALE_QUALITIES.map((q) => ({
const upscaleOptions = getValidUpscaleQualities(store.frameGenVendor).map((q) => ({
value: q,
label: t(`editor.upscaleQualityOptions.${q}`),
label:
store.frameGenVendor === "none"
? t(`editor.upscaleQualityOptions.${q}`)
: t(`editor.upscaleQuality.${store.frameGenVendor}.${q}`),
}));
// When the vendor changes, the previously-selected upscale quality /
// frame-gen multiplier may no longer be in the new dropdown's options
// (e.g. switching DLSS→FSR drops `dlaa`). Coerce to "none" so the
// Select doesn't render with a stale, no-longer-rendered value.
function handleVendorChange(next: FrameGenVendor) {
store.set("frameGenVendor", next);
const coercedQ = coerceUpscaleQuality(next, store.upscaleQuality);
if (coercedQ !== store.upscaleQuality) store.set("upscaleQuality", coercedQ);
const coercedM = coerceFrameGenMultiplier(next, store.frameGenMultiplier);
if (coercedM !== store.frameGenMultiplier) store.set("frameGenMultiplier", coercedM);
}
const artStyleOptions = ART_STYLES.map((s) => ({
value: s,
label: t(`editor.artStyleOptions.${s}`),
@@ -101,6 +143,14 @@ export function VideoSettingsForm() {
/>
)}
<Select
label={t("editor.videoStyle")}
options={videoStyleOptions}
value={store.videoStyleEra}
onChange={(v) => store.set("videoStyleEra", v as VideoStyleEra)}
/>
<p className="-mt-1 text-xs text-text-muted">{t("editor.videoStyleHelp")}</p>
<Toggle
label={t("editor.skipGraphicsSettings")}
checked={store.skipGraphicsSettings}
@@ -123,7 +173,7 @@ export function VideoSettingsForm() {
label={t("editor.frameGenVendor")}
options={vendorOptions}
value={store.frameGenVendor}
onChange={(v) => store.set("frameGenVendor", v as FrameGenVendor)}
onChange={(v) => handleVendorChange(v as FrameGenVendor)}
/>
<Select
label={t("editor.frameGenMultiplier")}
@@ -1,6 +1,13 @@
import { useState } from "react";
import { useTranslation } from "react-i18next";
import { Input } from "@components/ui/Input";
import { Select } from "@components/ui/Select";
import { useEditorStore } from "@store/editor-store";
import {
VIETNAMESE_BANKS,
VIETNAMESE_BANK_OTHER,
isCustomVietnameseBank,
} from "@config/vietnamese-banks";
/**
* Vietnam-specific donate fields — bank transfer + e-wallets. The
@@ -13,10 +20,45 @@ import { useEditorStore } from "@store/editor-store";
* output language — we don't want creators to have to flip language
* just to fill in their bank info, and the data is preserved in the
* draft either way.
*
* v0.18.0: when the output language is Vietnamese, the bank-name field
* upgrades to a dropdown sourced from
* {@link VIETNAMESE_BANKS}. Picking "Khác" (Other) reveals an inline
* text input so the field still accepts unlisted / digital-only / less
* common banks. The persisted shape is unchanged — `vnBankName` is
* still a `string` — so saved profiles and exports keep round-tripping.
*/
export function VietnameseDonateEditor() {
const { t } = useTranslation("ui");
const store = useEditorStore();
const language = useEditorStore((s) => s.language);
const vnBankName = useEditorStore((s) => s.vnBankName);
const isVi = language === "vi";
// Sticky flag for the "user explicitly chose Other from the dropdown"
// case. We can't derive it purely from `vnBankName` because the user
// might pick "Other" with the field still empty — at that point the
// value is `""`, which the auto-detector would treat as "use the
// dropdown placeholder". The initial value still uses the auto-detect
// (any non-preset saved name lights up custom mode on mount), so a
// reload of e.g. "Citibank Vietnam" renders correctly without the
// sticky flag needing to be hydrated.
const [otherSticky, setOtherSticky] = useState(
() => isVi && isCustomVietnameseBank(vnBankName ?? ""),
);
const customMode =
isVi && (otherSticky || isCustomVietnameseBank(vnBankName ?? ""));
const selectValue = customMode
? VIETNAMESE_BANK_OTHER
: (vnBankName ?? "");
const bankOptions = [
{ value: "", label: t("editor.vnBankNameSelectPlaceholder") },
...VIETNAMESE_BANKS.map((b) => ({ value: b, label: b })),
{ value: VIETNAMESE_BANK_OTHER, label: t("editor.vnBankNameOther") },
];
return (
<div className="flex flex-col gap-3">
@@ -28,12 +70,39 @@ export function VietnameseDonateEditor() {
</div>
<div className="grid grid-cols-2 gap-3">
<Input
label={t("editor.vnBankName")}
placeholder={t("editor.vnBankNamePlaceholder")}
value={store.vnBankName ?? ""}
onChange={(e) => store.set("vnBankName", e.target.value)}
/>
{isVi ? (
<div className="flex flex-col gap-2">
<Select
label={t("editor.vnBankName")}
options={bankOptions}
value={selectValue}
onChange={(v) => {
if (v === VIETNAMESE_BANK_OTHER) {
// Keep any value the creator already had — pre-existing
// free-form names should survive a Khác re-selection.
setOtherSticky(true);
} else {
setOtherSticky(false);
store.set("vnBankName", v);
}
}}
/>
{customMode && (
<Input
placeholder={t("editor.vnBankNamePlaceholder")}
value={vnBankName ?? ""}
onChange={(e) => store.set("vnBankName", e.target.value)}
/>
)}
</div>
) : (
<Input
label={t("editor.vnBankName")}
placeholder={t("editor.vnBankNamePlaceholder")}
value={vnBankName ?? ""}
onChange={(e) => store.set("vnBankName", e.target.value)}
/>
)}
<Input
label={t("editor.vnBankAccount")}
placeholder={t("editor.vnBankAccountPlaceholder")}
-26
View File
@@ -1,26 +0,0 @@
import { useTranslation } from "react-i18next";
import { Toggle } from "@components/ui/Toggle";
import { useEditorStore } from "@store/editor-store";
export function WarningToggles() {
const { t } = useTranslation("ui");
const spoilerWarning = useEditorStore((s) => s.spoilerWarning);
const matureWarning = useEditorStore((s) => s.matureWarning);
const set = useEditorStore((s) => s.set);
return (
<div className="flex flex-col gap-3">
<span className="text-sm font-medium text-text-secondary">{t("editor.warnings")}</span>
<Toggle
label={t("editor.spoilerWarning")}
checked={spoilerWarning}
onChange={(v) => set("spoilerWarning", v)}
/>
<Toggle
label={t("editor.matureWarning")}
checked={matureWarning}
onChange={(v) => set("matureWarning", v)}
/>
</div>
);
}
+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>
);
}
+27 -8
View File
@@ -1,27 +1,46 @@
import { useState } from "react";
import { useRef, useState } from "react";
import { Outlet } from "react-router-dom";
import { Header } from "./Header";
import { TabBar } from "./TabBar";
import { Sidebar, SidebarNavList } from "./Sidebar";
import { ScrollToTopButton } from "./ScrollToTopButton";
import { Drawer } from "@components/ui/Drawer";
import { ShortcutHelpModal } from "@components/ui/ShortcutHelpModal";
import { useKeyboardShortcuts } from "@hooks/use-keyboard-shortcuts";
import { useGlobalErrorHandler } from "@hooks/use-global-error-handler";
import { useSettingsStore } from "@store/settings-store";
export function AppShell() {
const [showShortcuts, setShowShortcuts] = useState(false);
const [mobileNavOpen, setMobileNavOpen] = useState(false);
const mainRef = useRef<HTMLElement>(null);
const setSetting = useSettingsStore((s) => s.setSetting);
const collapsed = useSettingsStore((s) => s.sidebarCollapsed);
useKeyboardShortcuts({
onToggleHelp: () => setShowShortcuts((v) => !v),
onToggleSidebar: () => setSetting("sidebarCollapsed", !collapsed),
});
useGlobalErrorHandler();
return (
<div className="flex min-h-screen flex-col bg-surface-0">
<Header />
<TabBar />
<main className="flex-1 overflow-y-auto">
<Outlet />
</main>
<div className="flex h-screen overflow-hidden bg-surface-0">
<Sidebar />
<div className="flex min-w-0 flex-1 flex-col">
<Header onOpenMobileNav={() => setMobileNavOpen(true)} />
<main ref={mainRef} className="min-h-0 flex-1 overflow-y-auto">
<Outlet />
</main>
</div>
<Drawer
open={mobileNavOpen}
onClose={() => setMobileNavOpen(false)}
side="left"
ariaLabel="Navigation"
>
<SidebarNavList collapsed={false} onItemClick={() => setMobileNavOpen(false)} />
</Drawer>
<ShortcutHelpModal open={showShortcuts} onClose={() => setShowShortcuts(false)} />
<ScrollToTopButton scrollRef={mainRef} />
</div>
);
}
+84 -33
View File
@@ -1,14 +1,19 @@
import { useState, useRef, useEffect } from "react";
import { useTranslation } from "react-i18next";
import { ChevronDown } 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";
import type { SupportedLanguage } from "@engine/types";
import clsx from "clsx";
export function Header() {
interface HeaderProps {
onOpenMobileNav?: () => void;
}
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);
@@ -32,37 +37,83 @@ export function Header() {
};
return (
<header className="flex items-center justify-between border-b border-border bg-surface-1 px-6 py-3">
<div>
<h1 className="text-lg font-bold text-text-primary">{t("app.title")}</h1>
<p className="text-xs text-text-muted">{t("app.subtitle")}</p>
</div>
<div className="relative" ref={dropdownRef}>
<button
onClick={() => setOpen(!open)}
className="flex items-center gap-1.5 rounded-lg px-3 py-1.5 text-sm transition-colors hover:bg-surface-2"
>
<span>{current?.flag}</span>
<span className="text-text-primary">{current?.nativeName}</span>
<ChevronDown className="h-3.5 w-3.5 text-text-muted" />
</button>
{open && (
<div className="absolute right-0 top-full z-50 mt-1 min-w-44 rounded-lg border border-border bg-surface-1 py-1 shadow-xl">
{SUPPORTED_LANGUAGES.map((lang) => (
<button
key={lang.id}
onClick={() => handleSwitch(lang.id as SupportedLanguage)}
className={clsx(
"flex w-full items-center gap-2 px-3 py-2 text-sm transition-colors hover:bg-surface-2",
lang.id === appLanguage ? "bg-accent-muted text-accent" : "text-text-primary",
)}
>
<span>{lang.flag}</span>
<span>{lang.nativeName}</span>
</button>
))}
</div>
<header
className="flex items-center justify-between gap-2 border-b border-border bg-surface-1 px-3 py-3 pt-[max(0.75rem,env(safe-area-inset-top))] sm:px-6"
>
<div className="flex min-w-0 items-center gap-2">
{onOpenMobileNav && (
<button
type="button"
onClick={onOpenMobileNav}
aria-label="Open navigation menu"
className="-ml-1 rounded-lg p-2 text-text-secondary transition-colors hover:bg-surface-2 hover:text-text-primary md:hidden"
>
<Menu className="h-5 w-5" />
</button>
)}
<div className="min-w-0">
<h1 className="truncate text-base font-bold text-text-primary sm:text-lg">
{t("app.title")}
</h1>
<p className="hidden truncate text-xs text-text-muted sm:block">
{t("app.subtitle")}
</p>
</div>
</div>
<div className="flex shrink-0 items-center gap-2">
<a
href={PRIMARY_DONATE_URL}
target="_blank"
rel="noopener noreferrer"
className="flex items-center gap-1.5 rounded-lg border border-pink-500/30 bg-pink-500/10 px-2.5 py-1.5 text-sm text-pink-300 transition-colors hover:border-pink-400/60 hover:bg-pink-500/20 hover:text-pink-200 sm:px-3"
title={t("header.donate")}
aria-label={t("header.donate")}
>
<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)}
className="flex items-center gap-1.5 rounded-lg px-2.5 py-1.5 text-sm transition-colors hover:bg-surface-2 sm:px-3"
aria-haspopup="listbox"
aria-expanded={open}
>
<span>{current?.flag}</span>
<span className="hidden text-text-primary sm:inline">{current?.nativeName}</span>
<ChevronDown className="h-3.5 w-3.5 text-text-muted" />
</button>
{open && (
<div className="absolute right-0 top-full z-50 mt-1 max-w-[calc(100vw-2rem)] min-w-[200px] rounded-lg border border-border bg-surface-1 py-1 shadow-xl">
{SUPPORTED_LANGUAGES.map((lang) => (
<button
key={lang.id}
onClick={() => handleSwitch(lang.id as SupportedLanguage)}
className={clsx(
"flex w-full items-center gap-2 px-3 py-2 text-sm transition-colors hover:bg-surface-2",
lang.id === appLanguage ? "bg-accent-muted text-accent" : "text-text-primary",
)}
>
<span>{lang.flag}</span>
<span>{lang.nativeName}</span>
</button>
))}
</div>
)}
</div>
</div>
</header>
);
@@ -0,0 +1,77 @@
import { useEffect, useState, type RefObject } from "react";
import { useLocation } from "react-router-dom";
import { useTranslation } from "react-i18next";
import { ArrowUp } from "lucide-react";
import clsx from "clsx";
interface ScrollToTopButtonProps {
/** The scrollable container to watch and scroll back to the top. */
scrollRef: RefObject<HTMLElement>;
}
/** Scroll distance (px) past which the button fades in. */
const SHOW_AFTER_PX = 300;
/**
* Floating "back to top" button, fixed to the bottom-right of the
* viewport. Fades in once the app's scroll container is scrolled past
* {@link SHOW_AFTER_PX} and smooth-scrolls back on click.
*
* The scroll container is the `<main>` element (see AppShell), not the
* window — so the listener and `scrollTo` both target the passed ref.
*/
export function ScrollToTopButton({ scrollRef }: ScrollToTopButtonProps) {
const { t } = useTranslation("ui");
const location = useLocation();
const [visible, setVisible] = useState(false);
useEffect(() => {
const el = scrollRef.current;
if (!el) return;
let ticking = false;
const update = () => {
setVisible(el.scrollTop > SHOW_AFTER_PX);
ticking = false;
};
const onScroll = () => {
if (ticking) return;
ticking = true;
requestAnimationFrame(update);
};
// Re-evaluate on mount and whenever the route changes — the same
// <main> persists across tabs, so scrollTop does not reset itself.
update();
el.addEventListener("scroll", onScroll, { passive: true });
return () => el.removeEventListener("scroll", onScroll);
}, [scrollRef, location.pathname]);
function scrollToTop() {
const el = scrollRef.current;
if (!el) return;
const reduceMotion = window.matchMedia(
"(prefers-reduced-motion: reduce)",
).matches;
el.scrollTo({ top: 0, behavior: reduceMotion ? "auto" : "smooth" });
}
return (
<button
type="button"
onClick={scrollToTop}
aria-label={t("common.scrollToTop")}
aria-hidden={!visible}
tabIndex={visible ? 0 : -1}
className={clsx(
"fixed bottom-6 right-6 z-40 flex h-touch w-touch items-center justify-center",
"rounded-full border border-border bg-surface-1 text-text-primary shadow-lg",
"transition-opacity duration-200 hover:bg-surface-2",
"focus:outline-none focus-visible:ring-2 focus-visible:ring-accent",
visible ? "opacity-100" : "pointer-events-none opacity-0",
)}
>
<ArrowUp className="h-5 w-5" />
</button>
);
}
+133
View File
@@ -0,0 +1,133 @@
import { NavLink } from "react-router-dom";
import { useTranslation } from "react-i18next";
import {
Pencil,
FileText,
User,
Clock,
Settings,
Layers,
Share2,
ListVideo,
ScrollText,
Info,
Bug,
PanelLeftClose,
PanelLeftOpen,
type LucideIcon,
} from "lucide-react";
import clsx from "clsx";
import { useSettingsStore } from "@store/settings-store";
import { ABOUT } from "@config/about";
interface TabItem {
to: string;
labelKey: string;
icon: LucideIcon;
external?: boolean;
}
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 },
{ to: "/logs", labelKey: "tabs.logs", icon: ScrollText },
{ to: "/settings", labelKey: "tabs.settings", icon: Settings },
{ to: "/about", labelKey: "tabs.about", icon: Info },
{ to: ABOUT.bugReportUrl, labelKey: "tabs.reportBug", icon: Bug, external: true },
] as const;
interface SidebarNavListProps {
collapsed: boolean;
onItemClick?: () => void;
}
export function SidebarNavList({ collapsed, onItemClick }: SidebarNavListProps) {
const { t } = useTranslation("ui");
return (
<nav className="flex flex-1 flex-col gap-0.5 overflow-y-auto p-2">
{tabs.map((tab) => {
const baseClass = clsx(
"flex items-center gap-3 rounded-lg px-3 py-2 text-sm font-medium transition-colors",
collapsed && "justify-center px-0",
);
if (tab.external) {
return (
<a
key={tab.to}
href={tab.to}
target="_blank"
rel="noopener noreferrer"
title={collapsed ? t(tab.labelKey) : undefined}
onClick={onItemClick}
className={clsx(
baseClass,
"text-text-secondary hover:bg-surface-2 hover:text-text-primary",
)}
>
<tab.icon className="h-4 w-4 shrink-0" />
{!collapsed && <span className="truncate">{t(tab.labelKey)}</span>}
</a>
);
}
return (
<NavLink
key={tab.to}
to={tab.to}
end={tab.to === "/"}
title={collapsed ? t(tab.labelKey) : undefined}
onClick={onItemClick}
className={({ isActive }) =>
clsx(
baseClass,
isActive
? "bg-accent-muted text-accent"
: "text-text-secondary hover:bg-surface-2 hover:text-text-primary",
)
}
>
<tab.icon className="h-4 w-4 shrink-0" />
{!collapsed && <span className="truncate">{t(tab.labelKey)}</span>}
</NavLink>
);
})}
</nav>
);
}
export function Sidebar() {
const { t } = useTranslation("ui");
const collapsed = useSettingsStore((s) => s.sidebarCollapsed);
const setSetting = useSettingsStore((s) => s.setSetting);
const toggle = () => setSetting("sidebarCollapsed", !collapsed);
return (
<aside
className={clsx(
"hidden shrink-0 flex-col border-r border-border bg-surface-1 transition-[width] duration-200 md:flex",
collapsed ? "w-14" : "w-56",
)}
>
<button
type="button"
onClick={toggle}
aria-label={t(collapsed ? "sidebar.expand" : "sidebar.collapse")}
title={t(collapsed ? "sidebar.expand" : "sidebar.collapse")}
className="flex h-12 items-center justify-center border-b border-border text-text-muted transition-colors hover:bg-surface-2 hover:text-text-primary"
>
{collapsed ? (
<PanelLeftOpen className="h-5 w-5" />
) : (
<PanelLeftClose className="h-5 w-5" />
)}
</button>
<SidebarNavList collapsed={collapsed} />
</aside>
);
}
-42
View File
@@ -1,42 +0,0 @@
import { NavLink } from "react-router-dom";
import { useTranslation } from "react-i18next";
import { Pencil, FileText, User, Clock, Settings, Layers, ListVideo, ScrollText } from "lucide-react";
import clsx from "clsx";
const tabs = [
{ to: "/", labelKey: "tabs.editor", icon: Pencil },
{ to: "/output", labelKey: "tabs.output", icon: FileText },
{ to: "/batch", labelKey: "tabs.batch", icon: Layers },
{ to: "/profiles", labelKey: "tabs.profiles", icon: User },
{ to: "/history", labelKey: "tabs.history", icon: Clock },
{ to: "/playlist", labelKey: "tabs.playlist", icon: ListVideo },
{ to: "/logs", labelKey: "tabs.logs", icon: ScrollText },
{ to: "/settings", labelKey: "tabs.settings", icon: Settings },
] as const;
export function TabBar() {
const { t } = useTranslation("ui");
return (
<nav className="flex overflow-x-auto border-b border-border bg-surface-1 px-6">
{tabs.map((tab) => (
<NavLink
key={tab.to}
to={tab.to}
end={tab.to === "/"}
className={({ isActive }) =>
clsx(
"flex shrink-0 items-center gap-2 border-b-2 px-4 py-2.5 text-sm font-medium transition-colors",
isActive
? "border-accent text-accent"
: "border-transparent text-text-muted hover:text-text-secondary",
)
}
>
<tab.icon className="h-4 w-4" />
{t(tab.labelKey)}
</NavLink>
))}
</nav>
);
}
+36 -4
View File
@@ -1,8 +1,10 @@
import { useTranslation } from "react-i18next";
import toast from "react-hot-toast";
import { ClipboardCopy } from "lucide-react";
import { Button } from "@components/ui/Button";
import { useGeneratedOutput } from "@hooks/use-generated-output";
import { useClipboard } from "@hooks/use-clipboard";
import { YT_LIMITS } from "@engine/types";
interface CopyAllBarProps {
extraText?: string;
@@ -14,13 +16,43 @@ export function CopyAllBar({ extraText }: CopyAllBarProps) {
const { copy } = useClipboard();
const handleCopyAll = () => {
const text = extraText || `${output.title}\n\n${output.description}`;
copy(text);
if (extraText) {
copy(extraText);
return;
}
const overflows: string[] = [];
if (output.title.length > YT_LIMITS.TITLE_MAX) {
overflows.push(
t("output.copy.overLimit", {
field: t("output.title"),
count: output.title.length,
limit: YT_LIMITS.TITLE_MAX,
}),
);
}
if (output.description.length > YT_LIMITS.DESCRIPTION_MAX) {
overflows.push(
t("output.copy.overLimit", {
field: t("output.description"),
count: output.description.length,
limit: YT_LIMITS.DESCRIPTION_MAX,
}),
);
}
if (overflows.length > 0) {
toast.error(overflows.join("\n"));
return;
}
copy(`${output.title}\n\n${output.description}`);
};
return (
<div className="sticky bottom-0 flex items-center justify-end border-t border-border bg-surface-0 px-4 py-3">
<Button onClick={handleCopyAll} size="lg">
<div className="sticky bottom-0 flex items-center justify-end border-t border-border bg-surface-0 px-3 py-3 pb-[max(0.75rem,env(safe-area-inset-bottom))] sm:px-4">
<Button
onClick={handleCopyAll}
size="lg"
className="text-sm sm:text-base"
>
<ClipboardCopy className="h-4 w-4" />
{t("output.copyAll")}
</Button>
+21 -4
View File
@@ -1,18 +1,35 @@
import { Copy, Check } from "lucide-react";
import { Copy, Check, AlertTriangle } from "lucide-react";
import clsx from "clsx";
import { Button } from "@components/ui/Button";
import { useClipboard } from "@hooks/use-clipboard";
interface CopyButtonProps {
text: string;
label: string;
limit?: number;
fieldLabel?: string;
}
export function CopyButton({ text, label }: CopyButtonProps) {
export function CopyButton({ text, label, limit, fieldLabel }: CopyButtonProps) {
const { copy, copied } = useClipboard();
const isOver = limit !== undefined && text.length > limit;
return (
<Button variant="ghost" size="sm" onClick={() => copy(text)} disabled={!text}>
{copied ? <Check className="h-4 w-4" /> : <Copy className="h-4 w-4" />}
<Button
variant="ghost"
size="sm"
onClick={() => copy(text, { limit, fieldLabel })}
disabled={!text}
className={clsx(isOver && "text-danger hover:bg-surface-2 hover:text-danger")}
title={isOver ? `${text.length}/${limit}` : undefined}
>
{isOver ? (
<AlertTriangle className="h-4 w-4" />
) : copied ? (
<Check className="h-4 w-4" />
) : (
<Copy className="h-4 w-4" />
)}
{copied ? "Copied!" : label}
</Button>
);
+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,
+19 -4
View File
@@ -24,7 +24,12 @@ export function OutputPreview({ output: outputProp }: OutputPreviewProps) {
<h3 className="text-sm font-semibold text-text-primary">{t("output.title")}</h3>
<div className="flex items-center gap-3">
{showCharCount && <CharCounter text={output.title} limit={YT_LIMITS.TITLE_MAX} />}
<CopyButton text={output.title} label={t("output.copyTitle")} />
<CopyButton
text={output.title}
label={t("output.copyTitle")}
limit={YT_LIMITS.TITLE_MAX}
fieldLabel={t("output.title")}
/>
</div>
</div>
<div className="rounded-lg border border-border bg-surface-1 p-3">
@@ -38,10 +43,15 @@ export function OutputPreview({ output: outputProp }: OutputPreviewProps) {
<h3 className="text-sm font-semibold text-text-primary">{t("output.description")}</h3>
<div className="flex items-center gap-3">
{showCharCount && <CharCounter text={output.description} limit={YT_LIMITS.DESCRIPTION_MAX} />}
<CopyButton text={output.description} label={t("output.copyDescription")} />
<CopyButton
text={output.description}
label={t("output.copyDescription")}
limit={YT_LIMITS.DESCRIPTION_MAX}
fieldLabel={t("output.description")}
/>
</div>
</div>
<div className="max-h-[400px] overflow-y-auto rounded-lg border border-border bg-surface-1 p-3">
<div className="max-h-[60vh] overflow-y-auto rounded-lg border border-border bg-surface-1 p-3 sm:max-h-[400px]">
<pre className="whitespace-pre-wrap font-sans text-sm text-text-secondary">
{output.description}
</pre>
@@ -56,7 +66,12 @@ export function OutputPreview({ output: outputProp }: OutputPreviewProps) {
</h3>
<div className="flex items-center gap-3">
{showCharCount && <CharCounter text={output.tagString} limit={YT_LIMITS.TAGS_MAX} />}
<CopyButton text={output.tagString} label={t("output.copyTags")} />
<CopyButton
text={output.tagString}
label={t("output.copyTags")}
limit={YT_LIMITS.TAGS_MAX}
fieldLabel={t("output.tags")}
/>
</div>
</div>
<div className="rounded-lg border border-border bg-surface-1 p-3">
+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,
+9
View File
@@ -4,6 +4,7 @@ import { Upload, Pencil, Trash2 } from "lucide-react";
import { Button } from "@components/ui/Button";
import { ConfirmDialog } from "@components/ui/ConfirmDialog";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { usePresetStore, type GamePreset } from "@store/preset-store";
import { GENRES } from "@config/genres";
import { PresetSaveForm } from "./PresetSaveForm";
@@ -15,6 +16,7 @@ interface PresetCardProps {
export function PresetCard({ preset }: PresetCardProps) {
const { t } = useTranslation("ui");
const loadPreset = useEditorStore((s) => s.loadPreset);
const setSetting = useSettingsStore((s) => s.setSetting);
const deletePreset = usePresetStore((s) => s.deletePreset);
const [showDelete, setShowDelete] = useState(false);
const [showEdit, setShowEdit] = useState(false);
@@ -28,7 +30,14 @@ export function PresetCard({ preset }: PresetCardProps) {
storeLinks: { ...preset.storeLinks },
spoilerWarning: preset.spoilerWarning,
matureWarning: preset.matureWarning,
pubDevName: preset.pubDevName ?? "",
});
// v0.21.0: same pattern as PresetSelector — only flip the setting
// when the preset explicitly carries it, so older presets don't
// silently reset a user's preference on first load.
if (preset.showGameCopyright !== undefined) {
setSetting("showGameCopyright", preset.showGameCopyright);
}
};
const genreDefs = preset.genres
@@ -4,6 +4,7 @@ import { Modal } from "@components/ui/Modal";
import { Button } from "@components/ui/Button";
import { Input } from "@components/ui/Input";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { usePresetStore, type GamePreset } from "@store/preset-store";
interface PresetSaveFormProps {
@@ -15,6 +16,7 @@ interface PresetSaveFormProps {
export function PresetSaveForm({ open, onClose, editPreset }: PresetSaveFormProps) {
const { t } = useTranslation("ui");
const editor = useEditorStore();
const showGameCopyrightSetting = useSettingsStore((s) => s.showGameCopyright);
const { addPreset, updatePreset } = usePresetStore();
const [gameName, setGameName] = useState(editPreset?.gameName ?? editor.gameName);
@@ -28,6 +30,8 @@ export function PresetSaveForm({ open, onClose, editPreset }: PresetSaveFormProp
storeLinks: editPreset?.storeLinks ?? { ...editor.storeLinks },
spoilerWarning: editPreset?.spoilerWarning ?? editor.spoilerWarning,
matureWarning: editPreset?.matureWarning ?? editor.matureWarning,
pubDevName: editPreset?.pubDevName ?? editor.pubDevName,
showGameCopyright: editPreset?.showGameCopyright ?? showGameCopyrightSetting,
};
if (editPreset) {
+10
View File
@@ -2,11 +2,13 @@ import { useTranslation } from "react-i18next";
import { Select } from "@components/ui/Select";
import { usePresetStore } from "@store/preset-store";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
export function PresetSelector() {
const { t } = useTranslation("ui");
const presets = usePresetStore((s) => s.presets);
const loadPreset = useEditorStore((s) => s.loadPreset);
const setSetting = useSettingsStore((s) => s.setSetting);
if (presets.length === 0) return null;
@@ -27,7 +29,15 @@ export function PresetSelector() {
storeLinks: { ...preset.storeLinks },
spoilerWarning: preset.spoilerWarning,
matureWarning: preset.matureWarning,
pubDevName: preset.pubDevName ?? "",
});
// v0.21.0: pull the per-preset toggle into the global setting so the
// description re-renders with the right credit obligation. Missing
// means "leave the user's setting alone" — older presets don't carry
// this field.
if (preset.showGameCopyright !== undefined) {
setSetting("showGameCopyright", preset.showGameCopyright);
}
};
return <Select label={t("presets.selectPreset")} options={options} value="" onChange={handleSelect} />;
+12 -4
View File
@@ -19,19 +19,27 @@ export function ProfileCard({ profile }: ProfileCardProps) {
const [showEdit, setShowEdit] = useState(false);
const handleLoad = () => {
// v0.15.0: defensive nullish-coalesce on the two nested record
// fields. A malformed imported profile may carry `social: null` /
// `rig: null` — spreading null throws "Cannot convert undefined or
// null to object", which used to black-screen the app. `?? {}`
// turns the bad import into a partial load instead of a crash.
loadProfile({
channelName: profile.channelName,
contactEmail: profile.contactEmail,
social: { ...profile.social },
rig: { ...profile.rig },
social: { ...(profile.social ?? {}) },
rig: { ...(profile.rig ?? {}) },
resolution: profile.resolution,
fps: profile.fps,
graphicsPreset: profile.graphicsPreset,
thirdPartyAdText: profile.thirdPartyAdText ?? "",
});
};
const socialCount = Object.values(profile.social).filter((v) => v).length;
const rigCount = Object.values(profile.rig).filter((v) => v).length;
// Same defence on render: `Object.values(null)` throws. With the
// coalesce the count falls back to 0 and the chip just hides.
const socialCount = Object.values(profile.social ?? {}).filter((v) => v).length;
const rigCount = Object.values(profile.rig ?? {}).filter((v) => v).length;
return (
<>
+20 -1
View File
@@ -3,6 +3,7 @@ import { useTranslation } from "react-i18next";
import { Modal } from "@components/ui/Modal";
import { Button } from "@components/ui/Button";
import { Input } from "@components/ui/Input";
import { Textarea } from "@components/ui/Textarea";
import { useEditorStore } from "@store/editor-store";
import { useProfileStore, type Profile } from "@store/profile-store";
@@ -18,6 +19,15 @@ export function ProfileSaveForm({ open, onClose, editProfile }: ProfileSaveFormP
const { addProfile, updateProfile } = useProfileStore();
const [name, setName] = useState(editProfile?.name ?? "");
// v0.11: third-party ad copy is the only Profile field that doesn't
// round-trip through the editor. Edit it inline here so the user can
// set it once per channel without round-tripping through the editor
// form. New profiles inherit from `editor.thirdPartyAdText` (so a
// fresh profile picks up whatever the user typed in the editor); edit
// mode reads the existing value.
const [adText, setAdText] = useState(
editProfile?.thirdPartyAdText ?? editor.thirdPartyAdText ?? "",
);
const handleSave = () => {
const data = {
@@ -29,6 +39,7 @@ export function ProfileSaveForm({ open, onClose, editProfile }: ProfileSaveFormP
resolution: editProfile?.resolution ?? editor.resolution,
fps: editProfile?.fps ?? editor.fps,
graphicsPreset: editProfile?.graphicsPreset ?? editor.graphicsPreset,
thirdPartyAdText: adText,
};
if (editProfile) {
@@ -61,9 +72,17 @@ export function ProfileSaveForm({ open, onClose, editProfile }: ProfileSaveFormP
onChange={(e) => setName(e.target.value)}
autoFocus
/>
<Textarea
label={t("profiles.thirdPartyAdText")}
placeholder={t("profiles.thirdPartyAdTextPlaceholder")}
value={adText}
onChange={(e) => setAdText(e.target.value)}
rows={4}
/>
<p className="text-xs text-text-muted">{t("profiles.thirdPartyAdTextHelp")}</p>
<p className="text-xs text-text-muted">
{editProfile
? "Update this profile's name. Other fields are saved from the editor."
? "Update this profile's name and ad copy. Other fields are saved from the editor."
: "Profile will save your current channel name, social links, rig info, and video settings."}
</p>
</div>
@@ -18,6 +18,15 @@ export function TemplateCard({ template }: TemplateCardProps) {
const [showDelete, setShowDelete] = useState(false);
const handleApply = () => {
// v0.15.0: defend against a template whose `snapshot` field is
// null/undefined — most commonly when the template was imported
// from a malformed JSON. `loadProfile` itself now ignores a null
// patch via `normalizeEditorPatch`, but checking here lets us
// surface a clearer toast and skip the no-op success message.
if (!template.snapshot || typeof template.snapshot !== "object") {
toast.error(t("templates.applyFailed", { defaultValue: "Template is corrupt — cannot apply" }));
return;
}
loadProfile(template.snapshot);
toast.success(t("templates.appliedToast", { name: template.name }));
};
@@ -39,6 +39,9 @@ export function TemplateSaveForm({ open, onClose }: TemplateSaveFormProps) {
modList: editor.modList,
liveUrl: editor.liveUrl,
scheduledTime: editor.scheduledTime,
gachaQuestType: editor.gachaQuestType,
chapterName: editor.chapterName,
questName: editor.questName,
resolution: editor.resolution,
fps: editor.fps,
graphicsPreset: editor.graphicsPreset,
@@ -61,7 +64,13 @@ export function TemplateSaveForm({ open, onClose }: TemplateSaveFormProps) {
playthroughStatus: editor.playthroughStatus,
difficulty: editor.difficulty,
difficultyCustomLabel: editor.difficultyCustomLabel,
endingsShown: editor.endingsShown,
languagePatch: editor.languagePatch,
languagePatchCustom: editor.languagePatchCustom,
gameVersion: editor.gameVersion,
gameVersionCustom: editor.gameVersionCustom,
contentWarnings: [...editor.contentWarnings],
techNotes: [...editor.techNotes],
storeLinks: { ...editor.storeLinks },
storeLinkTypes: { ...editor.storeLinkTypes },
social: { ...editor.social },
+3 -3
View File
@@ -13,9 +13,9 @@ const variantClasses = {
};
const sizeClasses = {
sm: "px-2.5 py-1 text-xs",
md: "px-4 py-2 text-sm",
lg: "px-6 py-2.5 text-base",
sm: "px-2.5 py-1 text-xs min-h-[36px]",
md: "px-4 py-2 text-sm min-h-touch",
lg: "px-6 py-2.5 text-base min-h-touch",
};
export const Button = forwardRef<HTMLButtonElement, ButtonProps>(
+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>
);
}
+87
View File
@@ -0,0 +1,87 @@
import { useEffect, type ReactNode } from "react";
import { X } from "lucide-react";
import clsx from "clsx";
interface DrawerProps {
open: boolean;
onClose: () => void;
side?: "left" | "right";
title?: string;
children: ReactNode;
className?: string;
ariaLabel?: string;
}
export function Drawer({
open,
onClose,
side = "left",
title,
children,
className,
ariaLabel,
}: DrawerProps) {
useEffect(() => {
if (!open) return;
const handleEsc = (e: KeyboardEvent) => {
if (e.key === "Escape") onClose();
};
document.addEventListener("keydown", handleEsc);
const prevOverflow = document.body.style.overflow;
document.body.style.overflow = "hidden";
return () => {
document.removeEventListener("keydown", handleEsc);
document.body.style.overflow = prevOverflow;
};
}, [open, onClose]);
return (
<div
className={clsx(
"fixed inset-0 z-50 transition-opacity duration-200",
open ? "pointer-events-auto opacity-100" : "pointer-events-none opacity-0",
)}
aria-hidden={!open}
>
<div
className="absolute inset-0 bg-black/60"
onClick={onClose}
aria-hidden="true"
/>
<div
role="dialog"
aria-modal="true"
aria-label={ariaLabel ?? title}
className={clsx(
"absolute bottom-0 top-0 flex w-64 max-w-[85vw] flex-col bg-surface-1 shadow-2xl transition-transform duration-200",
side === "left" ? "left-0 border-r border-border" : "right-0 border-l border-border",
open
? "translate-x-0"
: side === "left"
? "-translate-x-full"
: "translate-x-full",
className,
)}
style={{
paddingTop: "env(safe-area-inset-top)",
paddingBottom: "env(safe-area-inset-bottom)",
}}
>
{title && (
<div className="flex items-center justify-between border-b border-border px-4 py-3">
<h2 className="text-base font-semibold text-text-primary">{title}</h2>
<button
type="button"
onClick={onClose}
className="rounded-lg p-2 text-text-muted hover:bg-surface-2 hover:text-text-primary"
aria-label="Close"
>
<X className="h-4 w-4" />
</button>
</div>
)}
<div className="flex-1 overflow-y-auto">{children}</div>
</div>
</div>
);
}
+1 -1
View File
@@ -21,7 +21,7 @@ export const Input = forwardRef<HTMLInputElement, InputProps>(
ref={ref}
id={inputId}
className={clsx(
"rounded-lg border bg-surface-1 px-3 py-2 text-sm text-text-primary placeholder:text-text-muted transition-colors focus:outline-none focus:ring-2 focus:ring-accent/50",
"min-h-touch rounded-lg border bg-surface-1 px-3 py-2.5 text-base text-text-primary placeholder:text-text-muted transition-colors focus:outline-none focus:ring-2 focus:ring-accent/50 sm:text-sm",
error ? "border-danger" : "border-border focus:border-accent",
className,
)}
+49 -9
View File
@@ -1,3 +1,4 @@
import { useEffect, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { Modal } from "./Modal";
@@ -6,29 +7,68 @@ interface ShortcutHelpModalProps {
onClose: () => void;
}
const shortcuts = [
const SHORTCUTS = [
{ keys: "Ctrl + G", labelKey: "shortcuts.generate" },
{ keys: "Ctrl + Enter", labelKey: "shortcuts.generate" },
{ keys: "Ctrl + Shift + C", labelKey: "shortcuts.copyAll" },
{ keys: "Ctrl + S", labelKey: "shortcuts.saveDraft" },
{ keys: "Ctrl + B", labelKey: "shortcuts.toggleSidebar" },
{ keys: "Ctrl + /", labelKey: "shortcuts.help" },
{ keys: "?", labelKey: "shortcuts.help" },
{ keys: "Escape", labelKey: "shortcuts.close" },
] as const;
export function ShortcutHelpModal({ open, onClose }: ShortcutHelpModalProps) {
const { t } = useTranslation("ui");
const [query, setQuery] = useState("");
// Reset the filter every time the modal closes so a re-open starts
// fresh — otherwise the previous filter persists invisibly.
useEffect(() => {
if (!open) setQuery("");
}, [open]);
const filtered = useMemo(() => {
const trimmed = query.trim().toLowerCase();
if (!trimmed) return SHORTCUTS;
return SHORTCUTS.filter((s) => {
const label = t(s.labelKey).toLowerCase();
return label.includes(trimmed) || s.keys.toLowerCase().includes(trimmed);
});
}, [query, t]);
return (
<Modal open={open} onClose={onClose} title={t("shortcuts.title")}>
<div className="flex flex-col gap-2">
{shortcuts.map((s) => (
<div key={s.keys} className="flex items-center justify-between py-1">
<span className="text-sm text-text-secondary">{t(s.labelKey)}</span>
<kbd className="rounded bg-surface-2 px-2 py-0.5 font-mono text-xs text-text-primary">
{s.keys}
</kbd>
<div className="flex flex-col gap-3">
<input
type="text"
value={query}
onChange={(e) => setQuery(e.target.value)}
placeholder={t("shortcuts.searchPlaceholder")}
className="rounded-lg border border-border bg-surface-1 px-3 py-2 text-sm text-text-primary placeholder:text-text-muted transition-colors focus:border-accent focus:outline-none focus:ring-2 focus:ring-accent/50"
autoFocus
/>
{filtered.length === 0 ? (
<p className="py-2 text-sm text-text-muted">
{t("shortcuts.noResults")}
</p>
) : (
<div className="flex flex-col gap-2">
{filtered.map((s) => (
<div
key={`${s.keys}-${s.labelKey}`}
className="flex items-center justify-between py-1"
>
<span className="text-sm text-text-secondary">
{t(s.labelKey)}
</span>
<kbd className="rounded bg-surface-2 px-2 py-0.5 font-mono text-xs text-text-primary">
{s.keys}
</kbd>
</div>
))}
</div>
))}
)}
</div>
</Modal>
);
+1 -1
View File
@@ -21,7 +21,7 @@ export const Textarea = forwardRef<HTMLTextAreaElement, TextareaProps>(
ref={ref}
id={inputId}
className={clsx(
"min-h-[80px] rounded-lg border bg-surface-1 px-3 py-2 text-sm text-text-primary placeholder:text-text-muted transition-colors focus:outline-none focus:ring-2 focus:ring-accent/50 resize-y",
"min-h-[96px] rounded-lg border bg-surface-1 px-3 py-2.5 text-base text-text-primary placeholder:text-text-muted transition-colors focus:outline-none focus:ring-2 focus:ring-accent/50 resize-y sm:text-sm",
error ? "border-danger" : "border-border focus:border-accent",
className,
)}
+10 -1
View File
@@ -10,6 +10,9 @@ interface ValidatedInputProps {
validate: (value: string) => ValidationResult;
placeholder?: string;
helpText?: string;
inputMode?: "text" | "email" | "url" | "numeric" | "tel" | "search" | "decimal";
autoComplete?: string;
enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send";
/**
* Forwarded to the inner `<input>`. Used by StoreLinkEditor to sniff a
* pasted URL and auto-fill the Game Name field — see
@@ -26,6 +29,9 @@ export function ValidatedInput({
validate,
placeholder,
helpText,
inputMode,
autoComplete,
enterKeyHint,
onPaste,
}: ValidatedInputProps) {
const { t } = useTranslation("ui");
@@ -68,8 +74,11 @@ export function ValidatedInput({
onBlur={() => setTouched(true)}
onPaste={onPaste}
placeholder={placeholder}
inputMode={inputMode}
autoComplete={autoComplete}
enterKeyHint={enterKeyHint}
className={clsx(
"rounded-lg border bg-surface-1 px-3 py-2 text-sm text-text-primary placeholder:text-text-muted transition-colors focus:outline-none focus:ring-2 focus:ring-accent/50",
"min-h-touch rounded-lg border bg-surface-1 px-3 py-2.5 text-base text-text-primary placeholder:text-text-muted transition-colors focus:outline-none focus:ring-2 focus:ring-accent/50 sm:text-sm",
touched && error ? "border-danger" : "border-border focus:border-accent",
)}
/>
+37
View File
@@ -0,0 +1,37 @@
import pkg from "../../package.json";
/**
* App metadata + author / social links surfaced on the About page.
*
* Versions come from `package.json` so the About page never lies after a
* version bump. Empty social URLs are hidden by the page; fill in the
* channel / handle URLs you want to expose before tagging a release.
*
* Note: Ko-fi / Patreon were moved out of `socials` into `@config/donate`
* in v0.13.1 — they're "support" links, not "presence" links.
*/
export const ABOUT = {
appName: "YTDescGen",
version: pkg.version,
license: "Apache-2.0",
repo: "https://github.com/poli0981/youtube-generator",
issuesUrl: "https://github.com/poli0981/youtube-generator/issues",
bugReportUrl: "https://github.com/poli0981/youtube-generator/issues/new?template=bug_report.yml",
discussionsUrl: "https://github.com/poli0981/youtube-generator/discussions",
licenseUrl: "https://github.com/poli0981/youtube-generator/blob/main/LICENSE",
githubAuthor: "https://github.com/poli0981",
socials: {
youtube: "https://www.youtube.com/@SkullMute",
x: "https://x.com/SkullMute0011",
bluesky: "https://bsky.app/profile/skullmute0011.bsky.social",
mastodon: "https://mastodon.social/@skullmute1122",
discord: "https://discord.gg/2aNR3aVt",
discordGame: "https://discord.gg/kDM9GMu5vm",
steam: "https://steamcommunity.com/profiles/76561199544666292/",
telegramBot: "https://t.me/my_skull_bot",
telegramUser: "https://t.me/SkullMute0011",
email: "mailto:lopop05905@proton.me",
},
} as const;
export type AboutSocialId = keyof typeof ABOUT.socials;
+344
View File
@@ -0,0 +1,344 @@
import type { ContentWarning } from "@engine/types";
/**
* UI grouping for the content-warning checklist. The engine doesn't
* care about groups — render order in the description follows the
* user's selection order in the array — but the editor uses these
* groups to render collapsible sections so 40+ items are scannable.
*
* Add a new warning by:
* 1. Appending the id to {@link CONTENT_WARNINGS} in `@engine/types`.
* 2. Adding it to one of these groups (UI placement).
* 3. Translating `description.contentWarnings.items.{id}` in all locales
* + the editor's `editor.contentWarningOptions.{id}` short label.
*/
export interface ContentWarningGroup {
id: string;
/** i18n key for the group heading shown in the editor. */
labelKey: string;
items: ContentWarning[];
}
export const CONTENT_WARNING_GROUPS: readonly ContentWarningGroup[] = [
{
id: "spoilers",
labelKey: "editor.contentWarningGroups.spoilers",
items: [
"spoiler_story",
"spoiler_ending",
"spoiler_true_ending",
"spoiler_post_game",
"spoiler_secret_ending",
"spoiler_dlc",
],
},
{
id: "photosensitive",
labelKey: "editor.contentWarningGroups.photosensitive",
items: [
"flashing_lights",
"motion_sickness",
"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",
],
},
{
id: "audio",
labelKey: "editor.contentWarningGroups.audio",
items: [
"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",
],
},
{
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",
items: [
"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",
],
},
{
id: "mental_health",
labelKey: "editor.contentWarningGroups.mental_health",
items: [
"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",
],
},
{
id: "social_phenomena",
labelKey: "editor.contentWarningGroups.social_phenomena",
items: [
"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",
],
},
{
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",
],
},
{
id: "sensitive",
labelKey: "editor.contentWarningGroups.sensitive",
items: [
"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",
],
},
{
id: "horror_specific",
labelKey: "editor.contentWarningGroups.horror_specific",
items: [
"eye_horror",
"body_horror",
"face_horror",
"cosmic_horror",
"extreme_gore",
"decay_rot",
"mutilation",
"liminal_spaces",
"analog_horror",
"unreality_themes",
"pursuit_chase",
"entity_horror",
],
},
{
id: "playstyle",
labelKey: "editor.contentWarningGroups.playstyle",
items: [
"blind_playthrough",
"no_spoilers_chat",
"casual_difficulty",
"hardcore_difficulty",
"permadeath_run",
"speedrun_attempt",
"completionist_run",
"learning_mechanics",
"first_time_playing",
"returning_player",
],
},
{
id: "gameplay_disclosure",
labelKey: "editor.contentWarningGroups.gameplay_disclosure",
items: [
"mods_used",
"cheats_enabled",
"glitch_exploits",
"assisted_run",
"educational_purpose_only",
],
},
] as const;
+79 -2
View File
@@ -8,12 +8,19 @@ import type {
UpscaleQuality,
ArtStyle,
} from "./graphics-settings";
import type { VideoStyleEra } from "./video-styles";
import { DEFAULT_GACHA_QUEST_TYPE, type GachaQuestType } from "./gacha-quest-types";
import type {
SupportedLanguage,
StoreLinkType,
PlaythroughStatus,
DifficultyLevel,
ContentWarning,
LanguagePatch,
GameVersion,
TechNote,
EndingEntry,
EndingVideoRange,
} from "@engine/types";
export interface EditorDefaults {
@@ -35,6 +42,18 @@ export interface EditorDefaults {
liveUrl: string;
/** Livestream-only: ISO scheduled datetime. */
scheduledTime: string;
/** Gacha-quest selected pattern (v0.9). */
gachaQuestType: GachaQuestType;
/** Gacha-quest chapter / story-arc label (free-form). */
chapterName: string;
/** Gacha-quest individual quest / event name (free-form). */
questName: string;
/** Gacha-quest character name (v0.13) — only rendered for `showcase` quest type. */
characterName: string;
/** Gacha-quest anniversary year (v0.13) — only rendered for `anniversary` quest type. 1–20 or null. */
anniversaryYear: number | null;
/** Gacha-quest game version label (v0.13) — e.g. "1.2", "2.4". Only used for `gacha_quest` videoType. */
gachaVersion: string;
resolution: string;
fps: string;
graphicsPreset: GraphicsPreset;
@@ -45,6 +64,8 @@ export interface EditorDefaults {
frameGenMultiplier: FrameGenMultiplier;
upscaleQuality: UpscaleQuality;
artStyle: ArtStyle;
/** v0.22.0 opt-in. Empty string = no style line in the description. */
videoStyleEra: VideoStyleEra;
versionInfo: string;
timestamps: string;
playlistLink: string;
@@ -52,14 +73,53 @@ export interface EditorDefaults {
musicAttribution: string;
sponsorName: string;
sponsorPlatform: string;
/**
* Free-text publisher / developer name shown alongside the
* Publisher / Developer site URL in the Store Links editor. Emitted
* as a YouTube tag (e.g. "Ubisoft", "FromSoftware") via tag-generator.
* Independent from {@link sponsorName}, which feeds the description's
* "🎁 Thanks to …" line and is not added to tags.
*/
pubDevName: string;
/**
* Channel-level third-party advertising / sponsor / partner copy
* (v0.11). Persisted on the Profile so it carries across all videos
* for a given channel. Empty string by default — the description
* block is gated on both this being non-empty AND the
* `showThirdPartyAds` settings toggle being on.
*/
thirdPartyAdText: string;
thumbnailText: string;
pinnedComment: string;
/** @deprecated v0.11 — superseded by `contentWarnings` checklist. */
spoilerWarning: boolean;
/** @deprecated v0.11 — superseded by `contentWarnings` checklist. */
matureWarning: boolean;
playthroughStatus: PlaythroughStatus;
difficulty: DifficultyLevel;
difficultyCustomLabel: string;
/** Free-text endings descriptor for Playthrough Notes section (v0.12).
* @deprecated v0.16.0 — superseded by structured {@link endings}. */
endingsShown: string;
/** Structured ending list (v0.16.0). */
endings: EndingEntry[];
/** Number of videos the playthrough is split across (v0.16.0). */
endingVideoCount: number;
/** Per-video ending range (v0.16.0). */
endingVideoRanges: EndingVideoRange[];
/** Which per-video slice the Output previews (v0.17.1). */
endingVideoIndex: number;
/** Language-patch enum for Playthrough Notes section (v0.12). */
languagePatch: LanguagePatch;
/** Free-form label when `languagePatch` is `"official_other"` or `"custom"`. */
languagePatchCustom: string;
/** Game-version enum for Playthrough Notes section (v0.12). */
gameVersion: GameVersion;
/** Free-form label when `gameVersion === "custom"`. */
gameVersionCustom: string;
contentWarnings: ContentWarning[];
/** Tech / production / playstyle disclaimer checklist items (v0.12). */
techNotes: TechNote[];
storeLinks: Record<string, string>;
storeLinkTypes: Record<string, StoreLinkType>;
social: Record<string, string>;
@@ -76,7 +136,6 @@ export interface EditorDefaults {
export interface SettingsDefaults {
theme: "dark" | "light";
defaultLanguage: string;
defaultGenres: GenreId[];
}
export const DEFAULTS = {
@@ -96,6 +155,12 @@ export const DEFAULTS = {
modList: "",
liveUrl: "",
scheduledTime: "",
gachaQuestType: DEFAULT_GACHA_QUEST_TYPE,
chapterName: "",
questName: "",
characterName: "",
anniversaryYear: null,
gachaVersion: "",
resolution: "1080p",
fps: "60",
graphicsPreset: "medium",
@@ -106,6 +171,7 @@ export const DEFAULTS = {
frameGenMultiplier: "none",
upscaleQuality: "none",
artStyle: "none",
videoStyleEra: "" satisfies VideoStyleEra,
versionInfo: "",
timestamps: "",
playlistLink: "",
@@ -113,6 +179,8 @@ export const DEFAULTS = {
musicAttribution: "",
sponsorName: "",
sponsorPlatform: "",
pubDevName: "",
thirdPartyAdText: "",
thumbnailText: "",
pinnedComment: "",
spoilerWarning: false,
@@ -120,7 +188,17 @@ export const DEFAULTS = {
playthroughStatus: "none",
difficulty: "none",
difficultyCustomLabel: "",
endingsShown: "",
endings: [],
endingVideoCount: 1,
endingVideoRanges: [],
endingVideoIndex: 1,
languagePatch: "none",
languagePatchCustom: "",
gameVersion: "full_release",
gameVersionCustom: "",
contentWarnings: [],
techNotes: [],
storeLinks: {},
storeLinkTypes: {},
social: {},
@@ -135,6 +213,5 @@ export const DEFAULTS = {
settings: {
theme: "dark",
defaultLanguage: "en",
defaultGenres: ["action"],
} satisfies SettingsDefaults,
} as const;
Loaded 100 of 200 files, more files were not shown because too many files have changed in this diff. Show more