@atscript/db-mysql 0.1.104 → 0.1.106

package/dist/index.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_plugin = require("./plugin-AzwuXV59.cjs");
 let _atscript_db = require("@atscript/db");
 let _atscript_db_sql_tools = require("@atscript/db-sql-tools");
 //#region src/sql-builder.ts
@@ -40,9 +39,53 @@ const mysqlDialect = {
 			params: [pattern]
 		};
 	},
+	geoWithin(quotedCol, circle) {
+		const dist = mysqlGeoDistanceExpr(quotedCol, circle.center);
+		return {
+			sql: `${dist.sql} <= ?`,
+			params: [...dist.params, circle.radius]
+		};
+	},
 	createViewPrefix: "CREATE OR REPLACE VIEW"
 };
 /**
+* Spherical distance in meters from a POINT column to a query point.
+* Used as the `distExpr` of the shared geo search builder.
+*/
+function mysqlGeoDistanceExpr(quotedCol, point) {
+	return {
+		sql: `ST_Distance_Sphere(${quotedCol}, ST_SRID(POINT(?, ?), 4326))`,
+		params: [point[0], point[1]]
+	};
+}
+/**
+* Encodes a `[lng, lat]` tuple in MySQL's internal geometry format
+* (4-byte SRID LE + WKB point) — geometry columns accept it directly as a
+* binary parameter, bypassing the WKT/WKB axis-order pitfalls entirely.
+*/
+function geoPointToMysqlInternal(point) {
+	const buf = Buffer.alloc(25);
+	buf.writeUInt32LE(4326, 0);
+	buf.writeUInt8(1, 4);
+	buf.writeUInt32LE(1, 5);
+	buf.writeDoubleLE(point[0], 9);
+	buf.writeDoubleLE(point[1], 17);
+	return buf;
+}
+/**
+* Decodes a geo read value back to `[lng, lat]`. The mysql2 driver parses
+* POINT columns to `{x, y}` objects (internal order: x=lng, y=lat); raw
+* internal-format buffers are handled for drivers that don't.
+*/
+function mysqlGeoValueToPoint(value) {
+	if (typeof value === "object" && value !== null && typeof value.x === "number" && typeof value.y === "number") return [value.x, value.y];
+	if (value instanceof Uint8Array && value.length >= 25) {
+		const buf = Buffer.isBuffer(value) ? value : Buffer.from(value);
+		const littleEndian = buf.readUInt8(4) === 1;
+		if (((littleEndian ? buf.readUInt32LE(5) : buf.readUInt32BE(5)) & 255) === 1) return [littleEndian ? buf.readDoubleLE(9) : buf.readDoubleBE(9), littleEndian ? buf.readDoubleLE(17) : buf.readDoubleBE(17)];
+	}
+}
+/**
 * Builds an INSERT statement.
 */
 function buildInsert(table, data) {
@@ -122,6 +165,7 @@ function mysqlTypeFromField(field) {
 	const metadata = field.type?.metadata;
 	const mysqlTypeOverride = metadata?.get("db.mysql.type");
 	if (mysqlTypeOverride) return mysqlTypeOverride;
+	if (field.isGeoPoint && !field.encrypted) return "POINT SRID 4326";
 	const unsigned = metadata?.has("db.mysql.unsigned") ?? false;
 	const precision = metadata?.get("db.column.precision");
 	switch (field.designType) {
@@ -410,6 +454,13 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 			toStorage: (value) => typeof value === "number" ? epochMsToUtcDatetime(value) : value,
 			fromStorage: utcDatetimeToEpochMs
 		};
+		if (field.isGeoPoint && !field.encrypted) return {
+			toStorage: (value) => {
+				const point = (0, _atscript_db_sql_tools.normalizeGeoPointValue)(value);
+				return point ? geoPointToMysqlInternal(point) : value;
+			},
+			fromStorage: (value) => mysqlGeoValueToPoint(value) ?? value
+		};
 	}
 	/**
 	* Wraps an async write operation to catch MySQL constraint errors
@@ -579,8 +630,11 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 		this._log(sql, params);
 		return { deletedCount: (await this._wrapConstraintError(() => this._exec().run(sql, params))).affectedRows };
 	}
-	async ensureTable() {
+	async prepareTypeMapper() {
 		if (this._supportsVector === void 0 && this._vectorFields.size > 0) await this._detectVectorSupport();
+	}
+	async ensureTable() {
+		await this.prepareTypeMapper();
 		if (this._table instanceof _atscript_db.AtscriptDbView) return this._ensureView();
 		const sql = buildCreateTable(this.resolveTableName(), this._table.fieldDescriptors, this._table.foreignKeys, {
 			engine: this._engine,
@@ -604,12 +658,12 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 	}
 	async getExistingColumnsForTable(tableName) {
 		const schema = this._schema;
-		return (await this._exec().all(`SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_KEY, COLUMN_DEFAULT
+		return (await this._exec().all(`SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_KEY, COLUMN_DEFAULT, SRS_ID
        FROM INFORMATION_SCHEMA.COLUMNS
        WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
        ORDER BY ORDINAL_POSITION`, [tableName, schema])).map((r) => ({
 			name: r.COLUMN_NAME,
-			type: r.COLUMN_TYPE.toUpperCase(),
+			type: r.SRS_ID == null ? r.COLUMN_TYPE.toUpperCase() : `${r.COLUMN_TYPE.toUpperCase()} SRID ${r.SRS_ID}`,
 			notnull: r.IS_NULLABLE === "NO",
 			pk: r.COLUMN_KEY === "PRI",
 			dflt_value: normalizeMysqlDefault(r.COLUMN_DEFAULT)
@@ -630,7 +684,7 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 			let ddl = `ALTER TABLE ${quoteTableName(tableName)} ADD COLUMN ${qi(field.physicalName)} ${sqlType}`;
 			if (!field.optional && !field.isPrimaryKey) ddl += " NOT NULL";
 			if (field.defaultValue?.kind === "value") ddl += ` DEFAULT ${(0, _atscript_db_sql_tools.defaultValueToSqlLiteral)(field.designType, field.defaultValue.value)}`;
-			else if (!field.optional && !field.isPrimaryKey) ddl += ` DEFAULT ${(0, _atscript_db_sql_tools.defaultValueForType)(field.designType)}`;
+			else if (!field.optional && !field.isPrimaryKey) ddl += field.isGeoPoint && !field.encrypted ? ` DEFAULT (ST_SRID(POINT(0, 0), 4326))` : ` DEFAULT ${(0, _atscript_db_sql_tools.defaultValueForType)(field.designType)}`;
 			if (field.collate) {
 				const nativeCollate = field.type?.metadata?.get("db.mysql.collate");
 				ddl += ` COLLATE ${nativeCollate ?? collationToMysql(field.collate)}`;
@@ -641,6 +695,10 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 		}
 		for (const { field } of diff.typeChanged ?? []) {
 			const sqlType = this.typeMapper(field);
+			if (field.isGeoPoint && !field.encrypted && sqlType.startsWith("POINT")) {
+				await this._migrateJsonColumnToPoint(tableName, field);
+				continue;
+			}
 			let ddl = `ALTER TABLE ${quoteTableName(tableName)} MODIFY COLUMN ${qi(field.physicalName)} ${sqlType}`;
 			if (!field.optional && !field.isPrimaryKey) ddl += " NOT NULL";
 			this._log(ddl);
@@ -727,6 +785,21 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 		this._log(ddl);
 		await this._exec().exec(ddl);
 	}
+	async dropIndexesForColumns(columns) {
+		const placeholders = columns.map(() => "?").join(", ");
+		const rows = await this._exec().all(`SELECT DISTINCT INDEX_NAME AS name FROM INFORMATION_SCHEMA.STATISTICS
+       WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
+         AND INDEX_NAME LIKE 'atscript\\_\\_%' AND COLUMN_NAME IN (${placeholders})`, [
+			this._table.tableName,
+			this._schema,
+			...columns
+		]);
+		for (const row of rows) {
+			const sql = `DROP INDEX ${qi(row.name)} ON ${quoteTableName(this.resolveTableName())}`;
+			this._log(sql);
+			await this._exec().exec(sql);
+		}
+	}
 	async dropTableByName(tableName) {
 		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(tableName)}`;
 		this._log(ddl);
@@ -763,9 +836,28 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 		const schema = this._schema;
 		const stringFields = new Set(this._table.fieldDescriptors.filter((f) => f.designType === "string").map((f) => f.physicalName));
 		await this.syncIndexesWithDiff({
-			listExisting: async () => this._exec().all(`SELECT DISTINCT INDEX_NAME as name FROM INFORMATION_SCHEMA.STATISTICS
-           WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())`, [tableName, schema]),
+			listExisting: async () => {
+				return (await this._exec().all(`SELECT INDEX_NAME AS name,
+                  GROUP_CONCAT(COLUMN_NAME ORDER BY SEQ_IN_INDEX SEPARATOR ',') AS columns
+           FROM INFORMATION_SCHEMA.STATISTICS
+           WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
+           GROUP BY INDEX_NAME`, [tableName, schema])).map((r) => ({
+					name: r.name,
+					columns: r.columns ? r.columns.split(",") : void 0
+				}));
+			},
 			createIndex: async (index) => {
+				if (index.type === "geo") {
+					const fieldMeta = this._table.fieldDescriptors.find((f) => f.physicalName === index.fields[0]?.name);
+					if (fieldMeta?.optional) {
+						this.logger.warn(`[mysql] geo index "${index.name}" skipped — SPATIAL indexes require a NOT NULL column; make "${fieldMeta.path}" required to index it`);
+						return;
+					}
+					const sql = `CREATE SPATIAL INDEX ${qi(index.key)} ON ${quoteTableName(this.resolveTableName())} (${qi(index.fields[0].name)})`;
+					this._log(sql);
+					await this._exec().exec(sql);
+					return;
+				}
 				const unique = index.type === "unique" ? "UNIQUE " : "";
 				const fulltext = index.type === "fulltext" ? "FULLTEXT " : "";
 				const isFulltext = index.type === "fulltext";
@@ -780,10 +872,6 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 				const sql = `DROP INDEX ${qi(name)} ON ${quoteTableName(this.resolveTableName())}`;
 				this._log(sql);
 				await this._exec().exec(sql);
-			},
-			warnUnsupportedTypes: {
-				adapter: "mysql",
-				types: ["geo"]
 			}
 		});
 	}
@@ -1010,6 +1098,65 @@ var MysqlAdapter = class MysqlAdapter extends _atscript_db.BaseDbAdapter {
 		if (queryThreshold !== void 0) return queryThreshold;
 		return this._vectorThresholds.get(indexName);
 	}
+	/** Native POINT SRID 4326 + ST_Distance_Sphere — available on MySQL 8.0+. */
+	isGeoSearchable() {
+		return true;
+	}
+	async geoSearch(point, query, indexName) {
+		const { sql, params } = this._buildGeoSearchSelect(this._prepareGeoSearch(point, query, indexName));
+		this._log(sql, params);
+		return (await this._exec().all(sql, params)).map((row) => (0, _atscript_db_sql_tools.renameGeoDistance)(row));
+	}
+	async geoSearchWithCount(point, query, indexName) {
+		const ctx = this._prepareGeoSearch(point, query, indexName);
+		const { sql, params } = this._buildGeoSearchSelect(ctx);
+		const countFrag = (0, _atscript_db_sql_tools.buildGeoSearchCount)(mysqlDialect, ctx.tableName, ctx.where, ctx.dist, ctx.window);
+		this._log(sql, params);
+		this._log(countFrag.sql, countFrag.params);
+		const [rows, countRow] = await Promise.all([this._exec().all(sql, params), this._exec().get(countFrag.sql, countFrag.params)]);
+		return {
+			data: rows.map((row) => (0, _atscript_db_sql_tools.renameGeoDistance)(row)),
+			count: Number(countRow?.cnt ?? 0)
+		};
+	}
+	/** Resolves the shared parts of a geo search once (column, filter, distance, window). */
+	_prepareGeoSearch(point, query, indexName) {
+		const column = this._resolveGeoColumn(indexName);
+		const controls = query.controls ?? {};
+		return {
+			tableName: this.resolveTableName(),
+			where: buildWhere(query.filter),
+			dist: mysqlGeoDistanceExpr(qi(column), point),
+			window: (0, _atscript_db_sql_tools.geoWindowFromControls)(controls),
+			controls
+		};
+	}
+	_buildGeoSearchSelect(ctx) {
+		return (0, _atscript_db_sql_tools.buildGeoSearchSelect)(mysqlDialect, ctx.tableName, ctx.where, ctx.dist, ctx.window, {
+			$limit: ctx.controls.$limit,
+			$skip: ctx.controls.$skip
+		});
+	}
+	/**
+	* Migrates a v1 JSON `[lng, lat]` column to native `POINT SRID 4326` via a
+	* temp column (MySQL has no JSON→geometry cast for MODIFY COLUMN).
+	*/
+	async _migrateJsonColumnToPoint(tableName, field) {
+		const col = qi(field.physicalName);
+		const tmp = qi(`${field.physicalName}__geo_mig`);
+		const quotedTable = quoteTableName(tableName);
+		const steps = [
+			`ALTER TABLE ${quotedTable} ADD COLUMN ${tmp} POINT SRID 4326 NULL`,
+			`UPDATE ${quotedTable} SET ${tmp} = ST_SRID(POINT(CAST(${col}->>'$[0]' AS DOUBLE), CAST(${col}->>'$[1]' AS DOUBLE)), 4326) WHERE ${col} IS NOT NULL`,
+			`ALTER TABLE ${quotedTable} DROP COLUMN ${col}`,
+			`ALTER TABLE ${quotedTable} RENAME COLUMN ${tmp} TO ${col}`,
+			...field.optional || field.isPrimaryKey ? [] : [`ALTER TABLE ${quotedTable} MODIFY COLUMN ${col} POINT SRID 4326 NOT NULL`]
+		];
+		for (const ddl of steps) {
+			this._log(ddl);
+			await this._exec().exec(ddl);
+		}
+	}
 };
 /**
 * Normalizes MySQL INFORMATION_SCHEMA.COLUMNS.COLUMN_DEFAULT values
@@ -1194,6 +1341,5 @@ function createAdapter(uri, options) {
 //#endregion
 exports.Mysql2Driver = Mysql2Driver;
 exports.MysqlAdapter = MysqlAdapter;
-exports.MysqlPlugin = require_plugin.MysqlPlugin;
 exports.buildWhere = buildWhere;
 exports.createAdapter = createAdapter;

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import { t as MysqlPlugin } from "./index-BLQr6loH.cjs";
 import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbUpdateResult, TExistingColumn, TExistingTableOption, TFieldOps, TSearchIndexInfo, TSyncColumnResult, TTableOptionDiff, TValueFormatterPair } from "@atscript/db";
 import { TMetadataMap } from "@atscript/typescript/utils";
 import { FilterExpr as FilterExpr$1 } from "@uniqu/core";
@@ -158,6 +157,7 @@ declare class MysqlAdapter extends BaseDbAdapter {
   replaceMany(filter: FilterExpr, data: Record<string, unknown>): Promise<TDbUpdateResult>;
   deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
   deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
+  prepareTypeMapper(): Promise<void>;
   ensureTable(): Promise<void>;
   private _ensureView;
   getExistingColumns(): Promise<TExistingColumn[]>;
@@ -166,6 +166,7 @@ declare class MysqlAdapter extends BaseDbAdapter {
   recreateTable(): Promise<void>;
   dropTable(): Promise<void>;
   dropColumns(columns: string[]): Promise<void>;
+  dropIndexesForColumns(columns: string[]): Promise<void>;
   dropTableByName(tableName: string): Promise<void>;
   dropViewByName(viewName: string): Promise<void>;
   renameTable(oldName: string): Promise<void>;
@@ -201,6 +202,21 @@ declare class MysqlAdapter extends BaseDbAdapter {
   private _buildVectorSearchCountQuery;
   /** Resolves threshold: query-time $threshold > schema-level @db.search.vector.threshold. */
   private _resolveVectorThreshold;
