tuain-ng-forms-lib 17.3.7 → 17.4.0

package/lib/classes/forms/action.d.ts

@@ -1,7 +1,8 @@
 import { Observable } from 'rxjs';
 import { FormElement } from './element';
 import { ActionDefinition, IFormConfig } from '../../interfaces/form-config.interface';
-export declare class FormAction extends FormElement {
+import type { IAction } from '../../interfaces/action.interface';
+export declare class FormAction extends FormElement implements IAction {
     private readonly _actionActivated;
     private _actionCode;
     private _actionName;
@@ -34,7 +35,7 @@ export declare class FormAction extends FormElement {
     start(): void;
     stop(): void;
     connectWithParentForm(form: any, formChangeSubject: any): void;
-    updateRestrictedVisibility(event: any): void;
+    updateRestrictedVisibility(_event: unknown): void;
     viewOnState(state: string): boolean;
     get actionActivated(): Observable<string>;
     notifyActivation(): void;

package/lib/classes/forms/element.d.ts

@@ -1,6 +1,7 @@
 import { FormPiecePropagate } from './piece-propagate';
 import { ElementAttribute, IFormConfig, PieceDefinition } from '../../interfaces/form-config.interface';
-export declare abstract class FormElement extends FormPiecePropagate {
+import type { IFormElement } from '../../interfaces/piece.interface';
+export declare abstract class FormElement extends FormPiecePropagate implements IFormElement {
     elementType: string | null;
     constructor(elementDefinition: PieceDefinition, formConfig: IFormConfig);
     setAttr(attr: ElementAttribute, value: any): void;

package/lib/classes/forms/field.d.ts

@@ -1,6 +1,7 @@
 import { Observable } from 'rxjs';
 import { FormElement } from './element';
 import { FieldDefinition, FieldEditionEvent, FieldCustomEventData, IFormConfig } from '../../interfaces/form-config.interface';
+import type { IField } from '../../interfaces/field.interface';
 export interface DetailEvent {
     code: string;
     detail: any;
@@ -9,7 +10,7 @@ export interface FieldOption {
     fieldOptionValue: string;
     fieldOptionId: string;
 }
-export declare class FieldDescriptor extends FormElement {
+export declare class FieldDescriptor extends FormElement implements IField {
     private readonly _customEvent;
     private readonly _editionFinish;
     private readonly _editionPartial;
@@ -175,15 +176,15 @@ export declare class FieldDescriptor extends FormElement {
     /**
      * @deprecated Since v17. Use optionText instead. Will be removed in v19.
      */
-    getOptionText(): string;
+    getOptionText(): string | null;
     /**
      * @deprecated Since v17. Use options instead. Will be removed in v19.
      */
-    getFieldOptions(): FieldOption[];
+    getFieldOptions(): FieldOption[] | null;
     /**
      * @deprecated Since v17. Use options instead. Will be removed in v19.
      */
-    setFieldOptions(newOptions: any): any;
+    setFieldOptions(newOptions: any): void;
     /**
      * @deprecated Since v17. Use intrinsicErrorMessage instead. Will be removed in v19.
      */

package/lib/classes/forms/form.d.ts

@@ -1,3 +1,4 @@
+import { Observable } from 'rxjs';
 import { FormAction } from './action';
 import { FieldDescriptor, FieldOption } from './field';
 import { RecordTable } from './table/table';
@@ -5,6 +6,7 @@ import { RecordFormSection } from './section';
 import { RecordFormSubSection } from './subsection';
 import { TableRecordData } from './table/row-data';
 import { FormStateEvent, IFormConfig } from '../../interfaces/form-config.interface';
+import type { IForm } from '../../interfaces/form.interface';
 interface Transition {
     name: string;
     source: string;
@@ -38,7 +40,7 @@ export interface FormPayload {
     fields: FieldPayload[];
     tables: TablePayload[];
 }
-export declare class FormStructureAndData {
+export declare class FormStructureAndData implements IForm {
     private readonly _stateChange;
     private _immutableData;
     private _extraInfo;
@@ -70,7 +72,7 @@ export declare class FormStructureAndData {
     supportState(state?: string): boolean;
     getNextStates(): string[];
     changeState(newState: string): boolean;
-    get stateChange(): import("rxjs").Observable<FormStateEvent>;
+    get stateChange(): Observable<FormStateEvent>;
     setStateFlow(states: any, transitions: any, defaultState?: string, stateDescriptions?: any): void;
     getImmutableElement(name: string): any;
     set immutableData(immutableData: any);

package/lib/classes/forms/piece-propagate.d.ts

@@ -1,7 +1,8 @@
 import { BehaviorSubject, Observable } from 'rxjs';
 import { FormPiece } from './piece';
 import { AttributeChange, IFormConfig, PieceDefinition } from '../../interfaces/form-config.interface';
-export declare abstract class FormPiecePropagate extends FormPiece {
+import type { IFormPropagate } from '../../interfaces/piece.interface';
+export declare abstract class FormPiecePropagate extends FormPiece implements IFormPropagate {
     protected _attributeChange: BehaviorSubject<AttributeChange | null>;
     constructor(pieceDefinition: PieceDefinition, formConfig: IFormConfig);
     get attributeChange(): Observable<AttributeChange | null>;

package/lib/classes/forms/piece.d.ts

@@ -1,6 +1,7 @@
 import { Subject } from 'rxjs';
 import { IFormConfig, PieceDefinition } from '../../interfaces/form-config.interface';
-export declare abstract class FormPiece {
+import type { IFormPiece } from '../../interfaces/piece.interface';
+export declare abstract class FormPiece implements IFormPiece {
     protected destroy$: Subject<void>;
     protected _formState: string;
     protected _visibleForced: boolean;
@@ -11,7 +12,7 @@ export declare abstract class FormPiece {
     protected visibleStates: string[];
     protected enabledStates: string[];
     protected _form: any;
-    protected _formConfig: IFormConfig;
+    protected readonly _formConfig: IFormConfig;
     protected _visible: boolean;
     protected _disabled: boolean;
     customAttributes: Record<string, any>;
@@ -44,7 +45,7 @@ export declare abstract class FormPiece {
     set disabled(disabled: boolean);
     enable(): void;
     disable(): void;
-    formStateChangeCustomSubscribe(form: any, formChangeSubject: any): void;
+    formStateChangeCustomSubscribe(_form: any, _formChangeSubject: any): void;
     formStateChange(state: any): void;
     connectWithParentForm(form: any, formChangeSubject: any): void;
     get form(): any;

package/lib/classes/forms/section.d.ts

@@ -4,7 +4,8 @@ import { FormAction } from './action';
 import { FieldDescriptor } from './field';
 import { RecordFormSubSection } from './subsection';
 import { SectionDefinition, IFormConfig } from '../../interfaces/form-config.interface';
-export declare class RecordFormSection extends FormPiecePropagate {
+import type { ISection } from '../../interfaces/section.interface';
+export declare class RecordFormSection extends FormPiecePropagate implements ISection {
     private readonly _activation;
     private readonly _inactivation;
     private _active;
@@ -34,7 +35,7 @@ export declare class RecordFormSection extends FormPiecePropagate {
     inactivate(): void;
     get title(): string | null;
     set title(title: string | null);
-    getVisibleSubsections(state?: string): RecordFormSubSection[];
+    getVisibleSubsections(_state?: string): RecordFormSubSection[];
     getSubsection(subSectionCode: string): RecordFormSubSection | null;
     activateSubSection(subSectionCode: string): void;
     getFields(): FieldDescriptor[];

package/lib/classes/forms/subsection.d.ts

@@ -4,7 +4,8 @@ import { FieldDescriptor } from './field';
 import { FormElement } from './element';
 import { RecordTable } from './table/table';
 import { IFormConfig, SubsectionDefinition } from '../../interfaces/form-config.interface';
-export declare class RecordFormSubSection extends FormPiecePropagate {
+import type { ISubSection } from '../../interfaces/section.interface';
+export declare class RecordFormSubSection extends FormPiecePropagate implements ISubSection {
     private _customRender;
     private _subsectionId;
     private _subsectionCode;

package/lib/classes/forms/table/action.d.ts

@@ -1,6 +1,7 @@
 import { FormPiece } from '../piece';
 import { ActionDefinition, IFormConfig } from '../../../interfaces/form-config.interface';
-export declare class TableAction extends FormPiece {
+import type { ITableAction } from '../../../interfaces/table.interface';
+export declare class TableAction extends FormPiece implements ITableAction {
     private _actionCode;
     private _actionTitle;
     private _iconName;

package/lib/classes/forms/table/column.d.ts

@@ -1,5 +1,6 @@
 import { FormPiece } from '../piece';
 import { ColumnDefinition, IFormConfig } from '../../../interfaces/form-config.interface';
+import type { ITableColumn } from '../../../interfaces/table.interface';
 export interface FilterDef {
     operators: string[];
     options: any[];
@@ -9,7 +10,7 @@ export interface FilterSetup {
     operator: string;
     values: any[];
 }
-export declare class RecordTableColumn extends FormPiece {
+export declare class RecordTableColumn extends FormPiece implements ITableColumn {
     fieldCode: string;
     fieldTitle: string;
     fieldType: string;

package/lib/classes/forms/table/row-data.d.ts

@@ -1,5 +1,6 @@
 import { RecordTableColumn } from './column';
-export declare class TableRecordData {
+import type { ITableRecord } from '../../../interfaces/table.interface';
+export declare class TableRecordData implements ITableRecord {
     recordId: string | null;
     selected: boolean;
     recordData: Record<string, any>;
@@ -7,7 +8,7 @@ export declare class TableRecordData {
     toggleSelect(): void;
     select(): void;
     unselect(): void;
-    get recordIdKey(): string;
+    get recordIdKey(): string | null;
     getFieldValue(fieldCode: string): any;
     hasPattern(words: string[], columnObj: any): boolean;
     hasCondition(columnFilters: any[]): boolean;

package/lib/classes/forms/table/table.d.ts

@@ -4,6 +4,7 @@ import { RecordTableColumn, FilterSetup } from './column';
 import { TableAction } from './action';
 import { TableRecordData } from './row-data';
 import { TableSorting, TableDefinition, IFormConfig } from '../../../interfaces/form-config.interface';
+import type { ITable } from '../../../interfaces/table.interface';
 export interface TableActionEvent {
     actionCode: string;
     recordId: any;
@@ -14,7 +15,7 @@ export interface TableEvent {
     actionCode: string | null;
     actionDetail: any;
 }
-export declare class RecordTable extends FormElement {
+export declare class RecordTable extends FormElement implements ITable {
     private readonly _inlineActionTrigger;
     private readonly _globalActionTrigger;
     private readonly _recordSelectionTrigger;
@@ -68,6 +69,7 @@ export declare class RecordTable extends FormElement {
     get selectionField(): string;
     get allSelected(): boolean;
     get tableCode(): string;
+    get code(): string;
     get tableTitle(): string;
     get currentPage(): number;
     get totalPages(): number;

package/lib/components/elements/layout/piece.component.d.ts

@@ -7,10 +7,10 @@ export declare abstract class PieceComponent {
     enabled: import("@angular/core").Signal<boolean>;
     customAttributes: import("@angular/core").WritableSignal<Record<string, any>>;
     setForm(form: any): void;
-    propagatedAttributeChange(attribute: string, value?: any): void;
+    propagatedAttributeChange(_attribute: string, _value?: any): void;
     updatePieceAttribute(signaledAttributes: string[], signaledAttribute: string, value: any): void;
     updatePieceAttributes(piece: any, signaledAttributes: string[]): void;
-    customAttributeChange(subAttribute: string, value?: any): void;
+    customAttributeChange(_subAttribute: string, _value?: any): void;
     updateCustomAttribute(attrName: string, attrValue: any): void;
     replaceCustomAttributes(customAttributes: Record<string, any>): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PieceComponent, never>;

package/lib/components/forms/basic-form.d.ts

@@ -67,9 +67,9 @@ export declare abstract class BasicFormComponent extends FormStructureAndData im
     displayActionServerError(): void;
     displayValidationServerError(): void;
     displayTableServerError(): void;
-    showFieldInfo(code?: string, detail?: any): void;
-    showModalDialog(title: any, body: any, options: any, callback?: any, params?: any): void;
-    openUploadDialog(title: any, body: any, options: any, callback?: any, params?: any): void;
+    showFieldInfo(_code?: string, _detail?: any): void;
+    showModalDialog(_title: any, _body: any, _options: any, _callback?: any, _params?: any): void;
+    openUploadDialog(_title: any, _body: any, _options: any, _callback?: any, _params?: any): void;
     subscribeAppEvent(eventName: string, callback: (...args: any[]) => any): void;
     openForm(name: string, data?: any, backData?: any, cleanStack?: boolean): void;
     enableActivityNotification(): void;
@@ -141,7 +141,7 @@ export declare abstract class BasicFormComponent extends FormStructureAndData im
     removeFieldValidationFinish(codes: string[] | string | null): void;
     onFieldValidationFinish(codes: string[] | string | null, callback: (...args: any[]) => any, properties?: Record<string, any> | null): void;
     removeFieldAllEventCallbacks(codes: string[] | string | null): void;
-    startFieldInputValidation(code: string, intrinsicValidation?: boolean): Promise<boolean>;
+    startFieldInputValidation(code: string, _intrinsicValidation?: boolean): Promise<boolean>;
     startFieldCustomEvent(code: string, eventName: string, eventData: any): Promise<void>;
     startFieldValidation(code: string, intrinsicValidation?: boolean): Promise<void>;
     startServerFieldValidation(inputField: string | FieldDescriptor): Promise<void>;

package/lib/interfaces/action.interface.d.ts

@@ -0,0 +1,23 @@
+import type { Observable } from 'rxjs';
+import type { IFormElement } from './piece.interface';
+/**
+ * Contrato público de una acción de formulario.
+ * Implementado por {@link FormAction}.
+ */
+export interface IAction extends IFormElement {
+    actionCode: string;
+    actionName: string;
+    iconName: string;
+    inProgress: boolean;
+    newState: string;
+    backend: boolean;
+    restrictedOnField: string | null;
+    restrictedOnOperator: string | null;
+    restrictedOnValue: string | null;
+    readonly actionActivated: Observable<string>;
+    start(): void;
+    stop(): void;
+    notifyActivation(): void;
+    updateRestrictedVisibility(event: unknown): void;
+    updateFromServer(receivedAction: any): void;
+}

package/lib/interfaces/field.interface.d.ts

@@ -0,0 +1,70 @@
+import type { Observable } from 'rxjs';
+import type { IFormElement } from './piece.interface';
+import type { FieldEditionEvent, FieldCustomEventData } from './form-config.interface';
+import type { FieldOption, DetailEvent } from '../classes/forms/field';
+/**
+ * Contrato público de un campo de formulario.
+ * Implementado por {@link FieldDescriptor}.
+ */
+export interface IField extends IFormElement {
+    readonly code: string;
+    readonly name: string;
+    title: string;
+    type: string;
+    captureType: string;
+    placeholder: string;
+    alignment: string;
+    info: any;
+    tooltip: string;
+    format: RegExp | null;
+    value: any;
+    defaultValue: any;
+    required: boolean;
+    outputOnly: boolean;
+    visibleLabel: boolean;
+    hasChanged: boolean;
+    readonly empty: boolean;
+    readonly externalValue: any;
+    readonly options: FieldOption[] | null;
+    readonly optionText: string | null;
+    minValue: any;
+    maxValue: any;
+    minLength: number;
+    maxLength: string;
+    readonly backend: boolean;
+    validateOnServer: boolean;
+    serverAction: boolean;
+    validating: boolean;
+    readonly onValidation: boolean;
+    error: {
+        type: string;
+        code: string;
+        message: string;
+    };
+    errorCode: string;
+    errorMessage: string;
+    readonly errorType: string;
+    readonly editionFinish: Observable<FieldEditionEvent>;
+    readonly editionPartial: Observable<FieldEditionEvent>;
+    readonly customEvent: Observable<FieldCustomEventData>;
+    readonly detailRequest: Observable<DetailEvent>;
+    setValue(newValue: any, widgetUpdate?: boolean): void;
+    clean(): void;
+    focus(): void;
+    hasError(): boolean;
+    resetError(): void;
+    setError(code: string, message: string | null, type?: string): void;
+    setEditable(editable?: boolean): void;
+    setErrorCode(code: string): void;
+    setErrorMessage(msg: string): void;
+    getErrorCode(): string;
+    getErrorMessage(): string;
+    showLabel(): void;
+    hideLabel(): void;
+    defaultEmpty(): boolean;
+    notifyEditionFinish(): void;
+    notifyEditionPartial(): void;
+    notifyEditionDetailRequest(detail: any): void;
+    triggerCustomEvent(eventName: string, eventData: any): void;
+    updateFromServer(fld: any): void;
+}

package/lib/interfaces/form-config.interface.d.ts

@@ -34,23 +34,29 @@ export interface FieldCustomEventData {
 export interface FormStateEvent {
     state: string;
 }
+/**
+ * Configuración del framework por aplicación. Se comparte por referencia entre
+ * todas las instancias del modelo, por lo que su contrato es **inmutable**: una
+ * vez definido no debe mutarse (las propiedades son `readonly`). La librería solo
+ * lo lee, nunca lo modifica.
+ */
 export interface IFormConfig {
-    fieldTypes: Record<string, string>;
-    captureTypes: Record<string, string>;
-    captureTypesWithOptions: string[];
-    widgets: {
-        byType: Record<string, string>;
-        byCapture: Record<string, string>;
-    };
-    fieldValidations: Record<string, IFieldValidation>;
-    tableActions: Record<string, string>;
-    defaultRecordsPerPage: number;
-    formStandardErrors: Record<string, string>;
-    tableFieldStyles: Record<string, Record<string, string>>;
-    defaultFieldAttributes?: Record<string, any>;
-    defaultActionAttributes?: Record<string, any>;
-    notLabeledFields?: string[];
-    arrayFieldTypes?: Record<string, any>;
+    readonly fieldTypes: Readonly<Record<string, string>>;
+    readonly captureTypes: Readonly<Record<string, string>>;
+    readonly captureTypesWithOptions: ReadonlyArray<string>;
+    readonly widgets: Readonly<{
+        byType: Readonly<Record<string, string>>;
+        byCapture: Readonly<Record<string, string>>;
+    }>;
+    readonly fieldValidations: Readonly<Record<string, IFieldValidation>>;
+    readonly tableActions: Readonly<Record<string, string>>;
+    readonly defaultRecordsPerPage: number;
+    readonly formStandardErrors: Readonly<Record<string, string>>;
+    readonly tableFieldStyles: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    readonly defaultFieldAttributes?: Readonly<Record<string, any>>;
+    readonly defaultActionAttributes?: Readonly<Record<string, any>>;
+    readonly notLabeledFields?: ReadonlyArray<string>;
+    readonly arrayFieldTypes?: Readonly<Record<string, any>>;
 }
 export interface PieceDefinition {
     visibleStates?: string[] | string;
@@ -77,6 +83,8 @@ export interface FieldDefinition extends PieceDefinition {
     outputOnly?: boolean;
     minLength?: number;
     maxLength?: number;
+    minValue?: any;
+    maxValue?: any;
     errorCode?: string;
     errorMessage?: string;
     errorType?: string;

package/lib/interfaces/form.interface.d.ts

@@ -0,0 +1,106 @@
+import type { Observable } from 'rxjs';
+import type { IFormConfig, FormStateEvent } from './form-config.interface';
+import type { IField } from './field.interface';
+import type { IAction } from './action.interface';
+import type { ITable, ITableRecord } from './table.interface';
+import type { ISection, ISubSection } from './section.interface';
+import type { FieldOption } from '../classes/forms/field';
+import type { FormPayload } from '../classes/forms/form';
+/**
+ * Contrato público del contenedor de un formulario (estructura + datos).
+ * Expone el acceso a campos, acciones, tablas y la gestión de estado.
+ * Implementado por {@link FormStructureAndData} (y por herencia, por BasicFormComponent).
+ */
+export interface IForm {
+    customAttributes: Record<string, any>;
+    formConfig: IFormConfig;
+    state: string;
+    name: string;
+    title: string;
+    readonly defaultState: string;
+    readonly states: any[];
+    readonly stateDescriptions: any[];
+    readonly stateChange: Observable<FormStateEvent>;
+    supportState(state?: string): boolean;
+    getNextStates(): string[];
+    changeState(newState: string): boolean;
+    setStateFlow(states: any, transitions: any, defaultState?: string, stateDescriptions?: any): void;
+    setConfig(formConfig: IFormConfig): void;
+    cleanForm(): void;
+    loadDefinition(definitionReceived: any): void;
+    immutableData: any;
+    extraInfo: any;
+    getImmutableElement(name: string): any;
+    getExtraInfo(name: string): any;
+    getCustomAttribute(name: string): any;
+    setCustomAttribute(name: string, value: any): void;
+    setCustomAttributes(attributes: Record<string, any>): IForm;
+    readonly fieldNames: string[];
+    getFields(): IField[];
+    getFieldNames(): string[];
+    getField(code: string): IField;
+    enableField(code: string): void;
+    disableField(code: string): void;
+    getFieldValue(code: string): any;
+    getFieldOptionText(code: string): any;
+    getFieldOptions(code: string): FieldOption[] | null;
+    setFieldValue(code: string, value: any): any;
+    setFieldError(code: string, errorCode: string, message: string, type?: string): any;
+    setFieldErrorMessage(code: string, message: string): any;
+    setFieldRequired(inputCodes: string[] | string | null, required: boolean): any;
+    setFieldOptions(code: string, optionsArray: any[], idAttribute: string, valueAttribute: string | string[], separator?: string): any;
+    getFieldSet(filter: ((field: IField) => boolean) | null, inputCodes: string[] | string | null, secCode?: string | null, subCode?: string | null): string[];
+    applyOnFields(processFunc: (field: IField) => void, inputCodes?: string[] | string | null, secCode?: string, subCode?: string): number;
+    enableFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
+    disableFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
+    showFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
+    hideFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
+    cleanFields(codes?: string[] | string | null, secCode?: string, subCode?: string): number;
+    getRequiredFields(codes?: string[] | string | null, secCode?: string, subCode?: string): string[];
+    getRequiredEmptyFields(codes?: string[] | string | null, secCode?: string, subCode?: string, onlyVisible?: boolean): string[];
+    getChangedFields(codes?: string[] | string | null, secCode?: string, subCode?: string): string[];
+    getFieldsWithValidationIssues(codes?: string[] | string | null, secCode?: string, subCode?: string, onlyVisible?: boolean): string[];
+    getFieldsValues(inputCodes?: string[] | string | null, secCode?: string, subCode?: string): Record<string, any>;
+    getActions(): IAction[];
+    getAction(code: string): IAction;
+    showActions(codes: string[] | string): void;
+    hideActions(codes: string[] | string): void;
+    enableActions(codes: string[] | string): void;
+    disableActions(codes: string[] | string): void;
+    enableAction(code: string): void;
+    disableAction(code: string): void;
+    showAction(code: string): void;
+    hideAction(code: string): void;
+    getHeaderActions(): IAction[];
+    getActionsByAttribute(name: string, value: any): IAction[];
+    getTables(): ITable[];
+    getTable(code: string): ITable;
+    getTableRecord(code: string, id: string): ITableRecord;
+    enableTables(codes: string[] | string): void;
+    disableTables(codes: string[] | string): void;
+    showTables(codes: string[] | string): void;
+    hideTables(codes: string[] | string): void;
+    cleanTables(codes: string[] | string): void;
+    readonly sectionTitles: string[];
+    readonly visibleSections: ISection[];
+    getSections(): ISection[];
+    getSection(code: string): ISection;
+    getSectionsTitles(): string[];
+    numSections(): number;
+    getSectionsByAttribute(name: string, value: any): ISection[];
+    showSections(codes: string[] | string): void;
+    hideSections(codes: string[] | string): void;
+    showSection(code: string): void;
+    hideSection(code: string): void;
+    activeSection(): string;
+    activateSection(code: string): void;
+    getSubSection(code: string, subCode: string): ISubSection;
+    showSubSections(code: string, subCodes: string[] | string): void;
+    showSubSection(code: string, subCode: string): void;
+    hideSubSection(code: string, subCode: string): void;
+    hideSubSections(code: string, subCodes: string[] | string): void;
+    getSectionActions(code: string): IAction[];
+    getSectionActionNames(code: string): string[];
+    cleanData(): void;
+    getPayload(): FormPayload;
+}

package/lib/interfaces/index.d.ts

@@ -1,2 +1,9 @@
 export * from './form-config.interface';
 export * from './icon-resolver.interface';
+export * from './sse-live-connection.interface';
+export * from './piece.interface';
+export * from './field.interface';
+export * from './action.interface';
+export * from './table.interface';
+export * from './section.interface';
+export * from './form.interface';

package/lib/interfaces/piece.interface.d.ts

@@ -0,0 +1,67 @@
+import type { Observable } from 'rxjs';
+import type { AttributeChange, ElementAttribute, IFormConfig } from './form-config.interface';
+/**
+ * Contrato público de la pieza base de un formulario (FormPiece).
+ * Define la gestión de visibilidad, habilitación, estados y custom attributes
+ * común a campos, acciones, tablas, columnas y acciones de tabla.
+ *
+ * Implementado por {@link FormPiece}.
+ */
+export interface IFormPiece {
+    customAttributes: Record<string, any>;
+    readonly absoluteVisible: boolean;
+    readonly absoluteDisabled: boolean;
+    visible: boolean;
+    enabled: boolean;
+    disabled: boolean;
+    readonly editable: boolean;
+    readonly form: any;
+    readonly formConfig: IFormConfig;
+    widget: any;
+    getCustomAttribute(name: string): any;
+    setCustomAttribute(name: string, value: any): void;
+    setCustomAttributes(attributes: Record<string, any>): IFormPiece;
+    matchAttribute(name: string, value: string): boolean;
+    setVisibleStates(newStates: any): void;
+    addVisibleState(state: string): void;
+    removeVisibleState(state: string): void;
+    setEnabledStates(newStates: any): void;
+    addEnabledState(state: string): void;
+    removeEnabledState(state: string): void;
+    viewOnState(state: string): boolean;
+    enabledOnState(state: string): boolean;
+    visibleOn(state: string): boolean;
+    enabledOn(state: string): boolean;
+    setVisibility(visible: boolean, forced?: boolean | null): void;
+    show(forced?: boolean | null): void;
+    hide(forced?: boolean | null): void;
+    enable(): void;
+    disable(): void;
+    formStateChangeCustomSubscribe(form: any, formChangeSubject: any): void;
+    formStateChange(state: any): void;
+    connectWithParentForm(form: any, formChangeSubject: any): void;
+    destroy(): void;
+}
+/**
+ * Contrato de una pieza con propagación reactiva de atributos (FormPiecePropagate),
+ * base común de elementos (campos/acciones/tablas) y secciones/subsecciones.
+ *
+ * Implementado por {@link FormPiecePropagate}.
+ */
+export interface IFormPropagate extends IFormPiece {
+    readonly attributeChange: Observable<AttributeChange | null>;
+    propagateAttribute(name: string, value: any): void;
+}
+/**
+ * Contrato público de un elemento de formulario (FormElement), que añade a
+ * {@link IFormPropagate} la identificación de tipo y la actualización de atributos.
+ *
+ * Implementado por {@link FormElement} y, por herencia, por campos, acciones y tablas.
+ */
+export interface IFormElement extends IFormPropagate {
+    elementType: string | null;
+    setAttr(attr: ElementAttribute, value: any): void;
+    isField(): boolean;
+    isAction(): boolean;
+    isTable(): boolean;
+}