commons-shared-web-ui 0.0.77 → 0.0.79

package/index.d.ts

@@ -526,6 +526,33 @@ interface OptionConfig$1 {
      * pagination is added.
      */
     customUI?: boolean;
+    /** Edit-mode lookup for resolving primitive initial values (id/code) into full option objects via targeted API call. */
+    lookupConfig?: LookupConfig;
+}
+/**
+ * Configuration for resolving primitive initial values (id/code) into full
+ * option objects during edit-mode form initialization.
+ * Only fires when selectedOptionsData is absent and initialValues contains
+ * a primitive (not a full object).
+ */
+interface LookupConfig {
+    /** Endpoint URL. Supports {value} placeholder for single-item GET. */
+    apiUrl: string;
+    /** HTTP method. Default: 'GET'. Same convention as OptionConfig.apiMethod. */
+    apiMethod?: 'GET' | 'POST';
+    /** Static base payload for POST. Lookup value(s) merged via paramName key. */
+    apiPayload?: any;
+    /** Parameter key for the lookup value.
+     *  GET: query param (?id=2415 or ?ids=5,12,18)
+     *  POST: body key ({ "codes": ["MATH_01"] })
+     *  Default: 'id' (single) / 'ids' (multiple). */
+    paramName?: string;
+    /** Response path to extract results. Falls back to parent optionConfig.dataPath. */
+    dataPath?: string;
+    /** Custom HTTP headers. Same convention as AutocompleteConfig.headers. */
+    headers?: {
+        [key: string]: string;
+    };
 }
 interface AutocompleteDisplayField {
     /** Dot-notation path to the value in the API response item (e.g. 'login', 'contact.phone'). */
@@ -1560,6 +1587,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private hostRef;
     private overlay;
     private dateAdapter;
+    private cdr;
     config: FieldConfig;
     controller: SmartFormController;
     /**
@@ -1767,7 +1795,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     get groupKey(): string;
     readonly dropdownScrollStrategy: ScrollStrategy;
-    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>, overlay: Overlay, dateAdapter: DateAdapter<Date>);
+    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>, overlay: Overlay, dateAdapter: DateAdapter<Date>, cdr: ChangeDetectorRef);
     isFieldVisible(field: FieldConfig, rowController?: SmartFormController): boolean;
     /** Portal root, resolved from this component's own node rather than the global document. */
     private get portalRoot();
@@ -1973,6 +2001,12 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     resetDropdownSearch(forceLoad?: boolean, bypassCache?: boolean): void;
     /** Merges option(s) from selectedOptionsData into the local dropdown options list */
     mergeSelectedOptionsIntoList(): void;
+    /**
+     * If the field's initial value is a primitive (not an object) and no
+     * selectedOptionsData was provided, uses lookupConfig to fire a targeted
+     * API call to resolve the display label for edit-mode prefilling.
+     */
+    private _resolveLookupIfNeeded;
     /**
      * Extracts option(s) and their corresponding raw codes from an initial value object or array of objects.
      * If the value is a primitive but initialLabelField is configured, it looks up the sibling field value.
@@ -5379,6 +5413,14 @@ interface HierarchyCfg {
     colSpan: number;
     payloadPrefix: string;
     dependencyParam: string;
+    /**
+     * Per-classCode overrides, keyed by the template's classCode (e.g. "GREF.REGION_DISTRICT").
+     * Recognized keys: name, label, placeholder, payloadField, colSpan, required, errorMessage,
+     * noDependency, hidden (skip this node but keep walking its children), disabled (render the
+     * generated field as disabled — e.g. to lock a level to a known value), and leaf (stop
+     * descending past this classCode, so deeper template levels — e.g. Ward below District —
+     * are never generated for this consumer).
+     */
     nodes: Record<string, any>;
     branchSubType: string;
     showLoader: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.77",
+  "version": "0.0.79",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",