@praxisui/metadata-editor 10.0.0-rc.4 → 10.0.0-rc.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/metadata-editor",
-  "version": "10.0.0-rc.4",
+  "version": "10.0.0-rc.40",
   "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.4",
-    "@praxisui/core": "^10.0.0-rc.4",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.4",
-    "@praxisui/settings-panel": "^10.0.0-rc.4",
+    "@praxisui/ai": "^10.0.0-rc.40",
+    "@praxisui/core": "^10.0.0-rc.40",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.40",
+    "@praxisui/settings-panel": "^10.0.0-rc.40",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

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

@@ -22,6 +22,11 @@ interface EditorProperty {
         value: any;
         text: string;
         textKey?: string;
+        icon?: string;
+        code?: string | null;
+        badge?: string | null;
+        description?: string | null;
+        searchTerms?: string[];
     }> | {
         type: 'static' | 'http' | 'fn';
         config?: any;
@@ -154,7 +159,11 @@ declare class FieldMetadataEditorComponent implements OnInit {
     normalizedProps: any[];
     renderedProps: any[];
     private initialSnapshot;
+    private initialControlType?;
+    private initialSeed?;
     private baselineReady;
+    private readonly formRebuild$;
+    private readonly hostApplyPatch?;
     typeOptions: Array<{
         value: FieldControlType;
         label: string;
@@ -163,9 +172,20 @@ declare class FieldMetadataEditorComponent implements OnInit {
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
     private readonly destroyRef;
+    private readonly resourceDiscovery;
+    private readonly i18n;
+    private discoveredResourceOptions;
     private lastCurrencyPreset;
     constructor(registry: ConfigRegistryService, normalizer: SchemaNormalizerService, factory: DynamicFormFactoryService, ctxValidators: ContextValidatorRegistryService);
+    private catalogLookupRequested;
+    private readonly resourceSchemaFieldsByPath;
+    private readonly resourceSchemaRequestIdByScope;
     ngOnInit(): void;
+    private loadCatalogResourceOptionsIfNeeded;
+    private resolveDiscoveryEndpointKey;
+    private bindResourcePathSchemaSync;
+    private seedCatalogResponseFieldsCache;
+    private resolveAndApplyResourceSchemaFields;
     private resolveCanonicalEditorProperties;
     private rebuildEditorForType;
     private setupGradientStopValidationSync;
@@ -208,9 +228,22 @@ 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;
+    private static readonly OPTION_SOURCE_DEPENDENT_FIELD_KEY_PROPS;
     private buildRenderedProps;
+    private enrichResourcePathProperty;
+    private enrichDependentFieldKeyProperty;
+    private normalizeResourceCacheKey;
+    private getCachedFieldsForResource;
+    private setCachedFieldsForResource;
+    private applyAutoSuggestedDependentKeys;
+    private selectSuggestedFieldKeys;
     private cloneSnapshot;
     private cloneMetadataValue;
     private canEmitSettingsValue;
@@ -265,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>;
@@ -286,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;
@@ -299,20 +357,35 @@ declare class CascadeManagerTabComponent implements OnChanges {
     editLoadOn: 'respectLoadOn' | 'immediate' | 'manual';
     editDebounce: number | null;
     editValuePath: string;
-    editFilterMapJson: string;
     importMode: boolean;
     importJson: string;
+    feedbackMessage: string;
+    feedbackTone: 'info' | 'error';
     editMapRows: Array<{
         dep: string;
         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;
@@ -320,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;
@@ -335,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;
@@ -343,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>;
 }
 
 /**
@@ -375,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 };