@toolbox-web/grid 0.2.8 → 0.3.0

package/lib/core/internal/shell.d.ts

@@ -0,0 +1,228 @@
+import { HeaderContentDefinition, IconValue, ShellConfig, ToolbarButtonConfig, ToolbarButtonInfo, ToolPanelDefinition } from '../types';
+/**
+ * State for managing shell UI.
+ */
+export interface ShellState {
+    /** Registered tool panels (from plugins + consumer API) */
+    toolPanels: Map<string, ToolPanelDefinition>;
+    /** Registered header content (from plugins + consumer API) */
+    headerContents: Map<string, HeaderContentDefinition>;
+    /** Custom toolbar buttons registered via API */
+    toolbarButtons: Map<string, ToolbarButtonConfig>;
+    /** Light DOM toolbar buttons */
+    lightDomButtons: HTMLElement[];
+    /** Light DOM header content elements */
+    lightDomHeaderContent: HTMLElement[];
+    /** Light DOM header title from <tbw-grid-header title="..."> */
+    lightDomTitle: string | null;
+    /** IDs of tool panels registered from light DOM (to avoid re-parsing) */
+    lightDomToolPanelIds: Set<string>;
+    /** Whether the tool panel sidebar is open */
+    isPanelOpen: boolean;
+    /** Which accordion sections are expanded (by panel ID) */
+    expandedSections: Set<string>;
+    /** Cleanup functions for header content render returns */
+    headerContentCleanups: Map<string, () => void>;
+    /** Cleanup functions for each panel section's render return */
+    panelCleanups: Map<string, () => void>;
+    /** Cleanup functions for toolbar button render returns */
+    toolbarButtonCleanups: Map<string, () => void>;
+    /** @deprecated Use isPanelOpen instead. Kept for backward compatibility. */
+    activePanel: string | null;
+    /** @deprecated Use panelCleanups instead. Kept for backward compatibility. */
+    activePanelCleanup: (() => void) | null;
+}
+/**
+ * Create initial shell state.
+ */
+export declare function createShellState(): ShellState;
+/**
+ * Determine if shell header should be rendered.
+ */
+export declare function shouldRenderShellHeader(config: ShellConfig | undefined, state: ShellState): boolean;
+/**
+ * Render the shell header HTML.
+ * @param toolPanelIcon - Icon for the tool panel toggle (from grid icon config)
+ */
+export declare function renderShellHeader(config: ShellConfig | undefined, state: ShellState, toolPanelIcon?: IconValue): string;
+/**
+ * Render the shell body wrapper HTML (contains grid content + accordion-style tool panel).
+ * @param icons - Optional icons for expand/collapse chevrons (from grid config)
+ */
+export declare function renderShellBody(config: ShellConfig | undefined, state: ShellState, gridContentHtml: string, icons?: {
+    expand?: IconValue;
+    collapse?: IconValue;
+}): string;
+/**
+ * Parse light DOM shell elements (tbw-grid-header, etc.).
+ * Safe to call multiple times - will only parse once when elements are available.
+ */
+export declare function parseLightDomShell(host: HTMLElement, state: ShellState): void;
+/**
+ * Callback type for creating a tool panel renderer from a light DOM element.
+ * This is used by framework adapters (Angular, React, etc.) to create renderers
+ * from their template syntax.
+ */
+export type ToolPanelRendererFactory = (element: HTMLElement) => ((container: HTMLElement) => void | (() => void)) | undefined;
+/**
+ * Parse light DOM tool panel elements (<tbw-grid-tool-panel>).
+ * These can appear as direct children of <tbw-grid> for declarative tool panel configuration.
+ *
+ * Attributes:
+ * - `id` (required): Unique panel identifier
+ * - `title` (required): Panel title shown in accordion header
+ * - `icon`: Icon for accordion section header (emoji or text)
+ * - `tooltip`: Tooltip for accordion section header
+ * - `order`: Panel order priority (lower = first, default: 100)
+ *
+ * For vanilla JS, the element's innerHTML is used as the panel content.
+ * For framework adapters, the adapter can provide a custom renderer factory.
+ *
+ * @param host - The grid host element
+ * @param state - Shell state to update
+ * @param rendererFactory - Optional factory for creating renderers (used by framework adapters)
+ */
+export declare function parseLightDomToolPanels(host: HTMLElement, state: ShellState, rendererFactory?: ToolPanelRendererFactory): void;
+/**
+ * Set up event listeners for shell toolbar buttons and accordion.
+ */
+export declare function setupShellEventListeners(shadowRoot: ShadowRoot, config: ShellConfig | undefined, state: ShellState, callbacks: {
+    onPanelToggle: () => void;
+    onSectionToggle: (sectionId: string) => void;
+    onToolbarButtonClick: (buttonId: string) => void;
+}): void;
+/**
+ * Set up resize handle for tool panel.
+ * Returns a cleanup function to remove event listeners.
+ */
+export declare function setupToolPanelResize(shadowRoot: ShadowRoot, config: ShellConfig | undefined, onResize: (width: number) => void): () => void;
+/**
+ * Render custom button elements/render functions into toolbar slots.
+ */
+export declare function renderCustomToolbarButtons(shadowRoot: ShadowRoot, config: ShellConfig | undefined, state: ShellState): void;
+/**
+ * Render header content from plugins into the shell content area.
+ */
+export declare function renderHeaderContent(shadowRoot: ShadowRoot, state: ShellState): void;
+/**
+ * Render content for expanded accordion sections.
+ * @param icons - Optional icons for expand/collapse chevrons (from grid config)
+ */
+export declare function renderPanelContent(shadowRoot: ShadowRoot, state: ShellState, icons?: {
+    expand?: IconValue;
+    collapse?: IconValue;
+}): void;
+/**
+ * Update toolbar button active states.
+ */
+export declare function updateToolbarActiveStates(shadowRoot: ShadowRoot, state: ShellState): void;
+/**
+ * Update tool panel open/close state.
+ */
+export declare function updatePanelState(shadowRoot: ShadowRoot, state: ShellState): void;
+/**
+ * Get all toolbar button info.
+ */
+export declare function getToolbarButtonsInfo(config: ShellConfig | undefined, state: ShellState): ToolbarButtonInfo[];
+/**
+ * Cleanup all shell state when grid disconnects.
+ */
+export declare function cleanupShellState(state: ShellState): void;
+/**
+ * Callbacks for ShellController to communicate with the grid.
+ * This interface decouples the controller from grid internals.
+ */
+export interface ShellControllerCallbacks {
+    /** Get the shadow root for DOM queries */
+    getShadow: () => ShadowRoot;
+    /** Get the current shell config */
+    getShellConfig: () => ShellConfig | undefined;
+    /** Get accordion expand/collapse icons */
+    getAccordionIcons: () => {
+        expand: IconValue;
+        collapse: IconValue;
+    };
+    /** Emit an event from the grid */
+    emit: (eventName: string, detail: unknown) => void;
+    /** Refresh the shell header (re-parse light DOM and re-render) */
+    refreshShellHeader: () => void;
+}
+/**
+ * Controller interface for managing shell/tool panel behavior.
+ */
+export interface ShellController {
+    /** Whether the shell has been initialized */
+    readonly isInitialized: boolean;
+    /** Set the initialized state */
+    setInitialized(value: boolean): void;
+    /** Whether the tool panel is currently open */
+    readonly isPanelOpen: boolean;
+    /** Get the currently active panel ID (deprecated) */
+    readonly activePanel: string | null;
+    /** Get IDs of expanded accordion sections */
+    readonly expandedSections: string[];
+    /** Open the tool panel */
+    openToolPanel(): void;
+    /** Close the tool panel */
+    closeToolPanel(): void;
+    /** Toggle the tool panel */
+    toggleToolPanel(): void;
+    /** Toggle an accordion section */
+    toggleToolPanelSection(sectionId: string): void;
+    /** Get registered tool panels */
+    getToolPanels(): ToolPanelDefinition[];
+    /** Register a tool panel */
+    registerToolPanel(panel: ToolPanelDefinition): void;
+    /** Unregister a tool panel */
+    unregisterToolPanel(panelId: string): void;
+    /** Get registered header contents */
+    getHeaderContents(): HeaderContentDefinition[];
+    /** Register header content */
+    registerHeaderContent(content: HeaderContentDefinition): void;
+    /** Unregister header content */
+    unregisterHeaderContent(contentId: string): void;
+    /** Get all toolbar buttons info */
+    getToolbarButtons(): ToolbarButtonInfo[];
+    /** Register a toolbar button */
+    registerToolbarButton(button: ToolbarButtonConfig): void;
+    /** Unregister a toolbar button */
+    unregisterToolbarButton(buttonId: string): void;
+    /** Enable/disable a toolbar button */
+    setToolbarButtonDisabled(buttonId: string, disabled: boolean): void;
+}
+/**
+ * Create a ShellController instance.
+ * The controller encapsulates all tool panel orchestration logic.
+ */
+export declare function createShellController(state: ShellState, callbacks: ShellControllerCallbacks): ShellController;
+/**
+ * Core grid content HTML template.
+ * Uses faux scrollbar pattern for smooth virtualized scrolling.
+ */
+export declare const GRID_CONTENT_HTML = "\n  <div class=\"tbw-scroll-area\">\n    <div class=\"rows-body-wrapper\">\n      <div class=\"rows-body\" role=\"grid\">\n        <div class=\"header\">\n          <div class=\"header-row\" part=\"header-row\"></div>\n        </div>\n        <div class=\"rows-container\">\n          <div class=\"rows-viewport\">\n            <div class=\"rows\"></div>\n          </div>\n        </div>\n      </div>\n    </div>\n  </div>\n  <div class=\"faux-vscroll\">\n    <div class=\"faux-vscroll-spacer\"></div>\n  </div>\n";
+/**
+ * Render the complete grid HTML structure.
+ * @returns HTML string to set as shadow root innerHTML
+ * @deprecated Use buildGridDOM() for better performance
+ */
+export declare function renderGridHtml(shellConfig: ShellConfig | undefined, state: ShellState, icons?: {
+    toolPanel?: IconValue;
+    expand?: IconValue;
+    collapse?: IconValue;
+}): string;
+/**
+ * Build the complete grid DOM structure using direct DOM construction.
+ * This is 2-3x faster than innerHTML for initial render.
+ *
+ * @param shadowRoot - The shadow root to render into (will be cleared)
+ * @param shellConfig - Shell configuration
+ * @param state - Shell state
+ * @param icons - Optional icons
+ * @returns Whether shell is active (for post-render setup)
+ */
+export declare function buildGridDOMIntoShadow(shadowRoot: ShadowRoot, shellConfig: ShellConfig | undefined, state: ShellState, icons?: {
+    toolPanel?: IconValue;
+    expand?: IconValue;
+    collapse?: IconValue;
+}): boolean;
+//# sourceMappingURL=shell.d.ts.map

