feat: metona-sqlark v0.1.12 — 前端TypeScript关系型数据库

- 4种存储引擎：Memory / IndexedDB / OPFS / Hybrid
- 完整SQL支持：SELECT/INSERT/UPDATE/DELETE/JOIN/GROUP BY/HAVING/DISTINCT
- Query Builder链式API + TypeScript泛型支持
- 聚合函数：COUNT/SUM/AVG/MIN/MAX
- 事务、插件系统(14 hooks)、发布订阅、数据迁移、导入导出
- React/Vue框架集成
- 264个测试用例，93.46%覆盖率
- 零运行时依赖

src/index.ts

@@ -0,0 +1,83 @@
+/**
+ * metona-sqlark — 入口文件
+ * @module metona-sqlark
+ * @version 0.1.12
+ *
+ * 前端关系型数据库，内存与磁盘双模式。
+ * 支持 Query Builder 链式 API 和 SQL 字符串查询。
+ */
+
+import { MetonaSqlark } from './core';
+import type { DatabaseConfig } from './constants';
+import { VERSION } from './constants';
+
+// ---------------------------------------------------------------------------
+//  工厂函数
+// ---------------------------------------------------------------------------
+
+/**
+ * 创建数据库实例并初始化
+ *
+ * @example
+ * ```ts
+ * const db = await MetonaSqlark.create({
+ *   name: 'my-app',
+ *   mode: 'hybrid',
+ * });
+ *
+ * await db.defineTable('users', {
+ *   id: { type: 'string', primaryKey: true },
+ *   name: { type: 'string', required: true },
+ * });
+ *
+ * await db.table('users').insert({ id: '1', name: 'Alice' });
+ * const results = await db.query('SELECT * FROM users');
+ * ```
+ */
+async function create(config: DatabaseConfig): Promise<MetonaSqlark> {
+  const db = new MetonaSqlark(config);
+  await db.init();
+  return db;
+}
+
+// ---------------------------------------------------------------------------
+//  全局 API
+// ---------------------------------------------------------------------------
+
+const api = {
+  VERSION,
+  version: VERSION,
+  create,
+  MetonaSqlark,
+  MeSqlark: MetonaSqlark,
+};
+
+// 浏览器全局挂载
+declare global { interface Window { MetonaSqlark: typeof api; MeSqlark: typeof api; } }
+if (typeof window !== 'undefined') {
+  window.MetonaSqlark = api;
+  window.MeSqlark = api;
+}
+
+export default api;
+export {
+  api,
+  VERSION,
+  create,
+  MetonaSqlark,
+};
+
+// 别名
+export const MeSqlark = MetonaSqlark;
+
+// 类型导出
+export type { DatabaseConfig, TableSchema, ColumnDef, FieldType, StorageMode, DiskEngine } from './constants';
+export type { IStorageEngine } from './engine/interface';
+export type { Statement, SelectStatement, InsertStatement, UpdateStatement, DeleteStatement } from './query/ast';
+export { MemoryEngine } from './engine/memory';
+export { IndexedDBEngine } from './engine/indexeddb';
+export { OPFSEngine } from './engine/opfs';
+export { HybridEngine } from './hybrid/index';
+export { Table } from './table/table';
+export { parse } from './sql/parser';
+export { tokenize } from './sql/lexer';