@flanksource/clicky-ui 0.3.36 → 0.3.37

package/dist/data/data-table-server-filters.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-server-filters.js","sources":["../../src/data/data-table-server-filters.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport type {\n  FilterBarFilter,\n  FilterBarNumberValue,\n  FilterBarRangePreset,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { FilterExtension } from \"../components/filter-bar-utils\";\nimport { applyFilterExtensions } from \"../components/filter-bar-utils\";\nimport type { MultiSelectOption } from \"../components/MultiSelect\";\nimport type { TriState } from \"../components/TriStateToggle\";\nimport { formatUnit } from \"../lib/format\";\nimport type { DataTableColumn, DataTableColumnKind } from \"./DataTable\";\nimport {\n  parseBoundsValue,\n  parseMultiFilterValue,\n  serializeBoundsValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\n  type FilterBoundsValue,\n} from \"./data-table-filter-values\";\nimport { prettifyKey } from \"./data-table-utils\";\n\n/**\n * Which control a filter renders as.\n *\n * Deliberately opaque: \"terms\" is not \"a SQL IN() or an OpenSearch terms\n * query\", it is \"a set of discrete values the user includes or excludes\". The\n * source compiles the selection; nothing about how it does so crosses into the\n * browser.\n */\nexport type DataTableFilterKind =\n  | \"terms\"\n  /** Whole values like \"terms\", but typed rather than picked — an identifier\n   *  has no list worth offering. */\n  | \"exact\"\n  | \"range\"\n  /** A range over elapsed time, labelled in the column's own `unit`. */\n  | \"duration\"\n  | \"time\"\n  /** A range over whole days: \"time\" with the clock taken off it. */\n  | \"date\"\n  | \"boolean\"\n  | \"text\";\n\nexport type DataTableFilterOption = {\n  /** Value written into the selection. */\n  value: string;\n  /** Display label. Falls back to `value`. */\n  label?: string;\n  /** How many rows carry this value, shown as a tooltip. */\n  count?: number;\n};\n\nexport type DataTableColumnFilter = {\n  kind: DataTableFilterKind;\n  /** Head of the option set for kind:\"terms\". Empty relies on `lookup`. */\n  options?: DataTableFilterOption[];\n  /** True when `options` is a capped head of a larger set. */\n  truncated?: boolean;\n  /** Distinct count behind a truncated head; drives the \"… and N more\" hint. */\n  total?: number;\n  /** The source can answer a type-ahead for this filter. */\n  lookup?: boolean;\n  /** Slider domain for kind:\"range\". */\n  min?: number;\n  max?: number;\n  step?: number;\n  /** The unit a kind:\"duration\" bound is written in (\"ms\" or \"s\"), so the\n   *  control labels itself in the numbers the column is stored in. Absent\n   *  means milliseconds. */\n  unit?: string;\n  /** Range presets for kind:\"time\". */\n  presets?: FilterBarRangePreset[];\n  /** Helper text shown in the filter popover. */\n  description?: string;\n  disabled?: boolean;\n};\n\n/**\n * A result column as the source describes it: how to render it, and — when the\n * source can narrow on it — which filter parameter it binds to and what control\n * that filter is.\n *\n * `filterKey` need not equal `name`: an analyzed text field filters through an\n * exact-value sibling, and a computed column filters by the alias it was given.\n */\nexport type DataTableServerColumn = {\n  /** Field name as the source knows it; also the literal row key. */\n  name: string;\n  /** Header label. Defaults to a prettified `name`. */\n  label?: string;\n  /** Backend type string, verbatim (e.g. \"TIMESTAMPTZ\", \"keyword\"). Display only. */\n  databaseType?: string;\n  /** Cell rendering kind. */\n  kind?: DataTableColumnKind;\n  /** Filter parameter this column narrows on. Absent means not filterable. */\n  filterKey?: string;\n  /** The control the filter renders as. Absent means not filterable. */\n  filter?: DataTableColumnFilter;\n};\n\n/** Head-set size for a filter value type-ahead. */\nexport const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;\n\nexport type DataTableFilterLookupRequest = {\n  /** Which filter is being searched — the column's `filterKey`. */\n  filterKey: string;\n  /** What the user typed. Empty asks for the head of the set. */\n  search: string;\n  /** How many options to return. */\n  limit: number;\n};\n\nexport type DataTableFilterLookupResult = {\n  options: DataTableFilterOption[];\n};\n\n/**\n * Answers a filter's value type-ahead. Sync or async — a static option source\n * returns an array, a server-backed one a promise.\n */\nexport type DataTableFilterLookup = (\n  request: DataTableFilterLookupRequest,\n) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;\n\nexport type ServerFilterBarOptions = {\n  /** Answers a terms type-ahead for filters whose `lookup` is set. */\n  lookupValues?: DataTableFilterLookup;\n  /** Decorators applied to each built filter (icons, relabelling). */\n  extensions?: FilterExtension[];\n};\n\nexport type ServerFilterConfig = {\n  filters: FilterBarFilter[];\n  /** Present when exactly one column declared kind:\"time\". */\n  timeRange?: FilterBarRangeProps;\n};\n\n/**\n * Turns the source's column description into DataTable columns.\n *\n * Every column gets a literal `accessor` — a raw result set has empty, dotted\n * and colliding names, none of which survive being read as a path — and\n * `filterable: false`, because a described result is filtered by the source and\n * never by cardinality guessed from one page.\n */\nexport function serverColumnsToDataTableColumns<T extends Record<string, unknown>>(\n  columns: DataTableServerColumn[],\n): DataTableColumn<T>[] {\n  return columns.map((column, index) => ({\n    key: column.name === \"\" ? `column-${index}` : column.name,\n    label: column.label ?? prettifyKey(column.name),\n    accessor: (row: T) => row[column.name],\n    sortable: true,\n    filterable: false,\n    ...(column.kind !== undefined ? { kind: column.kind } : {}),\n    ...(column.filterKey !== undefined ? { filterKey: column.filterKey } : {}),\n  }));\n}\n\n/**\n * Builds the FilterBar controls for a described result, already wired to\n * `values`/`setValues`.\n *\n * Pure — it holds no state and fetches nothing; a `lookup` filter closes over\n * the caller's loader. Pass the result as DataTable's `externalFilters`\n * together with `manualFilter`, since the source has already applied it.\n *\n * Throws when a column declares a filter it cannot address: no `filterKey`, a\n * `filterKey` another column already claimed, or a second time range. Each\n * would bind a control to a filter that means something else.\n */\nexport function serverFiltersToFilterBar(\n  columns: DataTableServerColumn[],\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n  options: ServerFilterBarOptions = {},\n): ServerFilterConfig {\n  const config: ServerFilterConfig = { filters: [] };\n  const claimed = new Map<string, string>();\n\n  for (const column of columns) {\n    const filter = column.filter;\n    if (!filter) continue;\n    const filterKey = column.filterKey;\n    if (!filterKey) {\n      throw new Error(`Column ${column.name} declares a filter but no filterKey to send it under`);\n    }\n    const owner = claimed.get(filterKey);\n    if (owner !== undefined) {\n      throw new Error(\n        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`,\n      );\n    }\n    claimed.set(filterKey, column.name);\n\n    const label = column.label ?? prettifyKey(column.name);\n    // The bar's own range control is the primary way through a result, and a\n    // result has one of those — so the first time column takes it and any\n    // others are ranges among the filters. A raw SELECT commonly returns\n    // created_at beside updated_at, and refusing the second one cost the whole\n    // bar rather than just that column's control.\n    if (filter.kind === \"time\" && !config.timeRange) {\n      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);\n      continue;\n    }\n    config.filters.push(\n      applyFilterExtensions(\n        buildFilter({ column, filterKey, label, filter, values, setValues, options }),\n        options.extensions,\n      ),\n    );\n  }\n  return config;\n}\n\ntype BuildArgs = {\n  column: DataTableServerColumn;\n  filterKey: string;\n  label: string;\n  filter: DataTableColumnFilter;\n  values: DataTableFilterSelection;\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>;\n  options: ServerFilterBarOptions;\n};\n\nfunction buildFilter(args: BuildArgs): FilterBarFilter {\n  const { filterKey, label, filter, values, setValues } = args;\n  const raw = values[filterKey] ?? \"\";\n  const write = (serialized: string) =>\n    setValues((current) => updateFilterSelection(current, filterKey, serialized));\n  const shared = {\n    key: filterKey,\n    label,\n    ...(filter.description !== undefined ? { description: filter.description } : {}),\n    ...(filter.disabled !== undefined ? { disabled: filter.disabled } : {}),\n  };\n\n  switch (filter.kind) {\n    case \"time\":\n    // A date range is the same two-edged control with the clock taken off it,\n    // so it shares every line below except timeEnabled.\n    case \"date\":\n      return {\n        ...shared,\n        kind: \"date-range\",\n        ...boundsToRange(parseBoundsValue(raw)),\n        onApply: (from: string, to: string) =>\n          write(serializeBoundsValue({ min: from, max: to })),\n        ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n        timeEnabled: filter.kind === \"time\",\n      };\n    case \"range\":\n    // A duration is a range that knows what its numbers mean, so it differs\n    // only in how the slider labels them.\n    case \"duration\":\n      return {\n        ...shared,\n        kind: \"number\",\n        value: parseBoundsValue(raw),\n        onChange: (next: FilterBarNumberValue) => write(serializeBoundsValue(next)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n        ...(filter.kind === \"duration\"\n          ? { formatValue: (value: number) => formatUnit(value, filter.unit || \"ms\") }\n          : {}),\n      };\n    // An exact match has nothing to enumerate, which is what buildTermsFilter\n    // already falls back to for a selection that turned out to have no values.\n    // Declaring it says so up front rather than arriving there by exhaustion.\n    case \"exact\":\n      return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n    case \"boolean\":\n      return {\n        ...shared,\n        kind: \"tristate\",\n        value: raw === \"\" ? undefined : raw === \"true\",\n        onChange: (next: TriState) => write(next === undefined ? \"\" : String(next)),\n      };\n    case \"text\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    default:\n      return buildTermsFilter(args, shared, raw, write);\n  }\n}\n\nfunction buildTermsFilter(\n  { filter, options }: BuildArgs,\n  shared: { key: string; label: string; description?: string; disabled?: boolean },\n  raw: string,\n  write: (serialized: string) => void,\n): FilterBarFilter {\n  const lookupValues = options.lookupValues;\n  // A selection with no options and no type-ahead has nothing to select from,\n  // and a dropdown that opens empty is a control the user cannot use. The\n  // grammar is the wire format either way, so typing \"a,b\" or \"!a\" into the\n  // input still means what selecting them would have.\n  if (!filter.lookup && (filter.options?.length ?? 0) === 0) {\n    return { ...shared, kind: \"text\", value: raw, onChange: (next: string) => write(next) };\n  }\n  return {\n    ...shared,\n    kind: \"multi\",\n    value: parseMultiFilterValue(raw),\n    onChange: (next) => write(serializeMultiFilterValue(next)),\n    options: (filter.options ?? []).map(toMultiSelectOption),\n    ...(filter.truncated !== undefined ? { truncated: filter.truncated } : {}),\n    ...(filter.total !== undefined ? { total: filter.total } : {}),\n    // The field owns the in-flight flag from the promise this returns, so no\n    // `loading` is passed: a second source of truth for it could disagree.\n    ...(lookupValues && filter.lookup\n      ? {\n          onSearch: async (search: string) => {\n            const result = await lookupValues({\n              filterKey: shared.key,\n              search,\n              limit: DATA_TABLE_FILTER_LOOKUP_LIMIT,\n            });\n            return result.options.map(toMultiSelectOption);\n          },\n        }\n      : {}),\n  };\n}\n\nfunction buildTimeRange(\n  filterKey: string,\n  filter: DataTableColumnFilter,\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n): FilterBarRangeProps {\n  return {\n    ...boundsToRange(parseBoundsValue(values[filterKey] ?? \"\")),\n    onApply: (from, to) =>\n      setValues((current) =>\n        updateFilterSelection(current, filterKey, serializeBoundsValue({ min: from, max: to })),\n      ),\n    ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n    timeEnabled: true,\n  };\n}\n\n/** Names a bounded selection's edges the way a range control reads them. */\nfunction boundsToRange(bounds: FilterBoundsValue): { from?: string; to?: string } {\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\n  };\n}\n\nfunction toMultiSelectOption(option: DataTableFilterOption): MultiSelectOption {\n  const label = option.label ?? option.value;\n  return {\n    value: option.value,\n    label,\n    ...(option.count !== undefined ? { title: `${label} · ${option.count.toLocaleString()}` } : {}),\n  };\n}\n\n/**\n * Refuses a DataTable that would filter twice or offer a control wired to\n * nothing. Both are silent in a running table — rows narrow more than the user\n * asked, or a box swallows what they type — so they are refused at the seam.\n */\nexport function assertDataTableFilterProps(props: {\n  autoFilter: boolean;\n  manualFilter: boolean;\n  showGlobalFilter: boolean;\n  globalFilterControlled: boolean;\n  hasExternalSearch: boolean;\n}): void {\n  if (props.autoFilter && props.manualFilter) {\n    throw new Error(\n      \"DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead.\",\n    );\n  }\n  if (\n    props.manualFilter &&\n    props.showGlobalFilter &&\n    !props.globalFilterControlled &&\n    !props.hasExternalSearch\n  ) {\n    throw new Error(\n      \"DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source.\",\n    );\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-table-server-filters.js","sources":["../../src/data/data-table-server-filters.ts"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport type {\n  FilterBarDurationUnit,\n  FilterBarDurationValue,\n  FilterBarFilter,\n  FilterBarNumberValue,\n  FilterBarRangePreset,\n  FilterBarRangeProps,\n} from \"../components/FilterBar\";\nimport type { FilterExtension } from \"../components/filter-bar-utils\";\nimport { applyFilterExtensions } from \"../components/filter-bar-utils\";\nimport type { MultiSelectOption } from \"../components/MultiSelect\";\nimport type { TriState } from \"../components/TriStateToggle\";\nimport type { DataTableColumn, DataTableColumnKind } from \"./DataTable\";\nimport {\n  parseBoundsValue,\n  parseDurationBoundsValue,\n  parseMultiFilterValue,\n  serializeBoundsValue,\n  serializeDurationBoundsValue,\n  serializeMultiFilterValue,\n  updateFilterSelection,\n  type DataTableFilterSelection,\n  type FilterBoundsValue,\n} from \"./data-table-filter-values\";\nimport { prettifyKey } from \"./data-table-utils\";\n\n/**\n * Which control a filter renders as.\n *\n * Deliberately opaque: \"terms\" is not \"a SQL IN() or an OpenSearch terms\n * query\", it is \"a set of discrete values the user includes or excludes\". The\n * source compiles the selection; nothing about how it does so crosses into the\n * browser.\n */\nexport type DataTableFilterKind =\n  | \"terms\"\n  /** Whole values like \"terms\", but typed rather than picked — an identifier\n   *  has no list worth offering. */\n  | \"exact\"\n  | \"range\"\n  /** A range over elapsed time, labelled in the column's own `unit`. */\n  | \"duration\"\n  | \"time\"\n  /** A range over whole days: \"time\" with the clock taken off it. */\n  | \"date\"\n  | \"boolean\"\n  | \"text\";\n\nexport type DataTableFilterOption = {\n  /** Value written into the selection. */\n  value: string;\n  /** Display label. Falls back to `value`. */\n  label?: string;\n  /** How many rows carry this value, shown as a tooltip. */\n  count?: number;\n};\n\nexport type DataTableColumnFilter = {\n  kind: DataTableFilterKind;\n  /** Head of the option set for kind:\"terms\". Empty relies on `lookup`. */\n  options?: DataTableFilterOption[];\n  /** True when `options` is a capped head of a larger set. */\n  truncated?: boolean;\n  /** Distinct count behind a truncated head; drives the \"… and N more\" hint. */\n  total?: number;\n  /** The source can answer a type-ahead for this filter. */\n  lookup?: boolean;\n  /** Slider domain for kind:\"range\". */\n  min?: number;\n  max?: number;\n  step?: number;\n  /** The unit a kind:\"duration\" bound is written in (\"ms\" or \"s\"), so the\n   *  control labels itself in the numbers the column is stored in. Absent\n   *  means milliseconds. */\n  unit?: string;\n  /** Range presets for kind:\"time\". */\n  presets?: FilterBarRangePreset[];\n  /** Helper text shown in the filter popover. */\n  description?: string;\n  disabled?: boolean;\n};\n\n/**\n * A result column as the source describes it: how to render it, and — when the\n * source can narrow on it — which filter parameter it binds to and what control\n * that filter is.\n *\n * `filterKey` need not equal `name`: an analyzed text field filters through an\n * exact-value sibling, and a computed column filters by the alias it was given.\n */\nexport type DataTableServerColumn = {\n  /** Field name as the source knows it; also the literal row key. */\n  name: string;\n  /** Header label. Defaults to a prettified `name`. */\n  label?: string;\n  /** Backend type string, verbatim (e.g. \"TIMESTAMPTZ\", \"keyword\"). Display only. */\n  databaseType?: string;\n  /** Cell rendering kind. */\n  kind?: DataTableColumnKind;\n  /** Filter parameter this column narrows on. Absent means not filterable. */\n  filterKey?: string;\n  /** The control the filter renders as. Absent means not filterable. */\n  filter?: DataTableColumnFilter;\n};\n\n/** Head-set size for a filter value type-ahead. */\nexport const DATA_TABLE_FILTER_LOOKUP_LIMIT = 20;\n\nexport type DataTableFilterLookupRequest = {\n  /** Which filter is being searched — the column's `filterKey`. */\n  filterKey: string;\n  /** What the user typed. Empty asks for the head of the set. */\n  search: string;\n  /** How many options to return. */\n  limit: number;\n};\n\nexport type DataTableFilterLookupResult = {\n  options: DataTableFilterOption[];\n};\n\n/**\n * Answers a filter's value type-ahead. Sync or async — a static option source\n * returns an array, a server-backed one a promise.\n */\nexport type DataTableFilterLookup = (\n  request: DataTableFilterLookupRequest,\n) => Promise<DataTableFilterLookupResult> | DataTableFilterLookupResult;\n\nexport type ServerFilterBarOptions = {\n  /** Answers a terms type-ahead for filters whose `lookup` is set. */\n  lookupValues?: DataTableFilterLookup;\n  /** Decorators applied to each built filter (icons, relabelling). */\n  extensions?: FilterExtension[];\n};\n\nexport type ServerFilterConfig = {\n  filters: FilterBarFilter[];\n  /** Present when exactly one column declared kind:\"time\". */\n  timeRange?: FilterBarRangeProps;\n};\n\n/**\n * Turns the source's column description into DataTable columns.\n *\n * Every column gets a literal `accessor` — a raw result set has empty, dotted\n * and colliding names, none of which survive being read as a path — and\n * `filterable: false`, because a described result is filtered by the source and\n * never by cardinality guessed from one page.\n */\nexport function serverColumnsToDataTableColumns<\n  T extends Record<string, unknown>,\n>(columns: DataTableServerColumn[]): DataTableColumn<T>[] {\n  return columns.map((column, index) => ({\n    key: column.name === \"\" ? `column-${index}` : column.name,\n    label: column.label ?? prettifyKey(column.name),\n    accessor: (row: T) => row[column.name],\n    sortable: true,\n    filterable: false,\n    ...(column.kind !== undefined ? { kind: column.kind } : {}),\n    ...(column.filterKey !== undefined ? { filterKey: column.filterKey } : {}),\n  }));\n}\n\n/**\n * Builds the FilterBar controls for a described result, already wired to\n * `values`/`setValues`.\n *\n * Pure — it holds no state and fetches nothing; a `lookup` filter closes over\n * the caller's loader. Pass the result as DataTable's `externalFilters`\n * together with `manualFilter`, since the source has already applied it.\n *\n * Throws when a column declares a filter it cannot address: no `filterKey`, a\n * `filterKey` another column already claimed, or a second time range. Each\n * would bind a control to a filter that means something else.\n */\nexport function serverFiltersToFilterBar(\n  columns: DataTableServerColumn[],\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n  options: ServerFilterBarOptions = {},\n): ServerFilterConfig {\n  const config: ServerFilterConfig = { filters: [] };\n  const claimed = new Map<string, string>();\n\n  for (const column of columns) {\n    const filter = column.filter;\n    if (!filter) continue;\n    const filterKey = column.filterKey;\n    if (!filterKey) {\n      throw new Error(\n        `Column ${column.name} declares a filter but no filterKey to send it under`,\n      );\n    }\n    const owner = claimed.get(filterKey);\n    if (owner !== undefined) {\n      throw new Error(\n        `Columns ${owner} and ${column.name} both filter through ${filterKey}; a filter key addresses one column`,\n      );\n    }\n    claimed.set(filterKey, column.name);\n\n    const label = column.label ?? prettifyKey(column.name);\n    // The bar's own range control is the primary way through a result, and a\n    // result has one of those — so the first time column takes it and any\n    // others are ranges among the filters. A raw SELECT commonly returns\n    // created_at beside updated_at, and refusing the second one cost the whole\n    // bar rather than just that column's control.\n    if (filter.kind === \"time\" && !config.timeRange) {\n      config.timeRange = buildTimeRange(filterKey, filter, values, setValues);\n      continue;\n    }\n    config.filters.push(\n      applyFilterExtensions(\n        buildFilter({\n          column,\n          filterKey,\n          label,\n          filter,\n          values,\n          setValues,\n          options,\n        }),\n        options.extensions,\n      ),\n    );\n  }\n  return config;\n}\n\ntype BuildArgs = {\n  column: DataTableServerColumn;\n  filterKey: string;\n  label: string;\n  filter: DataTableColumnFilter;\n  values: DataTableFilterSelection;\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>;\n  options: ServerFilterBarOptions;\n};\n\nfunction buildFilter(args: BuildArgs): FilterBarFilter {\n  const { filterKey, label, filter, values, setValues } = args;\n  const raw = values[filterKey] ?? \"\";\n  const write = (serialized: string) =>\n    setValues((current) =>\n      updateFilterSelection(current, filterKey, serialized),\n    );\n  const shared = {\n    key: filterKey,\n    label,\n    ...(filter.description !== undefined\n      ? { description: filter.description }\n      : {}),\n    ...(filter.disabled !== undefined ? { disabled: filter.disabled } : {}),\n  };\n\n  switch (filter.kind) {\n    case \"time\":\n    // A date range is the same two-edged control with the clock taken off it,\n    // so it shares every line below except timeEnabled.\n    case \"date\":\n      return {\n        ...shared,\n        kind: \"date-range\",\n        ...boundsToRange(parseBoundsValue(raw)),\n        onApply: (from: string, to: string) =>\n          write(serializeBoundsValue({ min: from, max: to })),\n        ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n        timeEnabled: filter.kind === \"time\",\n      };\n    case \"range\":\n      return {\n        ...shared,\n        kind: \"number\",\n        value: parseBoundsValue(raw),\n        onChange: (next: FilterBarNumberValue) =>\n          write(serializeBoundsValue(next)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n        ...(filter.unit ? { unit: filter.unit } : {}),\n      };\n    case \"duration\": {\n      const unit = durationStorageUnit(filter.unit);\n      return {\n        ...shared,\n        kind: \"duration\",\n        unit,\n        value: parseDurationBoundsValue(raw, unit),\n        onChange: (next: FilterBarDurationValue) =>\n          write(serializeDurationBoundsValue(next, unit)),\n        ...(filter.min !== undefined ? { domainMin: filter.min } : {}),\n        ...(filter.max !== undefined ? { domainMax: filter.max } : {}),\n        ...(filter.step !== undefined ? { step: filter.step } : {}),\n      };\n    }\n    // An exact match has nothing to enumerate, which is what buildTermsFilter\n    // already falls back to for a selection that turned out to have no values.\n    // Declaring it says so up front rather than arriving there by exhaustion.\n    case \"exact\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    case \"boolean\":\n      return {\n        ...shared,\n        kind: \"tristate\",\n        value: raw === \"\" ? undefined : raw === \"true\",\n        onChange: (next: TriState) =>\n          write(next === undefined ? \"\" : String(next)),\n      };\n    case \"text\":\n      return {\n        ...shared,\n        kind: \"text\",\n        value: raw,\n        onChange: (next: string) => write(next),\n      };\n    default:\n      return buildTermsFilter(args, shared, raw, write);\n  }\n}\n\nfunction durationStorageUnit(unit: string | undefined): FilterBarDurationUnit {\n  const resolved = unit || \"ms\";\n  if (resolved !== \"ms\" && resolved !== \"s\") {\n    throw new Error(`Unsupported duration storage unit ${resolved}`);\n  }\n  return resolved;\n}\n\nfunction buildTermsFilter(\n  { filter, options }: BuildArgs,\n  shared: {\n    key: string;\n    label: string;\n    description?: string;\n    disabled?: boolean;\n  },\n  raw: string,\n  write: (serialized: string) => void,\n): FilterBarFilter {\n  const lookupValues = options.lookupValues;\n  // A selection with no options and no type-ahead has nothing to select from,\n  // and a dropdown that opens empty is a control the user cannot use. The\n  // grammar is the wire format either way, so typing \"a,b\" or \"!a\" into the\n  // input still means what selecting them would have.\n  if (!filter.lookup && (filter.options?.length ?? 0) === 0) {\n    return {\n      ...shared,\n      kind: \"text\",\n      value: raw,\n      onChange: (next: string) => write(next),\n    };\n  }\n  return {\n    ...shared,\n    kind: \"multi\",\n    value: parseMultiFilterValue(raw),\n    onChange: (next) => write(serializeMultiFilterValue(next)),\n    options: (filter.options ?? []).map(toMultiSelectOption),\n    ...(filter.truncated !== undefined ? { truncated: filter.truncated } : {}),\n    ...(filter.total !== undefined ? { total: filter.total } : {}),\n    // The field owns the in-flight flag from the promise this returns, so no\n    // `loading` is passed: a second source of truth for it could disagree.\n    ...(lookupValues && filter.lookup\n      ? {\n          onSearch: async (search: string) => {\n            const result = await lookupValues({\n              filterKey: shared.key,\n              search,\n              limit: DATA_TABLE_FILTER_LOOKUP_LIMIT,\n            });\n            return result.options.map(toMultiSelectOption);\n          },\n        }\n      : {}),\n  };\n}\n\nfunction buildTimeRange(\n  filterKey: string,\n  filter: DataTableColumnFilter,\n  values: DataTableFilterSelection,\n  setValues: Dispatch<SetStateAction<DataTableFilterSelection>>,\n): FilterBarRangeProps {\n  return {\n    ...boundsToRange(parseBoundsValue(values[filterKey] ?? \"\")),\n    onApply: (from, to) =>\n      setValues((current) =>\n        updateFilterSelection(\n          current,\n          filterKey,\n          serializeBoundsValue({ min: from, max: to }),\n        ),\n      ),\n    ...(filter.presets !== undefined ? { presets: filter.presets } : {}),\n    timeEnabled: true,\n  };\n}\n\n/** Names a bounded selection's edges the way a range control reads them. */\nfunction boundsToRange(bounds: FilterBoundsValue): {\n  from?: string;\n  to?: string;\n} {\n  return {\n    ...(bounds.min !== undefined ? { from: bounds.min } : {}),\n    ...(bounds.max !== undefined ? { to: bounds.max } : {}),\n  };\n}\n\nfunction toMultiSelectOption(option: DataTableFilterOption): MultiSelectOption {\n  const label = option.label ?? option.value;\n  return {\n    value: option.value,\n    label,\n    ...(option.count !== undefined\n      ? { title: `${label} · ${option.count.toLocaleString()}` }\n      : {}),\n  };\n}\n\n/**\n * Refuses a DataTable that would filter twice or offer a control wired to\n * nothing. Both are silent in a running table — rows narrow more than the user\n * asked, or a box swallows what they type — so they are refused at the seam.\n */\nexport function assertDataTableFilterProps(props: {\n  autoFilter: boolean;\n  manualFilter: boolean;\n  showGlobalFilter: boolean;\n  globalFilterControlled: boolean;\n  hasExternalSearch: boolean;\n}): void {\n  if (props.autoFilter && props.manualFilter) {\n    throw new Error(\n      \"DataTable: autoFilter generates filters that narrow rows locally, which manualFilter then suppresses — the controls would render and do nothing. Pass externalFilters instead.\",\n    );\n  }\n  if (\n    props.manualFilter &&\n    props.showGlobalFilter &&\n    !props.globalFilterControlled &&\n    !props.hasExternalSearch\n  ) {\n    throw new Error(\n      \"DataTable: manualFilter suppresses the built-in search's row narrowing, so showGlobalFilter needs globalFilter/onGlobalFilterChange or externalSearch to reach the source.\",\n    );\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/data/data-table-utils.cjs

@@ -30,6 +30,13 @@ function getFilterTokens(row, column) {
 function prettifyKey(key) {
   return key.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/\b\w/g, (value) => value.toUpperCase()).trim();
 }
+function labelText(column) {
+  if (typeof column.label === "string") return column.label;
+  return prettifyKey(column.key.split(".").at(-1) ?? column.key);
+}
+function isColumnHideable(column) {
+  return column.hideable !== false;
+}
 function inferColumns(data, opts) {
   if (data.length === 0) return [];
   const literalKeys = (opts == null ? void 0 : opts.literalKeys) ?? false;
@@ -48,6 +55,8 @@ function inferColumns(data, opts) {
 exports.getFilterCandidate = getFilterCandidate;
 exports.getFilterTokens = getFilterTokens;
 exports.inferColumns = inferColumns;
+exports.isColumnHideable = isColumnHideable;
+exports.labelText = labelText;
 exports.normalizeTokens = normalizeTokens;
 exports.prettifyKey = prettifyKey;
 exports.resolveColumnValue = resolveColumnValue;

package/dist/data/data-table-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-utils.cjs","sources":["../../src/data/data-table-utils.ts"],"sourcesContent":["import type { DataTableColumn } from \"./DataTable\";\n\nexport function resolvePath(obj: unknown, path: string): unknown {\n  return path.split(\".\").reduce<unknown>((current, key) => {\n    if (current && typeof current === \"object\") {\n      return (current as Record<string, unknown>)[key];\n    }\n    return undefined;\n  }, obj);\n}\n\nexport function normalizeTokens(value: unknown): string[] {\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => normalizeTokens(item)).filter(Boolean);\n  }\n\n  if (value == null) return [];\n  if (typeof value === \"object\") return [JSON.stringify(value)];\n\n  const token = String(value).trim();\n  return token ? [token] : [];\n}\n\n/**\n * Reads a column's raw value from a row, honoring a column `accessor` when\n * present (for literal/empty/dotted SQL keys) and otherwise resolving `key` as\n * a dotted path. This is the single value-access seam for rendering, sorting,\n * and filtering.\n */\nexport function resolveColumnValue<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n): unknown {\n  return column.accessor ? column.accessor(row) : resolvePath(row, column.key);\n}\n\nexport function getFilterCandidate<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  const rawValue = resolveColumnValue(row, column);\n  return column.filterValue ? column.filterValue(rawValue, row) : rawValue;\n}\n\nexport function getFilterTokens<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  return normalizeTokens(getFilterCandidate(row, column));\n}\n\nexport function prettifyKey(key: string) {\n  return key\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/[_-]/g, \" \")\n    .replace(/\\b\\w/g, (value) => value.toUpperCase())\n    .trim();\n}\n\nexport function inferColumns<T extends Record<string, unknown>>(\n  data: T[],\n  opts?: {\n    /**\n     * Treat every key as a literal property name rather than a dotted path,\n     * and tolerate empty/dotted column names (e.g. raw SQL result sets). Each\n     * column carries an `accessor` reading `row[key]` directly, and blank keys\n     * get a stable placeholder id + label so the table renders instead of\n     * crashing on an id-less column.\n     */\n    literalKeys?: boolean;\n  },\n): DataTableColumn<T>[] {\n  if (data.length === 0) return [];\n  const literalKeys = opts?.literalKeys ?? false;\n\n  const keys = new Set<string>();\n  for (const row of data.slice(0, 20)) {\n    Object.keys(row)\n      .filter((key) => !key.startsWith(\"_\"))\n      .forEach((key) => keys.add(key));\n  }\n\n  return Array.from(keys).map((key, index) => ({\n    key: key || `__col_${index}`,\n    label: key ? prettifyKey(key) : \"(no column name)\",\n    sortable: true,\n    filterable: true,\n    ...(literalKeys\n      ? { accessor: (row: T) => (row as Record<string, unknown>)[key] }\n      : {}),\n  }));\n}\n"],"names":[],"mappings":";;AAEO,SAAS,YAAY,KAAc,MAAuB;AAC/D,SAAO,KAAK,MAAM,GAAG,EAAE,OAAgB,CAAC,SAAS,QAAQ;AACvD,QAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,aAAQ,QAAoC,GAAG;AAAA,IACjD;AACA,WAAO;AAAA,EACT,GAAG,GAAG;AACR;AAEO,SAAS,gBAAgB,OAA0B;AACxD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,QAAQ,CAAC,SAAS,gBAAgB,IAAI,CAAC,EAAE,OAAO,OAAO;AAAA,EACtE;AAEA,MAAI,SAAS,KAAM,QAAO,CAAA;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC,KAAK,UAAU,KAAK,CAAC;AAE5D,QAAM,QAAQ,OAAO,KAAK,EAAE,KAAA;AAC5B,SAAO,QAAQ,CAAC,KAAK,IAAI,CAAA;AAC3B;AAQO,SAAS,mBACd,KACA,QACS;AACT,SAAO,OAAO,WAAW,OAAO,SAAS,GAAG,IAAI,YAAY,KAAK,OAAO,GAAG;AAC7E;AAEO,SAAS,mBACd,KACA,QACA;AACA,QAAM,WAAW,mBAAmB,KAAK,MAAM;AAC/C,SAAO,OAAO,cAAc,OAAO,YAAY,UAAU,GAAG,IAAI;AAClE;AAEO,SAAS,gBACd,KACA,QACA;AACA,SAAO,gBAAgB,mBAAmB,KAAK,MAAM,CAAC;AACxD;AAEO,SAAS,YAAY,KAAa;AACvC,SAAO,IACJ,QAAQ,mBAAmB,OAAO,EAClC,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,CAAC,UAAU,MAAM,YAAA,CAAa,EAC/C,KAAA;AACL;AAEO,SAAS,aACd,MACA,MAUsB;AACtB,MAAI,KAAK,WAAW,EAAG,QAAO,CAAA;AAC9B,QAAM,eAAc,6BAAM,gBAAe;AAEzC,QAAM,2BAAW,IAAA;AACjB,aAAW,OAAO,KAAK,MAAM,GAAG,EAAE,GAAG;AACnC,WAAO,KAAK,GAAG,EACZ,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,EACpC,QAAQ,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC;AAAA,EACnC;AAEA,SAAO,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,KAAK,WAAW;AAAA,IAC3C,KAAK,OAAO,SAAS,KAAK;AAAA,IAC1B,OAAO,MAAM,YAAY,GAAG,IAAI;AAAA,IAChC,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAI,cACA,EAAE,UAAU,CAAC,QAAY,IAAgC,GAAG,MAC5D,CAAA;AAAA,EAAC,EACL;AACJ;;;;;;;;"}
+{"version":3,"file":"data-table-utils.cjs","sources":["../../src/data/data-table-utils.ts"],"sourcesContent":["import type { DataTableColumn } from \"./DataTable\";\n\nexport function resolvePath(obj: unknown, path: string): unknown {\n  return path.split(\".\").reduce<unknown>((current, key) => {\n    if (current && typeof current === \"object\") {\n      return (current as Record<string, unknown>)[key];\n    }\n    return undefined;\n  }, obj);\n}\n\nexport function normalizeTokens(value: unknown): string[] {\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => normalizeTokens(item)).filter(Boolean);\n  }\n\n  if (value == null) return [];\n  if (typeof value === \"object\") return [JSON.stringify(value)];\n\n  const token = String(value).trim();\n  return token ? [token] : [];\n}\n\n/**\n * Reads a column's raw value from a row, honoring a column `accessor` when\n * present (for literal/empty/dotted SQL keys) and otherwise resolving `key` as\n * a dotted path. This is the single value-access seam for rendering, sorting,\n * and filtering.\n */\nexport function resolveColumnValue<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n): unknown {\n  return column.accessor ? column.accessor(row) : resolvePath(row, column.key);\n}\n\nexport function getFilterCandidate<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  const rawValue = resolveColumnValue(row, column);\n  return column.filterValue ? column.filterValue(rawValue, row) : rawValue;\n}\n\nexport function getFilterTokens<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  return normalizeTokens(getFilterCandidate(row, column));\n}\n\nexport function prettifyKey(key: string) {\n  return key\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/[_-]/g, \" \")\n    .replace(/\\b\\w/g, (value) => value.toUpperCase())\n    .trim();\n}\n\nexport function labelText<T extends Record<string, unknown>>(\n  column: DataTableColumn<T>,\n) {\n  if (typeof column.label === \"string\") return column.label;\n  return prettifyKey(column.key.split(\".\").at(-1) ?? column.key);\n}\n\nexport function isColumnHideable<T extends Record<string, unknown>>(\n  column: DataTableColumn<T>,\n) {\n  return column.hideable !== false;\n}\n\nexport function inferColumns<T extends Record<string, unknown>>(\n  data: T[],\n  opts?: {\n    /**\n     * Treat every key as a literal property name rather than a dotted path,\n     * and tolerate empty/dotted column names (e.g. raw SQL result sets). Each\n     * column carries an `accessor` reading `row[key]` directly, and blank keys\n     * get a stable placeholder id + label so the table renders instead of\n     * crashing on an id-less column.\n     */\n    literalKeys?: boolean;\n  },\n): DataTableColumn<T>[] {\n  if (data.length === 0) return [];\n  const literalKeys = opts?.literalKeys ?? false;\n\n  const keys = new Set<string>();\n  for (const row of data.slice(0, 20)) {\n    Object.keys(row)\n      .filter((key) => !key.startsWith(\"_\"))\n      .forEach((key) => keys.add(key));\n  }\n\n  return Array.from(keys).map((key, index) => ({\n    key: key || `__col_${index}`,\n    label: key ? prettifyKey(key) : \"(no column name)\",\n    sortable: true,\n    filterable: true,\n    ...(literalKeys\n      ? { accessor: (row: T) => (row as Record<string, unknown>)[key] }\n      : {}),\n  }));\n}\n"],"names":[],"mappings":";;AAEO,SAAS,YAAY,KAAc,MAAuB;AAC/D,SAAO,KAAK,MAAM,GAAG,EAAE,OAAgB,CAAC,SAAS,QAAQ;AACvD,QAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,aAAQ,QAAoC,GAAG;AAAA,IACjD;AACA,WAAO;AAAA,EACT,GAAG,GAAG;AACR;AAEO,SAAS,gBAAgB,OAA0B;AACxD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,QAAQ,CAAC,SAAS,gBAAgB,IAAI,CAAC,EAAE,OAAO,OAAO;AAAA,EACtE;AAEA,MAAI,SAAS,KAAM,QAAO,CAAA;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC,KAAK,UAAU,KAAK,CAAC;AAE5D,QAAM,QAAQ,OAAO,KAAK,EAAE,KAAA;AAC5B,SAAO,QAAQ,CAAC,KAAK,IAAI,CAAA;AAC3B;AAQO,SAAS,mBACd,KACA,QACS;AACT,SAAO,OAAO,WAAW,OAAO,SAAS,GAAG,IAAI,YAAY,KAAK,OAAO,GAAG;AAC7E;AAEO,SAAS,mBACd,KACA,QACA;AACA,QAAM,WAAW,mBAAmB,KAAK,MAAM;AAC/C,SAAO,OAAO,cAAc,OAAO,YAAY,UAAU,GAAG,IAAI;AAClE;AAEO,SAAS,gBACd,KACA,QACA;AACA,SAAO,gBAAgB,mBAAmB,KAAK,MAAM,CAAC;AACxD;AAEO,SAAS,YAAY,KAAa;AACvC,SAAO,IACJ,QAAQ,mBAAmB,OAAO,EAClC,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,CAAC,UAAU,MAAM,YAAA,CAAa,EAC/C,KAAA;AACL;AAEO,SAAS,UACd,QACA;AACA,MAAI,OAAO,OAAO,UAAU,iBAAiB,OAAO;AACpD,SAAO,YAAY,OAAO,IAAI,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG;AAC/D;AAEO,SAAS,iBACd,QACA;AACA,SAAO,OAAO,aAAa;AAC7B;AAEO,SAAS,aACd,MACA,MAUsB;AACtB,MAAI,KAAK,WAAW,EAAG,QAAO,CAAA;AAC9B,QAAM,eAAc,6BAAM,gBAAe;AAEzC,QAAM,2BAAW,IAAA;AACjB,aAAW,OAAO,KAAK,MAAM,GAAG,EAAE,GAAG;AACnC,WAAO,KAAK,GAAG,EACZ,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,EACpC,QAAQ,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC;AAAA,EACnC;AAEA,SAAO,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,KAAK,WAAW;AAAA,IAC3C,KAAK,OAAO,SAAS,KAAK;AAAA,IAC1B,OAAO,MAAM,YAAY,GAAG,IAAI;AAAA,IAChC,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAI,cACA,EAAE,UAAU,CAAC,QAAY,IAAgC,GAAG,MAC5D,CAAA;AAAA,EAAC,EACL;AACJ;;;;;;;;;;"}

package/dist/data/data-table-utils.d.ts

@@ -11,6 +11,8 @@ export declare function resolveColumnValue<T extends Record<string, unknown>>(ro
 export declare function getFilterCandidate<T extends Record<string, unknown>>(row: T, column: DataTableColumn<T>): unknown;
 export declare function getFilterTokens<T extends Record<string, unknown>>(row: T, column: DataTableColumn<T>): string[];
 export declare function prettifyKey(key: string): string;
+export declare function labelText<T extends Record<string, unknown>>(column: DataTableColumn<T>): string;
+export declare function isColumnHideable<T extends Record<string, unknown>>(column: DataTableColumn<T>): boolean;
 export declare function inferColumns<T extends Record<string, unknown>>(data: T[], opts?: {
     /**
      * Treat every key as a literal property name rather than a dotted path,

package/dist/data/data-table-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-utils.d.ts","sourceRoot":"","sources":["../../src/data/data-table-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAUxD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,WAI3B;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,YAG3B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,UAMtC;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,CAAC,EAAE;IACL;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,eAAe,CAAC,CAAC,CAAC,EAAE,CAoBtB"}
+{"version":3,"file":"data-table-utils.d.ts","sourceRoot":"","sources":["../../src/data/data-table-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAUxD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,WAI3B;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,GAAG,EAAE,CAAC,EACN,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,YAG3B;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,UAMtC;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,UAI3B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,WAG3B;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,CAAC,EAAE;IACL;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,eAAe,CAAC,CAAC,CAAC,EAAE,CAoBtB"}

package/dist/data/data-table-utils.js

@@ -28,6 +28,13 @@ function getFilterTokens(row, column) {
 function prettifyKey(key) {
   return key.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/\b\w/g, (value) => value.toUpperCase()).trim();
 }
+function labelText(column) {
+  if (typeof column.label === "string") return column.label;
+  return prettifyKey(column.key.split(".").at(-1) ?? column.key);
+}
+function isColumnHideable(column) {
+  return column.hideable !== false;
+}
 function inferColumns(data, opts) {
   if (data.length === 0) return [];
   const literalKeys = (opts == null ? void 0 : opts.literalKeys) ?? false;
@@ -47,6 +54,8 @@ export {
   getFilterCandidate,
   getFilterTokens,
   inferColumns,
+  isColumnHideable,
+  labelText,
   normalizeTokens,
   prettifyKey,
   resolveColumnValue,

package/dist/data/data-table-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-table-utils.js","sources":["../../src/data/data-table-utils.ts"],"sourcesContent":["import type { DataTableColumn } from \"./DataTable\";\n\nexport function resolvePath(obj: unknown, path: string): unknown {\n  return path.split(\".\").reduce<unknown>((current, key) => {\n    if (current && typeof current === \"object\") {\n      return (current as Record<string, unknown>)[key];\n    }\n    return undefined;\n  }, obj);\n}\n\nexport function normalizeTokens(value: unknown): string[] {\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => normalizeTokens(item)).filter(Boolean);\n  }\n\n  if (value == null) return [];\n  if (typeof value === \"object\") return [JSON.stringify(value)];\n\n  const token = String(value).trim();\n  return token ? [token] : [];\n}\n\n/**\n * Reads a column's raw value from a row, honoring a column `accessor` when\n * present (for literal/empty/dotted SQL keys) and otherwise resolving `key` as\n * a dotted path. This is the single value-access seam for rendering, sorting,\n * and filtering.\n */\nexport function resolveColumnValue<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n): unknown {\n  return column.accessor ? column.accessor(row) : resolvePath(row, column.key);\n}\n\nexport function getFilterCandidate<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  const rawValue = resolveColumnValue(row, column);\n  return column.filterValue ? column.filterValue(rawValue, row) : rawValue;\n}\n\nexport function getFilterTokens<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  return normalizeTokens(getFilterCandidate(row, column));\n}\n\nexport function prettifyKey(key: string) {\n  return key\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/[_-]/g, \" \")\n    .replace(/\\b\\w/g, (value) => value.toUpperCase())\n    .trim();\n}\n\nexport function inferColumns<T extends Record<string, unknown>>(\n  data: T[],\n  opts?: {\n    /**\n     * Treat every key as a literal property name rather than a dotted path,\n     * and tolerate empty/dotted column names (e.g. raw SQL result sets). Each\n     * column carries an `accessor` reading `row[key]` directly, and blank keys\n     * get a stable placeholder id + label so the table renders instead of\n     * crashing on an id-less column.\n     */\n    literalKeys?: boolean;\n  },\n): DataTableColumn<T>[] {\n  if (data.length === 0) return [];\n  const literalKeys = opts?.literalKeys ?? false;\n\n  const keys = new Set<string>();\n  for (const row of data.slice(0, 20)) {\n    Object.keys(row)\n      .filter((key) => !key.startsWith(\"_\"))\n      .forEach((key) => keys.add(key));\n  }\n\n  return Array.from(keys).map((key, index) => ({\n    key: key || `__col_${index}`,\n    label: key ? prettifyKey(key) : \"(no column name)\",\n    sortable: true,\n    filterable: true,\n    ...(literalKeys\n      ? { accessor: (row: T) => (row as Record<string, unknown>)[key] }\n      : {}),\n  }));\n}\n"],"names":[],"mappings":"AAEO,SAAS,YAAY,KAAc,MAAuB;AAC/D,SAAO,KAAK,MAAM,GAAG,EAAE,OAAgB,CAAC,SAAS,QAAQ;AACvD,QAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,aAAQ,QAAoC,GAAG;AAAA,IACjD;AACA,WAAO;AAAA,EACT,GAAG,GAAG;AACR;AAEO,SAAS,gBAAgB,OAA0B;AACxD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,QAAQ,CAAC,SAAS,gBAAgB,IAAI,CAAC,EAAE,OAAO,OAAO;AAAA,EACtE;AAEA,MAAI,SAAS,KAAM,QAAO,CAAA;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC,KAAK,UAAU,KAAK,CAAC;AAE5D,QAAM,QAAQ,OAAO,KAAK,EAAE,KAAA;AAC5B,SAAO,QAAQ,CAAC,KAAK,IAAI,CAAA;AAC3B;AAQO,SAAS,mBACd,KACA,QACS;AACT,SAAO,OAAO,WAAW,OAAO,SAAS,GAAG,IAAI,YAAY,KAAK,OAAO,GAAG;AAC7E;AAEO,SAAS,mBACd,KACA,QACA;AACA,QAAM,WAAW,mBAAmB,KAAK,MAAM;AAC/C,SAAO,OAAO,cAAc,OAAO,YAAY,UAAU,GAAG,IAAI;AAClE;AAEO,SAAS,gBACd,KACA,QACA;AACA,SAAO,gBAAgB,mBAAmB,KAAK,MAAM,CAAC;AACxD;AAEO,SAAS,YAAY,KAAa;AACvC,SAAO,IACJ,QAAQ,mBAAmB,OAAO,EAClC,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,CAAC,UAAU,MAAM,YAAA,CAAa,EAC/C,KAAA;AACL;AAEO,SAAS,aACd,MACA,MAUsB;AACtB,MAAI,KAAK,WAAW,EAAG,QAAO,CAAA;AAC9B,QAAM,eAAc,6BAAM,gBAAe;AAEzC,QAAM,2BAAW,IAAA;AACjB,aAAW,OAAO,KAAK,MAAM,GAAG,EAAE,GAAG;AACnC,WAAO,KAAK,GAAG,EACZ,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,EACpC,QAAQ,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC;AAAA,EACnC;AAEA,SAAO,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,KAAK,WAAW;AAAA,IAC3C,KAAK,OAAO,SAAS,KAAK;AAAA,IAC1B,OAAO,MAAM,YAAY,GAAG,IAAI;AAAA,IAChC,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAI,cACA,EAAE,UAAU,CAAC,QAAY,IAAgC,GAAG,MAC5D,CAAA;AAAA,EAAC,EACL;AACJ;"}
+{"version":3,"file":"data-table-utils.js","sources":["../../src/data/data-table-utils.ts"],"sourcesContent":["import type { DataTableColumn } from \"./DataTable\";\n\nexport function resolvePath(obj: unknown, path: string): unknown {\n  return path.split(\".\").reduce<unknown>((current, key) => {\n    if (current && typeof current === \"object\") {\n      return (current as Record<string, unknown>)[key];\n    }\n    return undefined;\n  }, obj);\n}\n\nexport function normalizeTokens(value: unknown): string[] {\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => normalizeTokens(item)).filter(Boolean);\n  }\n\n  if (value == null) return [];\n  if (typeof value === \"object\") return [JSON.stringify(value)];\n\n  const token = String(value).trim();\n  return token ? [token] : [];\n}\n\n/**\n * Reads a column's raw value from a row, honoring a column `accessor` when\n * present (for literal/empty/dotted SQL keys) and otherwise resolving `key` as\n * a dotted path. This is the single value-access seam for rendering, sorting,\n * and filtering.\n */\nexport function resolveColumnValue<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n): unknown {\n  return column.accessor ? column.accessor(row) : resolvePath(row, column.key);\n}\n\nexport function getFilterCandidate<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  const rawValue = resolveColumnValue(row, column);\n  return column.filterValue ? column.filterValue(rawValue, row) : rawValue;\n}\n\nexport function getFilterTokens<T extends Record<string, unknown>>(\n  row: T,\n  column: DataTableColumn<T>,\n) {\n  return normalizeTokens(getFilterCandidate(row, column));\n}\n\nexport function prettifyKey(key: string) {\n  return key\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/[_-]/g, \" \")\n    .replace(/\\b\\w/g, (value) => value.toUpperCase())\n    .trim();\n}\n\nexport function labelText<T extends Record<string, unknown>>(\n  column: DataTableColumn<T>,\n) {\n  if (typeof column.label === \"string\") return column.label;\n  return prettifyKey(column.key.split(\".\").at(-1) ?? column.key);\n}\n\nexport function isColumnHideable<T extends Record<string, unknown>>(\n  column: DataTableColumn<T>,\n) {\n  return column.hideable !== false;\n}\n\nexport function inferColumns<T extends Record<string, unknown>>(\n  data: T[],\n  opts?: {\n    /**\n     * Treat every key as a literal property name rather than a dotted path,\n     * and tolerate empty/dotted column names (e.g. raw SQL result sets). Each\n     * column carries an `accessor` reading `row[key]` directly, and blank keys\n     * get a stable placeholder id + label so the table renders instead of\n     * crashing on an id-less column.\n     */\n    literalKeys?: boolean;\n  },\n): DataTableColumn<T>[] {\n  if (data.length === 0) return [];\n  const literalKeys = opts?.literalKeys ?? false;\n\n  const keys = new Set<string>();\n  for (const row of data.slice(0, 20)) {\n    Object.keys(row)\n      .filter((key) => !key.startsWith(\"_\"))\n      .forEach((key) => keys.add(key));\n  }\n\n  return Array.from(keys).map((key, index) => ({\n    key: key || `__col_${index}`,\n    label: key ? prettifyKey(key) : \"(no column name)\",\n    sortable: true,\n    filterable: true,\n    ...(literalKeys\n      ? { accessor: (row: T) => (row as Record<string, unknown>)[key] }\n      : {}),\n  }));\n}\n"],"names":[],"mappings":"AAEO,SAAS,YAAY,KAAc,MAAuB;AAC/D,SAAO,KAAK,MAAM,GAAG,EAAE,OAAgB,CAAC,SAAS,QAAQ;AACvD,QAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,aAAQ,QAAoC,GAAG;AAAA,IACjD;AACA,WAAO;AAAA,EACT,GAAG,GAAG;AACR;AAEO,SAAS,gBAAgB,OAA0B;AACxD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,QAAQ,CAAC,SAAS,gBAAgB,IAAI,CAAC,EAAE,OAAO,OAAO;AAAA,EACtE;AAEA,MAAI,SAAS,KAAM,QAAO,CAAA;AAC1B,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC,KAAK,UAAU,KAAK,CAAC;AAE5D,QAAM,QAAQ,OAAO,KAAK,EAAE,KAAA;AAC5B,SAAO,QAAQ,CAAC,KAAK,IAAI,CAAA;AAC3B;AAQO,SAAS,mBACd,KACA,QACS;AACT,SAAO,OAAO,WAAW,OAAO,SAAS,GAAG,IAAI,YAAY,KAAK,OAAO,GAAG;AAC7E;AAEO,SAAS,mBACd,KACA,QACA;AACA,QAAM,WAAW,mBAAmB,KAAK,MAAM;AAC/C,SAAO,OAAO,cAAc,OAAO,YAAY,UAAU,GAAG,IAAI;AAClE;AAEO,SAAS,gBACd,KACA,QACA;AACA,SAAO,gBAAgB,mBAAmB,KAAK,MAAM,CAAC;AACxD;AAEO,SAAS,YAAY,KAAa;AACvC,SAAO,IACJ,QAAQ,mBAAmB,OAAO,EAClC,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,CAAC,UAAU,MAAM,YAAA,CAAa,EAC/C,KAAA;AACL;AAEO,SAAS,UACd,QACA;AACA,MAAI,OAAO,OAAO,UAAU,iBAAiB,OAAO;AACpD,SAAO,YAAY,OAAO,IAAI,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG;AAC/D;AAEO,SAAS,iBACd,QACA;AACA,SAAO,OAAO,aAAa;AAC7B;AAEO,SAAS,aACd,MACA,MAUsB;AACtB,MAAI,KAAK,WAAW,EAAG,QAAO,CAAA;AAC9B,QAAM,eAAc,6BAAM,gBAAe;AAEzC,QAAM,2BAAW,IAAA;AACjB,aAAW,OAAO,KAAK,MAAM,GAAG,EAAE,GAAG;AACnC,WAAO,KAAK,GAAG,EACZ,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,EACpC,QAAQ,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC;AAAA,EACnC;AAEA,SAAO,MAAM,KAAK,IAAI,EAAE,IAAI,CAAC,KAAK,WAAW;AAAA,IAC3C,KAAK,OAAO,SAAS,KAAK;AAAA,IAC1B,OAAO,MAAM,YAAY,GAAG,IAAI;AAAA,IAChC,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,GAAI,cACA,EAAE,UAAU,CAAC,QAAY,IAAgC,GAAG,MAC5D,CAAA;AAAA,EAAC,EACL;AACJ;"}

package/dist/data/dataTableMenuPosition.cjs

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react$1 = require("@floating-ui/react");
+const react = require("react");
+function menuStateFromPointer(event, columnKey) {
+  return {
+    reference: { x: event.clientX, y: event.clientY, width: 0, height: 0 },
+    placement: "bottom-start",
+    ...columnKey ? { columnKey } : {}
+  };
+}
+function menuStateFromTrigger(event, columnKey) {
+  const rect = event.currentTarget.getBoundingClientRect();
+  return {
+    reference: { x: rect.left, y: rect.top, width: rect.width, height: rect.height },
+    placement: "bottom-end",
+    ...columnKey ? { columnKey } : {}
+  };
+}
+const PANEL_PADDING = 8;
+function useMenuPanelPosition(anchor) {
+  const { x, y, width, height } = anchor.reference;
+  const reference = react.useMemo(
+    () => ({
+      getBoundingClientRect: () => ({
+        x,
+        y,
+        top: y,
+        left: x,
+        width,
+        height,
+        right: x + width,
+        bottom: y + height,
+        toJSON: () => ({})
+      })
+    }),
+    [x, y, width, height]
+  );
+  const { refs, floatingStyles } = react$1.useFloating({
+    strategy: "fixed",
+    placement: anchor.placement,
+    transform: false,
+    whileElementsMounted: react$1.autoUpdate,
+    middleware: [
+      react$1.offset(6),
+      react$1.flip({ padding: PANEL_PADDING }),
+      react$1.shift({ padding: PANEL_PADDING }),
+      react$1.size({
+        padding: PANEL_PADDING,
+        apply({ availableHeight, elements }) {
+          elements.floating.style.maxHeight = `${Math.max(0, Math.floor(availableHeight))}px`;
+        }
+      })
+    ]
+  });
+  react.useLayoutEffect(() => {
+    refs.setPositionReference(reference);
+  }, [refs, reference]);
+  return { ref: refs.setFloating, style: floatingStyles };
+}
+exports.menuStateFromPointer = menuStateFromPointer;
+exports.menuStateFromTrigger = menuStateFromTrigger;
+exports.useMenuPanelPosition = useMenuPanelPosition;
+//# sourceMappingURL=dataTableMenuPosition.cjs.map

package/dist/data/dataTableMenuPosition.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTableMenuPosition.cjs","sources":["../../src/data/dataTableMenuPosition.ts"],"sourcesContent":["import { autoUpdate, flip, offset, shift, size, useFloating, type Placement } from \"@floating-ui/react\";\nimport { useLayoutEffect, useMemo, type CSSProperties, type MouseEvent as ReactMouseEvent } from \"react\";\n\n/**\n * Where a DataTable panel (the column menu, a column's filter) opens from: the\n * box it is anchored to — the pressed trigger, or the point of a right-click —\n * and which of that box's corners it starts at.\n */\nexport type ColumnMenuState = {\n  reference: { x: number; y: number; width: number; height: number };\n  placement: Placement;\n  columnKey?: string;\n};\n\nexport function menuStateFromPointer(event: ReactMouseEvent<HTMLElement>, columnKey?: string): ColumnMenuState {\n  return {\n    reference: { x: event.clientX, y: event.clientY, width: 0, height: 0 },\n    placement: \"bottom-start\",\n    ...(columnKey ? { columnKey } : {}),\n  };\n}\n\nexport function menuStateFromTrigger(event: ReactMouseEvent<HTMLElement>, columnKey?: string): ColumnMenuState {\n  const rect = event.currentTarget.getBoundingClientRect();\n  return {\n    reference: { x: rect.left, y: rect.top, width: rect.width, height: rect.height },\n    placement: \"bottom-end\",\n    ...(columnKey ? { columnKey } : {}),\n  };\n}\n\nconst PANEL_PADDING = 8;\n\n/**\n * useMenuPanelPosition places a fixed panel against its anchor and keeps all of\n * it on screen, whatever its height. The panel's height is measured, not\n * assumed: a column menu grows with every column, so one placed for a fixed\n * height ran off the bottom of the viewport, taking its last rows — the actions\n * — out of reach. It flips above the anchor when there is more room there, and\n * is capped to the room it has, so a panel taller than either side scrolls.\n */\nexport function useMenuPanelPosition(anchor: ColumnMenuState): {\n  ref: (node: HTMLElement | null) => void;\n  style: CSSProperties;\n} {\n  const { x, y, width, height } = anchor.reference;\n  const reference = useMemo(\n    () => ({\n      getBoundingClientRect: () =>\n        ({\n          x,\n          y,\n          top: y,\n          left: x,\n          width,\n          height,\n          right: x + width,\n          bottom: y + height,\n          toJSON: () => ({}),\n        }) as DOMRect,\n    }),\n    [x, y, width, height],\n  );\n  const { refs, floatingStyles } = useFloating({\n    strategy: \"fixed\",\n    placement: anchor.placement,\n    transform: false,\n    whileElementsMounted: autoUpdate,\n    middleware: [\n      offset(6),\n      flip({ padding: PANEL_PADDING }),\n      shift({ padding: PANEL_PADDING }),\n      size({\n        padding: PANEL_PADDING,\n        apply({ availableHeight, elements }) {\n          elements.floating.style.maxHeight = `${Math.max(0, Math.floor(availableHeight))}px`;\n        },\n      }),\n    ],\n  });\n  useLayoutEffect(() => {\n    refs.setPositionReference(reference);\n  }, [refs, reference]);\n  return { ref: refs.setFloating, style: floatingStyles };\n}\n"],"names":["useMemo","useFloating","autoUpdate","offset","flip","shift","size","useLayoutEffect"],"mappings":";;;;AAcO,SAAS,qBAAqB,OAAqC,WAAqC;AAC7G,SAAO;AAAA,IACL,WAAW,EAAE,GAAG,MAAM,SAAS,GAAG,MAAM,SAAS,OAAO,GAAG,QAAQ,EAAA;AAAA,IACnE,WAAW;AAAA,IACX,GAAI,YAAY,EAAE,cAAc,CAAA;AAAA,EAAC;AAErC;AAEO,SAAS,qBAAqB,OAAqC,WAAqC;AAC7G,QAAM,OAAO,MAAM,cAAc,sBAAA;AACjC,SAAO;AAAA,IACL,WAAW,EAAE,GAAG,KAAK,MAAM,GAAG,KAAK,KAAK,OAAO,KAAK,OAAO,QAAQ,KAAK,OAAA;AAAA,IACxE,WAAW;AAAA,IACX,GAAI,YAAY,EAAE,cAAc,CAAA;AAAA,EAAC;AAErC;AAEA,MAAM,gBAAgB;AAUf,SAAS,qBAAqB,QAGnC;AACA,QAAM,EAAE,GAAG,GAAG,OAAO,OAAA,IAAW,OAAO;AACvC,QAAM,YAAYA,MAAAA;AAAAA,IAChB,OAAO;AAAA,MACL,uBAAuB,OACpB;AAAA,QACC;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA,OAAO,IAAI;AAAA,QACX,QAAQ,IAAI;AAAA,QACZ,QAAQ,OAAO,CAAA;AAAA,MAAC;AAAA,IAClB;AAAA,IAEJ,CAAC,GAAG,GAAG,OAAO,MAAM;AAAA,EAAA;AAEtB,QAAM,EAAE,MAAM,eAAA,IAAmBC,oBAAY;AAAA,IAC3C,UAAU;AAAA,IACV,WAAW,OAAO;AAAA,IAClB,WAAW;AAAA,IACX,sBAAsBC,QAAAA;AAAAA,IACtB,YAAY;AAAA,MACVC,QAAAA,OAAO,CAAC;AAAA,MACRC,aAAK,EAAE,SAAS,eAAe;AAAA,MAC/BC,cAAM,EAAE,SAAS,eAAe;AAAA,MAChCC,aAAK;AAAA,QACH,SAAS;AAAA,QACT,MAAM,EAAE,iBAAiB,YAAY;AACnC,mBAAS,SAAS,MAAM,YAAY,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,eAAe,CAAC,CAAC;AAAA,QACjF;AAAA,MAAA,CACD;AAAA,IAAA;AAAA,EACH,CACD;AACDC,QAAAA,gBAAgB,MAAM;AACpB,SAAK,qBAAqB,SAAS;AAAA,EACrC,GAAG,CAAC,MAAM,SAAS,CAAC;AACpB,SAAO,EAAE,KAAK,KAAK,aAAa,OAAO,eAAA;AACzC;;;;"}

