@burdenoff/microfe-bigconsole 2026.1008.14 → 2026.1009.10

package/dist/bigconsole/pages/PipelinesPage.js

@@ -1,26 +1,28 @@
 import { usePipelineStore as e } from "../store/pipelineStore.js";
 import { useAppNavigate as t } from "../contexts/NavigationContext.js";
 import "../contexts/index.js";
-import { SECTION_FOCUS_RING as n, sectionSurfaceClasses as r } from "../components/common/sectionStyles.js";
-import { Section as i, SectionStack as a } from "../components/common/Section.js";
+import { SECTION_FOCUS_RING as ee, sectionSurfaceClasses as te } from "../components/common/sectionStyles.js";
+import { Section as n, SectionStack as ne } from "../components/common/Section.js";
 import "../components/common/index.js";
-import ee from "../hooks/usePipelineOperations.js";
-import { BIGCONSOLE_PERMISSIONS as o } from "../../constants/permissions.js";
-import { isNative as s, nativeNotify as c } from "../../utils/nativeBridge.js";
-import { PipelineScopePicker as l } from "../components/pipeline/PipelineScopePicker.js";
-import te from "../components/pipeline/PipelineDeleteDialog.js";
-import ne from "../components/pipeline/PipelineCard.js";
-import { memo as u, useCallback as d, useMemo as f, useState as p } from "react";
-import { useSearchParams as m } from "react-router";
-import { AccessDenied as h, PermissionButton as g } from "@burdenoff/fe-libs/shared/components";
-import { usePermissions as _ } from "@burdenoff/fe-libs/shared/providers/shell";
-import { AlertCircle as v, GitBranch as y, LayoutGrid as b, List as re, Plus as x, Search as ie } from "lucide-react";
-import { AuroraBackground as ae, Button as S, GradientText as oe, IllustratedEmptyState as se, Input as ce, PagePurpose as le, Spinner as C } from "@burdenoff/fe-libs/ui";
-import { useI18n as ue } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+import re from "../hooks/usePipelineOperations.js";
+import { BIGCONSOLE_PERMISSIONS as r } from "../../constants/permissions.js";
+import { isNative as i, nativeNotify as a } from "../../utils/nativeBridge.js";
+import { pipelinesListControls as o } from "../assistant/pageControls.js";
+import { PipelineScopePicker as s } from "../components/pipeline/PipelineScopePicker.js";
+import c from "../components/pipeline/PipelineDeleteDialog.js";
+import ie from "../components/pipeline/PipelineCard.js";
+import { memo as l, useCallback as u, useMemo as d, useState as f } from "react";
+import { useSearchParams as p } from "react-router";
+import { AccessDenied as m, PermissionButton as h } from "@burdenoff/fe-libs/shared/components";
+import { usePermissions as g } from "@burdenoff/fe-libs/shared/providers/shell";
+import { AlertCircle as _, GitBranch as ae, LayoutGrid as oe, List as se, Plus as v, Search as ce } from "lucide-react";
+import { AuroraBackground as le, Button as y, GradientText as b, IllustratedEmptyState as ue, Input as de, PagePurpose as x, Spinner as S } from "@burdenoff/fe-libs/ui";
+import { useI18n as C } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
 import { jsx as w, jsxs as T } from "react/jsx-runtime";
+import { useAssistantPageControls as fe } from "@burdenoff/fe-libs/shared/assistant/appControls/useAssistantControl";
 //#region src/bigconsole/pages/PipelinesPage.tsx
