@praxisui/dynamic-fields 9.0.0-beta.44 → 9.0.0-beta.46

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-07-07T20:03:42.325Z",
+  "generatedAt": "2026-07-08T00:30:08.464Z",
   "packageName": "@praxisui/dynamic-fields",
-  "packageVersion": "9.0.0-beta.44",
+  "packageVersion": "9.0.0-beta.46",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 76,

package/docs/dynamic-fields-inline-components-guide.md

@@ -418,6 +418,7 @@ No modo percentual (`numericFormat` ou `format` com valor `percent`), mantém o
 `inlineCurrency` segue envelope adaptativo (`inlineAutoSize`) com máscara de moeda e símbolo antes/depois conforme metadata (`currencyPosition`).
 `inlineCurrencyRange` segue envelope adaptativo (`inlineAutoSize`) no chip e popover, com escala e resumo monetário formatados. No painel, o resumo completo é a leitura principal da faixa selecionada; os valores junto ao slider são usados apenas como orientação quando não duplicam a seleção ativa. `marks` materializa até três labels compactos e ativa ticks; `semanticBands` projeta faixas de significado no trilho; `distribution/rangeDistribution/histogram` continua sendo a camada para comparação com população real. Por padrão, alterações feitas no painel ficam em rascunho até `Aplicar`; `Cancelar`, `Esc` ou fechamento externo descartam o rascunho, e `Limpar` remove o filtro explicitamente. Labels, aria, `appearance`, `colorRole` e ícones dessas ações devem vir de `inlineOverlay.actions.*` e materializar tokens do tema. Quando `inlineOverlay.applyMode: "auto"` for explicitado, o slider comita durante a interação e a ação de cancelar deixa de ser exibida.
 `inlineEntityLookup` usa envelope adaptativo (`inlineAutoSize`) com faixa padrão maior para comportar `id + descrição`.
+Em shells corporativos autenticados, como seletores globais de empresa, tenant ou órgão, `pdx-inline-entity-lookup` pode ser usado fora de `PraxisDynamicForm` com um `FormControl` externo e `initialMetadata` estático. Para fontes locais, informe `options`, `optionValueKey`, `optionLabelKey` e `loadOn: "open"`; o valor inicial do `FormControl` deve ser preservado sem disparar recarga remota nem reprocessamento contínuo de metadata. Hosts devem preferir uma referência estável de metadata, mas o runtime tolera recriação semântica equivalente para evitar loops de change detection em topbars.
 `inlineRange` usa envelope adaptativo de largura (`inlineAutoSize`) no chip e no popover para evitar bloco fixo largo quando usado na barra compacta. Por padrao, altera em modo `auto` para preservar filtros rápidos; com `inlineOverlay.applyMode: "explicit"`, slider, inputs e presets ficam em rascunho até `Aplicar`, enquanto `Cancelar`, `Esc` ou fechamento externo descartam o rascunho. Labels, aria, `appearance` e `colorRole` dos botoes devem vir de `inlineOverlay.actions.*` e materializar tokens do tema, nao CSS ad hoc.
 `inlineRating` usa o mesmo contrato `inlineOverlay` para fluxos em que explorar estrelas, inputs ou presets nao deve alterar o filtro aplicado imediatamente. Em `applyMode: "explicit"`, o painel exibe `Aplicar`, `Cancelar` e `Limpar`; a escala visual acompanha o rascunho e o valor final so muda no commit.
 `inlineDistanceRadius` usa o mesmo contrato `inlineOverlay` quando a decisao de UX exigir confirmacao: em `applyMode: "explicit"`, slider radial e presets ficam em rascunho ate `Aplicar`; `Cancelar`, `Esc` e fechamento externo descartam a alteracao. O modo default continua imediato para preservar filtros de raio rapidos.

package/fesm2022/praxisui-dynamic-fields.mjs

@@ -13225,6 +13225,10 @@ class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     inlineMaxWidthPx = 420;
     fieldLabelText = 'Lookup';
     staticOptions = [];
