Schema validation on every generator + a11y pass on custom forms

Schema rollout (26 pages):
  - One file lib/schemas/generators.ts exporting Zod schemas for every
    generator that uses GeneratorShell with expectJson:true. Schemas are
    deliberately lenient (.passthrough(), most fields optional) so the
    retry only fires on genuinely broken shapes — not pedantic mismatches
    that would burn tokens.
  - Wired into the configs of all generate/* + optimize/* pages.
  - Discriminated unions for tiktok (hooks vs scripts), twitter (thread
    vs tweets), youtube (variants vs scripts vs headlines).
  - Every generator now self-corrects via the retry path added in d1d9da5
    when the model returns the wrong shape.

A11y label/input pairing on the 5 non-shell pages:
  - Settings: htmlFor/id on api-key input (per provider) + model select
  - Setup: htmlFor/id on api-key + website-url + brand-name + aria-label
    on the show/hide-key toggle button
  - Brand/new: aria-label on the Method-1 URL input, file input, and
    stop button (was a tooltip-only "Cancel")
  - Competitors: htmlFor/id on all 5 form fields (our_product, our_usp,
    competitor_name, target_platform, competitor_ads) + sr-only label
    on the library-search input + aria-required on the paste textarea
  - Launch wizard: htmlFor/id on all 6 form fields + role="group" +
    aria-labelledby on the platforms toggle bank + aria-pressed on each
    platform button + py-2 mobile / py-1 desktop touch targets

Smoke filter:
  - Filter the benign "Failed to fetch RSC payload" prefetch race that
    Next 14 emits in Playwright when the test browser closes before a
    Link prefetch lands. Framework falls back to full navigation; not a
    real bug. Without this filter 29/47 routes false-flag.

Tooling:
  - Added @playwright/test as devDep (was an implicit npx download
    before; now an explicit dependency for reproducible smoke runs).

Verified: tsc clean, 53/53 unit tests pass, next build clean, 47/47
Playwright smoke pass against the production build on port 3055.

Author: IamRamgarhia

app/brand/new/page.tsx

@@ -722,13 +722,14 @@ function Inner() {
                 onChange={(e) => setQuickUrl(e.target.value)}
                 onKeyDown={(e) => { if (e.key === "Enter") quickAddFromUrl(); }}
                 disabled={quickBusy}
+                aria-label="Client website URL or business name"
               />
               <button onClick={quickAddFromUrl} disabled={quickBusy || !quickUrl.trim()} className="btn-primary">
                 {quickBusy ? <Loader2 size={11} className="animate-spin" /> : <Plus size={11} />}
                 {quickBusy ? "extracting" : "extract"}
               </button>
               {quickBusy ? (
-                <button onClick={stopExtraction} className="btn-ghost" title="Cancel the extraction (no charge for partial work)">
+                <button onClick={stopExtraction} className="btn-ghost" title="Cancel the extraction (no charge for partial work)" aria-label="Cancel extraction">
                   <StopCircle size={11} /> stop
                 </button>
               ) : null}
@@ -846,13 +847,14 @@ function Inner() {
                 onChange={(e) => setVisionFile(e.target.files?.[0] ?? null)}
                 disabled={quickBusy}
                 className="text-[11px] font-mono text-ink-muted"
+                aria-label="Upload homepage screenshot for vision extraction"
               />
               <button onClick={quickAddFromVision} disabled={quickBusy || !visionFile} className="btn-primary">
                 {quickBusy ? <Loader2 size={11} className="animate-spin" /> : <ImageIcon size={11} />}
                 {quickBusy ? "reading…" : "extract from image"}
               </button>
               {quickBusy ? (
-                <button onClick={stopExtraction} className="btn-ghost" title="Cancel">
+                <button onClick={stopExtraction} className="btn-ghost" title="Cancel" aria-label="Cancel image extraction">
                   <StopCircle size={11} /> stop
                 </button>
               ) : null}

app/generate/branded-hashtag-challenge/page.tsx

@@ -5,6 +5,7 @@ import { Section, Pill, Kv } from "@/components/OutputBlocks";
 import { CopyButton } from "@/components/CopyButton";
 import { buildBhcPrompt, type BhcInput } from "@/lib/prompts/tiktok-bhc";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { BrandedHashtagChallengeSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<BhcInput & Record<string, unknown>> = {
   title: "TikTok Branded Hashtag Challenge",
@@ -34,6 +35,7 @@ const config: GeneratorConfig<BhcInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildBhcPrompt(input as unknown as BhcInput),
   buildTitle: (i: any) => `BHC · ${i.brand}`,
   expectJson: true,
+  schema: BrandedHashtagChallengeSchema,
   renderJson: (json) => <BhcOutput json={json} />,
 };
 

app/generate/creative-prompts/page.tsx

@@ -12,6 +12,7 @@ import {
   type CreativeToolLink,
 } from "@/lib/prompts/creative-prompts";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { CreativePromptsSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<CreativePromptInput & Record<string, unknown>> = {
   title: "AI Creative Prompt Generator",
@@ -89,6 +90,7 @@ const config: GeneratorConfig<CreativePromptInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildCreativePromptPrompt(input as unknown as CreativePromptInput),
   buildTitle: (i: any) => `Creative · ${i.asset_type} · ${i.product?.slice(0, 24)}`,
   expectJson: true,
+  schema: CreativePromptsSchema,
   renderJson: (json) => <CreativePromptOutput json={json} />,
 };
 

app/generate/display/page.tsx

@@ -6,6 +6,7 @@ import { CharBadge } from "@/components/CharBadge";
 import { CopyButton } from "@/components/CopyButton";
 import { buildDisplayPrompt, DISPLAY_SIZES, type DisplayInput } from "@/lib/prompts/display-ads";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { DisplaySchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<DisplayInput & Record<string, unknown>> = {
   title: "Display Banners",
@@ -23,6 +24,7 @@ const config: GeneratorConfig<DisplayInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildDisplayPrompt(input as unknown as DisplayInput),
   buildTitle: (i: any) => `Display · ${i.product}`,
   expectJson: true,
+  schema: DisplaySchema,
   renderJson: (json) => <DisplayOutput json={json} />,
 };
 

app/generate/email-subjects/page.tsx

@@ -6,6 +6,7 @@ import { CharBadge } from "@/components/CharBadge";
 import { CopyButton } from "@/components/CopyButton";
 import { buildEmailSubjectsPrompt, EMAIL_SUBJECT_LIMITS, type EmailSubjectInput } from "@/lib/prompts/email-subjects";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { EmailSubjectsSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<EmailSubjectInput & Record<string, unknown>> = {
   title: "Email subject lines",
@@ -36,6 +37,7 @@ const config: GeneratorConfig<EmailSubjectInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildEmailSubjectsPrompt(input as unknown as EmailSubjectInput),
   buildTitle: (i: any) => `Email · ${i.campaign_type} · ${i.product_or_topic?.slice(0, 24)}`,
   expectJson: true,
+  schema: EmailSubjectsSchema,
   renderJson: (json) => <EmailOutput json={json} />,
 };
 

app/generate/google-pmax/page.tsx

@@ -6,6 +6,7 @@ import { CharBadge } from "@/components/CharBadge";
 import { CopyButton } from "@/components/CopyButton";
 import { buildPmaxPrompt, PMAX_LIMITS, type PmaxInput } from "@/lib/prompts/google-pmax";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { GooglePmaxSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<PmaxInput & Record<string, unknown>> = {
   title: "Google Performance Max",
@@ -35,6 +36,7 @@ const config: GeneratorConfig<PmaxInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildPmaxPrompt(input as unknown as PmaxInput),
   buildTitle: (i: any) => `PMax · ${i.product}`,
   expectJson: true,
+  schema: GooglePmaxSchema,
   renderJson: (json) => <PmaxOutput json={json} />,
 };
 

app/generate/google-shopping/page.tsx

@@ -6,6 +6,7 @@ import { CharBadge } from "@/components/CharBadge";
 import { CopyButton } from "@/components/CopyButton";
 import { buildShoppingPrompt, SHOPPING_LIMITS, type ShoppingInput } from "@/lib/prompts/google-shopping";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { GoogleShoppingSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<ShoppingInput & Record<string, unknown>> = {
   title: "Google Shopping Optimizer",
@@ -28,6 +29,7 @@ const config: GeneratorConfig<ShoppingInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildShoppingPrompt(input as unknown as ShoppingInput),
   buildTitle: (i: any) => `Shopping · ${i.product_title?.slice(0, 30)}`,
   expectJson: true,
+  schema: GoogleShoppingSchema,
   renderJson: (json) => <ShoppingOutput json={json} />,
 };
 

app/generate/google/page.tsx

@@ -12,6 +12,7 @@ import {
   type GoogleRsaOutput,
 } from "@/lib/prompts/google-ads";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { GoogleSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<GoogleRsaInput & Record<string, unknown>> = {
   title: "Google Responsive Search Ad",
@@ -42,6 +43,7 @@ const config: GeneratorConfig<GoogleRsaInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildGoogleRsaPrompt(input as unknown as GoogleRsaInput),
   buildTitle: (input) => `${(input as any).product} — ${(input as any).keyword}`,
   expectJson: true,
+  schema: GoogleSchema,
   renderJson: (json: GoogleRsaOutput) => <RsaOutput json={json} />,
 };
 

app/generate/hashtags/page.tsx

@@ -5,6 +5,7 @@ import { Section, Pill } from "@/components/OutputBlocks";
 import { CopyButton } from "@/components/CopyButton";
 import { buildHashtagPrompt, type HashtagInput } from "@/lib/prompts/hashtags";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { HashtagsSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<HashtagInput & Record<string, unknown>> = {
   title: "Hashtag Generator",
@@ -37,6 +38,7 @@ const config: GeneratorConfig<HashtagInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildHashtagPrompt(input as unknown as HashtagInput),
   buildTitle: (i: any) => `Hashtags · ${i.platform} · ${i.title?.slice(0, 28)}`,
   expectJson: true,
+  schema: HashtagsSchema,
   renderJson: (json) => <HashtagOutput json={json} />,
 };
 

app/generate/lead-form/page.tsx

@@ -5,6 +5,7 @@ import { Section, Pill } from "@/components/OutputBlocks";
 import { CopyButton } from "@/components/CopyButton";
 import { buildLeadFormPrompt, type LeadFormInput } from "@/lib/prompts/lead-form";
 import type { GeneratorConfig } from "@/lib/generator-config";
+import { LeadFormSchema } from "@/lib/schemas/generators";
 
 const config: GeneratorConfig<LeadFormInput & Record<string, unknown>> = {
   title: "Native Lead Form",
@@ -42,6 +43,7 @@ const config: GeneratorConfig<LeadFormInput & Record<string, unknown>> = {
   buildPrompt: (input) => buildLeadFormPrompt(input as unknown as LeadFormInput),
   buildTitle: (i: any) => `Lead Form · ${i.platform} · ${i.offer?.slice(0, 24)}`,
   expectJson: true,
+  schema: LeadFormSchema,
   renderJson: (json) => <LeadFormOutput json={json} />,
 };