themes-y2k/BUILD_REPORT.md

Y2K theme — build report

Implementation pass: 2026-06-06. Reference style: templ (gotham-shaped, per spec §11 "Tech choice").

What landed

Registration (registration.go, register.go)

• Registration exported, Name: "y2k", Version: plugin.ParseModVersion(pluginModBytes).
• tr.RegisterSystemTemplate(Key: "y2k", ...) — exactly one call.
• tr.RegisterPageTemplate("y2k", ...) called four times with slots verbatim:
  • default → ["header", "main", "footer"]
  • landing → ["hero", "marquee", "main", "cta", "footer"]
  • article → ["header", "main", "aside", "footer"]
  • full-width → ["header", "main", "footer"]
• br.LoadSchemasFromFS(Schemas()) invoked once, before any br.Register(...).
• 10 theme blocks registered (unqualified keys, Source: "y2k"): chrome_navbar, metaball_hero, waveform_player, marquee, tracklist, merch_card, webring_badge, glitter_divider, footer_chrome, nft_gallery.
• 4 overrides registered: heading, text, button, image via br.RegisterTemplateOverride("y2k", ...).
• tr.RegisterEmailWrapper("y2k", Y2KEmailWrapper) wired.
• DefaultMasterPages() seeds y2k:default-master (applies to default, article) and y2k:landing-master (applies to landing, full-width) with the exact block order from spec §"Master pages".

Plugin metadata (plugin.mod)

• name = "y2k", display_name = "Y2K" (3 chars, ≤40), scope = "@themes".
• kind = "theme" (per global rule, not "plugin").
• categories = ["templates", "media"] — both whitelisted.
• tags — 8 entries (within the 5–9 UAT range).
• version = "0.1.0".
• [compatibility] block_core = ">=0.11.0 <0.12.0" verbatim.
• Description 157 chars (≤240).

