@medyll/idae-machine 0.119.0 → 0.121.0

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: any, idbqlState: any, idbDatabase: any, idbqModel: any;
+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>>>;

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: any, idbqlState: any, idbDatabase: any, idbqModel: any;
+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>>>;

package/dist/form/CollectionFks.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import { IDbBase } from '../db/dbFields.js';
+	import { IDbBase } from '../main/machineDb.js';
 	import { schemeModel, idbqlState } from '../db/dbSchema.js';
 	import type { TplCollectionName, Where } from '@medyll/idae-idbql';
 	import { Looper } from '@medyll/idae-slotui-svelte';

package/dist/form/CollectionReverseFks.svelte

@@ -14,7 +14,7 @@
     } 
  -->
 <script lang="ts">
-	import { IDbBase } from '../db/dbFields.js';
+	import { IDbBase } from '../main/machineDb.js';
 	import { schemeModel, idbqlState } from '../db/dbSchema';
 	import type { Tpl, TplCollectionName, Where } from '@medyll/idae-idbql';
 	import { Looper } from '@medyll/idae-slotui-svelte';

package/dist/form/CreateUpdate.svelte

@@ -4,7 +4,7 @@
  -->
 
 <script lang="ts" generics="COL = Record<string,any>">
-	import {  IDbFormValidate } from '../db/dbFields.js'; 
+	import {  IDbFormValidate } from '../main/machineDb.js'; 
 	import type { CreateUpdateProps } from './types';
 	import CollectionReverseFks from './CollectionReverseFks.svelte';
 	import FieldInput from './FieldValue.svelte';

package/dist/index.d.ts

@@ -1,6 +1,14 @@
 export * from './types/appschemeTypes.js';
+export * from './main/machineDb.js';
+export * from './main/machineDb.spec.js';
 export * from './main/machine.js';
 export * from './main/machine.spec.js';
+export { default as Skeleton } from './fragments/Skeleton.svelte';
+export { default as Selector } from './fragments/Selector.svelte';
+export { default as List } from './fragments/List.svelte';
+export { default as InfoLine } from './fragments/InfoLine.svelte';
+export { default as Frame } from './fragments/Frame.svelte';
+export { default as Confirm } from './fragments/Confirm.svelte';
 export * from './form/types.js';
 export { default as FieldValue } from './form/FieldValue.svelte';
 export { default as FieldInPlace } from './form/FieldInPlace.svelte';
@@ -14,19 +22,11 @@ export { default as CollectionList } from './form/CollectionList.svelte';
 export { default as CollectionFks } from './form/CollectionFks.svelte';
 export { default as CollectionFieldGuess } from './form/CollectionFieldGuess.svelte';
 export { default as CollectionButton } from './form/CollectionButton.svelte';
-export { default as Skeleton } from './fragments/Skeleton.svelte';
-export { default as Selector } from './fragments/Selector.svelte';
-export { default as List } from './fragments/List.svelte';
-export { default as InfoLine } from './fragments/InfoLine.svelte';
-export { default as Frame } from './fragments/Frame.svelte';
-export { default as Confirm } from './fragments/Confirm.svelte';
 export * from './db/types.js';
 export * from './db/testDbSchema.js';
 export * from './db/dbSchema.js';
 export * from './db/dbSchema.spec.js';
 export * from './db/dbFormValidate.spec.js';
-export * from './db/dbFields.js';
-export * from './db/dbFields.spec.js';
 export * from './db/dbCollectionValues.spec.js';
 export * from './db/dbCollectionFieldValues.spec.js';
 export * from './db/dbCollectionFieldForge.spec.js';

package/dist/index.js

@@ -1,7 +1,15 @@
 // auto exports of entry components
 export * from './types/appschemeTypes.js';
+export * from './main/machineDb.js';
+export * from './main/machineDb.spec.js';
 export * from './main/machine.js';
 export * from './main/machine.spec.js';
