@lavalogic/scoria 0.36.0 → 0.37.0

package/dist/Components/Table/Types/Filtering/CustomRemoteFilters.d.ts

@@ -1,3 +1,9 @@
 import type { SvelteMap } from 'svelte/reactivity';
 import type { CustomFilter } from './CustomFilter.js';
+/**
+ * Reactive registry of custom filters keyed by `CustomFilter.id`. Held on
+ * `DefsWrapper.remoteFilters` and consumed by the filter panel. The
+ * `SvelteMap` choice (rather than a plain `Map`) ensures the filter panel
+ * re-renders when filters are added / removed.
+ */
 export type CustomRemoteFilters<FilterValueType> = SvelteMap<string, CustomFilter<FilterValueType>>;

package/dist/Components/Table/Types/Filtering/FilterFn.d.ts

@@ -1,9 +1,37 @@
 import type { Row } from '../Context/Row.js';
+/**
+ * Date column filter value: an inclusive `[from, to]` tuple. Either bound
+ * may be `undefined` to represent an open-ended range (e.g.
+ * `[d, undefined]` is "from `d` onwards").
+ */
 export type DateFilterValueType = [Date | undefined, Date | undefined];
+/**
+ * Number column filter value: an array of `number | string | undefined`.
+ * Strings are accepted because the filter input may forward raw string
+ * values for ranges or `In` / `NotIn` mode lists; the filter function is
+ * expected to coerce them. `undefined` entries represent open ends.
+ */
 export type NumberFilterValueType = Array<number | string | undefined>;
+/**
+ * Select column filter value. Permits string, array, set, or wrapped-object
+ * shapes so the same filter can serve both single-select and multi-select
+ * columns and remote-shaped value objects.
+ */
 export type SelectFilterValueType<T, columnType = T[keyof T]> = string | Array<unknown> | Set<unknown> | {
     value: columnType;
 } | undefined;
+/** Tri-state boolean filter: `true` / `false` / `null` (no filter). */
 export type BoolFilterValueType = boolean | null;
+/** String filter: a string or `null` (no filter). */
 export type StringFilterValueType = string | null;
+/**
+ * Per-column row-matching function. Returns `true` to keep the row in the
+ * filtered set, `false` to drop it. The `in FilterValueType` variance marker
+ * is correct because the function consumes (but does not produce) the filter
+ * value.
+ *
+ * May return a `Promise<boolean>` so the implementation can read from an
+ * async source; `LocalTableDataRepository` awaits the result before applying
+ * pagination.
+ */
 export type FilterFn<T extends object, in FilterValueType> = (row: Row<T>, columnId: string, filterValue: FilterValueType) => boolean | Promise<boolean>;

package/dist/Components/Table/Types/Filtering/FilterMode.d.ts

@@ -1,3 +1,10 @@
 import type { NumberDateFilterMode } from './NumberDateFilterMode.js';
 import type { StringFilterMode } from './StringFilterMode.js';
+/**
+ * Union of all per-column filter operators. The string values are operator
+ * suffixes appended to query parameters when serialising filter state, so
+ * the literal values are part of the on-disk / on-wire contract and must
+ * not be reordered or renamed without a migration. See
+ * `NumberDateFilterMode` and `StringFilterMode` for the canonical lists.
+ */
 export type FilterMode = StringFilterMode | NumberDateFilterMode;