+    lastAppliedSelectMetadata = null;
+    lastSelectMetadataSignature = '';
+    metadataFunctionIds = new WeakMap();
+    nextMetadataFunctionId = 0;
     set initialMetadata(metadata) {
         if (metadata) {
             this.setSelectMetadata(metadata);
@@ -13234,6 +13238,14 @@ class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
         return (this.metadata() || {});
     }
     setSelectMetadata(metadata) {
+        if (metadata === this.lastAppliedSelectMetadata) {
+            return;
+        }
+        const metadataSignature = this.buildMetadataSignature(metadata);
+        if (metadataSignature && metadataSignature === this.lastSelectMetadataSignature) {
+            this.lastAppliedSelectMetadata = metadata;
+            return;
+        }
         super.setSelectMetadata(metadata);
         this.fieldLabelText = this.resolveFieldLabelFromMetadata(metadata);
         this.staticOptions = this.options().map((option) => ({ ...option }));
@@ -13241,6 +13253,8 @@ class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
             this.applyStaticOptionsFilter(this.currentSearchTerm());
         }
         this.recalculateInlineSizeBounds();
+        this.lastAppliedSelectMetadata = metadata;
+        this.lastSelectMetadataSignature = metadataSignature;
     }
     setMetadata(metadata) {
         super.setMetadata(metadata);
@@ -14703,6 +14717,64 @@ class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     lookupOptionSource() {
         return (this.metadata()?.optionSource ?? this.optionSource()) || null;
     }
+    buildMetadataSignature(metadata) {
+        return this.stableMetadataHash(metadata, new WeakSet());
+    }
+    stableMetadataHash(value, seen) {
+        if (value === null) {
+            return 'null';
+        }
+        if (value === undefined) {
+            return 'undefined';
+        }
+        const valueType = typeof value;
+        if (valueType === 'function') {
+            return `function:${this.metadataFunctionId(value)}`;
+        }
+        if (valueType !== 'object') {
+            return `${valueType}:${this.hashText(String(value))}`;
+        }
+        const objectValue = value;
+        if (seen.has(objectValue)) {
+            return 'cycle';
+        }
+        seen.add(objectValue);
+        if (Array.isArray(value)) {
+            return this.hashParts([
+                'array',
+                String(value.length),
+                ...value.map((item) => this.stableMetadataHash(item, seen)),
+            ]);
+        }
+        const record = value;
+        return this.hashParts(Object.keys(record)
+            .sort()
+            .map((key) => `${key}:${this.stableMetadataHash(record[key], seen)}`));
+    }
+    metadataFunctionId(value) {
+        const existing = this.metadataFunctionIds.get(value);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const next = ++this.nextMetadataFunctionId;
+        this.metadataFunctionIds.set(value, next);
+        return next;
+    }
+    hashParts(parts) {
+        let hash = 2166136261;
+        for (const part of parts) {
+            hash = this.hashText(part, hash);
+        }
+        return hash.toString(36);
+    }
+    hashText(value, seed = 2166136261) {
+        let hash = seed;
+        for (let index = 0; index < value.length; index += 1) {
+            hash ^= value.charCodeAt(index);
+            hash = Math.imul(hash, 16777619);
+        }
+        return hash >>> 0;
+    }
     resolveDetailHref(id) {
         return this.applyLookupTemplate(this.lookupOptionSource()?.detail?.hrefTemplate, id);
     }
@@ -26795,11 +26867,23 @@ class MaterialSearchableSelectComponent extends SimpleBaseSelectComponent {
       @if (hasValidationError()) {
         <mat-error>{{ errorMessage() }}</mat-error>
       }
-      @if (metadata()?.hint && !hasValidationError()) {
-        <mat-hint>{{ metadata()!.hint }}</mat-hint>
+      @if (fieldHelpPopoverText()) {
+        <mat-icon
+          matSuffix
+          class="pdx-field-help-icon"
+          [matTooltip]="fieldHelpPopoverText()"
+          matTooltipPosition="above"
+          [matTooltipDisabled]="fieldHelpPopoverDisabled()"
+          [attr.aria-label]="fieldHelpAriaLabel()"
+          tabindex="0"
+          [praxisIcon]="'help_outline'"
+        ></mat-icon>
+      }
+      @if (hasInlineFieldHelp()) {
+        <mat-hint>{{ fieldHelpInlineText() }}</mat-hint>
       }
     </mat-form-field>
-    `, isInline: true, styles: ["::ng-deep .cdk-overlay-connected-position-bounding-box:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane .mat-mdc-select-panel.pdx-material-searchable-select-panel{max-height:min(360px,calc(100vh - 96px));overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain;padding:8px 0 6px;scrollbar-gutter:auto;scrollbar-width:thin;scrollbar-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 42%,transparent) transparent}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar{width:10px}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-track{border-radius:999px;background:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 10%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb{min-height:36px;border:3px solid transparent;border-radius:999px;background-clip:content-box;background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 56%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb:hover{background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 70%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option{background:var( --pdx-overlay-surface, var(--md-sys-color-surface-container-highest, var(--mat-select-panel-background-color)) );border-bottom:1px solid var(--pdx-overlay-border, var(--md-sys-color-outline-variant, rgba(148, 163, 184, .28)));box-sizing:border-box;display:block;padding:7px 12px;position:sticky;top:-8px;z-index:1}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input{background:var( --pdx-field-surface, color-mix( in srgb, var(--pdx-overlay-surface, var(--md-sys-color-surface-container-highest)) 82%, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 8% ) );border:1px solid var( --pdx-field-border, color-mix( in srgb, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 22%, transparent ) );border-radius:12px;box-sizing:border-box;color:var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)));min-height:38px;padding:0 12px;width:100%}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input::placeholder{color:color-mix(in srgb,var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface))) 68%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input:focus{border-color:var(--pdx-field-focus-border, var(--md-sys-color-primary, var(--mat-select-focused-arrow-color)));outline:1px solid var( --pdx-field-focus-ring, color-mix(in srgb, var(--md-sys-color-primary, currentColor) 32%, transparent) );outline-offset:0}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action{display:flex;align-items:center;min-height:48px;padding:0 16px;color:var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface));cursor:pointer;outline:none;-webkit-user-select:none;user-select:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:hover,::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:focus-visible{background:var(--pdx-overlay-state-layer, var(--md-sys-color-surface-container-high))}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action[aria-disabled=true]{cursor:default;opacity:.48;pointer-events:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-open-sentinel{min-height:0;height:0;padding:0;overflow:hidden;visibility:hidden}\n"], dependencies: [{ kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i1$2.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i4.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.RequiredValidator, selector: ":not([type=checkbox])[required][formControlName],:not([type=checkbox])[required][formControl],:not([type=checkbox])[required][ngModel]", inputs: ["required"] }, { kind: "directive", type: i1$1.FormControlDirective, selector: "[formControl]", inputs: ["formControl", "disabled", "ngModel"], outputs: ["ngModelChange"], exportAs: ["ngForm"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "component", type: i2$1.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i2$1.MatLabel, selector: "mat-label" }, { kind: "directive", type: i2$1.MatHint, selector: "mat-hint", inputs: ["align", "id"] }, { kind: "directive", type: i2$1.MatError, selector: "mat-error, [matError]", inputs: ["id"] }, { kind: "directive", type: i2$1.MatSuffix, selector: "[matSuffix], [matIconSuffix], [matTextSuffix]", inputs: ["matTextSuffix"] }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i3$1.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i3$1.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }, { kind: "ngmodule", type: MatInputModule }, { kind: "directive", type: i3.MatInput, selector: "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", inputs: ["disabled", "id", "placeholder", "name", "required", "type", "errorStateMatcher", "aria-describedby", "value", "readonly", "disabledInteractive"], exportAs: ["matInput"] }, { kind: "ngmodule", type: MatProgressSpinnerModule }, { kind: "component", type: i7.MatProgressSpinner, selector: "mat-progress-spinner, mat-spinner", inputs: ["color", "mode", "value", "diameter", "strokeWidth"], exportAs: ["matProgressSpinner"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i5.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }] });
+    `, isInline: true, styles: [".pdx-field-help-icon{border-radius:999px;color:var(--md-sys-color-on-surface-variant);cursor:help}.pdx-field-help-icon:focus{outline:2px solid var(--md-sys-color-primary);outline-offset:2px}::ng-deep .cdk-overlay-connected-position-bounding-box:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane .mat-mdc-select-panel.pdx-material-searchable-select-panel{max-height:min(360px,calc(100vh - 96px));overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain;padding:8px 0 6px;scrollbar-gutter:auto;scrollbar-width:thin;scrollbar-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 42%,transparent) transparent}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar{width:10px}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-track{border-radius:999px;background:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 10%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb{min-height:36px;border:3px solid transparent;border-radius:999px;background-clip:content-box;background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 56%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb:hover{background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 70%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option{background:var( --pdx-overlay-surface, var(--md-sys-color-surface-container-highest, var(--mat-select-panel-background-color)) );border-bottom:1px solid var(--pdx-overlay-border, var(--md-sys-color-outline-variant, rgba(148, 163, 184, .28)));box-sizing:border-box;display:block;padding:7px 12px;position:sticky;top:-8px;z-index:1}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input{background:var( --pdx-field-surface, color-mix( in srgb, var(--pdx-overlay-surface, var(--md-sys-color-surface-container-highest)) 82%, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 8% ) );border:1px solid var( --pdx-field-border, color-mix( in srgb, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 22%, transparent ) );border-radius:12px;box-sizing:border-box;color:var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)));min-height:38px;padding:0 12px;width:100%}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input::placeholder{color:color-mix(in srgb,var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface))) 68%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input:focus{border-color:var(--pdx-field-focus-border, var(--md-sys-color-primary, var(--mat-select-focused-arrow-color)));outline:1px solid var( --pdx-field-focus-ring, color-mix(in srgb, var(--md-sys-color-primary, currentColor) 32%, transparent) );outline-offset:0}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action{display:flex;align-items:center;min-height:48px;padding:0 16px;color:var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface));cursor:pointer;outline:none;-webkit-user-select:none;user-select:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:hover,::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:focus-visible{background:var(--pdx-overlay-state-layer, var(--md-sys-color-surface-container-high))}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action[aria-disabled=true]{cursor:default;opacity:.48;pointer-events:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-open-sentinel{min-height:0;height:0;padding:0;overflow:hidden;visibility:hidden}\n"], dependencies: [{ kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i1$2.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i4.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.RequiredValidator, selector: ":not([type=checkbox])[required][formControlName],:not([type=checkbox])[required][formControl],:not([type=checkbox])[required][ngModel]", inputs: ["required"] }, { kind: "directive", type: i1$1.FormControlDirective, selector: "[formControl]", inputs: ["formControl", "disabled", "ngModel"], outputs: ["ngModelChange"], exportAs: ["ngForm"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "component", type: i2$1.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i2$1.MatLabel, selector: "mat-label" }, { kind: "directive", type: i2$1.MatHint, selector: "mat-hint", inputs: ["align", "id"] }, { kind: "directive", type: i2$1.MatError, selector: "mat-error, [matError]", inputs: ["id"] }, { kind: "directive", type: i2$1.MatSuffix, selector: "[matSuffix], [matIconSuffix], [matTextSuffix]", inputs: ["matTextSuffix"] }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i3$1.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i3$1.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }, { kind: "ngmodule", type: MatInputModule }, { kind: "directive", type: i3.MatInput, selector: "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", inputs: ["disabled", "id", "placeholder", "name", "required", "type", "errorStateMatcher", "aria-describedby", "value", "readonly", "disabledInteractive"], exportAs: ["matInput"] }, { kind: "ngmodule", type: MatProgressSpinnerModule }, { kind: "component", type: i7.MatProgressSpinner, selector: "mat-progress-spinner, mat-spinner", inputs: ["color", "mode", "value", "diameter", "strokeWidth"], exportAs: ["matProgressSpinner"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i5.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImport: i0, type: MaterialSearchableSelectComponent, decorators: [{
             type: Component,
@@ -27007,8 +27091,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
       @if (hasValidationError()) {
         <mat-error>{{ errorMessage() }}</mat-error>
       }
-      @if (metadata()?.hint && !hasValidationError()) {
-        <mat-hint>{{ metadata()!.hint }}</mat-hint>
+      @if (fieldHelpPopoverText()) {
+        <mat-icon
+          matSuffix
+          class="pdx-field-help-icon"
+          [matTooltip]="fieldHelpPopoverText()"
+          matTooltipPosition="above"
+          [matTooltipDisabled]="fieldHelpPopoverDisabled()"
+          [attr.aria-label]="fieldHelpAriaLabel()"
+          tabindex="0"
+          [praxisIcon]="'help_outline'"
+        ></mat-icon>
+      }
+      @if (hasInlineFieldHelp()) {
+        <mat-hint>{{ fieldHelpInlineText() }}</mat-hint>
       }
     </mat-form-field>
     `, providers: [
@@ -27028,7 +27124,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
                         '[attr.data-field-type]': '"searchable-select"',
                         '[attr.data-field-name]': 'metadata()?.name',
                         '[attr.data-component-id]': 'componentId()',
-                    }, styles: ["::ng-deep .cdk-overlay-connected-position-bounding-box:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane .mat-mdc-select-panel.pdx-material-searchable-select-panel{max-height:min(360px,calc(100vh - 96px));overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain;padding:8px 0 6px;scrollbar-gutter:auto;scrollbar-width:thin;scrollbar-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 42%,transparent) transparent}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar{width:10px}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-track{border-radius:999px;background:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 10%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb{min-height:36px;border:3px solid transparent;border-radius:999px;background-clip:content-box;background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 56%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb:hover{background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 70%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option{background:var( --pdx-overlay-surface, var(--md-sys-color-surface-container-highest, var(--mat-select-panel-background-color)) );border-bottom:1px solid var(--pdx-overlay-border, var(--md-sys-color-outline-variant, rgba(148, 163, 184, .28)));box-sizing:border-box;display:block;padding:7px 12px;position:sticky;top:-8px;z-index:1}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input{background:var( --pdx-field-surface, color-mix( in srgb, var(--pdx-overlay-surface, var(--md-sys-color-surface-container-highest)) 82%, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 8% ) );border:1px solid var( --pdx-field-border, color-mix( in srgb, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 22%, transparent ) );border-radius:12px;box-sizing:border-box;color:var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)));min-height:38px;padding:0 12px;width:100%}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input::placeholder{color:color-mix(in srgb,var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface))) 68%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input:focus{border-color:var(--pdx-field-focus-border, var(--md-sys-color-primary, var(--mat-select-focused-arrow-color)));outline:1px solid var( --pdx-field-focus-ring, color-mix(in srgb, var(--md-sys-color-primary, currentColor) 32%, transparent) );outline-offset:0}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action{display:flex;align-items:center;min-height:48px;padding:0 16px;color:var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface));cursor:pointer;outline:none;-webkit-user-select:none;user-select:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:hover,::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:focus-visible{background:var(--pdx-overlay-state-layer, var(--md-sys-color-surface-container-high))}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action[aria-disabled=true]{cursor:default;opacity:.48;pointer-events:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-open-sentinel{min-height:0;height:0;padding:0;overflow:hidden;visibility:hidden}\n"] }]
+                    }, styles: [".pdx-field-help-icon{border-radius:999px;color:var(--md-sys-color-on-surface-variant);cursor:help}.pdx-field-help-icon:focus{outline:2px solid var(--md-sys-color-primary);outline-offset:2px}::ng-deep .cdk-overlay-connected-position-bounding-box:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane:has(.pdx-material-searchable-select-panel){z-index:var(--praxis-layer-popup, 1400)!important}::ng-deep .cdk-overlay-pane .mat-mdc-select-panel.pdx-material-searchable-select-panel{max-height:min(360px,calc(100vh - 96px));overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain;padding:8px 0 6px;scrollbar-gutter:auto;scrollbar-width:thin;scrollbar-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 42%,transparent) transparent}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar{width:10px}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-track{border-radius:999px;background:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 10%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb{min-height:36px;border:3px solid transparent;border-radius:999px;background-clip:content-box;background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 56%,transparent)}::ng-deep .pdx-material-searchable-select-panel::-webkit-scrollbar-thumb:hover{background-color:color-mix(in srgb,var(--pdx-overlay-on-surface, currentColor) 70%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option{background:var( --pdx-overlay-surface, var(--md-sys-color-surface-container-highest, var(--mat-select-panel-background-color)) );border-bottom:1px solid var(--pdx-overlay-border, var(--md-sys-color-outline-variant, rgba(148, 163, 184, .28)));box-sizing:border-box;display:block;padding:7px 12px;position:sticky;top:-8px;z-index:1}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input{background:var( --pdx-field-surface, color-mix( in srgb, var(--pdx-overlay-surface, var(--md-sys-color-surface-container-highest)) 82%, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 8% ) );border:1px solid var( --pdx-field-border, color-mix( in srgb, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)) 22%, transparent ) );border-radius:12px;box-sizing:border-box;color:var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface)));min-height:38px;padding:0 12px;width:100%}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input::placeholder{color:color-mix(in srgb,var(--pdx-field-text, var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface))) 68%,transparent)}::ng-deep .pdx-material-searchable-select-panel .pdx-select-search-option input:focus{border-color:var(--pdx-field-focus-border, var(--md-sys-color-primary, var(--mat-select-focused-arrow-color)));outline:1px solid var( --pdx-field-focus-ring, color-mix(in srgb, var(--md-sys-color-primary, currentColor) 32%, transparent) );outline-offset:0}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action{display:flex;align-items:center;min-height:48px;padding:0 16px;color:var(--pdx-overlay-on-surface, var(--md-sys-color-on-surface));cursor:pointer;outline:none;-webkit-user-select:none;user-select:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:hover,::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action:focus-visible{background:var(--pdx-overlay-state-layer, var(--md-sys-color-surface-container-high))}::ng-deep .pdx-material-searchable-select-panel .pdx-select-load-more-action[aria-disabled=true]{cursor:default;opacity:.48;pointer-events:none}::ng-deep .pdx-material-searchable-select-panel .pdx-select-open-sentinel{min-height:0;height:0;padding:0;overflow:hidden;visibility:hidden}\n"] }]
         }], propDecorators: { readonlyMode: [{
                 type: Input
             }], disabledMode: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-fields",
-  "version": "9.0.0-beta.44",
+  "version": "9.0.0-beta.46",
   "description": "Angular Material-based dynamic form fields for Praxis UI with lazy loading and metadata-driven rendering.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -11,8 +11,8 @@
     "@angular/platform-browser": "^21.0.0",
     "@angular/router": "^21.0.0",
     "rxjs": "^7.8.0",
-    "@praxisui/core": "^9.0.0-beta.44",
-    "@praxisui/cron-builder": "^9.0.0-beta.44"
+    "@praxisui/core": "^9.0.0-beta.46",
+    "@praxisui/cron-builder": "^9.0.0-beta.46"
   },
   "dependencies": {
     "libphonenumber-js": "^1.12.41",

package/src/lib/components/inline-entity-lookup/pdx-inline-entity-lookup.json-api.md

@@ -366,6 +366,7 @@ Resumo de composicao deste componente:
 - `metadata.optionSource.display` e a fonte preferencial de UX para a entidade; campos top-level como `selectedLayout`, `density`, `showAvatar` e `showStatus` funcionam como override local de host.
 - Opcoes podem mostrar linha secundaria (`subtitle`) para desambiguacao; em `entityLookup`, a linha rica tambem mostra avatar, campos ricos com icones/chips/datas, status visual, badges e motivo de bloqueio.
 - Com `metadata.optionSource.resourcePath`, busca emite termo no pipeline remoto de option-source; sem endpoint, filtra local.
+- Em uso standalone de shell/topbar autenticado, o componente aceita `FormControl` externo com `initialMetadata` estático e `options` locais. Um valor inicial já selecionado no controle deve materializar o texto da opção local sem bloquear a montagem da rota nem realimentar change detection quando a metadata recebida for semanticamente equivalente.
 - `metadata.resourcePath` continua aceito como configuracao operacional herdada, mas nao substitui a semantica canonica de entidade publicada em `metadata.optionSource`.
 - Opcao de reset limpa filtro sem fechar contexto de trabalho.
 - `OptionDTO.extra.selectable === false` desabilita a opcao e permite exibir `disabledReason` sem remover a entidade da lista ou da reidratacao.

package/types/praxisui-dynamic-fields.d.ts

@@ -2895,6 +2895,10 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     inlineMaxWidthPx: number;
     private fieldLabelText;
     private staticOptions;
+    private lastAppliedSelectMetadata;
+    private lastSelectMetadataSignature;
+    private readonly metadataFunctionIds;
+    private nextMetadataFunctionId;
     set initialMetadata(metadata: MaterialEntityLookupMetadata | null | undefined);
     private currentMetadata;
     setSelectMetadata(metadata: EntityLookupMetadata): void;
@@ -3086,6 +3090,11 @@ declare class InlineEntityLookupComponent extends MaterialAsyncSelectComponent {
     private isPrimitiveLookupValue;
     private asRecord;
     private lookupOptionSource;
+    private buildMetadataSignature;
+    private stableMetadataHash;
+    private metadataFunctionId;
+    private hashParts;
+    private hashText;
     private resolveDetailHref;
     private resolveDetailRoute;
     private applyLookupTemplate;