Core initialization routine. Sets up the paging object, binds grid options, applies localization, and attaches pqGrid to the DOM.

Initializes the column visibility popup menu. Only executes if grid_columns_key is populated.

Hook called when row numbers change. Intended to be overridden to update UI tab badges (e.g., 'Notes (3)').

Returns the raw rowData object of the currently selected row. Returns null if none or multiple are selected.

Fetches the ID integer from the currently selected row. Used for syncing related tabs.

Extracts current column filters and sorting rules into a parameter object ready for Ajax transmission.

Programmatically selects a specific row index. Safely clamps to boundaries or triggers clear views if empty.

Forces a hard refresh of the grid. Aborts pending calls, clears data cache, resets paging, and fires a new request.

Bypasses remote protocol for a manual, one-time Ajax GET to fetch the entire dataset at once.

Callback executed by grid_load_once(). Populates the paging object and pushes data directly into local dataModel.

Internal utility used to programmatically trigger filter rules and force an immediate re-fetch.

Returns a dictionary mapping row IDs to their exact rowData objects for extremely fast memory lookups.

Standard column renderer. Trims strings and generates HTML title tooltips for hovering.

Safely digs into nested CUSTOM_FIELDS JSON object to extract and format custom string values.

Parses server UTC timestamps and formats them to the user's localized time zone settings.

Standard localized date renderer utilizing the global dateFormatter().

Automatically applies the user's currency symbol, decimal rules, and multiplier logic.

Click handler for the column gear icon. Positions and reveals the column visibility toggles.

Scans the active colModel and applies tick/blank icons to the column menu list accordingly.

Constructs the HTML DOM for the column toggle menu based on columns flagged with hh_optional: true.

Handles menu selections. Triggers grid resets or calculates visibility arrays. Automatically saves settings.

Takes array of desired visible columns, computes hidden array based on hh_optional, and applies to pqGrid.

Callback fired when a user drags to reorder a column. Extracts new layout and saves to profile.

Master assembler compiling all models into the final configuration object handed to pqGrid.

Generates Ajax payload (time, paging, deleted flag). Designed to be extended via _super().

Constructs the pqGrid dataModel object (GET/POST, URL routing, JSON type, success handlers).

Retrieves raw column model and cross-references against user's saved settings to reorder/hide columns.

Returns raw array of column definitions. Intended to be completely overridden by descendant widgets.

Utility to parse FIELD_DEFINITIONS and inject dynamically generated schemas for custom fields.

Generates the pqGrid sortModel based on the initial sort options provided.

Generates the pqGrid filterModel. Applies a 1000ms debounce timeout.

Generates the pqGrid focusModel. Disables individual cell focus outlines by default.

Callback executed as each row is drawn. Override to inject custom CSS classes based on row status.

Event hook triggered immediately whenever the internal paging tracker object is reset to page 0.

Returns the internal grid_paging tracker object (stores data chunks, total records, current page).

Fired when a user clicks a row. Immediately delegates to this.fill_details().

Fired on double click. Left empty by default, intended for overriding.

Master Ajax success interceptor. Calculates pagination math, caches lookups, and splices data into scroll buffer.

Memory management function to trim trailing empty placeholder rows if data exceeds totalRecords.

Fired before sorting. Hard-resets the pagination object to prevent page offset corruptions.

Fired before filtering. Caches focused filter input to seamlessly restore cursor focus after re-rendering.

Infinite scroll engine. Analyzes viewport to detect empty placeholder rows and triggers Ajax fetches.

Fires after DOM rendering completes. Forces row selection, executes fill_details(), restores focus.

Used in sequential page load mode. Pre-emptively checks bottom boundary to fetch next page.

Fired iteratively during scrolling. Empty hook for override.

Empty hook fired upon a right mouse click event on the grid.

Parses user currency and date formats to construct native Excel string formats for exports.

Requests export, applies custom row striping/headers, and triggers browser download.

Export callback to adjust visibility dynamically during export processing.

Export callback hook to manipulate header cell text/styling.

Export callback hook to apply Excel-specific data formatting (urls, math) before encoding.

Constructs a robust pqGrid filter dropdown object dynamically populated with the global depot list.

Constructs a standard filter dropdown object populated by the globally localized lang.statusValues array.

Constructs a generic dropdown filter object from any provided array of objects.

Stub hook. Fired whenever grid row selection changes to populate external forms or update UI states.

Scans the edit dialog to gather values for saving. Applies red border warnings. Returns payload.

Standard widget constructor. Adds base classes and kicks off the _init_sections() builder pipeline.

Master builder routine. Sequentially calls all other _init_* functions to construct DOM.

Loads required APIs or establishes initial object variables before DOM construction begins.

Empty hook designed for descendant widgets to inject extra build steps.

Empty hook intended purely for OOP customizations and third-party plugins.

Final step in pipeline. Triggers initial resize() and attaches ResizeObserver.

Creates master tabs container, mobile nav bar, and initializes jQuery UI tabs.

Constructs the mobile-only navigation bar with the hamburger icon toggle.

Injects standard list elements and div panes for Main, Todo, Notes, and Files tabs.

