archetype-engine 2.0.0

package/dist/src/template/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/template/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACd,MAAM,eAAe,CAAA;AAEtB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAA;IAEtB,uBAAuB;IACvB,MAAM,EAAE;QACN,WAAW,EAAE,OAAO,WAAW,CAAA;QAC/B,SAAS,EAAE,OAAO,SAAS,CAAA;QAC3B,WAAW,EAAE,OAAO,WAAW,CAAA;QAC/B,YAAY,EAAE,OAAO,YAAY,CAAA;QACjC,YAAY,EAAE,OAAO,YAAY,CAAA;QACjC,aAAa,EAAE,OAAO,aAAa,CAAA;KACpC,CAAA;IAED,+DAA+D;IAC/D,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;QACjD,QAAQ,EAAE,OAAO,CAAA;QACjB,UAAU,EAAE,OAAO,CAAA;QACnB,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,EAAE,OAAO,CAAA;KACpB,CAAA;IAED,wCAAwC;IACxC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CACvC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,cAAc,GACrB,gBAAgB,CAuBlB"}

package/dist/src/template/context.js

@@ -0,0 +1,31 @@
+"use strict";
+// Generator context with common utilities
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContext = createContext;
+const utils_1 = require("../core/utils");
+/**
+ * Create a generator context from manifest and config
+ */
+function createContext(manifest, config) {
+    const dbType = manifest.database?.type;
+    const isHeadless = manifest.mode.type === 'headless' || !manifest.database;
+    return {
+        config,
+        naming: {
+            toSnakeCase: utils_1.toSnakeCase,
+            pluralize: utils_1.pluralize,
+            toCamelCase: utils_1.toCamelCase,
+            toPascalCase: utils_1.toPascalCase,
+            getTableName: utils_1.getTableName,
+            getColumnName: utils_1.getColumnName,
+        },
+        database: {
+            type: dbType,
+            isSqlite: dbType === 'sqlite',
+            isPostgres: dbType === 'postgres',
+            isMysql: dbType === 'mysql',
+            isHeadless,
+        },
+        resolvePath: (alias) => config.importAliases[alias] || alias,
+    };
+}

package/dist/src/template/index.d.ts

@@ -0,0 +1,6 @@
+export type { GeneratedFile, Generator, GeneratorOutput, TemplateMetadata, TemplateConfig, Template, } from './types';
+export type { GeneratorContext } from './context';
+export { createContext } from './context';
+export { runTemplate } from './runner';
+export { getTemplate, listTemplates, hasTemplate, } from './registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/template/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/template/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,aAAa,EACb,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,QAAQ,GACT,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEtC,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAA"}

package/dist/src/template/index.js

