vizmatic 0.1.0

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 (57) hide show
  1. package/LICENSE +21 -0
  2. package/PROMPT.md +500 -0
  3. package/README.md +530 -0
  4. package/dist/chunk-ADU7JROD.js +627 -0
  5. package/dist/cli.d.ts +1 -0
  6. package/dist/cli.js +303 -0
  7. package/dist/index.d.ts +1433 -0
  8. package/dist/index.js +4702 -0
  9. package/docs/PROMPT.md +500 -0
  10. package/docs/assets/examples/.gitkeep +1 -0
  11. package/docs/assets/examples/agent-pipeline_dark.png +0 -0
  12. package/docs/assets/examples/agent-pipeline_light.png +0 -0
  13. package/docs/assets/examples/animated-pipeline_dark.gif +0 -0
  14. package/docs/assets/examples/animated-pipeline_dark.png +0 -0
  15. package/docs/assets/examples/animated-pipeline_light.gif +0 -0
  16. package/docs/assets/examples/animated-pipeline_light.png +0 -0
  17. package/docs/assets/examples/attention-head_dark.png +0 -0
  18. package/docs/assets/examples/attention-head_light.png +0 -0
  19. package/docs/assets/examples/embedding-map_dark.png +0 -0
  20. package/docs/assets/examples/embedding-map_light.png +0 -0
  21. package/docs/assets/examples/eval-dashboard_dark.png +0 -0
  22. package/docs/assets/examples/eval-dashboard_light.png +0 -0
  23. package/docs/assets/examples/gif-manifest.json +12 -0
  24. package/docs/assets/examples/manifest.json +108 -0
  25. package/docs/assets/examples/model-router_dark.png +0 -0
  26. package/docs/assets/examples/model-router_light.png +0 -0
  27. package/docs/assets/examples/presentation-frame_dark.png +0 -0
  28. package/docs/assets/examples/presentation-frame_light.png +0 -0
  29. package/docs/assets/examples/rag-graph_dark.png +0 -0
  30. package/docs/assets/examples/rag-graph_light.png +0 -0
  31. package/docs/assets/examples/release-card_dark.png +0 -0
  32. package/docs/assets/examples/release-card_light.png +0 -0
  33. package/docs/assets/examples/research-landscape_dark.png +0 -0
  34. package/docs/assets/examples/research-landscape_light.png +0 -0
  35. package/docs/assets/examples/sources.json +93 -0
  36. package/docs/assets/examples/spec-anatomy_dark.png +0 -0
  37. package/docs/assets/examples/spec-anatomy_light.png +0 -0
  38. package/docs/assets/examples/theme-system_dark.png +0 -0
  39. package/docs/assets/examples/theme-system_light.png +0 -0
  40. package/docs/assets/examples/token-matrix_dark.png +0 -0
  41. package/docs/assets/examples/token-matrix_light.png +0 -0
  42. package/docs/assets/icon.svg +16 -0
  43. package/docs/assets/logo.svg +30 -0
  44. package/examples/agent-pipeline.tsx +27 -0
  45. package/examples/animated-pipeline.tsx +72 -0
  46. package/examples/attention-head.tsx +27 -0
  47. package/examples/embedding-map.tsx +34 -0
  48. package/examples/eval-dashboard.tsx +44 -0
  49. package/examples/model-router.tsx +35 -0
  50. package/examples/presentation-frame.tsx +32 -0
  51. package/examples/rag-graph.tsx +36 -0
  52. package/examples/release-card.tsx +39 -0
  53. package/examples/research-landscape.tsx +34 -0
  54. package/examples/spec-anatomy.tsx +44 -0
  55. package/examples/theme-system.tsx +30 -0
  56. package/examples/token-matrix.tsx +49 -0
  57. package/package.json +84 -0