Duplicates horizontal tabs into a vertical .ui-menu popup for mobile navigation.

Assembles the contents of the main tab (buttons, body, custom fields).

Empty stub. Override to construct page-specific action buttons inside the main tab.

Empty stub. Override to build the primary layout inside the main tab.

Sets up context/popup menu and binds right-click (contextmenu) listener.

Populates the context menu with standard actions (New, Edit, Print, etc).

Master responsive reflow function. Adapts layout for header bars, converts adaptive buttons.

Fired when user switches tabs. Manages lazy-loading of Todo, Notes, and Files widgets.

Empty stub triggered when popup menu receives focus. Dynamically disables/enables items.

Hides active menus and triggers global openPrint() routine.

Hides active menus and triggers global send_email() routine.

Opens the system history log dialog for the currently selected record ID.

Returns configuration object defining the document scope required by Print and Email engines.

Safely returns the active document type, prioritizing options with a fallback to global.

Stub returning 0. Must be overridden to return database ID of selected row.

Stub returning null. Must be overridden to extract custom field values for display.

Widget constructor. Adds has_bottom_table class and initializes sections.

Overrides parent. Triggers _init_bottom_section() to construct the grid container.

Initializes the edit dialog and the column configuration gear menu.

Builds standard New, Edit, Delete, Refresh, and Columns buttons into main tab header.

Creates grid_container, appends it, and invokes _init_grid() to bind pqGrid.

Creates the jQuery UI Dialog infrastructure for editing records.

Empty stub intended to be overridden to inject HTML inputs into edit dialog DOM.

Appends a dynamic custom fields form block to edit dialog if configured.

Overrides mixin. Enforces backwards compatibility by appending explicit id to menu.

Reflows edit dialog dimensions and forces a visual refresh of underlying pqGrid.

Safe alias to trigger this.grid_refresh().

Toggles button states based on grid selection and syncs custom field views.

Fetches active grid filters and selected row ID to build print/email payload.

Click handler for the Refresh button. Calls refresh().

Click handler for the Menu button. Positions and displays context menu.

Click handler for the Show Deleted checkbox. Triggers full grid refresh.

Automatically toggles popup menu items with needs_selected class based on grid state.

Overrides mixin. Force-selects a row when the user right-clicks on it.

Fired when edit dialog opens. Injects contextual help page paths and triggers resize.

Fired when edit dialog closes. Restores original help page paths.

Dynamically recalculates edit dialog width against window boundary.

Click handler. Wipes data, applies 'New' title, and opens edit dialog.

Clears inputs, textareas, and selects inside dialog, wiping validation borders.

Click handler. Extracts selected row payload and routes to fill_edit_dlg().

Iterates over dialog DOM matching input name attributes to payload keys to pre-fill form.

Validates inputs and dispatches payload to options.save_filename via Ajax POST.

Ajax success callback. Interprets server response to update existing row or prepend new one.

Extracts the ID of the selected row to construct the deletion HTTP payload.

Prompts for user confirmation, then fires Ajax POST to options.delete_filename.

Ajax success callback. Physically removes deleted row from pqGrid's local cache.

Extracts specific custom field values from active grid row for display rendering.

Retrieves custom field value currently staged within edit dialog's data store.

Updates edit dialog's internal data store with newly manipulated custom field value.

Standard widget constructor. Adds base classes and kicks off the _init_sections() builder pipeline.

Master builder routine. Sequentially calls all other _init_* functions to construct DOM.

Loads required APIs or establishes initial object variables before DOM construction begins.

Empty hook designed for descendant widgets to inject extra build steps.

Empty hook intended purely for OOP customizations and third-party plugins.

Final step in pipeline. Triggers initial resize() and attaches ResizeObserver.

Creates master tabs container, mobile nav bar, and initializes jQuery UI tabs.

Constructs the mobile-only navigation bar with the hamburger icon toggle.

Injects standard list elements and div panes for Main, Todo, Notes, and Files tabs.

Duplicates horizontal tabs into a vertical .ui-menu popup for mobile navigation.

Assembles the contents of the main tab (buttons, body, custom fields).

Empty stub. Override to construct page-specific action buttons inside the main tab.

Empty stub. Override to build the primary layout inside the main tab.

Sets up context/popup menu and binds right-click (contextmenu) listener.

Populates the context menu with standard actions (New, Edit, Print, etc).

Master responsive reflow function. Adapts layout for header bars, converts adaptive buttons.

Fired when user switches tabs. Manages lazy-loading of Todo, Notes, and Files widgets.

Empty stub triggered when popup menu receives focus. Dynamically disables/enables items.

Hides active menus and triggers global openPrint() routine.

Hides active menus and triggers global send_email() routine.

Opens the system history log dialog for the currently selected record ID.

Returns configuration object defining the document scope required by Print and Email engines.

Safely returns the active document type, prioritizing options with a fallback to global.

Stub returning 0. Must be overridden to return database ID of selected row.

Stub returning null. Must be overridden to extract custom field values for display.

Core initialization routine. Sets up the paging object, binds grid options, applies localization, and attaches pqGrid to the DOM.

Initializes the column visibility popup menu. Only executes if grid_columns_key is populated.

