- CHANGELOG: the v1.0.0 entry (moving house, new interface, data fixes,
backup & restore, faster entry, catalogs, desktop hardening, CI).
- README: the web app at ytgenerator.stream, what moved from GitHub
Pages, current features, privacy as it is now (Cloudflare delivery,
Turnstile, cookieless analytics on the web only), contacts by purpose;
the dead Discord invite and the old email are gone.
- docs/HOSTING.md (new): Worker routing, cookies, headers, secrets,
one-time dashboard settings, local dev, previews and rollback.
- CLAUDE.md rewritten for the real stack, layout, commands and rules.
- CONTRIBUTING / PR template / issue templates: main-only branching,
the required checks, 8 locales, Android and current versions; issue
links to security advisories, the wiki, Discord and poli0981.dev/links.
- DISCLAIMER (+ Vietnamese), NOTICE: current model disclosure and the
copyright / DMCA contacts. PRIVACY: backup locations and the moving
notice on the old address.
- Version 1.0.0 in package.json, package-lock.json, tauri.conf.json,
Cargo.toml and Cargo.lock.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Storage (desktop):
- The webview can no longer name a path. Five commands that read, wrote,
listed and deleted any path the frontend sent are replaced by name-only
commands (backups, logs) that resolve under the app data folder, and by
export/import commands that open the native dialog from Rust, so the only
file touched is the one the user picked (json/jsonl/txt/csv/md, 20 MB).
The fs and shell plugins are removed (Rust, npm, capabilities).
- The settings "mirror" file is gone: it was written next to the data
folder (a missing path separator) and never read back. On first start
the file becomes a restorable backup — never applied on its own — and
the stray log folder is merged into the right one.
- Automatic backups on desktop: after library changes (quiet 30 s, at most
every 10 min, skipped when unchanged or empty), newest ten kept, plus one
before every restore. Settings lists them with Restore.
- One tray icon, built in code with the app icon (the config entry that
could add a second, iconless one is removed).
Backup & restore (every platform):
- Format 2 files carry each section's store version; imports run the
stores' own migrations (now exported functions), then a whitelist
sanitizer: known fields and values only, editor limits, safe unique ids.
- Reads every earlier export: v0.15-v0.38 envelopes (log exports were
labelled "history"), pre-v0.15 bare arrays, the old desktop data file.
- Restore dialog: new / already here / different per item, merge (keep the
newer one, or both) or replace, section and item selection, one step,
Undo. Newer-version sections are shown, not restored.
- Settings: Back up (choose sections) / Restore / drop a file. Consent and
panel state are never exported or overwritten.
- History export as CSV (spreadsheet-safe) or JSON; logs export as "logs";
dated file names; no more 250 ms timer guessing that a picker was
cancelled.
Library:
- Templates save every editor field; presets save store link types and the
other per-game fields; profiles save donate, community links and the
custom graphics preset. Edit forms can update from the current editor,
start fresh each time they open, and save on Enter. Toasts translated.
Dev: Vite no longer watches src-tauri (cargo's locked .dll crashed
`tauri dev` on Windows).
Verified in `tauri dev` on Windows under a test identifier: legacy file
recovered, old logs merged, auto backup, restore from the legacy backup
with a backup before it.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A new, compact interface on Radix primitives, Motion, cmdk and sonner.
Design system
- Tokens for surfaces, text, accent and states in dark and light, used
everywhere (no more hard-coded red/yellow/pink); Inter and JetBrains
Mono self-hosted; compact controls that grow to 44px on touch screens.
- Primitives rebuilt on Radix: Button, IconButton (cannot render without
a name), Field/Input/Select/Textarea (labels wired to controls; the ten
selects that shared id="type" are gone), Switch, Checkbox, Tabs,
SegmentedControl, Accordion (closed content is inert), Dialog,
AlertDialog, Sheet, Popover, Tooltip, Card, Badge, Banner, EmptyState,
PageHeader, NumberField.
- Animated icons (copy→check, sun↔moon, hover micro-motion on the nav)
that follow the OS reduce-motion setting.
App shell
- Collapsible sidebar with grouped pages and a sliding active marker;
top bar with the command palette, output/interface language, theme
and donate; on phones a bottom bar with four pages plus "More".
- Ctrl/⌘+K command palette: go anywhere, copy title/description/tags,
apply a profile/preset/template, switch theme or languages.
- Skip link, one h1 per page, <main> focusable; toasts no longer share a
corner with three other floating elements.
Pages
- Editor: two columns with a sticky live preview (tabs, counters, copy)
or a sheet on phones; sections reordered so video type and game come
first; genres are a searchable picker instead of a wall of 42 chips;
expand/collapse all; a button to the Output page.
- Output: a YouTube preview (what search results and the "…more" fold
show), language tabs, Copy All in the header (floating on phones).
- Profiles/presets/templates share one card with Apply + Undo; History,
Logs, Batch, Social, Playlist, Settings, About, Legal, the consent
screen and the error pages all use the same primitives.
Fixes
- Ctrl/⌘+Shift+C ignored the YouTube limits and Strict Mode.
- Number settings clamped on every keystroke; they now save on blur.
- Hard-coded English on Playlist, Batch, Logs, Profiles and Settings.
- Flags as language icons (Windows shows letters) → native name + code.
- The consent screen could not change language or theme.
- About: dead Discord invite removed; contact addresses by purpose.
- Desktop window is resizable (1280×820, min 960×640).
Initial load 262 KB gzip (budget 280): the command palette, the genre
list and the Output page load on demand.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
New checks
- security.yml: dependency-review blocks PRs that add a high/critical
advisory; actionlint + zizmor lint the workflows themselves (template
injection, permissions, credential persistence, unpinned uses); OpenSSF
Scorecard weekly and on main (published, not uploaded as alerts).
- compliance.yml: REUSE lint over the whole repo (REUSE.toml + LICENSES/,
no per-file headers) and Conventional-Commit PR titles.
- rust.yml (src-tauri changes + weekly): rustfmt, clippy -D warnings,
cargo test, and cargo-deny for RustSec advisories, licenses and sources.
- ci.yml `check` gains: coverage thresholds (src/engine, worker),
check:licenses, check:bundle, and a `wrangler deploy --dry-run`.
Licensing
- THIRD_PARTY_NOTICES.md is now generated from package.json, the installed
packages and Cargo.toml/Cargo.lock (`npm run generate:third-party`); CI
fails when it is stale or when anything bundled into the app carries a
license outside the allowlist. It had drifted to React 18 / Vite 7 /
Tailwind 3.
- Vite's build.license emits the full text of every bundled package's
license to /licenses/third-party.md (served publicly, before the gate).
Bundle budget
- scripts/check-bundle-size.ts measures what CLAUDE.md's "500KB" never
defined: initial load (everything index.html references) <= 280 KB gzip
(197 KB today) and no JS chunk over 500 KB raw.
Coverage
- @vitest/coverage-v8; thresholds sit just under today's numbers. The
engine is at 89% lines / 64% functions — not the 100% CLAUDE.md claimed.
Supply chain
- Every third-party action pinned to a commit SHA (Dependabot updates the
SHA and its version comment); checkout never persists credentials.
- Release workflows: a `verify` job (typecheck, tests, version sync, Tauri
alignment, tag == package version) gates the build; no dependency caches
in release jobs; permissions granted per job.
- Reusable Discord workflows receive only the secrets they declare instead
of `secrets: inherit` (which exposed the Android signing keys to them).
- Rust: cargo-deny found RUSTSEC-2026-0194/0195 (quick-xml DoS, via plist)
that Dependabot had not raised; plist 1.10 brings quick-xml 0.41.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
One lockfile instead of nine PRs: every minor/patch the open Dependabot PRs
proposed, plus everything else that moved within range.
npm (`npm update --save`)
- react/react-dom 19.3, vite 8.3, i18next 26.4, react-i18next 17.0.15,
react-router 7.18.4, eslint 10.11, typescript-eslint 8.71, knip 6.38,
prettier 3.9.9, @vitejs/plugin-react 6.1, @tauri-apps/* 2.12 / plugins,
@types/*, @testing-library/react, postcss, autoprefixer, tsx.
- Security: vitest + @vitest/mocker 4.1.11 (path traversal via redirect
mock), @humanfs/node 0.16.8 (symlinked copy). `npm audit`: 0.
- Majors stay out (TypeScript 7, Vitest 5, lucide-react 1).
Rust (`cargo update -p tauri …`)
- tauri 2.12, tauri-build 2.7, dialog 2.8, fs 2.6, opener 2.7, shell 2.4,
single-instance 2.5 — matching the npm side minor for minor.
- tauri 2.12 no longer depends on kuchikiki, so `rand` 0.7.3 (the unsound
custom-logger advisory) leaves Cargo.lock entirely. Only glib 0.18 (gtk-rs
0.18 Linux stack) remains ignored.
CI and config
- New `npm run check:tauri`: the tauri CLI refuses to build when the npm
packages and crates differ in major.minor, and CI never runs `tauri build`
— so a one-sided bump merged green and broke the next release tag. Now CI
says which side lags.
- dependabot.yml: 3-day cooldown for version updates (security updates are
exempt), new ui / cloudflare / testing / types groups, rand ignore removed.
- actions/setup-java v5 -> v6 (release-android).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A Worker (worker/) now sits in front of the static build, configured from the
same wrangler.jsonc. Cloudflare builds and deploys it; nothing in GitHub
Actions does.
Gate
- First visit shows a branded check page (8 languages, Accept-Language) with
Cloudflare Turnstile. The token is verified server-side against
TURNSTILE_SECRET: success, hostname, action "enter", age <= 300 s. Only
Cloudflare's own test-key results skip the hostname/action check, so
`npm run cf:dev` works with the published test keys.
- Pass -> `__Host-ytg_gate` (HttpOnly, Secure, SameSite=Lax, 24 h): an HMAC
over expiry + a user-agent hash, keyed from the Turnstile secret, so no
second secret exists and a cookie copied into a scraper is useless.
- The page reloads in place instead of redirecting, so there is no `next`
parameter to open-redirect with; /__gate/status lets the page tell a
cookie-blocking browser what is wrong instead of looping; after one
failure it waits for a click rather than resubmitting.
- Missing secret = deployment mistake: the site stays up without the gate and
the Worker logs it, instead of locking every visitor out.
- The agree box on the gate records `ytg_terms`, which the app reads on boot
so web visitors meet one blocking screen, not two.
Headers and static files
- worker/headers.ts sets CSP (nonce + strict-dynamic on the gate, no script
at all on legal pages), nosniff, Referrer-Policy, Permissions-Policy, COOP,
CORP, X-Frame-Options on everything the Worker returns; _headers covers
the files served directly; a test keeps the two baselines identical.
- `not_found_handling: "404-page"` (a static 404.html) instead of the SPA
fallback, which would have handed index.html past the gate for any
excluded path. The Worker serves the shell itself by fetching "/" - not
"/index.html", which html_handling would 307 back to the home page.
- security.txt (RFC 9116) is generated per build so Expires stays ~6 months
ahead; the Web Analytics beacon is injected into the web build only.
- theme-init.js applies the saved theme before first paint (no inline script).
Legal in-site
- build-plugins/legal-docs.ts renders TERMS, PRIVACY, DISCLAIMER (+ vi),
LICENSE, THIRD_PARTY_NOTICES, SECURITY, NOTICE and CODE_OF_CONDUCT at build
time into static /legal pages (public, before the gate) and a lazy
`virtual:legal-docs` module for the in-app Legal Center, which works
offline on desktop and Android and never leaves the webview.
- PRIVACY, TERMS and SECURITY rewritten for Cloudflare hosting, Turnstile,
Web Analytics and the two cookies; contacts moved to the poli0981.dev
aliases (privacy@, legal@, dmca@, copyright@, security@, code@).
- CURRENT_TERMS_VERSION 1 -> 2: the Privacy Policy changed materially.
App
- Web uses BrowserRouter (real paths; analytics can count them), Tauri keeps
HashRouter; old /#/x bookmarks are rewritten to /x before the router reads
them. Consent is a layout route; /legal sits outside it.
- <html lang> follows the UI language; a stale chunk after a deploy triggers
one reload instead of an error page.
.gitattributes pins LF everywhere so Windows checkouts stop failing Prettier.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Worker connected to ytgenerator.stream was serving a build made for the
GitHub Pages sub-path: index.html asked for /youtube-generator/assets/*.js, the
SPA fallback answered every one of those with index.html, and the site loaded
blank. Both builds are now served from `/`.
- vite.config.ts: base "/" for web and Tauri alike.
- wrangler.jsonc: the one Cloudflare file in the repo. Assets-only for now
(dist/, SPA fallback, custom domain declared so `wrangler deploy` never
detaches it, workers.dev off, build.command runs `npm run build`).
- public/_headers: CSP, nosniff, Referrer-Policy, Permissions-Policy, COOP,
X-Frame-Options; immutable caching for hashed /assets/*. No HSTS - the
zone edge already sends it with preload.
- index.html, manifest, robots, sitemap: canonical/OG/JSON-LD on the new
domain, pt-BR and id added to the locale metadata, Android listed.
- Brand: one SVG source in assets/brand/ now drives the favicon, the PWA
icons (192/512/maskable), apple-touch-icon, a 1200x630 link-preview card
and every Tauri desktop/Android/iOS icon. The desktop and Android apps had
been shipping a flat indigo placeholder square; manifest and index.html
pointed at four PNGs that did not exist. `npm run generate:brand`
re-renders the web images; the Android adaptive icon gets a glyph-only
foreground on the brand colour instead of a tile on a white disc.
- deploy-web.yml and notify-deploy.yml removed, .nojekyll dropped. The last
Pages deployment stays online untouched until the data-migration page
replaces it.
- .node-version pins Node 22 for Workers Builds; wrangler, @tauri-apps/cli
and @resvg/resvg-js are pinned dev dependencies (`npm run cf:dev`,
`npm run cf:check` for a dry-run deploy).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Two new locales, 1,562 strings each, complete: titles, every description
block, all 248 content warnings, tech notes, playthrough notes, pinned
comments, playlist copy, and the whole interface.
Brazil is a top-three market for gameplay viewing and Indonesia the largest in
Southeast Asia. Both use Latin script, so neither needed font or layout work.
**docs/I18N.md was wrong about what registering a locale takes**, and this
release is where that bit. It claimed `SUPPORTED_LANGUAGES` was "the only
registration step". It is one of four, and they fail differently:
SupportedLanguage union compile error
CORE_TAGS_BY_LANG compile error (there are TWO such records,
MULTILINGUAL_TAGS compile error not one — the doc mentioned one)
detectBrowserLanguage SILENT
The silent one matters most: the language works perfectly and simply never
auto-selects for a visitor whose browser is set to it. `SUPPORTED_LANGUAGES`
also wasn't type-bound to the union, and every consumer casts, so a mismatch
between the first two compiled cleanly — it now carries a `satisfies` clause.
`tests/i18n/locale-registration.test.ts` exists to close those gaps: it checks
the picker list against the locale directories on disk in BOTH directions, plus
namespace files, flags, native names and tag pools.
Browser-language detection now matches the full BCP-47 tag before the bare
language, or `pt-BR` would be reduced to `pt` and never found. Any other
Portuguese variant resolves to pt-BR rather than falling through to English.
115 UI keys were not hand-translated at all: their English text is
byte-identical to a string already translated in templates.json (graphics
presets, ray-tracing modes, difficulty names, content-warning labels), so they
are copied across. Translating those twice risks a checkbox and the rendered
description disagreeing about what the same option is called.
Deliberately left in English, matching what the Spanish locale already does:
vendor product names (NVIDIA DLSS, AMD FSR, Intel XeSS, Fluid Motion Frames),
platform brands, hardware acronyms, genre terms that are loanwords in both
languages, and example URLs/emails in placeholders. So pt-BR reads 1,344/1,562
and id 1,308/1,562 "differing from English" — the remainder are those
pass-throughs, not gaps.
Both are AI-translated and NOT native-reviewed. Recorded in DISCLAIMER.md
alongside JA/ES/KO/ZH.
Also replaces `__dirname` in the Vite and Vitest configs with
`import.meta.dirname` — Vite 8's native config loader doesn't provide the CJS
global and warned on every run.
v0.36.0 is skipped: the dependency release shipped first and took 0.37.0.
Tests 692 → 698. Validator now 1,562 keys x 8 locales.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Every major the project had been sitting on, brought current. No user-facing
feature changes; the app should behave identically.
React 18 → 19 (+ types, @vitejs/plugin-react 6)
Tailwind 3 → 4
ESLint 9 → 10 (+ eslint-plugin-react-hooks 5 → 7)
Zustand 4 → 5
i18next 23 → 26, react-i18next 15 → 17
@testing-library/*, typescript-eslint 8.67, Vite/Vitest/tsx/knip patches
**React 19** needed exactly one source change: `useRef<T>(null)` is now typed
`RefObject<T | null>` rather than `RefObject<T>`. The old type quietly claimed a
ref was non-null before its element mounted; ScrollToTopButton now matches,
which makes its existing null check honest rather than defensive.
**Tailwind 4** moves configuration from `tailwind.config.ts` (deleted) into
CSS. The tokens live in an `@theme` block that maps Tailwind's names onto the
existing `:root` / `.light` variables, so the runtime theme toggle still owns
the values and keeps working untouched. `darkMode: "class"` becomes
`@custom-variant dark` — the app toggles a class on <html> rather than
following the OS, so the default prefers-color-scheme variant would be wrong.
Verified in the browser in both themes; a CSS migration fails visually, not at
build time.
**The lint upgrade earned its keep.** `react-hooks/set-state-in-effect` (new in
v7, React Compiler-aware) flagged seven sites. Four were real extra render
passes:
- use-online-status rewritten to `useSyncExternalStore`. It had been
re-reading `navigator.onLine` inside an effect to close the gap between
first render and the listeners attaching — subscribing properly removes the
gap instead of patching it.
- ShortcutHelpModal derives its filter from `open` instead of resetting state
in an effect, so a modal that is closed most of the time stops scheduling
work on unrelated parent updates.
- DraftIndicator and use-languages-ready now guard their setters.
Three remain as warnings, deliberately. They genuinely sync state FROM an
external source (i18next bundle readiness, a text mirror of a numeric store
field, a useMemo the compiler cannot preserve) and need a restructure rather
than a guard. Recorded in eslint.config.js with the reason — downgraded, not
silenced, and not a reason to hold back ESLint 10.
**lucide-react deliberately stays at 0.577.0.** 1.x removes every brand icon;
upstream dropped them for trademark reasons. Taking it would mean either a
generic globe beside a Facebook link or re-adding the marks ourselves and
inheriting the exposure lucide just shed. 0.577 already delivered the win —
main bundle 175 kB → 137 kB.
knip now ignores `tailwindcss`: after the migration its only reference is
`@import "tailwindcss"` in CSS, which knip does not follow.
Full gate green — typecheck, typecheck:all, lint, format:check,
validate:locales, knip, check:version, 692 tests, build — plus a browser check
of both themes with the editor and batch pages functional.
0.36.0 is reserved for the two new locales.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The new grouped Dependabot config opened six PRs within minutes of landing.
Merging them one at a time would mean six lockfile rebases and six CI runs for
what is a single dependency resolution, so this applies all of them together:
i18next-resources-to-backend 1.2.1 → 1.2.3
@tauri-apps/{api,plugin-dialog,plugin-fs,plugin-opener} → latest 2.x
lucide-react 0.400.0 → 0.577.0
eslint + @eslint/js 9.39.4 → 9.39.5, typescript-eslint 8.58 → 8.67
knip 6.14.1 → 6.32.2, prettier 3.8.1 → 3.9.6,
prettier-plugin-tailwindcss 0.6.14 → 0.8.1
vite 8.0.16 → 8.2.1, vitest 4.1.8 → 4.1.10, tsx 4.22 → 4.23,
postcss 8.5.15 → 8.5.26, autoprefixer 10.4.27 → 10.5.4
All within-major; the majors (React 19, Tailwind 4, ESLint 10, i18next 26,
Zustand 5) are held back by the Dependabot ignore rule and belong to their own
planned release.
The `lint-and-format` group's own PR was RED, and correctly so: prettier 3.9
formats six files differently, and Dependabot cannot run `npm run format` for
itself. Reformatted here — which is the format gate doing exactly its job on
its first real outing.
lucide-react's jump also drops the main bundle 175 kB → 137 kB (gzip 48 → 37).
Verified: typecheck, typecheck:all, lint, format:check, validate:locales, knip,
check:version, 692 tests and build all pass, and the app renders with icons
intact in the browser.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Splits SettingsPage (544 → 347 lines), extracting the import/export IO and the
42-input Genre Playlists section — the two pieces with no reason to sit inside
a page component.
Bumps all six version manifests and adds the CHANGELOG entry. `npm run
check:version`, added earlier in this cycle, confirms they agree.
Deliberately NOT split: `description-builder.ts` (974) and `editor-store.ts`
(998). Both are large, but this release changes almost nothing in either, and
carving up a 20-section render pipeline or a migration ladder is a test-heavy
refactor with real regression surface and no connection to guardrails.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
CI ran typecheck/lint/locales/test/build. Everything else the repo owned was
configured but never executed — `knip` was installed and configured yet ran
nowhere, Prettier had a config and no gate, and the six version fields the
release ritual bumps by hand had nothing watching them. This wires all of it
into the pipeline.
Correctness gaps this immediately caught:
- `tsconfig.json` covers only `src`, so tests/ and scripts/ were NEVER
type-checked. Adding `tsconfig.check.json` (+ `typecheck:all`) surfaced 53
errors, including three fields silently missing from the editor→engine
parity fixture: `videoStyleEra` (v0.22.0), `adEmail` + `gameKeyEmail`
(v0.34.0), and the four `endings*` fields (v0.16.0/v0.17.1). The fixture is
the guard against exactly that class of drift, and it had drifted itself.
- `vitest.config.ts` `include` matched only `*.test.ts`, so any `.test.tsx`
would have been collected by nobody and "passed" silently. Now `{ts,tsx}`.
New gates in ci.yml: `typecheck:all`, `format:check`, `knip`, `check:version`,
and an advisory `npm audit --audit-level=high` (advisory so a fresh transitive
advisory cannot redden every unrelated PR before Dependabot opens its fix).
Plus least-privilege `permissions: contents: read` — which also clears the
`actions/missing-workflow-permissions` code-scanning alert — and a
concurrency group that cancels superseded runs everywhere except `main`.
New scripts:
- `scripts/check-version-sync.ts` — asserts all SIX version fields agree
(package.json, package-lock root AND packages[""], tauri.conf.json,
Cargo.toml, Cargo.lock self-entry). Nothing else notices a missed one, and a
stale tauri.conf.json ships an installer that disagrees with its tag.
- `scripts/generate-locale-template.ts` — `npm run generate:locale` has been
advertised in package.json and docs/I18N.md step 1 since v0.1, but the file
was never committed, so the documented first step of adding a language
failed outright. Blocks the planned pt-BR + id work.
Dead code removed: the Rust `ensure_dir` command and its two scoped `opener:`
capabilities. Its documented caller, `openSettingsFolder()`, no longer exists
in `src/` — `opener:default` (all `openExternal` needs) is untouched. Also
`@tauri-apps/plugin-opener` left knip's ignore list now that it is genuinely
imported, and `DroppedReasonId` went from unused export to typing
PlaylistPage's dropped-reason state.
Security: the `js/incomplete-url-substring-sanitization` alert in
description-builder.test.ts was a real (if low-stakes) weak assertion —
`includes("itch.io")` also matches `https://itch.io.example.com/`, so the
test could pass on the wrong line. Now matches the full URL.
CHANGELOG: v0.31.0, v0.32.0 and v0.32.1 shipped as tagged releases but were
never logged, leaving the file jumping v0.33.0 → v0.30.0. Reconstructed from
the release commits in the file's existing house style.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Add a Settings "Split contact email by purpose" toggle (off by default).
When on, the editor exposes three email fields — Contact, Advertising,
and Game keys & playtest — and the description renders a grouped
"BUSINESS / CONTACT" block with one labeled line per non-empty field.
Off keeps the single "Business inquiries" line unchanged.
- New editor fields adEmail/gameKeyEmail (persist v17->v18); contactEmail
is reused as the Contact line, so no saved data moves. The
splitContactEmail toggle mirrors showThirdPartyAds end-to-end
(settings persist v10->v11). Profiles persist v1->v2. All migrations
are additive back-fills.
- +8 ui / +4 templates i18n keys across all six locales (983/563).
- 621 tests pass (613 + 8), typecheck/lint/locale validation green.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Grow the description's COMMUNITY block into the channel's full "join the
chat" hub. Two new dedicated invite fields — Signal
(https://signal.group/#<id>) and the Instagram group chat
(https://www.instagram.com/j/<id> or https://ig.me/j/<id>) — plus
Facebook Group moved out of the generic Social list into its own
facebookGroupLink community field. All three render for every output
language (like Messenger); Zalo stays Vietnamese-only. Block order:
Messenger, Signal, Instagram, Facebook Group, Zalo.
Each new link hard-rejects off-format input via a strict validator
(validateSignalGroupUrl / validateInstagramInviteUrl /
validateFacebookGroupUrl). The three fields thread through defaults, the
store (persist v16 -> v17), GeneratorInput, the editor -> engine mapper,
and template snapshots. The v17 migration lifts a legacy social.fb_group
value into facebookGroupLink and drops the dead key; normalizeEditorPatch
does the same for profiles/presets/templates.
i18n: 9 keys added / 1 removed across all 6 locales + schema
(975 ui / 559 templates). 613 tests pass (was 583). Five manifests
bumped 0.32.1 -> 0.33.0.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
v0.32.0 accepted `https://m.me/[id]` (a personal-page link) for the
Messenger Community field. A community/channel invite is actually
`https://m.me/ch/[id]` (e.g. https://m.me/ch/Abb1hmBhU_97UMCF/).
- Tighten MESSENGER_URL_REGEX to require the /ch/ segment (trailing
slash optional) and hard-reject the old bare form.
- Update the shown example (MESSENGER_URL_EXPECTED) + the 6-locale
placeholder to https://m.me/ch/yourid; refresh stale doc comments.
- Update validation/engine/migrate tests; add trailing-slash accept
and bare-form reject cases.
Engine and store are unchanged (the link is printed verbatim, and the
field type/persist shape is untouched). Bump to v0.32.1.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add two "join the chat" community links that render into a single
"💬 COMMUNITY" description block:
- Messenger community (https://m.me/[id]) — shown for every language.
- Zalo group (https://zalo.me/g/<code>) — Zalo is a Vietnam-audience
app, so the editor input only appears (and the description line only
renders) when the output language is Vietnamese, mirroring the VN
donate block. A value entered while in Vietnamese is preserved if the
creator switches language.
Both links are hard-validated (validateMessengerUrl / validateZaloGroupUrl)
so a malformed URL never reaches the output. New editor-store fields
persist via a v15→v16 migration and round-trip through saved templates.
i18n across all 6 locales (967 ui / 559 templates). Tests 560→581.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Playlist Generator now produces a status-adaptive pinned comment for the
latest video, and when a series is marked dropped, a multi-select of
reasons (predefined checklist + free-text) that render in both the
playlist description and the comment. Localized across all 6 locales.
New buildPlaylistComment engine fn + first tests for playlist-builder.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Playtest section (Store & Social): a signup link + platform dropdown
(Steam Playtest / Epic / itch.io / Discord / Other) + invite count
capped per-platform (≤100). Renders a localized "🧪 PLAYTEST" block in
the description only when a link is set, like Store Links. New config
playtest-platforms.ts; 3 editor fields thread through the store (persist
v14→v15 migration), GeneratorInput, and the editor→engine mapping.
Invalid-number guarding: validateIntegerInRange + validateBatchRange
reject negative / decimal / out-of-range / end<start / >100-span inputs.
Batch and Social bulk disable Generate + warn on a bad range; Playlist
"Total videos" and Playtest invites warn inline and guard the output.
Input primitive gains optional errorText/helpText.
60 new i18n strings across all six locales (validator 948/544). 544
tests (517 + 27), typecheck, lint, and locale validation pass; verified
live. Five manifests bumped 0.29.3 → 0.30.0.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Multi-language Output tabs were rendering content warnings / tech notes / playthrough notes bilingually after v0.29.2 forwarded the shared `tEn` translator. New `bilingualContentBlocks` render option (default true) lets the multi-language hook keep those blocks single-language while the AI-translation disclaimer stays bilingual. Single-language output unchanged.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
useMultilangOutput had drifted out of sync with useGeneratedOutput and never
forwarded showTranslationQuality, showThirdPartyAds, or the always-English tEn
translator to renderAll. As a result the AI-translation disclaimer (and the
identical third-party-ads disclaimer) never appeared when the Output page showed
two or more languages, and the bilingual blocks rendered target-language-only.
Bring the hook to parity with the single-language hook: destructure both
settings, build a memoized tEn, and pass all three into renderAll. Single-language
output and the Batch page were already correct. No engine/store/config/i18n
changes; 513 tests + locale validation (937/542) pass; verified live.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Side-by-side rows that never collapsed on narrow mobile (~360-400px) made
the Batch and Profile screens overrun the viewport horizontally on Android
and web mobile. Make those rows responsive (flex-col -> sm:flex-row) and
sweep a few adjacent overflow spots. Layout-only; desktop is unchanged
(every change gated behind the sm: breakpoint).
- Batch: part-range row stacks below sm (full-width Generate); copy-button
rows wrap.
- Profile: tab pill + Export/Import stack onto separate rows; Profile/
Preset/Template cards stack action buttons below content and let long
names wrap (min-w-0).
- Sweep: Settings responsive padding + wrapping header (Import/Export shows
on Android), VideoSettingsForm grid 1-col below sm, Modal pinned to
calc(100% - 2rem).
Bumps five manifests 0.29.0 -> 0.29.1 (package-lock.json resynced from a
0.28.0 drift). typecheck/lint/locales/513 tests/build all green; verified
live at 375px and 1280px with zero horizontal overflow.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Build and package the app for Android from the same Tauri 2 codebase, shipping
an installable, sideloadable signed APK alongside the desktop binaries.
Build / packaging
- cfg-gate desktop-only tray / single-instance / hide-to-tray / exit-prevention
in lib.rs behind #[cfg(desktop)]; move tauri-plugin-single-instance to a
desktop-only target table so the library compiles for Android.
- `cargo tauri android init` -> committed gen/android Gradle project; release
signingConfigs read keystore.properties (gitignored, from CI secrets locally).
- .github/workflows/release-android.yml: JDK 17 + Android SDK/NDK + rust targets,
decode keystore from secrets, build --apk, upload to the same draft release.
- vite.config.ts: es2020 build.target for Tauri builds (older-WebView safety).
Runtime fixes (found via on-device testing)
- External links: a real tap on `<a target="_blank">` makes the Android WebView
fire onCreateWindow, which Tauri tries to satisfy via the shell plugin's open
(no such binary on Android -> uncaught error, nothing opens). Strip
target="_blank" from external anchors and route clicks through the opener
plugin in the capture phase. (open-external.ts, main.tsx)
- Boot black screen on old WebViews: crypto.randomUUID() (Chrome/WebView 92+)
ran at module load and threw on WebView 91. Fall back to a manual RFC 4122 v4
built on getRandomValues. (uuid.ts; +4 regression tests, 509 -> 513)
- File export on Android routes through the in-WebView blob download. (IS_MOBILE)
Compatibility
- minSdk 30 (Android 11+), targetSdk 36 (Android 16): covers the large majority
of active devices with a modern, patched WebView + Google Play system updates.
Release: bump manifests 0.28.0 -> 0.29.0; docs (README, FEATURES, PACKAGING,
CHANGELOG). Verified on an Android 13 emulator (render, links, export).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Resolves the 4 high-severity esbuild advisories (GHSA-gv7w-rqvm-qjhr,
GHSA-g7r4-m6w7-qqqr) deferred from v0.27.0. esbuild 0.17.0-0.28.0 is
vulnerable; the fix (0.28.1) is only reachable via vite 8 -- vite 7.3.3
pins esbuild ^0.27.0 and cannot reach it. Dev-server-only; the shipped
static bundle was never affected. npm audit: 4 high -> 0.
- vite ^7.3.3 -> ^8.0.16, @vitejs/plugin-react ^4.3.0 -> ^5.2.0,
tsx ^4.16.0 -> ^4.22.4 (vitest 4.1.8 already supports vite 8)
- vite 8 bundles with Rolldown: manualChunks object form -> function
form (vite.config.ts) is the only source change required
- Full gate chain green (typecheck, lint, knip, validate:locales,
500/500 tests, build); dev/preview + Tauri-context build verified
- Bump 5 manifests 0.27.0 -> 0.27.1; CHANGELOG + stack-version docs
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Only English ships in the main chunk (fallbackLng + the engine's
bilingual tEn must resolve synchronously); the 10 non-English locale
JSONs become Vite async chunks fetched on first use via
i18next-resources-to-backend. Main chunk: 594.0 -> 264.0 kB min
(204.3 -> 82.0 kB gzip), back under the 500 kB warning threshold.
Every reactive getFixedT site gates on the new useLanguagesReady hook
(an unloaded language would silently render English — and OutputPage
would save that as a wrong-language history entry); Batch/Social bulk
handlers preload all selected languages before their loops; main.tsx
preloads the persisted UI + output languages before first paint. A
failed chunk fetch is retried once via direct import (i18next pins
failed languages permanently), then logged, degrading to English.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Two new warning groups — Dialogue / Language (10) and Internet / Digital
life (18) — plus 5 color phobias, 5 suggestive-imagery disclosures, 2
body-image phenomena, and an educational/PSA-purpose disclosure: 207 -> 248
ids across 12 groups. 504 new locale strings (84 keys x 6 locales), VI
flag-prone labels masked per the v0.21.0 precedent. Backfills the
content-inventory docs (audio group + v0.23.0 VFX items were never
documented) and replaces the stale v0.7 warning lines in FEATURES.md.
Adds 8 tests incl. a CONTENT_WARNINGS <-> groups parity guard. Five
manifests bumped 0.24.2 -> 0.25.0.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
v0.24.1's Linux job failed on a sustained upstream GitHub-CDN 504 while the AppImage bundler fetched linuxdeploy, so v0.24.1 shipped with only Windows + macOS binaries. Set APPIMAGE_EXTRACT_AND_RUN=1 + NO_STRIP=true on the tauri-action step (fixes the linuxdeploy FUSE run-failure mode + future resilience; no-op on Win/macOS) and bump to 0.24.2 to re-run the full matrix. No application code changes — identical app to v0.24.1.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Security/deps: react-router 6.30.3→6.30.4 (moderate open-redirect patch, non-breaking) and vitest 3.2.4→4.1.8 (clears the dev-only critical Vitest-UI advisory); all 482 tests pass unchanged on the new major. npm audit now reports 0 vulnerabilities. Removed unused serde/serde_json from src-tauri/Cargo.toml (no refs in src-tauri/src/; cargo check confirms the crate still compiles). Documented the cross-post caption generator (Social tab) in README + docs/FEATURES.md. Five manifests bumped 0.24.0→0.24.1.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adds a cross-post caption generator (TikTok 4000 / Instagram Reels 2200 / Facebook Reels 2200) with single + bulk modes and JSON import/export, a header dark/light theme toggle synced with Settings, an opt-in translation-quality notice for non-trusted (non EN/VI) output languages, and a Telegram social link. Fixes a stray 'Pick a DDR generation' warning on the OS Rig field via a pure validateCompositeField helper. Extracts a shared buildBilingualBulletSection helper reused across content warnings, tech notes, the translation notice, and the social-post builder. +28 tests (482 total). Gates green: typecheck, lint, validate:locales, knip, build.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Three concerns bundled per the per-version plan:
1. CHANGELOG catch-up — v0.22.0 was shipped without a `CHANGELOG.md`
entry. Backfilled the missing section (Added / Changed / Removed /
Under the hood) matching v0.21.0's structure.
2. +8 VFX warnings in the `photosensitive` group. New IDs:
`lens_flare_intense`, `bloom_excessive`, `particle_effects_dense`,
`screen_overlay_flashing`, `color_saturation_extreme`,
`motion_blur_heavy`, `depth_of_field_aggressive`,
`post_processing_intense`. Closes the gap between blanket
flashing-lights / strobe warnings and AAA / horror games that ship
intense VFX passes (bloom, particles, post-processing) without ever
triggering a strobe-style flash. Total warnings 187 → 195;
photosensitive group 5 → 13. Engine renders each automatically.
3. macOS + Linux in the OS Rig field. `CompositePart.options` widened
from a static array to a union with `(previousParts) =>
RigFieldOption[]`, plus new optional `labelKeyResolver` (swap
"Version" ↔ "Distro") and `hiddenWhen` (macOS has no Edition slot)
per-part predicates. macOS: 7 versions (10 Mojave-era through 26
Tahoe — the 15 → 26 jump is intentional, matching Apple's 2025
year-aligned numbering). Linux: 7 distros gameplay creators
actually use via Proton (Ubuntu / Fedora / Debian / Arch /
Manjaro / Pop!_OS / Mint) with per-distro version cascading. RAM
(the existing 2-part static composite) is unaffected — the union
accepts arrays unchanged. `RigEditor.renderComposite` walks parts
with a `previousValues` accumulator and resets all downstream
parts on parent change so the form can't end up in an invalid
state (e.g. macOS 11 Pro).
Stats: ui.json 835 → 844 keys (+9 = 8 VFX + 1 os_distro), templates
487 → 495 keys (+8 VFX). 6 locales updated in parallel.
454 tests pass (was 445, +9: 7 OS cascading cases + 1 empty-name
fallback + 1 RAM regression check). Gates green: lint, typecheck,
validate:locales (12/12), test, build. Five manifests bumped
0.22.0 → 0.23.0.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Group A — Warnings expansion + UX cleanup:
- New "audio" content-warning group (12 IDs: ear_piercing,
jumpscare_audio, sudden_volume_changes, distorted_audio,
screeching_metallic, persistent_high_pitch, audio_glitches,
heavy_bass_rumble, screaming_audio, glass_breaking_audio,
microphone_pops, white_noise_static). `loud_noises` migrated from
photosensitive into this dedicated group. Total warnings 175 → 187.
- Remove "Default Genre" from Settings (UI + state + legacy v1→v2
migration + migration tests). `healSettings` now strips both
`defaultGenre` and `defaultGenres` from persisted blobs.
- Remove "Dev Environment" block from About (locked hardcoded specs
that drift on every box upgrade; their wiki link survives in repo).
Group B — Editor additions:
- Video Style era toggle (12 eras: 1980s/90s/00s/10s/20s + modern,
cinematic, retro, vhs, film_noir, anime_mv, documentary). Combines
with `rig.video_editor` to emit a one-line credit like
"Edited in 1990s VHS style using DaVinci Resolve". Renders even
when `skipGraphicsSettings` is on (2D/pixel-art creators still
edit footage). New `src/config/video-styles.ts`; editor-store
persist version bumped 13 → 14 (additive, defensive coercion).
- OS field in My Rig — composite_dropdown following the RAM pattern
(name + version + edition → "Windows 11 Pro"). Windows 10/11 +
Home/Pro/Enterprise/Education/IoT for now; macOS/Linux can be
added later by extending the option arrays.
- `rig.os` locale key added across 6 locales (the rig.* namespace
itself already existed — only the new field's label is new).
Locale stats (per locale): ui.json 816 → 835 keys (+19),
templates.json 473 → 487 keys (+14). 6 locales updated in parallel
(en/vi/ja/es/ko/zh).
Tests: 416 → 445 passing (+29 — audio warnings touch no test, but
new OS composite tests + new video style line tests + reworked
default-genre migration test).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bundles two changes for the v0.20.0 release:
- Content warnings: +50 IDs across three thematic axes. The phobias
group gains 10 weather-related fears (homichlophobia/fog,
lilapsophobia/tornadoes, ombrophobia/rain, nephophobia/clouds,
ancraophobia/wind, cryophobia/cold, heliophobia/sun, cymophobia/waves,
limnophobia/lakes, potamophobia/rivers); 41 -> 51. The sensitive
group gains 20 political/religion/war themes (political_extremism,
religious_extremism, genocide, holy_war, holocaust_themes, civil_war,
mass_shooting, colonialism, propaganda, dystopian_state,
conspiracy_theories, censorship_themes, ethnic_conflict,
refugee_crisis, revolution_themes, assassination, coup_themes,
inquisition, forced_labor, ultranationalism); 29 -> 49. A new
social_phenomena group carries 20 psychological-social IDs that
don't fit clinical mental-health framing (autism_themes,
adhd_themes, hikikomori, neet_themes, social_anxiety_themes,
social_isolation, schizophrenia_themes, burnout_themes,
survivor_guilt, abandonment_themes, parasocial_themes,
gaslighting_themes, stockholm_syndrome, behavioral_addiction,
existential_crisis, impostor_syndrome, midlife_crisis,
quarter_life_crisis, workplace_harassment, masculinity_pressure).
Total content warnings 125 -> 175 across 9 groups (was 8). Fully
translated across all 6 locales. Purely additive.
- Tag generator: strip comma/semicolon/pipe from game names before
they enter the tag list. New sanitizeForTag helper applied to
rawName at generateTags entry and inside tagFriendlyGameName.
Title/description/hashtag paths still read input.gameName verbatim
so original punctuation survives for human copy. Fixes the case
where a game like "Hello, World" produced YouTube-broken composite
tags ("Hello, World gameplay" split at the comma).
Version bumped 0.19.0 -> 0.20.0 across all five manifests.
Pre-release gates green: lint, typecheck, validate:locales (12/12
files complete), 435 tests (+9 new for the tag fix), knip, build,
npm audit (0 vulnerabilities).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bundles five changes for the v0.19.0 release:
- Content warnings: +28 IDs (25 clinical phobias in the phobias group,
3 discrimination terms in the sensitive group); 97 -> 125 total,
fully translated across all 6 locales. Purely additive.
- Dead-code sweep: add knip tooling (knip.json + npm run knip); remove
the unused use-debounce.ts hook and ~13 unreferenced exports; tighten
~12 symbols to module-private.
- Security: npm audit fix for the brace-expansion moderate DoS
(transitive dev dependency, 5.0.5 -> 5.0.6).
- UI: scroll-to-top floating button that scrolls the AppShell <main>.
- Docs: accuracy pass across TECH-SPEC, ROADMAP, FEATURES,
CONTENT-INVENTORY (+ vi mirror), CHANGELOG, README.
Version bumped 0.18.0 -> 0.19.0 across all five manifests.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bundles one new feature, two persistence-layer bug fixes, one cleanup,
and a transparency doc:
- feat: Vietnamese bank dropdown in VietnameseDonateEditor when output
language is `vi`. 30 banks from the SBV 2026 list (Big 4 state-owned
+ top 22 joint-stock + 4 foreign), plus a "Khác (nhập tay)" option
that reveals a free-form text input for unlisted banks. Persisted
shape (`vnBankName: string`) is unchanged.
- fix: UI language reverted to English on every app relaunch because
i18next initialised synchronously while the Zustand persist hydration
was async and nothing bridged the persisted value back to i18n.
App.tsx now reads `appLanguage` at mount and subscribes for future
changes (covers both the synchronous localStorage path and the async
Tauri settings.json path).
- fix: Settings JSON export was dumping the entire on-disk
`settings.json` — which contains every Zustand store's data. The new
exporter writes only the Settings store through the envelope-typed
flow already used by the Profiles tab. Importer rejects pre-v0.18.0
multi-store dumps with a friendly toast instead of silently injecting
profile / template / history rows into the Settings store.
- cleanup: removed the "Open Folder" button from Settings (low usage,
Tauri-only). The `ensure_dir` Rust command stays for other paths.
- docs: new `docs/CONTENT-INVENTORY.md` + Vietnamese mirror listing
every video type (20), genre (41), and content warning (96 across 8
groups) the editor surfaces. Linked from README's Documentation table.
Locale schema +2 keys × 6 locales (vnBankNameSelectPlaceholder,
vnBankNameOther). 720/720 ui keys per locale. 426/426 tests pass.
Bundle 427.46 kB (under 500 kB cap).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Closes the last deferred piece from the v0.16 ending redesign.
Multi-video ending playthroughs (case C) can now flip between
per-video previews of title / description / tags without leaving
the editor.
Key changes:
* `endingVideoIndex` joins `EditorData` (1-indexed, default 1).
Stored on the editor so the creator's pick survives navigating
away and back. Engine already respected the corresponding
`GeneratorInput.endingVideoIndex` since v0.17.0 — this just
persists it.
* "Preview video" Select dropdown in EndingsEditor case C.
Renders `endingVideoCount` options labelled "Video N (X–Y)"
with the matching ending-range bounds. Changing it pipes the
index into the engine, which slices `endings[]` for both
title (buildStructuredEndingLabel) and description
(sliceEndingsForVideo).
* "Previewing Video X of Y — Endings A–B" banner at the top of
Output page when in case C. Persistent reminder so a creator
flipping through videos doesn't forget which slice they're
looking at.
* `use-current-generator-input` forwards `endingVideoIndex` only
when `endingVideoCount > 1` — single-video mode passes
`undefined` so the slice helpers short-circuit to render the
union. Keeps the input cleaner for tests.
* `EndingsEditor.setVideoCount` clamps `endingVideoIndex` down
when the creator shrinks `endingVideoCount` (e.g. 6 → 2 with
index = 4 → snaps to 2) so the preview never targets a
non-existent video.
* Persist version 12 → 13 additive — `endingVideoIndex`
back-fills to 1 on first rehydrate; pre-v0.17.1 drafts with a
stale higher index get clamped to endingVideoCount by
migrateEditorState.
* 3 new locale keys × 6 locales (editor.endings.videoIndexLabel,
editor.endings.videoIndexHint, output.previewingVideo).
718/718 ui per locale.
* 4 new tests for v12→v13 migration (default back-fill, valid
preserved, clamp above max, clamp below 1). Total 426/426.
Bundle: index 473.91 KB (+3 KB). Under 500 KB cap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replaces the freeform "Endings shown" Input in Playthrough Notes
with a structured editor that knows about ending numbers, names,
multi-video splits, and timeline cross-validation. The output
description bullet renders comma-joined structured entries with
fallback to the legacy freeform for migrated drafts.
Key changes:
* New `EndingsEditor` component with three logical cases:
- 1 ending → Number + Name pair with live preview
- 2+ endings, 1 video → table row per ending + timeline gate
(warns when timeline lacks `ending` markers for each row)
- 2+ endings, 2+ videos → endings table + per-video range table
with auto-contiguous balanced split (extras spill into the
LAST video — climactic-final convention) and override support
+ inline overlap/gap/out-of-bounds warnings.
* Schema additions to `EditorData`:
- `endings: EndingEntry[]` ({number, name})
- `endingVideoCount: number`
- `endingVideoRanges: EndingVideoRange[]` (1-indexed inclusive)
- `endingsShown` kept on the type for migration round-trip but
no longer surfaces in the UI.
* Engine `endings-format.ts` — pure helpers used by description
builder + editor preview:
- `formatEndingEntry` (4 cases: both / number-only / name-only
/ neither → null drop signal)
- `sliceEndingsForVideo` (whole-array fallback when not multi-
video / index out of range; targeted slice otherwise)
- `clampRange`
* Timeline parser ending pattern now captures an optional ordinal
so `Ending 3: Best End` parses into `{keyword: "ending",
number: 3, rest: ": Best End"}`. Unblocks the case-B timeline
gate. Renderer collapses trailing whitespace so a bare `Boss`
no longer becomes `Boss `.
* Description builder reads structured `endings[]` first, falls
back to legacy `endingsShown` only when the array is empty.
Multi-row entries render comma-joined; sliced by
`endingVideoIndex` when supplied.
* Migration `migrateEditorState` v11 → v12:
- `liftLegacyEndingString` parses "Ending 3: Best End" /
"Ending 3" / localised "Kết thúc N" / "エンディングN" / etc.
into a single structured row. Unparseable strings fall
through to a name-only row.
- `computeContiguousRanges` builds the default video split.
- Clamps `endingVideoCount` to `[1, endings.length]`.
* 19 new locale keys × 6 locales under `editor.endings.*`
(705/705 keys, up from 686/686). Schema updated.
* 42 new tests (367 → 409): endings-format, editor-store
migration, description-builder structured render, timeline-
parser ending ordinal capture.
* Bundle: index 463.08 KB (+62 KB for new UI + engine). Under
the 500 KB cap.
Migration notes:
* Persisted v0.12–v0.15 drafts auto-lift their `endingsShown`
string into a single structured row on first rehydrate. The
rendered description bullet is byte-identical for the common
case ("True ending only" → "True ending only"). Numbered
legacy strings ("Ending 3: Best End") gain structure so future
edits via the new UI work seamlessly.
* Pre-v0.16 templates with `endings` missing still load — the
TemplateSnapshot type makes all three new fields optional.
* Case C (multi-video) currently renders the union of all
endings in the Output preview. Per-video output rendering is
wired into the engine via `endingVideoIndex` but the UI
selector for it lands in a follow-up patch.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Closes the "black-screen on bad file" class of bugs and gives every
JSON export an auto-detect header so users can no longer confuse
profile / preset / template files with each other.
Key changes:
* `ErrorBoundary` (new) wraps every <Route> in App.tsx plus a
top-level boundary in main.tsx. Catches render-time exceptions
that previously black-screened the app, surfaces a fallback UI
with `Try again` + `Reload page` actions, and copies the error
to the in-app Logs tab via the logger. Per-route boundaries mean
a crash on Profiles cannot take down the Editor.
* File envelope format (`src/utils/file-schema.ts`) — every JSON
export now writes `{ _app: "ytdescgen", _type, _schemaVersion,
_exportedAt, data }`. The `_type` discriminator lets imports
detect "you opened a Template file in Profiles importer" and
offer to auto-switch tabs instead of failing silently. Legacy
bare-array exports still import via shape detection.
* `importTypedFromJsonFile(expected)` returns a discriminated union
with five distinct failure kinds (cancelled / read-failed / empty
/ parse-error / wrong-shape / newer-schema) so every error gets a
targeted toast instead of a generic "Import failed".
* Black-screen root cause fix: null-guard the three-spread chain
`TemplateCard.snapshot` → `editor-store.normalizeEditorPatch` →
`ProfileCard.Object.values(profile.social)`. All three now treat
null/undefined as no-ops. Store-level import validators in
profile/preset/template stores filter rows with missing `id`
before they hit the store, so a malformed file can't even reach
the render path.
* 17 new unit tests in `tests/utils/file-schema.test.ts` cover the
envelope round-trip plus every detection branch. Total 367/367
pass.
Migration notes:
* No store schema bump. v0.14.x persisted state loads unchanged.
* Legacy bare-array export files still import via shape-detector.
Re-export to get the envelope header + tab-switch hints.
* Envelope versions: profile=1, preset=2, template=1, settings=9,
history=2. Bump per-type on a non-additive shape change.
Bundle: index 401 KB, ProfilesPage chunk 18.44 KB. Well under the
500 KB cap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Same-day patch on v0.14.0 closing two desktop-only papercuts.
* `openSettingsFolder()` now pre-creates the app-data directory via a
new `ensure_dir` Tauri command before calling `openPath(dir)`. Fixes
the first-run "Windows cannot find ... AppData\Roaming\
com.skullmute.ytdescgen" Explorer error — `appDataDir()` only
resolves the path string; the folder itself was being created lazily
on the first `save_to_file` write, so users who clicked Open Folder
before any setting had persisted hit the shell with a non-existent
path. `exportSettingsToFile` gets the same guard.
* Adds a Settings → Import button (Tauri-only, next to Export). Reads
via the existing `loadFile()` dialog wrapper, accepts both the
multi-store dump shape that Export produces *and* a bare
SettingsData payload, runs the input through `healSettings()` to
back-fill any missing keys, then dispatches via setState. Five
failure modes get their own toast (cancel, read-error, empty,
parse-error, non-object). Theme class on <html> is re-applied
directly because setState bypasses the setTheme action.
Auto-regenerated Tauri ACL schemas from local tauri-dev (incidental
Tauri-plugin minor versions; not behavioural). package-lock.json
version bump only.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Bumps the six manifest files per the established ritual:
- package.json
- package-lock.json (root version + "" packages entry)
- src-tauri/Cargo.toml
- src-tauri/Cargo.lock (yt-desc-gen entry only)
- src-tauri/tauri.conf.json
`@tauri-apps/api` stays at 2.11.0 (Rust tauri crate is at 2.11.x;
no minor cross-bump needed this cycle).
CHANGELOG.md gains a v0.14.0 section covering the Apache-2.0
license switch, 22 new content-warning IDs (new gameplay_disclosure
group), mobile-responsive layout, and the docs sweep. Also
backfills the missing v0.13.1 hotfix section that the v0.13.1
release-day churn never landed in CHANGELOG.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds canonical Apache License 2.0 text as LICENSE, NOTICE asserting
copyright + AI-assisted-dev disclosure, and the `license` field on
both package.json (npm) and src-tauri/Cargo.toml (Cargo).
Repository previously claimed MIT in README/CLAUDE.md without an
actual LICENSE file. Apache-2.0 was selected for the patent grant
and NOTICE pattern; see docs_guide.txt requirement.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The v0.13.1 rebuild failed because tauri-action's same-minor-version check
caught:
tauri (v2.11.1) : @tauri-apps/api (v2.10.1)
Dependabot's PR #51 bumped the Rust `tauri` crate to 2.11.1 but left the
npm `@tauri-apps/api` package at 2.10.1 (different ecosystem, separate
alert). The constraint `^2.0.0` allowed 2.10.x → 2.11.x but npm doesn't
auto-bump within range; needs explicit `npm install @tauri-apps/api@^2.11.0`.
The four plugin pairs were already aligned (plugin-dialog/fs/opener/shell
Rust crate versions match their npm counterparts exactly), so no other
bumps needed.
Side effect of `npm install`: package.json deps were alphabetized — that's
npm's default key-ordering on save.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Resolves Dependabot alerts:
- vite (GHSA-4w7w-66w2-5vf9, path traversal in optimized deps .map handling,
patched in 6.4.2 — jumping to vite 7 covers it cleanly)
- esbuild (GHSA-67mh-4wv8-2f99, dev server CORS allows arbitrary origins,
pulled transitively via vite 7 / vitest 3)
Dependabot's own PR #54 tried to bump vite to 8 but broke `npm ci` because
@vitejs/plugin-react@4.7.0 caps at vite 7 in its peer-dep range. This bumps
to the latest vite/vitest pair that plugin-react still supports.
Both deps are dev-scope only — no runtime impact on shipped artifacts.
- npm run typecheck — clean
- npm run lint — clean
- npm run test:run — 350/350 pass on vitest 3.2.4
- npm run validate:locales — 663 ui + 346 templates × 6 locales
- npm run build — clean, main bundle 426 KB raw / 133 KB gzip
(vite 7 default chunking runs a bit looser than vite 5's; still well under
the 500 KB CLAUDE.md budget)
No version bump — dev deps don't appear in the shipped artifact.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>