package/dist/data/dataTableMenuPosition.d.ts

@@ -0,0 +1,32 @@
+import { Placement } from '@floating-ui/react';
+import { CSSProperties, MouseEvent as ReactMouseEvent } from 'react';
+/**
+ * Where a DataTable panel (the column menu, a column's filter) opens from: the
+ * box it is anchored to — the pressed trigger, or the point of a right-click —
+ * and which of that box's corners it starts at.
+ */
+export type ColumnMenuState = {
+    reference: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    placement: Placement;
+    columnKey?: string;
+};
+export declare function menuStateFromPointer(event: ReactMouseEvent<HTMLElement>, columnKey?: string): ColumnMenuState;
+export declare function menuStateFromTrigger(event: ReactMouseEvent<HTMLElement>, columnKey?: string): ColumnMenuState;
+/**
+ * useMenuPanelPosition places a fixed panel against its anchor and keeps all of
+ * it on screen, whatever its height. The panel's height is measured, not
+ * assumed: a column menu grows with every column, so one placed for a fixed
+ * height ran off the bottom of the viewport, taking its last rows — the actions
+ * — out of reach. It flips above the anchor when there is more room there, and
+ * is capped to the room it has, so a panel taller than either side scrolls.
+ */
+export declare function useMenuPanelPosition(anchor: ColumnMenuState): {
+    ref: (node: HTMLElement | null) => void;
+    style: CSSProperties;
+};
+//# sourceMappingURL=dataTableMenuPosition.d.ts.map

