@customafk/lunas-ui 0.2.33 → 0.2.35

package/dist/{index-B0tpV7YG.d.cts → index-C45OSg1W.d.mts}

@@ -1,6 +1,6 @@
-import { t as AnyEntity } from "./types-CLkAmCre.cjs";
-import { t as Input } from "./input-DgwlkE9s.cjs";
-import * as react690 from "react";
+import { t as AnyEntity } from "./types-YLu40dXY.mjs";
+import { t as Input } from "./input-DcbOSbQr.mjs";
+import * as react639 from "react";
 import { AccessorKeyColumnDef, CellContext, Column, ColumnPinningPosition, ColumnPinningState, Header, HeaderGroup, Row, RowSelectionState, Table } from "@tanstack/react-table";
 import { VirtualItem, Virtualizer } from "@tanstack/react-virtual";
 
@@ -30,18 +30,7 @@ declare const UITableBadgeDisplay: React.FC<{
 }>;
 //#endregion
 //#region packages/components/features/tables/components/atoms/boolean-display.d.ts
-/**
- * Displays a green check icon for `true`, a red X icon for `false`, and a
- * double-dash placeholder via {@link UITableEmpty} when the value is
- * `null` or `undefined`.
- *
- * @example
- * import { UITableBooleanDisplay } from '@customafk/lunas-ui/features/tables';
- *
- * <UITableBooleanDisplay value={isActive} />
- */
 declare const UITableBooleanDisplay: React.FC<{
-  /** The boolean value to visualise; `null`/`undefined` renders an empty state. */
   value: boolean | null | undefined;
 }>;
 //#endregion
