@inandu-solutions/grid-react 0.1.2 → 0.1.4

package/dist/components/InanduGrid.d.ts

@@ -0,0 +1,99 @@
+import { ReactNode } from 'react';
+import { InanduGridRow } from '../core';
+import { InanduGridCellPaste, InanduGridColumn, InanduGridRowSave } from '../hooks/useInanduGrid';
+export interface InanduGridProps {
+    rows: InanduGridRow[];
+    columns: InanduGridColumn[];
+    /** Drives number/date formatting (`Intl`-based). Default: 'en'. */
+    locale?: string;
+    /** Drives built-in UI string translation (one of `INANDU_GRID_TRANSLATIONS`'s keys). Default: `locale`'s primary subtag. */
+    lang?: string;
+    /** 0 (default) disables pagination — every filtered/sorted row renders. Ignored while grouped. */
+    pageSize?: number;
+    /** Adds a checkbox column with row + select-all selection. Default: false. */
+    selectable?: boolean;
+    /** Called after every selection change with the current full selection, as an array. */
+    onSelectionChange?: (selectedRows: InanduGridRow[]) => void;
+    /** Adds a CSV/Excel/PDF export toolbar above the table. Default: false. */
+    exportable?: boolean;
+    /** Base filename (without extension) for exports. Default: 'inandu-grid'. */
+    exportFilenameBase?: string;
+    /** Adds a per-row "Delete" button. Default: false. */
+    deletable?: boolean;
+    /** `window.confirm()`-gates a single row's delete. Unset: deletes immediately. */
+    deleteConfirmMessage?: string;
+    /** `window.confirm()`-gates the "Delete selected" bulk action (shown when `selectable && deletable` with at least one row selected). Unset: deletes immediately. */
+    bulkDeleteConfirmMessage?: string;
+    /** Adds an "Add row" trigger with a blank draft row. Default: false. Has no effect unless at least one column is `editable`. */
+    creatable?: boolean;
+    /** Called once a row edit passes validation. The grid never mutates `rows` itself — applying `values` onto `row` is the caller's job. */
+    onRowSave?: (event: InanduGridRowSave) => void;
+    /** Called once a new row's draft passes validation. No row reference — it doesn't exist in `rows` yet. */
+    onRowCreate?: (values: Record<string, unknown>) => void;
+    /** Called after a single-row delete is confirmed (or clicked, if no `deleteConfirmMessage`). */
+    onRowDelete?: (row: InanduGridRow) => void;
+    /** Called after the bulk "Delete selected" action is confirmed (or clicked, if no `bulkDeleteConfirmMessage`). */
+    onRowsDelete?: (rows: InanduGridRow[]) => void;
+    /** Opts into `Ctrl+C`/`Ctrl+V` cell copy/paste (Excel-style TSV). Default: false. */
+    clipboard?: boolean;
+    /** Called with every parsed cell update from a `Ctrl+V`. The grid never mutates `rows` itself. */
+    onCellsPaste?: (updates: InanduGridCellPaste[]) => void;
+    /** Adds a "Columns" toolbar button + popup letting the user show/hide individual columns at runtime. Default: false. */
+    columnToggle?: boolean;
+    /** Adds a per-row drag handle to reorder rows. Default: false. Auto-disabled while grouped, same as grid-angular. */
+    rowReorder?: boolean;
+    /** Called with the fully reordered row array after a row drag-and-drop. The grid never mutates `rows` itself. */
+    onRowOrderChange?: (rows: InanduGridRow[]) => void;
+    /**
+     * Turns on tree mode: the field on each row holding its child rows (a nested array of the same
+     * shape). `rows` is then the root rows. Auto-disabled while grouped. Tree rows are display +
+     * expand only — inline editing, drag-reorder and clipboard don't apply to them, same as
+     * grid-angular.
+     */
+    treeChildrenKey?: string;
+    /** Initial expand state for tree mode. Default: `'none'`. */
+    treeDefaultExpanded?: 'none' | 'all' | number;
+    /**
+     * Enables master-detail: renders a leading expand/collapse toggle per row, and (while expanded)
+     * a full-width detail row right below it, with whatever this returns. Auto-disabled while
+     * grouped, same as grid-angular's `detailTemplate`/`hasMasterDetail`. Unset (default): off.
+     */
+    renderDetail?: (row: InanduGridRow) => ReactNode;
+    /** Collapses any other expanded row first, accordion-style, when a new one expands. Off (any number of rows can be expanded at once) by default. */
+    singleDetailExpand?: boolean;
+    /** An extra per-row predicate ANDed onto the free-text + column filters — same as grid-angular's `extraRowFilter`. Lets a caller layer its own filtering (e.g. an advanced-filter query) on top of the grid's own. Unset: no extra filtering. */
+    extraRowFilter?: (row: InanduGridRow) => boolean;
+    /**
+     * Opt-in row virtualization for large datasets — only rows scrolled into view (plus a small
+     * overscan runway) are actually mounted. Bypasses pagination entirely, same as grouping.
+     * Auto-disabled while grouped (this port doesn't interleave group headers into the virtualized
+     * window the way grid-angular does); also disables master-detail, row drag-reorder, tree data,
+     * and the totals `<tfoot>`, same restrictions grid-angular's `virtualScroll` has. Default: false.
+     */
+    virtualScroll?: boolean;
+    /**
+     * Fixed row height (px) the virtualization math uses to compute scroll position and how many
+     * rows to render. Unlike grid-angular, this port doesn't auto-measure a rendered row's real
+     * height (that needs a real layout engine to verify, which unit tests can't provide) — pass the
+     * actual rendered row height for correct scrolling. Default: 40.
+     */
+    virtualRowHeight?: number;
+    /** The scrollable viewport's own height (px) — only used while `virtualScroll`. Default: 400. */
+    height?: number;
+    /** Extra rows rendered above/below the visible window, so a fast scroll doesn't flash empty space before the next render catches up. Default: 4. */
+    overscan?: number;
+    /**
+     * Double-click a column's resize handle to fit its width to its widest currently-rendered value
+     * (header included). Measures real rendered text width via the DOM (`measureColumnContentWidth`)
+     * — like grid-angular's own autosize, this only measures what's actually mounted (one page, or
+     * the virtual window), not the full dataset. Default: false.
+     */
+    autosize?: boolean;
+}
+/**
+ * Batteries-included table over `useInanduGrid`: sorting, free-text search, a per-column filter
+ * row, pagination, single-column grouping with per-group + grand-total aggregates, row selection,
+ * CSV/Excel/PDF export, i18n, inline row editing/creation/deletion with validation, and row
+ * virtualization for large datasets.
+ */
+export declare function InanduGrid({ rows, columns, locale, lang, pageSize, selectable, onSelectionChange, exportable, exportFilenameBase, deletable, deleteConfirmMessage, bulkDeleteConfirmMessage, creatable, onRowSave, onRowCreate, onRowDelete, onRowsDelete, clipboard, onCellsPaste, columnToggle, rowReorder, onRowOrderChange, treeChildrenKey, treeDefaultExpanded, renderDetail, singleDetailExpand, extraRowFilter, virtualScroll, virtualRowHeight, height, overscan, autosize, }: InanduGridProps): import('react').JSX.Element;

