Compare commits

...
165 Commits
Author SHA1 Message Date
poli0981 841df7d246 Merge pull request #146 from poli0981/fix/android-release-upload
fix(ci): upload the Android APK with gh instead of action-gh-release
2026-08-17 12:07:25 +07:00
poli0981andClaude Opus 5 b244063555 fix(ci): upload the Android APK with gh instead of action-gh-release
The v0.35.0 APK built successfully three times and was never attached. The
build was fine every time; the upload step failed with "Resource not accessible
by integration" on update-a-release.

`softprops/action-gh-release@v3` was resolving the target release from
GITHUB_REF rather than from the `tag_name` it was handed. On the tag push it
looked for a release tagged `refs/tags/v0.35.0`; on the workflow_dispatch re-run
it looked for one tagged `refs/heads/main`. Neither exists, so it fell through
to CREATING a release against a branch ref, which the token is quite right to
refuse. The permissions were never the problem — the job log shows
`Contents: write` on every run.

Replaced with `gh release upload`, which is pre-installed on every runner and
takes the tag as a positional argument, so it cannot make that substitution.
`--clobber` makes a re-run idempotent.

Also uploads the APK as a workflow artifact first, so a failed release upload
never costs another 20-minute NDK build to recover from — which is what it cost
to diagnose this.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 12:06:07 +07:00
poli0981 bb0a40cfae Merge pull request #145 from poli0981/chore/v0.37.0-deps
chore: v0.37.0 — dependency modernization
2026-08-17 11:46:29 +07:00
poli0981andClaude Opus 5 0c7fb31165 chore(release): v0.37.0 — dependency modernization
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>
2026-08-17 11:43:51 +07:00
poli0981 11a822a881 Merge pull request #144 from poli0981/docs/v0.35.0
docs: correct the i18n registration claim, document v0.35.0
2026-08-17 11:33:23 +07:00
poli0981andClaude Opus 5 08be7d1ff8 docs: correct the i18n guide's registration claim, document v0.35.0
**docs/I18N.md was wrong in a way that would waste a contributor's afternoon.**
It said adding a locale to `SUPPORTED_LANGUAGES` was "the only registration
step". It is one of four, and the missing ones fail differently: the
`SupportedLanguage` union is a compile error, `MULTILINGUAL_TAGS` is a compile
error, but `detectBrowserLanguage`'s own hardcoded copy of the list fails
*silently* — the language works and simply never auto-selects for a visitor
whose browser is set to it. Also noted: `SUPPORTED_LANGUAGES` is not type-bound
to the union and every consumer casts, so a mismatch compiles cleanly.

Also documents the `--copy-english` / `--force` flags on the locale generator,
which only started existing in v0.35.0 despite having been advertised in
package.json since v0.1.

Elsewhere:

- **DEVELOPMENT.md** — the five new npm scripts, including why `format:check`
  excludes markdown and locale JSON, and why `typecheck:all` exists.
- **TECH-SPEC.md** — the real CI job, a new Field Limits section, and how
  over-limit enforcement derives from the engine's long-ignored `warnings`.
- **ARCHITECTURE.md** — the settings→engine mapping and its two guards, the
  two-source validation state, and an honest note that the first Strict Mode
  implementation typechecked, passed tests, and did nothing.
- **FEATURES.md** — the settings table still listed `Default Genre` and
  `Auto-save Draft`, removed in v0.22.0 and v0.3. Replaced, plus a guardrails
  section.
- **README.md** — guardrails in the feature list, and a link to the wiki.

The wiki itself (12 pages: quick start, glossary, field reference, guardrails,
batch/social, import-export, languages, privacy, troubleshooting, FAQ, release
process) is published separately — it lives in its own repository.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 11:32:09 +07:00
poli0981 03174084cf Merge pull request #143 from poli0981/chore/deps-minor
chore(deps): consolidate the six Dependabot minor bumps
2026-08-17 11:29:16 +07:00
poli0981andClaude Opus 5 d6de8764f1 chore(deps): consolidate the six Dependabot minor bumps into one lockfile
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>
2026-08-17 11:21:30 +07:00
poli0981 ff8c1133e6 Merge pull request #137 from poli0981/dependabot/github_actions/actions-859475a651
ci: bump the actions group with 4 updates
2026-08-17 11:18:43 +07:00
poli0981 c9facc59ec Merge pull request #142 from poli0981/feat/v0.35.0-guardrails
feat: v0.35.0 — guardrails
2026-08-17 11:16:50 +07:00
poli0981andClaude Opus 5 b8f245dee4 chore(release): v0.35.0 — guardrails
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>
2026-08-17 11:15:08 +07:00
poli0981andClaude Opus 5 8c32435d8a fix(strict-mode): derive the gate from state, not from mounted inputs
The first cut had each input register its own error into a shared store as it
rendered, clearing on unmount. That read as reasonable and was quietly useless:
the fields live on the Editor page, the gates live on Batch / Social / Output /
Profiles, and unmounting the Editor took every issue with it. Verified in the
browser — typing a malformed Steam URL, navigating to Batch, and finding
Generate perfectly enabled with no banner.

Replaced with two sources that between them cover what the setting promises:

- `collectEditorIssues` (pure, `@utils/editor-issues`) walks the editor STATE
  against the same validators and the same `PLATFORMS` / `SOCIAL_FIELDS` config
  the inputs use — one rule set, two consumers, no duplicated regexes. This is
  what catches data that never passed through an input at all: an imported
  profile, a preset shared by someone else, a draft persisted before a
  validator got stricter. Since `ValidatedInput` refuses to commit invalid
  text, imports are in fact the main way bad data reaches the store.
- `pending-invalid-store` holds text that is invalid and therefore *not*
  committed. Without it, a field showing a red error would still be invisible
  to every gate, because the store behind it holds the last good value. It has
  no unmount cleanup — that was the original bug — so an entry lives until the
  field is valid again.

Both are filtered through one relevance check, so a field nobody can see never
blocks: `adEmail` / `gameKeyEmail` while the split toggle is off, `zaloGroupLink`
outside Vietnamese output. Without that, Strict Mode could become an
unresolvable dead end — blocked on a field with no visible input to fix it.

Dropping the registry also removes the render-loop hazard it carried: the
effect published on every render of every input, guarded only by a deep-equal
bail-out.

Verified end to end in the browser: a bad Steam URL now disables Generate on
Batch and names the field in the banner; fixing it re-enables; and a Ko-fi link
on a vanity domain shows its inline prefix warning without blocking anything.

Tests 687 → 696.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 11:11:20 +07:00
poli0981andClaude Opus 5 1f9621b5cd feat: enforce the field caps everywhere they can be reached
Completes the field-limit work: `maxLength` is now wired at 53 call sites
across every editor form, the Settings genre-playlist inputs, the save dialogs
and the Playlist notes — grouped by what the field holds rather than named one
by one, so a new input inherits a sensible cap instead of inventing a number.

Two gaps that a `maxLength` attribute alone cannot close:

- **Imports bypass it entirely.** `maxLength` constrains typing and pasting;
  a profile, preset or template — including one saved before the caps existed
  — never passes through an input at all. `normalizeEditorPatch` now clamps on
  the way in, covering the flat fields plus the nested `social` and
  `storeLinks` URL maps. Without this the cap was decorative for exactly the
  path most likely to violate it.
- **Strict Mode could not see any field.** The registry landed in the previous
  commit, but nothing registered with it. Every `ValidatedInput` now carries a
  stable `fieldId` (composed for loop-rendered fields: `editor.social.twitch`,
  `settings.genrePlaylists.horror`), so the banner can name the offending
  input rather than saying "something is wrong".

Also fixed: `liveUrl` was a plain `Input` with no validation at all — the only
URL field in the app that would accept anything and pass it straight into the
description.

Tests 681 → 687.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 11:00:51 +07:00
poli0981andClaude Opus 5 f69941aae3 feat: block copying over-limit output, and add an opt-in Strict Mode
**Over-limit output could always be copied.** `renderAll` has returned
`warnings: CharLimitWarning[]` since v0.5 and nothing in the UI ever read it.
Three ad-hoc checks had grown up in the components instead, each with a
different blind spot:

  - `CopyButton` turned red and stayed clickable.
  - `CopyAllBar` checked title and description but not tags — and bailed out of
    every check when its `extraText` prop was set. Exactly one caller set that
    prop: OutputPage, whenever more than one language was selected. So picking
    a second language silently disabled limit checking on the main copy path.
  - BatchPage passed no limits at all, so a 6000-character description copied
    without a word.

`src/engine/limits.ts` is now the single derivation, and the requested rule is
all-or-nothing per output: if any one of title / description / tags is over,
none of them can be copied. Copying two fields and silently leaving the third
is how a half-populated description gets published.

Scoping decisions worth stating:
  - Batch blocks the offending part's own buttons plus Copy All Batch, but not
    the other 99 parts. Freezing an entire batch because part 7 is three
    characters long would be useless.
  - On Output, per-field buttons use the ACTIVE TAB's status while Copy All
    uses the merge — an over-long Japanese title must not disable the English
    copy button the user is looking at, but it must block the blob containing it.
  - `OutputExtras` (thumbnail text, pinned comment) and Playlist stay ungated:
    different YouTube surfaces with different limits, so reusing YT_LIMITS
    there would be wrong.

Batch also gained the description and tag counters it never had — a row could
be 1500 characters over with nothing on screen saying so. Social bulk Copy All
now respects each platform's own cap (TikTok 4000, Reels 2200).

**Strict Mode** (Settings → Guardrails, default OFF). Blocks Generate, Copy and
Export while any field carries a hard error. This needed something that did not
exist: an app-wide view of which fields are invalid. Every error lived in the
private `useState` of the input that produced it, so no caller could ask the
question. `src/store/validation-store.ts` is that registry — ephemeral, not
persisted, since an error rehydrated from disk would describe text the user can
no longer see.

Errors only. `validateUrlWithPrefix` returns a soft warning for a link that
works but doesn't match a platform's usual prefix; blocking on that would
strand anyone on a vanity domain or a regional mirror.

Two exemptions: the log .txt/.json export stays ungated (a debugging export
must not be held hostage by an unrelated bad URL), and the Editor gets the
banner but no gate — it is where you go to FIX the fields, so disabling
anything there would be backwards. Unmounted fields deregister, so a hidden
`adEmail` or a swapped-out video-type field can never block.

**Settings sections are collapsible.** Genre Playlists renders one input per
genre — 42 of them — and was the tallest block on the page. It now ships
collapsed with a filled-count badge. The other eight sections became accordions
too (defaulting OPEN) because a page mixing bare headings with chevrons reads
as broken, and unknown ids default open so a section added later cannot vanish
for an existing user.

Settings persist v11 → v12 (`strictMode`, `settingsAccordionState`), with
`SCHEMA_VERSIONS.settings` bumped in lockstep. Both are coerced, not just
back-filled: a hand-edited `"strictMode": "yes"` is truthy in JS, and silently
switching a seatbelt on is the opposite of an opt-in. Also corrected
`SCHEMA_VERSIONS.profile` 1 → 2, left behind when profile-store bumped in v0.34.0.

16 UI keys across all six locales (validator 999 ui / 563 templates).
Tests 665 → 681.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 10:56:05 +07:00
dependabot[bot] 913e82f6b5 ci: bump the actions group with 4 updates
Bumps the actions group with 4 updates: [actions/checkout](https://github.com/actions/checkout), [actions/setup-node](https://github.com/actions/setup-node), [actions/cache](https://github.com/actions/cache) and [tauri-apps/tauri-action](https://github.com/tauri-apps/tauri-action).


Updates `actions/checkout` from 6 to 7
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

Updates `actions/setup-node` from 6 to 7
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](https://github.com/actions/setup-node/compare/v6...v7)

Updates `actions/cache` from 5 to 6
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v5...v6)

