@hanzogui/get 7.3.0

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hanzogui/get",
+  "version": "7.3.0",
+  "description": "CLI installer for Hanzo GUI recipes.",
+  "license": "BSD-3-Clause",
+  "author": "Hanzo AI <dev@hanzo.ai>",
+  "homepage": "https://gui.hanzo.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hanzoai/gui.git",
+    "directory": "pkgs/get"
+  },
+  "bin": {
+    "hanzo-gui-get": "./dist/cli.js"
+  },
+  "type": "module",
+  "main": "./dist/cli.js",
+  "source": "src/cli.ts",
+  "files": [
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun run build.ts",
+    "clean": "rm -rf dist",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@hanzogui/recipes": "7.3.0",
+    "fuse.js": "7.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/readme.md

@@ -0,0 +1,46 @@
+# @hanzogui/get
+
+Install Hanzo GUI recipes — composable screens and widgets built on `@hanzogui/*` primitives — into your project with one command.
+
+## Usage
+
+```sh
+npx @hanzogui/get                  # interactive picker
+npx @hanzogui/get add sign-in-form # install a single recipe
+npx @hanzogui/get list             # show all available recipes
+npx @hanzogui/get init             # write gui.config.json
+```
+
+After global install (`npm i -g @hanzogui/get`), the command is `hanzo-gui-get`.
+
+Recipes are vendored into `src/gui/` by default. Override the destination by adding a `gui.config.json` at the project root:
+
+```json
+{ "installDir": "src/components" }
+```
+
+## How it works
+
+`hanzo-gui-get` reads recipes from Hanzo Base at `${HANZO_BASE_URL}/v1/base/collections/gui_recipes/records`. Each recipe is a small, self-contained `.tsx` file (or set of files) that composes `@hanzogui/*` primitives. Recipes can depend on other recipes; transitive deps are pulled in automatically.
+
+Override the registry host:
+
+```sh
+HANZO_BASE_URL=https://base.staging.hanzo.ai npx @hanzogui/get
+```
+
+You still need `@hanzogui/*` primitives installed normally.
+
+## Publishing a recipe
+
+Recipes live in `hanzoai/gui` at `recipes/<slug>/{recipe.json, files/**}`. To seed Base:
+
+```sh
+HANZO_BASE_ADMIN_TOKEN=… bun run scripts/seed-recipes.ts
+```
+
+The seed script creates the `gui_recipes` collection on first run if it doesn't exist, then upserts each recipe by slug.
+
+## What this is not
+
+`@hanzogui/get` is a plain Node CLI — no terminal-UI framework, no React, no `ink`. Just stdout + readline. If you want a Hanzo TUI for building richer CLI apps, use `@hanzo/tui` (separate package).

package/src/cli.ts

@@ -0,0 +1,67 @@
+import { CLI_NAME } from './constants.js'
+import { red } from './lib/ansi.js'
+
+const HELP = `${CLI_NAME} — install Hanzo GUI recipes into your project.
+
+Usage:
+  ${CLI_NAME}                 Interactive picker.
+  ${CLI_NAME} add <slug>      Install a single recipe.
+  ${CLI_NAME} list            List all available recipes.
+  ${CLI_NAME} init            Write gui.config.json.
+  ${CLI_NAME} --help          Show this message.
+  ${CLI_NAME} --version       Print version.
+
+Recipes are fetched from Hanzo Base at $HANZO_BASE_URL (default https://base.hanzo.ai).
+Recipe files vendor into src/gui/ by default; override via gui.config.json.
+`
+
+async function main(): Promise<void> {
+  const [, , cmd, ...rest] = process.argv
+
+  if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
+    process.stdout.write(HELP)
+    return
+  }
+
+  if (cmd === '--version' || cmd === '-v') {
+    const pkg = await import('../package.json', { with: { type: 'json' } } as ImportCallOptions)
+    process.stdout.write(((pkg as { default?: { version?: string } }).default?.version ?? 'unknown') + '\n')
+    return
+  }
+
+  if (!cmd) {
+    const { pick } = await import('./commands/pick.js')
+    await pick()
+    return
+  }
+
+  if (cmd === 'add') {
+    if (!rest[0]) {
+      process.stderr.write(`Usage: ${CLI_NAME} add <recipe-slug>\n`)
+      process.exit(1)
+    }
+    const { add } = await import('./commands/add.js')
+    await add(rest[0])
+    return
+  }
+
+  if (cmd === 'list') {
+    const { list } = await import('./commands/list.js')
+    await list()
+    return
+  }
+
+  if (cmd === 'init') {
+    const { init } = await import('./commands/init.js')
+    await init()
+    return
+  }
+
+  process.stderr.write(`Unknown command: ${cmd}\n\n${HELP}`)
+  process.exit(1)
+}
+
+main().catch((e) => {
+  process.stderr.write(red(e instanceof Error ? e.message : String(e)) + '\n')
+  process.exit(1)
+})

package/src/commands/add.ts

