@medyll/idae-machine 0.124.0 → 0.125.0

package/dist/form/CreateUpdate.svelte

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

package/dist/index.d.ts

@@ -1,27 +1,27 @@
+export { default as CollectionReverseFks } from './ui/CollectionReverseFks.svelte';
+export { default as CollectionListMenu } from './ui/CollectionListMenu.svelte';
+export { default as CollectionList } from './ui/CollectionList.svelte';
+export { default as CollectionFks } from './ui/CollectionFks.svelte';
+export { default as CollectionFieldGuess } from './ui/CollectionFieldGuess.svelte';
+export { default as CollectionButton } from './ui/CollectionButton.svelte';
 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 './main/machineForge.js';
+export * from './main/machineDb.js';
+export * from './main/machineDb.spec.js';
+export * from './main/machine.js';
+export * from './main/machine.spec.js';
 export * from './form/types.js';
 export { default as FieldValue } from './form/FieldValue.svelte';
 export { default as FieldInPlace } from './form/FieldInPlace.svelte';
 export { default as DataProvider } from './form/DataProvider.svelte';
-export { default as DataList } from './form/DataList.svelte';
 export { default as CrudZone } from './form/CrudZone.svelte';
 export { default as CreateUpdate } from './form/CreateUpdate.svelte';
-export { default as CollectionReverseFks } from './form/CollectionReverseFks.svelte';
-export { default as CollectionListMenu } from './form/CollectionListMenu.svelte';
-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 * from './db/types.js';
 export * from './db/testDbSchema.js';
 export * from './db/dbSchema.js';
@@ -32,3 +32,10 @@ export * from './db/dbCollectionFieldValues.spec.js';
 export * from './db/dbCollectionFieldForge.spec.js';
 export * from './db/dataModel.js';
 export * from './db/CrudService.js';
+export * from './main/machine/IDbValidationError.js';
+export * from './main/machine/IDbFormValidate.js';
+export * from './main/machine/IDbError.js';
+export * from './main/machine/IDbCollectionValues.js';
+export * from './main/machine/IDbCollectionFieldValues.js';
+export * from './main/machine/IDbCollectionFieldForge.js';
+export * from './main/machine/IDbCollection.js';

package/dist/index.js

@@ -1,28 +1,28 @@
 // auto exports of entry components
+export { default as CollectionReverseFks } from './ui/CollectionReverseFks.svelte';
+export { default as CollectionListMenu } from './ui/CollectionListMenu.svelte';
+export { default as CollectionList } from './ui/CollectionList.svelte';
+export { default as CollectionFks } from './ui/CollectionFks.svelte';
+export { default as CollectionFieldGuess } from './ui/CollectionFieldGuess.svelte';
+export { default as CollectionButton } from './ui/CollectionButton.svelte';
 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 './main/machineForge.js';
+export * from './main/machineDb.js';
+export * from './main/machineDb.spec.js';
+export * from './main/machine.js';
+export * from './main/machine.spec.js';
 export * from './form/types.js';
 export { default as FieldValue } from './form/FieldValue.svelte';
 export { default as FieldInPlace } from './form/FieldInPlace.svelte';
 export { default as DataProvider } from './form/DataProvider.svelte';
-export { default as DataList } from './form/DataList.svelte';
 export { default as CrudZone } from './form/CrudZone.svelte';
 export { default as CreateUpdate } from './form/CreateUpdate.svelte';
-export { default as CollectionReverseFks } from './form/CollectionReverseFks.svelte';
-export { default as CollectionListMenu } from './form/CollectionListMenu.svelte';
-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 * from './db/types.js';
 export * from './db/testDbSchema.js';
 export * from './db/dbSchema.js';
@@ -33,3 +33,10 @@ export * from './db/dbCollectionFieldValues.spec.js';
 export * from './db/dbCollectionFieldForge.spec.js';
 export * from './db/dataModel.js';
 export * from './db/CrudService.js';
