@atscript/db 0.1.38 → 0.1.40

package/dist/plugin.cjs

@@ -1,12 +1,12 @@
-"use strict";
-Object.defineProperty(exports, '__esModule', { value: true });
-const require_chunk = require('./chunk-CrpGerW8.cjs');
-const require_validation_utils = require('./validation-utils-DEoCMmEb.cjs');
-const __atscript_core = require_chunk.__toESM(require("@atscript/core"));
-
-//#region packages/db/src/plugin/annotations/agg.ts
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_validation_utils = require("./validation-utils-DVJDijnB.cjs");
+let _atscript_core = require("@atscript/core");
+//#region src/plugin/annotations/agg.ts
 const dbAggAnnotations = { agg: {
-	sum: new __atscript_core.AnnotationSpec({
+	sum: new _atscript_core.AnnotationSpec({
 		description: "Declares a view field as SUM of a source column.",
 		nodeType: ["prop"],
 		argument: {
@@ -18,7 +18,7 @@ const dbAggAnnotations = { agg: {
 			return require_validation_utils.validateFieldBaseType(token, doc, "@db.agg.sum", ["number", "decimal"]);
 		}
 	}),
-	avg: new __atscript_core.AnnotationSpec({
+	avg: new _atscript_core.AnnotationSpec({
 		description: "Declares a view field as AVG of a source column.",
 		nodeType: ["prop"],
 		argument: {
@@ -30,7 +30,7 @@ const dbAggAnnotations = { agg: {
 			return require_validation_utils.validateFieldBaseType(token, doc, "@db.agg.avg", ["number", "decimal"]);
 		}
 	}),
-	count: new __atscript_core.AnnotationSpec({
+	count: new _atscript_core.AnnotationSpec({
 		description: "Declares a view field as COUNT. Without argument: COUNT(*). With field name argument: COUNT(field) (non-null count).",
 		nodeType: ["prop"],
 		argument: {
@@ -43,7 +43,7 @@ const dbAggAnnotations = { agg: {
 			return require_validation_utils.validateFieldBaseType(token, doc, "@db.agg.count", ["number"]);
 		}
 	}),
-	min: new __atscript_core.AnnotationSpec({
+	min: new _atscript_core.AnnotationSpec({
 		description: "Declares a view field as MIN of a source column.",
 		nodeType: ["prop"],
 		argument: {
@@ -52,7 +52,7 @@ const dbAggAnnotations = { agg: {
 			description: "Source column name."
 		}
 	}),
-	max: new __atscript_core.AnnotationSpec({
+	max: new _atscript_core.AnnotationSpec({
 		description: "Declares a view field as MAX of a source column.",
 		nodeType: ["prop"],
 		argument: {
@@ -62,11 +62,10 @@ const dbAggAnnotations = { agg: {
 		}
 	})
 } };
-
 //#endregion
-//#region packages/db/src/plugin/annotations/column.ts
+//#region src/plugin/annotations/column.ts
 const dbColumnAnnotations = {
-	patch: { strategy: new __atscript_core.AnnotationSpec({
+	patch: { strategy: new _atscript_core.AnnotationSpec({
 		description: "Defines the **patching strategy** for updating nested objects.\n\n- **\"replace\"** → The field or object will be **fully replaced**.\n- **\"merge\"** → The field or object will be **merged recursively** (applies only to objects, not arrays).\n\n**Example:**\n```atscript\n@db.patch.strategy \"merge\"\nsettings: {\n  notifications: boolean\n  preferences: {\n    theme: string\n  }\n}\n```\n",
 		nodeType: ["prop"],
 		multiple: false,
@@ -82,10 +81,10 @@ const dbColumnAnnotations = {
 			const definition = field.getDefinition();
 			if (!definition) return errors;
 			let wrongType = false;
-			if ((0, __atscript_core.isRef)(definition)) {
+			if ((0, _atscript_core.isRef)(definition)) {
 				const def = doc.unwindType(definition.id, definition.chain)?.def;
-				if (!(0, __atscript_core.isStructure)(def) && !(0, __atscript_core.isInterface)(def) && !(0, __atscript_core.isArray)(def)) wrongType = true;
-			} else if (!(0, __atscript_core.isStructure)(definition) && !(0, __atscript_core.isInterface)(definition) && !(0, __atscript_core.isArray)(definition)) wrongType = true;
+				if (!(0, _atscript_core.isStructure)(def) && !(0, _atscript_core.isInterface)(def) && !(0, _atscript_core.isArray)(def)) wrongType = true;
+			} else if (!(0, _atscript_core.isStructure)(definition) && !(0, _atscript_core.isInterface)(definition) && !(0, _atscript_core.isArray)(definition)) wrongType = true;
 			if (wrongType) errors.push({
 				message: `@db.patch.strategy requires a field of type object or array`,
 				severity: 1,
@@ -95,7 +94,7 @@ const dbColumnAnnotations = {
 		}
 	}) },
 	column: {
-		$self: new __atscript_core.AnnotationSpec({
+		$self: new _atscript_core.AnnotationSpec({
 			description: "Overrides the physical column name in the database. For nested (flattened) fields, the parent prefix is still prepended automatically.\n\n**Example:**\n```atscript\n@db.column \"first_name\"\nfirstName: string\n// → physical column: first_name\n\n// Nested:\naddress: {\n  @db.column \"zip_code\"\n  zip: string\n}\n// → physical column: address__zip_code\n```\n",
 			nodeType: ["prop"],
 			argument: {
@@ -104,7 +103,7 @@ const dbColumnAnnotations = {
 				description: "The column/field name (without parent prefix for nested fields)."
 			}
 		}),
-		renamed: new __atscript_core.AnnotationSpec({
+		renamed: new _atscript_core.AnnotationSpec({
 			description: "Specifies the previous local field name for column rename migration. The sync engine generates ALTER TABLE RENAME COLUMN instead of drop+add.\n\n**Example:**\n```atscript\n@db.column.renamed \"zip\"\npostalCode: string\n// Renames address__zip → address__postalCode\n```\n",
 			nodeType: ["prop"],
 			argument: {
@@ -113,7 +112,7 @@ const dbColumnAnnotations = {
 				description: "The old local field name (parent prefix is reconstructed automatically)."
 			}
 		}),
-		collate: new __atscript_core.AnnotationSpec({
+		collate: new _atscript_core.AnnotationSpec({
 			description: "Portable collation for string comparison and sorting. Adapters map the generic value to their native collation.\n\n- **\"binary\"** — exact byte comparison (case-sensitive)\n- **\"nocase\"** — case-insensitive comparison\n- **\"unicode\"** — full Unicode-aware sorting\n\nFor adapter-specific collations, use `@db.<engine>.collate` instead.\n\n**Example:**\n```atscript\n@db.column.collate \"nocase\"\nusername: string\n```\n",
 			nodeType: ["prop"],
 			argument: {
@@ -130,7 +129,7 @@ const dbColumnAnnotations = {
 				return require_validation_utils.validateFieldBaseType(token, doc, "@db.column.collate", "string");
 			}
 		}),
-		precision: new __atscript_core.AnnotationSpec({
+		precision: new _atscript_core.AnnotationSpec({
 			description: "Sets decimal precision and scale for database storage. Adapters map this to their native decimal type (e.g., `DECIMAL(10,2)` in SQL, ignored in MongoDB).\n\nFor `decimal` fields the runtime value is a string; for `number` fields this is a DB storage hint only.\n\n**Example:**\n```atscript\n@db.column.precision 10, 2\nprice: decimal\n```\n",
 			nodeType: ["prop"],
 			argument: [{
@@ -146,11 +145,11 @@ const dbColumnAnnotations = {
 				return require_validation_utils.validateFieldBaseType(token, doc, "@db.column.precision", ["number", "decimal"]);
 			}
 		}),
-		dimension: new __atscript_core.AnnotationSpec({
+		dimension: new _atscript_core.AnnotationSpec({
 			description: "Marks a field as a dimension — groupable in aggregate queries ($groupBy). Dimension fields automatically receive a database index during schema sync.",
 			nodeType: ["prop"]
 		}),
-		measure: new __atscript_core.AnnotationSpec({
+		measure: new _atscript_core.AnnotationSpec({
 			description: "Marks a field as a measure — aggregatable in aggregate queries (sum, avg, count, min, max). Only valid on numeric or decimal fields.",
 			nodeType: ["prop"],
 			validate(token, _args, doc) {
@@ -159,7 +158,7 @@ const dbColumnAnnotations = {
 		})
 	},
 	default: {
-		$self: new __atscript_core.AnnotationSpec({
+		$self: new _atscript_core.AnnotationSpec({
 			description: "Sets a static DB-level default value (used in DDL DEFAULT clause). For string fields the value is used as-is; for other types it is parsed as JSON.\n\n**Example:**\n```atscript\n@db.default \"active\"\nstatus: string\n```\n",
 			nodeType: ["prop"],
 			argument: {
@@ -168,7 +167,7 @@ const dbColumnAnnotations = {
 				description: "Static default value. Strings used as-is; other types parsed via JSON.parse()."
 			}
 		}),
-		increment: new __atscript_core.AnnotationSpec({
+		increment: new _atscript_core.AnnotationSpec({
 			description: "Auto-incrementing integer default. Each adapter maps this to its native mechanism (e.g., `AUTO_INCREMENT` in MySQL, `INTEGER PRIMARY KEY` in SQLite, counter collection in MongoDB).\n\n**Example:**\n```atscript\n@db.default.increment\nid: number.int\n\n// With optional start value:\n@db.default.increment 1000\nid: number.int\n```\n",
 			nodeType: ["prop"],
 			argument: {
@@ -181,14 +180,14 @@ const dbColumnAnnotations = {
 				return require_validation_utils.validateFieldBaseType(token, doc, "db.default.increment", "number");
 			}
 		}),
-		uuid: new __atscript_core.AnnotationSpec({
+		uuid: new _atscript_core.AnnotationSpec({
 			description: "UUID generation default. Each adapter maps this to its native mechanism (e.g., `DEFAULT (UUID())` in MySQL, `gen_random_uuid()` in PostgreSQL, app-level in SQLite).\n\n**Example:**\n```atscript\n@db.default.uuid\nid: string.uuid\n```\n",
 			nodeType: ["prop"],
 			validate(token, args, doc) {
 				return require_validation_utils.validateFieldBaseType(token, doc, "db.default.uuid", "string");
 			}
 		}),
-		now: new __atscript_core.AnnotationSpec({
+		now: new _atscript_core.AnnotationSpec({
 			description: "Current timestamp default. Each adapter maps this to its native mechanism (e.g., `DEFAULT CURRENT_TIMESTAMP` in MySQL, `DEFAULT now()` in PostgreSQL).\n\n**Example:**\n```atscript\n@db.default.now\ncreatedAt: number.timestamp\n```\n",
 			nodeType: ["prop"],
 			validate(token, args, doc) {
@@ -196,16 +195,15 @@ const dbColumnAnnotations = {
 			}
 		})
 	},
-	json: new __atscript_core.AnnotationSpec({
+	json: new _atscript_core.AnnotationSpec({
 		description: "Forces a field to be stored as a single JSON column instead of being flattened into separate columns. Use on nested object fields that should remain as JSON in the database.\n\n**Example:**\n```atscript\n@db.json\nmetadata: { key: string, value: string }\n```\n",
 		nodeType: ["prop"],
 		validate(token, _args, doc) {
 			const errors = [];
-			const field = token.parentNode;
-			const definition = field.getDefinition();
-			if (definition && (0, __atscript_core.isRef)(definition)) {
+			const definition = token.parentNode.getDefinition();
+			if (definition && (0, _atscript_core.isRef)(definition)) {
 				const unwound = doc.unwindType(definition.id, definition.chain);
-				if (unwound && (0, __atscript_core.isPrimitive)(unwound.def)) errors.push({
+				if (unwound && (0, _atscript_core.isPrimitive)(unwound.def)) errors.push({
 					message: "@db.json on a primitive field has no effect — primitive fields are already stored as scalar columns",
 					severity: 2,
 					range: token.range
@@ -214,13 +212,12 @@ const dbColumnAnnotations = {
 			return errors;
 		}
 	}),
-	ignore: new __atscript_core.AnnotationSpec({
+	ignore: new _atscript_core.AnnotationSpec({
 		description: "Excludes a field from the database schema. The field exists in the Atscript type but has no column in the DB.\n\n**Example:**\n```atscript\n@db.ignore\ndisplayName: string\n```\n",
 		nodeType: ["prop"],
-		validate(token, args, doc) {
+		validate(token, _args, _doc) {
 			const errors = [];
-			const field = token.parentNode;
-			if (field.countAnnotations("meta.id") > 0) errors.push({
+			if (token.parentNode.countAnnotations("meta.id") > 0) errors.push({
 				message: `@db.ignore cannot coexist with @meta.id — a field cannot be both a primary key and excluded from the database`,
 				severity: 1,
 				range: token.range
@@ -229,11 +226,10 @@ const dbColumnAnnotations = {
 		}
 	})
 };
-
 //#endregion
-//#region packages/db/src/plugin/annotations/index-ann.ts
+//#region src/plugin/annotations/index-ann.ts
 const dbIndexAnnotations = { index: {
-	plain: new __atscript_core.AnnotationSpec({
+	plain: new _atscript_core.AnnotationSpec({
 		description: "Standard (non-unique) index for query performance. Fields sharing the same index name form a composite index.\n\n**Example:**\n```atscript\n@db.index.plain \"idx_timeline\", \"desc\"\ncreatedAt: number.timestamp\n```\n",
 		nodeType: ["prop"],
 		multiple: true,
@@ -251,7 +247,7 @@ const dbIndexAnnotations = { index: {
 			description: "Sort direction. Defaults to \"asc\"."
 		}]
 	}),
-	unique: new __atscript_core.AnnotationSpec({
+	unique: new _atscript_core.AnnotationSpec({
 		description: "Unique index — ensures no two rows/documents have the same value(s). Fields sharing the same index name form a composite unique constraint.\n\n**Example:**\n```atscript\n@db.index.unique \"tenant_email\"\nemail: string.email\n```\n",
 		nodeType: ["prop"],
 		multiple: true,
@@ -263,7 +259,7 @@ const dbIndexAnnotations = { index: {
 			description: "Index name / composite group name."
 		}
 	}),
-	fulltext: new __atscript_core.AnnotationSpec({
+	fulltext: new _atscript_core.AnnotationSpec({
 		description: "Full-text search index. Fields sharing the same index name form a composite full-text index.\n\n**Example:**\n```atscript\n@db.index.fulltext \"ft_content\"\ntitle: string\n\n@db.index.fulltext \"ft_content\", 5\nbio: string\n```\n",
 		nodeType: ["prop"],
 		multiple: true,
@@ -281,11 +277,10 @@ const dbIndexAnnotations = { index: {
 		}]
 	})
 } };
-
 //#endregion
-//#region packages/db/src/plugin/annotations/rel.ts
+//#region src/plugin/annotations/rel.ts
 const dbRelAnnotations = { rel: {
-	FK: new __atscript_core.AnnotationSpec({
+	FK: new _atscript_core.AnnotationSpec({
 		description: "Declares a foreign key constraint on this field. The field must use a chain reference type (e.g., `User.id`) to specify the FK target.\n\n**Example:**\n```atscript\n@db.rel.FK\nauthorId: User.id\n\n// With alias (required when multiple FKs point to the same type)\n@db.rel.FK \"author\"\nauthorId: User.id\n```\n",
 		nodeType: ["prop"],
 		argument: {
@@ -310,7 +305,7 @@ const dbRelAnnotations = { rel: {
 				range: token.range
 			});
 			const definition = field.getDefinition();
-			if (!definition || !(0, __atscript_core.isRef)(definition) || !definition.hasChain) {
+			if (!definition || !(0, _atscript_core.isRef)(definition) || !definition.hasChain) {
 				errors.push({
 					message: `@db.rel.FK requires a chain reference type (e.g. User.id), got scalar type`,
 					severity: 1,
@@ -324,9 +319,9 @@ const dbRelAnnotations = { rel: {
 			const targetUnwound = doc.unwindType(refTypeName);
 			if (targetUnwound) {
 				const targetDef = targetUnwound.def;
-				if ((0, __atscript_core.isInterface)(targetDef) || (0, __atscript_core.isStructure)(targetDef)) {
-					const struct = (0, __atscript_core.isInterface)(targetDef) ? targetDef.getDefinition() : targetDef;
-					if (struct && (0, __atscript_core.isStructure)(struct) && chainFields.length > 0) {
+				if ((0, _atscript_core.isInterface)(targetDef) || (0, _atscript_core.isStructure)(targetDef)) {
+					const struct = (0, _atscript_core.isInterface)(targetDef) ? targetDef.getDefinition() : targetDef;
+					if (struct && (0, _atscript_core.isStructure)(struct) && chainFields.length > 0) {
 						const targetProp = struct.props.get(chainFields[0]);
 						if (targetProp) {
 							if (targetProp.countAnnotations("meta.id") === 0 && targetProp.countAnnotations("db.index.unique") === 0) errors.push({
@@ -335,14 +330,14 @@ const dbRelAnnotations = { rel: {
 								range: token.range
 							});
 							const propDef = targetProp.getDefinition();
-							if (propDef && (0, __atscript_core.isRef)(propDef)) {
+							if (propDef && (0, _atscript_core.isRef)(propDef)) {
 								const propUnwound = targetUnwound.doc.unwindType(propDef.id, propDef.chain);
-								if (propUnwound && !(0, __atscript_core.isPrimitive)(propUnwound.def)) errors.push({
+								if (propUnwound && !(0, _atscript_core.isPrimitive)(propUnwound.def)) errors.push({
 									message: `Foreign key field must resolve to a scalar type (number, string, etc.), got '${propDef.id}'`,
 									severity: 1,
 									range: token.range
 								});
-							} else if (propDef && !(0, __atscript_core.isPrimitive)(propDef)) errors.push({
+							} else if (propDef && !(0, _atscript_core.isPrimitive)(propDef)) errors.push({
 								message: `Foreign key field must resolve to a scalar type (number, string, etc.)`,
 								severity: 1,
 								range: token.range
@@ -358,7 +353,7 @@ const dbRelAnnotations = { rel: {
 					for (const [, prop] of struct.props) {
 						if (prop.countAnnotations("db.rel.FK") === 0) continue;
 						const def = prop.getDefinition();
-						if (!def || !(0, __atscript_core.isRef)(def)) continue;
+						if (!def || !(0, _atscript_core.isRef)(def)) continue;
 						const r = def;
 						if (!r.hasChain) continue;
 						if (r.id === refTypeName) {
@@ -375,7 +370,7 @@ const dbRelAnnotations = { rel: {
 			return errors;
 		}
 	}),
-	to: new __atscript_core.AnnotationSpec({
+	to: new _atscript_core.AnnotationSpec({
 		description: "Forward navigational property — the FK is on **this** interface. The compiler resolves the matching @db.rel.FK by target type or alias.\n\n**Example:**\n```atscript\n@db.rel.to\nauthor?: User\n\n// With alias\n@db.rel.to \"author\"\nauthor?: User\n```\n",
 		nodeType: ["prop"],
 		argument: {
@@ -404,7 +399,7 @@ const dbRelAnnotations = { rel: {
 			const unwound = doc.unwindType(targetTypeName);
 			if (unwound) {
 				const targetDef = unwound.def;
-				const targetNode = (0, __atscript_core.isInterface)(targetDef) ? targetDef : undefined;
+				const targetNode = (0, _atscript_core.isInterface)(targetDef) ? targetDef : void 0;
 				if (!targetNode || targetNode.countAnnotations("db.table") === 0) errors.push({
 					message: `@db.rel.to target '${targetTypeName}' is not a @db.table entity`,
 					severity: 1,
@@ -424,9 +419,8 @@ const dbRelAnnotations = { rel: {
 					if (name === fieldName) continue;
 					if (prop.countAnnotations("db.rel.to") === 0) continue;
 					const propAlias = require_validation_utils.getAnnotationAlias(prop, "db.rel.to");
-					if ((alias || undefined) === (propAlias || undefined)) {
-						const otherTarget = require_validation_utils.getNavTargetTypeName(prop);
-						if (otherTarget === targetTypeName) {
+					if ((alias || void 0) === (propAlias || void 0)) {
+						if (require_validation_utils.getNavTargetTypeName(prop) === targetTypeName) {
 							errors.push({
 								message: `Duplicate @db.rel.to '${alias || targetTypeName}' — only one forward navigational property per alias`,
 								severity: 1,
@@ -437,8 +431,7 @@ const dbRelAnnotations = { rel: {
 					}
 				}
 				if (alias) {
-					const matches = require_validation_utils.findFKFieldsPointingTo(doc, struct, targetTypeName, alias);
-					if (matches.length === 0) errors.push({
+					if (require_validation_utils.findFKFieldsPointingTo(doc, struct, targetTypeName, alias).length === 0) errors.push({
 						message: `No @db.rel.FK '${alias}' found on this interface`,
 						severity: 1,
 						range: token.range
@@ -450,7 +443,7 @@ const dbRelAnnotations = { rel: {
 						severity: 1,
 						range: token.range
 					});
-else if (matches.length > 1) errors.push({
+					else if (matches.length > 1) errors.push({
 						message: `Multiple @db.rel.FK fields point to '${targetTypeName}' — add alias to disambiguate`,
 						severity: 1,
 						range: token.range
@@ -460,7 +453,7 @@ else if (matches.length > 1) errors.push({
 			return errors;
 		}
 	}),
-	from: new __atscript_core.AnnotationSpec({
+	from: new _atscript_core.AnnotationSpec({
 		description: "Inverse navigational property — the FK is on the **target** interface, pointing back to this one.\n\n**Example:**\n```atscript\n@db.rel.from\nposts: Post[]\n\n// With alias\n@db.rel.from \"original\"\ncomments: Comment[]\n```\n",
 		nodeType: ["prop"],
 		argument: {
@@ -490,7 +483,7 @@ else if (matches.length > 1) errors.push({
 			if (!unwound) return errors;
 			const targetDef = unwound.def;
 			const targetDoc = unwound.doc;
-			if (!(0, __atscript_core.isInterface)(targetDef) || targetDef.countAnnotations("db.table") === 0) {
+			if (!(0, _atscript_core.isInterface)(targetDef) || targetDef.countAnnotations("db.table") === 0) {
 				errors.push({
 					message: `@db.rel.from target '${targetTypeName}' is not a @db.table entity`,
 					severity: 1,
@@ -505,9 +498,8 @@ else if (matches.length > 1) errors.push({
 					if (name === fieldName) continue;
 					if (prop.countAnnotations("db.rel.from") === 0) continue;
 					const propAlias = require_validation_utils.getAnnotationAlias(prop, "db.rel.from");
-					if ((alias || undefined) === (propAlias || undefined)) {
-						const otherTarget = require_validation_utils.getNavTargetTypeName(prop);
-						if (otherTarget === targetTypeName) {
+					if ((alias || void 0) === (propAlias || void 0)) {
+						if (require_validation_utils.getNavTargetTypeName(prop) === targetTypeName) {
 							errors.push({
 								message: `Duplicate @db.rel.from '${alias || targetTypeName}' — only one inverse navigational property per alias`,
 								severity: 1,
@@ -532,15 +524,13 @@ else if (matches.length > 1) errors.push({
 				severity: 1,
 				range: token.range
 			});
-else if (matches.length > 1) errors.push({
+			else if (matches.length > 1) errors.push({
 				message: `'${targetTypeName}' has multiple @db.rel.FK fields pointing to '${thisTypeName}' — add alias`,
 				severity: 1,
 				range: token.range
 			});
-			const fieldDef = field.getDefinition();
-			if (!(0, __atscript_core.isArray)(fieldDef) && matches.length === 1) {
-				const fkProp = matches[0].prop;
-				if (fkProp.countAnnotations("db.index.unique") === 0) errors.push({
+			if (!(0, _atscript_core.isArray)(field.getDefinition()) && matches.length === 1) {
+				if (matches[0].prop.countAnnotations("db.index.unique") === 0) errors.push({
 					message: `@db.rel.from '${field.id}' has singular type '${targetTypeName}' (1:1) but the FK on '${targetTypeName}' is not @db.index.unique — did you mean '${targetTypeName}[]' (1:N)?`,
 					severity: 2,
 					range: token.range
@@ -551,7 +541,7 @@ else if (matches.length > 1) errors.push({
 	}),
 	onDelete: require_validation_utils.refActionAnnotation("onDelete"),
 	onUpdate: require_validation_utils.refActionAnnotation("onUpdate"),
-	via: new __atscript_core.AnnotationSpec({
+	via: new _atscript_core.AnnotationSpec({
 		description: "Declares a many-to-many navigational property through an explicit junction table. `@db.rel.via` is self-sufficient — no `@db.rel.from` pairing is needed.\n\n**Example:**\n```atscript\n@db.rel.via PostTag\ntags: Tag[]\n```\n",
 		nodeType: ["prop"],
 		argument: {
@@ -567,8 +557,7 @@ else if (matches.length > 1) errors.push({
 				severity: 1,
 				range: token.range
 			});
-			const definition = field.getDefinition();
-			if (!(0, __atscript_core.isArray)(definition)) errors.push({
+			if (!(0, _atscript_core.isArray)(field.getDefinition())) errors.push({
 				message: "@db.rel.via requires an array type (e.g. Tag[])",
 				severity: 1,
 				range: token.range
@@ -580,7 +569,7 @@ else if (matches.length > 1) errors.push({
 			const junctionUnwound = doc.unwindType(junctionName);
 			if (!junctionUnwound) return errors;
 			const junctionDef = junctionUnwound.def;
-			if (!(0, __atscript_core.isInterface)(junctionDef)) return errors;
+			if (!(0, _atscript_core.isInterface)(junctionDef)) return errors;
 			const thisTypeName = require_validation_utils.getParentTypeName(token);
 			const targetTypeName = require_validation_utils.getNavTargetTypeName(field);
 			if (!thisTypeName || !targetTypeName) return errors;
@@ -590,7 +579,7 @@ else if (matches.length > 1) errors.push({
 				severity: 1,
 				range: args[0].range
 			});
-else if (fksToThis.length > 1) errors.push({
+			else if (fksToThis.length > 1) errors.push({
 				message: `Junction '${junctionName}' has multiple @db.rel.FK pointing to '${thisTypeName}' — not supported`,
 				severity: 1,
 				range: args[0].range
@@ -602,7 +591,7 @@ else if (fksToThis.length > 1) errors.push({
 					severity: 1,
 					range: args[0].range
 				});
-else if (fksToTarget.length > 1) errors.push({
+				else if (fksToTarget.length > 1) errors.push({
 					message: `Junction '${junctionName}' has multiple @db.rel.FK pointing to '${targetTypeName}' — not supported`,
 					severity: 1,
 					range: args[0].range
@@ -611,7 +600,7 @@ else if (fksToTarget.length > 1) errors.push({
 			return errors;
 		}
 	}),
-	filter: new __atscript_core.AnnotationSpec({
+	filter: new _atscript_core.AnnotationSpec({
 		description: "Applies a filter to a navigational property, restricting which related records are loaded.\n\n**Example:**\n```atscript\n@db.rel.from\n@db.rel.filter `Post.published = true`\npublishedPosts: Post[]\n```\n",
 		nodeType: ["prop"],
 		argument: {
@@ -646,12 +635,11 @@ else if (fksToTarget.length > 1) errors.push({
 		}
 	})
 } };
-
 //#endregion
-//#region packages/db/src/plugin/annotations/search.ts
+//#region src/plugin/annotations/search.ts
 const dbSearchAnnotations = { search: {
 	vector: {
-		$self: new __atscript_core.AnnotationSpec({
+		$self: new _atscript_core.AnnotationSpec({
 			description: "Marks a field as a **vector embedding** for **similarity search**.\n\n- Each adapter maps this to its native vector type and index:\n  - **MongoDB** → Atlas `$vectorSearch` index\n  - **MySQL 9+** → `VECTOR(N)` column + `VEC_DISTANCE_*` functions\n  - **PostgreSQL** → pgvector `vector(N)` column + distance operators\n  - **SQLite** → JSON storage (no native vector support)\n\n**Example:**\n```atscript\n@db.search.vector 1536, \"cosine\"\nembedding: db.vector\n```\n",
 			nodeType: ["prop"],
 			multiple: false,
@@ -689,7 +677,7 @@ const dbSearchAnnotations = { search: {
 				}
 			]
 		}),
-		threshold: new __atscript_core.AnnotationSpec({
+		threshold: new _atscript_core.AnnotationSpec({
 			description: "Sets a **default minimum similarity threshold** for vector search queries on this field.\n\n- Results with a similarity score below this threshold are excluded.\n- Query-time `$threshold` control overrides this default.\n- Value range: `0` to `1` (where `1` means exact match).\n\n**Example:**\n```atscript\n@db.search.vector 1536, \"cosine\"\n@db.search.vector.threshold 0.7\nembedding: db.vector\n```\n",
 			nodeType: ["prop"],
 			multiple: false,
@@ -701,7 +689,7 @@ const dbSearchAnnotations = { search: {
 			}
 		})
 	},
-	filter: new __atscript_core.AnnotationSpec({
+	filter: new _atscript_core.AnnotationSpec({
 		description: "Assigns a field as a **pre-filter** for a **vector search index**.\n\n- Filters allow vector search queries to return results only within a specific subset.\n- The referenced index must be defined using `@db.search.vector`.\n\n**Example:**\n```atscript\n@db.search.vector 1536, \"cosine\"\nembedding: db.vector\n\n@db.search.filter \"embedding\"\ncategory: string\n```\n",
 		nodeType: ["prop"],
 		multiple: true,
@@ -713,12 +701,11 @@ const dbSearchAnnotations = { search: {
 		}
 	})
 } };
-
 //#endregion
-//#region packages/db/src/plugin/annotations/table.ts
+//#region src/plugin/annotations/table.ts
 const dbTableAnnotations = {
 	table: {
-		$self: new __atscript_core.AnnotationSpec({
+		$self: new _atscript_core.AnnotationSpec({
 			description: "Marks an interface as a database-persisted entity (table in SQL, collection in MongoDB). If the name argument is omitted, the adapter derives the table name from the interface name.\n\n**Example:**\n```atscript\n@db.table \"users\"\nexport interface User { ... }\n```\n",
 			nodeType: ["interface"],
 			argument: {
@@ -738,7 +725,7 @@ const dbTableAnnotations = {
 				return errors;
 			}
 		}),
-		renamed: new __atscript_core.AnnotationSpec({
+		renamed: new _atscript_core.AnnotationSpec({
 			description: "Specifies the previous table name for table rename migration. The sync engine generates ALTER TABLE RENAME instead of drop+create.\n\n**Example:**\n```atscript\n@db.table \"app_users\"\n@db.table.renamed \"users\"\nexport interface User { ... }\n```\n",
 			nodeType: ["interface"],
 			argument: {
@@ -748,8 +735,7 @@ const dbTableAnnotations = {
 			},
 			validate(token, _args, _doc) {
 				const errors = [];
-				const owner = token.parentNode;
-				if (owner.countAnnotations("db.table") === 0) errors.push({
+				if (token.parentNode.countAnnotations("db.table") === 0) errors.push({
 					message: "@db.table.renamed requires @db.table on the same interface",
 					severity: 1,
 					range: token.range
@@ -758,7 +744,7 @@ const dbTableAnnotations = {
 			}
 		})
 	},
-	schema: new __atscript_core.AnnotationSpec({
+	schema: new _atscript_core.AnnotationSpec({
 		description: "Assigns the entity to a database schema/namespace.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.schema \"auth\"\nexport interface User { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -767,7 +753,7 @@ const dbTableAnnotations = {
 			description: "Schema/namespace name."
 		}
 	}),
-	sync: { method: new __atscript_core.AnnotationSpec({
+	sync: { method: new _atscript_core.AnnotationSpec({
 		description: "Controls how the sync engine handles structural changes that cannot be applied via ALTER TABLE.\n\n- `\"recreate\"` — lossless: create temp table, copy data, drop old, rename.\n- `\"drop\"` — lossy: drop table entirely and create from scratch.\n\nWithout this annotation, structural changes fail with an error requiring manual intervention.\n\n**Example:**\n```atscript\n@db.sync.method \"drop\"\ninterface Logs { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -778,11 +764,10 @@ const dbTableAnnotations = {
 		}
 	}) }
 };
-
 //#endregion
-//#region packages/db/src/plugin/annotations/view.ts
+//#region src/plugin/annotations/view.ts
 const dbViewAnnotations = { view: {
-	$self: new __atscript_core.AnnotationSpec({
+	$self: new _atscript_core.AnnotationSpec({
 		description: "Marks an interface as a **database view**. Optionally takes a view name argument.\n\n**Example:**\n```atscript\n@db.view \"active_premium_users\"\n@db.view.for User\nexport interface ActivePremiumUser { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -793,8 +778,7 @@ const dbViewAnnotations = { view: {
 		},
 		validate(token, _args, _doc) {
 			const errors = [];
-			const owner = token.parentNode;
-			if (owner.countAnnotations("db.table") > 0) errors.push({
+			if (token.parentNode.countAnnotations("db.table") > 0) errors.push({
 				message: "An interface cannot be both a @db.table and a @db.view",
 				severity: 1,
 				range: token.range
@@ -802,7 +786,7 @@ const dbViewAnnotations = { view: {
 			return errors;
 		}
 	}),
-	for: new __atscript_core.AnnotationSpec({
+	for: new _atscript_core.AnnotationSpec({
 		description: "Specifies the entry/primary table for a computed view. Required for views that map fields via chain refs.\n\n**Example:**\n```atscript\n@db.view.for Order\n@db.view.filter `Order.status = 'active'`\nexport interface ActiveOrderDetails { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -812,8 +796,7 @@ const dbViewAnnotations = { view: {
 		},
 		validate(token, args, doc) {
 			const errors = [];
-			const owner = token.parentNode;
-			if (owner.countAnnotations("db.table") > 0) errors.push({
+			if (token.parentNode.countAnnotations("db.table") > 0) errors.push({
 				message: "An interface cannot be both a @db.table and a @db.view",
 				severity: 1,
 				range: token.range
@@ -822,7 +805,7 @@ const dbViewAnnotations = { view: {
 			return errors;
 		}
 	}),
-	joins: new __atscript_core.AnnotationSpec({
+	joins: new _atscript_core.AnnotationSpec({
 		description: "Declares an explicit join for a view. Use when no `@db.rel.*` path exists between the entry table and the target.\n\n**Example:**\n```atscript\n@db.view.for Order\n@db.view.joins Warehouse, `Warehouse.regionId = Order.regionId`\nexport interface OrderWarehouse { ... }\n```\n",
 		nodeType: ["interface"],
 		multiple: true,
@@ -864,7 +847,7 @@ const dbViewAnnotations = { view: {
 			return errors;
 		}
 	}),
-	filter: new __atscript_core.AnnotationSpec({
+	filter: new _atscript_core.AnnotationSpec({
 		description: "WHERE clause for a view, filtering which rows are included.\n\n**Example:**\n```atscript\n@db.view.for User\n@db.view.filter `User.status = 'active' and User.age >= 18`\nexport interface ActiveUser { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -902,7 +885,7 @@ const dbViewAnnotations = { view: {
 			return errors;
 		}
 	}),
-	materialized: new __atscript_core.AnnotationSpec({
+	materialized: new _atscript_core.AnnotationSpec({
 		description: "Marks a view as materialized (precomputed, stored on disk). Supported by PostgreSQL, CockroachDB, Oracle, SQL Server (indexed views), Snowflake. MongoDB supports on-demand materialized views via $merge/$out. Not applicable to MySQL or SQLite.\n\n**Example:**\n```atscript\n@db.view.materialized\n@db.view.for User\n@db.view.filter `User.status = 'active'`\nexport interface ActiveUsers { ... }\n```\n",
 		nodeType: ["interface"],
 		validate(token, _args, _doc) {
@@ -916,7 +899,7 @@ const dbViewAnnotations = { view: {
 			return errors;
 		}
 	}),
-	renamed: new __atscript_core.AnnotationSpec({
+	renamed: new _atscript_core.AnnotationSpec({
 		description: "Specifies the previous view name for view rename migration. The sync engine drops the old view and creates the new one.\n\n**Example:**\n```atscript\n@db.view \"active_premium_users\"\n@db.view.renamed \"active_users\"\n@db.view.for User\nexport interface ActivePremiumUser { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -935,7 +918,7 @@ const dbViewAnnotations = { view: {
 			return errors;
 		}
 	}),
-	having: new __atscript_core.AnnotationSpec({
+	having: new _atscript_core.AnnotationSpec({
 		description: "Post-aggregation filter (HAVING clause) for analytical views. References view field aliases with applied aggregate functions.\n\n**Example:**\n```atscript\n@db.view\n@db.view.for Order\n@db.view.having `totalRevenue > 100`\nexport interface TopCategories { ... }\n```\n",
 		nodeType: ["interface"],
 		argument: {
@@ -955,9 +938,8 @@ const dbViewAnnotations = { view: {
 		}
 	})
 } };
-
 //#endregion
-//#region packages/db/src/plugin/index.ts
+//#region src/plugin/index.ts
 const dbPlugin = () => ({
 	name: "db",
 	config() {
@@ -987,7 +969,6 @@ const dbPlugin = () => ({
 		};
 	}
 });
-
 //#endregion
-exports.dbPlugin = dbPlugin
-exports.default = dbPlugin
+exports.dbPlugin = dbPlugin;
+exports.default = dbPlugin;

package/dist/plugin.d.cts

@@ -0,0 +1,6 @@
+import { TAtscriptPlugin } from "@atscript/core";
+
+//#region src/plugin/index.d.ts
+declare const dbPlugin: () => TAtscriptPlugin;
+//#endregion
+export { dbPlugin, dbPlugin as default };

package/dist/plugin.d.mts

@@ -0,0 +1,6 @@
+import { TAtscriptPlugin } from "@atscript/core";
+
+//#region src/plugin/index.d.ts
+declare const dbPlugin: () => TAtscriptPlugin;
+//#endregion
+export { dbPlugin, dbPlugin as default };