Files
youtube-generator/tests/engine/description-builder.test.ts
T
poli0981andClaude Opus 5.5 7e6c12152f fix(data): hardware names, YouTube's tag count, chapters, history duplicates, validation
Hardware
- GPU catalog rewritten with stable ids and official names: descriptions
  read "NVIDIA GeForce RTX 5080", "AMD Radeon RX 9070 XT", "Apple M4 Pro"
  instead of "NVIDIA RTX 5080" / "AMD RX 9070 XT" / "Apple Silicon M4 Pro".
  Cards that never shipped (RX 9080, RX 9090 XT, Arc B380) are gone;
  RTX 50/40/30 laptop GPUs, RX 9070 GRE, VRAM variants, Radeon/Intel
  integrated graphics, handheld APUs and Apple M5 (Pro/Max/Ultra) added.
  One searchable picker ("5080", "rog ally") replaces Brand › Series ›
  Model, with free text for anything else.
- Old `brand|series|model` values are migrated (editor v19, profiles v3,
  templates v2, and on load/import); unknown cards keep their full name.
- RAM: 24/48/192 GB, LPDDR4/4X/5/5X, optional speed ("32 GB DDR5-6000");
  no DDR6/DDR7; plain "DDR"; "48GB GB" fixed; changing the size no longer
  clears the type. OS: SteamOS, Bazzite, CachyOS, Nobara, openSUSE,
  Fedora 43/44; Linux reads "Ubuntu 24.04 LTS". CPU: suggestions, and
  Windows' "Intel(R) Core(TM) … CPU @ 3.60GHz" is tidied on blur.
- The rig block uses translated labels in a fixed order (CPU, GPU, RAM…)
  in both the description and the social captions.

Tags
- Measured the way YouTube counts (quotes around multi-word tags, one
  comma between): 15 of 51 real tag sets were over 500 by YouTube's count
  while showing under. Counters and the limit warning use the same count.
- Trimming keeps trying shorter tags after one that doesn't fit.
- "Elden Ring Steam", "itch.io gameplay" (was STEAM / ITCHIO); no platform
  tags for a publisher site; "best open world games" (was "openworld");
  RPG/simulation/card pools no longer carry other genres' tags.

Timestamps
- Keywords need a word boundary: "Final Fantasy VII" stays a title (was
  "Ending Fantasy VII"), "Introduction" stays whole.
- Accepts [0:00], 0:00 - label and editor frame counts; pt-BR and
  Indonesian keywords; a Tidy up button; a live check of YouTube's
  chapter rules (0:00 first, 3+, 10 s apart, in order).

Output and data
- History keeps one entry per video (updated in place) instead of one per
  Output visit; existing duplicates are folded (history v3). The History
  Limit is healed on every load.
- A field over its limit blocks only its own copy button (Copy All: title
  or description); a warning when YouTube would reject "<" or ">".
- Validation: Steam /sub/, /bundle/ and s.team links, GOG/Humble/xbox.com
  without www, regional Nintendo sites, Microsoft Store, Luna; social
  links with www./m./twitter.com; phone, YouTube Music and
  video-in-playlist links (normalised); email domains need a TLD; the live
  URL is validated; no bare "#" hashtag.
- The engine takes the year from the caller; "Ending N" follows the output
  language.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 21:11:58 +07:00

1830 lines
66 KiB
TypeScript

