@camstack/ui-library 1.2.256 → 1.2.258

package/dist/composites/confirm-dialog.d.ts

@@ -1,53 +1,115 @@
-import { ReactNode } from 'react';
-export type DialogVariant = 'danger' | 'warning' | 'default';
+/**
+* The ONE modal dialog of the product — confirm, alert and prompt.
+*
+* ## Why all three live here
+*
+* The admin UI used to reach for `window.confirm` / `window.alert` /
+* `window.prompt` wherever a `useConfirm()` call was inconvenient. A native
+* dialog is wrong on three counts, and the operator hit the worst one on
+* Identity → Users: resetting a password opened `window.prompt`, which
+* **cannot mask its input**. A new password was typed in clear text, into a
+* box the browser may offer to remember. On top of that a native dialog
+* matches none of the product's visual language and the host can neither style
+* nor test it.
+*
+* So the fix is not "a password modal" — a second dialog component is the
+* defect, not the cure. The provider that already served every confirm in the
+* admin UI (and in the viewer, which documents its own copy as "deliberately
+* the same one `@camstack/ui-library` exposes to the admin UI") grew two more
+* intents. One provider, one backdrop, one visual language, one set of
+* keyboard rules.
+*
+* ## The three intents are NOT one control
+*
+* - `confirm` — a destructive yes/no. It names what is destroyed, and for the
+*   `danger` variant the destructive button is the NON-default: opening focus
+*   lands on Cancel, so a reflexive Enter cancels.
+* - `alert` — an error/notice with a single acknowledge.
+* - `prompt` — one text input with OK/Cancel. `inputType: 'password'` masks it
+*   (and opts out of autofill/remember); `readOnly` turns it into a readable,
+*   select-all-on-open field, which is the shape the copy-to-clipboard
+*   fallback needs — a password box would be actively wrong there.
+*
+* ## Why the surface is a native `<dialog>`
+*
+* These dialogs open OVER surfaces that are themselves native `<dialog>`s
+* opened with `showModal()` — the event detail panel, the similar-groups
+* modal. A `showModal()` dialog is promoted to the TOP LAYER and everything
+* outside it is inert, so a plain `fixed inset-0` overlay rendered at the app
+* root would be drawn behind that backdrop and could not be clicked at all.
+* Confirming a track delete from the detail panel would have been impossible.
+* So this surface is a `<dialog>` of its own: the top layer stacks, the newest
+* `showModal()` wins, and the confirm sits above the panel that asked for it.
+*
+* jsdom implements `<dialog>` but not `showModal()`, so the open falls back to
+* the `open` attribute there. Everything this component does — focus, keys,
+* resolution — is identical on both paths; only the top-layer promotion, which
+* jsdom cannot model at all, is missing. The fallback is asserted below.
+*
+* ## Focus, and why there is NO focus trap
+*
+* A `showModal()` dialog already scopes the tab ring to itself, and the
+* surfaces underneath (`SlideOverPanel`) implement no trap of their own. A
+* second, hand-rolled focus trap on top of that is how a page becomes
+* unescapable, so this component deliberately does not trap. What it does do:
+*
+* - focuses the input (prompt) or the DEFAULT button on open,
+* - restores focus to the previously focused element on close,
+* - handles Escape/Enter from a `keydown` on the dialog itself and calls
+*   `stopPropagation()`. React attaches its listeners at the root container, so
+*   stopping there keeps the event from reaching the `window` Escape listener
+*   of whatever modal is underneath: one Escape closes ONE dialog.
+*/
+import { type JSX, type ReactNode } from "react";
+export type DialogVariant = "danger" | "warning" | "default";
 export interface ConfirmOptions {
-    readonly title: string;
-    readonly message: string;
-    readonly confirmLabel?: string;
-    readonly cancelLabel?: string;
-    readonly variant?: DialogVariant;
+	readonly title: string;
+	readonly message: string;
+	readonly confirmLabel?: string;
+	readonly cancelLabel?: string;
+	readonly variant?: DialogVariant;
 }
 export interface AlertOptions {
-    readonly title: string;
-    readonly message: string;
-    readonly acknowledgeLabel?: string;
-    readonly variant?: DialogVariant;
+	readonly title: string;
+	readonly message: string;
+	readonly acknowledgeLabel?: string;
+	readonly variant?: DialogVariant;
 }
