argus-table 0.0.0-stage → 0.0.1

package/dist/custom-elements.json

@@ -0,0 +1,1131 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/argus-table.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A virtualized data table.\n\nSet `columns` and `data` as properties. Header and cell content is rendered\ninto the element's light DOM and slotted into the cells, so page CSS and the\npage's own components work inside cells.",
+          "name": "ArgusTable",
+          "cssProperties": [
+            {
+              "description": "Background of the table and rows.",
+              "name": "--argus-bg",
+              "default": "Canvas"
+            },
+            {
+              "description": "Text colour.",
+              "name": "--argus-fg",
+              "default": "CanvasText"
+            },
+            {
+              "description": "Font shorthand for the table.",
+              "name": "--argus-font",
+              "default": "inherit"
+            },
+            {
+              "description": "Header background.",
+              "name": "--argus-header-bg"
+            },
+            {
+              "description": "Header text colour.",
+              "name": "--argus-header-fg",
+              "default": "inherit"
+            },
+            {
+              "description": "Colour of the row borders.",
+              "name": "--argus-border-color"
+            },
+            {
+              "description": "Width of the row borders.",
+              "name": "--argus-border-width",
+              "default": "1px"
+            },
+            {
+              "description": "Height of a row. Default per density: 32px, 40px, 52px.",
+              "name": "--argus-row-height"
+            },
+            {
+              "description": "Inline padding of cells. Default per density: 8px, 12px, 16px.",
+              "name": "--argus-cell-padding-inline"
+            },
+            {
+              "description": "Background of odd rows. Default: no stripes.",
+              "name": "--argus-row-stripe-bg"
+            },
+            {
+              "description": "Shadow on the pinned edge, as a `box-shadow` falling toward the end side (`4px 0 6px -4px …`). Mirrored for the end edge and in RTL; `none` removes it.",
+              "name": "--argus-pinned-shadow"
+            },
+            {
+              "description": "Colour of the resize handle's line, shown on hover, focus and drag.",
+              "name": "--argus-resize-handle-color"
+            },
+            {
+              "description": "Outline of the focused header or cell.",
+              "name": "--argus-focus-ring",
+              "default": "2px solid Highlight"
+            },
+            {
+              "description": "Background of the hovered row. Default: no change.",
+              "name": "--argus-row-hover-bg"
+            },
+            {
+              "description": "Reserved for row selection, which comes after v0.1. The table doesn't read it yet.",
+              "name": "--argus-row-selected-bg"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The scroll container that holds header and body.",
+              "name": "table"
+            },
+            {
+              "description": "The sticky header row group.",
+              "name": "header"
+            },
+            {
+              "description": "The header row.",
+              "name": "header-row"
+            },
+            {
+              "description": "Every header cell.",
+              "name": "header-cell"
+            },
+            {
+              "description": "The header of the sorted column. The direction is in `aria-sort`.",
+              "name": "header-cell-sorted"
+            },
+            {
+              "description": "The drag handle on the inline-end edge of a resizable column's header.",
+              "name": "resize-handle"
+            },
+            {
+              "description": "The row group holding the rendered body rows.",
+              "name": "body"
+            },
+            {
+              "description": "Every body row.",
+              "name": "row"
+            },
+            {
+              "description": "Body rows with an even index (0-based).",
+              "name": "row-even"
+            },
+            {
+              "description": "Body rows with an odd index.",
+              "name": "row-odd"
+            },
+            {
+              "description": "Every body cell.",
+              "name": "cell"
+            },
+            {
+              "description": "Body cells in the sorted column.",
+              "name": "cell-sorted"
+            },
+            {
+              "description": "Body cells in a pinned column, on either side.",
+              "name": "cell-pinned"
+            },
+            {
+              "description": "The pinned body cell next to the scrolling columns (one per pinned side).",
+              "name": "cell-pinned-edge"
+            },
+            {
+              "description": "The empty-state container.",
+              "name": "empty"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Shown instead of the body when there are no rows. Default: \"No rows\".",
+              "name": "empty"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "columns",
+              "type": {
+                "text": "readonly ColumnDef<T>[]"
+              },
+              "default": "[]",
+              "description": "Column definitions. Property only: functions can't be attributes."
+            },
+            {
+              "kind": "field",
+              "name": "data",
+              "type": {
+                "text": "readonly T[]"
+              },
+              "default": "[]",
+              "description": "The rows to show. Replace the array to update; changes inside it aren't detected."
+            },
+            {
+              "kind": "field",
+              "name": "getRowId",
+              "type": {
+                "text": "(row: T, index: number) => string | undefined"
+              },
+              "description": "Returns a stable id for a row. Default: the row's index in `data`."
+            },
+            {
+              "kind": "field",
+              "name": "rowHeight",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Row height in px. Unset: the density (or the `--argus-row-height` token) decides.",
+              "attribute": "row-height"
+            },
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "Density"
+              },
+              "default": "'comfortable'",
+              "description": "Row density: `compact`, `comfortable` or `spacious`.",
+              "attribute": "density",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "overscan",
+              "type": {
+                "text": "number"
+              },
+              "default": "6",
+              "description": "Rows rendered above and below the visible ones.",
+              "attribute": "overscan"
+            },
+            {
+              "kind": "field",
+              "name": "sorting",
+              "type": {
+                "text": "SortState"
+              },
+              "description": "The sort order, e.g. `[{ id: 'total', desc: true }]`; `[]` when unsorted. Unset,\nthe table keeps it itself and header clicks change it. Once set, it is\ncontrolled: a click only fires `argus-sort-change` with the proposed order,\nand nothing changes until you set the property. Set `undefined` to hand it back."
+            },
+            {
+              "kind": "field",
+              "name": "columnSizing",
+              "type": {
+                "text": "ColumnSizingState"
+              },
+              "description": "Resized widths in px by column id, e.g. `{ name: 240 }`. A resized flex column\nbecomes fixed. Uncontrolled until set, like `sorting`: once set, a resize only\nfires `argus-column-resize` with the proposed widths. `undefined` hands it back."
+            },
+            {
+              "kind": "method",
+              "name": "scrollToRow",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Scrolls so that the row at `index` (in the current row order) is at the top."
+            }
+          ],
+          "events": [
+            {
+              "description": "A sortable header was clicked, or activated with Enter or Space. `detail: { sorting }`: the new order, or the proposed one when `sorting` is controlled.",
+              "name": "argus-sort-change"
+            },
+            {
+              "description": "A column was resized by dragging its handle or with Alt+Arrow on its header. `detail: { columnId, width, sizing }`: the new widths, or the proposed ones when `columnSizing` is controlled. Fires on every frame of a drag.",
+              "name": "argus-column-resize"
+            },
+            {
+              "description": "A body cell was clicked, or Enter was pressed on it. `detail: { row, columnId, value }`. Fires before `argus-row-click`.",
+              "name": "argus-cell-click"
+            },
+            {
+              "description": "A body row was clicked, or Enter was pressed on one of its cells. `detail: { row, rowId, index }`.",
+              "name": "argus-row-click"
+            },
+            {
+              "description": "The visible rows changed. `detail: { start, end }` (row indices, inclusive).",
+              "name": "argus-range-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "row-height",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Row height in px. Unset: the density (or the `--argus-row-height` token) decides.",
+              "fieldName": "rowHeight"
+            },
+            {
+              "name": "density",
+              "type": {
+                "text": "Density"
+              },
+              "default": "'comfortable'",
+              "description": "Row density: `compact`, `comfortable` or `spacious`.",
+              "fieldName": "density"
+            },
+            {
+              "name": "overscan",
+              "type": {
+                "text": "number"
+              },
+              "default": "6",
+              "description": "Rows rendered above and below the visible ones.",
+              "fieldName": "overscan"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "summary": "Data table with pinned rows and columns and infinite loading.",
+          "tagName": "argus-table",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ArgusTable",
+          "declaration": {
+            "name": "ArgusTable",
+            "module": "src/argus-table.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "argus-table",
+          "declaration": {
+            "name": "ArgusTable",
+            "module": "src/argus-table.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/events.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "RANGE_CHANGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'argus-range-change'",
+          "description": "Fired after an update when the visible row range changed."
+        },
+        {
+          "kind": "variable",
+          "name": "SORT_CHANGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'argus-sort-change'",
+          "description": "Fired after the sort order changed (uncontrolled), or with the proposed order (controlled)."
+        },
+        {
+          "kind": "variable",
+          "name": "COLUMN_RESIZE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'argus-column-resize'",
+          "description": "Fired when a column was resized (uncontrolled), or with the proposed widths (controlled)."
+        },
+        {
+          "kind": "variable",
+          "name": "ROW_CLICK",
+          "type": {
+            "text": "string"
+          },
+          "default": "'argus-row-click'",
+          "description": "Fired when a body row was clicked, after `argus-cell-click`."
+        },
+        {
+          "kind": "variable",
+          "name": "CELL_CLICK",
+          "type": {
+            "text": "string"
+          },
+          "default": "'argus-cell-click'",
+          "description": "Fired when a body cell was clicked, before `argus-row-click`."
+        },
+        {
+          "kind": "function",
+          "name": "fire",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "detail",
+              "type": {
+                "text": "unknown"
+              }
+            }
+          ],
+          "description": "Dispatches a bubbling, composed `CustomEvent`, the shape of every public event."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RANGE_CHANGE",
+          "declaration": {
+            "name": "RANGE_CHANGE",
+            "module": "src/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SORT_CHANGE",
+          "declaration": {
+            "name": "SORT_CHANGE",
+            "module": "src/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "COLUMN_RESIZE",
+          "declaration": {
+            "name": "COLUMN_RESIZE",
+            "module": "src/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ROW_CLICK",
+          "declaration": {
+            "name": "ROW_CLICK",
+            "module": "src/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CELL_CLICK",
+          "declaration": {
+            "name": "CELL_CLICK",
+            "module": "src/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fire",
+          "declaration": {
+            "name": "fire",
+            "module": "src/events.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ArgusTable",
+          "declaration": {
+            "name": "ArgusTable",
+            "module": "./argus-table.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CELL_CLICK",
+          "declaration": {
+            "name": "CELL_CLICK",
+            "module": "./events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "COLUMN_RESIZE",
+          "declaration": {
+            "name": "COLUMN_RESIZE",
+            "module": "./events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RANGE_CHANGE",
+          "declaration": {
+            "name": "RANGE_CHANGE",
+            "module": "./events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ROW_CLICK",
+          "declaration": {
+            "name": "ROW_CLICK",
+            "module": "./events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SORT_CHANGE",
+          "declaration": {
+            "name": "SORT_CHANGE",
+            "module": "./events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/types.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/types.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CellClickDetail",
+          "declaration": {
+            "name": "CellClickDetail",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CellContext",
+          "declaration": {
+            "name": "CellContext",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColumnAlign",
+          "declaration": {
+            "name": "ColumnAlign",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColumnPin",
+          "declaration": {
+            "name": "ColumnPin",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColumnResizeDetail",
+          "declaration": {
+            "name": "ColumnResizeDetail",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColumnSizingState",
+          "declaration": {
+            "name": "ColumnSizingState",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColumnWidth",
+          "declaration": {
+            "name": "ColumnWidth",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RangeChangeDetail",
+          "declaration": {
+            "name": "RangeChangeDetail",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RowClickDetail",
+          "declaration": {
+            "name": "RowClickDetail",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SortChangeDetail",
+          "declaration": {
+            "name": "SortChangeDetail",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SortItem",
+          "declaration": {
+            "name": "SortItem",
+            "package": "@argus-table/core"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SortState",
+          "declaration": {
+            "name": "SortState",
+            "package": "@argus-table/core"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/resize-drag.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "startResizeDrag",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "handle",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "down",
+              "type": {
+                "text": "PointerEvent"
+              }
+            },
+            {
+              "name": "startWidth",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "direction",
+              "type": {
+                "text": "1 | -1"
+              }
+            },
+            {
+              "name": "onWidth",
+              "type": {
+                "text": "(width: number) => void"
+              }
+            }
+          ],
+          "description": "One pointer drag on a resize handle. The pointer is captured, so the drag keeps\nworking outside the handle, and moves are batched to one `onWidth` call per\nanimation frame (TanStack's `onChange` mode: the width updates while dragging).\n\n`direction` is 1 in LTR and -1 in RTL: the handle sits on the inline-end edge,\nso moving toward the inline end always grows the column."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "startResizeDrag",
+          "declaration": {
+            "name": "startResizeDrag",
+            "module": "src/controllers/resize-drag.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/table-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Owns the table model (core's TanStack adapter). The element pushes its\nproperties in from `willUpdate`; render functions read `model`. It needs no\nlifecycle hooks yet: the model is pull-based and owns no state.",
+          "name": "TableController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "model",
+              "type": {
+                "text": "TableModel<T, CellContent>"
+              },
+              "readonly": true
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TableController",
+          "declaration": {
+            "name": "TableController",
+            "module": "src/controllers/table-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/controllers/virtual-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Row virtualization (TanStack Virtual) plus the row pool: which rows render,\nwhere, and which pool slot's DOM each one uses. The virtualizer registers itself\nwith the host and requests updates on scroll.",
+          "name": "VirtualController",
+          "members": [
+            {
+              "kind": "method",
+              "name": "configure",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "VirtualConfig"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "computeWindow",
+              "return": {
+                "type": {
+                  "text": "VirtualWindow"
+                }
+              },
+              "description": "Computes the rendered window and updates the pool. Call once per render."
+            },
+            {
+              "kind": "field",
+              "name": "poolSize",
+              "type": {
+                "text": "number"
+              },
+              "description": "Number of pool slots created so far: bounded by the most rows rendered at once.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "scrollToIndex",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "align",
+                  "default": "'start'",
+                  "type": {
+                    "text": "'start' | 'auto'"
+                  }
+                }
+              ],
+              "description": "`'start'` puts the row at the top; `'auto'` scrolls only as far as needed to show it."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "VirtualController",
+          "declaration": {
+            "name": "VirtualController",
+            "module": "src/controllers/virtual-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/render/body.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderBody",
+          "parameters": [
+            {
+              "name": "rows",
+              "type": {
+                "text": "readonly WindowRow[]"
+              }
+            },
+            {
+              "name": "columns",
+              "type": {
+                "text": "Columns<T>"
+              }
+            },
+            {
+              "name": "totalSize",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "active",
+              "type": {
+                "text": "ActiveCell | undefined"
+              }
+            }
+          ],
+          "description": "The virtualized body. Rows are keyed by pool slot, so a row entering the window\nreuses the DOM of one that left (ADR 0001), and they stay in pool order: screen\nreaders get the position from `aria-rowindex` (the header row is 1)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderBody",
+          "declaration": {
+            "name": "renderBody",
+            "module": "src/render/body.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/render/cells.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderLightDom",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "model",
+              "type": {
+                "text": "TableModel<T, CellContent>"
+              }
+            },
+            {
+              "name": "rows",
+              "type": {
+                "text": "readonly WindowRow[]"
+              }
+            }
+          ],
+          "description": "Renders header and cell content into the host's light DOM, as direct children\n(a slot only takes the host's own children). Keyed and ordered by pool slot,\nso recycled content updates in place instead of moving (ADR 0001)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderLightDom",
+          "declaration": {
+            "name": "renderLightDom",
+            "module": "src/render/cells.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/render/content.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "toChild",
+          "return": {
+            "type": {
+              "text": "unknown"
+            }
+          },
+          "parameters": [
+            {
+              "name": "content",
+              "type": {
+                "text": "CellContent | null | undefined"
+              }
+            }
+          ],
+          "description": "Turns header or cell content into a Lit child."
+        },
+        {
+          "kind": "function",
+          "name": "formatValue",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "unknown"
+              }
+            }
+          ],
+          "description": "Default cell text for an accessor value."
+        },
+        {
+          "kind": "function",
+          "name": "cellSlot",
+          "parameters": [
+            {
+              "name": "slot",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "colIndex",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Private slot names (ADR 0001): cells by pool slot and column, headers by column."
+        },
+        {
+          "kind": "function",
+          "name": "headerSlot",
+          "parameters": [
+            {
+              "name": "colIndex",
+              "type": {
+                "text": "number"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "cellParts",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "column",
+              "type": {
+                "text": "Pinnable & { sorted: 'asc' | 'desc' | false }"
+              }
+            }
+          ],
+          "description": "Part list of a body cell: state is in the part name (`::part()` can't take attribute selectors)."
+        },
+        {
+          "kind": "function",
+          "name": "ariaSort",
+          "return": {
+            "type": {
+              "text": "'ascending' | 'descending' | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "sorted",
+              "type": {
+                "text": "'asc' | 'desc' | false"
+              }
+            }
+          ],
+          "description": "`aria-sort` for a header: only the sorted column carries it (WAI-ARIA APG)."
+        },
+        {
+          "kind": "function",
+          "name": "pinStyle",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "column",
+              "type": {
+                "text": "Pinnable & { offset: number }"
+              }
+            }
+          ],
+          "description": "Inline style of a pinned cell: its sticky inset, from the start or the end edge."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "toChild",
+          "declaration": {
+            "name": "toChild",
+            "module": "src/render/content.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatValue",
+          "declaration": {
+            "name": "formatValue",
+            "module": "src/render/content.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "cellSlot",
+          "declaration": {
+            "name": "cellSlot",
+            "module": "src/render/content.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "headerSlot",
+          "declaration": {
+            "name": "headerSlot",
+            "module": "src/render/content.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "cellParts",
+          "declaration": {
+            "name": "cellParts",
+            "module": "src/render/content.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ariaSort",
+          "declaration": {
+            "name": "ariaSort",
+            "module": "src/render/content.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "pinStyle",
+          "declaration": {
+            "name": "pinStyle",
+            "module": "src/render/content.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/render/header.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderHeader",
+          "parameters": [
+            {
+              "name": "columns",
+              "type": {
+                "text": "readonly ColumnView<T, CellContent>[]"
+              }
+            },
+            {
+              "name": "handlers",
+              "type": {
+                "text": "HeaderHandlers"
+              }
+            },
+            {
+              "name": "activeCol",
+              "type": {
+                "text": "string | undefined"
+              }
+            }
+          ],
+          "description": "The sticky header row. Header content is slotted from the light DOM. Pinned\nheader cells use the same private `data-pin` hooks as body cells, but no parts.\nEvery header carries `data-col` (its column id) and sortable ones also\n`data-sort-col`; the element's delegated handlers read them. Headers take part\nin the grid's roving tabindex: the active one is the tab stop (`activeCol`).\nResizable columns get a `resize-handle` on the header's inline-end edge. It is\nnot focusable: the focused header resizes with Alt+Arrow."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderHeader",
+          "declaration": {
+            "name": "renderHeader",
+            "module": "src/render/header.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/styles/base.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "baseStyles",
+          "default": "css` @layer argus-base { :host { display: block; /* A table that virtualizes needs a bounded height; set your own on the element. */ block-size: 400px; box-sizing: border-box; contain: content; color-scheme: light dark; color: var(--argus-fg, CanvasText); background: var(--argus-bg, Canvas); font: var(--argus-font, inherit); --_row-height: var(--argus-row-height, 40px); --_pad: var(--argus-cell-padding-inline, 12px); --_border: var(--argus-border-width, 1px) solid var(--argus-border-color, light-dark(#e5e7eb, #374151)); /* 1 in LTR, -1 in RTL: mirrors the pinned-edge shadow. */ --_dir: 1; } :host(:dir(rtl)) { --_dir: -1; } :host([density='compact']) { --_row-height: var(--argus-row-height, 32px); --_pad: var(--argus-cell-padding-inline, 8px); } :host([density='spacious']) { --_row-height: var(--argus-row-height, 52px); --_pad: var(--argus-cell-padding-inline, 16px); } :host([hidden]) { display: none; } [part~='table'] { position: relative; block-size: 100%; overflow: auto; overscroll-behavior: contain; /* A cell moved to by keyboard scrolls clear of the sticky header and pinned columns. */ scroll-padding-block-start: var(--_row-height); scroll-padding-inline: var(--_pin-start, 0) var(--_pin-end, 0); } .row { display: grid; grid-template-columns: var(--_cols); inline-size: var(--_width); min-inline-size: 100%; block-size: var(--_row-height); box-sizing: border-box; } [part~='header'] { position: sticky; inset-block-start: 0; z-index: 2; } [part~='body'] { position: relative; contain: layout; } [part~='row'] { position: absolute; inset-block-start: 0; inset-inline-start: 0; --_row-bg: var(--argus-bg, Canvas); --_row-surface: var(--_row-bg); background: var(--_row-surface); } [part~='row-odd'] { --_row-bg: var(--argus-row-stripe-bg, var(--argus-bg, Canvas)); } [part~='row']:hover { --_row-surface: var(--argus-row-hover-bg, var(--_row-bg)); } [part~='cell'], [part~='header-cell'] { display: flex; align-items: center; min-inline-size: 0; box-sizing: border-box; padding-inline: var(--_pad); overflow: hidden; white-space: nowrap; border-block-end: var(--_border); } [part~='header-cell'] { background: var(--argus-header-bg, light-dark(#f9fafb, #111827)); color: var(--argus-header-fg, inherit); font-weight: 600; } [part~='header-cell'] { position: relative; } [part~='resize-handle'] { position: absolute; inset-block: 0; inset-inline-end: 0; inline-size: 8px; z-index: 1; cursor: col-resize; touch-action: none; } [part~='resize-handle']::after { content: ''; position: absolute; inset-block: 25%; inset-inline-end: 0; inline-size: 2px; background: var(--argus-resize-handle-color, light-dark(#9ca3af, #6b7280)); opacity: 0; } [part~='header-cell']:hover [part~='resize-handle']::after, [part~='header-cell']:focus-visible [part~='resize-handle']::after, [part~='resize-handle'][data-active]::after { opacity: 1; } [data-sort-col] { cursor: pointer; user-select: none; } [part~='header-cell']:focus-visible, [part~='cell']:focus-visible { outline: var(--argus-focus-ring, 2px solid Highlight); outline-offset: -2px; } /* A small chevron after the header content; only the sorted column shows it. */ .sort-indicator { flex: none; inline-size: 0.35em; block-size: 0.35em; margin-inline-start: 0.4em; /* Physical sides on purpose: the chevron is rotated, so it must not mirror in RTL. */ border-right: 0.12em solid currentColor; border-bottom: 0.12em solid currentColor; visibility: hidden; } [aria-sort] .sort-indicator { visibility: visible; } [aria-sort='ascending'] .sort-indicator { transform: translateY(0.1em) rotate(-135deg); } [aria-sort='descending'] .sort-indicator { transform: translateY(-0.1em) rotate(45deg); } [data-align='end'] .sort-indicator { order: -1; margin-inline: 0 0.4em; } /* * Pinned columns: sticky inside the scroll container, with offsets from the * table model. Logical insets make RTL work without extra rules. */ [data-pin] { position: sticky; z-index: 1; /* Visible so the edge shadow isn't clipped; slotted content still clips itself. */ overflow: visible; } [data-pin='start'] { inset-inline-start: var(--_pin-offset); } [data-pin='end'] { inset-inline-end: var(--_pin-offset); } [part~='cell-pinned'] { background: var(--_row-surface); } /* * The edge shadow. --argus-pinned-shadow is written for a shadow falling * toward the end side; the start edge in RTL and the end edge in LTR mirror it. */ [data-pin-edge]::after { content: ''; position: absolute; inset: 0; pointer-events: none; box-shadow: var( --argus-pinned-shadow, 4px 0 6px -4px light-dark(rgb(0 0 0 / 0.2), rgb(0 0 0 / 0.6)) ); transform: scaleX(var(--_dir)); } [data-pin='end'][data-pin-edge]::after { transform: scaleX(calc(-1 * var(--_dir))); } [data-align='center'] { justify-content: center; text-align: center; } [data-align='end'] { justify-content: flex-end; text-align: end; } ::slotted(*) { min-inline-size: 0; overflow: hidden; text-overflow: ellipsis; } [part~='empty'] { display: flex; align-items: center; justify-content: center; min-block-size: calc(100% - var(--_row-height)); padding: var(--_pad); box-sizing: border-box; } /* Measures the resolved row height in px for the virtualizer. */ .probe { position: absolute; inset-block-start: 0; inline-size: 0; block-size: var(--_row-height); visibility: hidden; pointer-events: none; } } `",
+          "description": "Base styles. Everything sits in `@layer argus-base`, and every value reads a\npublic token with a neutral fallback, so themes and page CSS always win.\n`--_*` properties are private."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "baseStyles",
+          "declaration": {
+            "name": "baseStyles",
+            "module": "src/styles/base.ts"
+          }
+        }
+      ]
+    }
+  ]
+}