@@ -0,0 +1,23 @@
+import { resolveRecipe, installPlan } from '@hanzogui/recipes'
+import { green, gray, bold } from '../lib/ansi.js'
+
+export async function add(slug: string): Promise<void> {
+  const plan = await resolveRecipe(slug)
+  const paths = await installPlan(plan)
+
+  process.stdout.write(green(`Installed "${plan.recipe.name}"`) + '\n')
+  if (plan.transitiveRecipes.length > 0) {
+    process.stdout.write(
+      gray(
+        `+ ${plan.transitiveRecipes.length} dependent recipe${
+          plan.transitiveRecipes.length === 1 ? '' : 's'
+        }: ${plan.transitiveRecipes.map((r) => r.slug).join(', ')}\n`
+      )
+    )
+  }
+  for (const p of paths) process.stdout.write(`  ${p}\n`)
+  if (plan.recipe.npmDeps.length > 0) {
+    process.stdout.write('\n' + gray('Install these npm deps:') + '\n')
+    process.stdout.write(`  ${bold('npm i ' + plan.recipe.npmDeps.join(' '))}\n`)
+  }
+}

package/src/commands/init.ts

@@ -0,0 +1,18 @@
+import { existsSync, promises as fs } from 'node:fs'
+import path from 'node:path'
+import { findProjectRoot, DEFAULT_INSTALL_DIR } from '@hanzogui/recipes'
+import { green, yellow } from '../lib/ansi.js'
+
+export async function init(): Promise<void> {
+  const root = await findProjectRoot()
+  const dest = path.join(root, 'gui.config.json')
+  if (existsSync(dest)) {
+    process.stdout.write(yellow(`gui.config.json already exists at ${dest}\n`))
+    return
+  }
+  await fs.writeFile(
+    dest,
+    JSON.stringify({ installDir: DEFAULT_INSTALL_DIR }, null, 2) + '\n'
+  )
+  process.stdout.write(green(`Wrote ${dest}\n`))
+}

package/src/commands/list.ts

@@ -0,0 +1,19 @@
+import { listRecipes } from '@hanzogui/recipes'
+import { bold, cyan, gray, yellow } from '../lib/ansi.js'
+
+export async function list(): Promise<void> {
+  const recipes = await listRecipes()
+  if (recipes.length === 0) {
+    process.stdout.write(yellow('No recipes published yet.\n'))
+    return
+  }
+  const byCategory: Record<string, typeof recipes> = {}
+  for (const r of recipes) (byCategory[r.category || 'misc'] ||= []).push(r)
+  for (const [cat, items] of Object.entries(byCategory)) {
+    process.stdout.write(`\n${bold(cat)}\n`)
+    for (const r of items) {
+      process.stdout.write(`  ${cyan(r.slug.padEnd(24))}  ${gray(r.description)}\n`)
+    }
+  }
+  process.stdout.write('\n')
+}

package/src/commands/pick.ts

@@ -0,0 +1,61 @@
+import Fuse from 'fuse.js'
+import * as readline from 'node:readline/promises'
+import { listRecipes } from '@hanzogui/recipes'
+import { bold, cyan, dim, gray } from '../lib/ansi.js'
+import { add } from './add.js'
+
+export async function pick(): Promise<void> {
+  const recipes = await listRecipes()
+  if (recipes.length === 0) {
+    process.stdout.write('No recipes published yet.\n')
+    return
+  }
+
+  const fuse = new Fuse(recipes, {
+    keys: ['name', 'slug', 'category', 'description'],
+    threshold: 0.4,
+  })
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+
+  try {
+    const query = (await rl.question(bold('Search recipes') + ' (empty = show all): ')).trim()
+    const hits = query
+      ? fuse.search(query).map((h) => h.item)
+      : recipes
+    if (hits.length === 0) {
+      process.stdout.write(dim('No matches.\n'))
+      return
+    }
+
+    process.stdout.write('\n')
+    hits.slice(0, 20).forEach((r, i) => {
+      process.stdout.write(
+        `  ${cyan(String(i + 1).padStart(2))}  ${bold(r.name)}  ${gray(r.slug)}\n`
+      )
+      process.stdout.write(`      ${gray(r.description)}\n`)
+    })
+    process.stdout.write('\n')
+
+    const pickRaw = (await rl.question('Pick a number (or paste a slug): ')).trim()
+    if (!pickRaw) return
+
+    let slug: string | undefined
+    const asNum = Number.parseInt(pickRaw, 10)
+    if (!Number.isNaN(asNum) && asNum >= 1 && asNum <= hits.length) {
+      slug = hits[asNum - 1]!.slug
+    } else if (recipes.find((r) => r.slug === pickRaw)) {
+      slug = pickRaw
+    }
+
+    if (!slug) {
+      process.stdout.write(dim(`No recipe matches "${pickRaw}".\n`))
+      return
+    }
+
+    process.stdout.write('\n')
+    await add(slug)
+  } finally {
+    rl.close()
+  }
+}

package/src/constants.ts

@@ -0,0 +1 @@
+export const CLI_NAME = 'hanzo-gui-get'

package/src/lib/ansi.ts

@@ -0,0 +1,12 @@
+const ESC = '\x1b['
+const isTTY = process.stdout.isTTY === true
+const wrap = (open: number, close: number) => (s: string) =>
+  isTTY ? `${ESC}${open}m${s}${ESC}${close}m` : s
+
+export const bold = wrap(1, 22)
+export const dim = wrap(2, 22)
+export const red = wrap(31, 39)
+export const green = wrap(32, 39)
+export const yellow = wrap(33, 39)
+export const cyan = wrap(36, 39)
+export const gray = wrap(90, 39)