package/dist/Components/Table/Types/Filtering/FilterType.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Discriminator on the active filter pipeline:
+ *
+ * - `Virtual` - filters are applied client-side over the full data set held
+ *   by `LocalTableDataRepository`.
+ * - `Real` - filters are forwarded to the remote repository and applied
+ *   server-side; the client only sees the already-filtered page.
+ */
 export declare const FilterType: {
     readonly Virtual: "Virtual";
     readonly Real: "Real";

package/dist/Components/Table/Types/Filtering/FilterType.js

@@ -1,5 +1,13 @@
+/**
+ * Discriminator on the active filter pipeline:
+ *
+ * - `Virtual` - filters are applied client-side over the full data set held
+ *   by `LocalTableDataRepository`.
+ * - `Real` - filters are forwarded to the remote repository and applied
+ *   server-side; the client only sees the already-filtered page.
+ */
 export const FilterType = {
     Virtual: 'Virtual',
-    Real: 'Real'
+    Real: 'Real',
 };
 Object.freeze(FilterType);

package/dist/Components/Table/Types/Filtering/FilterValueType.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Discriminator on the value-side shape of a column filter. Selects which
+ * `FilterFn` and filter input the table wires up:
+ *
+ * - `String` - `StringFilterValueType`, text input with `StringFilterMode`s.
+ * - `Number` - `NumberFilterValueType`, number input with
+ *   `NumberDateFilterMode`s.
+ * - `Date`   - `DateFilterValueType`, date picker.
+ * - `Bool`   - `BoolFilterValueType`, tri-state switch.
+ * - `Select` - `SelectFilterValueType`, dropdown / multi-select.
+ */
 export declare const FilterValueType: {
     readonly String: "String";
     readonly Number: "Number";

package/dist/Components/Table/Types/Filtering/FilterValueType.js

@@ -1,8 +1,19 @@
+/**
+ * Discriminator on the value-side shape of a column filter. Selects which
+ * `FilterFn` and filter input the table wires up:
+ *
+ * - `String` - `StringFilterValueType`, text input with `StringFilterMode`s.
+ * - `Number` - `NumberFilterValueType`, number input with
+ *   `NumberDateFilterMode`s.
+ * - `Date`   - `DateFilterValueType`, date picker.
+ * - `Bool`   - `BoolFilterValueType`, tri-state switch.
+ * - `Select` - `SelectFilterValueType`, dropdown / multi-select.
+ */
 export const FilterValueType = {
     String: 'String',
     Number: 'Number',
     Date: 'Date',
     Bool: 'Bool',
-    Select: 'Select'
+    Select: 'Select',
 };
 Object.freeze(FilterValueType);

package/dist/Components/Table/Types/Filtering/HasCustomFilterFunction.d.ts

@@ -1,3 +1,24 @@
-export type HasCustomFilterFunction = {
-    filterFn: HasCustomFilterFunction;
+import type { FilterFn } from './FilterFn.js';
+/**
+ * Type predicate companion used by `isSearchable(def)` to narrow a
+ * `ColumnDef` to "has a non-undefined `filterFn`". Used to gate filter UI
+ * surfaces (quick search, advanced filter input) on whether a column can
+ * actually be searched.
+ *
+ * The historical declaration was a self-recursive `{ filterFn:
+ * HasCustomFilterFunction }`, which compiled but reduced to a meaningless
+ * "anything truthy" check. The corrected form requires `filterFn` to be a
+ * `FilterFn`, matching what the predicate body actually asserts:
+ *
+ * ```ts
+ * def.filterFn && typeof def.filterFn === 'function'
+ * ```
+ *
+ * `T` defaults to `object` and `FilterValueType` to `unknown` so existing
+ * call sites that do not parametrise the type continue to compile; concrete
+ * consumers can narrow further once `ColumnDef.filterFn`'s generic chain is
+ * tightened.
+ */
+export type HasCustomFilterFunction<T extends object = object, FilterValueType = unknown> = {
+    filterFn: FilterFn<T, FilterValueType>;
 };

package/dist/Components/Table/Types/Filtering/NumberDateFilterMode.d.ts

@@ -1,12 +1,19 @@
-export declare enum NumberDateFilterMode {
-    Equals = "=",
-    NotEquals = "__notequals=",
-    LessThan = "__lt=",
-    LessThanOrEqual = "__lte=",
-    GreaterThan = "__gt=",
-    GreaterThanOrEqual = "__gte=",
-    Between = "__between=",
-    In = "__in=",
-    NotIn = "__notin=",
-    'null' = "__null="
-}
+/**
+ * Modes available when filtering a numeric or date column. The string values are
+ * the filter operator suffixes appended to query parameters; they MUST be preserved
+ * verbatim because serialised filter presets in localStorage and any in-flight
+ * URL/query encodings depend on them.
+ */
+export declare const NumberDateFilterMode: Readonly<{
+    readonly Equals: "=";
+    readonly NotEquals: "__notequals=";
+    readonly LessThan: "__lt=";
+    readonly LessThanOrEqual: "__lte=";
+    readonly GreaterThan: "__gt=";
+    readonly GreaterThanOrEqual: "__gte=";
+    readonly Between: "__between=";
+    readonly In: "__in=";
+    readonly NotIn: "__notin=";
+    readonly null: "__null=";
+}>;
+export type NumberDateFilterMode = (typeof NumberDateFilterMode)[keyof typeof NumberDateFilterMode];

package/dist/Components/Table/Types/Filtering/NumberDateFilterMode.js

@@ -1,14 +1,18 @@
-export var NumberDateFilterMode;
-(function (NumberDateFilterMode) {
-    NumberDateFilterMode["Equals"] = "=";
-    // Only = '__only=',
-    NumberDateFilterMode["NotEquals"] = "__notequals=";
-    NumberDateFilterMode["LessThan"] = "__lt=";
-    NumberDateFilterMode["LessThanOrEqual"] = "__lte=";
-    NumberDateFilterMode["GreaterThan"] = "__gt=";
-    NumberDateFilterMode["GreaterThanOrEqual"] = "__gte=";
-    NumberDateFilterMode["Between"] = "__between=";
-    NumberDateFilterMode["In"] = "__in=";
-    NumberDateFilterMode["NotIn"] = "__notin=";
-    NumberDateFilterMode["null"] = "__null=";
-})(NumberDateFilterMode || (NumberDateFilterMode = {}));
+/**
+ * Modes available when filtering a numeric or date column. The string values are
+ * the filter operator suffixes appended to query parameters; they MUST be preserved
+ * verbatim because serialised filter presets in localStorage and any in-flight
+ * URL/query encodings depend on them.
+ */
+export const NumberDateFilterMode = Object.freeze({
+    Equals: '=',
+    NotEquals: '__notequals=',
+    LessThan: '__lt=',
+    LessThanOrEqual: '__lte=',
+    GreaterThan: '__gt=',
+    GreaterThanOrEqual: '__gte=',
+    Between: '__between=',
+    In: '__in=',
+    NotIn: '__notin=',
+    null: '__null=',
+});

package/dist/Components/Table/Types/Filtering/StringFilterMode.d.ts

@@ -1,15 +1,22 @@
-export declare enum StringFilterMode {
-    ImplicitEquals = "=",// used by booleans which fall under 'true'/'false' and therefore strings in the current implementation
-    Equals = "__equals=",
-    NotEquals = "__notequals=",
-    Contains = "__contains=",
-    NotContains = "__notcontains=",
-    StartsWith = "__startswith=",
-    NotStartsWith = "__notstartswith=",
-    EndsWith = "__endswith=",
-    NotEndsWith = "__notendswith=",
-    In = "__in=",
-    NotIn = "__notin=",
-    Empty = "__empty=",
-    'null' = "__null="
-}
+/**
+ * Modes available when filtering a string (or boolean coerced to string) column.
+ * The string values are the filter operator suffixes appended to query parameters;
+ * they MUST be preserved verbatim because serialised filter presets in
+ * localStorage and any in-flight URL/query encodings depend on them.
+ */
+export declare const StringFilterMode: Readonly<{
+    readonly ImplicitEquals: "=";
+    readonly Equals: "__equals=";
+    readonly NotEquals: "__notequals=";
+    readonly Contains: "__contains=";
+    readonly NotContains: "__notcontains=";
+    readonly StartsWith: "__startswith=";
+    readonly NotStartsWith: "__notstartswith=";
+    readonly EndsWith: "__endswith=";
+    readonly NotEndsWith: "__notendswith=";
+    readonly In: "__in=";
+    readonly NotIn: "__notin=";
+    readonly Empty: "__empty=";
+    readonly null: "__null=";
+}>;
+export type StringFilterMode = (typeof StringFilterMode)[keyof typeof StringFilterMode];

package/dist/Components/Table/Types/Filtering/StringFilterMode.js

@@ -1,16 +1,22 @@
-export var StringFilterMode;
-(function (StringFilterMode) {
-    StringFilterMode["ImplicitEquals"] = "=";
-    StringFilterMode["Equals"] = "__equals=";
-    StringFilterMode["NotEquals"] = "__notequals=";
-    StringFilterMode["Contains"] = "__contains=";
-    StringFilterMode["NotContains"] = "__notcontains=";
-    StringFilterMode["StartsWith"] = "__startswith=";
-    StringFilterMode["NotStartsWith"] = "__notstartswith=";
-    StringFilterMode["EndsWith"] = "__endswith=";
-    StringFilterMode["NotEndsWith"] = "__notendswith=";
-    StringFilterMode["In"] = "__in=";
-    StringFilterMode["NotIn"] = "__notin=";
-    StringFilterMode["Empty"] = "__empty=";
-    StringFilterMode["null"] = "__null=";
-})(StringFilterMode || (StringFilterMode = {}));
+/**
+ * Modes available when filtering a string (or boolean coerced to string) column.
+ * The string values are the filter operator suffixes appended to query parameters;
+ * they MUST be preserved verbatim because serialised filter presets in
+ * localStorage and any in-flight URL/query encodings depend on them.
+ */
+export const StringFilterMode = Object.freeze({
+    // Used by booleans which fall under 'true'/'false' and therefore strings in the current implementation.
+    ImplicitEquals: '=',
+    Equals: '__equals=',
+    NotEquals: '__notequals=',
+    Contains: '__contains=',
+    NotContains: '__notcontains=',
+    StartsWith: '__startswith=',
+    NotStartsWith: '__notstartswith=',
+    EndsWith: '__endswith=',
+    NotEndsWith: '__notendswith=',
+    In: '__in=',
+    NotIn: '__notin=',
+    Empty: '__empty=',
+    null: '__null=',
+});

package/dist/Components/Table/Types/Focus/MultiFocusEdge.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Edge positions for cells that sit on the boundary of a multi-cell focus
+ * selection. Currently only `ActionsCell.svelte` consumes a single
+ * `MultiFocusEdge | undefined` field; the bulk of `TableFocusDetails` still
+ * exposes per-edge booleans (`topEdge`, `leftEdge`, ...). Either fully
+ * converting `TableFocusDetails` to the enum or deleting this type is
+ * deferred (workorder Types-Focus finding 8).
+ */
 export declare const MultiFocusEdge: {
     readonly TopLeft: "TopLeft";
     readonly Top: "Top";

package/dist/Components/Table/Types/Focus/MultiFocusEdge.js

@@ -1,3 +1,11 @@
+/**
+ * Edge positions for cells that sit on the boundary of a multi-cell focus
+ * selection. Currently only `ActionsCell.svelte` consumes a single
+ * `MultiFocusEdge | undefined` field; the bulk of `TableFocusDetails` still
+ * exposes per-edge booleans (`topEdge`, `leftEdge`, ...). Either fully
+ * converting `TableFocusDetails` to the enum or deleting this type is
+ * deferred (workorder Types-Focus finding 8).
+ */
 export const MultiFocusEdge = {
     TopLeft: 'TopLeft',
     Top: 'Top',
@@ -6,6 +14,6 @@ export const MultiFocusEdge = {
     BottomRight: 'BottomRight',
     Bottom: 'Bottom',
     BottomLeft: 'BottomLeft',
-    Left: 'Left'
+    Left: 'Left',
 };
 Object.freeze(MultiFocusEdge);

package/dist/Components/Table/Types/Focus/TableFocusDetails.svelte.d.ts

@@ -4,6 +4,28 @@ import type { TableCell } from '../Columns/TableCell.js';
 import type { TableContext } from '../Context/TableContext.svelte.js';
 import type { Primitive } from '../Context/TableInitOptions.js';
 import type { CellCoordinates } from '../Coordinates/CellCoordinates.js';
+/**
+ * Per-cell helper that derives "is this cell part of the current focus
+ * group" and the inline `box-shadow:` CSS string that draws the multi-focus
+ * outline. One instance per cell per render is the current pattern; the
+ * caching/flattening rewrite is tracked under the parent workorder
+ * (Types-Focus finding 1 / 2) and is the largest contributor to cell-render
+ * cost.
+ *
+ * Public surface:
+ *
+ * - `coordinates` - the `{ row, column, id }` for this cell.
+ * - `isMultiFocused` / `isMultiFocusStart` - whether this cell is in the
+ *   focus group / the anchor cell.
+ * - `topEdge` / `rightEdge` / `bottomEdge` / `leftEdge` - whether this cell
+ *   sits on each edge of the multi-focus rectangle.
+ * - `validity` - the `Promise<Validity | ValidityWrapper | undefined>` for
+ *   this cell, computed by invoking `columnDef.isValid` (currently
+ *   unwrapped in a try/catch fence; see the security note in the workorder).
+ * - `outline` - the inline `box-shadow: ...;` CSS fragment for the cell;
+ *   safe because the colour comes from the `Colour['$brand-primary']` token
+ *   and not user input.
+ */
 export declare class TableFocusDetails<T extends object, RowIdType extends Primitive> {
     private cell;
     private tableContext;

package/dist/Components/Table/Types/Focus/TableFocusDetails.svelte.js

@@ -1,5 +1,27 @@
 import { Colour } from '../../../../scss/colours.js';
 import { Validity } from '../../../../Types/Internal/Validity.js';
+/**
+ * Per-cell helper that derives "is this cell part of the current focus
+ * group" and the inline `box-shadow:` CSS string that draws the multi-focus
+ * outline. One instance per cell per render is the current pattern; the
+ * caching/flattening rewrite is tracked under the parent workorder
+ * (Types-Focus finding 1 / 2) and is the largest contributor to cell-render
+ * cost.
+ *
+ * Public surface:
+ *
+ * - `coordinates` - the `{ row, column, id }` for this cell.
+ * - `isMultiFocused` / `isMultiFocusStart` - whether this cell is in the
+ *   focus group / the anchor cell.
+ * - `topEdge` / `rightEdge` / `bottomEdge` / `leftEdge` - whether this cell
+ *   sits on each edge of the multi-focus rectangle.
+ * - `validity` - the `Promise<Validity | ValidityWrapper | undefined>` for
+ *   this cell, computed by invoking `columnDef.isValid` (currently
+ *   unwrapped in a try/catch fence; see the security note in the workorder).
+ * - `outline` - the inline `box-shadow: ...;` CSS fragment for the cell;
+ *   safe because the colour comes from the `Colour['$brand-primary']` token
+ *   and not user input.
+ */
 export class TableFocusDetails {
     cell;
     tableContext;

package/dist/Components/Table/Types/Header.d.ts

@@ -1,4 +1,12 @@
 import type { Column } from './Columns/Column.js';
+/**
+ * Header-cell view of one column. Produced by the header machinery and
+ * consumed by `TableHead.svelte`. Holds the underlying `Column` plus
+ * header-only affordances: column-span, header size, and the resize handler.
+ *
+ * Variance markers (`in FilterValueType`, `out FilterOptionsType`) mirror
+ * the inner `Column<T, F, O>` so headers compose with column assignability.
+ */
 export interface Header<T extends object, in FilterValueType, out FilterOptionsType> {
     id: string;
     colSpan: number;

package/dist/Components/Table/Types/HeaderGroup.d.ts

@@ -1,4 +1,11 @@
 import type { Header } from './Header.js';
+/**
+ * One row of headers (left / centre / right group). `headers` is typed with
+ * the conservative placeholder element type `Header<T, never, unknown>`
+ * because the group holds heterogeneous columns whose per-column filter
+ * value type cannot be expressed in the array element type. Tightening to
+ * `Header<T, unknown, unknown>` is deferred (workorder Types-Root finding 1).
+ */
 export interface HeaderGroup<T extends object> {
     id: string;
     headers: Array<Header<T, never, unknown>>;

package/dist/Components/Table/Types/Layout/CellPinning.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/Components/Table/Types/Layout/CellPinning.js

@@ -0,0 +1,8 @@
+// File scheduled for deletion. The CellPinning type was designed for
+// a per-cell pinning prop, but the final div+grid refactor moved the
+// sticky positioning concern onto a wrapper `<div role="cell">` in
+// TableRow / TableHead. Cells no longer need to know about pinning.
+//
+// Kept as an empty module until the next housekeeping pass removes it
+// from the tree. No exports.
+export {};

package/dist/Components/Table/Types/OnChangeFn.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Tanstack-style updater: either the new value directly, or a function from
+ * the old value to the new value. The locally-declared shape (rather than
+ * importing `Updater` from `svelte/store`) is intentional - scoria avoids a
+ * runtime dependency on legacy Svelte stores per project convention.
+ */
 type Updater<T> = T | ((old: T) => T);
+/**
+ * Subscriber-callback signature for state changes on `ITable`. Accepts the
+ * new value or an updater function. Used by `onColumnVisibilityChange`,
+ * `onColumnFiltersChange`, etc. on the table-options surface.
+ */
 export type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void;
 export {};

package/dist/Components/Table/Types/Pagination/PaginationState.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Pagination cursor held by `IDataRepository.paginationState`.
+ *
+ * - `pageIndex` is zero-based (`0` is the first page). The footer / toolbar
+ *   add `1` when displaying it to the user.
+ * - `pageSize` is the number of rows per page. Bare numbers rather than
+ *   branded `PageIndex` / `PageSize`; brand promotion is deferred (workorder
+ *   Types-Root finding 4).
+ */
 export interface PaginationState {
     pageIndex: number;
     pageSize: number;

package/dist/Components/Table/Types/Pagination/PaginationType.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Discriminator on a `IDataRepository`'s pagination mode. Used by
+ * `TableContext` to select code paths and by `TableFooter.svelte` to decide
+ * whether to render the page-count label.
+ *
+ * - `Remote` - server-paged; `lastPage` is authoritative from the backend.
+ * - `Local`  - client-side pagination over the full in-memory data set.
+ * - `None`   - no pagination (currently unused; the footer simply renders
+ *   no page controls in this case).
+ */
 export declare const PaginationType: {
     readonly Remote: "Remote";
     readonly Local: "Local";

package/dist/Components/Table/Types/Pagination/PaginationType.js

@@ -1,6 +1,16 @@
+/**
+ * Discriminator on a `IDataRepository`'s pagination mode. Used by
+ * `TableContext` to select code paths and by `TableFooter.svelte` to decide
+ * whether to render the page-count label.
+ *
+ * - `Remote` - server-paged; `lastPage` is authoritative from the backend.
+ * - `Local`  - client-side pagination over the full in-memory data set.
+ * - `None`   - no pagination (currently unused; the footer simply renders
+ *   no page controls in this case).
+ */
 export const PaginationType = {
     Remote: 'Remote',
     Local: 'Local',
-    None: 'None'
+    None: 'None',
 };
 Object.freeze(PaginationType);

package/dist/Components/Table/Types/Public/AnyEditEvent.d.ts

@@ -0,0 +1,30 @@
+import type { CellCoordinates } from '../Coordinates/CellCoordinates.js';
+/**
+ * Payload passed to the top-level `onAnyEdit` callback (see `CreateTableOptions.onAnyEdit`).
+ *
+ * Fires after every cell edit, regardless of column. Use for change tracking,
+ * batched saves, telemetry, audit logs, or anything else that needs a single
+ * observation point across every editable column.
+ *
+ * `value` is typed `unknown` deliberately. The Table cannot statically know
+ * which column produced the edit (the discriminated mapped-type funnel was
+ * considered and rejected in the proposal because it required `as const`
+ * column arrays, which the FloWMS audit shows are never possible in practice).
+ * Consumers that need a typed value go through per-column `onEdit` instead.
+ *
+ * When both per-column `onEdit` and `onAnyEdit` are configured, the per-column
+ * callback fires first with its typed `value`; `onAnyEdit` runs after the
+ * per-column callback resolves. A per-column callback that throws or rejects
+ * suppresses the corresponding `onAnyEdit`.
+ */
+export interface AnyEditEvent<TRow extends object> {
+    /** The column id whose cell was edited. */
+    readonly column: string;
+    /** The new value. Untyped at this seam by design; use per-column `onEdit`
+     *  for the typed value. */
+    readonly value: unknown;
+    /** The row instance the edit applied to. */
+    readonly row: TRow;
+    /** Full cell coordinates. */
+    readonly coords: CellCoordinates;
+}

package/dist/Components/Table/Types/Public/AnyEditEvent.js

@@ -0,0 +1 @@
+export {};

package/dist/Components/Table/Types/Public/BaseColumnOptions.d.ts

@@ -0,0 +1,44 @@
+import type { Snippet } from 'svelte';
+import type { Pixels } from '../../../../Types/Internal/Misc.js';
+export type { Pixels };
+/**
+ * Options shared by every column kind. Each per-kind option interface
+ * (`TextColumnOptions`, `NumberColumnOptions`, etc.) extends this base.
+ *
+ * Width fields use plain `number` (pixels) at the public surface; the column
+ * factory converts to the internal `Pixels` brand at the boundary so consumers
+ * do not have to import the brand or its constructor. This matches the
+ * "branded primitives stay invisible at the call site" principle in the
+ * proposal (section 3 of `agent-review/proposals/table-api.md`).
+ */
+export interface BaseColumnOptions {
+    /** Column header. Plain string renders as text; a Snippet renders arbitrary
+     *  markup. Only string headers serialise cleanly into saved column presets;
+     *  Snippet headers are stored by id and re-rendered from the live column
+     *  defs on hydration. */
+    header: string | Snippet;
+    /** Minimum width in pixels. Defaults to 48. */
+    minWidth?: number;
+    /** Initial width in pixels. Defaults to `minWidth`. */
+    width?: number;
+    /** Whether this column may be sorted. Defaults to true. */
+    allowSorting?: boolean;
+    /** Whether this column may be filtered. Defaults to true. */
+    allowFiltering?: boolean;
+    /** Whether the column is hidden by default. Still appears in the column
+     *  picker. Defaults to false. */
+    defaultHidden?: boolean;
+    /** Whether the user may resize the column via the resize handle. Defaults
+     *  to true. */
+    resizable?: boolean;
+    /** When true, the cell, header, and filter row log per-render debug info to
+     *  the console. Defaults to false. */
+    debug?: boolean;
+    /** Optional grouping label for this column's filter row in the
+     *  advanced filter panel. Columns sharing the same `filterGroup`
+     *  string render under a single collapsible section with the group
+     *  name as its header. Columns without a `filterGroup` collect into
+     *  a default "Other" group at the bottom of the panel. Has no
+     *  effect on quick-filtering or on the column visibility panel. */
+    filterGroup?: string;
+}

package/dist/Components/Table/Types/Public/BaseColumnOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/Components/Table/Types/Public/ColumnFactory.d.ts

@@ -0,0 +1,35 @@
+import type { Primitive } from '../Context/TableInitOptions.js';
+import type { ActionsColumnOptions, BubbleColumnOptions, CheckboxColumnOptions, DateColumnOptions, DisplayColumnOptions, ExpandColumnOptions, FilterOnlyColumnOptions, NumberColumnOptions, ProgressColumnOptions, QueryColumnOptions, RowSelectionColumnOptions, SelectColumnOptions, TextColumnOptions, ValidityColumnOptions } from './ColumnOptions.js';
+import type { ColumnSpec } from './ColumnSpec.js';
+import type { BooleanKeyOf, DateKeyOf, NumberKeyOf, StringKeyOf } from './KeyConstraints.js';
+/**
+ * Typed builder handed to the `columns:` closure on `createTable(...)`.
+ *
+ * Each method returns a `ColumnSpec<TRow, Kind>`. The accessor kinds
+ * (`text`, `number`, `checkbox`, `date`, `select`, `query`) constrain the
+ * `id` parameter via the matching `<Kind>KeyOf<TRow>` helper from
+ * `KeyConstraints.ts`, so IDE autocomplete only lists fields whose value
+ * type fits the kind. Display kinds and structural kinds do not take an
+ * `id` from the caller; the factory mints a synthetic id via
+ * `syntheticColumnId(...)` internally.
+ *
+ * Inference flows from the `<TRow>` parameter on `createTable(...)`
+ * through every method on this factory. Consumers do not write generics
+ * at any call site.
+ */
+export interface ColumnFactory<TRow extends object> {
+    text<K extends StringKeyOf<TRow>>(options: TextColumnOptions<TRow, K>): ColumnSpec<TRow, 'text'>;
+    number<K extends NumberKeyOf<TRow>>(options: NumberColumnOptions<TRow, K>): ColumnSpec<TRow, 'number'>;
+    checkbox<K extends BooleanKeyOf<TRow>>(options: CheckboxColumnOptions<TRow, K>): ColumnSpec<TRow, 'checkbox'>;
+    date<K extends DateKeyOf<TRow>>(options: DateColumnOptions<TRow, K>): ColumnSpec<TRow, 'date'>;
+    select<K extends keyof TRow & string, TValue = TRow[K]>(options: SelectColumnOptions<TRow, K, TValue>): ColumnSpec<TRow, 'select'>;
+    query<K extends keyof TRow & string, TValue = TRow[K]>(options: QueryColumnOptions<TRow, K, TValue>): ColumnSpec<TRow, 'query'>;
+    display<TValue = unknown>(options: DisplayColumnOptions<TRow, TValue>): ColumnSpec<TRow, 'display'>;
+    bubble<TValue = unknown>(options: BubbleColumnOptions<TRow, TValue>): ColumnSpec<TRow, 'bubble'>;
+    progress(options: ProgressColumnOptions<TRow>): ColumnSpec<TRow, 'progress'>;
+    validity(options?: ValidityColumnOptions<TRow>): ColumnSpec<TRow, 'validity'>;
+    rowSelection(options?: RowSelectionColumnOptions<TRow>): ColumnSpec<TRow, 'rowSelection'>;
+    actions(options: ActionsColumnOptions<TRow>): ColumnSpec<TRow, 'actions'>;
+    expand<TInner extends object, TInnerId extends Primitive = string>(options: ExpandColumnOptions<TRow, TInner, TInnerId>): ColumnSpec<TRow, 'expand'>;
+    filterOnly<K extends keyof TRow & string, TValue = TRow[K]>(options: FilterOnlyColumnOptions<TRow, K, TValue>): ColumnSpec<TRow, 'filterOnly'>;
+}

package/dist/Components/Table/Types/Public/ColumnFactory.js

@@ -0,0 +1 @@
+export {};