package/lib/core/internal/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/shell.ts"],"names":[],"mappings":"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"}

package/lib/core/internal/sorting.d.ts

@@ -0,0 +1,24 @@
+import { ColumnConfig, InternalGrid, SortState } from '../types';
+/**
+ * Default comparator for sorting values.
+ * Handles nulls (pushed to end), numbers, and string fallback.
+ */
+export declare function defaultComparator(a: unknown, b: unknown): number;
+/**
+ * Built-in sort implementation using column comparator or default.
+ * This is the default sortHandler when none is configured.
+ */
+export declare function builtInSort<T>(rows: T[], sortState: SortState, columns: ColumnConfig<T>[]): T[];
+/**
+ * Cycle sort state for a column: none -> ascending -> descending -> none.
+ * Restores original row order when clearing sort.
+ */
+export declare function toggleSort(grid: InternalGrid, col: ColumnConfig<any>): void;
+/**
+ * Apply a concrete sort direction to rows.
+ *
+ * Uses custom sortHandler from gridConfig if provided, otherwise uses built-in sorting.
+ * Supports both sync and async handlers (for server-side sorting).
+ */
+export declare function applySort(grid: InternalGrid, col: ColumnConfig<any>, dir: 1 | -1): void;
+//# sourceMappingURL=sorting.d.ts.map

