@principal-ai/principal-view-core 0.5.14 → 0.5.16

package/dist/cli/codegen.d.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * Code Generation CLI
+ *
+ * Generate types from canvas files.
+ *
+ * Usage:
+ *   npx @principal-ai/principal-view-core codegen my-flow.canvas
+ *   npx @principal-ai/principal-view-core codegen --lang typescript --output types/ my-flow.canvas
+ *
+ * Similar to:
+ *   - graphql-codegen (GraphQL)
+ *   - openapi-generator (OpenAPI)
+ *   - protoc (Protobuf)
+ */
+interface CliOptions {
+    language: 'typescript' | 'python' | 'go' | 'rust';
+    output?: string;
+    readonly?: boolean;
+    strictNullChecks?: boolean;
+    includeDocComments?: boolean;
+    namespace?: string;
+    watch?: boolean;
+}
+/**
+ * Parse command line arguments
+ */
+declare function parseArgs(args: string[]): {
+    options: CliOptions;
+    canvasFiles: string[];
+};
+/**
+ * Generate types for a canvas file
+ */
+declare function generateTypesForFile(canvasPath: string, options: CliOptions): string;
+/**
+ * Main entry point
+ */
+declare function main(): void;
+export { main, parseArgs, generateTypesForFile };
+//# sourceMappingURL=codegen.d.ts.map