Hook called when row numbers change. Intended to be overridden to update UI tab badges (e.g., 'Notes (3)').

Returns the raw rowData object of the currently selected row. Returns null if none or multiple are selected.

Fetches the ID integer from the currently selected row. Used for syncing related tabs.

Extracts current column filters and sorting rules into a parameter object ready for Ajax transmission.

Programmatically selects a specific row index. Safely clamps to boundaries or triggers clear views if empty.

Forces a hard refresh of the grid. Aborts pending calls, clears data cache, resets paging, and fires a new request.

Bypasses remote protocol for a manual, one-time Ajax GET to fetch the entire dataset at once.

Callback executed by grid_load_once(). Populates the paging object and pushes data directly into local dataModel.

Internal utility used to programmatically trigger filter rules and force an immediate re-fetch.

Returns a dictionary mapping row IDs to their exact rowData objects for extremely fast memory lookups.

Standard column renderer. Trims strings and generates HTML title tooltips for hovering.

Safely digs into nested CUSTOM_FIELDS JSON object to extract and format custom string values.

Parses server UTC timestamps and formats them to the user's localized time zone settings.

Standard localized date renderer utilizing the global dateFormatter().

Automatically applies the user's currency symbol, decimal rules, and multiplier logic.

Click handler for the column gear icon. Positions and reveals the column visibility toggles.

Scans the active colModel and applies tick/blank icons to the column menu list accordingly.

Constructs the HTML DOM for the column toggle menu based on columns flagged with hh_optional: true.

Handles menu selections. Triggers grid resets or calculates visibility arrays. Automatically saves settings.

Takes array of desired visible columns, computes hidden array based on hh_optional, and applies to pqGrid.

Callback fired when a user drags to reorder a column. Extracts new layout and saves to profile.

Master assembler compiling all models into the final configuration object handed to pqGrid.

Generates Ajax payload (time, paging, deleted flag). Designed to be extended via _super().

Constructs the pqGrid dataModel object (GET/POST, URL routing, JSON type, success handlers).

Retrieves raw column model and cross-references against user's saved settings to reorder/hide columns.

Returns raw array of column definitions. Intended to be completely overridden by descendant widgets.

Utility to parse FIELD_DEFINITIONS and inject dynamically generated schemas for custom fields.

Generates the pqGrid sortModel based on the initial sort options provided.

Generates the pqGrid filterModel. Applies a 1000ms debounce timeout.

Generates the pqGrid focusModel. Disables individual cell focus outlines by default.

Callback executed as each row is drawn. Override to inject custom CSS classes based on row status.

Event hook triggered immediately whenever the internal paging tracker object is reset to page 0.

Returns the internal grid_paging tracker object (stores data chunks, total records, current page).

Fired when a user clicks a row. Immediately delegates to this.fill_details().

Fired on double click. Left empty by default, intended for overriding.

Master Ajax success interceptor. Calculates pagination math, caches lookups, and splices data into scroll buffer.

Memory management function to trim trailing empty placeholder rows if data exceeds totalRecords.

Fired before sorting. Hard-resets the pagination object to prevent page offset corruptions.

Fired before filtering. Caches focused filter input to seamlessly restore cursor focus after re-rendering.

Infinite scroll engine. Analyzes viewport to detect empty placeholder rows and triggers Ajax fetches.

Fires after DOM rendering completes. Forces row selection, executes fill_details(), restores focus.

Used in sequential page load mode. Pre-emptively checks bottom boundary to fetch next page.

Fired iteratively during scrolling. Empty hook for override.

Empty hook fired upon a right mouse click event on the grid.

Parses user currency and date formats to construct native Excel string formats for exports.

Requests export, applies custom row striping/headers, and triggers browser download.

Export callback to adjust visibility dynamically during export processing.

Export callback hook to manipulate header cell text/styling.

Export callback hook to apply Excel-specific data formatting (urls, math) before encoding.

Constructs a robust pqGrid filter dropdown object dynamically populated with the global depot list.

Constructs a standard filter dropdown object populated by the globally localized lang.statusValues array.

Constructs a generic dropdown filter object from any provided array of objects.

Stub hook. Fired whenever grid row selection changes to populate external forms or update UI states.

Scans the edit dialog to gather values for saving. Applies red border warnings. Returns payload.

Widget constructor. Adds hh-framework_grid_categories_page class and resets timeout buffers.

Overrides parent builder. Checks USE_CATEGORY_TREE to execute tab or tree builder before grid.

Calls parent finalizer to bind resize observers.

Constructs horizontal jQuery UI Tabs container for flat category filtering.

Constructs side panel and initializes specialized pqGrid formatted as selectable checkbox tree.

Appends 'Categories' management tab to top navigation alongside standard tabs.

Intercepts tab changes. Lazy-loads categories_edit sub-widget if Categories tab selected.

Extends parent reflow to calculate dynamic dimensions for active category selector.

Calculates total width of category list elements for horizontal scrolling.

Adjusts top positioning of category tree panel when viewport drops below 880px.

Toggles directional arrow icon on mobile category slide-out bar based on visibility.

Fired when node is checked. Applies 500ms debounce before grid data refresh.

