@praxisui/dynamic-form 9.0.0-beta.1 → 9.0.0-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "9.0.0-beta.1",
+  "version": "9.0.0-beta.10",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.0-beta.1",
-    "@praxisui/dynamic-fields": "^9.0.0-beta.1",
-    "@praxisui/metadata-editor": "^9.0.0-beta.1",
-    "@praxisui/rich-content": "^9.0.0-beta.1",
-    "@praxisui/settings-panel": "^9.0.0-beta.1",
-    "@praxisui/visual-builder": "^9.0.0-beta.1",
-    "@praxisui/core": "^9.0.0-beta.1",
+    "@praxisui/ai": "^9.0.0-beta.10",
+    "@praxisui/dynamic-fields": "^9.0.0-beta.10",
+    "@praxisui/metadata-editor": "^9.0.0-beta.10",
+    "@praxisui/rich-content": "^9.0.0-beta.10",
+    "@praxisui/settings-panel": "^9.0.0-beta.10",
+    "@praxisui/visual-builder": "^9.0.0-beta.10",
+    "@praxisui/core": "^9.0.0-beta.10",
     "rxjs": "^7.8.0"
   },
   "dependencies": {
@@ -26,14 +26,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/codexrodrigues/praxis-ui-angular"
-  },
-  "homepage": "https://praxisui.dev",
-  "bugs": {
-    "url": "https://github.com/codexrodrigues/praxis-ui-angular/issues"
-  },
+  "homepage": "https://praxisui.dev/components/dynamic-form",
   "keywords": [
     "angular",
     "praxisui",

package/src/lib/config-editor/praxis-dynamic-form-config-editor.json-api.md

@@ -58,7 +58,9 @@ Este documento e a referencia canonica da API JSON de praxis-dynamic-form-config
 - O editor visual e o editor JSON operam sobre `DynamicFormAuthoringDocument`.
 - O editor JSON aceita apenas o envelope canônico; payloads legados pertencem aos caminhos de compatibilidade do runtime.
 - `Apply` e `Save` emitem um snapshot canonico completo com semantica `replace-all`.
-- Em comandos condicionais, o editor visual autora `globalAction.payload` estruturado; `globalAction.payloadExpr` fica reservado ao JSON avancado e e preservado no round-trip quando nenhum payload estruturado e definido.
+- Em comandos condicionais, o editor visual autora o efeito primario `effects[0].globalAction.payload` estruturado; `globalAction.payloadExpr` fica reservado ao JSON avancado e e preservado no round-trip quando nenhum payload estruturado e definido.
+- Regras com multiplos `effects` continuam JSON-avancadas para autoria completa; ao editar o efeito primario pela UI, efeitos secundarios existentes sao preservados para evitar perda silenciosa.
+- Em `formCommandRules[].policy`, o editor visual autora os campos comuns `distinct`, `distinctBy` e `runOnInitialEvaluation`; campos avancados vindos do JSON, como `trigger`, `debounceMs`, `errorPolicy` e `missingValuePolicy`, sao preservados no preview/apply, mas nao sao expostos como controles visuais completos.
 - `config`, `bindings` e `contextSnapshot` substituem integralmente o estado autoral anterior.
 - Ausencia de `bindings.mode` limpa o binding persistido e restaura o modo default efetivo do host.
 - Ausencia de `contextSnapshot.backConfig`, `contextSnapshot.presentation` ou `contextSnapshot.schemaPrefs` significa remocao explicita do bloco ausente.

package/src/lib/layout-editor/praxis-layout-editor.json-api.md

@@ -277,7 +277,7 @@ Extensoes de runtime no editor (fora do contrato canonico):
   - A ação "Campos da API" reinsere apenas campos já existentes em `fieldMetadata[]`; ela grava `kind: 'field'` em `items[]` e atualiza `fields[]` somente como projeção derivada.
   - Estado colapsado da palette é persistido em `LayoutPrefsService`.
 - Blocos visuais:
-  - A ação "Adicionar bloco visual" oferece presets de authoring internos para texto, aviso, separador, card informativo, `callout`, `keyValueList`, `recordSummary`, `disclosure` e `emptyState`.
+  - A ação "Adicionar bloco visual" oferece presets de authoring internos para texto, aviso, separador, card informativo, `callout`, `keyValueList`, prova de contrato, `recordSummary`, `disclosure` e `emptyState`.
   - Cada preset gera `RichContentDocument` válido em item `kind: 'richContent'`; presets não criam novo `kind`, não escrevem em `fieldMetadata[]` e não entram no payload de submit.
   - Presets como `emptyState` já podem semear `actionButton`, e o runtime do formulário encaminha essas ações pela mesma trilha de `customAction/globalAction` usada pelos demais CTAs do componente.
   - O guia didático completo está em `projects/praxis-dynamic-form/docs/layout-items-visual-blocks.md`.

package/types/praxisui-dynamic-form.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, FormLayoutItem, FormActionButton, AiCapability, BackConfig, RichBlockHostCapabilities, 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, JsonLogicExpression, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, GlobalActionField, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, IconPickerService, GlobalActionRef, SurfaceOpenPayload, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
+import { AsyncConfigStorage, FormLayout, FieldMetadata, FormLayoutRule, FormRuleTargetType as FormRuleTargetType$1, PraxisJsonLogicService, FormSection, FormRow, FormColumn, FormConfig, FormLayoutItem, FormActionButton, AiCapability, BackConfig, RichBlockHostCapabilities, 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, JsonLogicExpression, GlobalActionCatalogEntry, PraxisRuntimeConditionalEffectRule, PraxisRuntimeGlobalActionEffect, SurfaceOpenPayload, GlobalActionField, PraxisEffectPolicy, FieldDefinition, ComponentDocMeta, Breakpoint, DomainRuleRequestOptions, DomainRuleService, DomainRuleMaterialization, IconPickerService, GlobalActionRef, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { SettingsPanelService, SettingsValueProvider } from '@praxisui/settings-panel';
@@ -1393,6 +1393,7 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     diagnostics: EditorDiagnostic[];
     private destroy$;
     private jsonTextChanges$;
+    private readonly i18n;
     constructor(cdr: ChangeDetectorRef, configService: FormConfigService);
     ngOnInit(): void;
     ngOnDestroy(): void;
@@ -1412,6 +1413,9 @@ declare class JsonConfigEditorComponent implements OnInit, OnDestroy {
     private updateValidationState;
     insertHooksTemplate(): void;
     enableReactiveValidation(): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    private resolveI18n;
+    private interpolateFallback;
     static ɵfac: i0.ɵɵFactoryDeclaration<JsonConfigEditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<JsonConfigEditorComponent, "form-json-config-editor", never, { "config": { "alias": "config"; "required": false; }; "document": { "alias": "document"; "required": false; }; }, { "configChange": "configChange"; "documentChange": "documentChange"; "validationChange": "validationChange"; "editorEvent": "editorEvent"; }, never, never, true, never>;
 }
@@ -1448,6 +1452,12 @@ interface FormRuleDiagnostics {
     runtimeOnlyReason?: string;
 }
 
+type ConfigEditorTabKey = 'general' | 'schema' | 'layout' | 'hooks' | 'presentation' | 'behavior' | 'hints' | 'actions' | 'rules' | 'cascades' | 'messages' | 'navigation' | 'json';
+interface ConfigEditorTabOption {
+    key: ConfigEditorTabKey;
+    index: number;
+    label: string;
+}
 interface CommandRulePreviewModel {
     state: 'ready' | 'invalid';
     executionMode: 'preview-only';
@@ -1456,11 +1466,11 @@ interface CommandRulePreviewModel {
     payload?: unknown;
     payloadExpr?: string;
     policy: {
-        trigger: 'on-condition-enter';
+        trigger: NonNullable<PraxisEffectPolicy['trigger']>;
         distinct: boolean;
         distinctBy?: string;
         runOnInitialEvaluation?: boolean;
-    };
+    } & Omit<PraxisEffectPolicy, 'trigger' | 'distinct' | 'distinctBy' | 'runOnInitialEvaluation'>;
     diagnostics: string[];
 }
 declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, OnInit, OnDestroy {
@@ -1473,6 +1483,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     ruleBuilderConfig: RuleBuilderConfig;
     ruleBuilderState?: RuleBuilderState;
     currentRules: FormLayoutRule[];
+    selectedConfigTabIndex: number;
     selectedCommandRuleId: string;
     commandRuleCondition: JsonLogicExpression | null;
     commandRuleConditionJson: string;
@@ -1482,6 +1493,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     commandRuleDistinct: boolean;
     commandRuleDistinctBy: string;
     commandRuleRunOnInitialEvaluation: boolean;
+    private commandRulePolicyTrigger;
+    private commandRuleAdvancedPolicy;
     commandRuleAuthoringError: string | null;
     commandRulePayloadFieldErrors: Record<string, string>;
     ruleDiagnostics: FormRuleDiagnostics[];
@@ -1507,10 +1520,10 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private readonly editorMode;
     isPresentationMode: boolean;
     truncatePreview: boolean;
-    previewItems: {
+    previewItems: Array<{
         label: string;
         value: string;
-    }[];
+    }>;
     presentationPrefs: {
         labelPosition: 'above' | 'left';
         labelFontSize?: number | null;
@@ -1538,13 +1551,19 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private hasProcessedInitialRuleState;
     private jsonEditorIsValid;
     private globalActionValidationIssues;
+    private readonly i18n;
     readonly globalActionCatalog: GlobalActionCatalogEntry[];
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
     private lastRulesSignature;
+    private pendingRulePropertiesStateSignature;
     private readonly DEBUG;
     private debugLog;
+    get configTabOptions(): ConfigEditorTabOption[];
+    configTabLabel(key: ConfigEditorTabKey): string;
+    private buildPresentationPreviewItems;
+    getConfigTabIndex(key: ConfigEditorTabKey): number;
     constructor(storage: AsyncConfigStorage, configService: FormConfigService, settingsPanel: SettingsPanelService, cdr: ChangeDetectorRef, globalActionCatalogSource?: ReadonlyArray<GlobalActionCatalogEntry[]>, injectedData?: any);
     ngOnInit(): void;
     reset(): void;
@@ -1571,6 +1590,7 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     applyCommandRule(): void;
     deleteCommandRule(): void;
     get commandRuleActionSchema(): _praxisui_core.GlobalActionUiSchema | undefined;
+    get commandRuleSurfaceOpenPayload(): SurfaceOpenPayload;
     shouldShowCommandActionField(field: GlobalActionField): boolean;
     isCommandActionFieldRequired(field: GlobalActionField): boolean;
     isCommandActionFieldMissing(field: GlobalActionField): boolean;
@@ -1579,12 +1599,15 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     get commandRulePreview(): CommandRulePreviewModel;
     getCommandActionFieldValue(field: GlobalActionField): any;
     onCommandActionFieldChange(field: GlobalActionField, value: any): void;
+    onCommandSurfaceOpenPayloadChange(payload: SurfaceOpenPayload): void;
     private initializeCommandRuleEditor;
     private loadCommandRuleEditor;
+    private buildCommandRulePolicy;
     private updateCommandRules;
     private parseCommandRuleCondition;
     private parseOptionalJson;
     private parseCommandPayloadObject;
+    private getCommandRuleErrorMessage;
     private collectCommandActionFieldValues;
     private setCommandActionFieldError;
     private clearCommandActionFieldError;
@@ -1596,6 +1619,8 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     getRuleStatusTone(diagnostic: FormRuleDiagnostics): 'ok' | 'warn' | 'error';
     canAcceptPendingLlmRule(diagnostic: FormRuleDiagnostics): boolean;
     canApplyRulePropertyFix(diagnostic: FormRuleDiagnostics): boolean;
+    canOpenRuleJsonReview(diagnostic: FormRuleDiagnostics): boolean;
+    openRuleJsonReview(ruleId: string): void;
     applyRulePropertyFix(ruleId: string): void;
     acceptPendingLlmRule(ruleId: string): void;
     getRuleDiagnosticDetails(diagnostic: FormRuleDiagnostics): string[];
@@ -1641,6 +1666,9 @@ declare class PraxisDynamicFormConfigEditor implements SettingsValueProvider, On
     private toPresentationSnapshot;
     private toSchemaPrefsSnapshot;
     private toBackConfigSnapshot;
+    tx(key: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    private resolveI18n;
+    private interpolateFallback;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisDynamicFormConfigEditor, [null, null, null, null, { optional: true; }, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisDynamicFormConfigEditor, "praxis-dynamic-form-config-editor", never, {}, {}, never, never, true, never>;
 }
@@ -1748,7 +1776,7 @@ declare class LayoutPrefsService {
     static ɵprov: i0.ɵɵInjectableDeclaration<LayoutPrefsService>;
 }
 
-type VisualBlockPresetId = 'text' | 'notice' | 'divider' | 'infoCard' | 'callout' | 'keyValueList' | 'recordSummary' | 'lookupCard' | 'disclosure' | 'emptyState';
+type VisualBlockPresetId = 'text' | 'notice' | 'divider' | 'infoCard' | 'callout' | 'keyValueList' | 'contractProof' | 'recordSummary' | 'lookupCard' | 'disclosure' | 'emptyState';
 interface VisualBlockPreset {
     id: VisualBlockPresetId;
     labelKey: string;
@@ -1953,6 +1981,7 @@ declare class RowConfiguratorComponent implements OnChanges {
     activeDropIndex: number | null;
     protected readonly visualBlockPresets: readonly VisualBlockPreset[];
     private readonly i18n;
+    private readonly dialog;
     private hoverTimer;
     protected readonly breakpoints: Breakpoint[];
     previewBreakpoint: Breakpoint;
@@ -2171,6 +2200,7 @@ declare class CanvasToolbarComponent {
     /** Estado interno para animar o fechamento. */
     closing: boolean;
     private readonly closeAnimMs;
+    private readonly i18n;
     toggleReadonly: EventEmitter<void>;
     toggleRequired: EventEmitter<void>;
     toggleHidden: EventEmitter<void>;
@@ -2188,6 +2218,7 @@ declare class CanvasToolbarComponent {
     onGlobalKeydown(ev: KeyboardEvent): void;
     /** Inicia animação de saída e emite o evento ao final. */
     triggerClose(): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number>): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CanvasToolbarComponent, never>;
     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>;
 }
@@ -2345,6 +2376,7 @@ declare class RowEditorComponent implements OnInit, OnDestroy, SettingsValueProv
     isBusy$: BehaviorSubject<boolean>;
     private destroy$;
     private initialValueSig;
+    private readonly i18n;
     constructor(fb: FormBuilder, data: {
         row: EditableFormRow;
     });
@@ -2353,10 +2385,12 @@ declare class RowEditorComponent implements OnInit, OnDestroy, SettingsValueProv
     getSettingsValue(): any;
     displayValue(value: number | null | undefined, fallback: string): string | number;
     displayPxValue(value: number | null | undefined): string;
+    visibilityStateLabel(bp: Breakpoint): string;
     private setColumns;
     applyPreset(preset: 'full' | 'half' | 'thirds' | 'thirdTwoThird' | 'twoThirdThird' | 'autoBalance'): void;
     private resolveHiddenMode;
     setHiddenMode(mode: 'none' | 'mobile' | 'desktop'): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number>): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<RowEditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RowEditorComponent, "praxis-row-editor", never, {}, {}, never, never, true, never>;
 }
@@ -2373,6 +2407,7 @@ declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueP
     isBusy$: BehaviorSubject<boolean>;
     private destroy$;
     private _previewTimer;
+    private readonly i18n;
     constructor(fb: FormBuilder, data: {
         column: FormColumn;
     });
@@ -2396,6 +2431,7 @@ declare class ColumnEditorComponent implements OnInit, OnDestroy, SettingsValueP
     resetResponsive(): void;
     applyPreset(key: 'full' | 'half' | 'third' | 'twoThird' | 'centered' | 'narrowSidebar' | 'wideContent' | 'stackMobile' | 'hideMobile' | 'desktopOnly'): void;
     toggleHiddenBp(bp: Breakpoint): void;
+    tx(key: string, fallback: string, params?: Record<string, string | number>): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ColumnEditorComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ColumnEditorComponent, "praxis-column-editor", never, {}, {}, never, never, true, never>;
 }