package/dist/data/dataTableMenuPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTableMenuPosition.d.ts","sourceRoot":"","sources":["../../src/data/dataTableMenuPosition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxG,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,UAAU,IAAI,eAAe,EAAE,MAAM,OAAO,CAAC;AAEzG;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAM7G;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAO7G;AAID;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG;IAC7D,GAAG,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACxC,KAAK,EAAE,aAAa,CAAC;CACtB,CAwCA"}

package/dist/data/dataTableMenuPosition.js

@@ -0,0 +1,64 @@
+import { useFloating, autoUpdate, offset, flip, shift, size } from "@floating-ui/react";
+import { useMemo, useLayoutEffect } from "react";
+function menuStateFromPointer(event, columnKey) {
+  return {
+    reference: { x: event.clientX, y: event.clientY, width: 0, height: 0 },
+    placement: "bottom-start",
+    ...columnKey ? { columnKey } : {}
+  };
+}
+function menuStateFromTrigger(event, columnKey) {
+  const rect = event.currentTarget.getBoundingClientRect();
+  return {
+    reference: { x: rect.left, y: rect.top, width: rect.width, height: rect.height },
+    placement: "bottom-end",
+    ...columnKey ? { columnKey } : {}
+  };
+}
+const PANEL_PADDING = 8;
+function useMenuPanelPosition(anchor) {
+  const { x, y, width, height } = anchor.reference;
+  const reference = useMemo(
+    () => ({
+      getBoundingClientRect: () => ({
+        x,
+        y,
+        top: y,
+        left: x,
+        width,
+        height,
+        right: x + width,
+        bottom: y + height,
+        toJSON: () => ({})
+      })
+    }),
+    [x, y, width, height]
+  );
+  const { refs, floatingStyles } = useFloating({
+    strategy: "fixed",
+    placement: anchor.placement,
+    transform: false,
+    whileElementsMounted: autoUpdate,
+    middleware: [
+      offset(6),
+      flip({ padding: PANEL_PADDING }),
+      shift({ padding: PANEL_PADDING }),
+      size({
+        padding: PANEL_PADDING,
+        apply({ availableHeight, elements }) {
+          elements.floating.style.maxHeight = `${Math.max(0, Math.floor(availableHeight))}px`;
+        }
+      })
+    ]
+  });
+  useLayoutEffect(() => {
+    refs.setPositionReference(reference);
+  }, [refs, reference]);
+  return { ref: refs.setFloating, style: floatingStyles };
+}
+export {
+  menuStateFromPointer,
+  menuStateFromTrigger,
+  useMenuPanelPosition
+};
+//# sourceMappingURL=dataTableMenuPosition.js.map