package/dist/cli.js ADDED
@@ -0,0 +1,303 @@
1
+ #!/usr/bin/env node
2
+ import {
3
+ renderAnimatedGif,
4
+ renderToPng
5
+ } from "./chunk-ADU7JROD.js";
6
+
7
+ // src/cli.ts
8
+ import { mkdir, readFile, readdir, writeFile } from "fs/promises";
9
+ import { basename, extname, join, relative, resolve } from "path";
10
+ import { pathToFileURL } from "url";
11
+ var RENDER_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".jsx", ".mjs", ".ts", ".tsx"]);
12
+ function usage() {
13
+ console.error(`Usage:
14
+ vizmatic render <file-or-directory...> --out <dir> [--theme dark,light] [--watermark Label] [--watermark-image path-or-url] [--watermark-position top-right] [--no-crop] [--force]
15
+ vizmatic gif <file-or-directory...> --out <dir> [--theme dark] [--watermark Label] [--watermark-image path-or-url] [--watermark-position top-right] [--scale 1]
16
+
17
+ Examples:
18
+ vizmatic render examples --out docs/assets/examples --theme dark --watermark Vizmatic
19
+ vizmatic render frames/attention.tsx --out dist/frames --theme dark,light
20
+ vizmatic gif examples/animated-pipeline.tsx --out docs/assets/examples --theme dark --watermark Vizmatic`);
21
+ process.exit(1);
22
+ }
23
+ var WATERMARK_POSITIONS = /* @__PURE__ */ new Set(["top-left", "top-right", "bottom-left", "bottom-right"]);
24
+ var IMAGE_MIME_BY_EXT = {
25
+ ".apng": "image/apng",
26
+ ".avif": "image/avif",
27
+ ".gif": "image/gif",
28
+ ".jpg": "image/jpeg",
29
+ ".jpeg": "image/jpeg",
30
+ ".png": "image/png",
31
+ ".svg": "image/svg+xml",
32
+ ".webp": "image/webp"
33
+ };
34
+ function imageMime(source) {
35
+ return IMAGE_MIME_BY_EXT[extname(source).toLowerCase()] ?? "application/octet-stream";
36
+ }
37
+ async function imageSourceToDataUri(source) {
38
+ if (/^(data:|https?:\/\/)/i.test(source)) return source;
39
+ const filePath = resolve(source);
40
+ const data = await readFile(filePath);
41
+ return `data:${imageMime(filePath)};base64,${data.toString("base64")}`;
42
+ }
43
+ async function resolveWatermarkAssets(watermark) {
44
+ if (watermark == null || typeof watermark !== "object") return watermark;
45
+ if (!watermark.image) return watermark;
46
+ if (typeof watermark.image === "string") {
47
+ return {
48
+ ...watermark,
49
+ image: await imageSourceToDataUri(watermark.image)
50
+ };
51
+ }
52
+ return {
53
+ ...watermark,
54
+ image: {
55
+ ...watermark.image,
56
+ src: await imageSourceToDataUri(watermark.image.src)
57
+ }
58
+ };
59
+ }
60
+ function parseRenderArgs(argv) {
61
+ const inputs = [];
62
+ let outDir = "dist/frames";
63
+ let themes = ["dark", "light"];
64
+ let watermark;
65
+ let watermarkOptions;
66
+ let force = false;
67
+ let crop = true;
68
+ let scale;
69
+ function mutableWatermark() {
70
+ if (!watermarkOptions) {
71
+ watermarkOptions = typeof watermark === "object" && watermark !== null ? { ...watermark } : {};
72
+ if (typeof watermark === "string") watermarkOptions.text = watermark;
73
+ watermark = watermarkOptions;
74
+ }
75
+ return watermarkOptions;
76
+ }
77
+ function readOptionalValue(index) {
78
+ const next = argv[index + 1];
79
+ if (!next || next.startsWith("-")) return void 0;
80
+ return next;
81
+ }
82
+ function setWatermarkImageSource(src) {
83
+ const current = mutableWatermark().image;
84
+ if (current && typeof current === "object") {
85
+ current.src = src;
86
+ } else {
87
+ mutableWatermark().image = src;
88
+ }
89
+ }
90
+ function mutableWatermarkImage() {
91
+ const watermarkConfig = mutableWatermark();
92
+ if (!watermarkConfig.image || typeof watermarkConfig.image === "string") {
93
+ watermarkConfig.image = { src: watermarkConfig.image ?? "" };
94
+ }
95
+ return watermarkConfig.image;
96
+ }
97
+ for (let index = 0; index < argv.length; index += 1) {
98
+ const arg = argv[index];
99
+ if (!arg) continue;
100
+ if (arg === "--out") {
101
+ outDir = argv[++index] ?? usage();
102
+ } else if (arg === "--theme") {
103
+ const raw = argv[++index] ?? usage();
104
+ themes = raw.split(",").map((theme) => theme.trim()).filter(Boolean);
105
+ if (themes.some((theme) => theme !== "dark" && theme !== "light")) usage();
106
+ } else if (arg === "--brand") {
107
+ const label = argv[++index] ?? "Vizmatic";
108
+ mutableWatermark().text = label;
109
+ } else if (arg === "--watermark") {
110
+ const label = readOptionalValue(index);
111
+ if (label) {
112
+ mutableWatermark().text = label;
113
+ index += 1;
114
+ } else {
115
+ watermark = true;
116
+ watermarkOptions = void 0;
117
+ }
118
+ } else if (arg === "--watermark-text") {
119
+ const rawText = argv[++index] ?? usage();
120
+ mutableWatermark().text = rawText === "false" || rawText === "none" ? false : rawText;
121
+ } else if (arg === "--watermark-icon") {
122
+ const rawIcon = argv[++index] ?? usage();
123
+ mutableWatermark().icon = rawIcon === "false" || rawIcon === "none" ? false : rawIcon;
124
+ } else if (arg === "--watermark-image") {
125
+ setWatermarkImageSource(argv[++index] ?? usage());
126
+ } else if (arg === "--watermark-image-width") {
127
+ const width = Number(argv[++index]);
128
+ if (!Number.isFinite(width) || width <= 0) usage();
129
+ mutableWatermarkImage().width = width;
130
+ } else if (arg === "--watermark-image-height") {
131
+ const height = Number(argv[++index]);
132
+ if (!Number.isFinite(height) || height <= 0) usage();
133
+ mutableWatermarkImage().height = height;
134
+ } else if (arg === "--watermark-position") {
135
+ const position = argv[++index];
136
+ if (!position || !WATERMARK_POSITIONS.has(position)) usage();
137
+ mutableWatermark().position = position;
138
+ } else if (arg === "--no-brand") {
139
+ watermark = false;
140
+ watermarkOptions = void 0;
141
+ } else if (arg === "--no-watermark") {
142
+ watermark = false;
143
+ watermarkOptions = void 0;
144
+ } else if (arg === "--force") {
145
+ force = true;
146
+ } else if (arg === "--no-crop") {
147
+ crop = false;
148
+ } else if (arg === "--scale") {
149
+ const rawScale = Number(argv[++index]);
150
+ if (!Number.isFinite(rawScale) || rawScale <= 0) usage();
151
+ scale = rawScale;
152
+ } else if (arg.startsWith("-")) {
153
+ usage();
154
+ } else {
155
+ inputs.push(arg);
156
+ }
157
+ }
158
+ if (inputs.length === 0) usage();
159
+ return { inputs, outDir, themes, watermark, force, crop, scale };
160
+ }
161
+ async function findFrameFiles(inputs) {
162
+ const files = [];
163
+ async function walk(path) {
164
+ const resolved = resolve(path);
165
+ const entries = await readdir(resolved, { withFileTypes: true }).catch(() => void 0);
166
+ if (!entries) {
167
+ if (RENDER_EXTENSIONS.has(extname(resolved)) && !resolved.endsWith(".d.ts")) {
168
+ files.push(resolved);
169
+ }
170
+ return;
171
+ }
172
+ for (const entry of entries) {
173
+ const next = join(resolved, entry.name);
174
+ if (entry.isDirectory()) {
175
+ if (entry.name === "node_modules" || entry.name === "dist") continue;
176
+ await walk(next);
177
+ } else if (RENDER_EXTENSIONS.has(extname(entry.name)) && !entry.name.endsWith(".d.ts")) {
178
+ files.push(next);
179
+ }
180
+ }
181
+ }
182
+ for (const input of inputs) {
183
+ await walk(input);
184
+ }
185
+ return files.sort();
186
+ }
187
+ async function importFrame(filePath) {
188
+ const url = pathToFileURL(filePath).href;
189
+ try {
190
+ return await import(url);
191
+ } catch (error) {
192
+ if (!/\.[tj]sx?$/.test(filePath)) throw error;
193
+ const { tsImport } = await import("tsx/esm/api");
194
+ return await tsImport(url, import.meta.url);
195
+ }
196
+ }
197
+ function normalizeFrameModule(mod) {
198
+ const defaultObject = typeof mod.default === "object" && mod.default && "create" in mod.default ? mod.default : void 0;
199
+ return {
200
+ ...mod,
201
+ ...defaultObject ?? {},
202
+ width: mod.width ?? defaultObject?.width ?? 960,
203
+ height: mod.height ?? defaultObject?.height ?? 540
204
+ };
205
+ }
206
+ function frameElement(mod, theme) {
207
+ if (mod.create) return mod.create(theme);
208
+ if (mod.default && !(typeof mod.default === "object" && "create" in mod.default)) return mod.default;
209
+ throw new Error("frame module must export create(theme) or default React element");
210
+ }
211
+ async function renderCommand(argv) {
212
+ const args = parseRenderArgs(argv);
213
+ const cliWatermark = await resolveWatermarkAssets(args.watermark);
214
+ const files = await findFrameFiles(args.inputs);
215
+ if (files.length === 0) throw new Error("no frame files found");
216
+ await mkdir(args.outDir, { recursive: true });
217
+ const manifest = [];
218
+ for (const file of files) {
219
+ const rawMod = await importFrame(file);
220
+ const mod = normalizeFrameModule(rawMod);
221
+ const name = basename(file).replace(/\.[^.]+$/, "");
222
+ const outputs = [];
223
+ const moduleWatermark = await resolveWatermarkAssets(mod.watermark ?? mod.brand);
224
+ for (const theme of args.themes) {
225
+ const outputName = `${name}_${theme}.png`;
226
+ const outputPath = join(args.outDir, outputName);
227
+ await renderToPng(frameElement(mod, theme), {
228
+ width: mod.width,
229
+ height: mod.height,
230
+ outputPath,
231
+ watermark: cliWatermark ?? moduleWatermark,
232
+ crop: args.crop,
233
+ scale: args.scale
234
+ }, mod.create, theme);
235
+ outputs.push(outputName);
236
+ console.log(`rendered ${relative(process.cwd(), outputPath)}`);
237
+ }
238
+ manifest.push({
239
+ name,
240
+ source: relative(process.cwd(), file),
241
+ width: mod.width,
242
+ height: mod.height,
243
+ outputs
244
+ });
245
+ }
246
+ await writeFile(join(args.outDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
247
+ `);
248
+ }
249
+ async function gifCommand(argv) {
250
+ const args = parseRenderArgs(argv);
251
+ const cliWatermark = await resolveWatermarkAssets(args.watermark);
252
+ const files = await findFrameFiles(args.inputs);
253
+ if (files.length === 0) throw new Error("no frame files found");
254
+ await mkdir(args.outDir, { recursive: true });
255
+ const manifest = [];
256
+ for (const file of files) {
257
+ const rawMod = await importFrame(file);
258
+ const mod = normalizeFrameModule(rawMod);
259
+ const name = basename(file).replace(/\.[^.]+$/, "");
260
+ const outputs = [];
261
+ const moduleWatermark = await resolveWatermarkAssets(mod.watermark ?? mod.brand);
262
+ if (!mod.createScenes) {
263
+ throw new Error(`${relative(process.cwd(), file)} must export createScenes(theme) for GIF rendering`);
264
+ }
265
+ for (const theme of args.themes) {
266
+ const outputName = `${name}_${theme}.gif`;
267
+ const outputPath = join(args.outDir, outputName);
268
+ await renderAnimatedGif(mod.createScenes(theme), {
269
+ width: mod.width,
270
+ height: mod.height,
271
+ outputPath,
272
+ watermark: cliWatermark ?? moduleWatermark,
273
+ scale: args.scale ?? 1,
274
+ theme
275
+ });
276
+ outputs.push(outputName);
277
+ console.log(`rendered ${relative(process.cwd(), outputPath)}`);
278
+ }
279
+ manifest.push({
280
+ name,
281
+ source: relative(process.cwd(), file),
282
+ width: mod.width,
283
+ height: mod.height,
284
+ outputs
285
+ });
286
+ }
287
+ await writeFile(join(args.outDir, "gif-manifest.json"), `${JSON.stringify(manifest, null, 2)}
288
+ `);
289
+ }
290
+ async function main() {
291
+ const [command, ...rest] = process.argv.slice(2);
292
+ if (command === "render") {
293
+ await renderCommand(rest);
294
+ } else if (command === "gif") {
295
+ await gifCommand(rest);
296
+ } else {
297
+ usage();
298
+ }
299
+ }
300
+ main().catch((error) => {
301
+ console.error(error instanceof Error ? error.message : String(error));
302
+ process.exit(1);
303
+ });