@camstack/ui-library 1.2.290 → 1.2.292

package/dist/lib/format-last-seen.d.ts

@@ -1,8 +1,22 @@
 /**
+* Relative "last seen" formatter for the offline affordance.
+*
+* Renders a short relative-time label from a millisecond epoch:
+* "just now", "5m ago", "3h ago", "2d ago". Returns `null` for missing
+* inputs, or inputs below {@link MIN_PLAUSIBLE_TIMESTAMP_MS} (a
+* placeholder or a seeded "known value, unknown change time" stamp), so
+* callers can render nothing rather than a misleading "—", "NaN ago", or
+* (for a seeded `1`) "20000 days ago".
+*
+* Future timestamps (clock skew between the device and the browser)
+* collapse to "just now" instead of a negative duration.
+*/
+import { type UiTextFn } from "../contexts/ui-text";
+/**
 * The earliest timestamp a real "last seen" could plausibly carry. Below
 * this, a value is a placeholder or a seeded "known value, unknown change
 * time" stamp (e.g. Homematic's `HM_SEEDED_CHANGED_AT = 1`) — never a real
 * instant. Year 2000 predates every device this renders.
 */
 export declare const MIN_PLAUSIBLE_TIMESTAMP_MS: number;
-export declare function formatLastSeen(timestampMs: number | null | undefined): string | null;
+export declare function formatLastSeen(timestampMs: number | null | undefined, t?: UiTextFn): string | null;

package/dist/lib/phase-config.d.ts

@@ -12,8 +12,9 @@
 * or use the provided `PhaseIcon` component from `./phase-icon.tsx`.
 */
 import type { CameraPhase } from "@camstack/types";
+import { type UiTextFn } from "../contexts/ui-text";
 export interface PhaseVisual {
-	/** Human-readable label (e.g. "Active", "Load-Shed"). */
+	/** Human-readable label (e.g. "Active", "Load-Shed"), resolved through the host's translator. */
 	readonly label: string;
 	/** Tailwind text color class (e.g. "text-success"). */
 	readonly textColor: string;
@@ -24,6 +25,11 @@ export interface PhaseVisual {
 	/** Lucide icon name to use for this phase. */
 	readonly icon: "Activity" | "Eye" | "AlertTriangle" | "PauseCircle" | "PowerOff";
 }
-export declare const PHASE_CONFIG: Record<CameraPhase, PhaseVisual>;
+/** A table row: the label is a catalogue key + English fallback, resolved by the consumer. */
+export interface PhaseStyle extends Omit<PhaseVisual, "label"> {
+	readonly labelKey: string;
+	readonly labelFallback: string;
+}
+export declare const PHASE_CONFIG: Record<CameraPhase, PhaseStyle>;
 /** Look up phase config with a safe fallback to `watching` for unknown values. */
-export declare function getPhaseVisual(phase: string): PhaseVisual;
+export declare function getPhaseVisual(phase: string, t?: UiTextFn): PhaseVisual;

package/dist/lib/pipeline-mirror.d.ts

@@ -1,4 +1,5 @@
 import type { AgentAddonConfig, CameraStepOverridePatch, PipelineSchema } from "@camstack/types";
+import { type UiTextFn } from "../contexts/ui-text";
 export interface MirrorSource {
 	readonly nodeId: string;
 	readonly engine: {
@@ -20,4 +21,4 @@ export interface MirrorResultEntry {
 	readonly reason?: string;
 	readonly patch: CameraStepOverridePatch | null;
 }
-export declare function mirror(input: MirrorInput): readonly MirrorResultEntry[];
+export declare function mirror(input: MirrorInput, t?: UiTextFn): readonly MirrorResultEntry[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.290",
+  "version": "1.2.292",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",

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

@@ -1,11 +0,0 @@
-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;
-}
-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,10 +0,0 @@
-import type { PaginationState } from "./types";
-import { type JSX } from "react";
-interface DataTablePaginationProps {
-	page: number;
-	pageSize: number;
-	total: number;
-	onPaginationChange?: (pagination: PaginationState) => void;
-}
-export declare function DataTablePagination({ page, pageSize, total, onPaginationChange }: DataTablePaginationProps): JSX.Element;
-export {};

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

@@ -1,11 +0,0 @@
-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;
-}
-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,3 +0,0 @@
-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 +0,0 @@
-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 +0,0 @@
-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";
-}
-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";
-}

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

@@ -1,31 +0,0 @@
-/**
-* 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";
-/** How the table renders once the decision is made. */
-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.
-*/
-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;
-}
-export declare function resolveTableLayout({ mode, columnCount, isNarrow }: ResolveTableLayoutInput): TableLayoutKind;