@danceroutine/tango-codegen 0.1.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pedro Del Moral Lopez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# @danceroutine/tango-codegen
+
+`@danceroutine/tango-codegen` generates Tango-oriented source files and project scaffolding.
+
+This package automates the repetitive parts of bootstrapping a Tango application while keeping the generated output aligned with Tango's architecture.
+
+## Install
+
+```bash
+pnpm add -D @danceroutine/tango-codegen
+```
+
+Most application developers will use this package through `@danceroutine/tango-cli`, because the `tango new` workflow is composed there.
+
+## What the package does
+
+The package has two related jobs:
+
+- scaffold full Tango applications for supported host frameworks
+- expose programmatic generators and mapping helpers for Tango-shaped source code
+
+The scaffold strategies are the primary public workflow. The lower-level generators are useful when you are building internal automation, editor tooling, or custom project bootstrapping around Tango conventions.
+
+## Scaffolding a project
+
+```bash
+tango new my-app --framework express --package-manager pnpm --dialect sqlite
+```
+
+Generated applications include:
+
+- `tango.config.ts`
+- model definitions that expose `Model.objects`
+- adapter-backed CRUD resources
+- migration scripts and seed/bootstrap wiring
+- host-framework entrypoints that keep Tango-specific setup out of application glue
+
+## Programmatic API example
+
+```ts
+import { generateMigrationFromModels, generateModelInterface, generateViewSet } from '@danceroutine/tango-codegen';
+
+const modelSource = generateModelInterface({
+    name: 'Post',
+    fields: {
+        id: { type: 'serial', primaryKey: true },
+        title: { type: 'string' },
+    },
+});
+
+const viewSetSource = generateViewSet('Post');
+const migrationSource = generateMigrationFromModels([
+    {
+        name: 'Post',
+        fields: {
+            id: { type: 'serial', primaryKey: true },
+            title: { type: 'string' },
+        },
+    },
+]);
+```
+
+Generated code should still be reviewed and adapted for the application.
+
+## Public API
+
+The root export includes:
+
+- generators such as `generateModelInterface`, `generateMigrationFromModels`, and `generateViewSet`
+- mapping helpers such as `mapFieldTypeToTS` and `normalizeFields`
+- framework scaffolding types and helpers such as `FrameworkScaffoldRegistry` and `scaffoldProject`
+- `registerCodegenCommands()`, which mounts the code-generation command tree into the shared CLI
+
+You can import from the root for normal use, or drill into `domain`, `generators`, `mappers`, `frameworks`, and `commands` when you need a narrower boundary.
+
+## Developer workflow
+
+```bash
+pnpm --filter @danceroutine/tango-codegen build
+pnpm --filter @danceroutine/tango-codegen typecheck
+pnpm --filter @danceroutine/tango-codegen test
+```
+
+## Bugs and support
+
+- Documentation: <https://tangowebframework.dev>
+- CLI reference: <https://tangowebframework.dev/reference/cli-api>
+- Architecture topic: <https://tangowebframework.dev/topics/architecture>
+- Issue tracker: <https://github.com/danceroutine/tango/issues>
+
+## License
+
+MIT

package/dist/chunk-BkvOhyD0.js

@@ -0,0 +1,12 @@
+
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+};
+
+//#endregion
+export { __export };

package/dist/{generators/repository → commands}/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
-export { generateRepository } from './generateRepository';
+export { registerCodegenCommands } from './registerCodegenCommands';

package/dist/commands/index.js

@@ -0,0 +1,4 @@
+import "../frameworks-Bp_9BOt2.js";
+import { registerCodegenCommands } from "../commands-C2Xr9uRE.js";
+
+export { registerCodegenCommands };

package/dist/commands/registerCodegenCommands.d.ts

@@ -0,0 +1,5 @@
+import type { Argv } from 'yargs';
+/**
+ * Register Tango project scaffolding commands on an existing CLI parser.
+ */
+export declare function registerCodegenCommands(parser: Argv): Argv;

package/dist/commands/runInitCommand.d.ts

@@ -0,0 +1,13 @@
+import { type SupportedFramework } from '../frameworks';
+import { type ScaffoldDatabaseDialect } from '../frameworks/contracts/FrameworkScaffoldStrategy';
+import type { Argv } from 'yargs';
+type InitCommandArgs = {
+    framework: SupportedFramework;
+    path: string;
+    dialect: ScaffoldDatabaseDialect;
+    skipExisting: boolean;
+    force: boolean;
+};
+export declare function runInitCommand({ framework, path, dialect, skipExisting, force, }: InitCommandArgs): Promise<void>;
+export declare function withInitCommand(parser: Argv): Argv;
+export {};

