@toolbox-web/grid 3.8.2 → 3.9.0

package/lib/plugins/shell/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../../libs/grid/src/lib/core/defaults.ts","../../../../../../libs/grid/src/lib/core/internal/sanitize.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/core/internal/pointer-drag.ts","../../../../../../libs/grid/src/lib/core/internal/size-popover.ts","../../../../../../libs/grid/src/lib/core/constants.ts","../../../../../../libs/grid/src/lib/core/internal/dom-builder.ts","../../../../../../libs/grid/src/lib/plugins/shell/shell.ts","../../../../../../libs/grid/src/lib/plugins/shell/shell-controller.ts","../../../../../../libs/grid/src/lib/plugins/shell/shell.css?inline","../../../../../../libs/grid/src/lib/plugins/shell/shell-plugin.ts"],"sourcesContent":["/**\n * Centralized diagnostic messages for @toolbox-web/grid.\n *\n * Every user-facing warning, error, or info message in the grid has a unique\n * diagnostic code (e.g. `TBW001`). Each code maps to a section on the online\n * troubleshooting page, giving developers a direct link to resolution steps.\n *\n * ## Usage\n *\n * ```ts\n * import { MISSING_BREAKPOINT, warnDiagnostic, throwDiagnostic } from './diagnostics';\n *\n * // Warn with a code\n * warnDiagnostic(MISSING_BREAKPOINT, 'Set a breakpoint...', gridId);\n *\n * // Throw with a code\n * throwDiagnostic(MISSING_ROW_ID, 'Configure getRowId...', gridId);\n * ```\n *\n * Plugins should prefer `this.warn(MISSING_BREAKPOINT, message)` via BaseGridPlugin\n * instead of importing this module directly.\n *\n * @internal\n */\n\n// #region Grid Prefix\n\n/**\n * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.\n * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.\n */\nexport function gridPrefix(gridId?: string, pluginName?: string): string {\n  const id = gridId ? `#${gridId}` : '';\n  const plugin = pluginName ? `:${pluginName}` : '';\n  return `[tbw-grid${id}${plugin}]`;\n}\n\n// #endregion\n\n// #region Diagnostic Codes\n\n/**\n * Diagnostic codes used across the grid library.\n *\n * Each code is an individual export so that unused codes are tree-shaken\n * from bundles that don't reference them (esbuild can't tree-shake\n * properties from a single object).\n *\n * Naming: TBW + 3-digit number.\n * Ranges:\n *   001–019  Configuration validation (missing plugins, bad config)\n *   020–029  Plugin lifecycle (dependencies, incompatibilities, alias collapse)\n *   030–039  Feature registry\n *   040–049  Row operations (row ID, row mutations)\n *   050–059  Column operations (width, template)\n *   060–069  Rendering (callbacks, formatters, external views)\n *   070–079  Shell (tool panels, header/toolbar content)\n *   080–089  Editing & editors\n *   090–099  Print\n *   100–109  Clipboard\n *   110–119  Plugin-specific (responsive, undo-redo, grouping-columns)\n *   120–129  Style injection\n *   130–139  Attribute parsing\n *   140–149  DataSource / ServerSide\n */\n\n// --- Config validation (001–019) ---\n/** Column uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN = 'TBW001' as const;\n/** Grid config uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN_CONFIG = 'TBW002' as const;\n/** Plugin config rule violation (error severity). */\nexport const CONFIG_RULE_ERROR = 'TBW003' as const;\n/** Plugin config rule violation (warning severity). */\nexport const CONFIG_RULE_WARN = 'TBW004' as const;\n\n// --- Plugin lifecycle (020–029) ---\n/** Required plugin dependency is missing. */\nexport const MISSING_DEPENDENCY = 'TBW020' as const;\n/** Optional plugin dependency is missing. */\nexport const OPTIONAL_DEPENDENCY = 'TBW021' as const;\n/** Two loaded plugins are incompatible. */\nexport const INCOMPATIBLE_PLUGINS = 'TBW022' as const;\n/** Two plugin instances resolve to the same canonical name (alias collapse). */\nexport const PLUGIN_ALIAS_COLLAPSE = 'TBW023' as const;\n/** Error thrown inside a plugin event handler. */\nexport const PLUGIN_EVENT_ERROR = 'TBW024' as const;\n/** Conflicting config values found while merging alias-collapsed plugin instances. */\nexport const PLUGIN_ALIAS_CONFIG_CONFLICT = 'TBW025' as const;\n\n// --- Feature registry (030–039) ---\n/** Feature was re-registered (overwritten). */\nexport const FEATURE_REREGISTERED = 'TBW030' as const;\n/** Feature configured but not imported. */\nexport const FEATURE_NOT_IMPORTED = 'TBW031' as const;\n/** Feature depends on another feature that is not enabled. */\nexport const FEATURE_MISSING_DEP = 'TBW032' as const;\n\n// --- Row operations (040–049) ---\n/** Cannot determine row ID (no getRowId and no id property). */\nexport const MISSING_ROW_ID = 'TBW040' as const;\n/** Row with given ID not found. */\nexport const ROW_NOT_FOUND = 'TBW041' as const;\n\n// --- Column operations (050–059) ---\n/** Column has an invalid CSS width value. */\nexport const INVALID_COLUMN_WIDTH = 'TBW050' as const;\n\n// --- Rendering callbacks (060–069) ---\n/** rowClass callback threw an error. */\nexport const ROW_CLASS_ERROR = 'TBW060' as const;\n/** cellClass callback threw an error. */\nexport const CELL_CLASS_ERROR = 'TBW061' as const;\n/** Column format function threw an error. */\nexport const FORMAT_ERROR = 'TBW062' as const;\n/** External view mount() threw an error. */\nexport const VIEW_MOUNT_ERROR = 'TBW063' as const;\n/** External view event dispatch error. */\nexport const VIEW_DISPATCH_ERROR = 'TBW064' as const;\n\n// --- Shell (070–079) ---\n/** Tool panel missing required id. */\nexport const TOOL_PANEL_MISSING_ATTR = 'TBW070' as const;\n/** No tool panels registered. */\nexport const NO_TOOL_PANELS = 'TBW071' as const;\n/** Tool panel section not found. */\nexport const TOOL_PANEL_NOT_FOUND = 'TBW072' as const;\n/** Tool panel already registered. */\nexport const TOOL_PANEL_DUPLICATE = 'TBW073' as const;\n/** Header content already registered. */\nexport const HEADER_CONTENT_DUPLICATE = 'TBW074' as const;\n/** Toolbar content already registered. */\nexport const TOOLBAR_CONTENT_DUPLICATE = 'TBW075' as const;\n\n// --- Editing & editors (080–089) ---\n/** External editor mount() threw an error. */\nexport const EDITOR_MOUNT_ERROR = 'TBW080' as const;\n\n// --- Print (090–099) ---\n/** Print already in progress. */\nexport const PRINT_IN_PROGRESS = 'TBW090' as const;\n/** Grid not available for printing. */\nexport const PRINT_NO_GRID = 'TBW091' as const;\n/** Print operation failed. */\nexport const PRINT_FAILED = 'TBW092' as const;\n/** Multiple elements share the same grid ID (print isolation issue). */\nexport const PRINT_DUPLICATE_ID = 'TBW093' as const;\n\n// --- Clipboard (100–109) ---\n/** Clipboard API write failed. */\nexport const CLIPBOARD_FAILED = 'TBW100' as const;\n\n// --- Plugin-specific (110–119) ---\n/** ResponsivePlugin: no breakpoint configured. */\nexport const MISSING_BREAKPOINT = 'TBW110' as const;\n/** UndoRedoPlugin: transaction already in progress. */\nexport const TRANSACTION_IN_PROGRESS = 'TBW111' as const;\n/** UndoRedoPlugin: no transaction in progress. */\nexport const NO_TRANSACTION = 'TBW112' as const;\n/** GroupingColumnsPlugin: missing id or header on column group definition. */\nexport const COLUMN_GROUP_NO_ID = 'TBW113' as const;\n/** GroupingColumnsPlugin: conflicting columnGroups sources. */\nexport const COLUMN_GROUPS_CONFLICT = 'TBW114' as const;\n\n// --- Style injection (120–129) ---\n/** Failed to extract grid.css from document stylesheets. */\nexport const STYLE_EXTRACT_FAILED = 'TBW120' as const;\n/** Could not find grid.css in document.styleSheets. */\nexport const STYLE_NOT_FOUND = 'TBW121' as const;\n\n// --- Attribute parsing (130–139) ---\n/** Invalid JSON in an HTML attribute. */\nexport const INVALID_ATTRIBUTE_JSON = 'TBW130' as const;\n\n// --- DataSource / ServerSide (140–149) ---\n/** ServerSidePlugin: getRows() rejected. */\nexport const DATASOURCE_FETCH_ERROR = 'TBW140' as const;\n/** ServerSidePlugin: getChildRows() rejected. */\nexport const DATASOURCE_CHILD_FETCH_ERROR = 'TBW141' as const;\n/** ServerSidePlugin: getChildRows() not implemented but a plugin queried for children. */\nexport const DATASOURCE_NO_CHILD_HANDLER = 'TBW142' as const;\n/** ServerSidePlugin: concurrent request limit reached, request deferred. */\nexport const DATASOURCE_THROTTLED = 'TBW143' as const;\n\nexport type DiagnosticCode =\n  | typeof MISSING_PLUGIN\n  | typeof MISSING_PLUGIN_CONFIG\n  | typeof CONFIG_RULE_ERROR\n  | typeof CONFIG_RULE_WARN\n  | typeof MISSING_DEPENDENCY\n  | typeof OPTIONAL_DEPENDENCY\n  | typeof INCOMPATIBLE_PLUGINS\n  | typeof PLUGIN_ALIAS_COLLAPSE\n  | typeof PLUGIN_EVENT_ERROR\n  | typeof PLUGIN_ALIAS_CONFIG_CONFLICT\n  | typeof FEATURE_REREGISTERED\n  | typeof FEATURE_NOT_IMPORTED\n  | typeof FEATURE_MISSING_DEP\n  | typeof MISSING_ROW_ID\n  | typeof ROW_NOT_FOUND\n  | typeof INVALID_COLUMN_WIDTH\n  | typeof ROW_CLASS_ERROR\n  | typeof CELL_CLASS_ERROR\n  | typeof FORMAT_ERROR\n  | typeof VIEW_MOUNT_ERROR\n  | typeof VIEW_DISPATCH_ERROR\n  | typeof TOOL_PANEL_MISSING_ATTR\n  | typeof NO_TOOL_PANELS\n  | typeof TOOL_PANEL_NOT_FOUND\n  | typeof TOOL_PANEL_DUPLICATE\n  | typeof HEADER_CONTENT_DUPLICATE\n  | typeof TOOLBAR_CONTENT_DUPLICATE\n  | typeof EDITOR_MOUNT_ERROR\n  | typeof PRINT_IN_PROGRESS\n  | typeof PRINT_NO_GRID\n  | typeof PRINT_FAILED\n  | typeof PRINT_DUPLICATE_ID\n  | typeof CLIPBOARD_FAILED\n  | typeof MISSING_BREAKPOINT\n  | typeof TRANSACTION_IN_PROGRESS\n  | typeof NO_TRANSACTION\n  | typeof COLUMN_GROUP_NO_ID\n  | typeof COLUMN_GROUPS_CONFLICT\n  | typeof STYLE_EXTRACT_FAILED\n  | typeof STYLE_NOT_FOUND\n  | typeof INVALID_ATTRIBUTE_JSON\n  | typeof DATASOURCE_FETCH_ERROR\n  | typeof DATASOURCE_CHILD_FETCH_ERROR\n  | typeof DATASOURCE_NO_CHILD_HANDLER\n  | typeof DATASOURCE_THROTTLED;\n\n// #endregion\n\n// #region Docs URL\n\nconst DOCS_BASE = 'https://toolboxjs.com/grid/errors';\n\n/** Build a direct link to the troubleshooting section for a code. */\nfunction docsUrl(code: DiagnosticCode): string {\n  return `${DOCS_BASE}#${code.toLowerCase()}`;\n}\n\n// #endregion\n\n// #region Formatting\n\n/**\n * Format a diagnostic message with prefix, code, and docs link.\n *\n * Output format:\n * ```\n * [tbw-grid#my-id] TBW001: Your message here.\n *\n *   → More info: https://toolboxjs.com/grid/errors#tbw001\n * ```\n */\nexport function formatDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): string {\n  const prefix = gridPrefix(gridId, pluginName);\n  return `${prefix} ${code}: ${message}\\n\\n  → More info: ${docsUrl(code)}`;\n}\n\n// #endregion\n\n// #region Public API\n\n/**\n * Throw an error with a diagnostic code and docs link.\n * Use for configuration errors and API misuse that should halt execution.\n */\nexport function throwDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): never {\n  throw new Error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a warning with a diagnostic code and docs link.\n * Use for recoverable issues the developer should fix.\n */\nexport function warnDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.warn(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a debug message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications — visible only when\n * the browser DevTools \"Verbose\" log level is enabled.\n */\nexport function debugDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.debug(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log an error with a diagnostic code and docs link.\n * Use for non-throwing errors (e.g., failed async operations).\n */\nexport function errorDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n// #endregion\n","/**\n * Runtime default values for grid configuration.\n *\n * Kept out of `core/types.ts` so that file stays type-only apart from the two\n * enum-like consts whose `type` aliases are derived from them via `typeof`.\n * Import types from `./types`; import the values that back them from here.\n */\n\nimport type { A11yMessages, AnimationConfig, GridIcons } from './types';\n\n/**\n * Default English announcement messages.\n * Used when no custom messages are provided via {@link A11yConfig.messages}.\n * @since 2.0.0\n */\nexport const DEFAULT_A11Y_MESSAGES: A11yMessages = {\n  sortApplied: (column, direction) => `Sorted by ${column}, ${direction}`,\n  sortCleared: () => 'Sort cleared',\n  filterApplied: (column) => `Filter applied on ${column}`,\n  filterCleared: (column) => `Filter cleared from ${column}`,\n  allFiltersCleared: () => 'All filters cleared',\n  groupExpanded: (name, count) => `Group ${name} expanded, ${count} rows`,\n  groupCollapsed: (name) => `Group ${name} collapsed`,\n  selectionChanged: (count) => `${count} rows selected`,\n  selectAllRows: () => 'Select all rows',\n  selectRow: (rowIndex) => `Select row ${rowIndex + 1}`,\n  columnSelected: (label) => `Column ${label} selected`,\n  columnSelectionChanged: (count) => `${count} columns selected`,\n  columnSelectionCleared: () => 'Column selection cleared',\n  selectionAxisChanged: (toAxis) =>\n    toAxis === 'column'\n      ? 'Row selection cleared, column selection active'\n      : 'Column selection cleared, row selection active',\n  editingStarted: (rowIndex) => `Editing row ${rowIndex + 1}`,\n  editingCommitted: (rowIndex) => `Row ${rowIndex + 1} saved`,\n  dataLoaded: (count) => `${count} rows loaded`,\n};\n\n/**\n * Default animation configuration\n * @since 0.2.7\n */\nexport const DEFAULT_ANIMATION_CONFIG: Required<Omit<AnimationConfig, 'sort'>> = {\n  mode: 'reduced-motion',\n  duration: 200,\n  easing: 'ease-out',\n};\n\n/**\n * Default icons used when not overridden. Most entries are short text/emoji;\n * `filter` and `filterActive` are empty strings because the actual rendering\n * is driven by the `--tbw-icon-filter[-active]-mask` CSS custom properties\n * (see `core/styles/variables.css`). Userland that wants an HTML/SVG fallback\n * via `gridConfig.icons.filter = '<svg…>'` is unaffected — that path overrides this default.\n * @since 0.1.1\n */\nexport const DEFAULT_GRID_ICONS: Required<GridIcons> = {\n  expand: '▶',\n  collapse: '▼',\n  sortAsc: '▲',\n  sortDesc: '▼',\n  sortNone: '⇅',\n  submenuArrow: '▶',\n  dragHandle: '⋮⋮',\n  toolPanel: '☰',\n  filter: '',\n  filterActive: '',\n  print: '🖨️',\n};\n","// Centralized template expression evaluation & sanitization utilities.\n// Responsible for safely interpolating {{ }} expressions while blocking\n// access to dangerous globals / reflective capabilities.\nimport type { CompiledViewFunction, EvalContext } from '../types';\n\n// #region Constants\nconst EXPR_RE = /{{\\s*([^}]+)\\s*}}/g;\nconst EMPTY_SENTINEL = '__DG_EMPTY__';\nconst SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/;\n\n// Forbidden identifiers built at runtime to avoid static analysis scanners\n// from flagging string literals (e.g. socket.dev \"network access\" / \"uses eval\").\n// Stored as reversed, pipe-delimited tokens — reversed back when constructing the regex.\nconst _F =\n  '__otorp__|__retteGenifed__|__retteSenifed__|rotcurtsnoc|wodniw|sihTlabolg|labolg|ssecorp|noitcnuF|tropmi|lave|tcelfeR|yxorP|rorrE|stnemugra|tnemucod|noitacol|eikooc|egarotSlacol|egarotSnoisses|BDdexedni|hctef|tseuqeRpttHLMX|tekcoSbeW|rekroW|rekroWderahS|rekroWecivreS|renepo|tnerap|pot|semarf|fles'\n    .split('|')\n    .map((s) => s.split('').reverse().join(''));\nconst FORBIDDEN = new RegExp(`__(proto|defineGetter|defineSetter)|${_F.slice(3).join('|')}|this\\\\b`);\n// #endregion\n\n// #region HTML Sanitization\n\n/**\n * Escape a plain text string for safe insertion into HTML.\n * Converts special HTML characters to their entity equivalents.\n *\n * @param text - Plain text string to escape\n * @returns HTML-safe string\n */\nexport function escapeHtml(text: string): string {\n  if (!text || typeof text !== 'string') return '';\n  return text\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;');\n}\n\n/**\n * Tags that are considered dangerous and will be completely removed.\n * These can execute scripts, load external resources, or manipulate the page.\n */\nconst DANGEROUS_TAGS = new Set(\n  'script|iframe|object|embed|form|input|button|textarea|select|link|meta|base|style|template|slot|portal|frame|frameset|applet|noscript|noembed|plaintext|xmp|listing|math'.split(\n    '|',\n  ),\n);\n\n/**\n * Attributes that are considered dangerous - event handlers and data loading.\n */\nconst DANGEROUS_ATTR_PATTERN = /^on\\w+$/i;\n\n/**\n * Attributes that can contain URLs which might be javascript: or data: URIs.\n */\nconst URL_ATTRS = new Set('href|src|action|formaction|data|srcdoc|xlink:href|poster|srcset'.split('|'));\n\n/**\n * Protocol patterns that are dangerous in URLs.\n */\nconst DANGEROUS_URL_PROTOCOL = /^\\s*(javascript|vbscript|data|blob):/i;\n\n/**\n * Sanitize an HTML string by removing dangerous tags and attributes.\n *\n * Prefer {@link setSanitizedHTML} wherever the result is destined for an\n * element: this function has to re-serialize the sanitized tree back to a\n * string, and the caller's `innerHTML =` then re-parses it. That\n * parse→serialize→parse round trip is the classic mutation-XSS vector, and it\n * costs a second parse. Use this overload only when a string is genuinely\n * required (e.g. the value is stored, compared, or handed to another API).\n *\n * @param html - Raw HTML string to sanitize\n * @returns Sanitized HTML string safe for innerHTML\n */\nexport function sanitizeHTML(html: string): string {\n  if (!html || typeof html !== 'string') return '';\n\n  // Fast path: if no HTML tags at all, return as-is (already safe)\n  if (html.indexOf('<') === -1) return html;\n\n  const template = document.createElement('template');\n  template.innerHTML = html;\n\n  sanitizeNode(template.content);\n\n  return template.innerHTML;\n}\n\n/**\n * Parse and sanitize an HTML string into a detached {@link DocumentFragment}.\n *\n * This is the primitive {@link setSanitizedHTML} builds on, exposed for callers\n * that need to inspect or relocate the nodes before insertion.\n *\n * @param html - Raw HTML string to sanitize\n * @returns Fragment containing the sanitized nodes (empty for falsy input)\n */\nexport function sanitizeToFragment(html: string): DocumentFragment {\n  const template = document.createElement('template');\n  if (html && typeof html === 'string') {\n    template.innerHTML = html;\n    sanitizeNode(template.content);\n  }\n  return template.content;\n}\n\n/**\n * Replace an element's children with the sanitized parse of `html`.\n *\n * **This is the canonical sink for user-supplied markup** — cell/header/group\n * renderer string returns, `gridConfig.icons.*`, light-DOM tool panel fallback\n * content, and any new extension point that turns a user string into markup.\n * `textContent` is wrong here (it renders SVG icon strings as literal text) and\n * raw `innerHTML` is wrong (it is an XSS sink).\n *\n * Nodes are moved from the parse fragment rather than re-serialized, so the\n * sanitized tree is exactly what lands in the document.\n *\n * @param el - Element whose children are replaced\n * @param html - Raw HTML string to sanitize and insert\n */\nexport function setSanitizedHTML(el: Element, html: string): void {\n  if (!html || typeof html !== 'string') {\n    el.replaceChildren();\n    return;\n  }\n  // Nothing for the parser to do: no markup and no entities to decode.\n  if (html.indexOf('<') === -1 && html.indexOf('&') === -1) {\n    el.textContent = html;\n    return;\n  }\n  el.replaceChildren(sanitizeToFragment(html));\n}\n\n/**\n * Recursively sanitize a DOM node tree.\n */\nfunction sanitizeNode(root: DocumentFragment | Element): void {\n  const toRemove: Element[] = [];\n\n  // Use querySelectorAll to find all elements, then filter\n  const elements = root.querySelectorAll('*');\n\n  for (const el of elements) {\n    const tagName = el.tagName.toLowerCase();\n\n    // Check if tag is dangerous\n    if (DANGEROUS_TAGS.has(tagName)) {\n      toRemove.push(el);\n      continue;\n    }\n\n    // SVG elements need special handling - they can contain script-like behavior\n    if (tagName === 'svg' || el.namespaceURI === 'http://www.w3.org/2000/svg') {\n      // Remove entire SVG if it has any suspicious attributes\n      const hasDangerousContent = Array.from(el.attributes).some(\n        (attr) => DANGEROUS_ATTR_PATTERN.test(attr.name) || attr.name === 'href' || attr.name === 'xlink:href',\n      );\n      if (hasDangerousContent) {\n        toRemove.push(el);\n        continue;\n      }\n    }\n\n    // Check and remove dangerous attributes\n    const attrsToRemove: string[] = [];\n    for (const attr of el.attributes) {\n      const attrName = attr.name.toLowerCase();\n\n      // Event handlers (onclick, onerror, onload, etc.)\n      if (DANGEROUS_ATTR_PATTERN.test(attrName)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // `is=` upgrades a plain tag into a registered customized built-in, so it\n      // can smuggle behaviour past the tag-name check above.\n      if (attrName === 'is') {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // URL attributes with dangerous protocols\n      if (URL_ATTRS.has(attrName) && DANGEROUS_URL_PROTOCOL.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // style attribute can contain expressions (IE) or url() with javascript:\n      if (attrName === 'style' && /expression\\s*\\(|javascript:|behavior\\s*:/i.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n    }\n\n    attrsToRemove.forEach((name) => el.removeAttribute(name));\n  }\n\n  // Remove dangerous elements (do this after iteration to avoid modifying during traversal)\n  toRemove.forEach((el) => el.remove());\n}\n\n// #endregion\n\n// #region Template Evaluation\n\n// #region Safe Expression Evaluator\n// A minimal recursive-descent evaluator for the token set allowed by SAFE_EXPR.\n// Replaces `new Function()` to avoid dynamic code execution warnings from\n// static analysis tools (socket.dev, npm audit) while maintaining identical\n// functionality for expressions that pass the allowlist guards.\n//\n// Supported grammar (matching SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/):\n//   ternary     → logicalOr ('?' ternary ':' ternary)?\n//   logicalOr   → logicalAnd ('||' logicalAnd)*\n//   logicalAnd  → equality ('&&' equality)*\n//   equality    → comparison (('==' | '!=' | '===' | '!==') comparison)*\n//   comparison  → additive (('<' | '>' | '<=' | '>=') additive)*\n//   additive    → multiplicative (('+' | '-') multiplicative)*\n//   multiplicative → unary (('*' | '/' | '%') unary)*\n//   unary       → '!' unary | primary\n//   primary     → NUMBER | STRING | IDENT ('.' IDENT)? | '(' ternary ')'\n\ntype Token =\n  { type: 'num'; v: number } | { type: 'str'; v: string } | { type: 'id'; v: string } | { type: 'op'; v: string };\n\nfunction tokenize(expr: string): Token[] | null {\n  const tokens: Token[] = [];\n  let i = 0;\n  while (i < expr.length) {\n    const ch = expr[i];\n    if (ch === ' ') {\n      i++;\n      continue;\n    }\n\n    // Numbers\n    if ((ch >= '0' && ch <= '9') || (ch === '.' && i + 1 < expr.length && expr[i + 1] >= '0' && expr[i + 1] <= '9')) {\n      const start = i;\n      while (i < expr.length && ((expr[i] >= '0' && expr[i] <= '9') || expr[i] === '.')) i++;\n      tokens.push({ type: 'num', v: Number(expr.slice(start, i)) });\n      continue;\n    }\n\n    // String literals (single-quoted only, per SAFE_EXPR)\n    if (ch === \"'\") {\n      let s = '';\n      i++; // skip opening quote\n      while (i < expr.length && expr[i] !== \"'\") s += expr[i++];\n      if (i >= expr.length) return null; // unterminated\n      i++; // skip closing quote\n      tokens.push({ type: 'str', v: s });\n      continue;\n    }\n\n    // Identifiers (value, row, row.field)\n    if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_' || ch === '$') {\n      const start = i;\n      while (i < expr.length && /[\\w$.]/.test(expr[i])) i++;\n      tokens.push({ type: 'id', v: expr.slice(start, i) });\n      continue;\n    }\n\n    // Multi-char operators\n    if (i + 2 < expr.length) {\n      const tri = expr.slice(i, i + 3);\n      if (tri === '===' || tri === '!==') {\n        tokens.push({ type: 'op', v: tri });\n        i += 3;\n        continue;\n      }\n    }\n    if (i + 1 < expr.length) {\n      const bi = expr.slice(i, i + 2);\n      if (bi === '==' || bi === '!=' || bi === '<=' || bi === '>=' || bi === '&&' || bi === '||') {\n        tokens.push({ type: 'op', v: bi });\n        i += 2;\n        continue;\n      }\n    }\n\n    // Single-char operators\n    if ('+-*/%<>!?:(),'.includes(ch)) {\n      tokens.push({ type: 'op', v: ch });\n      i++;\n      continue;\n    }\n\n    return null; // unexpected character\n  }\n  return tokens;\n}\n\nfunction safeEval(expr: string, ctx: EvalContext): unknown {\n  const toks = tokenize(expr);\n  if (!toks) return undefined;\n  const tokens: Token[] = toks;\n  let pos = 0;\n\n  function peek(): Token | undefined {\n    return tokens[pos];\n  }\n  function advance(): Token {\n    return tokens[pos++];\n  }\n  function match(type: string, val?: string): boolean {\n    const t = peek();\n    if (!t) return false;\n    if (t.type !== type) return false;\n    if (val !== undefined && t.v !== val) return false;\n    return true;\n  }\n\n  function resolveId(name: string): unknown {\n    if (name === 'value') return ctx.value;\n    if (name.startsWith('row.')) {\n      const key = name.slice(4);\n      return ctx.row ? ctx.row[key] : undefined;\n    }\n    if (name.startsWith('typeDefault.')) {\n      const key = name.slice('typeDefault.'.length);\n      return ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    }\n    // bare 'row' reference\n    if (name === 'row') return ctx.row;\n    if (name === 'typeDefault') return ctx.typeDefault;\n    return undefined;\n  }\n\n  function parseTernary(): unknown {\n    const result = parseLogicalOr();\n    if (match('op', '?')) {\n      advance(); // consume '?'\n      const consequent = parseTernary();\n      if (!match('op', ':')) return undefined;\n      advance(); // consume ':'\n      const alternate = parseTernary();\n      return result ? consequent : alternate;\n    }\n    return result;\n  }\n\n  function parseLogicalOr(): unknown {\n    let left = parseLogicalAnd();\n    while (match('op', '||')) {\n      advance();\n      left = left || parseLogicalAnd();\n    }\n    return left;\n  }\n\n  function parseLogicalAnd(): unknown {\n    let left = parseEquality();\n    while (match('op', '&&')) {\n      advance();\n      left = left && parseEquality();\n    }\n    return left;\n  }\n\n  function parseEquality(): unknown {\n    let left = parseComparison();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '===') {\n        advance();\n        left = left === parseComparison();\n      } else if (t.v === '!==') {\n        advance();\n        left = left !== parseComparison();\n      } else if (t.v === '==') {\n        advance();\n        left = left == parseComparison();\n      } else if (t.v === '!=') {\n        advance();\n        left = left != parseComparison();\n      } else break;\n    }\n    return left;\n  }\n\n  function parseComparison(): unknown {\n    let left = parseAdditive();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '<') {\n        advance();\n        left = (left as number) < (parseAdditive() as number);\n      } else if (t.v === '>') {\n        advance();\n        left = (left as number) > (parseAdditive() as number);\n      } else if (t.v === '<=') {\n        advance();\n        left = (left as number) <= (parseAdditive() as number);\n      } else if (t.v === '>=') {\n        advance();\n        left = (left as number) >= (parseAdditive() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseAdditive(): unknown {\n    let left = parseMultiplicative();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '+') {\n        advance();\n        left = (left as number) + (parseMultiplicative() as number);\n      } else if (t.v === '-') {\n        advance();\n        left = (left as number) - (parseMultiplicative() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseMultiplicative(): unknown {\n    let left = parseUnary();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '*') {\n        advance();\n        left = (left as number) * (parseUnary() as number);\n      } else if (t.v === '/') {\n        advance();\n        left = (left as number) / (parseUnary() as number);\n      } else if (t.v === '%') {\n        advance();\n        left = (left as number) % (parseUnary() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseUnary(): unknown {\n    if (match('op', '!')) {\n      advance();\n      return !parseUnary();\n    }\n    return parsePrimary();\n  }\n\n  function parsePrimary(): unknown {\n    const t = peek();\n    if (!t) return undefined;\n    if (t.type === 'num') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'str') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'id') {\n      advance();\n      return resolveId(t.v as string);\n    }\n    if (t.type === 'op' && t.v === '(') {\n      advance(); // consume '('\n      const result = parseTernary();\n      if (match('op', ')')) advance(); // consume ')'\n      return result;\n    }\n    // Unary minus for negative numbers\n    if (t.type === 'op' && t.v === '-') {\n      advance();\n      return -(parsePrimary() as number);\n    }\n    return undefined;\n  }\n\n  const result = parseTernary();\n  // Ensure all tokens were consumed\n  if (pos < tokens.length) return undefined;\n  return result;\n}\n// #endregion\n\nexport function evalTemplateString(raw: string, ctx: EvalContext): string {\n  if (!raw || raw.indexOf('{{') === -1) return raw; // fast path (no expressions)\n  const parts: { expr: string; result: string }[] = [];\n  const evaluated = raw.replace(EXPR_RE, (_m, expr) => {\n    const res = evalSingle(expr, ctx);\n    parts.push({ expr: expr.trim(), result: res });\n    // The template markup is author-controlled; the interpolated data is not.\n    // Escaping here stops row data from injecting elements or breaking out of\n    // an attribute (sanitizeHTML downstream only strips *dangerous* markup).\n    return res === EMPTY_SENTINEL ? res : escapeHtml(res);\n  });\n  const finalStr = postProcess(evaluated);\n  // If every part evaluated to EMPTY_SENTINEL we treat this as intentionally blank.\n  // If any expression was blocked due to forbidden token (EMPTY_SENTINEL) we *still* only output ''\n  // but do not escalate to BLOCKED_SENTINEL unless the original contained explicit forbidden tokens.\n  const allEmpty = parts.length && parts.every((p) => p.result === '' || p.result === EMPTY_SENTINEL);\n  const hadForbidden = REFLECTIVE_RE.test(raw);\n  if (hadForbidden || allEmpty) return '';\n  return finalStr;\n}\n\nfunction evalSingle(expr: string, ctx: EvalContext): string {\n  expr = (expr || '').trim();\n  if (!expr) return EMPTY_SENTINEL;\n  if (REFLECTIVE_RE.test(expr)) return EMPTY_SENTINEL;\n  if (expr === 'value') return ctx.value == null ? EMPTY_SENTINEL : String(ctx.value);\n  if (expr.startsWith('row.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice(4);\n    const v = ctx.row ? ctx.row[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.startsWith('typeDefault.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice('typeDefault.'.length);\n    const v = ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.length > 80) return EMPTY_SENTINEL;\n  if (!SAFE_EXPR.test(expr) || FORBIDDEN.test(expr)) return EMPTY_SENTINEL;\n  const dotChain = expr.match(/\\./g);\n  if (dotChain && dotChain.length > 1) return EMPTY_SENTINEL;\n  try {\n    const out = safeEval(expr, ctx);\n    const str = out == null ? '' : String(out);\n    if (REFLECTIVE_RE.test(str)) return EMPTY_SENTINEL;\n    return str || EMPTY_SENTINEL;\n  } catch {\n    return EMPTY_SENTINEL;\n  }\n}\n// #endregion\n\n// #region Cell Scrubbing\n/** Pattern matching reflective/introspective APIs that must be stripped from output. */\nconst REFLECTIVE_RE = /Reflect|Proxy|ownKeys/;\n\nfunction postProcess(s: string): string {\n  if (!s) return s;\n  return s.replace(new RegExp(EMPTY_SENTINEL, 'g'), '').replace(/Reflect\\.[^<>{}\\s]+|\\bProxy\\b|ownKeys\\([^)]*\\)/g, '');\n}\n\nexport function finalCellScrub(cell: HTMLElement): void {\n  if (!REFLECTIVE_RE.test(cell.textContent || '')) return;\n  // First pass: clear only text nodes containing forbidden tokens\n  for (const n of cell.childNodes) {\n    if (n.nodeType === Node.TEXT_NODE && REFLECTIVE_RE.test(n.textContent || '')) n.textContent = '';\n  }\n  // If forbidden tokens persist in element nodes, nuke everything\n  if (REFLECTIVE_RE.test(cell.textContent || '')) {\n    cell.textContent = '';\n  }\n}\n// #endregion\n\n// #region Template Compilation\nexport function compileTemplate(raw: string) {\n  if (REFLECTIVE_RE.test(raw)) {\n    const fn = (() => '') as CompiledViewFunction;\n    fn.__blocked = true;\n    return fn;\n  }\n  const fn = ((ctx: EvalContext) => evalTemplateString(raw, ctx)) as CompiledViewFunction;\n  fn.__blocked = false;\n  return fn;\n}\n// #endregion\n","/**\n * Base Grid Plugin Class\n *\n * All plugins extend this abstract class.\n * Plugins are instantiated per-grid and manage their own state.\n */\n\n// Injected by Vite at build time from package.json (same as grid.ts)\ndeclare const __GRID_VERSION__: string;\n\nimport type { HeaderContentDefinition, ToolPanelDefinition } from '../../plugins/shell/types';\nimport { DEFAULT_GRID_ICONS } from '../defaults';\nimport {\n  type DiagnosticCode,\n  PLUGIN_ALIAS_CONFIG_CONFLICT,\n  formatDiagnostic,\n  gridPrefix,\n} from '../internal/diagnostics';\nimport { setSanitizedHTML } from '../internal/sanitize';\nimport type {\n  ColumnConfig,\n  ColumnState,\n  GridConfig,\n  GridIcons,\n  GridPlugin,\n  IconValue,\n  PluginNameMap,\n  Translate,\n} from '../types';\n\n// Re-export shared plugin types for convenience\nexport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellCoords,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  ContextMenuItem,\n  ContextMenuParams,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  KeyboardModifiers,\n  PluginCellRenderContext,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\nimport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\n/**\n * Grid element interface for plugins.\n * Extends GridElementRef with plugin-specific methods.\n * Note: effectiveConfig is already available from GridElementRef.\n */\nexport interface GridElement extends GridElementRef {\n  getPlugin<T extends GridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName<K extends string>(\n    name: K,\n  ): (K extends keyof PluginNameMap ? PluginNameMap[K] : BaseGridPlugin) | undefined;\n  /**\n   * Get a plugin's state by plugin name.\n   * This is a loose-coupling method for plugins to access other plugins' state\n   * without importing the plugin class directly.\n   * @internal Plugin API\n   */\n  getPluginState?(name: string): unknown;\n\n  // Focus Management\n  /** Register an external DOM element as a logical focus container. @internal Plugin API */\n  registerExternalFocusContainer?(el: Element): void;\n  /** Unregister a previously registered external focus container. @internal Plugin API */\n  unregisterExternalFocusContainer?(el: Element): void;\n  /** Check whether focus is logically inside this grid (own DOM + external containers). @internal Plugin API */\n  containsFocus?(node?: Node | null): boolean;\n}\n\n/**\n * Header render context for plugin header renderers.\n */\nexport interface PluginHeaderRenderContext {\n  /** Column configuration */\n  column: ColumnConfig;\n  /** Column index */\n  colIndex: number;\n}\n\n// ============================================================================\n// Plugin Dependency Types\n// ============================================================================\n\n/**\n * Declares a dependency on another plugin.\n *\n * @category Plugin Development\n * @example\n * ```typescript\n * export class UndoRedoPlugin extends BaseGridPlugin {\n *   static readonly dependencies: PluginDependency[] = [\n *     { name: 'editing', required: true },\n *   ];\n * }\n * ```\n * @since 0.4.1\n */\nexport interface PluginDependency {\n  /**\n   * The name of the required plugin (matches the plugin's `name` property).\n   * Use string names for loose coupling - avoids static imports.\n   */\n  name: string;\n\n  /**\n   * Whether this dependency is required (hard) or optional (soft).\n   * - `true`: Plugin cannot function without it. Throws error if missing.\n   * - `false`: Plugin works with reduced functionality. Silent if missing\n   *   (set {@link severity} to `'warn'` or `'info'` to opt into a message).\n   * @default true\n   */\n  required?: boolean;\n\n  /**\n   * Explicit severity when this dependency is missing. Overrides the default\n   * derived from {@link required}.\n   * - `'error'`: throw (halts grid setup). Default when `required` is not `false`.\n   * - `'warn'`: log a console warning and continue (development only).\n   * - `'info'`: log a verbose console.debug message and continue (development only).\n   *\n   * When omitted, a missing hard dependency throws and a missing soft\n   * dependency is silent — preserving backward-compatible behavior.\n   * @since 2.16.0\n   */\n  severity?: 'error' | 'warn' | 'info';\n\n  /**\n   * Optional predicate that gates whether this dependency applies, evaluated\n   * against the depending plugin's own resolved configuration (defaults merged\n   * with user config). Return `false` to skip the dependency entirely.\n   *\n   * Lets a plugin require/recommend another plugin only under certain config\n   * — e.g. a plugin that needs a tool-panel host only when its tool panel is\n   * enabled. When omitted, the dependency always applies.\n   * @example when: (cfg: PivotConfig) => cfg.showToolPanel === true\n   * @since 2.16.0\n   */\n  when?: (pluginConfig: unknown) => boolean;\n\n  /**\n   * Human-readable reason for this dependency.\n   * Shown in error/info messages to help users understand why.\n   * @example \"UndoRedoPlugin needs EditingPlugin to track cell edits\"\n   */\n  reason?: string;\n}\n\n/**\n * Declares an incompatibility between plugins.\n * When both plugins are loaded, a warning is logged to help users understand the conflict.\n *\n * @category Plugin Development\n */\nexport interface PluginIncompatibility {\n  /**\n   * The name of the incompatible plugin (matches the plugin's `name` property).\n   */\n  name: string;\n\n  /**\n   * Human-readable reason for the incompatibility.\n   * Should explain why the plugins conflict and any workarounds.\n   * @example \"Both transform the entire row model in different ways\"\n   */\n  reason: string;\n}\n\n// ============================================================================\n// Plugin Query & Event Definitions\n// ============================================================================\n\n/**\n * Defines a query that a plugin can handle.\n * Other plugins or the grid can send this query type to retrieve data.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * queries: [\n *   {\n *     type: 'canMoveColumn',\n *     description: 'Check if a column can be moved/reordered',\n *   },\n * ]\n *\n * // In plugin class\n * handleQuery(query: PluginQuery): unknown {\n *   if (query.type === 'canMoveColumn') {\n *     return this.canMoveColumn(query.context);\n *   }\n * }\n * ```\n * @since 1.8.0\n */\nexport interface QueryDefinition {\n  /**\n   * The query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems').\n   * Should be unique across all plugins.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the query does.\n   */\n  description?: string;\n}\n\n/**\n * Defines an event that a plugin can emit.\n * Other plugins can subscribe to these events via the Event Bus.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * events: [\n *   {\n *     type: 'filter-change',\n *     description: 'Emitted when filter criteria change',\n *   },\n * ]\n *\n * // In plugin class - emit\n * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n *\n * // In another plugin - subscribe\n * this.on('filter-change', (detail) => console.log('Filter changed:', detail));\n * ```\n * @since 1.8.0\n */\nexport interface EventDefinition {\n  /**\n   * The event type identifier (e.g., 'filter-change', 'selection-change').\n   * Used when emitting and subscribing to events.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the event represents.\n   */\n  description?: string;\n\n  /**\n   * Whether this event is cancelable via `event.preventDefault()`.\n   * @default false\n   */\n  cancelable?: boolean;\n}\n\n// ============================================================================\n// Plugin Manifest Types\n// ============================================================================\n\n/**\n * Defines a property that a plugin \"owns\" - used for configuration validation.\n * When this property is used without the owning plugin loaded, an error is thrown.\n *\n * @category Plugin Development\n */\nexport interface PluginPropertyDefinition {\n  /** The property name on column or grid config */\n  property: string;\n  /** Whether this is a column-level or config-level property */\n  level: 'column' | 'config';\n  /** Human-readable description for error messages (e.g., 'the \"editable\" column property') */\n  description: string;\n  /** Import path hint for error messages (e.g., \"import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\") */\n  importHint?: string;\n  /** Custom check for whether property is considered \"used\" (default: truthy value check) */\n  isUsed?: (value: unknown) => boolean;\n}\n\n/**\n * A configuration validation rule for detecting invalid/conflicting settings.\n * Plugins declare rules in their manifest; the validator executes them during grid initialization.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n */\nexport interface PluginConfigRule<TConfig = unknown> {\n  /** Rule identifier for debugging (e.g., 'selection/range-dblclick') */\n  id: string;\n  /** Severity: 'error' throws, 'warn' logs warning */\n  severity: 'error' | 'warn';\n  /** Human-readable message shown when rule is violated */\n  message: string;\n  /** Predicate returning true if the rule is VIOLATED (i.e., config is invalid) */\n  check: (pluginConfig: TConfig) => boolean;\n}\n\n/**\n * Hook names that can have execution priority configured.\n *\n * @category Plugin Development\n */\nexport type HookName =\n  | 'processColumns'\n  | 'processConfig'\n  | 'processRows'\n  | 'afterStructuralRender'\n  | 'afterRender'\n  | 'afterCellRender'\n  | 'afterRowRender'\n  | 'onCellClick'\n  | 'onCellMouseDown'\n  | 'onCellMouseMove'\n  | 'onCellMouseUp'\n  | 'onHeaderClick'\n  | 'onKeyDown'\n  | 'onRowClick'\n  | 'onScroll'\n  | 'onScrollRender';\n\n/**\n * Static metadata about a plugin's capabilities and requirements.\n * Declared as a static property on plugin classes.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n *\n * @example\n * ```typescript\n * export class MyPlugin extends BaseGridPlugin<MyConfig> {\n *   static override readonly manifest: PluginManifest<MyConfig> = {\n *     ownedProperties: [\n *       { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n *     ],\n *     configRules: [\n *       { id: 'my-plugin/invalid-combo', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n *     ],\n *   };\n *   readonly name = 'myPlugin';\n * }\n * ```\n * @since 1.1.0\n */\nexport interface PluginManifest<TConfig = unknown> {\n  /**\n   * Properties this plugin owns - validated by validate-config.ts.\n   * If a user uses one of these properties without loading the plugin, an error is thrown.\n   */\n  ownedProperties?: PluginPropertyDefinition[];\n\n  /**\n   * Hook execution priority (higher = later, default 0).\n   * Use negative values to run earlier, positive to run later.\n   */\n  hookPriority?: Partial<Record<HookName, number>>;\n\n  /**\n   * Configuration validation rules - checked during grid initialization.\n   * Rules with severity 'error' throw, 'warn' logs to console.\n   */\n  configRules?: PluginConfigRule<TConfig>[];\n\n  /**\n   * Plugins that are incompatible with this plugin.\n   * When both plugins are loaded together, a warning is shown.\n   *\n   * @example\n   * ```typescript\n   * incompatibleWith: [\n   *   { name: 'tree', reason: 'Both transform the entire row model in different ways' },\n   * ],\n   * ```\n   */\n  incompatibleWith?: PluginIncompatibility[];\n\n  /**\n   * Queries this plugin can handle.\n   * Declares what query types this plugin responds to via `handleQuery()`.\n   * This replaces the centralized PLUGIN_QUERIES approach with manifest-declared queries.\n   *\n   * @example\n   * ```typescript\n   * queries: [\n   *   { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   * ],\n   * ```\n   */\n  queries?: QueryDefinition[];\n\n  /**\n   * Events this plugin can emit.\n   * Declares what event types other plugins can subscribe to via `on()`.\n   *\n   * @example\n   * ```typescript\n   * events: [\n   *   { type: 'filter-change', description: 'Emitted when filter criteria change' },\n   * ],\n   * ```\n   */\n  events?: EventDefinition[];\n\n  /**\n   * Whether this plugin's `processRows` hook injects or removes rows\n   * (group headers, tree nodes, pivot aggregates, placeholders, etc.).\n   *\n   * When true, the core sorting module delegates to the render scheduler\n   * instead of sorting `_rows` in-place, because `_rows` may contain\n   * plugin-generated marker objects that would be corrupted by a direct sort.\n   *\n   * Plugins that only **filter** or **reorder** existing rows (e.g. Filtering,\n   * MultiSort) should leave this unset or set it to `false`.\n   */\n  modifiesRowStructure?: boolean;\n}\n\n/** Convert camelCase icon key to kebab-case data-icon attribute value. */\nexport function toIconAttr(key: string): string {\n  return key.replace(/([A-Z])/g, '-$1').toLowerCase();\n}\n\n/**\n * Abstract base class for all grid plugins.\n *\n * @category Plugin Development\n * @template TConfig - Configuration type for the plugin\n * @since 0.1.1\n */\nexport abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {\n  /**\n   * Plugin dependencies - declare other plugins this one requires.\n   *\n   * Dependencies are validated when the plugin is attached.\n   * Required dependencies throw an error if missing. Optional dependencies are\n   * silent by default; set a {@link PluginDependency.severity} of `'warn'` or\n   * `'info'` to opt into a development-only log.\n   *\n   * @example\n   * ```typescript\n   * static readonly dependencies: PluginDependency[] = [\n   *   { name: 'editing', required: true, reason: 'Tracks cell edits for undo/redo' },\n   *   { name: 'selection', required: false, reason: 'Enables selection-based undo' },\n   * ];\n   * ```\n   */\n  static readonly dependencies?: PluginDependency[];\n\n  /**\n   * Plugin manifest - declares owned properties, config rules, and hook priorities.\n   *\n   * This is read by the configuration validator to:\n   * - Validate that required plugins are loaded when their properties are used\n   * - Execute configRules to detect invalid/conflicting settings\n   * - Order hook execution based on priority\n   *\n   * @example\n   * ```typescript\n   * static override readonly manifest: PluginManifest<MyConfig> = {\n   *   ownedProperties: [\n   *     { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n   *   ],\n   *   configRules: [\n   *     { id: 'myPlugin/conflict', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n   *   ],\n   * };\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static readonly manifest?: PluginManifest<any>;\n\n  /** Unique plugin identifier (derived from class name by default) */\n  abstract readonly name: string;\n\n  /**\n   * Alternative names for backward compatibility.\n   * `getPluginByName()` matches against both `name` and `aliases`.\n   * @internal\n   */\n  readonly aliases?: readonly string[];\n\n  /**\n   * Plugin version - defaults to grid version for built-in plugins.\n   * Third-party plugins can override with their own semver.\n   */\n  readonly version: string = typeof __GRID_VERSION__ !== 'undefined' ? __GRID_VERSION__ : 'dev';\n\n  /** CSS styles to inject via `document.adoptedStyleSheets` */\n  readonly styles?: string;\n\n  /** Custom cell renderers keyed by type name */\n  readonly cellRenderers?: Record<string, CellRenderer>;\n\n  /** Custom header renderers keyed by type name */\n  readonly headerRenderers?: Record<string, HeaderRenderer>;\n\n  /** Custom cell editors keyed by type name */\n  readonly cellEditors?: Record<string, CellEditor>;\n\n  /** The grid instance this plugin is attached to */\n  protected grid!: GridElement;\n\n  /** Plugin configuration - merged with defaults in attach() */\n  protected config!: TConfig;\n\n  /** User-provided configuration from constructor */\n  protected readonly userConfig: Partial<TConfig>;\n\n  /**\n   * Plugin-level AbortController for event listener cleanup.\n   * Created fresh in attach(), aborted in detach().\n   * This ensures event listeners are properly cleaned up when plugins are re-attached.\n   */\n  #abortController?: AbortController;\n\n  /**\n   * Default configuration - subclasses should override this getter.\n   * Note: This must be a getter (not property initializer) for proper inheritance\n   * since property initializers run after parent constructor.\n   */\n  protected get defaultConfig(): Partial<TConfig> {\n    return {};\n  }\n\n  constructor(config: Partial<TConfig> = {}) {\n    this.userConfig = config;\n  }\n\n  /**\n   * Effective configuration (defaults merged with user config), resolved\n   * eagerly so it is available **before** {@link attach} runs. Dependency\n   * validation happens before `attach()` merges {@link config}, so config\n   * -conditional dependency `when` predicates evaluate against this getter.\n   *\n   * While attached, returns the already-merged {@link config}; otherwise\n   * recomputes `defaultConfig` + `userConfig` fresh. `config` is intentionally\n   * **not** trusted when detached because {@link detach} does not clear it — a\n   * re-validated plugin would otherwise see stale config from a prior\n   * attachment. The {@link attach}-managed abort controller is the\n   * attached/detached signal.\n   * @internal Plugin infrastructure (used by `validatePluginDependencies`).\n   */\n  get resolvedConfig(): TConfig {\n    return (this.#abortController ? this.config : { ...this.defaultConfig, ...this.userConfig }) as TConfig;\n  }\n\n  /**\n   * Merge user-supplied configuration from other plugin instances into this\n   * plugin's `userConfig`. Used by `PluginManager.attachAll()`'s alias-collapse\n   * pre-pass: when a consumer instantiates the same plugin more than once (or\n   * under an alias name), only one instance is attached, and the other\n   * instances' configs are folded in via this method.\n   *\n   * Merge rules (shallow):\n   *\n   * - Same key, **same value** → silent.\n   * - Same key, **different values** (incl. function vs function) → throws\n   *   a diagnostic naming the conflicting key. Conflicting callbacks\n   *   (`canDrag`, `canDrop`, etc.) cannot be reconciled automatically.\n   * - **Disjoint keys** → merged cleanly.\n   *\n   * Subclasses may override to implement custom deep-merge logic, but should\n   * call `super.mergeConfigsFrom(others)` to inherit the conflict-detection.\n   *\n   * @internal Plugin infrastructure (used by `PluginManager.attachAll`).\n   * @throws Error with diagnostic code `TBW025` when configs conflict.\n   */\n  mergeConfigsFrom(others: readonly BaseGridPlugin<TConfig>[]): void {\n    if (others.length === 0) return;\n    const merged = { ...this.userConfig } as Record<string, unknown>;\n    const sources: Record<string, BaseGridPlugin<TConfig>> = {};\n    for (const key of Object.keys(merged)) sources[key] = this;\n    for (const other of others) {\n      const otherConfig = other.userConfig as Record<string, unknown>;\n      for (const [key, value] of Object.entries(otherConfig)) {\n        if (value === undefined) continue;\n        if (!(key in merged)) {\n          merged[key] = value;\n          sources[key] = other;\n          continue;\n        }\n        if (merged[key] === value) continue;\n        // Conflict\n        const ownerA = sources[key]?.constructor.name ?? this.constructor.name;\n        const ownerB = other.constructor.name;\n        const code = formatDiagnostic(\n          PLUGIN_ALIAS_CONFIG_CONFLICT,\n          `Cannot merge plugin configs for \"${this.name}\": conflicting value for \"${key}\" supplied by both ${ownerA} and ${ownerB}. Pass the option on a single instance, or remove the duplicate.`,\n          undefined,\n          this.name,\n        );\n        throw new Error(code);\n      }\n    }\n    // Mutate userConfig in place so re-attach picks it up via attach().\n    // `userConfig` is declared `readonly` to prevent reassigning the binding,\n    // but the object's own properties are intentionally mutable for this\n    // alias-collapse pre-pass. A single cast to a record is enough — no\n    // `as unknown as` double-cast needed.\n    Object.assign(this.userConfig as Record<string, unknown>, merged);\n  }\n\n  /**\n   * Replace this plugin's `userConfig` with a freshly-resolved sibling\n   * instance's config. Used by the grid's per-grid feature-instance gate\n   * (`#initializePlugins`): when a feature is re-resolved across a config\n   * change, the **existing** instance is reused — so its accumulated state\n   * survives — but it must adopt the latest `gridConfig.features.<name>`\n   * value. Unlike {@link mergeConfigsFrom}, this is last-write-wins with no\n   * conflict detection: the re-resolved instance is authoritative.\n   *\n   * `attach()` recomputes {@link config} from `userConfig`, so updating\n   * `userConfig` here is enough for the reused instance to pick up the new\n   * config on its next attach during the same `#initializePlugins` pass.\n   *\n   * @internal Plugin infrastructure (used by the grid feature gate).\n   */\n  refreshUserConfigFrom(other: BaseGridPlugin<TConfig>): void {\n    const target = this.userConfig as Record<string, unknown>;\n    // Snapshot the source BEFORE clearing `target`. A feature factory may\n    // store the consumer's config object by reference (e.g. `new\n    // ContextMenuPlugin(config)`), and a consumer that passes the *same* config\n    // object across re-resolutions (common when `gridConfig` is a recomputed\n    // Angular `computed()`) makes `this.userConfig === other.userConfig`.\n    // Without this snapshot, the `delete` loop below would empty that shared\n    // object first, then `Object.assign` would copy back nothing — silently\n    // wiping the config and falling back to plugin defaults. (#contextMenu)\n    const source = { ...(other.userConfig as Record<string, unknown>) };\n    for (const key of Object.keys(target)) delete target[key];\n    Object.assign(target, source);\n  }\n\n  /**\n   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   *\n   * @example\n   * ```ts\n   * attach(grid: GridElement): void {\n   *   super.attach(grid);\n   *   // Set up document-level listeners with auto-cleanup\n   *   document.addEventListener('keydown', this.handleEscape, {\n   *     signal: this.disconnectSignal\n   *   });\n   * }\n   * ```\n   */\n  attach(grid: GridElement): void {\n    // Abort any previous abort controller (in case of re-attach without detach)\n    this.#abortController?.abort();\n    // Create fresh abort controller for this attachment\n    this.#abortController = new AbortController();\n\n    this.grid = grid;\n    // Merge config here (after subclass construction is complete)\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\n  }\n\n  /**\n   * Called when the plugin is detached from a grid.\n   * Override to clean up event listeners, timers, etc.\n   *\n   * @example\n   * ```ts\n   * detach(): void {\n   *   // Clean up any state not handled by disconnectSignal\n   *   this.selectedRows.clear();\n   *   this.cache = null;\n   * }\n   * ```\n   */\n  detach(): void {\n    // Abort the plugin's abort controller to clean up all event listeners\n    // registered with { signal: this.disconnectSignal }\n    this.#abortController?.abort();\n    this.#abortController = undefined;\n    // Override in subclass for additional cleanup\n  }\n\n  /**\n   * Called when another plugin is attached to the same grid.\n   * Use for inter-plugin coordination, e.g., to integrate with new plugins.\n   *\n   * @param name - The name of the plugin that was attached\n   * @param plugin - The plugin instance (for direct access if needed)\n   *\n   * @example\n   * ```ts\n   * onPluginAttached(name: string, plugin: BaseGridPlugin): void {\n   *   if (name === 'selection') {\n   *     // Integrate with selection plugin\n   *     this.selectionPlugin = plugin as SelectionPlugin;\n   *   }\n   * }\n   * ```\n   */\n  onPluginAttached?(name: string, plugin: BaseGridPlugin): void;\n\n  /**\n   * Called when another plugin is detached from the same grid.\n   * Use to clean up inter-plugin references.\n   *\n   * @param name - The name of the plugin that was detached\n   *\n   * @example\n   * ```ts\n   * onPluginDetached(name: string): void {\n   *   if (name === 'selection') {\n   *     this.selectionPlugin = undefined;\n   *   }\n   * }\n   * ```\n   */\n  onPluginDetached?(name: string): void;\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\n   *\n   * **Prefer {@link BaseGridPlugin.grid grid.getPluginByName()}** when you don't need the class import.\n   *\n   * @example\n   * ```ts\n   * // Preferred: by name\n   * const selection = this.grid?.getPluginByName('selection');\n   *\n   * // Alternative: by class\n   * const selection = this.getPlugin(SelectionPlugin);\n   * if (selection) {\n   *   const selectedRows = selection.getSelectedRows();\n   * }\n   * ```\n   */\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\n    return this.grid?.getPlugin(PluginClass);\n  }\n\n  /**\n   * Emit a custom event from the grid.\n   */\n  protected emit<T>(eventName: string, detail: T): void {\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\n  }\n\n  /**\n   * Emit a cancelable custom event from the grid.\n   * @returns `true` if the event was cancelled (preventDefault called), `false` otherwise\n   */\n  protected emitCancelable<T>(eventName: string, detail: T): boolean {\n    const event = new CustomEvent(eventName, { detail, bubbles: true, cancelable: true });\n    this.grid?.dispatchEvent?.(event);\n    return event.defaultPrevented;\n  }\n\n  // =========================================================================\n  // Event Bus - Plugin-to-Plugin Communication\n  // =========================================================================\n\n  /**\n   * Subscribe to an event from another plugin.\n   * The subscription is automatically cleaned up when this plugin is detached.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to listen for (e.g., 'filter-change')\n   * @param callback - The callback to invoke when the event is emitted\n   *\n   * @example\n   * ```typescript\n   * // In attach() or other initialization\n   * this.on('filter-change', (detail) => {\n   *   console.log('Filter changed:', detail);\n   * });\n   * ```\n   */\n  protected on<T = unknown>(eventType: string, callback: (detail: T) => void): void {\n    this.grid?._pluginManager?.subscribe(this, eventType, callback as (detail: unknown) => void);\n  }\n\n  /**\n   * Unsubscribe from a plugin event.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to stop listening for\n   *\n   * @example\n   * ```typescript\n   * this.off('filter-change');\n   * ```\n   */\n  protected off(eventType: string): void {\n    this.grid?._pluginManager?.unsubscribe(this, eventType);\n  }\n\n  /**\n   * Emit an event to other plugins via the Event Bus.\n   * This is for inter-plugin communication only; it does NOT dispatch DOM events.\n   * Use `emit()` to dispatch DOM events that external consumers can listen to.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to emit (should be declared in manifest.events)\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Emit to other plugins (not DOM)\n   * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n   *\n   * // For DOM events that consumers can addEventListener to:\n   * this.emit('filter-change', { field: 'name', value: 'Alice' });\n   * ```\n   */\n  protected emitPluginEvent<T>(eventType: string, detail: T): void {\n    this.grid?._pluginManager?.emitPluginEvent(eventType, detail);\n  }\n\n  /**\n   * Emit an event to **both** the plugin Event Bus (for inter-plugin communication)\n   * **and** the DOM (for external consumers via `addEventListener`).\n   *\n   * Use this when a state change is relevant to both other plugins and external\n   * consumers. For example, `sort-change` needs to invalidate Selection (plugin bus)\n   * and notify the host application (DOM event).\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to broadcast\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Notify both plugins and consumers of a sort change\n   * this.broadcast('sort-change', { sortModel: [...this.sortModel] });\n   * ```\n   */\n  protected broadcast<T>(eventType: string, detail: T): void {\n    this.emitPluginEvent(eventType, detail);\n    this.emit(eventType, detail);\n  }\n\n  /**\n   * Run a yes/no plugin query and reduce the responses to a single boolean.\n   *\n   * `grid.query()` always returns an **array** of responses (empty when no\n   * plugin handles the query), and `[]` is truthy in JavaScript — so testing\n   * the raw result directly (`if (grid.query(...))`) is always `true` and\n   * silently takes the \"some plugin said yes\" branch even when nothing\n   * answered. Always route boolean queries through this helper.\n   *\n   * @category Plugin Development\n   * @param type - The query type to dispatch\n   * @param context - Optional query context passed to the handlers\n   * @returns `true` only when at least one plugin answered truthily\n   *\n   * @example\n   * ```typescript\n   * if (this.queryBoolean('datasource:is-active')) {\n   *   // A ServerSide data source really is installed\n   * }\n   * ```\n   * @since 3.4.0\n   */\n  protected queryBoolean(type: string, context: unknown = null): boolean {\n    const responses = this.grid?.query?.(type, context);\n    // Tolerate hosts/tests that hand back a bare value instead of the array.\n    return Array.isArray(responses) ? responses.some(Boolean) : !!responses;\n  }\n\n  /**\n   * Request a re-render of the grid.\n   * Uses ROWS phase - does NOT trigger processColumns hooks.\n   */\n  protected requestRender(): void {\n    this.grid?.requestRender?.();\n  }\n\n  /**\n   * Request a columns re-render of the grid.\n   * Uses COLUMNS phase - triggers processColumns hooks.\n   * Use this when your plugin needs to reprocess column configuration.\n   */\n  protected requestColumnsRender(): void {\n    (this.grid as { requestColumnsRender?: () => void })?.requestColumnsRender?.();\n  }\n\n  /**\n   * Request a re-render and restore focus styling afterward.\n   * Use this when a plugin action (like expand/collapse) triggers a render\n   * but needs to maintain keyboard navigation focus.\n   */\n  protected requestRenderWithFocus(): void {\n    this.grid?.requestRenderWithFocus?.();\n  }\n\n  /**\n   * Request a lightweight style update without rebuilding DOM.\n   * Use this instead of requestRender() when only CSS classes need updating.\n   */\n  protected requestAfterRender(): void {\n    this.grid?.requestAfterRender?.();\n  }\n\n  /**\n   * Re-render visible rows without rebuilding the row model or recalculating geometry.\n   * Use this when row data has been updated in-place (e.g., server-side block loads)\n   * and only the visible viewport needs to re-render.\n   */\n  protected requestVirtualRefresh(): void {\n    this.grid?.requestVirtualRefresh?.();\n  }\n\n  /**\n   * Get the current rows from the grid.\n   */\n  protected get rows(): any[] {\n    return this.grid?.rows ?? [];\n  }\n\n  /**\n   * Get the original unfiltered/unprocessed rows from the grid.\n   * Use this when you need all source data regardless of active filters.\n   */\n  protected get sourceRows(): any[] {\n    return this.grid?.sourceRows ?? [];\n  }\n\n  /**\n   * Get the current columns from the grid.\n   */\n  protected get columns(): ColumnConfig[] {\n    return this.grid?.columns ?? [];\n  }\n\n  /**\n   * Get only visible columns from the grid (excludes hidden).\n   * Use this for rendering that needs to match the grid template.\n   */\n  protected get visibleColumns(): ColumnConfig[] {\n    return this.grid?._visibleColumns ?? [];\n  }\n\n  /**\n   * Get the grid as an HTMLElement for direct DOM operations.\n   * Use sparingly - prefer the typed GridElementRef API when possible.\n   *\n   * @example\n   * ```ts\n   * const width = this.gridElement.clientWidth;\n   * this.gridElement.classList.add('my-plugin-active');\n   * ```\n   */\n  protected get gridElement(): HTMLElement {\n    return this.grid?._hostElement;\n  }\n\n  /**\n   * Get the disconnect signal for event listener cleanup.\n   * This signal is aborted when the grid disconnects from the DOM.\n   * Use this when adding event listeners that should be cleaned up automatically.\n   *\n   * Best for:\n   * - Document/window-level listeners added in attach()\n   * - Listeners on the grid element itself\n   * - Any listener that should persist across renders\n   *\n   * Not needed for:\n   * - Listeners on elements created in afterRender() (removed with element)\n   *\n   * @example\n   * element.addEventListener('click', handler, { signal: this.disconnectSignal });\n   * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });\n   */\n  protected get disconnectSignal(): AbortSignal {\n    // Return the plugin's own abort signal for proper cleanup on detach/re-attach\n    // Falls back to grid's signal if plugin's controller not yet created\n    return this.#abortController?.signal ?? this.grid?.disconnectSignal;\n  }\n\n  /**\n   * Get the grid-level icons configuration.\n   * Returns merged icons (user config + defaults).\n   */\n  protected get gridIcons(): Required<GridIcons> {\n    const userIcons = this.grid?.gridConfig?.icons ?? {};\n    return { ...DEFAULT_GRID_ICONS, ...userIcons };\n  }\n\n  /**\n   * Resolve a user-visible string from {@link GridConfig.locale}, falling back to\n   * the English default supplied at the call site.\n   *\n   * The fallback is passed inline rather than read from a shipped default map so\n   * that a plugin's strings live in the plugin's own chunk.\n   *\n   * @param key - Namespaced message id, e.g. `'filter.apply'`.\n   * @param fallback - English text used when the key is not overridden.\n   * @since 3.5.0\n   *\n   * @example\n   * ```ts\n   * applyBtn.textContent = this.t('filter.apply', 'Apply');\n   * ```\n   */\n  protected t(key: string, fallback: string): string {\n    return this.grid?.effectiveConfig?.locale?.[key] ?? fallback;\n  }\n\n  /**\n   * A bound `t()` suitable for handing to standalone renderer\n   * helpers and public renderer callbacks.\n   * @since 3.5.0\n   */\n  protected get translate(): Translate {\n    return (key, fallback) => this.t(key, fallback);\n  }\n\n  // #region Animation Helpers\n\n  /**\n   * Check if animations are enabled at the grid level.\n   * Respects gridConfig.animation.mode and the CSS variable set by the grid.\n   *\n   * Plugins should use this to skip animations when:\n   * - Animation mode is 'off' or `false`\n   * - User prefers reduced motion and mode is 'reduced-motion' (default)\n   *\n   * @example\n   * ```ts\n   * private get animationStyle(): 'slide' | 'fade' | false {\n   *   if (!this.isAnimationEnabled) return false;\n   *   return this.config.animation ?? 'slide';\n   * }\n   * ```\n   */\n  protected get isAnimationEnabled(): boolean {\n    const mode = this.grid?.effectiveConfig?.animation?.mode ?? 'reduced-motion';\n\n    // Explicit off = disabled\n    if (mode === false || mode === 'off') return false;\n\n    // Explicit on = always enabled\n    if (mode === true || mode === 'on') return true;\n\n    // reduced-motion: check CSS variable (set by grid based on media query)\n    const host = this.gridElement;\n    if (host) {\n      const enabled = getComputedStyle(host).getPropertyValue('--tbw-animation-enabled').trim();\n      return enabled !== '0';\n    }\n\n    return true; // Default to enabled\n  }\n\n  /**\n   * Get the animation duration in milliseconds from CSS variable.\n   * Falls back to 200ms if not set.\n   *\n   * Plugins can use this for their animation timing to stay consistent\n   * with the grid-level animation.duration setting.\n   *\n   * @example\n   * ```ts\n   * element.animate(keyframes, { duration: this.animationDuration });\n   * ```\n   */\n  protected get animationDuration(): number {\n    const host = this.gridElement;\n    if (host) {\n      const durationStr = getComputedStyle(host).getPropertyValue('--tbw-animation-duration').trim();\n      const parsed = parseInt(durationStr, 10);\n      if (!isNaN(parsed)) return parsed;\n    }\n    return 200; // Default\n  }\n\n  // #endregion\n\n  /**\n   * Set an icon on an element using the CSS-first hybrid approach.\n   *\n   * Sets `data-icon` for CSS pseudo-element rendering and `data-expanded` for\n   * expand/collapse toggle elements. Only injects DOM content when a JS override\n   * is present (via `gridConfig.icons` or `pluginOverride`), which naturally\n   * suppresses the CSS `::before` via the `:empty` selector.\n   *\n   * @param element - The element to set the icon on\n   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')\n   * @param pluginOverride - Optional plugin-level override (string or HTMLElement)\n   */\n  protected setIcon(element: HTMLElement, iconKey: keyof GridIcons, pluginOverride?: IconValue): void {\n    // Set data-icon attribute for CSS targeting (always)\n    element.dataset.icon = toIconAttr(iconKey);\n\n    // Set data-expanded for toggle elements (tree, group, master-detail)\n    if (iconKey === 'collapse') {\n      element.dataset.expanded = '';\n    } else if (iconKey === 'expand') {\n      delete element.dataset.expanded;\n    }\n\n    // Resolve JS-only icon (returns undefined when CSS default should be used)\n    const jsIcon = this.#resolveJsIcon(iconKey, pluginOverride);\n\n    if (jsIcon !== undefined) {\n      // JS override: inject content (suppresses CSS ::before via :empty)\n      if (typeof jsIcon === 'string') {\n        setSanitizedHTML(element, jsIcon);\n      } else if (jsIcon instanceof HTMLElement) {\n        element.replaceChildren(jsIcon.cloneNode(true));\n      }\n    } else {\n      // CSS path: ensure element is empty so ::before renders\n      element.innerHTML = '';\n    }\n  }\n\n  /**\n   * Resolve JS-only icon override. Returns undefined if CSS default should render.\n   * Only returns a value when the user explicitly set gridConfig.icons[key] or\n   * the plugin passed an override.\n   */\n  #resolveJsIcon(iconKey: keyof GridIcons, pluginOverride?: IconValue): IconValue | undefined {\n    if (pluginOverride !== undefined) return pluginOverride;\n    return this.grid?.gridConfig?.icons?.[iconKey];\n  }\n\n  /**\n   * Create or replace a sort indicator on a header cell.\n   *\n   * Handles the full lifecycle: removes any existing indicator, creates a new\n   * `<span part=\"sort-indicator\" class=\"sort-indicator\">` with the appropriate\n   * icon, sets `aria-sort` / `data-sort` attributes, and inserts it before the\n   * filter button or resize handle.\n   *\n   * Plugins decide **which** cells and **when** — this method handles **how**.\n   *\n   * @param cell - The header cell element\n   * @param direction - `'asc'` | `'desc'` for sorted, `null` for unsorted idle state\n   * @returns The created indicator element (useful for appending badges, etc.)\n   */\n  protected updateSortIndicator(cell: Element, direction: 'asc' | 'desc' | null): HTMLElement {\n    // Remove any existing indicator (core uses part, plugins use class)\n    cell.querySelector('[part~=\"sort-indicator\"], .sort-indicator')?.remove();\n\n    const indicator = document.createElement('span');\n    indicator.setAttribute('part', 'sort-indicator');\n    indicator.className = 'sort-indicator';\n\n    if (direction) {\n      cell.setAttribute('aria-sort', direction === 'asc' ? 'ascending' : 'descending');\n      cell.setAttribute('data-sort', direction);\n      this.setIcon(indicator, direction === 'asc' ? 'sortAsc' : 'sortDesc');\n    } else {\n      cell.setAttribute('aria-sort', 'none');\n      cell.removeAttribute('data-sort');\n      this.setIcon(indicator, 'sortNone');\n    }\n\n    // Insert before filter button or resize handle to maintain DOM order\n    const insertBefore = cell.querySelector('.tbw-filter-btn') ?? cell.querySelector('.resize-handle');\n    if (insertBefore) {\n      cell.insertBefore(indicator, insertBefore);\n    } else {\n      cell.appendChild(indicator);\n    }\n\n    return indicator;\n  }\n\n  /**\n   * Log a warning with an optional diagnostic code.\n   *\n   * When a diagnostic code is provided, the message is formatted with the code\n   * and a link to the troubleshooting docs.\n   *\n   * @example\n   * ```ts\n   * this.warn('Something went wrong');                          // plain\n   * this.warn(MISSING_BREAKPOINT, 'Set a breakpoint'); // with code + docs link\n   * ```\n   */\n  protected warn(message: string): void;\n  protected warn(code: DiagnosticCode, message: string): void;\n  protected warn(codeOrMessage: DiagnosticCode | string, message?: string): void {\n    if (message !== undefined) {\n      // Called with (code, message)\n      console.warn(formatDiagnostic(codeOrMessage as DiagnosticCode, message, this.gridElement.id, this.name));\n    } else {\n      // Called with (message) — plain warning, no diagnostic code\n      console.warn(`${gridPrefix(this.gridElement.id, this.name)} ${codeOrMessage}`);\n    }\n  }\n\n  /**\n   * Throw an error with a diagnostic code and docs link.\n   * Use for configuration errors and API misuse that should halt execution.\n   */\n  protected throwDiagnostic(code: DiagnosticCode, message: string): never {\n    throw new Error(formatDiagnostic(code, message, this.gridElement.id, this.name));\n  }\n\n  // #region Lifecycle Hooks\n\n  /**\n   * Transform rows before rendering.\n   * Called during each render cycle before rows are rendered to the DOM.\n   * Use this to filter, sort, or add computed properties to rows.\n   *\n   * @param rows - The current rows array (readonly to encourage returning a new array)\n   * @returns The modified rows array to render\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Filter out hidden rows\n   *   return rows.filter(row => !row._hidden);\n   * }\n   * ```\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Add computed properties\n   *   return rows.map(row => ({\n   *     ...row,\n   *     _fullName: `${row.firstName} ${row.lastName}`\n   *   }));\n   * }\n   * ```\n   */\n  processRows?(rows: readonly any[]): any[];\n\n  /**\n   * Contribute to the grid's effective configuration during each config merge.\n   * Called by {@link ConfigManager.merge} after the base config is assembled,\n   * before it becomes `effectiveConfig`. Mutate `config` in place to inject\n   * plugin-derived settings (e.g. the shell plugin folds its light-DOM /\n   * API-registered state into `config.shell`).\n   *\n   * This is the config-pipeline counterpart to {@link processColumns} /\n   * {@link processRows}: it keeps the core config merge free of any plugin\n   * knowledge — each plugin owns the shape it contributes.\n   *\n   * @param config - The mutable base config being assembled into effectiveConfig.\n   *\n   * @example\n   * ```ts\n   * processConfig(config: GridConfig): void {\n   *   config.shell = { ...config.shell, header: { title: this.#title } };\n   * }\n   * ```\n   */\n  processConfig?(config: GridConfig): void;\n\n  /**\n   * Transform columns before rendering.\n   * Called during each render cycle before column headers and cells are rendered.\n   * Use this to add, remove, or modify column definitions.\n   *\n   * @param columns - The current columns array (readonly to encourage returning a new array)\n   * @returns The modified columns array to render\n   *\n   * @example\n   * ```ts\n   * processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n   *   // Add a selection checkbox column\n   *   return [\n   *     { field: '_select', header: '', width: 40 },\n   *     ...columns\n   *   ];\n   * }\n   * ```\n   */\n  processColumns?(columns: readonly ColumnConfig[]): ColumnConfig[];\n\n  /**\n   * Called before each render cycle begins.\n   * Use this to prepare state or cache values needed during rendering.\n   *\n   * **Note:** This hook is currently a placeholder for future implementation.\n   * It is defined in the interface but not yet invoked by the grid's render pipeline.\n   * If you need this functionality, please open an issue or contribute an implementation.\n   *\n   * @example\n   * ```ts\n   * beforeRender(): void {\n   *   this.visibleRowCount = this.calculateVisibleRows();\n   * }\n   * ```\n   */\n  beforeRender?(): void;\n\n  /**\n   * Called after each render cycle completes.\n   * Use this for DOM manipulation, adding event listeners to rendered elements,\n   * or applying visual effects like selection highlights.\n   *\n   * @example\n   * ```ts\n   * afterRender(): void {\n   *   // Apply selection styling to rendered rows\n   *   const rows = this.gridElement?.querySelectorAll('.data-grid-row');\n   *   rows?.forEach((row, i) => {\n   *     row.classList.toggle('selected', this.selectedRows.has(i));\n   *   });\n   * }\n   * ```\n   */\n  afterRender?(): void;\n\n  /**\n   * Called synchronously immediately after the grid (re)builds its root DOM\n   * structure, before the browser has a chance to paint.\n   *\n   * Unlike {@link afterRender} (which runs in the scheduler's STYLE phase and\n   * may be deferred), this hook fires inside the same task as the structural\n   * DOM build. It is the correct place for plugins that need to wrap, relocate,\n   * or augment the freshly built grid DOM without a flash of unstyled/unwrapped\n   * content — e.g. a shell that moves the grid content into a chrome wrapper.\n   *\n   * The grid emits this hook every time it performs a full structural rebuild\n   * (initial connect and structural changes), but NOT on the scroll/data hot\n   * path. Implementations MUST be idempotent: a full rebuild discards any DOM a\n   * previous invocation produced, so re-create it, and no-op when the desired\n   * structure is already present.\n   *\n   * @example\n   * ```ts\n   * afterStructuralRender(): void {\n   *   const root = this.grid?._renderRoot;\n   *   if (!root || root.querySelector('.my-wrapper > .tbw-grid-content')) return;\n   *   // build wrapper, move .tbw-grid-content inside it\n   * }\n   * ```\n   */\n  afterStructuralRender?(): void;\n\n  /**\n   * Called synchronously by the grid immediately before it tears down and\n   * rebuilds its root DOM structure (a structural re-render). Plugins that\n   * relocated existing light-DOM nodes into their own chrome (e.g. a shell that\n   * moves toolbar buttons into the header bar) use this to move those nodes back\n   * to their original container so they survive the rebuild. Generic\n   * counterpart to {@link afterStructuralRender}. MUST be idempotent.\n   */\n  beforeStructuralRender?(): void;\n\n  /**\n   * Called by the grid after a config merge to ask whether the change requires a\n   * full structural re-render (rather than a cheaper in-place update). A plugin\n   * returns `true` when its rendered DOM signature no longer matches the new\n   * effective config — e.g. a shell header appearing/disappearing or a tool\n   * panel's count/position/mode changing. The grid performs a structural\n   * re-render if ANY plugin returns `true`. MUST be side-effect free.\n   */\n  needsStructuralRerender?(): boolean;\n\n  /**\n   * Called by the grid to let a plugin (re-)parse its own light-DOM\n   * contributions into plugin state ahead of a config merge. Generic seam that\n   * keeps core free of plugin-specific light-DOM tag knowledge (the plugin reads\n   * `this.grid._hostElement`). MUST be idempotent.\n   */\n  parseLightDom?(): void;\n\n  /**\n   * Called by the grid (from `refreshColumns` and the light-DOM observer) to\n   * let a plugin re-parse its light-DOM contributions AND refresh any\n   * already-rendered chrome in place when something changed — e.g. a shell\n   * title or tool buttons that a framework projected asynchronously after the\n   * initial render. Distinct from {@link parseLightDom}, which only updates\n   * plugin state. Generic seam — core holds no plugin-specific knowledge. MUST\n   * be idempotent and a no-op when the plugin's chrome is not yet rendered.\n   */\n  syncLightDom?(): void;\n\n  /**\n   * Called after each cell is rendered.\n   * This hook is more efficient than `afterRender()` for cell-level modifications\n   * because you receive the cell context directly - no DOM queries needed.\n   *\n   * Use cases:\n   * - Adding selection/highlight classes to specific cells\n   * - Injecting badges or decorations\n   * - Applying conditional styling based on cell value\n   *\n   * Performance note: Called for every visible cell during render. Keep implementation fast.\n   * This hook is also called during scroll when cells are recycled.\n   *\n   * @param context - The cell render context with row, column, value, and elements\n   *\n   * @example\n   * ```ts\n   * afterCellRender(context: AfterCellRenderContext): void {\n   *   // Add selection class without DOM queries\n   *   if (this.isSelected(context.rowIndex, context.colIndex)) {\n   *     context.cellElement.classList.add('selected');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.hasError(context.row, context.column.field)) {\n   *     context.cellElement.classList.add('has-error');\n   *   }\n   * }\n   * ```\n   */\n  afterCellRender?(context: AfterCellRenderContext): void;\n\n  /**\n   * Called after a row is fully rendered (all cells complete).\n   * Use this for row-level decorations, styling, or ARIA attributes.\n   *\n   * Common use cases:\n   * - Adding selection classes to entire rows (row-focus, selected)\n   * - Setting row-level ARIA attributes\n   * - Applying row validation highlighting\n   * - Tree indentation styling\n   *\n   * Performance note: Called for every visible row during render. Keep implementation fast.\n   * This hook is also called during scroll when rows are recycled.\n   *\n   * @param context - The row render context with row data and element\n   *\n   * @example\n   * ```ts\n   * afterRowRender(context: AfterRowRenderContext): void {\n   *   // Add row selection class without DOM queries\n   *   if (this.isRowSelected(context.rowIndex)) {\n   *     context.rowElement.classList.add('selected', 'row-focus');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.rowHasErrors(context.row)) {\n   *     context.rowElement.classList.add('has-errors');\n   *   }\n   * }\n   * ```\n   */\n  afterRowRender?(context: AfterRowRenderContext): void;\n\n  /**\n   * Called after scroll-triggered row rendering completes.\n   * This is a lightweight hook for applying visual state to recycled DOM elements.\n   * Use this instead of afterRender when you need to reapply styling during scroll.\n   *\n   * Performance note: This is called frequently during scroll. Keep implementation fast.\n   *\n   * @example\n   * ```ts\n   * onScrollRender(): void {\n   *   // Reapply selection state to visible cells\n   *   this.applySelectionToVisibleCells();\n   * }\n   * ```\n   */\n  onScrollRender?(): void;\n\n  /**\n   * Get the height of a specific row.\n   * Used for synthetic rows (group headers, detail panels, etc.) that have fixed heights.\n   * Return undefined if this plugin does not manage the height for this row.\n   *\n   * This hook is called during position cache rebuilds for variable row height virtualization.\n   * Plugins that create synthetic rows should implement this to provide accurate heights.\n   *\n   * @param row - The row data\n   * @param index - The row index in the processed rows array\n   * @returns The row height in pixels, or undefined if not managed by this plugin\n   */\n  getRowHeight?(row: unknown, index: number): number | undefined;\n\n  /**\n   * Adjust the virtualization start index to render additional rows before the visible range.\n   * Use this when expanded content (like detail rows) needs its parent row to remain rendered\n   * even when the parent row itself has scrolled above the viewport.\n   *\n   * @param start - The calculated start row index\n   * @param scrollTop - The current scroll position\n   * @param rowHeight - The height of a single row\n   * @returns The adjusted start index (lower than or equal to original start)\n   *\n   * @example\n   * ```ts\n   * adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n   *   // If row 5 is expanded and scrolled partially, keep it rendered\n   *   for (const expandedRowIndex of this.expandedRowIndices) {\n   *     const expandedRowTop = expandedRowIndex * rowHeight;\n   *     const expandedRowBottom = expandedRowTop + rowHeight + this.detailHeight;\n   *     if (expandedRowBottom > scrollTop && expandedRowIndex < start) {\n   *       return expandedRowIndex;\n   *     }\n   *   }\n   *   return start;\n   * }\n   * ```\n   */\n  adjustVirtualStart?(start: number, scrollTop: number, rowHeight: number): number;\n\n  /**\n   * Render a custom row, bypassing the default row rendering.\n   * Use this for special row types like group headers, detail rows, or footers.\n   *\n   * @param row - The row data object\n   * @param rowEl - The row DOM element to render into\n   * @param rowIndex - The index of the row in the data array\n   * @returns `true` if the plugin handled rendering (prevents default), `false`/`void` for default rendering\n   *\n   * @example\n   * ```ts\n   * renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void {\n   *   if (row._isGroupHeader) {\n   *     rowEl.innerHTML = `<div class=\"group-header\">${row._groupLabel}</div>`;\n   *     return true; // Handled - skip default rendering\n   *   }\n   *   // Return void to let default rendering proceed\n   * }\n   * ```\n   */\n  renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;\n\n  // #endregion\n\n  // #region Inter-Plugin Communication\n\n  /**\n   * Handle queries from other plugins or the grid.\n   *\n   * Queries are declared in `manifest.queries` and dispatched via `grid.query()`.\n   * This enables type-safe, discoverable inter-plugin communication.\n   *\n   * @category Plugin Development\n   * @param query - The query object with type and context\n   * @returns Query-specific response, or undefined if not handling this query\n   *\n   * @example\n   * ```ts\n   * // In manifest\n   * static override readonly manifest: PluginManifest = {\n   *   queries: [\n   *     { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   *   ],\n   * };\n   *\n   * // In plugin class\n   * handleQuery(query: PluginQuery): unknown {\n   *   if (query.type === 'canMoveColumn') {\n   *     const column = query.context as ColumnConfig;\n   *     return !column.sticky; // Can't move sticky columns\n   *   }\n   * }\n   * ```\n   */\n  handleQuery?(query: PluginQuery): unknown;\n\n  // #endregion\n\n  // #region Interaction Hooks\n\n  /**\n   * Handle keyboard events on the grid.\n   * Called when a key is pressed while the grid or a cell has focus.\n   *\n   * @param event - The native KeyboardEvent\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onKeyDown(event: KeyboardEvent): boolean | void {\n   *   // Handle Ctrl+A for select all\n   *   if (event.ctrlKey && event.key === 'a') {\n   *     this.selectAllRows();\n   *     return true; // Prevent default browser select-all\n   *   }\n   * }\n   * ```\n   */\n  onKeyDown?(event: KeyboardEvent): boolean | void;\n\n  /**\n   * Handle cell click events.\n   * Called when a data cell is clicked (not headers).\n   *\n   * @param event - Cell click event with row/column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onCellClick(event: CellClickEvent): boolean | void {\n   *   if (event.field === '_select') {\n   *     this.toggleRowSelection(event.rowIndex);\n   *     return true; // Handled\n   *   }\n   * }\n   * ```\n   */\n  onCellClick?(event: CellClickEvent): boolean | void;\n\n  /**\n   * Handle row click events.\n   * Called when any part of a data row is clicked.\n   * Note: This is called in addition to onCellClick, not instead of.\n   *\n   * @param event - Row click event with row context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onRowClick(event: RowClickEvent): boolean | void {\n   *   if (this.config.mode === 'row') {\n   *     this.selectRow(event.rowIndex, event.originalEvent);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onRowClick?(event: RowClickEvent): boolean | void;\n\n  /**\n   * Handle header click events.\n   * Called when a column header is clicked. Commonly used for sorting.\n   *\n   * @param event - Header click event with column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onHeaderClick(event: HeaderClickEvent): boolean | void {\n   *   if (event.column.sortable !== false) {\n   *     this.toggleSort(event.field);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onHeaderClick?(event: HeaderClickEvent): boolean | void;\n\n  /**\n   * Handle scroll events on the grid viewport.\n   * Called during scrolling. Note: This may be called frequently; debounce if needed.\n   *\n   * @param event - Scroll event with scroll position and viewport dimensions\n   *\n   * @example\n   * ```ts\n   * onScroll(event: ScrollEvent): void {\n   *   // Update sticky column positions\n   *   this.updateStickyPositions(event.scrollLeft);\n   * }\n   * ```\n   */\n  onScroll?(event: ScrollEvent): void;\n\n  /**\n   * Handle cell mousedown events.\n   * Used for initiating drag operations like range selection or column resize.\n   *\n   * @param event - Mouse event with cell context\n   * @returns `true` to indicate drag started (prevents text selection), `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseDown(event: CellMouseEvent): boolean | void {\n   *   if (event.rowIndex !== undefined && this.config.mode === 'range') {\n   *     this.startDragSelection(event.rowIndex, event.colIndex);\n   *     return true; // Prevent text selection\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseDown?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mousemove events during drag operations.\n   * Only called when a drag is in progress (after mousedown returned true).\n   *\n   * @param event - Mouse event with current cell context\n   * @returns `true` to continue handling the drag, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseMove(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging && event.rowIndex !== undefined) {\n   *     this.extendSelection(event.rowIndex, event.colIndex);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseMove?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mouseup events to end drag operations.\n   *\n   * @param event - Mouse event with final cell context\n   * @returns `true` if drag was finalized, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseUp(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging) {\n   *     this.finalizeDragSelection();\n   *     this.isDragging = false;\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseUp?(event: CellMouseEvent): boolean | void;\n\n  // Note: Context menu items are provided via handleQuery('getContextMenuItems').\n  // This keeps the core decoupled from the context-menu plugin specifics.\n\n  // #endregion\n\n  // #region Column State Hooks\n\n  /**\n   * Contribute plugin-specific state for a column.\n   * Called by the grid when collecting column state for serialization.\n   * Plugins can add their own properties to the column state.\n   *\n   * @param field - The field name of the column\n   * @returns Partial column state with plugin-specific properties, or undefined if no state to contribute\n   *\n   * @example\n   * ```ts\n   * getColumnState(field: string): Partial<ColumnState> | undefined {\n   *   const filterModel = this.filterModels.get(field);\n   *   if (filterModel) {\n   *     // Uses module augmentation to add filter property to ColumnState\n   *     return { filter: filterModel } as Partial<ColumnState>;\n   *   }\n   *   return undefined;\n   * }\n   * ```\n   */\n  getColumnState?(field: string): Partial<ColumnState> | undefined;\n\n  /**\n   * Apply plugin-specific state to a column.\n   * Called by the grid when restoring column state from serialized data.\n   * Plugins should restore their internal state based on the provided state.\n   *\n   * @param field - The field name of the column\n   * @param state - The column state to apply (may contain plugin-specific properties)\n   *\n   * @example\n   * ```ts\n   * applyColumnState(field: string, state: ColumnState): void {\n   *   // Check for filter property added via module augmentation\n   *   const filter = (state as any).filter;\n   *   if (filter) {\n   *     this.filterModels.set(field, filter);\n   *     this.applyFilter();\n   *   }\n   * }\n   * ```\n   */\n  applyColumnState?(field: string, state: ColumnState): void;\n\n  // #endregion\n\n  // #region Scroll Boundary Hooks\n\n  /**\n   * Report horizontal scroll boundary offsets for this plugin.\n   * Plugins that obscure part of the scroll area (e.g., pinned/sticky columns)\n   * should return how much space they occupy on each side.\n   * The keyboard navigation uses this to ensure focused cells are fully visible.\n   *\n   * @param rowEl - The row element (optional, for calculating widths from rendered cells)\n   * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)\n   * @returns Object with left/right pixel offsets and optional skipScroll flag, or undefined if plugin has no offsets\n   *\n   * @example\n   * ```ts\n   * getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): { left: number; right: number; skipScroll?: boolean } | undefined {\n   *   // Calculate total width of left-pinned columns\n   *   const leftCells = rowEl?.querySelectorAll('.sticky-left') ?? [];\n   *   let left = 0;\n   *   leftCells.forEach(el => { left += (el as HTMLElement).offsetWidth; });\n   *   // Skip scroll if focused cell is pinned (always visible)\n   *   const skipScroll = focusedCell?.classList.contains('sticky-left');\n   *   return { left, right: 0, skipScroll };\n   * }\n   * ```\n   */\n  getHorizontalScrollOffsets?(\n    rowEl?: HTMLElement,\n    focusedCell?: HTMLElement,\n  ): { left: number; right: number; skipScroll?: boolean } | undefined;\n\n  /**\n   * Report vertical scroll boundary offsets for this plugin.\n   * Plugins that overlay the top or bottom of the rows viewport (e.g. sticky\n   * row clones) should return how much space they obscure on each edge, so\n   * keyboard navigation can scroll a focused row clear of the overlay rather\n   * than leaving it hidden underneath — WCAG 2.2 SC 2.4.11 Focus Not Obscured.\n   *\n   * Only report space that is painted *over* the scrollable rows. Content that\n   * takes part in normal flow (pinned-row bars, the column header) already\n   * shrinks the viewport and must NOT be reported here, or rows would scroll\n   * twice as far as needed.\n   *\n   * @param focusedRowIndex - Index of the row being scrolled into view, so a plugin can report `skipScroll` when it already renders that row in a permanently visible overlay\n   * @returns Object with top/bottom pixel offsets and optional skipScroll flag, or undefined if plugin obscures nothing\n   *\n   * @example\n   * ```ts\n   * getVerticalScrollOffsets(focusedRowIndex?: number): { top: number; bottom: number; skipScroll?: boolean } | undefined {\n   *   if (!this.overlayEl) return undefined;\n   *   // The row is already pinned in the overlay — it is visible where it is.\n   *   if (focusedRowIndex != null && this.stuckIndices.includes(focusedRowIndex)) {\n   *     return { top: 0, bottom: 0, skipScroll: true };\n   *   }\n   *   return { top: this.overlayEl.offsetHeight, bottom: 0 };\n   * }\n   * ```\n   *\n   * @since 3.6.0\n   */\n  getVerticalScrollOffsets?(\n    focusedRowIndex?: number,\n  ): { top: number; bottom: number; skipScroll?: boolean } | undefined;\n\n  // #endregion\n\n  // #region Shell Integration Hooks\n\n  /**\n   * Register a tool panel for this plugin.\n   * Return undefined if plugin has no tool panel.\n   * The shell will create a toolbar toggle button and render the panel content\n   * when the user opens the panel.\n   *\n   * @returns Tool panel definition, or undefined if plugin has no panel\n   *\n   * @example\n   * ```ts\n   * getToolPanel(): ToolPanelDefinition | undefined {\n   *   return {\n   *     id: 'columns',\n   *     title: 'Columns',\n   *     icon: '☰',\n   *     tooltip: 'Show/hide columns',\n   *     order: 10,\n   *     render: (container) => {\n   *       this.renderColumnList(container);\n   *       return () => this.cleanup();\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getToolPanel?(): ToolPanelDefinition | undefined;\n\n  /**\n   * Register content for the shell header center section.\n   * Return undefined if plugin has no header content.\n   * Examples: search input, selection summary, status indicators.\n   *\n   * @returns Header content definition, or undefined if plugin has no header content\n   *\n   * @example\n   * ```ts\n   * getHeaderContent(): HeaderContentDefinition | undefined {\n   *   return {\n   *     id: 'quick-filter',\n   *     order: 10,\n   *     render: (container) => {\n   *       const input = document.createElement('input');\n   *       input.type = 'text';\n   *       input.placeholder = 'Search...';\n   *       input.addEventListener('input', this.handleInput);\n   *       container.appendChild(input);\n   *       return () => input.removeEventListener('input', this.handleInput);\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getHeaderContent?(): HeaderContentDefinition | undefined;\n\n  // #endregion\n}\n","/**\n * Generic pointer-drag helper — converts a `pointerdown` event into a\n * deterministic drag lifecycle with pointer capture, threshold / long-press\n * promotion, and clean teardown.\n *\n * ## Usage\n * ```ts\n * element.addEventListener('pointerdown', (e) => {\n *   startPointerDrag(e, element, {\n *     onMove: (pe) => resize(pe.clientX),\n *     onEnd:  (pe) => commit(),\n *   });\n * });\n * ```\n *\n * ## Fine vs coarse pointer promotion\n * For **fine** pointers (mouse / precision trackpad): set `longPressDuration`\n * to `0` (or omit it) so the drag is promoted immediately on first move.\n *\n * For **coarse** pointers (touch / stylus): set `longPressDuration` to e.g.\n * `400` ms so the drag is only promoted after the user holds still long\n * enough. Movement exceeding `longPressSlop` px before the timer fires\n * **cancels** the drag — this lets native scroll proceed uninterrupted.\n *\n * Branch example at call site:\n * ```ts\n * const isCoarse = e.pointerType === 'touch' || e.pointerType === 'pen';\n * startPointerDrag(e, el, handlers, { longPressDuration: isCoarse ? 400 : 0 });\n * ```\n *\n * ## Pointer capture\n * `setPointerCapture` / `releasePointerCapture` are called on `captureTarget`\n * only — **never** `document` / `window` listeners. Capture is claimed at\n * **promotion**, not on `pointerdown`: a captured pointer makes the browser\n * retarget the compatibility mouse events (`mouseup`, `click`, `dblclick`) to\n * the capture element, which would break click-driven grid features.\n *\n * ## Re-entrancy\n * Simultaneous drags on the same element with the same `pointerId` are\n * silently ignored (returns a no-op cancel function).\n *\n * ## DnD plugins\n * HTML5 drag-and-drop plugins (`RowDragDropPlugin`, `ReorderPlugin`, etc.)\n * are expected to consume this module in the future (#228). The API is\n * intentionally general.\n *\n * This module is **internal only** — NOT exported from `src/public.ts`.\n *\n * @since 3.5.0\n * @internal\n */\n\n// #region Types\n\n/**\n * Callbacks supplied to {@link startPointerDrag}.\n *\n * @since 3.5.0\n */\nexport interface PointerDragHandlers {\n  /**\n   * Called on each `pointermove` after the drag has been promoted.\n   * For immediate drags (no threshold / long-press) this fires on the very\n   * first move. For long-press promotion it fires only after the delay.\n   */\n  onMove(e: PointerEvent): void;\n\n  /**\n   * Called when the pointer is released after promotion (`pointerup`).\n   * Not called if the drag was cancelled before promotion.\n   */\n  onEnd(e: PointerEvent): void;\n\n  /**\n   * Called once when the drag is promoted — when the movement threshold is\n   * crossed or the long-press timer elapses. Fires before the first `onMove`.\n   *\n   * Long-press call sites use this to enter a mode (e.g. cell range-paint) and\n   * give feedback at the moment the press is recognised, even if the pointer\n   * never subsequently moves.\n   */\n  onPromote?(): void;\n\n  /**\n   * Called when the drag is cancelled — by `pointercancel`, `lostpointercapture`,\n   * an `Escape` keydown, or the returned `cancel()` function.\n   * Also called when the pointer is released *before* promotion (tap / short press).\n   */\n  onCancel?(): void;\n}\n\n/**\n * Options for {@link startPointerDrag}.\n *\n * @since 3.5.0\n */\nexport interface PointerDragOptions {\n  /**\n   * Minimum movement in px before the drag is promoted.\n   * `0` (default) promotes immediately on the first `pointermove`.\n   */\n  threshold?: number;\n\n  /**\n   * Long-press duration in milliseconds.\n   *\n   * `0` (default) = no long-press requirement; the drag is promoted as soon\n   * as the pointer moves (subject to `threshold`).\n   *\n   * When `> 0` the drag is promoted only after this many ms have elapsed\n   * without the pointer exceeding `longPressSlop`. If the slop is exceeded\n   * before the timer fires the entire drag is cancelled so native scroll can\n   * proceed.\n   *\n   * Use this for **coarse** (touch/stylus) pointers to disambiguate a tap\n   * or a scroll gesture from an intentional drag-to-paint interaction.\n   */\n  longPressDuration?: number;\n\n  /**\n   * Maximum pointer movement (px) permitted during the long-press wait.\n   * If this distance is exceeded the drag is cancelled.\n   * Default: `8`.\n   */\n  longPressSlop?: number;\n}\n\n// #endregion\n\n// #region Re-entrancy guard\n\n/**\n * Tracks active pointer IDs per capture target.\n * Prevents two simultaneous drags on the same element with the same pointer.\n */\nconst _activePointers = new WeakMap<Element, Set<number>>();\n\nfunction _claimPointer(el: Element, id: number): boolean {\n  let set = _activePointers.get(el);\n  if (!set) {\n    set = new Set();\n    _activePointers.set(el, set);\n  }\n  if (set.has(id)) return false;\n  set.add(id);\n  return true;\n}\n\nfunction _releasePointer(el: Element, id: number): void {\n  _activePointers.get(el)?.delete(id);\n}\n\n// #endregion\n\n// #region startPointerDrag\n\n/**\n * Begin a pointer drag on `captureTarget`.\n *\n * Attaches `pointermove`, `pointerup`, `pointercancel`, and\n * `lostpointercapture` listeners directly to `captureTarget` (never to\n * `document` / `window`). `setPointerCapture` is called when the drag is\n * promoted so events continue to route here regardless of DOM changes; an\n * unpromoted press never captures and therefore leaves `click` / `dblclick`\n * targeting the element actually under the pointer.\n *\n * Returns a `cancel()` dispose function. Calling it is idempotent.\n *\n * @param startEvent  - The originating `pointerdown` event.\n * @param captureTarget - Element on which to set pointer capture and attach\n *   pointer listeners. Must be in a connected document.\n * @param handlers - `onMove`, `onEnd`, and optional `onCancel` callbacks.\n * @param options - Threshold, long-press, and slop configuration.\n *\n * @since 3.5.0\n */\nexport function startPointerDrag(\n  startEvent: PointerEvent,\n  captureTarget: Element,\n  handlers: PointerDragHandlers,\n  options?: PointerDragOptions,\n): () => void {\n  const { onMove, onEnd, onCancel, onPromote } = handlers;\n  const threshold = options?.threshold ?? 0;\n  const longPressDuration = options?.longPressDuration ?? 0;\n  const longPressSlop = options?.longPressSlop ?? 8;\n  const pointerId = startEvent.pointerId;\n\n  // Re-entrancy guard — silently ignore duplicate drags on same element/pointer\n  if (!_claimPointer(captureTarget, pointerId)) {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const startX = startEvent.clientX;\n  const startY = startEvent.clientY;\n\n  // Promotion: true when the drag has passed threshold/long-press requirements\n  let promoted = threshold === 0 && longPressDuration === 0;\n  let done = false;\n  let longPressTimer: ReturnType<typeof setTimeout> | null = null;\n  let captureFailed = false;\n\n  // #region Internal helpers\n\n  /**\n   * Claim pointer capture — called at promotion, never at `pointerdown`.\n   *\n   * While an element holds pointer capture the browser retargets the\n   * compatibility mouse events (`mouseup`, `click`, `dblclick`) to that element\n   * instead of the element actually under the pointer. Capturing on press would\n   * therefore break every click-driven feature in the grid (cell editing,\n   * header sort, row click) because those handlers resolve their target with\n   * `event.target.closest(...)`. Promotion is the point where the gesture is\n   * known to be a drag, so capturing there keeps plain clicks intact.\n   */\n  function acquireCapture(): boolean {\n    try {\n      captureTarget.setPointerCapture(pointerId);\n      return true;\n    } catch {\n      // setPointerCapture can fail in unit-test environments without full\n      // browser APIs, or if the element was detached mid-gesture. Callers\n      // typically flip UI state (cursor, user-select, `isResizing`) *before*\n      // calling us, so report the failure as a cancellation — otherwise that\n      // state is never rolled back and the UI sticks mid-drag.\n      captureFailed = true;\n      return false;\n    }\n  }\n\n  /** Promote the gesture to a drag: take capture, then notify the caller. */\n  function promote(): boolean {\n    promoted = true;\n    if (!acquireCapture()) {\n      cancel();\n      return false;\n    }\n    onPromote?.();\n    return true;\n  }\n\n  function teardown(): void {\n    if (done) return;\n    done = true;\n    if (longPressTimer !== null) {\n      clearTimeout(longPressTimer);\n      longPressTimer = null;\n    }\n    captureTarget.removeEventListener('pointermove', onPointerMove);\n    captureTarget.removeEventListener('pointerup', onPointerUp);\n    captureTarget.removeEventListener('pointercancel', onPointerCancel);\n    captureTarget.removeEventListener('lostpointercapture', onLostCapture);\n    document.removeEventListener('keydown', onEscapeKey, true);\n    _releasePointer(captureTarget, pointerId);\n    try {\n      if (captureTarget.hasPointerCapture(pointerId)) {\n        captureTarget.releasePointerCapture(pointerId);\n      }\n    } catch {\n      // Ignore — element may have been removed from DOM\n    }\n  }\n\n  function cancel(): void {\n    if (done) return;\n    teardown();\n    onCancel?.();\n  }\n\n  // #endregion\n\n  // #region Event handlers\n\n  function onPointerMove(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n\n    const dx = e.clientX - startX;\n    const dy = e.clientY - startY;\n    const dist = Math.sqrt(dx * dx + dy * dy);\n\n    if (!promoted) {\n      if (longPressDuration > 0) {\n        // Cancel entire drag if movement exceeds slop while waiting for long-press\n        if (dist > longPressSlop) {\n          cancel();\n          return;\n        }\n        // Long-press not yet elapsed — swallow event, no onMove\n        return;\n      }\n      // Threshold promotion only (no long-press)\n      if (threshold > 0 && dist < threshold) return;\n      if (!promote()) return;\n    }\n\n    onMove(e);\n  }\n\n  function onPointerUp(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n    const wasPromoted = promoted;\n    teardown();\n    if (wasPromoted) {\n      onEnd(e);\n    } else {\n      onCancel?.();\n    }\n  }\n\n  function onPointerCancel(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n    cancel();\n  }\n\n  function onLostCapture(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n    cancel();\n  }\n\n  function onEscapeKey(event: Event): void {\n    const e = event as KeyboardEvent;\n    if (e.key === 'Escape' && !done) cancel();\n  }\n\n  // #endregion\n\n  // Attach listeners before starting the long-press timer\n  captureTarget.addEventListener('pointermove', onPointerMove);\n  captureTarget.addEventListener('pointerup', onPointerUp);\n  captureTarget.addEventListener('pointercancel', onPointerCancel);\n  captureTarget.addEventListener('lostpointercapture', onLostCapture);\n  document.addEventListener('keydown', onEscapeKey, true);\n\n  // Drags with neither a threshold nor a long-press are promoted up front.\n  if (promoted) {\n    promote();\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    if (captureFailed) return () => {};\n  }\n\n  // Start long-press timer after capture so the countdown is accurate\n  if (longPressDuration > 0) {\n    longPressTimer = setTimeout(() => {\n      longPressTimer = null;\n      if (done) return;\n      promote();\n    }, longPressDuration);\n  }\n\n  return cancel;\n}\n\n// #endregion\n","/**\n * Non-drag alternative for resizing — WCAG 2.2 SC 2.5.7 \"Dragging Movements\".\n *\n * Dragging a splitter is the primary gesture, but a single-pointer user\n * (trackball, head pointer, eye-gaze, speech mouse emulator) cannot reliably\n * press-hold-move-release. Tapping the splitter instead opens this popover,\n * which offers the same functionality through plain clicks: step buttons, a\n * numeric input, and a reset. A keyboard alternative alone would **not**\n * satisfy the criterion — it is specifically about pointer input.\n *\n * Target-agnostic on purpose: core column resizing and the shell's tool-panel\n * splitter share it, so every resizable thing in the grid presents the same\n * control instead of one-off menus.\n *\n * This module is **internal only** — NOT exported from `src/public.ts`.\n *\n * @since 3.6.0\n * @internal\n */\n\n/** Default size change per click of the − / + buttons, in px. */\nconst DEFAULT_STEP_PX = 16;\n\n/** Gap between the anchor handle and the popover, in px. */\nconst ANCHOR_GAP_PX = 6;\n\n/** Runtime check — happy-dom and older browsers may lack the Popover API. */\nfunction supportsPopover(): boolean {\n  return typeof HTMLElement.prototype?.showPopover === 'function';\n}\n\n/**\n * How the popover reads and writes whatever it is sizing. `T` identifies the\n * target — a column index for the header, the panel element for the shell.\n *\n * Supplied by the owning controller so the drag and the click path share one\n * clamping/commit implementation.\n */\nexport interface SizePopoverOptions<T> {\n  /** DOM id for the popover element, unique per owning controller. */\n  id: string;\n  /** Size change per click of the − / + buttons. Defaults to 16px. */\n  step?: number;\n  /** Current rendered size of the target, in px. */\n  getSize(target: T): number;\n  /** Commit an explicit size (implementation clamps to its own limits). */\n  setSize(target: T, size: number): void;\n  /** Restore the target's configured size. */\n  reset(target: T): void;\n  /** Accessible name for the popover, e.g. `\"Width of column Name\"`. */\n  getLabel(target: T): string;\n  /**\n   * The grid host. The popover is mounted INSIDE it (the grid renders in light\n   * DOM) so it inherits the theme's custom properties and `color-scheme`; the\n   * top layer keeps it clear of ancestor overflow. `buildBareGridDOMIntoElement`\n   * preserves foreign direct children, so it survives re-renders.\n   */\n  getHost(target: T): HTMLElement | null;\n}\n\nexport interface SizePopover<T> {\n  /** Show the popover for `target`, positioned against `anchor`. */\n  open(target: T, anchor: HTMLElement): void;\n  /** Hide the popover. Safe to call when already closed. */\n  close(): void;\n  /** Remove the popover element and every document-level listener. */\n  dispose(): void;\n  /** The popover element, or `null` before the first {@link SizePopover.open}. */\n  readonly element: HTMLElement | null;\n}\n\nfunction button(label: string, text: string): HTMLButtonElement {\n  const el = document.createElement('button');\n  el.type = 'button';\n  el.className = 'tbw-size-popover-btn';\n  el.setAttribute('aria-label', label);\n  el.textContent = text;\n  return el;\n}\n\nexport function createSizePopover<T>(options: SizePopoverOptions<T>): SizePopover<T> {\n  const step = options.step ?? DEFAULT_STEP_PX;\n  let root: HTMLDivElement | null = null;\n  let input: HTMLInputElement | null = null;\n  let anchorEl: HTMLElement | null = null;\n  let target: T;\n  let opened = false;\n  let disposed = false;\n  const abort = new AbortController();\n\n  function close(): void {\n    if (!opened || !root) return;\n    opened = false;\n    if (supportsPopover()) root.hidePopover();\n    root.hidden = true;\n    anchorEl?.removeAttribute('data-tbw-size-open');\n    anchorEl = null;\n  }\n\n  function sync(): void {\n    if (input) input.value = String(Math.round(options.getSize(target)));\n  }\n\n  function apply(size: number): void {\n    if (!Number.isFinite(size)) return;\n    options.setSize(target, size);\n    sync();\n  }\n\n  function build(): HTMLDivElement {\n    const el = document.createElement('div');\n    el.id = options.id;\n    el.className = 'tbw-size-popover';\n    el.setAttribute('popover', 'manual');\n    el.setAttribute('role', 'group');\n    // Without the Popover API there is no UA `display: none`, so hide it here.\n    el.hidden = true;\n\n    const minus = button('Narrower', '\\u2212');\n    const plus = button('Wider', '+');\n    const reset = button('Reset size', 'Reset');\n\n    const field = document.createElement('input');\n    field.type = 'number';\n    field.className = 'tbw-size-popover-input';\n    field.min = '0';\n    // `step` belongs to the − / + buttons, not the field: a measured size is\n    // rarely a multiple of it, and a step mismatch would mark the field\n    // `:invalid` and expose `aria-invalid=\"true\"` for a perfectly valid width.\n    field.step = 'any';\n    field.setAttribute('aria-label', 'Size in pixels');\n\n    minus.addEventListener('click', () => apply(options.getSize(target) - step), { signal: abort.signal });\n    plus.addEventListener('click', () => apply(options.getSize(target) + step), { signal: abort.signal });\n    reset.addEventListener(\n      'click',\n      () => {\n        options.reset(target);\n        sync();\n      },\n      { signal: abort.signal },\n    );\n    field.addEventListener('change', () => apply(field.valueAsNumber), { signal: abort.signal });\n\n    // Tabbing past either end dismisses instead of stranding the user — the\n    // popover has no visible trigger to tab back to. A null `relatedTarget`\n    // (click focus in Firefox/Safari, focus leaving the document) is ignored.\n    el.addEventListener(\n      'focusout',\n      (e) => {\n        const next = (e as FocusEvent).relatedTarget;\n        if (next instanceof Node && !el.contains(next)) close();\n      },\n      { signal: abort.signal },\n    );\n\n    el.append(minus, field, plus, reset);\n    input = field;\n    return el;\n  }\n\n  /**\n   * Position against the anchor in viewport coordinates. The popover lives in\n   * the top layer, so its containing block is the viewport regardless of where\n   * the anchor sits in the DOM.\n   *\n   * Called once per open and never again: repeatedly clicking − / + moves the\n   * anchor, and following it would slide the button out from under the pointer\n   * of the very users this control exists for. The anchor keeps its indicator\n   * lit instead (`data-tbw-size-open`) to show which edge is being sized.\n   */\n  function place(anchor: HTMLElement): void {\n    if (!root) return;\n    const a = anchor.getBoundingClientRect();\n    const box = root.getBoundingClientRect();\n    const clamp = (v: number, max: number) => Math.max(4, Math.min(v, max - 4));\n    const left = clamp(a.left + a.width / 2 - box.width / 2, window.innerWidth - box.width);\n\n    // A full-height anchor (the tool-panel splitter) has no meaningful \"below\":\n    // it would land past the bottom of the grid. Sit against its middle instead.\n    const below = a.bottom + ANCHOR_GAP_PX;\n    const above = a.top - ANCHOR_GAP_PX - box.height;\n    const tall = a.height > box.height * 3;\n    let top: number;\n    if (!tall && below + box.height <= window.innerHeight) top = below;\n    else if (!tall && above >= 4) top = above;\n    else top = clamp(a.top + a.height / 2 - box.height / 2, window.innerHeight - box.height);\n\n    root.style.left = `${Math.round(left)}px`;\n    root.style.top = `${Math.round(top)}px`;\n  }\n\n  // Any pointer press outside the popover dismisses it. Capture phase so the\n  // press that lands on a grid cell still reaches its own handler afterwards.\n  document.addEventListener(\n    'pointerdown',\n    (e) => {\n      if (opened && root && !e.composedPath().includes(root)) close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n  document.addEventListener(\n    'keydown',\n    (e) => {\n      if ((e as KeyboardEvent).key === 'Escape') close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n\n  return {\n    get element() {\n      return root;\n    },\n    open(next, anchor) {\n      if (disposed) return;\n      target = next;\n      anchorEl?.removeAttribute('data-tbw-size-open');\n      anchorEl = anchor;\n      anchor.setAttribute('data-tbw-size-open', '');\n      if (!root) root = build();\n      const host = options.getHost(next) ?? document.body;\n      if (root.parentNode !== host) host.appendChild(root);\n      root.setAttribute('aria-label', options.getLabel(next));\n      sync();\n      root.hidden = false;\n      if (!opened && supportsPopover()) root.showPopover();\n      opened = true;\n      place(anchor);\n      input?.focus();\n    },\n    close,\n    dispose() {\n      disposed = true;\n      close();\n      abort.abort();\n      root?.remove();\n      root = null;\n      input = null;\n    },\n  };\n}\n","/**\n * Grid DOM Constants\n *\n * Centralized constants for CSS classes, data attributes, and selectors\n * used throughout the grid. Use these instead of magic strings.\n *\n * Note: Some constants here are used by plugins but defined in core because:\n * 1. The core CSS needs to style these elements (e.g., sticky positioning)\n * 2. Multiple plugins may share the same class names\n *\n * Plugins can define their own additional constants and export them.\n * See each plugin's index.ts for plugin-specific exports.\n */\n\n/**\n * CSS selector for focusable editor elements within a cell.\n * Used by EditingPlugin, UndoRedoPlugin, and keyboard navigation. Defined here\n * (a leaf module) rather than in `rows.ts` so `keyboard.ts` can consume it\n * without creating a rows ↔ keyboard import cycle.\n */\nexport const FOCUSABLE_EDITOR_SELECTOR =\n  'input,select,textarea,[contenteditable=\"true\"],[contenteditable=\"\"],[tabindex]:not([tabindex=\"-1\"])';\n\n// #region CSS Classes\n\n/**\n * CSS class names used in the grid's DOM.\n * Use these when adding/removing classes or querying elements.\n *\n * Classes are organized by:\n * - Core: Used by the grid core for structure and basic functionality\n * - Shared: Used by multiple features/plugins, styled by core CSS\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridClasses = {\n  // ─── Core Structure ───────────────────────────────────────────────\n  ROOT: 'tbw-grid-root',\n  HEADER: 'header',\n  HEADER_ROW: 'header-row',\n  HEADER_CELL: 'header-cell',\n\n  // Body structure\n  ROWS_VIEWPORT: 'rows-viewport',\n  ROWS_SPACER: 'rows-spacer',\n  ROWS_CONTAINER: 'rows',\n\n  // Row elements\n  DATA_ROW: 'data-grid-row',\n  GROUP_ROW: 'group-row',\n\n  // Cell elements\n  DATA_CELL: 'cell',\n\n  // ─── Core States ──────────────────────────────────────────────────\n  SELECTED: 'selected',\n  FOCUSED: 'focused',\n  EDITING: 'editing',\n  EXPANDED: 'expanded',\n  COLLAPSED: 'collapsed',\n  DRAGGING: 'dragging',\n  RESIZING: 'resizing',\n\n  // Sorting (core feature)\n  SORTABLE: 'sortable',\n  SORTED_ASC: 'sorted-asc',\n  SORTED_DESC: 'sorted-desc',\n\n  // Visibility\n  HIDDEN: 'hidden',\n\n  // ─── Shared Classes (used by plugins, styled by core CSS) ────────\n  // These are defined here because core CSS provides the base styling.\n  // Plugins apply these classes; core CSS defines how they look.\n\n  // Sticky positioning (PinnedColumnsPlugin applies, core CSS styles)\n  STICKY_LEFT: 'sticky-left',\n  STICKY_RIGHT: 'sticky-right',\n\n  // Pinned rows (PinnedRowsPlugin applies, core CSS styles)\n  PINNED_TOP: 'pinned-top',\n  PINNED_BOTTOM: 'pinned-bottom',\n\n  // Tree structure (TreePlugin applies, core CSS styles)\n  TREE_TOGGLE: 'tree-toggle',\n  TREE_INDENT: 'tree-indent',\n\n  // Grouping (GroupingRowsPlugin applies, core CSS styles)\n  GROUP_TOGGLE: 'group-toggle',\n  GROUP_LABEL: 'group-label',\n  GROUP_COUNT: 'group-count',\n\n  // Selection (SelectionPlugin applies, core CSS styles)\n  RANGE_SELECTION: 'range-selection',\n  SELECTION_OVERLAY: 'selection-overlay',\n} as const;\n\n// #endregion\n\n// #region Data Attributes\n\n/**\n * Data attribute names used on grid elements.\n * Use these when getting/setting data attributes.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridDataAttrs = {\n  // ─── Core Attributes ──────────────────────────────────────────────\n  FIELD: 'data-field',\n\n  /**\n   * Marks a `title` the grid itself put on a cell to reveal ellipsised text\n   * (WCAG SC 1.4.12). Anything that sets its own `title` on a cell must clear\n   * this, or the grid will later mistake that title for its own and replace it.\n   *\n   * @since 3.6.0\n   */\n  TRUNCATED: 'data-tbw-truncated',\n\n  // ─── Shared Attributes (used by plugins) ──────────────────────────\n  GROUP_KEY: 'data-group-key', // GroupingRowsPlugin\n} as const;\n\n// #endregion\n\n// #region Selectors\n\n/**\n * Common CSS selectors for querying grid elements.\n * Built from the class constants for consistency.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridSelectors = {\n  ROOT: `.${GridClasses.ROOT}`,\n  HEADER: `.${GridClasses.HEADER}`,\n  HEADER_ROW: `.${GridClasses.HEADER_ROW}`,\n  HEADER_CELL: `.${GridClasses.HEADER_CELL}`,\n  ROWS_VIEWPORT: `.${GridClasses.ROWS_VIEWPORT}`,\n  ROWS_CONTAINER: `.${GridClasses.ROWS_CONTAINER}`,\n  DATA_ROW: `.${GridClasses.DATA_ROW}`,\n  DATA_CELL: `.${GridClasses.DATA_CELL}`,\n  GROUP_ROW: `.${GridClasses.GROUP_ROW}`,\n\n  // By data attribute\n  CELL_BY_FIELD: (field: string) => `.${GridClasses.DATA_CELL}[${GridDataAttrs.FIELD}=\"${field}\"]`,\n\n  // State selectors\n  SELECTED_ROWS: `.${GridClasses.DATA_ROW}.${GridClasses.SELECTED}`,\n  EDITING_CELL: `.${GridClasses.DATA_CELL}.${GridClasses.EDITING}`,\n} as const;\n\n// #endregion\n\n// #region CSS Custom Properties\n\n/**\n * CSS custom property names for theming.\n * Use these when programmatically setting styles.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridCSSVars = {\n  // Colors\n  COLOR_BG: '--tbw-color-bg',\n  COLOR_FG: '--tbw-color-fg',\n  COLOR_FG_MUTED: '--tbw-color-fg-muted',\n  COLOR_BORDER: '--tbw-color-border',\n  COLOR_ACCENT: '--tbw-color-accent',\n  COLOR_HEADER_BG: '--tbw-color-header-bg',\n  COLOR_HEADER_FG: '--tbw-color-header-fg',\n  COLOR_SELECTION: '--tbw-color-selection',\n  COLOR_ROW_HOVER: '--tbw-color-row-hover',\n  COLOR_ROW_ALT: '--tbw-color-row-alt',\n\n  // Sizing\n  ROW_HEIGHT: '--tbw-row-height',\n  HEADER_HEIGHT: '--tbw-header-height',\n  CELL_PADDING: '--tbw-cell-padding',\n\n  // Typography\n  FONT_FAMILY: '--tbw-font-family',\n  FONT_SIZE: '--tbw-font-size',\n\n  // Borders\n  BORDER_RADIUS: '--tbw-border-radius',\n  FOCUS_OUTLINE: '--tbw-focus-outline',\n} as const;\n\n// #endregion\n\n// Type helpers\n\n/**\n * Union of all CSS class names used in the grid's DOM.\n * Use `GridClasses` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridClassName = (typeof GridClasses)[keyof typeof GridClasses];\n\n/**\n * Union of all `data-*` attribute names used on grid elements.\n * Use `GridDataAttrs` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridDataAttr = (typeof GridDataAttrs)[keyof typeof GridDataAttrs];\n\n/**\n * Union of all CSS custom property names (`--tbw-*`) available for theming.\n * Use `GridCSSVars` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridCSSVar = (typeof GridCSSVars)[keyof typeof GridCSSVars];\n","/**\n * DOM Builder - Direct DOM construction for performance.\n *\n * Using direct DOM APIs instead of innerHTML is significantly faster:\n * - No HTML parsing by the browser\n * - No template string concatenation\n * - Immediate element creation without serialization/deserialization\n *\n * Benchmark: DOM construction is ~2-3x faster than innerHTML for complex structures.\n */\n\nimport { GridClasses } from '../constants';\nimport { setSanitizedHTML } from './sanitize';\n\n// #region Element Factories\n/**\n * Apply attributes to an element, skipping null/undefined values.\n * Shared by createElement/div/button to keep the bundle small.\n */\nfunction applyAttrs(el: Element, attrs: Record<string, string | undefined> | undefined): void {\n  if (!attrs) return;\n  for (const key in attrs) {\n    const value = attrs[key];\n    if (value != null) el.setAttribute(key, value);\n  }\n}\n\n/**\n * Create an element with attributes and optional children.\n * Optimized helper that avoids repeated function calls.\n */\nfunction createElement<K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  attrs?: Record<string, string>,\n  children?: (Node | string | null | undefined)[],\n): HTMLElementTagNameMap[K] {\n  const el = document.createElement(tag);\n  applyAttrs(el, attrs);\n\n  if (children) {\n    for (const child of children) {\n      if (child == null) continue;\n      if (typeof child === 'string') {\n        el.appendChild(document.createTextNode(child));\n      } else {\n        el.appendChild(child);\n      }\n    }\n  }\n\n  return el;\n}\n\n/**\n * Create an element with class (common pattern).\n */\nfunction div(className?: string, attrs?: Record<string, string>): HTMLDivElement {\n  const el = document.createElement('div');\n  if (className) el.className = className;\n  applyAttrs(el, attrs);\n  return el;\n}\n\n/**\n * Create a button element. Always sets `type=\"button\"` (callers can override\n * via `attrs`) so internal grid buttons inside a <form> never default to\n * type=\"submit\". See issue #296.\n */\nfunction button(className?: string, attrs?: Record<string, string>, content?: string | Node): HTMLButtonElement {\n  const el = document.createElement('button');\n  el.type = 'button';\n  if (className) el.className = className;\n  applyAttrs(el, attrs);\n  if (content) {\n    if (typeof content === 'string') {\n      el.textContent = content;\n    } else {\n      el.appendChild(content);\n    }\n  }\n  return el;\n}\n// #endregion\n\n// #region Grid Templates\n/**\n * Template for grid content (the core scrollable grid area).\n * Pre-built once, then cloned for each grid instance.\n */\nconst gridContentTemplate = document.createElement('template');\ngridContentTemplate.innerHTML = `\n  <div class=\"tbw-scroll-area\">\n    <div class=\"rows-body-wrapper\">\n      <div class=\"rows-body\" role=\"grid\">\n        <div class=\"header\" role=\"rowgroup\">\n          <div class=\"header-row\" role=\"row\" part=\"header-row\"></div>\n        </div>\n        <div class=\"rows-container\" role=\"presentation\">\n          <div class=\"rows-viewport\" role=\"presentation\">\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  <div class=\"tbw-sr-only\" aria-live=\"polite\" aria-atomic=\"true\"></div>\n`;\n\n/**\n * Clone the grid content structure.\n * Using template cloning is faster than createElement for nested structures.\n */\nexport function cloneGridContent(): DocumentFragment {\n  return gridContentTemplate.content.cloneNode(true) as DocumentFragment;\n}\n// #endregion\n\n// #region Grid DOM Building\n/**\n * Build the grid root structure using direct DOM construction.\n * This is called once per grid instance during initial render.\n */\nexport interface GridDOMOptions {\n  hasShell: boolean;\n  /** Shell header element (pre-built) */\n  shellHeader?: Element;\n  /** Shell body element with tool panel (pre-built) */\n  shellBody?: Element;\n}\n\n/**\n * Build the complete grid DOM structure.\n * Returns a DocumentFragment ready to be appended to shadow root.\n */\nexport function buildGridDOM(options: GridDOMOptions): DocumentFragment {\n  const fragment = document.createDocumentFragment();\n\n  const root = div(options.hasShell ? `${GridClasses.ROOT} has-shell` : GridClasses.ROOT);\n\n  if (options.hasShell && options.shellBody) {\n    // Shell mode: optional header + body (with grid content inside).\n    // The header bar may be suppressed via `shell.header.visible: false`, in\n    // which case only the body (and its tool panel) is rendered.\n    if (options.shellHeader) root.appendChild(options.shellHeader);\n    root.appendChild(options.shellBody);\n  } else {\n    // No shell: just grid content in wrapper\n    const contentWrapper = div('tbw-grid-content');\n    contentWrapper.appendChild(cloneGridContent());\n    root.appendChild(contentWrapper);\n  }\n\n  fragment.appendChild(root);\n  return fragment;\n}\n\n/**\n * Build the BARE grid DOM (no shell chrome) directly into `renderRoot`.\n *\n * Preserves all existing direct child nodes EXCEPT the grid's own\n * `.tbw-grid-root` (which is rebuilt), so user/framework light-DOM stays intact\n * in its original order — including non-element nodes (comment anchors used by\n * Angular `@if`/`@for` and other structural directives as positional markers).\n *\n * Core's render path always builds the bare grid; the shell, when configured,\n * is wrapped around this freshly built grid by the auto-registered ShellPlugin\n * in the `afterStructuralRender` hook (extraction #370 — DOM ownership\n * inversion). Core therefore holds no shell-construction knowledge.\n */\nexport function buildBareGridDOMIntoElement(renderRoot: Element): void {\n  const preservedNodes: Node[] = [];\n  for (let n: Node | null = renderRoot.firstChild; n; n = n.nextSibling) {\n    if (n.nodeType === 1 && (n as Element).classList.contains(GridClasses.ROOT)) continue;\n    preservedNodes.push(n);\n  }\n\n  // Clear existing content (this would delete light DOM nodes, so we preserved them first).\n  renderRoot.replaceChildren();\n\n  // Re-append preserved nodes in original order (hidden elements are used for config).\n  // IMPORTANT: These are prepended before .tbw-grid-root, so `renderRoot.children[0]`\n  // is NOT the grid root. Use `querySelector('.tbw-grid-root')` instead.\n  for (const n of preservedNodes) {\n    renderRoot.appendChild(n);\n  }\n\n  renderRoot.appendChild(buildGridDOM({ hasShell: false }));\n}\n// #endregion\n\n// #region Shell Header\n/**\n * Build shell header using direct DOM construction.\n *\n * Note: The grid no longer creates buttons from config (icon/action).\n * Config/API buttons only use element or render function.\n * Light DOM buttons are slotted directly.\n * The ONLY button the grid creates is the panel toggle.\n */\nexport interface ShellHeaderOptions {\n  title?: string;\n  hasPanels: boolean;\n  isPanelOpen: boolean;\n  toolPanelIcon?: string;\n  /**\n   * Whether to render the built-in tool panel toggle button and the\n   * adjacent separator. Independent of `hasPanels` so panels can remain\n   * registered (and openable via the public API) while the consumer\n   * supplies their own toggle button.\n   * @default true when hasPanels is true\n   */\n  showToggle?: boolean;\n  /** Config toolbar contents with render function (pre-sorted by order) */\n  configButtons: Array<{\n    id: string;\n    hasRender?: boolean;\n  }>;\n  /** API toolbar contents with render function (pre-sorted by order) */\n  apiButtons: Array<{\n    id: string;\n    hasRender?: boolean;\n  }>;\n}\n\n/**\n * Build shell header element directly without innerHTML.\n */\nexport function buildShellHeader(options: ShellHeaderOptions): HTMLDivElement {\n  const header = div('tbw-shell-header', { part: 'shell-header', role: 'presentation' });\n\n  // Title\n  if (options.title) {\n    const titleEl = div('tbw-shell-title');\n    titleEl.textContent = options.title;\n    header.appendChild(titleEl);\n  }\n\n  // Shell content with placeholder for light DOM header content\n  const content = div('tbw-shell-content', {\n    part: 'shell-content',\n    role: 'presentation',\n    'data-light-dom-header-content': '',\n  });\n  header.appendChild(content);\n\n  // Toolbar\n  const toolbar = div('tbw-shell-toolbar', { part: 'shell-toolbar', role: 'presentation' });\n\n  // Placeholders for config toolbar contents with render function\n  for (const btn of options.configButtons) {\n    if (btn.hasRender) {\n      toolbar.appendChild(div('tbw-toolbar-content-slot', { 'data-toolbar-content': btn.id }));\n    }\n  }\n  // Placeholders for API toolbar contents with render function\n  for (const btn of options.apiButtons) {\n    if (btn.hasRender) {\n      toolbar.appendChild(div('tbw-toolbar-content-slot', { 'data-toolbar-content': btn.id }));\n    }\n  }\n\n  // Separator between custom content and panel toggle\n  const hasCustomContent =\n    options.configButtons.some((b) => b.hasRender) || options.apiButtons.some((b) => b.hasRender);\n  // Default showToggle to hasPanels for backwards compat; suppress both the\n  // button and the separator when the consumer opts out.\n  const showToggle = options.hasPanels && options.showToggle !== false;\n  if (hasCustomContent && showToggle) {\n    toolbar.appendChild(div('tbw-toolbar-separator'));\n  }\n\n  // Panel toggle button (suppressed when shell.header.toolPanelToggle is false)\n  if (showToggle) {\n    const toggleBtn = button(options.isPanelOpen ? 'tbw-toolbar-btn active' : 'tbw-toolbar-btn', {\n      'data-panel-toggle': '',\n      title: 'Settings',\n      'aria-label': 'Toggle settings panel',\n      'aria-pressed': String(options.isPanelOpen),\n      'aria-controls': 'tbw-tool-panel',\n    });\n    toggleBtn.dataset.icon = 'tool-panel';\n    if (options.toolPanelIcon !== undefined) {\n      setSanitizedHTML(toggleBtn, options.toolPanelIcon);\n    }\n    toolbar.appendChild(toggleBtn);\n  }\n\n  header.appendChild(toolbar);\n  return header;\n}\n// #endregion\n\n// #region Shell Body\n/**\n * Build shell body (grid content + optional tool panel).\n */\nexport interface ShellBodyOptions {\n  position: 'left' | 'right';\n  /**\n   * Layout mode for the tool panel.\n   * - `'overlay'` (default): panel is absolutely positioned over the grid.\n   * - `'push'`: panel participates in flex layout, shrinking the grid sibling.\n   * - `'dropdown'`: panel is a native popover anchored near a trigger element.\n   */\n  mode?: 'overlay' | 'push' | 'dropdown';\n  isPanelOpen: boolean;\n  expandIcon?: string;\n  collapseIcon?: string;\n  /**\n   * Render an in-panel close (✕) button in the panel's top-right corner.\n   * Used when the shell header bar is hidden (`shell.header.visible: false`)\n   * so the panel can be dismissed without the built-in header toggle.\n   */\n  showCloseButton?: boolean;\n  /** Sorted panels for accordion */\n  panels: Array<{\n    id: string;\n    title?: string;\n    icon?: string;\n    isExpanded: boolean;\n  }>;\n}\n\n/**\n * Panel close (✕) button. `data-panel-close` is wired by\n * `setupShellEventListeners` to close the panel.\n */\nfunction buildPanelCloseButton(inline: boolean): HTMLButtonElement {\n  const closeBtn = button(inline ? 'tbw-tool-panel-close tbw-tool-panel-close--inline' : 'tbw-tool-panel-close', {\n    part: 'tool-panel-close',\n    'data-panel-close': '',\n    title: 'Close panel',\n    'aria-label': 'Close panel',\n    'aria-controls': 'tbw-tool-panel',\n  });\n  closeBtn.textContent = '✕';\n  return closeBtn;\n}\n\n/** Slim standalone header row holding just the close button. */\nfunction buildPanelCloseRow(): HTMLDivElement {\n  const panelHeader = div('tbw-tool-panel-header', { part: 'tool-panel-header' });\n  panelHeader.appendChild(buildPanelCloseButton(false));\n  return panelHeader;\n}\n\n/** Accordion header button: icon + title + chevron. */\nfunction buildAccordionHeader(\n  panel: ShellBodyOptions['panels'][number],\n  options: ShellBodyOptions,\n  isSinglePanel: boolean,\n): HTMLButtonElement {\n  const headerBtn = button('tbw-accordion-header', {\n    'aria-expanded': String(panel.isExpanded),\n    'aria-controls': `tbw-section-${panel.id}`,\n  });\n  if (isSinglePanel) headerBtn.setAttribute('aria-disabled', 'true');\n\n  if (panel.icon) {\n    const iconSpan = createElement('span', { class: 'tbw-accordion-icon' });\n    setSanitizedHTML(iconSpan, panel.icon);\n    headerBtn.appendChild(iconSpan);\n  }\n\n  // Title (empty span kept as a flex spacer so the chevron stays right-aligned)\n  const titleSpan = createElement('span', { class: 'tbw-accordion-title' });\n  titleSpan.textContent = panel.title ?? '';\n  headerBtn.appendChild(titleSpan);\n\n  // Chevron (hidden for single panel) — always use expandIcon, CSS rotation handles state\n  if (!isSinglePanel) {\n    const chevronSpan = createElement('span', { class: 'tbw-accordion-chevron', 'data-icon': 'expand' });\n    if (options.expandIcon !== undefined) {\n      setSanitizedHTML(chevronSpan, options.expandIcon);\n    }\n    headerBtn.appendChild(chevronSpan);\n  }\n  return headerBtn;\n}\n\n/** One accordion section (header row + empty content slot). */\nfunction buildAccordionSection(\n  panel: ShellBodyOptions['panels'][number],\n  options: ShellBodyOptions,\n  isSinglePanel: boolean,\n  inlineClose: boolean,\n): HTMLDivElement {\n  // The accordion header row (icon + title + chevron/toggle) is skipped only\n  // when a single title-less panel is registered — there is nothing to show and\n  // no sibling to toggle between. With multiple panels a title-less header still\n  // renders (empty title span) so the chevron and toggle button stay available.\n  const renderHeader = !!panel.title || !isSinglePanel;\n  // Inline close shares the header row; only possible when a header exists.\n  const canInlineClose = inlineClose && renderHeader;\n  const sectionClasses = `tbw-accordion-section${panel.isExpanded ? ' expanded' : ''}${isSinglePanel ? ' single' : ''}${canInlineClose ? ' has-inline-close' : ''}`;\n  const section = div(sectionClasses, { 'data-section': panel.id });\n\n  if (renderHeader) {\n    const headerBtn = buildAccordionHeader(panel, options, isSinglePanel);\n    if (canInlineClose) {\n      // Single-panel close button shares the header row with the panel title.\n      const headerRow = div('tbw-accordion-header-row');\n      headerRow.appendChild(headerBtn);\n      headerRow.appendChild(buildPanelCloseButton(true));\n      section.appendChild(headerRow);\n    } else {\n      section.appendChild(headerBtn);\n    }\n  } else if (inlineClose) {\n    // Single title-less panel with the header suppressed: the inline close\n    // button has no header row to share, so render it as a standalone row.\n    section.appendChild(buildPanelCloseRow());\n  }\n\n  // Accordion content (empty, will be filled by panel render functions)\n  section.appendChild(\n    div('tbw-accordion-content', {\n      id: `tbw-section-${panel.id}`,\n      role: 'presentation',\n    }),\n  );\n  return section;\n}\n\n/** The `<aside>` tool panel: resize handle, optional close affordance, accordion. */\nfunction buildToolPanel(options: ShellBodyOptions, mode: 'overlay' | 'push' | 'dropdown'): HTMLElement {\n  const isSinglePanel = options.panels.length === 1;\n  const panelEl = createElement('aside', {\n    class: options.isPanelOpen ? 'tbw-tool-panel open' : 'tbw-tool-panel',\n    part: 'tool-panel',\n    'data-position': options.position,\n    role: 'presentation',\n    id: 'tbw-tool-panel',\n    // In dropdown mode the panel is a manually-controlled native popover\n    // (shown/hidden via showPopover()/hidePopover() from the controller).\n    ...(mode === 'dropdown' ? { popover: 'manual' } : {}),\n  });\n\n  // Resize handle — draggable, and tappable for the SC 2.5.7 size menu.\n  panelEl.appendChild(\n    div('tbw-tool-panel-resize', {\n      'data-resize-handle': '',\n      'data-handle-position': options.position === 'left' ? 'right' : 'left',\n      role: 'button',\n      tabindex: '-1',\n      'aria-label': 'Tool panel width — drag, or activate to set a width',\n    }),\n  );\n\n  // Optional close (✕) button — rendered (overlay/push only) when the shell\n  // header bar is hidden, so the panel can always be dismissed. Dropdown mode\n  // never reaches here (showCloseButton is gated off upstream).\n  //\n  // Placement:\n  // - Multiple panels: a dedicated slim header row above the accordion.\n  // - Single panel: inlined onto the (only) accordion header row so it shares\n  //   the line with the panel title instead of wasting a full-width row.\n  const inlineClose = options.showCloseButton === true && isSinglePanel;\n  if (options.showCloseButton && !isSinglePanel) {\n    panelEl.appendChild(buildPanelCloseRow());\n  }\n\n  const panelContent = div('tbw-tool-panel-content', { role: 'presentation' });\n  const accordion = div('tbw-accordion');\n  for (const panel of options.panels) {\n    accordion.appendChild(buildAccordionSection(panel, options, isSinglePanel, inlineClose));\n  }\n  panelContent.appendChild(accordion);\n  panelEl.appendChild(panelContent);\n  return panelEl;\n}\n\n/**\n * Build shell body element directly without innerHTML.\n */\nexport function buildShellBody(options: ShellBodyOptions): HTMLDivElement {\n  const mode = options.mode ?? 'overlay';\n  const body = div('tbw-shell-body', { 'data-mode': mode });\n\n  // Grid content wrapper with cloned grid structure\n  const gridContent = div('tbw-grid-content');\n  gridContent.appendChild(cloneGridContent());\n\n  const panelEl = options.panels.length > 0 ? buildToolPanel(options, mode) : null;\n\n  // Append in correct order based on position\n  if (options.position === 'left' && panelEl) {\n    body.appendChild(panelEl);\n    body.appendChild(gridContent);\n  } else {\n    body.appendChild(gridContent);\n    if (panelEl) body.appendChild(panelEl);\n  }\n\n  return body;\n}\n// #endregion\n","/**\n * Shell infrastructure for grid header bar and tool panels.\n *\n * The shell is an optional wrapper layer that provides:\n * - Header bar with title, plugin content, and toolbar buttons\n * - Tool panels that plugins can register content into\n * - Light DOM parsing for framework-friendly configuration\n */\n\nimport { TOOL_PANEL_DUPLICATE, TOOL_PANEL_MISSING_ATTR, warnDiagnostic } from '../../core/internal/diagnostics';\nimport { startPointerDrag } from '../../core/internal/pointer-drag';\nimport { escapeHtml, sanitizeHTML, setSanitizedHTML } from '../../core/internal/sanitize';\nimport { createSizePopover, type SizePopover } from '../../core/internal/size-popover';\nimport type { IconValue } from '../../core/types';\nimport type { HeaderContentDefinition, ShellConfig, ToolbarContentDefinition, ToolPanelDefinition } from './types';\n\n/** Tool-panel width change per click of the size popover's − / + buttons, in px. */\nconst RESIZE_STEP_PX = 32;\n\n// #region Types & State\n/**\n * Convert an IconValue to a string for rendering in HTML.\n */\nfunction iconToString(icon: IconValue | undefined): string {\n  if (!icon) return '';\n  if (typeof icon === 'string') return sanitizeHTML(icon);\n  // For HTMLElement, get the outerHTML\n  return icon.outerHTML;\n}\n\n/**\n * State for managing shell UI.\n *\n * This interface holds both configuration-like properties (toolPanels, headerContents)\n * and runtime state (isPanelOpen, expandedSections). The Maps allow for efficient\n * registration/unregistration of panels and content.\n */\nexport interface ShellState {\n  /** Registered tool panels (from plugins + consumer API) */\n  toolPanels: Map<string, ToolPanelDefinition>;\n  /** Registered header content (from plugins + consumer API) */\n  headerContents: Map<string, HeaderContentDefinition>;\n  /** Toolbar content registered via API or light DOM */\n  toolbarContents: Map<string, ToolbarContentDefinition>;\n  /** Whether a <tbw-grid-tool-buttons> container was found in light DOM */\n  hasToolButtonsContainer: boolean;\n  /** Light DOM header content elements */\n  lightDomHeaderContent: HTMLElement[];\n  /** Light DOM header title from <tbw-grid-header title=\"...\"> */\n  lightDomTitle: string | null;\n  /** IDs of tool panels registered from light DOM (to avoid re-parsing) */\n  lightDomToolPanelIds: Set<string>;\n  /**\n   * IDs of light DOM tool panels whose `render` has already been bound to a\n   * framework-adapter renderer. Used by `parseLightDomToolPanels` to detect\n   * the FIRST adapter attach (which legitimately needs to swap the vanilla\n   * fallback for the real adapter renderer and tear down any in-progress\n   * render) vs. subsequent re-parses (which must NOT tear down — doing so\n   * unmounts the user's React/Vue/Angular component, losing local state and\n   * resetting scroll position inside the panel).\n   */\n  adapterBoundToolPanelIds: Set<string>;\n  /** IDs of toolbar content registered from light DOM (to avoid re-parsing) */\n  lightDomToolbarContentIds: Set<string>;\n  /** IDs of tool panels registered via registerToolPanel API */\n  apiToolPanelIds: Set<string>;\n  /** IDs of header content registered via registerHeaderContent API */\n  apiHeaderContentIds: Set<string>;\n  /** Whether the tool panel sidebar is open */\n  isPanelOpen: boolean;\n  /** Which accordion sections are expanded (by panel ID) */\n  expandedSections: Set<string>;\n  /** Whether light DOM header content has been moved to placeholder (perf optimization) */\n  lightDomContentMoved: boolean;\n  /** Cleanup functions for header content render returns */\n  headerContentCleanups: Map<string, () => void>;\n  /** Cleanup functions for each panel section's render return */\n  panelCleanups: Map<string, () => void>;\n  /** Cleanup functions for toolbar content render returns */\n  toolbarContentCleanups: Map<string, () => void>;\n  /**\n   * Element the dropdown popover is currently anchored to (mode: 'dropdown').\n   * Tracked so dismissal logic can ignore clicks on the anchor and the\n   * `anchor-name` it set can be cleared on close. `null` when no dropdown is open.\n   */\n  dropdownAnchorEl?: HTMLElement | null;\n  /**\n   * Unique `anchor-name` assigned to the current dropdown's trigger (and\n   * mirrored as `position-anchor` on the popover). Minted per show so multiple\n   * grids on one page never collide on a shared anchor name — a collision would\n   * position one grid's popover against another grid's trigger. `null` when no\n   * dropdown is open.\n   */\n  dropdownAnchorName?: string | null;\n}\n\n/**\n * Create initial shell state.\n */\nexport function createShellState(): ShellState {\n  return {\n    toolPanels: new Map(),\n    headerContents: new Map(),\n    toolbarContents: new Map(),\n    hasToolButtonsContainer: false,\n    lightDomHeaderContent: [],\n    lightDomTitle: null,\n    lightDomToolPanelIds: new Set(),\n    adapterBoundToolPanelIds: new Set(),\n    lightDomToolbarContentIds: new Set(),\n    apiToolPanelIds: new Set(),\n    apiHeaderContentIds: new Set(),\n    isPanelOpen: false,\n    expandedSections: new Set(),\n    headerContentCleanups: new Map(),\n    panelCleanups: new Map(),\n    toolbarContentCleanups: new Map(),\n    lightDomContentMoved: false,\n    dropdownAnchorEl: null,\n    dropdownAnchorName: null,\n  };\n}\n// #endregion\n\n// #region Render Functions\n/**\n * Determine if shell header should be rendered.\n * Reads only from effectiveConfig.shell (single source of truth).\n */\nexport function shouldRenderShellHeader(config: ShellConfig | undefined): boolean {\n  // Check if title is configured\n  if (config?.header?.title) return true;\n\n  // Check if config has toolbar contents\n  if (config?.header?.toolbarContents?.length) return true;\n\n  // Check if any tool panels are registered\n  if (config?.toolPanels?.length) return true;\n\n  // Check if any header content is registered\n  if (config?.headerContents?.length) return true;\n\n  // Check if light DOM has header elements\n  if (config?.header?.lightDomContent?.length) return true;\n\n  // Check if a toolbar buttons container was found\n  if (config?.header?.hasToolButtonsContainer) return true;\n\n  return false;\n}\n\n/**\n * Determine whether the visible shell header bar (`.tbw-shell-header`) should\n * be rendered.\n *\n * Distinct from {@link shouldRenderShellHeader}, which decides whether the\n * shell *wrapper* (including the body that hosts the tool panel) exists at\n * all. The header bar can be suppressed via `header.visible: false` while the\n * shell body and tool panels still render — letting consumers drive panels\n * from their own UI (e.g. a utility-column header icon).\n */\nexport function shouldRenderHeaderBar(config: ShellConfig | undefined): boolean {\n  return config?.header?.visible !== false;\n}\n\n/**\n * Render the shell header HTML.\n *\n * Toolbar contents come from two sources:\n * 1. Light DOM slot (users provide their own HTML in <tbw-grid-tool-buttons>)\n * 2. Config/API with render function (programmatic insertion)\n *\n * Users have full control over toolbar HTML, styling, and behavior.\n * The only button the grid creates is the tool panel toggle.\n *\n * @param toolPanelIcon - Icon for the tool panel toggle (from grid icon config)\n */\nexport function renderShellHeader(\n  config: ShellConfig | undefined,\n  state: ShellState,\n  toolPanelIcon?: IconValue,\n): string {\n  const title = config?.header?.title ?? state.lightDomTitle ?? '';\n  const hasTitle = !!title;\n\n  // Build tool panel button content: use data-icon for CSS, inject content only for JS overrides\n  let toolPanelBtnContent = '';\n  if (toolPanelIcon !== undefined) {\n    // JS override: inject content but still set data-icon\n    toolPanelBtnContent = typeof toolPanelIcon === 'string' ? sanitizeHTML(toolPanelIcon) : toolPanelIcon.outerHTML;\n  }\n\n  // Get all toolbar contents from effectiveConfig (already merged: config + API + light DOM)\n  // The config-manager merges state.toolbarContents into effectiveConfig.shell.header.toolbarContents\n  // Also include state.toolbarContents directly for cases where renderShellHeader is called\n  // before config-manager has merged (e.g., unit tests, initial render)\n  const configContents = config?.header?.toolbarContents ?? [];\n  const stateContents = [...state.toolbarContents.values()];\n\n  // Merge: use config contents, add state contents that aren't in config\n  const configIds = new Set(configContents.map((c) => c.id));\n  const allContents = [...configContents];\n  for (const content of stateContents) {\n    if (!configIds.has(content.id)) {\n      allContents.push(content);\n    }\n  }\n\n  const hasCustomContent = allContents.length > 0;\n  const hasPanels = state.toolPanels.size > 0;\n  // Allow consumers to suppress the built-in toggle (and the separator that\n  // only exists to space it from custom toolbar contents) so they can render\n  // their own design-system button and wire it to `grid.toggleToolPanel()`.\n  // Also suppress when the tool panel is locked open — toggling is disabled.\n  // Default true preserves existing behavior.\n  const isLocked = config?.toolPanel?.locked === true;\n  const showToggle = hasPanels && config?.header?.toolPanelToggle !== false && !isLocked;\n  const showSeparator = hasCustomContent && showToggle;\n\n  // Sort contents by order for slot placement\n  const sortedContents = [...allContents].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n\n  // Build toolbar HTML\n  let toolbarHtml = '';\n\n  // Create slots for all contents (unified: config + API + light DOM)\n  for (const content of sortedContents) {\n    toolbarHtml += `<div class=\"tbw-toolbar-content-slot\" data-toolbar-content=\"${content.id}\"></div>`;\n  }\n\n  // Separator between custom content and panel toggle\n  if (showSeparator) {\n    toolbarHtml += '<div class=\"tbw-toolbar-separator\"></div>';\n  }\n\n  // Single panel toggle button (the ONLY button the grid creates).\n  // Suppressed when `shell.header.toolPanelToggle === false` so consumers can\n  // BYO toggle button without hiding library DOM via CSS.\n  if (showToggle) {\n    const isOpen = state.isPanelOpen;\n    const toggleClass = isOpen ? 'tbw-toolbar-btn active' : 'tbw-toolbar-btn';\n    // type=\"button\" is required: without it a <button> inside a <form>\n    // defaults to type=\"submit\" and clicking the toggle would submit the\n    // surrounding form. Internal grid buttons must never trigger form\n    // submission. See issue #296.\n    toolbarHtml += `<button type=\"button\" class=\"${toggleClass}\" data-panel-toggle data-icon=\"tool-panel\" title=\"Settings\" aria-label=\"Toggle settings panel\" aria-pressed=\"${isOpen}\" aria-controls=\"tbw-tool-panel\">${toolPanelBtnContent}</button>`;\n  }\n\n  return `\n    <div class=\"tbw-shell-header\" part=\"shell-header\" role=\"presentation\">\n      ${hasTitle ? `<div class=\"tbw-shell-title\">${escapeHtml(title)}</div>` : ''}\n      <div class=\"tbw-shell-content\" part=\"shell-content\" role=\"presentation\" data-light-dom-header-content></div>\n      <div class=\"tbw-shell-toolbar\" part=\"shell-toolbar\" role=\"presentation\">\n        ${toolbarHtml}\n      </div>\n    </div>\n  `;\n}\n\n/**\n * Render the shell body wrapper HTML (contains grid content + accordion-style tool panel).\n * @param icons - Optional icons for expand/collapse chevrons (from grid config)\n */\nexport function renderShellBody(\n  config: ShellConfig | undefined,\n  state: ShellState,\n  gridContentHtml: string,\n  icons?: { expand?: IconValue; collapse?: IconValue },\n): string {\n  const position = config?.toolPanel?.position ?? 'right';\n  const mode = config?.toolPanel?.mode ?? 'overlay';\n  const hasPanel = state.toolPanels.size > 0;\n  const isOpen = state.isPanelOpen;\n  const hasJsExpandIcon = icons?.expand !== undefined;\n  const expandIcon = hasJsExpandIcon ? iconToString(icons.expand) : '';\n\n  // Sort panels by order for accordion sections\n  const sortedPanels = [...state.toolPanels.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n  const isSinglePanel = sortedPanels.length === 1;\n\n  // Build accordion sections HTML\n  let accordionHtml = '';\n  for (const panel of sortedPanels) {\n    const isExpanded = state.expandedSections.has(panel.id);\n    const iconHtml = panel.icon ? `<span class=\"tbw-accordion-icon\">${panel.icon}</span>` : '';\n    // Hide chevron for single panel (no toggling needed)\n    // Always use expandIcon (▶) — CSS rotation handles the expanded state\n    const chevronHtml = isSinglePanel\n      ? ''\n      : `<span class=\"tbw-accordion-chevron\" data-icon=\"expand\">${expandIcon}</span>`;\n    // Disable accordion toggle for single panel\n    const sectionClasses = `tbw-accordion-section${isExpanded ? ' expanded' : ''}${isSinglePanel ? ' single' : ''}`;\n    // Skip the header row only for a single title-less panel. With multiple\n    // panels a title-less header still renders (empty title span) so the\n    // expand/collapse chevron and toggle button remain available.\n    const renderHeader = !!panel.title || !isSinglePanel;\n    const headerHtml = renderHeader\n      ? `<button type=\"button\" class=\"tbw-accordion-header\" aria-expanded=\"${isExpanded}\" aria-controls=\"tbw-section-${panel.id}\"${isSinglePanel ? ' aria-disabled=\"true\"' : ''}>\n          ${iconHtml}\n          <span class=\"tbw-accordion-title\">${escapeHtml(panel.title ?? '')}</span>\n          ${chevronHtml}\n        </button>`\n      : '';\n    accordionHtml += `\n      <div class=\"${sectionClasses}\" data-section=\"${panel.id}\">\n        ${headerHtml}\n        <div class=\"tbw-accordion-content\" id=\"tbw-section-${panel.id}\" role=\"presentation\"></div>\n      </div>\n    `;\n  }\n\n  // Resize handle position depends on panel position\n  const resizeHandlePosition = position === 'left' ? 'right' : 'left';\n\n  const panelHtml = hasPanel\n    ? `\n    <aside class=\"tbw-tool-panel${isOpen ? ' open' : ''}\" part=\"tool-panel\" data-position=\"${position}\" role=\"presentation\" id=\"tbw-tool-panel\"${mode === 'dropdown' ? ' popover=\"manual\"' : ''}>\n      <div class=\"tbw-tool-panel-resize\" data-resize-handle data-handle-position=\"${resizeHandlePosition}\" role=\"button\" tabindex=\"-1\" aria-label=\"Tool panel width — drag, or activate to set a width\"></div>\n      <div class=\"tbw-tool-panel-content\" role=\"presentation\">\n        <div class=\"tbw-accordion\">\n          ${accordionHtml}\n        </div>\n      </div>\n    </aside>\n  `\n    : '';\n\n  // For left position, panel comes before content in DOM order\n  if (position === 'left') {\n    return `\n      <div class=\"tbw-shell-body\" data-mode=\"${mode}\">\n        ${panelHtml}\n        <div class=\"tbw-grid-content\">\n          ${gridContentHtml}\n        </div>\n      </div>\n    `;\n  }\n\n  return `\n    <div class=\"tbw-shell-body\" data-mode=\"${mode}\">\n      <div class=\"tbw-grid-content\">\n        ${gridContentHtml}\n      </div>\n      ${panelHtml}\n    </div>\n  `;\n}\n// #endregion\n\n// #region Light DOM Parsing\n/**\n * Parse light DOM shell elements (tbw-grid-header, etc.).\n * Safe to call multiple times - will only parse once when elements are available.\n */\nexport function parseLightDomShell(host: HTMLElement, state: ShellState): void {\n  const headerEl = host.querySelector('tbw-grid-header');\n  if (!headerEl) return;\n\n  // Parse title attribute (only if not already parsed)\n  if (!state.lightDomTitle) {\n    const title = headerEl.getAttribute('title');\n    if (title) {\n      state.lightDomTitle = title;\n    }\n  }\n\n  // Parse header content elements - store references but don't set slot (light DOM doesn't use slots)\n  const headerContents = headerEl.querySelectorAll('tbw-grid-header-content');\n  if (headerContents.length > 0 && state.lightDomHeaderContent.length === 0) {\n    state.lightDomHeaderContent = Array.from(headerContents) as HTMLElement[];\n  }\n\n  // Hide the light DOM header container (it was just for declarative config)\n  (headerEl as HTMLElement).style.display = 'none';\n}\n\n/**\n * Callback type for creating a toolbar content renderer from a light DOM container.\n * This is used by framework adapters (Angular, React, etc.) to create renderers\n * from their template syntax.\n */\nexport type ToolbarContentRendererFactory = (\n  container: HTMLElement,\n) => ((target: HTMLElement) => void | (() => void)) | undefined;\n\n/**\n * Parse toolbar buttons container element (<tbw-grid-tool-buttons>).\n * This is a content container - we don't parse individual children.\n * The entire container content is registered as a single toolbar content entry.\n *\n * Example:\n * ```html\n * <tbw-grid>\n *   <tbw-grid-tool-buttons>\n *     <button>My button</button>\n *     <button>My other button</button>\n *   </tbw-grid-tool-buttons>\n * </tbw-grid>\n * ```\n *\n * The container's children are moved to the toolbar area during render.\n * We treat this as opaque content - users control what goes inside.\n *\n * @param host - The grid host element\n * @param state - Shell state to update\n * @param rendererFactory - Optional factory for creating renderers (used by framework adapters)\n */\nexport function parseLightDomToolButtons(\n  host: HTMLElement,\n  state: ShellState,\n  rendererFactory?: ToolbarContentRendererFactory,\n): void {\n  // Look for the toolbar buttons container element\n  const toolButtonsContainer = host.querySelector(':scope > tbw-grid-tool-buttons') as HTMLElement | null;\n  if (!toolButtonsContainer) return;\n\n  // Mark that we found the container (for shouldRenderShellHeader)\n  state.hasToolButtonsContainer = true;\n\n  // Skip if already registered\n  const id = 'light-dom-toolbar-content';\n  if (state.lightDomToolbarContentIds.has(id)) return;\n\n  // Register as a single content entry with a render function\n  const adapterRenderer = rendererFactory?.(toolButtonsContainer);\n\n  const contentDef: ToolbarContentDefinition = {\n    id,\n    order: 0, // Light DOM content comes first\n    render:\n      adapterRenderer ??\n      ((target: HTMLElement) => {\n        // Move all children from the light DOM container to the target\n        while (toolButtonsContainer.firstChild) {\n          target.appendChild(toolButtonsContainer.firstChild);\n        }\n        // Return cleanup that moves children back to original container\n        // This preserves them across full re-renders that destroy the slot\n        return () => {\n          while (target.firstChild) {\n            toolButtonsContainer.appendChild(target.firstChild);\n          }\n        };\n      }),\n  };\n\n  state.toolbarContents.set(id, contentDef);\n  state.lightDomToolbarContentIds.add(id);\n\n  // Hide the original container\n  toolButtonsContainer.style.display = 'none';\n}\n\n/**\n * Callback type for creating a tool panel renderer from a light DOM element.\n * This is used by framework adapters (Angular, React, etc.) to create renderers\n * from their template syntax.\n */\nexport type ToolPanelRendererFactory = (\n  element: HTMLElement,\n) => ((container: HTMLElement) => void | (() => void)) | undefined;\n\n/**\n * Parse light DOM tool panel elements (<tbw-grid-tool-panel>).\n * These can appear as direct children of <tbw-grid> for declarative tool panel configuration.\n *\n * Attributes:\n * - `id` (required): Unique panel identifier\n * - `title` (optional): Panel title shown in accordion header. Omit it when the\n *   panel content provides its own heading (see {@link ToolPanelDefinition.title}).\n * - `icon`: Icon for accordion section header (emoji or text)\n * - `tooltip`: Tooltip for accordion section header\n * - `order`: Panel order priority (lower = first, default: 100)\n *\n * For vanilla JS, the element's innerHTML is used as the panel content.\n * For framework adapters, the adapter can provide a custom renderer factory.\n *\n * @param host - The grid host element\n * @param state - Shell state to update\n * @param rendererFactory - Optional factory for creating renderers (used by framework adapters)\n */\nexport function parseLightDomToolPanels(\n  host: HTMLElement,\n  state: ShellState,\n  rendererFactory?: ToolPanelRendererFactory,\n): void {\n  const toolPanelElements = host.querySelectorAll(':scope > tbw-grid-tool-panel');\n\n  toolPanelElements.forEach((element) => {\n    const panelEl = element as HTMLElement;\n    const id = panelEl.getAttribute('id');\n    const title = panelEl.getAttribute('title') ?? undefined;\n\n    // Skip only if the required `id` is missing. `title` is optional (#430):\n    // a title-less panel renders its content without an accordion header row\n    // (single panel) or with an empty title span (multiple panels).\n    if (!id) {\n      warnDiagnostic(TOOL_PANEL_MISSING_ATTR, `Tool panel missing required id attribute: title=\"${title ?? ''}\"`);\n      return;\n    }\n\n    const icon = panelEl.getAttribute('icon') ?? undefined;\n    const tooltip = panelEl.getAttribute('tooltip') ?? undefined;\n    const order = parseInt(panelEl.getAttribute('order') ?? '100', 10);\n\n    // Try framework adapter first, then fall back to innerHTML\n    let render: (container: HTMLElement) => void | (() => void);\n\n    const adapterRenderer = rendererFactory?.(panelEl);\n    if (adapterRenderer) {\n      render = adapterRenderer;\n    } else {\n      // Vanilla fallback: use sanitized light-DOM markup as static content.\n      // Light DOM authored markup is generally trusted, but we sanitize\n      // defensively in case the panel content was server-rendered from data.\n      const rawContent = panelEl.innerHTML.trim();\n      render = (container: HTMLElement) => {\n        const wrapper = document.createElement('div');\n        setSanitizedHTML(wrapper, rawContent);\n        container.appendChild(wrapper);\n        return () => wrapper.remove();\n      };\n    }\n\n    // Check if panel was already parsed\n    const existingPanel = state.toolPanels.get(id);\n\n    // Precedence (#370): a panel contributed by a plugin (or registered via the\n    // grid API) owns its id. A light-DOM <tbw-grid-tool-panel> with the same id\n    // is ignored so the owner can rely on its own DOM existing. We detect a\n    // foreign owner by the id being present in toolPanels but NOT tracked as a\n    // light-DOM id (which would mean this is just a re-parse of our own panel).\n    if (existingPanel && !state.lightDomToolPanelIds.has(id)) {\n      warnDiagnostic(\n        TOOL_PANEL_DUPLICATE,\n        `Tool panel \"${id}\" is already provided by a plugin or the grid API; ignoring the matching light-DOM <tbw-grid-tool-panel>.`,\n      );\n      panelEl.style.display = 'none';\n      return;\n    }\n\n    // If already parsed and we have an adapter renderer, refresh the render\n    // function and (potentially) re-read attributes from DOM (Angular may have\n    // updated them after the initial parse). However, **only tear down the\n    // already-rendered panel content** when something the user can observe has\n    // actually changed:\n    //   - First time the adapter renderer attaches (we may have been using\n    //     the vanilla innerHTML fallback up to now)\n    //   - Any attribute the panel header renders from changed\n    //\n    // Otherwise the user's React/Vue/Angular component is already mounted in\n    // the panel and is happily managing its own state. A teardown here unmounts\n    // it (losing local state) and re-mounts it on next renderPanelContent —\n    // which, for a scrollable panel, resets `scrollTop` to 0. This was the\n    // cause of the \"tool panel scroll jumps to top on column visibility toggle\"\n    // bug: every `grid.gridConfig = …` setter in the adapter eventually calls\n    // back into parseLightDomToolPanels (via #applyGridConfigUpdate), and the\n    // previous unconditional `cleanup()` here threw away the user's component\n    // tree on every config sync.\n    if (existingPanel) {\n      if (adapterRenderer) {\n        const firstAdapterAttach = !state.adapterBoundToolPanelIds.has(id);\n        const attrsChanged =\n          existingPanel.title !== title ||\n          existingPanel.order !== order ||\n          existingPanel.icon !== icon ||\n          existingPanel.tooltip !== tooltip;\n\n        // Always keep the render function fresh — adapter renderers capture\n        // the current grid element / portal context and the most recent\n        // children, so a stale reference would render against an old closure.\n        existingPanel.render = render;\n        existingPanel.title = title;\n        existingPanel.order = order;\n        existingPanel.icon = icon;\n        existingPanel.tooltip = tooltip;\n        state.adapterBoundToolPanelIds.add(id);\n\n        if (firstAdapterAttach || attrsChanged) {\n          const cleanup = state.panelCleanups.get(id);\n          if (cleanup) {\n            cleanup();\n            state.panelCleanups.delete(id);\n          }\n        }\n      }\n      return;\n    }\n\n    // Register the tool panel\n    const panel: ToolPanelDefinition = {\n      id,\n      title,\n      icon,\n      tooltip,\n      order,\n      render,\n    };\n\n    state.toolPanels.set(id, panel);\n    state.lightDomToolPanelIds.add(id);\n    if (adapterRenderer) {\n      state.adapterBoundToolPanelIds.add(id);\n    }\n\n    // Hide the light DOM element\n    panelEl.style.display = 'none';\n  });\n}\n// #endregion\n\n// #region Event Handlers\n/**\n * Set up event listeners for shell toolbar buttons and accordion.\n */\nexport function setupShellEventListeners(\n  renderRoot: Element,\n  config: ShellConfig | undefined,\n  state: ShellState,\n  callbacks: {\n    onPanelToggle: () => void;\n    onSectionToggle: (sectionId: string) => void;\n    /** Invoked when the in-panel close (✕) button is clicked. */\n    onPanelClose?: () => void;\n  },\n): void {\n  const toolbar = renderRoot.querySelector('.tbw-shell-toolbar');\n  if (toolbar) {\n    toolbar.addEventListener('click', (e) => {\n      const target = e.target as HTMLElement;\n\n      // Handle single panel toggle button\n      const panelToggle = target.closest('[data-panel-toggle]') as HTMLElement | null;\n      if (panelToggle) {\n        callbacks.onPanelToggle();\n        return;\n      }\n    });\n  }\n\n  // In-panel close (✕) button — only present when the header bar is hidden.\n  const panel = renderRoot.querySelector('.tbw-tool-panel');\n  if (panel && callbacks.onPanelClose) {\n    panel.addEventListener('click', (e) => {\n      const target = e.target as HTMLElement;\n      if (target.closest('[data-panel-close]')) {\n        callbacks.onPanelClose!();\n      }\n    });\n  }\n\n  // Accordion header clicks\n  const accordion = renderRoot.querySelector('.tbw-accordion');\n  if (accordion) {\n    accordion.addEventListener('click', (e) => {\n      const target = e.target as HTMLElement;\n      const header = target.closest('.tbw-accordion-header') as HTMLElement | null;\n      if (header) {\n        const section = header.closest('[data-section]') as HTMLElement | null;\n        const sectionId = section?.getAttribute('data-section');\n        if (sectionId) {\n          callbacks.onSectionToggle(sectionId);\n        }\n      }\n    });\n  }\n}\n\n/**\n * Whether `node` belongs to `gridElement` — directly (light DOM) or via the\n * grid's shadow root (the node's root-node host is the grid). Used to scope\n * click-outside checks so one grid's listener never treats another grid's\n * toggle or panel as \"inside\" itself.\n */\nfunction isInGrid(node: Node, gridElement: Element): boolean {\n  if (gridElement.contains(node)) return true;\n  const root = node.getRootNode();\n  return root instanceof ShadowRoot && root.host === gridElement;\n}\n\n/**\n * Set up a click-outside listener that closes the tool panel when the user\n * clicks anywhere in the document outside the tool panel itself.\n *\n * Only active when `config.toolPanel.closeOnClickOutside` is `true` AND the\n * panel is open. The listener is added on `document` `mousedown` (not `click`)\n * so it fires before focus changes and catches clicks anywhere in the window —\n * including outside the grid. Uses `composedPath()` so clicks inside the\n * grid's shadow DOM are correctly attributed (shadow-retargeted `event.target`\n * would otherwise always be the host element).\n *\n * @returns A cleanup function that removes the listener.\n */\nexport function setupClickOutsideDismiss(\n  gridElement: Element,\n  config: ShellConfig | undefined,\n  state: ShellState,\n  onClose: () => void,\n): () => void {\n  const mode = config?.toolPanel?.mode;\n\n  // Dropdown popovers always light-dismiss on outside click (standard dropdown\n  // behavior), regardless of the `closeOnClickOutside` flag. Other modes only\n  // dismiss when the consumer opts in.\n  if (mode !== 'dropdown' && !config?.toolPanel?.closeOnClickOutside) {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  // In push mode the panel does not overlap grid content, so there is\n  // no meaningful \"outside\" to click against. Treat the option as a no-op.\n  if (mode === 'push') {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const handler = (e: Event) => {\n    if (!state.isPanelOpen) return;\n\n    // Ignore clicks inside the tool panel itself, on the toggle button, or on\n    // the dropdown's resolved anchor element (so a consumer's BYO trigger can\n    // toggle without the outside-click handler racing the button's own click).\n    // composedPath() pierces shadow boundaries so this works for both the\n    // light-DOM toggle and the shadow-DOM panel.\n    //\n    // CRITICAL: the panel/toggle match MUST be scoped to THIS grid via\n    // `isInGrid`. With multiple grids on one page, a click on another grid's\n    // toggle/panel is an \"outside\" click for us and must still dismiss \\u2014\n    // otherwise opening a dropdown in grid B leaves grid A's dropdown stuck\n    // open (#375 follow-up).\n    const anchorEl = state.dropdownAnchorEl;\n    for (const node of e.composedPath()) {\n      if (anchorEl != null && node === anchorEl) return;\n      if (\n        node instanceof Element &&\n        (node.classList?.contains('tbw-tool-panel') || node.matches?.('[data-panel-toggle]')) &&\n        isInGrid(node, gridElement)\n      ) {\n        return;\n      }\n    }\n\n    onClose();\n  };\n\n  document.addEventListener('mousedown', handler);\n  return () => document.removeEventListener('mousedown', handler);\n}\n\n/**\n * Set up an Escape-key listener that closes an open overlay tool panel.\n *\n * Active only in `overlay` mode (a push panel is a persistent sidebar, not a\n * transient overlay, so Esc does not dismiss it — the in-panel close button is\n * the affordance there). Yields to more specific handlers: if another listener\n * already called `preventDefault()` on the keydown (e.g. an active cell editor\n * cancelling an edit), the panel is left open.\n *\n * @returns A cleanup function that removes the listener.\n */\nexport function setupEscapeDismiss(\n  config: ShellConfig | undefined,\n  state: ShellState,\n  onClose: () => void,\n): () => void {\n  // Push panels are persistent — Esc only dismisses overlay panels.\n  if (config?.toolPanel?.mode === 'push') {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const handler = (e: KeyboardEvent) => {\n    if (e.key !== 'Escape' || e.defaultPrevented) return;\n    if (!state.isPanelOpen) return;\n    onClose();\n  };\n\n  document.addEventListener('keydown', handler);\n  return () => document.removeEventListener('keydown', handler);\n}\n\n/**\n * Set up resize handle for tool panel.\n * Returns a cleanup function to remove event listeners.\n *\n * The handle is draggable **and** tappable: pressing and releasing without\n * moving opens a click-only size menu (WCAG 2.2 SC 2.5.7).\n */\nexport function setupToolPanelResize(\n  renderRoot: Element,\n  config: ShellConfig | undefined,\n  onResize: (width: number) => void,\n): () => void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as HTMLElement | null;\n  const handle = renderRoot.querySelector('[data-resize-handle]') as HTMLElement | null;\n  const shellBody = renderRoot.querySelector('.tbw-shell-body') as HTMLElement | null;\n  if (!panel || !handle || !shellBody) {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const position = config?.toolPanel?.position ?? 'right';\n  const minWidth = 200;\n\n  let startX = 0;\n  let startWidth = 0;\n  let maxWidth = 0;\n  let isResizing = false;\n  let moved = false;\n  let cancelDrag: (() => void) | null = null;\n  let sizePopover: SizePopover<HTMLElement> | null = null;\n\n  const availableMax = () => shellBody.getBoundingClientRect().width - 20;\n\n  const openSizePopover = () => {\n    sizePopover ??= createSizePopover<HTMLElement>({\n      id: 'tbw-tool-panel-width-popover',\n      step: RESIZE_STEP_PX,\n      getSize: (el) => el.getBoundingClientRect().width,\n      // Same clamp as `onMove`, so no pointer path can reach a size the drag cannot.\n      setSize: (el, width) => {\n        const clamped = Math.min(availableMax(), Math.max(minWidth, width));\n        el.style.width = `${clamped}px`;\n        onResize(clamped);\n      },\n      reset: (el) => {\n        el.style.width = '';\n        onResize(el.getBoundingClientRect().width);\n      },\n      getLabel: () => 'Tool panel width',\n      getHost: (el) => el.closest<HTMLElement>('tbw-grid, [data-tbw-grid]'),\n    });\n    sizePopover.open(panel, handle);\n  };\n\n  const onMove = (e: PointerEvent) => {\n    if (!isResizing) return;\n    e.preventDefault();\n    moved = true;\n\n    // For right-positioned panel: dragging left (negative clientX change) should expand\n    // For left-positioned panel: dragging right (positive clientX change) should expand\n    const delta = position === 'left' ? e.clientX - startX : startX - e.clientX;\n    const newWidth = Math.min(maxWidth, Math.max(minWidth, startWidth + delta));\n\n    panel.style.width = `${newWidth}px`;\n  };\n\n  /**\n   * Restore chrome after a drag. `commit` is false when the drag was aborted\n   * (pointercancel / Escape), in which case the caller has already restored the\n   * original width and no `onResize` notification should fire.\n   */\n  const finish = (commit: boolean) => {\n    if (!isResizing) return;\n    isResizing = false;\n    cancelDrag = null;\n    handle.classList.remove('resizing');\n    panel.style.transition = ''; // Re-enable transition\n    document.body.style.cursor = '';\n    document.body.style.userSelect = '';\n\n    if (commit) {\n      // Get final width and notify\n      const finalWidth = panel.getBoundingClientRect().width;\n      onResize(finalWidth);\n    }\n  };\n\n  const onPointerDown = (e: PointerEvent) => {\n    if (isResizing) return;\n    // Only the primary mouse button starts a splitter drag — a right-click must\n    // keep its context menu rather than being preventDefault()-ed away.\n    if (e.button !== 0 && e.pointerType === 'mouse') return;\n    e.preventDefault();\n    isResizing = true;\n    moved = false;\n    startX = e.clientX;\n    startWidth = panel.getBoundingClientRect().width;\n    // Calculate max width dynamically based on grid container width\n    maxWidth = availableMax(); // Leave 20px margin\n    handle.classList.add('resizing');\n    panel.style.transition = 'none'; // Disable transition for smooth resize\n    document.body.style.cursor = 'col-resize';\n    document.body.style.userSelect = 'none';\n\n    cancelDrag = startPointerDrag(e, handle, {\n      onMove,\n      onEnd: () => {\n        // `startPointerDrag` promotes immediately, so tap-vs-drag can only be\n        // told apart by whether `onMove` ever ran.\n        const wasTap = !moved;\n        finish(!wasTap);\n        if (wasTap) openSizePopover();\n      },\n      onCancel: () => {\n        // Aborted (pointercancel / Escape) — snap back to the pre-drag width.\n        panel.style.width = `${startWidth}px`;\n        finish(false);\n      },\n    });\n  };\n\n  handle.addEventListener('pointerdown', onPointerDown);\n\n  // Return cleanup function\n  return () => {\n    handle.removeEventListener('pointerdown', onPointerDown);\n    cancelDrag?.();\n    cancelDrag = null;\n    sizePopover?.dispose();\n    sizePopover = null;\n  };\n}\n// #endregion\n\n// #region Content Rendering\n/**\n * Render toolbar content (render functions) into toolbar slots.\n * All contents (config + API + light DOM) are now unified.\n */\nexport function renderCustomToolbarContents(\n  renderRoot: Element,\n  config: ShellConfig | undefined,\n  state: ShellState,\n): void {\n  // Merge config contents with state contents (same logic as renderShellHeader)\n  const configContents = config?.header?.toolbarContents ?? [];\n  const stateContents = [...state.toolbarContents.values()];\n  const configIds = new Set(configContents.map((c) => c.id));\n  const allContents = [...configContents];\n  for (const content of stateContents) {\n    if (!configIds.has(content.id)) {\n      allContents.push(content);\n    }\n  }\n\n  // Only process contents that need rendering (have render and cleanup not already set)\n  for (const content of allContents) {\n    // Skip if already rendered (cleanup exists)\n    if (state.toolbarContentCleanups.has(content.id)) continue;\n    if (!content.render) continue;\n\n    const slot = renderRoot.querySelector(`[data-toolbar-content=\"${content.id}\"]`);\n    if (!slot) continue;\n\n    const cleanup = content.render(slot as HTMLElement);\n    if (cleanup) {\n      state.toolbarContentCleanups.set(content.id, cleanup);\n    }\n  }\n}\n\n/**\n * Render header content from plugins into the shell content area.\n * Also moves light DOM header content to the placeholder (once).\n */\nexport function renderHeaderContent(renderRoot: Element, state: ShellState): void {\n  // Early exit if nothing to do (most common path after initial render)\n  const hasLightDomContent = state.lightDomHeaderContent.length > 0 && !state.lightDomContentMoved;\n  const hasPluginContent = state.headerContents.size > 0;\n  if (!hasLightDomContent && !hasPluginContent) return;\n\n  const contentArea = renderRoot.querySelector('.tbw-shell-content');\n  if (!contentArea) return;\n\n  // Move light DOM header content to placeholder - only once (perf optimization)\n  if (hasLightDomContent) {\n    for (const el of state.lightDomHeaderContent) {\n      el.style.display = ''; // Show it (was hidden in the original container)\n      contentArea.appendChild(el);\n    }\n    state.lightDomContentMoved = true;\n  }\n\n  // Sort by order\n  const sortedContents = [...state.headerContents.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n\n  for (const content of sortedContents) {\n    // Clean up previous render if any\n    const existingCleanup = state.headerContentCleanups.get(content.id);\n    if (existingCleanup) {\n      existingCleanup();\n      state.headerContentCleanups.delete(content.id);\n    }\n\n    // Check if container already exists\n    let container = contentArea.querySelector(`[data-header-content=\"${content.id}\"]`) as HTMLElement | null;\n    if (!container) {\n      container = document.createElement('div');\n      container.setAttribute('data-header-content', content.id);\n      contentArea.appendChild(container);\n    }\n\n    const cleanup = content.render(container);\n    if (cleanup) {\n      state.headerContentCleanups.set(content.id, cleanup);\n    }\n  }\n}\n\n/**\n * Render content for expanded accordion sections.\n * @param icons - Optional icons for expand/collapse chevrons (from grid config)\n */\nexport function renderPanelContent(\n  renderRoot: Element,\n  state: ShellState,\n  _icons?: { expand?: IconValue; collapse?: IconValue },\n): void {\n  if (!state.isPanelOpen) return;\n\n  for (const [panelId, panel] of state.toolPanels) {\n    const isExpanded = state.expandedSections.has(panelId);\n    const section = renderRoot.querySelector(`[data-section=\"${panelId}\"]`);\n    const contentArea = section?.querySelector('.tbw-accordion-content') as HTMLElement | null;\n\n    if (!section || !contentArea) continue;\n\n    // Update expanded state\n    section.classList.toggle('expanded', isExpanded);\n    const header = section.querySelector('.tbw-accordion-header');\n    if (header) {\n      header.setAttribute('aria-expanded', String(isExpanded));\n    }\n    // Don't swap chevron icon — CSS rotation handles expanded/collapsed state\n\n    if (isExpanded) {\n      // Check if content is already rendered\n      if (contentArea.children.length === 0) {\n        // Render panel content\n        const cleanup = panel.render(contentArea);\n        if (cleanup) {\n          state.panelCleanups.set(panelId, cleanup);\n        }\n      }\n    } else {\n      // Clean up and clear content when collapsed\n      const cleanup = state.panelCleanups.get(panelId);\n      if (cleanup) {\n        cleanup();\n        state.panelCleanups.delete(panelId);\n      }\n      contentArea.innerHTML = '';\n    }\n  }\n}\n\n/**\n * Update toolbar button active states.\n */\nexport function updateToolbarActiveStates(renderRoot: Element, state: ShellState): void {\n  // Update single panel toggle button\n  const panelToggle = renderRoot.querySelector('[data-panel-toggle]');\n  if (panelToggle) {\n    panelToggle.classList.toggle('active', state.isPanelOpen);\n    panelToggle.setAttribute('aria-pressed', String(state.isPanelOpen));\n  }\n}\n\n/**\n * Update tool panel open/close state.\n */\nexport function updatePanelState(renderRoot: Element, state: ShellState): void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as HTMLElement | null;\n  if (!panel) return;\n\n  panel.classList.toggle('open', state.isPanelOpen);\n\n  // Clear inline width when closing (resize sets inline style that overrides CSS)\n  if (!state.isPanelOpen) {\n    panel.style.width = '';\n  }\n}\n\n/** Base CSS anchor name used to feature-detect CSS anchor positioning support. */\nconst DROPDOWN_ANCHOR_NAME = '--tbw-tool-panel-anchor';\n\n/**\n * Monotonic counter for minting unique per-grid dropdown anchor names. A shared\n * constant name collides when two grids on the same page each open a dropdown,\n * pairing one grid's popover with the other grid's trigger (#375 follow-up).\n */\nlet dropdownAnchorSeq = 0;\n\n/** Whether the current environment supports CSS anchor positioning. */\nexport function supportsAnchorPositioning(): boolean {\n  return (\n    typeof CSS !== 'undefined' &&\n    typeof CSS.supports === 'function' &&\n    CSS.supports('anchor-name', DROPDOWN_ANCHOR_NAME)\n  );\n}\n\n/**\n * Position the dropdown popover with fixed coordinates derived from the\n * anchor's bounding rect. Used only when CSS anchor positioning is\n * unsupported; otherwise placement is driven entirely by `shell.css`.\n */\nfunction positionDropdownFallback(panel: HTMLElement, anchorEl: HTMLElement, corner: boolean): void {\n  const rect = anchorEl.getBoundingClientRect();\n  const position = panel.getAttribute('data-position') ?? 'right';\n  panel.style.position = 'fixed';\n  // `corner` anchors to the top of the grid (top corner); otherwise drop below\n  // the trigger button.\n  panel.style.top = `${Math.round((corner ? rect.top : rect.bottom) + 4)}px`;\n  if (position === 'left') {\n    panel.style.left = `${Math.round(rect.left)}px`;\n    panel.style.right = 'auto';\n  } else {\n    const viewportWidth = typeof window !== 'undefined' ? window.innerWidth : 0;\n    panel.style.left = 'auto';\n    panel.style.right = `${Math.round(viewportWidth - rect.right)}px`;\n  }\n}\n\n/**\n * Show the tool panel as an anchored dropdown popover (`mode: 'dropdown'`).\n *\n * Reuses the existing `.tbw-tool-panel` aside (the full accordion) and shows it\n * in the top layer via the native Popover API. Placement is handled by CSS\n * anchor positioning when supported, with a JS bounding-rect fallback otherwise.\n *\n * @param anchorEl - Element the popover anchors to.\n * @param corner - When `true`, anchor to the top corner of `anchorEl` (grid\n *   corner fallback); otherwise drop directly below it (toggle / custom button).\n */\nexport function showToolPanelDropdown(\n  renderRoot: Element,\n  state: ShellState,\n  anchorEl: HTMLElement,\n  corner: boolean,\n): void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as (HTMLElement & { showPopover?: () => void }) | null;\n  if (!panel) return;\n\n  state.dropdownAnchorEl = anchorEl;\n  panel.dataset.anchor = corner ? 'corner' : 'below';\n\n  // Show in the top layer. Guard for environments (older browsers / test DOM)\n  // without the native Popover API.\n  if (panel.hasAttribute('popover') && typeof panel.showPopover === 'function') {\n    try {\n      panel.showPopover();\n    } catch {\n      // Already open or not connected — ignore.\n    }\n  }\n\n  if (supportsAnchorPositioning()) {\n    // CSS drives placement; just wire up the anchor-name pairing. Mint a unique\n    // name per show so multiple grids (or repeated opens) on one page never\n    // collide on a shared anchor name — a collision positions this popover\n    // against another grid's trigger instead of its own.\n    const anchorName = `${DROPDOWN_ANCHOR_NAME}-${++dropdownAnchorSeq}`;\n    state.dropdownAnchorName = anchorName;\n    anchorEl.style.setProperty('anchor-name', anchorName);\n    panel.style.setProperty('position-anchor', anchorName);\n    panel.style.removeProperty('top');\n    panel.style.removeProperty('left');\n    panel.style.removeProperty('right');\n  } else {\n    positionDropdownFallback(panel, anchorEl, corner);\n  }\n}\n\n/**\n * Hide the dropdown popover and clear all anchor wiring set by\n * {@link showToolPanelDropdown}.\n */\nexport function hideToolPanelDropdown(renderRoot: Element, state: ShellState): void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as (HTMLElement & { hidePopover?: () => void }) | null;\n  if (panel) {\n    if (panel.hasAttribute('popover') && typeof panel.hidePopover === 'function') {\n      try {\n        panel.hidePopover();\n      } catch {\n        // Not currently open — ignore.\n      }\n    }\n    panel.style.removeProperty('position-anchor');\n    panel.style.removeProperty('position');\n    panel.style.removeProperty('top');\n    panel.style.removeProperty('left');\n    panel.style.removeProperty('right');\n    delete panel.dataset.anchor;\n  }\n  if (state.dropdownAnchorEl) {\n    state.dropdownAnchorEl.style.removeProperty('anchor-name');\n    state.dropdownAnchorEl = null;\n  }\n  state.dropdownAnchorName = null;\n}\n\n/**\n * Re-pair an OPEN dropdown's existing anchor onto a freshly resolved trigger\n * IN PLACE — reusing the already-minted `anchor-name` and leaving the popover\n * shown — instead of hiding and re-showing it.\n *\n * WHY: when an outer framework (e.g. a React column `headerRenderer`) recreates\n * the `[data-panel-toggle]` trigger on a column toggle, the new node lacks the\n * `anchor-name`, so the popover's `position-anchor` no longer resolves and the\n * browser drops it to the corner. Hiding + re-showing (the heavier\n * {@link showToolPanelDropdown} path) mints a NEW name and re-enters the\n * Popover API, which flashes the popover to the corner for a frame. Moving the\n * SAME name to the new node keeps the popover visually anchored with no flash.\n *\n * Returns `true` when the re-pair was applied. The caller must ensure CSS\n * anchor positioning is supported (see {@link supportsAnchorPositioning});\n * otherwise the fixed-coordinate fallback in {@link showToolPanelDropdown} must\n * be used instead.\n */\nexport function repairDropdownAnchor(renderRoot: Element, state: ShellState, trigger: HTMLElement): boolean {\n  const anchorName = state.dropdownAnchorName;\n  if (!anchorName) return false;\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as (HTMLElement & { showPopover?: () => void }) | null;\n  if (!panel) return false;\n  const prev = state.dropdownAnchorEl;\n  if (prev && prev !== trigger) prev.style.removeProperty('anchor-name');\n  trigger.style.setProperty('anchor-name', anchorName);\n  panel.style.setProperty('position-anchor', anchorName);\n  panel.style.removeProperty('top');\n  panel.style.removeProperty('left');\n  panel.style.removeProperty('right');\n  panel.dataset.anchor = 'below';\n  state.dropdownAnchorEl = trigger;\n  // A structural rebuild (`rebuildShellDOM`) creates a FRESH `.tbw-tool-panel`\n  // that is not in the top layer — only its `.open` class arm renders it, which\n  // can be clipped / mis-stacked. Re-assert the popover idempotently so both the\n  // non-structural path (panel already open → no-op via the catch) and the\n  // structural-rebuild path (fresh panel → shown) end up in the top layer.\n  if (panel.hasAttribute('popover') && typeof panel.showPopover === 'function') {\n    try {\n      panel.showPopover();\n    } catch {\n      // Already open or not connected — ignore.\n    }\n  }\n  return true;\n}\n\n/**\n * Prepare shell state for a full re-render.\n * Runs cleanup functions so content (toolbar buttons, panels, headers)\n * can be restored to their original containers and re-rendered into new DOM.\n */\nexport function prepareForRerender(state: ShellState): void {\n  // Run cleanups for toolbar contents (moves elements back to original containers)\n  for (const cleanup of state.toolbarContentCleanups.values()) {\n    cleanup();\n  }\n  state.toolbarContentCleanups.clear();\n\n  // Run cleanups for panel contents (old DOM will be destroyed)\n  for (const cleanup of state.panelCleanups.values()) {\n    cleanup();\n  }\n  state.panelCleanups.clear();\n\n  // Run cleanups for header contents (old DOM will be destroyed)\n  for (const cleanup of state.headerContentCleanups.values()) {\n    cleanup();\n  }\n  state.headerContentCleanups.clear();\n\n  // Allow light DOM content to be re-moved into new DOM\n  state.lightDomContentMoved = false;\n}\n\n/**\n * Cleanup all shell state when grid disconnects.\n */\nexport function cleanupShellState(state: ShellState): void {\n  // Clean up header content\n  for (const cleanup of state.headerContentCleanups.values()) {\n    cleanup();\n  }\n  state.headerContentCleanups.clear();\n\n  // Clean up panel content\n  for (const cleanup of state.panelCleanups.values()) {\n    cleanup();\n  }\n  state.panelCleanups.clear();\n\n  // Clean up toolbar contents\n  for (const cleanup of state.toolbarContentCleanups.values()) {\n    cleanup();\n  }\n  state.toolbarContentCleanups.clear();\n\n  // Call onDestroy for all toolbar contents\n  for (const content of state.toolbarContents.values()) {\n    content.onDestroy?.();\n  }\n\n  // Invoke onClose for all open panels\n  if (state.isPanelOpen) {\n    for (const sectionId of state.expandedSections) {\n      const panel = state.toolPanels.get(sectionId);\n      panel?.onClose?.();\n    }\n  }\n\n  // Reset panel state\n  state.isPanelOpen = false;\n  state.expandedSections.clear();\n\n  // Clear registrations\n  state.toolPanels.clear();\n  state.headerContents.clear();\n  state.toolbarContents.clear();\n  state.lightDomHeaderContent = [];\n\n  // Clear light DOM tracking sets (allow re-parsing)\n  state.lightDomToolPanelIds.clear();\n  state.adapterBoundToolPanelIds.clear();\n  state.lightDomToolbarContentIds.clear();\n\n  // Reset move tracking flag (allow re-initialization)\n  state.lightDomContentMoved = false;\n}\n// #endregion\n\n// #region DOM Construction\nimport { GridClasses } from '../../core/constants';\nimport {\n  buildGridDOM,\n  buildShellBody,\n  buildShellHeader,\n  type ShellBodyOptions,\n  type ShellHeaderOptions,\n} from '../../core/internal/dom-builder';\n\n/**\n * Build ShellHeaderOptions and ShellBodyOptions from shell config and runtime state.\n * Shared by buildGridDOMIntoElement and rebuildShellDOM to avoid duplication.\n */\nfunction buildShellOptions(\n  shellConfig: ShellConfig,\n  runtimeState: { isPanelOpen: boolean; expandedSections: Set<string> },\n  icons?: { toolPanel?: IconValue; expand?: IconValue; collapse?: IconValue },\n): { headerOptions: ShellHeaderOptions; bodyOptions: ShellBodyOptions } {\n  const toolPanelIcon = icons?.toolPanel !== undefined ? iconToString(icons.toolPanel) : undefined;\n  const expandIcon = icons?.expand !== undefined ? iconToString(icons.expand) : undefined;\n  const collapseIcon = icons?.collapse !== undefined ? iconToString(icons.collapse) : undefined;\n\n  const allContents = shellConfig.header?.toolbarContents ?? [];\n  const sortedContents = [...allContents].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n\n  const allPanels = shellConfig.toolPanels ?? [];\n  const sortedPanels = [...allPanels].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n\n  return {\n    headerOptions: {\n      title: shellConfig.header?.title ?? undefined,\n      hasPanels: sortedPanels.length > 0,\n      isPanelOpen: runtimeState.isPanelOpen,\n      toolPanelIcon,\n      showToggle: shellConfig.header?.toolPanelToggle !== false && shellConfig.toolPanel?.locked !== true,\n      configButtons: sortedContents.map((c) => ({\n        id: c.id,\n        hasElement: false,\n        hasRender: !!c.render,\n      })),\n      apiButtons: [],\n    },\n    bodyOptions: {\n      position: shellConfig.toolPanel?.position ?? 'right',\n      mode: shellConfig.toolPanel?.mode ?? 'overlay',\n      isPanelOpen: runtimeState.isPanelOpen,\n      expandIcon,\n      collapseIcon,\n      // Render an in-panel close (✕) button when the header bar is hidden, so\n      // the panel can be dismissed without the (absent) built-in toggle. A\n      // locked panel cannot be closed, so no button in that case. Dropdown mode\n      // is excluded: the popover light-dismisses on Esc / click-outside, so a\n      // ✕ would be redundant clutter.\n      showCloseButton:\n        shellConfig.header?.visible === false &&\n        shellConfig.toolPanel?.locked !== true &&\n        (shellConfig.toolPanel?.mode ?? 'overlay') !== 'dropdown',\n      panels: sortedPanels.map((p) => ({\n        id: p.id,\n        title: p.title,\n        icon: iconToString(p.icon),\n        isExpanded: runtimeState.expandedSections.has(p.id),\n      })),\n    },\n  };\n}\n\n/**\n * Build the complete grid DOM structure using direct DOM construction.\n * This is 2-3x faster than innerHTML for initial render.\n *\n * @param renderRoot - The element to render into (will be cleared)\n * @param shellConfig - Shell configuration\n * @param runtimeState - Runtime shell state\n * @param icons - Optional icons\n * @returns Whether shell is active (for post-render setup)\n */\nexport function buildGridDOMIntoElement(\n  renderRoot: Element,\n  shellConfig: ShellConfig | undefined,\n  runtimeState: { isPanelOpen: boolean; expandedSections: Set<string> },\n  icons?: { toolPanel?: IconValue; expand?: IconValue; collapse?: IconValue },\n): boolean {\n  const hasShell = shouldRenderShellHeader(shellConfig);\n\n  // Preserve all direct child nodes EXCEPT the grid's own `.tbw-grid-root`\n  // (which we are about to rebuild). This keeps user/framework light-DOM\n  // intact in its original order — including non-element nodes like comment\n  // anchors that Angular's `@if`/`@for` and other structural directives use\n  // as positional markers. Filtering by element-tag selectors would discard\n  // those anchors and break re-renders of the conditional content.\n  const preservedNodes: Node[] = [];\n  for (let n: Node | null = renderRoot.firstChild; n; n = n.nextSibling) {\n    if (n.nodeType === 1 && (n as Element).classList.contains(GridClasses.ROOT)) continue;\n    preservedNodes.push(n);\n  }\n\n  // Clear existing content (this would delete light DOM nodes, so we preserved them first)\n  renderRoot.replaceChildren();\n\n  // Re-append preserved nodes in original order (hidden elements are used for config).\n  // IMPORTANT: These are prepended before .tbw-grid-root, so `renderRoot.children[0]`\n  // is NOT the grid root. Use `querySelector('.tbw-grid-root')` instead.\n  for (const n of preservedNodes) {\n    renderRoot.appendChild(n);\n  }\n\n  if (hasShell) {\n    const { headerOptions, bodyOptions } = buildShellOptions(shellConfig!, runtimeState, icons);\n    const shellHeader = shouldRenderHeaderBar(shellConfig) ? buildShellHeader(headerOptions) : undefined;\n    const shellBody = buildShellBody(bodyOptions);\n\n    const fragment = buildGridDOM({\n      hasShell: true,\n      shellHeader,\n      shellBody,\n    });\n    renderRoot.appendChild(fragment);\n  } else {\n    const fragment = buildGridDOM({ hasShell: false });\n    renderRoot.appendChild(fragment);\n  }\n\n  return hasShell;\n}\n\n/**\n * Surgically rebuild only the shell wrapper (header + tool panel) while\n * preserving the existing `.tbw-grid-root` element and its `.tbw-grid-content`\n * child with all descendants and event listeners intact.\n *\n * This avoids the full `replaceChildren()` nuke that `buildGridDOMIntoElement`\n * performs, so event listeners bound to `.tbw-grid-root` or its grid content\n * descendants (e.g. tooltip's delegated mouseover) remain intact.\n *\n * If no existing `.tbw-grid-root` is found (first render), falls back to\n * `buildGridDOMIntoElement` for a full rebuild.\n */\nexport function rebuildShellDOM(\n  renderRoot: Element,\n  shellConfig: ShellConfig | undefined,\n  runtimeState: { isPanelOpen: boolean; expandedSections: Set<string> },\n  icons?: { toolPanel?: IconValue; expand?: IconValue; collapse?: IconValue },\n): boolean {\n  // Find the existing grid root and content to preserve\n  const existingRoot = renderRoot.querySelector(`.${GridClasses.ROOT}`) as HTMLElement | null;\n  const existingContent = existingRoot?.querySelector('.tbw-grid-content');\n\n  // If there's no existing root, fall back to full rebuild (first render)\n  if (!existingRoot || !existingContent) {\n    return buildGridDOMIntoElement(renderRoot, shellConfig, runtimeState, icons);\n  }\n\n  // Detach grid content so it survives the child replacement\n  existingContent.remove();\n\n  const hasShell = shouldRenderShellHeader(shellConfig);\n\n  // Clear the root's children (shell header, shell body, etc.) but keep the root element itself\n  existingRoot.replaceChildren();\n\n  if (hasShell) {\n    existingRoot.className = `${GridClasses.ROOT} has-shell`;\n\n    const { headerOptions, bodyOptions } = buildShellOptions(shellConfig!, runtimeState, icons);\n    const shellHeader = shouldRenderHeaderBar(shellConfig) ? buildShellHeader(headerOptions) : undefined;\n    const shellBody = buildShellBody(bodyOptions);\n\n    // Replace the freshly cloned grid content with the preserved one\n    const freshContent = shellBody.querySelector('.tbw-grid-content');\n    if (freshContent) {\n      freshContent.replaceWith(existingContent);\n    }\n\n    if (shellHeader) existingRoot.appendChild(shellHeader);\n    existingRoot.appendChild(shellBody);\n  } else {\n    // No shell — place content directly in root\n    existingRoot.className = GridClasses.ROOT;\n    existingRoot.appendChild(existingContent);\n  }\n\n  return hasShell;\n}\n// #endregion\n","/**\n * Shell Controller - Tool panel and header content orchestration.\n *\n * Extracted from shell.ts to isolate the stateful controller logic\n * from the rendering/parsing infrastructure.\n *\n * The ShellController manages:\n * - Tool panel open/close/toggle state\n * - Accordion section expand/collapse\n * - Registration of tool panels, header content, and toolbar content\n */\n\nimport {\n  HEADER_CONTENT_DUPLICATE,\n  NO_TOOL_PANELS,\n  TOOL_PANEL_DUPLICATE,\n  TOOL_PANEL_NOT_FOUND,\n  TOOLBAR_CONTENT_DUPLICATE,\n  warnDiagnostic,\n} from '../../core/internal/diagnostics';\nimport type { GridElement } from '../../core/plugin/base-plugin';\nimport type { InternalGrid } from '../../core/types';\nimport {\n  hideToolPanelDropdown,\n  renderHeaderContent,\n  renderPanelContent,\n  repairDropdownAnchor,\n  showToolPanelDropdown,\n  supportsAnchorPositioning,\n  updatePanelState,\n  updateToolbarActiveStates,\n  type ShellState,\n} from './shell';\nimport type {\n  HeaderContentDefinition,\n  OpenToolPanelOptions,\n  ToolbarContentDefinition,\n  ToolPanelDefinition,\n} from './types';\n\n// #region ShellController\n/**\n * Controller interface for managing shell/tool panel behavior.\n */\nexport interface ShellController {\n  /** Whether the shell has been initialized */\n  readonly isInitialized: boolean;\n  /** Set the initialized state */\n  setInitialized(value: boolean): void;\n  /** Whether the tool panel is currently open */\n  readonly isPanelOpen: boolean;\n  /** Get IDs of expanded accordion sections */\n  readonly expandedSections: string[];\n  /**\n   * Open the tool panel.\n   * @param panelId - Optional ID of the section to expand on open. When provided,\n   *   takes precedence over `shell.toolPanel.defaultOpen`. If the panel is already\n   *   open with a different section expanded, switches to the requested section.\n   *   If the panel ID is not registered, a `TBW072` warning is emitted and the\n   *   call falls back to default behavior (auto-expand `defaultOpen` or first by order).\n   * @param options - Optional open options. In `mode: 'dropdown'`, `options.anchor`\n   *   sets the element the popover anchors to (see {@link OpenToolPanelOptions}).\n   */\n  openToolPanel(panelId?: string, options?: OpenToolPanelOptions): void;\n  /** Close the tool panel */\n  closeToolPanel(): void;\n  /**\n   * Toggle the tool panel.\n   * @param options - Optional open options forwarded to {@link openToolPanel}\n   *   when the panel is currently closed (e.g. `anchor` for dropdown mode).\n   */\n  toggleToolPanel(options?: OpenToolPanelOptions): void;\n  /**\n   * Re-pair an open dropdown popover onto its (possibly recreated) trigger\n   * after a re-render (`mode: 'dropdown'` only). A column toggle / reorder may\n   * recreate the custom column-header button the popover was anchored to,\n   * leaving the popover's `position-anchor` dangling so the browser drops it to\n   * the corner.\n   *\n   * Behaviour:\n   * - intact pairing → no-op (cheap fast-path, safe to call every render);\n   * - a live `[data-panel-toggle]` exists → re-pair the existing anchor onto it\n   *   IN PLACE (no popover re-show → no flash), or a fixed-coord re-show when\n   *   CSS anchor positioning is unavailable;\n   * - corner-origin dropdown with no trigger → keep it pinned to the corner;\n   * - trigger-origin dropdown whose trigger is transiently absent → leave the\n   *   popover at its last position (the shell's MutationObserver re-pairs it\n   *   before paint once the trigger reappears), rather than flashing to corner.\n   *\n   * No-op when the panel is closed or the mode is not `'dropdown'`.\n   */\n  reanchorOpenDropdown(): void;\n  /** Toggle an accordion section */\n  toggleToolPanelSection(sectionId: string): void;\n  /** Get registered tool panels */\n  getToolPanels(): ToolPanelDefinition[];\n  /** Register a tool panel */\n  registerToolPanel(panel: ToolPanelDefinition): void;\n  /** Unregister a tool panel */\n  unregisterToolPanel(panelId: string): void;\n  /** Get registered header contents */\n  getHeaderContents(): HeaderContentDefinition[];\n  /** Register header content */\n  registerHeaderContent(content: HeaderContentDefinition): void;\n  /** Unregister header content */\n  unregisterHeaderContent(contentId: string): void;\n  /** Get all registered toolbar contents */\n  getToolbarContents(): ToolbarContentDefinition[];\n  /** Register toolbar content */\n  registerToolbarContent(content: ToolbarContentDefinition): void;\n  /** Unregister toolbar content */\n  unregisterToolbarContent(contentId: string): void;\n}\n\n/**\n * The slice of the grid the shell controller needs: the plugin-facing\n * {@link GridElement} surface plus a few internal seams (`id`, `_emit`,\n * `_accordionIcons`, optional `refreshShellHeader`). Declaring it as\n * `GridElement & Pick<InternalGrid, …>` lets the {@link ShellPlugin} pass its\n * `GridElement`-typed `grid` with a plain downcast — no `as unknown as` — while\n * keeping core free of any shell-specific grid surface (extraction #370).\n */\nexport type ShellControllerGrid = GridElement &\n  Pick<InternalGrid, 'id' | '_emit' | '_accordionIcons' | 'refreshShellHeader'>;\n\n/**\n * Create a ShellController instance.\n * The controller encapsulates all tool panel orchestration logic.\n */\nexport function createShellController(state: ShellState, grid: ShellControllerGrid): ShellController {\n  let initialized = false;\n\n  /**\n   * Resolve the element a dropdown popover should anchor to. Priority:\n   * explicit `anchor` option → built-in toolbar toggle button → grid host\n   * corner fallback.\n   */\n  function resolveDropdownAnchor(explicit?: HTMLElement): { el: HTMLElement; corner: boolean } {\n    if (explicit) return { el: explicit, corner: false };\n    const toggle = grid._renderRoot.querySelector('[data-panel-toggle]') as HTMLElement | null;\n    if (toggle) return { el: toggle, corner: false };\n    return { el: grid._hostElement, corner: true };\n  }\n\n  const controller: ShellController = {\n    get isInitialized() {\n      return initialized;\n    },\n    setInitialized(value: boolean) {\n      initialized = value;\n    },\n\n    get isPanelOpen() {\n      return state.isPanelOpen;\n    },\n\n    get expandedSections() {\n      return [...state.expandedSections];\n    },\n\n    openToolPanel(panelId?: string, options?: OpenToolPanelOptions) {\n      if (state.toolPanels.size === 0) {\n        warnDiagnostic(NO_TOOL_PANELS, 'No tool panels registered', grid.id);\n        return;\n      }\n\n      // Validate explicit panelId; on unknown id, warn and fall back to default behavior.\n      let targetSectionId: string | undefined;\n      if (panelId !== undefined) {\n        if (state.toolPanels.has(panelId)) {\n          targetSectionId = panelId;\n        } else {\n          warnDiagnostic(TOOL_PANEL_NOT_FOUND, `Tool panel \"${panelId}\" not found`, grid.id);\n        }\n      }\n\n      // Fast path: panel already open and requested section already expanded → no-op.\n      if (state.isPanelOpen && targetSectionId && state.expandedSections.has(targetSectionId)) {\n        return;\n      }\n\n      // Panel already open but a different section is expanded → switch sections\n      // (delegate to toggleToolPanelSection for accordion exclusivity + event emission).\n      if (state.isPanelOpen && targetSectionId && !state.expandedSections.has(targetSectionId)) {\n        controller.toggleToolPanelSection(targetSectionId);\n        return;\n      }\n\n      if (state.isPanelOpen) return;\n\n      state.isPanelOpen = true;\n\n      // Decide initial expanded section:\n      // 1. Explicit panelId argument (already validated above).\n      // 2. shell.toolPanel.defaultOpen if it matches a registered panel.\n      // 3. First panel by `order`.\n      if (state.expandedSections.size === 0 && state.toolPanels.size > 0) {\n        if (targetSectionId) {\n          state.expandedSections.add(targetSectionId);\n        } else {\n          const defaultOpenId = grid.effectiveConfig?.shell?.toolPanel?.defaultOpen;\n          if (defaultOpenId && state.toolPanels.has(defaultOpenId)) {\n            state.expandedSections.add(defaultOpenId);\n          } else {\n            const sortedPanels = [...state.toolPanels.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n            const firstPanel = sortedPanels[0];\n            if (firstPanel) {\n              state.expandedSections.add(firstPanel.id);\n            }\n          }\n        }\n      } else if (targetSectionId && !state.expandedSections.has(targetSectionId)) {\n        // Some other section was already pre-expanded (e.g. via config); switch to requested.\n        for (const id of [...state.expandedSections]) {\n          state.expandedSections.delete(id);\n        }\n        state.expandedSections.add(targetSectionId);\n      }\n\n      // Update UI\n      const shadow = grid._renderRoot;\n      updateToolbarActiveStates(shadow, state);\n      updatePanelState(shadow, state);\n\n      // Render accordion sections\n      renderPanelContent(shadow, state, grid._accordionIcons);\n\n      // In dropdown mode, show the panel as an anchored popover in the top layer.\n      if (grid.effectiveConfig?.shell?.toolPanel?.mode === 'dropdown') {\n        const { el, corner } = resolveDropdownAnchor(options?.anchor);\n        showToolPanelDropdown(shadow, state, el, corner);\n      }\n\n      // Emit event\n      grid._emit('tool-panel-open', { sections: controller.expandedSections });\n    },\n\n    closeToolPanel() {\n      if (!state.isPanelOpen) return;\n      // When the tool panel is locked open, programmatic and user close\n      // requests become no-ops. Accordion sections can still toggle.\n      if (grid.effectiveConfig?.shell?.toolPanel?.locked) return;\n\n      // Clean up all panel content\n      for (const cleanup of state.panelCleanups.values()) {\n        cleanup();\n      }\n      state.panelCleanups.clear();\n\n      // Call onClose for all panels\n      for (const panel of state.toolPanels.values()) {\n        panel.onClose?.();\n      }\n\n      state.isPanelOpen = false;\n\n      // Update UI\n      const shadow = grid._renderRoot;\n      updateToolbarActiveStates(shadow, state);\n      updatePanelState(shadow, state);\n\n      // In dropdown mode, hide the popover and clear anchor wiring.\n      if (grid.effectiveConfig?.shell?.toolPanel?.mode === 'dropdown') {\n        hideToolPanelDropdown(shadow, state);\n      }\n\n      // Emit event\n      grid._emit('tool-panel-close', {});\n    },\n\n    toggleToolPanel(options?: OpenToolPanelOptions) {\n      if (state.isPanelOpen) {\n        controller.closeToolPanel();\n      } else {\n        controller.openToolPanel(undefined, options);\n      }\n    },\n\n    reanchorOpenDropdown() {\n      if (!state.isPanelOpen) return;\n      if (grid.effectiveConfig?.shell?.toolPanel?.mode !== 'dropdown') return;\n      const stored = state.dropdownAnchorEl;\n      // Idempotent fast-path: the anchor element is still connected AND still\n      // carries the minted `anchor-name`, so the pairing is intact — nothing to\n      // do. This keeps the hook cheap when it runs on the `afterRender` path\n      // (which fires on every render, e.g. a column toggle), only doing real\n      // work when the trigger was actually recreated/detached.\n      if (\n        stored &&\n        stored.isConnected &&\n        state.dropdownAnchorName &&\n        stored.style.getPropertyValue('anchor-name') === state.dropdownAnchorName\n      ) {\n        return;\n      }\n      // Idempotent fast-path (fixed-coordinate fallback mode — CSS anchor\n      // positioning unsupported, so `dropdownAnchorName` is never minted). Here\n      // re-anchoring means a `getBoundingClientRect()` + re-show on every\n      // render/mutation, which is wasteful when nothing was recreated. Skip when\n      // the stored trigger is still the SAME connected node (not the corner\n      // anchor) AND the CURRENT panel was already positioned (`data-anchor` set).\n      // A structural rebuild produces a FRESH `.tbw-tool-panel` with no\n      // `data-anchor`, so this never short-circuits the case that still needs a\n      // re-show.\n      if (!state.dropdownAnchorName && stored && stored.isConnected && stored !== grid._hostElement) {\n        const panel = grid._renderRoot.querySelector('.tbw-tool-panel') as HTMLElement | null;\n        if (panel?.dataset.anchor === 'below') return;\n      }\n      // Re-pair to a LIVE custom trigger (`[data-panel-toggle]`) whenever one\n      // exists. Prefer the cheap in-place repair: it reuses the already-minted\n      // `anchor-name`, keeps the popover shown, and never re-enters the Popover\n      // API — so the popover stays visually anchored with NO flash. Falls back\n      // to a fixed-coordinate re-show only when CSS anchor positioning is\n      // unavailable.\n      const fresh = grid._renderRoot.querySelector('[data-panel-toggle]') as HTMLElement | null;\n      if (fresh && fresh !== grid._hostElement) {\n        if (\n          state.dropdownAnchorName &&\n          supportsAnchorPositioning() &&\n          repairDropdownAnchor(grid._renderRoot, state, fresh)\n        ) {\n          return;\n        }\n        showToolPanelDropdown(grid._renderRoot, state, fresh, false);\n        return;\n      }\n      // No live trigger.\n      if (stored === grid._hostElement) {\n        // Corner-origin dropdown (opened without a custom trigger): keep it\n        // pinned to the grid corner across re-renders.\n        showToolPanelDropdown(grid._renderRoot, state, grid._hostElement, true);\n        return;\n      }\n      // Trigger-origin dropdown whose trigger is transiently absent (an outer\n      // framework, e.g. React, recreates it on a separate commit) — or was\n      // permanently removed. Do NOT flash the popover to the corner: leave it\n      // at its last position. When the trigger reappears, the shell's\n      // MutationObserver re-pairs it before paint (see ShellPlugin).\n    },\n\n    toggleToolPanelSection(sectionId: string) {\n      const panel = state.toolPanels.get(sectionId);\n      if (!panel) {\n        warnDiagnostic(TOOL_PANEL_NOT_FOUND, `Tool panel section \"${sectionId}\" not found`, grid.id);\n        return;\n      }\n\n      // Don't allow toggling when there's only one panel (it should stay expanded)\n      if (state.toolPanels.size === 1) {\n        return;\n      }\n\n      const shadow = grid._renderRoot;\n      const isExpanded = state.expandedSections.has(sectionId);\n\n      if (isExpanded) {\n        // Collapsing current section\n        const cleanup = state.panelCleanups.get(sectionId);\n        if (cleanup) {\n          cleanup();\n          state.panelCleanups.delete(sectionId);\n        }\n        panel.onClose?.();\n        state.expandedSections.delete(sectionId);\n        updateAccordionSectionState(shadow, sectionId, false);\n      } else {\n        // Expanding - first collapse all others (exclusive accordion)\n        for (const [otherId, otherPanel] of state.toolPanels) {\n          if (otherId !== sectionId && state.expandedSections.has(otherId)) {\n            const cleanup = state.panelCleanups.get(otherId);\n            if (cleanup) {\n              cleanup();\n              state.panelCleanups.delete(otherId);\n            }\n            otherPanel.onClose?.();\n            state.expandedSections.delete(otherId);\n            updateAccordionSectionState(shadow, otherId, false);\n            // Clear content of collapsed section\n            const contentEl = shadow.querySelector(`[data-section=\"${otherId}\"] .tbw-accordion-content`);\n            if (contentEl) contentEl.innerHTML = '';\n          }\n        }\n        // Now expand the target section\n        state.expandedSections.add(sectionId);\n        updateAccordionSectionState(shadow, sectionId, true);\n        renderAccordionSectionContent(shadow, state, sectionId);\n      }\n\n      // Emit event\n      grid._emit('tool-panel-section-toggle', { id: sectionId, expanded: !isExpanded });\n    },\n\n    getToolPanels() {\n      return [...state.toolPanels.values()];\n    },\n\n    registerToolPanel(panel: ToolPanelDefinition) {\n      if (state.toolPanels.has(panel.id)) {\n        warnDiagnostic(TOOL_PANEL_DUPLICATE, `Tool panel \"${panel.id}\" already registered`, grid.id);\n        return;\n      }\n      state.toolPanels.set(panel.id, panel);\n\n      // Refresh when already rendered, OR bootstrap the chrome when the shell is\n      // connected but has not rendered yet (an opt-in `features: { shell: true }`\n      // shell with no other content renders no chrome — registering the first\n      // tool panel must build it). `refreshShellHeader` self-guards on\n      // `isConnected` and batches, so a pre-connect call is a harmless no-op.\n      if (initialized || grid._hostElement.isConnected) {\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    unregisterToolPanel(panelId: string) {\n      // Close panel if open and this section is expanded\n      if (state.expandedSections.has(panelId)) {\n        const cleanup = state.panelCleanups.get(panelId);\n        if (cleanup) {\n          cleanup();\n          state.panelCleanups.delete(panelId);\n        }\n        state.expandedSections.delete(panelId);\n      }\n\n      state.toolPanels.delete(panelId);\n\n      if (initialized || grid._hostElement.isConnected) {\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    getHeaderContents() {\n      return [...state.headerContents.values()];\n    },\n\n    registerHeaderContent(content: HeaderContentDefinition) {\n      if (state.headerContents.has(content.id)) {\n        warnDiagnostic(HEADER_CONTENT_DUPLICATE, `Header content \"${content.id}\" already registered`, grid.id);\n        return;\n      }\n      state.headerContents.set(content.id, content);\n\n      if (initialized) {\n        renderHeaderContent(grid._renderRoot, state);\n      } else if (grid._hostElement.isConnected) {\n        // Connected opt-in shell with no chrome yet — bootstrap it so the header\n        // content has a `.tbw-shell-header` to render into.\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    unregisterHeaderContent(contentId: string) {\n      // Clean up\n      const cleanup = state.headerContentCleanups.get(contentId);\n      if (cleanup) {\n        cleanup();\n        state.headerContentCleanups.delete(contentId);\n      }\n\n      // Call onDestroy\n      const content = state.headerContents.get(contentId);\n      content?.onDestroy?.();\n\n      state.headerContents.delete(contentId);\n\n      // Remove DOM element\n      const el = grid._renderRoot.querySelector(`[data-header-content=\"${contentId}\"]`);\n      el?.remove();\n    },\n\n    getToolbarContents() {\n      return [...state.toolbarContents.values()].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n    },\n\n    registerToolbarContent(content: ToolbarContentDefinition) {\n      if (state.toolbarContents.has(content.id)) {\n        warnDiagnostic(TOOLBAR_CONTENT_DUPLICATE, `Toolbar content \"${content.id}\" already registered`, grid.id);\n        return;\n      }\n      state.toolbarContents.set(content.id, content);\n\n      if (initialized || grid._hostElement.isConnected) {\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    unregisterToolbarContent(contentId: string) {\n      // Clean up\n      const cleanup = state.toolbarContentCleanups.get(contentId);\n      if (cleanup) {\n        cleanup();\n        state.toolbarContentCleanups.delete(contentId);\n      }\n\n      // Call onDestroy if defined\n      const content = state.toolbarContents.get(contentId);\n      if (content?.onDestroy) {\n        content.onDestroy();\n      }\n\n      state.toolbarContents.delete(contentId);\n\n      if (initialized) {\n        grid.refreshShellHeader?.();\n      }\n    },\n  };\n\n  return controller;\n}\n\n/**\n * Update accordion section visual state.\n */\nfunction updateAccordionSectionState(renderRoot: Element, sectionId: string, expanded: boolean): void {\n  const section = renderRoot.querySelector(`[data-section=\"${sectionId}\"]`);\n  if (section) {\n    section.classList.toggle('expanded', expanded);\n  }\n}\n\n/**\n * Render content for a single accordion section.\n */\nfunction renderAccordionSectionContent(renderRoot: Element, state: ShellState, sectionId: string): void {\n  const panel = state.toolPanels.get(sectionId);\n  if (!panel?.render) return;\n\n  const contentEl = renderRoot.querySelector(`[data-section=\"${sectionId}\"] .tbw-accordion-content`);\n  if (!contentEl) return;\n\n  const cleanup = panel.render(contentEl as HTMLElement);\n  if (cleanup) {\n    state.panelCleanups.set(sectionId, cleanup);\n  }\n}\n// #endregion\n","/**\n * Shell Plugin Styles\n *\n * Merged from the former core partials `core/styles/shell.css` +\n * `core/styles/tool-panel.css` (extraction #370). Near-verbatim concatenation —\n * cascade layer (`@layer tbw-base`) preserved so behavior is byte-identical\n * while both copies coexist during Phase 1a. Core copies are removed in\n * Task 1b.1.5; the layer question (tbw-base vs tbw-plugins) is revisited then.\n *\n * EXCEPTION: `.tbw-scroll-area` and `.tbw-grid-content` are NOT here — both are\n * core scroll-viewport layout (rendered by dom-builder for every grid, shell or\n * not) and live in `core/styles/base.css`. Without a shell, `.tbw-grid-content`\n * still wraps the scroll area, so its layout rule must load unconditionally.\n *\n * @layer tbw-base\n */\n\n/* ==========================================================================\n * Shell Layout (was core/styles/shell.css)\n *\n * Styles for the grid shell including header, toolbar, content area,\n * and scroll container.\n * ========================================================================== */\n\n@layer tbw-base {\n  tbw-grid {\n    .tbw-shell-header {\n      display: flex;\n      align-items: center;\n      gap: 8px;\n      min-height: var(--tbw-shell-header-height);\n      padding: 0 8px;\n      background: var(--tbw-shell-header-bg);\n      border-bottom: 1px solid var(--tbw-shell-header-border);\n      flex-shrink: 0;\n    }\n\n    .tbw-shell-title {\n      font-size: var(--tbw-shell-title-font-size);\n      font-weight: var(--tbw-shell-title-font-weight);\n      white-space: nowrap;\n      overflow: hidden;\n      text-overflow: ellipsis;\n    }\n\n    .tbw-shell-content {\n      flex: 1;\n      display: flex;\n      align-items: center;\n      gap: 12px;\n      min-width: 0;\n      overflow: hidden;\n    }\n\n    .tbw-shell-toolbar {\n      display: flex;\n      align-items: center;\n      gap: var(--tbw-toolbar-button-gap);\n      flex-shrink: 0;\n    }\n\n    .tbw-toolbar-btn {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: var(--tbw-toolbar-button-size);\n      height: var(--tbw-toolbar-button-size);\n      padding: 0;\n      border: 1px solid transparent;\n      border-radius: var(--tbw-border-radius);\n      background: transparent;\n      color: var(--tbw-color-fg);\n      cursor: pointer;\n      font-size: 16px;\n      transition:\n        background var(--tbw-transition-duration) var(--tbw-transition-ease),\n        border-color var(--tbw-transition-duration) var(--tbw-transition-ease);\n\n      &:hover {\n        background: var(--tbw-color-row-hover);\n      }\n\n      &:focus-visible {\n        outline: var(--tbw-focus-outline);\n        outline-offset: var(--tbw-focus-outline-offset);\n      }\n\n      &.active {\n        background: var(--tbw-focus-background);\n        border-color: var(--tbw-color-accent);\n      }\n\n      &:disabled {\n        opacity: 0.5;\n        cursor: not-allowed;\n      }\n    }\n\n    .tbw-toolbar-separator {\n      width: 1px;\n      height: 20px;\n      background: var(--tbw-color-border);\n      margin: 0 4px;\n    }\n\n    .tbw-shell-body {\n      position: relative;\n      display: flex;\n      flex: 1;\n      min-height: 0;\n      overflow: visible;\n    }\n  }\n}\n\n/* ==========================================================================\n * Tool Panel (was core/styles/tool-panel.css)\n *\n * Styles for the collapsible side panel including header, content,\n * resize handle, and accordion components.\n * ========================================================================== */\n\n@layer tbw-base {\n  tbw-grid {\n    .tbw-tool-panel {\n      position: absolute;\n      top: 0;\n      bottom: 0;\n      right: 0;\n      width: 0;\n      /* `clip` rather than `hidden` so the clip region can be widened: the\n         splitter's hit area straddles the docked edge and has to survive it.\n         `overflow-clip-margin` is the one place `calc()` is avoided — Chromium\n         drops the declaration when the value is calculated, so the overhang is\n         its own token and the splitter geometry is derived from it. */\n      overflow: clip;\n      overflow-clip-margin: var(--tbw-tool-panel-resize-overhang, 12px);\n      background: var(--tbw-tool-panel-bg);\n      border-left: 1px solid var(--tbw-tool-panel-border);\n      transition: width var(--tbw-tool-panel-transition);\n      display: flex;\n      flex-direction: column;\n      z-index: var(--tbw-z-layer-toolpanel, 31);\n      box-shadow: -2px 0 8px var(--tbw-color-shadow);\n\n      &[data-position='left'] {\n        right: auto;\n        left: 0;\n        border-left: none;\n        border-right: 1px solid var(--tbw-tool-panel-border);\n        box-shadow: 2px 0 8px var(--tbw-color-shadow);\n      }\n\n      &.open {\n        /* Never wider than the grid it docks into. An overflowing panel is cut\n           off by the clip above with no way to scroll to what is missing — the\n           labels and the left half of every chip simply vanish (SC 1.4.10\n           Reflow). The 20px reserve matches the drag clamp in\n           `setupToolPanelResize`, so no path can reach a size the other cannot.\n           `max-width` as well as `width`: a dragged width lands as an inline\n           style, which only a max-width can rein back in when the grid later\n           narrows under it. */\n        width: min(var(--tbw-tool-panel-width), 100% - 20px);\n        max-width: calc(100% - 20px);\n      }\n    }\n\n    /* ========== Push mode ========== */\n\n    /* In push mode the panel becomes a flex sibling of the grid content\n       instead of overlaying it. Opening the panel shrinks the grid's\n       available width; the grid's ResizeObserver re-runs column\n       virtualization, so cells that would be hidden by an overlay panel\n       remain reachable.\n\n       The overlay shadow is dropped (nothing to lift off) and the resize\n       handle is suppressed: the panel's width is part of the layout, so\n       drag-to-resize would fight the flex container instead of cooperating\n       with it. */\n    .tbw-shell-body[data-mode='push'] {\n      .tbw-tool-panel {\n        position: relative;\n        top: auto;\n        bottom: auto;\n        right: auto;\n        left: auto;\n        flex-shrink: 0;\n        box-shadow: none;\n        z-index: auto;\n        /* In overlay mode the 1px side border is harmless because the panel\n           floats above the grid. In push mode the panel is a flex sibling,\n           so a non-zero border on a width:0 panel still reserves 1px of\n           horizontal space and shows as a stray divider. Drop the border\n           by default and only re-apply it on the open state. */\n        border-left: none;\n        border-right: none;\n\n        &.open {\n          border-left: 1px solid var(--tbw-tool-panel-border);\n        }\n\n        &[data-position='left'].open {\n          border-left: none;\n          border-right: 1px solid var(--tbw-tool-panel-border);\n        }\n      }\n\n      .tbw-tool-panel-resize {\n        display: none;\n      }\n    }\n\n    /* ========== Dropdown mode ========== */\n\n    /* In dropdown mode the whole tool-panel sidebar (the full accordion) is\n       promoted to the top layer as a native popover and anchored near a\n       trigger (the built-in toggle, a custom column-header button, or the grid\n       corner). The docked absolute/full-height sidebar styling is replaced by\n       a self-sized floating card with an internal scroll region.\n\n       The resize handle is suppressed (a popover has no docked edge to drag)\n       and the open/close width transition is dropped (the popover is shown and\n       hidden via the Popover API, not by animating width). */\n    .tbw-tool-panel[popover] {\n      position: fixed;\n      inset: auto;\n      width: var(--tbw-tool-panel-width);\n      max-width: calc(100vw - 16px);\n      height: auto;\n      max-height: min(70vh, 480px);\n      overflow: hidden auto;\n      margin: 4px 0 0 0;\n      padding: 0;\n      border: 1px solid var(--tbw-tool-panel-border);\n      border-radius: var(--tbw-border-radius, 6px);\n      box-shadow: 0 8px 24px var(--tbw-color-shadow);\n      transition: none;\n\n      /* The native popover UA rule hides a closed popover with `display: none`,\n         but the base `.tbw-tool-panel { display: flex }` author rule outranks\n         the UA origin and would leak the closed popover onto the page (floating\n         over the header). Re-assert hidden-until-open here, and restore the\n         flex layout only while the popover is actually shown. */\n      display: none;\n\n      /* `:popover-open` is the native (Popover API) open signal. `.open` is the\n         JS-toggled fallback (`updatePanelState`) so dropdown mode still renders\n         in browsers / DOMs without Popover API support, where `showPopover()`\n         is unavailable and `:popover-open` never matches. */\n      &:popover-open,\n      &.open {\n        display: flex;\n        width: var(--tbw-tool-panel-width);\n      }\n\n      .tbw-tool-panel-resize {\n        display: none;\n      }\n    }\n\n    /* CSS anchor positioning (progressive enhancement). When the browser\n       supports it, the controller wires `anchor-name` on the trigger and\n       `position-anchor` on the popover; JS only sets fixed coordinates as a\n       fallback for browsers without anchor positioning. */\n    @supports (anchor-name: --x) {\n      .tbw-tool-panel[popover] {\n        /* Default (right position): align popover's right edge to the anchor's\n           right edge and drop below it. */\n        top: anchor(bottom);\n        right: anchor(right);\n        left: auto;\n        position-try-fallbacks:\n          flip-block,\n          flip-inline,\n          flip-block flip-inline;\n\n        /* Grid-corner fallback anchors to the top of the grid host. */\n        &[data-anchor='corner'] {\n          top: anchor(top);\n        }\n\n        &[data-position='left'] {\n          left: anchor(left);\n          right: auto;\n        }\n      }\n    }\n\n    .tbw-tool-panel-resize {\n      position: absolute;\n      top: 0;\n      bottom: 0;\n      /* Transparent hit area, twice the overhang wide (24px by default, the\n         SC 2.5.8 minimum) and centred on the docked edge, so half of it falls\n         outside the panel and it never covers the panel's own controls. */\n      width: calc(var(--tbw-tool-panel-resize-overhang, 12px) * 2);\n      cursor: col-resize;\n      background: transparent;\n      z-index: 10;\n      /* The splitter drag is driven by pointer capture, so the browser must not\n         claim the gesture for panning on touch devices. */\n      touch-action: none;\n      user-select: none;\n\n      /* The visible bar is only the 6px at the docked edge; the rest of the\n         width is invisible hit area. */\n      &::before {\n        content: '';\n        position: absolute;\n        top: 0;\n        bottom: 0;\n        width: 6px;\n        background: transparent;\n        transition: background var(--tbw-transition-duration) var(--tbw-transition-ease);\n      }\n\n      &[data-handle-position='left'] {\n        left: calc(3px - var(--tbw-tool-panel-resize-overhang, 12px));\n\n        &::before {\n          left: calc(var(--tbw-tool-panel-resize-overhang, 12px) - 3px);\n        }\n      }\n\n      &[data-handle-position='right'] {\n        right: calc(3px - var(--tbw-tool-panel-resize-overhang, 12px));\n\n        &::before {\n          right: calc(var(--tbw-tool-panel-resize-overhang, 12px) - 3px);\n        }\n      }\n\n      /* `[data-tbw-size-open]` keeps the splitter lit while the size popover is\n         open, so the popover stays visually tied to the edge it is sizing. */\n      &:hover::before,\n      &.resizing::before,\n      &[data-tbw-size-open]::before {\n        background: var(--tbw-color-accent);\n      }\n    }\n\n    /* A closed panel is zero-width, so the splitter would hang over the grid\n       inside the clip margin. It has nothing to size until the panel is open. */\n    .tbw-tool-panel:not(.open) .tbw-tool-panel-resize {\n      display: none;\n    }\n\n    .tbw-tool-panel-header {\n      display: flex;\n      align-items: center;\n      justify-content: flex-end;\n      min-height: var(--tbw-tool-panel-header-height);\n      padding: 0 12px;\n      border-bottom: 1px solid var(--tbw-tool-panel-border);\n      flex-shrink: 0;\n    }\n\n    .tbw-tool-panel-title {\n      font-weight: 600;\n      font-size: 13px;\n      white-space: nowrap;\n      overflow: hidden;\n      text-overflow: ellipsis;\n    }\n\n    .tbw-tool-panel-close {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 24px;\n      height: 24px;\n      padding: 0;\n      border: none;\n      border-radius: var(--tbw-border-radius);\n      background: transparent;\n      color: var(--tbw-color-fg-muted);\n      cursor: pointer;\n      font-size: 14px;\n\n      &:hover {\n        background: var(--tbw-color-row-hover);\n        color: var(--tbw-color-fg);\n      }\n    }\n\n    /* Inline close button — shares the first accordion header row in\n       single-panel mode (header bar hidden, overlay/push mode). */\n    .tbw-accordion-header-row {\n      display: flex;\n      align-items: stretch;\n\n      .tbw-accordion-header {\n        flex: 1;\n        min-width: 0;\n      }\n    }\n\n    .tbw-tool-panel-close--inline {\n      align-self: center;\n      flex-shrink: 0;\n      margin-inline-end: 8px;\n    }\n\n    .tbw-tool-panel-content {\n      flex: 1;\n      overflow: auto;\n    }\n\n    /* ========== Accordion ========== */\n\n    .tbw-accordion {\n      display: flex;\n      flex-direction: column;\n      gap: 0;\n    }\n\n    .tbw-accordion-section {\n      border-bottom: 1px solid var(--tbw-tool-panel-border);\n\n      &:last-child {\n        border-bottom: none;\n      }\n\n      &.single .tbw-accordion-header {\n        cursor: default;\n\n        &:hover {\n          background: transparent;\n        }\n      }\n\n      &.expanded {\n        .tbw-accordion-chevron {\n          transform: rotate(90deg);\n        }\n\n        .tbw-accordion-content {\n          display: block;\n        }\n      }\n    }\n\n    .tbw-accordion-header {\n      display: flex;\n      align-items: center;\n      gap: 8px;\n      width: 100%;\n      padding: 10px 12px;\n      border: none;\n      background: transparent;\n      color: var(--tbw-color-fg);\n      font-size: 13px;\n      font-weight: 600;\n      text-align: start;\n      cursor: pointer;\n      user-select: none;\n\n      &:hover {\n        background: var(--tbw-color-row-hover);\n      }\n    }\n\n    .tbw-accordion-chevron {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 16px;\n      height: 16px;\n      font-size: 10px;\n      color: var(--tbw-color-fg-muted);\n      transition: transform 0.15s ease;\n      flex-shrink: 0;\n    }\n\n    .tbw-accordion-icon {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 16px;\n      height: 16px;\n      font-size: 14px;\n      flex-shrink: 0;\n    }\n\n    .tbw-accordion-title {\n      flex: 1;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n\n    .tbw-accordion-content {\n      display: none;\n    }\n  }\n}\n","/**\n * Shell Plugin (Class-based)\n *\n * Owns the grid shell: header bar, toolbar content, and tool panels.\n *\n * **Extraction #370 — Phase 1b (ownership inversion):** this plugin now owns\n * the shell **state** for the grid's lifetime (Approach A: state created once,\n * survives plugin re-inits, torn down on disconnect). Light-DOM parsing,\n * per-render work, and DOM construction move here in the following increments;\n * until each lands, core still drives that part via the resolved plugin\n * instance.\n *\n * @module Plugins/Shell\n */\n\nimport { HEADER_CONTENT_DUPLICATE, TOOL_PANEL_DUPLICATE, warnDiagnostic } from '../../core/internal/diagnostics';\nimport { BaseGridPlugin, type GridElement } from '../../core/plugin/base-plugin';\nimport type { GridConfig } from '../../core/types';\nimport {\n  cleanupShellState,\n  createShellState,\n  parseLightDomShell,\n  parseLightDomToolButtons,\n  parseLightDomToolPanels,\n  prepareForRerender,\n  rebuildShellDOM,\n  renderCustomToolbarContents,\n  renderHeaderContent,\n  renderPanelContent,\n  setupClickOutsideDismiss,\n  setupEscapeDismiss,\n  setupShellEventListeners,\n  setupToolPanelResize,\n  shouldRenderShellHeader,\n  updatePanelState,\n  updateToolbarActiveStates,\n  type ShellState,\n} from './shell';\nimport { createShellController, type ShellController, type ShellControllerGrid } from './shell-controller';\nimport styles from './shell.css?inline';\nimport './types';\nimport type {\n  HeaderContentDefinition,\n  OpenToolPanelOptions,\n  ShellConfig,\n  ToolbarContentDefinition,\n  ToolPanelDefinition,\n} from './types';\n\n/**\n * Shell plugin for `<tbw-grid>`.\n *\n * @see {@link ShellConfig} for all configuration options.\n *\n * @internal Extends BaseGridPlugin.\n * @since 2.x (extraction #370)\n */\nexport class ShellPlugin extends BaseGridPlugin<ShellConfig> {\n  /** @internal */\n  readonly name = 'shell';\n  /** @internal */\n  override readonly styles = styles;\n\n  // Extraction #370 — Approach A: the plugin owns the shell state for the\n  // grid's lifetime. State is created once (via `ensureState`, lazily on first\n  // access) and survives plugin re-inits (idempotent attach / non-destructive\n  // detach); it is torn down only on grid disconnect via `disposeShellState()`.\n  #state?: ShellState;\n  #controller?: ShellController;\n\n  // Document-level listeners the plugin owns for the shell's interactive\n  // affordances. Each `#setupListeners` call cleans the previous registration\n  // before re-adding (idempotent across re-wraps); torn down on disconnect.\n  #resizeCleanup?: () => void;\n  #clickOutsideCleanup?: () => void;\n  #escapeDismissCleanup?: () => void;\n\n  // The light-DOM shell-change handler (re-parses <tbw-grid-header> /\n  // <tbw-grid-tool-buttons> / <tbw-grid-tool-panel> when the framework projects\n  // them asynchronously). Registered in `attach` via the generic\n  // `_registerLightDomHandler` seam; unregistered on disconnect.\n  #shellChangeHandler?: () => void;\n\n  // While a dropdown tool panel is open, this observer watches the render root\n  // for the trigger being recreated by an outer framework (e.g. a React column\n  // `headerRenderer` re-running on a column toggle) and re-pairs the popover's\n  // anchor. MutationObserver callbacks run as a pre-paint microtask, so the\n  // re-pair lands BEFORE the browser paints the dangling-anchor frame — no\n  // flash. It also fires for every toggle (not a coalesced single rAF), so the\n  // dropdown no longer intermittently disappears. Connected lazily while a\n  // dropdown is open; disconnected on close and on grid disconnect.\n  #reanchorObserver?: MutationObserver;\n  #reanchorObserving = false;\n\n  /** @internal Whether shell state has been created yet. */\n  get hasState(): boolean {\n    return this.#state !== undefined;\n  }\n\n  /**\n   * @internal Create the canonical shell state + controller (idempotent).\n   * The plugin owns shell-state construction; the controller binds to the grid\n   * for UI updates. No-op once state exists, so it is safe to call on every\n   * `attach` (and from a pre-connect API call), which keeps the shell self-\n   * sufficient — core holds no shell-activation knowledge (extraction #370).\n   */\n  ensureState(grid: GridElement): void {\n    if (this.#state) return;\n    const state = createShellState();\n    this.#state = state;\n    this.#controller = createShellController(state, grid as ShellControllerGrid);\n  }\n\n  /** @internal Canonical shell state. */\n  get shellState(): ShellState {\n    return this.#state as ShellState;\n  }\n\n  /** @internal Shell controller. */\n  get shellController(): ShellController {\n    return this.#controller as ShellController;\n  }\n\n  // #region Public Shell API\n  // The shell plugin's public, programmatic API. Obtain the instance via\n  // `grid.getPluginByName('shell')`. The equivalent `<tbw-grid>` delegate\n  // methods were removed in v3 (extraction #370). Each guards on `hasState`\n  // so a call before the shell has initialized is a safe no-op.\n\n  /** Whether the tool panel sidebar is currently open. */\n  get isToolPanelOpen(): boolean {\n    return this.hasState ? this.shellController.isPanelOpen : false;\n  }\n\n  /** IDs of the currently expanded accordion sections in the tool panel. */\n  get expandedToolPanelSections(): string[] {\n    return this.hasState ? this.shellController.expandedSections : [];\n  }\n\n  /**\n   * Open the tool panel sidebar.\n   * @param panelId - Optional section to expand on open (see {@link ShellController.openToolPanel}).\n   * @param options - Optional open options. In `mode: 'dropdown'`, `options.anchor`\n   *   sets the element the popover anchors to (see {@link OpenToolPanelOptions}).\n   */\n  openToolPanel(panelId?: string, options?: OpenToolPanelOptions): void {\n    this.shellController?.openToolPanel(panelId, options);\n  }\n\n  /** Close the tool panel sidebar. */\n  closeToolPanel(): void {\n    this.shellController?.closeToolPanel();\n  }\n\n  /**\n   * Toggle the tool panel sidebar open or closed.\n   * @param options - Optional open options forwarded when opening (e.g. `anchor`\n   *   for dropdown mode; see {@link OpenToolPanelOptions}).\n   */\n  toggleToolPanel(options?: OpenToolPanelOptions): void {\n    this.shellController?.toggleToolPanel(options);\n  }\n\n  /** Toggle an accordion section expanded or collapsed within the tool panel. */\n  toggleToolPanelSection(sectionId: string): void {\n    this.shellController?.toggleToolPanelSection(sectionId);\n  }\n\n  /** Get all registered tool panel definitions. */\n  getToolPanels(): ToolPanelDefinition[] {\n    return this.hasState ? this.shellController.getToolPanels() : [];\n  }\n\n  /** Register a custom tool panel section. */\n  registerToolPanel(panel: ToolPanelDefinition): void {\n    if (!this.hasState) return;\n    this.shellState.apiToolPanelIds.add(panel.id);\n    this.shellController.registerToolPanel(panel);\n  }\n\n  /** Unregister a custom tool panel section. */\n  unregisterToolPanel(panelId: string): void {\n    if (!this.hasState) return;\n    this.shellState.apiToolPanelIds.delete(panelId);\n    this.shellController.unregisterToolPanel(panelId);\n  }\n\n  /** Get all registered header content definitions. */\n  getHeaderContents(): HeaderContentDefinition[] {\n    return this.hasState ? this.shellController.getHeaderContents() : [];\n  }\n\n  /** Register custom header content (rendered in the shell header bar). */\n  registerHeaderContent(content: HeaderContentDefinition): void {\n    if (!this.hasState) return;\n    this.shellState.apiHeaderContentIds.add(content.id);\n    this.shellController.registerHeaderContent(content);\n  }\n\n  /** Unregister custom header content. */\n  unregisterHeaderContent(contentId: string): void {\n    if (!this.hasState) return;\n    this.shellState.apiHeaderContentIds.delete(contentId);\n    this.shellController.unregisterHeaderContent(contentId);\n  }\n\n  /** Get all registered toolbar content definitions. */\n  getToolbarContents(): ToolbarContentDefinition[] {\n    return this.hasState ? this.shellController.getToolbarContents() : [];\n  }\n\n  /** Register custom toolbar content (rendered in the shell toolbar). */\n  registerToolbarContent(content: ToolbarContentDefinition): void {\n    this.shellController?.registerToolbarContent(content);\n  }\n\n  /** Unregister custom toolbar content. */\n  unregisterToolbarContent(contentId: string): void {\n    this.shellController?.unregisterToolbarContent(contentId);\n  }\n  // #endregion\n\n  /** @internal */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    // Activate the shell on attach so an opted-in shell renders without core\n    // ever calling into it (extraction #370 — core holds no shell-activation\n    // knowledge). Idempotent: a pre-connect API call may have created state.\n    this.ensureState(grid);\n    // Register the light-DOM shell handlers via the generic seam. Core holds no\n    // shell tag knowledge (extraction #370). `registerLightDomHandler` is keyed\n    // by tag name, so re-attach simply overwrites — idempotent. Torn down on\n    // grid disconnect in `disposeShellState` (Approach A: survives re-inits).\n    const handler = (): void => this.syncLightDom();\n    this.#shellChangeHandler = handler;\n    grid._registerLightDomHandler('tbw-grid-header', handler);\n    grid._registerLightDomHandler('tbw-grid-tool-buttons', handler);\n    grid._registerLightDomHandler('tbw-grid-tool-panel', handler);\n  }\n\n  /** @internal Parse all light-DOM shell elements into the plugin's state. */\n  #parseLightDom(grid: GridElement): void {\n    const host = grid._hostElement;\n    parseLightDomShell(host, this.shellState);\n    parseLightDomToolButtons(host, this.shellState);\n    parseLightDomToolPanels(host, this.shellState, grid._getToolPanelRendererFactory());\n  }\n\n  /**\n   * @internal Generic hook: react to a light-DOM shell element being\n   * added/removed/mutated (e.g. a framework projecting `<tbw-grid-header title>`\n   * asynchronously). Re-parses, and if a title or tool-buttons container newly\n   * appeared, re-merges the config (so `processConfig` folds it in) and re-wraps\n   * the already-rendered shell header. No-op until the shell header is rendered.\n   * Called by core from `refreshColumns` and the light-DOM observer.\n   */\n  override syncLightDom(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    const state = this.shellState;\n    const hadTitle = state.lightDomTitle;\n    const hadToolButtons = state.hasToolButtonsContainer;\n    this.#parseLightDom(grid);\n    const hasTitle = state.lightDomTitle;\n    const hasToolButtons = state.hasToolButtonsContainer;\n\n    if ((hasTitle && !hadTitle) || (hasToolButtons && !hadToolButtons)) {\n      grid._requestConfigMerge();\n      // Re-wrap the shell header to reflect the new title / tool buttons.\n      // `afterStructuralRender` rebuilds the chrome AND re-renders all shell\n      // contents (header content, toolbar slots, panel), so no manual render is\n      // needed here.\n      if (grid._renderRoot.querySelector('.tbw-shell-header')) {\n        prepareForRerender(state);\n        this.afterStructuralRender();\n      }\n    }\n  }\n\n  // #region Generic structural hooks (extraction #370)\n  // Core calls these via the plugin manager (parseLightDom /\n  // beforeStructuralRender / needsStructuralRerender) — it holds no\n  // shell-specific orchestration. The shell self-parses, self-prepares, and\n  // self-decides re-render needs from its own state + DOM signature.\n\n  /** @internal Generic hook: re-parse all light-DOM shell elements into state. */\n  override parseLightDom(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    this.#parseLightDom(grid);\n  }\n\n  /** @internal Generic hook: move toolbar buttons back ahead of a structural rebuild. */\n  override beforeStructuralRender(): void {\n    if (!this.hasState) return;\n    prepareForRerender(this.shellState);\n  }\n\n  /**\n   * @internal Generic hook: whether the shell's rendered DOM signature no longer\n   * matches the new effective config (header appearing/disappearing, tool-panel\n   * count/position/mode change) and therefore needs a structural re-render.\n   * Reads the still-current (old) DOM vs the freshly merged config.\n   */\n  override needsStructuralRerender(): boolean {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return false;\n    const root = grid._renderRoot;\n    const hadShell = !!root.querySelector('.has-shell');\n    const hadToolPanel = !!root.querySelector('.tbw-tool-panel');\n    const accordionSectionsBefore = root.querySelectorAll('.tbw-accordion-section').length;\n    const prevPosition = (root.querySelector('.tbw-tool-panel') as HTMLElement | null)?.dataset.position ?? 'right';\n    const prevMode = (root.querySelector('.tbw-shell-body') as HTMLElement | null)?.dataset.mode ?? 'overlay';\n\n    const shell = grid.effectiveConfig?.shell;\n    const nowNeedsShell = shouldRenderShellHeader(shell);\n    const nowHasToolPanels = (shell?.toolPanels?.length ?? 0) > 0;\n    const toolPanelCount = shell?.toolPanels?.length ?? 0;\n    const newPosition = shell?.toolPanel?.position ?? 'right';\n    const newMode = shell?.toolPanel?.mode ?? 'overlay';\n\n    return (\n      hadShell !== nowNeedsShell ||\n      (!hadToolPanel && nowHasToolPanels) ||\n      (hadToolPanel && toolPanelCount !== accordionSectionsBefore) ||\n      (hadToolPanel && prevPosition !== newPosition) ||\n      (hadToolPanel && prevMode !== newMode)\n    );\n  }\n  // #endregion\n\n  /**\n   * @internal Fold the plugin's shell state into the effective config.\n   *\n   * Called by core's config merge ({@link ConfigManager.merge}) via the neutral\n   * `processConfig` plugin hook \\u2014 core holds no shell-config knowledge. Mutates\n   * `config.shell` in place from light-DOM-parsed + API-registered shell state\n   * (title, header content, tool buttons, tool panels, header/toolbar contents).\n   *\n   * Extraction #370, Task 1b \\u2014 config ownership inversion: replaces core's old\n   * `ConfigManager.#mergeShellConfig`.\n   */\n  /**\n   * @internal Self-collect plugin tool panels + header contents into shell\n   * state. Clears stale plugin-contributed entries (preserving light-DOM +\n   * API-registered) then re-collects fresh from all attached plugins via the\n   * neutral `grid._pluginShellContributions()` seam. Idempotent — safe to run on\n   * every config merge, which is how plugin re-inits are picked up.\n   *\n   * Extraction #370: replaces core's `#collectPluginShellContributions` plus the\n   * plugin-reinit cleanup block in core's `#updatePluginConfigs`.\n   */\n  #syncPluginContributions(grid: GridElement): void {\n    const state = this.shellState;\n    const gridId = grid._hostElement.id;\n\n    // Drop stale plugin-contributed tool panels (keep light-DOM + API panels).\n    for (const panelId of [...state.toolPanels.keys()]) {\n      if (state.lightDomToolPanelIds.has(panelId) || state.apiToolPanelIds.has(panelId)) continue;\n      state.panelCleanups.get(panelId)?.();\n      state.panelCleanups.delete(panelId);\n      state.toolPanels.delete(panelId);\n    }\n    // Drop stale plugin-contributed header contents (keep API-registered).\n    for (const contentId of [...state.headerContents.keys()]) {\n      if (state.apiHeaderContentIds.has(contentId)) continue;\n      state.headerContentCleanups.get(contentId)?.();\n      state.headerContentCleanups.delete(contentId);\n      state.headerContents.delete(contentId);\n    }\n\n    const { toolPanels, headerContents } = grid._pluginShellContributions();\n\n    for (const panel of toolPanels) {\n      // Precedence (#370): an API-registered panel wins over a plugin; a plugin\n      // wins over a colliding light-DOM panel (the plugin owns its own DOM, so\n      // it must own the id).\n      if (state.apiToolPanelIds.has(panel.id)) continue;\n      if (state.lightDomToolPanelIds.has(panel.id)) {\n        warnDiagnostic(\n          TOOL_PANEL_DUPLICATE,\n          `Tool panel \"${panel.id}\" is provided by a plugin; ignoring the matching light-DOM <tbw-grid-tool-panel>.`,\n          gridId,\n        );\n        state.panelCleanups.get(panel.id)?.();\n        state.panelCleanups.delete(panel.id);\n        state.lightDomToolPanelIds.delete(panel.id);\n        state.adapterBoundToolPanelIds.delete(panel.id);\n      }\n      state.toolPanels.set(panel.id, panel);\n    }\n\n    for (const content of headerContents) {\n      if (state.apiHeaderContentIds.has(content.id)) continue;\n      if (state.headerContents.has(content.id)) {\n        warnDiagnostic(\n          HEADER_CONTENT_DUPLICATE,\n          `Header content \"${content.id}\" is provided by a plugin; ignoring the matching light-DOM definition.`,\n          gridId,\n        );\n        state.headerContentCleanups.get(content.id)?.();\n        state.headerContentCleanups.delete(content.id);\n      }\n      state.headerContents.set(content.id, content);\n    }\n  }\n\n  override processConfig(config: GridConfig): void {\n    if (!this.hasState) return;\n    const state = this.shellState;\n\n    // Self-parse light-DOM shell elements + self-collect plugin shell\n    // contributions before folding state into config (extraction #370 —\n    // replaces core's `#parseLightDom` + `#collectPluginShellContributions`).\n    const grid = this.grid;\n    if (grid) {\n      this.#parseLightDom(grid);\n      this.#syncPluginContributions(grid);\n    }\n\n    // Constructor-supplied shell config is the base layer: the canonical\n    // `features: { shell: ... }` opt-in passes the config value here (and an\n    // explicit `plugins: [new ShellPlugin(cfg)]` does too). An explicit\n    // top-level `gridConfig.shell` overrides it; parsed light-DOM / API state\n    // folds on top below. Empty for the auto-registered instance\n    // (`new ShellPlugin()`), so existing default-on behavior is unchanged.\n    const ctor = this.resolvedConfig;\n\n    // Clone shell hierarchy to avoid mutating the original gridConfig.\n    config.shell = { ...ctor, ...config.shell };\n    config.shell.header = { ...ctor.header, ...config.shell.header };\n\n    // Light DOM title (does not override an explicit config title).\n    if (state.lightDomTitle && !config.shell.header.title) {\n      config.shell.header.title = state.lightDomTitle;\n    }\n\n    // Light DOM header content elements.\n    if (state.lightDomHeaderContent?.length > 0) {\n      config.shell.header.lightDomContent = state.lightDomHeaderContent;\n    }\n\n    // Tool-buttons container presence.\n    if (state.hasToolButtonsContainer) {\n      config.shell.header.hasToolButtonsContainer = true;\n    }\n\n    // Tool panels (from plugins + API + Light DOM), sorted by order.\n    if (state.toolPanels.size > 0) {\n      const panels = Array.from(state.toolPanels.values());\n      panels.sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n      config.shell.toolPanels = panels;\n    }\n\n    // Header contents (from plugins + API), sorted by order.\n    if (state.headerContents.size > 0) {\n      const contents = Array.from(state.headerContents.values());\n      contents.sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n      config.shell.headerContents = contents;\n    }\n\n    // Toolbar contents: merge ORIGINAL config contents (from the source\n    // gridConfig, not a previous merge) with API-registered contents so stale\n    // API entries never accumulate. Config takes precedence by id.\n    const apiContents = Array.from(state.toolbarContents.values());\n    const originalConfigContents = this.grid?._sourceConfig?.shell?.header?.toolbarContents ?? [];\n    const configIds = new Set(originalConfigContents.map((c) => c.id));\n    const mergedContents = [...originalConfigContents];\n    for (const content of apiContents) {\n      if (!configIds.has(content.id)) {\n        mergedContents.push(content);\n      }\n    }\n    mergedContents.sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n    config.shell.header.toolbarContents = mergedContents;\n  }\n\n  /**\n   * @internal Wrap the freshly built (bare) grid DOM in shell chrome.\n   *\n   * Fired synchronously by core at the end of every structural (re)build, before\n   * paint. Core builds a BARE grid; this hook relocates the existing\n   * `.tbw-grid-content` node into shell chrome (header bar, toolbar, tool panel)\n   * via {@link rebuildShellDOM}, which preserves the content subtree (and all its\n   * listeners / cached refs) intact. No-op when no shell is configured.\n   *\n   * Extraction #370, Task 1b — DOM ownership inversion: the shell DOM is now\n   * constructed by the plugin, not core.\n   */\n  override afterStructuralRender(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    const state = this.shellState;\n    const hasShell = rebuildShellDOM(\n      grid._renderRoot,\n      grid.effectiveConfig?.shell,\n      { isPanelOpen: state.isPanelOpen, expandedSections: state.expandedSections },\n      grid.effectiveConfig?.icons,\n    );\n    if (hasShell) {\n      this.#setupListeners(grid);\n      this.shellController.setInitialized(true);\n      this.#renderShellContents(grid);\n    }\n  }\n\n  /**\n   * @internal Re-anchor an open dropdown tool panel after a NON-structural\n   * render.\n   *\n   * A column-visibility toggle (or reorder) re-renders the grid header WITHOUT\n   * a full structural rebuild — it fires `afterRender`, not\n   * `afterStructuralRender`. When the column-chooser trigger lives in the grid\n   * header (e.g. a custom `[data-panel-toggle]` button in a column\n   * `headerRenderer`), that re-render recreates the trigger node, so it loses\n   * the `anchor-name` that paired it with the open popover. The popover then\n   * collapses to the viewport / grid corner.\n   *\n   * Two cooperating mechanisms keep the popover anchored with NO flash:\n   * 1. A synchronous {@link ShellController.reanchorOpenDropdown} here catches\n   *    the case where the trigger was recreated synchronously during this\n   *    render (in-place re-pair, before paint).\n   * 2. A {@link MutationObserver} (started here, kept running while the panel is\n   *    open) catches the case where an outer framework commits the replacement\n   *    trigger on a LATER task. Its callback runs as a pre-paint microtask, so\n   *    the re-pair lands before the dangling-anchor frame is painted.\n   *\n   * `reanchorOpenDropdown()` is idempotent and cheap (early-returns unless a\n   * dropdown is open with a broken anchor), so running it on every render and\n   * every mutation is safe.\n   */\n  override afterRender(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    const state = this.shellState;\n\n    // In-place shell header title sync (extraction #370 — replaces core's\n    // `#updateShellHeaderInPlace`). Idempotent: only touches the existing\n    // `.tbw-shell-header`, no-op when no shell is rendered.\n    this.#syncShellHeaderTitle(grid);\n\n    // Re-render any open tool-panel sections whose content was cleared during a\n    // plugin re-init (extraction #370 — replaces core's `_renderOpenPanelContent`).\n    // `renderPanelContent` is idempotent — it only fills empty sections.\n    if (state.isPanelOpen) {\n      renderPanelContent(grid._renderRoot, state);\n    }\n\n    // Dropdown re-anchor after a NON-structural render (see method docs below).\n    if (!state.isPanelOpen) {\n      this.#stopReanchorObserver();\n      return;\n    }\n    this.shellController.reanchorOpenDropdown();\n    this.#startReanchorObserver(grid);\n  }\n\n  /**\n   * @internal Sync the shell header title element in place from the effective\n   * config (or parsed light-DOM title) without a full re-render. Extracted from\n   * core's former `#updateShellHeaderInPlace` (#370).\n   */\n  #syncShellHeaderTitle(grid: GridElement): void {\n    const shellHeader = grid._renderRoot.querySelector('.tbw-shell-header');\n    if (!shellHeader) return;\n\n    const title = grid.effectiveConfig?.shell?.header?.title ?? this.shellState.lightDomTitle;\n\n    let titleEl = shellHeader.querySelector('.tbw-shell-title') as HTMLElement | null;\n    if (title) {\n      if (!titleEl) {\n        titleEl = document.createElement('h2');\n        titleEl.className = 'tbw-shell-title';\n        titleEl.setAttribute('part', 'shell-title');\n        shellHeader.insertBefore(titleEl, shellHeader.firstChild);\n      }\n      titleEl.textContent = title;\n    } else if (titleEl) {\n      titleEl.remove();\n    }\n  }\n\n  /** @internal Start (idempotently) the dropdown re-anchor observer. */\n  #startReanchorObserver(grid: GridElement): void {\n    // Only dropdown mode needs the observer. If the mode changed away from\n    // 'dropdown' while the panel is still open, tear down any observer started\n    // by an earlier render instead of leaving it watching the render root.\n    if (grid.effectiveConfig?.shell?.toolPanel?.mode !== 'dropdown') {\n      this.#stopReanchorObserver();\n      return;\n    }\n    if (typeof MutationObserver === 'undefined') return;\n    if (!this.#reanchorObserver) {\n      this.#reanchorObserver = new MutationObserver(() => {\n        if (!this.grid || !this.hasState || !this.shellState.isPanelOpen) {\n          this.#stopReanchorObserver();\n          return;\n        }\n        this.shellController.reanchorOpenDropdown();\n      });\n    }\n    if (!this.#reanchorObserving) {\n      this.#reanchorObserver.observe(grid._renderRoot, { childList: true, subtree: true });\n      this.#reanchorObserving = true;\n    }\n  }\n\n  /** @internal Stop the dropdown re-anchor observer if running. */\n  #stopReanchorObserver(): void {\n    if (this.#reanchorObserver && this.#reanchorObserving) {\n      this.#reanchorObserver.disconnect();\n      this.#reanchorObserving = false;\n    }\n  }\n\n  /**\n   * @internal Render all shell contents into the freshly built shell chrome.\n   *\n   * Runs from {@link afterStructuralRender} after the chrome is wrapped and\n   * listeners are attached. Renders plugin header content + custom toolbar\n   * slots, applies the configured default-open / legacy open-on-load behavior,\n   * and restores an already-open panel's content. All render functions operate\n   * on the shell DOM (queried from `_renderRoot`), not on the grid-body refs,\n   * so they are safe to run before `#afterConnect` caches those.\n   *\n   * Extraction #370, Task 1b (Step 1b.1.3) — replaces core's per-render shell\n   * content block in `#afterConnect` / `#afterShellRefresh`.\n   */\n  #renderShellContents(grid: GridElement): void {\n    const state = this.shellState;\n    const renderRoot = grid._renderRoot;\n    const shellConfig = grid.effectiveConfig?.shell;\n\n    // Render plugin header content + custom toolbar contents (render modes).\n    renderHeaderContent(renderRoot, state);\n    renderCustomToolbarContents(renderRoot, shellConfig, state);\n\n    // Pre-expand the configured default section.\n    const toolPanelCfg = shellConfig?.toolPanel;\n    const defaultOpen = toolPanelCfg?.defaultOpen;\n    if (defaultOpen && state.toolPanels.has(defaultOpen)) {\n      state.expandedSections.add(defaultOpen);\n    }\n\n    // Decide whether the sidebar should be open on load.\n    // `initialState` (or `locked`) is authoritative when set. Otherwise a\n    // `defaultOpen` section implies the sidebar opens on load. See issue #259\n    // for the proposal to split these two concerns.\n    // Search marker: TOOLPANEL-OPEN-259\n    const shouldOpenOnLoad =\n      toolPanelCfg?.locked === true ||\n      toolPanelCfg?.initialState === 'open' ||\n      (toolPanelCfg?.initialState === undefined && defaultOpen !== undefined && state.toolPanels.has(defaultOpen));\n    if (!state.isPanelOpen && state.toolPanels.size > 0 && shouldOpenOnLoad) {\n      this.openToolPanel();\n    }\n\n    // Restore panel content if the panel was already open (e.g. after a position\n    // change re-render or a plugin re-init that triggered a shell refresh).\n    if (state.isPanelOpen) {\n      updatePanelState(renderRoot, state);\n      renderPanelContent(renderRoot, state, {\n        expand: grid.effectiveConfig?.icons?.expand,\n        collapse: grid.effectiveConfig?.icons?.collapse,\n      });\n      updateToolbarActiveStates(renderRoot, state);\n      // In dropdown mode `rebuildShellDOM` created a fresh `.tbw-tool-panel`, so\n      // the popover must be re-shown in the top layer and re-anchored — the\n      // trigger may have been recreated by the same re-render (e.g. a custom\n      // column-header button after a column toggle/reorder). Otherwise the\n      // popover loses its anchor and collapses to the viewport corner.\n      this.shellController.reanchorOpenDropdown();\n    }\n  }\n\n  /**\n   * @internal Attach shell event + dismiss/resize listeners.\n   *\n   * Cleans any prior document-level registrations before re-adding, so it is\n   * safe to call on every re-wrap (initial render, shell refresh, plugin\n   * re-init) without leaking or double-attaching listeners.\n   */\n  #setupListeners(grid: GridElement): void {\n    const renderRoot = grid._renderRoot;\n    const shellConfig = grid.effectiveConfig?.shell;\n    const state = this.shellState;\n\n    setupShellEventListeners(renderRoot, shellConfig, state, {\n      onPanelToggle: () => this.toggleToolPanel(),\n      onSectionToggle: (sectionId: string) => this.toggleToolPanelSection(sectionId),\n      onPanelClose: () => this.closeToolPanel(),\n    });\n\n    // Tool panel resize handle — persists the new width as a CSS variable on\n    // the host element.\n    this.#resizeCleanup?.();\n    this.#resizeCleanup = setupToolPanelResize(renderRoot, shellConfig, (width: number) => {\n      grid._hostElement.style.setProperty('--tbw-tool-panel-width', `${width}px`);\n    });\n\n    // Click-outside dismiss for an open overlay tool panel.\n    this.#clickOutsideCleanup?.();\n    this.#clickOutsideCleanup = setupClickOutsideDismiss(grid._hostElement, shellConfig, state, () =>\n      this.closeToolPanel(),\n    );\n\n    // Escape-to-close dismiss for overlay tool panels.\n    this.#escapeDismissCleanup?.();\n    this.#escapeDismissCleanup = setupEscapeDismiss(shellConfig, state, () => this.closeToolPanel());\n  }\n\n  /** @internal Remove the document-level shell listeners. */\n  #teardownListeners(): void {\n    this.#resizeCleanup?.();\n    this.#resizeCleanup = undefined;\n    this.#clickOutsideCleanup?.();\n    this.#clickOutsideCleanup = undefined;\n    this.#escapeDismissCleanup?.();\n    this.#escapeDismissCleanup = undefined;\n  }\n\n  /** @internal */\n  override detach(): void {\n    // Non-destructive detach (Approach A): shell state and document listeners\n    // survive plugin re-inits. `#setupListeners` cleans-before-add on the next\n    // re-wrap, so there is nothing to tear down here. Real teardown happens in\n    // `disposeShellState()` on grid disconnect.\n    super.detach();\n  }\n\n  /**\n   * @internal Tear down shell state on grid disconnect (Approach A).\n   * Idempotent and harmless when no state exists.\n   */\n  disposeShellState(): void {\n    this.#teardownListeners();\n    this.#stopReanchorObserver();\n    this.#reanchorObserver = undefined;\n    // Unregister the light-DOM shell handlers (registered in `attach`). `detach`\n    // does not clear `this.grid`, so the reference is still valid here.\n    const grid = this.grid as GridElement | undefined;\n    if (grid && this.#shellChangeHandler) {\n      grid._unregisterLightDomHandler('tbw-grid-header');\n      grid._unregisterLightDomHandler('tbw-grid-tool-buttons');\n      grid._unregisterLightDomHandler('tbw-grid-tool-panel');\n      this.#shellChangeHandler = undefined;\n    }\n    if (this.#state) {\n      cleanupShellState(this.#state);\n      this.#controller?.setInitialized(false);\n    }\n  }\n}\n"],"mappings":"AA+BA,SAAgB,EAAW,EAAiB,GAG1C,MAAO,YAFI,EAAS,IAAI,IAAW,KACpB,EAAa,IAAI,IAAe,KAEjD,CAqDA,IAsCa,EAAuB,SAEvB,EAAuB,SAEvB,EAA2B,SA8HxC,SAAgB,EAAiB,EAAsB,EAAiB,EAAiB,GAEvF,MAAO,GADQ,EAAW,EAAQ,MACd,MAAS,uBApB/B,SAAiB,GACf,MAAO,qCAAgB,EAAK,eAC9B,CAkB4D,CAAQ,IACpE,CAkBA,SAAgB,EAAe,EAAsB,EAAiB,EAAiB,GACrF,QAAQ,KAAK,EAAiB,EAAM,EAAS,EAAQ,GACvD,CC/NA,IAAa,EAA0C,CACrD,OAAQ,IACR,SAAU,IACV,QAAS,IACT,SAAU,IACV,SAAU,IACV,aAAc,IACd,WAAY,KACZ,UAAW,IACX,OAAQ,GACR,aAAc,GACd,MAAO,OCtDH,EACJ,4SACG,MAAM,KACN,IAAK,GAAM,EAAE,MAAM,IAAI,UAAU,KAAK,KA2BrC,GA1BY,IAAI,OAAO,uCAAuC,EAAG,MAAM,GAAG,KAAK,gBA0B9D,IAAI,IACzB,2KAA2K,MACzK,OAOE,EAAyB,WAKzB,EAAY,IAAI,IAAI,kEAAkE,MAAM,MAK5F,EAAyB,wCA8D/B,SAAgB,EAAiB,EAAa,GACvC,GAAwB,iBAAT,GAKM,IAAtB,EAAK,QAAQ,OAAqC,IAAtB,EAAK,QAAQ,KAI7C,EAAG,gBAlCL,SAAmC,GACjC,MAAM,EAAW,SAAS,cAAc,YAKxC,OAJI,GAAwB,iBAAT,IACjB,EAAS,UAAY,EACrB,EAAa,EAAS,UAEjB,EAAS,OAClB,CA2BqB,CAAmB,IAHpC,EAAG,YAAc,EALjB,EAAG,iBASP,CAKA,SAAS,EAAa,GACpB,MAAM,EAAsB,GAGtB,EAAW,EAAK,iBAAiB,KAEvC,IAAK,MAAM,KAAM,EAAU,CACzB,MAAM,EAAU,EAAG,QAAQ,cAG3B,GAAI,EAAe,IAAI,GAAU,CAC/B,EAAS,KAAK,GACd,QACF,CAGA,IAAgB,QAAZ,GAAyC,+BAApB,EAAG,eAEE,MAAM,KAAK,EAAG,YAAY,KACnD,GAAS,EAAuB,KAAK,EAAK,OAAuB,SAAd,EAAK,MAAiC,eAAd,EAAK,MAE1D,CACvB,EAAS,KAAK,GACd,QACF,CAIF,MAAM,EAA0B,GAChC,IAAK,MAAM,KAAQ,EAAG,WAAY,CAChC,MAAM,EAAW,EAAK,KAAK,cAGvB,EAAuB,KAAK,GAC9B,EAAc,KAAK,EAAK,MAMT,OAAb,GAMA,EAAU,IAAI,IAAa,EAAuB,KAAK,EAAK,QAM/C,UAAb,GAAwB,4CAA4C,KAAK,EAAK,SALhF,EAAc,KAAK,EAAK,MANxB,EAAc,KAAK,EAAK,KAe5B,CAEA,EAAc,QAAS,GAAS,EAAG,gBAAgB,GACrD,CAGA,EAAS,QAAS,GAAO,EAAG,SAC9B,CCqPA,IAAsB,EAAtB,MAiBE,oBAuBA,gBAUA,QAMA,QAAA,QAGA,OAGA,cAGA,gBAGA,YAGA,KAGA,OAGA,WAOA,GAOA,iBAAc,GACZ,MAAO,CAAC,CACV,CAEA,WAAA,CAAY,EAA2B,CAAC,GACtC,KAAK,WAAa,CACpB,CAgBA,kBAAI,GACF,OAAQ,MAAK,EAAmB,KAAK,OAAS,IAAK,KAAK,iBAAkB,KAAK,WACjF,CAuBA,gBAAA,CAAiB,GACf,GAAsB,IAAlB,EAAO,OAAc,OACzB,MAAM,EAAS,IAAK,KAAK,YACnB,EAAmD,CAAC,EAC1D,IAAK,MAAM,KAAO,OAAO,KAAK,GAAS,EAAQ,GAAO,KACtD,IAAK,MAAM,KAAS,EAAQ,CAC1B,MAAM,EAAc,EAAM,WAC1B,IAAK,MAAO,EAAK,KAAU,OAAO,QAAQ,GAAc,CACtD,QAAc,IAAV,EAAqB,SACzB,KAAM,KAAO,GAAS,CACpB,EAAO,GAAO,EACd,EAAQ,GAAO,EACf,QACF,CACA,GAAI,EAAO,KAAS,EAAO,SAE3B,MAAM,EAAS,EAAQ,IAAM,YAAY,MAAQ,KAAK,YAAY,KAC5D,EAAS,EAAM,YAAY,KAC3B,EAAO,EHpgBuB,SGsgBlC,oCAAoC,KAAK,iCAAiC,uBAAyB,SAAc,yEACjH,EACA,KAAK,MAEP,MAAM,IAAI,MAAM,EAClB,CACF,CAMA,OAAO,OAAO,KAAK,WAAuC,EAC5D,CAiBA,qBAAA,CAAsB,GACpB,MAAM,EAAS,KAAK,WASd,EAAS,IAAM,EAAM,YAC3B,IAAK,MAAM,KAAO,OAAO,KAAK,UAAgB,EAAO,GACrD,OAAO,OAAO,EAAQ,EACxB,CAiBA,MAAA,CAAO,GAEL,MAAK,GAAkB,QAEvB,MAAK,EAAmB,IAAI,gBAE5B,KAAK,KAAO,EAEZ,KAAK,OAAS,IAAK,KAAK,iBAAkB,KAAK,WACjD,CAeA,MAAA,GAGE,MAAK,GAAkB,QACvB,MAAK,OAAmB,CAE1B,CAwDA,SAAA,CAA8C,GAC5C,OAAO,KAAK,MAAM,UAAU,EAC9B,CAKA,IAAA,CAAkB,EAAmB,GACnC,KAAK,MAAM,gBAAgB,IAAI,YAAY,EAAW,CAAE,SAAQ,SAAS,IAC3E,CAMA,cAAA,CAA4B,EAAmB,GAC7C,MAAM,EAAQ,IAAI,YAAY,EAAW,CAAE,SAAQ,SAAS,EAAM,YAAY,IAE9E,OADA,KAAK,MAAM,gBAAgB,GACpB,EAAM,gBACf,CAsBA,EAAA,CAA0B,EAAmB,GAC3C,KAAK,MAAM,gBAAgB,UAAU,KAAM,EAAW,EACxD,CAaA,GAAA,CAAc,GACZ,KAAK,MAAM,gBAAgB,YAAY,KAAM,EAC/C,CAoBA,eAAA,CAA6B,EAAmB,GAC9C,KAAK,MAAM,gBAAgB,gBAAgB,EAAW,EACxD,CAoBA,SAAA,CAAuB,EAAmB,GACxC,KAAK,gBAAgB,EAAW,GAChC,KAAK,KAAK,EAAW,EACvB,CAwBA,YAAA,CAAuB,EAAc,EAAmB,MACtD,MAAM,EAAY,KAAK,MAAM,QAAQ,EAAM,GAE3C,OAAO,MAAM,QAAQ,GAAa,EAAU,KAAK,WAAa,CAChE,CAMA,aAAA,GACE,KAAK,MAAM,iBACb,CAOA,oBAAA,GACE,KAAM,MAAgD,wBACxD,CAOA,sBAAA,GACE,KAAK,MAAM,0BACb,CAMA,kBAAA,GACE,KAAK,MAAM,sBACb,CAOA,qBAAA,GACE,KAAK,MAAM,yBACb,CAKA,QAAc,GACZ,OAAO,KAAK,MAAM,MAAQ,EAC5B,CAMA,cAAc,GACZ,OAAO,KAAK,MAAM,YAAc,EAClC,CAKA,WAAc,GACZ,OAAO,KAAK,MAAM,SAAW,EAC/B,CAMA,kBAAc,GACZ,OAAO,KAAK,MAAM,iBAAmB,EACvC,CAYA,eAAc,GACZ,OAAO,KAAK,MAAM,YACpB,CAmBA,oBAAc,GAGZ,OAAO,MAAK,GAAkB,QAAU,KAAK,MAAM,gBACrD,CAMA,aAAc,GACZ,MAAM,EAAY,KAAK,MAAM,YAAY,OAAS,CAAC,EACnD,MAAO,IAAK,KAAuB,EACrC,CAkBA,CAAA,CAAY,EAAa,GACvB,OAAO,KAAK,MAAM,iBAAiB,SAAS,IAAQ,CACtD,CAOA,aAAc,GACZ,MAAA,CAAQ,EAAK,IAAa,KAAK,EAAE,EAAK,EACxC,CAoBA,sBAAc,GACZ,MAAM,EAAO,KAAK,MAAM,iBAAiB,WAAW,MAAQ,iBAG5D,IAAa,IAAT,GAA2B,QAAT,EAAgB,OAAO,EAG7C,IAAa,IAAT,GAA0B,OAAT,EAAe,OAAO,EAG3C,MAAM,EAAO,KAAK,YAClB,OAAI,GAEiB,MADH,iBAAiB,GAAM,iBAAiB,2BAA2B,MAKvF,CAcA,qBAAc,GACZ,MAAM,EAAO,KAAK,YAClB,GAAI,EAAM,CACR,MAAM,EAAc,iBAAiB,GAAM,iBAAiB,4BAA4B,OAClF,EAAS,SAAS,EAAa,IACrC,IAAK,MAAM,GAAS,OAAO,CAC7B,CACA,OAAO,GACT,CAgBA,OAAA,CAAkB,EAAsB,EAA0B,GAEhE,EAAQ,QAAQ,KAAkB,EA9pBzB,QAAQ,WAAY,OAAO,cAiqBpB,aAAZ,EACF,EAAQ,QAAQ,SAAW,GACN,WAAZ,UACF,EAAQ,QAAQ,SAIzB,MAAM,EAAS,MAAK,EAAe,EAAS,QAE7B,IAAX,EAEoB,iBAAX,EACT,EAAiB,EAAS,GACjB,aAAkB,aAC3B,EAAQ,gBAAgB,EAAO,WAAU,IAI3C,EAAQ,UAAY,EAExB,CAOA,EAAA,CAAe,EAA0B,GACvC,YAAuB,IAAnB,EAAqC,EAClC,KAAK,MAAM,YAAY,QAAQ,EACxC,CAgBA,mBAAA,CAA8B,EAAe,GAE3C,EAAK,cAAc,8CAA8C,SAEjE,MAAM,EAAY,SAAS,cAAc,QACzC,EAAU,aAAa,OAAQ,kBAC/B,EAAU,UAAY,iBAElB,GACF,EAAK,aAAa,YAA2B,QAAd,EAAsB,YAAc,cACnE,EAAK,aAAa,YAAa,GAC/B,KAAK,QAAQ,EAAyB,QAAd,EAAsB,UAAY,cAE1D,EAAK,aAAa,YAAa,QAC/B,EAAK,gBAAgB,aACrB,KAAK,QAAQ,EAAW,aAI1B,MAAM,EAAe,EAAK,cAAc,oBAAsB,EAAK,cAAc,kBAOjF,OANI,EACF,EAAK,aAAa,EAAW,GAE7B,EAAK,YAAY,GAGZ,CACT,CAgBA,IAAA,CAAe,EAAwC,QACrC,IAAZ,EAEF,QAAQ,KAAK,EAAiB,EAAiC,EAAS,KAAK,YAAY,GAAI,KAAK,OAGlG,QAAQ,KAAK,GAAG,EAAW,KAAK,YAAY,GAAI,KAAK,SAAS,IAElE,CAMA,eAAA,CAA0B,EAAsB,GAC9C,MAAM,IAAI,MAAM,EAAiB,EAAM,EAAS,KAAK,YAAY,GAAI,KAAK,MAC5E,GCzjCI,iBAAkB,IAAI,QAyC5B,SAAgB,EACd,EACA,EACA,EACA,GAEA,MAAM,OAAE,EAAA,MAAQ,EAAA,SAAO,EAAA,UAAU,GAAc,EACzC,EAAY,GAAS,WAAa,EAClC,EAAoB,GAAS,mBAAqB,EAClD,EAAgB,GAAS,eAAiB,EAC1C,EAAY,EAAW,UAG7B,IApDF,SAAuB,EAAa,GAClC,IAAI,EAAM,EAAgB,IAAI,GAK9B,OAJK,IACH,iBAAM,IAAI,IACV,EAAgB,IAAI,EAAI,KAEtB,EAAI,IAAI,KACZ,EAAI,IAAI,IACD,EACT,CA2CO,CAAc,EAAe,GAEhC,MAAA,OAGF,MAAM,EAAS,EAAW,QACpB,EAAS,EAAW,QAG1B,IAAI,EAAyB,IAAd,GAAyC,IAAtB,EAC9B,GAAO,EACP,EAAuD,KACvD,GAAgB,EA+BpB,SAAS,IAEP,OADA,GAAW,EAjBb,WACE,IAEE,OADA,EAAc,kBAAkB,IACzB,CACT,CAAA,MAOE,OADA,GAAgB,GACT,CACT,CACF,CAKO,IAIL,OACO,IAJL,KACO,EAIX,CAEA,SAAS,IACP,IAAI,EAAJ,CA/FJ,IAAyB,EAAa,EAgGlC,GAAO,EACgB,OAAnB,IACF,aAAa,GACb,EAAiB,MAEnB,EAAc,oBAAoB,cAAe,GACjD,EAAc,oBAAoB,YAAa,GAC/C,EAAc,oBAAoB,gBAAiB,GACnD,EAAc,oBAAoB,qBAAsB,GACxD,SAAS,oBAAoB,UAAW,GAAa,GAzGhC,EA0GL,EA1GkB,EA0GH,EAzGjC,EAAgB,IAAI,IAAK,OAAO,GA0G9B,IACM,EAAc,kBAAkB,IAClC,EAAc,sBAAsB,EAExC,CAAA,MAEA,CAlBU,CAmBZ,CAEA,SAAS,IACH,IACJ,IACA,MACF,CAMA,SAAS,EAAc,GACrB,MAAM,EAAI,EACV,GAAI,EAAE,YAAc,GAAa,EAAM,OAEvC,MAAM,EAAK,EAAE,QAAU,EACjB,EAAK,EAAE,QAAU,EACjB,EAAO,KAAK,KAAK,EAAK,EAAK,EAAK,GAEtC,IAAK,EAAU,CACb,GAAI,EAAoB,EAEtB,OAAI,EAAO,OACT,SAIF,EAGF,GAAI,EAAY,GAAK,EAAO,EAAW,OACvC,IAAK,IAAW,MAClB,CAEA,EAAO,EACT,CAEA,SAAS,EAAY,GACnB,MAAM,EAAI,EACV,GAAI,EAAE,YAAc,GAAa,EAAM,OACvC,MAAM,EAAc,EACpB,IACI,EACF,EAAM,GAEN,KAEJ,CAEA,SAAS,EAAgB,GAEnB,EAAE,YAAc,GAAa,GACjC,GACF,CAEA,SAAS,EAAc,GAEjB,EAAE,YAAc,GAAa,GACjC,GACF,CAEA,SAAS,EAAY,GAEL,WAAV,EAAE,KAAqB,GAAM,GACnC,CAYA,OAPA,EAAc,iBAAiB,cAAe,GAC9C,EAAc,iBAAiB,YAAa,GAC5C,EAAc,iBAAiB,gBAAiB,GAChD,EAAc,iBAAiB,qBAAsB,GACrD,SAAS,iBAAiB,UAAW,GAAa,GAG9C,IACF,IAEI,GAAe,QAIjB,EAAoB,IACtB,EAAiB,WAAA,KACf,EAAiB,KACb,GACJ,KACC,IAGE,EACT,CCxUA,SAAS,IACP,MAAqD,mBAAvC,YAAY,WAAW,WACvC,CA0CA,SAAS,EAAO,EAAe,GAC7B,MAAM,EAAK,SAAS,cAAc,UAKlC,OAJA,EAAG,KAAO,SACV,EAAG,UAAY,uBACf,EAAG,aAAa,aAAc,GAC9B,EAAG,YAAc,EACV,CACT,CAEA,SAAgB,EAAqB,GACnC,MAAM,EAAO,EAAQ,MA5DC,GA6DtB,IAGI,EAHA,EAA8B,KAC9B,EAAiC,KACjC,EAA+B,KAE/B,GAAS,EACT,GAAW,EACf,MAAM,EAAQ,IAAI,gBAElB,SAAS,IACF,GAAW,IAChB,GAAS,EACL,KAAmB,EAAK,cAC5B,EAAK,QAAS,EACd,GAAU,gBAAgB,sBAC1B,EAAW,KACb,CAEA,SAAS,IACH,IAAO,EAAM,MAAQ,OAAO,KAAK,MAAM,EAAQ,QAAQ,KAC7D,CAEA,SAAS,EAAM,GACR,OAAO,SAAS,KACrB,EAAQ,QAAQ,EAAQ,GACxB,IACF,CAsGA,OAfA,SAAS,iBACP,cACC,IACK,GAAU,IAAS,EAAE,eAAe,SAAS,IAAO,KAE1D,CAAE,SAAS,EAAM,OAAQ,EAAM,SAEjC,SAAS,iBACP,UACC,IACkC,WAA5B,EAAoB,KAAkB,KAE7C,CAAE,SAAS,EAAM,OAAQ,EAAM,SAG1B,CACL,WAAI,GACF,OAAO,CACT,EACA,IAAA,CAAK,EAAM,GACT,GAAI,EAAU,OACd,EAAS,EACT,GAAU,gBAAgB,sBAC1B,EAAW,EACX,EAAO,aAAa,qBAAsB,IACrC,IAAM,EA9Gf,WACE,MAAM,EAAK,SAAS,cAAc,OAClC,EAAG,GAAK,EAAQ,GAChB,EAAG,UAAY,mBACf,EAAG,aAAa,UAAW,UAC3B,EAAG,aAAa,OAAQ,SAExB,EAAG,QAAS,EAEZ,MAAM,EAAQ,EAAO,WAAY,KAC3B,EAAO,EAAO,QAAS,KACvB,EAAQ,EAAO,aAAc,SAE7B,EAAQ,SAAS,cAAc,SAoCrC,OAnCA,EAAM,KAAO,SACb,EAAM,UAAY,yBAClB,EAAM,IAAM,IAIZ,EAAM,KAAO,MACb,EAAM,aAAa,aAAc,kBAEjC,EAAM,iBAAiB,QAAA,IAAe,EAAM,EAAQ,QAAQ,GAAU,GAAO,CAAE,OAAQ,EAAM,SAC7F,EAAK,iBAAiB,QAAA,IAAe,EAAM,EAAQ,QAAQ,GAAU,GAAO,CAAE,OAAQ,EAAM,SAC5F,EAAM,iBACJ,QAAA,KAEE,EAAQ,MAAM,GACd,KAEF,CAAE,OAAQ,EAAM,SAElB,EAAM,iBAAiB,SAAA,IAAgB,EAAM,EAAM,eAAgB,CAAE,OAAQ,EAAM,SAKnF,EAAG,iBACD,WACC,IACC,MAAM,EAAQ,EAAiB,cAC3B,aAAgB,OAAS,EAAG,SAAS,IAAO,KAElD,CAAE,OAAQ,EAAM,SAGlB,EAAG,OAAO,EAAO,EAAO,EAAM,GAC9B,EAAQ,EACD,CACT,CA4DsB,IAClB,MAAM,EAAO,EAAQ,QAAQ,IAAS,SAAS,KAC3C,EAAK,aAAe,GAAM,EAAK,YAAY,GAC/C,EAAK,aAAa,aAAc,EAAQ,SAAS,IACjD,IACA,EAAK,QAAS,GACT,GAAU,KAAmB,EAAK,cACvC,GAAS,EAvDb,SAAe,GACb,IAAK,EAAM,OACX,MAAM,EAAI,EAAO,wBACX,EAAM,EAAK,wBACX,EAAA,CAAS,EAAW,IAAgB,KAAK,IAAI,EAAG,KAAK,IAAI,EAAG,EAAM,IAClE,EAAO,EAAM,EAAE,KAAO,EAAE,MAAQ,EAAI,EAAI,MAAQ,EAAG,OAAO,WAAa,EAAI,OAI3E,EAAQ,EAAE,OA5JE,EA6JZ,EAAQ,EAAE,IA7JE,EA6JoB,EAAI,OACpC,EAAO,EAAE,OAAsB,EAAb,EAAI,OAC5B,IAAI,EACmD,GAAlD,GAAQ,EAAQ,EAAI,QAAU,OAAO,YAAmB,GACnD,GAAQ,GAAS,EAAS,EACzB,EAAM,EAAE,IAAM,EAAE,OAAS,EAAI,EAAI,OAAS,EAAG,OAAO,YAAc,EAAI,QAEjF,EAAK,MAAM,KAAO,GAAG,KAAK,MAAM,OAChC,EAAK,MAAM,IAAM,GAAG,KAAK,MAAM,MACjC,CAqCI,CAAM,GACN,GAAO,OACT,EACA,QACA,OAAA,GACE,GAAW,EACX,IACA,EAAM,QACN,GAAM,SACN,EAAO,KACP,EAAQ,IACV,EAEJ,CC5MA,IAAa,EAEL,gBCnBR,SAAS,EAAW,EAAa,GAC/B,GAAK,EACL,IAAK,MAAM,KAAO,EAAO,CACvB,MAAM,EAAQ,EAAM,GACP,MAAT,GAAe,EAAG,aAAa,EAAK,EAC1C,CACF,CAMA,SAAS,EACP,EACA,EACA,GAEA,MAAM,EAAK,SAAS,cAAc,GAGlC,GAFA,EAAW,EAAI,GAEX,EACF,IAAK,MAAM,KAAS,EACL,MAAT,IACiB,iBAAV,EACT,EAAG,YAAY,SAAS,eAAe,IAEvC,EAAG,YAAY,IAKrB,OAAO,CACT,CAKA,SAAS,EAAI,EAAoB,GAC/B,MAAM,EAAK,SAAS,cAAc,OAGlC,OAFI,IAAW,EAAG,UAAY,GAC9B,EAAW,EAAI,GACR,CACT,CAOA,SAAS,EAAO,EAAoB,EAAgC,GAClE,MAAM,EAAK,SAAS,cAAc,UAWlC,OAVA,EAAG,KAAO,SACN,IAAW,EAAG,UAAY,GAC9B,EAAW,EAAI,GACX,IACqB,iBAAZ,EACT,EAAG,YAAc,EAEjB,EAAG,YAAY,IAGZ,CACT,CAQA,IAAM,EAAsB,SAAS,cAAc,YA0BnD,SAAgB,IACd,OAAO,EAAoB,QAAQ,WAAU,EAC/C,CAoBA,SAAgB,EAAa,GAC3B,MAAM,EAAW,SAAS,yBAEpB,EAAO,EAAI,EAAQ,SAAW,GAAG,cAA+B,GAEtE,GAAI,EAAQ,UAAY,EAAQ,UAI1B,EAAQ,aAAa,EAAK,YAAY,EAAQ,aAClD,EAAK,YAAY,EAAQ,eACpB,CAEL,MAAM,EAAiB,EAAI,oBAC3B,EAAe,YAAY,KAC3B,EAAK,YAAY,EACnB,CAGA,OADA,EAAS,YAAY,GACd,CACT,CAyEA,SAAgB,EAAiB,GAC/B,MAAM,EAAS,EAAI,mBAAoB,CAAE,KAAM,eAAgB,KAAM,iBAGrE,GAAI,EAAQ,MAAO,CACjB,MAAM,EAAU,EAAI,mBACpB,EAAQ,YAAc,EAAQ,MAC9B,EAAO,YAAY,EACrB,CAGA,MAAM,EAAU,EAAI,oBAAqB,CACvC,KAAM,gBACN,KAAM,eACN,gCAAiC,KAEnC,EAAO,YAAY,GAGnB,MAAM,EAAU,EAAI,oBAAqB,CAAE,KAAM,gBAAiB,KAAM,iBAGxE,IAAK,MAAM,KAAO,EAAQ,cACpB,EAAI,WACN,EAAQ,YAAY,EAAI,2BAA4B,CAAE,uBAAwB,EAAI,MAItF,IAAK,MAAM,KAAO,EAAQ,WACpB,EAAI,WACN,EAAQ,YAAY,EAAI,2BAA4B,CAAE,uBAAwB,EAAI,MAKtF,MAAM,EACJ,EAAQ,cAAc,KAAM,GAAM,EAAE,YAAc,EAAQ,WAAW,KAAM,GAAM,EAAE,WAG/E,EAAa,EAAQ,YAAoC,IAAvB,EAAQ,WAMhD,GALI,GAAoB,GACtB,EAAQ,YAAY,EAAI,0BAItB,EAAY,CACd,MAAM,EAAY,EAAO,EAAQ,YAAc,yBAA2B,kBAAmB,CAC3F,oBAAqB,GACrB,MAAO,WACP,aAAc,wBACd,eAAgB,OAAO,EAAQ,aAC/B,gBAAiB,mBAEnB,EAAU,QAAQ,KAAO,kBACK,IAA1B,EAAQ,eACV,EAAiB,EAAW,EAAQ,eAEtC,EAAQ,YAAY,EACtB,CAGA,OADA,EAAO,YAAY,GACZ,CACT,CAsCA,SAAS,EAAsB,GAC7B,MAAM,EAAW,EAAO,EAAS,oDAAsD,uBAAwB,CAC7G,KAAM,mBACN,mBAAoB,GACpB,MAAO,cACP,aAAc,cACd,gBAAiB,mBAGnB,OADA,EAAS,YAAc,IAChB,CACT,CAGA,SAAS,IACP,MAAM,EAAc,EAAI,wBAAyB,CAAE,KAAM,sBAEzD,OADA,EAAY,YAAY,GAAsB,IACvC,CACT,CAqCA,SAAS,EACP,EACA,EACA,EACA,GAMA,MAAM,IAAiB,EAAM,QAAU,EAEjC,EAAiB,GAAe,EAEhC,EAAU,EAAI,wBAD2B,EAAM,WAAa,YAAc,KAAK,EAAgB,UAAY,KAAK,EAAiB,oBAAsB,KACzH,CAAE,eAAgB,EAAM,KAE5D,GAAI,EAAc,CAChB,MAAM,EAnDV,SACE,EACA,EACA,GAEA,MAAM,EAAY,EAAO,uBAAwB,CAC/C,gBAAiB,OAAO,EAAM,YAC9B,gBAAiB,eAAe,EAAM,OAIxC,GAFI,GAAe,EAAU,aAAa,gBAAiB,QAEvD,EAAM,KAAM,CACd,MAAM,EAAW,EAAc,OAAQ,CAAE,MAAO,uBAChD,EAAiB,EAAU,EAAM,MACjC,EAAU,YAAY,EACxB,CAGA,MAAM,EAAY,EAAc,OAAQ,CAAE,MAAO,wBAKjD,GAJA,EAAU,YAAc,EAAM,OAAS,GACvC,EAAU,YAAY,IAGjB,EAAe,CAClB,MAAM,EAAc,EAAc,OAAQ,CAAE,MAAO,wBAAyB,YAAa,gBAC9D,IAAvB,EAAQ,YACV,EAAiB,EAAa,EAAQ,YAExC,EAAU,YAAY,EACxB,CACA,OAAO,CACT,CAoBsB,CAAqB,EAAO,EAAS,GACvD,GAAI,EAAgB,CAElB,MAAM,EAAY,EAAI,4BACtB,EAAU,YAAY,GACtB,EAAU,YAAY,GAAsB,IAC5C,EAAQ,YAAY,EACtB,MACE,EAAQ,YAAY,EAExB,MAAW,GAGT,EAAQ,YAAY,KAUtB,OANA,EAAQ,YACN,EAAI,wBAAyB,CAC3B,GAAI,eAAe,EAAM,KACzB,KAAM,kBAGH,CACT,CAqDA,SAAgB,EAAe,GAC7B,MAAM,EAAO,EAAQ,MAAQ,UACvB,EAAO,EAAI,iBAAkB,CAAE,YAAa,IAG5C,EAAc,EAAI,oBACxB,EAAY,YAAY,KAExB,MAAM,EAAU,EAAQ,OAAO,OAAS,EA1D1C,SAAwB,EAA2B,GACjD,MAAM,EAA0C,IAA1B,EAAQ,OAAO,OAC/B,EAAU,EAAc,QAAS,CACrC,MAAO,EAAQ,YAAc,sBAAwB,iBACrD,KAAM,aACN,gBAAiB,EAAQ,SACzB,KAAM,eACN,GAAI,oBAGS,aAAT,EAAsB,CAAE,QAAS,UAAa,CAAC,IAIrD,EAAQ,YACN,EAAI,wBAAyB,CAC3B,qBAAsB,GACtB,uBAA6C,SAArB,EAAQ,SAAsB,QAAU,OAChE,KAAM,SACN,SAAU,KACV,aAAc,yDAYlB,MAAM,GAA0C,IAA5B,EAAQ,iBAA4B,EACpD,EAAQ,kBAAoB,GAC9B,EAAQ,YAAY,KAGtB,MAAM,EAAe,EAAI,yBAA0B,CAAE,KAAM,iBACrD,EAAY,EAAI,iBACtB,IAAK,MAAM,KAAS,EAAQ,OAC1B,EAAU,YAAY,EAAsB,EAAO,EAAS,EAAe,IAI7E,OAFA,EAAa,YAAY,GACzB,EAAQ,YAAY,GACb,CACT,CAa8C,CAAe,EAAS,GAAQ,KAW5E,MARyB,SAArB,EAAQ,UAAuB,GACjC,EAAK,YAAY,GACjB,EAAK,YAAY,KAEjB,EAAK,YAAY,GACb,GAAS,EAAK,YAAY,IAGzB,CACT,CAxZA,EAAoB,UAAY,0nBCnEhC,SAAS,EAAa,GACpB,OAAK,EACe,iBAAT,ENoDb,SAA6B,GAC3B,IAAK,GAAwB,iBAAT,EAAmB,MAAO,GAG9C,IAA0B,IAAtB,EAAK,QAAQ,KAAa,OAAO,EAErC,MAAM,EAAW,SAAS,cAAc,YAKxC,OAJA,EAAS,UAAY,EAErB,EAAa,EAAS,SAEf,EAAS,SAClB,CMhEuC,CAAa,GAE3C,EAAK,UAHM,EAIpB,CAqGA,SAAgB,EAAwB,GAEtC,QAAI,GAAQ,QAAQ,UAGhB,GAAQ,QAAQ,iBAAiB,WAGjC,GAAQ,YAAY,WAGpB,GAAQ,gBAAgB,WAGxB,GAAQ,QAAQ,iBAAiB,UAGjC,GAAQ,QAAQ,2BAGtB,CAYA,SAAgB,EAAsB,GACpC,OAAmC,IAA5B,GAAQ,QAAQ,OACzB,CAggBA,SAAS,EAAS,EAAY,GAC5B,GAAI,EAAY,SAAS,GAAO,OAAO,EACvC,MAAM,EAAO,EAAK,cAClB,OAAO,aAAgB,YAAc,EAAK,OAAS,CACrD,CA8GA,SAAgB,EACd,EACA,EACA,GAEA,MAAM,EAAQ,EAAW,cAAc,mBACjC,EAAS,EAAW,cAAc,wBAClC,EAAY,EAAW,cAAc,mBAC3C,IAAK,IAAU,IAAW,EAExB,MAAA,OAGF,MAAM,EAAW,GAAQ,WAAW,UAAY,QAGhD,IAAI,EAAS,EACT,EAAa,EACb,EAAW,EACX,GAAa,EACb,GAAQ,EACR,EAAkC,KAClC,EAA+C,KAEnD,MAAM,EAAA,IAAqB,EAAU,wBAAwB,MAAQ,GAuB/D,EAAU,IACd,IAAK,EAAY,OACjB,EAAE,iBACF,GAAQ,EAIR,MAAM,EAAqB,SAAb,EAAsB,EAAE,QAAU,EAAS,EAAS,EAAE,QAC9D,EAAW,KAAK,IAAI,EAAU,KAAK,IAzC1B,IAyCwC,EAAa,IAEpE,EAAM,MAAM,MAAQ,GAAG,OAQnB,EAAU,IACd,GAAK,IACL,GAAa,EACb,EAAa,KACb,EAAO,UAAU,OAAO,YACxB,EAAM,MAAM,WAAa,GACzB,SAAS,KAAK,MAAM,OAAS,GAC7B,SAAS,KAAK,MAAM,WAAa,GAE7B,GAAQ,CAEV,MAAM,EAAa,EAAM,wBAAwB,MACjD,EAAS,EACX,GAGI,EAAiB,IACjB,GAGa,IAAb,EAAE,QAAkC,UAAlB,EAAE,cACxB,EAAE,iBACF,GAAa,EACb,GAAQ,EACR,EAAS,EAAE,QACX,EAAa,EAAM,wBAAwB,MAE3C,EAAW,IACX,EAAO,UAAU,IAAI,YACrB,EAAM,MAAM,WAAa,OACzB,SAAS,KAAK,MAAM,OAAS,aAC7B,SAAS,KAAK,MAAM,WAAa,OAEjC,EAAa,EAAiB,EAAG,EAAQ,CACvC,SACA,MAAA,KAGE,MAAM,GAAU,EAChB,GAAQ,GACJ,IA9ER,IAAgB,EAA+B,CAC7C,GAAI,+BACJ,KAjyBiB,GAkyBjB,QAAU,GAAO,EAAG,wBAAwB,MAE5C,QAAA,CAAU,EAAI,KACZ,MAAM,EAAU,KAAK,IAAI,IAAgB,KAAK,IAnBnC,IAmBiD,IAC5D,EAAG,MAAM,MAAQ,GAAG,MACpB,EAAS,IAEX,MAAQ,IACN,EAAG,MAAM,MAAQ,GACjB,EAAS,EAAG,wBAAwB,QAEtC,SAAA,IAAgB,mBAChB,QAAU,GAAO,EAAG,QAAqB,+BAE3C,EAAY,KAAK,EAAO,KA+DtB,SAAA,KAEE,EAAM,MAAM,MAAQ,GAAG,MACvB,GAAO,QAQb,OAHA,EAAO,iBAAiB,cAAe,GAGvC,KACE,EAAO,oBAAoB,cAAe,GAC1C,MACA,EAAa,KACb,GAAa,UACb,EAAc,KAElB,CA4CA,SAAgB,EAAoB,EAAqB,GAEvD,MAAM,EAAqB,EAAM,sBAAsB,OAAS,IAAM,EAAM,qBACtE,EAAmB,EAAM,eAAe,KAAO,EACrD,IAAK,IAAuB,EAAkB,OAE9C,MAAM,EAAc,EAAW,cAAc,sBAC7C,IAAK,EAAa,OAGlB,GAAI,EAAoB,CACtB,IAAK,MAAM,KAAM,EAAM,sBACrB,EAAG,MAAM,QAAU,GACnB,EAAY,YAAY,GAE1B,EAAM,sBAAuB,CAC/B,CAGA,MAAM,EAAiB,IAAI,EAAM,eAAe,UAAU,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MAExG,IAAK,MAAM,KAAW,EAAgB,CAEpC,MAAM,EAAkB,EAAM,sBAAsB,IAAI,EAAQ,IAC5D,IACF,IACA,EAAM,sBAAsB,OAAO,EAAQ,KAI7C,IAAI,EAAY,EAAY,cAAc,yBAAyB,EAAQ,QACtE,IACH,EAAY,SAAS,cAAc,OACnC,EAAU,aAAa,sBAAuB,EAAQ,IACtD,EAAY,YAAY,IAG1B,MAAM,EAAU,EAAQ,OAAO,GAC3B,GACF,EAAM,sBAAsB,IAAI,EAAQ,GAAI,EAEhD,CACF,CAMA,SAAgB,EACd,EACA,EACA,GAEA,GAAK,EAAM,YAEX,IAAK,MAAO,EAAS,KAAU,EAAM,WAAY,CAC/C,MAAM,EAAa,EAAM,iBAAiB,IAAI,GACxC,EAAU,EAAW,cAAc,kBAAkB,OACrD,EAAc,GAAS,cAAc,0BAE3C,IAAK,IAAY,EAAa,SAG9B,EAAQ,UAAU,OAAO,WAAY,GACrC,MAAM,EAAS,EAAQ,cAAc,yBAMrC,GALI,GACF,EAAO,aAAa,gBAAiB,OAAO,IAI1C,GAEE,GAAgC,IAAhC,EAAY,SAAS,OAAc,CAErC,MAAM,EAAU,EAAM,OAAO,GACzB,GACF,EAAM,cAAc,IAAI,EAAS,EAErC,MACK,CAEL,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAY,UAAY,EAC1B,CACF,CACF,CAKA,SAAgB,EAA0B,EAAqB,GAE7D,MAAM,EAAc,EAAW,cAAc,uBACzC,IACF,EAAY,UAAU,OAAO,SAAU,EAAM,aAC7C,EAAY,aAAa,eAAgB,OAAO,EAAM,cAE1D,CAKA,SAAgB,EAAiB,EAAqB,GACpD,MAAM,EAAQ,EAAW,cAAc,mBAClC,IAEL,EAAM,UAAU,OAAO,OAAQ,EAAM,aAGhC,EAAM,cACT,EAAM,MAAM,MAAQ,IAExB,CAGA,IAAM,EAAuB,0BAOzB,EAAoB,EAGxB,SAAgB,IACd,MACiB,oBAAR,KACiB,mBAAjB,IAAI,UACX,IAAI,SAAS,cAAe,EAEhC,CAmCA,SAAgB,EACd,EACA,EACA,EACA,GAEA,MAAM,EAAQ,EAAW,cAAc,mBACvC,GAAK,EAAL,CAOA,GALA,EAAM,iBAAmB,EACzB,EAAM,QAAQ,OAAS,EAAS,SAAW,QAIvC,EAAM,aAAa,YAA2C,mBAAtB,EAAM,YAChD,IACE,EAAM,aACR,CAAA,MAEA,CAGF,GAAI,IAA6B,CAK/B,MAAM,EAAa,GAAG,OAA0B,IAChD,EAAM,mBAAqB,EAC3B,EAAS,MAAM,YAAY,cAAe,GAC1C,EAAM,MAAM,YAAY,kBAAmB,GAC3C,EAAM,MAAM,eAAe,OAC3B,EAAM,MAAM,eAAe,QAC3B,EAAM,MAAM,eAAe,QAC7B,MA9DF,SAAkC,EAAoB,EAAuB,GAC3E,MAAM,EAAO,EAAS,wBAChB,EAAW,EAAM,aAAa,kBAAoB,QAKxD,GAJA,EAAM,MAAM,SAAW,QAGvB,EAAM,MAAM,IAAM,GAAG,KAAK,OAAO,EAAS,EAAK,IAAM,EAAK,QAAU,OACnD,SAAb,EACF,EAAM,MAAM,KAAO,GAAG,KAAK,MAAM,EAAK,UACtC,EAAM,MAAM,MAAQ,WACf,CACL,MAAM,EAAkC,oBAAX,OAAyB,OAAO,WAAa,EAC1E,EAAM,MAAM,KAAO,OACnB,EAAM,MAAM,MAAQ,GAAG,KAAK,MAAM,EAAgB,EAAK,UACzD,CACF,CAgDI,CAAyB,EAAO,EAAU,EA5BhC,CA8Bd,CAkFA,SAAgB,EAAmB,GAEjC,IAAK,MAAM,KAAW,EAAM,uBAAuB,SACjD,IAEF,EAAM,uBAAuB,QAG7B,IAAK,MAAM,KAAW,EAAM,cAAc,SACxC,IAEF,EAAM,cAAc,QAGpB,IAAK,MAAM,KAAW,EAAM,sBAAsB,SAChD,IAEF,EAAM,sBAAsB,QAG5B,EAAM,sBAAuB,CAC/B,CAuEA,SAAS,EACP,EACA,EACA,GAEA,MAAM,OAAqC,IAArB,GAAO,UAA0B,EAAa,EAAM,gBAAa,EACjF,OAA+B,IAAlB,GAAO,OAAuB,EAAa,EAAM,aAAU,EACxE,OAAmC,IAApB,GAAO,SAAyB,EAAa,EAAM,eAAY,EAG9E,EAAiB,IADH,EAAY,QAAQ,iBAAmB,IACnB,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,IAAM,EAAE,OAAS,IAG9E,EAAe,IADH,EAAY,YAAc,IACR,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MAElF,MAAO,CACL,cAAe,CACb,MAAO,EAAY,QAAQ,YAAS,EACpC,UAAW,EAAa,OAAS,EACjC,YAAa,EAAa,YAC1B,gBACA,YAAoD,IAAxC,EAAY,QAAQ,kBAA+D,IAAlC,EAAY,WAAW,OACpF,cAAe,EAAe,IAAK,IAAA,CACjC,GAAI,EAAE,GACN,YAAY,EACZ,YAAa,EAAE,UAEjB,WAAY,IAEd,YAAa,CACX,SAAU,EAAY,WAAW,UAAY,QAC7C,KAAM,EAAY,WAAW,MAAQ,UACrC,YAAa,EAAa,YAC1B,aACA,eAMA,iBACkC,IAAhC,EAAY,QAAQ,UACc,IAAlC,EAAY,WAAW,QACwB,cAA9C,EAAY,WAAW,MAAQ,WAClC,OAAQ,EAAa,IAAK,IAAA,CACxB,GAAI,EAAE,GACN,MAAO,EAAE,MACT,KAAM,EAAa,EAAE,MACrB,WAAY,EAAa,iBAAiB,IAAI,EAAE,QAIxD,CAyEA,SAAgB,EACd,EACA,EACA,EACA,GAGA,MAAM,EAAe,EAAW,cAAc,IAAI,KAC5C,EAAkB,GAAc,cAAc,qBAGpD,IAAK,IAAiB,EACpB,OAzEJ,SACE,EACA,EACA,EACA,GAEA,MAAM,EAAW,EAAwB,GAQnC,EAAyB,GAC/B,IAAK,IAAI,EAAiB,EAAW,WAAY,EAAG,EAAI,EAAE,YACrC,IAAf,EAAE,UAAmB,EAAc,UAAU,SAAS,IAC1D,EAAe,KAAK,GAItB,EAAW,kBAKX,IAAK,MAAM,KAAK,EACd,EAAW,YAAY,GAGzB,GAAI,EAAU,CACZ,MAAM,cAAE,EAAA,YAAe,GAAgB,EAAkB,EAAc,EAAc,GAI/E,EAAW,EAAa,CAC5B,UAAU,EACV,YALkB,EAAsB,GAAe,EAAiB,QAAiB,EAMzF,UALgB,EAAe,KAOjC,EAAW,YAAY,EACzB,KAAO,CACL,MAAM,EAAW,EAAa,CAAE,UAAU,IAC1C,EAAW,YAAY,EACzB,CAEA,OAAO,CACT,CA0BW,CAAwB,EAAY,EAAa,EAAc,GAIxE,EAAgB,SAEhB,MAAM,EAAW,EAAwB,GAKzC,GAFA,EAAa,kBAET,EAAU,CACZ,EAAa,UAAY,GAAG,cAE5B,MAAM,cAAE,EAAA,YAAe,GAAgB,EAAkB,EAAc,EAAc,GAC/E,EAAc,EAAsB,GAAe,EAAiB,QAAiB,EACrF,EAAY,EAAe,GAG3B,EAAe,EAAU,cAAc,qBACzC,GACF,EAAa,YAAY,GAGvB,GAAa,EAAa,YAAY,GAC1C,EAAa,YAAY,EAC3B,MAEE,EAAa,UAAY,EACzB,EAAa,YAAY,GAG3B,OAAO,CACT,CCp2CA,SAAgB,EAAsB,EAAmB,GACvD,IAAI,GAAc,EAclB,MAAM,EAA8B,CAClC,iBAAI,GACF,OAAO,CACT,EACA,cAAA,CAAe,GACb,EAAc,CAChB,EAEA,eAAI,GACF,OAAO,EAAM,WACf,EAEA,oBAAI,GACF,MAAO,IAAI,EAAM,iBACnB,EAEA,aAAA,CAAc,EAAkB,GAC9B,GAA8B,IAA1B,EAAM,WAAW,KAEnB,YADA,ETtCsB,SSsCS,4BAA6B,EAAK,IAKnE,IAAI,EAUJ,QATgB,IAAZ,IACE,EAAM,WAAW,IAAI,GACvB,EAAkB,EAElB,EAAe,EAAsB,eAAe,eAAsB,EAAK,KAK/E,EAAM,aAAe,GAAmB,EAAM,iBAAiB,IAAI,GACrE,OAKF,GAAI,EAAM,aAAe,IAAoB,EAAM,iBAAiB,IAAI,GAEtE,YADA,EAAW,uBAAuB,GAIpC,GAAI,EAAM,YAAa,OAQvB,GANA,EAAM,aAAc,EAMgB,IAAhC,EAAM,iBAAiB,MAAc,EAAM,WAAW,KAAO,EAC/D,GAAI,EACF,EAAM,iBAAiB,IAAI,OACtB,CACL,MAAM,EAAgB,EAAK,iBAAiB,OAAO,WAAW,YAC9D,GAAI,GAAiB,EAAM,WAAW,IAAI,GACxC,EAAM,iBAAiB,IAAI,OACtB,CAEL,MAAM,EADe,IAAI,EAAM,WAAW,UAAU,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MAClE,GAC5B,GACF,EAAM,iBAAiB,IAAI,EAAW,GAE1C,CACF,MACK,GAAI,IAAoB,EAAM,iBAAiB,IAAI,GAAkB,CAE1E,IAAK,MAAM,IAAM,IAAI,EAAM,kBACzB,EAAM,iBAAiB,OAAO,GAEhC,EAAM,iBAAiB,IAAI,EAC7B,CAGA,MAAM,EAAS,EAAK,YAQpB,GAPA,EAA0B,EAAQ,GAClC,EAAiB,EAAQ,GAGzB,EAAmB,EAAQ,EAAO,EAAK,iBAGc,aAAjD,EAAK,iBAAiB,OAAO,WAAW,KAAqB,CAC/D,MAAM,GAAE,EAAA,OAAI,GA5FlB,SAA+B,GAC7B,GAAI,EAAU,MAAO,CAAE,GAAI,EAAU,QAAQ,GAC7C,MAAM,EAAS,EAAK,YAAY,cAAc,uBAC9C,OAAI,EAAe,CAAE,GAAI,EAAQ,QAAQ,GAClC,CAAE,GAAI,EAAK,aAAc,QAAQ,EAC1C,CAuF6B,CAAsB,GAAS,QACtD,EAAsB,EAAQ,EAAO,EAAI,EAC3C,CAGA,EAAK,MAAM,kBAAmB,CAAE,SAAU,EAAW,kBACvD,EAEA,cAAA,GACE,IAAK,EAAM,YAAa,OAGxB,GAAI,EAAK,iBAAiB,OAAO,WAAW,OAAQ,OAGpD,IAAK,MAAM,KAAW,EAAM,cAAc,SACxC,IAEF,EAAM,cAAc,QAGpB,IAAK,MAAM,KAAS,EAAM,WAAW,SACnC,EAAM,YAGR,EAAM,aAAc,EAGpB,MAAM,EAAS,EAAK,YACpB,EAA0B,EAAQ,GAClC,EAAiB,EAAQ,GAG4B,aAAjD,EAAK,iBAAiB,OAAO,WAAW,MD64BlD,SAAsC,EAAqB,GACzD,MAAM,EAAQ,EAAW,cAAc,mBACvC,GAAI,EAAO,CACT,GAAI,EAAM,aAAa,YAA2C,mBAAtB,EAAM,YAChD,IACE,EAAM,aACR,CAAA,MAEA,CAEF,EAAM,MAAM,eAAe,mBAC3B,EAAM,MAAM,eAAe,YAC3B,EAAM,MAAM,eAAe,OAC3B,EAAM,MAAM,eAAe,QAC3B,EAAM,MAAM,eAAe,gBACpB,EAAM,QAAQ,MACvB,CACI,EAAM,mBACR,EAAM,iBAAiB,MAAM,eAAe,eAC5C,EAAM,iBAAmB,MAE3B,EAAM,mBAAqB,IAC7B,CCl6BQ,CAAsB,EAAQ,GAIhC,EAAK,MAAM,mBAAoB,CAAC,EAClC,EAEA,eAAA,CAAgB,GACV,EAAM,YACR,EAAW,iBAEX,EAAW,mBAAc,EAAW,EAExC,EAEA,oBAAA,GACE,IAAK,EAAM,YAAa,OACxB,GAAqD,aAAjD,EAAK,iBAAiB,OAAO,WAAW,KAAqB,OACjE,MAAM,EAAS,EAAM,iBAMrB,GACE,GACA,EAAO,aACP,EAAM,oBACN,EAAO,MAAM,iBAAiB,iBAAmB,EAAM,mBAEvD,OAWF,IAAK,EAAM,oBAAsB,GAAU,EAAO,aAAe,IAAW,EAAK,cAEjD,UADhB,EAAK,YAAY,cAAc,oBAClC,QAAQ,OAAoB,OAQzC,MAAM,EAAQ,EAAK,YAAY,cAAc,uBAC7C,GAAI,GAAS,IAAU,EAAK,aAA5B,CACE,GACE,EAAM,oBACN,KD+3BV,SAAqC,EAAqB,EAAmB,GAC3E,MAAM,EAAa,EAAM,mBACzB,IAAK,EAAY,OAAO,EACxB,MAAM,EAAQ,EAAW,cAAc,mBACvC,IAAK,EAAO,OAAO,EACnB,MAAM,EAAO,EAAM,iBAcnB,GAbI,GAAQ,IAAS,GAAS,EAAK,MAAM,eAAe,eACxD,EAAQ,MAAM,YAAY,cAAe,GACzC,EAAM,MAAM,YAAY,kBAAmB,GAC3C,EAAM,MAAM,eAAe,OAC3B,EAAM,MAAM,eAAe,QAC3B,EAAM,MAAM,eAAe,SAC3B,EAAM,QAAQ,OAAS,QACvB,EAAM,iBAAmB,EAMrB,EAAM,aAAa,YAA2C,mBAAtB,EAAM,YAChD,IACE,EAAM,aACR,CAAA,MAEA,CAEF,OAAO,CACT,CCz5BU,CAAqB,EAAK,YAAa,EAAO,GAE9C,OAEF,EAAsB,EAAK,YAAa,EAAO,GAAO,EAExD,MAEI,IAAW,EAAK,cAGlB,EAAsB,EAAK,YAAa,EAAO,EAAK,cAAc,EAQtE,EAEA,sBAAA,CAAuB,GACrB,MAAM,EAAQ,EAAM,WAAW,IAAI,GACnC,IAAK,EAEH,YADA,EAAe,EAAsB,uBAAuB,eAAwB,EAAK,IAK3F,GAA8B,IAA1B,EAAM,WAAW,KACnB,OAGF,MAAM,EAAS,EAAK,YACd,EAAa,EAAM,iBAAiB,IAAI,GAE9C,GAAI,EAAY,CAEd,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAM,YACN,EAAM,iBAAiB,OAAO,GAC9B,EAA4B,EAAQ,GAAW,EACjD,KAAO,CAEL,IAAK,MAAO,EAAS,KAAe,EAAM,WACxC,GAAI,IAAY,GAAa,EAAM,iBAAiB,IAAI,GAAU,CAChE,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAW,YACX,EAAM,iBAAiB,OAAO,GAC9B,EAA4B,EAAQ,GAAS,GAE7C,MAAM,EAAY,EAAO,cAAc,kBAAkB,8BACrD,IAAW,EAAU,UAAY,GACvC,CAGF,EAAM,iBAAiB,IAAI,GAC3B,EAA4B,EAAQ,GAAW,GA4IvD,SAAuC,EAAqB,EAAmB,GAC7E,MAAM,EAAQ,EAAM,WAAW,IAAI,GACnC,IAAK,GAAO,OAAQ,OAEpB,MAAM,EAAY,EAAW,cAAc,kBAAkB,8BAC7D,IAAK,EAAW,OAEhB,MAAM,EAAU,EAAM,OAAO,GACzB,GACF,EAAM,cAAc,IAAI,EAAW,EAEvC,CAtJQ,CAA8B,EAAQ,EAAO,EAC/C,CAGA,EAAK,MAAM,4BAA6B,CAAE,GAAI,EAAW,UAAW,GACtE,EAEA,cAAA,IACS,IAAI,EAAM,WAAW,UAG9B,iBAAA,CAAkB,GACZ,EAAM,WAAW,IAAI,EAAM,IAC7B,EAAe,EAAsB,eAAe,EAAM,yBAA0B,EAAK,KAG3F,EAAM,WAAW,IAAI,EAAM,GAAI,IAO3B,GAAe,EAAK,aAAa,cACnC,EAAK,uBAET,EAEA,mBAAA,CAAoB,GAElB,GAAI,EAAM,iBAAiB,IAAI,GAAU,CACvC,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAM,iBAAiB,OAAO,EAChC,CAEA,EAAM,WAAW,OAAO,IAEpB,GAAe,EAAK,aAAa,cACnC,EAAK,sBAET,EAEA,kBAAA,IACS,IAAI,EAAM,eAAe,UAGlC,qBAAA,CAAsB,GAChB,EAAM,eAAe,IAAI,EAAQ,IACnC,EAAe,EAA0B,mBAAmB,EAAQ,yBAA0B,EAAK,KAGrG,EAAM,eAAe,IAAI,EAAQ,GAAI,GAEjC,EACF,EAAoB,EAAK,YAAa,GAC7B,EAAK,aAAa,aAG3B,EAAK,uBAET,EAEA,uBAAA,CAAwB,GAEtB,MAAM,EAAU,EAAM,sBAAsB,IAAI,GAC5C,IACF,IACA,EAAM,sBAAsB,OAAO,IAKrC,EADsB,eAAe,IAAI,IAChC,cAET,EAAM,eAAe,OAAO,GAI5B,EADgB,YAAY,cAAc,yBAAyB,QAC/D,QACN,EAEA,mBAAA,IACS,IAAI,EAAM,gBAAgB,UAAU,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,IAAM,EAAE,OAAS,IAGzF,sBAAA,CAAuB,GACjB,EAAM,gBAAgB,IAAI,EAAQ,IACpC,ETxViC,SSwVS,oBAAoB,EAAQ,yBAA0B,EAAK,KAGvG,EAAM,gBAAgB,IAAI,EAAQ,GAAI,IAElC,GAAe,EAAK,aAAa,cACnC,EAAK,uBAET,EAEA,wBAAA,CAAyB,GAEvB,MAAM,EAAU,EAAM,uBAAuB,IAAI,GAC7C,IACF,IACA,EAAM,uBAAuB,OAAO,IAItC,MAAM,EAAU,EAAM,gBAAgB,IAAI,GACtC,GAAS,WACX,EAAQ,YAGV,EAAM,gBAAgB,OAAO,GAEzB,GACF,EAAK,sBAET,GAGF,OAAO,CACT,CAKA,SAAS,EAA4B,EAAqB,EAAmB,GAC3E,MAAM,EAAU,EAAW,cAAc,kBAAkB,OACvD,GACF,EAAQ,UAAU,OAAO,WAAY,EAEzC,KE9ca,EAAb,cAAiC,EAE/B,KAAgB,QAEhB,unOAMA,GACA,GAKA,GACA,GACA,GAMA,GAUA,GACA,IAAqB,EAGrB,YAAI,GACF,YAAuB,IAAhB,MAAK,CACd,CASA,WAAA,CAAY,GACV,GAAI,MAAK,EAAQ,OACjB,MAAM,EHRD,CACL,0BAAY,IAAI,IAChB,8BAAgB,IAAI,IACpB,+BAAiB,IAAI,IACrB,yBAAyB,EACzB,sBAAuB,GACvB,cAAe,KACf,oCAAsB,IAAI,IAC1B,wCAA0B,IAAI,IAC9B,yCAA2B,IAAI,IAC/B,+BAAiB,IAAI,IACrB,mCAAqB,IAAI,IACzB,aAAa,EACb,gCAAkB,IAAI,IACtB,qCAAuB,IAAI,IAC3B,6BAAe,IAAI,IACnB,sCAAwB,IAAI,IAC5B,sBAAsB,EACtB,iBAAkB,KAClB,mBAAoB,MGVpB,MAAK,EAAS,EACd,MAAK,EAAc,EAAsB,EAAO,EAClD,CAGA,cAAI,GACF,OAAO,MAAK,CACd,CAGA,mBAAI,GACF,OAAO,MAAK,CACd,CASA,mBAAI,GACF,QAAO,KAAK,UAAW,KAAK,gBAAgB,WAC9C,CAGA,6BAAI,GACF,OAAO,KAAK,SAAW,KAAK,gBAAgB,iBAAmB,EACjE,CAQA,aAAA,CAAc,EAAkB,GAC9B,KAAK,iBAAiB,cAAc,EAAS,EAC/C,CAGA,cAAA,GACE,KAAK,iBAAiB,gBACxB,CAOA,eAAA,CAAgB,GACd,KAAK,iBAAiB,gBAAgB,EACxC,CAGA,sBAAA,CAAuB,GACrB,KAAK,iBAAiB,uBAAuB,EAC/C,CAGA,aAAA,GACE,OAAO,KAAK,SAAW,KAAK,gBAAgB,gBAAkB,EAChE,CAGA,iBAAA,CAAkB,GACX,KAAK,WACV,KAAK,WAAW,gBAAgB,IAAI,EAAM,IAC1C,KAAK,gBAAgB,kBAAkB,GACzC,CAGA,mBAAA,CAAoB,GACb,KAAK,WACV,KAAK,WAAW,gBAAgB,OAAO,GACvC,KAAK,gBAAgB,oBAAoB,GAC3C,CAGA,iBAAA,GACE,OAAO,KAAK,SAAW,KAAK,gBAAgB,oBAAsB,EACpE,CAGA,qBAAA,CAAsB,GACf,KAAK,WACV,KAAK,WAAW,oBAAoB,IAAI,EAAQ,IAChD,KAAK,gBAAgB,sBAAsB,GAC7C,CAGA,uBAAA,CAAwB,GACjB,KAAK,WACV,KAAK,WAAW,oBAAoB,OAAO,GAC3C,KAAK,gBAAgB,wBAAwB,GAC/C,CAGA,kBAAA,GACE,OAAO,KAAK,SAAW,KAAK,gBAAgB,qBAAuB,EACrE,CAGA,sBAAA,CAAuB,GACrB,KAAK,iBAAiB,uBAAuB,EAC/C,CAGA,wBAAA,CAAyB,GACvB,KAAK,iBAAiB,yBAAyB,EACjD,CAIA,MAAA,CAAgB,GACd,MAAM,OAAO,GAIb,KAAK,YAAY,GAKjB,MAAM,EAAA,IAAsB,KAAK,eACjC,MAAK,EAAsB,EAC3B,EAAK,yBAAyB,kBAAmB,GACjD,EAAK,yBAAyB,wBAAyB,GACvD,EAAK,yBAAyB,sBAAuB,EACvD,CAGA,EAAA,CAAe,GACb,MAAM,EAAO,EAAK,cHiHtB,SAAmC,EAAmB,GACpD,MAAM,EAAW,EAAK,cAAc,mBACpC,IAAK,EAAU,OAGf,IAAK,EAAM,cAAe,CACxB,MAAM,EAAQ,EAAS,aAAa,SAChC,IACF,EAAM,cAAgB,EAE1B,CAGA,MAAM,EAAiB,EAAS,iBAAiB,2BAC7C,EAAe,OAAS,GAA4C,IAAvC,EAAM,sBAAsB,SAC3D,EAAM,sBAAwB,MAAM,KAAK,IAI3C,EAA0B,MAAM,QAAU,MAC5C,CGpII,CAAmB,EAAM,KAAK,YHqKlC,SACE,EACA,EACA,GAGA,MAAM,EAAuB,EAAK,cAAc,kCAChD,IAAK,EAAsB,OAG3B,EAAM,yBAA0B,EAGhC,MAAM,EAAK,4BACX,GAAI,EAAM,0BAA0B,IAAI,GAAK,OAK7C,MAAM,EAAuC,CAC3C,KACA,MAAO,EACP,OALsB,IAAkB,IAAoB,CAOxD,IAEA,KAAO,EAAqB,YAC1B,EAAO,YAAY,EAAqB,YAI1C,MAAA,KACE,KAAO,EAAO,YACZ,EAAqB,YAAY,EAAO,YAG9C,IAGJ,EAAM,gBAAgB,IAAI,EAAI,GAC9B,EAAM,0BAA0B,IAAI,GAGpC,EAAqB,MAAM,QAAU,MACvC,CGhNI,CAAyB,EAAM,KAAK,YH8OxC,SACE,EACA,EACA,GAIA,EAF+B,iBAAiB,gCAE9B,QAAS,IACzB,MAAM,EAAU,EACV,EAAK,EAAQ,aAAa,MAC1B,EAAQ,EAAQ,aAAa,eAAY,EAK/C,IAAK,EAEH,YADA,ERxXiC,SQwXO,oDAAoD,GAAS,OAIvG,MAAM,EAAO,EAAQ,aAAa,cAAW,EACvC,EAAU,EAAQ,aAAa,iBAAc,EAC7C,EAAQ,SAAS,EAAQ,aAAa,UAAY,MAAO,IAG/D,IAAI,EAEJ,MAAM,EAAkB,IAAkB,GAC1C,GAAI,EACF,EAAS,MACJ,CAIL,MAAM,EAAa,EAAQ,UAAU,OACrC,EAAU,IACR,MAAM,EAAU,SAAS,cAAc,OAGvC,OAFA,EAAiB,EAAS,GAC1B,EAAU,YAAY,GACtB,IAAa,EAAQ,SAEzB,CAGA,MAAM,EAAgB,EAAM,WAAW,IAAI,GAO3C,GAAI,IAAkB,EAAM,qBAAqB,IAAI,GAMnD,OALA,EACE,EACA,eAAe,mHAEjB,EAAQ,MAAM,QAAU,QAsB1B,GAAI,EAAe,CACjB,GAAI,EAAiB,CACnB,MAAM,GAAsB,EAAM,yBAAyB,IAAI,GACzD,EACJ,EAAc,QAAU,GACxB,EAAc,QAAU,GACxB,EAAc,OAAS,GACvB,EAAc,UAAY,EAY5B,GAPA,EAAc,OAAS,EACvB,EAAc,MAAQ,EACtB,EAAc,MAAQ,EACtB,EAAc,KAAO,EACrB,EAAc,QAAU,EACxB,EAAM,yBAAyB,IAAI,GAE/B,GAAsB,EAAc,CACtC,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,GAE/B,CACF,CACA,MACF,CAGA,MAAM,EAA6B,CACjC,KACA,QACA,OACA,UACA,QACA,UAGF,EAAM,WAAW,IAAI,EAAI,GACzB,EAAM,qBAAqB,IAAI,GAC3B,GACF,EAAM,yBAAyB,IAAI,GAIrC,EAAQ,MAAM,QAAU,QAE5B,CG5WI,CAAwB,EAAM,KAAK,WAAY,EAAK,+BACtD,CAUA,YAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAC7B,MAAM,EAAQ,KAAK,WACb,EAAW,EAAM,cACjB,EAAiB,EAAM,wBAC7B,MAAK,EAAe,GACpB,MAAM,EAAW,EAAM,cACjB,EAAiB,EAAM,yBAExB,IAAa,GAAc,IAAmB,KACjD,EAAK,sBAKD,EAAK,YAAY,cAAc,uBACjC,EAAmB,GACnB,KAAK,yBAGX,CASA,aAAA,GACE,MAAM,EAAO,KAAK,KACb,GAAS,KAAK,UACnB,MAAK,EAAe,EACtB,CAGA,sBAAA,GACO,KAAK,UACV,EAAmB,KAAK,WAC1B,CAQA,uBAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAAO,EACpC,MAAM,EAAO,EAAK,YACZ,IAAa,EAAK,cAAc,cAChC,IAAiB,EAAK,cAAc,mBACpC,EAA0B,EAAK,iBAAiB,0BAA0B,OAC1E,EAAgB,EAAK,cAAc,oBAA2C,QAAQ,UAAY,QAClG,EAAY,EAAK,cAAc,oBAA2C,QAAQ,MAAQ,UAE1F,EAAQ,EAAK,iBAAiB,MAOpC,OACE,IAPoB,EAAwB,KAQ1C,IAPsB,GAAO,YAAY,QAAU,GAAK,GAQzD,IAPoB,GAAO,YAAY,QAAU,KAOd,GACnC,GAAgB,KAPC,GAAO,WAAW,UAAY,UAQ/C,GAAgB,KAPH,GAAO,WAAW,MAAQ,UAS5C,CAwBA,EAAA,CAAyB,GACvB,MAAM,EAAQ,KAAK,WACb,EAAS,EAAK,aAAa,GAGjC,IAAK,MAAM,IAAW,IAAI,EAAM,WAAW,QACrC,EAAM,qBAAqB,IAAI,IAAY,EAAM,gBAAgB,IAAI,KACzE,EAAM,cAAc,IAAI,EAAxB,KACA,EAAM,cAAc,OAAO,GAC3B,EAAM,WAAW,OAAO,IAG1B,IAAK,MAAM,IAAa,IAAI,EAAM,eAAe,QAC3C,EAAM,oBAAoB,IAAI,KAClC,EAAM,sBAAsB,IAAI,EAAhC,KACA,EAAM,sBAAsB,OAAO,GACnC,EAAM,eAAe,OAAO,IAG9B,MAAM,WAAE,EAAA,eAAY,GAAmB,EAAK,4BAE5C,IAAK,MAAM,KAAS,EAId,EAAM,gBAAgB,IAAI,EAAM,MAChC,EAAM,qBAAqB,IAAI,EAAM,MACvC,EACE,EACA,eAAe,EAAM,sFACrB,GAEF,EAAM,cAAc,IAAI,EAAM,GAA9B,KACA,EAAM,cAAc,OAAO,EAAM,IACjC,EAAM,qBAAqB,OAAO,EAAM,IACxC,EAAM,yBAAyB,OAAO,EAAM,KAE9C,EAAM,WAAW,IAAI,EAAM,GAAI,IAGjC,IAAK,MAAM,KAAW,EAChB,EAAM,oBAAoB,IAAI,EAAQ,MACtC,EAAM,eAAe,IAAI,EAAQ,MACnC,EACE,EACA,mBAAmB,EAAQ,2EAC3B,GAEF,EAAM,sBAAsB,IAAI,EAAQ,GAAxC,KACA,EAAM,sBAAsB,OAAO,EAAQ,KAE7C,EAAM,eAAe,IAAI,EAAQ,GAAI,GAEzC,CAEA,aAAA,CAAuB,GACrB,IAAK,KAAK,SAAU,OACpB,MAAM,EAAQ,KAAK,WAKb,EAAO,KAAK,KACd,IACF,MAAK,EAAe,GACpB,MAAK,EAAyB,IAShC,MAAM,EAAO,KAAK,eAsBlB,GAnBA,EAAO,MAAQ,IAAK,KAAS,EAAO,OACpC,EAAO,MAAM,OAAS,IAAK,EAAK,UAAW,EAAO,MAAM,QAGpD,EAAM,gBAAkB,EAAO,MAAM,OAAO,QAC9C,EAAO,MAAM,OAAO,MAAQ,EAAM,eAIhC,EAAM,uBAAuB,OAAS,IACxC,EAAO,MAAM,OAAO,gBAAkB,EAAM,uBAI1C,EAAM,0BACR,EAAO,MAAM,OAAO,yBAA0B,GAI5C,EAAM,WAAW,KAAO,EAAG,CAC7B,MAAM,EAAS,MAAM,KAAK,EAAM,WAAW,UAC3C,EAAO,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MACrD,EAAO,MAAM,WAAa,CAC5B,CAGA,GAAI,EAAM,eAAe,KAAO,EAAG,CACjC,MAAM,EAAW,MAAM,KAAK,EAAM,eAAe,UACjD,EAAS,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MACvD,EAAO,MAAM,eAAiB,CAChC,CAKA,MAAM,EAAc,MAAM,KAAK,EAAM,gBAAgB,UAC/C,EAAyB,KAAK,MAAM,eAAe,OAAO,QAAQ,iBAAmB,GACrF,EAAY,IAAI,IAAI,EAAuB,IAAK,GAAM,EAAE,KACxD,EAAiB,IAAI,GAC3B,IAAK,MAAM,KAAW,EACf,EAAU,IAAI,EAAQ,KACzB,EAAe,KAAK,GAGxB,EAAe,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,IAAM,EAAE,OAAS,IAC3D,EAAO,MAAM,OAAO,gBAAkB,CACxC,CAcA,qBAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAC7B,MAAM,EAAQ,KAAK,WACF,EACf,EAAK,YACL,EAAK,iBAAiB,MACtB,CAAE,YAAa,EAAM,YAAa,iBAAkB,EAAM,kBAC1D,EAAK,iBAAiB,SAGtB,MAAK,EAAgB,GACrB,KAAK,gBAAgB,gBAAe,GACpC,MAAK,EAAqB,GAE9B,CA2BA,WAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAC7B,MAAM,EAAQ,KAAK,WAKnB,MAAK,EAAsB,GAKvB,EAAM,aACR,EAAmB,EAAK,YAAa,GAIlC,EAAM,aAIX,KAAK,gBAAgB,uBACrB,MAAK,EAAuB,IAJ1B,MAAK,GAKT,CAOA,EAAA,CAAsB,GACpB,MAAM,EAAc,EAAK,YAAY,cAAc,qBACnD,IAAK,EAAa,OAElB,MAAM,EAAQ,EAAK,iBAAiB,OAAO,QAAQ,OAAS,KAAK,WAAW,cAE5E,IAAI,EAAU,EAAY,cAAc,oBACpC,GACG,IACH,EAAU,SAAS,cAAc,MACjC,EAAQ,UAAY,kBACpB,EAAQ,aAAa,OAAQ,eAC7B,EAAY,aAAa,EAAS,EAAY,aAEhD,EAAQ,YAAc,GACb,GACT,EAAQ,QAEZ,CAGA,EAAA,CAAuB,GAIgC,aAAjD,EAAK,iBAAiB,OAAO,WAAW,KAIZ,oBAArB,mBACN,MAAK,IACR,MAAK,EAAoB,IAAI,iBAAA,KACtB,KAAK,MAAS,KAAK,UAAa,KAAK,WAAW,YAIrD,KAAK,gBAAgB,uBAHnB,MAAK,OAMN,MAAK,IACR,MAAK,EAAkB,QAAQ,EAAK,YAAa,CAAE,WAAW,EAAM,SAAS,IAC7E,MAAK,GAAqB,IAf1B,MAAK,GAiBT,CAGA,EAAA,GACM,MAAK,GAAqB,MAAK,IACjC,MAAK,EAAkB,aACvB,MAAK,GAAqB,EAE9B,CAeA,EAAA,CAAqB,GACnB,MAAM,EAAQ,KAAK,WACb,EAAa,EAAK,YAClB,EAAc,EAAK,iBAAiB,MAG1C,EAAoB,EAAY,GHgSpC,SACE,EACA,EACA,GAGA,MAAM,EAAiB,GAAQ,QAAQ,iBAAmB,GACpD,EAAgB,IAAI,EAAM,gBAAgB,UAC1C,EAAY,IAAI,IAAI,EAAe,IAAK,GAAM,EAAE,KAChD,EAAc,IAAI,GACxB,IAAK,MAAM,KAAW,EACf,EAAU,IAAI,EAAQ,KACzB,EAAY,KAAK,GAKrB,IAAK,MAAM,KAAW,EAAa,CAEjC,GAAI,EAAM,uBAAuB,IAAI,EAAQ,IAAK,SAClD,IAAK,EAAQ,OAAQ,SAErB,MAAM,EAAO,EAAW,cAAc,0BAA0B,EAAQ,QACxE,IAAK,EAAM,SAEX,MAAM,EAAU,EAAQ,OAAO,GAC3B,GACF,EAAM,uBAAuB,IAAI,EAAQ,GAAI,EAEjD,CACF,CG7TI,CAA4B,EAAY,EAAa,GAGrD,MAAM,EAAe,GAAa,UAC5B,EAAc,GAAc,YAC9B,GAAe,EAAM,WAAW,IAAI,IACtC,EAAM,iBAAiB,IAAI,GAQ7B,MAAM,GACqB,IAAzB,GAAc,QACiB,SAA/B,GAAc,mBACkB,IAA/B,GAAc,mBAA8C,IAAhB,GAA6B,EAAM,WAAW,IAAI,IAC5F,EAAM,aAAe,EAAM,WAAW,KAAO,GAAK,GACrD,KAAK,gBAKH,EAAM,cACR,EAAiB,EAAY,GAC7B,EAAmB,EAAY,GACrB,EAAK,gBACH,EAAK,kBAEjB,EAA0B,EAAY,GAMtC,KAAK,gBAAgB,uBAEzB,CASA,EAAA,CAAgB,GACd,MAAM,EAAa,EAAK,YAClB,EAAc,EAAK,iBAAiB,MACpC,EAAQ,KAAK,YHrEvB,SACE,EACA,EACA,EACA,GAOA,MAAM,EAAU,EAAW,cAAc,sBACrC,GACF,EAAQ,iBAAiB,QAAU,IAClB,EAAE,OAGU,QAAQ,wBAEjC,EAAU,kBAOhB,MAAM,EAAQ,EAAW,cAAc,mBACnC,GAAS,EAAU,cACrB,EAAM,iBAAiB,QAAU,IAChB,EAAE,OACN,QAAQ,uBACjB,EAAU,iBAMhB,MAAM,EAAY,EAAW,cAAc,kBACvC,GACF,EAAU,iBAAiB,QAAU,IAEnC,MAAM,EADS,EAAE,OACK,QAAQ,yBAC9B,GAAI,EAAQ,CAEV,MAAM,EADU,EAAO,QAAQ,mBACJ,aAAa,gBACpC,GACF,EAAU,gBAAgB,EAE9B,GAGN,CGoBI,CAAyB,EAAY,EAAa,EAAO,CACvD,cAAA,IAAqB,KAAK,kBAC1B,gBAAkB,GAAsB,KAAK,uBAAuB,GACpE,aAAA,IAAoB,KAAK,mBAK3B,MAAK,MACL,MAAK,EAAiB,EAAqB,EAAY,EAAc,IACnE,EAAK,aAAa,MAAM,YAAY,yBAA0B,GAAG,SAInE,MAAK,MACL,MAAK,EHRT,SACE,EACA,EACA,EACA,GAEA,MAAM,EAAO,GAAQ,WAAW,KAKhC,GAAa,aAAT,IAAwB,GAAQ,WAAW,oBAE7C,MAAA,OAKF,GAAa,SAAT,EAEF,MAAA,OAGF,MAAM,EAAW,IACf,IAAK,EAAM,YAAa,OAaxB,MAAM,EAAW,EAAM,iBACvB,IAAK,MAAM,KAAQ,EAAE,eAAgB,CACnC,GAAgB,MAAZ,GAAoB,IAAS,EAAU,OAC3C,GACE,aAAgB,UACf,EAAK,WAAW,SAAS,mBAAqB,EAAK,UAAU,yBAC9D,EAAS,EAAM,GAEf,MAEJ,CAEA,KAIF,OADA,SAAS,iBAAiB,YAAa,GACvC,IAAa,SAAS,oBAAoB,YAAa,EACzD,CG9CgC,CAAyB,EAAK,aAAc,EAAa,EAAA,IACnF,KAAK,kBAIP,MAAK,MACL,MAAK,EHqDT,SACE,EACA,EACA,GAGA,GAAgC,SAA5B,GAAQ,WAAW,KAErB,MAAA,OAGF,MAAM,EAAW,IACD,WAAV,EAAE,KAAoB,EAAE,kBACvB,EAAM,aACX,KAIF,OADA,SAAS,iBAAiB,UAAW,GACrC,IAAa,SAAS,oBAAoB,UAAW,EACvD,CGxEiC,CAAmB,EAAa,EAAA,IAAa,KAAK,iBACjF,CAGA,EAAA,GACE,MAAK,MACL,MAAK,OAAiB,EACtB,MAAK,MACL,MAAK,OAAuB,EAC5B,MAAK,MACL,MAAK,OAAwB,CAC/B,CAGA,MAAA,GAKE,MAAM,QACR,CAMA,iBAAA,GACE,MAAK,IACL,MAAK,IACL,MAAK,OAAoB,EAGzB,MAAM,EAAO,KAAK,KACd,GAAQ,MAAK,IACf,EAAK,2BAA2B,mBAChC,EAAK,2BAA2B,yBAChC,EAAK,2BAA2B,uBAChC,MAAK,OAAsB,GAEzB,MAAK,KH8gBb,SAAkC,GAEhC,IAAK,MAAM,KAAW,EAAM,sBAAsB,SAChD,IAEF,EAAM,sBAAsB,QAG5B,IAAK,MAAM,KAAW,EAAM,cAAc,SACxC,IAEF,EAAM,cAAc,QAGpB,IAAK,MAAM,KAAW,EAAM,uBAAuB,SACjD,IAEF,EAAM,uBAAuB,QAG7B,IAAK,MAAM,KAAW,EAAM,gBAAgB,SAC1C,EAAQ,cAIV,GAAI,EAAM,YACR,IAAK,MAAM,KAAa,EAAM,iBAE5B,EADoB,WAAW,IAAI,IAC5B,YAKX,EAAM,aAAc,EACpB,EAAM,iBAAiB,QAGvB,EAAM,WAAW,QACjB,EAAM,eAAe,QACrB,EAAM,gBAAgB,QACtB,EAAM,sBAAwB,GAG9B,EAAM,qBAAqB,QAC3B,EAAM,yBAAyB,QAC/B,EAAM,0BAA0B,QAGhC,EAAM,sBAAuB,CAC/B,CG9jBM,CAAkB,MAAK,GACvB,MAAK,GAAa,gBAAe,GAErC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../../libs/grid/src/lib/core/defaults.ts","../../../../../../libs/grid/src/lib/core/internal/sanitize.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/core/internal/pointer-drag.ts","../../../../../../libs/grid/src/lib/core/internal/size-popover.ts","../../../../../../libs/grid/src/lib/core/constants.ts","../../../../../../libs/grid/src/lib/core/internal/dom-builder.ts","../../../../../../libs/grid/src/lib/plugins/shell/shell.ts","../../../../../../libs/grid/src/lib/plugins/shell/shell-controller.ts","../../../../../../libs/grid/src/lib/plugins/shell/shell.css?inline","../../../../../../libs/grid/src/lib/plugins/shell/shell-plugin.ts"],"sourcesContent":["/**\n * Centralized diagnostic messages for @toolbox-web/grid.\n *\n * Every user-facing warning, error, or info message in the grid has a unique\n * diagnostic code (e.g. `TBW001`). Each code maps to a section on the online\n * troubleshooting page, giving developers a direct link to resolution steps.\n *\n * ## Usage\n *\n * ```ts\n * import { MISSING_BREAKPOINT, warnDiagnostic, throwDiagnostic } from './diagnostics';\n *\n * // Warn with a code\n * warnDiagnostic(MISSING_BREAKPOINT, 'Set a breakpoint...', gridId);\n *\n * // Throw with a code\n * throwDiagnostic(MISSING_ROW_ID, 'Configure getRowId...', gridId);\n * ```\n *\n * Plugins should prefer `this.warn(MISSING_BREAKPOINT, message)` via BaseGridPlugin\n * instead of importing this module directly.\n *\n * @internal\n */\n\n// #region Grid Prefix\n\n/**\n * Build the `[tbw-grid]` or `[tbw-grid#my-id]` log prefix.\n * Pass `pluginName` for a scoped prefix like `[tbw-grid:SelectionPlugin]`.\n */\nexport function gridPrefix(gridId?: string, pluginName?: string): string {\n  const id = gridId ? `#${gridId}` : '';\n  const plugin = pluginName ? `:${pluginName}` : '';\n  return `[tbw-grid${id}${plugin}]`;\n}\n\n// #endregion\n\n// #region Diagnostic Codes\n\n/**\n * Diagnostic codes used across the grid library.\n *\n * Each code is an individual export so that unused codes are tree-shaken\n * from bundles that don't reference them (esbuild can't tree-shake\n * properties from a single object).\n *\n * Naming: TBW + 3-digit number.\n * Ranges:\n *   001–019  Configuration validation (missing plugins, bad config)\n *   020–029  Plugin lifecycle (dependencies, incompatibilities, alias collapse)\n *   030–039  Feature registry\n *   040–049  Row operations (row ID, row mutations)\n *   050–059  Column operations (width, template)\n *   060–069  Rendering (callbacks, formatters, external views)\n *   070–079  Shell (tool panels, header/toolbar content)\n *   080–089  Editing & editors\n *   090–099  Print\n *   100–109  Clipboard\n *   110–119  Plugin-specific (responsive, undo-redo, grouping-columns)\n *   120–129  Style injection\n *   130–139  Attribute parsing\n *   140–149  DataSource / ServerSide\n */\n\n// --- Config validation (001–019) ---\n/** Column uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN = 'TBW001' as const;\n/** Grid config uses a plugin-owned property but the plugin is not loaded. */\nexport const MISSING_PLUGIN_CONFIG = 'TBW002' as const;\n/** Plugin config rule violation (error severity). */\nexport const CONFIG_RULE_ERROR = 'TBW003' as const;\n/** Plugin config rule violation (warning severity). */\nexport const CONFIG_RULE_WARN = 'TBW004' as const;\n\n// --- Plugin lifecycle (020–029) ---\n/** Required plugin dependency is missing. */\nexport const MISSING_DEPENDENCY = 'TBW020' as const;\n/** Optional plugin dependency is missing. */\nexport const OPTIONAL_DEPENDENCY = 'TBW021' as const;\n/** Two loaded plugins are incompatible. */\nexport const INCOMPATIBLE_PLUGINS = 'TBW022' as const;\n/** Two plugin instances resolve to the same canonical name (alias collapse). */\nexport const PLUGIN_ALIAS_COLLAPSE = 'TBW023' as const;\n/** Error thrown inside a plugin event handler. */\nexport const PLUGIN_EVENT_ERROR = 'TBW024' as const;\n/** Conflicting config values found while merging alias-collapsed plugin instances. */\nexport const PLUGIN_ALIAS_CONFIG_CONFLICT = 'TBW025' as const;\n\n// --- Feature registry (030–039) ---\n/** Feature was re-registered (overwritten). */\nexport const FEATURE_REREGISTERED = 'TBW030' as const;\n/** Feature configured but not imported. */\nexport const FEATURE_NOT_IMPORTED = 'TBW031' as const;\n/** Feature depends on another feature that is not enabled. */\nexport const FEATURE_MISSING_DEP = 'TBW032' as const;\n\n// --- Row operations (040–049) ---\n/** Cannot determine row ID (no getRowId and no id property). */\nexport const MISSING_ROW_ID = 'TBW040' as const;\n/** Row with given ID not found. */\nexport const ROW_NOT_FOUND = 'TBW041' as const;\n\n// --- Column operations (050–059) ---\n/** Column has an invalid CSS width value. */\nexport const INVALID_COLUMN_WIDTH = 'TBW050' as const;\n\n// --- Rendering callbacks (060–069) ---\n/** rowClass callback threw an error. */\nexport const ROW_CLASS_ERROR = 'TBW060' as const;\n/** cellClass callback threw an error. */\nexport const CELL_CLASS_ERROR = 'TBW061' as const;\n/** Column format function threw an error. */\nexport const FORMAT_ERROR = 'TBW062' as const;\n/** External view mount() threw an error. */\nexport const VIEW_MOUNT_ERROR = 'TBW063' as const;\n/** External view event dispatch error. */\nexport const VIEW_DISPATCH_ERROR = 'TBW064' as const;\n\n// --- Shell (070–079) ---\n/** Tool panel missing required id. */\nexport const TOOL_PANEL_MISSING_ATTR = 'TBW070' as const;\n/** No tool panels registered. */\nexport const NO_TOOL_PANELS = 'TBW071' as const;\n/** Tool panel section not found. */\nexport const TOOL_PANEL_NOT_FOUND = 'TBW072' as const;\n/** Tool panel already registered. */\nexport const TOOL_PANEL_DUPLICATE = 'TBW073' as const;\n/** Header content already registered. */\nexport const HEADER_CONTENT_DUPLICATE = 'TBW074' as const;\n/** Toolbar content already registered. */\nexport const TOOLBAR_CONTENT_DUPLICATE = 'TBW075' as const;\n\n// --- Editing & editors (080–089) ---\n/** External editor mount() threw an error. */\nexport const EDITOR_MOUNT_ERROR = 'TBW080' as const;\n\n// --- Print (090–099) ---\n/** Print already in progress. */\nexport const PRINT_IN_PROGRESS = 'TBW090' as const;\n/** Grid not available for printing. */\nexport const PRINT_NO_GRID = 'TBW091' as const;\n/** Print operation failed. */\nexport const PRINT_FAILED = 'TBW092' as const;\n/** Multiple elements share the same grid ID (print isolation issue). */\nexport const PRINT_DUPLICATE_ID = 'TBW093' as const;\n\n// --- Clipboard (100–109) ---\n/** Clipboard API write failed. */\nexport const CLIPBOARD_FAILED = 'TBW100' as const;\n\n// --- Plugin-specific (110–119) ---\n/** ResponsivePlugin: no breakpoint configured. */\nexport const MISSING_BREAKPOINT = 'TBW110' as const;\n/** UndoRedoPlugin: transaction already in progress. */\nexport const TRANSACTION_IN_PROGRESS = 'TBW111' as const;\n/** UndoRedoPlugin: no transaction in progress. */\nexport const NO_TRANSACTION = 'TBW112' as const;\n/** GroupingColumnsPlugin: missing id or header on column group definition. */\nexport const COLUMN_GROUP_NO_ID = 'TBW113' as const;\n/** GroupingColumnsPlugin: conflicting columnGroups sources. */\nexport const COLUMN_GROUPS_CONFLICT = 'TBW114' as const;\n\n// --- Style injection (120–129) ---\n/** Failed to extract grid.css from document stylesheets. */\nexport const STYLE_EXTRACT_FAILED = 'TBW120' as const;\n/** Could not find grid.css in document.styleSheets. */\nexport const STYLE_NOT_FOUND = 'TBW121' as const;\n\n// --- Attribute parsing (130–139) ---\n/** Invalid JSON in an HTML attribute. */\nexport const INVALID_ATTRIBUTE_JSON = 'TBW130' as const;\n\n// --- DataSource / ServerSide (140–149) ---\n/** ServerSidePlugin: getRows() rejected. */\nexport const DATASOURCE_FETCH_ERROR = 'TBW140' as const;\n/** ServerSidePlugin: getChildRows() rejected. */\nexport const DATASOURCE_CHILD_FETCH_ERROR = 'TBW141' as const;\n/** ServerSidePlugin: getChildRows() not implemented but a plugin queried for children. */\nexport const DATASOURCE_NO_CHILD_HANDLER = 'TBW142' as const;\n/** ServerSidePlugin: concurrent request limit reached, request deferred. */\nexport const DATASOURCE_THROTTLED = 'TBW143' as const;\n\nexport type DiagnosticCode =\n  | typeof MISSING_PLUGIN\n  | typeof MISSING_PLUGIN_CONFIG\n  | typeof CONFIG_RULE_ERROR\n  | typeof CONFIG_RULE_WARN\n  | typeof MISSING_DEPENDENCY\n  | typeof OPTIONAL_DEPENDENCY\n  | typeof INCOMPATIBLE_PLUGINS\n  | typeof PLUGIN_ALIAS_COLLAPSE\n  | typeof PLUGIN_EVENT_ERROR\n  | typeof PLUGIN_ALIAS_CONFIG_CONFLICT\n  | typeof FEATURE_REREGISTERED\n  | typeof FEATURE_NOT_IMPORTED\n  | typeof FEATURE_MISSING_DEP\n  | typeof MISSING_ROW_ID\n  | typeof ROW_NOT_FOUND\n  | typeof INVALID_COLUMN_WIDTH\n  | typeof ROW_CLASS_ERROR\n  | typeof CELL_CLASS_ERROR\n  | typeof FORMAT_ERROR\n  | typeof VIEW_MOUNT_ERROR\n  | typeof VIEW_DISPATCH_ERROR\n  | typeof TOOL_PANEL_MISSING_ATTR\n  | typeof NO_TOOL_PANELS\n  | typeof TOOL_PANEL_NOT_FOUND\n  | typeof TOOL_PANEL_DUPLICATE\n  | typeof HEADER_CONTENT_DUPLICATE\n  | typeof TOOLBAR_CONTENT_DUPLICATE\n  | typeof EDITOR_MOUNT_ERROR\n  | typeof PRINT_IN_PROGRESS\n  | typeof PRINT_NO_GRID\n  | typeof PRINT_FAILED\n  | typeof PRINT_DUPLICATE_ID\n  | typeof CLIPBOARD_FAILED\n  | typeof MISSING_BREAKPOINT\n  | typeof TRANSACTION_IN_PROGRESS\n  | typeof NO_TRANSACTION\n  | typeof COLUMN_GROUP_NO_ID\n  | typeof COLUMN_GROUPS_CONFLICT\n  | typeof STYLE_EXTRACT_FAILED\n  | typeof STYLE_NOT_FOUND\n  | typeof INVALID_ATTRIBUTE_JSON\n  | typeof DATASOURCE_FETCH_ERROR\n  | typeof DATASOURCE_CHILD_FETCH_ERROR\n  | typeof DATASOURCE_NO_CHILD_HANDLER\n  | typeof DATASOURCE_THROTTLED;\n\n// #endregion\n\n// #region Docs URL\n\nconst DOCS_BASE = 'https://toolboxjs.com/grid/errors';\n\n/** Build a direct link to the troubleshooting section for a code. */\nfunction docsUrl(code: DiagnosticCode): string {\n  return `${DOCS_BASE}#${code.toLowerCase()}`;\n}\n\n// #endregion\n\n// #region Formatting\n\n/**\n * Format a diagnostic message with prefix, code, and docs link.\n *\n * Output format:\n * ```\n * [tbw-grid#my-id] TBW001: Your message here.\n *\n *   → More info: https://toolboxjs.com/grid/errors#tbw001\n * ```\n */\nexport function formatDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): string {\n  const prefix = gridPrefix(gridId, pluginName);\n  return `${prefix} ${code}: ${message}\\n\\n  → More info: ${docsUrl(code)}`;\n}\n\n// #endregion\n\n// #region Public API\n\n/**\n * Throw an error with a diagnostic code and docs link.\n * Use for configuration errors and API misuse that should halt execution.\n */\nexport function throwDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): never {\n  throw new Error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a warning with a diagnostic code and docs link.\n * Use for recoverable issues the developer should fix.\n */\nexport function warnDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.warn(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log a debug message with a diagnostic code and docs link.\n * Use for optional/soft dependency notifications — visible only when\n * the browser DevTools \"Verbose\" log level is enabled.\n */\nexport function debugDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.debug(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n/**\n * Log an error with a diagnostic code and docs link.\n * Use for non-throwing errors (e.g., failed async operations).\n */\nexport function errorDiagnostic(code: DiagnosticCode, message: string, gridId?: string, pluginName?: string): void {\n  console.error(formatDiagnostic(code, message, gridId, pluginName));\n}\n\n// #endregion\n","/**\n * Runtime default values for grid configuration.\n *\n * Kept out of `core/types.ts` so that file stays type-only apart from the two\n * enum-like consts whose `type` aliases are derived from them via `typeof`.\n * Import types from `./types`; import the values that back them from here.\n */\n\nimport type { A11yMessages, AnimationConfig, GridIcons } from './types';\n\n/**\n * Default English announcement messages.\n * Used when no custom messages are provided via {@link A11yConfig.messages}.\n * @since 2.0.0\n */\nexport const DEFAULT_A11Y_MESSAGES: Required<A11yMessages> = {\n  sortApplied: (column, direction) => `Sorted by ${column}, ${direction}`,\n  sortCleared: () => 'Sort cleared',\n  filterApplied: (column) => `Filter applied on ${column}`,\n  filterCleared: (column) => `Filter cleared from ${column}`,\n  allFiltersCleared: () => 'All filters cleared',\n  groupExpanded: (name, count) => `Group ${name} expanded, ${count} rows`,\n  groupCollapsed: (name) => `Group ${name} collapsed`,\n  selectionChanged: (count) => `${count} rows selected`,\n  selectAllRows: () => 'Select all rows',\n  selectRow: (rowIndex) => `Select row ${rowIndex + 1}`,\n  columnSelected: (label) => `Column ${label} selected`,\n  columnSelectionChanged: (count) => `${count} columns selected`,\n  columnSelectionCleared: () => 'Column selection cleared',\n  selectionAxisChanged: (toAxis) =>\n    toAxis === 'column'\n      ? 'Row selection cleared, column selection active'\n      : 'Column selection cleared, row selection active',\n  rangeSpanSelected: (axis, count) =>\n    count === 1 ? `${axis === 'row' ? 'Row' : 'Column'} selected` : `${count} ${axis}s selected`,\n  editingStarted: (rowIndex) => `Editing row ${rowIndex + 1}`,\n  editingCommitted: (rowIndex) => `Row ${rowIndex + 1} saved`,\n  dataLoaded: (count) => `${count} rows loaded`,\n};\n\n/**\n * Default animation configuration\n * @since 0.2.7\n */\nexport const DEFAULT_ANIMATION_CONFIG: Required<Omit<AnimationConfig, 'sort'>> = {\n  mode: 'reduced-motion',\n  duration: 200,\n  easing: 'ease-out',\n};\n\n/**\n * Default icons used when not overridden. Most entries are short text/emoji;\n * `filter` and `filterActive` are empty strings because the actual rendering\n * is driven by the `--tbw-icon-filter[-active]-mask` CSS custom properties\n * (see `core/styles/variables.css`). Userland that wants an HTML/SVG fallback\n * via `gridConfig.icons.filter = '<svg…>'` is unaffected — that path overrides this default.\n * @since 0.1.1\n */\nexport const DEFAULT_GRID_ICONS: Required<GridIcons> = {\n  expand: '▶',\n  collapse: '▼',\n  sortAsc: '▲',\n  sortDesc: '▼',\n  sortNone: '⇅',\n  submenuArrow: '▶',\n  dragHandle: '⋮⋮',\n  toolPanel: '☰',\n  filter: '',\n  filterActive: '',\n  print: '🖨️',\n};\n","// Centralized template expression evaluation & sanitization utilities.\n// Responsible for safely interpolating {{ }} expressions while blocking\n// access to dangerous globals / reflective capabilities.\nimport type { CompiledViewFunction, EvalContext } from '../types';\n\n// #region Constants\nconst EXPR_RE = /{{\\s*([^}]+)\\s*}}/g;\nconst EMPTY_SENTINEL = '__DG_EMPTY__';\nconst SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/;\n\n// Forbidden identifiers built at runtime to avoid static analysis scanners\n// from flagging string literals (e.g. socket.dev \"network access\" / \"uses eval\").\n// Stored as reversed, pipe-delimited tokens — reversed back when constructing the regex.\nconst _F =\n  '__otorp__|__retteGenifed__|__retteSenifed__|rotcurtsnoc|wodniw|sihTlabolg|labolg|ssecorp|noitcnuF|tropmi|lave|tcelfeR|yxorP|rorrE|stnemugra|tnemucod|noitacol|eikooc|egarotSlacol|egarotSnoisses|BDdexedni|hctef|tseuqeRpttHLMX|tekcoSbeW|rekroW|rekroWderahS|rekroWecivreS|renepo|tnerap|pot|semarf|fles'\n    .split('|')\n    .map((s) => s.split('').reverse().join(''));\nconst FORBIDDEN = new RegExp(`__(proto|defineGetter|defineSetter)|${_F.slice(3).join('|')}|this\\\\b`);\n// #endregion\n\n// #region HTML Sanitization\n\n/**\n * Escape a plain text string for safe insertion into HTML.\n * Converts special HTML characters to their entity equivalents.\n *\n * @param text - Plain text string to escape\n * @returns HTML-safe string\n */\nexport function escapeHtml(text: string): string {\n  if (!text || typeof text !== 'string') return '';\n  return text\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;');\n}\n\n/**\n * Tags that are considered dangerous and will be completely removed.\n * These can execute scripts, load external resources, or manipulate the page.\n */\nconst DANGEROUS_TAGS = new Set(\n  'script|iframe|object|embed|form|input|button|textarea|select|link|meta|base|style|template|slot|portal|frame|frameset|applet|noscript|noembed|plaintext|xmp|listing|math'.split(\n    '|',\n  ),\n);\n\n/**\n * Attributes that are considered dangerous - event handlers and data loading.\n */\nconst DANGEROUS_ATTR_PATTERN = /^on\\w+$/i;\n\n/**\n * Attributes that can contain URLs which might be javascript: or data: URIs.\n */\nconst URL_ATTRS = new Set('href|src|action|formaction|data|srcdoc|xlink:href|poster|srcset'.split('|'));\n\n/**\n * Protocol patterns that are dangerous in URLs.\n */\nconst DANGEROUS_URL_PROTOCOL = /^\\s*(javascript|vbscript|data|blob):/i;\n\n/**\n * Sanitize an HTML string by removing dangerous tags and attributes.\n *\n * Prefer {@link setSanitizedHTML} wherever the result is destined for an\n * element: this function has to re-serialize the sanitized tree back to a\n * string, and the caller's `innerHTML =` then re-parses it. That\n * parse→serialize→parse round trip is the classic mutation-XSS vector, and it\n * costs a second parse. Use this overload only when a string is genuinely\n * required (e.g. the value is stored, compared, or handed to another API).\n *\n * @param html - Raw HTML string to sanitize\n * @returns Sanitized HTML string safe for innerHTML\n */\nexport function sanitizeHTML(html: string): string {\n  if (!html || typeof html !== 'string') return '';\n\n  // Fast path: if no HTML tags at all, return as-is (already safe)\n  if (html.indexOf('<') === -1) return html;\n\n  const template = document.createElement('template');\n  template.innerHTML = html;\n\n  sanitizeNode(template.content);\n\n  return template.innerHTML;\n}\n\n/**\n * Parse and sanitize an HTML string into a detached {@link DocumentFragment}.\n *\n * This is the primitive {@link setSanitizedHTML} builds on, exposed for callers\n * that need to inspect or relocate the nodes before insertion.\n *\n * @param html - Raw HTML string to sanitize\n * @returns Fragment containing the sanitized nodes (empty for falsy input)\n */\nexport function sanitizeToFragment(html: string): DocumentFragment {\n  const template = document.createElement('template');\n  if (html && typeof html === 'string') {\n    template.innerHTML = html;\n    sanitizeNode(template.content);\n  }\n  return template.content;\n}\n\n/**\n * Replace an element's children with the sanitized parse of `html`.\n *\n * **This is the canonical sink for user-supplied markup** — cell/header/group\n * renderer string returns, `gridConfig.icons.*`, light-DOM tool panel fallback\n * content, and any new extension point that turns a user string into markup.\n * `textContent` is wrong here (it renders SVG icon strings as literal text) and\n * raw `innerHTML` is wrong (it is an XSS sink).\n *\n * Nodes are moved from the parse fragment rather than re-serialized, so the\n * sanitized tree is exactly what lands in the document.\n *\n * @param el - Element whose children are replaced\n * @param html - Raw HTML string to sanitize and insert\n */\nexport function setSanitizedHTML(el: Element, html: string): void {\n  if (!html || typeof html !== 'string') {\n    el.replaceChildren();\n    return;\n  }\n  // Nothing for the parser to do: no markup and no entities to decode.\n  if (html.indexOf('<') === -1 && html.indexOf('&') === -1) {\n    el.textContent = html;\n    return;\n  }\n  el.replaceChildren(sanitizeToFragment(html));\n}\n\n/**\n * Recursively sanitize a DOM node tree.\n */\nfunction sanitizeNode(root: DocumentFragment | Element): void {\n  const toRemove: Element[] = [];\n\n  // Use querySelectorAll to find all elements, then filter\n  const elements = root.querySelectorAll('*');\n\n  for (const el of elements) {\n    const tagName = el.tagName.toLowerCase();\n\n    // Check if tag is dangerous\n    if (DANGEROUS_TAGS.has(tagName)) {\n      toRemove.push(el);\n      continue;\n    }\n\n    // SVG elements need special handling - they can contain script-like behavior\n    if (tagName === 'svg' || el.namespaceURI === 'http://www.w3.org/2000/svg') {\n      // Remove entire SVG if it has any suspicious attributes\n      const hasDangerousContent = Array.from(el.attributes).some(\n        (attr) => DANGEROUS_ATTR_PATTERN.test(attr.name) || attr.name === 'href' || attr.name === 'xlink:href',\n      );\n      if (hasDangerousContent) {\n        toRemove.push(el);\n        continue;\n      }\n    }\n\n    // Check and remove dangerous attributes\n    const attrsToRemove: string[] = [];\n    for (const attr of el.attributes) {\n      const attrName = attr.name.toLowerCase();\n\n      // Event handlers (onclick, onerror, onload, etc.)\n      if (DANGEROUS_ATTR_PATTERN.test(attrName)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // `is=` upgrades a plain tag into a registered customized built-in, so it\n      // can smuggle behaviour past the tag-name check above.\n      if (attrName === 'is') {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // URL attributes with dangerous protocols\n      if (URL_ATTRS.has(attrName) && DANGEROUS_URL_PROTOCOL.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n\n      // style attribute can contain expressions (IE) or url() with javascript:\n      if (attrName === 'style' && /expression\\s*\\(|javascript:|behavior\\s*:/i.test(attr.value)) {\n        attrsToRemove.push(attr.name);\n        continue;\n      }\n    }\n\n    attrsToRemove.forEach((name) => el.removeAttribute(name));\n  }\n\n  // Remove dangerous elements (do this after iteration to avoid modifying during traversal)\n  toRemove.forEach((el) => el.remove());\n}\n\n// #endregion\n\n// #region Template Evaluation\n\n// #region Safe Expression Evaluator\n// A minimal recursive-descent evaluator for the token set allowed by SAFE_EXPR.\n// Replaces `new Function()` to avoid dynamic code execution warnings from\n// static analysis tools (socket.dev, npm audit) while maintaining identical\n// functionality for expressions that pass the allowlist guards.\n//\n// Supported grammar (matching SAFE_EXPR = /^[\\w$. '?+\\-*/%:()!<>=,&|]+$/):\n//   ternary     → logicalOr ('?' ternary ':' ternary)?\n//   logicalOr   → logicalAnd ('||' logicalAnd)*\n//   logicalAnd  → equality ('&&' equality)*\n//   equality    → comparison (('==' | '!=' | '===' | '!==') comparison)*\n//   comparison  → additive (('<' | '>' | '<=' | '>=') additive)*\n//   additive    → multiplicative (('+' | '-') multiplicative)*\n//   multiplicative → unary (('*' | '/' | '%') unary)*\n//   unary       → '!' unary | primary\n//   primary     → NUMBER | STRING | IDENT ('.' IDENT)? | '(' ternary ')'\n\ntype Token =\n  { type: 'num'; v: number } | { type: 'str'; v: string } | { type: 'id'; v: string } | { type: 'op'; v: string };\n\nfunction tokenize(expr: string): Token[] | null {\n  const tokens: Token[] = [];\n  let i = 0;\n  while (i < expr.length) {\n    const ch = expr[i];\n    if (ch === ' ') {\n      i++;\n      continue;\n    }\n\n    // Numbers\n    if ((ch >= '0' && ch <= '9') || (ch === '.' && i + 1 < expr.length && expr[i + 1] >= '0' && expr[i + 1] <= '9')) {\n      const start = i;\n      while (i < expr.length && ((expr[i] >= '0' && expr[i] <= '9') || expr[i] === '.')) i++;\n      tokens.push({ type: 'num', v: Number(expr.slice(start, i)) });\n      continue;\n    }\n\n    // String literals (single-quoted only, per SAFE_EXPR)\n    if (ch === \"'\") {\n      let s = '';\n      i++; // skip opening quote\n      while (i < expr.length && expr[i] !== \"'\") s += expr[i++];\n      if (i >= expr.length) return null; // unterminated\n      i++; // skip closing quote\n      tokens.push({ type: 'str', v: s });\n      continue;\n    }\n\n    // Identifiers (value, row, row.field)\n    if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_' || ch === '$') {\n      const start = i;\n      while (i < expr.length && /[\\w$.]/.test(expr[i])) i++;\n      tokens.push({ type: 'id', v: expr.slice(start, i) });\n      continue;\n    }\n\n    // Multi-char operators\n    if (i + 2 < expr.length) {\n      const tri = expr.slice(i, i + 3);\n      if (tri === '===' || tri === '!==') {\n        tokens.push({ type: 'op', v: tri });\n        i += 3;\n        continue;\n      }\n    }\n    if (i + 1 < expr.length) {\n      const bi = expr.slice(i, i + 2);\n      if (bi === '==' || bi === '!=' || bi === '<=' || bi === '>=' || bi === '&&' || bi === '||') {\n        tokens.push({ type: 'op', v: bi });\n        i += 2;\n        continue;\n      }\n    }\n\n    // Single-char operators\n    if ('+-*/%<>!?:(),'.includes(ch)) {\n      tokens.push({ type: 'op', v: ch });\n      i++;\n      continue;\n    }\n\n    return null; // unexpected character\n  }\n  return tokens;\n}\n\nfunction safeEval(expr: string, ctx: EvalContext): unknown {\n  const toks = tokenize(expr);\n  if (!toks) return undefined;\n  const tokens: Token[] = toks;\n  let pos = 0;\n\n  function peek(): Token | undefined {\n    return tokens[pos];\n  }\n  function advance(): Token {\n    return tokens[pos++];\n  }\n  function match(type: string, val?: string): boolean {\n    const t = peek();\n    if (!t) return false;\n    if (t.type !== type) return false;\n    if (val !== undefined && t.v !== val) return false;\n    return true;\n  }\n\n  function resolveId(name: string): unknown {\n    if (name === 'value') return ctx.value;\n    if (name.startsWith('row.')) {\n      const key = name.slice(4);\n      return ctx.row ? ctx.row[key] : undefined;\n    }\n    if (name.startsWith('typeDefault.')) {\n      const key = name.slice('typeDefault.'.length);\n      return ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    }\n    // bare 'row' reference\n    if (name === 'row') return ctx.row;\n    if (name === 'typeDefault') return ctx.typeDefault;\n    return undefined;\n  }\n\n  function parseTernary(): unknown {\n    const result = parseLogicalOr();\n    if (match('op', '?')) {\n      advance(); // consume '?'\n      const consequent = parseTernary();\n      if (!match('op', ':')) return undefined;\n      advance(); // consume ':'\n      const alternate = parseTernary();\n      return result ? consequent : alternate;\n    }\n    return result;\n  }\n\n  function parseLogicalOr(): unknown {\n    let left = parseLogicalAnd();\n    while (match('op', '||')) {\n      advance();\n      left = left || parseLogicalAnd();\n    }\n    return left;\n  }\n\n  function parseLogicalAnd(): unknown {\n    let left = parseEquality();\n    while (match('op', '&&')) {\n      advance();\n      left = left && parseEquality();\n    }\n    return left;\n  }\n\n  function parseEquality(): unknown {\n    let left = parseComparison();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '===') {\n        advance();\n        left = left === parseComparison();\n      } else if (t.v === '!==') {\n        advance();\n        left = left !== parseComparison();\n      } else if (t.v === '==') {\n        advance();\n        left = left == parseComparison();\n      } else if (t.v === '!=') {\n        advance();\n        left = left != parseComparison();\n      } else break;\n    }\n    return left;\n  }\n\n  function parseComparison(): unknown {\n    let left = parseAdditive();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '<') {\n        advance();\n        left = (left as number) < (parseAdditive() as number);\n      } else if (t.v === '>') {\n        advance();\n        left = (left as number) > (parseAdditive() as number);\n      } else if (t.v === '<=') {\n        advance();\n        left = (left as number) <= (parseAdditive() as number);\n      } else if (t.v === '>=') {\n        advance();\n        left = (left as number) >= (parseAdditive() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseAdditive(): unknown {\n    let left = parseMultiplicative();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '+') {\n        advance();\n        left = (left as number) + (parseMultiplicative() as number);\n      } else if (t.v === '-') {\n        advance();\n        left = (left as number) - (parseMultiplicative() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseMultiplicative(): unknown {\n    let left = parseUnary();\n    while (true) {\n      const t = peek();\n      if (!t || t.type !== 'op') break;\n      if (t.v === '*') {\n        advance();\n        left = (left as number) * (parseUnary() as number);\n      } else if (t.v === '/') {\n        advance();\n        left = (left as number) / (parseUnary() as number);\n      } else if (t.v === '%') {\n        advance();\n        left = (left as number) % (parseUnary() as number);\n      } else break;\n    }\n    return left;\n  }\n\n  function parseUnary(): unknown {\n    if (match('op', '!')) {\n      advance();\n      return !parseUnary();\n    }\n    return parsePrimary();\n  }\n\n  function parsePrimary(): unknown {\n    const t = peek();\n    if (!t) return undefined;\n    if (t.type === 'num') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'str') {\n      advance();\n      return t.v;\n    }\n    if (t.type === 'id') {\n      advance();\n      return resolveId(t.v as string);\n    }\n    if (t.type === 'op' && t.v === '(') {\n      advance(); // consume '('\n      const result = parseTernary();\n      if (match('op', ')')) advance(); // consume ')'\n      return result;\n    }\n    // Unary minus for negative numbers\n    if (t.type === 'op' && t.v === '-') {\n      advance();\n      return -(parsePrimary() as number);\n    }\n    return undefined;\n  }\n\n  const result = parseTernary();\n  // Ensure all tokens were consumed\n  if (pos < tokens.length) return undefined;\n  return result;\n}\n// #endregion\n\nexport function evalTemplateString(raw: string, ctx: EvalContext): string {\n  if (!raw || raw.indexOf('{{') === -1) return raw; // fast path (no expressions)\n  const parts: { expr: string; result: string }[] = [];\n  const evaluated = raw.replace(EXPR_RE, (_m, expr) => {\n    const res = evalSingle(expr, ctx);\n    parts.push({ expr: expr.trim(), result: res });\n    // The template markup is author-controlled; the interpolated data is not.\n    // Escaping here stops row data from injecting elements or breaking out of\n    // an attribute (sanitizeHTML downstream only strips *dangerous* markup).\n    return res === EMPTY_SENTINEL ? res : escapeHtml(res);\n  });\n  const finalStr = postProcess(evaluated);\n  // If every part evaluated to EMPTY_SENTINEL we treat this as intentionally blank.\n  // If any expression was blocked due to forbidden token (EMPTY_SENTINEL) we *still* only output ''\n  // but do not escalate to BLOCKED_SENTINEL unless the original contained explicit forbidden tokens.\n  const allEmpty = parts.length && parts.every((p) => p.result === '' || p.result === EMPTY_SENTINEL);\n  const hadForbidden = REFLECTIVE_RE.test(raw);\n  if (hadForbidden || allEmpty) return '';\n  return finalStr;\n}\n\nfunction evalSingle(expr: string, ctx: EvalContext): string {\n  expr = (expr || '').trim();\n  if (!expr) return EMPTY_SENTINEL;\n  if (REFLECTIVE_RE.test(expr)) return EMPTY_SENTINEL;\n  if (expr === 'value') return ctx.value == null ? EMPTY_SENTINEL : String(ctx.value);\n  if (expr.startsWith('row.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice(4);\n    const v = ctx.row ? ctx.row[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.startsWith('typeDefault.') && !/[()?]/.test(expr) && !expr.includes(':')) {\n    const key = expr.slice('typeDefault.'.length);\n    const v = ctx.typeDefault ? ctx.typeDefault[key] : undefined;\n    return v == null ? EMPTY_SENTINEL : String(v);\n  }\n  if (expr.length > 80) return EMPTY_SENTINEL;\n  if (!SAFE_EXPR.test(expr) || FORBIDDEN.test(expr)) return EMPTY_SENTINEL;\n  const dotChain = expr.match(/\\./g);\n  if (dotChain && dotChain.length > 1) return EMPTY_SENTINEL;\n  try {\n    const out = safeEval(expr, ctx);\n    const str = out == null ? '' : String(out);\n    if (REFLECTIVE_RE.test(str)) return EMPTY_SENTINEL;\n    return str || EMPTY_SENTINEL;\n  } catch {\n    return EMPTY_SENTINEL;\n  }\n}\n// #endregion\n\n// #region Cell Scrubbing\n/** Pattern matching reflective/introspective APIs that must be stripped from output. */\nconst REFLECTIVE_RE = /Reflect|Proxy|ownKeys/;\n\nfunction postProcess(s: string): string {\n  if (!s) return s;\n  return s.replace(new RegExp(EMPTY_SENTINEL, 'g'), '').replace(/Reflect\\.[^<>{}\\s]+|\\bProxy\\b|ownKeys\\([^)]*\\)/g, '');\n}\n\nexport function finalCellScrub(cell: HTMLElement): void {\n  if (!REFLECTIVE_RE.test(cell.textContent || '')) return;\n  // First pass: clear only text nodes containing forbidden tokens\n  for (const n of cell.childNodes) {\n    if (n.nodeType === Node.TEXT_NODE && REFLECTIVE_RE.test(n.textContent || '')) n.textContent = '';\n  }\n  // If forbidden tokens persist in element nodes, nuke everything\n  if (REFLECTIVE_RE.test(cell.textContent || '')) {\n    cell.textContent = '';\n  }\n}\n// #endregion\n\n// #region Template Compilation\nexport function compileTemplate(raw: string) {\n  if (REFLECTIVE_RE.test(raw)) {\n    const fn = (() => '') as CompiledViewFunction;\n    fn.__blocked = true;\n    return fn;\n  }\n  const fn = ((ctx: EvalContext) => evalTemplateString(raw, ctx)) as CompiledViewFunction;\n  fn.__blocked = false;\n  return fn;\n}\n// #endregion\n","/**\n * Base Grid Plugin Class\n *\n * All plugins extend this abstract class.\n * Plugins are instantiated per-grid and manage their own state.\n */\n\n// Injected by Vite at build time from package.json (same as grid.ts)\ndeclare const __GRID_VERSION__: string;\n\nimport type { HeaderContentDefinition, ToolPanelDefinition } from '../../plugins/shell/types';\nimport { DEFAULT_GRID_ICONS } from '../defaults';\nimport {\n  type DiagnosticCode,\n  PLUGIN_ALIAS_CONFIG_CONFLICT,\n  formatDiagnostic,\n  gridPrefix,\n} from '../internal/diagnostics';\nimport { setSanitizedHTML } from '../internal/sanitize';\nimport type {\n  ColumnConfig,\n  ColumnState,\n  GridConfig,\n  GridIcons,\n  GridPlugin,\n  IconValue,\n  PluginNameMap,\n  Translate,\n} from '../types';\n\n// Re-export shared plugin types for convenience\nexport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellCoords,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  ContextMenuItem,\n  ContextMenuParams,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  KeyboardModifiers,\n  PluginCellRenderContext,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\nimport type {\n  AfterCellRenderContext,\n  AfterRowRenderContext,\n  CellClickEvent,\n  CellEditor,\n  CellMouseEvent,\n  CellRenderer,\n  GridElementRef,\n  HeaderClickEvent,\n  HeaderRenderer,\n  PluginQuery,\n  RowClickEvent,\n  ScrollEvent,\n} from './types';\n\n/**\n * Grid element interface for plugins.\n * Extends GridElementRef with plugin-specific methods.\n * Note: effectiveConfig is already available from GridElementRef.\n */\nexport interface GridElement extends GridElementRef {\n  getPlugin<T extends GridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined;\n  getPluginByName<K extends string>(\n    name: K,\n  ): (K extends keyof PluginNameMap ? PluginNameMap[K] : BaseGridPlugin) | undefined;\n  /**\n   * Get a plugin's state by plugin name.\n   * This is a loose-coupling method for plugins to access other plugins' state\n   * without importing the plugin class directly.\n   * @internal Plugin API\n   */\n  getPluginState?(name: string): unknown;\n\n  // Focus Management\n  /** Register an external DOM element as a logical focus container. @internal Plugin API */\n  registerExternalFocusContainer?(el: Element): void;\n  /** Unregister a previously registered external focus container. @internal Plugin API */\n  unregisterExternalFocusContainer?(el: Element): void;\n  /** Check whether focus is logically inside this grid (own DOM + external containers). @internal Plugin API */\n  containsFocus?(node?: Node | null): boolean;\n}\n\n/**\n * Header render context for plugin header renderers.\n */\nexport interface PluginHeaderRenderContext {\n  /** Column configuration */\n  column: ColumnConfig;\n  /** Column index */\n  colIndex: number;\n}\n\n// ============================================================================\n// Plugin Dependency Types\n// ============================================================================\n\n/**\n * Declares a dependency on another plugin.\n *\n * @category Plugin Development\n * @example\n * ```typescript\n * export class UndoRedoPlugin extends BaseGridPlugin {\n *   static readonly dependencies: PluginDependency[] = [\n *     { name: 'editing', required: true },\n *   ];\n * }\n * ```\n * @since 0.4.1\n */\nexport interface PluginDependency {\n  /**\n   * The name of the required plugin (matches the plugin's `name` property).\n   * Use string names for loose coupling - avoids static imports.\n   */\n  name: string;\n\n  /**\n   * Whether this dependency is required (hard) or optional (soft).\n   * - `true`: Plugin cannot function without it. Throws error if missing.\n   * - `false`: Plugin works with reduced functionality. Silent if missing\n   *   (set {@link severity} to `'warn'` or `'info'` to opt into a message).\n   * @default true\n   */\n  required?: boolean;\n\n  /**\n   * Explicit severity when this dependency is missing. Overrides the default\n   * derived from {@link required}.\n   * - `'error'`: throw (halts grid setup). Default when `required` is not `false`.\n   * - `'warn'`: log a console warning and continue (development only).\n   * - `'info'`: log a verbose console.debug message and continue (development only).\n   *\n   * When omitted, a missing hard dependency throws and a missing soft\n   * dependency is silent — preserving backward-compatible behavior.\n   * @since 2.16.0\n   */\n  severity?: 'error' | 'warn' | 'info';\n\n  /**\n   * Optional predicate that gates whether this dependency applies, evaluated\n   * against the depending plugin's own resolved configuration (defaults merged\n   * with user config). Return `false` to skip the dependency entirely.\n   *\n   * Lets a plugin require/recommend another plugin only under certain config\n   * — e.g. a plugin that needs a tool-panel host only when its tool panel is\n   * enabled. When omitted, the dependency always applies.\n   * @example when: (cfg: PivotConfig) => cfg.showToolPanel === true\n   * @since 2.16.0\n   */\n  when?: (pluginConfig: unknown) => boolean;\n\n  /**\n   * Factory for a default instance of the dependency. When the dependency is\n   * missing, the grid attaches the instance this returns (once per grid,\n   * before the depending plugin) instead of reporting an error, so consumers\n   * never have to add it themselves. An explicitly configured instance always\n   * wins.\n   *\n   * Import the dependency's plugin module statically so it ships with the\n   * depending plugin's module graph — never with `import()`.\n   *\n   * @example provide: () => new HierarchyPlugin()\n   * @since 3.9.0\n   */\n  provide?: () => BaseGridPlugin;\n\n  /**\n   * Human-readable reason for this dependency.\n   * Shown in error/info messages to help users understand why.\n   * @example \"UndoRedoPlugin needs EditingPlugin to track cell edits\"\n   */\n  reason?: string;\n}\n\n/**\n * Declares an incompatibility between plugins.\n * When both plugins are loaded, a warning is logged to help users understand the conflict.\n *\n * @category Plugin Development\n */\nexport interface PluginIncompatibility {\n  /**\n   * The name of the incompatible plugin (matches the plugin's `name` property).\n   */\n  name: string;\n\n  /**\n   * Human-readable reason for the incompatibility.\n   * Should explain why the plugins conflict and any workarounds.\n   * @example \"Both transform the entire row model in different ways\"\n   */\n  reason: string;\n}\n\n// ============================================================================\n// Plugin Query & Event Definitions\n// ============================================================================\n\n/**\n * Defines a query that a plugin can handle.\n * Other plugins or the grid can send this query type to retrieve data.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * queries: [\n *   {\n *     type: 'canMoveColumn',\n *     description: 'Check if a column can be moved/reordered',\n *   },\n * ]\n *\n * // In plugin class\n * handleQuery(query: PluginQuery): unknown {\n *   if (query.type === 'canMoveColumn') {\n *     return this.canMoveColumn(query.context);\n *   }\n * }\n * ```\n * @since 1.8.0\n */\nexport interface QueryDefinition {\n  /**\n   * The query type identifier (e.g., 'canMoveColumn', 'getContextMenuItems').\n   * Should be unique across all plugins.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the query does.\n   */\n  description?: string;\n}\n\n/**\n * Defines an event that a plugin can emit.\n * Other plugins can subscribe to these events via the Event Bus.\n *\n * @category Plugin Development\n *\n * @example\n * ```typescript\n * // In manifest\n * events: [\n *   {\n *     type: 'filter-change',\n *     description: 'Emitted when filter criteria change',\n *   },\n * ]\n *\n * // In plugin class - emit\n * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n *\n * // In another plugin - subscribe\n * this.on('filter-change', (detail) => console.log('Filter changed:', detail));\n * ```\n * @since 1.8.0\n */\nexport interface EventDefinition {\n  /**\n   * The event type identifier (e.g., 'filter-change', 'selection-change').\n   * Used when emitting and subscribing to events.\n   */\n  type: string;\n\n  /**\n   * Human-readable description of what the event represents.\n   */\n  description?: string;\n\n  /**\n   * Whether this event is cancelable via `event.preventDefault()`.\n   * @default false\n   */\n  cancelable?: boolean;\n}\n\n// ============================================================================\n// Plugin Manifest Types\n// ============================================================================\n\n/**\n * Defines a property that a plugin \"owns\" - used for configuration validation.\n * When this property is used without the owning plugin loaded, an error is thrown.\n *\n * @category Plugin Development\n */\nexport interface PluginPropertyDefinition {\n  /** The property name on column or grid config */\n  property: string;\n  /** Whether this is a column-level or config-level property */\n  level: 'column' | 'config';\n  /** Human-readable description for error messages (e.g., 'the \"editable\" column property') */\n  description: string;\n  /** Import path hint for error messages (e.g., \"import { EditingPlugin } from '@toolbox-web/grid/plugins/editing';\") */\n  importHint?: string;\n  /** Custom check for whether property is considered \"used\" (default: truthy value check) */\n  isUsed?: (value: unknown) => boolean;\n}\n\n/**\n * A configuration validation rule for detecting invalid/conflicting settings.\n * Plugins declare rules in their manifest; the validator executes them during grid initialization.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n */\nexport interface PluginConfigRule<TConfig = unknown> {\n  /** Rule identifier for debugging (e.g., 'selection/range-dblclick') */\n  id: string;\n  /** Severity: 'error' throws, 'warn' logs warning */\n  severity: 'error' | 'warn';\n  /** Human-readable message shown when rule is violated */\n  message: string;\n  /** Predicate returning true if the rule is VIOLATED (i.e., config is invalid) */\n  check: (pluginConfig: TConfig) => boolean;\n}\n\n/**\n * Hook names that can have execution priority configured.\n *\n * @category Plugin Development\n */\nexport type HookName =\n  | 'processColumns'\n  | 'processConfig'\n  | 'processRows'\n  | 'afterStructuralRender'\n  | 'afterRender'\n  | 'afterCellRender'\n  | 'afterRowRender'\n  | 'onCellClick'\n  | 'onCellMouseDown'\n  | 'onCellMouseMove'\n  | 'onCellMouseUp'\n  | 'onHeaderClick'\n  | 'onKeyDown'\n  | 'onRowClick'\n  | 'onScroll'\n  | 'onScrollRender';\n\n/**\n * Static metadata about a plugin's capabilities and requirements.\n * Declared as a static property on plugin classes.\n *\n * @category Plugin Development\n * @template TConfig - The plugin's configuration type\n *\n * @example\n * ```typescript\n * export class MyPlugin extends BaseGridPlugin<MyConfig> {\n *   static override readonly manifest: PluginManifest<MyConfig> = {\n *     ownedProperties: [\n *       { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n *     ],\n *     configRules: [\n *       { id: 'my-plugin/invalid-combo', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n *     ],\n *   };\n *   readonly name = 'myPlugin';\n * }\n * ```\n * @since 1.1.0\n */\nexport interface PluginManifest<TConfig = unknown> {\n  /**\n   * Properties this plugin owns - validated by validate-config.ts.\n   * If a user uses one of these properties without loading the plugin, an error is thrown.\n   */\n  ownedProperties?: PluginPropertyDefinition[];\n\n  /**\n   * Hook execution priority (higher = later, default 0).\n   * Use negative values to run earlier, positive to run later.\n   */\n  hookPriority?: Partial<Record<HookName, number>>;\n\n  /**\n   * Configuration validation rules - checked during grid initialization.\n   * Rules with severity 'error' throw, 'warn' logs to console.\n   */\n  configRules?: PluginConfigRule<TConfig>[];\n\n  /**\n   * Plugins that are incompatible with this plugin.\n   * When both plugins are loaded together, a warning is shown.\n   *\n   * @example\n   * ```typescript\n   * incompatibleWith: [\n   *   { name: 'tree', reason: 'Both transform the entire row model in different ways' },\n   * ],\n   * ```\n   */\n  incompatibleWith?: PluginIncompatibility[];\n\n  /**\n   * Queries this plugin can handle.\n   * Declares what query types this plugin responds to via `handleQuery()`.\n   * This replaces the centralized PLUGIN_QUERIES approach with manifest-declared queries.\n   *\n   * @example\n   * ```typescript\n   * queries: [\n   *   { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   * ],\n   * ```\n   */\n  queries?: QueryDefinition[];\n\n  /**\n   * Events this plugin can emit.\n   * Declares what event types other plugins can subscribe to via `on()`.\n   *\n   * @example\n   * ```typescript\n   * events: [\n   *   { type: 'filter-change', description: 'Emitted when filter criteria change' },\n   * ],\n   * ```\n   */\n  events?: EventDefinition[];\n\n  /**\n   * Whether this plugin's `processRows` hook injects or removes rows\n   * (group headers, tree nodes, pivot aggregates, placeholders, etc.).\n   *\n   * When true, the core sorting module delegates to the render scheduler\n   * instead of sorting `_rows` in-place, because `_rows` may contain\n   * plugin-generated marker objects that would be corrupted by a direct sort.\n   *\n   * Plugins that only **filter** or **reorder** existing rows (e.g. Filtering,\n   * MultiSort) should leave this unset or set it to `false`.\n   */\n  modifiesRowStructure?: boolean;\n}\n\n/** Convert camelCase icon key to kebab-case data-icon attribute value. */\nexport function toIconAttr(key: string): string {\n  return key.replace(/([A-Z])/g, '-$1').toLowerCase();\n}\n\n/**\n * Abstract base class for all grid plugins.\n *\n * @category Plugin Development\n * @template TConfig - Configuration type for the plugin\n * @since 0.1.1\n */\nexport abstract class BaseGridPlugin<TConfig = unknown> implements GridPlugin {\n  /**\n   * Plugin dependencies - declare other plugins this one requires.\n   *\n   * Dependencies are validated when the plugin is attached.\n   * Required dependencies throw an error if missing. Optional dependencies are\n   * silent by default; set a {@link PluginDependency.severity} of `'warn'` or\n   * `'info'` to opt into a development-only log.\n   *\n   * @example\n   * ```typescript\n   * static readonly dependencies: PluginDependency[] = [\n   *   { name: 'editing', required: true, reason: 'Tracks cell edits for undo/redo' },\n   *   { name: 'selection', required: false, reason: 'Enables selection-based undo' },\n   * ];\n   * ```\n   */\n  static readonly dependencies?: PluginDependency[];\n\n  /**\n   * Plugin manifest - declares owned properties, config rules, and hook priorities.\n   *\n   * This is read by the configuration validator to:\n   * - Validate that required plugins are loaded when their properties are used\n   * - Execute configRules to detect invalid/conflicting settings\n   * - Order hook execution based on priority\n   *\n   * @example\n   * ```typescript\n   * static override readonly manifest: PluginManifest<MyConfig> = {\n   *   ownedProperties: [\n   *     { property: 'myProp', level: 'column', description: 'the \"myProp\" column property' },\n   *   ],\n   *   configRules: [\n   *     { id: 'myPlugin/conflict', severity: 'warn', message: '...', check: (c) => c.a && c.b },\n   *   ],\n   * };\n   * ```\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static readonly manifest?: PluginManifest<any>;\n\n  /** Unique plugin identifier (derived from class name by default) */\n  abstract readonly name: string;\n\n  /**\n   * Alternative names for backward compatibility.\n   * `getPluginByName()` matches against both `name` and `aliases`.\n   * @internal\n   */\n  readonly aliases?: readonly string[];\n\n  /**\n   * Plugin version - defaults to grid version for built-in plugins.\n   * Third-party plugins can override with their own semver.\n   */\n  readonly version: string = typeof __GRID_VERSION__ !== 'undefined' ? __GRID_VERSION__ : 'dev';\n\n  /** CSS styles to inject via `document.adoptedStyleSheets` */\n  readonly styles?: string;\n\n  /** Custom cell renderers keyed by type name */\n  readonly cellRenderers?: Record<string, CellRenderer>;\n\n  /** Custom header renderers keyed by type name */\n  readonly headerRenderers?: Record<string, HeaderRenderer>;\n\n  /** Custom cell editors keyed by type name */\n  readonly cellEditors?: Record<string, CellEditor>;\n\n  /** The grid instance this plugin is attached to */\n  protected grid!: GridElement;\n\n  /** Plugin configuration - merged with defaults in attach() */\n  protected config!: TConfig;\n\n  /** User-provided configuration from constructor */\n  protected readonly userConfig: Partial<TConfig>;\n\n  /**\n   * Plugin-level AbortController for event listener cleanup.\n   * Created fresh in attach(), aborted in detach().\n   * This ensures event listeners are properly cleaned up when plugins are re-attached.\n   */\n  #abortController?: AbortController;\n\n  /**\n   * Default configuration - subclasses should override this getter.\n   * Note: This must be a getter (not property initializer) for proper inheritance\n   * since property initializers run after parent constructor.\n   */\n  protected get defaultConfig(): Partial<TConfig> {\n    return {};\n  }\n\n  constructor(config: Partial<TConfig> = {}) {\n    this.userConfig = config;\n  }\n\n  /**\n   * Effective configuration (defaults merged with user config), resolved\n   * eagerly so it is available **before** {@link attach} runs. Dependency\n   * validation happens before `attach()` merges {@link config}, so config\n   * -conditional dependency `when` predicates evaluate against this getter.\n   *\n   * While attached, returns the already-merged {@link config}; otherwise\n   * recomputes `defaultConfig` + `userConfig` fresh. `config` is intentionally\n   * **not** trusted when detached because {@link detach} does not clear it — a\n   * re-validated plugin would otherwise see stale config from a prior\n   * attachment. The {@link attach}-managed abort controller is the\n   * attached/detached signal.\n   * @internal Plugin infrastructure (used by `validatePluginDependencies`).\n   */\n  get resolvedConfig(): TConfig {\n    return (this.#abortController ? this.config : { ...this.defaultConfig, ...this.userConfig }) as TConfig;\n  }\n\n  /**\n   * Merge user-supplied configuration from other plugin instances into this\n   * plugin's `userConfig`. Used by `PluginManager.attachAll()`'s alias-collapse\n   * pre-pass: when a consumer instantiates the same plugin more than once (or\n   * under an alias name), only one instance is attached, and the other\n   * instances' configs are folded in via this method.\n   *\n   * Merge rules (shallow):\n   *\n   * - Same key, **same value** → silent.\n   * - Same key, **different values** (incl. function vs function) → throws\n   *   a diagnostic naming the conflicting key. Conflicting callbacks\n   *   (`canDrag`, `canDrop`, etc.) cannot be reconciled automatically.\n   * - **Disjoint keys** → merged cleanly.\n   *\n   * Subclasses may override to implement custom deep-merge logic, but should\n   * call `super.mergeConfigsFrom(others)` to inherit the conflict-detection.\n   *\n   * @internal Plugin infrastructure (used by `PluginManager.attachAll`).\n   * @throws Error with diagnostic code `TBW025` when configs conflict.\n   */\n  mergeConfigsFrom(others: readonly BaseGridPlugin<TConfig>[]): void {\n    if (others.length === 0) return;\n    const merged = { ...this.userConfig } as Record<string, unknown>;\n    const sources: Record<string, BaseGridPlugin<TConfig>> = {};\n    for (const key of Object.keys(merged)) sources[key] = this;\n    for (const other of others) {\n      const otherConfig = other.userConfig as Record<string, unknown>;\n      for (const [key, value] of Object.entries(otherConfig)) {\n        if (value === undefined) continue;\n        if (!(key in merged)) {\n          merged[key] = value;\n          sources[key] = other;\n          continue;\n        }\n        if (merged[key] === value) continue;\n        // Conflict\n        const ownerA = sources[key]?.constructor.name ?? this.constructor.name;\n        const ownerB = other.constructor.name;\n        const code = formatDiagnostic(\n          PLUGIN_ALIAS_CONFIG_CONFLICT,\n          `Cannot merge plugin configs for \"${this.name}\": conflicting value for \"${key}\" supplied by both ${ownerA} and ${ownerB}. Pass the option on a single instance, or remove the duplicate.`,\n          undefined,\n          this.name,\n        );\n        throw new Error(code);\n      }\n    }\n    // Mutate userConfig in place so re-attach picks it up via attach().\n    // `userConfig` is declared `readonly` to prevent reassigning the binding,\n    // but the object's own properties are intentionally mutable for this\n    // alias-collapse pre-pass. A single cast to a record is enough — no\n    // `as unknown as` double-cast needed.\n    Object.assign(this.userConfig as Record<string, unknown>, merged);\n  }\n\n  /**\n   * Replace this plugin's `userConfig` with a freshly-resolved sibling\n   * instance's config. Used by the grid's per-grid feature-instance gate\n   * (`#initializePlugins`): when a feature is re-resolved across a config\n   * change, the **existing** instance is reused — so its accumulated state\n   * survives — but it must adopt the latest `gridConfig.features.<name>`\n   * value. Unlike {@link mergeConfigsFrom}, this is last-write-wins with no\n   * conflict detection: the re-resolved instance is authoritative.\n   *\n   * `attach()` recomputes {@link config} from `userConfig`, so updating\n   * `userConfig` here is enough for the reused instance to pick up the new\n   * config on its next attach during the same `#initializePlugins` pass.\n   *\n   * @internal Plugin infrastructure (used by the grid feature gate).\n   */\n  refreshUserConfigFrom(other: BaseGridPlugin<TConfig>): void {\n    const target = this.userConfig as Record<string, unknown>;\n    // Snapshot the source BEFORE clearing `target`. A feature factory may\n    // store the consumer's config object by reference (e.g. `new\n    // ContextMenuPlugin(config)`), and a consumer that passes the *same* config\n    // object across re-resolutions (common when `gridConfig` is a recomputed\n    // Angular `computed()`) makes `this.userConfig === other.userConfig`.\n    // Without this snapshot, the `delete` loop below would empty that shared\n    // object first, then `Object.assign` would copy back nothing — silently\n    // wiping the config and falling back to plugin defaults. (#contextMenu)\n    const source = { ...(other.userConfig as Record<string, unknown>) };\n    for (const key of Object.keys(target)) delete target[key];\n    Object.assign(target, source);\n  }\n\n  /**\n   * Called when the plugin is attached to a grid.\n   * Override to set up event listeners, initialize state, etc.\n   *\n   * @example\n   * ```ts\n   * attach(grid: GridElement): void {\n   *   super.attach(grid);\n   *   // Set up document-level listeners with auto-cleanup\n   *   document.addEventListener('keydown', this.handleEscape, {\n   *     signal: this.disconnectSignal\n   *   });\n   * }\n   * ```\n   */\n  attach(grid: GridElement): void {\n    // Abort any previous abort controller (in case of re-attach without detach)\n    this.#abortController?.abort();\n    // Create fresh abort controller for this attachment\n    this.#abortController = new AbortController();\n\n    this.grid = grid;\n    // Merge config here (after subclass construction is complete)\n    this.config = { ...this.defaultConfig, ...this.userConfig } as TConfig;\n  }\n\n  /**\n   * Called when the plugin is detached from a grid.\n   * Override to clean up event listeners, timers, etc.\n   *\n   * @example\n   * ```ts\n   * detach(): void {\n   *   // Clean up any state not handled by disconnectSignal\n   *   this.selectedRows.clear();\n   *   this.cache = null;\n   * }\n   * ```\n   */\n  detach(): void {\n    // Abort the plugin's abort controller to clean up all event listeners\n    // registered with { signal: this.disconnectSignal }\n    this.#abortController?.abort();\n    this.#abortController = undefined;\n    // Override in subclass for additional cleanup\n  }\n\n  /**\n   * Called when another plugin is attached to the same grid.\n   * Use for inter-plugin coordination, e.g., to integrate with new plugins.\n   *\n   * @param name - The name of the plugin that was attached\n   * @param plugin - The plugin instance (for direct access if needed)\n   *\n   * @example\n   * ```ts\n   * onPluginAttached(name: string, plugin: BaseGridPlugin): void {\n   *   if (name === 'selection') {\n   *     // Integrate with selection plugin\n   *     this.selectionPlugin = plugin as SelectionPlugin;\n   *   }\n   * }\n   * ```\n   */\n  onPluginAttached?(name: string, plugin: BaseGridPlugin): void;\n\n  /**\n   * Called when another plugin is detached from the same grid.\n   * Use to clean up inter-plugin references.\n   *\n   * @param name - The name of the plugin that was detached\n   *\n   * @example\n   * ```ts\n   * onPluginDetached(name: string): void {\n   *   if (name === 'selection') {\n   *     this.selectionPlugin = undefined;\n   *   }\n   * }\n   * ```\n   */\n  onPluginDetached?(name: string): void;\n\n  /**\n   * Get another plugin instance from the same grid.\n   * Use for inter-plugin communication.\n   *\n   * **Prefer {@link BaseGridPlugin.grid grid.getPluginByName()}** when you don't need the class import.\n   *\n   * @example\n   * ```ts\n   * // Preferred: by name\n   * const selection = this.grid?.getPluginByName('selection');\n   *\n   * // Alternative: by class\n   * const selection = this.getPlugin(SelectionPlugin);\n   * if (selection) {\n   *   const selectedRows = selection.getSelectedRows();\n   * }\n   * ```\n   */\n  protected getPlugin<T extends BaseGridPlugin>(PluginClass: new (...args: any[]) => T): T | undefined {\n    return this.grid?.getPlugin(PluginClass);\n  }\n\n  /**\n   * Emit a custom event from the grid.\n   */\n  protected emit<T>(eventName: string, detail: T): void {\n    this.grid?.dispatchEvent?.(new CustomEvent(eventName, { detail, bubbles: true }));\n  }\n\n  /**\n   * Emit a cancelable custom event from the grid.\n   * @returns `true` if the event was cancelled (preventDefault called), `false` otherwise\n   */\n  protected emitCancelable<T>(eventName: string, detail: T): boolean {\n    const event = new CustomEvent(eventName, { detail, bubbles: true, cancelable: true });\n    this.grid?.dispatchEvent?.(event);\n    return event.defaultPrevented;\n  }\n\n  // =========================================================================\n  // Event Bus - Plugin-to-Plugin Communication\n  // =========================================================================\n\n  /**\n   * Subscribe to an event from another plugin.\n   * The subscription is automatically cleaned up when this plugin is detached.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to listen for (e.g., 'filter-change')\n   * @param callback - The callback to invoke when the event is emitted\n   *\n   * @example\n   * ```typescript\n   * // In attach() or other initialization\n   * this.on('filter-change', (detail) => {\n   *   console.log('Filter changed:', detail);\n   * });\n   * ```\n   */\n  protected on<T = unknown>(eventType: string, callback: (detail: T) => void): void {\n    this.grid?._pluginManager?.subscribe(this, eventType, callback as (detail: unknown) => void);\n  }\n\n  /**\n   * Unsubscribe from a plugin event.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to stop listening for\n   *\n   * @example\n   * ```typescript\n   * this.off('filter-change');\n   * ```\n   */\n  protected off(eventType: string): void {\n    this.grid?._pluginManager?.unsubscribe(this, eventType);\n  }\n\n  /**\n   * Emit an event to other plugins via the Event Bus.\n   * This is for inter-plugin communication only; it does NOT dispatch DOM events.\n   * Use `emit()` to dispatch DOM events that external consumers can listen to.\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to emit (should be declared in manifest.events)\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Emit to other plugins (not DOM)\n   * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });\n   *\n   * // For DOM events that consumers can addEventListener to:\n   * this.emit('filter-change', { field: 'name', value: 'Alice' });\n   * ```\n   */\n  protected emitPluginEvent<T>(eventType: string, detail: T): void {\n    this.grid?._pluginManager?.emitPluginEvent(eventType, detail);\n  }\n\n  /**\n   * Emit an event to **both** the plugin Event Bus (for inter-plugin communication)\n   * **and** the DOM (for external consumers via `addEventListener`).\n   *\n   * Use this when a state change is relevant to both other plugins and external\n   * consumers. For example, `sort-change` needs to invalidate Selection (plugin bus)\n   * and notify the host application (DOM event).\n   *\n   * @category Plugin Development\n   * @param eventType - The event type to broadcast\n   * @param detail - The event payload\n   *\n   * @example\n   * ```typescript\n   * // Notify both plugins and consumers of a sort change\n   * this.broadcast('sort-change', { sortModel: [...this.sortModel] });\n   * ```\n   */\n  protected broadcast<T>(eventType: string, detail: T): void {\n    this.emitPluginEvent(eventType, detail);\n    this.emit(eventType, detail);\n  }\n\n  /**\n   * Run a yes/no plugin query and reduce the responses to a single boolean.\n   *\n   * `grid.query()` always returns an **array** of responses (empty when no\n   * plugin handles the query), and `[]` is truthy in JavaScript — so testing\n   * the raw result directly (`if (grid.query(...))`) is always `true` and\n   * silently takes the \"some plugin said yes\" branch even when nothing\n   * answered. Always route boolean queries through this helper.\n   *\n   * @category Plugin Development\n   * @param type - The query type to dispatch\n   * @param context - Optional query context passed to the handlers\n   * @returns `true` only when at least one plugin answered truthily\n   *\n   * @example\n   * ```typescript\n   * if (this.queryBoolean('datasource:is-active')) {\n   *   // A ServerSide data source really is installed\n   * }\n   * ```\n   * @since 3.4.0\n   */\n  protected queryBoolean(type: string, context: unknown = null): boolean {\n    const responses = this.grid?.query?.(type, context);\n    // Tolerate hosts/tests that hand back a bare value instead of the array.\n    return Array.isArray(responses) ? responses.some(Boolean) : !!responses;\n  }\n\n  /**\n   * Request a re-render of the grid.\n   * Uses ROWS phase - does NOT trigger processColumns hooks.\n   */\n  protected requestRender(): void {\n    this.grid?.requestRender?.();\n  }\n\n  /**\n   * Request a columns re-render of the grid.\n   * Uses COLUMNS phase - triggers processColumns hooks.\n   * Use this when your plugin needs to reprocess column configuration.\n   */\n  protected requestColumnsRender(): void {\n    (this.grid as { requestColumnsRender?: () => void })?.requestColumnsRender?.();\n  }\n\n  /**\n   * Request a re-render and restore focus styling afterward.\n   * Use this when a plugin action (like expand/collapse) triggers a render\n   * but needs to maintain keyboard navigation focus.\n   */\n  protected requestRenderWithFocus(): void {\n    this.grid?.requestRenderWithFocus?.();\n  }\n\n  /**\n   * Request a lightweight style update without rebuilding DOM.\n   * Use this instead of requestRender() when only CSS classes need updating.\n   */\n  protected requestAfterRender(): void {\n    this.grid?.requestAfterRender?.();\n  }\n\n  /**\n   * Re-render visible rows without rebuilding the row model or recalculating geometry.\n   * Use this when row data has been updated in-place (e.g., server-side block loads)\n   * and only the visible viewport needs to re-render.\n   */\n  protected requestVirtualRefresh(): void {\n    this.grid?.requestVirtualRefresh?.();\n  }\n\n  /**\n   * Get the current rows from the grid.\n   */\n  protected get rows(): any[] {\n    return this.grid?.rows ?? [];\n  }\n\n  /**\n   * Get the original unfiltered/unprocessed rows from the grid.\n   * Use this when you need all source data regardless of active filters.\n   */\n  protected get sourceRows(): any[] {\n    return this.grid?.sourceRows ?? [];\n  }\n\n  /**\n   * Get the current columns from the grid.\n   */\n  protected get columns(): ColumnConfig[] {\n    return this.grid?.columns ?? [];\n  }\n\n  /**\n   * Get only visible columns from the grid (excludes hidden).\n   * Use this for rendering that needs to match the grid template.\n   */\n  protected get visibleColumns(): ColumnConfig[] {\n    return this.grid?._visibleColumns ?? [];\n  }\n\n  /**\n   * Get the grid as an HTMLElement for direct DOM operations.\n   * Use sparingly - prefer the typed GridElementRef API when possible.\n   *\n   * @example\n   * ```ts\n   * const width = this.gridElement.clientWidth;\n   * this.gridElement.classList.add('my-plugin-active');\n   * ```\n   */\n  protected get gridElement(): HTMLElement {\n    return this.grid?._hostElement;\n  }\n\n  /**\n   * Get the disconnect signal for event listener cleanup.\n   * This signal is aborted when the grid disconnects from the DOM.\n   * Use this when adding event listeners that should be cleaned up automatically.\n   *\n   * Best for:\n   * - Document/window-level listeners added in attach()\n   * - Listeners on the grid element itself\n   * - Any listener that should persist across renders\n   *\n   * Not needed for:\n   * - Listeners on elements created in afterRender() (removed with element)\n   *\n   * @example\n   * element.addEventListener('click', handler, { signal: this.disconnectSignal });\n   * document.addEventListener('keydown', handler, { signal: this.disconnectSignal });\n   */\n  protected get disconnectSignal(): AbortSignal {\n    // Return the plugin's own abort signal for proper cleanup on detach/re-attach\n    // Falls back to grid's signal if plugin's controller not yet created\n    return this.#abortController?.signal ?? this.grid?.disconnectSignal;\n  }\n\n  /**\n   * Get the grid-level icons configuration.\n   * Returns merged icons (user config + defaults).\n   */\n  protected get gridIcons(): Required<GridIcons> {\n    const userIcons = this.grid?.gridConfig?.icons ?? {};\n    return { ...DEFAULT_GRID_ICONS, ...userIcons };\n  }\n\n  /**\n   * Resolve a user-visible string from {@link GridConfig.locale}, falling back to\n   * the English default supplied at the call site.\n   *\n   * The fallback is passed inline rather than read from a shipped default map so\n   * that a plugin's strings live in the plugin's own chunk.\n   *\n   * @param key - Namespaced message id, e.g. `'filter.apply'`.\n   * @param fallback - English text used when the key is not overridden.\n   * @since 3.5.0\n   *\n   * @example\n   * ```ts\n   * applyBtn.textContent = this.t('filter.apply', 'Apply');\n   * ```\n   */\n  protected t(key: string, fallback: string): string {\n    return this.grid?.effectiveConfig?.locale?.[key] ?? fallback;\n  }\n\n  /**\n   * A bound `t()` suitable for handing to standalone renderer\n   * helpers and public renderer callbacks.\n   * @since 3.5.0\n   */\n  protected get translate(): Translate {\n    return (key, fallback) => this.t(key, fallback);\n  }\n\n  // #region Animation Helpers\n\n  /**\n   * Check if animations are enabled at the grid level.\n   * Respects gridConfig.animation.mode and the CSS variable set by the grid.\n   *\n   * Plugins should use this to skip animations when:\n   * - Animation mode is 'off' or `false`\n   * - User prefers reduced motion and mode is 'reduced-motion' (default)\n   *\n   * @example\n   * ```ts\n   * private get animationStyle(): 'slide' | 'fade' | false {\n   *   if (!this.isAnimationEnabled) return false;\n   *   return this.config.animation ?? 'slide';\n   * }\n   * ```\n   */\n  protected get isAnimationEnabled(): boolean {\n    const mode = this.grid?.effectiveConfig?.animation?.mode ?? 'reduced-motion';\n\n    // Explicit off = disabled\n    if (mode === false || mode === 'off') return false;\n\n    // Explicit on = always enabled\n    if (mode === true || mode === 'on') return true;\n\n    // reduced-motion: check CSS variable (set by grid based on media query)\n    const host = this.gridElement;\n    if (host) {\n      const enabled = getComputedStyle(host).getPropertyValue('--tbw-animation-enabled').trim();\n      return enabled !== '0';\n    }\n\n    return true; // Default to enabled\n  }\n\n  /**\n   * Get the animation duration in milliseconds from CSS variable.\n   * Falls back to 200ms if not set.\n   *\n   * Plugins can use this for their animation timing to stay consistent\n   * with the grid-level animation.duration setting.\n   *\n   * @example\n   * ```ts\n   * element.animate(keyframes, { duration: this.animationDuration });\n   * ```\n   */\n  protected get animationDuration(): number {\n    const host = this.gridElement;\n    if (host) {\n      const durationStr = getComputedStyle(host).getPropertyValue('--tbw-animation-duration').trim();\n      const parsed = parseInt(durationStr, 10);\n      if (!isNaN(parsed)) return parsed;\n    }\n    return 200; // Default\n  }\n\n  // #endregion\n\n  /**\n   * Set an icon on an element using the CSS-first hybrid approach.\n   *\n   * Sets `data-icon` for CSS pseudo-element rendering and `data-expanded` for\n   * expand/collapse toggle elements. Only injects DOM content when a JS override\n   * is present (via `gridConfig.icons` or `pluginOverride`), which naturally\n   * suppresses the CSS `::before` via the `:empty` selector.\n   *\n   * @param element - The element to set the icon on\n   * @param iconKey - The icon key in GridIcons (e.g., 'expand', 'collapse')\n   * @param pluginOverride - Optional plugin-level override (string or HTMLElement)\n   */\n  protected setIcon(element: HTMLElement, iconKey: keyof GridIcons, pluginOverride?: IconValue): void {\n    // Set data-icon attribute for CSS targeting (always)\n    element.dataset.icon = toIconAttr(iconKey);\n\n    // Set data-expanded for toggle elements (tree, group, master-detail)\n    if (iconKey === 'collapse') {\n      element.dataset.expanded = '';\n    } else if (iconKey === 'expand') {\n      delete element.dataset.expanded;\n    }\n\n    // Resolve JS-only icon (returns undefined when CSS default should be used)\n    const jsIcon = this.#resolveJsIcon(iconKey, pluginOverride);\n\n    if (jsIcon !== undefined) {\n      // JS override: inject content (suppresses CSS ::before via :empty)\n      if (typeof jsIcon === 'string') {\n        setSanitizedHTML(element, jsIcon);\n      } else if (jsIcon instanceof HTMLElement) {\n        element.replaceChildren(jsIcon.cloneNode(true));\n      }\n    } else {\n      // CSS path: ensure element is empty so ::before renders\n      element.innerHTML = '';\n    }\n  }\n\n  /**\n   * Resolve JS-only icon override. Returns undefined if CSS default should render.\n   * Only returns a value when the user explicitly set gridConfig.icons[key] or\n   * the plugin passed an override.\n   */\n  #resolveJsIcon(iconKey: keyof GridIcons, pluginOverride?: IconValue): IconValue | undefined {\n    if (pluginOverride !== undefined) return pluginOverride;\n    return this.grid?.gridConfig?.icons?.[iconKey];\n  }\n\n  /**\n   * Create or replace a sort indicator on a header cell.\n   *\n   * Handles the full lifecycle: removes any existing indicator, creates a new\n   * `<span part=\"sort-indicator\" class=\"sort-indicator\">` with the appropriate\n   * icon, sets `aria-sort` / `data-sort` attributes, and inserts it before the\n   * filter button or resize handle.\n   *\n   * Plugins decide **which** cells and **when** — this method handles **how**.\n   *\n   * @param cell - The header cell element\n   * @param direction - `'asc'` | `'desc'` for sorted, `null` for unsorted idle state\n   * @returns The created indicator element (useful for appending badges, etc.)\n   */\n  protected updateSortIndicator(cell: Element, direction: 'asc' | 'desc' | null): HTMLElement {\n    // Remove any existing indicator (core uses part, plugins use class)\n    cell.querySelector('[part~=\"sort-indicator\"], .sort-indicator')?.remove();\n\n    const indicator = document.createElement('span');\n    indicator.setAttribute('part', 'sort-indicator');\n    indicator.className = 'sort-indicator';\n\n    if (direction) {\n      cell.setAttribute('aria-sort', direction === 'asc' ? 'ascending' : 'descending');\n      cell.setAttribute('data-sort', direction);\n      this.setIcon(indicator, direction === 'asc' ? 'sortAsc' : 'sortDesc');\n    } else {\n      cell.setAttribute('aria-sort', 'none');\n      cell.removeAttribute('data-sort');\n      this.setIcon(indicator, 'sortNone');\n    }\n\n    // Insert before filter button or resize handle to maintain DOM order\n    const insertBefore = cell.querySelector('.tbw-filter-btn') ?? cell.querySelector('.resize-handle');\n    if (insertBefore) {\n      cell.insertBefore(indicator, insertBefore);\n    } else {\n      cell.appendChild(indicator);\n    }\n\n    return indicator;\n  }\n\n  /**\n   * Log a warning with an optional diagnostic code.\n   *\n   * When a diagnostic code is provided, the message is formatted with the code\n   * and a link to the troubleshooting docs.\n   *\n   * @example\n   * ```ts\n   * this.warn('Something went wrong');                          // plain\n   * this.warn(MISSING_BREAKPOINT, 'Set a breakpoint'); // with code + docs link\n   * ```\n   */\n  protected warn(message: string): void;\n  protected warn(code: DiagnosticCode, message: string): void;\n  protected warn(codeOrMessage: DiagnosticCode | string, message?: string): void {\n    if (message !== undefined) {\n      // Called with (code, message)\n      console.warn(formatDiagnostic(codeOrMessage as DiagnosticCode, message, this.gridElement.id, this.name));\n    } else {\n      // Called with (message) — plain warning, no diagnostic code\n      console.warn(`${gridPrefix(this.gridElement.id, this.name)} ${codeOrMessage}`);\n    }\n  }\n\n  /**\n   * Throw an error with a diagnostic code and docs link.\n   * Use for configuration errors and API misuse that should halt execution.\n   */\n  protected throwDiagnostic(code: DiagnosticCode, message: string): never {\n    throw new Error(formatDiagnostic(code, message, this.gridElement.id, this.name));\n  }\n\n  // #region Lifecycle Hooks\n\n  /**\n   * Transform rows before rendering.\n   * Called during each render cycle before rows are rendered to the DOM.\n   * Use this to filter, sort, or add computed properties to rows.\n   *\n   * @param rows - The current rows array (readonly to encourage returning a new array)\n   * @returns The modified rows array to render\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Filter out hidden rows\n   *   return rows.filter(row => !row._hidden);\n   * }\n   * ```\n   *\n   * @example\n   * ```ts\n   * processRows(rows: readonly any[]): any[] {\n   *   // Add computed properties\n   *   return rows.map(row => ({\n   *     ...row,\n   *     _fullName: `${row.firstName} ${row.lastName}`\n   *   }));\n   * }\n   * ```\n   */\n  processRows?(rows: readonly any[]): any[];\n\n  /**\n   * Contribute to the grid's effective configuration during each config merge.\n   * Called by {@link ConfigManager.merge} after the base config is assembled,\n   * before it becomes `effectiveConfig`. Mutate `config` in place to inject\n   * plugin-derived settings (e.g. the shell plugin folds its light-DOM /\n   * API-registered state into `config.shell`).\n   *\n   * This is the config-pipeline counterpart to {@link processColumns} /\n   * {@link processRows}: it keeps the core config merge free of any plugin\n   * knowledge — each plugin owns the shape it contributes.\n   *\n   * @param config - The mutable base config being assembled into effectiveConfig.\n   *\n   * @example\n   * ```ts\n   * processConfig(config: GridConfig): void {\n   *   config.shell = { ...config.shell, header: { title: this.#title } };\n   * }\n   * ```\n   */\n  processConfig?(config: GridConfig): void;\n\n  /**\n   * Transform columns before rendering.\n   * Called during each render cycle before column headers and cells are rendered.\n   * Use this to add, remove, or modify column definitions.\n   *\n   * @param columns - The current columns array (readonly to encourage returning a new array)\n   * @returns The modified columns array to render\n   *\n   * @example\n   * ```ts\n   * processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n   *   // Add a selection checkbox column\n   *   return [\n   *     { field: '_select', header: '', width: 40 },\n   *     ...columns\n   *   ];\n   * }\n   * ```\n   */\n  processColumns?(columns: readonly ColumnConfig[]): ColumnConfig[];\n\n  /**\n   * Called before each render cycle begins.\n   * Use this to prepare state or cache values needed during rendering.\n   *\n   * **Note:** This hook is currently a placeholder for future implementation.\n   * It is defined in the interface but not yet invoked by the grid's render pipeline.\n   * If you need this functionality, please open an issue or contribute an implementation.\n   *\n   * @example\n   * ```ts\n   * beforeRender(): void {\n   *   this.visibleRowCount = this.calculateVisibleRows();\n   * }\n   * ```\n   */\n  beforeRender?(): void;\n\n  /**\n   * Called after each render cycle completes.\n   * Use this for DOM manipulation, adding event listeners to rendered elements,\n   * or applying visual effects like selection highlights.\n   *\n   * @example\n   * ```ts\n   * afterRender(): void {\n   *   // Apply selection styling to rendered rows\n   *   const rows = this.gridElement?.querySelectorAll('.data-grid-row');\n   *   rows?.forEach((row, i) => {\n   *     row.classList.toggle('selected', this.selectedRows.has(i));\n   *   });\n   * }\n   * ```\n   */\n  afterRender?(): void;\n\n  /**\n   * Called synchronously immediately after the grid (re)builds its root DOM\n   * structure, before the browser has a chance to paint.\n   *\n   * Unlike {@link afterRender} (which runs in the scheduler's STYLE phase and\n   * may be deferred), this hook fires inside the same task as the structural\n   * DOM build. It is the correct place for plugins that need to wrap, relocate,\n   * or augment the freshly built grid DOM without a flash of unstyled/unwrapped\n   * content — e.g. a shell that moves the grid content into a chrome wrapper.\n   *\n   * The grid emits this hook every time it performs a full structural rebuild\n   * (initial connect and structural changes), but NOT on the scroll/data hot\n   * path. Implementations MUST be idempotent: a full rebuild discards any DOM a\n   * previous invocation produced, so re-create it, and no-op when the desired\n   * structure is already present.\n   *\n   * @example\n   * ```ts\n   * afterStructuralRender(): void {\n   *   const root = this.grid?._renderRoot;\n   *   if (!root || root.querySelector('.my-wrapper > .tbw-grid-content')) return;\n   *   // build wrapper, move .tbw-grid-content inside it\n   * }\n   * ```\n   */\n  afterStructuralRender?(): void;\n\n  /**\n   * Called synchronously by the grid immediately before it tears down and\n   * rebuilds its root DOM structure (a structural re-render). Plugins that\n   * relocated existing light-DOM nodes into their own chrome (e.g. a shell that\n   * moves toolbar buttons into the header bar) use this to move those nodes back\n   * to their original container so they survive the rebuild. Generic\n   * counterpart to {@link afterStructuralRender}. MUST be idempotent.\n   */\n  beforeStructuralRender?(): void;\n\n  /**\n   * Called by the grid after a config merge to ask whether the change requires a\n   * full structural re-render (rather than a cheaper in-place update). A plugin\n   * returns `true` when its rendered DOM signature no longer matches the new\n   * effective config — e.g. a shell header appearing/disappearing or a tool\n   * panel's count/position/mode changing. The grid performs a structural\n   * re-render if ANY plugin returns `true`. MUST be side-effect free.\n   */\n  needsStructuralRerender?(): boolean;\n\n  /**\n   * Called by the grid to let a plugin (re-)parse its own light-DOM\n   * contributions into plugin state ahead of a config merge. Generic seam that\n   * keeps core free of plugin-specific light-DOM tag knowledge (the plugin reads\n   * `this.grid._hostElement`). MUST be idempotent.\n   */\n  parseLightDom?(): void;\n\n  /**\n   * Called by the grid (from `refreshColumns` and the light-DOM observer) to\n   * let a plugin re-parse its light-DOM contributions AND refresh any\n   * already-rendered chrome in place when something changed — e.g. a shell\n   * title or tool buttons that a framework projected asynchronously after the\n   * initial render. Distinct from {@link parseLightDom}, which only updates\n   * plugin state. Generic seam — core holds no plugin-specific knowledge. MUST\n   * be idempotent and a no-op when the plugin's chrome is not yet rendered.\n   */\n  syncLightDom?(): void;\n\n  /**\n   * Called after each cell is rendered.\n   * This hook is more efficient than `afterRender()` for cell-level modifications\n   * because you receive the cell context directly - no DOM queries needed.\n   *\n   * Use cases:\n   * - Adding selection/highlight classes to specific cells\n   * - Injecting badges or decorations\n   * - Applying conditional styling based on cell value\n   *\n   * Performance note: Called for every visible cell during render. Keep implementation fast.\n   * This hook is also called during scroll when cells are recycled.\n   *\n   * @param context - The cell render context with row, column, value, and elements\n   *\n   * @example\n   * ```ts\n   * afterCellRender(context: AfterCellRenderContext): void {\n   *   // Add selection class without DOM queries\n   *   if (this.isSelected(context.rowIndex, context.colIndex)) {\n   *     context.cellElement.classList.add('selected');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.hasError(context.row, context.column.field)) {\n   *     context.cellElement.classList.add('has-error');\n   *   }\n   * }\n   * ```\n   */\n  afterCellRender?(context: AfterCellRenderContext): void;\n\n  /**\n   * Called after a row is fully rendered (all cells complete).\n   * Use this for row-level decorations, styling, or ARIA attributes.\n   *\n   * Common use cases:\n   * - Adding selection classes to entire rows (row-focus, selected)\n   * - Setting row-level ARIA attributes\n   * - Applying row validation highlighting\n   * - Tree indentation styling\n   *\n   * Performance note: Called for every visible row during render. Keep implementation fast.\n   * This hook is also called during scroll when rows are recycled.\n   *\n   * @param context - The row render context with row data and element\n   *\n   * @example\n   * ```ts\n   * afterRowRender(context: AfterRowRenderContext): void {\n   *   // Add row selection class without DOM queries\n   *   if (this.isRowSelected(context.rowIndex)) {\n   *     context.rowElement.classList.add('selected', 'row-focus');\n   *   }\n   *\n   *   // Add validation error styling\n   *   if (this.rowHasErrors(context.row)) {\n   *     context.rowElement.classList.add('has-errors');\n   *   }\n   * }\n   * ```\n   */\n  afterRowRender?(context: AfterRowRenderContext): void;\n\n  /**\n   * Called after scroll-triggered row rendering completes.\n   * This is a lightweight hook for applying visual state to recycled DOM elements.\n   * Use this instead of afterRender when you need to reapply styling during scroll.\n   *\n   * Performance note: This is called frequently during scroll. Keep implementation fast.\n   *\n   * @example\n   * ```ts\n   * onScrollRender(): void {\n   *   // Reapply selection state to visible cells\n   *   this.applySelectionToVisibleCells();\n   * }\n   * ```\n   */\n  onScrollRender?(): void;\n\n  /**\n   * Get the height of a specific row.\n   * Used for synthetic rows (group headers, detail panels, etc.) that have fixed heights.\n   * Return undefined if this plugin does not manage the height for this row.\n   *\n   * This hook is called during position cache rebuilds for variable row height virtualization.\n   * Plugins that create synthetic rows should implement this to provide accurate heights.\n   *\n   * @param row - The row data\n   * @param index - The row index in the processed rows array\n   * @returns The row height in pixels, or undefined if not managed by this plugin\n   */\n  getRowHeight?(row: unknown, index: number): number | undefined;\n\n  /**\n   * Adjust the virtualization start index to render additional rows before the visible range.\n   * Use this when expanded content (like detail rows) needs its parent row to remain rendered\n   * even when the parent row itself has scrolled above the viewport.\n   *\n   * @param start - The calculated start row index\n   * @param scrollTop - The current scroll position\n   * @param rowHeight - The height of a single row\n   * @returns The adjusted start index (lower than or equal to original start)\n   *\n   * @example\n   * ```ts\n   * adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n   *   // If row 5 is expanded and scrolled partially, keep it rendered\n   *   for (const expandedRowIndex of this.expandedRowIndices) {\n   *     const expandedRowTop = expandedRowIndex * rowHeight;\n   *     const expandedRowBottom = expandedRowTop + rowHeight + this.detailHeight;\n   *     if (expandedRowBottom > scrollTop && expandedRowIndex < start) {\n   *       return expandedRowIndex;\n   *     }\n   *   }\n   *   return start;\n   * }\n   * ```\n   */\n  adjustVirtualStart?(start: number, scrollTop: number, rowHeight: number): number;\n\n  /**\n   * Render a custom row, bypassing the default row rendering.\n   * Use this for special row types like group headers, detail rows, or footers.\n   *\n   * @param row - The row data object\n   * @param rowEl - The row DOM element to render into\n   * @param rowIndex - The index of the row in the data array\n   * @returns `true` if the plugin handled rendering (prevents default), `false`/`void` for default rendering\n   *\n   * @example\n   * ```ts\n   * renderRow(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void {\n   *   if (row._isGroupHeader) {\n   *     rowEl.innerHTML = `<div class=\"group-header\">${row._groupLabel}</div>`;\n   *     return true; // Handled - skip default rendering\n   *   }\n   *   // Return void to let default rendering proceed\n   * }\n   * ```\n   */\n  renderRow?(row: any, rowEl: HTMLElement, rowIndex: number): boolean | void;\n\n  // #endregion\n\n  // #region Inter-Plugin Communication\n\n  /**\n   * Handle queries from other plugins or the grid.\n   *\n   * Queries are declared in `manifest.queries` and dispatched via `grid.query()`.\n   * This enables type-safe, discoverable inter-plugin communication.\n   *\n   * @category Plugin Development\n   * @param query - The query object with type and context\n   * @returns Query-specific response, or undefined if not handling this query\n   *\n   * @example\n   * ```ts\n   * // In manifest\n   * static override readonly manifest: PluginManifest = {\n   *   queries: [\n   *     { type: 'canMoveColumn', description: 'Check if a column can be moved' },\n   *   ],\n   * };\n   *\n   * // In plugin class\n   * handleQuery(query: PluginQuery): unknown {\n   *   if (query.type === 'canMoveColumn') {\n   *     const column = query.context as ColumnConfig;\n   *     return !column.sticky; // Can't move sticky columns\n   *   }\n   * }\n   * ```\n   */\n  handleQuery?(query: PluginQuery): unknown;\n\n  // #endregion\n\n  // #region Interaction Hooks\n\n  /**\n   * Handle keyboard events on the grid.\n   * Called when a key is pressed while the grid or a cell has focus.\n   *\n   * @param event - The native KeyboardEvent\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onKeyDown(event: KeyboardEvent): boolean | void {\n   *   // Handle Ctrl+A for select all\n   *   if (event.ctrlKey && event.key === 'a') {\n   *     this.selectAllRows();\n   *     return true; // Prevent default browser select-all\n   *   }\n   * }\n   * ```\n   */\n  onKeyDown?(event: KeyboardEvent): boolean | void;\n\n  /**\n   * Handle cell click events.\n   * Called when a data cell is clicked (not headers).\n   *\n   * @param event - Cell click event with row/column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onCellClick(event: CellClickEvent): boolean | void {\n   *   if (event.field === '_select') {\n   *     this.toggleRowSelection(event.rowIndex);\n   *     return true; // Handled\n   *   }\n   * }\n   * ```\n   */\n  onCellClick?(event: CellClickEvent): boolean | void;\n\n  /**\n   * Handle row click events.\n   * Called when any part of a data row is clicked.\n   * Note: This is called in addition to onCellClick, not instead of.\n   *\n   * @param event - Row click event with row context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onRowClick(event: RowClickEvent): boolean | void {\n   *   if (this.config.mode === 'row') {\n   *     this.selectRow(event.rowIndex, event.originalEvent);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onRowClick?(event: RowClickEvent): boolean | void;\n\n  /**\n   * Handle header click events.\n   * Called when a column header is clicked. Commonly used for sorting.\n   *\n   * @param event - Header click event with column context\n   * @returns `true` to prevent default behavior and stop propagation, `false`/`void` to allow default\n   *\n   * @example\n   * ```ts\n   * onHeaderClick(event: HeaderClickEvent): boolean | void {\n   *   if (event.column.sortable !== false) {\n   *     this.toggleSort(event.field);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onHeaderClick?(event: HeaderClickEvent): boolean | void;\n\n  /**\n   * Handle scroll events on the grid viewport.\n   * Called during scrolling. Note: This may be called frequently; debounce if needed.\n   *\n   * @param event - Scroll event with scroll position and viewport dimensions\n   *\n   * @example\n   * ```ts\n   * onScroll(event: ScrollEvent): void {\n   *   // Update sticky column positions\n   *   this.updateStickyPositions(event.scrollLeft);\n   * }\n   * ```\n   */\n  onScroll?(event: ScrollEvent): void;\n\n  /**\n   * Handle cell mousedown events.\n   * Used for initiating drag operations like range selection or column resize.\n   *\n   * @param event - Mouse event with cell context\n   * @returns `true` to indicate drag started (prevents text selection), `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseDown(event: CellMouseEvent): boolean | void {\n   *   if (event.rowIndex !== undefined && this.config.mode === 'range') {\n   *     this.startDragSelection(event.rowIndex, event.colIndex);\n   *     return true; // Prevent text selection\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseDown?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mousemove events during drag operations.\n   * Only called when a drag is in progress (after mousedown returned true).\n   *\n   * @param event - Mouse event with current cell context\n   * @returns `true` to continue handling the drag, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseMove(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging && event.rowIndex !== undefined) {\n   *     this.extendSelection(event.rowIndex, event.colIndex);\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseMove?(event: CellMouseEvent): boolean | void;\n\n  /**\n   * Handle cell mouseup events to end drag operations.\n   *\n   * @param event - Mouse event with final cell context\n   * @returns `true` if drag was finalized, `false`/`void` otherwise\n   *\n   * @example\n   * ```ts\n   * onCellMouseUp(event: CellMouseEvent): boolean | void {\n   *   if (this.isDragging) {\n   *     this.finalizeDragSelection();\n   *     this.isDragging = false;\n   *     return true;\n   *   }\n   * }\n   * ```\n   */\n  onCellMouseUp?(event: CellMouseEvent): boolean | void;\n\n  // Note: Context menu items are provided via handleQuery('getContextMenuItems').\n  // This keeps the core decoupled from the context-menu plugin specifics.\n\n  // #endregion\n\n  // #region Column State Hooks\n\n  /**\n   * Contribute plugin-specific state for a column.\n   * Called by the grid when collecting column state for serialization.\n   * Plugins can add their own properties to the column state.\n   *\n   * @param field - The field name of the column\n   * @returns Partial column state with plugin-specific properties, or undefined if no state to contribute\n   *\n   * @example\n   * ```ts\n   * getColumnState(field: string): Partial<ColumnState> | undefined {\n   *   const filterModel = this.filterModels.get(field);\n   *   if (filterModel) {\n   *     // Uses module augmentation to add filter property to ColumnState\n   *     return { filter: filterModel } as Partial<ColumnState>;\n   *   }\n   *   return undefined;\n   * }\n   * ```\n   */\n  getColumnState?(field: string): Partial<ColumnState> | undefined;\n\n  /**\n   * Apply plugin-specific state to a column.\n   * Called by the grid when restoring column state from serialized data.\n   * Plugins should restore their internal state based on the provided state.\n   *\n   * @param field - The field name of the column\n   * @param state - The column state to apply (may contain plugin-specific properties)\n   *\n   * @example\n   * ```ts\n   * applyColumnState(field: string, state: ColumnState): void {\n   *   // Check for filter property added via module augmentation\n   *   const filter = (state as any).filter;\n   *   if (filter) {\n   *     this.filterModels.set(field, filter);\n   *     this.applyFilter();\n   *   }\n   * }\n   * ```\n   */\n  applyColumnState?(field: string, state: ColumnState): void;\n\n  // #endregion\n\n  // #region Scroll Boundary Hooks\n\n  /**\n   * Report horizontal scroll boundary offsets for this plugin.\n   * Plugins that obscure part of the scroll area (e.g., pinned/sticky columns)\n   * should return how much space they occupy on each side.\n   * The keyboard navigation uses this to ensure focused cells are fully visible.\n   *\n   * @param rowEl - The row element (optional, for calculating widths from rendered cells)\n   * @param focusedCell - The currently focused cell element (optional, to determine if scrolling should be skipped)\n   * @returns Object with left/right pixel offsets and optional skipScroll flag, or undefined if plugin has no offsets\n   *\n   * @example\n   * ```ts\n   * getHorizontalScrollOffsets(rowEl?: HTMLElement, focusedCell?: HTMLElement): { left: number; right: number; skipScroll?: boolean } | undefined {\n   *   // Calculate total width of left-pinned columns\n   *   const leftCells = rowEl?.querySelectorAll('.sticky-left') ?? [];\n   *   let left = 0;\n   *   leftCells.forEach(el => { left += (el as HTMLElement).offsetWidth; });\n   *   // Skip scroll if focused cell is pinned (always visible)\n   *   const skipScroll = focusedCell?.classList.contains('sticky-left');\n   *   return { left, right: 0, skipScroll };\n   * }\n   * ```\n   */\n  getHorizontalScrollOffsets?(\n    rowEl?: HTMLElement,\n    focusedCell?: HTMLElement,\n  ): { left: number; right: number; skipScroll?: boolean } | undefined;\n\n  /**\n   * Report vertical scroll boundary offsets for this plugin.\n   * Plugins that overlay the top or bottom of the rows viewport (e.g. sticky\n   * row clones) should return how much space they obscure on each edge, so\n   * keyboard navigation can scroll a focused row clear of the overlay rather\n   * than leaving it hidden underneath — WCAG 2.2 SC 2.4.11 Focus Not Obscured.\n   *\n   * Only report space that is painted *over* the scrollable rows. Content that\n   * takes part in normal flow (pinned-row bars, the column header) already\n   * shrinks the viewport and must NOT be reported here, or rows would scroll\n   * twice as far as needed.\n   *\n   * @param focusedRowIndex - Index of the row being scrolled into view, so a plugin can report `skipScroll` when it already renders that row in a permanently visible overlay\n   * @returns Object with top/bottom pixel offsets and optional skipScroll flag, or undefined if plugin obscures nothing\n   *\n   * @example\n   * ```ts\n   * getVerticalScrollOffsets(focusedRowIndex?: number): { top: number; bottom: number; skipScroll?: boolean } | undefined {\n   *   if (!this.overlayEl) return undefined;\n   *   // The row is already pinned in the overlay — it is visible where it is.\n   *   if (focusedRowIndex != null && this.stuckIndices.includes(focusedRowIndex)) {\n   *     return { top: 0, bottom: 0, skipScroll: true };\n   *   }\n   *   return { top: this.overlayEl.offsetHeight, bottom: 0 };\n   * }\n   * ```\n   *\n   * @since 3.6.0\n   */\n  getVerticalScrollOffsets?(\n    focusedRowIndex?: number,\n  ): { top: number; bottom: number; skipScroll?: boolean } | undefined;\n\n  // #endregion\n\n  // #region Shell Integration Hooks\n\n  /**\n   * Register a tool panel for this plugin.\n   * Return undefined if plugin has no tool panel.\n   * The shell will create a toolbar toggle button and render the panel content\n   * when the user opens the panel.\n   *\n   * @returns Tool panel definition, or undefined if plugin has no panel\n   *\n   * @example\n   * ```ts\n   * getToolPanel(): ToolPanelDefinition | undefined {\n   *   return {\n   *     id: 'columns',\n   *     title: 'Columns',\n   *     icon: '☰',\n   *     tooltip: 'Show/hide columns',\n   *     order: 10,\n   *     render: (container) => {\n   *       this.renderColumnList(container);\n   *       return () => this.cleanup();\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getToolPanel?(): ToolPanelDefinition | undefined;\n\n  /**\n   * Register content for the shell header center section.\n   * Return undefined if plugin has no header content.\n   * Examples: search input, selection summary, status indicators.\n   *\n   * @returns Header content definition, or undefined if plugin has no header content\n   *\n   * @example\n   * ```ts\n   * getHeaderContent(): HeaderContentDefinition | undefined {\n   *   return {\n   *     id: 'quick-filter',\n   *     order: 10,\n   *     render: (container) => {\n   *       const input = document.createElement('input');\n   *       input.type = 'text';\n   *       input.placeholder = 'Search...';\n   *       input.addEventListener('input', this.handleInput);\n   *       container.appendChild(input);\n   *       return () => input.removeEventListener('input', this.handleInput);\n   *     },\n   *   };\n   * }\n   * ```\n   */\n  getHeaderContent?(): HeaderContentDefinition | undefined;\n\n  // #endregion\n}\n","/**\n * Generic pointer-drag helper — converts a `pointerdown` event into a\n * deterministic drag lifecycle with pointer capture, threshold / long-press\n * promotion, and clean teardown.\n *\n * ## Usage\n * ```ts\n * element.addEventListener('pointerdown', (e) => {\n *   startPointerDrag(e, element, {\n *     onMove: (pe) => resize(pe.clientX),\n *     onEnd:  (pe) => commit(),\n *   });\n * });\n * ```\n *\n * ## Fine vs coarse pointer promotion\n * For **fine** pointers (mouse / precision trackpad): set `longPressDuration`\n * to `0` (or omit it) so the drag is promoted immediately on first move.\n *\n * For **coarse** pointers (touch / stylus): set `longPressDuration` to e.g.\n * `400` ms so the drag is only promoted after the user holds still long\n * enough. Movement exceeding `longPressSlop` px before the timer fires\n * **cancels** the drag — this lets native scroll proceed uninterrupted.\n *\n * Branch example at call site:\n * ```ts\n * const isCoarse = e.pointerType === 'touch' || e.pointerType === 'pen';\n * startPointerDrag(e, el, handlers, { longPressDuration: isCoarse ? 400 : 0 });\n * ```\n *\n * ## Pointer capture\n * `setPointerCapture` / `releasePointerCapture` are called on `captureTarget`\n * only — **never** `document` / `window` listeners. Capture is claimed at\n * **promotion**, not on `pointerdown`: a captured pointer makes the browser\n * retarget the compatibility mouse events (`mouseup`, `click`, `dblclick`) to\n * the capture element, which would break click-driven grid features.\n *\n * ## Re-entrancy\n * Simultaneous drags on the same element with the same `pointerId` are\n * silently ignored (returns a no-op cancel function).\n *\n * ## DnD plugins\n * HTML5 drag-and-drop plugins (`RowDragDropPlugin`, `ReorderPlugin`, etc.)\n * are expected to consume this module in the future (#228). The API is\n * intentionally general.\n *\n * This module is **internal only** — NOT exported from `src/public.ts`.\n *\n * @since 3.5.0\n * @internal\n */\n\n// #region Types\n\n/**\n * Callbacks supplied to {@link startPointerDrag}.\n *\n * @since 3.5.0\n */\nexport interface PointerDragHandlers {\n  /**\n   * Called on each `pointermove` after the drag has been promoted.\n   * For immediate drags (no threshold / long-press) this fires on the very\n   * first move. For long-press promotion it fires only after the delay.\n   */\n  onMove(e: PointerEvent): void;\n\n  /**\n   * Called when the pointer is released after promotion (`pointerup`).\n   * Not called if the drag was cancelled before promotion.\n   */\n  onEnd(e: PointerEvent): void;\n\n  /**\n   * Called once when the drag is promoted — when the movement threshold is\n   * crossed or the long-press timer elapses. Fires before the first `onMove`.\n   *\n   * Long-press call sites use this to enter a mode (e.g. cell range-paint) and\n   * give feedback at the moment the press is recognised, even if the pointer\n   * never subsequently moves.\n   */\n  onPromote?(): void;\n\n  /**\n   * Called when the drag is cancelled — by `pointercancel`, `lostpointercapture`,\n   * an `Escape` keydown, or the returned `cancel()` function.\n   * Also called when the pointer is released *before* promotion (tap / short press).\n   */\n  onCancel?(): void;\n}\n\n/**\n * Options for {@link startPointerDrag}.\n *\n * @since 3.5.0\n */\nexport interface PointerDragOptions {\n  /**\n   * Minimum movement in px before the drag is promoted.\n   * `0` (default) promotes immediately on the first `pointermove`.\n   */\n  threshold?: number;\n\n  /**\n   * Long-press duration in milliseconds.\n   *\n   * `0` (default) = no long-press requirement; the drag is promoted as soon\n   * as the pointer moves (subject to `threshold`).\n   *\n   * When `> 0` the drag is promoted only after this many ms have elapsed\n   * without the pointer exceeding `longPressSlop`. If the slop is exceeded\n   * before the timer fires the entire drag is cancelled so native scroll can\n   * proceed.\n   *\n   * Use this for **coarse** (touch/stylus) pointers to disambiguate a tap\n   * or a scroll gesture from an intentional drag-to-paint interaction.\n   */\n  longPressDuration?: number;\n\n  /**\n   * Maximum pointer movement (px) permitted during the long-press wait.\n   * If this distance is exceeded the drag is cancelled.\n   * Default: `8`.\n   */\n  longPressSlop?: number;\n}\n\n// #endregion\n\n// #region Re-entrancy guard\n\n/**\n * Tracks active pointer IDs per capture target.\n * Prevents two simultaneous drags on the same element with the same pointer.\n */\nconst _activePointers = new WeakMap<Element, Set<number>>();\n\nfunction _claimPointer(el: Element, id: number): boolean {\n  let set = _activePointers.get(el);\n  if (!set) {\n    set = new Set();\n    _activePointers.set(el, set);\n  }\n  if (set.has(id)) return false;\n  set.add(id);\n  return true;\n}\n\nfunction _releasePointer(el: Element, id: number): void {\n  _activePointers.get(el)?.delete(id);\n}\n\n// #endregion\n\n// #region startPointerDrag\n\n/**\n * Begin a pointer drag on `captureTarget`.\n *\n * Attaches `pointermove`, `pointerup`, `pointercancel`, and\n * `lostpointercapture` listeners directly to `captureTarget` (never to\n * `document` / `window`). `setPointerCapture` is called when the drag is\n * promoted so events continue to route here regardless of DOM changes; an\n * unpromoted press never captures and therefore leaves `click` / `dblclick`\n * targeting the element actually under the pointer.\n *\n * Returns a `cancel()` dispose function. Calling it is idempotent.\n *\n * @param startEvent  - The originating `pointerdown` event.\n * @param captureTarget - Element on which to set pointer capture and attach\n *   pointer listeners. Must be in a connected document.\n * @param handlers - `onMove`, `onEnd`, and optional `onCancel` callbacks.\n * @param options - Threshold, long-press, and slop configuration.\n *\n * @since 3.5.0\n */\nexport function startPointerDrag(\n  startEvent: PointerEvent,\n  captureTarget: Element,\n  handlers: PointerDragHandlers,\n  options?: PointerDragOptions,\n): () => void {\n  const { onMove, onEnd, onCancel, onPromote } = handlers;\n  const threshold = options?.threshold ?? 0;\n  const longPressDuration = options?.longPressDuration ?? 0;\n  const longPressSlop = options?.longPressSlop ?? 8;\n  const pointerId = startEvent.pointerId;\n\n  // Re-entrancy guard — silently ignore duplicate drags on same element/pointer\n  if (!_claimPointer(captureTarget, pointerId)) {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const startX = startEvent.clientX;\n  const startY = startEvent.clientY;\n\n  // Promotion: true when the drag has passed threshold/long-press requirements\n  let promoted = threshold === 0 && longPressDuration === 0;\n  let done = false;\n  let longPressTimer: ReturnType<typeof setTimeout> | null = null;\n  let captureFailed = false;\n\n  // #region Internal helpers\n\n  /**\n   * Claim pointer capture — called at promotion, never at `pointerdown`.\n   *\n   * While an element holds pointer capture the browser retargets the\n   * compatibility mouse events (`mouseup`, `click`, `dblclick`) to that element\n   * instead of the element actually under the pointer. Capturing on press would\n   * therefore break every click-driven feature in the grid (cell editing,\n   * header sort, row click) because those handlers resolve their target with\n   * `event.target.closest(...)`. Promotion is the point where the gesture is\n   * known to be a drag, so capturing there keeps plain clicks intact.\n   */\n  function acquireCapture(): boolean {\n    try {\n      captureTarget.setPointerCapture(pointerId);\n      return true;\n    } catch {\n      // setPointerCapture can fail in unit-test environments without full\n      // browser APIs, or if the element was detached mid-gesture. Callers\n      // typically flip UI state (cursor, user-select, `isResizing`) *before*\n      // calling us, so report the failure as a cancellation — otherwise that\n      // state is never rolled back and the UI sticks mid-drag.\n      captureFailed = true;\n      return false;\n    }\n  }\n\n  /** Promote the gesture to a drag: take capture, then notify the caller. */\n  function promote(): boolean {\n    promoted = true;\n    if (!acquireCapture()) {\n      cancel();\n      return false;\n    }\n    onPromote?.();\n    return true;\n  }\n\n  function teardown(): void {\n    if (done) return;\n    done = true;\n    if (longPressTimer !== null) {\n      clearTimeout(longPressTimer);\n      longPressTimer = null;\n    }\n    captureTarget.removeEventListener('pointermove', onPointerMove);\n    captureTarget.removeEventListener('pointerup', onPointerUp);\n    captureTarget.removeEventListener('pointercancel', onPointerCancel);\n    captureTarget.removeEventListener('lostpointercapture', onLostCapture);\n    document.removeEventListener('keydown', onEscapeKey, true);\n    _releasePointer(captureTarget, pointerId);\n    try {\n      if (captureTarget.hasPointerCapture(pointerId)) {\n        captureTarget.releasePointerCapture(pointerId);\n      }\n    } catch {\n      // Ignore — element may have been removed from DOM\n    }\n  }\n\n  function cancel(): void {\n    if (done) return;\n    teardown();\n    onCancel?.();\n  }\n\n  // #endregion\n\n  // #region Event handlers\n\n  function onPointerMove(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n\n    const dx = e.clientX - startX;\n    const dy = e.clientY - startY;\n    const dist = Math.sqrt(dx * dx + dy * dy);\n\n    if (!promoted) {\n      if (longPressDuration > 0) {\n        // Cancel entire drag if movement exceeds slop while waiting for long-press\n        if (dist > longPressSlop) {\n          cancel();\n          return;\n        }\n        // Long-press not yet elapsed — swallow event, no onMove\n        return;\n      }\n      // Threshold promotion only (no long-press)\n      if (threshold > 0 && dist < threshold) return;\n      if (!promote()) return;\n    }\n\n    onMove(e);\n  }\n\n  function onPointerUp(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n    const wasPromoted = promoted;\n    teardown();\n    if (wasPromoted) {\n      onEnd(e);\n    } else {\n      onCancel?.();\n    }\n  }\n\n  function onPointerCancel(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n    cancel();\n  }\n\n  function onLostCapture(event: Event): void {\n    const e = event as PointerEvent;\n    if (e.pointerId !== pointerId || done) return;\n    cancel();\n  }\n\n  function onEscapeKey(event: Event): void {\n    const e = event as KeyboardEvent;\n    if (e.key === 'Escape' && !done) cancel();\n  }\n\n  // #endregion\n\n  // Attach listeners before starting the long-press timer\n  captureTarget.addEventListener('pointermove', onPointerMove);\n  captureTarget.addEventListener('pointerup', onPointerUp);\n  captureTarget.addEventListener('pointercancel', onPointerCancel);\n  captureTarget.addEventListener('lostpointercapture', onLostCapture);\n  document.addEventListener('keydown', onEscapeKey, true);\n\n  // Drags with neither a threshold nor a long-press are promoted up front.\n  if (promoted) {\n    promote();\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    if (captureFailed) return () => {};\n  }\n\n  // Start long-press timer after capture so the countdown is accurate\n  if (longPressDuration > 0) {\n    longPressTimer = setTimeout(() => {\n      longPressTimer = null;\n      if (done) return;\n      promote();\n    }, longPressDuration);\n  }\n\n  return cancel;\n}\n\n// #endregion\n","/**\n * Non-drag alternative for resizing — WCAG 2.2 SC 2.5.7 \"Dragging Movements\".\n *\n * Dragging a splitter is the primary gesture, but a single-pointer user\n * (trackball, head pointer, eye-gaze, speech mouse emulator) cannot reliably\n * press-hold-move-release. Tapping the splitter instead opens this popover,\n * which offers the same functionality through plain clicks: step buttons, a\n * numeric input, and a reset. A keyboard alternative alone would **not**\n * satisfy the criterion — it is specifically about pointer input.\n *\n * Target-agnostic on purpose: core column resizing and the shell's tool-panel\n * splitter share it, so every resizable thing in the grid presents the same\n * control instead of one-off menus.\n *\n * This module is **internal only** — NOT exported from `src/public.ts`.\n *\n * @since 3.6.0\n * @internal\n */\n\n/** Default size change per click of the − / + buttons, in px. */\nconst DEFAULT_STEP_PX = 16;\n\n/** Gap between the anchor handle and the popover, in px. */\nconst ANCHOR_GAP_PX = 6;\n\n/** Runtime check — happy-dom and older browsers may lack the Popover API. */\nfunction supportsPopover(): boolean {\n  return typeof HTMLElement.prototype?.showPopover === 'function';\n}\n\n/**\n * How the popover reads and writes whatever it is sizing. `T` identifies the\n * target — a column index for the header, the panel element for the shell.\n *\n * Supplied by the owning controller so the drag and the click path share one\n * clamping/commit implementation.\n */\nexport interface SizePopoverOptions<T> {\n  /** DOM id for the popover element, unique per owning controller. */\n  id: string;\n  /** Size change per click of the − / + buttons. Defaults to 16px. */\n  step?: number;\n  /** Current rendered size of the target, in px. */\n  getSize(target: T): number;\n  /** Commit an explicit size (implementation clamps to its own limits). */\n  setSize(target: T, size: number): void;\n  /** Restore the target's configured size. */\n  reset(target: T): void;\n  /** Accessible name for the popover, e.g. `\"Width of column Name\"`. */\n  getLabel(target: T): string;\n  /**\n   * The grid host. The popover is mounted INSIDE it (the grid renders in light\n   * DOM) so it inherits the theme's custom properties and `color-scheme`; the\n   * top layer keeps it clear of ancestor overflow. `buildBareGridDOMIntoElement`\n   * preserves foreign direct children, so it survives re-renders.\n   */\n  getHost(target: T): HTMLElement | null;\n}\n\nexport interface SizePopover<T> {\n  /** Show the popover for `target`, positioned against `anchor`. */\n  open(target: T, anchor: HTMLElement): void;\n  /** Hide the popover. Safe to call when already closed. */\n  close(): void;\n  /** Remove the popover element and every document-level listener. */\n  dispose(): void;\n  /** The popover element, or `null` before the first {@link SizePopover.open}. */\n  readonly element: HTMLElement | null;\n}\n\nfunction button(label: string, text: string): HTMLButtonElement {\n  const el = document.createElement('button');\n  el.type = 'button';\n  el.className = 'tbw-size-popover-btn';\n  el.setAttribute('aria-label', label);\n  el.textContent = text;\n  return el;\n}\n\nexport function createSizePopover<T>(options: SizePopoverOptions<T>): SizePopover<T> {\n  const step = options.step ?? DEFAULT_STEP_PX;\n  let root: HTMLDivElement | null = null;\n  let input: HTMLInputElement | null = null;\n  let anchorEl: HTMLElement | null = null;\n  let target: T;\n  let opened = false;\n  let disposed = false;\n  const abort = new AbortController();\n\n  function close(): void {\n    if (!opened || !root) return;\n    opened = false;\n    if (supportsPopover()) root.hidePopover();\n    root.hidden = true;\n    anchorEl?.removeAttribute('data-tbw-size-open');\n    anchorEl = null;\n  }\n\n  function sync(): void {\n    if (input) input.value = String(Math.round(options.getSize(target)));\n  }\n\n  function apply(size: number): void {\n    if (!Number.isFinite(size)) return;\n    options.setSize(target, size);\n    sync();\n  }\n\n  function build(): HTMLDivElement {\n    const el = document.createElement('div');\n    el.id = options.id;\n    el.className = 'tbw-size-popover';\n    el.setAttribute('popover', 'manual');\n    el.setAttribute('role', 'group');\n    // Without the Popover API there is no UA `display: none`, so hide it here.\n    el.hidden = true;\n\n    const minus = button('Narrower', '\\u2212');\n    const plus = button('Wider', '+');\n    const reset = button('Reset size', 'Reset');\n\n    const field = document.createElement('input');\n    field.type = 'number';\n    field.className = 'tbw-size-popover-input';\n    field.min = '0';\n    // `step` belongs to the − / + buttons, not the field: a measured size is\n    // rarely a multiple of it, and a step mismatch would mark the field\n    // `:invalid` and expose `aria-invalid=\"true\"` for a perfectly valid width.\n    field.step = 'any';\n    field.setAttribute('aria-label', 'Size in pixels');\n\n    minus.addEventListener('click', () => apply(options.getSize(target) - step), { signal: abort.signal });\n    plus.addEventListener('click', () => apply(options.getSize(target) + step), { signal: abort.signal });\n    reset.addEventListener(\n      'click',\n      () => {\n        options.reset(target);\n        sync();\n      },\n      { signal: abort.signal },\n    );\n    field.addEventListener('change', () => apply(field.valueAsNumber), { signal: abort.signal });\n\n    // Tabbing past either end dismisses instead of stranding the user — the\n    // popover has no visible trigger to tab back to. A null `relatedTarget`\n    // (click focus in Firefox/Safari, focus leaving the document) is ignored.\n    el.addEventListener(\n      'focusout',\n      (e) => {\n        const next = (e as FocusEvent).relatedTarget;\n        if (next instanceof Node && !el.contains(next)) close();\n      },\n      { signal: abort.signal },\n    );\n\n    el.append(minus, field, plus, reset);\n    input = field;\n    return el;\n  }\n\n  /**\n   * Position against the anchor in viewport coordinates. The popover lives in\n   * the top layer, so its containing block is the viewport regardless of where\n   * the anchor sits in the DOM.\n   *\n   * Called once per open and never again: repeatedly clicking − / + moves the\n   * anchor, and following it would slide the button out from under the pointer\n   * of the very users this control exists for. The anchor keeps its indicator\n   * lit instead (`data-tbw-size-open`) to show which edge is being sized.\n   */\n  function place(anchor: HTMLElement): void {\n    if (!root) return;\n    const a = anchor.getBoundingClientRect();\n    const box = root.getBoundingClientRect();\n    const clamp = (v: number, max: number) => Math.max(4, Math.min(v, max - 4));\n    const left = clamp(a.left + a.width / 2 - box.width / 2, window.innerWidth - box.width);\n\n    // A full-height anchor (the tool-panel splitter) has no meaningful \"below\":\n    // it would land past the bottom of the grid. Sit against its middle instead.\n    const below = a.bottom + ANCHOR_GAP_PX;\n    const above = a.top - ANCHOR_GAP_PX - box.height;\n    const tall = a.height > box.height * 3;\n    let top: number;\n    if (!tall && below + box.height <= window.innerHeight) top = below;\n    else if (!tall && above >= 4) top = above;\n    else top = clamp(a.top + a.height / 2 - box.height / 2, window.innerHeight - box.height);\n\n    root.style.left = `${Math.round(left)}px`;\n    root.style.top = `${Math.round(top)}px`;\n  }\n\n  // Any pointer press outside the popover dismisses it. Capture phase so the\n  // press that lands on a grid cell still reaches its own handler afterwards.\n  document.addEventListener(\n    'pointerdown',\n    (e) => {\n      if (opened && root && !e.composedPath().includes(root)) close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n  document.addEventListener(\n    'keydown',\n    (e) => {\n      if ((e as KeyboardEvent).key === 'Escape') close();\n    },\n    { capture: true, signal: abort.signal },\n  );\n\n  return {\n    get element() {\n      return root;\n    },\n    open(next, anchor) {\n      if (disposed) return;\n      target = next;\n      anchorEl?.removeAttribute('data-tbw-size-open');\n      anchorEl = anchor;\n      anchor.setAttribute('data-tbw-size-open', '');\n      if (!root) root = build();\n      const host = options.getHost(next) ?? document.body;\n      if (root.parentNode !== host) host.appendChild(root);\n      root.setAttribute('aria-label', options.getLabel(next));\n      sync();\n      root.hidden = false;\n      if (!opened && supportsPopover()) root.showPopover();\n      opened = true;\n      place(anchor);\n      input?.focus();\n    },\n    close,\n    dispose() {\n      disposed = true;\n      close();\n      abort.abort();\n      root?.remove();\n      root = null;\n      input = null;\n    },\n  };\n}\n","/**\n * Grid DOM Constants\n *\n * Centralized constants for CSS classes, data attributes, and selectors\n * used throughout the grid. Use these instead of magic strings.\n *\n * Note: Some constants here are used by plugins but defined in core because:\n * 1. The core CSS needs to style these elements (e.g., sticky positioning)\n * 2. Multiple plugins may share the same class names\n *\n * Plugins can define their own additional constants and export them.\n * See each plugin's index.ts for plugin-specific exports.\n */\n\n/**\n * CSS selector for focusable editor elements within a cell.\n * Used by EditingPlugin, UndoRedoPlugin, and keyboard navigation. Defined here\n * (a leaf module) rather than in `rows.ts` so `keyboard.ts` can consume it\n * without creating a rows ↔ keyboard import cycle.\n */\nexport const FOCUSABLE_EDITOR_SELECTOR =\n  'input,select,textarea,[contenteditable=\"true\"],[contenteditable=\"\"],[tabindex]:not([tabindex=\"-1\"])';\n\n// #region CSS Classes\n\n/**\n * CSS class names used in the grid's DOM.\n * Use these when adding/removing classes or querying elements.\n *\n * Classes are organized by:\n * - Core: Used by the grid core for structure and basic functionality\n * - Shared: Used by multiple features/plugins, styled by core CSS\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridClasses = {\n  // ─── Core Structure ───────────────────────────────────────────────\n  ROOT: 'tbw-grid-root',\n  HEADER: 'header',\n  HEADER_ROW: 'header-row',\n  HEADER_CELL: 'header-cell',\n\n  // Body structure\n  ROWS_VIEWPORT: 'rows-viewport',\n  ROWS_SPACER: 'rows-spacer',\n  ROWS_CONTAINER: 'rows',\n\n  // Row elements\n  DATA_ROW: 'data-grid-row',\n  GROUP_ROW: 'group-row',\n\n  // Cell elements\n  DATA_CELL: 'cell',\n\n  // ─── Core States ──────────────────────────────────────────────────\n  SELECTED: 'selected',\n  FOCUSED: 'focused',\n  EDITING: 'editing',\n  EXPANDED: 'expanded',\n  COLLAPSED: 'collapsed',\n  DRAGGING: 'dragging',\n  RESIZING: 'resizing',\n\n  // Sorting (core feature)\n  SORTABLE: 'sortable',\n  SORTED_ASC: 'sorted-asc',\n  SORTED_DESC: 'sorted-desc',\n\n  // Visibility\n  HIDDEN: 'hidden',\n\n  // ─── Shared Classes (used by plugins, styled by core CSS) ────────\n  // These are defined here because core CSS provides the base styling.\n  // Plugins apply these classes; core CSS defines how they look.\n\n  // Sticky positioning (PinnedColumnsPlugin applies, core CSS styles)\n  STICKY_LEFT: 'sticky-left',\n  STICKY_RIGHT: 'sticky-right',\n\n  // Pinned rows (PinnedRowsPlugin applies, core CSS styles)\n  PINNED_TOP: 'pinned-top',\n  PINNED_BOTTOM: 'pinned-bottom',\n\n  // Tree structure (TreePlugin applies, core CSS styles)\n  TREE_TOGGLE: 'tree-toggle',\n  TREE_INDENT: 'tree-indent',\n\n  // Grouping (GroupingRowsPlugin applies, core CSS styles)\n  GROUP_TOGGLE: 'group-toggle',\n  GROUP_LABEL: 'group-label',\n  GROUP_COUNT: 'group-count',\n\n  // Selection (SelectionPlugin applies, core CSS styles)\n  RANGE_SELECTION: 'range-selection',\n  SELECTION_OVERLAY: 'selection-overlay',\n} as const;\n\n// #endregion\n\n// #region Data Attributes\n\n/**\n * Data attribute names used on grid elements.\n * Use these when getting/setting data attributes.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridDataAttrs = {\n  // ─── Core Attributes ──────────────────────────────────────────────\n  FIELD: 'data-field',\n\n  /**\n   * Marks a `title` the grid itself put on a cell to reveal ellipsised text\n   * (WCAG SC 1.4.12). Anything that sets its own `title` on a cell must clear\n   * this, or the grid will later mistake that title for its own and replace it.\n   *\n   * @since 3.6.0\n   */\n  TRUNCATED: 'data-tbw-truncated',\n\n  // ─── Shared Attributes (used by plugins) ──────────────────────────\n  GROUP_KEY: 'data-group-key', // GroupingRowsPlugin\n} as const;\n\n// #endregion\n\n// #region Selectors\n\n/**\n * Common CSS selectors for querying grid elements.\n * Built from the class constants for consistency.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridSelectors = {\n  ROOT: `.${GridClasses.ROOT}`,\n  HEADER: `.${GridClasses.HEADER}`,\n  HEADER_ROW: `.${GridClasses.HEADER_ROW}`,\n  HEADER_CELL: `.${GridClasses.HEADER_CELL}`,\n  ROWS_VIEWPORT: `.${GridClasses.ROWS_VIEWPORT}`,\n  ROWS_CONTAINER: `.${GridClasses.ROWS_CONTAINER}`,\n  DATA_ROW: `.${GridClasses.DATA_ROW}`,\n  DATA_CELL: `.${GridClasses.DATA_CELL}`,\n  GROUP_ROW: `.${GridClasses.GROUP_ROW}`,\n\n  // By data attribute\n  CELL_BY_FIELD: (field: string) => `.${GridClasses.DATA_CELL}[${GridDataAttrs.FIELD}=\"${field}\"]`,\n\n  // State selectors\n  SELECTED_ROWS: `.${GridClasses.DATA_ROW}.${GridClasses.SELECTED}`,\n  EDITING_CELL: `.${GridClasses.DATA_CELL}.${GridClasses.EDITING}`,\n} as const;\n\n// #endregion\n\n// #region CSS Custom Properties\n\n/**\n * CSS custom property names for theming.\n * Use these when programmatically setting styles.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport const GridCSSVars = {\n  // Colors\n  COLOR_BG: '--tbw-color-bg',\n  COLOR_FG: '--tbw-color-fg',\n  COLOR_FG_MUTED: '--tbw-color-fg-muted',\n  COLOR_BORDER: '--tbw-color-border',\n  COLOR_ACCENT: '--tbw-color-accent',\n  COLOR_HEADER_BG: '--tbw-color-header-bg',\n  COLOR_HEADER_FG: '--tbw-color-header-fg',\n  COLOR_SELECTION: '--tbw-color-selection',\n  COLOR_ROW_HOVER: '--tbw-color-row-hover',\n  COLOR_ROW_ALT: '--tbw-color-row-alt',\n\n  // Sizing\n  ROW_HEIGHT: '--tbw-row-height',\n  HEADER_HEIGHT: '--tbw-header-height',\n  CELL_PADDING: '--tbw-cell-padding',\n\n  // Typography\n  FONT_FAMILY: '--tbw-font-family',\n  FONT_SIZE: '--tbw-font-size',\n\n  // Borders\n  BORDER_RADIUS: '--tbw-border-radius',\n  FOCUS_OUTLINE: '--tbw-focus-outline',\n} as const;\n\n// #endregion\n\n// Type helpers\n\n/**\n * Union of all CSS class names used in the grid's DOM.\n * Use `GridClasses` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridClassName = (typeof GridClasses)[keyof typeof GridClasses];\n\n/**\n * Union of all `data-*` attribute names used on grid elements.\n * Use `GridDataAttrs` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridDataAttr = (typeof GridDataAttrs)[keyof typeof GridDataAttrs];\n\n/**\n * Union of all CSS custom property names (`--tbw-*`) available for theming.\n * Use `GridCSSVars` to access individual values by key.\n *\n * @category Plugin Development\n * @since 0.1.1\n */\nexport type GridCSSVar = (typeof GridCSSVars)[keyof typeof GridCSSVars];\n","/**\n * DOM Builder - Direct DOM construction for performance.\n *\n * Using direct DOM APIs instead of innerHTML is significantly faster:\n * - No HTML parsing by the browser\n * - No template string concatenation\n * - Immediate element creation without serialization/deserialization\n *\n * Benchmark: DOM construction is ~2-3x faster than innerHTML for complex structures.\n */\n\nimport { GridClasses } from '../constants';\nimport { setSanitizedHTML } from './sanitize';\n\n// #region Element Factories\n/**\n * Apply attributes to an element, skipping null/undefined values.\n * Shared by createElement/div/button to keep the bundle small.\n */\nfunction applyAttrs(el: Element, attrs: Record<string, string | undefined> | undefined): void {\n  if (!attrs) return;\n  for (const key in attrs) {\n    const value = attrs[key];\n    if (value != null) el.setAttribute(key, value);\n  }\n}\n\n/**\n * Create an element with attributes and optional children.\n * Optimized helper that avoids repeated function calls.\n */\nfunction createElement<K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  attrs?: Record<string, string>,\n  children?: (Node | string | null | undefined)[],\n): HTMLElementTagNameMap[K] {\n  const el = document.createElement(tag);\n  applyAttrs(el, attrs);\n\n  if (children) {\n    for (const child of children) {\n      if (child == null) continue;\n      if (typeof child === 'string') {\n        el.appendChild(document.createTextNode(child));\n      } else {\n        el.appendChild(child);\n      }\n    }\n  }\n\n  return el;\n}\n\n/**\n * Create an element with class (common pattern).\n */\nfunction div(className?: string, attrs?: Record<string, string>): HTMLDivElement {\n  const el = document.createElement('div');\n  if (className) el.className = className;\n  applyAttrs(el, attrs);\n  return el;\n}\n\n/**\n * Create a button element. Always sets `type=\"button\"` (callers can override\n * via `attrs`) so internal grid buttons inside a <form> never default to\n * type=\"submit\". See issue #296.\n */\nfunction button(className?: string, attrs?: Record<string, string>, content?: string | Node): HTMLButtonElement {\n  const el = document.createElement('button');\n  el.type = 'button';\n  if (className) el.className = className;\n  applyAttrs(el, attrs);\n  if (content) {\n    if (typeof content === 'string') {\n      el.textContent = content;\n    } else {\n      el.appendChild(content);\n    }\n  }\n  return el;\n}\n// #endregion\n\n// #region Grid Templates\n/**\n * Template for grid content (the core scrollable grid area).\n * Pre-built once, then cloned for each grid instance.\n */\nconst gridContentTemplate = document.createElement('template');\ngridContentTemplate.innerHTML = `\n  <div class=\"tbw-scroll-area\">\n    <div class=\"rows-body-wrapper\">\n      <div class=\"rows-body\" role=\"grid\">\n        <div class=\"header\" role=\"rowgroup\">\n          <div class=\"header-row\" role=\"row\" part=\"header-row\"></div>\n        </div>\n        <div class=\"rows-container\" role=\"presentation\">\n          <div class=\"rows-viewport\" role=\"presentation\">\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  <div class=\"tbw-sr-only\" aria-live=\"polite\" aria-atomic=\"true\"></div>\n`;\n\n/**\n * Clone the grid content structure.\n * Using template cloning is faster than createElement for nested structures.\n */\nexport function cloneGridContent(): DocumentFragment {\n  return gridContentTemplate.content.cloneNode(true) as DocumentFragment;\n}\n// #endregion\n\n// #region Grid DOM Building\n/**\n * Build the grid root structure using direct DOM construction.\n * This is called once per grid instance during initial render.\n */\nexport interface GridDOMOptions {\n  hasShell: boolean;\n  /** Shell header element (pre-built) */\n  shellHeader?: Element;\n  /** Shell body element with tool panel (pre-built) */\n  shellBody?: Element;\n}\n\n/**\n * Build the complete grid DOM structure.\n * Returns a DocumentFragment ready to be appended to shadow root.\n */\nexport function buildGridDOM(options: GridDOMOptions): DocumentFragment {\n  const fragment = document.createDocumentFragment();\n\n  const root = div(options.hasShell ? `${GridClasses.ROOT} has-shell` : GridClasses.ROOT);\n\n  if (options.hasShell && options.shellBody) {\n    // Shell mode: optional header + body (with grid content inside).\n    // The header bar may be suppressed via `shell.header.visible: false`, in\n    // which case only the body (and its tool panel) is rendered.\n    if (options.shellHeader) root.appendChild(options.shellHeader);\n    root.appendChild(options.shellBody);\n  } else {\n    // No shell: just grid content in wrapper\n    const contentWrapper = div('tbw-grid-content');\n    contentWrapper.appendChild(cloneGridContent());\n    root.appendChild(contentWrapper);\n  }\n\n  fragment.appendChild(root);\n  return fragment;\n}\n\n/**\n * Build the BARE grid DOM (no shell chrome) directly into `renderRoot`.\n *\n * Preserves all existing direct child nodes EXCEPT the grid's own\n * `.tbw-grid-root` (which is rebuilt), so user/framework light-DOM stays intact\n * in its original order — including non-element nodes (comment anchors used by\n * Angular `@if`/`@for` and other structural directives as positional markers).\n *\n * Core's render path always builds the bare grid; the shell, when configured,\n * is wrapped around this freshly built grid by the auto-registered ShellPlugin\n * in the `afterStructuralRender` hook (extraction #370 — DOM ownership\n * inversion). Core therefore holds no shell-construction knowledge.\n */\nexport function buildBareGridDOMIntoElement(renderRoot: Element): void {\n  const preservedNodes: Node[] = [];\n  for (let n: Node | null = renderRoot.firstChild; n; n = n.nextSibling) {\n    if (n.nodeType === 1 && (n as Element).classList.contains(GridClasses.ROOT)) continue;\n    preservedNodes.push(n);\n  }\n\n  // Clear existing content (this would delete light DOM nodes, so we preserved them first).\n  renderRoot.replaceChildren();\n\n  // Re-append preserved nodes in original order (hidden elements are used for config).\n  // IMPORTANT: These are prepended before .tbw-grid-root, so `renderRoot.children[0]`\n  // is NOT the grid root. Use `querySelector('.tbw-grid-root')` instead.\n  for (const n of preservedNodes) {\n    renderRoot.appendChild(n);\n  }\n\n  renderRoot.appendChild(buildGridDOM({ hasShell: false }));\n}\n// #endregion\n\n// #region Shell Header\n/**\n * Build shell header using direct DOM construction.\n *\n * Note: The grid no longer creates buttons from config (icon/action).\n * Config/API buttons only use element or render function.\n * Light DOM buttons are slotted directly.\n * The ONLY button the grid creates is the panel toggle.\n */\nexport interface ShellHeaderOptions {\n  title?: string;\n  hasPanels: boolean;\n  isPanelOpen: boolean;\n  toolPanelIcon?: string;\n  /**\n   * Whether to render the built-in tool panel toggle button and the\n   * adjacent separator. Independent of `hasPanels` so panels can remain\n   * registered (and openable via the public API) while the consumer\n   * supplies their own toggle button.\n   * @default true when hasPanels is true\n   */\n  showToggle?: boolean;\n  /** Config toolbar contents with render function (pre-sorted by order) */\n  configButtons: Array<{\n    id: string;\n    hasRender?: boolean;\n  }>;\n  /** API toolbar contents with render function (pre-sorted by order) */\n  apiButtons: Array<{\n    id: string;\n    hasRender?: boolean;\n  }>;\n}\n\n/**\n * Build shell header element directly without innerHTML.\n */\nexport function buildShellHeader(options: ShellHeaderOptions): HTMLDivElement {\n  const header = div('tbw-shell-header', { part: 'shell-header', role: 'presentation' });\n\n  // Title\n  if (options.title) {\n    const titleEl = div('tbw-shell-title');\n    titleEl.textContent = options.title;\n    header.appendChild(titleEl);\n  }\n\n  // Shell content with placeholder for light DOM header content\n  const content = div('tbw-shell-content', {\n    part: 'shell-content',\n    role: 'presentation',\n    'data-light-dom-header-content': '',\n  });\n  header.appendChild(content);\n\n  // Toolbar\n  const toolbar = div('tbw-shell-toolbar', { part: 'shell-toolbar', role: 'presentation' });\n\n  // Placeholders for config toolbar contents with render function\n  for (const btn of options.configButtons) {\n    if (btn.hasRender) {\n      toolbar.appendChild(div('tbw-toolbar-content-slot', { 'data-toolbar-content': btn.id }));\n    }\n  }\n  // Placeholders for API toolbar contents with render function\n  for (const btn of options.apiButtons) {\n    if (btn.hasRender) {\n      toolbar.appendChild(div('tbw-toolbar-content-slot', { 'data-toolbar-content': btn.id }));\n    }\n  }\n\n  // Separator between custom content and panel toggle\n  const hasCustomContent =\n    options.configButtons.some((b) => b.hasRender) || options.apiButtons.some((b) => b.hasRender);\n  // Default showToggle to hasPanels for backwards compat; suppress both the\n  // button and the separator when the consumer opts out.\n  const showToggle = options.hasPanels && options.showToggle !== false;\n  if (hasCustomContent && showToggle) {\n    toolbar.appendChild(div('tbw-toolbar-separator'));\n  }\n\n  // Panel toggle button (suppressed when shell.header.toolPanelToggle is false)\n  if (showToggle) {\n    const toggleBtn = button(options.isPanelOpen ? 'tbw-toolbar-btn active' : 'tbw-toolbar-btn', {\n      'data-panel-toggle': '',\n      title: 'Settings',\n      'aria-label': 'Toggle settings panel',\n      'aria-pressed': String(options.isPanelOpen),\n      'aria-controls': 'tbw-tool-panel',\n    });\n    toggleBtn.dataset.icon = 'tool-panel';\n    if (options.toolPanelIcon !== undefined) {\n      setSanitizedHTML(toggleBtn, options.toolPanelIcon);\n    }\n    toolbar.appendChild(toggleBtn);\n  }\n\n  header.appendChild(toolbar);\n  return header;\n}\n// #endregion\n\n// #region Shell Body\n/**\n * Build shell body (grid content + optional tool panel).\n */\nexport interface ShellBodyOptions {\n  position: 'left' | 'right';\n  /**\n   * Layout mode for the tool panel.\n   * - `'overlay'` (default): panel is absolutely positioned over the grid.\n   * - `'push'`: panel participates in flex layout, shrinking the grid sibling.\n   * - `'dropdown'`: panel is a native popover anchored near a trigger element.\n   */\n  mode?: 'overlay' | 'push' | 'dropdown';\n  isPanelOpen: boolean;\n  expandIcon?: string;\n  collapseIcon?: string;\n  /**\n   * Render an in-panel close (✕) button in the panel's top-right corner.\n   * Used when the shell header bar is hidden (`shell.header.visible: false`)\n   * so the panel can be dismissed without the built-in header toggle.\n   */\n  showCloseButton?: boolean;\n  /** Sorted panels for accordion */\n  panels: Array<{\n    id: string;\n    title?: string;\n    icon?: string;\n    isExpanded: boolean;\n  }>;\n}\n\n/**\n * Panel close (✕) button. `data-panel-close` is wired by\n * `setupShellEventListeners` to close the panel.\n */\nfunction buildPanelCloseButton(inline: boolean): HTMLButtonElement {\n  const closeBtn = button(inline ? 'tbw-tool-panel-close tbw-tool-panel-close--inline' : 'tbw-tool-panel-close', {\n    part: 'tool-panel-close',\n    'data-panel-close': '',\n    title: 'Close panel',\n    'aria-label': 'Close panel',\n    'aria-controls': 'tbw-tool-panel',\n  });\n  closeBtn.textContent = '✕';\n  return closeBtn;\n}\n\n/** Slim standalone header row holding just the close button. */\nfunction buildPanelCloseRow(): HTMLDivElement {\n  const panelHeader = div('tbw-tool-panel-header', { part: 'tool-panel-header' });\n  panelHeader.appendChild(buildPanelCloseButton(false));\n  return panelHeader;\n}\n\n/** Accordion header button: icon + title + chevron. */\nfunction buildAccordionHeader(\n  panel: ShellBodyOptions['panels'][number],\n  options: ShellBodyOptions,\n  isSinglePanel: boolean,\n): HTMLButtonElement {\n  const headerBtn = button('tbw-accordion-header', {\n    'aria-expanded': String(panel.isExpanded),\n    'aria-controls': `tbw-section-${panel.id}`,\n  });\n  if (isSinglePanel) headerBtn.setAttribute('aria-disabled', 'true');\n\n  if (panel.icon) {\n    const iconSpan = createElement('span', { class: 'tbw-accordion-icon' });\n    setSanitizedHTML(iconSpan, panel.icon);\n    headerBtn.appendChild(iconSpan);\n  }\n\n  // Title (empty span kept as a flex spacer so the chevron stays right-aligned)\n  const titleSpan = createElement('span', { class: 'tbw-accordion-title' });\n  titleSpan.textContent = panel.title ?? '';\n  headerBtn.appendChild(titleSpan);\n\n  // Chevron (hidden for single panel) — always use expandIcon, CSS rotation handles state\n  if (!isSinglePanel) {\n    const chevronSpan = createElement('span', { class: 'tbw-accordion-chevron', 'data-icon': 'expand' });\n    if (options.expandIcon !== undefined) {\n      setSanitizedHTML(chevronSpan, options.expandIcon);\n    }\n    headerBtn.appendChild(chevronSpan);\n  }\n  return headerBtn;\n}\n\n/** One accordion section (header row + empty content slot). */\nfunction buildAccordionSection(\n  panel: ShellBodyOptions['panels'][number],\n  options: ShellBodyOptions,\n  isSinglePanel: boolean,\n  inlineClose: boolean,\n): HTMLDivElement {\n  // The accordion header row (icon + title + chevron/toggle) is skipped only\n  // when a single title-less panel is registered — there is nothing to show and\n  // no sibling to toggle between. With multiple panels a title-less header still\n  // renders (empty title span) so the chevron and toggle button stay available.\n  const renderHeader = !!panel.title || !isSinglePanel;\n  // Inline close shares the header row; only possible when a header exists.\n  const canInlineClose = inlineClose && renderHeader;\n  const sectionClasses = `tbw-accordion-section${panel.isExpanded ? ' expanded' : ''}${isSinglePanel ? ' single' : ''}${canInlineClose ? ' has-inline-close' : ''}`;\n  const section = div(sectionClasses, { 'data-section': panel.id });\n\n  if (renderHeader) {\n    const headerBtn = buildAccordionHeader(panel, options, isSinglePanel);\n    if (canInlineClose) {\n      // Single-panel close button shares the header row with the panel title.\n      const headerRow = div('tbw-accordion-header-row');\n      headerRow.appendChild(headerBtn);\n      headerRow.appendChild(buildPanelCloseButton(true));\n      section.appendChild(headerRow);\n    } else {\n      section.appendChild(headerBtn);\n    }\n  } else if (inlineClose) {\n    // Single title-less panel with the header suppressed: the inline close\n    // button has no header row to share, so render it as a standalone row.\n    section.appendChild(buildPanelCloseRow());\n  }\n\n  // Accordion content (empty, will be filled by panel render functions)\n  section.appendChild(\n    div('tbw-accordion-content', {\n      id: `tbw-section-${panel.id}`,\n      role: 'presentation',\n    }),\n  );\n  return section;\n}\n\n/** The `<aside>` tool panel: resize handle, optional close affordance, accordion. */\nfunction buildToolPanel(options: ShellBodyOptions, mode: 'overlay' | 'push' | 'dropdown'): HTMLElement {\n  const isSinglePanel = options.panels.length === 1;\n  const panelEl = createElement('aside', {\n    class: options.isPanelOpen ? 'tbw-tool-panel open' : 'tbw-tool-panel',\n    part: 'tool-panel',\n    'data-position': options.position,\n    role: 'presentation',\n    id: 'tbw-tool-panel',\n    // In dropdown mode the panel is a manually-controlled native popover\n    // (shown/hidden via showPopover()/hidePopover() from the controller).\n    ...(mode === 'dropdown' ? { popover: 'manual' } : {}),\n  });\n\n  // Resize handle — draggable, and tappable for the SC 2.5.7 size menu.\n  panelEl.appendChild(\n    div('tbw-tool-panel-resize', {\n      'data-resize-handle': '',\n      'data-handle-position': options.position === 'left' ? 'right' : 'left',\n      role: 'button',\n      tabindex: '-1',\n      'aria-label': 'Tool panel width — drag, or activate to set a width',\n    }),\n  );\n\n  // Optional close (✕) button — rendered (overlay/push only) when the shell\n  // header bar is hidden, so the panel can always be dismissed. Dropdown mode\n  // never reaches here (showCloseButton is gated off upstream).\n  //\n  // Placement:\n  // - Multiple panels: a dedicated slim header row above the accordion.\n  // - Single panel: inlined onto the (only) accordion header row so it shares\n  //   the line with the panel title instead of wasting a full-width row.\n  const inlineClose = options.showCloseButton === true && isSinglePanel;\n  if (options.showCloseButton && !isSinglePanel) {\n    panelEl.appendChild(buildPanelCloseRow());\n  }\n\n  const panelContent = div('tbw-tool-panel-content', { role: 'presentation' });\n  const accordion = div('tbw-accordion');\n  for (const panel of options.panels) {\n    accordion.appendChild(buildAccordionSection(panel, options, isSinglePanel, inlineClose));\n  }\n  panelContent.appendChild(accordion);\n  panelEl.appendChild(panelContent);\n  return panelEl;\n}\n\n/**\n * Build shell body element directly without innerHTML.\n */\nexport function buildShellBody(options: ShellBodyOptions): HTMLDivElement {\n  const mode = options.mode ?? 'overlay';\n  const body = div('tbw-shell-body', { 'data-mode': mode });\n\n  // Grid content wrapper with cloned grid structure\n  const gridContent = div('tbw-grid-content');\n  gridContent.appendChild(cloneGridContent());\n\n  const panelEl = options.panels.length > 0 ? buildToolPanel(options, mode) : null;\n\n  // Append in correct order based on position\n  if (options.position === 'left' && panelEl) {\n    body.appendChild(panelEl);\n    body.appendChild(gridContent);\n  } else {\n    body.appendChild(gridContent);\n    if (panelEl) body.appendChild(panelEl);\n  }\n\n  return body;\n}\n// #endregion\n","/**\n * Shell infrastructure for grid header bar and tool panels.\n *\n * The shell is an optional wrapper layer that provides:\n * - Header bar with title, plugin content, and toolbar buttons\n * - Tool panels that plugins can register content into\n * - Light DOM parsing for framework-friendly configuration\n */\n\nimport { TOOL_PANEL_DUPLICATE, TOOL_PANEL_MISSING_ATTR, warnDiagnostic } from '../../core/internal/diagnostics';\nimport { startPointerDrag } from '../../core/internal/pointer-drag';\nimport { escapeHtml, sanitizeHTML, setSanitizedHTML } from '../../core/internal/sanitize';\nimport { createSizePopover, type SizePopover } from '../../core/internal/size-popover';\nimport type { IconValue } from '../../core/types';\nimport type { HeaderContentDefinition, ShellConfig, ToolbarContentDefinition, ToolPanelDefinition } from './types';\n\n/** Tool-panel width change per click of the size popover's − / + buttons, in px. */\nconst RESIZE_STEP_PX = 32;\n\n// #region Types & State\n/**\n * Convert an IconValue to a string for rendering in HTML.\n */\nfunction iconToString(icon: IconValue | undefined): string {\n  if (!icon) return '';\n  if (typeof icon === 'string') return sanitizeHTML(icon);\n  // For HTMLElement, get the outerHTML\n  return icon.outerHTML;\n}\n\n/**\n * State for managing shell UI.\n *\n * This interface holds both configuration-like properties (toolPanels, headerContents)\n * and runtime state (isPanelOpen, expandedSections). The Maps allow for efficient\n * registration/unregistration of panels and content.\n */\nexport interface ShellState {\n  /** Registered tool panels (from plugins + consumer API) */\n  toolPanels: Map<string, ToolPanelDefinition>;\n  /** Registered header content (from plugins + consumer API) */\n  headerContents: Map<string, HeaderContentDefinition>;\n  /** Toolbar content registered via API or light DOM */\n  toolbarContents: Map<string, ToolbarContentDefinition>;\n  /** Whether a <tbw-grid-tool-buttons> container was found in light DOM */\n  hasToolButtonsContainer: boolean;\n  /** Light DOM header content elements */\n  lightDomHeaderContent: HTMLElement[];\n  /** Light DOM header title from <tbw-grid-header title=\"...\"> */\n  lightDomTitle: string | null;\n  /** IDs of tool panels registered from light DOM (to avoid re-parsing) */\n  lightDomToolPanelIds: Set<string>;\n  /**\n   * IDs of light DOM tool panels whose `render` has already been bound to a\n   * framework-adapter renderer. Used by `parseLightDomToolPanels` to detect\n   * the FIRST adapter attach (which legitimately needs to swap the vanilla\n   * fallback for the real adapter renderer and tear down any in-progress\n   * render) vs. subsequent re-parses (which must NOT tear down — doing so\n   * unmounts the user's React/Vue/Angular component, losing local state and\n   * resetting scroll position inside the panel).\n   */\n  adapterBoundToolPanelIds: Set<string>;\n  /** IDs of toolbar content registered from light DOM (to avoid re-parsing) */\n  lightDomToolbarContentIds: Set<string>;\n  /** IDs of tool panels registered via registerToolPanel API */\n  apiToolPanelIds: Set<string>;\n  /** IDs of header content registered via registerHeaderContent API */\n  apiHeaderContentIds: Set<string>;\n  /** Whether the tool panel sidebar is open */\n  isPanelOpen: boolean;\n  /** Which accordion sections are expanded (by panel ID) */\n  expandedSections: Set<string>;\n  /** Whether light DOM header content has been moved to placeholder (perf optimization) */\n  lightDomContentMoved: boolean;\n  /** Cleanup functions for header content render returns */\n  headerContentCleanups: Map<string, () => void>;\n  /** Cleanup functions for each panel section's render return */\n  panelCleanups: Map<string, () => void>;\n  /** Cleanup functions for toolbar content render returns */\n  toolbarContentCleanups: Map<string, () => void>;\n  /**\n   * Element the dropdown popover is currently anchored to (mode: 'dropdown').\n   * Tracked so dismissal logic can ignore clicks on the anchor and the\n   * `anchor-name` it set can be cleared on close. `null` when no dropdown is open.\n   */\n  dropdownAnchorEl?: HTMLElement | null;\n  /**\n   * Unique `anchor-name` assigned to the current dropdown's trigger (and\n   * mirrored as `position-anchor` on the popover). Minted per show so multiple\n   * grids on one page never collide on a shared anchor name — a collision would\n   * position one grid's popover against another grid's trigger. `null` when no\n   * dropdown is open.\n   */\n  dropdownAnchorName?: string | null;\n}\n\n/**\n * Create initial shell state.\n */\nexport function createShellState(): ShellState {\n  return {\n    toolPanels: new Map(),\n    headerContents: new Map(),\n    toolbarContents: new Map(),\n    hasToolButtonsContainer: false,\n    lightDomHeaderContent: [],\n    lightDomTitle: null,\n    lightDomToolPanelIds: new Set(),\n    adapterBoundToolPanelIds: new Set(),\n    lightDomToolbarContentIds: new Set(),\n    apiToolPanelIds: new Set(),\n    apiHeaderContentIds: new Set(),\n    isPanelOpen: false,\n    expandedSections: new Set(),\n    headerContentCleanups: new Map(),\n    panelCleanups: new Map(),\n    toolbarContentCleanups: new Map(),\n    lightDomContentMoved: false,\n    dropdownAnchorEl: null,\n    dropdownAnchorName: null,\n  };\n}\n// #endregion\n\n// #region Render Functions\n/**\n * Determine if shell header should be rendered.\n * Reads only from effectiveConfig.shell (single source of truth).\n */\nexport function shouldRenderShellHeader(config: ShellConfig | undefined): boolean {\n  // Check if title is configured\n  if (config?.header?.title) return true;\n\n  // Check if config has toolbar contents\n  if (config?.header?.toolbarContents?.length) return true;\n\n  // Check if any tool panels are registered\n  if (config?.toolPanels?.length) return true;\n\n  // Check if any header content is registered\n  if (config?.headerContents?.length) return true;\n\n  // Check if light DOM has header elements\n  if (config?.header?.lightDomContent?.length) return true;\n\n  // Check if a toolbar buttons container was found\n  if (config?.header?.hasToolButtonsContainer) return true;\n\n  return false;\n}\n\n/**\n * Determine whether the visible shell header bar (`.tbw-shell-header`) should\n * be rendered.\n *\n * Distinct from {@link shouldRenderShellHeader}, which decides whether the\n * shell *wrapper* (including the body that hosts the tool panel) exists at\n * all. The header bar can be suppressed via `header.visible: false` while the\n * shell body and tool panels still render — letting consumers drive panels\n * from their own UI (e.g. a utility-column header icon).\n */\nexport function shouldRenderHeaderBar(config: ShellConfig | undefined): boolean {\n  return config?.header?.visible !== false;\n}\n\n/**\n * Render the shell header HTML.\n *\n * Toolbar contents come from two sources:\n * 1. Light DOM slot (users provide their own HTML in <tbw-grid-tool-buttons>)\n * 2. Config/API with render function (programmatic insertion)\n *\n * Users have full control over toolbar HTML, styling, and behavior.\n * The only button the grid creates is the tool panel toggle.\n *\n * @param toolPanelIcon - Icon for the tool panel toggle (from grid icon config)\n */\nexport function renderShellHeader(\n  config: ShellConfig | undefined,\n  state: ShellState,\n  toolPanelIcon?: IconValue,\n): string {\n  const title = config?.header?.title ?? state.lightDomTitle ?? '';\n  const hasTitle = !!title;\n\n  // Build tool panel button content: use data-icon for CSS, inject content only for JS overrides\n  let toolPanelBtnContent = '';\n  if (toolPanelIcon !== undefined) {\n    // JS override: inject content but still set data-icon\n    toolPanelBtnContent = typeof toolPanelIcon === 'string' ? sanitizeHTML(toolPanelIcon) : toolPanelIcon.outerHTML;\n  }\n\n  // Get all toolbar contents from effectiveConfig (already merged: config + API + light DOM)\n  // The config-manager merges state.toolbarContents into effectiveConfig.shell.header.toolbarContents\n  // Also include state.toolbarContents directly for cases where renderShellHeader is called\n  // before config-manager has merged (e.g., unit tests, initial render)\n  const configContents = config?.header?.toolbarContents ?? [];\n  const stateContents = [...state.toolbarContents.values()];\n\n  // Merge: use config contents, add state contents that aren't in config\n  const configIds = new Set(configContents.map((c) => c.id));\n  const allContents = [...configContents];\n  for (const content of stateContents) {\n    if (!configIds.has(content.id)) {\n      allContents.push(content);\n    }\n  }\n\n  const hasCustomContent = allContents.length > 0;\n  const hasPanels = state.toolPanels.size > 0;\n  // Allow consumers to suppress the built-in toggle (and the separator that\n  // only exists to space it from custom toolbar contents) so they can render\n  // their own design-system button and wire it to `grid.toggleToolPanel()`.\n  // Also suppress when the tool panel is locked open — toggling is disabled.\n  // Default true preserves existing behavior.\n  const isLocked = config?.toolPanel?.locked === true;\n  const showToggle = hasPanels && config?.header?.toolPanelToggle !== false && !isLocked;\n  const showSeparator = hasCustomContent && showToggle;\n\n  // Sort contents by order for slot placement\n  const sortedContents = [...allContents].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n\n  // Build toolbar HTML\n  let toolbarHtml = '';\n\n  // Create slots for all contents (unified: config + API + light DOM)\n  for (const content of sortedContents) {\n    toolbarHtml += `<div class=\"tbw-toolbar-content-slot\" data-toolbar-content=\"${content.id}\"></div>`;\n  }\n\n  // Separator between custom content and panel toggle\n  if (showSeparator) {\n    toolbarHtml += '<div class=\"tbw-toolbar-separator\"></div>';\n  }\n\n  // Single panel toggle button (the ONLY button the grid creates).\n  // Suppressed when `shell.header.toolPanelToggle === false` so consumers can\n  // BYO toggle button without hiding library DOM via CSS.\n  if (showToggle) {\n    const isOpen = state.isPanelOpen;\n    const toggleClass = isOpen ? 'tbw-toolbar-btn active' : 'tbw-toolbar-btn';\n    // type=\"button\" is required: without it a <button> inside a <form>\n    // defaults to type=\"submit\" and clicking the toggle would submit the\n    // surrounding form. Internal grid buttons must never trigger form\n    // submission. See issue #296.\n    toolbarHtml += `<button type=\"button\" class=\"${toggleClass}\" data-panel-toggle data-icon=\"tool-panel\" title=\"Settings\" aria-label=\"Toggle settings panel\" aria-pressed=\"${isOpen}\" aria-controls=\"tbw-tool-panel\">${toolPanelBtnContent}</button>`;\n  }\n\n  return `\n    <div class=\"tbw-shell-header\" part=\"shell-header\" role=\"presentation\">\n      ${hasTitle ? `<div class=\"tbw-shell-title\">${escapeHtml(title)}</div>` : ''}\n      <div class=\"tbw-shell-content\" part=\"shell-content\" role=\"presentation\" data-light-dom-header-content></div>\n      <div class=\"tbw-shell-toolbar\" part=\"shell-toolbar\" role=\"presentation\">\n        ${toolbarHtml}\n      </div>\n    </div>\n  `;\n}\n\n/**\n * Render the shell body wrapper HTML (contains grid content + accordion-style tool panel).\n * @param icons - Optional icons for expand/collapse chevrons (from grid config)\n */\nexport function renderShellBody(\n  config: ShellConfig | undefined,\n  state: ShellState,\n  gridContentHtml: string,\n  icons?: { expand?: IconValue; collapse?: IconValue },\n): string {\n  const position = config?.toolPanel?.position ?? 'right';\n  const mode = config?.toolPanel?.mode ?? 'overlay';\n  const hasPanel = state.toolPanels.size > 0;\n  const isOpen = state.isPanelOpen;\n  const hasJsExpandIcon = icons?.expand !== undefined;\n  const expandIcon = hasJsExpandIcon ? iconToString(icons.expand) : '';\n\n  // Sort panels by order for accordion sections\n  const sortedPanels = [...state.toolPanels.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n  const isSinglePanel = sortedPanels.length === 1;\n\n  // Build accordion sections HTML\n  let accordionHtml = '';\n  for (const panel of sortedPanels) {\n    const isExpanded = state.expandedSections.has(panel.id);\n    const iconHtml = panel.icon ? `<span class=\"tbw-accordion-icon\">${panel.icon}</span>` : '';\n    // Hide chevron for single panel (no toggling needed)\n    // Always use expandIcon (▶) — CSS rotation handles the expanded state\n    const chevronHtml = isSinglePanel\n      ? ''\n      : `<span class=\"tbw-accordion-chevron\" data-icon=\"expand\">${expandIcon}</span>`;\n    // Disable accordion toggle for single panel\n    const sectionClasses = `tbw-accordion-section${isExpanded ? ' expanded' : ''}${isSinglePanel ? ' single' : ''}`;\n    // Skip the header row only for a single title-less panel. With multiple\n    // panels a title-less header still renders (empty title span) so the\n    // expand/collapse chevron and toggle button remain available.\n    const renderHeader = !!panel.title || !isSinglePanel;\n    const headerHtml = renderHeader\n      ? `<button type=\"button\" class=\"tbw-accordion-header\" aria-expanded=\"${isExpanded}\" aria-controls=\"tbw-section-${panel.id}\"${isSinglePanel ? ' aria-disabled=\"true\"' : ''}>\n          ${iconHtml}\n          <span class=\"tbw-accordion-title\">${escapeHtml(panel.title ?? '')}</span>\n          ${chevronHtml}\n        </button>`\n      : '';\n    accordionHtml += `\n      <div class=\"${sectionClasses}\" data-section=\"${panel.id}\">\n        ${headerHtml}\n        <div class=\"tbw-accordion-content\" id=\"tbw-section-${panel.id}\" role=\"presentation\"></div>\n      </div>\n    `;\n  }\n\n  // Resize handle position depends on panel position\n  const resizeHandlePosition = position === 'left' ? 'right' : 'left';\n\n  const panelHtml = hasPanel\n    ? `\n    <aside class=\"tbw-tool-panel${isOpen ? ' open' : ''}\" part=\"tool-panel\" data-position=\"${position}\" role=\"presentation\" id=\"tbw-tool-panel\"${mode === 'dropdown' ? ' popover=\"manual\"' : ''}>\n      <div class=\"tbw-tool-panel-resize\" data-resize-handle data-handle-position=\"${resizeHandlePosition}\" role=\"button\" tabindex=\"-1\" aria-label=\"Tool panel width — drag, or activate to set a width\"></div>\n      <div class=\"tbw-tool-panel-content\" role=\"presentation\">\n        <div class=\"tbw-accordion\">\n          ${accordionHtml}\n        </div>\n      </div>\n    </aside>\n  `\n    : '';\n\n  // For left position, panel comes before content in DOM order\n  if (position === 'left') {\n    return `\n      <div class=\"tbw-shell-body\" data-mode=\"${mode}\">\n        ${panelHtml}\n        <div class=\"tbw-grid-content\">\n          ${gridContentHtml}\n        </div>\n      </div>\n    `;\n  }\n\n  return `\n    <div class=\"tbw-shell-body\" data-mode=\"${mode}\">\n      <div class=\"tbw-grid-content\">\n        ${gridContentHtml}\n      </div>\n      ${panelHtml}\n    </div>\n  `;\n}\n// #endregion\n\n// #region Light DOM Parsing\n/**\n * Parse light DOM shell elements (tbw-grid-header, etc.).\n * Safe to call multiple times - will only parse once when elements are available.\n */\nexport function parseLightDomShell(host: HTMLElement, state: ShellState): void {\n  const headerEl = host.querySelector('tbw-grid-header');\n  if (!headerEl) return;\n\n  // Parse title attribute (only if not already parsed)\n  if (!state.lightDomTitle) {\n    const title = headerEl.getAttribute('title');\n    if (title) {\n      state.lightDomTitle = title;\n    }\n  }\n\n  // Parse header content elements - store references but don't set slot (light DOM doesn't use slots)\n  const headerContents = headerEl.querySelectorAll('tbw-grid-header-content');\n  if (headerContents.length > 0 && state.lightDomHeaderContent.length === 0) {\n    state.lightDomHeaderContent = Array.from(headerContents) as HTMLElement[];\n  }\n\n  // Hide the light DOM header container (it was just for declarative config)\n  (headerEl as HTMLElement).style.display = 'none';\n}\n\n/**\n * Callback type for creating a toolbar content renderer from a light DOM container.\n * This is used by framework adapters (Angular, React, etc.) to create renderers\n * from their template syntax.\n */\nexport type ToolbarContentRendererFactory = (\n  container: HTMLElement,\n) => ((target: HTMLElement) => void | (() => void)) | undefined;\n\n/**\n * Parse toolbar buttons container element (<tbw-grid-tool-buttons>).\n * This is a content container - we don't parse individual children.\n * The entire container content is registered as a single toolbar content entry.\n *\n * Example:\n * ```html\n * <tbw-grid>\n *   <tbw-grid-tool-buttons>\n *     <button>My button</button>\n *     <button>My other button</button>\n *   </tbw-grid-tool-buttons>\n * </tbw-grid>\n * ```\n *\n * The container's children are moved to the toolbar area during render.\n * We treat this as opaque content - users control what goes inside.\n *\n * @param host - The grid host element\n * @param state - Shell state to update\n * @param rendererFactory - Optional factory for creating renderers (used by framework adapters)\n */\nexport function parseLightDomToolButtons(\n  host: HTMLElement,\n  state: ShellState,\n  rendererFactory?: ToolbarContentRendererFactory,\n): void {\n  // Look for the toolbar buttons container element\n  const toolButtonsContainer = host.querySelector(':scope > tbw-grid-tool-buttons') as HTMLElement | null;\n  if (!toolButtonsContainer) return;\n\n  // Mark that we found the container (for shouldRenderShellHeader)\n  state.hasToolButtonsContainer = true;\n\n  // Skip if already registered\n  const id = 'light-dom-toolbar-content';\n  if (state.lightDomToolbarContentIds.has(id)) return;\n\n  // Register as a single content entry with a render function\n  const adapterRenderer = rendererFactory?.(toolButtonsContainer);\n\n  const contentDef: ToolbarContentDefinition = {\n    id,\n    order: 0, // Light DOM content comes first\n    render:\n      adapterRenderer ??\n      ((target: HTMLElement) => {\n        // Move all children from the light DOM container to the target\n        while (toolButtonsContainer.firstChild) {\n          target.appendChild(toolButtonsContainer.firstChild);\n        }\n        // Return cleanup that moves children back to original container\n        // This preserves them across full re-renders that destroy the slot\n        return () => {\n          while (target.firstChild) {\n            toolButtonsContainer.appendChild(target.firstChild);\n          }\n        };\n      }),\n  };\n\n  state.toolbarContents.set(id, contentDef);\n  state.lightDomToolbarContentIds.add(id);\n\n  // Hide the original container\n  toolButtonsContainer.style.display = 'none';\n}\n\n/**\n * Callback type for creating a tool panel renderer from a light DOM element.\n * This is used by framework adapters (Angular, React, etc.) to create renderers\n * from their template syntax.\n */\nexport type ToolPanelRendererFactory = (\n  element: HTMLElement,\n) => ((container: HTMLElement) => void | (() => void)) | undefined;\n\n/**\n * Parse light DOM tool panel elements (<tbw-grid-tool-panel>).\n * These can appear as direct children of <tbw-grid> for declarative tool panel configuration.\n *\n * Attributes:\n * - `id` (required): Unique panel identifier\n * - `title` (optional): Panel title shown in accordion header. Omit it when the\n *   panel content provides its own heading (see {@link ToolPanelDefinition.title}).\n * - `icon`: Icon for accordion section header (emoji or text)\n * - `tooltip`: Tooltip for accordion section header\n * - `order`: Panel order priority (lower = first, default: 100)\n *\n * For vanilla JS, the element's innerHTML is used as the panel content.\n * For framework adapters, the adapter can provide a custom renderer factory.\n *\n * @param host - The grid host element\n * @param state - Shell state to update\n * @param rendererFactory - Optional factory for creating renderers (used by framework adapters)\n */\nexport function parseLightDomToolPanels(\n  host: HTMLElement,\n  state: ShellState,\n  rendererFactory?: ToolPanelRendererFactory,\n): void {\n  const toolPanelElements = host.querySelectorAll(':scope > tbw-grid-tool-panel');\n\n  toolPanelElements.forEach((element) => {\n    const panelEl = element as HTMLElement;\n    const id = panelEl.getAttribute('id');\n    const title = panelEl.getAttribute('title') ?? undefined;\n\n    // Skip only if the required `id` is missing. `title` is optional (#430):\n    // a title-less panel renders its content without an accordion header row\n    // (single panel) or with an empty title span (multiple panels).\n    if (!id) {\n      warnDiagnostic(TOOL_PANEL_MISSING_ATTR, `Tool panel missing required id attribute: title=\"${title ?? ''}\"`);\n      return;\n    }\n\n    const icon = panelEl.getAttribute('icon') ?? undefined;\n    const tooltip = panelEl.getAttribute('tooltip') ?? undefined;\n    const order = parseInt(panelEl.getAttribute('order') ?? '100', 10);\n\n    // Try framework adapter first, then fall back to innerHTML\n    let render: (container: HTMLElement) => void | (() => void);\n\n    const adapterRenderer = rendererFactory?.(panelEl);\n    if (adapterRenderer) {\n      render = adapterRenderer;\n    } else {\n      // Vanilla fallback: use sanitized light-DOM markup as static content.\n      // Light DOM authored markup is generally trusted, but we sanitize\n      // defensively in case the panel content was server-rendered from data.\n      const rawContent = panelEl.innerHTML.trim();\n      render = (container: HTMLElement) => {\n        const wrapper = document.createElement('div');\n        setSanitizedHTML(wrapper, rawContent);\n        container.appendChild(wrapper);\n        return () => wrapper.remove();\n      };\n    }\n\n    // Check if panel was already parsed\n    const existingPanel = state.toolPanels.get(id);\n\n    // Precedence (#370): a panel contributed by a plugin (or registered via the\n    // grid API) owns its id. A light-DOM <tbw-grid-tool-panel> with the same id\n    // is ignored so the owner can rely on its own DOM existing. We detect a\n    // foreign owner by the id being present in toolPanels but NOT tracked as a\n    // light-DOM id (which would mean this is just a re-parse of our own panel).\n    if (existingPanel && !state.lightDomToolPanelIds.has(id)) {\n      warnDiagnostic(\n        TOOL_PANEL_DUPLICATE,\n        `Tool panel \"${id}\" is already provided by a plugin or the grid API; ignoring the matching light-DOM <tbw-grid-tool-panel>.`,\n      );\n      panelEl.style.display = 'none';\n      return;\n    }\n\n    // If already parsed and we have an adapter renderer, refresh the render\n    // function and (potentially) re-read attributes from DOM (Angular may have\n    // updated them after the initial parse). However, **only tear down the\n    // already-rendered panel content** when something the user can observe has\n    // actually changed:\n    //   - First time the adapter renderer attaches (we may have been using\n    //     the vanilla innerHTML fallback up to now)\n    //   - Any attribute the panel header renders from changed\n    //\n    // Otherwise the user's React/Vue/Angular component is already mounted in\n    // the panel and is happily managing its own state. A teardown here unmounts\n    // it (losing local state) and re-mounts it on next renderPanelContent —\n    // which, for a scrollable panel, resets `scrollTop` to 0. This was the\n    // cause of the \"tool panel scroll jumps to top on column visibility toggle\"\n    // bug: every `grid.gridConfig = …` setter in the adapter eventually calls\n    // back into parseLightDomToolPanels (via #applyGridConfigUpdate), and the\n    // previous unconditional `cleanup()` here threw away the user's component\n    // tree on every config sync.\n    if (existingPanel) {\n      if (adapterRenderer) {\n        const firstAdapterAttach = !state.adapterBoundToolPanelIds.has(id);\n        const attrsChanged =\n          existingPanel.title !== title ||\n          existingPanel.order !== order ||\n          existingPanel.icon !== icon ||\n          existingPanel.tooltip !== tooltip;\n\n        // Always keep the render function fresh — adapter renderers capture\n        // the current grid element / portal context and the most recent\n        // children, so a stale reference would render against an old closure.\n        existingPanel.render = render;\n        existingPanel.title = title;\n        existingPanel.order = order;\n        existingPanel.icon = icon;\n        existingPanel.tooltip = tooltip;\n        state.adapterBoundToolPanelIds.add(id);\n\n        if (firstAdapterAttach || attrsChanged) {\n          const cleanup = state.panelCleanups.get(id);\n          if (cleanup) {\n            cleanup();\n            state.panelCleanups.delete(id);\n          }\n        }\n      }\n      return;\n    }\n\n    // Register the tool panel\n    const panel: ToolPanelDefinition = {\n      id,\n      title,\n      icon,\n      tooltip,\n      order,\n      render,\n    };\n\n    state.toolPanels.set(id, panel);\n    state.lightDomToolPanelIds.add(id);\n    if (adapterRenderer) {\n      state.adapterBoundToolPanelIds.add(id);\n    }\n\n    // Hide the light DOM element\n    panelEl.style.display = 'none';\n  });\n}\n// #endregion\n\n// #region Event Handlers\n/**\n * Set up event listeners for shell toolbar buttons and accordion.\n */\nexport function setupShellEventListeners(\n  renderRoot: Element,\n  config: ShellConfig | undefined,\n  state: ShellState,\n  callbacks: {\n    onPanelToggle: () => void;\n    onSectionToggle: (sectionId: string) => void;\n    /** Invoked when the in-panel close (✕) button is clicked. */\n    onPanelClose?: () => void;\n  },\n): void {\n  const toolbar = renderRoot.querySelector('.tbw-shell-toolbar');\n  if (toolbar) {\n    toolbar.addEventListener('click', (e) => {\n      const target = e.target as HTMLElement;\n\n      // Handle single panel toggle button\n      const panelToggle = target.closest('[data-panel-toggle]') as HTMLElement | null;\n      if (panelToggle) {\n        callbacks.onPanelToggle();\n        return;\n      }\n    });\n  }\n\n  // In-panel close (✕) button — only present when the header bar is hidden.\n  const panel = renderRoot.querySelector('.tbw-tool-panel');\n  if (panel && callbacks.onPanelClose) {\n    panel.addEventListener('click', (e) => {\n      const target = e.target as HTMLElement;\n      if (target.closest('[data-panel-close]')) {\n        callbacks.onPanelClose!();\n      }\n    });\n  }\n\n  // Accordion header clicks\n  const accordion = renderRoot.querySelector('.tbw-accordion');\n  if (accordion) {\n    accordion.addEventListener('click', (e) => {\n      const target = e.target as HTMLElement;\n      const header = target.closest('.tbw-accordion-header') as HTMLElement | null;\n      if (header) {\n        const section = header.closest('[data-section]') as HTMLElement | null;\n        const sectionId = section?.getAttribute('data-section');\n        if (sectionId) {\n          callbacks.onSectionToggle(sectionId);\n        }\n      }\n    });\n  }\n}\n\n/**\n * Whether `node` belongs to `gridElement` — directly (light DOM) or via the\n * grid's shadow root (the node's root-node host is the grid). Used to scope\n * click-outside checks so one grid's listener never treats another grid's\n * toggle or panel as \"inside\" itself.\n */\nfunction isInGrid(node: Node, gridElement: Element): boolean {\n  if (gridElement.contains(node)) return true;\n  const root = node.getRootNode();\n  return root instanceof ShadowRoot && root.host === gridElement;\n}\n\n/**\n * Set up a click-outside listener that closes the tool panel when the user\n * clicks anywhere in the document outside the tool panel itself.\n *\n * Only active when `config.toolPanel.closeOnClickOutside` is `true` AND the\n * panel is open. The listener is added on `document` `mousedown` (not `click`)\n * so it fires before focus changes and catches clicks anywhere in the window —\n * including outside the grid. Uses `composedPath()` so clicks inside the\n * grid's shadow DOM are correctly attributed (shadow-retargeted `event.target`\n * would otherwise always be the host element).\n *\n * @returns A cleanup function that removes the listener.\n */\nexport function setupClickOutsideDismiss(\n  gridElement: Element,\n  config: ShellConfig | undefined,\n  state: ShellState,\n  onClose: () => void,\n): () => void {\n  const mode = config?.toolPanel?.mode;\n\n  // Dropdown popovers always light-dismiss on outside click (standard dropdown\n  // behavior), regardless of the `closeOnClickOutside` flag. Other modes only\n  // dismiss when the consumer opts in.\n  if (mode !== 'dropdown' && !config?.toolPanel?.closeOnClickOutside) {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  // In push mode the panel does not overlap grid content, so there is\n  // no meaningful \"outside\" to click against. Treat the option as a no-op.\n  if (mode === 'push') {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const handler = (e: Event) => {\n    if (!state.isPanelOpen) return;\n\n    // Ignore clicks inside the tool panel itself, on the toggle button, or on\n    // the dropdown's resolved anchor element (so a consumer's BYO trigger can\n    // toggle without the outside-click handler racing the button's own click).\n    // composedPath() pierces shadow boundaries so this works for both the\n    // light-DOM toggle and the shadow-DOM panel.\n    //\n    // CRITICAL: the panel/toggle match MUST be scoped to THIS grid via\n    // `isInGrid`. With multiple grids on one page, a click on another grid's\n    // toggle/panel is an \"outside\" click for us and must still dismiss \\u2014\n    // otherwise opening a dropdown in grid B leaves grid A's dropdown stuck\n    // open (#375 follow-up).\n    const anchorEl = state.dropdownAnchorEl;\n    for (const node of e.composedPath()) {\n      if (anchorEl != null && node === anchorEl) return;\n      if (\n        node instanceof Element &&\n        (node.classList?.contains('tbw-tool-panel') || node.matches?.('[data-panel-toggle]')) &&\n        isInGrid(node, gridElement)\n      ) {\n        return;\n      }\n    }\n\n    onClose();\n  };\n\n  document.addEventListener('mousedown', handler);\n  return () => document.removeEventListener('mousedown', handler);\n}\n\n/**\n * Set up an Escape-key listener that closes an open overlay tool panel.\n *\n * Active only in `overlay` mode (a push panel is a persistent sidebar, not a\n * transient overlay, so Esc does not dismiss it — the in-panel close button is\n * the affordance there). Yields to more specific handlers: if another listener\n * already called `preventDefault()` on the keydown (e.g. an active cell editor\n * cancelling an edit), the panel is left open.\n *\n * @returns A cleanup function that removes the listener.\n */\nexport function setupEscapeDismiss(\n  config: ShellConfig | undefined,\n  state: ShellState,\n  onClose: () => void,\n): () => void {\n  // Push panels are persistent — Esc only dismisses overlay panels.\n  if (config?.toolPanel?.mode === 'push') {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const handler = (e: KeyboardEvent) => {\n    if (e.key !== 'Escape' || e.defaultPrevented) return;\n    if (!state.isPanelOpen) return;\n    onClose();\n  };\n\n  document.addEventListener('keydown', handler);\n  return () => document.removeEventListener('keydown', handler);\n}\n\n/**\n * Set up resize handle for tool panel.\n * Returns a cleanup function to remove event listeners.\n *\n * The handle is draggable **and** tappable: pressing and releasing without\n * moving opens a click-only size menu (WCAG 2.2 SC 2.5.7).\n */\nexport function setupToolPanelResize(\n  renderRoot: Element,\n  config: ShellConfig | undefined,\n  onResize: (width: number) => void,\n): () => void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as HTMLElement | null;\n  const handle = renderRoot.querySelector('[data-resize-handle]') as HTMLElement | null;\n  const shellBody = renderRoot.querySelector('.tbw-shell-body') as HTMLElement | null;\n  if (!panel || !handle || !shellBody) {\n    // eslint-disable-next-line @typescript-eslint/no-empty-function\n    return () => {};\n  }\n\n  const position = config?.toolPanel?.position ?? 'right';\n  const minWidth = 200;\n\n  let startX = 0;\n  let startWidth = 0;\n  let maxWidth = 0;\n  let isResizing = false;\n  let moved = false;\n  let cancelDrag: (() => void) | null = null;\n  let sizePopover: SizePopover<HTMLElement> | null = null;\n\n  const availableMax = () => shellBody.getBoundingClientRect().width - 20;\n\n  const openSizePopover = () => {\n    sizePopover ??= createSizePopover<HTMLElement>({\n      id: 'tbw-tool-panel-width-popover',\n      step: RESIZE_STEP_PX,\n      getSize: (el) => el.getBoundingClientRect().width,\n      // Same clamp as `onMove`, so no pointer path can reach a size the drag cannot.\n      setSize: (el, width) => {\n        const clamped = Math.min(availableMax(), Math.max(minWidth, width));\n        el.style.width = `${clamped}px`;\n        onResize(clamped);\n      },\n      reset: (el) => {\n        el.style.width = '';\n        onResize(el.getBoundingClientRect().width);\n      },\n      getLabel: () => 'Tool panel width',\n      getHost: (el) => el.closest<HTMLElement>('tbw-grid, [data-tbw-grid]'),\n    });\n    sizePopover.open(panel, handle);\n  };\n\n  const onMove = (e: PointerEvent) => {\n    if (!isResizing) return;\n    e.preventDefault();\n    moved = true;\n\n    // For right-positioned panel: dragging left (negative clientX change) should expand\n    // For left-positioned panel: dragging right (positive clientX change) should expand\n    const delta = position === 'left' ? e.clientX - startX : startX - e.clientX;\n    const newWidth = Math.min(maxWidth, Math.max(minWidth, startWidth + delta));\n\n    panel.style.width = `${newWidth}px`;\n  };\n\n  /**\n   * Restore chrome after a drag. `commit` is false when the drag was aborted\n   * (pointercancel / Escape), in which case the caller has already restored the\n   * original width and no `onResize` notification should fire.\n   */\n  const finish = (commit: boolean) => {\n    if (!isResizing) return;\n    isResizing = false;\n    cancelDrag = null;\n    handle.classList.remove('resizing');\n    panel.style.transition = ''; // Re-enable transition\n    document.body.style.cursor = '';\n    document.body.style.userSelect = '';\n\n    if (commit) {\n      // Get final width and notify\n      const finalWidth = panel.getBoundingClientRect().width;\n      onResize(finalWidth);\n    }\n  };\n\n  const onPointerDown = (e: PointerEvent) => {\n    if (isResizing) return;\n    // Only the primary mouse button starts a splitter drag — a right-click must\n    // keep its context menu rather than being preventDefault()-ed away.\n    if (e.button !== 0 && e.pointerType === 'mouse') return;\n    e.preventDefault();\n    isResizing = true;\n    moved = false;\n    startX = e.clientX;\n    startWidth = panel.getBoundingClientRect().width;\n    // Calculate max width dynamically based on grid container width\n    maxWidth = availableMax(); // Leave 20px margin\n    handle.classList.add('resizing');\n    panel.style.transition = 'none'; // Disable transition for smooth resize\n    document.body.style.cursor = 'col-resize';\n    document.body.style.userSelect = 'none';\n\n    cancelDrag = startPointerDrag(e, handle, {\n      onMove,\n      onEnd: () => {\n        // `startPointerDrag` promotes immediately, so tap-vs-drag can only be\n        // told apart by whether `onMove` ever ran.\n        const wasTap = !moved;\n        finish(!wasTap);\n        if (wasTap) openSizePopover();\n      },\n      onCancel: () => {\n        // Aborted (pointercancel / Escape) — snap back to the pre-drag width.\n        panel.style.width = `${startWidth}px`;\n        finish(false);\n      },\n    });\n  };\n\n  handle.addEventListener('pointerdown', onPointerDown);\n\n  // Return cleanup function\n  return () => {\n    handle.removeEventListener('pointerdown', onPointerDown);\n    cancelDrag?.();\n    cancelDrag = null;\n    sizePopover?.dispose();\n    sizePopover = null;\n  };\n}\n// #endregion\n\n// #region Content Rendering\n/**\n * Render toolbar content (render functions) into toolbar slots.\n * All contents (config + API + light DOM) are now unified.\n */\nexport function renderCustomToolbarContents(\n  renderRoot: Element,\n  config: ShellConfig | undefined,\n  state: ShellState,\n): void {\n  // Merge config contents with state contents (same logic as renderShellHeader)\n  const configContents = config?.header?.toolbarContents ?? [];\n  const stateContents = [...state.toolbarContents.values()];\n  const configIds = new Set(configContents.map((c) => c.id));\n  const allContents = [...configContents];\n  for (const content of stateContents) {\n    if (!configIds.has(content.id)) {\n      allContents.push(content);\n    }\n  }\n\n  // Only process contents that need rendering (have render and cleanup not already set)\n  for (const content of allContents) {\n    // Skip if already rendered (cleanup exists)\n    if (state.toolbarContentCleanups.has(content.id)) continue;\n    if (!content.render) continue;\n\n    const slot = renderRoot.querySelector(`[data-toolbar-content=\"${content.id}\"]`);\n    if (!slot) continue;\n\n    const cleanup = content.render(slot as HTMLElement);\n    if (cleanup) {\n      state.toolbarContentCleanups.set(content.id, cleanup);\n    }\n  }\n}\n\n/**\n * Render header content from plugins into the shell content area.\n * Also moves light DOM header content to the placeholder (once).\n */\nexport function renderHeaderContent(renderRoot: Element, state: ShellState): void {\n  // Early exit if nothing to do (most common path after initial render)\n  const hasLightDomContent = state.lightDomHeaderContent.length > 0 && !state.lightDomContentMoved;\n  const hasPluginContent = state.headerContents.size > 0;\n  if (!hasLightDomContent && !hasPluginContent) return;\n\n  const contentArea = renderRoot.querySelector('.tbw-shell-content');\n  if (!contentArea) return;\n\n  // Move light DOM header content to placeholder - only once (perf optimization)\n  if (hasLightDomContent) {\n    for (const el of state.lightDomHeaderContent) {\n      el.style.display = ''; // Show it (was hidden in the original container)\n      contentArea.appendChild(el);\n    }\n    state.lightDomContentMoved = true;\n  }\n\n  // Sort by order\n  const sortedContents = [...state.headerContents.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n\n  for (const content of sortedContents) {\n    // Clean up previous render if any\n    const existingCleanup = state.headerContentCleanups.get(content.id);\n    if (existingCleanup) {\n      existingCleanup();\n      state.headerContentCleanups.delete(content.id);\n    }\n\n    // Check if container already exists\n    let container = contentArea.querySelector(`[data-header-content=\"${content.id}\"]`) as HTMLElement | null;\n    if (!container) {\n      container = document.createElement('div');\n      container.setAttribute('data-header-content', content.id);\n      contentArea.appendChild(container);\n    }\n\n    const cleanup = content.render(container);\n    if (cleanup) {\n      state.headerContentCleanups.set(content.id, cleanup);\n    }\n  }\n}\n\n/**\n * Render content for expanded accordion sections.\n * @param icons - Optional icons for expand/collapse chevrons (from grid config)\n */\nexport function renderPanelContent(\n  renderRoot: Element,\n  state: ShellState,\n  _icons?: { expand?: IconValue; collapse?: IconValue },\n): void {\n  if (!state.isPanelOpen) return;\n\n  for (const [panelId, panel] of state.toolPanels) {\n    const isExpanded = state.expandedSections.has(panelId);\n    const section = renderRoot.querySelector(`[data-section=\"${panelId}\"]`);\n    const contentArea = section?.querySelector('.tbw-accordion-content') as HTMLElement | null;\n\n    if (!section || !contentArea) continue;\n\n    // Update expanded state\n    section.classList.toggle('expanded', isExpanded);\n    const header = section.querySelector('.tbw-accordion-header');\n    if (header) {\n      header.setAttribute('aria-expanded', String(isExpanded));\n    }\n    // Don't swap chevron icon — CSS rotation handles expanded/collapsed state\n\n    if (isExpanded) {\n      // Check if content is already rendered\n      if (contentArea.children.length === 0) {\n        // Render panel content\n        const cleanup = panel.render(contentArea);\n        if (cleanup) {\n          state.panelCleanups.set(panelId, cleanup);\n        }\n      }\n    } else {\n      // Clean up and clear content when collapsed\n      const cleanup = state.panelCleanups.get(panelId);\n      if (cleanup) {\n        cleanup();\n        state.panelCleanups.delete(panelId);\n      }\n      contentArea.innerHTML = '';\n    }\n  }\n}\n\n/**\n * Update toolbar button active states.\n */\nexport function updateToolbarActiveStates(renderRoot: Element, state: ShellState): void {\n  // Update single panel toggle button\n  const panelToggle = renderRoot.querySelector('[data-panel-toggle]');\n  if (panelToggle) {\n    panelToggle.classList.toggle('active', state.isPanelOpen);\n    panelToggle.setAttribute('aria-pressed', String(state.isPanelOpen));\n  }\n}\n\n/**\n * Update tool panel open/close state.\n */\nexport function updatePanelState(renderRoot: Element, state: ShellState): void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as HTMLElement | null;\n  if (!panel) return;\n\n  panel.classList.toggle('open', state.isPanelOpen);\n\n  // Clear inline width when closing (resize sets inline style that overrides CSS)\n  if (!state.isPanelOpen) {\n    panel.style.width = '';\n  }\n}\n\n/** Base CSS anchor name used to feature-detect CSS anchor positioning support. */\nconst DROPDOWN_ANCHOR_NAME = '--tbw-tool-panel-anchor';\n\n/**\n * Monotonic counter for minting unique per-grid dropdown anchor names. A shared\n * constant name collides when two grids on the same page each open a dropdown,\n * pairing one grid's popover with the other grid's trigger (#375 follow-up).\n */\nlet dropdownAnchorSeq = 0;\n\n/** Whether the current environment supports CSS anchor positioning. */\nexport function supportsAnchorPositioning(): boolean {\n  return (\n    typeof CSS !== 'undefined' &&\n    typeof CSS.supports === 'function' &&\n    CSS.supports('anchor-name', DROPDOWN_ANCHOR_NAME)\n  );\n}\n\n/**\n * Position the dropdown popover with fixed coordinates derived from the\n * anchor's bounding rect. Used only when CSS anchor positioning is\n * unsupported; otherwise placement is driven entirely by `shell.css`.\n */\nfunction positionDropdownFallback(panel: HTMLElement, anchorEl: HTMLElement, corner: boolean): void {\n  const rect = anchorEl.getBoundingClientRect();\n  const position = panel.getAttribute('data-position') ?? 'right';\n  panel.style.position = 'fixed';\n  // `corner` anchors to the top of the grid (top corner); otherwise drop below\n  // the trigger button.\n  panel.style.top = `${Math.round((corner ? rect.top : rect.bottom) + 4)}px`;\n  if (position === 'left') {\n    panel.style.left = `${Math.round(rect.left)}px`;\n    panel.style.right = 'auto';\n  } else {\n    const viewportWidth = typeof window !== 'undefined' ? window.innerWidth : 0;\n    panel.style.left = 'auto';\n    panel.style.right = `${Math.round(viewportWidth - rect.right)}px`;\n  }\n}\n\n/**\n * Show the tool panel as an anchored dropdown popover (`mode: 'dropdown'`).\n *\n * Reuses the existing `.tbw-tool-panel` aside (the full accordion) and shows it\n * in the top layer via the native Popover API. Placement is handled by CSS\n * anchor positioning when supported, with a JS bounding-rect fallback otherwise.\n *\n * @param anchorEl - Element the popover anchors to.\n * @param corner - When `true`, anchor to the top corner of `anchorEl` (grid\n *   corner fallback); otherwise drop directly below it (toggle / custom button).\n */\nexport function showToolPanelDropdown(\n  renderRoot: Element,\n  state: ShellState,\n  anchorEl: HTMLElement,\n  corner: boolean,\n): void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as (HTMLElement & { showPopover?: () => void }) | null;\n  if (!panel) return;\n\n  state.dropdownAnchorEl = anchorEl;\n  panel.dataset.anchor = corner ? 'corner' : 'below';\n\n  // Show in the top layer. Guard for environments (older browsers / test DOM)\n  // without the native Popover API.\n  if (panel.hasAttribute('popover') && typeof panel.showPopover === 'function') {\n    try {\n      panel.showPopover();\n    } catch {\n      // Already open or not connected — ignore.\n    }\n  }\n\n  if (supportsAnchorPositioning()) {\n    // CSS drives placement; just wire up the anchor-name pairing. Mint a unique\n    // name per show so multiple grids (or repeated opens) on one page never\n    // collide on a shared anchor name — a collision positions this popover\n    // against another grid's trigger instead of its own.\n    const anchorName = `${DROPDOWN_ANCHOR_NAME}-${++dropdownAnchorSeq}`;\n    state.dropdownAnchorName = anchorName;\n    anchorEl.style.setProperty('anchor-name', anchorName);\n    panel.style.setProperty('position-anchor', anchorName);\n    panel.style.removeProperty('top');\n    panel.style.removeProperty('left');\n    panel.style.removeProperty('right');\n  } else {\n    positionDropdownFallback(panel, anchorEl, corner);\n  }\n}\n\n/**\n * Hide the dropdown popover and clear all anchor wiring set by\n * {@link showToolPanelDropdown}.\n */\nexport function hideToolPanelDropdown(renderRoot: Element, state: ShellState): void {\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as (HTMLElement & { hidePopover?: () => void }) | null;\n  if (panel) {\n    if (panel.hasAttribute('popover') && typeof panel.hidePopover === 'function') {\n      try {\n        panel.hidePopover();\n      } catch {\n        // Not currently open — ignore.\n      }\n    }\n    panel.style.removeProperty('position-anchor');\n    panel.style.removeProperty('position');\n    panel.style.removeProperty('top');\n    panel.style.removeProperty('left');\n    panel.style.removeProperty('right');\n    delete panel.dataset.anchor;\n  }\n  if (state.dropdownAnchorEl) {\n    state.dropdownAnchorEl.style.removeProperty('anchor-name');\n    state.dropdownAnchorEl = null;\n  }\n  state.dropdownAnchorName = null;\n}\n\n/**\n * Re-pair an OPEN dropdown's existing anchor onto a freshly resolved trigger\n * IN PLACE — reusing the already-minted `anchor-name` and leaving the popover\n * shown — instead of hiding and re-showing it.\n *\n * WHY: when an outer framework (e.g. a React column `headerRenderer`) recreates\n * the `[data-panel-toggle]` trigger on a column toggle, the new node lacks the\n * `anchor-name`, so the popover's `position-anchor` no longer resolves and the\n * browser drops it to the corner. Hiding + re-showing (the heavier\n * {@link showToolPanelDropdown} path) mints a NEW name and re-enters the\n * Popover API, which flashes the popover to the corner for a frame. Moving the\n * SAME name to the new node keeps the popover visually anchored with no flash.\n *\n * Returns `true` when the re-pair was applied. The caller must ensure CSS\n * anchor positioning is supported (see {@link supportsAnchorPositioning});\n * otherwise the fixed-coordinate fallback in {@link showToolPanelDropdown} must\n * be used instead.\n */\nexport function repairDropdownAnchor(renderRoot: Element, state: ShellState, trigger: HTMLElement): boolean {\n  const anchorName = state.dropdownAnchorName;\n  if (!anchorName) return false;\n  const panel = renderRoot.querySelector('.tbw-tool-panel') as (HTMLElement & { showPopover?: () => void }) | null;\n  if (!panel) return false;\n  const prev = state.dropdownAnchorEl;\n  if (prev && prev !== trigger) prev.style.removeProperty('anchor-name');\n  trigger.style.setProperty('anchor-name', anchorName);\n  panel.style.setProperty('position-anchor', anchorName);\n  panel.style.removeProperty('top');\n  panel.style.removeProperty('left');\n  panel.style.removeProperty('right');\n  panel.dataset.anchor = 'below';\n  state.dropdownAnchorEl = trigger;\n  // A structural rebuild (`rebuildShellDOM`) creates a FRESH `.tbw-tool-panel`\n  // that is not in the top layer — only its `.open` class arm renders it, which\n  // can be clipped / mis-stacked. Re-assert the popover idempotently so both the\n  // non-structural path (panel already open → no-op via the catch) and the\n  // structural-rebuild path (fresh panel → shown) end up in the top layer.\n  if (panel.hasAttribute('popover') && typeof panel.showPopover === 'function') {\n    try {\n      panel.showPopover();\n    } catch {\n      // Already open or not connected — ignore.\n    }\n  }\n  return true;\n}\n\n/**\n * Prepare shell state for a full re-render.\n * Runs cleanup functions so content (toolbar buttons, panels, headers)\n * can be restored to their original containers and re-rendered into new DOM.\n */\nexport function prepareForRerender(state: ShellState): void {\n  // Run cleanups for toolbar contents (moves elements back to original containers)\n  for (const cleanup of state.toolbarContentCleanups.values()) {\n    cleanup();\n  }\n  state.toolbarContentCleanups.clear();\n\n  // Run cleanups for panel contents (old DOM will be destroyed)\n  for (const cleanup of state.panelCleanups.values()) {\n    cleanup();\n  }\n  state.panelCleanups.clear();\n\n  // Run cleanups for header contents (old DOM will be destroyed)\n  for (const cleanup of state.headerContentCleanups.values()) {\n    cleanup();\n  }\n  state.headerContentCleanups.clear();\n\n  // Allow light DOM content to be re-moved into new DOM\n  state.lightDomContentMoved = false;\n}\n\n/**\n * Cleanup all shell state when grid disconnects.\n */\nexport function cleanupShellState(state: ShellState): void {\n  // Clean up header content\n  for (const cleanup of state.headerContentCleanups.values()) {\n    cleanup();\n  }\n  state.headerContentCleanups.clear();\n\n  // Clean up panel content\n  for (const cleanup of state.panelCleanups.values()) {\n    cleanup();\n  }\n  state.panelCleanups.clear();\n\n  // Clean up toolbar contents\n  for (const cleanup of state.toolbarContentCleanups.values()) {\n    cleanup();\n  }\n  state.toolbarContentCleanups.clear();\n\n  // Call onDestroy for all toolbar contents\n  for (const content of state.toolbarContents.values()) {\n    content.onDestroy?.();\n  }\n\n  // Invoke onClose for all open panels\n  if (state.isPanelOpen) {\n    for (const sectionId of state.expandedSections) {\n      const panel = state.toolPanels.get(sectionId);\n      panel?.onClose?.();\n    }\n  }\n\n  // Reset panel state\n  state.isPanelOpen = false;\n  state.expandedSections.clear();\n\n  // Clear registrations\n  state.toolPanels.clear();\n  state.headerContents.clear();\n  state.toolbarContents.clear();\n  state.lightDomHeaderContent = [];\n\n  // Clear light DOM tracking sets (allow re-parsing)\n  state.lightDomToolPanelIds.clear();\n  state.adapterBoundToolPanelIds.clear();\n  state.lightDomToolbarContentIds.clear();\n\n  // Reset move tracking flag (allow re-initialization)\n  state.lightDomContentMoved = false;\n}\n// #endregion\n\n// #region DOM Construction\nimport { GridClasses } from '../../core/constants';\nimport {\n  buildGridDOM,\n  buildShellBody,\n  buildShellHeader,\n  type ShellBodyOptions,\n  type ShellHeaderOptions,\n} from '../../core/internal/dom-builder';\n\n/**\n * Build ShellHeaderOptions and ShellBodyOptions from shell config and runtime state.\n * Shared by buildGridDOMIntoElement and rebuildShellDOM to avoid duplication.\n */\nfunction buildShellOptions(\n  shellConfig: ShellConfig,\n  runtimeState: { isPanelOpen: boolean; expandedSections: Set<string> },\n  icons?: { toolPanel?: IconValue; expand?: IconValue; collapse?: IconValue },\n): { headerOptions: ShellHeaderOptions; bodyOptions: ShellBodyOptions } {\n  const toolPanelIcon = icons?.toolPanel !== undefined ? iconToString(icons.toolPanel) : undefined;\n  const expandIcon = icons?.expand !== undefined ? iconToString(icons.expand) : undefined;\n  const collapseIcon = icons?.collapse !== undefined ? iconToString(icons.collapse) : undefined;\n\n  const allContents = shellConfig.header?.toolbarContents ?? [];\n  const sortedContents = [...allContents].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n\n  const allPanels = shellConfig.toolPanels ?? [];\n  const sortedPanels = [...allPanels].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n\n  return {\n    headerOptions: {\n      title: shellConfig.header?.title ?? undefined,\n      hasPanels: sortedPanels.length > 0,\n      isPanelOpen: runtimeState.isPanelOpen,\n      toolPanelIcon,\n      showToggle: shellConfig.header?.toolPanelToggle !== false && shellConfig.toolPanel?.locked !== true,\n      configButtons: sortedContents.map((c) => ({\n        id: c.id,\n        hasElement: false,\n        hasRender: !!c.render,\n      })),\n      apiButtons: [],\n    },\n    bodyOptions: {\n      position: shellConfig.toolPanel?.position ?? 'right',\n      mode: shellConfig.toolPanel?.mode ?? 'overlay',\n      isPanelOpen: runtimeState.isPanelOpen,\n      expandIcon,\n      collapseIcon,\n      // Render an in-panel close (✕) button when the header bar is hidden, so\n      // the panel can be dismissed without the (absent) built-in toggle. A\n      // locked panel cannot be closed, so no button in that case. Dropdown mode\n      // is excluded: the popover light-dismisses on Esc / click-outside, so a\n      // ✕ would be redundant clutter.\n      showCloseButton:\n        shellConfig.header?.visible === false &&\n        shellConfig.toolPanel?.locked !== true &&\n        (shellConfig.toolPanel?.mode ?? 'overlay') !== 'dropdown',\n      panels: sortedPanels.map((p) => ({\n        id: p.id,\n        title: p.title,\n        icon: iconToString(p.icon),\n        isExpanded: runtimeState.expandedSections.has(p.id),\n      })),\n    },\n  };\n}\n\n/**\n * Build the complete grid DOM structure using direct DOM construction.\n * This is 2-3x faster than innerHTML for initial render.\n *\n * @param renderRoot - The element to render into (will be cleared)\n * @param shellConfig - Shell configuration\n * @param runtimeState - Runtime shell state\n * @param icons - Optional icons\n * @returns Whether shell is active (for post-render setup)\n */\nexport function buildGridDOMIntoElement(\n  renderRoot: Element,\n  shellConfig: ShellConfig | undefined,\n  runtimeState: { isPanelOpen: boolean; expandedSections: Set<string> },\n  icons?: { toolPanel?: IconValue; expand?: IconValue; collapse?: IconValue },\n): boolean {\n  const hasShell = shouldRenderShellHeader(shellConfig);\n\n  // Preserve all direct child nodes EXCEPT the grid's own `.tbw-grid-root`\n  // (which we are about to rebuild). This keeps user/framework light-DOM\n  // intact in its original order — including non-element nodes like comment\n  // anchors that Angular's `@if`/`@for` and other structural directives use\n  // as positional markers. Filtering by element-tag selectors would discard\n  // those anchors and break re-renders of the conditional content.\n  const preservedNodes: Node[] = [];\n  for (let n: Node | null = renderRoot.firstChild; n; n = n.nextSibling) {\n    if (n.nodeType === 1 && (n as Element).classList.contains(GridClasses.ROOT)) continue;\n    preservedNodes.push(n);\n  }\n\n  // Clear existing content (this would delete light DOM nodes, so we preserved them first)\n  renderRoot.replaceChildren();\n\n  // Re-append preserved nodes in original order (hidden elements are used for config).\n  // IMPORTANT: These are prepended before .tbw-grid-root, so `renderRoot.children[0]`\n  // is NOT the grid root. Use `querySelector('.tbw-grid-root')` instead.\n  for (const n of preservedNodes) {\n    renderRoot.appendChild(n);\n  }\n\n  if (hasShell) {\n    const { headerOptions, bodyOptions } = buildShellOptions(shellConfig!, runtimeState, icons);\n    const shellHeader = shouldRenderHeaderBar(shellConfig) ? buildShellHeader(headerOptions) : undefined;\n    const shellBody = buildShellBody(bodyOptions);\n\n    const fragment = buildGridDOM({\n      hasShell: true,\n      shellHeader,\n      shellBody,\n    });\n    renderRoot.appendChild(fragment);\n  } else {\n    const fragment = buildGridDOM({ hasShell: false });\n    renderRoot.appendChild(fragment);\n  }\n\n  return hasShell;\n}\n\n/**\n * Surgically rebuild only the shell wrapper (header + tool panel) while\n * preserving the existing `.tbw-grid-root` element and its `.tbw-grid-content`\n * child with all descendants and event listeners intact.\n *\n * This avoids the full `replaceChildren()` nuke that `buildGridDOMIntoElement`\n * performs, so event listeners bound to `.tbw-grid-root` or its grid content\n * descendants (e.g. tooltip's delegated mouseover) remain intact.\n *\n * If no existing `.tbw-grid-root` is found (first render), falls back to\n * `buildGridDOMIntoElement` for a full rebuild.\n */\nexport function rebuildShellDOM(\n  renderRoot: Element,\n  shellConfig: ShellConfig | undefined,\n  runtimeState: { isPanelOpen: boolean; expandedSections: Set<string> },\n  icons?: { toolPanel?: IconValue; expand?: IconValue; collapse?: IconValue },\n): boolean {\n  // Find the existing grid root and content to preserve\n  const existingRoot = renderRoot.querySelector(`.${GridClasses.ROOT}`) as HTMLElement | null;\n  const existingContent = existingRoot?.querySelector('.tbw-grid-content');\n\n  // If there's no existing root, fall back to full rebuild (first render)\n  if (!existingRoot || !existingContent) {\n    return buildGridDOMIntoElement(renderRoot, shellConfig, runtimeState, icons);\n  }\n\n  // Detach grid content so it survives the child replacement\n  existingContent.remove();\n\n  const hasShell = shouldRenderShellHeader(shellConfig);\n\n  // Clear the root's children (shell header, shell body, etc.) but keep the root element itself\n  existingRoot.replaceChildren();\n\n  if (hasShell) {\n    existingRoot.className = `${GridClasses.ROOT} has-shell`;\n\n    const { headerOptions, bodyOptions } = buildShellOptions(shellConfig!, runtimeState, icons);\n    const shellHeader = shouldRenderHeaderBar(shellConfig) ? buildShellHeader(headerOptions) : undefined;\n    const shellBody = buildShellBody(bodyOptions);\n\n    // Replace the freshly cloned grid content with the preserved one\n    const freshContent = shellBody.querySelector('.tbw-grid-content');\n    if (freshContent) {\n      freshContent.replaceWith(existingContent);\n    }\n\n    if (shellHeader) existingRoot.appendChild(shellHeader);\n    existingRoot.appendChild(shellBody);\n  } else {\n    // No shell — place content directly in root\n    existingRoot.className = GridClasses.ROOT;\n    existingRoot.appendChild(existingContent);\n  }\n\n  return hasShell;\n}\n// #endregion\n","/**\n * Shell Controller - Tool panel and header content orchestration.\n *\n * Extracted from shell.ts to isolate the stateful controller logic\n * from the rendering/parsing infrastructure.\n *\n * The ShellController manages:\n * - Tool panel open/close/toggle state\n * - Accordion section expand/collapse\n * - Registration of tool panels, header content, and toolbar content\n */\n\nimport {\n  HEADER_CONTENT_DUPLICATE,\n  NO_TOOL_PANELS,\n  TOOL_PANEL_DUPLICATE,\n  TOOL_PANEL_NOT_FOUND,\n  TOOLBAR_CONTENT_DUPLICATE,\n  warnDiagnostic,\n} from '../../core/internal/diagnostics';\nimport type { GridElement } from '../../core/plugin/base-plugin';\nimport type { InternalGrid } from '../../core/types';\nimport {\n  hideToolPanelDropdown,\n  renderHeaderContent,\n  renderPanelContent,\n  repairDropdownAnchor,\n  showToolPanelDropdown,\n  supportsAnchorPositioning,\n  updatePanelState,\n  updateToolbarActiveStates,\n  type ShellState,\n} from './shell';\nimport type {\n  HeaderContentDefinition,\n  OpenToolPanelOptions,\n  ToolbarContentDefinition,\n  ToolPanelDefinition,\n} from './types';\n\n// #region ShellController\n/**\n * Controller interface for managing shell/tool panel behavior.\n */\nexport interface ShellController {\n  /** Whether the shell has been initialized */\n  readonly isInitialized: boolean;\n  /** Set the initialized state */\n  setInitialized(value: boolean): void;\n  /** Whether the tool panel is currently open */\n  readonly isPanelOpen: boolean;\n  /** Get IDs of expanded accordion sections */\n  readonly expandedSections: string[];\n  /**\n   * Open the tool panel.\n   * @param panelId - Optional ID of the section to expand on open. When provided,\n   *   takes precedence over `shell.toolPanel.defaultOpen`. If the panel is already\n   *   open with a different section expanded, switches to the requested section.\n   *   If the panel ID is not registered, a `TBW072` warning is emitted and the\n   *   call falls back to default behavior (auto-expand `defaultOpen` or first by order).\n   * @param options - Optional open options. In `mode: 'dropdown'`, `options.anchor`\n   *   sets the element the popover anchors to (see {@link OpenToolPanelOptions}).\n   */\n  openToolPanel(panelId?: string, options?: OpenToolPanelOptions): void;\n  /** Close the tool panel */\n  closeToolPanel(): void;\n  /**\n   * Toggle the tool panel.\n   * @param options - Optional open options forwarded to {@link openToolPanel}\n   *   when the panel is currently closed (e.g. `anchor` for dropdown mode).\n   */\n  toggleToolPanel(options?: OpenToolPanelOptions): void;\n  /**\n   * Re-pair an open dropdown popover onto its (possibly recreated) trigger\n   * after a re-render (`mode: 'dropdown'` only). A column toggle / reorder may\n   * recreate the custom column-header button the popover was anchored to,\n   * leaving the popover's `position-anchor` dangling so the browser drops it to\n   * the corner.\n   *\n   * Behaviour:\n   * - intact pairing → no-op (cheap fast-path, safe to call every render);\n   * - a live `[data-panel-toggle]` exists → re-pair the existing anchor onto it\n   *   IN PLACE (no popover re-show → no flash), or a fixed-coord re-show when\n   *   CSS anchor positioning is unavailable;\n   * - corner-origin dropdown with no trigger → keep it pinned to the corner;\n   * - trigger-origin dropdown whose trigger is transiently absent → leave the\n   *   popover at its last position (the shell's MutationObserver re-pairs it\n   *   before paint once the trigger reappears), rather than flashing to corner.\n   *\n   * No-op when the panel is closed or the mode is not `'dropdown'`.\n   */\n  reanchorOpenDropdown(): void;\n  /** Toggle an accordion section */\n  toggleToolPanelSection(sectionId: string): void;\n  /** Get registered tool panels */\n  getToolPanels(): ToolPanelDefinition[];\n  /** Register a tool panel */\n  registerToolPanel(panel: ToolPanelDefinition): void;\n  /** Unregister a tool panel */\n  unregisterToolPanel(panelId: string): void;\n  /** Get registered header contents */\n  getHeaderContents(): HeaderContentDefinition[];\n  /** Register header content */\n  registerHeaderContent(content: HeaderContentDefinition): void;\n  /** Unregister header content */\n  unregisterHeaderContent(contentId: string): void;\n  /** Get all registered toolbar contents */\n  getToolbarContents(): ToolbarContentDefinition[];\n  /** Register toolbar content */\n  registerToolbarContent(content: ToolbarContentDefinition): void;\n  /** Unregister toolbar content */\n  unregisterToolbarContent(contentId: string): void;\n}\n\n/**\n * The slice of the grid the shell controller needs: the plugin-facing\n * {@link GridElement} surface plus a few internal seams (`id`, `_emit`,\n * `_accordionIcons`, optional `refreshShellHeader`). Declaring it as\n * `GridElement & Pick<InternalGrid, …>` lets the {@link ShellPlugin} pass its\n * `GridElement`-typed `grid` with a plain downcast — no `as unknown as` — while\n * keeping core free of any shell-specific grid surface (extraction #370).\n */\nexport type ShellControllerGrid = GridElement &\n  Pick<InternalGrid, 'id' | '_emit' | '_accordionIcons' | 'refreshShellHeader'>;\n\n/**\n * Create a ShellController instance.\n * The controller encapsulates all tool panel orchestration logic.\n */\nexport function createShellController(state: ShellState, grid: ShellControllerGrid): ShellController {\n  let initialized = false;\n\n  /**\n   * Resolve the element a dropdown popover should anchor to. Priority:\n   * explicit `anchor` option → built-in toolbar toggle button → grid host\n   * corner fallback.\n   */\n  function resolveDropdownAnchor(explicit?: HTMLElement): { el: HTMLElement; corner: boolean } {\n    if (explicit) return { el: explicit, corner: false };\n    const toggle = grid._renderRoot.querySelector('[data-panel-toggle]') as HTMLElement | null;\n    if (toggle) return { el: toggle, corner: false };\n    return { el: grid._hostElement, corner: true };\n  }\n\n  const controller: ShellController = {\n    get isInitialized() {\n      return initialized;\n    },\n    setInitialized(value: boolean) {\n      initialized = value;\n    },\n\n    get isPanelOpen() {\n      return state.isPanelOpen;\n    },\n\n    get expandedSections() {\n      return [...state.expandedSections];\n    },\n\n    openToolPanel(panelId?: string, options?: OpenToolPanelOptions) {\n      if (state.toolPanels.size === 0) {\n        warnDiagnostic(NO_TOOL_PANELS, 'No tool panels registered', grid.id);\n        return;\n      }\n\n      // Validate explicit panelId; on unknown id, warn and fall back to default behavior.\n      let targetSectionId: string | undefined;\n      if (panelId !== undefined) {\n        if (state.toolPanels.has(panelId)) {\n          targetSectionId = panelId;\n        } else {\n          warnDiagnostic(TOOL_PANEL_NOT_FOUND, `Tool panel \"${panelId}\" not found`, grid.id);\n        }\n      }\n\n      // Fast path: panel already open and requested section already expanded → no-op.\n      if (state.isPanelOpen && targetSectionId && state.expandedSections.has(targetSectionId)) {\n        return;\n      }\n\n      // Panel already open but a different section is expanded → switch sections\n      // (delegate to toggleToolPanelSection for accordion exclusivity + event emission).\n      if (state.isPanelOpen && targetSectionId && !state.expandedSections.has(targetSectionId)) {\n        controller.toggleToolPanelSection(targetSectionId);\n        return;\n      }\n\n      if (state.isPanelOpen) return;\n\n      state.isPanelOpen = true;\n\n      // Decide initial expanded section:\n      // 1. Explicit panelId argument (already validated above).\n      // 2. shell.toolPanel.defaultOpen if it matches a registered panel.\n      // 3. First panel by `order`.\n      if (state.expandedSections.size === 0 && state.toolPanels.size > 0) {\n        if (targetSectionId) {\n          state.expandedSections.add(targetSectionId);\n        } else {\n          const defaultOpenId = grid.effectiveConfig?.shell?.toolPanel?.defaultOpen;\n          if (defaultOpenId && state.toolPanels.has(defaultOpenId)) {\n            state.expandedSections.add(defaultOpenId);\n          } else {\n            const sortedPanels = [...state.toolPanels.values()].sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n            const firstPanel = sortedPanels[0];\n            if (firstPanel) {\n              state.expandedSections.add(firstPanel.id);\n            }\n          }\n        }\n      } else if (targetSectionId && !state.expandedSections.has(targetSectionId)) {\n        // Some other section was already pre-expanded (e.g. via config); switch to requested.\n        for (const id of [...state.expandedSections]) {\n          state.expandedSections.delete(id);\n        }\n        state.expandedSections.add(targetSectionId);\n      }\n\n      // Update UI\n      const shadow = grid._renderRoot;\n      updateToolbarActiveStates(shadow, state);\n      updatePanelState(shadow, state);\n\n      // Render accordion sections\n      renderPanelContent(shadow, state, grid._accordionIcons);\n\n      // In dropdown mode, show the panel as an anchored popover in the top layer.\n      if (grid.effectiveConfig?.shell?.toolPanel?.mode === 'dropdown') {\n        const { el, corner } = resolveDropdownAnchor(options?.anchor);\n        showToolPanelDropdown(shadow, state, el, corner);\n      }\n\n      // Emit event\n      grid._emit('tool-panel-open', { sections: controller.expandedSections });\n    },\n\n    closeToolPanel() {\n      if (!state.isPanelOpen) return;\n      // When the tool panel is locked open, programmatic and user close\n      // requests become no-ops. Accordion sections can still toggle.\n      if (grid.effectiveConfig?.shell?.toolPanel?.locked) return;\n\n      // Clean up all panel content\n      for (const cleanup of state.panelCleanups.values()) {\n        cleanup();\n      }\n      state.panelCleanups.clear();\n\n      // Call onClose for all panels\n      for (const panel of state.toolPanels.values()) {\n        panel.onClose?.();\n      }\n\n      state.isPanelOpen = false;\n\n      // Update UI\n      const shadow = grid._renderRoot;\n      updateToolbarActiveStates(shadow, state);\n      updatePanelState(shadow, state);\n\n      // In dropdown mode, hide the popover and clear anchor wiring.\n      if (grid.effectiveConfig?.shell?.toolPanel?.mode === 'dropdown') {\n        hideToolPanelDropdown(shadow, state);\n      }\n\n      // Emit event\n      grid._emit('tool-panel-close', {});\n    },\n\n    toggleToolPanel(options?: OpenToolPanelOptions) {\n      if (state.isPanelOpen) {\n        controller.closeToolPanel();\n      } else {\n        controller.openToolPanel(undefined, options);\n      }\n    },\n\n    reanchorOpenDropdown() {\n      if (!state.isPanelOpen) return;\n      if (grid.effectiveConfig?.shell?.toolPanel?.mode !== 'dropdown') return;\n      const stored = state.dropdownAnchorEl;\n      // Idempotent fast-path: the anchor element is still connected AND still\n      // carries the minted `anchor-name`, so the pairing is intact — nothing to\n      // do. This keeps the hook cheap when it runs on the `afterRender` path\n      // (which fires on every render, e.g. a column toggle), only doing real\n      // work when the trigger was actually recreated/detached.\n      if (\n        stored &&\n        stored.isConnected &&\n        state.dropdownAnchorName &&\n        stored.style.getPropertyValue('anchor-name') === state.dropdownAnchorName\n      ) {\n        return;\n      }\n      // Idempotent fast-path (fixed-coordinate fallback mode — CSS anchor\n      // positioning unsupported, so `dropdownAnchorName` is never minted). Here\n      // re-anchoring means a `getBoundingClientRect()` + re-show on every\n      // render/mutation, which is wasteful when nothing was recreated. Skip when\n      // the stored trigger is still the SAME connected node (not the corner\n      // anchor) AND the CURRENT panel was already positioned (`data-anchor` set).\n      // A structural rebuild produces a FRESH `.tbw-tool-panel` with no\n      // `data-anchor`, so this never short-circuits the case that still needs a\n      // re-show.\n      if (!state.dropdownAnchorName && stored && stored.isConnected && stored !== grid._hostElement) {\n        const panel = grid._renderRoot.querySelector('.tbw-tool-panel') as HTMLElement | null;\n        if (panel?.dataset.anchor === 'below') return;\n      }\n      // Re-pair to a LIVE custom trigger (`[data-panel-toggle]`) whenever one\n      // exists. Prefer the cheap in-place repair: it reuses the already-minted\n      // `anchor-name`, keeps the popover shown, and never re-enters the Popover\n      // API — so the popover stays visually anchored with NO flash. Falls back\n      // to a fixed-coordinate re-show only when CSS anchor positioning is\n      // unavailable.\n      const fresh = grid._renderRoot.querySelector('[data-panel-toggle]') as HTMLElement | null;\n      if (fresh && fresh !== grid._hostElement) {\n        if (\n          state.dropdownAnchorName &&\n          supportsAnchorPositioning() &&\n          repairDropdownAnchor(grid._renderRoot, state, fresh)\n        ) {\n          return;\n        }\n        showToolPanelDropdown(grid._renderRoot, state, fresh, false);\n        return;\n      }\n      // No live trigger.\n      if (stored === grid._hostElement) {\n        // Corner-origin dropdown (opened without a custom trigger): keep it\n        // pinned to the grid corner across re-renders.\n        showToolPanelDropdown(grid._renderRoot, state, grid._hostElement, true);\n        return;\n      }\n      // Trigger-origin dropdown whose trigger is transiently absent (an outer\n      // framework, e.g. React, recreates it on a separate commit) — or was\n      // permanently removed. Do NOT flash the popover to the corner: leave it\n      // at its last position. When the trigger reappears, the shell's\n      // MutationObserver re-pairs it before paint (see ShellPlugin).\n    },\n\n    toggleToolPanelSection(sectionId: string) {\n      const panel = state.toolPanels.get(sectionId);\n      if (!panel) {\n        warnDiagnostic(TOOL_PANEL_NOT_FOUND, `Tool panel section \"${sectionId}\" not found`, grid.id);\n        return;\n      }\n\n      // Don't allow toggling when there's only one panel (it should stay expanded)\n      if (state.toolPanels.size === 1) {\n        return;\n      }\n\n      const shadow = grid._renderRoot;\n      const isExpanded = state.expandedSections.has(sectionId);\n\n      if (isExpanded) {\n        // Collapsing current section\n        const cleanup = state.panelCleanups.get(sectionId);\n        if (cleanup) {\n          cleanup();\n          state.panelCleanups.delete(sectionId);\n        }\n        panel.onClose?.();\n        state.expandedSections.delete(sectionId);\n        updateAccordionSectionState(shadow, sectionId, false);\n      } else {\n        // Expanding - first collapse all others (exclusive accordion)\n        for (const [otherId, otherPanel] of state.toolPanels) {\n          if (otherId !== sectionId && state.expandedSections.has(otherId)) {\n            const cleanup = state.panelCleanups.get(otherId);\n            if (cleanup) {\n              cleanup();\n              state.panelCleanups.delete(otherId);\n            }\n            otherPanel.onClose?.();\n            state.expandedSections.delete(otherId);\n            updateAccordionSectionState(shadow, otherId, false);\n            // Clear content of collapsed section\n            const contentEl = shadow.querySelector(`[data-section=\"${otherId}\"] .tbw-accordion-content`);\n            if (contentEl) contentEl.innerHTML = '';\n          }\n        }\n        // Now expand the target section\n        state.expandedSections.add(sectionId);\n        updateAccordionSectionState(shadow, sectionId, true);\n        renderAccordionSectionContent(shadow, state, sectionId);\n      }\n\n      // Emit event\n      grid._emit('tool-panel-section-toggle', { id: sectionId, expanded: !isExpanded });\n    },\n\n    getToolPanels() {\n      return [...state.toolPanels.values()];\n    },\n\n    registerToolPanel(panel: ToolPanelDefinition) {\n      if (state.toolPanels.has(panel.id)) {\n        warnDiagnostic(TOOL_PANEL_DUPLICATE, `Tool panel \"${panel.id}\" already registered`, grid.id);\n        return;\n      }\n      state.toolPanels.set(panel.id, panel);\n\n      // Refresh when already rendered, OR bootstrap the chrome when the shell is\n      // connected but has not rendered yet (an opt-in `features: { shell: true }`\n      // shell with no other content renders no chrome — registering the first\n      // tool panel must build it). `refreshShellHeader` self-guards on\n      // `isConnected` and batches, so a pre-connect call is a harmless no-op.\n      if (initialized || grid._hostElement.isConnected) {\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    unregisterToolPanel(panelId: string) {\n      // Close panel if open and this section is expanded\n      if (state.expandedSections.has(panelId)) {\n        const cleanup = state.panelCleanups.get(panelId);\n        if (cleanup) {\n          cleanup();\n          state.panelCleanups.delete(panelId);\n        }\n        state.expandedSections.delete(panelId);\n      }\n\n      state.toolPanels.delete(panelId);\n\n      if (initialized || grid._hostElement.isConnected) {\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    getHeaderContents() {\n      return [...state.headerContents.values()];\n    },\n\n    registerHeaderContent(content: HeaderContentDefinition) {\n      if (state.headerContents.has(content.id)) {\n        warnDiagnostic(HEADER_CONTENT_DUPLICATE, `Header content \"${content.id}\" already registered`, grid.id);\n        return;\n      }\n      state.headerContents.set(content.id, content);\n\n      if (initialized) {\n        renderHeaderContent(grid._renderRoot, state);\n      } else if (grid._hostElement.isConnected) {\n        // Connected opt-in shell with no chrome yet — bootstrap it so the header\n        // content has a `.tbw-shell-header` to render into.\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    unregisterHeaderContent(contentId: string) {\n      // Clean up\n      const cleanup = state.headerContentCleanups.get(contentId);\n      if (cleanup) {\n        cleanup();\n        state.headerContentCleanups.delete(contentId);\n      }\n\n      // Call onDestroy\n      const content = state.headerContents.get(contentId);\n      content?.onDestroy?.();\n\n      state.headerContents.delete(contentId);\n\n      // Remove DOM element\n      const el = grid._renderRoot.querySelector(`[data-header-content=\"${contentId}\"]`);\n      el?.remove();\n    },\n\n    getToolbarContents() {\n      return [...state.toolbarContents.values()].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n    },\n\n    registerToolbarContent(content: ToolbarContentDefinition) {\n      if (state.toolbarContents.has(content.id)) {\n        warnDiagnostic(TOOLBAR_CONTENT_DUPLICATE, `Toolbar content \"${content.id}\" already registered`, grid.id);\n        return;\n      }\n      state.toolbarContents.set(content.id, content);\n\n      if (initialized || grid._hostElement.isConnected) {\n        grid.refreshShellHeader?.();\n      }\n    },\n\n    unregisterToolbarContent(contentId: string) {\n      // Clean up\n      const cleanup = state.toolbarContentCleanups.get(contentId);\n      if (cleanup) {\n        cleanup();\n        state.toolbarContentCleanups.delete(contentId);\n      }\n\n      // Call onDestroy if defined\n      const content = state.toolbarContents.get(contentId);\n      if (content?.onDestroy) {\n        content.onDestroy();\n      }\n\n      state.toolbarContents.delete(contentId);\n\n      if (initialized) {\n        grid.refreshShellHeader?.();\n      }\n    },\n  };\n\n  return controller;\n}\n\n/**\n * Update accordion section visual state.\n */\nfunction updateAccordionSectionState(renderRoot: Element, sectionId: string, expanded: boolean): void {\n  const section = renderRoot.querySelector(`[data-section=\"${sectionId}\"]`);\n  if (section) {\n    section.classList.toggle('expanded', expanded);\n  }\n}\n\n/**\n * Render content for a single accordion section.\n */\nfunction renderAccordionSectionContent(renderRoot: Element, state: ShellState, sectionId: string): void {\n  const panel = state.toolPanels.get(sectionId);\n  if (!panel?.render) return;\n\n  const contentEl = renderRoot.querySelector(`[data-section=\"${sectionId}\"] .tbw-accordion-content`);\n  if (!contentEl) return;\n\n  const cleanup = panel.render(contentEl as HTMLElement);\n  if (cleanup) {\n    state.panelCleanups.set(sectionId, cleanup);\n  }\n}\n// #endregion\n","/**\n * Shell Plugin Styles\n *\n * Merged from the former core partials `core/styles/shell.css` +\n * `core/styles/tool-panel.css` (extraction #370). Near-verbatim concatenation —\n * cascade layer (`@layer tbw-base`) preserved so behavior is byte-identical\n * while both copies coexist during Phase 1a. Core copies are removed in\n * Task 1b.1.5; the layer question (tbw-base vs tbw-plugins) is revisited then.\n *\n * EXCEPTION: `.tbw-scroll-area` and `.tbw-grid-content` are NOT here — both are\n * core scroll-viewport layout (rendered by dom-builder for every grid, shell or\n * not) and live in `core/styles/base.css`. Without a shell, `.tbw-grid-content`\n * still wraps the scroll area, so its layout rule must load unconditionally.\n *\n * @layer tbw-base\n */\n\n/* ==========================================================================\n * Shell Layout (was core/styles/shell.css)\n *\n * Styles for the grid shell including header, toolbar, content area,\n * and scroll container.\n * ========================================================================== */\n\n@layer tbw-base {\n  tbw-grid {\n    .tbw-shell-header {\n      display: flex;\n      align-items: center;\n      gap: 8px;\n      min-height: var(--tbw-shell-header-height);\n      padding: 0 8px;\n      background: var(--tbw-shell-header-bg);\n      border-bottom: 1px solid var(--tbw-shell-header-border);\n      flex-shrink: 0;\n    }\n\n    .tbw-shell-title {\n      font-size: var(--tbw-shell-title-font-size);\n      font-weight: var(--tbw-shell-title-font-weight);\n      white-space: nowrap;\n      overflow: hidden;\n      text-overflow: ellipsis;\n    }\n\n    .tbw-shell-content {\n      flex: 1;\n      display: flex;\n      align-items: center;\n      gap: 12px;\n      min-width: 0;\n      overflow: hidden;\n    }\n\n    .tbw-shell-toolbar {\n      display: flex;\n      align-items: center;\n      gap: var(--tbw-toolbar-button-gap);\n      flex-shrink: 0;\n    }\n\n    .tbw-toolbar-btn {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: var(--tbw-toolbar-button-size);\n      height: var(--tbw-toolbar-button-size);\n      padding: 0;\n      border: 1px solid transparent;\n      border-radius: var(--tbw-border-radius);\n      background: transparent;\n      color: var(--tbw-color-fg);\n      cursor: pointer;\n      font-size: 16px;\n      transition:\n        background var(--tbw-transition-duration) var(--tbw-transition-ease),\n        border-color var(--tbw-transition-duration) var(--tbw-transition-ease);\n\n      &:hover {\n        background: var(--tbw-color-row-hover);\n      }\n\n      &:focus-visible {\n        outline: var(--tbw-focus-outline);\n        outline-offset: var(--tbw-focus-outline-offset);\n      }\n\n      &.active {\n        background: var(--tbw-focus-background);\n        border-color: var(--tbw-color-accent);\n      }\n\n      &:disabled {\n        opacity: 0.5;\n        cursor: not-allowed;\n      }\n    }\n\n    .tbw-toolbar-separator {\n      width: 1px;\n      height: 20px;\n      background: var(--tbw-color-border);\n      margin: 0 4px;\n    }\n\n    .tbw-shell-body {\n      position: relative;\n      display: flex;\n      flex: 1;\n      min-height: 0;\n      overflow: visible;\n    }\n  }\n}\n\n/* ==========================================================================\n * Tool Panel (was core/styles/tool-panel.css)\n *\n * Styles for the collapsible side panel including header, content,\n * resize handle, and accordion components.\n * ========================================================================== */\n\n@layer tbw-base {\n  tbw-grid {\n    .tbw-tool-panel {\n      position: absolute;\n      top: 0;\n      bottom: 0;\n      right: 0;\n      width: 0;\n      /* `clip` rather than `hidden` so the clip region can be widened: the\n         splitter's hit area straddles the docked edge and has to survive it.\n         `overflow-clip-margin` is the one place `calc()` is avoided — Chromium\n         drops the declaration when the value is calculated, so the overhang is\n         its own token and the splitter geometry is derived from it. */\n      overflow: clip;\n      overflow-clip-margin: var(--tbw-tool-panel-resize-overhang, 12px);\n      background: var(--tbw-tool-panel-bg);\n      border-left: 1px solid var(--tbw-tool-panel-border);\n      transition: width var(--tbw-tool-panel-transition);\n      display: flex;\n      flex-direction: column;\n      z-index: var(--tbw-z-layer-toolpanel, 31);\n      box-shadow: -2px 0 8px var(--tbw-color-shadow);\n\n      &[data-position='left'] {\n        right: auto;\n        left: 0;\n        border-left: none;\n        border-right: 1px solid var(--tbw-tool-panel-border);\n        box-shadow: 2px 0 8px var(--tbw-color-shadow);\n      }\n\n      &.open {\n        /* Never wider than the grid it docks into. An overflowing panel is cut\n           off by the clip above with no way to scroll to what is missing — the\n           labels and the left half of every chip simply vanish (SC 1.4.10\n           Reflow). The 20px reserve matches the drag clamp in\n           `setupToolPanelResize`, so no path can reach a size the other cannot.\n           `max-width` as well as `width`: a dragged width lands as an inline\n           style, which only a max-width can rein back in when the grid later\n           narrows under it. */\n        width: min(var(--tbw-tool-panel-width), 100% - 20px);\n        max-width: calc(100% - 20px);\n      }\n    }\n\n    /* ========== Push mode ========== */\n\n    /* In push mode the panel becomes a flex sibling of the grid content\n       instead of overlaying it. Opening the panel shrinks the grid's\n       available width; the grid's ResizeObserver re-runs column\n       virtualization, so cells that would be hidden by an overlay panel\n       remain reachable.\n\n       The overlay shadow is dropped (nothing to lift off) and the resize\n       handle is suppressed: the panel's width is part of the layout, so\n       drag-to-resize would fight the flex container instead of cooperating\n       with it. */\n    .tbw-shell-body[data-mode='push'] {\n      .tbw-tool-panel {\n        position: relative;\n        top: auto;\n        bottom: auto;\n        right: auto;\n        left: auto;\n        flex-shrink: 0;\n        box-shadow: none;\n        z-index: auto;\n        /* In overlay mode the 1px side border is harmless because the panel\n           floats above the grid. In push mode the panel is a flex sibling,\n           so a non-zero border on a width:0 panel still reserves 1px of\n           horizontal space and shows as a stray divider. Drop the border\n           by default and only re-apply it on the open state. */\n        border-left: none;\n        border-right: none;\n\n        &.open {\n          border-left: 1px solid var(--tbw-tool-panel-border);\n        }\n\n        &[data-position='left'].open {\n          border-left: none;\n          border-right: 1px solid var(--tbw-tool-panel-border);\n        }\n      }\n\n      .tbw-tool-panel-resize {\n        display: none;\n      }\n    }\n\n    /* ========== Dropdown mode ========== */\n\n    /* In dropdown mode the whole tool-panel sidebar (the full accordion) is\n       promoted to the top layer as a native popover and anchored near a\n       trigger (the built-in toggle, a custom column-header button, or the grid\n       corner). The docked absolute/full-height sidebar styling is replaced by\n       a self-sized floating card with an internal scroll region.\n\n       The resize handle is suppressed (a popover has no docked edge to drag)\n       and the open/close width transition is dropped (the popover is shown and\n       hidden via the Popover API, not by animating width). */\n    .tbw-tool-panel[popover] {\n      position: fixed;\n      inset: auto;\n      width: var(--tbw-tool-panel-width);\n      max-width: calc(100vw - 16px);\n      height: auto;\n      max-height: min(70vh, 480px);\n      overflow: hidden auto;\n      margin: 4px 0 0 0;\n      padding: 0;\n      border: 1px solid var(--tbw-tool-panel-border);\n      border-radius: var(--tbw-border-radius, 6px);\n      box-shadow: 0 8px 24px var(--tbw-color-shadow);\n      transition: none;\n\n      /* The native popover UA rule hides a closed popover with `display: none`,\n         but the base `.tbw-tool-panel { display: flex }` author rule outranks\n         the UA origin and would leak the closed popover onto the page (floating\n         over the header). Re-assert hidden-until-open here, and restore the\n         flex layout only while the popover is actually shown. */\n      display: none;\n\n      /* `:popover-open` is the native (Popover API) open signal. `.open` is the\n         JS-toggled fallback (`updatePanelState`) so dropdown mode still renders\n         in browsers / DOMs without Popover API support, where `showPopover()`\n         is unavailable and `:popover-open` never matches. */\n      &:popover-open,\n      &.open {\n        display: flex;\n        width: var(--tbw-tool-panel-width);\n      }\n\n      .tbw-tool-panel-resize {\n        display: none;\n      }\n    }\n\n    /* CSS anchor positioning (progressive enhancement). When the browser\n       supports it, the controller wires `anchor-name` on the trigger and\n       `position-anchor` on the popover; JS only sets fixed coordinates as a\n       fallback for browsers without anchor positioning. */\n    @supports (anchor-name: --x) {\n      .tbw-tool-panel[popover] {\n        /* Default (right position): align popover's right edge to the anchor's\n           right edge and drop below it. */\n        top: anchor(bottom);\n        right: anchor(right);\n        left: auto;\n        position-try-fallbacks:\n          flip-block,\n          flip-inline,\n          flip-block flip-inline;\n\n        /* Grid-corner fallback anchors to the top of the grid host. */\n        &[data-anchor='corner'] {\n          top: anchor(top);\n        }\n\n        &[data-position='left'] {\n          left: anchor(left);\n          right: auto;\n        }\n      }\n    }\n\n    .tbw-tool-panel-resize {\n      position: absolute;\n      top: 0;\n      bottom: 0;\n      /* Transparent hit area, twice the overhang wide (24px by default, the\n         SC 2.5.8 minimum) and centred on the docked edge, so half of it falls\n         outside the panel and it never covers the panel's own controls. */\n      width: calc(var(--tbw-tool-panel-resize-overhang, 12px) * 2);\n      cursor: col-resize;\n      background: transparent;\n      z-index: 10;\n      /* The splitter drag is driven by pointer capture, so the browser must not\n         claim the gesture for panning on touch devices. */\n      touch-action: none;\n      user-select: none;\n\n      /* The visible bar is only the 6px at the docked edge; the rest of the\n         width is invisible hit area. */\n      &::before {\n        content: '';\n        position: absolute;\n        top: 0;\n        bottom: 0;\n        width: 6px;\n        background: transparent;\n        transition: background var(--tbw-transition-duration) var(--tbw-transition-ease);\n      }\n\n      &[data-handle-position='left'] {\n        left: calc(3px - var(--tbw-tool-panel-resize-overhang, 12px));\n\n        &::before {\n          left: calc(var(--tbw-tool-panel-resize-overhang, 12px) - 3px);\n        }\n      }\n\n      &[data-handle-position='right'] {\n        right: calc(3px - var(--tbw-tool-panel-resize-overhang, 12px));\n\n        &::before {\n          right: calc(var(--tbw-tool-panel-resize-overhang, 12px) - 3px);\n        }\n      }\n\n      /* `[data-tbw-size-open]` keeps the splitter lit while the size popover is\n         open, so the popover stays visually tied to the edge it is sizing. */\n      &:hover::before,\n      &.resizing::before,\n      &[data-tbw-size-open]::before {\n        background: var(--tbw-color-accent);\n      }\n    }\n\n    /* A closed panel is zero-width, so the splitter would hang over the grid\n       inside the clip margin. It has nothing to size until the panel is open. */\n    .tbw-tool-panel:not(.open) .tbw-tool-panel-resize {\n      display: none;\n    }\n\n    .tbw-tool-panel-header {\n      display: flex;\n      align-items: center;\n      justify-content: flex-end;\n      min-height: var(--tbw-tool-panel-header-height);\n      padding: 0 12px;\n      border-bottom: 1px solid var(--tbw-tool-panel-border);\n      flex-shrink: 0;\n    }\n\n    .tbw-tool-panel-title {\n      font-weight: 600;\n      font-size: 13px;\n      white-space: nowrap;\n      overflow: hidden;\n      text-overflow: ellipsis;\n    }\n\n    .tbw-tool-panel-close {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 24px;\n      height: 24px;\n      padding: 0;\n      border: none;\n      border-radius: var(--tbw-border-radius);\n      background: transparent;\n      color: var(--tbw-color-fg-muted);\n      cursor: pointer;\n      font-size: 14px;\n\n      &:hover {\n        background: var(--tbw-color-row-hover);\n        color: var(--tbw-color-fg);\n      }\n    }\n\n    /* Inline close button — shares the first accordion header row in\n       single-panel mode (header bar hidden, overlay/push mode). */\n    .tbw-accordion-header-row {\n      display: flex;\n      align-items: stretch;\n\n      .tbw-accordion-header {\n        flex: 1;\n        min-width: 0;\n      }\n    }\n\n    .tbw-tool-panel-close--inline {\n      align-self: center;\n      flex-shrink: 0;\n      margin-inline-end: 8px;\n    }\n\n    .tbw-tool-panel-content {\n      flex: 1;\n      overflow: auto;\n    }\n\n    /* ========== Accordion ========== */\n\n    .tbw-accordion {\n      display: flex;\n      flex-direction: column;\n      gap: 0;\n    }\n\n    .tbw-accordion-section {\n      border-bottom: 1px solid var(--tbw-tool-panel-border);\n\n      &:last-child {\n        border-bottom: none;\n      }\n\n      &.single .tbw-accordion-header {\n        cursor: default;\n\n        &:hover {\n          background: transparent;\n        }\n      }\n\n      &.expanded {\n        .tbw-accordion-chevron {\n          transform: rotate(90deg);\n        }\n\n        .tbw-accordion-content {\n          display: block;\n        }\n      }\n    }\n\n    .tbw-accordion-header {\n      display: flex;\n      align-items: center;\n      gap: 8px;\n      width: 100%;\n      padding: 10px 12px;\n      border: none;\n      background: transparent;\n      color: var(--tbw-color-fg);\n      font-size: 13px;\n      font-weight: 600;\n      text-align: start;\n      cursor: pointer;\n      user-select: none;\n\n      &:hover {\n        background: var(--tbw-color-row-hover);\n      }\n    }\n\n    .tbw-accordion-chevron {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 16px;\n      height: 16px;\n      font-size: 10px;\n      color: var(--tbw-color-fg-muted);\n      transition: transform 0.15s ease;\n      flex-shrink: 0;\n    }\n\n    .tbw-accordion-icon {\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n      width: 16px;\n      height: 16px;\n      font-size: 14px;\n      flex-shrink: 0;\n    }\n\n    .tbw-accordion-title {\n      flex: 1;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n\n    .tbw-accordion-content {\n      display: none;\n    }\n  }\n}\n","/**\n * Shell Plugin (Class-based)\n *\n * Owns the grid shell: header bar, toolbar content, and tool panels.\n *\n * **Extraction #370 — Phase 1b (ownership inversion):** this plugin now owns\n * the shell **state** for the grid's lifetime (Approach A: state created once,\n * survives plugin re-inits, torn down on disconnect). Light-DOM parsing,\n * per-render work, and DOM construction move here in the following increments;\n * until each lands, core still drives that part via the resolved plugin\n * instance.\n *\n * @module Plugins/Shell\n */\n\nimport { HEADER_CONTENT_DUPLICATE, TOOL_PANEL_DUPLICATE, warnDiagnostic } from '../../core/internal/diagnostics';\nimport { BaseGridPlugin, type GridElement } from '../../core/plugin/base-plugin';\nimport type { GridConfig } from '../../core/types';\nimport {\n  cleanupShellState,\n  createShellState,\n  parseLightDomShell,\n  parseLightDomToolButtons,\n  parseLightDomToolPanels,\n  prepareForRerender,\n  rebuildShellDOM,\n  renderCustomToolbarContents,\n  renderHeaderContent,\n  renderPanelContent,\n  setupClickOutsideDismiss,\n  setupEscapeDismiss,\n  setupShellEventListeners,\n  setupToolPanelResize,\n  shouldRenderShellHeader,\n  updatePanelState,\n  updateToolbarActiveStates,\n  type ShellState,\n} from './shell';\nimport { createShellController, type ShellController, type ShellControllerGrid } from './shell-controller';\nimport styles from './shell.css?inline';\nimport './types';\nimport type {\n  HeaderContentDefinition,\n  OpenToolPanelOptions,\n  ShellConfig,\n  ToolbarContentDefinition,\n  ToolPanelDefinition,\n} from './types';\n\n/**\n * Shell plugin for `<tbw-grid>`.\n *\n * @see {@link ShellConfig} for all configuration options.\n *\n * @internal Extends BaseGridPlugin.\n * @since 2.x (extraction #370)\n */\nexport class ShellPlugin extends BaseGridPlugin<ShellConfig> {\n  /** @internal */\n  readonly name = 'shell';\n  /** @internal */\n  override readonly styles = styles;\n\n  // Extraction #370 — Approach A: the plugin owns the shell state for the\n  // grid's lifetime. State is created once (via `ensureState`, lazily on first\n  // access) and survives plugin re-inits (idempotent attach / non-destructive\n  // detach); it is torn down only on grid disconnect via `disposeShellState()`.\n  #state?: ShellState;\n  #controller?: ShellController;\n\n  // Document-level listeners the plugin owns for the shell's interactive\n  // affordances. Each `#setupListeners` call cleans the previous registration\n  // before re-adding (idempotent across re-wraps); torn down on disconnect.\n  #resizeCleanup?: () => void;\n  #clickOutsideCleanup?: () => void;\n  #escapeDismissCleanup?: () => void;\n\n  // The light-DOM shell-change handler (re-parses <tbw-grid-header> /\n  // <tbw-grid-tool-buttons> / <tbw-grid-tool-panel> when the framework projects\n  // them asynchronously). Registered in `attach` via the generic\n  // `_registerLightDomHandler` seam; unregistered on disconnect.\n  #shellChangeHandler?: () => void;\n\n  // While a dropdown tool panel is open, this observer watches the render root\n  // for the trigger being recreated by an outer framework (e.g. a React column\n  // `headerRenderer` re-running on a column toggle) and re-pairs the popover's\n  // anchor. MutationObserver callbacks run as a pre-paint microtask, so the\n  // re-pair lands BEFORE the browser paints the dangling-anchor frame — no\n  // flash. It also fires for every toggle (not a coalesced single rAF), so the\n  // dropdown no longer intermittently disappears. Connected lazily while a\n  // dropdown is open; disconnected on close and on grid disconnect.\n  #reanchorObserver?: MutationObserver;\n  #reanchorObserving = false;\n\n  /** @internal Whether shell state has been created yet. */\n  get hasState(): boolean {\n    return this.#state !== undefined;\n  }\n\n  /**\n   * @internal Create the canonical shell state + controller (idempotent).\n   * The plugin owns shell-state construction; the controller binds to the grid\n   * for UI updates. No-op once state exists, so it is safe to call on every\n   * `attach` (and from a pre-connect API call), which keeps the shell self-\n   * sufficient — core holds no shell-activation knowledge (extraction #370).\n   */\n  ensureState(grid: GridElement): void {\n    if (this.#state) return;\n    const state = createShellState();\n    this.#state = state;\n    this.#controller = createShellController(state, grid as ShellControllerGrid);\n  }\n\n  /** @internal Canonical shell state. */\n  get shellState(): ShellState {\n    return this.#state as ShellState;\n  }\n\n  /** @internal Shell controller. */\n  get shellController(): ShellController {\n    return this.#controller as ShellController;\n  }\n\n  // #region Public Shell API\n  // The shell plugin's public, programmatic API. Obtain the instance via\n  // `grid.getPluginByName('shell')`. The equivalent `<tbw-grid>` delegate\n  // methods were removed in v3 (extraction #370). Each guards on `hasState`\n  // so a call before the shell has initialized is a safe no-op.\n\n  /** Whether the tool panel sidebar is currently open. */\n  get isToolPanelOpen(): boolean {\n    return this.hasState ? this.shellController.isPanelOpen : false;\n  }\n\n  /** IDs of the currently expanded accordion sections in the tool panel. */\n  get expandedToolPanelSections(): string[] {\n    return this.hasState ? this.shellController.expandedSections : [];\n  }\n\n  /**\n   * Open the tool panel sidebar.\n   * @param panelId - Optional section to expand on open (see {@link ShellController.openToolPanel}).\n   * @param options - Optional open options. In `mode: 'dropdown'`, `options.anchor`\n   *   sets the element the popover anchors to (see {@link OpenToolPanelOptions}).\n   */\n  openToolPanel(panelId?: string, options?: OpenToolPanelOptions): void {\n    this.shellController?.openToolPanel(panelId, options);\n  }\n\n  /** Close the tool panel sidebar. */\n  closeToolPanel(): void {\n    this.shellController?.closeToolPanel();\n  }\n\n  /**\n   * Toggle the tool panel sidebar open or closed.\n   * @param options - Optional open options forwarded when opening (e.g. `anchor`\n   *   for dropdown mode; see {@link OpenToolPanelOptions}).\n   */\n  toggleToolPanel(options?: OpenToolPanelOptions): void {\n    this.shellController?.toggleToolPanel(options);\n  }\n\n  /** Toggle an accordion section expanded or collapsed within the tool panel. */\n  toggleToolPanelSection(sectionId: string): void {\n    this.shellController?.toggleToolPanelSection(sectionId);\n  }\n\n  /** Get all registered tool panel definitions. */\n  getToolPanels(): ToolPanelDefinition[] {\n    return this.hasState ? this.shellController.getToolPanels() : [];\n  }\n\n  /** Register a custom tool panel section. */\n  registerToolPanel(panel: ToolPanelDefinition): void {\n    if (!this.hasState) return;\n    this.shellState.apiToolPanelIds.add(panel.id);\n    this.shellController.registerToolPanel(panel);\n  }\n\n  /** Unregister a custom tool panel section. */\n  unregisterToolPanel(panelId: string): void {\n    if (!this.hasState) return;\n    this.shellState.apiToolPanelIds.delete(panelId);\n    this.shellController.unregisterToolPanel(panelId);\n  }\n\n  /** Get all registered header content definitions. */\n  getHeaderContents(): HeaderContentDefinition[] {\n    return this.hasState ? this.shellController.getHeaderContents() : [];\n  }\n\n  /** Register custom header content (rendered in the shell header bar). */\n  registerHeaderContent(content: HeaderContentDefinition): void {\n    if (!this.hasState) return;\n    this.shellState.apiHeaderContentIds.add(content.id);\n    this.shellController.registerHeaderContent(content);\n  }\n\n  /** Unregister custom header content. */\n  unregisterHeaderContent(contentId: string): void {\n    if (!this.hasState) return;\n    this.shellState.apiHeaderContentIds.delete(contentId);\n    this.shellController.unregisterHeaderContent(contentId);\n  }\n\n  /** Get all registered toolbar content definitions. */\n  getToolbarContents(): ToolbarContentDefinition[] {\n    return this.hasState ? this.shellController.getToolbarContents() : [];\n  }\n\n  /** Register custom toolbar content (rendered in the shell toolbar). */\n  registerToolbarContent(content: ToolbarContentDefinition): void {\n    this.shellController?.registerToolbarContent(content);\n  }\n\n  /** Unregister custom toolbar content. */\n  unregisterToolbarContent(contentId: string): void {\n    this.shellController?.unregisterToolbarContent(contentId);\n  }\n  // #endregion\n\n  /** @internal */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    // Activate the shell on attach so an opted-in shell renders without core\n    // ever calling into it (extraction #370 — core holds no shell-activation\n    // knowledge). Idempotent: a pre-connect API call may have created state.\n    this.ensureState(grid);\n    // Register the light-DOM shell handlers via the generic seam. Core holds no\n    // shell tag knowledge (extraction #370). `registerLightDomHandler` is keyed\n    // by tag name, so re-attach simply overwrites — idempotent. Torn down on\n    // grid disconnect in `disposeShellState` (Approach A: survives re-inits).\n    const handler = (): void => this.syncLightDom();\n    this.#shellChangeHandler = handler;\n    grid._registerLightDomHandler('tbw-grid-header', handler);\n    grid._registerLightDomHandler('tbw-grid-tool-buttons', handler);\n    grid._registerLightDomHandler('tbw-grid-tool-panel', handler);\n  }\n\n  /** @internal Parse all light-DOM shell elements into the plugin's state. */\n  #parseLightDom(grid: GridElement): void {\n    const host = grid._hostElement;\n    parseLightDomShell(host, this.shellState);\n    parseLightDomToolButtons(host, this.shellState);\n    parseLightDomToolPanels(host, this.shellState, grid._getToolPanelRendererFactory());\n  }\n\n  /**\n   * @internal Generic hook: react to a light-DOM shell element being\n   * added/removed/mutated (e.g. a framework projecting `<tbw-grid-header title>`\n   * asynchronously). Re-parses, and if a title or tool-buttons container newly\n   * appeared, re-merges the config (so `processConfig` folds it in) and re-wraps\n   * the already-rendered shell header. No-op until the shell header is rendered.\n   * Called by core from `refreshColumns` and the light-DOM observer.\n   */\n  override syncLightDom(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    const state = this.shellState;\n    const hadTitle = state.lightDomTitle;\n    const hadToolButtons = state.hasToolButtonsContainer;\n    this.#parseLightDom(grid);\n    const hasTitle = state.lightDomTitle;\n    const hasToolButtons = state.hasToolButtonsContainer;\n\n    if ((hasTitle && !hadTitle) || (hasToolButtons && !hadToolButtons)) {\n      grid._requestConfigMerge();\n      // Re-wrap the shell header to reflect the new title / tool buttons.\n      // `afterStructuralRender` rebuilds the chrome AND re-renders all shell\n      // contents (header content, toolbar slots, panel), so no manual render is\n      // needed here.\n      if (grid._renderRoot.querySelector('.tbw-shell-header')) {\n        prepareForRerender(state);\n        this.afterStructuralRender();\n      }\n    }\n  }\n\n  // #region Generic structural hooks (extraction #370)\n  // Core calls these via the plugin manager (parseLightDom /\n  // beforeStructuralRender / needsStructuralRerender) — it holds no\n  // shell-specific orchestration. The shell self-parses, self-prepares, and\n  // self-decides re-render needs from its own state + DOM signature.\n\n  /** @internal Generic hook: re-parse all light-DOM shell elements into state. */\n  override parseLightDom(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    this.#parseLightDom(grid);\n  }\n\n  /** @internal Generic hook: move toolbar buttons back ahead of a structural rebuild. */\n  override beforeStructuralRender(): void {\n    if (!this.hasState) return;\n    prepareForRerender(this.shellState);\n  }\n\n  /**\n   * @internal Generic hook: whether the shell's rendered DOM signature no longer\n   * matches the new effective config (header appearing/disappearing, tool-panel\n   * count/position/mode change) and therefore needs a structural re-render.\n   * Reads the still-current (old) DOM vs the freshly merged config.\n   */\n  override needsStructuralRerender(): boolean {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return false;\n    const root = grid._renderRoot;\n    const hadShell = !!root.querySelector('.has-shell');\n    const hadToolPanel = !!root.querySelector('.tbw-tool-panel');\n    const accordionSectionsBefore = root.querySelectorAll('.tbw-accordion-section').length;\n    const prevPosition = (root.querySelector('.tbw-tool-panel') as HTMLElement | null)?.dataset.position ?? 'right';\n    const prevMode = (root.querySelector('.tbw-shell-body') as HTMLElement | null)?.dataset.mode ?? 'overlay';\n\n    const shell = grid.effectiveConfig?.shell;\n    const nowNeedsShell = shouldRenderShellHeader(shell);\n    const nowHasToolPanels = (shell?.toolPanels?.length ?? 0) > 0;\n    const toolPanelCount = shell?.toolPanels?.length ?? 0;\n    const newPosition = shell?.toolPanel?.position ?? 'right';\n    const newMode = shell?.toolPanel?.mode ?? 'overlay';\n\n    return (\n      hadShell !== nowNeedsShell ||\n      (!hadToolPanel && nowHasToolPanels) ||\n      (hadToolPanel && toolPanelCount !== accordionSectionsBefore) ||\n      (hadToolPanel && prevPosition !== newPosition) ||\n      (hadToolPanel && prevMode !== newMode)\n    );\n  }\n  // #endregion\n\n  /**\n   * @internal Fold the plugin's shell state into the effective config.\n   *\n   * Called by core's config merge ({@link ConfigManager.merge}) via the neutral\n   * `processConfig` plugin hook \\u2014 core holds no shell-config knowledge. Mutates\n   * `config.shell` in place from light-DOM-parsed + API-registered shell state\n   * (title, header content, tool buttons, tool panels, header/toolbar contents).\n   *\n   * Extraction #370, Task 1b \\u2014 config ownership inversion: replaces core's old\n   * `ConfigManager.#mergeShellConfig`.\n   */\n  /**\n   * @internal Self-collect plugin tool panels + header contents into shell\n   * state. Clears stale plugin-contributed entries (preserving light-DOM +\n   * API-registered) then re-collects fresh from all attached plugins via the\n   * neutral `grid._pluginShellContributions()` seam. Idempotent — safe to run on\n   * every config merge, which is how plugin re-inits are picked up.\n   *\n   * Extraction #370: replaces core's `#collectPluginShellContributions` plus the\n   * plugin-reinit cleanup block in core's `#updatePluginConfigs`.\n   */\n  #syncPluginContributions(grid: GridElement): void {\n    const state = this.shellState;\n    const gridId = grid._hostElement.id;\n\n    // Drop stale plugin-contributed tool panels (keep light-DOM + API panels).\n    for (const panelId of [...state.toolPanels.keys()]) {\n      if (state.lightDomToolPanelIds.has(panelId) || state.apiToolPanelIds.has(panelId)) continue;\n      state.panelCleanups.get(panelId)?.();\n      state.panelCleanups.delete(panelId);\n      state.toolPanels.delete(panelId);\n    }\n    // Drop stale plugin-contributed header contents (keep API-registered).\n    for (const contentId of [...state.headerContents.keys()]) {\n      if (state.apiHeaderContentIds.has(contentId)) continue;\n      state.headerContentCleanups.get(contentId)?.();\n      state.headerContentCleanups.delete(contentId);\n      state.headerContents.delete(contentId);\n    }\n\n    const { toolPanels, headerContents } = grid._pluginShellContributions();\n\n    for (const panel of toolPanels) {\n      // Precedence (#370): an API-registered panel wins over a plugin; a plugin\n      // wins over a colliding light-DOM panel (the plugin owns its own DOM, so\n      // it must own the id).\n      if (state.apiToolPanelIds.has(panel.id)) continue;\n      if (state.lightDomToolPanelIds.has(panel.id)) {\n        warnDiagnostic(\n          TOOL_PANEL_DUPLICATE,\n          `Tool panel \"${panel.id}\" is provided by a plugin; ignoring the matching light-DOM <tbw-grid-tool-panel>.`,\n          gridId,\n        );\n        state.panelCleanups.get(panel.id)?.();\n        state.panelCleanups.delete(panel.id);\n        state.lightDomToolPanelIds.delete(panel.id);\n        state.adapterBoundToolPanelIds.delete(panel.id);\n      }\n      state.toolPanels.set(panel.id, panel);\n    }\n\n    for (const content of headerContents) {\n      if (state.apiHeaderContentIds.has(content.id)) continue;\n      if (state.headerContents.has(content.id)) {\n        warnDiagnostic(\n          HEADER_CONTENT_DUPLICATE,\n          `Header content \"${content.id}\" is provided by a plugin; ignoring the matching light-DOM definition.`,\n          gridId,\n        );\n        state.headerContentCleanups.get(content.id)?.();\n        state.headerContentCleanups.delete(content.id);\n      }\n      state.headerContents.set(content.id, content);\n    }\n  }\n\n  override processConfig(config: GridConfig): void {\n    if (!this.hasState) return;\n    const state = this.shellState;\n\n    // Self-parse light-DOM shell elements + self-collect plugin shell\n    // contributions before folding state into config (extraction #370 —\n    // replaces core's `#parseLightDom` + `#collectPluginShellContributions`).\n    const grid = this.grid;\n    if (grid) {\n      this.#parseLightDom(grid);\n      this.#syncPluginContributions(grid);\n    }\n\n    // Constructor-supplied shell config is the base layer: the canonical\n    // `features: { shell: ... }` opt-in passes the config value here (and an\n    // explicit `plugins: [new ShellPlugin(cfg)]` does too). An explicit\n    // top-level `gridConfig.shell` overrides it; parsed light-DOM / API state\n    // folds on top below. Empty for the auto-registered instance\n    // (`new ShellPlugin()`), so existing default-on behavior is unchanged.\n    const ctor = this.resolvedConfig;\n\n    // Clone shell hierarchy to avoid mutating the original gridConfig.\n    config.shell = { ...ctor, ...config.shell };\n    config.shell.header = { ...ctor.header, ...config.shell.header };\n\n    // Light DOM title (does not override an explicit config title).\n    if (state.lightDomTitle && !config.shell.header.title) {\n      config.shell.header.title = state.lightDomTitle;\n    }\n\n    // Light DOM header content elements.\n    if (state.lightDomHeaderContent?.length > 0) {\n      config.shell.header.lightDomContent = state.lightDomHeaderContent;\n    }\n\n    // Tool-buttons container presence.\n    if (state.hasToolButtonsContainer) {\n      config.shell.header.hasToolButtonsContainer = true;\n    }\n\n    // Tool panels (from plugins + API + Light DOM), sorted by order.\n    if (state.toolPanels.size > 0) {\n      const panels = Array.from(state.toolPanels.values());\n      panels.sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n      config.shell.toolPanels = panels;\n    }\n\n    // Header contents (from plugins + API), sorted by order.\n    if (state.headerContents.size > 0) {\n      const contents = Array.from(state.headerContents.values());\n      contents.sort((a, b) => (a.order ?? 100) - (b.order ?? 100));\n      config.shell.headerContents = contents;\n    }\n\n    // Toolbar contents: merge ORIGINAL config contents (from the source\n    // gridConfig, not a previous merge) with API-registered contents so stale\n    // API entries never accumulate. Config takes precedence by id.\n    const apiContents = Array.from(state.toolbarContents.values());\n    const originalConfigContents = this.grid?._sourceConfig?.shell?.header?.toolbarContents ?? [];\n    const configIds = new Set(originalConfigContents.map((c) => c.id));\n    const mergedContents = [...originalConfigContents];\n    for (const content of apiContents) {\n      if (!configIds.has(content.id)) {\n        mergedContents.push(content);\n      }\n    }\n    mergedContents.sort((a, b) => (a.order ?? 0) - (b.order ?? 0));\n    config.shell.header.toolbarContents = mergedContents;\n  }\n\n  /**\n   * @internal Wrap the freshly built (bare) grid DOM in shell chrome.\n   *\n   * Fired synchronously by core at the end of every structural (re)build, before\n   * paint. Core builds a BARE grid; this hook relocates the existing\n   * `.tbw-grid-content` node into shell chrome (header bar, toolbar, tool panel)\n   * via {@link rebuildShellDOM}, which preserves the content subtree (and all its\n   * listeners / cached refs) intact. No-op when no shell is configured.\n   *\n   * Extraction #370, Task 1b — DOM ownership inversion: the shell DOM is now\n   * constructed by the plugin, not core.\n   */\n  override afterStructuralRender(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    const state = this.shellState;\n    const hasShell = rebuildShellDOM(\n      grid._renderRoot,\n      grid.effectiveConfig?.shell,\n      { isPanelOpen: state.isPanelOpen, expandedSections: state.expandedSections },\n      grid.effectiveConfig?.icons,\n    );\n    if (hasShell) {\n      this.#setupListeners(grid);\n      this.shellController.setInitialized(true);\n      this.#renderShellContents(grid);\n    }\n  }\n\n  /**\n   * @internal Re-anchor an open dropdown tool panel after a NON-structural\n   * render.\n   *\n   * A column-visibility toggle (or reorder) re-renders the grid header WITHOUT\n   * a full structural rebuild — it fires `afterRender`, not\n   * `afterStructuralRender`. When the column-chooser trigger lives in the grid\n   * header (e.g. a custom `[data-panel-toggle]` button in a column\n   * `headerRenderer`), that re-render recreates the trigger node, so it loses\n   * the `anchor-name` that paired it with the open popover. The popover then\n   * collapses to the viewport / grid corner.\n   *\n   * Two cooperating mechanisms keep the popover anchored with NO flash:\n   * 1. A synchronous {@link ShellController.reanchorOpenDropdown} here catches\n   *    the case where the trigger was recreated synchronously during this\n   *    render (in-place re-pair, before paint).\n   * 2. A {@link MutationObserver} (started here, kept running while the panel is\n   *    open) catches the case where an outer framework commits the replacement\n   *    trigger on a LATER task. Its callback runs as a pre-paint microtask, so\n   *    the re-pair lands before the dangling-anchor frame is painted.\n   *\n   * `reanchorOpenDropdown()` is idempotent and cheap (early-returns unless a\n   * dropdown is open with a broken anchor), so running it on every render and\n   * every mutation is safe.\n   */\n  override afterRender(): void {\n    const grid = this.grid;\n    if (!grid || !this.hasState) return;\n    const state = this.shellState;\n\n    // In-place shell header title sync (extraction #370 — replaces core's\n    // `#updateShellHeaderInPlace`). Idempotent: only touches the existing\n    // `.tbw-shell-header`, no-op when no shell is rendered.\n    this.#syncShellHeaderTitle(grid);\n\n    // Re-render any open tool-panel sections whose content was cleared during a\n    // plugin re-init (extraction #370 — replaces core's `_renderOpenPanelContent`).\n    // `renderPanelContent` is idempotent — it only fills empty sections.\n    if (state.isPanelOpen) {\n      renderPanelContent(grid._renderRoot, state);\n    }\n\n    // Dropdown re-anchor after a NON-structural render (see method docs below).\n    if (!state.isPanelOpen) {\n      this.#stopReanchorObserver();\n      return;\n    }\n    this.shellController.reanchorOpenDropdown();\n    this.#startReanchorObserver(grid);\n  }\n\n  /**\n   * @internal Sync the shell header title element in place from the effective\n   * config (or parsed light-DOM title) without a full re-render. Extracted from\n   * core's former `#updateShellHeaderInPlace` (#370).\n   */\n  #syncShellHeaderTitle(grid: GridElement): void {\n    const shellHeader = grid._renderRoot.querySelector('.tbw-shell-header');\n    if (!shellHeader) return;\n\n    const title = grid.effectiveConfig?.shell?.header?.title ?? this.shellState.lightDomTitle;\n\n    let titleEl = shellHeader.querySelector('.tbw-shell-title') as HTMLElement | null;\n    if (title) {\n      if (!titleEl) {\n        titleEl = document.createElement('h2');\n        titleEl.className = 'tbw-shell-title';\n        titleEl.setAttribute('part', 'shell-title');\n        shellHeader.insertBefore(titleEl, shellHeader.firstChild);\n      }\n      titleEl.textContent = title;\n    } else if (titleEl) {\n      titleEl.remove();\n    }\n  }\n\n  /** @internal Start (idempotently) the dropdown re-anchor observer. */\n  #startReanchorObserver(grid: GridElement): void {\n    // Only dropdown mode needs the observer. If the mode changed away from\n    // 'dropdown' while the panel is still open, tear down any observer started\n    // by an earlier render instead of leaving it watching the render root.\n    if (grid.effectiveConfig?.shell?.toolPanel?.mode !== 'dropdown') {\n      this.#stopReanchorObserver();\n      return;\n    }\n    if (typeof MutationObserver === 'undefined') return;\n    if (!this.#reanchorObserver) {\n      this.#reanchorObserver = new MutationObserver(() => {\n        if (!this.grid || !this.hasState || !this.shellState.isPanelOpen) {\n          this.#stopReanchorObserver();\n          return;\n        }\n        this.shellController.reanchorOpenDropdown();\n      });\n    }\n    if (!this.#reanchorObserving) {\n      this.#reanchorObserver.observe(grid._renderRoot, { childList: true, subtree: true });\n      this.#reanchorObserving = true;\n    }\n  }\n\n  /** @internal Stop the dropdown re-anchor observer if running. */\n  #stopReanchorObserver(): void {\n    if (this.#reanchorObserver && this.#reanchorObserving) {\n      this.#reanchorObserver.disconnect();\n      this.#reanchorObserving = false;\n    }\n  }\n\n  /**\n   * @internal Render all shell contents into the freshly built shell chrome.\n   *\n   * Runs from {@link afterStructuralRender} after the chrome is wrapped and\n   * listeners are attached. Renders plugin header content + custom toolbar\n   * slots, applies the configured default-open / legacy open-on-load behavior,\n   * and restores an already-open panel's content. All render functions operate\n   * on the shell DOM (queried from `_renderRoot`), not on the grid-body refs,\n   * so they are safe to run before `#afterConnect` caches those.\n   *\n   * Extraction #370, Task 1b (Step 1b.1.3) — replaces core's per-render shell\n   * content block in `#afterConnect` / `#afterShellRefresh`.\n   */\n  #renderShellContents(grid: GridElement): void {\n    const state = this.shellState;\n    const renderRoot = grid._renderRoot;\n    const shellConfig = grid.effectiveConfig?.shell;\n\n    // Render plugin header content + custom toolbar contents (render modes).\n    renderHeaderContent(renderRoot, state);\n    renderCustomToolbarContents(renderRoot, shellConfig, state);\n\n    // Pre-expand the configured default section.\n    const toolPanelCfg = shellConfig?.toolPanel;\n    const defaultOpen = toolPanelCfg?.defaultOpen;\n    if (defaultOpen && state.toolPanels.has(defaultOpen)) {\n      state.expandedSections.add(defaultOpen);\n    }\n\n    // Decide whether the sidebar should be open on load.\n    // `initialState` (or `locked`) is authoritative when set. Otherwise a\n    // `defaultOpen` section implies the sidebar opens on load. See issue #259\n    // for the proposal to split these two concerns.\n    // Search marker: TOOLPANEL-OPEN-259\n    const shouldOpenOnLoad =\n      toolPanelCfg?.locked === true ||\n      toolPanelCfg?.initialState === 'open' ||\n      (toolPanelCfg?.initialState === undefined && defaultOpen !== undefined && state.toolPanels.has(defaultOpen));\n    if (!state.isPanelOpen && state.toolPanels.size > 0 && shouldOpenOnLoad) {\n      this.openToolPanel();\n    }\n\n    // Restore panel content if the panel was already open (e.g. after a position\n    // change re-render or a plugin re-init that triggered a shell refresh).\n    if (state.isPanelOpen) {\n      updatePanelState(renderRoot, state);\n      renderPanelContent(renderRoot, state, {\n        expand: grid.effectiveConfig?.icons?.expand,\n        collapse: grid.effectiveConfig?.icons?.collapse,\n      });\n      updateToolbarActiveStates(renderRoot, state);\n      // In dropdown mode `rebuildShellDOM` created a fresh `.tbw-tool-panel`, so\n      // the popover must be re-shown in the top layer and re-anchored — the\n      // trigger may have been recreated by the same re-render (e.g. a custom\n      // column-header button after a column toggle/reorder). Otherwise the\n      // popover loses its anchor and collapses to the viewport corner.\n      this.shellController.reanchorOpenDropdown();\n    }\n  }\n\n  /**\n   * @internal Attach shell event + dismiss/resize listeners.\n   *\n   * Cleans any prior document-level registrations before re-adding, so it is\n   * safe to call on every re-wrap (initial render, shell refresh, plugin\n   * re-init) without leaking or double-attaching listeners.\n   */\n  #setupListeners(grid: GridElement): void {\n    const renderRoot = grid._renderRoot;\n    const shellConfig = grid.effectiveConfig?.shell;\n    const state = this.shellState;\n\n    setupShellEventListeners(renderRoot, shellConfig, state, {\n      onPanelToggle: () => this.toggleToolPanel(),\n      onSectionToggle: (sectionId: string) => this.toggleToolPanelSection(sectionId),\n      onPanelClose: () => this.closeToolPanel(),\n    });\n\n    // Tool panel resize handle — persists the new width as a CSS variable on\n    // the host element.\n    this.#resizeCleanup?.();\n    this.#resizeCleanup = setupToolPanelResize(renderRoot, shellConfig, (width: number) => {\n      grid._hostElement.style.setProperty('--tbw-tool-panel-width', `${width}px`);\n    });\n\n    // Click-outside dismiss for an open overlay tool panel.\n    this.#clickOutsideCleanup?.();\n    this.#clickOutsideCleanup = setupClickOutsideDismiss(grid._hostElement, shellConfig, state, () =>\n      this.closeToolPanel(),\n    );\n\n    // Escape-to-close dismiss for overlay tool panels.\n    this.#escapeDismissCleanup?.();\n    this.#escapeDismissCleanup = setupEscapeDismiss(shellConfig, state, () => this.closeToolPanel());\n  }\n\n  /** @internal Remove the document-level shell listeners. */\n  #teardownListeners(): void {\n    this.#resizeCleanup?.();\n    this.#resizeCleanup = undefined;\n    this.#clickOutsideCleanup?.();\n    this.#clickOutsideCleanup = undefined;\n    this.#escapeDismissCleanup?.();\n    this.#escapeDismissCleanup = undefined;\n  }\n\n  /** @internal */\n  override detach(): void {\n    // Non-destructive detach (Approach A): shell state and document listeners\n    // survive plugin re-inits. `#setupListeners` cleans-before-add on the next\n    // re-wrap, so there is nothing to tear down here. Real teardown happens in\n    // `disposeShellState()` on grid disconnect.\n    super.detach();\n  }\n\n  /**\n   * @internal Tear down shell state on grid disconnect (Approach A).\n   * Idempotent and harmless when no state exists.\n   */\n  disposeShellState(): void {\n    this.#teardownListeners();\n    this.#stopReanchorObserver();\n    this.#reanchorObserver = undefined;\n    // Unregister the light-DOM shell handlers (registered in `attach`). `detach`\n    // does not clear `this.grid`, so the reference is still valid here.\n    const grid = this.grid as GridElement | undefined;\n    if (grid && this.#shellChangeHandler) {\n      grid._unregisterLightDomHandler('tbw-grid-header');\n      grid._unregisterLightDomHandler('tbw-grid-tool-buttons');\n      grid._unregisterLightDomHandler('tbw-grid-tool-panel');\n      this.#shellChangeHandler = undefined;\n    }\n    if (this.#state) {\n      cleanupShellState(this.#state);\n      this.#controller?.setInitialized(false);\n    }\n  }\n}\n"],"mappings":"AA+BA,SAAgB,EAAW,EAAiB,GAG1C,MAAO,YAFI,EAAS,IAAI,IAAW,KACpB,EAAa,IAAI,IAAe,KAEjD,CAqDA,IAsCa,EAAuB,SAEvB,EAAuB,SAEvB,EAA2B,SA8HxC,SAAgB,EAAiB,EAAsB,EAAiB,EAAiB,GAEvF,MAAO,GADQ,EAAW,EAAQ,MACd,MAAS,uBApB/B,SAAiB,GACf,MAAO,qCAAgB,EAAK,eAC9B,CAkB4D,CAAQ,IACpE,CAkBA,SAAgB,EAAe,EAAsB,EAAiB,EAAiB,GACrF,QAAQ,KAAK,EAAiB,EAAM,EAAS,EAAQ,GACvD,CC7NA,IAAa,EAA0C,CACrD,OAAQ,IACR,SAAU,IACV,QAAS,IACT,SAAU,IACV,SAAU,IACV,aAAc,IACd,WAAY,KACZ,UAAW,IACX,OAAQ,GACR,aAAc,GACd,MAAO,OCxDH,EACJ,4SACG,MAAM,KACN,IAAK,GAAM,EAAE,MAAM,IAAI,UAAU,KAAK,KA2BrC,GA1BY,IAAI,OAAO,uCAAuC,EAAG,MAAM,GAAG,KAAK,gBA0B9D,IAAI,IACzB,2KAA2K,MACzK,OAOE,EAAyB,WAKzB,EAAY,IAAI,IAAI,kEAAkE,MAAM,MAK5F,EAAyB,wCA8D/B,SAAgB,EAAiB,EAAa,GACvC,GAAwB,iBAAT,GAKM,IAAtB,EAAK,QAAQ,OAAqC,IAAtB,EAAK,QAAQ,KAI7C,EAAG,gBAlCL,SAAmC,GACjC,MAAM,EAAW,SAAS,cAAc,YAKxC,OAJI,GAAwB,iBAAT,IACjB,EAAS,UAAY,EACrB,EAAa,EAAS,UAEjB,EAAS,OAClB,CA2BqB,CAAmB,IAHpC,EAAG,YAAc,EALjB,EAAG,iBASP,CAKA,SAAS,EAAa,GACpB,MAAM,EAAsB,GAGtB,EAAW,EAAK,iBAAiB,KAEvC,IAAK,MAAM,KAAM,EAAU,CACzB,MAAM,EAAU,EAAG,QAAQ,cAG3B,GAAI,EAAe,IAAI,GAAU,CAC/B,EAAS,KAAK,GACd,QACF,CAGA,IAAgB,QAAZ,GAAyC,+BAApB,EAAG,eAEE,MAAM,KAAK,EAAG,YAAY,KACnD,GAAS,EAAuB,KAAK,EAAK,OAAuB,SAAd,EAAK,MAAiC,eAAd,EAAK,MAE1D,CACvB,EAAS,KAAK,GACd,QACF,CAIF,MAAM,EAA0B,GAChC,IAAK,MAAM,KAAQ,EAAG,WAAY,CAChC,MAAM,EAAW,EAAK,KAAK,cAGvB,EAAuB,KAAK,GAC9B,EAAc,KAAK,EAAK,MAMT,OAAb,GAMA,EAAU,IAAI,IAAa,EAAuB,KAAK,EAAK,QAM/C,UAAb,GAAwB,4CAA4C,KAAK,EAAK,SALhF,EAAc,KAAK,EAAK,MANxB,EAAc,KAAK,EAAK,KAe5B,CAEA,EAAc,QAAS,GAAS,EAAG,gBAAgB,GACrD,CAGA,EAAS,QAAS,GAAO,EAAG,SAC9B,CCoQA,IAAsB,EAAtB,MAiBE,oBAuBA,gBAUA,QAMA,QAAA,QAGA,OAGA,cAGA,gBAGA,YAGA,KAGA,OAGA,WAOA,GAOA,iBAAc,GACZ,MAAO,CAAC,CACV,CAEA,WAAA,CAAY,EAA2B,CAAC,GACtC,KAAK,WAAa,CACpB,CAgBA,kBAAI,GACF,OAAQ,MAAK,EAAmB,KAAK,OAAS,IAAK,KAAK,iBAAkB,KAAK,WACjF,CAuBA,gBAAA,CAAiB,GACf,GAAsB,IAAlB,EAAO,OAAc,OACzB,MAAM,EAAS,IAAK,KAAK,YACnB,EAAmD,CAAC,EAC1D,IAAK,MAAM,KAAO,OAAO,KAAK,GAAS,EAAQ,GAAO,KACtD,IAAK,MAAM,KAAS,EAAQ,CAC1B,MAAM,EAAc,EAAM,WAC1B,IAAK,MAAO,EAAK,KAAU,OAAO,QAAQ,GAAc,CACtD,QAAc,IAAV,EAAqB,SACzB,KAAM,KAAO,GAAS,CACpB,EAAO,GAAO,EACd,EAAQ,GAAO,EACf,QACF,CACA,GAAI,EAAO,KAAS,EAAO,SAE3B,MAAM,EAAS,EAAQ,IAAM,YAAY,MAAQ,KAAK,YAAY,KAC5D,EAAS,EAAM,YAAY,KAC3B,EAAO,EHnhBuB,SGqhBlC,oCAAoC,KAAK,iCAAiC,uBAAyB,SAAc,yEACjH,EACA,KAAK,MAEP,MAAM,IAAI,MAAM,EAClB,CACF,CAMA,OAAO,OAAO,KAAK,WAAuC,EAC5D,CAiBA,qBAAA,CAAsB,GACpB,MAAM,EAAS,KAAK,WASd,EAAS,IAAM,EAAM,YAC3B,IAAK,MAAM,KAAO,OAAO,KAAK,UAAgB,EAAO,GACrD,OAAO,OAAO,EAAQ,EACxB,CAiBA,MAAA,CAAO,GAEL,MAAK,GAAkB,QAEvB,MAAK,EAAmB,IAAI,gBAE5B,KAAK,KAAO,EAEZ,KAAK,OAAS,IAAK,KAAK,iBAAkB,KAAK,WACjD,CAeA,MAAA,GAGE,MAAK,GAAkB,QACvB,MAAK,OAAmB,CAE1B,CAwDA,SAAA,CAA8C,GAC5C,OAAO,KAAK,MAAM,UAAU,EAC9B,CAKA,IAAA,CAAkB,EAAmB,GACnC,KAAK,MAAM,gBAAgB,IAAI,YAAY,EAAW,CAAE,SAAQ,SAAS,IAC3E,CAMA,cAAA,CAA4B,EAAmB,GAC7C,MAAM,EAAQ,IAAI,YAAY,EAAW,CAAE,SAAQ,SAAS,EAAM,YAAY,IAE9E,OADA,KAAK,MAAM,gBAAgB,GACpB,EAAM,gBACf,CAsBA,EAAA,CAA0B,EAAmB,GAC3C,KAAK,MAAM,gBAAgB,UAAU,KAAM,EAAW,EACxD,CAaA,GAAA,CAAc,GACZ,KAAK,MAAM,gBAAgB,YAAY,KAAM,EAC/C,CAoBA,eAAA,CAA6B,EAAmB,GAC9C,KAAK,MAAM,gBAAgB,gBAAgB,EAAW,EACxD,CAoBA,SAAA,CAAuB,EAAmB,GACxC,KAAK,gBAAgB,EAAW,GAChC,KAAK,KAAK,EAAW,EACvB,CAwBA,YAAA,CAAuB,EAAc,EAAmB,MACtD,MAAM,EAAY,KAAK,MAAM,QAAQ,EAAM,GAE3C,OAAO,MAAM,QAAQ,GAAa,EAAU,KAAK,WAAa,CAChE,CAMA,aAAA,GACE,KAAK,MAAM,iBACb,CAOA,oBAAA,GACE,KAAM,MAAgD,wBACxD,CAOA,sBAAA,GACE,KAAK,MAAM,0BACb,CAMA,kBAAA,GACE,KAAK,MAAM,sBACb,CAOA,qBAAA,GACE,KAAK,MAAM,yBACb,CAKA,QAAc,GACZ,OAAO,KAAK,MAAM,MAAQ,EAC5B,CAMA,cAAc,GACZ,OAAO,KAAK,MAAM,YAAc,EAClC,CAKA,WAAc,GACZ,OAAO,KAAK,MAAM,SAAW,EAC/B,CAMA,kBAAc,GACZ,OAAO,KAAK,MAAM,iBAAmB,EACvC,CAYA,eAAc,GACZ,OAAO,KAAK,MAAM,YACpB,CAmBA,oBAAc,GAGZ,OAAO,MAAK,GAAkB,QAAU,KAAK,MAAM,gBACrD,CAMA,aAAc,GACZ,MAAM,EAAY,KAAK,MAAM,YAAY,OAAS,CAAC,EACnD,MAAO,IAAK,KAAuB,EACrC,CAkBA,CAAA,CAAY,EAAa,GACvB,OAAO,KAAK,MAAM,iBAAiB,SAAS,IAAQ,CACtD,CAOA,aAAc,GACZ,MAAA,CAAQ,EAAK,IAAa,KAAK,EAAE,EAAK,EACxC,CAoBA,sBAAc,GACZ,MAAM,EAAO,KAAK,MAAM,iBAAiB,WAAW,MAAQ,iBAG5D,IAAa,IAAT,GAA2B,QAAT,EAAgB,OAAO,EAG7C,IAAa,IAAT,GAA0B,OAAT,EAAe,OAAO,EAG3C,MAAM,EAAO,KAAK,YAClB,OAAI,GAEiB,MADH,iBAAiB,GAAM,iBAAiB,2BAA2B,MAKvF,CAcA,qBAAc,GACZ,MAAM,EAAO,KAAK,YAClB,GAAI,EAAM,CACR,MAAM,EAAc,iBAAiB,GAAM,iBAAiB,4BAA4B,OAClF,EAAS,SAAS,EAAa,IACrC,IAAK,MAAM,GAAS,OAAO,CAC7B,CACA,OAAO,GACT,CAgBA,OAAA,CAAkB,EAAsB,EAA0B,GAEhE,EAAQ,QAAQ,KAAkB,EA9pBzB,QAAQ,WAAY,OAAO,cAiqBpB,aAAZ,EACF,EAAQ,QAAQ,SAAW,GACN,WAAZ,UACF,EAAQ,QAAQ,SAIzB,MAAM,EAAS,MAAK,EAAe,EAAS,QAE7B,IAAX,EAEoB,iBAAX,EACT,EAAiB,EAAS,GACjB,aAAkB,aAC3B,EAAQ,gBAAgB,EAAO,WAAU,IAI3C,EAAQ,UAAY,EAExB,CAOA,EAAA,CAAe,EAA0B,GACvC,YAAuB,IAAnB,EAAqC,EAClC,KAAK,MAAM,YAAY,QAAQ,EACxC,CAgBA,mBAAA,CAA8B,EAAe,GAE3C,EAAK,cAAc,8CAA8C,SAEjE,MAAM,EAAY,SAAS,cAAc,QACzC,EAAU,aAAa,OAAQ,kBAC/B,EAAU,UAAY,iBAElB,GACF,EAAK,aAAa,YAA2B,QAAd,EAAsB,YAAc,cACnE,EAAK,aAAa,YAAa,GAC/B,KAAK,QAAQ,EAAyB,QAAd,EAAsB,UAAY,cAE1D,EAAK,aAAa,YAAa,QAC/B,EAAK,gBAAgB,aACrB,KAAK,QAAQ,EAAW,aAI1B,MAAM,EAAe,EAAK,cAAc,oBAAsB,EAAK,cAAc,kBAOjF,OANI,EACF,EAAK,aAAa,EAAW,GAE7B,EAAK,YAAY,GAGZ,CACT,CAgBA,IAAA,CAAe,EAAwC,QACrC,IAAZ,EAEF,QAAQ,KAAK,EAAiB,EAAiC,EAAS,KAAK,YAAY,GAAI,KAAK,OAGlG,QAAQ,KAAK,GAAG,EAAW,KAAK,YAAY,GAAI,KAAK,SAAS,IAElE,CAMA,eAAA,CAA0B,EAAsB,GAC9C,MAAM,IAAI,MAAM,EAAiB,EAAM,EAAS,KAAK,YAAY,GAAI,KAAK,MAC5E,GCxkCI,iBAAkB,IAAI,QAyC5B,SAAgB,EACd,EACA,EACA,EACA,GAEA,MAAM,OAAE,EAAA,MAAQ,EAAA,SAAO,EAAA,UAAU,GAAc,EACzC,EAAY,GAAS,WAAa,EAClC,EAAoB,GAAS,mBAAqB,EAClD,EAAgB,GAAS,eAAiB,EAC1C,EAAY,EAAW,UAG7B,IApDF,SAAuB,EAAa,GAClC,IAAI,EAAM,EAAgB,IAAI,GAK9B,OAJK,IACH,iBAAM,IAAI,IACV,EAAgB,IAAI,EAAI,KAEtB,EAAI,IAAI,KACZ,EAAI,IAAI,IACD,EACT,CA2CO,CAAc,EAAe,GAEhC,MAAA,OAGF,MAAM,EAAS,EAAW,QACpB,EAAS,EAAW,QAG1B,IAAI,EAAyB,IAAd,GAAyC,IAAtB,EAC9B,GAAO,EACP,EAAuD,KACvD,GAAgB,EA+BpB,SAAS,IAEP,OADA,GAAW,EAjBb,WACE,IAEE,OADA,EAAc,kBAAkB,IACzB,CACT,CAAA,MAOE,OADA,GAAgB,GACT,CACT,CACF,CAKO,IAIL,OACO,IAJL,KACO,EAIX,CAEA,SAAS,IACP,IAAI,EAAJ,CA/FJ,IAAyB,EAAa,EAgGlC,GAAO,EACgB,OAAnB,IACF,aAAa,GACb,EAAiB,MAEnB,EAAc,oBAAoB,cAAe,GACjD,EAAc,oBAAoB,YAAa,GAC/C,EAAc,oBAAoB,gBAAiB,GACnD,EAAc,oBAAoB,qBAAsB,GACxD,SAAS,oBAAoB,UAAW,GAAa,GAzGhC,EA0GL,EA1GkB,EA0GH,EAzGjC,EAAgB,IAAI,IAAK,OAAO,GA0G9B,IACM,EAAc,kBAAkB,IAClC,EAAc,sBAAsB,EAExC,CAAA,MAEA,CAlBU,CAmBZ,CAEA,SAAS,IACH,IACJ,IACA,MACF,CAMA,SAAS,EAAc,GACrB,MAAM,EAAI,EACV,GAAI,EAAE,YAAc,GAAa,EAAM,OAEvC,MAAM,EAAK,EAAE,QAAU,EACjB,EAAK,EAAE,QAAU,EACjB,EAAO,KAAK,KAAK,EAAK,EAAK,EAAK,GAEtC,IAAK,EAAU,CACb,GAAI,EAAoB,EAEtB,OAAI,EAAO,OACT,SAIF,EAGF,GAAI,EAAY,GAAK,EAAO,EAAW,OACvC,IAAK,IAAW,MAClB,CAEA,EAAO,EACT,CAEA,SAAS,EAAY,GACnB,MAAM,EAAI,EACV,GAAI,EAAE,YAAc,GAAa,EAAM,OACvC,MAAM,EAAc,EACpB,IACI,EACF,EAAM,GAEN,KAEJ,CAEA,SAAS,EAAgB,GAEnB,EAAE,YAAc,GAAa,GACjC,GACF,CAEA,SAAS,EAAc,GAEjB,EAAE,YAAc,GAAa,GACjC,GACF,CAEA,SAAS,EAAY,GAEL,WAAV,EAAE,KAAqB,GAAM,GACnC,CAYA,OAPA,EAAc,iBAAiB,cAAe,GAC9C,EAAc,iBAAiB,YAAa,GAC5C,EAAc,iBAAiB,gBAAiB,GAChD,EAAc,iBAAiB,qBAAsB,GACrD,SAAS,iBAAiB,UAAW,GAAa,GAG9C,IACF,IAEI,GAAe,QAIjB,EAAoB,IACtB,EAAiB,WAAA,KACf,EAAiB,KACb,GACJ,KACC,IAGE,EACT,CCxUA,SAAS,IACP,MAAqD,mBAAvC,YAAY,WAAW,WACvC,CA0CA,SAAS,EAAO,EAAe,GAC7B,MAAM,EAAK,SAAS,cAAc,UAKlC,OAJA,EAAG,KAAO,SACV,EAAG,UAAY,uBACf,EAAG,aAAa,aAAc,GAC9B,EAAG,YAAc,EACV,CACT,CAEA,SAAgB,EAAqB,GACnC,MAAM,EAAO,EAAQ,MA5DC,GA6DtB,IAGI,EAHA,EAA8B,KAC9B,EAAiC,KACjC,EAA+B,KAE/B,GAAS,EACT,GAAW,EACf,MAAM,EAAQ,IAAI,gBAElB,SAAS,IACF,GAAW,IAChB,GAAS,EACL,KAAmB,EAAK,cAC5B,EAAK,QAAS,EACd,GAAU,gBAAgB,sBAC1B,EAAW,KACb,CAEA,SAAS,IACH,IAAO,EAAM,MAAQ,OAAO,KAAK,MAAM,EAAQ,QAAQ,KAC7D,CAEA,SAAS,EAAM,GACR,OAAO,SAAS,KACrB,EAAQ,QAAQ,EAAQ,GACxB,IACF,CAsGA,OAfA,SAAS,iBACP,cACC,IACK,GAAU,IAAS,EAAE,eAAe,SAAS,IAAO,KAE1D,CAAE,SAAS,EAAM,OAAQ,EAAM,SAEjC,SAAS,iBACP,UACC,IACkC,WAA5B,EAAoB,KAAkB,KAE7C,CAAE,SAAS,EAAM,OAAQ,EAAM,SAG1B,CACL,WAAI,GACF,OAAO,CACT,EACA,IAAA,CAAK,EAAM,GACT,GAAI,EAAU,OACd,EAAS,EACT,GAAU,gBAAgB,sBAC1B,EAAW,EACX,EAAO,aAAa,qBAAsB,IACrC,IAAM,EA9Gf,WACE,MAAM,EAAK,SAAS,cAAc,OAClC,EAAG,GAAK,EAAQ,GAChB,EAAG,UAAY,mBACf,EAAG,aAAa,UAAW,UAC3B,EAAG,aAAa,OAAQ,SAExB,EAAG,QAAS,EAEZ,MAAM,EAAQ,EAAO,WAAY,KAC3B,EAAO,EAAO,QAAS,KACvB,EAAQ,EAAO,aAAc,SAE7B,EAAQ,SAAS,cAAc,SAoCrC,OAnCA,EAAM,KAAO,SACb,EAAM,UAAY,yBAClB,EAAM,IAAM,IAIZ,EAAM,KAAO,MACb,EAAM,aAAa,aAAc,kBAEjC,EAAM,iBAAiB,QAAA,IAAe,EAAM,EAAQ,QAAQ,GAAU,GAAO,CAAE,OAAQ,EAAM,SAC7F,EAAK,iBAAiB,QAAA,IAAe,EAAM,EAAQ,QAAQ,GAAU,GAAO,CAAE,OAAQ,EAAM,SAC5F,EAAM,iBACJ,QAAA,KAEE,EAAQ,MAAM,GACd,KAEF,CAAE,OAAQ,EAAM,SAElB,EAAM,iBAAiB,SAAA,IAAgB,EAAM,EAAM,eAAgB,CAAE,OAAQ,EAAM,SAKnF,EAAG,iBACD,WACC,IACC,MAAM,EAAQ,EAAiB,cAC3B,aAAgB,OAAS,EAAG,SAAS,IAAO,KAElD,CAAE,OAAQ,EAAM,SAGlB,EAAG,OAAO,EAAO,EAAO,EAAM,GAC9B,EAAQ,EACD,CACT,CA4DsB,IAClB,MAAM,EAAO,EAAQ,QAAQ,IAAS,SAAS,KAC3C,EAAK,aAAe,GAAM,EAAK,YAAY,GAC/C,EAAK,aAAa,aAAc,EAAQ,SAAS,IACjD,IACA,EAAK,QAAS,GACT,GAAU,KAAmB,EAAK,cACvC,GAAS,EAvDb,SAAe,GACb,IAAK,EAAM,OACX,MAAM,EAAI,EAAO,wBACX,EAAM,EAAK,wBACX,EAAA,CAAS,EAAW,IAAgB,KAAK,IAAI,EAAG,KAAK,IAAI,EAAG,EAAM,IAClE,EAAO,EAAM,EAAE,KAAO,EAAE,MAAQ,EAAI,EAAI,MAAQ,EAAG,OAAO,WAAa,EAAI,OAI3E,EAAQ,EAAE,OA5JE,EA6JZ,EAAQ,EAAE,IA7JE,EA6JoB,EAAI,OACpC,EAAO,EAAE,OAAsB,EAAb,EAAI,OAC5B,IAAI,EACmD,GAAlD,GAAQ,EAAQ,EAAI,QAAU,OAAO,YAAmB,GACnD,GAAQ,GAAS,EAAS,EACzB,EAAM,EAAE,IAAM,EAAE,OAAS,EAAI,EAAI,OAAS,EAAG,OAAO,YAAc,EAAI,QAEjF,EAAK,MAAM,KAAO,GAAG,KAAK,MAAM,OAChC,EAAK,MAAM,IAAM,GAAG,KAAK,MAAM,MACjC,CAqCI,CAAM,GACN,GAAO,OACT,EACA,QACA,OAAA,GACE,GAAW,EACX,IACA,EAAM,QACN,GAAM,SACN,EAAO,KACP,EAAQ,IACV,EAEJ,CC5MA,IAAa,EAEL,gBCnBR,SAAS,EAAW,EAAa,GAC/B,GAAK,EACL,IAAK,MAAM,KAAO,EAAO,CACvB,MAAM,EAAQ,EAAM,GACP,MAAT,GAAe,EAAG,aAAa,EAAK,EAC1C,CACF,CAMA,SAAS,EACP,EACA,EACA,GAEA,MAAM,EAAK,SAAS,cAAc,GAGlC,GAFA,EAAW,EAAI,GAEX,EACF,IAAK,MAAM,KAAS,EACL,MAAT,IACiB,iBAAV,EACT,EAAG,YAAY,SAAS,eAAe,IAEvC,EAAG,YAAY,IAKrB,OAAO,CACT,CAKA,SAAS,EAAI,EAAoB,GAC/B,MAAM,EAAK,SAAS,cAAc,OAGlC,OAFI,IAAW,EAAG,UAAY,GAC9B,EAAW,EAAI,GACR,CACT,CAOA,SAAS,EAAO,EAAoB,EAAgC,GAClE,MAAM,EAAK,SAAS,cAAc,UAWlC,OAVA,EAAG,KAAO,SACN,IAAW,EAAG,UAAY,GAC9B,EAAW,EAAI,GACX,IACqB,iBAAZ,EACT,EAAG,YAAc,EAEjB,EAAG,YAAY,IAGZ,CACT,CAQA,IAAM,EAAsB,SAAS,cAAc,YA0BnD,SAAgB,IACd,OAAO,EAAoB,QAAQ,WAAU,EAC/C,CAoBA,SAAgB,EAAa,GAC3B,MAAM,EAAW,SAAS,yBAEpB,EAAO,EAAI,EAAQ,SAAW,GAAG,cAA+B,GAEtE,GAAI,EAAQ,UAAY,EAAQ,UAI1B,EAAQ,aAAa,EAAK,YAAY,EAAQ,aAClD,EAAK,YAAY,EAAQ,eACpB,CAEL,MAAM,EAAiB,EAAI,oBAC3B,EAAe,YAAY,KAC3B,EAAK,YAAY,EACnB,CAGA,OADA,EAAS,YAAY,GACd,CACT,CAyEA,SAAgB,EAAiB,GAC/B,MAAM,EAAS,EAAI,mBAAoB,CAAE,KAAM,eAAgB,KAAM,iBAGrE,GAAI,EAAQ,MAAO,CACjB,MAAM,EAAU,EAAI,mBACpB,EAAQ,YAAc,EAAQ,MAC9B,EAAO,YAAY,EACrB,CAGA,MAAM,EAAU,EAAI,oBAAqB,CACvC,KAAM,gBACN,KAAM,eACN,gCAAiC,KAEnC,EAAO,YAAY,GAGnB,MAAM,EAAU,EAAI,oBAAqB,CAAE,KAAM,gBAAiB,KAAM,iBAGxE,IAAK,MAAM,KAAO,EAAQ,cACpB,EAAI,WACN,EAAQ,YAAY,EAAI,2BAA4B,CAAE,uBAAwB,EAAI,MAItF,IAAK,MAAM,KAAO,EAAQ,WACpB,EAAI,WACN,EAAQ,YAAY,EAAI,2BAA4B,CAAE,uBAAwB,EAAI,MAKtF,MAAM,EACJ,EAAQ,cAAc,KAAM,GAAM,EAAE,YAAc,EAAQ,WAAW,KAAM,GAAM,EAAE,WAG/E,EAAa,EAAQ,YAAoC,IAAvB,EAAQ,WAMhD,GALI,GAAoB,GACtB,EAAQ,YAAY,EAAI,0BAItB,EAAY,CACd,MAAM,EAAY,EAAO,EAAQ,YAAc,yBAA2B,kBAAmB,CAC3F,oBAAqB,GACrB,MAAO,WACP,aAAc,wBACd,eAAgB,OAAO,EAAQ,aAC/B,gBAAiB,mBAEnB,EAAU,QAAQ,KAAO,kBACK,IAA1B,EAAQ,eACV,EAAiB,EAAW,EAAQ,eAEtC,EAAQ,YAAY,EACtB,CAGA,OADA,EAAO,YAAY,GACZ,CACT,CAsCA,SAAS,EAAsB,GAC7B,MAAM,EAAW,EAAO,EAAS,oDAAsD,uBAAwB,CAC7G,KAAM,mBACN,mBAAoB,GACpB,MAAO,cACP,aAAc,cACd,gBAAiB,mBAGnB,OADA,EAAS,YAAc,IAChB,CACT,CAGA,SAAS,IACP,MAAM,EAAc,EAAI,wBAAyB,CAAE,KAAM,sBAEzD,OADA,EAAY,YAAY,GAAsB,IACvC,CACT,CAqCA,SAAS,EACP,EACA,EACA,EACA,GAMA,MAAM,IAAiB,EAAM,QAAU,EAEjC,EAAiB,GAAe,EAEhC,EAAU,EAAI,wBAD2B,EAAM,WAAa,YAAc,KAAK,EAAgB,UAAY,KAAK,EAAiB,oBAAsB,KACzH,CAAE,eAAgB,EAAM,KAE5D,GAAI,EAAc,CAChB,MAAM,EAnDV,SACE,EACA,EACA,GAEA,MAAM,EAAY,EAAO,uBAAwB,CAC/C,gBAAiB,OAAO,EAAM,YAC9B,gBAAiB,eAAe,EAAM,OAIxC,GAFI,GAAe,EAAU,aAAa,gBAAiB,QAEvD,EAAM,KAAM,CACd,MAAM,EAAW,EAAc,OAAQ,CAAE,MAAO,uBAChD,EAAiB,EAAU,EAAM,MACjC,EAAU,YAAY,EACxB,CAGA,MAAM,EAAY,EAAc,OAAQ,CAAE,MAAO,wBAKjD,GAJA,EAAU,YAAc,EAAM,OAAS,GACvC,EAAU,YAAY,IAGjB,EAAe,CAClB,MAAM,EAAc,EAAc,OAAQ,CAAE,MAAO,wBAAyB,YAAa,gBAC9D,IAAvB,EAAQ,YACV,EAAiB,EAAa,EAAQ,YAExC,EAAU,YAAY,EACxB,CACA,OAAO,CACT,CAoBsB,CAAqB,EAAO,EAAS,GACvD,GAAI,EAAgB,CAElB,MAAM,EAAY,EAAI,4BACtB,EAAU,YAAY,GACtB,EAAU,YAAY,GAAsB,IAC5C,EAAQ,YAAY,EACtB,MACE,EAAQ,YAAY,EAExB,MAAW,GAGT,EAAQ,YAAY,KAUtB,OANA,EAAQ,YACN,EAAI,wBAAyB,CAC3B,GAAI,eAAe,EAAM,KACzB,KAAM,kBAGH,CACT,CAqDA,SAAgB,EAAe,GAC7B,MAAM,EAAO,EAAQ,MAAQ,UACvB,EAAO,EAAI,iBAAkB,CAAE,YAAa,IAG5C,EAAc,EAAI,oBACxB,EAAY,YAAY,KAExB,MAAM,EAAU,EAAQ,OAAO,OAAS,EA1D1C,SAAwB,EAA2B,GACjD,MAAM,EAA0C,IAA1B,EAAQ,OAAO,OAC/B,EAAU,EAAc,QAAS,CACrC,MAAO,EAAQ,YAAc,sBAAwB,iBACrD,KAAM,aACN,gBAAiB,EAAQ,SACzB,KAAM,eACN,GAAI,oBAGS,aAAT,EAAsB,CAAE,QAAS,UAAa,CAAC,IAIrD,EAAQ,YACN,EAAI,wBAAyB,CAC3B,qBAAsB,GACtB,uBAA6C,SAArB,EAAQ,SAAsB,QAAU,OAChE,KAAM,SACN,SAAU,KACV,aAAc,yDAYlB,MAAM,GAA0C,IAA5B,EAAQ,iBAA4B,EACpD,EAAQ,kBAAoB,GAC9B,EAAQ,YAAY,KAGtB,MAAM,EAAe,EAAI,yBAA0B,CAAE,KAAM,iBACrD,EAAY,EAAI,iBACtB,IAAK,MAAM,KAAS,EAAQ,OAC1B,EAAU,YAAY,EAAsB,EAAO,EAAS,EAAe,IAI7E,OAFA,EAAa,YAAY,GACzB,EAAQ,YAAY,GACb,CACT,CAa8C,CAAe,EAAS,GAAQ,KAW5E,MARyB,SAArB,EAAQ,UAAuB,GACjC,EAAK,YAAY,GACjB,EAAK,YAAY,KAEjB,EAAK,YAAY,GACb,GAAS,EAAK,YAAY,IAGzB,CACT,CAxZA,EAAoB,UAAY,0nBCnEhC,SAAS,EAAa,GACpB,OAAK,EACe,iBAAT,ENoDb,SAA6B,GAC3B,IAAK,GAAwB,iBAAT,EAAmB,MAAO,GAG9C,IAA0B,IAAtB,EAAK,QAAQ,KAAa,OAAO,EAErC,MAAM,EAAW,SAAS,cAAc,YAKxC,OAJA,EAAS,UAAY,EAErB,EAAa,EAAS,SAEf,EAAS,SAClB,CMhEuC,CAAa,GAE3C,EAAK,UAHM,EAIpB,CAqGA,SAAgB,EAAwB,GAEtC,QAAI,GAAQ,QAAQ,UAGhB,GAAQ,QAAQ,iBAAiB,WAGjC,GAAQ,YAAY,WAGpB,GAAQ,gBAAgB,WAGxB,GAAQ,QAAQ,iBAAiB,UAGjC,GAAQ,QAAQ,2BAGtB,CAYA,SAAgB,EAAsB,GACpC,OAAmC,IAA5B,GAAQ,QAAQ,OACzB,CAggBA,SAAS,EAAS,EAAY,GAC5B,GAAI,EAAY,SAAS,GAAO,OAAO,EACvC,MAAM,EAAO,EAAK,cAClB,OAAO,aAAgB,YAAc,EAAK,OAAS,CACrD,CA8GA,SAAgB,EACd,EACA,EACA,GAEA,MAAM,EAAQ,EAAW,cAAc,mBACjC,EAAS,EAAW,cAAc,wBAClC,EAAY,EAAW,cAAc,mBAC3C,IAAK,IAAU,IAAW,EAExB,MAAA,OAGF,MAAM,EAAW,GAAQ,WAAW,UAAY,QAGhD,IAAI,EAAS,EACT,EAAa,EACb,EAAW,EACX,GAAa,EACb,GAAQ,EACR,EAAkC,KAClC,EAA+C,KAEnD,MAAM,EAAA,IAAqB,EAAU,wBAAwB,MAAQ,GAuB/D,EAAU,IACd,IAAK,EAAY,OACjB,EAAE,iBACF,GAAQ,EAIR,MAAM,EAAqB,SAAb,EAAsB,EAAE,QAAU,EAAS,EAAS,EAAE,QAC9D,EAAW,KAAK,IAAI,EAAU,KAAK,IAzC1B,IAyCwC,EAAa,IAEpE,EAAM,MAAM,MAAQ,GAAG,OAQnB,EAAU,IACd,GAAK,IACL,GAAa,EACb,EAAa,KACb,EAAO,UAAU,OAAO,YACxB,EAAM,MAAM,WAAa,GACzB,SAAS,KAAK,MAAM,OAAS,GAC7B,SAAS,KAAK,MAAM,WAAa,GAE7B,GAAQ,CAEV,MAAM,EAAa,EAAM,wBAAwB,MACjD,EAAS,EACX,GAGI,EAAiB,IACjB,GAGa,IAAb,EAAE,QAAkC,UAAlB,EAAE,cACxB,EAAE,iBACF,GAAa,EACb,GAAQ,EACR,EAAS,EAAE,QACX,EAAa,EAAM,wBAAwB,MAE3C,EAAW,IACX,EAAO,UAAU,IAAI,YACrB,EAAM,MAAM,WAAa,OACzB,SAAS,KAAK,MAAM,OAAS,aAC7B,SAAS,KAAK,MAAM,WAAa,OAEjC,EAAa,EAAiB,EAAG,EAAQ,CACvC,SACA,MAAA,KAGE,MAAM,GAAU,EAChB,GAAQ,GACJ,IA9ER,IAAgB,EAA+B,CAC7C,GAAI,+BACJ,KAjyBiB,GAkyBjB,QAAU,GAAO,EAAG,wBAAwB,MAE5C,QAAA,CAAU,EAAI,KACZ,MAAM,EAAU,KAAK,IAAI,IAAgB,KAAK,IAnBnC,IAmBiD,IAC5D,EAAG,MAAM,MAAQ,GAAG,MACpB,EAAS,IAEX,MAAQ,IACN,EAAG,MAAM,MAAQ,GACjB,EAAS,EAAG,wBAAwB,QAEtC,SAAA,IAAgB,mBAChB,QAAU,GAAO,EAAG,QAAqB,+BAE3C,EAAY,KAAK,EAAO,KA+DtB,SAAA,KAEE,EAAM,MAAM,MAAQ,GAAG,MACvB,GAAO,QAQb,OAHA,EAAO,iBAAiB,cAAe,GAGvC,KACE,EAAO,oBAAoB,cAAe,GAC1C,MACA,EAAa,KACb,GAAa,UACb,EAAc,KAElB,CA4CA,SAAgB,EAAoB,EAAqB,GAEvD,MAAM,EAAqB,EAAM,sBAAsB,OAAS,IAAM,EAAM,qBACtE,EAAmB,EAAM,eAAe,KAAO,EACrD,IAAK,IAAuB,EAAkB,OAE9C,MAAM,EAAc,EAAW,cAAc,sBAC7C,IAAK,EAAa,OAGlB,GAAI,EAAoB,CACtB,IAAK,MAAM,KAAM,EAAM,sBACrB,EAAG,MAAM,QAAU,GACnB,EAAY,YAAY,GAE1B,EAAM,sBAAuB,CAC/B,CAGA,MAAM,EAAiB,IAAI,EAAM,eAAe,UAAU,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MAExG,IAAK,MAAM,KAAW,EAAgB,CAEpC,MAAM,EAAkB,EAAM,sBAAsB,IAAI,EAAQ,IAC5D,IACF,IACA,EAAM,sBAAsB,OAAO,EAAQ,KAI7C,IAAI,EAAY,EAAY,cAAc,yBAAyB,EAAQ,QACtE,IACH,EAAY,SAAS,cAAc,OACnC,EAAU,aAAa,sBAAuB,EAAQ,IACtD,EAAY,YAAY,IAG1B,MAAM,EAAU,EAAQ,OAAO,GAC3B,GACF,EAAM,sBAAsB,IAAI,EAAQ,GAAI,EAEhD,CACF,CAMA,SAAgB,EACd,EACA,EACA,GAEA,GAAK,EAAM,YAEX,IAAK,MAAO,EAAS,KAAU,EAAM,WAAY,CAC/C,MAAM,EAAa,EAAM,iBAAiB,IAAI,GACxC,EAAU,EAAW,cAAc,kBAAkB,OACrD,EAAc,GAAS,cAAc,0BAE3C,IAAK,IAAY,EAAa,SAG9B,EAAQ,UAAU,OAAO,WAAY,GACrC,MAAM,EAAS,EAAQ,cAAc,yBAMrC,GALI,GACF,EAAO,aAAa,gBAAiB,OAAO,IAI1C,GAEE,GAAgC,IAAhC,EAAY,SAAS,OAAc,CAErC,MAAM,EAAU,EAAM,OAAO,GACzB,GACF,EAAM,cAAc,IAAI,EAAS,EAErC,MACK,CAEL,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAY,UAAY,EAC1B,CACF,CACF,CAKA,SAAgB,EAA0B,EAAqB,GAE7D,MAAM,EAAc,EAAW,cAAc,uBACzC,IACF,EAAY,UAAU,OAAO,SAAU,EAAM,aAC7C,EAAY,aAAa,eAAgB,OAAO,EAAM,cAE1D,CAKA,SAAgB,EAAiB,EAAqB,GACpD,MAAM,EAAQ,EAAW,cAAc,mBAClC,IAEL,EAAM,UAAU,OAAO,OAAQ,EAAM,aAGhC,EAAM,cACT,EAAM,MAAM,MAAQ,IAExB,CAGA,IAAM,EAAuB,0BAOzB,EAAoB,EAGxB,SAAgB,IACd,MACiB,oBAAR,KACiB,mBAAjB,IAAI,UACX,IAAI,SAAS,cAAe,EAEhC,CAmCA,SAAgB,EACd,EACA,EACA,EACA,GAEA,MAAM,EAAQ,EAAW,cAAc,mBACvC,GAAK,EAAL,CAOA,GALA,EAAM,iBAAmB,EACzB,EAAM,QAAQ,OAAS,EAAS,SAAW,QAIvC,EAAM,aAAa,YAA2C,mBAAtB,EAAM,YAChD,IACE,EAAM,aACR,CAAA,MAEA,CAGF,GAAI,IAA6B,CAK/B,MAAM,EAAa,GAAG,OAA0B,IAChD,EAAM,mBAAqB,EAC3B,EAAS,MAAM,YAAY,cAAe,GAC1C,EAAM,MAAM,YAAY,kBAAmB,GAC3C,EAAM,MAAM,eAAe,OAC3B,EAAM,MAAM,eAAe,QAC3B,EAAM,MAAM,eAAe,QAC7B,MA9DF,SAAkC,EAAoB,EAAuB,GAC3E,MAAM,EAAO,EAAS,wBAChB,EAAW,EAAM,aAAa,kBAAoB,QAKxD,GAJA,EAAM,MAAM,SAAW,QAGvB,EAAM,MAAM,IAAM,GAAG,KAAK,OAAO,EAAS,EAAK,IAAM,EAAK,QAAU,OACnD,SAAb,EACF,EAAM,MAAM,KAAO,GAAG,KAAK,MAAM,EAAK,UACtC,EAAM,MAAM,MAAQ,WACf,CACL,MAAM,EAAkC,oBAAX,OAAyB,OAAO,WAAa,EAC1E,EAAM,MAAM,KAAO,OACnB,EAAM,MAAM,MAAQ,GAAG,KAAK,MAAM,EAAgB,EAAK,UACzD,CACF,CAgDI,CAAyB,EAAO,EAAU,EA5BhC,CA8Bd,CAkFA,SAAgB,EAAmB,GAEjC,IAAK,MAAM,KAAW,EAAM,uBAAuB,SACjD,IAEF,EAAM,uBAAuB,QAG7B,IAAK,MAAM,KAAW,EAAM,cAAc,SACxC,IAEF,EAAM,cAAc,QAGpB,IAAK,MAAM,KAAW,EAAM,sBAAsB,SAChD,IAEF,EAAM,sBAAsB,QAG5B,EAAM,sBAAuB,CAC/B,CAuEA,SAAS,EACP,EACA,EACA,GAEA,MAAM,OAAqC,IAArB,GAAO,UAA0B,EAAa,EAAM,gBAAa,EACjF,OAA+B,IAAlB,GAAO,OAAuB,EAAa,EAAM,aAAU,EACxE,OAAmC,IAApB,GAAO,SAAyB,EAAa,EAAM,eAAY,EAG9E,EAAiB,IADH,EAAY,QAAQ,iBAAmB,IACnB,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,IAAM,EAAE,OAAS,IAG9E,EAAe,IADH,EAAY,YAAc,IACR,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MAElF,MAAO,CACL,cAAe,CACb,MAAO,EAAY,QAAQ,YAAS,EACpC,UAAW,EAAa,OAAS,EACjC,YAAa,EAAa,YAC1B,gBACA,YAAoD,IAAxC,EAAY,QAAQ,kBAA+D,IAAlC,EAAY,WAAW,OACpF,cAAe,EAAe,IAAK,IAAA,CACjC,GAAI,EAAE,GACN,YAAY,EACZ,YAAa,EAAE,UAEjB,WAAY,IAEd,YAAa,CACX,SAAU,EAAY,WAAW,UAAY,QAC7C,KAAM,EAAY,WAAW,MAAQ,UACrC,YAAa,EAAa,YAC1B,aACA,eAMA,iBACkC,IAAhC,EAAY,QAAQ,UACc,IAAlC,EAAY,WAAW,QACwB,cAA9C,EAAY,WAAW,MAAQ,WAClC,OAAQ,EAAa,IAAK,IAAA,CACxB,GAAI,EAAE,GACN,MAAO,EAAE,MACT,KAAM,EAAa,EAAE,MACrB,WAAY,EAAa,iBAAiB,IAAI,EAAE,QAIxD,CAyEA,SAAgB,EACd,EACA,EACA,EACA,GAGA,MAAM,EAAe,EAAW,cAAc,IAAI,KAC5C,EAAkB,GAAc,cAAc,qBAGpD,IAAK,IAAiB,EACpB,OAzEJ,SACE,EACA,EACA,EACA,GAEA,MAAM,EAAW,EAAwB,GAQnC,EAAyB,GAC/B,IAAK,IAAI,EAAiB,EAAW,WAAY,EAAG,EAAI,EAAE,YACrC,IAAf,EAAE,UAAmB,EAAc,UAAU,SAAS,IAC1D,EAAe,KAAK,GAItB,EAAW,kBAKX,IAAK,MAAM,KAAK,EACd,EAAW,YAAY,GAGzB,GAAI,EAAU,CACZ,MAAM,cAAE,EAAA,YAAe,GAAgB,EAAkB,EAAc,EAAc,GAI/E,EAAW,EAAa,CAC5B,UAAU,EACV,YALkB,EAAsB,GAAe,EAAiB,QAAiB,EAMzF,UALgB,EAAe,KAOjC,EAAW,YAAY,EACzB,KAAO,CACL,MAAM,EAAW,EAAa,CAAE,UAAU,IAC1C,EAAW,YAAY,EACzB,CAEA,OAAO,CACT,CA0BW,CAAwB,EAAY,EAAa,EAAc,GAIxE,EAAgB,SAEhB,MAAM,EAAW,EAAwB,GAKzC,GAFA,EAAa,kBAET,EAAU,CACZ,EAAa,UAAY,GAAG,cAE5B,MAAM,cAAE,EAAA,YAAe,GAAgB,EAAkB,EAAc,EAAc,GAC/E,EAAc,EAAsB,GAAe,EAAiB,QAAiB,EACrF,EAAY,EAAe,GAG3B,EAAe,EAAU,cAAc,qBACzC,GACF,EAAa,YAAY,GAGvB,GAAa,EAAa,YAAY,GAC1C,EAAa,YAAY,EAC3B,MAEE,EAAa,UAAY,EACzB,EAAa,YAAY,GAG3B,OAAO,CACT,CCp2CA,SAAgB,EAAsB,EAAmB,GACvD,IAAI,GAAc,EAclB,MAAM,EAA8B,CAClC,iBAAI,GACF,OAAO,CACT,EACA,cAAA,CAAe,GACb,EAAc,CAChB,EAEA,eAAI,GACF,OAAO,EAAM,WACf,EAEA,oBAAI,GACF,MAAO,IAAI,EAAM,iBACnB,EAEA,aAAA,CAAc,EAAkB,GAC9B,GAA8B,IAA1B,EAAM,WAAW,KAEnB,YADA,ETtCsB,SSsCS,4BAA6B,EAAK,IAKnE,IAAI,EAUJ,QATgB,IAAZ,IACE,EAAM,WAAW,IAAI,GACvB,EAAkB,EAElB,EAAe,EAAsB,eAAe,eAAsB,EAAK,KAK/E,EAAM,aAAe,GAAmB,EAAM,iBAAiB,IAAI,GACrE,OAKF,GAAI,EAAM,aAAe,IAAoB,EAAM,iBAAiB,IAAI,GAEtE,YADA,EAAW,uBAAuB,GAIpC,GAAI,EAAM,YAAa,OAQvB,GANA,EAAM,aAAc,EAMgB,IAAhC,EAAM,iBAAiB,MAAc,EAAM,WAAW,KAAO,EAC/D,GAAI,EACF,EAAM,iBAAiB,IAAI,OACtB,CACL,MAAM,EAAgB,EAAK,iBAAiB,OAAO,WAAW,YAC9D,GAAI,GAAiB,EAAM,WAAW,IAAI,GACxC,EAAM,iBAAiB,IAAI,OACtB,CAEL,MAAM,EADe,IAAI,EAAM,WAAW,UAAU,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MAClE,GAC5B,GACF,EAAM,iBAAiB,IAAI,EAAW,GAE1C,CACF,MACK,GAAI,IAAoB,EAAM,iBAAiB,IAAI,GAAkB,CAE1E,IAAK,MAAM,IAAM,IAAI,EAAM,kBACzB,EAAM,iBAAiB,OAAO,GAEhC,EAAM,iBAAiB,IAAI,EAC7B,CAGA,MAAM,EAAS,EAAK,YAQpB,GAPA,EAA0B,EAAQ,GAClC,EAAiB,EAAQ,GAGzB,EAAmB,EAAQ,EAAO,EAAK,iBAGc,aAAjD,EAAK,iBAAiB,OAAO,WAAW,KAAqB,CAC/D,MAAM,GAAE,EAAA,OAAI,GA5FlB,SAA+B,GAC7B,GAAI,EAAU,MAAO,CAAE,GAAI,EAAU,QAAQ,GAC7C,MAAM,EAAS,EAAK,YAAY,cAAc,uBAC9C,OAAI,EAAe,CAAE,GAAI,EAAQ,QAAQ,GAClC,CAAE,GAAI,EAAK,aAAc,QAAQ,EAC1C,CAuF6B,CAAsB,GAAS,QACtD,EAAsB,EAAQ,EAAO,EAAI,EAC3C,CAGA,EAAK,MAAM,kBAAmB,CAAE,SAAU,EAAW,kBACvD,EAEA,cAAA,GACE,IAAK,EAAM,YAAa,OAGxB,GAAI,EAAK,iBAAiB,OAAO,WAAW,OAAQ,OAGpD,IAAK,MAAM,KAAW,EAAM,cAAc,SACxC,IAEF,EAAM,cAAc,QAGpB,IAAK,MAAM,KAAS,EAAM,WAAW,SACnC,EAAM,YAGR,EAAM,aAAc,EAGpB,MAAM,EAAS,EAAK,YACpB,EAA0B,EAAQ,GAClC,EAAiB,EAAQ,GAG4B,aAAjD,EAAK,iBAAiB,OAAO,WAAW,MD64BlD,SAAsC,EAAqB,GACzD,MAAM,EAAQ,EAAW,cAAc,mBACvC,GAAI,EAAO,CACT,GAAI,EAAM,aAAa,YAA2C,mBAAtB,EAAM,YAChD,IACE,EAAM,aACR,CAAA,MAEA,CAEF,EAAM,MAAM,eAAe,mBAC3B,EAAM,MAAM,eAAe,YAC3B,EAAM,MAAM,eAAe,OAC3B,EAAM,MAAM,eAAe,QAC3B,EAAM,MAAM,eAAe,gBACpB,EAAM,QAAQ,MACvB,CACI,EAAM,mBACR,EAAM,iBAAiB,MAAM,eAAe,eAC5C,EAAM,iBAAmB,MAE3B,EAAM,mBAAqB,IAC7B,CCl6BQ,CAAsB,EAAQ,GAIhC,EAAK,MAAM,mBAAoB,CAAC,EAClC,EAEA,eAAA,CAAgB,GACV,EAAM,YACR,EAAW,iBAEX,EAAW,mBAAc,EAAW,EAExC,EAEA,oBAAA,GACE,IAAK,EAAM,YAAa,OACxB,GAAqD,aAAjD,EAAK,iBAAiB,OAAO,WAAW,KAAqB,OACjE,MAAM,EAAS,EAAM,iBAMrB,GACE,GACA,EAAO,aACP,EAAM,oBACN,EAAO,MAAM,iBAAiB,iBAAmB,EAAM,mBAEvD,OAWF,IAAK,EAAM,oBAAsB,GAAU,EAAO,aAAe,IAAW,EAAK,cAEjD,UADhB,EAAK,YAAY,cAAc,oBAClC,QAAQ,OAAoB,OAQzC,MAAM,EAAQ,EAAK,YAAY,cAAc,uBAC7C,GAAI,GAAS,IAAU,EAAK,aAA5B,CACE,GACE,EAAM,oBACN,KD+3BV,SAAqC,EAAqB,EAAmB,GAC3E,MAAM,EAAa,EAAM,mBACzB,IAAK,EAAY,OAAO,EACxB,MAAM,EAAQ,EAAW,cAAc,mBACvC,IAAK,EAAO,OAAO,EACnB,MAAM,EAAO,EAAM,iBAcnB,GAbI,GAAQ,IAAS,GAAS,EAAK,MAAM,eAAe,eACxD,EAAQ,MAAM,YAAY,cAAe,GACzC,EAAM,MAAM,YAAY,kBAAmB,GAC3C,EAAM,MAAM,eAAe,OAC3B,EAAM,MAAM,eAAe,QAC3B,EAAM,MAAM,eAAe,SAC3B,EAAM,QAAQ,OAAS,QACvB,EAAM,iBAAmB,EAMrB,EAAM,aAAa,YAA2C,mBAAtB,EAAM,YAChD,IACE,EAAM,aACR,CAAA,MAEA,CAEF,OAAO,CACT,CCz5BU,CAAqB,EAAK,YAAa,EAAO,GAE9C,OAEF,EAAsB,EAAK,YAAa,EAAO,GAAO,EAExD,MAEI,IAAW,EAAK,cAGlB,EAAsB,EAAK,YAAa,EAAO,EAAK,cAAc,EAQtE,EAEA,sBAAA,CAAuB,GACrB,MAAM,EAAQ,EAAM,WAAW,IAAI,GACnC,IAAK,EAEH,YADA,EAAe,EAAsB,uBAAuB,eAAwB,EAAK,IAK3F,GAA8B,IAA1B,EAAM,WAAW,KACnB,OAGF,MAAM,EAAS,EAAK,YACd,EAAa,EAAM,iBAAiB,IAAI,GAE9C,GAAI,EAAY,CAEd,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAM,YACN,EAAM,iBAAiB,OAAO,GAC9B,EAA4B,EAAQ,GAAW,EACjD,KAAO,CAEL,IAAK,MAAO,EAAS,KAAe,EAAM,WACxC,GAAI,IAAY,GAAa,EAAM,iBAAiB,IAAI,GAAU,CAChE,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAW,YACX,EAAM,iBAAiB,OAAO,GAC9B,EAA4B,EAAQ,GAAS,GAE7C,MAAM,EAAY,EAAO,cAAc,kBAAkB,8BACrD,IAAW,EAAU,UAAY,GACvC,CAGF,EAAM,iBAAiB,IAAI,GAC3B,EAA4B,EAAQ,GAAW,GA4IvD,SAAuC,EAAqB,EAAmB,GAC7E,MAAM,EAAQ,EAAM,WAAW,IAAI,GACnC,IAAK,GAAO,OAAQ,OAEpB,MAAM,EAAY,EAAW,cAAc,kBAAkB,8BAC7D,IAAK,EAAW,OAEhB,MAAM,EAAU,EAAM,OAAO,GACzB,GACF,EAAM,cAAc,IAAI,EAAW,EAEvC,CAtJQ,CAA8B,EAAQ,EAAO,EAC/C,CAGA,EAAK,MAAM,4BAA6B,CAAE,GAAI,EAAW,UAAW,GACtE,EAEA,cAAA,IACS,IAAI,EAAM,WAAW,UAG9B,iBAAA,CAAkB,GACZ,EAAM,WAAW,IAAI,EAAM,IAC7B,EAAe,EAAsB,eAAe,EAAM,yBAA0B,EAAK,KAG3F,EAAM,WAAW,IAAI,EAAM,GAAI,IAO3B,GAAe,EAAK,aAAa,cACnC,EAAK,uBAET,EAEA,mBAAA,CAAoB,GAElB,GAAI,EAAM,iBAAiB,IAAI,GAAU,CACvC,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,IAE7B,EAAM,iBAAiB,OAAO,EAChC,CAEA,EAAM,WAAW,OAAO,IAEpB,GAAe,EAAK,aAAa,cACnC,EAAK,sBAET,EAEA,kBAAA,IACS,IAAI,EAAM,eAAe,UAGlC,qBAAA,CAAsB,GAChB,EAAM,eAAe,IAAI,EAAQ,IACnC,EAAe,EAA0B,mBAAmB,EAAQ,yBAA0B,EAAK,KAGrG,EAAM,eAAe,IAAI,EAAQ,GAAI,GAEjC,EACF,EAAoB,EAAK,YAAa,GAC7B,EAAK,aAAa,aAG3B,EAAK,uBAET,EAEA,uBAAA,CAAwB,GAEtB,MAAM,EAAU,EAAM,sBAAsB,IAAI,GAC5C,IACF,IACA,EAAM,sBAAsB,OAAO,IAKrC,EADsB,eAAe,IAAI,IAChC,cAET,EAAM,eAAe,OAAO,GAI5B,EADgB,YAAY,cAAc,yBAAyB,QAC/D,QACN,EAEA,mBAAA,IACS,IAAI,EAAM,gBAAgB,UAAU,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,IAAM,EAAE,OAAS,IAGzF,sBAAA,CAAuB,GACjB,EAAM,gBAAgB,IAAI,EAAQ,IACpC,ETxViC,SSwVS,oBAAoB,EAAQ,yBAA0B,EAAK,KAGvG,EAAM,gBAAgB,IAAI,EAAQ,GAAI,IAElC,GAAe,EAAK,aAAa,cACnC,EAAK,uBAET,EAEA,wBAAA,CAAyB,GAEvB,MAAM,EAAU,EAAM,uBAAuB,IAAI,GAC7C,IACF,IACA,EAAM,uBAAuB,OAAO,IAItC,MAAM,EAAU,EAAM,gBAAgB,IAAI,GACtC,GAAS,WACX,EAAQ,YAGV,EAAM,gBAAgB,OAAO,GAEzB,GACF,EAAK,sBAET,GAGF,OAAO,CACT,CAKA,SAAS,EAA4B,EAAqB,EAAmB,GAC3E,MAAM,EAAU,EAAW,cAAc,kBAAkB,OACvD,GACF,EAAQ,UAAU,OAAO,WAAY,EAEzC,KE9ca,EAAb,cAAiC,EAE/B,KAAgB,QAEhB,unOAMA,GACA,GAKA,GACA,GACA,GAMA,GAUA,GACA,IAAqB,EAGrB,YAAI,GACF,YAAuB,IAAhB,MAAK,CACd,CASA,WAAA,CAAY,GACV,GAAI,MAAK,EAAQ,OACjB,MAAM,EHRD,CACL,0BAAY,IAAI,IAChB,8BAAgB,IAAI,IACpB,+BAAiB,IAAI,IACrB,yBAAyB,EACzB,sBAAuB,GACvB,cAAe,KACf,oCAAsB,IAAI,IAC1B,wCAA0B,IAAI,IAC9B,yCAA2B,IAAI,IAC/B,+BAAiB,IAAI,IACrB,mCAAqB,IAAI,IACzB,aAAa,EACb,gCAAkB,IAAI,IACtB,qCAAuB,IAAI,IAC3B,6BAAe,IAAI,IACnB,sCAAwB,IAAI,IAC5B,sBAAsB,EACtB,iBAAkB,KAClB,mBAAoB,MGVpB,MAAK,EAAS,EACd,MAAK,EAAc,EAAsB,EAAO,EAClD,CAGA,cAAI,GACF,OAAO,MAAK,CACd,CAGA,mBAAI,GACF,OAAO,MAAK,CACd,CASA,mBAAI,GACF,QAAO,KAAK,UAAW,KAAK,gBAAgB,WAC9C,CAGA,6BAAI,GACF,OAAO,KAAK,SAAW,KAAK,gBAAgB,iBAAmB,EACjE,CAQA,aAAA,CAAc,EAAkB,GAC9B,KAAK,iBAAiB,cAAc,EAAS,EAC/C,CAGA,cAAA,GACE,KAAK,iBAAiB,gBACxB,CAOA,eAAA,CAAgB,GACd,KAAK,iBAAiB,gBAAgB,EACxC,CAGA,sBAAA,CAAuB,GACrB,KAAK,iBAAiB,uBAAuB,EAC/C,CAGA,aAAA,GACE,OAAO,KAAK,SAAW,KAAK,gBAAgB,gBAAkB,EAChE,CAGA,iBAAA,CAAkB,GACX,KAAK,WACV,KAAK,WAAW,gBAAgB,IAAI,EAAM,IAC1C,KAAK,gBAAgB,kBAAkB,GACzC,CAGA,mBAAA,CAAoB,GACb,KAAK,WACV,KAAK,WAAW,gBAAgB,OAAO,GACvC,KAAK,gBAAgB,oBAAoB,GAC3C,CAGA,iBAAA,GACE,OAAO,KAAK,SAAW,KAAK,gBAAgB,oBAAsB,EACpE,CAGA,qBAAA,CAAsB,GACf,KAAK,WACV,KAAK,WAAW,oBAAoB,IAAI,EAAQ,IAChD,KAAK,gBAAgB,sBAAsB,GAC7C,CAGA,uBAAA,CAAwB,GACjB,KAAK,WACV,KAAK,WAAW,oBAAoB,OAAO,GAC3C,KAAK,gBAAgB,wBAAwB,GAC/C,CAGA,kBAAA,GACE,OAAO,KAAK,SAAW,KAAK,gBAAgB,qBAAuB,EACrE,CAGA,sBAAA,CAAuB,GACrB,KAAK,iBAAiB,uBAAuB,EAC/C,CAGA,wBAAA,CAAyB,GACvB,KAAK,iBAAiB,yBAAyB,EACjD,CAIA,MAAA,CAAgB,GACd,MAAM,OAAO,GAIb,KAAK,YAAY,GAKjB,MAAM,EAAA,IAAsB,KAAK,eACjC,MAAK,EAAsB,EAC3B,EAAK,yBAAyB,kBAAmB,GACjD,EAAK,yBAAyB,wBAAyB,GACvD,EAAK,yBAAyB,sBAAuB,EACvD,CAGA,EAAA,CAAe,GACb,MAAM,EAAO,EAAK,cHiHtB,SAAmC,EAAmB,GACpD,MAAM,EAAW,EAAK,cAAc,mBACpC,IAAK,EAAU,OAGf,IAAK,EAAM,cAAe,CACxB,MAAM,EAAQ,EAAS,aAAa,SAChC,IACF,EAAM,cAAgB,EAE1B,CAGA,MAAM,EAAiB,EAAS,iBAAiB,2BAC7C,EAAe,OAAS,GAA4C,IAAvC,EAAM,sBAAsB,SAC3D,EAAM,sBAAwB,MAAM,KAAK,IAI3C,EAA0B,MAAM,QAAU,MAC5C,CGpII,CAAmB,EAAM,KAAK,YHqKlC,SACE,EACA,EACA,GAGA,MAAM,EAAuB,EAAK,cAAc,kCAChD,IAAK,EAAsB,OAG3B,EAAM,yBAA0B,EAGhC,MAAM,EAAK,4BACX,GAAI,EAAM,0BAA0B,IAAI,GAAK,OAK7C,MAAM,EAAuC,CAC3C,KACA,MAAO,EACP,OALsB,IAAkB,IAAoB,CAOxD,IAEA,KAAO,EAAqB,YAC1B,EAAO,YAAY,EAAqB,YAI1C,MAAA,KACE,KAAO,EAAO,YACZ,EAAqB,YAAY,EAAO,YAG9C,IAGJ,EAAM,gBAAgB,IAAI,EAAI,GAC9B,EAAM,0BAA0B,IAAI,GAGpC,EAAqB,MAAM,QAAU,MACvC,CGhNI,CAAyB,EAAM,KAAK,YH8OxC,SACE,EACA,EACA,GAIA,EAF+B,iBAAiB,gCAE9B,QAAS,IACzB,MAAM,EAAU,EACV,EAAK,EAAQ,aAAa,MAC1B,EAAQ,EAAQ,aAAa,eAAY,EAK/C,IAAK,EAEH,YADA,ERxXiC,SQwXO,oDAAoD,GAAS,OAIvG,MAAM,EAAO,EAAQ,aAAa,cAAW,EACvC,EAAU,EAAQ,aAAa,iBAAc,EAC7C,EAAQ,SAAS,EAAQ,aAAa,UAAY,MAAO,IAG/D,IAAI,EAEJ,MAAM,EAAkB,IAAkB,GAC1C,GAAI,EACF,EAAS,MACJ,CAIL,MAAM,EAAa,EAAQ,UAAU,OACrC,EAAU,IACR,MAAM,EAAU,SAAS,cAAc,OAGvC,OAFA,EAAiB,EAAS,GAC1B,EAAU,YAAY,GACtB,IAAa,EAAQ,SAEzB,CAGA,MAAM,EAAgB,EAAM,WAAW,IAAI,GAO3C,GAAI,IAAkB,EAAM,qBAAqB,IAAI,GAMnD,OALA,EACE,EACA,eAAe,mHAEjB,EAAQ,MAAM,QAAU,QAsB1B,GAAI,EAAe,CACjB,GAAI,EAAiB,CACnB,MAAM,GAAsB,EAAM,yBAAyB,IAAI,GACzD,EACJ,EAAc,QAAU,GACxB,EAAc,QAAU,GACxB,EAAc,OAAS,GACvB,EAAc,UAAY,EAY5B,GAPA,EAAc,OAAS,EACvB,EAAc,MAAQ,EACtB,EAAc,MAAQ,EACtB,EAAc,KAAO,EACrB,EAAc,QAAU,EACxB,EAAM,yBAAyB,IAAI,GAE/B,GAAsB,EAAc,CACtC,MAAM,EAAU,EAAM,cAAc,IAAI,GACpC,IACF,IACA,EAAM,cAAc,OAAO,GAE/B,CACF,CACA,MACF,CAGA,MAAM,EAA6B,CACjC,KACA,QACA,OACA,UACA,QACA,UAGF,EAAM,WAAW,IAAI,EAAI,GACzB,EAAM,qBAAqB,IAAI,GAC3B,GACF,EAAM,yBAAyB,IAAI,GAIrC,EAAQ,MAAM,QAAU,QAE5B,CG5WI,CAAwB,EAAM,KAAK,WAAY,EAAK,+BACtD,CAUA,YAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAC7B,MAAM,EAAQ,KAAK,WACb,EAAW,EAAM,cACjB,EAAiB,EAAM,wBAC7B,MAAK,EAAe,GACpB,MAAM,EAAW,EAAM,cACjB,EAAiB,EAAM,yBAExB,IAAa,GAAc,IAAmB,KACjD,EAAK,sBAKD,EAAK,YAAY,cAAc,uBACjC,EAAmB,GACnB,KAAK,yBAGX,CASA,aAAA,GACE,MAAM,EAAO,KAAK,KACb,GAAS,KAAK,UACnB,MAAK,EAAe,EACtB,CAGA,sBAAA,GACO,KAAK,UACV,EAAmB,KAAK,WAC1B,CAQA,uBAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAAO,EACpC,MAAM,EAAO,EAAK,YACZ,IAAa,EAAK,cAAc,cAChC,IAAiB,EAAK,cAAc,mBACpC,EAA0B,EAAK,iBAAiB,0BAA0B,OAC1E,EAAgB,EAAK,cAAc,oBAA2C,QAAQ,UAAY,QAClG,EAAY,EAAK,cAAc,oBAA2C,QAAQ,MAAQ,UAE1F,EAAQ,EAAK,iBAAiB,MAOpC,OACE,IAPoB,EAAwB,KAQ1C,IAPsB,GAAO,YAAY,QAAU,GAAK,GAQzD,IAPoB,GAAO,YAAY,QAAU,KAOd,GACnC,GAAgB,KAPC,GAAO,WAAW,UAAY,UAQ/C,GAAgB,KAPH,GAAO,WAAW,MAAQ,UAS5C,CAwBA,EAAA,CAAyB,GACvB,MAAM,EAAQ,KAAK,WACb,EAAS,EAAK,aAAa,GAGjC,IAAK,MAAM,IAAW,IAAI,EAAM,WAAW,QACrC,EAAM,qBAAqB,IAAI,IAAY,EAAM,gBAAgB,IAAI,KACzE,EAAM,cAAc,IAAI,EAAxB,KACA,EAAM,cAAc,OAAO,GAC3B,EAAM,WAAW,OAAO,IAG1B,IAAK,MAAM,IAAa,IAAI,EAAM,eAAe,QAC3C,EAAM,oBAAoB,IAAI,KAClC,EAAM,sBAAsB,IAAI,EAAhC,KACA,EAAM,sBAAsB,OAAO,GACnC,EAAM,eAAe,OAAO,IAG9B,MAAM,WAAE,EAAA,eAAY,GAAmB,EAAK,4BAE5C,IAAK,MAAM,KAAS,EAId,EAAM,gBAAgB,IAAI,EAAM,MAChC,EAAM,qBAAqB,IAAI,EAAM,MACvC,EACE,EACA,eAAe,EAAM,sFACrB,GAEF,EAAM,cAAc,IAAI,EAAM,GAA9B,KACA,EAAM,cAAc,OAAO,EAAM,IACjC,EAAM,qBAAqB,OAAO,EAAM,IACxC,EAAM,yBAAyB,OAAO,EAAM,KAE9C,EAAM,WAAW,IAAI,EAAM,GAAI,IAGjC,IAAK,MAAM,KAAW,EAChB,EAAM,oBAAoB,IAAI,EAAQ,MACtC,EAAM,eAAe,IAAI,EAAQ,MACnC,EACE,EACA,mBAAmB,EAAQ,2EAC3B,GAEF,EAAM,sBAAsB,IAAI,EAAQ,GAAxC,KACA,EAAM,sBAAsB,OAAO,EAAQ,KAE7C,EAAM,eAAe,IAAI,EAAQ,GAAI,GAEzC,CAEA,aAAA,CAAuB,GACrB,IAAK,KAAK,SAAU,OACpB,MAAM,EAAQ,KAAK,WAKb,EAAO,KAAK,KACd,IACF,MAAK,EAAe,GACpB,MAAK,EAAyB,IAShC,MAAM,EAAO,KAAK,eAsBlB,GAnBA,EAAO,MAAQ,IAAK,KAAS,EAAO,OACpC,EAAO,MAAM,OAAS,IAAK,EAAK,UAAW,EAAO,MAAM,QAGpD,EAAM,gBAAkB,EAAO,MAAM,OAAO,QAC9C,EAAO,MAAM,OAAO,MAAQ,EAAM,eAIhC,EAAM,uBAAuB,OAAS,IACxC,EAAO,MAAM,OAAO,gBAAkB,EAAM,uBAI1C,EAAM,0BACR,EAAO,MAAM,OAAO,yBAA0B,GAI5C,EAAM,WAAW,KAAO,EAAG,CAC7B,MAAM,EAAS,MAAM,KAAK,EAAM,WAAW,UAC3C,EAAO,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MACrD,EAAO,MAAM,WAAa,CAC5B,CAGA,GAAI,EAAM,eAAe,KAAO,EAAG,CACjC,MAAM,EAAW,MAAM,KAAK,EAAM,eAAe,UACjD,EAAS,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,MAAQ,EAAE,OAAS,MACvD,EAAO,MAAM,eAAiB,CAChC,CAKA,MAAM,EAAc,MAAM,KAAK,EAAM,gBAAgB,UAC/C,EAAyB,KAAK,MAAM,eAAe,OAAO,QAAQ,iBAAmB,GACrF,EAAY,IAAI,IAAI,EAAuB,IAAK,GAAM,EAAE,KACxD,EAAiB,IAAI,GAC3B,IAAK,MAAM,KAAW,EACf,EAAU,IAAI,EAAQ,KACzB,EAAe,KAAK,GAGxB,EAAe,KAAA,CAAM,EAAG,KAAO,EAAE,OAAS,IAAM,EAAE,OAAS,IAC3D,EAAO,MAAM,OAAO,gBAAkB,CACxC,CAcA,qBAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAC7B,MAAM,EAAQ,KAAK,WACF,EACf,EAAK,YACL,EAAK,iBAAiB,MACtB,CAAE,YAAa,EAAM,YAAa,iBAAkB,EAAM,kBAC1D,EAAK,iBAAiB,SAGtB,MAAK,EAAgB,GACrB,KAAK,gBAAgB,gBAAe,GACpC,MAAK,EAAqB,GAE9B,CA2BA,WAAA,GACE,MAAM,EAAO,KAAK,KAClB,IAAK,IAAS,KAAK,SAAU,OAC7B,MAAM,EAAQ,KAAK,WAKnB,MAAK,EAAsB,GAKvB,EAAM,aACR,EAAmB,EAAK,YAAa,GAIlC,EAAM,aAIX,KAAK,gBAAgB,uBACrB,MAAK,EAAuB,IAJ1B,MAAK,GAKT,CAOA,EAAA,CAAsB,GACpB,MAAM,EAAc,EAAK,YAAY,cAAc,qBACnD,IAAK,EAAa,OAElB,MAAM,EAAQ,EAAK,iBAAiB,OAAO,QAAQ,OAAS,KAAK,WAAW,cAE5E,IAAI,EAAU,EAAY,cAAc,oBACpC,GACG,IACH,EAAU,SAAS,cAAc,MACjC,EAAQ,UAAY,kBACpB,EAAQ,aAAa,OAAQ,eAC7B,EAAY,aAAa,EAAS,EAAY,aAEhD,EAAQ,YAAc,GACb,GACT,EAAQ,QAEZ,CAGA,EAAA,CAAuB,GAIgC,aAAjD,EAAK,iBAAiB,OAAO,WAAW,KAIZ,oBAArB,mBACN,MAAK,IACR,MAAK,EAAoB,IAAI,iBAAA,KACtB,KAAK,MAAS,KAAK,UAAa,KAAK,WAAW,YAIrD,KAAK,gBAAgB,uBAHnB,MAAK,OAMN,MAAK,IACR,MAAK,EAAkB,QAAQ,EAAK,YAAa,CAAE,WAAW,EAAM,SAAS,IAC7E,MAAK,GAAqB,IAf1B,MAAK,GAiBT,CAGA,EAAA,GACM,MAAK,GAAqB,MAAK,IACjC,MAAK,EAAkB,aACvB,MAAK,GAAqB,EAE9B,CAeA,EAAA,CAAqB,GACnB,MAAM,EAAQ,KAAK,WACb,EAAa,EAAK,YAClB,EAAc,EAAK,iBAAiB,MAG1C,EAAoB,EAAY,GHgSpC,SACE,EACA,EACA,GAGA,MAAM,EAAiB,GAAQ,QAAQ,iBAAmB,GACpD,EAAgB,IAAI,EAAM,gBAAgB,UAC1C,EAAY,IAAI,IAAI,EAAe,IAAK,GAAM,EAAE,KAChD,EAAc,IAAI,GACxB,IAAK,MAAM,KAAW,EACf,EAAU,IAAI,EAAQ,KACzB,EAAY,KAAK,GAKrB,IAAK,MAAM,KAAW,EAAa,CAEjC,GAAI,EAAM,uBAAuB,IAAI,EAAQ,IAAK,SAClD,IAAK,EAAQ,OAAQ,SAErB,MAAM,EAAO,EAAW,cAAc,0BAA0B,EAAQ,QACxE,IAAK,EAAM,SAEX,MAAM,EAAU,EAAQ,OAAO,GAC3B,GACF,EAAM,uBAAuB,IAAI,EAAQ,GAAI,EAEjD,CACF,CG7TI,CAA4B,EAAY,EAAa,GAGrD,MAAM,EAAe,GAAa,UAC5B,EAAc,GAAc,YAC9B,GAAe,EAAM,WAAW,IAAI,IACtC,EAAM,iBAAiB,IAAI,GAQ7B,MAAM,GACqB,IAAzB,GAAc,QACiB,SAA/B,GAAc,mBACkB,IAA/B,GAAc,mBAA8C,IAAhB,GAA6B,EAAM,WAAW,IAAI,IAC5F,EAAM,aAAe,EAAM,WAAW,KAAO,GAAK,GACrD,KAAK,gBAKH,EAAM,cACR,EAAiB,EAAY,GAC7B,EAAmB,EAAY,GACrB,EAAK,gBACH,EAAK,kBAEjB,EAA0B,EAAY,GAMtC,KAAK,gBAAgB,uBAEzB,CASA,EAAA,CAAgB,GACd,MAAM,EAAa,EAAK,YAClB,EAAc,EAAK,iBAAiB,MACpC,EAAQ,KAAK,YHrEvB,SACE,EACA,EACA,EACA,GAOA,MAAM,EAAU,EAAW,cAAc,sBACrC,GACF,EAAQ,iBAAiB,QAAU,IAClB,EAAE,OAGU,QAAQ,wBAEjC,EAAU,kBAOhB,MAAM,EAAQ,EAAW,cAAc,mBACnC,GAAS,EAAU,cACrB,EAAM,iBAAiB,QAAU,IAChB,EAAE,OACN,QAAQ,uBACjB,EAAU,iBAMhB,MAAM,EAAY,EAAW,cAAc,kBACvC,GACF,EAAU,iBAAiB,QAAU,IAEnC,MAAM,EADS,EAAE,OACK,QAAQ,yBAC9B,GAAI,EAAQ,CAEV,MAAM,EADU,EAAO,QAAQ,mBACJ,aAAa,gBACpC,GACF,EAAU,gBAAgB,EAE9B,GAGN,CGoBI,CAAyB,EAAY,EAAa,EAAO,CACvD,cAAA,IAAqB,KAAK,kBAC1B,gBAAkB,GAAsB,KAAK,uBAAuB,GACpE,aAAA,IAAoB,KAAK,mBAK3B,MAAK,MACL,MAAK,EAAiB,EAAqB,EAAY,EAAc,IACnE,EAAK,aAAa,MAAM,YAAY,yBAA0B,GAAG,SAInE,MAAK,MACL,MAAK,EHRT,SACE,EACA,EACA,EACA,GAEA,MAAM,EAAO,GAAQ,WAAW,KAKhC,GAAa,aAAT,IAAwB,GAAQ,WAAW,oBAE7C,MAAA,OAKF,GAAa,SAAT,EAEF,MAAA,OAGF,MAAM,EAAW,IACf,IAAK,EAAM,YAAa,OAaxB,MAAM,EAAW,EAAM,iBACvB,IAAK,MAAM,KAAQ,EAAE,eAAgB,CACnC,GAAgB,MAAZ,GAAoB,IAAS,EAAU,OAC3C,GACE,aAAgB,UACf,EAAK,WAAW,SAAS,mBAAqB,EAAK,UAAU,yBAC9D,EAAS,EAAM,GAEf,MAEJ,CAEA,KAIF,OADA,SAAS,iBAAiB,YAAa,GACvC,IAAa,SAAS,oBAAoB,YAAa,EACzD,CG9CgC,CAAyB,EAAK,aAAc,EAAa,EAAA,IACnF,KAAK,kBAIP,MAAK,MACL,MAAK,EHqDT,SACE,EACA,EACA,GAGA,GAAgC,SAA5B,GAAQ,WAAW,KAErB,MAAA,OAGF,MAAM,EAAW,IACD,WAAV,EAAE,KAAoB,EAAE,kBACvB,EAAM,aACX,KAIF,OADA,SAAS,iBAAiB,UAAW,GACrC,IAAa,SAAS,oBAAoB,UAAW,EACvD,CGxEiC,CAAmB,EAAa,EAAA,IAAa,KAAK,iBACjF,CAGA,EAAA,GACE,MAAK,MACL,MAAK,OAAiB,EACtB,MAAK,MACL,MAAK,OAAuB,EAC5B,MAAK,MACL,MAAK,OAAwB,CAC/B,CAGA,MAAA,GAKE,MAAM,QACR,CAMA,iBAAA,GACE,MAAK,IACL,MAAK,IACL,MAAK,OAAoB,EAGzB,MAAM,EAAO,KAAK,KACd,GAAQ,MAAK,IACf,EAAK,2BAA2B,mBAChC,EAAK,2BAA2B,yBAChC,EAAK,2BAA2B,uBAChC,MAAK,OAAsB,GAEzB,MAAK,KH8gBb,SAAkC,GAEhC,IAAK,MAAM,KAAW,EAAM,sBAAsB,SAChD,IAEF,EAAM,sBAAsB,QAG5B,IAAK,MAAM,KAAW,EAAM,cAAc,SACxC,IAEF,EAAM,cAAc,QAGpB,IAAK,MAAM,KAAW,EAAM,uBAAuB,SACjD,IAEF,EAAM,uBAAuB,QAG7B,IAAK,MAAM,KAAW,EAAM,gBAAgB,SAC1C,EAAQ,cAIV,GAAI,EAAM,YACR,IAAK,MAAM,KAAa,EAAM,iBAE5B,EADoB,WAAW,IAAI,IAC5B,YAKX,EAAM,aAAc,EACpB,EAAM,iBAAiB,QAGvB,EAAM,WAAW,QACjB,EAAM,eAAe,QACrB,EAAM,gBAAgB,QACtB,EAAM,sBAAwB,GAG9B,EAAM,qBAAqB,QAC3B,EAAM,yBAAyB,QAC/B,EAAM,0BAA0B,QAGhC,EAAM,sBAAuB,CAC/B,CG9jBM,CAAkB,MAAK,GACvB,MAAK,GAAa,gBAAe,GAErC"}