Appends selected Tab ID or JSON array of checked Tree IDs to grid's Ajax payload.

Defines specialized column model required for rendering Category Tree's pqGrid.

Intercepts Ajax response to dynamically rebuild Category Tabs if headings are present.

Rebuilds category tree data from global heading_data and restores previously checked nodes.

Extracts checked nodes from Category Tree and formats into JSON string for HTTP transmission.

Widget constructor. Adds has_bottom_table class and initializes sections.

Overrides parent. Triggers _init_bottom_section() to construct the grid container.

Initializes the edit dialog and the column configuration gear menu.

Builds standard New, Edit, Delete, Refresh, and Columns buttons into main tab header.

Creates grid_container, appends it, and invokes _init_grid() to bind pqGrid.

Creates the jQuery UI Dialog infrastructure for editing records.

Empty stub intended to be overridden to inject HTML inputs into edit dialog DOM.

Appends a dynamic custom fields form block to edit dialog if configured.

Overrides mixin. Enforces backwards compatibility by appending explicit id to menu.

Reflows edit dialog dimensions and forces a visual refresh of underlying pqGrid.

Safe alias to trigger this.grid_refresh().

Toggles button states based on grid selection and syncs custom field views.

Fetches active grid filters and selected row ID to build print/email payload.

Click handler for the Refresh button. Calls refresh().

Click handler for the Menu button. Positions and displays context menu.

Click handler for the Show Deleted checkbox. Triggers full grid refresh.

Automatically toggles popup menu items with needs_selected class based on grid state.

Overrides mixin. Force-selects a row when the user right-clicks on it.

Fired when edit dialog opens. Injects contextual help page paths and triggers resize.

Fired when edit dialog closes. Restores original help page paths.

Dynamically recalculates edit dialog width against window boundary.

Click handler. Wipes data, applies 'New' title, and opens edit dialog.

Clears inputs, textareas, and selects inside dialog, wiping validation borders.

Click handler. Extracts selected row payload and routes to fill_edit_dlg().

Iterates over dialog DOM matching input name attributes to payload keys to pre-fill form.

Validates inputs and dispatches payload to options.save_filename via Ajax POST.

Ajax success callback. Interprets server response to update existing row or prepend new one.

Extracts the ID of the selected row to construct the deletion HTTP payload.

Prompts for user confirmation, then fires Ajax POST to options.delete_filename.

Ajax success callback. Physically removes deleted row from pqGrid's local cache.

Extracts specific custom field values from active grid row for display rendering.

Retrieves custom field value currently staged within edit dialog's data store.

Updates edit dialog's internal data store with newly manipulated custom field value.

Widget constructor. Adds custom classes and triggers build sequence.

Master builder invoking all sub-initialization methods.

Pre-flight hook for APIs.

Customizations hook for descendant extensions.

OOP customizations hook for third-party plugins.

Final requirements. Forces resize computation.

Configures CSS grid template rules and calls button/content builders.

Constructs the button bar (New, Edit, Delete, Refresh).

Builds content area directly beneath buttons and above grid.

Appends grid_container and invokes pqGrid mixin initializer.

Attaches jQuery UI Resizable handle if include_resize option is true.

Builds right-click context menu and assigns selection handlers.

Sets up jQuery UI Dialog for editing records.

Stub for injecting form inputs into edit dialog.

Injects custom fields form block if type is specified.

Populates context menu items.

Mixes in main_id and del flags into Ajax payload.

Double click handler mapping to edit_btn_click().

Intercepts option changes. Triggers auto-refresh if main_id changes.

Fires grid refresh, or clears data if main_id is 0.

Resizes dialogs and visually reflows pqGrid.

Refresh button click handler.

Context menu button click handler.

Show/hide deleted checkbox handler.

Routes params to global openPrint().

Routes params to global send_email().

Enables/disables popup menu items dynamically.

Returns current active document type.

Extracts custom field value for display.

Returns payload parameters for print/email routing.

Toggles button states based on row selection and main_id presence.

Edit dialog opened handler. Sets help pages.

Edit dialog closed handler.

Resizes edit dialog bounded by edit_dlg_max_width.

New button clicked. Clears form and opens dialog.

Empties edit dialog inputs for fresh record.

Edit button clicked. Loads selection to dialog.

Fills edit dialog inputs matching rowData keys.

Validates inputs and dispatches Ajax save.

Applies saved data to grid (update or addRow).

Gets delete parameters containing selected ID.

Delete button clicked. Confirms and dispatches Ajax.

Processes local grid deletion post-success.

Stages custom field edits in dialog data store.

Retrieves staged custom field value.

Core initialization routine. Sets up the paging object, binds grid options, applies localization, and attaches pqGrid to the DOM.

Initializes the column visibility popup menu. Only executes if grid_columns_key is populated.

Hook called when row numbers change. Intended to be overridden to update UI tab badges (e.g., 'Notes (3)').

Returns the raw rowData object of the currently selected row. Returns null if none or multiple are selected.

Fetches the ID integer from the currently selected row. Used for syncing related tabs.

Extracts current column filters and sorting rules into a parameter object ready for Ajax transmission.

Programmatically selects a specific row index. Safely clamps to boundaries or triggers clear views if empty.