+export { default as Skeleton } from './fragments/Skeleton.svelte';
+export { default as Selector } from './fragments/Selector.svelte';
+export { default as List } from './fragments/List.svelte';
+export { default as InfoLine } from './fragments/InfoLine.svelte';
+export { default as Frame } from './fragments/Frame.svelte';
+export { default as Confirm } from './fragments/Confirm.svelte';
 export * from './form/types.js';
 export { default as FieldValue } from './form/FieldValue.svelte';
 export { default as FieldInPlace } from './form/FieldInPlace.svelte';
@@ -15,19 +23,11 @@ export { default as CollectionList } from './form/CollectionList.svelte';
 export { default as CollectionFks } from './form/CollectionFks.svelte';
 export { default as CollectionFieldGuess } from './form/CollectionFieldGuess.svelte';
 export { default as CollectionButton } from './form/CollectionButton.svelte';
-export { default as Skeleton } from './fragments/Skeleton.svelte';
-export { default as Selector } from './fragments/Selector.svelte';
-export { default as List } from './fragments/List.svelte';
-export { default as InfoLine } from './fragments/InfoLine.svelte';
-export { default as Frame } from './fragments/Frame.svelte';
-export { default as Confirm } from './fragments/Confirm.svelte';
 export * from './db/types.js';
 export * from './db/testDbSchema.js';
 export * from './db/dbSchema.js';
 export * from './db/dbSchema.spec.js';
 export * from './db/dbFormValidate.spec.js';
-export * from './db/dbFields.js';
-export * from './db/dbFields.spec.js';
 export * from './db/dbCollectionValues.spec.js';
 export * from './db/dbCollectionFieldValues.spec.js';
 export * from './db/dbCollectionFieldForge.spec.js';

package/dist/main/machine.d.ts

@@ -24,14 +24,13 @@
  * // Access the IDBQL data model
  * const model = machine.idbqModel;
  */
