@danceroutine/tango-codegen 1.11.0 → 1.11.2

package/dist/index-DDt-Xe7q.d.ts

@@ -0,0 +1,201 @@
+//#region src/frameworks/contracts/template/TemplateBuilder.d.ts
+/**
+ * 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.
+ */
+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.
+ */
+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: PackageManager, dialect: 'sqlite' | 'postgres', framework: 'express' | 'next' | 'nuxt'): string;
+  static getRunScriptCommand(packageManager: PackageManager, scriptName: string, scriptArgs?: readonly string[]): 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>;
+}
+//#endregion
+//#region src/frameworks/contracts/FrameworkScaffoldStrategy.d.ts
+declare const SUPPORTED_FRAMEWORK: {
+  readonly EXPRESS: "express";
+  readonly NEXT: "next";
+  readonly NUXT: "nuxt";
+};
+type SupportedFramework = (typeof SUPPORTED_FRAMEWORK)[keyof typeof SUPPORTED_FRAMEWORK];
+declare const PACKAGE_MANAGER: {
+  readonly PNPM: "pnpm";
+  readonly NPM: "npm";
+  readonly YARN: "yarn";
+  readonly BUN: "bun";
+};
+type PackageManager = (typeof PACKAGE_MANAGER)[keyof typeof PACKAGE_MANAGER];
+declare const SCAFFOLD_DATABASE_DIALECT: {
+  readonly SQLITE: "sqlite";
+  readonly POSTGRES: "postgres";
+};
+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.
+ */
+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;
+}
+//#endregion
+//#region src/frameworks/contracts/template/ScaffoldTemplate.d.ts
+declare const SCAFFOLD_TEMPLATE_CATEGORY: {
+  readonly FRAMEWORK: "framework";
+  readonly TANGO: "tango";
+  readonly INIT_ONLY: "init-only";
+};
+type ScaffoldTemplateCategory = (typeof SCAFFOLD_TEMPLATE_CATEGORY)[keyof typeof SCAFFOLD_TEMPLATE_CATEGORY];
+type ScaffoldMode = 'new' | 'init';
+type FrameworkScaffoldContext = {
+  projectName: string;
+  targetDir: string;
+  framework: SupportedFramework;
+  packageManager: PackageManager;
+  dialect: ScaffoldDatabaseDialect;
+  includeSeed: boolean;
+};
+interface ScaffoldTemplate {
+  readonly path: string;
+  readonly category: ScaffoldTemplateCategory;
+  render(ctx: FrameworkScaffoldContext): string;
+  shouldEmit(mode: ScaffoldMode): boolean;
+}
+//#endregion
+//#region src/frameworks/contracts/template/implementation/ScaffoldTemplateDescriptor.d.ts
+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;
+}
+//#endregion
+//#region src/frameworks/registry/FrameworkScaffoldRegistry.d.ts
+/**
+ * Registry for framework scaffolding strategies keyed by framework id.
+ */
+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[];
+}
+//#endregion
+//#region src/frameworks/strategies/express/ExpressScaffoldStrategy.d.ts
+/**
+ * Scaffold strategy for creating an Express-hosted Tango project.
+ */
+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[];
+}
+//#endregion
+//#region src/frameworks/strategies/next/NextScaffoldStrategy.d.ts
+/**
+ * Scaffold strategy for creating a Next.js-hosted Tango project.
+ */
+declare class NextScaffoldStrategy extends FrameworkScaffoldStrategy {
+  readonly id: "next";
+  readonly name = "Next.js";
+  readonly description = "Bootstrap a Tango application hosted by Next.js App Router.";
+  /**
+   * Return the file templates needed for the generated Next.js project.
+   */
+  getTemplates(): readonly ScaffoldTemplate[];
+}
+//#endregion
+//#region src/frameworks/strategies/nuxt/NuxtScaffoldStrategy.d.ts
+/**
+ * Scaffold strategy for creating a Nuxt-hosted Tango project.
+ */
+declare class NuxtScaffoldStrategy extends FrameworkScaffoldStrategy {
+  readonly id: "nuxt";
+  readonly name = "Nuxt";
+  readonly description = "Bootstrap a Tango application hosted by Nuxt Nitro and SSR pages.";
+  /**
+   * Return the file templates needed for the generated Nuxt project.
+   */
+  getTemplates(): readonly ScaffoldTemplate[];
+}
+//#endregion
+//#region src/frameworks/scaffold/scaffoldProject.d.ts
+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.
+ */
+declare function scaffoldProject(context: FrameworkScaffoldContext, strategy: FrameworkScaffoldStrategy, options?: ScaffoldProjectOptions): Promise<void>;
+declare namespace index_d_exports {
+  export { ExpressScaffoldStrategy, FrameworkScaffoldContext, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, PackageManager, SCAFFOLD_TEMPLATE_CATEGORY, ScaffoldDatabaseDialect as ScaffoldDialect, ScaffoldMode, ScaffoldProjectOptions, ScaffoldTemplate, ScaffoldTemplateCategory, ScaffoldTemplateDescriptor, SupportedFramework, scaffoldProject };
+}
+//#endregion
+export { SupportedFramework as _, NextScaffoldStrategy as a, ScaffoldTemplateDescriptor as c, ScaffoldMode as d, ScaffoldTemplate as f, ScaffoldDatabaseDialect as g, PackageManager as h, NuxtScaffoldStrategy as i, FrameworkScaffoldContext as l, FrameworkScaffoldStrategy as m, ScaffoldProjectOptions as n, ExpressScaffoldStrategy as o, ScaffoldTemplateCategory as p, scaffoldProject as r, FrameworkScaffoldRegistry as s, index_d_exports as t, SCAFFOLD_TEMPLATE_CATEGORY as u };
+//# sourceMappingURL=index-DDt-Xe7q.d.ts.map