Forces a hard refresh of the grid. Aborts pending calls, clears data cache, resets paging, and fires a new request.

Bypasses remote protocol for a manual, one-time Ajax GET to fetch the entire dataset at once.

Callback executed by grid_load_once(). Populates the paging object and pushes data directly into local dataModel.

Internal utility used to programmatically trigger filter rules and force an immediate re-fetch.

Returns a dictionary mapping row IDs to their exact rowData objects for extremely fast memory lookups.

Standard column renderer. Trims strings and generates HTML title tooltips for hovering.

Safely digs into nested CUSTOM_FIELDS JSON object to extract and format custom string values.

Parses server UTC timestamps and formats them to the user's localized time zone settings.

Standard localized date renderer utilizing the global dateFormatter().

Automatically applies the user's currency symbol, decimal rules, and multiplier logic.

Click handler for the column gear icon. Positions and reveals the column visibility toggles.

Scans the active colModel and applies tick/blank icons to the column menu list accordingly.

Constructs the HTML DOM for the column toggle menu based on columns flagged with hh_optional: true.

Handles menu selections. Triggers grid resets or calculates visibility arrays. Automatically saves settings.

Takes array of desired visible columns, computes hidden array based on hh_optional, and applies to pqGrid.

Callback fired when a user drags to reorder a column. Extracts new layout and saves to profile.

Master assembler compiling all models into the final configuration object handed to pqGrid.

Generates Ajax payload (time, paging, deleted flag). Designed to be extended via _super().

Constructs the pqGrid dataModel object (GET/POST, URL routing, JSON type, success handlers).

Retrieves raw column model and cross-references against user's saved settings to reorder/hide columns.

Returns raw array of column definitions. Intended to be completely overridden by descendant widgets.

Utility to parse FIELD_DEFINITIONS and inject dynamically generated schemas for custom fields.

Generates the pqGrid sortModel based on the initial sort options provided.

Generates the pqGrid filterModel. Applies a 1000ms debounce timeout.

Generates the pqGrid focusModel. Disables individual cell focus outlines by default.

Callback executed as each row is drawn. Override to inject custom CSS classes based on row status.

Event hook triggered immediately whenever the internal paging tracker object is reset to page 0.

Returns the internal grid_paging tracker object (stores data chunks, total records, current page).

Fired when a user clicks a row. Immediately delegates to this.fill_details().

Fired on double click. Left empty by default, intended for overriding.

Master Ajax success interceptor. Calculates pagination math, caches lookups, and splices data into scroll buffer.

Memory management function to trim trailing empty placeholder rows if data exceeds totalRecords.

Fired before sorting. Hard-resets the pagination object to prevent page offset corruptions.

Fired before filtering. Caches focused filter input to seamlessly restore cursor focus after re-rendering.

Infinite scroll engine. Analyzes viewport to detect empty placeholder rows and triggers Ajax fetches.

Fires after DOM rendering completes. Forces row selection, executes fill_details(), restores focus.

Used in sequential page load mode. Pre-emptively checks bottom boundary to fetch next page.

Fired iteratively during scrolling. Empty hook for override.

Empty hook fired upon a right mouse click event on the grid.

Parses user currency and date formats to construct native Excel string formats for exports.

Requests export, applies custom row striping/headers, and triggers browser download.

Export callback to adjust visibility dynamically during export processing.

Export callback hook to manipulate header cell text/styling.

Export callback hook to apply Excel-specific data formatting (urls, math) before encoding.

Constructs a robust pqGrid filter dropdown object dynamically populated with the global depot list.

Constructs a standard filter dropdown object populated by the globally localized lang.statusValues array.

Constructs a generic dropdown filter object from any provided array of objects.

Stub hook. Fired whenever grid row selection changes to populate external forms or update UI states.

Scans the edit dialog to gather values for saving. Applies red border warnings. Returns payload.

Widget constructor. Binds classes and initializes buffers.

Customizations hook.

Final requirements. Binds resize observers.

Evaluates USE_CATEGORY_TREE to spawn either tabs or tree, and appends grid container.

Initializes horizontal category tabs.

Initializes hierarchical category tree via pqGrid.

Destroys generated elements and dialogs.

Forces dataModel.location to 'remote' and triggers grid_refresh().

Calculates dimension reflows for either tabs or trees.

Reflows tab widths for scrolling.

Switches tree into floating popout panel below breakpoint.

Defines internal column schema specifically for the Category Tree.

Merges option callbacks and appends selected categories to Ajax payload.

Overrides mixin to explicitly set location:'local' to prevent auto-load on boot.

Intercepts JSON response. Rebuilds Category Tabs or Tree dynamically based on response metadata.

Returns grid_columnModel derived from options array.

Merges mixin defaults with options.grid_options.

Returns the underlying jQuery jqGrid/pqGrid element.

Extracts selected category IDs from tree as JSON string.

Fires options.grid_rowDblClick callback.

Executes options.fill_details callback.

Handler for category tab clicks. Triggers refresh().

Handler for tree node checks. Applies debounce timeout before grid refresh.

Toggles slide-out arrow icon direction on mobile view.

