vizcn 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# vizcn
+
+Agent-first SVG viz registry. **This package is a pointer CLI** — the
+registry itself lives at [vibecoding.tech/vizcn](https://vibecoding.tech/vizcn):
+copy-paste React + inline-SVG forms (no chart libraries) that an AI coding
+agent picks from a catalog by the question the data answers.
+
+```bash
+npx vizcn              # list the forms
+npx vizcn add <name>   # install one (wraps shadcn add)
+npx vizcn prompt       # print a ready-made prompt for your coding agent
+```
+
+Equivalent direct install (any shadcn-initialized project):
+
+```bash
+npx shadcn@latest add https://vibecoding.tech/vizcn/r/<name>.json
+```
+
+Machine-readable catalog with per-form `question` / `whenToUse` / `antiUse`:
+[catalog.json](https://vibecoding.tech/vizcn/catalog.json) ·
+Repo: [github.com/eugeneshilow/vizcn](https://github.com/eugeneshilow/vizcn)
+
+Not affiliated with shadcn — an independent registry following the shadcn
+registry spec.

package/bin.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// vizcn pointer CLI. The registry itself lives on the shelf (shelf.json is
+// generated from registry.config.json — the single home of all URLs).
+import { readFileSync } from 'node:fs'
+import { spawnSync } from 'node:child_process'
+
+const { shelfUrl, registryBase } = JSON.parse(
+  readFileSync(new URL('./shelf.json', import.meta.url), 'utf8'),
+)
+
+const PROMPT = `Add a data visualization to this project from the vizcn registry:
+
+1. Fetch ${shelfUrl}/catalog.json — every form declares the
+   question it answers, whenToUse, and antiUse.
+2. Pick the form whose question matches what my data needs to answer.
+   Respect antiUse. If no form fits, stop and ask — never invent a chart.
+3. Install: npx shadcn@latest add ${registryBase}/<name>.json
+   (no shadcn in the project? run \`npx shadcn@latest init -d\` once,
+   or copy the form file from the repo).
+4. Feed my real data via props — the demo data is fictional reference.`
+
+async function list() {
+  try {
+    const res = await fetch(`${shelfUrl}/catalog.json`)
+    const { forms } = await res.json()
+    console.log(`vizcn — agent-first SVG viz registry · ${forms.length} forms\n`)
+    const pad = Math.max(...forms.map((f) => f.name.length)) + 2
+    for (const f of forms) console.log(`  ${f.name.padEnd(pad)}${f.question}`)
+    console.log(`
+install   npx vizcn add <name>
+          npx shadcn@latest add ${registryBase}/<name>.json
+agents    npx vizcn prompt   (paste the output into your coding agent)
+shelf     ${shelfUrl}`)
+  } catch {
+    console.log(`vizcn — agent-first SVG viz registry`)
+    console.log(`shelf:   ${shelfUrl}`)
+    console.log(`catalog: ${shelfUrl}/catalog.json (couldn't fetch it right now)`)
+  }
+}
+
+const [cmd, ...args] = process.argv.slice(2)
+
+if (cmd === 'add' && args.length > 0) {
+  for (const name of args) {
+    const item = `${registryBase}/${name.replace(/\.json$/, '')}.json`
+    const r = spawnSync('npx', ['shadcn@latest', 'add', item], {
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+    })
+    if (r.status) process.exit(r.status)
+  }
+} else if (cmd === 'prompt') {
+  console.log(PROMPT)
+} else if (cmd === 'add') {
+  console.error('usage: npx vizcn add <form-name> — see `npx vizcn` for the list')
+  process.exit(1)
+} else {
+  await list()
+}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "vizcn",
+  "version": "0.1.0",
+  "description": "Agent-first SVG viz registry — pointer CLI. The registry lives at https://vibecoding.tech/vizcn: copy-paste forms an AI coding agent picks from a catalog by the question the data answers.",
+  "license": "MIT",
+  "type": "module",
+  "bin": { "vizcn": "./bin.mjs" },
+  "files": ["bin.mjs", "shelf.json", "README.md"],
+  "engines": { "node": ">=18" },
+  "repository": "github:eugeneshilow/vizcn",
+  "homepage": "https://vibecoding.tech/vizcn",
+  "author": "Evgeny Shilov (https://github.com/eugeneshilow)",
+  "keywords": ["shadcn", "registry", "svg", "dataviz", "charts", "agent", "ai", "vizcn"]
+}

package/shelf.json

@@ -0,0 +1,4 @@
+{
+  "shelfUrl": "https://vibecoding.tech/vizcn",
+  "registryBase": "https://vibecoding.tech/vizcn/r"
+}