package/lib/core/internal/sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/sorting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAe,SAAS,EAAE,MAAM,UAAU,CAAC;AAGnF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAKhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAQ/F;AAqBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CA8B3E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAqBvF"}

package/lib/core/internal/touch-scroll.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Touch scrolling controller for mobile devices.
+ *
+ * Handles touch events for scrolling with momentum physics.
+ * Supports both vertical (faux scrollbar) and horizontal (scroll area) scrolling.
+ */
+export interface TouchScrollState {
+    startY: number | null;
+    startX: number | null;
+    scrollTop: number | null;
+    scrollLeft: number | null;
+    lastY: number | null;
+    lastX: number | null;
+    lastTime: number | null;
+    velocityY: number;
+    velocityX: number;
+    momentumRaf: number;
+}
+export interface TouchScrollElements {
+    fauxScrollbar: HTMLElement;
+    scrollArea: HTMLElement | null;
+}
+/**
+ * Create initial touch scroll state.
+ */
+export declare function createTouchScrollState(): TouchScrollState;
+/**
+ * Reset touch scroll state (called on touchend or cleanup).
+ */
+export declare function resetTouchState(state: TouchScrollState): void;
+/**
+ * Cancel any ongoing momentum animation.
+ */
+export declare function cancelMomentum(state: TouchScrollState): void;
+/**
+ * Handle touchstart event.
+ */
+export declare function handleTouchStart(e: TouchEvent, state: TouchScrollState, elements: TouchScrollElements): void;
+/**
+ * Handle touchmove event.
+ * Returns true if the event should be prevented (grid scrolled).
+ */
+export declare function handleTouchMove(e: TouchEvent, state: TouchScrollState, elements: TouchScrollElements): boolean;
+/**
+ * Handle touchend event.
+ * Starts momentum scrolling if velocity is significant.
+ */
+export declare function handleTouchEnd(state: TouchScrollState, elements: TouchScrollElements): void;
+/**
+ * Set up touch scroll event listeners on the grid content element.
+ * Returns a cleanup function that removes all listeners.
+ */
+export declare function setupTouchScrollListeners(gridContentEl: HTMLElement, state: TouchScrollState, elements: TouchScrollElements, signal: AbortSignal): void;
+//# sourceMappingURL=touch-scroll.d.ts.map

