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.
Files changed (3) hide show
  1. package/README.md +45 -72
  2. package/dist/cli.js +4948 -33
  3. 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
- Frame files can import `react` and `vizmatic`; the CLI resolves those from its own package runtime in `dlx`/`npx` mode.
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
- import React from "react"
58
- import { defineIllustration, Flow, Scene } from "vizmatic"
59
-
60
- export const width = 1040
61
- export const height = 560
62
-
63
- const frame = defineIllustration((c) => (
64
- <Scene c={c} title="Agent visual pipeline">
65
- <Flow
66
- c={c}
67
- stages={[
68
- { title: "Prompt", subtitle: "intent", tone: "blue" },
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
- import { defineIllustration, Flow, Scene } from "vizmatic"
165
-
166
- export const width = 1040
167
- export const height = 560
168
-
169
- const frame = defineIllustration((c) =>
170
- <Scene c={c} title="Agent pipeline">
171
- <Flow c={c} stages={[
172
- { title: "Prompt", tone: "blue" },
173
- { title: "Scene spec", tone: "purple" },
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
- import React from "react"
189
- import { CalloutCard, defineIllustration, Flow, Row, Scene } from "vizmatic"
190
-
191
- export const width = 1040
192
- export const height = 560
193
-
194
- const frame = defineIllustration((c) => (
195
- <Scene c={c} title="Agent visual pipeline" subtitle="prompt -> scene spec -> verified artifact" gap={26}>
196
- <Flow
197
- c={c}
198
- connectorTone="purple"
199
- stages={[
200
- { eyebrow: "input", title: "Prompt", subtitle: "intent", tone: "blue", lines: ["goal", "audience", "constraints"], width: 190 },
201
- { eyebrow: "contract", title: "Scene spec", subtitle: "typed structure", tone: "purple", lines: ["cards", "flows", "charts"], width: 190 },
202
- { eyebrow: "render", title: "Satori", subtitle: "React primitives", tone: "cyan", lines: ["layout", "theme", "safe text"], width: 190 },
203
- { eyebrow: "output", title: "PNG / GIF", subtitle: "verified asset", tone: "green", lines: ["autocrop", "overflow checks"], width: 190 },
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 typecheck` | Type safety across `src/`, `examples/`, `scripts/`, and tests |
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 security:audit` | Fails on known low-or-higher npm advisories |
379
- | `npm pack --dry-run` | Published package contents before release |
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
- pnpm verify
386
- git diff --exit-code
359
+ ./test.sh
387
360
  ```
388
361
 
389
362
  ## Supply Chain Posture