package/dist/cli/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/cli/codegen.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAQH,UAAU,UAAU;IAClB,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAqDjF;AAED;;GAEG;AACH,iBAAS,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,UA2DpE;AAkED;;GAEG;AACH,iBAAS,IAAI,SAuDZ;AAOD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/cli/codegen.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+/**
+ * Code Generation CLI
+ *
+ * Generate types from canvas files.
+ *
+ * Usage:
+ *   npx @principal-ai/principal-view-core codegen my-flow.canvas
+ *   npx @principal-ai/principal-view-core codegen --lang typescript --output types/ my-flow.canvas
+ *
+ * Similar to:
+ *   - graphql-codegen (GraphQL)
+ *   - openapi-generator (OpenAPI)
+ *   - protoc (Protobuf)
+ */
+import fs from 'fs';
+import path from 'path';
+import { generateTypes, generatorRegistry } from '../codegen/type-generator';
+/**
+ * Parse command line arguments
+ */
+function parseArgs(args) {
+    const options = {
+        language: 'typescript',
+        includeDocComments: true,
+        strictNullChecks: true,
+    };
+    const canvasFiles = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--lang':
+            case '-l':
+                options.language = args[++i];
+                break;
+            case '--output':
+            case '-o':
+                options.output = args[++i];
+                break;
+            case '--readonly':
+                options.readonly = true;
+                break;
+            case '--no-strict-null-checks':
+                options.strictNullChecks = false;
+                break;
+            case '--no-doc-comments':
+                options.includeDocComments = false;
+                break;
+            case '--namespace':
+            case '-n':
+                options.namespace = args[++i];
+                break;
+            case '--watch':
+            case '-w':
+                options.watch = true;
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+            case '--list-generators':
+                listGenerators();
+                process.exit(0);
+            default:
+                if (!arg.startsWith('--')) {
+                    canvasFiles.push(arg);
+                }
+        }
+    }
+    return { options, canvasFiles };
+}
+/**
+ * Generate types for a canvas file
+ */
+function generateTypesForFile(canvasPath, options) {
+    console.log(`📝 Generating types from ${canvasPath}...`);
+    // Read canvas file
+    const canvas = JSON.parse(fs.readFileSync(canvasPath, 'utf-8'));
+    // Generate types
+    const codegenOptions = {
+        language: options.language,
+        style: {
+            readonly: options.readonly,
+            strictNullChecks: options.strictNullChecks,
+            includeDocComments: options.includeDocComments,
+        },
+        namespace: options.namespace,
+    };
+    const result = generateTypes(canvas, codegenOptions);
+    // Determine output path
+    let outputPath;
+    if (options.output) {
+        // If output is a directory, use generated filename
+        if (fs.existsSync(options.output) && fs.statSync(options.output).isDirectory()) {
+            outputPath = path.join(options.output, result.filename);
+        }
+        else {
+            outputPath = options.output;
+        }
+    }
+    else {
+        // Default: packages/core/src/generated/ for .principal-views canvases
+        // This keeps canvas files in .principal-views/ but generates types to idiomatic locations
+        const canvasDir = path.dirname(canvasPath);
+        const canvasAbsPath = path.resolve(canvasPath);
+        if (canvasAbsPath.includes('.principal-views')) {
+            // Canvas is in .principal-views/, output to packages/core/src/generated/
+            const repoRoot = canvasAbsPath.split('.principal-views')[0];
+            const generatedDir = path.join(repoRoot, 'packages', 'core', 'src', 'generated');
+            outputPath = path.join(generatedDir, result.filename);
+        }
+        else {
+            // Canvas is elsewhere, use same directory
+            outputPath = path.join(canvasDir, result.filename);
+        }
+    }
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+    // Write types file
+    fs.writeFileSync(outputPath, result.code);
+    console.log(`✅ Generated ${outputPath}`);
+    console.log(`   Language: ${options.language}`);
+    console.log(`   Size: ${result.code.length} bytes`);
+    return outputPath;
+}
+/**
+ * Print help message
+ */
+function printHelp() {
+    console.log(`
+Code Generation CLI - Generate types from canvas files
+
+USAGE:
+  npx @principal-ai/principal-view-core codegen [OPTIONS] <canvas-files...>
+
+OPTIONS:
+  -l, --lang <language>           Target language (typescript|python|go|rust) [default: typescript]
+  -o, --output <path>             Output file or directory [default: same as canvas]
+  -n, --namespace <name>          Wrap types in a namespace
+  --readonly                      Use readonly modifiers (TypeScript)
+  --no-strict-null-checks         Disable strict null checks
+  --no-doc-comments               Omit JSDoc comments
+  -w, --watch                     Watch for changes and regenerate
+  --list-generators               List available code generators
+  -h, --help                      Show this help message
+
+EXAMPLES:
+  # Generate TypeScript types
+  npx @principal-ai/principal-view-core codegen my-flow.canvas
+
+  # Generate with namespace
+  npx @principal-ai/principal-view-core codegen --namespace Events my-flow.canvas
+
+  # Generate to specific output directory
+  npx @principal-ai/principal-view-core codegen --output src/types/ my-flow.canvas
+
+  # Generate multiple files
+  npx @principal-ai/principal-view-core codegen *.canvas
+
+  # Watch mode (future)
+  npx @principal-ai/principal-view-core codegen --watch my-flow.canvas
+
+PRECEDENTS:
+  This tool follows patterns from:
+  - GraphQL Code Generator (graphql-code-generator.com)
+  - OpenAPI Generator (openapi-generator.tech)
+  - Protobuf Compiler (protoc)
+
+  Like these tools, it generates type-safe code from declarative schemas.
+`);
+}
+/**
+ * List available generators
+ */
+function listGenerators() {
+    console.log('\nAvailable Code Generators:\n');
+    const languages = generatorRegistry.list();
+    for (const lang of languages) {
+        const generator = generatorRegistry.get(lang);
+        console.log(`  • ${lang.padEnd(15)} ${generator ? '✓' : '✗'}`);
+    }
+    console.log('\nTo add support for more languages, implement the CodeGenerator interface.');
+    console.log('See: packages/core/src/codegen/type-generator.ts\n');
+}
+/**
+ * Main entry point
+ */
+function main() {
+    const { options, canvasFiles } = parseArgs(process.argv.slice(2));
+    if (canvasFiles.length === 0) {
+        console.error('❌ Error: No canvas files specified\n');
+        printHelp();
+        process.exit(1);
+    }
+    // Validate language
+    const availableLanguages = generatorRegistry.list();
+    if (!availableLanguages.includes(options.language)) {
+        console.error(`❌ Error: Unsupported language '${options.language}'`);
+        console.error(`   Available: ${availableLanguages.join(', ')}\n`);
+        listGenerators();
+        process.exit(1);
+    }
+    // Generate types for each file
+    const outputFiles = [];
+    for (const canvasFile of canvasFiles) {
+        try {
+            // Check if file exists
+            if (!fs.existsSync(canvasFile)) {
+                console.error(`❌ Error: File not found: ${canvasFile}`);
+                continue;
+            }
+            const outputPath = generateTypesForFile(canvasFile, options);
+            outputFiles.push(outputPath);
+        }
+        catch (error) {
+            console.error(`❌ Error processing ${canvasFile}:`, error);
+            process.exit(1);
+        }
+    }
+    console.log(`\n✨ Successfully generated ${outputFiles.length} type file(s)\n`);
+    // Watch mode
+    if (options.watch) {
+        console.log('👀 Watching for changes...');
+        for (const canvasFile of canvasFiles) {
+            fs.watch(canvasFile, (eventType) => {
+                if (eventType === 'change') {
+                    console.log(`\n🔄 ${canvasFile} changed, regenerating...`);
+                    try {
+                        generateTypesForFile(canvasFile, options);
+                    }
+                    catch (error) {
+                        console.error('❌ Error:', error);
+                    }
+                }
+            });
+        }
+    }
+}
+// Run CLI if executed directly
+if (require.main === module) {
+    main();
+}
+export { main, parseArgs, generateTypesForFile };
+//# sourceMappingURL=codegen.js.map

