@jielga/tmdatagrid 1.0.0 → 1.0.2

package/src/tmdatagrid/core/editEngine.ts

@@ -15,15 +15,15 @@ import type { TMDataGridColumnType } from "./filterOperators";
 import type { TMDataGridSize } from "./sizes";
 
 /**
- * How commits happen — one axis, each mode a thin policy over the same
+ * How commits happen - one axis, each mode a thin policy over the same
  * engine. See `editMode` on `UseTMDataGridOptions`.
  */
 export type TMDataGridEditMode = "cell" | "cellConfirm" | "row" | "batch";
 
 /**
  * One editing row's live form. TanStack Form's `FormApi`, not a wrapper: the
- * engine is a form library, and everything mid-edit — values, dirty state,
- * errors, async validation, submit lifecycle — is form state, read off
+ * engine is a form library, and everything mid-edit - values, dirty state,
+ * errors, async validation, submit lifecycle - is form state, read off
  * `form.store` with the same selector idiom as the rest of the grid.
  *
  * The alias erases Form's validator generics the way `TMDataGridRowData`
@@ -31,20 +31,20 @@ export type TMDataGridEditMode = "cell" | "cellConfirm" | "row" | "batch";
  */
 export type TMDataGridRowEditForm = AnyFormApi;
 
-/** The live field a cell editor binds to — TanStack Form's own `FieldApi`. */
+/** The live field a cell editor binds to - TanStack Form's own `FieldApi`. */
 export type TMDataGridEditField = AnyFieldApi;
 
 /**
  * A validator as TanStack Form takes it: a Standard Schema (Zod, Valibot,
  * ArkType…) or a plain function returning an error or nothing. Forwarded
- * untouched — the vocabulary is Form's, not a grid re-implementation.
+ * untouched - the vocabulary is Form's, not a grid re-implementation.
  */
 export type TMDataGridValidator =
   | StandardSchemaV1<unknown, unknown>
   | ((args: { value: never; fieldApi: never }) => unknown);
 
 /**
- * `meta.validate` — per-column field validators. A bare schema or function is
+ * `meta.validate` - per-column field validators. A bare schema or function is
  * shorthand for `{ onChange: it }`; the object form takes every trigger
  * TanStack Form defines, `Async` variants and debounce included.
  */
@@ -62,7 +62,7 @@ export type TMDataGridFieldValidate =
     };
 
 /**
- * `rowValidators` — form-level validators for the whole row, where
+ * `rowValidators` - form-level validators for the whole row, where
  * cross-field rules live. Passed into each row form's `validators` untouched;
  * pathed issues land on the matching fields, pathless ones on the row.
  */
