feat: add Stronkter catalog blocks (#570)

## Problem

The Catalog did not include the four prompt-matched Stronkter one-shot HyperFrames projects, and registry metadata only supported a plain author string, so there was no structured way to show creator attribution or the original generation prompt on generated catalog pages.

## What this fixes

- Adds four Catalog blocks matching the provided prompts, in order:
  - `north-korea-locked-down`
  - `apple-money-count`
  - `nyc-paris-flight`
  - `goonvpn-youtube-spot`
- Attributes each block to [Stronkter](https://x.com/Stronkter).
- Stores and renders the original source prompt for each generated catalog page.
- Adds a local realistic map plate for the North Korea block so rendering does not depend on live map tile requests.
- Extends registry item metadata/schema with `authorUrl` and `sourcePrompt`.
- Updates catalog page generation to read items from `registry/registry.json`, keeping generated docs aligned to the public registry manifest.
- Ignores normal browser media preload `net::ERR_ABORTED` request failures for media assets during `hyperframes validate`, while preserving failures for real missing assets.

## Root cause

The imported projects are Catalog-ready compositions, but the registry/docs pipeline did not have first-class source-prompt or linked-author fields to expose creator credit on generated MDX pages. The audio-backed compositions also surfaced a validation edge case: Chrome can report aborted media preload requests as `net::ERR_ABORTED` even when the audio file exists and playback is valid.

## Verification

### Local

- `bun run --filter @hyperframes/cli test src/commands/validate.test.ts`
- `bun run --filter @hyperframes/core test src/registry/types.test.ts`
- `bun run sync-schemas:check`
- `bunx oxlint packages/cli/src/commands/validate.ts packages/cli/src/commands/validate.test.ts packages/core/src/registry/types.ts packages/core/src/registry/types.test.ts scripts/generate-catalog-pages.ts`
- `bunx oxfmt --check ...` on changed source, registry, docs, and composition files
- `git diff --check`
- `bun packages/cli/src/cli.ts lint` and `validate` against temp installed projects for all four blocks
- Lefthook pre-commit: lint/format/typecheck on the initial commit, plus format on the amend
- Lefthook commit-msg: commitlint

### Browser

- Exercised all four blocks through HyperFrames preview routes with `agent-browser`.
- Captured playback screenshots and WebM recordings for:
  - `north-korea-locked-down`
  - `apple-money-count`
  - `nyc-paris-flight`
  - `goonvpn-youtube-spot`

## Notes

- The zip also contained unrelated project directories, but this PR intentionally includes only the four prompt-matched Catalog blocks requested here.
- The imported one-shot compositions may trigger the existing large-composition lint warning, but there are no lint errors and runtime validation passes.
This commit is contained in:
Miguel Ángel
2026-04-29 22:59:19 +02:00
committed by GitHub
parent ea3b708b12
commit 4d05b475f0
27 changed files with 2637 additions and 23 deletions
+5 -1
View File
@@ -212,13 +212,15 @@ describe("registry types", () => {
expect(true).toBe(true);
});
it("optional metadata fields are accepted (author, license, deprecated, minCliVersion)", () => {
it("optional metadata fields are accepted", () => {
const item: ComponentItem = {
name: "shader-wipe",
type: "hyperframes:component",
title: "Shader Wipe",
description: "d",
author: "heygen",
authorUrl: "https://example.com/heygen",
sourcePrompt: "Create a shader wipe.",
license: "Apache-2.0",
minCliVersion: "0.4.0",
deprecated: "Use `shader-wipe-v2` instead.",
@@ -231,6 +233,8 @@ describe("registry types", () => {
],
};
expect(item.author).toBe("heygen");
expect(item.authorUrl).toBe("https://example.com/heygen");
expect(item.sourcePrompt).toBe("Create a shader wipe.");
});
});
});
+4
View File
@@ -48,6 +48,10 @@ interface RegistryItemBase {
tags?: string[];
/** Item author / maintainer. */
author?: string;
/** URL for the author / creator credit. */
authorUrl?: string;
/** Original prompt used to create or inspire the item. */
sourcePrompt?: string;
/** SPDX license identifier. */
license?: string;
/** Minimum `hyperframes` CLI version required to install this item (semver). */