-export type PromptInputType = 'text' | 'password';
+export type PromptInputType = "text" | "password";
 export interface PromptOptions {
-    readonly title: string;
-    /** Explanatory paragraph above the field. */
-    readonly message?: string;
-    /** Label rendered against the input. Defaults to the title. */
-    readonly label?: string;
-    readonly defaultValue?: string;
-    /** `password` masks the value and opts out of autofill/remember. */
-    readonly inputType?: PromptInputType;
-    readonly placeholder?: string;
-    readonly confirmLabel?: string;
-    readonly cancelLabel?: string;
-    /**
-     * A field the operator reads/copies rather than edits (the clipboard
-     * fallback). Rendered unmasked, selected on open, with no validation.
-     */
-    readonly readOnly?: boolean;
-    /**
-     * Returns an error message to REFUSE the value and keep the dialog open, or
-     * `null` to accept. Runs on submit — the dialog is the validation surface, so
-     * a refusal never needs a second `alert`.
-     */
-    readonly validate?: (value: string) => string | null;
-    /**
-     * `danger` paints the affirmative button as destructive — a typed
-     * confirmation ("type 17 to revoke 17 links") is a prompt whose OK destroys.
-     * Focus still opens on the field. Default: `default`.
-     */
-    readonly variant?: DialogVariant;
+	readonly title: string;
+	/** Explanatory paragraph above the field. */
+	readonly message?: string;
+	/** Label rendered against the input. Defaults to the title. */
+	readonly label?: string;
+	readonly defaultValue?: string;
+	/** `password` masks the value and opts out of autofill/remember. */
+	readonly inputType?: PromptInputType;
+	readonly placeholder?: string;
+	readonly confirmLabel?: string;
+	readonly cancelLabel?: string;
+	/**
+	* A field the operator reads/copies rather than edits (the clipboard
+	* fallback). Rendered unmasked, selected on open, with no validation.
+	*/
+	readonly readOnly?: boolean;
+	/**
+	* Returns an error message to REFUSE the value and keep the dialog open, or
+	* `null` to accept. Runs on submit — the dialog is the validation surface, so
+	* a refusal never needs a second `alert`.
+	*/
+	readonly validate?: (value: string) => string | null;
+	/**
+	* `danger` paints the affirmative button as destructive — a typed
+	* confirmation ("type 17 to revoke 17 links") is a prompt whose OK destroys.
+	* Focus still opens on the field. Default: `default`.
+	*/
+	readonly variant?: DialogVariant;
 }
 export interface DialogContextValue {
-    readonly confirm: (options: ConfirmOptions) => Promise<boolean>;
-    readonly alert: (options: AlertOptions) => Promise<void>;
-    readonly prompt: (options: PromptOptions) => Promise<string | null>;
+	readonly confirm: (options: ConfirmOptions) => Promise<boolean>;
+	readonly alert: (options: AlertOptions) => Promise<void>;
+	readonly prompt: (options: PromptOptions) => Promise<string | null>;
 }
 export declare function useConfirm(): (options: ConfirmOptions) => Promise<boolean>;
 /** An error/notice with a single acknowledge. Replaces `window.alert`. */
@@ -55,10 +117,10 @@ export declare function useAlert(): (options: AlertOptions) => Promise<void>;
 /** One text input with OK/Cancel. Replaces `window.prompt`. */
 export declare function usePrompt(): (options: PromptOptions) => Promise<string | null>;
 export declare function ConfirmDialogProvider({ children }: {
-    children: ReactNode;
-}): import("react").JSX.Element;
+	children: ReactNode;
+}): JSX.Element;
 /**
- * Promotes `el` to the top layer. jsdom has `<dialog>` but no `showModal`, so
- * the attribute is the fallback — see the file docblock.
- */
+* Promotes `el` to the top layer. jsdom has `<dialog>` but no `showModal`, so
+* the attribute is the fallback — see the file docblock.
+*/
 export declare function openTopLayer(el: HTMLDialogElement): void;

package/dist/composites/copy-button.d.ts

