@praxisui/dynamic-form 8.0.0-beta.11 → 8.0.0-beta.13

package/index.d.ts

@@ -7,7 +7,7 @@ import { MatDialog } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import { CdkDragStart, CdkDragMove, CdkDragEnd, CdkDragDrop } from '@angular/cdk/drag-drop';
 import * as _praxisui_core from '@praxisui/core';
-import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, AiCapability, BackConfig, ApiEndpoint, ApiUrlEntry, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, GlobalActionCatalogEntry, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, GlobalActionRef, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormLayoutItem, FormActionButton, AiCapability, BackConfig, ApiEndpoint, ApiUrlEntry, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, RichContentDocument, JsonLogicRecord, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, ApiUrlConfig, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, GlobalActionCatalogEntry, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, GlobalActionRef, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapabilityCatalog, ComponentAuthoringManifest } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -53,6 +53,7 @@ interface RuleApplicationResult {
     actionProps: Record<string, Record<string, any>>;
     rowProps: Record<string, Record<string, any>>;
     columnProps: Record<string, Record<string, any>>;
+    visualBlockProps: Record<string, Record<string, any>>;
 }
 declare class FormRulesService {
     private readonly jsonLogic;
@@ -96,6 +97,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -106,6 +108,7 @@ interface Operation {
         sectionId?: string;
         rowId?: string;
         columnId?: string;
+        itemId?: string;
         fieldName?: string;
         sectionIndex?: number;
         rowIndex?: number;
@@ -178,6 +181,14 @@ declare class DynamicFormLayoutService {
     private capitalizeFirstLetter;
     private assertIndex;
     private mutate;
+    private getFieldName;
+    private findFieldLayoutItemIndex;
+    private getLayoutInsertIndexForFieldIndex;
+    private applyLayoutItemsToColumn;
+    private insertFieldLayoutItem;
+    private removeFieldLayoutItem;
+    private hasLayoutItems;
+    private moveFieldLayoutItem;
     moveSection(config: FormConfig, fromIndex: number, toIndex: number): LayoutResult;
     insertSection(config: FormConfig, section: any, atIndex?: number): LayoutResult;
     removeSection(config: FormConfig, index: number, _policy?: RemovePolicy): LayoutResult;
@@ -235,6 +246,37 @@ declare class DynamicFormLayoutService {
         rowId: string;
         columnId: string;
     }, field: any, atIndex?: number): LayoutResult;
+    insertLayoutItemById(config: FormConfig, target: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+    }, item: FormLayoutItem, atIndex?: number): LayoutResult;
+    moveLayoutItemById(config: FormConfig, from: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+        itemId: string;
+    }, to: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+        toIndex: number;
+    }, options?: {
+        policy?: RemovePolicy;
+        correlationId?: string;
+        origin?: string;
+    }): LayoutResult;
+    updateLayoutItemById(config: FormConfig, target: {
+        sectionId: string;
+        rowId: string;
+        columnId: string;
+        itemId: string;
+    }, item: FormLayoutItem): LayoutResult;
+    removeLayoutItemById(config: FormConfig, sectionId: string, rowId: string, columnId: string, itemId: string, options?: {
+        policy?: RemovePolicy;
+        correlationId?: string;
+        origin?: string;
+    }): LayoutResult;
     removeFieldById(config: FormConfig, sectionId: string, rowId: string, columnId: string, fieldName: string, options?: {
         policy?: RemovePolicy;
         correlationId?: string;
@@ -507,6 +549,21 @@ type ResolvedSectionHeaderVisual = {
     text?: string;
     ariaLabel: string;
 };
+interface FormColumnFieldsRenderItem {
+    kind: 'fields';
+    id: string;
+    fields: FieldMetadata[];
+}
+interface FormColumnRichContentRenderItem {
+    kind: 'richContent';
+    id: string;
+    document: RichContentDocument;
+    layout: 'block' | 'inline';
+    rootClassName?: string | null;
+    className?: string | null;
+    style?: Record<string, any> | null;
+}
+type FormColumnRenderItem = FormColumnFieldsRenderItem | FormColumnRichContentRenderItem;
 declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private crud;
     private http;
@@ -668,6 +725,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     actionRuleProps: Record<string, Record<string, any>>;
     private rowRuleProps;
     private columnRuleProps;
+    private visualBlockRuleProps;
     private pendingEntityId;
     private loadedEntityId;
     private hydratedEntityId;
@@ -890,11 +948,19 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     toggleSectionCollapse(event: Event, section: FormSection): void;
     sectionPanelId(section: FormSection, index: number): string;
     getSectionCollapsedSummary(section: FormSection): string;
+    getColumnItems(column: FormColumn): FormLayoutItem[];
+    getColumnRenderItems(column: FormColumn): FormColumnRenderItem[];
     getColumnFields(column: {
-        fields: string[];
+        fields?: string[];
+        items?: FormLayoutItem[];
         id?: string;
     }): FieldMetadata[];
+    getRichContentLayoutItemDocument(item: FormLayoutItem): RichContentDocument | null;
+    getRichContentLayoutItemLayout(item: FormLayoutItem): 'block' | 'inline';
+    private getVisualBlockRuleProps;
+    private isRichContentLayoutItemVisible;
     private getColumnFieldsSignature;
+    private getColumnItemsSignature;
     private getColumnRuleProps;
     private buildFieldRuleMetadataOverrides;
     private normalizeRuleFieldOptions;
@@ -1242,6 +1308,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     onSchemaPrefsChange(reason: string): void;
     private createRuleBuilderConfig;
     private mapMetadataToSchema;
+    private getVisualBlockTargetLabel;
+    private findRichContentNodeText;
     private mapDataTypeToFieldType;
     ngOnDestroy(): void;
     onLayoutSelect(event: any): void;
@@ -1335,11 +1403,42 @@ declare class LayoutPrefsService {
     static ɵprov: i0.ɵɵInjectableDeclaration<LayoutPrefsService>;
 }
 
+type VisualBlockPresetId = 'text' | 'notice' | 'divider' | 'infoCard';
+interface VisualBlockPreset {
+    id: VisualBlockPresetId;
+    labelKey: string;
+    icon: string;
+}
+
 interface FieldDropEvent {
     event: CdkDragDrop<any>;
     sectionIndex: number;
     rowIndex: number;
 }
+interface VisualBlockEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    itemId: string;
+}
+interface AddVisualBlockEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    presetId: VisualBlockPresetId;
+}
+interface AddApiFieldEvent {
+    sectionIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    fieldName: string;
+}
+interface MoveVisualBlockEvent extends VisualBlockEvent {
+    direction: -1 | 1;
+}
+interface MoveVisualBlockToColumnEvent extends VisualBlockEvent {
+    targetColumnIndex: number;
+}
 /**
  * Editor component for configuring sections, rows and fields of a dynamic form.
  * Provides a collapsible palette of available fields.
@@ -1349,13 +1448,18 @@ declare class LayoutEditorComponent implements OnInit {
     configChange: EventEmitter<FormConfig>;
     paletteCollapsed: boolean;
     protected readonly prefs: LayoutPrefsService;
+    private readonly layoutService;
+    private readonly settingsPanel;
+    private readonly i18n;
+    private visualBlockIdSequence;
     protected readonly colorTokens: typeof LayoutColorToken;
     selected: {
-        type: 'section' | 'row' | 'column' | 'field';
+        type: 'section' | 'row' | 'column' | 'field' | 'visualBlock';
         sectionIndex?: number;
         rowIndex?: number;
         columnIndex?: number;
         fieldName?: string;
+        itemId?: string;
     } | null;
     gapGlobal: number;
     setGapGlobal(val: number | string): void;
@@ -1380,6 +1484,7 @@ declare class LayoutEditorComponent implements OnInit {
      * Fields that are not yet placed in any section/column of the layout.
      */
     get availableFields(): FieldMetadata[];