+export * from './main/machine/IDbValidationError.js';
+export * from './main/machine/IDbFormValidate.js';
+export * from './main/machine/IDbError.js';
+export * from './main/machine/IDbCollectionValues.js';
+export * from './main/machine/IDbCollectionFieldValues.js';
+export * from './main/machine/IDbCollectionFieldForge.js';
+export * from './main/machine/IDbCollection.js';

package/dist/main/machine/IDbCollection.d.ts

@@ -0,0 +1,71 @@
+import type { TplCollectionName, Tpl, IdbqModel, TplFields } from "@medyll/idae-idbql";
+import { MachineDb, type IDbFieldRules } from "../machineDb.js";
+import { IDbFormValidate } from "./IDbFormValidate.js";
+import { IDbCollectionFieldForge } from "./IDbCollectionFieldForge.js";
+import { IDbCollectionFieldValues } from "./IDbCollectionFieldValues.js";
+import { IDbCollectionValues } from "./IDbCollectionValues.js";
+/**
+ * IDbCollection
+ *
+ * Represents a single collection template, providing access to its schema, fields, and metadata.
+ *
+ * Main responsibilities:
+ * - Holds references to the collection name, template, and model.
+ * - Provides access to field rules, presentation, and foreign keys.
+ * - Supplies utilities for retrieving collection values and templates.
+ *
+ * Usage:
+ *   const collection = new IDbCollection('agents', idbBase, model);
+ *   const fields = collection.fields;
+ *   const presentation = collection.getPresentation();
+ *
+ * This class is typically used for schema-driven applications and dynamic UI generation.
+ */
+export declare class IDbCollection {
+    #private;
+    /** The collection name. */
+    collection: TplCollectionName;
+    /**
+     * Create a new IDbCollection instance.
+     * @param collectionName The collection name.
+     * @param idbBase The MachineDb instance.
+     * @param model The IdbqModel instance.
+     */
+    constructor(collectionName: TplCollectionName, idbBase: MachineDb, model: IdbqModel);
+    /**
+     * Get the collection model.
+     */
+    get model(): import("@medyll/idae-idbql").CollectionModel<Record<string, any>>;
+    /**
+     * Get the collection fields.
+     */
+    get fields(): TplFields;
+    /**
+     * Get the presentation string for the collection.
+     */
+    getPresentation(): string;
+    /**
+     * Get the field rule for a given field name.
+     * @param fieldName The field name.
+     */
+    getFieldRule(fieldName: keyof TplFields): IDbFieldRules | undefined;
+    /**
+     * Get the collection template.
+     */
+    getTemplate(): Tpl;
+    /**
+     * Get the foreign keys from the model template.
+     */
+    getModelTemplateFks(): Tpl["fks"];
+    /**
+     * Get the index name for the collection.
+     */
+    getIndexName(): string;
+    /**
+     * Get a new IDbCollectionValues instance for this collection.
+     */
+    collectionValues(): IDbCollectionValues<Record<string, 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;
+}

package/dist/main/machine/IDbCollection.js

