@praxisui/dynamic-form 3.0.0-beta.7 → 3.0.0-beta.9

package/index.d.ts

@@ -5,7 +5,8 @@ import { Router, ActivatedRoute } from '@angular/router';
 import { MatDialog } from '@angular/material/dialog';
 import { MatSnackBar } from '@angular/material/snack-bar';
 import { CdkDragStart, CdkDragMove, CdkDragEnd, CdkDragDrop } from '@angular/cdk/drag-drop';
-import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, BackConfig, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, WidgetDefinition, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, FieldDefinition, Breakpoint, ComponentDocMeta, IconPickerService, PraxisI18nService, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
+import * as _praxisui_core from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, FormSection, FormRow, FormColumn, FormConfig, FormActionButton, BackConfig, FormHooksLayout, EndpointConfig, FormSubmitEvent, FormReadyEvent, FormValueChangeEvent, SyncResult, FormInitializationError, LoadingState, FormCustomActionEvent, FormActionConfirmationEvent, WidgetEventEnvelope, WidgetDefinition, GenericCrudService, ConnectionStorage, DynamicFormService, ErrorMessageService, SchemaNormalizerService, ComponentMetadataRegistry, GlobalConfigService, ComponentKeyService, LoadingOrchestrator, PraxisLoadingRenderer, FormHooksRegistry, FormHookPreset, LoggerService, FormSectionHeaderAction, FormSectionHeaderConfig, FormConfigState, FieldDefinition, ComponentDocMeta, Breakpoint, IconPickerService, SurfaceOpenPayload, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -53,6 +54,7 @@ interface RuleApplicationResult {
     columnProps: Record<string, Record<string, any>>;
 }
 declare class FormRulesService {
+    private normalizeLegacyConditionSyntax;
     /**
      * Evaluates a set of form rules against the current value of a FormGroup.
      *
@@ -491,6 +493,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hooksRegistry?;
     private hookPresets?;
     private logger?;
+    private readonly i18n;
     private readonly DEBUG;
     resourcePath?: string;
     resourceId?: string | number;
@@ -503,26 +506,26 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     mode: 'create' | 'edit' | 'view';
     config: FormConfig;
     /**
-     * Fonte de schema para construir o formulário.
-     * 'resource' (padrão) usa o schema do recurso (/{resource}/schemas -> .../all response)
+     * Fonte de schema para construir o formulário.
+     * 'resource' (padrão) usa o schema do recurso (/{resource}/schemas -> .../all response)
      * 'filter' usa o schema do DTO de filtro (via /schemas/filtered no POST /filter request)
      */
     schemaSource: 'resource' | 'filter';
     /**
-     * CUSTOMIZAÇÃO DE LAYOUT - NÃO confundir com edição de dados do formulário
+     * CUSTOMIZAÇÃO DE LAYOUT - NÃO confundir com edição de dados do formulário
      *
-     * Este flag controla se o usuário pode customizar a ESTRUTURA do formulário:
+     * Este flag controla se o usuário pode customizar a ESTRUTURA do formulário:
      * - Mover sections, rows, columns
-     * - Configurar layout e aparência
-     * - Acessar editor de configuração
+     * - Configurar layout e aparência
+     * - Acessar editor de configuração
      *
-     * É INDEPENDENTE do mode (view/edit/create) que controla os DADOS do registro
+     * É INDEPENDENTE do mode (view/edit/create) que controla os DADOS do registro
      *
      * @example
-     * // Formulário em modo VIEW de dados + customização HABILITADA
+     * // Formulário em modo VIEW de dados + customização HABILITADA
      * <praxis-dynamic-form mode="view" [enableCustomization]="true">
      *
-     * // Formulário em modo EDIT de dados + customização DESABILITADA
+     * // Formulário em modo EDIT de dados + customização DESABILITADA
      * <praxis-dynamic-form mode="edit" [enableCustomization]="false">
      */
     enableCustomization: boolean;
@@ -581,11 +584,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     /** Forwarded from DynamicFieldLoader to allow host-side observability. */
     fieldRenderError: EventEmitter<DynamicFieldRenderErrorEvent>;
     /** Re-emits events from editorial widgets hosted before, before actions, or after the form. */
-    widgetEvent: EventEmitter<{
+    widgetEvent: EventEmitter<WidgetEventEnvelope & {
         placement: "before" | "beforeActions" | "after";
-        sourceId: string;
-        output?: string;
-        payload?: any;
     }>;
     isLoading: boolean;
     submitting: boolean;
@@ -641,11 +641,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
      * In-place mutations do not invalidate the cached merged context snapshot.
      */
     getEditorialWidgetContext(): Record<string, unknown>;
-    onEditorialWidgetEvent(placement: 'before' | 'beforeActions' | 'after', event: {
-        sourceId: string;
-        output?: string;
-        payload?: any;
-    }): void;
+    onEditorialWidgetEvent(placement: 'before' | 'beforeActions' | 'after', event: WidgetEventEnvelope): void;
     private reactiveValidate$?;
     private warnedMissingId;
     private schemaState;
@@ -685,6 +681,7 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private hasMountedAnimation;
     private mountAnimationTimer;
     protected isMounting: boolean;
+    private hasBuiltFormFromConfig;
     constructor(crud: GenericCrudService<any>, fb: FormBuilder, cdr: ChangeDetectorRef, layoutService: FormLayoutService, contextService: FormContextService, rulesService: FormRulesService, settingsPanel: SettingsPanelService, dialog: MatDialog, asyncConfigStorage: AsyncConfigStorage, connectionStorage: ConnectionStorage, dynamicForm: DynamicFormService, snackBar: MatSnackBar, canvasState: CanvasStateService, dynamicLayout: DynamicFormLayoutService, errorMessages: ErrorMessageService, schemaNormalizer: SchemaNormalizerService, componentMetaRegistry: ComponentMetadataRegistry, global: GlobalConfigService, componentKeys: ComponentKeyService, loadingOrchestrator: LoadingOrchestrator, loadingRenderer?: PraxisLoadingRenderer | undefined, router?: Router | undefined, route?: ActivatedRoute | undefined, hooksRegistry?: FormHooksRegistry | undefined, hookPresets?: FormHookPreset[] | null | undefined, logger?: LoggerService | undefined);
     private emitLoadingState;
     private buildLoadingContext;
@@ -701,6 +698,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private formInputsKey;
     private crudBackKey;
     private tryInitializeForm;
+    private hasRenderableConfig;
+    private initializeStandaloneConfig;
     private reloadForModeChange;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -813,13 +812,13 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private navigateAfterSave;
     private shouldConfirmCancelOnDirty;
     /**
-     * TOGGLE DE CUSTOMIZAÇÃO DE LAYOUT - NÃO É EDIÇÃO DE DADOS
+     * TOGGLE DE CUSTOMIZAÇÃO DE LAYOUT - NÃO É EDIÇÃO DE DADOS
      *
-     * Este método alterna entre:
-     * - Modo normal: Usuário interage com dados do formulário (conforme mode: view/edit/create)
-     * - Modo customização: Usuário pode mover sections/rows/columns e configurar layout
+     * Este método alterna entre:
+     * - Modo normal: Usuário interage com dados do formulário (conforme mode: view/edit/create)
+     * - Modo customização: Usuário pode mover sections/rows/columns e configurar layout
      *
-     * IMPORTANTE: Independe completamente do mode do formulário
+     * IMPORTANTE: Independe completamente do mode do formulário
      */
     toggleEditMode(): void;
     openConfigEditor(): Promise<void>;
@@ -867,10 +866,11 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private openRowEditor;
     private openColumnEditor;
     openSectionEditor(section: any, focusTarget?: 'title' | 'description'): void;
+    private resolveControlTypeEditorial;
     private getControlTypeIcon;
     /**
-     * Friendly control type name resolved from ComponentMetadataRegistry when available.
-     * Falls back to a local map only when there is no registered metadata.
+     * Friendly control type name resolved from the canonical editorial resolver when available.
+     * Falls back only to neutral technical defaults when nothing can be resolved.
      */
     private getControlTypeName;
     private applyNullDeletionPatch;
@@ -1171,6 +1171,7 @@ declare class PraxisFilterForm implements OnChanges, OnDestroy {
     private buildForm;
     onFormSubmit(): void;
     getColumnFields(column: FormColumn): FieldMetadata[];
+    get fieldMetadata(): FieldMetadata[];
     get hasLayout(): boolean;
     trackBySection(i: number, section: FormSection): string;
     trackByRow(i: number, _row: FormRow): string;
@@ -1179,6 +1180,11 @@ declare class PraxisFilterForm implements OnChanges, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisFilterForm, "praxis-filter-form", never, { "config": { "alias": "config"; "required": true; }; "formId": { "alias": "formId"; "required": false; }; "resourcePath": { "alias": "resourcePath"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; }, { "formReady": "formReady"; "valueChange": "valueChange"; "submit": "submit"; "requestSearch": "requestSearch"; "validityChange": "validityChange"; }, never, never, true, never>;
 }
 
+/** Metadata for PraxisFilterForm component */
+declare const PRAXIS_FILTER_FORM_COMPONENT_METADATA: ComponentDocMeta;
+/** Provider to register PraxisFilterForm metadata. */
+declare function providePraxisFilterFormMetadata(): Provider;
+
 /** Tokens for theme colors used across the layout editor. */
 declare enum LayoutColorToken {
     Surface = "--md-sys-color-surface",
@@ -1352,10 +1358,8 @@ declare class RowConfiguratorComponent implements OnChanges {
 declare class FieldConfiguratorComponent {
     private readonly registry;
     field: FieldMetadata;
-    private readonly controlTypeMap;
     private readonly categoryByType;
-    private readonly fallbackInfo;
-    get meta(): ComponentDocMeta | undefined;
+    private resolveEditorialMeta;
     get icon(): string;
     get typeClass(): string;
     get typeSpecificClass(): string;
@@ -1458,6 +1462,19 @@ declare class CanvasToolbarComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<CanvasToolbarComponent, "praxis-canvas-toolbar", never, { "selectedElement": { "alias": "selectedElement"; "required": false; }; }, { "editMetadata": "editMetadata"; "delete": "delete"; "moveUp": "moveUp"; "moveDown": "moveDown"; "selectPath": "selectPath"; "requestClose": "requestClose"; "toggleReadonly": "toggleReadonly"; "toggleRequired": "toggleRequired"; "toggleHidden": "toggleHidden"; "toggleDisabled": "toggleDisabled"; }, never, never, true, never>;
 }
 
+type ActionCatalogOption = {
+    id: string;
+    label: string;
+    description?: string;
+    param?: {
+        required?: boolean;
+        label?: string;
+        placeholder?: string;
+        hint?: string;
+        example?: string;
+    };
+};
+
 interface EditableFormSection extends FormSection {
     sectionHeader?: FormSectionHeaderConfig;
     appearance?: 'card' | 'plain' | 'step';
@@ -1488,7 +1505,6 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     private fb;
     private data;
     private iconPicker;
-    private i18n;
     focusTarget?: 'title' | 'description';
     fieldMetadata: FieldMetadata[];
     section: EditableFormSection;
@@ -1501,19 +1517,42 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
+    private readonly globalActionCatalogSource;
+    private readonly i18n;
+    readonly legacyActionSpecs: _praxisui_core.GlobalActionSpec[];
+    readonly globalActionCatalog: ActionCatalogOption[];
+    readonly customActionValue = "__custom__";
     private destroy$;
     titleInput?: ElementRef<HTMLInputElement>;
     descriptionInput?: ElementRef<HTMLTextAreaElement>;
     constructor(fb: FormBuilder, data: {
         section: EditableFormSection;
         fieldMetadata?: FieldMetadata[];
-    }, iconPicker: IconPickerService, i18n: PraxisI18nService);
+    }, iconPicker: IconPickerService);
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     getSettingsValue(): any;
     get headerActionsArray(): FormArray;
     getHeaderActionStylePlaceholder(): string;
+    getActionCatalogLabel(spec: {
+        label?: string;
+    }): string;
+    getHeaderActionSpecById(id: string): ActionCatalogOption | undefined;
+    getHeaderActionSelectValue(value?: string): string;
+    getHeaderActionParam(value?: string): string;
+    getHeaderActionCustomValue(value?: string): string;
+    getHeaderGlobalActionSchema(value?: string): _praxisui_core.GlobalActionUiSchema | undefined;
+    getHeaderSurfaceOpenActionPayload(value?: string): SurfaceOpenPayload;
+    isHeaderActionParamMissing(value?: string): boolean;
+    onHeaderActionSelectChange(index: number, value: string): void;
+    onHeaderActionParamChange(index: number, value: string): void;
+    onHeaderActionCustomChange(index: number, value: string): void;
+    pickHeaderActionIcon(index: number): Promise<void>;
+    clearHeaderActionIcon(index: number): void;
+    applyHeaderActionStylePreset(index: number, preset: 'default' | 'soft-pill' | 'primary-pill' | 'critical-pill'): void;
+    getHeaderActionPreviewStyles(index: number): Record<string, any> | null;
+    onHeaderSurfaceOpenActionPayloadChange(index: number, payload: SurfaceOpenPayload): void;
     pickIcon(): Promise<void>;
     clearIcon(): void;
     pickFallbackIcon(): Promise<void>;
@@ -1537,6 +1576,8 @@ declare class SectionEditorComponent implements OnInit, AfterViewInit, OnDestroy
     private createHeaderActionGroup;
     private moveHeaderAction;
     private normalizeHeaderActions;
+    private mapCatalogEntryToActionSpec;
+    private getActionCatalogDescription;
     private headerActionStyleValidator;
     private stringifyHeaderActionStyle;
     private parseHeaderActionStyle;
@@ -1817,5 +1858,5 @@ declare const FORM_COMPONENT_AI_CAPABILITIES: CapabilityCatalog;
  */
 declare function getFormAiCatalog(formConfig?: FormConfig): AiCapabilityCatalog;
 
-export { ActionsEditorComponent, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DynamicFormLayoutService, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisFilterForm, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildDynamicFormApplyPlan, createDynamicFormAuthoringDocument, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, normalizeDateArrays, normalizeDynamicFormAuthoringDocument, parseLegacyOrDynamicFormDocument, providePraxisDynamicFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, serializeDynamicFormAuthoringDocument, stripLegacyFieldMetadata, toCanonicalDynamicFormConfig, validateDynamicFormAuthoringDocument, validateDynamicFormAuthoringInput };
+export { ActionsEditorComponent, CanvasStateService, CanvasToolbarComponent, ColumnEditorComponent, DynamicFormLayoutService, FORM_AI_CAPABILITIES, FORM_COMPONENT_AI_CAPABILITIES, FieldConfiguratorComponent, FieldEditorComponent, FormConfigService, FormContextService, FormLayoutService, JsonConfigEditorComponent, LayoutColorToken, LayoutEditorComponent, LayoutPrefsService, PRAXIS_DYNAMIC_FORM_COMPONENT_METADATA, PRAXIS_FILTER_FORM_COMPONENT_METADATA, PraxisDynamicForm, PraxisDynamicFormConfigEditor, PraxisFilterForm, PraxisFormActionsComponent, RowConfiguratorComponent, RowEditorComponent, SETTINGS_PANEL_DYNAMIC_FORM_PROVIDER, SectionEditorComponent, TASK_PRESETS, applyVisibilityRules, buildDynamicFormApplyPlan, createDynamicFormAuthoringDocument, formLayoutRulesToBuilderState, getFormAiCatalog, getFormCapabilities, getFormEnum, isRuleSatisfied, normalizeDateArrays, normalizeDynamicFormAuthoringDocument, parseLegacyOrDynamicFormDocument, providePraxisDynamicFormMetadata, providePraxisFilterFormMetadata, provideSettingsPanelDynamicForm, ruleBuilderStateToFormLayoutRules, serializeDynamicFormAuthoringDocument, stripLegacyFieldMetadata, toCanonicalDynamicFormConfig, validateDynamicFormAuthoringDocument, validateDynamicFormAuthoringInput };
 export type { CanvasElement, CanvasElementType, CanvasPathPart, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, DynamicFieldRenderErrorEvent, DynamicFormApplyPlan, DynamicFormAuthoringDocument, DynamicFormBindings, DynamicFormContextSnapshot, DynamicFormMode, DynamicFormPresentationSnapshot, DynamicFormProjectionContext, DynamicFormRuntimeContext, DynamicFormSchemaPrefsSnapshot, DynamicFormValidationContext, EditorDiagnostic, EditorDocument, FieldPath, FieldPathContainer, FieldPathWithIndex, Capability as FormComponentCapability, CapabilityCatalog as FormComponentCapabilityCatalog, CapabilityCategory as FormComponentCapabilityCategory, ValueKind as FormComponentValueKind, FormConfigLike, IdPath, JsonEditorEvent, JsonValidationResult, LayoutChange, LayoutResult, Operation, Path, PathWithIndex, PraxisFormActionEvent, RemovePolicy, ValidationReport, ValueKind$1 as ValueKind };

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "3.0.0-beta.7",
+  "version": "3.0.0-beta.9",
   "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/settings-panel": "^3.0.0-beta.7",
-    "@praxisui/visual-builder": "^3.0.0-beta.7",
-    "@praxisui/specification-core": "^3.0.0-beta.7",
-    "@praxisui/specification": "^3.0.0-beta.7",
-    "@praxisui/core": "^3.0.0-beta.7",
-    "@praxisui/cron-builder": "^3.0.0-beta.7"
+    "@praxisui/settings-panel": "^3.0.0-beta.9",
+    "@praxisui/visual-builder": "^3.0.0-beta.9",
+    "@praxisui/specification-core": "^3.0.0-beta.9",
+    "@praxisui/specification": "^3.0.0-beta.9",
+    "@praxisui/core": "^3.0.0-beta.9",
+    "@praxisui/cron-builder": "^3.0.0-beta.9"
   },
   "dependencies": {
     "tslib": "^2.3.0",