import { describe, it, expect } from "vitest";
import { buildDescription, checkDescriptionWarning } from "@engine/description-builder";
import { createMockT } from "../helpers/mock-t";
import type { GeneratorInput } from "@engine/types";
function makeInput(overrides: Partial<GeneratorInput> = {}): GeneratorInput {
return {
videoType: "full",
language: "en",
genres: ["action"],
gameName: "Elden Ring",
channelName: "TestChannel",
platform: "steam",
spoilerWarning: false,
matureWarning: false,
storeLinks: {},
social: {},
rig: {},
...overrides,
};
}
describe("buildDescription", () => {
it("generates minimal description with only required fields", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t);
expect(result).toContain("full gameplay of Elden Ring on TestChannel");
expect(result).toContain("No Commentary");
expect(result).toContain("Like | 🔔 Subscribe");
expect(result).toContain("#EldenRing");
});
it("sanitises hashtags for game names with special characters", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ gameName: "S.T.A.L.K.E.R. 2" }), t);
expect(result).toContain("#STALKER2");
expect(result).not.toMatch(/#\s?S\./);
});
it("sanitises hashtags for snake_case genre ids (fixes #visual_novel bug)", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ genres: ["visual_novel"] }), t);
expect(result).toContain("#visualnovel");
expect(result).not.toContain("#visual_novel");
});
it("uses the first genre for the hashtag when multiple are selected", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ genres: ["hack_slash", "action", "soulslike"] }),
t,
);
expect(result).toContain("#hackslash");
expect(result).not.toContain("#action");
expect(result).not.toContain("#soulslike");
});
it("includes timestamps when provided", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ timestamps: "0:00 Intro\n5:30 Boss" }), t);
expect(result).toContain("TIMESTAMPS");
expect(result).toContain("0:00 Intro");
expect(result).toContain("5:30 Boss");
});
it("includes store links when provided (paid default → Buy heading)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ storeLinks: { Steam: "https://store.steampowered.com/app/123" } }),
t,
);
expect(result).toContain("GET THE GAME (if you want to buy)");
expect(result).toContain("Steam: https://store.steampowered.com/app/123");
expect(result).not.toContain("DOWNLOAD THE GAME");
});
it("switches to Download heading when majority of links are free/demo", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
storeLinks: {
steam: "https://store.steampowered.com/app/1",
itchio: "https://dev.itch.io/demo",
epic: "https://store.epicgames.com/freegame",
},
storeLinkTypes: {
steam: "paid",
itchio: "demo",
epic: "free",
},
}),
t,
);
expect(result).toContain("DOWNLOAD THE GAME (if you want to play)");
expect(result).not.toContain("GET THE GAME");
});
it("ties favour the Buy heading", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
storeLinks: {
steam: "https://store.steampowered.com/app/1",
itchio: "https://dev.itch.io/game",
},
storeLinkTypes: { steam: "paid", itchio: "free" },
}),
t,
);
// 1 paid, 1 free → nonPaid (1) is NOT > entries.length/2 (1) → Buy
expect(result).toContain("GET THE GAME (if you want to buy)");
});
it("adds (free demo) suffix to demo links", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
storeLinks: { itchio: "https://dev.itch.io/demo" },
storeLinkTypes: { itchio: "demo" },
}),
t,
);
expect(result).toContain("(free demo)");
});
it("adds (free) suffix to free links but not paid ones", () => {
const t = createMockT("en");
const steamUrl = "https://store.steampowered.com/app/1";
const itchUrl = "https://dev.itch.io/game";
const result = buildDescription(
makeInput({
storeLinks: { steam: steamUrl, itchio: itchUrl },
storeLinkTypes: { steam: "paid", itchio: "free" },
}),
t,
);
// A store line renders as `🎮 {label}{suffix}: {url}`, so the suffix sits
// immediately before `: <url>`. Asserting that adjacency is stricter than
// locating the line by a host substring — `includes("itch.io")` would also
// match a decoy like `https://itch.io.example.com/`, which is exactly why
// CodeQL flags that shape as js/incomplete-url-substring-sanitization.
expect(result).toContain(`(free): ${itchUrl}`);
expect(result).not.toContain(`(free): ${steamUrl}`);
});
it("defaults unspecified link types to paid", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
storeLinks: { steam: "https://store.steampowered.com/app/1" },
// storeLinkTypes omitted entirely
}),
t,
);
expect(result).toContain("GET THE GAME (if you want to buy)");
expect(result).not.toContain("(free)");
});
it("includes the playtest block with platform label + link when a link is set (v0.30.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
playtestLink: "https://store.steampowered.com/app/1245620",
playtestPlatform: "steam",
playtestInvites: 25,
}),
t,
);
expect(result).toContain("🧪 PLAYTEST / EARLY ACCESS");
expect(result).toContain("🧪 Steam Playtest: https://store.steampowered.com/app/1245620");
expect(result).toContain("25 invites available");
});
it("omits the playtest block entirely when no link is set", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ playtestPlatform: "steam", playtestInvites: 25 }),
t,
);
expect(result).not.toContain("PLAYTEST / EARLY ACCESS");
});
it("omits the invites line when the count is 0", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
playtestLink: "https://dev.itch.io/my-game",
playtestPlatform: "itchio",
playtestInvites: 0,
}),
t,
);
expect(result).toContain("🧪 PLAYTEST / EARLY ACCESS");
expect(result).not.toContain("invites available");
});
it("guards the invites line against non-integer / negative counts", () => {
const t = createMockT("en");
const decimal = buildDescription(
makeInput({
playtestLink: "https://store.steampowered.com/app/1",
playtestInvites: 2.5,
}),
t,
);
expect(decimal).not.toContain("invites available");
const negative = buildDescription(
makeInput({
playtestLink: "https://store.steampowered.com/app/1",
playtestInvites: -3,
}),
t,
);
expect(negative).not.toContain("invites available");
});
it("falls back to the raw platform id when the platform is unknown", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
playtestLink: "https://example.com/signup",
playtestPlatform: "mystery",
}),
t,
);
expect(result).toContain("🧪 mystery: https://example.com/signup");
});
it("renders the localized playtest heading in Vietnamese", () => {
const t = createMockT("vi");
const result = buildDescription(
makeInput({
language: "vi",
playtestLink: "https://store.steampowered.com/app/1",
}),
t,
);
expect(result).toContain("🧪 PLAYTEST / TRẢI NGHIỆM SỚM");
});
it("includes video settings with the v0.8-polish multi-line block", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ resolution: "4K", fps: "60", graphicsPreset: "ultra" }),
t,
);
expect(result).toContain("VIDEO SETTINGS");
expect(result).toContain("Video: 4K - 60 FPS");
expect(result).toContain("In-game Setting: Ultra");
});
it("composes Cinematic + NVIDIA Frame Gen x2 + Ray Tracing line", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1440p",
fps: "120",
graphicsPreset: "cinematic",
frameGenVendor: "nvidia",
frameGenMultiplier: "x2",
rayTracingModes: ["ray_tracing"],
}),
t,
);
expect(result).toContain("Video: 1440p - 120 FPS");
expect(result).toContain(
"In-game Setting: Cinematic - NVIDIA Frame Generation x2 with Ray Tracing",
);
});
it("combines upscaling quality and frame generation under one vendor (v0.11 vendor-aware labels)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "4K",
fps: "60",
graphicsPreset: "ultra",
frameGenVendor: "amd",
upscaleQuality: "quality",
frameGenMultiplier: "x3",
rayTracingModes: ["full_rt"],
}),
t,
);
// v0.11 dropped the "skip brand on second mention" optimization in
// favour of vendor-keyed full labels — both halves now carry brand.
expect(result).toContain(
"In-game Setting: Ultra - AMD FSR Quality + AMD Fluid Motion Frames x3 with Full Ray Tracing",
);
});
it("renders DLAA as a quality tier under NVIDIA (v0.11)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "4K",
fps: "60",
graphicsPreset: "ultra",
frameGenVendor: "nvidia",
upscaleQuality: "dlaa",
}),
t,
);
// DLAA replaces DLSS upscaling — should NOT read "NVIDIA DLSS DLAA".
expect(result).toContain("In-game Setting: Ultra - NVIDIA DLAA");
expect(result).not.toContain("NVIDIA DLSS DLAA");
});
it("renders XeSS Ultra Quality under Intel (v0.11)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1440p",
fps: "60",
graphicsPreset: "high",
frameGenVendor: "intel",
upscaleQuality: "ultra_quality",
frameGenMultiplier: "x2",
}),
t,
);
expect(result).toContain("In-game Setting: High - Intel XeSS Ultra Quality + Intel XeFG x2");
});
it("emits multiple RT modes joined with commas", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1080p",
fps: "60",
graphicsPreset: "high",
rayTracingModes: ["path_tracing", "ray_reconstruction"],
}),
t,
);
expect(result).toContain("In-game Setting: High with Path Tracing, Ray Reconstruction");
});
it("uses the user's free-form label when graphicsPreset is custom", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1080p",
fps: "60",
graphicsPreset: "custom",
graphicsPresetCustom: "Epic",
}),
t,
);
expect(result).toContain("Video: 1080p - 60 FPS");
expect(result).toContain("In-game Setting: Epic");
});
it("emits Art Style on its own line", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
graphicsPreset: "medium",
artStyle: "pixel_art",
}),
t,
);
expect(result).toContain("In-game Setting: Medium");
expect(result).toContain("Art Style: Pixel Art");
});
it("emits Version on its own line", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1080p",
fps: "60",
graphicsPreset: "ultra",
versionInfo: "GeForce 565.90 | Game v1.4",
}),
t,
);
expect(result).toContain("Video: 1080p - 60 FPS");
expect(result).toContain("In-game Setting: Ultra");
expect(result).toContain("Version: GeForce 565.90 | Game v1.4");
});
it("renders the four video-settings tokens as separate labelled lines", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1440p",
fps: "60",
graphicsPreset: "cinematic",
frameGenVendor: "nvidia",
frameGenMultiplier: "x2",
rayTracingModes: ["ray_tracing"],
artStyle: "realistic",
versionInfo: "GeForce 566.36",
}),
t,
);
// Each line carries its own label — find the section and verify the
// four expected lines are present in order.
const section = result.split("🖥 VIDEO SETTINGS\n")[1]?.split("\n\n")[0];
expect(section).toBeTruthy();
const lines = section!.split("\n");
expect(lines[0]).toBe("Video: 1440p - 60 FPS");
expect(lines[1]).toBe(
"In-game Setting: Cinematic - NVIDIA Frame Generation x2 with Ray Tracing",
);
expect(lines[2]).toBe("Art Style: Realistic");
expect(lines[3]).toBe("Version: GeForce 566.36");
});
it("omits the entire VIDEO SETTINGS section when skipGraphicsSettings is true", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
resolution: "1080p",
fps: "60",
graphicsPreset: "ultra",
skipGraphicsSettings: true,
}),
t,
);
expect(result).not.toContain("VIDEO SETTINGS");
expect(result).not.toContain("Ultra Setting");
});
it("renders livestream intro + watch link + scheduled time", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "livestream",
gameName: "Elden Ring",
channelName: "TestChannel",
liveUrl: "https://www.youtube.com/watch?v=live123",
scheduledTime: "2026-05-04T20:00:00",
}),
t,
);
expect(result).toContain("Live stream of Elden Ring on TestChannel");
expect(result).toContain("🔴 LIVE on");
expect(result).toContain("Watch / replay: https://www.youtube.com/watch?v=live123");
});
it("falls back to the raw scheduledTime string when it can't be parsed", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "livestream",
liveUrl: "https://www.youtube.com/watch?v=abc",
scheduledTime: "tomorrow at 8pm", // not ISO
}),
t,
);
expect(result).toContain("🔴 LIVE on tomorrow at 8pm");
});
it("renders the Vietnam donate block when language is 'vi' and bank fields set", () => {
const t = createMockT("en"); // mock-t falls back to en for keys not in vi mock; section header is what matters
const result = buildDescription(
makeInput({
language: "vi",
vnBankName: "Vietcombank",
vnBankAccount: "0123456789",
vnBankHolder: "NGUYEN VAN A",
vnMomo: "0901234567",
vnZalopay: "0907654321",
}),
t,
);
expect(result).toContain("BANK TRANSFER / E-WALLET (Vietnam)");
expect(result).toContain("🏦 Vietcombank: 0123456789 (NGUYEN VAN A)");
expect(result).toContain("💸 MoMo: 0901234567");
expect(result).toContain("💸 ZaloPay: 0907654321");
});
it("omits the holder parens when the holder field is empty", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
vnBankName: "MB Bank",
vnBankAccount: "9876543210",
}),
t,
);
expect(result).toContain("🏦 MB Bank: 9876543210");
expect(result).not.toContain("()");
});
it("skips the bank line when only one of bankName/bankAccount is set", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
vnBankName: "Vietcombank",
// vnBankAccount missing
vnMomo: "0901234567",
}),
t,
);
expect(result).not.toContain("🏦 Vietcombank");
// MoMo line still emits
expect(result).toContain("💸 MoMo: 0901234567");
});
it("never renders the Vietnam donate block when language is not 'vi'", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
language: "en",
vnBankName: "Vietcombank",
vnBankAccount: "0123456789",
vnMomo: "0901234567",
}),
t,
);
expect(result).not.toContain("BANK TRANSFER");
expect(result).not.toContain("🏦 Vietcombank");
expect(result).not.toContain("💸 MoMo");
});
it("renders the community block with the Messenger line for any language (v0.32.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ messengerCommunityLink: "https://m.me/ch/mychannel" }),
t,
);
expect(result).toContain("💬 COMMUNITY / JOIN THE GROUP");
expect(result).toContain("💬 Messenger: https://m.me/ch/mychannel");
expect(result).not.toContain("💙 Zalo");
});
it("renders the Zalo group line when language is 'vi' (v0.32.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
messengerCommunityLink: "https://m.me/ch/mychannel",
zaloGroupLink: "https://zalo.me/g/abc123",
}),
t,
);
expect(result).toContain("💬 Messenger: https://m.me/ch/mychannel");
expect(result).toContain("💙 Zalo: https://zalo.me/g/abc123");
});
it("never renders the Zalo group line when language is not 'vi', even if set (v0.32.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
language: "en",
messengerCommunityLink: "https://m.me/ch/mychannel",
zaloGroupLink: "https://zalo.me/g/abc123",
}),
t,
);
// Messenger is language-agnostic and still renders…
expect(result).toContain("💬 Messenger: https://m.me/ch/mychannel");
// …but the Zalo line is gated to Vietnamese output.
expect(result).not.toContain("💙 Zalo");
expect(result).not.toContain("zalo.me/g/abc123");
});
it("omits the community block entirely when it would be empty (v0.32.0)", () => {
const t = createMockT("en");
// Zalo is set but the output language is English and there's no
// Messenger link → the block has no eligible lines and is skipped.
const result = buildDescription(
makeInput({ language: "en", zaloGroupLink: "https://zalo.me/g/abc123" }),
t,
);
expect(result).not.toContain("COMMUNITY / JOIN THE GROUP");
expect(result).not.toContain("💬 Messenger");
expect(result).not.toContain("💙 Zalo");
});
it("localizes the community heading for Vietnamese output (v0.32.0)", () => {
const t = createMockT("vi");
const result = buildDescription(
makeInput({
language: "vi",
messengerCommunityLink: "https://m.me/ch/mychannel",
zaloGroupLink: "https://zalo.me/g/abc123",
}),
t,
);
expect(result).toContain("CỘNG ĐỒNG / THAM GIA NHÓM");
expect(result).toContain("💙 Zalo: https://zalo.me/g/abc123");
});
it("renders Signal, Instagram and Facebook Group community lines for any language (v0.33.0)", () => {
// Japanese output — the three new links are language-agnostic (only
// the heading localizes), so they must appear just like for English.
const t = createMockT("ja");
const result = buildDescription(
makeInput({
language: "ja",
signalGroupLink: "https://signal.group/#abc123",
instagramGroupLink: "https://ig.me/j/xyz789",
facebookGroupLink: "https://facebook.com/groups/mygroup",
}),
t,
);
expect(result).toContain("🔒 Signal: https://signal.group/#abc123");
expect(result).toContain("📸 Instagram: https://ig.me/j/xyz789");
expect(result).toContain("👥 Facebook Group: https://facebook.com/groups/mygroup");
// Zalo is gated to Vietnamese output and unset here.
expect(result).not.toContain("💙 Zalo");
});
it("orders the community lines Messenger → Signal → Instagram → Facebook Group → Zalo (v0.33.0)", () => {
const t = createMockT("vi");
const result = buildDescription(
makeInput({
language: "vi",
messengerCommunityLink: "https://m.me/ch/mychannel",
signalGroupLink: "https://signal.group/#abc123",
instagramGroupLink: "https://ig.me/j/xyz789",
facebookGroupLink: "https://facebook.com/groups/mygroup",
zaloGroupLink: "https://zalo.me/g/abc123",
}),
t,
);
const iMessenger = result.indexOf("💬 Messenger");
const iSignal = result.indexOf("🔒 Signal");
const iInstagram = result.indexOf("📸 Instagram");
const iFacebook = result.indexOf("👥 Facebook Group");
const iZalo = result.indexOf("💙 Zalo");
expect(iMessenger).toBeGreaterThan(-1);
expect(iSignal).toBeGreaterThan(iMessenger);
expect(iInstagram).toBeGreaterThan(iSignal);
expect(iFacebook).toBeGreaterThan(iInstagram);
expect(iZalo).toBeGreaterThan(iFacebook);
});
it("renders Facebook Group in the Community block, not the Social block (v0.33.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
facebookGroupLink: "https://facebook.com/groups/mygroup",
social: { twitter: "myhandle" },
}),
t,
);
const iCommunity = result.indexOf("💬 COMMUNITY / JOIN THE GROUP");
const iFacebook = result.indexOf("👥 Facebook Group: https://facebook.com/groups/mygroup");
expect(iCommunity).toBeGreaterThan(-1);
expect(iFacebook).toBeGreaterThan(iCommunity);
// The FB group line appears exactly once — only under Community, never
// in the Social block (fb_group is no longer a SOCIAL_FIELDS entry).
expect(result.split("Facebook Group:").length - 1).toBe(1);
});
it("omits the community block when only an empty Facebook Group link is set (v0.33.0)", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ facebookGroupLink: " " }), t);
expect(result).not.toContain("COMMUNITY / JOIN THE GROUP");
expect(result).not.toContain("👥 Facebook Group");
});
it("renders the Mod List block when videoType is 'mods' and modList is non-empty", () => {
const t = createMockT("en");
const modList = "• Requiem\n• NaturalVision Evolved\n• Custom Skinpack v2.1";
const result = buildDescription(
makeInput({
videoType: "mods",
modName: "Requiem",
modList,
}),
t,
);
expect(result).toContain("🧩 MOD LIST");
expect(result).toContain(modList);
});
it("never renders the Mod List block for non-mods video types", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "full",
modList: "• Requiem",
}),
t,
);
expect(result).not.toContain("MOD LIST");
expect(result).not.toContain("Requiem");
});
it("skips the livestream block when no live metadata is set", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "livestream",
gameName: "Elden Ring",
channelName: "TestChannel",
}),
t,
);
// Intro still emits, but no metadata block
expect(result).toContain("Live stream of Elden Ring on TestChannel");
expect(result).not.toContain("🔴 LIVE on");
expect(result).not.toContain("Watch / replay:");
});
it("includes rig info when provided", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ rig: { CPU: "i9-14900K", GPU: "RTX 4090" } }), t);
expect(result).toContain("MY RIG");
expect(result).toContain("CPU: i9-14900K");
expect(result).toContain("GPU: RTX 4090");
});
it("labels rig lines in the output language, not as capitalised keys", () => {
const rig = { video_editor: "davinci_resolve_studio|19.1", storage: "2TB NVMe" };
const en = buildDescription(makeInput({ rig }), createMockT("en"));
expect(en).toContain("Video Editor: DaVinci Resolve Studio 19.1");
expect(en).not.toContain("VIDEO EDITOR");
expect(en).not.toContain("VIDEO_EDITOR");
const vi = buildDescription(makeInput({ language: "vi", rig }), createMockT("vi"));
expect(vi).toContain("Phần mềm dựng video: DaVinci Resolve Studio 19.1");
expect(vi).toContain("Ổ cứng: 2TB NVMe");
});
it("prints rig lines in a fixed order, whatever order they were filled in", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
rig: {
os: "windows|11|pro",
ram: "32|DDR5|6000",
gpu: "gpu:nvidia-rtx-5080",
cpu: "AMD Ryzen 7 9800X3D",
},
}),
t,
);
const block = result.slice(result.indexOf("MY RIG"));
const order = ["CPU:", "GPU:", "RAM:", "Operating System:"].map((label) =>
block.indexOf(label),
);
expect(order.every((i) => i > 0)).toBe(true);
expect([...order].sort((a, b) => a - b)).toEqual(order);
expect(block).toContain("GPU: NVIDIA GeForce RTX 5080");
expect(block).toContain("RAM: 32 GB DDR5-6000");
});
it("names a pre-v1.0 GPU value properly", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ rig: { gpu: "amd|rx_9000|RX 9070 XT" } }), t);
expect(result).toContain("GPU: AMD Radeon RX 9070 XT");
expect(result).not.toContain("GPU: AMD RX");
});
it("legacy spoilerWarning boolean no longer renders a standalone block (v0.11 deprecation)", () => {
// v0.11: the standalone SPOILER WARNING section was merged into the
// unified content-warning checklist as the `spoiler_story` item.
// Setting just the legacy boolean (without the equivalent checklist
// entry) renders nothing — by design; the editor-store v8→v9
// migration translates true→checklist for persisted drafts, and
// `normalizeEditorPatch` does the same for profile/preset/template
// loads, so live drafts surface the warning correctly.
const t = createMockT("en");
const result = buildDescription(makeInput({ spoilerWarning: true }), t);
expect(result).not.toContain("SPOILER WARNING");
expect(result).not.toContain("CONTENT WARNINGS");
});
it("includes music attribution section when provided", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ musicAttribution: "Music by Karl Casey @ White Bat Audio" }),
t,
);
expect(result).toContain("🎵 MUSIC / SOUND");
expect(result).toContain("Music by Karl Casey @ White Bat Audio");
});
it("places music section before donate/social sections", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
musicAttribution: "Music credit here",
social: { twitter: "https://x.com/me", kofi: "https://ko-fi.com/me" },
}),
t,
);
const musicIdx = result.indexOf("🎵 MUSIC / SOUND");
const donateIdx = result.indexOf("SUPPORT THE CHANNEL");
expect(musicIdx).toBeGreaterThan(-1);
expect(donateIdx).toBeGreaterThan(-1);
expect(musicIdx).toBeLessThan(donateIdx);
});
it("renders the sponsor credit line when toggle is on and both sponsor fields are filled", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ sponsorName: "Ubisoft", sponsorPlatform: "Steam" }),
t,
{ showSponsorCredit: true },
);
expect(result).toContain("🎁 Thanks to Ubisoft for providing the Steam key of this game.");
});
it("skips the sponsor credit when the toggle is off", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ sponsorName: "Ubisoft", sponsorPlatform: "Steam" }),
t,
{ showSponsorCredit: false },
);
expect(result).not.toContain("🎁 Thanks to Ubisoft");
});
it("skips the sponsor credit when sponsorName is blank even if toggle is on", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ sponsorName: "", sponsorPlatform: "Steam" }), t, {
showSponsorCredit: true,
});
expect(result).not.toContain("🎁");
expect(result).not.toContain("Steam key of this game");
});
it("skips the sponsor credit when sponsorPlatform is blank even if toggle is on", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ sponsorName: "Ubisoft", sponsorPlatform: "" }), t, {
showSponsorCredit: true,
});
expect(result).not.toContain("🎁");
expect(result).not.toContain("Thanks to Ubisoft");
});
it("trims whitespace around sponsor fields before rendering", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ sponsorName: " Ubisoft ", sponsorPlatform: " Steam " }),
t,
{ showSponsorCredit: true },
);
expect(result).toContain("Thanks to Ubisoft for providing the Steam key");
expect(result).not.toContain(" Ubisoft ");
});
it("places the sponsor credit above the music section and donate block", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
sponsorName: "Ubisoft",
sponsorPlatform: "Steam",
musicAttribution: "Music credit",
social: { kofi: "https://ko-fi.com/me" },
}),
t,
{ showSponsorCredit: true },
);
const sponsorIdx = result.indexOf("🎁");
const musicIdx = result.indexOf("🎵 MUSIC / SOUND");
const donateIdx = result.indexOf("SUPPORT THE CHANNEL");
expect(sponsorIdx).toBeGreaterThan(-1);
expect(musicIdx).toBeGreaterThan(sponsorIdx);
expect(donateIdx).toBeGreaterThan(musicIdx);
});
it("renders sponsor credit in Vietnamese with the localized template", () => {
const t = createMockT("vi");
const result = buildDescription(
makeInput({
language: "vi",
sponsorName: "Ubisoft",
sponsorPlatform: "Steam",
}),
t,
{ showSponsorCredit: true },
);
expect(result).toContain("🎁 Cảm ơn Ubisoft đã tặng key Steam của game này.");
});
it("omits the music section when attribution is blank or whitespace", () => {
const t = createMockT("en");
const blank = buildDescription(makeInput({ musicAttribution: "" }), t);
const whitespace = buildDescription(makeInput({ musicAttribution: " \n " }), t);
expect(blank).not.toContain("🎵 MUSIC / SOUND");
expect(whitespace).not.toContain("🎵 MUSIC / SOUND");
});
it("renders copyright line when showCopyright is true and channelName is set", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t, { showCopyright: true });
const year = new Date().getFullYear();
// v0.21.0 reworded the line to disambiguate the channel's video
// copyright from the game's IP. The header still leads with the
// same `© YYYY ChannelName` and the line still contains "All rights
// reserved on this recording" so the downstream checks (lines
// 664/670/694) keep working.
expect(result).toContain(`© ${year} TestChannel — Video content only.`);
expect(result).toContain("All rights reserved on this recording.");
});
it("skips copyright when channelName is blank even if toggle is on", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ channelName: "" }), t, {
showCopyright: true,
});
expect(result).not.toContain("All rights reserved");
});
it("skips copyright when the toggle is off", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t, { showCopyright: false });
expect(result).not.toContain("All rights reserved");
});
it("renders the usage policy block when showUsagePolicy is true", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t, { showUsagePolicy: true });
expect(result).toContain("📋 USAGE POLICY");
expect(result).toContain("Always credit");
expect(result).toContain("Compilation, review, commentary");
});
it("skips the usage policy when the toggle is off", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t, { showUsagePolicy: false });
expect(result).not.toContain("📋 USAGE POLICY");
});
it("places copyright and usage policy between CTA and hashtags", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t, {
showCopyright: true,
showUsagePolicy: true,
});
const ctaIdx = result.indexOf("Like | 🔔 Subscribe");
const copyrightIdx = result.indexOf("All rights reserved");
const policyIdx = result.indexOf("📋 USAGE POLICY");
const hashtagsIdx = result.indexOf("#EldenRing");
expect(ctaIdx).toBeGreaterThan(-1);
expect(copyrightIdx).toBeGreaterThan(ctaIdx);
expect(policyIdx).toBeGreaterThan(copyrightIdx);
expect(hashtagsIdx).toBeGreaterThan(policyIdx);
});
it("renders third-party ads block when toggle is on AND text is non-empty (v0.11)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ thirdPartyAdText: "Use code SAVE10 at GameStore.com" }),
t,
{ showThirdPartyAds: true },
);
expect(result).toContain("🤝 SPONSORS & PARTNERS");
expect(result).toContain("Use code SAVE10 at GameStore.com");
});
it("preserves multi-line third-party ad text verbatim (v0.11)", () => {
const t = createMockT("en");
const adText = "Sponsored by ChairCo — link below\nUse code SAVE10 for 10% off";
const result = buildDescription(makeInput({ thirdPartyAdText: adText }), t, {
showThirdPartyAds: true,
});
expect(result).toContain(adText);
});
it("skips ads block when toggle is off, even with non-empty text (v0.11)", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ thirdPartyAdText: "Sponsor copy" }), t, {
showThirdPartyAds: false,
});
expect(result).not.toContain("SPONSORS & PARTNERS");
expect(result).not.toContain("Sponsor copy");
});
it("skips ads block when toggle is on but text is empty (v0.11)", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ thirdPartyAdText: " " }), t, {
showThirdPartyAds: true,
});
expect(result).not.toContain("SPONSORS & PARTNERS");
});
it("legacy matureWarning boolean no longer renders a standalone block (v0.11 deprecation)", () => {
// Counterpart to the spoilerWarning deprecation test: the standalone
// MATURE CONTENT section was merged into the unified checklist as
// the `mature_18plus` item. Migration handles persisted state.
const t = createMockT("en");
const result = buildDescription(makeInput({ matureWarning: true }), t);
expect(result).not.toContain("MATURE CONTENT");
expect(result).not.toContain("CONTENT WARNINGS");
});
it("includes social links when provided", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ social: { twitter: "https://x.com/test", discord: "https://discord.gg/test" } }),
t,
);
expect(result).toContain("FOLLOW ME");
expect(result).toContain("Twitter / X: https://x.com/test");
});
it("includes playlist link when provided", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ playlistLink: "https://youtube.com/playlist?list=abc" }),
t,
);
expect(result).toContain("Watch the full series: https://youtube.com/playlist?list=abc");
});
it("includes contact email when provided", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ contactEmail: "test@example.com" }), t);
expect(result).toContain("Business inquiries: test@example.com");
});
describe("splitContactEmail", () => {
it("keeps the single business line when the toggle is off (default)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
contactEmail: "contact@example.com",
adEmail: "ads@example.com",
gameKeyEmail: "games@example.com",
}),
t,
);
expect(result).toContain("Business inquiries: contact@example.com");
// The extra purpose fields are ignored while the toggle is off.
expect(result).not.toContain("BUSINESS / CONTACT");
expect(result).not.toContain("ads@example.com");
expect(result).not.toContain("games@example.com");
});
it("renders a grouped block with one labeled line per non-empty field", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
contactEmail: "contact@example.com",
adEmail: "ads@example.com",
gameKeyEmail: "games@example.com",
}),
t,
{ splitContactEmail: true },
);
expect(result).toContain("BUSINESS / CONTACT");
expect(result).toContain("Contact: contact@example.com");
expect(result).toContain("Advertising: ads@example.com");
expect(result).toContain("Game keys & playtest: games@example.com");
// The single-line form must not also appear.
expect(result).not.toContain("Business inquiries:");
});
it("skips a purpose line whose field is empty", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
contactEmail: "contact@example.com",
adEmail: "",
gameKeyEmail: "games@example.com",
}),
t,
{ splitContactEmail: true },
);
expect(result).toContain("BUSINESS / CONTACT");
expect(result).toContain("Contact: contact@example.com");
expect(result).toContain("Game keys & playtest: games@example.com");
expect(result).not.toContain("Advertising:");
});
it("omits the whole block when all three fields are empty", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contactEmail: "", adEmail: "", gameKeyEmail: "" }),
t,
{ splitContactEmail: true },
);
expect(result).not.toContain("BUSINESS / CONTACT");
expect(result).not.toContain("Business inquiries:");
});
});
it("generates part description correctly", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ videoType: "part", partNumber: "5" }), t);
expect(result).toContain("Part 5 of Elden Ring");
});
it("generates boss description correctly", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ videoType: "boss", bossName: "Margit" }), t);
expect(result).toContain("Margit boss fight");
});
it("generates description in Vietnamese", () => {
const t = createMockT("vi");
const result = buildDescription(makeInput({ language: "vi" }), t);
expect(result).toContain("full gameplay của Elden Ring");
expect(result).toContain("Không bình luận");
});
});
describe("buildDescription — v0.12 Playthrough Notes consolidation", () => {
it("renders run type as a bullet of the unified PLAYTHROUGH NOTES block", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ playthroughStatus: "blind" }), t);
expect(result).toContain("▸ 🎮 PLAYTHROUGH NOTES");
expect(result).toContain("• Run type: Blind run (first time playing)");
// The block sits between the intro and No Commentary, replacing the
// pre-v0.12 standalone "🎯 Playthrough:" line.
const introIdx = result.indexOf("full gameplay of Elden Ring");
const pnIdx = result.indexOf("▸ 🎮 PLAYTHROUGH NOTES");
const noCommentaryIdx = result.indexOf("No Commentary");
expect(pnIdx).toBeGreaterThan(introIdx);
expect(noCommentaryIdx).toBeGreaterThan(pnIdx);
// The legacy single-line block must NOT render anymore.
expect(result).not.toContain("🎯 Playthrough:");
});
it("omits the entire PLAYTHROUGH NOTES block when every field is unset", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
playthroughStatus: "none",
difficulty: "none",
endingsShown: "",
languagePatch: "none",
gameVersion: "full_release",
}),
t,
);
expect(result).not.toContain("▸ 🎮 PLAYTHROUGH NOTES");
expect(result).not.toContain("🎯 Playthrough");
expect(result).not.toContain("🎮 DIFFICULTY");
});
it("renders difficulty as a bullet using the preset label", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ difficulty: "hard" }), t);
expect(result).toContain("▸ 🎮 PLAYTHROUGH NOTES");
expect(result).toContain("• Difficulty: Hard");
// Old standalone block must be gone.
expect(result).not.toContain("🎮 DIFFICULTY\n");
});
it("uses the custom difficulty label verbatim when difficulty is 'custom'", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ difficulty: "custom", difficultyCustomLabel: "Lethal" }),
t,
);
expect(result).toContain("• Difficulty: Lethal");
});
it("skips the Difficulty bullet when difficulty='custom' but label is blank", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ difficulty: "custom", difficultyCustomLabel: " " }),
t,
);
// The whole PN block should be skipped (no other PN field set either).
expect(result).not.toContain("▸ 🎮 PLAYTHROUGH NOTES");
});
it("renders all five PLAYTHROUGH NOTES bullets when fully filled", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
playthroughStatus: "blind",
difficulty: "hard",
endingsShown: "True ending only",
languagePatch: "fan_translation",
gameVersion: "early_access",
}),
t,
);
expect(result).toContain("▸ 🎮 PLAYTHROUGH NOTES");
expect(result).toContain("• Run type: Blind run (first time playing)");
expect(result).toContain("• Difficulty: Hard");
expect(result).toContain("• Endings shown: True ending only");
expect(result).toContain("• Language patch: Fan translation");
expect(result).toContain("• Game version: Early Access");
});
it("renders structured endings[] as a comma-joined bullet (v0.16.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
endings: [
{ number: 1, name: "True End" },
{ number: 3, name: "Bad End" },
{ number: null, name: "Hidden" },
],
}),
t,
);
expect(result).toContain("• Endings shown: Ending 1: True End, Ending 3: Bad End, Hidden");
});
it("falls back to legacy endingsShown when endings[] is empty (v0.16.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
endings: [],
endingsShown: "Legacy freeform value",
}),
t,
);
expect(result).toContain("• Endings shown: Legacy freeform value");
});
it("prefers structured endings over legacy endingsShown when both are set", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
endings: [{ number: 5, name: "Best End" }],
endingsShown: "Should be ignored",
}),
t,
);
expect(result).toContain("• Endings shown: Ending 5: Best End");
expect(result).not.toContain("Should be ignored");
});
it("slices endings[] to the requested video index when multi-video (v0.16.0)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
endings: [
{ number: 1, name: "A" },
{ number: 2, name: "B" },
{ number: 3, name: "C" },
{ number: 4, name: "D" },
],
endingVideoCount: 2,
endingVideoIndex: 2,
endingVideoRanges: [
{ from: 1, to: 2 },
{ from: 3, to: 4 },
],
}),
t,
);
// Video 2 covers endings 3 & 4 only.
expect(result).toContain("• Endings shown: Ending 3: C, Ending 4: D");
expect(result).not.toContain("Ending 1");
expect(result).not.toContain("Ending 2");
});
it("drops empty entries from the structured render", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
endings: [
{ number: 1, name: "True End" },
{ number: null, name: "" }, // empty — should be dropped
{ number: 2, name: "Bad End" },
],
}),
t,
);
expect(result).toContain("• Endings shown: Ending 1: True End, Ending 2: Bad End");
});
it("uses the custom slot for languagePatch='official_other'", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
languagePatch: "official_other",
languagePatchCustom: "Official KR",
}),
t,
);
expect(result).toContain("• Language patch: Official KR");
});
it("uses the custom slot for gameVersion='custom'", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
gameVersion: "custom",
gameVersionCustom: "Kickstarter backer build",
}),
t,
);
expect(result).toContain("• Game version: Kickstarter backer build");
});
it("renders bilingual EN · VI bullets when language=vi and tEn is provided", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
playthroughStatus: "blind",
difficulty: "hard",
languagePatch: "fan_translation",
}),
t,
{ tEn },
);
expect(result).toContain("▸ 🎮 PLAYTHROUGH NOTES / ▸ 🎮 GHI CHÚ LƯỢT CHƠI");
expect(result).toContain(
"• Run type · Kiểu chơi: Blind run (first time playing) · Chơi lần đầu (blind run)",
);
expect(result).toContain("• Difficulty · Độ khó: Hard · Khó");
expect(result).toContain("• Language patch · Bản dịch: Fan translation · Bản dịch của fan");
});
});
describe("buildDescription — v0.12 Tech Notes", () => {
it("renders selected tech notes as a bulleted block (en single-language)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
techNotes: ["copyright_muted_sections", "fps_drops_hardware"],
}),
t,
);
expect(result).toContain("▸ 🛠 TECH NOTES");
expect(result).toContain("Production and playstyle notes for transparency.");
expect(result).toContain("• Some sections muted due to YouTube copyright");
expect(result).toContain("• FPS drops — caused by hardware (FPS counter visible top-left)");
expect(result).not.toContain("• Game music replaced");
});
it("omits the TECH NOTES block when the list is empty", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ techNotes: [] }), t);
expect(result).not.toContain("TECH NOTES");
});
it("preserves selection order in the rendered tech-note bullets", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
techNotes: ["not_no_hit_run", "support_developers", "loading_cut"],
}),
t,
);
const noHitIdx = result.indexOf("• NOT a no-hit run");
const supportIdx = result.indexOf("• Original game music");
const loadingIdx = result.indexOf("• Loading screens");
expect(noHitIdx).toBeGreaterThan(-1);
expect(supportIdx).toBeGreaterThan(noHitIdx);
expect(loadingIdx).toBeGreaterThan(supportIdx);
});
it("renders bilingual EN · VI tech-note bullets when language=vi and tEn provided", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
techNotes: ["copyright_muted_sections", "casual_no_commentary"],
}),
t,
{ tEn },
);
expect(result).toContain("▸ 🛠 TECH NOTES / ▸ 🛠 GHI CHÚ KỸ THUẬT");
expect(result).toContain(
"• Some sections muted due to YouTube copyright · Một số đoạn tắt tiếng do bản quyền YouTube",
);
expect(result).toContain("• Casual play, no commentary · Chơi giải trí, không bình luận");
});
it("renders bilingual EN · JA tech-note bullets in Japanese mode", () => {
const t = createMockT("ja");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "ja",
techNotes: ["fps_drops_hardware", "support_developers"],
}),
t,
{ tEn },
);
expect(result).toContain("▸ 🛠 TECH NOTES / ▸ 🛠 技術メモ");
expect(result).toContain(
"• FPS drops — caused by hardware (FPS counter visible top-left) · FPS低下 — ハード起因(左上にFPS表示)",
);
expect(result).toContain(
"• Original game music — please support the developers · 原曲使用 — 開発者への応援をよろしくお願いします",
);
});
it("falls back to single-language tech-note bullets when tEn is omitted", () => {
const t = createMockT("vi");
const result = buildDescription(
makeInput({ language: "vi", techNotes: ["fps_drops_hardware"] }),
t,
);
// No `· ` separator since tEn isn't passed.
expect(result).not.toContain(" · ");
expect(result).toContain("▸ 🛠 GHI CHÚ KỸ THUẬT");
expect(result).toContain("• Có sụt FPS — do phần cứng (xem FPS góc trái video)");
});
});
describe("buildDescription — v0.7 content fields (legacy)", () => {
it("renders content warnings as a bulleted block (v0.11 unified, en single-language)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["flashing_lights", "loud_noises"] }),
t,
);
expect(result).toContain("▸ ⚠️ CONTENT WARNINGS");
expect(result).toContain(
"This video contains the following content. Viewer discretion advised.",
);
expect(result).toContain("• Flashing lights — photosensitive viewers take care");
expect(result).toContain("• Loud / sudden sounds");
expect(result).not.toContain("• Jumpscares");
});
it("omits the content-warnings block when the list is empty", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ contentWarnings: [] }), t);
expect(result).not.toContain("CONTENT WARNINGS");
});
it("preserves selection order in the rendered bullets (v0.11)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
contentWarnings: ["mature_18plus", "flashing_lights", "spoiler_story"],
}),
t,
);
const matureIdx = result.indexOf("• Mature themes");
const flashIdx = result.indexOf("• Flashing lights");
const spoilerIdx = result.indexOf("• Spoilers");
expect(matureIdx).toBeGreaterThan(-1);
expect(flashIdx).toBeGreaterThan(matureIdx);
expect(spoilerIdx).toBeGreaterThan(flashIdx);
});
it("renders bilingual EN · VI when output language is vi and tEn is provided (v0.11)", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
contentWarnings: ["jump_scares", "flashing_lights"],
}),
t,
{ tEn },
);
// Header is bilingual: EN / VI
expect(result).toContain("▸ ⚠️ CONTENT WARNINGS / ▸ ⚠️ CẢNH BÁO NỘI DUNG");
// Two-line intro
expect(result).toContain(
"This video contains the following content. Viewer discretion advised.",
);
expect(result).toContain("Video này chứa các nội dung sau");
// Bullets pair EN with VI using U+00B7 MIDDLE DOT
expect(result).toContain("• Jumpscares · Có jumpscare");
expect(result).toContain(
"• Flashing lights — photosensitive viewers take care · Hiệu ứng chớp sáng — người nhạy sáng cẩn thận",
);
});
it("falls back to single-language when tEn is omitted (v0.11 back-compat)", () => {
const t = createMockT("vi");
const result = buildDescription(
makeInput({ language: "vi", contentWarnings: ["jump_scares"] }),
t,
);
// No `· ` separator since tEn is not provided
expect(result).not.toContain(" · ");
expect(result).toContain("▸ ⚠️ CẢNH BÁO NỘI DUNG");
expect(result).toContain("• Có jumpscare");
});
it("censors YouTube-flag-prone Vietnamese terms with asterisks + euphemisms (v0.11 / v0.21.0)", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
contentWarnings: [
"sexual_assault",
"self_harm",
"detailed_killing",
"child_harm",
"war_violence",
"police_violence",
],
}),
t,
{ tEn },
);
// Asterisk-masked terms ARE present (kept from v0.11 baseline)
expect(result).toContain("x*m h*i");
expect(result).toContain("t* tử");
expect(result).toContain("g*ết người");
// v0.21.0: `child_harm` switched from the malformed asterisk pattern
// (`b* ng*y h*i`) to an unambiguous euphemism (`chịu tác động`).
expect(result).toContain("chịu tác động");
// v0.21.0: `bạo lực` → `tác động vật lý` (euphemism) across
// `war_violence`, `police_violence`, `bullying_themes`.
expect(result).toContain("Tác động vật lý liên quan chiến tranh");
expect(result).toContain("Tác động vật lý từ cảnh sát / chính quyền");
// Uncensored terms are NOT present
expect(result).not.toContain("xâm hại");
expect(result).not.toContain("tự tử");
expect(result).not.toContain("giết người");
expect(result).not.toContain("Bạo lực liên quan chiến tranh");
expect(result).not.toContain("Bạo lực từ cảnh sát");
// EN side stays clinical (no censoring needed)
expect(result).toContain("Sexual assault references");
expect(result).toContain("Self-harm / suicide themes");
});
});
describe("buildDescription — v0.25.0 dialogue / internet / suggestive warnings", () => {
it("renders dialogue/language warnings (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["profanity_frequent", "drug_references"] }),
t,
);
expect(result).toContain("▸ ⚠️ CONTENT WARNINGS");
expect(result).toContain("• Frequent profanity / strong language");
expect(result).toContain("• Drug / alcohol references in dialogue");
});
it("renders internet/digital-life warnings (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["cyberbullying", "loot_boxes"] }),
t,
);
expect(result).toContain("• Cyberbullying / online harassment");
expect(result).toContain("• Loot boxes / gacha mechanics");
});
it("renders color phobias without dragging in siblings (en)", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ contentWarnings: ["erythrophobia"] }), t);
expect(result).toContain("• Red / all-red scenes (erythrophobia)");
expect(result).not.toContain("(leukophobia)");
});
it("renders bilingual EN · VI for a new suggestive-imagery warning", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({ language: "vi", contentWarnings: ["sexualized_characters"] }),
t,
{ tEn },
);
expect(result).toContain("• Sexualized character designs · Tạo hình nhân vật bị t*nh d*c hóa");
});
it("masks YouTube-flag-prone Vietnamese terms on the new suggestive warnings", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
contentWarnings: ["sexual_innuendo", "partial_nudity", "sexualized_characters"],
}),
t,
{ tEn },
);
// Masked forms present (v0.21.0 asterisk precedent)
expect(result).toContain("Lời thoại ẩn ý t*nh d*c");
expect(result).toContain("Kh*a th*n một phần");
expect(result).toContain("t*nh d*c hóa");
// Unmasked flag-prone terms absent
expect(result).not.toContain("tình dục");
expect(result).not.toContain("Khỏa thân");
});
it("renders the educational/PSA-purpose disclosure (en)", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({ contentWarnings: ["educational_purpose_only"] }),
t,
);
expect(result).toContain("• Educational / PSA-purpose game");
});
});
describe("buildDescription — gacha_quest video type (v0.9)", () => {
it("dispatches to the per-quest-type intro for main_story", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "gacha_quest",
gachaQuestType: "main_story",
gameName: "Genshin Impact",
chapterName: "Chapter 5 Act 2: Where the Stars Fall",
}),
t,
);
expect(result).toContain(
"Welcome to Chapter 5 Act 2: Where the Stars Fall of Genshin Impact on TestChannel!",
);
});
it("dispatches to the per-quest-type intro for world_quest", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "gacha_quest",
gachaQuestType: "world_quest",
gameName: "Genshin Impact",
questName: "A Solitary Constellation",
}),
t,
);
expect(result).toContain(
'Today\'s video covers the World Quest "A Solitary Constellation" in Genshin Impact on TestChannel.',
);
});
it("dispatches to the per-quest-type intro for endgame", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "gacha_quest",
gachaQuestType: "endgame",
gameName: "Honkai: Star Rail",
chapterName: "Memory of Chaos",
}),
t,
);
expect(result).toContain('Endgame mode "Memory of Chaos" in Honkai: Star Rail on TestChannel.');
});
it("falls back to main_story intro when gachaQuestType is missing", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoType: "gacha_quest",
gameName: "Wuthering Waves",
chapterName: "Chapter 1",
}),
t,
);
expect(result).toContain("Welcome to Chapter 1 of Wuthering Waves on TestChannel!");
});
});
describe("video style era line (v0.22.0)", () => {
it("renders nothing when videoStyleEra is empty", () => {
const t = createMockT("en");
const result = buildDescription(makeInput(), t);
expect(result).not.toMatch(/Edited in /);
});
it("combines era + rig.video_editor into a single style line", () => {
const t = createMockT("en");
const result = buildDescription(
makeInput({
videoStyleEra: "1990s",
rig: { video_editor: "davinci_resolve_studio|19.1" },
}),
t,
);
expect(result).toContain("Edited in 1990s VHS style using DaVinci Resolve Studio 19.1");
});
it("falls back to the editor-less template when rig.video_editor is missing", () => {
const t = createMockT("en");
const result = buildDescription(makeInput({ videoStyleEra: "cinematic" }), t);
expect(result).toContain("Edited in cinematic style");
expect(result).not.toContain(" using ");
});
it("still renders the style line when skipGraphicsSettings is true", () => {
// 2D / pixel-art creators path. The whole graphics block is
// suppressed but the style credit survives as a standalone section.
const t = createMockT("en");
const result = buildDescription(
makeInput({
skipGraphicsSettings: true,
videoStyleEra: "retro",
rig: { video_editor: "capcut|" },
}),
t,
);
expect(result).toContain("VIDEO SETTINGS");
expect(result).toContain("Edited in retro style using CapCut");
// Graphics-specific lines should not appear in skip mode.
expect(result).not.toContain("Video: ");
expect(result).not.toContain("In-game Setting: ");
});
it("silently drops an unrecognised era id (defensive)", () => {
const t = createMockT("en");
const result = buildDescription(
// Force a value that's not in VIDEO_STYLE_ERAS via type-cast.
makeInput({ videoStyleEra: "bogus_era" as never }),
t,
);
expect(result).not.toMatch(/Edited in /);
});
});
describe("buildDescription — translation quality notice (v0.24.0)", () => {
it("renders the bilingual notice for a non-trusted output language when enabled", () => {
const t = createMockT("ja");
const tEn = createMockT("en");
const result = buildDescription(makeInput({ language: "ja" }), t, {
showTranslationQuality: true,
tEn,
});
expect(result).toContain("ABOUT THIS TRANSLATION"); // English header via tEn
expect(result).toContain("翻訳について"); // Japanese header
expect(result).toContain("• Accuracy isn't guaranteed 100%"); // English caveat
expect(result).toContain("正確性は100%保証されません"); // Japanese caveat
});
it("is hidden for trusted output languages (en / vi) even when enabled", () => {
const tEn = createMockT("en");
const en = buildDescription(makeInput({ language: "en" }), createMockT("en"), {
showTranslationQuality: true,
tEn,
});
expect(en).not.toContain("ABOUT THIS TRANSLATION");
const vi = buildDescription(makeInput({ language: "vi" }), createMockT("vi"), {
showTranslationQuality: true,
tEn,
});
expect(vi).not.toContain("VỀ BẢN DỊCH");
expect(vi).not.toContain("ABOUT THIS TRANSLATION");
});
it("is hidden when the toggle is off", () => {
const t = createMockT("ja");
const tEn = createMockT("en");
const result = buildDescription(makeInput({ language: "ja" }), t, {
showTranslationQuality: false,
tEn,
});
expect(result).not.toContain("ABOUT THIS TRANSLATION");
expect(result).not.toContain("翻訳について");
});
});
describe("buildDescription — bilingualContentBlocks gate (v0.29.3)", () => {
it("multi-language tabs: content blocks single-language but translation-quality stays bilingual", () => {
const t = createMockT("ja");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "ja",
contentWarnings: ["flashing_lights"],
techNotes: ["fps_drops_hardware"],
playthroughStatus: "blind",
}),
t,
{ tEn, bilingualContentBlocks: false, showTranslationQuality: true },
);
// Content warnings: JA-only header + no EN pairing.
expect(result).toContain("▸ ⚠️ コンテンツ警告");
expect(result).not.toContain("▸ ⚠️ CONTENT WARNINGS");
expect(result).not.toContain("Flashing lights — photosensitive viewers take care");
// Tech notes: JA-only header + no EN pairing.
expect(result).toContain("▸ 🛠 技術メモ");
expect(result).not.toContain("▸ 🛠 TECH NOTES");
expect(result).not.toContain("FPS drops — caused by hardware (FPS counter visible top-left)");
// Playthrough notes: JA-only header + no EN pairing.
expect(result).toContain("▸ 🎮 プレイ情報");
expect(result).not.toContain("▸ 🎮 PLAYTHROUGH NOTES");
// Translation-quality disclaimer: STILL bilingual (the v0.29.2 goal).
expect(result).toContain("ABOUT THIS TRANSLATION"); // EN header via tEn
expect(result).toContain("翻訳について"); // JA header — proves bilingual
});
it("multi-language tabs: content warnings render single-language with no `· ` separator", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({
language: "vi",
contentWarnings: ["jump_scares", "flashing_lights"],
}),
t,
{ tEn, bilingualContentBlocks: false },
);
expect(result).not.toContain(" · ");
expect(result).toContain("▸ ⚠️ CẢNH BÁO NỘI DUNG");
expect(result).not.toContain("▸ ⚠️ CONTENT WARNINGS");
expect(result).toContain("• Có jumpscare");
});
it("single-language mode (default true): content warnings stay bilingual", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const result = buildDescription(
makeInput({ language: "vi", contentWarnings: ["jump_scares"] }),
t,
{ tEn }, // bilingualContentBlocks omitted → defaults to true
);
expect(result).toContain("▸ ⚠️ CONTENT WARNINGS / ▸ ⚠️ CẢNH BÁO NỘI DUNG");
expect(result).toContain("• Jumpscares · Có jumpscare");
});
it("explicit bilingualContentBlocks:true matches the default", () => {
const t = createMockT("vi");
const tEn = createMockT("en");
const base = makeInput({
language: "vi",
contentWarnings: ["jump_scares"],
techNotes: ["fps_drops_hardware"],
playthroughStatus: "blind",
});
const a = buildDescription(base, t, { tEn });
const b = buildDescription(base, t, { tEn, bilingualContentBlocks: true });
expect(a).toBe(b);
});
});
describe("checkDescriptionWarning", () => {
it("returns null for description under limit", () => {
expect(checkDescriptionWarning("Short description")).toBeNull();
});
it("returns warning for description exceeding 5000 chars", () => {
const longDesc = "A".repeat(5001);
const warning = checkDescriptionWarning(longDesc);
expect(warning).not.toBeNull();
expect(warning!.field).toBe("description");
expect(warning!.limit).toBe(5000);
});
});