@@ -0,0 +1,102 @@
+import { MachineDb } from "../machineDb.js";
+import { IDbFormValidate } from "./IDbFormValidate.js";
+import { IDbCollectionFieldForge } from "./IDbCollectionFieldForge.js";
+import { IDbCollectionFieldValues } from "./IDbCollectionFieldValues.js";
+import { IDbCollectionValues } from "./IDbCollectionValues.js";
+/**
+ * IDbCollection
+ *
+ * Represents a single collection template, providing access to its schema, fields, and metadata.
+ *
+ * Main responsibilities:
+ * - Holds references to the collection name, template, and model.
+ * - Provides access to field rules, presentation, and foreign keys.
+ * - Supplies utilities for retrieving collection values and templates.
+ *
+ * Usage:
+ *   const collection = new IDbCollection('agents', idbBase, model);
+ *   const fields = collection.fields;
+ *   const presentation = collection.getPresentation();
+ *
+ * This class is typically used for schema-driven applications and dynamic UI generation.
+ */
+export class IDbCollection {
+    /** The collection name. */
+    collection;
+    /** The collection template. */
+    #template;
+    /** The MachineDb instance. */
+    #machineDb;
+    /** The collection model. */
+    #model;
+    /**
+     * Create a new IDbCollection instance.
+     * @param collectionName The collection name.
+     * @param idbBase The MachineDb instance.
+     * @param model The IdbqModel instance.
+     */
+    constructor(collectionName, idbBase, model) {
+        this.collection = collectionName;
+        this.#machineDb = idbBase;
+        this.#model = model[String(collectionName)];
+        this.#template = this.#model["template"];
+    }
+    /**
+     * Get the collection model.
+     */
+    get model() {
+        return this.#model;
+    }
+    /**
+     * Get the collection fields.
+     */
+    get fields() {
+        return this.#template?.fields;
+    }
+    /**
+     * Get the presentation string for the collection.
+     */
+    getPresentation() {
+        return this.#template?.presentation;
+    }
+    /**
+     * Get the field rule for a given field name.
+     * @param fieldName The field name.
+     */
+    getFieldRule(fieldName) {
+        return this.fields[String(fieldName)];
+    }
+    /**
+     * Get the collection template.
+     */
+    getTemplate() {
+        return this.#template;
+    }
+    /**
+     * Get the foreign keys from the model template.
+     */
+    getModelTemplateFks() {
+        return this.#template?.fks;
+    }
+    /**
+     * Get the index name for the collection.
+     */
+    getIndexName() {
+        return this.#template?.index;
+    }
+    /**
+     * Get a new IDbCollectionValues instance for this collection.
+     */
+    collectionValues() {
+        return new IDbCollectionValues(this.collection, this.#machineDb);
+    }
+    collectionFieldValues(data) {
+        return new IDbCollectionFieldValues(this.collection, data, this.collectionValues());
+    }
+    fieldForge(fieldName, data) {
+        return new IDbCollectionFieldForge(this.collection, fieldName, data, this.collectionValues());
+    }
+    getFormValidate() {
+        return new IDbFormValidate(this.collection, this.#machineDb);
+    }
+}

package/dist/main/machine/IDbCollectionFieldForge.d.ts

@@ -0,0 +1,42 @@
+import type { TplCollectionName } from '@medyll/idae-idbql';
+import { IDbCollectionValues } from './IDbCollectionValues.js';
+import type { IDbForgeArgs, IDbFieldType } from '../machineDb.js';
+import type { IDbForge } from '../machineForge.js';
+/**
+ * IDbCollectionFieldForge
+ *
+ * This class provides advanced metadata and formatting for a single field of a collection, given a data object.
+ * It is designed for dynamic UI generation, form rendering, and introspection in schema-driven applications.
+ *
+ * Main responsibilities:
+ * - Holds references to the collection name, field name, and the data object for context.
+ * - Provides access to the parsed field metadata (IDbForge) for the field, including type, rules, and arguments.
+ * - Offers formatting utilities for the field value, adapting to type (number, text, array, object, etc.).
+ * - Supplies input attributes and type hints for form generation (e.g., htmlInputType, inputDataSet).
+ * - Supports iteration over array/object fields for complex form layouts.
+ * - Enables extraction of raw data and field arguments for validation and UI logic.
+ *
+ * Usage:
+ *   const forge = new IDbCollectionFieldForge('agents', 'name', agentData);
+ *   const formatted = forge.format; // formatted value for display
+ *   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 IDbBase.getCollectionFieldForge for shared instance management.
+ */
+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-fieldArgs" | "data-fieldType" | "data-fieldName" | "data-collection" | "data-collectionId", string>;
+    get forge(): IDbForge | undefined;
+    get fieldArgs(): IDbForgeArgs | undefined;
+    get fieldType(): IDbFieldType | undefined;
+    /**
+     * will return  text.inputBase  for ['url', 'email', 'number', 'date', 'time', 'datetime', 'phone', 'password']
+     */
+    get htmlInputType(): string | 'text' | 'area';
+    get rawData(): T;
+    iterateArray(fieldName: string, data: any[]): IDbForge[];
+    iterateObject(fieldName: string, data: Record<string, any>): IDbForge[];
+}

package/dist/main/machine/IDbCollectionFieldForge.js

@@ -0,0 +1,74 @@
+import { IDbCollectionValues } from './IDbCollectionValues.js';
+/**
+ * IDbCollectionFieldForge
+ *
+ * This class provides advanced metadata and formatting for a single field of a collection, given a data object.
+ * It is designed for dynamic UI generation, form rendering, and introspection in schema-driven applications.
+ *
+ * Main responsibilities:
+ * - Holds references to the collection name, field name, and the data object for context.
+ * - Provides access to the parsed field metadata (IDbForge) for the field, including type, rules, and arguments.
+ * - Offers formatting utilities for the field value, adapting to type (number, text, array, object, etc.).
+ * - Supplies input attributes and type hints for form generation (e.g., htmlInputType, inputDataSet).
+ * - Supports iteration over array/object fields for complex form layouts.
+ * - Enables extraction of raw data and field arguments for validation and UI logic.
+ *
+ * Usage:
+ *   const forge = new IDbCollectionFieldForge('agents', 'name', agentData);
+ *   const formatted = forge.format; // formatted value for display
+ *   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 IDbBase.getCollectionFieldForge for shared instance management.
+ */
+export class IDbCollectionFieldForge {
+    #collection;
+    #collectionValues;
+    #fieldName;
+    #data;
+    constructor(collection, fieldName, data, collectionValues) {
+        this.#collection = collection;
+        this.#collectionValues = collectionValues ?? new IDbCollectionValues(collection);
+        this.#fieldName = String(fieldName);
+        this.#data = data;
+    }
+    get format() {
+        return this.#collectionValues.format(String(this.#fieldName), this.#data);
+    }
+    get inputDataSet() {
+        return this.#collectionValues.getInputDataSet(String(this.#fieldName), this.#data);
+    }
+    // renamed from parseCollectionFieldName
+    get forge() {
+        return this.#collectionValues.idbBase.parseCollectionFieldName(this.#collection, String(this.#fieldName));
+    }
+    get fieldArgs() {
+        return this.forge?.fieldArgs;
+    }
+    get fieldType() {
+        return this.forge?.fieldType;
+    }
+    /**
+     * will return  text.inputBase  for ['url', 'email', 'number', 'date', 'time', 'datetime', 'phone', 'password']
+     */
+    get htmlInputType() {
+        let variant = this?.fieldType?.split('text-')?.[1] ?? this.fieldType;
+        if (variant === 'area')
+            return variant;
+        if (this.forge?.fieldType?.startsWith('text-'))
+            return 'text';
+        if (['url', 'email', 'number', 'date', 'time', 'datetime', 'phone', 'password'].includes(this.forge?.fieldType ?? '')) {
+            return this.forge?.fieldType?.trim?.() ?? 'text';
+        }
+        return 'text';
+    }
+    get rawData() {
+        return this.#data;
+    }
+    iterateArray(fieldName, data) {
+        return this.#collectionValues.iterateArrayField(fieldName, data);
+    }
+    iterateObject(fieldName, data) {
+        return this.#collectionValues.iterateObjectField(fieldName, data);
+    }
+}

package/dist/main/machine/IDbCollectionFieldValues.d.ts

@@ -0,0 +1,57 @@
+import type { TplCollectionName } from '@medyll/idae-idbql';
+import { IDbCollectionValues } from './IDbCollectionValues.js';
+import type { IDbForge } from '../machineForge.js';
+/**
+ * IDbCollectionFieldValues
+ *
+ * Provides utilities to introspect and format field values for a given collection and data object.
+ *
+ * Main responsibilities:
+ * - Holds references to the collection, data, and collection values instance.
+ * - Provides methods to get field metadata, format values, and generate input attributes.
+ * - Supports iteration over array and object fields for advanced UI layouts.
+ *
+ * Usage:
+ *   const fieldValues = new IDbCollectionFieldValues('agents', agentData);
+ *   const forge = fieldValues.getForge('name');
+ *   const formatted = fieldValues.format('name');
+ *
+ * @template T - The type of the data object for the collection.
+ */
+export declare class IDbCollectionFieldValues<T extends Record<string, any>> {
+    #private;
+    /**
+     * Returns the IDbForge metadata for a given field name.
+     * @param fieldName The field name to introspect.
+     */
+    getForge(fieldName: keyof T): IDbForge | undefined;
+    /**
+     * Create a new IDbCollectionFieldValues instance.
+     * @param collection The collection name.
+     * @param data The data object.
+     * @param collectionValues Optional IDbCollectionValues instance.
+     */
+    constructor(collection: TplCollectionName, data: T, collectionValues?: IDbCollectionValues<T>);
+    /**
+     * Format the value of a field, handling arrays and objects.
+     * @param fieldName The field name.
+     */
+    format(fieldName: keyof T): string | string[];
+    /**
+     * Get input attributes for a field.
+     * @param fieldName The field name.
+     */
+    getInputDataSet(fieldName: keyof T): Record<"data-fieldArgs" | "data-fieldType" | "data-fieldName" | "data-collection" | "data-collectionId", string>;
+    /**
+     * Iterate over an array field and return field metadata for each item.
+     * @param fieldName The field name.
+     * @param data The array data.
+     */
+    iterateArray(fieldName: string, data: any[]): IDbForge[];
+    /**
+     * Iterate over an object field and return field metadata for each property.
+     * @param fieldName The field name.
+     * @param data The object data.
+     */
+    iterateObject(fieldName: string, data: Record<string, any>): IDbForge[];
+}

package/dist/main/machine/IDbCollectionFieldValues.js

@@ -0,0 +1,82 @@
+import { IDbCollectionValues } from './IDbCollectionValues.js';
+/**
+ * IDbCollectionFieldValues
+ *
+ * Provides utilities to introspect and format field values for a given collection and data object.
+ *
+ * Main responsibilities:
+ * - Holds references to the collection, data, and collection values instance.
+ * - Provides methods to get field metadata, format values, and generate input attributes.
+ * - Supports iteration over array and object fields for advanced UI layouts.
+ *
+ * Usage:
+ *   const fieldValues = new IDbCollectionFieldValues('agents', agentData);
+ *   const forge = fieldValues.getForge('name');
+ *   const formatted = fieldValues.format('name');
+ *
+ * @template T - The type of the data object for the collection.
+ */
+export class IDbCollectionFieldValues {
+    #collection;
+    #collectionValues;
+    #data;
+    /**
+     * Returns the IDbForge metadata for a given field name.
+     * @param fieldName The field name to introspect.
+     */
+    getForge(fieldName) {
+        return this.#collectionValues.idbBase.parseCollectionFieldName(this.#collection, String(fieldName));
+    }
+    /**
+     * Create a new IDbCollectionFieldValues instance.
+     * @param collection The collection name.
+     * @param data The data object.
+     * @param collectionValues Optional IDbCollectionValues instance.
+     */
+    constructor(collection, data, collectionValues) {
+        this.#collection = collection;
+        this.#collectionValues = collectionValues ?? new IDbCollectionValues(collection);
+        this.#data = data;
+    }
+    /**
+     * Format the value of a field, handling arrays and objects.
+     * @param fieldName The field name.
+     */
+    format(fieldName) {
+        const fieldInfo = this.#collectionValues.idbBase.parseCollectionFieldName(this.#collection, fieldName);
+        if (fieldInfo?.is === 'array') {
+            return this.iterateArray(String(fieldName), this.#data);
+        }
+        if (fieldInfo?.is === 'object') {
+            return this.iterateObject(String(fieldName), this.#data);
+        }
+        return this.#collectionValues.format(fieldName, this.#data);
+    }
+    /**
+     * Get input attributes for a field.
+     * @param fieldName The field name.
+     */
+    getInputDataSet(fieldName) {
+        return this.#collectionValues.getInputDataSet(String(fieldName), this.#data);
+    }
+    // renamed from parseCollectionFieldName
+    // get forge(): IDbForge | undefined {
+    //     return undefined; // Pas de #fieldName dans cette classe, getter non pertinent
+    // }
+    /**
+     * Iterate over an array field and return field metadata for each item.
+     * @param fieldName The field name.
+     * @param data The array data.
+     */
+    iterateArray(fieldName, data) {
+        return this.#collectionValues.iterateArrayField(fieldName, data);
+    }
+    /**
+     * Iterate over an object field and return field metadata for each property.
+     * @param fieldName The field name.
+     * @param data The object data.
+     */
+    iterateObject(fieldName, data) {
+        return this.#collectionValues.iterateObjectField(fieldName, data);
+    }
+}

package/dist/main/machine/IDbCollectionValues.d.ts

@@ -0,0 +1,78 @@
+import type { TplCollectionName, TplFields } from '@medyll/idae-idbql';
+import { MachineDb } from '../machineDb.js';
+import { type IDbForge } from '../machineForge.js';
+/**
+ * IDbCollectionValues
+ *
+ * This class provides utilities to display, format, and introspect field values for a given collection, using the schema and provided data.
+ * 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 (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).
+ * - Supports iteration over array/object fields for advanced UI layouts.
+ * - Enables access to field metadata for validation and rendering.
+ *
+ * Usage:
+ *   const values = new IDbCollectionValues('agents');
+ *   const display = values.presentation(agentData); // formatted display string
+ *   const index = values.indexValue(agentData); // index field value
+ *   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 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 IDbBase instance used for schema introspection.
+     */
+    idbBase: MachineDb;
+    /**
+     * The collection name this instance operates on.
+     */
+    private collectionName;
+    /**
+     * Create a new IDbCollectionValues instance for a given collection.
+     * @param collectionName The collection name.
+     */
+    constructor(collectionName: TplCollectionName, idbBase?: MachineDb);
+    presentation(data: Record<string, any>): string;
+    /**
+     * Get the value of the index field for a data object.
+     * @param data The data object.
+     * @returns The value of the index field, or null if not found.
+     */
+    indexValue(data: Record<string, any>): any | null;
+    /**
+     * Format a field value for display, using the field type and schema.
+     * @param fieldName The field name.
+     * @param data The data object.
+     * @returns The formatted value as a string.
+     */
+    format(fieldName: keyof T, data: T): string;
+    /**
+     * Get a set of data-* attributes for a field, for use in form generation or UI.
+     * @param fieldName The field name.
+     * @param data The data object.
+     * @returns An object with data-* attributes for the field.
+     */
+    getInputDataSet(fieldName: string, data: T): Record<`data-${'collection' | 'collectionId' | 'fieldName' | 'fieldType' | 'fieldArgs'}`, string>;
+    /**
+     * Iterate over an array field and return an array of IDbForge objects for each element.
+     * @param fieldName The field name.
+     * @param data The array data.
+     * @returns An array of IDbForge objects.
+     */
+    iterateArrayField(fieldName: keyof TplFields, data: any[]): IDbForge[];
+    /**
+     * Iterate over an object field and return an array of IDbForge objects for each property.
+     * @param fieldName The field name.
+     * @param data The object data.
+     * @returns An array of IDbForge objects.
+     */
+    iterateObjectField(fieldName: keyof TplFields, data: Record<string, unknown>): IDbForge[];
+}