-import { IDbBase } from '../db/dbFields.js';
+import { IDbBase } from './machineDb.js';
 import { createIdbqDb, type IdbqModel } from '@medyll/idae-idbql';
 /**
  * Machine: main entry point for managing the IDBQL connection and centralized data access.
  */
 export declare class Machine {
     /**
-  
      * IDBQL (readonly collections instance)
      */
     _idbql: ReturnType<ReturnType<typeof createIdbqDb>["create"]>["idbql"] | undefined;
@@ -50,7 +49,7 @@ export declare class Machine {
     /**
      * Centralized access to schema and collection logic
      */
-    _collections: IDbBase;
+    _idbbase: IDbBase;
     /**
      * Database name
      */
@@ -66,7 +65,7 @@ export declare class Machine {
     /**
      * Main constructor
      */
-    constructor();
+    constructor(dbName?: string, version?: number, model?: IdbqModel);
     init(options?: {
         dbName?: string;
         version?: number;
@@ -79,25 +78,29 @@ export declare class Machine {
     private createCollections;
     private createStore;
     /**
-     * Get the IDbCollections (schema logic) instance
+     * Get the IDbBase (schema logic) instance
      */
     get collections(): IDbBase;
     /**
      * IDBQL (readonly) instance
      */
-    get idbql(): any;
+    get idbql(): import("@medyll/idae-idbql").ReadonlyCollections<IdbqModel<Record<string, Record<string, any>>>> | undefined;
     /**
-     * IDBQL (stateful) instance
+     * IDBQL (stateful) instance , old name was idbqlState => store
      */
-    get store(): any;
+    get store(): import("@medyll/idae-idbql").StateCollections<IdbqModel<Record<string, Record<string, any>>>>;
+    /**
+     * Direct getter for idbqlState (for test compatibility)
+     */
+    get idbqlState(): import("@medyll/idae-idbql").StateCollections<IdbqModel<Record<string, Record<string, any>>>>;
     /**
      * IndexedDB (core) instance
      * @deprecated
      */
-    get indexedb(): any;
+    get indexedb(): import("@medyll/idae-idbql").IdbqlIndexedCore<IdbqModel<Record<string, Record<string, any>>>> | undefined;
     /**
      * IDBQL data model instance
      */
-    get idbqModel(): any;
+    get idbqModel(): IdbqModel<Record<string, Record<string, any>>> | undefined;
 }
 export declare const machine: Machine;

package/dist/main/machine.js

@@ -24,14 +24,13 @@
  * // Access the IDBQL data model
  * const model = machine.idbqModel;
  */
-import { IDbBase } from '../db/dbFields.js';
+import { IDbBase } from './machineDb.js';
 import { createIdbqDb } from '@medyll/idae-idbql';
 /**
  * Machine: main entry point for managing the IDBQL connection and centralized data access.
  */
 export class Machine {
     /**
-  
      * IDBQL (readonly collections instance)
      */
     _idbql;
@@ -50,7 +49,7 @@ export class Machine {
     /**
      * Centralized access to schema and collection logic
      */
-    _collections;
+    _idbbase;
     /**
      * Database name
      */
@@ -66,7 +65,10 @@ export class Machine {
     /**
      * Main constructor
      */
-    constructor() {
+    constructor(dbName, version, model) {
+        this._dbName = dbName ?? '';
+        this._version = version ?? 1;
+        this._model = model ?? undefined;
     }
     init(options) {
         this._dbName = options?.dbName ?? this._dbName;
@@ -84,7 +86,7 @@ export class Machine {
         if (!this._model) {
             throw new Error('Data model is not defined');
         }
-        this._collections = new IDbBase(this._model);
+        this._idbbase = new IDbBase(this._model);
     }
     createStore() {
         if (!this._model || !this._dbName || !this._version) {
@@ -98,10 +100,10 @@ export class Machine {
         this._idbqModel = idbqModel;
     }
     /**
-     * Get the IDbCollections (schema logic) instance
+     * Get the IDbBase (schema logic) instance
      */
     get collections() {
-        return this._collections;
+        return this._idbbase;
     }
     /**
      * IDBQL (readonly) instance
@@ -110,11 +112,17 @@ export class Machine {
         return this._idbql;
     }
     /**
-     * IDBQL (stateful) instance
+     * IDBQL (stateful) instance , old name was idbqlState => store
      */
     get store() {
         return this._idbqlState;
     }
+    /**
+     * Direct getter for idbqlState (for test compatibility)
+     */
+    get idbqlState() {
+        return this._idbqlState;
+    }
     /**
      * IndexedDB (core) instance
      * @deprecated

package/dist/{db/dbFields.d.ts → main/machineDb.d.ts}

@@ -38,22 +38,6 @@ export type IDbForge = {
     fieldArgs?: IDbForgeArgs | undefined;
     is: any;
 };
-export declare class IDbCollection {
-    collection: TplCollectionName;
-    _dbCollections: IDbBase;
-    constructor(collection: TplCollectionName, dbCollections: IDbBase);
-    getCollectionModelTemplate(): Tpl;
-    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>;
-    getFormValidate(): IDbFormValidate;
-    fks(): {
-        [collection: string]: Tpl;
-    };
-    reverseFks(): Record<string, any>;
-}
 /**
  * Central class for parsing, introspecting, and extracting metadata from the database schema.
  * Provides methods to access collections, templates, fields, foreign keys, and type information.
@@ -61,6 +45,20 @@ export declare class IDbCollection {
  */
 export declare class IDbBase {
     #private;
+    /**
+     * Public: Get the foreign keys (fks) object for a collection.
+     */
+    getCollectionTemplateFks(collection: TplCollectionName): {
+        [x: string]: {
+            code: string;
+            multiple: boolean;
+            rules: import("@medyll/idae-idbql").CombinedArgs;
+        } | undefined;
+    };
+    /**
+     * Public: Get the value of the index field for a given data object.
+     */
+    indexValue(collection: TplCollectionName, data: object): unknown;
     /**
      * The database model (schema) used for introspection.
      */
@@ -110,11 +108,13 @@ export declare class IDbBase {
     getCollectionModel(collection: TplCollectionName): CollectionModel;
     getCollectionModelTemplate(collection: TplCollectionName): Tpl;
     getCollectionModelTemplateFks(collection: TplCollectionName): Tpl["fks"];
-    getIndexName(collection: TplCollectionName): any;
+    getIndexName(collection: TplCollectionName): string;
     getCollectionTemplateFields(collection: TplCollectionName): TplFields;
     getTemplatePresentation(collection: TplCollectionName): string;
     getFkFieldType(string: `${string}.${string}`): IDbFieldRules | undefined;
-    getFkTemplateFields(string: `${string}.${string}`): any;
+    getFkTemplateFields(string: `${string}.${string}`): {
+        [x: string]: import("@medyll/idae-idbql").TplFieldRules;
+    };
     private testIs;
     is(what: 'array' | 'object' | 'fk' | 'primitive', fieldRule: IDbFieldRules): Partial<IDbForge>;
     extract(type: 'array' | 'object' | 'fk' | 'primitive', fieldRule: IDbFieldRules): Partial<IDbForge>;
@@ -125,6 +125,28 @@ export declare class IDbBase {
     iterateArrayField(collection: TplCollectionName, fieldName: keyof TplFields, data: any[]): IDbForge[];
     iterateObjectField(collection: TplCollectionName, fieldName: keyof TplFields, data: Record<string, any>): IDbForge[];
 }
+export declare class IDbCollection {
+    collection: TplCollectionName;
+    _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;
+    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>;
+    getFormValidate(): IDbFormValidate;
+    fks(): {
+        [collection: string]: Tpl;
+    };
+    reverseFks(): Record<string, any>;
+}
 /**
  * IDbCollectionValues
  *
@@ -132,7 +154,7 @@ export declare class IDbBase {
  * It is designed for dynamic UI rendering, presentation logic, and metadata extraction for form generation in schema-driven applications.
  *
  * Main responsibilities:
- * - Holds a reference to the collection name and the schema (IDbCollections).
+ * - Holds a reference to the collection name and the schema (IDbBase).
  * - Provides methods to format field values according to their type (number, text, array, object, etc.).
  * - Supplies presentation logic for displaying records (e.g., presentation string, index value).
  * - Offers input attribute generation for forms (inputDataSet).
@@ -146,15 +168,15 @@ export declare class IDbBase {
  *   const formatted = values.format('name', agentData); // formatted field value
  *   const attrs = values.getInputDataSet('name', agentData); // input attributes for forms
  *
- * This class is typically used via IDbCollections.getCollectionValues for shared instance management.
+ * This class is typically used via IDbBase.getCollectionValues for shared instance management.
  * @template T - The type of the data object for the collection.
  */
 export declare class IDbCollectionValues<T extends Record<string, any>> {
     #private;
     /**
-     * The IDbCollections instance used for schema introspection.
+     * The IDbBase instance used for schema introspection.
      */
-    idbCollections: IDbBase;
+    idbBase: IDbBase;
     /**
      * The collection name this instance operates on.
      */
@@ -163,7 +185,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?: IDbBase);
+    constructor(collectionName: TplCollectionName, idbBase?: IDbBase);
     presentation(data: Record<string, any>): string;
     /**
      * Get the value of the index field for a data object.
@@ -233,7 +255,7 @@ export declare class IDbCollectionFieldValues<T extends Record<string, any>> {
  *   const inputType = forge.htmlInputType; // e.g. 'text', 'area', 'email', etc.
  *   const meta = forge.forge; // IDbForge metadata for the field
  *
- * This class is typically used via IDbCollections.getCollectionFieldForge for shared instance management.
+ * This class is typically used via IDbBase.getCollectionFieldForge for shared instance management.
  */
 export declare class IDbCollectionFieldForge<T extends Record<string, any>> {
     #private;

package/dist/{db/dbFields.js → main/machineDb.js}

@@ -1,7 +1,7 @@
 /*
     path: D:\boulot\python\wollama\src\lib\db\dbFields.ts
  */
-import { schemeModel } from './dbSchema.js';
+import { schemeModel } from '../db/dbSchema.js';
 export var enumPrimitive;
 (function (enumPrimitive) {
     enumPrimitive["id"] = "id";
@@ -46,48 +46,26 @@ class IDbError extends Error {
         }
     }
 }
-/* Single collection relies on IDbCollections */
-export class IDbCollection {
-    collection;
-    _dbCollections;
-    constructor(collection, dbCollections) {
-        this.collection = collection;
-        this._dbCollections = dbCollections;
-    }
-    getCollectionModelTemplate() {
-        return this._dbCollections.getCollectionModelTemplate(this.collection);
-    }
-    getCollectionModelTemplateFks() {
-        return this._dbCollections.getCollectionModelTemplateFks(this.collection);
-    }
-    getIndexName() {
-        return this._dbCollections.getIndexName(this.collection);
-    }
-    collectionValues() {
-        return this._dbCollections.collectionValues(this.collection);
-    }
-    collectionFieldValues(data) {
-        return this._dbCollections.collectionFieldValues(this.collection, data);
-    }
-    fieldForge(fieldName, data) {
-        return this._dbCollections.collectionFieldForge(this.collection, fieldName, data);
-    }
-    getFormValidate() {
-        return this._dbCollections.formValidate(this.collection);
-    }
-    fks() {
-        return this._dbCollections.fks(this.collection);
-    }
-    reverseFks() {
-        return this._dbCollections.reverseFks(this.collection);
-    }
-}
 /**
  * Central class for parsing, introspecting, and extracting metadata from the database schema.
  * Provides methods to access collections, templates, fields, foreign keys, and type information.
  * Used for dynamic UI generation, validation, and schema-driven logic.
  */
 export class IDbBase {
+    /**
+     * Public: Get the foreign keys (fks) object for a collection.
+     */
+    getCollectionTemplateFks(collection) {
+        return this.getCollectionModelTemplateFks(collection);
+    }
+    /**
+     * Public: Get the value of the index field for a given data object.
+     */
+    indexValue(collection, data) {
+        const indexName = this.getIndexName(collection);
+        // @ts-ignore
+        return data && typeof data === 'object' && indexName && data[indexName];
+    }
     /**
      * The database model (schema) used for introspection.
      */
@@ -309,6 +287,42 @@ export class IDbBase {
         return Object.keys(data).map((key) => ({ ...fieldInfo, fieldName: `${String(fieldName)}.${key}` }));
     }
 }
+/* Single collection relies on IDbBase */
+export class IDbCollection {
+    collection;
+    _dbCollections;
+    constructor(collection, dbCollections) {
+        this.collection = collection;
+        this._dbCollections = dbCollections;
+    }
+    getCollectionModelTemplate() {
+        return this._dbCollections.getCollectionModelTemplate(this.collection);
+    }
+    getCollectionModelTemplateFks() {
+        return this._dbCollections.getCollectionModelTemplateFks(this.collection);
+    }
+    getIndexName() {
+        return this._dbCollections.getIndexName(this.collection);
+    }
+    collectionValues() {
+        return this._dbCollections.collectionValues(this.collection);
+    }
+    collectionFieldValues(data) {
+        return this._dbCollections.collectionFieldValues(this.collection, data);
+    }
+    fieldForge(fieldName, data) {
+        return this._dbCollections.collectionFieldForge(this.collection, fieldName, data);
+    }
+    getFormValidate() {
+        return this._dbCollections.formValidate(this.collection);
+    }
+    fks() {
+        return this._dbCollections.fks(this.collection);
+    }
+    reverseFks() {
+        return this._dbCollections.reverseFks(this.collection);
+    }
+}
 /**
  * IDbCollectionValues
  *
@@ -316,7 +330,7 @@ export class IDbBase {
  * It is designed for dynamic UI rendering, presentation logic, and metadata extraction for form generation in schema-driven applications.
  *
  * Main responsibilities:
- * - Holds a reference to the collection name and the schema (IDbCollections).
+ * - Holds a reference to the collection name and the schema (IDbBase).
  * - Provides methods to format field values according to their type (number, text, array, object, etc.).
  * - Supplies presentation logic for displaying records (e.g., presentation string, index value).
  * - Offers input attribute generation for forms (inputDataSet).
@@ -330,14 +344,14 @@ export class IDbBase {
  *   const formatted = values.format('name', agentData); // formatted field value
  *   const attrs = values.getInputDataSet('name', agentData); // input attributes for forms
  *
- * This class is typically used via IDbCollections.getCollectionValues for shared instance management.
+ * This class is typically used via IDbBase.getCollectionValues for shared instance management.
  * @template T - The type of the data object for the collection.
  */
 export class IDbCollectionValues {
     /**
-     * The IDbCollections instance used for schema introspection.
+     * The IDbBase instance used for schema introspection.
      */
-    idbCollections;
+    idbBase;
     /**
      * The collection name this instance operates on.
      */
@@ -346,14 +360,14 @@ export class IDbCollectionValues {
      * Create a new IDbCollectionValues instance for a given collection.
      * @param collectionName The collection name.
      */
-    constructor(collectionName, idbCollections) {
+    constructor(collectionName, idbBase) {
         this.collectionName = collectionName;
-        this.idbCollections = idbCollections ?? new IDbBase();
+        this.idbBase = idbBase ?? new IDbBase();
     }
     presentation(data) {
         try {
             this.#checkError(!this.#checkAccess(), 'Access denied', 'ACCESS_DENIED');
-            const presentation = this.idbCollections.getTemplatePresentation(this.collectionName);
+            const presentation = this.idbBase.getTemplatePresentation(this.collectionName);
             this.#checkError(!presentation, 'Presentation template not found', 'TEMPLATE_NOT_FOUND');
             const fields = presentation.split(' ');
             return fields
@@ -376,7 +390,7 @@ export class IDbCollectionValues {
     indexValue(data) {
         try {
             this.#checkError(!this.#checkAccess(), 'Access denied', 'ACCESS_DENIED');
-            const indexName = this.idbCollections.getIndexName(this.collectionName);
+            const indexName = this.idbBase.getIndexName(this.collectionName);
             this.#checkError(!indexName, 'Index not found for collection', 'INDEX_NOT_FOUND');
             this.#checkError(!(indexName in data), `Index field ${indexName} not found in data`, 'FIELD_NOT_FOUND');
             return data[indexName];
@@ -396,7 +410,7 @@ export class IDbCollectionValues {
         try {
             this.#checkError(!this.#checkAccess(), 'Access denied', 'ACCESS_DENIED');
             this.#checkError(!(fieldName in data), `Field ${String(fieldName)} not found in data`, 'FIELD_NOT_FOUND');
-            const fieldInfo = this.idbCollections.parseCollectionFieldName(this.collectionName, fieldName);
+            const fieldInfo = this.idbBase.parseCollectionFieldName(this.collectionName, fieldName);
             this.#checkError(!fieldInfo, `Field ${String(fieldName)} not found in collection`, 'FIELD_NOT_FOUND');
             switch (fieldInfo?.fieldType) {
                 case 'number':
@@ -424,10 +438,10 @@ export class IDbCollectionValues {
      * @returns An object with data-* attributes for the field.
      */
     getInputDataSet(fieldName, data) {
-        const fieldInfo = this.idbCollections.parseCollectionFieldName(this.collectionName, fieldName);
+        const fieldInfo = this.idbBase.parseCollectionFieldName(this.collectionName, fieldName);
         const fieldType = fieldInfo?.fieldType ?? '';
         const fieldArgs = fieldInfo?.fieldArgs?.join(' ') ?? '';
-        const indexName = this.idbCollections.getIndexName(this.collectionName);
+        const indexName = this.idbBase.getIndexName(this.collectionName);
         return {
             'data-collection': this.collectionName,
             'data-collectionId': indexName && data?.[indexName] !== undefined ? String(data?.[indexName]) : '',
@@ -443,7 +457,7 @@ export class IDbCollectionValues {
      * @returns An array of IDbForge objects.
      */
     iterateArrayField(fieldName, data) {
-        return this.idbCollections.iterateArrayField(this.collectionName, fieldName, data);
+        return this.idbBase.iterateArrayField(this.collectionName, fieldName, data);
     }
     /**
      * Iterate over an object field and return an array of IDbForge objects for each property.
@@ -452,7 +466,7 @@ export class IDbCollectionValues {
      * @returns An array of IDbForge objects.
      */
     iterateObjectField(fieldName, data) {
-        return this.idbCollections.iterateObjectField(this.collectionName, fieldName, data);
+        return this.idbBase.iterateObjectField(this.collectionName, fieldName, data);
     }
     /**
      * Internal: Format a number field for display.
@@ -477,8 +491,9 @@ export class IDbCollectionValues {
             'text-long': 40,
             'text-giant': 50
         };
-        const maxLength = lengths[type] || value.length;
-        return value.substring(0, maxLength);
+        const str = typeof value === 'string' ? value : String(value ?? '');
+        const maxLength = lengths[type] || str.length;
+        return str.substring(0, maxLength);
     }
     /**
      * Internal: Check if access is allowed (override for custom logic).
@@ -509,7 +524,7 @@ export class IDbCollectionFieldValues {
  * @param fieldName The field name to introspect.
  */
     getForge(fieldName) {
-        return this.#collectionValues.idbCollections.parseCollectionFieldName(this.#collection, String(fieldName));
+        return this.#collectionValues.idbBase.parseCollectionFieldName(this.#collection, String(fieldName));
     }
     constructor(collection, data, collectionValues) {
         this.#collection = collection;
@@ -517,7 +532,7 @@ export class IDbCollectionFieldValues {
         this.#data = data;
     }
     format(fieldName) {
-        const fieldInfo = this.#collectionValues.idbCollections.parseCollectionFieldName(this.#collection, fieldName);
+        const fieldInfo = this.#collectionValues.idbBase.parseCollectionFieldName(this.#collection, fieldName);
         if (fieldInfo?.is === 'array') {
             return this.iterateArray(String(fieldName), this.#data);
         }
@@ -560,14 +575,13 @@ export class IDbCollectionFieldValues {
  *   const inputType = forge.htmlInputType; // e.g. 'text', 'area', 'email', etc.
  *   const meta = forge.forge; // IDbForge metadata for the field
  *
- * This class is typically used via IDbCollections.getCollectionFieldForge for shared instance management.
+ * This class is typically used via IDbBase.getCollectionFieldForge for shared instance management.
  */
 export class IDbCollectionFieldForge {
     #collection;
     #collectionValues;
     #fieldName;
     #data;
-    #forge;
     constructor(collection, fieldName, data, collectionValues) {
         this.#collection = collection;
         this.#collectionValues = collectionValues ?? new IDbCollectionValues(collection);
@@ -582,7 +596,7 @@ export class IDbCollectionFieldForge {
     }
     // renamed from parseCollectionFieldName
     get forge() {
-        return this.#collectionValues.idbCollections.parseCollectionFieldName(this.#collection, String(this.#fieldName));
+        return this.#collectionValues.idbBase.parseCollectionFieldName(this.#collection, String(this.#fieldName));
     }
     get fieldArgs() {
         return this.forge?.fieldArgs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medyll/idae-machine",
-  "version": "0.119.0",
+  "version": "0.121.0",
   "files": [
     "dist",
     "!dist/**/*.test.*",
@@ -48,7 +48,9 @@
   },
   "scope": "@medyll",
   "dependencies": {
-    "@huggingface/prettier-plugin-vertical-align": "^0.2.3"
+    "@huggingface/prettier-plugin-vertical-align": "^0.2.3",
+    "@medyll/idae-slotui-svelte": "0.174.0",
+    "@medyll/idae-idbql": "0.171.0"
   },
   "scripts": {
     "dev": "vite dev",