package/dist/data/dataTableMenuPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTableMenuPosition.js","sources":["../../src/data/dataTableMenuPosition.ts"],"sourcesContent":["import { autoUpdate, flip, offset, shift, size, useFloating, type Placement } from \"@floating-ui/react\";\nimport { useLayoutEffect, useMemo, type CSSProperties, type MouseEvent as ReactMouseEvent } from \"react\";\n\n/**\n * Where a DataTable panel (the column menu, a column's filter) opens from: the\n * box it is anchored to — the pressed trigger, or the point of a right-click —\n * and which of that box's corners it starts at.\n */\nexport type ColumnMenuState = {\n  reference: { x: number; y: number; width: number; height: number };\n  placement: Placement;\n  columnKey?: string;\n};\n\nexport function menuStateFromPointer(event: ReactMouseEvent<HTMLElement>, columnKey?: string): ColumnMenuState {\n  return {\n    reference: { x: event.clientX, y: event.clientY, width: 0, height: 0 },\n    placement: \"bottom-start\",\n    ...(columnKey ? { columnKey } : {}),\n  };\n}\n\nexport function menuStateFromTrigger(event: ReactMouseEvent<HTMLElement>, columnKey?: string): ColumnMenuState {\n  const rect = event.currentTarget.getBoundingClientRect();\n  return {\n    reference: { x: rect.left, y: rect.top, width: rect.width, height: rect.height },\n    placement: \"bottom-end\",\n    ...(columnKey ? { columnKey } : {}),\n  };\n}\n\nconst PANEL_PADDING = 8;\n\n/**\n * useMenuPanelPosition places a fixed panel against its anchor and keeps all of\n * it on screen, whatever its height. The panel's height is measured, not\n * assumed: a column menu grows with every column, so one placed for a fixed\n * height ran off the bottom of the viewport, taking its last rows — the actions\n * — out of reach. It flips above the anchor when there is more room there, and\n * is capped to the room it has, so a panel taller than either side scrolls.\n */\nexport function useMenuPanelPosition(anchor: ColumnMenuState): {\n  ref: (node: HTMLElement | null) => void;\n  style: CSSProperties;\n} {\n  const { x, y, width, height } = anchor.reference;\n  const reference = useMemo(\n    () => ({\n      getBoundingClientRect: () =>\n        ({\n          x,\n          y,\n          top: y,\n          left: x,\n          width,\n          height,\n          right: x + width,\n          bottom: y + height,\n          toJSON: () => ({}),\n        }) as DOMRect,\n    }),\n    [x, y, width, height],\n  );\n  const { refs, floatingStyles } = useFloating({\n    strategy: \"fixed\",\n    placement: anchor.placement,\n    transform: false,\n    whileElementsMounted: autoUpdate,\n    middleware: [\n      offset(6),\n      flip({ padding: PANEL_PADDING }),\n      shift({ padding: PANEL_PADDING }),\n      size({\n        padding: PANEL_PADDING,\n        apply({ availableHeight, elements }) {\n          elements.floating.style.maxHeight = `${Math.max(0, Math.floor(availableHeight))}px`;\n        },\n      }),\n    ],\n  });\n  useLayoutEffect(() => {\n    refs.setPositionReference(reference);\n  }, [refs, reference]);\n  return { ref: refs.setFloating, style: floatingStyles };\n}\n"],"names":[],"mappings":";;AAcO,SAAS,qBAAqB,OAAqC,WAAqC;AAC7G,SAAO;AAAA,IACL,WAAW,EAAE,GAAG,MAAM,SAAS,GAAG,MAAM,SAAS,OAAO,GAAG,QAAQ,EAAA;AAAA,IACnE,WAAW;AAAA,IACX,GAAI,YAAY,EAAE,cAAc,CAAA;AAAA,EAAC;AAErC;AAEO,SAAS,qBAAqB,OAAqC,WAAqC;AAC7G,QAAM,OAAO,MAAM,cAAc,sBAAA;AACjC,SAAO;AAAA,IACL,WAAW,EAAE,GAAG,KAAK,MAAM,GAAG,KAAK,KAAK,OAAO,KAAK,OAAO,QAAQ,KAAK,OAAA;AAAA,IACxE,WAAW;AAAA,IACX,GAAI,YAAY,EAAE,cAAc,CAAA;AAAA,EAAC;AAErC;AAEA,MAAM,gBAAgB;AAUf,SAAS,qBAAqB,QAGnC;AACA,QAAM,EAAE,GAAG,GAAG,OAAO,OAAA,IAAW,OAAO;AACvC,QAAM,YAAY;AAAA,IAChB,OAAO;AAAA,MACL,uBAAuB,OACpB;AAAA,QACC;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA,OAAO,IAAI;AAAA,QACX,QAAQ,IAAI;AAAA,QACZ,QAAQ,OAAO,CAAA;AAAA,MAAC;AAAA,IAClB;AAAA,IAEJ,CAAC,GAAG,GAAG,OAAO,MAAM;AAAA,EAAA;AAEtB,QAAM,EAAE,MAAM,eAAA,IAAmB,YAAY;AAAA,IAC3C,UAAU;AAAA,IACV,WAAW,OAAO;AAAA,IAClB,WAAW;AAAA,IACX,sBAAsB;AAAA,IACtB,YAAY;AAAA,MACV,OAAO,CAAC;AAAA,MACR,KAAK,EAAE,SAAS,eAAe;AAAA,MAC/B,MAAM,EAAE,SAAS,eAAe;AAAA,MAChC,KAAK;AAAA,QACH,SAAS;AAAA,QACT,MAAM,EAAE,iBAAiB,YAAY;AACnC,mBAAS,SAAS,MAAM,YAAY,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,eAAe,CAAC,CAAC;AAAA,QACjF;AAAA,MAAA,CACD;AAAA,IAAA;AAAA,EACH,CACD;AACD,kBAAgB,MAAM;AACpB,SAAK,qBAAqB,SAAS;AAAA,EACrC,GAAG,CAAC,MAAM,SAAS,CAAC;AACpB,SAAO,EAAE,KAAK,KAAK,aAAa,OAAO,eAAA;AACzC;"}