Core initialization routine. Sets up the paging object, binds grid options, applies localization, and attaches pqGrid to the DOM.

Initializes the column visibility popup menu. Only executes if grid_columns_key is populated.

Hook called when row numbers change. Intended to be overridden to update UI tab badges (e.g., 'Notes (3)').

Returns the raw rowData object of the currently selected row. Returns null if none or multiple are selected.

Fetches the ID integer from the currently selected row. Used for syncing related tabs.

Extracts current column filters and sorting rules into a parameter object ready for Ajax transmission.

Programmatically selects a specific row index. Safely clamps to boundaries or triggers clear views if empty.

Forces a hard refresh of the grid. Aborts pending calls, clears data cache, resets paging, and fires a new request.

Bypasses remote protocol for a manual, one-time Ajax GET to fetch the entire dataset at once.

Callback executed by grid_load_once(). Populates the paging object and pushes data directly into local dataModel.

Internal utility used to programmatically trigger filter rules and force an immediate re-fetch.

Returns a dictionary mapping row IDs to their exact rowData objects for extremely fast memory lookups.

Standard column renderer. Trims strings and generates HTML title tooltips for hovering.

Safely digs into nested CUSTOM_FIELDS JSON object to extract and format custom string values.

Parses server UTC timestamps and formats them to the user's localized time zone settings.

Standard localized date renderer utilizing the global dateFormatter().

Automatically applies the user's currency symbol, decimal rules, and multiplier logic.

Click handler for the column gear icon. Positions and reveals the column visibility toggles.

Scans the active colModel and applies tick/blank icons to the column menu list accordingly.

Constructs the HTML DOM for the column toggle menu based on columns flagged with hh_optional: true.

Handles menu selections. Triggers grid resets or calculates visibility arrays. Automatically saves settings.

Takes array of desired visible columns, computes hidden array based on hh_optional, and applies to pqGrid.

Callback fired when a user drags to reorder a column. Extracts new layout and saves to profile.

Master assembler compiling all models into the final configuration object handed to pqGrid.

Generates Ajax payload (time, paging, deleted flag). Designed to be extended via _super().

Constructs the pqGrid dataModel object (GET/POST, URL routing, JSON type, success handlers).

Retrieves raw column model and cross-references against user's saved settings to reorder/hide columns.

Returns raw array of column definitions. Intended to be completely overridden by descendant widgets.

Utility to parse FIELD_DEFINITIONS and inject dynamically generated schemas for custom fields.

Generates the pqGrid sortModel based on the initial sort options provided.

Generates the pqGrid filterModel. Applies a 1000ms debounce timeout.

Generates the pqGrid focusModel. Disables individual cell focus outlines by default.

Callback executed as each row is drawn. Override to inject custom CSS classes based on row status.

Event hook triggered immediately whenever the internal paging tracker object is reset to page 0.

Returns the internal grid_paging tracker object (stores data chunks, total records, current page).

Fired when a user clicks a row. Immediately delegates to this.fill_details().

Fired on double click. Left empty by default, intended for overriding.

Master Ajax success interceptor. Calculates pagination math, caches lookups, and splices data into scroll buffer.

Memory management function to trim trailing empty placeholder rows if data exceeds totalRecords.

Fired before sorting. Hard-resets the pagination object to prevent page offset corruptions.

Fired before filtering. Caches focused filter input to seamlessly restore cursor focus after re-rendering.

Infinite scroll engine. Analyzes viewport to detect empty placeholder rows and triggers Ajax fetches.

Fires after DOM rendering completes. Forces row selection, executes fill_details(), restores focus.

Used in sequential page load mode. Pre-emptively checks bottom boundary to fetch next page.

Fired iteratively during scrolling. Empty hook for override.

Empty hook fired upon a right mouse click event on the grid.

Parses user currency and date formats to construct native Excel string formats for exports.

Requests export, applies custom row striping/headers, and triggers browser download.

Export callback to adjust visibility dynamically during export processing.

Export callback hook to manipulate header cell text/styling.

Export callback hook to apply Excel-specific data formatting (urls, math) before encoding.

Constructs a robust pqGrid filter dropdown object dynamically populated with the global depot list.

Constructs a standard filter dropdown object populated by the globally localized lang.statusValues array.

Constructs a generic dropdown filter object from any provided array of objects.

Stub hook. Fired whenever grid row selection changes to populate external forms or update UI states.

Scans the edit dialog to gather values for saving. Applies red border warnings. Returns payload.

Widget constructor. Initializes shopping list stores.

Customizations hook.

Binds dialog behavior, buttons, and resize handlers.

Injects top filters section and instantiates hh_grid_and_categories.

Builds checkboxes for Sales/Rental/Labour and global search input.

Destroys dialog UI footprint entirely.

Aliases refresh to inner hh_grid_and_categories instance.

Calculates math to maximize dialog bounds against viewport.

Routes string rendering to inner instance.

Renders QTY cell. Triggers async availability fetch if value is '?'.

Row initialization callback. Disables rows if unavailable or depot restricted.

Dialog opened handler. Resets shopping list and enforces column visibility based on multi_select.

Dialog closed handler. Halts any pending availability fetches.

