@atscript/db-mongo 0.1.102 → 0.1.103

package/dist/index-Bl_O47fp.d.cts

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

package/dist/index-Bl_O47fp.d.mts

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

package/dist/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_mongo_filter = require("./mongo-filter-1EpqdD-T.cjs");
+const require_plugin = require("./plugin-Bq6hZMBA.cjs");
 let _atscript_db = require("@atscript/db");
 let mongodb = require("mongodb");
 //#region src/lib/projection-dedupe.ts
@@ -2163,6 +2164,7 @@ function createAdapter(connection, _options) {
 //#endregion
 exports.CollectionPatcher = CollectionPatcher;
 exports.MongoAdapter = MongoAdapter;
+exports.MongoPlugin = require_plugin.MongoPlugin;
 exports.buildMongoFilter = require_mongo_filter.buildMongoFilter;
 exports.createAdapter = createAdapter;
 exports.validateMongoIdPlugin = validateMongoIdPlugin;

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { t as MongoPlugin } from "./index-Bl_O47fp.cjs";
 import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbForeignKey, TDbInsertManyResult, TDbInsertResult, TDbRelation, TDbUpdateResult, TExistingTableOption, TFieldOps, TMetadataOverrides, TSearchIndexInfo, TSyncColumnResult, TTableResolver, TableMetadata, WithRelation, getKeyProps } from "@atscript/db";
 import { AggregationCursor, ClientSession, Collection, Db, Document, Filter, MongoClient, ObjectId, UpdateFilter, UpdateOptions } from "mongodb";
 import { TAtscriptAnnotatedType, TMetadataMap, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
@@ -407,4 +408,4 @@ declare const validateMongoIdPlugin: TValidatorPlugin;
 //#region src/lib/index.d.ts
 declare function createAdapter(connection: string, _options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { CollectionPatcher, MongoAdapter, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };
+export { CollectionPatcher, MongoAdapter, MongoPlugin, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { t as MongoPlugin } from "./index-Bl_O47fp.mjs";
 import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDeleteResult, TDbFieldMeta, TDbForeignKey, TDbInsertManyResult, TDbInsertResult, TDbRelation, TDbUpdateResult, TExistingTableOption, TFieldOps, TMetadataOverrides, TSearchIndexInfo, TSyncColumnResult, TTableResolver, TableMetadata, WithRelation, getKeyProps } from "@atscript/db";
 import { AggregationCursor, ClientSession, Collection, Db, Document, Filter, MongoClient, ObjectId, UpdateFilter, UpdateOptions } from "mongodb";
 import { TAtscriptAnnotatedType, TMetadataMap, TValidatorOptions, TValidatorPlugin, Validator } from "@atscript/typescript/utils";
@@ -407,4 +408,4 @@ declare const validateMongoIdPlugin: TValidatorPlugin;
 //#region src/lib/index.d.ts
 declare function createAdapter(connection: string, _options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { CollectionPatcher, MongoAdapter, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };
+export { CollectionPatcher, MongoAdapter, MongoPlugin, TCollectionPatcherContext, type TMongoIndex, type TMongoSearchIndexDefinition, type TPlainIndex, type TSearchIndex, buildMongoFilter, createAdapter, validateMongoIdPlugin };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { t as buildMongoFilter } from "./mongo-filter-DBYaF9aH.mjs";
+import { t as MongoPlugin } from "./plugin-KVFAwoGw.mjs";
 import { AtscriptDbView, BaseDbAdapter, DbError, DbSpace, computeInsights, getDbFieldOp, getKeyProps, resolveDesignType } from "@atscript/db";
 import { MongoClient, MongoServerError, ObjectId } from "mongodb";
 //#region src/lib/projection-dedupe.ts
@@ -2160,4 +2161,4 @@ function createAdapter(connection, _options) {
 	return new DbSpace(() => new MongoAdapter(db, client));
 }
 //#endregion
-export { CollectionPatcher, MongoAdapter, buildMongoFilter, createAdapter, validateMongoIdPlugin };
+export { CollectionPatcher, MongoAdapter, MongoPlugin, buildMongoFilter, createAdapter, validateMongoIdPlugin };

package/dist/plugin-Bq6hZMBA.cjs

@@ -0,0 +1,242 @@
+let _atscript_core = require("@atscript/core");
+//#region src/plugin/annotations.ts
+const analyzers = [
+	"lucene.standard",
+	"lucene.simple",
+	"lucene.whitespace",
+	"lucene.english",
+	"lucene.french",
+	"lucene.german",
+	"lucene.italian",
+	"lucene.portuguese",
+	"lucene.spanish",
+	"lucene.chinese",
+	"lucene.hindi",
+	"lucene.bengali",
+	"lucene.russian",
+	"lucene.arabic"
+];
+const tokenizations = [
+	"edgeGram",
+	"rightEdgeGram",
+	"nGram"
+];
+const searchStrategies = [
+	"compound",
+	"autocomplete",
+	"text"
+];
+const strategyDescription = "How `search()` matches a term against this index. Locks the query shape into the index — there is no query-time mode switching.\n\n- `compound` (default) → rank exact-word hits above prefix hits: a wildcard `text` clause **plus** one `autocomplete` clause per autocomplete field. Degrades to plain `text` when the index has no autocomplete field.\n- `autocomplete` → **prefix/typeahead only** — query just the autocomplete fields, no word-match ranking clause.\n- `text` → **word matching only** — a single `text` operator over all string-mapped fields (autocomplete fields are matched via their companion `string` mapping).\n\nTo use the same data with a different strategy, declare a second index and select it per request with `$index`.";
+const fuzzyDescription = "Maximum typo tolerance, applied **at query time** to the search operator.\n\n- `0` (default) → no fuzzy matching (exact tokens).\n- `1` → allows small typos (e.g., `\"mongo\"` ≈ `\"mango\"`).\n- `2` → more typo tolerance (e.g., `\"mongodb\"` ≈ `\"mangodb\"`).\n\nAtlas only accepts an edit distance of `1` or `2`; `0` simply disables fuzzy. Can be overridden per request via the `$fuzzy` query control.";
+/**
+* MongoDB-specific annotations.
+*
+* Merged into the global config under `{ db: { mongo: ... } }` so they
+* live alongside core's `@db.table`, `@db.index.*`, etc.
+*
+* Annotations removed (now in core):
+* - `@mongo.index.plain` → use `@db.index.plain`
+* - `@mongo.index.unique` → use `@db.index.unique`
+* - `@db.mongo.index.text` → use `@db.index.fulltext` (with optional weight arg)
+* - `@db.mongo.patch.strategy` → use `@db.patch.strategy`
+* - `@db.mongo.array.uniqueItems` → use `@expect.array.uniqueItems`
+* - `@db.mongo.autoIndexes` → removed (use explicit syncIndexes() calls)
+* - `@db.mongo.search.vector` → use `@db.search.vector` (generic, in @atscript/db/plugin)
+* - `@db.mongo.search.filter` → use `@db.search.filter` (generic, in @atscript/db/plugin)
+*/
+const annotations = {
+	collection: new _atscript_core.AnnotationSpec({
+		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
+		nodeType: ["interface"],
+		validate(token, args, doc) {
+			const parent = token.parentNode;
+			const struc = parent?.getDefinition();
+			const errors = [];
+			if ((0, _atscript_core.isInterface)(parent) && parent.props.has("_id") && (0, _atscript_core.isStructure)(struc)) {
+				const _id = parent.props.get("_id");
+				if (!!_id.token("optional")) errors.push({
+					message: `[db.mongo] _id can't be optional in Mongo Collection`,
+					severity: 1,
+					range: _id.token("identifier").range
+				});
+				const definition = _id.getDefinition();
+				if (!definition) return errors;
+				let wrongType = false;
+				if ((0, _atscript_core.isRef)(definition)) {
+					const def = doc.unwindType(definition.id, definition.chain)?.def;
+					if ((0, _atscript_core.isPrimitive)(def) && !["string", "number"].includes(def.config.type)) wrongType = true;
+				} else wrongType = true;
+				if (wrongType) errors.push({
+					message: `[db.mongo] _id must be of type string, number or mongo.objectId`,
+					severity: 1,
+					range: _id.token("identifier").range
+				});
+			}
+			return errors;
+		},
+		modify(token, _args, _doc) {
+			const parent = token.parentNode;
+			const struc = parent?.getDefinition();
+			if ((0, _atscript_core.isInterface)(parent) && !parent.props.has("_id") && (0, _atscript_core.isStructure)(struc)) struc.addVirtualProp({
+				name: "_id",
+				type: "mongo.objectId",
+				documentation: "Mongodb Primary Key ObjectId"
+			});
+		}
+	}),
+	capped: new _atscript_core.AnnotationSpec({
+		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
+		nodeType: ["interface"],
+		multiple: false,
+		argument: [{
+			optional: false,
+			name: "size",
+			type: "number",
+			description: "Maximum size of the collection in **bytes**."
+		}, {
+			optional: true,
+			name: "max",
+			type: "number",
+			description: "Maximum number of documents in the collection. If omitted, only the byte size limit applies."
+		}]
+	}),
+	search: {
+		dynamic: new _atscript_core.AnnotationSpec({
+			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
+			nodeType: ["interface"],
+			multiple: false,
+			argument: [{
+				optional: true,
+				name: "analyzer",
+				type: "string",
+				description: "The **text analyzer** for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, etc.",
+				values: analyzers
+			}, {
+				optional: true,
+				name: "fuzzy",
+				type: "number",
+				description: fuzzyDescription
+			}]
+		}),
+		static: new _atscript_core.AnnotationSpec({
+			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
+			nodeType: ["interface"],
+			multiple: true,
+			argument: [
+				{
+					optional: true,
+					name: "analyzer",
+					type: "string",
+					description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
+					values: analyzers
+				},
+				{
+					optional: true,
+					name: "fuzzy",
+					type: "number",
+					description: fuzzyDescription
+				},
+				{
+					optional: true,
+					name: "indexName",
+					type: "string",
+					description: "The name of the search index. Fields must reference this name using `@db.mongo.search.text` or `@db.mongo.search.autocomplete`. If not set, defaults to `\"DEFAULT\"`."
+				},
+				{
+					optional: true,
+					name: "strategy",
+					type: "string",
+					description: strategyDescription,
+					values: searchStrategies
+				}
+			]
+		}),
+		text: new _atscript_core.AnnotationSpec({
+			description: "Marks a field to be **included in a MongoDB Atlas Search Index** defined by `@db.mongo.search.static`.\n\n- **The field has to reference an existing search index name**.\n- If index name is not defined, a new search index with default attributes will be created.\n\n**Example:**\n```atscript\n@db.mongo.search.text \"lucene.english\", \"mySearchIndex\"\nfirstName: string\n```\n",
+			nodeType: ["prop"],
+			multiple: true,
+			argument: [{
+				optional: true,
+				name: "analyzer",
+				type: "string",
+				description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
+				values: analyzers
+			}, {
+				optional: true,
+				name: "indexName",
+				type: "string",
+				description: "The **name of the search index** defined in `@db.mongo.search.static`. This links the field to the correct index. If not set, defaults to `\"DEFAULT\"`."
+			}]
+		}),
+		autocomplete: new _atscript_core.AnnotationSpec({
+			description: "Marks a field for **prefix / typeahead (as-you-type)** matching in a MongoDB Atlas Search Index.\n\n- Indexes the field as the Atlas **`autocomplete`** type, **and** double-maps it as `string` so exact-word hits still rank.\n- Lets `search()` match partial words: with the default `edgeGram` tokenization, `\"art\"` matches `\"Artem\"` **as you type** (no whole word required).\n- Use `nGram` tokenization for true mid-word (infix/substring) matching at higher index cost.\n- Like `@db.mongo.search.text`, the field joins the index named by `indexName` (or the default index).\n\n**Example:**\n```atscript\n@db.mongo.search.autocomplete \"users\"\nusername: string\n```\n",
+			nodeType: ["prop"],
+			multiple: true,
+			argument: [
+				{
+					optional: true,
+					name: "indexName",
+					type: "string",
+					description: "The **name of the search index** (defined by `@db.mongo.search.static`) this field joins. If not set, defaults to `\"DEFAULT\"`."
+				},
+				{
+					optional: true,
+					name: "tokenization",
+					type: "string",
+					description: "How the field is tokenized for partial matching:\n\n- `\"edgeGram\"` (default) → **prefix** matching from the start of each word (`\"art\"` → `\"Artem\"`).\n- `\"nGram\"` → **substring/infix** matching anywhere inside a word (`\"tem\"` → `\"Artem\"`); larger index, slower builds.\n- `\"rightEdgeGram\"` → **suffix** matching from the end of each word.",
+					values: tokenizations
+				},
+				{
+					optional: true,
+					name: "minGrams",
+					type: "number",
+					description: "Minimum number of characters per indexed sequence. Defaults to `2`."
+				},
+				{
+					optional: true,
+					name: "maxGrams",
+					type: "number",
+					description: "Maximum number of characters per indexed sequence. Defaults to `15`."
+				},
+				{
+					optional: true,
+					name: "foldDiacritics",
+					type: "boolean",
+					description: "Whether to fold (ignore) diacritics so `\"café\"` matches `\"cafe\"`. Defaults to `true`."
+				},
+				{
+					optional: true,
+					name: "analyzer",
+					type: "string",
+					description: "The text analyzer for the companion `string` mapping. Defaults to `\"lucene.standard\"`.",
+					values: analyzers
+				}
+			]
+		})
+	}
+};
+//#endregion
+//#region src/plugin/primitives.ts
+const primitives = { mongo: { extensions: { objectId: {
+	type: "string",
+	documentation: "Represents a **MongoDB ObjectId**.\n\n- Stored as a **string** but can be converted to an ObjectId at runtime.\n- Useful for handling `_id` fields and queries that require ObjectId conversion.\n- Automatically converts string `_id` values into **MongoDB ObjectId** when needed.\n\n**Example:**\n```atscript\nuserId: mongo.objectId\n```\n",
+	annotations: { "expect.pattern": { pattern: "^[a-fA-F0-9]{24}$" } }
+} } } };
+//#endregion
+//#region src/plugin/index.ts
+const MongoPlugin = () => ({
+	name: "mongo",
+	config() {
+		return {
+			primitives,
+			annotations: { db: { mongo: annotations } }
+		};
+	}
+});
+//#endregion
+Object.defineProperty(exports, "MongoPlugin", {
+	enumerable: true,
+	get: function() {
+		return MongoPlugin;
+	}
+});

package/dist/plugin-KVFAwoGw.mjs

@@ -0,0 +1,237 @@
+import { AnnotationSpec, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
+//#region src/plugin/annotations.ts
+const analyzers = [
+	"lucene.standard",
+	"lucene.simple",
+	"lucene.whitespace",
+	"lucene.english",
+	"lucene.french",
+	"lucene.german",
+	"lucene.italian",
+	"lucene.portuguese",
+	"lucene.spanish",
+	"lucene.chinese",
+	"lucene.hindi",
+	"lucene.bengali",
+	"lucene.russian",
+	"lucene.arabic"
+];
+const tokenizations = [
+	"edgeGram",
+	"rightEdgeGram",
+	"nGram"
+];
+const searchStrategies = [
+	"compound",
+	"autocomplete",
+	"text"
+];
+const strategyDescription = "How `search()` matches a term against this index. Locks the query shape into the index — there is no query-time mode switching.\n\n- `compound` (default) → rank exact-word hits above prefix hits: a wildcard `text` clause **plus** one `autocomplete` clause per autocomplete field. Degrades to plain `text` when the index has no autocomplete field.\n- `autocomplete` → **prefix/typeahead only** — query just the autocomplete fields, no word-match ranking clause.\n- `text` → **word matching only** — a single `text` operator over all string-mapped fields (autocomplete fields are matched via their companion `string` mapping).\n\nTo use the same data with a different strategy, declare a second index and select it per request with `$index`.";
+const fuzzyDescription = "Maximum typo tolerance, applied **at query time** to the search operator.\n\n- `0` (default) → no fuzzy matching (exact tokens).\n- `1` → allows small typos (e.g., `\"mongo\"` ≈ `\"mango\"`).\n- `2` → more typo tolerance (e.g., `\"mongodb\"` ≈ `\"mangodb\"`).\n\nAtlas only accepts an edit distance of `1` or `2`; `0` simply disables fuzzy. Can be overridden per request via the `$fuzzy` query control.";
+/**
+* MongoDB-specific annotations.
+*
+* Merged into the global config under `{ db: { mongo: ... } }` so they
+* live alongside core's `@db.table`, `@db.index.*`, etc.
+*
+* Annotations removed (now in core):
+* - `@mongo.index.plain` → use `@db.index.plain`
+* - `@mongo.index.unique` → use `@db.index.unique`
+* - `@db.mongo.index.text` → use `@db.index.fulltext` (with optional weight arg)
+* - `@db.mongo.patch.strategy` → use `@db.patch.strategy`
+* - `@db.mongo.array.uniqueItems` → use `@expect.array.uniqueItems`
+* - `@db.mongo.autoIndexes` → removed (use explicit syncIndexes() calls)
+* - `@db.mongo.search.vector` → use `@db.search.vector` (generic, in @atscript/db/plugin)
+* - `@db.mongo.search.filter` → use `@db.search.filter` (generic, in @atscript/db/plugin)
+*/
+const annotations = {
+	collection: new AnnotationSpec({
+		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
+		nodeType: ["interface"],
+		validate(token, args, doc) {
+			const parent = token.parentNode;
+			const struc = parent?.getDefinition();
+			const errors = [];
+			if (isInterface(parent) && parent.props.has("_id") && isStructure(struc)) {
+				const _id = parent.props.get("_id");
+				if (!!_id.token("optional")) errors.push({
+					message: `[db.mongo] _id can't be optional in Mongo Collection`,
+					severity: 1,
+					range: _id.token("identifier").range
+				});
+				const definition = _id.getDefinition();
+				if (!definition) return errors;
+				let wrongType = false;
+				if (isRef(definition)) {
+					const def = doc.unwindType(definition.id, definition.chain)?.def;
+					if (isPrimitive(def) && !["string", "number"].includes(def.config.type)) wrongType = true;
+				} else wrongType = true;
+				if (wrongType) errors.push({
+					message: `[db.mongo] _id must be of type string, number or mongo.objectId`,
+					severity: 1,
+					range: _id.token("identifier").range
+				});
+			}
+			return errors;
+		},
+		modify(token, _args, _doc) {
+			const parent = token.parentNode;
+			const struc = parent?.getDefinition();
+			if (isInterface(parent) && !parent.props.has("_id") && isStructure(struc)) struc.addVirtualProp({
+				name: "_id",
+				type: "mongo.objectId",
+				documentation: "Mongodb Primary Key ObjectId"
+			});
+		}
+	}),
+	capped: new AnnotationSpec({
+		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
+		nodeType: ["interface"],
+		multiple: false,
+		argument: [{
+			optional: false,
+			name: "size",
+			type: "number",
+			description: "Maximum size of the collection in **bytes**."
+		}, {
+			optional: true,
+			name: "max",
+			type: "number",
+			description: "Maximum number of documents in the collection. If omitted, only the byte size limit applies."
+		}]
+	}),
+	search: {
+		dynamic: new AnnotationSpec({
+			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
+			nodeType: ["interface"],
+			multiple: false,
+			argument: [{
+				optional: true,
+				name: "analyzer",
+				type: "string",
+				description: "The **text analyzer** for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, etc.",
+				values: analyzers
+			}, {
+				optional: true,
+				name: "fuzzy",
+				type: "number",
+				description: fuzzyDescription
+			}]
+		}),
+		static: new AnnotationSpec({
+			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
+			nodeType: ["interface"],
+			multiple: true,
+			argument: [
+				{
+					optional: true,
+					name: "analyzer",
+					type: "string",
+					description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
+					values: analyzers
+				},
+				{
+					optional: true,
+					name: "fuzzy",
+					type: "number",
+					description: fuzzyDescription
+				},
+				{
+					optional: true,
+					name: "indexName",
+					type: "string",
+					description: "The name of the search index. Fields must reference this name using `@db.mongo.search.text` or `@db.mongo.search.autocomplete`. If not set, defaults to `\"DEFAULT\"`."
+				},
+				{
+					optional: true,
+					name: "strategy",
+					type: "string",
+					description: strategyDescription,
+					values: searchStrategies
+				}
+			]
+		}),
+		text: new AnnotationSpec({
+			description: "Marks a field to be **included in a MongoDB Atlas Search Index** defined by `@db.mongo.search.static`.\n\n- **The field has to reference an existing search index name**.\n- If index name is not defined, a new search index with default attributes will be created.\n\n**Example:**\n```atscript\n@db.mongo.search.text \"lucene.english\", \"mySearchIndex\"\nfirstName: string\n```\n",
+			nodeType: ["prop"],
+			multiple: true,
+			argument: [{
+				optional: true,
+				name: "analyzer",
+				type: "string",
+				description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
+				values: analyzers
+			}, {
+				optional: true,
+				name: "indexName",
+				type: "string",
+				description: "The **name of the search index** defined in `@db.mongo.search.static`. This links the field to the correct index. If not set, defaults to `\"DEFAULT\"`."
+			}]
+		}),
+		autocomplete: new AnnotationSpec({
+			description: "Marks a field for **prefix / typeahead (as-you-type)** matching in a MongoDB Atlas Search Index.\n\n- Indexes the field as the Atlas **`autocomplete`** type, **and** double-maps it as `string` so exact-word hits still rank.\n- Lets `search()` match partial words: with the default `edgeGram` tokenization, `\"art\"` matches `\"Artem\"` **as you type** (no whole word required).\n- Use `nGram` tokenization for true mid-word (infix/substring) matching at higher index cost.\n- Like `@db.mongo.search.text`, the field joins the index named by `indexName` (or the default index).\n\n**Example:**\n```atscript\n@db.mongo.search.autocomplete \"users\"\nusername: string\n```\n",
+			nodeType: ["prop"],
+			multiple: true,
+			argument: [
+				{
+					optional: true,
+					name: "indexName",
+					type: "string",
+					description: "The **name of the search index** (defined by `@db.mongo.search.static`) this field joins. If not set, defaults to `\"DEFAULT\"`."
+				},
+				{
+					optional: true,
+					name: "tokenization",
+					type: "string",
+					description: "How the field is tokenized for partial matching:\n\n- `\"edgeGram\"` (default) → **prefix** matching from the start of each word (`\"art\"` → `\"Artem\"`).\n- `\"nGram\"` → **substring/infix** matching anywhere inside a word (`\"tem\"` → `\"Artem\"`); larger index, slower builds.\n- `\"rightEdgeGram\"` → **suffix** matching from the end of each word.",
+					values: tokenizations
+				},
+				{
+					optional: true,
+					name: "minGrams",
+					type: "number",
+					description: "Minimum number of characters per indexed sequence. Defaults to `2`."
+				},
+				{
+					optional: true,
+					name: "maxGrams",
+					type: "number",
+					description: "Maximum number of characters per indexed sequence. Defaults to `15`."
+				},
+				{
+					optional: true,
+					name: "foldDiacritics",
+					type: "boolean",
+					description: "Whether to fold (ignore) diacritics so `\"café\"` matches `\"cafe\"`. Defaults to `true`."
+				},
+				{
+					optional: true,
+					name: "analyzer",
+					type: "string",
+					description: "The text analyzer for the companion `string` mapping. Defaults to `\"lucene.standard\"`.",
+					values: analyzers
+				}
+			]
+		})
+	}
+};
+//#endregion
+//#region src/plugin/primitives.ts
+const primitives = { mongo: { extensions: { objectId: {
+	type: "string",
+	documentation: "Represents a **MongoDB ObjectId**.\n\n- Stored as a **string** but can be converted to an ObjectId at runtime.\n- Useful for handling `_id` fields and queries that require ObjectId conversion.\n- Automatically converts string `_id` values into **MongoDB ObjectId** when needed.\n\n**Example:**\n```atscript\nuserId: mongo.objectId\n```\n",
+	annotations: { "expect.pattern": { pattern: "^[a-fA-F0-9]{24}$" } }
+} } } };
+//#endregion
+//#region src/plugin/index.ts
+const MongoPlugin = () => ({
+	name: "mongo",
+	config() {
+		return {
+			primitives,
+			annotations: { db: { mongo: annotations } }
+		};
+	}
+});
+//#endregion
+export { MongoPlugin as t };

package/dist/plugin.cjs

@@ -2,241 +2,6 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-let _atscript_core = require("@atscript/core");
-//#region src/plugin/annotations.ts
-const analyzers = [
-	"lucene.standard",
-	"lucene.simple",
-	"lucene.whitespace",
-	"lucene.english",
-	"lucene.french",
-	"lucene.german",
-	"lucene.italian",
-	"lucene.portuguese",
-	"lucene.spanish",
-	"lucene.chinese",
-	"lucene.hindi",
-	"lucene.bengali",
-	"lucene.russian",
-	"lucene.arabic"
-];
-const tokenizations = [
-	"edgeGram",
-	"rightEdgeGram",
-	"nGram"
-];
-const searchStrategies = [
-	"compound",
-	"autocomplete",
-	"text"
-];
-const strategyDescription = "How `search()` matches a term against this index. Locks the query shape into the index — there is no query-time mode switching.\n\n- `compound` (default) → rank exact-word hits above prefix hits: a wildcard `text` clause **plus** one `autocomplete` clause per autocomplete field. Degrades to plain `text` when the index has no autocomplete field.\n- `autocomplete` → **prefix/typeahead only** — query just the autocomplete fields, no word-match ranking clause.\n- `text` → **word matching only** — a single `text` operator over all string-mapped fields (autocomplete fields are matched via their companion `string` mapping).\n\nTo use the same data with a different strategy, declare a second index and select it per request with `$index`.";
-const fuzzyDescription = "Maximum typo tolerance, applied **at query time** to the search operator.\n\n- `0` (default) → no fuzzy matching (exact tokens).\n- `1` → allows small typos (e.g., `\"mongo\"` ≈ `\"mango\"`).\n- `2` → more typo tolerance (e.g., `\"mongodb\"` ≈ `\"mangodb\"`).\n\nAtlas only accepts an edit distance of `1` or `2`; `0` simply disables fuzzy. Can be overridden per request via the `$fuzzy` query control.";
-/**
-* MongoDB-specific annotations.
-*
-* Merged into the global config under `{ db: { mongo: ... } }` so they
-* live alongside core's `@db.table`, `@db.index.*`, etc.
-*
-* Annotations removed (now in core):
-* - `@mongo.index.plain` → use `@db.index.plain`
-* - `@mongo.index.unique` → use `@db.index.unique`
-* - `@db.mongo.index.text` → use `@db.index.fulltext` (with optional weight arg)
-* - `@db.mongo.patch.strategy` → use `@db.patch.strategy`
-* - `@db.mongo.array.uniqueItems` → use `@expect.array.uniqueItems`
-* - `@db.mongo.autoIndexes` → removed (use explicit syncIndexes() calls)
-* - `@db.mongo.search.vector` → use `@db.search.vector` (generic, in @atscript/db/plugin)
-* - `@db.mongo.search.filter` → use `@db.search.filter` (generic, in @atscript/db/plugin)
-*/
-const annotations = {
-	collection: new _atscript_core.AnnotationSpec({
-		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
-		nodeType: ["interface"],
-		validate(token, args, doc) {
-			const parent = token.parentNode;
-			const struc = parent?.getDefinition();
-			const errors = [];
-			if ((0, _atscript_core.isInterface)(parent) && parent.props.has("_id") && (0, _atscript_core.isStructure)(struc)) {
-				const _id = parent.props.get("_id");
-				if (!!_id.token("optional")) errors.push({
-					message: `[db.mongo] _id can't be optional in Mongo Collection`,
-					severity: 1,
-					range: _id.token("identifier").range
-				});
-				const definition = _id.getDefinition();
-				if (!definition) return errors;
-				let wrongType = false;
-				if ((0, _atscript_core.isRef)(definition)) {
-					const def = doc.unwindType(definition.id, definition.chain)?.def;
-					if ((0, _atscript_core.isPrimitive)(def) && !["string", "number"].includes(def.config.type)) wrongType = true;
-				} else wrongType = true;
-				if (wrongType) errors.push({
-					message: `[db.mongo] _id must be of type string, number or mongo.objectId`,
-					severity: 1,
-					range: _id.token("identifier").range
-				});
-			}
-			return errors;
-		},
-		modify(token, _args, _doc) {
-			const parent = token.parentNode;
-			const struc = parent?.getDefinition();
-			if ((0, _atscript_core.isInterface)(parent) && !parent.props.has("_id") && (0, _atscript_core.isStructure)(struc)) struc.addVirtualProp({
-				name: "_id",
-				type: "mongo.objectId",
-				documentation: "Mongodb Primary Key ObjectId"
-			});
-		}
-	}),
-	capped: new _atscript_core.AnnotationSpec({
-		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
-		nodeType: ["interface"],
-		multiple: false,
-		argument: [{
-			optional: false,
-			name: "size",
-			type: "number",
-			description: "Maximum size of the collection in **bytes**."
-		}, {
-			optional: true,
-			name: "max",
-			type: "number",
-			description: "Maximum number of documents in the collection. If omitted, only the byte size limit applies."
-		}]
-	}),
-	search: {
-		dynamic: new _atscript_core.AnnotationSpec({
-			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
-			nodeType: ["interface"],
-			multiple: false,
-			argument: [{
-				optional: true,
-				name: "analyzer",
-				type: "string",
-				description: "The **text analyzer** for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, etc.",
-				values: analyzers
-			}, {
-				optional: true,
-				name: "fuzzy",
-				type: "number",
-				description: fuzzyDescription
-			}]
-		}),
-		static: new _atscript_core.AnnotationSpec({
-			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
-			nodeType: ["interface"],
-			multiple: true,
-			argument: [
-				{
-					optional: true,
-					name: "analyzer",
-					type: "string",
-					description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
-					values: analyzers
-				},
-				{
-					optional: true,
-					name: "fuzzy",
-					type: "number",
-					description: fuzzyDescription
-				},
-				{
-					optional: true,
-					name: "indexName",
-					type: "string",
-					description: "The name of the search index. Fields must reference this name using `@db.mongo.search.text` or `@db.mongo.search.autocomplete`. If not set, defaults to `\"DEFAULT\"`."
-				},
-				{
-					optional: true,
-					name: "strategy",
-					type: "string",
-					description: strategyDescription,
-					values: searchStrategies
-				}
-			]
-		}),
-		text: new _atscript_core.AnnotationSpec({
-			description: "Marks a field to be **included in a MongoDB Atlas Search Index** defined by `@db.mongo.search.static`.\n\n- **The field has to reference an existing search index name**.\n- If index name is not defined, a new search index with default attributes will be created.\n\n**Example:**\n```atscript\n@db.mongo.search.text \"lucene.english\", \"mySearchIndex\"\nfirstName: string\n```\n",
-			nodeType: ["prop"],
-			multiple: true,
-			argument: [{
-				optional: true,
-				name: "analyzer",
-				type: "string",
-				description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
-				values: analyzers
-			}, {
-				optional: true,
-				name: "indexName",
-				type: "string",
-				description: "The **name of the search index** defined in `@db.mongo.search.static`. This links the field to the correct index. If not set, defaults to `\"DEFAULT\"`."
-			}]
-		}),
-		autocomplete: new _atscript_core.AnnotationSpec({
-			description: "Marks a field for **prefix / typeahead (as-you-type)** matching in a MongoDB Atlas Search Index.\n\n- Indexes the field as the Atlas **`autocomplete`** type, **and** double-maps it as `string` so exact-word hits still rank.\n- Lets `search()` match partial words: with the default `edgeGram` tokenization, `\"art\"` matches `\"Artem\"` **as you type** (no whole word required).\n- Use `nGram` tokenization for true mid-word (infix/substring) matching at higher index cost.\n- Like `@db.mongo.search.text`, the field joins the index named by `indexName` (or the default index).\n\n**Example:**\n```atscript\n@db.mongo.search.autocomplete \"users\"\nusername: string\n```\n",
-			nodeType: ["prop"],
-			multiple: true,
-			argument: [
-				{
-					optional: true,
-					name: "indexName",
-					type: "string",
-					description: "The **name of the search index** (defined by `@db.mongo.search.static`) this field joins. If not set, defaults to `\"DEFAULT\"`."
-				},
-				{
-					optional: true,
-					name: "tokenization",
-					type: "string",
-					description: "How the field is tokenized for partial matching:\n\n- `\"edgeGram\"` (default) → **prefix** matching from the start of each word (`\"art\"` → `\"Artem\"`).\n- `\"nGram\"` → **substring/infix** matching anywhere inside a word (`\"tem\"` → `\"Artem\"`); larger index, slower builds.\n- `\"rightEdgeGram\"` → **suffix** matching from the end of each word.",
-					values: tokenizations
-				},
-				{
-					optional: true,
-					name: "minGrams",
-					type: "number",
-					description: "Minimum number of characters per indexed sequence. Defaults to `2`."
-				},
-				{
-					optional: true,
-					name: "maxGrams",
-					type: "number",
-					description: "Maximum number of characters per indexed sequence. Defaults to `15`."
-				},
-				{
-					optional: true,
-					name: "foldDiacritics",
-					type: "boolean",
-					description: "Whether to fold (ignore) diacritics so `\"café\"` matches `\"cafe\"`. Defaults to `true`."
-				},
-				{
-					optional: true,
-					name: "analyzer",
-					type: "string",
-					description: "The text analyzer for the companion `string` mapping. Defaults to `\"lucene.standard\"`.",
-					values: analyzers
-				}
-			]
-		})
-	}
-};
-//#endregion
-//#region src/plugin/primitives.ts
-const primitives = { mongo: { extensions: { objectId: {
-	type: "string",
-	documentation: "Represents a **MongoDB ObjectId**.\n\n- Stored as a **string** but can be converted to an ObjectId at runtime.\n- Useful for handling `_id` fields and queries that require ObjectId conversion.\n- Automatically converts string `_id` values into **MongoDB ObjectId** when needed.\n\n**Example:**\n```atscript\nuserId: mongo.objectId\n```\n",
-	annotations: { "expect.pattern": { pattern: "^[a-fA-F0-9]{24}$" } }
-} } } };
-//#endregion
-//#region src/plugin/index.ts
-const MongoPlugin = () => ({
-	name: "mongo",
-	config() {
-		return {
-			primitives,
-			annotations: { db: { mongo: annotations } }
-		};
-	}
-});
-//#endregion
-exports.MongoPlugin = MongoPlugin;
-exports.default = MongoPlugin;
+const require_plugin = require("./plugin-Bq6hZMBA.cjs");
+exports.MongoPlugin = require_plugin.MongoPlugin;
+exports.default = require_plugin.MongoPlugin;

package/dist/plugin.d.cts

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

package/dist/plugin.d.mts

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

package/dist/plugin.mjs

@@ -1,237 +1,2 @@
-import { AnnotationSpec, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
-//#region src/plugin/annotations.ts
-const analyzers = [
-	"lucene.standard",
-	"lucene.simple",
-	"lucene.whitespace",
-	"lucene.english",
-	"lucene.french",
-	"lucene.german",
-	"lucene.italian",
-	"lucene.portuguese",
-	"lucene.spanish",
-	"lucene.chinese",
-	"lucene.hindi",
-	"lucene.bengali",
-	"lucene.russian",
-	"lucene.arabic"
-];
-const tokenizations = [
-	"edgeGram",
-	"rightEdgeGram",
-	"nGram"
-];
-const searchStrategies = [
-	"compound",
-	"autocomplete",
-	"text"
-];
-const strategyDescription = "How `search()` matches a term against this index. Locks the query shape into the index — there is no query-time mode switching.\n\n- `compound` (default) → rank exact-word hits above prefix hits: a wildcard `text` clause **plus** one `autocomplete` clause per autocomplete field. Degrades to plain `text` when the index has no autocomplete field.\n- `autocomplete` → **prefix/typeahead only** — query just the autocomplete fields, no word-match ranking clause.\n- `text` → **word matching only** — a single `text` operator over all string-mapped fields (autocomplete fields are matched via their companion `string` mapping).\n\nTo use the same data with a different strategy, declare a second index and select it per request with `$index`.";
-const fuzzyDescription = "Maximum typo tolerance, applied **at query time** to the search operator.\n\n- `0` (default) → no fuzzy matching (exact tokens).\n- `1` → allows small typos (e.g., `\"mongo\"` ≈ `\"mango\"`).\n- `2` → more typo tolerance (e.g., `\"mongodb\"` ≈ `\"mangodb\"`).\n\nAtlas only accepts an edit distance of `1` or `2`; `0` simply disables fuzzy. Can be overridden per request via the `$fuzzy` query control.";
-/**
-* MongoDB-specific annotations.
-*
-* Merged into the global config under `{ db: { mongo: ... } }` so they
-* live alongside core's `@db.table`, `@db.index.*`, etc.
-*
-* Annotations removed (now in core):
-* - `@mongo.index.plain` → use `@db.index.plain`
-* - `@mongo.index.unique` → use `@db.index.unique`
-* - `@db.mongo.index.text` → use `@db.index.fulltext` (with optional weight arg)
-* - `@db.mongo.patch.strategy` → use `@db.patch.strategy`
-* - `@db.mongo.array.uniqueItems` → use `@expect.array.uniqueItems`
-* - `@db.mongo.autoIndexes` → removed (use explicit syncIndexes() calls)
-* - `@db.mongo.search.vector` → use `@db.search.vector` (generic, in @atscript/db/plugin)
-* - `@db.mongo.search.filter` → use `@db.search.filter` (generic, in @atscript/db/plugin)
-*/
-const annotations = {
-	collection: new AnnotationSpec({
-		description: "Marks an interface as a **MongoDB collection**.\n\n- Use together with `@db.table \"name\"` which provides the collection name.\n- Automatically injects a **non-optional** `_id` field if not explicitly defined.\n- `_id` must be of type **`string`**, **`number`**, or **`mongo.objectId`**.\n\n**Example:**\n```atscript\n@db.table \"users\"\n@db.mongo.collection\nexport interface User {\n    _id: mongo.objectId\n    email: string.email\n}\n```\n",
-		nodeType: ["interface"],
-		validate(token, args, doc) {
-			const parent = token.parentNode;
-			const struc = parent?.getDefinition();
-			const errors = [];
-			if (isInterface(parent) && parent.props.has("_id") && isStructure(struc)) {
-				const _id = parent.props.get("_id");
-				if (!!_id.token("optional")) errors.push({
-					message: `[db.mongo] _id can't be optional in Mongo Collection`,
-					severity: 1,
-					range: _id.token("identifier").range
-				});
-				const definition = _id.getDefinition();
-				if (!definition) return errors;
-				let wrongType = false;
-				if (isRef(definition)) {
-					const def = doc.unwindType(definition.id, definition.chain)?.def;
-					if (isPrimitive(def) && !["string", "number"].includes(def.config.type)) wrongType = true;
-				} else wrongType = true;
-				if (wrongType) errors.push({
-					message: `[db.mongo] _id must be of type string, number or mongo.objectId`,
-					severity: 1,
-					range: _id.token("identifier").range
-				});
-			}
-			return errors;
-		},
-		modify(token, _args, _doc) {
-			const parent = token.parentNode;
-			const struc = parent?.getDefinition();
-			if (isInterface(parent) && !parent.props.has("_id") && isStructure(struc)) struc.addVirtualProp({
-				name: "_id",
-				type: "mongo.objectId",
-				documentation: "Mongodb Primary Key ObjectId"
-			});
-		}
-	}),
-	capped: new AnnotationSpec({
-		description: "Creates a **capped collection** with a fixed maximum size.\n\n- Capped collections have fixed size and maintain insertion order.\n- Ideal for logs, event streams, and cache-like data.\n- Changing the cap size requires dropping and recreating the collection — use `@db.sync.method \"drop\"` to allow this.\n\n**Example:**\n```atscript\n@db.table \"logs\"\n@db.mongo.collection\n@db.mongo.capped 10485760, 10000\n@db.sync.method \"drop\"\nexport interface LogEntry {\n    message: string\n    timestamp: number\n}\n```\n",
-		nodeType: ["interface"],
-		multiple: false,
-		argument: [{
-			optional: false,
-			name: "size",
-			type: "number",
-			description: "Maximum size of the collection in **bytes**."
-		}, {
-			optional: true,
-			name: "max",
-			type: "number",
-			description: "Maximum number of documents in the collection. If omitted, only the byte size limit applies."
-		}]
-	}),
-	search: {
-		dynamic: new AnnotationSpec({
-			description: "Creates a **dynamic MongoDB Search Index** that applies to the entire collection.\n\n- **Indexes all text fields automatically** (no need to specify fields).\n- Supports **language analyzers** for text tokenization.\n- Enables **fuzzy search** (typo tolerance) if needed.\n\n**Example:**\n```atscript\n@db.mongo.search.dynamic \"lucene.english\", 1\nexport interface MongoCollection {}\n```\n",
-			nodeType: ["interface"],
-			multiple: false,
-			argument: [{
-				optional: true,
-				name: "analyzer",
-				type: "string",
-				description: "The **text analyzer** for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, etc.",
-				values: analyzers
-			}, {
-				optional: true,
-				name: "fuzzy",
-				type: "number",
-				description: fuzzyDescription
-			}]
-		}),
-		static: new AnnotationSpec({
-			description: "Defines a **MongoDB Atlas Search Index** for the collection. The props can refer to this index using `@db.mongo.search.text` annotation.\n\n- **Creates a named search index** for full-text search.\n- **Specify analyzers and fuzzy search** behavior at the index level.\n- **Fields must explicitly use `@db.mongo.search.text`** to be included in this search index.\n\n**Example:**\n```atscript\n@db.mongo.search.static \"lucene.english\", 1, \"mySearchIndex\"\nexport interface MongoCollection {}\n```\n",
-			nodeType: ["interface"],
-			multiple: true,
-			argument: [
-				{
-					optional: true,
-					name: "analyzer",
-					type: "string",
-					description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
-					values: analyzers
-				},
-				{
-					optional: true,
-					name: "fuzzy",
-					type: "number",
-					description: fuzzyDescription
-				},
-				{
-					optional: true,
-					name: "indexName",
-					type: "string",
-					description: "The name of the search index. Fields must reference this name using `@db.mongo.search.text` or `@db.mongo.search.autocomplete`. If not set, defaults to `\"DEFAULT\"`."
-				},
-				{
-					optional: true,
-					name: "strategy",
-					type: "string",
-					description: strategyDescription,
-					values: searchStrategies
-				}
-			]
-		}),
-		text: new AnnotationSpec({
-			description: "Marks a field to be **included in a MongoDB Atlas Search Index** defined by `@db.mongo.search.static`.\n\n- **The field has to reference an existing search index name**.\n- If index name is not defined, a new search index with default attributes will be created.\n\n**Example:**\n```atscript\n@db.mongo.search.text \"lucene.english\", \"mySearchIndex\"\nfirstName: string\n```\n",
-			nodeType: ["prop"],
-			multiple: true,
-			argument: [{
-				optional: true,
-				name: "analyzer",
-				type: "string",
-				description: "The text analyzer for tokenization. Defaults to `\"lucene.standard\"`.\n\n**Available options:** `\"lucene.standard\"`, `\"lucene.english\"`, `\"lucene.spanish\"`, `\"lucene.german\"`, etc.",
-				values: analyzers
-			}, {
-				optional: true,
-				name: "indexName",
-				type: "string",
-				description: "The **name of the search index** defined in `@db.mongo.search.static`. This links the field to the correct index. If not set, defaults to `\"DEFAULT\"`."
-			}]
-		}),
-		autocomplete: new AnnotationSpec({
-			description: "Marks a field for **prefix / typeahead (as-you-type)** matching in a MongoDB Atlas Search Index.\n\n- Indexes the field as the Atlas **`autocomplete`** type, **and** double-maps it as `string` so exact-word hits still rank.\n- Lets `search()` match partial words: with the default `edgeGram` tokenization, `\"art\"` matches `\"Artem\"` **as you type** (no whole word required).\n- Use `nGram` tokenization for true mid-word (infix/substring) matching at higher index cost.\n- Like `@db.mongo.search.text`, the field joins the index named by `indexName` (or the default index).\n\n**Example:**\n```atscript\n@db.mongo.search.autocomplete \"users\"\nusername: string\n```\n",
-			nodeType: ["prop"],
-			multiple: true,
-			argument: [
-				{
-					optional: true,
-					name: "indexName",
-					type: "string",
-					description: "The **name of the search index** (defined by `@db.mongo.search.static`) this field joins. If not set, defaults to `\"DEFAULT\"`."
-				},
-				{
-					optional: true,
-					name: "tokenization",
-					type: "string",
-					description: "How the field is tokenized for partial matching:\n\n- `\"edgeGram\"` (default) → **prefix** matching from the start of each word (`\"art\"` → `\"Artem\"`).\n- `\"nGram\"` → **substring/infix** matching anywhere inside a word (`\"tem\"` → `\"Artem\"`); larger index, slower builds.\n- `\"rightEdgeGram\"` → **suffix** matching from the end of each word.",
-					values: tokenizations
-				},
-				{
-					optional: true,
-					name: "minGrams",
-					type: "number",
-					description: "Minimum number of characters per indexed sequence. Defaults to `2`."
-				},
-				{
-					optional: true,
-					name: "maxGrams",
-					type: "number",
-					description: "Maximum number of characters per indexed sequence. Defaults to `15`."
-				},
-				{
-					optional: true,
-					name: "foldDiacritics",
-					type: "boolean",
-					description: "Whether to fold (ignore) diacritics so `\"café\"` matches `\"cafe\"`. Defaults to `true`."
-				},
-				{
-					optional: true,
-					name: "analyzer",
-					type: "string",
-					description: "The text analyzer for the companion `string` mapping. Defaults to `\"lucene.standard\"`.",
-					values: analyzers
-				}
-			]
-		})
-	}
-};
-//#endregion
-//#region src/plugin/primitives.ts
-const primitives = { mongo: { extensions: { objectId: {
-	type: "string",
-	documentation: "Represents a **MongoDB ObjectId**.\n\n- Stored as a **string** but can be converted to an ObjectId at runtime.\n- Useful for handling `_id` fields and queries that require ObjectId conversion.\n- Automatically converts string `_id` values into **MongoDB ObjectId** when needed.\n\n**Example:**\n```atscript\nuserId: mongo.objectId\n```\n",
-	annotations: { "expect.pattern": { pattern: "^[a-fA-F0-9]{24}$" } }
-} } } };
-//#endregion
-//#region src/plugin/index.ts
-const MongoPlugin = () => ({
-	name: "mongo",
-	config() {
-		return {
-			primitives,
-			annotations: { db: { mongo: annotations } }
-		};
-	}
-});
-//#endregion
+import { t as MongoPlugin } from "./plugin-KVFAwoGw.mjs";
 export { MongoPlugin, MongoPlugin as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-mongo",
-  "version": "0.1.102",
+  "version": "0.1.103",
   "description": "Mongodb plugin for atscript.",
   "keywords": [
     "atscript",
@@ -46,17 +46,17 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.74",
-    "@atscript/typescript": "^0.1.74",
+    "@atscript/core": "^0.1.75",
+    "@atscript/typescript": "^0.1.75",
     "mongodb": "^6.17.0",
     "mongodb-memory-server-core": "^10.0.0",
-    "unplugin-atscript": "^0.1.74"
+    "unplugin-atscript": "^0.1.75"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.74",
-    "@atscript/typescript": "^0.1.74",
+    "@atscript/core": "^0.1.75",
+    "@atscript/typescript": "^0.1.75",
     "mongodb": "^6.17.0",
-    "@atscript/db": "^0.1.102"
+    "@atscript/db": "^0.1.103"
   },
   "scripts": {
     "postinstall": "asc -f dts",