@@ -1,21 +1,27 @@
-import { ReactElement } from 'react';
+/**
+* `CopyButton` — a compact button that copies a string `value` to the
+* clipboard via `navigator.clipboard.writeText`, showing a brief
+* "copied" check state. Addon-agnostic; used wherever a secret / URL
+* needs a one-click copy affordance (export setup panels, etc.).
+*/
+import { type ReactElement } from "react";
 export interface CopyButtonProps {
-    /** String copied to the clipboard when the button is pressed. */
-    readonly value: string;
-    /** Optional visible label rendered next to the icon. Icon-only when omitted.
-     *
-     *  Do NOT pass the name of the field the button sits next to: the row
-     *  already shows it, and the repeat is what overlapped the value on a phone
-     *  (a token row rendered its own name on top of the masked secret). Use
-     *  {@link CopyButtonProps.srLabel} for that — it names the target for screen
-     *  readers without spending horizontal space. */
-    readonly label?: string;
-    /** Names what is copied, for assistive tech only — never rendered. Falls back
-     *  to `label`, then to a generic word. */
-    readonly srLabel?: string;
-    /** Extra classes merged onto the button. */
-    readonly className?: string;
-    /** Disable the button (e.g. nothing to copy). */
-    readonly disabled?: boolean;
+	/** String copied to the clipboard when the button is pressed. */
+	readonly value: string;
+	/** Optional visible label rendered next to the icon. Icon-only when omitted.
+	*
+	*  Do NOT pass the name of the field the button sits next to: the row
+	*  already shows it, and the repeat is what overlapped the value on a phone
+	*  (a token row rendered its own name on top of the masked secret). Use
+	*  {@link CopyButtonProps.srLabel} for that — it names the target for screen
+	*  readers without spending horizontal space. */
+	readonly label?: string;
+	/** Names what is copied, for assistive tech only — never rendered. Falls back
+	*  to `label`, then to a generic word. */
+	readonly srLabel?: string;
+	/** Extra classes merged onto the button. */
+	readonly className?: string;
+	/** Disable the button (e.g. nothing to copy). */
+	readonly disabled?: boolean;
 }
-export declare function CopyButton({ value, label, srLabel, className, disabled, }: CopyButtonProps): ReactElement;
+export declare function CopyButton({ value, label, srLabel, className, disabled }: CopyButtonProps): ReactElement;

package/dist/composites/data-table/data-table-header.d.ts

@@ -1,10 +1,11 @@
-import { HeaderGroup, flexRender } from '@tanstack/react-table';
-import { SortingState } from './types';
+import type { HeaderGroup, flexRender } from "@tanstack/react-table";
+import type { SortingState } from "./types";
+import { type JSX } from "react";
 interface DataTableHeaderProps<T> {
-    headerGroups: HeaderGroup<T>[];
-    onSortingChange?: (sorting: SortingState) => void;
-    stickyHeader?: boolean;
-    flexRender: typeof flexRender;
+	headerGroups: HeaderGroup<T>[];
+	onSortingChange?: (sorting: SortingState) => void;
+	stickyHeader?: boolean;
+	flexRender: typeof flexRender;
 }
-export declare function DataTableHeader<T>({ headerGroups, onSortingChange, stickyHeader, flexRender: render, }: DataTableHeaderProps<T>): import("react").JSX.Element;
+export declare function DataTableHeader<T>({ headerGroups, onSortingChange, stickyHeader, flexRender: render }: DataTableHeaderProps<T>): JSX.Element;
 export {};

package/dist/composites/data-table/data-table-pagination.d.ts

@@ -1,9 +1,10 @@
-import { PaginationState } from './types';
+import type { PaginationState } from "./types";
+import { type JSX } from "react";
 interface DataTablePaginationProps {
-    page: number;
-    pageSize: number;
-    total: number;
-    onPaginationChange?: (pagination: PaginationState) => void;
+	page: number;
+	pageSize: number;
+	total: number;
+	onPaginationChange?: (pagination: PaginationState) => void;
 }
-export declare function DataTablePagination({ page, pageSize, total, onPaginationChange, }: DataTablePaginationProps): import("react").JSX.Element;
+export declare function DataTablePagination({ page, pageSize, total, onPaginationChange }: DataTablePaginationProps): JSX.Element;
 export {};

