Compare commits

...
52 Commits
Author SHA1 Message Date
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
poli0981andClaude Opus 4.7 03bae05f07 chore: update version to 0.8.0 (#35)
* feat(v0.8-polish): VN bank/MoMo/ZaloPay donate, video-settings multi-line, mod-list textarea, template-snapshot fixes

Four small refinements requested before bumping 0.8.0.

VN donate (bank + MoMo + ZaloPay)
* Five new editor fields — vnBankName / vnBankAccount / vnBankHolder /
  vnMomo / vnZalopay — surface in a new `VietnameseDonateEditor`
  component nested inside the existing Store & Social accordion. The
  editor is always visible regardless of output language; the
  description block is gated on `language === "vi"` because non-VN
  viewers don't typically use these payment methods.
* Description renders a `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ (Việt Nam)` block
  between donate links and social links. Bank line includes the holder
  in parens when set, drops the parens when not. MoMo / ZaloPay each
  get their own line, independent of the bank entry.

Video Settings — multi-line block with labels
* The "🖥 VIDEO SETTINGS" section now renders one labelled line per
  token (Video / In-game Setting / Art Style / Version), matching the
  key-value-per-line shape of the rig + timestamps blocks. The pre-v0.8
  pipe-separated single line is gone.
* `composeGraphicsPart` drops its trailing "Setting" suffix — the new
  "In-game Setting:" label provides the same context without the
  "Cinematic Setting" / "Ultra Setting" double-up. The
  `description.graphics.settingSuffix` template key is removed across
  all 6 locales.

Mod List
* New `modList: string` editor field — multi-line textarea exposed
  alongside `modName` whenever videoType is `mods`. Designed for pasting
  straight from a mod manager (Wabbajack / Vortex / Mod Organizer).
* Description renders a `🧩 MOD LIST` block right after MY RIG, only
  for the `mods` video type and only when the field is non-empty.

TemplateSnapshot completeness fix
* Adds the v0.7 phase 2 fields that had been missing — playthroughStatus,
  difficulty, difficultyCustomLabel, contentWarnings — plus all v0.8
  polish fields (modList, vnBank*, vnMomo, vnZalopay). Saving a template
  now captures the full editor state. All new fields are optional on
  the type so legacy snapshots load cleanly via `loadProfile`'s spread.

Migrations
* Editor store v5 → v6, additive — empty-string defaults for the 6 new
  fields. No value mapping, no data loss.

i18n
* 6 locales × ui.json (14 new editor keys) + templates.json (2 new
  section headers, 3 new graphics labels, dropped settingSuffix). 391
  ui keys + 164 template keys per locale. Vietnamese fully translated;
  ja / es / ko / zh seeded with English defaults for new editor strings.

Tests (7 new, 7 updated): `Video: 1080p - 60 FPS` / `In-game Setting:`
multi-line shape (8 tests), VN donate gating (4 tests, including the
non-vi guard), Mod List gating (2 tests). 249 total.

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

* chore: update version to 0.8.0

Bumps all four manifest files for the v0.8.0 release: package.json,
src-tauri/tauri.conf.json, src-tauri/Cargo.toml, and the yt-desc-gen
entry in src-tauri/Cargo.lock. Marks the end of the v0.8 cycle (PR #32
+ #33 + #34 — tag fix, graphics v2, livestream, genre playlists, VN
donate, video-settings multi-line, mod list, TemplateSnapshot fix).

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 22:31:20 +07:00
poli0981andClaude Opus 4.7 39dd346050 feat(v0.8-polish): VN bank/MoMo/ZaloPay donate, video-settings multi-line, mod-list textarea, template-snapshot fixes (#34)
Four small refinements requested before bumping 0.8.0.

VN donate (bank + MoMo + ZaloPay)
* Five new editor fields — vnBankName / vnBankAccount / vnBankHolder /
  vnMomo / vnZalopay — surface in a new `VietnameseDonateEditor`
  component nested inside the existing Store & Social accordion. The
  editor is always visible regardless of output language; the
  description block is gated on `language === "vi"` because non-VN
  viewers don't typically use these payment methods.
* Description renders a `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ (Việt Nam)` block
  between donate links and social links. Bank line includes the holder
  in parens when set, drops the parens when not. MoMo / ZaloPay each
  get their own line, independent of the bank entry.

Video Settings — multi-line block with labels
* The "🖥 VIDEO SETTINGS" section now renders one labelled line per
  token (Video / In-game Setting / Art Style / Version), matching the
  key-value-per-line shape of the rig + timestamps blocks. The pre-v0.8
  pipe-separated single line is gone.
* `composeGraphicsPart` drops its trailing "Setting" suffix — the new
  "In-game Setting:" label provides the same context without the
  "Cinematic Setting" / "Ultra Setting" double-up. The
  `description.graphics.settingSuffix` template key is removed across
  all 6 locales.

Mod List
* New `modList: string` editor field — multi-line textarea exposed
  alongside `modName` whenever videoType is `mods`. Designed for pasting
  straight from a mod manager (Wabbajack / Vortex / Mod Organizer).
* Description renders a `🧩 MOD LIST` block right after MY RIG, only
  for the `mods` video type and only when the field is non-empty.

TemplateSnapshot completeness fix
* Adds the v0.7 phase 2 fields that had been missing — playthroughStatus,
  difficulty, difficultyCustomLabel, contentWarnings — plus all v0.8
  polish fields (modList, vnBank*, vnMomo, vnZalopay). Saving a template
  now captures the full editor state. All new fields are optional on
  the type so legacy snapshots load cleanly via `loadProfile`'s spread.

Migrations
* Editor store v5 → v6, additive — empty-string defaults for the 6 new
  fields. No value mapping, no data loss.

i18n
* 6 locales × ui.json (14 new editor keys) + templates.json (2 new
  section headers, 3 new graphics labels, dropped settingSuffix). 391
  ui keys + 164 template keys per locale. Vietnamese fully translated;
  ja / es / ko / zh seeded with English defaults for new editor strings.

Tests (7 new, 7 updated): `Video: 1080p - 60 FPS` / `In-game Setting:`
multi-line shape (8 tests), VN donate gating (4 tests, including the
non-vi guard), Mod List gating (2 tests). 249 total.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 22:25:55 +07:00
poli0981andClaude Opus 4.7 ba58037306 feat(v0.8-phase2): graphics settings v2, livestream, pinned-comment genre playlists (#33)
The big v0.8 feature drop: PC build viewers can finally see RT modes,
frame-gen multipliers, and upscaling quality in the description; 2D /
pixel-art games skip the Video Settings section entirely; livestreams
get their own video type with a 🔴 LIVE block; and the pinned-comment
template auto-suggests a per-genre playlist configured once in Settings.

Foundations
* New `src/config/graphics-settings.ts` — GraphicsPreset, RTMode,
  FrameGenVendor, FrameGenMultiplier, UpscaleQuality, ArtStyle enums,
  plus `GENRES_WITHOUT_GRAPHICS_SETTINGS` for the auto-suggest hint.
* `engine/types.ts` extends GeneratorInput; `livestream` joins VideoType.
* Editor store v4 → v5 migration maps legacy free-form `graphicsPreset`
  text ("Ultra"→"ultra"; "Epic"→"custom"+"Epic") and backfills 9 new
  fields. `legacyGraphicsPresetToEnum` is exported for unit tests, and
  `normalizeEditorPatch` runs on `loadProfile` / `loadPreset` so legacy
  profile / template snapshots round-trip cleanly.
* Settings store v6 → v7 — `genrePlaylists: {}` and
  `pinnedCommentIncludeGenrePlaylist: false`.

Engine
* `description-builder.ts` — `composeGraphicsPart` produces lines like
  `Cinematic Setting - NVIDIA Frame Generation x2 with Ray Tracing`,
  with Art Style and Driver/Game Version as separate trailing tokens.
  The whole 🖥 VIDEO SETTINGS section is omitted when
  `skipGraphicsSettings` is true. Livestream videos render an extra
  block with a locale-formatted scheduled time and the watch link.
* `tag-generator.ts` — new `livestream` pool ("livestream",
  "live gameplay", `${gameName} live`, `${gameName} stream`).
* `pinned-comment-builder.ts` gains `includeGenrePlaylist`,
  `genrePlaylists`, `genreLabels` options; emits the genre-playlist
  suggestion line for the primary genre when configured.

UI
* `VideoSettingsForm.tsx` rewritten — preset Select, Custom field,
  skip toggle (with help text), Ray Tracing chip multi-select,
  Frame Gen vendor + multiplier, Upscaling Quality, Art Style, free-form
  Driver/Game Version.
* `ExtraFieldsInput.tsx` — livestream extras (live URL, scheduled time
  via native datetime-local input).
* `GenreSelector.tsx` — auto-suggest skip-graphics chip when a
  visual_novel / fmv / rhythm genre is added; session-local dismissal.
* `SettingsPage.tsx` — Genre Playlists section (per-genre URL inputs
  validated by `validatePlaylistUrl`); `pinnedCommentIncludeGenrePlaylist`
  toggle nested under the existing pinned-comment template toggle.
* `OutputExtras.tsx` resolves genre labels and passes the new options
  to `buildPinnedComment`.
* Profile + template stores carry `GraphicsPreset` typed slot;
  TemplateSnapshot picks up the new fields as optional.

i18n — all 6 locales updated, schema enforces 377 ui + 160 template
keys / locale. Vietnamese fully translated; ja/es/ko/zh seeded with
English defaults for the new strings (refine later as needed). Brand
terms (DLSS / FSR / XeSS / Ray Tracing) intentionally English everywhere.

Tests (24 new): graphics composition (7), livestream (4 description +
1 title + 1 tag pool + 1 pinned greeting), genre-playlist suggestion (4),
`legacyGraphicsPresetToEnum` (7), settings-heal v6→v7 (3). 242 total.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 21:21:36 +07:00
poli0981andClaude Opus 4.7 26f5907006 feat(v0.8-phase1): tag long-name fix, playlist URL validator, URL paste auto-extract, publisher platform (#32)
Fixes the silent tag drop where a long game name (>30 chars after composition)
caused every game-name-bearing tag to disappear from the output. Adds
url-extractors that pre-fill Game Name from a pasted Steam / itch.io / GOG URL.
Tightens YouTube playlist URL validation. Introduces Publisher / Developer site
as a tenth store-link platform.

* tagFriendlyGameName helper strips trademark marks, peels edition qualifiers,
  falls back to colon head, then leading words. generateTags now seeds both a
  bare-name tag (≤30) and a compose-name (≤21) so composites also fit ≤30.
* validatePlaylistUrl rejects watch?v=, youtu.be, and http URLs; expects
  https://www.youtube.com/playlist?list=[id].
* StoreLinkEditor onPaste auto-fills empty Game Name with extracted slug;
  toast.custom shows the result with a 5s Undo action.
* Publisher platform uses a permissive HTTPS pattern for indie / niche releases
  distributed only from a developer's own site.
* New i18n keys: validation.playlistUrlInvalid, editor.toast.urlAutoFilled,
  common.undo (all 6 locales).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 20:41:29 +07:00
140 changed files with 15289 additions and 1574 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 -->
+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
+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
+49 -2
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,13 +20,39 @@ permissions:
jobs:
build:
strategy:
fail-fast: false
matrix:
include:
- 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
with:
# On `workflow_dispatch` checkout the requested tag; on a
# tag push we already get the tag commit by default.
ref: ${{ github.event.inputs.tag || github.ref }}
- uses: actions/setup-node@v4
with:
node-version: 20
@@ -24,12 +60,23 @@ jobs:
- 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 }}
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 }}
+350
View File
@@ -2,6 +2,356 @@
All notable changes to YTDescGen ship as tagged releases on `main`.
## 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.
+7 -6
View File
@@ -4,11 +4,11 @@
**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 7 + Tailwind CSS 3 + Zustand + Tauri 2 (desktop)
- **Target Platforms**: Web (GitHub Pages), Desktop (Windows/macOS/Linux via Tauri)
## Tech Stack
@@ -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.
+73
View File
@@ -0,0 +1,73 @@
# 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).
## 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`
+98 -34
View File
@@ -1,56 +1,120 @@
# 🎮 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.
- **91 content-warning IDs** across 8 groups — phobias, photosensitive, mental health, sensitive themes, horror-specific, playstyle, and gameplay disclosure (mods / cheats / glitches / guide-assisted). Sets viewer expectations before they hit play.
- **Profile system** — save channel / social / rig info once, reuse across every video.
- **Game presets** — save game name + store links once, reuse across the entire part series.
- **Snapshot templates** — save full-form configurations and recall in one click.
- **Smart tag generation** — combines genre pool, platform, quality tier, multilingual hooks, and trending terms; auto-dedup and 500-char-limit aware.
- **Character counters** — real-time limits for title (100), description (5000), tags (500).
- **Batch mode** — generate metadata for all parts of a series in one pass.
- **Desktop app** — Windows & macOS native binaries via Tauri (~8 MB).
- **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 7 · 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. |
| [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).
+143
View File
@@ -0,0 +1,143 @@
# 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.0.0` | Vite 7 dropped support for older Node. 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/*`.
### 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.
+22 -39
View File
@@ -239,48 +239,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+ |
+145
View File
@@ -0,0 +1,145 @@
# 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.0.0` | Vite 7 đã bỏ hỗ trợ Node cũ. Dùng [nvm](https://github.com/nvm-sh/nvm) hoặc [fnm](https://github.com/Schniz/fnm). |
| **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/*`.
### 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>
+204 -566
View File
File diff suppressed because it is too large. Load diff
+23 -22
View File
@@ -1,7 +1,8 @@
{
"name": "yt-desc-gen",
"version": "0.7.0",
"version": "0.14.0",
"private": true,
"license": "Apache-2.0",
"type": "module",
"scripts": {
"dev": "vite",
@@ -21,39 +22,39 @@
"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",
"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",
"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",
"postcss": "^8.5.14",
"prettier": "^3.3.0",
"prettier-plugin-tailwindcss": "^0.6.0",
"tsx": "^4.16.0"
"tailwindcss": "^3.4.0",
"tsx": "^4.16.0",
"typescript": "^5.5.0",
"typescript-eslint": "^8.0.0",
"vite": "^7.3.3",
"vitest": "^3.2.4"
}
}
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 -61
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,7 +5535,7 @@ dependencies = [
[[package]]
name = "yt-desc-gen"
version = "0.7.0"
version = "0.14.0"
dependencies = [
"serde",
"serde_json",
@@ -5421,6 +5545,7 @@ dependencies = [
"tauri-plugin-fs",
"tauri-plugin-opener",
"tauri-plugin-shell",
"tauri-plugin-single-instance",
]
[[package]]
+3 -1
View File
@@ -1,9 +1,10 @@
[package]
name = "yt-desc-gen"
version = "0.7.0"
version = "0.14.0"
description = "YouTube Gameplay Description Generator"
authors = ["poli0981"]
edition = "2021"
license = "Apache-2.0"
[lib]
name = "yt_desc_gen_lib"
@@ -18,5 +19,6 @@ tauri-plugin-dialog = "2"
tauri-plugin-fs = "2"
tauri-plugin-opener = "2"
tauri-plugin-shell = "2"
tauri-plugin-single-instance = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
+13
View File
@@ -31,6 +31,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())
+7 -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.7.0",
"version": "0.14.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
}
+11
View File
@@ -26,6 +26,9 @@ const PlaylistPage = lazy(() =>
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>;
@@ -93,6 +96,14 @@ export default function App() {
</Suspense>
}
/>
<Route
path="about"
element={
<Suspense fallback={<PageLoader />}>
<AboutPage />
</Suspense>
}
/>
</Route>
</Routes>
</HashRouter>
@@ -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,171 @@
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,
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>
);
}
+163 -6
View File
@@ -1,8 +1,18 @@
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`,
@@ -17,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")}
@@ -52,13 +179,43 @@ export function ExtraFieldsInput() {
/>
)}
{extraFields.includes("modName") && (
<>
<Input
label={t("editor.modName")}
placeholder={t("editor.modNamePlaceholder")}
value={store.modName ?? ""}
onChange={(e) => store.set("modName", e.target.value)}
/>
<Textarea
label={t("editor.modList")}
placeholder={t("editor.modListPlaceholder")}
value={store.modList ?? ""}
onChange={(e) => store.set("modList", e.target.value)}
rows={5}
/>
</>
)}
{extraFields.includes("liveUrl") && (
<Input
label={t("editor.modName")}
placeholder={t("editor.modNamePlaceholder")}
value={store.modName ?? ""}
onChange={(e) => store.set("modName", e.target.value)}
label={t("editor.liveUrl")}
placeholder={t("editor.liveUrlPlaceholder")}
value={store.liveUrl ?? ""}
onChange={(e) => store.set("liveUrl", e.target.value)}
/>
)}
{extraFields.includes("scheduledTime") && (
<div className="flex flex-col gap-1">
<label className="text-sm font-medium text-text-secondary">
{t("editor.scheduledTime")}
</label>
<input
type="datetime-local"
value={store.scheduledTime ?? ""}
onChange={(e) => store.set("scheduledTime", e.target.value)}
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"
/>
</div>
)}
</div>
);
}
+4
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")}
+109 -14
View File
@@ -1,28 +1,123 @@
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";
export function GenreSelector() {
const { t } = useTranslation("ui");
const genres = useEditorStore((s) => s.genres);
const skipGraphicsSettings = useEditorStore((s) => s.skipGraphicsSettings);
const set = useEditorStore((s) => s.set);
// Session-local dismissal so the hint doesn't keep popping up after the
// user has chosen "Keep". Forgets across reloads, which is fine — a
// 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 (
<ChipGroup
label={t("editor.genre")}
multiple
max={MAX_GENRES}
options={options}
value={genres}
onChange={(next) => set("genres", next as Genre[])}
/>
<div className="flex flex-col gap-2">
<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>
<div className="flex shrink-0 gap-2">
<button
type="button"
className="rounded bg-accent px-2 py-1 font-medium text-white"
onClick={() => {
set("skipGraphicsSettings", true);
setHintDismissed(true);
}}
>
{t("editor.skipGraphicsHintHide")}
</button>
<button
type="button"
className="rounded px-2 py-1 font-medium text-text-secondary hover:bg-surface-2"
onClick={() => setHintDismissed(true)}
>
{t("editor.skipGraphicsHintKeep")}
</button>
</div>
</div>
)}
</div>
);
}
@@ -0,0 +1,129 @@
import { useTranslation } from "react-i18next";
import { Select } from "@components/ui/Select";
import { Input } from "@components/ui/Input";
import { useEditorStore } from "@store/editor-store";
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)}
/>
)}
<Input
label={t("editor.playthroughNotes.endingsLabel")}
placeholder={t("editor.playthroughNotes.endingsPlaceholder")}
value={store.endingsShown}
onChange={(e) => store.set("endingsShown", e.target.value)}
/>
<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>
);
}
+224 -30
View File
@@ -1,48 +1,242 @@
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,
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,
validateRamValue,
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);
const issue = validateRamValue(raw);
const partValues = field.composite.parts.map(
(_p, i) => storedParts[i] ?? "",
);
const setPart = (index: number, next: string) => {
const updated = [...partValues];
updated[index] = next;
setNested("rig", field.id, joinComposite(updated));
};
const renderPart = (part: CompositePart, index: number) => {
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 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(part.labelKey)}
value={selectValue}
options={part.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>
);
};
return (
<div key={field.id} className="col-span-2 flex flex-col gap-2">
<span className="text-sm font-medium text-text-secondary">{t(field.labelKey)}</span>
<div className="grid grid-cols-2 gap-2">
{field.composite.parts.map((p, i) => renderPart(p, i))}
</div>
{renderValidationBadge(issue)}
</div>
);
};
const renderDropdownWithVersion = (field: RigField) => {
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}
+125 -1
View File
@@ -1,31 +1,144 @@
import { useMemo, useState } from "react";
import type { ClipboardEvent } from "react";
import { useTranslation } from "react-i18next";
import toast from "react-hot-toast";
import { Input } from "@components/ui/Input";
import { ValidatedInput } from "@components/ui/ValidatedInput";
import { Select } from "@components/ui/Select";
import { PLATFORMS } from "@config/platforms";
import { useEditorStore } from "@store/editor-store";
import { validateUrlWithPattern } from "@utils/validation";
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);
const storeLinkTypes = useEditorStore((s) => s.storeLinkTypes);
const gameName = useEditorStore((s) => s.gameName);
const pubDevName = useEditorStore((s) => s.pubDevName);
const setField = useEditorStore((s) => s.set);
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
// being reverted. Never overwrites a non-empty Game Name.
const handlePaste = (e: ClipboardEvent<HTMLInputElement>) => {
if (gameName.trim()) return;
const pasted = e.clipboardData.getData("text").trim();
if (!pasted) return;
const extracted = extractGameNameFromUrl(pasted);
if (!extracted) return;
setField("gameName", extracted);
toast.custom(
(item) => (
<div className="flex items-center gap-3 rounded-lg border border-border bg-surface-2 px-3 py-2 text-sm text-text-primary shadow">
<span>{t("editor.toast.urlAutoFilled", { name: extracted })}</span>
<button
type="button"
className="rounded px-2 py-0.5 text-xs font-medium text-accent hover:bg-surface-1"
onClick={() => {
setField("gameName", "");
toast.dismiss(item.id);
}}
>
{t("common.undo")}
</button>
</div>
),
{ duration: 5000 },
);
};
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] ?? "";
// Publisher / Developer site is the only platform that pairs
// with a free-text name field (rendered below the URL once the
// URL is non-empty). The name becomes a YouTube tag — see
// tag-generator.ts. Keeping the input in this same grid (via
// `col-span-2`) preserves vertical rhythm with the rest of
// the platform rows.
const showPubDevName =
platform.id === "publisher" && url.trim().length > 0;
return (
<div
key={platform.id}
@@ -34,12 +147,13 @@ 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);
}}
validate={(v) => validateUrlWithPattern(v, platform.urlPattern)}
onPaste={handlePaste}
/>
<Select
label={t("editor.storeLinkType")}
@@ -47,6 +161,16 @@ export function StoreLinkEditor() {
options={typeOptions}
onChange={(v) => setStoreLinkType(platform.id, v as StoreLinkType)}
/>
{showPubDevName && (
<div className="col-span-2">
<Input
label={t("editor.pubDevName")}
placeholder={t("editor.pubDevNamePlaceholder")}
value={pubDevName ?? ""}
onChange={(e) => setField("pubDevName", e.target.value)}
/>
</div>
)}
</div>
);
})}
@@ -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>
);
}
+145 -4
View File
@@ -1,7 +1,27 @@
import { useTranslation } from "react-i18next";
import { Select } from "@components/ui/Select";
import { Input } from "@components/ui/Input";
import { ChipGroup } from "@components/ui/ChipGroup";
import { Toggle } from "@components/ui/Toggle";
import { useEditorStore } from "@store/editor-store";
import {
GRAPHICS_PRESETS,
RT_MODES,
FRAMEGEN_VENDORS,
ART_STYLES,
type GraphicsPreset,
type RTMode,
type FrameGenVendor,
type FrameGenMultiplier,
type UpscaleQuality,
type ArtStyle,
} from "@config/graphics-settings";
import {
getValidUpscaleQualities,
getValidFrameGenMultipliers,
coerceUpscaleQuality,
coerceFrameGenMultiplier,
} from "@engine/graphics-vendor";
const RESOLUTION_OPTIONS = [
{ value: "720p", label: "720p" },
@@ -21,9 +41,65 @@ export function VideoSettingsForm() {
const { t } = useTranslation("ui");
const store = useEditorStore();
const presetOptions = GRAPHICS_PRESETS.map((p) => ({
value: p,
label: t(`editor.graphicsPresetOptions.${p}`),
}));
const rtChipOptions = RT_MODES.map((m) => ({
id: m,
label: t(`editor.rtOptions.${m}`),
}));
const vendorOptions = FRAMEGEN_VENDORS.map((v) => ({
value: v,
label: t(`editor.frameGenVendorOptions.${v}`),
}));
// 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:
store.frameGenVendor === "none"
? t(`editor.frameGenMultiplierOptions.${m}`)
: t(`editor.frameGenMultiplier.${store.frameGenVendor}.${m}`),
}));
const upscaleOptions = getValidUpscaleQualities(store.frameGenVendor).map((q) => ({
value: 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}`),
}));
return (
<div className="flex flex-col gap-3">
<span className="text-sm font-medium text-text-secondary">{t("editor.videoSettings")}</span>
<div className="grid grid-cols-3 gap-3">
<Select
label={t("editor.resolution")}
@@ -37,13 +113,78 @@ export function VideoSettingsForm() {
value={store.fps ?? "60"}
onChange={(v) => store.set("fps", v)}
/>
<Input
<Select
label={t("editor.graphicsPreset")}
placeholder="Ultra"
value={store.graphicsPreset ?? ""}
onChange={(e) => store.set("graphicsPreset", e.target.value)}
options={presetOptions}
value={store.graphicsPreset}
onChange={(v) => store.set("graphicsPreset", v as GraphicsPreset)}
/>
</div>
{store.graphicsPreset === "custom" && (
<Input
label={t("editor.graphicsPresetCustom")}
placeholder={t("editor.graphicsPresetCustomPlaceholder")}
value={store.graphicsPresetCustom}
onChange={(e) => store.set("graphicsPresetCustom", e.target.value)}
/>
)}
<Toggle
label={t("editor.skipGraphicsSettings")}
checked={store.skipGraphicsSettings}
onChange={(v) => store.set("skipGraphicsSettings", v)}
/>
<p className="-mt-1 text-xs text-text-muted">{t("editor.skipGraphicsSettingsHelp")}</p>
{!store.skipGraphicsSettings && (
<>
<ChipGroup
label={t("editor.rayTracing")}
multiple
options={rtChipOptions}
value={store.rayTracingModes}
onChange={(next) => store.set("rayTracingModes", next as RTMode[])}
/>
<div className="grid grid-cols-2 gap-3">
<Select
label={t("editor.frameGenVendor")}
options={vendorOptions}
value={store.frameGenVendor}
onChange={(v) => handleVendorChange(v as FrameGenVendor)}
/>
<Select
label={t("editor.frameGenMultiplier")}
options={multiplierOptions}
value={store.frameGenMultiplier}
onChange={(v) => store.set("frameGenMultiplier", v as FrameGenMultiplier)}
/>
</div>
<div className="grid grid-cols-2 gap-3">
<Select
label={t("editor.upscaleQuality")}
options={upscaleOptions}
value={store.upscaleQuality}
onChange={(v) => store.set("upscaleQuality", v as UpscaleQuality)}
/>
<Select
label={t("editor.artStyle")}
options={artStyleOptions}
value={store.artStyle}
onChange={(v) => store.set("artStyle", v as ArtStyle)}
/>
</div>
<Input
label={t("editor.versionInfo")}
placeholder={t("editor.versionInfoPlaceholder")}
value={store.versionInfo}
onChange={(e) => store.set("versionInfo", e.target.value)}
/>
</>
)}
</div>
);
}
@@ -0,0 +1,68 @@
import { useTranslation } from "react-i18next";
import { Input } from "@components/ui/Input";
import { useEditorStore } from "@store/editor-store";
/**
* Vietnam-specific donate fields — bank transfer + e-wallets. The
* `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ` description block only renders when
* the output language is Vietnamese, so the help text below the section
* label flags that condition for creators who occasionally publish in
* English / Japanese / etc.
*
* The fields are always visible in the editor regardless of the active
* 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.
*/
export function VietnameseDonateEditor() {
const { t } = useTranslation("ui");
const store = useEditorStore();
return (
<div className="flex flex-col gap-3">
<div className="flex flex-col gap-1">
<span className="text-sm font-medium text-text-secondary">
{t("editor.vnDonate")}
</span>
<p className="text-xs text-text-muted">{t("editor.vnDonateHelp")}</p>
</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)}
/>
<Input
label={t("editor.vnBankAccount")}
placeholder={t("editor.vnBankAccountPlaceholder")}
value={store.vnBankAccount ?? ""}
onChange={(e) => store.set("vnBankAccount", e.target.value)}
/>
</div>
<Input
label={t("editor.vnBankHolder")}
placeholder={t("editor.vnBankHolderPlaceholder")}
value={store.vnBankHolder ?? ""}
onChange={(e) => store.set("vnBankHolder", e.target.value)}
/>
<div className="grid grid-cols-2 gap-3">
<Input
label={t("editor.vnMomo")}
placeholder={t("editor.vnMomoPlaceholder")}
value={store.vnMomo ?? ""}
onChange={(e) => store.set("vnMomo", e.target.value)}
/>
<Input
label={t("editor.vnZalopay")}
placeholder={t("editor.vnZalopayPlaceholder")}
value={store.vnZalopay ?? ""}
onChange={(e) => store.set("vnZalopay", e.target.value)}
/>
</div>
</div>
);
}
-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>
);
}
+23 -7
View File
@@ -1,26 +1,42 @@
import { useState } from "react";
import { Outlet } from "react-router-dom";
import { Header } from "./Header";
import { TabBar } from "./TabBar";
import { Sidebar, SidebarNavList } from "./Sidebar";
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 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 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)} />
</div>
);
+70 -32
View File
@@ -1,12 +1,17 @@
import { useState, useRef, useEffect } from "react";
import { useTranslation } from "react-i18next";
import { ChevronDown } from "lucide-react";
import { ChevronDown, Heart, Menu } 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 [open, setOpen] = useState(false);
@@ -32,37 +37,70 @@ 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>
<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>
);
+131
View File
@@ -0,0 +1,131 @@
import { NavLink } from "react-router-dom";
import { useTranslation } from "react-i18next";
import {
Pencil,
FileText,
User,
Clock,
Settings,
Layers,
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: "/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>
);
+28 -2
View File
@@ -5,6 +5,8 @@ import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { useCurrentGeneratorInput } from "@hooks/use-current-generator-input";
import { buildPinnedComment } from "@engine/pinned-comment-builder";
import { GENRES } from "@config/genres";
import type { Genre } from "@engine/types";
import { CopyButton } from "./CopyButton";
/**
@@ -24,13 +26,37 @@ export function OutputExtras() {
const pinnedComment = useEditorStore((s) => s.pinnedComment);
const showPinnedCommentTemplate = useSettingsStore((s) => s.showPinnedCommentTemplate);
const includeAskNextGame = useSettingsStore((s) => s.pinnedCommentIncludeAskNextGame);
const includeGenrePlaylist = useSettingsStore(
(s) => s.pinnedCommentIncludeGenrePlaylist,
);
const genrePlaylists = useSettingsStore((s) => s.genrePlaylists);
const input = useCurrentGeneratorInput();
// Resolve genre labels via the UI-namespace translator. The pinned-comment
// builder is config-free by design — labels come in pre-resolved.
const genreLabels = useMemo(() => {
const map: Partial<Record<Genre, string>> = {};
for (const g of GENRES) map[g.id as Genre] = t(g.labelKey);
return map;
}, [t]);
const templateText = useMemo(() => {
if (!showPinnedCommentTemplate) return "";
const tFn = i18n.getFixedT(input.language, "templates");
return buildPinnedComment(input, tFn, { includeAskNextGame });
}, [showPinnedCommentTemplate, input, includeAskNextGame]);
return buildPinnedComment(input, tFn, {
includeAskNextGame,
includeGenrePlaylist,
genrePlaylists,
genreLabels,
});
}, [
showPinnedCommentTemplate,
input,
includeAskNextGame,
includeGenrePlaylist,
genrePlaylists,
genreLabels,
]);
const hasThumbnail = thumbnailText && thumbnailText.trim() !== "";
const hasPinned = pinnedComment && pinnedComment.trim() !== "";
+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">
+1
View File
@@ -27,6 +27,7 @@ export function ProfileCard({ profile }: ProfileCardProps) {
resolution: profile.resolution,
fps: profile.fps,
graphicsPreset: profile.graphicsPreset,
thirdPartyAdText: profile.thirdPartyAdText ?? "",
});
};
+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>
@@ -36,9 +36,23 @@ export function TemplateSaveForm({ open, onClose }: TemplateSaveFormProps) {
dlcName: editor.dlcName,
challengeName: editor.challengeName,
modName: editor.modName,
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,
graphicsPresetCustom: editor.graphicsPresetCustom,
skipGraphicsSettings: editor.skipGraphicsSettings,
rayTracingModes: [...editor.rayTracingModes],
frameGenVendor: editor.frameGenVendor,
frameGenMultiplier: editor.frameGenMultiplier,
upscaleQuality: editor.upscaleQuality,
artStyle: editor.artStyle,
versionInfo: editor.versionInfo,
timestamps: editor.timestamps,
playlistLink: editor.playlistLink,
contactEmail: editor.contactEmail,
@@ -47,10 +61,25 @@ export function TemplateSaveForm({ open, onClose }: TemplateSaveFormProps) {
pinnedComment: editor.pinnedComment,
spoilerWarning: editor.spoilerWarning,
matureWarning: editor.matureWarning,
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 },
rig: { ...editor.rig },
vnBankName: editor.vnBankName,
vnBankAccount: editor.vnBankAccount,
vnBankHolder: editor.vnBankHolder,
vnMomo: editor.vnMomo,
vnZalopay: editor.vnZalopay,
};
addTemplate(name, snapshot);
toast.success(t("templates.savedAs", { name: name.trim() || "Untitled" }));
+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>(
+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,
)}
+20 -2
View File
@@ -1,4 +1,4 @@
import { useState, useCallback } from "react";
import { useState, useCallback, type ClipboardEvent } from "react";
import { useTranslation } from "react-i18next";
import type { ValidationResult } from "@utils/validation";
import clsx from "clsx";
@@ -10,6 +10,16 @@ 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
* `extractGameNameFromUrl`. The handler runs alongside the normal paste
* flow; nothing here interferes with the value committed via onChange.
*/
onPaste?: (e: ClipboardEvent<HTMLInputElement>) => void;
}
export function ValidatedInput({
@@ -19,6 +29,10 @@ export function ValidatedInput({
validate,
placeholder,
helpText,
inputMode,
autoComplete,
enterKeyHint,
onPaste,
}: ValidatedInputProps) {
const { t } = useTranslation("ui");
const [displayValue, setDisplayValue] = useState(value);
@@ -58,9 +72,13 @@ export function ValidatedInput({
value={displayValue}
onChange={(e) => handleChange(e.target.value)}
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",
)}
/>
+43
View File
@@ -0,0 +1,43 @@
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",
// v0.14: pc_spec.md + dev_env.md merged into DEVELOPMENT.md.
// The two URL fields are kept for backwards compatibility with the About
// page layout — `pcSpecDocUrl` now points to the EN guide, `devEnvDocUrl`
// to the VI mirror.
pcSpecDocUrl: "https://github.com/poli0981/youtube-generator/blob/main/docs/DEVELOPMENT.md",
devEnvDocUrl: "https://github.com/poli0981/youtube-generator/blob/main/docs/i18n/vi/DEVELOPMENT.md",
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;
+163
View File
@@ -0,0 +1,163 @@
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",
"loud_noises",
"strobe_effects",
"screen_shake_intense",
],
},
{
id: "phobias",
labelKey: "editor.contentWarningGroups.phobias",
items: [
"jump_scares",
"acrophobia",
"trypophobia",
"thalassophobia",
"claustrophobia",
"arachnophobia",
"entomophobia",
"ophidiophobia",
"cynophobia",
"nyctophobia",
"pyrophobia",
"pediophobia",
"hemophobia",
"coulrophobia",
"ablutophobia",
"taphophobia",
],
},
{
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: "sensitive",
labelKey: "editor.contentWarningGroups.sensitive",
items: [
"blood_gore",
"mature_18plus",
"disturbing_imagery",
"animal_abuse",
"child_harm",
"domestic_violence",
"sexual_assault",
"torture",
"religion_themes",
"war_violence",
"discrimination",
"police_violence",
"smoking_drinking",
"detailed_killing",
"cult_occult",
"psychological_manipulation",
"grief_loss",
"kidnapping",
"hate_speech",
"historical_atrocity",
"slavery_themes",
"terrorism_themes",
"bullying_themes",
"human_experimentation",
"cannibalism",
"nuclear_themes",
],
},
{
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"],
},
] as const;
+107 -2
View File
@@ -1,11 +1,23 @@
import type { VideoTypeId } from "./video-types";
import type { GenreId } from "./genres";
import type {
GraphicsPreset,
RTMode,
FrameGenVendor,
FrameGenMultiplier,
UpscaleQuality,
ArtStyle,
} from "./graphics-settings";
import { DEFAULT_GACHA_QUEST_TYPE, type GachaQuestType } from "./gacha-quest-types";
import type {
SupportedLanguage,
StoreLinkType,
PlaythroughStatus,
DifficultyLevel,
ContentWarning,
LanguagePatch,
GameVersion,
TechNote,
} from "@engine/types";
export interface EditorDefaults {
@@ -21,27 +33,90 @@ export interface EditorDefaults {
dlcName: string;
challengeName: string;
modName: string;
/** Long-form mod credit list (multi-line) — only rendered for `mods` videoType. */
modList: string;
/** Livestream-only: live URL on YouTube/Twitch. */
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: string;
graphicsPreset: GraphicsPreset;
graphicsPresetCustom: string;
skipGraphicsSettings: boolean;
rayTracingModes: RTMode[];
frameGenVendor: FrameGenVendor;
frameGenMultiplier: FrameGenMultiplier;
upscaleQuality: UpscaleQuality;
artStyle: ArtStyle;
versionInfo: string;
timestamps: string;
playlistLink: string;
contactEmail: string;
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). */
endingsShown: string;
/** 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>;
rig: Record<string, string>;
/** Vietnam-specific donate: bank transfer + e-wallet fields. Only
* rendered into the description when output language is Vietnamese. */
vnBankName: string;
vnBankAccount: string;
vnBankHolder: string;
vnMomo: string;
vnZalopay: string;
}
export interface SettingsDefaults {
@@ -64,15 +139,34 @@ export const DEFAULTS = {
dlcName: "",
challengeName: "",
modName: "",
modList: "",
liveUrl: "",
scheduledTime: "",
gachaQuestType: DEFAULT_GACHA_QUEST_TYPE,
chapterName: "",
questName: "",
characterName: "",
anniversaryYear: null,
gachaVersion: "",
resolution: "1080p",
fps: "60",
graphicsPreset: "Ultra",
graphicsPreset: "medium",
graphicsPresetCustom: "",
skipGraphicsSettings: false,
rayTracingModes: [],
frameGenVendor: "none",
frameGenMultiplier: "none",
upscaleQuality: "none",
artStyle: "none",
versionInfo: "",
timestamps: "",
playlistLink: "",
contactEmail: "",
musicAttribution: "",
sponsorName: "",
sponsorPlatform: "",
pubDevName: "",
thirdPartyAdText: "",
thumbnailText: "",
pinnedComment: "",
spoilerWarning: false,
@@ -80,11 +174,22 @@ export const DEFAULTS = {
playthroughStatus: "none",
difficulty: "none",
difficultyCustomLabel: "",
endingsShown: "",
languagePatch: "none",
languagePatchCustom: "",
gameVersion: "full_release",
gameVersionCustom: "",
contentWarnings: [],
techNotes: [],
storeLinks: {},
storeLinkTypes: {},
social: {},
rig: {},
vnBankName: "",
vnBankAccount: "",
vnBankHolder: "",
vnMomo: "",
vnZalopay: "",
} satisfies EditorDefaults,
settings: {
+22
View File
@@ -0,0 +1,22 @@
/**
* Donate / support links surfaced on the About page and via the persistent
* Donate button in the Header.
*
* Mirrors `.github/FUNDING.yml` so GitHub's "Sponsor this project" picker
* and the in-app surface stay aligned. Update both files together.
*/
export const DONATE = {
githubSponsors: "https://github.com/sponsors/poli0981",
kofi: "https://ko-fi.com/skullmute",
buyMeACoffee: "https://buymeacoffee.com/skullmute",
patreon: "https://www.patreon.com/skullmute",
paypal: "https://paypal.me/DungDang212",
} as const;
export type DonateId = keyof typeof DONATE;
/**
* Single "primary" link the Header button points at. Ko-fi has no account
* gate and lowest friction — change here to swap the Header default.
*/
export const PRIMARY_DONATE_URL = DONATE.kofi;
+215
View File
@@ -0,0 +1,215 @@
/**
* Gacha-game quest taxonomy (v0.9 phase 1). One literal union covering
* the 17 quest patterns we see across major gacha titles — Genshin,
* Honkai: Star Rail, Wuthering Waves, ZZZ, Honkai Impact 3rd, Reverse
* 1999, Nikke, Azur Lane, Granblue, etc. Game-specific names like
* "Archon Quest" (Genshin) or "Trailblaze Mission" (HSR) collapse into
* `main_story`; "Hangout" / "Agent Story" collapse into
* `companion_quest`; "Spiral Abyss" / "Memory of Chaos" / "Tower of
* Adversity" / "Shiyu Defense" all collapse into `endgame`.
*
* Order matters: this is also the dropdown rendering order in the
* editor, grouped by use case (story → events → tutorial/trial →
* endgame/multiplayer → showcase).
*/
export const GACHA_QUEST_TYPES = [
// Story (6)
"main_story",
"world_quest",
"side_quest",
"spinoff_quest",
"companion_quest",
"bond_quest",
// Events (4)
"event",
"anniversary",
"crossover",
"dating_event",
// Tutorial / Trial (3)
"tutorial_quest",
"guide_quest",
"trial_quest",
// Endgame / Multiplayer (3)
"endgame",
"coop",
"daily_commission",
// Showcase (1)
"showcase",
] as const;
export type GachaQuestType = (typeof GACHA_QUEST_TYPES)[number];
export const DEFAULT_GACHA_QUEST_TYPE: GachaQuestType = "main_story";
export type GachaQuestTypeGroup =
| "story"
| "events"
| "tutorial_trial"
| "endgame_multiplayer"
| "showcase";
/**
* Display-order grouping for the quest-type dropdown. Each group
* surfaces a small heading (i18n: `editor.gachaQuestTypeGroups.<id>`)
* above its members.
*/
export const GACHA_QUEST_TYPE_GROUPS: ReadonlyArray<{
group: GachaQuestTypeGroup;
members: readonly GachaQuestType[];
}> = [
{
group: "story",
members: [
"main_story",
"world_quest",
"side_quest",
"spinoff_quest",
"companion_quest",
"bond_quest",
],
},
{
group: "events",
members: ["event", "anniversary", "crossover", "dating_event"],
},
{
group: "tutorial_trial",
members: ["tutorial_quest", "guide_quest", "trial_quest"],
},
{
group: "endgame_multiplayer",
members: ["endgame", "coop", "daily_commission"],
},
{
group: "showcase",
members: ["showcase"],
},
];
/**
* `partNumber` rendering style per quest type. Title-builder consumes
* this to decide whether the title's part-suffix reads "Part N", "Day
* N", "Floor N", or is dropped entirely. The four values map to
* `title.gachaPartSuffix.{part|day|floor}` translation keys; `none`
* skips the suffix.
*/
export type GachaPartSuffixStyle = "part" | "day" | "floor" | "none";
export const GACHA_PART_SUFFIX_STYLES: Record<GachaQuestType, GachaPartSuffixStyle> = {
main_story: "part",
world_quest: "none",
side_quest: "none",
spinoff_quest: "none",
companion_quest: "none",
bond_quest: "none",
event: "none",
anniversary: "day",
crossover: "none",
dating_event: "none",
tutorial_quest: "none",
guide_quest: "none",
trial_quest: "none",
endgame: "floor",
coop: "none",
daily_commission: "day",
showcase: "none",
};
/**
* Quest-type → which extra fields to render in the Gacha-quest editor
* (v0.13). Keeps the `extra-fields` UI surgical: Showcase replaces
* Chapter/Quest with Character Name, Anniversary swaps the part-number
* input for a 1–20 year dropdown, and the rest fall back to the default
* Chapter/Quest/Part triplet. `gachaVersion` is always shown for the
* `gacha_quest` video type, regardless of the selected quest type — it
* applies broadly (game patch labels like "1.2", "2.4").
*/
export interface GachaQuestFieldVisibility {
chapterName: boolean;
questName: boolean;
partNumber: boolean;
characterName: boolean;
anniversaryYear: boolean;
}
const DEFAULT_FIELD_VISIBILITY: GachaQuestFieldVisibility = {
chapterName: true,
questName: true,
partNumber: true,
characterName: false,
anniversaryYear: false,
};
export const GACHA_QUEST_FIELD_VISIBILITY: Record<
GachaQuestType,
GachaQuestFieldVisibility
> = {
main_story: { ...DEFAULT_FIELD_VISIBILITY, questName: false },
world_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
side_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
spinoff_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
companion_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
bond_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
event: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
anniversary: {
chapterName: false,
questName: false,
partNumber: true,
characterName: false,
anniversaryYear: true,
},
crossover: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
dating_event: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
tutorial_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
guide_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
trial_quest: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
endgame: { ...DEFAULT_FIELD_VISIBILITY, questName: false },
coop: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, partNumber: false },
daily_commission: { ...DEFAULT_FIELD_VISIBILITY, chapterName: false, questName: false },
showcase: {
chapterName: false,
questName: false,
partNumber: false,
characterName: true,
anniversaryYear: false,
},
};
/**
* Per-quest-type placeholder hints for Chapter Name / Quest Name / Part
* Number inputs (v0.13 QoL). Surfaces concrete examples so creators
* don't have to guess what each field expects under different quest
* patterns. Translated via `editor.placeholders.questType.<id>.<field>`
* — fall back to the static defaults when the locale lacks the override.
*/
export interface GachaQuestPlaceholders {
chapterName?: string;
questName?: string;
partNumber?: string;
}
export const GACHA_QUEST_PLACEHOLDERS: Record<GachaQuestType, GachaQuestPlaceholders> = {
main_story: {
chapterName: "e.g. Chapter 5 Act 2",
partNumber: "e.g. Part 1",
},
world_quest: { questName: "e.g. The Hidden Path" },
side_quest: { questName: "e.g. A Solitary Constellation" },
spinoff_quest: { questName: "e.g. The Tale of Wuthering Waves" },
companion_quest: { questName: "e.g. Yelan: Path of Stillness" },
bond_quest: { questName: "e.g. Trust Mission - Hina" },
event: { questName: "e.g. Summer Festival 2024" },
anniversary: { partNumber: "Day 1, Day 7, etc." },
crossover: { questName: "e.g. Honkai x Genshin Crossover" },
dating_event: { questName: "e.g. Date with Furina" },
tutorial_quest: { questName: "e.g. First Steps in Teyvat" },
guide_quest: { questName: "e.g. How to upgrade artifacts" },
trial_quest: { questName: "e.g. Adventure Trial - Diluc" },
endgame: {
chapterName: "e.g. Spiral Abyss / Memory of Chaos",
partNumber: "Floor 12, Floor 11",
},
coop: { questName: "e.g. Co-op Boss Run" },
daily_commission: { partNumber: "Day 1, Day 12, etc." },
showcase: {},
};
+29
View File
@@ -44,3 +44,32 @@ export const GENRES = [
] as const;
export type GenreId = (typeof GENRES)[number]["id"];
/**
* Ids for the bulk-select buttons rendered above the genre chip group.
* Each id maps to a curated set of genres in {@link GENRE_GROUPS} and
* an i18n label under `editor.genreGroups.<id>`.
*/
export type GenreGroupId = "rpg" | "shooter" | "horror";
/**
* Bulk-toggle groups (v0.9 phase 2). Clicking the group's button
* REPLACES the current selection with the first {@link MAX_GENRES} ids
* from the list (so the selection stays under the cap regardless of
* how big the group is). Order in each list determines which ids get
* picked when the group exceeds the cap.
*/
export const GENRE_GROUPS: Record<GenreGroupId, readonly GenreId[]> = {
rpg: ["rpg", "jrpg", "action_rpg", "crpg"],
shooter: [
"fps",
"arena_shooter",
"tactical_fps",
"boomer_shooter",
"extraction_shooter",
"shmup",
],
horror: ["horror", "survival_horror", "psychological_horror"],
};
export const GENRE_GROUP_IDS: readonly GenreGroupId[] = ["rpg", "shooter", "horror"];
+265
View File
@@ -0,0 +1,265 @@
/**
* GPU catalog for the My Rig editor (v0.13). Three-level taxonomy:
*
* Brand → Series → Model
*
* The cascading-dropdown UI in {@link RigEditor} stores the user's
* choice as a pipe-delimited string `"<brandId>|<seriesId>|<model>"` so
* the rig store stays a flat `Record<string, string>` (no schema
* migration vs. v0.12). The third segment is the verbatim model display
* string — it's stored as-is so we never need a reverse lookup table to
* render the value back into the description output.
*
* Backward-compatibility: pre-v0.13 rigs persisted GPU as free-form text
* (`"NVIDIA RTX 4090"`). Those values lack pipes, so `formatRigValue`
* passes them through unchanged, and the editor renders them under the
* `custom` brand for further editing.
*
* Scope: ambitious — covers the GPUs viewers commonly own in 2026,
* which still includes 10+ years of legacy NVIDIA / AMD parts because
* gameplay-no-commentary audiences run a wide spread of hardware ages.
*
* Apple Silicon is included for creators who edit on Mac and want their
* rig listing to reflect that, even though Apple chips aren't really
* "gaming GPUs" in the discrete-card sense.
*/
export interface GpuSeries {
/** Stable id used in the storage tuple (`<brandId>|<seriesId>|<model>`). */
readonly id: string;
readonly label: string;
/** Free-form display strings — stored verbatim as the model segment. */
readonly models: readonly string[];
}
export interface GpuBrand {
readonly id: string;
readonly label: string;
readonly series: readonly GpuSeries[];
}
export type GpuCatalog = readonly GpuBrand[];
const NVIDIA_SERIES: readonly GpuSeries[] = [
{
id: "rtx_50",
label: "RTX 50 Series",
models: ["RTX 5050", "RTX 5060", "RTX 5060 Ti", "RTX 5070", "RTX 5070 Ti", "RTX 5080", "RTX 5090"],
},
{
id: "rtx_40",
label: "RTX 40 Series",
models: [
"RTX 4050 (laptop)",
"RTX 4060",
"RTX 4060 Ti",
"RTX 4070",
"RTX 4070 SUPER",
"RTX 4070 Ti",
"RTX 4070 Ti SUPER",
"RTX 4080",
"RTX 4080 SUPER",
"RTX 4090",
],
},
{
id: "rtx_30",
label: "RTX 30 Series",
models: [
"RTX 3050",
"RTX 3050 6GB",
"RTX 3060",
"RTX 3060 Ti",
"RTX 3070",
"RTX 3070 Ti",
"RTX 3080",
"RTX 3080 12GB",
"RTX 3080 Ti",
"RTX 3090",
"RTX 3090 Ti",
],
},
{
id: "rtx_20",
label: "RTX 20 Series",
models: [
"RTX 2060",
"RTX 2060 SUPER",
"RTX 2070",
"RTX 2070 SUPER",
"RTX 2080",
"RTX 2080 SUPER",
"RTX 2080 Ti",
"TITAN RTX",
],
},
{
id: "gtx_16",
label: "GTX 16 Series",
models: ["GTX 1630", "GTX 1650", "GTX 1650 SUPER", "GTX 1660", "GTX 1660 SUPER", "GTX 1660 Ti"],
},
{
id: "gtx_10",
label: "GTX 10 Series",
models: [
"GTX 1050",
"GTX 1050 Ti",
"GTX 1060 3GB",
"GTX 1060 6GB",
"GTX 1070",
"GTX 1070 Ti",
"GTX 1080",
"GTX 1080 Ti",
"TITAN Xp",
],
},
{
id: "gtx_900",
label: "GTX 900 Series",
models: ["GTX 950", "GTX 960", "GTX 970", "GTX 980", "GTX 980 Ti", "TITAN X (Maxwell)"],
},
{
id: "gtx_700",
label: "GTX 700 Series",
models: ["GTX 750", "GTX 750 Ti", "GTX 760", "GTX 770", "GTX 780", "GTX 780 Ti", "TITAN Black"],
},
];
const AMD_SERIES: readonly GpuSeries[] = [
{
id: "rx_9000",
label: "Radeon RX 9000",
models: ["RX 9060", "RX 9060 XT", "RX 9070", "RX 9070 XT", "RX 9080", "RX 9090 XT"],
},
{
id: "rx_7000",
label: "Radeon RX 7000",
models: [
"RX 7600",
"RX 7600 XT",
"RX 7700 XT",
"RX 7800 XT",
"RX 7900 GRE",
"RX 7900 XT",
"RX 7900 XTX",
],
},
{
id: "rx_6000",
label: "Radeon RX 6000",
models: [
"RX 6400",
"RX 6500 XT",
"RX 6600",
"RX 6600 XT",
"RX 6650 XT",
"RX 6700",
"RX 6700 XT",
"RX 6750 XT",
"RX 6800",
"RX 6800 XT",
"RX 6900 XT",
"RX 6950 XT",
],
},
{
id: "rx_5000",
label: "Radeon RX 5000",
models: ["RX 5500", "RX 5500 XT", "RX 5600", "RX 5600 XT", "RX 5700", "RX 5700 XT"],
},
{
id: "rx_vega",
label: "Radeon RX Vega",
models: ["RX Vega 56", "RX Vega 64", "Radeon VII"],
},
{
id: "rx_500",
label: "Radeon RX 500",
models: ["RX 550", "RX 560", "RX 570", "RX 580", "RX 590"],
},
{
id: "rx_400",
label: "Radeon RX 400",
models: ["RX 460", "RX 470", "RX 480"],
},
{
id: "r9_300",
label: "Radeon R7/R9 300",
models: ["R7 360", "R7 370", "R9 380", "R9 380X", "R9 390", "R9 390X", "R9 Fury", "R9 Fury X", "R9 Nano"],
},
{
id: "r9_200",
label: "Radeon R7/R9 200",
models: ["R7 250", "R7 260", "R7 260X", "R9 270", "R9 270X", "R9 280", "R9 280X", "R9 290", "R9 290X"],
},
{
id: "hd_7000",
label: "Radeon HD 7000",
models: ["HD 7750", "HD 7770", "HD 7850", "HD 7870", "HD 7950", "HD 7970"],
},
];
const INTEL_SERIES: readonly GpuSeries[] = [
{
id: "arc_b",
label: "Arc B Series (Battlemage)",
models: ["Arc B380", "Arc B570", "Arc B580"],
},
{
id: "arc_a",
label: "Arc A Series (Alchemist)",
models: ["Arc A310", "Arc A380", "Arc A580", "Arc A750", "Arc A770"],
},
];
const APPLE_SERIES: readonly GpuSeries[] = [
{
id: "m4",
label: "Apple M4",
models: ["M4", "M4 Pro", "M4 Max"],
},
{
id: "m3",
label: "Apple M3",
models: ["M3", "M3 Pro", "M3 Max", "M3 Ultra"],
},
{
id: "m2",
label: "Apple M2",
models: ["M2", "M2 Pro", "M2 Max", "M2 Ultra"],
},
{
id: "m1",
label: "Apple M1",
models: ["M1", "M1 Pro", "M1 Max", "M1 Ultra"],
},
];
export const GPU_CATALOG: GpuCatalog = [
{ id: "nvidia", label: "NVIDIA", series: NVIDIA_SERIES },
{ id: "amd", label: "AMD", series: AMD_SERIES },
{ id: "intel", label: "Intel", series: INTEL_SERIES },
{ id: "apple", label: "Apple Silicon", series: APPLE_SERIES },
{ id: "custom", label: "Custom", series: [] },
];
/** Stable signal that the user picked the free-text fallback. */
export const GPU_CUSTOM_BRAND_ID = "custom";
/**
* Lookup a brand by id without throwing. Returns `undefined` for unknown
* ids so callers can render a graceful fallback (legacy free-text values
* round-trip without exploding).
*/
export function findGpuBrand(brandId: string): GpuBrand | undefined {
return GPU_CATALOG.find((b) => b.id === brandId);
}
/**
* Lookup a series within a known brand. Returns `undefined` for both
* unknown brand and unknown series; the caller decides whether to clear
* the downstream model selection or preserve it.
*/
export function findGpuSeries(brandId: string, seriesId: string): GpuSeries | undefined {
return findGpuBrand(brandId)?.series.find((s) => s.id === seriesId);
}
+108
View File
@@ -0,0 +1,108 @@
import type { GenreId } from "./genres";
/**
* Graphics-quality preset ladder. Mirrors the most common in-game preset
* names across Unreal/Unity/proprietary engines. `"custom"` reveals a
* free-form text field for games whose preset names don't fit the ladder
* (e.g. "Epic", "Maximum", "Insane") — same escape-hatch pattern as the
* v0.7 difficulty `"custom"` option.
*
* Default: `"medium"` (a sensible neutral starting point for new drafts).
*/
export const GRAPHICS_PRESETS = [
"low",
"medium",
"high",
"very_high",
"cinematic",
"ultra",
"extreme",
"custom",
] as const;
export type GraphicsPreset = (typeof GRAPHICS_PRESETS)[number];
/**
* Ray-tracing modes. Multi-select — modern AAA games can ship with several
* of these layered (e.g. Path Tracing + Ray Reconstruction + Frame
* Generation). Empty array → no RT clause in the description.
*/
export const RT_MODES = [
"ray_tracing",
"full_rt",
"path_tracing",
"ray_reconstruction",
] as const;
export type RTMode = (typeof RT_MODES)[number];
/**
* GPU vendor whose upscaling / frame-gen tech the creator used. Single
* vendor field on purpose — most builds run a single vendor's stack
* (NVIDIA → DLSS, AMD → FSR, Intel → XeSS). `"none"` skips the modifier
* entirely.
*/
export const FRAMEGEN_VENDORS = ["none", "nvidia", "amd", "intel"] as const;
export type FrameGenVendor = (typeof FRAMEGEN_VENDORS)[number];
/**
* Frame-generation multiplier — DLSS 4 supports up to x4, FSR 3 up to x3,
* Intel XeFG is ramping up. `"none"` means upscaling is in use but frame
* generation isn't; useful for builds where DLSS Quality is enabled but
* FG was left off.
*/
export const FRAMEGEN_MULTIPLIERS = ["none", "x2", "x3", "x4", "x6"] as const;
export type FrameGenMultiplier = (typeof FRAMEGEN_MULTIPLIERS)[number];
/**
* Upscaling-quality preset across DLSS Super Resolution / FSR / XeSS.
* The actual brand name is rendered from {@link FRAMEGEN_VENDORS}; this
* enum carries the quality dimension only.
*
* v0.11 expansion: `dlaa` (NVIDIA's anti-aliasing-only mode, distinct from
* the brand-agnostic `native_aa`) and `ultra_quality` (XeSS's highest
* quality tier) joined the ladder. Vendor-aware filtering happens in the
* UI / engine via {@link getValidUpscaleQualities} — this enum stays flat.
*/
export const UPSCALE_QUALITIES = [
"none",
"native_aa",
"dlaa",
"ultra_quality",
"quality",
"balanced",
"performance",
"ultra_performance",
] as const;
export type UpscaleQuality = (typeof UPSCALE_QUALITIES)[number];
/**
* High-level visual style of the game. Optional context for viewers
* scanning the description — particularly useful for indie titles where
* "Pixel Art" or "Hand-drawn" is part of the appeal. `"none"` skips the
* art-style line.
*/
export const ART_STYLES = [
"none",
"realistic",
"stylized",
"anime",
"cel_shaded",
"low_poly",
"voxel",
"pixel_art",
"hand_drawn",
"comic",
"photorealistic",
] as const;
export type ArtStyle = (typeof ART_STYLES)[number];
/**
* Genres where in-game graphics settings are typically absent — used by
* the editor to surface a one-time "Hide graphics settings?" suggestion
* chip. The user always has the final say via the manual `skipGraphicsSettings`
* toggle; this list only seeds the hint.
*/
export const GENRES_WITHOUT_GRAPHICS_SETTINGS: readonly GenreId[] = [
"visual_novel",
"fmv",
"rhythm",
] as const;
+11
View File
@@ -87,6 +87,17 @@ export const PLATFORMS: readonly PlatformConfig[] = [
urlPrefix: "https://www.amazon.com/luna/",
urlPattern: /^https:\/\/www\.amazon\.com\/[^\s]+$/i,
},
{
// Catch-all for indie / niche releases distributed only from a
// publisher's or developer's own site. Pattern is intentionally
// loose (any HTTPS URL with a host) — these sites don't share a
// common shape, and tightening the regex would just lock real
// links out of the description.
id: "publisher",
label: "Publisher / Developer site",
urlPrefix: "https://",
urlPattern: /^https:\/\/[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+(?:\/[^\s]*)?$/i,
},
] as const;
export type PlatformId = (typeof PLATFORMS)[number]["id"];
+51
View File
@@ -0,0 +1,51 @@
import {
LANGUAGE_PATCH_OPTIONS,
GAME_VERSION_OPTIONS,
type LanguagePatch,
type GameVersion,
} from "@engine/types";
/**
* UI-friendly option lists for the Playthrough Notes form (v0.12).
* Mirrors the const arrays from `@engine/types` but as `{ id, labelKey }`
* objects so Select renders both an i18n key and a stable value. The
* engine continues to read straight from the typed unions — these
* helpers exist purely so the editor doesn't repeat the i18n-key
* convention in every component.
*/
export interface PlaythroughOption<T extends string> {
id: T;
/** i18n key for the localised display label. */
labelKey: string;
}
export const LANGUAGE_PATCH_UI_OPTIONS: readonly PlaythroughOption<LanguagePatch>[] =
LANGUAGE_PATCH_OPTIONS.map((id) => ({
id,
labelKey: `editor.playthroughNotes.languagePatchOptions.${id}`,
}));
export const GAME_VERSION_UI_OPTIONS: readonly PlaythroughOption<GameVersion>[] =
GAME_VERSION_OPTIONS.map((id) => ({
id,
labelKey: `editor.playthroughNotes.gameVersionOptions.${id}`,
}));
/**
* Whether the language-patch enum value pairs with a free-form custom
* label slot (`languagePatchCustom`). True for `"official_other"` (e.g.
* "Official KR") and `"custom"` (everything else); false for the
* canonical EN / fan / MTL options whose labels come from i18n.
*/
export function languagePatchHasCustomSlot(value: LanguagePatch): boolean {
return value === "official_other" || value === "custom";
}
/**
* Whether the game-version enum value pairs with a free-form custom
* label slot (`gameVersionCustom`). Only `"custom"` does — used for
* niche cases like "Steam Next Fest demo", "Kickstarter backer build".
*/
export function gameVersionHasCustomSlot(value: GameVersion): boolean {
return value === "custom";
}
+207 -17
View File
@@ -1,3 +1,10 @@
import {
GPU_CATALOG,
GPU_CUSTOM_BRAND_ID,
findGpuBrand,
type GpuCatalog,
} from "./gpu-catalog";
/**
* Supported rig field input types.
*
@@ -6,8 +13,23 @@
* free-form version text input. The stored value is
* `"<option_value>|<version>"` so we don't break the flat
* `Partial<Record<string, string>>` rig shape in the editor store.
* - `cascading_dropdown` (v0.13): three-level Brand → Series → Model
* dropdown for GPU. Stored as `"<brand>|<series>|<model>"`. When
* brand = `"custom"`, the UI swaps to a single free-text input and
* stores `"custom||<freeText>"` (the model is the verbatim text the
* user typed). Pre-v0.13 free-text values lack pipes — they pass
* through `formatRigValue` unchanged so old profiles render the same
* string they did before.
* - `composite_dropdown` (v0.13): two-or-more dropdowns combined into
* one logical field. Used by RAM (size + DDR generation). Each part
* may opt into a free-text "Custom" override; the stored format is
* pipe-delimited in the order parts are declared.
*/
export type RigFieldType = "text" | "dropdown_with_version";
export type RigFieldType =
| "text"
| "dropdown_with_version"
| "cascading_dropdown"
| "composite_dropdown";
export interface RigFieldOption {
readonly value: string;
@@ -15,6 +37,29 @@ export interface RigFieldOption {
readonly label: string;
}
export interface CompositePart {
/** Stable id, used to assemble the storage tuple in declaration order. */
readonly id: string;
readonly labelKey: string;
readonly options: readonly RigFieldOption[];
/** When true, the part renders an extra free-text input when value === `"custom"`. */
readonly allowCustom?: boolean;
/** Suffix shown after the custom numeric input (e.g. " GB"). */
readonly customSuffix?: string;
/** Optional placeholder for the custom input. */
readonly customPlaceholder?: string;
}
export interface CompositeFieldSpec {
readonly parts: readonly CompositePart[];
/**
* Format the stored parts into the description-output string. Receives
* resolved labels (not raw ids) — for `custom` parts the resolved value
* is the free-text the user typed.
*/
readonly format: (resolvedParts: readonly string[]) => string;
}
export interface RigField {
readonly id: string;
readonly labelKey: string;
@@ -22,6 +67,10 @@ export interface RigField {
readonly placeholder?: string;
readonly options?: readonly RigFieldOption[];
readonly versionPlaceholder?: string;
/** Set when {@link type} is `"cascading_dropdown"`. */
readonly catalog?: GpuCatalog;
/** Set when {@link type} is `"composite_dropdown"`. */
readonly composite?: CompositeFieldSpec;
}
/**
@@ -45,10 +94,73 @@ export const VIDEO_EDITOR_OPTIONS: readonly RigFieldOption[] = [
{ value: "other", label: "Other" },
];
/** RAM size options in GB. `custom` opens a numeric free-text input. */
export const RAM_SIZE_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "4", label: "4 GB" },
{ value: "6", label: "6 GB" },
{ value: "8", label: "8 GB" },
{ value: "12", label: "12 GB" },
{ value: "16", label: "16 GB" },
{ value: "32", label: "32 GB" },
{ value: "64", label: "64 GB" },
{ value: "96", label: "96 GB" },
{ value: "128", label: "128 GB" },
{ value: "256", label: "256 GB" },
{ value: "custom", label: "Custom…" },
];
/** DDR generation. DDR1 stays in the list for legacy gear; users with
* unusual rigs (DDR6/DDR7) can pick early-spec options. */
export const RAM_DDR_OPTIONS: readonly RigFieldOption[] = [
{ value: "", label: "—" },
{ value: "DDR1", label: "DDR1" },
{ value: "DDR2", label: "DDR2" },
{ value: "DDR3", label: "DDR3" },
{ value: "DDR4", label: "DDR4" },
{ value: "DDR5", label: "DDR5" },
{ value: "DDR6", label: "DDR6" },
{ value: "DDR7", label: "DDR7" },
];
const RAM_COMPOSITE: CompositeFieldSpec = {
parts: [
{
id: "size",
labelKey: "editor.ram_size",
options: RAM_SIZE_OPTIONS,
allowCustom: true,
customSuffix: " GB",
customPlaceholder: "48",
},
{
id: "ddr",
labelKey: "editor.ram_ddr",
options: RAM_DDR_OPTIONS,
},
],
format: ([size = "", ddr = ""]) => {
if (!size && !ddr) return "";
if (!size) return ddr;
if (!ddr) return size;
return `${size} ${ddr}`;
},
};
export const RIG_FIELDS: readonly RigField[] = [
{ id: "cpu", labelKey: "rig.cpu", type: "text", placeholder: "Intel i9-14900K / AMD Ryzen 9 7950X" },
{ id: "gpu", labelKey: "rig.gpu", type: "text", placeholder: "NVIDIA RTX 4090 / AMD RX 7900 XTX" },
{ id: "ram", labelKey: "rig.ram", type: "text", placeholder: "32GB DDR5-6000" },
{
id: "gpu",
labelKey: "rig.gpu",
type: "cascading_dropdown",
catalog: GPU_CATALOG,
},
{
id: "ram",
labelKey: "rig.ram",
type: "composite_dropdown",
composite: RAM_COMPOSITE,
},
{ id: "storage", labelKey: "rig.storage", type: "text", placeholder: "2TB Samsung 990 PRO NVMe" },
{ id: "monitor", labelKey: "rig.monitor", type: "text", placeholder: "LG 27GP950 27\" 4K 144Hz" },
{ id: "capture", labelKey: "rig.capture", type: "text", placeholder: "OBS Studio 30.x" },
@@ -65,27 +177,105 @@ export const RIG_FIELDS: readonly RigField[] = [
export type RigFieldId = (typeof RIG_FIELDS)[number]["id"];
/**
* Parse a cascading-dropdown stored value into its three segments.
* Empty segments stay as empty strings. Pipeless legacy values are
* returned as `["", "", raw]` so the caller can render them under the
* Custom brand without losing the original text.
*/
export function parseCascadingValue(raw: string): {
brand: string;
series: string;
model: string;
isLegacy: boolean;
} {
if (!raw) return { brand: "", series: "", model: "", isLegacy: false };
if (!raw.includes("|")) {
// Pre-v0.13 free-text. Treat as Custom + verbatim model.
return { brand: GPU_CUSTOM_BRAND_ID, series: "", model: raw, isLegacy: true };
}
const [brand = "", series = "", model = ""] = raw.split("|");
return { brand, series, model, isLegacy: false };
}
/**
* Parse a composite-dropdown stored value into its segments. The order
* matches the parts declared on the field's {@link CompositeFieldSpec}.
* Pipeless legacy values are returned as a single-element tuple so the
* caller can render them as a fallback string.
*/
export function parseCompositeValue(raw: string): {
parts: readonly string[];
isLegacy: boolean;
} {
if (!raw) return { parts: [], isLegacy: false };
if (!raw.includes("|")) return { parts: [raw], isLegacy: true };
return { parts: raw.split("|"), isLegacy: false };
}
/**
* Format a stored rig value for display in the description output.
* For dropdown_with_version fields, this turns `"davinci_resolve_studio|19.1"`
* into `"DaVinci Resolve Studio 19.1"`. Other values pass through.
*
* - `dropdown_with_version` ("davinci_resolve_studio|19.1") →
* `"DaVinci Resolve Studio 19.1"`.
* - `cascading_dropdown` ("nvidia|rtx_40|RTX 4090") →
* `"NVIDIA RTX 4090"` (series label dropped — the model string is
* already verbose enough). Custom brand returns the verbatim model.
* Legacy pipeless values pass through unchanged.
* - `composite_dropdown` ("16|DDR5", "custom:48|DDR5") →
* `"16 GB DDR5"` / `"48 GB DDR5"` via the field's
* {@link CompositeFieldSpec.format}.
* - All other field types pass the raw value through.
*/
export function formatRigValue(fieldId: string, raw: string): string {
const field = RIG_FIELDS.find((f) => f.id === fieldId);
if (!field || field.type !== "dropdown_with_version") return raw;
if (!field) return raw;
const [value = "", version = ""] = raw.split("|");
const trimmedVersion = version.trim();
if (!value && !trimmedVersion) return "";
if (field.type === "dropdown_with_version") {
const [value = "", version = ""] = raw.split("|");
const trimmedVersion = version.trim();
if (!value && !trimmedVersion) return "";
// The empty-value sentinel option renders as "—" in the dropdown but
// should act as "no selection" in the output.
let label = "";
if (value) {
const option = field.options?.find((o) => o.value === value);
label = option?.label ?? value;
let label = "";
if (value) {
const option = field.options?.find((o) => o.value === value);
label = option?.label ?? value;
}
if (!label) return trimmedVersion;
return trimmedVersion ? `${label} ${trimmedVersion}` : label;
}
if (!label) return trimmedVersion;
return trimmedVersion ? `${label} ${trimmedVersion}` : label;
if (field.type === "cascading_dropdown") {
const { brand, model, isLegacy } = parseCascadingValue(raw);
if (isLegacy) return raw;
if (!brand && !model) return "";
if (brand === GPU_CUSTOM_BRAND_ID) return model.trim();
const brandLabel = findGpuBrand(brand)?.label ?? brand;
if (!model.trim()) return brandLabel;
return `${brandLabel} ${model.trim()}`;
}
if (field.type === "composite_dropdown" && field.composite) {
const { parts, isLegacy } = parseCompositeValue(raw);
if (isLegacy) return raw;
if (parts.length === 0) return "";
// Resolve each declared part. `custom:<value>` segments collapse to
// the free-text payload (without the `custom:` prefix).
const resolved = field.composite.parts.map((spec, i) => {
const stored = (parts[i] ?? "").trim();
if (!stored) return "";
if (spec.allowCustom && stored.startsWith("custom:")) {
const txt = stored.slice("custom:".length).trim();
return txt ? `${txt}${spec.customSuffix ?? ""}` : "";
}
const opt = spec.options.find((o) => o.value === stored);
return opt?.label ?? stored;
});
return field.composite.format(resolved);
}
return raw;
}
+77
View File
@@ -0,0 +1,77 @@
import type { TechNote } from "@engine/types";
/**
* UI grouping for the Tech Notes checklist (v0.12). Mirrors the shape
* of {@link CONTENT_WARNING_GROUPS} — flat array on the engine side,
* grouped here so 24+ items stay scannable in a collapsible UI.
*
* Add a new tech note by:
* 1. Appending the id to {@link TECH_NOTES} in `@engine/types`.
* 2. Adding it to one of these groups (UI placement only — engine
* renders bullets in the order the user picked them).
* 3. Translating `description.techNotes.items.{id}` in all locales
* + the editor's `editor.techNoteOptions.{id}` short label.
*/
export interface TechNoteGroup {
id: string;
/** i18n key for the group heading shown in the editor. */
labelKey: string;
items: TechNote[];
}
export const TECH_NOTE_GROUPS: readonly TechNoteGroup[] = [
{
id: "audio",
labelKey: "editor.techNoteGroups.audio",
items: [
"copyright_muted_sections",
"volume_reduced_copyright",
"music_replaced_copyright",
"cutscene_audio_muted_only",
"original_audio_kept",
],
},
{
id: "video_quality",
labelKey: "editor.techNoteGroups.video_quality",
items: [
"low_resolution_hardware",
"low_graphics_performance",
"fps_drops_hardware",
],
},
{
id: "recording_issues",
labelKey: "editor.techNoteGroups.recording_issues",
items: [
"bug_from_game",
"crash_kept_transparency",
"loading_cut",
"obs_artifacts_possible",
],
},
{
id: "playstyle",
labelKey: "editor.techNoteGroups.playstyle",
items: [
"not_no_hit_run",
"not_clean_walkthrough",
"casual_no_commentary",
"many_deaths_patience",
"slow_exploration",
"puzzle_stuck_possible",
"grinding_cut",
"not_speedrun_relaxed",
],
},
{
id: "production",
labelKey: "editor.techNoteGroups.production",
items: [
"exploration_focus_skip_combat",
"edited_for_pacing",
"support_developers",
"online_connectivity_issues",
],
},
] as const;
+116
View File
@@ -0,0 +1,116 @@
import pkg from "../../package.json";
interface ThirdPartyEntry {
readonly name: string;
readonly version: string;
readonly license: string;
readonly url: string;
}
const deps = pkg.dependencies as Record<string, string>;
const devDeps = pkg.devDependencies as Record<string, string>;
// Tiny lookup helper because tsconfig has `noUncheckedIndexedAccess`,
// which would otherwise type every `deps.foo` as `string | undefined`.
// `?` is a sentinel an upgrade is more likely to surface than a silent
// blank — easier to spot than an empty cell.
function v(map: Record<string, string>, key: string): string {
return map[key] ?? "?";
}
/**
* Credits surfaced on the About page. Versions are pulled from
* `package.json` so a `npm install <pkg>` keeps this list honest.
* License + URL are hardcoded (refresh on major upgrades).
*
* Listed in rough import-order: framework first, runtime libs next,
* tooling last.
*/
export const THIRD_PARTY: readonly ThirdPartyEntry[] = [
{
name: "React",
version: v(deps, "react"),
license: "MIT",
url: "https://react.dev/",
},
{
name: "react-dom",
version: v(deps, "react-dom"),
license: "MIT",
url: "https://react.dev/",
},
{
name: "react-router-dom",
version: v(deps, "react-router-dom"),
license: "MIT",
url: "https://reactrouter.com/",
},
{
name: "Zustand",
version: v(deps, "zustand"),
license: "MIT",
url: "https://zustand-demo.pmnd.rs/",
},
{
name: "i18next",
version: v(deps, "i18next"),
license: "MIT",
url: "https://www.i18next.com/",
},
{
name: "react-i18next",
version: v(deps, "react-i18next"),
license: "MIT",
url: "https://react.i18next.com/",
},
{
name: "react-hot-toast",
version: v(deps, "react-hot-toast"),
license: "MIT",
url: "https://react-hot-toast.com/",
},
{
name: "lucide-react",
version: v(deps, "lucide-react"),
license: "ISC",
url: "https://lucide.dev/",
},
{
name: "clsx",
version: v(deps, "clsx"),
license: "MIT",
url: "https://github.com/lukeed/clsx",
},
{
name: "Tauri",
version: v(deps, "@tauri-apps/api"),
license: "Apache-2.0 / MIT",
url: "https://tauri.app/",
},
{
name: "Vite",
version: v(devDeps, "vite"),
license: "MIT",
url: "https://vitejs.dev/",
},
{
name: "TypeScript",
version: v(devDeps, "typescript"),
license: "Apache-2.0",
url: "https://www.typescriptlang.org/",
},
{
name: "Tailwind CSS",
version: v(devDeps, "tailwindcss"),
license: "MIT",
url: "https://tailwindcss.com/",
},
{
name: "Vitest",
version: v(devDeps, "vitest"),
license: "MIT",
url: "https://vitest.dev/",
},
];
export type { ThirdPartyEntry };
+12
View File
@@ -17,6 +17,18 @@ export const VIDEO_TYPES = [
{ id: "guide", labelKey: "videoTypes.guide", icon: "📘", extraFields: [] },
{ id: "mods", labelKey: "videoTypes.mods", icon: "🧩", extraFields: ["modName"] },
{ id: "collectibles", labelKey: "videoTypes.collectibles", icon: "⭐", extraFields: [] },
{
id: "livestream",
labelKey: "videoTypes.livestream",
icon: "🔴",
extraFields: ["liveUrl", "scheduledTime"],
},
{
id: "gacha_quest",
labelKey: "videoTypes.gacha_quest",
icon: "🎴",
extraFields: ["gachaQuestType", "chapterName", "questName", "partNumber"],
},
] as const;
export type VideoTypeId = (typeof VIDEO_TYPES)[number]["id"];
+577 -46
View File
@@ -3,6 +3,8 @@ import { YT_LIMITS } from "./types";
import { PLATFORMS } from "@config/platforms";
import { SOCIAL_FIELDS } from "@config/social-fields";
import { formatRigValue } from "@config/rig-fields";
import { DEFAULT_GACHA_QUEST_TYPE } from "@config/gacha-quest-types";
import { ordinalSuffix } from "./title-builder";
import { parseTimeline, renderTimeline } from "./timeline-parser";
import { sanitizeHashtag } from "@utils/sanitize";
@@ -34,6 +36,149 @@ function getLabelForId(id: string, configs: readonly { id: string; label: string
return configs.find((c) => c.id === id)?.label ?? id;
}
/**
* Locale-aware short formatter for the livestream `scheduledTime` field.
* The editor stores ISO strings (`<input type="datetime-local">` output);
* we render them as "Sat, May 2, 8:00 PM" in en, and equivalent native
* forms elsewhere via `Intl.DateTimeFormat`. Falls back to the raw input
* if it can't be parsed — better than emitting "Invalid Date".
*/
function formatScheduledTime(iso: string, language: string): string {
const trimmed = iso.trim();
if (!trimmed) return "";
const date = new Date(trimmed);
if (Number.isNaN(date.getTime())) return trimmed;
try {
return new Intl.DateTimeFormat(language, {
weekday: "short",
month: "short",
day: "numeric",
hour: "numeric",
minute: "2-digit",
}).format(date);
} catch {
return trimmed;
}
}
/**
* Brand names by GPU vendor — kept in English on purpose. These are
* trademarked product names viewers are searching for verbatim ("DLSS",
* "FSR", "XeSS"); translating them would hurt SEO. Frame-gen branding
* is similarly fixed: "Frame Generation" (NVIDIA), "Fluid Motion Frames"
* (AMD's official term), "XeFG" (Intel's announced FG tech).
*/
const VENDOR_GFX_BRANDS: Record<
"nvidia" | "amd" | "intel",
{ upscale: string; framegen: string }
> = {
nvidia: { upscale: "NVIDIA DLSS", framegen: "NVIDIA Frame Generation" },
amd: { upscale: "AMD FSR", framegen: "AMD Fluid Motion Frames" },
intel: { upscale: "Intel XeSS", framegen: "Intel XeFG" },
};
/**
* Compose the value half of the "In-game Setting:" line — e.g.
* `Cinematic - NVIDIA Frame Generation x2 with Ray Tracing`.
*
* The `<label>: ` prefix is added by the caller (so the renderer can
* emit a multi-line block matching the rig / timestamps style). We drop
* the legacy "Setting" suffix here — having both the label AND a
* trailing "Setting" word read as redundant ("In-game Setting: Ultra
* Setting").
*
* Returns an empty string when nothing meaningful can be said (no preset
* label AND no modifiers AND no RT modes); the caller skips the line.
*/
function composeGraphicsPart(input: GeneratorInput, t: TranslationFn): string {
// 1. Preset label — `"custom"` reads from the free-form slot; everything
// else goes through i18n. Missing translation falls back to nothing
// rather than leaking the raw key.
let presetLabel = "";
if (input.graphicsPreset === "custom") {
presetLabel = (input.graphicsPresetCustom ?? "").trim();
} else if (input.graphicsPreset) {
const key = `description.graphics.presetOptions.${input.graphicsPreset}`;
const resolved = t(key);
if (resolved && resolved !== key) presetLabel = resolved;
}
// 2. Modifier (upscale + frame-gen). Vendor gates the whole clause —
// upscaling/frame-gen quality without a vendor is meaningless.
const vendor =
input.frameGenVendor && input.frameGenVendor !== "none"
? input.frameGenVendor
: null;
const upscaleQ =
input.upscaleQuality && input.upscaleQuality !== "none"
? input.upscaleQuality
: null;
const fgMul =
input.frameGenMultiplier && input.frameGenMultiplier !== "none"
? input.frameGenMultiplier
: null;
let modifier = "";
if (vendor) {
const brands = VENDOR_GFX_BRANDS[vendor];
const parts: string[] = [];
if (upscaleQ) {
// v0.11: try the vendor-keyed full label first ("NVIDIA DLAA",
// "AMD FSR Native AA", "Intel XeSS Ultra Quality"). Fall back to
// the pre-v0.11 flat key + brand prefix for legacy locales /
// unmigrated translations. The vendor-keyed label embeds the
// brand so we don't double-prefix on this path.
const newKey = `description.graphics.upscale.${vendor}.${upscaleQ}`;
const newLabel = t(newKey);
if (newLabel && newLabel !== newKey && newLabel.trim()) {
parts.push(newLabel);
} else {
const legacyKey = `description.graphics.upscaleQualityOptions.${upscaleQ}`;
const legacyLabel = t(legacyKey);
if (legacyLabel && legacyLabel !== legacyKey) {
parts.push(`${brands.upscale} ${legacyLabel}`);
}
}
}
if (fgMul) {
// Vendor-keyed full label embeds the brand AND the feature name
// ("NVIDIA Frame Generation x2", "AMD Fluid Motion Frames x3",
// "Intel XeFG x2"). Fall back to brand + raw multiplier for
// pre-v0.11 locales.
const newKey = `description.graphics.frameGen.${vendor}.${fgMul}`;
const newLabel = t(newKey);
if (newLabel && newLabel !== newKey && newLabel.trim()) {
parts.push(newLabel);
} else {
parts.push(`${brands.framegen} ${fgMul}`);
}
}
modifier = parts.join(" + ");
}
// 3. Ray-tracing clause. Each mode runs through i18n; falls back to
// the snake_case id if a locale hasn't translated it.
const rtModes = input.rayTracingModes ?? [];
let rtClause = "";
if (rtModes.length > 0) {
const labels = rtModes.map((m) => {
const key = `description.graphics.rtOptions.${m}`;
const resolved = t(key);
return resolved === key ? m : resolved;
});
rtClause = ` ${t("description.graphics.with")} ${labels.join(", ")}`;
}
if (!presetLabel && !modifier && !rtClause) return "";
if (!presetLabel) {
// No anchor preset (e.g. `custom` with empty free-form): fall back
// to just the modifier + RT clause, trimmed.
return `${modifier}${rtClause}`.trim();
}
const middle = modifier ? ` - ${modifier}` : "";
return `${presetLabel}${middle}${rtClause}`;
}
export interface BuildDescriptionOptions {
hashtagCount?: number;
/** When true and channelName is non-empty, appends an auto-generated
@@ -45,6 +190,14 @@ export interface BuildDescriptionOptions {
/** When true and both `sponsorName` and `sponsorPlatform` are set,
* emits a "🎁 Thanks to …" credit line above the music section. */
showSponsorCredit?: boolean;
/** When true and the active profile's `thirdPartyAdText` is non-empty,
* emits a "🤝 SPONSORS & PARTNERS" block (v0.11). */
showThirdPartyAds?: boolean;
/** Optional English-fixed translation function used by the unified
* content-warnings block (v0.11) to render bilingual lines
* `EN · output-language`. When omitted, the warnings block falls
* back to single-language output via `t`. */
tEn?: TranslationFn;
}
export function buildDescription(
@@ -57,13 +210,27 @@ export function buildDescription(
showCopyright = false,
showUsagePolicy = false,
showSponsorCredit = false,
showThirdPartyAds = false,
tEn,
} = options;
const sections: string[] = [];
const gameName =
input.gameNameLocalized?.[input.language] ?? input.gameName;
// 1. Intro
const intro = t(`description.intro.${input.videoType}`, {
// 1. Intro. Gacha videos dispatch on `gachaQuestType` so each of the
// 17 patterns can frame the description with its own opening line
// ("World Quest …", "Spiral Abyss endgame", "Dating Event …"). All
// other video types fall through to the flat `description.intro.<id>`
// shape that's been around since v0.2.
let introKey = `description.intro.${input.videoType}`;
if (input.videoType === "gacha_quest") {
const questType = input.gachaQuestType ?? DEFAULT_GACHA_QUEST_TYPE;
introKey = `description.intro.gacha_quest_${questType}`;
}
const versionLabel = input.gachaVersion?.trim()
? ` (${t("description.intro.versionInline", { v: input.gachaVersion.trim() })})`
: "";
const intro = t(introKey, {
gameName,
channelName: input.channelName,
partNumber: input.partNumber ?? "",
@@ -71,17 +238,46 @@ export function buildDescription(
dlcName: input.dlcName ?? "",
challengeName: input.challengeName ?? "",
modName: input.modName ?? "",
chapterName: input.chapterName ?? "",
questName: input.questName ?? "",
characterName: input.characterName ?? "",
anniversaryYear: input.anniversaryYear != null ? String(input.anniversaryYear) : "",
ordinalSuffix:
input.anniversaryYear != null ? ordinalSuffix(input.anniversaryYear) : "",
gachaVersion: input.gachaVersion ?? "",
versionLabel,
});
sections.push(intro);
// 1.5 Playthrough status — surfaces "is this a blind run / NG+ / …"
// right after the intro because that context frames how viewers read
// everything below. Skipped when creator hasn't picked a value.
if (input.playthroughStatus && input.playthroughStatus !== "none") {
const label = t(`description.playthrough.${input.playthroughStatus}`);
sections.push(t("description.sections.playthrough", { value: label }));
// 1.25 Livestream metadata — only emitted for livestream-type videos
// when at least one of `liveUrl` / `scheduledTime` is set. Sits right
// after the intro so viewers can grab the live link before scrolling
// through the rest of the description.
if (input.videoType === "livestream") {
const lines: string[] = [];
if (input.scheduledTime && input.scheduledTime.trim()) {
const formatted = formatScheduledTime(input.scheduledTime, input.language);
const line = t("description.livestream.scheduledLine", { time: formatted });
if (line && line !== "description.livestream.scheduledLine") lines.push(line);
}
if (input.liveUrl && input.liveUrl.trim()) {
const line = t("description.livestream.watchLine", { link: input.liveUrl.trim() });
if (line && line !== "description.livestream.watchLine") lines.push(line);
}
if (lines.length > 0) sections.push(lines.join("\n"));
}
// 1.5 Playthrough Notes — v0.12 unified block that consolidates the
// pre-v0.12 standalone "🎯 Playthrough" line and the standalone
// "🎮 DIFFICULTY" block, plus three new bullets (endings shown,
// language patch, game version). Sits right after the intro because
// these facts frame how viewers read everything below. Empty bullets
// are skipped; if every bullet is empty the whole block is skipped.
// Bilingual when `tEn` is provided AND output language ≠ English —
// pattern mirrors the v0.11 content-warnings block.
const pnBlock = buildPlaythroughNotesSection(input, t, tEn);
if (pnBlock) sections.push(pnBlock);
// 2. No Commentary tagline
sections.push(t("description.noCommentaryLine"));
@@ -130,30 +326,56 @@ export function buildDescription(
}
}
// 5. Video Settings
const settings: string[] = [];
if (input.resolution) settings.push(input.resolution);
if (input.fps) settings.push(`${input.fps} FPS`);
if (input.graphicsPreset) settings.push(input.graphicsPreset);
if (settings.length > 0) {
sections.push(`${t("description.sections.videoSettings")}\n${settings.join(" | ")}`);
}
// 5. Video Settings — skipped entirely for 2D / pixel-art / no-in-game-
// settings games (the user toggles that explicitly; v0.8 phase 2 also
// auto-suggests it on certain genres but the toggle is the source of
// truth at render time).
//
// v0.8 polish: each token now sits on its own line with a label
// ("Video:", "In-game Setting:", "Art Style:", "Version:"), matching
// the key-value-per-line shape of the rig and timestamps blocks.
// Lines with no value are dropped; if every line is dropped, the
// whole section is dropped.
if (!input.skipGraphicsSettings) {
const lines: string[] = [];
// 5.5 Difficulty — sits with Video Settings because a difficulty
// choice is another gameplay setting, not a content warning. For
// `"custom"`, the user's free-form label is used verbatim (not
// translated — intentional: lets creators use game-specific names
// like "Lethal" without per-locale fallback friction).
if (input.difficulty && input.difficulty !== "none") {
const value =
input.difficulty === "custom"
? (input.difficultyCustomLabel ?? "").trim()
: t(`description.difficulty.${input.difficulty}`);
if (value) {
sections.push(`${t("description.sections.difficulty")}\n${value}`);
// Capture-side: resolution + FPS, joined with " - " on a single line.
const captureParts: string[] = [];
if (input.resolution) captureParts.push(input.resolution);
if (input.fps) captureParts.push(`${input.fps} FPS`);
if (captureParts.length > 0) {
lines.push(`${t("description.graphics.videoLabel")}: ${captureParts.join(" - ")}`);
}
// In-game side: preset + modifiers + RT.
const gfxPart = composeGraphicsPart(input, t);
if (gfxPart) {
lines.push(`${t("description.graphics.inGameSettingLabel")}: ${gfxPart}`);
}
// Art style — own line so it stays visible alongside the in-game preset.
if (input.artStyle && input.artStyle !== "none") {
const styleKey = `description.graphics.artStyleOptions.${input.artStyle}`;
const styleLabel = t(styleKey);
if (styleLabel && styleLabel !== styleKey) {
lines.push(`${t("description.graphics.artStyle")}: ${styleLabel}`);
}
}
// Driver / game version — free-form, own line.
if (input.versionInfo && input.versionInfo.trim()) {
lines.push(`${t("description.graphics.versionLabel")}: ${input.versionInfo.trim()}`);
}
if (lines.length > 0) {
sections.push(`${t("description.sections.videoSettings")}\n${lines.join("\n")}`);
}
}
// 5.5 Difficulty — moved into the unified Playthrough Notes block
// above (slot 1.5) in v0.12. Kept here as a no-op placeholder so the
// numbering of subsequent comments stays stable.
// 6. Rig
if (hasEntries(input.rig)) {
const rigLines = Object.entries(input.rig)
@@ -166,31 +388,66 @@ export function buildDescription(
}
}
// 7. Spoiler Warning
if (input.spoilerWarning) {
sections.push(t("description.sections.spoilerWarning"));
// 6.5 Mod list — only meaningful for the `mods` videoType. Free-form
// multi-line text the creator pastes from their mod manager (Wabbajack,
// Vortex, Mod Organizer…). The single-line `modName` field stays in the
// title / intro for short identification; this block lists the full
// load order for the description.
if (
input.videoType === "mods" &&
input.modList &&
input.modList.trim()
) {
sections.push(
`${t("description.sections.modList")}\n${input.modList.trim()}`,
);
}
// 7.5 Content warnings — accessibility block. Rendered as a bulleted
// list so viewers using screen readers or avoiding triggers can scan
// quickly. Each warning has its own emoji bullet (⚡ / 🔊 / 😱) and a
// localised label. Empty array → skipped, matching the behaviour for
// every other opt-in section.
if (input.contentWarnings && input.contentWarnings.length > 0) {
const bullets = input.contentWarnings
.map((w) => t(`description.contentWarnings.${w}`))
.filter((line) => line && line.trim() !== "")
.map((line) => `• ${line}`)
// 7. Content warnings — unified bilingual checklist (v0.11). Replaces
// the v0.7 trio of separate spoiler / generic-content-warnings /
// mature blocks. Renders header + intro + bulleted list. When the
// output language is not English, each piece is paired with its
// English equivalent: header `EN / LOCAL`, intro on two lines,
// bullets `• EN · LOCAL` (separator is U+00B7 MIDDLE DOT). When
// `tEn` is omitted (e.g. legacy callers / unit tests that haven't
// migrated), falls back to single-language output via `t` — degraded
// but never broken.
const cw = input.contentWarnings ?? [];
if (cw.length > 0) {
const isEn = input.language === "en";
const renderBilingual = !isEn && Boolean(tEn);
const tEnUse: TranslationFn = tEn ?? t;
const headerEn = tEnUse("description.contentWarnings.header");
const headerLocal = t("description.contentWarnings.header");
const introEn = tEnUse("description.contentWarnings.intro");
const introLocal = t("description.contentWarnings.intro");
const headerLine = renderBilingual ? `${headerEn} / ${headerLocal}` : headerEn;
const introLines = renderBilingual ? `${introEn}\n${introLocal}` : introEn;
const bullets = cw
.map((id) => {
const key = `description.contentWarnings.items.${id}`;
const enLabel = tEnUse(key);
const localLabel = t(key);
if (!enLabel || enLabel === key || !enLabel.trim()) return null;
return renderBilingual ? `• ${enLabel} · ${localLabel}` : `• ${enLabel}`;
})
.filter((line): line is string => Boolean(line))
.join("\n");
if (bullets) {
sections.push(`${t("description.sections.contentWarnings")}\n${bullets}`);
sections.push(`${headerLine}\n${introLines}\n\n${bullets}`);
}
}
// 8. Mature Warning
if (input.matureWarning) {
sections.push(t("description.sections.matureWarning"));
}
// 7.5 Tech Notes — v0.12 production / playstyle disclaimer checklist.
// Sits next to Content Warnings because both are transparency blocks;
// grouping them keeps disclaimers visually together. Same bilingual
// render pattern as the content-warnings block above.
const tnBlock = buildTechNotesSection(input, t, tEn);
if (tnBlock) sections.push(tnBlock);
// 8.3. Sponsor credit — appears above the music / donate block so the
// "thanks to X" line stands out. Only renders when both the toggle is
@@ -212,6 +469,21 @@ export function buildDescription(
);
}
// 8.4. Third-party ads — channel-level partner / affiliate / sponsor
// copy stored on the active profile (v0.11). Multi-line preserved
// verbatim. Gated on settings toggle AND profile field non-empty;
// partial state is a no-op so flipping the toggle without filling
// the profile doesn't sneak an empty section into the description.
if (
showThirdPartyAds &&
input.thirdPartyAdText &&
input.thirdPartyAdText.trim()
) {
sections.push(
`${t("description.sections.thirdPartyAds")}\n${input.thirdPartyAdText.trim()}`,
);
}
// 8.5. Music / sound attribution — sits right before the donate
// block because both are "credits"-adjacent sections.
if (input.musicAttribution && input.musicAttribution.trim()) {
@@ -231,6 +503,32 @@ export function buildDescription(
sections.push(`${t("description.sections.donate")}\n${donateEntries.join("\n")}`);
}
// 9.5 Vietnam donate (bank + e-wallets) — gated on output language
// because non-Vietnamese viewers don't typically use VN bank
// transfer / MoMo / ZaloPay. Bank line requires both `vnBankName` and
// `vnBankAccount`; holder is decorative. Each e-wallet line is
// independent.
if (input.language === "vi") {
const vnLines: string[] = [];
const bankName = input.vnBankName?.trim() ?? "";
const bankAccount = input.vnBankAccount?.trim() ?? "";
const bankHolder = input.vnBankHolder?.trim() ?? "";
if (bankName && bankAccount) {
vnLines.push(
bankHolder
? `🏦 ${bankName}: ${bankAccount} (${bankHolder})`
: `🏦 ${bankName}: ${bankAccount}`,
);
}
const momo = input.vnMomo?.trim() ?? "";
if (momo) vnLines.push(`💸 MoMo: ${momo}`);
const zalopay = input.vnZalopay?.trim() ?? "";
if (zalopay) vnLines.push(`💸 ZaloPay: ${zalopay}`);
if (vnLines.length > 0) {
sections.push(`${t("description.sections.vnDonate")}\n${vnLines.join("\n")}`);
}
}
// 10. Social Links (use proper labels + icons)
const socialEntries = Object.entries(input.social)
.filter(([k, v]) => {
@@ -287,6 +585,239 @@ export function buildDescription(
return sections.join("\n\n");
}
/**
* Builds the unified `▸ 🎮 PLAYTHROUGH NOTES` block (v0.12). Combines
* five bullets (run type, difficulty, endings, language patch, game
* version) into one section. Each bullet's value is resolved through
* `t` (localised) plus `tEn` (English fallback) so the rendered line
* can be bilingual `EN · LOCAL` when the output language ≠ English.
*
* Returns "" when every bullet is empty / skipped — caller drops the
* section entirely instead of emitting a header with no body.
*
* Custom string slots (`difficultyCustomLabel`, `languagePatchCustom`,
* `gameVersionCustom`) are intentionally NOT translated: a creator who
* types "Lethal" or "Steam Next Fest backer build" wants that label
* preserved verbatim across locale switches, not run through a
* non-existent translation key.
*/
function buildPlaythroughNotesSection(
input: GeneratorInput,
t: TranslationFn,
tEn?: TranslationFn,
): string {
const isEn = input.language === "en";
const renderBilingual = !isEn && Boolean(tEn);
const tEnUse: TranslationFn = tEn ?? t;
/**
* Resolve a key against both `t` and `tEnUse`, returning a single bullet
* line. Bullets are formatted as `Label · NhãnLocal: ValueEn · ValueLocal`
* in bilingual mode and `Label: Value` otherwise. Returns null when the
* value is empty (caller filters these out).
*/
function bullet(
labelKey: string,
valueEn: string,
valueLocal: string,
): string | null {
const trimmedEn = valueEn.trim();
const trimmedLocal = valueLocal.trim();
if (!trimmedEn && !trimmedLocal) return null;
const labelEn = tEnUse(labelKey);
const labelLocal = t(labelKey);
const labelLine = renderBilingual
? `${labelEn} · ${labelLocal}`
: labelEn;
const valueLine = renderBilingual
? `${trimmedEn || trimmedLocal} · ${trimmedLocal || trimmedEn}`
: trimmedEn || trimmedLocal;
return `• ${labelLine}: ${valueLine}`;
}
/**
* Resolve an enum value through i18n. Returns ["", ""] for the
* skip-sentinel value (caller drops the bullet). Falls back to the raw
* id if a locale hasn't translated the key — degraded but never
* "[object Object]".
*/
function resolveEnum(
namespace: string,
value: string,
skipSentinel: string,
): { en: string; local: string } {
if (!value || value === skipSentinel) return { en: "", local: "" };
const key = `description.playthroughNotes.${namespace}.${value}`;
const en = tEnUse(key);
const local = t(key);
return {
en: en === key ? value : en,
local: local === key ? value : local,
};
}
const bullets: string[] = [];
// Run type — reads from `playthroughStatus`, looks up the existing
// v0.7 `description.playthrough.<status>` keys (kept in templates so
// the migration stays purely about render shape, not value labels).
if (input.playthroughStatus && input.playthroughStatus !== "none") {
const key = `description.playthrough.${input.playthroughStatus}`;
const valueEn = tEnUse(key);
const valueLocal = t(key);
const b = bullet(
"description.playthroughNotes.labels.runType",
valueEn === key ? input.playthroughStatus : valueEn,
valueLocal === key ? input.playthroughStatus : valueLocal,
);
if (b) bullets.push(b);
}
// Difficulty — reads from `difficulty`, with custom slot for
// free-form labels. Custom labels are passed through verbatim
// (no translation) on both sides of the bilingual separator.
if (input.difficulty && input.difficulty !== "none") {
let valueEn: string;
let valueLocal: string;
if (input.difficulty === "custom") {
const custom = (input.difficultyCustomLabel ?? "").trim();
valueEn = custom;
valueLocal = custom;
} else {
const key = `description.difficulty.${input.difficulty}`;
const en = tEnUse(key);
const local = t(key);
valueEn = en === key ? input.difficulty : en;
valueLocal = local === key ? input.difficulty : local;
}
const b = bullet(
"description.playthroughNotes.labels.difficulty",
valueEn,
valueLocal,
);
if (b) bullets.push(b);
}
// Endings shown — free text, identical on both sides of the bilingual
// separator (it's a creator-typed label, not localised content).
const endings = (input.endingsShown ?? "").trim();
if (endings) {
const b = bullet(
"description.playthroughNotes.labels.endings",
endings,
endings,
);
if (b) bullets.push(b);
}
// Language patch — enum + custom slot. `official_other` and `custom`
// both pull their value from `languagePatchCustom`; the enum-resolved
// label is used otherwise. `none` is the skip sentinel.
if (input.languagePatch && input.languagePatch !== "none") {
let valueEn: string;
let valueLocal: string;
if (input.languagePatch === "official_other" || input.languagePatch === "custom") {
const custom = (input.languagePatchCustom ?? "").trim();
valueEn = custom;
valueLocal = custom;
} else {
const resolved = resolveEnum("languagePatchOptions", input.languagePatch, "none");
valueEn = resolved.en;
valueLocal = resolved.local;
}
const b = bullet(
"description.playthroughNotes.labels.languagePatch",
valueEn,
valueLocal,
);
if (b) bullets.push(b);
}
// Game version — `full_release` is the implicit default and skips
// the bullet entirely (no need to announce "this is the full game").
if (input.gameVersion && input.gameVersion !== "full_release") {
let valueEn: string;
let valueLocal: string;
if (input.gameVersion === "custom") {
const custom = (input.gameVersionCustom ?? "").trim();
valueEn = custom;
valueLocal = custom;
} else {
const resolved = resolveEnum(
"gameVersionOptions",
input.gameVersion,
"full_release",
);
valueEn = resolved.en;
valueLocal = resolved.local;
}
const b = bullet(
"description.playthroughNotes.labels.gameVersion",
valueEn,
valueLocal,
);
if (b) bullets.push(b);
}
if (bullets.length === 0) return "";
const headerEn = tEnUse("description.playthroughNotes.header");
const headerLocal = t("description.playthroughNotes.header");
const introEn = tEnUse("description.playthroughNotes.intro");
const introLocal = t("description.playthroughNotes.intro");
const headerLine = renderBilingual ? `${headerEn} / ${headerLocal}` : headerEn;
const introLines = renderBilingual ? `${introEn}\n${introLocal}` : introEn;
return `${headerLine}\n${introLines}\n\n${bullets.join("\n")}`;
}
/**
* Builds the `▸ 🛠 TECH NOTES` block (v0.12). Renders selected items
* from {@link GeneratorInput.techNotes} as bulleted bilingual lines —
* the rendering logic mirrors the v0.11 content-warnings block exactly,
* just with a different header, intro, and items namespace.
*
* Returns "" when no items are selected. Items whose translation key
* doesn't resolve are filtered out so a stale id from a hand-edited
* persistent blob doesn't render as a bare key.
*/
function buildTechNotesSection(
input: GeneratorInput,
t: TranslationFn,
tEn?: TranslationFn,
): string {
const tn = input.techNotes ?? [];
if (tn.length === 0) return "";
const isEn = input.language === "en";
const renderBilingual = !isEn && Boolean(tEn);
const tEnUse: TranslationFn = tEn ?? t;
const headerEn = tEnUse("description.techNotes.header");
const headerLocal = t("description.techNotes.header");
const introEn = tEnUse("description.techNotes.intro");
const introLocal = t("description.techNotes.intro");
const headerLine = renderBilingual ? `${headerEn} / ${headerLocal}` : headerEn;
const introLines = renderBilingual ? `${introEn}\n${introLocal}` : introEn;
const bullets = tn
.map((id) => {
const key = `description.techNotes.items.${id}`;
const enLabel = tEnUse(key);
const localLabel = t(key);
if (!enLabel || enLabel === key || !enLabel.trim()) return null;
return renderBilingual ? `• ${enLabel} · ${localLabel}` : `• ${enLabel}`;
})
.filter((line): line is string => Boolean(line))
.join("\n");
if (!bullets) return "";
return `${headerLine}\n${introLines}\n\n${bullets}`;
}
export function checkDescriptionWarning(description: string): CharLimitWarning | null {
if (description.length > YT_LIMITS.DESCRIPTION_MAX) {
return {
+101
View File
@@ -0,0 +1,101 @@
import type {
FrameGenVendor,
FrameGenMultiplier,
UpscaleQuality,
} from "@config/graphics-settings";
/**
* Vendor-aware filtering for upscaling-quality and frame-generation
* multiplier dropdowns. Each vendor exposes only the quality / multiplier
* tiers it actually ships:
*
* - NVIDIA: DLAA (anti-aliasing-only) + 4 quality bins. DLSS 4 supports
* multi-frame-gen up to x4.
* - AMD: FSR Native AA + 4 quality bins. FSR 3.1 caps at x3.
* - Intel: XeSS Native AA + Ultra Quality + 4 quality bins. Intel XeFG
* has only shipped x2.
* - none: vendor-agnostic legacy ladder (no DLAA, no Ultra Quality) —
* keeps pre-v0.11 presets / templates rendering without coercion loss.
*
* Pure functions — used by VideoSettingsForm to filter Select options
* and by description-builder / editor-store / template-store to coerce
* invalid vendor×quality combos back to `"none"` on rehydrate.
*/
export function getValidUpscaleQualities(
vendor: FrameGenVendor,
): readonly UpscaleQuality[] {
switch (vendor) {
case "nvidia":
return [
"none",
"dlaa",
"quality",
"balanced",
"performance",
"ultra_performance",
] as const;
case "amd":
return [
"none",
"native_aa",
"quality",
"balanced",
"performance",
"ultra_performance",
] as const;
case "intel":
return [
"none",
"native_aa",
"ultra_quality",
"quality",
"balanced",
"performance",
"ultra_performance",
] as const;
case "none":
return [
"none",
"native_aa",
"quality",
"balanced",
"performance",
"ultra_performance",
] as const;
}
}
export function getValidFrameGenMultipliers(
vendor: FrameGenVendor,
): readonly FrameGenMultiplier[] {
switch (vendor) {
case "nvidia":
return ["none", "x2", "x3", "x4"] as const;
case "amd":
return ["none", "x2", "x3"] as const;
case "intel":
return ["none", "x2"] as const;
case "none":
return ["none"] as const;
}
}
/** Returns `current` if it's valid for the vendor, else `"none"`. */
export function coerceUpscaleQuality(
vendor: FrameGenVendor,
current: UpscaleQuality | undefined,
): UpscaleQuality {
const valid = getValidUpscaleQualities(vendor);
if (current && (valid as readonly string[]).includes(current)) return current;
return "none";
}
/** Returns `current` if it's valid for the vendor, else `"none"`. */
export function coerceFrameGenMultiplier(
vendor: FrameGenVendor,
current: FrameGenMultiplier | undefined,
): FrameGenMultiplier {
const valid = getValidFrameGenMultipliers(vendor);
if (current && (valid as readonly string[]).includes(current)) return current;
return "none";
}
+42 -2
View File
@@ -1,4 +1,4 @@
import type { GeneratorInput, TranslationFn } from "./types";
import type { GeneratorInput, TranslationFn, Genre } from "./types";
export interface BuildPinnedCommentOptions {
/**
@@ -12,6 +12,22 @@ export interface BuildPinnedCommentOptions {
* "watch the full series here" line pointing at the playlist.
*/
includePlaylistLink?: boolean;
/**
* When true, the primary genre has a configured playlist URL in
* {@link genrePlaylists}, AND the matching label exists in
* {@link genreLabels}, the template includes a "More <genre>
* gameplay on the channel" line. v0.8 phase 2 — settings → Genre
* Playlists map drives this.
*/
includeGenrePlaylist?: boolean;
/** Per-genre playlist URLs, supplied by the caller from settings. */
genrePlaylists?: Partial<Record<Genre, string>>;
/**
* Per-genre human labels (already i18n-resolved by the caller). Kept
* separate from `genrePlaylists` so the engine stays config-free —
* the caller owns label resolution via the `ui.json` namespace.
*/
genreLabels?: Partial<Record<Genre, string>>;
}
/**
@@ -38,7 +54,13 @@ export function buildPinnedComment(
t: TranslationFn,
options: BuildPinnedCommentOptions = {},
): string {
const { includeAskNextGame = true, includePlaylistLink = true } = options;
const {
includeAskNextGame = true,
includePlaylistLink = true,
includeGenrePlaylist = false,
genrePlaylists,
genreLabels,
} = options;
const gameName = input.gameNameLocalized?.[input.language] ?? input.gameName;
const vars: Record<string, string> = {
@@ -69,6 +91,24 @@ export function buildPinnedComment(
if (playlist && playlist !== "pinnedComment.playlistPrompt") lines.push(playlist);
}
// Genre-playlist auto-suggestion. The primary genre (genres[0]) is the
// template trigger; secondary genres don't get their own line because
// the pinned comment would balloon for multi-genre videos.
if (includeGenrePlaylist) {
const primary = input.genres[0];
const url = primary ? genrePlaylists?.[primary]?.trim() : "";
const label = primary ? genreLabels?.[primary] : "";
if (primary && url && label) {
const line = t("pinnedComment.genrePlaylistSuggestion", {
genreLabel: label,
link: url,
});
if (line && line !== "pinnedComment.genrePlaylistSuggestion") {
lines.push(line);
}
}
}
const engagement = t("pinnedComment.engagementPrompt");
if (engagement && engagement !== "pinnedComment.engagementPrompt") lines.push(engagement);
+108 -8
View File
@@ -2,6 +2,57 @@ import type { GeneratorInput, SupportedLanguage } from "./types";
import { YT_LIMITS } from "./types";
import { humanizeId } from "@utils/sanitize";
/**
* Reserve a 9-char tail for the most common composite suffix (" gameplay").
* Composites whose suffix is longer than 9 chars may still get filtered out
* by the per-tag char limit, but the bare game name and short composites are
* guaranteed to land — fixing the silent-drop case where a long name made
* every game-name-bearing tag disappear.
*/
const COMPOSITE_NAME_BUDGET = YT_LIMITS.SINGLE_TAG_MAX - 9;
const QUALIFIER_SUFFIX_RE =
/[:\s]+(?:Definitive|Complete|Collector'?s?|Deluxe|Game\s+of\s+the\s+Year|GOTY|Ultimate|Special|Anniversary|Remastered|Remake|Enhanced|HD)(?:\s+(?:Edition|Cut|Version))?\s*$/i;
/**
* Returns a shortened, tag-friendly form of `name` whose length is ≤ `budget`.
*
* Strips trademark marks, then iteratively peels off common edition
* qualifiers ("Definitive Edition", "Remastered", "GOTY", …). If the result
* is still over budget, drops everything after the first colon. Falls back
* to picking leading whole words that fit.
*
* Pure — exported for testing.
*/
export function tagFriendlyGameName(name: string, budget: number): string {
let n = name.replace(/[™®©]/g, "").trim();
let prev: string;
do {
prev = n;
n = n.replace(QUALIFIER_SUFFIX_RE, "").trim();
} while (n !== prev);
if (n.length <= budget) return n;
const colonIdx = n.indexOf(":");
if (colonIdx > 0) {
const head = n.slice(0, colonIdx).trim();
if (head.length <= budget) return head;
n = head;
}
const words = n.split(/\s+/);
const acc: string[] = [];
let len = 0;
for (const w of words) {
const sep = acc.length === 0 ? 0 : 1;
if (len + sep + w.length > budget) break;
acc.push(w);
len += sep + w.length;
}
return acc.join(" ") || n.slice(0, budget);
}
/**
* Genre tag pool registry.
*
@@ -191,6 +242,24 @@ const VIDEO_TYPE_TAGS: Record<string, (gameName: string) => string[]> = {
`${g} completionist no commentary`,
`${g} achievement guide`,
],
livestream: (g) => [
"livestream",
"live gameplay",
`${g} live`,
`${g} stream`,
`${g} livestream`,
],
// One pool for the whole gacha bucket — quest-type-specific tags
// would balloon the pool and rarely surface in YouTube search anyway.
// The intro / title / hashtags already carry the per-quest framing.
gacha_quest: (g) => [
`${g} gameplay no commentary`,
`${g} quest`,
`${g} story`,
`${g} walkthrough`,
"gacha game gameplay",
"gacha rpg",
],
};
/**
@@ -286,41 +355,61 @@ export interface TagOptions {
export function generateTags(input: GeneratorInput, options?: TagOptions): string[] {
const { includeMultilingualTags = true, includeTrendingTags = true } = options ?? {};
const gameName = input.gameNameLocalized?.[input.language] ?? input.gameName;
const rawName = input.gameNameLocalized?.[input.language] ?? input.gameName;
// Two friendly forms of the game name:
// • bareNameTag — fits the per-tag 30-char limit; always added so the
// game name appears as a standalone tag even when long.
// • composeName — shorter still, used inside composite tags like
// `${name} gameplay` so the composites also fit ≤ 30.
// For short names both equal `rawName` and behaviour matches v0.7.
const bareNameTag =
rawName.length <= YT_LIMITS.SINGLE_TAG_MAX
? rawName
: tagFriendlyGameName(rawName, YT_LIMITS.SINGLE_TAG_MAX);
const composeName =
rawName.length <= COMPOSITE_NAME_BUDGET
? rawName
: tagFriendlyGameName(rawName, COMPOSITE_NAME_BUDGET);
const allTags: string[] = [];
// Always seed the bare game-name tag(s) so they survive dedup even when
// the pool composites overflow.
if (bareNameTag) allTags.push(bareNameTag);
if (composeName && composeName !== bareNameTag) allTags.push(composeName);
// Core tags — language-specific (highest priority)
const coreFn = CORE_TAGS_BY_LANG[input.language] ?? CORE_TAGS_BY_LANG.en;
allTags.push(...coreFn(gameName));
allTags.push(...coreFn(composeName));
// Genre tags — merge contributions from every selected genre.
// Final dedup at the bottom collapses overlap across the pools.
for (const genre of input.genres) {
const genreFn = GENRE_TAG_REGISTRY[genre];
if (genreFn) {
allTags.push(...genreFn(gameName));
allTags.push(...genreFn(composeName));
}
}
// Video type tags
const typeFn = VIDEO_TYPE_TAGS[input.videoType];
if (typeFn) {
allTags.push(...typeFn(gameName));
allTags.push(...typeFn(composeName));
}
// Platform tags
allTags.push(...getPlatformTags(gameName, input.platform));
allTags.push(...getPlatformTags(composeName, input.platform));
// Quality tags
allTags.push(...getQualityTags(gameName, input.resolution, input.fps));
allTags.push(...getQualityTags(composeName, input.resolution, input.fps));
// Multilingual tags — only the selected language (v0.3.0 fix: was
// previously iterating over every language entry).
if (includeMultilingualTags) {
const langFn = MULTILINGUAL_TAGS[input.language];
if (langFn) {
allTags.push(...langFn(gameName));
allTags.push(...langFn(composeName));
}
}
@@ -329,7 +418,18 @@ export function generateTags(input: GeneratorInput, options?: TagOptions): strin
// one headline category that searchers use.
const primaryGenre = input.genres[0];
if (includeTrendingTags && primaryGenre) {
allTags.push(...getTrendingTags(gameName, primaryGenre));
allTags.push(...getTrendingTags(composeName, primaryGenre));
}
// Publisher / Developer name (v0.10) — emitted as a bare tag only.
// Distinct semantic from the platform pool above, so the dedup pass
// catches any overlap with sponsorName-style entries case-insensitively.
// No composite (`${pubDevName} ${composeName}`) — would chew through
// the 500-char total budget for marginal search lift.
const pubDev = input.pubDevName?.trim();
if (pubDev) {
const trimmed = tagFriendlyGameName(pubDev, YT_LIMITS.SINGLE_TAG_MAX);
if (trimmed) allTags.push(trimmed);
}
// Dedup (case-insensitive) and enforce per-tag char limit
+15
View File
@@ -41,6 +41,19 @@ export interface RenderOptions extends TagOptions {
* above the music / donate block.
*/
showSponsorCredit?: boolean;
/**
* When true and the active profile's `thirdPartyAdText` is non-empty,
* the description emits a "🤝 SPONSORS & PARTNERS" block above the
* music section (v0.11).
*/
showThirdPartyAds?: boolean;
/**
* Optional English-fixed translation function. Used by the v0.11
* unified content-warnings block to render bilingual lines
* `EN · output-language`. When omitted, the warnings block falls back
* to single-language output via `t`.
*/
tEn?: TranslationFn;
}
export function renderAll(
@@ -59,6 +72,8 @@ export function renderAll(
showCopyright: options?.showCopyright,
showUsagePolicy: options?.showUsagePolicy,
showSponsorCredit: options?.showSponsorCredit,
showThirdPartyAds: options?.showThirdPartyAds,
tEn: options?.tEn,
});
const tags = generateTags(input, options);
const tagString = formatTagString(tags);
+85 -6
View File
@@ -7,6 +7,11 @@ import type {
TitleBadgeCase,
} from "./types";
import { YT_LIMITS } from "./types";
import {
DEFAULT_GACHA_QUEST_TYPE,
GACHA_PART_SUFFIX_STYLES,
type GachaQuestType,
} from "@config/gacha-quest-types";
/**
* Compact "[2K 60FPS]" badge appended to the video-type segment when the
@@ -120,6 +125,50 @@ function composeTitle(args: ComposeArgs): string {
return parts.join(separator);
}
/**
* English ordinal suffix for an integer (1 → "st", 2 → "nd", 11 → "th",
* 21 → "st", etc.). Used by the Anniversary template to render
* `"{{anniversaryYear}}{{ordinalSuffix}} Anniversary"` as e.g.
* `"2nd Anniversary"`. Non-English locales pass an empty string so the
* native form ("第2周年", "주년") doesn't pick up an English suffix.
*/
export function ordinalSuffix(n: number): string {
const abs = Math.abs(Math.trunc(n));
const lastTwo = abs % 100;
if (lastTwo >= 11 && lastTwo <= 13) return "th";
switch (abs % 10) {
case 1:
return "st";
case 2:
return "nd";
case 3:
return "rd";
default:
return "th";
}
}
/**
* Build the per-quest-type partNumber suffix for a gacha title — e.g.
* `" - Part 5"`, `" - Day 3"`, `" - Floor 12"`. Driven by the
* {@link GACHA_PART_SUFFIX_STYLES} mapping so each quest type renders
* its own canonical wording. Returns an empty string when the part
* number is blank or the quest type doesn't carry a suffix.
*/
export function buildGachaPartSuffix(
questType: GachaQuestType,
partNumber: string | undefined,
t: TranslationFn,
): string {
const n = (partNumber ?? "").trim();
if (!n) return "";
const style = GACHA_PART_SUFFIX_STYLES[questType];
if (style === "none") return "";
const key = `title.gachaPartSuffix.${style}`;
const resolved = t(key, { n });
return resolved && resolved !== key ? resolved : "";
}
export function buildTitle(
input: GeneratorInput,
t: TranslationFn,
@@ -135,6 +184,42 @@ export function buildTitle(
const suffix = t("title.suffix");
const gameName =
input.gameNameLocalized?.[input.language] ?? input.gameName;
let badge = opts.showQualityBadge ? buildQualityBadge(input.resolution, input.fps) : "";
if (badge && opts.badgeCase === "lower") badge = badge.toLowerCase();
// Gacha-quest titles compose their own head segment via the
// per-quest-type i18n template (which already embeds gameName +
// chapterName / questName + the optional partSuffix). The standard
// suffix ("Gameplay No Commentary") still tails the result, and the
// quality badge respects `badgePosition` as usual.
if (input.videoType === "gacha_quest") {
const questType = input.gachaQuestType ?? DEFAULT_GACHA_QUEST_TYPE;
const partSuffix = buildGachaPartSuffix(questType, input.partNumber, t);
const gachaHeadKey = `title.gachaQuestType.${questType}`;
const gachaHead = t(gachaHeadKey, {
gameName,
chapterName: input.chapterName ?? "",
questName: input.questName ?? "",
characterName: input.characterName ?? "",
anniversaryYear: input.anniversaryYear != null ? String(input.anniversaryYear) : "",
ordinalSuffix: input.anniversaryYear != null ? ordinalSuffix(input.anniversaryYear) : "",
gachaVersion: input.gachaVersion ?? "",
partSuffix,
});
return composeTitle({
gameName: gachaHead,
videoTypeLabel: "",
suffix,
badge,
separator,
position: opts.badgePosition,
});
}
const videoTypeLabel = t(`title.videoType.${input.videoType}`, {
partNumber: input.partNumber ?? "",
bossName: input.bossName ?? "",
@@ -143,12 +228,6 @@ export function buildTitle(
modName: input.modName ?? "",
});
const gameName =
input.gameNameLocalized?.[input.language] ?? input.gameName;
let badge = opts.showQualityBadge ? buildQualityBadge(input.resolution, input.fps) : "";
if (badge && opts.badgeCase === "lower") badge = badge.toLowerCase();
return composeTitle({
gameName,
videoTypeLabel,
+372 -10
View File
@@ -1,3 +1,13 @@
import type {
GraphicsPreset,
RTMode,
FrameGenVendor,
FrameGenMultiplier,
UpscaleQuality,
ArtStyle,
} from "@config/graphics-settings";
import type { GachaQuestType } from "@config/gacha-quest-types";
export type VideoType =
| "full"
| "part"
@@ -16,7 +26,9 @@ export type VideoType =
| "comparison"
| "guide"
| "mods"
| "collectibles";
| "collectibles"
| "livestream"
| "gacha_quest";
export type Genre =
| "action"
@@ -113,14 +125,206 @@ export const DIFFICULTY_LEVELS = [
export type DifficultyLevel = (typeof DIFFICULTY_LEVELS)[number];
/**
* Accessibility-oriented content warnings (v0.7 phase 2). Multi-select:
* a single video can have flashing lights AND loud noises AND jump
* scares. Empty array → skip the section entirely.
* Language-patch state (v0.12). Distinguishes between an officially
* shipped translation, a fan translation, machine translation, or no
* patch at all. `"official_other"` covers official non-English releases
* — pair with {@link languagePatchCustom} to surface the actual locale
* (e.g. "Official KR"). `"none"` skips the bullet in the description.
*/
export const LANGUAGE_PATCH_OPTIONS = [
"none",
"official_en",
"official_other",
"fan_translation",
"mtl",
"custom",
] as const;
export type LanguagePatch = (typeof LANGUAGE_PATCH_OPTIONS)[number];
/**
* Game-version state (v0.12). Lets viewers know if they're watching the
* full release vs. a demo / EA / beta / prologue. `"custom"` is the
* escape hatch for niche cases ("Steam Next Fest demo", "Kickstarter
* backer build"); pair with {@link gameVersionCustom}. `"full_release"`
* is the implicit default and skips the bullet (no need to announce
* "this is the full game" — that's the assumed baseline).
*/
export const GAME_VERSION_OPTIONS = [
"full_release",
"demo",
"early_access",
"beta",
"prologue",
"pre_release",
"custom",
] as const;
export type GameVersion = (typeof GAME_VERSION_OPTIONS)[number];
/**
* Tech / production / playstyle disclaimer items (v0.12). One unified
* checklist that consolidates "Technical issue", "Gameplay", and
* "Game State" disclaimer pools. Items that overlap with structured
* fields ({@link PlaythroughStatus}, {@link DifficultyLevel},
* {@link LanguagePatch}, {@link GameVersion}, `endingsShown`) are
* intentionally NOT in this list — the structured field renders that
* data instead, so duplicating it here would surface the same fact
* twice.
*
* Grouped semantically in the UI (see {@link TECH_NOTE_GROUPS} in
* `@config/tech-note-groups`) but flat in the array — render order in
* the description matches the user's selection order. Like content
* warnings, the rendered block is bilingual when `tEn` is provided.
*/
export const TECH_NOTES = [
// Audio
"copyright_muted_sections",
"volume_reduced_copyright",
"music_replaced_copyright",
"cutscene_audio_muted_only",
"original_audio_kept",
// Video quality
"low_resolution_hardware",
"low_graphics_performance",
"fps_drops_hardware",
// Recording issues
"bug_from_game",
"crash_kept_transparency",
"loading_cut",
"obs_artifacts_possible",
// Playstyle disclaimers
"not_no_hit_run",
"not_clean_walkthrough",
"casual_no_commentary",
"many_deaths_patience",
"slow_exploration",
"puzzle_stuck_possible",
"grinding_cut",
"not_speedrun_relaxed",
// Production / attribution
"exploration_focus_skip_combat",
"edited_for_pacing",
"support_developers",
"online_connectivity_issues",
] as const;
export type TechNote = (typeof TECH_NOTES)[number];
/**
* Content warnings (v0.11 unified bilingual checklist). Replaces the
* v0.7 trio (flashing_lights / loud_noises / jump_scares) plus the
* standalone `spoilerWarning` / `matureWarning` boolean toggles. The 3
* legacy ids are preserved unchanged so persisted drafts round-trip.
*
* Grouped semantically in the UI (see {@link CONTENT_WARNING_GROUPS} in
* `@config/content-warning-groups`) but flat in the array — the engine
* doesn't care about groups. Render order in the description matches
* the user's selection order.
*/
export const CONTENT_WARNINGS = [
// Spoilers
"spoiler_story",
"spoiler_ending",
"spoiler_true_ending",
"spoiler_post_game",
"spoiler_secret_ending",
"spoiler_dlc",
// Photosensitive / health
"flashing_lights",
"motion_sickness",
"migraine_trigger",
"loud_noises",
"strobe_effects",
"screen_shake_intense",
// Phobias
"jump_scares",
"acrophobia",
"trypophobia",
"thalassophobia",
"claustrophobia",
"arachnophobia",
"entomophobia",
"ophidiophobia",
"cynophobia",
"nyctophobia",
"pyrophobia",
"pediophobia",
"hemophobia",
"coulrophobia",
"ablutophobia",
"taphophobia",
// Mental health
"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",
// Mature / sensitive
"blood_gore",
"mature_18plus",
"disturbing_imagery",
"animal_abuse",
"child_harm",
"domestic_violence",
"sexual_assault",
"torture",
"religion_themes",
"war_violence",
"discrimination",
"police_violence",
"smoking_drinking",
"detailed_killing",
"cult_occult",
"psychological_manipulation",
"grief_loss",
"kidnapping",
"hate_speech",
"historical_atrocity",
"slavery_themes",
"terrorism_themes",
"bullying_themes",
"human_experimentation",
"cannibalism",
"nuclear_themes",
// Heavy-horror specific (v0.13.1)
"eye_horror",
"body_horror",
"face_horror",
"cosmic_horror",
"extreme_gore",
"decay_rot",
"mutilation",
"liminal_spaces",
"analog_horror",
"unreality_themes",
"pursuit_chase",
"entity_horror",
// Playstyle disclosures
"blind_playthrough",
"no_spoilers_chat",
"casual_difficulty",
"hardcore_difficulty",
"permadeath_run",
"speedrun_attempt",
"completionist_run",
"learning_mechanics",
"first_time_playing",
"returning_player",
// Gameplay disclosure (v0.14)
"mods_used",
"cheats_enabled",
"glitch_exploits",
"assisted_run",
] as const;
export type ContentWarning = (typeof CONTENT_WARNINGS)[number];
@@ -143,9 +347,86 @@ export interface GeneratorInput {
dlcName?: string;
challengeName?: string;
modName?: string;
/**
* Long-form mod credit list (multi-line text). Renders into a separate
* `🧩 MOD LIST` description section when {@link videoType} is `"mods"`.
* Free-form so creators can paste straight from a Wabbajack / Vortex /
* Mod Organizer modlist.
*/
modList?: string;
/** Livestream-only: canonical YouTube/Twitch live URL. */
liveUrl?: string;
/** Livestream-only: ISO datetime (`<input type="datetime-local">`). */
scheduledTime?: string;
/**
* Gacha-quest-only (v0.9 phase 1). Selected quest pattern; drives both
* the per-type title format and the per-type intro template. Defaults
* to `"main_story"` in the editor; missing values in pre-v0.9 drafts
* fall through to `"main_story"` via the editor-store v6→v7 migration.
*/
gachaQuestType?: GachaQuestType;
/**
* Gacha-quest-only: human chapter / story-arc label, e.g.
* `"Chapter 5 Act 2: Where the Stars Fall"`, `"Penacony 2.0"`.
*/
chapterName?: string;
/**
* Gacha-quest-only: individual quest / event name, e.g.
* `"A Solitary Constellation"`. Optional — `main_story`-style videos
* usually rely on `chapterName` only.
*/
questName?: string;
/**
* Gacha-quest-only (v0.13): character name. Used by the `showcase`
* quest type as the primary subject of the title and description.
*/
characterName?: string;
/**
* Gacha-quest-only (v0.13): anniversary year (1–20). Used by the
* `anniversary` quest type to render "1st", "2nd", ..., "Nth"
* Anniversary in title and description templates.
*/
anniversaryYear?: number | null;
/**
* Gacha-quest-only (v0.13): game version label like `"1.2"`, `"2.4"`.
* Distinct from {@link versionInfo} which is the driver / generic game
* version shown in 🖥 VIDEO SETTINGS for any video type. `gachaVersion`
* is rendered inside Gacha-specific intros (showcase / anniversary etc.).
*/
gachaVersion?: string;
resolution?: string;
fps?: string;
graphicsPreset?: string;
/**
* Graphics-quality preset (v0.8 enum + `"custom"` escape hatch).
* Pre-v0.8 drafts persisted this as free-form text — the editor-store
* v4→v5 migration maps known labels to enum values and routes anything
* else into {@link graphicsPresetCustom}.
*/
graphicsPreset?: GraphicsPreset;
/** Free-form preset name when {@link graphicsPreset} === `"custom"`. */
graphicsPresetCustom?: string;
/**
* When true, the entire 🖥 VIDEO SETTINGS section is omitted from the
* description — for 2D / pixel-art / web games that have no in-game
* graphics settings to talk about.
*/
skipGraphicsSettings?: boolean;
/** Multi-select RT modes layered on the graphics line. */
rayTracingModes?: RTMode[];
/** GPU vendor whose upscaling / frame-gen the creator used. */
frameGenVendor?: FrameGenVendor;
/** Frame-generation multiplier (only meaningful when vendor !== "none"). */
frameGenMultiplier?: FrameGenMultiplier;
/** Upscaling quality (DLSS / FSR / XeSS quality preset). */
upscaleQuality?: UpscaleQuality;
/** High-level art-style descriptor — surfaces a separate line. */
artStyle?: ArtStyle;
/**
* Free-form short string for driver / game version, e.g.
* "GeForce 565.90 | Game v1.4". Surfaces as the trailing token of the
* video-settings line.
*/
versionInfo?: string;
timestamps?: string;
playlistLink?: string;
contactEmail?: string;
@@ -166,26 +447,87 @@ export interface GeneratorInput {
* Free-form string so regional / non-listed stores still work.
*/
sponsorPlatform?: string;
/**
* Free-text publisher / developer label paired with the
* `Publisher / Developer site` URL in the Store Links editor. When
* non-empty, the tag generator emits it as a bare YouTube tag (e.g.
* "Ubisoft", "FromSoftware"). Distinct from {@link sponsorName}, which
* drives the description's "🎁 Thanks to …" line and is not tagged.
*/
pubDevName?: string;
/**
* Channel-level third-party advertising / sponsor / partner copy
* (v0.11). Free-form multi-line text persisted on the Profile (so it
* carries across all videos for a given channel). Rendered into a
* "🤝 SPONSORS & PARTNERS" description block when both the
* `showThirdPartyAds` settings toggle is on AND this field is non-empty.
*/
thirdPartyAdText?: string;
/**
* @deprecated v0.11 — merged into the unified content-warning checklist
* as the `spoiler_story` item. Field retained on input for back-compat
* with persisted drafts; the engine no longer renders a standalone
* spoiler block.
*/
spoilerWarning: boolean;
/**
* @deprecated v0.11 — merged into the unified content-warning checklist
* as the `mature_18plus` item. Field retained on input for back-compat
* with persisted drafts; the engine no longer renders a standalone
* mature block.
*/
matureWarning: boolean;
/**
* Playthrough state — renders a "🎯 Playthrough: …" block above
* `noCommentaryLine`. Defaults to `"none"` (skipped).
* Playthrough state — feeds the "Run type" bullet of the unified
* `▸ 🎮 PLAYTHROUGH NOTES` block (v0.12). Defaults to `"none"` (bullet
* is skipped). Pre-v0.12 this rendered as a standalone "🎯 Playthrough:"
* line above `noCommentaryLine`.
*/
playthroughStatus?: PlaythroughStatus;
/**
* Preset / custom difficulty — renders a "🎮 DIFFICULTY" block after
* the Video Settings section. When `"custom"`, the value is taken
* from {@link difficultyCustomLabel} instead of the locale preset.
* Preset / custom difficulty — feeds the "Difficulty" bullet of the
* unified `▸ 🎮 PLAYTHROUGH NOTES` block (v0.12). When `"custom"`, the
* value comes from {@link difficultyCustomLabel}. Pre-v0.12 this had
* its own `🎮 DIFFICULTY` section after Video Settings.
*/
difficulty?: DifficultyLevel;
/** Free-form label used when `difficulty === "custom"`. */
difficultyCustomLabel?: string;
/**
* Free-text "endings shown" bullet for the `▸ 🎮 PLAYTHROUGH NOTES`
* block (v0.12). Examples: "1 of 3", "True ending only", "All routes
* 100%". Empty → bullet is skipped. Free-form on purpose: the natural
* value space is too varied for an enum.
*/
endingsShown?: string;
/**
* Language-patch state for the `▸ 🎮 PLAYTHROUGH NOTES` block (v0.12).
* `"none"` → skip the bullet. `"official_other"` and `"custom"` pair
* with {@link languagePatchCustom} to surface a free-form value
* ("Official KR", "VNI fan translation v2.1").
*/
languagePatch?: LanguagePatch;
/** Free-form label for `languagePatch === "official_other"` or `"custom"`. */
languagePatchCustom?: string;
/**
* Game-version state for the `▸ 🎮 PLAYTHROUGH NOTES` block (v0.12).
* `"full_release"` → skip the bullet (it's the assumed baseline; no
* need to announce). `"custom"` pairs with {@link gameVersionCustom}.
*/
gameVersion?: GameVersion;
/** Free-form label for `gameVersion === "custom"`. */
gameVersionCustom?: string;
/**
* Accessibility warnings — renders a "⚠️ CONTENT WARNINGS" bulleted
* block after the spoiler section. Empty / missing → skipped.
*/
contentWarnings?: ContentWarning[];
/**
* Tech / production / playstyle disclaimers (v0.12) — renders a
* "▸ 🛠 TECH NOTES" bulleted block after the content-warnings block.
* Bilingual when `tEn` is provided. Empty / missing → skipped.
*/
techNotes?: TechNote[];
storeLinks: Partial<Record<string, string>>;
/**
* Parallel map from the same platform id to a pricing category.
@@ -194,6 +536,17 @@ export interface GeneratorInput {
storeLinkTypes?: Partial<Record<string, StoreLinkType>>;
social: Partial<Record<string, string>>;
rig: Partial<Record<string, string>>;
/**
* Vietnam-specific donate metadata (v0.8 polish). The corresponding
* `🏦 CHUYỂN KHOẢN / VÍ ĐIỆN TỬ` description block is gated on
* {@link language} === `"vi"` — non-Vietnamese viewers don't typically
* use VN bank transfer, so the block stays out of their description.
*/
vnBankName?: string;
vnBankAccount?: string;
vnBankHolder?: string;
vnMomo?: string;
vnZalopay?: string;
}
export interface GeneratorOutput {
@@ -228,6 +581,15 @@ export interface TranslationFn {
(key: string, options?: Record<string, string>): string;
}
/**
* Optional second translation function, fixed to English. Used by the
* description-builder to render the bilingual content-warning block
* (v0.11): each line becomes `{EN} · {output-language}`. The engine
* stays framework-agnostic — the caller (use-generated-output) builds it
* via i18next's `getFixedT("en", "templates")` and passes it in.
*/
export type EnglishTranslationFn = TranslationFn;
/**
* Where the quality-badge ("[2K]") sits relative to the other title segments:
* - "middle" → attached to the video-type segment (v0.6 behavior)
+36 -13
View File
@@ -1,29 +1,52 @@
import { useState, useCallback, useRef } from "react";
import toast from "react-hot-toast";
import { useTranslation } from "react-i18next";
import { logger } from "@utils/logger";
export interface CopyOptions {
limit?: number;
fieldLabel?: string;
}
interface UseClipboardReturn {
copy: (text: string) => Promise<void>;
copy: (text: string, opts?: CopyOptions) => Promise<boolean>;
copied: boolean;
}
export function useClipboard(): UseClipboardReturn {
const { t } = useTranslation("ui");
const [copied, setCopied] = useState(false);
const timeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
const copy = useCallback(async (text: string) => {
try {
await navigator.clipboard.writeText(text);
setCopied(true);
toast.success("Copied!");
const copy = useCallback(
async (text: string, opts?: CopyOptions): Promise<boolean> => {
if (opts?.limit !== undefined && text.length > opts.limit) {
toast.error(
t("output.copy.overLimit", {
field: opts.fieldLabel ?? t("output.copy.fieldGeneric"),
count: text.length,
limit: opts.limit,
}),
);
return false;
}
if (timeoutRef.current) clearTimeout(timeoutRef.current);
timeoutRef.current = setTimeout(() => setCopied(false), 2000);
} catch (e) {
toast.error("Failed to copy");
logger.error("clipboard", "Failed to copy to clipboard", String(e));
}
}, []);
try {
await navigator.clipboard.writeText(text);
setCopied(true);
toast.success(t("output.copied"));
if (timeoutRef.current) clearTimeout(timeoutRef.current);
timeoutRef.current = setTimeout(() => setCopied(false), 2000);
return true;
} catch (e) {
toast.error(t("output.copy.failed"));
logger.error("clipboard", "Failed to copy to clipboard", String(e));
return false;
}
},
[t],
);
return { copy, copied };
}
+93 -74
View File
@@ -1,16 +1,94 @@
import { useMemo } from "react";
import { useEditorStore } from "@store/editor-store";
import { useEditorStore, type EditorData } from "@store/editor-store";
import type { GeneratorInput, SupportedLanguage } from "@engine/types";
/**
* Shapes the editor-store state into a {@link GeneratorInput} — the
* Shapes an editor-store snapshot into a {@link GeneratorInput} — the
* exact blob that every engine function (title / description / tags /
* pinned comment) consumes.
* pinned comment) consumes. Pure function so it's directly testable
* without React rendering; the hook below wraps it in `useMemo` for
* referential stability.
*
* Why a hook: four call sites (two hooks + BatchPage + OutputExtras)
* used to hand-roll the same 25-field object. Adding a new editor
* field meant editing every site; drift was likely. Centralising here
* means one place to update when v0.8 adds more input fields.
* Why split: a v0.12.0 regression silently dropped the new Playthrough
* Notes / Tech Notes fields here when the input shape gained them but
* this mapping wasn't kept in sync — symptom was the editor's checkbox
* state being correct but the description preview never reflecting it.
* Pulling the mapping into a pure function lets tests assert parity
* between {@link EditorData} fields and the resulting `GeneratorInput`,
* so the next field add can't slip through unnoticed.
*/
export function buildGeneratorInputFromEditor(
state: EditorData,
languageOverride?: SupportedLanguage,
): GeneratorInput {
return {
videoType: state.videoType,
language: languageOverride ?? state.language,
genres: state.genres,
gameName: state.gameName,
gameNameLocalized: state.gameNameLocalized,
channelName: state.channelName,
platform: state.platform,
partNumber: state.partNumber,
bossName: state.bossName,
dlcName: state.dlcName,
challengeName: state.challengeName,
modName: state.modName,
modList: state.modList,
liveUrl: state.liveUrl,
scheduledTime: state.scheduledTime,
gachaQuestType: state.gachaQuestType,
chapterName: state.chapterName,
questName: state.questName,
characterName: state.characterName,
anniversaryYear: state.anniversaryYear,
gachaVersion: state.gachaVersion,
resolution: state.resolution,
fps: state.fps,
graphicsPreset: state.graphicsPreset,
graphicsPresetCustom: state.graphicsPresetCustom,
skipGraphicsSettings: state.skipGraphicsSettings,
rayTracingModes: state.rayTracingModes,
frameGenVendor: state.frameGenVendor,
frameGenMultiplier: state.frameGenMultiplier,
upscaleQuality: state.upscaleQuality,
artStyle: state.artStyle,
versionInfo: state.versionInfo,
timestamps: state.timestamps,
playlistLink: state.playlistLink,
contactEmail: state.contactEmail,
musicAttribution: state.musicAttribution,
sponsorName: state.sponsorName,
sponsorPlatform: state.sponsorPlatform,
pubDevName: state.pubDevName,
thirdPartyAdText: state.thirdPartyAdText,
spoilerWarning: state.spoilerWarning,
matureWarning: state.matureWarning,
playthroughStatus: state.playthroughStatus,
difficulty: state.difficulty,
difficultyCustomLabel: state.difficultyCustomLabel,
endingsShown: state.endingsShown,
languagePatch: state.languagePatch,
languagePatchCustom: state.languagePatchCustom,
gameVersion: state.gameVersion,
gameVersionCustom: state.gameVersionCustom,
contentWarnings: state.contentWarnings,
techNotes: state.techNotes,
storeLinks: state.storeLinks,
storeLinkTypes: state.storeLinkTypes,
social: state.social,
rig: state.rig,
vnBankName: state.vnBankName,
vnBankAccount: state.vnBankAccount,
vnBankHolder: state.vnBankHolder,
vnMomo: state.vnMomo,
vnZalopay: state.vnZalopay,
};
}
/**
* Memoised editor-state → GeneratorInput hook used by every engine
* caller (description / title / tags / pinned-comment / batch).
*
* Takes an optional `language` override — BatchPage builds the same
* input for multiple languages, so the hook supports passing a target
@@ -20,72 +98,13 @@ export function useCurrentGeneratorInput(languageOverride?: SupportedLanguage):
const state = useEditorStore();
return useMemo<GeneratorInput>(
() => ({
videoType: state.videoType,
language: languageOverride ?? state.language,
genres: state.genres,
gameName: state.gameName,
gameNameLocalized: state.gameNameLocalized,
channelName: state.channelName,
platform: state.platform,
partNumber: state.partNumber,
bossName: state.bossName,
dlcName: state.dlcName,
challengeName: state.challengeName,
modName: state.modName,
resolution: state.resolution,
fps: state.fps,
graphicsPreset: state.graphicsPreset,
timestamps: state.timestamps,
playlistLink: state.playlistLink,
contactEmail: state.contactEmail,
musicAttribution: state.musicAttribution,
sponsorName: state.sponsorName,
sponsorPlatform: state.sponsorPlatform,
spoilerWarning: state.spoilerWarning,
matureWarning: state.matureWarning,
playthroughStatus: state.playthroughStatus,
difficulty: state.difficulty,
difficultyCustomLabel: state.difficultyCustomLabel,
contentWarnings: state.contentWarnings,
storeLinks: state.storeLinks,
storeLinkTypes: state.storeLinkTypes,
social: state.social,
rig: state.rig,
}),
[
languageOverride,
state.videoType,
state.language,
state.genres,
state.gameName,
state.gameNameLocalized,
state.channelName,
state.platform,
state.partNumber,
state.bossName,
state.dlcName,
state.challengeName,
state.modName,
state.resolution,
state.fps,
state.graphicsPreset,
state.timestamps,
state.playlistLink,
state.contactEmail,
state.musicAttribution,
state.sponsorName,
state.sponsorPlatform,
state.spoilerWarning,
state.matureWarning,
state.playthroughStatus,
state.difficulty,
state.difficultyCustomLabel,
state.contentWarnings,
state.storeLinks,
state.storeLinkTypes,
state.social,
state.rig,
],
// `useEditorStore()` (no selector) returns a fresh `state` reference
// on every store update, so depending on `state` alone captures every
// field change without enumerating each one — same memoisation
// behaviour as the old per-field deps list, minus the v0.12.0 footgun
// (any field added to EditorData but missing from the deps list would
// silently stop participating in the memo invalidation).
() => buildGeneratorInputFromEditor(state, languageOverride),
[state, languageOverride],
);
}
+19
View File
@@ -0,0 +1,19 @@
import { useEffect } from "react";
/**
* Sets `document.title` to `"<title> · YTDescGen"` for the lifetime of the
* component, and restores the previous title on unmount. Per-page titles
* help with browser-tab readability and OS-level window menus (and feed
* the OG tag in `index.html` for the root route).
*
* Pass the localized page name — e.g. `useDocumentTitle(t("tabs.editor"))`.
*/
export function useDocumentTitle(title: string): void {
useEffect(() => {
const previous = document.title;
document.title = `${title} · YTDescGen`;
return () => {
document.title = previous;
};
}, [title]);
}
+9
View File
@@ -15,10 +15,15 @@ export function useGeneratedOutput(): GeneratorOutput {
showCopyright,
showUsagePolicy,
showSponsorCredit,
showThirdPartyAds,
titleFormat,
} = useSettingsStore();
const t = useMemo(() => i18n.getFixedT(input.language, "templates"), [input.language]);
// Always-English `t` for the v0.11 bilingual content-warning block.
// Built once per render so the engine receives a stable function ref;
// the engine falls back to `t` when this is undefined.
const tEn = useMemo(() => i18n.getFixedT("en", "templates"), []);
return useMemo(
() =>
@@ -30,11 +35,14 @@ export function useGeneratedOutput(): GeneratorOutput {
showCopyright,
showUsagePolicy,
showSponsorCredit,
showThirdPartyAds,
titleFormat,
tEn,
}),
[
input,
t,
tEn,
includeMultilingualTags,
includeTrendingTags,
hashtagCount,
@@ -42,6 +50,7 @@ export function useGeneratedOutput(): GeneratorOutput {
showCopyright,
showUsagePolicy,
showSponsorCredit,
showThirdPartyAds,
titleFormat,
],
);
+39 -2
View File
@@ -6,9 +6,13 @@ import toast from "react-hot-toast";
interface ShortcutOptions {
onToggleHelp: () => void;
onToggleSidebar: () => void;
}
export function useKeyboardShortcuts({ onToggleHelp }: ShortcutOptions) {
export function useKeyboardShortcuts({
onToggleHelp,
onToggleSidebar,
}: ShortcutOptions) {
const navigate = useNavigate();
const output = useGeneratedOutput();
const { copy } = useClipboard();
@@ -26,13 +30,46 @@ export function useKeyboardShortcuts({ onToggleHelp }: ShortcutOptions) {
} else if (ctrl && !e.shiftKey && e.key === "s") {
e.preventDefault();
toast.success("Draft saved");
} else if (ctrl && !e.shiftKey && (e.key === "b" || e.key === "B")) {
// VS Code convention: Ctrl/Cmd+B toggles the sidebar.
e.preventDefault();
onToggleSidebar();
} else if (ctrl && e.key === "/") {
e.preventDefault();
onToggleHelp();
} else if (
// Bare `?` (Shift+/) opens the cheatsheet too. Skip when the
// user is typing into a form field — `?` is a legitimate
// character in titles, descriptions, and other inputs.
e.key === "?" &&
!ctrl &&
!isEditableTarget(e.target)
) {
e.preventDefault();
onToggleHelp();
}
};
window.addEventListener("keydown", handleKeyDown);
return () => window.removeEventListener("keydown", handleKeyDown);
}, [navigate, output.title, output.description, copy, onToggleHelp]);
}, [
navigate,
output.title,
output.description,
copy,
onToggleHelp,
onToggleSidebar,
]);
}
/**
* True when the keydown target is an input the user might be typing
* into. Used to gate bare-character shortcuts (e.g. `?`) so they don't
* hijack normal text entry.
*/
function isEditableTarget(target: EventTarget | null): boolean {
if (!(target instanceof HTMLElement)) return false;
const tag = target.tagName;
if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
return target.isContentEditable;
}
+166 -18
View File
@@ -1,7 +1,20 @@
{
"ui": {
"app": ["title", "subtitle"],
"tabs": ["editor", "output", "profiles", "history", "settings", "batch", "playlist", "logs"],
"tabs": ["editor", "output", "profiles", "history", "settings", "batch", "playlist", "logs", "about", "reportBug"],
"sidebar": ["expand", "collapse"],
"header": ["donate"],
"about": [
"tagline",
"repoHeading", "repoLabel", "issuesLabel", "reportBugLabel", "discussionsLabel", "authorLabel", "licenseLabel",
"donateHeading", "donateHelp",
"connectHeading",
"devEnvHeading", "devEnvHelp",
"thirdPartyHeading", "thirdPartyHelp"
],
"about.donate": ["githubSponsors", "kofi", "buyMeACoffee", "patreon", "paypal"],
"about.devEnv": ["os", "cpu", "gpu", "ram", "ide", "toolchains", "fullSpecLink", "fullDevEnvLink"],
"about.socials": ["youtube", "x", "bluesky", "mastodon", "discord", "discordGame", "steam", "telegramBot", "telegramUser", "email"],
"editor.sections": ["gameInfo", "videoSettings", "contentDetails", "attribution", "rig", "storeAndSocial"],
"editor": [
"videoType", "language", "genre", "gameName", "gameNamePlaceholder",
@@ -9,25 +22,105 @@
"partNumber", "partNumberPlaceholder", "bossName", "bossNamePlaceholder",
"dlcName", "dlcNamePlaceholder", "challengeName", "challengeNamePlaceholder",
"modName", "modNamePlaceholder",
"modList", "modListPlaceholder",
"gachaQuestType",
"chapterName", "chapterNamePlaceholder",
"questName", "questNamePlaceholder",
"characterName", "characterNamePlaceholder",
"anniversaryYear", "anniversaryYearOption",
"gachaVersion", "gachaVersionPlaceholder",
"gpu_brand", "gpu_series", "gpu_model", "gpu_custom",
"ram_size", "ram_ddr",
"vnDonate", "vnDonateHelp",
"vnBankName", "vnBankNamePlaceholder",
"vnBankAccount", "vnBankAccountPlaceholder",
"vnBankHolder", "vnBankHolderPlaceholder",
"vnMomo", "vnMomoPlaceholder",
"vnZalopay", "vnZalopayPlaceholder",
"resolution", "fps", "graphicsPreset",
"graphicsPresetCustom", "graphicsPresetCustomPlaceholder",
"skipGraphicsSettings", "skipGraphicsSettingsHelp",
"rayTracing", "frameGenVendor", "frameGenMultiplier", "upscaleQuality",
"artStyle", "versionInfo", "versionInfoPlaceholder",
"liveUrl", "liveUrlPlaceholder", "scheduledTime",
"skipGraphicsHintLabel", "skipGraphicsHintHide", "skipGraphicsHintKeep",
"timestamps", "timestampsPlaceholder",
"storeLinks", "storeLinkType", "rig", "social", "warnings",
"spoilerWarning", "matureWarning",
"playlistLink", "playlistLinkPlaceholder",
"contactEmail", "contactEmailPlaceholder", "contactEmailHelp",
"musicAttribution", "musicAttributionPlaceholder",
"sponsorName", "sponsorNamePlaceholder",
"sponsorPlatform", "sponsorPlatformPlaceholder",
"pubDevName", "pubDevNamePlaceholder",
"thumbnailText", "thumbnailTextPlaceholder",
"pinnedComment", "pinnedCommentPlaceholder",
"playthrough", "difficulty", "difficultyCustomLabel", "difficultyCustomPlaceholder",
"contentWarnings",
"contentWarningSearchPlaceholder", "contentWarningEmpty",
"techNotes", "techNoteSearchPlaceholder", "techNoteEmpty",
"videoSettings", "quickPreview", "version",
"clearDraft", "draftSaved", "clearDraftConfirm"
"clearDraft", "draftSaved", "clearDraftConfirm",
"genreSearchPlaceholder", "genreSearchNoResults"
],
"editor.genreGroups": ["rpg", "shooter", "horror"],
"editor.graphicsPresetOptions": ["low", "medium", "high", "very_high", "cinematic", "ultra", "extreme", "custom"],
"editor.rtOptions": ["ray_tracing", "full_rt", "path_tracing", "ray_reconstruction"],
"editor.frameGenVendorOptions": ["none", "nvidia", "amd", "intel"],
"editor.frameGenMultiplierOptions": ["none", "x2", "x3", "x4", "x6"],
"editor.frameGenMultiplier.nvidia": ["none", "x2", "x3", "x4"],
"editor.frameGenMultiplier.amd": ["none", "x2", "x3"],
"editor.frameGenMultiplier.intel": ["none", "x2"],
"editor.upscaleQualityOptions": ["none", "native_aa", "quality", "balanced", "performance", "ultra_performance"],
"editor.upscaleQuality.nvidia": ["none", "dlaa", "quality", "balanced", "performance", "ultra_performance"],
"editor.upscaleQuality.amd": ["none", "native_aa", "quality", "balanced", "performance", "ultra_performance"],
"editor.upscaleQuality.intel": ["none", "native_aa", "ultra_quality", "quality", "balanced", "performance", "ultra_performance"],
"editor.artStyleOptions": ["none", "realistic", "stylized", "anime", "cel_shaded", "low_poly", "voxel", "pixel_art", "hand_drawn", "comic", "photorealistic"],
"editor.toast": ["urlAutoFilled"],
"editor.warning": ["linkNameMismatch"],
"editor.validation": [
"gpuMissingSeries", "gpuMissingModel", "gpuCustomEmpty",
"ramMissingDdr", "ramMissingSize", "ramCustomEmpty"
],
"editor.playthroughOptions": ["none", "blind", "replay", "newgame_plus", "postgame"],
"editor.difficultyOptions": ["none", "easy", "normal", "hard", "nightmare", "custom"],
"editor.contentWarningOptions": ["flashing_lights", "loud_noises", "jump_scares"],
"editor.playthroughNotes": [
"title",
"runTypeLabel", "difficultyLabel", "endingsLabel", "endingsPlaceholder",
"languagePatchLabel", "languagePatchCustomLabel", "languagePatchCustomPlaceholder",
"gameVersionLabel", "gameVersionCustomLabel", "gameVersionCustomPlaceholder"
],
"editor.playthroughNotes.languagePatchOptions": ["none", "official_en", "official_other", "fan_translation", "mtl", "custom"],
"editor.playthroughNotes.gameVersionOptions": ["full_release", "demo", "early_access", "beta", "prologue", "pre_release", "custom"],
"editor.techNoteGroups": ["audio", "video_quality", "recording_issues", "playstyle", "production"],
"editor.techNoteOptions": [
"copyright_muted_sections", "volume_reduced_copyright", "music_replaced_copyright", "cutscene_audio_muted_only", "original_audio_kept",
"low_resolution_hardware", "low_graphics_performance", "fps_drops_hardware",
"bug_from_game", "crash_kept_transparency", "loading_cut", "obs_artifacts_possible",
"not_no_hit_run", "not_clean_walkthrough", "casual_no_commentary", "many_deaths_patience", "slow_exploration", "puzzle_stuck_possible", "grinding_cut", "not_speedrun_relaxed",
"exploration_focus_skip_combat", "edited_for_pacing", "support_developers", "online_connectivity_issues"
],
"editor.contentWarningGroups": ["spoilers", "photosensitive", "phobias", "mental_health", "sensitive", "playstyle", "horror_specific", "gameplay_disclosure"],
"editor.contentWarningOptions": [
"spoiler_story", "spoiler_ending", "spoiler_true_ending", "spoiler_post_game", "spoiler_secret_ending", "spoiler_dlc",
"flashing_lights", "motion_sickness", "migraine_trigger", "loud_noises", "strobe_effects", "screen_shake_intense",
"jump_scares", "acrophobia", "trypophobia", "thalassophobia", "claustrophobia", "arachnophobia", "entomophobia", "ophidiophobia",
"cynophobia", "nyctophobia", "pyrophobia", "pediophobia", "hemophobia", "coulrophobia", "ablutophobia", "taphophobia",
"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",
"blood_gore", "mature_18plus", "disturbing_imagery", "animal_abuse", "child_harm", "domestic_violence", "sexual_assault", "torture", "religion_themes", "war_violence", "discrimination", "police_violence", "smoking_drinking", "detailed_killing", "cult_occult", "psychological_manipulation", "grief_loss", "kidnapping",
"hate_speech", "historical_atrocity", "slavery_themes", "terrorism_themes", "bullying_themes", "human_experimentation", "cannibalism", "nuclear_themes",
"blind_playthrough", "no_spoilers_chat", "casual_difficulty", "hardcore_difficulty", "permadeath_run", "speedrun_attempt", "completionist_run", "learning_mechanics", "first_time_playing", "returning_player",
"eye_horror", "body_horror", "face_horror", "cosmic_horror", "extreme_gore", "decay_rot", "mutilation", "liminal_spaces", "analog_horror", "unreality_themes", "pursuit_chase", "entity_horror",
"mods_used", "cheats_enabled", "glitch_exploits", "assisted_run"
],
"editor.gachaQuestTypeOptions": [
"main_story", "world_quest", "side_quest", "spinoff_quest", "companion_quest", "bond_quest",
"event", "anniversary", "crossover", "dating_event",
"tutorial_quest", "guide_quest", "trial_quest",
"endgame", "coop", "daily_commission",
"showcase"
],
"editor.gachaQuestTypeGroups": ["story", "events", "tutorial_trial", "endgame_multiplayer", "showcase"],
"storeLinkTypes": ["paid", "free", "demo"],
"output": [
"title", "description", "tags",
@@ -39,46 +132,101 @@
"generateAlternatives", "saveAsTemplate"
],
"output.variants": ["default", "typeFirst", "qualityFirst"],
"common": ["save", "cancel", "delete", "confirm", "export", "import", "reset", "search", "generate"],
"videoTypes": ["full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles"],
"output.copy": ["overLimit", "fieldGeneric", "failed"],
"common": ["save", "cancel", "delete", "confirm", "export", "import", "reset", "search", "generate", "undo", "dismiss"],
"videoTypes": ["full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles", "livestream", "gacha_quest"],
"genres": ["action", "hack_slash", "beatemup", "platformer", "horror", "survival_horror", "psychological_horror", "rpg", "jrpg", "action_rpg", "crpg", "fps", "arena_shooter", "tactical_fps", "boomer_shooter", "extraction_shooter", "shmup", "openworld", "indie", "soulslike", "racing", "story", "simulation", "city_builder", "fighting", "stealth", "survival_craft", "roguelike", "metroidvania", "mmo", "rhythm", "puzzle", "tower_defense", "card_game", "deck_builder", "auto_battler", "battle_royale", "tactical", "space", "farming", "fmv", "visual_novel"],
"rig": ["cpu", "gpu", "ram", "storage", "monitor", "capture", "motherboard", "controller", "video_editor"],
"social": ["kofi", "patreon", "buymeacoffee", "paypal", "github", "twitter", "discord", "website", "twitch", "tiktok", "instagram", "streamlabs", "bluesky", "mastodon", "facebook", "fb_page", "fb_group"],
"resolutions": ["720p", "1080p", "1440p", "4K"],
"fpsOptions": ["30", "60", "120", "144"],
"profiles": ["title", "createNew", "editProfile", "profileName", "profileNamePlaceholder", "loadProfile", "deleteConfirm", "emptyState", "exportProfiles", "importProfiles"],
"profiles": ["title", "createNew", "editProfile", "profileName", "profileNamePlaceholder", "loadProfile", "deleteConfirm", "emptyState", "exportProfiles", "importProfiles", "thirdPartyAdText", "thirdPartyAdTextPlaceholder", "thirdPartyAdTextHelp"],
"presets": ["title", "createNew", "editPreset", "loadPreset", "deleteConfirm", "emptyState", "selectPreset", "noPresets", "exportPresets", "importPresets"],
"templates": ["title", "createNew", "saveAsTemplate", "templateName", "templateNamePlaceholder", "loadTemplate", "deleteConfirm", "emptyState", "saveHint", "savedAs", "appliedToast", "exportTemplates", "importTemplates"],
"history": ["title", "emptyState", "clearAll", "clearConfirm", "searchPlaceholder"],
"settings": ["title", "appearance", "defaults", "editorSettings", "tagSettings", "historySettings", "theme", "appLanguage", "defaultOutputLanguage", "defaultGenre", "showCharCount", "compactTagDisplay", "historyLimit", "multilingualTags", "trendingTags", "hashtagCount", "showQualityBadge", "showCopyright", "showUsagePolicy", "showSponsorCredit", "titleFormatTitle", "descriptionSettingsTitle", "badgePosition", "badgePositionPrefix", "badgePositionMiddle", "badgePositionSuffix", "titleSeparator", "titleSeparatorEmDash", "titleSeparatorHyphen", "titleSeparatorColon", "titleSeparatorPipe", "badgeCase", "badgeCaseUpper", "badgeCaseLower", "showPinnedCommentTemplate", "pinnedCommentIncludeAskNextGame"],
"settings": ["title", "appearance", "defaults", "editorSettings", "tagSettings", "historySettings", "theme", "appLanguage", "defaultOutputLanguage", "defaultGenre", "showCharCount", "compactTagDisplay", "historyLimit", "multilingualTags", "trendingTags", "hashtagCount", "showQualityBadge", "showCopyright", "showUsagePolicy", "showSponsorCredit", "showThirdPartyAds", "thirdPartyAdsHint", "titleFormatTitle", "descriptionSettingsTitle", "badgePosition", "badgePositionPrefix", "badgePositionMiddle", "badgePositionSuffix", "titleSeparator", "titleSeparatorEmDash", "titleSeparatorHyphen", "titleSeparatorColon", "titleSeparatorPipe", "badgeCase", "badgeCaseUpper", "badgeCaseLower", "showPinnedCommentTemplate", "pinnedCommentIncludeAskNextGame", "pinnedCommentIncludeGenrePlaylist", "genrePlaylistsTitle", "genrePlaylistsHelp", "genrePlaylistsEmptyHint"],
"batch": ["title", "startPart", "endPart", "generateBatch", "copyAllBatch", "emptyState"],
"shortcuts": ["title", "generate", "copyAll", "saveDraft", "help", "close"],
"validation": ["emailInvalid", "emailMaxExceeded", "urlInvalid", "urlPrefixMismatch"],
"shortcuts": ["title", "generate", "copyAll", "saveDraft", "toggleSidebar", "help", "close", "searchPlaceholder", "noResults"],
"validation": ["emailInvalid", "emailMaxExceeded", "urlInvalid", "urlPrefixMismatch", "playlistUrlInvalid"],
"logs": ["title", "emptyState", "clearAll", "clearConfirm", "searchPlaceholder"],
"playlist": ["title", "status", "contentType", "totalVideos", "customNote", "generatePlaylist"]
},
"templates": {
"title": ["separator", "suffix"],
"title.separators": ["emDash", "hyphen", "colon", "pipe"],
"title.videoType": ["full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles"],
"description.intro": ["full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles"],
"title.videoType": ["full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles", "livestream", "gacha_quest"],
"title.gachaQuestType": [
"main_story", "world_quest", "side_quest", "spinoff_quest", "companion_quest", "bond_quest",
"event", "anniversary", "crossover", "dating_event",
"tutorial_quest", "guide_quest", "trial_quest",
"endgame", "coop", "daily_commission",
"showcase"
],
"title.gachaPartSuffix": ["part", "day", "floor"],
"description.intro": [
"full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending", "speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest", "secret", "comparison", "guide", "mods", "collectibles", "livestream",
"gacha_quest_main_story", "gacha_quest_world_quest", "gacha_quest_side_quest", "gacha_quest_spinoff_quest", "gacha_quest_companion_quest", "gacha_quest_bond_quest",
"gacha_quest_event", "gacha_quest_anniversary", "gacha_quest_crossover", "gacha_quest_dating_event",
"gacha_quest_tutorial_quest", "gacha_quest_guide_quest", "gacha_quest_trial_quest",
"gacha_quest_endgame", "gacha_quest_coop", "gacha_quest_daily_commission",
"gacha_quest_showcase",
"versionInline"
],
"description": ["noCommentaryLine"],
"description.sections": [
"timestamps", "storeLinksBuy", "storeLinksDownload", "videoSettings", "rig",
"spoilerWarning", "matureWarning", "sponsorCredit", "music", "donate", "social",
"modList", "vnDonate",
"sponsorCredit", "thirdPartyAds", "music", "donate", "social",
"playlist", "contact", "cta",
"copyright", "usagePolicyHeader", "usagePolicy",
"playthrough", "difficulty", "contentWarnings"
"copyright", "usagePolicyHeader", "usagePolicy"
],
"description.playthrough": ["blind", "replay", "newgame_plus", "postgame"],
"description.difficulty": ["easy", "normal", "hard", "nightmare"],
"description.contentWarnings": ["flashing_lights", "loud_noises", "jump_scares"],
"description.playthroughNotes": ["header", "intro"],
"description.playthroughNotes.labels": ["runType", "difficulty", "endings", "languagePatch", "gameVersion"],
"description.playthroughNotes.languagePatchOptions": ["official_en", "official_other", "fan_translation", "mtl", "custom"],
"description.playthroughNotes.gameVersionOptions": ["demo", "early_access", "beta", "prologue", "pre_release", "custom"],
"description.techNotes": ["header", "intro"],
"description.techNotes.items": [
"copyright_muted_sections", "volume_reduced_copyright", "music_replaced_copyright", "cutscene_audio_muted_only", "original_audio_kept",
"low_resolution_hardware", "low_graphics_performance", "fps_drops_hardware",
"bug_from_game", "crash_kept_transparency", "loading_cut", "obs_artifacts_possible",
"not_no_hit_run", "not_clean_walkthrough", "casual_no_commentary", "many_deaths_patience", "slow_exploration", "puzzle_stuck_possible", "grinding_cut", "not_speedrun_relaxed",
"exploration_focus_skip_combat", "edited_for_pacing", "support_developers", "online_connectivity_issues"
],
"description.contentWarnings": ["header", "intro"],
"description.contentWarnings.items": [
"spoiler_story", "spoiler_ending", "spoiler_true_ending", "spoiler_post_game", "spoiler_secret_ending", "spoiler_dlc",
"flashing_lights", "motion_sickness", "migraine_trigger", "loud_noises", "strobe_effects", "screen_shake_intense",
"jump_scares", "acrophobia", "trypophobia", "thalassophobia", "claustrophobia", "arachnophobia", "entomophobia", "ophidiophobia",
"cynophobia", "nyctophobia", "pyrophobia", "pediophobia", "hemophobia", "coulrophobia", "ablutophobia", "taphophobia",
"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",
"blood_gore", "mature_18plus", "disturbing_imagery", "animal_abuse", "child_harm", "domestic_violence", "sexual_assault", "torture", "religion_themes", "war_violence", "discrimination", "police_violence", "smoking_drinking", "detailed_killing", "cult_occult", "psychological_manipulation", "grief_loss", "kidnapping",
"hate_speech", "historical_atrocity", "slavery_themes", "terrorism_themes", "bullying_themes", "human_experimentation", "cannibalism", "nuclear_themes",
"blind_playthrough", "no_spoilers_chat", "casual_difficulty", "hardcore_difficulty", "permadeath_run", "speedrun_attempt", "completionist_run", "learning_mechanics", "first_time_playing", "returning_player",
"eye_horror", "body_horror", "face_horror", "cosmic_horror", "extreme_gore", "decay_rot", "mutilation", "liminal_spaces", "analog_horror", "unreality_themes", "pursuit_chase", "entity_horror",
"mods_used", "cheats_enabled", "glitch_exploits", "assisted_run"
],
"description.storeLinkSuffix": ["free", "demo"],
"pinnedComment": ["thanksForWatching", "playlistPrompt", "engagementPrompt", "askNextGame"],
"description.graphics": ["with", "artStyle", "videoLabel", "inGameSettingLabel", "versionLabel"],
"description.graphics.presetOptions": ["low", "medium", "high", "very_high", "cinematic", "ultra", "extreme"],
"description.graphics.rtOptions": ["ray_tracing", "full_rt", "path_tracing", "ray_reconstruction"],
"description.graphics.upscaleQualityOptions": ["native_aa", "quality", "balanced", "performance", "ultra_performance"],
"description.graphics.upscale.nvidia": ["none", "dlaa", "quality", "balanced", "performance", "ultra_performance"],
"description.graphics.upscale.amd": ["none", "native_aa", "quality", "balanced", "performance", "ultra_performance"],
"description.graphics.upscale.intel": ["none", "native_aa", "ultra_quality", "quality", "balanced", "performance", "ultra_performance"],
"description.graphics.frameGen.nvidia": ["none", "x2", "x3", "x4"],
"description.graphics.frameGen.amd": ["none", "x2", "x3"],
"description.graphics.frameGen.intel": ["none", "x2"],
"description.graphics.artStyleOptions": ["realistic", "stylized", "anime", "cel_shaded", "low_poly", "voxel", "pixel_art", "hand_drawn", "comic", "photorealistic"],
"description.livestream": ["scheduledLine", "watchLine"],
"pinnedComment": ["thanksForWatching", "playlistPrompt", "engagementPrompt", "askNextGame", "genrePlaylistSuggestion"],
"pinnedComment.greetings": [
"full", "part", "full_demo", "demo_part", "boss", "boss_nohit", "ending",
"speedrun", "100percent", "dlc", "newgame_plus", "challenge", "side_quest",
"secret", "comparison", "guide", "mods", "collectibles"
"secret", "comparison", "guide", "mods", "collectibles", "livestream",
"gacha_quest"
],
"hashtags": ["gameplay", "noCommentary", "genre"],
"playlist.status": ["completed", "dropped", "incomplete", "in_progress"],
+301 -12
View File
@@ -26,7 +26,33 @@
"comparison": "Comparison",
"guide": "Guide",
"mods": "{{modName}} Mods",
"collectibles": "All Collectibles"
"collectibles": "All Collectibles",
"livestream": "🔴 LIVE",
"gacha_quest": ""
},
"gachaQuestType": {
"main_story": "{{gameName}} — {{chapterName}}{{partSuffix}}",
"world_quest": "{{gameName}} — World Quest: {{questName}}",
"side_quest": "{{gameName}} — Side Quest: {{questName}}",
"spinoff_quest": "{{gameName}} — Spinoff: {{questName}}",
"companion_quest": "{{gameName}} — Companion Quest: {{questName}}",
"bond_quest": "{{gameName}} — Bond Quest: {{questName}}",
"event": "{{gameName}} — Event: {{questName}}",
"anniversary": "{{gameName}} — {{anniversaryYear}}{{ordinalSuffix}} Anniversary{{partSuffix}}",
"crossover": "{{gameName}} — Crossover: {{questName}}",
"dating_event": "{{gameName}} — Dating Event: {{questName}}",
"tutorial_quest": "{{gameName}} — Tutorial: {{questName}}",
"guide_quest": "{{gameName}} — Guide: {{questName}}",
"trial_quest": "{{gameName}} — Trial: {{questName}}",
"endgame": "{{gameName}} — {{chapterName}}{{partSuffix}}",
"coop": "{{gameName}} — Co-op: {{questName}}",
"daily_commission": "{{gameName}} — Daily Commissions{{partSuffix}}",
"showcase": "{{gameName}} — Character Showcase: {{characterName}}"
},
"gachaPartSuffix": {
"part": " - Part {{n}}",
"day": " - Day {{n}}",
"floor": " - Floor {{n}}"
}
},
"description": {
@@ -48,7 +74,26 @@
"comparison": "This video compares the graphics/performance of {{gameName}} on {{channelName}}.",
"guide": "This video is a silent guide for {{gameName}} on {{channelName}}.",
"mods": "This video features the {{modName}} mod for {{gameName}} on {{channelName}}.",
"collectibles": "This video covers all collectibles and 100% completion of {{gameName}} on {{channelName}}."
"collectibles": "This video covers all collectibles and 100% completion of {{gameName}} on {{channelName}}.",
"livestream": "Live stream of {{gameName}} on {{channelName}}. Join the chat and say hi!",
"gacha_quest_main_story": "Welcome to {{chapterName}} of {{gameName}} on {{channelName}}!",
"gacha_quest_world_quest": "Today's video covers the World Quest \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_side_quest": "Side Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_spinoff_quest": "Spinoff quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_companion_quest": "Companion Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_bond_quest": "Bond Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_event": "Limited-time Event \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_anniversary": "Celebrating the {{anniversaryYear}}{{ordinalSuffix}} anniversary of {{gameName}}{{versionLabel}} on {{channelName}}.",
"gacha_quest_crossover": "Crossover Event \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_dating_event": "Dating Event \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_tutorial_quest": "Tutorial \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_guide_quest": "Guide Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_trial_quest": "Trial Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_endgame": "Endgame mode \"{{chapterName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_coop": "Co-op session \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_daily_commission": "Daily Commissions in {{gameName}} on {{channelName}}.",
"gacha_quest_showcase": "This video showcases the skills, appearance, and details of {{characterName}} in {{gameName}}{{versionLabel}} on {{channelName}}.",
"versionInline": "version {{v}}"
},
"noCommentaryLine": "No Commentary — pure gameplay for your enjoyment.",
"storeLinkSuffix": {
@@ -61,9 +106,10 @@
"storeLinksDownload": "⬇️ DOWNLOAD THE GAME (if you want to play)",
"videoSettings": "🖥 VIDEO SETTINGS",
"rig": "💻 MY RIG",
"spoilerWarning": "⚠️ SPOILER WARNING: This video may contain spoilers. Watch at your own risk!",
"matureWarning": "🔞 MATURE CONTENT (18+): Contains violence / strong language / graphic content.",
"modList": "🧩 MOD LIST",
"vnDonate": "🏦 BANK TRANSFER / E-WALLET (Vietnam)",
"sponsorCredit": "🎁 Thanks to {{sponsor}} for providing the {{platform}} key of this game.",
"thirdPartyAds": "🤝 SPONSORS & PARTNERS",
"music": "🎵 MUSIC / SOUND",
"donate": "☕ SUPPORT THE CHANNEL",
"social": "🔗 FOLLOW ME",
@@ -72,10 +118,7 @@
"cta": "👍 Like | 🔔 Subscribe | ↗️ Share",
"copyright": "© {{year}} {{channelName}}. All rights reserved.",
"usagePolicyHeader": "📋 USAGE POLICY",
"usagePolicy": "• Always credit with a link to the original video AND channel (at minimum in the description).\n• Don't re-upload the full video or large portions as your own content.\n• Don't monetize footage without explicit consent.\n• Don't edit footage to misrepresent the original content or creator.\n• Compilation, review, commentary, and reaction videos are OK — as long as you credit.\nIf in doubt, reach out via the social links or email in the description.",
"playthrough": "🎯 Playthrough: {{value}}",
"difficulty": "🎮 DIFFICULTY",
"contentWarnings": "⚠️ CONTENT WARNINGS"
"usagePolicy": "• Always credit with a link to the original video AND channel (at minimum in the description).\n• Don't re-upload the full video or large portions as your own content.\n• Don't monetize footage without explicit consent.\n• Don't edit footage to misrepresent the original content or creator.\n• Compilation, review, commentary, and reaction videos are OK — as long as you credit.\nIf in doubt, reach out via the social links or email in the description."
},
"playthrough": {
"blind": "Blind run (first time playing)",
@@ -89,10 +132,253 @@
"hard": "Hard",
"nightmare": "Nightmare / Extreme"
},
"playthroughNotes": {
"header": "▸ 🎮 PLAYTHROUGH NOTES",
"intro": "This run's settings, version, and approach.",
"labels": {
"runType": "Run type",
"difficulty": "Difficulty",
"endings": "Endings shown",
"languagePatch": "Language patch",
"gameVersion": "Game version"
},
"languagePatchOptions": {
"official_en": "Official English release",
"official_other": "Official release (other locale)",
"fan_translation": "Fan translation",
"mtl": "Machine translation",
"custom": "Custom"
},
"gameVersionOptions": {
"demo": "Demo",
"early_access": "Early Access",
"beta": "Beta",
"prologue": "Prologue / Teaser",
"pre_release": "Pre-release build",
"custom": "Custom"
}
},
"techNotes": {
"header": "▸ 🛠 TECH NOTES",
"intro": "Production and playstyle notes for transparency.",
"items": {
"copyright_muted_sections": "Some sections muted due to YouTube copyright",
"volume_reduced_copyright": "Volume reduced in some sections due to copyright",
"music_replaced_copyright": "Game music replaced to avoid copyright claims",
"cutscene_audio_muted_only": "Only cutscene audio muted — gameplay audio kept",
"original_audio_kept": "Original audio kept — accepting potential claim risk",
"low_resolution_hardware": "Recorded at lower resolution due to hardware",
"low_graphics_performance": "Graphics settings lowered for performance",
"fps_drops_hardware": "FPS drops — caused by hardware (FPS counter visible top-left)",
"bug_from_game": "Bugs / glitches are from the game, not the recording",
"crash_kept_transparency": "Game crash kept in for transparency",
"loading_cut": "Loading screens have been cut",
"obs_artifacts_possible": "Possible OBS recording artifacts",
"not_no_hit_run": "NOT a no-hit run — looking for clean play, skip this",
"not_clean_walkthrough": "Not a polished walkthrough — exploring naturally",
"casual_no_commentary": "Casual play, no commentary",
"many_deaths_patience": "Many deaths — patience required",
"slow_exploration": "Lots of backtracking — slow exploration pace",
"puzzle_stuck_possible": "May get stuck on puzzles",
"grinding_cut": "Grinding / repetitive sections cut",
"not_speedrun_relaxed": "Not a speedrun — relaxed playthrough",
"exploration_focus_skip_combat": "Exploration-focused — combat may be skipped",
"edited_for_pacing": "Edited for pacing — not real-time",
"support_developers": "Original game music — please support the developers",
"online_connectivity_issues": "Online game — possible connectivity issues"
}
},
"contentWarnings": {
"flashing_lights": "⚡ Flashing lights / strobe effects",
"loud_noises": "🔊 Loud noises / sudden volume spikes",
"jump_scares": "😱 Jump scares"
"header": "▸ ⚠️ CONTENT WARNINGS",
"intro": "This video contains the following content. Viewer discretion advised.",
"items": {
"spoiler_story": "Spoilers — story / ending / true ending",
"spoiler_ending": "Spoilers — ending only",
"spoiler_true_ending": "Spoilers — true ending only",
"spoiler_post_game": "Spoilers — post-game / New Game+ content",
"spoiler_secret_ending": "Spoilers — secret ending",
"spoiler_dlc": "Spoilers — DLC story",
"flashing_lights": "Flashing lights — photosensitive viewers take care",
"motion_sickness": "Motion sickness — fast camera / FPS movement",
"migraine_trigger": "Possible migraine trigger",
"loud_noises": "Loud / sudden sounds",
"jump_scares": "Jumpscares",
"acrophobia": "Heights",
"trypophobia": "Holes / clusters",
"thalassophobia": "Deep water",
"claustrophobia": "Confined spaces",
"arachnophobia": "Spiders",
"entomophobia": "Insects",
"ophidiophobia": "Snakes",
"cynophobia": "Dogs",
"nyctophobia": "Darkness / pitch-black scenes",
"pyrophobia": "Fire / burning scenes",
"pediophobia": "Dolls / mannequins",
"hemophobia": "Blood",
"anxiety_inducing": "Scenes that may cause anxiety",
"depression_themes": "Depression themes",
"eating_disorders": "Eating disorder themes",
"substance_use": "Substance use",
"self_harm": "Self-harm / suicide themes",
"ptsd_themes": "PTSD-related content",
"needles": "Needle imagery",
"body_fluids": "Body fluids",
"pregnancy_horror": "Pregnancy / birth horror",
"illness_themes": "Illness / infection themes",
"bipolar_themes": "Bipolar disorder themes",
"ocd_themes": "Obsessive-compulsive themes",
"panic_attacks": "Panic attack scenes",
"dissociation": "Dissociation / derealization themes",
"blood_gore": "Blood and gore",
"mature_18plus": "Mature themes — 18+",
"disturbing_imagery": "Disturbing imagery",
"animal_abuse": "Animal cruelty",
"child_harm": "Violence against minors",
"domestic_violence": "Domestic violence",
"sexual_assault": "Sexual assault references",
"torture": "Torture scenes",
"religion_themes": "Religious themes",
"war_violence": "War violence",
"discrimination": "Discrimination themes",
"police_violence": "State / police violence",
"smoking_drinking": "Smoking / drinking",
"detailed_killing": "Detailed killing scenes",
"cult_occult": "Cult / occult themes",
"psychological_manipulation": "Psychological manipulation",
"grief_loss": "Loss / grief themes",
"kidnapping": "Kidnapping",
"hate_speech": "Hate speech themes",
"historical_atrocity": "Historical atrocities",
"slavery_themes": "Slavery themes",
"terrorism_themes": "Terrorism themes",
"bullying_themes": "Bullying themes",
"blind_playthrough": "Blind playthrough — first time playing",
"no_spoilers_chat": "No spoilers in chat please",
"casual_difficulty": "Casual / story difficulty",
"hardcore_difficulty": "Hardcore / max difficulty",
"permadeath_run": "Permadeath / Iron Man run",
"speedrun_attempt": "Speedrun attempt",
"completionist_run": "100% completionist run",
"learning_mechanics": "Still learning the mechanics",
"eye_horror": "Eyeball clusters / distorted gaze imagery",
"body_horror": "Body horror — flesh distortion and mutation",
"face_horror": "Distorted or mutilated face imagery",
"cosmic_horror": "Cosmic / eldritch / Lovecraftian horror",
"extreme_gore": "Extreme gore — dismemberment and viscera",
"decay_rot": "Decay, rot, maggots, corpse imagery",
"mutilation": "Mutilation / amputation imagery",
"strobe_effects": "Strobe-lighting sequences",
"screen_shake_intense": "Heavy screen shake / camera trauma",
"coulrophobia": "Clowns / clown-like figures",
"ablutophobia": "Drowning / extended water immersion",
"taphophobia": "Live burial / coffin / tomb confinement",
"paranoia_themes": "Paranoia / surveillance themes",
"intrusive_thoughts": "Intrusive-thought sequences",
"medical_horror": "Medical / surgical procedure horror",
"human_experimentation": "Human experimentation themes",
"cannibalism": "Cannibalism — depicted or implied",
"nuclear_themes": "Nuclear war / radiation themes",
"liminal_spaces": "Liminal / unsettling empty spaces",
"analog_horror": "Analog horror / VHS distortion aesthetic",
"unreality_themes": "Reality distortion / unreliable perception",
"pursuit_chase": "Sustained chase / stalker pursuit sequences",
"entity_horror": "Unknowable entity / SCP-style horror",
"first_time_playing": "First playthrough — mechanics may be missed",
"returning_player": "Returning player — NG+ context",
"mods_used": "Gameplay mods enabled",
"cheats_enabled": "Cheats / debug commands used",
"glitch_exploits": "Intentional glitch usage / sequence-breaking",
"assisted_run": "Guide-assisted — not a blind run"
}
},
"graphics": {
"with": "with",
"artStyle": "Art Style",
"presetOptions": {
"low": "Low",
"medium": "Medium",
"high": "High",
"very_high": "Very High",
"cinematic": "Cinematic",
"ultra": "Ultra",
"extreme": "Extreme"
},
"rtOptions": {
"ray_tracing": "Ray Tracing",
"full_rt": "Full Ray Tracing",
"path_tracing": "Path Tracing",
"ray_reconstruction": "Ray Reconstruction"
},
"upscaleQualityOptions": {
"native_aa": "Native AA",
"quality": "Quality",
"balanced": "Balanced",
"performance": "Performance",
"ultra_performance": "Ultra Performance"
},
"upscale": {
"nvidia": {
"none": "",
"dlaa": "NVIDIA DLAA",
"quality": "NVIDIA DLSS Quality",
"balanced": "NVIDIA DLSS Balanced",
"performance": "NVIDIA DLSS Performance",
"ultra_performance": "NVIDIA DLSS Ultra Performance"
},
"amd": {
"none": "",
"native_aa": "AMD FSR Native AA",
"quality": "AMD FSR Quality",
"balanced": "AMD FSR Balanced",
"performance": "AMD FSR Performance",
"ultra_performance": "AMD FSR Ultra Performance"
},
"intel": {
"none": "",
"native_aa": "Intel XeSS Native AA",
"ultra_quality": "Intel XeSS Ultra Quality",
"quality": "Intel XeSS Quality",
"balanced": "Intel XeSS Balanced",
"performance": "Intel XeSS Performance",
"ultra_performance": "Intel XeSS Ultra Performance"
}
},
"frameGen": {
"nvidia": {
"none": "",
"x2": "NVIDIA Frame Generation x2",
"x3": "NVIDIA Multi Frame Generation x3",
"x4": "NVIDIA Multi Frame Generation x4"
},
"amd": {
"none": "",
"x2": "AMD Fluid Motion Frames x2",
"x3": "AMD Fluid Motion Frames x3"
},
"intel": {
"none": "",
"x2": "Intel XeFG x2"
}
},
"artStyleOptions": {
"realistic": "Realistic",
"stylized": "Stylized",
"anime": "Anime",
"cel_shaded": "Cel-shaded",
"low_poly": "Low-poly",
"voxel": "Voxel",
"pixel_art": "Pixel Art",
"hand_drawn": "Hand-drawn",
"comic": "Comic",
"photorealistic": "Photorealistic"
},
"videoLabel": "Video",
"inGameSettingLabel": "In-game Setting",
"versionLabel": "Version"
},
"livestream": {
"scheduledLine": "🔴 LIVE on {{time}}",
"watchLine": "Watch / replay: {{link}}"
}
},
"pinnedComment": {
@@ -100,6 +386,7 @@
"playlistPrompt": "📺 Watch the full series here: {{link}}",
"engagementPrompt": "Don't forget to like & subscribe if you want to see more — it really helps out the channel 💚",
"askNextGame": "💬 What game should I play next? Drop your suggestions below!",
"genrePlaylistSuggestion": "📺 More {{genreLabel}} gameplay on the channel: {{link}}",
"greetings": {
"full": "This one's the full run of {{gameName}} — hope you enjoy every minute of it.",
"part": "Welcome back to {{gameName}} on {{channelName}}!",
@@ -118,7 +405,9 @@
"comparison": "Graphics comparison for {{gameName}} — which one wins for you?",
"guide": "Hope this silent guide helped. Timestamps in the description.",
"mods": "Modded run — full load order / credits in the description.",
"collectibles": "Every collectible in one video. Thanks for the support!"
"collectibles": "Every collectible in one video. Thanks for the support!",
"livestream": "Welcome to the stream of {{gameName}}! Drop a hello in the chat 👋",
"gacha_quest": "Welcome back to {{gameName}} on {{channelName}}!"
}
},
"hashtags": {
+448 -14
View File
@@ -11,7 +11,62 @@
"settings": "Settings",
"batch": "Batch",
"playlist": "Playlist",
"logs": "Logs"
"logs": "Logs",
"about": "About",
"reportBug": "Report Bug"
},
"sidebar": {
"expand": "Expand sidebar",
"collapse": "Collapse sidebar"
},
"header": {
"donate": "Donate"
},
"about": {
"tagline": "YouTube title, description, and tag generator for Gameplay No Commentary channels.",
"repoHeading": "Repository & License",
"repoLabel": "GitHub Repo",
"issuesLabel": "Report an Issue",
"reportBugLabel": "Report a Bug",
"discussionsLabel": "Discussions",
"authorLabel": "Author",
"licenseLabel": "License",
"donateHeading": "Donate / Support",
"donateHelp": "If YTDescGen saves you time, consider buying me a coffee. Every bit helps keep the project going.",
"donate": {
"githubSponsors": "GitHub Sponsors",
"kofi": "Ko-fi",
"buyMeACoffee": "Buy Me a Coffee",
"patreon": "Patreon",
"paypal": "PayPal"
},
"connectHeading": "Connect",
"devEnvHeading": "Dev Environment",
"devEnvHelp": "Hardware and toolchain the public web build and desktop binaries are produced on.",
"devEnv": {
"os": "OS",
"cpu": "CPU",
"gpu": "GPU",
"ram": "RAM",
"ide": "IDE",
"toolchains": "Toolchains",
"fullSpecLink": "Read full PC spec ↗",
"fullDevEnvLink": "Read dev environment guide ↗"
},
"thirdPartyHeading": "Third-Party Credits",
"thirdPartyHelp": "YTDescGen is built on top of these open-source projects. Versions are pulled live from package.json.",
"socials": {
"youtube": "YouTube Channel",
"x": "X / Twitter",
"bluesky": "Bluesky",
"mastodon": "Mastodon",
"discord": "Discord — Repo / General",
"discordGame": "Discord — Game lobby",
"steam": "Steam profile",
"telegramBot": "Telegram bot",
"telegramUser": "Telegram",
"email": "Email"
}
},
"editor": {
"sections": {
@@ -40,18 +95,180 @@
"challengeNamePlaceholder": "e.g. No Hit Run",
"modName": "Mod Name",
"modNamePlaceholder": "e.g. Requiem, NaturalVision Evolved",
"modList": "Mod List",
"modListPlaceholder": "List the mods you used, one per line. Paste from your mod manager works.",
"gachaQuestType": "Quest Type",
"gachaQuestTypeOptions": {
"main_story": "Main Story",
"world_quest": "World Quest",
"side_quest": "Side Quest",
"spinoff_quest": "Spinoff Quest",
"companion_quest": "Companion Quest",
"bond_quest": "Bond Quest",
"event": "Event",
"anniversary": "Anniversary",
"crossover": "Crossover",
"dating_event": "Dating Event",
"tutorial_quest": "Tutorial",
"guide_quest": "Guide Quest",
"trial_quest": "Trial Quest",
"endgame": "Endgame Mode",
"coop": "Co-op",
"daily_commission": "Daily Commissions",
"showcase": "Showcase"
},
"gachaQuestTypeGroups": {
"story": "Story",
"events": "Events",
"tutorial_trial": "Tutorial / Trial",
"endgame_multiplayer": "Endgame / Multiplayer",
"showcase": "Showcase"
},
"chapterName": "Chapter / Story Arc",
"chapterNamePlaceholder": "e.g. Chapter 5 Act 2: Where the Stars Fall",
"questName": "Quest Name",
"questNamePlaceholder": "e.g. A Solitary Constellation",
"characterName": "Character Name",
"characterNamePlaceholder": "e.g. Furina, Topaz, Acheron",
"anniversaryYear": "Anniversary Year",
"anniversaryYearOption": "Year {{count}}",
"gachaVersion": "Game Version",
"gachaVersionPlaceholder": "e.g. 1.2, 2.4",
"gpu_brand": "Brand",
"gpu_series": "Series",
"gpu_model": "Model",
"gpu_custom": "Custom GPU",
"ram_size": "RAM Size",
"ram_ddr": "DDR Generation",
"vnDonate": "Donate (Vietnam)",
"vnDonateHelp": "Only rendered into the description when output language is Vietnamese.",
"vnBankName": "Bank name",
"vnBankNamePlaceholder": "e.g. Vietcombank, MB Bank, Techcombank",
"vnBankAccount": "Account number",
"vnBankAccountPlaceholder": "e.g. 0123456789",
"vnBankHolder": "Account holder",
"vnBankHolderPlaceholder": "e.g. NGUYEN VAN A",
"vnMomo": "MoMo",
"vnMomoPlaceholder": "MoMo phone number",
"vnZalopay": "ZaloPay",
"vnZalopayPlaceholder": "ZaloPay phone number",
"resolution": "Resolution",
"fps": "FPS",
"graphicsPreset": "Graphics Preset",
"graphicsPresetOptions": {
"low": "Low",
"medium": "Medium",
"high": "High",
"very_high": "Very High",
"cinematic": "Cinematic",
"ultra": "Ultra",
"extreme": "Extreme",
"custom": "Custom…"
},
"graphicsPresetCustom": "Custom preset name",
"graphicsPresetCustomPlaceholder": "e.g. Epic, Maximum",
"skipGraphicsSettings": "This game has no in-game graphics settings",
"skipGraphicsSettingsHelp": "Hide the Video Settings section in the description for 2D / pixel-art / web games.",
"rayTracing": "Ray Tracing",
"rtOptions": {
"ray_tracing": "Ray Tracing",
"full_rt": "Full Ray Tracing",
"path_tracing": "Path Tracing",
"ray_reconstruction": "Ray Reconstruction"
},
"frameGenVendor": "Frame Gen Vendor",
"frameGenVendorOptions": {
"none": "None",
"nvidia": "NVIDIA",
"amd": "AMD",
"intel": "Intel"
},
"frameGenMultiplier": "Frame Gen Multiplier",
"frameGenMultiplierOptions": {
"none": "None",
"x2": "x2",
"x3": "x3",
"x4": "x4",
"x6": "x6"
},
"frameGenMultiplier.nvidia": {
"none": "None",
"x2": "x2 (Frame Gen)",
"x3": "x3 (Multi Frame Gen)",
"x4": "x4 (Multi Frame Gen)"
},
"frameGenMultiplier.amd": {
"none": "None",
"x2": "x2 (Fluid Motion Frames)",
"x3": "x3 (Fluid Motion Frames)"
},
"frameGenMultiplier.intel": {
"none": "None",
"x2": "x2 (XeFG)"
},
"upscaleQuality": "Upscaling Quality",
"upscaleQualityOptions": {
"none": "None",
"native_aa": "Native AA",
"quality": "Quality",
"balanced": "Balanced",
"performance": "Performance",
"ultra_performance": "Ultra Performance"
},
"upscaleQuality.nvidia": {
"none": "None",
"dlaa": "DLAA",
"quality": "DLSS Quality",
"balanced": "DLSS Balanced",
"performance": "DLSS Performance",
"ultra_performance": "DLSS Ultra Performance"
},
"upscaleQuality.amd": {
"none": "None",
"native_aa": "FSR Native AA",
"quality": "FSR Quality",
"balanced": "FSR Balanced",
"performance": "FSR Performance",
"ultra_performance": "FSR Ultra Performance"
},
"upscaleQuality.intel": {
"none": "None",
"native_aa": "XeSS Native AA",
"ultra_quality": "XeSS Ultra Quality",
"quality": "XeSS Quality",
"balanced": "XeSS Balanced",
"performance": "XeSS Performance",
"ultra_performance": "XeSS Ultra Performance"
},
"artStyle": "Art Style",
"artStyleOptions": {
"none": "— Not set —",
"realistic": "Realistic",
"stylized": "Stylized",
"anime": "Anime",
"cel_shaded": "Cel-shaded",
"low_poly": "Low-poly",
"voxel": "Voxel",
"pixel_art": "Pixel Art",
"hand_drawn": "Hand-drawn",
"comic": "Comic",
"photorealistic": "Photorealistic"
},
"versionInfo": "Driver / Game Version",
"versionInfoPlaceholder": "e.g. GeForce 565.90 | Game v1.4",
"liveUrl": "Live URL",
"liveUrlPlaceholder": "https://www.youtube.com/watch?v=...",
"scheduledTime": "Scheduled Time",
"skipGraphicsHintLabel": "This looks like a game without graphics settings — hide the section?",
"skipGraphicsHintHide": "Hide",
"skipGraphicsHintKeep": "Keep",
"timestamps": "Timestamps",
"timestampsPlaceholder": "0:00 Intro\n5:30 Chapter 1\n15:00 Boss Fight",
"storeLinks": "Store Links",
"storeLinkType": "Type",
"rig": "My Rig",
"social": "Social & Donate Links",
"warnings": "Warnings",
"spoilerWarning": "Spoiler Warning",
"matureWarning": "Mature Content (18+)",
"warnings": "Content warnings",
"playlistLink": "Playlist Link",
"playlistLinkPlaceholder": "https://youtube.com/playlist?list=...",
"contactEmail": "Contact Email",
@@ -62,6 +279,8 @@
"sponsorNamePlaceholder": "e.g. Ubisoft, Capcom, Devolver Digital",
"sponsorPlatform": "Key platform",
"sponsorPlatformPlaceholder": "e.g. Steam, Epic Games, GOG",
"pubDevName": "Pub/Dev Name",
"pubDevNamePlaceholder": "e.g. Ubisoft, Capcom, FromSoftware",
"thumbnailText": "Thumbnail Text",
"thumbnailTextPlaceholder": "e.g. SECRET BOSS NO HIT",
"pinnedComment": "Pinned Comment Template",
@@ -86,10 +305,182 @@
"difficultyCustomLabel": "Custom difficulty label",
"difficultyCustomPlaceholder": "e.g. Lethal, NG+7, Fromsoft default",
"contentWarnings": "Content warnings",
"contentWarningSearchPlaceholder": "Search warnings…",
"contentWarningEmpty": "No matching warnings",
"contentWarningGroups": {
"spoilers": "Spoilers",
"photosensitive": "Photosensitive / Health",
"phobias": "Phobias",
"mental_health": "Mental health",
"sensitive": "Mature / Sensitive content",
"playstyle": "Playstyle disclosures",
"horror_specific": "Heavy horror",
"gameplay_disclosure": "Gameplay disclosure"
},
"contentWarningOptions": {
"flashing_lights": "⚡ Flashing lights",
"loud_noises": "🔊 Loud noises",
"jump_scares": "😱 Jump scares"
"spoiler_story": "Story / ending spoilers",
"spoiler_ending": "Ending spoilers",
"spoiler_true_ending": "True-ending spoilers",
"spoiler_post_game": "Post-game / NG+ spoilers",
"spoiler_secret_ending": "Secret-ending spoilers",
"spoiler_dlc": "DLC story spoilers",
"flashing_lights": "Flashing lights",
"motion_sickness": "Motion sickness",
"migraine_trigger": "Migraine trigger",
"loud_noises": "Loud / sudden sounds",
"jump_scares": "Jumpscares",
"acrophobia": "Heights",
"trypophobia": "Holes / clusters",
"thalassophobia": "Deep water",
"claustrophobia": "Confined spaces",
"arachnophobia": "Spiders",
"entomophobia": "Insects",
"ophidiophobia": "Snakes",
"cynophobia": "Dogs",
"nyctophobia": "Darkness",
"pyrophobia": "Fire",
"pediophobia": "Dolls",
"hemophobia": "Blood",
"anxiety_inducing": "Anxiety-inducing scenes",
"depression_themes": "Depression themes",
"eating_disorders": "Eating disorders",
"substance_use": "Substance use",
"self_harm": "Self-harm / suicide",
"ptsd_themes": "PTSD content",
"needles": "Needles",
"body_fluids": "Body fluids",
"pregnancy_horror": "Pregnancy / birth horror",
"illness_themes": "Illness / infection",
"bipolar_themes": "Bipolar themes",
"ocd_themes": "OCD themes",
"panic_attacks": "Panic attacks",
"dissociation": "Dissociation",
"blood_gore": "Blood and gore",
"mature_18plus": "Mature 18+",
"disturbing_imagery": "Disturbing imagery",
"animal_abuse": "Animal cruelty",
"child_harm": "Violence against minors",
"domestic_violence": "Domestic violence",
"sexual_assault": "Sexual assault references",
"torture": "Torture",
"religion_themes": "Religious themes",
"war_violence": "War violence",
"discrimination": "Discrimination",
"police_violence": "State / police violence",
"smoking_drinking": "Smoking / drinking",
"detailed_killing": "Detailed killing",
"cult_occult": "Cult / occult",
"psychological_manipulation": "Psychological manipulation",
"grief_loss": "Loss / grief",
"kidnapping": "Kidnapping",
"hate_speech": "Hate speech",
"historical_atrocity": "Historical atrocities",
"slavery_themes": "Slavery themes",
"terrorism_themes": "Terrorism themes",
"bullying_themes": "Bullying themes",
"blind_playthrough": "Blind playthrough",
"no_spoilers_chat": "No spoilers in chat",
"casual_difficulty": "Casual / story mode",
"hardcore_difficulty": "Hardcore / max difficulty",
"permadeath_run": "Permadeath / Iron Man",
"speedrun_attempt": "Speedrun attempt",
"completionist_run": "100% completionist",
"learning_mechanics": "Still learning mechanics",
"eye_horror": "Eyes / eyeball clusters",
"body_horror": "Body horror (flesh distortion)",
"face_horror": "Distorted / mutilated faces",
"cosmic_horror": "Cosmic / eldritch horror",
"extreme_gore": "Extreme gore / dismemberment",
"decay_rot": "Decay, rot, maggots",
"mutilation": "Mutilation / amputation",
"strobe_effects": "Strobe lighting",
"screen_shake_intense": "Heavy screen shake",
"coulrophobia": "Clowns (coulrophobia)",
"ablutophobia": "Drowning / water immersion",
"taphophobia": "Live burial",
"paranoia_themes": "Paranoia",
"intrusive_thoughts": "Intrusive thoughts",
"medical_horror": "Medical horror",
"human_experimentation": "Human experimentation",
"cannibalism": "Cannibalism",
"nuclear_themes": "Nuclear / radiation",
"liminal_spaces": "Liminal spaces",
"analog_horror": "Analog horror / VHS",
"unreality_themes": "Unreality / distortion",
"pursuit_chase": "Pursuit / chase",
"entity_horror": "Entity / SCP horror",
"first_time_playing": "First time playing",
"returning_player": "Returning / NG+",
"mods_used": "Mods used",
"cheats_enabled": "Cheats / debug",
"glitch_exploits": "Glitches used",
"assisted_run": "Guide-assisted"
},
"playthroughNotes": {
"title": "Playthrough notes",
"runTypeLabel": "Run type",
"difficultyLabel": "Difficulty",
"endingsLabel": "Endings shown",
"endingsPlaceholder": "e.g. True ending only, 1 of 3, All routes 100%",
"languagePatchLabel": "Language patch",
"languagePatchCustomLabel": "Custom language label",
"languagePatchCustomPlaceholder": "e.g. Official KR, VNI fan TL v2.1",
"gameVersionLabel": "Game version",
"gameVersionCustomLabel": "Custom version label",
"gameVersionCustomPlaceholder": "e.g. Steam Next Fest demo, Kickstarter backer build",
"languagePatchOptions": {
"none": "— Not set —",
"official_en": "Official English",
"official_other": "Official (other locale)",
"fan_translation": "Fan translation",
"mtl": "Machine translation",
"custom": "Custom…"
},
"gameVersionOptions": {
"full_release": "— Full release —",
"demo": "Demo",
"early_access": "Early Access",
"beta": "Beta",
"prologue": "Prologue / Teaser",
"pre_release": "Pre-release",
"custom": "Custom…"
}
},
"techNotes": "Tech notes",
"techNoteSearchPlaceholder": "Search tech notes…",
"techNoteEmpty": "No matching notes",
"techNoteGroups": {
"audio": "Audio",
"video_quality": "Video quality",
"recording_issues": "Recording issues",
"playstyle": "Playstyle disclaimers",
"production": "Production & attribution"
},
"techNoteOptions": {
"copyright_muted_sections": "Some sections muted (copyright)",
"volume_reduced_copyright": "Volume reduced (copyright)",
"music_replaced_copyright": "Game music replaced (copyright)",
"cutscene_audio_muted_only": "Cutscene audio muted only",
"original_audio_kept": "Original audio kept (claim risk)",
"low_resolution_hardware": "Low resolution (hardware)",
"low_graphics_performance": "Lower graphics (performance)",
"fps_drops_hardware": "FPS drops (hardware)",
"bug_from_game": "Bugs are from the game",
"crash_kept_transparency": "Crash kept (transparency)",
"loading_cut": "Loading screens cut",
"obs_artifacts_possible": "Possible OBS artifacts",
"not_no_hit_run": "NOT a no-hit run",
"not_clean_walkthrough": "Not a clean walkthrough",
"casual_no_commentary": "Casual, no commentary",
"many_deaths_patience": "Many deaths",
"slow_exploration": "Slow exploration",
"puzzle_stuck_possible": "May get stuck on puzzles",
"grinding_cut": "Grinding cut",
"not_speedrun_relaxed": "Not a speedrun",
"exploration_focus_skip_combat": "Exploration-focused (skip combat)",
"edited_for_pacing": "Edited for pacing",
"support_developers": "Support the developers",
"online_connectivity_issues": "Online connectivity issues"
},
"videoSettings": "Video Settings",
"quickPreview": "Quick Preview",
@@ -97,7 +488,28 @@
"clearDraft": "Clear Draft",
"draftSaved": "Draft saved",
"clearDraftConfirm": "Are you sure you want to clear all form data?",
"contactEmailHelp": "Up to 3 emails, comma-separated"
"genreSearchPlaceholder": "Search genres",
"genreSearchNoResults": "No matching genres",
"validation": {
"gpuMissingSeries": "Pick a series to complete the GPU.",
"gpuMissingModel": "Pick a model to complete the GPU.",
"gpuCustomEmpty": "Enter a GPU name or pick from the catalog.",
"ramMissingDdr": "Pick a DDR generation.",
"ramMissingSize": "Pick a RAM size.",
"ramCustomEmpty": "Enter a RAM size in GB."
},
"genreGroups": {
"rpg": "All RPGs",
"shooter": "All Shooters",
"horror": "All Horror"
},
"contactEmailHelp": "Up to 3 emails, comma-separated",
"toast": {
"urlAutoFilled": "Auto-filled '{{name}}' from URL"
},
"warning": {
"linkNameMismatch": "Check link and add again — '{{host}}' suggests '{{suggestedName}}', but Game Name is '{{gameName}}'."
}
},
"output": {
"title": "Title",
@@ -122,6 +534,11 @@
"default": "Default",
"typeFirst": "Type First",
"qualityFirst": "Quality First"
},
"copy": {
"overLimit": "{{field}} is too long: {{count}}/{{limit}} chars. Trim before copying.",
"fieldGeneric": "Text",
"failed": "Failed to copy"
}
},
"common": {
@@ -133,7 +550,9 @@
"import": "Import",
"reset": "Reset",
"search": "Search",
"generate": "Generate"
"generate": "Generate",
"undo": "Undo",
"dismiss": "Dismiss"
},
"videoTypes": {
"full": "Full Gameplay",
@@ -153,7 +572,9 @@
"comparison": "Graphics Comparison",
"guide": "Silent Guide",
"mods": "Modded Gameplay",
"collectibles": "All Collectibles"
"collectibles": "All Collectibles",
"livestream": "Livestream",
"gacha_quest": "Gacha Quest"
},
"genres": {
"action": "Action / Adventure",
@@ -251,7 +672,10 @@
"deleteConfirm": "Are you sure you want to delete this profile?",
"emptyState": "No profiles yet. Create one to save your channel info.",
"exportProfiles": "Export Profiles",
"importProfiles": "Import Profiles"
"importProfiles": "Import Profiles",
"thirdPartyAdText": "Third-party ad copy",
"thirdPartyAdTextPlaceholder": "e.g. Use code SAVE10 at GameStore.com — 10% off all titles\nSponsored by ChairCo — link in description",
"thirdPartyAdTextHelp": "Optional sponsor / partner / affiliate copy. Shown when 'Third-party ads' is enabled in Settings."
},
"presets": {
"title": "Game Presets",
@@ -308,6 +732,8 @@
"showCopyright": "Append © copyright line to description",
"showUsagePolicy": "Append usage policy block to description",
"showSponsorCredit": "Show sponsor credit line in description (thanks for the key)",
"showThirdPartyAds": "Show third-party advertising block in description",
"thirdPartyAdsHint": "Set ad copy in your channel profile (Profiles → Edit).",
"titleFormatTitle": "Title Format",
"descriptionSettingsTitle": "Description",
"badgePosition": "Quality badge position",
@@ -323,7 +749,11 @@
"badgeCaseUpper": "UPPERCASE (2K)",
"badgeCaseLower": "lowercase (2k)",
"showPinnedCommentTemplate": "Generate a pinned-comment template alongside output",
"pinnedCommentIncludeAskNextGame": "Include \"what game should I play next?\" prompt"
"pinnedCommentIncludeAskNextGame": "Include \"what game should I play next?\" prompt",
"pinnedCommentIncludeGenrePlaylist": "Include genre-playlist suggestion in pinned comment",
"genrePlaylistsTitle": "Genre Playlists",
"genrePlaylistsHelp": "Configure a YouTube playlist URL per genre. The pinned-comment template will auto-suggest the matching playlist when the video's primary genre is selected.",
"genrePlaylistsEmptyHint": "Leave empty to skip a genre."
},
"batch": {
"title": "Batch Mode",
@@ -338,14 +768,18 @@
"generate": "Generate (switch to Output)",
"copyAll": "Copy All",
"saveDraft": "Save Draft",
"toggleSidebar": "Toggle Sidebar",
"help": "Show Shortcuts",
"close": "Close Modal"
"close": "Close Modal",
"searchPlaceholder": "Search shortcuts",
"noResults": "No matching shortcuts"
},
"validation": {
"emailInvalid": "Invalid email: {{email}}",
"emailMaxExceeded": "Maximum {{max}} emails allowed (currently {{count}})",
"urlInvalid": "Invalid URL. Must start with https://",
"urlPrefixMismatch": "Expected URL starting with {{expected}}"
"urlPrefixMismatch": "Expected URL starting with {{expected}}",
"playlistUrlInvalid": "Invalid YouTube playlist URL. Expected: {{expected}}"
},
"storeLinkTypes": {
"paid": "Paid",
+301 -12
View File
@@ -26,7 +26,33 @@
"comparison": "Comparación de Gráficos",
"guide": "Guía Silenciosa",
"mods": "Mod {{modName}}",
"collectibles": "Todos los Coleccionables"
"collectibles": "Todos los Coleccionables",
"livestream": "🔴 EN VIVO",
"gacha_quest": ""
},
"gachaQuestType": {
"main_story": "{{gameName}} — {{chapterName}}{{partSuffix}}",
"world_quest": "{{gameName}} — World Quest: {{questName}}",
"side_quest": "{{gameName}} — Side Quest: {{questName}}",
"spinoff_quest": "{{gameName}} — Spinoff: {{questName}}",
"companion_quest": "{{gameName}} — Companion Quest: {{questName}}",
"bond_quest": "{{gameName}} — Bond Quest: {{questName}}",
"event": "{{gameName}} — Event: {{questName}}",
"anniversary": "{{gameName}} — Aniversario {{anniversaryYear}}{{partSuffix}}",
"crossover": "{{gameName}} — Crossover: {{questName}}",
"dating_event": "{{gameName}} — Dating Event: {{questName}}",
"tutorial_quest": "{{gameName}} — Tutorial: {{questName}}",
"guide_quest": "{{gameName}} — Guide: {{questName}}",
"trial_quest": "{{gameName}} — Trial: {{questName}}",
"endgame": "{{gameName}} — {{chapterName}}{{partSuffix}}",
"coop": "{{gameName}} — Co-op: {{questName}}",
"daily_commission": "{{gameName}} — Daily Commissions{{partSuffix}}",
"showcase": "{{gameName}} — Showcase de personaje: {{characterName}}"
},
"gachaPartSuffix": {
"part": " - Part {{n}}",
"day": " - Day {{n}}",
"floor": " - Floor {{n}}"
}
},
"description": {
@@ -48,7 +74,26 @@
"comparison": "Este video presenta una comparación de gráficos de {{gameName}} en {{channelName}}.",
"guide": "Este video presenta una guía silenciosa de {{gameName}} en {{channelName}}.",
"mods": "Este video presenta el mod {{modName}} para {{gameName}} en {{channelName}}.",
"collectibles": "Este video cubre todos los coleccionables y el 100% de {{gameName}} en {{channelName}}."
"collectibles": "Este video cubre todos los coleccionables y el 100% de {{gameName}} en {{channelName}}.",
"livestream": "Stream en vivo de {{gameName}} en {{channelName}}. ¡Únete al chat y saluda!",
"gacha_quest_main_story": "Welcome to {{chapterName}} of {{gameName}} on {{channelName}}!",
"gacha_quest_world_quest": "Today's video covers the World Quest \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_side_quest": "Side Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_spinoff_quest": "Spinoff quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_companion_quest": "Companion Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_bond_quest": "Bond Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_event": "Limited-time Event \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_anniversary": "Celebrando el {{anniversaryYear}}º aniversario de {{gameName}}{{versionLabel}} en {{channelName}}.",
"gacha_quest_crossover": "Crossover Event \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_dating_event": "Dating Event \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_tutorial_quest": "Tutorial \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_guide_quest": "Guide Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_trial_quest": "Trial Quest \"{{questName}}\" from {{gameName}} on {{channelName}}.",
"gacha_quest_endgame": "Endgame mode \"{{chapterName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_coop": "Co-op session \"{{questName}}\" in {{gameName}} on {{channelName}}.",
"gacha_quest_daily_commission": "Daily Commissions in {{gameName}} on {{channelName}}.",
"gacha_quest_showcase": "Este vídeo presenta las habilidades, apariencia y detalles de {{characterName}} en {{gameName}}{{versionLabel}} en {{channelName}}.",
"versionInline": "versión {{v}}"
},
"noCommentaryLine": "Sin Comentarios — gameplay puro para tu disfrute.",
"storeLinkSuffix": {
@@ -61,9 +106,10 @@
"storeLinksDownload": "⬇️ DESCARGA EL JUEGO (si quieres jugar)",
"videoSettings": "🖥 AJUSTES DE VIDEO",
"rig": "💻 MI EQUIPO",
"spoilerWarning": "⚠️ ADVERTENCIA DE SPOILERS: Este video puede contener spoilers. ¡Míralo bajo tu propio riesgo!",
"matureWarning": "🔞 CONTENIDO PARA ADULTOS (18+): Contiene violencia / lenguaje fuerte / contenido gráfico.",
"modList": "🧩 LISTA DE MODS",
"vnDonate": "🏦 BANK TRANSFER / E-WALLET (Vietnam)",
"sponsorCredit": "🎁 Gracias a {{sponsor}} por proporcionar la clave de {{platform}} de este juego.",
"thirdPartyAds": "🤝 PATROCINADORES Y SOCIOS",
"music": "🎵 MÚSICA / SONIDO",
"donate": "☕ APOYA EL CANAL",
"social": "🔗 SÍGUEME",
@@ -72,10 +118,7 @@
"cta": "👍 Me gusta | 🔔 Suscríbete | ↗️ Comparte",
"copyright": "© {{year}} {{channelName}}. Todos los derechos reservados.",
"usagePolicyHeader": "📋 POLÍTICA DE USO",
"usagePolicy": "• Siempre acredita con un enlace al vídeo original Y al canal (al menos en la descripción).\n• No reuploadees el vídeo completo ni porciones grandes como contenido propio.\n• No monetices el material sin consentimiento explícito.\n• No edites el material de forma que tergiverse el contenido original o al creador.\n• Compilaciones, reseñas, comentarios y reacciones están OK — siempre que acredites.\nSi tienes dudas, contáctame por las redes sociales o el email de la descripción.",
"playthrough": "🎯 Partida: {{value}}",
"difficulty": "🎮 DIFICULTAD",
"contentWarnings": "⚠️ ADVERTENCIAS DE CONTENIDO"
"usagePolicy": "• Siempre acredita con un enlace al vídeo original Y al canal (al menos en la descripción).\n• No reuploadees el vídeo completo ni porciones grandes como contenido propio.\n• No monetices el material sin consentimiento explícito.\n• No edites el material de forma que tergiverse el contenido original o al creador.\n• Compilaciones, reseñas, comentarios y reacciones están OK — siempre que acredites.\nSi tienes dudas, contáctame por las redes sociales o el email de la descripción."
},
"playthrough": {
"blind": "Partida a ciegas (primera vez)",
@@ -89,10 +132,253 @@
"hard": "Difícil",
"nightmare": "Pesadilla / Extremo"
},
"playthroughNotes": {
"header": "▸ 🎮 NOTAS DE LA PARTIDA",
"intro": "Configuración, versión y enfoque de esta partida.",
"labels": {
"runType": "Tipo de partida",
"difficulty": "Dificultad",
"endings": "Finales mostrados",
"languagePatch": "Parche de idioma",
"gameVersion": "Versión del juego"
},
"languagePatchOptions": {
"official_en": "Lanzamiento oficial en inglés",
"official_other": "Lanzamiento oficial (otro idioma)",
"fan_translation": "Traducción de fans",
"mtl": "Traducción automática",
"custom": "Personalizada"
},
"gameVersionOptions": {
"demo": "Demo",
"early_access": "Acceso anticipado",
"beta": "Beta",
"prologue": "Prólogo / Teaser",
"pre_release": "Versión preliminar",
"custom": "Personalizada"
}
},
"techNotes": {
"header": "▸ 🛠 NOTAS TÉCNICAS",
"intro": "Notas de producción y estilo de juego para mayor transparencia.",
"items": {
"copyright_muted_sections": "Algunas secciones silenciadas por derechos de autor de YouTube",
"volume_reduced_copyright": "Volumen reducido en algunas secciones por derechos de autor",
"music_replaced_copyright": "Música del juego reemplazada para evitar reclamos de copyright",
"cutscene_audio_muted_only": "Solo se silenció el audio de las cinemáticas — el audio del gameplay se mantiene",
"original_audio_kept": "Audio original conservado — aceptando posible riesgo de reclamo",
"low_resolution_hardware": "Grabado a menor resolución por limitaciones de hardware",
"low_graphics_performance": "Configuración gráfica reducida por rendimiento",
"fps_drops_hardware": "Caídas de FPS — causadas por hardware (contador de FPS visible arriba a la izquierda)",
"bug_from_game": "Los bugs / glitches son del juego, no de la grabación",
"crash_kept_transparency": "Crash del juego conservado por transparencia",
"loading_cut": "Pantallas de carga eliminadas",
"obs_artifacts_possible": "Posibles artefactos de grabación de OBS",
"not_no_hit_run": "NO es una partida sin recibir daño — si buscas juego limpio, salta este vídeo",
"not_clean_walkthrough": "No es una guía pulida — exploración natural",
"casual_no_commentary": "Juego casual, sin comentario",
"many_deaths_patience": "Muchas muertes — se requiere paciencia",
"slow_exploration": "Mucho retroceso — ritmo de exploración lento",
"puzzle_stuck_possible": "Puede haber bloqueos en los puzles",
"grinding_cut": "Secciones de grindeo / repetición eliminadas",
"not_speedrun_relaxed": "No es un speedrun — partida relajada",
"exploration_focus_skip_combat": "Enfocado en exploración — se puede saltar combate",
"edited_for_pacing": "Editado para el ritmo — no es en tiempo real",
"support_developers": "Música original del juego — apoya a los desarrolladores",
"online_connectivity_issues": "Juego online — posibles problemas de conexión"
}
},
"contentWarnings": {
"flashing_lights": "⚡ Luces parpadeantes / efecto estroboscópico",
"loud_noises": "🔊 Ruidos fuertes / picos de volumen",
"jump_scares": "😱 Sustos repentinos"
"header": "▸ ⚠️ ADVERTENCIAS DE CONTENIDO",
"intro": "Este video contiene los siguientes contenidos. Se recomienda discreción al espectador.",
"items": {
"spoiler_story": "Spoilers — historia / final / true ending",
"spoiler_ending": "Spoilers — solo del final",
"spoiler_true_ending": "Spoilers — del true ending",
"spoiler_post_game": "Spoilers — post-game / New Game+",
"spoiler_secret_ending": "Spoilers — final secreto",
"spoiler_dlc": "Spoilers — historia del DLC",
"flashing_lights": "Luces parpadeantes — cuidado con la fotosensibilidad",
"motion_sickness": "Mareo por movimiento — cámara / FPS rápidos",
"migraine_trigger": "Posible desencadenante de migraña",
"loud_noises": "Sonidos fuertes / repentinos",
"jump_scares": "Sustos repentinos",
"acrophobia": "Alturas",
"trypophobia": "Agujeros / patrones agrupados",
"thalassophobia": "Aguas profundas",
"claustrophobia": "Espacios cerrados",
"arachnophobia": "Arañas",
"entomophobia": "Insectos",
"ophidiophobia": "Serpientes",
"cynophobia": "Perros",
"nyctophobia": "Oscuridad / escenas en negro",
"pyrophobia": "Fuego / escenas de incendio",
"pediophobia": "Muñecas / maniquíes",
"hemophobia": "Sangre",
"anxiety_inducing": "Escenas que pueden causar ansiedad",
"depression_themes": "Temática de depresión",
"eating_disorders": "Trastornos alimentarios",
"substance_use": "Uso de sustancias",
"self_harm": "Autolesión / suicidio",
"ptsd_themes": "Contenido relacionado con TEPT",
"needles": "Agujas / inyecciones",
"body_fluids": "Fluidos corporales",
"pregnancy_horror": "Horror de embarazo / parto",
"illness_themes": "Enfermedad / infección",
"bipolar_themes": "Trastorno bipolar",
"ocd_themes": "Trastorno obsesivo-compulsivo",
"panic_attacks": "Escenas de ataques de pánico",
"dissociation": "Disociación / desrealización",
"blood_gore": "Sangre y violencia gráfica",
"mature_18plus": "Contenido adulto 18+",
"disturbing_imagery": "Imágenes perturbadoras",
"animal_abuse": "Crueldad animal",
"child_harm": "Violencia contra menores",
"domestic_violence": "Violencia doméstica",
"sexual_assault": "Referencias a agresión sexual",
"torture": "Escenas de tortura",
"religion_themes": "Temas religiosos",
"war_violence": "Violencia bélica",
"discrimination": "Discriminación",
"police_violence": "Violencia policial / estatal",
"smoking_drinking": "Fumar / beber alcohol",
"detailed_killing": "Asesinatos detallados",
"cult_occult": "Sectas / ocultismo",
"psychological_manipulation": "Manipulación psicológica",
"grief_loss": "Pérdida / duelo",
"kidnapping": "Secuestro",
"hate_speech": "Discurso de odio",
"historical_atrocity": "Atrocidades históricas",
"slavery_themes": "Esclavitud",
"terrorism_themes": "Terrorismo",
"bullying_themes": "Acoso escolar",
"blind_playthrough": "Sin spoilers — primera vez",
"no_spoilers_chat": "Sin spoilers en el chat",
"casual_difficulty": "Casual / dificultad historia",
"hardcore_difficulty": "Hardcore / máxima dificultad",
"permadeath_run": "Permadeath / Iron Man",
"speedrun_attempt": "Intento de speedrun",
"completionist_run": "Completista 100%",
"learning_mechanics": "Aprendiendo las mecánicas",
"eye_horror": "Racimos oculares / imágenes de miradas distorsionadas",
"body_horror": "Body horror — deformación corporal y mutación",
"face_horror": "Imágenes de rostros deformados o mutilados",
"cosmic_horror": "Horror cósmico / lovecraftiano",
"extreme_gore": "Gore extremo — desmembramiento y vísceras",
"decay_rot": "Putrefacción, larvas, imágenes de cadáveres",
"mutilation": "Imágenes de mutilación o amputación",
"strobe_effects": "Secuencias de luces estroboscópicas",
"screen_shake_intense": "Sacudida intensa de cámara / trauma visual",
"coulrophobia": "Payasos — coulrofobia",
"ablutophobia": "Ahogamiento / inmersión prolongada en agua",
"taphophobia": "Enterramiento en vida / confinamiento en ataúd o tumba",
"paranoia_themes": "Paranoia / temas de vigilancia",
"intrusive_thoughts": "Secuencias de pensamientos intrusivos",
"medical_horror": "Terror médico / quirúrgico",
"human_experimentation": "Experimentación humana",
"cannibalism": "Canibalismo — explícito o sugerido",
"nuclear_themes": "Guerra nuclear / temas de radiación",
"liminal_spaces": "Espacios liminales / vacíos inquietantes",
"analog_horror": "Terror analógico / estética VHS distorsionada",
"unreality_themes": "Distorsión de la realidad / percepción no confiable",
"pursuit_chase": "Persecución sostenida / secuencias de acecho",
"entity_horror": "Entidad desconocida / terror tipo SCP",
"first_time_playing": "Primera partida — puede pasar por alto mecánicas",
"returning_player": "Jugador que regresa — contexto NG+",
"mods_used": "Mods de juego activos",
"cheats_enabled": "Trucos / comandos de depuración usados",
"glitch_exploits": "Uso intencional de glitches / sequence-breaking",
"assisted_run": "Con guía — no es partida a ciegas"
}
},
"graphics": {
"with": "con",
"artStyle": "Estilo Artístico",
"presetOptions": {
"low": "Bajo",
"medium": "Medio",
"high": "Alto",
"very_high": "Muy Alto",
"cinematic": "Cinematográfico",
"ultra": "Ultra",
"extreme": "Extremo"
},
"rtOptions": {
"ray_tracing": "Ray Tracing",
"full_rt": "Full Ray Tracing",
"path_tracing": "Path Tracing",
"ray_reconstruction": "Ray Reconstruction"
},
"upscaleQualityOptions": {
"native_aa": "Native AA",
"quality": "Quality",
"balanced": "Balanced",
"performance": "Performance",
"ultra_performance": "Ultra Performance"
},
"upscale": {
"nvidia": {
"none": "",
"dlaa": "NVIDIA DLAA",
"quality": "NVIDIA DLSS Quality",
"balanced": "NVIDIA DLSS Balanced",
"performance": "NVIDIA DLSS Performance",
"ultra_performance": "NVIDIA DLSS Ultra Performance"
},
"amd": {
"none": "",
"native_aa": "AMD FSR Native AA",
"quality": "AMD FSR Quality",
"balanced": "AMD FSR Balanced",
"performance": "AMD FSR Performance",
"ultra_performance": "AMD FSR Ultra Performance"
},
"intel": {
"none": "",
"native_aa": "Intel XeSS Native AA",
"ultra_quality": "Intel XeSS Ultra Quality",
"quality": "Intel XeSS Quality",
"balanced": "Intel XeSS Balanced",
"performance": "Intel XeSS Performance",
"ultra_performance": "Intel XeSS Ultra Performance"
}
},
"frameGen": {
"nvidia": {
"none": "",
"x2": "NVIDIA Frame Generation x2",
"x3": "NVIDIA Multi Frame Generation x3",
"x4": "NVIDIA Multi Frame Generation x4"
},
"amd": {
"none": "",
"x2": "AMD Fluid Motion Frames x2",
"x3": "AMD Fluid Motion Frames x3"
},
"intel": {
"none": "",
"x2": "Intel XeFG x2"
}
},
"artStyleOptions": {
"realistic": "Realista",
"stylized": "Estilizado",
"anime": "Anime",
"cel_shaded": "Cel-shading",
"low_poly": "Low-poly",
"voxel": "Voxel",
"pixel_art": "Pixel Art",
"hand_drawn": "Dibujo a mano",
"comic": "Cómic",
"photorealistic": "Fotorrealista"
},
"videoLabel": "Video",
"inGameSettingLabel": "In-game Setting",
"versionLabel": "Version"
},
"livestream": {
"scheduledLine": "🔴 EN VIVO el {{time}}",
"watchLine": "Ver / repetir: {{link}}"
}
},
"pinnedComment": {
@@ -100,6 +386,7 @@
"playlistPrompt": "📺 Mira la serie completa aquí: {{link}}",
"engagementPrompt": "No olvides dar like y suscribirte si quieres ver más — ayuda muchísimo al canal 💚",
"askNextGame": "💬 ¿Qué juego debería jugar a continuación? ¡Déjame tus sugerencias!",
"genrePlaylistSuggestion": "📺 Más gameplay de {{genreLabel}} en el canal: {{link}}",
"greetings": {
"full": "Partida completa de {{gameName}} — espero que la disfrutes de principio a fin.",
"part": "¡Bienvenidos de vuelta a {{gameName}} en {{channelName}}!",
@@ -118,7 +405,9 @@
"comparison": "Comparación gráfica de {{gameName}} — ¿cuál gana para ti?",
"guide": "Espero que esta guía silenciosa te haya ayudado. Los tiempos están en la descripción.",
"mods": "Partida con mods — el orden de carga y créditos están en la descripción.",
"collectibles": "Todos los coleccionables en un solo vídeo. ¡Gracias por el apoyo!"
"collectibles": "Todos los coleccionables en un solo vídeo. ¡Gracias por el apoyo!",
"livestream": "¡Bienvenidos al stream de {{gameName}}! Déjenme un saludo en el chat 👋",
"gacha_quest": "Welcome back to {{gameName}} on {{channelName}}!"
}
},
"hashtags": {
Loaded 100 of 140 files, more files were not shown because too many files have changed in this diff. Show more