diff --git a/README.md b/README.md
index afd813c..5d4b2c0 100644
--- a/README.md
+++ b/README.md
@@ -13,30 +13,36 @@
- Above: gallery/loop-studio/showcase.gif — a 10-second, 160-frame showcase loop rendered directly by the loop CLI (`seamScore: 1.00`, `duplicateFrames: 0`, `WCAG contrast: 13.7:1`).
+ Above: gallery/loop-studio/showcase.gif — a 10-second, 160-frame showcase loop rendered directly by the loop CLI (`seamScore: 1.032`, `duplicateFrames: 0`, `PASS`).
---
## Gallery
-Every animation below is pure deterministic code (`sketch.js`), measured by `loop audit`, and committed with its exact `showcase.json` or `brief.json`, contact sheet (`sheet.png`), storyboard (`storyboard.png`), and `seam.json`. Pick any folder in [`gallery/`](./gallery), change one number, and re-render.
+Every animation below is pure deterministic code (`sketch.js`), measured by `loop audit`, and committed with its exact `showcase.json` or `brief.json`, contact sheet (`sheet.png`), storyboard (`storyboard.png`), and `seam.json`. Pick any folder in [`gallery/`](./gallery), change one number, and re-render (including `30–60 fps` Animated WebP & MP4).
### Showcase Loops (What a Repository Does)
-| Preview | Subject & Scene Pack | Seam & Audit | Artifacts |
+| Preview | Subject, Scene Pack & Real Use Case | Seam & Audit | Artifacts |
| :--- | :--- | :--- | :--- |
-|
| **Loop Studio Pipeline** (`scenes/flow` · `studio-dark`)
"Loop Studio turns a one-line request into a checked, seamless loop." | `seamScore: 1.00`
`dups: 0` · `PASS` | [showcase.json](./gallery/loop-studio/showcase.json) · [sketch.js](./gallery/loop-studio/sketch.js) · [storyboard.png](./gallery/loop-studio/storyboard.png) · [audit.json](./gallery/loop-studio/audit.json) |
-|
| **Loop CLI Audit Session** (`scenes/terminal` · `phosphor`)
"The loop CLI audits any sketch for seam jumps, caption legibility, and source citations." | `seamScore: 1.02`
`dups: 0` · `PASS` | [showcase.json](./gallery/cli-audit-session/showcase.json) · [sketch.js](./gallery/cli-audit-session/sketch.js) · [storyboard.png](./gallery/cli-audit-session/storyboard.png) · [audit.json](./gallery/cli-audit-session/audit.json) |
+|
| **Loop Studio Pipeline** (`scenes/flow` · `studio-dark`)
**Use case**: README hero diagram explaining an end-to-end tool or compiler pipeline.
"Loop Studio turns a one-line request into a checked, seamless loop." | `10s · 16fps`
`seamScore: 1.032` (`PASS`) | [showcase.json](./gallery/loop-studio/showcase.json) · [sketch.js](./gallery/loop-studio/sketch.js) · [storyboard.png](./gallery/loop-studio/storyboard.png) · [audit.json](./gallery/loop-studio/audit.json) |
+|
| **Loop CLI Audit Session** (`scenes/terminal` · `phosphor`)
**Use case**: CLI documentation showing real flags, terminal telemetry, and pass/fail checks.
"The loop CLI audits any sketch for seam jumps, caption legibility, and source citations." | `10s · 16fps`
`seamScore: 0.989` (`PASS`) | [showcase.json](./gallery/cli-audit-session/showcase.json) · [sketch.js](./gallery/cli-audit-session/sketch.js) · [storyboard.png](./gallery/cli-audit-session/storyboard.png) · [audit.json](./gallery/cli-audit-session/audit.json) |
+|
| **Phase Contract SDK** (`scenes/code` · `studio-dark`)
**Use case**: Library & SDK docs pairing live-stepping code lines with a synchronized state monitor.
"Every Loop Studio sketch exports meta and a pure render(ctx, phase) function." | `10s · 20fps`
`seamScore: 1.006` (`PASS`) | [showcase.json](./gallery/api-pipeline-code/showcase.json) · [sketch.js](./gallery/api-pipeline-code/sketch.js) · [storyboard.png](./gallery/api-pipeline-code/storyboard.png) · [audit.json](./gallery/api-pipeline-code/audit.json) |
+|
| **Agent Orchestrator Mesh** (`scenes/architecture` · `aurora`)
**Use case**: System architecture & multi-agent / MCP service topology diagrams for RFCs & READMEs.
"The Loop Studio orchestrator coordinates the CLI renderer, seam analyzer, and cold-read subagent." | `10s · 20fps`
`seamScore: 0.985` (`PASS`) | [showcase.json](./gallery/mcp-mesh-topology/showcase.json) · [sketch.js](./gallery/mcp-mesh-topology/sketch.js) · [storyboard.png](./gallery/mcp-mesh-topology/storyboard.png) · [audit.json](./gallery/mcp-mesh-topology/audit.json) |
-### Ambient Loops (Mood, Backgrounds & Generative Motion)
+### Ambient Loops (Mood, Backgrounds, 30–60 fps UI & Social Motion)
-| Preview | Style Pack & Prompt | Specs & Seam Score | Artifacts |
+| Preview | Style Pack & Real Use Case | Specs & Seam Score | Artifacts |
| :--- | :--- | :--- | :--- |
-|
| **`styles/particle-orbit`** (`abyss`)
"Make a 4-second square loop. Deep sea, slow, bioluminescent." | `4s · 20fps · 320×320`
`seamScore: 1.00` (`PASS`) | [brief.json](./gallery/deep-sea-orbits/brief.json) · [sketch.js](./gallery/deep-sea-orbits/sketch.js) · [sheet.png](./gallery/deep-sea-orbits/sheet.png) · [seam.json](./gallery/deep-sea-orbits/seam.json) |
-|
| **`styles/flow-field`** (`aurora`)
"Drifting aurora currents, organic silk streamlines, 4-second loop." | `4s · 20fps · 320×320`
`seamScore: 1.02` (`PASS`) | [brief.json](./gallery/aurora-flow-field/brief.json) · [sketch.js](./gallery/aurora-flow-field/sketch.js) · [sheet.png](./gallery/aurora-flow-field/sheet.png) · [seam.json](./gallery/aurora-flow-field/seam.json) |
-|
| **`styles/isometric-grid`** (`nordic`)
"Clean architectural blocks on an isometric grid rising and falling in waves." | `4s · 20fps · 320×320`
`seamScore: 1.00` (`PASS`) | [brief.json](./gallery/nordic-isometric/brief.json) · [sketch.js](./gallery/nordic-isometric/sketch.js) · [sheet.png](./gallery/nordic-isometric/sheet.png) · [seam.json](./gallery/nordic-isometric/seam.json) |
-|
| **`styles/blueprint-cad`** (`blueprint`)
"Precision engineering blueprint with planetary gear linkages at 1x and -2x speeds." | `4s · 20fps · 320×320`
`seamScore: 1.00` (`PASS`) | [brief.json](./gallery/cad-planetary/brief.json) · [sketch.js](./gallery/cad-planetary/sketch.js) · [sheet.png](./gallery/cad-planetary/sheet.png) · [seam.json](./gallery/cad-planetary/seam.json) |
+|
| **`styles/particle-orbit`** (`abyss`)
**Use case**: Calm dark-mode app background, stream overlay, or loading state.
"Deep sea, slow, bioluminescent particle orbits." | `4s · 20fps · 320×320`
`seamScore: 0.972` (`PASS`) | [brief.json](./gallery/deep-sea-orbits/brief.json) · [sketch.js](./gallery/deep-sea-orbits/sketch.js) · [sheet.png](./gallery/deep-sea-orbits/sheet.png) · [seam.json](./gallery/deep-sea-orbits/seam.json) |
+|
| **`styles/flow-field`** (`aurora`)
**Use case**: Organic generative header for landing pages and music visualizers.
"Drifting aurora currents, organic silk streamlines." | `4s · 20fps · 320×320`
`seamScore: 1.037` (`PASS`) | [brief.json](./gallery/aurora-flow-field/brief.json) · [sketch.js](./gallery/aurora-flow-field/sketch.js) · [sheet.png](./gallery/aurora-flow-field/sheet.png) · [seam.json](./gallery/aurora-flow-field/seam.json) |
+|
| **`styles/isometric-grid`** (`nordic`)
**Use case**: Cloud platform, cluster orchestration, or modular infrastructure tile.
"Architectural blocks on an isometric grid rising in waves." | `4s · 20fps · 320×320`
`seamScore: 0.927` (`PASS`) | [brief.json](./gallery/nordic-isometric/brief.json) · [sketch.js](./gallery/nordic-isometric/sketch.js) · [sheet.png](./gallery/nordic-isometric/sheet.png) · [seam.json](./gallery/nordic-isometric/seam.json) |
+|
| **`styles/blueprint-cad`** (`blueprint`)
**Use case**: Robotics, hardware, CAD, and precision engineering project badges.
"Planetary gear linkages rotating at 1x and -2x harmonic speeds." | `4s · 20fps · 320×320`
`seamScore: 1.023` (`PASS`) | [brief.json](./gallery/cad-planetary/brief.json) · [sketch.js](./gallery/cad-planetary/sketch.js) · [sheet.png](./gallery/cad-planetary/sheet.png) · [seam.json](./gallery/cad-planetary/seam.json) |
+|
| **`styles/sdf-raymarch`** (`nebula`)
**Use case**: Zero-dependency 3D product hero & smooth WebP/MP4 shader sculpture.
"30 fps 3D raymarched smooth-union torus and orbiting spheres." | `3s · 30fps · 280×280` (WebP)
`seamScore: 1.061` (`PASS`) | [loop.webp](./gallery/readme-hero-3d/loop.webp) · [loop.gif](./gallery/readme-hero-3d/loop.gif) · [sketch.js](./gallery/readme-hero-3d/sketch.js) · [sheet.png](./gallery/readme-hero-3d/sheet.png) |
+|
| **`styles/dither-mono`** (`amber-crt`)
**Use case**: Low-bandwidth CLI/game splash screen & zero-shimmer retro loader.
"30 fps amber CRT sphere and radar sweep via ordered 4×4 Bayer dithering." | `3s · 30fps · 280×280`
`seamScore: 1.005` (`PASS`) | [loop.gif](./gallery/retro-crt-loader/loop.gif) · [loop.webp](./gallery/retro-crt-loader/loop.webp) · [sketch.js](./gallery/retro-crt-loader/sketch.js) · [sheet.png](./gallery/retro-crt-loader/sheet.png) |
+|
| **`styles/kinetic-type`** (`editorial`)
**Use case**: Silky **60 fps** social release announcement card & talk title slide.
"60 fps editorial kinetic typography wave with WCAG-verified focal pill." | `2s · 60fps · 280×280` (WebP)
`seamScore: 0.987` (`PASS`) | [loop.webp](./gallery/kinetic-release-banner/loop.webp) · [loop.gif](./gallery/kinetic-release-banner/loop.gif) · [sketch.js](./gallery/kinetic-release-banner/sketch.js) · [sheet.png](./gallery/kinetic-release-banner/sheet.png) |
+|
| **`styles/topographic-contour`** (`abyss`)
**Use case**: Geospatial, weather, sonar, and telemetry elevation backgrounds.
"30 fps bathymetric contour isolines over a cyclic scalar noise field." | `3s · 30fps · 280×280`
`seamScore: 0.951` (`PASS`) | [loop.gif](./gallery/sonar-bathymetry/loop.gif) · [loop.webp](./gallery/sonar-bathymetry/loop.webp) · [sketch.js](./gallery/sonar-bathymetry/sketch.js) · [sheet.png](./gallery/sonar-bathymetry/sheet.png) |
---
diff --git a/gallery/api-pipeline-code/audit.json b/gallery/api-pipeline-code/audit.json
new file mode 100644
index 0000000..de6136a
--- /dev/null
+++ b/gallery/api-pipeline-code/audit.json
@@ -0,0 +1,15 @@
+{
+ "id": "api-pipeline-code",
+ "title": "Phase Contract SDK Showcase (Code)",
+ "mode": "showcase",
+ "useCase": "SDK / library docs pairing live-stepping code with a synchronized state monitor",
+ "fps": 20,
+ "pass": true,
+ "seamScore": 1.006,
+ "duplicateFrames": 0,
+ "flickerScore": 0.08,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 2343.8,
+ "totalFrames": 200
+}
diff --git a/gallery/api-pipeline-code/index.html b/gallery/api-pipeline-code/index.html
new file mode 100644
index 0000000..fc9009b
--- /dev/null
+++ b/gallery/api-pipeline-code/index.html
@@ -0,0 +1,120 @@
+
+
+
+
+
+ Phase Contract SDK Showcase (Code) · Loop Studio
+
+
+
+
+
+ Phase Contract SDK Showcase (Code)
+ loading sketch.js...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/gallery/api-pipeline-code/legible.json b/gallery/api-pipeline-code/legible.json
new file mode 100644
index 0000000..9328bdd
--- /dev/null
+++ b/gallery/api-pipeline-code/legible.json
@@ -0,0 +1,71 @@
+{
+ "pass": true,
+ "width": 800,
+ "height": 320,
+ "phoneWidth": 400,
+ "frame0ShowsAllStageLabels": true,
+ "stageLabelsChecked": 4,
+ "captions": [
+ {
+ "step": 1,
+ "caption": "declare duration and fps in meta",
+ "words": 6,
+ "chars": 32,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2.3,
+ "passReadingTime": true,
+ "contrastRatio": 14.25,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ },
+ {
+ "step": 2,
+ "caption": "pass normalized phase to render()",
+ "words": 5,
+ "chars": 33,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2,
+ "passReadingTime": true,
+ "contrastRatio": 14.25,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ },
+ {
+ "step": 3,
+ "caption": "convert phase to integer cycles",
+ "words": 5,
+ "chars": 31,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2,
+ "passReadingTime": true,
+ "contrastRatio": 14.25,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ },
+ {
+ "step": 4,
+ "caption": "last frame meets frame 0 cleanly",
+ "words": 6,
+ "chars": 32,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2.3,
+ "passReadingTime": true,
+ "contrastRatio": 14.25,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ }
+ ],
+ "reasons": []
+}
diff --git a/gallery/api-pipeline-code/loop.gif b/gallery/api-pipeline-code/loop.gif
new file mode 100644
index 0000000..a934b14
Binary files /dev/null and b/gallery/api-pipeline-code/loop.gif differ
diff --git a/gallery/api-pipeline-code/poster.png b/gallery/api-pipeline-code/poster.png
new file mode 100644
index 0000000..1053b88
Binary files /dev/null and b/gallery/api-pipeline-code/poster.png differ
diff --git a/gallery/api-pipeline-code/seam.json b/gallery/api-pipeline-code/seam.json
new file mode 100644
index 0000000..c12908c
--- /dev/null
+++ b/gallery/api-pipeline-code/seam.json
@@ -0,0 +1,215 @@
+{
+ "pass": true,
+ "totalFrames": 200,
+ "seamScore": 1.006,
+ "maxSeamScore": 1.5,
+ "duplicateFrames": 0,
+ "duplicatePairs": [],
+ "flickerScore": 0.08,
+ "maxFlickerScore": 2.5,
+ "medianStepDelta": 0.016208,
+ "seamStepDelta": 0.016312,
+ "normalizedSteps": [
+ 1.006,
+ 0.997,
+ 0.997,
+ 1.001,
+ 1.003,
+ 0.997,
+ 0.997,
+ 0.995,
+ 0.999,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.997,
+ 1.001,
+ 1,
+ 1,
+ 0.994,
+ 0.996,
+ 1.072,
+ 1.072,
+ 1.061,
+ 1.071,
+ 1.068,
+ 1.026,
+ 1.726,
+ 1.001,
+ 1.027,
+ 1.071,
+ 1.075,
+ 1.064,
+ 1.076,
+ 1.076,
+ 0.996,
+ 0.994,
+ 1,
+ 1,
+ 1.001,
+ 0.997,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.999,
+ 0.995,
+ 0.997,
+ 0.997,
+ 1.003,
+ 1.001,
+ 0.997,
+ 0.997,
+ 1.006,
+ 1.006,
+ 0.997,
+ 0.997,
+ 1.001,
+ 1.003,
+ 0.997,
+ 0.997,
+ 0.995,
+ 0.999,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.997,
+ 1.001,
+ 1,
+ 1,
+ 0.994,
+ 0.996,
+ 1.076,
+ 1.076,
+ 1.064,
+ 1.075,
+ 1.071,
+ 1.027,
+ 1.658,
+ 1.001,
+ 1.024,
+ 1.063,
+ 1.067,
+ 1.057,
+ 1.068,
+ 1.068,
+ 0.996,
+ 0.994,
+ 1,
+ 1,
+ 1.001,
+ 0.997,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.999,
+ 0.995,
+ 0.997,
+ 0.997,
+ 1.003,
+ 1.001,
+ 0.997,
+ 0.997,
+ 1.006,
+ 1.006,
+ 0.997,
+ 0.997,
+ 1.001,
+ 1.003,
+ 0.997,
+ 0.997,
+ 0.995,
+ 0.999,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.997,
+ 1.001,
+ 1,
+ 1,
+ 0.994,
+ 0.996,
+ 1.068,
+ 1.068,
+ 1.057,
+ 1.067,
+ 1.063,
+ 1.024,
+ 1.654,
+ 1.001,
+ 1.025,
+ 1.066,
+ 1.069,
+ 1.059,
+ 1.071,
+ 1.071,
+ 0.996,
+ 0.994,
+ 1,
+ 1,
+ 1.001,
+ 0.997,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.999,
+ 0.995,
+ 0.997,
+ 0.997,
+ 1.003,
+ 1.001,
+ 0.997,
+ 0.997,
+ 1.006,
+ 1.006,
+ 0.997,
+ 0.997,
+ 1.001,
+ 1.003,
+ 0.997,
+ 0.997,
+ 0.995,
+ 0.999,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.997,
+ 1.001,
+ 1,
+ 1,
+ 0.994,
+ 0.996,
+ 1.071,
+ 1.071,
+ 1.059,
+ 1.069,
+ 1.066,
+ 1.025,
+ 1.646,
+ 1.001,
+ 1.026,
+ 1.068,
+ 1.071,
+ 1.061,
+ 1.072,
+ 1.072,
+ 0.996,
+ 0.994,
+ 1,
+ 1,
+ 1.001,
+ 0.997,
+ 0.999,
+ 1.003,
+ 0.999,
+ 0.999,
+ 0.995,
+ 0.997,
+ 0.997,
+ 1.003,
+ 1.001,
+ 0.997,
+ 0.997,
+ 1.006
+ ],
+ "reasons": []
+}
diff --git a/gallery/api-pipeline-code/sheet.png b/gallery/api-pipeline-code/sheet.png
new file mode 100644
index 0000000..0c5a90f
Binary files /dev/null and b/gallery/api-pipeline-code/sheet.png differ
diff --git a/gallery/api-pipeline-code/showcase.gif b/gallery/api-pipeline-code/showcase.gif
new file mode 100644
index 0000000..a934b14
Binary files /dev/null and b/gallery/api-pipeline-code/showcase.gif differ
diff --git a/gallery/api-pipeline-code/showcase.json b/gallery/api-pipeline-code/showcase.json
new file mode 100644
index 0000000..466884e
--- /dev/null
+++ b/gallery/api-pipeline-code/showcase.json
@@ -0,0 +1,42 @@
+{
+ "title": "Phase Contract SDK Showcase",
+ "says": "Every Loop Studio sketch exports meta and a pure render(ctx, phase) function.",
+ "seconds": 10,
+ "fps": 20,
+ "width": 800,
+ "height": 320,
+ "palette": "studio-dark",
+ "scene": "code",
+ "stage": [
+ "export const meta = { seconds: 4 };",
+ "export function render(ctx, phase) {",
+ " const a = phase * Math.PI * 2;",
+ " drawOrbit(ctx, a); // seam 1.00"
+ ],
+ "steps": [
+ {
+ "from": 8.75,
+ "to": 1.25,
+ "caption": "declare duration and fps in meta",
+ "source": "rules/AGENTS.md:8"
+ },
+ {
+ "from": 1.25,
+ "to": 3.75,
+ "caption": "pass normalized phase to render()",
+ "source": "rules/AGENTS.md:17"
+ },
+ {
+ "from": 3.75,
+ "to": 6.25,
+ "caption": "convert phase to integer cycles",
+ "source": "skills/loop-math/SKILL.md:22"
+ },
+ {
+ "from": 6.25,
+ "to": 8.75,
+ "caption": "last frame meets frame 0 cleanly",
+ "source": "skills/loop-render/SKILL.md:30"
+ }
+ ]
+}
diff --git a/gallery/api-pipeline-code/sketch.js b/gallery/api-pipeline-code/sketch.js
new file mode 100644
index 0000000..ecc4ff8
--- /dev/null
+++ b/gallery/api-pipeline-code/sketch.js
@@ -0,0 +1,127 @@
+// Scene Pack: code — Stepping code editor + live inspector pane
+export const meta = {
+ mode: "showcase",
+ scene: "code",
+ seconds: 10,
+ fps: 20,
+ width: 800,
+ height: 320,
+ seed: 29,
+ palette: "studio-dark"
+};
+
+export const showcase = {
+ says: "Every Loop Studio sketch exports meta and a pure render(ctx, phase) function.",
+ seconds: 10,
+ scene: "code",
+ stage: [
+ "export const meta = { seconds: 4 };",
+ "export function render(ctx, phase) {",
+ " const a = phase * Math.PI * 2;",
+ " drawOrbit(ctx, a); // seam 1.00"
+ ],
+ steps: [
+ { from: 8.75, to: 1.25, caption: "declare duration and fps in meta", source: "rules/AGENTS.md:8" },
+ { from: 1.25, to: 3.75, caption: "pass normalized phase to render()", source: "rules/AGENTS.md:17" },
+ { from: 3.75, to: 6.25, caption: "convert phase to integer cycles", source: "skills/loop-math/SKILL.md:22" },
+ { from: 6.25, to: 8.75, caption: "last frame meets frame 0 cleanly", source: "skills/loop-render/SKILL.md:30" }
+ ]
+};
+
+export function render(ctx, phase, kit) {
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["studio-dark"];
+ const S = kit.showcase || showcase;
+ const codeLines = S.stage || showcase.stage;
+ const steps = S.steps || showcase.steps;
+ const SECONDS = S.seconds || meta.seconds;
+ const t = phase * SECONDS;
+ const TAU = Math.PI * 2;
+
+ ctx.fillStyle = C.ground;
+ ctx.fillRect(0, 0, W, H);
+
+ const codeW = Math.round(W * 0.56);
+ const paneH = Math.round(H * 0.60);
+ const codeX = Math.round(W * 0.06);
+ const paneY = Math.round(H * 0.08);
+ const inspW = Math.round(W * 0.29);
+ const inspX = codeX + codeW + Math.round(W * 0.03);
+
+ kit.roundRect(ctx, codeX, paneY, codeW, paneH, 10);
+ ctx.fillStyle = C.surface;
+ ctx.fill();
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 1.5;
+ ctx.stroke();
+
+ const rowStep = (paneH - 36) / Math.max(1, codeLines.length);
+ let activeLine = 0;
+ if (t >= 1.25 && t < 3.75) activeLine = 1;
+ else if (t >= 3.75 && t < 6.25) activeLine = 2;
+ else if (t >= 6.25 && t < 8.75) activeLine = 3;
+
+ ctx.font = "500 12.5px monospace";
+ ctx.textAlign = "left";
+ ctx.textBaseline = "middle";
+ codeLines.forEach((line, idx) => {
+ const ly = paneY + 24 + (idx + 0.4) * rowStep;
+ ctx.globalAlpha = 1;
+ ctx.fillStyle = idx === activeLine ? C.body : C.muted;
+ ctx.fillText(line, codeX + 18, ly);
+ });
+
+ // Inspector pane with constant-speed orbital particles
+ ctx.globalAlpha = 1;
+ kit.roundRect(ctx, inspX, paneY, inspW, paneH, 10);
+ ctx.fillStyle = C.surface;
+ ctx.fill();
+ ctx.strokeStyle = C.spark;
+ ctx.lineWidth = 1.5;
+ ctx.stroke();
+
+ const cx = inspX + inspW / 2;
+ const cy = paneY + paneH * 0.5;
+ const r = Math.min(inspW, paneH) * 0.30;
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 2;
+ ctx.beginPath();
+ ctx.arc(cx, cy, r, 0, TAU);
+ ctx.stroke();
+
+ for (let k = 0; k < 3; k++) {
+ const ang = phase * TAU + (k * TAU) / 3;
+ const px = cx + Math.cos(ang) * r;
+ const py = cy + Math.sin(ang) * r;
+ ctx.fillStyle = k === 0 ? C.accent : C.spark;
+ ctx.beginPath();
+ ctx.arc(px, py, Math.max(5, r * 0.2), 0, TAU);
+ ctx.fill();
+ }
+
+ // Fixed caption pill + cross-faded text
+ const capY = Math.round(H * 0.86);
+ const pillW = Math.round(W * 0.62);
+ kit.roundRect(ctx, W / 2 - pillW / 2, capY - 16, pillW, 32, 6);
+ ctx.globalAlpha = 0.95;
+ ctx.fillStyle = C.surface;
+ ctx.fill();
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 1;
+ ctx.stroke();
+
+ ctx.font = "500 13px monospace";
+ ctx.textAlign = "center";
+ ctx.textBaseline = "middle";
+ steps.forEach((c) => {
+ const len = ((c.to - c.from) % SECONDS + SECONDS) % SECONDS || SECONDS;
+ const u = ((t - c.from) % SECONDS + SECONDS) % SECONDS;
+ if (u >= len) return;
+ const fade = Math.max(0.2, Math.min(1, u / 0.35, (len - u) / 0.35));
+ ctx.globalAlpha = fade;
+ ctx.fillStyle = C.body;
+ ctx.fillText(c.caption, W / 2, capY);
+ });
+ ctx.globalAlpha = 1;
+}
diff --git a/gallery/api-pipeline-code/sources.json b/gallery/api-pipeline-code/sources.json
new file mode 100644
index 0000000..bbeb576
--- /dev/null
+++ b/gallery/api-pipeline-code/sources.json
@@ -0,0 +1,40 @@
+{
+ "pass": true,
+ "repoRoot": "/Users/marcusk/.gemini/antigravity/scratch/loop-studio",
+ "checked": 4,
+ "citations": [
+ {
+ "step": 1,
+ "source": "rules/AGENTS.md:8",
+ "file": "rules/AGENTS.md",
+ "line": 8,
+ "excerpt": "",
+ "valid": true
+ },
+ {
+ "step": 2,
+ "source": "rules/AGENTS.md:17",
+ "file": "rules/AGENTS.md",
+ "line": 17,
+ "excerpt": "palette: \"abyss\"",
+ "valid": true
+ },
+ {
+ "step": 3,
+ "source": "skills/loop-math/SKILL.md:22",
+ "file": "skills/loop-math/SKILL.md",
+ "line": 22,
+ "excerpt": "",
+ "valid": true
+ },
+ {
+ "step": 4,
+ "source": "skills/loop-render/SKILL.md:30",
+ "file": "skills/loop-render/SKILL.md",
+ "line": 30,
+ "excerpt": "### 4. Seam Analysis (`loop seam`)",
+ "valid": true
+ }
+ ],
+ "reasons": []
+}
diff --git a/gallery/api-pipeline-code/storyboard.png b/gallery/api-pipeline-code/storyboard.png
new file mode 100644
index 0000000..91e92d9
Binary files /dev/null and b/gallery/api-pipeline-code/storyboard.png differ
diff --git a/gallery/aurora-flow-field/audit.json b/gallery/aurora-flow-field/audit.json
index 4387b42..6caa210 100644
--- a/gallery/aurora-flow-field/audit.json
+++ b/gallery/aurora-flow-field/audit.json
@@ -2,6 +2,8 @@
"id": "aurora-flow-field",
"title": "Arctic Currents (Flow Field)",
"mode": "ambient",
+ "useCase": "Organic generative header for landing pages, music visualizers, and project banners",
+ "fps": 20,
"pass": true,
"seamScore": 1.037,
"duplicateFrames": 0,
diff --git a/gallery/cad-planetary/audit.json b/gallery/cad-planetary/audit.json
index 64c2637..ad3853a 100644
--- a/gallery/cad-planetary/audit.json
+++ b/gallery/cad-planetary/audit.json
@@ -2,6 +2,8 @@
"id": "cad-planetary",
"title": "Epicyclic Telemetry (Blueprint CAD)",
"mode": "ambient",
+ "useCase": "Robotics, hardware, CAD, and precision engineering repo badges",
+ "fps": 20,
"pass": true,
"seamScore": 1.023,
"duplicateFrames": 0,
diff --git a/gallery/cli-audit-session/audit.json b/gallery/cli-audit-session/audit.json
index 7c8ea8c..9a45b0c 100644
--- a/gallery/cli-audit-session/audit.json
+++ b/gallery/cli-audit-session/audit.json
@@ -2,6 +2,8 @@
"id": "cli-audit-session",
"title": "Loop CLI Audit Showcase (Terminal)",
"mode": "showcase",
+ "useCase": "CLI documentation showing commands, flags, and pass/fail audit output",
+ "fps": 16,
"pass": true,
"seamScore": 0.989,
"duplicateFrames": 0,
diff --git a/gallery/cli-audit-session/sources.json b/gallery/cli-audit-session/sources.json
index be2a598..1cd3ef8 100644
--- a/gallery/cli-audit-session/sources.json
+++ b/gallery/cli-audit-session/sources.json
@@ -8,7 +8,7 @@
"source": "docs/tool.md:22",
"file": "docs/tool.md",
"line": 22,
- "excerpt": "Renders all frames `0..N-1` at full resolution and outputs `showcase.gif` / `loop.gif` and `poster.png` (plus `loop.mp4`",
+ "excerpt": "Renders all frames `0..N-1` at full resolution and outputs `showcase.gif` / `loop.gif`, `poster.png`, `loop.mp4` (via FF",
"valid": true
},
{
diff --git a/gallery/deep-sea-orbits/audit.json b/gallery/deep-sea-orbits/audit.json
index b806cb4..371c177 100644
--- a/gallery/deep-sea-orbits/audit.json
+++ b/gallery/deep-sea-orbits/audit.json
@@ -2,6 +2,8 @@
"id": "deep-sea-orbits",
"title": "Abyssal Bioluminescence (Particle Orbit)",
"mode": "ambient",
+ "useCase": "Calm ambient background for dark-mode apps, streams, and loading states",
+ "fps": 20,
"pass": true,
"seamScore": 0.972,
"duplicateFrames": 0,
diff --git a/gallery/kinetic-release-banner/audit.json b/gallery/kinetic-release-banner/audit.json
new file mode 100644
index 0000000..d93dcce
--- /dev/null
+++ b/gallery/kinetic-release-banner/audit.json
@@ -0,0 +1,16 @@
+{
+ "id": "kinetic-release-banner",
+ "title": "Editorial Kinetic Wave (60 fps Type)",
+ "mode": "ambient",
+ "useCase": "60 fps social announcement card, talk title slide, and release launch banner",
+ "fps": 60,
+ "pass": true,
+ "seamScore": 0.987,
+ "duplicateFrames": 0,
+ "flickerScore": 0.238,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 704.1,
+ "webpKB": 691.5,
+ "totalFrames": 120
+}
diff --git a/gallery/kinetic-release-banner/brief.json b/gallery/kinetic-release-banner/brief.json
new file mode 100644
index 0000000..2e3ef24
--- /dev/null
+++ b/gallery/kinetic-release-banner/brief.json
@@ -0,0 +1,12 @@
+{
+ "title": "Editorial Kinetic Wave",
+ "prompt": "Silky 60 fps editorial kinetic typography wave repeating PHASE 0→1.",
+ "mode": "ambient",
+ "style": "kinetic-type",
+ "palette": "editorial",
+ "seconds": 2,
+ "fps": 60,
+ "width": 280,
+ "height": 280,
+ "seed": 61
+}
diff --git a/gallery/kinetic-release-banner/index.html b/gallery/kinetic-release-banner/index.html
new file mode 100644
index 0000000..6a89319
--- /dev/null
+++ b/gallery/kinetic-release-banner/index.html
@@ -0,0 +1,120 @@
+
+
+
+
+
+ Editorial Kinetic Wave (60 fps Type) · Loop Studio
+
+
+
+
+
+ Editorial Kinetic Wave (60 fps Type)
+ loading sketch.js...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/gallery/kinetic-release-banner/legible.json b/gallery/kinetic-release-banner/legible.json
new file mode 100644
index 0000000..1d763f0
--- /dev/null
+++ b/gallery/kinetic-release-banner/legible.json
@@ -0,0 +1,62 @@
+{
+ "pass": true,
+ "mode": "ambient",
+ "textElementsChecked": 9,
+ "captions": [
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 5.19,
+ "minMarginPx": 30,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 17.65,
+ "minMarginPx": 56,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 5.15,
+ "minMarginPx": 71,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 17.34,
+ "minMarginPx": 76,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 16.32,
+ "minMarginPx": 96,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 17.34,
+ "minMarginPx": 96,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 5.15,
+ "minMarginPx": 76,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 17.65,
+ "minMarginPx": 55,
+ "passContrast": true
+ },
+ {
+ "text": "PHASE 0→1",
+ "contrastRatio": 5.19,
+ "minMarginPx": 29,
+ "passContrast": true
+ }
+ ],
+ "reasons": []
+}
diff --git a/gallery/kinetic-release-banner/loop.gif b/gallery/kinetic-release-banner/loop.gif
new file mode 100644
index 0000000..3be310d
Binary files /dev/null and b/gallery/kinetic-release-banner/loop.gif differ
diff --git a/gallery/kinetic-release-banner/loop.webp b/gallery/kinetic-release-banner/loop.webp
new file mode 100644
index 0000000..33b41a2
Binary files /dev/null and b/gallery/kinetic-release-banner/loop.webp differ
diff --git a/gallery/kinetic-release-banner/poster.png b/gallery/kinetic-release-banner/poster.png
new file mode 100644
index 0000000..a91f7d5
Binary files /dev/null and b/gallery/kinetic-release-banner/poster.png differ
diff --git a/gallery/kinetic-release-banner/seam.json b/gallery/kinetic-release-banner/seam.json
new file mode 100644
index 0000000..d959da1
--- /dev/null
+++ b/gallery/kinetic-release-banner/seam.json
@@ -0,0 +1,135 @@
+{
+ "pass": true,
+ "totalFrames": 120,
+ "seamScore": 0.987,
+ "maxSeamScore": 1.5,
+ "duplicateFrames": 0,
+ "duplicatePairs": [],
+ "flickerScore": 0.238,
+ "maxFlickerScore": 2.5,
+ "medianStepDelta": 0.070287,
+ "seamStepDelta": 0.069343,
+ "normalizedSteps": [
+ 0.803,
+ 0.991,
+ 0.901,
+ 0.982,
+ 0.881,
+ 0.992,
+ 0.893,
+ 0.994,
+ 0.945,
+ 1.016,
+ 0.979,
+ 0.939,
+ 1.002,
+ 0.964,
+ 1.074,
+ 1.006,
+ 0.981,
+ 0.982,
+ 1.022,
+ 0.91,
+ 1.009,
+ 1.042,
+ 1.071,
+ 1.024,
+ 0.957,
+ 1.071,
+ 0.992,
+ 1.03,
+ 0.953,
+ 1.105,
+ 1.021,
+ 1.051,
+ 1.007,
+ 0.963,
+ 1.021,
+ 1.03,
+ 0.897,
+ 1.026,
+ 1.093,
+ 0.858,
+ 0.791,
+ 1.029,
+ 0.903,
+ 0.961,
+ 0.912,
+ 0.997,
+ 0.884,
+ 1.106,
+ 0.832,
+ 1.106,
+ 0.984,
+ 0.942,
+ 0.984,
+ 1.063,
+ 0.938,
+ 1.112,
+ 0.905,
+ 1.036,
+ 0.992,
+ 0.985,
+ 0.928,
+ 1.046,
+ 1.01,
+ 1.053,
+ 0.828,
+ 1.09,
+ 0.885,
+ 0.9,
+ 0.97,
+ 1.029,
+ 1.052,
+ 0.96,
+ 0.925,
+ 0.894,
+ 1.124,
+ 0.857,
+ 1.036,
+ 1.036,
+ 1.001,
+ 1.001,
+ 0.961,
+ 1.058,
+ 1.012,
+ 1,
+ 1.078,
+ 1.014,
+ 1.045,
+ 1.006,
+ 0.918,
+ 1.011,
+ 1.024,
+ 1.019,
+ 1.033,
+ 0.919,
+ 0.913,
+ 1.008,
+ 0.884,
+ 0.921,
+ 1.007,
+ 0.769,
+ 0.859,
+ 1.105,
+ 1.007,
+ 0.98,
+ 0.919,
+ 1.105,
+ 0.911,
+ 1.09,
+ 0.893,
+ 1.108,
+ 1.059,
+ 0.992,
+ 0.982,
+ 1.024,
+ 1.014,
+ 1.031,
+ 0.891,
+ 1.106,
+ 1.013,
+ 0.987
+ ],
+ "reasons": []
+}
diff --git a/gallery/kinetic-release-banner/sheet.png b/gallery/kinetic-release-banner/sheet.png
new file mode 100644
index 0000000..4502ba4
Binary files /dev/null and b/gallery/kinetic-release-banner/sheet.png differ
diff --git a/gallery/kinetic-release-banner/sketch.js b/gallery/kinetic-release-banner/sketch.js
new file mode 100644
index 0000000..3dfc206
--- /dev/null
+++ b/gallery/kinetic-release-banner/sketch.js
@@ -0,0 +1,53 @@
+// Style Pack: kinetic-type — Silky 60fps harmonic wave typography poster
+export const meta = {
+ mode: "ambient",
+ style: "kinetic-type",
+ seconds: 2,
+ fps: 60,
+ width: 280,
+ height: 280,
+ seed: 61,
+ palette: "editorial",
+ word: "PHASE 0→1"
+};
+
+export function render(ctx, phase, kit) {
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["editorial"];
+ const TAU = Math.PI * 2;
+ const word = meta.word || "LOOP STUDIO";
+
+ ctx.fillStyle = C.ground;
+ ctx.fillRect(0, 0, W, H);
+
+ const rows = 9;
+ const rowH = (H - 44) / rows;
+ ctx.textAlign = "center";
+ ctx.textBaseline = "middle";
+
+ for (let r = 0; r < rows; r++) {
+ const isCenter = r === Math.floor(rows / 2);
+ const dist = Math.abs(r - Math.floor(rows / 2));
+ const wave = Math.sin(TAU * (phase - r / rows));
+ const x = W / 2 + wave * (isCenter ? 10 : 38);
+ const y = 22 + (r + 0.5) * rowH;
+
+ const pillW = W * (0.68 + 0.14 * (0.5 + 0.5 * Math.cos(TAU * (phase + r / rows))));
+ kit.roundRect(ctx, x - pillW / 2, y - rowH * 0.37, pillW, rowH * 0.74, 6);
+ ctx.globalAlpha = isCenter ? 0.98 : 0.3 + 0.45 * (1 - dist / rows);
+ ctx.fillStyle = isCenter ? C.spark : C.surface;
+ ctx.fill();
+ ctx.strokeStyle = isCenter ? C.accent : C.line;
+ ctx.lineWidth = isCenter ? 2 : 1;
+ ctx.stroke();
+
+ const fontPx = Math.max(10, Math.round(W * (isCenter ? 0.044 : 0.036)));
+ ctx.font = (isCenter ? "700 " : "600 ") + fontPx + "px monospace";
+ ctx.globalAlpha = isCenter ? 1 : 0.5 + 0.5 * (0.5 + 0.5 * wave);
+ ctx.fillStyle = isCenter ? C.ground : r % 2 === 0 ? C.accent : C.body;
+ ctx.fillText(word, x, y);
+ }
+
+ ctx.globalAlpha = 1;
+}
diff --git a/gallery/kinetic-release-banner/sources.json b/gallery/kinetic-release-banner/sources.json
new file mode 100644
index 0000000..3fe0e95
--- /dev/null
+++ b/gallery/kinetic-release-banner/sources.json
@@ -0,0 +1,6 @@
+{
+ "pass": true,
+ "checked": 0,
+ "citations": [],
+ "reasons": []
+}
diff --git a/gallery/loop-studio/audit.json b/gallery/loop-studio/audit.json
index 7915885..a1cd10d 100644
--- a/gallery/loop-studio/audit.json
+++ b/gallery/loop-studio/audit.json
@@ -2,6 +2,8 @@
"id": "loop-studio",
"title": "Loop Studio Showcase (Flow Pipeline)",
"mode": "showcase",
+ "useCase": "README hero diagram explaining what a repo or workflow does end-to-end",
+ "fps": 16,
"pass": true,
"seamScore": 1.032,
"duplicateFrames": 0,
diff --git a/gallery/manifest.json b/gallery/manifest.json
index 744227f..167ced4 100644
--- a/gallery/manifest.json
+++ b/gallery/manifest.json
@@ -1,10 +1,12 @@
{
- "generatedAt": "2026-11-18T16:52:10.718Z",
+ "generatedAt": "2026-11-18T17:55:40.944Z",
"items": [
{
"id": "loop-studio",
"title": "Loop Studio Showcase (Flow Pipeline)",
"mode": "showcase",
+ "useCase": "README hero diagram explaining what a repo or workflow does end-to-end",
+ "fps": 16,
"pass": true,
"seamScore": 1.032,
"duplicateFrames": 0,
@@ -18,6 +20,8 @@
"id": "cli-audit-session",
"title": "Loop CLI Audit Showcase (Terminal)",
"mode": "showcase",
+ "useCase": "CLI documentation showing commands, flags, and pass/fail audit output",
+ "fps": 16,
"pass": true,
"seamScore": 0.989,
"duplicateFrames": 0,
@@ -27,10 +31,42 @@
"gifKB": 1371.6,
"totalFrames": 160
},
+ {
+ "id": "api-pipeline-code",
+ "title": "Phase Contract SDK Showcase (Code)",
+ "mode": "showcase",
+ "useCase": "SDK / library docs pairing live-stepping code with a synchronized state monitor",
+ "fps": 20,
+ "pass": true,
+ "seamScore": 1.006,
+ "duplicateFrames": 0,
+ "flickerScore": 0.08,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 2343.8,
+ "totalFrames": 200
+ },
+ {
+ "id": "mcp-mesh-topology",
+ "title": "Agent Orchestrator Mesh (Architecture)",
+ "mode": "showcase",
+ "useCase": "System architecture & multi-agent/MCP topology diagrams for engineering RFCs",
+ "fps": 20,
+ "pass": true,
+ "seamScore": 0.985,
+ "duplicateFrames": 0,
+ "flickerScore": 0.15,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 1463.6,
+ "totalFrames": 200
+ },
{
"id": "deep-sea-orbits",
"title": "Abyssal Bioluminescence (Particle Orbit)",
"mode": "ambient",
+ "useCase": "Calm ambient background for dark-mode apps, streams, and loading states",
+ "fps": 20,
"pass": true,
"seamScore": 0.972,
"duplicateFrames": 0,
@@ -44,6 +80,8 @@
"id": "aurora-flow-field",
"title": "Arctic Currents (Flow Field)",
"mode": "ambient",
+ "useCase": "Organic generative header for landing pages, music visualizers, and project banners",
+ "fps": 20,
"pass": true,
"seamScore": 1.037,
"duplicateFrames": 0,
@@ -57,6 +95,8 @@
"id": "nordic-isometric",
"title": "Harmonic Architecture (Isometric Grid)",
"mode": "ambient",
+ "useCase": "Infrastructure, cloud platform, and modular architecture hero tiles",
+ "fps": 20,
"pass": true,
"seamScore": 0.927,
"duplicateFrames": 0,
@@ -70,6 +110,8 @@
"id": "cad-planetary",
"title": "Epicyclic Telemetry (Blueprint CAD)",
"mode": "ambient",
+ "useCase": "Robotics, hardware, CAD, and precision engineering repo badges",
+ "fps": 20,
"pass": true,
"seamScore": 1.023,
"duplicateFrames": 0,
@@ -78,6 +120,70 @@
"sourcesPass": true,
"gifKB": 1193.9,
"totalFrames": 80
+ },
+ {
+ "id": "readme-hero-3d",
+ "title": "Nebula SDF Sculpture (3D Raymarch)",
+ "mode": "ambient",
+ "useCase": "Zero-dependency 3D product showcase & smooth shader sculpture for SaaS hero cards",
+ "fps": 30,
+ "pass": true,
+ "seamScore": 1.061,
+ "duplicateFrames": 0,
+ "flickerScore": 0.056,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 822.2,
+ "webpKB": 332.8,
+ "totalFrames": 90
+ },
+ {
+ "id": "retro-crt-loader",
+ "title": "Amber CRT Radar (Bayer Dither)",
+ "mode": "ambient",
+ "useCase": "Low-bandwidth terminal/game splash screen & zero-shimmer retro loading indicator",
+ "fps": 30,
+ "pass": true,
+ "seamScore": 1.005,
+ "duplicateFrames": 0,
+ "flickerScore": 0.114,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 339.2,
+ "webpKB": 2418.4,
+ "totalFrames": 90
+ },
+ {
+ "id": "kinetic-release-banner",
+ "title": "Editorial Kinetic Wave (60 fps Type)",
+ "mode": "ambient",
+ "useCase": "60 fps social announcement card, talk title slide, and release launch banner",
+ "fps": 60,
+ "pass": true,
+ "seamScore": 0.987,
+ "duplicateFrames": 0,
+ "flickerScore": 0.238,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 704.1,
+ "webpKB": 691.5,
+ "totalFrames": 120
+ },
+ {
+ "id": "sonar-bathymetry",
+ "title": "Abyssal Bathymetry (Topographic Isolines)",
+ "mode": "ambient",
+ "useCase": "Geospatial, weather, sonar, and telemetry elevation background loops",
+ "fps": 30,
+ "pass": true,
+ "seamScore": 0.951,
+ "duplicateFrames": 0,
+ "flickerScore": 0.051,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 440.8,
+ "webpKB": 1356.2,
+ "totalFrames": 90
}
]
}
diff --git a/gallery/mcp-mesh-topology/audit.json b/gallery/mcp-mesh-topology/audit.json
new file mode 100644
index 0000000..3e47cd8
--- /dev/null
+++ b/gallery/mcp-mesh-topology/audit.json
@@ -0,0 +1,15 @@
+{
+ "id": "mcp-mesh-topology",
+ "title": "Agent Orchestrator Mesh (Architecture)",
+ "mode": "showcase",
+ "useCase": "System architecture & multi-agent/MCP topology diagrams for engineering RFCs",
+ "fps": 20,
+ "pass": true,
+ "seamScore": 0.985,
+ "duplicateFrames": 0,
+ "flickerScore": 0.15,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 1463.6,
+ "totalFrames": 200
+}
diff --git a/gallery/mcp-mesh-topology/index.html b/gallery/mcp-mesh-topology/index.html
new file mode 100644
index 0000000..354d54f
--- /dev/null
+++ b/gallery/mcp-mesh-topology/index.html
@@ -0,0 +1,120 @@
+
+
+
+
+
+ Agent Orchestrator Mesh (Architecture) · Loop Studio
+
+
+
+
+
+ Agent Orchestrator Mesh (Architecture)
+ loading sketch.js...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/gallery/mcp-mesh-topology/legible.json b/gallery/mcp-mesh-topology/legible.json
new file mode 100644
index 0000000..d63688e
--- /dev/null
+++ b/gallery/mcp-mesh-topology/legible.json
@@ -0,0 +1,71 @@
+{
+ "pass": true,
+ "width": 800,
+ "height": 320,
+ "phoneWidth": 400,
+ "frame0ShowsAllStageLabels": true,
+ "stageLabelsChecked": 4,
+ "captions": [
+ {
+ "step": 1,
+ "caption": "agent scaffolds sketch via loop CLI",
+ "words": 6,
+ "chars": 35,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2.3,
+ "passReadingTime": true,
+ "contrastRatio": 14.86,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ },
+ {
+ "step": 2,
+ "caption": "CLI renders storyboard & frame deltas",
+ "words": 6,
+ "chars": 37,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2.3,
+ "passReadingTime": true,
+ "contrastRatio": 14.86,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ },
+ {
+ "step": 3,
+ "caption": "cold-reader inspects storyboard.png",
+ "words": 3,
+ "chars": 35,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 1.4,
+ "passReadingTime": true,
+ "contrastRatio": 14.86,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ },
+ {
+ "step": 4,
+ "caption": "verified loop.gif & audit return",
+ "words": 5,
+ "chars": 32,
+ "windowSeconds": 2.5,
+ "requiredSeconds": 2,
+ "passReadingTime": true,
+ "contrastRatio": 14.86,
+ "passContrast": true,
+ "minEdgeMarginPx": 37,
+ "phoneFontPx": 6.5,
+ "passMobileWidth": true,
+ "pass": true
+ }
+ ],
+ "reasons": []
+}
diff --git a/gallery/mcp-mesh-topology/loop.gif b/gallery/mcp-mesh-topology/loop.gif
new file mode 100644
index 0000000..1b29e6d
Binary files /dev/null and b/gallery/mcp-mesh-topology/loop.gif differ
diff --git a/gallery/mcp-mesh-topology/poster.png b/gallery/mcp-mesh-topology/poster.png
new file mode 100644
index 0000000..8ae6ccb
Binary files /dev/null and b/gallery/mcp-mesh-topology/poster.png differ
diff --git a/gallery/mcp-mesh-topology/seam.json b/gallery/mcp-mesh-topology/seam.json
new file mode 100644
index 0000000..5e050fa
--- /dev/null
+++ b/gallery/mcp-mesh-topology/seam.json
@@ -0,0 +1,215 @@
+{
+ "pass": true,
+ "totalFrames": 200,
+ "seamScore": 0.985,
+ "maxSeamScore": 1.5,
+ "duplicateFrames": 0,
+ "duplicatePairs": [],
+ "flickerScore": 0.15,
+ "maxFlickerScore": 2.5,
+ "medianStepDelta": 0.012173,
+ "seamStepDelta": 0.011987,
+ "normalizedSteps": [
+ 0.911,
+ 0.923,
+ 0.96,
+ 0.997,
+ 0.996,
+ 0.993,
+ 0.988,
+ 0.986,
+ 0.986,
+ 0.989,
+ 0.993,
+ 0.994,
+ 0.991,
+ 0.99,
+ 0.991,
+ 0.991,
+ 0.977,
+ 0.934,
+ 1.073,
+ 1.096,
+ 1.058,
+ 1.075,
+ 1.086,
+ 1.054,
+ 1.266,
+ 1.026,
+ 1.081,
+ 1.162,
+ 1.164,
+ 1.15,
+ 1.157,
+ 1.162,
+ 1.015,
+ 1.021,
+ 1.029,
+ 1.033,
+ 1.021,
+ 0.962,
+ 0.934,
+ 0.973,
+ 0.897,
+ 0.916,
+ 0.94,
+ 0.993,
+ 1.003,
+ 1,
+ 0.981,
+ 0.928,
+ 0.909,
+ 0.949,
+ 0.923,
+ 0.932,
+ 0.955,
+ 1.01,
+ 1.023,
+ 1.02,
+ 1.015,
+ 1.012,
+ 1.012,
+ 1.014,
+ 1.017,
+ 1.018,
+ 1.017,
+ 1.018,
+ 1.019,
+ 1.017,
+ 0.97,
+ 0.941,
+ 1.095,
+ 1.101,
+ 1.042,
+ 1.067,
+ 1.068,
+ 1.002,
+ 1.211,
+ 0.993,
+ 1.048,
+ 1.132,
+ 1.134,
+ 1.121,
+ 1.128,
+ 1.133,
+ 0.983,
+ 0.989,
+ 0.995,
+ 0.999,
+ 0.983,
+ 0.93,
+ 0.906,
+ 0.935,
+ 0.907,
+ 0.923,
+ 0.95,
+ 1.01,
+ 1.028,
+ 1.025,
+ 1.016,
+ 0.968,
+ 0.928,
+ 0.985,
+ 0.911,
+ 0.923,
+ 0.96,
+ 0.997,
+ 0.996,
+ 0.993,
+ 0.988,
+ 0.986,
+ 0.986,
+ 0.989,
+ 0.993,
+ 0.994,
+ 0.991,
+ 0.99,
+ 0.991,
+ 0.991,
+ 0.977,
+ 0.934,
+ 1.08,
+ 1.102,
+ 1.065,
+ 1.081,
+ 1.092,
+ 1.056,
+ 1.345,
+ 1.026,
+ 1.072,
+ 1.142,
+ 1.143,
+ 1.129,
+ 1.135,
+ 1.139,
+ 1.015,
+ 1.021,
+ 1.029,
+ 1.033,
+ 1.021,
+ 0.962,
+ 0.934,
+ 0.973,
+ 0.897,
+ 0.916,
+ 0.94,
+ 0.993,
+ 1.003,
+ 1,
+ 0.981,
+ 0.928,
+ 0.909,
+ 0.949,
+ 0.923,
+ 0.932,
+ 0.955,
+ 1.01,
+ 1.023,
+ 1.02,
+ 1.015,
+ 1.012,
+ 1.012,
+ 1.014,
+ 1.017,
+ 1.018,
+ 1.017,
+ 1.018,
+ 1.019,
+ 1.017,
+ 0.97,
+ 0.941,
+ 1.07,
+ 1.079,
+ 1.019,
+ 1.044,
+ 1.046,
+ 0.993,
+ 1.325,
+ 0.993,
+ 1.046,
+ 1.126,
+ 1.128,
+ 1.115,
+ 1.122,
+ 1.126,
+ 0.983,
+ 0.989,
+ 0.995,
+ 0.999,
+ 0.983,
+ 0.93,
+ 0.906,
+ 0.935,
+ 0.907,
+ 0.923,
+ 0.95,
+ 1.01,
+ 1.028,
+ 1.025,
+ 1.016,
+ 0.968,
+ 0.928,
+ 0.985
+ ],
+ "reasons": []
+}
diff --git a/gallery/mcp-mesh-topology/sheet.png b/gallery/mcp-mesh-topology/sheet.png
new file mode 100644
index 0000000..f9d2919
Binary files /dev/null and b/gallery/mcp-mesh-topology/sheet.png differ
diff --git a/gallery/mcp-mesh-topology/showcase.gif b/gallery/mcp-mesh-topology/showcase.gif
new file mode 100644
index 0000000..1b29e6d
Binary files /dev/null and b/gallery/mcp-mesh-topology/showcase.gif differ
diff --git a/gallery/mcp-mesh-topology/showcase.json b/gallery/mcp-mesh-topology/showcase.json
new file mode 100644
index 0000000..827b7a8
--- /dev/null
+++ b/gallery/mcp-mesh-topology/showcase.json
@@ -0,0 +1,42 @@
+{
+ "title": "Agent Orchestrator Mesh",
+ "says": "The Loop Studio orchestrator coordinates the CLI renderer, seam analyzer, and cold-read subagent.",
+ "seconds": 10,
+ "fps": 20,
+ "width": 800,
+ "height": 320,
+ "palette": "aurora",
+ "scene": "architecture",
+ "stage": [
+ "Agent",
+ "loop CLI",
+ "Seam Audit",
+ "Cold Reader"
+ ],
+ "steps": [
+ {
+ "from": 8.75,
+ "to": 1.25,
+ "caption": "agent scaffolds sketch via loop CLI",
+ "source": "AGENTS.md:9"
+ },
+ {
+ "from": 1.25,
+ "to": 3.75,
+ "caption": "CLI renders storyboard & frame deltas",
+ "source": "skills/loop-render/SKILL.md:24"
+ },
+ {
+ "from": 3.75,
+ "to": 6.25,
+ "caption": "cold-reader inspects storyboard.png",
+ "source": "agents/loop-cold-reader.md:10"
+ },
+ {
+ "from": 6.25,
+ "to": 8.75,
+ "caption": "verified loop.gif & audit return",
+ "source": "skills/loop-audit/SKILL.md:9"
+ }
+ ]
+}
diff --git a/gallery/mcp-mesh-topology/sketch.js b/gallery/mcp-mesh-topology/sketch.js
new file mode 100644
index 0000000..fd30d7b
--- /dev/null
+++ b/gallery/mcp-mesh-topology/sketch.js
@@ -0,0 +1,109 @@
+// Scene Pack: architecture — Multi-tier topology with request/response packets
+export const meta = {
+ mode: "showcase",
+ scene: "architecture",
+ seconds: 10,
+ fps: 20,
+ width: 800,
+ height: 320,
+ seed: 41,
+ palette: "aurora"
+};
+
+export const showcase = {
+ says: "The Loop Studio orchestrator coordinates the CLI renderer, seam analyzer, and cold-read subagent.",
+ seconds: 10,
+ scene: "architecture",
+ stage: ["Agent", "loop CLI", "Seam Audit", "Cold Reader"],
+ steps: [
+ { from: 8.75, to: 1.25, caption: "agent scaffolds sketch via loop CLI", source: "AGENTS.md:9" },
+ { from: 1.25, to: 3.75, caption: "CLI renders storyboard & frame deltas", source: "skills/loop-render/SKILL.md:24" },
+ { from: 3.75, to: 6.25, caption: "cold-reader inspects storyboard.png", source: "agents/loop-cold-reader.md:10" },
+ { from: 6.25, to: 8.75, caption: "verified loop.gif & audit return", source: "skills/loop-audit/SKILL.md:9" }
+ ]
+};
+
+export function render(ctx, phase, kit) {
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["studio-dark"];
+ const S = kit.showcase || showcase;
+ const labels = S.stage || showcase.stage;
+ const steps = S.steps || showcase.steps;
+ const SECONDS = S.seconds || meta.seconds;
+ const t = phase * SECONDS;
+ const TAU = Math.PI * 2;
+
+ ctx.fillStyle = C.ground;
+ ctx.fillRect(0, 0, W, H);
+
+ const nodes = [
+ { x: Math.round(W * 0.18), y: Math.round(H * 0.38), w: Math.round(W * 0.17), h: Math.round(H * 0.17), label: labels[0] || "Agent", color: C.accent },
+ { x: Math.round(W * 0.48), y: Math.round(H * 0.38), w: Math.round(W * 0.18), h: Math.round(H * 0.17), label: labels[1] || "loop CLI", color: C.body },
+ { x: Math.round(W * 0.80), y: Math.round(H * 0.24), w: Math.round(W * 0.21), h: Math.round(H * 0.15), label: labels[2] || "Seam Audit", color: C.spark },
+ { x: Math.round(W * 0.80), y: Math.round(H * 0.52), w: Math.round(W * 0.21), h: Math.round(H * 0.15), label: labels[3] || "Cold Reader", color: C.spark }
+ ];
+
+ const links = [
+ [0, 1],
+ [1, 2],
+ [1, 3]
+ ];
+
+ links.forEach(([aIdx, bIdx], i) => {
+ const a = nodes[aIdx];
+ const b = nodes[bIdx];
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 2;
+ ctx.beginPath();
+ ctx.moveTo(a.x + a.w / 2, a.y);
+ ctx.lineTo(b.x - b.w / 2, b.y);
+ ctx.stroke();
+
+ const u = (phase * 2 + i * 0.3) % 1;
+ const ping = u < 0.5 ? u * 2 : (1 - u) * 2;
+ const px = (a.x + a.w / 2) + ((b.x - b.w / 2) - (a.x + a.w / 2)) * ping;
+ const py = a.y + (b.y - a.y) * ping;
+ ctx.fillStyle = u < 0.5 ? C.accent : C.spark;
+ ctx.beginPath();
+ ctx.arc(px, py, 5, 0, TAU);
+ ctx.fill();
+ });
+
+ ctx.font = "600 13px monospace";
+ ctx.textAlign = "center";
+ ctx.textBaseline = "middle";
+ nodes.forEach((n) => {
+ kit.roundRect(ctx, n.x - n.w / 2, n.y - n.h / 2, n.w, n.h, 8);
+ ctx.fillStyle = C.surface;
+ ctx.fill();
+ ctx.strokeStyle = n.color;
+ ctx.lineWidth = 2;
+ ctx.stroke();
+
+ ctx.fillStyle = C.body;
+ ctx.fillText(n.label, n.x, n.y);
+ });
+
+ const capY = Math.round(H * 0.86);
+ const pillW = Math.round(W * 0.62);
+ kit.roundRect(ctx, W / 2 - pillW / 2, capY - 16, pillW, 32, 6);
+ ctx.globalAlpha = 0.95;
+ ctx.fillStyle = C.surface;
+ ctx.fill();
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 1;
+ ctx.stroke();
+
+ ctx.font = "500 13px monospace";
+ steps.forEach((c) => {
+ const len = ((c.to - c.from) % SECONDS + SECONDS) % SECONDS || SECONDS;
+ const u = ((t - c.from) % SECONDS + SECONDS) % SECONDS;
+ if (u >= len) return;
+ const fade = Math.max(0.2, Math.min(1, u / 0.35, (len - u) / 0.35));
+ ctx.globalAlpha = fade;
+ ctx.fillStyle = C.body;
+ ctx.fillText(c.caption, W / 2, capY);
+ });
+ ctx.globalAlpha = 1;
+}
diff --git a/gallery/mcp-mesh-topology/sources.json b/gallery/mcp-mesh-topology/sources.json
new file mode 100644
index 0000000..345f562
--- /dev/null
+++ b/gallery/mcp-mesh-topology/sources.json
@@ -0,0 +1,40 @@
+{
+ "pass": true,
+ "repoRoot": "/Users/marcusk/.gemini/antigravity/scratch/loop-studio",
+ "checked": 4,
+ "citations": [
+ {
+ "step": 1,
+ "source": "AGENTS.md:9",
+ "file": "AGENTS.md",
+ "line": 9,
+ "excerpt": "| Command | Purpose | Output |",
+ "valid": true
+ },
+ {
+ "step": 2,
+ "source": "skills/loop-render/SKILL.md:24",
+ "file": "skills/loop-render/SKILL.md",
+ "line": 24,
+ "excerpt": "### 3. Showcase Storyboard (`loop story`)",
+ "valid": true
+ },
+ {
+ "step": 3,
+ "source": "agents/loop-cold-reader.md:10",
+ "file": "agents/loop-cold-reader.md",
+ "line": 10,
+ "excerpt": "## Strict Isolation Rules",
+ "valid": true
+ },
+ {
+ "step": 4,
+ "source": "skills/loop-audit/SKILL.md:9",
+ "file": "skills/loop-audit/SKILL.md",
+ "line": 9,
+ "excerpt": "",
+ "valid": true
+ }
+ ],
+ "reasons": []
+}
diff --git a/gallery/mcp-mesh-topology/storyboard.png b/gallery/mcp-mesh-topology/storyboard.png
new file mode 100644
index 0000000..f0fe104
Binary files /dev/null and b/gallery/mcp-mesh-topology/storyboard.png differ
diff --git a/gallery/nordic-isometric/audit.json b/gallery/nordic-isometric/audit.json
index a9471ff..79f975e 100644
--- a/gallery/nordic-isometric/audit.json
+++ b/gallery/nordic-isometric/audit.json
@@ -2,6 +2,8 @@
"id": "nordic-isometric",
"title": "Harmonic Architecture (Isometric Grid)",
"mode": "ambient",
+ "useCase": "Infrastructure, cloud platform, and modular architecture hero tiles",
+ "fps": 20,
"pass": true,
"seamScore": 0.927,
"duplicateFrames": 0,
diff --git a/gallery/readme-hero-3d/audit.json b/gallery/readme-hero-3d/audit.json
new file mode 100644
index 0000000..15700ba
--- /dev/null
+++ b/gallery/readme-hero-3d/audit.json
@@ -0,0 +1,16 @@
+{
+ "id": "readme-hero-3d",
+ "title": "Nebula SDF Sculpture (3D Raymarch)",
+ "mode": "ambient",
+ "useCase": "Zero-dependency 3D product showcase & smooth shader sculpture for SaaS hero cards",
+ "fps": 30,
+ "pass": true,
+ "seamScore": 1.061,
+ "duplicateFrames": 0,
+ "flickerScore": 0.056,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 822.2,
+ "webpKB": 332.8,
+ "totalFrames": 90
+}
diff --git a/gallery/readme-hero-3d/brief.json b/gallery/readme-hero-3d/brief.json
new file mode 100644
index 0000000..9a776ad
--- /dev/null
+++ b/gallery/readme-hero-3d/brief.json
@@ -0,0 +1,12 @@
+{
+ "title": "Nebula SDF Sculpture",
+ "prompt": "30 fps 3D raymarched smooth-union torus and orbiting spheres in neon nebula lighting.",
+ "mode": "ambient",
+ "style": "sdf-raymarch",
+ "palette": "nebula",
+ "seconds": 3,
+ "fps": 30,
+ "width": 280,
+ "height": 280,
+ "seed": 53
+}
diff --git a/gallery/readme-hero-3d/index.html b/gallery/readme-hero-3d/index.html
new file mode 100644
index 0000000..f8f7815
--- /dev/null
+++ b/gallery/readme-hero-3d/index.html
@@ -0,0 +1,120 @@
+
+
+
+
+
+ Nebula SDF Sculpture (3D Raymarch) · Loop Studio
+
+
+
+
+
+ Nebula SDF Sculpture (3D Raymarch)
+ loading sketch.js...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/gallery/readme-hero-3d/legible.json b/gallery/readme-hero-3d/legible.json
new file mode 100644
index 0000000..58322b2
--- /dev/null
+++ b/gallery/readme-hero-3d/legible.json
@@ -0,0 +1,7 @@
+{
+ "pass": true,
+ "mode": "ambient",
+ "textElementsChecked": 0,
+ "captions": [],
+ "reasons": []
+}
diff --git a/gallery/readme-hero-3d/loop.gif b/gallery/readme-hero-3d/loop.gif
new file mode 100644
index 0000000..453b09d
Binary files /dev/null and b/gallery/readme-hero-3d/loop.gif differ
diff --git a/gallery/readme-hero-3d/loop.webp b/gallery/readme-hero-3d/loop.webp
new file mode 100644
index 0000000..5ab05a8
Binary files /dev/null and b/gallery/readme-hero-3d/loop.webp differ
diff --git a/gallery/readme-hero-3d/poster.png b/gallery/readme-hero-3d/poster.png
new file mode 100644
index 0000000..01cf90a
Binary files /dev/null and b/gallery/readme-hero-3d/poster.png differ
diff --git a/gallery/readme-hero-3d/seam.json b/gallery/readme-hero-3d/seam.json
new file mode 100644
index 0000000..f03d96b
--- /dev/null
+++ b/gallery/readme-hero-3d/seam.json
@@ -0,0 +1,105 @@
+{
+ "pass": true,
+ "totalFrames": 90,
+ "seamScore": 1.061,
+ "maxSeamScore": 1.5,
+ "duplicateFrames": 0,
+ "duplicatePairs": [],
+ "flickerScore": 0.056,
+ "maxFlickerScore": 2.5,
+ "medianStepDelta": 0.129204,
+ "seamStepDelta": 0.137061,
+ "normalizedSteps": [
+ 1.107,
+ 1.121,
+ 1.09,
+ 1.075,
+ 1.066,
+ 1.015,
+ 0.995,
+ 0.951,
+ 0.927,
+ 0.893,
+ 0.902,
+ 0.898,
+ 0.928,
+ 0.941,
+ 0.966,
+ 0.97,
+ 1,
+ 1.037,
+ 1.048,
+ 1.034,
+ 1.034,
+ 1.024,
+ 1.037,
+ 1.029,
+ 1.037,
+ 1.047,
+ 1.055,
+ 1.047,
+ 0.992,
+ 0.981,
+ 0.941,
+ 0.933,
+ 0.919,
+ 0.915,
+ 0.938,
+ 0.94,
+ 0.973,
+ 0.964,
+ 0.964,
+ 0.953,
+ 0.987,
+ 0.976,
+ 1.002,
+ 1.029,
+ 1.051,
+ 1.037,
+ 1.072,
+ 1.081,
+ 1.093,
+ 1.083,
+ 1.045,
+ 1.037,
+ 0.953,
+ 0.903,
+ 0.924,
+ 0.993,
+ 1.064,
+ 1.077,
+ 1.029,
+ 1.014,
+ 0.994,
+ 0.998,
+ 1.01,
+ 1.022,
+ 1,
+ 1.056,
+ 1.097,
+ 1.074,
+ 1.074,
+ 1.115,
+ 1.097,
+ 1.065,
+ 1.056,
+ 1.087,
+ 1.062,
+ 1.008,
+ 0.98,
+ 0.978,
+ 0.963,
+ 0.971,
+ 0.984,
+ 0.963,
+ 0.934,
+ 0.946,
+ 0.922,
+ 0.929,
+ 0.944,
+ 0.964,
+ 0.957,
+ 1.061
+ ],
+ "reasons": []
+}
diff --git a/gallery/readme-hero-3d/sheet.png b/gallery/readme-hero-3d/sheet.png
new file mode 100644
index 0000000..463b745
Binary files /dev/null and b/gallery/readme-hero-3d/sheet.png differ
diff --git a/gallery/readme-hero-3d/sketch.js b/gallery/readme-hero-3d/sketch.js
new file mode 100644
index 0000000..60684da
--- /dev/null
+++ b/gallery/readme-hero-3d/sketch.js
@@ -0,0 +1,111 @@
+// Style Pack: sdf-raymarch — Software-safe 3D Signed Distance Field smooth union with specular & rim glow
+export const meta = {
+ mode: "ambient",
+ style: "sdf-raymarch",
+ seconds: 3,
+ fps: 30,
+ width: 280,
+ height: 280,
+ seed: 53,
+ palette: "nebula"
+};
+
+function smin(a, b, k) {
+ const h = Math.max(k - Math.abs(a - b), 0) / k;
+ return Math.min(a, b) - h * h * k * 0.25;
+}
+
+function sceneSDF(px, py, pz, phase) {
+ const TAU = Math.PI * 2;
+ const a1 = phase * TAU;
+ const c = Math.cos(a1);
+ const s = Math.sin(a1);
+ // Rotate torus across two axes
+ const rx = px * c - pz * s;
+ const rz = px * s + pz * c;
+ const ry = py * Math.cos(a1) - rz * Math.sin(a1);
+ const rz2 = py * Math.sin(a1) + rz * Math.cos(a1);
+
+ const qx = Math.sqrt(rx * rx + rz2 * rz2) - 0.68;
+ const torus = Math.sqrt(qx * qx + ry * ry) - 0.22;
+
+ // 3 orbiting satellite spheres smoothly blending into the torus
+ let d = torus;
+ for (let i = 0; i < 3; i++) {
+ const ang = a1 * 2 + (i * TAU) / 3;
+ const sx = Math.cos(ang) * 0.86;
+ const sy = Math.sin(ang) * 0.86;
+ const sz = Math.sin(a1 + i * 2.094) * 0.36;
+ const dx = px - sx;
+ const dy = py - sy;
+ const dz = pz - sz;
+ const sph = Math.sqrt(dx * dx + dy * dy + dz * dz) - 0.24;
+ d = smin(d, sph, 0.38);
+ }
+ return d;
+}
+
+export function render(ctx, phase, kit) {
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["nebula"];
+
+ if (ctx.createRadialGradient) {
+ const bg = ctx.createRadialGradient(W * 0.5, H * 0.5, 10, W * 0.5, H * 0.5, W * 0.65);
+ bg.addColorStop(0, C.surface);
+ bg.addColorStop(1, C.ground);
+ ctx.fillStyle = bg;
+ } else {
+ ctx.fillStyle = C.ground;
+ }
+ ctx.fillRect(0, 0, W, H);
+
+ const cell = W >= 300 ? 3 : 2;
+ const eps = 0.02;
+
+ for (let y = 0; y < H; y += cell) {
+ const uvY = -((y + cell * 0.5) / H - 0.5) * 2.25;
+ for (let x = 0; x < W; x += cell) {
+ const uvX = ((x + cell * 0.5) / W - 0.5) * 2.25;
+ const roZ = 2.75;
+ const len = Math.sqrt(uvX * uvX + uvY * uvY + 1.85 * 1.85);
+ const rdX = uvX / len;
+ const rdY = uvY / len;
+ const rdZ = -1.85 / len;
+
+ let t = 0;
+ let hit = false;
+ for (let step = 0; step < 24; step++) {
+ const px = rdX * t;
+ const py = rdY * t;
+ const pz = roZ + rdZ * t;
+ const d = sceneSDF(px, py, pz, phase);
+ if (d < 0.018) {
+ hit = true;
+ break;
+ }
+ t += d;
+ if (t > 4.6) break;
+ }
+
+ if (hit) {
+ const px = rdX * t;
+ const py = rdY * t;
+ const pz = roZ + rdZ * t;
+ const d0 = sceneSDF(px, py, pz, phase);
+ const nx = sceneSDF(px + eps, py, pz, phase) - d0;
+ const ny = sceneSDF(px, py + eps, pz, phase) - d0;
+ const nz = sceneSDF(px, py, pz + eps, phase) - d0;
+ const nLen = Math.sqrt(nx * nx + ny * ny + nz * nz) || 1;
+ const lDot = Math.max(0, (nx * 0.55 + ny * 0.62 + nz * 0.56) / nLen);
+ const rim = Math.pow(1 - Math.max(0, nz / nLen), 2.2);
+ const spec = Math.pow(lDot, 8);
+
+ ctx.fillStyle = spec > 0.45 ? C.body : rim > 0.48 ? C.spark : lDot > 0.36 ? C.accent : C.surface;
+ ctx.globalAlpha = Math.min(1, 0.42 + lDot * 0.58 + rim * 0.32);
+ ctx.fillRect(x, y, cell, cell);
+ }
+ }
+ }
+ ctx.globalAlpha = 1;
+}
diff --git a/gallery/readme-hero-3d/sources.json b/gallery/readme-hero-3d/sources.json
new file mode 100644
index 0000000..3fe0e95
--- /dev/null
+++ b/gallery/readme-hero-3d/sources.json
@@ -0,0 +1,6 @@
+{
+ "pass": true,
+ "checked": 0,
+ "citations": [],
+ "reasons": []
+}
diff --git a/gallery/retro-crt-loader/audit.json b/gallery/retro-crt-loader/audit.json
new file mode 100644
index 0000000..cb54aef
--- /dev/null
+++ b/gallery/retro-crt-loader/audit.json
@@ -0,0 +1,16 @@
+{
+ "id": "retro-crt-loader",
+ "title": "Amber CRT Radar (Bayer Dither)",
+ "mode": "ambient",
+ "useCase": "Low-bandwidth terminal/game splash screen & zero-shimmer retro loading indicator",
+ "fps": 30,
+ "pass": true,
+ "seamScore": 1.005,
+ "duplicateFrames": 0,
+ "flickerScore": 0.114,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 339.2,
+ "webpKB": 2418.4,
+ "totalFrames": 90
+}
diff --git a/gallery/retro-crt-loader/brief.json b/gallery/retro-crt-loader/brief.json
new file mode 100644
index 0000000..6123d14
--- /dev/null
+++ b/gallery/retro-crt-loader/brief.json
@@ -0,0 +1,12 @@
+{
+ "title": "Amber CRT Radar",
+ "prompt": "30 fps retro amber CRT sphere and radar sweep using ordered 4x4 Bayer dithering.",
+ "mode": "ambient",
+ "style": "dither-mono",
+ "palette": "amber-crt",
+ "seconds": 3,
+ "fps": 30,
+ "width": 280,
+ "height": 280,
+ "seed": 67
+}
diff --git a/gallery/retro-crt-loader/index.html b/gallery/retro-crt-loader/index.html
new file mode 100644
index 0000000..2b18fce
--- /dev/null
+++ b/gallery/retro-crt-loader/index.html
@@ -0,0 +1,120 @@
+
+
+
+
+
+ Amber CRT Radar (Bayer Dither) · Loop Studio
+
+
+
+
+
+ Amber CRT Radar (Bayer Dither)
+ loading sketch.js...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/gallery/retro-crt-loader/legible.json b/gallery/retro-crt-loader/legible.json
new file mode 100644
index 0000000..d1ac4b0
--- /dev/null
+++ b/gallery/retro-crt-loader/legible.json
@@ -0,0 +1,20 @@
+{
+ "pass": true,
+ "mode": "ambient",
+ "textElementsChecked": 2,
+ "captions": [
+ {
+ "text": "BAYER-4X4 // SYNC",
+ "contrastRatio": 15.31,
+ "minMarginPx": 13,
+ "passContrast": true
+ },
+ {
+ "text": "p:0.00",
+ "contrastRatio": 5.37,
+ "minMarginPx": 10,
+ "passContrast": true
+ }
+ ],
+ "reasons": []
+}
diff --git a/gallery/retro-crt-loader/loop.gif b/gallery/retro-crt-loader/loop.gif
new file mode 100644
index 0000000..8a9644f
Binary files /dev/null and b/gallery/retro-crt-loader/loop.gif differ
diff --git a/gallery/retro-crt-loader/loop.webp b/gallery/retro-crt-loader/loop.webp
new file mode 100644
index 0000000..f905c19
Binary files /dev/null and b/gallery/retro-crt-loader/loop.webp differ
diff --git a/gallery/retro-crt-loader/poster.png b/gallery/retro-crt-loader/poster.png
new file mode 100644
index 0000000..7c982e2
Binary files /dev/null and b/gallery/retro-crt-loader/poster.png differ
diff --git a/gallery/retro-crt-loader/seam.json b/gallery/retro-crt-loader/seam.json
new file mode 100644
index 0000000..ec68cc6
--- /dev/null
+++ b/gallery/retro-crt-loader/seam.json
@@ -0,0 +1,105 @@
+{
+ "pass": true,
+ "totalFrames": 90,
+ "seamScore": 1.005,
+ "maxSeamScore": 1.5,
+ "duplicateFrames": 0,
+ "duplicatePairs": [],
+ "flickerScore": 0.114,
+ "maxFlickerScore": 2.5,
+ "medianStepDelta": 0.056274,
+ "seamStepDelta": 0.056544,
+ "normalizedSteps": [
+ 1.026,
+ 0.928,
+ 1.034,
+ 0.958,
+ 0.933,
+ 0.988,
+ 1.045,
+ 0.984,
+ 1.101,
+ 0.988,
+ 0.999,
+ 0.944,
+ 0.983,
+ 1.061,
+ 1.034,
+ 0.983,
+ 0.985,
+ 1.051,
+ 1.037,
+ 0.994,
+ 0.991,
+ 1.024,
+ 0.925,
+ 1.053,
+ 1.012,
+ 0.907,
+ 0.994,
+ 0.991,
+ 0.966,
+ 1.024,
+ 1.023,
+ 0.945,
+ 1.028,
+ 0.986,
+ 1.022,
+ 0.976,
+ 0.978,
+ 1.05,
+ 0.988,
+ 1.015,
+ 1.024,
+ 0.978,
+ 0.982,
+ 1.034,
+ 0.998,
+ 1.009,
+ 1,
+ 1.002,
+ 0.966,
+ 0.917,
+ 1.058,
+ 0.996,
+ 1.002,
+ 1.022,
+ 1.045,
+ 1.016,
+ 0.973,
+ 0.998,
+ 0.946,
+ 1.076,
+ 0.97,
+ 1.005,
+ 1.071,
+ 0.978,
+ 1.004,
+ 1.008,
+ 1.026,
+ 0.952,
+ 1.013,
+ 1.046,
+ 0.944,
+ 0.998,
+ 0.994,
+ 0.988,
+ 0.948,
+ 1.01,
+ 0.965,
+ 1.039,
+ 1.02,
+ 0.986,
+ 1.013,
+ 1.011,
+ 1.004,
+ 0.999,
+ 1.018,
+ 1.003,
+ 0.938,
+ 1.035,
+ 1.025,
+ 1.005
+ ],
+ "reasons": []
+}
diff --git a/gallery/retro-crt-loader/sheet.png b/gallery/retro-crt-loader/sheet.png
new file mode 100644
index 0000000..3efdc1a
Binary files /dev/null and b/gallery/retro-crt-loader/sheet.png differ
diff --git a/gallery/retro-crt-loader/sketch.js b/gallery/retro-crt-loader/sketch.js
new file mode 100644
index 0000000..98b0961
--- /dev/null
+++ b/gallery/retro-crt-loader/sketch.js
@@ -0,0 +1,70 @@
+// Style Pack: dither-mono — Ordered Bayer 4x4 dithering on a rotating sphere & CRT radar sweep
+export const meta = {
+ mode: "ambient",
+ style: "dither-mono",
+ seconds: 3,
+ fps: 30,
+ width: 280,
+ height: 280,
+ seed: 67,
+ palette: "amber-crt"
+};
+
+export function render(ctx, phase, kit) {
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["amber-crt"];
+ const TAU = Math.PI * 2;
+
+ ctx.fillStyle = C.ground;
+ ctx.fillRect(0, 0, W, H);
+
+ const pixel = W >= 300 ? 4 : 3;
+ const cols = Math.floor(W / pixel);
+ const rows = Math.floor(H / pixel);
+ const lx = Math.cos(TAU * phase);
+ const ly = Math.sin(TAU * phase);
+ const lz = 0.65;
+ const lLen = Math.sqrt(lx * lx + ly * ly + lz * lz);
+
+ for (let gy = 0; gy < rows; gy++) {
+ const ny = (gy / rows - 0.5) * 2.25;
+ for (let gx = 0; gx < cols; gx++) {
+ const nx = (gx / cols - 0.5) * 2.25;
+ const r2 = nx * nx + ny * ny;
+
+ let lum = 0;
+ if (r2 < 0.64) {
+ const nz = Math.sqrt(Math.max(0, 0.64 - r2));
+ const dot = Math.max(0, (nx * lx + ny * ly + nz * lz) / (0.8 * lLen));
+ const ring = 0.5 + 0.5 * Math.sin(TAU * (phase * 2 - Math.sqrt(r2) * 2.4));
+ lum = dot * 0.78 + ring * 0.28;
+ } else {
+ const dist = Math.sqrt(r2);
+ const angle = Math.atan2(ny, nx);
+ const sweep = 0.5 + 0.5 * Math.sin(angle * 3 - TAU * phase * 2);
+ const band = Math.max(0, 1 - Math.abs(dist - 0.94) * 6.5);
+ lum = band * sweep * 0.9;
+ }
+
+ const threshold = kit.dither.bayer4(gx, gy);
+ if (lum > threshold + 0.34) {
+ ctx.fillStyle = C.spark;
+ ctx.fillRect(gx * pixel, gy * pixel, pixel - 1, pixel - 1);
+ } else if (lum > threshold) {
+ ctx.fillStyle = C.accent;
+ ctx.fillRect(gx * pixel, gy * pixel, pixel - 1, pixel - 1);
+ }
+ }
+ }
+
+ // Subtle CRT corner telemetry stamp
+ ctx.font = "600 10px monospace";
+ ctx.fillStyle = C.spark;
+ ctx.textAlign = "left";
+ ctx.textBaseline = "middle";
+ ctx.fillText("BAYER-4X4 // SYNC", 14, 18);
+ ctx.textAlign = "right";
+ ctx.fillStyle = C.muted;
+ ctx.fillText("p:" + phase.toFixed(2), W - 14, H - 16);
+}
diff --git a/gallery/retro-crt-loader/sources.json b/gallery/retro-crt-loader/sources.json
new file mode 100644
index 0000000..3fe0e95
--- /dev/null
+++ b/gallery/retro-crt-loader/sources.json
@@ -0,0 +1,6 @@
+{
+ "pass": true,
+ "checked": 0,
+ "citations": [],
+ "reasons": []
+}
diff --git a/gallery/sonar-bathymetry/audit.json b/gallery/sonar-bathymetry/audit.json
new file mode 100644
index 0000000..5f4ac88
--- /dev/null
+++ b/gallery/sonar-bathymetry/audit.json
@@ -0,0 +1,16 @@
+{
+ "id": "sonar-bathymetry",
+ "title": "Abyssal Bathymetry (Topographic Isolines)",
+ "mode": "ambient",
+ "useCase": "Geospatial, weather, sonar, and telemetry elevation background loops",
+ "fps": 30,
+ "pass": true,
+ "seamScore": 0.951,
+ "duplicateFrames": 0,
+ "flickerScore": 0.051,
+ "legiblePass": true,
+ "sourcesPass": true,
+ "gifKB": 440.8,
+ "webpKB": 1356.2,
+ "totalFrames": 90
+}
diff --git a/gallery/sonar-bathymetry/brief.json b/gallery/sonar-bathymetry/brief.json
new file mode 100644
index 0000000..d61e35e
--- /dev/null
+++ b/gallery/sonar-bathymetry/brief.json
@@ -0,0 +1,12 @@
+{
+ "title": "Abyssal Bathymetry",
+ "prompt": "30 fps animated bathymetric contour isolines over a cyclic scalar noise field.",
+ "mode": "ambient",
+ "style": "topographic-contour",
+ "palette": "abyss",
+ "seconds": 3,
+ "fps": 30,
+ "width": 280,
+ "height": 280,
+ "seed": 83
+}
diff --git a/gallery/sonar-bathymetry/index.html b/gallery/sonar-bathymetry/index.html
new file mode 100644
index 0000000..0ffc9bf
--- /dev/null
+++ b/gallery/sonar-bathymetry/index.html
@@ -0,0 +1,120 @@
+
+
+
+
+
+ Abyssal Bathymetry (Topographic Isolines) · Loop Studio
+
+
+
+
+
+ Abyssal Bathymetry (Topographic Isolines)
+ loading sketch.js...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/gallery/sonar-bathymetry/legible.json b/gallery/sonar-bathymetry/legible.json
new file mode 100644
index 0000000..58322b2
--- /dev/null
+++ b/gallery/sonar-bathymetry/legible.json
@@ -0,0 +1,7 @@
+{
+ "pass": true,
+ "mode": "ambient",
+ "textElementsChecked": 0,
+ "captions": [],
+ "reasons": []
+}
diff --git a/gallery/sonar-bathymetry/loop.gif b/gallery/sonar-bathymetry/loop.gif
new file mode 100644
index 0000000..192a496
Binary files /dev/null and b/gallery/sonar-bathymetry/loop.gif differ
diff --git a/gallery/sonar-bathymetry/loop.webp b/gallery/sonar-bathymetry/loop.webp
new file mode 100644
index 0000000..74d78d5
Binary files /dev/null and b/gallery/sonar-bathymetry/loop.webp differ
diff --git a/gallery/sonar-bathymetry/poster.png b/gallery/sonar-bathymetry/poster.png
new file mode 100644
index 0000000..53b0638
Binary files /dev/null and b/gallery/sonar-bathymetry/poster.png differ
diff --git a/gallery/sonar-bathymetry/seam.json b/gallery/sonar-bathymetry/seam.json
new file mode 100644
index 0000000..1431a79
--- /dev/null
+++ b/gallery/sonar-bathymetry/seam.json
@@ -0,0 +1,105 @@
+{
+ "pass": true,
+ "totalFrames": 90,
+ "seamScore": 0.951,
+ "maxSeamScore": 1.5,
+ "duplicateFrames": 0,
+ "duplicatePairs": [],
+ "flickerScore": 0.051,
+ "maxFlickerScore": 2.5,
+ "medianStepDelta": 0.177524,
+ "seamStepDelta": 0.168777,
+ "normalizedSteps": [
+ 0.944,
+ 0.944,
+ 0.935,
+ 0.982,
+ 1.002,
+ 1.012,
+ 1.032,
+ 1.067,
+ 1.086,
+ 1.099,
+ 1.101,
+ 1.083,
+ 1.077,
+ 1.06,
+ 1.057,
+ 1.062,
+ 1.045,
+ 1.06,
+ 1.052,
+ 1.009,
+ 0.999,
+ 0.938,
+ 0.909,
+ 0.882,
+ 0.867,
+ 0.901,
+ 0.88,
+ 0.9,
+ 0.884,
+ 0.91,
+ 0.902,
+ 0.907,
+ 0.913,
+ 0.964,
+ 0.977,
+ 1.004,
+ 1.004,
+ 1.01,
+ 1.001,
+ 1.024,
+ 1.061,
+ 1.051,
+ 1.023,
+ 0.969,
+ 0.962,
+ 0.976,
+ 1.011,
+ 1.016,
+ 1,
+ 1.009,
+ 0.974,
+ 0.942,
+ 0.963,
+ 0.964,
+ 0.95,
+ 0.965,
+ 0.957,
+ 0.942,
+ 0.944,
+ 0.928,
+ 0.954,
+ 0.973,
+ 0.982,
+ 0.968,
+ 0.957,
+ 0.959,
+ 0.913,
+ 0.939,
+ 0.927,
+ 0.958,
+ 0.964,
+ 1.045,
+ 1.089,
+ 1.08,
+ 1.122,
+ 1.118,
+ 1.078,
+ 1.107,
+ 1.104,
+ 1.103,
+ 1.073,
+ 1.09,
+ 1.071,
+ 1.046,
+ 1.037,
+ 1.079,
+ 1.02,
+ 1.013,
+ 0.973,
+ 0.951
+ ],
+ "reasons": []
+}
diff --git a/gallery/sonar-bathymetry/sheet.png b/gallery/sonar-bathymetry/sheet.png
new file mode 100644
index 0000000..ee37b3c
Binary files /dev/null and b/gallery/sonar-bathymetry/sheet.png differ
diff --git a/gallery/sonar-bathymetry/sketch.js b/gallery/sonar-bathymetry/sketch.js
new file mode 100644
index 0000000..da930e3
--- /dev/null
+++ b/gallery/sonar-bathymetry/sketch.js
@@ -0,0 +1,75 @@
+// Style Pack: topographic-contour — Cyclic elevation isolines with sonar sweep ticks
+export const meta = {
+ mode: "ambient",
+ style: "topographic-contour",
+ seconds: 3,
+ fps: 30,
+ width: 280,
+ height: 280,
+ seed: 83,
+ palette: "abyss"
+};
+
+function field(nx, ny, cx, cy, kit, seed) {
+ const n1 = kit.noise2D(nx * 2.2 + cx, ny * 2.2 + cy, seed);
+ const n2 = 0.5 * kit.noise2D(nx * 4.4 - cy, ny * 4.4 + cx, seed + 13);
+ const r = Math.sqrt((nx - 0.5) * (nx - 0.5) + (ny - 0.5) * (ny - 0.5));
+ return (n1 + n2) * 0.5 + (0.5 - r);
+}
+
+export function render(ctx, phase, kit) {
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["abyss"];
+ const TAU = Math.PI * 2;
+
+ ctx.fillStyle = C.ground;
+ ctx.fillRect(0, 0, W, H);
+
+ const cx = Math.cos(TAU * phase) * 0.72;
+ const cy = Math.sin(TAU * phase) * 0.72;
+ const step = W >= 300 ? 4 : 3;
+ const cols = Math.floor(W / step);
+ const rows = Math.floor(H / step);
+ const bands = 9;
+
+ const grid = new Int16Array(cols * rows);
+ for (let j = 0; j < rows; j++) {
+ for (let i = 0; i < cols; i++) {
+ const val = field(i / cols, j / rows, cx, cy, kit, meta.seed);
+ grid[j * cols + i] = Math.floor((val + 1) * bands);
+ }
+ }
+
+ for (let j = 0; j < rows - 1; j++) {
+ for (let i = 0; i < cols - 1; i++) {
+ const b = grid[j * cols + i];
+ const bR = grid[j * cols + i + 1];
+ const bD = grid[(j + 1) * cols + i];
+ if (b !== bR || b !== bD) {
+ const isMajor = ((b % 3) + 3) % 3 === 0;
+ ctx.fillStyle = isMajor ? C.spark : C.accent;
+ ctx.globalAlpha = isMajor ? 0.95 : 0.45;
+ ctx.fillRect(i * step, j * step, isMajor ? step : step - 1, isMajor ? step : step - 1);
+ }
+ }
+ }
+
+ // Subtle rotating bathymetry target ring
+ const ringR = W * 0.38;
+ ctx.globalAlpha = 0.25;
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 1.5;
+ ctx.beginPath();
+ ctx.arc(W / 2, H / 2, ringR, 0, TAU);
+ ctx.stroke();
+
+ const ang = phase * TAU;
+ ctx.globalAlpha = 0.9;
+ ctx.fillStyle = C.spark;
+ ctx.beginPath();
+ ctx.arc(W / 2 + Math.cos(ang) * ringR, H / 2 + Math.sin(ang) * ringR, 4, 0, TAU);
+ ctx.fill();
+
+ ctx.globalAlpha = 1;
+}
diff --git a/gallery/sonar-bathymetry/sources.json b/gallery/sonar-bathymetry/sources.json
new file mode 100644
index 0000000..3fe0e95
--- /dev/null
+++ b/gallery/sonar-bathymetry/sources.json
@@ -0,0 +1,6 @@
+{
+ "pass": true,
+ "checked": 0,
+ "citations": [],
+ "reasons": []
+}
diff --git a/skills/styles/dither-mono/template.js b/skills/styles/dither-mono/template.js
index 0779dfd..f13d1dd 100644
--- a/skills/styles/dither-mono/template.js
+++ b/skills/styles/dither-mono/template.js
@@ -1,25 +1,25 @@
-// Style Pack: dither-mono — Ordered Bayer 4x4 dithering on a rotating torus & sphere
+// Style Pack: dither-mono — Ordered Bayer 4x4 dithering on a rotating sphere & CRT radar sweep
export const meta = {
mode: "ambient",
style: "dither-mono",
seconds: 4,
- fps: 24,
- width: 360,
- height: 360,
+ fps: 30,
+ width: 320,
+ height: 320,
seed: 67,
- palette: "phosphor"
+ palette: "amber-crt"
};
export function render(ctx, phase, kit) {
- const W = meta.width;
- const H = meta.height;
- const C = kit.palettes[meta.palette] || kit.palettes["phosphor"];
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
+ const C = kit.palettes[meta.palette] || kit.palettes["amber-crt"];
const TAU = Math.PI * 2;
ctx.fillStyle = C.ground;
ctx.fillRect(0, 0, W, H);
- const pixel = 4;
+ const pixel = W >= 300 ? 4 : 3;
const cols = Math.floor(W / pixel);
const rows = Math.floor(H / pixel);
const lx = Math.cos(TAU * phase);
@@ -28,29 +28,27 @@ export function render(ctx, phase, kit) {
const lLen = Math.sqrt(lx * lx + ly * ly + lz * lz);
for (let gy = 0; gy < rows; gy++) {
- const ny = (gy / rows - 0.5) * 2.2;
+ const ny = (gy / rows - 0.5) * 2.25;
for (let gx = 0; gx < cols; gx++) {
- const nx = (gx / cols - 0.5) * 2.2;
+ const nx = (gx / cols - 0.5) * 2.25;
const r2 = nx * nx + ny * ny;
let lum = 0;
- if (r2 < 0.72) {
- // Central lit sphere + latitude wave bands
- const nz = Math.sqrt(Math.max(0, 0.72 - r2));
- const dot = Math.max(0, (nx * lx + ny * ly + nz * lz) / (0.85 * lLen));
- const ring = 0.5 + 0.5 * Math.sin(TAU * (phase * 2 - Math.sqrt(r2) * 2.2));
- lum = dot * 0.78 + ring * 0.25;
+ if (r2 < 0.64) {
+ const nz = Math.sqrt(Math.max(0, 0.64 - r2));
+ const dot = Math.max(0, (nx * lx + ny * ly + nz * lz) / (0.8 * lLen));
+ const ring = 0.5 + 0.5 * Math.sin(TAU * (phase * 2 - Math.sqrt(r2) * 2.4));
+ lum = dot * 0.78 + ring * 0.28;
} else {
- // Outer orbital radar rings
const dist = Math.sqrt(r2);
const angle = Math.atan2(ny, nx);
const sweep = 0.5 + 0.5 * Math.sin(angle * 3 - TAU * phase * 2);
- const band = Math.max(0, 1 - Math.abs(dist - 0.96) * 7.5);
- lum = band * sweep * 0.85;
+ const band = Math.max(0, 1 - Math.abs(dist - 0.94) * 6.5);
+ lum = band * sweep * 0.9;
}
const threshold = kit.dither.bayer4(gx, gy);
- if (lum > threshold + 0.35) {
+ if (lum > threshold + 0.34) {
ctx.fillStyle = C.spark;
ctx.fillRect(gx * pixel, gy * pixel, pixel - 1, pixel - 1);
} else if (lum > threshold) {
@@ -59,4 +57,14 @@ export function render(ctx, phase, kit) {
}
}
}
+
+ // Subtle CRT corner telemetry stamp
+ ctx.font = "600 10px monospace";
+ ctx.fillStyle = C.spark;
+ ctx.textAlign = "left";
+ ctx.textBaseline = "middle";
+ ctx.fillText("BAYER-4X4 // SYNC", 14, 18);
+ ctx.textAlign = "right";
+ ctx.fillStyle = C.muted;
+ ctx.fillText("p:" + phase.toFixed(2), W - 14, H - 16);
}
diff --git a/skills/styles/kinetic-type/template.js b/skills/styles/kinetic-type/template.js
index ee13a10..9943f2d 100644
--- a/skills/styles/kinetic-type/template.js
+++ b/skills/styles/kinetic-type/template.js
@@ -1,19 +1,19 @@
-// Style Pack: kinetic-type — Harmonic wave typography poster
+// Style Pack: kinetic-type — Silky 60fps harmonic wave typography poster
export const meta = {
mode: "ambient",
style: "kinetic-type",
- seconds: 4,
- fps: 24,
- width: 400,
- height: 400,
+ seconds: 2,
+ fps: 60,
+ width: 320,
+ height: 320,
seed: 61,
palette: "editorial",
word: "PHASE 0→1"
};
export function render(ctx, phase, kit) {
- const W = meta.width;
- const H = meta.height;
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
const C = kit.palettes[meta.palette] || kit.palettes["editorial"];
const TAU = Math.PI * 2;
const word = meta.word || "LOOP STUDIO";
@@ -22,7 +22,7 @@ export function render(ctx, phase, kit) {
ctx.fillRect(0, 0, W, H);
const rows = 9;
- const rowH = (H - 56) / rows;
+ const rowH = (H - 44) / rows;
ctx.textAlign = "center";
ctx.textBaseline = "middle";
@@ -30,22 +30,22 @@ export function render(ctx, phase, kit) {
const isCenter = r === Math.floor(rows / 2);
const dist = Math.abs(r - Math.floor(rows / 2));
const wave = Math.sin(TAU * (phase - r / rows));
- const x = W / 2 + wave * (isCenter ? 14 : 46);
- const y = 28 + (r + 0.5) * rowH;
+ const x = W / 2 + wave * (isCenter ? 10 : 38);
+ const y = 22 + (r + 0.5) * rowH;
- // Background band pill
- const pillW = W * (0.68 + 0.16 * (0.5 + 0.5 * Math.cos(TAU * (phase + r / rows))));
- kit.roundRect(ctx, x - pillW / 2, y - rowH * 0.38, pillW, rowH * 0.76, 6);
- ctx.globalAlpha = isCenter ? 0.95 : 0.25 + 0.45 * (1 - dist / rows);
- ctx.fillStyle = isCenter ? C.accent : C.surface;
+ const pillW = W * (0.68 + 0.14 * (0.5 + 0.5 * Math.cos(TAU * (phase + r / rows))));
+ kit.roundRect(ctx, x - pillW / 2, y - rowH * 0.37, pillW, rowH * 0.74, 6);
+ ctx.globalAlpha = isCenter ? 0.98 : 0.3 + 0.45 * (1 - dist / rows);
+ ctx.fillStyle = isCenter ? C.spark : C.surface;
ctx.fill();
- ctx.strokeStyle = isCenter ? C.spark : C.line;
+ ctx.strokeStyle = isCenter ? C.accent : C.line;
ctx.lineWidth = isCenter ? 2 : 1;
ctx.stroke();
- ctx.font = (isCenter ? "700 18px" : "600 15px") + " monospace";
- ctx.globalAlpha = isCenter ? 1 : 0.45 + 0.5 * (0.5 + 0.5 * wave);
- ctx.fillStyle = isCenter ? C.body : r % 2 === 0 ? C.spark : C.body;
+ const fontPx = Math.max(10, Math.round(W * (isCenter ? 0.044 : 0.036)));
+ ctx.font = (isCenter ? "700 " : "600 ") + fontPx + "px monospace";
+ ctx.globalAlpha = isCenter ? 1 : 0.5 + 0.5 * (0.5 + 0.5 * wave);
+ ctx.fillStyle = isCenter ? C.ground : r % 2 === 0 ? C.accent : C.body;
ctx.fillText(word, x, y);
}
diff --git a/skills/styles/sdf-raymarch/template.js b/skills/styles/sdf-raymarch/template.js
index 2d28ef0..e891ecd 100644
--- a/skills/styles/sdf-raymarch/template.js
+++ b/skills/styles/sdf-raymarch/template.js
@@ -1,11 +1,11 @@
-// Style Pack: sdf-raymarch — Software-safe 3D Signed Distance Field smooth union
+// Style Pack: sdf-raymarch — Software-safe 3D Signed Distance Field smooth union with specular & rim glow
export const meta = {
mode: "ambient",
style: "sdf-raymarch",
seconds: 4,
- fps: 24,
- width: 360,
- height: 360,
+ fps: 30,
+ width: 320,
+ height: 320,
seed: 53,
palette: "nebula"
};
@@ -20,65 +20,72 @@ function sceneSDF(px, py, pz, phase) {
const a1 = phase * TAU;
const c = Math.cos(a1);
const s = Math.sin(a1);
- // Rotate point for torus
+ // Rotate torus across two axes
const rx = px * c - pz * s;
const rz = px * s + pz * c;
const ry = py * Math.cos(a1) - rz * Math.sin(a1);
const rz2 = py * Math.sin(a1) + rz * Math.cos(a1);
- const qx = Math.sqrt(rx * rx + rz2 * rz2) - 0.72;
- const torus = Math.sqrt(qx * qx + ry * ry) - 0.24;
+ const qx = Math.sqrt(rx * rx + rz2 * rz2) - 0.68;
+ const torus = Math.sqrt(qx * qx + ry * ry) - 0.22;
- // 3 orbiting spheres
+ // 3 orbiting satellite spheres smoothly blending into the torus
let d = torus;
for (let i = 0; i < 3; i++) {
const ang = a1 * 2 + (i * TAU) / 3;
- const sx = Math.cos(ang) * 0.88;
- const sy = Math.sin(ang) * 0.88;
- const sz = Math.sin(a1 + i * 2.1) * 0.35;
+ const sx = Math.cos(ang) * 0.86;
+ const sy = Math.sin(ang) * 0.86;
+ const sz = Math.sin(a1 + i * 2.094) * 0.36;
const dx = px - sx;
const dy = py - sy;
const dz = pz - sz;
- const sph = Math.sqrt(dx * dx + dy * dy + dz * dz) - 0.26;
- d = smin(d, sph, 0.35);
+ const sph = Math.sqrt(dx * dx + dy * dy + dz * dz) - 0.24;
+ d = smin(d, sph, 0.38);
}
return d;
}
export function render(ctx, phase, kit) {
- const W = meta.width;
- const H = meta.height;
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
const C = kit.palettes[meta.palette] || kit.palettes["nebula"];
- ctx.fillStyle = C.ground;
+ if (ctx.createRadialGradient) {
+ const bg = ctx.createRadialGradient(W * 0.5, H * 0.5, 10, W * 0.5, H * 0.5, W * 0.65);
+ bg.addColorStop(0, C.surface);
+ bg.addColorStop(1, C.ground);
+ ctx.fillStyle = bg;
+ } else {
+ ctx.fillStyle = C.ground;
+ }
ctx.fillRect(0, 0, W, H);
- const cell = 5;
+ const cell = W >= 300 ? 3 : 2;
const eps = 0.02;
for (let y = 0; y < H; y += cell) {
- const uvY = -((y + cell * 0.5) / H - 0.5) * 2.2;
+ const uvY = -((y + cell * 0.5) / H - 0.5) * 2.25;
for (let x = 0; x < W; x += cell) {
- const uvX = ((x + cell * 0.5) / W - 0.5) * 2.2;
- const roZ = 2.8;
- const len = Math.sqrt(uvX * uvX + uvY * uvY + 1.8 * 1.8);
+ const uvX = ((x + cell * 0.5) / W - 0.5) * 2.25;
+ const roZ = 2.75;
+ const len = Math.sqrt(uvX * uvX + uvY * uvY + 1.85 * 1.85);
const rdX = uvX / len;
const rdY = uvY / len;
- const rdZ = -1.8 / len;
+ const rdZ = -1.85 / len;
let t = 0;
let hit = false;
- for (let step = 0; step < 22; step++) {
+ for (let step = 0; step < 24; step++) {
const px = rdX * t;
const py = rdY * t;
const pz = roZ + rdZ * t;
const d = sceneSDF(px, py, pz, phase);
- if (d < 0.02) {
+ if (d < 0.018) {
hit = true;
break;
}
t += d;
- if (t > 4.8) break;
+ if (t > 4.6) break;
}
if (hit) {
@@ -90,11 +97,12 @@ export function render(ctx, phase, kit) {
const ny = sceneSDF(px, py + eps, pz, phase) - d0;
const nz = sceneSDF(px, py, pz + eps, phase) - d0;
const nLen = Math.sqrt(nx * nx + ny * ny + nz * nz) || 1;
- const lDot = Math.max(0, (nx * 0.57 + ny * 0.57 + nz * 0.57) / nLen);
- const rim = Math.pow(1 - Math.max(0, nz / nLen), 2);
+ const lDot = Math.max(0, (nx * 0.55 + ny * 0.62 + nz * 0.56) / nLen);
+ const rim = Math.pow(1 - Math.max(0, nz / nLen), 2.2);
+ const spec = Math.pow(lDot, 8);
- ctx.fillStyle = rim > 0.55 ? C.spark : lDot > 0.48 ? C.accent : C.surface;
- ctx.globalAlpha = Math.min(1, 0.35 + lDot * 0.65 + rim * 0.35);
+ ctx.fillStyle = spec > 0.45 ? C.body : rim > 0.48 ? C.spark : lDot > 0.36 ? C.accent : C.surface;
+ ctx.globalAlpha = Math.min(1, 0.42 + lDot * 0.58 + rim * 0.32);
ctx.fillRect(x, y, cell, cell);
}
}
diff --git a/skills/styles/topographic-contour/template.js b/skills/styles/topographic-contour/template.js
index bd6f376..4cfd398 100644
--- a/skills/styles/topographic-contour/template.js
+++ b/skills/styles/topographic-contour/template.js
@@ -1,11 +1,11 @@
-// Style Pack: topographic-contour — Cyclic elevation isolines
+// Style Pack: topographic-contour — Cyclic elevation isolines with sonar sweep ticks
export const meta = {
mode: "ambient",
style: "topographic-contour",
seconds: 4,
- fps: 24,
- width: 360,
- height: 360,
+ fps: 30,
+ width: 320,
+ height: 320,
seed: 83,
palette: "abyss"
};
@@ -18,8 +18,8 @@ function field(nx, ny, cx, cy, kit, seed) {
}
export function render(ctx, phase, kit) {
- const W = meta.width;
- const H = meta.height;
+ const W = ctx.width || meta.width;
+ const H = ctx.height || meta.height;
const C = kit.palettes[meta.palette] || kit.palettes["abyss"];
const TAU = Math.PI * 2;
@@ -28,7 +28,7 @@ export function render(ctx, phase, kit) {
const cx = Math.cos(TAU * phase) * 0.72;
const cy = Math.sin(TAU * phase) * 0.72;
- const step = 4;
+ const step = W >= 300 ? 4 : 3;
const cols = Math.floor(W / step);
const rows = Math.floor(H / step);
const bands = 9;
@@ -49,10 +49,27 @@ export function render(ctx, phase, kit) {
if (b !== bR || b !== bD) {
const isMajor = ((b % 3) + 3) % 3 === 0;
ctx.fillStyle = isMajor ? C.spark : C.accent;
- ctx.globalAlpha = isMajor ? 0.95 : 0.48;
+ ctx.globalAlpha = isMajor ? 0.95 : 0.45;
ctx.fillRect(i * step, j * step, isMajor ? step : step - 1, isMajor ? step : step - 1);
}
}
}
+
+ // Subtle rotating bathymetry target ring
+ const ringR = W * 0.38;
+ ctx.globalAlpha = 0.25;
+ ctx.strokeStyle = C.line;
+ ctx.lineWidth = 1.5;
+ ctx.beginPath();
+ ctx.arc(W / 2, H / 2, ringR, 0, TAU);
+ ctx.stroke();
+
+ const ang = phase * TAU;
+ ctx.globalAlpha = 0.9;
+ ctx.fillStyle = C.spark;
+ ctx.beginPath();
+ ctx.arc(W / 2 + Math.cos(ang) * ringR, H / 2 + Math.sin(ang) * ringR, 4, 0, TAU);
+ ctx.fill();
+
ctx.globalAlpha = 1;
}
diff --git a/tool/scripts/build-gallery.js b/tool/scripts/build-gallery.js
index ca76b42..a40d3fb 100644
--- a/tool/scripts/build-gallery.js
+++ b/tool/scripts/build-gallery.js
@@ -1,11 +1,11 @@
// Loop Studio — Gallery Builder
-// Builds and renders all 6 official gallery fixtures (2 showcase loops + 4 ambient loops)
-// along with their contact sheets, storyboards, audit reports, posters, and animated GIFs.
+// Builds and renders all 12 official gallery fixtures (4 showcase loops + 8 ambient loops)
+// along with their contact sheets, storyboards, audit reports, posters, GIFs, and high-FPS WebPs.
import fs from "node:fs";
import path from "node:path";
import { fileURLToPath, pathToFileURL } from "node:url";
-import { encodePNG, encodeGIF } from "../lib/encoders.js";
+import { encodePNG, encodeGIF, encodeAnimatedWebP, detectCapabilities } from "../lib/encoders.js";
import { analyzeSeam, analyzeLegibility, analyzeSources } from "../lib/analyzers.js";
import { renderAllFrames, renderContactSheet, renderStoryboard } from "../lib/compositor.js";
import { generatePreviewHtml } from "../lib/server.js";
@@ -15,12 +15,14 @@ const __dirname = path.dirname(__filename);
const REPO_ROOT = path.resolve(__dirname, "../..");
const GALLERY_ITEMS = [
+ // === Showcase Loops ===
{
id: "loop-studio",
title: "Loop Studio Showcase (Flow Pipeline)",
mode: "showcase",
scene: "flow",
palette: "studio-dark",
+ useCase: "README hero diagram explaining what a repo or workflow does end-to-end",
prompt: "Make me a 10 second video that loops smoothly about this repo and what it does.",
showcase: {
title: "Loop Studio Showcase",
@@ -46,6 +48,7 @@ const GALLERY_ITEMS = [
mode: "showcase",
scene: "terminal",
palette: "phosphor",
+ useCase: "CLI documentation showing commands, flags, and pass/fail audit output",
prompt: "Animate how the loop CLI audits a sketch for seam continuity and WCAG legibility.",
showcase: {
title: "Loop CLI Audit Session",
@@ -65,12 +68,72 @@ const GALLERY_ITEMS = [
]
}
},
+ {
+ id: "api-pipeline-code",
+ title: "Phase Contract SDK Showcase (Code)",
+ mode: "showcase",
+ scene: "code",
+ palette: "studio-dark",
+ useCase: "SDK / library docs pairing live-stepping code with a synchronized state monitor",
+ prompt: "Show how the render(ctx, phase) SDK contract executes line-by-line.",
+ showcase: {
+ title: "Phase Contract SDK Showcase",
+ says: "Every Loop Studio sketch exports meta and a pure render(ctx, phase) function.",
+ seconds: 10,
+ fps: 20,
+ width: 800,
+ height: 320,
+ palette: "studio-dark",
+ scene: "code",
+ stage: [
+ "export const meta = { seconds: 4 };",
+ "export function render(ctx, phase) {",
+ " const a = phase * Math.PI * 2;",
+ " drawOrbit(ctx, a); // seam 1.00"
+ ],
+ steps: [
+ { from: 8.75, to: 1.25, caption: "declare duration and fps in meta", source: "rules/AGENTS.md:8" },
+ { from: 1.25, to: 3.75, caption: "pass normalized phase to render()", source: "rules/AGENTS.md:17" },
+ { from: 3.75, to: 6.25, caption: "convert phase to integer cycles", source: "skills/loop-math/SKILL.md:22" },
+ { from: 6.25, to: 8.75, caption: "last frame meets frame 0 cleanly", source: "skills/loop-render/SKILL.md:30" }
+ ]
+ }
+ },
+ {
+ id: "mcp-mesh-topology",
+ title: "Agent Orchestrator Mesh (Architecture)",
+ mode: "showcase",
+ scene: "architecture",
+ palette: "aurora",
+ useCase: "System architecture & multi-agent/MCP topology diagrams for engineering RFCs",
+ prompt: "Animate how the Loop Studio agent coordinates the CLI, seam auditor, and cold-reader subagent.",
+ showcase: {
+ title: "Agent Orchestrator Mesh",
+ says: "The Loop Studio orchestrator coordinates the CLI renderer, seam analyzer, and cold-read subagent.",
+ seconds: 10,
+ fps: 20,
+ width: 800,
+ height: 320,
+ palette: "aurora",
+ scene: "architecture",
+ stage: ["Agent", "loop CLI", "Seam Audit", "Cold Reader"],
+ steps: [
+ { from: 8.75, to: 1.25, caption: "agent scaffolds sketch via loop CLI", source: "AGENTS.md:9" },
+ { from: 1.25, to: 3.75, caption: "CLI renders storyboard & frame deltas", source: "skills/loop-render/SKILL.md:24" },
+ { from: 3.75, to: 6.25, caption: "cold-reader inspects storyboard.png", source: "agents/loop-cold-reader.md:10" },
+ { from: 6.25, to: 8.75, caption: "verified loop.gif & audit return", source: "skills/loop-audit/SKILL.md:9" }
+ ]
+ }
+ },
+
+ // === Ambient Loops ===
{
id: "deep-sea-orbits",
title: "Abyssal Bioluminescence (Particle Orbit)",
mode: "ambient",
style: "particle-orbit",
palette: "abyss",
+ useCase: "Calm ambient background for dark-mode apps, streams, and loading states",
prompt: "Make a 4-second square loop. Deep sea, slow, bioluminescent.",
brief: {
title: "Abyssal Bioluminescence",
@@ -91,6 +154,7 @@ const GALLERY_ITEMS = [
mode: "ambient",
style: "flow-field",
palette: "aurora",
+ useCase: "Organic generative header for landing pages, music visualizers, and project banners",
prompt: "Drifting aurora currents, organic silk streamlines, 4-second loop.",
brief: {
title: "Arctic Currents",
@@ -111,6 +175,7 @@ const GALLERY_ITEMS = [
mode: "ambient",
style: "isometric-grid",
palette: "nordic",
+ useCase: "Infrastructure, cloud platform, and modular architecture hero tiles",
prompt: "Clean architectural blocks on an isometric grid rising and falling in waves.",
brief: {
title: "Harmonic Architecture",
@@ -131,6 +196,7 @@ const GALLERY_ITEMS = [
mode: "ambient",
style: "blueprint-cad",
palette: "blueprint",
+ useCase: "Robotics, hardware, CAD, and precision engineering repo badges",
prompt: "Precision engineering blueprint with planetary gear linkages rotating at 1x and -2x harmonic speeds.",
brief: {
title: "Epicyclic Telemetry",
@@ -144,10 +210,94 @@ const GALLERY_ITEMS = [
height: 320,
seed: 79
}
+ },
+ {
+ id: "readme-hero-3d",
+ title: "Nebula SDF Sculpture (3D Raymarch)",
+ mode: "ambient",
+ style: "sdf-raymarch",
+ palette: "nebula",
+ useCase: "Zero-dependency 3D product showcase & smooth shader sculpture for SaaS hero cards",
+ prompt: "30 fps 3D raymarched smooth-union torus and orbiting spheres in neon nebula lighting.",
+ brief: {
+ title: "Nebula SDF Sculpture",
+ prompt: "30 fps 3D raymarched smooth-union torus and orbiting spheres in neon nebula lighting.",
+ mode: "ambient",
+ style: "sdf-raymarch",
+ palette: "nebula",
+ seconds: 3,
+ fps: 30,
+ width: 280,
+ height: 280,
+ seed: 53
+ }
+ },
+ {
+ id: "retro-crt-loader",
+ title: "Amber CRT Radar (Bayer Dither)",
+ mode: "ambient",
+ style: "dither-mono",
+ palette: "amber-crt",
+ useCase: "Low-bandwidth terminal/game splash screen & zero-shimmer retro loading indicator",
+ prompt: "30 fps retro amber CRT sphere and radar sweep using ordered 4x4 Bayer dithering.",
+ brief: {
+ title: "Amber CRT Radar",
+ prompt: "30 fps retro amber CRT sphere and radar sweep using ordered 4x4 Bayer dithering.",
+ mode: "ambient",
+ style: "dither-mono",
+ palette: "amber-crt",
+ seconds: 3,
+ fps: 30,
+ width: 280,
+ height: 280,
+ seed: 67
+ }
+ },
+ {
+ id: "kinetic-release-banner",
+ title: "Editorial Kinetic Wave (60 fps Type)",
+ mode: "ambient",
+ style: "kinetic-type",
+ palette: "editorial",
+ useCase: "60 fps social announcement card, talk title slide, and release launch banner",
+ prompt: "Silky 60 fps editorial kinetic typography wave repeating PHASE 0→1.",
+ brief: {
+ title: "Editorial Kinetic Wave",
+ prompt: "Silky 60 fps editorial kinetic typography wave repeating PHASE 0→1.",
+ mode: "ambient",
+ style: "kinetic-type",
+ palette: "editorial",
+ seconds: 2,
+ fps: 60,
+ width: 280,
+ height: 280,
+ seed: 61
+ }
+ },
+ {
+ id: "sonar-bathymetry",
+ title: "Abyssal Bathymetry (Topographic Isolines)",
+ mode: "ambient",
+ style: "topographic-contour",
+ palette: "abyss",
+ useCase: "Geospatial, weather, sonar, and telemetry elevation background loops",
+ prompt: "30 fps animated bathymetric contour isolines over a cyclic scalar noise field.",
+ brief: {
+ title: "Abyssal Bathymetry",
+ prompt: "30 fps animated bathymetric contour isolines over a cyclic scalar noise field.",
+ mode: "ambient",
+ style: "topographic-contour",
+ palette: "abyss",
+ seconds: 3,
+ fps: 30,
+ width: 280,
+ height: 280,
+ seed: 83
+ }
}
];
-async function buildItem(item) {
+async function buildItem(item, caps) {
const dir = path.join(REPO_ROOT, "gallery", item.id);
fs.mkdirSync(dir, { recursive: true });
@@ -159,6 +309,7 @@ async function buildItem(item) {
let sketchCode = fs.readFileSync(templatePath, "utf8");
const spec = item.mode === "showcase" ? item.showcase : item.brief;
sketchCode = sketchCode
+ .replace(/seconds:\s*\d+/, `seconds: ${spec.seconds}`)
.replace(/fps:\s*\d+/, `fps: ${spec.fps}`)
.replace(/width:\s*\d+/, `width: ${spec.width}`)
.replace(/height:\s*\d+/, `height: ${spec.height}`)
@@ -188,13 +339,23 @@ async function buildItem(item) {
fs.writeFileSync(path.join(dir, "poster.png"), posterBuf);
const gifBuf = encodeGIF(frames, width, height, fps);
- const gifName = item.mode === "showcase" ? "showcase.gif" : "loop.gif";
- fs.writeFileSync(path.join(dir, gifName), gifBuf);
+ const stem = item.mode === "showcase" ? "showcase" : "loop";
+ fs.writeFileSync(path.join(dir, `${stem}.gif`), gifBuf);
if (item.mode === "showcase") {
fs.writeFileSync(path.join(dir, "loop.gif"), gifBuf);
}
- // 3. Contact sheet or storyboard
+ // 3. High-FPS Animated WebP when cwebp+webpmux are available (skipped gracefully on minimal CI)
+ let webpKB = null;
+ const webpPath = path.join(dir, `${stem}.webp`);
+ if (caps.cwebpPath && caps.webpmuxPath && fps >= 25) {
+ const wRes = encodeAnimatedWebP(frames, width, height, fps, webpPath);
+ webpKB = Number((wRes.bytes / 1024).toFixed(1));
+ } else if (fs.existsSync(webpPath)) {
+ webpKB = Number((fs.statSync(webpPath).size / 1024).toFixed(1));
+ }
+
+ // 4. Contact sheet or storyboard
const sheetCanvas = renderContactSheet(sketchModule, { ...meta, showcase: item.showcase, cols: 4 });
fs.writeFileSync(path.join(dir, "sheet.png"), encodePNG(sheetCanvas.data, sheetCanvas.width, sheetCanvas.height));
@@ -203,7 +364,7 @@ async function buildItem(item) {
fs.writeFileSync(path.join(dir, "storyboard.png"), encodePNG(boardCanvas.data, boardCanvas.width, boardCanvas.height));
}
- // 4. Seam, Legibility, Sources, Audit
+ // 5. Seam, Legibility, Sources, Audit
const seam = analyzeSeam(frames, width, height);
fs.writeFileSync(path.join(dir, "seam.json"), JSON.stringify(seam, null, 2) + "\n", "utf8");
@@ -217,6 +378,8 @@ async function buildItem(item) {
id: item.id,
title: item.title,
mode: item.mode,
+ useCase: item.useCase,
+ fps,
pass: seam.pass && legible.pass && sources.pass,
seamScore: seam.seamScore,
duplicateFrames: seam.duplicateFrames,
@@ -224,6 +387,7 @@ async function buildItem(item) {
legiblePass: legible.pass,
sourcesPass: sources.pass,
gifKB: Number((gifBuf.length / 1024).toFixed(1)),
+ ...(webpKB !== null ? { webpKB } : {}),
totalFrames
};
fs.writeFileSync(path.join(dir, "audit.json"), JSON.stringify(audit, null, 2) + "\n", "utf8");
@@ -231,11 +395,14 @@ async function buildItem(item) {
}
async function main() {
+ const caps = detectCapabilities();
const results = [];
for (const item of GALLERY_ITEMS) {
- const res = await buildItem(item);
+ const res = await buildItem(item, caps);
results.push(res);
- console.log(`[Gallery] ${res.id}: pass=${res.pass} seam=${res.seamScore} dup=${res.duplicateFrames} gif=${res.gifKB}KB`);
+ console.log(
+ `[Gallery] ${res.id} (${res.fps}fps): pass=${res.pass} seam=${res.seamScore} dup=${res.duplicateFrames} gif=${res.gifKB}KB${res.webpKB ? ` webp=${res.webpKB}KB` : ""}`
+ );
}
fs.writeFileSync(
path.join(REPO_ROOT, "gallery", "manifest.json"),