package/dist/core/aggregate.d.ts

@@ -0,0 +1,5 @@
+import { ColumnConfig, InanduColumnAggregate, InanduGridRow } from './types';
+/** Short, language-agnostic symbol shown for each `InanduColumnAggregate` kind — deliberately not translated (the same way units like "CSV"/"PDF" aren't). */
+export declare const AGGREGATE_SYMBOLS: Record<Exclude<InanduColumnAggregate, ''>, string>;
+/** One numeric aggregate per `aggregateColumns` entry, computed over `rows` — `'count'` just counts rows (works for any column type); the rest ignore rows whose raw value isn't a finite number. */
+export declare function computeGroupAggregates(rows: InanduGridRow[], aggregateColumns: readonly ColumnConfig[]): Record<string, number>;

package/dist/core/columns.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Columns with an explicit `order` land at that 0-based slot; columns without one
+ * fill the remaining slots in declaration order. Equal/out-of-range `order` values
+ * degrade gracefully by falling back to declaration order among themselves.
+ *
+ * Generic over the column type: works for `InanduColumnComponent` instances or any object with
+ * an `order()` accessor.
+ */
+export declare function placeColumnsByOrder<C extends {
+    order(): number | undefined;
+}>(columns: readonly C[]): C[];

package/dist/core/constants.d.ts

@@ -0,0 +1,14 @@
+/** Floor enforced while dragging a resize handle, so a column can never be shrunk to zero/negative width. */
+export declare const MIN_COLUMN_WIDTH = 30;
+/** Ceiling `autosize` (double-click a resize handle to fit content) will grow a column to, so one
+ *  very long value can't blow the column out to the width of the page. The drag handle itself is
+ *  not capped by this. */
+export declare const MAX_COLUMN_WIDTH = 600;
+/** Must match `.inandu-select-column`'s CSS width — used by `stickyOffset()` to account for the (always-sticky) checkbox column. */
+export declare const SELECT_COLUMN_WIDTH = 36;
+/** Must match `.inandu-row-drag-column`'s CSS width — used by `stickyOffset()` to account for the (always-leading, when enabled) drag-handle column. */
+export declare const ROW_DRAG_COLUMN_WIDTH = 32;
+/** Must match `.inandu-detail-toggle-column`'s CSS width — used by `stickyOffset()` to account for the (always-leading-most, when enabled) master-detail expand/collapse column. */
+export declare const DETAIL_TOGGLE_COLUMN_WIDTH = 32;
+/** `localStorage` key prefix for `stateKey`-based persistence, so this library's own saved blobs don't collide with anything else a host app stores. */
+export declare const STATE_STORAGE_PREFIX = "inandu-grid-state:";

package/dist/core/dom.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Escapes `value` for use inside a double-quoted CSS attribute-selector value (e.g.
+ * `` `td[data-field="${escaped}"]` ``), for the rare runtime with no native `CSS.escape`. Backslashes
+ * MUST be escaped before quotes — escaping only quotes lets a value containing a backslash (e.g.
+ * `a\"b`) smuggle an unescaped quote through (`\"` in the output reads back as an escaped backslash
+ * followed by a bare, string-terminating `"`), letting the selector break out of the attribute value.
+ */
+export declare function escapeAttributeSelectorValue(value: string): string;

package/dist/core/export/csv.d.ts

@@ -0,0 +1,2 @@
+/** Quotes `value` for a CSV cell (doubling internal quotes) only if it contains a comma, quote, or newline. */
+export declare function escapeCsvValue(value: string): string;

package/dist/core/export/download.d.ts

@@ -0,0 +1,2 @@
+/** Triggers a browser download of `content` as `filename`, via a throwaway object URL + `<a>` click. */
+export declare function downloadBlob(content: string | Blob, filename: string, mimeType?: string): void;

package/dist/core/export/markup.d.ts

@@ -0,0 +1,2 @@
+/** Escapes `&`/`</>` for safe use as XML/HTML element text content — shared by `exportExcel()` and `printTable()`. */
+export declare function escapeMarkup(value: string): string;

package/dist/core/export/pdf.d.ts

@@ -0,0 +1,3 @@
+import { jsPDF } from 'jspdf';
+/** Shortens `text` with a trailing "…" until it fits `maxWidth` (in the PDF's current font), unchanged if it already fits. */
+export declare function truncatePdfText(doc: jsPDF, text: string, maxWidth: number): string;

package/dist/core/filter.d.ts

