@atscript/typescript 0.1.30 → 0.1.32

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import path from "path";
-import { DEFAULT_FORMAT, isArray, isConst, isGroup, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
+import { DEFAULT_FORMAT, flattenInterfaceNode, isArray, isConst, isGroup, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
 
 //#region packages/typescript/src/codegen/code-printer.ts
 function _define_property$4(obj, key, value) {
@@ -116,6 +116,9 @@ else obj[key] = value;
 	return obj;
 }
 var BaseRenderer = class extends CodePrinter {
+	get unused() {
+		return this._unused ?? (this._unused = new Set(this.doc.getUnusedTokens().map((t) => t.text)));
+	}
 	pre() {}
 	post() {}
 	render() {
@@ -169,15 +172,14 @@ var BaseRenderer = class extends CodePrinter {
 		}
 	}
 	constructor(doc) {
-		super(), _define_property$3(this, "doc", void 0), _define_property$3(this, "unused", void 0), this.doc = doc;
-		this.unused = new Set(this.doc.getUnusedTokens().map((t) => t.text));
+		super(), _define_property$3(this, "doc", void 0), _define_property$3(this, "_unused", void 0), this.doc = doc;
 	}
 };
 
 //#endregion
 //#region packages/typescript/src/codegen/utils.ts
+const validIdentifier = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 function wrapProp(name) {
-	const validIdentifier = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 	if (!validIdentifier.test(name)) return `"${escapeQuotes(name)}"`;
 	return name;
 }
@@ -262,14 +264,16 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			if (isGrp) this.write(")");
 			return this.write("[]");
 		}
+		if (isPrimitive(def)) return this.write(renderPrimitiveTypeDef(def.config.type));
 	}