package/dist/data/diagnostics/FrameSourceWindow.cjs

@@ -6,7 +6,8 @@ const codeHighlight = require("../code-highlight.cjs");
 const HighlightedTokens = require("../HighlightedTokens.cjs");
 function FrameSourceWindow({
   frame,
-  className
+  className,
+  focalTone = "error"
 }) {
   const lines = react.useMemo(() => frame.sourceLines ?? [], [frame.sourceLines]);
   const start = frame.sourceStartLine ?? 0;
@@ -28,6 +29,7 @@ function FrameSourceWindow({
     };
   }, [lines, language]);
   if (lines.length === 0) return null;
+  const focalClassName = focalTone === "neutral" ? "bg-primary/10 font-semibold text-foreground" : "bg-red-500/10 font-semibold text-red-800 dark:text-red-300";
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
@@ -37,18 +39,19 @@ function FrameSourceWindow({
       ].filter(Boolean).join(" "),
       children: lines.map((source, i) => {
         const lineNumber = (numbers == null ? void 0 : numbers[i]) ?? start + i;
-        const isFocal = lineNumber === focal;
+        const known = numbers === void 0 || lineNumber > 0;
+        const isFocal = known && lineNumber === focal;
         return /* @__PURE__ */ jsxRuntime.jsxs(
           "div",
           {
             className: [
               "grid min-w-max grid-cols-[3.5rem_minmax(24rem,1fr)] gap-3 px-2",
-              isFocal ? "bg-red-500/10 font-semibold text-red-800 dark:text-red-300" : "text-foreground"
+              isFocal ? focalClassName : "text-foreground"
             ].join(" "),
             children: [
               /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "select-none text-right text-muted-foreground", children: [
                 isFocal ? ">" : "",
-                lineNumber
+                known ? lineNumber : ""
               ] }),
               /* @__PURE__ */ jsxRuntime.jsx("code", { className: "whitespace-pre", children: source ? /* @__PURE__ */ jsxRuntime.jsx(HighlightedTokens.HighlightedTokens, { tokens: tokens == null ? void 0 : tokens[i], content: source }) : " " })
             ]

package/dist/data/diagnostics/FrameSourceWindow.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"FrameSourceWindow.cjs","sources":["../../../src/data/diagnostics/FrameSourceWindow.tsx"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport { highlightToLines, type HighlightedLine } from \"../code-highlight\";\nimport { HighlightedTokens } from \"../HighlightedTokens\";\nimport type { FrameSource } from \"./FrameSourceWindow.utils\";\n\n// FrameSourceWindow renders a decompiled / resolved source window beneath a\n// stack frame: a gutter of absolute line numbers with the focal line (the one\n// the frame points at) highlighted. It is the single source-window renderer,\n// shared by the JVM thread-dump frames, the exception stack-trace frames, and\n// frameless callers that have source but no stack (a template error, a single\n// decompiled class).\n//\n// The gutter is painted explicitly rather than by embedding Shiki's own `<pre>`,\n// because `sourceLineNumbers` is frequently NOT a contiguous run: arthas `jad`\n// returns bytecode-keyed line numbers with gaps. A CSS-counter gutter would\n// silently renumber those. Tokenizing via `highlightToLines` keeps the\n// highlighting while letting us own the numbering — the same trade CodeDiff makes.\nexport function FrameSourceWindow({\n  frame,\n  className,\n}: {\n  frame: FrameSource;\n  className?: string;\n}) {\n  const lines = useMemo(() => frame.sourceLines ?? [], [frame.sourceLines]);\n  const start = frame.sourceStartLine ?? 0;\n  const numbers = frame.sourceLineNumbers;\n  const focal = frame.line ?? -1;\n  // No default language: this renderer is shared by JVM frames, exception frames\n  // and frameless callers, so a Go dump or a template error must not be coloured\n  // with Java grammar. `highlightToLines` returns null without a language and\n  // `HighlightedTokens` then paints the plain source.\n  const language = frame.sourceLanguage;\n\n  const [tokens, setTokens] = useState<HighlightedLine[] | null>(null);\n\n  useEffect(() => {\n    if (lines.length === 0) {\n      setTokens(null);\n      return;\n    }\n    let cancelled = false;\n    highlightToLines(lines.join(\"\\n\"), { lang: language }).then((out) => {\n      if (!cancelled) setTokens(out);\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [lines, language]);\n\n  if (lines.length === 0) return null;\n\n  return (\n    <div\n      className={[\n        \"mx-3 mb-2 ml-12 overflow-x-auto rounded border border-border/60 bg-muted/30 py-1 font-mono text-[11px] leading-relaxed\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n    >\n      {lines.map((source, i) => {\n        const lineNumber = numbers?.[i] ?? start + i;\n        const isFocal = lineNumber === focal;\n        return (\n          <div\n            key={`${lineNumber}-${i}`}\n            className={[\n              \"grid min-w-max grid-cols-[3.5rem_minmax(24rem,1fr)] gap-3 px-2\",\n              isFocal ? \"bg-red-500/10 font-semibold text-red-800 dark:text-red-300\" : \"text-foreground\",\n            ].join(\" \")}\n          >\n            <span className=\"select-none text-right text-muted-foreground\">\n              {isFocal ? \">\" : \"\"}\n              {lineNumber}\n            </span>\n            <code className=\"whitespace-pre\">\n              {source ? <HighlightedTokens tokens={tokens?.[i]} content={source} /> : \" \"}\n            </code>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n"],"names":["useMemo","useState","useEffect","highlightToLines","jsx","jsxs","HighlightedTokens"],"mappings":";;;;;;AAiBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AACF,GAGG;AACD,QAAM,QAAQA,MAAAA,QAAQ,MAAM,MAAM,eAAe,IAAI,CAAC,MAAM,WAAW,CAAC;AACxE,QAAM,QAAQ,MAAM,mBAAmB;AACvC,QAAM,UAAU,MAAM;AACtB,QAAM,QAAQ,MAAM,QAAQ;AAK5B,QAAM,WAAW,MAAM;AAEvB,QAAM,CAAC,QAAQ,SAAS,IAAIC,MAAAA,SAAmC,IAAI;AAEnEC,QAAAA,UAAU,MAAM;AACd,QAAI,MAAM,WAAW,GAAG;AACtB,gBAAU,IAAI;AACd;AAAA,IACF;AACA,QAAI,YAAY;AAChBC,kBAAAA,iBAAiB,MAAM,KAAK,IAAI,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,CAAC,QAAQ;AACnE,UAAI,CAAC,UAAW,WAAU,GAAG;AAAA,IAC/B,CAAC;AACD,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,OAAO,QAAQ,CAAC;AAEpB,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,SACEC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MAAA,EAEC,OAAO,OAAO,EACd,KAAK,GAAG;AAAA,MAEV,UAAA,MAAM,IAAI,CAAC,QAAQ,MAAM;AACxB,cAAM,cAAa,mCAAU,OAAM,QAAQ;AAC3C,cAAM,UAAU,eAAe;AAC/B,eACEC,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAW;AAAA,cACT;AAAA,cACA,UAAU,+DAA+D;AAAA,YAAA,EACzE,KAAK,GAAG;AAAA,YAEV,UAAA;AAAA,cAAAA,2BAAAA,KAAC,QAAA,EAAK,WAAU,gDACb,UAAA;AAAA,gBAAA,UAAU,MAAM;AAAA,gBAChB;AAAA,cAAA,GACH;AAAA,cACAD,2BAAAA,IAAC,QAAA,EAAK,WAAU,kBACb,mBAASA,+BAACE,kBAAAA,mBAAA,EAAkB,QAAQ,iCAAS,IAAI,SAAS,OAAA,CAAQ,IAAK,IAAA,CAC1E;AAAA,YAAA;AAAA,UAAA;AAAA,UAZK,GAAG,UAAU,IAAI,CAAC;AAAA,QAAA;AAAA,MAe7B,CAAC;AAAA,IAAA;AAAA,EAAA;AAGP;;"}
+{"version":3,"file":"FrameSourceWindow.cjs","sources":["../../../src/data/diagnostics/FrameSourceWindow.tsx"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport { highlightToLines, type HighlightedLine } from \"../code-highlight\";\nimport { HighlightedTokens } from \"../HighlightedTokens\";\nimport type { FrameSource } from \"./FrameSourceWindow.utils\";\n\n// FrameSourceWindow renders a decompiled / resolved source window beneath a\n// stack frame: a gutter of absolute line numbers with the focal line (the one\n// the frame points at) highlighted. It is the single source-window renderer,\n// shared by the JVM thread-dump frames, the exception stack-trace frames, and\n// frameless callers that have source but no stack (a template error, a single\n// decompiled class).\n//\n// The gutter is painted explicitly rather than by embedding Shiki's own `<pre>`,\n// because `sourceLineNumbers` is frequently NOT a contiguous run: arthas `jad`\n// returns bytecode-keyed line numbers with gaps. A CSS-counter gutter would\n// silently renumber those. Tokenizing via `highlightToLines` keeps the\n// highlighting while letting us own the numbering — the same trade CodeDiff makes.\nexport function FrameSourceWindow({\n  frame,\n  className,\n  focalTone = \"error\",\n}: {\n  frame: FrameSource;\n  className?: string;\n  /**\n   * Styling for the focal line. `\"error\"` (the default, so existing callers\n   * render unchanged) is the red highlight meaning \"this line failed\".\n   * `\"neutral\"` marks \"the line that made this call\" — a subtle theme-token\n   * highlight with no red.\n   */\n  focalTone?: \"error\" | \"neutral\";\n}) {\n  const lines = useMemo(() => frame.sourceLines ?? [], [frame.sourceLines]);\n  const start = frame.sourceStartLine ?? 0;\n  const numbers = frame.sourceLineNumbers;\n  const focal = frame.line ?? -1;\n  // No default language: this renderer is shared by JVM frames, exception frames\n  // and frameless callers, so a Go dump or a template error must not be coloured\n  // with Java grammar. `highlightToLines` returns null without a language and\n  // `HighlightedTokens` then paints the plain source.\n  const language = frame.sourceLanguage;\n\n  const [tokens, setTokens] = useState<HighlightedLine[] | null>(null);\n\n  useEffect(() => {\n    if (lines.length === 0) {\n      setTokens(null);\n      return;\n    }\n    let cancelled = false;\n    highlightToLines(lines.join(\"\\n\"), { lang: language }).then((out) => {\n      if (!cancelled) setTokens(out);\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [lines, language]);\n\n  if (lines.length === 0) return null;\n\n  const focalClassName =\n    focalTone === \"neutral\"\n      ? \"bg-primary/10 font-semibold text-foreground\"\n      : \"bg-red-500/10 font-semibold text-red-800 dark:text-red-300\";\n\n  return (\n    <div\n      className={[\n        \"mx-3 mb-2 ml-12 overflow-x-auto rounded border border-border/60 bg-muted/30 py-1 font-mono text-[11px] leading-relaxed\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n    >\n      {lines.map((source, i) => {\n        const lineNumber = numbers?.[i] ?? start + i;\n        const known = numbers === undefined || lineNumber > 0;\n        const isFocal = known && lineNumber === focal;\n        return (\n          <div\n            key={`${lineNumber}-${i}`}\n            className={[\n              \"grid min-w-max grid-cols-[3.5rem_minmax(24rem,1fr)] gap-3 px-2\",\n              isFocal ? focalClassName : \"text-foreground\",\n            ].join(\" \")}\n          >\n            <span className=\"select-none text-right text-muted-foreground\">\n              {isFocal ? \">\" : \"\"}\n              {known ? lineNumber : \"\"}\n            </span>\n            <code className=\"whitespace-pre\">\n              {source ? <HighlightedTokens tokens={tokens?.[i]} content={source} /> : \" \"}\n            </code>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n"],"names":["useMemo","useState","useEffect","highlightToLines","jsx","jsxs","HighlightedTokens"],"mappings":";;;;;;AAiBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA,YAAY;AACd,GAUG;AACD,QAAM,QAAQA,MAAAA,QAAQ,MAAM,MAAM,eAAe,IAAI,CAAC,MAAM,WAAW,CAAC;AACxE,QAAM,QAAQ,MAAM,mBAAmB;AACvC,QAAM,UAAU,MAAM;AACtB,QAAM,QAAQ,MAAM,QAAQ;AAK5B,QAAM,WAAW,MAAM;AAEvB,QAAM,CAAC,QAAQ,SAAS,IAAIC,MAAAA,SAAmC,IAAI;AAEnEC,QAAAA,UAAU,MAAM;AACd,QAAI,MAAM,WAAW,GAAG;AACtB,gBAAU,IAAI;AACd;AAAA,IACF;AACA,QAAI,YAAY;AAChBC,kBAAAA,iBAAiB,MAAM,KAAK,IAAI,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,CAAC,QAAQ;AACnE,UAAI,CAAC,UAAW,WAAU,GAAG;AAAA,IAC/B,CAAC;AACD,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,OAAO,QAAQ,CAAC;AAEpB,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,QAAM,iBACJ,cAAc,YACV,gDACA;AAEN,SACEC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MAAA,EAEC,OAAO,OAAO,EACd,KAAK,GAAG;AAAA,MAEV,UAAA,MAAM,IAAI,CAAC,QAAQ,MAAM;AACxB,cAAM,cAAa,mCAAU,OAAM,QAAQ;AAC3C,cAAM,QAAQ,YAAY,UAAa,aAAa;AACpD,cAAM,UAAU,SAAS,eAAe;AACxC,eACEC,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAW;AAAA,cACT;AAAA,cACA,UAAU,iBAAiB;AAAA,YAAA,EAC3B,KAAK,GAAG;AAAA,YAEV,UAAA;AAAA,cAAAA,2BAAAA,KAAC,QAAA,EAAK,WAAU,gDACb,UAAA;AAAA,gBAAA,UAAU,MAAM;AAAA,gBAChB,QAAQ,aAAa;AAAA,cAAA,GACxB;AAAA,cACAD,2BAAAA,IAAC,QAAA,EAAK,WAAU,kBACb,mBAASA,+BAACE,kBAAAA,mBAAA,EAAkB,QAAQ,iCAAS,IAAI,SAAS,OAAA,CAAQ,IAAK,IAAA,CAC1E;AAAA,YAAA;AAAA,UAAA;AAAA,UAZK,GAAG,UAAU,IAAI,CAAC;AAAA,QAAA;AAAA,MAe7B,CAAC;AAAA,IAAA;AAAA,EAAA;AAGP;;"}

package/dist/data/diagnostics/FrameSourceWindow.d.ts

@@ -1,6 +1,13 @@
 import { FrameSource } from './FrameSourceWindow.utils';
-export declare function FrameSourceWindow({ frame, className, }: {
+export declare function FrameSourceWindow({ frame, className, focalTone, }: {
     frame: FrameSource;
     className?: string;
+    /**
+     * Styling for the focal line. `"error"` (the default, so existing callers
+     * render unchanged) is the red highlight meaning "this line failed".
+     * `"neutral"` marks "the line that made this call" — a subtle theme-token
+     * highlight with no red.
+     */
+    focalTone?: "error" | "neutral";
 }): import("react").JSX.Element | null;
 //# sourceMappingURL=FrameSourceWindow.d.ts.map

package/dist/data/diagnostics/FrameSourceWindow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrameSourceWindow.d.ts","sourceRoot":"","sources":["../../../src/data/diagnostics/FrameSourceWindow.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAc7D,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,SAAS,GACV,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,sCA6DA"}
+{"version":3,"file":"FrameSourceWindow.d.ts","sourceRoot":"","sources":["../../../src/data/diagnostics/FrameSourceWindow.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAc7D,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,SAAS,EACT,SAAmB,GACpB,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,sCAmEA"}

package/dist/data/diagnostics/FrameSourceWindow.js

@@ -4,7 +4,8 @@ import { highlightToLines } from "../code-highlight.js";
 import { HighlightedTokens } from "../HighlightedTokens.js";
 function FrameSourceWindow({
   frame,
-  className
+  className,
+  focalTone = "error"
 }) {
   const lines = useMemo(() => frame.sourceLines ?? [], [frame.sourceLines]);
   const start = frame.sourceStartLine ?? 0;
@@ -26,6 +27,7 @@ function FrameSourceWindow({
     };
   }, [lines, language]);
   if (lines.length === 0) return null;
+  const focalClassName = focalTone === "neutral" ? "bg-primary/10 font-semibold text-foreground" : "bg-red-500/10 font-semibold text-red-800 dark:text-red-300";
   return /* @__PURE__ */ jsx(
     "div",
     {
@@ -35,18 +37,19 @@ function FrameSourceWindow({
       ].filter(Boolean).join(" "),
       children: lines.map((source, i) => {
         const lineNumber = (numbers == null ? void 0 : numbers[i]) ?? start + i;
-        const isFocal = lineNumber === focal;
+        const known = numbers === void 0 || lineNumber > 0;
+        const isFocal = known && lineNumber === focal;
         return /* @__PURE__ */ jsxs(
           "div",
           {
             className: [
               "grid min-w-max grid-cols-[3.5rem_minmax(24rem,1fr)] gap-3 px-2",
-              isFocal ? "bg-red-500/10 font-semibold text-red-800 dark:text-red-300" : "text-foreground"
+              isFocal ? focalClassName : "text-foreground"
             ].join(" "),
             children: [
               /* @__PURE__ */ jsxs("span", { className: "select-none text-right text-muted-foreground", children: [
                 isFocal ? ">" : "",
-                lineNumber
+                known ? lineNumber : ""
               ] }),
               /* @__PURE__ */ jsx("code", { className: "whitespace-pre", children: source ? /* @__PURE__ */ jsx(HighlightedTokens, { tokens: tokens == null ? void 0 : tokens[i], content: source }) : " " })
             ]

package/dist/data/diagnostics/FrameSourceWindow.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrameSourceWindow.js","sources":["../../../src/data/diagnostics/FrameSourceWindow.tsx"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport { highlightToLines, type HighlightedLine } from \"../code-highlight\";\nimport { HighlightedTokens } from \"../HighlightedTokens\";\nimport type { FrameSource } from \"./FrameSourceWindow.utils\";\n\n// FrameSourceWindow renders a decompiled / resolved source window beneath a\n// stack frame: a gutter of absolute line numbers with the focal line (the one\n// the frame points at) highlighted. It is the single source-window renderer,\n// shared by the JVM thread-dump frames, the exception stack-trace frames, and\n// frameless callers that have source but no stack (a template error, a single\n// decompiled class).\n//\n// The gutter is painted explicitly rather than by embedding Shiki's own `<pre>`,\n// because `sourceLineNumbers` is frequently NOT a contiguous run: arthas `jad`\n// returns bytecode-keyed line numbers with gaps. A CSS-counter gutter would\n// silently renumber those. Tokenizing via `highlightToLines` keeps the\n// highlighting while letting us own the numbering — the same trade CodeDiff makes.\nexport function FrameSourceWindow({\n  frame,\n  className,\n}: {\n  frame: FrameSource;\n  className?: string;\n}) {\n  const lines = useMemo(() => frame.sourceLines ?? [], [frame.sourceLines]);\n  const start = frame.sourceStartLine ?? 0;\n  const numbers = frame.sourceLineNumbers;\n  const focal = frame.line ?? -1;\n  // No default language: this renderer is shared by JVM frames, exception frames\n  // and frameless callers, so a Go dump or a template error must not be coloured\n  // with Java grammar. `highlightToLines` returns null without a language and\n  // `HighlightedTokens` then paints the plain source.\n  const language = frame.sourceLanguage;\n\n  const [tokens, setTokens] = useState<HighlightedLine[] | null>(null);\n\n  useEffect(() => {\n    if (lines.length === 0) {\n      setTokens(null);\n      return;\n    }\n    let cancelled = false;\n    highlightToLines(lines.join(\"\\n\"), { lang: language }).then((out) => {\n      if (!cancelled) setTokens(out);\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [lines, language]);\n\n  if (lines.length === 0) return null;\n\n  return (\n    <div\n      className={[\n        \"mx-3 mb-2 ml-12 overflow-x-auto rounded border border-border/60 bg-muted/30 py-1 font-mono text-[11px] leading-relaxed\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n    >\n      {lines.map((source, i) => {\n        const lineNumber = numbers?.[i] ?? start + i;\n        const isFocal = lineNumber === focal;\n        return (\n          <div\n            key={`${lineNumber}-${i}`}\n            className={[\n              \"grid min-w-max grid-cols-[3.5rem_minmax(24rem,1fr)] gap-3 px-2\",\n              isFocal ? \"bg-red-500/10 font-semibold text-red-800 dark:text-red-300\" : \"text-foreground\",\n            ].join(\" \")}\n          >\n            <span className=\"select-none text-right text-muted-foreground\">\n              {isFocal ? \">\" : \"\"}\n              {lineNumber}\n            </span>\n            <code className=\"whitespace-pre\">\n              {source ? <HighlightedTokens tokens={tokens?.[i]} content={source} /> : \" \"}\n            </code>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;;AAiBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AACF,GAGG;AACD,QAAM,QAAQ,QAAQ,MAAM,MAAM,eAAe,IAAI,CAAC,MAAM,WAAW,CAAC;AACxE,QAAM,QAAQ,MAAM,mBAAmB;AACvC,QAAM,UAAU,MAAM;AACtB,QAAM,QAAQ,MAAM,QAAQ;AAK5B,QAAM,WAAW,MAAM;AAEvB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAmC,IAAI;AAEnE,YAAU,MAAM;AACd,QAAI,MAAM,WAAW,GAAG;AACtB,gBAAU,IAAI;AACd;AAAA,IACF;AACA,QAAI,YAAY;AAChB,qBAAiB,MAAM,KAAK,IAAI,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,CAAC,QAAQ;AACnE,UAAI,CAAC,UAAW,WAAU,GAAG;AAAA,IAC/B,CAAC;AACD,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,OAAO,QAAQ,CAAC;AAEpB,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MAAA,EAEC,OAAO,OAAO,EACd,KAAK,GAAG;AAAA,MAEV,UAAA,MAAM,IAAI,CAAC,QAAQ,MAAM;AACxB,cAAM,cAAa,mCAAU,OAAM,QAAQ;AAC3C,cAAM,UAAU,eAAe;AAC/B,eACE;AAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAW;AAAA,cACT;AAAA,cACA,UAAU,+DAA+D;AAAA,YAAA,EACzE,KAAK,GAAG;AAAA,YAEV,UAAA;AAAA,cAAA,qBAAC,QAAA,EAAK,WAAU,gDACb,UAAA;AAAA,gBAAA,UAAU,MAAM;AAAA,gBAChB;AAAA,cAAA,GACH;AAAA,cACA,oBAAC,QAAA,EAAK,WAAU,kBACb,mBAAS,oBAAC,mBAAA,EAAkB,QAAQ,iCAAS,IAAI,SAAS,OAAA,CAAQ,IAAK,IAAA,CAC1E;AAAA,YAAA;AAAA,UAAA;AAAA,UAZK,GAAG,UAAU,IAAI,CAAC;AAAA,QAAA;AAAA,MAe7B,CAAC;AAAA,IAAA;AAAA,EAAA;AAGP;"}
+{"version":3,"file":"FrameSourceWindow.js","sources":["../../../src/data/diagnostics/FrameSourceWindow.tsx"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport { highlightToLines, type HighlightedLine } from \"../code-highlight\";\nimport { HighlightedTokens } from \"../HighlightedTokens\";\nimport type { FrameSource } from \"./FrameSourceWindow.utils\";\n\n// FrameSourceWindow renders a decompiled / resolved source window beneath a\n// stack frame: a gutter of absolute line numbers with the focal line (the one\n// the frame points at) highlighted. It is the single source-window renderer,\n// shared by the JVM thread-dump frames, the exception stack-trace frames, and\n// frameless callers that have source but no stack (a template error, a single\n// decompiled class).\n//\n// The gutter is painted explicitly rather than by embedding Shiki's own `<pre>`,\n// because `sourceLineNumbers` is frequently NOT a contiguous run: arthas `jad`\n// returns bytecode-keyed line numbers with gaps. A CSS-counter gutter would\n// silently renumber those. Tokenizing via `highlightToLines` keeps the\n// highlighting while letting us own the numbering — the same trade CodeDiff makes.\nexport function FrameSourceWindow({\n  frame,\n  className,\n  focalTone = \"error\",\n}: {\n  frame: FrameSource;\n  className?: string;\n  /**\n   * Styling for the focal line. `\"error\"` (the default, so existing callers\n   * render unchanged) is the red highlight meaning \"this line failed\".\n   * `\"neutral\"` marks \"the line that made this call\" — a subtle theme-token\n   * highlight with no red.\n   */\n  focalTone?: \"error\" | \"neutral\";\n}) {\n  const lines = useMemo(() => frame.sourceLines ?? [], [frame.sourceLines]);\n  const start = frame.sourceStartLine ?? 0;\n  const numbers = frame.sourceLineNumbers;\n  const focal = frame.line ?? -1;\n  // No default language: this renderer is shared by JVM frames, exception frames\n  // and frameless callers, so a Go dump or a template error must not be coloured\n  // with Java grammar. `highlightToLines` returns null without a language and\n  // `HighlightedTokens` then paints the plain source.\n  const language = frame.sourceLanguage;\n\n  const [tokens, setTokens] = useState<HighlightedLine[] | null>(null);\n\n  useEffect(() => {\n    if (lines.length === 0) {\n      setTokens(null);\n      return;\n    }\n    let cancelled = false;\n    highlightToLines(lines.join(\"\\n\"), { lang: language }).then((out) => {\n      if (!cancelled) setTokens(out);\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [lines, language]);\n\n  if (lines.length === 0) return null;\n\n  const focalClassName =\n    focalTone === \"neutral\"\n      ? \"bg-primary/10 font-semibold text-foreground\"\n      : \"bg-red-500/10 font-semibold text-red-800 dark:text-red-300\";\n\n  return (\n    <div\n      className={[\n        \"mx-3 mb-2 ml-12 overflow-x-auto rounded border border-border/60 bg-muted/30 py-1 font-mono text-[11px] leading-relaxed\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n    >\n      {lines.map((source, i) => {\n        const lineNumber = numbers?.[i] ?? start + i;\n        const known = numbers === undefined || lineNumber > 0;\n        const isFocal = known && lineNumber === focal;\n        return (\n          <div\n            key={`${lineNumber}-${i}`}\n            className={[\n              \"grid min-w-max grid-cols-[3.5rem_minmax(24rem,1fr)] gap-3 px-2\",\n              isFocal ? focalClassName : \"text-foreground\",\n            ].join(\" \")}\n          >\n            <span className=\"select-none text-right text-muted-foreground\">\n              {isFocal ? \">\" : \"\"}\n              {known ? lineNumber : \"\"}\n            </span>\n            <code className=\"whitespace-pre\">\n              {source ? <HighlightedTokens tokens={tokens?.[i]} content={source} /> : \" \"}\n            </code>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;;AAiBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA,YAAY;AACd,GAUG;AACD,QAAM,QAAQ,QAAQ,MAAM,MAAM,eAAe,IAAI,CAAC,MAAM,WAAW,CAAC;AACxE,QAAM,QAAQ,MAAM,mBAAmB;AACvC,QAAM,UAAU,MAAM;AACtB,QAAM,QAAQ,MAAM,QAAQ;AAK5B,QAAM,WAAW,MAAM;AAEvB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAmC,IAAI;AAEnE,YAAU,MAAM;AACd,QAAI,MAAM,WAAW,GAAG;AACtB,gBAAU,IAAI;AACd;AAAA,IACF;AACA,QAAI,YAAY;AAChB,qBAAiB,MAAM,KAAK,IAAI,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,CAAC,QAAQ;AACnE,UAAI,CAAC,UAAW,WAAU,GAAG;AAAA,IAC/B,CAAC;AACD,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,OAAO,QAAQ,CAAC;AAEpB,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,QAAM,iBACJ,cAAc,YACV,gDACA;AAEN,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MAAA,EAEC,OAAO,OAAO,EACd,KAAK,GAAG;AAAA,MAEV,UAAA,MAAM,IAAI,CAAC,QAAQ,MAAM;AACxB,cAAM,cAAa,mCAAU,OAAM,QAAQ;AAC3C,cAAM,QAAQ,YAAY,UAAa,aAAa;AACpD,cAAM,UAAU,SAAS,eAAe;AACxC,eACE;AAAA,UAAC;AAAA,UAAA;AAAA,YAEC,WAAW;AAAA,cACT;AAAA,cACA,UAAU,iBAAiB;AAAA,YAAA,EAC3B,KAAK,GAAG;AAAA,YAEV,UAAA;AAAA,cAAA,qBAAC,QAAA,EAAK,WAAU,gDACb,UAAA;AAAA,gBAAA,UAAU,MAAM;AAAA,gBAChB,QAAQ,aAAa;AAAA,cAAA,GACxB;AAAA,cACA,oBAAC,QAAA,EAAK,WAAU,kBACb,mBAAS,oBAAC,mBAAA,EAAkB,QAAQ,iCAAS,IAAI,SAAS,OAAA,CAAQ,IAAK,IAAA,CAC1E;AAAA,YAAA;AAAA,UAAA;AAAA,UAZK,GAAG,UAAU,IAAI,CAAC;AAAA,QAAA;AAAA,MAe7B,CAAC;AAAA,IAAA;AAAA,EAAA;AAGP;"}

package/dist/data/diagnostics/FrameSourceWindow.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"FrameSourceWindow.utils.cjs","sources":["../../../src/data/diagnostics/FrameSourceWindow.utils.ts"],"sourcesContent":["export interface FrameSource {\n  /** Source lines around the focal line. */\n  sourceLines?: string[];\n  /** Absolute line number for each entry in sourceLines (preferred gutter). */\n  sourceLineNumbers?: number[];\n  /** Line number of sourceLines[0] when sourceLineNumbers is absent. */\n  sourceStartLine?: number;\n  /** The frame's focal line, highlighted when it falls inside the window. */\n  line?: number;\n  /** Highlighter language for the window's contents. Omit when unknown: the\n   *  window then renders plain, un-tokenized source rather than guessing. */\n  sourceLanguage?: string;\n}\n\nexport function frameHasSource(frame: FrameSource): boolean {\n  return !!frame.sourceLines && frame.sourceLines.length > 0;\n}\n"],"names":[],"mappings":";;AAcO,SAAS,eAAe,OAA6B;AAC1D,SAAO,CAAC,CAAC,MAAM,eAAe,MAAM,YAAY,SAAS;AAC3D;;"}
+{"version":3,"file":"FrameSourceWindow.utils.cjs","sources":["../../../src/data/diagnostics/FrameSourceWindow.utils.ts"],"sourcesContent":["export interface FrameSource {\n  /** Source lines around the focal line. */\n  sourceLines?: string[];\n  /** Absolute line number for each entry in sourceLines (preferred gutter). An\n   *  entry of 0 marks a line whose number is unknown — e.g. a decompiled row\n   *  the line table does not map — and leaves its gutter blank. */\n  sourceLineNumbers?: number[];\n  /** Line number of sourceLines[0] when sourceLineNumbers is absent. */\n  sourceStartLine?: number;\n  /** The frame's focal line, highlighted when it falls inside the window. */\n  line?: number;\n  /** Highlighter language for the window's contents. Omit when unknown: the\n   *  window then renders plain, un-tokenized source rather than guessing. */\n  sourceLanguage?: string;\n}\n\nexport function frameHasSource(frame: FrameSource): boolean {\n  return !!frame.sourceLines && frame.sourceLines.length > 0;\n}\n"],"names":[],"mappings":";;AAgBO,SAAS,eAAe,OAA6B;AAC1D,SAAO,CAAC,CAAC,MAAM,eAAe,MAAM,YAAY,SAAS;AAC3D;;"}

package/dist/data/diagnostics/FrameSourceWindow.utils.d.ts

@@ -1,7 +1,9 @@
 export interface FrameSource {
     /** Source lines around the focal line. */
     sourceLines?: string[];
-    /** Absolute line number for each entry in sourceLines (preferred gutter). */
+    /** Absolute line number for each entry in sourceLines (preferred gutter). An
+     *  entry of 0 marks a line whose number is unknown — e.g. a decompiled row
+     *  the line table does not map — and leaves its gutter blank. */
     sourceLineNumbers?: number[];
     /** Line number of sourceLines[0] when sourceLineNumbers is absent. */
     sourceStartLine?: number;

package/dist/data/diagnostics/FrameSourceWindow.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrameSourceWindow.utils.d.ts","sourceRoot":"","sources":["../../../src/data/diagnostics/FrameSourceWindow.utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;+EAC2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE1D"}
+{"version":3,"file":"FrameSourceWindow.utils.d.ts","sourceRoot":"","sources":["../../../src/data/diagnostics/FrameSourceWindow.utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;qEAEiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;+EAC2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE1D"}

package/dist/data/diagnostics/FrameSourceWindow.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrameSourceWindow.utils.js","sources":["../../../src/data/diagnostics/FrameSourceWindow.utils.ts"],"sourcesContent":["export interface FrameSource {\n  /** Source lines around the focal line. */\n  sourceLines?: string[];\n  /** Absolute line number for each entry in sourceLines (preferred gutter). */\n  sourceLineNumbers?: number[];\n  /** Line number of sourceLines[0] when sourceLineNumbers is absent. */\n  sourceStartLine?: number;\n  /** The frame's focal line, highlighted when it falls inside the window. */\n  line?: number;\n  /** Highlighter language for the window's contents. Omit when unknown: the\n   *  window then renders plain, un-tokenized source rather than guessing. */\n  sourceLanguage?: string;\n}\n\nexport function frameHasSource(frame: FrameSource): boolean {\n  return !!frame.sourceLines && frame.sourceLines.length > 0;\n}\n"],"names":[],"mappings":"AAcO,SAAS,eAAe,OAA6B;AAC1D,SAAO,CAAC,CAAC,MAAM,eAAe,MAAM,YAAY,SAAS;AAC3D;"}
+{"version":3,"file":"FrameSourceWindow.utils.js","sources":["../../../src/data/diagnostics/FrameSourceWindow.utils.ts"],"sourcesContent":["export interface FrameSource {\n  /** Source lines around the focal line. */\n  sourceLines?: string[];\n  /** Absolute line number for each entry in sourceLines (preferred gutter). An\n   *  entry of 0 marks a line whose number is unknown — e.g. a decompiled row\n   *  the line table does not map — and leaves its gutter blank. */\n  sourceLineNumbers?: number[];\n  /** Line number of sourceLines[0] when sourceLineNumbers is absent. */\n  sourceStartLine?: number;\n  /** The frame's focal line, highlighted when it falls inside the window. */\n  line?: number;\n  /** Highlighter language for the window's contents. Omit when unknown: the\n   *  window then renders plain, un-tokenized source rather than guessing. */\n  sourceLanguage?: string;\n}\n\nexport function frameHasSource(frame: FrameSource): boolean {\n  return !!frame.sourceLines && frame.sourceLines.length > 0;\n}\n"],"names":[],"mappings":"AAgBO,SAAS,eAAe,OAA6B;AAC1D,SAAO,CAAC,CAAC,MAAM,eAAe,MAAM,YAAY,SAAS;AAC3D;"}