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 Flow Showcase | **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 Terminal Showcase | **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 Flow Showcase | **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 Terminal Showcase | **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 Code Showcase | **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 Architecture Showcase | **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 | | :--- | :--- | :--- | :--- | -| Abyssal Bioluminescence | **`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) | -| Arctic Currents Flow Field | **`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) | -| Harmonic Architecture Isometric Grid | **`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) | -| Epicyclic Telemetry Blueprint CAD | **`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) | +| Abyssal Bioluminescence | **`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) | +| Arctic Currents Flow Field | **`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) | +| Harmonic Architecture Isometric Grid | **`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) | +| Epicyclic Telemetry Blueprint CAD | **`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) | +| Nebula 3D Raymarched Sculpture | **`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) | +| Amber CRT Bayer Dither Radar | **`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) | +| 60 fps Editorial Kinetic Wave | **`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) | +| Abyssal Bathymetry Topographic Isolines | **`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... +
+
+
+ +
+
+ + + frame 000 / 120 · phase 0.00 + +
+
+
+ + + \ 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... +
+
+
+ +
+
+ + + frame 000 / 120 · phase 0.00 + +
+
+
+ + + \ 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... +
+
+
+ +
+
+ + + frame 000 / 120 · phase 0.00 + +
+
+
+ + + \ 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... +
+
+
+ +
+
+ + + frame 000 / 120 · phase 0.00 + +
+
+
+ + + \ 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... +
+
+
+ +
+
+ + + frame 000 / 120 · phase 0.00 + +
+
+
+ + + \ 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... +
+
+
+ +
+
+ + + frame 000 / 120 · phase 0.00 + +
+
+
+ + + \ 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"),