graphein 0.20.0 → 0.22.0

package/dist/charts/tableView/types.d.ts

@@ -4,18 +4,27 @@ import type { ThemeTokens } from '../../theme/index.js';
 import type { FieldType, Rect } from '../../types.js';
 import type { EvidenceLedger, DataRepresentation } from '../../render/evidence.js';
 import type { LabelLedger } from '../../render/labelLedger.js';
-export declare const HEADER_ROW_HEIGHT = 32;
-export declare const MIN_COL_WIDTH = 72;
-export declare const DEFAULT_BODY_ROW_HEIGHT = 30;
-export declare const FILL_EPS = 0.5;
+import type { ColumnFormatter } from './conditional.js';
+import type { TableDensity, TableGridlines } from './style.js';
 /** A wobbly, asymmetric border-radius that reads as a hand-drawn frame. */
 export declare const SKETCH_BORDER_RADIUS = "14px 6px 16px 7px / 7px 15px 6px 14px";
+/** Line-chart, filled-area, or column sparkline drawn from a cell's numeric array. */
+export interface ViewSparkline {
+    type: 'line' | 'area' | 'bar';
+    color?: string;
+    /** Shared column scale (comparable magnitudes) or per-row scale (shape only). */
+    domain: [number, number] | 'row';
+}
 export interface ViewColumn {
+    /** Field key used to read values (not necessarily unique). */
     key: string;
+    /** Unique column identity (sort state, DOM classes). Defaults to the key. */
+    id?: string;
     title: string;
     align: 'left' | 'center' | 'right';
     format?: string;
     type?: FieldType;
+    /** Fixed width in CSS px. */
     width?: number;
     conditionalFormat?: ConditionalFormat;
     isMeasure?: boolean;
@@ -25,6 +34,14 @@ export interface ViewColumn {
     sortable?: boolean;
     wrap?: boolean;
     group?: string;
+    /** Draw the cell's numeric array as a sparkline instead of text. */
+    sparkline?: ViewSparkline;
+    /** Stepped hierarchy column of a matrix (indent + expand/collapse). */
+    rowHeader?: boolean;
+    /** A grand-total / subtotal value column of a matrix. */
+    total?: boolean;
+    /** Draws a separator before this column (column-group boundary). */
+    groupStart?: boolean;
 }
 export interface HeaderCell {
     title: string;
@@ -33,71 +50,77 @@ export interface HeaderCell {
     align?: 'left' | 'center' | 'right';
     colIndex?: number;
 }
+export interface ViewCell {
+    value: unknown;
+    raw: number | string | null;
+    /** Free text (labels) rather than a value to format. */
+    label?: boolean;
+}
+export type RowKind = 'leaf' | 'group' | 'subtotal' | 'grandtotal';
+export interface ViewRowInfo {
+    kind: RowKind;
+    /** Hierarchy level for stepped row headers. */
+    depth: number;
+    expandable?: boolean;
+    expanded?: boolean;
+    /** Accessible name of the row (row-header text). */
+    label?: string;
+}
 export interface VisibleRange {
     start: number;
     end: number;
     rowHeight: number;
 }
-export interface BuildTableOptions {
-    container: HTMLElement;
+/** What both the DOM and canvas table renderers consume. */
+export interface TableViewInput {
     tokens: ThemeTokens;
     rect: Rect;
     columns: ViewColumn[];
     rowCount: number;
-    getCell(rowIndex: number, colIndex: number): {
-        value: unknown;
-        raw: number | string | null;
-    };
-    rowClass?(rowIndex: number): 'normal' | 'subtotal' | 'grandtotal';
-    cellIndent?(rowIndex: number, colIndex: number): number;
-    rowHeaderSpan?: number;
+    getCell(rowIndex: number, colIndex: number): ViewCell;
+    rowInfo?(rowIndex: number): ViewRowInfo;
+    /** Rows matching an active highlight are tinted. */
+    highlighted?(rowIndex: number): boolean;
+    /** Leading columns pinned while scrolling horizontally (the matrix row header). */
+    frozenColumns?: number;
     striped?: boolean;
-    stickyHeader?: boolean;
-    onSort?(colIndex: number): void;
-    sortState?: {
-        col: number;
-        dir: 'asc' | 'desc';
-    };
     conditionalDomains?: Array<[number, number] | null>;
+    /** Precompiled per-column formatters; built from `conditionalDomains` when omitted. */
+    formatters?: Array<ColumnFormatter | null>;
+    /** Conditional formats apply to these row kinds only (default: leaf rows). */
+    formatKinds?: readonly RowKind[];
+    /** Per-row formatter override (a matrix scales each hierarchy level separately); null leaves the row plain. */
+    rowFormatters?(rowIndex: number): ReadonlyArray<ColumnFormatter | null> | null;
+    /** Known [min, max] numeric extremes per column for width measurement. */
+    extremes?: Array<[number, number] | null>;
     headerRows?: HeaderCell[][];
     footerRow?: {
-        cells: Array<{
-            value: unknown;
-            raw: number | string | null;
-            label?: boolean;
-        }>;
+        cells: ViewCell[];
+        kind?: 'total' | 'grandtotal';
+    };
+    density?: TableDensity;
+    gridlines?: TableGridlines;
+    sortState?: {
+        col: number;
+        dir: 'asc' | 'desc';
     };
-    density?: 'comfortable' | 'standard' | 'compact';
-    visibleRange?: VisibleRange;
-    /** Render hand-drawn chrome (wobbly frame, grid, and data bars) for sketch
-     * mode. Carries the resolved rough style (roughness/bowing/seed/...) or null. */
+    /** Hand-drawn chrome (wobbly frame, grid, and data bars) or null. */
     sketch?: ResolvedSketch | null;
-    /** Computed internally by buildTable; column pixel widths fitted to the container. */
+    /** Column pixel widths, filled in by the renderer. */
     widths?: number[];
     evidence?: EvidenceLedger;
     labels?: LabelLedger;
     dataRepresentation?: DataRepresentation;
     sourceRepresentedRows?: number;
-    refreshEvidence?: () => void;
 }
-export type CanvasTableOptions = Omit<BuildTableOptions, 'container' | 'onSort'> & {
-    ctx: CanvasRenderingContext2D;
-    clippedCue?: boolean;
-};
 export declare function formatCellValue(value: unknown, column: Pick<ViewColumn, 'format'>): string;
 export declare function formatDisplayValue(value: unknown, column: Pick<ViewColumn, 'format' | 'prefix' | 'suffix' | 'negativeStyle'>): string;
-export declare function resolveConditionalDomain(conditionalFormat: ConditionalFormat | undefined, values: readonly (number | null | undefined)[]): [number, number] | null;
-export declare function computeFittedWidths(columns: readonly ViewColumn[], available: number, minimum?: number): number[];
-export declare function sumWidths(widths: readonly number[]): number;
-export declare function densityMetrics(density: BuildTableOptions['density']): {
-    rowHeight: number;
-    headerHeight: number;
-    padding: string;
-    paddingX: number;
-};
-export declare function normalizedHeaderRows(opts: Pick<BuildTableOptions, 'headerRows' | 'columns'>): HeaderCell[][];
-export declare function defaultColumnWidth(column: ViewColumn): number;
-export declare function leftOffset(opts: BuildTableOptions, colIndex: number): number;
+/** Display text of a cell: labels verbatim, values through the column format. */
+export declare function cellText(cell: ViewCell, column: ViewColumn): string;
+export declare function defaultRowInfo(): ViewRowInfo;
+export declare function normalizedHeaderRows(opts: Pick<TableViewInput, 'headerRows' | 'columns'>): HeaderCell[][];
+export declare function columnId(column: ViewColumn, index: number): string;
 export declare function clampInt(value: number, min: number, max: number): number;
+export declare function sumWidths(widths: readonly number[], start?: number, end?: number): number;
 export declare function setStyles(styleable: HTMLElement, styles: Record<string, string>): void;
 //# sourceMappingURL=types.d.ts.map

package/dist/charts/tableView/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/charts/tableView/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/charts/tableView/types.ts"],"names":[],"mappings":"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"}

package/dist/charts/tableView/types.js

@@ -1,117 +1,52 @@
 import { formatValue } from "../../format/index.js";
-const HEADER_ROW_HEIGHT = 32;
-const MIN_COL_WIDTH = 72;
-const DEFAULT_BODY_ROW_HEIGHT = 30;
-const FILL_EPS = 0.5;
 const SKETCH_BORDER_RADIUS = "14px 6px 16px 7px / 7px 15px 6px 14px";
 function formatCellValue(value, column) {
   return formatValue(value, column.format);
 }
 function formatDisplayValue(value, column) {
+  if (value == null || value === "") return "";
   const raw = typeof value === "number" ? value : Number(value);
-  const negative = Number.isFinite(raw) && raw < 0;
-  const baseValue = negative && (column.negativeStyle === "parens" || column.negativeStyle === "parens-red") ? Math.abs(raw) : value;
-  const formatted = formatCellValue(baseValue, column);
-  const wrapped = negative && (column.negativeStyle === "parens" || column.negativeStyle === "parens-red") ? `(${formatted})` : formatted;
-  return `${column.prefix ?? ""}${wrapped}${column.suffix ?? ""}`;
+  const parens = (column.negativeStyle === "parens" || column.negativeStyle === "parens-red") && Number.isFinite(raw) && raw < 0 && typeof value !== "boolean";
+  const formatted = formatCellValue(parens ? Math.abs(raw) : value, column);
+  return `${column.prefix ?? ""}${parens ? `(${formatted})` : formatted}${column.suffix ?? ""}`;
 }
-function resolveConditionalDomain(conditionalFormat, values) {
-  if (!conditionalFormat) return null;
-  if ("domain" in conditionalFormat && conditionalFormat.domain) return conditionalFormat.domain;
-  let min = Infinity;
-  let max = -Infinity;
-  for (const value of values) {
-    if (value == null || !Number.isFinite(value)) continue;
-    if (value < min) min = value;
-    if (value > max) max = value;
-  }
-  return min === Infinity ? null : [min, max];
-}
-function computeFittedWidths(columns, available, minimum = MIN_COL_WIDTH) {
-  const natural = columns.map((column) => column.width ?? defaultColumnWidth(column));
-  const naturalTotal = natural.reduce((sum, w) => sum + w, 0) || 1;
-  if (available <= FILL_EPS) return natural;
-  if (naturalTotal <= available) {
-    const extra = available - naturalTotal;
-    return natural.map((w) => w + extra * (w / naturalTotal));
-  }
-  const widths = natural.slice();
-  for (let pass = 0; pass < columns.length; pass += 1) {
-    const total = widths.reduce((sum, w) => sum + w, 0);
-    if (total <= available + FILL_EPS) break;
-    let flexTotal = 0;
-    let fixedTotal = 0;
-    for (const w of widths) {
-      if (w > minimum + FILL_EPS) flexTotal += w;
-      else fixedTotal += w;
-    }
-    if (flexTotal <= 0) break;
-    const targetFlex = available - fixedTotal;
-    const factor = targetFlex <= 0 ? 0 : targetFlex / flexTotal;
-    for (let i = 0; i < widths.length; i += 1) {
-      if (widths[i] > minimum + FILL_EPS) {
-        widths[i] = Math.max(minimum, widths[i] * factor);
-      }
-    }
-  }
-  return widths;
+function cellText(cell, column) {
+  if (cell.label) return cell.value == null ? "" : String(cell.value);
+  if (Array.isArray(cell.value) && column.sparkline) return "";
+  return formatDisplayValue(cell.value, column);
 }
-function sumWidths(widths) {
-  return widths.reduce((sum, w) => sum + w, 0);
-}
-function densityMetrics(density) {
-  if (density === "comfortable") return { rowHeight: 36, headerHeight: 36, padding: "8px 12px", paddingX: 12 };
-  if (density === "compact") return { rowHeight: 24, headerHeight: 28, padding: "3px 8px", paddingX: 8 };
-  return { rowHeight: DEFAULT_BODY_ROW_HEIGHT, headerHeight: HEADER_ROW_HEIGHT, padding: "6px 10px", paddingX: 10 };
+function defaultRowInfo() {
+  return { kind: "leaf", depth: 0 };
 }
 function normalizedHeaderRows(opts) {
   if (opts.headerRows) return opts.headerRows;
-  return [
-    opts.columns.map((column, colIndex) => ({
-      title: column.title,
-      align: column.align,
-      colIndex
-    }))
-  ];
-}
-function defaultColumnWidth(column) {
-  if (column.width) return column.width;
-  if (column.isMeasure || column.align === "right") return 112;
-  if (column.type === "temporal") return 132;
-  return 148;
+  return [opts.columns.map((column, colIndex) => ({ title: column.title, align: column.align, colIndex }))];
 }
-function leftOffset(opts, colIndex) {
-  const widths = opts.widths ?? opts.columns.map((column) => column.width ?? defaultColumnWidth(column));
-  let left = 0;
-  for (let i = 0; i < colIndex; i += 1) left += widths[i] ?? 0;
-  return left;
+function columnId(column, index) {
+  return column.id ?? `${column.key}#${index}`;
 }
 function clampInt(value, min, max) {
   return Math.max(min, Math.min(max, Math.floor(value)));
 }
+function sumWidths(widths, start = 0, end = widths.length) {
+  let total = 0;
+  for (let i = start; i < end; i++) total += widths[i] ?? 0;
+  return total;
+}
 function setStyles(styleable, styles) {
   for (const [key, value] of Object.entries(styles)) {
-    styleable.style.setProperty(kebab(key), value);
+    styleable.style.setProperty(key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`), value);
   }
 }
-function kebab(key) {
-  return key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
-}
 export {
-  DEFAULT_BODY_ROW_HEIGHT,
-  FILL_EPS,
-  HEADER_ROW_HEIGHT,
-  MIN_COL_WIDTH,
   SKETCH_BORDER_RADIUS,
+  cellText,
   clampInt,
-  computeFittedWidths,
-  defaultColumnWidth,
-  densityMetrics,
+  columnId,
+  defaultRowInfo,
   formatCellValue,
   formatDisplayValue,
-  leftOffset,
   normalizedHeaderRows,
-  resolveConditionalDomain,
   setStyles,
   sumWidths
 };

package/dist/charts/tableView/types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/charts/tableView/types.ts"],
-  "sourcesContent": ["import type { ConditionalFormat } from '../../spec/types';\nimport type { ResolvedSketch } from '../../spec/sketch';\nimport type { ThemeTokens } from '../../theme';\nimport type { FieldType, Rect } from '../../types';\nimport { formatValue } from '../../format';\nimport type { EvidenceLedger, DataRepresentation } from '../../render/evidence';\nimport type { LabelLedger } from '../../render/labelLedger';\nexport const HEADER_ROW_HEIGHT = 32;\nexport const MIN_COL_WIDTH = 72;\nexport const DEFAULT_BODY_ROW_HEIGHT = 30;\nexport const FILL_EPS = 0.5;\n/** A wobbly, asymmetric border-radius that reads as a hand-drawn frame. */\nexport const SKETCH_BORDER_RADIUS = '14px 6px 16px 7px / 7px 15px 6px 14px';\n\nexport interface ViewColumn {\n  key: string;\n  title: string;\n  align: 'left' | 'center' | 'right';\n  format?: string;\n  type?: FieldType;\n  width?: number;\n  conditionalFormat?: ConditionalFormat;\n  isMeasure?: boolean;\n  prefix?: string;\n  suffix?: string;\n  negativeStyle?: 'sign' | 'parens' | 'red' | 'parens-red';\n  sortable?: boolean;\n  wrap?: boolean;\n  group?: string;\n}\n\nexport interface HeaderCell {\n  title: string;\n  colSpan?: number;\n  rowSpan?: number;\n  align?: 'left' | 'center' | 'right';\n  colIndex?: number;\n}\n\nexport interface VisibleRange {\n  start: number;\n  end: number;\n  rowHeight: number;\n}\n\nexport interface BuildTableOptions {\n  container: HTMLElement;\n  tokens: ThemeTokens;\n  rect: Rect;\n  columns: ViewColumn[];\n  rowCount: number;\n  getCell(rowIndex: number, colIndex: number): { value: unknown; raw: number | string | null };\n  rowClass?(rowIndex: number): 'normal' | 'subtotal' | 'grandtotal';\n  cellIndent?(rowIndex: number, colIndex: number): number;\n  rowHeaderSpan?: number;\n  striped?: boolean;\n  stickyHeader?: boolean;\n  onSort?(colIndex: number): void;\n  sortState?: { col: number; dir: 'asc' | 'desc' };\n  conditionalDomains?: Array<[number, number] | null>;\n  headerRows?: HeaderCell[][];\n  footerRow?: { cells: Array<{ value: unknown; raw: number | string | null; label?: boolean }> };\n  density?: 'comfortable' | 'standard' | 'compact';\n  visibleRange?: VisibleRange;\n  /** Render hand-drawn chrome (wobbly frame, grid, and data bars) for sketch\n   * mode. Carries the resolved rough style (roughness/bowing/seed/...) or null. */\n  sketch?: ResolvedSketch | null;\n  /** Computed internally by buildTable; column pixel widths fitted to the container. */\n  widths?: number[];\n  evidence?: EvidenceLedger;\n  labels?: LabelLedger;\n  dataRepresentation?: DataRepresentation;\n  sourceRepresentedRows?: number;\n  refreshEvidence?: () => void;\n}\n\nexport type CanvasTableOptions = Omit<BuildTableOptions, 'container' | 'onSort'> & {\n  ctx: CanvasRenderingContext2D;\n  clippedCue?: boolean;\n};\n\nexport function formatCellValue(value: unknown, column: Pick<ViewColumn, 'format'>): string {\n  return formatValue(value, column.format);\n}\n\nexport function formatDisplayValue(\n  value: unknown,\n  column: Pick<ViewColumn, 'format' | 'prefix' | 'suffix' | 'negativeStyle'>,\n): string {\n  const raw = typeof value === 'number' ? value : Number(value);\n  const negative = Number.isFinite(raw) && raw < 0;\n  const baseValue =\n    negative && (column.negativeStyle === 'parens' || column.negativeStyle === 'parens-red') ? Math.abs(raw) : value;\n  const formatted = formatCellValue(baseValue, column);\n  const wrapped = negative && (column.negativeStyle === 'parens' || column.negativeStyle === 'parens-red')\n    ? `(${formatted})`\n    : formatted;\n  return `${column.prefix ?? ''}${wrapped}${column.suffix ?? ''}`;\n}\n\nexport function resolveConditionalDomain(\n  conditionalFormat: ConditionalFormat | undefined,\n  values: readonly (number | null | undefined)[],\n): [number, number] | null {\n  if (!conditionalFormat) return null;\n  if ('domain' in conditionalFormat && conditionalFormat.domain) return conditionalFormat.domain;\n  let min = Infinity;\n  let max = -Infinity;\n  for (const value of values) {\n    if (value == null || !Number.isFinite(value)) continue;\n    if (value < min) min = value;\n    if (value > max) max = value;\n  }\n  return min === Infinity ? null : [min, max];\n}\n\nexport function computeFittedWidths(columns: readonly ViewColumn[], available: number, minimum = MIN_COL_WIDTH): number[] {\n  const natural = columns.map((column) => column.width ?? defaultColumnWidth(column));\n  const naturalTotal = natural.reduce((sum, w) => sum + w, 0) || 1;\n  if (available <= FILL_EPS) return natural;\n  if (naturalTotal <= available) {\n    const extra = available - naturalTotal;\n    return natural.map((w) => w + extra * (w / naturalTotal));\n  }\n  // Shrink to fit: iteratively scale columns above the minimum, letting any\n  // column clamped at the minimum push its deficit onto the still-flexible ones,\n  // so the total lands exactly on `available` whenever the minimums allow it.\n  const widths = natural.slice();\n  for (let pass = 0; pass < columns.length; pass += 1) {\n    const total = widths.reduce((sum, w) => sum + w, 0);\n    if (total <= available + FILL_EPS) break;\n    let flexTotal = 0;\n    let fixedTotal = 0;\n    for (const w of widths) {\n      if (w > minimum + FILL_EPS) flexTotal += w;\n      else fixedTotal += w;\n    }\n    if (flexTotal <= 0) break;\n    const targetFlex = available - fixedTotal;\n    const factor = targetFlex <= 0 ? 0 : targetFlex / flexTotal;\n    for (let i = 0; i < widths.length; i += 1) {\n      if (widths[i] > minimum + FILL_EPS) {\n        widths[i] = Math.max(minimum, widths[i] * factor);\n      }\n    }\n  }\n  return widths;\n}\n\nexport function sumWidths(widths: readonly number[]): number {\n  return widths.reduce((sum, w) => sum + w, 0);\n}\n\nexport function densityMetrics(density: BuildTableOptions['density']): {\n  rowHeight: number;\n  headerHeight: number;\n  padding: string;\n  paddingX: number;\n} {\n  if (density === 'comfortable') return { rowHeight: 36, headerHeight: 36, padding: '8px 12px', paddingX: 12 };\n  if (density === 'compact') return { rowHeight: 24, headerHeight: 28, padding: '3px 8px', paddingX: 8 };\n  return { rowHeight: DEFAULT_BODY_ROW_HEIGHT, headerHeight: HEADER_ROW_HEIGHT, padding: '6px 10px', paddingX: 10 };\n}\n\nexport function normalizedHeaderRows(opts: Pick<BuildTableOptions, 'headerRows' | 'columns'>): HeaderCell[][] {\n  if (opts.headerRows) return opts.headerRows;\n  return [\n    opts.columns.map((column, colIndex) => ({\n      title: column.title,\n      align: column.align,\n      colIndex,\n    })),\n  ];\n}\n\nexport function defaultColumnWidth(column: ViewColumn): number {\n  if (column.width) return column.width;\n  if (column.isMeasure || column.align === 'right') return 112;\n  if (column.type === 'temporal') return 132;\n  return 148;\n}\n\nexport function leftOffset(opts: BuildTableOptions, colIndex: number): number {\n  const widths = opts.widths ?? opts.columns.map((column) => column.width ?? defaultColumnWidth(column));\n  let left = 0;\n  for (let i = 0; i < colIndex; i += 1) left += widths[i] ?? 0;\n  return left;\n}\n\nexport function clampInt(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, Math.floor(value)));\n}\n\nexport function setStyles(styleable: HTMLElement, styles: Record<string, string>): void {\n  for (const [key, value] of Object.entries(styles)) {\n    styleable.style.setProperty(kebab(key), value);\n  }\n}\n\nfunction kebab(key: string): string {\n  return key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { ConditionalFormat } from '../../spec/types';\nimport type { ResolvedSketch } from '../../spec/sketch';\nimport type { ThemeTokens } from '../../theme';\nimport type { FieldType, Rect } from '../../types';\nimport { formatValue } from '../../format';\nimport type { EvidenceLedger, DataRepresentation } from '../../render/evidence';\nimport type { LabelLedger } from '../../render/labelLedger';\nimport type { ColumnFormatter } from './conditional';\nimport type { TableDensity, TableGridlines } from './style';\n\n/** A wobbly, asymmetric border-radius that reads as a hand-drawn frame. */\nexport const SKETCH_BORDER_RADIUS = '14px 6px 16px 7px / 7px 15px 6px 14px';\n\n/** Line-chart, filled-area, or column sparkline drawn from a cell's numeric array. */\nexport interface ViewSparkline {\n  type: 'line' | 'area' | 'bar';\n  color?: string;\n  /** Shared column scale (comparable magnitudes) or per-row scale (shape only). */\n  domain: [number, number] | 'row';\n}\n\nexport interface ViewColumn {\n  /** Field key used to read values (not necessarily unique). */\n  key: string;\n  /** Unique column identity (sort state, DOM classes). Defaults to the key. */\n  id?: string;\n  title: string;\n  align: 'left' | 'center' | 'right';\n  format?: string;\n  type?: FieldType;\n  /** Fixed width in CSS px. */\n  width?: number;\n  conditionalFormat?: ConditionalFormat;\n  isMeasure?: boolean;\n  prefix?: string;\n  suffix?: string;\n  negativeStyle?: 'sign' | 'parens' | 'red' | 'parens-red';\n  sortable?: boolean;\n  wrap?: boolean;\n  group?: string;\n  /** Draw the cell's numeric array as a sparkline instead of text. */\n  sparkline?: ViewSparkline;\n  /** Stepped hierarchy column of a matrix (indent + expand/collapse). */\n  rowHeader?: boolean;\n  /** A grand-total / subtotal value column of a matrix. */\n  total?: boolean;\n  /** Draws a separator before this column (column-group boundary). */\n  groupStart?: boolean;\n}\n\nexport interface HeaderCell {\n  title: string;\n  colSpan?: number;\n  rowSpan?: number;\n  align?: 'left' | 'center' | 'right';\n  colIndex?: number;\n}\n\nexport interface ViewCell {\n  value: unknown;\n  raw: number | string | null;\n  /** Free text (labels) rather than a value to format. */\n  label?: boolean;\n}\n\nexport type RowKind = 'leaf' | 'group' | 'subtotal' | 'grandtotal';\n\nexport interface ViewRowInfo {\n  kind: RowKind;\n  /** Hierarchy level for stepped row headers. */\n  depth: number;\n  expandable?: boolean;\n  expanded?: boolean;\n  /** Accessible name of the row (row-header text). */\n  label?: string;\n}\n\nexport interface VisibleRange {\n  start: number;\n  end: number;\n  rowHeight: number;\n}\n\n/** What both the DOM and canvas table renderers consume. */\nexport interface TableViewInput {\n  tokens: ThemeTokens;\n  rect: Rect;\n  columns: ViewColumn[];\n  rowCount: number;\n  getCell(rowIndex: number, colIndex: number): ViewCell;\n  rowInfo?(rowIndex: number): ViewRowInfo;\n  /** Rows matching an active highlight are tinted. */\n  highlighted?(rowIndex: number): boolean;\n  /** Leading columns pinned while scrolling horizontally (the matrix row header). */\n  frozenColumns?: number;\n  striped?: boolean;\n  conditionalDomains?: Array<[number, number] | null>;\n  /** Precompiled per-column formatters; built from `conditionalDomains` when omitted. */\n  formatters?: Array<ColumnFormatter | null>;\n  /** Conditional formats apply to these row kinds only (default: leaf rows). */\n  formatKinds?: readonly RowKind[];\n  /** Per-row formatter override (a matrix scales each hierarchy level separately); null leaves the row plain. */\n  rowFormatters?(rowIndex: number): ReadonlyArray<ColumnFormatter | null> | null;\n  /** Known [min, max] numeric extremes per column for width measurement. */\n  extremes?: Array<[number, number] | null>;\n  headerRows?: HeaderCell[][];\n  footerRow?: { cells: ViewCell[]; kind?: 'total' | 'grandtotal' };\n  density?: TableDensity;\n  gridlines?: TableGridlines;\n  sortState?: { col: number; dir: 'asc' | 'desc' };\n  /** Hand-drawn chrome (wobbly frame, grid, and data bars) or null. */\n  sketch?: ResolvedSketch | null;\n  /** Column pixel widths, filled in by the renderer. */\n  widths?: number[];\n  evidence?: EvidenceLedger;\n  labels?: LabelLedger;\n  dataRepresentation?: DataRepresentation;\n  sourceRepresentedRows?: number;\n}\n\nexport function formatCellValue(value: unknown, column: Pick<ViewColumn, 'format'>): string {\n  return formatValue(value, column.format);\n}\n\nexport function formatDisplayValue(\n  value: unknown,\n  column: Pick<ViewColumn, 'format' | 'prefix' | 'suffix' | 'negativeStyle'>,\n): string {\n  if (value == null || value === '') return '';\n  const raw = typeof value === 'number' ? value : Number(value);\n  const parens = (column.negativeStyle === 'parens' || column.negativeStyle === 'parens-red') &&\n    Number.isFinite(raw) && raw < 0 && typeof value !== 'boolean';\n  const formatted = formatCellValue(parens ? Math.abs(raw) : value, column);\n  return `${column.prefix ?? ''}${parens ? `(${formatted})` : formatted}${column.suffix ?? ''}`;\n}\n\n/** Display text of a cell: labels verbatim, values through the column format. */\nexport function cellText(cell: ViewCell, column: ViewColumn): string {\n  if (cell.label) return cell.value == null ? '' : String(cell.value);\n  if (Array.isArray(cell.value) && column.sparkline) return '';\n  return formatDisplayValue(cell.value, column);\n}\n\nexport function defaultRowInfo(): ViewRowInfo {\n  return { kind: 'leaf', depth: 0 };\n}\n\nexport function normalizedHeaderRows(opts: Pick<TableViewInput, 'headerRows' | 'columns'>): HeaderCell[][] {\n  if (opts.headerRows) return opts.headerRows;\n  return [opts.columns.map((column, colIndex) => ({ title: column.title, align: column.align, colIndex }))];\n}\n\nexport function columnId(column: ViewColumn, index: number): string {\n  return column.id ?? `${column.key}#${index}`;\n}\n\nexport function clampInt(value: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, Math.floor(value)));\n}\n\nexport function sumWidths(widths: readonly number[], start = 0, end = widths.length): number {\n  let total = 0;\n  for (let i = start; i < end; i++) total += widths[i] ?? 0;\n  return total;\n}\n\nexport function setStyles(styleable: HTMLElement, styles: Record<string, string>): void {\n  for (const [key, value] of Object.entries(styles)) {\n    styleable.style.setProperty(key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`), value);\n  }\n}\n"],
+  "mappings": "AAIA,SAAS,mBAAmB;AAOrB,MAAM,uBAAuB;AA6G7B,SAAS,gBAAgB,OAAgB,QAA4C;AAC1F,SAAO,YAAY,OAAO,OAAO,MAAM;AACzC;AAEO,SAAS,mBACd,OACA,QACQ;AACR,MAAI,SAAS,QAAQ,UAAU,GAAI,QAAO;AAC1C,QAAM,MAAM,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK;AAC5D,QAAM,UAAU,OAAO,kBAAkB,YAAY,OAAO,kBAAkB,iBAC5E,OAAO,SAAS,GAAG,KAAK,MAAM,KAAK,OAAO,UAAU;AACtD,QAAM,YAAY,gBAAgB,SAAS,KAAK,IAAI,GAAG,IAAI,OAAO,MAAM;AACxE,SAAO,GAAG,OAAO,UAAU,EAAE,GAAG,SAAS,IAAI,SAAS,MAAM,SAAS,GAAG,OAAO,UAAU,EAAE;AAC7F;AAGO,SAAS,SAAS,MAAgB,QAA4B;AACnE,MAAI,KAAK,MAAO,QAAO,KAAK,SAAS,OAAO,KAAK,OAAO,KAAK,KAAK;AAClE,MAAI,MAAM,QAAQ,KAAK,KAAK,KAAK,OAAO,UAAW,QAAO;AAC1D,SAAO,mBAAmB,KAAK,OAAO,MAAM;AAC9C;AAEO,SAAS,iBAA8B;AAC5C,SAAO,EAAE,MAAM,QAAQ,OAAO,EAAE;AAClC;AAEO,SAAS,qBAAqB,MAAsE;AACzG,MAAI,KAAK,WAAY,QAAO,KAAK;AACjC,SAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,QAAQ,cAAc,EAAE,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,SAAS,EAAE,CAAC;AAC1G;AAEO,SAAS,SAAS,QAAoB,OAAuB;AAClE,SAAO,OAAO,MAAM,GAAG,OAAO,GAAG,IAAI,KAAK;AAC5C;AAEO,SAAS,SAAS,OAAe,KAAa,KAAqB;AACxE,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,KAAK,CAAC,CAAC;AACvD;AAEO,SAAS,UAAU,QAA2B,QAAQ,GAAG,MAAM,OAAO,QAAgB;AAC3F,MAAI,QAAQ;AACZ,WAAS,IAAI,OAAO,IAAI,KAAK,IAAK,UAAS,OAAO,CAAC,KAAK;AACxD,SAAO;AACT;AAEO,SAAS,UAAU,WAAwB,QAAsC;AACtF,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,cAAU,MAAM,YAAY,IAAI,QAAQ,UAAU,CAAC,MAAM,IAAI,EAAE,YAAY,CAAC,EAAE,GAAG,KAAK;AAAA,EACxF;AACF;",
   "names": []
 }

package/dist/charts/tableView.d.ts

@@ -1,7 +1,12 @@
-export { buildTable } from './tableView/dom.js';
+export { mountTable, RENDER_ALL_CELLS } from './tableView/dom.js';
+export type { DomTableOptions, DomTableView } from './tableView/dom.js';
 export { paintTableCanvas } from './tableView/canvas.js';
-export { createSketchGridCanvas, paintSketchGridOverlay } from './tableView/sketch.js';
-export { computeFittedWidths, densityMetrics, formatCellValue, formatDisplayValue, resolveConditionalDomain } from './tableView/types.js';
-export type { BuildTableOptions, CanvasTableOptions, HeaderCell, ViewColumn, VisibleRange } from './tableView/types.js';
-export type { SketchGridOverlay } from './tableView/sketch.js';
+export type { CanvasTableOptions } from './tableView/canvas.js';
+export { buildColumnFormatter, resolveConditionalDomain } from './tableView/conditional.js';
+export type { CellPaint, ColumnFormatter } from './tableView/conditional.js';
+export { cellText, formatCellValue, formatDisplayValue } from './tableView/types.js';
+export type { HeaderCell, RowKind, TableViewInput, ViewCell, ViewColumn, ViewRowInfo, ViewSparkline } from './tableView/types.js';
+export { densityMetrics, resolveTableStyle } from './tableView/style.js';
+export type { TableDensity, TableGridlines } from './tableView/style.js';
+export { sortRowIndices } from './tableView/sort.js';
 //# sourceMappingURL=tableView.d.ts.map

package/dist/charts/tableView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tableView.d.ts","sourceRoot":"","sources":["../../src/charts/tableView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACvI,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrH,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"tableView.d.ts","sourceRoot":"","sources":["../../src/charts/tableView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACzF,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/H,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/charts/tableView.js

@@ -1,16 +1,20 @@
-import { buildTable } from "./tableView/dom.js";
+import { mountTable, RENDER_ALL_CELLS } from "./tableView/dom.js";
 import { paintTableCanvas } from "./tableView/canvas.js";
-import { createSketchGridCanvas, paintSketchGridOverlay } from "./tableView/sketch.js";
-import { computeFittedWidths, densityMetrics, formatCellValue, formatDisplayValue, resolveConditionalDomain } from "./tableView/types.js";
+import { buildColumnFormatter, resolveConditionalDomain } from "./tableView/conditional.js";
+import { cellText, formatCellValue, formatDisplayValue } from "./tableView/types.js";
+import { densityMetrics, resolveTableStyle } from "./tableView/style.js";
+import { sortRowIndices } from "./tableView/sort.js";
 export {
-  buildTable,
-  computeFittedWidths,
-  createSketchGridCanvas,
+  RENDER_ALL_CELLS,
+  buildColumnFormatter,
+  cellText,
   densityMetrics,
   formatCellValue,
   formatDisplayValue,
-  paintSketchGridOverlay,
+  mountTable,
   paintTableCanvas,
-  resolveConditionalDomain
+  resolveConditionalDomain,
+  resolveTableStyle,
+  sortRowIndices
 };
 //# sourceMappingURL=tableView.js.map

package/dist/charts/tableView.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/charts/tableView.ts"],
-  "sourcesContent": ["export { buildTable } from './tableView/dom';\nexport { paintTableCanvas } from './tableView/canvas';\nexport { createSketchGridCanvas, paintSketchGridOverlay } from './tableView/sketch';\nexport { computeFittedWidths, densityMetrics, formatCellValue, formatDisplayValue, resolveConditionalDomain } from './tableView/types';\nexport type { BuildTableOptions, CanvasTableOptions, HeaderCell, ViewColumn, VisibleRange } from './tableView/types';\nexport type { SketchGridOverlay } from './tableView/sketch';\n"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AACjC,SAAS,wBAAwB,8BAA8B;AAC/D,SAAS,qBAAqB,gBAAgB,iBAAiB,oBAAoB,gCAAgC;",
+  "sourcesContent": ["export { mountTable, RENDER_ALL_CELLS } from './tableView/dom';\nexport type { DomTableOptions, DomTableView } from './tableView/dom';\nexport { paintTableCanvas } from './tableView/canvas';\nexport type { CanvasTableOptions } from './tableView/canvas';\nexport { buildColumnFormatter, resolveConditionalDomain } from './tableView/conditional';\nexport type { CellPaint, ColumnFormatter } from './tableView/conditional';\nexport { cellText, formatCellValue, formatDisplayValue } from './tableView/types';\nexport type { HeaderCell, RowKind, TableViewInput, ViewCell, ViewColumn, ViewRowInfo, ViewSparkline } from './tableView/types';\nexport { densityMetrics, resolveTableStyle } from './tableView/style';\nexport type { TableDensity, TableGridlines } from './tableView/style';\nexport { sortRowIndices } from './tableView/sort';\n"],
+  "mappings": "AAAA,SAAS,YAAY,wBAAwB;AAE7C,SAAS,wBAAwB;AAEjC,SAAS,sBAAsB,gCAAgC;AAE/D,SAAS,UAAU,iBAAiB,0BAA0B;AAE9D,SAAS,gBAAgB,yBAAyB;AAElD,SAAS,sBAAsB;",
   "names": []
 }

package/dist/charts/treemap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treemap.d.ts","sourceRoot":"","sources":["../../src/charts/treemap.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAS,IAAI,EAAQ,IAAI,EAAE,MAAM,UAAU,CAAC;AAGxD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB;IAClF,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,IAAI,CAAC;CACZ;AAqFD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAkCnH;AAqXD,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,aAAa,GACtB,gBAAgB,GAAG,IAAI,CA0BzB"}
+{"version":3,"file":"treemap.d.ts","sourceRoot":"","sources":["../../src/charts/treemap.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAS,IAAI,EAAQ,IAAI,EAAE,MAAM,UAAU,CAAC;AAIxD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB;IAClF,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,IAAI,CAAC;CACZ;AA8GD,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAkCnH;AA2fD,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,aAAa,GACtB,gBAAgB,GAAG,IAAI,CAoDzB"}