+  /** Native POINT SRID 4326 + ST_Distance_Sphere — available on MySQL 8.0+. */
+  isGeoSearchable(): boolean;
+  geoSearch(point: [number, number], query: DbQuery, indexName?: string): Promise<Array<Record<string, unknown>>>;
+  geoSearchWithCount(point: [number, number], query: DbQuery, indexName?: string): Promise<{
+    data: Array<Record<string, unknown>>;
+    count: number;
+  }>;
+  /** Resolves the shared parts of a geo search once (column, filter, distance, window). */
+  private _prepareGeoSearch;
+  private _buildGeoSearchSelect;
+  /**
+   * Migrates a v1 JSON `[lng, lat]` column to native `POINT SRID 4326` via a
+   * temp column (MySQL has no JSON→geometry cast for MODIFY COLUMN).
+   */
+  private _migrateJsonColumnToPoint;
 }
 //#endregion
 //#region src/mysql2-driver.d.ts
@@ -268,4 +284,4 @@ declare function buildWhere(filter: FilterExpr$1): TSqlFragment$1;
  */
 declare function createAdapter(uri: string, options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { Mysql2Driver, MysqlAdapter, MysqlPlugin, type TMysqlConnection, type TMysqlDriver, type TMysqlRunResult, type TSqlFragment, buildWhere, createAdapter };
+export { Mysql2Driver, MysqlAdapter, type TMysqlConnection, type TMysqlDriver, type TMysqlRunResult, type TSqlFragment, buildWhere, createAdapter };

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-import { t as MysqlPlugin } from "./index-BLQr6loH.mjs";
 import { BaseDbAdapter, DbQuery, DbSpace, FilterExpr, TColumnDiff, TDbDefaultFn, TDbDeleteResult, TDbFieldMeta, TDbInsertManyResult, TDbInsertResult, TDbUpdateResult, TExistingColumn, TExistingTableOption, TFieldOps, TSearchIndexInfo, TSyncColumnResult, TTableOptionDiff, TValueFormatterPair } from "@atscript/db";
 import { TSqlFragment, TSqlFragment as TSqlFragment$1 } from "@atscript/db-sql-tools";
 import { TMetadataMap } from "@atscript/typescript/utils";
@@ -158,6 +157,7 @@ declare class MysqlAdapter extends BaseDbAdapter {
   replaceMany(filter: FilterExpr, data: Record<string, unknown>): Promise<TDbUpdateResult>;
   deleteOne(filter: FilterExpr): Promise<TDbDeleteResult>;
   deleteMany(filter: FilterExpr): Promise<TDbDeleteResult>;
+  prepareTypeMapper(): Promise<void>;
   ensureTable(): Promise<void>;
   private _ensureView;
   getExistingColumns(): Promise<TExistingColumn[]>;
@@ -166,6 +166,7 @@ declare class MysqlAdapter extends BaseDbAdapter {
   recreateTable(): Promise<void>;
   dropTable(): Promise<void>;
   dropColumns(columns: string[]): Promise<void>;
+  dropIndexesForColumns(columns: string[]): Promise<void>;
   dropTableByName(tableName: string): Promise<void>;
   dropViewByName(viewName: string): Promise<void>;
   renameTable(oldName: string): Promise<void>;
@@ -201,6 +202,21 @@ declare class MysqlAdapter extends BaseDbAdapter {
   private _buildVectorSearchCountQuery;
   /** Resolves threshold: query-time $threshold > schema-level @db.search.vector.threshold. */
   private _resolveVectorThreshold;
+  /** Native POINT SRID 4326 + ST_Distance_Sphere — available on MySQL 8.0+. */
+  isGeoSearchable(): boolean;
+  geoSearch(point: [number, number], query: DbQuery, indexName?: string): Promise<Array<Record<string, unknown>>>;
+  geoSearchWithCount(point: [number, number], query: DbQuery, indexName?: string): Promise<{
+    data: Array<Record<string, unknown>>;
+    count: number;
+  }>;
+  /** Resolves the shared parts of a geo search once (column, filter, distance, window). */
+  private _prepareGeoSearch;
+  private _buildGeoSearchSelect;
+  /**
+   * Migrates a v1 JSON `[lng, lat]` column to native `POINT SRID 4326` via a
+   * temp column (MySQL has no JSON→geometry cast for MODIFY COLUMN).
+   */
+  private _migrateJsonColumnToPoint;
 }
 //#endregion
 //#region src/mysql2-driver.d.ts
@@ -268,4 +284,4 @@ declare function buildWhere(filter: FilterExpr$1): TSqlFragment$1;
  */
 declare function createAdapter(uri: string, options?: Record<string, unknown>): DbSpace;
 //#endregion
-export { Mysql2Driver, MysqlAdapter, MysqlPlugin, type TMysqlConnection, type TMysqlDriver, type TMysqlRunResult, type TSqlFragment, buildWhere, createAdapter };
+export { Mysql2Driver, MysqlAdapter, type TMysqlConnection, type TMysqlDriver, type TMysqlRunResult, type TSqlFragment, buildWhere, createAdapter };

package/dist/index.mjs

@@ -1,6 +1,5 @@
-import { t as MysqlPlugin } from "./plugin-CPJY5K_I.mjs";
 import { AtscriptDbView, BaseDbAdapter, DbError, DbSpace } from "@atscript/db";
-import { buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildInsert, buildSelect, buildUpdate, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, parseRegexString, refActionToSql, toSqlValue } from "@atscript/db-sql-tools";
+import { buildAggregateCount, buildAggregateSelect, buildCreateView, buildDelete, buildGeoSearchCount, buildGeoSearchSelect, buildInsert, buildSelect, buildUpdate, buildWhere as buildWhere$1, defaultValueForType, defaultValueToSqlLiteral, geoWindowFromControls, normalizeGeoPointValue, parseRegexString, refActionToSql, renameGeoDistance, toSqlValue } from "@atscript/db-sql-tools";
 //#region src/sql-builder.ts
 /** Escapes a MySQL identifier by doubling backticks. */
 function esc(name) {
@@ -39,9 +38,53 @@ const mysqlDialect = {
 			params: [pattern]
 		};
 	},
+	geoWithin(quotedCol, circle) {
+		const dist = mysqlGeoDistanceExpr(quotedCol, circle.center);
+		return {
+			sql: `${dist.sql} <= ?`,
+			params: [...dist.params, circle.radius]
+		};
+	},
 	createViewPrefix: "CREATE OR REPLACE VIEW"
 };
 /**
+* Spherical distance in meters from a POINT column to a query point.
+* Used as the `distExpr` of the shared geo search builder.
+*/
+function mysqlGeoDistanceExpr(quotedCol, point) {
+	return {
+		sql: `ST_Distance_Sphere(${quotedCol}, ST_SRID(POINT(?, ?), 4326))`,
+		params: [point[0], point[1]]
+	};
+}
+/**
+* Encodes a `[lng, lat]` tuple in MySQL's internal geometry format
+* (4-byte SRID LE + WKB point) — geometry columns accept it directly as a
+* binary parameter, bypassing the WKT/WKB axis-order pitfalls entirely.
+*/
+function geoPointToMysqlInternal(point) {
+	const buf = Buffer.alloc(25);
+	buf.writeUInt32LE(4326, 0);
+	buf.writeUInt8(1, 4);
+	buf.writeUInt32LE(1, 5);
+	buf.writeDoubleLE(point[0], 9);
+	buf.writeDoubleLE(point[1], 17);
+	return buf;
+}
+/**
+* Decodes a geo read value back to `[lng, lat]`. The mysql2 driver parses
+* POINT columns to `{x, y}` objects (internal order: x=lng, y=lat); raw
+* internal-format buffers are handled for drivers that don't.
+*/
+function mysqlGeoValueToPoint(value) {
+	if (typeof value === "object" && value !== null && typeof value.x === "number" && typeof value.y === "number") return [value.x, value.y];
+	if (value instanceof Uint8Array && value.length >= 25) {
+		const buf = Buffer.isBuffer(value) ? value : Buffer.from(value);
+		const littleEndian = buf.readUInt8(4) === 1;
+		if (((littleEndian ? buf.readUInt32LE(5) : buf.readUInt32BE(5)) & 255) === 1) return [littleEndian ? buf.readDoubleLE(9) : buf.readDoubleBE(9), littleEndian ? buf.readDoubleLE(17) : buf.readDoubleBE(17)];
+	}
+}
+/**
 * Builds an INSERT statement.
 */
 function buildInsert$1(table, data) {
@@ -121,6 +164,7 @@ function mysqlTypeFromField(field) {
 	const metadata = field.type?.metadata;
 	const mysqlTypeOverride = metadata?.get("db.mysql.type");
 	if (mysqlTypeOverride) return mysqlTypeOverride;
+	if (field.isGeoPoint && !field.encrypted) return "POINT SRID 4326";
 	const unsigned = metadata?.has("db.mysql.unsigned") ?? false;
 	const precision = metadata?.get("db.column.precision");
 	switch (field.designType) {
@@ -409,6 +453,13 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 			toStorage: (value) => typeof value === "number" ? epochMsToUtcDatetime(value) : value,
 			fromStorage: utcDatetimeToEpochMs
 		};
+		if (field.isGeoPoint && !field.encrypted) return {
+			toStorage: (value) => {
+				const point = normalizeGeoPointValue(value);
+				return point ? geoPointToMysqlInternal(point) : value;
+			},
+			fromStorage: (value) => mysqlGeoValueToPoint(value) ?? value
+		};
 	}
 	/**
 	* Wraps an async write operation to catch MySQL constraint errors
@@ -578,8 +629,11 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		this._log(sql, params);
 		return { deletedCount: (await this._wrapConstraintError(() => this._exec().run(sql, params))).affectedRows };
 	}
-	async ensureTable() {
+	async prepareTypeMapper() {
 		if (this._supportsVector === void 0 && this._vectorFields.size > 0) await this._detectVectorSupport();
+	}
+	async ensureTable() {
+		await this.prepareTypeMapper();
 		if (this._table instanceof AtscriptDbView) return this._ensureView();
 		const sql = buildCreateTable(this.resolveTableName(), this._table.fieldDescriptors, this._table.foreignKeys, {
 			engine: this._engine,
@@ -603,12 +657,12 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 	}
 	async getExistingColumnsForTable(tableName) {
 		const schema = this._schema;
-		return (await this._exec().all(`SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_KEY, COLUMN_DEFAULT
+		return (await this._exec().all(`SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_KEY, COLUMN_DEFAULT, SRS_ID
        FROM INFORMATION_SCHEMA.COLUMNS
        WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
        ORDER BY ORDINAL_POSITION`, [tableName, schema])).map((r) => ({
 			name: r.COLUMN_NAME,
-			type: r.COLUMN_TYPE.toUpperCase(),
+			type: r.SRS_ID == null ? r.COLUMN_TYPE.toUpperCase() : `${r.COLUMN_TYPE.toUpperCase()} SRID ${r.SRS_ID}`,
 			notnull: r.IS_NULLABLE === "NO",
 			pk: r.COLUMN_KEY === "PRI",
 			dflt_value: normalizeMysqlDefault(r.COLUMN_DEFAULT)
@@ -629,7 +683,7 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 			let ddl = `ALTER TABLE ${quoteTableName(tableName)} ADD COLUMN ${qi(field.physicalName)} ${sqlType}`;
 			if (!field.optional && !field.isPrimaryKey) ddl += " NOT NULL";
 			if (field.defaultValue?.kind === "value") ddl += ` DEFAULT ${defaultValueToSqlLiteral(field.designType, field.defaultValue.value)}`;
-			else if (!field.optional && !field.isPrimaryKey) ddl += ` DEFAULT ${defaultValueForType(field.designType)}`;
+			else if (!field.optional && !field.isPrimaryKey) ddl += field.isGeoPoint && !field.encrypted ? ` DEFAULT (ST_SRID(POINT(0, 0), 4326))` : ` DEFAULT ${defaultValueForType(field.designType)}`;
 			if (field.collate) {
 				const nativeCollate = field.type?.metadata?.get("db.mysql.collate");
 				ddl += ` COLLATE ${nativeCollate ?? collationToMysql(field.collate)}`;
@@ -640,6 +694,10 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		}
 		for (const { field } of diff.typeChanged ?? []) {
 			const sqlType = this.typeMapper(field);
+			if (field.isGeoPoint && !field.encrypted && sqlType.startsWith("POINT")) {
+				await this._migrateJsonColumnToPoint(tableName, field);
+				continue;
+			}
 			let ddl = `ALTER TABLE ${quoteTableName(tableName)} MODIFY COLUMN ${qi(field.physicalName)} ${sqlType}`;
 			if (!field.optional && !field.isPrimaryKey) ddl += " NOT NULL";
 			this._log(ddl);
@@ -726,6 +784,21 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		this._log(ddl);
 		await this._exec().exec(ddl);
 	}
+	async dropIndexesForColumns(columns) {
+		const placeholders = columns.map(() => "?").join(", ");
+		const rows = await this._exec().all(`SELECT DISTINCT INDEX_NAME AS name FROM INFORMATION_SCHEMA.STATISTICS
+       WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
+         AND INDEX_NAME LIKE 'atscript\\_\\_%' AND COLUMN_NAME IN (${placeholders})`, [
+			this._table.tableName,
+			this._schema,
+			...columns
+		]);
+		for (const row of rows) {
+			const sql = `DROP INDEX ${qi(row.name)} ON ${quoteTableName(this.resolveTableName())}`;
+			this._log(sql);
+			await this._exec().exec(sql);
+		}
+	}
 	async dropTableByName(tableName) {
 		const ddl = `DROP TABLE IF EXISTS ${quoteTableName(tableName)}`;
 		this._log(ddl);
@@ -762,9 +835,28 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		const schema = this._schema;
 		const stringFields = new Set(this._table.fieldDescriptors.filter((f) => f.designType === "string").map((f) => f.physicalName));
 		await this.syncIndexesWithDiff({
-			listExisting: async () => this._exec().all(`SELECT DISTINCT INDEX_NAME as name FROM INFORMATION_SCHEMA.STATISTICS
-           WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())`, [tableName, schema]),
+			listExisting: async () => {
+				return (await this._exec().all(`SELECT INDEX_NAME AS name,
+                  GROUP_CONCAT(COLUMN_NAME ORDER BY SEQ_IN_INDEX SEPARATOR ',') AS columns
+           FROM INFORMATION_SCHEMA.STATISTICS
+           WHERE TABLE_NAME = ? AND TABLE_SCHEMA = COALESCE(?, DATABASE())
+           GROUP BY INDEX_NAME`, [tableName, schema])).map((r) => ({
+					name: r.name,
+					columns: r.columns ? r.columns.split(",") : void 0
+				}));
+			},
 			createIndex: async (index) => {
+				if (index.type === "geo") {
+					const fieldMeta = this._table.fieldDescriptors.find((f) => f.physicalName === index.fields[0]?.name);
+					if (fieldMeta?.optional) {
+						this.logger.warn(`[mysql] geo index "${index.name}" skipped — SPATIAL indexes require a NOT NULL column; make "${fieldMeta.path}" required to index it`);
+						return;
+					}
+					const sql = `CREATE SPATIAL INDEX ${qi(index.key)} ON ${quoteTableName(this.resolveTableName())} (${qi(index.fields[0].name)})`;
+					this._log(sql);
+					await this._exec().exec(sql);
+					return;
+				}
 				const unique = index.type === "unique" ? "UNIQUE " : "";
 				const fulltext = index.type === "fulltext" ? "FULLTEXT " : "";
 				const isFulltext = index.type === "fulltext";
@@ -779,10 +871,6 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 				const sql = `DROP INDEX ${qi(name)} ON ${quoteTableName(this.resolveTableName())}`;
 				this._log(sql);
 				await this._exec().exec(sql);
-			},
-			warnUnsupportedTypes: {
-				adapter: "mysql",
-				types: ["geo"]
 			}
 		});
 	}
@@ -1009,6 +1097,65 @@ var MysqlAdapter = class MysqlAdapter extends BaseDbAdapter {
 		if (queryThreshold !== void 0) return queryThreshold;
 		return this._vectorThresholds.get(indexName);
 	}
+	/** Native POINT SRID 4326 + ST_Distance_Sphere — available on MySQL 8.0+. */
+	isGeoSearchable() {
+		return true;
+	}
+	async geoSearch(point, query, indexName) {
+		const { sql, params } = this._buildGeoSearchSelect(this._prepareGeoSearch(point, query, indexName));
+		this._log(sql, params);
+		return (await this._exec().all(sql, params)).map((row) => renameGeoDistance(row));
+	}
+	async geoSearchWithCount(point, query, indexName) {
+		const ctx = this._prepareGeoSearch(point, query, indexName);
+		const { sql, params } = this._buildGeoSearchSelect(ctx);
+		const countFrag = buildGeoSearchCount(mysqlDialect, ctx.tableName, ctx.where, ctx.dist, ctx.window);
+		this._log(sql, params);
+		this._log(countFrag.sql, countFrag.params);
+		const [rows, countRow] = await Promise.all([this._exec().all(sql, params), this._exec().get(countFrag.sql, countFrag.params)]);
+		return {
+			data: rows.map((row) => renameGeoDistance(row)),
+			count: Number(countRow?.cnt ?? 0)
+		};
+	}
+	/** Resolves the shared parts of a geo search once (column, filter, distance, window). */
+	_prepareGeoSearch(point, query, indexName) {
+		const column = this._resolveGeoColumn(indexName);
+		const controls = query.controls ?? {};
+		return {
+			tableName: this.resolveTableName(),
+			where: buildWhere(query.filter),
+			dist: mysqlGeoDistanceExpr(qi(column), point),
+			window: geoWindowFromControls(controls),
+			controls
+		};
+	}
+	_buildGeoSearchSelect(ctx) {
+		return buildGeoSearchSelect(mysqlDialect, ctx.tableName, ctx.where, ctx.dist, ctx.window, {
+			$limit: ctx.controls.$limit,
+			$skip: ctx.controls.$skip
+		});
+	}
+	/**
+	* Migrates a v1 JSON `[lng, lat]` column to native `POINT SRID 4326` via a
+	* temp column (MySQL has no JSON→geometry cast for MODIFY COLUMN).
+	*/
+	async _migrateJsonColumnToPoint(tableName, field) {
+		const col = qi(field.physicalName);
+		const tmp = qi(`${field.physicalName}__geo_mig`);
+		const quotedTable = quoteTableName(tableName);
+		const steps = [
+			`ALTER TABLE ${quotedTable} ADD COLUMN ${tmp} POINT SRID 4326 NULL`,
+			`UPDATE ${quotedTable} SET ${tmp} = ST_SRID(POINT(CAST(${col}->>'$[0]' AS DOUBLE), CAST(${col}->>'$[1]' AS DOUBLE)), 4326) WHERE ${col} IS NOT NULL`,
+			`ALTER TABLE ${quotedTable} DROP COLUMN ${col}`,
+			`ALTER TABLE ${quotedTable} RENAME COLUMN ${tmp} TO ${col}`,
+			...field.optional || field.isPrimaryKey ? [] : [`ALTER TABLE ${quotedTable} MODIFY COLUMN ${col} POINT SRID 4326 NOT NULL`]
+		];
+		for (const ddl of steps) {
+			this._log(ddl);
+			await this._exec().exec(ddl);
+		}
+	}
 };
 /**
 * Normalizes MySQL INFORMATION_SCHEMA.COLUMNS.COLUMN_DEFAULT values
@@ -1191,4 +1338,4 @@ function createAdapter(uri, options) {
 	return new DbSpace(() => new MysqlAdapter(driver));
 }
 //#endregion
-export { Mysql2Driver, MysqlAdapter, MysqlPlugin, buildWhere, createAdapter };
+export { Mysql2Driver, MysqlAdapter, buildWhere, createAdapter };

package/dist/plugin.cjs

@@ -1,3 +1,94 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_plugin = require("./plugin-AzwuXV59.cjs");
-exports.MysqlPlugin = require_plugin.MysqlPlugin;
+let _atscript_core = require("@atscript/core");
+//#region src/plugin/annotations.ts
+/**
+* MySQL-specific annotations.
+*
+* Merged into the global config under `{ db: { mysql: ... } }` so they
+* live alongside core's `@db.table`, `@db.index.*`, etc.
+*
+* These annotations opt-in to MySQL-specific behavior. Files using only
+* portable `@db.*` annotations remain adapter-agnostic.
+*/
+const annotations = {
+	engine: new _atscript_core.AnnotationSpec({
+		description: "Specifies the MySQL storage engine.\n\n**Default:** `\"InnoDB\"`\n\n```atscript\n@db.mysql.engine \"MyISAM\"\nexport interface Logs { ... }\n```",
+		nodeType: ["interface"],
+		multiple: false,
+		argument: {
+			name: "engine",
+			type: "string",
+			values: [
+				"InnoDB",
+				"MyISAM",
+				"MEMORY",
+				"CSV",
+				"ARCHIVE"
+			],
+			description: "MySQL storage engine name."
+		}
+	}),
+	charset: new _atscript_core.AnnotationSpec({
+		description: "Specifies the character set for the table or column.\n\n**Default:** `\"utf8mb4\"`\n\n```atscript\n@db.mysql.charset \"latin1\"\nexport interface Legacy { ... }\n```",
+		nodeType: ["interface", "prop"],
+		multiple: false,
+		argument: {
+			name: "charset",
+			type: "string",
+			values: [
+				"utf8mb4",
+				"utf8",
+				"latin1",
+				"ascii",
+				"binary"
+			],
+			description: "MySQL character set name."
+		}
+	}),
+	collate: new _atscript_core.AnnotationSpec({
+		description: "Specifies a native MySQL collation (overrides portable `@db.column.collate`).\n\n```atscript\n@db.mysql.collate \"utf8mb4_turkish_ci\"\nname: string\n```",
+		nodeType: ["interface", "prop"],
+		multiple: false,
+		argument: {
+			name: "collation",
+			type: "string",
+			description: "Native MySQL collation name (e.g., \"utf8mb4_turkish_ci\")."
+		}
+	}),
+	unsigned: new _atscript_core.AnnotationSpec({
+		description: "Adds the UNSIGNED modifier to an integer column.\n\n```atscript\n@db.mysql.unsigned\nage: number.int\n```",
+		nodeType: ["prop"],
+		multiple: false
+	}),
+	type: new _atscript_core.AnnotationSpec({
+		description: "Overrides the native MySQL column type.\n\n```atscript\n@db.mysql.type \"MEDIUMTEXT\"\nbio: string\n```",
+		nodeType: ["prop"],
+		multiple: false,
+		argument: {
+			name: "type",
+			type: "string",
+			description: "Native MySQL column type (e.g., \"MEDIUMTEXT\", \"TINYTEXT\")."
+		}
+	}),
+	onUpdate: new _atscript_core.AnnotationSpec({
+		description: "Sets the MySQL ON UPDATE clause for a column.\n\n```atscript\n@db.mysql.onUpdate \"CURRENT_TIMESTAMP\"\nupdatedAt: number.timestamp\n```",
+		nodeType: ["prop"],
+		multiple: false,
+		argument: {
+			name: "expression",
+			type: "string",
+			values: ["CURRENT_TIMESTAMP"],
+			description: "Expression to evaluate on row update."
+		}
+	})
+};
+//#endregion
+//#region src/plugin/index.ts
+const MysqlPlugin = () => ({
+	name: "mysql",
+	config() {
+		return { annotations: { db: { mysql: annotations } } };
+	}
+});
+//#endregion
+exports.MysqlPlugin = MysqlPlugin;

package/dist/plugin.d.cts

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

package/dist/plugin.d.mts

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

package/dist/plugin.mjs

@@ -1,2 +1,93 @@
-import { t as MysqlPlugin } from "./plugin-CPJY5K_I.mjs";
+import { AnnotationSpec } from "@atscript/core";
+//#region src/plugin/annotations.ts
+/**
+* MySQL-specific annotations.
+*
+* Merged into the global config under `{ db: { mysql: ... } }` so they
+* live alongside core's `@db.table`, `@db.index.*`, etc.
+*
+* These annotations opt-in to MySQL-specific behavior. Files using only
+* portable `@db.*` annotations remain adapter-agnostic.
+*/
+const annotations = {
+	engine: new AnnotationSpec({
+		description: "Specifies the MySQL storage engine.\n\n**Default:** `\"InnoDB\"`\n\n```atscript\n@db.mysql.engine \"MyISAM\"\nexport interface Logs { ... }\n```",
+		nodeType: ["interface"],
+		multiple: false,
+		argument: {
+			name: "engine",
+			type: "string",
+			values: [
+				"InnoDB",
+				"MyISAM",
+				"MEMORY",
+				"CSV",
+				"ARCHIVE"
+			],
+			description: "MySQL storage engine name."
+		}
+	}),
+	charset: new AnnotationSpec({
+		description: "Specifies the character set for the table or column.\n\n**Default:** `\"utf8mb4\"`\n\n```atscript\n@db.mysql.charset \"latin1\"\nexport interface Legacy { ... }\n```",
+		nodeType: ["interface", "prop"],
+		multiple: false,
+		argument: {
+			name: "charset",
+			type: "string",
+			values: [
+				"utf8mb4",
+				"utf8",
+				"latin1",
+				"ascii",
+				"binary"
+			],
+			description: "MySQL character set name."
+		}
+	}),
+	collate: new AnnotationSpec({
+		description: "Specifies a native MySQL collation (overrides portable `@db.column.collate`).\n\n```atscript\n@db.mysql.collate \"utf8mb4_turkish_ci\"\nname: string\n```",
+		nodeType: ["interface", "prop"],
+		multiple: false,
+		argument: {
+			name: "collation",
+			type: "string",
+			description: "Native MySQL collation name (e.g., \"utf8mb4_turkish_ci\")."
+		}
+	}),
+	unsigned: new AnnotationSpec({
+		description: "Adds the UNSIGNED modifier to an integer column.\n\n```atscript\n@db.mysql.unsigned\nage: number.int\n```",
+		nodeType: ["prop"],
+		multiple: false
+	}),
+	type: new AnnotationSpec({
+		description: "Overrides the native MySQL column type.\n\n```atscript\n@db.mysql.type \"MEDIUMTEXT\"\nbio: string\n```",
+		nodeType: ["prop"],
+		multiple: false,
+		argument: {
+			name: "type",
+			type: "string",
+			description: "Native MySQL column type (e.g., \"MEDIUMTEXT\", \"TINYTEXT\")."
+		}
+	}),
+	onUpdate: new AnnotationSpec({
+		description: "Sets the MySQL ON UPDATE clause for a column.\n\n```atscript\n@db.mysql.onUpdate \"CURRENT_TIMESTAMP\"\nupdatedAt: number.timestamp\n```",
+		nodeType: ["prop"],
+		multiple: false,
+		argument: {
+			name: "expression",
+			type: "string",
+			values: ["CURRENT_TIMESTAMP"],
+			description: "Expression to evaluate on row update."
+		}
+	})
+};
+//#endregion
+//#region src/plugin/index.ts
+const MysqlPlugin = () => ({
+	name: "mysql",
+	config() {
+		return { annotations: { db: { mysql: annotations } } };
+	}
+});
+//#endregion
 export { MysqlPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-mysql",
-  "version": "0.1.104",
+  "version": "0.1.106",
   "description": "MySQL adapter for @atscript/db with mysql2 driver support.",
   "keywords": [
     "atscript",
@@ -41,19 +41,19 @@
     "access": "public"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.75",
-    "@atscript/typescript": "^0.1.75",
+    "@atscript/core": "^0.1.76",
+    "@atscript/typescript": "^0.1.76",
     "@uniqu/core": "^0.1.6",
     "mysql2": "^3.11.0",
-    "unplugin-atscript": "^0.1.75"
+    "unplugin-atscript": "^0.1.76"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.75",
-    "@atscript/typescript": "^0.1.75",
+    "@atscript/core": "^0.1.76",
+    "@atscript/typescript": "^0.1.76",
     "@uniqu/core": "^0.1.6",
     "mysql2": ">=3.0.0",
-    "@atscript/db": "^0.1.104",
-    "@atscript/db-sql-tools": "^0.1.104"
+    "@atscript/db": "^0.1.106",
+    "@atscript/db-sql-tools": "^0.1.106"
   },
   "peerDependenciesMeta": {
     "mysql2": {

package/dist/index-BLQr6loH.d.cts

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

package/dist/index-BLQr6loH.d.mts

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

package/dist/plugin-AzwuXV59.cjs

@@ -1,98 +0,0 @@
-let _atscript_core = require("@atscript/core");
-//#region src/plugin/annotations.ts
-/**
-* MySQL-specific annotations.
-*
-* Merged into the global config under `{ db: { mysql: ... } }` so they
-* live alongside core's `@db.table`, `@db.index.*`, etc.
-*
-* These annotations opt-in to MySQL-specific behavior. Files using only
-* portable `@db.*` annotations remain adapter-agnostic.
-*/
-const annotations = {
-	engine: new _atscript_core.AnnotationSpec({
-		description: "Specifies the MySQL storage engine.\n\n**Default:** `\"InnoDB\"`\n\n```atscript\n@db.mysql.engine \"MyISAM\"\nexport interface Logs { ... }\n```",
-		nodeType: ["interface"],
-		multiple: false,
-		argument: {
-			name: "engine",
-			type: "string",
-			values: [
-				"InnoDB",
-				"MyISAM",
-				"MEMORY",
-				"CSV",
-				"ARCHIVE"
-			],
-			description: "MySQL storage engine name."
-		}
-	}),
-	charset: new _atscript_core.AnnotationSpec({
-		description: "Specifies the character set for the table or column.\n\n**Default:** `\"utf8mb4\"`\n\n```atscript\n@db.mysql.charset \"latin1\"\nexport interface Legacy { ... }\n```",
-		nodeType: ["interface", "prop"],
-		multiple: false,
-		argument: {
-			name: "charset",
-			type: "string",
-			values: [
-				"utf8mb4",
-				"utf8",
-				"latin1",
-				"ascii",
-				"binary"
-			],
-			description: "MySQL character set name."
-		}
-	}),
-	collate: new _atscript_core.AnnotationSpec({
-		description: "Specifies a native MySQL collation (overrides portable `@db.column.collate`).\n\n```atscript\n@db.mysql.collate \"utf8mb4_turkish_ci\"\nname: string\n```",
-		nodeType: ["interface", "prop"],
-		multiple: false,
-		argument: {
-			name: "collation",
-			type: "string",
-			description: "Native MySQL collation name (e.g., \"utf8mb4_turkish_ci\")."
-		}
-	}),
-	unsigned: new _atscript_core.AnnotationSpec({
-		description: "Adds the UNSIGNED modifier to an integer column.\n\n```atscript\n@db.mysql.unsigned\nage: number.int\n```",
-		nodeType: ["prop"],
-		multiple: false
-	}),
-	type: new _atscript_core.AnnotationSpec({
-		description: "Overrides the native MySQL column type.\n\n```atscript\n@db.mysql.type \"MEDIUMTEXT\"\nbio: string\n```",
-		nodeType: ["prop"],
-		multiple: false,
-		argument: {
-			name: "type",
-			type: "string",
-			description: "Native MySQL column type (e.g., \"MEDIUMTEXT\", \"TINYTEXT\")."
-		}
-	}),
-	onUpdate: new _atscript_core.AnnotationSpec({
-		description: "Sets the MySQL ON UPDATE clause for a column.\n\n```atscript\n@db.mysql.onUpdate \"CURRENT_TIMESTAMP\"\nupdatedAt: number.timestamp\n```",
-		nodeType: ["prop"],
-		multiple: false,
-		argument: {
-			name: "expression",
-			type: "string",
-			values: ["CURRENT_TIMESTAMP"],
-			description: "Expression to evaluate on row update."
-		}
-	})
-};
-//#endregion
-//#region src/plugin/index.ts
-const MysqlPlugin = () => ({
-	name: "mysql",
-	config() {
-		return { annotations: { db: { mysql: annotations } } };
-	}
-});
-//#endregion
-Object.defineProperty(exports, "MysqlPlugin", {
-	enumerable: true,
-	get: function() {
-		return MysqlPlugin;
-	}
-});

package/dist/plugin-CPJY5K_I.mjs

@@ -1,93 +0,0 @@
-import { AnnotationSpec } from "@atscript/core";
-//#region src/plugin/annotations.ts
-/**
-* MySQL-specific annotations.
-*
-* Merged into the global config under `{ db: { mysql: ... } }` so they
-* live alongside core's `@db.table`, `@db.index.*`, etc.
-*
-* These annotations opt-in to MySQL-specific behavior. Files using only
-* portable `@db.*` annotations remain adapter-agnostic.
-*/
-const annotations = {
-	engine: new AnnotationSpec({
-		description: "Specifies the MySQL storage engine.\n\n**Default:** `\"InnoDB\"`\n\n```atscript\n@db.mysql.engine \"MyISAM\"\nexport interface Logs { ... }\n```",
-		nodeType: ["interface"],
-		multiple: false,
-		argument: {
-			name: "engine",
-			type: "string",
-			values: [
-				"InnoDB",
-				"MyISAM",
-				"MEMORY",
-				"CSV",
-				"ARCHIVE"
-			],
-			description: "MySQL storage engine name."
-		}
-	}),
-	charset: new AnnotationSpec({
-		description: "Specifies the character set for the table or column.\n\n**Default:** `\"utf8mb4\"`\n\n```atscript\n@db.mysql.charset \"latin1\"\nexport interface Legacy { ... }\n```",
-		nodeType: ["interface", "prop"],
-		multiple: false,
-		argument: {
-			name: "charset",
-			type: "string",
-			values: [
-				"utf8mb4",
-				"utf8",
-				"latin1",
-				"ascii",
-				"binary"
-			],
-			description: "MySQL character set name."
-		}
-	}),
-	collate: new AnnotationSpec({
-		description: "Specifies a native MySQL collation (overrides portable `@db.column.collate`).\n\n```atscript\n@db.mysql.collate \"utf8mb4_turkish_ci\"\nname: string\n```",
-		nodeType: ["interface", "prop"],
-		multiple: false,
-		argument: {
-			name: "collation",
-			type: "string",
-			description: "Native MySQL collation name (e.g., \"utf8mb4_turkish_ci\")."
-		}
-	}),
-	unsigned: new AnnotationSpec({
-		description: "Adds the UNSIGNED modifier to an integer column.\n\n```atscript\n@db.mysql.unsigned\nage: number.int\n```",
-		nodeType: ["prop"],
-		multiple: false
-	}),
-	type: new AnnotationSpec({
-		description: "Overrides the native MySQL column type.\n\n```atscript\n@db.mysql.type \"MEDIUMTEXT\"\nbio: string\n```",
-		nodeType: ["prop"],
-		multiple: false,
-		argument: {
-			name: "type",
-			type: "string",
-			description: "Native MySQL column type (e.g., \"MEDIUMTEXT\", \"TINYTEXT\")."
-		}
-	}),
-	onUpdate: new AnnotationSpec({
-		description: "Sets the MySQL ON UPDATE clause for a column.\n\n```atscript\n@db.mysql.onUpdate \"CURRENT_TIMESTAMP\"\nupdatedAt: number.timestamp\n```",
-		nodeType: ["prop"],
-		multiple: false,
-		argument: {
-			name: "expression",
-			type: "string",
-			values: ["CURRENT_TIMESTAMP"],
-			description: "Expression to evaluate on row update."
-		}
-	})
-};
-//#endregion
-//#region src/plugin/index.ts
-const MysqlPlugin = () => ({
-	name: "mysql",
-	config() {
-		return { annotations: { db: { mysql: annotations } } };
-	}
-});
-//#endregion
-export { MysqlPlugin as t };