@@ -75,14 +64,14 @@ type Props$7 = {
  *
  * <UITableCurrencyDisplay value={1234.5} currency="USD" colorize />
  */
-declare const UITableCurrencyDisplay: react690.MemoExoticComponent<({
+declare const UITableCurrencyDisplay: react639.MemoExoticComponent<({
   value,
   currency,
   locale,
   display,
   size,
   colorize
-}: Props$7) => react690.JSX.Element>;
+}: Props$7) => react639.JSX.Element>;
 //#endregion
 //#region packages/components/features/tables/components/atoms/date-display.d.ts
 /** Props for the {@link UITableDateDisplay} component. */
@@ -272,12 +261,12 @@ type Props$3 = {
  *
  * <UITableProgressDisplay value={75} />
  */
-declare const UITableProgressDisplay: react690.MemoExoticComponent<({
+declare const UITableProgressDisplay: react639.MemoExoticComponent<({
   value,
   showLabel,
   successThreshold,
   warningThreshold
-}: Props$3) => react690.JSX.Element>;
+}: Props$3) => react639.JSX.Element>;
 //#endregion
 //#region packages/components/features/tables/components/atoms/remove-button.d.ts
 /**
@@ -331,7 +320,7 @@ type Props$2 = {
  *
  * <UITableStatisticDisplay value={1234567.89} precision={2} prefix="$" size="md" />
  */
-declare const UITableStatisticDisplay: react690.MemoExoticComponent<({
+declare const UITableStatisticDisplay: react639.MemoExoticComponent<({
   decimalSeparator,
   groupSeparator,
   prefix: Prefix,
@@ -341,7 +330,7 @@ declare const UITableStatisticDisplay: react690.MemoExoticComponent<({
   showTrailingZeros,
   size,
   value
-}: Props$2) => react690.JSX.Element>;
+}: Props$2) => react639.JSX.Element>;
 //#endregion
 //#region packages/components/features/tables/components/atoms/status-display.d.ts
 type BadgeColor = 'primary' | 'secondary' | 'muted' | 'accent' | 'info' | 'success' | 'warning' | 'danger';
@@ -544,8 +533,8 @@ type TUITableCell = React.ComponentProps<'td'> & {
   /** Returns the `CellContext` passed to `flexRender`. */
   getContext: () => CellContext<unknown, unknown>;
 };
-/** Props for `UITableFooter` — all native `<tfoot>` attributes are forwarded. */
-type TUITableFooter = React.PropsWithChildren<React.ComponentProps<'tfoot'>>;
+/** Props for `UITableFooter` — rendered as a `<div>` below the scroll container. */
+type TUITableFooter = React.PropsWithChildren<React.ComponentProps<'div'>>;
 /** Props for `UITableLoadMore` — the append-row "load more" trigger. */
 type TUITableLoadMore = React.PropsWithChildren<React.ComponentProps<'tr'> & {
   /** Virtual index of this synthetic row (appended after the last data row). */
@@ -558,6 +547,21 @@ type TUITableLoadMore = React.PropsWithChildren<React.ComponentProps<'tr'> & {
    */
   fetchMoreData?: () => void | Promise<void>;
 }>;
+/** Aggregation function types supported by `UITableFooterRow`. */
+type ColumnAggregationType = 'sum' | 'avg' | 'count' | 'min' | 'max';
+/** Per-column aggregation config placed in `TUITableColumn.meta.aggregation`. */
+type ColumnAggregation = {
+  /** Which aggregation to compute from the column's numeric values. */
+  type: ColumnAggregationType;
+  /** Override label shown in the analysis panel. Defaults to the column header text. */
+  label?: string;
+  /** Optional prefix rendered before the computed value (e.g. `'$'`). */
+  prefix?: string;
+  /** Optional suffix rendered after the computed value (e.g. `'%'`). */
+  suffix?: string;
+  /** Decimal precision for the formatted result. */
+  precision?: number;
+};
 /**
  * Typed column definition accepted by `UITableProvider`.
  *
@@ -570,8 +574,34 @@ type TUITableColumn<TData extends RowData<TData>> = Pick<AccessorKeyColumnDef<TD
     position?: 'start' | 'center' | 'end';
     /** When `true`, the cell auto-expands to fit its rendered content width. */
     fitContent?: boolean;
+    /** When set, renders an aggregated value in the footer row for this column. */
+    aggregation?: ColumnAggregation;
   };
 };
+/** A single KPI tile displayed in `UITableSummaryBar`. */
+type SummaryItem = {
+  /** Short label displayed above the value. */
+  label: string;
+  /** The numeric or string value to display. */
+  value: number | string | null;
+  /** Optional prefix rendered before the value (e.g. `'$'`). */
+  prefix?: string;
+  /** Optional suffix rendered after the value (e.g. `'%'`). */
+  suffix?: string;
+  /** Decimal precision for numeric values. */
+  precision?: number;
+  /** Colour trend indicator. */
+  trend?: 'neutral' | 'up' | 'down';
+  /** Secondary description text rendered below the value. */
+  description?: string;
+};
+/** Context value provided by the analysis panel toggle state. */
+type TTableAnalysisContext = {
+  /** Whether the analysis panel is currently expanded. */
+  isOpen: boolean;
+  /** Toggles the analysis panel open/closed. */
+  toggle: () => void;
+};
 /** A single cell in a CSV export row. */
 type CsvCell = {
   /** Column header label for this cell. */
@@ -612,6 +642,10 @@ type TTableContext<TData extends RowData<TData>> = {
   filterDefinitions?: FilterDefinition[];
   /** Called with the full list of active filters whenever filters are added, removed, or updated. */
   onFilterChange?: (filters: ActiveFilter[]) => void;
+  /** KPI stat cards displayed in `UITableSummaryBar` above the toolbar. */
+  summary?: SummaryItem[];
+  /** When `true`, a toggle button appears in `UITableTooltipActions` to open `UITableAnalysisPanel`. */
+  showAnalysisPanel?: boolean;
 };
 /** Context value provided by `UITableInnerWrapperProvider`. */
 type TTableInnerWrapperContext = {
@@ -740,6 +774,10 @@ type TableProviderProps<TData extends RowData<TData>, TKey extends keyof TData =
   filterDefinitions?: FilterDefinition[];
   /** Called with the full list of active filters whenever filters are added, removed, or updated. */
   onFilterChange?: (filters: ActiveFilter[]) => void;
+  /** KPI stat cards displayed in `UITableSummaryBar` above the toolbar. */
+  summary?: SummaryItem[];
+  /** When `true`, a toggle button appears in `UITableTooltipActions` to open `UITableAnalysisPanel`. */
+  showAnalysisPanel?: boolean;
 };
 type FilterType = 'tag' | 'single-tag' | 'date-range' | 'number' | 'text' | 'boolean';
 /** A selectable option for tag/enum filters. */
@@ -805,56 +843,62 @@ type TTableFilterContext = {
 };
 //#endregion
 //#region packages/components/features/tables/components/commons/body.d.ts
-declare const UITableBody: react690.NamedExoticComponent<TUITableBody>;
+declare const UITableBody: react639.NamedExoticComponent<TUITableBody>;
 //#endregion
 //#region packages/components/features/tables/components/commons/cell.d.ts
-declare const UITableCell: react690.NamedExoticComponent<TUITableCell>;
+declare const UITableCell: react639.NamedExoticComponent<TUITableCell>;
 //#endregion
 //#region packages/components/features/tables/components/commons/cell-actions.d.ts
-declare const UITableCellActions: react690.NamedExoticComponent<TUITableCellActions>;
+declare const UITableCellActions: react639.NamedExoticComponent<TUITableCellActions>;
 //#endregion
 //#region packages/components/features/tables/components/commons/cell-select.d.ts
-declare const UITableCellSelect: react690.NamedExoticComponent<TUITableCellSelect>;
+declare const UITableCellSelect: react639.NamedExoticComponent<TUITableCellSelect>;
 //#endregion
 //#region packages/components/features/tables/components/commons/empty-display.d.ts
-declare const UITableEmptyDisplay: react690.NamedExoticComponent<TUITableEmptyDisplay>;
+declare const UITableEmptyDisplay: react639.NamedExoticComponent<TUITableEmptyDisplay>;
 //#endregion
 //#region packages/components/features/tables/components/commons/footer.d.ts
-declare const UITableFooter: react690.NamedExoticComponent<TUITableFooter>;
+declare const UITableFooter: react639.NamedExoticComponent<TUITableFooter>;
+//#endregion
+//#region packages/components/features/tables/components/commons/footer-row.d.ts
+declare const UITableFooterRow: react639.MemoExoticComponent<() => react639.JSX.Element | null>;
 //#endregion
 //#region packages/components/features/tables/components/commons/head.d.ts
-declare const UITableHead: react690.NamedExoticComponent<TUITableHead>;
+declare const UITableHead: react639.NamedExoticComponent<TUITableHead>;
 //#endregion
 //#region packages/components/features/tables/components/commons/head-cell.d.ts
-declare const UITableHeadCell: react690.NamedExoticComponent<TUITableHeadCell>;
+declare const UITableHeadCell: react639.NamedExoticComponent<TUITableHeadCell>;
 //#endregion
 //#region packages/components/features/tables/components/commons/head-cell-option.d.ts
-declare const UITableHeadCellOption: react690.NamedExoticComponent<TUITableHeadCellOption>;
+declare const UITableHeadCellOption: react639.NamedExoticComponent<TUITableHeadCellOption>;
 //#endregion
 //#region packages/components/features/tables/components/commons/head-cell-select.d.ts
-declare const UITableHeadCellSelect: react690.NamedExoticComponent<TUITableHeadCellSelect>;
+declare const UITableHeadCellSelect: react639.NamedExoticComponent<TUITableHeadCellSelect>;
 //#endregion
 //#region packages/components/features/tables/components/commons/head-row.d.ts
-declare const UITableHeadRow: react690.NamedExoticComponent<TUITableHeadRow>;
+declare const UITableHeadRow: react639.NamedExoticComponent<TUITableHeadRow>;
 //#endregion
 //#region packages/components/features/tables/components/commons/inner-table.d.ts
-declare const UITableInnerTable: react690.NamedExoticComponent<TUITableInnerTable>;
+declare const UITableInnerTable: react639.NamedExoticComponent<TUITableInnerTable>;
 //#endregion
 //#region packages/components/features/tables/components/commons/inner-wrapper.d.ts
-declare const UITableInnerWrapper: react690.NamedExoticComponent<TUITableInnerWrapper>;
+declare const UITableInnerWrapper: react639.NamedExoticComponent<TUITableInnerWrapper>;
 //#endregion
 //#region packages/components/features/tables/components/commons/load-more.d.ts
-declare const UITableLoadMore: react690.NamedExoticComponent<TUITableLoadMore>;
+declare const UITableLoadMore: react639.NamedExoticComponent<TUITableLoadMore>;
 //#endregion
 //#region packages/components/features/tables/components/commons/row.d.ts
-declare const UITableRow: react690.NamedExoticComponent<TUITableRow>;
+declare const UITableRow: react639.NamedExoticComponent<TUITableRow>;
 //#endregion
 //#region packages/components/features/tables/components/commons/wrapper.d.ts
-declare const UITableWrapper: react690.NamedExoticComponent<TUITableWrapper>;
+declare const UITableWrapper: react639.NamedExoticComponent<TUITableWrapper>;
 //#endregion
 //#region packages/components/features/tables/components/table.d.ts
 declare const UITableContainer: React.FC<React.PropsWithChildren>;
 //#endregion
+//#region packages/components/features/tables/components/table/analysis-panel.d.ts
+declare const UITableAnalysisPanel: react639.MemoExoticComponent<() => react639.JSX.Element>;
+//#endregion
 //#region packages/components/features/tables/components/table/filter.d.ts
 /**
  * Collapsible side-panel that lets users toggle column visibility and build
@@ -884,7 +928,7 @@ declare const UITableContainer: React.FC<React.PropsWithChildren>;
  * </UITableProvider>
  * ```
  */
-declare const UITableFilter: () => react690.JSX.Element;
+declare const UITableFilter: () => react639.JSX.Element;
 //#endregion
 //#region packages/components/features/tables/components/table/provider.d.ts
 /**
@@ -940,8 +984,13 @@ declare const UITableProvider: <TData extends RowData<TData> = RowData<AnyEntity
   csvFileName,
   filterDefinitions,
   onFilterChange,
+  summary,
+  showAnalysisPanel,
   children
-}: React.PropsWithChildren<TableProviderProps<TData, TKey, TColumns>>) => react690.JSX.Element;
+}: React.PropsWithChildren<TableProviderProps<TData, TKey, TColumns>>) => react639.JSX.Element;
+//#endregion
+//#region packages/components/features/tables/components/table/summary-bar.d.ts
+declare const UITableSummaryBar: react639.MemoExoticComponent<() => react639.JSX.Element | null>;
 //#endregion
 //#region packages/components/features/tables/components/table/tooltip.d.ts
 /**
@@ -1008,5 +1057,5 @@ declare const UITableTooltipActions: React.FC<{
  */
 declare const UITableTooltip: React.FC<React.PropsWithChildren>;
 //#endregion
-export { TUITableHeadRow as $, FilterValue as A, TTableRowContext as B, ActiveFilter as C, UITableBadgeDisplay as Ct, FilterDefinition as D, DateRangeFilterValue as E, TTableContext as F, TUITableCellSelect as G, TUITableBody as H, TTableFilterContext as I, TUITableFooter as J, TUITableColumn as K, TTableHeadRowContext as L, RowData as M, SingleTagFilterValue as N, FilterOption as O, TTableBodyContext as P, TUITableHeadCellSelect as Q, TTableInnerTableContext as R, UITableBody as S, UITableBooleanDisplay as St, CsvCell as T, TUITableCell as U, TTableVirtualizerContext as V, TUITableCellActions as W, TUITableHeadCell as X, TUITableHead as Y, TUITableHeadCellOption as Z, UITableFooter as _, UITableListDisplay as _t, UITableFilter as a, TableProviderProps as at, UITableCellActions as b, UITableDateDisplay as bt, UITableRow as c, UITableUserDataDisplay as ct, UITableInnerTable as d, UITableRemoveButton as dt, TUITableInnerTable as et, UITableHeadRow as f, UITableProgressDisplay as ft, UITableHead as g, UITableMoreButton as gt, UITableHeadCell as h, UITableNameDisplay as ht, UITableProvider as i, TUITableWrapper as it, NumberFilterValue as j, FilterType as k, UITableLoadMore as l, UITableStatusDisplay as lt, UITableHeadCellOption as m, UITablePermalink as mt, UITableTooltipActions as n, TUITableLoadMore as nt, UITableContainer as o, TagFilterValue as ot, UITableHeadCellSelect as p, UITablePhoneNumberDisplay as pt, TUITableEmptyDisplay as q, UITableTooltipFilter as r, TUITableRow as rt, UITableWrapper as s, TextFilterValue as st, UITableTooltip as t, TUITableInnerWrapper as tt, UITableInnerWrapper as u, UITableStatisticDisplay as ut, UITableEmptyDisplay as v, UITableEmailDisplay as vt, BooleanFilterValue as w, UITableCell as x, UITableCurrencyDisplay as xt, UITableCellSelect as y, UITableDescriptionDisplay as yt, TTableInnerWrapperContext as z };
-//# sourceMappingURL=index-B0tpV7YG.d.cts.map
+export { TUITableColumn as $, CsvCell as A, UITableBadgeDisplay as At, TTableAnalysisContext as B, UITableCellActions as C, UITableMoreButton as Ct, BooleanFilterValue as D, UITableDateDisplay as Dt, ActiveFilter as E, UITableDescriptionDisplay as Et, FilterValue as F, TTableInnerTableContext as G, TTableContext as H, NumberFilterValue as I, TTableVirtualizerContext as J, TTableInnerWrapperContext as K, RowData as L, FilterDefinition as M, FilterOption as N, ColumnAggregation as O, UITableCurrencyDisplay as Ot, FilterType as P, TUITableCellSelect as Q, SingleTagFilterValue as R, UITableCellSelect as S, UITableNameDisplay as St, UITableBody as T, UITableEmailDisplay as Tt, TTableFilterContext as U, TTableBodyContext as V, TTableHeadRowContext as W, TUITableCell as X, TUITableBody as Y, TUITableCellActions as Z, UITableHeadCell as _, UITableStatisticDisplay as _t, UITableProvider as a, TUITableHeadCellSelect as at, UITableFooter as b, UITablePhoneNumberDisplay as bt, UITableContainer as c, TUITableInnerWrapper as ct, UITableLoadMore as d, TUITableWrapper as dt, TUITableEmptyDisplay as et, UITableInnerWrapper as f, TableProviderProps as ft, UITableHeadCellOption as g, UITableStatusDisplay as gt, UITableHeadCellSelect as h, UITableUserDataDisplay as ht, UITableSummaryBar as i, TUITableHeadCellOption as it, DateRangeFilterValue as j, ColumnAggregationType as k, UITableBooleanDisplay as kt, UITableWrapper as l, TUITableLoadMore as lt, UITableHeadRow as m, TextFilterValue as mt, UITableTooltipActions as n, TUITableHead as nt, UITableFilter as o, TUITableHeadRow as ot, UITableInnerTable as p, TagFilterValue as pt, TTableRowContext as q, UITableTooltipFilter as r, TUITableHeadCell as rt, UITableAnalysisPanel as s, TUITableInnerTable as st, UITableTooltip as t, TUITableFooter as tt, UITableRow as u, TUITableRow as ut, UITableHead as v, UITableRemoveButton as vt, UITableCell as w, UITableListDisplay as wt, UITableEmptyDisplay as x, UITablePermalink as xt, UITableFooterRow as y, UITableProgressDisplay as yt, SummaryItem as z };
+//# sourceMappingURL=index-C45OSg1W.d.mts.map