Routes column configuration gear click to inner instance.

Updates thumbnail image and HTML memo block for selected item.

Returns underlying pqGrid element.

Constructs complex colModel including dynamic price group columns.

Assembles search terms, checkboxes, and client IDs for list fetch.

Compiles internal shopping_list dictionary into final save payload.

Validates payload and triggers options.saved_callback.

Starts 500ms debounce timer for availability fetch.

Scans visible viewport rows and extracts items requiring stock resolution.

Dispatches Ajax GET to resolve batch of stock queries.

Merges resolved stock numbers back into active grid rowData cache.

Forces all GLOBAL cells back to '?' to force re-fetch upon depot change.

Widget constructor. Binds ID and initializes buffers.

Loads dependencies.

Customizations hook.

Binds dialog behavior, buttons, and resize handlers.

Configures CSS grid template and appends filter box.

Constructs the massive HTML filter form (dates, checkboxes, statuses).

Instantiates the nested hh_favourites_dialog widget.

Returns array of standard buttons (Favorite, Export, Open, Close) for dialog.

Overrides mixin to rename 'COLOUR' heading text.

Calculates math to maximize dialog bounds against viewport.

Evaluates sequential load requirements and fires grid_refresh().

Hard-resets grid paging options upon filter change.

Dynamically disables/enables filter checkboxes based on cross-dependencies.

Programmatically mutates UI checkbox/date fields from JSON and executes filter.

Returns raw payload of selected row.

Handler for 'Open' button or double-click. Evaluates override_open callback.

Public API to invoke dialog programmatically with pre-filled search JSON.

Serializes all active UI filters into a standardized JSON payload.

Routes double click to open_clicked().

Intercepts JSON response to populate preset_search_settings cache globally.

Defines massive column model for all job/project metadata.

Returns column model for the localized custom index column.

Injects custom field definitions dynamically into column array.

DataModel configured explicitly for local loading on boot.

Assembles all form filters into final Ajax payload.

Export callback to hide 'MONEY' column conditionally.

Export callback to rename header cells.

Export callback to format dates, money, and hyperlinked IDs.

Invokes the hh_favourites_dialog.

Callback executed when a user selects a preset search.

Core initialization routine. Sets up the paging object, binds grid options, applies localization, and attaches pqGrid to the DOM.

Initializes the column visibility popup menu. Only executes if grid_columns_key is populated.

Hook called when row numbers change. Intended to be overridden to update UI tab badges (e.g., 'Notes (3)').

Returns the raw rowData object of the currently selected row. Returns null if none or multiple are selected.

Fetches the ID integer from the currently selected row. Used for syncing related tabs.

Extracts current column filters and sorting rules into a parameter object ready for Ajax transmission.

Programmatically selects a specific row index. Safely clamps to boundaries or triggers clear views if empty.

Forces a hard refresh of the grid. Aborts pending calls, clears data cache, resets paging, and fires a new request.

Bypasses remote protocol for a manual, one-time Ajax GET to fetch the entire dataset at once.

Callback executed by grid_load_once(). Populates the paging object and pushes data directly into local dataModel.

Internal utility used to programmatically trigger filter rules and force an immediate re-fetch.

Returns a dictionary mapping row IDs to their exact rowData objects for extremely fast memory lookups.

Standard column renderer. Trims strings and generates HTML title tooltips for hovering.

Safely digs into nested CUSTOM_FIELDS JSON object to extract and format custom string values.

Parses server UTC timestamps and formats them to the user's localized time zone settings.

Standard localized date renderer utilizing the global dateFormatter().

Automatically applies the user's currency symbol, decimal rules, and multiplier logic.

Click handler for the column gear icon. Positions and reveals the column visibility toggles.

Scans the active colModel and applies tick/blank icons to the column menu list accordingly.

Constructs the HTML DOM for the column toggle menu based on columns flagged with hh_optional: true.

Handles menu selections. Triggers grid resets or calculates visibility arrays. Automatically saves settings.

Takes array of desired visible columns, computes hidden array based on hh_optional, and applies to pqGrid.

Callback fired when a user drags to reorder a column. Extracts new layout and saves to profile.

Master assembler compiling all models into the final configuration object handed to pqGrid.

Generates Ajax payload (time, paging, deleted flag). Designed to be extended via _super().

Constructs the pqGrid dataModel object (GET/POST, URL routing, JSON type, success handlers).

Retrieves raw column model and cross-references against user's saved settings to reorder/hide columns.

Returns raw array of column definitions. Intended to be completely overridden by descendant widgets.

Utility to parse FIELD_DEFINITIONS and inject dynamically generated schemas for custom fields.

Generates the pqGrid sortModel based on the initial sort options provided.

Generates the pqGrid filterModel. Applies a 1000ms debounce timeout.

Generates the pqGrid focusModel. Disables individual cell focus outlines by default.

Callback executed as each row is drawn. Override to inject custom CSS classes based on row status.

Event hook triggered immediately whenever the internal paging tracker object is reset to page 0.

Returns the internal grid_paging tracker object (stores data chunks, total records, current page).

Fired when a user clicks a row. Immediately delegates to this.fill_details().