package/dist/index-DM7Ade2V.d.ts

@@ -0,0 +1,43 @@
+import { ModelRegistry } from "@danceroutine/tango-schema";
+import { Argv } from "yargs";
+
+//#region src/commands/registerCodegenCommands.d.ts
+/**
+ * Register Tango project scaffolding commands on an existing CLI parser.
+ */
+declare function registerCodegenCommands(parser: Argv): Argv;
+//#endregion
+//#region src/commands/loadProjectModule.d.ts
+type ProjectModuleLoadResult = {
+  loaded: Record<string, unknown>;
+  modelTypeAccessors: Record<string, string>;
+  registry: ModelRegistry;
+};
+/**
+ * Load a Tango app module and discover model export accessors suitable for
+ * generated ambient type references.
+ */
+declare function loadProjectModule(modulePath: string, options?: {
+  projectRoot?: string;
+  outputDir?: string;
+}): Promise<ProjectModuleLoadResult>;
+//#endregion
+//#region src/commands/runGenerateRelationsCommand.d.ts
+type GenerateRelationsCommandArgs = {
+  models: string;
+  outDir: string;
+};
+/**
+ * Generate the app-local ambient relation registry from a finalized model graph.
+ */
+declare function runGenerateRelationsCommand({
+  models,
+  outDir
+}: GenerateRelationsCommandArgs): Promise<void>;
+declare function withGenerateRelationsCommand(parser: Argv): Argv;
+declare namespace index_d_exports {
+  export { loadProjectModule, registerCodegenCommands, runGenerateRelationsCommand, withGenerateRelationsCommand };
+}
+//#endregion
+export { registerCodegenCommands as a, loadProjectModule as i, runGenerateRelationsCommand as n, withGenerateRelationsCommand as r, index_d_exports as t };
+//# sourceMappingURL=index-DM7Ade2V.d.ts.map

package/dist/index-XicN3qCI.d.ts

