@praxisui/metadata-editor 10.0.0-rc.37 → 10.0.0-rc.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/metadata-editor",
-  "version": "10.0.0-rc.37",
+  "version": "10.0.0-rc.39",
   "description": "Metadata editor for Praxis UI fields and components with runtime integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -8,10 +8,10 @@
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.37",
-    "@praxisui/core": "^10.0.0-rc.37",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.37",
-    "@praxisui/settings-panel": "^10.0.0-rc.37",
+    "@praxisui/ai": "^10.0.0-rc.39",
+    "@praxisui/core": "^10.0.0-rc.39",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.39",
+    "@praxisui/settings-panel": "^10.0.0-rc.39",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-metadata-editor.d.ts

@@ -160,6 +160,7 @@ declare class FieldMetadataEditorComponent implements OnInit {
     renderedProps: any[];
     private initialSnapshot;
     private initialControlType?;
+    private initialSeed?;
     private baselineReady;
     private readonly formRebuild$;
     private readonly hostApplyPatch?;
@@ -227,6 +228,10 @@ declare class FieldMetadataEditorComponent implements OnInit {
     reset(): void;
     onControlTypeChange(next: FieldControlType): void;
     onControlTypeChangeEvent(event: Event): void;
+    tx(key: string, fallback: string): string;
+    private buildCurrentSemanticFieldSnapshot;
+    canCalibrateFromSemantics(): boolean;
+    calibrateFromSemantics(): void;
     private withSharedFieldMetadataProperties;
     get isArrayEditor(): boolean;
     private static readonly ROOT_DEPENDENT_FIELD_KEY_PROPS;
@@ -293,13 +298,37 @@ interface CascadeRuleViewModel {
     dependencyDebounceMs?: number | null;
     dependencyLoadOnChange?: 'respectLoadOn' | 'immediate' | 'manual';
 }
+interface CascadeCycleDiagnostic {
+    /** Ordered field names in the cycle, starting and ending with the same field (e.g. ['cargoId', 'departamentoId', 'cargoId']). */
+    path: string[];
+    /** Human-readable path with labels and field names (e.g. "Cargo (cargoId) → Departamento (departamentoId) → Cargo (cargoId)"). */
+    formattedPath: string;
+    /** True when a field directly references itself in dependencyFields. */
+    isSelfReference: boolean;
+    /** Actionable remediation message in analyst language. */
+    message: string;
+}
+interface CascadeGraphValidationResult {
+    valid: boolean;
+    cycles: CascadeCycleDiagnostic[];
+    fieldsInCycles: Set<string>;
+}
 declare class CascadeRulesService {
     getFieldLabelMap(fields: Array<FieldDefinition | FieldMetadata>): Map<string, string>;
     hydrateRule(field: FieldDefinition | FieldMetadata): CascadeRuleViewModel | null;
     dehydratePatch(rule: CascadeRuleViewModel): Partial<FieldDefinition>;
     clearPatch(): Partial<FieldDefinition>;
-    /** Suggest a basic mapping dep->dep and a default valuePath */
+    /** Fill missing mappings and value paths without replacing authored values. */
     suggest(rule: CascadeRuleViewModel, inferredValueKey?: string): CascadeRuleViewModel;
+    /**
+     * Validates the cascade dependency graph directly from an array of FieldMetadata/FieldDefinition.
+     */
+    validateFieldsCascadeGraph(fields: ReadonlyArray<FieldDefinition | FieldMetadata>): CascadeGraphValidationResult;
+    /**
+     * Detects self-references, direct cycles (A -> B -> A) and indirect cycles (A -> B -> C -> A),
+     * including graphs where fields have multiple parent dependencies.
+     */
+    validateCascadeGraph(rules: ReadonlyMap<string, CascadeRuleViewModel> | Record<string, CascadeRuleViewModel>, fields?: ReadonlyArray<FieldDefinition | FieldMetadata>): CascadeGraphValidationResult;
     private normalizeDependencyFields;
     static ɵfac: i0.ɵɵFactoryDeclaration<CascadeRulesService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CascadeRulesService>;
@@ -314,6 +343,7 @@ declare class CascadeManagerTabComponent implements OnChanges {
     }>;
     apply: EventEmitter<Record<string, Partial<FieldDefinition>>>;
     cancel: EventEmitter<void>;
+    validChange: EventEmitter<boolean>;
     searchTerm: string;
     private searchTimer;
     private searchValue;
@@ -327,7 +357,6 @@ declare class CascadeManagerTabComponent implements OnChanges {
     editLoadOn: 'respectLoadOn' | 'immediate' | 'manual';
     editDebounce: number | null;
     editValuePath: string;
-    editFilterMapJson: string;
     importMode: boolean;
     importJson: string;
     feedbackMessage: string;
@@ -337,13 +366,26 @@ declare class CascadeManagerTabComponent implements OnChanges {
         key: string;
         valuePath?: string;
     }>;
+    private editInitialFilterMap;
+    private editInitialValuePath;
+    private lastEmittedValid;
     private setFeedback;
     constructor(svc: CascadeRulesService);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
-    private _logCount;
     filteredFields(): Array<FieldDefinition | FieldMetadata>;
     labelFor(name: string): string;
+    /**
+     * Disambiguates fields that share the same display label (e.g. "Cargo" for both `cargoId` and `cargoNome`).
+     */
+    disambiguatedLabelFor(name: string): string;
+    hasRemoteOptionSource(name: string): boolean;
+    fieldRoleBadge(name: string): string;
+    fieldRoleSummary(name: string): string;
+    formatParentList(deps: string[]): string;
+    formatRelationshipSummary(targetField: string, deps: string[]): string;
+    formatLoadOnLabel(policy?: 'respectLoadOn' | 'immediate' | 'manual' | null): string;
+    formatMergeStrategyLabel(strategy?: 'merge' | 'replace' | null): string;
     selectedField(): string | null;
     selectField(name: string): void;
     hasRule(name: string): boolean;
@@ -351,10 +393,23 @@ declare class CascadeManagerTabComponent implements OnChanges {
     isCascadeEnabled(name: string): boolean;
     loadOnChange(name: string): 'respectLoadOn' | 'immediate' | 'manual';
     hasConflict(name: string): boolean;
+    /**
+     * Computes graph validation combining saved rules with any active draft in the inline editor.
+     */
+    validateCurrentGraph(includeDraft?: boolean): CascadeGraphValidationResult;
+    activeCycleDiagnostics(): CascadeCycleDiagnostic[];
+    isFieldInCycle(name: string): boolean;
+    hasBlockingErrors(): boolean;
+    private syncValidityState;
+    onDraftControlChange(): void;
     startEdit(name: string): void;
     edit(name: string): void;
     cancelEdit(): void;
     saveEdit(name: string): void;
+    /**
+     * Removes cyclic dependencies from the given field's draft (and saved rule if present).
+     */
+    breakCycleForField(name: string): void;
     remove(name: string): void;
     quickSet(name: string, action: 'disable' | 'manual'): void;
     private emitPatch;
@@ -366,6 +421,7 @@ declare class CascadeManagerTabComponent implements OnChanges {
     applyImport(): void;
     startTemplate(name: string, tpl: 'rota-destino' | 'rota-destino-propriedade'): void;
     buildMapRowsFromDeps(): void;
+    private initialRowValuePath;
     buildValuePathOverrides(deps: string[]): string | Record<string, string>;
     buildPreview(): string;
     copyPreview(): void;
@@ -374,7 +430,7 @@ declare class CascadeManagerTabComponent implements OnChanges {
     getKeySuggestions(dep: string): string[];
     getValuePathSuggestions(dep: string): string[];
     static ɵfac: i0.ɵɵFactoryDeclaration<CascadeManagerTabComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CascadeManagerTabComponent, "praxis-cascade-manager-tab", never, { "fields": { "alias": "fields"; "required": false; }; "connections": { "alias": "connections"; "required": false; }; }, { "apply": "apply"; "cancel": "cancel"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CascadeManagerTabComponent, "praxis-cascade-manager-tab", never, { "fields": { "alias": "fields"; "required": false; }; "connections": { "alias": "connections"; "required": false; }; }, { "apply": "apply"; "cancel": "cancel"; "validChange": "validChange"; }, never, never, true, never>;
 }
 
 /**
@@ -406,4 +462,4 @@ declare const PRAXIS_METADATA_EDITOR_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisMetadataEditorMetadata(): Provider;
 
 export { CascadeManagerTabComponent, CascadeRulesService, ConfigRegistryService, ContextValidatorRegistryService, DynamicEditorRendererComponent, DynamicFormFactoryService, EditorComponentRegistryService, FieldMetadataEditorComponent, METADATA_EDITOR_AI_CAPABILITIES, METADATA_EDITOR_AI_CAPABILITY_CATALOG, PRAXIS_METADATA_EDITOR_AUTHORING_MANIFEST, PRAXIS_METADATA_EDITOR_COMPONENT_METADATA, ReactiveDeterminationDiagnosticsComponent, SchemaNormalizerService, providePraxisMetadataEditorMetadata };
-export type { CascadeRuleViewModel, ConfigMap, EditorProperty };
+export type { CascadeCycleDiagnostic, CascadeGraphValidationResult, CascadeRuleViewModel, ConfigMap, EditorProperty };