package/dist/commands/runInstall.d.ts

@@ -0,0 +1,2 @@
+import type { PackageManager } from '../frameworks';
+export declare function runInstall(packageManager: PackageManager, cwd: string): void;

package/dist/commands/runNewCommand.d.ts

@@ -0,0 +1,16 @@
+import { type SupportedFramework, type PackageManager } from '../frameworks';
+import { type ScaffoldDatabaseDialect } from '../frameworks/contracts/FrameworkScaffoldStrategy';
+import type { Argv } from 'yargs';
+type NewCommandArgs = {
+    name?: string;
+    framework: SupportedFramework;
+    path?: string;
+    packageManager: PackageManager;
+    dialect: ScaffoldDatabaseDialect;
+    install: boolean;
+    force: boolean;
+    seed: boolean;
+};
+export declare function runNewCommand({ path, name, framework, packageManager, dialect, install, force, seed: includeSeed, }: NewCommandArgs): Promise<void>;
+export declare function withNewCommand(parser: Argv): Argv;
+export {};

package/dist/commands-C2Xr9uRE.js

@@ -0,0 +1,186 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { FrameworkScaffoldRegistry, PACKAGE_MANAGER, SCAFFOLD_DATABASE_DIALECT, SUPPORTED_FRAMEWORK, scaffoldProject } from "./frameworks-Bp_9BOt2.js";
+import { getLogger, getLogger as getLogger$1 } from "@danceroutine/tango-core";
+import { basename, basename as basename$1, join, resolve, resolve as resolve$1 } from "path/posix";
+import { spawnSync } from "child_process";
+import { readFile, readdir } from "fs/promises";
+
+//#region src/commands/runInstall.ts
+function runInstall(packageManager, cwd) {
+	const argsByPackageManager = {
+		pnpm: ["install"],
+		npm: ["install"],
+		yarn: ["install"],
+		bun: ["install"]
+	};
+	const result = spawnSync(packageManager, [...argsByPackageManager[packageManager]], {
+		cwd,
+		stdio: "inherit",
+		env: process.env
+	});
+	if (result.status !== 0) throw new Error(`Dependency install failed with ${packageManager}. Exit code: ${String(result.status ?? "unknown")}.`);
+}
+
+//#endregion
+//#region src/commands/runNewCommand.ts
+async function runNewCommand({ path, name, framework, packageManager, dialect, install, force, seed: includeSeed }) {
+	const registry = FrameworkScaffoldRegistry.createDefault();
+	const strategy = registry.get(framework);
+	const requestedPath = path ?? name ?? "tango-app";
+	const projectName = name ?? basename$1(requestedPath);
+	const targetDir = resolve$1(process.cwd(), requestedPath);
+	const context = {
+		projectName,
+		targetDir,
+		framework,
+		packageManager,
+		dialect,
+		includeSeed
+	};
+	await scaffoldProject(context, strategy, { force });
+	if (install) runInstall(packageManager, targetDir);
+	const logger = getLogger$1("tango.codegen");
+	logger.info(`Scaffold complete: ${targetDir}`);
+	logger.info(`Framework: ${strategy.name}`);
+	logger.info(`Run next: cd ${targetDir} && ${packageManager} run dev`);
+}
+function withNewCommand(parser) {
+	return parser.command("new [name]", "Bootstrap a new Tango project", (builder) => builder.positional("name", {
+		type: "string",
+		describe: "Project name (used as directory when --path is omitted)."
+	}).option("framework", {
+		type: "string",
+		choices: Object.values(SUPPORTED_FRAMEWORK),
+		demandOption: true,
+		describe: "Host framework scaffold to generate."
+	}).option("path", {
+		type: "string",
+		describe: "Target directory for generated project files."
+	}).option("package-manager", {
+		type: "string",
+		choices: Object.values(PACKAGE_MANAGER),
+		default: PACKAGE_MANAGER.PNPM,
+		describe: "Package manager used for follow-up instructions and optional install."
+	}).option("dialect", {
+		type: "string",
+		choices: Object.values(SCAFFOLD_DATABASE_DIALECT),
+		default: SCAFFOLD_DATABASE_DIALECT.SQLITE,
+		describe: "Database dialect default for generated config."
+	}).option("install", {
+		type: "boolean",
+		default: false,
+		describe: "Install dependencies after scaffolding."
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		describe: "Allow writing into a non-empty target directory."
+	}).option("seed", {
+		type: "boolean",
+		default: true,
+		describe: "Include seed/bootstrap sample artifacts when supported by the framework strategy."
+	}), async ({ name, framework, path, packageManager, dialect, install, force, seed }) => {
+		await runNewCommand({
+			name,
+			framework,
+			path,
+			packageManager,
+			dialect,
+			install,
+			force,
+			seed
+		});
+	});
+}
+
+//#endregion
+//#region src/commands/runInitCommand.ts
+async function detectPackageManager(targetDir) {
+	try {
+		const entries = await readdir(targetDir);
+		if (entries.includes("pnpm-lock.yaml")) return PACKAGE_MANAGER.PNPM;
+		if (entries.includes("package-lock.json")) return PACKAGE_MANAGER.NPM;
+		if (entries.includes("yarn.lock")) return PACKAGE_MANAGER.YARN;
+		if (entries.includes("bun.lockb") || entries.includes("bun.lock")) return PACKAGE_MANAGER.BUN;
+	} catch {}
+	return PACKAGE_MANAGER.PNPM;
+}
+async function runInitCommand({ framework, path, dialect, skipExisting, force }) {
+	const registry = FrameworkScaffoldRegistry.createDefault();
+	const strategy = registry.get(framework);
+	const targetDir = resolve(process.cwd(), path);
+	let projectName = basename(targetDir);
+	try {
+		const pkgPath = join(targetDir, "package.json");
+		const raw = await readFile(pkgPath, "utf8");
+		const pkg = JSON.parse(raw);
+		if (typeof pkg.name === "string" && pkg.name.length > 0) projectName = pkg.name;
+	} catch {}
+	const packageManager = await detectPackageManager(targetDir);
+	const context = {
+		projectName,
+		targetDir,
+		framework,
+		packageManager,
+		dialect,
+		includeSeed: true
+	};
+	await scaffoldProject(context, strategy, {
+		mode: "init",
+		skipExisting,
+		force
+	});
+	const logger = getLogger("tango.codegen");
+	logger.info(`Tango init complete: ${targetDir}`);
+	logger.info(`Install dependencies: ${strategy.getTangoInstallOneLiner(packageManager, context)}`);
+	if (framework === SUPPORTED_FRAMEWORK.EXPRESS) logger.info("Mount Tango: import { registerTango } from './src/tango.js'; await registerTango(app);");
+}
+function withInitCommand(parser) {
+	return parser.command("init", "Add Tango to an existing project (only Tango-layer files)", (builder) => builder.option("framework", {
+		type: "string",
+		choices: Object.values(SUPPORTED_FRAMEWORK),
+		demandOption: true,
+		describe: "Host framework (express or next)."
+	}).option("path", {
+		type: "string",
+		default: ".",
+		describe: "Target directory (default: current directory)."
+	}).option("dialect", {
+		type: "string",
+		choices: Object.values(SCAFFOLD_DATABASE_DIALECT),
+		default: SCAFFOLD_DATABASE_DIALECT.SQLITE,
+		describe: "Database dialect for generated config."
+	}).option("skip-existing", {
+		type: "boolean",
+		default: true,
+		describe: "Do not overwrite existing files."
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		describe: "Overwrite existing files when set."
+	}), async ({ framework, path, dialect, skipExisting, force }) => {
+		await runInitCommand({
+			framework,
+			path,
+			dialect,
+			skipExisting,
+			force
+		});
+	});
+}
+
+//#endregion
+//#region src/commands/registerCodegenCommands.ts
+function registerCodegenCommands(parser) {
+	const withTopLevelNew = withNewCommand(parser);
+	const withTopLevelInit = withInitCommand(withTopLevelNew);
+	return withTopLevelInit.command("codegen <command>", "Code generation command group", (builder) => withInitCommand(withNewCommand(builder)));
+}
+
+//#endregion
+//#region src/commands/index.ts
+var commands_exports = {};
+__export(commands_exports, { registerCodegenCommands: () => registerCodegenCommands });
+
+//#endregion
+export { commands_exports, registerCodegenCommands };
+//# sourceMappingURL=commands-C2Xr9uRE.js.map

