agentcut 0.2.4 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/dist/studio/workspace.js +4 -0
  2. package/dist/studio/workspace.js.map +1 -1
  3. package/package.json +1 -1
  4. package/template/components/CATALOG.md +52 -0
  5. package/template/components/README.md +70 -61
  6. package/template/components/STYLES.md +2 -0
  7. package/template/components/catalog.json +477 -0
  8. package/template/components/catalog.ts +4 -0
  9. package/template/components/cinematic/Cinematic.tsx +1093 -0
  10. package/template/components/cinematic/Device3D.tsx +324 -0
  11. package/template/components/cinematic/devices3d/display-model.ts +184 -0
  12. package/template/components/cinematic/devices3d/iphone-model.ts +643 -0
  13. package/template/components/cinematic/devices3d/macbook-model.ts +604 -0
  14. package/template/components/cinematic/devices3d/models.ts +657 -0
  15. package/template/components/cinematic/devices3d/runtime.ts +267 -0
  16. package/template/components/cinematic/math.ts +100 -0
  17. package/template/components/dot-trace-title/DotTraceTitle.tsx +181 -0
  18. package/template/components/dot-trace-title/meta.json +51 -0
  19. package/template/components/generate/GenerateReveal.tsx +381 -0
  20. package/template/components/index.ts +36 -0
  21. package/template/components/lib.ts +18 -6
  22. package/template/components/loops/LoopCanvas.tsx +132 -0
  23. package/template/components/loops/engine.ts +184 -0
  24. package/template/components/loops/library.ts +667 -0
  25. package/template/components/loops/library2.ts +777 -0
  26. package/template/components/motion-loop/MotionLoop.tsx +37 -0
  27. package/template/components/motion-loop/meta.json +312 -0
  28. package/template/skill/SKILL.md +16 -1
  29. package/template/skill/references/browser-export.md +61 -61
  30. package/template/skill/references/cinematic.md +184 -0
  31. package/template/skill/references/loops.md +151 -0
@@ -66,11 +66,15 @@ const MANAGED_DEPENDENCIES = {
66
66
  "@remotion/noise": REMOTION_VERSION,
67
67
  "@remotion/light-leaks": REMOTION_VERSION,
68
68
  "@remotion/cli": REMOTION_VERSION,
69
+ // The cinematic toolkit's 3D devices (agentcut/components) for local renders.
70
+ three: "0.183.2",
69
71
  react: REACT_VERSION,
70
72
  "react-dom": REACT_VERSION,
71
73
  };
72
74
  const MANAGED_DEV_DEPENDENCIES = {
73
75
  "@types/react": "^19.2.0",
76
+ // three ships no types; the workspace typecheck covers agentcut/components (Device3D).
77
+ "@types/three": "0.183.1",
74
78
  typescript: "^5.8.3",
75
79
  };
76
80
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/studio/workspace.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/studio/workspace.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentcut",
3
- "version": "0.2.4",
3
+ "version": "0.2.6",
4
4
  "description": "Local helper for Agentcut: runs your coding agent (Claude Code or Codex), your video workspace and live preview bundles for the Agentcut studio page.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -206,6 +206,33 @@ Examples:
206
206
  - Single band: `{"rows":["New in Agentcut"],"tilt":0,"background":"transparent","size":12,"font":"wide","weight":"800","outline":false,"uppercase":false,"accent":"#a3e635"}`
207
207
  - Editorial: `{"rows":["Launch","Tutorial","Demo"],"font":"serif","uppercase":false,"background":"#f5f1e8","color":"#1c1917","accent":"#dc2626","tilt":0,"separator":"—"}`
208
208
 
