@medyll/idae-machine 0.112.0 → 0.114.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 medyll
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/db/dbFields.d.ts

@@ -40,17 +40,11 @@ export type IDbForge = {
 };
 export declare class IDbCollection {
     collection: TplCollectionName;
-    _dbCollections: IDbCollections;
-    constructor(collection: TplCollectionName, dbCollections: IDbCollections);
+    _dbCollections: IDbBase;
+    constructor(collection: TplCollectionName, dbCollections: IDbBase);
     getCollectionModelTemplate(): Tpl;
-    getCollectionModelTemplateFks(): {
-        [x: string]: {
-            code: string;
-            multiple: boolean;
-            rules: import("@medyll/idae-idbql").CombinedArgs;
-        } | undefined;
-    };
-    getIndexName(): string;
+    getCollectionModelTemplateFks(): Tpl;
+    getIndexName(): any;
     collectionValues(): IDbCollectionValues<any>;
     collectionFieldValues<T extends Record<string, any>>(data: T): IDbCollectionFieldValues<T>;
     fieldForge<T extends Record<string, any>>(fieldName: keyof T, data: T): IDbCollectionFieldForge<T>;
@@ -65,194 +59,70 @@ export declare class IDbCollection {
  * Provides methods to access collections, templates, fields, foreign keys, and type information.
  * Used for dynamic UI generation, validation, and schema-driven logic.
  */
-export declare class IDbCollections {
+export declare class IDbBase {
     #private;
     /**
-     * Stores shared instances of IDbCollectionValues per collection
+     * The database model (schema) used for introspection.
      */
-    private _collectionValuesMap;
+    model: IdbqModel;
     /**
-     * Stores shared instances of IDbCollectionFieldValues per collection+data
+     * Create a new IDbBase instance.
+     * @param model Optional custom model to use (default: schemeModel)
      */
-    private _collectionFieldValuesMap;
+    constructor(model?: IdbqModel);
     /**
-     * Stores shared instances of IDbCollectionFieldForge per collection, field, and data
+     * Get an IDbCollection instance for a collection name.
      */
-    private _collectionFieldForgeMap;
+    get(collection: TplCollectionName): IDbCollection;
     /**
-     * Stores shared instances of IDbFormValidate per collection
+     * Get an IDbCollectionValues instance for a collection name.
      */
-    private _formValidateMap;
+    collectionValues(collection: TplCollectionName): IDbCollectionValues<any>;
     /**
-     * The database model (schema) used for introspection.
+     * Get an IDbCollectionFieldValues instance for a collection and data.
      */
-    model: IdbqModel;
+    collectionFieldValues<T extends Record<string, any>>(collection: TplCollectionName, data: T): IDbCollectionFieldValues<T>;
     /**
-     * Create a new IDbCollections instance.
-     * @param model Optional custom model to use (default: schemeModel)
+     * Get an IDbCollectionFieldForge instance for a collection, field, and data.
      */
-    constructor(model?: IdbqModel);
-    get(collection: TplCollectionName): IDbCollection;
+    collectionFieldForge<T extends Record<string, any>>(collection: TplCollectionName, fieldName: keyof T | string, data: T): IDbCollectionFieldForge<T>;
+    /**
+     * Get an IDbFormValidate instance for a collection name.
+     */
+    formValidate(collection: TplCollectionName): IDbFormValidate;
     /**
      * Parse all collections in the model and return their fields as IDbForge objects.
-     * @returns An object mapping collection names to their parsed fields.
      */
     parseAllCollections(): Record<string, Record<string, IDbForge | undefined> | undefined>;
     /**
      * Parse all fields of a given collection.
-     * @param collection The collection name.
-     * @returns An object mapping field names to their IDbForge representation.
      */
     parseRawCollection(collection: TplCollectionName): Record<string, IDbForge | undefined> | undefined;
     /**
      * Parse a single field of a collection and return its IDbForge metadata.
-     * @param collection The collection name.
-     * @param fieldName The field name.
-     * @returns The IDbForge object for the field, or throws if not found.
      */
     parseCollectionFieldName(collection: TplCollectionName, fieldName: keyof TplFields): IDbForge | undefined;
-    /**
-     * Parse a field rule string and extract its type and arguments.
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info for the rule.
-     */
-    parsFieldRule(fieldRule: IDbFieldRules): Partial<IDbForge> | undefined;
     /**
      * Internal helper to construct an IDbForge object from its components.
-     * @param params The IDbForge properties (collection, fieldName, fieldType, fieldRule, fieldArgs, is).
-     * @returns The constructed IDbForge object.
      */
     private forge;
-    /**
-     * Get the collection object from the model.
-     * @param collection The collection name.
-     * @returns The collection object.
-     */
-    getCollection(collection: TplCollectionName): CollectionModel; /**
-     * Get the collection object from the model.
-     * @param collection The collection name.
-     * @returns The collection object.
-     */
+    getCollection(collection: TplCollectionName): CollectionModel;
     getCollectionModel(collection: TplCollectionName): CollectionModel;
-    /**
-     * Get the template object for a collection.
-     * @param collection The collection name.
-     * @returns The template object.
-     */
     getCollectionModelTemplate(collection: TplCollectionName): Tpl;
-    /**
-     * Get the foreign keys (fks) object for a collection.
-     * @param collection The collection name.
-     * @returns The fks object.
-     */
     getCollectionModelTemplateFks(collection: TplCollectionName): Tpl["fks"];
-    /**
-     * Get the index field name for a collection.
-     * @param collection The collection name.
-     * @returns The index field name.
-     */
-    getIndexName(collection: TplCollectionName): string;
-    /**
-     * Returns a shared instance of IDbCollectionValues for a given collection
-     */
-    getCollectionValues(collection: TplCollectionName): IDbCollectionValues<any>;
-    /**
-     * Returns a shared instance of IDbCollectionFieldValues for a given collection and data
-     * The instance key is based on the collection and the main index of data (or JSON if missing)
-     */
-    getCollectionFieldValues<T extends Record<string, any>>(collection: TplCollectionName, data: T): IDbCollectionFieldValues<T>;
-    /**
-     * Returns a shared instance of IDbCollectionFieldForge for a given collection, field, and data
-     * The instance key is based on collection, field, and the main index of data (or JSON if missing)
-     */
-    getCollectionFieldForge<T extends Record<string, any>>(collection: TplCollectionName, fieldName: keyof T | string, data: T): IDbCollectionFieldForge<T>;
-    /**
-     * Returns a shared instance of IDbFormValidate for a given collection
-     */
-    getFormValidate(collection: TplCollectionName): IDbFormValidate;
-    /**
-     * Get the fields object for a collection.
-     * @param collection The collection name.
-     * @returns The fields object.
-     */
+    getIndexName(collection: TplCollectionName): any;
     getCollectionTemplateFields(collection: TplCollectionName): TplFields;
-    /**
-     * Get the presentation string for a collection (used for display).
-     * @param collection The collection name.
-     * @returns The presentation string.
-     */
     getTemplatePresentation(collection: TplCollectionName): string;
-    /**
-     * Get the field rule for a foreign key field (e.g. 'collection.field').
-     * @param string The string in the form 'collection.field'.
-     * @returns The field rule string, or undefined.
-     */
     getFkFieldType(string: `${string}.${string}`): IDbFieldRules | undefined;
-    /**
-     * Get the fields object for a foreign key collection.
-     * @param string The string in the form 'collection.field'.
-     * @returns The fields object for the referenced collection.
-     */
-    getFkTemplateFields(string: `${string}.${string}`): {
-        [x: string]: import("@medyll/idae-idbql").TplFieldRules;
-    };
-    /**
-     * Test if a field rule matches a given type (primitive, array, object, fk).
-     * @param what The type to test ('primitive', 'array', 'object', 'fk').
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info if match, else undefined.
-     */
+    getFkTemplateFields(string: `${string}.${string}`): any;
     private testIs;
-    /**
-     * Extract type information for a field rule.
-     * @param what The type to extract ('primitive', 'array', 'object', 'fk').
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info.
-     */
     is(what: 'array' | 'object' | 'fk' | 'primitive', fieldRule: IDbFieldRules): Partial<IDbForge>;
-    /**
-     * Get the value of the index field for a given data object.
-     * @param collection The collection name.
-     * @param data The data object.
-     * @returns The value of the index field.
-     */
-    indexValue(collection: TplCollectionName, data: Record<string, any>): any;
-    /**
-     * Extracts type, rule, and argument information from a field rule string.
-     * @param type The type to extract ('primitive', 'array', 'object', 'fk').
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info.
-     */
     extract(type: 'array' | 'object' | 'fk' | 'primitive', fieldRule: IDbFieldRules): Partial<IDbForge>;
-    /**
-     * Parse and return all foreign key collections referenced by a collection.
-     * @param collection The collection name.
-     * @returns An object mapping referenced collection names to their parsed fields.
-     */
     fks(collection: string): {
         [collection: string]: Tpl;
     };
-    /**
-     * Find all collections that reference the target collection via a foreign key.
-     * @param targetCollection The collection name to search for as a target.
-     * @returns An object mapping referencing collections to their fk configs.
-     */
     reverseFks(targetCollection: TplCollectionName): Record<string, any>;
-    /**
-     * Iterate over an array field and return an array of IDbForge objects for each element.
-     * @param collection The collection name.
-     * @param fieldName The field name.
-     * @param data The array data.
-     * @returns An array of IDbForge objects.
-     */
     iterateArrayField(collection: TplCollectionName, fieldName: keyof TplFields, data: any[]): IDbForge[];
-    /**
-     * Iterate over an object field and return an array of IDbForge objects for each property.
-     * @param collection The collection name.
-     * @param fieldName The field name.
-     * @param data The object data.
-     * @returns An array of IDbForge objects.
-     */
     iterateObjectField(collection: TplCollectionName, fieldName: keyof TplFields, data: Record<string, any>): IDbForge[];
 }
 /**
@@ -284,7 +154,7 @@ export declare class IDbCollectionValues<T extends Record<string, any>> {
     /**
      * The IDbCollections instance used for schema introspection.
      */
-    idbCollections: IDbCollections;
+    idbCollections: IDbBase;
     /**
      * The collection name this instance operates on.
      */
@@ -293,7 +163,7 @@ export declare class IDbCollectionValues<T extends Record<string, any>> {
      * Create a new IDbCollectionValues instance for a given collection.
      * @param collectionName The collection name.
      */
-    constructor(collectionName: TplCollectionName, idbCollections?: IDbCollections);
+    constructor(collectionName: TplCollectionName, idbCollections?: IDbBase);
     presentation(data: Record<string, any>): string;
     /**
      * Get the value of the index field for a data object.
@@ -339,7 +209,7 @@ export declare class IDbCollectionFieldValues<T extends Record<string, any>> {
     getForge(fieldName: keyof T): IDbForge | undefined;
     constructor(collection: TplCollectionName, data: T, collectionValues?: IDbCollectionValues<T>);
     format(fieldName: keyof T): string | string[];
-    getInputDataSet(fieldName: keyof T): Record<"data-collection" | "data-fieldName" | "data-fieldType" | "data-fieldArgs" | "data-collectionId", string>;
+    getInputDataSet(fieldName: keyof T): Record<"data-collection" | "data-collectionId" | "data-fieldName" | "data-fieldType" | "data-fieldArgs", string>;
     iterateArray(fieldName: string, data: any[]): IDbForge[];
     iterateObject(fieldName: string, data: Record<string, any>): IDbForge[];
 }
@@ -369,7 +239,7 @@ export declare class IDbCollectionFieldForge<T extends Record<string, any>> {
     #private;
     constructor(collection: TplCollectionName, fieldName: any, data: T, collectionValues?: IDbCollectionValues<T>);
     get format(): string;
-    get inputDataSet(): Record<"data-collection" | "data-fieldName" | "data-fieldType" | "data-fieldArgs" | "data-collectionId", string>;
+    get inputDataSet(): Record<"data-collection" | "data-collectionId" | "data-fieldName" | "data-fieldType" | "data-fieldArgs", string>;
     get forge(): IDbForge | undefined;
     get fieldArgs(): IDbForgeArgs | undefined;
     get fieldType(): IDbFieldType | undefined;
@@ -385,7 +255,7 @@ export declare class IDbFormValidate {
     #private;
     private collection;
     private idbCollections;
-    constructor(collection: TplCollectionName, idbCollections?: IDbCollections);
+    constructor(collection: TplCollectionName, idbCollections?: IDbBase);
     validateField(fieldName: keyof TplFields, value: any): {
         isValid: boolean;
         error?: string;

package/dist/db/dbFields.js

@@ -64,16 +64,16 @@ export class IDbCollection {
         return this._dbCollections.getIndexName(this.collection);
     }
     collectionValues() {
-        return this._dbCollections.getCollectionValues(this.collection);
+        return this._dbCollections.collectionValues(this.collection);
     }
     collectionFieldValues(data) {
-        return this._dbCollections.getCollectionFieldValues(this.collection, data);
+        return this._dbCollections.collectionFieldValues(this.collection, data);
     }
     fieldForge(fieldName, data) {
-        return this._dbCollections.getCollectionFieldForge(this.collection, fieldName, data);
+        return this._dbCollections.collectionFieldForge(this.collection, fieldName, data);
     }
     getFormValidate() {
-        return this._dbCollections.getFormValidate(this.collection);
+        return this._dbCollections.formValidate(this.collection);
     }
     fks() {
         return this._dbCollections.fks(this.collection);
@@ -87,40 +87,50 @@ export class IDbCollection {
  * Provides methods to access collections, templates, fields, foreign keys, and type information.
  * Used for dynamic UI generation, validation, and schema-driven logic.
  */
-export class IDbCollections {
+export class IDbBase {
     /**
-     * Stores shared instances of IDbCollectionValues per collection
+     * The database model (schema) used for introspection.
      */
-    _collectionValuesMap = {};
+    model = schemeModel;
     /**
-     * Stores shared instances of IDbCollectionFieldValues per collection+data
+     * Create a new IDbBase instance.
+     * @param model Optional custom model to use (default: schemeModel)
      */
-    _collectionFieldValuesMap = new Map();
+    constructor(model) {
+        this.model = model ?? schemeModel;
+    }
     /**
-     * Stores shared instances of IDbCollectionFieldForge per collection, field, and data
+     * Get an IDbCollection instance for a collection name.
      */
-    _collectionFieldForgeMap = new Map();
+    get(collection) {
+        return new IDbCollection(collection, this);
+    }
     /**
-     * Stores shared instances of IDbFormValidate per collection
+     * Get an IDbCollectionValues instance for a collection name.
      */
-    _formValidateMap = new Map();
+    collectionValues(collection) {
+        return new IDbCollectionValues(collection, this);
+    }
     /**
-     * The database model (schema) used for introspection.
+     * Get an IDbCollectionFieldValues instance for a collection and data.
      */
-    model = schemeModel;
+    collectionFieldValues(collection, data) {
+        return new IDbCollectionFieldValues(collection, data, this.collectionValues(collection));
+    }
     /**
-     * Create a new IDbCollections instance.
-     * @param model Optional custom model to use (default: schemeModel)
+     * Get an IDbCollectionFieldForge instance for a collection, field, and data.
      */
-    constructor(model) {
-        this.model = model ?? schemeModel;
+    collectionFieldForge(collection, fieldName, data) {
+        return new IDbCollectionFieldForge(collection, fieldName, data, this.collectionValues(collection));
     }
-    get(collection) {
-        return new IDbCollection(collection, this);
+    /**
+     * Get an IDbFormValidate instance for a collection name.
+     */
+    formValidate(collection) {
+        return new IDbFormValidate(collection, this);
     }
     /**
      * Parse all collections in the model and return their fields as IDbForge objects.
-     * @returns An object mapping collection names to their parsed fields.
      */
     parseAllCollections() {
         let out = {};
@@ -131,8 +141,6 @@ export class IDbCollections {
     }
     /**
      * Parse all fields of a given collection.
-     * @param collection The collection name.
-     * @returns An object mapping field names to their IDbForge representation.
      */
     parseRawCollection(collection) {
         const fields = this.getCollectionTemplateFields(collection);
@@ -149,9 +157,6 @@ export class IDbCollections {
     }
     /**
      * Parse a single field of a collection and return its IDbForge metadata.
-     * @param collection The collection name.
-     * @param fieldName The field name.
-     * @returns The IDbForge object for the field, or throws if not found.
      */
     parseCollectionFieldName(collection, fieldName) {
         const field = this.#getTemplateFieldRule(collection, fieldName);
@@ -166,178 +171,53 @@ export class IDbCollections {
         const fieldType = array ?? object ?? fk ?? primitive;
         return this.forge({ collection, fieldName, ...fieldType });
     }
-    /**
-     * Parse a field rule string and extract its type and arguments.
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info for the rule.
-     */
-    parsFieldRule(fieldRule) {
-        if (!fieldRule)
-            return;
-        const fieldType = this.testIs('primitive', fieldRule) ??
-            this.testIs('array', fieldRule) ??
-            this.testIs('object', fieldRule) ??
-            this.testIs('fk', fieldRule);
-        return fieldType;
-    }
     /**
      * Internal helper to construct an IDbForge object from its components.
-     * @param params The IDbForge properties (collection, fieldName, fieldType, fieldRule, fieldArgs, is).
-     * @returns The constructed IDbForge object.
      */
     forge({ collection, fieldName, fieldType, fieldRule, fieldArgs, is }) {
-        return {
-            collection,
-            fieldName,
-            fieldType,
-            fieldRule,
-            fieldArgs,
-            is
-        };
+        return { collection, fieldName, fieldType, fieldRule, fieldArgs, is };
     }
     #getModel() {
         return this.model;
     }
-    /**
-     * Get the collection object from the model.
-     * @param collection The collection name.
-     * @returns The collection object.
-     */
     getCollection(collection) {
         return this.#getModel()[String(collection)];
-    } /**
-     * Get the collection object from the model.
-     * @param collection The collection name.
-     * @returns The collection object.
-     */
+    }
     getCollectionModel(collection) {
         return this.#getModel()[String(collection)];
     }
-    /**
-     * Get the template object for a collection.
-     * @param collection The collection name.
-     * @returns The template object.
-     */
     getCollectionModelTemplate(collection) {
         return this.getCollectionModel(collection)['template'];
     }
-    /**
-     * Get the foreign keys (fks) object for a collection.
-     * @param collection The collection name.
-     * @returns The fks object.
-     */
     getCollectionModelTemplateFks(collection) {
         return this.getCollectionModel(collection)['template']?.fks;
     }
-    /**
-     * Get the index field name for a collection.
-     * @param collection The collection name.
-     * @returns The index field name.
-     */
     getIndexName(collection) {
         return this.getCollectionModel(collection)?.template?.index;
     }
-    /**
-     * Returns a shared instance of IDbCollectionValues for a given collection
-     */
-    getCollectionValues(collection) {
-        if (!this._collectionValuesMap[collection]) {
-            this._collectionValuesMap[collection] = new IDbCollectionValues(collection, this);
-        }
-        return this._collectionValuesMap[collection];
-    }
-    /**
-     * Returns a shared instance of IDbCollectionFieldValues for a given collection and data
-     * The instance key is based on the collection and the main index of data (or JSON if missing)
-     */
-    getCollectionFieldValues(collection, data) {
-        const indexName = this.getIndexName(collection);
-        const indexValue = data?.[indexName];
-        const key = `${collection}:${indexValue ?? JSON.stringify(data)}`;
-        if (!this._collectionFieldValuesMap.has(key)) {
-            this._collectionFieldValuesMap.set(key, new IDbCollectionFieldValues(collection, data, this.getCollectionValues(collection)));
-        }
-        return this._collectionFieldValuesMap.get(key);
-    }
-    /**
-     * Returns a shared instance of IDbCollectionFieldForge for a given collection, field, and data
-     * The instance key is based on collection, field, and the main index of data (or JSON if missing)
-     */
-    getCollectionFieldForge(collection, fieldName, data) {
-        const indexName = this.getIndexName(collection);
-        const indexValue = data?.[indexName];
-        const key = `${collection}:${String(fieldName)}:${indexValue ?? JSON.stringify(data)}`;
-        if (!this._collectionFieldForgeMap.has(key)) {
-            this._collectionFieldForgeMap.set(key, new IDbCollectionFieldForge(collection, fieldName, data, this.getCollectionValues(collection)));
-        }
-        return this._collectionFieldForgeMap.get(key);
-    }
-    /**
-     * Returns a shared instance of IDbFormValidate for a given collection
-     */
-    getFormValidate(collection) {
-        if (!this._formValidateMap.has(collection)) {
-            this._formValidateMap.set(collection, new IDbFormValidate(collection, this));
-        }
-        return this._formValidateMap.get(collection);
-    }
-    /**
-     * Get the fields object for a collection.
-     * @param collection The collection name.
-     * @returns The fields object.
-     */
     getCollectionTemplateFields(collection) {
         return this.getCollectionModelTemplate(collection)?.fields;
     }
-    /**
-     * Get the presentation string for a collection (used for display).
-     * @param collection The collection name.
-     * @returns The presentation string.
-     */
     getTemplatePresentation(collection) {
         return this.getCollectionModelTemplate(collection)?.presentation;
     }
     #getTemplateFieldRule(collection, fieldName) {
         return this.getCollectionTemplateFields(collection)?.[String(fieldName)];
     }
-    /**
-     * Get the field rule for a foreign key field (e.g. 'collection.field').
-     * @param string The string in the form 'collection.field'.
-     * @returns The field rule string, or undefined.
-     */
     getFkFieldType(string) {
         const [collection, field] = string.split('.');
         let template = this.#getTemplateFieldRule(collection, field);
         return template;
     }
-    /**
-     * Get the fields object for a foreign key collection.
-     * @param string The string in the form 'collection.field'.
-     * @returns The fields object for the referenced collection.
-     */
     getFkTemplateFields(string) {
         const [collection, field] = string.split('.');
         return this.getCollectionModel(collection).template?.fields;
     }
-    /**
-     * Test if a field rule matches a given type (primitive, array, object, fk).
-     * @param what The type to test ('primitive', 'array', 'object', 'fk').
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info if match, else undefined.
-     */
     testIs(what, fieldRule) {
-        const typeMappings = {
-            fk: 'fk-',
-            array: 'array-of-',
-            object: 'object-',
-            primitive: ''
-        };
+        const typeMappings = { fk: 'fk-', array: 'array-of-', object: 'object-', primitive: '' };
         const prefix = typeMappings[what];
         if (what === 'primitive') {
-            // Un type primitif ne doit pas commencer par un préfixe array/object/fk
-            if (!fieldRule.startsWith('array-of-') &&
-                !fieldRule.startsWith('object-') &&
-                !fieldRule.startsWith('fk-')) {
+            if (!fieldRule.startsWith('array-of-') && !fieldRule.startsWith('object-') && !fieldRule.startsWith('fk-')) {
                 return this.is(what, fieldRule);
             }
             return undefined;
@@ -347,35 +227,11 @@ export class IDbCollections {
         }
         return undefined;
     }
-    /**
-     * Extract type information for a field rule.
-     * @param what The type to extract ('primitive', 'array', 'object', 'fk').
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info.
-     */
     is(what, fieldRule) {
         return this.extract(what, fieldRule);
     }
-    /**
-     * Get the value of the index field for a given data object.
-     * @param collection The collection name.
-     * @param data The data object.
-     * @returns The value of the index field.
-     */
-    indexValue(collection, data) {
-        let presentation = this.getIndexName(collection);
-        return data[presentation];
-    }
-    /**
-     * Extracts type, rule, and argument information from a field rule string.
-     * @param type The type to extract ('primitive', 'array', 'object', 'fk').
-     * @param fieldRule The field rule string.
-     * @returns Partial IDbForge info.
-     */
     extract(type, fieldRule) {
-        // fieldType
         function extractAfter(pattern, source) {
-            // remove all between () on source
             const reg = source?.split('(')?.[0];
             return reg.split(pattern)[1];
         }
@@ -385,7 +241,6 @@ export class IDbCollections {
                 return { piece: piece.trim(), args: undefined };
             const [central] = remaining?.split(')');
             const args = central?.split(' ');
-            // console.log({ piece, args });
             return { piece: piece.trim(), args };
         }
         let extractedArgs = extractArgs(fieldRule);
@@ -402,7 +257,6 @@ export class IDbCollections {
                 is = is ?? fieldType;
                 break;
             case 'fk':
-                // Pour les fk, fieldType doit rester la string d'origine (ex: 'fk-agentPrompt.id')
                 fieldType = 'fk-' + extractAfter('fk-', fieldRule);
                 is = extractedArgs?.piece;
                 break;
@@ -413,15 +267,9 @@ export class IDbCollections {
         }
         return { fieldType, fieldRule, fieldArgs, is: type };
     }
-    /**
-     * Parse and return all foreign key collections referenced by a collection.
-     * @param collection The collection name.
-     * @returns An object mapping referenced collection names to their parsed fields.
-     */
     fks(collection) {
-        let fks = this.getCollectionTemplateFks(collection);
+        let fks = this.getCollectionModelTemplateFks(collection);
         let out = {};
-        // loop over fks
         if (fks) {
             Object.keys(fks).forEach((collection) => {
                 out[collection] = this.parseRawCollection(collection);
@@ -429,11 +277,6 @@ export class IDbCollections {
         }
         return out;
     }
-    /**
-     * Find all collections that reference the target collection via a foreign key.
-     * @param targetCollection The collection name to search for as a target.
-     * @returns An object mapping referencing collections to their fk configs.
-     */
     reverseFks(targetCollection) {
         const result = {};
         Object.entries(this.#getModel()).forEach(([collectionName, collectionModel]) => {
@@ -451,42 +294,19 @@ export class IDbCollections {
         });
         return result;
     }
-    // iterate base
-    /**
-     * Iterate over an array field and return an array of IDbForge objects for each element.
-     * @param collection The collection name.
-     * @param fieldName The field name.
-     * @param data The array data.
-     * @returns An array of IDbForge objects.
-     */
     iterateArrayField(collection, fieldName, data) {
         const fieldInfo = this.parseCollectionFieldName(collection, fieldName);
         if (fieldInfo?.is !== 'array' || !Array.isArray(data)) {
             return [];
         }
-        // Retourne un tableau d'objets IDbForge génériques pour chaque élément
-        return data.map((_, idx) => ({
-            ...fieldInfo,
-            fieldName: `${String(fieldName)}[${idx}]`,
-        }));
+        return data.map((_, idx) => ({ ...fieldInfo, fieldName: `${String(fieldName)}[${idx}]` }));
     }
-    /**
-     * Iterate over an object field and return an array of IDbForge objects for each property.
-     * @param collection The collection name.
-     * @param fieldName The field name.
-     * @param data The object data.
-     * @returns An array of IDbForge objects.
-     */
     iterateObjectField(collection, fieldName, data) {
         const fieldInfo = this.parseCollectionFieldName(collection, fieldName);
         if (fieldInfo?.is !== 'object' || typeof data !== 'object' || data === null) {
             return [];
         }
-        // Retourne un tableau d'objets IDbForge génériques pour chaque clé
-        return Object.keys(data).map((key) => ({
-            ...fieldInfo,
-            fieldName: `${String(fieldName)}.${key}`,
-        }));
+        return Object.keys(data).map((key) => ({ ...fieldInfo, fieldName: `${String(fieldName)}.${key}` }));
     }
 }
 /**
@@ -528,7 +348,7 @@ export class IDbCollectionValues {
      */
     constructor(collectionName, idbCollections) {
         this.collectionName = collectionName;
-        this.idbCollections = idbCollections ?? new IDbCollections();
+        this.idbCollections = idbCollections ?? new IDbBase();
     }
     presentation(data) {
         try {
@@ -809,7 +629,7 @@ export class IDbFormValidate {
     idbCollections;
     constructor(collection, idbCollections) {
         this.collection = collection;
-        this.idbCollections = idbCollections ?? new IDbCollections();
+        this.idbCollections = idbCollections ?? new IDbBase();
     }
     validateField(fieldName, value) {
         try {

package/dist/db/dbSchema.d.ts

@@ -453,4 +453,4 @@ export declare const schemeModelDb: {
 };
 export declare const schemeModel: IdbqModel;
 export type DataModelFinal = DbDataModelTs<typeof schemeModelDb>;
-export declare const idbql: import("@medyll/idae-idbql").ReadonlyCollections<IdbqModel<Record<string, Record<string, any>>>>, idbqlState: import("@medyll/idae-idbql").StateCollections<IdbqModel<Record<string, Record<string, any>>>>, idbDatabase: import("@medyll/idae-idbql").IdbqlIndexedCore<IdbqModel<Record<string, Record<string, any>>>>, idbqModel: IdbqModel<Record<string, Record<string, any>>>;
+export declare const idbql: any, idbqlState: any, idbDatabase: any, idbqModel: any;

package/dist/db/testDbSchema.d.ts

@@ -53,4 +53,4 @@ export declare const schemeModelTestDb: {
 };
 export declare const schemeModelTest: IdbqModel;
 export type DataModelTestFinal = DbDataModelTs<typeof schemeModelTestDb>;
-export declare const idbql: import("@medyll/idae-idbql").ReadonlyCollections<IdbqModel<Record<string, Record<string, any>>>>, idbqlState: import("@medyll/idae-idbql").StateCollections<IdbqModel<Record<string, Record<string, any>>>>, idbDatabase: import("@medyll/idae-idbql").IdbqlIndexedCore<IdbqModel<Record<string, Record<string, any>>>>, idbqModel: IdbqModel<Record<string, Record<string, any>>>;
+export declare const idbql: any, idbqlState: any, idbDatabase: any, idbqModel: any;

package/dist/form/CollectionFks.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { IDbCollections } from '../db/dbFields.js';
+	import { IDbBase } from '../db/dbFields.js';
 	import { schemeModel, idbqlState } from '../db/dbSchema.js';
 	import type { TplCollectionName, Where } from '@medyll/idae-idbql';
 	import { Looper } from '@medyll/idae-slotui-svelte';
@@ -15,7 +15,7 @@
 	// idbqlState[fkCollection].get(fkId);
 
 	const dbFields = machine.collections;
-	const collections = new IDbCollections(schemeModel);
+	const collections = new IDbBase(schemeModel);
 	const fks = $derived(collections.fks(collection));
 </script>
 

package/dist/form/CollectionListMenu.svelte

@@ -2,7 +2,7 @@
 	import { type MenuListProps, Button, MenuList, MenuListItem, openWindow, type Props } from '@medyll/idae-slotui-svelte';
 	import CreateUpdate from './CreateUpdate.svelte';
 	import { idbqlState } from '../db/dbSchema';
-	import { IDbCollections, IDbCollectionValues } from '../db/dbFields';
+	import { IDbBase, IDbCollectionValues } from '../db/dbFields';
 	import { hydrate } from 'svelte';
 	import type { Where } from '@medyll/idae-idbql';
 
@@ -18,7 +18,7 @@
 
 	let { collection, target, data, menuListProps, onclick, style, where }: DataListMenuProps = $props();
 
-	let test = new IDbCollections();
+	let test = new IDbBase();
 	let fieldValues = new IDbCollectionValues(collection);
 	let index = test.getIndexName(collection);
 

package/dist/form/CollectionReverseFks.svelte

@@ -14,7 +14,7 @@
     } 
  -->
 <script lang="ts">
-	import { IDbCollections } from '../db/dbFields.js';
+	import { IDbBase } from '../db/dbFields.js';
 	import { schemeModel, idbqlState } from '../db/dbSchema';
 	import type { Tpl, TplCollectionName, Where } from '@medyll/idae-idbql';
 	import { Looper } from '@medyll/idae-slotui-svelte';
@@ -30,7 +30,7 @@
 		componentProps?: Record<string, any>;
 	};
 	let { collection, children: child, showTitle = false, component, componentProps = {} }: CollectionFksProps = $props();
-	const dbFields = new IDbCollections(schemeModel);
+	const dbFields = new IDbBase(schemeModel);
 	const fks = $derived(dbFields.reverseFks(collection));
 
 	function getTitle() {

package/dist/form/FieldValue.svelte

@@ -29,7 +29,7 @@
 		showAiGuess = false
 	}: FieldValueProps = $props();
 
-	let _data = getContext('data');
+	let _data = getContext('data'); 
 
 	data = data ?? ({} as COL);
 

package/dist/main/machine.d.ts

@@ -24,7 +24,7 @@
  * // Access the IDBQL data model
  * const model = machine.idbqModel;
  */
-import { IDbCollections } from '../db/dbFields.js';
+import { IDbBase } from '../db/dbFields.js';
 import { createIdbqDb, type IdbqModel } from '@medyll/idae-idbql';
 /**
  * Machine: main entry point for managing the IDBQL connection and centralized data access.
@@ -50,7 +50,7 @@ export declare class Machine {
     /**
      * Centralized access to schema and collection logic
      */
-    _collections: IDbCollections;
+    _collections: IDbBase;
     /**
      * Database name
      */
@@ -81,23 +81,23 @@ export declare class Machine {
     /**
      * Get the IDbCollections (schema logic) instance
      */
-    get collections(): IDbCollections;
+    get collections(): IDbBase;
     /**
      * IDBQL (readonly) instance
      */
-    get idbql(): import("@medyll/idae-idbql").ReadonlyCollections<IdbqModel<Record<string, Record<string, any>>>> | undefined;
+    get idbql(): any;
     /**
      * IDBQL (stateful) instance
      */
-    get store(): import("@medyll/idae-idbql").StateCollections<IdbqModel<Record<string, Record<string, any>>>>;
+    get store(): any;
     /**
      * IndexedDB (core) instance
      * @deprecated
      */
-    get indexedb(): import("@medyll/idae-idbql").IdbqlIndexedCore<IdbqModel<Record<string, Record<string, any>>>> | undefined;
+    get indexedb(): any;
     /**
      * IDBQL data model instance
      */
-    get idbqModel(): IdbqModel<Record<string, Record<string, any>>> | undefined;
+    get idbqModel(): any;
 }
 export declare const machine: Machine;

package/dist/main/machine.js

@@ -24,7 +24,7 @@
  * // Access the IDBQL data model
  * const model = machine.idbqModel;
  */
-import { IDbCollections } from '../db/dbFields.js';
+import { IDbBase } from '../db/dbFields.js';
 import { createIdbqDb } from '@medyll/idae-idbql';
 /**
  * Machine: main entry point for managing the IDBQL connection and centralized data access.
@@ -84,7 +84,7 @@ export class Machine {
         if (!this._model) {
             throw new Error('Data model is not defined');
         }
-        this._collections = new IDbCollections(this._model);
+        this._collections = new IDbBase(this._model);
     }
     createStore() {
         if (!this._model || !this._dbName || !this._version) {

package/package.json

@@ -1,66 +1,65 @@
 {
-	"name": "@medyll/idae-machine",
-	"version": "0.112.0",
-	"scripts": {
-		"dev": "vite dev",
-		"build": "vite build && npm run prepack",
-		"preview": "vite preview",
-		"prepare": "svelte-kit sync || echo ''",
-		"prepack": "svelte-kit sync && svelte-package && publint",
-		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
-		"format": "prettier --write .",
-		"lint": "prettier --check . && eslint .",
-		"test:unit": "vitest",
-		"test": "npm run test:unit -- --run",
-		"package:pre": "node scripts/package-pre.js"
-	},
-	"files": [
-		"dist",
-		"!dist/**/*.test.*",
-		"!dist/**/*.spec.*"
-	],
-	"sideEffects": [
-		"**/*.css"
-	],
-	"svelte": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"type": "module",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"svelte": "./dist/index.js"
-		}
-	},
-	"peerDependencies": {
-		"svelte": "^5.0.0"
-	},
-	"devDependencies": {
-		"@eslint/compat": "^1.2.7",
-		"@eslint/js": "^9.23.0",
-		"@sveltejs/adapter-auto": "^5.0.0",
-		"@sveltejs/kit": "^2.20.2",
-		"@sveltejs/package": "^2.3.10",
-		"@sveltejs/vite-plugin-svelte": "^5.0.3",
-		"@testing-library/jest-dom": "^6.6.3",
-		"@testing-library/svelte": "^5.2.7",
-		"eslint": "^9.23.0",
-		"eslint-config-prettier": "^10.1.1",
-		"eslint-plugin-svelte": "^3.3.3",
-		"globals": "^16.0.0",
-		"jsdom": "^26.0.0",
-		"prettier": "^3.5.3",
-		"prettier-plugin-svelte": "^3.3.3",
-		"publint": "^0.3.9",
-		"svelte": "^5.25.3",
-		"svelte-check": "^4.1.5",
-		"typescript": "^5.8.2",
-		"typescript-eslint": "^8.28.0",
-		"vite": "^6.2.3",
-		"vitest": "^3.0.9"
-	},
-	"scope": "@medyll",
-	"dependencies": {
-		"@huggingface/prettier-plugin-vertical-align": "^0.2.3"
-	}
-}
+  "name": "@medyll/idae-machine",
+  "version": "0.114.0",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "svelte": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.2.7",
+    "@eslint/js": "^9.23.0",
+    "@sveltejs/adapter-auto": "^5.0.0",
+    "@sveltejs/kit": "^2.20.2",
+    "@sveltejs/package": "^2.3.10",
+    "@sveltejs/vite-plugin-svelte": "^5.0.3",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/svelte": "^5.2.7",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-svelte": "^3.3.3",
+    "globals": "^16.0.0",
+    "jsdom": "^26.0.0",
+    "prettier": "^3.5.3",
+    "prettier-plugin-svelte": "^3.3.3",
+    "publint": "^0.3.9",
+    "svelte": "^5.25.3",
+    "svelte-check": "^4.1.5",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.28.0",
+    "vite": "^6.2.3",
+    "vitest": "^3.0.9",
+    "@medyll/idae-prettier-config": "1.2.1"
+  },
+  "scope": "@medyll",
+  "dependencies": {
+    "@huggingface/prettier-plugin-vertical-align": "^0.2.3"
+  },
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build && npm run prepack",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+    "format": "prettier --write .",
+    "lint": "prettier --check . && eslint .",
+    "test:unit": "vitest",
+    "test": "npm run test:unit -- --run",
+    "package:pre": "node scripts/package-pre.js"
+  }
+}