@hybridcore/ui 1.6.26 → 1.6.27

package/dist/components/status-indicator/logic.js

@@ -1,7 +1,8 @@
-import { useThemeProps as u } from "@mui/material";
-import { a as w, b as k, I as v } from "../../IconTrendingUp-CW4SFYmc.js";
+import { useThemeProps as w } from "@mui/material";
+import { a as g, b as I, I as m } from "../../IconTrendingUp-CW4SFYmc.js";
 import { c as n } from "../../createReactComponent-C7L-DMHj.js";
-import { I } from "../../IconMinus-B6OPYVyo.js";
+import { I as k } from "../../IconMinus-B6OPYVyo.js";
+import { I as v, a as C } from "../../IconCheck-BcUcbvno.js";
 import { I as y } from "../../IconCircle-HcgE1lHy.js";
 /**
  * @license @tabler/icons-react v3.44.0 - MIT
@@ -9,28 +10,21 @@ import { I as y } from "../../IconCircle-HcgE1lHy.js";
  * This source code is licensed under the MIT license.
  * See the LICENSE file in the root directory of this source tree.
  */
-const M = [["path", { d: "M12 9v4", key: "svg-0" }], ["path", { d: "M10.363 3.591l-8.106 13.534a1.914 1.914 0 0 0 1.636 2.871h16.214a1.914 1.914 0 0 0 1.636 -2.87l-8.106 -13.536a1.914 1.914 0 0 0 -3.274 0", key: "svg-1" }], ["path", { d: "M12 16h.01", key: "svg-2" }]], m = n("outline", "alert-triangle", "AlertTriangle", M);
+const M = [["path", { d: "M12 5l0 14", key: "svg-0" }], ["path", { d: "M18 13l-6 6", key: "svg-1" }], ["path", { d: "M6 13l6 6", key: "svg-2" }]], _ = n("outline", "arrow-down", "ArrowDown", M);
 /**
  * @license @tabler/icons-react v3.44.0 - MIT
  *
  * This source code is licensed under the MIT license.
  * See the LICENSE file in the root directory of this source tree.
  */
-const C = [["path", { d: "M12 5l0 14", key: "svg-0" }], ["path", { d: "M18 13l-6 6", key: "svg-1" }], ["path", { d: "M6 13l6 6", key: "svg-2" }]], _ = n("outline", "arrow-down", "ArrowDown", C);
+const $ = [["path", { d: "M12 5l0 14", key: "svg-0" }], ["path", { d: "M18 11l-6 -6", key: "svg-1" }], ["path", { d: "M6 11l6 -6", key: "svg-2" }]], f = n("outline", "arrow-up", "ArrowUp", $);
 /**
  * @license @tabler/icons-react v3.44.0 - MIT
  *
  * This source code is licensed under the MIT license.
  * See the LICENSE file in the root directory of this source tree.
  */
-const $ = [["path", { d: "M12 5l0 14", key: "svg-0" }], ["path", { d: "M18 11l-6 -6", key: "svg-1" }], ["path", { d: "M6 11l6 -6", key: "svg-2" }]], N = n("outline", "arrow-up", "ArrowUp", $);
-/**
- * @license @tabler/icons-react v3.44.0 - MIT
- *
- * This source code is licensed under the MIT license.
- * See the LICENSE file in the root directory of this source tree.
- */
-const b = [["path", { d: "M3 12a9 9 0 1 0 18 0a9 9 0 1 0 -18 0", key: "svg-0" }], ["path", { d: "M5.7 5.7l12.6 12.6", key: "svg-1" }]], f = n("outline", "ban", "Ban", b);
+const b = [["path", { d: "M3 12a9 9 0 1 0 18 0a9 9 0 1 0 -18 0", key: "svg-0" }], ["path", { d: "M5.7 5.7l12.6 12.6", key: "svg-1" }]], N = n("outline", "ban", "Ban", b);
 /**
  * @license @tabler/icons-react v3.44.0 - MIT
  *
@@ -44,42 +38,35 @@ const A = [["path", { d: "M6 10l6 6l6 -6h-12", key: "svg-0" }]], D = n("outline"
  * This source code is licensed under the MIT license.
  * See the LICENSE file in the root directory of this source tree.
  */
