themes-art-deco/BUILD_REPORT.md

Art Deco — Build Report

Status: SHIPPED.

Compiled .so produced and the safety check exits 0.

What landed

Plugin metadata (plugin.mod)

• kind = "theme", scope = "@themes", version = "0.1.0".
• categories = ["templates"] (single whitelist entry).
• tags = ["luxury", "gold", "hospitality", "hotel", "wedding", "jewellery", "vintage", "glam", "fine-dining"] (9 tags, within the 5–9 UAT range).
• [compatibility].block_core = ">=0.11.0 <0.12.0".

System & page templates

• System template registered with Key: "art-deco".
• 4 page templates registered:
  • default → slots header, main, footer.
  • landing → slots marquee, main, cta, footer.
  • article → slots header, main, aside, footer.
  • full-width → slots header, main, footer.

Blocks (7, all Source: "art-deco")

Key	Schema	Notes
reservation	schemas/reservation.schema.json	Sticky gold-on-black strip with phone, OpenTable CTA, hours.
menu	schemas/menu.schema.json	Symmetric menu card with rich-text course descriptions and prices.
gallery_fan	schemas/gallery_fan.schema.json	Mirrored gallery framed by sunburst, 2/3/4 columns, collapses to 1 col <640px.
divider_fan	schemas/divider_fan.schema.json	Pure-CSS sunburst / scallop / ziggurat divider — falls back to sunburst on unknown variant.
footer	schemas/footer.schema.json	Centered footer with gold rule, address, reservations email, social row, menu name.
marquee_hero	schemas/marquee_hero.schema.json	Wide hero with stepped ziggurat frame and sunburst overlay.
press_quote	schemas/press_quote.schema.json	Italic Cormorant pull-quote with stars (clamped 0–5).

Schemas are loaded BEFORE any br.Register(...) call (line ordering enforced in register.go).

Template overrides (4)

• heading — caps tracking + hairline gold underline, Italiana display family.
• text — Cormorant body with italic drop-cap on first paragraph.
• button — black pill with gold border, stamped inset shadow on hover/focus.
• image — stepped ziggurat frame variant (also scallop / plain).

Email wrapper

• tr.RegisterEmailWrapper("art-deco", ArtDecoEmailWrapper) wired.
• 600px centered column, ivory body, jet-black masthead.
• Masthead uses a flat-gold SVG <img> (not a CSS gradient) so Outlook renders it correctly.
• Reservation phone / SupportEmail auto-injected as italic postscript line.

Master pages (2)

• art-deco:default-master covers default, article — navbar (header,0), art-deco:divider_fan (header,1,sunburst), slot (main,0,slotName=main), art-deco:footer (footer,0).
• art-deco:marquee-master covers landing, full-width — navbar (marquee,0), art-deco:reservation (marquee,1), slot (main,0,slotName=main), art-deco:divider_fan (cta,0,scallop), art-deco:footer (footer,0).

Presets (presets.json, 3)

• champagne-noir (mode: both, lightColors + darkColors, all 19 tokens each).
• ivory-rose (mode: light, lightColors only, all 19 tokens).
• velvet-onyx (mode: dark, darkColors only, all 19 tokens).
• Every value is an HSL triple H S% L% — no hsl(...) wrappers, no hex.

CSS manifest

• CSSManifest.InputCSSAppend registered via ThemeCSSManifest() in embed.go/registration.go.
• The injected CSS declares @layer utilities blocks for .deco-rule, .deco-frame, .deco-step, .deco-grain, plus aesthetic helpers .deco-foil, .deco-sunburst, .deco-scallop, .deco-ziggurat, .deco-caps, .deco-dropcap, .deco-underline, .deco-pill, .deco-link.
• All colour values consume hsl(var(--token)); all font-family declarations go through var(--font-heading|body|mono, <fallback>).

Fonts policy (Wave-1)

• fonts.json = [] (no bundled woff2s in this pass).
• RECOMMENDED_FONTS.md lists the spec §5 fonts as Google Fonts picker recommendations (Italiana, Cormorant Garamond, JetBrains Mono).
• Fallback stacks for --font-heading, --font-body, --font-mono are embedded inline in every template + utility.

Build output

$ cd ~/src/blockninja/themes/art-deco && go mod tidy
(no output — clean)
$ /home/alex/go/bin/templ generate
(✓) Complete [ updates=13 duration=… ]
$ make
CGO_ENABLED=1 go build -buildmode=plugin -ldflags="-s -w" -o art-deco.so .
$ ls -lh art-deco.so
-rw-rw-r-- 1 alex alex 21M  art-deco.so