package/dist/composites/data-table/data-table-row.d.ts

@@ -1,10 +1,11 @@
-import { Row, flexRender } from '@tanstack/react-table';
-import { DataTableAction } from './types';
+import type { Row, flexRender } from "@tanstack/react-table";
+import type { JSX } from "react";
+import type { DataTableAction } from "./types";
 interface DataTableRowProps<T> {
-    row: Row<T>;
-    onRowClick?: (row: T) => void;
-    rowActions?: (row: T) => DataTableAction[];
-    flexRender: typeof flexRender;
+	row: Row<T>;
+	onRowClick?: (row: T) => void;
+	rowActions?: (row: T) => DataTableAction[];
+	flexRender: typeof flexRender;
 }
-export declare function DataTableRow<T>({ row, onRowClick, rowActions, flexRender: render, }: DataTableRowProps<T>): import("react").JSX.Element;
+export declare function DataTableRow<T>({ row, onRowClick, rowActions, flexRender: render }: DataTableRowProps<T>): JSX.Element;
 export {};

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

@@ -1,2 +1,3 @@
-import { DataTableProps } from './types';
-export declare function DataTable<T>({ data, columns: userColumns, sorting, onSortingChange, filtering, onFilteringChange, pagination, onPaginationChange, loading, emptyState, rowActions, onRowClick, selectable, compact, stickyHeader, className, mobileMode, }: DataTableProps<T>): import("react").JSX.Element;
+import { type JSX } from "react";
+import type { DataTableProps } from "./types";
+export declare function DataTable<T>({ data, columns: userColumns, sorting, onSortingChange, filtering, onFilteringChange, pagination, onPaginationChange, loading, emptyState, rowActions, onRowClick, selectable, compact, stickyHeader, className, mobileMode }: DataTableProps<T>): JSX.Element;

package/dist/composites/data-table/index.d.ts

@@ -1,2 +1,2 @@
-export { DataTable } from './data-table';
-export type { DataTableProps, ColumnDef, SortingState, ColumnFiltersState, PaginationState, DataTableAction, } from './types';
+export { DataTable } from "./data-table";
+export type { DataTableProps, ColumnDef, SortingState, ColumnFiltersState, PaginationState, DataTableAction } from "./types";

package/dist/composites/data-table/types.d.ts

@@ -1,34 +1,34 @@
-import { ColumnDef, SortingState, ColumnFiltersState, PaginationState } from '@tanstack/react-table';
-import { ReactNode } from 'react';
-import { LucideIcon } from 'lucide-react';
+import type { ColumnDef, SortingState, ColumnFiltersState, PaginationState } from "@tanstack/react-table";
+import type { ReactNode } from "react";
+import type { LucideIcon } from "lucide-react";
 export type { ColumnDef, SortingState, ColumnFiltersState, PaginationState };
 export interface DataTableAction {
-    label: string;
-    icon?: LucideIcon;
-    onClick: () => void;
-    variant?: 'danger' | 'default';
+	label: string;
+	icon?: LucideIcon;
+	onClick: () => void;
+	variant?: "danger" | "default";
 }
 export interface DataTableProps<T> {
-    data: T[];
-    columns: ColumnDef<T, unknown>[];
-    sorting?: SortingState;
-    onSortingChange?: (sorting: SortingState) => void;
-    filtering?: ColumnFiltersState;
-    onFilteringChange?: (filtering: ColumnFiltersState) => void;
-    pagination?: {
-        page: number;
-        pageSize: number;
-        total: number;
-    };
-    onPaginationChange?: (pagination: PaginationState) => void;
-    loading?: boolean;
-    emptyState?: ReactNode;
-    rowActions?: (row: T) => DataTableAction[];
-    onRowClick?: (row: T) => void;
-    selectable?: boolean;
-    compact?: boolean;
-    stickyHeader?: boolean;
-    className?: string;
-    /** How to render on mobile. 'scroll' keeps table with horizontal scroll. 'cards' renders each row as a card. Default: 'scroll' */
-    mobileMode?: 'scroll' | 'cards';
+	data: T[];
+	columns: ColumnDef<T, unknown>[];
+	sorting?: SortingState;
+	onSortingChange?: (sorting: SortingState) => void;
+	filtering?: ColumnFiltersState;
+	onFilteringChange?: (filtering: ColumnFiltersState) => void;
+	pagination?: {
+		page: number;
+		pageSize: number;
+		total: number;
+	};
+	onPaginationChange?: (pagination: PaginationState) => void;
+	loading?: boolean;
+	emptyState?: ReactNode;
+	rowActions?: (row: T) => DataTableAction[];
+	onRowClick?: (row: T) => void;
+	selectable?: boolean;
+	compact?: boolean;
+	stickyHeader?: boolean;
+	className?: string;
+	/** How to render on mobile. 'scroll' keeps table with horizontal scroll. 'cards' renders each row as a card. Default: 'scroll' */
+	mobileMode?: "scroll" | "cards";
 }

