aeon-ui-engine 1.0.2 → 1.1.0

package/packages/cli/node_modules/.bin/vitest

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules/vitest/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules/vitest/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/vitest@4.1.8_@types+node@22.19.19_jsdom@29.1.1_vite@8.0.16_@types+node@22.19.19_esbuild@0.28.0_jiti@2.7.0_tsx@4.22.3_/node_modules:/Users/brandoncryderman/AeonUI/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/packages/cli/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@aeon-ui/cli",
+  "version": "0.1.0",
+  "description": "AI-optimized CLI for injecting Aeon UI agent rules, schemas, and starter code",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GenericCPU/aeon-ui.git",
+    "directory": "packages/cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "keywords": [
+    "aeon-ui",
+    "cli",
+    "cursor",
+    "generative-ui",
+    "ai"
+  ],
+  "type": "module",
+  "bin": {
+    "aeon-ui": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/bin.ts src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@aeon-ui/schemas": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.8"
+  }
+}

package/packages/cli/src/bin.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { initAeon } from './init.js'
+
+const args = process.argv.slice(2)
+const cmd = args[0] ?? 'help'
+const force = args.includes('--force') || args.includes('-f')
+
+function help() {
+  console.log(`aeon-ui — AI-optimized CLI for Aeon UI
+
+Usage:
+  npx aeon-ui init [--force]
+
+Commands:
+  init    Inject Cursor rules, JSON schemas, system prompt, and a starter component
+  help    Show this message
+
+Options:
+  --force, -f   Overwrite existing generated files
+`)
+}
+
+if (cmd === 'init') {
+  const result = initAeon({ force })
+  console.log(`Aeon UI init → ${result.cwd}`)
+  for (const line of result.written) console.log(`  ${line}`)
+  console.log('\nNext: npm install aeon-ui-engine react react-dom xstate @xstate/react')
+  console.log('Docs: AEON_AI.md · paste aeon.cursorrules.md into your agent system prompt')
+} else {
+  help()
+  if (cmd !== 'help' && cmd !== '--help' && cmd !== '-h') {
+    process.exitCode = 1
+  }
+}

package/packages/cli/src/index.ts

@@ -0,0 +1 @@
+export { initAeon, type InitOptions } from './init.js'

package/packages/cli/src/init.ts

@@ -0,0 +1,107 @@
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import {
+  CURSOR_RULES_SNIPPET,
+  AEON_SYSTEM_PROMPT,
+  catalog,
+  componentSchemas,
+} from '@aeon-ui/schemas'
+
+export type InitOptions = {
+  cwd?: string
+  force?: boolean
+}
+
+const STARTER = `/**
+ * Aeon UI starter — generated by \`npx aeon-ui init\`
+ * Headless: @aeon-ui/react · Styled: @aeon-ui/ui · Schemas: @aeon-ui/schemas
+ */
+import { Button, Field } from '@aeon-ui/ui'
+
+export function AeonStarter() {
+  return (
+    <div>
+      <Field.Root>
+        <Field.Label>Email</Field.Label>
+        <Field.Control type="email" placeholder="you@example.com" />
+        <Field.Message />
+      </Field.Root>
+      <Button.Root status="idle">Continue</Button.Root>
+    </div>
+  )
+}
+`
+
+export function initAeon(options: InitOptions = {}) {
+  const cwd = options.cwd ?? process.cwd()
+  const force = options.force ?? false
+  const written: string[] = []
+
+  const write = (rel: string, body: string) => {
+    const path = join(cwd, rel)
+    if (existsSync(path) && !force) {
+      written.push(`skip ${rel} (exists)`)
+      return
+    }
+    mkdirSync(join(path, '..'), { recursive: true })
+    writeFileSync(path, body.endsWith('\n') ? body : `${body}\n`)
+    written.push(`write ${rel}`)
+  }
+
+  write('.cursor/rules/aeon-ui.mdc', `---
+description: Aeon UI — statechart-driven components for AI agents
+globs: **/*.{tsx,ts,jsx,js}
+alwaysApply: true
+---
+
+${CURSOR_RULES_SNIPPET.trim()}
+`)
+
+  write('aeon.cursorrules.md', `${CURSOR_RULES_SNIPPET.trim()}\n`)
+  write('aeon.system-prompt.md', `${AEON_SYSTEM_PROMPT.trim()}\n`)
+  write(
+    'aeon.schemas/catalog.json',
+    `${JSON.stringify(
+      {
+        $id: catalog.$id,
+        title: catalog.title,
+        description: catalog.description,
+        version: catalog.version,
+        principle: catalog.principle,
+        attributes: catalog.attributes,
+        components: catalog.components,
+        note: 'Full schemas live under aeon.schemas/components/*.json',
+      },
+      null,
+      2,
+    )}\n`,
+  )
+
+  for (const [id, schema] of Object.entries(componentSchemas)) {
+    write(`aeon.schemas/components/${id}.json`, `${JSON.stringify(schema, null, 2)}\n`)
+  }
+
+  write('src/components/AeonStarter.tsx', STARTER)
+
+  write(
+    'AEON_AI.md',
+    `# Aeon UI — AI agent setup
+
+Generated by \`npx aeon-ui init\`.
+
+## Next steps
+
+1. Install: \`npm install aeon-ui-engine react react-dom xstate @xstate/react\`
+2. CSS: \`import 'aeon-ui-engine/aeon.css'\`
+3. Vite: add \`aeonUiVitePlugin()\` from \`aeon-ui-engine/vite\`
+4. Paste \`aeon.cursorrules.md\` into Cursor rules / system prompt (already mirrored to \`.cursor/rules/aeon-ui.mdc\`)
+5. Constrain generation with JSON under \`aeon.schemas/\`
+
+## Principle
+
+**UI = f(state)** — never invent boolean combinations for states the schema does not list.
+`,
+  )
+
+  return { cwd, written }
+}

package/packages/cli/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["node"],
+    "noEmit": true
+  },
+  "include": ["src"]
+}

package/packages/core/README.md

@@ -51,10 +51,16 @@ partAttrs(asyncAnatomy.scope, asyncAnatomy.readout, {
 ## Parallel regions
 
 ```ts
-import { stateToAttr } from '@aeon-ui/core'
+import { fieldFace, fieldRegions, stateToAttr } from '@aeon-ui/core'
 
+// Debug / serialization — not product UI labels
 stateToAttr({ interaction: 'dirty', validation: 'invalid', submission: 'idle' })
 // → "interaction:dirty validation:invalid submission:idle"
+
+// Field DOM face (same hierarchy as Button status)
+fieldFace({ interaction: 'dirty', validation: 'invalid', submission: 'idle' }) // "invalid"
+fieldRegions({ interaction: 'dirty', validation: 'invalid', submission: 'idle' })
+// → { interaction: "dirty", validation: "invalid", submission: "idle" }
 ```
 
 ## Adding a scope