209
+ ## Motion Loop (`motion-loop`) · Backgrounds
210
+
211
+ A seamless motion loop in your brand colours: 44 loops across backgrounds, shapes, symmetry (kaleidoscope, mandala, spirograph), shape morphing, little games (snake, pong, falling blocks, Game of Life), physics (Newton's cradle, gears, dominoes) and generative pieces, each a pure function of time that never shows a seam.
212
+
213
+ Use when: Behind titles, product shots, quotes and end cards; between shots; as a shape centerpiece over a background (transparent). Rotate loops: never the same loop twice in a row, and pick by mood (see each option). Set accent/accent2 to the brand colours and choose the tone: dark (deep brand background), accent (solid brand colour), light (paper). Change seed for another layout of the same loop.
214
+
215
+ Good length: 360 frames at 30 fps · layer: full
216
+
217
+ | prop | type | default | notes |
218
+ |---|---|---|---|
219
+ | loop | select | `"gradient-blobs"` | perspective-grid / dot-wave / flow-lines / gradient-blobs / stripes-scroll / concentric-pulse / checker-twist / halftone-sweep / terrain-ridges / starfield-warp / bokeh-drift / iso-cubes / ribbon-weave / tile-mosaic / orbit-rings / morph-blob / bouncing-ball / spinner-petals / stacked-squares / ripple-drop / cube-spin / dna-helix / pie-burst / wave-bars / kaleidoscope / mandala-bloom / spirograph / mirror-tiles / radial-burst / shape-morph / morph-grid / shape-shuffle / metaballs / snake-game / falling-blocks / pong / life-gliders / newtons-cradle / clock-gears / liquid-fill / domino-wave / vortex / lissajous-trail / bubble-pop |
220
+ | tone | select | `"dark"` | dark / accent / light |
221
+ | accent | color | `"#7c5cff"` | |
222
+ | accent2 | color | `"#ff5ca8"` | |
223
+ | speed | number | `1` | 0.25–3 × · Any speed is seamless within the clip. To repeat the clip itself, make its length × speed a multiple of 12 s. |
224
+ | seed | number | `0` | 0–99 |
225
+ | transparent | boolean | `false` | No background: a shape over footage or another layer. |
226
+ | blur | number | `4` | 1–12 · Sub-frames per frame in the export (the preview shows 1). |
227
+ | fade | boolean | `true` | |
228
+
229
+ Examples:
230
+ - Brand mesh: `{}`
231
+ - Synth grid: `{"loop":"perspective-grid","accent":"#22d3ee","accent2":"#f472b6"}`
232
+ - Paper dots: `{"loop":"dot-wave","tone":"light","accent":"#f97316"}`
233
+ - Orbit on brand: `{"loop":"orbit-rings","tone":"accent","accent":"#2563eb","accent2":"#facc15"}`
234
+ - Iso city: `{"loop":"iso-cubes","accent":"#10b981","accent2":"#f59e0b"}`
235
+
209
236
  ## Spotlight Grid (`spotlight-grid`) · Backgrounds
210
237
 
211
238
  A dark technical grid of lines or dots, fading toward the edges, with a colored spotlight that roams over it and lights it up.
@@ -780,6 +807,31 @@ Examples:
780
807
  - Access granted: `{"lines":["ACCESS","*GRANTED*"],"glyphs":"binary","accent":"#4ade80","background":"#050805","size":10}`
781
808
  - Neo Tokyo: `{"lines":["*Hello*, operator"],"glyphs":"katakana","accent":"#f472b6","font":"grotesk","weight":"700"}`
782
809
 
810
+ ## Dot Trace Title (`dot-trace-title`) · Text & Titles
811
+
812
+ A headline that looks generated by an agent: a scan line traces the letters in dots, the dots swell into the glyphs, and the real type resolves out of a blur.
813
+
814
+ Use when: AI products, agents, 'built by AI', launches of generative features, the moment a product creates something; also a techy title card for dev tools. Two or three short words per line. Mark the accent word with *stars*.
815
+
816
+ Good length: 90 frames at 30 fps · layer: overlay
817
+
818
+ | prop | type | default | notes |
819
+ |---|---|---|---|
820
+ | lines | lines | `["Generated","by *agents*"]` | One line per row. *Starred* words (or a *starred phrase*) use the accent. |
821
+ | font | select | `"display"` | display / sans / grotesk / wide / serif / mono / condensed |
822
+ | weight | select | `"800"` | 500 / 700 / 800 |
823
+ | size | number | `18` | 6–34 % of frame · Type size: this share of the frame's short side, times 0.9 (18 is about 16% of the short side). |
824
+ | color | color | `"#ffffff"` | |
825
+ | accent | color | `"#7c5cff"` | |
826
+ | background | color | `"transparent"` | |
827
+ | dot | number | `9` | 4–24 px · Dot spacing in px at 1080p on the short side; it scales with the frame size. |
828
+ | build | number | `1.8` | 0.6–5 s |
829
+
830
+ Examples:
831
+ - Generated: `{}`
832
+ - On paper: `{"lines":["Your site,","*built*"],"color":"#111111","accent":"#f97316","background":"#f5f3ee","font":"grotesk"}`
833
+ - Mono: `{"lines":["npx agentcut"],"font":"mono","weight":"700","accent":"#22d3ee","size":12}`
834
+
783
835
  ## Editorial Quote (`editorial-quote`) · Text & Titles
784
836
 
785
837
  A magazine-style pull quote: large serif lines drift up out of a soft blur, then the author's name draws in under a rule.
@@ -1,61 +1,70 @@
1
- # Agentcut motion components
2
-
3
- Ready-made Remotion animations that people and Claude drop on the Agentcut timeline and tune
4
- through props, without writing a scene. The same code runs in the studio preview, the browser export,
5
- a local render and the public gallery.
6
-
7
- ## How a component is used
8
-
9
- In a project's `layers.json`, a scene-track clip names the component instead of a scene file:
10
-
11
- ```json
12
- { "id": "title", "from": 0, "duration": 90, "component": "text-reveal",
13
- "props": { "lines": ["Make videos", "with *Claude*"], "accent": "#34d399" } }
14
- ```
15
-
16
- Props left out get their defaults. The inspector shows a form for them; Claude finds components with
17
- `agentcut_components`.
18
-
19
- ## Add a component
20
-
21
- 1. Make a folder: `motion/components/<id>/` (kebab-case id).
22
- 2. `<Name>.tsx`: a React component that takes `MotionBaseProps` (width, height, fps, durationInFrames,
23
- variant) plus its props. Rules:
24
- - Animate only from `useCurrentFrame()` (no timers, no `Math.random()` without a seed), so the
25
- preview, the export and every re-render match frame for frame.
26
- - Import only `react`, `remotion`, `../lib` and `../looks`. No CSS 3D (`perspective`, `preserve-3d`),
27
- `backdrop-filter`, `mix-blend-mode` or inset shadows: the browser export can't draw them.
28
- - Radial gradients: the browser export only draws centered, unsized ones
29
- (`radial-gradient(color 0%, transparent 70%)`). For a glow at a point use `glowStyle()`, and fade
30
- to `alpha(color, 0)` rather than `transparent`. Blur with `blurStyle()` so the blur isn't clipped.
31
- SVG (filters, masks, patterns) is drawn as an image, so it renders exactly.
32
- - Fonts: use `FONTS` (Inter, Bricolage, Instrument Serif, Fraunces, Space Grotesk, Syne, Unbounded,
33
- Anton, Geist Mono). The registry loads them before any frame renders.
34
- - Size everything from `unit(width, height)` so it works in wide (16:9) and mobile (9:16).
35
- - Fit any clip length: enter at the start, use `exitOut()` for the end.
36
- - `layer: "overlay"` components keep a transparent background unless a `background` prop is set.
37
- 3. `meta.json`: id, name, category, description, `useWhen` (when Claude should pick it), a good
38
- `durationInFrames`, tags, `props` (each with type, label, default and limits) and 2–3 `examples`.
39
- 4. Let it follow project styles: tag the props that carry the look with a token, e.g.
40
- `"accent": { "type": "color", "style": "accent", … }`. Tokens: `look`, `font`, `weight`, `text` (text over
41
- footage), `accent`, `onAccent`, `panel`, `panelText`, `line`, `theme`, `backdrop` (see `styles.ts`). Leave a
42
- component untagged when its look is the point (arcade, collage, platform mock-ups).
43
- 5. Register it: its meta in `catalog.ts` and its component in `COMPONENTS` in `index.ts`.
44
- 6. Check it: open the gallery (`/motion/components`) and look at it in wide and mobile, then
45
- `npm run verify:components` (registration, defaults, examples and style tags).
46
-
47
- ## Project styles
48
-
49
- A style is a whole editing preset. `looks.tsx` draws its graphic language (ink, paper, notebook,
50
- crt, clean: cards, word chips, stickers, backdrops, entrances); the Talking Head components are
51
- layouts built from it, so they restyle completely with the `look` prop. `style-layer.tsx` is what the
52
- studio runtime calls for a project with a style: the camera on footage clips, the texture over the
53
- frame and captions drawn in the look.
54
-
55
- `styles.json` holds the styles a project can pick (`"style": "loud"` in project.json, or the Style
56
- list in the studio's Project panel). A tagged prop the clip leaves out takes the style's value;
57
- caption and text clips take the style's fonts and colors. Add a style there; `verify:components`
58
- checks that its font lands on every component that takes one.
59
-
60
- The helper gets a copy of this folder for local renders and for Claude to read
61
- (`npm run sync:skill` in packages/agentcut copies the skill and the components).
1
+ # Agentcut motion components
2
+
3
+ Ready-made Remotion animations that people and Claude drop on the Agentcut timeline and tune
4
+ through props, without writing a scene. The same code runs in the studio preview, the browser export,
5
+ a local render and the public gallery.
6
+
7
+ ## How a component is used
8
+
9
+ In a project's `layers.json`, a scene-track clip names the component instead of a scene file:
10
+
11
+ ```json
12
+ { "id": "title", "from": 0, "duration": 90, "component": "text-reveal",
13
+ "props": { "lines": ["Make videos", "with *Claude*"], "accent": "#34d399" } }
14
+ ```
15
+
16
+ Props left out get their defaults. The inspector shows a form for them; Claude finds components with
17
+ `agentcut_components`.
18
+
19
+ ## Add a component
20
+
21
+ 1. Make a folder: `motion/components/<id>/` (kebab-case id).
22
+ 2. `<Name>.tsx`: a React component that takes `MotionBaseProps` (width, height, fps, durationInFrames,
23
+ variant) plus its props. Rules:
24
+ - Animate only from `useCurrentFrame()` (no timers, no `Math.random()` without a seed), so the
25
+ preview, the export and every re-render match frame for frame.
26
+ - Import only `react`, `remotion`, `../lib` and `../looks` (and `../cinematic/Cinematic` for 3D,
27
+ `../loops/*` for motion loops). No CSS 3D (`perspective`, `preserve-3d`),
28
+ `backdrop-filter`, `mix-blend-mode` or inset shadows: the browser export can't draw them.
29
+ - Radial gradients: the browser export only draws centered, unsized ones
30
+ (`radial-gradient(color 0%, transparent 70%)`). For a glow at a point use `glowStyle()`, and fade
31
+ to `alpha(color, 0)` rather than `transparent`. Blur with `blurStyle()` so the blur isn't clipped.
32
+ SVG (filters, masks, patterns) is drawn as an image, so it renders exactly.
33
+ - Fonts: use `FONTS` (Inter, Bricolage, Instrument Serif, Fraunces, Space Grotesk, Syne, Unbounded,
34
+ Anton, Geist Mono). The registry loads them before any frame renders.
35
+ - Size everything from `unit(width, height)` so it works in wide (16:9) and mobile (9:16).
36
+ - Fit any clip length: enter at the start, use `exitOut()` for the end.
37
+ - `layer: "overlay"` components keep a transparent background unless a `background` prop is set.
38
+ 3. `meta.json`: id, name, category, description, `useWhen` (when Claude should pick it), a good
39
+ `durationInFrames`, tags, `props` (each with type, label, default and limits) and 2–3 `examples`.
40
+ 4. Let it follow project styles: tag the props that carry the look with a token, e.g.
41
+ `"accent": { "type": "color", "style": "accent", … }`. Tokens: `look`, `font`, `weight`, `text` (text over
42
+ footage), `accent`, `onAccent`, `panel`, `panelText`, `line`, `theme`, `backdrop` (see `styles.ts`). Leave a
43
+ component untagged when its look is the point (arcade, collage, platform mock-ups).
44
+ 5. Register it: its meta in `catalog.ts` and its component in `COMPONENTS` in `index.ts`.
45
+ 6. Check it: open the gallery (`/motion/components`) and look at it in wide and mobile, then
46
+ `npm run verify:components` (registration, defaults, examples and style tags).
47
+
48
+ ## Cinematic toolkit
49
+
50
+ `cinematic/` is not a timeline component: it's the 3D camera scenes import from `agentcut/components`
51
+ (`Stage`, `Plane`, `Screen`, `Lift`, `Group`, `Device`, `Backdrop`, `Floor`, `Glare`). The stage computes
52
+ one `matrix3d()` per plane (camera, lens, placement), which the preview draws natively and the browser
53
+ export draws through WebGL; lens blur is a gradient between blurred copies along each plane's depth.
54
+ The skill's `references/cinematic.md` is how Claude directs it.
55
+
56
+ ## Project styles
57
+
58
+ A style is a whole editing preset. `looks.tsx` draws its graphic language (ink, paper, notebook,
59
+ crt, clean: cards, word chips, stickers, backdrops, entrances); the Talking Head components are
60
+ layouts built from it, so they restyle completely with the `look` prop. `style-layer.tsx` is what the
61
+ studio runtime calls for a project with a style: the camera on footage clips, the texture over the
62
+ frame and captions drawn in the look.
63
+
64
+ `styles.json` holds the styles a project can pick (`"style": "loud"` in project.json, or the Style
65
+ list in the studio's Project panel). A tagged prop the clip leaves out takes the style's value;
66
+ caption and text clips take the style's fonts and colors. Add a style there; `verify:components`
67
+ checks that its font lands on every component that takes one.
68
+
69
+ The helper gets a copy of this folder for local renders and for Claude to read
70
+ (`npm run sync:skill` in packages/agentcut copies the skill and the components).
@@ -217,6 +217,7 @@ Reach for:
217
217
  | `bento-grid` | accent (accent), theme (theme), font (font) |
218
218
  | `prompt-box` | theme (theme), accent (accent) |
219
219
  | `marquee` | color (text), accent (accent), background (backdrop), font (font), weight (weight) |
220
+ | `motion-loop` | accent (accent) |
220
221
  | `line-diagram` | color (line), accent (accent), font (font) |
221
222
  | `stat-counter` | accent (accent), textColor (text) |
222
223
  | `checklist` | accent (accent), theme (theme) |
@@ -231,6 +232,7 @@ Reach for:
231
232
  | `bar-wipe-title` | color (text), accent (accent), weight (weight), font (font) |
232
233
  | `blur-in-title` | color (text), accent (accent), weight (weight), font (font) |
233
234
  | `countdown` | color (text), accent (accent), font (font) |
235
+ | `dot-trace-title` | font (font), weight (weight), color (text), accent (accent) |
234
236
  | `editorial-quote` | color (text), accent (accent), font (font) |
235
237
  | `highlighter` | color (text), marker (accent), markedText (onAccent), weight (weight), font (font) |
236
238
  | `kinetic-punch` | color (text), accent (accent), background (backdrop), flashBackground (backdrop), font (font), weight (weight) |