-	renderStructure(struct, asClass) {
+	renderStructure(struct, asClass, interfaceNode, filterProps) {
 		this.blockln("{}");
 		const patterns = [];
 		const propsDefs = new Set();
-		for (const prop of Array.from(struct.props.values())) {
+		for (const prop of struct.props.values()) {
+			if (filterProps?.has(prop.id)) continue;
 			if (prop.token("identifier")?.pattern) {
-				patterns.push(prop);
+				if (!filterProps) patterns.push(prop);
 				continue;
 			}
 			const phantomType = this.phantomPropType(prop.getDefinition());
@@ -285,33 +289,36 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 		}
 		if (patterns.length > 0) {
 			this.write(`[key: string]: `);
-			if (patterns.length > 0) {
-				for (const prop of patterns) propsDefs.add(this.renderTypeDefString(prop.getDefinition()));
-				const defs = Array.from(propsDefs);
-				if (defs.length > 1) {
-					this.indent();
-					for (const def of defs) {
-						this.writeln();
-						this.write("| ");
-						def.split("\n").forEach((l) => this.write(l.trim()));
-					}
-					this.unindent();
+			for (const prop of patterns) propsDefs.add(this.renderTypeDefString(prop.getDefinition()));
+			const defs = Array.from(propsDefs);
+			if (defs.length > 1) {
+				this.indent();
+				for (const def of defs) {
 					this.writeln();
-				} else defs[0].split("\n").forEach((l) => this.writeln(l));
-			}
-		}
-		if (asClass) {
-			this.writeln("static __is_atscript_annotated_type: true");
-			this.writeln(`static type: TAtscriptTypeObject<keyof ${asClass}, ${asClass}>`);
-			this.writeln(`static metadata: TMetadataMap<AtscriptMetadata>`);
-			this.writeln(`static validator: (opts?: Partial<TValidatorOptions>) => Validator<typeof ${asClass}>`);
-			if (resolveJsonSchemaMode(this.opts) === false) this.writeln("/** @deprecated JSON Schema support is disabled. Calling this method will throw a runtime error. To enable, set `jsonSchema: 'lazy'` or `jsonSchema: 'bundle'` in tsPlugin options, or add `@emit.jsonSchema` annotation to individual interfaces. */");
-			this.writeln("static toJsonSchema: () => any");
-			if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
-			this.writeln("static toExampleData?: () => any");
+					this.write("| ");
+					def.split("\n").forEach((l) => this.write(l.trim()));
+				}
+				this.unindent();
+				this.writeln();
+			} else defs[0].split("\n").forEach((l) => this.writeln(l));
 		}
+		if (asClass) this.renderStaticDeclarations(asClass, interfaceNode);
 		this.pop();
 	}
+	renderStaticDeclarations(asClass, interfaceNode) {
+		this.writeln("static __is_atscript_annotated_type: true");
+		this.writeln(`static type: TAtscriptTypeObject<keyof ${asClass}, ${asClass}>`);
+		this.writeln(`static metadata: TMetadataMap<AtscriptMetadata>`);
+		this.writeln(`static validator: (opts?: Partial<TValidatorOptions>) => Validator<typeof ${asClass}>`);
+		if (resolveJsonSchemaMode(this.opts) === false) this.writeln("/** @deprecated JSON Schema support is disabled. Calling this method will throw a runtime error. To enable, set `jsonSchema: 'lazy'` or `jsonSchema: 'bundle'` in tsPlugin options, or add `@emit.jsonSchema` annotation to individual interfaces. */");
+		this.writeln("static toJsonSchema: () => any");
+		if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
+		this.writeln("static toExampleData?: () => any");
+		if (interfaceNode && this.hasDbTable(interfaceNode)) {
+			this.renderFlat(interfaceNode);
+			this.renderPk(interfaceNode);
+		}
+	}
 	renderInterface(node) {
 		this.writeln();
 		const exported = node.token("export")?.text === "export";
@@ -335,44 +342,16 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 					}
 					if (!firstParentProps && isStructure(fpDef)) firstParentProps = fpDef.props;
 				}
-				this.renderStructureFiltered(resolved, node.id, firstParentProps);
+				this.renderStructure(resolved, node.id, node, firstParentProps);
 			} else this.writeln("{}");
 		} else {
 			this.write(`class ${node.id} `);
 			const struct = node.getDefinition();
-			if (struct?.entity === "structure") this.renderStructure(struct, node.id);
+			if (struct?.entity === "structure") this.renderStructure(struct, node.id, node);
 else this.writeln("{}");
 		}
 		this.writeln();
 	}
-	/**
-	* Renders a structure block, optionally filtering out props that exist in a parent.
-	*/ renderStructureFiltered(struct, asClass, filterProps) {
-		if (!filterProps) return this.renderStructure(struct, asClass);
-		this.blockln("{}");
-		for (const prop of Array.from(struct.props.values())) {
-			if (filterProps.has(prop.id)) continue;
-			if (prop.token("identifier")?.pattern) continue;
-			const phantomType = this.phantomPropType(prop.getDefinition());
-			if (phantomType) {
-				this.writeln(`// ${prop.id}: ${phantomType}`);
-				continue;
-			}
-			const optional = !!prop.token("optional");
-			this.write(wrapProp(prop.id), optional ? "?" : "", ": ");
-			const renderedDef = this.renderTypeDefString(prop.getDefinition());
-			renderedDef.split("\n").forEach((l) => this.writeln(l));
-		}
-		this.writeln("static __is_atscript_annotated_type: true");
-		this.writeln(`static type: TAtscriptTypeObject<keyof ${asClass}, ${asClass}>`);
-		this.writeln(`static metadata: TMetadataMap<AtscriptMetadata>`);
-		this.writeln(`static validator: (opts?: Partial<TValidatorOptions>) => Validator<typeof ${asClass}>`);
-		if (resolveJsonSchemaMode(this.opts) === false) this.writeln("/** @deprecated JSON Schema support is disabled. Calling this method will throw a runtime error. To enable, set `jsonSchema: 'lazy'` or `jsonSchema: 'bundle'` in tsPlugin options, or add `@emit.jsonSchema` annotation to individual interfaces. */");
-		this.writeln("static toJsonSchema: () => any");
-		if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
-		this.writeln("static toExampleData?: () => any");
-		this.pop();
-	}
 	renderType(node) {
 		this.writeln();
 		const exported = node.token("export")?.text === "export";
@@ -426,6 +405,87 @@ else if (isPrimitive(realDef)) typeDef = `TAtscriptTypeFinal<${name}>`;
 		this.writeln("const toExampleData: (() => any) | undefined");
 		this.popln();
 	}