@@ -0,0 +1,12 @@
+"use strict";
+// Template system exports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasTemplate = exports.listTemplates = exports.getTemplate = exports.runTemplate = exports.createContext = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "createContext", { enumerable: true, get: function () { return context_1.createContext; } });
+var runner_1 = require("./runner");
+Object.defineProperty(exports, "runTemplate", { enumerable: true, get: function () { return runner_1.runTemplate; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "getTemplate", { enumerable: true, get: function () { return registry_1.getTemplate; } });
+Object.defineProperty(exports, "listTemplates", { enumerable: true, get: function () { return registry_1.listTemplates; } });
+Object.defineProperty(exports, "hasTemplate", { enumerable: true, get: function () { return registry_1.hasTemplate; } });

package/dist/src/template/registry.d.ts

@@ -0,0 +1,18 @@
+import type { Template, TemplateMetadata } from './types';
+/**
+ * Get a template by ID
+ */
+export declare function getTemplate(id: string): Promise<Template | null>;
+/**
+ * List all available templates
+ */
+export declare function listTemplates(): TemplateMetadata[];
+/**
+ * Check if a template exists
+ */
+export declare function hasTemplate(id: string): boolean;
+/**
+ * Get default template ID
+ */
+export declare function getDefaultTemplateId(): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/template/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/template/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAYzD;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAItE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,EAAE,CAelD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/src/template/registry.js

@@ -0,0 +1,89 @@
+"use strict";
+// Template registry - discovers and loads templates
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplate = getTemplate;
+exports.listTemplates = listTemplates;
+exports.hasTemplate = hasTemplate;
+exports.getDefaultTemplateId = getDefaultTemplateId;
+// Template loaders - lazy import for each template
+const templateLoaders = {
+    'nextjs-drizzle-trpc': async () => {
+        const mod = await Promise.resolve().then(() => __importStar(require('../templates/nextjs-drizzle-trpc')));
+        return mod.default;
+    },
+    // Future templates:
+    // 'sveltekit-prisma': async () => (await import('../templates/sveltekit-prisma')).default,
+};
+/**
+ * Get a template by ID
+ */
+async function getTemplate(id) {
+    const loader = templateLoaders[id];
+    if (!loader)
+        return null;
+    return loader();
+}
+/**
+ * List all available templates
+ */
+function listTemplates() {
+    return [
+        {
+            id: 'nextjs-drizzle-trpc',
+            name: 'Next.js + Drizzle + tRPC',
+            description: 'Full-stack Next.js with Drizzle ORM, tRPC API, and React hooks',
+            framework: 'nextjs',
+            stack: {
+                database: 'drizzle',
+                validation: 'zod',
+                api: 'trpc',
+                ui: 'react',
+            },
+        },
+    ];
+}
+/**
+ * Check if a template exists
+ */
+function hasTemplate(id) {
+    return id in templateLoaders;
+}
+/**
+ * Get default template ID
+ */
+function getDefaultTemplateId() {
+    return 'nextjs-drizzle-trpc';
+}

package/dist/src/template/runner.d.ts

@@ -0,0 +1,9 @@
+import type { ManifestIR } from '../manifest';
+import type { Template, GeneratedFile } from './types';
+/**
+ * Run a template against a manifest and write output files
+ */
+export declare function runTemplate(template: Template, manifest: ManifestIR, options?: {
+    dryRun?: boolean;
+}): Promise<GeneratedFile[]>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/template/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/template/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAa,MAAM,SAAS,CAAA;AA6DjE;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,UAAU,EACpB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC,CAqC1B"}

package/dist/src/template/runner.js

@@ -0,0 +1,125 @@
+"use strict";
+// Template runner - orchestrates generators and writes files
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTemplate = runTemplate;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const context_1 = require("./context");
+/**
+ * Generator names that should be skipped in headless mode
+ */
+const SKIP_IN_HEADLESS = ['drizzle-schema'];
+const GENERATOR_CATEGORIES = {
+    'drizzle-schema': 'schema',
+    'zod-schemas': 'validation',
+    'trpc-routers': 'api',
+    'react-hooks': 'hooks',
+    'i18n': 'i18n',
+    'service-layer': 'services',
+};
+/**
+ * Check if a generator should run based on mode
+ */
+function shouldRunGenerator(generator, mode) {
+    const name = generator.name;
+    // Full mode runs everything
+    if (mode.type === 'full') {
+        return true;
+    }
+    // Headless mode skips database-related generators
+    if (mode.type === 'headless') {
+        if (SKIP_IN_HEADLESS.includes(name)) {
+            return false;
+        }
+        // If include list is specified, check if generator category is included
+        if (mode.include) {
+            const category = GENERATOR_CATEGORIES[name];
+            // If we don't know the category, include it by default
+            if (!category)
+                return true;
+            return mode.include.includes(category);
+        }
+        return true;
+    }
+    // API-only mode runs schema, validation, and API generators
+    if (mode.type === 'api-only') {
+        const category = GENERATOR_CATEGORIES[name];
+        const apiOnlyCategories = ['schema', 'validation', 'api', 'services'];
+        if (!category)
+            return true;
+        return apiOnlyCategories.includes(category);
+    }
+    return true;
+}
+/**
+ * Run a template against a manifest and write output files
+ */
+async function runTemplate(template, manifest, options = {}) {
+    const config = template.defaultConfig;
+    const ctx = (0, context_1.createContext)(manifest, config);
+    const allFiles = [];
+    const mode = manifest.mode;
+    // Filter generators based on mode
+    const activeGenerators = template.generators.filter(g => shouldRunGenerator(g, mode));
+    // Log mode info
+    console.log(`  Mode: ${mode.type}`);
+    // Run each active generator
+    for (const generator of activeGenerators) {
+        console.log(`  Running ${generator.name}...`);
+        const result = generator.generate(manifest, ctx);
+        const files = Array.isArray(result) ? result : [result];
+        allFiles.push(...files);
+    }
+    // Run post-generate hook if defined
+    if (template.postGenerate) {
+        template.postGenerate(manifest, ctx);
+    }
+    // Write files (unless dry run)
+    if (!options.dryRun) {
+        for (const file of allFiles) {
+            const fullPath = path.join(config.outputDir, file.path);
+            ensureDir(path.dirname(fullPath));
+            fs.writeFileSync(fullPath, file.content);
+            console.log(`  Created: ${fullPath}`);
+        }
+    }
+    return allFiles;
+}
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}

package/dist/src/template/types.d.ts

@@ -0,0 +1,73 @@
+import type { ManifestIR } from '../manifest';
+import type { GeneratorContext } from './context';
+/**
+ * A generated file with path and content
+ */
+export interface GeneratedFile {
+    /** Relative path from output directory */
+    path: string;
+    /** File content */
+    content: string;
+}
+/**
+ * Generator output - single file or array of files
+ */
+export type GeneratorOutput = GeneratedFile | GeneratedFile[];
+/**
+ * A generator produces code for a specific aspect of the stack
+ */
+export interface Generator {
+    /** Unique identifier */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /**
+     * Generate code from the manifest
+     */
+    generate(manifest: ManifestIR, ctx: GeneratorContext): GeneratorOutput;
+}
+/**
+ * Template metadata for discovery and CLI
+ */
+export interface TemplateMetadata {
+    /** Unique template ID (e.g., "nextjs-drizzle-trpc") */
+    id: string;
+    /** Display name for CLI */
+    name: string;
+    /** Description shown in help */
+    description: string;
+    /** Framework this template targets */
+    framework: 'nextjs' | 'sveltekit' | 'remix' | 'astro' | 'generic';
+    /** Tech stack components */
+    stack: {
+        database: 'drizzle' | 'prisma' | 'kysely';
+        validation: 'zod' | 'valibot' | 'yup';
+        api?: 'trpc' | 'rest' | 'graphql';
+        ui?: 'react' | 'svelte' | 'vue' | 'none';
+    };
+}
+/**
+ * Configuration for output paths and import aliases
+ */
+export interface TemplateConfig {
+    /** Output directory (default: 'generated') */
+    outputDir: string;
+    /** Import alias mapping (e.g., { '@/generated': './generated' }) */
+    importAliases: Record<string, string>;
+}
+/**
+ * A template bundles generators for a specific tech stack
+ */
+export interface Template {
+    /** Template metadata */
+    meta: TemplateMetadata;
+    /** Default configuration */
+    defaultConfig: TemplateConfig;
+    /** List of generators in execution order */
+    generators: Generator[];
+    /**
+     * Optional hook to run after all generators complete
+     */
+    postGenerate?(manifest: ManifestIR, ctx: GeneratorContext): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/template/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/template/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,EAAE,CAAA;AAE7D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAAA;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAA;IACV,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,SAAS,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;IACjE,4BAA4B;IAC5B,KAAK,EAAE;QACL,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;QACzC,UAAU,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAA;QACrC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;QACjC,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;KACzC,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,IAAI,EAAE,gBAAgB,CAAA;IACtB,4BAA4B;IAC5B,aAAa,EAAE,cAAc,CAAA;IAC7B,4CAA4C;IAC5C,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB;;OAEG;IACH,YAAY,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACjE"}

package/dist/src/template/types.js

@@ -0,0 +1,3 @@
+"use strict";
+// Template and Generator interfaces
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/templates/nextjs-drizzle-trpc/generators/api.d.ts

@@ -0,0 +1,22 @@
+/**
+ * tRPC Router Generator
+ *
+ * Generates type-safe tRPC routers with CRUD operations for each entity.
+ * Adapts to database or external API source based on entity/manifest configuration.
+ *
+ * Generated files:
+ * - trpc/routers/{entity}.ts - Individual entity routers with list, get, create, update, remove
+ * - trpc/routers/index.ts - App router combining all entity routers
+ *
+ * Features:
+ * - Automatic procedure type selection (publicProcedure vs protectedProcedure)
+ * - Multi-tenancy support with automatic tenant filtering
+ * - Soft delete support (updates deletedAt instead of hard delete)
+ * - External API integration via generated service layer
+ * - Input validation using generated Zod schemas
+ *
+ * @module generators/api
+ */
+import type { Generator } from '../../../template/types';
+export declare const apiGenerator: Generator;
+//# sourceMappingURL=api.d.ts.map

package/dist/src/templates/nextjs-drizzle-trpc/generators/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../src/templates/nextjs-drizzle-trpc/generators/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAA;AAu3BvE,eAAO,MAAM,YAAY,EAAE,SAuB1B,CAAA"}