@@ -0,0 +1,82 @@
+import { r as CodegenModel } from "./index-sKndVpFf.js";
+import { GeneratedRelationRegistryArtifact, ModelRegistry, ResolvedRelationGraphSnapshot } from "@danceroutine/tango-schema";
+
+//#region src/generators/migration/generateMigrationFromModels.d.ts
+/**
+ * Generate a class-based Tango migration source file from model metadata.
+ *
+ * The generated migration creates one table per model in `up()` and drops
+ * those tables in reverse order in `down()` to keep teardown deterministic.
+ */
+declare function generateMigrationFromModels(models: CodegenModel[]): string;
+declare namespace index_d_exports$4 {
+  export { generateMigrationFromModels };
+}
+//#endregion
+//#region src/generators/model/generateModelInterface.d.ts
+/**
+ * Generate a TypeScript interface string from a Tango codegen model.
+ */
+declare function generateModelInterface(model: CodegenModel): string;
+declare namespace index_d_exports$3 {
+  export { generateModelInterface };
+}
+//#endregion
+//#region src/generators/relations/generateRelationRegistryArtifacts.d.ts
+type GenerateRelationRegistryArtifactsInput = {
+  snapshot: ResolvedRelationGraphSnapshot;
+  fingerprint: string;
+  modelTypeAccessors: Readonly<Record<string, string>>;
+};
+type GeneratedRelationRegistryArtifacts = {
+  declaration: string;
+  metadata: GeneratedRelationRegistryArtifact;
+};
+/**
+ * Generate the ambient relation registry declaration and metadata payload from
+ * a finalized relation-graph snapshot.
+ */
+declare function generateRelationRegistryArtifacts({
+  snapshot,
+  fingerprint,
+  modelTypeAccessors
+}: GenerateRelationRegistryArtifactsInput): GeneratedRelationRegistryArtifacts;
+//#endregion
+//#region src/generators/relations/writeRelationRegistryArtifacts.d.ts
+type WriteRelationRegistryArtifactsInput = {
+  registry: ModelRegistry;
+  modelTypeAccessors: Readonly<Record<string, string>>;
+  outputDir?: string;
+};
+type WrittenRelationRegistryArtifacts = {
+  outputDir: string;
+  typesFilepath: string;
+  metadataFilepath: string;
+  fingerprint: string;
+};
+/**
+ * Write the generated relation typing declaration and metadata files to disk.
+ */
+declare function writeRelationRegistryArtifacts({
+  registry,
+  modelTypeAccessors,
+  outputDir
+}: WriteRelationRegistryArtifactsInput): Promise<WrittenRelationRegistryArtifacts>;
+declare namespace index_d_exports$2 {
+  export { GenerateRelationRegistryArtifactsInput, GeneratedRelationRegistryArtifacts, WriteRelationRegistryArtifactsInput, WrittenRelationRegistryArtifacts, generateRelationRegistryArtifacts, writeRelationRegistryArtifacts };
+}
+//#endregion
+//#region src/generators/viewset/generateViewSet.d.ts
+/**
+ * Generate a `ModelViewSet` scaffold wired directly to a Tango model.
+ */
+declare function generateViewSet(modelName: string): string;
+declare namespace index_d_exports$1 {
+  export { generateViewSet };
+}
+declare namespace index_d_exports {
+  export { generateMigrationFromModels, generateModelInterface, generateRelationRegistryArtifacts, generateViewSet, index_d_exports$4 as migration, index_d_exports$3 as model, index_d_exports$2 as relations, index_d_exports$1 as viewset, writeRelationRegistryArtifacts };
+}
+//#endregion
+export { writeRelationRegistryArtifacts as a, generateModelInterface as c, index_d_exports$2 as i, index_d_exports$4 as l, index_d_exports$1 as n, generateRelationRegistryArtifacts as o, generateViewSet as r, index_d_exports$3 as s, index_d_exports as t, generateMigrationFromModels as u };
+//# sourceMappingURL=index-XicN3qCI.d.ts.map

package/dist/index-sKndVpFf.d.ts

@@ -0,0 +1,26 @@
+//#region src/domain/CodegenModel.d.ts
+type CodegenFieldMeta = {
+  type: string;
+  dbType?: string;
+  primaryKey?: boolean;
+  unique?: boolean;
+  nullable?: boolean;
+  default?: unknown;
+};
+type CodegenModel = {
+  name: string;
+  fields: Record<string, CodegenFieldMeta> | Array<{
+    name: string;
+    type: string;
+    primaryKey?: boolean;
+    unique?: boolean;
+    notNull?: boolean;
+    default?: unknown;
+  }>;
+};
+declare namespace index_d_exports {
+  export { CodegenFieldMeta, CodegenModel };
+}
+//#endregion
+export { CodegenFieldMeta as n, CodegenModel as r, index_d_exports as t };
+//# sourceMappingURL=index-sKndVpFf.d.ts.map

package/dist/index.d.ts

@@ -1,15 +1,20 @@
+import { a as registerCodegenCommands, i as loadProjectModule, n as runGenerateRelationsCommand, t as index_d_exports } from "./index-DM7Ade2V.js";
+import { n as CodegenFieldMeta, r as CodegenModel, t as index_d_exports$1 } from "./index-sKndVpFf.js";
+import { _ as SupportedFramework, a as NextScaffoldStrategy, g as ScaffoldDatabaseDialect, h as PackageManager, i as NuxtScaffoldStrategy, l as FrameworkScaffoldContext, m as FrameworkScaffoldStrategy, o as ExpressScaffoldStrategy, r as scaffoldProject, s as FrameworkScaffoldRegistry, t as index_d_exports$2 } from "./index-DDt-Xe7q.js";
+import { a as writeRelationRegistryArtifacts, c as generateModelInterface, o as generateRelationRegistryArtifacts, r as generateViewSet, t as index_d_exports$3, u as generateMigrationFromModels } from "./index-XicN3qCI.js";
+
+//#region src/mappers/fieldType.d.ts
 /**
- * Bundled exports for Django-style domain drill-down imports, plus curated
- * top-level symbols for TS-native ergonomic imports.
+ * Map Tango field metadata to the TypeScript type used in generated source.
  */