package/dist/composites/data-table-filter-bar.d.ts

@@ -1,36 +1,37 @@
-import { DataTableFacet, DataTableFilterState } from './data-table-filter';
+import type { JSX } from "react";
+import { type DataTableFacet, type DataTableFilterState } from "./data-table-filter";
 /** One facet group as the bar draws it. */
 export interface DataTableFilterBarGroup {
-    readonly id: string;
-    /** Visible caption AND the chip group's accessible name ("Status"). */
-    readonly label: string;
-    readonly facets: readonly DataTableFacet[];
-    readonly selected: readonly string[];
-    /** Render a chip's caption. Default: the raw value. */
-    readonly facetLabel?: (value: string) => string;
+	readonly id: string;
+	/** Visible caption AND the chip group's accessible name ("Status"). */
+	readonly label: string;
+	readonly facets: readonly DataTableFacet[];
+	readonly selected: readonly string[];
+	/** Render a chip's caption. Default: the raw value. */
+	readonly facetLabel?: (value: string) => string;
 }
 export interface DataTableFilterBarLabels {
-    /** Placeholder of the search box. */
-    readonly searchPlaceholder: string;
-    /** Accessible name of the search box — say WHICH table, two of them on one
-     *  page are otherwise indistinguishable to a screen reader. */
-    readonly searchLabel: string;
-    /** Accessible name of the chip group. */
-    readonly facetsLabel: string;
-    /** The clear-filters button. */
-    readonly clearLabel: string;
+	/** Placeholder of the search box. */
+	readonly searchPlaceholder: string;
+	/** Accessible name of the search box — say WHICH table, two of them on one
+	*  page are otherwise indistinguishable to a screen reader. */
+	readonly searchLabel: string;
+	/** Accessible name of the chip group. */
+	readonly facetsLabel: string;
+	/** The clear-filters button. */
+	readonly clearLabel: string;
 }
 export interface DataTableFilterBarProps {
-    readonly state: DataTableFilterState;
-    readonly facets: readonly DataTableFacet[];
-    readonly labels: DataTableFilterBarLabels;
-    readonly onSearch: (search: string) => void;
-    readonly onToggleFacet: (value: string) => void;
-    readonly onClear: () => void;
-    /** Render a chip's caption. Default: the raw value. */
-    readonly facetLabel?: (value: string) => string;
-    /** Further chip rows (status, owner, kind…), each its own group. */
-    readonly groups?: readonly DataTableFilterBarGroup[];
-    readonly onToggleGroupFacet?: (groupId: string, value: string) => void;
+	readonly state: DataTableFilterState;
+	readonly facets: readonly DataTableFacet[];
+	readonly labels: DataTableFilterBarLabels;
+	readonly onSearch: (search: string) => void;
+	readonly onToggleFacet: (value: string) => void;
+	readonly onClear: () => void;
+	/** Render a chip's caption. Default: the raw value. */
+	readonly facetLabel?: (value: string) => string;
+	/** Further chip rows (status, owner, kind…), each its own group. */
+	readonly groups?: readonly DataTableFilterBarGroup[];
+	readonly onToggleGroupFacet?: (groupId: string, value: string) => void;
 }