@@ -0,0 +1,26 @@
+import { ColumnConfig, InanduGridColumnFilterValue, InanduGridRow } from './types';
+import { NumberFormatter } from './format';
+/**
+ * Whether `value` has at least one non-empty key — an entry can exist (e.g. after typing then
+ * clearing) without actually narrowing anything. `values` is the one exception: unlike every other
+ * key, an *empty* array is still meaningful (see `matchesColumnFilter`) — the presence of the key
+ * at all is what counts, not its length. Only an entirely absent/`undefined` `values` reads as "no
+ * set-filter constraint".
+ */
+export declare function hasMeaningfulFilterValue(value: InanduGridColumnFilterValue | undefined): boolean;
+/**
+ * Whether `row` satisfies `column`'s own filter control. An empty/absent `filterValue` (no
+ * constraint entered for this column yet) always matches. Range checks (`'number'`/`'date'`) are
+ * inclusive on both ends; a cell that can't be parsed as that column's type never matches once at
+ * least one bound is set.
+ *
+ * `filterValue.values` (the set filter) is the one key that's *present-vs-absent*, not
+ * *non-empty-vs-empty*: an `undefined` `values` falls through to the type-specific checks below,
+ * same as omitting it; a *defined* `values` — even `[]` — takes over matching for the column
+ * entirely, checked against the formatted display value. This is deliberate: `[]` is how "every
+ * checkbox is unchecked" (match nothing) is told apart from "the set filter was never touched"
+ * (match everything, i.e. don't constrain) — collapsing them to the same "no constraint" meaning,
+ * like every other filter key's blank state does, would make unchecking every box a no-op instead
+ * of the empty result a consumer building a set-filter checklist actually needs.
+ */
+export declare function matchesColumnFilter(column: ColumnConfig, row: InanduGridRow, filterValue: InanduGridColumnFilterValue, locale: string, numberFormatter?: NumberFormatter): boolean;

package/dist/core/format.d.ts

@@ -0,0 +1,24 @@
+import { InanduColumnType } from './types';
+/**
+ * Turns a raw numeric value into its display string. `digitsInfo` is a `DecimalPipe`-style
+ * `'{minInt}.{minFrac}-{maxFrac}'` string (e.g. `"1.2-2"`), or empty for the default.
+ *
+ * Injected into `formatCellValue()` so the framework layer can choose the implementation: the
+ * Angular component passes one backed by `@angular/common`'s `formatNumber` (honouring whatever
+ * locale data the host app registered), keeping its output byte-identical to before this folder
+ * existed. `defaultNumberFormatter` below is the standalone fallback for a non-Angular consumer.
+ */
+export type NumberFormatter = (value: number, locale: string, digitsInfo?: string) => string;
+/** `Intl.NumberFormat`-based `NumberFormatter`. Parses the `digitsInfo` mini-syntax; falls back to Angular's own default of up to 3 fraction digits (`'1.0-3'`) when it's absent. */
+export declare function defaultNumberFormatter(value: number, locale: string, digitsInfo?: string): string;
+/**
+ * Coerces a raw cell value to a `Date` for `type="date"` columns — accepts a `Date`, a timestamp,
+ * or a string. Safari's `Date` string parser is stricter than Chrome's; notably it returns an
+ * Invalid Date for a space-separated `"yyyy-mm-dd hh:mm[:ss]"` that Chrome happily parses. That one
+ * common case is normalised to the ISO `T` form before parsing, so a `type="date"` column renders
+ * and filters identically in both. Anything still unparseable comes back as an Invalid Date — every
+ * caller already guards with `Number.isNaN(date.getTime())`.
+ */
+export declare function coerceToDate(value: unknown): Date;
+export declare function formatDateValue(date: Date, format: string): string;
+export declare function formatCellValue(value: unknown, type: InanduColumnType, format: string, locale: string, numberFormatter?: NumberFormatter): string;

package/dist/core/i18n/en.d.ts

@@ -0,0 +1,46 @@
+export declare const en: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/es.d.ts

@@ -0,0 +1,46 @@
+export declare const es: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/fr.d.ts

@@ -0,0 +1,46 @@
+export declare const fr: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/index.d.ts

@@ -0,0 +1,8 @@
+import { en } from './en';
+import { es } from './es';
+import { fr } from './fr';
+import { it } from './it';
+import { zh } from './zh';
+export { en, es, fr, it, zh };
+/** Every built-in dictionary, keyed by primary language subtag. */
+export declare const INANDU_GRID_TRANSLATIONS: Record<string, Record<string, string>>;

package/dist/core/i18n/it.d.ts

@@ -0,0 +1,46 @@
+export declare const it: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/i18n/zh.d.ts

