@atscript/db 0.1.39 → 0.1.41

package/dist/{validation-utils-DEoCMmEb.cjs → validation-utils-DVJDijnB.cjs}

@@ -1,33 +1,40 @@
-"use strict";
-const require_chunk = require('./chunk-CrpGerW8.cjs');
-const __atscript_core = require_chunk.__toESM(require("@atscript/core"));
-
-//#region packages/db/src/shared/annotation-utils.ts
+let _atscript_core = require("@atscript/core");
+//#region src/shared/annotation-utils.ts
+/**
+* Traverse from annotation token → prop → structure → interface
+* to check if the parent interface has @db.table.
+*/
 function getDbTableOwner(token) {
-	const field = token.parentNode;
-	const struct = field.ownerNode;
-	if (!struct || !(0, __atscript_core.isStructure)(struct)) return undefined;
+	const struct = token.parentNode.ownerNode;
+	if (!struct || !(0, _atscript_core.isStructure)(struct)) return;
 	const iface = struct.ownerNode;
-	return iface && (0, __atscript_core.isInterface)(iface) ? iface : struct;
+	return iface && (0, _atscript_core.isInterface)(iface) ? iface : struct;
 }
+/**
+* Get the parent structure node from an annotation token.
+*/
 function getParentStruct(token) {
-	const field = token.parentNode;
-	const struct = field.ownerNode;
-	return struct && (0, __atscript_core.isStructure)(struct) ? struct : undefined;
+	const struct = token.parentNode.ownerNode;
+	return struct && (0, _atscript_core.isStructure)(struct) ? struct : void 0;
 }
+/**
+* Get the parent interface name (for error messages and cross-type resolution).
+*/
 function getParentTypeName(token) {
 	const struct = getParentStruct(token);
-	if (!struct) return undefined;
+	if (!struct) return;
 	const iface = struct.ownerNode;
-	return iface && (0, __atscript_core.isInterface)(iface) ? iface.id : struct.id;
+	return iface && (0, _atscript_core.isInterface)(iface) ? iface.id : struct.id;
 }
+/**
+* Validate that an annotation is on a field with the expected base type.
+*/
 function validateFieldBaseType(token, doc, annotationName, expectedType) {
 	const errors = [];
-	const field = token.parentNode;
-	const definition = field.getDefinition();
-	if (!definition || !(0, __atscript_core.isRef)(definition)) return errors;
+	const definition = token.parentNode.getDefinition();
+	if (!definition || !(0, _atscript_core.isRef)(definition)) return errors;
 	const unwound = doc.unwindType(definition.id, definition.chain);
-	if (!unwound || !(0, __atscript_core.isPrimitive)(unwound.def)) return errors;
+	if (!unwound || !(0, _atscript_core.isPrimitive)(unwound.def)) return errors;
 	const ct = unwound.def.config.type;
 	const baseType = typeof ct === "object" ? ct.kind === "final" ? ct.value : ct.kind : ct;
 	const allowed = Array.isArray(expectedType) ? expectedType : [expectedType];
@@ -38,20 +45,35 @@ function validateFieldBaseType(token, doc, annotationName, expectedType) {
 	});
 	return errors;
 }
+/**
+* Extract target type name from a navigational field definition.
+* Unwraps arrays (e.g., `Post[]` → `Post`).
+*/
 function getNavTargetTypeName(field) {
 	let def = field.getDefinition();
-	if ((0, __atscript_core.isArray)(def)) def = def?.getDefinition();
-	if ((0, __atscript_core.isRef)(def)) return def.id;
-	return undefined;
+	if ((0, _atscript_core.isArray)(def)) def = def?.getDefinition();
+	if ((0, _atscript_core.isRef)(def)) return def.id;
 }