-const L = [["path", { d: "M18 14l-6 -6l-6 6h12", key: "svg-0" }]], T = n("outline", "caret-up", "CaretUp", L);
-/**
- * @license @tabler/icons-react v3.44.0 - MIT
- *
- * This source code is licensed under the MIT license.
- * See the LICENSE file in the root directory of this source tree.
- */
-const U = [["path", { d: "M5 12l5 5l10 -10", key: "svg-0" }]], B = n("outline", "check", "Check", U);
+const L = [["path", { d: "M18 14l-6 -6l-6 6h12", key: "svg-0" }]], U = n("outline", "caret-up", "CaretUp", L);
 /**
  * @license @tabler/icons-react v3.44.0 - MIT
  *
  * This source code is licensed under the MIT license.
  * See the LICENSE file in the root directory of this source tree.
  */
-const H = [["path", { d: "M3 12a9 9 0 1 0 18 0a9 9 0 0 0 -18 0", key: "svg-0" }], ["path", { d: "M12 16v.01", key: "svg-1" }], ["path", { d: "M12 13a2 2 0 0 0 .914 -3.782a1.98 1.98 0 0 0 -2.414 .483", key: "svg-2" }]], R = n("outline", "help-circle", "HelpCircle", H), x = {
-  "trending-up": w,
-  "trending-down": k,
-  "arrow-right": v,
-  "arrow-up": N,
+const T = [["path", { d: "M3 12a9 9 0 1 0 18 0a9 9 0 0 0 -18 0", key: "svg-0" }], ["path", { d: "M12 16v.01", key: "svg-1" }], ["path", { d: "M12 13a2 2 0 0 0 .914 -3.782a1.98 1.98 0 0 0 -2.414 .483", key: "svg-2" }]], B = n("outline", "help-circle", "HelpCircle", T), H = {
+  "trending-up": g,
+  "trending-down": I,
+  "arrow-right": m,
+  "arrow-up": f,
   "arrow-down": _,
-  "caret-up": T,
+  "caret-up": U,
   "caret-down": D,
-  minus: I,
-  ban: f,
-  help: R,
-  check: B,
-  alert: m,
+  minus: k,
+  ban: N,
+  help: B,
+  check: v,
+  alert: C,
   circle: y
-}, z = (p) => {
-  const t = u({ props: p, name: "HCStatusIndicator" }), {
-    value: e,
-    states: d = [],
+}, q = (p) => {
+  const t = w({ props: p, name: "HCStatusIndicator" }), {
+    value: r,
+    states: i = [],
     variant: c = "prominent",
     showIcon: s = !0,
     emptyLabel: a = "—"
-  } = t, r = e != null && `${e}`.trim() !== "", o = r ? d.find((g) => `${g.value}`.toLowerCase() === `${e}`.toLowerCase()) : void 0, l = (o == null ? void 0 : o.label) ?? (r ? `${e}` : a), i = s && (o != null && o.icon) ? x[o.icon] : void 0, h = {
+  } = t, e = r != null && `${r}`.trim() !== "", o = e ? i.find((h) => `${h.value}`.toLowerCase() === `${r}`.toLowerCase()) : void 0, l = (o == null ? void 0 : o.label) ?? (e ? `${r}` : a), d = s && (o != null && o.icon) ? H[o.icon] : void 0, u = {
     ...t,
     variant: c,
     showIcon: s,
@@ -87,19 +74,19 @@ const H = [["path", { d: "M3 12a9 9 0 1 0 18 0a9 9 0 0 0 -18 0", key: "svg-0" }]
     activeLabel: l,
     resolvedColor: o == null ? void 0 : o.color,
     resolvedBackgroundColor: o == null ? void 0 : o.backgroundColor,
-    hasValue: r
+    hasValue: e
   };
   return {
     refs: {},
     state: {
-      ownerState: h,
+      ownerState: u,
       variant: c,
       activeLabel: l,
-      Icon: i
+      Icon: d
     },
     actions: {}
   };
 };
 export {
-  z as useStatusIndicatorLogic
+  q as useStatusIndicatorLogic
 };

package/dist/main.d.ts

@@ -515,6 +515,169 @@ extends Omit<DataGridProps_2, "rows" | "columns"> {
     sx?: SxProps<Theme>;
 }
 
+export declare const DataList: (props: DataListProps) => JSX_2.Element;
+
+/**
+ * One entry in the badge state map: which raw status value renders which pill.
+ * Matched case-insensitively against `item.status`. Mirrors `DataListIconState`
+ * so both maps are authored the same way in widget config.
+ */
+export declare interface DataListBadgeState {
+    value: string;
+    label?: string;
+    color?: string;
+    backgroundColor?: string;
+    /** Set for the outlined chip style; omit for the filled-tint style. */
+    borderColor?: string;
+}
+
+export declare type DataListComponentOverride<Theme = unknown> = {
+    defaultProps?: DataListProps;
+    styleOverrides?: ComponentsOverrides<Theme>["HCDataList"];
+};
+
+export declare type DataListEndSlot = "none" | "badge" | "progress" | "text";
+
+export declare type DataListIconName =
+| "shield"
+| "shield-alert"
+| "alert-triangle"
+| "alert-circle"
+| "info"
+| "bell"
+| "check"
+| "clock"
+| "flag"
+| "file"
+| "map-pin"
+| "message"
+| "thumb-up"
+| "users"
+| "circle";
+
+export declare type DataListIconShape = "circle" | "rounded" | "plain";
+
+/**
+ * One entry in the leading-icon state map: which raw value renders which icon and
+ * tint. Matched case-insensitively against `item.iconValue`.
+ *
+ * `color` / `backgroundColor` accept a theme-token path ("error.main") or a raw CSS
+ * color ("#f00"), resolved via `resolvePaletteColor`.
+ */
+export declare interface DataListIconState {
+    value: string;
+    icon?: DataListIconName;
+    color?: string;
+    backgroundColor?: string;
+    /** Accessible name for the icon — read by screen readers, shown as the tooltip. */
+    label?: string;
+}
+
+export declare interface DataListItem {
+    id: string | number;
+    title: string;
+    /**
+     * Secondary line assembled from several fields — "District 3 • Maya Rousseau •
+     * Oct 19, 2026". Empty, null and undefined segments are dropped so a missing
+     * field never leaves a dangling separator. Takes precedence over `description`.
+     */
+    meta?: (string | number | null | undefined)[];
+    /** Secondary line as a single pre-composed string. Used when `meta` is absent. */
+    description?: string;
+    /** Matched against `iconStates` to pick the leading icon. */
+    iconValue?: string;
+    /** Leading-icon escape hatch for code callers. Wins over `iconValue`. */
+    icon?: ReactNode;
+    /** Matched against `badgeStates` when `endSlot` is "badge". */
+    status?: string;
+    /** Bar percentage (0–100) for `endSlot` "progress", or the text for "text". */
+    endValue?: number | string;
+    /** Short label beside the trailing slot, e.g. the "78%" next to a progress bar. */
+    endLabel?: string;
+    /** Trailing-slot escape hatch for code callers. Wins over `endSlot`. */
+    endContent?: ReactNode;
+    disabled?: boolean;
+}
+
+/**
+ * How the list reaches rows beyond the first screenful.
+ *
+ * - `infinite` — rows load as the user scrolls (default).
+ * - `buttons` — a `TablePagination` footer.
+ * - `none` — whatever is in `data` is all there is.
+ */
+export declare type DataListPaginationMode = "infinite" | "buttons" | "none";
+
+export declare interface DataListProps {
+    title?: string;
+    /** Header action link, e.g. "View all". Rendered only when a handler or href is set. */
+    actionLabel?: string;
+    actionHref?: string;
+    onActionClick?: () => void;
+    /**
+     * Header-action escape hatch — pass the widget menu here to seat it in the header
+     * row. Wins over `actionLabel`.
+     */
+    headerAction?: ReactNode;
+    /**
+     * Reserve space at the right edge of the header for chrome drawn *over* the
+     * component — the widget store's floating menu trigger sits at `top/right: 8px`
+     * and would otherwise cover the title or the action link. `true` reserves enough
+     * for the trigger; a number reserves that many pixels.
+     */
+    headerGutter?: boolean | number;
+
+    data: DataListItem[];
+    /** Row count on the server. Required for server-side paging (with `onChange`). */
+    totalCount?: number;
+    payload?: Partial<FV.SearchDTO>;
+    /** Set for server-side paging: the component stops slicing `data` itself. */
+    onChange?: (params: Partial<FV.SearchDTO>) => void;
+    onItemClick?: (item: DataListItem) => void;
+
+    /** Value → icon/tint map for the leading slot. */
+    iconStates?: DataListIconState[];
+    iconShape?: DataListIconShape;
+    /** Value → label/tint map for the trailing badge. */
+    badgeStates?: DataListBadgeState[];
+    endSlot?: DataListEndSlot;
+    /** Per-row leading-slot renderer. Wins over `icon` / `iconValue`. */
+    renderItemStart?: (item: DataListItem) => ReactNode;
+    /** Per-row trailing-slot renderer. Wins over `endContent` / `endSlot`. */
+    renderItemEnd?: (item: DataListItem) => ReactNode;
+
+    /** Joins `item.meta` segments. */
+    metaSeparator?: string;
+    /** Line clamp on the secondary line. 0 leaves it unclamped. */
+    descriptionLines?: number;
+    dense?: boolean;
+    divider?: boolean;
+    paginationMode?: DataListPaginationMode;
+    /** Rows revealed per scroll step, or per page in `buttons` mode. */
+    rowsPerPage?: number;
+    /** `buttons` mode only. */
+    rowsPerPageOptions?: number[];
+    /**
+     * Infinite scroll with server paging accumulates the pages it receives. Change
+     * this whenever the query behind `data` changes — a new filter, sort or search —
+     * and the accumulated rows are dropped so the list restarts at the first page.
+     */
+    resetKey?: string | number;
+    /** Set while a `onChange` page request is in flight, to draw the footer spinner. */
+    loadingMore?: boolean;
+    emptyMessage?: string;
+    loading?: boolean;
+    /** Skeleton rows drawn while `loading`. */
+    loadingRows?: number;
+    sx?: SxProps<Theme>;
+}
+
+/** Shape read off `data-snapshot` by the widget canvas when exporting a report. */
+export declare interface DataListSnapshot {
+    title?: string;
+    data: DataListItem[];
+}
+
 export declare const DataMap: (inProps: DataMapProps) => JSX_2.Element;
 
 export declare type DataMapComponentOverride<Theme = unknown> = {
@@ -3070,6 +3233,88 @@ declare module "@mui/material/styles" {
 
 
 
+declare module "@mui/material/styles" {
+  interface ComponentNameToClassKey {
+    HCLinearIndicator:
+      | "root"
+      | "barContainer"
+      | "barBackground"
+      | "bar"
+      | "middleContainer"
+      | "middle";
+  }
+
+  interface ComponentsPropsList {
+    HCLinearIndicator: LinearIndicatorProps;
+  }
+
+  interface Components<Theme = unknown> {
+    HCLinearIndicator?: LinearIndicatorComponentOverride<Theme>;
+  }
+}
+
+
+
+declare module "@mui/material/styles" {
+  interface ComponentNameToClassKey {
+    HCDataList:
+      | "root"
+      | "header"
+      | "headerAction"
+      | "content"
+      | "list"
+      | "item"
+      | "itemButton"
+      | "itemStart"
+      | "itemMain"
+      | "itemTitle"
+      | "itemMeta"
+      | "itemEnd"
+      | "badge"
+      | "empty"
+      | "loadMore"
+      | "pagination";
+  }
+
+  interface ComponentsPropsList {
+    HCDataList: DataListProps;
+  }
+
+  interface Components<Theme = unknown> {
+    HCDataList?: DataListComponentOverride<Theme>;
+  }
+}
+
+
+
+declare module "@mui/material/styles" {
+  interface ComponentNameToClassKey {
+    HCMetricCard:
+      | "root"
+      | "content"
+      | "label"
+      | "value"
+      | "secondValue"
+      | "trendContainer"
+      | "description"
+      | "icon"
+      | "cornerIcon"
+      | "chart"
+      | "panel"
+      | "sideChart";
+  }
+
+  interface ComponentsPropsList {
+    HCMetricCard: MetricCardProps;
+  }
+
+  interface Components<Theme = unknown> {
+    HCMetricCard?: MetricCardComponentOverride<Theme>;
+  }
+}
+
+
+
 declare namespace MAP {
   interface Coordinate {
     latitude: number;
@@ -3617,56 +3862,6 @@ declare module "@mui/material/styles" {
 
 
 
-declare module "@mui/material/styles" {
-  interface ComponentNameToClassKey {
-    HCLinearIndicator:
-      | "root"
-      | "barContainer"
-      | "barBackground"
-      | "bar"
-      | "middleContainer"
-      | "middle";
-  }
-
-  interface ComponentsPropsList {
-    HCLinearIndicator: LinearIndicatorProps;
-  }
-
-  interface Components<Theme = unknown> {
-    HCLinearIndicator?: LinearIndicatorComponentOverride<Theme>;
-  }
-}
-
-
-
-declare module "@mui/material/styles" {
-  interface ComponentNameToClassKey {
-    HCMetricCard:
-      | "root"
-      | "content"
-      | "label"
-      | "value"
-      | "secondValue"
-      | "trendContainer"
-      | "description"
-      | "icon"
-      | "cornerIcon"
-      | "chart"
-      | "panel"
-      | "sideChart";
-  }
-
-  interface ComponentsPropsList {
-    HCMetricCard: MetricCardProps;
-  }
-
-  interface Components<Theme = unknown> {
-    HCMetricCard?: MetricCardComponentOverride<Theme>;
-  }
-}
-
-
-
 declare module "@mui/material/styles" {
   interface ComponentNameToClassKey {
     HCObjectProfileCard: