imodel 0.4.0 → 0.4.1

package/index.d.mts

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.4.0
+ * imodel v0.4.1
  * (c) 2019-2025 undefined
  * @license undefined
  */
@@ -1841,6 +1841,33 @@ declare function toPrimary(fields: string[], data: Record<string, any>): string;
  */
 declare function toPrimaries(model: any, documents: any): string | string[];
 
+/**
+ * @typedef {object} Scene.Define
+ * @property {string} table
+ * @property {[column: string, field?: string, value?: any][]} fields
+ */
+/** @import {FieldDefine, Fields, TableDefine,} from './types/table' */
+declare class Scene {
+    /**
+     *
+     * @param {Map<string, Scene.Define>} map
+     */
+    constructor(map: Map<string, Scene.Define>);
+    /**
+     * @template {TableDefine<Fields, string>} T
+     * @param {T} table
+     * @returns {T}
+     */
+    table<T extends TableDefine<Fields, string>>(table: T): T;
+    #private;
+}
+declare namespace Scene {
+    type Define = {
+        table: string;
+        fields: [column: string, field?: string, value?: any][];
+    };
+}
+
 /**
  * @implements {Save}
  * @implements {Destroy}
@@ -1868,6 +1895,8 @@ declare class Model implements Save, Destroy, PseudoDestroy {
      * @returns {T}
      */
     static bindFields<T extends typeof Model>(this: T, fields?: string[]): T;
+    /** @type {Scene?} */
+    static get scene(): Scene | null;
     /**
      * @template {typeof Model} T
      * @this {T}
@@ -1989,6 +2018,12 @@ declare class Model implements Save, Destroy, PseudoDestroy {
      * @returns {VoidReturn}
      */
     $_onAfterDelete(t: Connection, update: object | null): VoidReturn;
+    /**
+     * @template {TableDefine<Fields, string>} T
+     * @param {T} table
+     * @returns {T}
+     */
+    $table<T extends TableDefine<Fields, string>>(table: T): T;
     /**
      * @param {Connection} t
      * @param {(data: any, newData?: any) => Promise<object?>} run
@@ -2198,4 +2233,4 @@ declare function field<T extends MainFieldType>(type: T, options: {
 declare function setDevelopment(d?: boolean): void;
 declare let isDevelopment: boolean;
 
-export { Build, type ClassDecorator, type Column, type ColumnOptions, Connection, type Constraint, Create, type DBColumn, type DBIndex, type DBTable, Destroy, type Environment, type FieldDecorator, type FieldDefine, type FieldDefineOption, type FieldDefineType, type FieldSpecific, type FieldSpecificValue, type FieldType, type FieldTypeDefine, type FieldValue, type Fields, type FindArg, type FindRange, type GetName, type IConnection, type Index, type IndexInfo, type IndexOptions, type Join, type JoinType, type MainFieldType, type MaybePromise, Model, type Options, PseudoDestroy, Query, type QueryOptions, type Queryable, Save, Select, SetValue, type Skip, Submodel, type Support, type TableDefine, type TableType, type ToFieldType, type ToType, type TransactionFn, type VirtualTable, Where, type WhereItem, type WhereLike, type WhereOr, type WhereRaw, type WhereValue, type Wheres, column, creating, decrement, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, immutable, increment, index, isDevelopment, isPseudo, submodel as model, multiply, now, primary, prop, pseudo, setDevelopment, sort, submodel, toNot, toPrimaries, toPrimary, undeleted, updating, uuid, values, withDeleted };
+export { Build, type ClassDecorator, type Column, type ColumnOptions, Connection, type Constraint, Create, type DBColumn, type DBIndex, type DBTable, Destroy, type Environment, type FieldDecorator, type FieldDefine, type FieldDefineOption, type FieldDefineType, type FieldSpecific, type FieldSpecificValue, type FieldType, type FieldTypeDefine, type FieldValue, type Fields, type FindArg, type FindRange, type GetName, type IConnection, type Index, type IndexInfo, type IndexOptions, type Join, type JoinType, type MainFieldType, type MaybePromise, Model, type Options, PseudoDestroy, Query, type QueryOptions, type Queryable, Save, Scene, Select, SetValue, type Skip, Submodel, type Support, type TableDefine, type TableType, type ToFieldType, type ToType, type TransactionFn, type VirtualTable, Where, type WhereItem, type WhereLike, type WhereOr, type WhereRaw, type WhereValue, type Wheres, column, creating, decrement, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, immutable, increment, index, isDevelopment, isPseudo, submodel as model, multiply, now, primary, prop, pseudo, setDevelopment, sort, submodel, toNot, toPrimaries, toPrimary, undeleted, updating, uuid, values, withDeleted };

package/index.mjs

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.4.0
+ * imodel v0.4.1
  * (c) 2019-2025 undefined
  * @license undefined
  */
@@ -4208,7 +4208,8 @@ function toPrimaries(model, documents) {
 }
 
 /* eslint-disable max-lines */
