@openg2p/registry-widgets 1.1.3-dev.1 → 1.1.4-dev.1

package/dist/index.d.ts

@@ -3,22 +3,10 @@ import * as _reduxjs_toolkit from '@reduxjs/toolkit';
 import * as redux_thunk from 'redux-thunk';
 import * as redux from 'redux';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1, { ReactNode } from 'react';
-import * as i18next from 'i18next';
-import i18next__default from 'i18next';
-export { default as i18n } from 'i18next';
+import React$1, { ComponentType, ReactNode } from 'react';
 
-/**
- * Widget data path can be a string (single path) or object (multi-path)
- */
 type WidgetDataPath = string | Record<string, string>;
-/**
- * Data source types
- */
 type DataSourceType = 'static' | 'api' | 'schema';
-/**
- * Static data source configuration
- */
 interface StaticDataSource {
     type: 'static';
     options: Array<{
@@ -26,20 +14,10 @@ interface StaticDataSource {
         label: string;
     }>;
 }
-/**
- * Data source request handler - called by widgets to request data from host application
- * Host application handles all API calls, formatting, CORS, auth, etc.
- */
-type DataSourceRequestHandler = (service: string, // Service mnemonic (e.g., "master-data", "geo-service")
-endpoint: string, // Endpoint/operation name (e.g., "get_g2p_geo_level_values", "get_g2p_programs")
-method: string, // HTTP method ("GET", "POST", etc.)
-params: Record<string, any>, // Request parameters (level_id, parent_level_value_id, etc.)
-options?: {
+/** Called by widgets to request data; the host app handles API calls, formatting, CORS, and auth. */
+type DataSourceRequestHandler = (service: string, endpoint: string, method: string, params: Record<string, any>, options?: {
     headers?: Record<string, string>;
 }) => Promise<any>;
-/**
- * API data source configuration
- */
 interface ApiDataSource$1 {
     type: 'api';
     service: string;
@@ -50,44 +28,63 @@ interface ApiDataSource$1 {
     labelKey?: string;
     params?: Record<string, any>;
     [key: string]: any;
+    /** @deprecated Use `service` + `endpoint` instead. */
     url?: string;
 }
-/**
- * Schema reference data source configuration
- */
 interface SchemaDataSource {
     type: 'schema';
     path: string;
     valueKey?: string;
     labelKey?: string;
 }
+interface GeoHierarchyDataSource {
+    type: 'api';
+    service: string;
+    method?: 'POST';
+    /** e.g. get-all-g2p-geo-levels (matches /api/master-data/...) */
+    levelsEndpoint: string;
+    /** e.g. geo-level-values (matches /api/master-data/...) */
+    valuesEndpoint: string;
+}
 type DataSource = StaticDataSource | ApiDataSource$1 | SchemaDataSource;
-/**
- * Allowed character types for text input
- */
+/** Configuration for a single upload slot inside a `docs` widget. */
+interface DocsWidgetDocumentConfig {
+    'document-key': string;
+    'document-label': string;
+    'document-required'?: boolean;
+    'document-accept': string;
+    'document-max-size': number;
+}
+interface GeoHierarchyLayout {
+    distribution?: 'fixed';
+    /** Explicit levels-per-column counts, e.g. [3, 3] for a 6-level hierarchy in 2 columns. */
+    columns?: number[];
+    /**
+     * How many section columns this hierarchy occupies (1–3), matching panel-column-span.
+     * Levels are distributed evenly across these columns.
+     * When omitted, derived from level count: ≤3 → 1, 4–5 → 2, ≥6 → 3.
+     */
+    columnSpan?: number;
+    columnIndex?: number;
+}
+/** Optional read path for edit-mode hydration (defaults from widget-data-path). */
+type GeoHierarchyDataPath = string | {
+    value: string;
+    hierarchy: string;
+};
+declare function isGeoHierarchyDataSource(dataSource: unknown): dataSource is GeoHierarchyDataSource;
 type CharacterType = 'any' | 'alphabetic' | 'alphanumeric' | 'numeric' | 'numeric-decimal' | 'custom';
-/**
- * Case control options
- */
 type CaseControl = 'none' | 'lowercase' | 'uppercase' | 'capitalize';
-/**
- * Input mask configuration
- */
 interface InputMask {
     pattern: string;
     type?: 'static' | 'phone' | 'national-id' | 'custom';
     placeholder?: string;
 }
-/**
- * Validation type options for common patterns
- */
 type ValidationType = 'email' | 'phone' | 'url';
-/**
- * Validation configuration
- */
 interface WidgetValidation {
     required?: boolean;
     validationType?: ValidationType;
+    /** Pattern takes precedence over `validationType` when both are set. */
     pattern?: string;
     patternMessage?: string;
     minLength?: number;
@@ -97,29 +94,11 @@ interface WidgetValidation {
     custom?: string;
     zodSchema?: z.ZodSchema;
 }
-/**
- * Numeric type options
- */
 type NumericType = 'integer' | 'decimal';
-/**
- * Rounding mode for decimal numbers
- */
 type RoundingMode = 'round' | 'truncate';
-/**
- * Text alignment options
- */
 type TextAlign = 'left' | 'right';
-/**
- * Boolean representation options
- */
 type BooleanRepresentation = 'true-false' | 'yes-no' | 'on-off' | 'custom';
-/**
- * Boolean control type options
- */
 type BooleanControlType = 'checkbox' | 'radio' | 'toggle';
-/**
- * Format configuration
- */
 interface WidgetFormat {
     dateFormat?: string;
     currency?: string;
@@ -145,7 +124,6 @@ interface WidgetFormat {
     booleanControlType?: BooleanControlType;
     booleanTrueLabel?: string;
     booleanFalseLabel?: string;
-    /** Label for null/unset when allowUnset (radio, toggle); defaults to "Not set" */
     booleanUnsetLabel?: string;
     allowUnset?: boolean;
     layout?: 'vertical' | 'horizontal' | 'grid';
@@ -155,33 +133,21 @@ interface WidgetFormat {
     dateTimeFormat?: string;
     dateTimeConstraint?: 'any' | 'past-only' | 'future-only';
 }
-/**
- * Condition operators
- */
 type ConditionOperator = 'equals' | 'notEquals' | 'notEmpty' | 'empty' | 'greaterThan' | 'lessThan' | 'contains' | 'notContains';
-/**
- * Condition configuration
- */
 interface WidgetCondition {
     field: string;
     operator: ConditionOperator;
     value?: any;
 }
-/**
- * Single conditional action rule (used in widget-data-options.actions list)
- */
 interface WidgetOptionRule {
     action: 'show' | 'hide' | 'enable' | 'disable' | 'require';
     condition?: WidgetCondition;
 }
-/**
- * Widget options for conditional behavior
- */
 interface WidgetOptions {
-    /** @deprecated Prefer `actions` for multiple sequential rules */
+    /**`actions` for multiple sequential rules. */
     action?: 'show' | 'hide' | 'enable' | 'disable' | 'require';
     condition?: WidgetCondition;
-    /** Sequential rules: enable/disable/show/hide first, then require */
+    /** Apply enable/disable/show/hide first, then require. */
     actions?: WidgetOptionRule[];
     minDate?: string;
     maxDate?: string;
@@ -192,9 +158,6 @@ interface WidgetOptions {
     showCalendar?: boolean;
     [key: string]: any;
 }
-/**
- * Widget cascade configuration
- */
 interface WidgetCascadeConfig {
     listenTo: string[];
     onEvent?: 'widget:change' | 'widget:blur' | 'widget:focus' | 'widget:reload' | 'widget:clear';
@@ -203,18 +166,6 @@ interface WidgetCascadeConfig {
     debounce?: number;
     throttle?: number;
 }
-/**
- * Widget geo configuration
- */
-interface WidgetGeoConfig {
-    level: string;
-    isLastLevel: boolean;
-    parentWidgetId: string | null;
-    levelMnemonic?: string;
-}
-/**
- * Base widget configuration
- */
 interface BaseWidgetConfig {
     widget: string;
     'widget-type'?: 'input' | 'layout' | 'table' | 'group';
@@ -233,7 +184,13 @@ interface BaseWidgetConfig {
     'widget-data-helptext'?: string;
     'widget-data-tooltip'?: string;
     'widget-cascade'?: WidgetCascadeConfig;
-    'widget-geo-config'?: WidgetGeoConfig;
+    /** Column layout for geo-hierarchy widget (e.g. 3 levels per column). */
+    'widget-geo-layout'?: GeoHierarchyLayout;
+    /**
+     * Read path for geo_code_hierarchy_json (hydrate/display).
+     * To also persist draft hierarchy on edit/save, use object widget-data-path with a hierarchy key.
+     */
+    'widget-geo-hierarchy-path'?: string;
     widgets?: BaseWidgetConfig[];
     'widget-item'?: BaseWidgetConfig;
     'widget-data-columns'?: Array<{
@@ -259,12 +216,11 @@ interface BaseWidgetConfig {
     'widget-data-add-label'?: string;
     'widget-data-collapsed'?: boolean;
     'widget-column-span'?: number;
+    'widget-total-docs'?: number;
+    documents?: DocsWidgetDocumentConfig[];
     _comment?: string;
     [key: string]: any;
 }
-/**
- * Panel configuration - a layout container that can contain nested panels or widgets
- */
 interface PanelConfig {
     'panel-id': string;
     'panel-orientation'?: 'horizontal' | 'vertical';
@@ -272,9 +228,6 @@ interface PanelConfig {
     panels?: PanelConfig[];
     widgets?: BaseWidgetConfig[];
 }
-/**
- * Supporting document configuration
- */
 interface SupportingDocumentConfig {
     'document-data-path': string;
     'document-type'?: string;
@@ -283,9 +236,6 @@ interface SupportingDocumentConfig {
     'document-accept'?: string;
     'document-max-size'?: number;
 }
-/**
- * Section configuration
- */
 interface SectionConfig {
     'section-id': string;
     'section-title'?: string;
@@ -296,19 +246,10 @@ interface SectionConfig {
     'section-supporting-documents'?: SupportingDocumentConfig[];
     panels: PanelConfig[];
 }
-/**
- * UI Schema structure
- */
 interface UISchema {
     sections: SectionConfig[];
 }
-/**
- * Widget value type
- */
 type WidgetValue = any;
-/**
- * Widget state in Redux store
- */
 interface WidgetState {
     values: Record<string, WidgetValue>;
     errors: Record<string, string[]>;
@@ -316,9 +257,6 @@ interface WidgetState {
     loading: Record<string, boolean>;
     dataSources: Record<string, any[]>;
 }
-/**
- * Widget context value
- */
 interface WidgetContextValue {
     widgetId: string;
     value: WidgetValue;
@@ -331,21 +269,12 @@ interface WidgetContextValue {
     getFieldValue: (path: string) => any;
     getDataSource: (widgetId: string) => any[];
 }
-/**
- * Custom widget render function
- */
 type WidgetRenderFunction = (config: BaseWidgetConfig, context: WidgetContextValue) => React.ReactNode;
-/**
- * Widget registry entry
- */
 interface WidgetRegistryEntry {
     widget: string;
     component: React.ComponentType<any> | WidgetRenderFunction;
     defaultProps?: Record<string, any>;
 }
-/**
- * API adapter function type
- */
 type ApiAdapter = (url: string, options: {
     method?: string;
     headers?: Record<string, string>;
@@ -397,7 +326,6 @@ interface UseBaseWidgetOptions {
 declare const useBaseWidget: (options: UseBaseWidgetOptions) => {
     widgetId: string;
     value: any;
-    geoDisplayLabel: string | undefined;
     formattedValue: any;
     error: string[];
     touched: boolean;
@@ -419,11 +347,6 @@ declare const useBaseWidget: (options: UseBaseWidgetOptions) => {
     config: BaseWidgetConfig;
 };
 
-/**
- * Widget Event Bus
- * Provides a publish/subscribe mechanism for widget communication
- * Supports debounce and throttle for performance optimization
- */
 type WidgetEventType = 'widget:change' | 'widget:blur' | 'widget:focus' | 'widget:reload' | 'widget:clear';
 interface WidgetEvent {
     type: WidgetEventType;
@@ -435,35 +358,15 @@ type EventHandler = (event: WidgetEvent) => void | Promise<void>;
 declare class WidgetEventBus {
     private subscriptions;
     private throttleTimers;
-    /**
-     * Subscribe to an event type
-     * @param eventType The type of event to listen to
-     * @param handler The handler function
-     * @param options Debounce/throttle options
-     * @returns Unsubscribe function
-     */
     subscribe(eventType: WidgetEventType, handler: EventHandler, options?: {
         debounce?: number;
         throttle?: number;
     }): () => void;
-    /**
-     * Publish an event
-     * @param event The event to publish
-     */
     publish(event: WidgetEvent): void;
-    /**
-     * Execute handler with debounce/throttle support
-     */
     private executeHandler;
-    /**
-     * Clear all subscriptions
-     */
     clear(): void;
 }
 
-/**
- * Hook to access the widget event bus from context
- */
 declare const useWidgetEventBus: () => WidgetEventBus | null;
 
 interface UseWidgetCascadeOptions {
@@ -477,65 +380,29 @@ interface UseWidgetCascadeOptions {
  */
 declare const useWidgetCascade: (options: UseWidgetCascadeOptions) => void;
 
-interface UseGeoWidgetCascadeOptions {
-    config: BaseWidgetConfig;
-    dataSourceRequestHandler?: DataSourceRequestHandler;
-    values: Record<string, any>;
-}
-/**
- * Hook for geo widget cascade functionality
- * Handles geo hierarchy building and cascade behavior
- */
-declare const useGeoWidgetCascade: (options: UseGeoWidgetCascadeOptions) => void;
-
 interface WidgetRendererProps extends Omit<UseBaseWidgetOptions, 'config'> {
     config: BaseWidgetConfig;
-    defaultComponent?: React$1.ComponentType<any>;
+    defaultComponent?: ComponentType<any>;
 }
 declare const WidgetRenderer: ({ config, dataSourceRequestHandler: propDataSourceRequestHandler, schemaData: propSchemaData, onValueChange, defaultComponent, }: WidgetRendererProps) => react_jsx_runtime.JSX.Element | null;
 
-/**
- * Theme color tokens for the widget library.
- * All properties are optional — omitted values fall back to built-in defaults.
- *
- * Default palette derived from OpenG2P brand colours:
- *   Gold #F5BB1A · Orange #F07B1A · Purple #88498F
- *   Grey #C4C4C4 · Dark Navy #011627 · Light Grey #F6F6F6
- */
 interface WidgetThemeColors {
-    /** Main brand colour (default: #F5BB1A — Gold) */
     primary?: string;
-    /** Darker brand accent (default: #F07B1A — Orange) */
     primaryDark?: string;
-    /** Light brand tint for backgrounds (default: #FBE6AA — Gold +62.5%) */
     primaryLight?: string;
-    /** Secondary accent used in edit-mode borders (default: #EE7C22 — Orange 0% shade) */
     primaryAccent?: string;
-    /** Standard border colour (default: #C4C4C4 — Grey) */
     border?: string;
-    /** Lighter border colour (default: #E4E4E4 — Grey +62.5%) */
     borderLight?: string;
-    /** Default background (default: #FFFFFF) */
     background?: string;
-    /** Alternate/muted background (default: #F6F6F6 — Light Grey) */
     backgroundAlt?: string;
-    /** Primary text colour (default: #011627 — Dark Navy) */
     text?: string;
-    /** Secondary / muted text colour (default: #727474 — Grey -37.5%) */
     textMuted?: string;
-    /** Success green (default: #16A34A) */
     success?: string;
-    /** Success dark green (default: #047857) */
     successDark?: string;
-    /** Light success surface for badges / highlights (default: #D1FAE5) */
     successLight?: string;
-    /** Error / danger red (default: #B91C1C) */
     error?: string;
-    /** Light error surface for badges / highlights (default: #FEE2E2) */
     errorLight?: string;
-    /** Warning amber (default: #F59E0B) */
     warning?: string;
-    /** Info / link blue (default: #2563EB) */
     info?: string;
 }
 interface WidgetThemeSection {
@@ -543,11 +410,9 @@ interface WidgetThemeSection {
     borderColor?: string;
     backgroundColor?: string;
     titleColor?: string;
-    /** Horizontal-rule / divider colour between panels (default: primary) */
     dividerColor?: string;
 }
 interface WidgetThemePanel {
-    /** Vertical divider colour between side-by-side panels */
     dividerColor?: string;
     backgroundColor?: string;
 }
@@ -567,29 +432,17 @@ interface WidgetThemeWidget {
     inputBackground?: string;
     errorColor?: string;
     helpTextColor?: string;
-    /** Table: header row background (default: #F6F6F6) */
     tableHeaderBg?: string;
-    /** Table: header text colour (default: #727474) */
     tableHeaderColor?: string;
-    /** Table: body / cell background (default: #FFFFFF) */
     tableBodyBg?: string;
-    /** Table: outer border colour (default: #C4C4C4) */
     tableBorderColor?: string;
-    /** Table: row divider lines (default: #E4E4E4) */
     tableRowDividerColor?: string;
-    /** Table: background of a row being edited (default: #FBE6AA) */
     tableEditingRowBg?: string;
-    /** Table: background of a row marked for deletion (default: #FEE2E2) */
     tableDeletedRowBg?: string;
-    /** Table: empty-state text colour (default: #727474) */
     tableEmptyTextColor?: string;
-    /** Table: container border radius (default: 15px) */
     tableBorderRadius?: string;
 }
-/**
- * Top-level theme object accepted by `<WidgetProvider theme={…}>`.
- * Every field is optional — only supply what you want to override.
- */
+/** Top-level theme object accepted by `<WidgetProvider theme={…}>`. */
 interface WidgetTheme {
     colors?: WidgetThemeColors;
     section?: WidgetThemeSection;
@@ -597,9 +450,6 @@ interface WidgetTheme {
     button?: WidgetThemeButton;
     widget?: WidgetThemeWidget;
 }
-/**
- * Built-in default values (matches the original hardcoded colours).
- */
 declare const defaultTheme: Required<{
     colors: Required<WidgetThemeColors>;
     section: Required<WidgetThemeSection>;
@@ -607,26 +457,22 @@ declare const defaultTheme: Required<{
     button: Required<WidgetThemeButton>;
     widget: Required<WidgetThemeWidget>;
 }>;
-/**
- * Merge a user-supplied (partial) theme with the built-in defaults.
- */
 declare function resolveTheme(theme?: WidgetTheme): typeof defaultTheme;
 
 interface WidgetProviderProps {
     store?: WidgetStore;
     dataSourceRequestHandler?: DataSourceRequestHandler;
     schemaData?: Record<string, any>;
-    translate?: (key: string, options?: any) => string;
-    /** Optional theme object to override default colors and styles across all widgets. */
+    t?: (key: string, options?: any) => string;
     theme?: WidgetTheme;
     children: ReactNode;
 }
 declare const useWidgetContext: () => {
     dataSourceRequestHandler?: DataSourceRequestHandler;
     schemaData?: Record<string, any>;
-    translate?: (key: string, options?: any) => string;
+    t?: (key: string, options?: any) => string;
 };
-declare const WidgetProvider: ({ store, dataSourceRequestHandler, schemaData, translate, theme, children, }: WidgetProviderProps) => react_jsx_runtime.JSX.Element;
+declare const WidgetProvider: ({ store, dataSourceRequestHandler, schemaData, t, theme, children, }: WidgetProviderProps) => react_jsx_runtime.JSX.Element;
 
 interface PanelRendererProps {
     panel: PanelConfig;
@@ -635,28 +481,21 @@ interface PanelRendererProps {
     onValueChange?: UseBaseWidgetOptions['onValueChange'];
     isEditMode?: boolean;
 }
-/**
- * Renders a panel with its nested panels or widgets
- *
- * Panels can contain:
- * - Nested panels (for layout composition)
- * - Widgets (for actual form inputs/controls)
- */
 declare const PanelRenderer: ({ panel, dataSourceRequestHandler, schemaData, onValueChange, isEditMode, }: PanelRendererProps) => react_jsx_runtime.JSX.Element;
 
+interface SectionChanges {
+    section_id?: string;
+    section_register_id?: string;
+    records: unknown[];
+    files?: unknown[];
+    image?: File | null;
+}
+
 type SectionMode = 'RegistryView' | 'CRView' | 'IntakeForm';
-/** Form controls passed to host via onFormReady. Allows host to validate and get all section data (e.g. on Submit). */
 interface SectionsFormHandle {
-    /** Validate all sections. Returns true if valid, false otherwise. */
     validate(): Promise<boolean>;
-    /** Get raw form data from store for all sections (no validation). */
     getFormData(): Record<string, unknown>;
-    /** Validate all sections. If valid, returns SectionChanges[]; if invalid, throws. */
     validateAndGetData(): Promise<SectionChanges[]>;
-    /**
-     * Used for form save-draft functionality.
-     * Retrieves record and file changes without validation.
-     */
     getStructuredData(): SectionChanges[];
 }
 interface SectionsContainerProps {
@@ -668,33 +507,12 @@ interface SectionsContainerProps {
     onSectionSave?: (changes: SectionChanges) => Promise<void> | void;
     hideEditButton?: boolean;
     mode?: SectionMode;
-    /** IntakeForm mode: when true or undefined, sections are editable; when false, sections are readonly */
     isDraft?: boolean;
-    namespace?: string | ((sectionId: string, index: number) => string);
-    /** Called when a section's dirty (has unsaved changes) status changes. Only fires while the section is in edit mode. */
     onSectionDirtyChange?: (sectionId: string, isDirty: boolean) => void;
-    /** Called when the form is ready. Passes form controls (validate, getFormData, validateAndGetData) so the host can trigger submit from its own button. */
     onFormReady?: (handle: SectionsFormHandle) => void;
 }
-/**
- * Container component that renders multiple sections
- *
- * Layout behavior:
- * - Uses CSS Grid for proper alignment
- * - Each grid column = 200px (one vertical panel width)
- * - Sections span columns based on their total vertical panel count
- * - All sections align to the same grid, ensuring right-side alignment
- * - Handles nested structure: multiple horizontal panels, each with multiple vertical panels
- */
-declare const SectionsContainer: ({ sections, dataSourceRequestHandler: propDataSourceRequestHandler, schemaData, onValueChange, className, onSectionSave, hideEditButton, mode, isDraft, namespace, onSectionDirtyChange, onFormReady, }: SectionsContainerProps) => react_jsx_runtime.JSX.Element;
+declare const SectionsContainer: ({ sections, dataSourceRequestHandler: propDataSourceRequestHandler, schemaData, onValueChange, className, onSectionSave, hideEditButton, mode, isDraft, onSectionDirtyChange, onFormReady, }: SectionsContainerProps) => react_jsx_runtime.JSX.Element;
 
-interface SectionChanges {
-    section_id?: string;
-    section_register_id?: string;
-    records: unknown[];
-    files?: unknown[];
-    image?: File | null;
-}
 interface SectionRendererProps {
     section: SectionConfig;
     dataSourceRequestHandler?: UseBaseWidgetOptions['dataSourceRequestHandler'];
@@ -704,47 +522,24 @@ interface SectionRendererProps {
     onSectionSave?: (changes: SectionChanges) => Promise<void> | void;
     hideEditButton?: boolean;
     mode?: SectionMode;
-    namespace?: string;
     changeRequestType?: 'new' | 'old';
     showChangeRequestLabel?: boolean;
     dbSectionId?: string;
     sectionRegisterId?: string;
-    /** Called when the section's dirty (has unsaved changes) status changes. Only fires while in edit mode. */
     onSectionDirtyChange?: (sectionId: string, isDirty: boolean) => void;
-    /** IntakeForm mode: 0-based index of this section within the form */
     sectionIndex?: number;
-    /** IntakeForm mode: total number of sections in the form */
     sectionCount?: number;
-    /** IntakeForm mode: index of the currently expanded section (null = all collapsed) */
     expandedSectionIndex?: number | null;
-    /** IntakeForm mode: called when user requests to expand a section (e.g. clicks accordion header) */
     onExpandSection?: (index: number) => void;
-    /** IntakeForm mode: called when section save completes successfully (collapse current, expand next) */
     onSectionSaveSuccess?: (index: number) => void;
-    /** IntakeForm mode: called when user clicks Previous (collapse current, expand previous) */
     onPreviousSection?: (index: number) => void;
-    /** IntakeForm mode: when true or undefined, sections are editable; when false, sections are readonly */
     isDraft?: boolean;
-    /**
-     * IntakeForm mode: when true the accordion header is clickable so the user can open/close this
-     * section freely. False (default) locks the header — navigation is only via Next/Previous.
-     * SectionsContainer sets this to true for every visited section plus the one immediately after.
-     */
     isAccessible?: boolean;
-    /** RegistryView: called when this section enters or exits edit mode. Used by SectionsContainer to enforce single-edit. */
     onEditModeChange?: (sectionId: string, editing: boolean) => void;
-    /** RegistryView: when true, forces this section out of edit mode (another section took over). */
     forceExitEdit?: boolean;
 }
-/**
- * Renders a section with its panels
- *
- * Layout behavior:
- * - Section width is based on max 3 panels (or more on high resolution)
- * - Panels wrap when they exceed available width
- * - Sections can sit side-by-side if there's space
- */
-declare const SectionRenderer: ({ section, dataSourceRequestHandler: propDataSourceRequestHandler, schemaData, onValueChange, gridColumnSpan, onSectionSave, hideEditButton, mode, namespace, changeRequestType, showChangeRequestLabel, dbSectionId, sectionRegisterId, onSectionDirtyChange, sectionIndex, sectionCount, expandedSectionIndex, onExpandSection, onSectionSaveSuccess, onPreviousSection, isDraft, isAccessible, onEditModeChange, forceExitEdit, }: SectionRendererProps) => react_jsx_runtime.JSX.Element;
+
+declare const SectionRenderer: ({ section, dataSourceRequestHandler: propDataSourceRequestHandler, schemaData, onValueChange, gridColumnSpan, onSectionSave, hideEditButton, mode, changeRequestType, showChangeRequestLabel, dbSectionId, sectionRegisterId, onSectionDirtyChange, sectionIndex, expandedSectionIndex, onExpandSection, onSectionSaveSuccess, onPreviousSection, isDraft, isAccessible, onEditModeChange, forceExitEdit, }: SectionRendererProps) => react_jsx_runtime.JSX.Element;
 
 interface SectionBuilderProps {
     initialSection?: SectionConfig;
@@ -820,574 +615,76 @@ interface PropertyEditorProps {
  */
 declare const PropertyEditor: React$1.FC<PropertyEditorProps>;
 
-/**
- * Register all default/generic widgets
- * This is called automatically when the package is imported
- */
 declare const registerDefaultWidgets: () => void;
 
 declare class WidgetRegistry {
     private widgets;
-    /**
-     * Register a widget
-     */
     register(entry: WidgetRegistryEntry): void;
-    /**
-     * Register multiple widgets
-     */
     registerMany(entries: WidgetRegistryEntry[]): void;
-    /**
-     * Get widget entry
-     */
     get(widgetName: string): WidgetRegistryEntry | undefined;
-    /**
-     * Check if widget is registered
-     */
     has(widgetName: string): boolean;
-    /**
-     * Get all registered widgets
-     */
     getAll(): WidgetRegistryEntry[];
-    /**
-     * Unregister a widget
-     */
     unregister(widgetName: string): boolean;
-    /**
-     * Clear all widgets
-     */
     clear(): void;
-    /**
-     * Render widget component
-     */
     render(config: BaseWidgetConfig, context: any, defaultComponent?: React$1.ComponentType<any>): React$1.ReactNode;
 }
 declare const widgetRegistry: WidgetRegistry;
 
-/**
- * Generic text input widget with advanced features
- * Supports all text-based inputs via configuration (text, email, password, number, tel, url, etc.)
- *
- * Features:
- * - Allowed character types (any, alphabetic, alphanumeric, numeric, numeric-decimal, custom)
- * - Case control (none, lowercase, uppercase, capitalize)
- * - Length constraints with live character counter
- * - Regular expression validation with custom messages
- * - Input masking (static and dynamic)
- * - Placeholder text with i18n support
- *
- * Usage in schema:
- * {
- *   "widget": "text",
- *   "widget-type": "input",
- *   "widget-label": "Field Label",
- *   "widget-id": "fieldId",
- *   "widget-data-path": "person.name",
- *   "widget-data-format": {
- *     "inputType": "email",
- *     "characterType": "alphanumeric",
- *     "caseControl": "lowercase",
- *     "mask": {
- *       "pattern": "XXX-XXX-XXXX",
- *       "type": "static"
- *     },
- *     "showCharCounter": true
- *   },
- *   "widget-data-validation": {
- *     "validationType": "email",  // Predefined type: "email", "phone", or "url"
- *     // OR use custom pattern:
- *     // "pattern": "^[a-z0-9]+$",
- *     // "patternMessage": "Only lowercase alphanumeric characters allowed",
- *     "minLength": 5,
- *     "maxLength": 20
- *   },
- *   "widget-required": true,
- *   "widget-data-placeholder": "Enter your value"
- * }
- */
 interface TextInputWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const TextInputWidget: ({ config }: TextInputWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Number input widget with advanced numeric features
- *
- * Features:
- * - Numeric type (integer/decimal, signed/unsigned)
- * - Decimal precision control (0-6 places, rounding/truncation)
- * - Value range validation (min/max)
- * - Regular expression validation with custom messages
- * - Maximum character limit
- * - Default value (numeric, applied when field has no existing data)
- * - Numeric masking and formatting (thousand/decimal separators)
- * - Text alignment (right by default, configurable)
- * - Key input restrictions
- *
- * Usage in schema:
- * {
- *   "widget": "number",
- *   "widget-type": "input",
- *   "widget-label": "Amount",
- *   "widget-id": "amount",
- *   "widget-data-path": "transaction.amount",
- *   "widget-data-format": {
- *     "numericType": "decimal",
- *     "decimalPlaces": 2,
- *     "roundingMode": "round",
- *     "thousandSeparator": ",",
- *     "decimalSeparator": ".",
- *     "textAlign": "right",
- *     "allowSigned": true,
- *     "formatOnBlur": true
- *   },
- *   "widget-data-validation": {
- *     "min": 0,
- *     "max": 10000,
- *     "pattern": "^[0-9]+(\\.[0-9]{1,2})?$",
- *     "patternMessage": "Invalid number format"
- *   },
- *   "widget-data-default": 0,
- *   "widget-required": true,
- *   "widget-data-placeholder": "Enter amount"
- * }
- */
 interface NumberInputWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const NumberInputWidget: ({ config }: NumberInputWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Boolean widget with advanced features
- *
- * Features:
- * - Boolean representation (true/false, yes/no, on/off, custom labels)
- * - Control type (checkbox, radio buttons, toggle/switch)
- * - Default value (true, false, unset/null)
- * - Required vs optional
- * - Layout options (horizontal/vertical)
- *
- * Usage in schema:
- * {
- *   "widget": "boolean",
- *   "widget-type": "input",
- *   "widget-label": "Is Married",
- *   "widget-id": "married",
- *   "widget-data-path": "person.married",
- *   "widget-data-default": false,
- *   "widget-data-format": {
- *     "booleanRepresentation": "yes-no",
- *     "booleanControlType": "radio",
- *     "allowUnset": true
- *   },
- *   "widget-data-validation": {},
- *   "widget-required": false,
- *   "widget-orientation": "horizontal"
- * }
- */
 interface BooleanWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const BooleanWidget: ({ config }: BooleanWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Date input widget with advanced features
- *
- * Features:
- * - Configurable date format (DD/MM/YYYY, MM/DD/YYYY, YYYY-MM-DD, etc.)
- * - Default value (none / today)
- * - Date constraints (minDate, maxDate, any/past only/future only)
- * - Relative bounds via minDateField / maxDateField (e.g. end date >= start date)
- * - Required vs optional
- * - Input method (date picker / manual / hybrid)
- * - Placeholder text
- * - Read-only & disabled
- * - Canonical stored format (ISO 8601)
- *
- * Usage in schema:
- * {
- *   "widget": "date",
- *   "widget-type": "input",
- *   "widget-label": "Date of Birth",
- *   "widget-id": "dob",
- *   "widget-data-path": "person.dob",
- *   "widget-data-default": "today",
- *   "widget-data-format": {
- *     "dateFormat": "DD/MM/YYYY",
- *     "inputMethod": "hybrid",
- *     "dateConstraint": "past-only"
- *   },
- *   "widget-data-options": {
- *     "minDate": "1900-01-01",
- *     "maxDate": "today"
- *     "minDateField": "register.start_date",
- *     "minDateMessage": "Date of birth must be on or after 1900-01-01"
- *     "maxDateField": "register.end_date",
- *     "maxDateMessage": "Date of birth must be on or before today"
- *   },
- *   "widget-data-validation": {},
- *   "widget-required": true,
- *   "widget-data-placeholder": "DD/MM/YYYY"
- * }
- */
 interface DateInputWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const DateInputWidget: ({ config }: DateInputWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * DateTime input widget with advanced features
- *
- * Features:
- * - Configurable datetime format (DD/MM/YYYY HH:mm, MM/DD/YYYY HH:mm:ss, etc.)
- * - Default value (none / now)
- * - DateTime constraints (minDateTime, maxDateTime, any/past only/future only)
- * - Required vs optional
- * - Input method (datetime picker / manual / hybrid)
- * - Placeholder text
- * - Read-only & disabled
- * - Canonical stored format (ISO 8601 with time)
- *
- * Usage in schema:
- * {
- *   "widget": "datetime",
- *   "widget-type": "input",
- *   "widget-label": "Appointment Time",
- *   "widget-id": "appointment",
- *   "widget-data-path": "appointment.datetime",
- *   "widget-data-default": "now",
- *   "widget-data-format": {
- *     "dateTimeFormat": "DD/MM/YYYY HH:mm",
- *     "inputMethod": "picker",
- *     "dateTimeConstraint": "future-only"
- *   },
- *   "widget-data-options": {
- *     "minDateTime": "2024-01-01T00:00",
- *     "maxDateTime": "now"
- *   },
- *   "widget-data-validation": {},
- *   "widget-required": true,
- *   "widget-data-placeholder": "DD/MM/YYYY HH:mm"
- * }
- */
 interface DateTimeInputWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const DateTimeInputWidget: ({ config }: DateTimeInputWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Select/Dropdown widget with data source support
- *
- * Usage in schema:
- * {
- *   "widget": "select",
- *   "widget-type": "input",
- *   "widget-label": "Country",
- *   "widget-id": "country",
- *   "widget-data-path": "address.country",
- *   "widget-data-source": {
- *     "type": "static" | "api" | "schema",
- *     ...
- *   }
- * }
- */
 interface SelectWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const SelectWidget: ({ config }: SelectWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Radio button widget with advanced features
- *
- * Features:
- * - Static list of options
- * - Dynamic options (from API / dataset)
- * - Ordered options (preserve order or sort)
- * - Option label & value separation
- * - Display label
- * - Stored value
- * - Default selection (pre-selected option or unset)
- * - Required vs optional
- * - Layout options (vertical, horizontal, grid)
- *
- * Usage in schema:
- * {
- *   "widget": "radio",
- *   "widget-type": "input",
- *   "widget-label": "Gender",
- *   "widget-id": "gender",
- *   "widget-data-path": "person.gender",
- *   "widget-data-default": "male",
- *   "widget-data-source": {
- *     "type": "static",
- *     "options": [
- *       { "value": "male", "label": "Male" },
- *       { "value": "female", "label": "Female" },
- *       { "value": "other", "label": "Other" }
- *     ]
- *   },
- *   "widget-data-format": {
- *     "layout": "vertical",
- *     "sortOptions": false
- *   },
- *   "widget-required": true
- * }
- */
 interface RadioWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const RadioWidget: ({ config }: RadioWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Checkbox widget with advanced features
- *
- * Features:
- * - Single checkbox (boolean) - when no data source
- * - Multiple checkboxes (array) - when data source provided
- * - Static list of options
- * - Dynamic options (from API / dataset)
- * - Ordered options (preserve order or sort)
- * - Option label & value separation
- * - Display label
- * - Stored value (array for multi-select)
- * - Default selection (pre-selected options or empty array)
- * - Required vs optional (at least one must be selected if required)
- * - Layout options (vertical, horizontal, grid)
- *
- * Usage in schema (single checkbox):
- * {
- *   "widget": "checkbox",
- *   "widget-type": "input",
- *   "widget-label": "I agree to terms",
- *   "widget-id": "agree",
- *   "widget-data-path": "form.agree",
- *   "widget-data-default": false
- * }
- *
- * Usage in schema (multiple checkboxes):
- * {
- *   "widget": "checkbox",
- *   "widget-type": "input",
- *   "widget-label": "Interests",
- *   "widget-id": "interests",
- *   "widget-data-path": "person.interests",
- *   "widget-data-default": ["sports"],
- *   "widget-data-source": {
- *     "type": "static",
- *     "options": [
- *       { "value": "sports", "label": "Sports" },
- *       { "value": "music", "label": "Music" },
- *       { "value": "reading", "label": "Reading" }
- *     ]
- *   },
- *   "widget-data-format": {
- *     "layout": "vertical",
- *     "sortOptions": false
- *   },
- *   "widget-required": true
- * }
- */
 interface CheckboxWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const CheckboxWidget: ({ config }: CheckboxWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * File input widget
- *
- * Usage in schema:
- * {
- *   "widget": "file",
- *   "widget-type": "input",
- *   "widget-label": "Upload Document",
- *   "widget-id": "document",
- *   "widget-data-path": "form.document",
- *   "widget-data-options": {
- *     "accept": ".pdf,.doc,.docx",
- *     "multiple": false,
- *     "maxSize": 5242880  // 5MB in bytes
- *   }
- * }
- */
 interface FileInputWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const FileInputWidget: ({ config }: FileInputWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Simple table widget for structured data
- *
- * Usage in schema:
- * {
- *   "widget": "simple-table",
- *   "widget-type": "table",
- *   "widget-label": "Education History",
- *   "widget-id": "educationHistory",
- *   "widget-data-path": "education.history",
- *   "widget-data-columns": [
- *     {
- *       "column-key": "degree",
- *       "widget-label": "Degree",
- *       "widget": "text",
- *       "widget-data-path": "degree"
- *     }
- *   ],
- *   "widget-data-operations": {
- *     "add": true,
- *     "remove": true,
- *     "edit": true
- *   }
- * }
- */
-interface SimpleTableWidgetProps {
-    config: BaseWidgetConfig;
-}
-declare const SimpleTableWidget: ({ config }: SimpleTableWidgetProps) => react_jsx_runtime.JSX.Element;
-
-/**
- * Array widget for simple repeating values
- *
- * Usage in schema:
- * {
- *   "widget": "array-widget",
- *   "widget-type": "group",
- *   "widget-label": "Skills",
- *   "widget-id": "skills",
- *   "widget-data-path": "person.skills",
- *   "widget-item": {
- *     "widget": "text",
- *     "widget-type": "input",
- *     "widget-label": "Skill"
- *   },
- *   "widget-data-add-label": "Add Skill",
- *   "widget-data-operations": {
- *     "add": true,
- *     "remove": true
- *   }
- * }
- */
-interface ArrayWidgetProps {
-    config: BaseWidgetConfig;
-}
-declare const ArrayWidget: ({ config }: ArrayWidgetProps) => react_jsx_runtime.JSX.Element | null;
-
-/**
- * Iterable accordion widget - expandable/collapsible container for widgets
- *
- * Usage in schema:
- * {
- *   "widget": "iterable-accordion",
- *   "widget-type": "group",
- *   "widget-label": "Advanced Options",
- *   "widget-id": "advancedOptions",
- *   "widget-data-path": "person.notes",
- *   "widget-data-collapsed": true,
- *   "widget-item": {
- *     "widget": "text",
- *     "widget-type": "input",
- *     "widget-label": "Additional Notes",
- *     "widget-id": "notes",
- *     ...
- *   }
- * }
- *
- * Note: widget-item can be any widget config. If it has nested widgets property,
- * those will be rendered as well.
- */
-interface IterableAccordionWidgetProps {
-    config: BaseWidgetConfig;
-}
-declare const IterableAccordionWidget: ({ config }: IterableAccordionWidgetProps) => react_jsx_runtime.JSX.Element | null;
-
-/**
- * Phone input widget with formatting
- *
- * Usage in schema:
- * {
- *   "widget": "phone",
- *   "widget-type": "input",
- *   "widget-label": "Phone",
- *   "widget-id": "phone",
- *   "widget-data-path": "person.phone",
- *   "widget-data-format": {
- *     "pattern": "(XXX) XXX-XXXX"
- *   }
- * }
- */
 interface PhoneInputWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const PhoneInputWidget: ({ config }: PhoneInputWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Currency input widget with formatting
- *
- * Usage in schema:
- * {
- *   "widget": "currency",
- *   "widget-type": "input",
- *   "widget-label": "Salary",
- *   "widget-id": "salary",
- *   "widget-data-path": "person.salary",
- *   "widget-data-format": {
- *     "currency": "USD",
- *     "locale": "en-US",
- *     "decimals": 2
- *   }
- * }
- */
-interface CurrencyInputWidgetProps {
-    config: BaseWidgetConfig;
-}
-declare const CurrencyInputWidget: ({ config }: CurrencyInputWidgetProps) => react_jsx_runtime.JSX.Element;
-
-/**
- * Display widget for readonly text display
- * Used for displaying information in a card layout
- */
 interface DisplayWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const DisplayWidget: ({ config }: DisplayWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Table widget with record-level inline editing
- *
- * Usage in schema:
- * {
- *   "widget": "table",
- *   "widget-type": "table",
- *   "widget-label": "Education History",
- *   "widget-id": "educationHistory",
- *   "widget-data-path": "education.history",
- *   "widget-data-columns": [
- *     {
- *       "column-key": "degree",
- *       "widget-label": "Degree",
- *       "widget": "text",
- *       "widget-type": "input",
- *       "widget-data-path": "degree",
- *       "widget-data-format": {...}
- *     },
- *     {
- *       "column-key": "year",
- *       "widget-label": "Year",
- *       "widget": "number",
- *       "widget-type": "input",
- *       "widget-data-path": "year"
- *     }
- *   ],
- *   "widget-data-operations": {
- *     "add": true,
- *     "remove": true,
- *     "edit": true
- *   },
- *   "widget-data-api": {
- *     "add": { "url": "/api/records", "method": "POST" },
- *     "edit": { "url": "/api/records/{id}", "method": "PUT" },
- *     "delete": { "url": "/api/records/{id}", "method": "DELETE" }
- *   }
- * }
- */
 interface TableWidgetProps {
     config: BaseWidgetConfig;
 }
@@ -1403,87 +700,11 @@ interface DialogTableWidgetProps {
  */
 declare const DialogTableWidget: ({ config }: DialogTableWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * Profile widget for displaying user identity information
- * Displays an image/avatar, display name, and ID in a vertical layout
- *
- * This is a display widget that groups related profile fields together.
- * Recommended widget-type: 'group' (groups related data fields)
- * Alternative: 'layout' (for display-only, no value storage)
- *
- * Configuration (Recommended - Multi-path data binding):
- *
- * - widget-data-path: Object with keys 'image', 'name', 'id' mapping to data paths
- *   Example: { "image": "person.photo", "name": "person.name", "id": "person.id" }
- *
- * Alternative (Individual path properties - fallback):
- * - widget-image-path?: string - Data path for the image/photo (e.g., "person.photo")
- * - widget-name-path?: string - Data path for the display name (e.g., "person.name")
- * - widget-id-path?: string - Data path for the ID (e.g., "person.id")
- *
- * Format options:
- * - widget-data-format: Optional format configuration
- *   - imageSize?: number - Size of the avatar image in pixels (default: 80)
- *   - nameColor?: string - Color for the name text (default: '#F07B1A')
- *   - showIdLabel?: boolean - Whether to show "ID :" label (default: true)
- *
- * Example usage (Recommended):
- * ```json
- * {
- *   "widget": "profile",
- *   "widget-type": "group",
- *   "widget-id": "user-profile",
- *   "widget-data-path": {
- *     "image": "photo",
- *     "name": "display_name",
- *     "id": "national_id"
- *   },
- *   "widget-data-format": {
- *     "imageSize": 80,
- *     "nameColor": "#F07B1A",
- *     "showIdLabel": true
- *   }
- * }
- * ```
- */
 interface ProfileWidgetProps {
     config: BaseWidgetConfig;
 }
 declare const ProfileWidget: ({ config }: ProfileWidgetProps) => react_jsx_runtime.JSX.Element;
 
-/**
- * TextArea widget for multi-line text input
- * Supports 2 rows by default with configurable rows
- *
- * Features:
- * - Multi-line text input
- * - Character type filtering (any, alphabetic, alphanumeric, numeric, etc.)
- * - Case control (none, lowercase, uppercase, capitalize)
- * - Length constraints with live character counter
- * - Regular expression validation with custom messages
- * - Placeholder text with i18n support
- *
- * Usage in schema:
- * {
- *   "widget": "textarea",
- *   "widget-type": "input",
- *   "widget-label": "Description",
- *   "widget-id": "description",
- *   "widget-data-path": "person.description",
- *   "widget-data-format": {
- *     "characterType": "any",
- *     "caseControl": "none",
- *     "showCharCounter": true,
- *     "rows": 2
- *   },
- *   "widget-data-validation": {
- *     "minLength": 10,
- *     "maxLength": 500
- *   },
- *   "widget-required": true,
- *   "widget-data-placeholder": "Enter description"
- * }
- */
 interface TextAreaWidgetProps {
     config: BaseWidgetConfig;
 }
@@ -1498,17 +719,6 @@ interface ScoresDisplayWidgetProps {
     config: BaseWidgetConfig;
     schemaData?: Record<string, unknown>;
 }
-/**
- * Scores Display Widget - full-width, view-only widget (list)
- *
- * Expected config (reference):
- * {
- *   "widget": "scores-display",
- *   "widget-type": "group",
- *   "widget-id": "record-scores",
- *   "widget-data-path": "scores"
- * }
- */
 declare const ScoresDisplayWidget: ({ config, schemaData: propSchemaData, }: ScoresDisplayWidgetProps) => react_jsx_runtime.JSX.Element;
 
 interface IdAuthenticationWidgetProps {
@@ -1526,6 +736,16 @@ interface MultiSelectWidgetProps {
 }
 declare const MultiSelectWidget: ({ config }: MultiSelectWidgetProps) => react_jsx_runtime.JSX.Element;
 
+interface GeoHierarchyWidgetProps {
+    config: BaseWidgetConfig;
+}
+declare const GeoHierarchyWidget: ({ config }: GeoHierarchyWidgetProps) => react_jsx_runtime.JSX.Element;
+
+interface DocsWidgetProps {
+    config: BaseWidgetConfig;
+}
+declare const DocsWidget: ({ config }: DocsWidgetProps) => react_jsx_runtime.JSX.Element;
+
 /**
  * Get value from object using dot notation path
  * Safely handles nested paths like "person.name" or "address.street.number"
@@ -1540,13 +760,6 @@ declare const setValueByPath: (obj: any, path: string, value: any) => any;
  * Parse widget data path (can be string or object)
  */
 declare const parseDataPath: (dataPath: string | Record<string, string> | undefined) => string | Record<string, string> | null;
-/**
- * Get value from widget state using data path
- */
-/**
- * Resolve a widget-id reference in Redux values.
- * Supports namespaced ids (e.g. "rv-section-0__region_code" when ref is "region_code").
- */
 declare const resolveWidgetIdValue: (values: Record<string, any>, ref: string) => any;
 declare const getWidgetValue: (values: Record<string, any>, dataPath: string | Record<string, string> | undefined, widgetId: string) => any;
 /**
@@ -1555,33 +768,15 @@ declare const getWidgetValue: (values: Record<string, any>, dataPath: string | R
 declare const setWidgetValue: (currentValues: Record<string, any>, dataPath: string | Record<string, string> | undefined, widgetId: string, value: any) => Record<string, any>;
 
 /**
- * Validate value against validation rules.
- *
- * @param skipRequired - When true, required-field checks are skipped (used by
- *   per-section Save/Next buttons so the user can move between sections without
- *   filling every mandatory field; only format/range checks still run).
+ * @param skipRequired - Skip required checks for per-section Save/Next navigation;
+ *   format and range validation still run.
  */
 declare const validateWidget: (value: any, validation: WidgetValidation | undefined, required?: boolean, skipRequired?: boolean) => string[];
-/**
- * Create Zod schema from validation config
- */
 declare const createZodSchema: (validation: WidgetValidation | undefined, required?: boolean) => z.ZodSchema | null;
 
-/**
- * Format date value
- */
 declare const formatDate: (value: any, format: WidgetFormat | undefined) => string;
-/**
- * Format currency value
- */
 declare const formatCurrency: (value: any, format: WidgetFormat | undefined) => string;
-/**
- * Format phone number
- */
 declare const formatPhone: (value: any, format: WidgetFormat | undefined) => string;
-/**
- * Format value based on widget format config
- */
 declare const formatValue: (value: any, format: WidgetFormat | undefined, widgetType?: string) => string;
 
 /**
@@ -1613,7 +808,7 @@ type ApiDataSource = Extract<DataSource, {
     type: 'api';
 }>;
 /** Return cached API options when already fetched (e.g. duplicate table cells). */
-declare function getCachedApiDataSource(dataSource: ApiDataSource, allValues: Record<string, any>, levelId?: string): any[] | undefined;
+declare function getCachedApiDataSource(dataSource: ApiDataSource, allValues: Record<string, any>): any[] | undefined;
 /**
  * Get static data source options
  */
@@ -1626,256 +821,42 @@ declare const getStaticDataSource: (dataSource: Extract<DataSource, {
  */
 declare const getApiDataSource: (dataSource: Extract<DataSource, {
     type: "api";
-}>, allValues: Record<string, any>, dataSourceRequestHandler: DataSourceRequestHandler, levelId?: string) => Promise<any[]>;
-/**
- * Get schema reference data source options
- */
+}>, allValues: Record<string, any>, dataSourceRequestHandler: DataSourceRequestHandler) => Promise<any[]>;
 declare const getSchemaDataSource: (dataSource: Extract<DataSource, {
     type: "schema";
 }>, schemaData: Record<string, any>) => any[];
-/**
- * Transform data source options to { value, label } format
- */
 declare const transformDataSourceOptions: (data: any[], valueKey?: string, labelKey?: string) => Array<{
     value: any;
     label: string;
 }>;
 
-/**
- * Filter input value based on allowed character type
- */
 declare const filterByCharacterType: (value: string, characterType?: CharacterType, customCharset?: string) => string;
-/**
- * Apply case transformation to text
- */
 declare const applyCaseControl: (value: string, caseControl?: CaseControl) => string;
-/**
- * Apply input mask to value
- */
 declare const applyMask: (value: string, mask: InputMask) => {
     displayValue: string;
     rawValue: string;
 };
-/**
- * Remove mask from value to get raw value
- */
 declare const removeMask: (value: string, mask: InputMask) => string;
 
-/**
- * Format number with thousand and decimal separators
- */
 declare const formatNumber: (value: number | string, format: WidgetFormat | undefined) => string;
-/**
- * Parse formatted number string to number
- */
 declare const parseNumber: (value: string, format: WidgetFormat | undefined) => number | null;
-/**
- * Apply decimal precision with rounding or truncation
- */
 declare const applyDecimalPrecision: (value: number, format: WidgetFormat | undefined) => number;
-/**
- * Validate numeric value against constraints
- */
 declare const validateNumericValue: (value: number | null, format: WidgetFormat | undefined, validation?: {
     min?: number;
     max?: number;
     pattern?: string;
     patternMessage?: string;
 }) => string[];
-/**
- * Check if a key is allowed for numeric input
- */
 declare const isAllowedKey: (key: string, format: WidgetFormat | undefined, currentValue: string, event?: React.KeyboardEvent<HTMLInputElement>) => boolean;
-/**
- * Calculate character count including separators and sign
- */
 declare const getFormattedNumberLength: (value: number | string | null, format: WidgetFormat | undefined) => number;
 declare const normalizeNumericDefault: (defaultValue: unknown, format: WidgetFormat | undefined) => number | null | undefined;
 
-/**
- * Geo Hierarchy Builder
- * Manages geo hierarchy state and builds hierarchy JSON structure
- */
-interface GeoLevelData {
-    level: string;
-    level_value_id: string;
-    level_value_mnemonic: string;
-}
-interface GeoLevelConfig {
-    level: string;
-}
-/**
- * Resolve the display value for a geo level widget.
- * When widgetId is explicitly set in Redux (including cleared undefined/null), do not
- * fall back to shared hierarchy dataPath — that stale path was keeping grandchildren visible.
- */
-declare function resolveGeoWidgetLevelValue(values: Record<string, any>, widgetId: string, dataPath: string | Record<string, string> | undefined, geoConfig: GeoLevelConfig): any;
-/**
- * Write the in-memory geo hierarchy builder state into Redux at the shared dataPath.
- */
-declare function applySharedGeoHierarchyToValues(baseValues: Record<string, any>, groupId: string, dataPath: string | Record<string, string> | undefined, widgetId: string): Record<string, any>;
-declare class GeoHierarchyBuilder {
-    private hierarchies;
-    /**
-     * Get or create hierarchy state for a group
-     */
-    private getHierarchy;
-    /**
-     * Add a level to the hierarchy
-     */
-    addLevel(level: string, level_value_id: string, level_value_mnemonic: string, groupId?: string): void;
-    /**
-     * Remove a level and all levels below it
-     */
-    removeLevelAndBelow(level: string, groupId?: string): void;
-    /**
-     * Build hierarchy JSON structure
-     */
-    buildHierarchyJson(groupId?: string): {
-        geo_lowest_level_value_id: string;
-        geo_code_hierarchy_json: {
-            hierarchy: Array<{
-                level: string;
-                level_value_id: string;
-                level_value_mnemonic: string;
-            }>;
-            lowest_level_value_id: string;
-        };
-    } | null;
-    /**
-     * Clear hierarchy for a group
-     */
-    clear(groupId?: string): void;
-    /**
-     * Clear all hierarchies
-     */
-    clearAll(): void;
-    /**
-     * Get current levels for a group
-     */
-    getLevels(groupId?: string): GeoLevelData[];
-}
-declare const geoHierarchyBuilder: GeoHierarchyBuilder;
-/** Sentinel written to Redux when a geo level is cleared by cascade (distinct from "never set"). */
-declare const GEO_LEVEL_CLEARED: null;
-interface GeoWidgetRegistration {
-    widgetId: string;
-    parentWidgetId: string | null;
-    level: string;
-    geoConfig: GeoLevelConfig;
-    dataPath: string;
-    groupId: string;
-}
-declare function registerGeoWidgetParent(widgetId: string, parentWidgetId: string | null): void;
-declare function unregisterGeoWidgetParent(widgetId: string): void;
-declare function registerGeoWidget(widgetId: string, geoConfig: GeoLevelConfig & {
-    parentWidgetId?: string | null;
-}, dataPath: string): void;
-declare function unregisterGeoWidget(widgetId: string): void;
-declare function orderGeoWidgetRegistrations(registrations: GeoWidgetRegistration[]): GeoWidgetRegistration[];
-/** Resolve display mnemonic from cached dropdown options, then stored hierarchy. */
-declare function createGeoLevelMnemonicResolver(values: Record<string, any>, dataSources: Record<string, Array<{
-    value: any;
-    label: string;
-}>>): (registration: GeoWidgetRegistration, valueId: string) => string | undefined;
-/** Rebuild group hierarchy from widget values in parent→child order; stop at first missing level. */
-declare function rebuildGeoHierarchyFromRegistrations(groupId: string, values: Record<string, any>, registrations: GeoWidgetRegistration[], resolveMnemonic?: (registration: GeoWidgetRegistration, valueId: string) => string | undefined): boolean;
-declare function collectGeoWidgetRegistrationsFromWidgets(widgets: Array<{
-    'widget-id': string;
-    'widget-data-path'?: string | Record<string, string>;
-    'widget-geo-config'?: GeoLevelConfig & {
-        parentWidgetId?: string | null;
-    };
-}>, namespace?: string): GeoWidgetRegistration[];
-/** Reconcile all geo groups in section values before save. */
-declare function reconcileGeoHierarchiesInValues(values: Record<string, any>, registrations: GeoWidgetRegistration[], dataSources?: Record<string, Array<{
-    value: any;
-    label: string;
-}>>): Record<string, any>;
-declare function getGeoWidgetRegistrationsInGroup(groupId: string): GeoWidgetRegistration[];
-/** True when changedWidgetId is any upstream geo parent of widgetId (not only immediate parent). */
-declare function isUpstreamGeoAncestor(changedWidgetId: string, widgetId: string, immediateParentWidgetId: string | null): boolean;
-/** Group id for geo widgets sharing the same register prefix (e.g. `{registerId}`). */
-declare function getGeoGroupId(dataPath: string | Record<string, string> | undefined): string;
-/**
- * Resolve the human-readable label for a geo level from persisted hierarchy JSON.
- * Used in readonly mode when API options are not loaded.
- */
-declare function resolveGeoWidgetLevelLabel(values: Record<string, any>, widgetId: string, dataPath: string | Record<string, string> | undefined, geoConfig: GeoLevelConfig): string | undefined;
-/** All registered geo widgets that are descendants of ancestorWidgetId. */
-declare function getGeoDescendantWidgetIds(ancestorWidgetId: string): string[];
-/** Seed in-memory builder from persisted hierarchy JSON (edit-mode rehydration). */
-declare function seedGeoHierarchyFromValues(values: Record<string, any>, dataPath: string | Record<string, string> | undefined, widgetId: string, groupId: string): void;
-/** Force-clear builder for a group, then seed from Redux/schema values (e.g. after Cancel). */
-declare function resetAndSeedGeoHierarchyFromValues(values: Record<string, any>, dataPath: string, widgetId: string, groupId: string): void;
-
 type ResolvedTheme = ReturnType<typeof resolveTheme>;
-/**
- * Access the resolved widget theme from any component inside `<WidgetProvider>`.
- *
- * ```tsx
- * const theme = useWidgetTheme();
- * // theme.colors.primary, theme.section.dividerColor, etc.
- * ```
- */
 declare function useWidgetTheme(): ResolvedTheme;
 
-/**
- * Initialize i18n for the widget library
- * Can be customized by passing custom resources or configuration
- *
- * If no resources are provided, it will attempt to automatically load translations
- * from the consuming project's locale directory.
- *
- * If options are provided and the default instance is already initialized,
- * creates a new i18n instance to avoid reinitialization issues.
- */
-declare const initI18n: (options?: {
-    resources?: Record<string, any>;
-    lng?: string;
-    fallbackLng?: string;
-    debug?: boolean;
-    loadPath?: string | string[];
-    autoLoad?: boolean;
-}) => Promise<i18next.i18n>;
-
-/**
- * Custom hook for widget translations
- * Provides translation function with widget-specific namespace and fallback support
- */
-declare const useWidgetTranslation: () => {
-    t: (keyOrString: string | undefined | null, options?: {
-        defaultValue?: string;
-        [key: string]: any;
-    }) => string;
-    translate: (keyOrString: string | undefined | null, options?: {
-        defaultValue?: string;
-        [key: string]: any;
-    }) => string;
-    translateConfig: (value: string | undefined | null, fallback?: string) => string;
-};
-
-/**
- * Recursively translate widget configuration using translation keys
- * This utility helps transform a schema with translation keys into translated strings
- *
- * @param widgetConfig - Widget configuration that may contain translation keys
- * @param translate - Translation function (from useWidgetTranslation or i18next)
- * @returns Translated widget configuration
- */
 declare const translateWidgetConfig: (widgetConfig: BaseWidgetConfig, translate: (key: string, options?: any) => string) => BaseWidgetConfig;
-/**
- * Recursively translate panel configuration
- */
 declare const translatePanelConfig: (panel: PanelConfig, translate: (key: string, options?: any) => string) => PanelConfig;
-/**
- * Translate entire UI Schema
- *
- * @param schema - UI Schema with potential translation keys
- * @param translate - Translation function
- * @returns Translated UI Schema
- */
 declare const translateUISchema: (schema: UISchema, translate: (key: string, options?: any) => string) => UISchema;
 
-export { ArrayWidget, BooleanWidget, CheckboxWidget, CurrencyInputWidget, DateInputWidget, DateTimeInputWidget, DialogTableWidget, DisplayWidget, FileInputWidget, GEO_LEVEL_CLEARED, HeaderSectionWidget, IdAuthenticationWidget, IterableAccordionWidget, JSONEditorPanel, MultiSelectWidget, NumberInputWidget, PanelRenderer, PhoneInputWidget, ProfileWidget, PropertyEditor, RadioWidget, RegisterLookupWidget, ScoresDisplayWidget, SectionBuilder, SectionRenderer, SectionTree, SectionsContainer, SelectWidget, SimpleTableWidget, TableWidget, TextAreaWidget, TextInputWidget, VisualBuilderPanel, WidgetEventBus, WidgetProvider, WidgetRenderer, applyCaseControl, applyDecimalPrecision, applyMask, applySharedGeoHierarchyToValues, collectGeoWidgetRegistrationsFromWidgets, createGeoLevelMnemonicResolver, createWidgetStore, createZodSchema, defaultTheme, evaluateCondition, evaluateWidgetConditions, filterByCharacterType, formatCurrency, formatDate, formatNumber, formatPhone, formatValue, geoHierarchyBuilder, getApiDataSource, getCachedApiDataSource, getFormattedNumberLength, getGeoDescendantWidgetIds, getGeoGroupId, getGeoWidgetRegistrationsInGroup, getSchemaDataSource, getStaticDataSource, getValueByPath, getWidgetValue, hasVisibilityRules, initI18n, isAllowedKey, isUpstreamGeoAncestor, normalizeNumericDefault, normalizeOptionRules, orderGeoWidgetRegistrations, parseDataPath, parseNumber, rebuildGeoHierarchyFromRegistrations, reconcileGeoHierarchiesInValues, registerDefaultWidgets, registerGeoWidget, registerGeoWidgetParent, removeMask, resetAll, resetAndSeedGeoHierarchyFromValues, resetWidget, resolveGeoWidgetLevelLabel, resolveGeoWidgetLevelValue, resolveTheme, resolveWidgetIdValue, seedGeoHierarchyFromValues, setDataSource, setError, setLoading, setTouched, setValue, setValueByPath, setValues, setWidgetValue, shouldEnableWidget, shouldRequireWidget, shouldShowWidget, transformDataSourceOptions, translatePanelConfig, translateUISchema, translateWidgetConfig, unregisterGeoWidget, unregisterGeoWidgetParent, useBaseWidget, useGeoWidgetCascade, useWidgetCascade, useWidgetContext, useWidgetEventBus, useWidgetTheme, useWidgetTranslation, validateNumericValue, validateWidget, widgetRegistry };
-export type { ApiAdapter, ApiDataSource$1 as ApiDataSource, BaseWidgetConfig, BooleanControlType, BooleanRepresentation, CaseControl, CharacterType, ConditionOperator, DataSource, DataSourceRequestHandler, DataSourceType, GeoLevelConfig, GeoLevelData, GeoWidgetRegistration, InputMask, NumericType, PanelConfig, RoundingMode, SchemaDataSource, SectionBuilderProps, SectionChanges, SectionConfig, SectionMode, SectionRendererProps, SectionsContainerProps, SectionsFormHandle, StaticDataSource, SupportingDocumentConfig, TextAlign, TreeNode, TreeNodeType, UISchema, UseBaseWidgetOptions, ValidationType, WidgetCascadeConfig, WidgetCondition, WidgetConditionState, WidgetContextValue, WidgetDataPath, WidgetDispatch, WidgetEvent, WidgetEventType, WidgetFormat, WidgetGeoConfig, WidgetOptionRule, WidgetOptions, WidgetRegistryEntry, WidgetRenderFunction, WidgetRootState, WidgetState, WidgetStore, WidgetTheme, WidgetThemeButton, WidgetThemeColors, WidgetThemePanel, WidgetThemeSection, WidgetThemeWidget, WidgetValidation, WidgetValue };
+export { BooleanWidget, CheckboxWidget, DateInputWidget, DateTimeInputWidget, DialogTableWidget, DisplayWidget, DocsWidget, FileInputWidget, GeoHierarchyWidget, HeaderSectionWidget, IdAuthenticationWidget, JSONEditorPanel, MultiSelectWidget, NumberInputWidget, PanelRenderer, PhoneInputWidget, ProfileWidget, PropertyEditor, RadioWidget, RegisterLookupWidget, ScoresDisplayWidget, SectionBuilder, SectionRenderer, SectionTree, SectionsContainer, SelectWidget, TableWidget, TextAreaWidget, TextInputWidget, VisualBuilderPanel, WidgetEventBus, WidgetProvider, WidgetRenderer, applyCaseControl, applyDecimalPrecision, applyMask, createWidgetStore, createZodSchema, defaultTheme, evaluateCondition, evaluateWidgetConditions, filterByCharacterType, formatCurrency, formatDate, formatNumber, formatPhone, formatValue, getApiDataSource, getCachedApiDataSource, getFormattedNumberLength, getSchemaDataSource, getStaticDataSource, getValueByPath, getWidgetValue, hasVisibilityRules, isAllowedKey, isGeoHierarchyDataSource, normalizeNumericDefault, normalizeOptionRules, parseDataPath, parseNumber, registerDefaultWidgets, removeMask, resetAll, resetWidget, resolveTheme, resolveWidgetIdValue, setDataSource, setError, setLoading, setTouched, setValue, setValueByPath, setValues, setWidgetValue, shouldEnableWidget, shouldRequireWidget, shouldShowWidget, transformDataSourceOptions, translatePanelConfig, translateUISchema, translateWidgetConfig, useBaseWidget, useWidgetCascade, useWidgetContext, useWidgetEventBus, useWidgetTheme, validateNumericValue, validateWidget, widgetRegistry };
+export type { ApiAdapter, ApiDataSource$1 as ApiDataSource, BaseWidgetConfig, BooleanControlType, BooleanRepresentation, CaseControl, CharacterType, ConditionOperator, DataSource, DataSourceRequestHandler, DataSourceType, DocsWidgetDocumentConfig, GeoHierarchyDataPath, GeoHierarchyDataSource, GeoHierarchyLayout, InputMask, NumericType, PanelConfig, RoundingMode, SchemaDataSource, SectionBuilderProps, SectionChanges, SectionConfig, SectionMode, SectionRendererProps, SectionsContainerProps, SectionsFormHandle, StaticDataSource, SupportingDocumentConfig, TextAlign, TreeNode, TreeNodeType, UISchema, UseBaseWidgetOptions, ValidationType, WidgetCascadeConfig, WidgetCondition, WidgetConditionState, WidgetContextValue, WidgetDataPath, WidgetDispatch, WidgetEvent, WidgetEventType, WidgetFormat, WidgetOptionRule, WidgetOptions, WidgetRegistryEntry, WidgetRenderFunction, WidgetRootState, WidgetState, WidgetStore, WidgetTheme, WidgetThemeButton, WidgetThemeColors, WidgetThemePanel, WidgetThemeSection, WidgetThemeWidget, WidgetValidation, WidgetValue };