Fired on double click. Left empty by default, intended for overriding.

Master Ajax success interceptor. Calculates pagination math, caches lookups, and splices data into scroll buffer.

Memory management function to trim trailing empty placeholder rows if data exceeds totalRecords.

Fired before sorting. Hard-resets the pagination object to prevent page offset corruptions.

Fired before filtering. Caches focused filter input to seamlessly restore cursor focus after re-rendering.

Infinite scroll engine. Analyzes viewport to detect empty placeholder rows and triggers Ajax fetches.

Fires after DOM rendering completes. Forces row selection, executes fill_details(), restores focus.

Used in sequential page load mode. Pre-emptively checks bottom boundary to fetch next page.

Fired iteratively during scrolling. Empty hook for override.

Empty hook fired upon a right mouse click event on the grid.

Parses user currency and date formats to construct native Excel string formats for exports.

Requests export, applies custom row striping/headers, and triggers browser download.

Export callback to adjust visibility dynamically during export processing.

Export callback hook to manipulate header cell text/styling.

Export callback hook to apply Excel-specific data formatting (urls, math) before encoding.

Constructs a robust pqGrid filter dropdown object dynamically populated with the global depot list.

Constructs a standard filter dropdown object populated by the globally localized lang.statusValues array.

Constructs a generic dropdown filter object from any provided array of objects.

Stub hook. Fired whenever grid row selection changes to populate external forms or update UI states.

Scans the edit dialog to gather values for saving. Applies red border warnings. Returns payload.

Widget constructor.

Dependencies hook.

Customizations hook.

Final initialization and resize binding.

Conditionally builds buttons and instantiates UI Dialog.

Sets up local pqGrid specifically for rendering favorites tree.

Sets up secondary dialog for editing search names.

Recalculates dialog position.

Dialog opened handler. Ensures grid is drawn correctly.

Fires callback with selected payload and closes dialog.

Public API to invoke dialog with active search params.

Opens name edit dialog for new favorite.

Opens name edit dialog for existing favorite.

Fires Ajax deletion routine.

Enables/disables buttons based on selected preset vs custom search.

Parses global preset_search_settings to build grid payload.

Removes deleted item from global preset_search_settings cache.

Extracts new name and packages JSON payload.

Fires Ajax POST to save favourite.

Merges saved response back into global cache and refreshes grid.

Widget constructor.

Dependencies hook.

Customizations hook.

Final initialization.

Builds the entire HTML form (inputs, dates, depot selectors).

Recalculates dialog position.

Resets the form and opens the dialog.

Closes form and invokes hh_search_results_dialog with JSON payload.

Serializes all active form inputs into JSON payload.

Widget constructor. Disables native select.

Customizations hook.

Binds dialog open/close observers to hide dropdown.

Builds CSS wrappers, overlays, and floating tree panels.

Master routine that populates all rows and nodes.

Injects sticky check-all header.

Creates UL or DIV container for tree or list.

Adds 'none' row for single select configurations.

Recursive function that generates DOM nodes from JSON tree.

Builds text/html span for a row.

Redraws and repopulates internal dropdown structures.

Programmatically toggles UI disabled states.

Calculates collision fit against window boundaries and displays the floating tree panel.

Binds hover and click listeners to dynamically generated rows.

Expands or collapses a parent node (trees only).

Scrolls selected node into visible boundary of dropdown.

Hook evaluated during row creation to silently drop specific rows.

Programmatically checks UI boxes matching array of passed IDs.

Alias for set_values.

Synchronizes visual tree state back to hidden native `<select>` and fires callback.

Overrides parent initializer to build data tree specifically by parsing the global `depots` JSON variable.

Widget constructor. Disables native select.

Builds CSS wrappers, overlays, and floating tree panels.

Customizations hook.

Binds dialog open/close observers to hide dropdown.

Redraws and repopulates internal dropdown structures.

Calculates collision fit against window boundaries and displays the floating tree panel.

Programmatically toggles UI disabled states.

Master routine that populates all rows and nodes.

Injects sticky check-all header.

Creates UL or DIV container for tree or list.

Adds 'none' row for single select configurations.

Recursive function that generates DOM nodes from JSON tree.

Builds text/html span for a row.

Hook evaluated during row creation to silently drop specific rows.

Binds hover and click listeners to dynamically generated rows.

Expands or collapses a parent node (trees only).

Scrolls selected node into visible boundary of dropdown.

Programmatically checks UI boxes matching array of passed IDs.

Alias for set_values.

Synchronizes visual tree state back to hidden native `<select>` and fires callback.

Widget constructor.

Customizations hook.

Final initialization.

Builds dialog components.

Constructs complex radio and select configurations for credit periods.

Toggles fieldsets disabled states based on active radio context.

Dialog opened handler. Sets help context.

Dialog closed handler.

Input change handler. Triggers translation string generation.

Sanitises input payload, pre-fills form, and opens dialog.

Validates form and triggers saved().

Fires callback and closes dialog.

Resizes dialog elements.

Globally accessible method. Enforces ISO duration constraints on period data.

Globally accessible method. Translates credit period JSON into a localized human-readable sentence.

Scrapes DOM elements and constructs ISO string payload.