snice 7.8.0 → 7.9.0

package/dist/components/table/snice-table.types.d.ts

@@ -236,6 +236,22 @@ export type PaginationMode = 'client' | 'server';
  * convention used across this file (attribute-reflectable, ergonomic to assign).
  */
 export type SelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * How the columns relate to the width of the frame they are painted in.
+ *
+ * `scroll` (the default, and the historical behavior): a column never goes
+ * below its `minWidth`. A frame too narrow for the minimums overflows into the
+ * frame's own horizontal scroller, so every column keeps a readable width and
+ * the reader scrolls to the ones that did not fit.
+ *
+ * `squish`: the frame's width is the hard constraint and `minWidth` is relaxed
+ * to a bare legibility floor. Every visible column shares the frame, cell
+ * content ellipsises, and the table NEVER scrolls horizontally — the rightmost
+ * column edge sits on the frame's inner edge at any width. Resizing is still
+ * allowed; the columns beside the dragged one give up (or take back) the
+ * difference so the total stays inside the frame.
+ */
+export type ColumnFit = 'scroll' | 'squish';
 /**
  * The real public surface of `SniceTable` (components/table/snice-table.ts),
  * enumerated directly from the class — every `@property`, every plain public
@@ -298,6 +314,7 @@ export interface SniceTableElement extends HTMLElement {
     editable: boolean;
     editMode: 'cell' | 'row';
     density: 'compact' | 'standard' | 'comfortable';
+    columnFit: ColumnFit;
     columnResize: boolean;
     headerFilters: boolean;
     quickFilter: boolean;

package/dist/components/table/table-cell-presentation.d.ts

@@ -1,4 +1,18 @@
 import type { ColumnDefinition } from './snice-table.types';
+/** The alignment a column type renders with when the column declares none. */
+export declare function defaultCellAlign(type?: string): 'left' | 'center' | 'right';
+/**
+ * The value a typed cell holds when the row has nothing to show — the row field
+ * is null, or the row never carried the field at all.
+ *
+ * Each typed cell owns its value semantics: `false` for boolean, `0` for
+ * rating/progress/duration/filesize, `null` for JSON, `''` for the text-shaped
+ * rest. Handing every empty value the same `''` instead lets the cell's typed
+ * attribute converter re-read that empty string as a value of the wrong
+ * meaning — `''` on a Boolean property is an attribute that is *present*, i.e.
+ * `true`, and `''` on an Object property parses to `{}`.
+ */
+export declare function emptyCellValue(type?: string): any;
 /**
  * Give every standalone specialized table cell the common ColumnDefinition
  * presentation contract. The observer reapplies after Snice's differential
@@ -10,10 +24,9 @@ import type { ColumnDefinition } from './snice-table.types';
  * fallback, so `formatter` wins. `formatterOverride` says the cell does NOT
  * apply `column.formatter` itself, so this module owns both formatters for it.
  *
- * A host marked `formatted` was handed its display text as `value` by the
- * table, which already resolved the pipeline. Its content is that text
- * verbatim — the marker exists so a rating/progress/link/tag cell, which
- * renders structure rather than text, still shows the formatted string.
+ * Table-rendered cells never arrive here with a formatter: `createCellElement`
+ * resolves the pipeline once and hands the text cell the formatted string. This
+ * path serves the declarative and standalone cells, which own a full column.
  */
 export declare function installCellPresentation(host: HTMLElement & {
     column?: ColumnDefinition | null;

package/dist/components/table/table-cell-presentation.js

@@ -6,6 +6,37 @@ const presentationProperties = [
     'fontSize',
     'textDecoration',
 ];
+/** The alignment a column type renders with when the column declares none. */
+function defaultCellAlign(type) {
+    if (['number', 'currency', 'percent', 'percentage', 'duration', 'filesize',
+        'accounting', 'scientific', 'fraction'].includes(type || ''))
+        return 'right';
+    if (['boolean', 'rating', 'image'].includes(type || ''))
+        return 'center';
+    return 'left';
+}
+/**
+ * The value a typed cell holds when the row has nothing to show — the row field
+ * is null, or the row never carried the field at all.
+ *
+ * Each typed cell owns its value semantics: `false` for boolean, `0` for
+ * rating/progress/duration/filesize, `null` for JSON, `''` for the text-shaped
+ * rest. Handing every empty value the same `''` instead lets the cell's typed
+ * attribute converter re-read that empty string as a value of the wrong
+ * meaning — `''` on a Boolean property is an attribute that is *present*, i.e.
+ * `true`, and `''` on an Object property parses to `{}`.
+ */
+function emptyCellValue(type) {
+    switch (type) {
+        case 'boolean': return false;
+        case 'rating':
+        case 'progress':
+        case 'duration':
+        case 'filesize': return 0;
+        case 'json': return null;
+        default: return '';
+    }
+}
 const installed = new WeakMap();
 const appliedClasses = new WeakMap();
 /**
@@ -19,10 +50,9 @@ const appliedClasses = new WeakMap();
  * fallback, so `formatter` wins. `formatterOverride` says the cell does NOT
  * apply `column.formatter` itself, so this module owns both formatters for it.
  *
- * A host marked `formatted` was handed its display text as `value` by the
- * table, which already resolved the pipeline. Its content is that text
- * verbatim — the marker exists so a rating/progress/link/tag cell, which
- * renders structure rather than text, still shows the formatted string.
+ * Table-rendered cells never arrive here with a formatter: `createCellElement`
+ * resolves the pipeline once and hands the text cell the formatted string. This
+ * path serves the declarative and standalone cells, which own a full column.
  */
 function installCellPresentation(host, formatterOverride = false) {
     if (installed.has(host))
@@ -75,12 +105,8 @@ function installCellPresentation(host, formatterOverride = false) {
             const formatter = column.formatter
                 ? (formatterOverride ? column.formatter : null)
                 : column.valueFormatter;
-            // Pre-formatted hosts read the attribute, not the property: a cell whose
-            // value property is typed (boolean, number) coerces the display string.
-            const display = host.hasAttribute('formatted')
-                ? (host.getAttribute('value') ?? '')
-                : (formatter ? String(formatter(host.value, host.rowData) ?? '') : null);
-            if (display !== null) {
+            if (formatter) {
+                const display = String(formatter(host.value, host.rowData) ?? '');
                 const content = host.shadowRoot?.querySelector('[part~="content"]');
                 if (content && (content.textContent !== display || content.childElementCount > 0)) {
                     content.textContent = display;
@@ -101,5 +127,5 @@ function installCellPresentation(host, formatterOverride = false) {
     queueMicrotask(sync);
 }
 
-export { installCellPresentation };
+export { defaultCellAlign, emptyCellValue, installCellPresentation };
 //# sourceMappingURL=table-cell-presentation.js.map

package/dist/components/table/table-cell-presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"table-cell-presentation.js","sources":["../../../../components/table/table-cell-presentation.ts"],"sourcesContent":["import type { ColumnDefinition, CellStyle } from './snice-table.types';\n\nconst presentationProperties: Array<keyof CellStyle> = [\n  'backgroundColor',\n  'color',\n  'fontWeight',\n  'fontStyle',\n  'fontSize',\n  'textDecoration',\n];\n\nconst installed = new WeakMap<HTMLElement, MutationObserver>();\nconst appliedClasses = new WeakMap<HTMLElement, string[]>();\n\n/**\n * Give every standalone specialized table cell the common ColumnDefinition\n * presentation contract. The observer reapplies after Snice's differential\n * renderer changes shadow content; equality guards prevent mutation loops.\n *\n * Display formatters\n * ------------------\n * `formatter` is the column's display formatter and `valueFormatter` its\n * fallback, so `formatter` wins. `formatterOverride` says the cell does NOT\n * apply `column.formatter` itself, so this module owns both formatters for it.\n *\n * A host marked `formatted` was handed its display text as `value` by the\n * table, which already resolved the pipeline. Its content is that text\n * verbatim — the marker exists so a rating/progress/link/tag cell, which\n * renders structure rather than text, still shows the formatted string.\n */\nexport function installCellPresentation(\n  host: HTMLElement & { column?: ColumnDefinition | null; value?: any; rowData?: any },\n  formatterOverride = false,\n) {\n  if (installed.has(host)) return;\n  let observer: MutationObserver | null = null;\n  let syncing = false;\n\n  const sync = () => {\n    if (syncing) return;\n    syncing = true;\n    observer?.disconnect();\n    try {\n      const column = host.column;\n      for (const className of appliedClasses.get(host) || []) host.classList.remove(className);\n      appliedClasses.set(host, []);\n      for (const property of presentationProperties) (host.style as any)[property] = '';\n      host.removeAttribute('title');\n      if (!column) return;\n\n      const applyStyle = (style?: CellStyle) => {\n        if (!style) return;\n        for (const property of presentationProperties) {\n          const value = style[property];\n          if (value) (host.style as any)[property] = value;\n        }\n      };\n\n      applyStyle(column.style);\n      for (const rule of column.conditionalFormats || []) {\n        if (!rule.condition(host.value, host.rowData)) continue;\n        applyStyle(rule.style);\n        if (rule.className) {\n          host.classList.add(rule.className);\n          appliedClasses.set(host, [rule.className]);\n        }\n        break;\n      }\n\n      if (column.tooltip) {\n        host.title = typeof column.tooltip === 'function'\n          ? column.tooltip(host.value, host.rowData)\n          : (host.value == null ? '' : String(host.value));\n      }\n\n      // `formatter` beats `valueFormatter`. A cell that applies `formatter`\n      // itself has already painted it, so the fallback must not overwrite that\n      // content — only a formatter-less column falls through to valueFormatter.\n      const formatter = column.formatter\n        ? (formatterOverride ? column.formatter : null)\n        : column.valueFormatter;\n      // Pre-formatted hosts read the attribute, not the property: a cell whose\n      // value property is typed (boolean, number) coerces the display string.\n      const display = host.hasAttribute('formatted')\n        ? (host.getAttribute('value') ?? '')\n        : (formatter ? String(formatter(host.value, host.rowData) ?? '') : null);\n      if (display !== null) {\n        const content = host.shadowRoot?.querySelector('[part~=\"content\"]') as HTMLElement | null;\n        if (content && (content.textContent !== display || content.childElementCount > 0)) {\n          content.textContent = display;\n        }\n      }\n    } finally {\n      syncing = false;\n      if (observer && host.shadowRoot) {\n        observer.observe(host.shadowRoot, { childList: true, subtree: true, characterData: true });\n      }\n    }\n  };\n\n  observer = new MutationObserver(sync);\n  if (host.shadowRoot) observer.observe(host.shadowRoot, { childList: true, subtree: true, characterData: true });\n  installed.set(host, observer);\n  queueMicrotask(sync);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"table-cell-presentation.js","sources":["../../../../components/table/table-cell-presentation.ts"],"sourcesContent":["import type { ColumnDefinition, CellStyle } from './snice-table.types';\n\nconst presentationProperties: Array<keyof CellStyle> = [\n  'backgroundColor',\n  'color',\n  'fontWeight',\n  'fontStyle',\n  'fontSize',\n  'textDecoration',\n];\n\n/** The alignment a column type renders with when the column declares none. */\nexport function defaultCellAlign(type?: string): 'left' | 'center' | 'right' {\n  if (['number', 'currency', 'percent', 'percentage', 'duration', 'filesize',\n       'accounting', 'scientific', 'fraction'].includes(type || '')) return 'right';\n  if (['boolean', 'rating', 'image'].includes(type || '')) return 'center';\n  return 'left';\n}\n\n/**\n * The value a typed cell holds when the row has nothing to show — the row field\n * is null, or the row never carried the field at all.\n *\n * Each typed cell owns its value semantics: `false` for boolean, `0` for\n * rating/progress/duration/filesize, `null` for JSON, `''` for the text-shaped\n * rest. Handing every empty value the same `''` instead lets the cell's typed\n * attribute converter re-read that empty string as a value of the wrong\n * meaning — `''` on a Boolean property is an attribute that is *present*, i.e.\n * `true`, and `''` on an Object property parses to `{}`.\n */\nexport function emptyCellValue(type?: string): any {\n  switch (type) {\n    case 'boolean': return false;\n    case 'rating':\n    case 'progress':\n    case 'duration':\n    case 'filesize': return 0;\n    case 'json': return null;\n    default: return '';\n  }\n}\n\nconst installed = new WeakMap<HTMLElement, MutationObserver>();\nconst appliedClasses = new WeakMap<HTMLElement, string[]>();\n\n/**\n * Give every standalone specialized table cell the common ColumnDefinition\n * presentation contract. The observer reapplies after Snice's differential\n * renderer changes shadow content; equality guards prevent mutation loops.\n *\n * Display formatters\n * ------------------\n * `formatter` is the column's display formatter and `valueFormatter` its\n * fallback, so `formatter` wins. `formatterOverride` says the cell does NOT\n * apply `column.formatter` itself, so this module owns both formatters for it.\n *\n * Table-rendered cells never arrive here with a formatter: `createCellElement`\n * resolves the pipeline once and hands the text cell the formatted string. This\n * path serves the declarative and standalone cells, which own a full column.\n */\nexport function installCellPresentation(\n  host: HTMLElement & { column?: ColumnDefinition | null; value?: any; rowData?: any },\n  formatterOverride = false,\n) {\n  if (installed.has(host)) return;\n  let observer: MutationObserver | null = null;\n  let syncing = false;\n\n  const sync = () => {\n    if (syncing) return;\n    syncing = true;\n    observer?.disconnect();\n    try {\n      const column = host.column;\n      for (const className of appliedClasses.get(host) || []) host.classList.remove(className);\n      appliedClasses.set(host, []);\n      for (const property of presentationProperties) (host.style as any)[property] = '';\n      host.removeAttribute('title');\n      if (!column) return;\n\n      const applyStyle = (style?: CellStyle) => {\n        if (!style) return;\n        for (const property of presentationProperties) {\n          const value = style[property];\n          if (value) (host.style as any)[property] = value;\n        }\n      };\n\n      applyStyle(column.style);\n      for (const rule of column.conditionalFormats || []) {\n        if (!rule.condition(host.value, host.rowData)) continue;\n        applyStyle(rule.style);\n        if (rule.className) {\n          host.classList.add(rule.className);\n          appliedClasses.set(host, [rule.className]);\n        }\n        break;\n      }\n\n      if (column.tooltip) {\n        host.title = typeof column.tooltip === 'function'\n          ? column.tooltip(host.value, host.rowData)\n          : (host.value == null ? '' : String(host.value));\n      }\n\n      // `formatter` beats `valueFormatter`. A cell that applies `formatter`\n      // itself has already painted it, so the fallback must not overwrite that\n      // content — only a formatter-less column falls through to valueFormatter.\n      const formatter = column.formatter\n        ? (formatterOverride ? column.formatter : null)\n        : column.valueFormatter;\n      if (formatter) {\n        const display = String(formatter(host.value, host.rowData) ?? '');\n        const content = host.shadowRoot?.querySelector('[part~=\"content\"]') as HTMLElement | null;\n        if (content && (content.textContent !== display || content.childElementCount > 0)) {\n          content.textContent = display;\n        }\n      }\n    } finally {\n      syncing = false;\n      if (observer && host.shadowRoot) {\n        observer.observe(host.shadowRoot, { childList: true, subtree: true, characterData: true });\n      }\n    }\n  };\n\n  observer = new MutationObserver(sync);\n  if (host.shadowRoot) observer.observe(host.shadowRoot, { childList: true, subtree: true, characterData: true });\n  installed.set(host, observer);\n  queueMicrotask(sync);\n}\n"],"names":[],"mappings":"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"}

package/dist/components/table/table-column-manager.d.ts

@@ -2,7 +2,9 @@
  * Column management for snice-table.
  * Handles: flex width, resize, auto-size, visibility, ordering, pinning, groups.
  */
-import type { ColumnDefinition } from './snice-table.types';
+import type { ColumnDefinition, ColumnFit } from './snice-table.types';
+/** Padding + border a cell spends before any content fits inside it. */
+export declare function horizontalCellChrome(cell: HTMLElement): number;
 export interface ColumnState {
     key: string;
     width: number;
@@ -16,6 +18,13 @@ export interface ColumnState {
     reorderable: boolean;
     hideable: boolean;
     pinnable: boolean;
+    /**
+     * Someone chose this width on purpose — the column definition declared one,
+     * the user dragged the edge, or auto-size measured the content. Only columns
+     * that never did participate in `fitVisibleColumns`, so a deliberate width is
+     * never quietly overwritten by the container's arithmetic.
+     */
+    authored: boolean;
 }
 export interface ColumnGroup {
     label: string;
@@ -30,8 +39,71 @@ export declare class TableColumnManager {
     private resizingKey;
     private resizeOverlay;
     private tableElement;
-    /** Initialize column states from column definitions */
+    private fitMode;
+    /**
+     * The content budget the last `squish` fit shared out. A drag-resize needs it
+     * to know how much width the columns beside the dragged one have to give up
+     * (or take back) for the total to stay on the frame.
+     */
+    private squishBudget;
+    /** Fallback content width for a column nobody sized. */
+    static readonly DEFAULT_WIDTH = 150;
+    /**
+     * The floor `squish` relaxes `minWidth` down to. Not zero: a column narrower
+     * than this shows no glyph at all, only its ellipsis, and stops being a
+     * column the reader can identify. A frame too narrow even for this is past
+     * what the mode can honour — see `fitVisibleColumns`.
+     */
+    static readonly SQUISH_MIN_WIDTH = 24;
+    /**
+     * Which fitting policy `fitVisibleColumns` (and a drag-resize) follows.
+     * Owned by the table's `columnFit` property; see the `ColumnFit` docs.
+     */
+    setFitMode(mode: ColumnFit): void;
+    getFitMode(): ColumnFit;
+    /**
+     * Routine resync, run on every render: make sure a state exists for each
+     * declared column and refresh the flags that are pure declaration (min/max,
+     * resizable, reorderable, hideable, pinnable, flex).
+     *
+     * Deliberately PRESERVES the interaction-owned members of an existing state —
+     * width, visible, pinned, order — because renderBody() calls this on every
+     * paint, and re-applying the declaration here would undo a drag-resize, a
+     * hidden column or a user reorder on the very next render. Re-applying the
+     * declaration is applyConfiguration()'s job, and only a `columns` assignment
+     * calls that.
+     */
     initialize(columns: ColumnDefinition[], tableEl: HTMLElement): void;
+    /**
+     * A `columns` assignment (or setColumns()) delivered a NEW CONFIGURATION.
+     *
+     * The declaration is the source of truth here: painted order, `pinned`,
+     * `width` and visibility all come from the array just assigned, and states for
+     * columns the new array no longer declares are DROPPED. Without this the first
+     * configuration the table ever saw won permanently — a re-ordered array kept
+     * the original order, a newly declared pin or width was ignored, and a column
+     * hidden through setColumnVisible() could never be brought back
+     * (MATRIX-columns-2/3/4/6).
+     *
+     * The cost is that the assignment also discards user interaction state (a
+     * drag-resize, a manual reorder, a hidden column) for the columns it
+     * re-declares. That is the intended reading of the contract, and it applies to
+     * EVERY assignment: `columns` declares `hasChanged: () => true`, so handing
+     * back the array the table already holds — after mutating it, or unchanged —
+     * re-applies the declaration exactly like a fresh array would. Mutating the
+     * published definitions is therefore NOT an escape hatch; the only way to keep
+     * user column state is to not assign `columns` at all and drive the change
+     * through the column APIs instead (setColumnVisible / moveColumn / pinColumn /
+     * unpinColumn), which mutate the state map in place. Renders triggered by this
+     * go through the table's coalescing queue, so re-applying costs no extra paint.
+     */
+    applyConfiguration(columns: ColumnDefinition[], tableEl: HTMLElement): void;
+    /**
+     * One place that turns a column definition into a state. `existing` supplies
+     * the interaction-owned members on the resync path; omitting it yields the
+     * pure declared state applyConfiguration() wants.
+     */
+    private buildState;
     private parseWidth;
     /** Get ordered, visible columns */
     getVisibleColumns(): ColumnState[];
@@ -45,6 +117,63 @@ export declare class TableColumnManager {
     getUnpinned(): ColumnState[];
     /** Compute flex widths based on available space */
     computeFlexWidths(availableWidth: number): Map<string, number>;
+    /**
+     * Fit the columns nobody sized into `availableWidth` (the frame's content
+     * box), reserving `chromePerColumn` for each column's own padding + border.
+     *
+     * A column width is a CONTENT width — the rendered column is that plus its
+     * chrome — so the budget has to come off the top or the fitted table lands a
+     * few pixels wider than the frame it was fitted to.
+     *
+     * Declared and user-chosen widths are spent first and never rewritten: a
+     * table that asked for `width: '80'` keeps 80 whatever the frame does. What
+     * is left is split evenly and clamped to each column's [minWidth, maxWidth],
+     * so a frame too narrow for the minimums overflows into the frame's own
+     * scroller instead of collapsing the columns to nothing.
+     *
+     * Returns whether any width actually moved, so callers can skip a repaint.
+     *
+     * Under `column-fit="squish"` the frame stops being a suggestion: see
+     * `squishVisibleColumns`.
+     */
+    fitVisibleColumns(availableWidth: number, chromePerColumn?: number): boolean;
+    /**
+     * The `squish` policy: the columns add up to the frame, whatever that costs.
+     *
+     * `minWidth` is a readability preference, and this mode has already decided
+     * the frame outranks it, so the only floor left is SQUISH_MIN_WIDTH. Two
+     * cases:
+     *
+     *  - There is an unsized column left to absorb the difference, and the
+     *    authored widths still leave room for it. Those are honoured exactly (a
+     *    column that asked for 80, or that the user dragged to 80, keeps 80) and
+     *    the rest is split evenly between the unsized ones.
+     *
+     *  - Every column is authored, or the authored widths alone already overflow
+     *    the frame. There is nothing left to give, so `scroll`'s escape hatch
+     *    (overflow into the frame's scroller) is exactly what this mode exists to
+     *    prevent: every column is scaled by the same factor instead. Scaling is a
+     *    fixed point — the second pass computes a factor of 1 — so this settles
+     *    on the first render rather than creeping on every repaint.
+     *
+     * Either way the remainder from integer division is handed back to the widest
+     * columns that are free to take it, so the widths sum to the budget EXACTLY
+     * and the rightmost column edge lands on the frame's inner edge instead of a
+     * few pixels short of it.
+     */
+    private squishVisibleColumns;
+    /**
+     * A drag-resize under `squish` moved one column; the others pay for it.
+     *
+     * The dragged column is the anchor — it keeps the width the pointer asked
+     * for, capped so the remaining columns can still sit on their floor — and the
+     * rest are scaled to fill exactly what is left of the frame. Without this a
+     * drag would simply push the trailing column out of a frame that is not
+     * allowed to scroll.
+     */
+    private rebalanceSquish;
+    /** Push the current widths onto the painted header and body cells. */
+    private writeWidths;
     /** Apply computed widths to <col> or <th> elements */
     applyWidths(headerRow: HTMLElement, widths: Map<string, number>): void;
     /** Start column resize. Call from mousedown on resize handle. */
@@ -53,6 +182,28 @@ export declare class TableColumnManager {
     autoSizeColumn(columnKey: string, tbody: HTMLElement): void;
     /** Auto-size all columns */
     autoSizeAll(tbody: HTMLElement): void;
+    /** Slack added to a measured content width so the last glyph never sits on
+     *  the clip edge (and a sortable header keeps room for its chevron). */
+    private static readonly AUTO_SIZE_SLACK;
+    /**
+     * Measure the columns' content and give each the width it actually needs.
+     *
+     * A table cell's `scrollWidth` is NOT its content width: for content that
+     * fits, it reports the padding box — the width the column already has. The
+     * previous implementation took that maximum and added 16px, so every
+     * "auto-size" pass could only GROW the column, by a chrome's worth each
+     * time, until the table outgrew its own frame. Once it did, the right-pinned
+     * column (`position: sticky`) parked over the columns beside it, and the
+     * columns behind it read as deleted.
+     *
+     * The width a column NEEDS is a layout question, so ask layout: drop the
+     * table into content-driven sizing (`table-layout: auto` at `max-content`)
+     * with the measured columns' imposed widths removed, and read back the width
+     * each header settles at. `max-content` also means no wrapping, so a long
+     * cell reports its full single-line extent even though the painted column
+     * ellipsises it. Everything is restored in the same task, before paint.
+     */
+    private autoSizeColumns;
     setColumnVisible(key: string, visible: boolean): void;
     showAllColumns(): void;
     hideAllColumns(): void;