Skip to content

Add evidence blocks to the marketing grammar - #106

Merged
0thernet merged 1 commit into
mainfrom
task/marketing-evidence-layout
Sep 28, 2026
Merged

0thernet merged 1 commit into
mainfrom
task/marketing-evidence-layout

Conversation

@0thernet

Copy link
Copy Markdown
Member

Summary

  • MarketingDataTable: a captioned, dated evidence table for product pages — numeric column alignment via data-numeric, positive/negative cell tones via data-tone, an honest caveat note, and a bounded internal scroll region so wide tables never cause page-level overflow.
  • MarketingCodeBlock: a shared <pre> wrapper over SyntaxCode so every consumer page gets syntax highlighting by default.
  • Containment fix: unowned direct children of MarketingPage now inherit the shared measure instead of escaping to full bleed — the class of layout bug that produced clipped/full-width content on consumer sites.
  • Raw/compiled parity fix: .hraness-marketing-proof-frame { margin: 0 } (specificity 0,1,0) silently defeated the :where() group's margin-inline: auto in non-compiled delivery, while compiled atoms applied it. Raw rules now use margin-block: 0, and atoms no longer set text-align where the data-numeric grammar must win — the browser suite's 72 delivery-vs-oracle mismatches are resolved to 0.
  • MARKETING_COPY.md documents the new slots (caption = the measurement's name, note = the caveat that bounds the claim).

Test plan

  • bun run check — lint, typecheck, build, StyleX artifact parity + determinism, package smoke, 287 unit tests, full browser matrix (raw / projected / standalone / compiler-foundation)
  • Browser suite delivery-vs-oracle mismatches: 72 → 0
  • Consumer verification: gobstopper site consumes the new blocks on homepage, benchmarks, docs, and compare pages (site PR follows; merge order: this PR first)

Generated with Devin

MarketingDataTable and MarketingCodeBlock give product pages a shared
way to publish dated measurements and runnable commands: captioned
tables with numeric columns, cell tones, an honest caveat note, and
internal scroll containment; code blocks that carry the shared syntax
highlighting and stay inside the measure.

The grammar also closes the containment gap that let unowned direct
children of MarketingPage escape the measure, and fixes raw-CSS
resets (blanket margin: 0) that silently defeated the shared
auto-margin measure in non-compiled delivery. Compiled atoms now leave
text-align to the [data-numeric] grammar rule so attribute hooks work
identically in both delivery modes.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@0thernet
0thernet force-pushed the task/marketing-evidence-layout branch from 1043e85 to 9357150 Compare September 28, 2026 05:25
@0thernet
0thernet enabled auto-merge (squash) September 28, 2026 05:25
@0thernet
0thernet merged commit a4e30f1 into main Sep 28, 2026
5 checks passed
@0thernet
0thernet deleted the task/marketing-evidence-layout branch September 28, 2026 05:36
0thernet added a commit to hraness/gobstopper that referenced this pull request Sep 28, 2026
The previous quiet rewrite shipped unstyled hooks and bypassed the
design system: the proof figure broke the measure with a raw pre
block, benchmark tables had no numeric alignment or containment, and
README-derived code rendered without syntax highlighting.

The homepage now composes MarketingDataTable for the resume-trial
evidence — a captioned, dated table with numeric columns, tone marks,
and an honest caveat — plus MarketingCodeBlock for install commands.
Docs, benchmarks, methodology, and compare routes render through a
shared SiteDocument that emits the embedded plain-publication grammar,
so measure, contents navigation, tables, and highlighted code are
owned by the design kit rather than per-page CSS. The bespoke
document-page stylesheet is removed; readme-html now passes fenced
blocks through the shared highlighter.

Pins @hraness/design-kit to the evidence-grammar commit
(hraness/design-kit#106); update to its release tag once cut.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
0thernet added a commit to hraness/gobstopper that referenced this pull request Sep 28, 2026
The previous quiet rewrite shipped unstyled hooks and bypassed the
design system: the proof figure broke the measure with a raw pre
block, benchmark tables had no numeric alignment or containment, and
README-derived code rendered without syntax highlighting.

The homepage now composes MarketingDataTable for the resume-trial
evidence — a captioned, dated table with numeric columns, tone marks,
and an honest caveat — plus MarketingCodeBlock for install commands.
Docs, benchmarks, methodology, and compare routes render through a
shared SiteDocument that emits the embedded plain-publication grammar,
so measure, contents navigation, tables, and highlighted code are
owned by the design kit rather than per-page CSS. The bespoke
document-page stylesheet is removed; readme-html now passes fenced
blocks through the shared highlighter.

Pins @hraness/design-kit to the evidence-grammar commit
(hraness/design-kit#106); update to its release tag once cut.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
0thernet added a commit to hraness/gobstopper that referenced this pull request Sep 28, 2026
## Summary

Rebuilds the site on the shared design-kit grammar instead of the
bespoke quiet-presentation markup that shipped unstyled hooks.

- Homepage: `MarketingDataTable` presents the resume-trial evidence as a
captioned, dated table with numeric columns and an honest caveat;
`MarketingCodeBlock` gives install/inspect commands shared syntax
highlighting; sections compose the marketing grammar (`ProductHero`,
`MarketingFlow`, `MarketingInterfaceGrid`, `MarketingPrimitives`,
`MarketingTrustBoundary`, `MarketingInstallPanel`,
`MarketingQuestionList`, `MarketingMaker`, `MarketingRelated`) with no
site-owned layout classes.
- Docs, benchmarks, methodology, and compare routes render through a
shared `SiteDocument` emitting the embedded `plain-publication` grammar
— contents nav, measure, styled tables, and highlighted code are owned
by the design kit, separating reference documents from the marketing
composition.
- `readme-html.ts` passes fenced code blocks through the shared
highlighter, so README-derived docs get syntax highlighting.
- `globals.css` drops the bespoke `.document-page` stylesheet; remaining
rules are intentional site-owned hooks (`gob-agent-marks`,
`gob-doc-marks`, `install-note`) plus host-level block spacing for
embedded publications.
- Tests updated for syntax-tokenized markup (assertions strip tags
before comparing command text).

**Dependency:** `@hraness/design-kit` is pinned to `a4e30f1` — the
merged hraness/design-kit#106 commit on main (post-v0.25.0). A follow-up
can move to the release tag once a release containing it is cut.

#### Test plan

- [x] `bun run check` — theme snapshots, readme/blog sync, 45 unit
tests, lint, typecheck, `next build`, built-site runtime tests — all
against the real pinned commit
- [x] Playwright at 1280px and 375px on `/`, `/benchmarks`, `/docs`,
`/compare/*`: zero page-level horizontal overflow; benchmark table
scrolls only inside its ruled region; README code blocks render
syntax-highlighted
- [x] `scrollWidth === innerWidth` at both widths on all six audited
routes

Generated with [Devin](https://devin.ai)

Co-authored-by: 0thernet <894119+0thernet@users.noreply.github.com>
Co-authored-by: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant