Skip to content

feat(registry): mk-* family — 11 minimal presentation-style items (7 blocks, 4 components) - #1992

Merged
miguel-heygen merged 11 commits into
heygen-com:mainfrom
jbernard077:prep/registry-mk-family
Aug 3, 2026
Merged

miguel-heygen merged 11 commits into
heygen-com:mainfrom
jbernard077:prep/registry-mk-family

Conversation

@jbernard077

Copy link
Copy Markdown
Contributor

What

The full mk- family of minimal presentation-style registry items — the planned follow-up to mk-background (#1933), which is the family's backdrop and ships separately.

Blocks (7): mk-specs-list (checklist with draw-on hairlines), mk-callout-highlight (word-sweep karaoke highlight), mk-clone-wall-transition (text clone-wall with mix-blend hard cut), mk-placeholder-grid (rounded media grid with decorative wells), mk-line-graph (1–2 series draw-on graph), mk-progress-stat (count-up stat card), mk-logo-sting (outline logo closer).

Components (4): mk-cta-button (frosted pill CTA), mk-emphasis-type (background emphasis type), mk-pill-callout (capsule callout chip), mk-usage-arc (hairline arc gauge).

  • One shared --mk-* token block per item (ink/paper/accent/shadow/radius…) — hosts re-skin without editing items; every palette value is tokenized, no raw hex outside token declarations
  • Light/dark schemes where the item is scheme-bound; scheme-agnostic overlays documented as such
  • Seek-safe: single paused GSAP timeline per item, seeded RNG, no rAF / Math.random / Date.now

Why

Completes the minimal presentation-style set that #1933 opens: restrained motion, Inter typography, one accent color, capsules and rounded cards. Same clean-room approach — a re-implementation of widely used minimalist presentation conventions; no third-party assets or code copied.

Validation

  • hyperframes lint → 0 errors
  • hyperframes validate (contrast checks enabled) → no console errors, all text passes WCAG AA
  • Layout inspector → 0 issues
  • Determinism spot-check: mix-blend/backdrop-filter effects snapshot byte-identical across independent headless runs

Notes for maintainers

  • 11 commits, one per item — cherry-pickable if you want to take a subset
  • External contribution — catalog PNG/MP4 upload needs a maintainer, per CONTRIBUTING
  • docs/catalog/**/*.mdx pages generated with scripts/generate-catalog-pages.ts; wider regeneration churn (docs.json / catalog-index.json) intentionally not committed, consistent with feat(registry): mk-background — minimal procedural gradient background #1933

🤖 Generated with Claude Code

@jbernard077

Copy link
Copy Markdown
Contributor Author

Preview reel — all 11 items back-to-back (59.9s, rendered with hyperframes render from this branch's item content, on the family's --mk-stage background):

📹 mk-family-preview.mp4 (2.9 MB)

t item
0:00 mk-callout-highlight
0:08 mk-clone-wall-transition
0:10 mk-line-graph
0:17 mk-logo-sting
0:21 mk-placeholder-grid
0:29 mk-progress-stat
0:36 mk-specs-list
0:44 mk-cta-button
0:48 mk-emphasis-type
0:52 mk-pill-callout
0:56 mk-usage-arc

Maintainers: the MP4 is the render source for catalog media if useful — happy to re-render any item solo at whatever spec the catalog pipeline wants.

jbernard077 and others added 11 commits July 6, 2026 12:50
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…tion

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@jbernard077
jbernard077 force-pushed the prep/registry-mk-family branch from d9ac01c to cc98f5f Compare July 6, 2026 16:51
@miguel-heygen
miguel-heygen merged commit 4c54f45 into heygen-com:main Aug 3, 2026
2 checks passed
pull Bot pushed a commit to bhardwajRahul/hyperframes that referenced this pull request Aug 3, 2026
Adds three themed registry families contributed by @jbernard077:

- mk-*  minimal presentation  (7 blocks, 3 components)
- yt-*  retro-broadcast creator (5 blocks, 4 components)
- hw-*  hand-drawn scribble   (6 blocks, 5 components)

Consolidates PRs heygen-com#1933, heygen-com#1992, heygen-com#1993 and heygen-com#1994, cuts 5 of the original 34
items, and fixes the defects that CI never got to report.

Cut (5), each covered by something we already ship or trivial to inline:
- yt-doc-lower-third — would be the 12th name/role lower third next to the
  10 lt-* variants and lower-third-bild
- mk-logo-sting — logo-outro exists, and yt-logo-intro is the richer version
- mk-cta-button, mk-pill-callout, yt-avatar-pip — a styled button, a styled
  chip and a masked circle

Fixes:
- hw-path-text rendered as a solid black blob. #hw-pt-path is the textPath
  carrier and had no rule, so it inherited SVG's default black fill while
  only #hw-pt-guide set fill:none.
- mk-line-graph value labels collided with their own dots and each other.
  Series after the first now label downward, and the offset moved off a CSS
  transform because the entrance tween animates y and GSAP rewrote it.
- Added demo.html for the 11 components and the 3 transparent-root blocks.
  Without it generate-catalog-previews.ts skips components entirely, so the
  catalog-previews job failed for every component in the original PRs.
- Tagged hw-title, hw-pipeline and hw-path-text as overlays.

Also registers all catalog pages in docs.json, which the original PRs left
orphaned, and picks up 4 pre-existing blocks that had no catalog page
(camcorder-hud, editorial-flash-overlay, freeze-frame-dressing,
organic-light-leak-overlay) because the regenerated nav now links them.

Every item was verified by rendering it and looking at the frames.

Co-authored-by: jbernard077 <jbernard077@users.noreply.github.com>
@jbernard077
jbernard077 deleted the prep/registry-mk-family branch August 3, 2026 16:39
dahans-msft2 pushed a commit to dahans-msft2/hyperframes that referenced this pull request Aug 6, 2026
Adds three themed registry families contributed by @jbernard077:

- mk-*  minimal presentation  (7 blocks, 3 components)
- yt-*  retro-broadcast creator (5 blocks, 4 components)
- hw-*  hand-drawn scribble   (6 blocks, 5 components)

Consolidates PRs heygen-com#1933, heygen-com#1992, heygen-com#1993 and heygen-com#1994, cuts 5 of the original 34
items, and fixes the defects that CI never got to report.

Cut (5), each covered by something we already ship or trivial to inline:
- yt-doc-lower-third — would be the 12th name/role lower third next to the
  10 lt-* variants and lower-third-bild
- mk-logo-sting — logo-outro exists, and yt-logo-intro is the richer version
- mk-cta-button, mk-pill-callout, yt-avatar-pip — a styled button, a styled
  chip and a masked circle

Fixes:
- hw-path-text rendered as a solid black blob. #hw-pt-path is the textPath
  carrier and had no rule, so it inherited SVG's default black fill while
  only #hw-pt-guide set fill:none.
- mk-line-graph value labels collided with their own dots and each other.
  Series after the first now label downward, and the offset moved off a CSS
  transform because the entrance tween animates y and GSAP rewrote it.
- Added demo.html for the 11 components and the 3 transparent-root blocks.
  Without it generate-catalog-previews.ts skips components entirely, so the
  catalog-previews job failed for every component in the original PRs.
- Tagged hw-title, hw-pipeline and hw-path-text as overlays.

Also registers all catalog pages in docs.json, which the original PRs left
orphaned, and picks up 4 pre-existing blocks that had no catalog page
(camcorder-hud, editorial-flash-overlay, freeze-frame-dressing,
organic-light-leak-overlay) because the regenerated nav now links them.

Every item was verified by rendering it and looking at the frames.

Co-authored-by: jbernard077 <jbernard077@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.

2 participants