-export declare function DataTableFilterBar({ state, facets, labels, onSearch, onToggleFacet, onClear, facetLabel, groups, onToggleGroupFacet, }: DataTableFilterBarProps): import("react").JSX.Element;
+export declare function DataTableFilterBar({ state, facets, labels, onSearch, onToggleFacet, onClear, facetLabel, groups, onToggleGroupFacet }: DataTableFilterBarProps): JSX.Element;

package/dist/composites/data-table-filter.d.ts

@@ -1,47 +1,47 @@
 export interface DataTableFilterState {
-    /** Case- and separator-insensitive substring, see `fuzzyMatch`. */
-    readonly search: string;
-    /** Selected facet values. Empty = every row. */
-    readonly facets: readonly string[];
-    /**
-     * Selected chips per facet GROUP (`facetGroups[].id` → values). OR inside a
-     * group, AND across groups. Absent or empty = the group does not filter.
-     */
-    readonly groups?: Readonly<Record<string, readonly string[]>>;
+	/** Case- and separator-insensitive substring, see `fuzzyMatch`. */
+	readonly search: string;
+	/** Selected facet values. Empty = every row. */
+	readonly facets: readonly string[];
+	/**
+	* Selected chips per facet GROUP (`facetGroups[].id` → values). OR inside a
+	* group, AND across groups. Absent or empty = the group does not filter.
+	*/
+	readonly groups?: Readonly<Record<string, readonly string[]>>;
 }
 export declare const EMPTY_DATA_TABLE_FILTER: DataTableFilterState;
 /** One independent chip row — status, owner, kind… */
 export interface DataTableFacetGroupConfig<T> {
-    /** Stable id; the key of `DataTableFilterState.groups`. */
-    readonly id: string;
-    /** The value this row contributes to THIS group's chips. */
-    readonly value: (row: T) => string;
+	/** Stable id; the key of `DataTableFilterState.groups`. */
+	readonly id: string;
+	/** The value this row contributes to THIS group's chips. */
+	readonly value: (row: T) => string;
 }
 /** A group's chips, derived from the rows. */
 export interface DataTableFacetGroup {
-    readonly id: string;
-    readonly facets: readonly DataTableFacet[];
+	readonly id: string;
+	readonly facets: readonly DataTableFacet[];
 }
 /** One facet chip, with how many of the rows carry it. */
 export interface DataTableFacet {
-    readonly value: string;
-    readonly count: number;
+	readonly value: string;
+	readonly count: number;
 }
 export interface DataTableFilterConfig<T> {
-    /** Every text the search is matched against for this row — a name, and
-     *  whatever else an operator would type to find it (a nested accessory's
-     *  name, an id). */
-    readonly searchText: (row: T) => readonly string[];
-    /** The value this row contributes to the facet chips. Omit for a table
-     *  with a search box only. */
-    readonly facetValue?: (row: T) => string;
-    /** Further chip rows, each filtering on its own dimension. */
-    readonly facetGroups?: readonly DataTableFacetGroupConfig<T>[];
+	/** Every text the search is matched against for this row — a name, and
+	*  whatever else an operator would type to find it (a nested accessory's
+	*  name, an id). */
+	readonly searchText: (row: T) => readonly string[];
+	/** The value this row contributes to the facet chips. Omit for a table
+	*  with a search box only. */
+	readonly facetValue?: (row: T) => string;
+	/** Further chip rows, each filtering on its own dimension. */
+	readonly facetGroups?: readonly DataTableFacetGroupConfig<T>[];
 }
 /**
- * The facet chips for these rows: one per distinct value, most common first,
- * ties by value.
- */
+* The facet chips for these rows: one per distinct value, most common first,
+* ties by value.
+*/
 export declare function dataTableFacets<T>(rows: readonly T[], facetValue: ((row: T) => string) | undefined): readonly DataTableFacet[];
 /** One chip row per configured group, each derived like {@link dataTableFacets}. */
 export declare function dataTableFacetGroups<T>(rows: readonly T[], groups: readonly DataTableFacetGroupConfig<T>[] | undefined): readonly DataTableFacetGroup[];