package/dist/commands-C2Xr9uRE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-C2Xr9uRE.js","names":["packageManager: PackageManager","cwd: string","argsByPackageManager: Record<PackageManager, readonly string[]>","context: FrameworkScaffoldContext","parser: Argv","targetDir: string","context: FrameworkScaffoldContext","parser: Argv","parser: Argv"],"sources":["../src/commands/runInstall.ts","../src/commands/runNewCommand.ts","../src/commands/runInitCommand.ts","../src/commands/registerCodegenCommands.ts","../src/commands/index.ts"],"sourcesContent":["import { spawnSync } from 'child_process';\nimport type { PackageManager } from '../frameworks';\n\nexport function runInstall(packageManager: PackageManager, cwd: string): void {\n    const argsByPackageManager: Record<PackageManager, readonly string[]> = {\n        pnpm: ['install'],\n        npm: ['install'],\n        yarn: ['install'],\n        bun: ['install'],\n    };\n\n    const result = spawnSync(packageManager, [...argsByPackageManager[packageManager]], {\n        cwd,\n        stdio: 'inherit',\n        env: process.env,\n    });\n\n    if (result.status !== 0) {\n        throw new Error(\n            `Dependency install failed with ${packageManager}. Exit code: ${String(result.status ?? 'unknown')}.`\n        );\n    }\n}\n","import { getLogger } from '@danceroutine/tango-core';\nimport { basename, resolve } from 'path/posix';\nimport {\n    type SupportedFramework,\n    type PackageManager,\n    FrameworkScaffoldRegistry,\n    type FrameworkScaffoldContext,\n    scaffoldProject,\n} from '../frameworks';\nimport {\n    PACKAGE_MANAGER,\n    SCAFFOLD_DATABASE_DIALECT,\n    SUPPORTED_FRAMEWORK,\n    type ScaffoldDatabaseDialect,\n} from '../frameworks/contracts/FrameworkScaffoldStrategy';\nimport { runInstall } from './runInstall';\nimport type { Argv } from 'yargs';\n\ntype NewCommandArgs = {\n    name?: string;\n    framework: SupportedFramework;\n    path?: string;\n    packageManager: PackageManager;\n    dialect: ScaffoldDatabaseDialect;\n    install: boolean;\n    force: boolean;\n    seed: boolean;\n};\nexport async function runNewCommand({\n    path,\n    name,\n    framework,\n    packageManager,\n    dialect,\n    install,\n    force,\n    seed: includeSeed,\n}: NewCommandArgs): Promise<void> {\n    const registry = FrameworkScaffoldRegistry.createDefault();\n    const strategy = registry.get(framework)!;\n\n    const requestedPath = path ?? name ?? 'tango-app';\n    const projectName = name ?? basename(requestedPath);\n    const targetDir = resolve(process.cwd(), requestedPath);\n\n    const context: FrameworkScaffoldContext = {\n        projectName,\n        targetDir,\n        framework,\n        packageManager,\n        dialect,\n        includeSeed,\n    };\n\n    await scaffoldProject(context, strategy, { force });\n\n    if (install) {\n        runInstall(packageManager, targetDir);\n    }\n\n    const logger = getLogger('tango.codegen');\n    logger.info(`Scaffold complete: ${targetDir}`);\n    logger.info(`Framework: ${strategy.name}`);\n    logger.info(`Run next: cd ${targetDir} && ${packageManager} run dev`);\n}\nexport function withNewCommand(parser: Argv): Argv {\n    return parser.command(\n        'new [name]',\n        'Bootstrap a new Tango project',\n        (builder) =>\n            builder\n                .positional('name', {\n                    type: 'string',\n                    describe: 'Project name (used as directory when --path is omitted).',\n                })\n                .option('framework', {\n                    type: 'string',\n                    choices: Object.values(SUPPORTED_FRAMEWORK),\n                    demandOption: true,\n                    describe: 'Host framework scaffold to generate.',\n                })\n                .option('path', {\n                    type: 'string',\n                    describe: 'Target directory for generated project files.',\n                })\n                .option('package-manager', {\n                    type: 'string',\n                    choices: Object.values(PACKAGE_MANAGER),\n                    default: PACKAGE_MANAGER.PNPM,\n                    describe: 'Package manager used for follow-up instructions and optional install.',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: Object.values(SCAFFOLD_DATABASE_DIALECT),\n                    default: SCAFFOLD_DATABASE_DIALECT.SQLITE,\n                    describe: 'Database dialect default for generated config.',\n                })\n                .option('install', {\n                    type: 'boolean',\n                    default: false,\n                    describe: 'Install dependencies after scaffolding.',\n                })\n                .option('force', {\n                    type: 'boolean',\n                    default: false,\n                    describe: 'Allow writing into a non-empty target directory.',\n                })\n                .option('seed', {\n                    type: 'boolean',\n                    default: true,\n                    describe: 'Include seed/bootstrap sample artifacts when supported by the framework strategy.',\n                }),\n        async ({ name, framework, path, packageManager, dialect, install, force, seed }) => {\n            await runNewCommand({\n                name,\n                framework,\n                path,\n                packageManager,\n                dialect,\n                install,\n                force,\n                seed,\n            });\n        }\n    );\n}\n","import { getLogger } from '@danceroutine/tango-core';\nimport { readdir, readFile } from 'fs/promises';\nimport { resolve, basename, join } from 'path/posix';\nimport {\n    type PackageManager,\n    type SupportedFramework,\n    FrameworkScaffoldRegistry,\n    type FrameworkScaffoldContext,\n    scaffoldProject,\n} from '../frameworks';\nimport {\n    PACKAGE_MANAGER,\n    SCAFFOLD_DATABASE_DIALECT,\n    type ScaffoldDatabaseDialect,\n    SUPPORTED_FRAMEWORK,\n} from '../frameworks/contracts/FrameworkScaffoldStrategy';\nimport type { Argv } from 'yargs';\n\nasync function detectPackageManager(targetDir: string): Promise<PackageManager> {\n    try {\n        const entries = await readdir(targetDir);\n        if (entries.includes('pnpm-lock.yaml')) return PACKAGE_MANAGER.PNPM;\n        if (entries.includes('package-lock.json')) return PACKAGE_MANAGER.NPM;\n        if (entries.includes('yarn.lock')) return PACKAGE_MANAGER.YARN;\n        if (entries.includes('bun.lockb') || entries.includes('bun.lock')) return PACKAGE_MANAGER.BUN;\n    } catch {\n        // ENOENT or other: fall through to default\n    }\n    return PACKAGE_MANAGER.PNPM;\n}\ntype InitCommandArgs = {\n    framework: SupportedFramework;\n    path: string;\n    dialect: ScaffoldDatabaseDialect;\n    skipExisting: boolean;\n    force: boolean;\n};\nexport async function runInitCommand({\n    framework,\n    path,\n    dialect,\n    skipExisting,\n    force,\n}: InitCommandArgs): Promise<void> {\n    const registry = FrameworkScaffoldRegistry.createDefault();\n    const strategy = registry.get(framework)!;\n    const targetDir = resolve(process.cwd(), path);\n\n    let projectName = basename(targetDir);\n    try {\n        const pkgPath = join(targetDir, 'package.json');\n        const raw = await readFile(pkgPath, 'utf8');\n        const pkg = JSON.parse(raw) as { name?: string };\n        if (typeof pkg.name === 'string' && pkg.name.length > 0) {\n            projectName = pkg.name;\n        }\n    } catch {\n        // no package.json or invalid: keep basename\n    }\n\n    const packageManager = await detectPackageManager(targetDir);\n\n    const context: FrameworkScaffoldContext = {\n        projectName,\n        targetDir,\n        framework,\n        packageManager,\n        dialect,\n        includeSeed: true,\n    };\n\n    await scaffoldProject(context, strategy, {\n        mode: 'init',\n        skipExisting,\n        force,\n    });\n\n    const logger = getLogger('tango.codegen');\n    logger.info(`Tango init complete: ${targetDir}`);\n    logger.info(`Install dependencies: ${strategy.getTangoInstallOneLiner(packageManager, context)}`);\n    if (framework === SUPPORTED_FRAMEWORK.EXPRESS) {\n        logger.info(\"Mount Tango: import { registerTango } from './src/tango.js'; await registerTango(app);\");\n    }\n}\nexport function withInitCommand(parser: Argv): Argv {\n    return parser.command(\n        'init',\n        'Add Tango to an existing project (only Tango-layer files)',\n        (builder) =>\n            builder\n                .option('framework', {\n                    type: 'string',\n                    choices: Object.values(SUPPORTED_FRAMEWORK),\n                    demandOption: true,\n                    describe: 'Host framework (express or next).',\n                })\n                .option('path', {\n                    type: 'string',\n                    default: '.',\n                    describe: 'Target directory (default: current directory).',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: Object.values(SCAFFOLD_DATABASE_DIALECT),\n                    default: SCAFFOLD_DATABASE_DIALECT.SQLITE,\n                    describe: 'Database dialect for generated config.',\n                })\n                .option('skip-existing', {\n                    type: 'boolean',\n                    default: true,\n                    describe: 'Do not overwrite existing files.',\n                })\n                .option('force', {\n                    type: 'boolean',\n                    default: false,\n                    describe: 'Overwrite existing files when set.',\n                }),\n        async ({ framework, path, dialect, skipExisting, force }) => {\n            await runInitCommand({\n                framework,\n                path,\n                dialect,\n                skipExisting,\n                force,\n            });\n        }\n    );\n}\n","import type { Argv } from 'yargs';\nimport { withNewCommand } from './runNewCommand';\nimport { withInitCommand } from './runInitCommand';\n\n/**\n * Register Tango project scaffolding commands on an existing CLI parser.\n */\nexport function registerCodegenCommands(parser: Argv): Argv {\n    const withTopLevelNew = withNewCommand(parser);\n    const withTopLevelInit = withInitCommand(withTopLevelNew);\n    return withTopLevelInit.command('codegen <command>', 'Code generation command group', (builder) =>\n        withInitCommand(withNewCommand(builder))\n    );\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { registerCodegenCommands } from './registerCodegenCommands';\n"],"mappings":"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"}

package/dist/frameworks/contracts/FrameworkScaffoldStrategy.d.ts

@@ -0,0 +1,39 @@
+import { type ScaffoldTemplate, type FrameworkScaffoldContext } from './template/ScaffoldTemplate';
+import { TemplateBuilder } from './template/TemplateBuilder';
+export declare const SUPPORTED_FRAMEWORK: {
+    readonly EXPRESS: "express";
+    readonly NEXT: "next";
+};
+export type SupportedFramework = (typeof SUPPORTED_FRAMEWORK)[keyof typeof SUPPORTED_FRAMEWORK];
+export declare const PACKAGE_MANAGER: {
+    readonly PNPM: "pnpm";
+    readonly NPM: "npm";
+    readonly YARN: "yarn";
+    readonly BUN: "bun";
+};
+export type PackageManager = (typeof PACKAGE_MANAGER)[keyof typeof PACKAGE_MANAGER];
+export declare const SCAFFOLD_DATABASE_DIALECT: {
+    readonly SQLITE: "sqlite";
+    readonly POSTGRES: "postgres";
+};
+export type ScaffoldDatabaseDialect = (typeof SCAFFOLD_DATABASE_DIALECT)[keyof typeof SCAFFOLD_DATABASE_DIALECT];
+/**
+ * Base scaffold strategy contract and helpers for Tango framework scaffolds.
+ *
+ * Concrete strategies extend this class and assemble their template lists
+ * through the protected helpers below.
+ */
+export declare abstract class FrameworkScaffoldStrategy {
+    abstract readonly id: SupportedFramework;
+    abstract readonly name: string;
+    abstract readonly description: string;
+    /**
+     * One-liner to install Tango + dialect deps and Tango CLI, for init success message.
+     */
+    getTangoInstallOneLiner(packageManager: PackageManager, context: FrameworkScaffoldContext): string;
+    abstract getTemplates(): readonly ScaffoldTemplate[];
+    protected addFrameworkTemplate(template: TemplateBuilder): ScaffoldTemplate;
+    protected addTangoTemplate(template: TemplateBuilder): ScaffoldTemplate;
+    protected addInitOnlyTemplate(template: TemplateBuilder): ScaffoldTemplate;
+    private createTemplate;
+}

package/dist/frameworks/contracts/template/ScaffoldTemplate.d.ts

@@ -0,0 +1,22 @@
+import type { SupportedFramework, PackageManager, ScaffoldDatabaseDialect } from '../FrameworkScaffoldStrategy';
+export declare const SCAFFOLD_TEMPLATE_CATEGORY: {
+    readonly FRAMEWORK: "framework";
+    readonly TANGO: "tango";
+    readonly INIT_ONLY: "init-only";
+};
+export type ScaffoldTemplateCategory = (typeof SCAFFOLD_TEMPLATE_CATEGORY)[keyof typeof SCAFFOLD_TEMPLATE_CATEGORY];
+export type ScaffoldMode = 'new' | 'init';
+export type FrameworkScaffoldContext = {
+    projectName: string;
+    targetDir: string;
+    framework: SupportedFramework;
+    packageManager: PackageManager;
+    dialect: ScaffoldDatabaseDialect;
+    includeSeed: boolean;
+};
+export interface ScaffoldTemplate {
+    readonly path: string;
+    readonly category: ScaffoldTemplateCategory;
+    render(ctx: FrameworkScaffoldContext): string;
+    shouldEmit(mode: ScaffoldMode): boolean;
+}

package/dist/frameworks/contracts/template/TemplateBuilder.d.ts

@@ -0,0 +1,40 @@
+import type { FrameworkScaffoldContext } from './ScaffoldTemplate';
+/**
+ * Interface for a context-bound template that the strategy's add* methods accept.
+ * Implemented by bound TemplateBuilder instances and by the return value of createStaticTemplate.
+ */
+export interface BoundTemplate {
+    getPath(): string;
+    build(): string;
+}
+/**
+ * Base class for scaffold template builders. Subclasses override resolveTemplate().
+ * Use new WhateverBuilder().setContext(context) for registration with add* methods.
+ * Deps logic (getTangoDependencyEntries, getTangoDevDependencyEntries) and version live here.
+ */
+export declare abstract class TemplateBuilder implements BoundTemplate {
+    protected readonly name: string;
+    protected _context?: FrameworkScaffoldContext;
+    constructor(options: {
+        name: string;
+    });
+    /**
+     * One-liner to install Tango + dialect deps and Tango CLI (for init success message).
+     */
+    static getTangoInstallOneLiner(packageManager: string, dialect: 'sqlite' | 'postgres', framework: 'express' | 'next'): string;
+    /**
+     * Shorthand for static content (no subclass needed). Returns a BoundTemplate that add* methods accept.
+     */
+    static createStaticTemplate(fileName: string, template: string | (() => string)): TemplateBuilder;
+    /** Tango package version (semver range) for scaffolded dependency entries. */
+    private static getTangoVersion;
+    private static getTangoDependencyEntriesFor;
+    private static getTangoDevDependencyEntriesFor;
+    /** Bind context and return this for chaining. Use before passing to add* methods. */
+    setContext(context: FrameworkScaffoldContext): this;
+    getPath(): string;
+    protected abstract resolveTemplate(context: FrameworkScaffoldContext): string;
+    build(): string;
+    protected getTangoDependencyEntries(context: FrameworkScaffoldContext): Record<string, string>;
+    protected getTangoDevDependencyEntries(_context: FrameworkScaffoldContext): Record<string, string>;
+}

package/dist/frameworks/contracts/template/implementation/ScaffoldTemplateDescriptor.d.ts

@@ -0,0 +1,10 @@
+import { type ScaffoldTemplate, type ScaffoldTemplateCategory, type FrameworkScaffoldContext, type ScaffoldMode } from '../ScaffoldTemplate';
+import type { TemplateBuilder } from '../TemplateBuilder';
+export declare class ScaffoldTemplateDescriptor implements ScaffoldTemplate {
+    readonly template: TemplateBuilder;
+    readonly category: ScaffoldTemplateCategory;
+    constructor(template: TemplateBuilder, category: ScaffoldTemplateCategory);
+    get path(): string;
+    render(ctx: FrameworkScaffoldContext): string;
+    shouldEmit(mode: ScaffoldMode): boolean;
+}

package/dist/frameworks/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Domain boundary barrel: centralizes this subdomain's public contract.
+ */
+export { type FrameworkScaffoldContext, type ScaffoldMode, type ScaffoldTemplate, type ScaffoldTemplateCategory, SCAFFOLD_TEMPLATE_CATEGORY, } from './contracts/template/ScaffoldTemplate';
+export type { PackageManager, ScaffoldDatabaseDialect as ScaffoldDialect, SupportedFramework, } from './contracts/FrameworkScaffoldStrategy';
+export { FrameworkScaffoldStrategy } from './contracts/FrameworkScaffoldStrategy';
+export { ScaffoldTemplateDescriptor } from './contracts/template/implementation/ScaffoldTemplateDescriptor';
+export { FrameworkScaffoldRegistry } from './registry/FrameworkScaffoldRegistry';
+export { ExpressScaffoldStrategy } from './strategies/express/ExpressScaffoldStrategy';
+export { NextScaffoldStrategy } from './strategies/next/NextScaffoldStrategy';
+export { scaffoldProject, type ScaffoldProjectOptions } from './scaffold/scaffoldProject';

package/dist/frameworks/index.js

@@ -0,0 +1,3 @@
+import { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, SCAFFOLD_TEMPLATE_CATEGORY, ScaffoldTemplateDescriptor, scaffoldProject } from "../frameworks-Bp_9BOt2.js";
+
+export { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, SCAFFOLD_TEMPLATE_CATEGORY, ScaffoldTemplateDescriptor, scaffoldProject };

package/dist/frameworks/registry/FrameworkScaffoldRegistry.d.ts

@@ -0,0 +1,23 @@
+import { FrameworkScaffoldStrategy, type SupportedFramework } from '../contracts/FrameworkScaffoldStrategy';
+/**
+ * Registry for framework scaffolding strategies keyed by framework id.
+ */
+export declare class FrameworkScaffoldRegistry {
+    private readonly strategies;
+    /**
+     * Create a registry preloaded with Tango's built-in framework scaffolds.
+     */
+    static createDefault(): FrameworkScaffoldRegistry;
+    /**
+     * Register a strategy under its declared framework id.
+     */
+    register(strategy: FrameworkScaffoldStrategy): void;
+    /**
+     * Resolve a strategy for a known framework id.
+     */
+    get(id: SupportedFramework): FrameworkScaffoldStrategy | undefined;
+    /**
+     * List all registered framework strategies in registration order.
+     */
+    list(): readonly FrameworkScaffoldStrategy[];
+}

package/dist/frameworks/scaffold/scaffoldProject.d.ts

@@ -0,0 +1,17 @@
+import type { FrameworkScaffoldStrategy } from '../contracts/FrameworkScaffoldStrategy';
+import type { FrameworkScaffoldContext, ScaffoldMode } from '../contracts/template/ScaffoldTemplate';
+export type ScaffoldProjectOptions = {
+    force?: boolean;
+    /** 'new' = full scaffold; 'init' = only Tango + init-only files. Default 'new'. */
+    mode?: ScaffoldMode;
+    /** When true, do not overwrite existing files. Default true when mode === 'init', otherwise false. */
+    skipExisting?: boolean;
+};
+/**
+ * Write a framework scaffold into a target directory after basic safety checks.
+ *
+ * The selected strategy controls which files are created, while this helper
+ * owns directory validation and filesystem writes. With mode 'init', only
+ * Tango and init-only templates are emitted, and existing files can be skipped.
+ */
+export declare function scaffoldProject(context: FrameworkScaffoldContext, strategy: FrameworkScaffoldStrategy, options?: ScaffoldProjectOptions): Promise<void>;

package/dist/frameworks/strategies/express/ExpressScaffoldStrategy.d.ts

@@ -0,0 +1,14 @@
+import { FrameworkScaffoldStrategy } from '../../contracts/FrameworkScaffoldStrategy';
+import type { ScaffoldTemplate } from '../../contracts/template/ScaffoldTemplate';
+/**
+ * Scaffold strategy for creating an Express-hosted Tango project.
+ */
+export declare class ExpressScaffoldStrategy extends FrameworkScaffoldStrategy {
+    readonly id: "express";
+    readonly name = "Express";
+    readonly description = "Bootstrap a Tango application hosted by Express.";
+    /**
+     * Return the file templates needed for the generated Express project.
+     */
+    getTemplates(): readonly ScaffoldTemplate[];
+}

package/dist/frameworks/strategies/express/templates/appSource.d.ts

@@ -0,0 +1,6 @@
+import { TemplateBuilder } from '../../../contracts/template/TemplateBuilder';
+import type { FrameworkScaffoldContext } from '../../../contracts/template/ScaffoldTemplate';
+export declare class AppSourceTemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(_context: FrameworkScaffoldContext): string;
+}

package/dist/frameworks/strategies/express/templates/bootstrap.d.ts

@@ -0,0 +1,6 @@
+import { TemplateBuilder } from '../../../contracts/template/TemplateBuilder';
+import type { FrameworkScaffoldContext } from '../../../contracts/template/ScaffoldTemplate';
+export declare class BootstrapTemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(_context: FrameworkScaffoldContext): string;
+}

