diff --git a/README.md b/README.md index ca9edb6..7122234 100644 --- a/README.md +++ b/README.md @@ -9,11 +9,11 @@

- Animated showcase diagram: Loop Studio turns a one-line request into a checked, seamless loop. + Animated showcase diagram: Loop Studio turns a one-line request into a checked, seamless 60 fps loop.

- 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`). + Above: gallery/loop-studio/showcase.webp — an 8-second, 480-frame 60 fps showcase loop rendered directly by the loop CLI (`seamScore: 1.083`, `duplicateFrames: 0`, `PASS`).

--- @@ -26,7 +26,7 @@ Every animation below is pure deterministic code (`sketch.js`), measured by `loo | Preview | Subject, Scene Pack & Real Use Case | Seam & Audit | Artifacts | | :--- | :--- | :--- | :--- | -| 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 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." | `8s · 60fps · 480f` (WebP)
`seamScore: 1.083` (`PASS`) | [showcase.webp](./gallery/loop-studio/showcase.webp) · [showcase.gif](./gallery/loop-studio/showcase.gif) · [sketch.js](./gallery/loop-studio/sketch.js) · [storyboard.png](./gallery/loop-studio/storyboard.png) | | 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) | diff --git a/gallery/git-pr-guardrails/audit.json b/gallery/git-pr-guardrails/audit.json index 053c703..8c36c69 100644 --- a/gallery/git-pr-guardrails/audit.json +++ b/gallery/git-pr-guardrails/audit.json @@ -11,6 +11,6 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 6539.7, - "webpKB": 3906.6, + "webpKB": 3114.5, "totalFrames": 480 } diff --git a/gallery/git-pr-guardrails/showcase.webp b/gallery/git-pr-guardrails/showcase.webp index 4d763a8..b94f945 100644 Binary files a/gallery/git-pr-guardrails/showcase.webp and b/gallery/git-pr-guardrails/showcase.webp differ diff --git a/gallery/json-to-gif-transform/audit.json b/gallery/json-to-gif-transform/audit.json index 4c3a933..4933b4e 100644 --- a/gallery/json-to-gif-transform/audit.json +++ b/gallery/json-to-gif-transform/audit.json @@ -11,6 +11,6 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 5008.7, - "webpKB": 4697.5, + "webpKB": 3798.9, "totalFrames": 480 } diff --git a/gallery/json-to-gif-transform/showcase.webp b/gallery/json-to-gif-transform/showcase.webp index e814b52..2f99941 100644 Binary files a/gallery/json-to-gif-transform/showcase.webp and b/gallery/json-to-gif-transform/showcase.webp differ diff --git a/gallery/kinetic-release-banner/audit.json b/gallery/kinetic-release-banner/audit.json index 6f49af3..c9ddd17 100644 --- a/gallery/kinetic-release-banner/audit.json +++ b/gallery/kinetic-release-banner/audit.json @@ -11,6 +11,6 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 1408.1, - "webpKB": 1383.2, + "webpKB": 1134.1, "totalFrames": 240 } diff --git a/gallery/kinetic-release-banner/loop.webp b/gallery/kinetic-release-banner/loop.webp index e2a92e7..0d1f1a5 100644 Binary files a/gallery/kinetic-release-banner/loop.webp and b/gallery/kinetic-release-banner/loop.webp differ diff --git a/gallery/live-audio-spectrum/audit.json b/gallery/live-audio-spectrum/audit.json index 0a35eab..3ff9382 100644 --- a/gallery/live-audio-spectrum/audit.json +++ b/gallery/live-audio-spectrum/audit.json @@ -11,6 +11,6 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 1804, - "webpKB": 2134.8, + "webpKB": 1688.8, "totalFrames": 360 } diff --git a/gallery/live-audio-spectrum/loop.webp b/gallery/live-audio-spectrum/loop.webp index c19cc48..a5c19ac 100644 Binary files a/gallery/live-audio-spectrum/loop.webp and b/gallery/live-audio-spectrum/loop.webp differ diff --git a/gallery/loop-studio/audit.json b/gallery/loop-studio/audit.json index a1cd10d..8517a98 100644 --- a/gallery/loop-studio/audit.json +++ b/gallery/loop-studio/audit.json @@ -3,13 +3,14 @@ "title": "Loop Studio Showcase (Flow Pipeline)", "mode": "showcase", "useCase": "README hero diagram explaining what a repo or workflow does end-to-end", - "fps": 16, + "fps": 60, "pass": true, - "seamScore": 1.032, + "seamScore": 1.117, "duplicateFrames": 0, - "flickerScore": 0.745, + "flickerScore": 0.525, "legiblePass": true, "sourcesPass": true, - "gifKB": 3924.5, - "totalFrames": 160 + "gifKB": 9476.8, + "webpKB": 5622.2, + "totalFrames": 480 } diff --git a/gallery/loop-studio/legible.json b/gallery/loop-studio/legible.json index f624d5f..755582f 100644 --- a/gallery/loop-studio/legible.json +++ b/gallery/loop-studio/legible.json @@ -1,68 +1,68 @@ { "pass": true, - "width": 800, - "height": 360, + "width": 640, + "height": 288, "phoneWidth": 400, "frame0ShowsAllStageLabels": true, "stageLabelsChecked": 4, "captions": [ { "step": 1, - "caption": "a request arrives: \"deep sea, square\"", - "words": 6, - "chars": 37, - "windowSeconds": 2.5, - "requiredSeconds": 2.3, + "caption": "request arrives: \"deep sea, square\"", + "words": 5, + "chars": 35, + "windowSeconds": 2, + "requiredSeconds": 2, "passReadingTime": true, "contrastRatio": 14.23, "passContrast": true, - "minEdgeMarginPx": 39, - "phoneFontPx": 6.5, + "minEdgeMarginPx": 29, + "phoneFontPx": 7.5, "passMobileWidth": true, "pass": true }, { "step": 2, - "caption": "sketch is drawn from the phase", - "words": 6, - "chars": 30, - "windowSeconds": 2.5, - "requiredSeconds": 2.3, + "caption": "sketch draws from phase", + "words": 4, + "chars": 23, + "windowSeconds": 2, + "requiredSeconds": 1.7, "passReadingTime": true, "contrastRatio": 14.23, "passContrast": true, - "minEdgeMarginPx": 39, - "phoneFontPx": 6.5, + "minEdgeMarginPx": 29, + "phoneFontPx": 7.5, "passMobileWidth": true, "pass": true }, { "step": 3, - "caption": "seam and legibility are measured", - "words": 5, - "chars": 32, - "windowSeconds": 2.5, - "requiredSeconds": 2, + "caption": "seam and contrast measured", + "words": 4, + "chars": 26, + "windowSeconds": 2, + "requiredSeconds": 1.7, "passReadingTime": true, "contrastRatio": 14.23, "passContrast": true, - "minEdgeMarginPx": 39, - "phoneFontPx": 6.5, + "minEdgeMarginPx": 29, + "phoneFontPx": 7.5, "passMobileWidth": true, "pass": true }, { "step": 4, - "caption": "the verified loop drops out", + "caption": "verified 60fps loop drops out", "words": 5, - "chars": 27, - "windowSeconds": 2.5, + "chars": 29, + "windowSeconds": 2, "requiredSeconds": 2, "passReadingTime": true, "contrastRatio": 14.23, "passContrast": true, - "minEdgeMarginPx": 39, - "phoneFontPx": 6.5, + "minEdgeMarginPx": 29, + "phoneFontPx": 7.5, "passMobileWidth": true, "pass": true } diff --git a/gallery/loop-studio/loop.gif b/gallery/loop-studio/loop.gif index 4bec59b..f5e2ed2 100644 Binary files a/gallery/loop-studio/loop.gif and b/gallery/loop-studio/loop.gif differ diff --git a/gallery/loop-studio/poster.png b/gallery/loop-studio/poster.png index 292ee22..c41af90 100644 Binary files a/gallery/loop-studio/poster.png and b/gallery/loop-studio/poster.png differ diff --git a/gallery/loop-studio/seam.json b/gallery/loop-studio/seam.json index 98c23e9..ccc4116 100644 --- a/gallery/loop-studio/seam.json +++ b/gallery/loop-studio/seam.json @@ -1,175 +1,495 @@ { "pass": true, - "totalFrames": 160, - "seamScore": 1.032, + "totalFrames": 480, + "seamScore": 1.117, "maxSeamScore": 1.5, "duplicateFrames": 0, "duplicatePairs": [], - "flickerScore": 0.745, + "flickerScore": 0.525, "maxFlickerScore": 2.5, - "medianStepDelta": 0.027129, - "seamStepDelta": 0.028011, + "medianStepDelta": 0.013848, + "seamStepDelta": 0.015467, "normalizedSteps": [ - 1.02, - 1.032, + 1.021, 1.023, - 1.011, - 1.019, 1.013, - 1.001, - 0.987, - 1.001, - 0.97, - 0.959, - 0.956, - 0.917, - 0.895, - 0.929, - 0.942, - 0.907, - 0.889, - 0.846, - 0.981, - 0.84, - 0.868, - 0.913, - 0.922, - 0.953, - 0.921, - 0.931, - 0.966, - 0.962, - 0.976, - 1, - 1, - 1.011, - 1.016, + 1.033, + 1.014, + 1.017, + 1.056, 1.021, - 1.018, - 1.034, - 1.779, - 1.028, - 1.124, - 1.139, + 1.014, + 1.011, + 1.024, + 1.005, + 1.02, + 1.025, + 1.005, 1.028, - 1.784, - 1.026, - 1.026, - 1.008, - 1.002, - 1.012, + 0.993, + 1.02, + 0.997, + 0.989, + 1.014, + 0.984, + 0.99, + 0.972, + 0.991, 0.992, - 0.982, - 0.965, - 0.968, - 0.949, - 0.94, - 0.914, - 0.928, + 0.971, + 0.973, + 0.964, + 0.954, + 0.955, + 0.939, + 0.935, + 0.93, 0.925, - 0.922, - 0.87, - 0.966, + 0.917, + 0.931, + 0.92, + 0.912, + 0.925, + 0.914, + 0.906, + 0.886, + 0.882, + 0.879, + 0.882, + 0.879, + 0.874, + 0.878, + 0.887, + 0.852, + 0.858, + 0.853, + 0.848, + 0.836, + 0.826, + 0.84, + 0.822, + 0.821, + 1.421, + 0.834, 0.85, - 0.871, - 0.926, - 0.928, + 0.832, + 0.833, + 0.841, + 0.857, + 0.864, + 0.869, + 0.873, + 0.87, + 0.878, + 0.9, + 0.886, + 0.881, + 0.913, 0.927, - 0.916, - 0.929, + 0.917, + 0.906, + 0.906, + 0.915, + 0.944, + 0.946, + 0.941, + 0.951, 0.949, - 0.97, + 0.941, 0.971, - 0.985, - 1, + 0.957, + 0.996, + 0.975, 1, - 1.013, + 0.986, + 0.985, + 0.988, + 0.99, + 1.015, + 0.998, + 1.004, + 1.004, + 1.03, + 1.011, + 1.008, + 1.008, + 1.015, 1.02, - 1.016, - 1.025, - 1.657, + 1.038, + 1.02, + 1.018, 1.025, - 1.104, - 1.126, - 1.034, - 1.78, + 1.038, + 1.03, + 3.33, 1.024, + 1.065, + 1.028, + 1.035, + 1.05, + 1.472, + 1.032, + 1.029, + 1.055, + 1.029, + 1.51, 1.031, - 1.021, + 1.032, + 1.023, + 1.025, + 1.029, + 3.309, + 1.025, + 1.076, + 1.013, + 1.018, + 1.018, + 1.032, + 1.036, 1.002, + 1, + 1.003, + 1.02, + 0.999, + 0.994, + 0.993, 0.989, 0.99, - 0.958, - 0.95, - 1.032, - 0.936, - 0.93, - 0.953, + 0.98, + 0.981, 0.975, - 0.962, - 0.952, + 0.988, + 0.99, + 0.961, + 0.955, + 0.968, + 0.946, + 0.947, + 0.973, + 0.936, + 0.948, + 0.914, + 1.037, + 0.926, + 0.894, + 0.912, + 0.891, + 0.881, + 0.907, + 0.894, + 0.879, + 0.874, + 0.869, + 0.871, + 0.869, 0.903, - 1.02, 0.857, - 0.896, - 0.945, + 0.856, + 0.845, + 0.874, + 0.852, + 0.828, + 1.411, + 0.83, + 0.831, + 0.837, + 0.855, + 0.844, + 0.851, + 0.885, + 0.871, + 0.868, + 0.879, + 0.882, + 0.88, + 0.881, + 0.882, + 0.89, + 0.899, + 0.901, + 0.904, + 0.911, + 0.917, + 0.925, + 0.922, + 0.936, + 0.964, + 0.964, + 0.957, 0.96, - 0.992, - 0.969, - 0.994, - 1.003, + 0.954, + 0.976, + 0.984, + 0.971, + 0.98, + 0.984, 1.004, + 0.984, + 0.992, 1.011, + 1.002, + 1.033, + 1.004, + 1.017, + 1, + 1.008, + 1.037, + 1.019, + 1.015, + 1.024, + 1.019, + 1.02, 1.032, - 1.03, - 1.039, - 1.041, - 1.047, - 1.048, - 1.054, - 1.771, - 1.052, - 1.144, - 1.142, - 1.053, - 1.674, - 1.056, - 1.055, - 1.043, + 1.046, + 3.016, 1.035, - 1.047, + 1.043, + 1.024, + 1.022, + 1.029, + 1.397, + 1.05, + 1.03, + 1.028, + 1.036, + 1.475, + 1.04, + 1.022, + 1.018, + 1.063, + 1.032, + 3.335, 1.031, - 1.023, - 1.012, - 1.014, - 0.999, - 0.98, + 1.043, + 1.029, + 1.036, + 1.039, + 1.016, + 1.032, + 1.009, + 1.018, + 0.987, + 0.984, + 1.003, + 0.986, + 0.985, + 0.971, + 0.982, + 0.984, + 0.965, 0.977, - 0.98, - 0.972, + 0.963, + 0.957, 0.961, - 0.898, - 0.983, - 0.869, + 1.242, + 0.961, + 0.968, + 0.961, + 0.961, + 0.975, 0.973, - 1.043, - 1.055, - 1.096, - 1.094, - 1.097, - 1.078, - 1.074, - 1.137, - 1.76, - 1.035, + 0.965, + 0.976, 0.986, - 0.969, - 1.739, - 0.987, - 1.115, + 0.972, + 0.953, + 0.948, + 0.947, + 0.95, + 0.939, + 0.94, + 0.934, + 0.944, + 0.917, + 0.918, + 0.908, + 0.898, + 0.878, + 0.866, + 0.877, + 0.861, + 0.843, + 1.46, + 0.838, + 0.858, + 0.846, + 0.852, + 0.866, + 0.878, + 0.892, + 0.902, + 0.913, + 0.917, + 0.926, + 0.948, + 0.943, + 0.947, + 0.976, + 0.992, + 0.988, + 0.985, + 0.988, + 1.103, + 1.026, + 1.022, + 1.021, 1.03, + 1.038, + 1.044, + 1.061, + 1.053, + 1.084, + 1.068, + 1.096, + 1.083, + 1.09, + 1.096, + 1.094, + 1.122, + 1.105, + 1.113, + 1.113, + 1.135, + 1.127, + 1.125, + 1.13, + 1.128, + 1.131, + 1.158, + 1.148, + 1.141, + 1.145, + 1.15, + 1.151, + 3.273, + 1.151, + 1.191, + 1.156, + 1.156, + 1.174, + 1.59, + 1.157, + 1.156, + 1.176, + 1.162, + 1.496, + 1.153, + 1.16, + 1.158, + 1.151, + 1.153, + 3.053, + 1.156, + 1.195, + 1.143, + 1.142, + 1.148, + 1.156, + 1.161, + 1.134, + 1.123, + 1.12, + 1.14, + 1.116, + 1.114, + 1.112, + 1.107, + 1.104, + 1.095, + 1.09, + 1.09, + 1.094, + 1.095, + 1.072, + 1.065, + 1.071, + 1.053, + 1.041, + 1.059, + 1.027, + 1.04, + 1.011, + 1.011, + 1.017, + 0.985, + 0.999, + 0.975, + 0.962, + 0.979, + 0.966, + 0.95, + 0.936, + 0.926, + 0.92, + 0.917, + 0.945, + 0.893, + 0.884, + 0.866, + 0.892, + 0.867, + 0.84, + 1.365, + 0.831, + 0.841, + 0.877, + 0.93, + 0.954, + 0.994, + 1.052, + 1.053, + 1.064, + 1.1, + 1.108, + 1.122, + 1.143, + 1.163, + 1.173, + 1.185, + 1.18, + 1.184, + 1.186, + 1.175, + 1.184, + 1.158, + 1.14, + 1.159, + 1.152, + 1.127, + 1.123, + 1.1, + 1.555, + 1.088, + 1.066, + 1.058, + 3.25, + 1.073, + 1.043, + 1.042, + 1.045, + 0.996, + 1.012, + 0.966, + 0.974, + 0.951, + 3.285, + 0.968, + 0.952, + 0.966, + 1, + 1.002, 1.013, - 1.032 + 1.499, + 1.033, + 1.044, + 1.021, + 1.033, + 1.01, + 1.011, + 1.008, + 1.016, + 1.036, + 1.117 ], "reasons": [] } diff --git a/gallery/loop-studio/sheet.png b/gallery/loop-studio/sheet.png index 8279bf3..1abef45 100644 Binary files a/gallery/loop-studio/sheet.png and b/gallery/loop-studio/sheet.png differ diff --git a/gallery/loop-studio/showcase.gif b/gallery/loop-studio/showcase.gif index 4bec59b..f5e2ed2 100644 Binary files a/gallery/loop-studio/showcase.gif and b/gallery/loop-studio/showcase.gif differ diff --git a/gallery/loop-studio/showcase.json b/gallery/loop-studio/showcase.json index 8bcbbfc..668fca3 100644 --- a/gallery/loop-studio/showcase.json +++ b/gallery/loop-studio/showcase.json @@ -1,10 +1,10 @@ { "title": "Loop Studio Showcase", "says": "Loop Studio turns a one-line request into a checked, seamless loop.", - "seconds": 10, - "fps": 16, - "width": 800, - "height": 360, + "seconds": 8, + "fps": 60, + "width": 640, + "height": 288, "palette": "studio-dark", "scene": "flow", "stage": [ @@ -15,27 +15,27 @@ ], "steps": [ { - "from": 8.75, - "to": 1.25, - "caption": "a request arrives: \"deep sea, square\"", + "from": 7, + "to": 1, + "caption": "request arrives: \"deep sea, square\"", "source": "docs/contract.md:3" }, { - "from": 1.25, - "to": 3.75, - "caption": "sketch is drawn from the phase", + "from": 1, + "to": 3, + "caption": "sketch draws from phase", "source": "docs/contract.md:14" }, { - "from": 3.75, - "to": 6.25, - "caption": "seam and legibility are measured", + "from": 3, + "to": 5, + "caption": "seam and contrast measured", "source": "docs/tool.md:14" }, { - "from": 6.25, - "to": 8.75, - "caption": "the verified loop drops out", + "from": 5, + "to": 7, + "caption": "verified 60fps loop drops out", "source": "docs/tool.md:24" } ] diff --git a/gallery/loop-studio/showcase.webp b/gallery/loop-studio/showcase.webp new file mode 100644 index 0000000..864fe8f Binary files /dev/null and b/gallery/loop-studio/showcase.webp differ diff --git a/gallery/loop-studio/sketch.js b/gallery/loop-studio/sketch.js index a7e26a6..b620fac 100644 --- a/gallery/loop-studio/sketch.js +++ b/gallery/loop-studio/sketch.js @@ -2,24 +2,24 @@ export const meta = { mode: "showcase", scene: "flow", - seconds: 10, - fps: 16, - width: 800, - height: 360, + seconds: 8, + fps: 60, + width: 640, + height: 288, seed: 11, palette: "studio-dark" }; export const showcase = { says: "Loop Studio turns a one-line request into a checked, seamless loop.", - seconds: 10, + seconds: 8, scene: "flow", stage: ["request", "sketch", "check", "loop.gif"], steps: [ - { from: 8.75, to: 1.25, caption: "a request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, - { from: 1.25, to: 3.75, caption: "sketch is drawn from the phase", source: "docs/contract.md:14" }, - { from: 3.75, to: 6.25, caption: "seam and legibility are measured", source: "docs/tool.md:14" }, - { from: 6.25, to: 8.75, caption: "the verified loop drops out", source: "docs/tool.md:24" } + { from: 7.0, to: 1.0, caption: "request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, + { from: 1.0, to: 3.0, caption: "sketch draws from phase", source: "docs/contract.md:14" }, + { from: 3.0, to: 5.0, caption: "seam and contrast measured", source: "docs/tool.md:14" }, + { from: 5.0, to: 7.0, caption: "verified 60fps loop drops out", source: "docs/tool.md:24" } ] }; @@ -32,26 +32,26 @@ function placeItem(age, xs, W) { const right = 1.05 * W; let x = left; let alpha = 1; - if (age < 2.5) { - x = left + (xs[0] - left) * ease(age / 2.5); - } else if (age < 5.0) { - const u = (age - 2.5) / 2.5; + if (age < 2.0) { + x = left + (xs[0] - left) * ease(age / 2.0); + } else if (age < 4.0) { + const u = (age - 2.0) / 2.0; x = xs[0] + (xs[1] - xs[0]) * (0.18 * u + 0.82 * ease(u)); - } else if (age < 7.5) { - const u = (age - 5.0) / 2.5; + } else if (age < 6.0) { + const u = (age - 4.0) / 2.0; x = xs[1] + (xs[2] - xs[1]) * (0.18 * u + 0.82 * ease(u)); - } else if (age < 10.0) { - const u = (age - 7.5) / 2.5; + } else if (age < 8.0) { + const u = (age - 6.0) / 2.0; x = xs[2] + (xs[3] - xs[2]) * (0.18 * u + 0.82 * ease(u)); } else { - const e = ease((age - 10.0) / 1.25); + const e = ease((age - 8.0) / 1.0); x = xs[3] + (right - xs[3]) * e; alpha = 1 - e; } return { x, alpha, - checked: ease((age - 6.6) / 0.8) + checked: ease((age - 5.2) / 0.65) }; } @@ -110,8 +110,8 @@ export function render(ctx, phase, kit) { const capY = Math.round(H * 0.87); const xs = [0, 1, 2, 3].map((i) => margin + i * (bw + gap) + bw / 2); - const items = [placeItem(t + 1.25, xs, W)]; - if (t >= 8.75) items.push(placeItem(t - 8.75, xs, W)); + const items = [placeItem(t + 1.0, xs, W)]; + if (t >= 7.0) items.push(placeItem(t - 7.0, xs, W)); // Transport rail + glowing carrier stream ctx.globalAlpha = 1; @@ -134,7 +134,7 @@ export function render(ctx, phase, kit) { ctx.fill(); } - const stepHeaders = ["01 BRIEF", "02 SKETCH", "03 SEAM", "04 EXPORT"]; + const stepHeaders = ["01", "02", "03", "04"]; xs.forEach((cx, i) => { let near = 0; @@ -191,14 +191,14 @@ export function render(ctx, phase, kit) { ctx.lineTo(cardLeft + bw - 1, cardTop + headH); ctx.stroke(); - // Card header step tag + primary stage label (kept for Frame-0 legibility check) - ctx.font = "600 10px monospace"; + // Card header step badge + primary stage label + ctx.font = "700 10.5px monospace"; ctx.fillStyle = activeColor; ctx.textAlign = "left"; ctx.textBaseline = "middle"; ctx.fillText(stepHeaders[i], cardLeft + 10, cardTop + headH * 0.5); - ctx.font = "700 12px monospace"; + ctx.font = "700 11.5px monospace"; ctx.fillStyle = C.body; ctx.textAlign = "right"; ctx.fillText(labels[i], cardLeft + bw - 10, cardTop + headH * 0.5); @@ -208,8 +208,8 @@ export function render(ctx, phase, kit) { if (i === 0) { // Card 1: Prompt lines + live rotating Phase Ring (0 -> 1) - const ringX = cardLeft + bw * 0.28; - const ringR = Math.min(bw, bh) * 0.19; + const ringX = cardLeft + bw * 0.25; + const ringR = Math.min(bw, bh) * 0.155; ctx.strokeStyle = C.line; ctx.lineWidth = 2; ctx.beginPath(); @@ -225,19 +225,19 @@ export function render(ctx, phase, kit) { ctx.fillStyle = C.spark; ctx.beginPath(); - ctx.arc(ringX + Math.cos(pAng) * ringR, innerY + Math.sin(pAng) * ringR, 3.8, 0, TAU); + ctx.arc(ringX + Math.cos(pAng) * ringR, innerY + Math.sin(pAng) * ringR, 3.4, 0, TAU); ctx.fill(); - // Prompt spec bars on right half of Card 1 - const tx0 = cardLeft + bw * 0.52; - ctx.font = "500 10px monospace"; + // Prompt spec labels on right half of Card 1 + const tx0 = cardLeft + bw * 0.45; + ctx.font = "500 9.5px monospace"; ctx.fillStyle = C.muted; ctx.textAlign = "left"; - ctx.fillText("4s · 30fps", tx0, innerY - 14); + ctx.fillText("8s · 60fps", tx0, innerY - 14); ctx.fillStyle = C.body; - ctx.fillText("phase 0→1", tx0, innerY + 3); + ctx.fillText("phase 0→1", tx0, innerY + 2); ctx.fillStyle = cyan; - ctx.fillText("seed: 7", tx0, innerY + 19); + ctx.fillText("seed: 7", tx0, innerY + 18); } else if (i === 1) { // Card 2: Live Miniature Bioluminescent Particle-Orbit Sketch Viewport! const vpW = bw - 20; @@ -372,7 +372,7 @@ export function render(ctx, phase, kit) { }); // 4. Bottom Caption Pill + Step Progress Dots - const pillW = Math.round(W * 0.64); + const pillW = Math.round(W * 0.74); const pillH = 34; kit.roundRect(ctx, W / 2 - pillW / 2, capY - pillH / 2, pillW, pillH, 8); ctx.globalAlpha = 0.96; @@ -394,11 +394,11 @@ export function render(ctx, phase, kit) { ctx.globalAlpha = 1; ctx.fillStyle = d === activeStepIdx ? cyan : C.line; ctx.beginPath(); - ctx.arc(W / 2 - pillW / 2 + 18 + d * 11, capY, d === activeStepIdx ? 3.8 : 2.6, 0, TAU); + ctx.arc(W / 2 - pillW / 2 + 16 + d * 10, capY, d === activeStepIdx ? 3.5 : 2.5, 0, TAU); ctx.fill(); } - ctx.font = "500 13px monospace"; + ctx.font = "500 12px monospace"; ctx.textAlign = "center"; ctx.textBaseline = "middle"; @@ -409,7 +409,7 @@ export function render(ctx, phase, kit) { const fade = Math.max(0.25, Math.min(1, u / 0.35, (len - u) / 0.35)); ctx.globalAlpha = fade; ctx.fillStyle = C.body; - ctx.fillText(c.caption, W / 2 + 16, capY); + ctx.fillText(c.caption, W / 2 + 22, capY); }); ctx.globalAlpha = 1; diff --git a/gallery/loop-studio/storyboard.png b/gallery/loop-studio/storyboard.png index 8c6a4f4..01d81af 100644 Binary files a/gallery/loop-studio/storyboard.png and b/gallery/loop-studio/storyboard.png differ diff --git a/gallery/manifest.json b/gallery/manifest.json index 701be5e..7f79cbb 100644 --- a/gallery/manifest.json +++ b/gallery/manifest.json @@ -1,20 +1,21 @@ { - "generatedAt": "2026-11-18T18:06:59.266Z", + "generatedAt": "2026-11-18T18:13:57.421Z", "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, + "fps": 60, "pass": true, - "seamScore": 1.032, + "seamScore": 1.116, "duplicateFrames": 0, - "flickerScore": 0.745, + "flickerScore": 0.582, "legiblePass": true, "sourcesPass": true, - "gifKB": 3924.5, - "totalFrames": 160 + "gifKB": 10072.3, + "webpKB": 6098, + "totalFrames": 480 }, { "id": "cli-audit-session", @@ -166,7 +167,7 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 1408.1, - "webpKB": 1383.2, + "webpKB": 1134.1, "totalFrames": 240 }, { @@ -198,7 +199,7 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 6539.7, - "webpKB": 3906.6, + "webpKB": 3114.5, "totalFrames": 480 }, { @@ -214,7 +215,7 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 5008.7, - "webpKB": 4697.5, + "webpKB": 3798.9, "totalFrames": 480 }, { @@ -230,7 +231,7 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 1804, - "webpKB": 2134.8, + "webpKB": 1688.8, "totalFrames": 360 }, { @@ -246,7 +247,7 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 5494.6, - "webpKB": 4307.1, + "webpKB": 3257, "totalFrames": 480 } ] diff --git a/gallery/orbital-telemetry-watch/audit.json b/gallery/orbital-telemetry-watch/audit.json index 99a189e..3c3f517 100644 --- a/gallery/orbital-telemetry-watch/audit.json +++ b/gallery/orbital-telemetry-watch/audit.json @@ -11,6 +11,6 @@ "legiblePass": true, "sourcesPass": true, "gifKB": 5494.6, - "webpKB": 4307.1, + "webpKB": 3257, "totalFrames": 480 } diff --git a/gallery/orbital-telemetry-watch/loop.webp b/gallery/orbital-telemetry-watch/loop.webp index 890cd26..85e9400 100644 Binary files a/gallery/orbital-telemetry-watch/loop.webp and b/gallery/orbital-telemetry-watch/loop.webp differ diff --git a/skills/scenes/flow/template.js b/skills/scenes/flow/template.js index 63806f0..b620fac 100644 --- a/skills/scenes/flow/template.js +++ b/skills/scenes/flow/template.js @@ -2,24 +2,24 @@ export const meta = { mode: "showcase", scene: "flow", - seconds: 10, - fps: 20, - width: 800, - height: 360, + seconds: 8, + fps: 60, + width: 640, + height: 288, seed: 11, palette: "studio-dark" }; export const showcase = { says: "Loop Studio turns a one-line request into a checked, seamless loop.", - seconds: 10, + seconds: 8, scene: "flow", stage: ["request", "sketch", "check", "loop.gif"], steps: [ - { from: 8.75, to: 1.25, caption: "a request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, - { from: 1.25, to: 3.75, caption: "sketch is drawn from the phase", source: "docs/contract.md:14" }, - { from: 3.75, to: 6.25, caption: "seam and legibility are measured", source: "docs/tool.md:14" }, - { from: 6.25, to: 8.75, caption: "the verified loop drops out", source: "docs/tool.md:24" } + { from: 7.0, to: 1.0, caption: "request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, + { from: 1.0, to: 3.0, caption: "sketch draws from phase", source: "docs/contract.md:14" }, + { from: 3.0, to: 5.0, caption: "seam and contrast measured", source: "docs/tool.md:14" }, + { from: 5.0, to: 7.0, caption: "verified 60fps loop drops out", source: "docs/tool.md:24" } ] }; @@ -32,26 +32,26 @@ function placeItem(age, xs, W) { const right = 1.05 * W; let x = left; let alpha = 1; - if (age < 2.5) { - x = left + (xs[0] - left) * ease(age / 2.5); - } else if (age < 5.0) { - const u = (age - 2.5) / 2.5; + if (age < 2.0) { + x = left + (xs[0] - left) * ease(age / 2.0); + } else if (age < 4.0) { + const u = (age - 2.0) / 2.0; x = xs[0] + (xs[1] - xs[0]) * (0.18 * u + 0.82 * ease(u)); - } else if (age < 7.5) { - const u = (age - 5.0) / 2.5; + } else if (age < 6.0) { + const u = (age - 4.0) / 2.0; x = xs[1] + (xs[2] - xs[1]) * (0.18 * u + 0.82 * ease(u)); - } else if (age < 10.0) { - const u = (age - 7.5) / 2.5; + } else if (age < 8.0) { + const u = (age - 6.0) / 2.0; x = xs[2] + (xs[3] - xs[2]) * (0.18 * u + 0.82 * ease(u)); } else { - const e = ease((age - 10.0) / 1.25); + const e = ease((age - 8.0) / 1.0); x = xs[3] + (right - xs[3]) * e; alpha = 1 - e; } return { x, alpha, - checked: ease((age - 6.6) / 0.8) + checked: ease((age - 5.2) / 0.65) }; } @@ -110,8 +110,8 @@ export function render(ctx, phase, kit) { const capY = Math.round(H * 0.87); const xs = [0, 1, 2, 3].map((i) => margin + i * (bw + gap) + bw / 2); - const items = [placeItem(t + 1.25, xs, W)]; - if (t >= 8.75) items.push(placeItem(t - 8.75, xs, W)); + const items = [placeItem(t + 1.0, xs, W)]; + if (t >= 7.0) items.push(placeItem(t - 7.0, xs, W)); // Transport rail + glowing carrier stream ctx.globalAlpha = 1; @@ -134,7 +134,7 @@ export function render(ctx, phase, kit) { ctx.fill(); } - const stepHeaders = ["01 BRIEF", "02 SKETCH", "03 SEAM", "04 EXPORT"]; + const stepHeaders = ["01", "02", "03", "04"]; xs.forEach((cx, i) => { let near = 0; @@ -191,14 +191,14 @@ export function render(ctx, phase, kit) { ctx.lineTo(cardLeft + bw - 1, cardTop + headH); ctx.stroke(); - // Card header step tag + primary stage label (kept for Frame-0 legibility check) - ctx.font = "600 10px monospace"; + // Card header step badge + primary stage label + ctx.font = "700 10.5px monospace"; ctx.fillStyle = activeColor; ctx.textAlign = "left"; ctx.textBaseline = "middle"; ctx.fillText(stepHeaders[i], cardLeft + 10, cardTop + headH * 0.5); - ctx.font = "700 12px monospace"; + ctx.font = "700 11.5px monospace"; ctx.fillStyle = C.body; ctx.textAlign = "right"; ctx.fillText(labels[i], cardLeft + bw - 10, cardTop + headH * 0.5); @@ -208,8 +208,8 @@ export function render(ctx, phase, kit) { if (i === 0) { // Card 1: Prompt lines + live rotating Phase Ring (0 -> 1) - const ringX = cardLeft + bw * 0.28; - const ringR = Math.min(bw, bh) * 0.19; + const ringX = cardLeft + bw * 0.25; + const ringR = Math.min(bw, bh) * 0.155; ctx.strokeStyle = C.line; ctx.lineWidth = 2; ctx.beginPath(); @@ -225,19 +225,19 @@ export function render(ctx, phase, kit) { ctx.fillStyle = C.spark; ctx.beginPath(); - ctx.arc(ringX + Math.cos(pAng) * ringR, innerY + Math.sin(pAng) * ringR, 3.8, 0, TAU); + ctx.arc(ringX + Math.cos(pAng) * ringR, innerY + Math.sin(pAng) * ringR, 3.4, 0, TAU); ctx.fill(); - // Prompt spec bars on right half of Card 1 - const tx0 = cardLeft + bw * 0.52; - ctx.font = "500 10px monospace"; + // Prompt spec labels on right half of Card 1 + const tx0 = cardLeft + bw * 0.45; + ctx.font = "500 9.5px monospace"; ctx.fillStyle = C.muted; ctx.textAlign = "left"; - ctx.fillText("4s · 30fps", tx0, innerY - 14); + ctx.fillText("8s · 60fps", tx0, innerY - 14); ctx.fillStyle = C.body; - ctx.fillText("phase 0→1", tx0, innerY + 3); + ctx.fillText("phase 0→1", tx0, innerY + 2); ctx.fillStyle = cyan; - ctx.fillText("seed: 7", tx0, innerY + 19); + ctx.fillText("seed: 7", tx0, innerY + 18); } else if (i === 1) { // Card 2: Live Miniature Bioluminescent Particle-Orbit Sketch Viewport! const vpW = bw - 20; @@ -372,7 +372,7 @@ export function render(ctx, phase, kit) { }); // 4. Bottom Caption Pill + Step Progress Dots - const pillW = Math.round(W * 0.64); + const pillW = Math.round(W * 0.74); const pillH = 34; kit.roundRect(ctx, W / 2 - pillW / 2, capY - pillH / 2, pillW, pillH, 8); ctx.globalAlpha = 0.96; @@ -394,11 +394,11 @@ export function render(ctx, phase, kit) { ctx.globalAlpha = 1; ctx.fillStyle = d === activeStepIdx ? cyan : C.line; ctx.beginPath(); - ctx.arc(W / 2 - pillW / 2 + 18 + d * 11, capY, d === activeStepIdx ? 3.8 : 2.6, 0, TAU); + ctx.arc(W / 2 - pillW / 2 + 16 + d * 10, capY, d === activeStepIdx ? 3.5 : 2.5, 0, TAU); ctx.fill(); } - ctx.font = "500 13px monospace"; + ctx.font = "500 12px monospace"; ctx.textAlign = "center"; ctx.textBaseline = "middle"; @@ -409,7 +409,7 @@ export function render(ctx, phase, kit) { const fade = Math.max(0.25, Math.min(1, u / 0.35, (len - u) / 0.35)); ctx.globalAlpha = fade; ctx.fillStyle = C.body; - ctx.fillText(c.caption, W / 2 + 16, capY); + ctx.fillText(c.caption, W / 2 + 22, capY); }); ctx.globalAlpha = 1; diff --git a/tool/bin/loop.js b/tool/bin/loop.js index 484c259..e4a5ab4 100755 --- a/tool/bin/loop.js +++ b/tool/bin/loop.js @@ -122,18 +122,18 @@ function cmdNew(targetDir, flags) { const showcaseData = { title: path.basename(absDir), says: "Loop Studio turns a one-line request into a checked, seamless loop.", - seconds: Number(flags.seconds || 10), - fps: Number(flags.fps || 30), - width: Number(flags.width || 800), - height: Number(flags.height || 360), + seconds: Number(flags.seconds || 8), + fps: Number(flags.fps || 60), + width: Number(flags.width || 640), + height: Number(flags.height || 288), palette, scene, stage: ["request", "sketch", "check", "loop.gif"], steps: [ - { from: 8.75, to: 1.25, caption: "a request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, - { from: 1.25, to: 3.75, caption: "sketch is drawn from the phase", source: "docs/contract.md:14" }, - { from: 3.75, to: 6.25, caption: "seam and legibility are measured", source: "docs/tool.md:14" }, - { from: 6.25, to: 8.75, caption: "the verified loop drops out", source: "docs/tool.md:24" } + { from: 7.0, to: 1.0, caption: "request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, + { from: 1.0, to: 3.0, caption: "sketch draws from phase", source: "docs/contract.md:14" }, + { from: 3.0, to: 5.0, caption: "seam and contrast measured", source: "docs/tool.md:14" }, + { from: 5.0, to: 7.0, caption: "verified 60fps loop drops out", source: "docs/tool.md:24" } ] }; const scPath = path.join(absDir, "showcase.json"); diff --git a/tool/lib/encoders.js b/tool/lib/encoders.js index e6730d9..4e40921 100644 --- a/tool/lib/encoders.js +++ b/tool/lib/encoders.js @@ -424,13 +424,14 @@ export function encodeAnimatedWebP(frames, width, height, fps = 30, outPath) { if (caps.cwebpPath && caps.webpmuxPath) { const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "loop-studio-webp-")); + const quality = frames.length > 200 ? "80" : "88"; try { const muxArgs = []; for (let i = 0; i < frames.length; i++) { const pngPath = path.join(tmpDir, `f_${i}.png`); const webpPath = path.join(tmpDir, `f_${i}.webp`); fs.writeFileSync(pngPath, encodePNG(frames[i], width, height, 1)); - const cw = spawnSync(caps.cwebpPath, ["-quiet", "-q", "88", pngPath, "-o", webpPath], { encoding: "utf8" }); + const cw = spawnSync(caps.cwebpPath, ["-quiet", "-q", quality, pngPath, "-o", webpPath], { encoding: "utf8" }); if (cw.status !== 0) { throw new Error(`cwebp failed on frame ${i}: ${cw.stderr}`); } diff --git a/tool/scripts/build-gallery.js b/tool/scripts/build-gallery.js index b9c65bc..badfe91 100644 --- a/tool/scripts/build-gallery.js +++ b/tool/scripts/build-gallery.js @@ -23,22 +23,22 @@ const GALLERY_ITEMS = [ 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.", + prompt: "Make me an 8 second 60fps video that loops smoothly about this repo and what it does.", showcase: { title: "Loop Studio Showcase", says: "Loop Studio turns a one-line request into a checked, seamless loop.", - seconds: 10, - fps: 16, - width: 800, - height: 360, + seconds: 8, + fps: 60, + width: 640, + height: 288, palette: "studio-dark", scene: "flow", stage: ["request", "sketch", "check", "loop.gif"], steps: [ - { from: 8.75, to: 1.25, caption: "a request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, - { from: 1.25, to: 3.75, caption: "sketch is drawn from the phase", source: "docs/contract.md:14" }, - { from: 3.75, to: 6.25, caption: "seam and legibility are measured", source: "docs/tool.md:14" }, - { from: 6.25, to: 8.75, caption: "the verified loop drops out", source: "docs/tool.md:24" } + { from: 7.0, to: 1.0, caption: "request arrives: \"deep sea, square\"", source: "docs/contract.md:3" }, + { from: 1.0, to: 3.0, caption: "sketch draws from phase", source: "docs/contract.md:14" }, + { from: 3.0, to: 5.0, caption: "seam and contrast measured", source: "docs/tool.md:14" }, + { from: 5.0, to: 7.0, caption: "verified 60fps loop drops out", source: "docs/tool.md:24" } ] } },