+/**
+* Get the alias argument from an annotation on a field.
+*/
 function getAnnotationAlias(prop, annotationName) {
 	const annotations = prop.annotations?.filter((a) => a.name === annotationName);
-	if (!annotations || annotations.length === 0) return undefined;
-	return annotations[0].args.length > 0 ? annotations[0].args[0].text : undefined;
+	if (!annotations || annotations.length === 0) return;
+	return annotations[0].args.length > 0 ? annotations[0].args[0].text : void 0;
 }
+/**
+* Factory for @db.rel.onDelete / @db.rel.onUpdate — identical validation logic,
+* only the annotation name and description verb differ.
+*/
 function refActionAnnotation(name) {
-	return new __atscript_core.AnnotationSpec({
-		description: `Referential action when the target ${name === "onDelete" ? "row is deleted" : "key is updated"}. Only valid on @db.rel.FK fields.\n\n` + "**Example:**\n" + "```atscript\n" + "@db.rel.FK\n" + `@db.rel.${name} "cascade"\n` + "authorId: User.id\n" + "```\n",
+	return new _atscript_core.AnnotationSpec({
+		description: `Referential action when the target ${name === "onDelete" ? "row is deleted" : "key is updated"}. Only valid on @db.rel.FK fields.\n\n**Example:**
+\`\`\`atscript
+@db.rel.FK
+@db.rel.${name} "cascade"\nauthorId: User.id
+\`\`\`
+`,
 		nodeType: ["prop"],
 		argument: {
 			name: "action",
@@ -65,7 +87,7 @@ function refActionAnnotation(name) {
 			],
 			description: "Referential action: \"cascade\", \"restrict\", \"noAction\", \"setNull\", or \"setDefault\"."
 		},
-		validate(token, args, doc) {
+		validate(token, args, _doc) {
 			const errors = [];
 			const field = token.parentNode;
 			if (field.countAnnotations("db.rel.FK") === 0) errors.push({
@@ -95,8 +117,7 @@ function refActionAnnotation(name) {
 					for (const [, prop] of struct.props) {
 						if (prop.countAnnotations("db.rel.FK") === 0) continue;
 						if (prop.countAnnotations(annotationName) === 0) continue;
-						const propFkAlias = getAnnotationAlias(prop, "db.rel.FK");
-						if (propFkAlias === fkAlias) count++;
+						if (getAnnotationAlias(prop, "db.rel.FK") === fkAlias) count++;
 					}
 					if (count > 1) errors.push({
 						message: `Composite FK '${fkAlias}' has @db.rel.${name} on multiple fields — declare it on exactly one`,
@@ -109,17 +130,18 @@ function refActionAnnotation(name) {
 		}
 	});
 }
-
 //#endregion
-//#region packages/db/src/shared/validation-utils.ts
+//#region src/shared/validation-utils.ts
+/**
+* Validate a ref annotation argument against the document's type registry.
+* Returns diagnostic messages for unknown types or fields.
+*/
 function validateRefArgument(token, doc, options) {
 	const messages = [];
-	const text = token.text;
-	const [typeName, ...chain] = text.split(".");
+	const [typeName, ...chain] = token.text.split(".");
 	const decl = doc.getDeclarationOwnerNode(typeName);
 	if (!decl) {
-		const regDef = doc.registry.definitions.get(typeName);
-		if (regDef?.imported) return messages;
+		if (doc.registry.definitions.get(typeName)?.imported) return messages;
 		messages.push({
 			severity: 1,
 			message: `Unknown type '${typeName}'.`,
@@ -128,8 +150,7 @@ function validateRefArgument(token, doc, options) {
 		return messages;
 	}
 	if (chain.length > 0) {
-		const unwound = doc.unwindType(typeName, chain);
-		if (!unwound) {
+		if (!doc.unwindType(typeName, chain)) {
 			messages.push({
 				severity: 1,
 				message: `Field '${chain.join(".")}' does not exist on type '${typeName}'.`,
@@ -139,8 +160,7 @@ function validateRefArgument(token, doc, options) {
 		}
 	}
 	if (options?.requireDbTable && decl.node) {
-		const hasDbTable = decl.node.countAnnotations("db.table") > 0;
-		if (!hasDbTable) messages.push({
+		if (!(decl.node.countAnnotations("db.table") > 0)) messages.push({
 			severity: 1,
 			message: `Type '${typeName}' must have @db.table annotation.`,
 			range: token.range
@@ -148,28 +168,30 @@ function validateRefArgument(token, doc, options) {
 	}
 	return messages;
 }
+/**
+* Find all `@db.rel.FK` fields on a type that reference `targetTypeName`.
+* Resolves `extends` to include inherited fields.
+*/
 function findFKFieldsPointingTo(doc, iface, targetTypeName, alias) {
 	const results = [];
 	let struct;
-	if ((0, __atscript_core.isInterface)(iface) && iface.hasExtends) {
+	if ((0, _atscript_core.isInterface)(iface) && iface.hasExtends) {
 		const resolved = doc.resolveInterfaceExtends(iface);
-		if (resolved && (0, __atscript_core.isStructure)(resolved)) struct = resolved;
+		if (resolved && (0, _atscript_core.isStructure)(resolved)) struct = resolved;
 	}
-	if (!struct) struct = (0, __atscript_core.isStructure)(iface) ? iface : (0, __atscript_core.isInterface)(iface) && (0, __atscript_core.isStructure)(iface.getDefinition()) ? iface.getDefinition() : undefined;
+	if (!struct) struct = (0, _atscript_core.isStructure)(iface) ? iface : (0, _atscript_core.isInterface)(iface) && (0, _atscript_core.isStructure)(iface.getDefinition()) ? iface.getDefinition() : void 0;
 	if (!struct) return results;
 	for (const [name, 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 ref = def;
 		if (!ref.hasChain) continue;
 		const refTypeName = ref.id;
 		const refField = ref.chain.map((c) => c.text).join(".");
 		if (refTypeName !== targetTypeName) continue;
-		if (alias !== undefined) {
-			const fkAnnotations = prop.annotations?.filter((a) => a.name === "db.rel.FK");
-			const hasMatchingAlias = fkAnnotations?.some((a) => a.args.length > 0 && a.args[0].text === alias);
-			if (!hasMatchingAlias) continue;
+		if (alias !== void 0) {
+			if (!(prop.annotations?.filter((a) => a.name === "db.rel.FK"))?.some((a) => a.args.length > 0 && a.args[0].text === alias)) continue;
 		}
 		results.push({
 			name,
@@ -189,9 +211,20 @@ const viewAnnotationNames = [
 	"db.view.filter",
 	"db.view.materialized"
 ];
+/**
+* Check if a node has any @db.view.* annotation.
+*/
 function hasAnyViewAnnotation(node) {
 	return viewAnnotationNames.some((name) => node.countAnnotations(name) > 0);
 }
+/**
+* Validate that all type refs in a query expression are within the allowed scope.
+*
+* @param queryToken - The query arg token (must have .queryNode)
+* @param allowedTypes - Type names allowed as qualified refs
+* @param unqualifiedTarget - Type name for resolving unqualified refs, or null to disallow them
+* @param doc - The document for type lookups
+*/
 function validateQueryScope(queryToken, allowedTypes, unqualifiedTarget, doc) {
 	const errors = [];
 	const queryNode = queryToken.queryNode;
@@ -209,13 +242,13 @@ function validateQueryScope(queryToken, allowedTypes, unqualifiedTarget, doc) {
 			severity: 1,
 			range: ref.fieldRef.range
 		});
-else {
+		else {
 			const unwound = doc.unwindType(unqualifiedTarget);
 			if (unwound) {
 				const targetDef = unwound.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) && !struct.props.has(ref.fieldRef.text)) errors.push({
+				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) && !struct.props.has(ref.fieldRef.text)) errors.push({
 						message: `Field '${ref.fieldRef.text}' does not exist on '${unqualifiedTarget}'`,
 						severity: 1,
 						range: ref.fieldRef.range
@@ -225,8 +258,8 @@ else {
 		}
 	}
 	function walkExpr(expr) {
-		if ((0, __atscript_core.isQueryLogical)(expr)) for (const operand of expr.operands) walkExpr(operand);
-else if ((0, __atscript_core.isQueryComparison)(expr)) {
+		if ((0, _atscript_core.isQueryLogical)(expr)) for (const operand of expr.operands) walkExpr(operand);
+		else if ((0, _atscript_core.isQueryComparison)(expr)) {
 			walkFieldRef(expr.left);
 			if (expr.right && "fieldRef" in expr.right) walkFieldRef(expr.right);
 		}
@@ -234,71 +267,70 @@ else if ((0, __atscript_core.isQueryComparison)(expr)) {
 	walkExpr(queryNode.expression);
 	return errors;
 }
-
 //#endregion
-Object.defineProperty(exports, 'findFKFieldsPointingTo', {
-  enumerable: true,
-  get: function () {
-    return findFKFieldsPointingTo;
-  }
+Object.defineProperty(exports, "findFKFieldsPointingTo", {
+	enumerable: true,
+	get: function() {
+		return findFKFieldsPointingTo;
+	}
+});
+Object.defineProperty(exports, "getAnnotationAlias", {
+	enumerable: true,
+	get: function() {
+		return getAnnotationAlias;
+	}
 });
-Object.defineProperty(exports, 'getAnnotationAlias', {
-  enumerable: true,
-  get: function () {
-    return getAnnotationAlias;
-  }
+Object.defineProperty(exports, "getDbTableOwner", {
+	enumerable: true,
+	get: function() {
+		return getDbTableOwner;
+	}
 });
-Object.defineProperty(exports, 'getDbTableOwner', {
-  enumerable: true,
-  get: function () {
-    return getDbTableOwner;
-  }
+Object.defineProperty(exports, "getNavTargetTypeName", {
+	enumerable: true,
+	get: function() {
+		return getNavTargetTypeName;
+	}
 });
-Object.defineProperty(exports, 'getNavTargetTypeName', {
-  enumerable: true,
-  get: function () {
-    return getNavTargetTypeName;
-  }
+Object.defineProperty(exports, "getParentStruct", {
+	enumerable: true,
+	get: function() {
+		return getParentStruct;
+	}
 });
-Object.defineProperty(exports, 'getParentStruct', {
-  enumerable: true,
-  get: function () {
-    return getParentStruct;
-  }
+Object.defineProperty(exports, "getParentTypeName", {
+	enumerable: true,
+	get: function() {
+		return getParentTypeName;
+	}
 });
-Object.defineProperty(exports, 'getParentTypeName', {
-  enumerable: true,
-  get: function () {
-    return getParentTypeName;
-  }
+Object.defineProperty(exports, "hasAnyViewAnnotation", {
+	enumerable: true,
+	get: function() {
+		return hasAnyViewAnnotation;
+	}
 });
-Object.defineProperty(exports, 'hasAnyViewAnnotation', {
-  enumerable: true,
-  get: function () {
-    return hasAnyViewAnnotation;
-  }
+Object.defineProperty(exports, "refActionAnnotation", {
+	enumerable: true,
+	get: function() {
+		return refActionAnnotation;
+	}
 });
-Object.defineProperty(exports, 'refActionAnnotation', {
-  enumerable: true,
-  get: function () {
-    return refActionAnnotation;
-  }
+Object.defineProperty(exports, "validateFieldBaseType", {
+	enumerable: true,
+	get: function() {
+		return validateFieldBaseType;
+	}
 });
-Object.defineProperty(exports, 'validateFieldBaseType', {
-  enumerable: true,
-  get: function () {
-    return validateFieldBaseType;
-  }
+Object.defineProperty(exports, "validateQueryScope", {
+	enumerable: true,
+	get: function() {
+		return validateQueryScope;
+	}
 });
-Object.defineProperty(exports, 'validateQueryScope', {
-  enumerable: true,
-  get: function () {
-    return validateQueryScope;
-  }
+Object.defineProperty(exports, "validateRefArgument", {
+	enumerable: true,
+	get: function() {
+		return validateRefArgument;
+	}
 });
-Object.defineProperty(exports, 'validateRefArgument', {
-  enumerable: true,
-  get: function () {
-    return validateRefArgument;
-  }
-});

package/dist/{validation-utils-DhR_mtKa.mjs → validation-utils-DhjIjP1-.mjs}

@@ -1,28 +1,37 @@
 import { AnnotationSpec, isArray, isInterface, isPrimitive, isQueryComparison, isQueryLogical, isRef, isStructure } from "@atscript/core";
-
-//#region packages/db/src/shared/annotation-utils.ts
+//#region src/shared/annotation-utils.ts
+/**
+* Traverse from annotation token → prop → structure → interface
+* to check if the parent interface has @db.table.
+*/
 function getDbTableOwner(token) {
-	const field = token.parentNode;
-	const struct = field.ownerNode;
-	if (!struct || !isStructure(struct)) return undefined;
+	const struct = token.parentNode.ownerNode;
+	if (!struct || !isStructure(struct)) return;
 	const iface = struct.ownerNode;
 	return iface && isInterface(iface) ? iface : struct;
 }
+/**
+* Get the parent structure node from an annotation token.
+*/
 function getParentStruct(token) {
-	const field = token.parentNode;
-	const struct = field.ownerNode;
-	return struct && isStructure(struct) ? struct : undefined;
+	const struct = token.parentNode.ownerNode;
+	return struct && isStructure(struct) ? struct : void 0;
 }
+/**
+* Get the parent interface name (for error messages and cross-type resolution).
+*/
 function getParentTypeName(token) {
 	const struct = getParentStruct(token);
-	if (!struct) return undefined;
+	if (!struct) return;
 	const iface = struct.ownerNode;
 	return iface && isInterface(iface) ? iface.id : struct.id;
 }
+/**
+* Validate that an annotation is on a field with the expected base type.
+*/
 function validateFieldBaseType(token, doc, annotationName, expectedType) {
 	const errors = [];
-	const field = token.parentNode;
-	const definition = field.getDefinition();
+	const definition = token.parentNode.getDefinition();
 	if (!definition || !isRef(definition)) return errors;
 	const unwound = doc.unwindType(definition.id, definition.chain);
 	if (!unwound || !isPrimitive(unwound.def)) return errors;
@@ -36,20 +45,35 @@ function validateFieldBaseType(token, doc, annotationName, expectedType) {
 	});
 	return errors;
 }
+/**
+* Extract target type name from a navigational field definition.
+* Unwraps arrays (e.g., `Post[]` → `Post`).
+*/
 function getNavTargetTypeName(field) {
 	let def = field.getDefinition();
 	if (isArray(def)) def = def?.getDefinition();
 	if (isRef(def)) return def.id;
-	return undefined;
 }
+/**
+* Get the alias argument from an annotation on a field.
+*/
 function getAnnotationAlias(prop, annotationName) {
 	const annotations = prop.annotations?.filter((a) => a.name === annotationName);
-	if (!annotations || annotations.length === 0) return undefined;
-	return annotations[0].args.length > 0 ? annotations[0].args[0].text : undefined;
+	if (!annotations || annotations.length === 0) return;
+	return annotations[0].args.length > 0 ? annotations[0].args[0].text : void 0;
 }
+/**
+* Factory for @db.rel.onDelete / @db.rel.onUpdate — identical validation logic,
+* only the annotation name and description verb differ.
+*/
 function refActionAnnotation(name) {
 	return new AnnotationSpec({
-		description: `Referential action when the target ${name === "onDelete" ? "row is deleted" : "key is updated"}. Only valid on @db.rel.FK fields.\n\n` + "**Example:**\n" + "```atscript\n" + "@db.rel.FK\n" + `@db.rel.${name} "cascade"\n` + "authorId: User.id\n" + "```\n",
+		description: `Referential action when the target ${name === "onDelete" ? "row is deleted" : "key is updated"}. Only valid on @db.rel.FK fields.\n\n**Example:**
+\`\`\`atscript
+@db.rel.FK
+@db.rel.${name} "cascade"\nauthorId: User.id
+\`\`\`
+`,
 		nodeType: ["prop"],
 		argument: {
 			name: "action",
@@ -63,7 +87,7 @@ function refActionAnnotation(name) {
 			],
 			description: "Referential action: \"cascade\", \"restrict\", \"noAction\", \"setNull\", or \"setDefault\"."
 		},
-		validate(token, args, doc) {
+		validate(token, args, _doc) {
 			const errors = [];
 			const field = token.parentNode;
 			if (field.countAnnotations("db.rel.FK") === 0) errors.push({
@@ -93,8 +117,7 @@ function refActionAnnotation(name) {
 					for (const [, prop] of struct.props) {
 						if (prop.countAnnotations("db.rel.FK") === 0) continue;
 						if (prop.countAnnotations(annotationName) === 0) continue;
-						const propFkAlias = getAnnotationAlias(prop, "db.rel.FK");
-						if (propFkAlias === fkAlias) count++;
+						if (getAnnotationAlias(prop, "db.rel.FK") === fkAlias) count++;
 					}
 					if (count > 1) errors.push({
 						message: `Composite FK '${fkAlias}' has @db.rel.${name} on multiple fields — declare it on exactly one`,
@@ -107,17 +130,18 @@ function refActionAnnotation(name) {
 		}
 	});
 }
-
 //#endregion
-//#region packages/db/src/shared/validation-utils.ts
+//#region src/shared/validation-utils.ts
+/**
+* Validate a ref annotation argument against the document's type registry.
+* Returns diagnostic messages for unknown types or fields.
+*/
 function validateRefArgument(token, doc, options) {
 	const messages = [];
-	const text = token.text;
-	const [typeName, ...chain] = text.split(".");
+	const [typeName, ...chain] = token.text.split(".");
 	const decl = doc.getDeclarationOwnerNode(typeName);
 	if (!decl) {
-		const regDef = doc.registry.definitions.get(typeName);
-		if (regDef?.imported) return messages;
+		if (doc.registry.definitions.get(typeName)?.imported) return messages;
 		messages.push({
 			severity: 1,
 			message: `Unknown type '${typeName}'.`,
@@ -126,8 +150,7 @@ function validateRefArgument(token, doc, options) {
 		return messages;
 	}
 	if (chain.length > 0) {
-		const unwound = doc.unwindType(typeName, chain);
-		if (!unwound) {
+		if (!doc.unwindType(typeName, chain)) {
 			messages.push({
 				severity: 1,
 				message: `Field '${chain.join(".")}' does not exist on type '${typeName}'.`,
@@ -137,8 +160,7 @@ function validateRefArgument(token, doc, options) {
 		}
 	}
 	if (options?.requireDbTable && decl.node) {
-		const hasDbTable = decl.node.countAnnotations("db.table") > 0;
-		if (!hasDbTable) messages.push({
+		if (!(decl.node.countAnnotations("db.table") > 0)) messages.push({
 			severity: 1,
 			message: `Type '${typeName}' must have @db.table annotation.`,
 			range: token.range
@@ -146,6 +168,10 @@ function validateRefArgument(token, doc, options) {
 	}
 	return messages;
 }
+/**
+* Find all `@db.rel.FK` fields on a type that reference `targetTypeName`.
+* Resolves `extends` to include inherited fields.
+*/
 function findFKFieldsPointingTo(doc, iface, targetTypeName, alias) {
 	const results = [];
 	let struct;
@@ -153,7 +179,7 @@ function findFKFieldsPointingTo(doc, iface, targetTypeName, alias) {
 		const resolved = doc.resolveInterfaceExtends(iface);
 		if (resolved && isStructure(resolved)) struct = resolved;
 	}
-	if (!struct) struct = isStructure(iface) ? iface : isInterface(iface) && isStructure(iface.getDefinition()) ? iface.getDefinition() : undefined;
+	if (!struct) struct = isStructure(iface) ? iface : isInterface(iface) && isStructure(iface.getDefinition()) ? iface.getDefinition() : void 0;
 	if (!struct) return results;
 	for (const [name, prop] of struct.props) {
 		if (prop.countAnnotations("db.rel.FK") === 0) continue;
@@ -164,10 +190,8 @@ function findFKFieldsPointingTo(doc, iface, targetTypeName, alias) {
 		const refTypeName = ref.id;
 		const refField = ref.chain.map((c) => c.text).join(".");
 		if (refTypeName !== targetTypeName) continue;
-		if (alias !== undefined) {
-			const fkAnnotations = prop.annotations?.filter((a) => a.name === "db.rel.FK");
-			const hasMatchingAlias = fkAnnotations?.some((a) => a.args.length > 0 && a.args[0].text === alias);
-			if (!hasMatchingAlias) continue;
+		if (alias !== void 0) {
+			if (!(prop.annotations?.filter((a) => a.name === "db.rel.FK"))?.some((a) => a.args.length > 0 && a.args[0].text === alias)) continue;
 		}
 		results.push({
 			name,
@@ -187,9 +211,20 @@ const viewAnnotationNames = [
 	"db.view.filter",
 	"db.view.materialized"
 ];
+/**
+* Check if a node has any @db.view.* annotation.
+*/
 function hasAnyViewAnnotation(node) {
 	return viewAnnotationNames.some((name) => node.countAnnotations(name) > 0);
 }
+/**
+* Validate that all type refs in a query expression are within the allowed scope.
+*
+* @param queryToken - The query arg token (must have .queryNode)
+* @param allowedTypes - Type names allowed as qualified refs
+* @param unqualifiedTarget - Type name for resolving unqualified refs, or null to disallow them
+* @param doc - The document for type lookups
+*/
 function validateQueryScope(queryToken, allowedTypes, unqualifiedTarget, doc) {
 	const errors = [];
 	const queryNode = queryToken.queryNode;
@@ -207,7 +242,7 @@ function validateQueryScope(queryToken, allowedTypes, unqualifiedTarget, doc) {
 			severity: 1,
 			range: ref.fieldRef.range
 		});
-else {
+		else {
 			const unwound = doc.unwindType(unqualifiedTarget);
 			if (unwound) {
 				const targetDef = unwound.def;
@@ -224,7 +259,7 @@ else {
 	}
 	function walkExpr(expr) {
 		if (isQueryLogical(expr)) for (const operand of expr.operands) walkExpr(operand);
-else if (isQueryComparison(expr)) {
+		else if (isQueryComparison(expr)) {
 			walkFieldRef(expr.left);
 			if (expr.right && "fieldRef" in expr.right) walkFieldRef(expr.right);
 		}
@@ -232,6 +267,5 @@ else if (isQueryComparison(expr)) {
 	walkExpr(queryNode.expression);
 	return errors;
 }
-
 //#endregion
-export { findFKFieldsPointingTo, getAnnotationAlias, getDbTableOwner, getNavTargetTypeName, getParentStruct, getParentTypeName, hasAnyViewAnnotation, refActionAnnotation, validateFieldBaseType, validateQueryScope, validateRefArgument };
+export { getAnnotationAlias as a, getParentStruct as c, validateFieldBaseType as d, validateRefArgument as i, getParentTypeName as l, hasAnyViewAnnotation as n, getDbTableOwner as o, validateQueryScope as r, getNavTargetTypeName as s, findFKFieldsPointingTo as t, refActionAnnotation as u };