Safety check

$ cd ~/src/blockninja/check-safety && go run . ~/src/blockninja/themes/art-deco \
      --plugin-dir ~/src/blockninja/themes/art-deco
…
=== Check 2c: Standalone plugin SDK import boundaries ===
  OK: Standalone plugin imports and go.mod stay on SDK version v0.11.1
=== Check 3: Go code compiles and passes go fix, golangci-lint --fix, go vet, and strict lint ===
  OK: Go lint pipeline clean for 1 module(s)
=== Check 6: No hardcoded colors in frontend (use theme tokens) ===
  OK: No hardcoded colors in .templ files
=== Check 11: No placeholder code; only shipped features ===
  OK: No placeholder code found
…
exit=0

Only WARN remaining is Check 2e (any usage in content map[string]any signatures). This is the exact same warning Gotham emits — it is the standalone-plugin block signature contract and is non-blocking.

Open items / deferred

Wave-1 deferrals (intentional, per themes/docs/FONTS.md)

• No bundled woff2 fonts. Theme ships fonts.json = [] and a RECOMMENDED_FONTS.md for the admin to pick Italiana / Cormorant Garamond / JetBrains Mono from the Google Fonts tab.
• No LICENSES.md — nothing is bundled.

Wave-2 follow-ups (out of scope for this pass)

• Commission a redistributable Art Deco display face (Italiana variants are limited) and bundle via fonts.json if Italiana proves brittle at retina sizes. UAT §11 FOUT timing and the licence audit only become checkable once a face is bundled.
• Capture the 6 UAT marketplace screenshots (docs/uat/art-deco-shots/01..06.png). Requires a running CMS instance — outside the autonomous build scope.
• Seed the "Maison Étoile" demo content (6 pages, 4 courses, 1 press quote, 9 gallery images). Same constraint as above — requires the instance container.
• Run the UAT browser-side gates: WCAG contrast pairs, focus-visible ring sweep, viewport scroll-width checks at 360/768/1024/1440. The CSS is wired to satisfy them but the verification is an instance-side workflow.
• Master-page UAT cell "Replacing art-deco:footer on default-master in admin produces a ghost-free re-render" — admin-side verification, not a build-side check.

Not implemented (called out by spec but explicitly listed in BUILD_REPORT)

• make rebuild and the container deploy targets — by build-instructions, make rebuild is off-limits to the autonomous build pass. The Makefile here ships only all, templ, clean, help — production deploy is reserved for the gotham-style upstream Makefile and a human run.
• Real woff2 bundles in assets/fonts/ — deferred to Wave-2 per FONTS.md.

File inventory

art-deco/
├── BUILD_REPORT.md           ← this file
├── Makefile                  ← local-only build (make, make templ, make clean)
├── RECOMMENDED_FONTS.md      ← Wave-1 Google Fonts picker guide
├── assets/style.css          ← @layer utilities CSS (foil, frame, fan, grain, pill…)
├── button_override.{go,templ,_templ.go}
├── divider_fan.{go,templ,_templ.go}
├── email_wrapper.{templ,_templ.go}
├── embed.go                  ← //go:embed directives + CSSManifest hook
├── fonts.json                ← []
├── footer.{go,templ,_templ.go}
├── gallery_fan.{go,templ,_templ.go}
├── go.{mod,sum}              ← block/core v0.11.1, no replace directives
├── heading_override.{go,templ,_templ.go}
├── helpers.go                ← getString / getInt / getSlice / getStringSlice / clampInt
├── image_override.{go,templ,_templ.go}
├── marquee_hero.{go,templ,_templ.go}
├── menu.{go,templ,_templ.go}
├── plugin.mod                ← TOML metadata, kind=theme
├── presets.json              ← 3 presets, 19 tokens each, HSL triples
├── press_quote.{go,templ,_templ.go}
├── press_quote_helpers.go
├── register.go               ← Register(tr,br) + DefaultMasterPages()
├── registration.go           ← var Registration plugin.PluginRegistration
├── reservation.{go,templ,_templ.go}
├── schemas/
│   ├── divider_fan.schema.json
│   ├── footer.schema.json
│   ├── gallery_fan.schema.json
│   ├── marquee_hero.schema.json
│   ├── menu.schema.json
│   ├── press_quote.schema.json
│   └── reservation.schema.json
├── template.templ + template_templ.go
└── text_override.{go,templ,_templ.go}