+	/**
+	* Checks whether an interface has the `@db.table` annotation.
+	*
+	* NOTE: Only `@db.table` interfaces get the `__flat` static property.
+	* This is intentionally hardcoded — `__flat` exists solely to improve
+	* type-safety for filter expressions and `$select`/`$sort` operations
+	* in the DB layer. Non-DB interfaces have no use for dot-notation path types.
+	*/ hasDbTable(node) {
+		return !!node.annotations?.some((a) => a.name === "db.table");
+	}
+	/**
+	* Renders the `static __flat` property — a map of all dot-notation paths
+	* to their TypeScript value types.
+	*
+	* This enables type-safe autocomplete for filter keys and `$select`/`$sort`
+	* paths when using `AtscriptDbTable`. The `FlatOf<T>` utility type extracts
+	* this map at the type level.
+	*
+	* Special rendering rules:
+	* - **Intermediate paths** (structures, arrays of structures) → `never`
+	*   (prevents `$eq` comparisons, but allows `$select` and `$exists`)
+	* - **`@db.json` fields** → `string` (stored as serialized JSON in DB,
+	*   not individually queryable)
+	* - **Leaf fields** → their original TypeScript type
+	*/ renderFlat(node) {
+		const flatMap = flattenInterfaceNode(this.doc, node);
+		if (flatMap.size === 0) return;
+		this.write("static __flat: ");
+		this.blockln("{}");
+		for (const [path$1, descriptor] of flatMap) {
+			this.write(`"${escapeQuotes(path$1)}"`);
+			if (descriptor.optional) this.write("?");
+			this.write(": ");
+			if (descriptor.intermediate) this.writeln("never");
+else if (descriptor.dbJson) this.writeln("string");
+else {
+				const originalDef = descriptor.propNode?.getDefinition();
+				const defToRender = originalDef && !(isGroup(descriptor.def) && descriptor.def !== originalDef) ? originalDef : descriptor.def;
+				const renderedDef = this.renderTypeDefString(defToRender);
+				renderedDef.split("\n").forEach((l) => this.writeln(l));
+			}
+		}
+		this.pop();
+	}
+	/**
+	* Renders the `static __pk` property — the primary key type for type-safe
+	* `deleteOne`/`findById` signatures on `AtscriptDbTable`.
+	*
+	* - **Single PK** (one `@meta.id`) → `static __pk: <scalar type>`
+	* - **Compound PK** (multiple `@meta.id`) → `static __pk: { field1: Type1; field2: Type2 }`
+	* - **No PK** → no `__pk` emitted
+	*/ renderPk(node) {
+		let struct;
+		if (node.hasExtends) struct = this.doc.resolveInterfaceExtends(node);
+		if (!struct) struct = node.getDefinition();
+		if (!struct || !isStructure(struct)) return;
+		const pkProps = [];
+		for (const [name, prop] of struct.props) {
+			if (prop.token("identifier")?.pattern) continue;
+			if (prop.countAnnotations("meta.id") > 0) pkProps.push({
+				name,
+				prop
+			});
+		}
+		if (pkProps.length === 0) return;
+		this.writeln();
+		if (pkProps.length === 1) {
+			this.write("static __pk: ");
+			const renderedDef = this.renderTypeDefString(pkProps[0].prop.getDefinition());
+			renderedDef.split("\n").forEach((l) => this.writeln(l));
+		} else {
+			this.write("static __pk: ");
+			this.blockln("{}");
+			for (const { name, prop } of pkProps) {
+				this.write(wrapProp(name), ": ");
+				const renderedDef = this.renderTypeDefString(prop.getDefinition());
+				renderedDef.split("\n").forEach((l) => this.writeln(l));
+			}
+			this.pop();
+		}
+	}
 	phantomPropType(def) {
 		if (!def) return undefined;
 		if (isPrimitive(def) && def.config.type === "phantom") return def.id;
@@ -474,24 +534,6 @@ function renderPrimitiveTypeDef(def) {
 	}
 }
 
