@toolbox-web/grid 3.8.2 → 3.8.3

package/lib/plugins/master-detail/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../../libs/grid/src/lib/core/internal/sanitize.ts","../../../../../../libs/grid/src/lib/core/defaults.ts","../../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/core/plugin/expander-column.ts","../../../../../../libs/grid/src/lib/plugins/master-detail/master-detail.ts","../../../../../../libs/grid/src/lib/plugins/master-detail/master-detail.css?inline","../../../../../../libs/grid/src/lib/plugins/master-detail/master-detail-plugin.ts"],"sourcesContent":["// 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 * 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","/**\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 * 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 * Shared Expander Column Utilities\n *\n * Provides a fixed expander column for plugins that need expand/collapse icons\n * (MasterDetail, Tree, RowGrouping). The column is:\n * - Always first in the grid\n * - Cannot be reordered (lockPosition: true)\n * - Has no header (empty string)\n * - Has no right border (borderless styling)\n * - Narrow width (just fits the icon)\n */\n\nimport type { ColumnConfig } from '../types';\n\n/** Special field name for the expander column */\nexport const EXPANDER_COLUMN_FIELD = '__tbw_expander';\n\n/** Default width for the expander column (pixels) */\nexport const EXPANDER_COLUMN_WIDTH = 32;\n\n/**\n * Marker interface for expander column renderers.\n * Used to detect if expander column is already present.\n */\nexport interface ExpanderColumnRenderer {\n  (ctx: any): HTMLElement;\n  __expanderColumn?: true;\n  /** Plugin name that created this expander */\n  __expanderPlugin?: string;\n}\n\n/**\n * Check if a column is an expander column.\n */\nexport function isExpanderColumn(column: ColumnConfig): boolean {\n  return column.field === EXPANDER_COLUMN_FIELD;\n}\n\n/**\n * Check if a column is a utility column (excluded from selection, clipboard, etc.).\n * Utility columns are non-data columns like expander columns.\n */\nexport function isUtilityColumn(column: ColumnConfig): boolean {\n  return column.utility === true;\n}\n\n/**\n * Find an existing expander column in the column array.\n */\nexport function findExpanderColumn(columns: readonly ColumnConfig[]): ColumnConfig | undefined {\n  return columns.find(isExpanderColumn);\n}\n\n/**\n * Create the base expander column config.\n * Plugins should add their own renderer to customize the expand icon behavior.\n *\n * @param pluginName - Name of the plugin creating the expander (for debugging)\n * @returns Base column config for the expander column\n */\nexport function createExpanderColumnConfig(pluginName: string): ColumnConfig {\n  return {\n    field: EXPANDER_COLUMN_FIELD as any,\n    header: '', // No header text - visually merges with next column\n    width: EXPANDER_COLUMN_WIDTH,\n    resizable: false,\n    sortable: false,\n    filterable: false, // No filter button for expander column\n    lockPosition: true,\n    utility: true, // Marks this as a utility column (excluded from selection, clipboard, etc.)\n    meta: {\n      expanderColumn: true,\n      expanderPlugin: pluginName,\n    },\n  };\n}\n","/**\n * Master/Detail Core Logic\n *\n * Pure functions for managing detail row expansion state.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n// Uses `any` for maximum flexibility with user-defined row types.\n\nimport { setSanitizedHTML } from '../../core/internal/sanitize';\n\n/**\n * Toggle the expansion state of a detail row.\n *\n * **Mutates the input `Set` in place and returns the same reference** (avoids\n * O(n) copy per toggle). Do NOT rely on reference inequality (`result !== input`)\n * to detect change — inspect the returned set's contents instead.\n */\nexport function toggleDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  if (expandedRows.has(row)) {\n    expandedRows.delete(row);\n  } else {\n    expandedRows.add(row);\n  }\n  return expandedRows;\n}\n\n/**\n * Expand a detail row.\n *\n * **Mutates the input `Set` in place and returns the same reference** (avoids\n * O(n) copy). Reference identity is preserved across calls.\n */\nexport function expandDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.add(row);\n  return expandedRows;\n}\n\n/**\n * Collapse a detail row.\n *\n * **Mutates the input `Set` in place and returns the same reference** (avoids\n * O(n) copy). Reference identity is preserved across calls.\n */\nexport function collapseDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.delete(row);\n  return expandedRows;\n}\n\n/**\n * Check if a detail row is expanded.\n */\nexport function isDetailExpanded(expandedRows: Set<object>, row: object): boolean {\n  return expandedRows.has(row);\n}\n\n/**\n * Create a detail element for a given row.\n * The element spans all columns and contains the rendered content.\n *\n * Strings returned by the renderer are passed through `setSanitizedHTML()` —\n * mirroring the cell render path — so a detail template interpolating row data\n * cannot become an XSS sink.\n */\nexport function createDetailElement(\n  row: any,\n  rowIndex: number,\n  renderer: (row: any, rowIndex: number) => HTMLElement | string,\n  columnCount: number,\n): HTMLElement {\n  const detailRow = document.createElement('div');\n  detailRow.className = 'master-detail-row';\n  detailRow.setAttribute('data-detail-for', String(rowIndex));\n  detailRow.setAttribute('role', 'row');\n\n  const detailCell = document.createElement('div');\n  detailCell.className = 'master-detail-cell';\n  detailCell.setAttribute('role', 'cell');\n  detailCell.style.gridColumn = `1 / ${columnCount + 1}`;\n\n  const content = renderer(row, rowIndex);\n  if (typeof content === 'string') {\n    setSanitizedHTML(detailCell, content);\n  } else if (content instanceof HTMLElement) {\n    detailCell.appendChild(content);\n  }\n\n  detailRow.appendChild(detailCell);\n  return detailRow;\n}\n","/**\n * Master-Detail Plugin Styles\n *\n * Scoped to tbw-grid using CSS nesting for light DOM compatibility.\n */\n@layer tbw-plugins {\n  tbw-grid {\n    /* Expander column data cells - always first, borderless right edge */\n    & .cell[data-field='__tbw_expander'] {\n      border-right: none !important;\n      padding: 0;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n    }\n\n    /* Expander column header - completely hidden; the next column's grid-column\n       span is set dynamically by afterRender to cover the expander's track. */\n    & .header-row .cell[data-field='__tbw_expander'] {\n      display: none;\n    }\n\n    /* Master-detail expander cell */\n    .master-detail-expander {\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      width: 100%;\n      height: 100%;\n    }\n\n    .master-detail-toggle {\n      cursor: pointer;\n      opacity: 0.7;\n      user-select: none;\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n    }\n\n    .master-detail-toggle:hover {\n      opacity: 1;\n    }\n\n    /* SC 2.5.8: grow the target, not the box, so the row keeps its height. */\n    .master-detail-toggle {\n      position: relative;\n\n      &::after {\n        content: '';\n        position: absolute;\n        inset-block-start: 50%;\n        inset-inline-start: 50%;\n        translate: -50% -50%;\n        inline-size: var(--tbw-touch-target-min, 24px);\n        block-size: var(--tbw-touch-target-min, 24px);\n      }\n    }\n\n    @media (pointer: coarse) {\n      .master-detail-toggle {\n        min-width: var(--tbw-touch-target-min, 24px);\n        min-height: var(--tbw-touch-target-min, 24px);\n      }\n    }\n\n    .master-detail-row {\n      grid-column: 1 / -1;\n      display: grid;\n      background: var(--tbw-master-detail-bg, var(--tbw-color-row-alt));\n      border-bottom: 1px solid var(--tbw-master-detail-border, var(--tbw-color-border));\n      overflow: hidden;\n    }\n\n    .master-detail-cell {\n      padding: var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));\n      overflow: auto;\n    }\n\n    /* Animation for expanding detail rows */\n    .master-detail-row.tbw-expanding {\n      animation: tbw-detail-expand var(--tbw-animation-duration, 200ms) var(--tbw-animation-easing, ease-out) forwards;\n    }\n\n    /* Animation for collapsing detail rows */\n    .master-detail-row.tbw-collapsing {\n      animation: tbw-detail-collapse var(--tbw-animation-duration, 200ms) var(--tbw-animation-easing, ease-out) forwards;\n    }\n  }\n\n  @keyframes tbw-detail-expand {\n    from {\n      opacity: 0;\n      max-height: 0;\n      padding-top: 0;\n      padding-bottom: 0;\n    }\n    to {\n      opacity: 1;\n      max-height: var(--tbw-detail-max-height, 31.25rem);\n      padding-top: var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));\n      padding-bottom: var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));\n    }\n  }\n\n  @keyframes tbw-detail-collapse {\n    from {\n      opacity: 1;\n      max-height: var(--tbw-detail-max-height, 31.25rem);\n    }\n    to {\n      opacity: 0;\n      max-height: 0;\n    }\n  }\n} /* End @layer tbw-plugins */\n","/**\n * Master/Detail Plugin (Class-based)\n *\n * Enables expandable detail rows showing additional content for each row.\n * Animation style is plugin-configured; respects grid-level animation.mode.\n */\n\nimport { evalTemplateString, sanitizeHTML } from '../../core/internal/sanitize';\nimport { BaseGridPlugin, CellClickEvent, GridElement, RowClickEvent } from '../../core/plugin/base-plugin';\nimport { createExpanderColumnConfig, findExpanderColumn, isExpanderColumn } from '../../core/plugin/expander-column';\nimport type { ColumnConfig, GridHost } from '../../core/types';\nimport type { DataSourceChildrenDetail, FetchChildrenQuery } from '../server-side/datasource-types';\nimport {\n  collapseDetailRow,\n  createDetailElement,\n  expandDetailRow,\n  isDetailExpanded,\n  toggleDetailRow,\n} from './master-detail';\nimport styles from './master-detail.css?inline';\nimport type { DetailExpandDetail, ExpandCollapseAnimation, MasterDetailConfig } from './types';\n\n/**\n * Master-Detail Plugin for tbw-grid\n *\n * Creates expandable detail rows that reveal additional content beneath each master row.\n * Perfect for order/line-item UIs, employee/department views, or any scenario where\n * you need to show related data without navigating away.\n *\n * ## Installation\n *\n * ```ts\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n * ```\n *\n * ## CSS Custom Properties\n *\n * | Property | Default | Description |\n * |----------|---------|-------------|\n * | `--tbw-master-detail-bg` | `var(--tbw-color-row-alt)` | Detail row background |\n * | `--tbw-master-detail-border` | `var(--tbw-color-border)` | Detail row border |\n * | `--tbw-detail-padding` | `1em` | Detail content padding |\n * | `--tbw-animation-duration` | `200ms` | Expand/collapse animation |\n *\n * @example Basic Master-Detail with HTML Template\n * ```ts\n * import '@toolbox-web/grid';\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n *\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'orderId', header: 'Order ID' },\n *     { field: 'customer', header: 'Customer' },\n *     { field: 'total', header: 'Total', type: 'currency' },\n *   ],\n *   plugins: [\n *     new MasterDetailPlugin({\n *       detailRenderer: (row) => `\n *         <div class=\"order-details\">\n *           <h4>Order Items</h4>\n *           <ul>${row.items.map(i => `<li>${i.name} - $${i.price}</li>`).join('')}</ul>\n *         </div>\n *       `,\n *     }),\n *   ],\n * };\n * ```\n *\n * @example Nested Grid in Detail\n * ```ts\n * new MasterDetailPlugin({\n *   detailRenderer: (row) => {\n *     const childGrid = document.createElement('tbw-grid');\n *     childGrid.style.height = '200px';\n *     childGrid.gridConfig = { columns: [...] };\n *     childGrid.rows = row.items || [];\n *     return childGrid;\n *   },\n * })\n * ```\n *\n * @see {@link MasterDetailConfig} for all configuration options\n * @see {@link DetailExpandDetail} for expand/collapse event details\n *\n * @internal Extends BaseGridPlugin\n * @since 0.1.1\n */\nexport class MasterDetailPlugin extends BaseGridPlugin<MasterDetailConfig> {\n  /** @internal */\n  readonly name = 'masterDetail';\n  /** @internal */\n  override readonly styles = styles;\n\n  /**\n   * Optional dependency on ServerSide for async detail data.\n   * When loaded, MasterDetail can fetch detail data via `datasource:fetch-children`.\n   */\n  static override readonly dependencies = [\n    { name: 'serverSide', required: false, reason: 'Fetches detail data via datasource:fetch-children on expand' },\n  ];\n\n  /** Typed internal grid accessor. */\n  get #internalGrid(): GridHost {\n    return this.grid;\n  }\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<MasterDetailConfig> {\n    return {\n      detailHeight: 'auto',\n      expandOnRowClick: false,\n      // Note: showExpandColumn is intentionally NOT defaulted here.\n      // If undefined, processColumns() adds expander only when detailRenderer is provided.\n      // Set to true for framework adapters that register renderers asynchronously.\n      animation: 'slide', // Plugin's own default\n    };\n  }\n\n  // #region Light DOM Parsing\n\n  /**\n   * Called when plugin is attached to the grid.\n   * Parses light DOM for `<tbw-grid-detail>` elements to configure detail templates.\n   * @internal\n   */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    this.parseLightDomDetail();\n\n    // Listen for datasource:children — receive async detail data from ServerSide\n    this.on('datasource:children', (detail: unknown) => {\n      const d = detail as DataSourceChildrenDetail;\n      if (d.context?.source !== 'master-detail') return;\n      d.claimed = true;\n\n      const row = d.context.row;\n      if (row && this.expandedRows.has(row)) {\n        this.detailDataMap.set(row, d.rows);\n        this.loadingDetails.delete(row);\n        // Re-render: remove existing detail element so #syncDetailRows recreates it\n        const existingDetail = this.detailElements.get(row);\n        if (existingDetail) {\n          existingDetail.remove();\n          this.detailElements.delete(row);\n          this.measuredDetailHeights.delete(row);\n        }\n        this.requestRender();\n      }\n    });\n  }\n\n  /**\n   * Parse `<tbw-grid-detail>` elements from the grid's light DOM.\n   *\n   * Allows declarative configuration:\n   * ```html\n   * <tbw-grid [rows]=\"data\">\n   *   <tbw-grid-detail>\n   *     <div class=\"detail-content\">\n   *       <p>Name: {{ row.name }}</p>\n   *       <p>Email: {{ row.email }}</p>\n   *     </div>\n   *   </tbw-grid-detail>\n   * </tbw-grid>\n   * ```\n   *\n   * Attributes:\n   * - `animation`: 'slide' | 'fade' | 'false' (default: 'slide')\n   * - `show-expand-column`: 'true' | 'false' (default: 'true')\n   * - `expand-on-row-click`: 'true' | 'false' (default: 'false')\n   * - `height`: number (pixels) or 'auto' (default: 'auto')\n   */\n  private parseLightDomDetail(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const detailEl = gridEl.querySelector('tbw-grid-detail');\n    if (!detailEl) return;\n\n    // Check if a framework adapter wants to handle this element\n    // (e.g., Angular adapter intercepts for ng-template rendering)\n    const adapter = this.#internalGrid.__frameworkAdapter;\n    if (adapter?.parseDetailElement) {\n      const adapterRenderer = adapter.parseDetailElement(detailEl);\n      if (adapterRenderer) {\n        this.config = { ...this.config, detailRenderer: adapterRenderer };\n        return;\n      }\n    }\n\n    // Parse attributes for configuration\n    const animation = detailEl.getAttribute('animation');\n    const showExpandColumn = detailEl.getAttribute('show-expand-column');\n    const expandOnRowClick = detailEl.getAttribute('expand-on-row-click');\n    const heightAttr = detailEl.getAttribute('height');\n\n    const configUpdates: Partial<MasterDetailConfig> = {};\n\n    if (animation !== null) {\n      configUpdates.animation = animation === 'false' ? false : (animation as 'slide' | 'fade');\n    }\n    if (showExpandColumn !== null) {\n      configUpdates.showExpandColumn = showExpandColumn !== 'false';\n    }\n    if (expandOnRowClick !== null) {\n      configUpdates.expandOnRowClick = expandOnRowClick === 'true';\n    }\n    if (heightAttr !== null) {\n      configUpdates.detailHeight = heightAttr === 'auto' ? 'auto' : parseInt(heightAttr, 10);\n    }\n\n    // Get template content from innerHTML\n    const templateHTML = detailEl.innerHTML.trim();\n    if (templateHTML && !this.config.detailRenderer) {\n      // Create a template-based renderer using the inner HTML\n      configUpdates.detailRenderer = (row: any, _rowIndex: number): string => {\n        // Evaluate template expressions like {{ row.field }}\n        const evaluated = evalTemplateString(templateHTML, { value: row, row });\n        // Sanitize the result to prevent XSS\n        return sanitizeHTML(evaluated);\n      };\n    }\n\n    // Merge updates into config\n    if (Object.keys(configUpdates).length > 0) {\n      this.config = { ...this.config, ...configUpdates };\n    }\n  }\n\n  // #endregion\n\n  // #region Animation Helpers\n\n  /**\n   * Get expand/collapse animation style from plugin config.\n   * Uses base class isAnimationEnabled to respect grid-level settings.\n   */\n  private get animationStyle(): ExpandCollapseAnimation {\n    if (!this.isAnimationEnabled) return false;\n    return this.config.animation ?? 'slide';\n  }\n\n  /**\n   * Apply expand animation to a detail element.\n   * Returns true if animation was applied, false if skipped.\n   * When animated, height measurement is deferred to animationend to avoid\n   * measuring during the max-height: 0 CSS animation constraint.\n   */\n  private animateExpand(detailEl: HTMLElement, row?: any, rowIndex?: number): boolean {\n    if (!this.isAnimationEnabled || this.animationStyle === false) return false;\n\n    detailEl.classList.add('tbw-expanding');\n\n    let measured = false;\n    const measureOnce = () => {\n      if (measured) return;\n      measured = true;\n      detailEl.classList.remove('tbw-expanding');\n\n      // Measure height AFTER animation completes - the element now has its\n      // natural height without the max-height constraint from the animation.\n      if (row !== undefined && rowIndex !== undefined) {\n        this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n      }\n    };\n\n    detailEl.addEventListener('animationend', measureOnce, { once: true });\n    // Fallback timeout in case animationend doesn't fire (e.g., element detached,\n    // animation removed, or framework rendering delays). Matches animateCollapse pattern.\n    setTimeout(measureOnce, this.animationDuration + 50);\n    return true;\n  }\n\n  /**\n   * Apply collapse animation to a detail element and remove after animation.\n   */\n  private animateCollapse(detailEl: HTMLElement, onComplete: () => void): void {\n    if (!this.isAnimationEnabled || this.animationStyle === false) {\n      onComplete();\n      return;\n    }\n\n    detailEl.classList.add('tbw-collapsing');\n    const cleanup = () => {\n      detailEl.classList.remove('tbw-collapsing');\n      onComplete();\n    };\n    detailEl.addEventListener('animationend', cleanup, { once: true });\n    // Fallback timeout in case animation doesn't fire\n    setTimeout(cleanup, this.animationDuration + 50);\n  }\n\n  /**\n   * Measure a detail element's height and update the position cache if it changed.\n   * Used after layout settles (RAF) or after animation completes (animationend).\n   */\n  #measureAndCacheDetailHeight(detailEl: HTMLElement, row: any, rowIndex: number): void {\n    if (!detailEl.isConnected) return;\n\n    const height = detailEl.offsetHeight;\n    if (height > 0) {\n      const previousHeight = this.measuredDetailHeights.get(row);\n      this.measuredDetailHeights.set(row, height);\n\n      // Only invalidate if height actually changed\n      // This triggers an incremental position cache update, not a full rebuild\n      if (previousHeight !== height) {\n        this.grid.invalidateRowHeight(rowIndex);\n      }\n    }\n  }\n\n  // #endregion\n\n  // #region Internal State\n  private expandedRows: Set<any> = new Set();\n  private detailElements: Map<any, HTMLElement> = new Map();\n  /** Cached measured heights - persists even when elements are virtualized out */\n  private measuredDetailHeights: Map<any, number> = new Map();\n  /** Rows that were just expanded by user action and should animate.\n   * Prevents re-animation when rows scroll back into the virtual window. */\n  private rowsToAnimate: Set<any> = new Set();\n  /** Rows currently waiting for datasource:children response. */\n  private loadingDetails: Set<any> = new Set();\n  /** Child rows received via datasource:children, keyed by parent row reference. */\n  private detailDataMap: Map<any, unknown[]> = new Map();\n\n  /** Default height for detail rows when not configured */\n  private static readonly DEFAULT_DETAIL_HEIGHT = 150;\n\n  /**\n   * Get the estimated height for a detail row.\n   * Uses cached measured height when available (survives virtualization).\n   * Avoids reading offsetHeight during CSS animations to prevent poisoning the cache.\n   */\n  private getDetailHeight(row: any): number {\n    // Try DOM element first - works for tests and when element is connected\n    const detailEl = this.detailElements.get(row);\n    if (detailEl) {\n      // Skip DOM measurement if currently animating (max-height constraint gives wrong value)\n      const isAnimating = detailEl.classList.contains('tbw-expanding') || detailEl.classList.contains('tbw-collapsing');\n      if (!isAnimating) {\n        const height = detailEl.offsetHeight;\n        if (height > 0) {\n          // Cache the measurement for when this row is virtualized out\n          this.measuredDetailHeights.set(row, height);\n          return height;\n        }\n      }\n    }\n\n    // DOM element missing, detached, or animating - check cached measurement\n    const cachedHeight = this.measuredDetailHeights.get(row);\n    if (cachedHeight && cachedHeight > 0) {\n      return cachedHeight;\n    }\n\n    // Fallback to config or default\n    return typeof this.config?.detailHeight === 'number'\n      ? this.config.detailHeight\n      : MasterDetailPlugin.DEFAULT_DETAIL_HEIGHT;\n  }\n\n  /**\n   * Toggle a row's detail and emit event.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  private toggleAndEmit(row: any, rowIndex: number): void {\n    // Synthetic rows (e.g., group headers) don't have detail content\n    if (row?.__isGroupRow) return;\n\n    this.expandedRows = toggleDetailRow(this.expandedRows, row as object);\n    const expanded = this.expandedRows.has(row as object);\n    if (expanded) {\n      this.rowsToAnimate.add(row);\n\n      // Request detail data from ServerSide if available and not already cached\n      if (!this.detailDataMap.has(row)) {\n        const isServerSideActive = this.queryBoolean('datasource:is-active');\n        if (isServerSideActive) {\n          this.loadingDetails.add(row);\n          this.grid.query('datasource:fetch-children', {\n            context: { source: 'master-detail', row, rowIndex },\n          } satisfies FetchChildrenQuery);\n        }\n      }\n    } else {\n      this.loadingDetails.delete(row);\n    }\n    this.emit<DetailExpandDetail>('detail-expand', {\n      rowIndex,\n      row: row as Record<string, unknown>,\n      expanded,\n    });\n    this.requestRender();\n  }\n  // #endregion\n\n  // #region Lifecycle\n\n  /** @internal */\n  override detach(): void {\n    this.expandedRows.clear();\n    this.detailElements.clear();\n    this.measuredDetailHeights.clear();\n    this.rowsToAnimate.clear();\n    this.loadingDetails.clear();\n    this.detailDataMap.clear();\n  }\n  // #endregion\n\n  // #region Hooks\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    // Determine whether to add the expander column:\n    // 1. If showExpandColumn === false: never add (explicit opt-out)\n    // 2. If showExpandColumn === true: always add (explicit opt-in, for framework adapters)\n    // 3. If showExpandColumn is undefined: add only if detailRenderer is provided\n    //\n    // This supports React/Angular adapters which register renderers asynchronously via light DOM.\n    // They must set showExpandColumn: true to get the column immediately, avoiding layout shift.\n    const shouldAddExpander =\n      this.config.showExpandColumn === true || (this.config.showExpandColumn !== false && !!this.config.detailRenderer);\n\n    if (!shouldAddExpander) {\n      return [...columns];\n    }\n\n    const cols = [...columns];\n\n    // Check if expander column already exists (from this or another plugin)\n    const existingExpander = findExpanderColumn(cols);\n    if (existingExpander) {\n      // Another plugin already added an expander column - don't add duplicate\n      // Our expand logic will be handled via onCellClick on the expander column\n      return cols;\n    }\n\n    // Create dedicated expander column that stays fixed at position 0\n    const expanderCol = createExpanderColumnConfig(this.name);\n    expanderCol.viewRenderer = (renderCtx) => {\n      const { row } = renderCtx;\n      const isExpanded = this.expandedRows.has(row as object);\n\n      const container = document.createElement('span');\n      container.className = 'master-detail-expander expander-cell';\n\n      // Expand/collapse toggle icon\n      const toggle = document.createElement('span');\n      toggle.className = `master-detail-toggle${isExpanded ? ' expanded' : ''}`;\n      // Use grid-level icons (fall back to defaults)\n      this.setIcon(toggle, isExpanded ? 'collapse' : 'expand');\n      // role=\"button\" is required for aria-expanded to be valid\n      toggle.setAttribute('role', 'button');\n      toggle.setAttribute('tabindex', '0');\n      toggle.setAttribute('aria-expanded', String(isExpanded));\n      toggle.setAttribute('aria-label', isExpanded ? 'Collapse details' : 'Expand details');\n      container.appendChild(toggle);\n\n      return container;\n    };\n\n    // Prepend expander column to ensure it's always first\n    return [expanderCol, ...cols];\n  }\n\n  /** @internal */\n  override onRowClick(event: RowClickEvent): boolean | void {\n    if (!this.config.expandOnRowClick || !this.config.detailRenderer) return;\n    this.toggleAndEmit(event.row, event.rowIndex);\n    return false;\n  }\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean | void {\n    // Handle click on master-detail toggle icon (same pattern as TreePlugin)\n    const target = event.originalEvent?.target as HTMLElement;\n    if (target?.classList.contains('master-detail-toggle')) {\n      this.toggleAndEmit(event.row, event.rowIndex);\n      return true; // Prevent default handling\n    }\n\n    // Sync detail rows after cell click triggers refreshVirtualWindow\n    // This runs in microtask to ensure DOM updates are complete\n    if (this.expandedRows.size > 0) {\n      queueMicrotask(() => this.#syncDetailRows());\n    }\n    return; // Don't prevent default\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    // SPACE toggles expansion when focus is on the expander column\n    if (event.key !== ' ') return;\n\n    const focusCol = this.grid._focusCol;\n    const focusRow = this.grid._focusRow;\n    // _focusCol is a visible-column index (set from data-col), so use visibleColumns\n    const column = this.visibleColumns[focusCol];\n\n    // Only handle SPACE on expander column\n    if (!column || !isExpanderColumn(column)) return;\n\n    const row = this.rows[focusRow];\n    if (!row) return;\n\n    event.preventDefault();\n    this.toggleAndEmit(row, focusRow);\n\n    // Restore focus styling after render completes via render pipeline\n    this.requestRenderWithFocus();\n    return true;\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    this.#fixExpanderHeaderSpan();\n    this.#syncDetailRows();\n  }\n\n  /**\n   * The expander header cell is hidden (display:none), so the next sibling\n   * header cell must span two CSS grid tracks (the expander's + its own)\n   * to keep the header aligned with data rows.  The column position is\n   * computed dynamically so that pinned columns can appear before the expander.\n   */\n  #fixExpanderHeaderSpan(): void {\n    const expanderHeader = this.gridElement?.querySelector(\n      '.header-row .cell[data-field=\"__tbw_expander\"]',\n    ) as HTMLElement | null;\n    if (!expanderHeader) return;\n\n    const colIdx = parseInt(expanderHeader.getAttribute('data-col') || '0', 10);\n    const nextCell = expanderHeader.nextElementSibling as HTMLElement | null;\n    if (nextCell) {\n      // CSS grid columns are 1-based; span from the expander's track to the next cell's track.\n      nextCell.style.gridColumn = `${colIdx + 1} / ${colIdx + 3}`;\n    }\n  }\n\n  /**\n   * Called on scroll to sync detail elements with visible rows.\n   * Removes details for rows that scrolled out of view and reattaches for visible rows.\n   * @internal\n   */\n  override onScrollRender(): void {\n    if (!this.config.detailRenderer || this.expandedRows.size === 0) return;\n    // Full sync needed on scroll to clean up orphaned details\n    this.#syncDetailRows();\n  }\n\n  /**\n   * Full sync of detail rows - cleans up stale elements and creates new ones.\n   * Detail rows are inserted as siblings AFTER their master row to survive row rebuilds.\n   *\n   * PERF: Uses the grid's row pool (_rowPool) and virtual window (_virtualization.start/end)\n   * to avoid querySelectorAll on every scroll frame. The pool is index-aligned with the\n   * virtual window, so pool[i] corresponds to row index (start + i).\n   */\n  #syncDetailRows(): void {\n    const detailRenderer = this.config.detailRenderer;\n    if (!detailRenderer) return;\n\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    const visibleRowMap = this.#collectVisibleRowMap(body);\n    this.#pruneDetachedDetails(visibleRowMap);\n\n    // Insert detail rows for expanded rows that are visible. We also toggle\n    // `.tbw-row-expanded` on every visible master row (matches Tree /\n    // GroupingRows) so devs can style expanded rows via CSS instead of\n    // depending on `[aria-expanded=\"true\"]` (which lives on the toggle\n    // button, not the row). MUST clear on the negative branch — the row\n    // pool recycles elements as the virtual window slides.\n    const columnCount = this.columns.length;\n    for (const [rowIndex, rowEl] of visibleRowMap) {\n      const row = this.rows[rowIndex];\n      if (!row) continue;\n      const isExpanded = this.expandedRows.has(row);\n      rowEl.classList.toggle('tbw-row-expanded', isExpanded);\n      if (!isExpanded) continue;\n\n      // Check if detail already exists for this row\n      const existingDetail = this.detailElements.get(row);\n      if (existingDetail) {\n        // Ensure it's positioned correctly (as next sibling of row element)\n        if (existingDetail.previousElementSibling !== rowEl) {\n          rowEl.after(existingDetail);\n        }\n        continue;\n      }\n\n      this.#insertDetailRow(row, rowIndex, rowEl, columnCount, detailRenderer);\n    }\n  }\n\n  /**\n   * Map visible row index → row element.\n   *\n   * PERF: prefers the grid's index-aligned row pool (`_rowPool[i]` renders row\n   * `_virtualization.start + i`) so no `querySelectorAll` runs per scroll frame;\n   * falls back to a DOM query when the pool is not accessible.\n   */\n  #collectVisibleRowMap(body: Element): Map<number, Element> {\n    const gridInternal = this.grid as any;\n    const rowPool: HTMLElement[] | undefined = gridInternal._rowPool;\n    const visibleStart: number = gridInternal._virtualization?.start ?? 0;\n    const visibleEnd: number = gridInternal._virtualization?.end ?? 0;\n\n    const visibleRowMap = new Map<number, Element>();\n    if (rowPool) {\n      const poolLen = Math.min(rowPool.length, visibleEnd - visibleStart);\n      for (let i = 0; i < poolLen; i++) {\n        const rowEl = rowPool[i];\n        if (rowEl.parentNode === body) {\n          visibleRowMap.set(visibleStart + i, rowEl);\n        }\n      }\n      return visibleRowMap;\n    }\n\n    for (const rowEl of body.querySelectorAll('.data-grid-row')) {\n      const firstCell = rowEl.querySelector('.cell[data-row]');\n      const rowIndex = firstCell ? parseInt(firstCell.getAttribute('data-row') ?? '-1', 10) : -1;\n      if (rowIndex >= 0) {\n        visibleRowMap.set(rowIndex, rowEl);\n      }\n    }\n    return visibleRowMap;\n  }\n\n  /**\n   * Remove detail rows whose master row is no longer visible or no longer\n   * expanded. Iterates the owned `detailElements` map instead of the DOM.\n   */\n  #pruneDetachedDetails(visibleRowMap: Map<number, Element>): void {\n    for (const [row, detailEl] of this.detailElements) {\n      const rowIndex = this.rows.indexOf(row);\n      const isRowVisible = rowIndex >= 0 && visibleRowMap.has(rowIndex);\n      if (this.expandedRows.has(row) && isRowVisible) continue;\n\n      // Clean up framework adapter resources (React root, Vue app, Angular view)\n      // before removing to prevent memory leaks.\n      const adapter = this.#internalGrid.__frameworkAdapter;\n      if (adapter?.unmount) {\n        const detailCell = detailEl.querySelector('.master-detail-cell');\n        const container = detailCell?.firstElementChild as HTMLElement | null;\n        if (container) adapter.unmount(container);\n      }\n      if (detailEl.parentNode) detailEl.remove();\n      this.detailElements.delete(row);\n    }\n  }\n\n  /**\n   * Create a detail element and insert it as the next sibling of its master row.\n   * Animates only when the row was just expanded by a user action — rows\n   * re-appearing from scroll (virtualization) must not re-animate.\n   */\n  #insertDetailRow(\n    row: object,\n    rowIndex: number,\n    rowEl: Element,\n    columnCount: number,\n    detailRenderer: NonNullable<MasterDetailConfig['detailRenderer']>,\n  ): void {\n    const detailEl = createDetailElement(row, rowIndex, detailRenderer, columnCount);\n\n    if (typeof this.config.detailHeight === 'number') {\n      detailEl.style.height = `${this.config.detailHeight}px`;\n    }\n\n    // Insert as sibling after the row element (not as child)\n    rowEl.after(detailEl);\n    this.detailElements.set(row, detailEl);\n\n    const shouldAnimate = this.rowsToAnimate.has(row);\n    if (shouldAnimate) {\n      this.rowsToAnimate.delete(row);\n    }\n\n    // When animating, measurement is deferred to the animationend callback\n    // (inside animateExpand) to avoid measuring during the max-height: 0 constraint.\n    if (shouldAnimate && this.animateExpand(detailEl, row, rowIndex)) return;\n\n    // No animation - measure height after layout settles via RAF\n    requestAnimationFrame(() => {\n      this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n    });\n  }\n\n  /**\n   * Get the height of a specific row, including any expanded detail content.\n   * Always returns a height to ensure the position cache uses plugin-controlled values\n   * rather than stale DOM measurements.\n   *\n   * @param row - The row data\n   * @param _index - The row index (unused, but part of the interface)\n   * @returns The row height in pixels (base height for collapsed, base + detail for expanded)\n   */\n  override getRowHeight(row: unknown, _index: number): number | undefined {\n    const isExpanded = this.expandedRows.has(row as object);\n\n    if (!isExpanded) {\n      // Collapsed row - return undefined to let the grid use its measured/estimated height.\n      // This ensures the position cache uses the correct row height from CSS/config.\n      return undefined;\n    }\n\n    // Row is expanded - return base height plus detail height\n    // Use grid's defaultRowHeight which reflects the actual measured/configured height\n    const baseHeight = this.grid.defaultRowHeight ?? 28;\n    const detailHeight = this.getDetailHeight(row);\n\n    return baseHeight + detailHeight;\n  }\n\n  /**\n   * Adjust the virtualization start index to keep expanded row visible while its detail is visible.\n   * This ensures the detail scrolls smoothly out of view instead of disappearing abruptly.\n   */\n  override adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n    if (this.expandedRows.size === 0) return start;\n\n    // Use position cache for accurate row positions when available (variable heights mode)\n    const positionCache = (this.grid as any)?._virtualization?.positionCache as\n      Array<{ offset: number; height: number }> | undefined;\n\n    let minStart = start;\n\n    if (positionCache && positionCache.length > 0) {\n      // Variable heights: use position cache for accurate offset\n      for (const row of this.expandedRows) {\n        const rowIndex = this.rows.indexOf(row);\n        if (rowIndex < 0 || rowIndex >= start) continue;\n\n        // Position cache already includes cumulative heights from all expanded details\n        const detailBottom = positionCache[rowIndex].offset + positionCache[rowIndex].height;\n\n        if (detailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    } else {\n      // Fixed heights fallback: accumulate detail heights manually\n      // Build sorted list of expanded row indices for cumulative height calculation\n      const expandedIndices: Array<{ index: number; row: any }> = [];\n      for (const row of this.expandedRows) {\n        const index = this.rows.indexOf(row);\n        if (index >= 0) {\n          expandedIndices.push({ index, row });\n        }\n      }\n      expandedIndices.sort((a, b) => a.index - b.index);\n\n      let cumulativeExtraHeight = 0;\n\n      for (const { index: rowIndex, row } of expandedIndices) {\n        const actualRowTop = rowIndex * rowHeight + cumulativeExtraHeight;\n        const detailHeight = this.getDetailHeight(row);\n        const actualDetailBottom = actualRowTop + rowHeight + detailHeight;\n\n        cumulativeExtraHeight += detailHeight;\n\n        if (rowIndex >= start) continue;\n\n        if (actualDetailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    }\n\n    return minStart;\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Expand the detail row at the given index.\n   * @param rowIndex - Index of the row to expand\n   */\n  expand(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.rowsToAnimate.add(row);\n      this.expandedRows = expandDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Collapse the detail row at the given index.\n   * @param rowIndex - Index of the row to collapse\n   */\n  collapse(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row) {\n      this.expandedRows = collapseDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Toggle the detail row at the given index.\n   * @param rowIndex - Index of the row to toggle\n   */\n  toggle(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.expandedRows = toggleDetailRow(this.expandedRows, row);\n      if (this.expandedRows.has(row)) {\n        this.rowsToAnimate.add(row);\n      }\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Check if the detail row at the given index is expanded.\n   * @param rowIndex - Index of the row to check\n   * @returns Whether the detail row is expanded\n   */\n  isExpanded(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? isDetailExpanded(this.expandedRows, row) : false;\n  }\n\n  /**\n   * Expand all detail rows.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  expandAll(): void {\n    for (const row of this.rows) {\n      if (row?.__isGroupRow) continue;\n      this.rowsToAnimate.add(row);\n      this.expandedRows.add(row);\n    }\n    this.requestRender();\n  }\n\n  /**\n   * Collapse all detail rows.\n   */\n  collapseAll(): void {\n    this.expandedRows.clear();\n    this.requestRender();\n  }\n\n  /**\n   * Get the indices of all expanded rows.\n   * @returns Array of row indices that are expanded\n   */\n  getExpandedRows(): number[] {\n    const indices: number[] = [];\n    for (const row of this.expandedRows) {\n      const idx = this.rows.indexOf(row);\n      if (idx >= 0) indices.push(idx);\n    }\n    return indices;\n  }\n\n  /**\n   * Get the detail element for a specific row.\n   * @param rowIndex - Index of the row\n   * @returns The detail HTMLElement or undefined\n   */\n  getDetailElement(rowIndex: number): HTMLElement | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailElements.get(row) : undefined;\n  }\n\n  /**\n   * Get async detail data fetched via `ServerSidePlugin` for a specific row.\n   *\n   * Returns the child rows received from `datasource:children` after a\n   * `datasource:fetch-children` query was fired on expand. Returns `undefined`\n   * when ServerSide is not loaded or data has not arrived yet.\n   *\n   * @param rowIndex - Index of the row\n   * @returns Array of child rows or undefined\n   */\n  getDetailData(rowIndex: number): unknown[] | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailDataMap.get(row) : undefined;\n  }\n\n  /**\n   * Check if detail data is currently being loaded for a row.\n   * @param rowIndex - Index of the row\n   * @returns Whether the detail is loading\n   */\n  isDetailLoading(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? this.loadingDetails.has(row) : false;\n  }\n\n  /**\n   * Re-parse light DOM to refresh the detail renderer.\n   * Call this after framework templates are registered (e.g., Angular ngAfterContentInit).\n   *\n   * This allows frameworks to register templates asynchronously and then\n   * update the plugin's detailRenderer.\n   */\n  refreshDetailRenderer(): void {\n    // Force re-parse by temporarily clearing the renderer\n    const currentRenderer = this.config.detailRenderer;\n    this.config = { ...this.config, detailRenderer: undefined };\n    this.parseLightDomDetail();\n\n    // If no new renderer was found, restore the original\n    if (!this.config.detailRenderer && currentRenderer) {\n      this.config = { ...this.config, detailRenderer: currentRenderer };\n    }\n\n    // Request a COLUMNS phase re-render so processColumns runs again with the new detailRenderer\n    // This ensures the expand toggle is added to the first column.\n    // Must use refreshColumns() (COLUMNS phase) not requestRender() (ROWS phase)\n    // because processColumns only runs at COLUMNS phase or higher.\n    if (this.config.detailRenderer) {\n      const grid = this.#internalGrid;\n      if (typeof grid.refreshColumns === 'function') {\n        grid.refreshColumns();\n      } else {\n        // Fallback to requestRender if refreshColumns not available\n        this.requestRender();\n      }\n    }\n  }\n  // #endregion\n}\n"],"mappings":"AAMA,IAAM,EAAU,qBACV,EAAiB,eACjB,EAAY,+BAKZ,EACJ,4SACG,MAAM,KACN,IAAK,GAAM,EAAE,MAAM,IAAI,UAAU,KAAK,KACrC,EAAY,IAAI,OAAO,uCAAuC,EAAG,MAAM,GAAG,KAAK,gBA0BrF,IAAM,EAAiB,IAAI,IACzB,2KAA2K,MACzK,MAOE,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,CA6FA,SAAS,EAAS,EAAc,GAC9B,MAAM,EApER,SAAkB,GAChB,MAAM,EAAkB,GACxB,IAAI,EAAI,EACR,KAAO,EAAI,EAAK,QAAQ,CACtB,MAAM,EAAK,EAAK,GAChB,GAAW,MAAP,EAAJ,CAMA,GAAK,GAAM,KAAO,GAAM,KAAgB,MAAP,GAAc,EAAI,EAAI,EAAK,QAAU,EAAK,EAAI,IAAM,KAAO,EAAK,EAAI,IAAM,IAAM,CAC/G,MAAM,EAAQ,EACd,KAAO,EAAI,EAAK,SAAY,EAAK,IAAM,KAAO,EAAK,IAAM,KAAoB,MAAZ,EAAK,KAAa,IACnF,EAAO,KAAK,CAAE,KAAM,MAAO,EAAG,OAAO,EAAK,MAAM,EAAO,MACvD,QACF,CAGA,GAAW,MAAP,EAAY,CACd,IAAI,EAAI,GAER,IADA,IACO,EAAI,EAAK,QAAsB,MAAZ,EAAK,IAAY,GAAK,EAAK,KACrD,GAAI,GAAK,EAAK,OAAQ,OAAO,KAC7B,IACA,EAAO,KAAK,CAAE,KAAM,MAAO,EAAG,IAC9B,QACF,CAGA,GAAK,GAAM,KAAO,GAAM,KAAS,GAAM,KAAO,GAAM,KAAe,MAAP,GAAqB,MAAP,EAAY,CACpF,MAAM,EAAQ,EACd,KAAO,EAAI,EAAK,QAAU,SAAS,KAAK,EAAK,KAAK,IAClD,EAAO,KAAK,CAAE,KAAM,KAAM,EAAG,EAAK,MAAM,EAAO,KAC/C,QACF,CAGA,GAAI,EAAI,EAAI,EAAK,OAAQ,CACvB,MAAM,EAAM,EAAK,MAAM,EAAG,EAAI,GAC9B,GAAY,QAAR,GAAyB,QAAR,EAAe,CAClC,EAAO,KAAK,CAAE,KAAM,KAAM,EAAG,IAC7B,GAAK,EACL,QACF,CACF,CACA,GAAI,EAAI,EAAI,EAAK,OAAQ,CACvB,MAAM,EAAK,EAAK,MAAM,EAAG,EAAI,GAC7B,GAAW,OAAP,GAAsB,OAAP,GAAsB,OAAP,GAAsB,OAAP,GAAsB,OAAP,GAAsB,OAAP,EAAa,CAC1F,EAAO,KAAK,CAAE,KAAM,KAAM,EAAG,IAC7B,GAAK,EACL,QACF,CACF,CAGA,IAAI,gBAAgB,SAAS,GAM7B,OAAO,KALL,EAAO,KAAK,CAAE,KAAM,KAAM,EAAG,IAC7B,GAlDF,MAFE,GAyDJ,CACA,OAAO,CACT,CAGe,CAAS,GACtB,IAAK,EAAM,OACX,MAAM,EAAkB,EACxB,IAAI,EAAM,EAEV,SAAS,IACP,OAAO,EAAO,EAChB,CACA,SAAS,IACP,OAAO,EAAO,IAChB,CACA,SAAS,EAAM,EAAc,GAC3B,MAAM,EAAI,IACV,QAAK,IACD,EAAE,OAAS,SACH,IAAR,GAAqB,EAAE,IAAM,GAEnC,CAkBA,SAAS,IACP,MAAM,EAYR,WACE,IAAI,EAAO,IACX,KAAO,EAAM,KAAM,OACjB,IACA,EAAO,GAAQ,IAEjB,OAAO,CACT,CAnBiB,GACf,GAAI,EAAM,KAAM,KAAM,CACpB,IACA,MAAM,EAAa,IACnB,IAAK,EAAM,KAAM,KAAM,OACvB,IACA,MAAM,EAAY,IAClB,OAAO,EAAS,EAAa,CAC/B,CACA,OAAO,CACT,CAWA,SAAS,IACP,IAAI,EAAO,IACX,KAAO,EAAM,KAAM,OACjB,IACA,EAAO,GAAQ,IAEjB,OAAO,CACT,CAEA,SAAS,IACP,IAAI,EAAO,IACX,OAAa,CACX,MAAM,EAAI,IACV,IAAK,GAAgB,OAAX,EAAE,KAAe,MAC3B,GAAY,QAAR,EAAE,EACJ,IACA,EAAO,IAAS,SACX,GAAY,QAAR,EAAE,EACX,IACA,EAAO,IAAS,SACX,GAAY,OAAR,EAAE,EACX,IACA,EAAO,GAAQ,QACV,IAAY,OAAR,EAAE,EAGN,MAFL,IACA,EAAO,GAAQ,GACV,CACT,CACA,OAAO,CACT,CAEA,SAAS,IACP,IAAI,EAAO,IACX,OAAa,CACX,MAAM,EAAI,IACV,IAAK,GAAgB,OAAX,EAAE,KAAe,MAC3B,GAAY,MAAR,EAAE,EACJ,IACA,EAAQ,EAAmB,SACtB,GAAY,MAAR,EAAE,EACX,IACA,EAAQ,EAAmB,SACtB,GAAY,OAAR,EAAE,EACX,IACA,EAAQ,GAAoB,QACvB,IAAY,OAAR,EAAE,EAGN,MAFL,IACA,EAAQ,GAAoB,GACvB,CACT,CACA,OAAO,CACT,CAEA,SAAS,IACP,IAAI,EAAO,IACX,OAAa,CACX,MAAM,EAAI,IACV,IAAK,GAAgB,OAAX,EAAE,KAAe,MAC3B,GAAY,MAAR,EAAE,EACJ,IACA,GAA2B,QACtB,IAAY,MAAR,EAAE,EAGN,MAFL,IACA,GAA2B,GACtB,CACT,CACA,OAAO,CACT,CAEA,SAAS,IACP,IAAI,EAAO,IACX,OAAa,CACX,MAAM,EAAI,IACV,IAAK,GAAgB,OAAX,EAAE,KAAe,MAC3B,GAAY,MAAR,EAAE,EACJ,IACA,GAA2B,SACtB,GAAY,MAAR,EAAE,EACX,IACA,GAA2B,QACtB,IAAY,MAAR,EAAE,EAGN,MAFL,IACA,GAA2B,GACtB,CACT,CACA,OAAO,CACT,CAEA,SAAS,IACP,OAAI,EAAM,KAAM,MACd,KACQ,KAEH,GACT,CAEA,SAAS,IACP,MAAM,EAAI,IACV,GAAK,EAAL,CACA,GAAe,QAAX,EAAE,KAEJ,OADA,IACO,EAAE,EAEX,GAAe,QAAX,EAAE,KAEJ,OADA,IACO,EAAE,EAEX,GAAe,OAAX,EAAE,KAEJ,OADA,IAlJJ,SAAmB,GACjB,GAAa,UAAT,EAAkB,OAAO,EAAI,MACjC,GAAI,EAAK,WAAW,QAAS,CAC3B,MAAM,EAAM,EAAK,MAAM,GACvB,OAAO,EAAI,IAAM,EAAI,IAAI,QAAO,CAClC,CACA,GAAI,EAAK,WAAW,gBAAiB,CACnC,MAAM,EAAM,EAAK,MAAM,IACvB,OAAO,EAAI,YAAc,EAAI,YAAY,QAAO,CAClD,CAEA,MAAa,QAAT,EAAuB,EAAI,IAClB,gBAAT,EAA+B,EAAI,iBAAvC,CAEF,CAqIW,CAAU,EAAE,GAErB,GAAe,OAAX,EAAE,MAAyB,MAAR,EAAE,EAAW,CAClC,IACA,MAAM,EAAS,IAEf,OADI,EAAM,KAAM,MAAM,IACf,CACT,CAEA,MAAe,OAAX,EAAE,MAAyB,MAAR,EAAE,GACvB,KACS,UAFX,CApBe,CAyBjB,CAEA,MAAM,EAAS,IAEf,OAAI,EAAM,EAAO,YAAjB,EACO,CACT,CAGA,SAAgB,EAAmB,EAAa,GAC9C,IAAK,IAA6B,IAAtB,EAAI,QAAQ,MAAc,OAAO,EAC7C,MAAM,EAA4C,GAS5C,GA4Ca,EApDD,EAAI,QAAQ,EAAA,CAAU,EAAI,KAC1C,MAAM,EAiBV,SAAoB,EAAc,GAEhC,KADA,GAAQ,GAAQ,IAAI,QACT,OAAO,EAClB,GAAI,EAAc,KAAK,GAAO,OAAO,EACrC,GAAa,UAAT,EAAkB,OAAoB,MAAb,EAAI,MAAgB,EAAiB,OAAO,EAAI,OAC7E,GAAI,EAAK,WAAW,UAAY,QAAQ,KAAK,KAAU,EAAK,SAAS,KAAM,CACzE,MAAM,EAAM,EAAK,MAAM,GACjB,EAAI,EAAI,IAAM,EAAI,IAAI,QAAO,EACnC,OAAY,MAAL,EAAY,EAAiB,OAAO,EAC7C,CACA,GAAI,EAAK,WAAW,kBAAoB,QAAQ,KAAK,KAAU,EAAK,SAAS,KAAM,CACjF,MAAM,EAAM,EAAK,MAAM,IACjB,EAAI,EAAI,YAAc,EAAI,YAAY,QAAO,EACnD,OAAY,MAAL,EAAY,EAAiB,OAAO,EAC7C,CACA,GAAI,EAAK,OAAS,GAAI,OAAO,EAC7B,IAAK,EAAU,KAAK,IAAS,EAAU,KAAK,GAAO,OAAO,EAC1D,MAAM,EAAW,EAAK,MAAM,OAC5B,GAAI,GAAY,EAAS,OAAS,EAAG,OAAO,EAC5C,IACE,MAAM,EAAM,EAAS,EAAM,GACrB,EAAa,MAAP,EAAc,GAAK,OAAO,GACtC,OAAI,EAAc,KAAK,GAAa,EAC7B,GAAO,CAChB,CAAA,MACE,OAAO,CACT,CACF,CA5CgB,CAAW,EAAM,GAK7B,OAJA,EAAM,KAAK,CAAE,KAAM,EAAK,OAAQ,OAAQ,IAIjC,IAAQ,EAAiB,GAldT,EAkd0B,IAjdtB,iBAAT,EACb,EACJ,QAAQ,KAAM,SACd,QAAQ,KAAM,QACd,QAAQ,KAAM,QACd,QAAQ,KAAM,UACd,QAAQ,KAAM,SAN6B,GADhD,IAA2B,IAigBpB,EACE,EAAE,QAAQ,IAAI,OAAO,EAAgB,KAAM,IAAI,QAAQ,kDAAmD,IADlG,GADjB,IAAqB,EAxCnB,MAAM,EAAW,EAAM,QAAU,EAAM,MAAO,GAAmB,KAAb,EAAE,QAAiB,EAAE,SAAW,GAEpF,OADqB,EAAc,KAAK,IACpB,EAAiB,GAC9B,CACT,CAkCA,IAAM,EAAgB,wBCnetB,IAAa,EAA0C,CACrD,OAAQ,IACR,SAAU,IACV,QAAS,IACT,SAAU,IACV,SAAU,IACV,aAAc,IACd,WAAY,KACZ,UAAW,IACX,OAAQ,GACR,aAAc,GACd,MAAO,OCpCT,SAAgB,EAAW,EAAiB,GAG1C,MAAO,YAFI,EAAS,IAAI,IAAW,KACpB,EAAa,IAAI,IAAe,KAEjD,CA6NA,SAAgB,EAAiB,EAAsB,EAAiB,EAAiB,GAEvF,MAAO,GADQ,EAAW,EAAQ,MACd,MAAS,uBApB/B,SAAiB,GACf,MAAO,qCAAgB,EAAK,eAC9B,CAkB4D,CAAQ,IACpE,CC6LA,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,EDpgBuB,SCsgBlC,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,GCjrCW,EAAwB,iBAmBrC,SAAgB,EAAiB,GAC/B,OAAO,EAAO,QAAU,CAC1B,CClBA,SAAgB,EAAgB,EAA2B,GAMzD,OALI,EAAa,IAAI,GACnB,EAAa,OAAO,GAEpB,EAAa,IAAI,GAEZ,CACT,KE8Da,EAAb,MAAa,UAA2B,EAEtC,KAAgB,eAEhB,s8DAMA,oBAAwC,CACtC,CAAE,KAAM,aAAc,UAAU,EAAO,OAAQ,gEAIjD,KAAI,GACF,OAAO,KAAK,IACd,CAGA,iBAAuB,GACrB,MAAO,CACL,aAAc,OACd,kBAAkB,EAIlB,UAAW,QAEf,CASA,MAAA,CAAgB,GACd,MAAM,OAAO,GACb,KAAK,sBAGL,KAAK,GAAG,sBAAwB,IAC9B,MAAM,EAAI,EACV,GAA0B,kBAAtB,EAAE,SAAS,OAA4B,OAC3C,EAAE,SAAU,EAEZ,MAAM,EAAM,EAAE,QAAQ,IACtB,GAAI,GAAO,KAAK,aAAa,IAAI,GAAM,CACrC,KAAK,cAAc,IAAI,EAAK,EAAE,MAC9B,KAAK,eAAe,OAAO,GAE3B,MAAM,EAAiB,KAAK,eAAe,IAAI,GAC3C,IACF,EAAe,SACf,KAAK,eAAe,OAAO,GAC3B,KAAK,sBAAsB,OAAO,IAEpC,KAAK,eACP,GAEJ,CAuBA,mBAAA,GACE,MAAM,EAAS,KAAK,YACpB,IAAK,EAAQ,OAEb,MAAM,EAAW,EAAO,cAAc,mBACtC,IAAK,EAAU,OAIf,MAAM,EAAU,MAAK,EAAc,mBACnC,GAAI,GAAS,mBAAoB,CAC/B,MAAM,EAAkB,EAAQ,mBAAmB,GACnD,GAAI,EAEF,YADA,KAAK,OAAS,IAAK,KAAK,OAAQ,eAAgB,GAGpD,CAGA,MAAM,EAAY,EAAS,aAAa,aAClC,EAAmB,EAAS,aAAa,sBACzC,EAAmB,EAAS,aAAa,uBACzC,EAAa,EAAS,aAAa,UAEnC,EAA6C,CAAC,EAElC,OAAd,IACF,EAAc,UAA0B,UAAd,GAAiC,GAEpC,OAArB,IACF,EAAc,iBAAwC,UAArB,GAEV,OAArB,IACF,EAAc,iBAAwC,SAArB,GAEhB,OAAf,IACF,EAAc,aAA8B,SAAf,EAAwB,OAAS,SAAS,EAAY,KAIrF,MAAM,EAAe,EAAS,UAAU,OACpC,IAAiB,KAAK,OAAO,iBAE/B,EAAc,eAAA,CAAkB,EAAU,IP1IhD,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,COkIe,CAFW,EAAmB,EAAc,CAAE,MAAO,EAAK,UAOjE,OAAO,KAAK,GAAe,OAAS,IACtC,KAAK,OAAS,IAAK,KAAK,UAAW,GAEvC,CAUA,kBAAY,GACV,QAAK,KAAK,qBACH,KAAK,OAAO,WAAa,QAClC,CAQA,aAAA,CAAsB,EAAuB,EAAW,GACtD,IAAK,KAAK,qBAA8C,IAAxB,KAAK,eAA0B,OAAO,EAEtE,EAAS,UAAU,IAAI,iBAEvB,IAAI,GAAW,EACf,MAAM,EAAA,KACA,IACJ,GAAW,EACX,EAAS,UAAU,OAAO,sBAId,IAAR,QAAkC,IAAb,GACvB,MAAK,EAA6B,EAAU,EAAK,KAQrD,OAJA,EAAS,iBAAiB,eAAgB,EAAa,CAAE,MAAM,IAG/D,WAAW,EAAa,KAAK,kBAAoB,KAC1C,CACT,CAKA,eAAA,CAAwB,EAAuB,GAC7C,IAAK,KAAK,qBAA8C,IAAxB,KAAK,eAEnC,YADA,IAIF,EAAS,UAAU,IAAI,kBACvB,MAAM,EAAA,KACJ,EAAS,UAAU,OAAO,kBAC1B,KAEF,EAAS,iBAAiB,eAAgB,EAAS,CAAE,MAAM,IAE3D,WAAW,EAAS,KAAK,kBAAoB,GAC/C,CAMA,EAAA,CAA6B,EAAuB,EAAU,GAC5D,IAAK,EAAS,YAAa,OAE3B,MAAM,EAAS,EAAS,aACxB,GAAI,EAAS,EAAG,CACd,MAAM,EAAiB,KAAK,sBAAsB,IAAI,GACtD,KAAK,sBAAsB,IAAI,EAAK,GAIhC,IAAmB,GACrB,KAAK,KAAK,oBAAoB,EAElC,CACF,CAKA,4BAAiC,IAAI,IACrC,8BAAgD,IAAI,IAEpD,qCAAkD,IAAI,IAGtD,6BAAkC,IAAI,IAEtC,8BAAmC,IAAI,IAEvC,6BAA6C,IAAI,IAGjD,6BAAgD,IAOhD,eAAA,CAAwB,GAEtB,MAAM,EAAW,KAAK,eAAe,IAAI,GACzC,GAAI,IAEkB,EAAS,UAAU,SAAS,mBAAoB,EAAS,UAAU,SAAS,kBAC9E,CAChB,MAAM,EAAS,EAAS,aACxB,GAAI,EAAS,EAGX,OADA,KAAK,sBAAsB,IAAI,EAAK,GAC7B,CAEX,CAIF,MAAM,EAAe,KAAK,sBAAsB,IAAI,GACpD,OAAI,GAAgB,EAAe,EAC1B,EAImC,iBAA9B,KAAK,QAAQ,aACvB,KAAK,OAAO,aACZ,EAAmB,qBACzB,CAMA,aAAA,CAAsB,EAAU,GAE9B,GAAI,GAAK,aAAc,OAEvB,KAAK,aAAe,EAAgB,KAAK,aAAc,GACvD,MAAM,EAAW,KAAK,aAAa,IAAI,GACnC,GACF,KAAK,cAAc,IAAI,GAGlB,KAAK,cAAc,IAAI,IACC,KAAK,aAAa,0BAE3C,KAAK,eAAe,IAAI,GACxB,KAAK,KAAK,MAAM,4BAA6B,CAC3C,QAAS,CAAE,OAAQ,gBAAiB,MAAK,gBAK/C,KAAK,eAAe,OAAO,GAE7B,KAAK,KAAyB,gBAAiB,CAC7C,WACK,MACL,aAEF,KAAK,eACP,CAMA,MAAA,GACE,KAAK,aAAa,QAClB,KAAK,eAAe,QACpB,KAAK,sBAAsB,QAC3B,KAAK,cAAc,QACnB,KAAK,eAAe,QACpB,KAAK,cAAc,OACrB,CAMA,cAAA,CAAwB,GAWtB,MAFmC,IAAjC,KAAK,OAAO,mBAA+D,IAAjC,KAAK,OAAO,kBAAgC,KAAK,OAAO,gBAGlG,MAAO,IAAI,GAGb,MAAM,EAAO,IAAI,GAIjB,GHhYJ,SAAmC,GACjC,OAAO,EAAQ,KAAK,EACtB,CG6X6B,CAAmB,GAI1C,OAAO,EAIT,MAAM,GH5XiC,EG4XQ,KAAK,KH3X/C,CACL,MAAO,EACP,OAAQ,GACR,MAAA,GACA,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,KAAM,CACJ,gBAAgB,EAChB,eAAgB,KAZtB,IAA2C,EGoZvC,OAvBA,EAAY,aAAgB,IAC1B,MAAM,IAAE,GAAQ,EACV,EAAa,KAAK,aAAa,IAAI,GAEnC,EAAY,SAAS,cAAc,QACzC,EAAU,UAAY,uCAGtB,MAAM,EAAS,SAAS,cAAc,QAWtC,OAVA,EAAO,UAAY,wBAAuB,EAAa,YAAc,IAErE,KAAK,QAAQ,EAAQ,EAAa,WAAa,UAE/C,EAAO,aAAa,OAAQ,UAC5B,EAAO,aAAa,WAAY,KAChC,EAAO,aAAa,gBAAiB,OAAO,IAC5C,EAAO,aAAa,aAAc,EAAa,mBAAqB,kBACpE,EAAU,YAAY,GAEf,GAIF,CAAC,KAAgB,EAC1B,CAGA,UAAA,CAAoB,GAClB,GAAK,KAAK,OAAO,kBAAqB,KAAK,OAAO,eAElD,OADA,KAAK,cAAc,EAAM,IAAK,EAAM,WAC7B,CACT,CAGA,WAAA,CAAqB,GAGnB,IADe,EAAM,eAAe,SACxB,UAAU,SAAS,wBAE7B,OADA,KAAK,cAAc,EAAM,IAAK,EAAM,WAC7B,EAKL,KAAK,aAAa,KAAO,GAC3B,eAAA,IAAqB,MAAK,IAG9B,CAGA,SAAA,CAAmB,GAEjB,GAAkB,MAAd,EAAM,IAAa,OAEvB,MAAM,EAAW,KAAK,KAAK,UACrB,EAAW,KAAK,KAAK,UAErB,EAAS,KAAK,eAAe,GAGnC,IAAK,IAAW,EAAiB,GAAS,OAE1C,MAAM,EAAM,KAAK,KAAK,GACtB,OAAK,GAEL,EAAM,iBACN,KAAK,cAAc,EAAK,GAGxB,KAAK,0BACE,QAPP,CAQF,CAGA,WAAA,GACE,MAAK,IACL,MAAK,GACP,CAQA,EAAA,GACE,MAAM,EAAiB,KAAK,aAAa,cACvC,kDAEF,IAAK,EAAgB,OAErB,MAAM,EAAS,SAAS,EAAe,aAAa,aAAe,IAAK,IAClE,EAAW,EAAe,mBAC5B,IAEF,EAAS,MAAM,WAAa,GAAG,EAAS,OAAO,EAAS,IAE5D,CAOA,cAAA,GACO,KAAK,OAAO,gBAA6C,IAA3B,KAAK,aAAa,MAErD,MAAK,GACP,CAUA,EAAA,GACE,MAAM,EAAiB,KAAK,OAAO,eACnC,IAAK,EAAgB,OAErB,MAAM,EAAO,KAAK,aAAa,cAAc,SAC7C,IAAK,EAAM,OAEX,MAAM,EAAgB,MAAK,EAAsB,GACjD,MAAK,EAAsB,GAQ3B,MAAM,EAAc,KAAK,QAAQ,OACjC,IAAK,MAAO,EAAU,KAAU,EAAe,CAC7C,MAAM,EAAM,KAAK,KAAK,GACtB,IAAK,EAAK,SACV,MAAM,EAAa,KAAK,aAAa,IAAI,GAEzC,GADA,EAAM,UAAU,OAAO,mBAAoB,IACtC,EAAY,SAGjB,MAAM,EAAiB,KAAK,eAAe,IAAI,GAC3C,EAEE,EAAe,yBAA2B,GAC5C,EAAM,MAAM,GAKhB,MAAK,EAAiB,EAAK,EAAU,EAAO,EAAa,EAC3D,CACF,CASA,EAAA,CAAsB,GACpB,MAAM,EAAe,KAAK,KACpB,EAAqC,EAAa,SAClD,EAAuB,EAAa,iBAAiB,OAAS,EAC9D,EAAqB,EAAa,iBAAiB,KAAO,EAE1D,iBAAgB,IAAI,IAC1B,GAAI,EAAS,CACX,MAAM,EAAU,KAAK,IAAI,EAAQ,OAAQ,EAAa,GACtD,IAAK,IAAI,EAAI,EAAG,EAAI,EAAS,IAAK,CAChC,MAAM,EAAQ,EAAQ,GAClB,EAAM,aAAe,GACvB,EAAc,IAAI,EAAe,EAAG,EAExC,CACA,OAAO,CACT,CAEA,IAAK,MAAM,KAAS,EAAK,iBAAiB,kBAAmB,CAC3D,MAAM,EAAY,EAAM,cAAc,mBAChC,EAAW,EAAY,SAAS,EAAU,aAAa,aAAe,KAAM,KAAM,EACpF,GAAY,GACd,EAAc,IAAI,EAAU,EAEhC,CACA,OAAO,CACT,CAMA,EAAA,CAAsB,GACpB,IAAK,MAAO,EAAK,KAAa,KAAK,eAAgB,CACjD,MAAM,EAAW,KAAK,KAAK,QAAQ,GAC7B,EAAe,GAAY,GAAK,EAAc,IAAI,GACxD,GAAI,KAAK,aAAa,IAAI,IAAQ,EAAc,SAIhD,MAAM,EAAU,MAAK,EAAc,mBACnC,GAAI,GAAS,QAAS,CAEpB,MAAM,EADa,EAAS,cAAc,wBACZ,kBAC1B,GAAW,EAAQ,QAAQ,EACjC,CACI,EAAS,YAAY,EAAS,SAClC,KAAK,eAAe,OAAO,EAC7B,CACF,CAOA,EAAA,CACE,EACA,EACA,EACA,EACA,GAEA,MAAM,EF5lBV,SACE,EACA,EACA,EACA,GAEA,MAAM,EAAY,SAAS,cAAc,OACzC,EAAU,UAAY,oBACtB,EAAU,aAAa,kBAAmB,OAAO,IACjD,EAAU,aAAa,OAAQ,OAE/B,MAAM,EAAa,SAAS,cAAc,OAC1C,EAAW,UAAY,qBACvB,EAAW,aAAa,OAAQ,QAChC,EAAW,MAAM,WAAa,OAAO,EAAc,IAEnD,MAAM,EAAU,EAAS,EAAK,GAQ9B,MAPuB,iBAAZ,EACT,EAAiB,EAAY,GACpB,aAAmB,aAC5B,EAAW,YAAY,GAGzB,EAAU,YAAY,GACf,CACT,CEmkBqB,CAAoB,EAAK,EAAU,EAAgB,GAE5B,iBAA7B,KAAK,OAAO,eACrB,EAAS,MAAM,OAAS,GAAG,KAAK,OAAO,kBAIzC,EAAM,MAAM,GACZ,KAAK,eAAe,IAAI,EAAK,GAE7B,MAAM,EAAgB,KAAK,cAAc,IAAI,GACzC,GACF,KAAK,cAAc,OAAO,GAKxB,GAAiB,KAAK,cAAc,EAAU,EAAK,IAGvD,sBAAA,KACE,MAAK,EAA6B,EAAU,EAAK,IAErD,CAWA,YAAA,CAAsB,EAAc,GAGlC,GAFmB,KAAK,aAAa,IAAI,GAazC,OAHmB,KAAK,KAAK,kBAAoB,IAC5B,KAAK,gBAAgB,EAG5C,CAMA,kBAAA,CAA4B,EAAe,EAAmB,GAC5D,GAA+B,IAA3B,KAAK,aAAa,KAAY,OAAO,EAGzC,MAAM,EAAiB,KAAK,MAAc,iBAAiB,cAG3D,IAAI,EAAW,EAEf,GAAI,GAAiB,EAAc,OAAS,EAE1C,IAAK,MAAM,KAAO,KAAK,aAAc,CACnC,MAAM,EAAW,KAAK,KAAK,QAAQ,GAC/B,EAAW,GAAK,GAAY,GAGX,EAAc,GAAU,OAAS,EAAc,GAAU,OAE3D,GAAa,EAAW,IACzC,EAAW,EAEf,KACK,CAGL,MAAM,EAAsD,GAC5D,IAAK,MAAM,KAAO,KAAK,aAAc,CACnC,MAAM,EAAQ,KAAK,KAAK,QAAQ,GAC5B,GAAS,GACX,EAAgB,KAAK,CAAE,QAAO,OAElC,CACA,EAAgB,KAAA,CAAM,EAAG,IAAM,EAAE,MAAQ,EAAE,OAE3C,IAAI,EAAwB,EAE5B,IAAK,MAAQ,MAAO,EAAA,IAAU,KAAS,EAAiB,CACtD,MAAM,EAAe,EAAW,EAAY,EACtC,EAAe,KAAK,gBAAgB,GAG1C,GAAyB,EAErB,GAAY,GAJW,EAAe,EAAY,EAM7B,GAAa,EAAW,IAC/C,EAAW,EAEf,CACF,CAEA,OAAO,CACT,CASA,MAAA,CAAO,GACL,MAAM,EAAM,KAAK,KAAK,GAClB,IAAQ,EAAI,eACd,KAAK,cAAc,IAAI,GACvB,KAAK,aFnvBX,SAAgC,EAA2B,GAEzD,OADA,EAAa,IAAI,GACV,CACT,CEgvB0B,CAAgB,KAAK,aAAc,GACvD,KAAK,gBAET,CAMA,QAAA,CAAS,GACP,MAAM,EAAM,KAAK,KAAK,GAClB,IACF,KAAK,aFpvBX,SAAkC,EAA2B,GAE3D,OADA,EAAa,OAAO,GACb,CACT,CEivB0B,CAAkB,KAAK,aAAc,GACzD,KAAK,gBAET,CAMA,MAAA,CAAO,GACL,MAAM,EAAM,KAAK,KAAK,GAClB,IAAQ,EAAI,eACd,KAAK,aAAe,EAAgB,KAAK,aAAc,GACnD,KAAK,aAAa,IAAI,IACxB,KAAK,cAAc,IAAI,GAEzB,KAAK,gBAET,CAOA,UAAA,CAAW,GACT,MAAM,EAAM,KAAK,KAAK,GACtB,QAAO,GFvwBX,SAAiC,EAA2B,GAC1D,OAAO,EAAa,IAAI,EAC1B,CEqwBiB,CAAiB,KAAK,aAAc,EACnD,CAMA,SAAA,GACE,IAAK,MAAM,KAAO,KAAK,KACjB,GAAK,eACT,KAAK,cAAc,IAAI,GACvB,KAAK,aAAa,IAAI,IAExB,KAAK,eACP,CAKA,WAAA,GACE,KAAK,aAAa,QAClB,KAAK,eACP,CAMA,eAAA,GACE,MAAM,EAAoB,GAC1B,IAAK,MAAM,KAAO,KAAK,aAAc,CACnC,MAAM,EAAM,KAAK,KAAK,QAAQ,GAC1B,GAAO,GAAG,EAAQ,KAAK,EAC7B,CACA,OAAO,CACT,CAOA,gBAAA,CAAiB,GACf,MAAM,EAAM,KAAK,KAAK,GACtB,OAAO,EAAM,KAAK,eAAe,IAAI,QAAO,CAC9C,CAYA,aAAA,CAAc,GACZ,MAAM,EAAM,KAAK,KAAK,GACtB,OAAO,EAAM,KAAK,cAAc,IAAI,QAAO,CAC7C,CAOA,eAAA,CAAgB,GACd,MAAM,EAAM,KAAK,KAAK,GACtB,QAAO,GAAM,KAAK,eAAe,IAAI,EACvC,CASA,qBAAA,GAEE,MAAM,EAAkB,KAAK,OAAO,eAapC,GAZA,KAAK,OAAS,IAAK,KAAK,OAAQ,oBAAgB,GAChD,KAAK,uBAGA,KAAK,OAAO,gBAAkB,IACjC,KAAK,OAAS,IAAK,KAAK,OAAQ,eAAgB,IAO9C,KAAK,OAAO,eAAgB,CAC9B,MAAM,EAAO,MAAK,EACiB,mBAAxB,EAAK,eACd,EAAK,iBAGL,KAAK,eAET,CACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../../libs/grid/src/lib/core/internal/sanitize.ts","../../../../../../libs/grid/src/lib/core/defaults.ts","../../../../../../libs/grid/src/lib/core/internal/diagnostics.ts","../../../../../../libs/grid/src/lib/core/plugin/base-plugin.ts","../../../../../../libs/grid/src/lib/core/plugin/expander-column.ts","../../../../../../libs/grid/src/lib/plugins/master-detail/master-detail.ts","../../../../../../libs/grid/src/lib/plugins/master-detail/master-detail.css?inline","../../../../../../libs/grid/src/lib/plugins/master-detail/master-detail-plugin.ts"],"sourcesContent":["// 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 * 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","/**\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 * 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 * Shared Expander Column Utilities\n *\n * Provides a fixed expander column for plugins that need expand/collapse icons\n * (MasterDetail, Tree, RowGrouping). The column is:\n * - Always first in the grid\n * - Cannot be reordered (lockPosition: true)\n * - Has no header (empty string)\n * - Has no right border (borderless styling)\n * - Narrow width (just fits the icon)\n */\n\nimport type { ColumnConfig } from '../types';\n\n/** Special field name for the expander column */\nexport const EXPANDER_COLUMN_FIELD = '__tbw_expander';\n\n/** Default width for the expander column (pixels) */\nexport const EXPANDER_COLUMN_WIDTH = 32;\n\n/**\n * Marker interface for expander column renderers.\n * Used to detect if expander column is already present.\n */\nexport interface ExpanderColumnRenderer {\n  (ctx: any): HTMLElement;\n  __expanderColumn?: true;\n  /** Plugin name that created this expander */\n  __expanderPlugin?: string;\n}\n\n/**\n * Check if a column is an expander column.\n */\nexport function isExpanderColumn(column: ColumnConfig): boolean {\n  return column.field === EXPANDER_COLUMN_FIELD;\n}\n\n/**\n * Check if a column is a utility column (excluded from selection, clipboard, etc.).\n * Utility columns are non-data columns like expander columns.\n */\nexport function isUtilityColumn(column: ColumnConfig): boolean {\n  return column.utility === true;\n}\n\n/**\n * Find an existing expander column in the column array.\n */\nexport function findExpanderColumn(columns: readonly ColumnConfig[]): ColumnConfig | undefined {\n  return columns.find(isExpanderColumn);\n}\n\n/**\n * Create the base expander column config.\n * Plugins should add their own renderer to customize the expand icon behavior.\n *\n * @param pluginName - Name of the plugin creating the expander (for debugging)\n * @returns Base column config for the expander column\n */\nexport function createExpanderColumnConfig(pluginName: string): ColumnConfig {\n  return {\n    field: EXPANDER_COLUMN_FIELD as any,\n    header: '', // No header text - visually merges with next column\n    width: EXPANDER_COLUMN_WIDTH,\n    resizable: false,\n    sortable: false,\n    filterable: false, // No filter button for expander column\n    lockPosition: true,\n    utility: true, // Marks this as a utility column (excluded from selection, clipboard, etc.)\n    meta: {\n      expanderColumn: true,\n      expanderPlugin: pluginName,\n    },\n  };\n}\n","/**\n * Master/Detail Core Logic\n *\n * Pure functions for managing detail row expansion state.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n// Uses `any` for maximum flexibility with user-defined row types.\n\nimport { setSanitizedHTML } from '../../core/internal/sanitize';\n\n/**\n * Toggle the expansion state of a detail row.\n *\n * **Mutates the input `Set` in place and returns the same reference** (avoids\n * O(n) copy per toggle). Do NOT rely on reference inequality (`result !== input`)\n * to detect change — inspect the returned set's contents instead.\n */\nexport function toggleDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  if (expandedRows.has(row)) {\n    expandedRows.delete(row);\n  } else {\n    expandedRows.add(row);\n  }\n  return expandedRows;\n}\n\n/**\n * Expand a detail row.\n *\n * **Mutates the input `Set` in place and returns the same reference** (avoids\n * O(n) copy). Reference identity is preserved across calls.\n */\nexport function expandDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.add(row);\n  return expandedRows;\n}\n\n/**\n * Collapse a detail row.\n *\n * **Mutates the input `Set` in place and returns the same reference** (avoids\n * O(n) copy). Reference identity is preserved across calls.\n */\nexport function collapseDetailRow(expandedRows: Set<object>, row: object): Set<object> {\n  expandedRows.delete(row);\n  return expandedRows;\n}\n\n/**\n * Check if a detail row is expanded.\n */\nexport function isDetailExpanded(expandedRows: Set<object>, row: object): boolean {\n  return expandedRows.has(row);\n}\n\n/**\n * Create a detail element for a given row.\n * The element spans all columns and contains the rendered content.\n *\n * Strings returned by the renderer are passed through `setSanitizedHTML()` —\n * mirroring the cell render path — so a detail template interpolating row data\n * cannot become an XSS sink.\n */\nexport function createDetailElement(\n  row: any,\n  rowIndex: number,\n  renderer: (row: any, rowIndex: number) => HTMLElement | string,\n  columnCount: number,\n): HTMLElement {\n  const detailRow = document.createElement('div');\n  detailRow.className = 'master-detail-row';\n  detailRow.setAttribute('data-detail-for', String(rowIndex));\n  detailRow.setAttribute('role', 'row');\n\n  const detailCell = document.createElement('div');\n  detailCell.className = 'master-detail-cell';\n  detailCell.setAttribute('role', 'cell');\n  detailCell.style.gridColumn = `1 / ${columnCount + 1}`;\n\n  const content = renderer(row, rowIndex);\n  if (typeof content === 'string') {\n    setSanitizedHTML(detailCell, content);\n  } else if (content instanceof HTMLElement) {\n    detailCell.appendChild(content);\n  }\n\n  detailRow.appendChild(detailCell);\n  return detailRow;\n}\n","/**\n * Master-Detail Plugin Styles\n *\n * Scoped to tbw-grid using CSS nesting for light DOM compatibility.\n */\n@layer tbw-plugins {\n  tbw-grid {\n    /* Expander column data cells - always first, borderless right edge */\n    & .cell[data-field='__tbw_expander'] {\n      border-right: none !important;\n      padding: 0;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n    }\n\n    /* Expander column header - completely hidden; the next column's grid-column\n       span is set dynamically by afterRender to cover the expander's track. */\n    & .header-row .cell[data-field='__tbw_expander'] {\n      display: none;\n    }\n\n    /* Master-detail expander cell */\n    .master-detail-expander {\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      width: 100%;\n      height: 100%;\n    }\n\n    .master-detail-toggle {\n      cursor: pointer;\n      opacity: 0.7;\n      user-select: none;\n      display: inline-flex;\n      align-items: center;\n      justify-content: center;\n    }\n\n    .master-detail-toggle:hover {\n      opacity: 1;\n    }\n\n    /* SC 2.5.8: grow the target, not the box, so the row keeps its height. */\n    .master-detail-toggle {\n      position: relative;\n\n      &::after {\n        content: '';\n        position: absolute;\n        inset-block-start: 50%;\n        inset-inline-start: 50%;\n        translate: -50% -50%;\n        inline-size: var(--tbw-touch-target-min, 24px);\n        block-size: var(--tbw-touch-target-min, 24px);\n      }\n    }\n\n    @media (pointer: coarse) {\n      .master-detail-toggle {\n        min-width: var(--tbw-touch-target-min, 24px);\n        min-height: var(--tbw-touch-target-min, 24px);\n      }\n    }\n\n    .master-detail-row {\n      grid-column: 1 / -1;\n      display: grid;\n      background: var(--tbw-master-detail-bg, var(--tbw-color-row-alt));\n      border-bottom: 1px solid var(--tbw-master-detail-border, var(--tbw-color-border));\n      overflow: hidden;\n    }\n\n    .master-detail-cell {\n      padding: var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));\n      overflow: auto;\n    }\n\n    /* Animation for expanding detail rows */\n    .master-detail-row.tbw-expanding {\n      animation: tbw-detail-expand var(--tbw-animation-duration, 200ms) var(--tbw-animation-easing, ease-out) forwards;\n    }\n\n    /* Animation for collapsing detail rows */\n    .master-detail-row.tbw-collapsing {\n      animation: tbw-detail-collapse var(--tbw-animation-duration, 200ms) var(--tbw-animation-easing, ease-out) forwards;\n    }\n  }\n\n  @keyframes tbw-detail-expand {\n    from {\n      opacity: 0;\n      max-height: 0;\n      padding-top: 0;\n      padding-bottom: 0;\n    }\n    to {\n      opacity: 1;\n      max-height: var(--tbw-detail-max-height, 31.25rem);\n      padding-top: var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));\n      padding-bottom: var(--tbw-detail-padding, var(--tbw-spacing-xl, 1rem));\n    }\n  }\n\n  @keyframes tbw-detail-collapse {\n    from {\n      opacity: 1;\n      max-height: var(--tbw-detail-max-height, 31.25rem);\n    }\n    to {\n      opacity: 0;\n      max-height: 0;\n    }\n  }\n} /* End @layer tbw-plugins */\n","/**\n * Master/Detail Plugin (Class-based)\n *\n * Enables expandable detail rows showing additional content for each row.\n * Animation style is plugin-configured; respects grid-level animation.mode.\n */\n\nimport { evalTemplateString, sanitizeHTML } from '../../core/internal/sanitize';\nimport { BaseGridPlugin, CellClickEvent, GridElement, RowClickEvent } from '../../core/plugin/base-plugin';\nimport { createExpanderColumnConfig, findExpanderColumn, isExpanderColumn } from '../../core/plugin/expander-column';\nimport type { ColumnConfig, GridHost } from '../../core/types';\nimport type { DataSourceChildrenDetail, FetchChildrenQuery } from '../server-side/datasource-types';\nimport {\n  collapseDetailRow,\n  createDetailElement,\n  expandDetailRow,\n  isDetailExpanded,\n  toggleDetailRow,\n} from './master-detail';\nimport styles from './master-detail.css?inline';\nimport type { DetailExpandDetail, ExpandCollapseAnimation, MasterDetailConfig } from './types';\n\n/**\n * Master-Detail Plugin for tbw-grid\n *\n * Creates expandable detail rows that reveal additional content beneath each master row.\n * Perfect for order/line-item UIs, employee/department views, or any scenario where\n * you need to show related data without navigating away.\n *\n * ## Installation\n *\n * ```ts\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n * ```\n *\n * ## CSS Custom Properties\n *\n * | Property | Default | Description |\n * |----------|---------|-------------|\n * | `--tbw-master-detail-bg` | `var(--tbw-color-row-alt)` | Detail row background |\n * | `--tbw-master-detail-border` | `var(--tbw-color-border)` | Detail row border |\n * | `--tbw-detail-padding` | `1em` | Detail content padding |\n * | `--tbw-animation-duration` | `200ms` | Expand/collapse animation |\n *\n * @example Basic Master-Detail with HTML Template\n * ```ts\n * import '@toolbox-web/grid';\n * import { MasterDetailPlugin } from '@toolbox-web/grid/plugins/master-detail';\n *\n * grid.gridConfig = {\n *   columns: [\n *     { field: 'orderId', header: 'Order ID' },\n *     { field: 'customer', header: 'Customer' },\n *     { field: 'total', header: 'Total', type: 'currency' },\n *   ],\n *   plugins: [\n *     new MasterDetailPlugin({\n *       detailRenderer: (row) => `\n *         <div class=\"order-details\">\n *           <h4>Order Items</h4>\n *           <ul>${row.items.map(i => `<li>${i.name} - $${i.price}</li>`).join('')}</ul>\n *         </div>\n *       `,\n *     }),\n *   ],\n * };\n * ```\n *\n * @example Nested Grid in Detail\n * ```ts\n * new MasterDetailPlugin({\n *   detailRenderer: (row) => {\n *     const childGrid = document.createElement('tbw-grid');\n *     childGrid.style.height = '200px';\n *     childGrid.gridConfig = { columns: [...] };\n *     childGrid.rows = row.items || [];\n *     return childGrid;\n *   },\n * })\n * ```\n *\n * @see {@link MasterDetailConfig} for all configuration options\n * @see {@link DetailExpandDetail} for expand/collapse event details\n *\n * @internal Extends BaseGridPlugin\n * @since 0.1.1\n */\nexport class MasterDetailPlugin extends BaseGridPlugin<MasterDetailConfig> {\n  /** @internal */\n  readonly name = 'masterDetail';\n  /** @internal */\n  override readonly styles = styles;\n\n  /**\n   * Optional dependency on ServerSide for async detail data.\n   * When loaded, MasterDetail can fetch detail data via `datasource:fetch-children`.\n   */\n  static override readonly dependencies = [\n    { name: 'serverSide', required: false, reason: 'Fetches detail data via datasource:fetch-children on expand' },\n  ];\n\n  /** Typed internal grid accessor. */\n  get #internalGrid(): GridHost {\n    return this.grid;\n  }\n\n  /** @internal */\n  protected override get defaultConfig(): Partial<MasterDetailConfig> {\n    return {\n      detailHeight: 'auto',\n      expandOnRowClick: false,\n      // Note: showExpandColumn is intentionally NOT defaulted here.\n      // If undefined, processColumns() adds expander only when detailRenderer is provided.\n      // Set to true for framework adapters that register renderers asynchronously.\n      animation: 'slide', // Plugin's own default\n    };\n  }\n\n  // #region Light DOM Parsing\n\n  /**\n   * Called when plugin is attached to the grid.\n   * Parses light DOM for `<tbw-grid-detail>` elements to configure detail templates.\n   * @internal\n   */\n  override attach(grid: GridElement): void {\n    super.attach(grid);\n    this.parseLightDomDetail();\n\n    // Listen for datasource:children — receive async detail data from ServerSide\n    this.on('datasource:children', (detail: unknown) => {\n      const d = detail as DataSourceChildrenDetail;\n      if (d.context?.source !== 'master-detail') return;\n      d.claimed = true;\n\n      const row = d.context.row;\n      if (row && this.expandedRows.has(row)) {\n        this.detailDataMap.set(row, d.rows);\n        this.loadingDetails.delete(row);\n        // Re-render: remove existing detail element so #syncDetailRows recreates it\n        const existingDetail = this.detailElements.get(row);\n        if (existingDetail) {\n          existingDetail.remove();\n          this.detailElements.delete(row);\n          this.measuredDetailHeights.delete(row);\n        }\n        this.requestRender();\n      }\n    });\n  }\n\n  /**\n   * Parse `<tbw-grid-detail>` elements from the grid's light DOM.\n   *\n   * Allows declarative configuration:\n   * ```html\n   * <tbw-grid [rows]=\"data\">\n   *   <tbw-grid-detail>\n   *     <div class=\"detail-content\">\n   *       <p>Name: {{ row.name }}</p>\n   *       <p>Email: {{ row.email }}</p>\n   *     </div>\n   *   </tbw-grid-detail>\n   * </tbw-grid>\n   * ```\n   *\n   * Attributes:\n   * - `animation`: 'slide' | 'fade' | 'false' (default: 'slide')\n   * - `show-expand-column`: 'true' | 'false' (default: 'true')\n   * - `expand-on-row-click`: 'true' | 'false' (default: 'false')\n   * - `height`: number (pixels) or 'auto' (default: 'auto')\n   */\n  private parseLightDomDetail(): void {\n    const gridEl = this.gridElement;\n    if (!gridEl) return;\n\n    const detailEl = gridEl.querySelector('tbw-grid-detail');\n    if (!detailEl) return;\n\n    // Check if a framework adapter wants to handle this element\n    // (e.g., Angular adapter intercepts for ng-template rendering)\n    const adapter = this.#internalGrid.__frameworkAdapter;\n    if (adapter?.parseDetailElement) {\n      const adapterRenderer = adapter.parseDetailElement(detailEl);\n      if (adapterRenderer) {\n        this.config = { ...this.config, detailRenderer: adapterRenderer };\n        return;\n      }\n    }\n\n    // Parse attributes for configuration\n    const animation = detailEl.getAttribute('animation');\n    const showExpandColumn = detailEl.getAttribute('show-expand-column');\n    const expandOnRowClick = detailEl.getAttribute('expand-on-row-click');\n    const heightAttr = detailEl.getAttribute('height');\n\n    const configUpdates: Partial<MasterDetailConfig> = {};\n\n    if (animation !== null) {\n      configUpdates.animation = animation === 'false' ? false : (animation as 'slide' | 'fade');\n    }\n    if (showExpandColumn !== null) {\n      configUpdates.showExpandColumn = showExpandColumn !== 'false';\n    }\n    if (expandOnRowClick !== null) {\n      configUpdates.expandOnRowClick = expandOnRowClick === 'true';\n    }\n    if (heightAttr !== null) {\n      configUpdates.detailHeight = heightAttr === 'auto' ? 'auto' : parseInt(heightAttr, 10);\n    }\n\n    // Get template content from innerHTML\n    const templateHTML = detailEl.innerHTML.trim();\n    if (templateHTML && !this.config.detailRenderer) {\n      // Create a template-based renderer using the inner HTML\n      configUpdates.detailRenderer = (row: any, _rowIndex: number): string => {\n        // Evaluate template expressions like {{ row.field }}\n        const evaluated = evalTemplateString(templateHTML, { value: row, row });\n        // Sanitize the result to prevent XSS\n        return sanitizeHTML(evaluated);\n      };\n    }\n\n    // Merge updates into config\n    if (Object.keys(configUpdates).length > 0) {\n      this.config = { ...this.config, ...configUpdates };\n    }\n  }\n\n  // #endregion\n\n  // #region Animation Helpers\n\n  /**\n   * Get expand/collapse animation style from plugin config.\n   * Uses base class isAnimationEnabled to respect grid-level settings.\n   */\n  private get animationStyle(): ExpandCollapseAnimation {\n    if (!this.isAnimationEnabled) return false;\n    return this.config.animation ?? 'slide';\n  }\n\n  /**\n   * Apply expand animation to a detail element.\n   * Returns true if animation was applied, false if skipped.\n   * When animated, height measurement is deferred to animationend to avoid\n   * measuring during the max-height: 0 CSS animation constraint.\n   */\n  private animateExpand(detailEl: HTMLElement, row?: any, rowIndex?: number): boolean {\n    if (!this.isAnimationEnabled || this.animationStyle === false) return false;\n\n    detailEl.classList.add('tbw-expanding');\n\n    let measured = false;\n    const measureOnce = () => {\n      if (measured) return;\n      measured = true;\n      detailEl.classList.remove('tbw-expanding');\n\n      // Measure height AFTER animation completes - the element now has its\n      // natural height without the max-height constraint from the animation.\n      if (row !== undefined && rowIndex !== undefined) {\n        this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n      }\n    };\n\n    detailEl.addEventListener('animationend', measureOnce, { once: true });\n    // Fallback timeout in case animationend doesn't fire (e.g., element detached,\n    // animation removed, or framework rendering delays). Matches animateCollapse pattern.\n    setTimeout(measureOnce, this.animationDuration + 50);\n    return true;\n  }\n\n  /**\n   * Apply collapse animation to a detail element and remove after animation.\n   */\n  private animateCollapse(detailEl: HTMLElement, onComplete: () => void): void {\n    if (!this.isAnimationEnabled || this.animationStyle === false) {\n      onComplete();\n      return;\n    }\n\n    detailEl.classList.add('tbw-collapsing');\n    const cleanup = () => {\n      detailEl.classList.remove('tbw-collapsing');\n      onComplete();\n    };\n    detailEl.addEventListener('animationend', cleanup, { once: true });\n    // Fallback timeout in case animation doesn't fire\n    setTimeout(cleanup, this.animationDuration + 50);\n  }\n\n  /**\n   * Measure a detail element's height and update the position cache if it changed.\n   * Used after layout settles (RAF) or after animation completes (animationend).\n   */\n  #measureAndCacheDetailHeight(detailEl: HTMLElement, row: any, rowIndex: number): void {\n    if (!detailEl.isConnected) return;\n\n    const height = detailEl.offsetHeight;\n    if (height > 0) {\n      const previousHeight = this.measuredDetailHeights.get(row);\n      this.measuredDetailHeights.set(row, height);\n\n      // Only invalidate if height actually changed\n      // This triggers an incremental position cache update, not a full rebuild\n      if (previousHeight !== height) {\n        this.grid.invalidateRowHeight(rowIndex);\n      }\n    }\n  }\n\n  // #endregion\n\n  // #region Internal State\n  private expandedRows: Set<any> = new Set();\n  private detailElements: Map<any, HTMLElement> = new Map();\n  /** Cached measured heights - persists even when elements are virtualized out */\n  private measuredDetailHeights: Map<any, number> = new Map();\n  /** Rows that were just expanded by user action and should animate.\n   * Prevents re-animation when rows scroll back into the virtual window. */\n  private rowsToAnimate: Set<any> = new Set();\n  /** Rows currently waiting for datasource:children response. */\n  private loadingDetails: Set<any> = new Set();\n  /** Child rows received via datasource:children, keyed by parent row reference. */\n  private detailDataMap: Map<any, unknown[]> = new Map();\n\n  /** Default height for detail rows when not configured */\n  private static readonly DEFAULT_DETAIL_HEIGHT = 150;\n\n  /**\n   * Get the estimated height for a detail row.\n   * Uses cached measured height when available (survives virtualization).\n   * Avoids reading offsetHeight during CSS animations to prevent poisoning the cache.\n   */\n  private getDetailHeight(row: any): number {\n    // Try DOM element first - works for tests and when element is connected\n    const detailEl = this.detailElements.get(row);\n    if (detailEl) {\n      // Skip DOM measurement if currently animating (max-height constraint gives wrong value)\n      const isAnimating = detailEl.classList.contains('tbw-expanding') || detailEl.classList.contains('tbw-collapsing');\n      if (!isAnimating) {\n        const height = detailEl.offsetHeight;\n        if (height > 0) {\n          // Cache the measurement for when this row is virtualized out\n          this.measuredDetailHeights.set(row, height);\n          return height;\n        }\n      }\n    }\n\n    // DOM element missing, detached, or animating - check cached measurement\n    const cachedHeight = this.measuredDetailHeights.get(row);\n    if (cachedHeight && cachedHeight > 0) {\n      return cachedHeight;\n    }\n\n    // Fallback to config or default\n    return typeof this.config?.detailHeight === 'number'\n      ? this.config.detailHeight\n      : MasterDetailPlugin.DEFAULT_DETAIL_HEIGHT;\n  }\n\n  /**\n   * Toggle a row's detail and emit event.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  private toggleAndEmit(row: any, rowIndex: number): void {\n    // Synthetic rows (e.g., group headers) don't have detail content\n    if (row?.__isGroupRow) return;\n\n    this.expandedRows = toggleDetailRow(this.expandedRows, row as object);\n    const expanded = this.expandedRows.has(row as object);\n    if (expanded) {\n      this.rowsToAnimate.add(row);\n\n      // Request detail data from ServerSide if available and not already cached\n      if (!this.detailDataMap.has(row)) {\n        const isServerSideActive = this.queryBoolean('datasource:is-active');\n        if (isServerSideActive) {\n          this.loadingDetails.add(row);\n          this.grid.query('datasource:fetch-children', {\n            context: { source: 'master-detail', row, rowIndex },\n          } satisfies FetchChildrenQuery);\n        }\n      }\n    } else {\n      this.loadingDetails.delete(row);\n    }\n    this.emit<DetailExpandDetail>('detail-expand', {\n      rowIndex,\n      row: row as Record<string, unknown>,\n      expanded,\n    });\n    this.requestRender();\n  }\n  // #endregion\n\n  // #region Lifecycle\n\n  /** @internal */\n  override detach(): void {\n    this.expandedRows.clear();\n    this.detailElements.clear();\n    this.measuredDetailHeights.clear();\n    this.rowsToAnimate.clear();\n    this.loadingDetails.clear();\n    this.detailDataMap.clear();\n  }\n  // #endregion\n\n  // #region Hooks\n\n  /** @internal */\n  override processColumns(columns: readonly ColumnConfig[]): ColumnConfig[] {\n    // Determine whether to add the expander column:\n    // 1. If showExpandColumn === false: never add (explicit opt-out)\n    // 2. If showExpandColumn === true: always add (explicit opt-in, for framework adapters)\n    // 3. If showExpandColumn is undefined: add only if detailRenderer is provided\n    //\n    // This supports React/Angular adapters which register renderers asynchronously via light DOM.\n    // They must set showExpandColumn: true to get the column immediately, avoiding layout shift.\n    const shouldAddExpander =\n      this.config.showExpandColumn === true || (this.config.showExpandColumn !== false && !!this.config.detailRenderer);\n\n    if (!shouldAddExpander) {\n      return [...columns];\n    }\n\n    const cols = [...columns];\n\n    // Check if expander column already exists (from this or another plugin)\n    const existingExpander = findExpanderColumn(cols);\n    if (existingExpander) {\n      // Another plugin already added an expander column - don't add duplicate\n      // Our expand logic will be handled via onCellClick on the expander column\n      return cols;\n    }\n\n    // Create dedicated expander column that stays fixed at position 0\n    const expanderCol = createExpanderColumnConfig(this.name);\n    expanderCol.viewRenderer = (renderCtx) => {\n      const { row } = renderCtx;\n      const isExpanded = this.expandedRows.has(row as object);\n\n      const container = document.createElement('span');\n      container.className = 'master-detail-expander expander-cell';\n\n      // Expand/collapse toggle icon\n      const toggle = document.createElement('span');\n      toggle.className = `master-detail-toggle${isExpanded ? ' expanded' : ''}`;\n      // Use grid-level icons (fall back to defaults)\n      this.setIcon(toggle, isExpanded ? 'collapse' : 'expand');\n      // role=\"button\" is required for aria-expanded to be valid\n      toggle.setAttribute('role', 'button');\n      toggle.setAttribute('tabindex', '0');\n      toggle.setAttribute('aria-expanded', String(isExpanded));\n      toggle.setAttribute('aria-label', isExpanded ? 'Collapse details' : 'Expand details');\n      container.appendChild(toggle);\n\n      return container;\n    };\n\n    // Prepend expander column to ensure it's always first\n    return [expanderCol, ...cols];\n  }\n\n  /** @internal */\n  override onRowClick(event: RowClickEvent): boolean | void {\n    if (!this.config.expandOnRowClick || !this.config.detailRenderer) return;\n    this.toggleAndEmit(event.row, event.rowIndex);\n    return false;\n  }\n\n  /** @internal */\n  override onCellClick(event: CellClickEvent): boolean | void {\n    // Handle click on master-detail toggle icon (same pattern as TreePlugin)\n    const target = event.originalEvent?.target as HTMLElement;\n    if (target?.classList.contains('master-detail-toggle')) {\n      this.toggleAndEmit(event.row, event.rowIndex);\n      return true; // Prevent default handling\n    }\n\n    // Sync detail rows after cell click triggers refreshVirtualWindow\n    // This runs in microtask to ensure DOM updates are complete\n    if (this.expandedRows.size > 0) {\n      queueMicrotask(() => this.#syncDetailRows());\n    }\n    return; // Don't prevent default\n  }\n\n  /** @internal */\n  override onKeyDown(event: KeyboardEvent): boolean | void {\n    // SPACE toggles expansion when focus is on the expander column\n    if (event.key !== ' ') return;\n\n    const focusCol = this.grid._focusCol;\n    const focusRow = this.grid._focusRow;\n    // _focusCol is a visible-column index (set from data-col), so use visibleColumns\n    const column = this.visibleColumns[focusCol];\n\n    // Only handle SPACE on expander column\n    if (!column || !isExpanderColumn(column)) return;\n\n    const row = this.rows[focusRow];\n    if (!row) return;\n\n    event.preventDefault();\n    this.toggleAndEmit(row, focusRow);\n\n    // Restore focus styling after render completes via render pipeline\n    this.requestRenderWithFocus();\n    return true;\n  }\n\n  /** @internal */\n  override afterRender(): void {\n    this.#fixExpanderHeaderSpan();\n    this.#syncDetailRows();\n  }\n\n  /**\n   * The expander header cell is hidden (display:none), so the next sibling\n   * header cell must span two CSS grid tracks (the expander's + its own)\n   * to keep the header aligned with data rows.  The column position is\n   * computed dynamically so that pinned columns can appear before the expander.\n   */\n  #fixExpanderHeaderSpan(): void {\n    const expanderHeader = this.gridElement?.querySelector(\n      '.header-row .cell[data-field=\"__tbw_expander\"]',\n    ) as HTMLElement | null;\n    if (!expanderHeader) return;\n\n    const colIdx = parseInt(expanderHeader.getAttribute('data-col') || '0', 10);\n    const nextCell = expanderHeader.nextElementSibling as HTMLElement | null;\n    if (nextCell) {\n      // CSS grid columns are 1-based; span from the expander's track to the next cell's track.\n      nextCell.style.gridColumn = `${colIdx + 1} / ${colIdx + 3}`;\n    }\n  }\n\n  /**\n   * Called on scroll to sync detail elements with visible rows.\n   * Removes details for rows that scrolled out of view and reattaches for visible rows.\n   * @internal\n   */\n  override onScrollRender(): void {\n    if (!this.config.detailRenderer || this.expandedRows.size === 0) return;\n    // Full sync needed on scroll to clean up orphaned details\n    this.#syncDetailRows();\n  }\n\n  /**\n   * Full sync of detail rows - cleans up stale elements and creates new ones.\n   * Detail rows are inserted as siblings AFTER their master row to survive row rebuilds.\n   *\n   * PERF: Uses the grid's row pool (_rowPool) and virtual window (_virtualization.start/end)\n   * to avoid querySelectorAll on every scroll frame. The pool is index-aligned with the\n   * virtual window, so pool[i] corresponds to row index (start + i).\n   */\n  #syncDetailRows(): void {\n    const detailRenderer = this.config.detailRenderer;\n    if (!detailRenderer) return;\n\n    const body = this.gridElement?.querySelector('.rows');\n    if (!body) return;\n\n    const visibleRowMap = this.#collectVisibleRowMap(body);\n    this.#pruneDetachedDetails(visibleRowMap);\n\n    // Insert detail rows for expanded rows that are visible. We also toggle\n    // `.tbw-row-expanded` on every visible master row (matches Tree /\n    // GroupingRows) so devs can style expanded rows via CSS instead of\n    // depending on `[aria-expanded=\"true\"]` (which lives on the toggle\n    // button, not the row). MUST clear on the negative branch — the row\n    // pool recycles elements as the virtual window slides.\n    const columnCount = this.columns.length;\n    for (const [rowIndex, rowEl] of visibleRowMap) {\n      const row = this.rows[rowIndex];\n      if (!row) continue;\n      const isExpanded = this.expandedRows.has(row);\n      rowEl.classList.toggle('tbw-row-expanded', isExpanded);\n      if (!isExpanded) continue;\n\n      // Check if detail already exists for this row\n      const existingDetail = this.detailElements.get(row);\n      if (existingDetail) {\n        // Ensure it's positioned correctly (as next sibling of row element)\n        if (existingDetail.previousElementSibling !== rowEl) {\n          rowEl.after(existingDetail);\n        }\n        continue;\n      }\n\n      this.#insertDetailRow(row, rowIndex, rowEl, columnCount, detailRenderer);\n    }\n  }\n\n  /**\n   * Map visible row index → row element.\n   *\n   * PERF: prefers the grid's index-aligned row pool (`_rowPool[i]` renders row\n   * `_virtualization.start + i`) so no `querySelectorAll` runs per scroll frame;\n   * falls back to a DOM query when the pool is not accessible.\n   */\n  #collectVisibleRowMap(body: Element): Map<number, Element> {\n    const gridInternal = this.grid as any;\n    const rowPool: HTMLElement[] | undefined = gridInternal._rowPool;\n    const visibleStart: number = gridInternal._virtualization?.start ?? 0;\n    const visibleEnd: number = gridInternal._virtualization?.end ?? 0;\n\n    const visibleRowMap = new Map<number, Element>();\n    if (rowPool) {\n      const poolLen = Math.min(rowPool.length, visibleEnd - visibleStart);\n      for (let i = 0; i < poolLen; i++) {\n        const rowEl = rowPool[i];\n        if (rowEl.parentNode === body) {\n          visibleRowMap.set(visibleStart + i, rowEl);\n        }\n      }\n      return visibleRowMap;\n    }\n\n    for (const rowEl of body.querySelectorAll('.data-grid-row')) {\n      const firstCell = rowEl.querySelector('.cell[data-row]');\n      const rowIndex = firstCell ? parseInt(firstCell.getAttribute('data-row') ?? '-1', 10) : -1;\n      if (rowIndex >= 0) {\n        visibleRowMap.set(rowIndex, rowEl);\n      }\n    }\n    return visibleRowMap;\n  }\n\n  /**\n   * Remove detail rows whose master row is no longer visible or no longer\n   * expanded. Iterates the owned `detailElements` map instead of the DOM.\n   */\n  #pruneDetachedDetails(visibleRowMap: Map<number, Element>): void {\n    for (const [row, detailEl] of this.detailElements) {\n      const rowIndex = this.rows.indexOf(row);\n      const isRowVisible = rowIndex >= 0 && visibleRowMap.has(rowIndex);\n      if (this.expandedRows.has(row) && isRowVisible) continue;\n\n      // Clean up framework adapter resources (React root, Vue app, Angular view)\n      // before removing to prevent memory leaks.\n      const adapter = this.#internalGrid.__frameworkAdapter;\n      if (adapter?.unmount) {\n        const detailCell = detailEl.querySelector('.master-detail-cell');\n        const container = detailCell?.firstElementChild as HTMLElement | null;\n        if (container) adapter.unmount(container);\n      }\n      if (detailEl.parentNode) detailEl.remove();\n      this.detailElements.delete(row);\n    }\n  }\n\n  /**\n   * Create a detail element and insert it as the next sibling of its master row.\n   * Animates only when the row was just expanded by a user action — rows\n   * re-appearing from scroll (virtualization) must not re-animate.\n   */\n  #insertDetailRow(\n    row: object,\n    rowIndex: number,\n    rowEl: Element,\n    columnCount: number,\n    detailRenderer: NonNullable<MasterDetailConfig['detailRenderer']>,\n  ): void {\n    const detailEl = createDetailElement(row, rowIndex, detailRenderer, columnCount);\n\n    if (typeof this.config.detailHeight === 'number') {\n      detailEl.style.height = `${this.config.detailHeight}px`;\n    }\n\n    // Insert as sibling after the row element (not as child)\n    rowEl.after(detailEl);\n    this.detailElements.set(row, detailEl);\n\n    const shouldAnimate = this.rowsToAnimate.has(row);\n    if (shouldAnimate) {\n      this.rowsToAnimate.delete(row);\n    }\n\n    // When animating, measurement is deferred to the animationend callback\n    // (inside animateExpand) to avoid measuring during the max-height: 0 constraint.\n    if (shouldAnimate && this.animateExpand(detailEl, row, rowIndex)) return;\n\n    // No animation - measure height after layout settles via RAF\n    requestAnimationFrame(() => {\n      this.#measureAndCacheDetailHeight(detailEl, row, rowIndex);\n    });\n  }\n\n  /**\n   * Get the height of a specific row, including any expanded detail content.\n   * Always returns a height to ensure the position cache uses plugin-controlled values\n   * rather than stale DOM measurements.\n   *\n   * @param row - The row data\n   * @param _index - The row index (unused, but part of the interface)\n   * @returns The row height in pixels (base height for collapsed, base + detail for expanded)\n   */\n  override getRowHeight(row: unknown, _index: number): number | undefined {\n    const isExpanded = this.expandedRows.has(row as object);\n\n    if (!isExpanded) {\n      // Collapsed row - return undefined to let the grid use its measured/estimated height.\n      // This ensures the position cache uses the correct row height from CSS/config.\n      return undefined;\n    }\n\n    // Row is expanded - return base height plus detail height\n    // Use grid's defaultRowHeight which reflects the actual measured/configured height\n    const baseHeight = this.grid.defaultRowHeight ?? 28;\n    const detailHeight = this.getDetailHeight(row);\n\n    return baseHeight + detailHeight;\n  }\n\n  /**\n   * Adjust the virtualization start index to keep expanded row visible while its detail is visible.\n   * This ensures the detail scrolls smoothly out of view instead of disappearing abruptly.\n   */\n  override adjustVirtualStart(start: number, scrollTop: number, rowHeight: number): number {\n    if (this.expandedRows.size === 0) return start;\n\n    // Use position cache for accurate row positions when available (variable heights mode)\n    const positionCache = (this.grid as any)?._virtualization?.positionCache as\n      Array<{ offset: number; height: number }> | undefined;\n\n    let minStart = start;\n\n    if (positionCache && positionCache.length > 0) {\n      // Variable heights: use position cache for accurate offset\n      for (const row of this.expandedRows) {\n        const rowIndex = this.rows.indexOf(row);\n        if (rowIndex < 0 || rowIndex >= start) continue;\n\n        // Position cache already includes cumulative heights from all expanded details\n        const detailBottom = positionCache[rowIndex].offset + positionCache[rowIndex].height;\n\n        if (detailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    } else {\n      // Fixed heights fallback: accumulate detail heights manually\n      // Build sorted list of expanded row indices for cumulative height calculation\n      const expandedIndices: Array<{ index: number; row: any }> = [];\n      for (const row of this.expandedRows) {\n        const index = this.rows.indexOf(row);\n        if (index >= 0) {\n          expandedIndices.push({ index, row });\n        }\n      }\n      expandedIndices.sort((a, b) => a.index - b.index);\n\n      let cumulativeExtraHeight = 0;\n\n      for (const { index: rowIndex, row } of expandedIndices) {\n        const actualRowTop = rowIndex * rowHeight + cumulativeExtraHeight;\n        const detailHeight = this.getDetailHeight(row);\n        const actualDetailBottom = actualRowTop + rowHeight + detailHeight;\n\n        cumulativeExtraHeight += detailHeight;\n\n        if (rowIndex >= start) continue;\n\n        if (actualDetailBottom > scrollTop && rowIndex < minStart) {\n          minStart = rowIndex;\n        }\n      }\n    }\n\n    return minStart;\n  }\n  // #endregion\n\n  // #region Public API\n\n  /**\n   * Expand the detail row at the given index.\n   * @param rowIndex - Index of the row to expand\n   */\n  expand(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.rowsToAnimate.add(row);\n      this.expandedRows = expandDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Collapse the detail row at the given index.\n   * @param rowIndex - Index of the row to collapse\n   */\n  collapse(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row) {\n      this.expandedRows = collapseDetailRow(this.expandedRows, row);\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Toggle the detail row at the given index.\n   * @param rowIndex - Index of the row to toggle\n   */\n  toggle(rowIndex: number): void {\n    const row = this.rows[rowIndex];\n    if (row && !row.__isGroupRow) {\n      this.expandedRows = toggleDetailRow(this.expandedRows, row);\n      if (this.expandedRows.has(row)) {\n        this.rowsToAnimate.add(row);\n      }\n      this.requestRender();\n    }\n  }\n\n  /**\n   * Check if the detail row at the given index is expanded.\n   * @param rowIndex - Index of the row to check\n   * @returns Whether the detail row is expanded\n   */\n  isExpanded(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? isDetailExpanded(this.expandedRows, row) : false;\n  }\n\n  /**\n   * Expand all detail rows.\n   * Skips synthetic rows (e.g., group headers from GroupingRowsPlugin).\n   */\n  expandAll(): void {\n    for (const row of this.rows) {\n      if (row?.__isGroupRow) continue;\n      this.rowsToAnimate.add(row);\n      this.expandedRows.add(row);\n    }\n    this.requestRender();\n  }\n\n  /**\n   * Collapse all detail rows.\n   */\n  collapseAll(): void {\n    this.expandedRows.clear();\n    this.requestRender();\n  }\n\n  /**\n   * Get the indices of all expanded rows.\n   * @returns Array of row indices that are expanded\n   */\n  getExpandedRows(): number[] {\n    const indices: number[] = [];\n    for (const row of this.expandedRows) {\n      const idx = this.rows.indexOf(row);\n      if (idx >= 0) indices.push(idx);\n    }\n    return indices;\n  }\n\n  /**\n   * Get the detail element for a specific row.\n   * @param rowIndex - Index of the row\n   * @returns The detail HTMLElement or undefined\n   */\n  getDetailElement(rowIndex: number): HTMLElement | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailElements.get(row) : undefined;\n  }\n\n  /**\n   * Get async detail data fetched via `ServerSidePlugin` for a specific row.\n   *\n   * Returns the child rows received from `datasource:children` after a\n   * `datasource:fetch-children` query was fired on expand. Returns `undefined`\n   * when ServerSide is not loaded or data has not arrived yet.\n   *\n   * @param rowIndex - Index of the row\n   * @returns Array of child rows or undefined\n   */\n  getDetailData(rowIndex: number): unknown[] | undefined {\n    const row = this.rows[rowIndex];\n    return row ? this.detailDataMap.get(row) : undefined;\n  }\n\n  /**\n   * Check if detail data is currently being loaded for a row.\n   * @param rowIndex - Index of the row\n   * @returns Whether the detail is loading\n   */\n  isDetailLoading(rowIndex: number): boolean {\n    const row = this.rows[rowIndex];\n    return row ? this.loadingDetails.has(row) : false;\n  }\n\n  /**\n   * Re-parse light DOM to refresh the detail renderer.\n   * Call this after framework templates are registered (e.g., Angular ngAfterContentInit).\n   *\n   * This allows frameworks to register templates asynchronously and then\n   * update the plugin's detailRenderer.\n   */\n  refreshDetailRenderer(): void {\n    // Force re-parse by temporarily clearing the renderer\n    const currentRenderer = this.config.detailRenderer;\n    this.config = { ...this.config, detailRenderer: undefined };\n    this.parseLightDomDetail();\n\n    // If no new renderer was found, restore the original\n    if (!this.config.detailRenderer && currentRenderer) {\n      this.config = { ...this.config, detailRenderer: currentRenderer };\n    }\n\n    // Request a COLUMNS phase re-render so processColumns runs again with the new detailRenderer\n    // This ensures the expand toggle is added to the first column.\n    // Must use refreshColumns() (COLUMNS phase) not requestRender() (ROWS phase)\n    // because processColumns only runs at COLUMNS phase or higher.\n    if (this.config.detailRenderer) {\n      const grid = this.#internalGrid;\n      if (typeof grid.refreshColumns === 'function') {\n        grid.refreshColumns();\n      } else {\n        // Fallback to requestRender if refreshColumns not available\n        this.requestRender();\n      }\n    }\n  }\n  // #endregion\n}\n"],"mappings":"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"}