-export * as domain from './domain/index';
-export * as generators from './generators/index';
-export * as mappers from './mappers/index';
-export * as frameworks from './frameworks/index';
-export * as commands from './commands/index';
-export type { CodegenFieldMeta, CodegenModel } from './domain/index';
-export { generateMigrationFromModels, generateModelInterface, generateRelationRegistryArtifacts, writeRelationRegistryArtifacts, generateViewSet, } from './generators/index';
-export { mapFieldTypeToTS, normalizeFields } from './mappers/index';
-export { FrameworkScaffoldRegistry, ExpressScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, scaffoldProject, } from './frameworks/index';
-export type { FrameworkScaffoldContext, FrameworkScaffoldStrategy, PackageManager, ScaffoldDialect, SupportedFramework, } from './frameworks/index';
-export { loadProjectModule, registerCodegenCommands, runGenerateRelationsCommand } from './commands/index';
+declare function mapFieldTypeToTS(type: string): string;
+/**
+ * Normalize field metadata into a stable iterable shape for generators.
+ */
+declare function normalizeFields(fields: CodegenModel['fields']): Array<[string, CodegenFieldMeta]>;
+declare namespace index_d_exports$4 {
+  export { mapFieldTypeToTS, normalizeFields };
+}
+//#endregion
+export { type CodegenFieldMeta, type CodegenModel, ExpressScaffoldStrategy, type FrameworkScaffoldContext, FrameworkScaffoldRegistry, type FrameworkScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, type PackageManager, type ScaffoldDatabaseDialect as ScaffoldDialect, type SupportedFramework, index_d_exports as commands, index_d_exports$1 as domain, index_d_exports$2 as frameworks, generateMigrationFromModels, generateModelInterface, generateRelationRegistryArtifacts, generateViewSet, index_d_exports$3 as generators, loadProjectModule, mapFieldTypeToTS, index_d_exports$4 as mappers, normalizeFields, registerCodegenCommands, runGenerateRelationsCommand, scaffoldProject, writeRelationRegistryArtifacts };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,7 +1,6 @@
-import { domain_exports } from "./domain-Cufz6y1q.js";
-import { generateMigrationFromModels, generateModelInterface, generateViewSet, generators_exports, mapFieldTypeToTS, mappers_exports, normalizeFields } from "./generators-DuAuGNR2.js";
-import { generateRelationRegistryArtifacts, writeRelationRegistryArtifacts } from "./relations-DqDEZ6MV.js";
-import { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, NextScaffoldStrategy, NuxtScaffoldStrategy, frameworks_exports, scaffoldProject } from "./frameworks-D4q168d9.js";
-import { commands_exports, loadProjectModule, registerCodegenCommands, runGenerateRelationsCommand } from "./commands-CFAq4wXC.js";
-
-export { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, NextScaffoldStrategy, NuxtScaffoldStrategy, commands_exports as commands, domain_exports as domain, frameworks_exports as frameworks, generateMigrationFromModels, generateModelInterface, generateRelationRegistryArtifacts, generateViewSet, generators_exports as generators, loadProjectModule, mapFieldTypeToTS, mappers_exports as mappers, normalizeFields, registerCodegenCommands, runGenerateRelationsCommand, scaffoldProject, writeRelationRegistryArtifacts };
+import { t as domain_exports } from "./domain/index.js";
+import { a as generateModelInterface, c as mappers_exports, l as mapFieldTypeToTS, r as generateViewSet, s as generateMigrationFromModels, t as generators_exports, u as normalizeFields } from "./generators-D7GoehXD.js";
+import { n as writeRelationRegistryArtifacts, r as generateRelationRegistryArtifacts } from "./relations-tePbGOWl.js";
+import { a as NextScaffoldStrategy, i as NuxtScaffoldStrategy, n as scaffoldProject, o as ExpressScaffoldStrategy, r as FrameworkScaffoldRegistry, t as frameworks_exports } from "./frameworks-DcmEvb3N.js";
+import { a as loadProjectModule, n as registerCodegenCommands, r as runGenerateRelationsCommand, t as commands_exports } from "./commands-pbMmQ_tn.js";
+export { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, NextScaffoldStrategy, NuxtScaffoldStrategy, commands_exports as commands, domain_exports as domain, frameworks_exports as frameworks, generateMigrationFromModels, generateModelInterface, generateRelationRegistryArtifacts, generateViewSet, generators_exports as generators, loadProjectModule, mapFieldTypeToTS, mappers_exports as mappers, normalizeFields, registerCodegenCommands, runGenerateRelationsCommand, scaffoldProject, writeRelationRegistryArtifacts };