package/dist/cli/codegen.js.map

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

package/dist/codegen/type-generator.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Type Generator
+ *
+ * Generates TypeScript types from canvas event schemas.
+ * Similar to how GraphQL Code Generator works for GraphQL schemas,
+ * or how OpenAPI generators work for API specs.
+ *
+ * Precedents:
+ * - GraphQL Code Generator: graphql-code-generator.com
+ * - OpenAPI Generator: openapi-generator.tech
+ * - Protobuf: generates code from .proto files
+ * - Zod: runtime validation with TypeScript inference
+ */
+import type { ExtendedCanvas } from '../types/canvas';
+/**
+ * Code generation options
+ */
+export interface CodegenOptions {
+    /** Output language (extensible for future languages) */
+    language: 'typescript' | 'python' | 'go' | 'rust';
+    /** Style preferences */
+    style?: {
+        /** Use readonly for immutable types */
+        readonly?: boolean;
+        /** Use strict null checks */
+        strictNullChecks?: boolean;
+        /** Generate JSDoc comments */
+        includeDocComments?: boolean;
+    };
+    /** Namespace/module name */
+    namespace?: string;
+}
+/**
+ * Generated code result
+ */
+export interface CodegenResult {
+    /** Generated code content */
+    code: string;
+    /** File extension for the language */
+    extension: string;
+    /** Suggested filename */
+    filename: string;
+}
+/**
+ * Abstract code generator interface
+ *
+ * This allows us to implement generators for different languages
+ * following the same pattern as OpenAPI generators.
+ */
+export interface CodeGenerator {
+    /** Target language */
+    language: string;
+    /** Generate code from canvas */
+    generate(canvas: ExtendedCanvas, options?: CodegenOptions): CodegenResult;
+}
+/**
+ * TypeScript Type Generator
+ *
+ * Generates TypeScript types from canvas event schemas.
+ * Similar to GraphQL Code Generator but for canvas schemas.
+ */
+export declare class TypeScriptGenerator implements CodeGenerator {
+    language: string;
+    generate(canvas: ExtendedCanvas, options?: CodegenOptions): CodegenResult;
+    private generateNodeTypes;
+    private generateEventInterface;
+    private generateEventNameUnion;
+    private generateEmitterTypes;
+    private nodeIdToTypeName;
+    private eventNameToTypeName;
+    private fieldTypeToTsType;
+    private generateFilename;
+}
+/**
+ * Generate types from canvas
+ *
+ * @example
+ * ```typescript
+ * import fs from 'fs';
+ * import { generateTypes } from '@principal-ai/principal-view-core';
+ *
+ * const canvas = JSON.parse(fs.readFileSync('my-flow.canvas', 'utf-8'));
+ * const result = generateTypes(canvas, { language: 'typescript' });
+ *
+ * fs.writeFileSync(result.filename, result.code);
+ * ```
+ */
+export declare function generateTypes(canvas: ExtendedCanvas, options?: CodegenOptions): CodegenResult;
+/**
+ * Registry of available generators
+ *
+ * This allows external packages to register custom generators:
+ *
+ * @example
+ * ```typescript
+ * import { generatorRegistry } from '@principal-ai/principal-view-core';
+ *
+ * class PythonGenerator implements CodeGenerator {
+ *   language = 'python';
+ *   generate(canvas, options) { ... }
+ * }
+ *
+ * generatorRegistry.register(new PythonGenerator());
+ * ```
+ */
+export declare const generatorRegistry: {
+    generators: Map<string, CodeGenerator>;
+    register(generator: CodeGenerator): void;
+    get(language: string): CodeGenerator | undefined;
+    list(): string[];
+};
+//# sourceMappingURL=type-generator.d.ts.map

package/dist/codegen/type-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-generator.d.ts","sourceRoot":"","sources":["../../src/codegen/type-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAqC,MAAM,iBAAiB,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;IAClD,wBAAwB;IACxB,KAAK,CAAC,EAAE;QACN,uCAAuC;QACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,6BAA6B;QAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,8BAA8B;QAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;IACF,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC;CAC3E;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,SAAgB;IAExB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa;IA2DzE,OAAO,CAAC,iBAAiB;IA2CzB,OAAO,CAAC,sBAAsB;IAwC9B,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,oBAAoB;IAoD5B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,gBAAgB;CASzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,cAA2C,GACnD,aAAa,CAGf;AAuBD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB;;wBAKR,aAAa;kBAInB,MAAM,GAAG,aAAa,GAAG,SAAS;YAIxC,MAAM,EAAE;CAGjB,CAAC"}