-var E = u(function() {
-	let u = t(), { t: E } = ue(), { hasPermission: D, isLoading: O } = _(), k = D(o.PIPELINE_READ), A = D(o.PIPELINE_UPDATE), j = D(o.PIPELINE_DELETE), M = D(o.PIPELINE_TEST), [N, P] = p("all"), [F, I] = m(), L = F.get("consoleId") || "default", [R, z] = p("grid"), B = e((e) => e.searchQuery), V = e((e) => e.setSearchQuery), H = e((e) => e.deleteDialogOpen), U = e((e) => e.currentPipeline), W = e((e) => e.openDeleteDialog), G = e((e) => e.closeDeleteDialog), { loading: K, error: q, pipelines: J, deletePipeline: Y, refetch: de } = ee({ consoleId: L }), X = f(() => {
+var E = l(function() {
+	let l = t(), { t: E } = C(), { hasPermission: D, isLoading: O } = g(), k = D(r.PIPELINE_READ), A = D(r.PIPELINE_UPDATE), j = D(r.PIPELINE_DELETE), M = D(r.PIPELINE_TEST), [N, P] = f("all"), [F, I] = p(), L = F.get("consoleId") || "default", [R, z] = f("grid"), B = e((e) => e.searchQuery), V = e((e) => e.setSearchQuery), H = e((e) => e.deleteDialogOpen), U = e((e) => e.currentPipeline), W = e((e) => e.openDeleteDialog), G = e((e) => e.closeDeleteDialog), { loading: K, error: q, pipelines: J, deletePipeline: Y, refetch: pe } = re({ consoleId: L }), X = d(() => {
 		let e = [...J];
 		if (N !== "all" && (e = e.filter((e) => e.status === N)), B.trim()) {
 			let t = B.toLowerCase();
@@ -31,23 +33,23 @@ var E = u(function() {
 		J,
 		N,
 		B
-	]), Z = d(() => {
-		u(`/pipelines/new?consoleId=${encodeURIComponent(L)}`);
-	}, [u, L]), fe = d((e) => {
-		u(`/pipelines/${e}`);
-	}, [u]), pe = d((e) => {
-		u(`/pipelines/${e}/edit`);
-	}, [u]), me = d((e) => {
-		u(`/pipelines/${e}?test=true`);
-	}, [u]), he = d((e) => {
+	]), Z = u(() => {
+		l(`/pipelines/new?consoleId=${encodeURIComponent(L)}`);
+	}, [l, L]), me = u((e) => {
+		l(`/pipelines/${e}`);
+	}, [l]), he = u((e) => {
+		l(`/pipelines/${e}/edit`);
+	}, [l]), ge = u((e) => {
+		l(`/pipelines/${e}?test=true`);
+	}, [l]), _e = u((e) => {
 		let t = J.find((t) => t.id === e);
 		t && W(t);
-	}, [J, W]), ge = d(async () => {
+	}, [J, W]), ve = u(async () => {
 		if (U) {
 			try {
-				await Y(U.id), s() && c("success");
+				await Y(U.id), i() && a("success");
 			} catch (e) {
-				throw s() && c("error"), e;
+				throw i() && a("error"), e;
 			}
 			G();
 		}
@@ -55,9 +57,9 @@ var E = u(function() {
 		U,
 		Y,
 		G
-	]), _e = d(() => {
+	]), ye = u(() => {
 		P("all"), V("");
-	}, [V]), Q = [
+	}, [V]), Q = d(() => [
 		{
 			value: "all",
 			label: E("bigconsole.pipelines.filters.all", "All")
@@ -78,26 +80,43 @@ var E = u(function() {
 			value: "error",
 			label: E("bigconsole.pipelines.filters.error", "Error")
 		}
-	];
-	if (O) return /* @__PURE__ */ w("div", {
+	], [E]);
+	if (fe(d(() => !O && k && !q ? o({
+		tr: E,
+		statusOptions: Q,
+		status: N,
+		setStatus: (e) => {
+			let t = Q.find((t) => t.value === e);
+			t && P(t.value);
+		},
+		setSearch: V
+	}) : null, [
+		E,
+		O,
+		k,
+		q,
+		Q,
+		N,
+		V
+	])), O) return /* @__PURE__ */ w("div", {
 		style: {
 			display: "flex",
 			alignItems: "center",
 			justifyContent: "center",
 			padding: "80px 0"
 		},
-		children: /* @__PURE__ */ w(C, { style: {
+		children: /* @__PURE__ */ w(S, { style: {
 			height: "var(--size-icon-xl)",
 			width: "var(--size-icon-xl)"
 		} })
 	});
-	if (!k) return /* @__PURE__ */ w(h, {
+	if (!k) return /* @__PURE__ */ w(m, {
 		title: E("bigconsole.pipelines.errors.accessDeniedTitle", "Access Denied"),
 		description: E("bigconsole.pipelines.errors.accessDeniedListDescription", "You don't have permission to view pipelines.")
 	});
 	let $ = /* @__PURE__ */ T("header", {
 		className: "relative overflow-hidden border-b border-[var(--color-border-seam)] bg-[image:var(--gradient-gloss-card)]",
-		children: [/* @__PURE__ */ w(ae, { intensity: "subtle" }), /* @__PURE__ */ T("div", {
+		children: [/* @__PURE__ */ w(le, { intensity: "subtle" }), /* @__PURE__ */ T("div", {
 			className: "flex flex-col gap-form-gap sm:flex-row sm:items-center sm:justify-between",
 			style: { padding: "var(--space-pagePadding)" },
 			children: [/* @__PURE__ */ T("div", {
@@ -110,7 +129,7 @@ var E = u(function() {
 						width: "var(--size-controlHeight-lg)",
 						backgroundColor: "var(--color-action-primary-bg)"
 					},
-					children: /* @__PURE__ */ w(y, { style: {
+					children: /* @__PURE__ */ w(ae, { style: {
 						height: "var(--size-icon-lg)",
 						width: "var(--size-icon-lg)",
 						color: "var(--color-action-primary-text)"
@@ -119,19 +138,19 @@ var E = u(function() {
 					className: "min-w-0",
 					children: [/* @__PURE__ */ w("h1", {
 						className: "text-2xl font-bold leading-tight text-text-primary",
-						children: /* @__PURE__ */ w(oe, { children: E("bigconsole.pipelines.list.heading", "Pipelines") })
+						children: /* @__PURE__ */ w(b, { children: E("bigconsole.pipelines.list.heading", "Pipelines") })
 					}), /* @__PURE__ */ w("p", {
 						className: "text-sm text-text-secondary",
 						children: E("bigconsole.pipelines.list.subtitle", "Create and manage sequential parser chains for data transformation")
 					})]
 				})]
-			}), /* @__PURE__ */ w(g, {
-				permission: o.PIPELINE_CREATE,
+			}), /* @__PURE__ */ w(h, {
+				permission: r.PIPELINE_CREATE,
 				deniedBehavior: "disable",
-				children: /* @__PURE__ */ T(S, {
+				children: /* @__PURE__ */ T(y, {
 					onClick: Z,
 					className: "w-full shrink-0 min-h-[var(--size-controlHeight-md)] sm:w-auto",
-					children: [/* @__PURE__ */ w(x, { className: "h-icon-sm w-icon-sm" }), E("bigconsole.pipelines.actions.createPipeline", "Create Pipeline")]
+					children: [/* @__PURE__ */ w(v, { className: "h-icon-sm w-icon-sm" }), E("bigconsole.pipelines.actions.createPipeline", "Create Pipeline")]
 				})
 			})]
 		})]
@@ -140,15 +159,15 @@ var E = u(function() {
 		className: "min-h-screen bg-bg-canvas",
 		children: [$, /* @__PURE__ */ w("div", {
 			style: { padding: "var(--space-pagePadding)" },
-			children: /* @__PURE__ */ w(i, {
+			children: /* @__PURE__ */ w(n, {
 				tone: "danger",
 				headingLevel: 2,
 				title: E("bigconsole.pipelines.errors.loadListTitle", "Failed to load Pipelines"),
 				description: q.message,
-				icon: /* @__PURE__ */ w(v, { className: "h-icon-sm w-icon-sm" }),
-				actions: /* @__PURE__ */ w(S, {
+				icon: /* @__PURE__ */ w(_, { className: "h-icon-sm w-icon-sm" }),
+				actions: /* @__PURE__ */ w(y, {
 					size: "sm",
-					onClick: () => de(),
+					onClick: () => pe(),
 					children: E("bigconsole.pipelines.actions.tryAgain", "Try Again")
 				}),
 				"data-testid": "pipelines-error",
@@ -164,8 +183,8 @@ var E = u(function() {
 			$,
 			/* @__PURE__ */ w("div", {
 				style: { padding: "var(--space-pagePadding)" },
-				children: /* @__PURE__ */ T(a, { children: [
-					/* @__PURE__ */ w(le, {
+				children: /* @__PURE__ */ T(ne, { children: [
+					/* @__PURE__ */ w(x, {
 						className: "max-w-[75ch]",
 						children: E("bigconsole.pipelines.list.purpose", "Pipelines chain parsers and data sinks into a repeatable flow — they take raw input, run it through your parsers, and route the structured result into a sink. Use them to turn messy logs, files, or API payloads into clean, queryable data your dashboards can use.")
 					}),
@@ -173,8 +192,8 @@ var E = u(function() {
 						"aria-label": "Filter and search pipelines",
 						"data-testid": "pipelines-toolbar",
 						"data-section-emphasis": "bare",
-						className: r("bare", "neutral", "none"),
-						children: [/* @__PURE__ */ w(l, {
+						className: te("bare", "neutral", "none"),
+						children: [/* @__PURE__ */ w(s, {
 							value: L,
 							onChange: (e) => {
 								let t = new URLSearchParams(F);
@@ -191,7 +210,7 @@ var E = u(function() {
 										type: "button",
 										"aria-pressed": N === e.value,
 										onClick: () => P(e.value),
-										className: `shrink-0 whitespace-nowrap rounded-button text-sm font-medium motion-safe:transition-colors ${n}`,
+										className: `shrink-0 whitespace-nowrap rounded-button text-sm font-medium motion-safe:transition-colors ${ee}`,
 										style: {
 											minHeight: "var(--size-controlHeight-md)",
 											padding: "0 var(--space-formGap)",
@@ -208,23 +227,23 @@ var E = u(function() {
 									role: "group",
 									"aria-label": "Pipeline layout",
 									className: "flex shrink-0 gap-1",
-									children: [/* @__PURE__ */ w(S, {
+									children: [/* @__PURE__ */ w(y, {
 										variant: R === "grid" ? "secondary" : "ghost",
 										"aria-label": "Grid view",
 										"aria-pressed": R === "grid",
 										onClick: () => z("grid"),
-										children: /* @__PURE__ */ w(b, { className: "h-icon-sm w-icon-sm" })
-									}), /* @__PURE__ */ w(S, {
+										children: /* @__PURE__ */ w(oe, { className: "h-icon-sm w-icon-sm" })
+									}), /* @__PURE__ */ w(y, {
 										variant: R === "list" ? "secondary" : "ghost",
 										"aria-label": "List view",
 										"aria-pressed": R === "list",
 										onClick: () => z("list"),
-										children: /* @__PURE__ */ w(re, { className: "h-icon-sm w-icon-sm" })
+										children: /* @__PURE__ */ w(se, { className: "h-icon-sm w-icon-sm" })
 									})]
 								}),
 								/* @__PURE__ */ T("div", {
 									className: "relative w-full md:max-w-[320px]",
-									children: [/* @__PURE__ */ w(ie, {
+									children: [/* @__PURE__ */ w(ce, {
 										"aria-hidden": "true",
 										style: {
 											position: "absolute",
@@ -235,7 +254,7 @@ var E = u(function() {
 											width: "var(--size-icon-sm)",
 											color: "var(--color-text-muted)"
 										}
-									}), /* @__PURE__ */ w(ce, {
+									}), /* @__PURE__ */ w(de, {
 										type: "text",
 										"aria-label": E("bigconsole.pipelines.list.searchPlaceholder", "Search pipelines..."),
 										placeholder: E("bigconsole.pipelines.list.searchPlaceholder", "Search pipelines..."),
@@ -250,7 +269,7 @@ var E = u(function() {
 							]
 						})]
 					}),
-					/* @__PURE__ */ T(i, {
+					/* @__PURE__ */ T(n, {
 						emphasis: "primary",
 						headingLevel: 2,
 						title: "Your pipelines",
@@ -266,7 +285,7 @@ var E = u(function() {
 								role: "status",
 								children: /* @__PURE__ */ T("div", {
 									className: "text-center",
-									children: [/* @__PURE__ */ w(C, { style: {
+									children: [/* @__PURE__ */ w(S, { style: {
 										height: "var(--size-icon-xl)",
 										width: "var(--size-icon-xl)",
 										margin: "0 auto var(--space-formGap)"
@@ -278,32 +297,32 @@ var E = u(function() {
 							}),
 							!K && J.length === 0 && /* @__PURE__ */ w("div", {
 								"data-testid": "pipelines-empty",
-								children: /* @__PURE__ */ w(se, {
+								children: /* @__PURE__ */ w(ue, {
 									illustration: "empty-data",
 									title: E("bigconsole.pipelines.list.emptyTitle", "No Pipelines yet"),
 									description: E("bigconsole.pipelines.list.emptyDescription", "Create a pipeline to chain parsers together for sequential data transformation. Each stage processes the output of the previous stage."),
-									action: /* @__PURE__ */ w(g, {
-										permission: o.PIPELINE_CREATE,
+									action: /* @__PURE__ */ w(h, {
+										permission: r.PIPELINE_CREATE,
 										deniedBehavior: "disable",
-										children: /* @__PURE__ */ T(S, {
+										children: /* @__PURE__ */ T(y, {
 											onClick: Z,
 											className: "min-h-[var(--size-controlHeight-md)]",
-											children: [/* @__PURE__ */ w(x, { className: "h-icon-sm w-icon-sm" }), E("bigconsole.pipelines.actions.createPipeline", "Create Pipeline")]
+											children: [/* @__PURE__ */ w(v, { className: "h-icon-sm w-icon-sm" }), E("bigconsole.pipelines.actions.createPipeline", "Create Pipeline")]
 										})
 									})
 								})
 							}),
-							!K && X.length === 0 && J.length > 0 && /* @__PURE__ */ w(i, {
+							!K && X.length === 0 && J.length > 0 && /* @__PURE__ */ w(n, {
 								emphasis: "muted",
 								tone: "info",
 								padding: "compact",
 								headingLevel: 3,
 								title: E("bigconsole.pipelines.list.noResultsTitle", "No matching pipelines"),
 								description: E("bigconsole.pipelines.list.noResultsDescription", "No pipelines match your filters"),
-								actions: /* @__PURE__ */ w(S, {
+								actions: /* @__PURE__ */ w(y, {
 									size: "sm",
 									variant: "secondary",
-									onClick: _e,
+									onClick: ye,
 									children: "Clear filters"
 								}),
 								"data-testid": "pipelines-no-results"
@@ -311,23 +330,23 @@ var E = u(function() {
 							X.length > 0 && /* @__PURE__ */ w("div", {
 								className: R === "grid" ? "grid grid-cols-1 gap-form-gap sm:grid-cols-2 xl:grid-cols-3" : "grid grid-cols-1 gap-form-gap",
 								"data-layout": R,
-								children: X.map((e) => /* @__PURE__ */ w(ne, {
+								children: X.map((e) => /* @__PURE__ */ w(ie, {
 									pipeline: e,
-									onView: fe,
-									onEdit: A ? pe : void 0,
-									onTest: M ? me : void 0,
-									onDelete: j ? he : void 0
+									onView: me,
+									onEdit: A ? he : void 0,
+									onTest: M ? ge : void 0,
+									onDelete: j ? _e : void 0
 								}, e.id))
 							})
 						]
 					})
 				] })
 			}),
-			U && /* @__PURE__ */ w(te, {
+			U && /* @__PURE__ */ w(c, {
 				pipeline: U,
 				isOpen: H,
 				onClose: G,
-				onConfirm: ge
+				onConfirm: ve
 			})
 		]
 	});

package/dist/bigconsole/utils/dashboardList.d.ts

@@ -0,0 +1,28 @@
+import { ListSortValue } from './listSort';
+
+export interface DashboardRow {
+    name: string;
+    description?: string | null;
+    category?: string | null;
+    status?: string;
+    updatedAt: string;
+}
+export interface DashboardListQuery {
+    search: string;
+    /** '' = all categories. */
+    category: string;
+    /** '' = all statuses. */
+    status: string;
+    sort: ListSortValue;
+    /** 1-based. */
+    page: number;
+    pageSize: number;
+}
+export interface DashboardListResult<T> {
+    /** Every row that passes search and filters, in the chosen order. */
+    filtered: T[];
+    totalPages: number;
+    /** The rows on `page` (clamped to the available pages). */
+    pageItems: T[];
+}
+export declare function selectDashboards<T extends DashboardRow>(dashboards: readonly T[], query: DashboardListQuery): DashboardListResult<T>;

package/dist/bigconsole/utils/dashboardList.js

@@ -0,0 +1,15 @@
+import { sortList as e } from "./listSort.js";
+//#region src/bigconsole/utils/dashboardList.ts
+function t(t, n) {
+	let r = n.search.toLowerCase(), i = e(t.filter((e) => (!n.category || e.category === n.category) && (!n.status || e.status === n.status) && (e.name.toLowerCase().includes(r) || e.description?.toLowerCase().includes(r))), n.sort, {
+		name: (e) => e.name,
+		updatedAt: (e) => e.updatedAt
+	}), a = Math.max(1, Math.ceil(i.length / n.pageSize)), o = (Math.min(Math.max(1, n.page), a) - 1) * n.pageSize;
+	return {
+		filtered: i,
+		totalPages: a,
+		pageItems: i.slice(o, o + n.pageSize)
+	};
+}
+//#endregion
+export { t as selectDashboards };

package/dist/bigconsole/utils/dataSinkList.d.ts

@@ -0,0 +1,15 @@
+import { DataSink, DataSinkSetupState, DataSinkStatus } from '../types';
+import { ListSortValue } from './listSort';
+
+export interface DataSinkRow {
+    dataSink: DataSink;
+    setupState: DataSinkSetupState;
+}
+export interface DataSinkListQuery {
+    setupState: 'all' | 'in_progress' | 'completed';
+    status: DataSinkStatus | null;
+    active: boolean | null;
+    search: string;
+    sort: ListSortValue;
+}
+export declare function selectDataSinks<T extends DataSinkRow>(rows: readonly T[], query: DataSinkListQuery): T[];

package/dist/bigconsole/utils/dataSinkList.js

@@ -0,0 +1,15 @@
+import { sortList as e } from "./listSort.js";
+//#region src/bigconsole/utils/dataSinkList.ts
+function t(t, n) {
+	let r = [...t];
+	if (n.setupState === "in_progress" ? r = r.filter((e) => e.setupState !== "completed") : n.setupState === "completed" && (r = r.filter((e) => e.setupState === "completed")), n.status !== null && (r = r.filter((e) => e.dataSink.status === n.status)), n.active !== null && (r = r.filter((e) => e.dataSink.isActive === n.active)), n.search.trim()) {
+		let e = n.search.toLowerCase();
+		r = r.filter((t) => t.dataSink.name?.toLowerCase().includes(e) || t.dataSink.key.toLowerCase().includes(e) || t.dataSink.description?.toLowerCase().includes(e));
+	}
+	return e(r, n.sort, {
+		name: (e) => e.dataSink.name || e.dataSink.key,
+		updatedAt: (e) => e.dataSink.updatedAt
+	});
+}
+//#endregion
+export { t as selectDataSinks };

package/dist/bigconsole/utils/listSort.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared "Sort by" model for BigConsole list pages (BOFF-8679).
+ *
+ * ★ One definition of the sort values, the comparator and the option labels, so
+ * the visible `SortBySelect`, the page's own list pipeline and the assistant's
+ * page-control adapter (`assistant/pageControls.ts`) cannot disagree: a person
+ * who picks "Name Z–A" from the menu and a person who says "sort by name
+ * descending" set the SAME state and get the SAME list.
+ *
+ * Pure: no React, no DOM, no i18n provider (labels come in through `Tr`).
+ *
+ * Only fields the list data really carries are offered:
+ * - Name: every dashboard has `name`; a data sink may have a null `name`, in
+ *   which case its `key` is what the card and the table show, so that is what
+ *   sorts.
+ * - Last updated: `updatedAt` on both. A row with no parseable date sorts last
+ *   in both directions (it has no "age" to rank).
+ */
+export type ListSortValue = 'default' | 'name-asc' | 'name-desc' | 'updated-desc' | 'updated-asc';
+export type ListSortField = 'name' | 'updated';
+export type SortTr = (key: string, fallback: string) => string;
+export interface ListSortOption {
+    value: ListSortValue;
+    label: string;
+}
+/** How a list item exposes the two sortable fields. */
+export interface ListSortKeys<T> {
+    /** The text the row shows as its name. */
+    name: (item: T) => string;
+    /** ISO timestamp of the last update, if any. */
+    updatedAt: (item: T) => string | null | undefined;
+}
+/** The i18n key and English source of every label used by the control. */
+export declare const LIST_SORT_COPY: {
+    readonly label: {
+        readonly key: "bigconsole.listSort.label";
+        readonly en: "Sort by";
+    };
+    readonly default: {
+        readonly key: "bigconsole.listSort.default";
+        readonly en: "Default order";
+    };
+    readonly nameAsc: {
+        readonly key: "bigconsole.listSort.nameAsc";
+        readonly en: "Name A–Z";
+    };
+    readonly nameDesc: {
+        readonly key: "bigconsole.listSort.nameDesc";
+        readonly en: "Name Z–A";
+    };
+    readonly updatedDesc: {
+        readonly key: "bigconsole.listSort.updatedDesc";
+        readonly en: "Last updated: newest";
+    };
+    readonly updatedAsc: {
+        readonly key: "bigconsole.listSort.updatedAsc";
+        readonly en: "Last updated: oldest";
+    };
+    readonly fieldName: {
+        readonly key: "bigconsole.listSort.field.name";
+        readonly en: "Name";
+    };
+    readonly fieldUpdated: {
+        readonly key: "bigconsole.listSort.field.updated";
+        readonly en: "Last updated";
+    };
+};
+/**
+ * The list ordered by `value`. `default` returns the items in the order given
+ * (the page's own default order, untouched). The sort is stable: rows that tie
+ * keep their incoming order, so a re-sort never shuffles equal rows.
+ */
+export declare function sortList<T>(items: readonly T[], value: ListSortValue, keys: ListSortKeys<T>): T[];
+/**
+ * The options the visible control lists, in its words. `withDefault` adds the
+ * "Default order" entry for a page whose natural order is not one of the four
+ * (Dashboards: the server's order). A page whose default IS one of them
+ * (Data Sinks: newest first) omits it and starts on that value.
+ */
+export declare function listSortOptions(tr: SortTr, withDefault: boolean): ListSortOption[];

package/dist/bigconsole/utils/listSort.js

@@ -0,0 +1,85 @@
+//#region src/bigconsole/utils/listSort.ts
+var e = {
+	label: {
+		key: "bigconsole.listSort.label",
+		en: "Sort by"
+	},
+	default: {
+		key: "bigconsole.listSort.default",
+		en: "Default order"
+	},
+	nameAsc: {
+		key: "bigconsole.listSort.nameAsc",
+		en: "Name A–Z"
+	},
+	nameDesc: {
+		key: "bigconsole.listSort.nameDesc",
+		en: "Name Z–A"
+	},
+	updatedDesc: {
+		key: "bigconsole.listSort.updatedDesc",
+		en: "Last updated: newest"
+	},
+	updatedAsc: {
+		key: "bigconsole.listSort.updatedAsc",
+		en: "Last updated: oldest"
+	},
+	fieldName: {
+		key: "bigconsole.listSort.field.name",
+		en: "Name"
+	},
+	fieldUpdated: {
+		key: "bigconsole.listSort.field.updated",
+		en: "Last updated"
+	}
+}, t = new Intl.Collator(void 0, {
+	sensitivity: "base",
+	numeric: !0
+});
+function n(e) {
+	if (!e) return null;
+	let t = new Date(e).getTime();
+	return Number.isNaN(t) ? null : t;
+}
+function r(e, r, i) {
+	let a = [...e];
+	switch (r) {
+		case "default": return a;
+		case "name-asc": return a.sort((e, n) => t.compare(i.name(e), i.name(n)));
+		case "name-desc": return a.sort((e, n) => t.compare(i.name(n), i.name(e)));
+		case "updated-desc":
+		case "updated-asc": {
+			let e = r === "updated-desc" ? -1 : 1;
+			return a.sort((t, r) => {
+				let a = n(i.updatedAt(t)), o = n(i.updatedAt(r));
+				return a === null && o === null ? 0 : a === null ? 1 : o === null ? -1 : (a - o) * e;
+			});
+		}
+	}
+}
+function i(t, n) {
+	let r = [
+		{
+			value: "name-asc",
+			label: t(e.nameAsc.key, e.nameAsc.en)
+		},
+		{
+			value: "name-desc",
+			label: t(e.nameDesc.key, e.nameDesc.en)
+		},
+		{
+			value: "updated-desc",
+			label: t(e.updatedDesc.key, e.updatedDesc.en)
+		},
+		{
+			value: "updated-asc",
+			label: t(e.updatedAsc.key, e.updatedAsc.en)
+		}
+	];
+	return n ? [{
+		value: "default",
+		label: t(e.default.key, e.default.en)
+	}, ...r] : r;
+}
+//#endregion
+export { e as LIST_SORT_COPY, i as listSortOptions, r as sortList };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-bigconsole",
-  "version": "2026.1008.14",
+  "version": "2026.1009.10",
   "description": "BigConsole - AI-powered analytics and dashboard platform",
   "type": "module",
   "files": [
@@ -51,7 +51,7 @@
   },
   "peerDependencies": {
     "@apollo/client": "^4.0.11",
-    "@burdenoff/fe-libs": "2026.1009.1",
+    "@burdenoff/fe-libs": "2026.1009.2",
     "@burdenoff/fluidgrids-fe-sdk": "2026.731.4",
     "@iconify/react": "^6.0.2",
     "@monaco-editor/react": "^4.7.0",
@@ -86,7 +86,7 @@
     "zustand": "^5.0.3"
   },
   "devDependencies": {
-    "@burdenoff/fe-libs": "2026.1009.1",
+    "@burdenoff/fe-libs": "2026.1009.2",
     "@burdenoff/fluidgrids-fe-sdk": "2026.731.4",
     "@eslint/js": "^10.0.1",
     "@graphql-codegen/add": "^5.0.0",