From 8628991390e97b12e56b36b27780331329a7db0a Mon Sep 17 00:00:00 2001 From: poli0981 <127664709+poli0981@users.noreply.github.com> Date: Sun, 8 Nov 2026 00:41:27 +0700 Subject: [PATCH] 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 --- .github/ISSUE_TEMPLATE/bug_report.yml | 4 +- CHANGELOG.md | 29 ++++++++++ CLAUDE.md | 3 +- DISCLAIMER.md | 2 +- docs/ARCHITECTURE.md | 13 +++-- docs/CONTENT-INVENTORY.md | 2 + docs/FEATURES.md | 81 +++++++++++++++++---------- docs/PACKAGING.md | 4 +- docs/ROADMAP.md | 11 +++- docs/TECH-SPEC.md | 14 +++-- docs/i18n/vi/CONTENT-INVENTORY.md | 2 + docs/i18n/vi/DISCLAIMER.md | 2 +- package-lock.json | 4 +- package.json | 2 +- src-tauri/Cargo.lock | 2 +- src-tauri/Cargo.toml | 2 +- src-tauri/tauri.conf.json | 2 +- 17 files changed, 121 insertions(+), 58 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index bd7086c..4609f07 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -12,8 +12,8 @@ body: id: version attributes: label: App version - description: From the About page. Example `v1.4.0`. - placeholder: v1.4.0 + description: From the About page. Example `v1.5.0`. + placeholder: v1.5.0 validations: required: true - type: dropdown diff --git a/CHANGELOG.md b/CHANGELOG.md index 7e29b7a..c628255 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,35 @@ All notable changes to YTDescGen ship as tagged releases on `main`. +## 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. diff --git a/CLAUDE.md b/CLAUDE.md index 89e7293..30cf791 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -40,7 +40,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), diff --git a/DISCLAIMER.md b/DISCLAIMER.md index 5cd00d7..5ecf69e 100644 --- a/DISCLAIMER.md +++ b/DISCLAIMER.md @@ -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.4.0 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.0 with Claude Opus 5.5)**. All commits, releases, and architectural decisions are reviewed and approved by the maintainer before merging. This disclosure applies to: diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index f3c5baa..b9d251c 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -2,7 +2,7 @@ ## YTDescGen — Technical Architecture -Reflects **v1.4.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). +Reflects **v1.5.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.4.0**. 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 │ @@ -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 … @@ -257,7 +258,7 @@ export const GENRE_TAG_REGISTRY: Record string[]> ``` ┌────────────────────────────────────────────────────────────────────┐ -│ EditorStore — "ytdescgen-editor-draft", v20 │ +│ EditorStore — "ytdescgen-editor-draft", v21 │ │ - the draft: every form field (EditorData) + setter actions │ │ - persists data only (editorDataOf); migrateEditorState │ ├────────────────────────────────────────────────────────────────────┤ @@ -297,7 +298,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, …). diff --git a/docs/CONTENT-INVENTORY.md b/docs/CONTENT-INVENTORY.md index 87de730..2345bcb 100644 --- a/docs/CONTENT-INVENTORY.md +++ b/docs/CONTENT-INVENTORY.md @@ -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) diff --git a/docs/FEATURES.md b/docs/FEATURES.md index 8f991f4..1e58609 100644 --- a/docs/FEATURES.md +++ b/docs/FEATURES.md @@ -1,6 +1,6 @@ # Complete Feature List -## YTDescGen — All Features (v1.4.0 + Planned) +## YTDescGen — All Features (v1.5.0 + Planned) --- @@ -186,11 +186,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) @@ -208,6 +208,25 @@ 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. + 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 — @@ -354,13 +373,13 @@ 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. @@ -402,27 +421,27 @@ In **Settings › Backup & restore**: ## 🔧 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 | +| **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 diff --git a/docs/PACKAGING.md b/docs/PACKAGING.md index da2e1e4..5e756b5 100644 --- a/docs/PACKAGING.md +++ b/docs/PACKAGING.md @@ -2,7 +2,7 @@ ## YTDescGen — Tauri 2 Desktop and Android Apps -Reflects **v1.4.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). +Reflects **v1.5.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.4.0", + "version": "1.5.0", "identifier": "com.skullmute.ytdescgen", "build": { "beforeBuildCommand": "npm run build", diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 61911ee..41ff0ed 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -2,7 +2,7 @@ ## YTDescGen — Phased Development Plan -> **Status (2026-11-06): v1.4.0 is the current release.** Phases 1–4 are the original +> **Status (2026-11-08): v1.5.0 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. @@ -350,6 +350,13 @@ A **LUT** field in My Rig, printed on its own line under the video editor 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). + --- ## Phase 5 — Extensions & Ecosystem (Priority: P2-P3) @@ -427,4 +434,4 @@ Ideas carried over from the v1.0.0 planning — not scheduled. | Phase 5 | Extensions | Ongoing | — | **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.4.0 (2026-11-06).** +**v1.0.0 shipped on 2026-09-30; the current release is v1.5.0 (2026-11-08).** diff --git a/docs/TECH-SPEC.md b/docs/TECH-SPEC.md index 09de101..37864fb 100644 --- a/docs/TECH-SPEC.md +++ b/docs/TECH-SPEC.md @@ -2,7 +2,7 @@ ## YTDescGen — Implementation Details -Reflects **v1.4.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). +Reflects **v1.5.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.4.0**. The module map and data flow are in [ARCHITECTURE.md](ARCHI ```json { "name": "yt-desc-gen", - "version": "1.4.0", + "version": "1.5.0", "private": true, "license": "Apache-2.0", "type": "module", @@ -345,7 +345,7 @@ 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), + // Video settings: resolution, upscaledFrom (v1.5.0), fps, graphicsPreset (+ graphicsPresetCustom), // skipGraphicsSettings, rayTracingModes, frameGenVendor, frameGenMultiplier, // upscaleQuality, artStyle, videoStyleEra, versionInfo. // Content: timestamps, playlistLink, contactEmail, adEmail, gameKeyEmail, @@ -473,7 +473,7 @@ interface EditorActions { } /** Bump together with a new step in migrateEditorState. */ -export const EDITOR_STORE_VERSION = 20; +export const EDITOR_STORE_VERSION = 21; export const useEditorStore = create()( persist( @@ -507,7 +507,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` = 21 | `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 +520,8 @@ 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. + 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. @@ -645,7 +647,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`: 1065 tests in 52 files at v1.4.0. 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`: 1093 tests in 53 files at v1.5.0. 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. 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): diff --git a/docs/i18n/vi/CONTENT-INVENTORY.md b/docs/i18n/vi/CONTENT-INVENTORY.md index 9f1c918..5a09baf 100644 --- a/docs/i18n/vi/CONTENT-INVENTORY.md +++ b/docs/i18n/vi/CONTENT-INVENTORY.md @@ -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) diff --git a/docs/i18n/vi/DISCLAIMER.md b/docs/i18n/vi/DISCLAIMER.md index 53ccc2f..b05dbac 100644 --- a/docs/i18n/vi/DISCLAIMER.md +++ b/docs/i18n/vi/DISCLAIMER.md @@ -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.4.0 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.0 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. Tuyên bố này áp dụng cho: diff --git a/package-lock.json b/package-lock.json index ca7fd80..3ee0911 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "yt-desc-gen", - "version": "1.4.0", + "version": "1.5.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "yt-desc-gen", - "version": "1.4.0", + "version": "1.5.0", "license": "Apache-2.0", "dependencies": { "@fontsource-variable/inter": "^5.3.0", diff --git a/package.json b/package.json index 1365e62..613c406 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "yt-desc-gen", - "version": "1.4.0", + "version": "1.5.0", "private": true, "license": "Apache-2.0", "type": "module", diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock index 1a817fb..afdf047 100644 --- a/src-tauri/Cargo.lock +++ b/src-tauri/Cargo.lock @@ -5001,7 +5001,7 @@ dependencies = [ [[package]] name = "yt-desc-gen" -version = "1.4.0" +version = "1.5.0" dependencies = [ "serde", "tauri", diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml index df7eb51..4b3861c 100644 --- a/src-tauri/Cargo.toml +++ b/src-tauri/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "yt-desc-gen" -version = "1.4.0" +version = "1.5.0" description = "YouTube Gameplay Description Generator" authors = ["poli0981"] edition = "2021" diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json index 80a4292..217de6b 100644 --- a/src-tauri/tauri.conf.json +++ b/src-tauri/tauri.conf.json @@ -1,7 +1,7 @@ { "$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-cli/schema.json", "productName": "YTDescGen", - "version": "1.4.0", + "version": "1.5.0", "identifier": "com.skullmute.ytdescgen", "build": { "beforeBuildCommand": "npm run build",