@@ -82,7 +82,7 @@ export type TMDataGridRowValidators = {
 export type TMDataGridEditChange = {
   /** Column the field maps back to, for consumers thinking in columns. */
   columnId: string;
-  /** The data path — `getEditFieldName` of the column. */
+  /** The data path - `getEditFieldName` of the column. */
   field: string;
   previous: unknown;
   next: unknown;
@@ -90,23 +90,23 @@ export type TMDataGridEditChange = {
 
 export type TMDataGridEditCommitArgs<TData extends RowData> = {
   rowId: string;
-  /** The whole row as edited — for the consumer who saves records. */
+  /** The whole row as edited - for the consumer who saves records. */
   value: TData;
   /** The row as it was when editing began. */
   original: TData;
-  /** Per-field diff — for the consumer who PATCHes. One entry in cell mode. */
+  /** Per-field diff - for the consumer who PATCHes. One entry in cell mode. */
   changes: Array<TMDataGridEditChange>;
   /** Which policy committed. */
   source: TMDataGridEditMode;
 };
 
-/** What one open row's form looks like from outside — the cell markers. */
+/** What one open row's form looks like from outside - the cell markers. */
 export type TMDataGridEditRowProjection = {
   /** Field names whose value differs from the original. */
   dirtyFields: ReadonlyArray<string>;
   /** Field names carrying a validation error. */
   errorFields: ReadonlyArray<string>;
-  /** A row-level error — a pathless `.refine()`, or a rejected commit. */
+  /** A row-level error - a pathless `.refine()`, or a rejected commit. */
   hasRowError: boolean;
   isSubmitting: boolean;
 };
@@ -115,7 +115,7 @@ export type TMDataGridEditRowProjection = {
  * The grid-facing index of everything mid-edit. A projection synced from the
  * open forms' stores, so body cells subscribe to this one store for their
  * dirty/error markers instead of one store per form. Only the editor host
- * reads a form's store directly — it is mounted for one cell at a time.
+ * reads a form's store directly - it is mounted for one cell at a time.
  */
 export type TMDataGridEditState = {
   /** The cell whose editor is open; `columnId: null` is a whole row (row mode). */
@@ -123,9 +123,9 @@ export type TMDataGridEditState = {
   /** Rows with a live form. In cell mode at most one; in batch, many. */
   openRowIds: ReadonlyArray<string>;
   rows: Record<string, TMDataGridEditRowProjection>;
-  /** Phase 4 — rows being created, not yet in `data`. */
+  /** Phase 4 - rows being created, not yet in `data`. */
   newRows: ReadonlyArray<{ tempId: string }>;
-  /** Phase 4 — rows marked deleted under batch mode. */
+  /** Phase 4 - rows marked deleted under batch mode. */
   deletedRowIds: ReadonlyArray<string>;
 };
 
@@ -141,14 +141,14 @@ type ErasedRow = Row<TMDataGridFeatures, TMDataGridRowData>;
 type ErasedColumn = Column<TMDataGridFeatures, TMDataGridRowData, unknown>;
 
 /**
- * What a cell editor is handed — deliberately both vocabularies at once. The
+ * What a cell editor is handed - deliberately both vocabularies at once. The
  * form side is TanStack Form's real `field` API (`field.state.value`,
  * `field.state.meta.errors`, `field.handleChange`, `field.handleBlur`), so a
  * custom calendar, slider or async combobox binds to it exactly as it would
  * inside any TanStack Form. The table side is where the editor is standing.
  *
  * The built-ins are implemented against this same contract, so
- * `meta.editor` is not a special case — it is the slot the defaults
+ * `meta.editor` is not a special case - it is the slot the defaults
  * fill, and the exported built-ins can be wrapped instead of replaced.
  */
 export type TMDataGridEditorArgs = {
@@ -160,9 +160,9 @@ export type TMDataGridEditorArgs = {
   row: ErasedRow;
   column: ErasedColumn;
   table: TMDataGridTable<TMDataGridRowData>;
-  /** What Enter would do — commit the edit. For the editor's own UI. */
+  /** What Enter would do - commit the edit. For the editor's own UI. */
   commit: () => Promise<boolean>;
-  /** What Escape would do — drop the draft. */
+  /** What Escape would do - drop the draft. */
   cancel: () => void;
   size: TMDataGridSize;
   /**
@@ -171,33 +171,33 @@ export type TMDataGridEditorArgs = {
    */
   autoFocus: boolean;
   /**
-   * Set when typing opened the editor (the Sheets gesture) — the built-ins
+   * Set when typing opened the editor (the Sheets gesture) - the built-ins
    * replace the value with it and keep typing. A custom editor may ignore it.
    */
   seedText?: string;
 };
 
 /**
- * `meta.editor` — replaces the built-in editor for this column. Rendered as
+ * `meta.editor` - replaces the built-in editor for this column. Rendered as
  * JSX, never invoked as a bare function, so hooks are legal inside. Define it
  * at module scope: a new identity per render remounts the editor mid-edit.
  */
 export type TMDataGridEditorComponent = ComponentType<TMDataGridEditorArgs>;
 
-/** A new row being committed — `onRowAdd`, and `submitAll`'s `added`. */
+/** A new row being committed - `onRowAdd`, and `submitAll`'s `added`. */
 export type TMDataGridRowAddArgs<TData extends RowData> = {
   /** The engine's placeholder id; the real id is the consumer's to mint. */
   tempId: string;
   value: TData;
 };
 
-/** A deletion — `onRowDelete`. */
+/** A deletion - `onRowDelete`. */
 export type TMDataGridRowDeleteArgs<TData extends RowData> = {
   rowId: string;
   row: Row<TMDataGridFeatures, TData>;
 };
 
-/** What `submitAll` hands `onEditCommitBatch` — everything pending at once. */
+/** What `submitAll` hands `onEditCommitBatch` - everything pending at once. */
 export type TMDataGridEditCommitBatchArgs<TData extends RowData> = {
   /** Every valid dirty existing row. */
   rows: Array<TMDataGridEditCommitArgs<TData>>;
@@ -207,7 +207,7 @@ export type TMDataGridEditCommitBatchArgs<TData extends RowData> = {
   deleted: Array<string>;
 };
 
-/** What the engine reads fresh on every call — see `createEditEngine`. */
+/** What the engine reads fresh on every call - see `createEditEngine`. */
 export type TMDataGridEditEngineContext = {
   table: TMDataGridTable<TMDataGridRowData>;
   editMode: TMDataGridEditMode;
@@ -236,7 +236,7 @@ export type TMDataGridEditEngineContext = {
  * nested rows work for free: `accessorKey: "address.city"` edits
  * `values.address.city`. A column built on `accessorFn` has no path and is
  * not editable unless `meta.editField` names one. TanStack's default column
- * id turns dots into underscores — which is why this starts from
+ * id turns dots into underscores - which is why this starts from
  * `accessorKey`, never from `id`.
  */
 export function getEditFieldName(column: {
@@ -250,7 +250,7 @@ export function getEditFieldName(column: {
   return typeof accessorKey === "string" ? accessorKey : null;
 }
 
-/** What Delete writes into a cell — the type's honest empty value. */
+/** What Delete writes into a cell - the type's honest empty value. */
 export function clearedValueForType(type: TMDataGridColumnType): unknown {
   switch (type) {
     case "string":
@@ -265,14 +265,14 @@ export function clearedValueForType(type: TMDataGridColumnType): unknown {
 }
 
 /**
- * The engine plus its store — `api.edit`.
+ * The engine plus its store - `api.edit`.
  *
  * "One row, one form": `getForm` hands out the same `FormApi` the inline
  * editors write through, so a consumer can render it in a drawer or a detail
  * panel and share values, dirty state and errors with the cells.
  */
 export type TMDataGridEditApi = {
-  /** The projection store — subscribe with `useSelector(edit.store, …)`. */
+  /** The projection store - subscribe with `useSelector(edit.store, …)`. */
   store: Store<TMDataGridEditState>;
   /** Current snapshot, for reads outside React. */
   readonly state: TMDataGridEditState;
@@ -283,12 +283,12 @@ export type TMDataGridEditApi = {
    * switched it off, and the row takes edits at all.
    */
   canEditCell: (row: ErasedRow, column: ErasedColumn) => boolean;
-  /** Whether the row takes edits at all — the edit lane's pencil gate. */
+  /** Whether the row takes edits at all - the edit lane's pencil gate. */
   canEditRow: (row: ErasedRow) => boolean;
   /** Opens an editor. `columnId: null` opens the whole row (row mode). */
   begin: (target: { rowId: string; columnId: string | null }) => void;
   /**
-   * Commits one row — `form.handleSubmit` under the hood. Resolves `true`
+   * Commits one row - `form.handleSubmit` under the hood. Resolves `true`
    * when the form is gone: validation passed and `onEditCommit` resolved, or
    * there was nothing to save. `false` keeps the form open with its errors.
    */
@@ -296,31 +296,31 @@ export type TMDataGridEditApi = {
   /** Drops one row's draft. */
   cancel: (rowId: string) => void;
   /**
-   * Closes the editor without touching the draft — what blur does under
+   * Closes the editor without touching the draft - what blur does under
    * `"cellConfirm"`, where the dirty cell keeps waiting for its ✓.
    */
   deactivate: () => void;
   /** Drops every draft. */
   cancelAll: () => void;
-  /** Commits every open row — batch mode's save. `true` when all landed. */
+  /** Commits every open row - batch mode's save. `true` when all landed. */
   submitAll: () => Promise<boolean>;
-  /** Writes the type's empty value into a cell and commits it — Delete. */
+  /** Writes the type's empty value into a cell and commits it - Delete. */
   clearCell: (rowId: string, columnId: string) => Promise<boolean>;
   /**
    * Opens a new entry row (the sticky block under the header) seeded from
-   * `newRowDefaults`. Returns its temporary id — a form with no backing row
+   * `newRowDefaults`. Returns its temporary id - a form with no backing row
    * yet. Committing it calls `onRowAdd` (immediate modes) or joins
    * `submitAll`'s `added` (batch).
    */
   addRow: () => string;
   /**
    * Deletes a row: `onRowDelete` straight away under the immediate modes;
-   * under batch it toggles the id in `deletedRowIds` — the row renders
+   * under batch it toggles the id in `deletedRowIds` - the row renders
    * struck through until `submitAll` reports it. On an uncommitted entry
    * row it just discards the entry.
    */
   deleteRow: (rowId: string) => void;
-  /** Whether delete chrome makes sense — the lane's trash gate. */
+  /** Whether delete chrome makes sense - the lane's trash gate. */
   canDeleteRows: () => boolean;
 };
 
@@ -366,7 +366,7 @@ function hasAnyError(errors: ReadonlyArray<unknown>): boolean {
  * sees the latest table, mode and consumer callbacks without being rebuilt.
  *
  * Virtualization, per the plan: nothing here is DOM. A form is a plain object
- * in a map keyed by rowId — scroll its row away and the editor unmounts, the
+ * in a map keyed by rowId - scroll its row away and the editor unmounts, the
  * form keeps its values, meta and errors; scroll back and the editor
  * re-mounts over the same form.
  */
@@ -378,11 +378,11 @@ export function createEditEngine(
   type FormEntry = {
     form: TMDataGridRowEditForm;
     original: TMDataGridRowData;
-    /** An entry-block row — a form with no backing row yet. */
+    /** An entry-block row - a form with no backing row yet. */
     isNew: boolean;
     /** Set by the wrapped onSubmit when the consumer's commit resolved. */
     lastSubmitOk: boolean;
-    /** A commit already running — Enter and blur race on the same edit. */
+    /** A commit already running - Enter and blur race on the same edit. */
     pendingCommit: Promise<boolean> | null;
     unsubscribe: () => void;
     unmount: () => void;
@@ -392,7 +392,7 @@ export function createEditEngine(
 
   /**
    * While `submitAll` runs with an `onEditCommitBatch`, each row's wrapped
-   * onSubmit contributes its args here instead of calling `onEditCommit` —
+   * onSubmit contributes its args here instead of calling `onEditCommit` -
    * validation stays per row (Form's), the consumer call becomes one.
    */
   let batchCollector: Array<TMDataGridEditCommitArgs<TMDataGridRowData>> | null =
@@ -432,7 +432,7 @@ export function createEditEngine(
     const errorFields = Object.entries(state.fieldMeta)
       .filter(
         ([name, meta]) =>
-          // The empty path is a pathless (row-level) issue's landing spot —
+          // The empty path is a pathless (row-level) issue's landing spot -
           // it belongs to `hasRowError`, not to any cell's marker.
           name !== "" &&
           hasAnyError((meta as { errors: ReadonlyArray<unknown> }).errors),
@@ -593,7 +593,7 @@ export function createEditEngine(
     // Enter and blur race on the same edit; the second caller joins the
     // first's commit instead of submitting the row twice.
     if (entry.pendingCommit !== null) return entry.pendingCommit;
-    // A pristine form has nothing to say — drop it without a consumer call.
+    // A pristine form has nothing to say - drop it without a consumer call.
     // Not for a new row: adding an untouched entry is still an add.
     if (
       !entry.isNew &&
@@ -641,8 +641,8 @@ export function createEditEngine(
     //
     // | Mode | Another row open |
     // | ---- | ---------------- |
-    // | cell | committed — Sheets; a failed commit keeps holding the edit |
-    // | row  | dropped if pristine, otherwise the pencil is refused — a
+    // | cell | committed - Sheets; a failed commit keeps holding the edit |
+    // | row  | dropped if pristine, otherwise the pencil is refused - a
     //          row edit saves explicitly, so leaving must not save quietly |
     // | cellConfirm, batch | accumulates; every draft waits for its ✓ |
     if (openElsewhere !== undefined) {
@@ -702,7 +702,7 @@ export function createEditEngine(
     }
     const context = getContext();
     if (context.editMode === "batch") {
-      // A toggle: the second press unmarks — the mark is a draft too.
+      // A toggle: the second press unmarks - the mark is a draft too.
       store.setState((prev) => ({
         ...prev,
         deletedRowIds: prev.deletedRowIds.includes(rowId)
@@ -739,7 +739,7 @@ export function createEditEngine(
 
   const submitAll = async (): Promise<boolean> => {
     if (getContext().onEditCommitBatch === undefined) {
-      // The default: the per-row loop — edits through `onEditCommit`, entry
+      // The default: the per-row loop - edits through `onEditCommit`, entry
       // rows through `onRowAdd`, marked deletions through `onRowDelete`.
       const results = await Promise.all(
         [...forms.keys()].map((rowId) => commit(rowId)),
@@ -755,7 +755,7 @@ export function createEditEngine(
 
     // One consumer call for the lot. Validation stays Form's, per row: rows
     // that fail keep their forms and markers; the valid ones travel
-    // together, and only a resolved batch drops them — a rejected save keeps
+    // together, and only a resolved batch drops them - a rejected save keeps
     // every draft, deletions included.
     const collected: Array<TMDataGridEditCommitArgs<TMDataGridRowData>> = [];
     const added: Array<TMDataGridRowAddArgs<TMDataGridRowData>> = [];
@@ -844,7 +844,7 @@ export function createEditEngine(
 
 /**
  * `meta.validate` normalised to the object TanStack Form's `validators`
- * option takes — a bare schema or function is shorthand for `{ onChange }`.
+ * option takes - a bare schema or function is shorthand for `{ onChange }`.
  */
 export function normalizeFieldValidate(
   validate: TMDataGridFieldValidate | undefined,

package/src/tmdatagrid/core/expanding.ts

@@ -6,8 +6,8 @@ import type { TMDataGridFeatures } from "../useTMDataGrid";
  *
  * TanStack keeps one `expanded` state, and the grid opens two unrelated things
  * out of it: a group row opens into its children, a data row opens into its
- * detail panel. So `toggleAllRowsExpanded` — which writes the state's
- * whole-table form — is the wrong verb for either control. "Expand all groups"
+ * detail panel. So `toggleAllRowsExpanded` - which writes the state's
+ * whole-table form - is the wrong verb for either control. "Expand all groups"
  * in the tree menu would open every panel in the grid, and the details lane's
  * chevron would unfold the whole tree.
  *
@@ -25,7 +25,7 @@ function isTarget<TData extends RowData>(
 
 /**
  * The state as a map. `true` is the whole-table form, which has to be written
- * out before one kind of row can be taken back out of it — the same thing
+ * out before one kind of row can be taken back out of it - the same thing
  * TanStack does before toggling a single row.
  */
 function toExpandedMap<TData extends RowData>(
@@ -40,7 +40,7 @@ function toExpandedMap<TData extends RowData>(
 
 export type TMDataGridExpandAllArgs<TData extends RowData> = {
   /**
-   * Every row in the model, groups and records alike — `flatRows` off any of
+   * Every row in the model, groups and records alike - `flatRows` off any of
    * them. A grouped model lists its leaves both under their group and in the
    * flat list, so this may repeat rows; both helpers are written so that a
    * repeat costs nothing.
@@ -51,7 +51,7 @@ export type TMDataGridExpandAllArgs<TData extends RowData> = {
 };
 
 /**
- * Whether every row of this kind is open — what the control shows, and what a
+ * Whether every row of this kind is open - what the control shows, and what a
  * bare toggle inverts.
  *
  * `false` when there are none of them, matching TanStack's own

package/src/tmdatagrid/core/filterControls.ts

@@ -8,13 +8,13 @@ import type { TMDataGridLabels } from "./labels";
 import type { TMDataGridSize } from "./sizes";
 
 /**
- * What a filter control is handed — the value slot of one filter-panel row.
+ * What a filter control is handed - the value slot of one filter-panel row.
  *
  * The contract is value-only: the control reads `operator` to shape itself
  * (a `between` pair renders two ends, an `equals` a single input) and calls
  * `onChange` with the bare value; the grid composes the operator-aware
  * `TMDataGridFilterValue` around it. A control never builds that wrapper and
- * never writes the operator — `table` is the escape hatch for the rare
+ * never writes the operator - `table` is the escape hatch for the rare
  * control that must.
  */
 export type TMDataGridFilterControlArgs = {
@@ -22,13 +22,13 @@ export type TMDataGridFilterControlArgs = {
   table: TMDataGridTable<TMDataGridRowData>;
   /** The row's currently selected operator. Read-only for the control. */
   operator: TMDataGridFilterOperator;
-  /** The bare filter value — never the `{ operator, value }` wrapper. */
+  /** The bare filter value - never the `{ operator, value }` wrapper. */
   value: string | ReadonlyArray<string>;
   /** Writes the bare value; the grid pairs it with the current operator. */
   onChange: (next: string | ReadonlyArray<string>) => void;
   /**
    * The column's options through `resolveColumnOptions`, pre-resolved for a
-   * column that declares `meta.options` or is select-shaped. Empty otherwise —
+   * column that declares `meta.options` or is select-shaped. Empty otherwise -
    * a control wanting faceted values on other columns resolves them itself.
    */
   options: ReadonlyArray<TMDataGridOption>;
@@ -37,7 +37,7 @@ export type TMDataGridFilterControlArgs = {
 };
 
 /**
- * `meta.filterControl` — replaces the built-in value control for this column.
+ * `meta.filterControl` - replaces the built-in value control for this column.
  * Rendered as JSX, never invoked as a bare function, so hooks are legal
  * inside. Define it at module scope so its identity is stable across renders.
  */

package/src/tmdatagrid/core/filterOperators.ts

@@ -5,12 +5,12 @@ import type { Row, RowData, TableFeatures } from "@tanstack/react-table";
  *
  * TanStack resolves `filterFn` statically per column, so the operator travels
  * inside the filter *value* instead. That keeps the whole filter model plain,
- * serialisable JSON — which is what makes it portable to a server-side
+ * serialisable JSON - which is what makes it portable to a server-side
  * `manualFiltering` table (just forward `columnFilters` to the API).
  *
  * `value` is a string array under `isAnyOf` / `isNoneOf` (the set the cell is
  * tested against), a `[min, max]` pair under `between` (an empty string means
- * that end is open), and a single string everywhere else — dates travel as
+ * that end is open), and a single string everywhere else - dates travel as
  * ISO `YYYY-MM-DD` strings, booleans as `"true"` / `"false"`. Still plain
  * JSON.
  */
@@ -176,21 +176,21 @@ export function operatorNeedsValue(operator: TMDataGridFilterOperator): boolean
   return !VALUELESS_OPERATORS.includes(operator);
 }
 
-/** Whether the operator's value is a string array — `isAnyOf` / `isNoneOf`. */
+/** Whether the operator's value is a string array - `isAnyOf` / `isNoneOf`. */
 export function operatorTakesArrayValue(
   operator: TMDataGridFilterOperator,
 ): boolean {
   return ARRAY_OPERATORS.includes(operator);
 }
 
-/** Whether the operator's value is a `[min, max]` pair — `between`. */
+/** Whether the operator's value is a `[min, max]` pair - `between`. */
 export function operatorTakesRangeValue(
   operator: TMDataGridFilterOperator,
 ): boolean {
   return RANGE_OPERATORS.includes(operator);
 }
 
-/** The untouched value a fresh filter starts with — the operator's shape, empty. */
+/** The untouched value a fresh filter starts with - the operator's shape, empty. */
 export function emptyValueForOperator(
   operator: TMDataGridFilterOperator,
 ): string | ReadonlyArray<string> {
@@ -228,8 +228,8 @@ export function isFilterActive(value: unknown): boolean {
 /**
  * One-line description of a single filter, as shown on a filter pill.
  *
- * The type's default operator is left implicit — "First name: Sofia" reads the
- * way a person would say it — while any other operator is spelled out, since
+ * The type's default operator is left implicit - "First name: Sofia" reads the
+ * way a person would say it - while any other operator is spelled out, since
  * that is the part a reader cannot guess.
  */
 export function formatFilterLabel({
@@ -241,7 +241,7 @@ export function formatFilterLabel({
   label: string;
   type: TMDataGridColumnType;
   filter: TMDataGridFilterValue;
-  /** Localized operator names — `labels.operators`. Defaults to English. */
+  /** Localized operator names - `labels.operators`. Defaults to English. */
   operatorLabels?: Record<TMDataGridFilterOperator, string>;
 }): string {
   const { operator, value } = filter;
@@ -260,8 +260,8 @@ export function formatFilterLabel({
 
 /**
  * A value's calendar day as `YYYY-MM-DD`, or `null` for anything that has no
- * day to speak of. A `Date` is read in local time — `sv-SE` formats as ISO,
- * which is the shape `<input type="date">` produced on the other side — and a
+ * day to speak of. A `Date` is read in local time - `sv-SE` formats as ISO,
+ * which is the shape `<input type="date">` produced on the other side - and a
  * string contributes its leading ISO day, so both `2026-07-31` and a full
  * timestamp compare by day.
  */
@@ -317,8 +317,8 @@ export function matchesFilter(
   if (operator === "isEmpty") return isEmptyCell(cellValue);
   if (operator === "isNotEmpty") return !isEmptyCell(cellValue);
 
-  // Set membership. The cell side is also a list — a multiSelect cell holds an
-  // array — so "any of" is an intersection test and "none of" its complement.
+  // Set membership. The cell side is also a list - a multiSelect cell holds an
+  // array - so "any of" is an intersection test and "none of" its complement.
   if (operator === "isAnyOf" || operator === "isNoneOf") {
     const set = (Array.isArray(value) ? value : [value])
       .map((entry) => String(entry).toLowerCase())
@@ -332,7 +332,7 @@ export function matchesFilter(
   }
 
   // A closed or half-open interval. Each present end must hold; an empty end
-  // is open — and a fully empty pair matches everything, the same way a blank
+  // is open - and a fully empty pair matches everything, the same way a blank
   // needle does. Ends compare the way the single-ended operators would:
   // numerically when both sides are numbers, by calendar day otherwise.
   if (operator === "between") {
@@ -349,7 +349,7 @@ export function matchesFilter(
   if (filterText === "") return true;
 
   // Day ordering. ISO days compare correctly as strings, which keeps this
-  // free of timezone arithmetic — the whole comparison lives in local days.
+  // free of timezone arithmetic - the whole comparison lives in local days.
   switch (operator) {
     case "before":
     case "after":

package/src/tmdatagrid/core/labels.ts

@@ -4,7 +4,7 @@ import {
 } from "./filterOperators";
 
 /**
- * Every user-facing string in the grid — menu items, panels, tooltips, the
+ * Every user-facing string in the grid - menu items, panels, tooltips, the
  * pager, and the `aria-label`s a screen reader speaks. One flat object, so an
  * override is a spread rather than a deep merge; `operators` is the single
  * nested record and {@link mergeLabels} folds it separately.
@@ -17,9 +17,9 @@ export type TMDataGridLabels = {
   operators: Record<TMDataGridFilterOperator, string>;
 
   // Toolbar
-  /** "Manage columns" — the burger button and the header menu item. */
+  /** "Manage columns" - the burger button and the header menu item. */
   manageColumns: string;
-  /** "Filters" — the funnel button and the filter panel's title. */
+  /** "Filters" - the funnel button and the filter panel's title. */
   filters: string;
   searchPlaceholder: string;
   searchLabel: string;
@@ -35,7 +35,7 @@ export type TMDataGridLabels = {
   /** Menu/panel name of the generated row-number gutter. */
   rowNumberColumnLabel: string;
   /**
-   * The truly-empty message — no data and no filters. Filtered-empty says
+   * The truly-empty message - no data and no filters. Filtered-empty says
    * {@link noResults} instead; only one of the two is the user's own doing.
    */
   noRows: string;
@@ -51,7 +51,7 @@ export type TMDataGridLabels = {
   filterTo: string;
   /** `DgTriStateFilter`'s no-filter segment. */
   filterAll: string;
-  /** What a boolean column's `true` reads as — its filter choice and cell text. */
+  /** What a boolean column's `true` reads as - its filter choice and cell text. */
   booleanTrue: string;
   booleanFalse: string;
   addFilter: string;
@@ -115,9 +115,9 @@ export type TMDataGridLabels = {
   saveAllEdits: (rows: number) => string;
   /** `EditActions`' Discard. */
   discardAllEdits: string;
-  /** The entry row's ✓ — commit the add. */
+  /** The entry row's ✓ - commit the add. */
   confirmNewRow: string;
-  /** The entry row's ✕ — drop the entry. */
+  /** The entry row's ✕ - drop the entry. */
   discardNewRow: string;
   /** The lane's trash can. */
   deleteRow: string;
@@ -152,7 +152,7 @@ export type TMDataGridLabels = {
 
 /**
  * What the `labels` option accepts: any subset, merged over the English
- * defaults — so `{ noResults: "Inga rader" }` is a complete configuration.
+ * defaults - so `{ noResults: "Inga rader" }` is a complete configuration.
  */
 export type TMDataGridLabelsOverride = Partial<
   Omit<TMDataGridLabels, "operators">

package/src/tmdatagrid/core/matchHighlight.ts

@@ -9,7 +9,7 @@ import type { TMDataGridTable } from "../useTMDataGrid";
 export type TMDataGridMatchRange = { start: number; end: number };
 
 /**
- * The operators whose match is a contiguous substring — the ones highlighting
+ * The operators whose match is a contiguous substring - the ones highlighting
  * can point at. Equality highlights nothing: marking the whole cell says
  * nothing the filter did not already say.
  */
@@ -20,14 +20,14 @@ const HIGHLIGHTABLE_OPERATORS: ReadonlyArray<TMDataGridFilterOperator> = [
 ];
 
 /**
- * Every needle that could highlight in a given column, keyed by column id —
+ * Every needle that could highlight in a given column, keyed by column id -
  * the quick search for the columns it searches, plus any contains-family
  * column filter. `null` while nothing highlightable is active, which is the
  * common case and the cheap one.
  *
  * The fuzzy quick search still contributes its raw text: when the needle
  * occurs contiguously it is highlighted, and a typo-match simply shows no
- * highlight — the honest answer to what a non-contiguous match "is".
+ * highlight - the honest answer to what a non-contiguous match "is".
  */
 export function buildMatchNeedles<TData extends RowData>(
   table: TMDataGridTable<TData>,
@@ -62,7 +62,7 @@ export function buildMatchNeedles<TData extends RowData>(
 
 /**
  * Where the needles occur in the text, case-insensitively, merged where they
- * overlap or touch — so two needles covering "St" and "tock" come back as one
+ * overlap or touch - so two needles covering "St" and "tock" come back as one
  * range rather than nested marks. `null` when nothing matches.
  */
 export function findMatchRanges(