commons-shared-web-ui 0.0.63 → 0.0.64

package/index.d.ts

@@ -960,7 +960,7 @@ interface ConfiguratorTreeNode {
     label: string;
     /** Node type */
     type: ConfiguratorNodeType;
-    /** Whether the node is expanded (for groups/sections) */
+    /** Whether the node is expanded (for groups/sections, and for a 'field' node with children — see geoClassCode) */
     expanded: boolean;
     /** Reference to the FieldConfig (only for field nodes) */
     fieldConfig: FieldConfig | null;
@@ -968,6 +968,14 @@ interface ConfiguratorTreeNode {
     path: number[];
     /** Child nodes */
     children: ConfiguratorTreeNode[];
+    /**
+     * Set only on synthetic geography-hierarchy-level nodes (children of a GEOGRAPHY_DYNAMIC
+     * field, e.g. Country/State/District). These don't exist as real schema array children —
+     * they live in the parent field's nested `geographyConfig.field.nodes` map — so `path` on
+     * these nodes equals the PARENT GEOGRAPHY_DYNAMIC field's own path, and `geoClassCode` is
+     * what actually distinguishes one level (and the parent itself, where it's undefined).
+     */
+    geoClassCode?: string;
 }
 
 /**
@@ -980,6 +988,16 @@ declare class FieldConfiguratorService {
     readonly tree: i0.Signal<ConfiguratorTreeNode[]>;
     readonly schema: i0.Signal<FormSchema>;
     readonly selectedFieldPath: i0.Signal<number[]>;
+    readonly selectedGeoClassCode: i0.Signal<string>;
+    /**
+     * Resolves to the real FieldConfig at the selected path — UNLESS the selection is a
+     * synthetic geography-hierarchy-level node (selectedGeoClassCode set), in which case this
+     * returns a small synthetic FieldConfig built from that level's entry in the parent
+     * GEOGRAPHY_DYNAMIC field's `geographyConfig.field.nodes` map instead. Every downstream
+     * consumer (selectedFieldInfo, selectedFieldBuilderType, the config panel itself) works
+     * against whichever shape comes out of here unchanged — mapFieldTypeToBuilderType('GEOGRAPHY_NODE')
+     * resolves the right minimal config schema (label/colSpan only, see field-type-schema.map.ts).
+     */
     readonly selectedField: i0.Signal<FieldConfig>;
     readonly selectedFieldInfo: i0.Signal<ConfiguratorFieldInfo>;
     /**
@@ -992,9 +1010,11 @@ declare class FieldConfiguratorService {
      */
     loadSchema(schema: FormSchema, preserveSelection?: boolean): void;
     /**
-     * Select a field by its path. Pass null to deselect.
+     * Select a field by its path. Pass null to deselect. `geoClassCode` selects a synthetic
+     * geography-hierarchy-level child of the GEOGRAPHY_DYNAMIC field at `path` instead of the
+     * field itself — see ConfiguratorTreeNode.geoClassCode / selectedField above.
      */
-    selectField(path: number[] | null): void;
+    selectField(path: number[] | null, geoClassCode?: string | null): void;
     /**
      * Toggle a tree node's expanded state.
      */
@@ -1007,7 +1027,8 @@ declare class FieldConfiguratorService {
     /**
      * Change the type (and optionally subType) of the currently selected field.
      * Mapping goes from builderType keys (e.g. 'richText') → {type, subType?}.
-     * DROPDOWN fields cannot be changed and are guarded here as well.
+     * DROPDOWN fields cannot be changed and are guarded here as well — same for a synthetic
+     * geography-hierarchy-level selection, which has no real `type` to switch at all.
      */
     changeFieldType(builderType: string): void;
     /**
@@ -1048,7 +1069,10 @@ declare class FieldConfiguratorComponent implements OnChanges {
     finalFieldTypeSchemaMap: Record<string, FormSchema>;
     private _isInternalChange;
     ngOnChanges(changes: SimpleChanges): void;
-    onFieldSelected(path: number[]): void;
+    onFieldSelected(selection: {
+        path: number[];
+        geoClassCode?: string;
+    }): void;
     onNodeToggleExpanded(nodeId: string): void;
     onConfigChange(patch: Record<string, unknown>): void;
     onTypeChange(builderType: string): void;
@@ -1128,7 +1152,13 @@ declare class SelectionFieldNodeComponent {
 declare class ConfiguratorTreeComponent {
     tree: ConfiguratorTreeNode[];
     selectedFieldPath: number[] | null;
-    selectField: EventEmitter<number[]>;
+    /** Distinguishes a GEOGRAPHY_DYNAMIC field itself from one of its synthetic hierarchy-level
+     *  children — both share the same `path`, so `path` alone can't tell them apart. */
+    selectedGeoClassCode: string | null;
+    selectField: EventEmitter<{
+        path: number[];
+        geoClassCode?: string;
+    }>;
     toggleExpanded: EventEmitter<string>;
     onNodeClick(node: ConfiguratorTreeNode): void;
     onFieldSelect(node: ConfiguratorTreeNode): void;
@@ -1137,7 +1167,7 @@ declare class ConfiguratorTreeComponent {
     trackByNodeId(_index: number, node: ConfiguratorTreeNode): string;
     private pathsEqual;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfiguratorTreeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorTreeComponent, "lib-configurator-tree", never, { "tree": { "alias": "tree"; "required": false; }; "selectedFieldPath": { "alias": "selectedFieldPath"; "required": false; }; }, { "selectField": "selectField"; "toggleExpanded": "toggleExpanded"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorTreeComponent, "lib-configurator-tree", never, { "tree": { "alias": "tree"; "required": false; }; "selectedFieldPath": { "alias": "selectedFieldPath"; "required": false; }; "selectedGeoClassCode": { "alias": "selectedGeoClassCode"; "required": false; }; }, { "selectField": "selectField"; "toggleExpanded": "toggleExpanded"; }, never, never, false, never>;
 }
 
 type SnackbarVariant = 'success' | 'error' | 'warning' | 'info';
@@ -1200,7 +1230,8 @@ declare class ConfiguratorConfigPanelComponent implements OnChanges {
     currentBuilderType: string | null;
     /** Identity key of the currently rendered field — used to detect real field switches. */
     private _currentFieldKey;
-    /** True when the current field type is DROPDOWN — type switching is disabled for these fields. */
+    /** True when type switching should be disabled — DROPDOWN-based fields, and synthetic
+     *  geography-hierarchy-level nodes (GEOGRAPHY_NODE), which have no real `type` to switch. */
     get isDropdownType(): boolean;
     ngOnChanges(changes: SimpleChanges): void;
     /**
@@ -4962,9 +4993,22 @@ declare function appendBaseUrlRecursively(obj: any, baseURL: string): void;
 interface HierarchyCfg {
     templateApiUrl: string;
     templateListPath: string | null;
-    templateSelect: 'default' | 'first' | 'byCode';
+    templateSelect: 'default' | 'first' | 'byCode' | 'byId';
     templateSelectField: string;
     templateSelectCode?: string;
+    /** Used when templateSelect === 'byId' — matches a template by its numeric `id`, since
+     *  multiple templates can share the same templateCode (distinguished by templateName). */
+    templateSelectId?: number;
+    /**
+     * When set, the caller already has the resolved MdmClassHierarchyTemplateDTO-shaped object
+     * (e.g. it fetched and picked it client-side already) — used as-is, skipping the runtime's
+     * own HTTP GET to templateApiUrl and the templateSelect/templateSelectId matching entirely.
+     * Trades the always-live "re-fetch and re-match by id" behavior for zero extra network
+     * round-trips; the caller is responsible for re-supplying fresh data if the underlying
+     * template changes later. Analogous to how optionConfig.optionList is a static alternative
+     * to optionConfig.apiUrl for dropdown fields.
+     */
+    templateData?: any;
     rootCodePath: string;
     templateCodePath: string;
     hierarchyListPath: string;

package/package.json

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