@servicetitan/anvil2 3.15.0 → 3.15.1

package/dist/src/beta/components/Table/createColumnHelper.d.ts

@@ -1,101 +1,59 @@
 import { ReactNode } from 'react';
 import { ColumnDef, ColumnOverflowConfig, ColumnTypeConfig, TextEditConfig, NumberEditConfig, SelectEditConfig, SelectAsyncEditConfig, MultiselectEditConfig, MultiselectAsyncEditConfig, BooleanEditConfig, CustomEditConfig, TableRow, ColumnHeaderConfig, ColumnReadRenderContext, ColumnReadRenderResult } from './types';
 import { MultiSelectMenuOption } from '../../../components/MultiSelectMenu';
-/**
- * Base column configuration shared by all column types
- */
 type BaseColumnConfig<T> = ColumnHeaderConfig & {
-    /**
-     * The cleaned-up header configuration.
-     */
     header?: ColumnDef<T>["header"];
     /**
-     * The label of the header.
+     * Deprecated string label used when `header` is omitted.
      * @deprecated Use `header.label` instead.
      */
     headerLabel?: string;
     /**
-     * The alignment of the header.
-     * When using `type`, this is set automatically but can be overridden.
+     * On leaf columns, overrides the alignment inferred from `type`. Group
+     * headers stay start-aligned.
      */
     align?: "start" | "center" | "end";
     /**
-     * Custom content to display when a cell value is empty (null, undefined, or empty string).
-     * Overrides the default em dash. When set on both the column and the DataTable,
-     * the column-level value takes precedence.
+     * Replaces the table's empty-cell content for this column. Applies to `null`,
+     * `undefined`, and empty strings.
      */
     emptyCellContent?: ReactNode;
-    /**
-     * The content of the footer cell. An array will display multiple footer rows
-     */
+    /** One footer value, or one value per footer row. */
     footerContent?: ReactNode | ReactNode[];
-    /**
-     * The maximum width of the column, in pixels. Caps automatic growth when
-     * the table has extra horizontal space available.
-     */
+    /** Same sizing contract as {@link ColumnBaseDef} `maxWidth`. */
     maxWidth?: number;
-    /**
-     * The minimum width of the column, in pixels. Used as the floor for manual
-     * resize — users can drag a column down to but not below this value. Also
-     * serves as the fallback auto-sizing floor when `defaultWidth` is not set.
-     */
+    /** Same sizing contract as {@link ColumnBaseDef} `minWidth`. */
     minWidth?: number;
-    /**
-     * The preferred starting width of the column, in pixels. Used as the basis
-     * for automatic growing/shrinking: the column renders at this width by
-     * default, grows toward `maxWidth` when the table has spare horizontal
-     * space, and never auto-shrinks below it — the table scrolls horizontally
-     * instead.
-     *
-     * Manual resize via the column's resize handle is still bounded by
-     * `minWidth`/`maxWidth`, so users can drag a column below `defaultWidth`
-     * down to `minWidth`.
-     *
-     * Falls back to `minWidth` when not specified.
-     */
+    /** Same sizing contract as {@link ColumnBaseDef} `defaultWidth`. */
     defaultWidth?: number;
-    /**
-     * The pinning location of the column
-     */
+    /** Keeps the column against the chosen edge while horizontally scrolling. */
     pinned?: "left" | "right";
-    /**
-     * Whether the column is resizable
-     */
+    /** Shows a pointer-driven resize handle. */
     resizable?: boolean;
 };
 type BaseDataColumnConfig<T, K extends keyof T> = BaseColumnConfig<T> & {
     /**
-     * The function to customize how the cell content is rendered.
-     * When using `type`, a default renderer is provided but can be overridden.
+     * Overrides the renderer inferred from `type`.
      */
     renderCell?: (value: T[K], context: ColumnReadRenderContext<TableRow<T>>) => ReactNode;
-    /**
-     * Optional plain-text extractor for the read path.
-     * Useful when `renderCell` returns JSX or multiline content but default sorting
-     * should still use a simple string.
-     */
+    /** Supplies sortable text when `renderCell` returns rich content. */
     getCellText?: (value: T[K], context: ColumnReadRenderContext<TableRow<T>>) => string;
     /**
-     * Optional advanced read-display extractor.
-     * Prefer `getCellText` for the common case where `renderCell` already handles
-     * display and sorting only needs a simple string. Use this when you want one
-     * hook to return both rendered read content and the sortable raw string.
+     * Supplies rendered content and sortable text together. When set, it wins
+     * over `renderCell` and `getCellText`. Prefer `getCellText` when only
+     * sorting needs an alternate representation.
      */
     getReadRenderResult?: (value: T[K], context: ColumnReadRenderContext<TableRow<T>>) => ColumnReadRenderResult;
-    /**
-     * Whether the column is sortable, or a function to customize the sorting logic
-     */
+    /** Enables default sorting, or supplies a value comparator. */
     sortable?: boolean | ((valueA: T[K], valueB: T[K]) => number);
     /**
-     * The column type for automatic display configuration.
-     * Sets default `renderCell` (formatter) and `align` based on the data type.
+     * Supplies default formatting and alignment; explicit column options override
+     * those defaults.
      */
     type?: ColumnTypeConfig;
 };
 type GroupColumnConfig<T> = BaseColumnConfig<T> & {
-    /**
-     * Columns of a group column (for grouped columns)
-     */
+    /** Leaf or nested columns displayed beneath this group header. */
     columns: ColumnDef<T>[];
     editConfig?: never;
     overflow?: never;
@@ -103,139 +61,66 @@ type GroupColumnConfig<T> = BaseColumnConfig<T> & {
     sortable?: never;
     type?: never;
 };
-/**
- * Configuration for read-only columns (no editing)
- */
 type ReadOnlyColumnConfig<T, K extends keyof T> = BaseDataColumnConfig<T, K> & {
     editConfig?: undefined;
+    /** Shows clipped read-only content in a disclosure Surface. */
     overflow?: ColumnOverflowConfig;
 };
 type EditableColumnConfig<T, K extends keyof T> = BaseDataColumnConfig<T, K> & {
     overflow?: never;
 };
-/**
- * Configuration for text editable columns using editConfig.
- * Valid when T[K] is a string.
- */
+/** Allows text editing only when the column value is string-compatible. */
 type TextEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends string ? EditableColumnConfig<T, K> & {
     editConfig: TextEditConfig<T, K>;
 } : never;
-/**
- * Configuration for number editable columns using editConfig.
- * Valid when T[K] is a number type.
- */
+/** Allows number editing only when the column value is number-compatible. */
 type NumberEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends number ? EditableColumnConfig<T, K> & {
     editConfig: NumberEditConfig<T, K>;
 } : never;
-/**
- * Configuration for select editable columns using editConfig
- */
 type SelectEditConfigColumnConfig<T, K extends keyof T> = EditableColumnConfig<T, K> & {
     editConfig: SelectEditConfig<T, K>;
 };
-/**
- * Configuration for async select editable columns using editConfig
- */
 type SelectAsyncEditConfigColumnConfig<T, K extends keyof T> = EditableColumnConfig<T, K> & {
     editConfig: SelectAsyncEditConfig<T>;
 };
 type CellArrayItem = object | string | number | boolean | bigint | symbol | null | undefined;
 type CellArrayValue = readonly CellArrayItem[];
-/**
- * Configuration for multiselect editable columns using editConfig
- * Only valid when T[K] is an array type
- */
+/** Allows multiselect editing only when the column value is an array. */
 type MultiselectEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends CellArrayValue ? EditableColumnConfig<T, K> & {
     editConfig: MultiselectEditConfig<T, K>;
 } : never;
 /**
- * Configuration for async multiselect editable columns using editConfig.
- * Only valid when T[K] is MultiSelectMenuOption[] — full option objects,
- * not a plain primitive array like string[].
+ * Allows async multiselect editing only for full option-object arrays, not
+ * primitive arrays.
  */
 type MultiselectAsyncEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends MultiSelectMenuOption[] ? EditableColumnConfig<T, K> & {
     editConfig: MultiselectAsyncEditConfig<T>;
 } : never;
-/**
- * Configuration for boolean editable columns using editConfig.
- * Valid when T[K] is a boolean type.
- */
+/** Allows boolean editing only when the column value is boolean-compatible. */
 type BooleanEditConfigColumnConfig<T, K extends keyof T> = NonNullable<T[K]> extends boolean ? EditableColumnConfig<T, K> & {
     editConfig: BooleanEditConfig<T, K>;
 } : never;
 type CustomEditConfigColumnConfig<T, K extends keyof T> = EditableColumnConfig<T, K> & {
     editConfig: CustomEditConfig<T, K>;
 };
-/**
- * Full column configuration type - union of all possible configurations.
- * TypeScript will enforce that the editConfig matches the value type constraints.
- */
+/** Couples each edit mode to the column value types it supports. */
 type ColumnConfig<T, K extends keyof T> = ReadOnlyColumnConfig<T, K> | TextEditConfigColumnConfig<T, K> | NumberEditConfigColumnConfig<T, K> | SelectEditConfigColumnConfig<T, K> | SelectAsyncEditConfigColumnConfig<T, K> | MultiselectEditConfigColumnConfig<T, K> | MultiselectAsyncEditConfigColumnConfig<T, K> | BooleanEditConfigColumnConfig<T, K> | CustomEditConfigColumnConfig<T, K>;
 /**
- * Factory function to create column helper function for defining Table columns.
- *
- * This helper provides type safety by enforcing that:
- * - `type` sets display defaults (formatter and alignment) for the column
- * - `editConfig` enables cell editing with proper type constraints
- * - `editConfig.mode: "text"` can only be used with string columns
- * - `editConfig.mode: "boolean"` can only be used with boolean columns
- * - `editConfig.mode: "number"` can only be used with number columns
- * - `editConfig.mode: "multiselect"` can only be used with array columns
- * - `editConfig.mode: "select"` options values must match the column's value type
- * - `editConfig.mode: "custom"` can only be used with structured object columns;
- *   drafts may be partial objects, plus null/undefined when declared by the row type
- * - non-custom `editConfig.onChange` callbacks receive the correct value type;
- *   custom mode uses `onCommit` and `onDraftUpdate`
- * - `getCellText` provides a simple sortable read string when `renderCell` returns rich content
- *
- * @template T - The type of the row data
- * @returns A function that creates type-safe column definitions
+ * Creates column definitions keyed to row type `T`. The returned overloads
+ * constrain edit modes by value type and accept `{ group: string }` for grouped
+ * columns.
  *
  * @example
  * ```ts
- * type Data = { name: string; amount: number; tags: string[] };
- * const createColumn = createColumnHelper<Data>();
- *
- * // Display-only column with type defaults
- * createColumn("amount", { header: { label: "Amount" }, type: "currency" });
- *
- * // Editable column with editConfig
- * createColumn("name", {
- *   header: { label: "Name" },
- *   type: "text",
- *   editConfig: { mode: "text", onChange: (value, rowId) => save(value, rowId) }
- * });
- *
- * // Number editing
- * createColumn("amount", {
+ * const column = createColumnHelper<{ name: string; amount: number }>();
+ * column("amount", {
  *   header: { label: "Amount" },
- *   editConfig: {
- *     mode: "number",
- *     minValue: 0,
- *     maxValue: 10000,
- *     step: 0.01,
- *     onChange: (value, rowId) => save(value, rowId)
- *   }
+ *   type: "currency",
+ *   editConfig: { mode: "number", onChange: saveAmount },
  * });
- *
- * // Select editing
- * createColumn("status", {
- *   header: { label: "Status" },
- *   editConfig: {
- *     mode: "select",
- *     options: [{ id: "active", label: "Active" }],
- *     onChange: (option, rowId) => save(option?.id, rowId)
- *   }
- * });
- *
- * // Multiselect editing with array column
- * createColumn("tags", {
- *   header: { label: "Tags" },
- *   editConfig: {
- *     mode: "multiselect",
- *     options: [{ id: "urgent", label: "Urgent" }],
- *     onChange: (options, rowId) => save(options.map(o => o.id), rowId)
- *   }
+ * column({ group: "customer" }, {
+ *   header: { label: "Customer" },
+ *   columns: [column("name", { header: { label: "Name" } })],
  * });
  * ```
  */

package/dist/src/beta/components/Table/formatters/booleanFormatter.d.ts

@@ -1,22 +1,11 @@
-/**
- * Options type for the boolean formatter function
- */
 export type BooleanFormatterOptions = {
-    /**
-     * The text to display for true values
-     * @default "True"
-     */
+    /** Label when `value` is `true`. Defaults to `"True"`. */
     trueLabel?: string;
-    /**
-     * The text to display for false values
-     * @default "False"
-     */
+    /** Label when `value` is `false`. Defaults to `"False"`. */
     falseLabel?: string;
 };
 /**
- * Helper function for formatting table cells with boolean values
- * @param value - The boolean value to format
- * @param options - The options for the boolean formatter
- * @returns The formatted boolean label or null for undefined/null values
+ * Formats a boolean for a table cell. `null` and `undefined` return `null`
+ * (empty cell); they do not use either label.
  */
 export declare const booleanFormatter: (value?: boolean | null, { trueLabel, falseLabel }?: BooleanFormatterOptions) => string | null;

package/dist/src/beta/components/Table/formatters/chipsFormatter.d.ts

@@ -1,21 +1,19 @@
 import { ChipProps } from '../../../../components/Chip';
 /**
- * The accepted value type for the chips formatter function
+ * One chip or many. Arrays must be all strings or all {@link ChipProps} — mixed
+ * arrays are treated as `ChipProps[]`.
  */
 export type ChipsValueType = string | string[] | ChipProps | ChipProps[];
-/**
- * Props for the chips formatter function
- */
 export type ChipsFormatterOptions = {
     /**
-     * Whether to truncate the chips instead of wrapping
+     * When `true`, array values overflow into a +N disclosure instead of wrapping.
+     * Ignored for a single chip. Defaults to wrapping.
      */
     truncateChips?: boolean;
 };
 /**
- * Helper function for formatting table cells with chips
- * @param value - The value to format
- * @param options - The options for the chips formatter
- * @returns The formatted chips
+ * Renders chips for a table cell. Falsy values and empty arrays become
+ * {@link TableEmptyCellContent} (`—`). Unspecified `size` is `"small"`, or
+ * `"medium"` when both `onClick` and `onClose` are set.
  */
 export declare const chipsFormatter: (value?: ChipsValueType, { truncateChips }?: ChipsFormatterOptions) => import("react/jsx-runtime").JSX.Element;

package/dist/src/beta/components/Table/formatters/currencyFormatter.d.ts

@@ -1,22 +1,10 @@
-/**
- * Props for the currency formatter function
- */
 export type CurrencyFormatterOptions = {
-    /**
-     * The locale to use for the currency formatter
-     * @default "en-US"
-     */
+    /** `Intl` locale. Defaults to `"en-US"`. */
     locale?: Intl.LocalesArgument;
-    /**
-     * The currency to use for the currency formatter
-     * @default "USD"
-     */
+    /** ISO 4217 currency code. Defaults to `"USD"`. */
     currency?: Intl.NumberFormatOptions["currency"];
 };
 /**
- * Helper function for formatting table cells with currency, including i18n support
- * @param value - The value to format
- * @param options - The options for the currency formatter
- * @returns The formatted currency
+ * Formats a number as currency via `Intl`. Nullish values return `null`.
  */
 export declare const currencyFormatter: (value?: number, options?: CurrencyFormatterOptions) => string | null;

package/dist/src/beta/components/Table/formatters/dateFormatter.d.ts

@@ -1,34 +1,21 @@
 import { DateFormatPreset } from './presets';
 export type { DateFormatPreset };
-/**
- * Options type for the date formatter function
- */
 export type DateFormatterOptions = {
-    /**
-     * The locale to use for the date formatter
-     * @default "en-US"
-     */
+    /** `Intl` locale. Defaults to `"en-US"`. */
     locale?: Intl.LocalesArgument;
     /**
-     * The format preset or Intl.DateTimeFormatOptions object
-     * - "short": 01/15/2024
-     * - "medium": Jan 15, 2024
-     * - "long": January 15, 2024
-     * - "full": Monday, January 15, 2024
-     * - Intl.DateTimeFormatOptions: Custom format (e.g., { weekday: "long", month: "short", day: "numeric" })
-     * @default "short"
+     * Preset name or a custom `Intl.DateTimeFormatOptions` bag. Preset samples
+     * below are `en-US`; other locales differ. Defaults to `"short"`.
+     * - `"short"`: 01/15/2024
+     * - `"medium"`: Jan 15, 2024
+     * - `"long"`: January 15, 2024
+     * - `"full"`: Monday, January 15, 2024
      */
     format?: DateFormatPreset | Intl.DateTimeFormatOptions;
 };
 /**
- * Helper function for formatting table cells with plain dates, including i18n support.
- *
- * Accepts plain date strings in the format "YYYY-MM-DD" (like Temporal.PlainDate).
- * For JavaScript Date objects or date-times with timezone information,
- * use `dateTimeFormatter` instead.
- *
- * @param value - The plain date string to format (ISO format "YYYY-MM-DD")
- * @param options - The options for the date formatter
- * @returns The formatted date string or null for undefined/null values
+ * Formats a calendar date (`YYYY-MM-DD`) without applying a timezone offset.
+ * For `Date` objects or ISO strings with time/zone, use {@link dateTimeFormatter}.
+ * Invalid or missing values return `null`.
  */
 export declare const dateFormatter: (value?: string | null, { locale, format }?: DateFormatterOptions) => string | null;

package/dist/src/beta/components/Table/formatters/dateTimeFormatter.d.ts

@@ -1,66 +1,43 @@
 import { IanaZone } from '../../../../types';
 import { DateFormatPreset, TimeFormatPreset } from './presets';
-/**
- * Date format preset options for dateTimeFormatter
- */
+/** Alias of {@link DateFormatPreset} for the date portion. */
 export type DateTimeFormatDatePreset = DateFormatPreset;
-/**
- * Time format preset options for dateTimeFormatter
- */
+/** {@link TimeFormatPreset} plus `"none"` to omit the time. */
 export type DateTimeFormatTimePreset = TimeFormatPreset | "none";
-/**
- * Options type for the date-time formatter function
- */
 export type DateTimeFormatterOptions = {
-    /**
-     * The locale to use for the date-time formatter
-     * @default "en-US"
-     */
+    /** `Intl` locale. Defaults to `"en-US"`. */
     locale?: Intl.LocalesArgument;
     /**
-     * The format preset for the date portion or Intl.DateTimeFormatOptions object
-     * - "short": 01/15/2024
-     * - "medium": Jan 15, 2024
-     * - "long": January 15, 2024
-     * - "full": Monday, January 15, 2024
-     * - Intl.DateTimeFormatOptions: Custom format (e.g., { weekday: "long", month: "short", day: "numeric" })
-     * @default "short"
+     * Date portion: a {@link DateTimeFormatDatePreset} or a custom
+     * `Intl.DateTimeFormatOptions` bag. Preset samples below are `en-US`.
+     * Defaults to `"short"`.
+     * - `"short"`: 01/15/2024
+     * - `"medium"`: Jan 15, 2024
+     * - `"long"`: January 15, 2024
+     * - `"full"`: Monday, January 15, 2024
      */
     dateFormat?: DateTimeFormatDatePreset | Intl.DateTimeFormatOptions;
     /**
-     * The format preset for the time portion or Intl.DateTimeFormatOptions object
-     * - "short": 08:30 AM
-     * - "medium": 08:30:00 AM
-     * - "none": Omit time from display (useful for Date objects when you only want the date)
-     * - Intl.DateTimeFormatOptions: Custom format (e.g., { hour: "2-digit", minute: "2-digit", hour12: false })
-     * @default "short"
+     * Time portion: a {@link DateTimeFormatTimePreset}, `"none"` (date only), or
+     * a custom `Intl.DateTimeFormatOptions` bag. Preset samples below are `en-US`.
+     * Defaults to `"short"`.
+     * - `"short"`: 08:30 AM
+     * - `"medium"`: 08:30:00 AM
      */
     timeFormat?: DateTimeFormatTimePreset | Intl.DateTimeFormatOptions;
     /**
-     * The IANA timezone to use for displaying Date objects (e.g., "America/New_York", "Europe/London", "UTC").
-     * If not provided, uses the user's local timezone.
-     *
-     * **Note:** This option only applies to `Date` objects. For string inputs, timezone handling is automatic:
-     * - Strings without timezone info (e.g., "2024-01-15T09:30:00") are treated as plain date-times with no conversion
-     * - Strings with timezone info (e.g., "2024-01-15T09:30:00Z" or "2024-01-15T09:30:00-05:00") use their embedded timezone
-     *
-     * @default undefined (local timezone)
+     * IANA zone applied to `Date` values; omitted uses the local zone. ISO strings
+     * ignore this: zoneless strings remain wall times, while strings with `Z` or
+     * an offset are converted to the local zone.
      */
     timeZone?: IanaZone;
 };
 /**
- * Helper function for formatting table cells with date and time, including i18n support.
- *
- * For string inputs:
- * - Strings without timezone info are treated as "plain date-times" (no timezone conversion, no timezone displayed)
- * - Strings with timezone info (Z or offset) honor the provided timezone and display it (e.g., "PST", "UTC")
- *
- * For Date objects:
- * - Uses local timezone by default and displays the timezone
- * - Use the `timeZone` option to specify a different timezone (e.g., "America/New_York", "UTC")
+ * Formats a date-time for a table cell. Invalid or missing values return `null`.
  *
- * @param value - The date-time value to format (ISO string "YYYY-MM-DDTHH:mm:ss" or Date object)
- * @param options - The options for the date-time formatter
- * @returns The formatted date-time string or null for undefined/null values
+ * `Date` values use the local zone (or {@link DateTimeFormatterOptions.timeZone}).
+ * Zoneless ISO strings are wall times with no zone label; strings with `Z` or an
+ * offset are instants converted to the local zone. Zoned values default to a
+ * short zone name, which custom format options can override.
  */
 export declare const dateTimeFormatter: (value?: string | Date | null, { locale, dateFormat, timeFormat, timeZone, }?: DateTimeFormatterOptions) => string | null;

package/dist/src/beta/components/Table/formatters/htmlFormatter.d.ts

@@ -1,15 +1,6 @@
 import { ReactNode } from 'react';
 /**
- * Formats an HTML string value for DataTable cells by converting to markdown
- * and rendering through the markdown formatter.
- *
- * Supported HTML: strong, b, em, i, code, mark, s, strike, del, h1, h2, h3,
- * ul, ol, li, br, p. The u and span tags, along with text-align styling on
- * p/h1-h3, are rendered as plain text (styling ignored, content preserved).
- * Other unsupported tags and their content are dropped entirely.
- * HTML entities are decoded to plain text.
- *
- * @param value - The HTML string to format
- * @returns Formatted React nodes, or null for empty/null/undefined values
+ * DataTable cell HTML via {@link htmlToMarkdown} then {@link markdownFormatter}.
+ * Empty or nullish HTML becomes `null`.
  */
 export declare const htmlFormatter: (value?: string | null) => ReactNode;

package/dist/src/beta/components/Table/formatters/htmlToMarkdown.d.ts

@@ -1,14 +1,9 @@
 /**
- * Converts an HTML string to the markdown subset supported by markdownFormatter.
+ * Converts HTML to the subset {@link markdownFormatter} understands.
  *
- * Supported tags: strong, b, em, i, code, mark, s, strike, del, h1, h2, h3,
- * ul, ol, li, br, p.
- * The u and span tags, along with text-align styling on p/h1-h3, are rendered
- * as plain text: their styling is ignored but their content is preserved.
- * Other unsupported tags and their content are dropped entirely.
- * HTML entities are decoded to plain text.
- *
- * @param value - The HTML string to convert
- * @returns The equivalent markdown string, or empty string for null/undefined/empty input
+ * Kept tags: strong, b, em, i, code, mark, s, strike, del, h1–h3, ul, ol, li,
+ * br, p. `u` and `span` unwrap to plain text (alignment on p/h1–h3 is ignored).
+ * Other tags and their content are dropped. Entities decode to plain text.
+ * Nullish or empty input returns `""`.
  */
 export declare function htmlToMarkdown(value?: string | null): string;

package/dist/src/beta/components/Table/formatters/markdownFormatter.d.ts

@@ -1,12 +1,7 @@
 import { ReactNode } from 'react';
 /**
- * Formats a string value as markdown content for DataTable cells.
- *
- * Supports inline constructs (bold, italic, bold+italic, strikethrough, inline
- * code, highlight) and block-level constructs: headings (`# ` through `### `)
- * and flat lists (unordered with `- `, ordered with `N. `).
- *
- * @param value - The markdown string to format
- * @returns Formatted React nodes, or null for empty/null/undefined values
+ * Renders a markdown subset in a DataTable cell: bold, italic, bold+italic,
+ * strikethrough, inline code, `==highlight==`, `#`–`###` headings, and flat
+ * `- ` / `N. ` lists. Empty or nullish values return `null`.
  */
 export declare const markdownFormatter: (value?: string | null) => ReactNode;

package/dist/src/beta/components/Table/formatters/numberFormatter.d.ts

@@ -1,42 +1,23 @@
-/**
- * Options type for the number formatter function
- */
 export type NumberFormatterOptions = {
-    /**
-     * The locale to use for the number formatter
-     * @default "en-US"
-     */
+    /** `Intl` locale. Defaults to `"en-US"`. */
     locale?: Intl.LocalesArgument;
-    /**
-     * The minimum number of fraction digits to display
-     * @default 0
-     */
+    /** Floor on displayed fraction digits. Defaults to `0`. */
     minimumFractionDigits?: number;
-    /**
-     * The maximum number of fraction digits to display
-     * @default 2
-     */
+    /** Cap on displayed fraction digits. Defaults to `2`. */
     maximumFractionDigits?: number;
-    /**
-     * Whether to use grouping separators (e.g., thousands separator)
-     * @default true
-     */
+    /** Grouping separators (thousands, etc.). Defaults to `true`. */
     useGrouping?: boolean;
     /**
-     * The notation style: "standard", "scientific", "engineering", or "compact"
-     * @default "standard"
+     * `Intl.NumberFormat` notation. Defaults to `"standard"`.
      */
     notation?: "standard" | "scientific" | "engineering" | "compact";
     /**
-     * How to display the sign: "auto", "never", "always", or "exceptZero"
-     * @default "auto"
+     * `Intl.NumberFormat` sign display. Defaults to `"auto"`.
      */
     signDisplay?: "auto" | "never" | "always" | "exceptZero";
 };
 /**
- * Helper function for formatting table cells with numbers, including i18n support
- * @param value - The value to format
- * @param options - The options for the number formatter
- * @returns The formatted number
+ * Formats a number with `Intl` decimal style. `null` and `undefined` return
+ * `null`.
  */
 export declare const numberFormatter: (value?: number | null, options?: NumberFormatterOptions) => string | null;

package/dist/src/beta/components/Table/formatters/percentFormatter.d.ts

@@ -1,22 +1,11 @@
-/**
- * Options type for the percent formatter function
- */
 export type PercentFormatterOptions = {
-    /**
-     * The number of decimals to display
-     * @default 2
-     */
+    /** Fraction digits for both min and max. Defaults to `2`. */
     decimals?: number;
-    /**
-     * The locale to use for the percent formatter
-     * @default "en-US"
-     */
+    /** `Intl` locale. Defaults to `"en-US"`. */
     locale?: Intl.LocalesArgument;
 };
 /**
- * Helper function for formatting table cells with percentages, including i18n support
- * @param value - The value to format
- * @param options - The options for the percent formatter
- * @returns The formatted percentage
+ * Formats a ratio as a percentage (`0.5` → `50%`) via `Intl` percent style.
+ * Nullish values return `null`.
  */
 export declare const percentFormatter: (value?: number, options?: PercentFormatterOptions) => string | null;