vizmatic 0.1.5 → 0.1.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.
- package/README.md +45 -72
- package/dist/cli.js +4948 -33
- package/package.json +6 -4
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ Use Vizmatic as a one-off binary without touching `package.json`:
|
|
|
37
37
|
pnpm dlx vizmatic ./frame.tsx --out ./dist/frames --theme dark,light
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
Bare CLI frames auto-import Vizmatic primitives and inject theme colors. Use normal imports when a frame needs helpers, data loading, custom dependencies, or direct renderer APIs.
|
|
41
41
|
|
|
42
42
|
Install it when you want project scripts, editor types, or direct renderer APIs:
|
|
43
43
|
|
|
@@ -54,27 +54,18 @@ pnpm add github:bvolpato/vizmatic react
|
|
|
54
54
|
Create a frame:
|
|
55
55
|
|
|
56
56
|
```tsx
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
{ title: "Scene spec", subtitle: "typed structure", tone: "purple" },
|
|
70
|
-
{ title: "PNG / SVG / GIF", subtitle: "rendered artifact", tone: "green" },
|
|
71
|
-
]}
|
|
72
|
-
/>
|
|
73
|
-
</Scene>
|
|
74
|
-
))
|
|
75
|
-
|
|
76
|
-
export const create = frame.create
|
|
77
|
-
export default frame.default
|
|
57
|
+
width = 1040
|
|
58
|
+
height = 560
|
|
59
|
+
|
|
60
|
+
<Scene title="Agent visual pipeline">
|
|
61
|
+
<Flow
|
|
62
|
+
stages={[
|
|
63
|
+
{ title: "Prompt", subtitle: "intent", tone: "blue" },
|
|
64
|
+
{ title: "Scene spec", subtitle: "typed structure", tone: "purple" },
|
|
65
|
+
{ title: "PNG / SVG / GIF", subtitle: "rendered artifact", tone: "green" },
|
|
66
|
+
]}
|
|
67
|
+
/>
|
|
68
|
+
</Scene>
|
|
78
69
|
```
|
|
79
70
|
|
|
80
71
|
Render it:
|
|
@@ -161,23 +152,16 @@ More examples live in [`examples/`](examples) and on the [website](https://bvolp
|
|
|
161
152
|
Use this for small docs snippets and quick agent-generated frames.
|
|
162
153
|
|
|
163
154
|
```tsx
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
{ title: "PNG / GIF", tone: "green" },
|
|
175
|
-
]} />
|
|
176
|
-
</Scene>
|
|
177
|
-
)
|
|
178
|
-
|
|
179
|
-
export const create = frame.create
|
|
180
|
-
export default frame.default
|
|
155
|
+
width = 1040
|
|
156
|
+
height = 560
|
|
157
|
+
|
|
158
|
+
<Scene title="Agent pipeline">
|
|
159
|
+
<Flow stages={[
|
|
160
|
+
{ title: "Prompt", tone: "blue" },
|
|
161
|
+
{ title: "Scene spec", tone: "purple" },
|
|
162
|
+
{ title: "PNG / GIF", tone: "green" },
|
|
163
|
+
]} />
|
|
164
|
+
</Scene>
|
|
181
165
|
```
|
|
182
166
|
|
|
183
167
|
### Flow + callouts
|
|
@@ -185,33 +169,24 @@ export default frame.default
|
|
|
185
169
|
Use this for process diagrams, architecture walkthroughs, and agent pipelines.
|
|
186
170
|
|
|
187
171
|
```tsx
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
<Row width="100%" gap={14}>
|
|
207
|
-
<CalloutCard c={c} title="Model writes structure" detail="No hand-written SVG paths." tone="purple" width={470} />
|
|
208
|
-
<CalloutCard c={c} title="Theme stays in control" detail="Colors and typography come from tokens." tone="green" width={470} />
|
|
209
|
-
</Row>
|
|
210
|
-
</Scene>
|
|
211
|
-
))
|
|
212
|
-
|
|
213
|
-
export const create = frame.create
|
|
214
|
-
export default frame.default
|
|
172
|
+
width = 1040
|
|
173
|
+
height = 560
|
|
174
|
+
|
|
175
|
+
<Scene title="Agent visual pipeline" subtitle="prompt -> scene spec -> verified artifact" gap={26}>
|
|
176
|
+
<Flow
|
|
177
|
+
connectorTone="purple"
|
|
178
|
+
stages={[
|
|
179
|
+
{ eyebrow: "input", title: "Prompt", subtitle: "intent", tone: "blue", lines: ["goal", "audience", "constraints"], width: 190 },
|
|
180
|
+
{ eyebrow: "contract", title: "Scene spec", subtitle: "typed structure", tone: "purple", lines: ["cards", "flows", "charts"], width: 190 },
|
|
181
|
+
{ eyebrow: "render", title: "Satori", subtitle: "React primitives", tone: "cyan", lines: ["layout", "theme", "safe text"], width: 190 },
|
|
182
|
+
{ eyebrow: "output", title: "PNG / GIF", subtitle: "verified asset", tone: "green", lines: ["autocrop", "overflow checks"], width: 190 },
|
|
183
|
+
]}
|
|
184
|
+
/>
|
|
185
|
+
<Row width="100%" gap={14}>
|
|
186
|
+
<CalloutCard title="Model writes structure" detail="No hand-written SVG paths." tone="purple" width={470} />
|
|
187
|
+
<CalloutCard title="Theme stays in control" detail="Colors and typography come from tokens." tone="green" width={470} />
|
|
188
|
+
</Row>
|
|
189
|
+
</Scene>
|
|
215
190
|
```
|
|
216
191
|
|
|
217
192
|
### Animated GIF
|
|
@@ -371,19 +346,17 @@ Vizmatic treats generated visuals as source-controlled build artifacts. CI fails
|
|
|
371
346
|
|
|
372
347
|
| Gate | What it protects |
|
|
373
348
|
|---|---|
|
|
374
|
-
| `pnpm
|
|
349
|
+
| `pnpm lint` | Static TypeScript coverage across `src/`, `examples/`, `scripts/`, and tests |
|
|
375
350
|
| `pnpm test` | Render pipeline behavior, watermark options, and output validation |
|
|
376
351
|
| `pnpm render:examples` | Dark/light PNGs, animated GIFs, source snippets, and website HTML |
|
|
377
352
|
| `pnpm docs:check` | Local asset references, `PROMPT.md` sync, source modal themes, and homepage affordances |
|
|
378
|
-
| `pnpm
|
|
379
|
-
| `
|
|
380
|
-
| CI generated-file check | Ensures rendered docs/examples are committed |
|
|
353
|
+
| `pnpm deps:check` | npm audit plus package tarball contents before release |
|
|
354
|
+
| `./test.sh` drift check | Ensures render/docs commands do not create extra changes |
|
|
381
355
|
|
|
382
356
|
Run the full local gate:
|
|
383
357
|
|
|
384
358
|
```bash
|
|
385
|
-
|
|
386
|
-
git diff --exit-code
|
|
359
|
+
./test.sh
|
|
387
360
|
```
|
|
388
361
|
|
|
389
362
|
## Supply Chain Posture
|