@@ -51,9 +51,9 @@ export declare function toggleDataTableGroupFacet(state: DataTableFilterState, g
 /** A new state with `value` added to, or removed from, the selected facets. */
 export declare function toggleDataTableFacet(state: DataTableFilterState, value: string): DataTableFilterState;
 /**
- * The rows that survive the filter, in their incoming order.
- *
- * A selected facet that none of `rows` carries is dropped from the effective
- * selection (see the header), so a chip that is not on screen never filters.
- */
+* The rows that survive the filter, in their incoming order.
+*
+* A selected facet that none of `rows` carries is dropped from the effective
+* selection (see the header), so a chip that is not on screen never filters.
+*/
 export declare function filterDataTableRows<T>(rows: readonly T[], state: DataTableFilterState, config: DataTableFilterConfig<T>): readonly T[];

package/dist/composites/data-table-layout.d.ts

@@ -1,31 +1,31 @@
 /**
- * The one decision a shared table has to make on a phone.
- *
- * A wide table has no good phone rendering. There are exactly two honest
- * answers — become a list of cards, or scroll horizontally INSIDE its own
- * container while the page body never moves sideways — and shrinking the font
- * is not one of them. `DataTable` supports both; this module decides which, so
- * the choice is a pure, testable rule instead of per-page CSS.
- *
- * The default is a table that scrolls horizontally inside its own container.
- * Cards exist as an explicit `mobileMode="cards"` opt-in. `auto` still
- * applies a column-count rule for surfaces that want the old behaviour.
- *
- * Pass an explicit `mobileMode` to override per table.
- */
+* The one decision a shared table has to make on a phone.
+*
+* A wide table has no good phone rendering. There are exactly two honest
+* answers — become a list of cards, or scroll horizontally INSIDE its own
+* container while the page body never moves sideways — and shrinking the font
+* is not one of them. `DataTable` supports both; this module decides which, so
+* the choice is a pure, testable rule instead of per-page CSS.
+*
+* The default is a table that scrolls horizontally inside its own container.
+* Cards exist as an explicit `mobileMode="cards"` opt-in. `auto` still
+* applies a column-count rule for surfaces that want the old behaviour.
+*
+* Pass an explicit `mobileMode` to override per table.
+*/
 /** Per-table override. `auto` applies the column-count rule below. */
-export type TableMobileMode = 'auto' | 'scroll' | 'cards';
+export type TableMobileMode = "auto" | "scroll" | "cards";
 /** How the table renders once the decision is made. */
-export type TableLayoutKind = 'table' | 'cards';
+export type TableLayoutKind = "table" | "cards";
 /**
- * At this many columns and above, `auto` switches a narrow viewport to cards.
- * Three columns still fit a phone at a readable size; four do not.
- */
+* At this many columns and above, `auto` switches a narrow viewport to cards.
+* Three columns still fit a phone at a readable size; four do not.
+*/
 export declare const CARD_MODE_MIN_COLUMNS = 4;
 export interface ResolveTableLayoutInput {
-    readonly mode: TableMobileMode;
-    readonly columnCount: number;
-    /** Viewport below the card breakpoint (`useIsMobile`). */
-    readonly isNarrow: boolean;
+	readonly mode: TableMobileMode;
+	readonly columnCount: number;
+	/** Viewport below the card breakpoint (`useIsMobile`). */
+	readonly isNarrow: boolean;
 }
-export declare function resolveTableLayout({ mode, columnCount, isNarrow, }: ResolveTableLayoutInput): TableLayoutKind;
+export declare function resolveTableLayout({ mode, columnCount, isNarrow }: ResolveTableLayoutInput): TableLayoutKind;

package/dist/composites/data-table-pager.d.ts

@@ -1,8 +1,8 @@
-import { ReactNode } from 'react';
-import { DataTablePage, DataTablePaginationLabels } from './data-table-pagination';
+import type { ReactNode } from "react";
+import type { DataTablePage, DataTablePaginationLabels } from "./data-table-pagination";
 export interface DataTablePagerProps {
-    readonly page: DataTablePage<unknown>;
-    readonly labels: DataTablePaginationLabels;
-    readonly onPageChange: (page: number) => void;
+	readonly page: DataTablePage<unknown>;
+	readonly labels: DataTablePaginationLabels;
+	readonly onPageChange: (page: number) => void;
 }
 export declare function DataTablePager({ page, labels, onPageChange }: DataTablePagerProps): ReactNode;