+    t(key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
     get columnDropListIds(): string[];
     getColumnId(sectionIndex: number, rowIndex: number, columnIndex: number): string;
     private parseColumnId;
@@ -1390,10 +1495,25 @@ declare class LayoutEditorComponent implements OnInit {
     selectRow(sectionIndex: number, rowIndex: number): void;
     selectColumn(sectionIndex: number, rowIndex: number, columnIndex: number): void;
     dropField({ event }: FieldDropEvent): void;
+    private getColumnLayoutItemByIndex;
+    private getColumnTargetByIndex;
+    private getLayoutItemTargetByIndex;
     dropSection(event: CdkDragDrop<FormSection[]>): void;
     addSection(): void;
     removeSection(index: number): void;
     onSectionUpdated(index: number, updatedSection: FormSection): void;
+    addVisualBlockToColumn(event: AddVisualBlockEvent): void;
+    private createVisualBlockItemId;
+    addApiFieldToColumn(event: AddApiFieldEvent): void;
+    openVisualBlockEditor(event: {
+        sectionIndex: number;
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+    }): void;
+    moveVisualBlock(event: MoveVisualBlockEvent): void;
+    moveVisualBlockToColumn(event: MoveVisualBlockToColumnEvent): void;
+    removeVisualBlock(event: VisualBlockEvent): void;
     private emitNewConfig;
     onApplyStyleToAll(patch: Partial<FormSection>): void;
     trackBySection(index: number, s: FormSection & {
@@ -1406,15 +1526,17 @@ declare class LayoutEditorComponent implements OnInit {
 declare class RowConfiguratorComponent implements OnChanges {
     row: FormRow;
     fieldMetadata: FieldMetadata[];
+    availableFields: FieldMetadata[];
     sectionIndex: number;
     rowIndex: number;
     isLastRow: boolean;
     selected: {
-        type: 'section' | 'row' | 'column' | 'field';
+        type: 'section' | 'row' | 'column' | 'field' | 'visualBlock';
         sectionIndex?: number;
         rowIndex?: number;
         columnIndex?: number;
         fieldName?: string;
+        itemId?: string;
     } | null;
     availableFieldsListId: string | null;
     connectedDropListIds: string[];
@@ -1424,8 +1546,42 @@ declare class RowConfiguratorComponent implements OnChanges {
     remove: EventEmitter<void>;
     applyRowGapAll: EventEmitter<number>;
     fieldDrop: EventEmitter<CdkDragDrop<any, any, any>>;
+    addVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        presetId: VisualBlockPresetId;
+    }>;
+    addApiField: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        fieldName: string;
+    }>;
+    editVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+    }>;
+    moveVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+        direction: -1 | 1;
+    }>;
+    moveVisualBlockToColumn: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        targetColumnIndex: number;
+        itemId: string;
+    }>;
+    removeVisualBlock: EventEmitter<{
+        rowIndex: number;
+        columnIndex: number;
+        itemId: string;
+    }>;
     select: EventEmitter<any>;
     activeDropIndex: number | null;
+    protected readonly visualBlockPresets: readonly VisualBlockPreset[];
+    private readonly i18n;
     private hoverTimer;
     protected readonly breakpoints: Breakpoint[];
     previewBreakpoint: Breakpoint;
@@ -1438,7 +1594,21 @@ declare class RowConfiguratorComponent implements OnChanges {
     ngOnChanges(changes: SimpleChanges): void;
     private rebuildConnectedColumnsCache;
     getFieldByName(fieldName: string): FieldMetadata;
-    drop(event: CdkDragDrop<string[]>): void;
+    getColumnLayoutItems(column: FormColumn): FormLayoutItem[];
+    trackLayoutItem(_: number, item: FormLayoutItem): string;
+    hasColumnContent(column: FormColumn): boolean;
+    getVisualBlockLabel(item: FormLayoutItem): string;
+    private findRichContentLabel;
+    private findRichNodeLabel;
+    t(key: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    getFieldLabel(field: FieldMetadata): string;
+    selectVisualBlock(columnIndex: number, item: FormLayoutItem, event: Event): void;
+    openVisualBlockEditor(columnIndex: number, item: FormLayoutItem, event: Event): void;
+    moveVisualBlockItem(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: Event): void;
+    canMoveVisualBlockToColumn(columnIndex: number, direction: -1 | 1): boolean;
+    moveVisualBlockToAdjacentColumn(columnIndex: number, item: FormLayoutItem, direction: -1 | 1, event: Event): void;
+    removeVisualBlockItem(columnIndex: number, item: FormLayoutItem, event: Event): void;
+    drop(event: CdkDragDrop<FormLayoutItem[], FormLayoutItem[] | FieldMetadata[], FormLayoutItem | FieldMetadata>): void;
     selectRow(): void;
     openColumnConfig(index: number): void;
     selectColumn(index: number, event: MouseEvent): void;
@@ -1456,6 +1626,8 @@ declare class RowConfiguratorComponent implements OnChanges {
     removeRow(): void;
     moveColumn(index: number, direction: number): void;
     clearColumn(index: number): void;
+    addVisualBlockToColumn(index: number, presetId: VisualBlockPresetId): void;
+    addApiFieldToColumn(index: number, fieldName: string): void;
     addFieldToColumn(index: number): void;
     getColumnId(index: number): string;
     private generateId;
@@ -1479,7 +1651,7 @@ declare class RowConfiguratorComponent implements OnChanges {
     adjustOffset(columnIndex: number, delta: number): void;
     getSuggestedSpan(columnIndex: number): number | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<RowConfiguratorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RowConfiguratorComponent, "praxis-row-configurator", never, { "row": { "alias": "row"; "required": false; }; "fieldMetadata": { "alias": "fieldMetadata"; "required": false; }; "sectionIndex": { "alias": "sectionIndex"; "required": false; }; "rowIndex": { "alias": "rowIndex"; "required": false; }; "isLastRow": { "alias": "isLastRow"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "availableFieldsListId": { "alias": "availableFieldsListId"; "required": false; }; "connectedDropListIds": { "alias": "connectedDropListIds"; "required": false; }; "gapGlobal": { "alias": "gapGlobal"; "required": false; }; }, { "rowChange": "rowChange"; "remove": "remove"; "applyRowGapAll": "applyRowGapAll"; "fieldDrop": "fieldDrop"; "select": "select"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RowConfiguratorComponent, "praxis-row-configurator", never, { "row": { "alias": "row"; "required": false; }; "fieldMetadata": { "alias": "fieldMetadata"; "required": false; }; "availableFields": { "alias": "availableFields"; "required": false; }; "sectionIndex": { "alias": "sectionIndex"; "required": false; }; "rowIndex": { "alias": "rowIndex"; "required": false; }; "isLastRow": { "alias": "isLastRow"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "availableFieldsListId": { "alias": "availableFieldsListId"; "required": false; }; "connectedDropListIds": { "alias": "connectedDropListIds"; "required": false; }; "gapGlobal": { "alias": "gapGlobal"; "required": false; }; }, { "rowChange": "rowChange"; "remove": "remove"; "applyRowGapAll": "applyRowGapAll"; "fieldDrop": "fieldDrop"; "addVisualBlock": "addVisualBlock"; "addApiField": "addApiField"; "editVisualBlock": "editVisualBlock"; "moveVisualBlock": "moveVisualBlock"; "moveVisualBlockToColumn": "moveVisualBlockToColumn"; "removeVisualBlock": "removeVisualBlock"; "select": "select"; }, never, never, true, never>;
 }
 
 declare class FieldConfiguratorComponent {
@@ -1894,7 +2066,8 @@ declare enum FormRuleTargetType {
     Section = "section",
     Action = "action",
     Row = "row",
-    Column = "column"
+    Column = "column",
+    VisualBlock = "visualBlock"
 }
 declare enum FormRuleContext {
     Visibility = "visibility",
@@ -1990,7 +2163,7 @@ declare function getFormAiCatalog(formConfig?: FormConfig): AiCapabilityCatalog;
  * Manifesto de authoring canônico para o componente praxis-dynamic-form.
  * Este arquivo define as operações permitidas pela IA para editar formulários.
  *
- * @version 1.4.0
+ * @version 1.5.0
  * @status COMPLIANT - Alinhado com contrato v2, gate de aceitação e semântica local/schema-backed.
  */
 declare const PRAXIS_DYNAMIC_FORM_AUTHORING_MANIFEST: ComponentAuthoringManifest;

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "8.0.0-beta.11",
+  "version": "8.0.0-beta.13",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/cdk": "^20.0.0",
-    "@praxisui/rich-content": "^8.0.0-beta.11",
-    "@praxisui/settings-panel": "^8.0.0-beta.11",
-    "@praxisui/visual-builder": "^8.0.0-beta.11",
-    "@praxisui/core": "^8.0.0-beta.11",
-    "@praxisui/cron-builder": "^8.0.0-beta.11"
+    "@praxisui/rich-content": "^8.0.0-beta.13",
+    "@praxisui/settings-panel": "^8.0.0-beta.13",
+    "@praxisui/visual-builder": "^8.0.0-beta.13",
+    "@praxisui/core": "^8.0.0-beta.13",
+    "@praxisui/cron-builder": "^8.0.0-beta.13"
   },
   "dependencies": {
     "tslib": "^2.3.0",