@lynx-js/genui 0.0.2 → 0.0.3

package/cli/bin/cli.js

@@ -2,273 +2,15 @@
 // Copyright 2026 The Lynx Authors. All rights reserved.
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
-import * as fs from 'node:fs';
-import { createRequire } from 'node:module';
 import * as path from 'node:path';
-import { pathToFileURL } from 'node:url';
 
-const usage = `Usage: genui <namespace> <command> [options]
+import { runCli } from '../dist/cli.js';
 
-Namespaces:
-  a2ui    Generate A2UI catalog artifacts and system prompts.
-  openui  Reserved for future OpenUI workflows.
-
-Examples:
-  genui a2ui generate catalog --catalog-dir src/catalog --out-dir dist/catalog
-  genui a2ui generate prompt --out dist/a2ui-system-prompt.txt
-`;
-
-const a2uiUsage = `Usage: genui a2ui generate <target> [options]
-
-Targets:
-  catalog  Generate A2UI component and function catalog files.
-  prompt   Generate an A2UI system prompt from catalog files.
-`;
-
-const openuiUsage = `Usage: genui openui <command> [options]
-
-OpenUI CLI commands are reserved for future GenUI workflows.
-`;
-
-function createGenerateCatalogUsage(programName) {
-  return `Usage: ${programName} generate catalog [options]
-
-Options:
-  --catalog-dir <dir>  Directory to scan for TypeScript catalog interfaces.
-  --source <path>      Source file or directory to scan. Repeatable.
-  --typedoc-json <file>
-                       Read an existing TypeDoc JSON project instead of
-                       running TypeDoc conversion.
-  --out-dir <dir>      Output directory for component catalog.json files.
-  --version            Print the package version.
-  --help               Print this help message.
-
-Defaults:
-  --catalog-dir src/catalog
-  --out-dir dist/catalog
-`;
-}
-
-function createGeneratePromptUsage(programName) {
-  return `Usage: ${programName} generate prompt [options]
-
-Options:
-  --catalog-dir <dir>  Directory containing generated catalog files. When
-                       omitted, use the built-in A2UI basic catalog.
-  --catalog-id <id>    Catalog id to require in createSurface messages.
-  --out <file>         Write the prompt to a file instead of stdout.
-  --appendix <text>    Append extra instructions to the generated prompt.
-  --version            Print the package version.
-  --help               Print this help message.
-
-Defaults:
-  --catalog-id built-in A2UI basic catalog id
-`;
-}
-
-if (isMain(import.meta.url)) {
-  try {
-    process.exitCode = await runCli(process.argv.slice(2), process.cwd(), {
-      binName: path.basename(process.argv[1] ?? 'genui'),
-    });
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exitCode = 1;
-  }
-}
-
-export async function runCli(args, cwd = process.cwd(), cliOptions = {}) {
-  const binName = cliOptions.binName ?? 'genui';
-  if (binName === 'a2ui-cli') {
-    return await runA2UICli(args, cwd, { programName: 'a2ui-cli' });
-  }
-
-  const command = args[0];
-  if (command === undefined || command === '--help' || command === '-h') {
-    console.info(usage);
-    return 0;
-  }
-  if (command === '--version' || command === '-v') {
-    printPackageVersion();
-    return 0;
-  }
-
-  if (command === 'a2ui') {
-    return await runA2UICli(args.slice(1), cwd, { programName: 'genui a2ui' });
-  }
-  if (command === 'openui') {
-    return runOpenUICli(args.slice(1));
-  }
-
-  throw new Error(`Unknown namespace: ${command}`);
-}
-
-async function runA2UICli(args, cwd, options) {
-  const programName = options.programName;
-  const command = args[0];
-  if (command === undefined || command === '--help' || command === '-h') {
-    console.info(programName === 'a2ui-cli' ? legacyA2UIUsage : a2uiUsage);
-    return 0;
-  }
-  if (command === '--version' || command === '-v') {
-    printPackageVersion();
-    return 0;
-  }
-  if (command !== 'generate') {
-    throw new Error(`Unknown A2UI command: ${command}`);
-  }
-  const target = args[1];
-  const targetArgs = args.slice(2);
-  if (target === undefined || target === '--help' || target === '-h') {
-    console.info(programName === 'a2ui-cli' ? legacyA2UIUsage : a2uiUsage);
-    return 0;
-  }
-  if (target === '--version' || target === '-v') {
-    printPackageVersion();
-    return 0;
-  }
-  if (target === 'catalog') {
-    if (targetArgs.includes('--help') || targetArgs.includes('-h')) {
-      console.info(createGenerateCatalogUsage(programName));
-      return 0;
-    }
-    const { runCli: runCatalogExtractorCli } = await import(
-      '../../a2ui-catalog-extractor/dist/cli.js'
-    );
-    return await runCatalogExtractorCli(targetArgs, cwd);
-  }
-  if (target === 'prompt') {
-    return runGeneratePromptCli(targetArgs, cwd, { programName });
-  }
-  throw new Error(`Unknown generate target: ${target}`);
-}
-
-const legacyA2UIUsage = a2uiUsage.replaceAll('genui a2ui', 'a2ui-cli');
-
-function runOpenUICli(args) {
-  const command = args[0];
-  if (command === undefined || command === '--help' || command === '-h') {
-    console.info(openuiUsage);
-    return 0;
-  }
-  if (command === '--version' || command === '-v') {
-    printPackageVersion();
-    return 0;
-  }
-  throw new Error(
-    `Unknown OpenUI command: ${command}. OpenUI CLI commands are not available yet.`,
-  );
-}
-
-async function runGeneratePromptCli(args, cwd, cliOptions) {
-  const programName = cliOptions.programName;
-  const options = parseGeneratePromptArgs(args);
-  if (options.help) {
-    console.info(createGeneratePromptUsage(programName));
-    return 0;
-  }
-  if (options.version) {
-    printPackageVersion();
-    return 0;
-  }
-
-  const {
-    BASIC_CATALOG,
-    BASIC_CATALOG_ID,
-    buildA2UISystemPrompt,
-    readA2UICatalogFromDirectory,
-  } = await import('../../a2ui-prompt/dist/index.js');
-  const catalog = options.catalogDir
-    ? readA2UICatalogFromDirectory({
-      catalogDir: options.catalogDir,
-      catalogId: options.catalogId ?? BASIC_CATALOG_ID,
-      cwd,
-    })
-    : (options.catalogId
-      ? { ...BASIC_CATALOG, id: options.catalogId }
-      : undefined);
-  if (options.catalogDir && catalog && isEmptyCatalog(catalog)) {
-    throw new Error(
-      `[${programName}] No components or functions found in generated catalog directory: ${options.catalogDir}`,
-    );
-  }
-  const systemPrompt = buildA2UISystemPrompt({
-    ...(catalog ? { catalog } : {}),
-    ...(options.appendix ? { appendix: options.appendix } : {}),
+try {
+  process.exitCode = await runCli(process.argv.slice(2), process.cwd(), {
+    binName: path.basename(process.argv[1] ?? 'genui'),
   });
-
-  if (options.out) {
-    const outPath = path.resolve(cwd, options.out);
-    fs.mkdirSync(path.dirname(outPath), { recursive: true });
-    fs.writeFileSync(outPath, systemPrompt);
-    console.info(`Generated A2UI system prompt at ${options.out}.`);
-  } else {
-    process.stdout.write(systemPrompt);
-  }
-
-  return 0;
-}
-
-function parseGeneratePromptArgs(args) {
-  const options = {
-    help: false,
-    version: false,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-    switch (arg) {
-      case '--catalog-dir':
-        options.catalogDir = readValue(args, ++index, arg);
-        break;
-      case '--catalog-id':
-        options.catalogId = readValue(args, ++index, arg);
-        break;
-      case '--out':
-        options.out = readValue(args, ++index, arg);
-        break;
-      case '--appendix':
-        options.appendix = readValue(args, ++index, arg);
-        break;
-      case '--help':
-      case '-h':
-        options.help = true;
-        break;
-      case '--version':
-      case '-v':
-        options.version = true;
-        break;
-      default:
-        throw new Error(`Unknown option: ${arg}`);
-    }
-  }
-
-  return options;
-}
-
-function isEmptyCatalog(catalog) {
-  return (!Array.isArray(catalog.components) || catalog.components.length === 0)
-    && (!Array.isArray(catalog.functions) || catalog.functions.length === 0);
-}
-
-function readValue(args, index, option) {
-  const value = args[index];
-  if (!value || value.startsWith('-')) {
-    throw new Error(`Missing value for ${option}.`);
-  }
-  return value;
-}
-
-function printPackageVersion() {
-  const require = createRequire(import.meta.url);
-  const packageJson = require('../package.json');
-  console.info(packageJson.version);
-}
-
-function isMain(moduleUrl) {
-  if (process.argv[1] === undefined) {
-    return false;
-  }
-
-  return moduleUrl === pathToFileURL(fs.realpathSync(process.argv[1])).href;
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
 }

package/cli/dist/a2ui/create.d.ts

@@ -0,0 +1,5 @@
+interface CreateOptions {
+    programName: string;
+}
+export declare function runA2UICreateCli(args: string[], cwd: string, options: CreateOptions): number;
+export {};

package/cli/dist/a2ui/create.js

@@ -0,0 +1,178 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import * as fs from 'node:fs';
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readValue } from '../utils.js';
+const createUsage = `Usage: genui a2ui create [project-name] [options]
+
+Options:
+  --template <name>  Template to use (default: "default").
+  --help             Print this help message.
+`;
+const AVAILABLE_TEMPLATES = ['default'];
+export function runA2UICreateCli(args, cwd, options) {
+    const programName = options.programName;
+    const parsed = parseCreateArgs(args);
+    if (parsed.help) {
+        console.info(createUsage);
+        return 0;
+    }
+    const projectName = parsed.projectName ?? 'my-a2ui-app';
+    const template = parsed.template ?? 'default';
+    if (!AVAILABLE_TEMPLATES.includes(template)) {
+        throw new Error(`[${programName}] Unknown template: "${template}". Available templates: ${AVAILABLE_TEMPLATES.join(', ')}`);
+    }
+    const targetDir = path.resolve(cwd, projectName);
+    if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
+        throw new Error(`[${programName}] Target directory "${projectName}" is not empty. Please choose a different name or remove the existing directory.`);
+    }
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const templateDir = path.resolve(__dirname, '../../templates', template);
+    copyDir(templateDir, targetDir);
+    // Replace {{projectName}} and resolve workspace:* versions in package.json
+    const pkgName = path.basename(targetDir);
+    const pkgJsonPath = path.join(targetDir, 'package.json');
+    if (fs.existsSync(pkgJsonPath)) {
+        const require = createRequire(import.meta.url);
+        const versionMap = resolveVersionMap([loadPackageManifest(require, '../../../package.json')], require);
+        let content = fs.readFileSync(pkgJsonPath, 'utf-8');
+        content = content.replaceAll('{{projectName}}', pkgName);
+        content = replaceWorkspaceVersions(content, versionMap, require);
+        fs.writeFileSync(pkgJsonPath, content);
+    }
+    console.info(`\nProject created at ${projectName}/\n`);
+    console.info(`Next steps:\n`);
+    console.info(`  cd ${projectName}`);
+    console.info(`  pnpm install`);
+    console.info(`  pnpm run dev\n`);
+    return 0;
+}
+function parseCreateArgs(args) {
+    const options = { help: false };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--help' || arg === '-h') {
+            options.help = true;
+        }
+        else if (arg === '--template') {
+            options.template = readValue(args, ++index, arg);
+        }
+        else if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        else {
+            options.projectName = arg;
+        }
+    }
+    return options;
+}
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+function replaceWorkspaceVersions(content, versionMap, requireFn) {
+    const pkg = JSON.parse(content);
+    for (const field of ['dependencies', 'devDependencies']) {
+        const deps = pkg[field];
+        if (!deps)
+            continue;
+        for (const name of Object.keys(deps)) {
+            if (deps[name] === 'workspace:*') {
+                const resolved = versionMap[name]
+                    ?? resolvePackageVersion(name, requireFn);
+                if (resolved) {
+                    deps[name] = resolved;
+                }
+            }
+        }
+    }
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+function resolvePackageVersion(name, requireFn) {
+    try {
+        const pkg = requireFn(`${name}/package.json`);
+        return `^${pkg.version}`;
+    }
+    catch {
+        // Package might have strict exports; try resolving via main entry
+        try {
+            const mainPath = requireFn.resolve(name);
+            // Walk up to find package.json
+            let dir = path.dirname(mainPath);
+            while (dir !== path.dirname(dir)) {
+                const pkgPath = path.join(dir, 'package.json');
+                if (fs.existsSync(pkgPath)) {
+                    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+                    if (pkg.name === name && pkg.version) {
+                        return `^${pkg.version}`;
+                    }
+                }
+                dir = path.dirname(dir);
+            }
+        }
+        catch {
+            // Cannot resolve package at all
+        }
+        return undefined;
+    }
+}
+/**
+ * Resolve workspace:^ / workspace:* values to real versions.
+ * The CLI is also shipped inside @lynx-js/genui, where cli/package.json is a
+ * nested workspace manifest that pnpm does not rewrite on publish. Use the
+ * parent package manifest as the generated app's dependency version source.
+ */
+function resolveVersionMap(manifests, requireFn) {
+    const resolved = {};
+    for (const manifest of manifests) {
+        if (manifest.name && manifest.version && !resolved[manifest.name]) {
+            resolved[manifest.name] = `^${manifest.version}`;
+        }
+        for (const deps of getManifestDependencyFields(manifest)) {
+            for (const [name, version] of Object.entries(deps)) {
+                if (resolved[name])
+                    continue;
+                if (version.startsWith('workspace:')) {
+                    const resolvedVersion = resolvePackageVersion(name, requireFn);
+                    if (resolvedVersion) {
+                        resolved[name] = resolvedVersion;
+                    }
+                }
+                else if (!version.startsWith('catalog:')) {
+                    resolved[name] = version;
+                }
+            }
+        }
+    }
+    return resolved;
+}
+function loadPackageManifest(requireFn, id) {
+    try {
+        return requireFn(id);
+    }
+    catch {
+        return {};
+    }
+}
+function getManifestDependencyFields(manifest) {
+    return [
+        manifest.dependencies,
+        manifest.devDependencies,
+        manifest.optionalDependencies,
+        manifest.peerDependencies,
+    ].filter((deps) => deps !== undefined);
+}
+//# sourceMappingURL=create.js.map

package/cli/dist/a2ui/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/a2ui/create.ts"],"names":[],"mappings":"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"}

package/cli/dist/a2ui/index.d.ts

@@ -0,0 +1,5 @@
+interface A2UIOptions {
+    programName: string;
+}
+export declare function runA2UICli(args: string[], cwd: string, options: A2UIOptions): Promise<number>;
+export {};

package/cli/dist/a2ui/index.js

@@ -0,0 +1,170 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { runA2UICreateCli } from './create.js';
+import { printPackageVersion, readValue } from '../utils.js';
+const a2uiUsage = `Usage: genui a2ui <command> [options]
+
+Commands:
+  create [project-name]  Create a new A2UI project from a template.
+  generate <target>      Generate catalog artifacts or system prompts.
+
+Targets (for generate):
+  catalog  Generate A2UI component and function catalog files.
+  prompt   Generate an A2UI system prompt from catalog files.
+`;
+const legacyA2UIUsage = a2uiUsage.replaceAll('genui a2ui', 'a2ui-cli');
+function createGenerateCatalogUsage(programName) {
+    return `Usage: ${programName} generate catalog [options]
+
+Options:
+  --catalog-dir <dir>  Directory to scan for TypeScript catalog interfaces.
+  --source <path>      Source file or directory to scan. Repeatable.
+  --typedoc-json <file>
+                       Read an existing TypeDoc JSON project instead of
+                       running TypeDoc conversion.
+  --out-dir <dir>      Output directory for component catalog.json files.
+  --version            Print the package version.
+  --help               Print this help message.
+
+Defaults:
+  --catalog-dir src/catalog
+  --out-dir dist/catalog
+`;
+}
+function createGeneratePromptUsage(programName) {
+    return `Usage: ${programName} generate prompt [options]
+
+Options:
+  --catalog-dir <dir>  Directory containing generated catalog files. When
+                       omitted, use the built-in A2UI basic catalog.
+  --catalog-id <id>    Catalog id to require in createSurface messages.
+  --out <file>         Write the prompt to a file instead of stdout.
+  --appendix <text>    Append extra instructions to the generated prompt.
+  --version            Print the package version.
+  --help               Print this help message.
+
+Defaults:
+  --catalog-id built-in A2UI basic catalog id
+`;
+}
+export async function runA2UICli(args, cwd, options) {
+    const programName = options.programName;
+    const command = args[0];
+    if (command === undefined || command === '--help' || command === '-h') {
+        console.info(programName === 'a2ui-cli' ? legacyA2UIUsage : a2uiUsage);
+        return 0;
+    }
+    if (command === '--version' || command === '-v') {
+        printPackageVersion();
+        return 0;
+    }
+    if (command === 'create') {
+        return runA2UICreateCli(args.slice(1), cwd, { programName });
+    }
+    if (command !== 'generate') {
+        throw new Error(`Unknown A2UI command: ${command}`);
+    }
+    const target = args[1];
+    const targetArgs = args.slice(2);
+    if (target === undefined || target === '--help' || target === '-h') {
+        console.info(programName === 'a2ui-cli' ? legacyA2UIUsage : a2uiUsage);
+        return 0;
+    }
+    if (target === '--version' || target === '-v') {
+        printPackageVersion();
+        return 0;
+    }
+    if (target === 'catalog') {
+        if (targetArgs.includes('--help') || targetArgs.includes('-h')) {
+            console.info(createGenerateCatalogUsage(programName));
+            return 0;
+        }
+        const { runCli: runCatalogExtractorCli } = await import('../../../a2ui-catalog-extractor/dist/cli.js');
+        return await runCatalogExtractorCli(targetArgs, cwd);
+    }
+    if (target === 'prompt') {
+        return runGeneratePromptCli(targetArgs, cwd, { programName });
+    }
+    throw new Error(`Unknown generate target: ${target}`);
+}
+async function runGeneratePromptCli(args, cwd, cliOptions) {
+    const programName = cliOptions.programName;
+    const options = parseGeneratePromptArgs(args);
+    if (options.help) {
+        console.info(createGeneratePromptUsage(programName));
+        return 0;
+    }
+    if (options.version) {
+        printPackageVersion();
+        return 0;
+    }
+    const { BASIC_CATALOG, BASIC_CATALOG_ID, buildA2UISystemPrompt, readA2UICatalogFromDirectory, } = await import('../../../a2ui-prompt/dist/index.js');
+    const catalog = options.catalogDir
+        ? readA2UICatalogFromDirectory({
+            catalogDir: options.catalogDir,
+            catalogId: options.catalogId ?? BASIC_CATALOG_ID,
+            cwd,
+        })
+        : (options.catalogId
+            ? { ...BASIC_CATALOG, id: options.catalogId }
+            : undefined);
+    if (options.catalogDir && catalog && isEmptyCatalog(catalog)) {
+        throw new Error(`[${programName}] No components or functions found in generated catalog directory: ${options.catalogDir}`);
+    }
+    const systemPrompt = buildA2UISystemPrompt({
+        ...(catalog ? { catalog } : {}),
+        ...(options.appendix ? { appendix: options.appendix } : {}),
+    });
+    if (options.out) {
+        const outPath = path.resolve(cwd, options.out);
+        fs.mkdirSync(path.dirname(outPath), { recursive: true });
+        fs.writeFileSync(outPath, systemPrompt);
+        console.info(`Generated A2UI system prompt at ${options.out}.`);
+    }
+    else {
+        process.stdout.write(systemPrompt);
+    }
+    return 0;
+}
+function parseGeneratePromptArgs(args) {
+    const options = {
+        help: false,
+        version: false,
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        switch (arg) {
+            case '--catalog-dir':
+                options.catalogDir = readValue(args, ++index, arg);
+                break;
+            case '--catalog-id':
+                options.catalogId = readValue(args, ++index, arg);
+                break;
+            case '--out':
+                options.out = readValue(args, ++index, arg);
+                break;
+            case '--appendix':
+                options.appendix = readValue(args, ++index, arg);
+                break;
+            case '--help':
+            case '-h':
+                options.help = true;
+                break;
+            case '--version':
+            case '-v':
+                options.version = true;
+                break;
+            default:
+                throw new Error(`Unknown option: ${arg}`);
+        }
+    }
+    return options;
+}
+function isEmptyCatalog(catalog) {
+    return (!Array.isArray(catalog.components) || catalog.components.length === 0)
+        && (!Array.isArray(catalog.functions) || catalog.functions.length === 0);
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/a2ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"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"}

package/cli/dist/cli.d.ts

@@ -0,0 +1,4 @@
+export interface CliOptions {
+    binName?: string;
+}
+export declare function runCli(args: string[], cwd?: string, cliOptions?: CliOptions): Promise<number>;