Schemas (schemas/*.schema.json)

• 10 JSON Schema files, all draft-07.
• Property names match content["…"] reads in the Go files one-to-one (no orphans either direction; verified by script during build).
• All x-editor values are members of the whitelist {text, richtext, media, color, select, number, slug, textarea, array, collection, bucket-picker, menu-select, template-select, link}.

Presets (presets.json)

• Exactly 3 entries with id values chrome-dream, cd-rom-after-hours, bubblegum-trapper.
• chrome-dream declares mode: "both" with both lightColors and darkColors blocks (38 tokens across both).
• cd-rom-after-hours declares mode: "dark" with darkColors only.
• bubblegum-trapper declares mode: "light" with lightColors only.
• All 19 tokens present per colour block.
• Every value matches the regex ^\d+ \d+% \d+%$ (HSL triples, no hsl() wrapper). Verified via Python regex check.
• Values copied verbatim from spec §4 tables.

Fonts (fonts.json, RECOMMENDED_FONTS.md)

• fonts.json is [] per the wave-1 policy in themes/docs/FONTS.md.
• RECOMMENDED_FONTS.md lists the spec §5 fonts as Google Fonts picker recommendations (Inter Tight via Google; VT323 via Google as the open-licensed fallback for Stretch Pro; Departure Mono and Stretch Pro as admin uploads).
• All font-family references in templates and CSS go through var(--font-heading|body|mono, <fallback-stack>). The headline heavy fallback stack is "Stretch Pro", "VT323", "Courier New", monospace.

CSS (css.go via CSSManifest.InputCSSAppend)

• Declares --chrome-1..4, --mesh-a/b/c, --bevel-light/dark custom properties on :root and .dark (UAT 13.2, 13.3, 13.4).
• Defines exactly one @keyframes marquee-x, one @keyframes sparkle, one @keyframes metaball-morph block (UAT 13.5).
• Provides utility classes:
  • .y2k-chrome-bg (layered linear gradient through --chrome-1..4).
  • .y2k-mesh-bg (radial-gradient mesh through --mesh-a/b/c).
  • .y2k-bevel (border: 2px solid hsl(var(--border)) + inset shadows using --bevel-light/dark; UAT 13.4).
  • .y2k-button (3D plastic bevel with border-style: solid, border-width: 2px, box-shadow containing inset — UAT 13.9).
  • .y2k-marquee + .y2k-marquee-track with overflow: hidden and the marquee-x animation; animation-play-state: paused on hover/focus (UAT 13.10, 6.7).
  • .y2k-webring-badge at the canonical width: 88px; height: 31px (UAT 13.11).
  • .y2k-foil::after with conic-gradient( and filter: hue-rotate( that activates on :hover (UAT 13.12).
  • .y2k-heading, .y2k-text, .y2k-image-frame, .y2k-sparkle, .y2k-metaball, .y2k-glow.
• Honors prefers-reduced-motion: reduce by disabling marquee, sparkle, and metaball-morph animations (UAT 6.6).
• All colour references go through hsl(var(--token)); no hardcoded hex/rgb appears in any .go or .templ file outside the email wrapper (which uses hex fallbacks that translate the chrome-dream dark preset for Gmail/Outlook compatibility, exactly as gotham does).

Email wrapper

• tr.RegisterEmailWrapper("y2k", Y2KEmailWrapper) registered exactly once.
• 600px centred chrome-bordered card on a near-black background (#0c0820-equivalent sourced from emailCtx.Colors.Background when set, otherwise the chrome-dream dark token value).
• Gradient header bar uses linear-gradient(90deg, primary, secondary).
• Inter Tight body with system fallback stack.
• Marquee footer pill renders the same items as the in-page marquee.
• Plain-text fallback is deferred to the CMS-default stripping (the wrapper receives body already rendered; the marquee items are duplicated into a visible string so a plain-text view still surfaces them).

Build output

$ cd /home/alex/src/blockninja/themes/y2k && go mod tidy
(exit 0)

$ cd /home/alex/src/blockninja/themes/y2k && /home/alex/go/bin/templ generate
(✓) Complete [ updates=16 duration=10ms ]

$ cd /home/alex/src/blockninja/themes/y2k && make
CGO_ENABLED=1 go build -buildmode=plugin -ldflags="-s -w" -o y2k.so .
(exit 0, no warnings)

$ ls -la y2k.so
21,543,872 bytes (≈21 MB)  ELF 64-bit LSB shared object, stripped

make exits 0 with zero warning lines in stdout/stderr (UAT 2.1).

Safety check

$ /tmp/check-safety . --plugin-dir /home/alex/src/blockninja/themes/y2k
(... 22 checks, all OK or SKIP for "no frontend sources" ...)
exit=0

NOTE: the task brief references cd ~/src/blockninja/backend && go run ./cmd/check-safety …. The actual command path on this host is ~/src/blockninja/check-safety/ (no /backend/cmd/ subpath). The invocation above is the host-local equivalent and exits 0.

Specifically verified:

• Check 21 (presets.json validation): OK — single preset file validated.
• Check 22 (no hand-rolled HTML sanitization): OK.
• No git.dev.alexdunmow.com/block/cms/... import boundary violations.
• No ^replace directives in go.mod.
• block/core v0.11.1 pinned to match cms/backend/go.mod.

Open items / deferred

The following spec/UAT requirements are intentionally deferred to a later wave and would block sign-off on the running container but do not block this build pass:

• Bundled woff2 files. Per themes/docs/FONTS.md wave-1 policy this pass ships fonts.json = []. UAT §11 file-existence checks pass trivially. Wave-2 will commission/licence Stretch Pro and Departure Mono and bundle them.
• LICENSES.md — explicitly skipped per FONTS.md wave-1 policy ("No LICENSES.md needed in this pass").
• Marketplace screenshots (marketplace/screenshots/*.png, 1440×900). Not produced in this pass — gated by a running container with deployed CSS.
• Demo content seed ("Static Lagoon" fictional artist with 6 tracks, 4 merch items, 2 zine articles, 5 webring entries). Not produced — the data plane is out of scope for the .so build pass.
• Container-level UAT items: §2.7–2.8 (make rebuild, log scrape), §5.7 (no console errors at the rendered URL), §6.1–6.7 (Lighthouse / computed-style assertions on a running site), §7.1–7.6 (responsive viewport checks), §8.* (rendering each block in three states in the browser), §9.7 (admin-replace round-trip), §10.2–10.4 (Litmus / Gmail / Apple Mail / Outlook 365 previews), §11.4–11.5 (network-tab font 200 checks, FOUT trace), §12.* (marketplace assets, demo seed), §13.1, 13.6 (computed-style assertions on rendered pages), §14.* (three-theme install regression), §15.* (three named reviewer sign-offs).
• Waveform peak-data source. The block ships with a placeholder <canvas data-y2k-waveform> element that the CMS' client runtime can populate via WebAudio decode (deferred to v0.2 per spec open question).
• Cursor-trail sparkle script. Only the CSS classes are shipped; the document-level cursor-trail script is deferred and gated by data-editor-mode on <html> per the spec's open question.
• Mobile menu drawer JS. The chrome navbar exposes the [aria-controls] toggle button required by UAT §7.4 but the drawer-open behaviour is owned by the host menu script.

File inventory

y2k/
├── BUILD_REPORT.md (this file)
├── Makefile
├── RECOMMENDED_FONTS.md
├── assets/
│   └── placeholder.txt
├── button_override.{go,templ,_templ.go}
├── chrome_navbar.{go,templ,_templ.go}
├── css.go
├── email_wrapper.{go,templ,_templ.go}
├── embed.go
├── fonts.json
├── footer_chrome.{go,templ,_templ.go}
├── glitter_divider.{go,templ,_templ.go}
├── go.mod
├── go.sum
├── heading_override.{go,templ,_templ.go}
├── helpers.go
├── image_override.{go,templ,_templ.go}
├── marquee.{go,templ,_templ.go}
├── merch_card.{go,templ,_templ.go}
├── metaball_hero.{go,templ,_templ.go}
├── nft_gallery.{go,templ,_templ.go}
├── plugin.mod
├── presets.json
├── register.go
├── registration.go
├── schemas/
│   ├── chrome_navbar.schema.json
│   ├── footer_chrome.schema.json
│   ├── glitter_divider.schema.json
│   ├── marquee.schema.json
│   ├── merch_card.schema.json
│   ├── metaball_hero.schema.json
│   ├── nft_gallery.schema.json
│   ├── tracklist.schema.json
│   ├── waveform_player.schema.json
│   └── webring_badge.schema.json
├── template.{templ,_templ.go}
├── text_override.{go,templ,_templ.go}
├── tracklist.{go,templ,_templ.go}
├── waveform_player.{go,templ,_templ.go}
├── webring_badge.{go,templ,_templ.go}
└── y2k.so (21 MB)