Updates `tauri-apps/tauri-action` from 0 to 1
- [Release notes](https://github.com/tauri-apps/tauri-action/releases)
- [Changelog](https://github.com/tauri-apps/tauri-action/blob/dev/CHANGELOG.md)
- [Commits](https://github.com/tauri-apps/tauri-action/compare/v0...v1)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: actions/setup-node
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: actions/cache
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: tauri-apps/tauri-action
  dependency-version: '1'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-17 03:42:57 +00:00
poli0981andClaude Opus 5 6e0b02a050 feat: ask where to save exports, and cap what can be typed into a field
Two independent guardrails; both were missing outright rather than broken.

**Exports never asked where to save.** There were two writers that disagreed:
`saveFile` branched correctly per platform but had exactly one caller (the log
.txt export), while every JSON export went through a private blob-download
helper with no platform branch at all. So "Export" on Settings, Profiles,
Presets, Templates, Social and the log JSON dumped straight into Downloads —
even on desktop, where a native Save As dialog had been available and
capability-approved the whole time.

Now one writer, `saveTextFile`, with three branches:
  1. Tauri desktop — native Save As, then the existing `save_to_file` command.
     No Rust or capability change was needed; the permissions were already there.
  2. Web with the File System Access API — a real picker. It must be the FIRST
     await in a click handler because it needs transient user activation, so
     every call site now builds its payload synchronously first. A
     `NotAllowedError` from a spent activation degrades to (3) instead of
     losing the file.
  3. Everything else (Android WebView, Firefox, Safari) — blob download.

`exportTypedToJsonFile` is now async and returns the outcome, so **cancelling
is silent**: dismissing a save dialog is a decision, not a failure, and
toasting "Export failed" at someone who pressed Escape is how people learn to
ignore toasts. The shared `useFileExport` hook holds that rule in one place and
retires the hardcoded English "Exported!" / "Export failed" strings.

Settings Import/Export is no longer desktop-only. That gate was a leftover from
when export meant dumping the on-disk settings.json; import has always been a
plain <input type="file">, and export now offers a real dialog on the web too.

**No field had a length cap** — `maxLength` appeared nowhere in the codebase, so
a pasted novel in the game-name field produced a title YouTube would reject.
`FIELD_LIMITS` groups caps by what a field holds (URL 200, email 320, short
name 100, label 300, long text 2000, timestamps = the 5000 description budget)
so a new input inherits a sensible limit instead of inventing one. `clampField`
covers the paths `maxLength` cannot: profile/preset/template import and
paste-autofill.

**Emails hard-stop at three per field.** The cap is enforced on the increase,
not the absolute count, which buys two things: a field that already holds four
(legacy profile, hand-edited import) stays editable down to three instead of
freezing, and a half-typed `a@b.com,c@` is never punished. Per field rather
than across the split — each of the three renders its own labelled line, so
filling the advertising address must not retroactively invalidate the contact.

**`ValidatedInput` no longer destroys good input.** On an invalid value it used
to call `onChange("")`, wiping the stored value while the box still showed the
user's text — so backspacing one character out of a complete URL silently
emptied the field, and autosave then persisted the empty value with no signal.
It now simply doesn't commit, leaving the last valid value in place; bad input
is kept out just as effectively. Also fixed while here: `displayValue` never
re-synced when the prop changed, so applying a profile or preset left the box
showing stale text that disagreed with the store.

i18n keys for the new strings land in the following commit.

Tests 629 → 655.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 10:41:33 +07:00
poli0981andClaude Opus 5 6b6613cca0 fix(batch): render split contact emails in Batch, and make the drift impossible
Reported: with Settings → "Split contact email by purpose" ON, the Batch tab
showed only the old single "📧 Business inquiries:" line, while the Output tab
correctly showed the grouped 📧 BUSINESS / CONTACT block with all three
addresses.

Root cause is not in the engine. `renderAll` had three call sites, each
hand-copying the same twelve settings fields into an options object, and
BatchPage's copy was missing two: `splitContactEmail` and `showThirdPartyAds`
(plus `tEn`). An absent flag defaults to `false` inside `buildDescription`, so
the else-branch emitted the legacy single line — silently, with no type error
and no failing test, because the engine tests call `buildDescription` directly
with an explicit options object and never exercise the wiring.

Rather than add a third copy of the list, the mapping now lives in one place:

- `SettingsRenderOptions` (settings-derived) is split from
  `RenderOptionOverrides` (per-caller: `tEn`, `bilingualContentBlocks`), and
  `RenderOptions` is their intersection. Same shape as before for `renderAll`.
- New `useRenderOptions` / `buildRenderOptions` produce the settings half; all
  three call sites consume it and layer only their own overrides.

Two guards, both verified to fail when the original bug is reintroduced:

- Compile-time: `buildRenderOptions` builds a `Required<SettingsRenderOptions>`,
  so dropping a key is `TS2741: Property 'splitContactEmail' is missing`.
- Runtime: `tests/hooks/render-options-parity.test.ts` diffs the produced keys
  against `SETTINGS_DERIVED_RENDER_KEYS` in both directions and names the
  offending key in the failure message.

Also fixed by the same change, since Batch was dropping it too:
`showThirdPartyAds` — the SPONSORS & PARTNERS block now renders in Batch.

Batch deliberately still passes no `tEn`: its rows are one language each, so
the bilingual `EN · LOCAL` treatment would duplicate every content-warning line.

Note for the changelog: Batch descriptions get *longer* for anyone who had
either toggle on, because those blocks were being silently dropped.

Tests 621 → 629.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 10:41:33 +07:00
poli0981 31fa18627e Merge pull request #135 from poli0981/chore/security-and-format
ci: enforce existing checks, patch advisories, backfill CHANGELOG
2026-08-17 10:41:30 +07:00
poli0981andClaude Opus 5 7b0189a1f9 test: assert the (free) suffix by adjacency instead of a URL substring
The first attempt at this alert swapped the bare host substring for the full
URL, which CodeQL still flags — `js/incomplete-url-substring-sanitization`
fires on `.includes()` against any URL-shaped value, not on the needle's
length, so the change produced two alerts where there had been one.

A store line renders as `🎮 {label}{suffix}: {url}`, so asserting
`(free): <url>` against the whole description tests the actual adjacency the
case is about, drops `.includes()` entirely, and no longer needs to locate a
line by host at all.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 10:33:57 +07:00
poli0981andClaude Opus 5 d2100d2d40 ci: enforce the checks the repo already had, and close the CHANGELOG gap
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>
2026-08-17 10:28:00 +07:00
poli0981andClaude Opus 5 48d5bb035c style: apply Prettier across src, tests and scripts
`prettier --check` failed on 81 files: the repo had a Prettier config and a
`format` script from day one, but nothing ever enforced them, so formatting
drifted file by file. This is that pass, isolated in its own commit so the
CI gate added alongside it lands on an already-clean tree and no future
feature diff has to carry whitespace noise.

Formatting only — no behavioural change. Verified by `npm run test:run`
(621 passing, unchanged) and `npm run typecheck`.

Markdown, `_schema.json` and the workflow YAML are deliberately excluded:
Prettier reflows prose and expands the locale schema's compact arrays by
~1600 lines, which makes both harder to review for zero benefit. The
`format` script is scoped to `{src,tests,scripts}/**/*.{ts,tsx,css}` to
match.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 10:27:24 +07:00
poli0981andClaude Opus 5 86c5dec087 chore(deps): patch nanoid DoS advisory via npm audit fix
`nanoid` <3.3.18 (GHSA-2v37-7h3g-55p8 — custom generators can loop
indefinitely when size is zero) reached the tree transitively through
postcss. `npm audit` now reports 0 vulnerabilities; the brace-expansion
advisories were cleared separately by #134.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-17 10:16:56 +07:00
poli0981 216eabcec8 Merge pull request #134 from poli0981/dependabot/npm_and_yarn/brace-expansion-1.1.18
chore(deps-dev): bump brace-expansion from 1.1.13 to 1.1.18
2026-08-17 10:16:32 +07:00
poli0981 69f6e32ebf Merge pull request #126 from poli0981/dependabot/cargo/src-tauri/serde_with-3.21.0 2026-08-13 09:45:25 +07:00
poli0981 779aa1943e Merge pull request #131 from poli0981/dependabot/npm_and_yarn/postcss-8.5.25 2026-08-13 09:43:20 +07:00
poli0981 1a67dc6901 Merge pull request #133 from poli0981/dependabot/npm_and_yarn/multi-2181bdc769 2026-08-13 09:42:20 +07:00
dependabot[bot] 967c0c4024 chore(deps-dev): bump brace-expansion from 1.1.13 to 1.1.18
Bumps [brace-expansion](https://github.com/juliangruber/brace-expansion) from 1.1.13 to 1.1.18.
- [Release notes](https://github.com/juliangruber/brace-expansion/releases)
- [Commits](https://github.com/juliangruber/brace-expansion/compare/v1.1.13...v1.1.18)

---
updated-dependencies:
- dependency-name: brace-expansion
  dependency-version: 1.1.18
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-13 02:42:07 +00:00
dependabot[bot] 2408c40e50 chore(deps): bump react-router and react-router-dom
Bumps [react-router](https://github.com/remix-run/react-router/tree/HEAD/packages/react-router) to 7.18.2 and updates ancestor dependency [react-router-dom](https://github.com/remix-run/react-router/tree/HEAD/packages/react-router-dom). These dependencies need to be updated together.


Updates `react-router` from 6.30.4 to 7.18.2
- [Release notes](https://github.com/remix-run/react-router/releases)
- [Changelog](https://github.com/remix-run/react-router/blob/react-router@7.18.2/packages/react-router/CHANGELOG.md)
- [Commits](https://github.com/remix-run/react-router/commits/react-router@7.18.2/packages/react-router)

Updates `react-router-dom` from 6.30.4 to 7.18.2
- [Release notes](https://github.com/remix-run/react-router/releases)
- [Changelog](https://github.com/remix-run/react-router/blob/react-router-dom@7.18.2/packages/react-router-dom/CHANGELOG.md)
- [Commits](https://github.com/remix-run/react-router/commits/react-router-dom@7.18.2/packages/react-router-dom)

---
updated-dependencies:
- dependency-name: react-router
  dependency-version: 7.18.2
  dependency-type: indirect
- dependency-name: react-router-dom
  dependency-version: 7.18.2
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-13 02:41:01 +00:00
poli0981 d955d045f0 Merge pull request #132 from poli0981/dependabot/npm_and_yarn/js-yaml-4.3.1 2026-08-13 09:39:45 +07:00
dependabot[bot] 8c064ebd98 chore(deps-dev): bump js-yaml from 4.2.0 to 4.3.1
Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 4.2.0 to 4.3.1.
- [Changelog](https://github.com/nodeca/js-yaml/blob/4.3.1/CHANGELOG.md)
- [Commits](https://github.com/nodeca/js-yaml/compare/4.2.0...4.3.1)

---
updated-dependencies:
- dependency-name: js-yaml
  dependency-version: 4.3.1
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-12 00:51:36 +00:00
dependabot[bot] e138758656 chore(deps-dev): bump postcss from 8.5.15 to 8.5.25
Bumps [postcss](https://github.com/postcss/postcss) from 8.5.15 to 8.5.25.
- [Release notes](https://github.com/postcss/postcss/releases)
- [Changelog](https://github.com/postcss/postcss/blob/main/CHANGELOG.md)
- [Commits](https://github.com/postcss/postcss/compare/8.5.15...8.5.25)

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

Signed-off-by: dependabot[bot] <support@github.com>
2026-08-02 02:38:44 +00:00
poli0981 9671bca9c4 Merge pull request #127 from poli0981/claude/email-customization-toggle-1afb33
feat: split contact email by purpose behind a toggle (v0.34.0)
2026-07-20 21:02:38 +07:00
poli0981andClaude Opus 4.8 633298c049 feat: split contact email by purpose behind a toggle (v0.34.0)
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>
2026-07-20 20:59:19 +07:00
dependabot[bot] 938d35b613 chore(deps): bump serde_with from 3.18.0 to 3.21.0 in /src-tauri
Bumps [serde_with](https://github.com/jonasbb/serde_with) from 3.18.0 to 3.21.0.
- [Release notes](https://github.com/jonasbb/serde_with/releases)
- [Commits](https://github.com/jonasbb/serde_with/compare/v3.18.0...v3.21.0)

---
updated-dependencies:
- dependency-name: serde_with
  dependency-version: 3.21.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-07-15 23:29:04 +00:00
poli0981 43d850d1d4 Merge pull request #124 from poli0981/claude/community-social-links-7a51c1
feat: Community section — Signal + Instagram links, Facebook Group moved in (v0.33.0)
2026-07-13 19:19:46 +07:00
poli0981andClaude Opus 4.8 10ef68bfdc feat: add Signal + Instagram community links, move Facebook Group (v0.33.0)
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>
2026-07-13 19:18:19 +07:00
poli0981 7e31791439 Merge pull request #122 from poli0981/claude/messenger-community-link-hotfix-f1b3c9
fix: correct Messenger community link format to m.me/ch/ (v0.32.1)
2026-07-12 23:13:51 +07:00
poli0981andClaude Opus 4.8 2d92d5ba81 fix: correct Messenger community link format to m.me/ch/ (v0.32.1)
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>
2026-07-12 23:10:53 +07:00
poli0981 fdb55f3018 Merge pull request #120 from poli0981/claude/zalo-messenger-community-links-a6a29e
feat: add Messenger community + VN Zalo group links (v0.32.0)
2026-07-08 20:51:03 +07:00
poli0981andClaude Opus 4.8 12b0099238 feat: add Messenger community + VN Zalo group links (v0.32.0)
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>
2026-07-08 20:47:53 +07:00
poli0981 e5776fa38c Merge pull request #118 from poli0981/claude/wizardly-tesla-6f470f
feat: playlist pinned-comment + dropped reasons (v0.31.0)
2026-06-28 22:18:23 +07:00
poli0981andClaude Opus 4.8 fe7e89d57e feat: add playlist pinned-comment + dropped reasons (v0.31.0)
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>
2026-06-28 22:15:14 +07:00
poli0981 f637d89aae Merge pull request #116 from poli0981/claude/xenodochial-goldstine-599ba3
feat: Playtest section + invalid-number validation (v0.30.0)
2026-06-27 01:12:21 +07:00
poli0981andClaude Opus 4.8 1e5720eecc feat: add Playtest section and invalid-number validation (v0.30.0)
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>
2026-06-27 01:08:58 +07:00
dependabot[bot] 08ebae0416 chore(deps-dev): bump @babel/core from 7.29.0 to 7.29.7 (#109)
Bumps [@babel/core](https://github.com/babel/babel/tree/HEAD/packages/babel-core) from 7.29.0 to 7.29.7.
- [Release notes](https://github.com/babel/babel/releases)
- [Changelog](https://github.com/babel/babel/blob/main/CHANGELOG.md)
- [Commits](https://github.com/babel/babel/commits/v7.29.7/packages/babel-core)

---
updated-dependencies:
- dependency-name: "@babel/core"
  dependency-version: 7.29.7
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-21 22:12:43 +07:00
dependabot[bot] 546802210e chore(deps-dev): bump js-yaml from 4.1.1 to 4.2.0 (#108)
Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 4.1.1 to 4.2.0.
- [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md)
- [Commits](https://github.com/nodeca/js-yaml/commits)

---
updated-dependencies:
- dependency-name: js-yaml
  dependency-version: 4.2.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-21 22:12:22 +07:00
poli0981andClaude Opus 4.8 da22625178 fix(engine): keep multi-language content blocks single-language (v0.29.3)
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>
2026-06-20 20:33:04 +07:00
poli0981 f53b7df65b Merge pull request #112 from poli0981/claude/serene-taussig-955f69
fix(hooks): AI-translation disclaimer missing in multi-language output (v0.29.2)
2026-06-20 11:27:00 +07:00
poli0981andClaude Opus 4.8 303f978a60 fix(hooks): forward translation-quality toggle to multi-language output (v0.29.2)
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>
2026-06-20 11:25:12 +07:00
poli0981 8405c6fa49 Merge pull request #111 from poli0981/claude/priceless-mayer-d6b5cc
ci(android): bump Node-20 actions to Node-24 majors
2026-06-17 11:47:55 +07:00
poli0981andClaude Opus 4.8 7ea308293a ci(android): bump Node-20 actions to Node-24 majors
GitHub deprecated the Node.js 20 Actions runtime on 2026-06-16 (removal
from runners 2026-09-16). release-android.yml was the only workflow still
pinning actions whose latest-supported runtime was node20; each has a
newer major declaring `runs.using: node24`, so bump to the floating major:

  actions/setup-java          v4 -> v5  (node20 -> node24)
  android-actions/setup-android v3 -> v4 (node20 -> node24; defaults
                                          cmdline-tools 20.0, NDK install
                                          via sdkmanager unaffected)
  actions/cache               v4 -> v5  (node20 -> node24)
  softprops/action-gh-release v2 -> v3  (node20 -> node24)

All four bumps are pure runtime migrations with unchanged inputs. The
node24 majors require Actions Runner >= 2.327.1, which GitHub-hosted
ubuntu-latest already satisfies. ci.yml and release-desktop.yml use only
checkout@v6 / setup-node@v6 (already node24) plus composite actions
(rust-toolchain, tauri-action) that have no Node runtime, so no changes
there. App build node-version (22) is unaffected — this is action
runtimes only. Verified with actionlint (clean) + YAML parse.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 11:43:26 +07:00
poli0981 9f156d1f2c Merge pull request #107 from poli0981/claude/clever-goldberg-557979
fix(ui): mobile viewport overflow on Batch/Profile + sweep (v0.29.1)
2026-06-17 11:06:44 +07:00
poli0981andClaude Opus 4.8 79be06b804 fix(ui): mobile viewport overflow on Batch/Profile + sweep (v0.29.1)
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>
2026-06-17 11:04:42 +07:00
poli0981 b4e32eac63 Merge pull request #106 from poli0981/claude/android-docs
docs(android): requirements + tested versions (11–16, real device Android 12)
2026-06-15 19:29:31 +07:00
poli0981andClaude Opus 4.8 f8ada5944a docs(android): document requirements + tested versions
Add an explicit "Requirements & tested versions" section for the Android build:
- Minimum Android 11 (minSdk 30), target Android 16 (targetSdk 36), universal ABIs.
- Tested Android 11 -> 16 on emulators, plus a real device on Android 12.
- Rationale for the Android 11 floor: device coverage, a modern auto-updating
  WebView (why the Android 12 real device worked but a stale WebView-91 emulator
  black-screened), and component-level security upkeep (Play system updates /
  Play services / WebView) since OS bulletins for 11-13 have ended.

Touches docs/PACKAGING.md, docs/FEATURES.md, README.md only — no code change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 19:28:11 +07:00
poli0981 ca0b795a0d Merge pull request #104 from poli0981/claude/youthful-albattani-95ef02
feat(android): Android (.apk) build + WebView fixes + Android 11+ (v0.29.0)
2026-06-15 18:58:40 +07:00
poli0981andClaude Opus 4.8 89c0e76c2c feat(android): Android (.apk) build + packaging, WebView fixes, Android 11+ (v0.29.0)
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>
2026-06-15 18:56:37 +07:00
poli0981 61281c5815 Merge pull request #102 from poli0981/claude/v0.28.0
feat(legal): first-run consent gate + Windows installer license — v0.28.0
2026-06-13 21:28:18 +07:00
poli0981andClaude Opus 4.8 7caf4180e9 chore(release): bump manifests to 0.28.0
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 21:26:37 +07:00
poli0981andClaude Opus 4.8 521ca559d5 docs(legal): document consent gate in CHANGELOG, FEATURES, PACKAGING, PRIVACY
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 21:26:36 +07:00
poli0981andClaude Opus 4.8 2f84586cf1 feat(legal): add first-run consent gate + Windows installer license
Render a full-screen, non-dismissible consent gate in place of the router
until the user reviews the legal docs (Terms/Privacy/Disclaimer/License,
linked to the GitHub copies) and ticks one 'I agree' box. Acceptance is
recorded in the settings store (legalConsentVersion + timestamp) — no
cookie, no new storage key — and re-prompts only when CURRENT_TERMS_VERSION
is raised, so it is one-time in normal use and re-appears in fresh/incognito
storage.

Also: surface all four docs in About -> Legal (only License was linked
before); add a Windows MSI/NSIS installer license page via bundle.licenseFile;
add an accessible Checkbox primitive; and apply the persisted theme on boot
in main.tsx (fixes a pre-existing dark flash for light-theme users, and makes
the gate render in the right theme before the app shell mounts).

Consent state is additive (no persist version bump); healSettings coerces a
malformed value to 0 so a corrupt file re-shows the gate. 60 new locale
strings (10 keys x 6 languages); validator now 937 ui keys. +9 tests (500 ->
509).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 21:26:00 +07:00
poli0981 6f95d292e6 Merge pull request #100 from poli0981/claude/hopeful-mirzakhani-8581d4
chore(deps): upgrade vite 7→8 to patch esbuild advisories (v0.27.1)
2026-06-13 19:46:49 +07:00
poli0981andClaude Opus 4.8 9554dcc7af chore(deps): upgrade vite 7->8 to patch esbuild advisories (v0.27.1)
Resolves the 4 high-severity esbuild advisories (GHSA-gv7w-rqvm-qjhr,
GHSA-g7r4-m6w7-qqqr) deferred from v0.27.0. esbuild 0.17.0-0.28.0 is
vulnerable; the fix (0.28.1) is only reachable via vite 8 -- vite 7.3.3
pins esbuild ^0.27.0 and cannot reach it. Dev-server-only; the shipped
static bundle was never affected. npm audit: 4 high -> 0.

- vite ^7.3.3 -> ^8.0.16, @vitejs/plugin-react ^4.3.0 -> ^5.2.0,
  tsx ^4.16.0 -> ^4.22.4 (vitest 4.1.8 already supports vite 8)
- vite 8 bundles with Rolldown: manualChunks object form -> function
  form (vite.config.ts) is the only source change required
- Full gate chain green (typecheck, lint, knip, validate:locales,
  500/500 tests, build); dev/preview + Tauri-context build verified
- Bump 5 manifests 0.27.0 -> 0.27.1; CHANGELOG + stack-version docs

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:43:39 +07:00
poli0981 3c667fa8d3 Merge pull request #98 from poli0981/claude/adoring-wilbur-9b3de5
feat(errors): error pages (404/403/419/500) + offline detection — v0.27.0
2026-06-13 19:06:50 +07:00
poli0981andClaude Opus 4.8 03d430d49a chore(release): bump manifests to 0.27.0
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:04:41 +07:00
poli0981andClaude Opus 4.8 114c8d1ec6 docs(errors): document error pages in CHANGELOG, FEATURES, ARCHITECTURE
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:04:33 +07:00
poli0981andClaude Opus 4.8 12b17dbed0 feat(errors): add internationalized error pages + offline detection
Add a reusable, router-agnostic ErrorPage (404/403/419/500/offline/runtime)
driven by a pure config/error-pages.ts kind->meta map. Wire standalone
error routes (/403, /419, /500, /offline) plus a catch-all '*' -> 404 as
siblings of the AppShell group, so they render full-screen with no shell —
closing the long-standing gap where unknown hash routes rendered blank.

Add a navigator.onLine hook + non-blocking, dismissible OfflineBanner (the
app works fully offline, so it never blocks input). Redesign the
ErrorBoundary fallback to reuse ErrorPage's 'contained' runtime variant, so
render crashes share the same localized visual language.

120 new locale strings (20 keys x 6 languages) + _schema.json; validator
now expects 927 ui keys per locale. +6 pure config tests (494 -> 500).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 19:04:02 +07:00
poli0981 10ac1764b4 Merge pull request #94 from poli0981/claude/fervent-feynman-42a586
ci(dependabot): ignore unfixable transitive cargo advisories (rand, glib)
2026-06-12 13:35:28 +07:00
poli0981 107efcb0fa Merge pull request #96 from poli0981/claude/clever-wing-ce2a1f
ci(node): bump workflows from EOL Node 20 to Node 22 LTS
2026-06-12 08:52:10 +07:00
poli0981andClaude Fable 5 12c2fcd01c ci(node): bump workflows from EOL Node 20 to Node 22 LTS
Node 20 reached end-of-life in April 2026 and GitHub is removing it
from runner images (actions/runner-images#14029), so setup-node now
downloads it on every run. Node 22 satisfies Vite 7's engine range
(^20.19 || >=22.12) and matches the docs/TECH-SPEC.md snippets.
Also sync the two doc mentions of CI's Node version.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:49:20 +07:00
poli0981 9faa192ec4 Merge pull request #95 from poli0981/claude/admiring-snyder-a5292f
ci(actions): bump workflow actions to Node 24 majors before June 16 forced migration
2026-06-12 08:43:34 +07:00
poli0981andClaude Fable 5 211d2d8364 ci(test): drop temporary vs2026 build check, record verification
Build-only run 27388695090 on windows-2025-vs2026 produced both MSI
and NSIS bundles cleanly, so windows-latest stays unpinned.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:42:25 +07:00
poli0981andClaude Fable 5 2f50658d89 docs(tech-spec): sync workflow snippets with Node 24 action majors
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:35:17 +07:00
poli0981andClaude Fable 5 bbeae33506 ci(test): temporary build-only check on windows-2025-vs2026
windows-latest redirects to this image from June 15, 2026. Build-only
(no tagName), so no release is touched. Reverted before merge.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:33:33 +07:00
poli0981andClaude Fable 5 0d4f1c7800 ci(actions): bump checkout/setup-node/pages actions to Node 24 majors
GitHub forces the Node 24 runtime for actions on June 16, 2026 and
removes Node 20 from runners September 16, 2026. checkout v4,
setup-node v4, configure-pages v5, upload-pages-artifact v3 and
deploy-pages v4 all declare node20; their current majors (v6/v6/v6/
v5/v5) declare node24. tauri-action@v0 already runs node24 and
dtolnay/rust-toolchain is composite, so both stay.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:33:33 +07:00
poli0981andClaude Fable 5 7ae5da629a ci(dependabot): ignore unfixable transitive cargo advisories (rand, glib)
Dependabot cargo security-update jobs for rand and glib fail with
security_update_not_possible every time Cargo.lock changes on main
(runs 27387346373, 27387346324). Both are transitive deps of tauri:
rand 0.7.3 is pinned to ^0.7 by phf_generator 0.8 (via kuchikiki),
fix is 0.8.6; glib 0.18.5 is pinned by the gtk-rs 0.18 stack, fix is
0.20.0. Cargo cannot resolve the patched versions until tauri bumps
those subtrees, so ignore both to stop the recurring red runs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 08:31:52 +07:00
poli0981 c02464cafb Merge pull request #92 from poli0981/claude/v0.26.0
feat(v0.26.0): lazy-load locale bundles per language
2026-06-12 07:55:15 +07:00
poli0981andClaude Fable 5 c78e49d08b chore(release): bump manifests to 0.26.0
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:53:20 +07:00
poli0981andClaude Fable 5 6f87dfc254 docs(i18n): document lazy-loaded locales in CHANGELOG, I18N, ARCHITECTURE, DEVELOPMENT
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:53:19 +07:00
poli0981andClaude Fable 5 820bbb9369 feat(i18n): lazy-load locale bundles per language
Only English ships in the main chunk (fallbackLng + the engine's
bilingual tEn must resolve synchronously); the 10 non-English locale
JSONs become Vite async chunks fetched on first use via
i18next-resources-to-backend. Main chunk: 594.0 -> 264.0 kB min
(204.3 -> 82.0 kB gzip), back under the 500 kB warning threshold.

Every reactive getFixedT site gates on the new useLanguagesReady hook
(an unloaded language would silently render English — and OutputPage
would save that as a wrong-language history entry); Batch/Social bulk
handlers preload all selected languages before their loops; main.tsx
preloads the persisted UI + output languages before first paint. A
failed chunk fetch is retried once via direct import (i18next pins
failed languages permanently), then logged, degrading to English.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-12 07:52:27 +07:00
poli0981 b522540614 Merge pull request #90 from poli0981/claude/v0.25.0
feat(v0.25.0): +41 content warnings (dialogue + internet/digital groups), inventory docs backfill
2026-06-10 21:47:21 +07:00
poli0981andClaude Fable 5 b8317c2151 feat(v0.25.0): +41 content warnings (dialogue + internet/digital groups), inventory docs backfill
Two new warning groups — Dialogue / Language (10) and Internet / Digital
life (18) — plus 5 color phobias, 5 suggestive-imagery disclosures, 2
body-image phenomena, and an educational/PSA-purpose disclosure: 207 -> 248
ids across 12 groups. 504 new locale strings (84 keys x 6 locales), VI
flag-prone labels masked per the v0.21.0 precedent. Backfills the
content-inventory docs (audio group + v0.23.0 VFX items were never
documented) and replaces the stale v0.7 warning lines in FEATURES.md.
Adds 8 tests incl. a CONTENT_WARNINGS <-> groups parity guard. Five
manifests bumped 0.24.2 -> 0.25.0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 21:44:45 +07:00
poli0981 69ede56493 Merge pull request #88 from poli0981/claude/v0.24.2
ci(v0.24.2): harden Linux AppImage build, rebuild to ship Linux binaries
2026-06-08 14:21:24 +07:00
poli0981andClaude Opus 4.8 8569e1f81b ci(v0.24.2): harden Linux AppImage build, rebuild to ship Linux binaries
v0.24.1's Linux job failed on a sustained upstream GitHub-CDN 504 while the AppImage bundler fetched linuxdeploy, so v0.24.1 shipped with only Windows + macOS binaries. Set APPIMAGE_EXTRACT_AND_RUN=1 + NO_STRIP=true on the tauri-action step (fixes the linuxdeploy FUSE run-failure mode + future resilience; no-op on Win/macOS) and bump to 0.24.2 to re-run the full matrix. No application code changes — identical app to v0.24.1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 14:20:26 +07:00
poli0981 7a5b1f9e87 Merge pull request #85 from poli0981/claude/v0.24.1
chore(v0.24.1): clear npm audit, drop unused Cargo deps, document cross-post generator
2026-06-08 13:27:34 +07:00
poli0981andClaude Opus 4.8 c29e04b15f chore(v0.24.1): clear npm audit, drop unused Cargo deps, document cross-post generator
Security/deps: react-router 6.30.3→6.30.4 (moderate open-redirect patch, non-breaking) and vitest 3.2.4→4.1.8 (clears the dev-only critical Vitest-UI advisory); all 482 tests pass unchanged on the new major. npm audit now reports 0 vulnerabilities. Removed unused serde/serde_json from src-tauri/Cargo.toml (no refs in src-tauri/src/; cargo check confirms the crate still compiles). Documented the cross-post caption generator (Social tab) in README + docs/FEATURES.md. Five manifests bumped 0.24.0→0.24.1.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 13:26:47 +07:00
poli0981 23bec5fbda Merge pull request #83 from poli0981/claude/v0.24.0
feat(v0.24.0): cross-post captions, theme toggle, translation notice, Telegram
2026-06-08 12:30:13 +07:00
poli0981andClaude Opus 4.8 f86469485f feat(v0.24.0): cross-post captions, theme toggle, translation notice, Telegram
Adds a cross-post caption generator (TikTok 4000 / Instagram Reels 2200 / Facebook Reels 2200) with single + bulk modes and JSON import/export, a header dark/light theme toggle synced with Settings, an opt-in translation-quality notice for non-trusted (non EN/VI) output languages, and a Telegram social link. Fixes a stray 'Pick a DDR generation' warning on the OS Rig field via a pure validateCompositeField helper. Extracts a shared buildBilingualBulletSection helper reused across content warnings, tech notes, the translation notice, and the social-post builder. +28 tests (482 total). Gates green: typecheck, lint, validate:locales, knip, build.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 12:28:42 +07:00
poli0981 3783c2b1a5 Merge pull request #79 from poli0981/claude/v0.23.0
feat(v0.23.0): +8 VFX warnings, macOS/Linux OS rig support, CHANGELOG catch-up
2026-05-28 08:04:53 +07:00
poli0981andClaude Opus 4.7 6796c78b7e feat(v0.23.0): +8 VFX warnings, macOS/Linux OS rig support, CHANGELOG catch-up
Three concerns bundled per the per-version plan:

1. CHANGELOG catch-up — v0.22.0 was shipped without a `CHANGELOG.md`
   entry. Backfilled the missing section (Added / Changed / Removed /
   Under the hood) matching v0.21.0's structure.

2. +8 VFX warnings in the `photosensitive` group. New IDs:
   `lens_flare_intense`, `bloom_excessive`, `particle_effects_dense`,
   `screen_overlay_flashing`, `color_saturation_extreme`,
   `motion_blur_heavy`, `depth_of_field_aggressive`,
   `post_processing_intense`. Closes the gap between blanket
   flashing-lights / strobe warnings and AAA / horror games that ship
   intense VFX passes (bloom, particles, post-processing) without ever
   triggering a strobe-style flash. Total warnings 187 → 195;
   photosensitive group 5 → 13. Engine renders each automatically.

3. macOS + Linux in the OS Rig field. `CompositePart.options` widened
   from a static array to a union with `(previousParts) =>
   RigFieldOption[]`, plus new optional `labelKeyResolver` (swap
   "Version" ↔ "Distro") and `hiddenWhen` (macOS has no Edition slot)
   per-part predicates. macOS: 7 versions (10 Mojave-era through 26
   Tahoe — the 15 → 26 jump is intentional, matching Apple's 2025
   year-aligned numbering). Linux: 7 distros gameplay creators
   actually use via Proton (Ubuntu / Fedora / Debian / Arch /
   Manjaro / Pop!_OS / Mint) with per-distro version cascading. RAM
   (the existing 2-part static composite) is unaffected — the union
   accepts arrays unchanged. `RigEditor.renderComposite` walks parts
   with a `previousValues` accumulator and resets all downstream
   parts on parent change so the form can't end up in an invalid
   state (e.g. macOS 11 Pro).

Stats: ui.json 835 → 844 keys (+9 = 8 VFX + 1 os_distro), templates
487 → 495 keys (+8 VFX). 6 locales updated in parallel.
454 tests pass (was 445, +9: 7 OS cascading cases + 1 empty-name
fallback + 1 RAM regression check). Gates green: lint, typecheck,
validate:locales (12/12), test, build. Five manifests bumped
0.22.0 → 0.23.0.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 08:02:50 +07:00
poli0981 3019be0610 Merge pull request #77 from poli0981/claude/sharp-torvalds-dd5813
feat(v0.22.0): audio warnings, video-style era, OS rig field, drop Default Genre + Dev Env
2026-05-28 01:16:34 +07:00
poli0981andClaude Opus 4.7 6ba2acfd7e feat(v0.22.0): +12 audio warnings, video-style era toggle, OS rig field, drop Default Genre + Dev Env
Group A — Warnings expansion + UX cleanup:
- New "audio" content-warning group (12 IDs: ear_piercing,
  jumpscare_audio, sudden_volume_changes, distorted_audio,
  screeching_metallic, persistent_high_pitch, audio_glitches,
  heavy_bass_rumble, screaming_audio, glass_breaking_audio,
  microphone_pops, white_noise_static). `loud_noises` migrated from
  photosensitive into this dedicated group. Total warnings 175 → 187.
- Remove "Default Genre" from Settings (UI + state + legacy v1→v2
  migration + migration tests). `healSettings` now strips both
  `defaultGenre` and `defaultGenres` from persisted blobs.
- Remove "Dev Environment" block from About (locked hardcoded specs
  that drift on every box upgrade; their wiki link survives in repo).

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

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

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

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

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

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

- Content warnings: +50 IDs across three thematic axes. The phobias
  group gains 10 weather-related fears (homichlophobia/fog,
  lilapsophobia/tornadoes, ombrophobia/rain, nephophobia/clouds,
  ancraophobia/wind, cryophobia/cold, heliophobia/sun, cymophobia/waves,
  limnophobia/lakes, potamophobia/rivers); 41 -> 51. The sensitive
  group gains 20 political/religion/war themes (political_extremism,
  religious_extremism, genocide, holy_war, holocaust_themes, civil_war,
  mass_shooting, colonialism, propaganda, dystopian_state,
  conspiracy_theories, censorship_themes, ethnic_conflict,
  refugee_crisis, revolution_themes, assassination, coup_themes,
  inquisition, forced_labor, ultranationalism); 29 -> 49. A new
  social_phenomena group carries 20 psychological-social IDs that
  don't fit clinical mental-health framing (autism_themes,
  adhd_themes, hikikomori, neet_themes, social_anxiety_themes,
  social_isolation, schizophrenia_themes, burnout_themes,
  survivor_guilt, abandonment_themes, parasocial_themes,
  gaslighting_themes, stockholm_syndrome, behavioral_addiction,
  existential_crisis, impostor_syndrome, midlife_crisis,
  quarter_life_crisis, workplace_harassment, masculinity_pressure).
  Total content warnings 125 -> 175 across 9 groups (was 8). Fully
  translated across all 6 locales. Purely additive.

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

Version bumped 0.19.0 -> 0.20.0 across all five manifests.

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

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

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

Version bumped 0.18.0 -> 0.19.0 across all five manifests.

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

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

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

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

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

Key changes:

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

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

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

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

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

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

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

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

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

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

## Structured ending titles

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

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

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

## Logging overhaul

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

## Locale & test churn

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

## Bundle

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

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

Key changes:

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

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

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

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

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

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

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

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

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

Migration notes:

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

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

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

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

Key changes:

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

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

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

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

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

Migration notes:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---------

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

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

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

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

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

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

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

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

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

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

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

B4 — Multi-platform release matrix:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

* chore: update version to 0.8.1

Patch release bumping all four manifest files.

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

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

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

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

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 23:38:38 +07:00
poli0981andClaude Opus 4.7 03bae05f07 chore: update version to 0.8.0 (#35)
* feat(v0.8-polish): VN bank/MoMo/ZaloPay donate, video-settings multi-line, mod-list textarea, template-snapshot fixes

Four small refinements requested before bumping 0.8.0.

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

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

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

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

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

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

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

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

* chore: update version to 0.8.0

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

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

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 22:31:20 +07:00
poli0981andClaude Opus 4.7 39dd346050 feat(v0.8-polish): VN bank/MoMo/ZaloPay donate, video-settings multi-line, mod-list textarea, template-snapshot fixes (#34)
Four small refinements requested before bumping 0.8.0.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 20:41:29 +07:00
poli0981 73af30f6e6 chore: update version to 0.7.0 2026-04-24 21:56:17 +07:00
poli0981andClaude Opus 4.7 66753acce0 feat(v0.7-phase2): pinned-comment templates + playthrough/difficulty/content-warning fields (#31)
Second half of v0.7. Bumps package.json to 0.7.0 and ships the final
feature set for this version. See CHANGELOG.md for the full cumulative
entry covering both phases.

New description fields
- PlaythroughStatus (none / blind / replay / newgame_plus / postgame)
  renders a "🎯 Playthrough: …" line right after the intro.
- DifficultyLevel (none / easy / normal / hard / nightmare / custom)
  renders a "🎮 DIFFICULTY" block after Video Settings. "custom" reveals
  a free-form label that passes through the description untranslated —
  game-specific names like "Lethal" survive a locale switch.
- ContentWarnings (multi-select: flashing_lights / loud_noises /
  jump_scares) render a "⚠️ CONTENT WARNINGS" bulleted block between
  the spoiler and mature warnings.
- All three use a "none" / [] sentinel: creator hasn't picked → section
  is skipped entirely rather than rendered with a blank value.

Pinned-comment template system
- New pure engine module src/engine/pinned-comment-builder.ts composes
  from four shared sub-keys (thanks / playlist / engage / askNextGame)
  plus a per-video-type greeting. Missing per-type greeting falls back
  to greetings.part; missing that too drops the line rather than
  leaking a raw locale key.
- New Settings toggles showPinnedCommentTemplate (default off) and
  pinnedCommentIncludeAskNextGame (default on, only rendered when the
  parent toggle is on).
- OutputExtras renders a third section for the generated template with
  its own copy button, alongside the existing freeform pinnedComment
  field. They coexist as independent sections — no magic precedence.
- BatchPage generates one pinned-comment template per part per language
  with its own copy button; the combined "copy everything" bar includes
  the pinned block when the setting is on.

Refactor: useCurrentGeneratorInput hook
- The editor → GeneratorInput shape used to be copy-pasted across four
  call sites (use-generated-output, use-multilang-output, BatchPage,
  OutputExtras). Extracted into src/hooks/use-current-generator-input.ts
  so future input fields touch one file instead of four.

Store migrations
- Editor store v3 → v4: adds playthroughStatus, difficulty,
  difficultyCustomLabel, contentWarnings. Missing entries back-fill to
  sentinels, so existing drafts round-trip cleanly.
- Settings store v5 → v6: adds showPinnedCommentTemplate and
  pinnedCommentIncludeAskNextGame. Flat booleans pick up via the
  existing healSettings spread.

Locales (6 languages, all in sync)
- ui.json: playthrough / playthroughOptions, difficulty /
  difficultyOptions, difficultyCustomLabel / placeholder, content
  warnings + options, pinnedCommentTemplate label + copy button,
  Settings toggles for the template. (~23 new keys per locale.)
- templates.json: description.sections.{playthrough,difficulty,
  contentWarnings} + description.{playthrough,difficulty,
  contentWarnings} blocks + pinnedComment.{thanksForWatching,
  playlistPrompt, engagementPrompt, askNextGame} + 18 per-video-type
  greetings. (~36 new keys per locale.)
- _schema.json updated. validate:locales passes 314/125 keys across
  all 6 locales.

Tests
- New tests/engine/pinned-comment-builder.test.ts (11 cases): default
  greeting, localized game name, playlist include/exclude,
  includeAskNextGame toggle, per-type greetings (boss, speedrun),
  fallback to `part` greeting when per-type is missing, graceful
  drop-line when even fallback is missing, channelName interpolation,
  empty-locale returns "".
- description-builder.test.ts +8 cases for playthrough / difficulty
  (preset + custom + blank custom) / content warnings (render / empty /
  placement between spoiler & mature).
- settings-heal.test.ts +2 cases for v5 → v6 migration (back-fill
  defaults + preserve user-set values).
- Full suite: 177 / 177 pass.

Version
- package.json 0.7.0-phase1 → 0.7.0.
- New CHANGELOG.md with cumulative v0.7.0 entry.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 21:50:09 +07:00
poli0981andClaude Opus 4.7 c73c51472e feat(v0.7-phase1): title-format settings + reorganized Settings page (#30)
Add user-configurable title formatting so creators can switch the Batch
and Editor output to badge-first styles like "[2k] - Game - phần 1 -
Gameplay No Commentary". Reorganize the Settings page from 5 mixed
sections into 7 purpose-based sections so knobs are easier to locate.

Settings changes
- New nested `titleFormat: { badgePosition, separator, badgeCase }`
  config in SettingsData with defaults that reproduce v0.6 output
  byte-for-byte (middle / emDash / upper).
- Settings store v4 -> v5 with defensive sub-key merge in
  healSettings so a partial titleFormat object keeps working defaults.
- New `setTitleFormat(patch)` action.
- Page split into Appearance / Language & Defaults / Editor / Title /
  Description / Tags / History.

Engine changes
- buildTitle accepts an options bag (BuildTitleOptions) while still
  accepting the legacy boolean third arg, so title-variants.ts and any
  other existing caller keeps working unchanged.
- New composeTitle helper handles prefix / middle / suffix badge
  positions; empty-badge case collapses all three to identical output.
- Separator resolution prefers `title.separators.<id>` with fallback to
  the legacy `title.separator` key so partial locales still render.
- TitleFormatConfig + related types live in engine/types.ts (engine
  stays pure, store re-exports).

Renderer / call sites
- RenderOptions.titleFormat threads through template-renderer into
  buildTitle from useGeneratedOutput, useMultilangOutput, and BatchPage.
- Drive-by fix: useMultilangOutput was missing showSponsorCredit and
  the sponsor fields on its GeneratorInput; added both so multi-lang
  output matches single-lang.

Locales (6 languages)
- templates.json gains `title.separators.{emDash,hyphen,colon,pipe}`.
- ui.json gains the 14 new settings labels (titleFormatTitle,
  descriptionSettingsTitle, badgePosition{Prefix,Middle,Suffix},
  titleSeparator{EmDash,Hyphen,Colon,Pipe}, badgeCase{Upper,Lower}).
- _schema.json updated; `npm run validate:locales` passes 291/291 ui
  keys and 89/89 template keys per locale.

Tests
- 10 new title-builder cases (prefix/middle/suffix, lower-case, hyphen/
  colon/pipe separators, empty-badge collapse, legacy-separator
  fallback, legacy-boolean arg).
- 3 new settings-heal cases (v4 -> v5 back-fill, partial titleFormat
  merge, corrupt non-object titleFormat).
- Full suite: 156/156 pass.

Version
- package.json 0.6.0 -> 0.7.0-phase1. Tag + final 0.7.0 bump will land
  with phase 2 (pinned-comment templates + new description fields).

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 21:22:42 +07:00
303 changed files with 51087 additions and 4625 deletions

No files matched your search

+6
View File
@@ -0,0 +1,6 @@
github: poli0981
ko_fi: skullmute
buy_me_a_coffee: skullmute
patreon: skullmute
custom:
- paypal.me/DungDang212
+99
View File
@@ -0,0 +1,99 @@
name: Bug report
description: Something is broken or behaving unexpectedly.
title: "[Bug]: "
labels: ["bug", "triage"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to file a bug. Please fill in as much detail as you can —
a clear reproduction is the difference between a fix today and a fix in 3 weeks.
- type: input
id: version
attributes:
label: App version
description: From the About page or the title bar. Example `v0.13.0`.
placeholder: v0.13.0
validations:
required: true
- type: dropdown
id: surface
attributes:
label: Where are you running YTDescGen?
options:
- Web (GitHub Pages)
- Desktop — Windows (Tauri)
- Desktop — macOS (Tauri)
- Desktop — Linux (Tauri)
- Local dev (npm run dev)
validations:
required: true
- type: input
id: os
attributes:
label: Operating system
description: e.g. Windows 11 25H2, macOS 14.6, Ubuntu 24.04
validations:
required: true
- type: input
id: browser
attributes:
label: Browser (web only)
description: e.g. Chrome 131, Brave 1.70, Safari 17. Leave blank for desktop.
- type: dropdown
id: language
attributes:
label: App language at the time of the bug
options:
- English (en)
- Tiếng Việt (vi)
- 日本語 (ja)
- Español (es)
- 한국어 (ko)
- 中文 (zh)
validations:
required: true
- type: textarea
id: repro
attributes:
label: Steps to reproduce
description: Numbered steps. Include the exact inputs that triggered the bug.
placeholder: |
1. Open Editor
2. Pick genre "Survival Horror"
3. Toggle "eye_horror" warning
4. Click Generate
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior
validations:
required: true
- type: textarea
id: console
attributes:
label: Console / log output
description: Open DevTools (web) or the log panel (desktop) and paste any errors. Rendered as code.
render: shell
- type: textarea
id: screenshots
attributes:
label: Screenshots / screen recording (optional)
description: Drag and drop images or videos here.
- type: checkboxes
id: checks
attributes:
label: Pre-flight checks
options:
- label: I searched existing issues and this is not a duplicate.
required: true
- label: I'm on the latest released version (or noted my older version above).
required: true
+8
View File
@@ -0,0 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: Discord — General chat
url: https://discord.gg/2aNR3aVt
about: For casual questions, gameplay chat, or quick help. Use a bug report or feature request for anything actionable.
- name: GitHub Discussions
url: https://github.com/poli0981/youtube-generator/discussions
about: Ideas, Q&A, and release announcements live here.
@@ -0,0 +1,48 @@
name: Feature request
description: Suggest a new feature or improvement.
title: "[Feature]: "
labels: ["enhancement", "triage"]
body:
- type: textarea
id: problem
attributes:
label: Problem
description: What pain point or workflow gap are you running into today?
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed solution
description: What should YTDescGen do? Be concrete — UI sketch, example output, etc.
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: Other approaches you thought about and why you ruled them out.
- type: dropdown
id: scope
attributes:
label: Scope
description: Which surfaces does this affect?
multiple: true
options:
- Editor
- Output / preview
- Profiles / presets
- Templates (description, title, tags)
- i18n / locales
- Settings
- Desktop (Tauri)
- Documentation
validations:
required: true
- type: checkboxes
id: checks
attributes:
label: Pre-flight checks
options:
- label: I searched existing issues and this is not a duplicate.
required: true
+47
View File
@@ -0,0 +1,47 @@
## Summary
<!-- 1-3 bullet points describing the change -->
-
-
## Type
- [ ] `feat` — new feature
- [ ] `fix` — bug fix
- [ ] `refactor` — code change with no behavior change
- [ ] `docs` — documentation only
- [ ] `test` — tests only
- [ ] `ci` — CI / build pipeline
- [ ] `chore` — other
## Checklist
- [ ] `npm run typecheck` passes
- [ ] `npm run lint` passes
- [ ] `npm run validate:locales` passes (required if you touched `src/i18n/locales/` or `_schema.json`)
- [ ] `npm run test:run` passes
- [ ] No secrets, credentials, or PII committed
- [ ] No new runtime dependencies without prior discussion in an issue
- [ ] Commit messages follow `type(scope): message`
## UI Changes
<!--
If this PR touches the UI, attach screenshots or short recordings at:
- Desktop (≥1024px)
- Tablet (768px)
- Mobile (390px)
Otherwise delete this section.
-->
## AI-Assisted Contribution
- [ ] Yes — AI tool used: <!-- e.g. Claude Code 4.7 Opus, Cursor, GitHub Copilot -->
- [ ] No
If yes: did you review every line of generated code/text yourself before submitting? <!-- yes/no -->
## Related Issues
<!-- Fixes #123, Closes #456 -->
+73
View File
@@ -0,0 +1,73 @@
# Dependabot configuration.
#
# Three ecosystems: npm (the app), cargo (the Tauri shell), and github-actions
# (the workflows). Security updates are on repo-wide by default; the entries
# below add scheduled VERSION updates so the tree does not silently rot between
# advisories, and carry the ignore rules that keep unfixable alerts quiet.
#
# Why the cargo ignores: `rand` and `glib` are transitive dependencies of tauri,
# and their security fixes require semver-major bumps that the dependency
# tree does not allow, so every Dependabot security-update job for them
# fails with `security_update_not_possible` (runs 27387346373, 27387346324):
#
# rand 0.7.3 (fix: 0.8.6) pinned by
# tauri -> tauri-utils -> kuchikiki -> selectors -> phf_codegen 0.8
# -> phf_generator 0.8 (requires rand ^0.7)
# glib 0.18.5 (fix: 0.20.0) pinned by
# tauri's gtk-rs 0.18 Linux stack (gtk/gdk/gio 0.18 require glib 0.18)
#
# Remove these ignores once tauri updates kuchikiki / the gtk-rs bindings
# (re-check with: cargo update -p rand@0.7.3 --precise 0.8.6 --dry-run).
version: 2
updates:
- package-ecosystem: "npm"
directory: "/"
schedule:
interval: "weekly"
open-pull-requests-limit: 5
commit-message:
prefix: "chore(deps)"
prefix-development: "chore(deps-dev)"
groups:
# One PR per family instead of one per package. A split React or
# typescript-eslint bump is never independently mergeable anyway, and
# CI has to run for each PR.
react:
patterns: ["react", "react-dom", "@types/react", "@types/react-dom"]
i18n:
patterns: ["i18next*", "react-i18next"]
tauri:
patterns: ["@tauri-apps/*"]
lint-and-format:
patterns: ["eslint*", "@eslint/*", "typescript-eslint", "prettier*", "knip"]
build-tooling:
patterns: ["vite", "vitest", "@vitejs/*", "tailwindcss", "postcss", "autoprefixer", "tsx"]
ignore:
# Majors land in their own planned release (see docs/ROADMAP.md) because
# each one needs a real migration — React 19, Tailwind 4 and ESLint 10 all
# change APIs the app uses directly. Dependabot handles minor + patch.
- dependency-name: "*"
update-types: ["version-update:semver-major"]
- package-ecosystem: "cargo"
directory: "/src-tauri"
schedule:
interval: "weekly"
# No version-update PRs; this entry only feeds ignore rules to security
# updates. The Rust side is pinned to whatever tauri's tree allows.
open-pull-requests-limit: 0
ignore:
- dependency-name: "rand"
- dependency-name: "glib"
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
open-pull-requests-limit: 3
commit-message:
prefix: "ci"
groups:
actions:
patterns: ["*"]
+41
View File
@@ -0,0 +1,41 @@
name: Announce Release to Discord
on:
release:
types: [published]
workflow_dispatch:
inputs:
tag:
description: "Existing release tag to re-announce"
required: true
type: string
# `link-discussion` needs `contents: write` (to edit the release) and
# `discussions: write` (so GitHub auto-creates the linked Discussion under
# the configured category). The reusable announce job only needs read.
permissions:
contents: write
discussions: write
jobs:
link-discussion:
runs-on: ubuntu-latest
steps:
- name: Link release to Announcements discussion
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# Setting --discussion-category on a published release causes
# GitHub to auto-create the linked Discussion. Requires the
# repo to have Discussions enabled with an "Announcements"
# category (configured manually under repo Settings).
run: |
gh release edit "${{ github.event.release.tag_name || inputs.tag }}" \
--repo "${{ github.repository }}" \
--discussion-category "Announcements"
announce:
needs: link-discussion
uses: poli0981/.github/.github/workflows/announce-release.yml@main
with:
tag_override: ${{ inputs.tag || '' }}
secrets: inherit
+54 -8
View File
@@ -6,18 +6,64 @@ on:
pull_request:
branches: [main]
# Least privilege. The job only reads the repo — it publishes nothing, comments
# nowhere. Declaring it explicitly also silences CodeQL's
# `actions/missing-workflow-permissions`, which otherwise flags the implicit
# (and much wider) default token scope.
permissions:
contents: read
# A force-push or a quick follow-up commit makes the older run worthless. Cancel
# it instead of paying for both — except on `main`, where every commit's result
# is a historical record the release process reads back.
concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 20
node-version: 22
cache: npm
- run: npm ci
- run: npm run typecheck
- run: npm run lint
- run: npm run validate:locales
- run: npm run test:run
- run: npm run build
# --- correctness ------------------------------------------------------
# `typecheck` covers src/ (what Vite actually builds); `typecheck:all`
# adds tests/ and scripts/, which went unchecked until v0.35.0 and were
# hiding three silently-stale fixture fields.
- name: Type check (src)
run: npm run typecheck
- name: Type check (tests + scripts)
run: npm run typecheck:all
- name: Lint
run: npm run lint
- name: Validate locales
run: npm run validate:locales
- name: Test
run: npm run test:run
# --- consistency ------------------------------------------------------
- name: Check formatting
run: npm run format:check
- name: Check dead code
run: npm run knip
# The release ritual bumps SIX version fields by hand. This is the only
# thing that notices when one is missed — see scripts/check-version-sync.ts.
- name: Check version sync
run: npm run check:version
# --- security ---------------------------------------------------------
# Advisory-only: a fresh high-severity advisory in a transitive dep must
# not turn every unrelated PR red before Dependabot has had a chance to
# open its fix PR. The Dependabot alerts tab is the source of truth.
- name: Audit dependencies
run: npm audit --audit-level=high
continue-on-error: true
# --- build ------------------------------------------------------------
- name: Build
run: npm run build
+6 -6
View File
@@ -16,16 +16,16 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with:
node-version: 20
node-version: 22
cache: npm
- run: npm ci
- run: npm run build
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
- uses: actions/configure-pages@v6
- uses: actions/upload-pages-artifact@v5
with:
path: dist
- id: deployment
uses: actions/deploy-pages@v4
uses: actions/deploy-pages@v5
+19
View File
@@ -0,0 +1,19 @@
name: Notify CI Failures
on:
workflow_run:
# Match the exact `name:` of the CI workflow (.github/workflows/ci.yml).
# Renaming CI silently breaks this filter — keep them in sync.
workflows: ["CI"]
types: [completed]
# REQUIRED: declare permissions matching the reusable workflow's needs.
# Reusable needs `actions: read` to inspect workflow_run details.
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-ci-failure.yml@main
secrets: inherit
+18
View File
@@ -0,0 +1,18 @@
name: Notify Deploy Status
on:
workflow_run:
# Match the exact `name:` of the deploy workflow
# (.github/workflows/deploy-web.yml). Renaming it silently breaks this
# filter — keep them in sync.
workflows: ["Deploy to GitHub Pages"]
types: [completed]
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-deploy.yml@main
secrets: inherit
@@ -0,0 +1,18 @@
name: Notify Release Pipeline
on:
workflow_run:
# Match the exact `name:` of the release-pipeline producers
# (release-desktop.yml + announce-release.yml). Renaming either silently
# breaks this filter — keep them in sync.
workflows: ["Release Desktop", "Announce Release to Discord"]
types: [completed]
permissions:
contents: read
actions: read
jobs:
notify:
uses: poli0981/.github/.github/workflows/notify-release-pipeline.yml@main
secrets: inherit
+108
View File
@@ -0,0 +1,108 @@
name: Release Android
on:
push:
tags: ["v*"]
workflow_dispatch:
inputs:
tag:
description: "Tag to build (e.g. v0.29.0). The manifests must already carry this version."
required: true
type: string
permissions:
contents: write
jobs:
build-android:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
with:
ref: ${{ github.event.inputs.tag || github.ref }}
- uses: actions/setup-node@v7
with:
node-version: 22
cache: npm
- uses: actions/setup-java@v5
with:
distribution: temurin
java-version: "17"
- uses: android-actions/setup-android@v4
- name: Install Android NDK (r27 LTS)
run: sdkmanager "ndk;27.3.13750724"
- uses: dtolnay/rust-toolchain@stable
with:
targets: aarch64-linux-android,armv7-linux-androideabi,i686-linux-android,x86_64-linux-android
- name: Cache cargo
uses: actions/cache@v6
with:
path: |
~/.cargo/registry
~/.cargo/git
src-tauri/target
key: ${{ runner.os }}-android-cargo-${{ hashFiles('src-tauri/Cargo.lock') }}
- run: npm ci
- name: Install Tauri CLI
run: cargo install tauri-cli --version "^2" --locked
- name: Decode keystore
env:
ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
run: echo "$ANDROID_KEYSTORE_BASE64" | base64 -d > "$RUNNER_TEMP/release.jks"
- name: Write keystore.properties
env:
ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
ANDROID_STORE_PASSWORD: ${{ secrets.ANDROID_STORE_PASSWORD }}
run: |
{
echo "storeFile=$RUNNER_TEMP/release.jks"
echo "storePassword=$ANDROID_STORE_PASSWORD"
echo "keyAlias=$ANDROID_KEY_ALIAS"
echo "keyPassword=$ANDROID_KEY_PASSWORD"
} > src-tauri/gen/android/keystore.properties
- name: Build signed APK
env:
# Pin NDK_HOME to the exact version we installed above — the runner may
# ship a different default NDK that ANDROID_NDK_ROOT would point at.
NDK_HOME: ${{ env.ANDROID_HOME }}/ndk/27.3.13750724
run: cargo tauri android build --apk
# Keep the APK regardless of whether the release upload works, so a
# broken upload never costs a 20-minute rebuild.
- name: Upload APK as workflow artifact
uses: actions/upload-artifact@v6
with:
name: ytdescgen-android-apk
path: src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
if-no-files-found: error
# Uses `gh` (pre-installed on every runner) rather than a third-party
# action. `softprops/action-gh-release@v3` resolved the target release
# from GITHUB_REF instead of the `tag_name` it was given, so on a tag push
# it looked for a release tagged `refs/tags/v0.35.0` and on a
# workflow_dispatch it looked for one tagged `refs/heads/main` — neither
# exists, so it tried to CREATE a release on a branch ref and got
# "Resource not accessible by integration". The v0.35.0 APK was built
# three times before this was pinned down.
#
# `gh release upload` takes the tag as a positional argument and cannot
# make that mistake. `--clobber` makes a re-run idempotent.
- name: Upload APK to draft release
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
TAG: ${{ github.event.inputs.tag || github.ref_name }}
APK: src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
run: |
gh release upload "$TAG" "$APK" --clobber --repo "${{ github.repository }}"
+65 -6
View File
@@ -3,6 +3,16 @@ name: Release Desktop
on:
push:
tags: ["v*"]
# Manual re-run hook — lets us rebuild a release without deleting +
# recreating the tag. Useful when a transient runner failure (e.g.
# the macOS DMG bundler hitting an AppleScript flake) costs us one
# arch's binary on an otherwise-shipped tag.
workflow_dispatch:
inputs:
tag:
description: "Tag to build (e.g. v0.9.0). The job still expects the manifests to already carry this version."
required: true
type: string
permissions:
contents: write
@@ -10,26 +20,75 @@ permissions:
jobs:
build:
strategy:
fail-fast: false
matrix:
include:
# windows-latest serves the windows-2025-vs2026 image (VS 2026
# toolchain) from June 15, 2026. Tauri build (MSI + NSIS)
# verified on that exact image 2026-06-12, actions run
# 27388695090 — no runner pin needed.
- os: windows-latest
target: x86_64-pc-windows-msvc
# Default Windows bundles: MSI + NSIS (.exe). Both ship.
bundleArgs: ""
- os: macos-14
target: aarch64-apple-darwin
# macOS DMG bundling on hosted runners flakes inside
# `bundle_dmg.sh` (the AppleScript that sets icon
# positions in the DMG window times out on the headless
# runner). Build only the `.app` bundle; tauri-action
# tar.gzips it into a `.app.tar.gz` for upload. Users
# expand and drag-drop into /Applications.
#
# Intel macOS (x86_64) is NOT built — the `macos-13`
# free runner queue is functionally unavailable since
# GitHub started deprecating it. Revisit with a
# `universal-apple-darwin` build on this same runner if
# Intel support becomes a priority.
bundleArgs: "--bundles app"
- os: ubuntu-latest
target: x86_64-unknown-linux-gnu
# Default Linux bundles: AppImage + deb. Both ship.
bundleArgs: ""
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v7
with:
node-version: 20
# On `workflow_dispatch` checkout the requested tag; on a
# tag push we already get the tag commit by default.
ref: ${{ github.event.inputs.tag || github.ref }}
- uses: actions/setup-node@v7
with:
node-version: 22
cache: npm
- uses: dtolnay/rust-toolchain@stable
with:
targets: ${{ matrix.target }}
- name: Install Linux dependencies
if: matrix.os == 'ubuntu-latest'
run: |
sudo apt-get update
sudo apt-get install -y \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
patchelf
- run: npm ci
- uses: tauri-apps/tauri-action@v0
- uses: tauri-apps/tauri-action@v1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# AppImage bundling on hosted runners flakes: linuxdeploy (itself
# an AppImage) needs FUSE to mount, which GitHub runners don't
# reliably provide → "failed to run linuxdeploy". Extract-and-run
# avoids FUSE; NO_STRIP skips a strip pass that also intermittently
# fails. (No-op on Windows / macOS.) Transient CDN 504s while
# *fetching* linuxdeploy are handled by re-running the job.
APPIMAGE_EXTRACT_AND_RUN: 1
NO_STRIP: true
with:
tagName: v__VERSION__
releaseName: "YTDescGen v__VERSION__"
tagName: ${{ github.event.inputs.tag || 'v__VERSION__' }}
releaseName: "YTDescGen ${{ github.event.inputs.tag || 'v__VERSION__' }}"
releaseBody: "See the assets to download the installer for your platform."
releaseDraft: true
args: ${{ matrix.bundleArgs }} --target ${{ matrix.target }}
+11
View File
@@ -11,3 +11,14 @@ coverage/
.claude/
src-tauri/target/
app-icon.png
# Android (Tauri gen) — the generated Gradle project source IS committed, but
# never the signing secrets, machine-local files, or build artifacts.
*.jks
*.keystore
src-tauri/gen/android/keystore.properties
src-tauri/gen/android/local.properties
src-tauri/gen/android/.gradle/
src-tauri/gen/android/.idea/
src-tauri/gen/android/build/
src-tauri/gen/android/app/build/
+1223
View File
File diff suppressed because it is too large. Load diff
+8 -7
View File
@@ -4,18 +4,18 @@
**YTDescGen** is a desktop-capable web application that generates YouTube video titles, descriptions, and tags for Gameplay No Commentary channels. It supports multiple languages, game genres, and video types with a profile/preset system to eliminate repetitive data entry.
- **Repository**: `github.com/poli0981/yt-desc-gen` (private)
- **License**: MIT
- **Repository**: `github.com/poli0981/youtube-generator`
- **License**: Apache-2.0 (see `LICENSE` + `NOTICE`)
- **Primary Language**: TypeScript
- **Stack**: React 18 + Vite + Tailwind CSS + Zustand + Tauri (desktop)
- **Target Platforms**: Web (GitHub Pages), Desktop (Windows/macOS via Tauri)
- **Stack**: React 18 + Vite 8 + Tailwind CSS 3 + Zustand + Tauri 2 (desktop)
- **Target Platforms**: Web (GitHub Pages), Desktop (Windows/macOS/Linux via Tauri)
## Tech Stack
| Layer | Technology | Why |
|-------|-----------|-----|
| Framework | React 18 | Familiar from F2P tracker dashboard |
| Build | Vite 5 | Fast HMR, clean config |
| Build | Vite 8 | Fast HMR, Rolldown bundler |
| Language | TypeScript (strict) | Type safety for template engine |
| Styling | Tailwind CSS 3 | Utility-first, fast iteration |
| State | Zustand + persist middleware | Simple, localStorage/file persistence |
@@ -40,13 +40,14 @@ yt-desc-gen/
├── index.html
│
├── docs/ # Project documentation
│ ├── PRD.md # Product Requirements Document
│ ├── DEVELOPMENT.md # Toolchain / IDE / build commands (EN)
│ ├── ARCHITECTURE.md # Technical architecture
│ ├── FEATURES.md # Complete feature list
│ ├── ROADMAP.md # Development phases
│ ├── TECH-SPEC.md # Technical specifications
│ ├── I18N.md # Internationalization guide
│ └── PACKAGING.md # Desktop packaging guide
│ ├── PACKAGING.md # Desktop packaging guide
│ └── i18n/vi/ # Vietnamese mirrors (DEVELOPMENT, DISCLAIMER)
│
├── src/
│ ├── main.tsx # Entry point
+22
View File
@@ -0,0 +1,22 @@
# Code of Conduct
This project adopts the **[Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)** in full.
By participating in this project — opening issues, submitting pull requests, commenting, translating locales, or any other form of contribution — you agree to abide by its terms.
## Reporting
Report violations privately to the maintainer: `lopop05905@proton.me`.
All reports are reviewed and investigated promptly and fairly. The maintainer is obligated to respect the privacy and security of the reporter.
## Enforcement
Examples of enforcement actions, in escalating order:
1. A private warning.
2. A public warning on the relevant issue / PR.
3. A temporary ban from contributing.
4. A permanent ban — applied without warning for serious violations (harassment, threats, malicious code submissions per [`CONTRIBUTING.md`](./CONTRIBUTING.md) auto-ignore rules).
For the full list of enforcement guidelines, read the [Contributor Covenant v2.1 — Enforcement Section](https://www.contributor-covenant.org/version/2/1/code_of_conduct/#enforcement).
+80
View File
@@ -0,0 +1,80 @@
# Contributing to YTDescGen
Thanks for taking the time to contribute. Read this once before opening your first PR — it saves time on both sides.
## Code of Conduct
Participation is governed by the [Code of Conduct](./CODE_OF_CONDUCT.md). By contributing, you agree to its terms.
## Getting Started
1. Read the [Development Guide](./docs/DEVELOPMENT.md) — also available in [Vietnamese](./docs/i18n/vi/DEVELOPMENT.md).
2. Install dependencies: `npm install`.
3. Start the dev server: `npm run dev`.
4. Before opening a PR run all gates:
```bash
npm run typecheck
npm run lint
npm run validate:locales
npm run test:run
```
## How to Contribute
### Issues
Use the templates in `.github/ISSUE_TEMPLATE/`:
- **Bug report** — only if you can reproduce on the latest release.
- **Feature request** — only with a concrete use case, not abstract requests.
### Pull Requests
- Branch from `dev`, not `main`.
- Commit format: `type(scope): message` — e.g. `feat(engine): add Spanish template support`. Types: `feat`, `fix`, `refactor`, `docs`, `test`, `ci`, `chore`.
- One logical change per PR. Don't bundle unrelated refactors.
- All locale files must stay in lock-step — see the i18n section below.
- AI-assisted contributions are welcome but **must be disclosed** in the PR description.
### i18n Contributions
If your change adds or removes any user-facing string:
1. Update the locale schema at `src/i18n/locales/_schema.json` first.
2. Add the key to **all 6 locales** (`en` / `vi` / `ja` / `es` / `ko` / `zh`).
3. `npm run validate:locales` must pass.
Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially welcome — see [DISCLAIMER.md](./DISCLAIMER.md) for the current translation-quality status.
## Auto-ignored Contributions
The following are closed without review and may result in a contributor ban — no exceptions:
- **Suspected malicious code.** If a PR contains code we suspect may be a supply-chain attack, obfuscation, credential harvesting, cryptominer, or any form of malware — even if CodeQL and Dependabot don't flag it, the maintainer may investigate manually. **Detection equals ban.**
- **Unverified or suspicious links** in issues, PRs, or comments (pastebin scrapers, redirect chains, unfamiliar shortlinks, link-shortener URLs without context).
- **Behavior or language violating** [GitHub's Acceptable Use Policies](https://docs.github.com/en/site-policy/acceptable-use-policies).
- **Off-topic / rambling reports** that don't get to the point. Example of what gets ignored: *"Good morning, today is a beautiful day, I was just wondering if maybe…"* — get straight to the problem.
- **PRs that touch hundreds of files for a one-line fix** (typical sign of an auto-formatter run on unrelated files).
- **Tests deleted, or `--no-verify` used to bypass pre-commit hooks.**
- **"AI rewrote my entire codebase in a different style" PRs.** AI-assisted edits are welcome (disclosed); whole-repo rewrites are not.
- **Spam, drive-by typo fixes** that don't address a real issue, and karma-farming PRs.
## What We Want
- Bug fixes with a reproduction case and a regression test.
- Locale corrections from native speakers.
- New content-warning IDs with all 6 translations and a clear rationale (especially horror-genre vocabulary).
- New video types or genres that fit the gameplay no-commentary use case.
- Accessibility and mobile-responsive improvements.
- Performance fixes with a `before/after` measurement.
## What We Don't Want
- Cosmetic refactors with no behavior change.
- Adding new runtime dependencies without first opening an issue to discuss the tradeoff.
- Renaming files without coordinating with open PRs.
- Changes to the LICENSE or NOTICE files (these are governance, not contributions).
## License
By contributing, you agree your contribution will be licensed under the [Apache License 2.0](./LICENSE), the same license as the project, and that you have the right to grant that license.
+53
View File
@@ -0,0 +1,53 @@
# Disclaimer
## Solo project, AI-assisted
YTDescGen is a personal project built by a single maintainer (`@poli0981`) for use with the [`@SkullMute`](https://www.youtube.com/@SkullMute) YouTube channel and shared publicly as open source. It is **not a commercial product** and there is no support obligation.
Code, documentation, locale translations, and design decisions in this repository were **co-authored with the assistance of Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. All commits, releases, and architectural decisions are reviewed and approved by the maintainer before merging.
This disclosure applies to:
- Source code in `src/` and `src-tauri/`.
- Documentation in `docs/` and all root markdown files.
- Locale files in `src/i18n/locales/`.
- CI/CD workflows in `.github/workflows/`.
See also: [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) § "AI-Assisted Development Disclosure".
## Translation quality
The application UI ships in six languages. Authoring quality varies:
| Locale | Authoring | Notes |
| --- | --- | --- |
| English (`en`) | Maintainer + AI | Primary working locale. Strings reviewed before commit. |
| Vietnamese (`vi`) | Maintainer (native) + AI | Reviewed by the maintainer, who is a native Vietnamese speaker. |
| Japanese (`ja`) | AI-translated | Not native-reviewed. Grammar and tone may be imperfect. |
| Spanish (`es`) | AI-translated | Not native-reviewed. Regional voice (LatAm vs. Castilian) not specifically targeted. |
| Korean (`ko`) | AI-translated | Not native-reviewed. Honorific register chosen for neutrality, not specific cultural fit. |
| Chinese (`zh`) | AI-translated | Simplified Chinese only. Not native-reviewed. |
If you're a native speaker and spot mistranslations, please open an issue or PR — see [CONTRIBUTING.md](./CONTRIBUTING.md) § "i18n Contributions".
## Voice and tone
Generated description templates use an opinionated tone tailored to the **gameplay no-commentary** YouTube niche, with extra emphasis on horror / scary games (because that's the maintainer's channel). The output may not fit every channel's voice or every country's reader expectations. The application is template-driven — you can edit any generated text before publishing.
Some Vietnamese phrasings deliberately keep loanwords and casual tone reflecting how Vietnamese gameplay creators commonly write descriptions. These are not "incorrect translations"; they are stylistic choices for the target audience.
## No warranty
This software is provided **as-is, with no warranty of any kind**. See [`LICENSE`](./LICENSE) (Apache 2.0) §§ 7 and 8 for the full disclaimer of warranty and limitation of liability.
In plain English: if the application crashes, mangles your draft, generates a description that gets your video flagged by YouTube, or causes any other harm — the maintainer is not liable. Use at your own risk; back up your drafts.
## Not affiliated with YouTube / Anthropic
YTDescGen is **not** affiliated with, endorsed by, or sponsored by YouTube, Google LLC, or Alphabet Inc. The generated output is intended to be pasted into the YouTube Studio editor; this application does not interact with the YouTube API.
Use of Claude Code during development does **not** make this an Anthropic product. Anthropic, Claude, and Claude Code are trademarks of Anthropic, PBC. This project is independent.
## Not legal or financial advice
Any mention of GDPR, CCPA, copyright law, YouTube's monetization policies, or similar topics in this repository's documentation is provided for orientation only and is **not legal advice**. Consult a qualified lawyer in your jurisdiction if you need an authoritative answer.
+201
View File
@@ -0,0 +1,201 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for describing the origin of the Work and
reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Support. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or support.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the License for the specific language governing permissions and
limitations under the License.
+28
View File
@@ -0,0 +1,28 @@
# Maintainers
## Active Maintainers
### `@poli0981`
- **GitHub**: <https://github.com/poli0981>
- **YouTube** (reference channel): <https://www.youtube.com/@SkullMute>
- **Email** (security & private contact): `lopop05905@proton.me`
- **Areas of responsibility**: all — core engine, locale management, UI, Tauri desktop shell, releases, CI/CD.
## Maintainer Responsibilities
- Triage incoming issues and PRs.
- Run the release process: `CHANGELOG.md` entry, version bump, build artifacts, signed tag.
- Enforce the [Code of Conduct](./CODE_OF_CONDUCT.md).
- Review and approve locale translation contributions.
- Coordinate security advisory disclosure per [SECURITY.md](./SECURITY.md).
## Becoming a Maintainer
There is currently no formal pathway. The project has been solo since inception. If you'd like to help maintain a specific area — most realistically, native-speaker review for one of the AI-translated locales (JA / ES / KO / ZH) — open an issue describing what you'd like to take on.
Persistent, high-quality contributions over time are the path. There is no application form.
## Past Maintainers
None — solo project since v0.1.0.
+15
View File
@@ -0,0 +1,15 @@
YTDescGen — YouTube Gameplay Description Generator
Copyright 2026 poli0981 (https://github.com/poli0981)
This product includes software developed by poli0981 and contributors.
Licensed under the Apache License, Version 2.0 (the "License");
see LICENSE for the full terms, or visit:
http://www.apache.org/licenses/LICENSE-2.0
This product was co-developed with the assistance of Anthropic's
Claude Code 4.7 Opus (1M context). See DISCLAIMER.md and
THIRD_PARTY_NOTICES.md for details.
Third-party dependencies retain their respective licenses; see
THIRD_PARTY_NOTICES.md for the complete attribution list.
+75
View File
@@ -0,0 +1,75 @@
# Privacy Policy
**Effective:** 2026-05-14
YTDescGen is an **offline-first** template engine for generating YouTube video metadata. This document describes what data the application handles, where it lives, and what it never collects.
## What We Collect
**Nothing.** The application sends no data to any server controlled by the maintainer.
There is no analytics provider, no telemetry, no crash reporter, no A/B testing, no advertising network, no behavioral tracking. There is no backend.
## What Stays on Your Device
### Web version (GitHub Pages)
The web build stores your work in your browser's **`localStorage`** only. Keys used:
| Key prefix | Purpose |
| --- | --- |
| `ytdesc:editor` | Current editor draft |
| `ytdesc:settings` | Theme, default language, accordion state, hashtag preferences |
| `ytdesc:profiles` | Saved channel / social / rig profiles |
| `ytdesc:presets` | Saved game presets |
| `ytdesc:templates` | Saved full-form snapshots |
| `ytdesc:history` | Recently generated outputs |
| `ytdesc:logs` | Application event log |
`localStorage` is scoped to the origin and never transmitted. Clearing your browser data, browsing in a private/incognito window, or signing out wipes all of it.
### Desktop version (Tauri)
The desktop build uses the operating system's standard application-data directory:
- **Windows**: `%APPDATA%\com.skullmute.ytdescgen`
- **macOS**: `~/Library/Application Support/com.skullmute.ytdescgen`
- **Linux**: `~/.config/com.skullmute.ytdescgen`
The same key set as the web version is stored as JSON files there. Uninstalling the application or deleting that directory removes everything.
## Third-Party Services
The application does **not** call third-party APIs at runtime.
Optional links you may click — donation buttons, store links you paste into a draft, social links you save to your profile — navigate **away** from the application to third-party sites. Those sites have their own privacy policies; the maintainer is not responsible for them.
YouTube oEmbed, the Steam store API, Twitch helix, and similar services are **not** fetched by this application.
## Cookies / Local Storage Distinction
The web version uses **`localStorage`**, not cookies. No cookie is set by the application. GitHub Pages itself may issue a session cookie at the platform level — that is GitHub's, not ours, and is governed by [GitHub's Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement).
The first-run consent acknowledgement (added in v0.28.0) is recorded **inside the existing settings record** — a `legalConsentVersion` number plus a local timestamp — not as a separate cookie or storage key. It never leaves your device.
## Children's Privacy
This application is not directed at children under 13 and does not knowingly process any personal data from anyone.
## GDPR / CCPA / Equivalent Rights
Because no data ever leaves your device:
- **Right to access**: your data is already accessible — open DevTools → Application → Local Storage on the web, or browse the application-data directory on desktop.
- **Right to erasure**: clear your browser's site data (web) or delete the application-data directory / uninstall the app (desktop).
- **Right to portability**: use the in-app **Export** action in `Profiles` / `Presets` / `Templates` / `History` / `Logs` to download JSON.
- **Right to object / restrict processing**: not applicable — no processing happens off-device.
- **Right to know what is sold or shared**: nothing. Nothing is sold or shared.
## Changes to This Policy
If this policy changes, the change is committed to the repository under `PRIVACY.md` with the `Effective` date updated. There is no notification mechanism because the application has no way to reach you.
## Contact
`lopop05905@proton.me`
+113 -34
View File
@@ -1,56 +1,135 @@
# 🎮 YTDescGen
**YouTube Gameplay Description Generator** — A template engine for Gameplay No Commentary channels.
**YouTube Gameplay Description Generator** — an offline-first template engine for Gameplay No Commentary YouTube channels.
Generate YouTube video titles, descriptions, and tags in multiple languages with one click.
Generate YouTube titles, descriptions, and tags in six languages with one click. Save channel, rig, and game presets to skip repetitive data entry. Works in the browser (GitHub Pages), as a ~8 MB native desktop app (Windows / macOS / Linux), or as an installable Android APK — all from one Tauri 2 codebase.
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
[![Node](https://img.shields.io/badge/node-%E2%89%A522-brightgreen)](./docs/DEVELOPMENT.md)
[![Latest release](https://img.shields.io/github/v/release/poli0981/youtube-generator?include_prereleases)](https://github.com/poli0981/youtube-generator/releases)
[![Last commit](https://img.shields.io/github/last-commit/poli0981/youtube-generator)](https://github.com/poli0981/youtube-generator/commits)
---
## What is YTDescGen
YTDescGen is a single-purpose template engine. It does **one** job: turn a small set of structured fields (video type, game name, genres, rig, social links, content warnings, …) into a publish-ready YouTube title + description + tag set.
It doesn't talk to the YouTube API. It doesn't upload anything. It doesn't track you. There is no server. State lives in your browser's `localStorage` (web) or your OS application-data directory (desktop) — and nowhere else.
Built for the gameplay no-commentary niche — especially horror / scary games — by someone running the [@SkullMute](https://www.youtube.com/@SkullMute) channel who got tired of pasting the same boilerplate into every video. Released under Apache 2.0 in case it's useful to anyone else.
## Features
- **14 video types** — Full Gameplay, Part, Boss Fight, Speedrun, 100%, DLC, and more
- **12 languages** — English, Vietnamese, Japanese, Spanish, Korean, Chinese, and more
- **25 game genres** — Action, Horror, RPG, FPS, Open World, Souls-like, and more
- **Profile system** — Save social/rig/channel info once, reuse forever
- **Game presets** — Save game info once, reuse for multi-part series
- **Smart tags** — Auto-generated from genre + platform + quality + multilingual
- **Character counters** — Real-time limits for title (100), description (5000), tags (500)
- **Batch mode** — Generate descriptions for multiple parts at once
- **Desktop app** — Windows & macOS via Tauri (~8MB binary)
- **Offline** — Full functionality without internet
- **20 video types** — Full Gameplay, Part, Boss Fight, Boss No-Hit, Ending, Speedrun, 100%, DLC, NG+, Challenge, Side Quest, Secret, Comparison, Guide, Mods, Collectibles, Livestream, Gacha Quest, Demo, Demo Part.
- **6 UI languages** — English, Vietnamese, Japanese, Spanish, Korean, Chinese. *(VI authored by a native speaker; JA / ES / KO / ZH AI-translated — see [DISCLAIMER.md](./DISCLAIMER.md).)*
- **40+ game genres** — across action, RPG, FPS, horror, soulslike, indie, simulation, fighting, and more.
- **248 content-warning IDs** across 12 groups — spoilers, photosensitive/VFX, audio, dialogue/language, phobias (incl. color phobias), mental health, social phenomena, internet/digital life, sensitive themes (incl. method-specific death/violence and suggestive imagery), horror-specific, playstyle, and gameplay disclosure (mods / cheats / glitches / guide-assisted / educational purpose). Sets viewer expectations before they hit play.
- **Profile system** — save channel / social / rig info once, reuse across every video.
- **Game presets** — save game name + store links once, reuse across the entire part series.
- **Snapshot templates** — save full-form configurations and recall in one click.
- **Smart tag generation** — combines genre pool, platform, quality tier, multilingual hooks, and trending terms; auto-dedup and 500-char-limit aware.
- **Character counters** — real-time limits for title (100), description (5000), tags (500). If **any one** is over, no field can be copied — partial copying is how a half-finished description gets published.
- **Guardrails** — hard length caps on every input field, a three-address cap per email field, and an opt-in **Strict Mode** that blocks Generate / Copy / Export while any field holds an error.
- **Batch mode** — generate metadata for all parts of a series in one pass.
- **Cross-post captions** — a dedicated **Social** tab re-packages the same YouTube source into short-form captions for **TikTok** (4,000-char), **Instagram Reels**, and **Facebook Reels** — title, rig, content warnings, copyright, thanks, and hashtags (game + genre + curated per-platform popular tags). Single + bulk modes, per-platform character limits with smart overflow trimming, and JSON import/export.
- **Desktop app** — Windows, macOS & Linux native binaries via Tauri (~8 MB).
- **Android app** — installable, sideloadable `.apk` built from the same Tauri 2 codebase. **Requires Android 11+** (tested 11–16; real-device test on Android 12). Grab it from [Releases](https://github.com/poli0981/youtube-generator/releases) and enable "Install unknown apps" to sideload.
- **Mobile-responsive web** — drawer navigation, touch-sized controls, iOS-safe text-input behavior. Tested down to 360 × 640.
- **100% offline** — no server, no telemetry, no account. See [PRIVACY.md](./PRIVACY.md).
## Quick Start
```bash
# Clone
git clone https://github.com/poli0981/yt-desc-gen.git
git clone https://github.com/poli0981/youtube-generator.git
cd yt-desc-gen
# Install
npm install
# Dev
npm run dev
# Build
npm run build
npm run dev # web dev server at http://localhost:5173
```
Desktop build (Windows / macOS / Linux):
```bash
npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}
```
Android build (`.apk`) — requires the Android SDK + NDK + a JDK:
```bash
cargo tauri android init # one-time; generates src-tauri/gen/android
cargo tauri android build --apk
# Output: src-tauri/gen/android/app/build/outputs/apk/universal/release/
```
See [`docs/PACKAGING.md`](./docs/PACKAGING.md#android-apk-packaging) for the SDK/NDK setup and signing steps.
Full development setup, IDE config, and troubleshooting: see [`docs/DEVELOPMENT.md`](./docs/DEVELOPMENT.md). Vietnamese version: [`docs/i18n/vi/DEVELOPMENT.md`](./docs/i18n/vi/DEVELOPMENT.md).
## Use Cases
- **Gameplay no-commentary channels** — the primary target. Default templates assume no voice-over and lean on visual hooks, music attribution, and timestamps.
- **Horror / scary-game channels** — the content-warning system is especially deep here (analog horror, liminal spaces, pursuit / chase, entity / SCP-style, body horror, etc.).
- **Demo / Early Access playthroughs** — dedicated video types and language-patch / game-version disclosure fields.
- **Speedrunners and 100% completionists** — playstyle disclosures, run-type metadata, and difficulty fields.
- **Solo creators tired of copy-paste** — profiles and presets exist specifically to eliminate repetitive data entry.
## Privacy & Offline-First
Nothing leaves your device. No analytics, no telemetry, no tracking. The web version stores your work in `localStorage`; the desktop version stores it in the OS application-data directory. Clearing site data (web) or uninstalling the app (desktop) wipes everything. Full details in [PRIVACY.md](./PRIVACY.md).
## Tech Stack
React 18 • TypeScript • Vite • Tailwind CSS • Zustand • i18next • Tauri 2
React 18 · TypeScript (strict) · Vite 8 · Tailwind CSS 3 · Zustand · i18next · Tauri 2 (Rust stable).
Architecture overview: [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
## Documentation
| Document | Description |
|----------|-------------|
| [CLAUDE.md](./CLAUDE.md) | Claude Code instructions & project overview |
| [PRD](./docs/PRD.md) | Product Requirements Document |
| [Architecture](./docs/ARCHITECTURE.md) | Technical architecture & data flow |
| [Features](./docs/FEATURES.md) | Complete feature list |
| [Roadmap](./docs/ROADMAP.md) | Development phases & timeline |
| [Tech Spec](./docs/TECH-SPEC.md) | Implementation details & configs |
| [i18n Guide](./docs/I18N.md) | How to add new languages |
| [Packaging](./docs/PACKAGING.md) | Desktop app build guide |
| Document | What's in it |
| --- | --- |
| **[Wiki](https://github.com/poli0981/youtube-generator/wiki)** | **User documentation** — quick start, glossary, every field and its limit, guardrails, troubleshooting, FAQ. Start here if you're using the app rather than building it. |
| [Development Guide](./docs/DEVELOPMENT.md) | Toolchain, IDE setup, build commands, troubleshooting. *(Also: [Vietnamese](./docs/i18n/vi/DEVELOPMENT.md).)* |
| [Architecture](./docs/ARCHITECTURE.md) | Layer model, data flow, engine design. |
| [Features](./docs/FEATURES.md) | Full feature matrix. |
| [Content Inventory](./docs/CONTENT-INVENTORY.md) | Every video type, genre, and content warning the editor surfaces. *(Also: [Vietnamese](./docs/i18n/vi/CONTENT-INVENTORY.md).)* |
| [Roadmap](./docs/ROADMAP.md) | Development phases. |
| [Tech Spec](./docs/TECH-SPEC.md) | Implementation details and configs. |
| [i18n Guide](./docs/I18N.md) | Adding new locales. |
| [Packaging](./docs/PACKAGING.md) | Tauri desktop + Android release builds and signing. |
| [Contributing](./CONTRIBUTING.md) | PR process, commit conventions, auto-ignore rules. |
| [Security](./SECURITY.md) | Reporting vulnerabilities. |
| [Privacy](./PRIVACY.md) | Data handling (TL;DR: none). |
| [Disclaimer](./DISCLAIMER.md) | AI-assistance and translation-quality disclosure. *(Also: [Vietnamese](./docs/i18n/vi/DISCLAIMER.md).)* |
| [Terms of Use](./TERMS.md) | Acceptable use and license compliance. |
| [Code of Conduct](./CODE_OF_CONDUCT.md) | Contributor Covenant v2.1. |
| [Maintainers](./MAINTAINERS.md) | Who runs this. |
| [Third-Party Notices](./THIRD_PARTY_NOTICES.md) | Dependency attribution. |
| [Changelog](./CHANGELOG.md) | Per-release notes. |
## Contributing
PRs welcome — read [CONTRIBUTING.md](./CONTRIBUTING.md) first. Native-speaker corrections to AI-translated locales (JA / ES / KO / ZH) are especially appreciated.
## License
MIT
Licensed under the **[Apache License 2.0](./LICENSE)**. See [`NOTICE`](./NOTICE) for the copyright statement and [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md) for dependency licenses.
## AI Disclosure
This project was co-authored with **Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. Source code, locale translations, documentation, and CI workflows were generated or edited with AI assistance, then reviewed by the human maintainer (`@poli0981`) before being committed. See [DISCLAIMER.md](./DISCLAIMER.md) for the full disclosure.
## Channel & Socials
Reference channel and maintainer links:
- **YouTube**: [@SkullMute](https://www.youtube.com/@SkullMute)
- **X / Twitter**: [@SkullMute0011](https://x.com/SkullMute0011)
- **Bluesky**: [skullmute0011.bsky.social](https://bsky.app/profile/skullmute0011.bsky.social)
- **Mastodon**: [@skullmute1122@mastodon.social](https://mastodon.social/@skullmute1122)
- **Discord** (project / repo): [join](https://discord.gg/2aNR3aVt)
- **Discord** (gaming): [join](https://discord.gg/kDM9GMu5vm)
- **Steam**: [profile](https://steamcommunity.com/profiles/76561199544666292/)
- **Patreon / Ko-fi**: `skullmute`
- **Telegram**: `@SkullMute0011` (bot: `@my_skull_bot`)
- **Email** (security & private contact): `lopop05905@proton.me`
+50
View File
@@ -0,0 +1,50 @@
# Security Policy
## Supported Versions
Only the latest released version of YTDescGen receives security updates. This is a solo open-source project; there are no LTS branches.
| Version | Supported |
| ------- | --------- |
| 0.13.x | ✅ |
| < 0.13 | ❌ |
## Reporting a Vulnerability
Please report security issues **privately**. Do not open a public issue.
**Preferred channels (in order):**
1. **GitHub Security Advisory** — open a draft advisory in this repository's `Security` tab.
2. **Email** — `lopop05905@proton.me` with subject prefix `[SECURITY]`.
Include:
- A description of the issue and its potential impact.
- Steps to reproduce, ideally a minimal proof-of-concept.
- The affected version (`node -p "require('./package.json').version"`).
- Whether the issue is already public.
## Response Timeline
- **Initial reply**: within 7 days.
- **Triage + planned fix**: within 30 days for high-severity issues.
- **Disclosure**: coordinated with the reporter after a fix ships, or at most 90 days from initial reply.
## Scope
In scope:
- The web bundle deployed to GitHub Pages.
- The Tauri desktop binaries (Windows, macOS, Linux).
- CI/CD workflows in `.github/workflows/`.
Out of scope:
- Vulnerabilities in third-party dependencies — report those upstream and we'll bump.
- Issues requiring physical access to the user's device.
- Self-XSS in user-supplied template content (the app deliberately renders user input as plain text in the preview).
## No Bounty
This is a solo open-source project. Credit in release notes and a thank-you in `MAINTAINERS.md` is the only reward we can offer.
+67
View File
@@ -0,0 +1,67 @@
# Terms of Use
**Effective:** 2026-05-14
These terms govern your use of YTDescGen — both the web version hosted at the project's GitHub Pages URL and any Tauri desktop binaries distributed under this project.
## License
YTDescGen is licensed under the **[Apache License 2.0](./LICENSE)**. You may use, modify, and redistribute it under those terms.
Apache 2.0 grants a patent license (Section 3) and an irrevocable copyright license (Section 2). It does **not** grant trademark rights — see Section 6 of the LICENSE.
## Acceptable Use
You may use YTDescGen for any lawful purpose. You may **not** use it to:
- Generate content that harasses, threatens, defames, or incites violence against any person or group.
- Generate content intended to mislead or impersonate (faked attribution, false sponsor disclosure, deepfake-adjacent metadata).
- Generate content that violates any third party's intellectual-property rights (including misleading copyright or licensing claims in descriptions).
- Distribute modified versions of YTDescGen in a way that violates Apache-2.0 — e.g. stripping copyright notices, omitting the NOTICE file, falsely indicating endorsement.
- Violate applicable law in your jurisdiction, including but not limited to **GDPR** (EU), **CCPA / CPRA** (California), **PIPL** (China), **LGPD** (Brazil), the **Vietnamese Cybersecurity Law**, or equivalent data-protection / cybercrime regulation in your country.
- Bypass YouTube's policies on metadata (misleading thumbnails / titles / tags) using the application.
## GitHub Terms
If you use the web version hosted on GitHub Pages, your use is also subject to:
- [GitHub's Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service)
- [GitHub's Acceptable Use Policies](https://docs.github.com/en/site-policy/acceptable-use-policies)
These apply alongside this document; in case of conflict, GitHub's policies govern the hosted artifact.
## No Warranty
See [DISCLAIMER.md](./DISCLAIMER.md) and `LICENSE` §§ 7–8. The software is provided **as-is** with no warranty of any kind, express or implied.
## Generated Content
YTDescGen produces text intended to be pasted into YouTube descriptions. **You — the operator pasting that text — are solely responsible for**:
- Confirming the generated description complies with [YouTube's Community Guidelines](https://www.youtube.com/howyoutubeworks/policies/community-guidelines/) and [YouTube's Terms of Service](https://www.youtube.com/static?template=terms).
- Disclosing paid promotions, sponsorships, and any AI-generated portions per YouTube's monetization and disclosure rules.
- Not including misleading information, copyright-infringing material, or any prohibited content listed in YouTube's policies.
- Truthful representation of run-type, difficulty, blind status, mod / cheat usage, and similar disclosures the application optionally exposes.
## Contributions
By submitting a contribution (issue, pull request, comment, locale translation, screenshot, log dump), you agree:
1. Your contribution is licensed under Apache 2.0, the same as the project.
2. You have the right to grant that license (you wrote it, or it's compatibly licensed and credited).
3. You will not include malicious code or knowingly vulnerable dependencies.
4. You will follow the [Code of Conduct](./CODE_OF_CONDUCT.md) and [Contributing Guide](./CONTRIBUTING.md).
Violations may result in your contribution being closed and, in severe cases, a permanent ban from the repository — see `CONTRIBUTING.md` § "Auto-ignored Contributions".
## Termination
These terms remain in effect for as long as you use the software. Your rights under Apache 2.0 are perpetual subject to that license's termination clauses (notably § 3 patent retaliation).
## Changes
Updates to these terms are committed under `TERMS.md` with the `Effective` date updated. Continued use of the software after a change constitutes acceptance.
## Contact
`lopop05905@proton.me`
+79
View File
@@ -0,0 +1,79 @@
# Third-Party Notices
YTDescGen incorporates the following third-party software. Each dependency retains its own license; consult the linked project page for the full text of each license.
## Runtime Dependencies (web bundle)
| Package | Version | License | Project |
| --- | --- | --- | --- |
| `react` | ^18.3.0 | MIT | <https://github.com/facebook/react> |
| `react-dom` | ^18.3.0 | MIT | <https://github.com/facebook/react> |
| `react-router-dom` | ^6.26.0 | MIT | <https://github.com/remix-run/react-router> |
| `react-i18next` | ^15.0.0 | MIT | <https://github.com/i18next/react-i18next> |
| `i18next` | ^23.15.0 | MIT | <https://github.com/i18next/i18next> |
| `zustand` | ^4.5.0 | MIT | <https://github.com/pmndrs/zustand> |
| `react-hot-toast` | ^2.4.0 | MIT | <https://github.com/timolins/react-hot-toast> |
| `lucide-react` | ^0.400.0 | ISC | <https://github.com/lucide-icons/lucide> |
| `clsx` | ^2.1.0 | MIT | <https://github.com/lukeed/clsx> |
| `@tauri-apps/api` | ^2.11.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `@tauri-apps/plugin-dialog` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `@tauri-apps/plugin-fs` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `@tauri-apps/plugin-opener` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `@tauri-apps/plugin-shell` | ^2.0.0 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
## Build / Dev Dependencies
| Package | Version | License | Project |
| --- | --- | --- | --- |
| `vite` | ^7.3.3 | MIT | <https://github.com/vitejs/vite> |
| `@vitejs/plugin-react` | ^4.3.0 | MIT | <https://github.com/vitejs/vite-plugin-react> |
| `typescript` | ^5.5.0 | Apache-2.0 | <https://github.com/microsoft/TypeScript> |
| `tsx` | ^4.16.0 | MIT | <https://github.com/privatenumber/tsx> |
| `tailwindcss` | ^3.4.0 | MIT | <https://github.com/tailwindlabs/tailwindcss> |
| `prettier-plugin-tailwindcss` | ^0.6.0 | MIT | <https://github.com/tailwindlabs/prettier-plugin-tailwindcss> |
| `postcss` | ^8.5.14 | MIT | <https://github.com/postcss/postcss> |
| `autoprefixer` | ^10.4.0 | MIT | <https://github.com/postcss/autoprefixer> |
| `eslint` | ^9.0.0 | MIT | <https://github.com/eslint/eslint> |
| `@eslint/js` | ^9.0.0 | MIT | <https://github.com/eslint/eslint> |
| `eslint-plugin-react-hooks` | ^5.0.0 | MIT | <https://github.com/facebook/react> |
| `typescript-eslint` | ^8.0.0 | MIT | <https://github.com/typescript-eslint/typescript-eslint> |
| `prettier` | ^3.3.0 | MIT | <https://github.com/prettier/prettier> |
| `vitest` | ^3.2.4 | MIT | <https://github.com/vitest-dev/vitest> |
| `@testing-library/react` | ^16.0.0 | MIT | <https://github.com/testing-library/react-testing-library> |
| `@testing-library/jest-dom` | ^6.4.0 | MIT | <https://github.com/testing-library/jest-dom> |
| `@types/react` | ^18.3.0 | MIT | DefinitelyTyped |
| `@types/react-dom` | ^18.3.0 | MIT | DefinitelyTyped |
## Tauri Desktop (Rust crates)
| Crate | Version | License | Project |
| --- | --- | --- | --- |
| `tauri` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-build` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/tauri> |
| `tauri-plugin-dialog` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-fs` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-opener` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-shell` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `tauri-plugin-single-instance` | ^2 | Apache-2.0 OR MIT | <https://github.com/tauri-apps/plugins-workspace> |
| `serde` | ^1 | Apache-2.0 OR MIT | <https://github.com/serde-rs/serde> |
| `serde_json` | ^1 | Apache-2.0 OR MIT | <https://github.com/serde-rs/json> |
Transitive dependencies are not enumerated here. `cargo tree` (in `src-tauri/`) and `npm list --all` produce the exhaustive trees; this list covers the direct dependencies declared in `package.json` and `src-tauri/Cargo.toml`.
## Fonts & Icons
The application uses **system fonts** (`Inter` / `SF Pro` / `Segoe UI` / `Roboto`, fallback `sans-serif`). No custom font files are bundled in the web build.
Icons are provided by [`lucide-react`](https://github.com/lucide-icons/lucide) (ISC license — see above).
## AI-Assisted Development Disclosure
Per [`DISCLAIMER.md`](./DISCLAIMER.md), this project was co-authored with **Anthropic's Claude Code (model 4.7 Opus, 1M-context variant)**. The model contributed to source code, locale translations, documentation, and CI configuration. All output was reviewed by the human maintainer (`@poli0981`) before being committed.
No third-party content was reproduced verbatim from the model's training data. Any external text quoted in this repository (notably the Apache License 2.0 in [`LICENSE`](./LICENSE) and the Contributor Covenant link in [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md)) is sourced from canonical public locations.
Claude is a product of Anthropic, PBC — <https://www.anthropic.com>. No license is granted by Anthropic to use this project; the Apache 2.0 license in `LICENSE` is granted by `@poli0981` as the project author.
## Reporting an Omission
If you believe a dependency is missing from this list, please open an issue or PR per [`CONTRIBUTING.md`](./CONTRIBUTING.md).
+55 -3
View File
@@ -46,6 +46,14 @@
└──────────────────────────────────────────────────────────────┘
```
**Error pages (v0.27):** `components/errors/` holds a reusable `ErrorPage`
(404/403/419/500/offline/runtime) driven by the pure `config/error-pages.ts`
map. The dedicated error routes (`/403`, `/419`, `/500`, `/offline`, catch-all
`*`) are declared as **siblings of the `AppShell` route group** in `App.tsx`, so
they render full-screen with no Sidebar/Header. `ErrorPage` is router-agnostic
(hash anchors + `history.back()`) so the root `ErrorBoundary` — mounted outside
`HashRouter` in `main.tsx` — can reuse it as its crash fallback.
## 2. Core Engine Design
Engine module chứa toàn bộ logic generate — **zero framework dependency**. Mọi function đều pure: input → string.
@@ -253,13 +261,55 @@ Zustand Stores:
├───────────────────────────────────────────────┤
│ SettingsStore │
│ - theme: "dark" | "light" │
│ - defaultLanguage: SupportedLanguage │
│ - defaultGenres: GenreId[] │
│ - appLanguage / defaultOutputLanguage │
│ - strictMode, settingsAccordionState (v12) │
│ - (flags: quality badge / copyright / ...) │
│ Middleware: persist (localStorage + file) │
├───────────────────────────────────────────────┤
│ PendingInvalidStore (0.35) │
│ - entries: Record<fieldId, PendingInvalid> │
│ Middleware: NONE — in-flight typing, not data │
└───────────────────────────────────────────────┘
```
### Settings → engine options
`renderAll` is called from three places (the Output hook, the multi-language
Output hook, BatchPage). Each used to hand-copy the same twelve settings fields
into an options object, and they had drifted — BatchPage's copy silently omitted
`splitContactEmail` and `showThirdPartyAds`, so Batch rendered a different
description than Output from identical data.
`src/hooks/use-render-options.ts` is now the single mapping, with two guards:
- **Compile-time** — `buildRenderOptions` builds a
`Required<SettingsRenderOptions>`, so omitting a key is a type error.
- **Runtime** — `tests/hooks/render-options-parity.test.ts` diffs the produced
keys against `SETTINGS_DERIVED_RENDER_KEYS` in both directions.
`RenderOptions` is split accordingly: `SettingsRenderOptions` (from the user)
plus `RenderOptionOverrides` (`tEn`, `bilingualContentBlocks` — decided per call
site, since Output wants bilingual content blocks and Batch does not).
### Validation state
Two sources, unioned by `useStrictBlock`, because neither alone is sufficient:
| Source | Catches | Why it's needed |
|---|---|---|
| `collectEditorIssues` (pure, over `EditorData`) | Saved values that fail validation | Bad data from imports — `ValidatedInput` refuses to commit invalid text, so imports are the main way it gets in |
| `PendingInvalidStore` | Typed text that is invalid and therefore **not** saved | Otherwise a field showing a red error is invisible to every gate, because the store behind it holds the last good value |
Both are filtered through `isRelevantIssueId`, so a field that isn't currently
shown (`adEmail` with split-email off, `zaloGroupLink` outside Vietnamese
output) can never block on a value with no visible input to fix it.
The first implementation registered issues from the inputs themselves and
cleared on unmount. It typechecked and had passing tests, and did nothing: the
fields live on the Editor page while the gates live on Batch / Social / Output,
so navigating away cleared every issue. Deriving from state removes the mount
coupling entirely.
## 4. i18n Architecture
```
@@ -278,6 +328,8 @@ i18n/locales/
**Adding a new language** = 2 JSON files + 1 line registration. See docs/I18N.md.
**Lazy loading (v0.26+)**: only English is bundled into the main chunk — it is the `fallbackLng` and the engine's bilingual `tEn` translator, both of which must resolve synchronously. Every other language is fetched on first use as a Vite async chunk via `i18next-resources-to-backend` + dynamic `import()`. Generation paths gate on bundle readiness (`useLanguagesReady` hook / `ensureLanguagesLoaded`): an unloaded language would otherwise silently render English fallback output. A chunk that fails to fetch degrades to English and logs to the in-app Log page — it never hangs the UI.
**UI language vs Output language**: These are independent. User can browse the app in English but generate descriptions in Japanese. UI language follows `SettingsStore.defaultLanguage`, output language follows `EditorStore.language`.
## 5. Desktop Packaging (Tauri)
@@ -313,7 +365,7 @@ Tauri advantages over Electron:
| What | How to Extend | Files to Touch |
|------|--------------|----------------|
| New language | Add `locales/{code}/ui.json` + `templates.json`, register in `i18n/index.ts` | 3 files |
| New language | Add `locales/{code}/ui.json` + `templates.json`, register in `SUPPORTED_LANGUAGES` (lazy-loaded automatically) | 3 files |
| New genre | Add entry to `config/genres.ts`, add tag pool to `engine/tag-generator.ts` | 2 files |
| New video type | Add to `config/video-types.ts`, add patterns to all `templates.json` | 1 + N locale files |
| New platform/store | Add entry to `config/platforms.ts` | 1 file |
+161
View File
@@ -0,0 +1,161 @@
# Content Inventory
A static manifest of every video type, game genre, and content warning surfaced in YTDescGen's editor. Maintained manually — when adding a new option to one of the source files below, **add a row here too** in the same PR.
This file exists for **transparency** — anyone curious about what the editor can describe (without installing the app or reading the source) can scan it in one minute.
**Vietnamese mirror:** [`docs/i18n/vi/CONTENT-INVENTORY.md`](./i18n/vi/CONTENT-INVENTORY.md).
**Source of truth:**
- Video types: [`src/config/video-types.ts`](../src/config/video-types.ts)
- Game genres: [`src/config/genres.ts`](../src/config/genres.ts)
- Content warnings: [`src/config/content-warning-groups.ts`](../src/config/content-warning-groups.ts)
---
## 1. Video types (20)
Each video type drives a dedicated description template + title structure + tag bias. The "Extra fields" column lists fields the editor reveals when this type is selected.
| Icon | Type | Extra fields |
|---|---|---|
| 🎮 | Full Gameplay | — |
| 📂 | Gameplay Part | Part Number |
| 🎬 | Full Demo | — |
| 🎞 | Demo Part | Part Number |
| 👹 | Boss Fight | Boss Name |
| 💀 | Boss No Hit | Boss Name |
| 🏁 | Ending / All Endings | — |
| ⚡ | Speedrun | — |
| 💯 | 100% Completion | — |
| 📦 | DLC Content | DLC Name |
| 🔄 | New Game+ | — |
| 🏆 | Challenge Run | Challenge Name |
| 📌 | Side Quests | — |
| 🔍 | Secrets / Hidden | — |
| ⚖️ | Graphics Comparison | — |
| 📘 | Silent Guide | — |
| 🧩 | Modded Gameplay | Mod Name |
| ⭐ | All Collectibles | — |
| 🔴 | Livestream | Live URL, Scheduled Time |
| 🎴 | Gacha Quest | Quest Type, Chapter Name, Quest Name, Part Number |
---
## 2. Game genres (41)
Selected genres feed the title format, the tag pool, and (when configured in Settings → Genre Playlists) the pinned-comment recommendation.
Bulk-select groups available in the editor: **All RPGs** (rpg + jrpg + action_rpg + crpg), **All Shooters** (fps + arena_shooter + tactical_fps + boomer_shooter + extraction_shooter + shmup), **All Horror** (horror + survival_horror + psychological_horror).
| Icon | Genre |
|---|---|
| ⚔️ | Action / Adventure |
| 🗡 | Hack & Slash |
| 👊 | Beat 'em Up |
| 🦘 | Platformer |
| 👻 | Horror / Survival |
| 🧟 | Survival Horror |
| 🧠 | Psychological Horror |
| 🛡 | RPG |
| 🎎 | JRPG |
| 🏹 | Action RPG |
| 📜 | CRPG / Isometric |
| 🔫 | FPS / Shooter |
| 🎯 | Arena Shooter |
| 🎖 | Tactical FPS |
| 💥 | Boomer Shooter |
| 🎒 | Extraction Shooter |
| 🛸 | SHMUP / Bullet Hell |
| 🌍 | Open World / Sandbox |
| 🕹 | Indie |
| 💀 | Souls-like |
| 🏎 | Racing / Sports |
| 📖 | Story / Narrative |
| 🏗 | Simulation / Strategy |
| 🏙 | City Builder |
| 🥊 | Fighting |
| 🥷 | Stealth / Espionage |
| ⛏ | Survival / Crafting |
| 🎲 | Roguelike / Roguelite |
| 🗺 | Metroidvania |
| 🌐 | MMO / Online |
| 🎵 | Rhythm / Music |
| 🧩 | Puzzle |
| 🏰 | Tower Defense |
| 🃏 | Card Game |
| 🎴 | Deck Builder |
| 🤖 | Auto Battler |
| 🏆 | Battle Royale |
| ♟ | Tactical / Turn-based |
| 🚀 | Space / Sci-Fi |
| 🌾 | Farming / Life Sim |
| 🎬 | FMV / Interactive Movie |
| 💬 | Visual Novel |
---
## 3. Content warnings (248, grouped)
Selected warnings are appended to a `⚠ CONTENT WARNINGS` block in the description, ahead of timestamps. Each group is collapsible in the editor; warnings render in description order = user's selection order.
### Spoilers (6)
Story / ending spoilers · Ending spoilers · True-ending spoilers · Post-game / NG+ spoilers · Secret-ending spoilers · DLC story spoilers
### Photosensitive / Health (13)
Flashing lights · Motion sickness · Migraine trigger · Strobe lighting · Heavy screen shake · Lens flare / sun glare · Excessive bloom / overblown highlights · Dense particle effects · Flashing HUD / UI overlays · Extreme color saturation · Heavy motion blur · Aggressive depth of field · Intense post-processing
### Audio / Sensory (13)
Loud / sudden sounds · Ear-piercing / high-pitched · Audio jumpscares · Sudden volume changes · Distorted / clipping audio · Screeching / metallic sounds · Persistent high-pitched tones · Audio glitches / artifacts · Heavy bass / sub-bass rumble · Sustained screaming · Glass breaking / shattering · Mic pops / breath noise · White noise / static
### Dialogue / Language (10)
Frequent profanity · Sexual innuendo / suggestive dialogue · Inflammatory / inciting dialogue · Verbal abuse · Threats / intimidation · Slurs / derogatory terms · Crude / toilet humor · Mature / adult humor · Dark / morbid humor · Drug / alcohol references
### Phobias (56)
Jumpscares · Heights (acrophobia) · Holes / clusters (trypophobia) · Deep water (thalassophobia) · Confined spaces (claustrophobia) · Spiders (arachnophobia) · Insects (entomophobia) · Snakes (ophidiophobia) · Dogs (cynophobia) · Darkness (nyctophobia) · Fire (pyrophobia) · Dolls (pediophobia) · Blood (hemophobia) · Clowns (coulrophobia) · Drowning / water immersion (ablutophobia) · Live burial (taphophobia) · Animatronics / mannequins (automatonophobia) · Large objects (megalophobia) · Submerged man-made objects (submechanophobia) · Corpses (necrophobia) · Ghosts (spectrophobia) · Demons (demonophobia) · Sharks (selachophobia) · Germs / contamination (mysophobia) · Vomiting (emetophobia) · Being watched (scopophobia) · Isolation (monophobia) · Mice / rats (musophobia) · Bats (chiroptophobia) · Birds (ornithophobia) · Fish (ichthyophobia) · Reptiles (herpetophobia) · Cockroaches (katsaridaphobia) · Bees / wasps (apiphobia) · Thunder / lightning (astraphobia) · Open spaces (agoraphobia) · Crowds (enochlophobia) · Snow / extreme cold (chionophobia) · Hospitals (nosocomephobia) · Sharp objects (aichmophobia) · Choking / suffocation (pnigophobia) · Fog / mist (homichlophobia) · Tornadoes / hurricanes (lilapsophobia) · Heavy rain (ombrophobia) · Clouds (nephophobia) · Strong wind (ancraophobia) · Extreme cold (cryophobia) · Sunlight (heliophobia) · Large waves (cymophobia) · Lakes / still water (limnophobia) · Rivers / currents (potamophobia) · Colors / vivid color scenes (chromophobia) · Red / all-red scenes (erythrophobia) · Yellow color (xanthophobia) · White / all-white spaces (leukophobia) · Black color (melanophobia)
### Mental health (17)
Anxiety-inducing scenes · Depression themes · Eating disorders · Substance use · Self-harm / suicide · PTSD content · Needles · Body fluids · Pregnancy / birth horror · Illness / infection · Bipolar themes · OCD themes · Panic attacks · Dissociation · Paranoia · Intrusive thoughts · Medical horror
### Social phenomena (22)
Autism / neurodivergence themes · ADHD / executive dysfunction · Hikikomori / social withdrawal · NEET themes · Social anxiety themes · Social isolation / loneliness · Schizophrenia / psychosis · Burnout / overwork · Survivor guilt · Abandonment themes · Parasocial relationships · Gaslighting · Stockholm syndrome · Gaming / gambling addiction · Existential / nihilistic themes · Impostor syndrome · Midlife crisis · Quarter-life crisis · Workplace harassment · Gender-role pressure · Body shaming / appearance mockery · Unrealistic beauty standards
### Internet / Digital life (18)
Cyberbullying / online harassment · Doxxing / privacy exposure · Trolling / griefing · Cancel culture / public shaming · Social media addiction · Doomscrolling · FOMO (fear of missing out) · Fake news / misinformation · Online scams / phishing · Catfishing / fake identity · Deepfakes / synthetic media · Cyberstalking · Dangerous viral challenges · Influencer culture / clout chasing · Online radicalization / echo chambers · Loot boxes / gacha mechanics · AI / artificial intelligence themes · Data privacy / mass surveillance
### Mature / Sensitive content (66)
Blood and gore · Mature 18+ · Revealing / skimpy outfits · Partial nudity · Sexualized character designs · Fan service / ecchi · Suggestive poses / camera angles · Disturbing imagery · Animal cruelty · Violence against minors · Domestic violence · Sexual assault references · Torture · Religious themes · War violence · Discrimination · State / police violence · Smoking / drinking · Detailed killing · Cult / occult · Psychological manipulation · Loss / grief · Kidnapping · Hate speech · Historical atrocities · Slavery themes · Terrorism themes · Bullying themes · Human experimentation · Cannibalism · Nuclear / radiation · Homophobia / anti-LGBTQ+ · Transphobia / anti-trans · Xenophobia / anti-foreigner · Political extremism · Religious extremism / fundamentalism · Genocide / ethnic cleansing · Holy war / sectarian conflict · Holocaust themes · Civil war · Mass / school shootings · Colonialism / imperialism · State propaganda · Surveillance / dystopian state · Conspiracy theories · Censorship themes · Ethnic / racial conflict · Refugee crisis · Revolution / uprising · Political assassination · Coup d'état · Inquisition / religious persecution · Forced labor · Ultranationalism · Hanging / strangulation · Drowning scene · Burning alive / immolation · Asphyxiation / suffocation · Bound / restrained victim · Public execution · Decapitation · Impalement · Mass-casualty event · Vehicular violence · Overdose scene · Falling from height (intentional)
### Heavy horror (12)
Eyes / eyeball clusters · Body horror (flesh distortion) · Distorted / mutilated faces · Cosmic / eldritch horror · Extreme gore / dismemberment · Decay, rot, maggots · Mutilation / amputation · Liminal spaces · Analog horror / VHS · Unreality / distortion · Pursuit / chase · Entity / SCP horror
### Playstyle disclosures (10)
Blind playthrough · No spoilers in chat · Casual / story mode · Hardcore / max difficulty · Permadeath / Iron Man · Speedrun attempt · 100% completionist · Still learning mechanics · First time playing · Returning / NG+
### Gameplay disclosure (5)
Mods used · Cheats / debug · Glitches used · Guide-assisted · Educational / PSA purpose
---
## 4. Maintenance
When adding a new item to any of the source files:
1. **Video types** → append to [`src/config/video-types.ts`](../src/config/video-types.ts) AND add a row in section 1 above.
2. **Genres** → append to [`src/config/genres.ts`](../src/config/genres.ts) AND add a row in section 2.
3. **Content warnings** → append to the relevant group in [`src/config/content-warning-groups.ts`](../src/config/content-warning-groups.ts) AND add the label to the right group in section 3 — keep the group count in the heading accurate.
4. Update the Vietnamese mirror at [`docs/i18n/vi/CONTENT-INVENTORY.md`](./i18n/vi/CONTENT-INVENTORY.md) in the same PR.
Mismatch between this file and the source files is treated as a documentation bug — open an issue or PR.
+151
View File
@@ -0,0 +1,151 @@
# Development Guide
This guide covers setting up YTDescGen for local development on Windows, macOS, or Linux. The application is a Vite/React web app with an optional Tauri desktop shell.
## Reference Workstation
The reference workstation used to develop and ship this project:
| Component | Spec |
| --- | --- |
| OS | Windows 11 Pro (24H2 or newer) |
| CPU | Modern x86-64 — 6+ cores with AVX2 (Intel 11th-gen / AMD Zen 3 or newer) |
| GPU | Discrete or integrated — Tauri's WebView2 backend runs fine on iGPU |
| RAM | 16 GB minimum, 32 GB recommended for parallel typecheck + dev server |
| Storage | 5 GB free for `node_modules` + Cargo `target/` after a full Tauri build |
| Display | 1920×1080 minimum; mobile-responsive layout tested down to 360×640 |
macOS and Linux work for development. Tauri release builds are cross-compiled or run on dedicated CI runners — see [PACKAGING.md](./PACKAGING.md).
## Toolchain
Install in this order:
| Tool | Version | Why |
| --- | --- | --- |
| **Node.js** | `>= 22.12.0` | Vite 8 requires Node `^20.19` or `>= 22.12`. Use [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/Schniz/fnm). |
| **npm** | bundled with Node 22 | The project uses npm; `pnpm` and `yarn` are not tested. |
| **Rust** | stable, `>= 1.78` | Required for the Tauri desktop build. Install via [rustup](https://rustup.rs/). |
| **Python** | `3.12` | Optional — only needed for some Tauri platform tooling on Windows. |
| **Tauri prerequisites** | per OS | See <https://v2.tauri.app/start/prerequisites/>. |
### Windows specifics
- Install **Visual Studio Build Tools 2022** with the "Desktop development with C++" workload (required by `tauri-build`).
- Install the **WebView2 Runtime** (usually pre-installed on Windows 11).
- Long path support: `git config --global core.longpaths true`.
### macOS specifics
- Install Xcode Command Line Tools: `xcode-select --install`.
### Linux specifics
- Install per-distro Tauri prerequisites — `libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, etc. See the Tauri docs linked above.
## IDE Setup
The reference workflow uses **JetBrains 2026.x** IDEs (WebStorm or RustRover) as primary, with **VS Code** for quick edits.
### JetBrains (WebStorm / RustRover / IntelliJ Ultimate)
- Enable the **Tailwind CSS** plugin.
- Enable the **i18next** plugin (or rely on `src/i18n/locales/_schema.json` for autocomplete).
- Settings → Languages → TypeScript → "Use TypeScript from `node_modules/typescript`".
- Settings → Code Style → Prettier → Run on save (`src/**/*.{ts,tsx,json,css}`).
### VS Code
Recommended extensions (no `.vscode/extensions.json` is committed — install manually):
- `dbaeumer.vscode-eslint`
- `esbenp.prettier-vscode`
- `bradlc.vscode-tailwindcss`
- `rust-lang.rust-analyzer` (if you touch `src-tauri/`)
- `tauri-apps.tauri-vscode`
## First Run
```bash
# 1. Clone
git clone https://github.com/poli0981/youtube-generator.git
cd youtube-generator
# 2. Install web dependencies
npm install
# 3. Start the web dev server
npm run dev
# → http://localhost:5173
```
## Common Commands
| Command | What it does |
| --- | --- |
| `npm run dev` | Vite dev server, hot reload, web only. |
| `npm run build` | Production web bundle into `dist/`. |
| `npm run preview` | Serve the production bundle for sanity-testing. |
| `npm run typecheck` | `tsc --noEmit` over `src/` — what Vite actually builds. |
| `npm run typecheck:all` | Same, plus `tests/` and `scripts/`, which the base config deliberately excludes. Added in v0.35.0 after it turned out they had **never** been type-checked — and immediately found three fields silently missing from the editor→engine parity fixture. |
| `npm run lint` | ESLint. Use `npm run lint:fix` to autofix. |
| `npm run format` | Prettier write across `src/`, `tests/`, `scripts/`. |
| `npm run format:check` | Same, read-only. CI gate. Markdown and the locale JSON are deliberately out of scope — Prettier reflows prose and expands the schema's compact arrays by ~1600 lines for no benefit. |
| `npm run knip` | Dead-code / unused-dependency check. CI gate. |
| `npm run check:version` | Asserts all **six** version fields agree (`package.json`, both `package-lock.json` entries, `tauri.conf.json`, `Cargo.toml`, `Cargo.lock`). The only thing that notices a missed one. |
| `npm run test` | Vitest watch mode. |
| `npm run test:run` | Vitest single-run (for CI / pre-commit). |
| `npm run test:coverage` | Coverage report into `coverage/`. |
| `npm run validate:locales` | Enforces all 6 locales match `_schema.json` exactly. **Must pass before any locale-touching PR merges.** |
| `npm run generate:locale` | Scaffold a locale from the English source. `--lang <code>`, plus optional `--copy-english` / `--force`. (Advertised since v0.1 but only actually written in v0.35.0.) |
| `npm run tauri:dev` | Tauri desktop in dev mode (auto-restarts on Rust or frontend changes). |
| `npm run tauri:build` | Tauri release binary for the current platform. |
## Tauri Desktop Build
See [PACKAGING.md](./PACKAGING.md) for the full release pipeline. Quick local build:
```bash
npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}
```
The first build takes ~5–10 minutes (cold Cargo cache). Subsequent builds are incremental.
## Troubleshooting
### `validate:locales` fails after adding a key
You forgot to update `src/i18n/locales/_schema.json`. The schema is the source of truth; locales must match it exactly.
### Tauri build fails with `link.exe not found` (Windows)
Install Visual Studio Build Tools 2022 + Desktop C++ workload, then restart your shell so the new PATH is picked up.
### Tauri build fails with `pkg-config not found` (Linux)
Install the per-distro Tauri prerequisites listed at <https://v2.tauri.app/start/prerequisites/>.
### `npm install` is slow or hangs
Disable corporate VPNs / proxies that block the npm registry. The lock file is committed; offline installs work after one successful online install.
### Hot reload not picking up locale edits
Locale JSON is bundled at build time, not watched. Restart the dev server after editing `src/i18n/locales/*`.
Since v0.26, only English ships in the main chunk; the other languages are
lazy-loaded async chunks fetched on first use (see `src/i18n/index.ts` and
docs/I18N.md). The restart advice above still applies to all of them.
### Pre-commit hook fails on `validate:locales` but I didn't touch locales
You probably added a new key to `_schema.json` indirectly via the engine types (`src/engine/types.ts` → `CONTENT_WARNINGS`). New IDs require translations in all 6 locales.
## See Also
- [ARCHITECTURE.md](./ARCHITECTURE.md) — layer model, data flow, engine design.
- [I18N.md](./I18N.md) — adding new languages step-by-step.
- [PACKAGING.md](./PACKAGING.md) — Tauri release builds and signing.
- [Top-level CONTRIBUTING.md](../CONTRIBUTING.md) — PR process, commit conventions, auto-ignore rules.
- [Top-level SECURITY.md](../SECURITY.md) — reporting vulnerabilities.
+142 -80
View File
@@ -4,84 +4,40 @@
---
## 🎬 Video Types (14 types)
## 🎬 Video Types (20 types)
| ID | Label (EN) | Label (VI) | Label (JA) | Extra Fields |
|----|-----------|------------|------------|--------------|
| `full` | Full Gameplay | Full Gameplay | フルゲームプレイ | — |
| `part` | Gameplay Part | Gameplay Phần | ゲームプレイ パート | `partNumber` |
| `boss` | Boss Fight | Boss Fight | ボス戦 | `bossName` |
| `boss_nohit` | Boss No Hit | Boss No Hit | ボス ノーヒット | `bossName` |
| `ending` | Ending / All Endings | Kết thúc | エンディング | — |
| `speedrun` | Speedrun | Speedrun | スピードラン | — |
| `100percent` | 100% Completion | 100% Completion | 100%クリア | — |
| `dlc` | DLC Content | Nội dung DLC | DLCコンテンツ | `dlcName` |
| `newgame_plus` | New Game+ | New Game+ | 強くてニューゲーム | — |
| `challenge` | Challenge Run | Challenge Run | チャレンジラン | `challengeName` |
| `side_quest` | Side Quests | Nhiệm vụ phụ | サブクエスト | — |
| `secret` | Secrets / Hidden | Bí mật | 隠し要素 | — |
| `comparison` | Graphics Comparison | So sánh đồ họa | グラフィック比較 | — |
| `guide` | Silent Guide | Hướng dẫn | 攻略ガイド | — |
Twenty video types, each driving a dedicated description template, title
structure, and tag bias. The complete table — every type with its icon and
the extra fields the editor reveals — is in
[Content Inventory](./CONTENT-INVENTORY.md).
## 🌐 Languages (12 languages)
## 🌐 Languages (6 shipped)
All six locales ship today — UI strings and description templates fully
translated and parity-validated by `npm run validate:locales`.
### Launch (Phase 1)
| Code | Language | Native Name | Status |
|------|----------|-------------|--------|
| `en` | English | English | ✅ Ready |
| `vi` | Vietnamese | Tiếng Việt | ✅ Ready |
| `ja` | Japanese | 日本語 | ✅ Ready |
| `en` | English | English | ✅ Shipped |
| `vi` | Vietnamese | Tiếng Việt | ✅ Shipped |
| `ja` | Japanese | 日本語 | ✅ Shipped |
| `es` | Spanish | Español | ✅ Shipped |
| `ko` | Korean | 한국어 | ✅ Shipped |
| `zh` | Chinese (Simplified) | 简体中文 | ✅ Shipped |
### Phase 2
| Code | Language | Native Name |
|------|----------|-------------|
| `es` | Spanish | Español |
| `ko` | Korean | 한국어 |
| `zh` | Chinese (Simplified) | 简体中文 |
### Phase 3+
| Code | Language | Native Name |
|------|----------|-------------|
| `fr` | French | Français |
| `de` | German | Deutsch |
| `pt` | Portuguese | Português |
| `ru` | Russian | Русский |
| `th` | Thai | ภาษาไทย |
| `ar` | Arabic | العربية |
Further locales (French, German, Portuguese, Russian, Thai, Arabic) are
tracked in [Roadmap § 5.3](./ROADMAP.md).
Each language requires:
- `ui.json` — UI labels, buttons, placeholders, error messages
- `templates.json` — Title patterns, description sections, CTA text
## 🎮 Game Genres (25 genres)
## 🎮 Game Genres (41 genres)
| ID | Label | Icon | Tag Keywords (sample) |
|----|-------|------|-----------------------|
| `action` | Action / Adventure | ⚔️ | action game, hack and slash, action adventure |
| `horror` | Horror / Survival | 👻 | horror game, survival horror, scary game, psychological horror |
| `rpg` | RPG / JRPG | 🛡 | RPG, JRPG, action RPG, turn based RPG |
| `fps` | FPS / Shooter | 🔫 | FPS, shooter, tactical shooter, third person shooter |
| `openworld` | Open World / Sandbox | 🌍 | open world, sandbox, free roam, exploration |
| `indie` | Indie / Platformer | 🕹 | indie game, platformer, pixel art |
| `soulslike` | Souls-like | 💀 | souls like, soulsborne, boss fight, no death run |
| `racing` | Racing / Sports | 🏎 | racing game, driving sim, sports game |
| `story` | Story / Visual Novel | 📖 | story game, visual novel, narrative game, interactive drama |
| `simulation` | Simulation / Strategy | 🏗 | simulation, city builder, management, tycoon |
| `fighting` | Fighting | 🥊 | fighting game, combo, versus, arcade |
| `stealth` | Stealth / Espionage | 🥷 | stealth game, stealth gameplay, infiltration |
| `survival_craft` | Survival / Crafting | 🏕 | survival game, crafting, base building |
| `mmo` | MMO / Online | 🌐 | MMO, MMORPG, online game, multiplayer |
| `rhythm` | Rhythm / Music | 🎵 | rhythm game, music game, beat game |
| `puzzle` | Puzzle | 🧩 | puzzle game, brain teaser, logic game |
| `roguelike` | Roguelike / Roguelite | 🎲 | roguelike, roguelite, procedural, permadeath |
| `metroidvania` | Metroidvania | 🗺 | metroidvania, exploration, ability unlock |
| `tower_defense` | Tower Defense | 🏰 | tower defense, TD game, strategy |
| `card_game` | Card / Deck Builder | 🃏 | card game, deck builder, TCG |
| `battle_royale` | Battle Royale | 🏆 | battle royale, last man standing, BR |
| `crpg` | CRPG / Isometric | 📜 | CRPG, isometric RPG, classic RPG |
| `tactical` | Tactical / Turn-based | ♟ | tactical, turn based strategy, XCOM-like |
| `space` | Space / Sci-Fi | 🚀 | space game, sci-fi, space exploration |
| `farming` | Farming / Life Sim | 🌾 | farming sim, life sim, cozy game |
Forty-one genres feed the title format, the tag pool, and (when configured
in Settings → Genre Playlists) the pinned-comment playlist recommendation.
The complete list — with icons and bulk-select groups — is in
[Content Inventory](./CONTENT-INVENTORY.md).
## 🛒 Store Platforms (9 platforms)
@@ -143,16 +99,44 @@ Mỗi ngôn ngữ có description structure như sau (tất cả sections option
4. ─── Store Links ─── (if any platform link provided)
5. ─── Video Settings ─── (resolution / FPS / graphics)
6. ─── My Rig ─── (if any rig field provided)
7. ─── Spoiler Warning ─── (if toggled)
8. ─── 18+ Warning ─── (if toggled)
9. ─── Donate Links ─── (if any provided)
10. ─── Social Links ─── (if any provided)
11. ─── Playlist Link ─── (if provided)
12. ─── Contact Email ─── (if provided)
13. CTA line (Like / Subscribe / Share)
14. Hashtags (3 max, auto-generated)
7. ─── Content Warnings ─── (if any selected — 248 IDs across 12 groups)
8. ─── Donate Links ─── (if any provided)
9. ─── Social Links ─── (if any provided)
10. ─── Playlist Link ─── (if provided)
11. ─── Contact Email ─── (if provided)
12. CTA line (Like / Subscribe / Share)
13. Hashtags (3 max, auto-generated)
```
## 🔁 Cross-Post Captions (Social tab)
A dedicated **Social** tab re-packages the same editor source that drives the
YouTube description into short-form captions for other platforms — no
re-typing. Each caption is derived live from the current form.
| Platform | Caption limit | Popular hashtags appended |
|----------|--------------|----------------------------|
| TikTok | 4,000 | `#fyp #foryou #foryoupage #gaming #gamingtiktok #gameplay #gamer` |
| Instagram Reels | 2,200 | `#reels #reelsinstagram #gaming #gamingreels #gamer #instagaming #videogames` |
| Facebook Reels | 2,200 | `#reels #facebookreels #fbreels #gaming #gameplay #gamingcommunity #videogames` |
Each caption pulls, in order: **Title** (quality badge suppressed for
short-form), **My Rig**, **Content Warnings**, **Thanks / sponsor credit**,
**Copyright**, and **hashtags** (game + primary genre + the curated
per-platform popular set, deduplicated case-insensitively).
- **Overflow handling** — when a caption exceeds the platform limit, optional
blocks are dropped in priority order (warnings → copyright → thanks → rig).
The title and the hashtag line are never dropped, and there is no
mid-string truncation.
- **Single mode** — platform tabs with a live character counter and
over-limit warning.
- **Bulk mode** — generate a part range (e.g. Parts 1–10) across selected
languages in one pass, reusing the Batch loop.
- **Import / Export** — round-trip the generated captions as a typed JSON
bundle (`_type: "social"`); import is display-only since captions are
derived artifacts (the source round-trips via Profiles / Presets).
## 🏷 Tag Generation
### Tag Pools by Category
@@ -243,16 +227,42 @@ interface HistoryEntry {
| Setting | Type | Default | Description |
|---------|------|---------|-------------|
| Theme | dark / light | dark | App color theme |
| Default UI Language | SupportedLanguage | en | Language for app interface |
| Default Output Language | SupportedLanguage | en | Default language for generated output |
| Default Genre | Genre | action | Pre-selected genre on new session |
| Auto-save Draft | boolean | true | Auto-save form state to localStorage |
| Show Character Count | boolean | true | Display char counters on output |
| App Language | SupportedLanguage | browser-detected | Language of the interface |
| Default Output Language | SupportedLanguage | en | Pre-selected for new drafts |
| 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 |
| **Strict Mode** | boolean | **false** | v0.35.0. Blocks Generate / Copy / Export while any field has a hard error |
| History Limit | number | 100 | Max history entries to keep |
| Include Multilingual Tags | boolean | true | Add JA/VI tags to tag output |
| Log Retention | 1–90 days | 7 | Log files older than this are deleted at boot |
| Include Multilingual Tags | boolean | true | Add per-language tags to tag output |
| 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 |
`Default Genre` and `Auto-save Draft` were removed in v0.22.0 and v0.3
respectively — the draft autosaves unconditionally, so the toggle was dead.
### Description toggles
`showCopyright` · `showUsagePolicy` · `showSponsorCredit` · `showGameCopyright`
· `showThirdPartyAds` · `showTranslationQuality` · `splitContactEmail` ·
`showPinnedCommentTemplate` · `pinnedCommentIncludeAskNextGame` ·
`pinnedCommentIncludeGenrePlaylist`
## 🛡 Guardrails (v0.35.0)
Three independent mechanisms. The first two are always on.
| Mechanism | Scope |
|---|---|
| **Character limits** | Title 100 / description 5,000 / tags 500. If **any one** is over, **no** field can be copied — on Output and Batch. Batch scopes per part; Copy All Batch blocks if any part is over |
| **Field limits** | Hard `maxLength` per category: URL 200, email 320, short name 100, label 300, long text 2,000, timestamps 5,000, numeric 10. Imported values are clamped too |
| **Strict Mode** | Opt-in. Blocks Generate / Copy / Export on hard errors only; warnings (e.g. a working link on a non-standard prefix) never block. Log export is exempt |
Emails are capped at **three per field**, enforced on the increase so an
over-cap legacy value stays editable. Invalid input is never committed to the
store, so a malformed URL cannot reach the generated description whether Strict
Mode is on or off.
## 🖥 Desktop App Features (Tauri)
@@ -266,6 +276,58 @@ interface HistoryEntry {
| Offline | Full functionality without internet |
| Global Hotkey | System-wide hotkey to open app (optional) |
## 📱 Android App (v0.29)
An installable, sideloadable `.apk` built from the same Tauri 2 codebase — no
separate mobile project. Build with `cargo tauri android build --apk`; see
[PACKAGING.md](./PACKAGING.md#android-apk-packaging).
| Feature | Description |
|---------|-------------|
| Same codebase | One Tauri 2 project produces web, desktop, and Android |
| Min version | Android 11+ (minSdk 30); `targetSdk` 36 (Android 16) |
| Tested | Android 11 → 16 (emulators); real device on Android 12 |
| Signed APK | Self-signed release APK for sideloading; CI publishes it to GitHub Releases |
| Responsive UI | Drawer navigation, touch-sized controls, safe-area insets |
| File export | Routed through the WebView download (lands in Downloads) on Android |
| Persistence | App-private data dir (`appDataDir()`) + localStorage; works offline |
| No tray | Desktop-only tray / single-instance are `#[cfg(desktop)]`-gated out |
## 🚦 Error Pages & Offline (v0.27)
A single reusable, fully-localized `ErrorPage` component (`src/components/errors/`)
backed by a pure kind→meta config (`src/config/error-pages.ts`). All copy ships
in every locale (en/vi/ja/es/ko/zh).
| Kind | Route | Trigger |
|------|-------|---------|
| 404 Not found | catch-all `*` | A mistyped / dead hash route (live — was a blank screen before) |
| 403 Forbidden | `/#/403` | Designed page, route-reachable for future triggers |
| 419 Expired | `/#/419` | Designed page, route-reachable for future triggers |
| 500 Server error | `/#/500` | Designed page (covers 408/5xx), route-reachable for future triggers |
| Offline | `/#/offline` + banner | `navigator.onLine` flips false |
| Runtime crash | — | A render error caught by `ErrorBoundary` (shared `contained` variant) |
- **Full-screen, no shell** — dedicated error routes render outside `AppShell`
(no Sidebar/Header), with Home / Back / (Reload) / Report-a-bug actions.
- **Non-blocking offline banner** — a dismissible bottom strip; the app stays
fully usable offline, and a toast confirms when the connection returns.
## ⚖️ Legal & Consent (v0.28)
A first-run **consent gate** (`src/components/ConsentGate.tsx`, backed by the
pure `src/config/legal.ts`) blocks the app until the user reviews the legal
documents and ticks one "I agree" checkbox.
| Aspect | Behaviour |
|--------|-----------|
| Documents | Terms of Use, Privacy Policy, Disclaimer, License — linked to the GitHub-hosted copies (open in the browser); also surfaced in About → Legal |
| Acceptance | One combined checkbox; Continue disabled until checked |
| Persistence | Stored in the existing settings record (`legalConsentVersion` + timestamp) — **no cookie, no new storage key** |
| Re-prompt | Version-based — only when `CURRENT_TERMS_VERSION` is raised (terms changed); also re-shows in fresh / incognito storage |
| Desktop | Same in-app gate on Windows/macOS/Linux, **plus** a license-acceptance page in the Windows MSI/NSIS installer (`bundle.licenseFile`) |
| Layout | Full-screen, non-dismissible, theme- and locale-aware (all 6 languages) |
## 🔌 Future Extension Points
| Extension | Description | Effort |
+39 -10
View File
@@ -17,7 +17,7 @@ These are independent: a Vietnamese user can browse the app in Vietnamese (UI) w
```
src/i18n/
├── index.ts # i18next initialization + language registration
├── index.ts # i18next init + SUPPORTED_LANGUAGES (en eager, others lazy-loaded)
├── locales/
│ ├── _schema.json # JSON Schema defining all required keys
│ ├── en/
@@ -45,8 +45,18 @@ npm run generate:locale -- --lang es
# This creates:
# src/i18n/locales/es/ui.json (all keys, empty values)
# src/i18n/locales/es/templates.json (all keys, empty values)
# Prefer editing in place over working from blanks? Pre-fill with English:
npm run generate:locale -- --lang es --copy-english
# Overwrite an existing locale directory:
npm run generate:locale -- --lang es --force
```
The output is key-for-key identical to English, so `npm run validate:locales`
passes the moment the files are written — it checks key parity, not whether the
values were actually translated.
Or copy from English and translate:
```bash
@@ -205,8 +215,12 @@ cp -r src/i18n/locales/en src/i18n/locales/es
### Step 4: Register the language
**Four edits, not one.** This section previously claimed `SUPPORTED_LANGUAGES`
was the only registration step; it isn't, and the missing edits fail in
different ways — one at compile time, one silently at runtime.
```typescript
// src/i18n/index.ts — add to SUPPORTED_LANGUAGES
// 1. src/i18n/index.ts — the flag + native name shown in every language picker
export const SUPPORTED_LANGUAGES = [
{ id: "en", label: "English", flag: "🇬🇧", nativeName: "English" },
{ id: "vi", label: "Vietnamese", flag: "🇻🇳", nativeName: "Tiếng Việt" },
@@ -214,17 +228,32 @@ export const SUPPORTED_LANGUAGES = [
{ id: "es", label: "Spanish", flag: "🇪🇸", nativeName: "Español" }, // ← Add here
] as const;
// Add resource import
import esUI from "./locales/es/ui.json";
import esTemplates from "./locales/es/templates.json";
// 2. src/engine/types.ts — the union the whole engine is typed against
export type SupportedLanguage = "en" | "vi" | "ja" | "es" | "ko" | "zh";
// Add to i18next resources
resources: {
// ...existing
es: { ui: esUI, templates: esTemplates },
}
// 3. src/store/settings-heal.ts — detectBrowserLanguage's own hardcoded copy.
// Miss this and the language works, but is never auto-selected for a
// first-time visitor whose browser is set to it.
const supported: SupportedLanguage[] = ["en", "vi", "ja", "es", "ko", "zh"];
// 4. src/engine/tag-generator.ts — MULTILINGUAL_TAGS (see Step 5).
// Typed `Record<SupportedLanguage, …>`, so TypeScript catches this one.
```
> `SUPPORTED_LANGUAGES` is **not** type-bound to `SupportedLanguage`, and every
> consumer casts (`lang.id as SupportedLanguage`). A mismatch between edits 1
> and 2 therefore compiles cleanly and fails at runtime. Do both.
`npm run generate:locale` prints this checklist on success.
No import or `resources` edits needed (v0.26+): locales are lazy-loaded
through a dynamic `import("./locales/<code>/<ns>.json")`, so Vite picks the
new files up automatically as async chunks — **the file names must stay
exactly `ui.json` and `templates.json`**. Only English is eagerly bundled
(it's the `fallbackLng` and the engine's bilingual `tEn` source); don't add
static imports for other languages, that would drag them back into the
main chunk.
### Step 5: Add multilingual tag pool
```typescript
+167 -39
View File
@@ -27,7 +27,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Tauri CLI
cargo install tauri-cli
# Node.js 20+
# Node.js 22+
# npm already installed from web development
# Platform-specific
@@ -108,6 +108,15 @@ This creates `src-tauri/` directory.
}
```
> **Installer license page (v0.28).** The real `src-tauri/tauri.conf.json`
> sets `bundle.licenseFile: "installer-license.txt"` (path relative to
> `src-tauri/`). Tauri shows that file as an "accept the terms" page in the
> **Windows MSI/NSIS** installers. macOS `.app`/`.dmg` and the Linux packages
> have no interactive license step, so they rely on the app's first-run
> consent gate instead. If a WiX/MSI build ever rejects the `.txt`, switch to
> the per-bundler keys (`bundle.windows.wix.licenseFile` wants `.rtf`,
> `bundle.windows.nsis.licenseFile` accepts `.txt`).
### 3. Rust Backend (src-tauri/src/main.rs)
```rust
@@ -239,49 +248,168 @@ Output locations:
### GitHub Actions Release
```yaml
# .github/workflows/release-desktop.yml
name: Release Desktop
The live workflow lives at [.github/workflows/release-desktop.yml](../.github/workflows/release-desktop.yml). Pushing a `v*` tag (e.g. `v0.10.0`) triggers a three-platform matrix build (Windows, macOS ARM, Linux) and uploads each installer to a single draft GitHub Release named `YTDescGen v__VERSION__`. Publish the draft manually after smoke-testing the binaries.
on:
push:
tags: ["v*"]
Matrix entries:
permissions:
contents: write
| Runner | Target | Output |
|---|---|---|
| `windows-latest` | `x86_64-pc-windows-msvc` | `.msi`, `.exe` (NSIS) |
| `macos-14` | `aarch64-apple-darwin` | `.app.tar.gz` |
| `ubuntu-latest` | `x86_64-unknown-linux-gnu` | `.AppImage`, `.deb` |
jobs:
build:
strategy:
matrix:
include:
- os: windows-latest
target: x86_64-pc-windows-msvc
- os: macos-latest
target: aarch64-apple-darwin
- os: macos-latest
target: x86_64-apple-darwin
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
cache: npm
- uses: dtolnay/rust-toolchain@stable
with:
targets: ${{ matrix.target }}
- run: npm ci
- uses: tauri-apps/tauri-action@v0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
tagName: v__VERSION__
releaseName: "YTDescGen v__VERSION__"
releaseBody: "See CHANGELOG.md for details."
releaseDraft: true
Linux runners install `libwebkit2gtk-4.1-dev`, `libgtk-3-dev`, `libayatana-appindicator3-dev`, `librsvg2-dev`, and `patchelf` before building — Tauri's webview + AppImage tooling needs these.
`fail-fast: false` keeps the other platforms going if one breaks. The `bundleArgs` matrix field is concatenated with `--target ${{ matrix.target }}` and passed through to `tauri build`.
**macOS notes (v0.9.1+):**
- **DMG bundling is skipped** (`--bundles app`). Tauri's DMG bundler runs an AppleScript that flakes intermittently on hosted macOS runners (the headless display can't load Finder fast enough for `osascript` to position icons), so we ship a `.app.tar.gz` instead. Users expand the archive and drag the `.app` into `/Applications`.
- **Intel macOS (`macos-13`) is NOT built.** GitHub started deprecating the `macos-13` free runner pool in 2025; jobs queue indefinitely. If Intel support becomes a priority, switch the macos-14 entry's target to `universal-apple-darwin` (Tauri builds both archs and lipos them into one universal binary) — the runner already has the toolchain capacity.
**Code signing is intentionally skipped** for both Windows and macOS — this is an open-source personal tool, and signing certificates carry recurring cost. End users will see the standard "unverified publisher" / "unidentified developer" prompts on first launch. Document the bypass steps in the release notes if needed.
**Auto-changelog** (`git-cliff`) is out of scope; release notes come from the tag's annotated message via the default `tauri-action` behaviour. CHANGELOG.md is hand-maintained.
**Manual re-run:** the workflow accepts `workflow_dispatch` with a `tag` input — `gh workflow run release-desktop.yml -f tag=v0.9.0` rebuilds an existing release without deleting + recreating the tag. Useful when a transient runner failure costs a single arch's binary.
**Backfill for pre-workflow tags:** `v0.8.0` and `v0.8.1` predate the multi-platform matrix and only have local Windows builds. To attach binaries retroactively, build manually then `gh release create v0.8.0 --notes-file CHANGELOG.md path/to/*.msi …`.
## Android (.apk) Packaging
YTDescGen also builds an installable Android APK from the **same** Tauri 2
codebase — there is no separate mobile project. Tauri 2 ships Android support;
the crate is already `cdylib`/`staticlib` with a `#[cfg_attr(mobile, …)]` entry
point, and the Android launcher icons live in `src-tauri/icons/android/`. The
desktop-only tray / single-instance / hide-to-tray logic in `src-tauri/src/lib.rs`
is gated behind `#[cfg(desktop)]` so the library compiles for Android.
### Requirements & tested versions
| | |
|---|---|
| **Minimum OS** | **Android 11** (API level 30, `minSdk 30`). The APK will not install below this. |
| **Target OS** | **Android 16** (API level 36, `targetSdk 36`). |
| **Architectures** | Universal APK — `arm64-v8a`, `armeabi-v7a`, `x86`, `x86_64`. |
| **Tested** | **Android 11 → 16.** The v0.29.0 build was verified on Android emulators across this range **and on a real device running Android 12** (the maintainer's phone). |
Where the value lives: `bundle.android.minSdkVersion` in
[`src-tauri/tauri.conf.json`](../src-tauri/tauri.conf.json) is the source of
truth used by `tauri android init`; the generated
`gen/android/app/build.gradle.kts` carries the baked `minSdk = 30` — edit that
directly if you change the floor without re-running `init`.
**Why Android 11 is the floor (rationale):**
- **Coverage.** Android 11+ accounts for the large majority of active devices in
2026 (Android 14/15 alone are the two biggest slices, and 11–13 together still
hold a sizeable share). Going lower buys few extra users at growing compat cost.
- **A modern, patched WebView.** The app renders entirely in the system WebView,
whose minimum is Android 10. On Android 11+ the WebView auto-updates via Google
Play, so the rendering/JS engine stays current and patched. This is exactly why
the **real-device test on Android 12 worked**, while a *stale* Android-12
emulator stuck on WebView 91 showed a black screen (the `crypto.randomUUID`
boot crash) — that class of bug is fixed in v0.29.0 and is moot on an
up-to-date WebView.
- **Security upkeep.** Even though Google's *OS-level* monthly security bulletins
for Android 11–13 have ended (Android 12 in 2025, Android 13 in early 2026),
Android 11+ keeps receiving security updates for the components that matter to a
sandboxed WebView app: Google Play system updates (Project Mainline), Google
Play services, and System WebView. Requiring strict OS-bulletin support would
mean Android 14+, which would drop more than half of users.
### Prerequisites
- **Android SDK** — platform-tools, a platform (e.g. `android-34`/`android-36`), build-tools. Install via Android Studio or the command-line tools.
- **Android NDK** — r27 LTS recommended (e.g. `27.3.13750724`).
- **JDK 17** — Android Studio's bundled JBR works (`…/Android Studio/jbr`).
- **Rust android targets**:
```bash
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android
```
Set these environment variables before any `android` command (PowerShell shown):
```powershell
$env:ANDROID_HOME = "C:\Users\<you>\AppData\Local\Android\Sdk"
$env:NDK_HOME = "C:\Users\<you>\AppData\Local\Android\Sdk\ndk\27.3.13750724"
$env:JAVA_HOME = "C:\Jetbrains\Android Studio\jbr" # or any JDK 17
```
### Initialize (one-time)
```bash
cargo tauri android init
```
Generates the Gradle project under `src-tauri/gen/android/` — **committed** to
the repo so the signing block and any manifest edits persist. It pulls launcher
icons from `src-tauri/icons/android/` and sets `applicationId =
com.skullmute.ytdescgen`. Treat `init` as a one-time step: re-running it
overwrites hand edits like the signing config below, so only re-run it if a
Tauri upgrade requires regenerating the project (then re-apply the signing edit).
### Signing (one-time)
Sideloaded APKs must be signed. Create a self-signed release keystore and keep
it **outside** the repo:
```powershell
& "$env:JAVA_HOME\bin\keytool.exe" -genkeypair -v `
-keystore C:\keys\ytdescgen-release.jks `
-keyalg RSA -keysize 2048 -validity 10000 -alias ytdescgen
```
> ⚠️ **Back this keystore up.** If you lose it you can never publish an update
> that installs over an existing copy — Android rejects a changed signature.
Create `src-tauri/gen/android/keystore.properties` (gitignored):
```properties
storeFile=C:/keys/ytdescgen-release.jks
storePassword=<store-password>
keyAlias=ytdescgen
keyPassword=<key-password>
```
`app/build.gradle.kts` carries a `release` `signingConfigs` block that reads this
file, guarded by `if (exists())` — a missing keystore yields an *unsigned*
release build rather than a hard failure (handy for contributors).
### Build
```bash
cargo tauri android build --apk
# → src-tauri/gen/android/app/build/outputs/apk/universal/release/app-universal-release.apk
```
- `--apk` produces an APK. **Without it Tauri builds an `.aab`** App Bundle for the Play Store, which cannot be sideloaded.
- `cargo tauri android build --apk --target aarch64` builds an arm64-only APK (smaller download; covers virtually all modern phones).
- The build runs `npm run build` first (the `beforeBuildCommand`), then Gradle. The first build takes several minutes (Rust × up to 4 ABIs + a cold Gradle).
- For on-device iteration with hot reload: `cargo tauri android dev`.
Install on a device: copy the APK over (or `adb install -r <apk>`) and enable
"Install unknown apps" for the source app.
### CI
[.github/workflows/release-android.yml](../.github/workflows/release-android.yml)
builds and signs the APK on a `v*` tag (or `workflow_dispatch`) and attaches it
to the same draft GitHub Release as the desktop binaries. It needs four repo
secrets:
| Secret | Value |
|---|---|
| `ANDROID_KEYSTORE_BASE64` | base64 of the `.jks` (`base64 -w0 ytdescgen-release.jks`) |
| `ANDROID_STORE_PASSWORD` | keystore store password |
| `ANDROID_KEY_PASSWORD` | key password |
| `ANDROID_KEY_ALIAS` | `ytdescgen` |
### App-level changes for Android
- **`src-tauri/src/lib.rs`** — tray / single-instance / hide-to-tray / exit-prevention are `#[cfg(desktop)]`; the dialog/fs/opener/shell plugins and the six file commands run on every platform.
- **`src-tauri/Cargo.toml`** — `tauri-plugin-single-instance` lives in a desktop-only `[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]` table.
- **`src/utils/platform.ts` / `file-ops.ts`** — `IS_MOBILE` routes file export through the WebView blob download on Android (the native save dialog is unreliable under scoped storage). Settings persist via `appDataDir()` (app-private storage) **and** localStorage, both of which work on Android.
## Auto-Update Flow
```
-120
View File
@@ -1,120 +0,0 @@
# Product Requirements Document (PRD)
## YTDescGen — YouTube Gameplay Description Generator
**Version**: 1.0
**Author**: Kokone (skullmute)
**Last Updated**: 2026-04-07
---
## 1. Problem Statement
Kênh YouTube Gameplay No Commentary cần tạo title, description, và tags cho mỗi video upload. Quy trình hiện tại:
1. Mở file template → copy → paste vào YouTube Studio
2. Thay thế từng placeholder bằng thông tin game cụ thể
3. Tìm và thêm tags phù hợp thể loại
4. Lặp lại toàn bộ cho mỗi ngôn ngữ
5. Lặp lại toàn bộ cho mỗi video trong series
**Pain Points:**
- Lặp lại thao tác nhập Social/Rig/Channel info mỗi lần
- Dễ quên/sai khi thay placeholder
- Tags phải nhớ hoặc tra cứu từ file Excel
- Không có cách kiểm tra character limit trước khi paste
- Multi-language phải làm riêng từng bản
- Không tái sử dụng được game info cho multi-part series
## 2. Solution
Ứng dụng web (+ desktop) với form-based UI:
- Chọn video type, ngôn ngữ, thể loại game
- Nhập thông tin một lần → lưu Profile
- Nhập game info một lần → lưu Preset cho cả series
- Tự động generate title + description + tags
- Copy trực tiếp vào clipboard, paste vào YouTube Studio
- Hỗ trợ batch mode cho nhiều video cùng game
## 3. Target Users
- **Primary**: Bản thân Kokone — kênh Gameplay No Commentary
- **Secondary**: Các YouTuber gameplay nhỏ lẻ cùng niche
- **Future**: Mở rộng cho community qua GitHub release
## 4. Core User Stories
### Must Have (P0)
| ID | Story | Acceptance Criteria |
|----|-------|-------------------|
| US-01 | Chọn loại video (Full, Part, Boss, etc.) | UI hiển thị đúng form fields theo loại video đã chọn |
| US-02 | Chọn ngôn ngữ output (EN/VI/JA) | Toàn bộ generated output chuyển sang ngôn ngữ đã chọn |
| US-03 | Chọn thể loại game | Tags được generate phù hợp thể loại |
| US-04 | Nhập game info (tên, platform, store links) | Thông tin được đưa vào title + description đúng vị trí |
| US-05 | Nhập timestamps | Timestamps xuất hiện trong description với format YouTube chapters |
| US-06 | Nhập Social/Donate links | Links xuất hiện trong description section phù hợp |
| US-07 | Nhập Rig info | Rig xuất hiện dưới dạng compact format trong description |
| US-08 | Xem preview title + description + tags | Preview cập nhật real-time khi thay đổi input |
| US-09 | Copy từng phần (title / desc / tags) | Clipboard chứa đúng nội dung, toast confirm |
| US-10 | Copy tất cả | Clipboard chứa title + desc, tags riêng |
| US-11 | Hiển thị character count | Description ≤ 5000, Tags ≤ 500, warning khi gần/vượt limit |
| US-12 | Toggle Spoiler/18+ warning | Dòng warning xuất hiện/ẩn trong description |
### Should Have (P1)
| ID | Story | Acceptance Criteria |
|----|-------|-------------------|
| US-13 | Lưu Profile (social, rig, channel) | Profile persist qua sessions, load vào form |
| US-14 | Lưu Game Preset (tên + store links) | Preset persist, selectable khi tạo video mới |
| US-15 | Xem lịch sử generated outputs | Danh sách outputs đã tạo, có thể copy lại |
| US-16 | Thêm ngôn ngữ mới dễ dàng | Chỉ cần thêm locale JSON files + register |
| US-17 | Thêm thể loại game mới | Chỉ cần thêm entry trong config + tag pool |
| US-18 | Import/Export settings | JSON export/import cho profiles + presets |
| US-19 | Multi-language output đồng thời | Generate cả 3 ngôn ngữ cùng lúc, mỗi ngôn ngữ 1 tab |
### Nice to Have (P2)
| ID | Story | Acceptance Criteria |
|----|-------|-------------------|
| US-20 | Batch mode cho multi-part series | Nhập game info 1 lần, tạo N videos khác part/timestamps |
| US-21 | Desktop app (Windows/macOS) | Tauri binary, hoạt động offline |
| US-22 | Custom template editor | Người dùng tự sửa template structure |
| US-23 | Keyboard shortcuts | Ctrl+Enter = generate, Ctrl+Shift+C = copy all |
| US-24 | Dark/Light theme toggle | Theme persist qua sessions |
| US-25 | Auto-save draft | Form state tự lưu, recover khi reload |
| US-26 | Tag suggestions từ game name | Gợi ý tag dựa trên tên game + trending |
| US-27 | YouTube API integration | Auto-fill qua YouTube Data API (future) |
| US-28 | VS Code / IDE extension | Command palette → generate description |
## 5. Non-Functional Requirements
| Requirement | Target |
|------------|--------|
| First Contentful Paint | < 1.5s |
| Bundle size (web) | < 500KB gzipped |
| Desktop binary size | < 15MB (Tauri) |
| Offline support | Full functionality without internet |
| Browser support | Chrome 90+, Firefox 90+, Edge 90+ |
| Accessibility | WCAG 2.1 Level AA |
| Persistence | localStorage (web), file system (desktop) |
## 6. Out of Scope (v1)
- YouTube API auto-upload
- Thumbnail generation
- Video editing integration
- Multi-user / team features
- Cloud sync between devices
- Analytics / tracking
- Monetization
## 7. Success Metrics
| Metric | Target |
|--------|--------|
| Time to generate 1 video description | < 2 minutes (vs ~10 minutes manual) |
| Error rate (missing fields, wrong format) | 0% — form validates before generate |
| Languages supported at launch | 3 (EN, VI, JA) |
| Genres supported at launch | 10+ |
| Video types supported | 7+ |
+1 -1
View File
@@ -51,7 +51,7 @@
- [x] editor/ components: StoreLinkEditor, RigEditor, SocialEditor, WarningToggles
- [x] editor/ components: QuickPreview
- [x] output/ components: OutputPreview, CopyButton, CharCounter, CopyAllBar
- [x] layout/ components: AppShell, Header, TabBar
- [x] layout/ components: AppShell, Header, Sidebar
1.7 Pages
- [x] EditorPage (form + quick preview)
+77 -11
View File
@@ -11,7 +11,7 @@
```jsonc
{
"name": "yt-desc-gen",
"version": "0.1.0",
"version": "0.20.0",
"private": true,
"type": "module",
"scripts": {
@@ -317,19 +317,46 @@ jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: 20
node-version: 22
cache: npm
- run: npm ci
- run: npm run typecheck
# correctness
- run: npm run typecheck # src/
- run: npm run typecheck:all # + tests/ and scripts/
- run: npm run lint
- run: npm run validate:locales
- run: npm run test:run
# consistency
- run: npm run format:check
- run: npm run knip
- run: npm run check:version
# security (advisory — a fresh transitive advisory must not redden
# every unrelated PR before Dependabot opens its fix)
- run: npm audit --audit-level=high
continue-on-error: true
- run: npm run build
```
The workflow also declares `permissions: contents: read` (least privilege, and
it clears CodeQL's `actions/missing-workflow-permissions` alert) and a
`concurrency` group that cancels superseded runs everywhere except `main`, where
each commit's result is a historical record the release process reads back.
**Why these gates exist.** Every one of them was already installed and
configured before v0.35.0, and none of them ran. `knip` was in `package.json`
with a `knip.json` beside it. Prettier had a config and a `format` script.
Turning them on found real problems immediately — most notably that
`tsconfig.json` covers only `src/`, so `tests/` and `scripts/` had **never** been
type-checked, which was hiding three fields silently missing from the
editor→engine parity fixture whose entire job is catching that class of drift.
```yaml
# .github/workflows/deploy-web.yml
name: Deploy to GitHub Pages
@@ -350,19 +377,19 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
with:
node-version: 20
node-version: 22
cache: npm
- run: npm ci
- run: npm run build
- uses: actions/configure-pages@v5
- uses: actions/upload-pages-artifact@v3
- uses: actions/configure-pages@v6
- uses: actions/upload-pages-artifact@v5
with:
path: dist
- id: deployment
uses: actions/deploy-pages@v4
uses: actions/deploy-pages@v5
```
## 5. Testing Strategy
@@ -418,3 +445,42 @@ describe("buildTitle", () => {
| Single Tag | 30 chars | YouTube rejects that tag |
| Hashtags in description | 60 max, 3 shown | First 3 shown above title |
| Playlist title | 150 chars | Truncated |
### Enforcement (v0.35.0)
`renderAll` has always returned `warnings: CharLimitWarning[]`; until v0.35.0
nothing in the UI read it. `src/engine/limits.ts` is now the single derivation,
consumed by `useOutputLimits` on Output and precomputed per row in Batch.
The rule is **all-or-nothing per output**: one over-limit field disables every
copy button for that output. `checkTitleWarning` / `checkDescriptionWarning`
only fire when a field is *strictly over*, never at the 80 % counter threshold,
so a non-empty `warnings` array is an exact "YouTube will reject this" signal.
Deliberately not gated by `YT_LIMITS`: thumbnail text and the pinned comment
(different surfaces), the Playlist tab (150-char title, not 100), and social
captions (per-platform caps in `SOCIAL_PLATFORMS`).
## 7. Field Limits (v0.35.0)
`src/config/field-limits.ts` — caps on what can be *typed*, distinct from
YouTube's caps on what is *generated*.
```typescript
export const FIELD_LIMITS = {
URL: 200,
EMAIL_FIELD: 320, // 3 addresses; RFC 5321 caps a single one at 254
SHORT_NAME: 100,
LABEL: 300,
LONG_TEXT: 2000,
TIMESTAMPS: YT_LIMITS.DESCRIPTION_MAX,
NUMERIC: 10,
} as const;
```
Values are UTF-16 code units, matching the DOM `maxLength` attribute — an emoji
costs 2. Grapheme counting would be more correct but cannot be enforced by the
browser, and these are ceilings against absurd input, not a character budget.
`maxLength` only constrains typing and pasting, so `clampField` is applied in
`normalizeEditorPatch` to cover profile / preset / template imports.
+161
View File
@@ -0,0 +1,161 @@
# Danh mục Nội dung
Bản kê khai tĩnh cho mọi loại video, thể loại game, và cảnh báo nội dung trong editor của YTDescGen. Cập nhật thủ công — khi thêm mục mới vào một trong các file nguồn dưới đây, **thêm dòng tương ứng vào đây** trong cùng PR.
File này tồn tại để **minh bạch** — bất kỳ ai tò mò về việc editor có thể mô tả được gì (mà không cần cài app hay đọc source) đều có thể quét trong một phút.
**Bản gốc tiếng Anh:** [`docs/CONTENT-INVENTORY.md`](../../CONTENT-INVENTORY.md).
**Nguồn tham chiếu (source of truth):**
- Loại video: [`src/config/video-types.ts`](../../../src/config/video-types.ts)
- Thể loại game: [`src/config/genres.ts`](../../../src/config/genres.ts)
- Cảnh báo nội dung: [`src/config/content-warning-groups.ts`](../../../src/config/content-warning-groups.ts)
---
## 1. Loại video (20)
Mỗi loại video kéo theo một template description, cấu trúc title, và tag bias riêng. Cột "Trường bổ sung" liệt kê các trường editor sẽ hiển thị khi chọn loại video tương ứng.
| Icon | Loại | Trường bổ sung |
|---|---|---|
| 🎮 | Gameplay đầy đủ | — |
| 📂 | Gameplay theo phần | Số phần |
| 🎬 | Demo đầy đủ | — |
| 🎞 | Demo theo phần | Số phần |
| 👹 | Đấu trùm | Tên trùm |
| 💀 | Đấu trùm không trúng đòn | Tên trùm |
| 🏁 | Kết thúc / Toàn bộ Ending | — |
| ⚡ | Speedrun | — |
| 💯 | Hoàn thành 100% | — |
| 📦 | Nội dung DLC | Tên DLC |
| 🔄 | New Game+ | — |
| 🏆 | Thử thách | Tên thử thách |
| 📌 | Nhiệm vụ phụ | — |
| 🔍 | Bí mật / Ẩn | — |
| ⚖️ | So sánh đồ họa | — |
| 📘 | Hướng dẫn không lời | — |
| 🧩 | Chơi với Mod | Tên Mod |
| ⭐ | Toàn bộ vật phẩm sưu tầm | — |
| 🔴 | Livestream | URL Live, Thời gian dự kiến |
| 🎴 | Nhiệm vụ Gacha | Loại nhiệm vụ, Tên chapter, Tên quest, Số phần |
---
## 2. Thể loại game (41)
Thể loại được chọn ảnh hưởng đến định dạng title, tag pool, và (khi cấu hình ở Settings → Genre Playlists) gợi ý playlist trong pinned comment.
Các nhóm bulk-select trong editor: **All RPGs** (rpg + jrpg + action_rpg + crpg), **All Shooters** (fps + arena_shooter + tactical_fps + boomer_shooter + extraction_shooter + shmup), **All Horror** (horror + survival_horror + psychological_horror).
| Icon | Thể loại |
|---|---|
| ⚔️ | Hành động / Phiêu lưu |
| 🗡 | Hack & Slash |
| 👊 | Beat 'em Up |
| 🦘 | Platformer |
| 👻 | Kinh dị / Sinh tồn |
| 🧟 | Kinh dị Sinh tồn |
| 🧠 | Kinh dị Tâm lý |
| 🛡 | RPG |
| 🎎 | JRPG |
| 🏹 | Action RPG |
| 📜 | CRPG / Góc nhìn từ trên |
| 🔫 | FPS / Bắn súng |
| 🎯 | Bắn súng Arena |
| 🎖 | Bắn súng Chiến thuật |
| 💥 | Boomer Shooter |
| 🎒 | Extraction Shooter |
| 🛸 | SHMUP / Bullet Hell |
| 🌍 | Thế giới mở / Sandbox |
| 🕹 | Indie |
| 💀 | Souls-like |
| 🏎 | Đua xe / Thể thao |
| 📖 | Cốt truyện |
| 🏗 | Mô phỏng / Chiến thuật |
| 🏙 | Xây thành |
| 🥊 | Đối kháng |
| 🥷 | Lén lút / Gián điệp |
| ⛏ | Sinh tồn / Chế tạo |
| 🎲 | Roguelike / Roguelite |
| 🗺 | Metroidvania |
| 🌐 | MMO / Trực tuyến |
| 🎵 | Âm nhạc / Nhịp điệu |
| 🧩 | Giải đố |
| 🏰 | Tower Defense |
| 🃏 | Bài / Card |
| 🎴 | Deck Builder |
| 🤖 | Auto Battler |
| 🏆 | Battle Royale |
| ♟ | Chiến thuật theo lượt |
| 🚀 | Không gian / Sci-Fi |
| 🌾 | Nông trại / Life Sim |
| 🎬 | FMV / Phim tương tác |
| 💬 | Visual Novel |
---
## 3. Cảnh báo nội dung (248, chia nhóm)
Cảnh báo được chọn sẽ thêm vào khối `⚠ CONTENT WARNINGS` trong description, trước phần timestamp. Mỗi nhóm có thể thu gọn trong editor; cảnh báo hiển thị theo thứ tự người dùng chọn.
### Spoiler (6)
Spoiler cốt truyện / ending · Spoiler ending · Spoiler ending thật · Spoiler hậu game / NG+ · Spoiler ending bí mật · Spoiler cốt truyện DLC
### Sức khỏe / Quang nhạy (13)
Hiệu ứng chớp sáng · Say game / camera nhanh · Có thể đau nửa đầu · Đèn nhấp nháy · Rung màn hình mạnh · Loé sáng / lens flare · Bloom quá đà / sáng cháy · Hiệu ứng hạt dày đặc · HUD / overlay nhấp nháy · Màu sắc quá rực / loè loẹt · Motion blur nặng · Depth of field gắt · Post-processing đậm đặc
### Âm thanh / Cảm âm (13)
Âm thanh đột ngột · Âm chói tai / tần số cao · Jumpscare bằng âm thanh · Thay đổi âm lượng đột ngột · Âm thanh méo / vỡ · Tiếng ken két / kim loại · Tiếng cao kéo dài · Lỗi âm thanh / glitch · Bass nặng / sub-bass rung · Tiếng la hét kéo dài · Tiếng kính vỡ / va đập · Tạp âm mic / tiếng thở · Tiếng nhiễu / tĩnh điện
### Lời thoại / Ngôn từ (10)
Văng tục dày đặc · Lời thoại ẩn ý t*nh d*c · Lời thoại kích động · Lăng mạ / sỉ nhục bằng lời · Lời đe dọa / uy hiếp · Từ ngữ miệt thị / xúc phạm · Hài thô tục · Hài người lớn · Hài đen / u tối · Nhắc đến chất kích thích / đồ có cồn
### Ám ảnh / Phobia (56)
Jumpscare · Sợ độ cao (acrophobia) · Sợ lỗ / cụm (trypophobia) · Sợ nước sâu (thalassophobia) · Sợ không gian kín (claustrophobia) · Sợ nhện (arachnophobia) · Sợ côn trùng (entomophobia) · Sợ rắn (ophidiophobia) · Sợ chó (cynophobia) · Sợ bóng tối (nyctophobia) · Sợ lửa (pyrophobia) · Sợ búp bê (pediophobia) · Sợ máu (hemophobia) · Sợ chú hề (coulrophobia) · Sợ chết đuối (ablutophobia) · Sợ bị chôn sống (taphophobia) · Hình nhân máy (automatonophobia) · Vật thể khổng lồ (megalophobia) · Vật nhân tạo dưới nước (submechanophobia) · Xác chết (necrophobia) · Ma quỷ (spectrophobia) · Quỷ dữ (demonophobia) · Cá mập (selachophobia) · Vi trùng / ô nhiễm (mysophobia) · Nôn mửa (emetophobia) · Bị nhìn chằm chằm (scopophobia) · Cô lập (monophobia) · Chuột (musophobia) · Dơi (chiroptophobia) · Chim (ornithophobia) · Cá (ichthyophobia) · Bò sát (herpetophobia) · Gián (katsaridaphobia) · Ong (apiphobia) · Sấm sét (astraphobia) · Không gian rộng (agoraphobia) · Đám đông (enochlophobia) · Tuyết / giá lạnh (chionophobia) · Bệnh viện (nosocomephobia) · Vật sắc nhọn (aichmophobia) · Nghẹt thở (pnigophobia) · Sương mù (homichlophobia) · Lốc xoáy / bão (lilapsophobia) · Mưa lớn (ombrophobia) · Mây / trời u ám (nephophobia) · Gió mạnh (ancraophobia) · Cực lạnh (cryophobia) · Ánh nắng gay gắt (heliophobia) · Sóng lớn (cymophobia) · Hồ / nước tĩnh (limnophobia) · Sông / dòng chảy (potamophobia) · Sợ màu sắc / cảnh màu chói (chromophobia) · Sợ màu đỏ / cảnh toàn đỏ (erythrophobia) · Sợ màu vàng (xanthophobia) · Sợ màu trắng / không gian toàn trắng (leukophobia) · Sợ màu đen (melanophobia)
### Sức khỏe tâm thần (17)
Cảnh gây lo âu · Trầm cảm · Rối loạn ăn uống · Sử dụng chất kích thích · Tự hại / tự tử · PTSD · Kim tiêm · Dịch cơ thể · Mang thai / sinh nở kinh dị · Bệnh tật / nhiễm trùng · Lưỡng cực · OCD · Hoảng loạn · Phân ly · Hoang tưởng · Suy nghĩ xâm nhập · Y khoa kinh dị
### Hiện tượng tâm lý — xã hội (22)
Tự kỷ / thần kinh đa dạng · ADHD / rối loạn tập trung · Hikikomori / ẩn dật xã hội · NEET (không học không làm) · Lo âu xã hội · Cô lập xã hội / cô đơn · Tâm thần phân liệt / loạn thần · Burnout / kiệt sức · Mặc cảm sống sót · Bị bỏ rơi / sang chấn · Quan hệ parasocial · Gaslighting / thao túng · Hội chứng Stockholm · Nghiện game / cờ bạc · Khủng hoảng hiện sinh · Hội chứng kẻ mạo danh · Khủng hoảng tuổi trung niên · Khủng hoảng tuổi 1/4 · Quấy rối nơi làm việc · Áp lực vai trò giới · Miệt thị ngoại hình (body shaming) · Chuẩn mực ngoại hình phi thực tế
### Internet / Đời sống số (18)
Bắt nạt / quấy rối qua mạng · Doxxing / phơi bày thông tin cá nhân · Trolling / phá game · Văn hóa tẩy chay / bêu rếu công khai · Nghiện mạng xã hội · Lướt tin tiêu cực vô độ (doomscrolling) · Hội chứng sợ bỏ lỡ (FOMO) · Tin giả / thông tin sai lệch · Lừa đảo trực tuyến / phishing · Giả mạo danh tính trên mạng (catfishing) · Deepfake / nội dung giả mạo bằng AI · Theo dõi / rình rập qua mạng · Trào lưu / thử thách nguy hiểm trên mạng · Văn hóa influencer / câu tương tác · Cực đoan hóa qua mạng / buồng vang thông tin · Loot box / cơ chế gacha · Chủ đề AI / trí tuệ nhân tạo · Riêng tư dữ liệu / giám sát diện rộng
### Nội dung nhạy cảm / 18+ (66)
Máu me · 18+ · Trang phục hở hang · Kh*a th*n một phần · Tạo hình nhân vật bị t*nh d*c hóa · Yếu tố fan service · Tư thế / góc quay gợi cảm · Hình ảnh gây khó chịu · B*o h*nh động vật · Trẻ em chịu tác động · B*o h*nh gia đình · Tham chiếu x*m h*i t*nh d*c · Tra tấn · Tôn giáo · Tác động vật lý chiến tranh · Phân biệt đối xử · Tác động vật lý từ chính quyền · Hút thuốc / uống rượu · G*ết người chi tiết · Tà giáo / huyền bí · Thao túng tâm lý · Mất mát / đau buồn · Bắt cóc · Phát ngôn thù hận · Tội ác lịch sử · Nô lệ · Khủng bố · Bắt nạt · Thử nghiệm trên người · Ăn thịt người · Hạt nhân / phóng xạ · Kỳ thị người đồng tính / LGBTQ+ (homophobia) · Kỳ thị người chuyển giới (transphobia) · Bài ngoại (xenophobia) · Cực đoan chính trị · Cực đoan tôn giáo / cuồng tín · Diệt chủng / thanh trừng sắc tộc · Thánh chiến / xung đột tôn giáo · Đại nạn Holocaust · Nội chiến · Xả súng hàng loạt / xả súng trường học · Chủ nghĩa thực dân / đế quốc · Tuyên truyền nhà nước · Nhà nước giám sát / dystopia · Thuyết âm mưu · Kiểm duyệt / cấm phát ngôn · Xung đột sắc tộc / chủng tộc · Khủng hoảng tị nạn · Cách mạng / nổi dậy · Ám sát chính trị · Đảo chính · Toà án dị giáo / săn phù thủy · Lao động cưỡng bức · Chủ nghĩa dân tộc cực đoan · Treo c* / siết c* · Cảnh ch*t đuối · Cảnh thiêu s*ng · Cảnh ngạt th* · Bị trói / cầm tù tra tấn · Cảnh hành quyết công khai · Cảnh chặt đầu · Cảnh đâm xuyên cơ thể · Thương vong hàng loạt · Tác động vật lý bằng phương tiện · Cảnh sử dụng quá liều · Ngã / nhảy từ trên cao
### Kinh dị nặng (12)
Mắt / cụm mắt · Body horror (biến dạng cơ thể) · Mặt biến dạng / cắt xén · Kinh dị vũ trụ · Máu me / phân thây cực độ · Phân hủy, thối rữa, dòi bọ · Cắt xẻo / cụt chi · Liminal space · Analog horror / VHS · Phi thực tế / méo mó · Truy đuổi · Thực thể / SCP
### Thông tin về playstyle (10)
Lần đầu chơi (blind) · Không spoiler trong chat · Chế độ easy / story · Chế độ khó cao · Permadeath / Iron Man · Thử speedrun · 100% completionist · Đang học cơ chế · Chơi lần đầu · Chơi lại / NG+
### Thông tin về gameplay (5)
Dùng mod · Bật cheat / debug · Dùng glitch · Có guide hỗ trợ · Game mục đích giáo dục / tuyên truyền
---
## 4. Bảo trì
Khi thêm mục mới vào bất kỳ file nguồn nào:
1. **Loại video** → thêm vào [`src/config/video-types.ts`](../../../src/config/video-types.ts) VÀ thêm dòng vào mục 1 ở trên.
2. **Thể loại** → thêm vào [`src/config/genres.ts`](../../../src/config/genres.ts) VÀ thêm dòng vào mục 2.
3. **Cảnh báo nội dung** → thêm vào nhóm phù hợp ở [`src/config/content-warning-groups.ts`](../../../src/config/content-warning-groups.ts) VÀ thêm label vào đúng nhóm ở mục 3 — giữ số đếm trong tiêu đề chính xác.
4. Cập nhật cả bản gốc EN tại [`docs/CONTENT-INVENTORY.md`](../../CONTENT-INVENTORY.md) trong cùng PR.
Sai lệch giữa file này và file nguồn được xem là lỗi tài liệu — mở issue hoặc PR.
+149
View File
@@ -0,0 +1,149 @@
# Hướng dẫn phát triển
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`docs/DEVELOPMENT.md`](../../DEVELOPMENT.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
Hướng dẫn này bao gồm cách cài đặt YTDescGen để phát triển cục bộ trên Windows, macOS hoặc Linux. Ứng dụng là một web app Vite/React với tùy chọn vỏ desktop Tauri.
## Cấu hình máy tham chiếu
Cấu hình máy đã dùng để phát triển và phát hành dự án:
| Thành phần | Thông số |
| --- | --- |
| OS | Windows 11 Pro (24H2 trở lên) |
| CPU | x86-64 hiện đại — 6 nhân trở lên có AVX2 (Intel gen 11 / AMD Zen 3 hoặc mới hơn) |
| GPU | Rời hoặc tích hợp — backend WebView2 của Tauri chạy thoải mái trên iGPU |
| RAM | Tối thiểu 16 GB, khuyến nghị 32 GB để chạy song song typecheck + dev server |
| Lưu trữ | 5 GB trống cho `node_modules` + `target/` Cargo sau khi build Tauri đầy đủ |
| Màn hình | Tối thiểu 1920×1080; layout mobile đã test đến 360×640 |
macOS và Linux đều dùng được để phát triển. Build release Tauri được cross-compile hoặc chạy trên CI riêng — xem [PACKAGING.md](../../PACKAGING.md).
## Toolchain
Cài theo thứ tự:
| Công cụ | Phiên bản | Lý do |
| --- | --- | --- |
| **Node.js** | `>= 22.12.0` | Vite 8 yêu cầu Node `^20.19` hoặc `>= 22.12`. Dùng [nvm](https://github.com/nvm-sh/nvm) hoặc [fnm](https://github.com/Schniz/fnm). |
| **npm** | đi kèm Node 22 | Dự án dùng npm; `pnpm` và `yarn` chưa test. |
| **Rust** | stable, `>= 1.78` | Bắt buộc cho build Tauri. Cài qua [rustup](https://rustup.rs/). |
| **Python** | `3.12` | Tùy chọn — chỉ cần cho một số tooling Tauri trên Windows. |
| **Tauri prerequisites** | theo OS | Xem <https://v2.tauri.app/start/prerequisites/>. |
### Windows
- Cài **Visual Studio Build Tools 2022** với workload "Desktop development with C++" (bắt buộc cho `tauri-build`).
- Cài **WebView2 Runtime** (Windows 11 thường đã có sẵn).
- Bật long path: `git config --global core.longpaths true`.
### macOS
- Cài Xcode Command Line Tools: `xcode-select --install`.
### Linux
- Cài Tauri prerequisites theo từng distro — `libwebkit2gtk-4.1-dev`, `libappindicator3-dev`, v.v. Xem docs Tauri ở link trên.
## Cấu hình IDE
Quy trình tham chiếu dùng **JetBrains 2026.x** (WebStorm hoặc RustRover) làm IDE chính, **VS Code** cho chỉnh sửa nhanh.
### JetBrains (WebStorm / RustRover / IntelliJ Ultimate)
- Bật plugin **Tailwind CSS**.
- Bật plugin **i18next** (hoặc dùng `src/i18n/locales/_schema.json` để autocomplete).
- Settings → Languages → TypeScript → "Use TypeScript from `node_modules/typescript`".
- Settings → Code Style → Prettier → Run on save (`src/**/*.{ts,tsx,json,css}`).
### VS Code
Extension đề xuất (không có `.vscode/extensions.json` được commit — cài thủ công):
- `dbaeumer.vscode-eslint`
- `esbenp.prettier-vscode`
- `bradlc.vscode-tailwindcss`
- `rust-lang.rust-analyzer` (nếu động vào `src-tauri/`)
- `tauri-apps.tauri-vscode`
## Chạy lần đầu
```bash
# 1. Clone
git clone https://github.com/poli0981/youtube-generator.git
cd youtube-generator
# 2. Cài web dependencies
npm install
# 3. Chạy web dev server
npm run dev
# → http://localhost:5173
```
## Lệnh thường dùng
| Lệnh | Tác dụng |
| --- | --- |
| `npm run dev` | Vite dev server, hot reload, chỉ web. |
| `npm run build` | Bundle web production vào `dist/`. |
| `npm run preview` | Phục vụ bundle production để kiểm tra. |
| `npm run typecheck` | `tsc --noEmit`. Chạy trước mỗi PR. |
| `npm run lint` | ESLint. Dùng `npm run lint:fix` để autofix. |
| `npm run format` | Chạy Prettier trên `src/`. |
| `npm run test` | Vitest chế độ watch. |
| `npm run test:run` | Vitest chạy một lần (cho CI / pre-commit). |
| `npm run test:coverage` | Báo cáo coverage vào `coverage/`. |
| `npm run validate:locales` | Bắt buộc cả 6 locale có cùng key với `_schema.json`. **Phải pass trước khi merge PR động đến locale.** |
| `npm run generate:locale` | Scaffold locale rỗng từ `_schema.json` cho ngôn ngữ mới. |
| `npm run tauri:dev` | Tauri desktop chế độ dev (tự restart khi đổi Rust hoặc frontend). |
| `npm run tauri:build` | Build binary Tauri release cho platform hiện tại. |
## Build Tauri desktop
Xem [PACKAGING.md](../../PACKAGING.md) cho pipeline release đầy đủ. Build cục bộ nhanh:
```bash
npm run tauri:build
# Output: src-tauri/target/release/bundle/{msi,deb,dmg,app}
```
Build đầu tiên mất khoảng 5–10 phút (Cargo cache rỗng). Build sau đó là incremental.
## Khắc phục sự cố
### `validate:locales` fail sau khi thêm key
Bạn quên cập nhật `src/i18n/locales/_schema.json`. Schema là source of truth; locale phải khớp 100%.
### Build Tauri báo `link.exe not found` (Windows)
Cài Visual Studio Build Tools 2022 + workload Desktop C++, sau đó khởi động lại shell để PATH được cập nhật.
### Build Tauri báo `pkg-config not found` (Linux)
Cài Tauri prerequisites theo distro tại <https://v2.tauri.app/start/prerequisites/>.
### `npm install` chậm / treo
Tắt VPN/proxy doanh nghiệp chặn npm registry. Lock file đã commit; install offline chạy được sau lần install thành công đầu tiên.
### Hot reload không bắt được sửa đổi locale
Locale JSON bundle vào lúc build, không được watch. Restart dev server sau khi sửa `src/i18n/locales/*`.
Từ v0.26, chỉ tiếng Anh nằm trong main chunk; các ngôn ngữ khác là async
chunk lazy-load, tải khi dùng lần đầu (xem `src/i18n/index.ts` và
docs/I18N.md). Lời khuyên restart ở trên vẫn áp dụng cho tất cả.
### Pre-commit hook fail ở `validate:locales` mà mình không động đến locale
Có thể bạn vô tình thêm key mới vào `_schema.json` thông qua `src/engine/types.ts` → `CONTENT_WARNINGS`. ID mới cần dịch ở cả 6 locale.
## Xem thêm
- [ARCHITECTURE.md](../../ARCHITECTURE.md) — mô hình layer, data flow, thiết kế engine.
- [I18N.md](../../I18N.md) — thêm ngôn ngữ mới từng bước.
- [PACKAGING.md](../../PACKAGING.md) — Tauri release build và signing.
- [CONTRIBUTING.md ở root](../../../CONTRIBUTING.md) — quy trình PR, quy ước commit, auto-ignore rules.
- [SECURITY.md ở root](../../../SECURITY.md) — báo cáo lỗ hổng bảo mật.
+55
View File
@@ -0,0 +1,55 @@
# Tuyên bố miễn trừ
> **Lưu ý dịch thuật:** Tiếng Anh là phiên bản chính ([`DISCLAIMER.md` ở root](../../../DISCLAIMER.md)). Bản tiếng Việt này có thể chậm cập nhật một vài commit.
## Dự án cá nhân, có sự hỗ trợ của AI
YTDescGen là dự án cá nhân do một người duy trì (`@poli0981`) để dùng cho kênh YouTube [`@SkullMute`](https://www.youtube.com/@SkullMute), và chia sẻ công khai dưới dạng mã nguồn mở. Đây **không phải sản phẩm thương mại** và không có nghĩa vụ hỗ trợ.
Mã nguồn, tài liệu, bản dịch locale, và các quyết định thiết kế trong repo này được **đồng tác giả với sự hỗ trợ của Anthropic's Claude Code (model 4.7 Opus, cửa sổ context 1M)**. Tất cả commit, release, và quyết định kiến trúc được người duy trì xem xét và phê duyệt trước khi merge.
Tuyên bố này áp dụng cho:
- Mã nguồn trong `src/` và `src-tauri/`.
- Tài liệu trong `docs/` và các file markdown ở root.
- File locale trong `src/i18n/locales/`.
- Workflow CI/CD trong `.github/workflows/`.
Xem thêm: [`THIRD_PARTY_NOTICES.md`](../../../THIRD_PARTY_NOTICES.md) § "AI-Assisted Development Disclosure".
## Chất lượng bản dịch
UI ứng dụng hỗ trợ sáu ngôn ngữ. Chất lượng tác giả khác nhau:
| Locale | Tác giả | Ghi chú |
| --- | --- | --- |
| Tiếng Anh (`en`) | Người duy trì + AI | Locale làm việc chính. Chuỗi được review trước khi commit. |
| Tiếng Việt (`vi`) | Người duy trì (bản ngữ) + AI | Review bởi người duy trì là người bản ngữ tiếng Việt. |
| Tiếng Nhật (`ja`) | AI dịch | Không có review bản ngữ. Ngữ pháp và văn phong có thể chưa chuẩn. |
| Tiếng Tây Ban Nha (`es`) | AI dịch | Không có review bản ngữ. Không nhắm cụ thể vào giọng vùng miền (LatAm vs. Castilian). |
| Tiếng Hàn (`ko`) | AI dịch | Không có review bản ngữ. Honorific register chọn ở mức trung tính. |
| Tiếng Trung (`zh`) | AI dịch | Giản thể. Không có review bản ngữ. |
Nếu bạn là người bản ngữ và phát hiện dịch sai, vui lòng mở issue hoặc PR — xem [CONTRIBUTING.md](../../../CONTRIBUTING.md) § "i18n Contributions".
## Giọng văn và phong cách
Template description sinh ra dùng giọng văn được điều chỉnh cho ngách **gameplay no-commentary** trên YouTube, đặc biệt nhấn mạnh game horror / kinh dị (vì đó là nội dung kênh của người duy trì). Output có thể không hợp với mọi kênh hay mọi văn hoá đọc. Ứng dụng dùng template — bạn có thể sửa bất kỳ text sinh ra nào trước khi đăng.
Một số cụm tiếng Việt cố tình giữ từ vay mượn và giọng casual phản ánh cách các creator gameplay Việt thường viết description. Đây không phải "dịch sai" mà là lựa chọn phong cách cho đối tượng đọc.
## Không bảo hành
Phần mềm cung cấp **nguyên trạng, không có bất kỳ bảo hành nào**. Xem [`LICENSE`](../../../LICENSE) (Apache 2.0) §§ 7 và 8 cho đầy đủ điều khoản miễn trừ bảo hành và giới hạn trách nhiệm.
Nói ngắn gọn: nếu ứng dụng crash, làm hỏng draft, sinh ra description khiến video bị YouTube flag, hoặc gây bất kỳ thiệt hại nào — người duy trì không chịu trách nhiệm. Dùng tự chịu rủi ro; back up draft của bạn.
## Không liên kết với YouTube / Anthropic
YTDescGen **không** liên kết, được tài trợ, hay được YouTube, Google LLC, hay Alphabet Inc. xác nhận. Output sinh ra dành để paste vào YouTube Studio editor; ứng dụng này không tương tác với YouTube API.
Việc dùng Claude Code trong quá trình phát triển **không** biến đây thành sản phẩm của Anthropic. Anthropic, Claude, và Claude Code là nhãn hiệu của Anthropic, PBC. Dự án này độc lập.
## Không phải tư vấn pháp lý hay tài chính
Bất kỳ đề cập nào đến GDPR, CCPA, luật bản quyền, chính sách monetization của YouTube, hay các chủ đề tương tự trong tài liệu repo này chỉ để định hướng — **không phải tư vấn pháp lý**. Tham vấn luật sư có chuyên môn ở khu vực của bạn nếu cần câu trả lời chính thống.
+29
View File
@@ -13,6 +13,35 @@ export default tseslint.config(
...reactHooks.configs.recommended.rules,
"@typescript-eslint/no-explicit-any": "error",
"@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
// eslint-plugin-react-hooks 7 turned on the React Compiler diagnostics.
// They are worth having — four of the seven they flagged on arrival were
// real extra render passes and were fixed (use-online-status moved to
// `useSyncExternalStore`, ShortcutHelpModal now derives instead of
// resetting in an effect, DraftIndicator and use-languages-ready were
// guarded).
//
// Three remain, all genuinely syncing state FROM an external source:
// src/hooks/use-languages-ready.ts — i18next bundle readiness
// src/components/editor/PlaytestEditor.tsx — text mirror of a store number
// src/components/editor/StoreLinkEditor.tsx — compiler can't preserve a useMemo
//
// Each needs a real restructure, not a guard, so they are warnings rather
// than a reason to hold back the ESLint 10 upgrade or to delete the rule.
// Downgrade — do not remove: the signal is the point.
"react-hooks/set-state-in-effect": "warn",
"react-hooks/preserve-manual-memoization": "warn",
},
},
{
// Tests index into fixture arrays constantly, and `noUncheckedIndexedAccess`
// makes every one of those reads `T | undefined`. A `!` there asserts the
// fixture the test itself just built — the alternative is a guard clause per
// lookup that can only ever fail if the test is already broken. Production
// code keeps the rule.
files: ["tests/**/*.ts", "tests/**/*.tsx"],
rules: {
"@typescript-eslint/no-non-null-assertion": "off",
},
},
{
+64 -1
View File
@@ -3,7 +3,70 @@
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>YTDescGen</title>
<meta name="color-scheme" content="dark light" />
<meta name="theme-color" content="#0a0a0a" />
<title>YTDescGen — YouTube Title, Description & Tag Generator for Gameplay Channels</title>
<meta name="description" content="Generate YouTube titles, descriptions, and tags for Gameplay No Commentary channels — multilingual templates, profile presets, and a Tauri-based desktop build." />
<meta name="keywords" content="youtube, gameplay, no commentary, description generator, tags generator, video title, vietnamese, japanese, korean, spanish, chinese, multilingual, tauri, desktop" />
<meta name="author" content="SkullMute (poli0981)" />
<meta name="robots" content="index, follow" />
<meta name="generator" content="Vite + React" />
<link rel="canonical" href="https://poli0981.github.io/youtube-generator/" />
<link rel="icon" type="image/svg+xml" href="/youtube-generator/favicon.svg" />
<link rel="apple-touch-icon" href="/youtube-generator/apple-touch-icon.png" />
<link rel="manifest" href="/youtube-generator/manifest.webmanifest" />
<!-- OpenGraph -->
<meta property="og:type" content="website" />
<meta property="og:site_name" content="YTDescGen" />
<meta property="og:title" content="YTDescGen — YouTube Title, Description & Tag Generator" />
<meta property="og:description" content="Multilingual title, description, and tag generator for Gameplay No Commentary channels." />
<meta property="og:url" content="https://poli0981.github.io/youtube-generator/" />
<meta property="og:image" content="https://poli0981.github.io/youtube-generator/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:locale" content="en_US" />
<meta property="og:locale:alternate" content="vi_VN" />
<meta property="og:locale:alternate" content="ja_JP" />
<meta property="og:locale:alternate" content="es_ES" />
<meta property="og:locale:alternate" content="ko_KR" />
<meta property="og:locale:alternate" content="zh_CN" />
<!-- Twitter / X card -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@SkullMute0011" />
<meta name="twitter:creator" content="@SkullMute0011" />
<meta name="twitter:title" content="YTDescGen — YouTube Title, Description & Tag Generator" />
<meta name="twitter:description" content="Multilingual title, description, and tag generator for Gameplay No Commentary channels." />
<meta name="twitter:image" content="https://poli0981.github.io/youtube-generator/og-image.png" />
<!-- Structured data -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebApplication",
"name": "YTDescGen",
"alternateName": "YouTube Description Generator",
"url": "https://poli0981.github.io/youtube-generator/",
"applicationCategory": "MultimediaApplication",
"operatingSystem": "Web, Windows, macOS, Linux",
"description": "Generate YouTube titles, descriptions, and tags for Gameplay No Commentary channels — multilingual templates, profile presets, and a Tauri-based desktop build.",
"inLanguage": ["en", "vi", "ja", "es", "ko", "zh"],
"offers": {
"@type": "Offer",
"price": "0",
"priceCurrency": "USD"
},
"author": {
"@type": "Person",
"name": "SkullMute",
"url": "https://github.com/poli0981"
},
"license": "https://github.com/poli0981/youtube-generator/blob/main/LICENSE"
}
</script>
</head>
<body>
<div id="root"></div>
+14
View File
@@ -0,0 +1,14 @@
{
"$schema": "https://unpkg.com/knip@6/schema.json",
"entry": ["scripts/*.ts", "tests/**/*.test.ts"],
"project": ["src/**/*.{ts,tsx}", "scripts/**/*.ts", "tests/**/*.ts"],
"ignoreExportsUsedInFile": true,
"ignoreDependencies": [
"@tauri-apps/plugin-fs",
"@tauri-apps/plugin-shell",
"tailwindcss",
"@testing-library/jest-dom",
"@testing-library/react"
],
"ignoreBinaries": ["tauri"]
}
+2733 -2481
View File
File diff suppressed because it is too large. Load diff
+44 -35
View File
@@ -1,7 +1,8 @@
{
"name": "yt-desc-gen",
"version": "0.6.0",
"version": "0.37.0",
"private": true,
"license": "Apache-2.0",
"type": "module",
"scripts": {
"dev": "vite",
@@ -10,10 +11,14 @@
"test": "vitest",
"test:run": "vitest run",
"test:coverage": "vitest run --coverage",
"lint": "eslint src/",
"lint:fix": "eslint src/ --fix",
"lint": "eslint src/ tests/ scripts/",
"lint:fix": "eslint src/ tests/ scripts/ --fix",
"knip": "knip",
"typecheck": "tsc --noEmit",
"format": "prettier --write \"src/**/*.{ts,tsx,json,css}\"",
"typecheck:all": "tsc --noEmit -p tsconfig.check.json",
"format": "prettier --write \"{src,tests,scripts}/**/*.{ts,tsx,css}\"",
"format:check": "prettier --check \"{src,tests,scripts}/**/*.{ts,tsx,css}\"",
"check:version": "tsx scripts/check-version-sync.ts",
"validate:locales": "tsx scripts/validate-locales.ts",
"generate:locale": "tsx scripts/generate-locale-template.ts",
"tauri": "tauri",
@@ -21,39 +26,43 @@
"tauri:build": "tauri build"
},
"dependencies": {
"react": "^18.3.0",
"react-dom": "^18.3.0",
"react-router-dom": "^6.26.0",
"zustand": "^4.5.0",
"i18next": "^23.15.0",
"react-i18next": "^15.0.0",
"react-hot-toast": "^2.4.0",
"lucide-react": "^0.400.0",
"clsx": "^2.1.0",
"@tauri-apps/api": "^2.0.0",
"@tauri-apps/plugin-dialog": "^2.0.0",
"@tauri-apps/plugin-fs": "^2.0.0",
"@tauri-apps/plugin-opener": "^2.0.0",
"@tauri-apps/plugin-shell": "^2.0.0"
"@tauri-apps/api": "^2.11.1",
"@tauri-apps/plugin-dialog": "^2.7.2",
"@tauri-apps/plugin-fs": "^2.5.1",
"@tauri-apps/plugin-opener": "^2.5.4",
"@tauri-apps/plugin-shell": "^2.3.5",
"clsx": "^2.1.1",
"i18next": "^26.3.6",
"i18next-resources-to-backend": "^1.2.3",
"lucide-react": "^0.577.0",
"react": "^19.2.8",
"react-dom": "^19.2.8",
"react-hot-toast": "^2.6.0",
"react-i18next": "^17.0.11",
"react-router-dom": "^7.18.2",
"zustand": "^5.0.15"
},
"devDependencies": {
"@types/react": "^18.3.0",
"@types/react-dom": "^18.3.0",
"@vitejs/plugin-react": "^4.3.0",
"@eslint/js": "^10.0.1",
"@tailwindcss/postcss": "^4.3.3",
"@testing-library/jest-dom": "^7.0.1",
"@testing-library/react": "^16.3.2",
"@types/node": "^26.2.0",
"@types/react": "^19.2.18",
"@types/react-dom": "^19.2.4",
"@vitejs/plugin-react": "^6.0.5",
"autoprefixer": "^10.5.4",
"eslint": "^10.8.1",
"eslint-plugin-react-hooks": "^7.1.1",
"knip": "^6.32.2",
"postcss": "^8.5.26",
"prettier": "^3.9.6",
"prettier-plugin-tailwindcss": "^0.8.1",
"tailwindcss": "^4.3.3",
"tsx": "^4.23.12",
"typescript": "^5.5.0",
"vite": "^5.4.0",
"vitest": "^2.0.0",
"@testing-library/react": "^16.0.0",
"@testing-library/jest-dom": "^6.4.0",
"tailwindcss": "^3.4.0",
"postcss": "^8.4.0",
"autoprefixer": "^10.4.0",
"eslint": "^9.0.0",
"@eslint/js": "^9.0.0",
"typescript-eslint": "^8.0.0",
"eslint-plugin-react-hooks": "^5.0.0",
"prettier": "^3.3.0",
"prettier-plugin-tailwindcss": "^0.6.0",
"tsx": "^4.16.0"
"typescript-eslint": "^8.67.0",
"vite": "^8.2.1",
"vitest": "^4.1.10"
}
}
+2 -1
View File
@@ -1,6 +1,7 @@
export default {
plugins: {
tailwindcss: {},
// Tailwind 4 ships its PostCSS plugin as a separate package.
"@tailwindcss/postcss": {},
autoprefixer: {},
},
};
View File
Whitespace-only changes.
+5
View File
@@ -0,0 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
<rect width="64" height="64" rx="12" fill="#0a0a0a"/>
<rect x="14" y="14" width="36" height="36" rx="6" fill="none" stroke="#ec4899" stroke-width="3"/>
<path d="M22 22h20M22 30h20M22 38h12" stroke="#ec4899" stroke-width="3" stroke-linecap="round"/>
</svg>

After

Width:  |  Height:  |  Size: 335 B

+32
View File
@@ -0,0 +1,32 @@
{
"name": "YTDescGen",
"short_name": "YTDescGen",
"description": "YouTube title, description, and tag generator for Gameplay No Commentary channels.",
"start_url": "/youtube-generator/",
"scope": "/youtube-generator/",
"display": "standalone",
"background_color": "#0a0a0a",
"theme_color": "#0a0a0a",
"lang": "en",
"categories": ["productivity", "utilities", "multimedia"],
"icons": [
{
"src": "favicon.svg",
"sizes": "any",
"type": "image/svg+xml",
"purpose": "any"
},
{
"src": "icon-192.png",
"sizes": "192x192",
"type": "image/png",
"purpose": "any maskable"
},
{
"src": "icon-512.png",
"sizes": "512x512",
"type": "image/png",
"purpose": "any maskable"
}
]
}
+3
View File
@@ -0,0 +1,3 @@
User-agent: *
Allow: /
Sitemap: https://poli0981.github.io/youtube-generator/sitemap.xml
+8
View File
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://poli0981.github.io/youtube-generator/</loc>
<changefreq>weekly</changefreq>
<priority>1.0</priority>
</url>
</urlset>
+111
View File
@@ -0,0 +1,111 @@
/**
* Verify that every manifest carrying the app version agrees.
*
* A release bumps SIX places, and nothing but this script notices when one is
* missed. A stale `tauri.conf.json` ships an installer whose About screen and
* updater metadata disagree with the tag; a stale `Cargo.lock` self-entry makes
* the next `cargo build` rewrite the lockfile mid-release.
*
* Run via `npm run check:version`. Exits non-zero (and prints every mismatch,
* not just the first) so CI fails the PR rather than the release.
*/
import { readFileSync } from "fs";
import { resolve } from "path";
interface VersionSource {
/** Human-readable location, printed on mismatch. */
label: string;
/** Repo-relative path. */
file: string;
/** Pull the version out of the file's raw text. */
extract: (raw: string) => string | null;
}
/** Read `version` from a top-level JSON object. */
function jsonVersion(raw: string): string | null {
const parsed: unknown = JSON.parse(raw);
if (typeof parsed !== "object" || parsed === null) return null;
const version = (parsed as Record<string, unknown>).version;
return typeof version === "string" ? version : null;
}
const SOURCES: VersionSource[] = [
{
label: "package.json → version",
file: "package.json",
extract: jsonVersion,
},
{
label: "package-lock.json → version",
file: "package-lock.json",
extract: jsonVersion,
},
{
label: 'package-lock.json → packages[""].version',
file: "package-lock.json",
extract: (raw) => {
const parsed: unknown = JSON.parse(raw);
if (typeof parsed !== "object" || parsed === null) return null;
const packages = (parsed as Record<string, unknown>).packages;
if (typeof packages !== "object" || packages === null) return null;
const root = (packages as Record<string, unknown>)[""];
if (typeof root !== "object" || root === null) return null;
const version = (root as Record<string, unknown>).version;
return typeof version === "string" ? version : null;
},
},
{
label: "src-tauri/tauri.conf.json → version",
file: "src-tauri/tauri.conf.json",
extract: jsonVersion,
},
{
label: "src-tauri/Cargo.toml → [package] version",
file: "src-tauri/Cargo.toml",
// Anchor on the [package] table so a dependency's `version = "…"` in the
// same file can never be picked up instead.
extract: (raw) => /^\[package\][\s\S]*?^version\s*=\s*"([^"]+)"/m.exec(raw)?.[1] ?? null,
},
{
label: "src-tauri/Cargo.lock → yt-desc-gen entry",
file: "src-tauri/Cargo.lock",
extract: (raw) => /^name = "yt-desc-gen"\r?\nversion = "([^"]+)"/m.exec(raw)?.[1] ?? null,
},
];
function main(): void {
const found: { label: string; version: string | null }[] = SOURCES.map((source) => {
let raw: string;
try {
raw = readFileSync(resolve(source.file), "utf8");
} catch {
return { label: source.label, version: null };
}
try {
return { label: source.label, version: source.extract(raw) };
} catch {
return { label: source.label, version: null };
}
});
const missing = found.filter((entry) => entry.version === null);
const versions = [...new Set(found.map((entry) => entry.version).filter(Boolean))];
if (missing.length === 0 && versions.length === 1) {
console.log(`✓ All ${found.length} manifests agree on version ${versions[0]}`);
return;
}
console.error("✗ Version manifests are out of sync.\n");
for (const entry of found) {
const mark = entry.version === null ? "?" : entry.version === versions[0] ? " " : "!";
console.error(` ${mark} ${entry.version ?? "<not found>"} ${entry.label}`);
}
console.error(
"\nBump every manifest to the same version before tagging. `npm version --no-git-tag-version <v>`",
);
console.error("covers package.json + package-lock.json; the three Rust/Tauri files are manual.");
process.exit(1);
}
main();
+133
View File
@@ -0,0 +1,133 @@
/**
* Scaffold a new locale directory from the English source.
*
* `package.json` has advertised `npm run generate:locale` since v0.1, and
* `docs/I18N.md` step 1 tells contributors to run it — but the script was never
* committed, so the documented first step of adding a language failed outright.
* This is that script.
*
* Usage:
* npm run generate:locale -- --lang pt-BR # empty values to translate
* npm run generate:locale -- --lang id --copy-english # pre-fill with EN text
* npm run generate:locale -- --lang id --force # overwrite an existing dir
*
* Output mirrors `src/i18n/locales/en/{ui,templates}.json` key-for-key, so
* `npm run validate:locales` passes the moment the files are written (it checks
* key parity, not whether the values were actually translated).
*
* Registering the locale in code is NOT done here — see the checklist printed
* on success, and docs/I18N.md.
*/
import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
import { join, resolve } from "path";
const LOCALES_DIR = resolve("src/i18n/locales");
const SOURCE_LOCALE = "en";
const NAMESPACES = ["ui", "templates"] as const;
/** BCP-47-ish: `pt`, `pt-BR`, `zh-Hant`. Keeps a typo from creating a junk dir. */
const LANG_PATTERN = /^[a-z]{2,3}(-[A-Za-z]{2,8})*$/;
interface Options {
lang: string;
copyEnglish: boolean;
force: boolean;
}
function parseArgs(argv: string[]): Options {
let lang = "";
let copyEnglish = false;
let force = false;
for (let i = 0; i < argv.length; i++) {
const arg = argv[i];
if (arg === "--lang" || arg === "-l") {
lang = argv[++i] ?? "";
} else if (arg?.startsWith("--lang=")) {
lang = arg.slice("--lang=".length);
} else if (arg === "--copy-english") {
copyEnglish = true;
} else if (arg === "--force") {
force = true;
}
}
if (!lang) {
console.error("Missing --lang.\n\n npm run generate:locale -- --lang pt-BR\n");
process.exit(1);
}
if (!LANG_PATTERN.test(lang)) {
console.error(`Invalid language code "${lang}". Expected e.g. "id", "pt-BR", "zh-Hant".\n`);
process.exit(1);
}
return { lang, copyEnglish, force };
}
/**
* Rebuild the tree with every leaf replaced by `""`, preserving key order so
* the generated file diffs cleanly against the English source.
*/
function blankLeaves(value: unknown): unknown {
if (Array.isArray(value)) return value.map(blankLeaves);
if (typeof value === "object" && value !== null) {
const out: Record<string, unknown> = {};
for (const [key, child] of Object.entries(value as Record<string, unknown>)) {
out[key] = blankLeaves(child);
}
return out;
}
return "";
}
function countLeaves(value: unknown): number {
if (Array.isArray(value)) return value.reduce<number>((n, v) => n + countLeaves(v), 0);
if (typeof value === "object" && value !== null) {
return Object.values(value as Record<string, unknown>).reduce<number>(
(n, v) => n + countLeaves(v),
0,
);
}
return 1;
}
function main(): void {
const { lang, copyEnglish, force } = parseArgs(process.argv.slice(2));
const targetDir = join(LOCALES_DIR, lang);
if (existsSync(targetDir) && !force) {
console.error(`✗ ${targetDir} already exists. Pass --force to overwrite.\n`);
process.exit(1);
}
mkdirSync(targetDir, { recursive: true });
let total = 0;
for (const ns of NAMESPACES) {
const sourcePath = join(LOCALES_DIR, SOURCE_LOCALE, `${ns}.json`);
if (!existsSync(sourcePath)) {
console.error(`✗ Source locale missing: ${sourcePath}`);
process.exit(1);
}
const source: unknown = JSON.parse(readFileSync(sourcePath, "utf-8"));
const output = copyEnglish ? source : blankLeaves(source);
const outPath = join(targetDir, `${ns}.json`);
// Two-space indent + trailing newline matches the existing locale files.
writeFileSync(outPath, `${JSON.stringify(output, null, 2)}\n`, "utf-8");
const leaves = countLeaves(source);
total += leaves;
console.log(
`✓ ${lang}/${ns}.json — ${leaves} keys${copyEnglish ? " (English text)" : " (empty)"}`,
);
}
console.log(`\n${total} strings to translate. Remaining steps to register "${lang}":
1. src/i18n/index.ts — add to SUPPORTED_LANGUAGES (flag + nativeName)
2. src/engine/types.ts — add to the SupportedLanguage union
3. src/store/settings-heal.ts — add to detectBrowserLanguage's supported list
4. src/engine/tag-generator.ts— add a MULTILINGUAL_TAGS entry (TS enforces this)
5. npm run validate:locales — must pass before committing
See docs/I18N.md for the full checklist.`);
}
main();
+1 -3
View File
@@ -74,9 +74,7 @@ function validate(): void {
console.log(`✓ ${locale}/${filename} — ${actualKeys.length}/${expectedKeys.length} keys`);
} else {
hasErrors = true;
console.error(
`✗ ${locale}/${filename} — ${actualKeys.length}/${expectedKeys.length} keys`,
);
console.error(`✗ ${locale}/${filename} — ${actualKeys.length}/${expectedKeys.length} keys`);
if (missing.length > 0) {
console.error(` Missing: ${missing.join(", ")}`);
}
+226 -109
View File
@@ -307,6 +307,15 @@ dependencies = [
"alloc-stdlib",
]
[[package]]
name = "bs58"
version = "0.5.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bf88ba1141d185c399bee5288d850d63b8369520c1eafc32a0430b5b6c287bf4"
dependencies = [
"tinyvec",
]
[[package]]
name = "bumpalo"
version = "3.20.2"
@@ -616,14 +625,20 @@ dependencies = [
[[package]]
name = "ctor"
version = "0.2.9"
version = "0.8.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "32a2785755761f3ddc1492979ce1e48d2c00d09311c39e4466429188f3dd6501"
checksum = "352d39c2f7bef1d6ad73db6f5160efcaed66d94ef8c6c573a8410c00bf909a98"
dependencies = [
"quote",
"syn 2.0.117",
"ctor-proc-macro",
"dtor",
]
[[package]]
name = "ctor-proc-macro"
version = "0.0.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "52560adf09603e58c9a7ee1fe1dcb95a16927b17c127f0ac02d6e768a0e25bc1"
[[package]]
name = "darling"
version = "0.23.0"
@@ -658,6 +673,17 @@ dependencies = [
"syn 2.0.117",
]
[[package]]
name = "dbus"
version = "0.9.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b942602992bb7acfd1f51c49811c58a610ef9181b6e66f3e519d79b540a3bf73"
dependencies = [
"libc",
"libdbus-sys",
"windows-sys 0.61.2",
]
[[package]]
name = "deranged"
version = "0.5.8"
@@ -818,6 +844,21 @@ dependencies = [
"dtoa",
]
[[package]]
name = "dtor"
version = "0.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f1057d6c64987086ff8ed0fd3fbf377a6b7d205cc7715868cd401705f715cbe4"
dependencies = [
"dtor-proc-macro",
]
[[package]]
name = "dtor-proc-macro"
version = "0.0.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f678cf4a922c215c63e0de95eb1ff08a958a81d47e485cf9da1e27bf6305cfa5"
[[package]]
name = "dunce"
version = "1.0.5"
@@ -1597,7 +1638,7 @@ dependencies = [
"js-sys",
"log",
"wasm-bindgen",
"windows-core 0.62.2",
"windows-core",
]
[[package]]
@@ -1616,7 +1657,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3e795dff5605e0f04bff85ca41b51a96b83e80b281e96231bcaaf1ac35103371"
dependencies = [
"byteorder",
"png",
"png 0.17.16",
]
[[package]]
@@ -1967,6 +2008,15 @@ version = "0.2.184"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "48f5d2a454e16a5ea0f4ced81bd44e4cfc7bd3a507b61887c99fd3538b28e4af"
[[package]]
name = "libdbus-sys"
version = "0.2.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "328c4789d42200f1eeec05bd86c9c13c7f091d2ba9a6ea35acdf51f31bc0f043"
dependencies = [
"pkg-config",
]
[[package]]
name = "libloading"
version = "0.7.4"
@@ -2105,9 +2155,9 @@ dependencies = [
[[package]]
name = "muda"
version = "0.17.2"
version = "0.19.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7c9fec5a4e89860383d778d10563a605838f8f0b2f9303868937e5ff32e86177"
checksum = "0ae8844f63b5b118e334e205585b8c5c17b984121dbdb179d44aeb087ffad3cb"
dependencies = [
"crossbeam-channel",
"dpi",
@@ -2118,10 +2168,10 @@ dependencies = [
"objc2-core-foundation",
"objc2-foundation",
"once_cell",
"png",
"png 0.18.1",
"serde",
"thiserror 2.0.18",
"windows-sys 0.60.2",
"windows-sys 0.61.2",
]
[[package]]
@@ -2139,12 +2189,6 @@ dependencies = [
"thiserror 1.0.69",
]
[[package]]
name = "ndk-context"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "27b02d87554356db9e9a873add8782d4ea6e3e58ea071a9adb9a2e8ddb884a8b"
[[package]]
name = "ndk-sys"
version = "0.6.0+11769913"
@@ -2226,6 +2270,27 @@ dependencies = [
"objc2-foundation",
]
[[package]]
name = "objc2-cloud-kit"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "73ad74d880bb43877038da939b7427bba67e9dd42004a18b809ba7d87cee241c"
dependencies = [
"bitflags 2.11.0",
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-data"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0b402a653efbb5e82ce4df10683b6b28027616a2715e90009947d50b8dd298fa"
dependencies = [
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-foundation"
version = "0.3.2"
@@ -2250,6 +2315,38 @@ dependencies = [
"objc2-io-surface",
]
[[package]]
name = "objc2-core-image"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e5d563b38d2b97209f8e861173de434bd0214cf020e3423a52624cd1d989f006"
dependencies = [
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-location"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ca347214e24bc973fc025fd0d36ebb179ff30536ed1f80252706db19ee452009"
dependencies = [
"objc2",
"objc2-foundation",
]
[[package]]
name = "objc2-core-text"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0cde0dfb48d25d2b4862161a4d5fcc0e3c24367869ad306b0c9ec0073bfed92d"
dependencies = [
"bitflags 2.11.0",
"objc2",
"objc2-core-foundation",
"objc2-core-graphics",
]
[[package]]
name = "objc2-encode"
version = "4.1.0"
@@ -2308,8 +2405,27 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d87d638e33c06f577498cbcc50491496a3ed4246998a7fbba7ccb98b1e7eab22"
dependencies = [
"bitflags 2.11.0",
"block2",
"objc2",
"objc2-cloud-kit",
"objc2-core-data",
"objc2-core-foundation",
"objc2-core-graphics",
"objc2-core-image",
"objc2-core-location",
"objc2-core-text",
"objc2-foundation",
"objc2-quartz-core",
"objc2-user-notifications",
]
[[package]]
name = "objc2-user-notifications"
version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9df9128cbbfef73cda168416ccf7f837b62737d748333bfe9ab71c245d76613e"
dependencies = [
"objc2",
"objc2-foundation",
]
@@ -2463,7 +2579,6 @@ version = "0.11.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fd6780a80ae0c52cc120a26a1a42c1ae51b247a253e4e06113d23d2c2edd078"
dependencies = [
"phf_macros 0.11.3",
"phf_shared 0.11.3",
]
@@ -2525,7 +2640,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5d5285893bb5eb82e6aaf5d59ee909a06a16737a8970984dd7746ba9283498d6"
dependencies = [
"phf_shared 0.10.0",
"rand 0.8.5",
"rand 0.8.6",
]
[[package]]
@@ -2535,7 +2650,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d"
dependencies = [
"phf_shared 0.11.3",
"rand 0.8.5",
"rand 0.8.6",
]
[[package]]
@@ -2562,19 +2677,6 @@ dependencies = [
"syn 1.0.109",
]
[[package]]
name = "phf_macros"
version = "0.11.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f84ac04429c13a7ff43785d75ad27569f2951ce0ffd30a3321230db2fc727216"
dependencies = [
"phf_generator 0.11.3",
"phf_shared 0.11.3",
"proc-macro2",
"quote",
"syn 2.0.117",
]
[[package]]
name = "phf_macros"
version = "0.13.1"
@@ -2673,6 +2775,19 @@ dependencies = [
"miniz_oxide",
]
[[package]]
name = "png"
version = "0.18.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "60769b8b31b2a9f263dae2776c37b1b28ae246943cf719eb6946a1db05128a61"
dependencies = [
"bitflags 2.11.0",
"crc32fast",
"fdeflate",
"flate2",
"miniz_oxide",
]
[[package]]
name = "polling"
version = "3.11.0"
@@ -2841,9 +2956,9 @@ dependencies = [
[[package]]
name = "rand"
version = "0.8.5"
version = "0.8.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"
dependencies = [
"libc",
"rand_chacha 0.3.1",
@@ -3283,11 +3398,12 @@ dependencies = [
[[package]]
name = "serde_with"
version = "3.18.0"
version = "3.21.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "dd5414fad8e6907dbdd5bc441a50ae8d6e26151a03b1de04d89a5576de61d01f"
checksum = "76a5c54c7310e7b8b9577c286d7e399ddd876c3e12b3ed917a8aabc4b96e9e8c"
dependencies = [
"base64 0.22.1",
"bs58",
"chrono",
"hex",
"indexmap 1.9.3",
@@ -3302,9 +3418,9 @@ dependencies = [
[[package]]
name = "serde_with_macros"
version = "3.18.0"
version = "3.21.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d3db8978e608f1fe7357e211969fd9abdcae80bac1ba7a3369bb7eb6b404eb65"
checksum = "84d57bc0c8b9a17920c178daa6bb924850d54a9c97ab45194bb8c17ad66bb660"
dependencies = [
"darling",
"proc-macro2",
@@ -3629,15 +3745,16 @@ dependencies = [
[[package]]
name = "tao"
version = "0.34.8"
version = "0.35.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9103edf55f2da3c82aea4c7fab7c4241032bfeea0e71fa557d98e00e7ce7cc20"
checksum = "a33f7f9e486ade65fcf1e45c440f9236c904f5c1002cdc7fc6ae582777345ce4"
dependencies = [
"bitflags 2.11.0",
"block2",
"core-foundation",
"core-graphics",
"crossbeam-channel",
"dbus",
"dispatch2",
"dlopen2",
"dpi",
@@ -3648,19 +3765,20 @@ dependencies = [
"libc",
"log",
"ndk",
"ndk-context",
"ndk-sys",
"objc2",
"objc2-app-kit",
"objc2-foundation",
"objc2-ui-kit",
"once_cell",
"parking_lot",
"percent-encoding",
"raw-window-handle",
"tao-macros",
"unicode-segmentation",
"url",
"windows",
"windows-core 0.61.2",
"windows-core",
"windows-version",
"x11-dl",
]
@@ -3684,9 +3802,9 @@ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
[[package]]
name = "tauri"
version = "2.10.3"
version = "2.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "da77cc00fb9028caf5b5d4650f75e31f1ef3693459dfca7f7e506d1ecef0ba2d"
checksum = "b93bd86d231f0a8138f11a02a584769fe4b703dc36ae133d783228dbc4801405"
dependencies = [
"anyhow",
"bytes",
@@ -3735,9 +3853,9 @@ dependencies = [
[[package]]
name = "tauri-build"
version = "2.5.6"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4bbc990d1dbf57a8e1c7fa2327f2a614d8b757805603c1b9ba5c81bade09fd4d"
checksum = "3a318b234cc2dea65f575467bafcfb76286bce228ebc3778e337d61d03213007"
dependencies = [
"anyhow",
"cargo_toml",
@@ -3751,22 +3869,21 @@ dependencies = [
"serde_json",
"tauri-utils",
"tauri-winres",
"toml 0.9.12+spec-1.1.0",
"walkdir",
]
[[package]]
name = "tauri-codegen"
version = "2.5.5"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d4a24476afd977c5d5d169f72425868613d82747916dd29e0a357c84c4bd6d29"
checksum = "6bd11644962add2549a60b7e7c6800f17d7020156e02f516021d8103e80cc528"
dependencies = [
"base64 0.22.1",
"brotli",
"ico",
"json-patch",
"plist",
"png",
"png 0.17.16",
"proc-macro2",
"quote",
"semver",
@@ -3784,9 +3901,9 @@ dependencies = [
[[package]]
name = "tauri-macros"
version = "2.5.5"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d39b349a98dadaffebb73f0a40dcd1f23c999211e5a2e744403db384d0c33de7"
checksum = "fed9d3742a37a355d2e47c9af924e9fbc112abb76f9835d35d4780e318419502"
dependencies = [
"heck 0.5.0",
"proc-macro2",
@@ -3899,10 +4016,25 @@ dependencies = [
]
[[package]]
name = "tauri-runtime"
version = "2.10.1"
name = "tauri-plugin-single-instance"
version = "2.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2826d79a3297ed08cd6ea7f412644ef58e32969504bc4fbd8d7dbeabc4445ea2"
checksum = "5c8f29386f5e9fdc699182388a33ee80a56de436d91b67459e86afef426282af"
dependencies = [
"serde",
"serde_json",
"tauri",
"thiserror 2.0.18",
"tracing",
"windows-sys 0.60.2",
"zbus",
]
[[package]]
name = "tauri-runtime"
version = "2.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8fef478ba1d2ac21c2d528740b24d0cb315e1e8b1111aae53fafac34804371fc"
dependencies = [
"cookie",
"dpi",
@@ -3925,9 +4057,9 @@ dependencies = [
[[package]]
name = "tauri-runtime-wry"
version = "2.10.1"
version = "2.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e11ea2e6f801d275fdd890d6c9603736012742a1c33b96d0db788c9cdebf7f9e"
checksum = "a3989df2ae1c476404fe0a2e8ffc4cfbde97e51efd613c2bb5355fbc9ab52cf0"
dependencies = [
"gtk",
"http",
@@ -3951,14 +4083,15 @@ dependencies = [
[[package]]
name = "tauri-utils"
version = "2.8.3"
version = "2.9.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "219a1f983a2af3653f75b5747f76733b0da7ff03069c7a41901a5eb3ace4557d"
checksum = "d57200389a2f82b4b0a40ae29ca19b6978116e8f4d4e974c3234ce40c0ffbdec"
dependencies = [
"anyhow",
"brotli",
"cargo_metadata",
"ctor",
"dom_query",
"dunce",
"glob",
"html5ever 0.29.1",
@@ -3968,7 +4101,8 @@ dependencies = [
"kuchikiki",
"log",
"memchr",
"phf 0.11.3",
"phf 0.13.1",
"plist",
"proc-macro2",
"quote",
"regex",
@@ -4113,6 +4247,21 @@ dependencies = [
"zerovec",
]
[[package]]
name = "tinyvec"
version = "1.12.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bb4ebadaa0af04fab11ae01eb5f9fdb5f9c5b875506e210e71c07873528baa7f"
dependencies = [
"tinyvec_macros",
]
[[package]]
name = "tinyvec_macros"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
[[package]]
name = "tokio"
version = "1.51.0"
@@ -4323,9 +4472,9 @@ dependencies = [
[[package]]
name = "tray-icon"
version = "0.21.3"
version = "0.23.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a5e85aa143ceb072062fc4d6356c1b520a51d636e7bc8e77ec94be3608e5e80c"
checksum = "15edbb0d80583e85ee8df283410038e17314df5cba30da2087a54a85216c0773"
dependencies = [
"crossbeam-channel",
"dirs",
@@ -4337,10 +4486,10 @@ dependencies = [
"objc2-core-graphics",
"objc2-foundation",
"once_cell",
"png",
"png 0.18.1",
"serde",
"thiserror 2.0.18",
"windows-sys 0.60.2",
"windows-sys 0.61.2",
]
[[package]]
@@ -4738,7 +4887,7 @@ dependencies = [
"webview2-com-macros",
"webview2-com-sys",
"windows",
"windows-core 0.61.2",
"windows-core",
"windows-implement",
"windows-interface",
]
@@ -4762,7 +4911,7 @@ checksum = "381336cfffd772377d291702245447a5251a2ffa5bad679c99e61bc48bacbf9c"
dependencies = [
"thiserror 2.0.18",
"windows",
"windows-core 0.61.2",
"windows-core",
]
[[package]]
@@ -4818,7 +4967,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9babd3a767a4c1aef6900409f85f5d53ce2544ccdfaa86dad48c91782c6d6893"
dependencies = [
"windows-collections",
"windows-core 0.61.2",
"windows-core",
"windows-future",
"windows-link 0.1.3",
"windows-numerics",
@@ -4830,7 +4979,7 @@ version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3beeceb5e5cfd9eb1d76b381630e82c4241ccd0d27f1a39ed41b2760b255c5e8"
dependencies = [
"windows-core 0.61.2",
"windows-core",
]
[[package]]
@@ -4842,21 +4991,8 @@ dependencies = [
"windows-implement",
"windows-interface",
"windows-link 0.1.3",
"windows-result 0.3.4",
"windows-strings 0.4.2",
]
[[package]]
name = "windows-core"
version = "0.62.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
dependencies = [
"windows-implement",
"windows-interface",
"windows-link 0.2.1",
"windows-result 0.4.1",
"windows-strings 0.5.1",
"windows-result",
"windows-strings",
]
[[package]]
@@ -4865,7 +5001,7 @@ version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "fc6a41e98427b19fe4b73c550f060b59fa592d7d686537eebf9385621bfbad8e"
dependencies = [
"windows-core 0.61.2",
"windows-core",
"windows-link 0.1.3",
"windows-threading",
]
@@ -4910,7 +5046,7 @@ version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9150af68066c4c5c07ddc0ce30421554771e528bde427614c61038bc2c92c2b1"
dependencies = [
"windows-core 0.61.2",
"windows-core",
"windows-link 0.1.3",
]
@@ -4923,15 +5059,6 @@ dependencies = [
"windows-link 0.1.3",
]
[[package]]
name = "windows-result"
version = "0.4.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
dependencies = [
"windows-link 0.2.1",
]
[[package]]
name = "windows-strings"
version = "0.4.2"
@@ -4941,15 +5068,6 @@ dependencies = [
"windows-link 0.1.3",
]
[[package]]
name = "windows-strings"
version = "0.5.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
dependencies = [
"windows-link 0.2.1",
]
[[package]]
name = "windows-sys"
version = "0.45.0"
@@ -5323,9 +5441,9 @@ checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4"
[[package]]
name = "wry"
version = "0.54.4"
version = "0.55.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e5a8135d8676225e5744de000d4dff5a082501bf7db6a1c1495034f8c314edbc"
checksum = "186f9871daa55fd9c016578b810d149de58367113db7fb72b462d2323ce19514"
dependencies = [
"base64 0.22.1",
"block2",
@@ -5360,7 +5478,7 @@ dependencies = [
"webkit2gtk-sys",
"webview2-com",
"windows",
"windows-core 0.61.2",
"windows-core",
"windows-version",
"x11-dl",
]
@@ -5411,16 +5529,15 @@ dependencies = [
[[package]]
name = "yt-desc-gen"
version = "0.6.0"
version = "0.37.0"
dependencies = [
"serde",
"serde_json",
"tauri",
"tauri-build",
"tauri-plugin-dialog",
"tauri-plugin-fs",
"tauri-plugin-opener",
"tauri-plugin-shell",
"tauri-plugin-single-instance",
]
[[package]]
+8 -3
View File
@@ -1,9 +1,10 @@
[package]
name = "yt-desc-gen"
version = "0.6.0"
version = "0.37.0"
description = "YouTube Gameplay Description Generator"
authors = ["poli0981"]
edition = "2021"
license = "Apache-2.0"
[lib]
name = "yt_desc_gen_lib"
@@ -18,5 +19,9 @@ tauri-plugin-dialog = "2"
tauri-plugin-fs = "2"
tauri-plugin-opener = "2"
tauri-plugin-shell = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
# Desktop-only: single-instance is unsupported on mobile and must not be
# compiled into the Android/iOS library. cfg(not(any(android, ios))) is the
# canonical Tauri "desktop" target table.
[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]
tauri-plugin-single-instance = "2"
+1 -9
View File
@@ -11,14 +11,6 @@
"fs:allow-read-text-file",
"fs:allow-write-text-file",
"shell:default",
"opener:default",
{
"identifier": "opener:allow-open-path",
"allow": [{ "path": "$APPDATA" }, { "path": "$APPDATA/**" }]
},
{
"identifier": "opener:allow-reveal-item-in-dir",
"allow": [{ "path": "$APPDATA" }, { "path": "$APPDATA/**" }]
}
"opener:default"
]
}
+12
View File
@@ -0,0 +1,12 @@
# EditorConfig is awesome: https://EditorConfig.org
# top-most EditorConfig file
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = false
insert_final_newline = false
+19
View File
@@ -0,0 +1,19 @@
*.iml
.gradle
/local.properties
/.idea/caches
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
/.idea/navEditor.xml
/.idea/assetWizardSettings.xml
.DS_Store
build
/captures
.externalNativeBuild
.cxx
local.properties
key.properties
/.tauri
/tauri.settings.gradle
+6
View File
@@ -0,0 +1,6 @@
/src/main/**/generated
/src/main/jniLibs/**/*.so
/src/main/assets/tauri.conf.json
/tauri.build.gradle.kts
/proguard-tauri.pro
/tauri.properties
@@ -0,0 +1,92 @@
import java.util.Properties
plugins {
id("com.android.application")
id("org.jetbrains.kotlin.android")
id("rust")
}
val tauriProperties = Properties().apply {
val propFile = file("tauri.properties")
if (propFile.exists()) {
propFile.inputStream().use { load(it) }
}
}
// Release signing. `keystore.properties` is gitignored and created out-of-band
// (locally by the maintainer, or written from CI secrets). When it is absent
// the release build is left unsigned instead of failing, so debug builds and
// contributor checkouts without a keystore still work.
val keystorePropertiesFile = rootProject.file("keystore.properties")
val keystoreProperties = Properties().apply {
if (keystorePropertiesFile.exists()) {
keystorePropertiesFile.inputStream().use { load(it) }
}
}
android {
compileSdk = 36
namespace = "com.skullmute.ytdescgen"
defaultConfig {
manifestPlaceholders["usesCleartextTraffic"] = "false"
applicationId = "com.skullmute.ytdescgen"
minSdk = 30
targetSdk = 36
versionCode = tauriProperties.getProperty("tauri.android.versionCode", "1").toInt()
versionName = tauriProperties.getProperty("tauri.android.versionName", "1.0")
}
signingConfigs {
create("release") {
if (keystorePropertiesFile.exists()) {
keyAlias = keystoreProperties["keyAlias"] as String
keyPassword = keystoreProperties["keyPassword"] as String
storeFile = file(keystoreProperties["storeFile"] as String)
storePassword = keystoreProperties["storePassword"] as String
}
}
}
buildTypes {
getByName("debug") {
manifestPlaceholders["usesCleartextTraffic"] = "true"
isDebuggable = true
isJniDebuggable = true
isMinifyEnabled = false
packaging { jniLibs.keepDebugSymbols.add("*/arm64-v8a/*.so")
jniLibs.keepDebugSymbols.add("*/armeabi-v7a/*.so")
jniLibs.keepDebugSymbols.add("*/x86/*.so")
jniLibs.keepDebugSymbols.add("*/x86_64/*.so")
}
}
getByName("release") {
isMinifyEnabled = true
proguardFiles(
*fileTree(".") { include("**/*.pro") }
.plus(getDefaultProguardFile("proguard-android-optimize.txt"))
.toList().toTypedArray()
)
signingConfig = signingConfigs.getByName("release")
}
}
kotlinOptions {
jvmTarget = "1.8"
}
buildFeatures {
buildConfig = true
}
}
rust {
rootDirRel = "../../../"
}
dependencies {
implementation("androidx.webkit:webkit:1.14.0")
implementation("androidx.appcompat:appcompat:1.7.1")
implementation("androidx.activity:activity-ktx:1.10.1")
implementation("com.google.android.material:material:1.12.0")
testImplementation("junit:junit:4.13.2")
androidTestImplementation("androidx.test.ext:junit:1.1.4")
androidTestImplementation("androidx.test.espresso:espresso-core:3.5.0")
}
apply(from = "tauri.build.gradle.kts")
+21
View File
@@ -0,0 +1,21 @@
# Add project specific ProGuard rules here.
# You can control the set of applied configuration files using the
# proguardFiles setting in build.gradle.
#
# For more details, see
# http://developer.android.com/guide/developing/tools/proguard.html
# If your project uses WebView with JS, uncomment the following
# and specify the fully qualified class name to the JavaScript interface
# class:
#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
# public *;
#}
# Uncomment this to preserve the line number information for
# debugging stack traces.
#-keepattributes SourceFile,LineNumberTable
# If you keep the line number information, uncomment this to
# hide the original source file name.
#-renamesourcefileattribute SourceFile
@@ -0,0 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.INTERNET" />
<!-- AndroidTV support -->
<uses-feature android:name="android.software.leanback" android:required="false" />
<application
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:theme="@style/Theme.yt_desc_gen"
android:usesCleartextTraffic="${usesCleartextTraffic}">
<activity
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode"
android:launchMode="singleTask"
android:label="@string/main_activity_title"
android:name=".MainActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
<!-- AndroidTV support -->
<category android:name="android.intent.category.LEANBACK_LAUNCHER" />
</intent-filter>
</activity>
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths" />
</provider>
</application>
</manifest>
@@ -0,0 +1,11 @@
package com.skullmute.ytdescgen
import android.os.Bundle
import androidx.activity.enableEdgeToEdge
class MainActivity : TauriActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
}
}
@@ -0,0 +1,30 @@
<vector xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:aapt="http://schemas.android.com/aapt"
android:width="108dp"
android:height="108dp"
android:viewportWidth="108"
android:viewportHeight="108">
<path android:pathData="M31,63.928c0,0 6.4,-11 12.1,-13.1c7.2,-2.6 26,-1.4 26,-1.4l38.1,38.1L107,108.928l-32,-1L31,63.928z">
<aapt:attr name="android:fillColor">
<gradient
android:endX="85.84757"
android:endY="92.4963"
android:startX="42.9492"
android:startY="49.59793"
android:type="linear">
<item
android:color="#44000000"
android:offset="0.0" />
<item
android:color="#00000000"
android:offset="1.0" />
</gradient>
</aapt:attr>
</path>
<path
android:fillColor="#FFFFFF"
android:fillType="nonZero"
android:pathData="M65.3,45.828l3.8,-6.6c0.2,-0.4 0.1,-0.9 -0.3,-1.1c-0.4,-0.2 -0.9,-0.1 -1.1,0.3l-3.9,6.7c-6.3,-2.8 -13.4,-2.8 -19.7,0l-3.9,-6.7c-0.2,-0.4 -0.7,-0.5 -1.1,-0.3C38.8,38.328 38.7,38.828 38.9,39.228l3.8,6.6C36.2,49.428 31.7,56.028 31,63.928h46C76.3,56.028 71.8,49.428 65.3,45.828zM43.4,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2c-0.3,-0.7 -0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C45.3,56.528 44.5,57.328 43.4,57.328L43.4,57.328zM64.6,57.328c-0.8,0 -1.5,-0.5 -1.8,-1.2s-0.1,-1.5 0.4,-2.1c0.5,-0.5 1.4,-0.7 2.1,-0.4c0.7,0.3 1.2,1 1.2,1.8C66.5,56.528 65.6,57.328 64.6,57.328L64.6,57.328z"
android:strokeWidth="1"
android:strokeColor="#00000000" />
</vector>
@@ -0,0 +1,170 @@
<?xml version="1.0" encoding="utf-8"?>
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="108dp"
android:height="108dp"
android:viewportWidth="108"
android:viewportHeight="108">
<path
android:fillColor="#3DDC84"
android:pathData="M0,0h108v108h-108z" />
<path
android:fillColor="#00000000"
android:pathData="M9,0L9,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,0L19,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M29,0L29,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M39,0L39,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M49,0L49,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M59,0L59,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M69,0L69,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M79,0L79,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M89,0L89,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M99,0L99,108"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,9L108,9"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,19L108,19"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,29L108,29"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,39L108,39"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,49L108,49"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,59L108,59"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,69L108,69"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,79L108,79"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,89L108,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M0,99L108,99"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,29L89,29"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,39L89,39"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,49L89,49"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,59L89,59"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,69L89,69"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M19,79L89,79"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M29,19L29,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M39,19L39,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M49,19L49,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M59,19L59,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M69,19L69,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
<path
android:fillColor="#00000000"
android:pathData="M79,19L79,89"
android:strokeWidth="0.8"
android:strokeColor="#33FFFFFF" />
</vector>
@@ -0,0 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>
Binary file not shown.

After

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

@@ -0,0 +1,6 @@
<resources xmlns:tools="http://schemas.android.com/tools">
<!-- Base application theme. -->
<style name="Theme.yt_desc_gen" parent="Theme.MaterialComponents.DayNight.NoActionBar">
<!-- Customize your theme here. -->
</style>
</resources>
@@ -0,0 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<color name="purple_200">#FFBB86FC</color>
<color name="purple_500">#FF6200EE</color>
<color name="purple_700">#FF3700B3</color>
<color name="teal_200">#FF03DAC5</color>
<color name="teal_700">#FF018786</color>
<color name="black">#FF000000</color>
<color name="white">#FFFFFFFF</color>
</resources>
@@ -0,0 +1,4 @@
<resources>
<string name="app_name">YTDescGen</string>
<string name="main_activity_title">YTDescGen</string>
</resources>
@@ -0,0 +1,6 @@
<resources xmlns:tools="http://schemas.android.com/tools">
<!-- Base application theme. -->
<style name="Theme.yt_desc_gen" parent="Theme.MaterialComponents.DayNight.NoActionBar">
<!-- Customize your theme here. -->
</style>
</resources>
@@ -0,0 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<external-path name="my_images" path="." />
<cache-path name="my_cache_images" path="." />
</paths>
+22
View File
@@ -0,0 +1,22 @@
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath("com.android.tools.build:gradle:8.11.0")
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.25")
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
tasks.register("clean").configure {
delete("build")
}
@@ -0,0 +1,23 @@
plugins {
`kotlin-dsl`
}
gradlePlugin {
plugins {
create("pluginsForCoolKids") {
id = "rust"
implementationClass = "RustPlugin"
}
}
}
repositories {
google()
mavenCentral()
}
dependencies {
compileOnly(gradleApi())
implementation("com.android.tools.build:gradle:8.11.0")
}
@@ -0,0 +1,68 @@
import java.io.File
import org.apache.tools.ant.taskdefs.condition.Os
import org.gradle.api.DefaultTask
import org.gradle.api.GradleException
import org.gradle.api.logging.LogLevel
import org.gradle.api.tasks.Input
import org.gradle.api.tasks.TaskAction
open class BuildTask : DefaultTask() {
@Input
var rootDirRel: String? = null
@Input
var target: String? = null
@Input
var release: Boolean? = null
@TaskAction
fun assemble() {
val executable = """cargo""";
try {
runTauriCli(executable)
} catch (e: Exception) {
if (Os.isFamily(Os.FAMILY_WINDOWS)) {
// Try different Windows-specific extensions
val fallbacks = listOf(
"$executable.exe",
"$executable.cmd",
"$executable.bat",
)
var lastException: Exception = e
for (fallback in fallbacks) {
try {
runTauriCli(fallback)
return
} catch (fallbackException: Exception) {
lastException = fallbackException
}
}
throw lastException
} else {
throw e;
}
}
}
fun runTauriCli(executable: String) {
val rootDirRel = rootDirRel ?: throw GradleException("rootDirRel cannot be null")
val target = target ?: throw GradleException("target cannot be null")
val release = release ?: throw GradleException("release cannot be null")
val args = listOf("tauri", "android", "android-studio-script");
project.exec {
workingDir(File(project.projectDir, rootDirRel))
executable(executable)
args(args)
if (project.logger.isEnabled(LogLevel.DEBUG)) {
args("-vv")
} else if (project.logger.isEnabled(LogLevel.INFO)) {
args("-v")
}
if (release) {
args("--release")
}
args(listOf("--target", target))
}.assertNormalExitValue()
}
}
@@ -0,0 +1,85 @@
import com.android.build.api.dsl.ApplicationExtension
import org.gradle.api.DefaultTask
import org.gradle.api.Plugin
import org.gradle.api.Project
import org.gradle.kotlin.dsl.configure
import org.gradle.kotlin.dsl.get
const val TASK_GROUP = "rust"
open class Config {
lateinit var rootDirRel: String
}
open class RustPlugin : Plugin<Project> {
private lateinit var config: Config
override fun apply(project: Project) = with(project) {
config = extensions.create("rust", Config::class.java)
val defaultAbiList = listOf("arm64-v8a", "armeabi-v7a", "x86", "x86_64");
val abiList = (findProperty("abiList") as? String)?.split(',') ?: defaultAbiList
val defaultArchList = listOf("arm64", "arm", "x86", "x86_64");
val archList = (findProperty("archList") as? String)?.split(',') ?: defaultArchList
val targetsList = (findProperty("targetList") as? String)?.split(',') ?: listOf("aarch64", "armv7", "i686", "x86_64")
extensions.configure<ApplicationExtension> {
@Suppress("UnstableApiUsage")
flavorDimensions.add("abi")
productFlavors {
create("universal") {
dimension = "abi"
ndk {
abiFilters += abiList
}
}
defaultArchList.forEachIndexed { index, arch ->
create(arch) {
dimension = "abi"
ndk {
abiFilters.add(defaultAbiList[index])
}
}
}
}
}
afterEvaluate {
for (profile in listOf("debug", "release")) {
val profileCapitalized = profile.replaceFirstChar { it.uppercase() }
val buildTask = tasks.maybeCreate(
"rustBuildUniversal$profileCapitalized",
DefaultTask::class.java
).apply {
group = TASK_GROUP
description = "Build dynamic library in $profile mode for all targets"
}
tasks["mergeUniversal${profileCapitalized}JniLibFolders"].dependsOn(buildTask)
for (targetPair in targetsList.withIndex()) {
val targetName = targetPair.value
val targetArch = archList[targetPair.index]
val targetArchCapitalized = targetArch.replaceFirstChar { it.uppercase() }
val targetBuildTask = project.tasks.maybeCreate(
"rustBuild$targetArchCapitalized$profileCapitalized",
BuildTask::class.java
).apply {
group = TASK_GROUP
description = "Build dynamic library in $profile mode for $targetArch"
rootDirRel = config.rootDirRel
target = targetName
release = profile == "release"
}
buildTask.dependsOn(targetBuildTask)
tasks["merge$targetArchCapitalized${profileCapitalized}JniLibFolders"].dependsOn(
targetBuildTask
)
}
}
}
}
}
+24
View File
@@ -0,0 +1,24 @@
# Project-wide Gradle settings.
# IDE (e.g. Android Studio) users:
# Gradle settings configured through the IDE *will override*
# any settings specified in this file.
# For more details on how to configure your build environment visit
# http://www.gradle.org/docs/current/userguide/build_environment.html
# Specifies the JVM arguments used for the daemon process.
# The setting is particularly useful for tweaking memory settings.
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
# When configured, Gradle will run in incubating parallel mode.
# This option should only be used with decoupled projects. More details, visit
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
# org.gradle.parallel=true
# AndroidX package structure to make it clearer which packages are bundled with the
# Android operating system, and which are packaged with your app"s APK
# https://developer.android.com/topic/libraries/support-library/androidx-rn
android.useAndroidX=true
# Kotlin code style for this project: "official" or "obsolete":
kotlin.code.style=official
# Enables namespacing of each library's R class so that its R class includes only the
# resources declared in the library itself and none from the library's dependencies,
# thereby reducing the size of the R class for that library
android.nonTransitiveRClass=true
android.nonFinalResIds=false
Binary file not shown.
@@ -0,0 +1,6 @@
#Tue May 10 19:22:52 CST 2022
distributionBase=GRADLE_USER_HOME
distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
distributionPath=wrapper/dists
zipStorePath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
+185
View File
@@ -0,0 +1,185 @@
#!/usr/bin/env sh
#
# Copyright 2015 the original author or authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
##############################################################################
##
## Gradle start up script for UN*X
##
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
PRG="$0"
# Need this for relative symlinks.
while [ -h "$PRG" ] ; do
ls=`ls -ld "$PRG"`
link=`expr "$ls" : '.*-> \(.*\)$'`
if expr "$link" : '/.*' > /dev/null; then
PRG="$link"
else
PRG=`dirname "$PRG"`"/$link"
fi
done
SAVED="`pwd`"
cd "`dirname \"$PRG\"`/" >/dev/null
APP_HOME="`pwd -P`"
cd "$SAVED" >/dev/null
APP_NAME="Gradle"
APP_BASE_NAME=`basename "$0"`
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD="maximum"
warn () {
echo "$*"
}
die () {
echo
echo "$*"
echo
exit 1
}
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "`uname`" in
CYGWIN* )
cygwin=true
;;
Darwin* )
darwin=true
;;
MINGW* )
msys=true
;;
NONSTOP* )
nonstop=true
;;
esac
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD="$JAVA_HOME/jre/sh/java"
else
JAVACMD="$JAVA_HOME/bin/java"
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD="java"
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
# Increase the maximum file descriptors if we can.
if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
MAX_FD_LIMIT=`ulimit -H -n`
if [ $? -eq 0 ] ; then
if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
MAX_FD="$MAX_FD_LIMIT"
fi
ulimit -n $MAX_FD
if [ $? -ne 0 ] ; then
warn "Could not set maximum file descriptor limit: $MAX_FD"
fi
else
warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
fi
fi
# For Darwin, add options to specify how the application appears in the dock
if $darwin; then
GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
fi
# For Cygwin or MSYS, switch paths to Windows format before running java
if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
APP_HOME=`cygpath --path --mixed "$APP_HOME"`
CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
JAVACMD=`cygpath --unix "$JAVACMD"`
# We build the pattern for arguments to be converted via cygpath
ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
SEP=""
for dir in $ROOTDIRSRAW ; do
ROOTDIRS="$ROOTDIRS$SEP$dir"
SEP="|"
done
OURCYGPATTERN="(^($ROOTDIRS))"
# Add a user-defined pattern to the cygpath arguments
if [ "$GRADLE_CYGPATTERN" != "" ] ; then
OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
fi
# Now convert the arguments - kludge to limit ourselves to /bin/sh
i=0
for arg in "$@" ; do
CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
else
eval `echo args$i`="\"$arg\""
fi
i=`expr $i + 1`
done
case $i in
0) set -- ;;
1) set -- "$args0" ;;
2) set -- "$args0" "$args1" ;;
3) set -- "$args0" "$args1" "$args2" ;;
4) set -- "$args0" "$args1" "$args2" "$args3" ;;
5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
esac
fi
# Escape application args
save () {
for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
echo " "
}
APP_ARGS=`save "$@"`
# Collect all arguments for the java command, following the shell quoting and substitution rules
eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
exec "$JAVACMD" "$@"
+89
View File
@@ -0,0 +1,89 @@
@rem
@rem Copyright 2015 the original author or authors.
@rem
@rem Licensed under the Apache License, Version 2.0 (the "License");
@rem you may not use this file except in compliance with the License.
@rem You may obtain a copy of the License at
@rem
@rem https://www.apache.org/licenses/LICENSE-2.0
@rem
@rem Unless required by applicable law or agreed to in writing, software
@rem distributed under the License is distributed on an "AS IS" BASIS,
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
@if "%DEBUG%" == "" @echo off
@rem ##########################################################################
@rem
@rem Gradle startup script for Windows
@rem
@rem ##########################################################################
@rem Set local scope for the variables with windows NT shell
if "%OS%"=="Windows_NT" setlocal
set DIRNAME=%~dp0
if "%DIRNAME%" == "" set DIRNAME=.
set APP_BASE_NAME=%~n0
set APP_HOME=%DIRNAME%
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
@rem Find java.exe
if defined JAVA_HOME goto findJavaFromJavaHome
set JAVA_EXE=java.exe
%JAVA_EXE% -version >NUL 2>&1
if "%ERRORLEVEL%" == "0" goto execute
echo.
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
echo.
echo Please set the JAVA_HOME variable in your environment to match the
echo location of your Java installation.
goto fail
:findJavaFromJavaHome
set JAVA_HOME=%JAVA_HOME:"=%
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
if exist "%JAVA_EXE%" goto execute
echo.
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
echo.
echo Please set the JAVA_HOME variable in your environment to match the
echo location of your Java installation.
goto fail
:execute
@rem Setup the command line
set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
@rem Execute Gradle
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
:end
@rem End local scope for the variables with windows NT shell
if "%ERRORLEVEL%"=="0" goto mainEnd
:fail
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
rem the _cmd.exe /c_ return code!
if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
exit /b 1
:mainEnd
if "%OS%"=="Windows_NT" endlocal
:omega
+3
View File
@@ -0,0 +1,3 @@
include ':app'
apply from: 'tauri.settings.gradle'
+1 -1
View File
@@ -1 +1 @@
{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"Denies the identifier command without any pre-configured scope.","commands":{"allow":[],"deny":["identifier"]}},"deny-name":{"identifier":"deny-name","description":"Denies the name command without any pre-configured scope.","commands":{"allow":[],"deny":["name"]}},"deny-register-listener":{"identifier":"deny-register-listener","description":"Denies the register_listener command without any pre-configured scope.","commands":{"allow":[],"deny":["register_listener"]}},"deny-remove-data-store":{"identifier":"deny-remove-data-store","description":"Denies the remove_data_store command Line truncated
{"core":{"default_permission":{"identifier":"default","description":"Default core plugins set.","permissions":["core:path:default","core:event:default","core:window:default","core:webview:default","core:app:default","core:image:default","core:resources:default","core:menu:default","core:tray:default"]},"permissions":{},"permission_sets":{},"global_scope_schema":null},"core:app":{"default_permission":{"identifier":"default","description":"Default permissions for the plugin.","permissions":["allow-version","allow-name","allow-tauri-version","allow-identifier","allow-bundle-type","allow-register-listener","allow-remove-listener","allow-supports-multiple-windows"]},"permissions":{"allow-app-hide":{"identifier":"allow-app-hide","description":"Enables the app_hide command without any pre-configured scope.","commands":{"allow":["app_hide"],"deny":[]}},"allow-app-show":{"identifier":"allow-app-show","description":"Enables the app_show command without any pre-configured scope.","commands":{"allow":["app_show"],"deny":[]}},"allow-bundle-type":{"identifier":"allow-bundle-type","description":"Enables the bundle_type command without any pre-configured scope.","commands":{"allow":["bundle_type"],"deny":[]}},"allow-default-window-icon":{"identifier":"allow-default-window-icon","description":"Enables the default_window_icon command without any pre-configured scope.","commands":{"allow":["default_window_icon"],"deny":[]}},"allow-fetch-data-store-identifiers":{"identifier":"allow-fetch-data-store-identifiers","description":"Enables the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":["fetch_data_store_identifiers"],"deny":[]}},"allow-identifier":{"identifier":"allow-identifier","description":"Enables the identifier command without any pre-configured scope.","commands":{"allow":["identifier"],"deny":[]}},"allow-name":{"identifier":"allow-name","description":"Enables the name command without any pre-configured scope.","commands":{"allow":["name"],"deny":[]}},"allow-register-listener":{"identifier":"allow-register-listener","description":"Enables the register_listener command without any pre-configured scope.","commands":{"allow":["register_listener"],"deny":[]}},"allow-remove-data-store":{"identifier":"allow-remove-data-store","description":"Enables the remove_data_store command without any pre-configured scope.","commands":{"allow":["remove_data_store"],"deny":[]}},"allow-remove-listener":{"identifier":"allow-remove-listener","description":"Enables the remove_listener command without any pre-configured scope.","commands":{"allow":["remove_listener"],"deny":[]}},"allow-set-app-theme":{"identifier":"allow-set-app-theme","description":"Enables the set_app_theme command without any pre-configured scope.","commands":{"allow":["set_app_theme"],"deny":[]}},"allow-set-dock-visibility":{"identifier":"allow-set-dock-visibility","description":"Enables the set_dock_visibility command without any pre-configured scope.","commands":{"allow":["set_dock_visibility"],"deny":[]}},"allow-supports-multiple-windows":{"identifier":"allow-supports-multiple-windows","description":"Enables the supports_multiple_windows command without any pre-configured scope.","commands":{"allow":["supports_multiple_windows"],"deny":[]}},"allow-tauri-version":{"identifier":"allow-tauri-version","description":"Enables the tauri_version command without any pre-configured scope.","commands":{"allow":["tauri_version"],"deny":[]}},"allow-version":{"identifier":"allow-version","description":"Enables the version command without any pre-configured scope.","commands":{"allow":["version"],"deny":[]}},"deny-app-hide":{"identifier":"deny-app-hide","description":"Denies the app_hide command without any pre-configured scope.","commands":{"allow":[],"deny":["app_hide"]}},"deny-app-show":{"identifier":"deny-app-show","description":"Denies the app_show command without any pre-configured scope.","commands":{"allow":[],"deny":["app_show"]}},"deny-bundle-type":{"identifier":"deny-bundle-type","description":"Denies the bundle_type command without any pre-configured scope.","commands":{"allow":[],"deny":["bundle_type"]}},"deny-default-window-icon":{"identifier":"deny-default-window-icon","description":"Denies the default_window_icon command without any pre-configured scope.","commands":{"allow":[],"deny":["default_window_icon"]}},"deny-fetch-data-store-identifiers":{"identifier":"deny-fetch-data-store-identifiers","description":"Denies the fetch_data_store_identifiers command without any pre-configured scope.","commands":{"allow":[],"deny":["fetch_data_store_identifiers"]}},"deny-identifier":{"identifier":"deny-identifier","description":"Denies the identifier command without any pre-configured scope.","commands":{"allow":[],"deny":["identifier"]}},"deny-name":{"identifier":"deny-name","description":"Denies the name command without any pre-configured scope.","commands":{"allow":[],"deny":["name"]}},"deny-register-listener":{"identifier":"deny-reLine truncated
File diff suppressed because it is too large. Load diff
+1 -1
View File
@@ -1 +1 @@
{"default":{"identifier":"default","description":"Default capabilities for YTDescGen","local":true,"windows":["main"],"permissions":["core:default","dialog:default","dialog:allow-save","dialog:allow-open","fs:default","fs:allow-read-text-file","fs:allow-write-text-file","shell:default","opener:default",{"identifier":"opener:allow-open-path","allow":[{"path":"$APPDATA"},{"path":"$APPDATA/**"}]},{"identifier":"opener:allow-reveal-item-in-dir","allow":[{"path":"$APPDATA"},{"path":"$APPDATA/**"}]}]}}
{"default":{"identifier":"default","description":"Default capabilities for YTDescGen","local":true,"windows":["main"],"permissions":["core:default","dialog:default","dialog:allow-save","dialog:allow-open","fs:default","fs:allow-read-text-file","fs:allow-write-text-file","shell:default","opener:default"]}}
Loaded 100 of 303 files, more files were not shown because too many files have changed in this diff. Show more