-//#endregion
-//#region packages/typescript/src/traverse.ts
-function forAnnotatedType(def, handlers) {
-	switch (def.type.kind) {
-		case "": {
-			const typed = def;
-			if (handlers.phantom && typed.type.designType === "phantom") return handlers.phantom(typed);
-			return handlers.final(typed);
-		}
-		case "object": return handlers.object(def);
-		case "array": return handlers.array(def);
-		case "union": return handlers.union(def);
-		case "intersection": return handlers.intersection(def);
-		case "tuple": return handlers.tuple(def);
-		default: throw new Error(`Unknown type kind "${def.type.kind}"`);
-	}
-}
-
 //#endregion
 //#region packages/typescript/src/validator.ts
 function _define_property$1(obj, key, value) {
@@ -507,28 +549,35 @@ else obj[key] = value;
 const regexCache = new Map();
 var Validator = class {
 	isLimitExceeded() {
-		if (this.stackErrors.length > 0) return this.stackErrors[this.stackErrors.length - 1].length >= this.opts.errorLimit;
+		if (this.stackErrors.length > 0) {
+			const top = this.stackErrors[this.stackErrors.length - 1];
+			return top !== null && top.length >= this.opts.errorLimit;
+		}
 		return this.errors.length >= this.opts.errorLimit;
 	}
 	push(name) {
 		this.stackPath.push(name);
-		this.stackErrors.push([]);
+		this.stackErrors.push(null);
+		this.cachedPath = this.stackPath.length <= 1 ? "" : this.stackPath[1] + (this.stackPath.length > 2 ? "." + this.stackPath.slice(2).join(".") : "");
 	}
 	pop(saveErrors) {
 		this.stackPath.pop();
 		const popped = this.stackErrors.pop();
-		if (saveErrors && popped?.length) popped.forEach((error) => {
-			this.error(error.message, error.path, error.details);
-		});
+		if (saveErrors && popped !== null && popped !== undefined && popped.length > 0) for (const err of popped) this.error(err.message, err.path, err.details);
+		this.cachedPath = this.stackPath.length <= 1 ? "" : this.stackPath[1] + (this.stackPath.length > 2 ? "." + this.stackPath.slice(2).join(".") : "");
 		return popped;
 	}
 	clear() {
-		this.stackErrors[this.stackErrors.length - 1] = [];
+		this.stackErrors[this.stackErrors.length - 1] = null;
 	}
 	error(message, path$1, details) {
-		const errors = this.stackErrors[this.stackErrors.length - 1] || this.errors;
+		let errors = this.stackErrors[this.stackErrors.length - 1];
+		if (!errors) if (this.stackErrors.length > 0) {
+			errors = [];
+			this.stackErrors[this.stackErrors.length - 1] = errors;
+		} else errors = this.errors;
 		const error = {
-			path: path$1 || this.path,
+			path: path$1 || this.cachedPath,
 			message
 		};
 		if (details?.length) error.details = details;
@@ -548,9 +597,10 @@ var Validator = class {
 	* @returns `true` if the value matches the type definition.
 	* @throws {ValidatorError} When validation fails and `safe` is not `true`.
 	*/ validate(value, safe, context) {
-		this.push("");
 		this.errors = [];
 		this.stackErrors = [];
+		this.stackPath = [""];
+		this.cachedPath = "";
 		this.context = context;
 		const passed = this.validateSafe(this.def, value);
 		this.pop(!passed);
@@ -564,7 +614,7 @@ var Validator = class {
 	validateSafe(def, value) {
 		if (this.isLimitExceeded()) return false;
 		if (!isAnnotatedType(def)) throw new Error("Can not validate not-annotated type");
-		if (typeof this.opts.replace === "function") def = this.opts.replace(def, this.path);
+		if (typeof this.opts.replace === "function") def = this.opts.replace(def, this.cachedPath);
 		if (def.optional && value === undefined) return true;
 		for (const plugin of this.opts.plugins) {
 			const result = plugin(this, def, value);
@@ -573,18 +623,21 @@ var Validator = class {
 		return this.validateAnnotatedType(def, value);
 	}
 	get path() {
-		return this.stackPath.slice(1).join(".");
+		return this.cachedPath;
 	}
 	validateAnnotatedType(def, value) {
-		return forAnnotatedType(def, {
-			final: (d) => this.validatePrimitive(d, value),
-			phantom: () => true,
-			object: (d) => this.validateObject(d, value),
-			array: (d) => this.validateArray(d, value),
-			union: (d) => this.validateUnion(d, value),
-			intersection: (d) => this.validateIntersection(d, value),
-			tuple: (d) => this.validateTuple(d, value)
-		});
+		switch (def.type.kind) {
+			case "": {
+				if (def.type.designType === "phantom") return true;
+				return this.validatePrimitive(def, value);
+			}
+			case "object": return this.validateObject(def, value);
+			case "array": return this.validateArray(def, value);
+			case "union": return this.validateUnion(def, value);
+			case "intersection": return this.validateIntersection(def, value);
+			case "tuple": return this.validateTuple(def, value);
+			default: throw new Error(`Unknown type kind "${def.type.kind}"`);
+		}
 	}
 	validateUnion(def, value) {
 		let i = 0;
@@ -648,6 +701,30 @@ var Validator = class {
 				return false;
 			}
 		}
+		const uniqueItems = def.metadata.get("expect.array.uniqueItems");
+		if (uniqueItems) {
+			const separator = "▼↩";
+			const seen = new Set();
+			const keyProps = new Set();
+			if (def.type.of.type.kind === "object") {
+				for (const [key, val] of def.type.of.type.props.entries()) if (val.metadata.get("expect.array.key")) keyProps.add(key);
+			}
+			for (let idx = 0; idx < value.length; idx++) {
+				const item = value[idx];
+				let key;
+				if (keyProps.size > 0) {
+					key = "";
+					for (const prop of keyProps) key += JSON.stringify(item[prop]) + separator;
+				} else key = JSON.stringify(item);
+				if (seen.has(key)) {
+					this.push(String(idx));
+					this.error(uniqueItems.message || "Duplicate items are not allowed");
+					this.pop(true);
+					return false;
+				}
+				seen.add(key);
+			}
+		}
 		let i = 0;
 		let passed = true;
 		for (const item of value) {
@@ -669,21 +746,20 @@ var Validator = class {
 		let passed = true;
 		const valueKeys = new Set(Object.keys(value));
 		const typeKeys = new Set();
-		const skipList = new Set();
+		let skipList;
 		if (this.opts.skipList) {
-			const path$1 = this.stackPath.length > 1 ? `${this.path}.` : "";
-			this.opts.skipList.forEach((item) => {
-				if (item.startsWith(path$1)) {
-					const key = item.slice(path$1.length);
-					skipList.add(key);
-					valueKeys.delete(key);
-				}
-			});
+			const path$1 = this.stackPath.length > 1 ? `${this.cachedPath}.` : "";
+			for (const item of this.opts.skipList) if (item.startsWith(path$1)) {
+				const key = item.slice(path$1.length);
+				if (!skipList) skipList = new Set();
+				skipList.add(key);
+				valueKeys.delete(key);
+			}
 		}
 		let partialFunctionMatched = false;
-		if (typeof this.opts.partial === "function") partialFunctionMatched = this.opts.partial(def, this.path);
+		if (typeof this.opts.partial === "function") partialFunctionMatched = this.opts.partial(def, this.cachedPath);
 		for (const [key, item] of def.type.props.entries()) {
-			if (skipList.has(key) || isPhantomType(item)) continue;
+			if (skipList && skipList.has(key) || isPhantomType(item)) continue;
 			typeKeys.add(key);
 			if (value[key] === undefined) {
 				if (partialFunctionMatched || this.opts.partial === "deep" || this.opts.partial === true && this.stackPath.length <= 1) continue;
@@ -704,19 +780,21 @@ else {
 				def: propDef
 			});
 			if (matched.length > 0) {
+				this.push(key);
 				let keyPassed = false;
-				for (const { def: def$1 } of matched) if (this.validateSafe(def$1, value[key])) {
-					this.pop(false);
-					keyPassed = true;
-					break;
+				for (const { def: propDef } of matched) {
+					if (this.validateSafe(propDef, value[key])) {
+						keyPassed = true;
+						break;
+					}
+					this.clear();
 				}
 				if (!keyPassed) {
-					this.push(key);
 					this.validateSafe(matched[0].def, value[key]);
 					this.pop(true);
 					passed = false;
 					if (this.isLimitExceeded()) return false;
-				}
+				} else this.pop(false);
 			} else if (this.opts.unknownProps !== "ignore") {
 				if (this.opts.unknownProps === "error") {
 					this.push(key);
@@ -869,11 +947,13 @@ else {
 		/** Validation errors collected during the last {@link validate} call. */ _define_property$1(this, "errors", void 0);
 		_define_property$1(this, "stackErrors", void 0);
 		_define_property$1(this, "stackPath", void 0);
+		_define_property$1(this, "cachedPath", void 0);
 		_define_property$1(this, "context", void 0);
 		this.def = def;
 		this.errors = [];
 		this.stackErrors = [];
 		this.stackPath = [];
+		this.cachedPath = "";
 		this.opts = {
 			partial: false,
 			unknownProps: "error",
@@ -1017,6 +1097,24 @@ function isPhantomType(def) {
 	return def.type.kind === "" && def.type.designType === "phantom";
 }
 
+//#endregion
+//#region packages/typescript/src/traverse.ts
+function forAnnotatedType(def, handlers) {
+	switch (def.type.kind) {
+		case "": {
+			const typed = def;
+			if (handlers.phantom && typed.type.designType === "phantom") return handlers.phantom(typed);
+			return handlers.final(typed);
+		}
+		case "object": return handlers.object(def);
+		case "array": return handlers.array(def);
+		case "union": return handlers.union(def);
+		case "intersection": return handlers.intersection(def);
+		case "tuple": return handlers.tuple(def);
+		default: throw new Error(`Unknown type kind "${def.type.kind}"`);
+	}
+}
+
 //#endregion
 //#region packages/typescript/src/json-schema.ts
 /**
@@ -1189,24 +1287,25 @@ var JsRenderer = class extends BaseRenderer {
 		this.writeln("// prettier-ignore-start");
 		this.writeln("/* eslint-disable */");
 		this.writeln("/* oxlint-disable */");
+		let hasMutatingAnnotate = false;
+		const nodesByName = new Map();
+		for (const node of this.doc.nodes) {
+			if (node.entity === "annotate" && node.isMutating) hasMutatingAnnotate = true;
+			if (node.__typeId !== null && node.__typeId !== undefined && node.id) {
+				const name = node.id;
+				if (!nodesByName.has(name)) nodesByName.set(name, []);
+				nodesByName.get(name).push(node);
+			}
+		}
+		for (const [name, nodes] of nodesByName) if (nodes.length === 1) this.typeIds.set(nodes[0], name);
+else for (let i = 0; i < nodes.length; i++) this.typeIds.set(nodes[i], `${name}__${i + 1}`);
 		const imports = ["defineAnnotatedType as $", "annotate as $a"];
-		const hasMutatingAnnotate = this.doc.nodes.some((n) => n.entity === "annotate" && n.isMutating);
 		if (hasMutatingAnnotate) imports.push("cloneRefProp as $c");
 		const jsonSchemaMode = resolveJsonSchemaMode(this.opts);
 		if (jsonSchemaMode === "lazy") imports.push("buildJsonSchema as $$");
 		if (this.opts?.exampleData) imports.push("createDataFromAnnotatedType as $e");
 		if (jsonSchemaMode === false) imports.push("throwFeatureDisabled as $d");
 		this.writeln(`import { ${imports.join(", ")} } from "@atscript/typescript/utils"`);
-		const nameCounts = new Map();
-		const nodesByName = new Map();
-		for (const node of this.doc.nodes) if (node.__typeId !== null && node.__typeId !== undefined && node.id) {
-			const name = node.id;
-			nameCounts.set(name, (nameCounts.get(name) || 0) + 1);
-			if (!nodesByName.has(name)) nodesByName.set(name, []);
-			nodesByName.get(name).push(node);
-		}
-		for (const [name, nodes] of nodesByName) if (nodes.length === 1) this.typeIds.set(nodes[0], name);
-else for (let i = 0; i < nodes.length; i++) this.typeIds.set(nodes[i], `${name}__${i + 1}`);
 	}
 	buildAdHocMap(annotateNodes) {
 		const map = new Map();
@@ -1215,7 +1314,8 @@ else for (let i = 0; i < nodes.length; i++) this.typeIds.set(nodes[i], `${name}_
 			const anns = entry.annotations || [];
 			if (anns.length > 0) {
 				const existing = map.get(path$1);
-				map.set(path$1, existing ? [...existing, ...anns] : anns);
+				if (existing) existing.push(...anns);
+else map.set(path$1, [...anns]);
 			}
 		}
 		return map.size > 0 ? map : null;
@@ -1274,35 +1374,20 @@ else def = def.getDefinition() || def;
 		this.renderExampleDataMethod(node);
 	}
 	renderInterface(node) {
-		this.writeln();
-		const exported = node.token("export")?.text === "export";
-		this.write(exported ? "export " : "");
-		this.write(`class ${node.id} `);
-		this.blockln("{}");
-		this.renderClassStatics(node);
-		this.popln();
-		this.postAnnotate.push(node);
-		this.writeln();
+		this.renderDefinitionClass(node);
 	}
 	renderType(node) {
-		this.writeln();
-		const exported = node.token("export")?.text === "export";
-		this.write(exported ? "export " : "");
-		this.write(`class ${node.id} `);
-		this.blockln("{}");
-		this.renderClassStatics(node);
-		this.popln();
-		this.postAnnotate.push(node);
-		this.writeln();
+		this.renderDefinitionClass(node);
 	}
 	renderAnnotate(node) {
 		if (node.isMutating) {
 			this.postAnnotate.push(node);
 			return;
 		}
-		const targetName = node.targetName;
-		const unwound = this.doc.unwindType(targetName);
-		if (!unwound?.def) return;
+		if (!this.doc.unwindType(node.targetName)?.def) return;
+		this.renderDefinitionClass(node);
+	}
+	renderDefinitionClass(node) {
 		this.writeln();
 		const exported = node.token("export")?.text === "export";
 		this.write(exported ? "export " : "");
@@ -1460,6 +1545,11 @@ else handle.prop(prop.id, propHandle.$type);
 					handle.annotate(a.name, true);
 					break;
 				}
+				case "expect.array.uniqueItems":
+				case "expect.array.key": {
+					handle.annotate(a.name, { message: a.args[0]?.text });
+					break;
+				}
 				default:
 			}
 		});
@@ -1527,10 +1617,7 @@ else handle.prop(prop.id, propHandle.$type);
 				this.writeln(`$("array"${name ? `, ${name}` : ""})`).indent().defineArray(node).unindent();
 				return this;
 			}
-			default: {
-				console.log("!!!!!!! UNKNOWN", node.entity);
-				return this;
-			}
+			default: return this;
 		}
 	}
 	defineConst(node) {
@@ -1742,40 +1829,25 @@ else targetValue = "true";
 				this.writeln(`$c(${clone.parentPath}, "${escapeQuotes(clone.propName)}")`);
 			}
 		}
-		for (const { entry, accessors } of entryAccessors) {
-			const anns = entry.annotations;
-			for (const accessor of accessors) {
-				const cleared = new Set();
-				for (const an of anns) {
-					const { value, multiple } = this.computeAnnotationValue(entry, an);
-					if (multiple) {
-						if (!cleared.has(an.name)) {
-							const spec = this.doc.resolveAnnotation(an.name);
-							if (!spec || spec.config.mergeStrategy !== "append") this.writeln(`${accessor}.metadata.delete("${escapeQuotes(an.name)}")`);
-							cleared.add(an.name);
-						}
-						this.writeln(`$a(${accessor}.metadata, "${escapeQuotes(an.name)}", ${value}, true)`);
-					} else this.writeln(`$a(${accessor}.metadata, "${escapeQuotes(an.name)}", ${value})`);
-				}
-			}
-		}
+		for (const { entry, accessors } of entryAccessors) for (const accessor of accessors) this.emitMutatingAnnotations(entry, entry.annotations, accessor);
 		const topAnnotations = node.annotations;
-		if (topAnnotations && topAnnotations.length > 0) {
-			const cleared = new Set();
-			for (const an of topAnnotations) {
-				const { value, multiple } = this.computeAnnotationValue(node, an);
-				if (multiple) {
-					if (!cleared.has(an.name)) {
-						const spec = this.doc.resolveAnnotation(an.name);
-						if (!spec || spec.config.mergeStrategy !== "append") this.writeln(`${targetName}.metadata.delete("${escapeQuotes(an.name)}")`);
-						cleared.add(an.name);
-					}
-					this.writeln(`$a(${targetName}.metadata, "${escapeQuotes(an.name)}", ${value}, true)`);
-				} else this.writeln(`$a(${targetName}.metadata, "${escapeQuotes(an.name)}", ${value})`);
-			}
-		}
+		if (topAnnotations && topAnnotations.length > 0) this.emitMutatingAnnotations(node, topAnnotations, targetName);
 		this.writeln();
 	}
+	emitMutatingAnnotations(node, annotations, accessor) {
+		const cleared = new Set();
+		for (const an of annotations) {
+			const { value, multiple } = this.computeAnnotationValue(node, an);
+			if (multiple) {
+				if (!cleared.has(an.name)) {
+					const spec = this.doc.resolveAnnotation(an.name);
+					if (!spec || spec.config.mergeStrategy !== "append") this.writeln(`${accessor}.metadata.delete("${escapeQuotes(an.name)}")`);
+					cleared.add(an.name);
+				}
+				this.writeln(`$a(${accessor}.metadata, "${escapeQuotes(an.name)}", ${value}, true)`);
+			} else this.writeln(`$a(${accessor}.metadata, "${escapeQuotes(an.name)}", ${value})`);
+		}
+	}
 	resolveTargetDef(targetName) {
 		const unwound = this.doc.unwindType(targetName);
 		if (!unwound?.def) return undefined;