commons-shared-web-ui 0.0.72 → 0.0.74

package/index.d.ts

@@ -45,6 +45,8 @@ import * as i29 from '@angular/cdk/accordion';
 import * as i11$2 from 'ngx-quill';
 import * as i11$1 from '@angular/cdk/scrolling';
 import { CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
+import * as i5$1 from '@angular/cdk/drag-drop';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
 
 type ButtonVariant = 'primary' | 'warning' | 'outline' | 'secondary' | 'success' | 'danger' | 'danger-outline' | 'text';
 interface ButtonLabels {
@@ -517,6 +519,13 @@ interface OptionConfig$1 {
     showSelectAll?: boolean;
     /** When true, displays a loading spinner during options API requests. */
     showLoader?: boolean;
+    /**
+     * When true, a plain `optionList`-only SINGLE DROPDOWN (no `searchConfig`/`pagination`) renders
+     * the same styled overlay/chevron panel used by searchable and paginated dropdowns, instead of
+     * a native `<select>` — purely for visual consistency with sibling fields. No search box or
+     * pagination is added.
+     */
+    customUI?: boolean;
 }
 interface AutocompleteDisplayField {
     /** Dot-notation path to the value in the API response item (e.g. 'login', 'contact.phone'). */
@@ -1650,10 +1659,27 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
      * object is reused across multiple allowMulti repeater instances.
      */
     localOptionList: any[];
+    /** Snapshot of default (unsearched) options and pagination state for DROPDOWN / AUTOCOMPLETE fields */
+    private defaultStateSnapshot;
+    /** Tracks whether the current localOptionList is filtered by an active server-side search query */
+    private _isServerSearchActive;
     /** Dedicated cache of currently selected option objects */
     selectedItems: any[];
     /** Cache of the latest dependency parameters for server-side autocomplete filtering */
     private _latestDependencyValues;
+    /** True when this field has no optionConfig.dependencies (nothing to satisfy) OR every
+     *  dependency's current value is present — false while waiting on a parent field. Guards every
+     *  opportunistic reload path (dropdown-open, search-reset, search-clear) so a dependent
+     *  dropdown never re-fetches an unfiltered full list just because it was opened/searched before
+     *  its parent was chosen — only setupDependencies()'s own reactive load (which always supplies
+     *  the real dependency params) is allowed to populate it.
+     *  Defaults to true here (fields with no dependencies never get corrected otherwise), but
+     *  ngOnInit flips it to false up front for any field that DOES declare dependencies — closing
+     *  the window between component creation and setupDependencies()'s first (necessarily async,
+     *  via combineLatest) emission, during which a fast dropdown-open would otherwise still see
+     *  this stale `true` default and fire an unfiltered fetch before the parent-unmet state is
+     *  known. */
+    private _dependenciesSatisfied;
     /** For GROUP fields with allowMulti = true */
     groupFormArray: FormArray;
     /** For GROUP fields with allowMulti = false — single nested FormGroup */
@@ -1716,7 +1742,9 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     isSingleOptionSelected(code: any): boolean;
     /** Whether the dropdown search feature is enabled for this field */
     get isSearchableDropdown(): boolean;
-    /** Whether the custom single-select dropdown overlay is required (for search OR pagination) */
+    /** Whether the custom single-select dropdown overlay is required — for search, pagination, or
+     *  when optionConfig.customUI opts in to the styled overlay purely for visual consistency with
+     *  sibling dropdowns (no search box, no pagination — just the same panel/chevron treatment). */
     get isCustomSingleDropdown(): boolean;
     private initGroupField;
     /**
@@ -1888,6 +1916,8 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private initDropdownSearch;
     /** Execute client-side or server-side dropdown search. */
     private executeDropdownSearch;
+    /** Restores localOptionList and pagination metadata from defaultStateSnapshot, preserving selected item(s) */
+    private restoreDefaultOptionList;
     /** Resets the dropdown search text and filtered list. */
     resetDropdownSearch(forceLoad?: boolean, bypassCache?: boolean): void;
     /** Merges option(s) from selectedOptionsData into the local dropdown options list */
@@ -2660,6 +2690,9 @@ interface DropdownConfig {
     disabled?: boolean;
     required?: boolean;
     errorMessage?: string;
+    serverSearch?: boolean;
+    searchDebounceMs?: number;
+    lazyLoad?: boolean;
     width?: string;
     height?: string;
     borderRadius?: string;
@@ -2683,7 +2716,7 @@ interface DropdownConfig {
     boxShadow?: string;
 }
 
-declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChanges {
+declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChanges, OnDestroy {
     private el;
     config?: DropdownConfig;
     labels?: DropdownLabels;
@@ -2697,6 +2730,12 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     disabled: boolean;
     required: boolean;
     errorMessage: string;
+    serverSearch: boolean;
+    searchDebounceMs: number;
+    lazyLoad: boolean;
+    loading: boolean;
+    loadingMore: boolean;
+    hasMore: boolean;
     width?: string;
     height?: string;
     borderRadius?: string;
@@ -2719,6 +2758,8 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     disabledColor?: string;
     boxShadow?: string;
     selectionChange: EventEmitter<any>;
+    searchTermChange: EventEmitter<string>;
+    loadMore: EventEmitter<void>;
     viewport?: CdkVirtualScrollViewport;
     searchInput?: ElementRef;
     triggerEl?: ElementRef;
@@ -2734,8 +2775,10 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     };
     onChange: (value: any) => void;
     onTouched: () => void;
+    private search$;
     constructor(el: ElementRef);
     ngOnInit(): void;
+    ngOnDestroy(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private get validOptions();
     private updateFromConfig;
@@ -2756,6 +2799,7 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     selectOption(option: DropdownOption): void;
     isSelected(option: DropdownOption): boolean;
     onSearch(term: string): void;
+    onOptionsScroll(event: Event): void;
     clearSelection(event?: Event): void;
     getIconType(icon: any): 'material' | 'fontawesome' | 'img' | 'none';
     getIconValue(icon: any): string;
@@ -2774,7 +2818,7 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
         [key: string]: string | undefined;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "lib-dropdown", never, { "config": { "alias": "config"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "options": { "alias": "options"; "required": false; }; "selectedValue": { "alias": "selectedValue"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "label": { "alias": "label"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "width": { "alias": "width"; "required": false; }; "height": { "alias": "height"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "fontSize": { "alias": "fontSize"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "fontFamily": { "alias": "fontFamily"; "required": false; }; "labelColor": { "alias": "labelColor"; "required": false; }; "labelFontSize": { "alias": "labelFontSize"; "required": false; }; "labelFontWeight": { "alias": "labelFontWeight"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "borderColor": { "alias": "borderColor"; "required": false; }; "borderWidth": { "alias": "borderWidth"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "fontWeight": { "alias": "fontWeight"; "required": false; }; "color": { "alias": "color"; "required": false; }; "placeholderColor": { "alias": "placeholderColor"; "required": false; }; "focusBorderColor": { "alias": "focusBorderColor"; "required": false; }; "errorColor": { "alias": "errorColor"; "required": false; }; "disabledBackgroundColor": { "alias": "disabledBackgroundColor"; "required": false; }; "disabledColor": { "alias": "disabledColor"; "required": false; }; "boxShadow": { "alias": "boxShadow"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "lib-dropdown", never, { "config": { "alias": "config"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "options": { "alias": "options"; "required": false; }; "selectedValue": { "alias": "selectedValue"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "label": { "alias": "label"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "serverSearch": { "alias": "serverSearch"; "required": false; }; "searchDebounceMs": { "alias": "searchDebounceMs"; "required": false; }; "lazyLoad": { "alias": "lazyLoad"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "loadingMore": { "alias": "loadingMore"; "required": false; }; "hasMore": { "alias": "hasMore"; "required": false; }; "width": { "alias": "width"; "required": false; }; "height": { "alias": "height"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "fontSize": { "alias": "fontSize"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "fontFamily": { "alias": "fontFamily"; "required": false; }; "labelColor": { "alias": "labelColor"; "required": false; }; "labelFontSize": { "alias": "labelFontSize"; "required": false; }; "labelFontWeight": { "alias": "labelFontWeight"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "borderColor": { "alias": "borderColor"; "required": false; }; "borderWidth": { "alias": "borderWidth"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "fontWeight": { "alias": "fontWeight"; "required": false; }; "color": { "alias": "color"; "required": false; }; "placeholderColor": { "alias": "placeholderColor"; "required": false; }; "focusBorderColor": { "alias": "focusBorderColor"; "required": false; }; "errorColor": { "alias": "errorColor"; "required": false; }; "disabledBackgroundColor": { "alias": "disabledBackgroundColor"; "required": false; }; "disabledColor": { "alias": "disabledColor"; "required": false; }; "boxShadow": { "alias": "boxShadow"; "required": false; }; }, { "selectionChange": "selectionChange"; "searchTermChange": "searchTermChange"; "loadMore": "loadMore"; }, never, never, false, never>;
 }
 
 interface CheckboxOption {
@@ -3306,6 +3350,8 @@ interface ConfigFieldNode {
     visible: boolean;
     /** Whether the field is mandatory (required). Only meaningful when `visible` is true. */
     mandatory: boolean;
+    /** Column span in the section's 12-column grid (1-12). Freely editable. */
+    colSpan: number;
     /** When true, the visibility toggle is locked ON (cannot be hidden). */
     lockVisibility: boolean;
     /** When true, the mandatory control is locked (cannot be changed). */
@@ -3345,6 +3391,21 @@ interface ConfigSectionNode {
     fields: ConfigFieldNode[];
     /** Recursively nested child sections. */
     subsections: ConfigSectionNode[];
+    /**
+     * Live reference to the schema array `fields` was parsed from (e.g. a section's
+     * `sectionConfig.children`, or the top-level `sectionConfig.children` for a
+     * synthetic bundle). Reordering writes directly into this array so the schema's
+     * own field order — not a separate `sequence` property — drives render order.
+     * Null when there is nothing to reorder into (e.g. an empty section).
+     */
+    fieldsSource: FieldConfig[] | null;
+    /**
+     * False when this section's own children include a `ROW` wrapper. Reordering is
+     * disabled in that case — flattening a ROW's grouped children into plain
+     * siblings would silently break the row layout, so dragging is turned off
+     * instead of risking a corrupted schema.
+     */
+    reorderable: boolean;
 }
 
 /**
@@ -3377,6 +3438,16 @@ declare class FieldConfigurationService {
     toggleFieldVisible(path: number[], fieldIndex: number): void;
     /** Toggle a field's mandatory flag. Ignored when locked or hidden. */
     toggleFieldMandatory(path: number[], fieldIndex: number): void;
+    /** Set a field's column span, clamped to the 1-12 grid range. */
+    setFieldColSpan(path: number[], fieldIndex: number, colSpan: number): void;
+    /**
+     * Reorder a field within its own section (drag-and-drop). Reordering is scoped to
+     * one section's direct fields — dragging never moves a field across sections.
+     * Rejected (no-op) if the move would place a field above the field it depends on
+     * via `optionConfig.dependencies` (e.g. a "state" field can never sort above the
+     * "country" field it depends on).
+     */
+    reorderField(path: number[], previousIndex: number, currentIndex: number): void;
     /**
      * Produce the updated schema. Writes the current tree state onto the working
      * clone and returns a fresh deep clone (safe to hand to the host / submit).
@@ -3398,6 +3469,12 @@ declare class FieldConfigurationService {
      * derived `visibilityLockedByParent` flag set (drives the disabled toggle in the UI).
      */
     private _applyDependencyRules;
+    /**
+     * True when every field with a dependency parent (`parentName`) sorts after that
+     * parent within the given list. Fields whose parent isn't a sibling in this same
+     * list (cross-section dependency, or no such field) are unconstrained here.
+     */
+    private _isValidFieldOrder;
     /** Recursively set visibility on a section and all its descendants (respecting locks). */
     private _cascadeVisibility;
     static ɵfac: i0.ɵɵFactoryDeclaration<FieldConfigurationService, never>;
@@ -3409,6 +3486,16 @@ interface FieldEventPayload {
     sectionPath: number[];
     fieldIndex: number;
 }
+/** Payload for a field colSpan change, carrying the sub-path from this section down. */
+interface FieldColSpanPayload extends FieldEventPayload {
+    colSpan: number;
+}
+/** Payload for a field drag-reorder, carrying the sub-path from this section down. */
+interface FieldReorderPayload {
+    sectionPath: number[];
+    previousIndex: number;
+    currentIndex: number;
+}
 /**
  * A recursive section/group node in the form-field-configuration tree.
  * Emits path-relative events that parents prefix with their own index before
@@ -3423,6 +3510,8 @@ declare class ConfigSectionNodeComponent {
     toggleExpanded: EventEmitter<number[]>;
     fieldToggleVisible: EventEmitter<FieldEventPayload>;
     fieldToggleMandatory: EventEmitter<FieldEventPayload>;
+    fieldColSpanChange: EventEmitter<FieldColSpanPayload>;
+    fieldReorder: EventEmitter<FieldReorderPayload>;
     get displayLabel(): string;
     get visibleFieldCount(): number;
     get hasToggle(): boolean;
@@ -3430,29 +3519,41 @@ declare class ConfigSectionNodeComponent {
     onToggleExpanded(): void;
     onFieldToggleVisible(fieldIndex: number): void;
     onFieldToggleMandatory(fieldIndex: number): void;
+    onFieldColSpanChange(fieldIndex: number, colSpan: number): void;
+    onFieldDrop(event: CdkDragDrop<unknown>): void;
     onSubToggleVisible(subIndex: number, subPath: number[]): void;
     onSubToggleExpanded(subIndex: number, subPath: number[]): void;
     onSubFieldToggleVisible(subIndex: number, payload: FieldEventPayload): void;
     onSubFieldToggleMandatory(subIndex: number, payload: FieldEventPayload): void;
+    onSubFieldColSpanChange(subIndex: number, payload: FieldColSpanPayload): void;
+    onSubFieldReorder(subIndex: number, payload: FieldReorderPayload): void;
     trackByIndex(index: number): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfigSectionNodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfigSectionNodeComponent, "lib-config-section-node", never, { "section": { "alias": "section"; "required": true; }; "depth": { "alias": "depth"; "required": false; }; "translate": { "alias": "translate"; "required": false; }; }, { "toggleVisible": "toggleVisible"; "toggleExpanded": "toggleExpanded"; "fieldToggleVisible": "fieldToggleVisible"; "fieldToggleMandatory": "fieldToggleMandatory"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfigSectionNodeComponent, "lib-config-section-node", never, { "section": { "alias": "section"; "required": true; }; "depth": { "alias": "depth"; "required": false; }; "translate": { "alias": "translate"; "required": false; }; }, { "toggleVisible": "toggleVisible"; "toggleExpanded": "toggleExpanded"; "fieldToggleVisible": "fieldToggleVisible"; "fieldToggleMandatory": "fieldToggleMandatory"; "fieldColSpanChange": "fieldColSpanChange"; "fieldReorder": "fieldReorder"; }, never, never, false, never>;
 }
 
 /**
  * Form Field Configuration
  * ------------------------
  * Renders a compact tree of a form schema's sections and fields, each with a
- * **visibility** toggle and a **mandatory** control. Intended to be embedded
- * inside a `cc-confirmation-modal` on a host page ("Configure fields").
+ * **visibility** toggle, a **mandatory** control, an editable **column span**,
+ * and a drag handle to **reorder** fields within their own section. Intended to
+ * be embedded inside a `cc-confirmation-modal` on a host page ("Configure fields").
  *
  * Pass a `FormSchema` via `[schema]`. The input is deep-cloned, so it is never
  * mutated. When the user confirms, call `getUpdatedSchema()` to read back the
- * modified schema (visible/isEnabled/disabled and required flags updated).
+ * modified schema (visible/isEnabled/disabled, required, and colSpan flags
+ * updated, and each section's own children reordered to match the tree).
  *
  * Fields/sections carrying `lockVisibility: true` cannot be hidden, and
  * `lockMandatory: true` freezes their required state.
  *
+ * Reordering is scoped to one section's direct fields — a field can never be
+ * dragged into another section, and a field can never be dragged above a field
+ * it depends on via `optionConfig.dependencies` (e.g. "state" can't sort above
+ * "country"). Sections whose children include a `ROW` wrapper can't be
+ * reordered at all (dragging is disabled) to avoid flattening the row layout.
+ *
  * @example
  * ```html
  * <cc-confirmation-modal [isOpen]="open" (confirm)="save()" (cancel)="open = false">
@@ -3482,6 +3583,8 @@ declare class FormFieldConfigurationComponent implements OnChanges {
     onToggleExpanded(sectionIndex: number, subPath: number[]): void;
     onFieldToggleVisible(sectionIndex: number, payload: FieldEventPayload): void;
     onFieldToggleMandatory(sectionIndex: number, payload: FieldEventPayload): void;
+    onFieldColSpanChange(sectionIndex: number, payload: FieldColSpanPayload): void;
+    onFieldReorder(sectionIndex: number, payload: FieldReorderPayload): void;
     trackByIndex(index: number): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormFieldConfigurationComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FormFieldConfigurationComponent, "lib-form-field-configuration", never, { "schema": { "alias": "schema"; "required": true; }; "translate": { "alias": "translate"; "required": false; }; "showLegend": { "alias": "showLegend"; "required": false; }; }, {}, never, never, false, never>;
@@ -3498,14 +3601,16 @@ declare class ConfigFieldNodeComponent {
     translate?: (key: string) => string;
     toggleVisible: EventEmitter<void>;
     toggleMandatory: EventEmitter<void>;
+    colSpanChange: EventEmitter<number>;
     get displayLabel(): string;
+    onColSpanInput(value: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfigFieldNodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfigFieldNodeComponent, "lib-config-field-node", never, { "field": { "alias": "field"; "required": true; }; "translate": { "alias": "translate"; "required": false; }; }, { "toggleVisible": "toggleVisible"; "toggleMandatory": "toggleMandatory"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfigFieldNodeComponent, "lib-config-field-node", never, { "field": { "alias": "field"; "required": true; }; "translate": { "alias": "translate"; "required": false; }; }, { "toggleVisible": "toggleVisible"; "toggleMandatory": "toggleMandatory"; "colSpanChange": "colSpanChange"; }, never, never, false, never>;
 }
 
 declare class FormFieldConfigurationModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<FormFieldConfigurationModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<FormFieldConfigurationModule, [typeof FormFieldConfigurationComponent, typeof ConfigSectionNodeComponent, typeof ConfigFieldNodeComponent], [typeof i2$1.CommonModule], [typeof FormFieldConfigurationComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<FormFieldConfigurationModule, [typeof FormFieldConfigurationComponent, typeof ConfigSectionNodeComponent, typeof ConfigFieldNodeComponent], [typeof i2$1.CommonModule, typeof i5$1.DragDropModule], [typeof FormFieldConfigurationComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<FormFieldConfigurationModule>;
 }
 
@@ -3517,6 +3622,11 @@ declare class FormFieldConfigurationModule {
  * clone, so `applyTreeToSchema` simply walks the tree and assigns the node state
  * onto those references — there is no positional re-matching, which keeps it robust
  * against ROWs, nested groups, and mixed leaf/section children.
+ *
+ * Field order is a plain property of the schema — there is no separate `sequence`
+ * field. Reordering rewrites the schema's own children array in place, so render
+ * order (which simply follows array order, as it always has) reflects the
+ * configurator's choices with no extra sorting logic anywhere else.
  */
 declare class ConfigSchemaTreeService {
     /**
@@ -3526,8 +3636,9 @@ declare class ConfigSchemaTreeService {
     parseSchema(schema: FormSchema): ConfigSectionNode[];
     /**
      * Write the current tree state back onto the schema the nodes reference.
-     * Sets isEnabled/visible/disabled for visibility and required for mandatory.
-     * Hidden fields always emit required: false ("mandatory only if visible").
+     * Sets isEnabled/visible/disabled for visibility, required for mandatory, and
+     * colSpan; and physically reorders each section's own children array to match
+     * the tree's current field order.
      */
     applyTreeToSchema(sections: ConfigSectionNode[]): void;
     private _buildSections;
@@ -3536,6 +3647,13 @@ declare class ConfigSchemaTreeService {
     private _buildField;
     private _isSection;
     private _applySection;
+    /**
+     * Rewrites `slots` in place so its leaf-field entries follow `fields`' current
+     * order. Section entries (GROUP/SUBFIELDS) keep their original array position —
+     * only the leaf fields move. Safe to call whenever `slots` contains no ROW
+     * (guaranteed by the `reorderable` flag the caller checks).
+     */
+    private _reorderChildren;
     private _applyField;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfigSchemaTreeService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ConfigSchemaTreeService>;
@@ -3588,6 +3706,12 @@ interface TableColumn {
     visible?: boolean;
     /** Configurator-only flag: when true the column can never be hidden (toggle is replaced by a lock). */
     lockVisibility?: boolean;
+    /**
+     * Explicit display order (lower renders first). Columns without a sequence keep their
+     * original relative order, placed after any columns that do have one. Set automatically
+     * by the column configurator when the user reorders columns.
+     */
+    sequence?: number;
 }
 interface TableFilter {
     key: string;
@@ -3818,6 +3942,8 @@ declare class TableColumnConfigurationService {
     loadConfig(config: TableConfig): void;
     /** Toggle a column's visibility. Locked columns are ignored. */
     toggleColumnVisible(index: number): void;
+    /** Move a column from `previousIndex` to `currentIndex` (drag-and-drop reorder). */
+    reorderColumn(previousIndex: number, currentIndex: number): void;
     /**
      * Produce the updated config. Writes the current node state onto the working
      * clone and returns a fresh deep clone (safe to hand to the host / persist).
@@ -3825,6 +3951,12 @@ declare class TableColumnConfigurationService {
      */
     buildUpdatedConfig(): TableConfig | null;
     private _buildColumn;
+    /**
+     * Orders columns by `sequence` (ascending). Columns without a `sequence` keep their
+     * original relative order, placed after any columns that do have one — so configs that
+     * never set `sequence` come back untouched (stable sort).
+     */
+    private _sortBySequence;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableColumnConfigurationService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<TableColumnConfigurationService>;
 }
@@ -3833,15 +3965,17 @@ declare class TableColumnConfigurationService {
  * Table Column Configuration
  * --------------------------
  * Renders a compact list of a table config's columns, each with a **visibility**
- * toggle. Intended to be embedded inside a `cc-confirmation-modal` on a host page
- * ("Configure columns").
+ * toggle and a drag handle for **reordering**. Intended to be embedded inside a
+ * `cc-confirmation-modal` on a host page ("Configure columns").
  *
  * Pass a `TableConfig` via `[config]`. The input is deep-cloned, so it is never
- * mutated. When the user confirms, call `getUpdatedConfig()` to read back the
- * modified config (isEnabled/visible flags updated per column).
+ * mutated. Columns load pre-sorted by `sequence` (if set); columns without a
+ * `sequence` keep their original relative order. When the user confirms, call
+ * `getUpdatedConfig()` to read back the modified config (isEnabled/visible flags
+ * and `sequence` updated per column, in the new order).
  *
  * Columns carrying `lockVisibility: true` cannot be hidden — their toggle is
- * replaced by a lock icon.
+ * replaced by a lock icon. They can still be dragged to reorder.
  *
  * @example
  * ```html
@@ -3869,6 +4003,8 @@ declare class TableColumnConfigurationComponent implements OnChanges {
      */
     getUpdatedConfig(): TableConfig | null;
     onToggleVisible(index: number): void;
+    /** Drag-and-drop reorder. Written back as `sequence` on each column by `getUpdatedConfig()`. */
+    onDrop(event: CdkDragDrop<ConfigColumnNode[]>): void;
     trackByIndex(index: number): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<TableColumnConfigurationComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TableColumnConfigurationComponent, "lib-table-column-configuration", never, { "config": { "alias": "config"; "required": true; }; "translate": { "alias": "translate"; "required": false; }; "showLegend": { "alias": "showLegend"; "required": false; }; }, {}, never, never, false, never>;
@@ -3891,7 +4027,7 @@ declare class ConfigColumnNodeComponent {
 
 declare class TableColumnConfigurationModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<TableColumnConfigurationModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<TableColumnConfigurationModule, [typeof TableColumnConfigurationComponent, typeof ConfigColumnNodeComponent], [typeof i2$1.CommonModule], [typeof TableColumnConfigurationComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<TableColumnConfigurationModule, [typeof TableColumnConfigurationComponent, typeof ConfigColumnNodeComponent], [typeof i2$1.CommonModule, typeof i5$1.DragDropModule], [typeof TableColumnConfigurationComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<TableColumnConfigurationModule>;
 }
 
@@ -4903,6 +5039,12 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
     private calculateStickyPositions;
     private toTitleCase;
     get columnCount(): number;
+    /**
+     * Orders `config.columns` by their `sequence` value (ascending). Columns without a
+     * `sequence` are left in their original relative order, placed after any columns that
+     * do have one — so configs that never set `sequence` are left untouched (stable sort).
+     */
+    private sortColumnsBySequence;
     /**
      * Filters out actions/action-items that are either explicitly disabled via
      * `isEnabled: false` or hidden for the given row by their `visibleWhen` /
@@ -5178,6 +5320,13 @@ interface HierarchyCfg {
     nodes: Record<string, any>;
     branchSubType: string;
     showLoader: boolean;
+    /** Passed straight through onto every generated level's DROPDOWN optionConfig — same shape as
+     *  optionConfig.searchConfig documented in smart-form.md. Lets a large flat MDM level (e.g.
+     *  hundreds of districts) be searched instead of scrolled through in full. */
+    searchConfig?: any;
+    /** Passed straight through onto every generated level's DROPDOWN optionConfig — same shape as
+     *  optionConfig.pagination documented in smart-form.md (loadMore/infiniteScroll). */
+    pagination?: any;
 }
 
 declare class ValidationUtils {
@@ -5228,4 +5377,4 @@ declare class SnackbarModule {
 }
 
 export { AlertComponent, AlertModule, ButtonComponent, ButtonDropdownComponent, ButtonDropdownModule, ButtonModule, CheckboxComponent, ClickOutsideDirective, ConfigColumnNodeComponent, ConfigFieldNodeComponent, ConfigSchemaTreeService, ConfigSectionNodeComponent, ConfigurableFormComponent, configurableForm_examples_d as ConfigurableFormExamples, ConfigurableFormModule, ConfirmationModalComponent, ConfirmationModalModule, DEFAULT_ITEMS_PER_PAGE, DEFAULT_PAGE_SIZE_OPTIONS, DEFAULT_SIDE_NAV_TOOLTIP_POSITION, DatepickerComponent, DropdownComponent, ExpressionService, FieldConfigurationService, FieldConfiguratorComponent, FieldSelectionComponent, FilterComponent, FilterModule, FilterSidebarComponent, FilterSidebarModule, FilterTableSelectorComponent, FilterTableSelectorModule, FormBuilderModule, FormComponentsModule, FormFieldConfigurationComponent, FormFieldConfigurationModule, InputComponent, MaterialModule, NAV_ORIENTATION_DEFAULT, NAV_VARIANT_DEFAULT, NavComponent, NavModule, PAGINATION_THEME_DARK, PAGINATION_THEME_DEFAULT, PaginationComponent, PaginationModule, RadioComponent, SearchComponent, SharedUiModule, SideNavComponent, SideNavModule, SmartFormComponent, SmartFormController, smartForm_examples_d as SmartFormExamples, SmartFormModule, SmartTableComponent, SmartTableModule, SnackbarComponent, SnackbarModule, SnackbarService, StringUtils, SummaryCardComponent, SummaryCardModule, TableColumnConfigurationComponent, TableColumnConfigurationModule, TableColumnConfigurationService, TimePickerComponent, TimePickerModule, TimeWheelPanelComponent, ToggleComponent, ValidationUtils, appendBaseUrlRecursively, clearLocalStorage, clearSessionStorage, getLocalStorageItem, getSessionStorageItem, removeLocalStorageItem, removeSessionStorageItem, setLocalStorageItem, setSessionStorageItem, translateConfig };
-export type { ActionVisibility, AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ConfigColumnNode, ConfigFieldNode, ConfigSectionNode, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldConfig, FieldEventPayload, FieldType, FilterChangeEvent, FilterConfig, FilterItem, FilterItemType, FilterOutput, FilterPanelConfig, FilterParamMap, FilterSearchConfig, FilterSidebarChangeEvent, FilterSidebarConfig, FilterSidebarOutput, FilterTableConfig, FilterTableSelectorConfig, FormConfig, FormField, FormOption, FormSchema, FormSection, GeneratedConfig, HierarchyCfg, IconInput, InputConfig, InputLabels, InputType, JsonFieldConfig, JsonFormConfig, KeyType, LengthConstraint, LocationConfig, NavItem, NavStyleConfig, NestedStringConfig, NumberConfig, OptionConfig, OptionDTO, OptionItem, PaginationConfig, PaginationLabels, PhoneConfig, QueryParamsConfig, RadioConfig, RadioLabels, RadioOption, RangeConfig, RatingConfig, SearchConfig, SearchLabels, SectionConfig, SelectionConfig, SideNavItem, SideNavSection, SideNavStyleConfig, SnackbarConfig, SnackbarVariant, StepperConfig, SubmitConfig, SuffixActionIcon, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, TimeMode, TimePickerConfig, TimePickerLabels, TimePickerVariant, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules, VisibilityRule };
+export type { ActionVisibility, AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ConfigColumnNode, ConfigFieldNode, ConfigSectionNode, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldColSpanPayload, FieldConfig, FieldEventPayload, FieldReorderPayload, FieldType, FilterChangeEvent, FilterConfig, FilterItem, FilterItemType, FilterOutput, FilterPanelConfig, FilterParamMap, FilterSearchConfig, FilterSidebarChangeEvent, FilterSidebarConfig, FilterSidebarOutput, FilterTableConfig, FilterTableSelectorConfig, FormConfig, FormField, FormOption, FormSchema, FormSection, GeneratedConfig, HierarchyCfg, IconInput, InputConfig, InputLabels, InputType, JsonFieldConfig, JsonFormConfig, KeyType, LengthConstraint, LocationConfig, NavItem, NavStyleConfig, NestedStringConfig, NumberConfig, OptionConfig, OptionDTO, OptionItem, PaginationConfig, PaginationLabels, PhoneConfig, QueryParamsConfig, RadioConfig, RadioLabels, RadioOption, RangeConfig, RatingConfig, SearchConfig, SearchLabels, SectionConfig, SelectionConfig, SideNavItem, SideNavSection, SideNavStyleConfig, SnackbarConfig, SnackbarVariant, StepperConfig, SubmitConfig, SuffixActionIcon, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, TimeMode, TimePickerConfig, TimePickerLabels, TimePickerVariant, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules, VisibilityRule };

package/package.json

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