package/dist/frameworks/strategies/express/templates/models.d.ts

@@ -0,0 +1,10 @@
+import { TemplateBuilder } from '../../../contracts/template/TemplateBuilder';
+import type { FrameworkScaffoldContext } from '../../../contracts/template/ScaffoldTemplate';
+export declare class TodoModelTemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(_context: FrameworkScaffoldContext): string;
+}
+export declare class ModelsBarrelTemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(_context: FrameworkScaffoldContext): string;
+}

package/dist/frameworks/strategies/express/templates/openapi.d.ts

@@ -0,0 +1,6 @@
+import { TemplateBuilder } from '../../../contracts/template/TemplateBuilder';
+import type { FrameworkScaffoldContext } from '../../../contracts/template/ScaffoldTemplate';
+export declare class OpenAPITemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(_context: FrameworkScaffoldContext): string;
+}

package/dist/frameworks/strategies/express/templates/packageJson.d.ts

@@ -0,0 +1,6 @@
+import { TemplateBuilder } from '../../../contracts/template/TemplateBuilder';
+import type { FrameworkScaffoldContext } from '../../../contracts/template/ScaffoldTemplate';
+export declare class PackageJsonTemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(context: FrameworkScaffoldContext): string;
+}

package/dist/frameworks/strategies/express/templates/readme.d.ts

@@ -0,0 +1,6 @@
+import { TemplateBuilder } from '../../../contracts/template/TemplateBuilder';
+import type { FrameworkScaffoldContext } from '../../../contracts/template/ScaffoldTemplate';
+export declare class ReadmeTemplateBuilder extends TemplateBuilder {
+    constructor();
+    protected resolveTemplate(context: FrameworkScaffoldContext): string;
+}