@@ -0,0 +1,46 @@
+export declare const zh: {
+    MsgNoData: string;
+    MsgFirstPage: string;
+    MsgPreviousPage: string;
+    MsgNextPage: string;
+    MsgLastPage: string;
+    MsgSortBy: string;
+    MsgPageOf: string;
+    MsgFilterPlaceholder: string;
+    MsgFilterColumn: string;
+    MsgFilterMin: string;
+    MsgFilterMax: string;
+    MsgFilterFrom: string;
+    MsgFilterTo: string;
+    MsgAll: string;
+    MsgCancelFilter: string;
+    MsgCancelAllFilters: string;
+    MsgGroupByHint: string;
+    MsgGroupedBy: string;
+    MsgGroupHeader: string;
+    MsgCancelGrouping: string;
+    MsgSelectAll: string;
+    MsgSelectRow: string;
+    MsgExportCsv: string;
+    MsgExportExcel: string;
+    MsgExportPdf: string;
+    MsgPrint: string;
+    MsgToggleColumns: string;
+    MsgToggleColumn: string;
+    MsgEditCell: string;
+    MsgEditRow: string;
+    MsgSaveRow: string;
+    MsgCancelRowEdit: string;
+    MsgDeleteRow: string;
+    MsgAddRow: string;
+    MsgLoading: string;
+    MsgDragRow: string;
+    MsgAutosizeColumn: string;
+    MsgExpandDetail: string;
+    MsgCollapseDetail: string;
+    MsgDeleteSelected: string;
+    MsgValidationRequired: string;
+    MsgValidationMin: string;
+    MsgValidationMax: string;
+    MsgValidationPattern: string;
+};

package/dist/core/index.d.ts

@@ -0,0 +1,17 @@
+export type { InanduColumnType, InanduColumnStickySide, InanduColumnAggregate, InanduGridRow, InanduGridColumnFilterValue, ColumnConfig, } from './types';
+export { MIN_COLUMN_WIDTH, MAX_COLUMN_WIDTH, SELECT_COLUMN_WIDTH, ROW_DRAG_COLUMN_WIDTH, DETAIL_TOGGLE_COLUMN_WIDTH, STATE_STORAGE_PREFIX, } from './constants';
+export { coerceToDate, formatDateValue, formatCellValue, defaultNumberFormatter, } from './format';
+export type { NumberFormatter } from './format';
+export { compareCellValues } from './sort';
+export { flattenTree, collectTreeRows } from './tree';
+export type { TreeVisibleRow, FlattenTreeOptions } from './tree';
+export { hasMeaningfulFilterValue, matchesColumnFilter } from './filter';
+export { AGGREGATE_SYMBOLS, computeGroupAggregates } from './aggregate';
+export { placeColumnsByOrder } from './columns';
+export { parseDraftValue, parsePastedCellValue } from './parse';
+export { escapeAttributeSelectorValue } from './dom';
+export { escapeCsvValue } from './export/csv';
+export { escapeMarkup } from './export/markup';
+export { truncatePdfText } from './export/pdf';
+export { downloadBlob } from './export/download';
+export { en, es, fr, it, zh, INANDU_GRID_TRANSLATIONS } from './i18n';

package/dist/core/parse.d.ts

@@ -0,0 +1,14 @@
+import { InanduColumnType } from './types';
+/**
+ * Parses a row-edit draft's raw control value (a string for text/number/date, a boolean for the
+ * checkbox — see `InanduGridComponent.onRowFieldChange`) per the column's `type`. Returns `undefined` for
+ * an unparseable `'number'`/`'date'`, the signal `saveRow()` uses to omit that field from `values`
+ * rather than committing garbage.
+ */
+export declare function parseDraftValue(raw: unknown, type: InanduColumnType): unknown;
+/**
+ * Parses one pasted TSV cell's raw text per `type` — like `parseDraftValue()`, except `'boolean'`:
+ * a pasted cell is always plain text (`"true"`/`"false"`, whatever the clipboard actually held),
+ * never an already-boolean checkbox `.checked` the way a manual row edit's draft value is.
+ */
+export declare function parsePastedCellValue(raw: string, type: InanduColumnType): unknown;

package/dist/core/sort.d.ts

@@ -0,0 +1 @@
+export declare function compareCellValues(a: unknown, b: unknown, locale?: string): number;

