Compare commits

...
41 Commits
Author SHA1 Message Date
poli0981 d7e287646d Merge pull request #261 from poli0981/chore/release-1.6.0
chore(release): v1.6.0
2026-11-17 11:08:15 +07:00
poli0981andClaude Opus 5.5 cdcd779219 chore(release): v1.6.0
The last feature release, and the first in maintenance mode: DLSS 5
Neural Rendering, x6 / Dynamic / Custom frame generation, a Custom LUT,
Qodana next to SonarCloud, the maintenance-mode policy and this week's
dependency fold.

CHANGELOG entry; ROADMAP release section and closing line; SECURITY
supported versions 1.6.x; version references in ARCHITECTURE, TECH-SPEC
(and its test count), PACKAGING, FEATURES, CONTENT-INVENTORY (+ vi),
DISCLAIMER (+ vi) and the bug / accessibility forms; the six manifests
1.5.2 -> 1.6.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 11:00:47 +07:00
poli0981 42697ce842 Merge pull request #260 from poli0981/chore/maintenance-mode
chore(repo): enter maintenance mode — policy, auto-triage, issue forms, badges
2026-11-17 11:00:44 +07:00
poli0981andClaude Opus 5.5 b2eb8236b4 chore(repo): enter maintenance mode — policy, auto-triage, issue forms, badges
YTDescGen is feature-complete; from 1.6.0 on it is maintained, not
extended. Still accepted: scheduled dependency updates; fixes for high or
critical CVEs and serious runtime issues; major language / runtime /
framework upgrades; bug, UI/UX and accessibility fixes, and options added
to or removed from the app's lists when people really need them;
translation fixes; Cloudflare / Worker changes the platform forces and
website incidents.

- README: status, CI, Qodana and SonarCloud badges; a Project status
  section; Contributing and the Roadmap row follow it.
- CONTRIBUTING: a Maintenance mode section, Option requests, issue and
  pull request rules, What We Want / Don't Want.
- SECURITY, MAINTAINERS, CLAUDE.md: the policy where each one needs it.
- ROADMAP: status block, a Maintenance mode section, Phase 5 and the
  backlog frozen. FEATURES: the extension points are frozen.
- Issue forms: Feature request removed; Option request and Translation or
  wording fix added; Bug report and Accessibility barrier now carry the
  `needs-triage` label (`triage` never existed). config.yml points feature
  ideas at Discussions → Ideas. The PR template gains a Scope checklist.
- maintenance-triage.yml closes, with a bilingual comment and the
  `out-of-scope` label, feature issues and `feat:` pull requests from
  outside contributors (scopes options, a11y and i18n stay open) and
  anything labelled `out-of-scope`. pull_request_target without checkout;
  listed under zizmor's dangerous-triggers ignore with the reason.

Labels created on the repository: out-of-scope, needs-triage, i18n,
option-request.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 10:53:40 +07:00
poli0981 e71949cf21 Merge pull request #259 from poli0981/feat/dlss5-framegen-lut
feat(editor): add DLSS 5 neural rendering, more frame generation modes and a custom LUT
2026-11-17 10:53:36 +07:00
poli0981andClaude Opus 5.5 cefbbd13ee feat(editor): add DLSS 5 neural rendering, more frame generation modes and a custom LUT
Video settings:
- NVIDIA frame generation gains x6 (the multiplier was already in the list
  but offered by no vendor) and Dynamic Multi Frame Generation (DLSS 4.5).
- "Custom…" for every vendor reveals a text field (`frameGenCustom`); the
  description prints what was typed, like a custom graphics preset, and
  nothing for an empty box.
- A "DLSS 5 Neural Rendering" switch (`dlssNeuralRendering`), shown for
  NVIDIA only and printed after the DLSS mode:
  "Ultra - NVIDIA DLSS Quality + NVIDIA DLSS 5 Neural Rendering + NVIDIA
  Dynamic Multi Frame Generation". Another vendor turns it off
  (`coerceDlssNeuralRendering`: the vendor switch, applied profiles and
  templates, backup import).
- Editor store v21 -> v22 back-fills both fields.
- composeGraphicsPart's vendor half moves into small helpers.

My Rig: "Custom" is the LUT field's first suggestion (typing it works too,
any case). The rig block then prints just "LUT applied" in the output
language ("Có áp dụng LUT") instead of "LUT: Custom" — a field's
`customNoteKey`. No migration: the rig is a string map.

i18n: the new editor and description keys in all 8 locales and
_schema.json; brand names stay English. tests/engine/graphics-vendor.test.ts
also holds every vendor's options to their labels in the schema.

Docs: FEATURES (upscaler / frame-gen table, LUT Custom), TECH-SPEC (input
fields, store v22, rig block), CLAUDE.md (how to add an option).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 10:46:35 +07:00
poli0981 731e194a70 Merge pull request #258 from poli0981/ci/qodana
ci(qodana): add Qodana for TypeScript and Rust
2026-11-17 10:46:27 +07:00
poli0981andClaude Opus 5.5 3b1b17ebf1 fix(qodana): clear the first run's findings
The first Qodana run found 74 problems in TypeScript / JavaScript and 12 in
Rust. Fixed:
- React 19.3 deprecates `FormEvent`: the three save forms take the
  `SubmitEvent` their `onSubmit` hands them.
- The URL patterns read `\S` instead of `[^\s]` (18 patterns in platforms.ts
  and playtest-platforms.ts, same characters).
- public/theme-init.js declares its browser globals and drops an unused
  catch binding.
- The two private `stable()` JSON helpers (restore.ts, library-apply.ts)
  become one `stableJson()` in src/utils/stable-json.ts, with a test.
- vitest.config.ts reuses vite.config.ts's alias map instead of a copy.
- Accordion destructures `icon` as `Icon` instead of copying it, a JSDoc
  link points at nothing any more, and i18next's `init()` promise is
  `void`ed on purpose.
- Rust: the three "show the main window" blocks become `show_main_window`.

Excluded in qodana.yaml, each with its reason: the Discord webhook secret
reference (HardcodedPasswords), escaped `]` / `}` in regexes, the
`@i18n/index` imports tsconfig needs, the three react-hooks warnings
eslint.config.js documents, the legacy `@deprecated` draft fields in the
files that migrate them; in src-tauri/qodana.yaml the module paths
`generate_handler!` needs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 10:38:59 +07:00
poli0981andClaude Opus 5.5 5a9e7e83de ci(qodana): add Qodana for TypeScript and Rust
A Qodana workflow with one job per Qodana Cloud project:
- typescript: Qodana for JS in native mode, on the runner's Node 26 and
  node_modules (qodana.yaml, project yt-ts-js, QODANA_TOKEN_TS_JS);
- rust: Qodana for Rust, Early Access, in Docker on src-tauri/
  (src-tauri/qodana.yaml, project yt-rust, QODANA_TOKEN_RUST). Its
  bootstrap installs what rust.yml installs; a stand-in dist/index.html
  lets generate_context!() expand.

Both use qodana.recommended with a quality gate of zero problems and
analyse the whole project on every run. A tokens job skips the analysis
for Dependabot and fork PRs, which get no secrets; the token reaches only
the scan step, never `npm ci`. Annotations and artifacts, no PR comment.
Failures reach Discord through notify-ci-failure.yml.

Docs: TECH-SPEC (workflow table, Qodana notes), DEVELOPMENT (+ vi),
CONTRIBUTING, CLAUDE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 10:21:18 +07:00
poli0981 d060444ab1 Merge pull request #257 from poli0981/chore/deps-2026-11-17
chore(deps): fold this week's updates; async-executor 1.14.1
2026-11-17 10:20:55 +07:00
poli0981andClaude Opus 5.5 cc66d9ecd9 chore(deps): fold this week's updates; async-executor 1.14.1
npm, the newest releases published before 2026-11-10 (the same 7-day
cooldown Dependabot uses): react-i18next 17.1.13, lucide-react 1.70,
zustand 5.1.0, simple-icons 16.37, vite 8.3.7 (rolldown 1.2.18),
@vitejs/plugin-react 6.3.0, tailwindcss and @tailwindcss/postcss 4.3.5,
typescript-eslint 8.72.2, knip 6.44.2, and the exact pins marked 18.2.0
and wrangler 4.159.0 (miniflare 5.20261109.0-beta, workerd 1.20261109.1).
THIRD_PARTY_NOTICES regenerated. No lock entry moved backwards.

Rust: async-executor 1.14.0 -> 1.14.1. 1.14.0 was yanked, and the weekly
cargo-deny run warned about it.

