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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/metadata-editor",
-  "version": "10.0.0-rc.38",
+  "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.38",
-    "@praxisui/core": "^10.0.0-rc.38",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.38",
-    "@praxisui/settings-panel": "^10.0.0-rc.38",
+    "@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

@@ -298,6 +298,21 @@ 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;
@@ -305,6 +320,15 @@ declare class CascadeRulesService {
     clearPatch(): Partial<FieldDefinition>;
     /** 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>;
@@ -319,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;
@@ -343,13 +368,24 @@ declare class CascadeManagerTabComponent implements OnChanges {
     }>;
     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;
@@ -357,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;
@@ -381,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>;
 }
 
 /**
@@ -413,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 };