qubu 0.4.0 → 0.4.1

package/dist/{canonical-BbnqavJm.mjs → canonical-BXUguqfo.mjs}

@@ -93,7 +93,7 @@ function validateSnapshot(value, diagnostics) {
 			if (validated !== void 0) tables.push(validated);
 		}
 	}
-	if (dialect === void 0 || namingPolicy === void 0) return void 0;
+	if (dialect === void 0 || namingPolicy === void 0) return;
 	validateCrossReferences(tables, diagnostics);
 	return {
 		format: schemaSnapshotFormat,
@@ -113,7 +113,7 @@ function validateDialect(value, path, diagnostics) {
 	if (typeof value.name !== "string" || value.name.length === 0) diagnostics.push(diagnostic("invalid-snapshot", "Dialect name must be non-empty", [...path, "name"]));
 	if (typeof value.version !== "number" || !Number.isSafeInteger(value.version) || value.version < 1) diagnostics.push(diagnostic("invalid-snapshot", "Dialect version must be a positive integer", [...path, "version"]));
 	else if (value.version > 1) diagnostics.push(diagnostic("future-version", `Unsupported dialect extension version: ${value.version}`, [...path, "version"]));
-	if (typeof value.name !== "string" || typeof value.version !== "number") return void 0;
+	if (typeof value.name !== "string" || typeof value.version !== "number") return;
 	return {
 		name: value.name,
 		version: value.version
@@ -127,7 +127,7 @@ function validateNamingPolicy(value, path, diagnostics) {
 	requireKeys(value, ["name", "version"], path, diagnostics);
 	if (typeof value.name !== "string" || value.name.length === 0) diagnostics.push(diagnostic("invalid-snapshot", "Naming-policy name must be non-empty", [...path, "name"]));
 	if (value.version !== 1) diagnostics.push(diagnostic(typeof value.version === "number" && value.version > 1 ? "future-version" : "invalid-snapshot", `Unsupported naming-policy version: ${String(value.version)}`, [...path, "version"]));
-	if (typeof value.name !== "string" || typeof value.version !== "number") return void 0;
+	if (typeof value.name !== "string" || typeof value.version !== "number") return;
 	return {
 		name: value.name,
 		version: value.version
@@ -153,7 +153,7 @@ function validateTable(value, path, dialect, diagnostics) {
 	validateSortedIds(value.columns, [...path, "columns"], diagnostics);
 	validateSortedIds(value.constraints, [...path, "constraints"], diagnostics);
 	validateSortedIds(value.indexes, [...path, "indexes"], diagnostics);
-	if (id === void 0 || physicalName === void 0 || columns === void 0 || constraints === void 0 || indexes === void 0) return void 0;
+	if (id === void 0 || physicalName === void 0 || columns === void 0 || constraints === void 0 || indexes === void 0) return;
 	return {
 		id,
 		physicalName,
@@ -196,7 +196,7 @@ function validateColumn(value, path, dialect, diagnostics) {
 	const identity = value.identity === void 0 ? void 0 : validateIdentity(value.identity, [...path, "identity"], dialect, diagnostics);
 	const onUpdate = value.onUpdate === void 0 ? void 0 : validateExpression(value.onUpdate, [...path, "onUpdate"], "default", dialect, diagnostics);
 	if (onUpdate !== void 0 && dialect !== "mysql") diagnostics.push(diagnostic("dialect-mismatch", "Column onUpdate metadata is only valid for MySQL snapshots", [...path, "onUpdate"]));
-	if (id === void 0 || physicalName === void 0 || nullable === void 0 || hasDefault === void 0 || generated === void 0) return void 0;
+	if (id === void 0 || physicalName === void 0 || nullable === void 0 || hasDefault === void 0 || generated === void 0) return;
 	return {
 		id,
 		physicalName,
@@ -311,7 +311,7 @@ function validateIdentity(value, path, dialect, diagnostics) {
 	], path, diagnostics, ["dialect"]);
 	if (value.kind !== "identity") diagnostics.push(diagnostic("invalid-snapshot", "Identity kind must be identity", [...path, "kind"]));
 	if (value.generation !== "always" && value.generation !== "by-default") diagnostics.push(diagnostic("invalid-snapshot", "Identity generation is invalid", [...path, "generation"]));
-	if (value.kind !== "identity" || value.generation !== "always" && value.generation !== "by-default") return void 0;
+	if (value.kind !== "identity" || value.generation !== "always" && value.generation !== "by-default") return;
 	const extension = validateExtension(value.dialect, [...path, "dialect"], dialect, diagnostics);
 	return {
 		kind: "identity",
@@ -325,7 +325,7 @@ function validateConstraint(value, path, dialect, diagnostics) {
 		return;
 	}
 	const common = validateConstraintCommon(value, path, diagnostics);
-	if (common === void 0) return void 0;
+	if (common === void 0) return;
 	if (value.kind === "primary-key" || value.kind === "unique") {
 		requireKeys(value, [
 			"id",
@@ -343,7 +343,7 @@ function validateConstraint(value, path, dialect, diagnostics) {
 		const columns = validateColumnIds(value.columns, [...path, "columns"], diagnostics);
 		const extra = validateConstraintTiming(value, path, diagnostics);
 		const extension = validateExtension(value.dialect, [...path, "dialect"], dialect, diagnostics);
-		if (columns === void 0 || extra === void 0) return void 0;
+		if (columns === void 0 || extra === void 0) return;
 		return {
 			...common,
 			kind: value.kind,
@@ -371,7 +371,7 @@ function validateConstraint(value, path, dialect, diagnostics) {
 		const extra = validateConstraintTiming(value, path, diagnostics);
 		const extension = validateExtension(value.dialect, [...path, "dialect"], dialect, diagnostics);
 		if (value.nulls !== "distinct" && value.nulls !== "not-distinct") diagnostics.push(diagnostic("invalid-snapshot", "Unique-constraint null semantics are invalid", [...path, "nulls"]));
-		if (columns === void 0 || extra === void 0 || value.nulls !== "distinct" && value.nulls !== "not-distinct") return void 0;
+		if (columns === void 0 || extra === void 0 || value.nulls !== "distinct" && value.nulls !== "not-distinct") return;
 		return {
 			...common,
 			kind: "unique-constraint",
@@ -406,7 +406,7 @@ function validateConstraint(value, path, dialect, diagnostics) {
 		const target = validateForeignKeyTarget(value.target, [...path, "target"], diagnostics);
 		const extra = validateForeignKeyOptions(value, path, diagnostics);
 		const extension = validateExtension(value.dialect, [...path, "dialect"], dialect, diagnostics);
-		if (columns === void 0 || target === void 0 || extra === void 0) return void 0;
+		if (columns === void 0 || target === void 0 || extra === void 0) return;
 		return {
 			...common,
 			kind: "foreign-key",
@@ -433,7 +433,7 @@ function validateConstraint(value, path, dialect, diagnostics) {
 		const expression = validateExpression(value.expression, [...path, "expression"], "check", dialect, diagnostics);
 		const extra = validateConstraintTiming(value, path, diagnostics);
 		const extension = validateExtension(value.dialect, [...path, "dialect"], dialect, diagnostics);
-		if (expression === void 0 || extra === void 0) return void 0;
+		if (expression === void 0 || extra === void 0) return;
 		return {
 			...common,
 			kind: "check",
@@ -447,7 +447,7 @@ function validateConstraint(value, path, dialect, diagnostics) {
 function validateConstraintCommon(value, path, diagnostics) {
 	const id = validateId(value.id, [...path, "id"], diagnostics);
 	const physicalName = validateName(value.physicalName, [...path, "physicalName"], diagnostics);
-	if (id === void 0 || physicalName === void 0) return void 0;
+	if (id === void 0 || physicalName === void 0) return;
 	return {
 		id,
 		kind: value.kind,
@@ -458,8 +458,8 @@ function validateConstraintTiming(value, path, diagnostics) {
 	const deferrable = validateOptionalBoolean(value.deferrable, [...path, "deferrable"], diagnostics);
 	const initially = value.initially === void 0 ? void 0 : value.initially === "immediate" || value.initially === "deferred" ? value.initially : void 0;
 	if (value.initially !== void 0 && initially === void 0) diagnostics.push(diagnostic("invalid-snapshot", "Constraint timing is invalid", [...path, "initially"]));
-	if (deferrable === void 0 && value.deferrable !== void 0) return void 0;
-	if (value.initially !== void 0 && initially === void 0) return void 0;
+	if (deferrable === void 0 && value.deferrable !== void 0) return;
+	if (value.initially !== void 0 && initially === void 0) return;
 	return {
 		...deferrable === void 0 ? {} : { deferrable },
 		...initially === void 0 ? {} : { initially }
@@ -468,7 +468,7 @@ function validateConstraintTiming(value, path, diagnostics) {
 function validateForeignKeyOptions(value, path, diagnostics) {
 	const action = (key) => {
 		const candidate = value[key];
-		if (candidate === void 0) return void 0;
+		if (candidate === void 0) return;
 		if (candidate === "no-action" || candidate === "restrict" || candidate === "cascade" || candidate === "set-null" || candidate === "set-default") return candidate;
 		diagnostics.push(diagnostic("invalid-snapshot", `Foreign-key ${key} action is invalid`, [...path, key]));
 	};
@@ -477,7 +477,7 @@ function validateForeignKeyOptions(value, path, diagnostics) {
 	const match = value.match === void 0 ? void 0 : value.match === "simple" || value.match === "full" || value.match === "partial" ? value.match : void 0;
 	if (value.match !== void 0 && match === void 0) diagnostics.push(diagnostic("invalid-snapshot", "Foreign-key match mode is invalid", [...path, "match"]));
 	const timing = validateConstraintTiming(value, path, diagnostics);
-	if (timing === void 0 || value.onUpdate !== void 0 && onUpdate === void 0 || value.onDelete !== void 0 && onDelete === void 0 || value.match !== void 0 && match === void 0) return void 0;
+	if (timing === void 0 || value.onUpdate !== void 0 && onUpdate === void 0 || value.onDelete !== void 0 && onDelete === void 0 || value.match !== void 0 && match === void 0) return;
 	return {
 		...onUpdate === void 0 ? {} : { onUpdate },
 		...onDelete === void 0 ? {} : { onDelete },
@@ -527,7 +527,7 @@ function validateIndex(value, path, dialect, diagnostics) {
 	const predicate = value.predicate === void 0 ? void 0 : validateExpression(value.predicate, [...path, "predicate"], "index", dialect, diagnostics);
 	const includedColumns = value.includedColumns === void 0 ? void 0 : validateColumnIds(value.includedColumns, [...path, "includedColumns"], diagnostics);
 	const extension = validateExtension(value.dialect, [...path, "dialect"], dialect, diagnostics);
-	if (id === void 0 || physicalName === void 0 || unique === void 0 || candidateKey === void 0 || terms === void 0 || value.kind !== "index" || terms.length === 0) return void 0;
+	if (id === void 0 || physicalName === void 0 || unique === void 0 || candidateKey === void 0 || terms === void 0 || value.kind !== "index" || terms.length === 0) return;
 	return {
 		id,
 		kind: "index",
@@ -573,7 +573,7 @@ function validateIndexTerm(value, path, dialect, diagnostics) {
 		const nulls = value.nulls === void 0 ? void 0 : value.nulls === "FIRST" || value.nulls === "LAST" ? value.nulls : void 0;
 		if (value.direction !== void 0 && direction === void 0) diagnostics.push(diagnostic("invalid-snapshot", "Index order direction is invalid", [...path, "direction"]));
 		if (value.nulls !== void 0 && nulls === void 0) diagnostics.push(diagnostic("invalid-snapshot", "Index NULL ordering is invalid", [...path, "nulls"]));
-		if (expression === void 0 || value.direction !== void 0 && direction === void 0 || value.nulls !== void 0 && nulls === void 0) return void 0;
+		if (expression === void 0 || value.direction !== void 0 && direction === void 0 || value.nulls !== void 0 && nulls === void 0) return;
 		return {
 			kind: "order",
 			expression,
@@ -626,7 +626,7 @@ function validateExpression(value, path, _mode, dialect, diagnostics) {
 	if (expressionDialect !== void 0 && value.expressionKind !== "unsafe") diagnostics.push(diagnostic("invalid-snapshot", "Only unsafe expressions may carry a dialect tag", [...path, "dialect"]));
 	if (expressionDialect === void 0 && value.expressionKind === "unsafe") diagnostics.push(diagnostic("invalid-snapshot", "Unsafe expressions must carry a dialect tag", [...path, "dialect"]));
 	if (sql !== void 0 && sql !== sql.replace(/\r\n?/g, "\n")) diagnostics.push(diagnostic("non-canonical", "Expression SQL must use LF line endings", [...path, "sql"]));
-	if (expressionKind === void 0 || sql === void 0 || value.kind !== "expression") return void 0;
+	if (expressionKind === void 0 || sql === void 0 || value.kind !== "expression") return;
 	return {
 		kind: "expression",
 		expressionKind,
@@ -670,7 +670,7 @@ function validateLiteral(value, path, diagnostics) {
 	diagnostics.push(diagnostic("invalid-snapshot", "Literal kind is invalid", [...path, "kind"]));
 }
 function validateExtension(value, path, dialect, diagnostics) {
-	if (value === void 0) return void 0;
+	if (value === void 0) return;
 	if (!isRecord(value)) {
 		diagnostics.push(diagnostic("invalid-snapshot", "Dialect extension must be an object", path));
 		return;
@@ -686,7 +686,7 @@ function validateExtension(value, path, dialect, diagnostics) {
 	else if (version > 1) diagnostics.push(diagnostic("future-version", `Unsupported dialect extension version: ${version}`, [...path, "version"]));
 	if (extensionDialect !== void 0 && dialect !== void 0 && extensionDialect !== dialect) diagnostics.push(diagnostic("dialect-mismatch", `Dialect extension belongs to "${extensionDialect}" but snapshot dialect is "${dialect}"`, [...path, "dialect"]));
 	const data = validateJsonValue(value.data, [...path, "data"], diagnostics);
-	if (extensionDialect === void 0 || typeof version !== "number" || data === void 0) return void 0;
+	if (extensionDialect === void 0 || typeof version !== "number" || data === void 0) return;
 	return {
 		dialect: extensionDialect,
 		version,
@@ -943,8 +943,8 @@ function encodeCanonicalSnapshot(snapshot) {
 	return canonicalJson(snapshot);
 }
 /**
-* Compute a small deterministic content digest for cache keys and diagnostics.
-* It is deliberately not an entity identity, signature, or migration lineage.
+* Compute a small deterministic content digest for cache keys and diagnostics. It is deliberately
+* not an entity identity, signature, or migration lineage.
 */
 function schemaSnapshotDigest(snapshot) {
 	const source = encodeCanonicalSnapshot(assertSchemaSnapshot(snapshot));

package/dist/codegen.d.mts

@@ -1,12 +1,12 @@
-import { St as IntrospectionDiagnostic, dt as IntrospectionResult, i as CatalogClassificationConfidence, p as CatalogDialect, z as CatalogPortableStorageType } from "./types-CSNJTYaM.mjs";
+import { St as IntrospectionDiagnostic, dt as IntrospectionResult, i as CatalogClassificationConfidence, p as CatalogDialect, z as CatalogPortableStorageType } from "./types-JSZHpUEj.mjs";
 //#region src/codegen/types.d.ts
 /** TypeScript value types that the controlled source printer can emit. */
-type CodegenApplicationType = 'unknown' | 'string' | 'number' | 'boolean' | 'bigint' | 'Date' | 'Uint8Array';
+type CodegenApplicationType = "unknown" | "string" | "number" | "boolean" | "bigint" | "Date" | "Uint8Array";
 /** Qubu SQL semantic domains that generated columns can carry. */
-type CodegenSqlDomain = 'unknown' | 'integer' | 'decimal' | 'text' | 'boolean' | 'date' | 'timestamp' | 'uuid' | 'json' | 'bigint' | 'binary';
+type CodegenSqlDomain = "unknown" | "integer" | "decimal" | "text" | "boolean" | "date" | "timestamp" | "uuid" | "json" | "bigint" | "binary";
 /** One logical-name decision exposed to a generator naming callback. */
 interface CodegenNameContext {
-  readonly kind: 'schema' | 'table' | 'column' | 'constraint' | 'index';
+  readonly kind: "schema" | "table" | "column" | "constraint" | "index";
   readonly physicalName: string;
   readonly suggestedName: string;
   readonly tablePhysicalName?: string;
@@ -39,21 +39,20 @@ interface CodegenColumnMapping {
 /** Controlled customization points for generated logical names and types. */
 interface SchemaCodegenOptions {
   /**
-   * Override one suggested camelCase name. The returned value must still be a
-   * safe camelCase logical ID, and table and schema names must be valid export
-   * bindings.
+   * Override one suggested camelCase name. The returned value must still be a safe camelCase
+   * logical ID, and table and schema names must be valid export bindings.
    */
   readonly naming?: (context: CodegenNameContext) => string | undefined;
   /**
-   * Override trusted application types or a Qubu SQL domain for one column.
-   * The callback selects from fixed tokens and cannot inject source text.
+   * Override trusted application types or a Qubu SQL domain for one column. The callback selects
+   * from fixed tokens and cannot inject source text.
    */
   readonly mapColumn?: (context: CodegenColumnContext) => CodegenColumnMapping | undefined;
 }
 /** Stable generator findings added beside retained introspection diagnostics. */
-type CodegenDiagnosticCode = IntrospectionDiagnostic['code'] | 'invalid-input' | 'lossy-input' | 'unsupported-snapshot' | 'omitted-fact' | 'unsafe-name' | 'name-collision' | 'invalid-option' | 'unrepresentable-fact' | 'excluded-object-family' | 'unsafe-source';
+type CodegenDiagnosticCode = IntrospectionDiagnostic["code"] | "invalid-input" | "lossy-input" | "unsupported-snapshot" | "omitted-fact" | "unsafe-name" | "name-collision" | "invalid-option" | "unrepresentable-fact" | "excluded-object-family" | "unsafe-source";
 /** A path-addressed finding returned by schema source generation. */
-interface CodegenDiagnostic extends Omit<IntrospectionDiagnostic, 'code'> {
+interface CodegenDiagnostic extends Omit<IntrospectionDiagnostic, "code"> {
   readonly code: CodegenDiagnosticCode;
   readonly relatedPaths?: readonly (readonly (string | number)[])[];
 }
@@ -77,28 +76,21 @@ type SchemaCodegenResult = SchemaCodegenSuccess | SchemaCodegenFailure;
  * Generate a deterministic TypeScript module from one introspection result.
  *
  * @remarks
- * Generation accepts only a successful, non-lossy Snapshot v1 result for one
- * PostgreSQL, SQLite, or MySQL namespace. It is pure: it opens no connection,
- * performs no filesystem writes, and never evaluates catalog SQL. Existing
- * introspection diagnostics are copied into the result. Any error returns no
- * source.
- *
- * The generated module exports every ordinary table plus one schema registry.
- * Physical names and native declarations remain escaped string literals.
- * Catalog expressions use dialect-tagged schema data, checks use
- * `catalogCheck()`, and foreign keys use lazy `catalogForeignKey()` targets.
- * Foreign keys must have equal local and target arity and target an exact
- * primary key, strict unique key, or candidate index. Nullable database UNIQUE
- * constraints do not provide that candidate-key proof and fail generation.
- *
- * Application output, insert, and update types default independently to
- * `unknown`. The generator may attach a conservative SQL semantic domain, and
- * {@link SchemaCodegenOptions.mapColumn} can override either type axis with a
- * fixed token. Naming callbacks can replace suggested camelCase IDs, but they
- * cannot supply source syntax.
- *
- * @param input A completed introspection operation. Failed and lossy results
- * are reported as diagnostics rather than thrown errors.
+ *   Generation accepts only a successful, non-lossy Snapshot v1 result for one PostgreSQL, SQLite,
+ *   or MySQL namespace. It is pure: it opens no connection, performs no filesystem writes, and
+ *   never evaluates catalog SQL. Existing introspection diagnostics are copied into the result. Any
+ *   error returns no source. The generated module exports every ordinary table plus one schema
+ *   registry. Physical names and native declarations remain escaped string literals. Catalog
+ *   expressions use dialect-tagged schema data, checks use `catalogCheck()`, and foreign keys use
+ *   lazy `catalogForeignKey()` targets. Foreign keys must have equal local and target arity and
+ *   target an exact primary key, strict unique key, or candidate index. Nullable database UNIQUE
+ *   constraints do not provide that candidate-key proof and fail generation. Application output,
+ *   insert, and update types default independently to `unknown`. The generator may attach a
+ *   conservative SQL semantic domain, and {@link SchemaCodegenOptions.mapColumn} can override either
+ *   type axis with a fixed token. Naming callbacks can replace suggested camelCase IDs, but they
+ *   cannot supply source syntax.
+ * @param input A completed introspection operation. Failed and lossy results are reported as
+ *   diagnostics rather than thrown errors.
  * @param options Controlled logical-name and column-type mappings.
  * @returns Generated source and diagnostics, or diagnostics without source.
  */

package/dist/codegen.mjs

@@ -1,5 +1,5 @@
-import { l as decodeSchemaSnapshot } from "./canonical-BbnqavJm.mjs";
-import { t as mapCatalogToSnapshot } from "./snapshot-DJpfmxhQ.mjs";
+import { l as decodeSchemaSnapshot } from "./canonical-BXUguqfo.mjs";
+import { t as mapCatalogToSnapshot } from "./snapshot-C-W65HEd.mjs";
 //#region src/codegen/source.ts
 const header = `/* Generated by Qubu. Do not edit this machine-owned file. */
 import * as _qubu from 'qubu'
@@ -40,7 +40,7 @@ const catalogPredicateHelper = `const _catalogPredicate = <
 `;
 function printSchemaSource(schema, diagnostics) {
 	const tables = schema.tables.map((table) => printTable(schema, table, diagnostics));
-	if (tables.some((table) => table === void 0)) return void 0;
+	if (tables.some((table) => table === void 0)) return;
 	const registry = schema.tables.map((table) => `    ${literal(table.name)}: ${table.name},`).join("\n");
 	const predicateHelper = schema.tables.some((table) => table.indexes.some((index) => index.snapshot.predicate !== void 0)) ? `\n${catalogPredicateHelper}` : "";
 	const columnHelper = schema.tables.some((table) => table.columns.length > 0) ? `\n${catalogColumnHelper}` : "";
@@ -110,7 +110,7 @@ function printConstraintType(table, constraint, columnsName, diagnostics) {
 	];
 	if (snapshot.kind === "check") return `readonly ${literal(constraint.name)}: _qubu.CheckConstraint`;
 	const columns = printColumnTypeTuple(table, snapshot.columns, columnsName, path, diagnostics);
-	if (columns === void 0) return void 0;
+	if (columns === void 0) return;
 	if (snapshot.kind === "foreign-key") return `readonly ${literal(constraint.name)}: _qubu.ForeignKeyConstraint<${columns}>`;
 	if (snapshot.kind === "unique-constraint") return `readonly ${literal(constraint.name)}: _qubu.UniqueConstraint<
   ${columns},
@@ -134,7 +134,7 @@ function printIndexType(table, index, columnsName, diagnostics) {
 		"terms",
 		position
 	], diagnostics));
-	if (terms.some((term) => term === void 0)) return void 0;
+	if (terms.some((term) => term === void 0)) return;
 	const properties = [
 		`readonly terms: readonly [${terms.join(", ")}]`,
 		`readonly unique: ${index.snapshot.unique ? "true" : "false"}`,
@@ -143,7 +143,7 @@ function printIndexType(table, index, columnsName, diagnostics) {
 	];
 	if (index.snapshot.includedColumns !== void 0) {
 		const included = printColumnTypeTuple(table, index.snapshot.includedColumns, columnsName, [...path, "includedColumns"], diagnostics);
-		if (included === void 0) return void 0;
+		if (included === void 0) return;
 		properties.push(`readonly includedColumns?: ${included}`);
 	} else properties.push("readonly includedColumns?: undefined");
 	return `readonly ${literal(index.name)}: {
@@ -199,7 +199,7 @@ function printColumn(schema, table, column, diagnostics) {
 		if (snapshot.default.kind === "external") options.push("default: _qubu.externalDefault()");
 		else if (snapshot.default.kind === "literal") {
 			const value = printSnapshotLiteral(snapshot.default.value, path, diagnostics);
-			if (value === void 0) return void 0;
+			if (value === void 0) return;
 			options.push(`default: ${value}`);
 		} else {
 			const value = printExpression(snapshot.default.expression, schema, [
@@ -207,7 +207,7 @@ function printColumn(schema, table, column, diagnostics) {
 				"default",
 				"expression"
 			], diagnostics);
-			if (value === void 0) return void 0;
+			if (value === void 0) return;
 			options.push(`default: ${value}`);
 		}
 	}
@@ -219,7 +219,7 @@ function printColumn(schema, table, column, diagnostics) {
 				"generatedColumn",
 				"expression"
 			], diagnostics);
-			if (expression === void 0) return void 0;
+			if (expression === void 0) return;
 			options.push(`generatedColumn: _qubu.generatedColumn(${expression}, ${literal(snapshot.generatedColumn.mode)})`);
 		}
 	}
@@ -234,7 +234,7 @@ function printColumn(schema, table, column, diagnostics) {
 	}
 	if (snapshot.onUpdate !== void 0) {
 		const expression = printExpression(snapshot.onUpdate, schema, [...path, "onUpdate"], diagnostics);
-		if (expression === void 0) return void 0;
+		if (expression === void 0) return;
 		options.push(`onUpdate: ${expression}`);
 	}
 	const types = [
@@ -262,11 +262,11 @@ function printConstraint(schema, table, constraint, diagnostics) {
 		snapshot.id
 	];
 	const options = printConstraintOptions(snapshot, schema, path, diagnostics);
-	if (options === void 0) return void 0;
+	if (options === void 0) return;
 	let expression;
 	if (snapshot.kind === "check") {
 		const sql = catalogExpressionData(snapshot.expression, schema, [...path, "expression"], diagnostics);
-		if (sql === void 0) return void 0;
+		if (sql === void 0) return;
 		expression = `_qubu.catalogCheck(${sql}, ${options})`;
 	} else if (snapshot.kind === "foreign-key") {
 		const local = printColumns(table, snapshot.columns, path, diagnostics);
@@ -280,7 +280,7 @@ function printConstraint(schema, table, constraint, diagnostics) {
 			return;
 		}
 		const target = printColumns(targetTable, snapshot.target.columns, [...path, "target"], diagnostics, targetTable.name);
-		if (local === void 0 || target === void 0) return void 0;
+		if (local === void 0 || target === void 0) return;
 		expression = `_qubu.catalogForeignKey(
   [${local.join(", ")}],
   () => _qubu.references(${targetTable.name}, ${target.join(", ")}),
@@ -288,7 +288,7 @@ function printConstraint(schema, table, constraint, diagnostics) {
 )`;
 	} else {
 		const columns = printColumns(table, snapshot.columns, path, diagnostics);
-		if (columns === void 0) return void 0;
+		if (columns === void 0) return;
 		expression = `_qubu.${snapshot.kind === "primary-key" ? "primaryKey" : snapshot.kind === "unique" ? "unique" : "uniqueConstraint"}(${columns.join(", ")}, ${options})`;
 	}
 	return `${literal(constraint.name)}: ${expression},`;
@@ -305,7 +305,7 @@ function printConstraintOptions(constraint, schema, path, diagnostics) {
 	if (constraint.initially !== void 0) properties.push(`initially: ${literal(constraint.initially)}`);
 	if (constraint.dialect !== void 0) {
 		const extension = printExtension(constraint.dialect, schema, [...path, "dialect"], diagnostics);
-		if (extension === void 0) return void 0;
+		if (extension === void 0) return;
 		properties.push(`dialect: ${extension}`);
 	}
 	return `{ ${properties.join(", ")} }`;
@@ -323,21 +323,21 @@ function printIndex(schema, table, index, diagnostics) {
 		"terms",
 		termIndex
 	], diagnostics));
-	if (terms.some((term) => term === void 0)) return void 0;
+	if (terms.some((term) => term === void 0)) return;
 	const options = [`physicalName: ${literal(index.snapshot.physicalName)}`, `unique: ${index.snapshot.unique ? "true" : "false"}`];
 	if (index.snapshot.predicate !== void 0) {
 		const predicate = catalogExpressionData(index.snapshot.predicate, schema, [...path, "predicate"], diagnostics);
-		if (predicate === void 0) return void 0;
+		if (predicate === void 0) return;
 		options.push(`where: _catalogPredicate(${predicate})`);
 	}
 	if (index.snapshot.includedColumns !== void 0) {
 		const included = printColumns(table, index.snapshot.includedColumns, [...path, "includedColumns"], diagnostics);
-		if (included === void 0) return void 0;
+		if (included === void 0) return;
 		options.push(`include: [${included.join(", ")}]`);
 	}
 	if (index.snapshot.dialect !== void 0) {
 		const extension = printExtension(index.snapshot.dialect, schema, [...path, "dialect"], diagnostics);
-		if (extension === void 0) return void 0;
+		if (extension === void 0) return;
 		options.push(`dialect: ${extension}`);
 	}
 	return `${literal(index.name)}: _qubu.index(
@@ -348,7 +348,7 @@ function printIndex(schema, table, index, diagnostics) {
 function printIndexTerm(schema, table, term, path, diagnostics) {
 	if (term.kind !== "order") return printIndexTermExpression(schema, table, term, path, diagnostics);
 	const expression = printIndexTermExpression(schema, table, term.expression, [...path, "expression"], diagnostics);
-	if (expression === void 0) return void 0;
+	if (expression === void 0) return;
 	return `_qubu.order(${expression}, ${term.direction === void 0 ? "undefined" : literal(term.direction)}, ${term.nulls === void 0 ? "undefined" : literal(term.nulls)})`;
 }
 function printIndexTermExpression(schema, table, expression, path, diagnostics) {
@@ -567,28 +567,21 @@ const excludedFamilies = [
 * Generate a deterministic TypeScript module from one introspection result.
 *
 * @remarks
-* Generation accepts only a successful, non-lossy Snapshot v1 result for one
-* PostgreSQL, SQLite, or MySQL namespace. It is pure: it opens no connection,
-* performs no filesystem writes, and never evaluates catalog SQL. Existing
-* introspection diagnostics are copied into the result. Any error returns no
-* source.
-*
-* The generated module exports every ordinary table plus one schema registry.
-* Physical names and native declarations remain escaped string literals.
-* Catalog expressions use dialect-tagged schema data, checks use
-* `catalogCheck()`, and foreign keys use lazy `catalogForeignKey()` targets.
-* Foreign keys must have equal local and target arity and target an exact
-* primary key, strict unique key, or candidate index. Nullable database UNIQUE
-* constraints do not provide that candidate-key proof and fail generation.
-*
-* Application output, insert, and update types default independently to
-* `unknown`. The generator may attach a conservative SQL semantic domain, and
-* {@link SchemaCodegenOptions.mapColumn} can override either type axis with a
-* fixed token. Naming callbacks can replace suggested camelCase IDs, but they
-* cannot supply source syntax.
-*
-* @param input A completed introspection operation. Failed and lossy results
-* are reported as diagnostics rather than thrown errors.
+*   Generation accepts only a successful, non-lossy Snapshot v1 result for one PostgreSQL, SQLite,
+*   or MySQL namespace. It is pure: it opens no connection, performs no filesystem writes, and
+*   never evaluates catalog SQL. Existing introspection diagnostics are copied into the result. Any
+*   error returns no source. The generated module exports every ordinary table plus one schema
+*   registry. Physical names and native declarations remain escaped string literals. Catalog
+*   expressions use dialect-tagged schema data, checks use `catalogCheck()`, and foreign keys use
+*   lazy `catalogForeignKey()` targets. Foreign keys must have equal local and target arity and
+*   target an exact primary key, strict unique key, or candidate index. Nullable database UNIQUE
+*   constraints do not provide that candidate-key proof and fail generation. Application output,
+*   insert, and update types default independently to `unknown`. The generator may attach a
+*   conservative SQL semantic domain, and {@link SchemaCodegenOptions.mapColumn} can override either
+*   type axis with a fixed token. Naming callbacks can replace suggested camelCase IDs, but they
+*   cannot supply source syntax.
+* @param input A completed introspection operation. Failed and lossy results are reported as
+*   diagnostics rather than thrown errors.
 * @param options Controlled logical-name and column-type mappings.
 * @returns Generated source and diagnostics, or diagnostics without source.
 */
@@ -730,7 +723,7 @@ function candidateIndexColumns(index) {
 	const columns = [];
 	for (const term of index.terms) {
 		const expression = term.kind === "order" ? term.expression : term;
-		if (expression.kind !== "column") return void 0;
+		if (expression.kind !== "column") return;
 		columns.push(expression.column);
 	}
 	return columns.length > 0 ? columns : void 0;
@@ -777,7 +770,7 @@ function resolveSchema(catalog, snapshot, options, diagnostics) {
 		const tableCollision = tableNames.get(schemaName);
 		if (tableCollision !== void 0) diagnostics.push(errorDiagnostic("name-collision", `Schema export and table export both resolve to "${schemaName}"`, ["schema"], void 0, [tableCollision]));
 	}
-	if (schemaName === void 0 || hasErrors(diagnostics)) return void 0;
+	if (schemaName === void 0 || hasErrors(diagnostics)) return;
 	const orderedTables = tables.sort(compareName);
 	return {
 		name: schemaName,
@@ -858,7 +851,7 @@ function resolveTable(snapshot, catalogTable, tableName, catalog, options, diagn
 	}
 	const constraints = resolveObjects(snapshot.constraints, "constraint", snapshot, tableName, options, diagnostics);
 	const indexes = resolveObjects(snapshot.indexes, "index", snapshot, tableName, options, diagnostics);
-	if (hasErrors(diagnostics)) return void 0;
+	if (hasErrors(diagnostics)) return;
 	const orderedColumns = columns.sort(compareName);
 	return {
 		name: tableName,