feat(registry): the video-primitive moves, documented and customisable

.github/workflows/catalog-previews.yml

@@ -70,9 +70,13 @@ jobs:
         env:
           BASE_SHA: ${{ github.event.pull_request.base.sha }}
         run: |
-          # Find which blocks/components changed in this PR
+          # Find which blocks/components changed in this PR. The trailing slash
+          # in the grep matters: an item is a directory, and a file sitting
+          # directly under registry/components (CATALOG.md) does not match the
+          # sed, so without it the whole path survives and is passed to the
+          # renderer as if it were an item name.
           CHANGED_ITEMS=$(git diff --name-only --diff-filter=ACMR "$BASE_SHA"...HEAD -- registry/blocks/ registry/components/ \
-            | grep -E '^registry/(blocks|components)/' \
+            | grep -E '^registry/(blocks|components)/[^/]+/' \
             | sed 's|^registry/[^/]*/\([^/]*\)/.*|\1|' \
             | sort -u)
 

.github/workflows/ci.yml

@@ -34,6 +34,7 @@ jobs:
       code: ${{ steps.filter.outputs.code }}
       cli: ${{ steps.filter.outputs.cli }}
       skills: ${{ steps.filter.outputs.skills }}
+      catalog_index: ${{ steps.filter.outputs.catalog_index }}
       codex_plugin: ${{ steps.filter.outputs.codex_plugin }}
       gcp_beginframe: ${{ steps.filter.outputs.gcp_beginframe }}
       studio: ${{ steps.filter.outputs.studio }}
@@ -49,6 +50,10 @@ jobs:
         with:
           token: ""
           filters: |
+            catalog_index:
+              - "registry/registry.json"
+              - "registry/catalog-artifact/**"
+              - "scripts/catalog/check-artifact-coverage.ts"
             code:
               - "packages/**"
               - "scripts/**"
@@ -259,6 +264,7 @@ jobs:
       - run: bash scripts/ci/install-workspace-dependencies.sh
       - run: bun run build
       - run: bun run --filter '*' typecheck
+      - run: bun run typecheck:scripts
 
   test:
     name: Test
@@ -284,10 +290,13 @@ jobs:
           node-version: 22
       - uses: ./.github/actions/prepare-ffmpeg-bin
       - run: bash scripts/ci/install-workspace-dependencies.sh
-      - run: bun run test:scripts
       - run: bun run --filter '@hyperframes/{parsers,lint,studio-server}' build
       - run: bun run --cwd packages/core build
       - run: bun run --cwd packages/core build:hyperframes-runtime
+      # After the builds: the preview scripts drive the producer, which imports
+      # @hyperframes/core from dist, so running these first fails on a missing
+      # module rather than on anything the test is actually checking.
+      - run: bun run test:scripts
       - run: bun run --filter '!@hyperframes/producer' test
 
   producer-source-tests:
@@ -359,6 +368,21 @@ jobs:
   # `gen:skills-manifest --check`, which compares per-skill content hashes; the
   # manifest carries no version/timestamp, so it only fails on real content
   # drift. bun runs the TS script directly, no install needed.
+  catalog-index-coverage:
+    name: "Catalog: search index covers the registry"
+    needs: changes
+    if: needs.changes.outputs.catalog_index == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2
+      # Comparing two name lists needs neither the embedding model nor a
+      # network call, so this stays a seconds-long gate. Regenerating the
+      # vectors does need the model, which is why CI checks rather than fixes.
+      - name: Verify every searchable registry item has a vector
+        run: bun scripts/catalog/check-artifact-coverage.ts
+
   skills-manifest:
     name: "Skills: manifest in sync"
     needs: changes

.oxlintrc.json

@@ -11,6 +11,7 @@
     "node_modules/",
     "playground/",
     "packages/producer/tests/**/src/vendor/**",
+    "docs/public/catalog/",
     "registry/blocks/**/lib/*.iife.js",
     "chrome/"
   ],
@@ -34,6 +35,9 @@
     },
     {
       "files": ["docs/snippets/**/*.jsx", "docs/snippets/**/*.tsx"],
+      "globals": {
+        "CodeBlock": "readonly"
+      },
       "rules": {
         "react-hooks/rules-of-hooks": "error",
         "react-hooks/exhaustive-deps": "warn"