package/dist/core/tree.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tree-data flattening (#3) — pure, framework-agnostic. Walks a nested-children hierarchy into the
+ * flat list of rows that should render right now: a node's children appear directly below it, but
+ * only while that node is expanded. Filtering keeps a node when it (or any descendant) matches, and
+ * force-expands the ancestors of a match so it's visible; an optional comparator sorts each level.
+ */
+export interface TreeVisibleRow<T> {
+    row: T;
+    /** 0 for a root, +1 per level. Drives the first cell's indentation. */
+    depth: number;
+    /** Has at least one (surviving) child — i.e. worth showing a toggle. */
+    expandable: boolean;
+    /** Currently showing its children. */
+    expanded: boolean;
+}
+export interface FlattenTreeOptions<T> {
+    /** A node's children array (or `undefined` / `[]` for a leaf). */
+    getChildren: (row: T) => readonly T[] | undefined;
+    /** Whether `row` is expanded — consulted only when there is no active `match`. */
+    isExpanded: (row: T) => boolean;
+    /** When set, a node survives iff it or a descendant returns `true`; matches render expanded. */
+    match?: (row: T) => boolean;
+    /** Sorts the siblings at every level (applied after filtering). */
+    compare?: (a: T, b: T) => number;
+}
+export declare function flattenTree<T>(roots: readonly T[], options: FlattenTreeOptions<T>): TreeVisibleRow<T>[];
+/** Every node in the hierarchy, depth-first — used for "expand all" / counting. */
+export declare function collectTreeRows<T>(roots: readonly T[], getChildren: (row: T) => readonly T[] | undefined): T[];

package/dist/core/types.d.ts

@@ -0,0 +1,46 @@
+/** How a column's raw cell value is interpreted and formatted. See `InanduColumnComponent.type`. */
+export type InanduColumnType = 'string' | 'number' | 'boolean' | 'date';
+/** Which side of the grid a `sticky="true"` column pins to. See `InanduColumnComponent.stickySide`. */
+export type InanduColumnStickySide = 'left' | 'right';
+/** Aggregate shown in a group's header row when the grid is grouped. See `InanduColumnComponent.aggregate`. */
+export type InanduColumnAggregate = 'sum' | 'avg' | 'min' | 'max' | 'count' | '';
+/** A grid row — a plain bag of field values. The grid never assumes any particular key. */
+export type InanduGridRow = Record<string, unknown>;
+/**
+ * The subset of a column definition the pure helpers read, expressed as the signal-getter shape
+ * `InanduColumnComponent` already exposes (so an `InanduColumnComponent` instance satisfies this
+ * structurally, with no adapter). A non-Angular consumer can pass any object with these five
+ * zero-arg accessors — e.g. `{ field: () => 'name', type: () => 'string', ... }`.
+ */
+export interface ColumnConfig {
+    field(): string;
+    type(): InanduColumnType;
+    format(): string;
+    order(): number | undefined;
+    aggregate(): InanduColumnAggregate;
+}
+/** Raw values from a single column's filter controls; which keys are used depends on that column's `type`. */
+export interface InanduGridColumnFilterValue {
+    /** `'string'` columns. */
+    text?: string;
+    /** `'number'` columns. */
+    min?: string;
+    max?: string;
+    /** `'date'` columns, `yyyy-mm-dd` (native `<input type="date">` value format). */
+    from?: string;
+    to?: string;
+    /** `'boolean'` columns: `''` (no filter), `'true'`, or `'false'`. */
+    bool?: string;
+    /**
+     * Excel-style "set filter" — an explicit list of the column's own *formatted* display values to
+     * match (OR within the column, same as every other filter key combines with AND across
+     * columns). Works the same regardless of `type` — unlike `text`/`min`/`max`/`from`/`to`/`bool`,
+     * which are each specific to one `type` — since it compares against the already-formatted
+     * string, not the raw value. Whenever this key is *present* (defined) at all, it takes over
+     * matching for the column entirely and the type-specific keys above are ignored — including an
+     * **empty array**, which means "every value unchecked" and matches nothing, not "no
+     * constraint". Omit the key (or set it to `undefined`) for "no constraint" instead. See
+     * `matchesColumnFilter`/`hasMeaningfulFilterValue`.
+     */
+    values?: string[];
+}