package/dist/{relations-DqDEZ6MV.js → relations-tePbGOWl.js}

@@ -1,9 +1,12 @@
-import { __export } from "./chunk-BkvOhyD0.js";
+import { t as __exportAll } from "./chunk-D7D4PA-g.js";
 import { GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_METADATA_VERSION, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, ImplicitManyToManyIdentifier } from "@danceroutine/tango-schema";
 import { mkdir, writeFile } from "node:fs/promises";
 import { resolve } from "node:path";
-
 //#region src/generators/relations/generateRelationRegistryArtifacts.ts
+/**
+* Generate the ambient relation registry declaration and metadata payload from
+* a finalized relation-graph snapshot.
+*/
 function generateRelationRegistryArtifacts({ snapshot, fingerprint, modelTypeAccessors }) {
 	const publicModels = snapshot.models.filter((model) => !ImplicitManyToManyIdentifier.isImplicitManyToManyModel(model.key));
 	for (const model of publicModels) for (const relation of model.relations) {
@@ -11,29 +14,28 @@ function generateRelationRegistryArtifacts({ snapshot, fingerprint, modelTypeAcc
 		if (!relation.capabilities.hydratable) continue;
 		if (!modelTypeAccessors[relation.targetModelKey]) throw new Error(`Unable to generate relation typing for '${relation.targetModelKey}'. Ensure the models module exports that model directly or through a one-level object export.`);
 	}
-	const declarationLines = [
-		"/**",
-		" * Generated by `tango codegen relations`.",
-		" * Do not edit this file directly.",
-		" */",
-		"declare global {",
-		"    interface TangoGeneratedRelationRegistry {",
-		...publicModels.map((model) => {
-			const hydratableRelations = model.relations.filter((relation) => relation.capabilities.hydratable && !ImplicitManyToManyIdentifier.isImplicitManyToManyModel(relation.targetModelKey));
-			const relationLines = hydratableRelations.length === 0 ? ["            [key: string]: never;"] : hydratableRelations.map((relation) => `            ${JSON.stringify(relation.name)}: { target: ${modelTypeAccessors[relation.targetModelKey]}; cardinality: ${JSON.stringify(relation.cardinality)}; kind: ${JSON.stringify(relation.kind)} };`);
-			return [
-				`        ${JSON.stringify(model.key)}: {`,
-				...relationLines,
-				"        };"
-			].join("\n");
-		}),
-		"    }",
-		"}",
-		"export type __TangoGeneratedRelationRegistryModule = TangoGeneratedRelationRegistry;",
-		""
-	];
 	return {
-		declaration: declarationLines.join("\n"),
+		declaration: [
+			"/**",
+			" * Generated by `tango codegen relations`.",
+			" * Do not edit this file directly.",
+			" */",
+			"declare global {",
+			"    interface TangoGeneratedRelationRegistry {",
+			...publicModels.map((model) => {
+				const hydratableRelations = model.relations.filter((relation) => relation.capabilities.hydratable && !ImplicitManyToManyIdentifier.isImplicitManyToManyModel(relation.targetModelKey));
+				const relationLines = hydratableRelations.length === 0 ? ["            [key: string]: never;"] : hydratableRelations.map((relation) => `            ${JSON.stringify(relation.name)}: { target: ${modelTypeAccessors[relation.targetModelKey]}; cardinality: ${JSON.stringify(relation.cardinality)}; kind: ${JSON.stringify(relation.kind)} };`);
+				return [
+					`        ${JSON.stringify(model.key)}: {`,
+					...relationLines,
+					"        };"
+				].join("\n");
+			}),
+			"    }",
+			"}",
+			"export type __TangoGeneratedRelationRegistryModule = TangoGeneratedRelationRegistry;",
+			""
+		].join("\n"),
 		metadata: {
 			version: GENERATED_RELATION_REGISTRY_METADATA_VERSION,
 			fingerprint,
@@ -41,9 +43,11 @@ function generateRelationRegistryArtifacts({ snapshot, fingerprint, modelTypeAcc
 		}
 	};
 }
-
 //#endregion
 //#region src/generators/relations/writeRelationRegistryArtifacts.ts
+/**
+* Write the generated relation typing declaration and metadata files to disk.
+*/
 async function writeRelationRegistryArtifacts({ registry, modelTypeAccessors, outputDir = resolve(process.cwd(), GENERATED_RELATION_REGISTRY_DIRNAME) }) {
 	const snapshot = registry.getResolvedRelationGraphSnapshot();
 	const fingerprint = registry.getResolvedRelationGraphFingerprint();
@@ -64,15 +68,13 @@ async function writeRelationRegistryArtifacts({ registry, modelTypeAccessors, ou
 		fingerprint
 	};
 }
-
 //#endregion
 //#region src/generators/relations/index.ts
-var relations_exports = {};
-__export(relations_exports, {
+var relations_exports = /* @__PURE__ */ __exportAll({
 	generateRelationRegistryArtifacts: () => generateRelationRegistryArtifacts,
 	writeRelationRegistryArtifacts: () => writeRelationRegistryArtifacts
 });
-
 //#endregion
-export { generateRelationRegistryArtifacts, relations_exports, writeRelationRegistryArtifacts };
-//# sourceMappingURL=relations-DqDEZ6MV.js.map
+export { writeRelationRegistryArtifacts as n, generateRelationRegistryArtifacts as r, relations_exports as t };
+
+//# sourceMappingURL=relations-tePbGOWl.js.map

package/dist/relations-tePbGOWl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations-tePbGOWl.js","names":[],"sources":["../src/generators/relations/generateRelationRegistryArtifacts.ts","../src/generators/relations/writeRelationRegistryArtifacts.ts","../src/generators/relations/index.ts"],"sourcesContent":["import {\n    GENERATED_RELATION_REGISTRY_METADATA_VERSION,\n    ImplicitManyToManyIdentifier,\n    type GeneratedRelationRegistryArtifact,\n    type ResolvedRelationGraphSnapshot,\n} from '@danceroutine/tango-schema';\n\nexport type GenerateRelationRegistryArtifactsInput = {\n    snapshot: ResolvedRelationGraphSnapshot;\n    fingerprint: string;\n    modelTypeAccessors: Readonly<Record<string, string>>;\n};\n\nexport type GeneratedRelationRegistryArtifacts = {\n    declaration: string;\n    metadata: GeneratedRelationRegistryArtifact;\n};\n\n/**\n * Generate the ambient relation registry declaration and metadata payload from\n * a finalized relation-graph snapshot.\n */\nexport function generateRelationRegistryArtifacts({\n    snapshot,\n    fingerprint,\n    modelTypeAccessors,\n}: GenerateRelationRegistryArtifactsInput): GeneratedRelationRegistryArtifacts {\n    const publicModels = snapshot.models.filter(\n        (model) => !ImplicitManyToManyIdentifier.isImplicitManyToManyModel(model.key)\n    );\n\n    for (const model of publicModels) {\n        for (const relation of model.relations) {\n            if (ImplicitManyToManyIdentifier.isImplicitManyToManyModel(relation.targetModelKey)) {\n                continue;\n            }\n            if (!relation.capabilities.hydratable) {\n                continue;\n            }\n            if (!modelTypeAccessors[relation.targetModelKey]) {\n                throw new Error(\n                    `Unable to generate relation typing for '${relation.targetModelKey}'. Ensure the models module exports that model directly or through a one-level object export.`\n                );\n            }\n        }\n    }\n\n    const declarationLines = [\n        '/**',\n        ' * Generated by `tango codegen relations`.',\n        ' * Do not edit this file directly.',\n        ' */',\n        'declare global {',\n        '    interface TangoGeneratedRelationRegistry {',\n        ...publicModels.map((model: ResolvedRelationGraphSnapshot['models'][number]) => {\n            const hydratableRelations = model.relations.filter(\n                (relation) =>\n                    relation.capabilities.hydratable &&\n                    !ImplicitManyToManyIdentifier.isImplicitManyToManyModel(relation.targetModelKey)\n            );\n            const relationLines =\n                hydratableRelations.length === 0\n                    ? ['            [key: string]: never;']\n                    : hydratableRelations.map(\n                          (relation: ResolvedRelationGraphSnapshot['models'][number]['relations'][number]) =>\n                              `            ${JSON.stringify(relation.name)}: { target: ${modelTypeAccessors[relation.targetModelKey]}; cardinality: ${JSON.stringify(relation.cardinality)}; kind: ${JSON.stringify(relation.kind)} };`\n                      );\n\n            return [`        ${JSON.stringify(model.key)}: {`, ...relationLines, '        };'].join('\\n');\n        }),\n        '    }',\n        '}',\n        'export type __TangoGeneratedRelationRegistryModule = TangoGeneratedRelationRegistry;',\n        '',\n    ];\n\n    return {\n        declaration: declarationLines.join('\\n'),\n        metadata: {\n            version: GENERATED_RELATION_REGISTRY_METADATA_VERSION,\n            fingerprint,\n            snapshot,\n        },\n    };\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport {\n    GENERATED_RELATION_REGISTRY_DIRNAME,\n    GENERATED_RELATION_REGISTRY_METADATA_FILENAME,\n    GENERATED_RELATION_REGISTRY_TYPES_FILENAME,\n    type ModelRegistry,\n} from '@danceroutine/tango-schema';\nimport { generateRelationRegistryArtifacts } from './generateRelationRegistryArtifacts';\n\nexport type WriteRelationRegistryArtifactsInput = {\n    registry: ModelRegistry;\n    modelTypeAccessors: Readonly<Record<string, string>>;\n    outputDir?: string;\n};\n\nexport type WrittenRelationRegistryArtifacts = {\n    outputDir: string;\n    typesFilepath: string;\n    metadataFilepath: string;\n    fingerprint: string;\n};\n\n/**\n * Write the generated relation typing declaration and metadata files to disk.\n */\nexport async function writeRelationRegistryArtifacts({\n    registry,\n    modelTypeAccessors,\n    outputDir = resolve(process.cwd(), GENERATED_RELATION_REGISTRY_DIRNAME),\n}: WriteRelationRegistryArtifactsInput): Promise<WrittenRelationRegistryArtifacts> {\n    const snapshot = registry.getResolvedRelationGraphSnapshot();\n    const fingerprint = registry.getResolvedRelationGraphFingerprint();\n    const artifacts = generateRelationRegistryArtifacts({\n        snapshot,\n        fingerprint,\n        modelTypeAccessors,\n    });\n\n    await mkdir(outputDir, { recursive: true });\n\n    const typesFilepath = resolve(outputDir, GENERATED_RELATION_REGISTRY_TYPES_FILENAME);\n    const metadataFilepath = resolve(outputDir, GENERATED_RELATION_REGISTRY_METADATA_FILENAME);\n\n    await writeFile(typesFilepath, artifacts.declaration, 'utf8');\n    await writeFile(metadataFilepath, `${JSON.stringify(artifacts.metadata, null, 2)}\\n`, 'utf8');\n\n    return {\n        outputDir,\n        typesFilepath,\n        metadataFilepath,\n        fingerprint,\n    };\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport {\n    generateRelationRegistryArtifacts,\n    type GenerateRelationRegistryArtifactsInput,\n    type GeneratedRelationRegistryArtifacts,\n} from './generateRelationRegistryArtifacts';\nexport {\n    writeRelationRegistryArtifacts,\n    type WriteRelationRegistryArtifactsInput,\n    type WrittenRelationRegistryArtifacts,\n} from './writeRelationRegistryArtifacts';\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,kCAAkC,EAC9C,UACA,aACA,sBAC2E;CAC3E,MAAM,eAAe,SAAS,OAAO,QAChC,UAAU,CAAC,6BAA6B,0BAA0B,MAAM,GAAG,CAChF;CAEA,KAAK,MAAM,SAAS,cAChB,KAAK,MAAM,YAAY,MAAM,WAAW;EACpC,IAAI,6BAA6B,0BAA0B,SAAS,cAAc,GAC9E;EAEJ,IAAI,CAAC,SAAS,aAAa,YACvB;EAEJ,IAAI,CAAC,mBAAmB,SAAS,iBAC7B,MAAM,IAAI,MACN,2CAA2C,SAAS,eAAe,8FACvE;CAER;CAgCJ,OAAO;EACH,aAAa;GA7Bb;GACA;GACA;GACA;GACA;GACA;GACA,GAAG,aAAa,KAAK,UAA2D;IAC5E,MAAM,sBAAsB,MAAM,UAAU,QACvC,aACG,SAAS,aAAa,cACtB,CAAC,6BAA6B,0BAA0B,SAAS,cAAc,CACvF;IACA,MAAM,gBACF,oBAAoB,WAAW,IACzB,CAAC,mCAAmC,IACpC,oBAAoB,KACf,aACG,eAAe,KAAK,UAAU,SAAS,IAAI,EAAE,cAAc,mBAAmB,SAAS,gBAAgB,iBAAiB,KAAK,UAAU,SAAS,WAAW,EAAE,UAAU,KAAK,UAAU,SAAS,IAAI,EAAE,IAC7M;IAEV,OAAO;KAAC,WAAW,KAAK,UAAU,MAAM,GAAG,EAAE;KAAM,GAAG;KAAe;IAAY,EAAE,KAAK,IAAI;GAChG,CAAC;GACD;GACA;GACA;GACA;EAI4B,EAAE,KAAK,IAAI;EACvC,UAAU;GACN,SAAS;GACT;GACA;EACJ;CACJ;AACJ;;;;;;AC1DA,eAAsB,+BAA+B,EACjD,UACA,oBACA,YAAY,QAAQ,QAAQ,IAAI,GAAG,mCAAmC,KACS;CAC/E,MAAM,WAAW,SAAS,iCAAiC;CAC3D,MAAM,cAAc,SAAS,oCAAoC;CACjE,MAAM,YAAY,kCAAkC;EAChD;EACA;EACA;CACJ,CAAC;CAED,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;CAE1C,MAAM,gBAAgB,QAAQ,WAAW,0CAA0C;CACnF,MAAM,mBAAmB,QAAQ,WAAW,6CAA6C;CAEzF,MAAM,UAAU,eAAe,UAAU,aAAa,MAAM;CAC5D,MAAM,UAAU,kBAAkB,GAAG,KAAK,UAAU,UAAU,UAAU,MAAM,CAAC,EAAE,KAAK,MAAM;CAE5F,OAAO;EACH;EACA;EACA;EACA;CACJ;AACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danceroutine/tango-codegen",
-  "version": "1.11.0",
+  "version": "1.11.2",
   "description": "CLI for generating repositories, types, migrations, and OpenAPI specs for Tango",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,17 +47,17 @@
   "dependencies": {
     "jiti": "^2.6.1",
     "yargs": "^18.0.0",
-    "@danceroutine/tango-core": "1.11.0",
-    "@danceroutine/tango-schema": "1.11.0"
+    "@danceroutine/tango-core": "1.11.2",
+    "@danceroutine/tango-schema": "1.11.2"
   },
   "devDependencies": {
     "@types/yargs": "^17.0.33",
     "@types/node": "^22.9.0",
-    "tsdown": "^0.4.0",
+    "tsdown": "^0.22.1",
     "typescript": "^5.6.3",
-    "vitest": "^4.0.6",
+    "vitest": "^4.1.7",
     "zod": "^4.0.0",
-    "@danceroutine/tango-testing": "1.11.0"
+    "@danceroutine/tango-testing": "1.11.2"
   },
   "scripts": {
     "build": "tsdown",

package/dist/chunk-BkvOhyD0.js

@@ -1,12 +0,0 @@
-
-//#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/commands/loadProjectModule.d.ts

@@ -1,15 +0,0 @@
-import { ModelRegistry } from '@danceroutine/tango-schema';
-type ProjectModuleLoadResult = {
-    loaded: Record<string, unknown>;
-    modelTypeAccessors: Record<string, string>;
-    registry: ModelRegistry;
-};
-/**
- * Load a Tango app module and discover model export accessors suitable for
- * generated ambient type references.
- */
-export declare function loadProjectModule(modulePath: string, options?: {
-    projectRoot?: string;
-    outputDir?: string;
-}): Promise<ProjectModuleLoadResult>;
-export {};

package/dist/commands/registerCodegenCommands.d.ts

@@ -1,5 +0,0 @@
-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/runGenerateRelationsCommand.d.ts

@@ -1,11 +0,0 @@
-import type { Argv } from 'yargs';
-type GenerateRelationsCommandArgs = {
-    models: string;
-    outDir: string;
-};
-/**
- * Generate the app-local ambient relation registry from a finalized model graph.
- */
-export declare function runGenerateRelationsCommand({ models, outDir }: GenerateRelationsCommandArgs): Promise<void>;
-export declare function withGenerateRelationsCommand(parser: Argv): Argv;
-export {};

package/dist/commands/runInitCommand.d.ts

@@ -1,13 +0,0 @@
-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

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

package/dist/commands/runNewCommand.d.ts

@@ -1,16 +0,0 @@
-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 {};