Held back, still inside the cooldown: eslint 10.15 / typescript-eslint
8.73 (they move to minimatch 11, the fix for the medium, dev-only alert
#50) and Tauri 2.12.6.

Closes #251, #252, #253, #255, #256.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 10:17:38 +07:00
poli0981 b7cfdec142 Merge pull request #254 from poli0981/dependabot/github_actions/actions-cbbf7163c1
ci: bump the actions group with 3 updates
2026-11-17 10:12:21 +07:00
dependabot[bot] b3d6190d06 ci: bump the actions group with 3 updates
Bumps the actions group with 3 updates: [SonarSource/sonarqube-scan-action](https://github.com/sonarsource/sonarqube-scan-action), [amannn/action-semantic-pull-request](https://github.com/amannn/action-semantic-pull-request) and [actions/setup-java](https://github.com/actions/setup-java).


Updates `SonarSource/sonarqube-scan-action` from 8.4.0 to 8.4.1
- [Release notes](https://github.com/sonarsource/sonarqube-scan-action/releases)
- [Commits](https://github.com/sonarsource/sonarqube-scan-action/compare/4d1dc0c91ee400dcf8a6dddf2f705ac36542e304...e805d875275f728fac1885b413934be6d7c63f65)

Updates `amannn/action-semantic-pull-request` from 6.1.1 to 6.1.2
- [Release notes](https://github.com/amannn/action-semantic-pull-request/releases)
- [Changelog](https://github.com/amannn/action-semantic-pull-request/blob/main/CHANGELOG.md)
- [Commits](https://github.com/amannn/action-semantic-pull-request/compare/48f256284bd46cdaab1048c3721360e808335d50...2252a14e810aa9b85c2d560bd7070c802206ecf6)

Updates `actions/setup-java` from 6.1.0 to 6.2.0
- [Release notes](https://github.com/actions/setup-java/releases)
- [Commits](https://github.com/actions/setup-java/compare/b843ebf9b913146b38da2eaa7aeddf76074ae1ad...77dd5b2ce225ea11469928ac317850245a74ae78)

---
updated-dependencies:
- dependency-name: SonarSource/sonarqube-scan-action
  dependency-version: 8.4.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: amannn/action-semantic-pull-request
  dependency-version: 6.1.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: actions/setup-java
  dependency-version: 6.2.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-16 13:46:39 +00:00
poli0981 0297209cff Merge pull request #249 from poli0981/chore/release-1.5.2
chore(release): v1.5.2
2026-11-10 06:03:11 +07:00
poli0981andClaude Fable 5.2 653cf829af chore(release): v1.5.2
Maintenance (#245, #248): Tauri 2.12.5 with the fixes its window,
webview and single-instance layers collected since 2.12.4, and this
week's dependency updates; i18next stays on 26.6.x to keep the initial
load inside its budget.

- CHANGELOG v1.5.2, ROADMAP entry and status
- docs: TECH-SPEC's package.json listing follows the real file again
  and notes the i18next hold
- version references: ARCHITECTURE, TECH-SPEC, PACKAGING, FEATURES,
  DISCLAIMER + Vietnamese, the bug-report and accessibility templates
- six manifests 1.5.1 -> 1.5.2

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-10 05:58:06 +07:00
poli0981 d0d22ef679 Merge pull request #248 from poli0981/chore/deps-2026-11-10
chore(deps): fold this week's updates; tauri 2.12.5; hold i18next at 26.6
2026-11-10 05:57:44 +07:00
poli0981andClaude Fable 5.2 8a76e98eea chore(deps): fold this week's updates; tauri 2.12.5; hold i18next at 26.6
Folds Dependabot's #242, #243, #244, #246 and #247 into one change.
Each failed the required `check` job the same way (a new version makes
THIRD_PARTY_NOTICES.md stale) and they conflict with each other in
package-lock.json and the notices.

npm, installed with `npm update --before=2026-11-03`, the 7-day
cooldown Dependabot uses:

- i18next 26.5.11 -> 26.6.0, react-i18next 17.1.9 -> 17.1.11,
  i18next-resources-to-backend 1.2.3 -> 1.2.4
- lucide-react 1.64.0 -> 1.66.0, react-router-dom 7.18.4 -> 7.18.5,
  simple-icons 16.35.0 -> 16.36.0
- vite 8.3.4 -> 8.3.5 (rolldown 1.2.16), @vitejs/plugin-react 6.1.2 ->
  6.2.1, tailwindcss 4.3.3 -> 4.3.4, postcss 8.5.32, autoprefixer
  10.6.2, marked 18.1.1 -> 18.1.3
- eslint 10.13.0 -> 10.14.0, typescript-eslint 8.72.1, knip 6.44.1,
  @types/node 26.6.6
- wrangler 4.152.0 -> 4.156.2 (miniflare 5.20261102.0-beta)

i18next stops at 26.6.x (`~26.6.0` plus a Dependabot ignore for
26.7.x): 26.7 adds the debug-mode warnings for the move to v27, about
1.9 KB gzip in the i18n chunk, which takes the initial load from 279.0
to 280.9 KB, over the 280 KB budget, for code the app never runs.

The undici override is gone: miniflare 5.20261102.0-beta depends on
undici 7.30.1 itself (alert #49 stays fixed).

Rust: tauri 2.12.4 -> 2.12.5, tauri-build / -macros / -codegen 2.7.4,
tauri-runtime-wry 2.12.3, wry 0.57.1, tao 0.37.2, tauri-plugin-dialog
2.8.4 (rfd 0.17), tauri-plugin-single-instance 2.5.5. All older than
the cooldown. THIRD_PARTY_NOTICES regenerated.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-10 05:51:26 +07:00
poli0981 dfe5f827dd Merge pull request #245 from poli0981/dependabot/github_actions/actions-34703ed004
ci: bump the actions group with 2 updates
2026-11-10 05:39:03 +07:00
dependabot[bot] ae3f729c4e ci: bump the actions group with 2 updates
Bumps the actions group with 2 updates: [SonarSource/sonarqube-scan-action](https://github.com/sonarsource/sonarqube-scan-action) and [zizmorcore/zizmor-action](https://github.com/zizmorcore/zizmor-action).


Updates `SonarSource/sonarqube-scan-action` from 8.3.0 to 8.4.0
- [Release notes](https://github.com/sonarsource/sonarqube-scan-action/releases)
- [Commits](https://github.com/sonarsource/sonarqube-scan-action/compare/d209202bc7d53ff1cc128f7f907dac145c9d6ae9...4d1dc0c91ee400dcf8a6dddf2f705ac36542e304)

Updates `zizmorcore/zizmor-action` from 0.8.0 to 0.8.1
- [Release notes](https://github.com/zizmorcore/zizmor-action/releases)
- [Commits](https://github.com/zizmorcore/zizmor-action/compare/53290badfa369cb0bf7ad16342cb62c2fa47ac7b...45d7276c9ca790aabd705e31ca99c6185c3e76dd)

---
updated-dependencies:
- dependency-name: SonarSource/sonarqube-scan-action
  dependency-version: 8.4.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: zizmorcore/zizmor-action
  dependency-version: 0.8.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-09 13:46:31 +00:00
poli0981 df92c80bcf Merge pull request #240 from poli0981/chore/release-1.5.1
chore(release): v1.5.1
2026-11-09 20:22:41 +07:00
poli0981andClaude Opus 5.5 5fd28e336c chore(release): v1.5.1
Accessibility (#238, #239): AA contrast, generated text marked with its
language, page names read out after a navigation, the single-key
shortcut switch, desktop zoom hotkeys, and ACCESSIBILITY.md in the repo,
the Legal Center and on the website.

- CHANGELOG v1.5.1, ROADMAP entry and status
- docs: ARCHITECTURE (RouteAnnouncer, settings, capabilities), TECH-SPEC
  (singleKeyShortcuts, contrast test, test count), PACKAGING (zoom
  hotkeys and permission), FEATURES
- version references: DISCLAIMER + Vietnamese, the bug-report template
- six manifests 1.5.0 -> 1.5.1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 20:19:21 +07:00
poli0981 754b669f4d Merge pull request #239 from poli0981/docs/accessibility-statement
feat(legal): accessibility statement — ACCESSIBILITY.md, Legal Center page, issue form
2026-11-09 20:19:16 +07:00
poli0981andClaude Opus 5.5 a45a06fad7 feat(legal): accessibility statement — ACCESSIBILITY.md, Legal Center page, issue form
- ACCESSIBILITY.md (+ docs/i18n/vi): goal (WCAG 2.2 AA, not a conformance
  claim), what works with a keyboard, screen readers, zoom, motion and touch,
  how it is checked, supported environments, known limitations, how to
  report a barrier (severity, response), and a checklist for contributors.
- In the Legal Center (consent: false, English + Vietnamese) and as
  /legal/accessibility on the website; the Turnstile page's footer links it
  in all eight languages.
- .github: Accessibility barrier issue form (label `accessibility`), an
  Accessibility option in the feature request scope, an accessibility
  checklist in the PR template.
- README, CONTRIBUTING, DEVELOPMENT (+vi), FEATURES and CLAUDE.md point to
  it; SECURITY.md's supported versions move from 1.3.x to 1.5.x.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 20:12:25 +07:00
poli0981 806201721c Merge pull request #238 from poli0981/feat/accessibility-pass
feat(a11y): contrast to AA, output language, page announcements, single-key shortcut switch, desktop zoom
2026-11-09 20:10:35 +07:00
poli0981andClaude Opus 5.5 68dc48ea53 feat(a11y): AA contrast, output language, page announcements, single-key shortcut switch, desktop zoom
- Colour tokens reach WCAG AA: lighter muted text and accent in the dark
  theme, darker muted/success/warning/danger/donate in the light theme, and
  new accent-solid / danger-solid fills for buttons with white text.
  tests/styles/contrast.test.ts checks every text token on every surface.
- Generated text carries its language (lang) on Output, the YouTube and
  quick previews, History, Batch, Social and Playlist, so screen readers read
  Japanese output with a Japanese voice.
- RouteAnnouncer reads the new page's name after a navigation; focus stays.
- Toast region and close button are translated; Alt+T is in the shortcut list.
- Endings table inputs and the custom bank name get accessible names; the
  From/To headers are translated.
- Settings > Editor > Single-key shortcuts turns the bare ? off (WCAG 2.1.4).
- Text inputs use outline-hidden so the focus outline shows in Windows High
  Contrast; the genre remove button is 24px, small close/dismiss buttons
  grow on touch screens.
- Desktop: zoomHotkeysEnabled (Ctrl/Cmd + = / -), with the
  set-webview-zoom permission for the macOS/Linux polyfill.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 20:02:37 +07:00
poli0981 d6cfea8449 Merge pull request #236 from poli0981/chore/release-1.5.0
chore(release): v1.5.0
2026-11-08 00:44:38 +07:00
poli0981andClaude Opus 5.5 8628991390 chore(release): v1.5.0
Upscaled video (#235): "Upscaled from" in Video settings, the
[4K Upscaled] title badge, the Upscale line in VIDEO SETTINGS and an
automatic tech note about upscaled detail.

- CHANGELOG v1.5.0, ROADMAP entry and status
- docs: FEATURES, CONTENT-INVENTORY (+ Vietnamese), ARCHITECTURE and
  TECH-SPEC (upscale.ts, store v21, test count), CLAUDE.md
- version references: PACKAGING, DISCLAIMER + Vietnamese, the
  bug-report template
- six manifests 1.4.0 -> 1.5.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-08 00:41:56 +07:00
poli0981 06e0d9ae3d Merge pull request #235 from poli0981/feat/upscaled-video
feat(editor): upscaled video — [4K Upscaled] badge, upscale line and warning
2026-11-08 00:41:47 +07:00
poli0981andClaude Opus 5.5 941a1fad4f feat(editor): upscaled video — [4K Upscaled] badge, upscale line and warning
Video settings gain "Upscaled from" next to Resolution: footage recorded
at 1440p and exported at 4K in the video editor is now declared as such.

- Title: the quality badge reads "[4K Upscaled]" ("[2K Upscaled]",
  "[4K Upscaled 120FPS]"), with the word in the output language; badge
  position, case and the "Show quality badge" setting apply as before.
  1080p 60fps keeps no badge, upscaled or not.
- Description, VIDEO SETTINGS: "Upscale: 1440p → 4K (DaVinci Resolve
  Studio 21.2)" right under the Video line, the editor taken from My Rig.
  It stays when the graphics settings are hidden.
- Description, TECH NOTES: an automatic bilingual note that upscaling
  reconstructs fine detail, so text, textures and edges may look slightly
  different from the original image. It is not in the checklist and
  goes away with the upscale.
- The Select lists only resolutions below the video's; lowering the
  resolution to or below the source ends the upscale. The collapsed
  section reads "1440p → 4K · 60 FPS". Saved with the channel profile.
- Editor store v20 → v21 (back-fills "" and drops unknown values);
  backups and applied items read an unknown value as not upscaled.
  `validUpscaleSource` in src/engine/upscale.ts is the one rule the
  title, description and form share. AUTO_TECH_NOTES holds the engine's
  own notes; their bullets share description.techNotes.items.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-08 00:38:08 +07:00
poli0981 8cc9a46167 Merge pull request #233 from poli0981/ci/macos-15-runner
ci(release): build the macOS app on macos-15
2026-11-06 22:51:53 +07:00
poli0981andClaude Opus 5.5 cf9934e25f ci(release): build the macOS app on macos-15
GitHub retired the macOS 14 runner image on 2026-11-02. The v1.4.0 tag's
Release Desktop run had its macOS job cancelled before any step ran
("The configuration 'macos-14-arm64-us-default' is not supported"); the
Windows and Linux builds went through. macos-15 is the direct Apple
silicon successor.

The macOS .app.tar.gz for v1.4.0 will come from the workflow's manual
`workflow_dispatch` re-run with tag v1.4.0, which takes the job matrix
from main and checks out the tag's code. PACKAGING's runner table and
the v1.4.0 CHANGELOG entry say so.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 22:44:25 +07:00
poli0981 09f50362a2 Merge pull request #232 from poli0981/chore/release-1.4.0
docs: v1.4.0 — LUT field, boss name tag; bump to 1.4.0
2026-11-06 22:28:33 +07:00
poli0981andClaude Opus 5.5 d2519ccaef chore(release): v1.4.0
A LUT field in My Rig (#230), the boss's name as a tag in boss videos
(#231), and this week's dependency updates (#228, #229).

- CHANGELOG v1.4.0, ROADMAP entry and status
- version references: ARCHITECTURE, TECH-SPEC (+ test count), PACKAGING,
  FEATURES, DISCLAIMER + Vietnamese, the bug-report template
- six manifests 1.3.2 -> 1.4.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 22:26:22 +07:00
poli0981 b216d71591 Merge pull request #231 from poli0981/feat/boss-name-tag
feat(tags): the boss name as a tag in boss videos
2026-11-06 22:25:08 +07:00
poli0981 b7d357ce4c Merge pull request #230 from poli0981/feat/rig-lut
feat(rig): add a LUT field under the video editor
2026-11-06 22:23:13 +07:00
poli0981andClaude Opus 5.5 0789a11a39 feat(tags): the boss name as a tag in boss videos
Boss Fight and Boss No Hit videos get the boss's name as a tag of its
own, right after the game's name, so fitting the list to 500 characters
never drops it.

bossNameTag cleans the Boss Name field the way a search term reads:
- NFC first; everything but letters (any script), marks, digits,
  whitespace and in-word ' ' - becomes a space: , : ; ! ? quotes,
  brackets, &, the CJK brackets and dots, (TM), emoji.
- A dot stays between digits ("Phase 2.0"), goes between initials
  ("S.T.A.L.K.E.R." -> "STALKER") and is a space anywhere else
  ("Mr.X" -> "Mr X"). Done per word in code: a lookbehind would be a
  syntax error in the macOS 11-13 webview and stop the chunk loading.
- Over 30 characters, the name before its title ("Loretta, Knight of
  the Haligtree" -> "Loretta"), else the leading words that fit; the
  word fit is now a helper shared with tagFriendlyGameName (same result
  there).

Only the video types whose extraFields include bossName add it, so a
boss name left in the draft after switching to Full Gameplay is not
tagged. Docs: FEATURES, ARCHITECTURE 2.3, TECH-SPEC.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 22:22:33 +07:00
poli0981andClaude Opus 5.5 d799c52112 feat(rig): add a LUT field under the video editor
A new My Rig field for the LUT graded in the video editor. The
description and the social captions print it on its own line right
under the editor ("LUT: Arri Alexa LogC to Rec709"); left empty, there
is no line.

- Typing offers the LUTs that come with DaVinci Resolve, named the way
  its LUT menu shows them (from Resolve 21's own LUT folder); any other
  name is printed as typed.
- cleanLutName tidies a pasted file name or path: Explorer's "Copy as
  path" or a macOS path keeps only the file name, and a .cube / .dat /
  .3dl / .csp / .ilut / .olut / .look extension goes. Dots inside a
  name ("SLog3SGamut3.CineToLC-709") stay.
- RigField gets `clean` (CPU and LUT) and `wide`. The cleaner runs when
  the field loses focus and again in formatRigValue, so Ctrl/Cmd+Shift+C
  or Ctrl/Cmd+S pressed with the cursor still in the field prints the
  tidy name too; the LUT field spans both columns, under the editor row.
- `rig.lut` and `description.rigLabels.lut` ("LUT") in all eight
  locales and _schema.json; a test now holds both label sets to
  RIG_FIELDS.

No store migration: the rig is a flat string map in the channel
profile.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 22:17:44 +07:00
poli0981 c14698c704 Merge pull request #229 from poli0981/chore/deps-2026-11-06
chore(deps): fold this week's Dependabot updates
2026-11-06 22:14:05 +07:00
poli0981andClaude Opus 5.5 78abb6f354 chore(deps): fold this week's Dependabot updates
Folds #223-#227 into one change. Each of them failed the required
`check` job the same way: a new version makes THIRD_PARTY_NOTICES.md
stale, and merged one by one they would conflict with each other in
package-lock.json and the notices.

- i18next 26.5.3 -> 26.5.11, react-i18next 17.1.0 -> 17.1.9
- lucide-react 1.59.0 -> 1.64.0, zustand 5.0.15 -> 5.0.16
- knip 6.42.1 -> 6.44.0
- wrangler 4.151.2 -> 4.152.0 (miniflare 5.20261019.2-beta)
- @tauri-apps/cli 2.12.3 -> 2.12.4 (matches the tauri 2.12.4 crate)

Installed with `npm install --before=2026-10-30`, the same 7-day
cooldown Dependabot uses; lucide-react and knip land on the newest
releases past it (1.64.0, 6.44.0) rather than Dependabot's 1.61.0 and
6.43.0. The undici override stays: miniflare 5.20261019.2-beta still
pins undici 7.29.1. THIRD_PARTY_NOTICES regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 22:09:22 +07:00
poli0981 842b9d2a36 Merge pull request #228 from poli0981/dependabot/github_actions/actions-d480c5930a
ci: bump the actions group with 2 updates
2026-11-06 22:03:37 +07:00
dependabot[bot] 931d7d8f8e ci: bump the actions group with 2 updates
Bumps the actions group with 2 updates: [Swatinem/rust-cache](https://github.com/swatinem/rust-cache) and [zizmorcore/zizmor-action](https://github.com/zizmorcore/zizmor-action).


Updates `Swatinem/rust-cache` from 2.9.2 to 2.9.3
- [Release notes](https://github.com/swatinem/rust-cache/releases)
- [Changelog](https://github.com/Swatinem/rust-cache/blob/master/CHANGELOG.md)
- [Commits](https://github.com/swatinem/rust-cache/compare/6323deb102c322ba6fcbdcafc7e3dddab59af2b6...d1527c8f67ef9af357290475d4af4b0fab8f12e0)

Updates `zizmorcore/zizmor-action` from 0.7.1 to 0.8.0
- [Release notes](https://github.com/zizmorcore/zizmor-action/releases)
- [Commits](https://github.com/zizmorcore/zizmor-action/compare/85b2b9fb8e3325e7a23d7d0a9d7ba5ae0f999e3e...53290badfa369cb0bf7ad16342cb62c2fa47ac7b)

---
updated-dependencies:
- dependency-name: Swatinem/rust-cache
  dependency-version: 2.9.3
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
- dependency-name: zizmorcore/zizmor-action
  dependency-version: 0.8.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-11-02 13:47:23 +00:00
148 changed files with 4805 additions and 1676 deletions

No files matched your search

+123
View File
@@ -0,0 +1,123 @@
name: Accessibility barrier
description: Something stops or slows you down when you use a keyboard, a screen reader, zoom, high contrast, voice control or a touch screen.
title: "[A11y]: "
labels: ["accessibility", "needs-triage"]
body:
- type: markdown
attributes:
value: |
Thanks for telling us. You don't need to know what causes the problem — describe what you tried and what happened.
Prefer not to post in public? Email **contact@poli0981.dev** with `[Accessibility]` at the start of the subject.
How reports are handled: [ACCESSIBILITY.md](https://github.com/poli0981/youtube-generator/blob/main/ACCESSIBILITY.md#reporting-a-barrier).
- type: textarea
id: barrier
attributes:
label: What happened?
description: What were you trying to do, and what got in the way?
placeholder: e.g. "With NVDA, the Copy Title button is announced only as 'button'."
validations:
required: true
- type: textarea
id: repro
attributes:
label: Steps to reproduce
description: The page, then numbered steps — keys you pressed, gestures or voice commands.
placeholder: |
1. Open Output
2. Press Tab until the Copy Title button
3. Listen to what the screen reader says
validations:
required: true
- type: textarea
id: expected
attributes:
label: What did you expect?
validations:
required: true
- type: dropdown
id: assistive-tech
attributes:
label: Assistive technology or setting
description: Pick everything you were using.
multiple: true
options:
- Keyboard only
- Narrator (Windows)
- NVDA
- JAWS
- VoiceOver (macOS / iOS)
- TalkBack (Android)
- Orca (Linux)
- Screen magnifier / browser zoom
- Speech input / voice control
- High contrast / forced colours
- Reduce motion
- Switch access
- Other (say which below)
validations:
required: true
- type: input
id: assistive-tech-version
attributes:
label: Version of that tool (if you know it)
placeholder: e.g. NVDA 2026.3, VoiceOver on macOS 26
- type: dropdown
id: severity
attributes:
label: How much does it stop you?
description: The levels are explained in ACCESSIBILITY.md.
options:
- Critical — I can't finish a core task (write, generate, copy, save, get past the website check)
- High — I can finish it, but only with real difficulty or a workaround
- Medium — it works, but inconsistently or confusingly
- Low — a minor annoyance
validations:
required: true
- type: input
id: version
attributes:
label: App version
description: From the About page. Example `v1.6.0`.
placeholder: v1.6.0
validations:
required: true
- type: dropdown
id: surface
attributes:
label: Where are you running YTDescGen?
options:
- Web (ytgenerator.stream)
- Desktop — Windows (Tauri)
- Desktop — macOS (Tauri)
- Desktop — Linux (Tauri)
- Android (APK)
- Local dev (npm run dev)
validations:
required: true
- type: input
id: os
attributes:
label: Operating system and browser
description: e.g. Windows 11 25H2 + Edge 141, macOS 26 + Safari 26, Android 15. Leave the browser out for the desktop and Android apps.
validations:
required: true
- type: dropdown
id: language
attributes:
label: App language
options:
- English (en)
- Tiếng Việt (vi)
- 日本語 (ja)
- Español (es)
- 한국어 (ko)
- 简体中文 (zh)
- Português (BR) (pt-BR)
- Bahasa Indonesia (id)
validations:
required: true
- type: textarea
id: recording
attributes:
label: Screen recording, screenshot or screen reader output (optional)
description: Drag and drop files here, or paste what the screen reader said.
+3 -3
View File
@@ -1,7 +1,7 @@
name: Bug report
description: Something is broken or behaving unexpectedly.
title: "[Bug]: "
labels: ["bug", "triage"]
labels: ["bug", "needs-triage"]
body:
- type: markdown
attributes:
@@ -12,8 +12,8 @@ body:
id: version
attributes:
label: App version
description: From the About page. Example `v1.3.2`.
placeholder: v1.3.2
description: From the About page. Example `v1.6.0`.
placeholder: v1.6.0
validations:
required: true
- type: dropdown
+4 -1
View File
@@ -1,5 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: Feature ideas (maintenance mode)
url: https://github.com/poli0981/youtube-generator/discussions/categories/ideas
about: YTDescGen is in maintenance mode and takes no new features. Share ideas in Discussions, with no commitment. To add or remove an option in one of the app's lists, use the Option request form.
- name: Report a security vulnerability
url: https://github.com/poli0981/youtube-generator/security/advisories/new
about: Privately, please — never in a public issue. See SECURITY.md.
@@ -8,7 +11,7 @@ contact_links:
about: How-tos, backup & restore, troubleshooting and the FAQ.
- name: Discord
url: https://discord.gg/kDM9GMu5vm
about: For casual questions, gameplay chat, or quick help. Use a bug report or feature request for anything actionable.
about: For casual questions, gameplay chat, or quick help. Use an issue form for anything actionable.
- name: All channels and contacts
url: https://poli0981.dev/links/
about: Email addresses by purpose and every other way to reach the maintainer.
@@ -1,55 +0,0 @@
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
- Batch
- Social captions
- Playlist
- History
- Profiles / presets
- Templates (description, title, tags)
- Backup & restore
- i18n / locales
- Settings
- Web app (ytgenerator.stream)
- Desktop (Tauri)
- Android
- 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
+62
View File
@@ -0,0 +1,62 @@
name: Option request
description: Add or remove an option in one of the app's lists — a store, platform, genre, video type, content warning, tech note, GPU or upscaler / frame-generation mode.
title: "[Option]: "
labels: ["option-request", "needs-triage"]
body:
- type: markdown
attributes:
value: |
YTDescGen is in **maintenance mode** ([CONTRIBUTING.md → Maintenance mode](https://github.com/poli0981/youtube-generator/blob/main/CONTRIBUTING.md#maintenance-mode)): it takes no new features, but an option people really need can still join — or leave — one of the lists the app already has. For anything else, share the idea in [Discussions → Ideas](https://github.com/poli0981/youtube-generator/discussions/categories/ideas).
- type: dropdown
id: action
attributes:
label: Add or remove?
options:
- Add an option
- Remove an option
validations:
required: true
- type: dropdown
id: list
attributes:
label: Which list
options:
- Store (store links)
- Social or donate platform
- Game genre
- Video type
- Content warning
- Tech note
- GPU (rig catalog)
- Upscaler / frame generation (Video settings)
- Another list (say which below)
validations:
required: true
- type: input
id: option
attributes:
label: The option
description: Its name as it should appear, e.g. "itch.io", "Roguelite", "AMD FSR 4 x4".
validations:
required: true
- type: textarea
id: why
attributes:
label: Who needs it, and why
description: What can't you do today? A link helps — the store page, the vendor's announcement, a video of yours that needed it.
validations:
required: true
- type: textarea
id: wording
attributes:
label: Suggested wording (optional)
description: For a content warning or tech note, the editor label and the line the description should print, in any of the eight languages you know.
- type: checkboxes
id: checks
attributes:
label: Pre-flight checks
options:
- label: I searched existing issues and this is not a duplicate.
required: true
- label: This adds or removes an option in a list the app already has — it is not a new feature.
required: true
+69
View File
@@ -0,0 +1,69 @@
name: Translation or wording fix
description: Wording that doesn't fit a culture or region, or a spelling mistake that could mislead — in the interface or in the generated text.
title: "[i18n]: "
labels: ["i18n", "needs-triage"]
body:
- type: markdown
attributes:
value: |
YTDescGen ships eight languages. Vietnamese is native-reviewed; Japanese, Spanish, Korean, Chinese, Portuguese (Brazil) and Indonesian are AI-translated (see [DISCLAIMER.md](https://github.com/poli0981/youtube-generator/blob/main/DISCLAIMER.md)), so corrections from native speakers are very welcome.
- type: dropdown
id: language
attributes:
label: Language
options:
- English (en)
- Tiếng Việt (vi)
- 日本語 (ja)
- Español (es)
- 한국어 (ko)
- 简体中文 (zh)
- Português (BR) (pt-BR)
- Bahasa Indonesia (id)
validations:
required: true
- type: dropdown
id: where
attributes:
label: Where
options:
- The interface (buttons, labels, messages)
- The generated title, description or tags
- Both
validations:
required: true
- type: textarea
id: current
attributes:
label: Current text
description: Copy it exactly as shown, and say where you saw it — the page or field, or the section of the description. A screenshot helps.
validations:
required: true
- type: textarea
id: suggested
attributes:
label: Suggested text
validations:
required: true
- type: dropdown
id: why
attributes:
label: Why
options:
- It doesn't fit the culture, region or usual tone
- A spelling or grammar mistake that could mislead
- The meaning is wrong (a mistranslation)
- Something else (say below)
validations:
required: true
- type: textarea
id: details
attributes:
label: Details (optional)
- type: checkboxes
id: checks
attributes:
label: Pre-flight checks
options:
- label: I searched existing issues and this is not a duplicate.
required: true
+32
View File
@@ -1,3 +1,10 @@
<!--
YTDescGen is in maintenance mode (CONTRIBUTING.md → "Maintenance mode"):
new features are out of scope, and `feat:` pull requests from outside
contributors are closed automatically unless their scope is `options`
(an agreed option request), `a11y` or `i18n`.
-->
## Summary
<!-- 1-3 bullet points describing the change -->
@@ -5,6 +12,17 @@
-
-
## Scope
<!-- Tick what this PR is. Anything else is out of scope while YTDescGen is in maintenance mode. -->
- [ ] Bug fix, broken UI/UX or accessibility fix
- [ ] Translation or wording fix
- [ ] Add or remove an option in one of the app's lists, agreed in issue #
- [ ] Dependency update, security fix, or major language/runtime/framework upgrade
- [ ] Cloudflare / Worker change, or a fix for a website incident
- [ ] Docs or tests only
## Type
- [ ] `feat` — new feature
@@ -42,6 +60,20 @@ If this PR touches the UI, attach screenshots or short recordings at:
Otherwise delete this section.
-->
## Accessibility
<!--
If this PR touches the UI, check each item (see ACCESSIBILITY.md#for-contributors).
Otherwise delete this section.
-->
- [ ] Works with the keyboard alone: logical focus order, visible focus, Esc closes, no focus trap
- [ ] Every control has a name and every field a label (`Field`, `IconButton`); new `aria-label` text is in all 8 locales
- [ ] Errors and status changes are announced (alert banner, toast or live region)
- [ ] Colour is not the only signal; design tokens only, and the contrast test passes
- [ ] New animation respects reduced motion; targets are at least 24 × 24 px
- [ ] Checked once with a screen reader (Narrator, VoiceOver, NVDA or Orca)
## AI-Assisted Contribution
- [ ] Yes — AI tool used: <!-- e.g. Claude Code (Claude Opus 5.5), Cursor, GitHub Copilot -->
+11 -9
View File
@@ -21,16 +21,15 @@
# other long-standing one, left the tree in v1.0.0 when tauri 2.12 dropped
# kuchikiki.)
#
# The npm side has the opposite case, a fix Dependabot cannot reach: miniflare
# (under wrangler, dev only) pins `undici` to an exact version, so the security
# job fails with `security_update_not_possible` and `overrides` in package.json
# lifts it instead:
# The npm side holds one package back on purpose: `i18next` stays on 26.6.x
# (`~26.6.0` in package.json). 26.7, the last 26.x minor, adds the debug-mode
# warnings that prepare the move to v27 — about 1.9 KB gzip in the i18n chunk,
# which takes the initial load from 279.0 KB to 280.9 KB, over the 280 KB
# budget (`npm run check:bundle`), for code the app never runs. Remove the
# ignore and the tilde with the planned i18next 27 migration.
#
# undici 7.29.1 (fix: 7.30.1, alert #49) pinned by
# miniflare 5.x (every release up to 5.20261019.2-beta)
#
# Remove the override once a wrangler release brings undici >= 7.30.1 on its
# own (`npm view miniflare@<version> dependencies.undici`).
# (`undici`, overridden in package.json for alert #49 until v1.5.1, needs no
# override any more: miniflare >= 5.20261101 depends on undici 7.30.1 itself.)
#
# Tauri moves in lockstep: the tauri CLI refuses to build when the
# @tauri-apps/* npm packages and the tauri crates differ in major.minor. When
@@ -110,6 +109,9 @@ updates:
# patch.
- dependency-name: "*"
update-types: ["version-update:semver-major"]
# Bundle budget — see the note at the top.
- dependency-name: "i18next"
versions: ["26.7.x"]
- package-ecosystem: "cargo"
directory: "/src-tauri"
+1 -1
View File
@@ -154,7 +154,7 @@ jobs:
fi
echo "version=$version" >> "$GITHUB_OUTPUT"
- name: SonarCloud scan
uses: SonarSource/sonarqube-scan-action@d209202bc7d53ff1cc128f7f907dac145c9d6ae9 # v8.3.0
uses: SonarSource/sonarqube-scan-action@e805d875275f728fac1885b413934be6d7c63f65 # v8.4.1
env:
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
with:
+1 -1
View File
@@ -35,7 +35,7 @@ jobs:
permissions:
pull-requests: read
steps:
- uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
- uses: amannn/action-semantic-pull-request@2252a14e810aa9b85c2d560bd7070c802206ecf6 # v6.1.2
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
+107
View File
@@ -0,0 +1,107 @@
name: Maintenance triage
# YTDescGen is in maintenance mode (CONTRIBUTING.md → Maintenance mode). This
# workflow closes, with a bilingual comment and the `out-of-scope` label:
# • any issue or pull request the maintainer labels `out-of-scope`;
# • when opened by an outside contributor: issues titled [Feature…] or
# labelled `enhancement`, and pull requests titled `feat:` — except the
# scopes maintenance mode still takes: `options` (an agreed option
# request), `a11y` and `i18n`. The owner, members, collaborators and bots
# are skipped.
# pull_request_target runs in the base repository so it can comment on and
# close pull requests from forks. It never checks out or runs pull request
# code, and the script reads titles from the event payload itself instead of
# having untrusted text interpolated into it (.github/zizmor.yml says so too).
on:
issues:
types: [opened, labeled]
pull_request_target:
types: [opened, labeled]
permissions: {}
concurrency:
group: maintenance-triage-${{ github.event.issue.number || github.event.pull_request.number }}
cancel-in-progress: false
jobs:
triage:
name: Close out-of-scope requests
if: >-
(github.event.action == 'labeled' && github.event.label.name == 'out-of-scope') ||
(github.event.action == 'opened' &&
!contains(fromJSON('["OWNER","MEMBER","COLLABORATOR"]'),
github.event.issue.author_association || github.event.pull_request.author_association))
runs-on: ubuntu-latest
timeout-minutes: 5
permissions:
issues: write
pull-requests: write
steps:
- name: Close if out of scope
uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
with:
script: |
const OUT_OF_SCOPE = 'out-of-scope';
const TRUSTED = ['OWNER', 'MEMBER', 'COLLABORATOR'];
// Feature pull requests maintenance mode still takes.
const KEPT_SCOPES = ['options', 'a11y', 'i18n'];
const { payload } = context;
const isPR = Boolean(payload.pull_request);
const item = payload.pull_request ?? payload.issue;
if (!item || item.state !== 'open') return;
const labels = (item.labels ?? []).map((label) => label.name);
let reason = null;
if (payload.action === 'labeled') {
if (payload.label?.name === OUT_OF_SCOPE) reason = 'labelled out-of-scope';
} else if (payload.action === 'opened') {
const trusted = TRUSTED.includes(item.author_association);
const bot = item.user?.type === 'Bot';
const title = String(item.title ?? '').trim();
if (!trusted && !bot) {
if (isPR) {
// Conventional Commits: feat:, feat(scope):, feat!:
const feat = /^feat(?:\(([^)]*)\))?!?:/i.exec(title);
const scope = (feat?.[1] ?? '').trim().toLowerCase();
if (feat && !KEPT_SCOPES.includes(scope)) reason = 'feat: pull request';
} else if (/^\[feature/i.test(title) || labels.includes('enhancement')) {
reason = 'feature request';
}
}
}
if (!reason) {
core.info(`#${item.number}: within scope, nothing to do.`);
return;
}
const ideas = 'https://github.com/poli0981/youtube-generator/discussions/categories/ideas';
const policy = 'https://github.com/poli0981/youtube-generator/blob/main/CONTRIBUTING.md#maintenance-mode';
const en = isPR ? 'pull request' : 'issue';
const vi = isPR ? 'Pull request' : 'Issue';
const body = [
'<!-- maintenance-triage -->',
'Thanks for taking the time to write this. YTDescGen is in **maintenance mode**: it still takes dependency and security updates, major runtime upgrades, fixes for bugs, UI/UX, accessibility and translations, options added to or removed from its lists when people really need them, and Cloudflare or website fixes, but no new features.',
'',
`This ${en} falls outside that scope, so it has been closed. If it is actually a bug, an accessibility or translation fix, or an option request, reply here and the maintainer will take another look. Ideas are welcome in [Discussions → Ideas](${ideas}). The full policy is in [CONTRIBUTING.md → Maintenance mode](${policy}).`,
'',
'---',
'',
'Cảm ơn bạn đã dành thời gian. YTDescGen đang ở **giai đoạn bảo trì**: vẫn nhận cập nhật thư viện và bảo mật, nâng cấp runtime lớn, sửa lỗi, UI/UX, trợ năng (accessibility) và bản dịch, thêm hoặc bỏ một tuỳ chọn trong các danh sách của app khi thật sự có người cần, và sửa lỗi Cloudflare hay website, nhưng không thêm tính năng mới.',
'',
`${vi} này nằm ngoài phạm vi đó nên đã được đóng. Nếu thực ra đây là lỗi, sửa trợ năng hay bản dịch, hoặc yêu cầu tuỳ chọn, hãy trả lời tại đây để maintainer xem lại. Ý tưởng có thể gửi ở [Discussions → Ideas](${ideas}). Chính sách đầy đủ: [CONTRIBUTING.md → Maintenance mode](${policy}).`,
].join('\n');
const { owner, repo } = context.repo;
const number = item.number;
await github.rest.issues.createComment({ owner, repo, issue_number: number, body });
if (!labels.includes(OUT_OF_SCOPE)) {
await github.rest.issues.addLabels({ owner, repo, issue_number: number, labels: [OUT_OF_SCOPE] });
}
if (isPR) {
await github.rest.pulls.update({ owner, repo, pull_number: number, state: 'closed' });
} else {
await github.rest.issues.update({ owner, repo, issue_number: number, state: 'closed', state_reason: 'not_planned' });
}
core.notice(`Closed ${en} #${number} as out of scope (${reason}).`);
+3 -3
View File
@@ -3,9 +3,9 @@ name: Notify CI Failures
on:
workflow_run:
# Match the exact `name:` of each watched workflow (ci.yml, security.yml,
# compliance.yml, rust.yml). Renaming one silently breaks this filter —
# keep them in sync.
workflows: ["CI", "Security", "Compliance", "Rust"]
# compliance.yml, rust.yml, qodana.yml). Renaming one silently breaks
# this filter — keep them in sync.
workflows: ["CI", "Security", "Compliance", "Rust", "Qodana"]
types: [completed]
# REQUIRED: declare permissions matching the reusable workflow's needs.
+137
View File
@@ -0,0 +1,137 @@
name: Qodana
# JetBrains Qodana static analysis, one linter per Qodana Cloud project:
#
# typescript - qodana-js (native mode) the repository project yt-ts-js, secret QODANA_TOKEN_TS_JS, qodana.yaml
# rust - qodana-rust (Docker, EAP) src-tauri/ project yt-rust, secret QODANA_TOKEN_RUST, src-tauri/qodana.yaml
#
# Every run analyses the whole project (`pr-mode: false`), so a pull request
# and `main` report the same way, and each qodana.yaml holds a quality gate of
# zero problems. Results: Qodana Cloud, check annotations on the run, and the
# qodana-report-* artifacts (SARIF and logs). Not a required check.
#
# Both linters need an Ultimate licence; the account runs the Qodana Ultimate
# trial. When the licence lapses, both jobs fail at the licence check: renew
# it, or delete this file and the two qodana.yaml files.
#
# PRs from forks and from Dependabot get no repository secrets: the `tokens`
# job sees that, and the analysis is skipped there, not failed — main is
# analysed once they merge. The token reaches the scan step only: npm
# packages are installed in a step that never sees it.
on:
push:
branches: [main]
pull_request:
branches: [main]
workflow_dispatch:
permissions: {}
concurrency:
group: qodana-${{ github.ref }}
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
jobs:
tokens:
name: Qodana tokens
runs-on: ubuntu-latest
timeout-minutes: 5
permissions: {}
outputs:
ts-js: ${{ steps.check.outputs.ts-js }}
rust: ${{ steps.check.outputs.rust }}
steps:
- name: Check which Qodana tokens this run has
id: check
env:
HAS_TS_JS: ${{ secrets.QODANA_TOKEN_TS_JS != '' }}
HAS_RUST: ${{ secrets.QODANA_TOKEN_RUST != '' }}
run: |
echo "ts-js=$HAS_TS_JS" >> "$GITHUB_OUTPUT"
echo "rust=$HAS_RUST" >> "$GITHUB_OUTPUT"
if [ "$HAS_TS_JS" != true ] || [ "$HAS_RUST" != true ]; then
echo "::notice::No Qodana token in this run (a Dependabot or fork pull request): that analysis is skipped."
fi
typescript:
name: TypeScript / JavaScript
needs: tokens
if: needs.tokens.outputs.ts-js == 'true'
runs-on: ubuntu-latest
timeout-minutes: 40
permissions:
contents: read
checks: write # the action's annotations
steps:
# The pull request's own head commit, not the merge GitHub makes, so
# the report names a commit that exists; full history for its VCS data.
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
- uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
with:
node-version-file: .node-version
cache: npm
# The linter resolves imports and types from node_modules. No lifecycle
# scripts, as in every workflow (ci.yml says why).
- run: npm ci --ignore-scripts
# Native mode: the linter runs on this runner's Node 26 and node_modules
# instead of the older Node the Qodana image ships.
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --linter qodana-js --within-docker false
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-typescript
primary-cache-key: qodana-2026.2-js-${{ github.ref }}-${{ github.sha }}
# A prefix, so pull requests can restore the cache saved on main.
additional-cache-key: qodana-2026.2-js-
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_TS_JS }}
rust:
name: Rust (Early Access)
needs: tokens
if: needs.tokens.outputs.rust == 'true'
runs-on: ubuntu-latest
timeout-minutes: 45
permissions:
contents: read
checks: write # the action's annotations
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
fetch-depth: 0
persist-credentials: false
# tauri::generate_context!() refuses to expand without the frontend
# directory (frontendDist, ../dist): an empty page stands in for the web
# build, which the analysis does not need. The icons are committed.
- name: Stand-in for the web build
run: |
mkdir -p dist
echo '<!doctype html><title>stand-in</title>' > dist/index.html
# qodana-rust ships only as a Docker image. It runs as root so that the
# bootstrap in src-tauri/qodana.yaml can install the C toolchain and the
# libraries Tauri links against — without them `cargo check` fails and
# the linter loads no Cargo package. The crates go to the cached Qodana
# directory. --repository-root keeps ../dist and the git data visible.
- name: Qodana scan
uses: JetBrains/qodana-action@3e8d76ff0e0241618abd808682f426afe84bab3f # v2026.2.2
with:
args: --project-dir src-tauri --repository-root . --linter qodana-rust -u root -e CARGO_HOME=/data/cache/cargo
pr-mode: false
post-pr-comment: false
upload-result: true
artifact-name: qodana-report-rust
primary-cache-key: qodana-2026.2-rust-${{ github.ref }}-${{ github.sha }}
# A prefix, so pull requests can restore the cache saved on main.
additional-cache-key: qodana-2026.2-rust-
cache-default-branch-only: true
env:
QODANA_TOKEN: ${{ secrets.QODANA_TOKEN_RUST }}
+1 -1
View File
@@ -63,7 +63,7 @@ jobs:
# by any other workflow must not be able to feed into them.
package-manager-cache: false
- uses: actions/setup-java@b843ebf9b913146b38da2eaa7aeddf76074ae1ad # v6.1.0
- uses: actions/setup-java@77dd5b2ce225ea11469928ac317850245a74ae78 # v6.2.0
with:
distribution: temurin
java-version: "17"
+5 -1
View File
@@ -64,7 +64,11 @@ jobs:
target: x86_64-pc-windows-msvc
# Default Windows bundles: MSI + NSIS (.exe). Both ship.
bundleArgs: ""
- os: macos-14
# Apple silicon. GitHub retired the macOS 14 image on 2026-11-02
# (`macos-14` jobs are cancelled: "The configuration
# 'macos-14-arm64-us-default' is not supported"); macos-15 is
# its direct successor.
- os: macos-15
target: aarch64-apple-darwin
# macOS DMG bundling on hosted runners flakes inside
# `bundle_dmg.sh` (the AppleScript that sets icon
+1 -1
View File
@@ -43,7 +43,7 @@ jobs:
with:
toolchain: stable
components: rustfmt, clippy
- uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
workspaces: src-tauri
# tauri::generate_context!() embeds the frontend at compile time, so
+1 -1
View File
@@ -48,7 +48,7 @@ jobs:
with:
args: -color
- name: zizmor
uses: zizmorcore/zizmor-action@85b2b9fb8e3325e7a23d7d0a9d7ba5ae0f999e3e # v0.7.1
uses: zizmorcore/zizmor-action@45d7276c9ca790aabd705e31ca99c6185c3e76dd # v0.8.1
with:
# Report in the log and fail the job; no SARIF upload, so findings
# are fixed in the PR instead of piling up as code-scanning alerts.
+6
View File
@@ -18,3 +18,9 @@ rules:
# actor) to the notifier script through `env:`, never by interpolation.
- notify-ci-failure.yml
- notify-release-pipeline.yml
# Runs on `pull_request_target` so it can label, comment on and close
# an out-of-scope pull request from a fork (maintenance mode). It never
# checks out the pull request, runs none of its code, and reads the
# title from the event payload inside the script — nothing from the
# pull request is interpolated into the workflow.
- maintenance-triage.yml
+127
View File
@@ -0,0 +1,127 @@
# Accessibility
**Last updated:** 2026-11-09
YTDescGen should work for everyone who makes videos, including people who use a keyboard instead of a mouse, a screen reader, zoom or magnification, high-contrast modes, voice control or a touch screen. This statement says what works today, how it is checked, what doesn't work yet, and how to tell us about a barrier.
It covers the website at [ytgenerator.stream](https://ytgenerator.stream), the desktop apps (Windows, macOS, Linux) and the Android app. They share one interface, so what is said here applies to all of them unless a platform is named.
## Our goal
We aim for [WCAG 2.2](https://www.w3.org/TR/WCAG22/) level **AA**. That is a goal, not a claim of conformance: YTDescGen is a solo open-source project and has not had an independent audit. When we find something that falls short, it is fixed or listed under [Known limitations](#known-limitations).
## What works today
### Keyboard
- Every page, menu and dialog works with the keyboard alone. **Skip to content** is the first stop on the app's pages, and a visible outline shows where the focus is.
- Dialogs keep the focus inside while they are open, close with **Esc**, and give the focus back to the control that opened them.
- Shortcuts work on every page:
- **Ctrl/⌘ + K**: command palette (any page, copy, profiles, presets, templates, theme, languages).
- **Ctrl/⌘ + G** or **Ctrl/⌘ + Enter**: Output.
- **Ctrl/⌘ + Shift + C**: Copy All.
- **Ctrl/⌘ + S**: save to History.
- **Ctrl/⌘ + B**: sidebar.
- **Alt + T**: notifications.
- **Ctrl/⌘ + /** (or **?**): the full list.
- The single-key **?** shortcut can be turned off in **Settings › Editor › Single-key shortcuts**, for speech input and stray key presses.
### Screen readers
- Every control has a name, including icon-only buttons, and every field has a label. Hints and errors are tied to their field.
- Confirmations and errors are announced ("Copied!", "Saved to History", why something can't be copied), and so are Strict Mode problems.
- After you open another page, its name is read out. The focus stays on the link you used.
- Each page has its own title and a single main heading, and the page language follows the interface language you pick (eight languages).
- Generated titles, descriptions and tags are marked with the language they were written in, so a Japanese description is read with a Japanese voice even when the interface is in English.
### Vision
- Dark and light themes, both at WCAG AA contrast for text (4.5:1) on every background. A test keeps them there ([tests/styles/contrast.test.ts](tests/styles/contrast.test.ts)).
- The layout reflows from wide screens down to phone width, so zooming in moves content into one column instead of off the screen.
- The desktop apps zoom with **Ctrl/⌘ + =** and **Ctrl/⌘ + −** (Ctrl + mouse wheel works on Windows too). On Android, pinch to zoom.
- In Windows High Contrast (forced colours), the focus outline stays visible.
- **Settings › Appearance › Hide scrollbars** removes the scrollbars; scrolling still works with the keyboard, mouse wheel and touch.
### Motion
- With **Reduce motion** turned on in your operating system, animations and smooth scrolling are switched off.
### Touch
- On touch screens, buttons and fields grow to about 44 px, and so do small close and dismiss buttons.
### The website's check page
- The Cloudflare Turnstile check before the website usually finishes on its own. Its status ("Checking your browser…", errors) is announced, and it works with the keyboard. See [Known limitations](#known-limitations) if Cloudflare asks you to solve a challenge.
## How it is checked
- **By hand.** The maintainer uses YTDescGen with the keyboard alone (mouse unplugged) and with Windows Narrator, through the main flows: editor, output, copying, profiles, presets, templates, History, Settings and backups.
- **Automatically.** A unit test checks the contrast of every colour token in both themes.
- **Design rules.** Interface parts come from accessible building blocks (Radix primitives). An icon-only button can't be built without a name, and every field gets its label and error wiring from one shared component.
The app has **not** been tested yet with NVDA, JAWS, VoiceOver (macOS), TalkBack (Android) or Orca (Linux). Reports from people who use them are very welcome.
## Supported environments
| Platform | Runs on | Screen reader |
| --- | --- | --- |
| Windows: desktop app, or the website in Edge / Chrome | Windows 10 or 11 with WebView2; Chrome or Edge 111+ | Narrator: tested |
| Website on other browsers | Firefox 114+, Safari 16.4+ | Not tested yet |
| macOS desktop app | macOS 11 or later, Apple silicon | VoiceOver: not tested yet |
| Linux desktop app | WebKitGTK 2.40 or later | Orca: not tested yet |
| Android app | Android 11 or later, current Android System WebView | TalkBack: not tested yet |
## Known limitations
- **Cloudflare's challenge on the website.** If Turnstile asks you to solve a challenge instead of passing on its own, that challenge is Cloudflare's, and its accessibility is theirs to fix. If it stops you, the desktop and Android apps have no check page at all, or [email us](#reporting-a-barrier).
- **Field borders are faint.** The outline of an empty text field is about 1.2–1.3:1 against the page, under the 3:1 that WCAG asks for. Fields are still marked by their labels, and the focused field gets an accent border and ring.
- **The Continue button on the first-run screen** uses the brand gradient. White text on its lighter violet end is 3.96:1.
- **Character counters are not read out as you type.** That would interrupt every keystroke. When a field is over YouTube's limit, copying it is refused with a message that says why, and Strict Mode lists the problem in an announced banner.
- **No automated accessibility linting yet.** `eslint-plugin-jsx-a11y` does not support ESLint 10, which the project uses, and the unit tests run without a browser DOM. Checks are manual (see above) apart from the contrast test.
- **Translations.** Interface languages other than English and Vietnamese were translated with AI assistance (see the [Disclaimer](DISCLAIMER.md)). Some labels may sound unnatural when read aloud.
- **Emoji in descriptions.** Generated descriptions use a few emoji as section markers (for example 👍 and 🔔), and screen readers on YouTube read them out by name.
## Reporting a barrier
If something in YTDescGen gets in your way, please tell us. You don't need to know what causes it.
- **Preferred:** open an [accessibility issue](https://github.com/poli0981/youtube-generator/issues/new?template=accessibility.yml). The form asks for the platform, the assistive technology you use and what happened.
- **Not comfortable posting publicly?** Email **contact@poli0981.dev** with `[Accessibility]` at the start of the subject.
- **Quick question?** Ask on [Discord](https://discord.gg/kDM9GMu5vm).
### Severity
| Level | Meaning |
| --- | --- |
| **Critical** | You can't finish a core task: write, generate, copy, save, or get past the website's check. |
| **High** | You can finish it, but only with real difficulty or a workaround. |
| **Medium** | It works, but inconsistently or confusingly. |
| **Low** | A minor annoyance that doesn't stop you. |
### How we respond
- We reply within **7 days**, and we will take your report at face value.
- **Critical** barriers are fixed in the next patch release. Others are planned like any other bug, with the more severe first.
- If there is a workaround, we tell you while the fix is on its way.
- When the fix ships, we'll ask you to check it if you're willing.
This is a one-person project, so timelines are honest estimates, not guarantees. If one slips, we'll say so in the issue.
## For contributors
Changes to the interface should keep everything above true. Before opening a pull request that touches the UI:
- **Keyboard.** Everything works with the keyboard: the focus order makes sense, the focus outline is visible, **Esc** closes what you opened, and nothing traps the focus.
- **Names.** Use the shared `Field` (label, hint and error wiring) and `IconButton` (which can't be rendered without a `label`) components. `aria-label` text goes through `t()` like any other string, in all eight locales.
- **Errors and status.** They are announced: `Banner` with `alert`, a toast, or an existing live region.
- **Colour.** Colour is never the only signal. Use the design tokens only, and run `npm run test:run`. The contrast test fails if a token drops under AA, and white text belongs on the `*-solid` fills.
- **Motion.** New animation respects reduced motion. Motion's components do this already, and CSS animations are covered by the global rule in `globals.css`.
- **Targets.** Anything clickable is at least 24 × 24 px and grows on touch screens.
- **Screen reader.** Try the change once with a screen reader: Narrator (Win + Ctrl + Enter), VoiceOver (⌘ + F5), NVDA or Orca.
The pull request template has the same checklist.
## Feedback on this statement
Ideas for improving this statement or the way accessibility is handled are welcome in [GitHub Discussions](https://github.com/poli0981/youtube-generator/discussions). Please report barriers through the [reporting process](#reporting-a-barrier) so they can be tracked.
+147
View File
@@ -2,6 +2,153 @@
All notable changes to YTDescGen ship as tagged releases on `main`.
## v1.6.0 — 2026-11-17
The last feature release: **DLSS 5 Neural Rendering** and more frame-generation modes in Video settings, a **Custom** LUT that prints just "LUT applied", and **JetBrains Qodana** next to SonarCloud. From this version on YTDescGen is in **maintenance mode**: it stays maintained, but takes no new features. Web, desktop and Android all ship as 1.6.0.
### Added
- **DLSS 5 Neural Rendering** — a switch in **Video settings** for NVIDIA (RTX 50 series), printed after the DLSS mode: `In-game Setting: Ultra - NVIDIA DLSS Quality + NVIDIA DLSS 5 Neural Rendering + NVIDIA Dynamic Multi Frame Generation`. Picking another vendor turns it off.
- **More frame generation** — NVIDIA's **x6** and **Dynamic** Multi Frame Generation (DLSS 4.5), and **Custom…** for every vendor: type what you used (_NVIDIA Smooth Motion_, _Lossless Scaling x3_) and the description prints it as typed.
- **Custom LUT** — "Custom" is the LUT field's first suggestion (typing it works too, in any case). **My Rig** then reads just _LUT applied_ — _Có áp dụng LUT_ in Vietnamese, and so on in every output language — without naming your own LUT.
- **Option request** and **Translation or wording fix** issue forms.
### Changed
- **Maintenance mode.** YTDescGen is feature-complete. Dependency and security updates, major language / runtime / framework upgrades, bug, UI/UX, accessibility and translation fixes, options added to or removed from its lists when people really need them, and Cloudflare or website fixes still land; new features don't. See README → Project status and CONTRIBUTING → Maintenance mode; the README carries a status badge.
- The **Feature request** form is gone — ideas go to Discussions → Ideas. A workflow closes feature issues and `feat:` pull requests from outside contributors with an explanation in English and Vietnamese (option requests, accessibility and translation pull requests stay open), and anything the maintainer labels `out-of-scope`.
- Bug and accessibility reports carry the `needs-triage` label; the `triage` label they named never existed.
### Under the hood
- **Qodana** (JetBrains, Ultimate licence): Qodana for JS in native mode and Qodana for Rust (Early Access, Docker) run on every push and pull request, each with a quality gate of zero problems, reported to Qodana Cloud. Dependabot and fork pull requests, which get no token, skip it; the token never shares a step with `npm ci`. The first run's findings (74 in TypeScript, 12 in Rust) were fixed — React 19.3's deprecated `FormEvent` in the three save forms (now `SubmitEvent`), `[^\s]` written as `\S` in the 18 store and playtest URL patterns, the theme start-up script's globals, two copies of the sorted-JSON helper made one (`stableJson`), Vitest reusing Vite's alias map, `show_main_window` for the desktop's three copies of the same block — or excluded in `qodana.yaml` with the reason written next to each.
- **Editor store v22** back-fills `frameGenCustom` and `dlssNeuralRendering`; backups and templates from older versions restore unchanged.
- **Dependencies**, the newest releases at least a week old: react-i18next 17.1.13, lucide-react 1.70, zustand 5.1.0, simple-icons 16.37, vite 8.3.7 (rolldown 1.2.18), @vitejs/plugin-react 6.3.0, tailwindcss 4.3.5, typescript-eslint 8.72.2, knip 6.44.2, marked 18.2.0, wrangler 4.159.0. Workflows: sonarqube-scan-action 8.4.1, action-semantic-pull-request 6.1.2, setup-java 6.2.0. Rust: async-executor 1.14.0 → 1.14.1 (1.14.0 was yanked). THIRD_PARTY_NOTICES regenerated.
- **Node.js 26.13.1**, the 2026-11-11 security release (16 CVEs, 7 rated high, in HTTP/2 and TLS servers): `.node-version` names the 26 line, so CI picks it up; the app runs no Node server, so nothing else changes.
- Held back, still inside the 7-day cooldown: eslint 10.15 / typescript-eslint 8.73 — they move to minimatch 11, which closes the medium, development-only alert #50 — and Tauri 2.12.6.
- **Docs**: README, CONTRIBUTING, SECURITY, MAINTAINERS, ROADMAP, FEATURES (upscaler and frame generation, LUT Custom), TECH-SPEC (Qodana, store v22, the rig block), DEVELOPMENT (+ Vietnamese), CONTENT-INVENTORY (+ Vietnamese), CLAUDE.md, version references.
- typecheck, typecheck:all, lint, format:check, validate:locales, knip, check:version, check:tauri, check:licenses, check:copyright, **1158 tests** (was 1131), build, cf:check and `cargo fmt` / `clippy` / `test` / `deny` all pass; Qodana reports no problems in either project and SonarCloud none on new code; initial load 279.6 of 280 KB gzip. Verified live: `wrangler dev` on 4.159.0 serves the gate page, `/legal/accessibility` and `robots.txt` and refuses a verify without a token; in the dev server a draft survives a reload on zustand 5.1, a v21 draft migrates to v22, NVIDIA offers x6 / Dynamic / Custom… and the DLSS 5 switch (the Output page prints the line above), switching to AMD turns DLSS 5 off and keeps a Custom frame generation, and a Custom LUT prints "LUT applied" in English and "Có áp dụng LUT" in Vietnamese.
- Six manifests bumped 1.5.2 → 1.6.0.
## v1.5.2 — 2026-11-10
A maintenance release: the desktop and Android apps move to **Tauri 2.12.5**, with the fixes its window, webview and single-instance layers collected since 2.12.4, and this week's dependency updates are folded in. What the app generates does not change. Web, desktop and Android all ship as 1.5.2.
### Fixed
- **Windows: starting the app a second time.** A second copy started while the first was still starting up could miss the first one's window and stay open instead of handing over and exiting (tauri-plugin-single-instance 2.5.5). A hidden window — the app sitting in the tray — no longer flashes when it leaves the maximized state (tao 0.37.2).
- **macOS: dragging onto the window.** No abort when a drag enters or is dropped on the window, and no panic while the dragged file paths are collected (tao 0.37.2, wry 0.57.1).
- **Android:** the webview runs Tauri's start-up scripts once per page instead of twice (wry 0.57.1).
- **Windows installer:** the NSIS installer blocks a downgrade over a newer MSI installation in silent, passive and update modes too (Tauri 2.12.5).
### Under the hood
- **Tauri 2.12.4 → 2.12.5**: tauri-build, tauri-macros and tauri-codegen 2.7.4, tauri-runtime-wry 2.12.3, wry 0.57.1, tao 0.37.2, tauri-plugin-dialog 2.8.4 (rfd 0.17), tauri-plugin-single-instance 2.5.5.
- **Dependencies**, the newest releases at least a week old (the same cooldown Dependabot uses): i18next 26.6.0, react-i18next 17.1.11, i18next-resources-to-backend 1.2.4, lucide-react 1.66, react-router-dom 7.18.5, simple-icons 16.36, vite 8.3.5 (rolldown 1.2.16), @vitejs/plugin-react 6.2.1, tailwindcss 4.3.4, postcss 8.5.32, autoprefixer 10.6.2, marked 18.1.3, eslint 10.14, typescript-eslint 8.72.1, knip 6.44.1, @types/node 26.6.6, wrangler 4.156.2. Workflows: sonarqube-scan-action 8.4.0, zizmor-action 0.8.1. THIRD_PARTY_NOTICES regenerated.
- **i18next stays on 26.6.x** (`~26.6.0` and a Dependabot ignore for 26.7.x). 26.7, the last 26.x minor, adds the debug-mode warnings that prepare the move to v27: about 1.9 KB gzip in the i18n chunk, which would take the initial load from 279.0 to 280.9 KB — over the 280 KB budget — for code the app never runs. Both go with the i18next 27 migration.
- **The `undici` override from v1.3.1 is gone**: miniflare 5.20261102.0-beta (under wrangler, development only) depends on undici 7.30.1 itself, so alert #49 stays fixed without it.
- **Docs**: TECH-SPEC's `package.json` listing follows the real file again (its dependency versions were several releases old) and notes the i18next hold; ROADMAP, version references.
- typecheck, typecheck:all, lint, format:check, validate:locales, knip, check:version, check:tauri, check:licenses, check:copyright, **1131 tests**, build, cf:check and `cargo fmt` / `clippy` / `test` / `deny` all pass; initial load 279.0 of 280 KB gzip. Verified live: `wrangler dev` on 4.156.2 serves the gate page, `/legal/accessibility` and `robots.txt`, and refuses a verify without a token; the desktop app (`tauri dev` with a separate test identifier) answers its commands, writes, lists, reads and deletes a backup, and opens and cancels the native Save and Open dialogs on the new dialog plugin.
- Six manifests bumped 1.5.1 → 1.5.2.
## v1.5.1 — 2026-11-09
An **accessibility** release. YTDescGen already worked with the keyboard alone and with Narrator; this release adds an accessibility statement and fixes what an audit against WCAG 2.2 AA turned up — colour contrast, the language of generated text, page changes a screen reader didn't hear, a single-key shortcut that couldn't be turned off, and zoom in the desktop app. Web, desktop and Android all ship as 1.5.1.
### Added
- **[ACCESSIBILITY.md](ACCESSIBILITY.md)** — what works with a keyboard, screen readers, zoom, reduced motion and touch, how it is checked, the supported environments, known limitations, how to report a barrier (severity levels, a reply within 7 days, Critical fixes in the next patch) and a checklist for contributors. Also in Vietnamese, in the app's **Legal Center**, at `ytgenerator.stream/legal/accessibility`, and linked from the website's check page in all eight languages.
- **Accessibility barrier** issue form on GitHub (assistive technology, severity, platform), an _Accessibility_ option in feature requests, and an accessibility checklist in the pull request template.
- **Settings › Editor › Single-key shortcuts** — on by default; turning it off stops the bare `?` from opening the shortcut list (for speech input and stray key presses), and Ctrl/⌘ + / still opens it. Travels with backups.
- **Zoom in the desktop app** — Ctrl/⌘ + = and Ctrl/⌘ + − (and Ctrl + mouse wheel on Windows).
- **The page's name is read out** after you open another page; the focus stays on the link you used.
- **Alt + T** (go to the notifications) in the shortcut list.
### Changed
- **Colours reach WCAG AA (4.5:1) for text** in both themes: secondary "muted" text (hints, placeholders, counters) is lighter in the dark theme and darker in the light theme; the dark theme's accent is a little lighter; filled buttons with white text use a deeper purple and red; the light theme's success, warning, danger and donate colours are darker. A test now checks every colour token against every background.
- Generated titles, descriptions, tags, captions and playlist text are marked with the **language they were written in**, so a screen reader reads Japanese output with a Japanese voice while the interface is in English or Vietnamese — on Output, the On YouTube and Quick previews, History, Batch, Social and Playlist.
- The Legal Center's intro mentions accessibility.
### Fixed
- The notifications area and its close button were announced in English ("Notifications alt+T", "Close toast") whatever the interface language.
- The Endings table's number and name fields and the per-video From / To fields had no accessible name, and the From / To column headers were always English; the bank name typed under _Other_ had only a placeholder.
- In Windows High Contrast, text fields showed no focus outline.
- The genre chips' remove button was 20 px (now 24 px); dialog close and banner dismiss buttons grow on touch screens.
- `SECURITY.md` still listed 1.3.x as the supported version.
### Under the hood
- New tokens `accent-solid`, `accent-solid-hover`, `danger-solid`, `danger-solid-hover`; `tests/styles/contrast.test.ts` reads both palettes from `globals.css` (text tokens on surface-0 to 2, muted also on surface-3, accent on its own tint, white on the solid fills, 3:1 for marks on `accent`). It found the light theme's donate colour at 4.26:1 on the first run.
- `RouteAnnouncer` listens for `ytdescgen:page-title`, which `useDocumentTitle` fires in a microtask after the commit's effects, so pages rendered in the same commit and lazy pages are both heard and a language switch stays silent.
- `singleKeyShortcuts` is an additive setting, healed (anything but a boolean → `true`) without a store version bump, like `hideScrollbars`.
- Text controls use Tailwind's `outline-hidden` instead of `outline-none`. `zoomHotkeysEnabled` on the main window, plus `core:webview:allow-set-webview-zoom` for Tauri's macOS / Linux zoom polyfill.
- Legal Center doc `accessibility` (`consent: false`, English + Vietnamese); `GateStrings.accessibility` in the Worker; the `accessibility` label on GitHub. New keys in all eight locales and `_schema.json`.
- **Docs**: ACCESSIBILITY.md (+ Vietnamese), README, CONTRIBUTING, DEVELOPMENT (+ Vietnamese), FEATURES (accessibility section, shortcuts, settings), ARCHITECTURE, TECH-SPEC, PACKAGING, ROADMAP, CLAUDE.md, SECURITY, version references.
- typecheck, typecheck:all, lint, format:check, validate:locales, knip, check:version, check:tauri, check:licenses, check:copyright, **1131 tests** (was 1093), build, cf:check and `cargo fmt` / `clippy` / `test` all pass; initial load 279.0 of 280 KB gzip. Verified in the dev server: Settings → Output announces "Settings", then "Output", without moving the focus, and switching to Vietnamese doesn't announce; the notifications region reads "Thông báo (Alt+T)" in Vietnamese; Japanese output under a Vietnamese interface carries `lang="ja"`; with the switch off `?` does nothing and leaves the list while Ctrl + / still opens it; `/legal/accessibility` in both languages with every in-page link resolving. In the desktop app (`tauri dev`, WebView2): Ctrl + = zooms to 110 %, Ctrl + − back to 100 %.
- Six manifests bumped 1.5.0 → 1.5.1.
## v1.5.0 — 2026-11-08
A feature release for videos **upscaled in the editor**: recorded at 1440p, exported at 4K — the title says `[4K Upscaled]`, the description says what was upscaled to what and warns that fine detail may look different from the original image. Web, desktop and Android all ship as 1.5.0.
### Added
- **Upscaled from** (Video settings), next to Resolution — the resolution the footage was recorded at, when the video editor upscaled it to the video's resolution. Only lower resolutions are offered (none at 720p); lowering the resolution to or below the source sets it back to _Not upscaled_. Like resolution and FPS, it is saved with the channel profile. With it set:
- **Title** — the quality badge reads `[4K Upscaled]`, `[2K Upscaled]` (1440p), `[4K Upscaled 120FPS]`, the word in the output language (`Upscale` in Vietnamese, Portuguese and Indonesian, `アップスケール`, `업스케일`, `超分`, `Reescalado`). Badge position, case and _Show quality badge_ work as before; 1080p 60fps still has no badge, upscaled or not.
- **🖥 VIDEO SETTINGS** — a line right under the resolution, the editor taken from My Rig (left out when My Rig has none):
```
Video: 4K - 60 FPS
Upscale: 1440p → 4K (DaVinci Resolve Studio 21.2)
```
It stays when _This game has no in-game graphics settings_ is on, like the video-style line.
- **▸ 🛠 TECH NOTES** — a note of its own, after the ones you picked and bilingual like them: _Upscaled to a higher resolution in editing — fine detail is reconstructed, so text, textures and edges may look slightly different from the original image._ It isn't in the checklist, so it can't be forgotten, and it goes away with the upscale. The DLSS / FSR / XeSS note is unchanged.
- The collapsed Video settings section reads `1440p → 4K · 60 FPS`.
### Under the hood
- `src/engine/upscale.ts`: `validUpscaleSource` is the one rule the title, the description and the form share — anything other than a known resolution below the video's is ignored. `VIDEO_RESOLUTIONS`, `UPSCALED_FROM_OPTIONS` and `isUpscaledFrom` live in `src/config/graphics-settings.ts`.
- `AUTO_TECH_NOTES` (`editor_upscaled`) holds the engine's own notes: never stored in `techNotes`, their bullets share `description.techNotes.items`; the tech-note parity test checks the checklist and the bullets separately.
- Editor store v20 → v21: `upscaledFrom` back-fills to `""` and an unknown value becomes `""`; an applied profile or template and a restored backup read one the same way. `Profile.upscaledFrom` is optional, so the profile store stays at v3. New keys in all eight locales and `_schema.json`.
- **Docs**: FEATURES (upscaled video, the badge setting, the profile row), CONTENT-INVENTORY (+ Vietnamese: the automatic note), ARCHITECTURE and TECH-SPEC (`upscale.ts`, the field, store v21, test count), ROADMAP, CLAUDE.md, version references.
- typecheck, typecheck:all, lint, format:check, validate:locales, knip, check:version, check:tauri, check:licenses, check:copyright, **1093 tests** (was 1065), build all pass; initial load 277.8 of 280 KB gzip. Verified in the dev server: Elden Ring at 4K upscaled from 1440p with DaVinci Resolve Studio 21.2 in My Rig gives `Elden Ring — [4K Upscaled] — Gameplay No Commentary`, the Upscale line under `Video: 4K - 60 FPS` and the note; Vietnamese output gives `[4K Upscale]` and the `EN · VI` note; 1080p sets the field back to _Not upscaled_, 720p disables it; hidden graphics settings keep the Upscale line; the four selects sit in one column at 375 px, 2 × 2 at 1024 px and in a row at 1440 px.
- Six manifests bumped 1.4.0 → 1.5.0.
## v1.4.0 — 2026-11-06
A feature release for the description and the tags: a **LUT** field in My Rig, printed on its own line under the video editor, and the **boss's name as a tag** in boss videos — plus this week's dependency updates. Web, desktop and Android all ship as 1.4.0.
### Added
- **LUT** (My Rig) — the LUT you grade with, on its own line right under the video editor, in the description and the social captions:
```
Video Editor: DaVinci Resolve Studio 21.2
LUT: Arri Alexa LogC to Rec709
```
Typing offers 14 LUTs that come with DaVinci Resolve, named the way its LUT menu shows them (Arri Alexa LogC to Rec709, the Rec709 Kodak 2383 and Fujifilm 3513DI film looks, HDR 1000 nits to Gamma 2.4, …); any other name is printed as typed. A pasted file name or path — Explorer's _Copy as path_ included — is cut down to the LUT's name: `"C:\…\Arri\Arri Alexa LogC to Rec709.dat"` → `Arri Alexa LogC to Rec709`. Like the rest of the rig, it is saved with the channel profile. Left empty, there is no line.
- **The boss's name as a tag** — Boss Fight and Boss No Hit videos get the Boss Name field as a tag of its own, right after the game's name, so fitting the tags to 500 characters never drops it. Marks that add nothing to a search are left out: "Gael, Slave Knight" → `Gael Slave Knight`, "Mr. X" → `Mr X`, "S.T.A.L.K.E.R." → `STALKER`, "「マレニア」" → `マレニア`; apostrophes and hyphens inside a word stay ("Mergo's Wet Nurse", "T-103"), and so does a dot between digits ("Phase 2.0"). Over 30 characters (YouTube's per-tag limit here), the name before its title is used: "Loretta, Knight of the Haligtree" → `Loretta`. A boss name left in the draft after switching to another video type is not tagged.
### Fixed
- A **CPU name pasted from Windows** ("Intel(R) Core(TM) i9-9900K CPU @ 3.60GHz") is tidied in the output too, not only once you leave the field — Ctrl/⌘+Shift+C or Ctrl/⌘+S pressed with the cursor still in it copied or saved the raw name. The new LUT field works the same way.
### Under the hood
- **Dependencies**, the newest releases at least a week old (Dependabot's cooldown): i18next 26.5.11, react-i18next 17.1.9, lucide-react 1.64, zustand 5.0.16, knip 6.44, wrangler 4.152 (miniflare 5.20261019.2-beta), @tauri-apps/cli 2.12.4. Dependabot's five npm PRs (#223–#227) were folded into one change: each failed CI alone because it left THIRD_PARTY_NOTICES stale (regenerated), and they would have conflicted with each other. GitHub Actions: Swatinem/rust-cache 2.9.3, zizmor-action 0.8.0. The undici override stays — miniflare still pins undici 7.29.1.
- Dependabot alert #50 (minimatch, development tools only, through eslint and typescript-eslint) stays open for now: its fix is minimatch 11, a new matching engine outside eslint's `^10` range, and the issue needs attacker-controlled glob patterns, which lint never reads.
- `RigField` gains `clean` (CPU, LUT) and `wide`; `formatRigValue` runs a field's cleaner; a test now holds the `rig.*` and `description.rigLabels.*` keys of all eight locales to `RIG_FIELDS`. `bossNameTag` in `tag-generator.ts` uses linear regexes and no lookbehind (the macOS 11–13 desktop webview is older WebKit, which rejects one); its word fit is shared with `tagFriendlyGameName`.
- **Docs**: FEATURES (11 rig fields, the LUT, the boss name tag), ARCHITECTURE (tag priority), TECH-SPEC (rig block, tag order, test count), ROADMAP, version references.
- typecheck, typecheck:all, lint, format:check, validate:locales, knip, check:version, check:tauri, check:licenses, check:copyright, **1065 tests** (was 1017), build, cf:check all pass; initial load 277.2 of 280 KB gzip. Verified in the dev server: the LUT field sits under Video Editor across both columns with its suggestions, a quoted Explorer path becomes the LUT's name when the field loses focus, and Quick Preview prints `LUT: Arri Alexa LogC to Rec709` right after `Video Editor: DaVinci Resolve Studio 21.2`; Boss Fight with "Gael, Slave Knight" puts `Gael Slave Knight` second in the tags, Full Gameplay drops it. `wrangler dev` on 4.152 serves the gate page.
- Six manifests bumped 1.3.2 → 1.4.0.
- **The macOS app is built on the `macos-15` runner.** GitHub retired the macOS 14 image on 2026-11-02, so the tag's first desktop run lost its macOS job ("The configuration 'macos-14-arm64-us-default' is not supported"); the Windows and Linux builds were unaffected. The macOS `.app.tar.gz` comes from a manual re-run of the desktop workflow for `v1.4.0`, which builds the tag's code.
## v1.3.2 — 2026-10-27
A hosting release: the website now **rate-limits** each visitor's address, so a script hammering ytgenerator.stream gets a cheap `429 Too Many Requests` instead of the gate, the app or a Turnstile check. Nothing a person does in normal use comes near the limits. The desktop and Android apps are unchanged apart from the version number. Web, desktop and Android all ship as 1.3.2.
+32 -15
View File
@@ -9,21 +9,32 @@
- **Repository**: `github.com/poli0981/youtube-generator` · **License**: Apache-2.0 (`LICENSE`, `NOTICE`, REUSE-compliant).
- **Maintainer**: poli0981 (SkullMute). Contacts by purpose: see `src/config/about.ts` and README.
**Status: maintenance mode** (since v1.6.0). Don't propose new features. Every change must fall under the policy in [`CONTRIBUTING.md` → Maintenance mode](CONTRIBUTING.md#maintenance-mode):
- dependency updates on the regular schedule;
- security fixes (a CVE rated high or critical, a serious runtime issue);
- major language, runtime or framework upgrades;
- bug, UI/UX and accessibility fixes, and adding or removing an option in one of the app's lists (stores, platforms, genres, video types, content warnings, tech notes, GPUs, upscaler / frame-gen modes) when people really need it;
- translation fixes (wording that doesn't fit a culture or region, misleading spelling);
- Cloudflare / Worker changes the platform forces, website incidents.
`.github/workflows/maintenance-triage.yml` closes out-of-scope issues and pull requests (label `out-of-scope`); `feat(options)`, `feat(a11y)` and `feat(i18n)` pull requests stay open.
## Tech Stack
| Layer | Technology |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UI | React 19, TypeScript 7 (strict), Radix primitives (`radix-ui`), Motion (LazyMotion), cmdk, sonner, lucide-react + simple-icons |
| Build | Vite 8 (Rolldown); config imports need `.ts` extensions; Node 26 (`.node-version`) |
| Type checking | TypeScript 7 `tsc` (`@typescript/native`); `typescript` is an npm alias for `@typescript/typescript6`, the 6.0 API typescript-eslint loads |
| Styling | Tailwind CSS 4, CSS-first `@theme` tokens in `src/styles/globals.css` |
| State | Zustand 5 + `persist` (localStorage) — the only store on every platform |
| Routing | React Router 7 — `BrowserRouter` on the web, `HashRouter` in Tauri |
| i18n | i18next + react-i18next, 8 locales (en, vi, ja, es, ko, zh, pt-BR, id); `en` bundled, others lazy |
| Desktop / Android | Tauri 2 (Rust) — see `src-tauri/` |
| Web hosting | Cloudflare Workers (`worker/`, `wrangler.jsonc`), Turnstile, Web Analytics |
| Tests | Vitest (node environment; Worker tests included) |
| Quality | ESLint, Prettier, knip, coverage thresholds, bundle budget, licence allow-list, copyright years, REUSE, actionlint/zizmor, cargo fmt/clippy/deny, SonarCloud (CI-based) |
| Layer | Technology |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UI | React 19, TypeScript 7 (strict), Radix primitives (`radix-ui`), Motion (LazyMotion), cmdk, sonner, lucide-react + simple-icons |
| Build | Vite 8 (Rolldown); config imports need `.ts` extensions; Node 26 (`.node-version`) |
| Type checking | TypeScript 7 `tsc` (`@typescript/native`); `typescript` is an npm alias for `@typescript/typescript6`, the 6.0 API typescript-eslint loads |
| Styling | Tailwind CSS 4, CSS-first `@theme` tokens in `src/styles/globals.css` |
| State | Zustand 5 + `persist` (localStorage) — the only store on every platform |
| Routing | React Router 7 — `BrowserRouter` on the web, `HashRouter` in Tauri |
| i18n | i18next + react-i18next, 8 locales (en, vi, ja, es, ko, zh, pt-BR, id); `en` bundled, others lazy |
| Desktop / Android | Tauri 2 (Rust) — see `src-tauri/` |
| Web hosting | Cloudflare Workers (`worker/`, `wrangler.jsonc`), Turnstile, Web Analytics |
| Tests | Vitest (node environment; Worker tests included) |
| Quality | ESLint, Prettier, knip, coverage thresholds, bundle budget, licence allow-list, copyright years, REUSE, actionlint/zizmor, cargo fmt/clippy/deny, SonarCloud (CI-based), Qodana (JS + Rust) |
## Project Structure
@@ -40,7 +51,8 @@ src/
channel-phrase.ts # drops "on {{channel}}" when there is no channel name
types.ts # GeneratorInput, CONTENT_WARNINGS, TECH_NOTES, option lists
rig-block.ts, limits.ts, social-post-builder.ts, pinned-comment-builder.ts, playlist-builder.ts,
endings-format.ts, graphics-vendor.ts
endings-format.ts, graphics-vendor.ts, upscale.ts (upscaled in the editor: one rule for title,
description and form)
config/ # static data: video types, genres, platforms (stores),
# social fields/platforms, GPU catalog, rig fields,
# content-warning-groups / tech-note-groups (editor groups),
@@ -102,7 +114,9 @@ LICENSES/ # license texts for REUSE
### Styling
- Tailwind utilities and the design tokens (`bg-surface-1`, `text-text-muted`, `accent`, …) — no hard-coded colours, no inline styles.
- Dark by default, light via class; touch targets grow on coarse pointers.
- Dark by default, light via class; touch targets grow on coarse pointers (`pointer-coarse:`), nothing clickable under 24 px.
- Contrast is WCAG AA in both themes and `tests/styles/contrast.test.ts` checks every token: text tokens on surfaces, white text only on the `*-solid` fills (`bg-accent-solid`, `bg-danger-solid`), never on `bg-accent`.
- Focus: the global `:focus-visible` outline; a control that swaps it for a ring uses `outline-hidden` (stays visible in forced colours), not `outline-none`.
- Watch Tailwind 4 specificity: a base `inline-flex` beats a plain `hidden` — wrap responsive visibility in an element.
### i18n
@@ -178,7 +192,10 @@ npm run generate:brand # favicon, PWA icons, link-preview card from assets/
- New video type: `src/config/video-types.ts` + every `templates.json` (titles, intros, pinned-comment greetings).
- New content warning / tech note: the id in `CONTENT_WARNINGS` / `TECH_NOTES` (`src/engine/types.ts`), a group in `src/config/content-warning-groups.ts` / `tech-note-groups.ts`, the editor label (`ui.json`) and description line (`templates.json`) in all 8 locales and `_schema.json` — tests fail on any gap — and the row in `docs/CONTENT-INVENTORY.md` (+ vi). Don't repeat a fact that has its own field (language patch, game version, difficulty, the Video settings upscaler).
- New store platform: `src/config/platforms.ts` (URL pattern, `tagName`), optionally a name extractor in `src/utils/url-extractors.ts`.
- New upscaler / frame-gen option: the id in `src/config/graphics-settings.ts`, the vendor's list in `src/engine/graphics-vendor.ts`, the editor label (`editor.upscaleQuality.<vendor>` / `editor.frameGenMultiplier.<vendor>`, `ui.json`) and the description label (`description.graphics.upscale|frameGen.<vendor>`, `templates.json`) in all 8 locales and `_schema.json` — `tests/engine/graphics-vendor.test.ts` fails on a gap. A new id only widens the lists (no store bump); a new field does need one.
- UI changes follow the accessibility checklist in `ACCESSIBILITY.md` (#for-contributors): keyboard, names via `Field` / `IconButton`, announced errors, tokens only, reduced motion, 24 px targets. Generated text gets `lang` (the output language); pages name themselves with `useDocumentTitle`, which `RouteAnnouncer` reads out. Update ACCESSIBILITY.md (+ `docs/i18n/vi/`) when what it promises changes.
- Never commit `note.txt`, `warning.txt` or `__pycache__/`; never put real secrets in files (`.dev.vars` holds Cloudflare's public Turnstile test keys only).
- SonarCloud (project `poli0981_youtube-generator`) is CI-based: the `sonarcloud` job in `ci.yml` scans every PR from this repository and every push to `main`, with the coverage from `check`; settings in `sonar-project.properties`; Automatic Analysis is off. Keep it at 0 open issues and the quality gate (Sonar way: A ratings, reviewed hotspots, ≤ 3 % duplication, ≥ 80 % coverage on new code) green — the job fails with the gate. Coverage covers what `coverage.include` in `vitest.config.ts` lists (the logic layers); everything else is in `sonar.coverage.exclusions`, because a file missing from the LCOV report counts as 0 % — a new source folder goes into one list or the other. The version passed to the scanner starts each release's new-code period. Fork and Dependabot PRs skip the scan (no `SONAR_TOKEN`). Check a PR with `https://sonarcloud.io/api/issues/search?componentKeys=poli0981_youtube-generator&pullRequest=<n>&resolved=false` and its gate with `https://sonarcloud.io/api/qualitygates/project_status?projectKey=poli0981_youtube-generator&pullRequest=<n>`. Workflows install with `npm ci --ignore-scripts` and call local binaries (`npm run …`), never `npx` for a package that isn't installed.
- Qodana (`.github/workflows/qodana.yml`) runs on every PR and push to `main`: job `typescript` is Qodana for JS in native mode (`qodana.yaml`, Cloud project `yt-ts-js`, secret `QODANA_TOKEN_TS_JS`), job `rust` is Qodana for Rust, Early Access, in Docker on `src-tauri/` (`src-tauri/qodana.yaml`, project `yt-rust`, secret `QODANA_TOKEN_RUST`). Both gate on zero problems: fix a finding, or exclude it in the `qodana.yaml` with a comment saying why. Both skip without their token (Dependabot and fork PRs). It needs an Ultimate licence (currently the trial): when it lapses both jobs fail at the licence check.
- TypeScript bumps may be manual: `@typescript/native` (`npm:typescript@^7`) and `typescript` (`npm:@typescript/typescript6@^6`) are npm aliases Dependabot may not follow. Stop the dev server before `npm ci` on Windows — it locks native modules (EPERM).
- The Cloudflare dashboard, publishing releases and repository settings are the maintainer's; ask before touching them.
+45 -6
View File
@@ -6,6 +6,28 @@ Thanks for taking the time to contribute. Read this once before opening your fir
Participation is governed by the [Code of Conduct](./CODE_OF_CONDUCT.md). By contributing, you agree to its terms.
## Maintenance mode
Since 1.6.0 (November 2026) YTDescGen is in **maintenance mode**. It is feature-complete and stays maintained, but it doesn't grow new features. These changes are still accepted:
1. **Dependency updates** on a regular schedule (weekly, grouped by Dependabot after a 7-day cooldown).
2. **Security fixes**, as soon as possible: a dependency with a high or critical CVE, or a serious security issue in a runtime such as Node.js.
3. **Major upgrades** of a language, runtime or framework, for example Node 24 → 26 or TypeScript 6 → 7.
4. **Issues and pull requests** that:
- add or remove an option in one of the app's lists when people really need it — a store, a social or donate platform, a genre, a video type, a content warning or tech note, a GPU, an upscaler or frame-generation mode (open an [option request](#option-requests) first);
- fix a bug, a broken UI/UX or an accessibility barrier.
5. **Language fixes**: wording that doesn't fit a culture or region, and spelling mistakes that could mislead (see [i18n Contributions](#i18n-contributions)).
6. **Cloudflare / Worker** changes when the platform changes significantly.
7. **Website incidents** such as DDoS or bot spam.
Anything else is out of scope, new features in particular, unless the maintainer judges one genuinely necessary.
- The [maintenance triage workflow](.github/workflows/maintenance-triage.yml) closes feature issues and `feat:` pull requests from outside contributors automatically — a `feat(options)`, `feat(a11y)` or `feat(i18n)` pull request stays open. It also closes anything the maintainer labels `out-of-scope`.
- Feature ideas are welcome in [Discussions → Ideas](https://github.com/poli0981/youtube-generator/discussions/categories/ideas), with no commitment.
- If your issue or pull request was closed by mistake, reply to it and the maintainer will take another look.
Releases ship only when one of these changes needs one, for example a security fix for the desktop and Android apps. The website keeps deploying from `main`.
## Getting Started
1. Read the [Development Guide](./docs/DEVELOPMENT.md) — also available in [Vietnamese](./docs/i18n/vi/DEVELOPMENT.md).
@@ -32,18 +54,33 @@ Participation is governed by the [Code of Conduct](./CODE_OF_CONDUCT.md). By con
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.
- **Option request** — add or remove an option in one of the app's lists; see [Option requests](#option-requests).
- **Translation or wording fix** — wording that doesn't fit a culture or region, or a spelling mistake that could mislead, in any of the eight languages.
- **Accessibility barrier** — anything that gets in the way with a keyboard, a screen reader, zoom, high contrast, voice control or touch. No reproduction on the latest release needed, and you don't need to know the cause. See [ACCESSIBILITY.md](./ACCESSIBILITY.md#reporting-a-barrier).
There is no feature request form any more: YTDescGen is in [maintenance mode](#maintenance-mode). Share ideas in [Discussions → Ideas](https://github.com/poli0981/youtube-generator/discussions/categories/ideas).
### Option requests
The one kind of addition maintenance mode still takes: an option in a list the app already has, when people really need it — a store (store links), a social or donate platform, a genre, a video type, a content warning or tech note, a GPU in the rig catalog, an upscaler or frame-generation mode. Removing one that no longer makes sense works the same way.
Open an **Option request** issue first: the option's name as it should appear, which list, and who needs it and why (a link to the store page, the vendor's announcement or a video that needed it helps). Once it's agreed, a pull request titled `feat(options): …` is welcome. [ARCHITECTURE.md → Extensibility Points](./docs/ARCHITECTURE.md) and CLAUDE.md's "Important Notes" say which files each kind of option touches, and the checks fail until all eight locales have its strings.
### Pull Requests
- Branch from `main` (`feat/…`, `fix/…`, `docs/…`) and open the PR against `main`. Every merge to `main` deploys the web app, so `main` stays releasable.
- Commit format and **PR title**: `type(scope): message` — e.g. `feat(engine): add Spanish template support`. Types: `feat`, `fix`, `refactor`, `docs`, `test`, `ci`, `chore`. CI checks the PR title.
- Required checks: `check`, `dependency-review`, `workflow-lint`, `reuse`, `pr-title`. When `src-tauri/` changes, the Rust workflow's `lint-and-test` and `cargo-deny` run too, and GitHub's CodeQL code scanning runs on every PR. SonarCloud analyses PRs opened from this repository — its quality gate wants A ratings, reviewed security hotspots, at most 3 % duplication and at least 80 % test coverage on new code in the layers Vitest measures (PRs from forks get no secrets and skip it; the maintainer's merge runs it on `main`). Commits on `main` are signed.
- Required checks: `check`, `dependency-review`, `workflow-lint`, `reuse`, `pr-title`. When `src-tauri/` changes, the Rust workflow's `lint-and-test` and `cargo-deny` run too, and GitHub's CodeQL code scanning runs on every PR. SonarCloud analyses PRs opened from this repository — its quality gate wants A ratings, reviewed security hotspots, at most 3 % duplication and at least 80 % test coverage on new code in the layers Vitest measures (PRs from forks get no secrets and skip it; the maintainer's merge runs it on `main`). JetBrains Qodana does the same for TypeScript and for the Rust shell, and fails on any problem it finds. Commits on `main` are signed.
- PR titles start with a lower-case letter after the colon (`feat(editor): add …`, not `feat(editor): Add …`).
- In [maintenance mode](#maintenance-mode) a `feat` pull request from an outside contributor is closed automatically, unless its scope is `options`, `a11y` or `i18n`. A fix is a `fix`.
- 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.
### Accessibility
UI changes keep YTDescGen usable with the keyboard alone and with screen readers. Run through the checklist in [ACCESSIBILITY.md](./ACCESSIBILITY.md#for-contributors) (the PR template repeats it); the contrast test (`tests/styles/contrast.test.ts`) fails if a colour token drops under WCAG AA.
### i18n Contributions
If your change adds or removes any user-facing string:
@@ -69,15 +106,17 @@ The following are closed without review and may result in a contributor ban —
## What We Want
Within [maintenance mode](#maintenance-mode):
- Bug fixes with a reproduction case and a regression test.
- Locale corrections from native speakers.
- New content-warning or tech-note IDs with all 8 translations and a clear rationale (especially horror-genre vocabulary) — the checks fail until every locale has its label and description line.
- New video types or genres that fit the gameplay no-commentary use case.
- Accessibility and mobile-responsive improvements.
- An option people really need, agreed in an [option request](#option-requests) first — for example a content-warning or tech-note ID with all 8 translations and a clear rationale (especially horror-genre vocabulary), a store, a genre or a video type that fits the gameplay no-commentary use case.
- Accessibility and mobile-responsive fixes.
- Performance fixes with a `before/after` measurement.
## What We Don't Want
- New features, unless the maintainer judges one genuinely necessary — share the idea in [Discussions → Ideas](https://github.com/poli0981/youtube-generator/discussions/categories/ideas) instead.
- 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.
@@ -85,7 +124,7 @@ The following are closed without review and may result in a contributor ban —
## Contact
Questions about contributing or conduct: `code@poli0981.dev`. Security issues go through [SECURITY.md](./SECURITY.md), never a public issue.
Questions about contributing or conduct: `code@poli0981.dev`. Security issues go through [SECURITY.md](./SECURITY.md), never a public issue. Accessibility barriers you'd rather not post publicly: `contact@poli0981.dev`, subject starting with `[Accessibility]`.
## License
+1 -1
View File
@@ -4,7 +4,7 @@
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 (Claude Opus models; v1.0.0 through v1.3.2 with Claude Opus 5.5)**. All commits, releases, and architectural decisions are reviewed and approved by the maintainer before merging.
Code, documentation, locale translations, and design decisions in this repository were **co-authored with the assistance of Anthropic's Claude Code (Claude Opus models; v1.0.0 through v1.5.1 and v1.6.0 with Claude Opus 5.5, v1.5.2 with Claude Fable 5.2)**. All commits, releases, and architectural decisions are reviewed and approved by the maintainer before merging.
This disclosure applies to:
+10 -1
View File
@@ -1,5 +1,7 @@
# Maintainers
Since 1.6.0 the project is in **maintenance mode**: no new features, only the changes listed in [CONTRIBUTING.md → Maintenance mode](./CONTRIBUTING.md#maintenance-mode).
## Active Maintainers
### `@poli0981`
@@ -12,12 +14,19 @@
## Maintainer Responsibilities
- Triage incoming issues and PRs.
- Triage incoming issues and PRs, keeping them within the maintenance scope: the [triage workflow](./.github/workflows/maintenance-triage.yml) closes feature requests from outside contributors, and anything labelled `out-of-scope`, with an explanation.
- 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).
## Where to Reach Us
- Bug reports, translation fixes and option requests: [GitHub Issues](https://github.com/poli0981/youtube-generator/issues)
- Feature ideas, with no commitment while in maintenance mode: [Discussions → Ideas](https://github.com/poli0981/youtube-generator/discussions/categories/ideas)
- Accessibility barriers: the [Accessibility barrier](https://github.com/poli0981/youtube-generator/issues/new?template=accessibility.yml) form — see [ACCESSIBILITY.md](./ACCESSIBILITY.md)
- Vulnerabilities: privately, as [SECURITY.md](./SECURITY.md) describes
## 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 / PT-BR / ID) — open an issue describing what you'd like to take on.
+21 -3
View File
@@ -6,6 +6,10 @@
Generate YouTube titles, descriptions and tags in eight languages. Save your channel as a profile and each game as a preset, and every new video is a few clicks.
[![Status: maintenance mode](https://img.shields.io/badge/status-maintenance_mode-yellow.svg)](#project-status)
[![CI](https://github.com/poli0981/youtube-generator/actions/workflows/ci.yml/badge.svg)](https://github.com/poli0981/youtube-generator/actions/workflows/ci.yml)
[![Qodana](https://github.com/poli0981/youtube-generator/actions/workflows/qodana.yml/badge.svg)](https://github.com/poli0981/youtube-generator/actions/workflows/qodana.yml)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=poli0981_youtube-generator&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=poli0981_youtube-generator)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
[![Node](https://img.shields.io/badge/node-%E2%89%A526-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)
@@ -23,6 +27,18 @@ It doesn't talk to the YouTube API and has no account. Your work — profiles, p
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.
## Project status
**Maintenance mode** since 1.6.0 (November 2026). YTDescGen is feature-complete, and it stays maintained:
- dependency updates on a regular schedule, and fast fixes for high or critical CVEs and serious runtime security issues;
- major language, runtime and framework upgrades (for example Node 24 → 26, TypeScript 6 → 7);
- bug, UI/UX and accessibility fixes, and adding or removing an option in one of the app's lists — a store, platform, genre, video type, content warning, GPU or upscaler mode — when people really need it;
- translation fixes: wording that doesn't fit a culture or region, and spelling mistakes that could mislead;
- changes the Cloudflare or Worker platform forces, and website incidents such as DDoS or bot spam.
New features are not planned, except the rare one that is genuinely necessary. Feature issues and pull requests outside this list are closed automatically. The full policy is in [CONTRIBUTING.md](./CONTRIBUTING.md#maintenance-mode).
## Features
- **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.
@@ -39,7 +55,8 @@ Built for the gameplay no-commentary niche — especially horror / scary games
- **Command palette** (Ctrl/⌘ + K) and keyboard shortcuts.
- **Contact emails by purpose** — one contact line, or separate lines for contact, advertising, game keys & playtest and copyright / DMCA, each purpose address checked for a word that says what it is for (`sponsor@…`, `keys@…`, `dmca@…`).
- **Guardrails** — length caps on every field and an opt-in **Strict Mode** that blocks copy and export while a field has an error.
- **Dark and light themes**, larger controls on touch screens, and an option to hide every scrollbar.
- **Dark and light themes** at WCAG AA contrast, larger controls on touch screens, and an option to hide every scrollbar.
- **Accessible** — works with the keyboard alone and with screen readers (generated text is marked with its language), respects reduce motion, zooms on desktop; see [ACCESSIBILITY.md](./ACCESSIBILITY.md).
- **Desktop app** — Windows, macOS & Linux via Tauri; **Android app** — Android 11+, sideloaded from [Releases](https://github.com/poli0981/youtube-generator/releases).
## Quick Start
@@ -103,12 +120,13 @@ Architecture overview: [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
| [Architecture](./docs/ARCHITECTURE.md) | Layer model, data flow, engine design. |
| [Features](./docs/FEATURES.md) | Full feature matrix. |
| [Content Inventory](./docs/CONTENT-INVENTORY.md) | Every video type, genre, content warning and tech note the editor surfaces. _(Also: [Vietnamese](./docs/i18n/vi/CONTENT-INVENTORY.md).)_ |
| [Roadmap](./docs/ROADMAP.md) | What shipped and what's next. |
| [Roadmap](./docs/ROADMAP.md) | What shipped, and what maintenance mode still covers. |
| [Tech Spec](./docs/TECH-SPEC.md) | Implementation details and configs. |
| [i18n Guide](./docs/I18N.md) | Adding new locales. |
| [Packaging](./docs/PACKAGING.md) | Tauri desktop + Android release builds and signing. |
| [Contributing](./CONTRIBUTING.md) | PR process, commit conventions, required checks. |
| [Security](./SECURITY.md) | Reporting vulnerabilities. |
| [Accessibility](./ACCESSIBILITY.md) | What works with a keyboard, screen readers and zoom, known gaps, how to report a barrier. _(Also: [Vietnamese](./docs/i18n/vi/ACCESSIBILITY.md).)_ |
| [Privacy](./PRIVACY.md) | What is stored where, and what Cloudflare processes. |
| [Terms of Use](./TERMS.md) | Acceptable use, license compliance, DMCA. |
| [Disclaimer](./DISCLAIMER.md) | AI-assistance and translation-quality disclosure. _(Also: [Vietnamese](./docs/i18n/vi/DISCLAIMER.md).)_ |
@@ -119,7 +137,7 @@ Architecture overview: [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
## Contributing
PRs welcome — read [CONTRIBUTING.md](./CONTRIBUTING.md) first. Native-speaker corrections to the AI-translated locales (JA / ES / KO / ZH / PT-BR / ID) are especially appreciated.
YTDescGen is in [maintenance mode](#project-status): bug, accessibility and translation fixes and agreed option requests are welcome — read [CONTRIBUTING.md](./CONTRIBUTING.md) first. Native-speaker corrections to the AI-translated locales (JA / ES / KO / ZH / PT-BR / ID) are especially appreciated. Feature ideas go to [Discussions → Ideas](https://github.com/poli0981/youtube-generator/discussions/categories/ideas).
## License
+4 -2
View File
@@ -6,8 +6,10 @@ Only the latest released version of YTDescGen receives security updates, and the
| Version | Supported |
| ------- | --------- |
| 1.3.x | ✅ |
| < 1.3 | ❌ |
| 1.6.x | ✅ |
| < 1.6 | ❌ |
YTDescGen has been in [maintenance mode](./CONTRIBUTING.md#maintenance-mode) since 1.6.0. That doesn't change this policy: security fixes keep shipping, and a dependency with a high or critical CVE is fixed as soon as possible.
## Reporting a Vulnerability
+24 -24
View File
@@ -18,18 +18,18 @@ Bundled into the web app and the desktop / Android apps.
| `@tauri-apps/plugin-opener` | 2.7.2 | MIT OR Apache-2.0 | <https://github.com/tauri-apps/plugins-workspace> |
| `clsx` | 2.1.1 | MIT | <https://github.com/lukeed/clsx> |
| `cmdk` | 1.1.1 | MIT | <https://github.com/pacocoursey/cmdk> |
| `i18next` | 26.5.3 | MIT | <https://github.com/i18next/i18next> |
| `i18next-resources-to-backend` | 1.2.3 | MIT | <https://github.com/i18next/i18next-resources-to-backend> |
| `lucide-react` | 1.59.0 | ISC | <https://github.com/lucide-icons/lucide> |
| `i18next` | 26.6.0 | MIT | <https://github.com/i18next/i18next> |
| `i18next-resources-to-backend` | 1.2.4 | MIT | <https://github.com/i18next/i18next-resources-to-backend> |
| `lucide-react` | 1.70.0 | ISC | <https://github.com/lucide-icons/lucide> |
| `motion` | 13.5.1 | MIT | <https://github.com/motiondivision/motion> |
| `radix-ui` | 1.8.1 | MIT | <https://github.com/radix-ui/primitives> |
| `react` | 19.3.1 | MIT | <https://github.com/react/react> |
| `react-dom` | 19.3.1 | MIT | <https://github.com/react/react> |
| `react-i18next` | 17.1.0 | MIT | <https://github.com/i18next/react-i18next> |
| `react-router-dom` | 7.18.4 | MIT | <https://github.com/remix-run/react-router> |
| `simple-icons` | 16.35.0 | CC0-1.0 | <https://simpleicons.org> |
| `react-i18next` | 17.1.13 | MIT | <https://github.com/i18next/react-i18next> |
| `react-router-dom` | 7.18.5 | MIT | <https://github.com/remix-run/react-router> |
| `simple-icons` | 16.37.0 | CC0-1.0 | <https://simpleicons.org> |
| `sonner` | 2.0.8 | MIT | <https://github.com/emilkowalski/sonner> |
| `zustand` | 5.0.15 | MIT | <https://github.com/pmndrs/zustand> |
| `zustand` | 5.1.0 | MIT | <https://github.com/pmndrs/zustand> |
## Build and development tools
@@ -39,31 +39,31 @@ Used to build, test and check YTDescGen. Not shipped to users.
| --- | --- | --- | --- |
| `@eslint/js` | 10.0.1 | MIT | <https://github.com/eslint/eslint> |
| `@resvg/resvg-js` | 2.6.2 | MPL-2.0 | — |
| `@tailwindcss/postcss` | 4.3.3 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `@tauri-apps/cli` | 2.12.3 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `@tailwindcss/postcss` | 4.3.5 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `@tauri-apps/cli` | 2.12.4 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `@testing-library/jest-dom` | 7.0.1 | MIT | <https://github.com/testing-library/jest-dom> |
| `@testing-library/react` | 16.3.3 | MIT | <https://github.com/testing-library/react-testing-library> |
| `@types/node` | 26.6.5 | MIT | <https://github.com/DefinitelyTyped/DefinitelyTyped> |
| `@types/node` | 26.6.6 | MIT | <https://github.com/DefinitelyTyped/DefinitelyTyped> |
| `@types/react` | 19.3.0 | MIT | <https://github.com/DefinitelyTyped/DefinitelyTyped> |
| `@types/react-dom` | 19.3.0 | MIT | <https://github.com/DefinitelyTyped/DefinitelyTyped> |
| `@typescript/typescript6` | 6.0.2 | Apache-2.0 | <https://github.com/microsoft/TypeScript> |
| `@vitejs/plugin-react` | 6.1.2 | MIT | <https://github.com/vitejs/vite-plugin-react> |
| `@vitejs/plugin-react` | 6.3.0 | MIT | <https://github.com/vitejs/vite-plugin-react> |
| `@vitest/coverage-v8` | 4.1.12 | MIT | <https://github.com/vitest-dev/vitest> |
| `autoprefixer` | 10.6.1 | MIT | <https://github.com/postcss/autoprefixer> |
| `eslint` | 10.13.0 | MIT | <https://github.com/eslint/eslint> |
| `autoprefixer` | 10.6.2 | MIT | <https://github.com/postcss/autoprefixer> |
| `eslint` | 10.14.0 | MIT | <https://github.com/eslint/eslint> |
| `eslint-plugin-react-hooks` | 7.1.1 | MIT | <https://github.com/facebook/react> |
| `knip` | 6.42.1 | ISC | <https://github.com/webpro-nl/knip> |
| `marked` | 18.1.1 | MIT | <https://github.com/markedjs/marked> |
| `postcss` | 8.5.31 | MIT | <https://github.com/postcss/postcss> |
| `knip` | 6.44.2 | ISC | <https://github.com/webpro-nl/knip> |
| `marked` | 18.2.0 | MIT | <https://github.com/markedjs/marked> |
| `postcss` | 8.5.32 | MIT | <https://github.com/postcss/postcss> |
| `prettier` | 3.9.10 | MIT | <https://github.com/prettier/prettier> |
| `prettier-plugin-tailwindcss` | 0.8.1 | MIT | <https://github.com/tailwindlabs/prettier-plugin-tailwindcss> |
| `tailwindcss` | 4.3.3 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `tailwindcss` | 4.3.5 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `tsx` | 4.23.15 | MIT | <https://github.com/privatenumber/tsx> |
| `typescript` | 7.0.2 | Apache-2.0 | <https://github.com/microsoft/TypeScript> |
| `typescript-eslint` | 8.72.0 | MIT | <https://github.com/typescript-eslint/typescript-eslint> |
| `vite` | 8.3.4 | MIT | <https://github.com/vitejs/vite> |
| `typescript-eslint` | 8.72.2 | MIT | <https://github.com/typescript-eslint/typescript-eslint> |
| `vite` | 8.3.7 | MIT | <https://github.com/vitejs/vite> |
| `vitest` | 4.1.12 | MIT | <https://github.com/vitest-dev/vitest> |
| `wrangler` | 4.151.2 | MIT OR Apache-2.0 | <https://github.com/cloudflare/workers-sdk> |
| `wrangler` | 4.159.0 | MIT OR Apache-2.0 | <https://github.com/cloudflare/workers-sdk> |
## Desktop and Android shell (Rust crates)
@@ -72,11 +72,11 @@ Direct dependencies of `src-tauri/`. Transitive crates are checked in CI by `car
| Crate | Version | License | Project |
| --- | --- | --- | --- |
| `serde` | 1.0.228 | MIT OR Apache-2.0 | <https://github.com/serde-rs/serde> |
| `tauri` | 2.12.4 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-build` | 2.7.3 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-plugin-dialog` | 2.8.3 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri` | 2.12.5 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-build` | 2.7.4 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-plugin-dialog` | 2.8.4 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-opener` | 2.7.2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-single-instance` | 2.5.4 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-single-instance` | 2.5.5 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
## Fonts and icons
+5 -2
View File
@@ -211,6 +211,8 @@ const DOC_SUMMARIES: Readonly<Record<LegalDocId, string>> = {
license: "The Apache License 2.0 the source code is released under.",
"third-party": "Open-source libraries, fonts and services YTDescGen relies on.",
security: "How to report a vulnerability privately, and what is in scope.",
accessibility:
"What works with a keyboard, screen readers and zoom, known gaps, and how to report a barrier.",
notice: "The Apache-2.0 NOTICE file with copyright and attribution.",
conduct: "Contributor Covenant rules for the project's community spaces.",
};
@@ -259,6 +261,7 @@ const TITLE_BY_ID: Record<LegalDocId, string> = {
license: "License (Apache-2.0)",
"third-party": "Third-Party Notices",
security: "Security Policy",
accessibility: "Accessibility",
notice: "NOTICE",
conduct: "Code of Conduct",
};
@@ -296,10 +299,10 @@ function indexPage(): string {
return pageShell({
title: "Legal",
canonicalPath: "/legal",
description: "Terms, privacy, licensing and security information for YTDescGen.",
description: "Terms, privacy, licensing, security and accessibility information for YTDescGen.",
activeId: null,
lang: "en",
body: `<article><h1>Legal</h1><p>Terms, privacy, licensing and security information for YTDescGen — the same documents the app shows in its Legal Center.</p><div class="cards">${cards}</div></article>`,
body: `<article><h1>Legal</h1><p>Terms, privacy, licensing, security and accessibility information for YTDescGen — the same documents the app shows in its Legal Center.</p><div class="cards">${cards}</div></article>`,
});
}
+20 -17
View File
@@ -2,7 +2,7 @@
## YTDescGen — Technical Architecture
Reflects **v1.3.2**. Implementation details (configs, interfaces, file formats, CI) are in [TECH-SPEC.md](TECH-SPEC.md); desktop and Android builds in [PACKAGING.md](PACKAGING.md); running the web deployment in [HOSTING.md](HOSTING.md).
Reflects **v1.6.0**. Implementation details (configs, interfaces, file formats, CI) are in [TECH-SPEC.md](TECH-SPEC.md); desktop and Android builds in [PACKAGING.md](PACKAGING.md); running the web deployment in [HOSTING.md](HOSTING.md).
---
@@ -32,7 +32,7 @@ Reflects **v1.3.2**. Implementation details (configs, interfaces, file formats,
│ ├─ description-builder ── rig-block · timeline-parser │
│ │ channel-phrase · endings-format │
│ └─ tag-generator │
│ Also: title-variants · limits · social-post-builder │
│ Also: title-variants · limits · social-post-builder · upscale │
│ pinned-comment-builder · playlist-builder · graphics-vendor │
├────────────────────────────────────────────────────────────────────┤
│ Infrastructure Layer │
@@ -66,7 +66,7 @@ The same source ships two ways:
**Route tree.** `/legal` and `/legal/:docId` (the Legal Center) sit outside the consent guard, so the consent screen can open each document. Everything else is inside `ConsentGuard`, a layout route that renders `ConsentGate` until the user has accepted the current terms version (`CURRENT_TERMS_VERSION` = 2 since v1.0.0). Inside it, `AppShell` holds the pages: the Editor (index route) stays in the entry bundle; Output, Profiles, History, Settings, Batch, Social, Playlist, Logs and About are `React.lazy` chunks, each wrapped in its own `ErrorBoundary` + `Suspense` so a crash on one page cannot blank the app. On the web, `/legal/<id>` loaded directly is the Worker's static page; navigated to inside the app, it is the Legal Center — the same URL either way.
**App shell.** `AppShell` combines a collapsible `Sidebar`, the `Header` top bar (output and interface languages, theme), `MobileNav` (a bottom bar on phones, with a "More" drawer), and three lazily loaded pieces: the ⌘/Ctrl + K `CommandPalette` (cmdk), the shortcut help and the backup `RestoreDialog`, mounted only while a restore is pending. UI primitives in `components/ui/` wrap Radix (Dialog, AlertDialog, Popover, Tooltip, Tabs, Switch, Checkbox, ToggleGroup); animation is Motion behind `LazyMotion` (its feature bundle loads after first paint, and `MotionConfig reducedMotion="user"` honours the OS setting); toasts are sonner.
**App shell.** `AppShell` combines a collapsible `Sidebar`, the `Header` top bar (output and interface languages, theme), `MobileNav` (a bottom bar on phones, with a "More" drawer), and three lazily loaded pieces: the ⌘/Ctrl + K `CommandPalette` (cmdk), the shortcut help and the backup `RestoreDialog`, mounted only while a restore is pending. UI primitives in `components/ui/` wrap Radix (Dialog, AlertDialog, Popover, Tooltip, Tabs, Switch, Checkbox, ToggleGroup); animation is Motion behind `LazyMotion` (its feature bundle loads after first paint, and `MotionConfig reducedMotion="user"` honours the OS setting); toasts are sonner, with translated region and close labels. `RouteAnnouncer` (v1.5.1) is a polite live region that reads out the new page's name after a navigation: every page names itself with `useDocumentTitle`, which fires `ytdescgen:page-title` once the commit's effects have run, and focus stays where it was. Accessibility as a whole: [ACCESSIBILITY.md](../ACCESSIBILITY.md).
**Error pages (v0.27).** `components/errors/` holds a reusable `ErrorPage` (404/403/419/500/offline/runtime) driven by the pure `config/error-pages.ts` map. The error routes (`/403`, `/419`, `/500`, `/offline`, catch-all `*`) are **siblings of the `AppShell` route group** inside the consent guard, so they render full-screen without the shell. `ErrorPage` is router-agnostic — Home is a plain location change (`/` on the web, `#/` in Tauri) and Back is `history.back()` — so the root `ErrorBoundary`, mounted in `main.tsx` outside the router, reuses it as its crash fallback.
@@ -93,6 +93,7 @@ The engine holds all generation logic with **zero framework dependency**: no Rea
| `channel-phrase.ts` | Drops "on {{channelName}}" (per language) when the channel name is empty |
| `rig-block.ts` | The rig as localised `Label: value` lines in a fixed order (description and social captions) |
| `endings-format.ts`, `graphics-vendor.ts` | Endings lists split across videos; valid upscaler / frame-generation options per vendor |
| `upscale.ts` | Upscaled in the editor (v1.5.0): `validUpscaleSource` — the one rule the title badge, the Upscale line and the automatic tech note share |
| `limits.ts` | Over-limit status per field, Copy All rules, `<` / `>` detection |
| `social-post-builder.ts` | Captions for TikTok, YouTube Shorts, Instagram Reels, Facebook Reels, X (weighted count), Threads, Bluesky |
| `pinned-comment-builder.ts`, `playlist-builder.ts` | Pinned comment; playlist title, description and comment |
@@ -139,8 +140,8 @@ interface GeneratorInput {
// Video-type specific: partNumber, bossName, dlcName, challengeName, modName, modList,
// liveUrl, scheduledTime, gacha quest fields …
// Video settings: resolution, fps, graphicsPreset, ray tracing, frame generation,
// upscaling, artStyle, videoStyleEra, versionInfo …
// Video settings: resolution, upscaledFrom, fps, graphicsPreset, ray tracing,
// frame generation, upscaling, artStyle, videoStyleEra, versionInfo …
// Content: timestamps, playlistLink, emails, music, sponsor, publisher, content warnings,
// tech notes, playthrough notes, endings, playtest, community links …
@@ -219,14 +220,15 @@ generateTags(input, { includeMultilingualTags, includeTrendingTags, year })
priority pool source
1 game name bare tag (≤ 30 chars) + a shorter form for composites
2 core CORE_TAGS_BY_LANG[language]
3 genre GENRE_TAG_REGISTRY[genre], for every selected genre
4 video type VIDEO_TYPE_TAGS[videoType]
5 platform PLATFORMS[].tagName ("Steam", "itch.io", …)
6 quality resolution / fps
7 multilingual MULTILINGUAL_TAGS[language] (setting)
8 trending year-based, first genre only (setting)
9 publisher/developer pubDevName, as a bare tag
2 boss name bossNameTag(bossName) — Boss Fight / Boss No Hit only
3 core CORE_TAGS_BY_LANG[language]
4 genre GENRE_TAG_REGISTRY[genre], for every selected genre
5 video type VIDEO_TYPE_TAGS[videoType]
6 platform PLATFORMS[].tagName ("Steam", "itch.io", …)
7 quality resolution / fps
8 multilingual MULTILINGUAL_TAGS[language] (setting)
9 trending year-based, first genre only (setting)
10 publisher/developer pubDevName, as a bare tag
│
▼
de-duplicate (case-insensitive) · drop tags over 30 characters
@@ -256,7 +258,7 @@ export const GENRE_TAG_REGISTRY: Record<string, (gameName: string) => string[]>
```
┌────────────────────────────────────────────────────────────────────┐
│ EditorStore — "ytdescgen-editor-draft", v20 │
│ EditorStore — "ytdescgen-editor-draft", v21 │
│ - the draft: every form field (EditorData) + setter actions │
│ - persists data only (editorDataOf); migrateEditorState │
├────────────────────────────────────────────────────────────────────┤
@@ -274,7 +276,8 @@ export const GENRE_TAG_REGISTRY: Record<string, (gameName: string) => string[]>
│ - capped by the History Limit setting (10–500, default 100) │
├────────────────────────────────────────────────────────────────────┤
│ SettingsStore — "ytdescgen-settings", v12 │
│ - theme · hideScrollbars · appLanguage · titleFormat │
│ - theme · hideScrollbars · singleKeyShortcuts · appLanguage │
│ - titleFormat │
│ - description toggles · strictMode · copyAllIncludesTags · … │
│ - healSettings on every load; consent and UI state never exported │
├────────────────────────────────────────────────────────────────────┤
@@ -296,7 +299,7 @@ Every persisted store uses Zustand `persist` with `createJSONStorage(() => local
`src/config/library-fields.ts` is the one list of which editor fields each kind of library item carries — the save forms, Apply, backups and imports all read it:
- **Profile** = the channel: `PROFILE_FIELDS` (channel name, emails, social, rig, resolution / fps / graphics preset, ad text, Vietnamese donate fields, community links).
- **Profile** = the channel: `PROFILE_FIELDS` (channel name, emails, social, rig, resolution (+ upscaled from) / fps / graphics preset, ad text, Vietnamese donate fields, community links).
- **Preset** = the game: `PRESET_FIELDS` (names, genres, platform, store links and their types, publisher, content warnings, language patch, game version, art style, the skip-graphics-settings switch, playlist link).
- **Template** = the whole form (every field since v1.0.0).
- `PER_VIDEO_FIELDS` is what belongs to one video only (boss, chapter, timestamps, pinned comment, endings, …).
@@ -419,7 +422,7 @@ React app (src/), built with TAURI_ENV_PLATFORM set
- Android: universal .apk
```
**The webview never names a path.** Since v1.0.0 the Rust side exposes only name-only commands for its own files (`backup_*` and `log_*` under the app data directory, `recover_legacy_data`) and two commands that open the native Save / Open dialog themselves (`export_text_file`, `import_text_file`: text formats only, imports capped at 20 MB). The capability file grants the webview only `core:default` and `opener:default`; the fs and shell plugins are gone. The JavaScript bridge is `src/utils/native.ts`, used by `file-ops.ts` (exports and imports on every platform), `log-storage.ts` and `utils/backup/`. Details: [PACKAGING.md](PACKAGING.md).
**The webview never names a path.** Since v1.0.0 the Rust side exposes only name-only commands for its own files (`backup_*` and `log_*` under the app data directory, `recover_legacy_data`) and two commands that open the native Save / Open dialog themselves (`export_text_file`, `import_text_file`: text formats only, imports capped at 20 MB). The capability file grants the webview only `core:default`, `opener:default` and (v1.5.1, for the zoom hotkeys' macOS/Linux polyfill) `core:webview:allow-set-webview-zoom`; the fs and shell plugins are gone. The JavaScript bridge is `src/utils/native.ts`, used by `file-ops.ts` (exports and imports on every platform), `log-storage.ts` and `utils/backup/`. Details: [PACKAGING.md](PACKAGING.md).
Tauri advantages over Electron:
+3 -1
View File
@@ -1,6 +1,6 @@
# Content Inventory
A static manifest of every video type, game genre, content warning, tech note, store, link field and cross-post platform surfaced in YTDescGen's editor (as of v1.3.0). Maintained manually — when adding a new option to one of the source files below, **add a row here too** in the same PR.
A static manifest of every video type, game genre, content warning, tech note, store, link field and cross-post platform surfaced in YTDescGen's editor (as of v1.6.0). Maintained manually — when adding a new option to one of the source files below, **add a row here too** in the same PR.
This file exists for **transparency** — anyone curious about what the editor can describe (without installing the app or reading the source) can scan it in one minute.
@@ -166,6 +166,8 @@ The game itself is made or run with generative AI — a story _about_ AI is "AI
Selected notes are rendered in a `▸ 🛠 TECH NOTES` block right after the content warnings, in the order you picked them. They describe the recording, not the game. Facts that have their own field — difficulty, endings shown, language patch, game version, the upscaler and frame generation in Video settings — are not repeated here.
When **Upscaled from** is set in Video settings (v1.5.0), one more note is added on its own, after yours: _Upscaled to a higher resolution in editing — fine detail is reconstructed, so text, textures and edges may look slightly different from the original image._ It is not in the checklist below; the Upscale line in Video settings says what was upscaled to what.
### Audio (5)
Some sections muted (copyright) · Volume reduced (copyright) · Game music replaced (copyright) · Cutscene audio muted only · Original audio kept (claim risk)
+2
View File
@@ -87,6 +87,7 @@ The dev server is the app alone: no Turnstile gate and no analytics. To run the
- PR titles use the commit format `type(scope): message`; CI checks them.
- Every PR runs the `check` job (below), `dependency-review`, `workflow-lint`, `reuse` and `pr-title`; the Rust jobs `lint-and-test` and `cargo-deny` run when `src-tauri/` changes.
- After `check`, the `sonarcloud` job sends the code and the coverage report to [SonarCloud](https://sonarcloud.io/project/overview?id=poli0981_youtube-generator) (settings in `sonar-project.properties`) and fails when its quality gate does: new code needs A ratings, reviewed security hotspots, at most 3 % duplication and at least 80 % coverage. PRs from forks and from Dependabot skip it — they get no `SONAR_TOKEN` — and `main` is analysed after every merge.
- The `Qodana` workflow runs JetBrains [Qodana](https://www.jetbrains.com/qodana/) on every PR and every push to `main`: Qodana for JS on the repository (`qodana.yaml`) and Qodana for Rust on `src-tauri/` (`src-tauri/qodana.yaml`). Both fail on any problem. Like SonarCloud, it skips PRs from forks and from Dependabot, which get no Qodana token. It is not a required check.
Full rules: [CONTRIBUTING.md](../CONTRIBUTING.md).
@@ -246,3 +247,4 @@ docs/I18N.md). The restart advice above still applies to all of them.
- [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.
- [Top-level ACCESSIBILITY.md](../ACCESSIBILITY.md) — what works with assistive technology, and the checklist for UI changes.
+132 -42
View File
@@ -1,6 +1,6 @@
# Complete Feature List
## YTDescGen — All Features (v1.3.2 + Planned)
## YTDescGen — All Features (v1.6.0)
---
@@ -142,7 +142,7 @@ is now "X (Twitter)" (same `twitter` id, so saved links still load).
Bank, Cake by VPBank and Timo; a profile saved with OceanBank, CBBank or
DongA Bank is offered the new name in one click.
## 💻 Rig Fields (10 fields)
## 💻 Rig Fields (11 fields)
Printed in this order, with labels in the output language.
@@ -158,6 +158,16 @@ Printed in this order, with labels in the output language.
| `capture` | Capture Software | Text | OBS Studio 31 |
| `controller` | Controller | Text | DualSense / Xbox Wireless Controller |
| `video_editor` | Video Editor | Dropdown + version | DaVinci Resolve Studio 19.1 |
| `lut` | LUT | Text with suggestions (DaVinci Resolve's own LUTs) — v1.4.0 | Arri Alexa LogC to Rec709 |
**LUT (v1.4.0)** — the LUT you grade with, on its own line right under the
video editor. The suggestions are LUTs that come with DaVinci Resolve, named
the way its LUT menu shows them; any other name is printed as typed. A pasted
file name or path (Explorer's _Copy as path_) is cut down to the LUT's name:
`"C:\…\Arri\Arri Alexa LogC to Rec709.dat"` → `Arri Alexa LogC to Rec709`.
**Custom** (v1.6.0), the first suggestion (typing "custom" works too), is for
a LUT of your own: the line then reads just _LUT applied_ (_Có áp dụng LUT_ in
Vietnamese), without a name.
**GPU catalog (v1.0.0)** — 198 models in 29 groups: NVIDIA GeForce (desktop
and laptop), AMD Radeon (including integrated), Intel Arc and integrated,
@@ -179,11 +189,11 @@ Every block is optional and skipped when empty. In order:
6. 🎮 Store links (heading depends on paid vs. free / demo links)
7. © Game copyright line (opt-in)
8. 🧪 Playtest / early access (when a playtest link is set)
9. 🖥 Video settings (skipped for games without graphics settings)
9. 🖥 Video settings (games without graphics settings keep only the upscale and video-style lines)
10. 💻 My rig
11. 🧩 Mod list (Modded Gameplay only)
12. ⚠️ Content warnings (257 IDs across 13 groups, incl. AI-generated content — v1.2.0)
13. 🛠 Tech notes (25 IDs across 5 groups)
13. 🛠 Tech notes (25 IDs across 5 groups, plus an automatic note for an upscaled video — v1.5.0)
14. Translation-quality note (opt-in; not for English or Vietnamese)
15. 🎁 Sponsor credit (opt-in)
16. 🤝 Sponsors & partners (opt-in)
@@ -201,6 +211,48 @@ Every block is optional and skipped when empty. In order:
27. Hashtags (1–3, auto-generated)
```
**Upscaled video (v1.5.0)** — Video settings › **Upscaled from** is for
footage recorded at a lower resolution and upscaled in the video editor
(1440p → 4K, say). The title badge reads `[4K Upscaled]` (`[2K Upscaled]`,
`[4K Upscaled 120FPS]`; the word in the output language), the Video settings
block gets a line under the resolution — the editor taken from My Rig:
```
Video: 4K - 60 FPS
Upscale: 1440p → 4K (DaVinci Resolve Studio 21.2)
```
and Tech notes gets a note of its own: _Upscaled to a higher resolution in
editing — fine detail is reconstructed, so text, textures and edges may look
slightly different from the original image._ It isn't in the checklist and
goes away with the upscale. Only resolutions below the video's are offered;
lowering the resolution to or below the source ends the upscale. 1080p 60fps
still has no badge, and the Upscale line stays when the graphics settings are
hidden. Saved with the channel profile.
**Upscaler and frame generation** — Video settings › the vendor picks the
options the other fields offer, and the `In-game Setting:` line names each
one under its brand (kept in English in every language, as viewers search
for it):
| Vendor | Upscaling | Frame generation |
| ------ | --------------------------------------------------------------- | ---------------------------------------------------------------------- |
| NVIDIA | DLAA, DLSS Quality / Balanced / Performance / Ultra Performance | x2, x3, x4, **x6**, **Dynamic** (Dynamic Multi Frame Gen), **Custom…** |
| AMD | FSR Native AA, Quality / Balanced / Performance / Ultra Perf. | x2, x3 (Fluid Motion Frames), **Custom…** |
| Intel | XeSS Native AA, Ultra Quality, Quality … Ultra Performance | x2 (XeFG), **Custom…** |
New in v1.6.0 (bold): NVIDIA's x6 and Dynamic Multi Frame Generation;
**Custom…** for every vendor, which prints what you type (_NVIDIA Smooth
Motion_, _Lossless Scaling x3_); and, for NVIDIA, a **DLSS 5 Neural
Rendering** switch, printed after the DLSS mode:
```
In-game Setting: Ultra - NVIDIA DLSS Quality + NVIDIA DLSS 5 Neural Rendering + NVIDIA Dynamic Multi Frame Generation with Path Tracing
```
Changing the vendor drops what the new one doesn't offer. These settings
belong to the draft and to templates, not to the profile.
With one output language selected, the Output page shows content warnings,
tech notes and playthrough notes bilingually (English · output language)
unless the output is English; with several languages selected, each tab —
@@ -254,6 +306,7 @@ per platform).
| Pool | Triggered By | Sample Output |
| ------------ | --------------------------------- | ------------------------------------------------------------------------ |
| Game name | Always | `[game]` (shortened to fit 30 characters) |
| Boss name | Boss Fight / Boss No Hit (v1.4.0) | `[boss]` — the Boss Name field, without punctuation |
| Core | Always, in the output language | `[game] gameplay`, `[game] no commentary`, `gameplay no commentary` |
| Genre | Each selected genre | `horror game no commentary`, `RPG gameplay no commentary` |
| VideoType | Video type | `[game] boss fight`, `[game] speedrun`, `[game] all endings` |
@@ -276,6 +329,17 @@ per platform).
Game names are cleaned of characters YouTube splits tags on (`,` `;` `|`) and
of ™ / ® / ©.
**Boss name tag (v1.4.0)** — Boss Fight and Boss No Hit videos get the boss's
name as a tag of its own, right after the game's name, so fitting the list to
500 characters never drops it. Marks that add nothing to a search go: `,` `:`
`;` `!` `?` quotes, brackets, `&`, `「」` `・` `、`, ™, emoji. A dot is kept
between digits ("Phase 2.0"), dropped between initials ("S.T.A.L.K.E.R." →
`STALKER`) and a space anywhere else ("Mr. X" / "Mr.X" → `Mr X`); apostrophes
and hyphens stay inside a word ("Mergo's Wet Nurse", "T-103"). "Gael, Slave
Knight" → `Gael Slave Knight`. Over 30 characters, the name before its title is
used ("Loretta, Knight of the Haligtree" → `Loretta`), otherwise the leading
words that fit.
## ⚡ Faster Data Entry (v1.0.0)
- **Quick start** — at the top of the editor, pick a **channel profile** and
@@ -329,19 +393,39 @@ a pasted store link can each be undone from the toast they show.
- Dark and light themes; scrollbars can be hidden (v1.1.0); animated icons
follow the system's _reduce motion_; controls grow on touch screens.
### ♿ Accessibility (v1.5.1)
The statement is [ACCESSIBILITY.md](../ACCESSIBILITY.md) (also in the Legal
Center, in English and Vietnamese). In short:
- **Keyboard** — everything works without a mouse: skip link, visible focus,
dialogs that keep and return focus, the shortcuts below; the bare `?` can
be turned off (Settings › Editor › Single-key shortcuts, WCAG 2.1.4).
- **Screen readers** — named controls and labelled fields, announced
confirmations and errors, the new page's name read out after a navigation
(`RouteAnnouncer`), translated toast labels, and generated text marked with
its language (`lang`) so it is read with the right voice.
- **Vision** — both themes at WCAG AA text contrast, checked by
`tests/styles/contrast.test.ts`; white text sits on the darker
`accent-solid` / `danger-solid` fills; focus stays visible in Windows High
Contrast; desktop zoom with Ctrl/⌘ + = / − (`zoomHotkeysEnabled`).
- **Reporting** — the _Accessibility barrier_ issue form
(`.github/ISSUE_TEMPLATE/accessibility.yml`), or `contact@` with
`[Accessibility]`.
## 💾 Data Persistence
Everything stays on the device: the browser's storage for
`ytgenerator.stream` on the web, the app's own storage on desktop and
Android. There is no account and no server-side copy.
| Item | What it holds | Where |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| **Profile** — the channel | Channel name; contact emails (general, advertising, game keys, copyright); social and donate links; community links; Vietnamese bank / MoMo / ZaloPay details; rig; resolution, FPS and graphics preset; sponsors & partners text | Profiles › Profiles |
| **Game preset** — the game | Game name (+ per-language names); genres; platform; store links and their type (paid / free / demo); publisher / developer; content warnings; language patch; game version; art style; "no graphics settings"; series playlist | Profiles › Game presets |
| **Template** — the whole form | Every editor field | Profiles › Templates |
| **History** | One entry per video — game, video type, language, genres, title, description, tags. Saving the same video again updates its entry (v1.0.0) | History |
| **Draft** | The editor form, saved as you type | — |
| Item | What it holds | Where |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| **Profile** — the channel | Channel name; contact emails (general, advertising, game keys, copyright); social and donate links; community links; Vietnamese bank / MoMo / ZaloPay details; rig; resolution (and what it was upscaled from), FPS and graphics preset; sponsors & partners text | Profiles › Profiles |
| **Game preset** — the game | Game name (+ per-language names); genres; platform; store links and their type (paid / free / demo); publisher / developer; content warnings; language patch; game version; art style; "no graphics settings"; series playlist | Profiles › Game presets |
| **Template** — the whole form | Every editor field | Profiles › Templates |
| **History** | One entry per video — game, video type, language, genres, title, description, tags. Saving the same video again updates its entry (v1.0.0) | History |
| **Draft** | The editor form, saved as you type | — |
The field lists live in `src/config/library-fields.ts`. Profiles, presets and
templates export and import as JSON; History exports as **CSV** or JSON.
@@ -371,39 +455,42 @@ In **Settings › Backup & restore**:
`Ctrl` on Windows / Linux / Android, `⌘` on a Mac — both work everywhere.
| Shortcut | Action |
| ---------------------------- | --------------------------------------------------------------- |
| `Ctrl/⌘+K` | Command palette |
| `Ctrl/⌘+Enter` or `Ctrl/⌘+G` | Generate (switch to Output) |
| `Ctrl/⌘+Shift+C` | Copy All — same limits and Strict Mode rules as the Output page |
| `Ctrl/⌘+S` | Save the current output to History |
| `Ctrl/⌘+B` | Collapse / expand the sidebar |
| `Ctrl/⌘+/` or `?` | Show keyboard shortcuts (`?` only outside text fields) |
| `Escape` | Close modal |
| Shortcut | Action |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `Ctrl/⌘+K` | Command palette |
| `Ctrl/⌘+Enter` or `Ctrl/⌘+G` | Generate (switch to Output) |
| `Ctrl/⌘+Shift+C` | Copy All — same limits and Strict Mode rules as the Output page |
| `Ctrl/⌘+S` | Save the current output to History |
| `Ctrl/⌘+B` | Collapse / expand the sidebar |
| `Alt+T` | Go to the notifications (while any are on screen) |
| `Ctrl/⌘+/` or `?` | Show keyboard shortcuts (`?` only outside text fields, while Settings › Editor › Single-key shortcuts is on) |
| `Ctrl/⌘+=` / `Ctrl/⌘+−` | Zoom in / out — desktop app (v1.5.1) |
| `Escape` | Close modal |
## 🔧 Settings
| Setting | Type | Default | Description |
| -------------------------- | ------------------------------- | ---------------- | ---------------------------------------------------------------------------------- |
| Theme | dark / light | dark | App color theme |
| Hide scrollbars | boolean | false | v1.1.0. No scrollbar anywhere in the app; wheel, touch and keyboard still scroll |
| App Language | SupportedLanguage | browser-detected | Language of the interface |
| Default Output Language | SupportedLanguage | browser-detected | Language a new draft starts in (first run, Start over) |
| Show Character Count | boolean | true | Display char counters on output. **Does not** affect copy blocking |
| Compact Tag Display | boolean | false | Tags as comma list vs chip display |
| Copy All includes the tags | boolean | false | v1.0.0. Copy All copies title, description, then tags |
| **Strict Mode** | boolean | **false** | v0.35.0. Blocks Generate / Copy / Export while any field has a hard error |
| Show quality badge | boolean | true | `[2K 60FPS]`-style badge in the title when resolution or FPS is above the defaults |
| Title order | game first / video first | game first | v1.0.0. "Hades — Part 3" or "Part 3 — Hades" |
| Quality badge position | prefix / middle / suffix | middle | Where the badge sits in the title |
| Segment separator | em dash / hyphen / colon / pipe | em dash | Characters come from each locale |
| Badge case | upper / lower | upper | "2K" or "2k" |
| Include Multilingual Tags | boolean | true | Add tags in the output language |
| Include Trending Tags | boolean | true | Add year-based trending tags |
| Hashtag Count | 1-3 | 3 | Number of hashtags to generate |
| Genre Playlists | map | `{}` | One playlist URL per genre (42), collapsed by default |
| History Limit | 10–500 | 100 | Max history entries to keep |
| Log Retention | 1–90 days | 7 | Log files older than this are deleted at boot |
| Setting | Type | Default | Description |
| -------------------------- | ------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Theme | dark / light | dark | App color theme |
| Hide scrollbars | boolean | false | v1.1.0. No scrollbar anywhere in the app; wheel, touch and keyboard still scroll |
| App Language | SupportedLanguage | browser-detected | Language of the interface |
| Default Output Language | SupportedLanguage | browser-detected | Language a new draft starts in (first run, Start over) |
| Show Character Count | boolean | true | Display char counters on output. **Does not** affect copy blocking |
| Compact Tag Display | boolean | false | Tags as comma list vs chip display |
| Copy All includes the tags | boolean | false | v1.0.0. Copy All copies title, description, then tags |
| Single-key shortcuts | boolean | true | v1.5.1. `?` opens the shortcut list outside text fields; off leaves Ctrl/⌘ + / only (speech input, stray key presses) |
| **Strict Mode** | boolean | **false** | v0.35.0. Blocks Generate / Copy / Export while any field has a hard error |
| Show quality badge | boolean | true | `[2K 60FPS]`-style badge in the title when resolution or FPS is above the defaults; `[4K Upscaled]` for an upscaled video (v1.5.0) |
| Title order | game first / video first | game first | v1.0.0. "Hades — Part 3" or "Part 3 — Hades" |
| Quality badge position | prefix / middle / suffix | middle | Where the badge sits in the title |
| Segment separator | em dash / hyphen / colon / pipe | em dash | Characters come from each locale |
| Badge case | upper / lower | upper | "2K" or "2k" |
| Include Multilingual Tags | boolean | true | Add tags in the output language |
| Include Trending Tags | boolean | true | Add year-based trending tags |
| Hashtag Count | 1-3 | 3 | Number of hashtags to generate |
| Genre Playlists | map | `{}` | One playlist URL per genre (42), collapsed by default |
| History Limit | 10–500 | 100 | Max history entries to keep |
| Log Retention | 1–90 days | 7 | Log files older than this are deleted at boot |
"Browser-detected" means the browser's language when it is one of the eight,
otherwise English. `Default Genre` and `Auto-save Draft` were removed in
@@ -512,7 +599,10 @@ documents and ticks one "I agree" checkbox.
## 🔌 Future Extension Points
See [ROADMAP.md](./ROADMAP.md) for the post-1.0 backlog.
**Frozen: YTDescGen is in maintenance mode** (since v1.6.0) and takes no new
features — see [CONTRIBUTING.md → Maintenance mode](../CONTRIBUTING.md#maintenance-mode).
The ideas below and the [ROADMAP.md](./ROADMAP.md) backlog stay as a record; one
moves only if the maintainer judges it genuinely necessary.
| Extension | Description | Effort |
| -------------------- | ----------------------------------------------------------- | ------ |
+10 -7
View File
@@ -2,7 +2,7 @@
## YTDescGen — Tauri 2 Desktop and Android Apps
Reflects **v1.3.2**: Windows, macOS (Apple silicon) and Linux desktop apps plus an Android APK, all built from the same Tauri 2 project in `src-tauri/`. The web app is deployed separately — see [HOSTING.md](HOSTING.md).
Reflects **v1.6.0**: Windows, macOS (Apple silicon) and Linux desktop apps plus an Android APK, all built from the same Tauri 2 project in `src-tauri/`. The web app is deployed separately — see [HOSTING.md](HOSTING.md).
---
@@ -62,7 +62,7 @@ The icons come from the one brand logo: `npx tauri icon assets/brand/logo.svg` r
{
"$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-cli/schema.json",
"productName": "YTDescGen",
"version": "1.3.2",
"version": "1.6.0",
"identifier": "com.skullmute.ytdescgen",
"build": {
"beforeBuildCommand": "npm run build",
@@ -81,7 +81,8 @@ The icons come from the one brand logo: `npx tauri icon assets/brand/logo.svg` r
"resizable": true,
"maximizable": true,
"fullscreen": false,
"center": true
"center": true,
"zoomHotkeysEnabled": true
}
],
"security": {
@@ -138,12 +139,14 @@ Notes:
```json
{
"identifier": "default",
"description": "Default capabilities for YTDescGen. File access goes through the app's own name-only commands and native dialogs run from Rust, so the webview gets no dialog, fs or shell permissions.",
"description": "Default capabilities for YTDescGen. File access goes through the app's own name-only commands and native dialogs run from Rust, so the webview gets no dialog, fs or shell permissions. set-webview-zoom backs the Ctrl/Cmd +/- zoom polyfill Tauri injects on macOS and Linux (zoomHotkeysEnabled).",
"windows": ["main"],
"permissions": ["core:default", "opener:default"]
"permissions": ["core:default", "core:webview:allow-set-webview-zoom", "opener:default"]
}
```
`zoomHotkeysEnabled` (v1.5.1) lets the desktop app zoom with Ctrl/⌘ + = and Ctrl/⌘ + − (WebView2's own zoom control on Windows, which also takes Ctrl + mouse wheel; a polyfill on macOS and Linux that calls `set_webview_zoom`, hence the permission). Android has no zoom hotkeys; pinch zoom works there.
The webview can call Tauri's core APIs, the opener plugin (external links open in the system browser, mail client or dialler) and the app's own commands — nothing else. v1.0.0 removed the `fs` and `shell` plugins and their permissions. `tauri-plugin-dialog` is still a dependency, but only Rust uses it: the webview has no dialog permission and no dialog JavaScript package. (`tauri-plugin-fs` still appears in `Cargo.lock` as a dependency of the dialog plugin; the app does not register it.)
### 3. Rust Backend (src-tauri/src)
@@ -332,7 +335,7 @@ The desktop build is a three-platform matrix; `tauri-apps/tauri-action` builds e
| Runner | Target | Output |
| ---------------- | -------------------------- | --------------------------- |
| `windows-latest` | `x86_64-pc-windows-msvc` | `.msi`, `.exe` (NSIS) |
| `macos-14` | `aarch64-apple-darwin` | `.app.tar.gz` |
| `macos-15` | `aarch64-apple-darwin` | `.app.tar.gz` |
| `ubuntu-latest` | `x86_64-unknown-linux-gnu` | `.AppImage`, `.deb`, `.rpm` |
Linux runners install `libwebkit2gtk-4.1-dev`, `libgtk-3-dev`, `libayatana-appindicator3-dev`, `librsvg2-dev` and `patchelf` before building — Tauri's webview and AppImage tooling need them. AppImage bundling runs with `APPIMAGE_EXTRACT_AND_RUN=1` (linuxdeploy needs FUSE, which hosted runners don't reliably provide) and `NO_STRIP=true`.
@@ -342,7 +345,7 @@ Linux runners install `libwebkit2gtk-4.1-dev`, `libgtk-3-dev`, `libayatana-appin
**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.
- **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-15 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. (The Android APK is signed — see below.)
+101 -13
View File
@@ -2,10 +2,12 @@
## YTDescGen — Phased Development Plan
> **Status (2026-10-27): v1.3.2 is the current release.** Phases 1–4 are the original
> plan, kept as a record; notes added beside or under an item say what has
> changed since. Every release is listed in [CHANGELOG.md](../CHANGELOG.md).
> What's next: Phase 5 and the backlog at the end of this page.
> **Status (2026-11-17): maintenance mode, from v1.6.0.** YTDescGen is
> feature-complete: it stays maintained but takes no new features — see
> [Maintenance mode](#maintenance-mode--from-v160) below. Phases 1–4 are the
> original plan, kept as a record; notes added beside or under an item say
> what has changed since. Every release is listed in
> [CHANGELOG.md](../CHANGELOG.md). Phase 5 and the backlog are frozen.
---
@@ -343,10 +345,95 @@ Worker (Workers Rate Limiting bindings), behind a WAF rate limiting rule at
the zone —
[CHANGELOG.md](../CHANGELOG.md#v132--2026-10-27).
## v1.4.0 — LUT field, boss name tag ✅ SHIPPED 2026-11-06
A **LUT** field in My Rig, printed on its own line under the video editor
(DaVinci Resolve's own LUTs offered while typing), the **boss's name as a
tag** in Boss Fight and Boss No Hit videos, and this week's dependency
updates — [CHANGELOG.md](../CHANGELOG.md#v140--2026-11-06).
## v1.5.0 — Upscaled video ✅ SHIPPED 2026-11-08
**Upscaled from** in Video settings, for footage upscaled in the video
editor: a `[4K Upscaled]` title badge, an `Upscale: 1440p → 4K (…)` line in
Video settings and an automatic tech note that fine detail may differ from
the original image — [CHANGELOG.md](../CHANGELOG.md#v150--2026-11-08).
## v1.5.1 — Accessibility ✅ SHIPPED 2026-11-09
An accessibility statement ([ACCESSIBILITY.md](../ACCESSIBILITY.md), also in
the Legal Center) and the fixes an audit against WCAG 2.2 AA turned up: AA
contrast in both themes, generated text marked with its language, the page's
name read out after a navigation, a switch for the single-key `?` shortcut,
and zoom hotkeys in the desktop app —
[CHANGELOG.md](../CHANGELOG.md#v151--2026-11-09).
## v1.5.2 — Maintenance ✅ SHIPPED 2026-11-10
Tauri 2.12.5 with the fixes its window, webview and single-instance layers
collected, and this week's dependency updates; i18next stays on 26.6 to keep
the initial load inside its budget —
[CHANGELOG.md](../CHANGELOG.md#v152--2026-11-10).
## v1.6.0 — Maintenance mode begins ✅ SHIPPED 2026-11-17
The last feature release: DLSS 5 Neural Rendering, NVIDIA's x6 and Dynamic
Multi Frame Generation and a Custom frame generation for every vendor in
Video settings, and a Custom LUT that prints just "LUT applied". JetBrains
Qodana joins SonarCloud, and the project enters
[maintenance mode](#maintenance-mode--from-v160) —
[CHANGELOG.md](../CHANGELOG.md#v160--2026-11-17).
---
## Maintenance mode — from v1.6.0
**Status**: ongoing since v1.6.0 (November 2026).
YTDescGen is feature-complete. From 1.6.0 on it is maintained, not extended:
no new features unless one is judged genuinely necessary. The accepted
changes, and how out-of-scope issues and pull requests are closed, are in
[CONTRIBUTING.md → Maintenance mode](../CONTRIBUTING.md#maintenance-mode):
1. Dependency updates on a regular schedule.
2. Security fixes: a dependency with a high or critical CVE, a serious runtime
issue.
3. Major language, runtime and framework upgrades (Node 24 → 26, TypeScript
6 → 7).
4. Bug, UI/UX and accessibility fixes, and adding or removing an option in one
of the app's lists when people really need it.
5. Translation fixes: wording that doesn't fit a culture or region, misleading
spelling mistakes.
6. Cloudflare / Worker changes the platform forces.
7. Website incidents such as DDoS or bot spam.
What 1.6.0 set up for it:
- [x] **Policy**: README → Project status, CONTRIBUTING → Maintenance mode,
SECURITY, MAINTAINERS, CLAUDE.md.
- [x] **Issue forms**: the feature request form is gone; an Option request
and a Translation or wording fix form joined Bug report and
Accessibility barrier; a Scope checklist in the pull request template.
- [x] **Auto-close**: `maintenance-triage.yml` closes, with a bilingual
comment and the `out-of-scope` label, feature issues and `feat:` pull
requests from outside contributors (`feat(options)`, `feat(a11y)` and
`feat(i18n)` stay open), and anything the maintainer labels
`out-of-scope`.
- [x] **Qodana**: Qodana for JS and Qodana for Rust (Early Access) on every
push and pull request, reported to Qodana Cloud, with a gate of zero
problems.
Known maintenance already queued: the GitHub Pages moving notice comes down
on 2026-11-29 (issue #177); i18next 27 and Tauri 3 arrive as planned major
upgrades when they are ready.
---
## Phase 5 — Extensions & Ecosystem (Priority: P2-P3)
**Frozen while YTDescGen is in maintenance mode.** An item moves only if it
falls under the [maintenance policy](../CONTRIBUTING.md#maintenance-mode).
**Goal**: IDE extension, CLI, community features.
**Estimated**: Ongoing
@@ -393,7 +480,8 @@ the zone —
## Backlog (after v1.0.0)
Ideas carried over from the v1.0.0 planning — not scheduled.
Ideas carried over from the v1.0.0 planning — not scheduled, and frozen while
YTDescGen is in maintenance mode.
```
- [ ] Auto-fill game info from Steam through the Worker — needs rate limiting
@@ -411,13 +499,13 @@ Ideas carried over from the v1.0.0 planning — not scheduled.
## Timeline Summary
| Phase | Scope | Days | Cumulative |
| ------- | ------------------ | ------- | ---------- |
| Phase 1 | MVP Core | 3-4 | 3-4 days |
| Phase 2 | Profiles & Presets | 2-3 | 5-7 days |
| Phase 3 | Polish & Advanced | 2-3 | 7-10 days |
| Phase 4 | Desktop App | 2-3 | 9-13 days |
| Phase 5 | Extensions | Ongoing | — |
| Phase | Scope | Days | Cumulative |
| ------- | ------------------ | ------ | ---------- |
| Phase 1 | MVP Core | 3-4 | 3-4 days |
| Phase 2 | Profiles & Presets | 2-3 | 5-7 days |
| Phase 3 | Polish & Advanced | 2-3 | 7-10 days |
| Phase 4 | Desktop App | 2-3 | 9-13 days |
| Phase 5 | Extensions | Frozen | — |
**MVP usable after Phase 1** (~3-4 days). Full-featured after Phase 3 (~7-10 days).
**v1.0.0 shipped on 2026-09-30; the current release is v1.3.2 (2026-10-27).**
**v1.0.0 shipped on 2026-09-30; the current release is v1.6.0 (2026-11-17), the first in maintenance mode.**
+43 -33
View File
@@ -2,7 +2,7 @@
## YTDescGen — Implementation Details
Reflects **v1.3.2**. The module map and data flow are in [ARCHITECTURE.md](ARCHITECTURE.md), the desktop and Android builds in [PACKAGING.md](PACKAGING.md), and running the web deployment (Cloudflare Worker, Turnstile, secrets, rollback) in [HOSTING.md](HOSTING.md).
Reflects **v1.6.0**. The module map and data flow are in [ARCHITECTURE.md](ARCHITECTURE.md), the desktop and Android builds in [PACKAGING.md](PACKAGING.md), and running the web deployment (Cloudflare Worker, Turnstile, secrets, rollback) in [HOSTING.md](HOSTING.md).
---
@@ -13,7 +13,7 @@ Reflects **v1.3.2**. The module map and data flow are in [ARCHITECTURE.md](ARCHI
```json
{
"name": "yt-desc-gen",
"version": "1.3.2",
"version": "1.6.0",
"private": true,
"license": "Apache-2.0",
"type": "module",
@@ -57,47 +57,47 @@ Reflects **v1.3.2**. The module map and data flow are in [ARCHITECTURE.md](ARCHI
"@tauri-apps/plugin-opener": "^2.7.2",
"clsx": "^2.1.1",
"cmdk": "^1.1.1",
"i18next": "^26.4.5",
"i18next-resources-to-backend": "^1.2.3",
"lucide-react": "^1.57.0",
"i18next": "~26.6.0",
"i18next-resources-to-backend": "^1.2.4",
"lucide-react": "^1.66.0",
"motion": "^13.5.1",
"radix-ui": "^1.8.1",
"react": "^19.3.0",
"react-dom": "^19.3.0",
"react-i18next": "^17.0.16",
"react-router-dom": "^7.18.4",
"simple-icons": "^16.33.0",
"react": "^19.3.1",
"react-dom": "^19.3.1",
"react-i18next": "^17.1.11",
"react-router-dom": "^7.18.5",
"simple-icons": "^16.36.0",
"sonner": "^2.0.8",
"zustand": "^5.0.15"
"zustand": "^5.0.16"
},
"devDependencies": {
"@eslint/js": "^10.0.1",
"@resvg/resvg-js": "2.6.2",
"@tailwindcss/postcss": "^4.3.3",
"@tauri-apps/cli": "2.12.3",
"@tailwindcss/postcss": "^4.3.4",
"@tauri-apps/cli": "2.12.4",
"@testing-library/jest-dom": "^7.0.1",
"@testing-library/react": "^16.3.3",
"@types/node": "^26.6.3",
"@types/node": "^26.6.6",
"@types/react": "^19.3.0",
"@types/react-dom": "^19.3.0",
"@typescript/native": "npm:typescript@^7.0.2",
"@vitejs/plugin-react": "^6.1.2",
"@vitejs/plugin-react": "^6.2.1",
"@vitest/coverage-v8": "^4.1.12",
"autoprefixer": "^10.6.1",
"eslint": "^10.12.0",
"autoprefixer": "^10.6.2",
"eslint": "^10.14.0",
"eslint-plugin-react-hooks": "^7.1.1",
"knip": "^6.41.0",
"marked": "18.1.1",
"postcss": "^8.5.30",
"knip": "^6.44.1",
"marked": "18.1.3",
"postcss": "^8.5.32",
"prettier": "^3.9.10",
"prettier-plugin-tailwindcss": "^0.8.1",
"tailwindcss": "^4.3.3",
"tsx": "^4.23.15",
"typescript": "npm:@typescript/typescript6@^6.0.2",
"typescript-eslint": "^8.71.2",
"vite": "^8.3.4",
"typescript-eslint": "^8.72.1",
"vite": "^8.3.5",
"vitest": "^4.1.12",
"wrangler": "4.149.0"
"wrangler": "4.156.2"
}
}
```
@@ -107,6 +107,7 @@ Notes:
- **UI stack**: React 19, React Router 7, Zustand 5, i18next 26 / react-i18next 17, Radix primitives through the single `radix-ui` package (Dialog, AlertDialog, Popover, Tooltip, Tabs, Switch, Checkbox, ToggleGroup, Slot), Motion (loaded through `LazyMotion`), cmdk for the command palette, sonner for toasts (react-hot-toast is gone), lucide-react 1.x for UI icons and simple-icons (CC0-1.0) for the brand marks lucide 1.x dropped.
- **Tauri on the JavaScript side** is only `@tauri-apps/api` (for `invoke`) and `@tauri-apps/plugin-opener`. There are no dialog, fs or shell plugin packages: file access goes through the app's own Rust commands (see [PACKAGING.md](PACKAGING.md)). `@tauri-apps/cli` is pinned exactly, and `npm run check:tauri` keeps the npm packages on the same major.minor as the crates.
- **Build-time only**: `marked` renders the legal documents and `@resvg/resvg-js` rasterises the brand assets; neither ships in the app. `wrangler` is pinned exactly for `cf:dev` / `cf:check`.
- **i18next stays on 26.6.x** (`~26.6.0`, and a Dependabot ignore for 26.7.x): 26.7 adds the debug-mode warnings for the move to v27 — about 1.9 KB gzip that would take the initial load over its 280 KB budget. The tilde and the ignore go with the i18next 27 migration (`.github/dependabot.yml` has the note).
- **Fonts** are self-hosted: `@fontsource-variable/inter` and `@fontsource-variable/jetbrains-mono` are imported in `src/main.tsx`, and each subset (latin, latin-ext, vietnamese, …) is fetched only when a page uses it.
- **TypeScript 7** checks types: `@typescript/native` is an npm alias for `typescript@7`, the native compiler, and supplies `tsc`. TypeScript 7.0 ships no JavaScript API, so `typescript` is an alias for `@typescript/typescript6` — the TypeScript 6.0 API that typescript-eslint loads (its peer range stops below 6.1), plus `tsc6`. Both are Microsoft's documented side-by-side setup. `@typescript/typescript6` pulls TypeScript 6 in as `@typescript/old`, which ships a `tsc` too; CI fails if the `tsc` on `PATH` is not 7.x. Dependabot may not follow `npm:` aliases, so TypeScript bumps can be manual.
- **Node 26** comes from `.node-version`, which CI, the release workflows and Cloudflare Workers Builds all read; `engines.node` says `>=26`. Vitest runs its workers with `--no-experimental-webstorage`: Node 25+ defines a `localStorage` global that is `undefined` without `--localstorage-file`, and zustand's `persist` crashes on it instead of falling back to memory.
@@ -345,9 +346,10 @@ export interface GeneratorInput {
// Video-type specific: partNumber, bossName, dlcName, challengeName, modName, modList,
// liveUrl, scheduledTime, gachaQuestType, chapterName, questName, characterName,
// anniversaryYear, gachaVersion.
// Video settings: resolution, fps, graphicsPreset (+ graphicsPresetCustom),
// skipGraphicsSettings, rayTracingModes, frameGenVendor, frameGenMultiplier,
// upscaleQuality, artStyle, videoStyleEra, versionInfo.
// Video settings: resolution, upscaledFrom (v1.5.0), fps, graphicsPreset (+ graphicsPresetCustom),
// skipGraphicsSettings, rayTracingModes, frameGenVendor, frameGenMultiplier
// (+ frameGenCustom, v1.6.0), upscaleQuality, dlssNeuralRendering (v1.6.0),
// artStyle, videoStyleEra, versionInfo.
// Content: timestamps, playlistLink, contactEmail, adEmail, gameKeyEmail,
// copyrightEmail, musicAttribution, sponsorName, sponsorPlatform, pubDevName,
// thirdPartyAdText,
@@ -414,12 +416,12 @@ export interface TitleFormatConfig {
**Tag length, counted the way YouTube counts it** (`tag-generator.ts`):
- `youtubeTagsLength(tags)` = the sum of each tag's length, plus 2 for the quotes YouTube puts around any tag containing whitespace, plus one comma between tags. The old measure (length of the `", "`-joined string) ignored the quotes; 15 of 51 real tag sets were over 500 by YouTube's count while showing as under.
- `generateTags` collects, in priority order: the game name (bare, and a shortened form for composites), core tags for the output language, genre tags for every selected genre, video-type tags, platform tags, quality tags, the output language's multilingual tags (setting), trending tags for the first genre (setting), and the publisher/developer name. It then de-duplicates case-insensitively, drops tags over 30 characters, and `trimToCharLimit(tags, 500)` keeps tags in priority order while they fit — a tag that doesn't fit is skipped and the shorter ones after it are still tried.
- `generateTags` collects, in priority order: the game name (bare, and a shortened form for composites), the boss name for the video types whose `extraFields` include `bossName` (v1.4.0 — `bossNameTag`: NFC, every mark but in-word `'` `’` `-` and digit-to-digit `.` removed, dots between initials dropped, the name before its title or the leading words when over 30 characters), core tags for the output language, genre tags for every selected genre, video-type tags, platform tags, quality tags, the output language's multilingual tags (setting), trending tags for the first genre (setting), and the publisher/developer name. It then de-duplicates case-insensitively, drops tags over 30 characters, and `trimToCharLimit(tags, 500)` keeps tags in priority order while they fit — a tag that doesn't fit is skipped and the shorter ones after it are still tried.
- Platform tags use `PlatformConfig.tagName` ("Steam", "Epic Games", "itch.io"), not the id; the publisher's own site has no tag name and adds no platform tags.
**Empty channel name** (`channel-phrase.ts`, used by the description, pinned comment and playlist builders): templates render with `CHANNEL_SLOT` (`@@CHANNEL@@`) in place of an empty channel name. `withoutEmptyChannel(text, language)` then removes the words that go with the channel name in that language ("trên kênh", "による", "en", "no", "di", …) and the English "on" (for English, and for locales that still carry English sentences for newer video types), replaces any slot left over with a neutral fallback ("this channel", "kênh", …) and tidies the spacing before punctuation. "…of Hades on ." no longer happens in any of the eight languages.
**Rig block** (`rig-block.ts`): `buildRigLines(rig, t)` returns `Label: value` lines, shared by the description and the social captions. Labels come from `description.rigLabels.<field>` in the output language, the order is `RIG_FIELDS` (CPU, GPU, RAM, motherboard, storage, OS, monitor, capture, controller, video editor), and values go through `formatRigValue` (`gpu:nvidia-rtx-5080` → "NVIDIA GeForce RTX 5080"). Keys that are no longer rig fields are still printed, after the known ones.
**Rig block** (`rig-block.ts`): `buildRigLines(rig, t)` returns `Label: value` lines, shared by the description and the social captions. Labels come from `description.rigLabels.<field>` in the output language, the order is `RIG_FIELDS` (CPU, GPU, RAM, motherboard, storage, OS, monitor, capture, controller, video editor, LUT), and values go through `formatRigValue` (`gpu:nvidia-rtx-5080` → "NVIDIA GeForce RTX 5080"; a text field's `clean` — `cleanCpuName`, and since v1.4.0 `cleanLutName`, which cuts a pasted path or `.cube` / `.dat` file name down to the LUT's name — runs there as well as when the editor field loses focus). A field with a `customNoteKey` whose value is "Custom" (any case) prints that templates key as its whole line instead — since v1.6.0 the LUT's "LUT applied" (`description.rigNotes.lut_custom`), for a LUT of one's own. Keys that are no longer rig fields are still printed, after the known ones.
**Chapters** (`timeline-parser.ts`):
@@ -473,7 +475,7 @@ interface EditorActions {
}
/** Bump together with a new step in migrateEditorState. */
export const EDITOR_STORE_VERSION = 20;
export const EDITOR_STORE_VERSION = 22;
export const useEditorStore = create<EditorData & EditorActions>()(
persist(
@@ -507,7 +509,7 @@ export function migrateEditorState(persistedState: unknown, version: number): Ed
| Store | localStorage key | Version | Migration (exported) |
| ------------------ | ------------------------ | ----------------------------- | ---------------------------------------------------------------------------------------------- |
| `useEditorStore` | `ytdescgen-editor-draft` | `EDITOR_STORE_VERSION` = 20 | `migrateEditorState` |
| `useEditorStore` | `ytdescgen-editor-draft` | `EDITOR_STORE_VERSION` = 22 | `migrateEditorState` |
| `useProfileStore` | `ytdescgen-profiles` | `PROFILE_STORE_VERSION` = 3 | `migrateProfilesState` |
| `usePresetStore` | `ytdescgen-presets` | `PRESET_STORE_VERSION` = 2 | `migratePresetsState` |
| `useTemplateStore` | `ytdescgen-templates` | `TEMPLATE_STORE_VERSION` = 2 | `migrateTemplatesState` |
@@ -520,6 +522,12 @@ v1.1.0: editor v20 back-fills `copyrightEmail` (the fourth split contact line) w
v1.2.0: nine content-warning ids and one tech note, and no version bump anywhere — the lists only widen. The backup whitelist (`choiceList` in `src/utils/backup/sanitize.ts`) checks against `CONTENT_WARNINGS` / `TECH_NOTES`, so a 1.1.0 build restoring a 1.2.0 backup keeps everything except the ids it doesn't know.
v1.5.0: editor v21 back-fills `upscaledFrom` (recorded at a lower resolution, upscaled to `resolution` in the video editor) with `""` and turns an unknown value into `""`; `normalizeEditorPatch` does the same for an applied profile or template, and the backup whitelist checks it against `UPSCALED_FROM_OPTIONS`. `Profile.upscaledFrom` is optional, so the profile store stays at v3. The engine's own tech note (`AUTO_TECH_NOTES`, `editor_upscaled`) is never stored, so `techNotes` and its whitelist don't change.
v1.5.1: the settings gain `singleKeyShortcuts` (default `true`: the bare `?` opens the shortcut list) without a version bump, like `hideScrollbars` — `healSettings` back-fills it and turns anything but a boolean into `true`.
v1.6.0: editor v22 back-fills `frameGenCustom` (the frame generation typed for the new `"custom"` multiplier) with `""` and `dlssNeuralRendering` (NVIDIA DLSS 5 Neural Rendering) with `false`, coercing values of the wrong type. The multiplier list only widens (`x6` and `dynamic` for NVIDIA, `custom` for every vendor), and the backup whitelist checks it against `FRAMEGEN_MULTIPLIERS`. `normalizeEditorPatch` and the backup import turn `dlssNeuralRendering` off for any vendor but NVIDIA (`coerceDlssNeuralRendering`). Neither field is a profile or preset field, like the rest of the frame-gen settings. The LUT's "Custom" needs no migration: it is a rig value like any LUT name.
Rules:
- **localStorage is the only store**, on the web, desktop and Android. The desktop "mirror" file of earlier versions (`storage-adapter.ts`, `saveSettings`, `checkDataFileHealth`) was removed in v1.0.0; it was written next to the data folder and never read back. [PACKAGING.md](PACKAGING.md) covers how the leftover file is recovered.
@@ -590,6 +598,7 @@ An unknown version is read as 0: every migration step is idempotent, so running
| `security.yml` (Security) | PRs, pushes on `main`, weekly, manual | `dependency-review` (PRs: fails on a newly added high/critical advisory), `workflow-lint` (actionlint + zizmor, `.github/zizmor.yml`), `scorecard` (OpenSSF Scorecard, informational; not on PRs) |
| `compliance.yml` (Compliance) | PRs, pushes on `main` | `reuse` (REUSE licensing via `REUSE.toml`), `pr-title` (Conventional-Commit PR titles with a lower-case subject) |
| `rust.yml` (Rust) | Changes under `src-tauri/`, weekly, manual | `lint-and-test` (`cargo fmt --all -- --check`, `cargo clippy --all-targets --locked -- -D warnings`, `cargo test --locked`, after `npm run build` because `generate_context!` embeds `dist/`), `cargo-deny` (`check advisories licenses sources`, `src-tauri/deny.toml`) |
| `qodana.yml` (Qodana) | PRs to and pushes on `main`, manual | `typescript` — Qodana for JS in native mode (`qodana.yaml`); `rust` — Qodana for Rust, Early Access, in Docker (`src-tauri/qodana.yaml`); both skip without their token (Dependabot and fork PRs) |
| `release-desktop.yml`, `release-android.yml` | `v*` tags, manual with a `tag` input | `verify`, then the builds — see [PACKAGING.md](PACKAGING.md) |
| `announce-release.yml` | Release published, manual | Links the release to an Announcements discussion and posts to Discord |
| `notify-ci-failure.yml`, `notify-release-pipeline.yml` | `workflow_run` | Discord notifications through the maintainer's shared workflows |
@@ -637,7 +646,8 @@ Then `sonarcloud` (after `check` succeeds):
- **Copyright years** (`scripts/lib/copyright.ts`, v1.1.0): NOTICE, REUSE.toml and `bundle.copyright` in `tauri.conf.json` must state `copyrightYears(<year of HEAD's commit>)` from `src/config/brand.ts` — "2026", then "2026-2027" from the first commit of 2027. The commit year rather than the clock keeps old commits green; `npm run update:copyright` rewrites the three files. The `/legal` pages' footer uses the same helper at build time.
- **Wrangler dry run** validates `wrangler.jsonc` and bundles the Worker exactly as Workers Builds will, without deploying.
- **SonarCloud** (CI-based; Automatic Analysis is off in the project's settings): `sonar-project.properties` makes the whole repository main code except the tests (`tests/**` and any `src/**/*.test.ts(x)`, analysed as tests) and the binary files (icons, the Gradle wrapper's jar), imports `coverage/lcov.info` and excludes from coverage everything Vitest does not measure (see [Testing Strategy](#6-testing-strategy)). The scan waits for the quality gate — Sonar way: A security, reliability and maintainability ratings, every security hotspot reviewed, ≤ 3 % duplication and ≥ 80 % coverage on new code — and fails the job when it fails. New code is "since the previous version": the job reads `package.json`'s version into `sonar.projectVersion`, so every release starts a new period. The scan runs in a job of its own so that `SONAR_TOKEN` never shares a job with npm packages. PRs from forks and from Dependabot get no repository secrets and skip it; the condition checks the PR author, not `github.actor` (zizmor's `bot-conditions`).
- Every workflow declares least-privilege `permissions`, checks out with `persist-credentials: false`, and pins actions by commit SHA (Dependabot keeps the SHAs and version comments current). The exceptions are the actionlint Docker image (pinned by version tag) and the maintainer's own `poli0981/.github` reusable workflows (tracked at `main`, allowed in `.github/zizmor.yml`). CI, Security, Compliance and Rust cancel superseded runs through a `concurrency` group, except on `main`, where each commit's result is a record the release process reads back.
- **Qodana** (v1.6.0; JetBrains, Ultimate licence — the account runs the trial): `qodana.yml` runs Qodana for JS in native mode, on the runner's Node 26 and `node_modules` (`qodana.yaml`), and Qodana for Rust (Early Access, Docker only) on `src-tauri/` (`src-tauri/qodana.yaml`: its `bootstrap` installs the packages `rust.yml` installs, and a stand-in `dist/index.html` lets `generate_context!` expand). Both use the `qodana.recommended` profile and a quality gate of zero problems; every exclusion in a `qodana.yaml` says why. Every run analyses the whole project (`pr-mode: false`). Results go to Qodana Cloud (projects `yt-ts-js` and `yt-rust`), the run's annotations and the `qodana-report-*` artifacts — no PR comment. A `tokens` job checks for `QODANA_TOKEN_TS_JS` and `QODANA_TOKEN_RUST`, which Dependabot and fork PRs don't get, so the analysis is skipped there; the token reaches only the scan step, never the `npm ci` one. Not a required check. When the licence lapses, both jobs fail at the licence check.
- Every workflow declares least-privilege `permissions`, checks out with `persist-credentials: false`, and pins actions by commit SHA (Dependabot keeps the SHAs and version comments current). The exceptions are the actionlint Docker image (pinned by version tag) and the maintainer's own `poli0981/.github` reusable workflows (tracked at `main`, allowed in `.github/zizmor.yml`). CI, Security, Compliance, Rust and Qodana cancel superseded runs through a `concurrency` group, except on `main`, where each commit's result is a record the release process reads back.
**Web deployment is not a GitHub workflow.** Cloudflare Workers Builds builds and deploys the Worker and `dist/` on every push to `main` (preview versions for other branches). The old `deploy-web.yml` (GitHub Pages) is gone; `pages-migration.yml` only serves the moving notice, which hands visitors the data their browser saved on the old address as a `_format: 2` backup file. See [HOSTING.md](HOSTING.md).
@@ -645,7 +655,7 @@ Then `sonarcloud` (after `check` succeeds):
## 6. Testing Strategy
Vitest runs `tests/**/*.test.{ts,tsx}` and `src/**/*.test.{ts,tsx}` in the **node** environment, with `globals: true`: 1017 tests in 52 files at v1.3.2. Directories: `tests/engine`, `store`, `utils` (backup detect / sanitize / restore, quick entry, validation, the migration page), `worker` (router, rate limits, cookie, Turnstile verdicts, headers, gate language), `build` (legal pages, web-only plugins), `config`, `hooks`, `i18n`, `scripts`. No test renders components: React Testing Library is installed but jsdom is not, so a rendering test would need both jsdom and a `// @vitest-environment jsdom` docblock.
Vitest runs `tests/**/*.test.{ts,tsx}` and `src/**/*.test.{ts,tsx}` in the **node** environment, with `globals: true`: 1158 tests in 56 files at v1.6.0. Directories: `tests/engine`, `store`, `styles` (WCAG AA contrast of the colour tokens), `utils` (backup detect / sanitize / restore, quick entry, validation, the migration page), `worker` (router, rate limits, cookie, Turnstile verdicts, headers, gate language), `build` (legal pages, web-only plugins), `config`, `hooks`, `i18n`, `scripts`. No test renders components: React Testing Library is installed but jsdom is not, so a rendering test would need both jsdom and a `// @vitest-environment jsdom` docblock.
Engine tests build a full `GeneratorInput` and pass a mock translator (`tests/helpers/mock-t.ts`) that reads the real `templates.json` files (en, vi, ja):
@@ -694,7 +704,7 @@ describe("buildTitle", () => {
| `src/engine/**` | 88 % | 85 % | 60 % | 88 % |
| `worker/**` (excluding `worker/index.ts`) | 95 % | 85 % | 95 % | 95 % |
Guard tests worth knowing: `tests/hooks/render-options-parity.test.ts` (settings → engine options), `tests/hooks/generator-input-mapping.test.ts` (editor → engine input), `tests/i18n/locale-registration.test.ts` (language registration in both directions), `tests/config/content-warning-groups.test.ts` and `tech-note-groups.test.ts` (every id in exactly one group, with an editor label and a description line in `_schema.json` — v1.2.0), the genre/tag-pool sync in `tests/engine/tag-generator.test.ts`, and `tests/worker/headers.test.ts` (keeps the Worker's baseline headers in step with `public/_headers`). The Rust side has its own `cargo test` suite (name validation, path rejection, pruning, legacy recovery, dialog filters).
Guard tests worth knowing: `tests/hooks/render-options-parity.test.ts` (settings → engine options), `tests/hooks/generator-input-mapping.test.ts` (editor → engine input), `tests/i18n/locale-registration.test.ts` (language registration in both directions), `tests/config/content-warning-groups.test.ts` and `tech-note-groups.test.ts` (every id in exactly one group, with an editor label and a description line in `_schema.json` — v1.2.0), the genre/tag-pool sync in `tests/engine/tag-generator.test.ts`, `tests/worker/headers.test.ts` (keeps the Worker's baseline headers in step with `public/_headers`), and `tests/styles/contrast.test.ts` (v1.5.1: every text token reaches 4.5:1 on the surfaces in both themes, white text on the `*-solid` fills, 3:1 for marks on `accent`). The Rust side has its own `cargo test` suite (name validation, path rejection, pruning, legacy recovery, dialog filters).
## 7. YouTube Character Limits Reference
+129
View File
@@ -0,0 +1,129 @@
# Khả năng tiếp cận
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`ACCESSIBILITY.md` ở root](../../../ACCESSIBILITY.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
**Cập nhật lần cuối:** 2026-11-09
YTDescGen hướng tới việc ai làm video cũng dùng được, kể cả người dùng bàn phím thay chuột, trình đọc màn hình, phóng to hoặc kính lúp, chế độ tương phản cao, điều khiển bằng giọng nói hay màn hình cảm ứng. Văn bản này nói rõ những gì đang hoạt động, cách kiểm tra, những gì chưa ổn, và cách báo cho chúng tôi khi bạn gặp rào cản.
Văn bản áp dụng cho trang web [ytgenerator.stream](https://ytgenerator.stream), ứng dụng desktop (Windows, macOS, Linux) và ứng dụng Android. Các bản này dùng chung một giao diện, nên mọi điều dưới đây áp dụng cho tất cả, trừ khi có nêu tên nền tảng.
## Mục tiêu
Chúng tôi hướng tới [WCAG 2.2](https://www.w3.org/TR/WCAG22/) mức **AA**. Đây là mục tiêu, không phải tuyên bố đã đạt chuẩn: YTDescGen là dự án mã nguồn mở do một người duy trì và chưa được kiểm định độc lập. Khi phát hiện chỗ chưa đạt, chỗ đó sẽ được sửa hoặc ghi vào mục [Hạn chế đã biết](#hạn-chế-đã-biết).
## Những gì đang hoạt động
### Bàn phím
- Mọi trang, menu và hộp thoại đều dùng được chỉ bằng bàn phím. **Chuyển đến nội dung** là điểm dừng đầu tiên trên các trang của ứng dụng, và một đường viền hiện rõ vị trí đang được focus.
- Hộp thoại giữ focus bên trong khi đang mở, đóng bằng **Esc**, rồi trả focus về đúng nút đã mở nó.
- Phím tắt dùng được trên mọi trang:
- **Ctrl/⌘ + K**: command palette (mở trang bất kỳ, sao chép, profile, preset, template, đổi theme và ngôn ngữ).
- **Ctrl/⌘ + G** hoặc **Ctrl/⌘ + Enter**: sang trang Kết quả.
- **Ctrl/⌘ + Shift + C**: Sao chép tất cả.
- **Ctrl/⌘ + S**: lưu vào Lịch sử.
- **Ctrl/⌘ + B**: thu gọn/mở thanh bên.
- **Alt + T**: tới vùng thông báo.
- **Ctrl/⌘ + /** (hoặc **?**): danh sách đầy đủ.
- Phím tắt một phím **?** có thể tắt ở **Cài đặt › Trình soạn › Phím tắt một phím**, dành cho người nhập bằng giọng nói hoặc hay bấm nhầm phím.
### Trình đọc màn hình
- Mọi nút đều có tên, kể cả nút chỉ có biểu tượng, và mọi ô nhập đều có nhãn. Gợi ý và thông báo lỗi được gắn với đúng ô của nó.
- Các xác nhận và lỗi đều được đọc lên ("Đã sao chép!", "Đã lưu vào lịch sử", lý do không sao chép được), các vấn đề của Strict Mode cũng vậy.
- Khi bạn mở trang khác, tên trang được đọc lên. Focus vẫn ở liên kết bạn vừa dùng.
- Mỗi trang có tiêu đề riêng và một tiêu đề chính duy nhất. Ngôn ngữ của trang theo ngôn ngữ giao diện bạn chọn (tám ngôn ngữ).
- Tiêu đề, mô tả và tag được tạo ra đều gắn ngôn ngữ mà chúng được viết, nên mô tả tiếng Nhật được đọc bằng giọng tiếng Nhật kể cả khi giao diện đang là tiếng Việt.
### Thị giác
- Có theme tối và theme sáng, cả hai đều đạt độ tương phản WCAG AA cho chữ (4.5:1) trên mọi nền. Một test giữ cho điều này không bị phá ([tests/styles/contrast.test.ts](../../../tests/styles/contrast.test.ts)).
- Bố cục co giãn từ màn hình rộng xuống bề rộng điện thoại, nên khi phóng to, nội dung dồn thành một cột thay vì tràn ra ngoài màn hình.
- Ứng dụng desktop phóng to/thu nhỏ bằng **Ctrl/⌘ + =** và **Ctrl/⌘ + −** (trên Windows dùng được cả Ctrl + con lăn chuột). Trên Android, dùng hai ngón tay để phóng to.
- Ở chế độ High Contrast của Windows (forced colours), đường viền focus vẫn hiện.
- **Cài đặt › Giao diện › Ẩn thanh cuộn** bỏ các thanh cuộn; vẫn cuộn được bằng bàn phím, con lăn chuột và cảm ứng.
### Chuyển động
- Khi bật **Giảm chuyển động** (Reduce motion) trong hệ điều hành, các hiệu ứng động và cuộn mượt được tắt.
### Cảm ứng
- Trên màn hình cảm ứng, nút và ô nhập lớn lên khoảng 44 px, các nút đóng/bỏ qua nhỏ cũng vậy.
### Trang kiểm tra của website
- Bước kiểm tra Cloudflare Turnstile trước khi vào website thường tự xong. Trạng thái của nó ("Đang kiểm tra trình duyệt…", lỗi) được đọc lên, và dùng được bằng bàn phím. Xem [Hạn chế đã biết](#hạn-chế-đã-biết) nếu Cloudflare yêu cầu bạn giải thử thách.
## Cách kiểm tra
- **Thủ công.** Người duy trì dùng YTDescGen chỉ bằng bàn phím (rút chuột) và bằng Windows Narrator, qua các luồng chính: trình soạn, kết quả, sao chép, profile, preset, template, Lịch sử, Cài đặt và sao lưu.
- **Tự động.** Một unit test kiểm tra độ tương phản của mọi token màu ở cả hai theme.
- **Quy tắc thiết kế.** Các thành phần giao diện dựng từ những khối có sẵn khả năng tiếp cận (Radix primitives). Nút chỉ có biểu tượng không thể tạo ra mà thiếu tên, và mọi ô nhập lấy nhãn và phần nối lỗi từ cùng một component dùng chung.
Ứng dụng **chưa** được thử với NVDA, JAWS, VoiceOver (macOS), TalkBack (Android) hay Orca (Linux). Rất mong nhận được phản hồi từ những ai đang dùng các công cụ này.
## Môi trường hỗ trợ
| Nền tảng | Chạy trên | Trình đọc màn hình |
| --- | --- | --- |
| Windows: ứng dụng desktop, hoặc website trên Edge / Chrome | Windows 10 hoặc 11 với WebView2; Chrome hoặc Edge 111+ | Narrator: đã thử |
| Website trên trình duyệt khác | Firefox 114+, Safari 16.4+ | Chưa thử |
| Ứng dụng desktop macOS | macOS 11 trở lên, Apple silicon | VoiceOver: chưa thử |
| Ứng dụng desktop Linux | WebKitGTK 2.40 trở lên | Orca: chưa thử |
| Ứng dụng Android | Android 11 trở lên, Android System WebView bản mới | TalkBack: chưa thử |
## Hạn chế đã biết
- **Thử thách của Cloudflare trên website.** Nếu Turnstile bắt bạn giải thử thách thay vì tự qua, thử thách đó do Cloudflare quản lý và khả năng tiếp cận của nó do họ sửa. Nếu nó chặn bạn, hãy dùng ứng dụng desktop hoặc Android (không có trang kiểm tra), hoặc [gửi email cho chúng tôi](#báo-một-rào-cản).
- **Viền ô nhập mờ.** Viền của ô nhập trống chỉ khoảng 1.2–1.3:1 so với nền, dưới mức 3:1 mà WCAG yêu cầu. Ô nhập vẫn được nhận biết qua nhãn, và ô đang focus có viền và vầng màu nhấn.
- **Nút Tiếp tục ở màn hình chạy lần đầu** dùng gradient của thương hiệu. Chữ trắng trên đầu màu tím nhạt hơn của gradient chỉ đạt 3.96:1.
- **Bộ đếm ký tự không được đọc lên khi bạn gõ**, vì như vậy sẽ chen ngang mỗi lần gõ phím. Khi một trường vượt giới hạn của YouTube, việc sao chép bị từ chối kèm thông báo lý do, và Strict Mode liệt kê vấn đề trong một banner được đọc lên.
- **Chưa có lint khả năng tiếp cận tự động.** `eslint-plugin-jsx-a11y` chưa hỗ trợ ESLint 10 mà dự án đang dùng, và unit test chạy không có DOM của trình duyệt. Ngoài test độ tương phản, việc kiểm tra là thủ công (xem ở trên).
- **Bản dịch.** Các ngôn ngữ giao diện ngoài tiếng Anh và tiếng Việt được dịch với sự hỗ trợ của AI (xem [Tuyên bố miễn trừ](DISCLAIMER.md)). Một số nhãn có thể nghe không tự nhiên khi được đọc lên.
- **Emoji trong mô tả.** Mô tả được tạo dùng vài emoji làm dấu mục (ví dụ 👍 và 🔔), và trình đọc màn hình trên YouTube sẽ đọc tên của chúng.
## Báo một rào cản
Nếu có điều gì trong YTDescGen cản trở bạn, hãy cho chúng tôi biết. Bạn không cần biết nguyên nhân kỹ thuật.
- **Nên dùng:** mở một [issue về khả năng tiếp cận](https://github.com/poli0981/youtube-generator/issues/new?template=accessibility.yml). Biểu mẫu sẽ hỏi nền tảng, công nghệ hỗ trợ bạn dùng và chuyện gì đã xảy ra.
- **Không muốn đăng công khai?** Gửi email tới **contact@poli0981.dev**, tiêu đề bắt đầu bằng `[Accessibility]`.
- **Câu hỏi nhanh?** Hỏi trên [Discord](https://discord.gg/kDM9GMu5vm).
### Mức độ nghiêm trọng
| Mức | Ý nghĩa |
| --- | --- |
| **Critical** | Bạn không làm xong được việc chính: soạn, tạo, sao chép, lưu, hoặc qua được bước kiểm tra của website. |
| **High** | Bạn làm xong được, nhưng rất vất vả hoặc phải dùng cách vòng. |
| **Medium** | Vẫn dùng được, nhưng thất thường hoặc khó hiểu. |
| **Low** | Phiền nhỏ, không cản bạn. |
### Cách chúng tôi phản hồi
- Chúng tôi trả lời trong vòng **7 ngày** và tin vào những gì bạn báo.
- Rào cản **Critical** được sửa trong bản vá kế tiếp. Các mức khác được lên kế hoạch như mọi lỗi khác, mức nặng hơn làm trước.
- Nếu có cách tạm thời, chúng tôi sẽ cho bạn biết trong lúc chờ bản sửa.
- Khi bản sửa ra, chúng tôi sẽ nhờ bạn kiểm tra lại nếu bạn sẵn lòng.
Đây là dự án một người làm, nên các mốc thời gian là ước tính thật lòng, không phải cam kết. Nếu trễ, chúng tôi sẽ nói rõ trong issue.
## Dành cho người đóng góp
Thay đổi giao diện cần giữ đúng mọi điều ở trên. Trước khi mở pull request có đụng tới UI:
- **Bàn phím.** Mọi thứ dùng được bằng bàn phím: thứ tự focus hợp lý, đường viền focus hiện rõ, **Esc** đóng thứ bạn vừa mở, và không có chỗ nào giữ chặt focus.
- **Tên gọi.** Dùng các component dùng chung `Field` (nối nhãn, gợi ý và lỗi) và `IconButton` (không thể render nếu thiếu `label`). Chữ trong `aria-label` đi qua `t()` như mọi chuỗi khác, đủ tám locale.
- **Lỗi và trạng thái.** Phải được đọc lên: `Banner` với `alert`, một toast, hoặc một live region có sẵn.
- **Màu sắc.** Màu không bao giờ là tín hiệu duy nhất. Chỉ dùng token thiết kế, và chạy `npm run test:run`. Test độ tương phản sẽ báo lỗi nếu một token tụt dưới AA, và chữ trắng phải nằm trên các nền `*-solid`.
- **Chuyển động.** Hiệu ứng mới phải tôn trọng giảm chuyển động. Các component của Motion đã làm sẵn, và animation CSS được quy tắc chung trong `globals.css` xử lý.
- **Kích thước.** Mọi thứ bấm được tối thiểu 24 × 24 px và lớn lên trên màn hình cảm ứng.
- **Trình đọc màn hình.** Thử thay đổi một lần bằng trình đọc màn hình: Narrator (Win + Ctrl + Enter), VoiceOver (⌘ + F5), NVDA hoặc Orca.
Mẫu pull request có cùng danh sách kiểm tra này.
## Góp ý cho văn bản này
Mọi ý tưởng để cải thiện văn bản này hay cách xử lý khả năng tiếp cận đều được hoan nghênh trên [GitHub Discussions](https://github.com/poli0981/youtube-generator/discussions). Còn rào cản thì hãy báo qua [quy trình báo lỗi](#báo-một-rào-cản) để được theo dõi.
+3 -1
View File
@@ -1,6 +1,6 @@
# Danh mục Nội dung
Bản kê khai tĩnh cho mọi loại video, thể loại game, cảnh báo nội dung, ghi chú kỹ thuật, cửa hàng, trường link và nền tảng đăng chéo trong editor của YTDescGen (tính đến v1.3.0). Cập nhật thủ công — khi thêm mục mới vào một trong các file nguồn dưới đây, **thêm dòng tương ứng vào đây** trong cùng PR.
Bản kê khai tĩnh cho mọi loại video, thể loại game, cảnh báo nội dung, ghi chú kỹ thuật, cửa hàng, trường link và nền tảng đăng chéo trong editor của YTDescGen (tính đến v1.6.0). Cập nhật thủ công — khi thêm mục mới vào một trong các file nguồn dưới đây, **thêm dòng tương ứng vào đây** trong cùng PR.
File này tồn tại để **minh bạch** — bất kỳ ai tò mò về việc editor có thể mô tả được gì (mà không cần cài app hay đọc source) đều có thể quét trong một phút.
@@ -166,6 +166,8 @@ Bản thân game được làm hoặc chạy bằng AI tạo sinh — còn game
Ghi chú được chọn hiển thị trong khối `▸ 🛠 TECH NOTES` (`▸ 🛠 GHI CHÚ KỸ THUẬT` khi output là tiếng Việt) ngay sau cảnh báo nội dung, theo thứ tự người dùng chọn. Chúng nói về bản quay, không phải về game. Những thông tin đã có trường riêng — độ khó, ending đã chiếu, language patch, phiên bản game, upscaler và frame generation trong Video settings — không lặp lại ở đây.
Khi chọn **Upscaled from** trong Video settings (v1.5.0), một ghi chú nữa tự thêm vào sau các ghi chú bạn chọn: _Đã upscale lên độ phân giải cao hơn khi dựng — chi tiết nhỏ được tái tạo, nên chữ, texture và đường viền có thể hơi khác so với hình gốc._ Ghi chú này không có trong danh sách bên dưới; dòng Upscale trong Video settings cho biết upscale từ đâu lên đâu.
### Âm thanh (5)
Tắt tiếng (bản quyền) · Giảm volume (bản quyền) · Thay nhạc (bản quyền) · Chỉ tắt cutscene · Giữ audio gốc (rủi ro claim)
+2
View File
@@ -89,6 +89,7 @@ Dev server chỉ chạy riêng app: không có cổng Turnstile, không có anal
- Tiêu đề PR theo định dạng commit `type(scope): message`; CI có kiểm tra.
- Mỗi PR đều chạy job `check` (xem bên dưới), `dependency-review`, `workflow-lint`, `reuse` và `pr-title`; hai job Rust `lint-and-test` và `cargo-deny` chạy khi có thay đổi trong `src-tauri/`.
- Sau `check`, job `sonarcloud` gửi mã nguồn và báo cáo coverage lên [SonarCloud](https://sonarcloud.io/project/overview?id=poli0981_youtube-generator) (cấu hình trong `sonar-project.properties`) và fail khi quality gate fail: code mới phải đạt hạng A, mọi security hotspot đã được review, trùng lặp tối đa 3 % và coverage tối thiểu 80 %. PR từ fork và từ Dependabot bỏ qua job này — chúng không có `SONAR_TOKEN` — còn `main` được phân tích sau mỗi lần merge.
- Workflow `Qodana` chạy JetBrains [Qodana](https://www.jetbrains.com/qodana/) trên mọi PR và mọi lần push vào `main`: Qodana for JS cho cả repo (`qodana.yaml`) và Qodana for Rust cho `src-tauri/` (`src-tauri/qodana.yaml`). Cả hai fail khi có bất kỳ lỗi nào. Giống SonarCloud, PR từ fork và từ Dependabot bỏ qua phân tích vì không có token Qodana. Đây không phải check bắt buộc.
Quy định đầy đủ: [CONTRIBUTING.md](../../../CONTRIBUTING.md).
@@ -248,3 +249,4 @@ docs/I18N.md). Lời khuyên restart ở trên vẫn áp dụng cho tất 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.
- [ACCESSIBILITY.md ở root](../../../ACCESSIBILITY.md) — những gì dùng được với công nghệ hỗ trợ, và checklist cho thay đổi UI (bản tiếng Việt: [ACCESSIBILITY.md](./ACCESSIBILITY.md)).
+1 -1
View File
@@ -6,7 +6,7 @@
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 (các model Claude Opus; từ bản v1.0.0 đến v1.3.2 dùng Claude Opus 5.5)**. 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.
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 (các model Claude Opus; từ bản v1.0.0 đến v1.5.1 và bản v1.6.0 dùng Claude Opus 5.5, bản v1.5.2 dùng Claude Fable 5.2)**. 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:
+713 -891
View File
File diff suppressed because it is too large. Load diff
+21 -24
View File
@@ -1,6 +1,6 @@
{
"name": "yt-desc-gen",
"version": "1.3.2",
"version": "1.6.0",
"private": true,
"license": "Apache-2.0",
"type": "module",
@@ -44,49 +44,46 @@
"@tauri-apps/plugin-opener": "^2.7.2",
"clsx": "^2.1.1",
"cmdk": "^1.1.1",
"i18next": "^26.5.3",
"i18next-resources-to-backend": "^1.2.3",
"lucide-react": "^1.59.0",
"i18next": "~26.6.0",
"i18next-resources-to-backend": "^1.2.4",
"lucide-react": "^1.70.0",
"motion": "^13.5.1",
"radix-ui": "^1.8.1",
"react": "^19.3.1",
"react-dom": "^19.3.1",
"react-i18next": "^17.1.0",
"react-router-dom": "^7.18.4",
"simple-icons": "^16.35.0",
"react-i18next": "^17.1.13",
"react-router-dom": "^7.18.5",
"simple-icons": "^16.37.0",
"sonner": "^2.0.8",
"zustand": "^5.0.15"
"zustand": "^5.1.0"
},
"devDependencies": {
"@eslint/js": "^10.0.1",
"@resvg/resvg-js": "2.6.2",
"@tailwindcss/postcss": "^4.3.3",
"@tauri-apps/cli": "2.12.3",
"@tailwindcss/postcss": "^4.3.5",
"@tauri-apps/cli": "2.12.4",
"@testing-library/jest-dom": "^7.0.1",
"@testing-library/react": "^16.3.3",
"@types/node": "^26.6.5",
"@types/node": "^26.6.6",
"@types/react": "^19.3.0",
"@types/react-dom": "^19.3.0",
"@typescript/native": "npm:typescript@^7.0.2",
"@vitejs/plugin-react": "^6.1.2",
"@vitejs/plugin-react": "^6.3.0",
"@vitest/coverage-v8": "^4.1.12",
"autoprefixer": "^10.6.1",
"eslint": "^10.13.0",
"autoprefixer": "^10.6.2",
"eslint": "^10.14.0",
"eslint-plugin-react-hooks": "^7.1.1",
"knip": "^6.42.1",
"marked": "18.1.1",
"postcss": "^8.5.31",
"knip": "^6.44.2",
"marked": "18.2.0",
"postcss": "^8.5.32",
"prettier": "^3.9.10",
"prettier-plugin-tailwindcss": "^0.8.1",
"tailwindcss": "^4.3.3",
"tailwindcss": "^4.3.5",
"tsx": "^4.23.15",
"typescript": "npm:@typescript/typescript6@^6.0.2",
"typescript-eslint": "^8.72.0",
"vite": "^8.3.4",
"typescript-eslint": "^8.72.2",
"vite": "^8.3.7",
"vitest": "^4.1.12",
"wrangler": "4.151.2"
},
"overrides": {
"undici": "^7.30.1"
"wrangler": "4.159.0"
}
}
+2 -1
View File
@@ -2,6 +2,7 @@
// first paint, so a light-theme user never sees the dark default flash. A
// separate file rather than an inline <script> so the Content-Security-Policy
// needs no exception.
/* global document, localStorage */
(function () {
var root = document.documentElement;
var theme = "dark";
@@ -14,7 +15,7 @@
// Unhealed raw storage, so only a real `true` counts.
if (state && state.hideScrollbars === true) hideScrollbars = true;
if (state && typeof state.appLanguage === "string") lang = state.appLanguage;
} catch (e) {
} catch {
/* storage blocked or corrupt: keep the defaults */
}
root.classList.toggle("dark", theme === "dark");
+59
View File
@@ -0,0 +1,59 @@
# Qodana for JavaScript / TypeScript: the web app (src/), the Worker, the
# build plugins, scripts, tests and workflows. Run by
# .github/workflows/qodana.yml (job `typescript`, native mode), reported to
# the Qodana Cloud project yt-ts-js (secret QODANA_TOKEN_TS_JS).
version: "1.0"
linter: qodana-js
profile:
name: qodana.recommended
# The quality gate: any problem fails the job.
failureConditions:
severityThresholds:
any: 0
exclude:
- name: All
paths:
# The Tauri shell is the Rust project (src-tauri/qodana.yaml).
- src-tauri
# Build output, caches and reports.
- dist
- coverage
- node_modules
- .wrangler
# The GitHub Pages moving notice, removed on 2026-11-29 (issue #177).
- migration-page
# `${{ secrets.DISCORD_RELEASE_PIPELINE_WEBHOOK }}` is a reference to a
# repository secret, not a secret: the "discord-client-secret" rule only
# sees the word.
- name: HardcodedPasswords
paths:
- .github/workflows/notify-release-pipeline.yml
# `\]` and `\}` outside a character class stay escaped: they read as the
# literal brackets they are, and the patterns stay valid if they ever get
# the `u` or `v` flag, where a lone `]` or `}` is a syntax error. ESLint's
# no-useless-escape accepts them too.
- name: RegExpRedundantEscape
# `@i18n/index` is the form tsconfig.json's `@i18n/*` path resolves. The
# bare `@i18n` this suggests resolves only through Vite's alias, so tsc
# would no longer find the module.
- name: ES6PreferShortImport
# The three react-hooks warnings eslint.config.js documents (state synced
# from i18next, from a store number, and a useMemo the React Compiler
# can't keep): each needs a restructure, and the config keeps them as
# warnings on purpose. ESLint runs in CI's `check` job as well.
- name: Eslint
paths:
- src/hooks/use-languages-ready.ts
- src/components/editor/PlaytestEditor.tsx
- src/components/editor/StoreLinkEditor.tsx
# The legacy draft fields `spoilerWarning`, `matureWarning` and
# `endingsShown` are `@deprecated` so new code doesn't use them; these
# files carry them on purpose, to read and migrate drafts, presets and
# templates saved by older versions.
- name: JSDeprecatedSymbols
paths:
- src/config/defaults.ts
- src/store/editor-store.ts
- src/hooks/use-current-generator-input.ts
- src/engine/description-builder.ts
- src/utils/library-apply.ts
+41 -128
View File
@@ -73,9 +73,9 @@ dependencies = [
[[package]]
name = "async-executor"
version = "1.14.0"
version = "1.14.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c96bf972d85afc50bf5ab8fe2d54d1586b4e0b46c97c50a0c9e71e2f7bcd812a"
checksum = "f426a31126c735126297bc5ea7a521263c9faff4f63ca415267ee625651c4f37"
dependencies = [
"async-task",
"concurrent-queue",
@@ -717,7 +717,7 @@ dependencies = [
"libc",
"option-ext",
"redox_users",
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -888,7 +888,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
dependencies = [
"libc",
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -1547,12 +1547,12 @@ dependencies = [
[[package]]
name = "ico"
version = "0.5.0"
version = "0.6.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3e795dff5605e0f04bff85ca41b51a96b83e80b281e96231bcaaf1ac35103371"
checksum = "d75e94d66081e4d8dcd098bd8dc5254800fea14a26389b298410158d834de167"
dependencies = [
"byteorder",
"png 0.17.16",
"png",
]
[[package]]
@@ -2013,7 +2013,7 @@ dependencies = [
"objc2-core-foundation",
"objc2-foundation",
"once_cell",
"png 0.18.1",
"png",
"serde",
"thiserror 2.0.18",
"windows-sys 0.61.2",
@@ -2478,19 +2478,6 @@ dependencies = [
"time",
]
[[package]]
name = "png"
version = "0.17.16"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "82151a2fc869e011c153adc57cf2789ccb8d9906ce52c0b39a6b5697749d7526"
dependencies = [
"bitflags 1.3.2",
"crc32fast",
"fdeflate",
"flate2",
"miniz_oxide",
]
[[package]]
name = "png"
version = "0.18.1"
@@ -2752,9 +2739,9 @@ dependencies = [
[[package]]
name = "rfd"
version = "0.16.0"
version = "0.17.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a15ad77d9e70a92437d8f74c35d99b4e4691128df018833e99f90bcd36152672"
checksum = "20dafead71c16a34e1ff357ddefc8afc11e7d51d6d2b9fbd07eaa48e3e540220"
dependencies = [
"block2",
"dispatch2",
@@ -2762,16 +2749,18 @@ dependencies = [
"gobject-sys",
"gtk-sys",
"js-sys",
"libc",
"log",
"objc2",
"objc2-app-kit",
"objc2-core-foundation",
"objc2-foundation",
"percent-encoding",
"raw-window-handle",
"wasm-bindgen",
"wasm-bindgen-futures",
"web-sys",
"windows-sys 0.60.2",
"windows-sys 0.61.2",
]
[[package]]
@@ -2799,7 +2788,7 @@ dependencies = [
"errno",
"libc",
"linux-raw-sys",
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -3279,9 +3268,9 @@ dependencies = [
[[package]]
name = "tao"
version = "0.37.1"
version = "0.37.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f37f381f4e048e6cdf038b5705f8cf14ad108279d46eb968140a7b291aba9400"
checksum = "d5777b06fe6435126ae8d816eba269e050e1e10d302cf5461e9c49eccabc3548"
dependencies = [
"bitflags 2.11.0",
"block2",
@@ -3336,9 +3325,9 @@ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
[[package]]
name = "tauri"
version = "2.12.4"
version = "2.12.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f316751027fc2644221d1a448564d519efb07067fda584879d9cda966391d212"
checksum = "5fb0244332cfb9cee7e2a568bf5da29a36ed8fdbd717f6f47a66b6b7b358c072"
dependencies = [
"anyhow",
"bytes",
@@ -3387,9 +3376,9 @@ dependencies = [
[[package]]
name = "tauri-build"
version = "2.7.3"
version = "2.7.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "641dd5fd297c99ab92717b0428cca5b9c6f960b2ac96ca131b3eebc9d70b8ddc"
checksum = "adddb0e648752aaac5da9c3c3c6a68e1e87cab55e3b757b18a9441ef8c3ac614"
dependencies = [
"anyhow",
"cargo_toml",
@@ -3410,16 +3399,16 @@ dependencies = [
[[package]]
name = "tauri-codegen"
version = "2.7.3"
version = "2.7.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a6585c5b536c00f039d12ce70a9755172d5423bbcfd3969863baa70314c3e02f"
checksum = "fb37631cf71dab5e8ab55e1bdd701e18a52653d90b78e71d0e5598b1e0a61316"
dependencies = [
"base64 0.23.1",
"brotli",
"ico",
"json-patch",
"plist",
"png 0.18.1",
"png",
"proc-macro2",
"quote",
"semver",
@@ -3437,9 +3426,9 @@ dependencies = [
[[package]]
name = "tauri-macros"
version = "2.7.3"
version = "2.7.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e2e83a0cfa1bae376e8fbbdc0b1692707aed50cd6072ce85cae4789af5d6c19f"
checksum = "0cc38db58854c10fb5f91a887ed8bf82d3239bb92b5d8db86eda09e96d9963d1"
dependencies = [
"heck 0.5.0",
"proc-macro2",
@@ -3467,9 +3456,9 @@ dependencies = [
[[package]]
name = "tauri-plugin-dialog"
version = "2.8.3"
version = "2.8.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b7461aaacf1901915ea7b9f5cd74f8224a351ed96af0a62c07fce934003cb34b"
checksum = "ce0fb9c2b6d34a9720627ed930ebc8af26f61e648695aecaeb03d5c33c5896f5"
dependencies = [
"log",
"raw-window-handle",
@@ -3531,9 +3520,9 @@ dependencies = [
[[package]]
name = "tauri-plugin-single-instance"
version = "2.5.4"
version = "2.5.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "561cd99484561bc39c954768e7b41a66cebbe1ac3d9d081c34361f740c489e2c"
checksum = "726b6da0dd5bd1344f84f4108a622c07d01923baacb5c803a605189672c5352f"
dependencies = [
"serde",
"serde_json",
@@ -3572,9 +3561,9 @@ dependencies = [
[[package]]
name = "tauri-runtime-wry"
version = "2.12.2"
version = "2.12.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8d61892587aea2a85245bcaec98c6fe46268874c0a0deae5535fb71ca7b93eae"
checksum = "e1aa9d8b7a120f879f44fdc1053f7b7dbf416bf0bbc6a72b714dec46b782b52f"
dependencies = [
"gtk",
"http",
@@ -3582,7 +3571,6 @@ dependencies = [
"log",
"objc2",
"objc2-app-kit",
"once_cell",
"percent-encoding",
"raw-window-handle",
"softbuffer",
@@ -3627,7 +3615,7 @@ dependencies = [
"serde_with",
"swift-rs",
"thiserror 2.0.18",
"toml 0.9.12+spec-1.1.0",
"toml 1.1.6+spec-1.1.0",
"url",
"urlpattern",
"uuid",
@@ -3652,10 +3640,10 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "32497e9a4c7b38532efcdebeef879707aa9f794296a4f0244f6f69e9bc8574bd"
dependencies = [
"fastrand",
"getrandom 0.3.4",
"getrandom 0.4.2",
"once_cell",
"rustix",
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -4003,7 +3991,7 @@ dependencies = [
"objc2-core-graphics",
"objc2-foundation",
"once_cell",
"png 0.18.1",
"png",
"serde",
"thiserror 2.0.18",
"windows-sys 0.61.2",
@@ -4414,7 +4402,7 @@ version = "0.1.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
dependencies = [
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -4558,15 +4546,6 @@ dependencies = [
"windows-targets 0.52.6",
]
[[package]]
name = "windows-sys"
version = "0.60.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb"
dependencies = [
"windows-targets 0.53.5",
]
[[package]]
name = "windows-sys"
version = "0.61.2"
@@ -4600,30 +4579,13 @@ dependencies = [
"windows_aarch64_gnullvm 0.52.6",
"windows_aarch64_msvc 0.52.6",
"windows_i686_gnu 0.52.6",
"windows_i686_gnullvm 0.52.6",
"windows_i686_gnullvm",
"windows_i686_msvc 0.52.6",
"windows_x86_64_gnu 0.52.6",
"windows_x86_64_gnullvm 0.52.6",
"windows_x86_64_msvc 0.52.6",
]
[[package]]
name = "windows-targets"
version = "0.53.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4945f9f551b88e0d65f3db0bc25c33b8acea4d9e41163edf90dcd0b19f9069f3"
dependencies = [
"windows-link",
"windows_aarch64_gnullvm 0.53.1",
"windows_aarch64_msvc 0.53.1",
"windows_i686_gnu 0.53.1",
"windows_i686_gnullvm 0.53.1",
"windows_i686_msvc 0.53.1",
"windows_x86_64_gnu 0.53.1",
"windows_x86_64_gnullvm 0.53.1",
"windows_x86_64_msvc 0.53.1",
]
[[package]]
name = "windows-threading"
version = "0.2.1"
@@ -4654,12 +4616,6 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
[[package]]
name = "windows_aarch64_gnullvm"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a9d8416fa8b42f5c947f8482c43e7d89e73a173cead56d044f6a56104a6d1b53"
[[package]]
name = "windows_aarch64_msvc"
version = "0.42.2"
@@ -4672,12 +4628,6 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
[[package]]
name = "windows_aarch64_msvc"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b9d782e804c2f632e395708e99a94275910eb9100b2114651e04744e9b125006"
[[package]]
name = "windows_i686_gnu"
version = "0.42.2"
@@ -4690,24 +4640,12 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
[[package]]
name = "windows_i686_gnu"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "960e6da069d81e09becb0ca57a65220ddff016ff2d6af6a223cf372a506593a3"
[[package]]
name = "windows_i686_gnullvm"
version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
[[package]]
name = "windows_i686_gnullvm"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "fa7359d10048f68ab8b09fa71c3daccfb0e9b559aed648a8f95469c27057180c"
[[package]]
name = "windows_i686_msvc"
version = "0.42.2"
@@ -4720,12 +4658,6 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
[[package]]
name = "windows_i686_msvc"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1e7ac75179f18232fe9c285163565a57ef8d3c89254a30685b57d83a38d326c2"
[[package]]
name = "windows_x86_64_gnu"
version = "0.42.2"
@@ -4738,12 +4670,6 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
[[package]]
name = "windows_x86_64_gnu"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9c3842cdd74a865a8066ab39c8a7a473c0778a3f29370b5fd6b4b9aa7df4a499"
[[package]]
name = "windows_x86_64_gnullvm"
version = "0.42.2"
@@ -4756,12 +4682,6 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
[[package]]
name = "windows_x86_64_gnullvm"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0ffa179e2d07eee8ad8f57493436566c7cc30ac536a3379fdf008f47f6bb7ae1"
[[package]]
name = "windows_x86_64_msvc"
version = "0.42.2"
@@ -4774,12 +4694,6 @@ version = "0.52.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
[[package]]
name = "windows_x86_64_msvc"
version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d6bbff5f0aada427a1e5a6da5f1f98158182f26556f345ac9e04d36d0ebed650"
[[package]]
name = "winnow"
version = "0.5.40"
@@ -4913,11 +4827,11 @@ checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4"
[[package]]
name = "wry"
version = "0.57.0"
version = "0.57.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a819957a01b3119af85e638a38d242af76dbc87d130dca67bfd0441072e21ff0"
checksum = "759c50ddad0ef9913bb5496cb9d509a50433a3b78cb0238d61105526589cf0e9"
dependencies = [
"base64 0.22.1",
"base64 0.23.1",
"block2",
"cookie",
"crossbeam-channel",
@@ -4938,7 +4852,6 @@ dependencies = [
"objc2-foundation",
"objc2-ui-kit",
"objc2-web-kit",
"once_cell",
"percent-encoding",
"raw-window-handle",
"sha2",
@@ -5001,7 +4914,7 @@ dependencies = [
[[package]]
name = "yt-desc-gen"
version = "1.3.2"
version = "1.6.0"
dependencies = [
"serde",
"tauri",
+1 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "yt-desc-gen"
version = "1.3.2"
version = "1.6.0"
description = "YouTube Gameplay Description Generator"
authors = ["poli0981"]
edition = "2021"
+2 -1
View File
@@ -1,11 +1,12 @@
{
"identifier": "default",
"description": "Default capabilities for YTDescGen. File access goes through the app's own name-only commands and native dialogs run from Rust, so the webview gets no dialog, fs or shell permissions.",
"description": "Default capabilities for YTDescGen. File access goes through the app's own name-only commands and native dialogs run from Rust, so the webview gets no dialog, fs or shell permissions. set-webview-zoom backs the Ctrl/Cmd +/- zoom polyfill Tauri injects on macOS and Linux (zoomHotkeysEnabled).",
"windows": [
"main"
],
"permissions": [
"core:default",
"core:webview:allow-set-webview-zoom",
"opener:default"
]
}
+1 -1
View File
@@ -1 +1 @@
{"default":{"identifier":"default","description":"Default capabilities for YTDescGen. File access goes through the app's own name-only commands and native dialogs run from Rust, so the webview gets no dialog, fs or shell permissions.","local":true,"windows":["main"],"permissions":["core:default","opener:default"]}}
{"default":{"identifier":"default","description":"Default capabilities for YTDescGen. File access goes through the app's own name-only commands and native dialogs run from Rust, so the webview gets no dialog, fs or shell permissions. set-webview-zoom backs the Ctrl/Cmd +/- zoom polyfill Tauri injects on macOS and Linux (zoomHotkeysEnabled).","local":true,"windows":["main"],"permissions":["core:default","core:webview:allow-set-webview-zoom","opener:default"]}}
+32
View File
@@ -0,0 +1,32 @@
# Qodana for Rust (Early Access): the Tauri 2 shell of the desktop and
# Android apps. Run by .github/workflows/qodana.yml (job `rust`, Docker),
# reported to the Qodana Cloud project yt-rust (secret QODANA_TOKEN_RUST).
version: "1.0"
linter: qodana-rust
profile:
name: qodana.recommended
# The quality gate: any problem fails the job.
failureConditions:
severityThresholds:
any: 0
# The linter evaluates build scripts and expands macros with `cargo check`,
# and its image has neither a C toolchain nor the libraries Tauri links
# against (the same packages rust.yml installs). Needs root in the container:
# the workflow passes `-u root`.
bootstrap: |
apt-get update -qq
DEBIAN_FRONTEND=noninteractive apt-get install -y -qq --no-install-recommends build-essential pkg-config libssl-dev libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev
exclude:
- name: All
paths:
# Cargo's build output, and the Android project `tauri android init`
# generated (Kotlin and Gradle, not Rust).
- target
- gen
# tauri::generate_handler! needs each command's module path
# (`storage::backup_list`): the #[tauri::command] macro puts a hidden
# helper next to the function, and the handler finds it through that
# path. Without the prefix the crate no longer compiles.
- name: RsUnnecessaryQualifications
paths:
- src/lib.rs
+14 -18
View File
@@ -17,6 +17,17 @@ use tauri::{
mod file_dialog;
mod storage;
/// Bring the main window back: show it, restore it if minimized and focus
/// it. Used by a second launch, the tray menu's "Show" and a tray click.
#[cfg(desktop)]
fn show_main_window<R: tauri::Runtime>(app: &tauri::AppHandle<R>) {
if let Some(window) = app.get_webview_window("main") {
let _ = window.show();
let _ = window.unminimize();
let _ = window.set_focus();
}
}
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
// Plugins and commands shared by every platform (desktop + Android).
@@ -62,11 +73,7 @@ pub fn run() {
// in the *first* (already-running) instance when a second launch is
// attempted: we surface its window instead of letting the second 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();
}
show_main_window(app);
}))
.setup(move |app| {
let show = MenuItem::with_id(app, "show", "Show YTDescGen", true, None::<&str>)?;
@@ -83,13 +90,7 @@ pub fn run() {
.tooltip("YTDescGen — YouTube Description Generator")
.menu(&menu)
.on_menu_event(move |app, event| match event.id.as_ref() {
"show" => {
if let Some(window) = app.get_webview_window("main") {
let _ = window.show();
let _ = window.unminimize();
let _ = window.set_focus();
}
}
"show" => show_main_window(app),
"quit" => {
quitting_menu.store(true, Ordering::SeqCst);
app.exit(0);
@@ -103,12 +104,7 @@ pub fn run() {
..
} = event
{
let app = tray.app_handle();
if let Some(window) = app.get_webview_window("main") {
let _ = window.show();
let _ = window.unminimize();
let _ = window.set_focus();
}
show_main_window(tray.app_handle());
}
})
.build(app)?;
+3 -2
View File
@@ -1,7 +1,7 @@
{
"$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-cli/schema.json",
"productName": "YTDescGen",
"version": "1.3.2",
"version": "1.6.0",
"identifier": "com.skullmute.ytdescgen",
"build": {
"beforeBuildCommand": "npm run build",
@@ -20,7 +20,8 @@
"resizable": true,
"maximizable": true,
"fullscreen": false,
"center": true
"center": true,
"zoomHotkeysEnabled": true
}
],
"security": {
+6 -2
View File
@@ -265,6 +265,7 @@ export function EndingsEditor() {
type="number"
min={1}
max={MAX_ENDINGS}
aria-label={t("editor.endings.rowNumberAria", { row: i + 1 })}
value={entry.number?.toString() ?? ""}
onChange={(e) => {
const v = e.target.value.trim();
@@ -275,6 +276,7 @@ export function EndingsEditor() {
<td className="px-2 py-1.5">
<Input
placeholder={t("editor.endings.namePlaceholder")}
aria-label={t("editor.endings.rowNameAria", { row: i + 1 })}
value={entry.name}
onChange={(e) => updateEnding(i, { name: e.target.value })}
/>
@@ -322,8 +324,8 @@ export function EndingsEditor() {
<thead className="bg-surface-2 text-text-muted text-xs uppercase">
<tr>
<th className="px-2 py-1.5 text-left">{t("editor.endings.videoLabel")}</th>
<th className="px-2 py-1.5 text-left">From</th>
<th className="px-2 py-1.5 text-left">To</th>
<th className="px-2 py-1.5 text-left">{t("editor.endings.fromLabel")}</th>
<th className="px-2 py-1.5 text-left">{t("editor.endings.toLabel")}</th>
</tr>
</thead>
<tbody>
@@ -335,6 +337,7 @@ export function EndingsEditor() {
type="number"
min={1}
max={count}
aria-label={t("editor.endings.rangeFromAria", { video: i + 1 })}
value={String(r.from)}
onChange={(e) => updateRange(i, { from: Number(e.target.value) || 1 })}
/>
@@ -344,6 +347,7 @@ export function EndingsEditor() {
type="number"
min={1}
max={count}
aria-label={t("editor.endings.rangeToAria", { video: i + 1 })}
value={String(r.to)}
onChange={(e) => updateRange(i, { to: Number(e.target.value) || 1 })}
/>
+1 -1
View File
@@ -39,7 +39,7 @@ export default function GenreList({
<Command.Input
autoFocus
placeholder={t("editor.genreSearchPlaceholder")}
className="text-text-primary placeholder:text-text-muted h-10 w-full bg-transparent text-sm outline-none"
className="text-text-primary placeholder:text-text-muted h-10 w-full bg-transparent text-sm outline-hidden"
/>
</div>
<Command.List className="max-h-72 scrollbar-thin overflow-y-auto p-1">
+2 -2
View File
@@ -77,14 +77,14 @@ export function GenreSelector() {
{genres.map((id) => (
<span
key={id}
className="bg-accent-muted text-accent inline-flex h-7 items-center gap-1 rounded-full pr-1 pl-2.5 text-xs font-medium"
className="bg-accent-muted text-accent inline-flex h-7 items-center gap-1 rounded-full pr-0.5 pl-2.5 text-xs font-medium"
>
{labelOf(id)}
<button
type="button"
onClick={() => toggle(id)}
aria-label={t("editor.genreRemove", { genre: labelOf(id) })}
className="hover:bg-accent/20 flex size-5 cursor-pointer items-center justify-center rounded-full"
className="hover:bg-accent/20 flex size-6 cursor-pointer items-center justify-center rounded-full pointer-coarse:size-7"
>
<X className="size-3" aria-hidden="true" />
</button>
+1 -1
View File
@@ -55,7 +55,7 @@ export default function GpuList({
<Command.Input
autoFocus
placeholder={t("editor.gpuSearch")}
className="text-text-primary placeholder:text-text-muted h-10 w-full bg-transparent text-sm outline-none"
className="text-text-primary placeholder:text-text-muted h-10 w-full bg-transparent text-sm outline-hidden"
/>
</div>
<Command.List className="max-h-80 scrollbar-thin overflow-y-auto p-1">
+7 -3
View File
@@ -33,6 +33,7 @@ export function LivePreview({
// Without a game name the engine still renders "— Gameplay No Commentary";
// show the prompt instead so nothing half-built can be copied.
const hasGame = useEditorStore((s) => s.gameName.trim() !== "");
const lang = useEditorStore((s) => s.language);
const output = hasGame ? generated : EMPTY_GENERATOR_OUTPUT;
const [tab, setTab] = useState<PreviewTab>("title");
@@ -73,7 +74,7 @@ export function LivePreview({
>
<TabPanel value="title" className="p-4">
{output.title ? (
<p className="text-text-primary text-[0.9375rem] leading-snug font-medium">
<p lang={lang} className="text-text-primary text-[0.9375rem] leading-snug font-medium">
{output.title}
</p>
) : (
@@ -82,7 +83,10 @@ export function LivePreview({
</TabPanel>
<TabPanel value="description" className="p-4">
{output.description ? (
<pre className="text-text-secondary max-h-[min(52dvh,32rem)] scrollbar-thin overflow-y-auto font-sans text-xs leading-relaxed whitespace-pre-wrap">
<pre
lang={lang}
className="text-text-secondary max-h-[min(52dvh,32rem)] scrollbar-thin overflow-y-auto font-sans text-xs leading-relaxed whitespace-pre-wrap"
>
{output.description}
</pre>
) : (
@@ -91,7 +95,7 @@ export function LivePreview({
</TabPanel>
<TabPanel value="tags" className="p-4">
{output.tags.length > 0 ? (
<div className="flex flex-wrap gap-1">
<div lang={lang} className="flex flex-wrap gap-1">
{output.tags.map((tag, i) => (
<span
key={i}
+15 -10
View File
@@ -9,7 +9,6 @@ import { PopoverContent, PopoverRoot, PopoverTrigger } from "@components/ui/Popo
import { Spinner } from "@components/icons/animated";
import {
RIG_FIELDS,
cleanCpuName,
parseCompositeValue,
resolveCompositeOptions,
resolveCompositeLabelKey,
@@ -117,7 +116,7 @@ function GpuPicker({
);
}
/** CPU (and any other suggested text field): type freely or pick a suggestion. */
/** CPU, LUT (any suggested text field): type freely or pick a suggestion. */
function SuggestedTextField({
field,
value,
@@ -139,10 +138,11 @@ function SuggestedTextField({
list={listId}
autoComplete="off"
onChange={(e) => onChange(e.target.value)}
// "Intel(R) Core(TM) i7-12700K CPU @ 3.60GHz", as Windows shows it,
// becomes "Intel Core i7-12700K" once the user leaves the field.
// The field's own tidy-up once the user leaves it: Windows' "Intel(R)
// Core(TM) i7-12700K CPU @ 3.60GHz" becomes "Intel Core i7-12700K",
// a pasted "Rec709 Kodak 2383 D65.cube" loses its extension.
onBlur={(e) => {
const cleaned = field.id === "cpu" ? cleanCpuName(e.target.value) : e.target.value.trim();
const cleaned = field.clean ? field.clean(e.target.value) : e.target.value.trim();
if (cleaned !== e.target.value) onChange(cleaned);
}}
/>
@@ -293,12 +293,10 @@ export function RigEditor() {
}
if (field.type === "composite_dropdown") return renderComposite(field);
if (field.type === "dropdown_with_version") return renderDropdownWithVersion(field);
if (field.suggestions) {
return <SuggestedTextField key={field.id} field={field} value={value} onChange={set} />;
}
return (
const input = field.suggestions ? (
<SuggestedTextField field={field} value={value} onChange={set} />
) : (
<Input
key={field.id}
label={t(field.labelKey)}
maxLength={FIELD_LIMITS.SHORT_NAME}
placeholder={field.placeholder}
@@ -306,6 +304,13 @@ export function RigEditor() {
onChange={(e) => set(e.target.value)}
/>
);
// A wide field (the LUT) takes the whole row, right under the
// Video Editor row it belongs to.
return (
<div key={field.id} className={clsx("min-w-0", field.wide && "sm:col-span-2")}>
{input}
</div>
);
})}
</div>
</div>
+64 -9
View File
@@ -9,28 +9,27 @@ import {
RT_MODES,
FRAMEGEN_VENDORS,
ART_STYLES,
VIDEO_RESOLUTIONS,
type GraphicsPreset,
type RTMode,
type FrameGenVendor,
type FrameGenMultiplier,
type UpscaleQuality,
type ArtStyle,
type UpscaledFrom,
} from "@config/graphics-settings";
import {
getValidUpscaleQualities,
getValidFrameGenMultipliers,
coerceUpscaleQuality,
coerceFrameGenMultiplier,
coerceDlssNeuralRendering,
} from "@engine/graphics-vendor";
import { upscaleSourcesFor, validUpscaleSource } from "@engine/upscale";
import { VIDEO_STYLE_ERA_IDS, type VideoStyleEra } from "@config/video-styles";
import { FIELD_LIMITS } from "@config/field-limits";
const RESOLUTION_OPTIONS = [
{ value: "720p", label: "720p" },
{ value: "1080p", label: "1080p" },
{ value: "1440p", label: "1440p" },
{ value: "4K", label: "4K" },
];
const RESOLUTION_OPTIONS = VIDEO_RESOLUTIONS.map((r) => ({ value: r, label: r }));
const FPS_OPTIONS = [
{ value: "30", label: "30 FPS" },
@@ -103,6 +102,32 @@ export function VideoSettingsForm() {
if (coercedQ !== store.upscaleQuality) store.set("upscaleQuality", coercedQ);
const coercedM = coerceFrameGenMultiplier(next, store.frameGenMultiplier);
if (coercedM !== store.frameGenMultiplier) store.set("frameGenMultiplier", coercedM);
// v1.6.0: DLSS 5 Neural Rendering is NVIDIA's; its switch hides for
// other vendors, so it turns off rather than linger unseen.
const coercedNeural = coerceDlssNeuralRendering(next, store.dlssNeuralRendering);
if (coercedNeural !== store.dlssNeuralRendering) {
store.set("dlssNeuralRendering", coercedNeural);
}
}
// v1.5.0: "Upscaled from" lists only resolutions below the video's own.
// A stale pair (an older profile applied over a 4K draft, say) shows as
// "Not upscaled" — the engine ignores it too.
const resolution = store.resolution ?? "1080p";
const upscaledFrom = validUpscaleSource(resolution, store.upscaledFrom);
const upscaleSources = upscaleSourcesFor(resolution);
const upscaledFromOptions = [
{ value: "", label: t("editor.upscaledFromNone") },
...upscaleSources.map((r) => ({ value: r, label: r })),
];
// Lowering the resolution to or below the upscale source ends the upscale,
// so the draft never keeps a pair the Select can't show.
function handleResolutionChange(next: string) {
store.set("resolution", next);
if (store.upscaledFrom && !validUpscaleSource(next, store.upscaledFrom)) {
store.set("upscaledFrom", "");
}
}
const artStyleOptions = ART_STYLES.map((s) => ({
@@ -112,12 +137,19 @@ export function VideoSettingsForm() {
return (
<div className="flex flex-col gap-3">
<div className="grid grid-cols-1 gap-3 sm:grid-cols-3">
<div className="grid grid-cols-1 gap-3 sm:grid-cols-2 xl:grid-cols-4">
<Select
label={t("editor.resolution")}
options={RESOLUTION_OPTIONS}
value={store.resolution ?? "1080p"}
onChange={(v) => store.set("resolution", v)}
value={resolution}
onChange={handleResolutionChange}
/>
<Select
label={t("editor.upscaledFrom")}
options={upscaledFromOptions}
value={upscaledFrom}
disabled={upscaleSources.length === 0}
onChange={(v) => store.set("upscaledFrom", v as UpscaledFrom)}
/>
<Select
label={t("editor.fps")}
@@ -132,6 +164,9 @@ export function VideoSettingsForm() {
onChange={(v) => store.set("graphicsPreset", v as GraphicsPreset)}
/>
</div>
{upscaledFrom && (
<p className="text-text-muted -mt-1 text-xs">{t("editor.upscaledFromHelp")}</p>
)}
{store.graphicsPreset === "custom" && (
<Input
@@ -183,6 +218,17 @@ export function VideoSettingsForm() {
/>
</div>
{/* v1.6.0: "Custom…" frame generation, printed as typed. */}
{store.frameGenMultiplier === "custom" && (
<Input
label={t("editor.frameGenCustom")}
maxLength={FIELD_LIMITS.LABEL}
placeholder={t("editor.frameGenCustomPlaceholder")}
value={store.frameGenCustom}
onChange={(e) => store.set("frameGenCustom", e.target.value)}
/>
)}
<div className="grid gap-3 sm:grid-cols-2">
<Select
label={t("editor.upscaleQuality")}
@@ -198,6 +244,15 @@ export function VideoSettingsForm() {
/>
</div>
{/* v1.6.0: DLSS 5 Neural Rendering — NVIDIA (RTX 50 series) only. */}
{store.frameGenVendor === "nvidia" && (
<Toggle
label={t("editor.dlssNeuralRendering")}
checked={store.dlssNeuralRendering}
onChange={(v) => store.set("dlssNeuralRendering", v)}
/>
)}
<Input
label={t("editor.versionInfo")}
maxLength={FIELD_LIMITS.LABEL}
@@ -88,6 +88,7 @@ export function VietnameseDonateEditor() {
/>
{customMode && (
<Input
aria-label={t("editor.vnBankName")}
placeholder={t("editor.vnBankNamePlaceholder")}
value={vnBankName ?? ""}
onChange={(e) => store.set("vnBankName", e.target.value)}
+1 -1
View File
@@ -47,7 +47,7 @@ export function OfflineBanner() {
type="button"
onClick={() => setDismissed(true)}
aria-label={t("common.dismiss")}
className="text-text-muted hover:bg-surface-2 hover:text-text-primary flex size-7 shrink-0 cursor-pointer items-center justify-center rounded-full transition-colors"
className="text-text-muted hover:bg-surface-2 hover:text-text-primary flex size-7 shrink-0 cursor-pointer items-center justify-center rounded-full transition-colors pointer-coarse:size-9"
>
<X className="size-3.5" aria-hidden="true" />
</button>
+8 -2
View File
@@ -36,7 +36,10 @@ export function HistoryCard({ entry }: { entry: HistoryEntry }) {
<Icon className="size-4" aria-hidden />
</span>
<span className="min-w-0 flex-1">
<span className="text-text-primary block truncate text-sm font-medium">
<span
lang={entry.language}
className="text-text-primary block truncate text-sm font-medium"
>
{entry.title}
</span>
<span className="text-text-muted mt-0.5 block truncate text-xs">
@@ -75,7 +78,10 @@ export function HistoryCard({ entry }: { entry: HistoryEntry }) {
<CopyButton text={entry.description} label={t("output.copyDescription")} />
<CopyButton text={entry.tags} label={t("output.copyTags")} />
</div>
<pre className="bg-surface-0 border-border text-text-secondary max-h-56 scrollbar-thin overflow-y-auto rounded-lg border p-2.5 font-sans text-xs leading-relaxed whitespace-pre-wrap">
<pre
lang={entry.language}
className="bg-surface-0 border-border text-text-secondary max-h-56 scrollbar-thin overflow-y-auto rounded-lg border p-2.5 font-sans text-xs leading-relaxed whitespace-pre-wrap"
>
{entry.description}
</pre>
</div>
+3 -1
View File
@@ -5,6 +5,7 @@ import { Header } from "./Header";
import { Sidebar, NavList, NavFooterLinks } from "./Sidebar";
import { MobileNav } from "./MobileNav";
import { ScrollToTopButton } from "./ScrollToTopButton";
import { RouteAnnouncer } from "./RouteAnnouncer";
import { Drawer } from "@components/ui/Drawer";
import { useKeyboardShortcuts, type ShortcutHandlers } from "@hooks/use-keyboard-shortcuts";
import { useGlobalErrorHandler } from "@hooks/use-global-error-handler";
@@ -77,7 +78,7 @@ export function AppShell() {
e.preventDefault();
mainRef.current?.focus();
}}
className="bg-accent text-accent-fg rounded-control sr-only z-[60] px-3 py-2 text-sm font-medium focus:not-sr-only focus:fixed focus:top-2 focus:left-2"
className="bg-accent-solid text-accent-fg rounded-control sr-only z-[60] px-3 py-2 text-sm font-medium focus:not-sr-only focus:fixed focus:top-2 focus:left-2"
>
{t("nav.skipToContent")}
</a>
@@ -96,6 +97,7 @@ export function AppShell() {
<Outlet />
</main>
<ScrollToTopButton scrollRef={mainRef} />
<RouteAnnouncer />
</div>
<MobileNav onOpenMore={() => setMoreOpen(true)} moreActive={moreOpen} />
</div>
+1 -1
View File
@@ -98,7 +98,7 @@ function PaletteBody({
<Command.Input
autoFocus
placeholder={t("command.placeholder")}
className="text-text-primary placeholder:text-text-muted h-12 w-full bg-transparent text-sm outline-none"
className="text-text-primary placeholder:text-text-muted h-12 w-full bg-transparent text-sm outline-hidden"
/>
<Kbd>Esc</Kbd>
</div>
+54
View File
@@ -0,0 +1,54 @@
import { useEffect, useRef, useState } from "react";
import { useLocation } from "react-router-dom";
import { PAGE_TITLE_EVENT } from "@hooks/use-document-title";
/** A navigation whose page never names itself stops waiting after this long. */
const PENDING_MS = 5000;
/**
* Tells screen readers which page a navigation opened. A single-page app
* swaps the content without loading a page, so nothing is announced on its
* own. Focus stays where it was (on the link that was used), so keyboard users
* carry on from there.
*
* Every page names itself through useDocumentTitle, which fires
* PAGE_TITLE_EVENT — after the commit's effects, so a page rendered in the
* same commit as the path change is heard, and a lazy page is heard once its
* chunk arrives and it renders. A title change with no navigation behind it
* (switching the interface language) stays silent.
*/
export function RouteAnnouncer() {
const { pathname } = useLocation();
const [message, setMessage] = useState("");
const pending = useRef(false);
const lastPath = useRef(pathname);
useEffect(() => {
const onTitle = (event: Event) => {
if (!pending.current || !(event instanceof CustomEvent)) return;
if (typeof event.detail !== "string") return;
pending.current = false;
setMessage(event.detail);
};
window.addEventListener(PAGE_TITLE_EVENT, onTitle);
return () => window.removeEventListener(PAGE_TITLE_EVENT, onTitle);
}, []);
useEffect(() => {
// The first page is announced by the browser's own page load (and
// Strict Mode's second run of this effect must not count as a visit).
if (pathname === lastPath.current) return;
lastPath.current = pathname;
pending.current = true;
const timer = window.setTimeout(() => {
pending.current = false;
}, PENDING_MS);
return () => window.clearTimeout(timer);
}, [pathname]);
return (
<div role="status" aria-live="polite" aria-atomic="true" className="sr-only">
{message}
</div>
);
}
+2 -2
View File
@@ -79,14 +79,14 @@ export function LogEntryCard({ entry }: { entry: LogEntryType }) {
label={t("logs.copyEntry")}
size="icon-sm"
onClick={handleCopy}
className="size-7"
className="size-7 pointer-coarse:size-9"
>
<CopyStateIcon copied={copied} className="size-3.5" />
</IconButton>
<IconButton
label={t("logs.deleteEntry")}
size="icon-sm"
className="hover:text-danger size-7"
className="hover:text-danger size-7 pointer-coarse:size-9"
onClick={() => deleteEntry(entry.id)}
>
<Trash2 className="size-3.5" />
+1 -1
View File
@@ -98,7 +98,7 @@ export function OutputExtras() {
icon={MessageSquareText}
actions={<CopyButton text={templateText} label={t("output.copyPinnedCommentTemplate")} />}
>
<OutputText>{templateText}</OutputText>
<OutputText lang={input.language}>{templateText}</OutputText>
</OutputField>
)}
</div>
+14 -2
View File
@@ -24,10 +24,22 @@ export function OutputField({ title, icon: Icon, actions, children }: OutputFiel
);
}
/** Pre-formatted generated text, scrollable when long. */
export function OutputText({ children, tall }: { children: ReactNode; tall?: boolean }) {
/**
* Pre-formatted generated text, scrollable when long. `lang` is the language
* the text was generated in, so a screen reader reads it with that voice.
*/
export function OutputText({
children,
tall,
lang,
}: {
children: ReactNode;
tall?: boolean;
lang?: string;
}) {
return (
<pre
lang={lang}
className={
tall
? "bg-surface-0 border-border text-text-secondary max-h-[60dvh] scrollbar-thin overflow-y-auto rounded-lg border p-3 font-sans text-sm leading-relaxed whitespace-pre-wrap sm:max-h-[28rem]"
+21 -5
View File
@@ -1,12 +1,13 @@
import { useTranslation } from "react-i18next";
import { FileText, Tags, Type } from "lucide-react";
import { useGeneratedOutput } from "@hooks/use-generated-output";
import { useEditorStore } from "@store/editor-store";
import { useSettingsStore } from "@store/settings-store";
import { CopyButton } from "./CopyButton";
import { CharCounter } from "./CharCounter";
import { OutputField, OutputText } from "./OutputField";
import { YT_LIMITS } from "@engine/types";
import type { GeneratorOutput } from "@engine/types";
import type { GeneratorOutput, SupportedLanguage } from "@engine/types";
import type { OutputLimitStatus } from "@engine/limits";
import { useCopyGate } from "@hooks/use-copy-gate";
@@ -16,19 +17,26 @@ interface OutputPreviewProps {
status: OutputLimitStatus;
/** Strict Mode is blocking: nothing can be copied. */
strictBlocked?: boolean;
/** Language of `output` (the draft's output language when omitted). */
lang?: SupportedLanguage;
}
export function OutputPreview({
output: outputProp,
status,
strictBlocked = false,
lang: langProp,
}: OutputPreviewProps) {
const { t } = useTranslation("ui");
const gate = useCopyGate(status, strictBlocked);
const defaultOutput = useGeneratedOutput();
const showCharCount = useSettingsStore((s) => s.showCharCount);
const compactTagDisplay = useSettingsStore((s) => s.compactTagDisplay);
const draftLanguage = useEditorStore((s) => s.language);
const output = outputProp ?? defaultOutput;
// The cards' headings are interface text; only the generated text itself
// carries the output language.
const lang = langProp ?? draftLanguage;
return (
<div className="flex flex-col gap-4">
@@ -48,7 +56,10 @@ export function OutputPreview({
</>
}
>
<p className="bg-surface-0 border-border text-text-primary rounded-lg border p-3 text-[0.9375rem] font-medium">
<p
lang={lang}
className="bg-surface-0 border-border text-text-primary rounded-lg border p-3 text-[0.9375rem] font-medium"
>
{output.title || "…"}
</p>
</OutputField>
@@ -71,7 +82,9 @@ export function OutputPreview({
</>
}
>
<OutputText tall>{output.description || "…"}</OutputText>
<OutputText tall lang={lang}>
{output.description || "…"}
</OutputText>
</OutputField>
<OutputField
@@ -96,11 +109,14 @@ export function OutputPreview({
}
>
{compactTagDisplay ? (
<p className="bg-surface-0 border-border text-text-secondary rounded-lg border p-3 text-xs leading-relaxed">
<p
lang={lang}
className="bg-surface-0 border-border text-text-secondary rounded-lg border p-3 text-xs leading-relaxed"
>
{output.tagString}
</p>
) : (
<div className="flex flex-wrap gap-1.5">
<div lang={lang} className="flex flex-wrap gap-1.5">
{output.tags.map((tag, i) => (
<span
key={i}
+17 -4
View File
@@ -16,6 +16,8 @@ interface YouTubePreviewProps {
description: string;
channelName: string;
gameName: string;
/** Language the title and description were generated in. */
lang?: string;
}
/**
@@ -23,7 +25,13 @@ interface YouTubePreviewProps {
* search result and above the watch page's "…more". Most viewers never see
* anything past those points, so this is where the important words must go.
*/
export function YouTubePreview({ title, description, channelName, gameName }: YouTubePreviewProps) {
export function YouTubePreview({
title,
description,
channelName,
gameName,
lang,
}: YouTubePreviewProps) {
const { t } = useTranslation("ui");
const titleCut = title.length > SEARCH_TITLE_CHARS;
const descriptionCut = description.length > FOLD_DESCRIPTION_CHARS;
@@ -51,18 +59,23 @@ export function YouTubePreview({ title, description, channelName, gameName }: Yo
</span>
</div>
<div className="min-w-0 flex-1">
<p className="text-text-primary line-clamp-2 text-base leading-snug font-semibold">
<p
lang={lang}
className="text-text-primary line-clamp-2 text-base leading-snug font-semibold"
>
{title || "…"}
</p>
<p className="text-text-muted mt-1 text-xs">{channel}</p>
<p className="text-text-muted mt-2 line-clamp-2 text-xs leading-relaxed">{description}</p>
<p lang={lang} className="text-text-muted mt-2 line-clamp-2 text-xs leading-relaxed">
{description}
</p>
</div>
</div>
{/* Watch page, above "…more" */}
<div className="border-border bg-surface-0/60 mx-4 mb-4 rounded-xl border p-3">
<p className="text-text-secondary text-xs leading-relaxed whitespace-pre-line">
{fold || "…"}
<span lang={lang}>{fold || "…"}</span>
{descriptionCut && (
<span className="text-text-primary font-semibold">
{" "}
+2 -2
View File
@@ -1,4 +1,4 @@
import { useId, useState, type FormEvent } from "react";
import { useId, useState, type SubmitEvent } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { Modal } from "@components/ui/Modal";
@@ -35,7 +35,7 @@ function PresetSaveFormBody({ onClose, editPreset }: PresetSaveFormProps) {
);
const [fromEditor, setFromEditor] = useState(false);
const save = (e: FormEvent) => {
const save = (e: SubmitEvent) => {
e.preventDefault();
const fields = presetFieldsFromEditor(editorDataOf(useEditorStore.getState()));
const name = gameName.trim() || fields.gameName.trim() || t("presets.unnamed");
+2 -2
View File
@@ -1,4 +1,4 @@
import { useId, useState, type FormEvent } from "react";
import { useId, useState, type SubmitEvent } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { Modal } from "@components/ui/Modal";
@@ -38,7 +38,7 @@ function ProfileSaveFormBody({ onClose, editProfile }: ProfileSaveFormProps) {
);
const [fromEditor, setFromEditor] = useState(false);
const save = (e: FormEvent) => {
const save = (e: SubmitEvent) => {
e.preventDefault();
const fields = profileFieldsFromEditor(editorDataOf(useEditorStore.getState()));
const finalName = name.trim() || fields.channelName.trim() || t("profiles.unnamed");
@@ -1,4 +1,4 @@
import { useId, useState, type FormEvent } from "react";
import { useId, useState, type SubmitEvent } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { Modal } from "@components/ui/Modal";
@@ -32,7 +32,7 @@ function TemplateSaveFormBody({ onClose, editTemplate }: TemplateSaveFormProps)
const [name, setName] = useState(editTemplate?.name ?? "");
const [fromEditor, setFromEditor] = useState(false);
const save = (e: FormEvent) => {
const save = (e: SubmitEvent) => {
e.preventDefault();
const snapshot = structuredClone(editorDataOf(useEditorStore.getState()));
const finalName = name.trim() || snapshot.gameName.trim() || t("templates.unnamed");
+2 -2
View File
@@ -29,7 +29,8 @@ interface AccordionProps {
export function Accordion({
id,
title,
icon,
// Capitalised so JSX reads it as a component, not an HTML tag.
icon: Icon,
summary,
badge,
open,
@@ -37,7 +38,6 @@ export function Accordion({
children,
}: AccordionProps) {
const panelId = `section-${id}-panel`;
const Icon = icon;
return (
<section
id={`section-${id}`}
+1 -1
View File
@@ -58,7 +58,7 @@ export function Banner({
type="button"
onClick={onDismiss}
aria-label={dismissLabel}
className="-m-1 flex size-6 shrink-0 cursor-pointer items-center justify-center rounded-md opacity-70 hover:opacity-100"
className="-m-1 flex size-6 shrink-0 cursor-pointer items-center justify-center rounded-md opacity-70 hover:opacity-100 pointer-coarse:size-9"
>
<X className="size-3.5" aria-hidden="true" />
</button>
+2 -2
View File
@@ -17,13 +17,13 @@ export interface ButtonProps extends ComponentProps<"button"> {
}
const VARIANTS: Record<ButtonVariant, string> = {
primary: "bg-accent text-accent-fg shadow-sm hover:bg-accent-hover",
primary: "bg-accent-solid text-accent-fg shadow-sm hover:bg-accent-solid-hover",
brand: "bg-brand-gradient text-white shadow-sm hover:brightness-110",
secondary:
"border border-border bg-surface-2 text-text-primary hover:border-border-strong hover:bg-surface-3",
outline: "border border-border text-text-primary hover:bg-surface-2",
ghost: "text-text-secondary hover:bg-surface-2 hover:text-text-primary",
danger: "bg-danger text-white shadow-sm hover:brightness-110",
danger: "bg-danger-solid text-white shadow-sm hover:bg-danger-solid-hover",
};
const SIZES: Record<ButtonSize, string> = {
+1 -1
View File
@@ -63,7 +63,7 @@ export function Drawer({
{title}
</Dialog.Title>
<Dialog.Close
className="text-text-muted hover:bg-surface-2 hover:text-text-primary flex size-8 cursor-pointer items-center justify-center rounded-lg"
className="text-text-muted hover:bg-surface-2 hover:text-text-primary flex size-8 cursor-pointer items-center justify-center rounded-lg pointer-coarse:size-10"
aria-label={t("common.close")}
>
<X className="size-4" aria-hidden="true" />
+3 -1
View File
@@ -68,7 +68,9 @@ export const controlClasses = (invalid: boolean) =>
clsx(
"w-full min-w-0 rounded-control border bg-surface-1 px-3 text-text-primary",
"placeholder:text-text-muted transition-[border-color,box-shadow] duration-150",
"focus:outline-none focus-visible:outline-none focus:ring-3 focus:ring-accent/25",
// `outline-hidden`, not `outline-none`: Windows High Contrast drops the
// ring, and this keeps a transparent outline there that it paints instead.
"focus:outline-hidden focus-visible:outline-hidden focus:ring-3 focus:ring-accent/25",
"disabled:cursor-not-allowed disabled:opacity-55",
invalid
? "border-danger focus:border-danger"
+1 -1
View File
@@ -80,7 +80,7 @@ export function Modal({
)}
</div>
<Dialog.Close
className="text-text-muted hover:bg-surface-2 hover:text-text-primary -m-1.5 flex size-8 shrink-0 cursor-pointer items-center justify-center rounded-lg transition-colors"
className="text-text-muted hover:bg-surface-2 hover:text-text-primary -m-1.5 flex size-8 shrink-0 cursor-pointer items-center justify-center rounded-lg transition-colors pointer-coarse:size-10"
aria-label={t("common.close")}
>
<X className="size-4" aria-hidden="true" />
+10 -4
View File
@@ -1,6 +1,7 @@
import { useMemo, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { Search } from "lucide-react";
import { useSettingsStore } from "@store/settings-store";
import { Modal } from "./Modal";
import { ShortcutKeys, keyName } from "./Badge";
@@ -16,6 +17,8 @@ const SHORTCUTS = [
{ keys: ["mod", "shift", "C"], labelKey: "shortcuts.copyAll" },
{ keys: ["mod", "S"], labelKey: "shortcuts.saveToHistory" },
{ keys: ["mod", "B"], labelKey: "shortcuts.toggleSidebar" },
// sonner's hotkey: focuses the notifications while any are on screen.
{ keys: ["alt", "T"], labelKey: "shortcuts.notifications" },
{ keys: ["mod", "/"], labelKey: "shortcuts.help" },
{ keys: ["?"], labelKey: "shortcuts.help" },
{ keys: ["esc"], labelKey: "shortcuts.close" },
@@ -24,6 +27,7 @@ const SHORTCUTS = [
export function ShortcutHelpModal({ open, onClose }: ShortcutHelpModalProps) {
const { t } = useTranslation("ui");
const [query, setQuery] = useState("");
const singleKey = useSettingsStore((s) => s.singleKeyShortcuts);
// The search box gets focus when the modal opens (through Radix, not an
// `autoFocus` attribute).
const searchRef = useRef<HTMLInputElement>(null);
@@ -34,14 +38,16 @@ export function ShortcutHelpModal({ open, onClose }: ShortcutHelpModalProps) {
const activeQuery = open ? query : "";
const filtered = useMemo(() => {
// The bare `?` row goes when Settings turned single-key shortcuts off.
const available = singleKey ? SHORTCUTS : SHORTCUTS.filter((s) => s.keys[0] !== "?");
const trimmed = activeQuery.trim().toLowerCase();
if (!trimmed) return SHORTCUTS;
return SHORTCUTS.filter((s) => {
if (!trimmed) return available;
return available.filter((s) => {
const label = t(s.labelKey).toLowerCase();
const keys = s.keys.map(keyName).join(" ").toLowerCase();
return label.includes(trimmed) || keys.includes(trimmed);
});
}, [activeQuery, t]);
}, [activeQuery, singleKey, t]);
return (
<Modal
@@ -61,7 +67,7 @@ export function ShortcutHelpModal({ open, onClose }: ShortcutHelpModalProps) {
onChange={(e) => setQuery(e.target.value)}
placeholder={t("shortcuts.searchPlaceholder")}
aria-label={t("shortcuts.searchPlaceholder")}
className="text-text-primary placeholder:text-text-muted w-full bg-transparent text-sm outline-none"
className="text-text-primary placeholder:text-text-muted w-full bg-transparent text-sm outline-hidden"
/>
</label>
{filtered.length === 0 ? (
+6 -1
View File
@@ -1,3 +1,4 @@
import { useTranslation } from "react-i18next";
import { Toaster as Sonner } from "sonner";
import { useSettingsStore } from "@store/settings-store";
@@ -8,21 +9,25 @@ import { useSettingsStore } from "@store/settings-store";
* floating elements.
*/
export function Toaster() {
const { t } = useTranslation("ui");
const theme = useSettingsStore((s) => s.theme);
return (
<Sonner
theme={theme}
position="bottom-center"
closeButton
// sonner's own labels are English ("Notifications alt+T", "Close toast").
customAriaLabel={t("common.notificationsRegion")}
// globals.css switches this at the md breakpoint, where the bar goes.
offset={{ bottom: "var(--toast-offset-bottom)" }}
mobileOffset={{ bottom: "var(--toast-offset-bottom)" }}
toastOptions={{
closeButtonAriaLabel: t("common.closeNotification"),
classNames: {
toast:
"!bg-surface-1 !border-border !text-text-primary !rounded-card !shadow-pop !font-sans",
description: "!text-text-secondary",
actionButton: "!bg-accent !text-accent-fg !rounded-lg !font-medium",
actionButton: "!bg-accent-solid !text-accent-fg !rounded-lg !font-medium",
cancelButton: "!bg-surface-2 !text-text-secondary !rounded-lg",
closeButton: "!bg-surface-2 !border-border !text-text-secondary",
},
+10
View File
@@ -7,6 +7,7 @@ import type {
FrameGenMultiplier,
UpscaleQuality,
ArtStyle,
UpscaledFrom,
} from "./graphics-settings";
import type { VideoStyleEra } from "./video-styles";
import { DEFAULT_GACHA_QUEST_TYPE, type GachaQuestType } from "./gacha-quest-types";
@@ -56,6 +57,8 @@ export interface EditorDefaults {
/** Gacha-quest game version label (v0.13) — e.g. "1.2", "2.4". Only used for `gacha_quest` videoType. */
gachaVersion: string;
resolution: string;
/** v1.5.0: recorded at this resolution, upscaled to `resolution` in the editor. "" = not upscaled. */
upscaledFrom: UpscaledFrom;
fps: string;
graphicsPreset: GraphicsPreset;
graphicsPresetCustom: string;
@@ -63,7 +66,11 @@ export interface EditorDefaults {
rayTracingModes: RTMode[];
frameGenVendor: FrameGenVendor;
frameGenMultiplier: FrameGenMultiplier;
/** v1.6.0: the frame generation as typed, when the multiplier is `"custom"`. */
frameGenCustom: string;
upscaleQuality: UpscaleQuality;
/** v1.6.0: NVIDIA DLSS 5 Neural Rendering (NVIDIA only). */
dlssNeuralRendering: boolean;
artStyle: ArtStyle;
/** v0.22.0 opt-in. Empty string = no style line in the description. */
videoStyleEra: VideoStyleEra;
@@ -194,6 +201,7 @@ export const DEFAULTS = {
anniversaryYear: null,
gachaVersion: "",
resolution: "1080p",
upscaledFrom: "",
fps: "60",
graphicsPreset: "medium",
graphicsPresetCustom: "",
@@ -201,7 +209,9 @@ export const DEFAULTS = {
rayTracingModes: [],
frameGenVendor: "none",
frameGenMultiplier: "none",
frameGenCustom: "",
upscaleQuality: "none",
dlssNeuralRendering: false,
artStyle: "none",
videoStyleEra: "" satisfies VideoStyleEra,
versionInfo: "",
+32 -5
View File
@@ -1,5 +1,26 @@
import type { GenreId } from "./genres";
/**
* The video's resolution — the uploaded file's, which is what the title badge,
* the quality tags and the description's "Video:" line name. Lowest first, so
* an index comparison tells which of two is higher.
*/
export const VIDEO_RESOLUTIONS = ["720p", "1080p", "1440p", "4K"] as const;
/**
* v1.5.0: the resolution the footage was recorded at when it was upscaled to
* {@link VIDEO_RESOLUTIONS} in the video editor (e.g. 1440p → 4K). `""` = not
* upscaled. Only a value below the video's resolution counts — the engine
* ignores any other pair (see `@engine/upscale`).
*/
export const UPSCALED_FROM_OPTIONS = ["", "720p", "1080p", "1440p"] as const;
export type UpscaledFrom = (typeof UPSCALED_FROM_OPTIONS)[number];
/** Type guard so the migration and patches can drop values from elsewhere. */
export function isUpscaledFrom(value: unknown): value is UpscaledFrom {
return typeof value === "string" && (UPSCALED_FROM_OPTIONS as readonly string[]).includes(value);
}
/**
* Graphics-quality preset ladder. Mirrors the most common in-game preset
* names across Unreal/Unity/proprietary engines. `"custom"` reveals a
@@ -39,12 +60,18 @@ 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.
* Frame-generation multiplier — DLSS 4 supports up to x4 and DLSS 4.5 adds
* x6 and Dynamic Multi Frame Generation (`"dynamic"`, which picks the
* multiplier itself), FSR 3 goes 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.
*
* v1.6.0: `"custom"` reveals a free-form text field (`frameGenCustom`),
* printed as typed — the same escape hatch as the graphics preset's, for
* modes the list doesn't name (a driver-level or third-party frame
* generator, a newer multiplier).
*/
export const FRAMEGEN_MULTIPLIERS = ["none", "x2", "x3", "x4", "x6"] as const;
export const FRAMEGEN_MULTIPLIERS = ["none", "x2", "x3", "x4", "x6", "dynamic", "custom"] as const;
export type FrameGenMultiplier = (typeof FRAMEGEN_MULTIPLIERS)[number];
/**
+8
View File
@@ -20,6 +20,7 @@ export type LegalDocId =
| "license"
| "third-party"
| "security"
| "accessibility"
| "notice"
| "conduct";
@@ -54,6 +55,13 @@ export const LEGAL_DOCS: readonly LegalDoc[] = [
consent: false,
},
{ id: "security", labelKey: "legal.docs.security", source: "SECURITY.md", consent: false },
{
id: "accessibility",
labelKey: "legal.docs.accessibility",
source: "ACCESSIBILITY.md",
sourceVi: "docs/i18n/vi/ACCESSIBILITY.md",
consent: false,
},
{ id: "notice", labelKey: "legal.docs.notice", source: "NOTICE", consent: false },
{ id: "conduct", labelKey: "legal.docs.conduct", source: "CODE_OF_CONDUCT.md", consent: false },
];
+1
View File
@@ -18,6 +18,7 @@ export const PROFILE_FIELDS = [
"social",
"rig",
"resolution",
"upscaledFrom",
"fps",
"graphicsPreset",
"graphicsPresetCustom",
+14 -14
View File
@@ -46,7 +46,7 @@ export const PLATFORMS: readonly PlatformConfig[] = [
// /app/, /sub/ (package) or /bundle/ + <digits>, optionally followed by
// /<slug>; or the s.team/a/<digits> short link.
urlPattern:
/^https:\/\/(?:store\.steampowered\.com\/(?:app|sub|bundle)\/\d+(?:\/[^\s]*)?|s\.team\/a\/\d+\/?)$/i,
/^https:\/\/(?:store\.steampowered\.com\/(?:app|sub|bundle)\/\d+(?:\/\S*)?|s\.team\/a\/\d+\/?)$/i,
normalize: normalizeSteamUrl,
},
{
@@ -54,14 +54,14 @@ export const PLATFORMS: readonly PlatformConfig[] = [
tagName: "Epic Games",
label: "Epic Games Store",
urlPrefix: "https://store.epicgames.com/",
urlPattern: /^https:\/\/(?:store\.epicgames\.com|www\.epicgames\.com\/store)\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:store\.epicgames\.com|www\.epicgames\.com\/store)\/\S+$/i,
},
{
id: "ps",
tagName: "PlayStation",
label: "PlayStation Store",
urlPrefix: "https://store.playstation.com/",
urlPattern: /^https:\/\/store\.playstation\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/store\.playstation\.com\/\S+$/i,
},
{
id: "xbox",
@@ -70,7 +70,7 @@ export const PLATFORMS: readonly PlatformConfig[] = [
urlPrefix: "https://www.xbox.com/games/",
// xbox.com (with or without www) and the Microsoft Store web pages.
urlPattern:
/^https:\/\/(?:(?:www\.)?xbox\.com|apps\.microsoft\.com|www\.microsoft\.com\/[a-z-]*\/?store)\/[^\s]*$/i,
/^https:\/\/(?:(?:www\.)?xbox\.com|apps\.microsoft\.com|www\.microsoft\.com\/[a-z-]*\/?store)\/\S*$/i,
},
{
id: "nintendo",
@@ -80,14 +80,14 @@ export const PLATFORMS: readonly PlatformConfig[] = [
// Every regional site: nintendo.com/us/…, nintendo.co.uk, nintendo.de,
// store.nintendo.co.uk, nintendo.co.jp …
urlPattern:
/^https:\/\/(?:[a-z0-9-]+\.)*nintendo\.(?:com|co\.[a-z]{2}|com\.[a-z]{2}|[a-z]{2})\/[^\s]+$/i,
/^https:\/\/(?:[a-z0-9-]+\.)*nintendo\.(?:com|co\.[a-z]{2}|com\.[a-z]{2}|[a-z]{2})\/\S+$/i,
},
{
id: "gog",
tagName: "GOG",
label: "GOG",
urlPrefix: "https://www.gog.com/game/",
urlPattern: /^https:\/\/(?:www\.)?gog\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:www\.)?gog\.com\/\S+$/i,
},
{
id: "itchio",
@@ -103,7 +103,7 @@ export const PLATFORMS: readonly PlatformConfig[] = [
tagName: "Humble Bundle",
label: "Humble Bundle",
urlPrefix: "https://www.humblebundle.com/store/",
urlPattern: /^https:\/\/(?:www\.)?humblebundle\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:www\.)?humblebundle\.com\/\S+$/i,
},
{
id: "amazon",
@@ -111,21 +111,21 @@ export const PLATFORMS: readonly PlatformConfig[] = [
label: "Amazon Luna",
urlPrefix: "https://luna.amazon.com/game/",
// Luna's own site, or the game's page on any Amazon storefront.
urlPattern: /^https:\/\/(?:luna\.amazon\.com|(?:www\.)?amazon\.[a-z.]{2,6})\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:luna\.amazon\.com|(?:www\.)?amazon\.[a-z.]{2,6})\/\S+$/i,
},
{
id: "ea",
tagName: "EA app",
label: "EA app",
urlPrefix: "https://www.ea.com/games/",
urlPattern: /^https:\/\/(?:www\.)?ea\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:www\.)?ea\.com\/\S+$/i,
},
{
id: "ubisoft",
tagName: "Ubisoft Connect",
label: "Ubisoft Store",
urlPrefix: "https://store.ubisoft.com/",
urlPattern: /^https:\/\/(?:store\.ubisoft\.com|(?:www\.)?ubisoft\.com)\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:store\.ubisoft\.com|(?:www\.)?ubisoft\.com)\/\S+$/i,
},
{
id: "battlenet",
@@ -133,7 +133,7 @@ export const PLATFORMS: readonly PlatformConfig[] = [
label: "Battle.net",
urlPrefix: "https://shop.battle.net/",
// shop.battle.net and its regional hosts (us.shop.battle.net …).
urlPattern: /^https:\/\/(?:[a-z0-9-]+\.)*battle\.net\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:[a-z0-9-]+\.)*battle\.net\/\S+$/i,
},
{
id: "googleplay",
@@ -151,7 +151,7 @@ export const PLATFORMS: readonly PlatformConfig[] = [
tagName: "iOS",
label: "App Store",
urlPrefix: "https://apps.apple.com/app/",
urlPattern: /^https:\/\/apps\.apple\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/apps\.apple\.com\/\S+$/i,
},
{
id: "meta",
@@ -159,7 +159,7 @@ export const PLATFORMS: readonly PlatformConfig[] = [
label: "Meta Quest Store",
urlPrefix: "https://www.meta.com/experiences/",
// meta.com, and oculus.com links that still circulate.
urlPattern: /^https:\/\/(?:www\.)?(?:meta|oculus)\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:www\.)?(?:meta|oculus)\.com\/\S+$/i,
},
{
// Catch-all for indie / niche releases distributed only from a
@@ -170,6 +170,6 @@ export const PLATFORMS: readonly PlatformConfig[] = [
id: "publisher",
label: "Publisher / Developer site",
urlPrefix: "https://",
urlPattern: /^https:\/\/[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+(?:\/[^\s]*)?$/i,
urlPattern: /^https:\/\/[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+(?:\/\S*)?$/i,
},
] as const;
+4 -4
View File
@@ -36,14 +36,14 @@ export const PLAYTEST_PLATFORMS: readonly PlaytestPlatformConfig[] = [
id: "steam",
label: "Steam Playtest",
urlPrefix: "https://store.steampowered.com/app/",
urlPattern: /^https:\/\/store\.steampowered\.com\/app\/\d+(?:\/[^\s]*)?$/i,
urlPattern: /^https:\/\/store\.steampowered\.com\/app\/\d+(?:\/\S*)?$/i,
maxInvites: 100,
},
{
id: "epic",
label: "Epic Games Store",
urlPrefix: "https://store.epicgames.com/",
urlPattern: /^https:\/\/store\.epicgames\.com\/[^\s]+$/i,
urlPattern: /^https:\/\/store\.epicgames\.com\/\S+$/i,
maxInvites: 100,
},
{
@@ -57,7 +57,7 @@ export const PLAYTEST_PLATFORMS: readonly PlaytestPlatformConfig[] = [
id: "discord",
label: "Discord / Community",
urlPrefix: "https://discord.gg/",
urlPattern: /^https:\/\/(?:discord\.gg|discord\.com\/invite)\/[^\s]+$/i,
urlPattern: /^https:\/\/(?:discord\.gg|discord\.com\/invite)\/\S+$/i,
maxInvites: 100,
},
{
@@ -66,7 +66,7 @@ export const PLAYTEST_PLATFORMS: readonly PlaytestPlatformConfig[] = [
id: "other",
label: "Other / Signup form",
urlPrefix: "https://",
urlPattern: /^https:\/\/[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+(?:\/[^\s]*)?$/i,
urlPattern: /^https:\/\/[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)+(?:\/\S*)?$/i,
maxInvites: 100,
},
] as const;
+102 -2
View File
@@ -102,6 +102,30 @@ export interface RigField {
readonly composite?: CompositeFieldSpec;
/** `text` fields: values offered while typing (the user may type anything). */
readonly suggestions?: readonly string[];
/**
* `text` fields: tidies the typed or pasted text. Runs when the user
* leaves the field and again in {@link formatRigValue}, so a shortcut
* pressed while the cursor is still in the field prints the tidy form
* too. Must be idempotent.
*/
readonly clean?: (raw: string) => string;
/** Takes both columns of the editor's grid (long values, such as a LUT name). */
readonly wide?: boolean;
/**
* `text` fields (v1.6.0): when the value is "Custom" (any case — the
* field's first suggestion), the description prints this templates key
* as the whole line instead of "Label: Custom". The LUT's is "LUT
* applied", for a LUT of one's own that has no name worth printing.
*/
readonly customNoteKey?: string;
}
/** The value that selects a field's {@link RigField.customNoteKey} line. */
const RIG_CUSTOM_VALUE = "Custom";
/** True when a rig value is the "Custom" choice (case and spaces ignored). */
export function isCustomRigValue(value: string): boolean {
return value.trim().toLowerCase() === RIG_CUSTOM_VALUE.toLowerCase();
}
/**
@@ -477,6 +501,68 @@ export function cleanCpuName(raw: string): string {
);
}
/**
* LUTs that come with DaVinci Resolve, named the way its LUT menu shows
* them (from Resolve 21's own LUT folder), offered while typing in the
* LUT field. Any other LUT's name is accepted as typed. v1.6.0: "Custom"
* comes first — a LUT of one's own, printed as just "LUT applied".
*/
export const LUT_SUGGESTIONS: readonly string[] = [
RIG_CUSTOM_VALUE,
"Arri Alexa LogC to Rec709",
"Rec709 Kodak 2383 D65",
"Rec709 Kodak 2383 D60",
"Rec709 Kodak 2383 D55",
"Rec709 Fujifilm 3513DI D65",
"Rec709 Fujifilm 3513DI D60",
"Rec709 Fujifilm 3513DI D55",
"HDR 1000 nits to Gamma 2.4",
"Blackmagic Gen 6 DaVinci to Rec709 BT1886 Film Look",
"SLog3SGamut3.CineToLC-709",
"SLog3SGamut3.CineToLC-709TypeA",
"V-Log to V-709",
"Leica Pure L-Log to Rec.709 Gamma 2.4",
"Samsung Log to Rec709",
];
/** The file extensions LUTs come in. Anchored at the end: linear. */
const LUT_FILE_EXTENSION = /\.(?:cube|3dl|dat|csp|ilut|olut|look)$/i;
/** One pass of {@link cleanLutName}. */
function tidyLutNameOnce(text: string): string {
let name = text.trim();
// Explorer's "Copy as path" wraps the path in double quotes.
if (name.length >= 2 && name.startsWith('"') && name.endsWith('"')) {
name = name.slice(1, -1).trim();
}
// A path (a backslash, a drive letter, or a leading / or ~/) keeps only
// its file name. A slash in an ordinary name ("Teal/Orange") stays.
const isPath =
name.includes("\\") || /^[a-z]:\//i.test(name) || name.startsWith("/") || name.startsWith("~/");
if (isPath) {
name = name.slice(Math.max(name.lastIndexOf("\\"), name.lastIndexOf("/")) + 1).trim();
}
return name.replace(LUT_FILE_EXTENSION, "").trim();
}
/**
* Tidy a LUT name pasted from a file manager:
* `"Rec709 Kodak 2383 D65.cube"` → `"Rec709 Kodak 2383 D65"`, and
* Explorer's `"C:\…\Arri\Arri Alexa LogC to Rec709.dat"` (or a macOS
* path) → `"Arri Alexa LogC to Rec709"`. Dots inside a name
* ("SLog3SGamut3.CineToLC-709", "Rec.709 Gamma 2.4") stay. Idempotent:
* passes repeat until nothing changes.
*/
export function cleanLutName(raw: string): string {
let name = raw;
let previous: string;
do {
previous = name;
name = tidyLutNameOnce(name);
} while (name !== previous);
return name;
}
/**
* The rig fields, in the order both the editor and the description show
* them: the parts a viewer compares first (CPU, GPU, RAM), then the rest.
@@ -488,6 +574,7 @@ export const RIG_FIELDS: readonly RigField[] = [
type: "text",
placeholder: "AMD Ryzen 7 9800X3D",
suggestions: CPU_SUGGESTIONS,
clean: cleanCpuName,
},
{ id: "gpu", labelKey: "rig.gpu", type: "gpu" },
{ id: "ram", labelKey: "rig.ram", type: "composite_dropdown", composite: RAM_COMPOSITE },
@@ -514,6 +601,17 @@ export const RIG_FIELDS: readonly RigField[] = [
options: VIDEO_EDITOR_OPTIONS,
versionPlaceholder: "20 / 2026 / v25",
},
// The LUT graded in that editor — its own line, right under it.
{
id: "lut",
labelKey: "rig.lut",
type: "text",
placeholder: "Arri Alexa LogC to Rec709",
suggestions: LUT_SUGGESTIONS,
clean: cleanLutName,
wide: true,
customNoteKey: "description.rigNotes.lut_custom",
},
];
/**
@@ -567,7 +665,9 @@ function withSuffix(text: string, suffix: string): string {
* - `composite_dropdown` ("32|DDR5|6000", "custom:48|DDR5|") →
* "32 GB DDR5-6000" / "48 GB DDR5" via the field's
* {@link CompositeFieldSpec.format}.
* - All other field types pass the raw value through.
* - `text` fields with a {@link RigField.clean} go through it (a pasted
* "Rec709 Kodak 2383 D65.cube" → "Rec709 Kodak 2383 D65"); other text
* passes through as typed.
*/
export function formatRigValue(fieldId: string, raw: string): string {
const field = RIG_FIELDS.find((f) => f.id === fieldId);
@@ -619,5 +719,5 @@ export function formatRigValue(fieldId: string, raw: string): string {
return field.composite.format(resolved);
}
return raw;
return field.clean ? field.clean(raw) : raw;
}
+95 -52
View File
@@ -1,4 +1,4 @@
import type { GeneratorInput, TranslationFn, CharLimitWarning } from "./types";
import type { GeneratorInput, TranslationFn, CharLimitWarning, AutoTechNote } from "./types";
import { channelOrSlot, withoutEmptyChannel } from "./channel-phrase";
import { YT_LIMITS } from "./types";
import { PLATFORMS } from "@config/platforms";
@@ -11,6 +11,7 @@ import { buildRigLines } from "./rig-block";
import { parseTimeline, renderTimeline } from "./timeline-parser";
import { formatEndingEntry, sliceEndingsForVideo } from "./endings-format";
import { sanitizeHashtag } from "@utils/sanitize";
import { validUpscaleSource } from "./upscale";
const SOCIAL_ICONS: Record<string, string> = {
kofi: "☕",
@@ -96,6 +97,65 @@ const VENDOR_GFX_BRANDS: Record<"nvidia" | "amd" | "intel", { upscale: string; f
intel: { upscale: "Intel XeSS", framegen: "Intel XeFG" },
};
type GfxVendor = keyof typeof VENDOR_GFX_BRANDS;
/** A translation that exists and isn't blank, else `""`. */
function resolvedLabel(t: TranslationFn, key: string): string {
const label = t(key);
return label && label !== key && label.trim() ? label : "";
}
/**
* The upscaling part — v0.11: the vendor-keyed full label first ("NVIDIA
* DLAA", "AMD FSR Native AA", "Intel XeSS Ultra Quality"), which embeds the
* brand; else the pre-v0.11 flat key with the brand in front, for legacy
* locales / unmigrated translations.
*/
function upscalePart(input: GeneratorInput, vendor: GfxVendor, t: TranslationFn): string {
const quality = input.upscaleQuality;
if (!quality || quality === "none") return "";
const label = resolvedLabel(t, `description.graphics.upscale.${vendor}.${quality}`);
if (label) return label;
const legacyKey = `description.graphics.upscaleQualityOptions.${quality}`;
const legacyLabel = t(legacyKey);
return legacyLabel && legacyLabel !== legacyKey
? `${VENDOR_GFX_BRANDS[vendor].upscale} ${legacyLabel}`
: "";
}
/**
* The frame-generation part. The vendor-keyed label embeds the brand AND
* the feature name ("NVIDIA Frame Generation x2", "AMD Fluid Motion Frames
* x3", "Intel XeFG x2"), with brand + raw multiplier as the fallback for
* pre-v0.11 locales. v1.6.0: `"custom"` prints what was typed (like a
* custom preset); an empty box prints nothing rather than "custom".
*/
function frameGenPart(input: GeneratorInput, vendor: GfxVendor, t: TranslationFn): string {
const multiplier = input.frameGenMultiplier;
if (!multiplier || multiplier === "none") return "";
if (multiplier === "custom") return (input.frameGenCustom ?? "").trim();
return (
resolvedLabel(t, `description.graphics.frameGen.${vendor}.${multiplier}`) ||
`${VENDOR_GFX_BRANDS[vendor].framegen} ${multiplier}`
);
}
/**
* The vendor half of the "In-game Setting:" line — e.g. `NVIDIA DLSS
* Quality + NVIDIA DLSS 5 Neural Rendering + NVIDIA Multi Frame Generation
* x4`. v1.6.0: DLSS 5 Neural Rendering follows the DLSS mode, for NVIDIA
* only — a stale flag on another vendor's draft prints nothing.
*/
function composeVendorModifier(input: GeneratorInput, vendor: GfxVendor, t: TranslationFn): string {
const neural =
vendor === "nvidia" && input.dlssNeuralRendering
? t("description.graphics.dlssNeuralRendering")
: "";
return [upscalePart(input, vendor, t), neural, frameGenPart(input, vendor, t)]
.filter(Boolean)
.join(" + ");
}
/**
* Compose the value half of the "In-game Setting:" line — e.g.
* `Cinematic - NVIDIA Frame Generation x2 with Ray Tracing`.
@@ -122,54 +182,11 @@ function composeGraphicsPart(input: GeneratorInput, t: TranslationFn): string {
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.
// 2. Modifier (upscale + DLSS 5 + 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(" + ");
}
const modifier = vendor ? composeVendorModifier(input, vendor, t) : "";
// 3. Ray-tracing clause. Each mode runs through i18n; falls back to
// the snake_case id if a locale hasn't translated it.
@@ -223,6 +240,26 @@ function composeVideoStyleLine(input: GeneratorInput, t: TranslationFn): string
return t("description.videoSettings.styleLineNoEditor", { era: eraLabel });
}
/**
* The v1.5.0 "Upscale:" line — `Upscale: 1440p → 4K (DaVinci Resolve Studio
* 21.2)`, the editor named by the rig's `video_editor` field (no brackets when
* it's empty). Empty string when the video isn't upscaled. Like the style
* line, it survives `skipGraphicsSettings`: it describes the video, not the
* game's settings, and the title's "Upscaled" badge needs it explained.
*/
function composeUpscaleLine(input: GeneratorInput, t: TranslationFn): string {
const from = validUpscaleSource(input.resolution, input.upscaledFrom);
if (!from) return "";
const editor = formatRigValue("video_editor", input.rig?.video_editor ?? "").trim();
const tool = editor ? ` (${editor})` : "";
return `${t("description.graphics.upscaleLabel")}: ${from} → ${input.resolution}${tool}`;
}
/** The tech notes the engine adds after the user's own ({@link AUTO_TECH_NOTES}). */
function autoTechNotes(input: GeneratorInput): AutoTechNote[] {
return validUpscaleSource(input.resolution, input.upscaledFrom) ? ["editor_upscaled"] : [];
}
export interface BuildDescriptionOptions {
hashtagCount?: number;
/** When true and channelName is non-empty, appends an auto-generated
@@ -450,6 +487,7 @@ export function buildDescription(
// still edit their footage, so the style credit shouldn't disappear
// with the graphics block.
const styleLine = composeVideoStyleLine(input, t);
const upscaleLine = composeUpscaleLine(input, t);
if (!input.skipGraphicsSettings) {
const lines: string[] = [];
@@ -461,6 +499,8 @@ export function buildDescription(
if (captureParts.length > 0) {
lines.push(`${t("description.graphics.videoLabel")}: ${captureParts.join(" - ")}`);
}
// v1.5.0: what the video was upscaled from, right under its resolution.
if (upscaleLine) lines.push(upscaleLine);
// In-game side: preset + modifiers + RT.
const gfxPart = composeGraphicsPart(input, t);
@@ -489,11 +529,12 @@ export function buildDescription(
if (lines.length > 0) {
sections.push(`${t("description.sections.videoSettings")}\n${lines.join("\n")}`);
}
} else if (styleLine) {
} else if (upscaleLine || styleLine) {
// 2D / pixel-art path: the graphics block is suppressed but the
// creator still set a style era, so emit a single-line standalone
// section under the same header.
sections.push(`${t("description.sections.videoSettings")}\n${styleLine}`);
// creator still upscaled the video or set a style era, so emit those
// lines as a standalone section under the same header.
const lines = [upscaleLine, styleLine].filter(Boolean);
sections.push(`${t("description.sections.videoSettings")}\n${lines.join("\n")}`);
}
// 5.5 Difficulty — moved into the unified Playthrough Notes block
@@ -534,8 +575,10 @@ export function buildDescription(
// Sits next to Content Warnings because both are transparency blocks;
// grouping them keeps disclaimers visually together. Same bilingual
// checklist shape.
// v1.5.0: the engine's own notes (the upscaling warning) follow the user's.
const techNotes = [...(input.techNotes ?? []), ...autoTechNotes(input)];
const tnSection = buildBilingualBulletSection(
input.techNotes ?? [],
techNotes,
"description.techNotes",
input.language,
t,
+17 -4
View File
@@ -6,13 +6,17 @@ import type { FrameGenVendor, FrameGenMultiplier, UpscaleQuality } from "@config
* tiers it actually ships:
*
* - NVIDIA: DLAA (anti-aliasing-only) + 4 quality bins. DLSS 4 supports
* multi-frame-gen up to x4.
* multi-frame-gen up to x4; DLSS 4.5 adds x6 and Dynamic Multi Frame
* Generation (v1.6.0).
* - 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.
*
* Every vendor also offers `"custom"` (v1.6.0): the frame generation typed
* into `frameGenCustom`, for a mode the list doesn't name.
*
* 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.
@@ -55,16 +59,25 @@ export function getValidUpscaleQualities(vendor: FrameGenVendor): readonly Upsca
export function getValidFrameGenMultipliers(vendor: FrameGenVendor): readonly FrameGenMultiplier[] {
switch (vendor) {
case "nvidia":
return ["none", "x2", "x3", "x4"] as const;
return ["none", "x2", "x3", "x4", "x6", "dynamic", "custom"] as const;
case "amd":
return ["none", "x2", "x3"] as const;
return ["none", "x2", "x3", "custom"] as const;
case "intel":
return ["none", "x2"] as const;
return ["none", "x2", "custom"] as const;
case "none":
return ["none"] as const;
}
}
/**
* DLSS 5 Neural Rendering (v1.6.0) is NVIDIA's (RTX 50 series): any other
* vendor turns it off, the way an invalid quality or multiplier falls back
* to `"none"`.
*/
export function coerceDlssNeuralRendering(vendor: FrameGenVendor, current: boolean): boolean {
return vendor === "nvidia" && current;
}
/** Returns `current` if it's valid for the vendor, else `"none"`. */
export function coerceUpscaleQuality(
vendor: FrameGenVendor,
+7 -2
View File
@@ -1,4 +1,4 @@
import { RIG_FIELDS, formatRigValue } from "@config/rig-fields";
import { RIG_FIELDS, formatRigValue, isCustomRigValue } from "@config/rig-fields";
import type { TranslationFn } from "./types";
/**
@@ -9,6 +9,9 @@ import type { TranslationFn } from "./types";
* order is {@link RIG_FIELDS}'. Both used to come from the stored object:
* every language printed English keys in capitals ("VIDEO EDITOR:"), in
* whatever order the fields had first been filled in.
*
* v1.6.0: a field with a `customNoteKey` set to "Custom" prints that note
* as its whole line — the LUT's "LUT applied".
*/
export function buildRigLines(
rig: Partial<Record<string, string>> | undefined,
@@ -19,7 +22,9 @@ export function buildRigLines(
const lines = RIG_FIELDS.flatMap((field) => {
const value = formatRigValue(field.id, rig[field.id] ?? "").trim();
return value ? [`${t(`description.rigLabels.${field.id}`)}: ${value}`] : [];
if (!value) return [];
if (field.customNoteKey && isCustomRigValue(value)) return [t(field.customNoteKey)];
return [`${t(`description.rigLabels.${field.id}`)}: ${value}`];
});
// Keys that aren't rig fields any more (older versions, hand-edited
+114 -9
View File
@@ -1,6 +1,7 @@
import type { GeneratorInput, SupportedLanguage } from "./types";
import { YT_LIMITS } from "./types";
import { PLATFORMS } from "@config/platforms";
import { VIDEO_TYPES } from "@config/video-types";
/**
* Length of a tag list as YouTube counts it against the 500-character
@@ -73,16 +74,111 @@ export function tagFriendlyGameName(name: string, budget: number): string {
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 leadingWordsWithin(n.split(/\s+/), budget);
}
/**
* The leading whole words that fit `budget` characters, joined by single
* spaces; when even the first word is longer, its first `budget`
* characters.
*/
function leadingWordsWithin(words: readonly string[], budget: number): string {
const kept: string[] = [];
let length = 0;
for (const word of words) {
const separator = kept.length === 0 ? 0 : 1;
if (length + separator + word.length > budget) break;
kept.push(word);
length += separator + word.length;
}
return acc.join(" ") || n.slice(0, budget);
return kept.join(" ") || (words[0] ?? "").slice(0, budget);
}
/**
* What a boss name's tag keeps: letters in any script (with their
* combining marks), digits, whitespace, and `.` `'` `’` `-` for the word
* rules below. Everything else — `,` `;` `:` `!` `?` quotes, brackets,
* `&` `/` `#`, `「」` `・` `、` `。`, ™, emoji — becomes a space. A single
* character class: linear.
*/
const BOSS_NAME_NOISE = /[^\p{L}\p{M}\p{N}\s.'’-]/gu;
/**
* Where a long boss name's title starts: "Loretta, Knight of the
* Haligtree", "Margit – the Fell Omen", "Sister Friede (Phase 2)".
*/
const BOSS_NAME_BREAK = /[,,、::;;(([【「『|—–]| - /;
const DIGIT = /^\p{Nd}$/u;
const INITIAL = /^\p{L}\p{M}*$/u;
/** Apostrophes and hyphens belong inside a word ("Mergo's", "T-103"), not at its edges. */
const WORD_EDGE_MARKS = new Set(["'", "’", "-"]);
function trimWordEdges(word: string): string {
let start = 0;
let end = word.length;
while (start < end && WORD_EDGE_MARKS.has(word.charAt(start))) start++;
while (end > start && WORD_EDGE_MARKS.has(word.charAt(end - 1))) end--;
return word.slice(start, end);
}
/**
* The dots in one word: kept between two digits ("2.0"), dropped between
* initials ("S.T.A.L.K.E.R." → "STALKER", "K.K." → "KK"), a space
* everywhere else ("Mr.X" → "Mr X", "Dr.ワイリー" → "Dr ワイリー").
* Done in code, not with a lookbehind: older WebKit (the macOS 11–13
* desktop webview) rejects one, and the whole chunk would fail to load.
*/
function resolveDots(word: string): string {
const parts = word.split(".");
let out = parts[0] ?? "";
for (let i = 1; i < parts.length; i++) {
const before = parts[i - 1] ?? "";
const after = parts[i] ?? "";
if (DIGIT.test(before.slice(-1)) && DIGIT.test(after.charAt(0))) out += ".";
else if (!(INITIAL.test(before) && (after === "" || INITIAL.test(after)))) out += " ";
out += after;
}
return out;
}
function bossNameWords(text: string): string[] {
return text
.replace(BOSS_NAME_NOISE, " ")
.split(/\s+/)
.flatMap((word) => resolveDots(word).split(" "))
.map(trimWordEdges)
.filter(Boolean);
}
/**
* The boss's name as one tag, without the marks that add nothing to a
* search: "Gael, Slave Knight" → "Gael Slave Knight", "Mr. X" → "Mr X",
* "「マレニア」" → "マレニア". Over 30 characters (the per-tag limit), the
* name before its title is tried ("Loretta, Knight of the Haligtree" →
* "Loretta"), then the leading words that fit. Empty when nothing is left.
*
* Pure — exported for testing.
*/
export function bossNameTag(name: string): string {
const text = name.normalize("NFC");
const words = bossNameWords(text);
const full = words.join(" ");
if (full.length <= YT_LIMITS.SINGLE_TAG_MAX) return full;
const breakAt = text.search(BOSS_NAME_BREAK);
const headWords = breakAt > 0 ? bossNameWords(text.slice(0, breakAt)) : [];
const head = headWords.join(" ");
if (head && head.length <= YT_LIMITS.SINGLE_TAG_MAX) return head;
return leadingWordsWithin(headWords.length > 0 ? headWords : words, YT_LIMITS.SINGLE_TAG_MAX);
}
/** Video types that ask for a boss name (Boss Fight, Boss No Hit). */
function takesBossName(videoType: string): boolean {
const extraFields: readonly string[] =
VIDEO_TYPES.find((type) => type.id === videoType)?.extraFields ?? [];
return extraFields.includes("bossName");
}
/**
@@ -541,6 +637,15 @@ export function generateTags(input: GeneratorInput, options?: TagOptions): strin
if (bareNameTag) allTags.push(bareNameTag);
if (composeName && composeName !== bareNameTag) allTags.push(composeName);
// Boss videos (v1.4.0): the boss's name as a tag of its own, right after
// the game's, so fitting the list to 500 characters never drops it. Only
// for the video types that ask for a boss name — one left in the draft
// after switching to another type isn't this video's.
if (takesBossName(input.videoType)) {
const bossTag = bossNameTag(input.bossName ?? "");
if (bossTag) allTags.push(bossTag);
}
// Core tags — language-specific (highest priority)
const coreFn = CORE_TAGS_BY_LANG[input.language] ?? CORE_TAGS_BY_LANG.en;
allTags.push(...coreFn(composeName));
+17 -5
View File
@@ -15,6 +15,7 @@ import {
} from "@config/gacha-quest-types";
import { formatEndingEntry, sliceEndingsForVideo } from "./endings-format";
import type { EndingEntry } from "./types";
import { validUpscaleSource } from "./upscale";
/**
* Compact "[2K 60FPS]" badge appended to the video-type segment when the
@@ -26,10 +27,15 @@ import type { EndingEntry } from "./types";
* - Non-default FPS → include the resolution alongside (e.g. "1080p 120FPS")
* so a lonely FPS number isn't ambiguous.
*
* Always returns upper-case. Callers apply `badgeCase: "lower"` downstream
* — this function is a label producer, not a display formatter.
* - v1.5.0: `upscaledWord` (the locale's "Upscaled", passed only when the
* video was upscaled in the editor) follows the resolution — "4K Upscaled",
* "4K Upscaled 120FPS". It never makes a badge on its own: 1080p 60fps
* upscaled from 720p still has none (the description says so instead).
*
* Callers apply `badgeCase: "lower"` downstream — this function is a label
* producer, not a display formatter.
*/
export function buildQualityBadge(resolution?: string, fps?: string): string {
export function buildQualityBadge(resolution?: string, fps?: string, upscaledWord = ""): string {
const res = resolution || "1080p";
const fpsValue = fps || "60";
const resDefault = res === "1080p";
@@ -37,7 +43,8 @@ export function buildQualityBadge(resolution?: string, fps?: string): string {
if (resDefault && fpsDefault) return "";
const resLabel = res === "1440p" ? "2K" : res;
return fpsDefault ? resLabel : `${resLabel} ${fpsValue}FPS`;
const head = upscaledWord ? `${resLabel} ${upscaledWord}` : resLabel;
return fpsDefault ? head : `${head} ${fpsValue}FPS`;
}
export interface BuildTitleOptions {
@@ -285,7 +292,12 @@ export function buildTitle(
const gameName = input.gameNameLocalized?.[input.language] ?? input.gameName;
let badge = opts.showQualityBadge ? buildQualityBadge(input.resolution, input.fps) : "";
const upscaledWord = validUpscaleSource(input.resolution, input.upscaledFrom)
? t("title.upscaled")
: "";
let badge = opts.showQualityBadge
? buildQualityBadge(input.resolution, input.fps, upscaledWord)
: "";
if (badge && opts.badgeCase === "lower") badge = badge.toLowerCase();
// Gacha-quest titles compose their own head segment via the
+24 -1
View File
@@ -255,6 +255,17 @@ export const TECH_NOTES = [
] as const;
export type TechNote = (typeof TECH_NOTES)[number];
/**
* Tech notes the engine adds on its own (v1.5.0), after the ones the user
* picked — never stored in `techNotes` and not in the editor's checklist.
* `editor_upscaled` comes with a valid {@link GeneratorInput.upscaledFrom}: the
* structured "Upscale:" line in 🖥 VIDEO SETTINGS says what was upscaled to
* what, this note warns what upscaling does to the image. Their bullets share
* `description.techNotes.items` with {@link TECH_NOTES}.
*/
export const AUTO_TECH_NOTES = ["editor_upscaled"] as const;
export type AutoTechNote = (typeof AUTO_TECH_NOTES)[number];
/**
* Content warnings (v0.11 unified bilingual checklist). Replaces the
* v0.7 trio (flashing_lights / loud_noises / jump_scares) plus the
@@ -644,7 +655,15 @@ export interface GeneratorInput {
* is rendered inside Gacha-specific intros (showcase / anniversary etc.).
*/
gachaVersion?: string;
/** The video's resolution — the uploaded file's ("4K" when 1440p footage was upscaled). */
resolution?: string;
/**
* v1.5.0: recorded at this resolution and upscaled to {@link resolution} in
* the video editor. Adds "Upscaled" to the title badge, an "Upscale:" line
* to 🖥 VIDEO SETTINGS and the {@link AUTO_TECH_NOTES} warning. Ignored
* unless it is below `resolution` (`@engine/upscale`).
*/
upscaledFrom?: string;
fps?: string;
/**
* Graphics-quality preset (v0.8 enum + `"custom"` escape hatch).
@@ -667,15 +686,19 @@ export interface GeneratorInput {
frameGenVendor?: FrameGenVendor;
/** Frame-generation multiplier (only meaningful when vendor !== "none"). */
frameGenMultiplier?: FrameGenMultiplier;
/** v1.6.0: the frame generation as typed, when {@link frameGenMultiplier} is `"custom"`. */
frameGenCustom?: string;
/** Upscaling quality (DLSS / FSR / XeSS quality preset). */
upscaleQuality?: UpscaleQuality;
/** v1.6.0: NVIDIA DLSS 5 Neural Rendering — printed only when the vendor is NVIDIA. */
dlssNeuralRendering?: boolean;
/** High-level art-style descriptor — surfaces a separate line. */
artStyle?: ArtStyle;
/**
* Video-style era opt-in (v0.22.0). When set to a non-empty era id,
* the renderer emits a single "Edited in {era} style using {editor}"
* credit at the end of the Video Settings section. Combines with
* {@link rig.video_editor}. Renders even when
* the rig's `video_editor`. Renders even when
* {@link skipGraphicsSettings} is true.
*/
videoStyleEra?: string;
+39
View File
@@ -0,0 +1,39 @@
import {
UPSCALED_FROM_OPTIONS,
VIDEO_RESOLUTIONS,
type UpscaledFrom,
} from "@config/graphics-settings";
/**
* Upscaling in the video editor (v1.5.0): footage recorded at one resolution
* and exported at a higher one, e.g. 1440p → 4K. The title badge, the
* description's "Upscale:" line and the automatic tech note all go through
* {@link validUpscaleSource}, so a pair that isn't an upscale (same or higher
* source, unknown value) changes nothing anywhere.
*/
function rank(resolution: string): number {
return (VIDEO_RESOLUTIONS as readonly string[]).indexOf(resolution);
}
/**
* `from` when it is a known resolution below `resolution` (the video's own,
* 1080p when unset — the editor's default); otherwise `""`.
*/
export function validUpscaleSource(
resolution: string | undefined,
from: string | undefined,
): string {
if (!from) return "";
const source = rank(from);
const target = rank(resolution || "1080p");
return source >= 0 && target >= 0 && source < target ? from : "";
}
/** The sources a video at `resolution` can be upscaled from, lowest first. */
export function upscaleSourcesFor(resolution: string | undefined): Exclude<UpscaledFrom, "">[] {
return UPSCALED_FROM_OPTIONS.filter(
(from): from is Exclude<UpscaledFrom, ""> =>
from !== "" && validUpscaleSource(resolution, from) !== "",
);
}
+3
View File
@@ -44,6 +44,7 @@ export function buildGeneratorInputFromEditor(
anniversaryYear: state.anniversaryYear,
gachaVersion: state.gachaVersion,
resolution: state.resolution,
upscaledFrom: state.upscaledFrom,
fps: state.fps,
graphicsPreset: state.graphicsPreset,
graphicsPresetCustom: state.graphicsPresetCustom,
@@ -51,7 +52,9 @@ export function buildGeneratorInputFromEditor(
rayTracingModes: state.rayTracingModes,
frameGenVendor: state.frameGenVendor,
frameGenMultiplier: state.frameGenMultiplier,
frameGenCustom: state.frameGenCustom,
upscaleQuality: state.upscaleQuality,
dlssNeuralRendering: state.dlssNeuralRendering,
artStyle: state.artStyle,
videoStyleEra: state.videoStyleEra,
versionInfo: state.versionInfo,
+12
View File
@@ -1,5 +1,12 @@
import { useEffect } from "react";
/**
* Fired on `window` (detail: the page name) whenever a page sets its title.
* RouteAnnouncer reads it out after a navigation; restoring the previous title
* on unmount does not fire it, so a page being left is never announced.
*/
export const PAGE_TITLE_EVENT = "ytdescgen:page-title";
/**
* Sets `document.title` to `"<title> · YTDescGen"` for the lifetime of the
* component, and restores the previous title on unmount. Per-page titles
@@ -12,6 +19,11 @@ export function useDocumentTitle(title: string): void {
useEffect(() => {
const previous = document.title;
document.title = `${title} · YTDescGen`;
// A microtask, so listeners hear it after every effect of this commit has
// run — RouteAnnouncer marks the navigation in one of them.
queueMicrotask(() => {
window.dispatchEvent(new CustomEvent(PAGE_TITLE_EVENT, { detail: title }));
});
return () => {
document.title = previous;
};
+5 -1
View File
@@ -1,5 +1,6 @@
import { useEffect, useRef } from "react";
import { useNavigate } from "react-router-dom";
import { useSettingsStore } from "@store/settings-store";
import { useOutputCopy } from "./use-output-copy";
import { useSaveToHistory } from "./use-save-to-history";
@@ -60,9 +61,12 @@ export function useKeyboardShortcuts(handlers: ShortcutHandlers) {
} 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.
// character in titles, descriptions, and other inputs — and when
// Settings › Editor turned single-key shortcuts off (WCAG 2.1.4:
// speech input says "question mark" and opens a dialog otherwise).
e.key === "?" &&
!mod &&
useSettingsStore.getState().singleKeyShortcuts &&
!isEditableTarget(e.target)
) {
e.preventDefault();
+3 -1
View File
@@ -23,7 +23,9 @@ export const SUPPORTED_LANGUAGES = [
nativeName: string;
}[];
i18n
// `void`: nothing waits on init. `en` is bundled, so the first render already
// has its strings, and every other language loads on demand.
void i18n
.use(initReactI18next)
.use(
// Vite statically analyses this template literal and emits one async
+28 -16
View File
@@ -109,6 +109,9 @@
"vnZalopay",
"vnZalopayPlaceholder",
"resolution",
"upscaledFrom",
"upscaledFromNone",
"upscaledFromHelp",
"fps",
"graphicsPreset",
"graphicsPresetCustom",
@@ -118,7 +121,10 @@
"rayTracing",
"frameGenVendor",
"frameGenMultiplier",
"frameGenCustom",
"frameGenCustomPlaceholder",
"upscaleQuality",
"dlssNeuralRendering",
"artStyle",
"videoStyle",
"videoStyleHelp",
@@ -226,10 +232,10 @@
],
"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.frameGenMultiplierOptions": ["none", "x2", "x3", "x4", "x6", "dynamic", "custom"],
"editor.frameGenMultiplier.nvidia": ["none", "x2", "x3", "x4", "x6", "dynamic", "custom"],
"editor.frameGenMultiplier.amd": ["none", "x2", "x3", "custom"],
"editor.frameGenMultiplier.intel": ["none", "x2", "custom"],
"editor.upscaleQualityOptions": [
"none",
"native_aa",
@@ -315,7 +321,7 @@
"editor.endings": [
"countLabel",
"videoCountLabel",
"videoLabel",
"videoLabel", "fromLabel", "toLabel", "rowNumberAria", "rowNameAria", "rangeFromAria", "rangeToAria",
"numberLabel",
"nameLabel",
"namePlaceholder",
@@ -737,7 +743,7 @@
"scrollToTop",
"exported",
"exportFailed",
"close",
"close", "notificationsRegion", "closeNotification",
"edit",
"loading"
],
@@ -826,7 +832,8 @@
"capture",
"motherboard",
"controller",
"video_editor"
"video_editor",
"lut"
],
"social": [
"kofi",
@@ -963,7 +970,7 @@
"genrePlaylistsBadge",
"numberRange",
"themeDark",
"themeLight", "titleOrder", "titleOrderGameFirst", "titleOrderTypeFirst", "copyAllIncludesTags", "copyAllIncludesTagsHint", "hideScrollbars", "hideScrollbarsHint"
"themeLight", "titleOrder", "titleOrderGameFirst", "titleOrderTypeFirst", "copyAllIncludesTags", "copyAllIncludesTagsHint", "hideScrollbars", "hideScrollbarsHint", "singleKeyShortcuts", "singleKeyShortcutsHint"
],
"batch": [
"title",
@@ -1001,7 +1008,7 @@
"help",
"close",
"searchPlaceholder",
"noResults", "saveToHistory"
"noResults", "saveToHistory", "notifications"
],
"validation": [
"emailInvalid",
@@ -1075,7 +1082,7 @@
"disclaimer",
"license",
"thirdParty",
"security",
"security", "accessibility",
"notice",
"conduct"
],
@@ -1085,7 +1092,7 @@
"disclaimer",
"license",
"thirdParty",
"security",
"security", "accessibility",
"notice",
"conduct"
],
@@ -1137,7 +1144,7 @@
"editor.socialGroups": ["donate", "social"]
},
"templates": {
"title": ["separator", "suffix"],
"title": ["separator", "suffix", "upscaled"],
"title.separators": ["emDash", "hyphen", "colon", "pipe"],
"title.videoType": [
"full",
@@ -1304,6 +1311,7 @@
"low_graphics_performance",
"fps_drops_hardware",
"upscaling_artifacts_possible",
"editor_upscaled",
"bug_from_game",
"crash_kept_transparency",
"loading_cut",
@@ -1587,7 +1595,9 @@
"artStyle",
"videoLabel",
"inGameSettingLabel",
"versionLabel"
"versionLabel",
"upscaleLabel",
"dlssNeuralRendering"
],
"description.graphics.presetOptions": [
"low",
@@ -1636,7 +1646,7 @@
"performance",
"ultra_performance"
],
"description.graphics.frameGen.nvidia": ["none", "x2", "x3", "x4"],
"description.graphics.frameGen.nvidia": ["none", "x2", "x3", "x4", "x6", "dynamic"],
"description.graphics.frameGen.amd": ["none", "x2", "x3"],
"description.graphics.frameGen.intel": ["none", "x2"],
"description.graphics.artStyleOptions": [
@@ -1717,7 +1727,9 @@
"monitor",
"capture",
"controller",
"video_editor"
]
"video_editor",
"lut"
],
"description.rigNotes": ["lut_custom"]
}
}
+14 -4
View File
@@ -8,6 +8,7 @@
"pipe": " | "
},
"suffix": "Gameplay No Commentary",
"upscaled": "Upscaled",
"videoType": {
"full": "",
"part": "Part {{partNumber}}",
@@ -209,7 +210,8 @@
"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",
"upscaling_artifacts_possible": "Possible upscaling / frame-generation artifacts (DLSS, FSR, XeSS)"
"upscaling_artifacts_possible": "Possible upscaling / frame-generation artifacts (DLSS, FSR, XeSS)",
"editor_upscaled": "Upscaled to a higher resolution in editing — fine detail is reconstructed, so text, textures and edges may look slightly different from the original image"
}
},
"contentWarnings": {
@@ -532,7 +534,9 @@
"none": "",
"x2": "NVIDIA Frame Generation x2",
"x3": "NVIDIA Multi Frame Generation x3",
"x4": "NVIDIA Multi Frame Generation x4"
"x4": "NVIDIA Multi Frame Generation x4",
"x6": "NVIDIA Multi Frame Generation x6",
"dynamic": "NVIDIA Dynamic Multi Frame Generation"
},
"amd": {
"none": "",
@@ -558,7 +562,9 @@
},
"videoLabel": "Video",
"inGameSettingLabel": "In-game Setting",
"versionLabel": "Version"
"versionLabel": "Version",
"upscaleLabel": "Upscale",
"dlssNeuralRendering": "NVIDIA DLSS 5 Neural Rendering"
},
"videoSettings": {
"styleLine": "Edited in {{era}} style using {{editor}}",
@@ -592,7 +598,11 @@
"monitor": "Monitor",
"capture": "Capture Software",
"controller": "Controller",
"video_editor": "Video Editor"
"video_editor": "Video Editor",
"lut": "LUT"
},
"rigNotes": {
"lut_custom": "LUT applied"
}
},
"pinnedComment": {
+35 -8
View File
@@ -168,6 +168,9 @@
"vnZalopay": "ZaloPay",
"vnZalopayPlaceholder": "ZaloPay phone number",
"resolution": "Resolution",
"upscaledFrom": "Upscaled from",
"upscaledFromNone": "Not upscaled",
"upscaledFromHelp": "The title says “Upscaled”; the description adds an Upscale line and a note that fine detail may differ from the original image.",
"fps": "FPS",
"graphicsPreset": "Graphics Preset",
"graphicsPresetOptions": {
@@ -204,23 +207,32 @@
"x2": "x2",
"x3": "x3",
"x4": "x4",
"x6": "x6"
"x6": "x6",
"dynamic": "Dynamic",
"custom": "Custom…"
},
"frameGenMultiplier.nvidia": {
"none": "None",
"x2": "x2 (Frame Gen)",
"x3": "x3 (Multi Frame Gen)",
"x4": "x4 (Multi Frame Gen)"
"x4": "x4 (Multi Frame Gen)",
"x6": "x6 (Multi Frame Gen)",
"dynamic": "Dynamic (Multi Frame Gen)",
"custom": "Custom…"
},
"frameGenMultiplier.amd": {
"none": "None",
"x2": "x2 (Fluid Motion Frames)",
"x3": "x3 (Fluid Motion Frames)"
"x3": "x3 (Fluid Motion Frames)",
"custom": "Custom…"
},
"frameGenMultiplier.intel": {
"none": "None",
"x2": "x2 (XeFG)"
"x2": "x2 (XeFG)",
"custom": "Custom…"
},
"frameGenCustom": "Custom frame generation",
"frameGenCustomPlaceholder": "e.g. NVIDIA Smooth Motion, Lossless Scaling x3",
"upscaleQuality": "Upscaling Quality",
"upscaleQualityOptions": {
"none": "None",
@@ -255,6 +267,7 @@
"performance": "XeSS Performance",
"ultra_performance": "XeSS Ultra Performance"
},
"dlssNeuralRendering": "DLSS 5 Neural Rendering",
"artStyle": "Art Style",
"artStyleOptions": {
"none": "— Not set —",
@@ -667,6 +680,12 @@
"countLabel": "Number of endings",
"videoCountLabel": "Number of videos",
"videoLabel": "Video",
"fromLabel": "From",
"toLabel": "To",
"rowNumberAria": "Ending {{row}}: number",
"rowNameAria": "Ending {{row}}: name",
"rangeFromAria": "Video {{video}}: from ending",
"rangeToAria": "Video {{video}}: to ending",
"numberLabel": "Number",
"nameLabel": "Name",
"namePlaceholder": "e.g. Best Ending",
@@ -877,6 +896,8 @@
"exported": "Exported",
"exportFailed": "Export failed",
"close": "Close",
"notificationsRegion": "Notifications (Alt+T)",
"closeNotification": "Close notification",
"edit": "Edit",
"loading": "Loading…"
},
@@ -1001,7 +1022,8 @@
"capture": "Capture Software",
"motherboard": "Motherboard",
"controller": "Controller",
"video_editor": "Video Editor"
"video_editor": "Video Editor",
"lut": "LUT"
},
"social": {
"kofi": "Ko-fi",
@@ -1175,7 +1197,9 @@
"copyAllIncludesTags": "Copy All includes the tags",
"copyAllIncludesTagsHint": "Title, description, then the tags — for pasting everything into a notes app in one go.",
"hideScrollbars": "Hide scrollbars",
"hideScrollbarsHint": "Removes every scrollbar in the app — the mouse wheel, touchpad, touch and keyboard still scroll."
"hideScrollbarsHint": "Removes every scrollbar in the app — the mouse wheel, touchpad, touch and keyboard still scroll.",
"singleKeyShortcuts": "Single-key shortcuts",
"singleKeyShortcutsHint": "? opens the shortcut list when you're not typing in a field. Turn this off if you use speech input or press keys by accident — Ctrl/⌘ + / still works."
},
"socialPost": {
"title": "Cross-Post Captions",
@@ -1222,7 +1246,8 @@
"close": "Close Modal",
"searchPlaceholder": "Search shortcuts",
"noResults": "No matching shortcuts",
"saveToHistory": "Save to History"
"saveToHistory": "Save to History",
"notifications": "Go to notifications"
},
"validation": {
"numberRequired": "Enter a number.",
@@ -1322,7 +1347,7 @@
},
"legal": {
"title": "Legal",
"intro": "Terms, privacy, licensing and security for YTDescGen — the same documents published at ytgenerator.stream/legal.",
"intro": "Terms, privacy, licensing, security and accessibility for YTDescGen — the same documents published at ytgenerator.stream/legal.",
"englishOnly": "Documents are published in English; the Disclaimer also has a Vietnamese version.",
"back": "Back",
"allDocuments": "All documents",
@@ -1336,6 +1361,7 @@
"license": "License (Apache-2.0)",
"thirdParty": "Third-party notices",
"security": "Security policy",
"accessibility": "Accessibility",
"notice": "NOTICE",
"conduct": "Code of Conduct"
},
@@ -1346,6 +1372,7 @@
"license": "The Apache License 2.0 the source code is released under.",
"thirdParty": "Open-source libraries, fonts and services YTDescGen relies on.",
"security": "How to report a vulnerability privately, and what is in scope.",
"accessibility": "What works with a keyboard, screen readers and zoom, known gaps, and how to report a barrier.",
"notice": "The Apache-2.0 NOTICE file with copyright and attribution.",
"conduct": "Contributor Covenant rules for the project's community spaces."
}
Loaded 100 of 148 files, more files were not shown because too many files have changed in this diff. Show more