-/** @import { Fields, IndexInfo, FieldDefine } from './types' */
+/** @import { Fields, IndexInfo, FieldDefine, TableDefine } from './types' */
+/** @import { Scene } from './Scene.mjs' */
 /**
  * @param {any} a
  * @param {any} b
@@ -5001,6 +5002,24 @@ class Model {
     }
     return this.#do(() => this.$_onBeforeDelete(t, update), () => run(this.#data), () => this.$_onAfterDelete(t, update));
   }
+  /** @type {Scene?} */
+  static get scene() {
+    return null;
+  }
+  /**
+   * @template {TableDefine<Fields, string>} T
+   * @param {T} table
+   * @returns {T}
+   */
+  $table(table) {
+    const {
+      scene
+    } = this.#model;
+    if (!scene) {
+      return table;
+    }
+    return scene.table(table);
+  }
 }
 /**
  * @param {string} key
@@ -5056,6 +5075,129 @@ defGetter('indexes', function () {
   return [];
 });
 
+/**
+ * @typedef {object} Scene.Define
+ * @property {string} table
+ * @property {[column: string, field?: string, value?: any][]} fields
+ */
+/** @import {FieldDefine, Fields, TableDefine,} from './types/table' */
+class Scene {
+  /** @type {Map<string, Scene.Define>} */
+  #map;
+  /** @type {Map<typeof Model, typeof Model>} */
+  #models = new Map();
+  /**
+   *
+   * @param {Map<string, Scene.Define>} map
+   */
+  constructor(map) {
+    this.#map = map;
+  }
+  /**
+   *
+   * @param {Fields} sceneFields
+   * @param {Scene.Define} table
+   * @returns
+   */
+  #cloneField(sceneFields, table) {
+    const allFields = new Map(Object.entries(sceneFields));
+    /** @type {Record<string, FieldDefine>} */
+    const fields = {};
+    for (const [column, field, value] of table.fields) {
+      if (field) {
+        const define = allFields.get(field);
+        allFields.delete(field);
+        if (!define) {
+          throw new Error();
+        }
+        if (!define.type) {
+          throw new Error();
+        }
+        if (typeof define.type !== 'string' && define.type.table) {
+          throw new Error();
+        }
+        fields[field] = {
+          ...define,
+          column
+        };
+      }
+    }
+    for (const [name, define] of allFields) {
+      if (!define.type) {
+        fields[name] = {
+          ...define
+        };
+        continue;
+      }
+      if (typeof define.type === 'string') {
+        throw new Error();
+      }
+      if (typeof define.type === 'function') {
+        fields[name] = {
+          ...define,
+          type: this.#getModel(define.type)
+        };
+        continue;
+      }
+    }
+    return fields;
+  }
+  /**
+   * @template {TableDefine<Fields, string>} T
+   * @param {T} table
+   * @returns {T}
+   */
+  #getModel(table, name = table.table) {
+    const tableMap = this.#map.get(name);
+    if (!tableMap) {
+      throw new Error();
+    }
+    if (typeof table !== 'function') {
+      return {
+        ...table,
+        table: tableMap.table,
+        fields: this.#cloneField(table.fields, tableMap)
+        // TODO: 索引？
+      };
+    }
+    const models = this.#models;
+    const ModelClass = /** @type {typeof Model} */table;
+    const defined = models.get(ModelClass);
+    // @ts-ignore
+    if (defined) {
+      return defined;
+    }
+    class M extends ModelClass {}
+    models.set(table, M);
+    Object.defineProperty(M, 'table', {
+      value: tableMap.table,
+      configurable: true,
+      enumerable: true
+    });
+    Object.defineProperty(M, 'scene', {
+      value: this,
+      configurable: true,
+      enumerable: true
+    });
+    Object.defineProperty(M, 'fields', {
+      value: this.#cloneField(ModelClass.fields, tableMap),
+      enumerable: true,
+      configurable: true
+    });
+    // TODO: 索引？
+    // @ts-ignore
+    return M;
+  }
+  /**
+   * @template {TableDefine<Fields, string>} T
+   * @param {T} table
+   * @returns {T}
+   */
+  table(table) {
+    return this.#getModel(table);
+  }
+}
+
 /** @import { FieldDefine, FieldDefineOption, MainFieldType, ToType } from './types' */
 /**
  * @template {MainFieldType} T
@@ -5204,4 +5346,4 @@ function field(type, {
   };
 }
 
-export { Build, Connection, Create, Destroy, Model, PseudoDestroy, Query, Save, Submodel, Where, column, creating, decrement, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, immutable, increment, index, isDevelopment, isPseudo, submodel as model, multiply, now, primary, prop, pseudo, setDevelopment, sort, submodel, toNot, toPrimaries, toPrimary, undeleted, updating, uuid, values, withDeleted };
+export { Build, Connection, Create, Destroy, Model, PseudoDestroy, Query, Save, Scene, Submodel, Where, column, creating, decrement, field as define, deleted, deleting, divide, field$1 as field, getPrimaryFields, getPrimaryKeys, immutable, increment, index, isDevelopment, isPseudo, submodel as model, multiply, now, primary, prop, pseudo, setDevelopment, sort, submodel, toNot, toPrimaries, toPrimary, undeleted, updating, uuid, values, withDeleted };

package/migrate.d.mts

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.4.0
+ * imodel v0.4.1
  * (c) 2019-2025 undefined
  * @license undefined
  */

package/migrate.mjs

@@ -1,5 +1,5 @@
 /*!
- * imodel v0.4.0
+ * imodel v0.4.1
  * (c) 2019-2025 undefined
  * @license undefined
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imodel",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "main": "index.mjs",
   "type": "module",
   "repository": {