package/lib/core/internal/touch-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-scroll.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/touch-scroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,WAAW,CAAC;IAC3B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAazD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAQ7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAK5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAgB5G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAsD9G;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAS3F;AAqCD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,WAAW,EAC1B,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,WAAW,GAClB,IAAI,CAkBN"}

package/lib/core/internal/utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Create a requestAnimationFrame-based debounce wrapper. Consecutive calls in the same frame
+ * cancel the previous scheduled callback ensuring it runs at most once per frame.
+ */
+export declare function rafDebounce<T extends (...args: any[]) => void>(fn: T): T & {
+    cancel: () => void;
+};
+/**
+ * Generate accessible HTML for a boolean cell.
+ * Uses role="checkbox" with proper aria attributes.
+ */
+export declare function booleanCellHTML(value: boolean): string;
+/**
+ * Format a date value for display.
+ * Handles Date objects, timestamps, and date strings.
+ * Returns empty string for invalid dates.
+ */
+export declare function formatDateValue(value: unknown): string;
+/**
+ * Format a boolean value for text display (not HTML).
+ */
+export declare function formatBooleanValue(value: unknown): string;
+/**
+ * Get the row index from a cell element's data-row attribute.
+ * Returns -1 if no valid row index is found.
+ */
+export declare function getRowIndexFromCell(cell: Element | null): number;
+/**
+ * Get the column index from a cell element's data-col attribute.
+ * Returns -1 if no valid column index is found.
+ */
+export declare function getColIndexFromCell(cell: Element | null): number;
+/**
+ * Clear all cell-focus styling from a root element (shadowRoot or bodyEl).
+ * Used when changing focus or when selection plugin takes over focus management.
+ */
+export declare function clearCellFocus(root: Element | ShadowRoot | null): void;
+//# sourceMappingURL=utils.d.ts.map

package/lib/core/internal/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,GAajD,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAC7C;AAWD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAIhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAIhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,IAAI,CAGtE"}

package/lib/core/internal/virtualization.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Row Virtualization Core Logic
+ *
+ * Pure functions for vertical row virtualization operations.
+ * Manages which rows are rendered based on scroll position and viewport size.
+ */
+/** Result of computing a virtual window */
+export interface VirtualWindow {
+    /** First row index to render (inclusive) */
+    start: number;
+    /** Last row index to render (exclusive) */
+    end: number;
+    /** Pixel offset to apply to the rows container (translateY) */
+    offsetY: number;
+    /** Total height of the scrollable content */
+    totalHeight: number;
+}
+/** Parameters for computing the virtual window */
+export interface VirtualWindowParams {
+    /** Total number of rows */
+    totalRows: number;
+    /** Height of the viewport in pixels */
+    viewportHeight: number;
+    /** Current scroll top position */
+    scrollTop: number;
+    /** Height of each row in pixels */
+    rowHeight: number;
+    /** Number of extra rows to render above/below viewport */
+    overscan: number;
+    /** Previous scroll position for velocity calculation */
+    prevScrollTop?: number;
+}
+/**
+ * Compute the virtual row window based on scroll position and viewport.
+ * Uses directional overscan - renders more rows in the scroll direction.
+ *
+ * @param params - Parameters for computing the window
+ * @returns VirtualWindow with start/end indices and transforms
+ */
+export declare function computeVirtualWindow(params: VirtualWindowParams): VirtualWindow;
+/**
+ * Determine if virtualization should be bypassed for small datasets.
+ * When there are very few items, the overhead of virtualization isn't worth it.
+ *
+ * @param totalRows - Total number of items
+ * @param threshold - Bypass threshold (skip virtualization if totalRows <= threshold)
+ * @returns True if virtualization should be bypassed
+ */
+export declare function shouldBypassVirtualization(totalRows: number, threshold: number): boolean;
+/**
+ * Compute the row index from a Y pixel position.
+ *
+ * @param y - Y position in pixels (relative to content top)
+ * @param rowHeight - Height of each row
+ * @returns Row index at that position
+ */
+export declare function getRowIndexFromY(y: number, rowHeight: number): number;
+/**
+ * Compute the Y offset for a given row index.
+ *
+ * @param rowIndex - Row index
+ * @param rowHeight - Height of each row
+ * @returns Y position in pixels
+ */
+export declare function getRowOffsetY(rowIndex: number, rowHeight: number): number;
+//# sourceMappingURL=virtualization.d.ts.map

package/lib/core/internal/virtualization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualization.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/core/internal/virtualization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAyB/E;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAExF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE"}