@camstack/ui-library 0.1.56 → 0.1.58

package/dist/lib/cap-error.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared capability-error utilities for the admin UI.
+ *
+ * The primary export `isAbsentProvider` lets UI components distinguish
+ * "this device doesn't have this cap" (expected — hide the widget) from
+ * "something went wrong while calling a present cap" (unexpected — surface
+ * the error to the operator).
+ *
+ * Detection strategy (two-tier):
+ *
+ *   1. **Typed reason** (preferred): tRPC's errorFormatter augments the
+ *      error shape with `data.capRouteReason` when the server throws a
+ *      CapRouteError. Read it from `err.data?.capRouteReason` to avoid
+ *      brittle string matching.
+ *
+ *   2. **Substring fallback** (transitional safety): older error paths
+ *      that don't carry a typed reason still emit the human-readable
+ *      message "provider not available". The fallback is ONLY engaged
+ *      when `capRouteReason` is absent — future clean-up can drop it
+ *      once every throw site has been migrated.
+ */
+/**
+ * Returns `true` when `err` indicates that the requested capability has
+ * no provider bound for the device — i.e. the device legitimately does
+ * not expose this cap and the UI should stay hidden / show a friendly
+ * "not supported" message.
+ *
+ * Returns `false` for real dispatch errors (`transport-failed`) — those
+ * should be surfaced to the operator as unexpected failures.
+ *
+ * ## Absent-provider reasons
+ * - `'no-provider'`  — no provider is registered for this cap/device pair.
+ * - `'node-offline'` — the node that hosts the cap is not reachable; the
+ *   device is effectively unavailable so we treat it as absent.
+ *
+ * ## Not-absent reasons
+ * - `'transport-failed'` — a provider exists but the call failed in transit.
+ * - `'cap-unknown'`      — the cap name isn't registered at all; treat as
+ *   a real error (likely a programming mistake or version skew).
+ */
+export declare function isAbsentProvider(err: unknown): boolean;

package/dist/lib/format-control-datetime.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Format an HA-native datetime control value in the user's locale.
+ *
+ * The `control` cap keeps the value verbatim in one of three HA-native shapes:
+ *   - date     → 'YYYY-MM-DD'
+ *   - time     → 'HH:MM' or 'HH:MM:SS'
+ *   - datetime → full ISO timestamp ('YYYY-MM-DDTHH:MM[:SS]' or space-separated)
+ *
+ * This helper renders that value for the READ-ONLY (at-a-glance) context:
+ *   - 'date'     → locale date    (e.g. en-US '6/7/2026')
+ *   - 'time'     → locale time    (e.g. en-US '07:30 AM')
+ *   - 'datetime' → locale date+time (medium date + short time)
+ *
+ * It NEVER throws: any value it cannot parse is returned unchanged (graceful
+ * fallback). `locale` is optional and defaults to the runtime/browser locale.
+ */
+export type ControlDateTimeFormat = 'date' | 'time' | 'datetime';
+export declare function formatControlDateTime(value: string, format: ControlDateTimeFormat, locale?: string): string;

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

@@ -0,0 +1,12 @@
+/**
+ * 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/non-positive inputs so callers can render nothing rather
+ * than a misleading "—" or "NaN ago".
+ *
+ * Future timestamps (clock skew between the device and the browser)
+ * collapse to "just now" instead of a negative duration.
+ */
+export declare function formatLastSeen(timestampMs: number | null | undefined): string | null;

package/dist/lib/format-numeric.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Format a numeric sensor / control value with optional display precision.
+ *
+ * When `precision` is provided, delegates to `value.toFixed(precision)` which
+ * matches the HA `suggested_display_precision` contract.
+ * When absent, falls back to auto-formatting: integers render without a
+ * decimal point; non-integers use one decimal place.
+ */
+export declare function formatNumeric(value: number, precision: number | undefined): string;

package/dist/lib/index.d.ts

@@ -1,4 +1,8 @@
 export { cn } from './cn';
+export { formatLastSeen } from './format-last-seen';
+export { formatControlDateTime } from './format-control-datetime';
+export type { ControlDateTimeFormat } from './format-control-datetime';
+export { isAbsentProvider } from './cap-error';
 export * from './responsive';
 export { mirror } from './pipeline-mirror';
 export type { MirrorSource, MirrorInput, MirrorOutcome, MirrorResultEntry, } from './pipeline-mirror';

package/dist/primitives/dialog.d.ts

@@ -7,6 +7,19 @@ interface DialogProps {
 }
 export declare function Dialog({ children, open: controlledOpen, onOpenChange }: DialogProps): import("react/jsx-runtime").JSX.Element;
 export declare function DialogTrigger({ children, ...props }: HTMLAttributes<HTMLButtonElement>): import("react/jsx-runtime").JSX.Element;
+/**
+ * A native <dialog> opened with showModal() is promoted to the top layer, so
+ * ancestor transform/overflow can't clip it — but it relies on the UA
+ * stylesheet's `dialog { margin: auto }` for modal centering. Tailwind's
+ * preflight resets `margin: 0` on every element, which defeats that centering
+ * and pins the modal to the top-left. We therefore center deterministically:
+ * a top-layer dialog with `position: fixed` is viewport-relative, and a
+ * self-transform is fine, so `fixed left-1/2 top-1/2 -translate-x-1/2
+ * -translate-y-1/2 m-0` always centers regardless of any margin reset. Width
+ * is capped to the viewport (`w-[calc(100vw-2rem)]`) rather than a bare
+ * `w-full` (which would overflow/clip a centered dialog); the per-variant
+ * `max-w-*` keeps small dialogs small while the cap prevents overflow.
+ */
 declare const contentVariants: (props?: ({
     width?: "sm" | "md" | "lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/primitives/tooltip.d.ts

@@ -1,6 +1,12 @@
 import { HTMLAttributes, ReactNode } from 'react';
-export declare function Tooltip({ children }: {
-    children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+interface TooltipProps {
+    readonly children: ReactNode;
+    /** Extra classes for the positioning wrapper. Defaults to `inline-block`
+     *  (shrink-to-fit). Pass `block w-full min-w-0` when the trigger must fill a
+     *  width-constrained parent so its inner content can truncate cleanly. */
+    readonly className?: string;
+}
+export declare function Tooltip({ children, className }: TooltipProps): import("react/jsx-runtime").JSX.Element;
 export declare function TooltipTrigger({ children, ...props }: HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
 export declare function TooltipContent({ className, children, ...props }: HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "0.1.56",
+  "version": "0.1.58",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -31,6 +31,7 @@
   "scripts": {
     "build": "vite build",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "publish": "npm publish --access public"
   },
   "peerDependencies": {
@@ -80,6 +81,7 @@
     "@module-federation/runtime": "^2.4.0",
     "class-variance-authority": "^0.7",
     "clsx": "^2.1",
+    "hls.js": "^1.6.16",
     "lucide-react": "^0.576",
     "qrcode.react": "^4.2.0",
     "tailwind-merge": "^3.0"

package/dist/composites/cap-settings/MotionGridCanvas.d.ts

@@ -1,9 +0,0 @@
-import { MotionZoneOptions } from '@camstack/types';
-export interface MotionGridCanvasProps {
-    /** Fixed lattice dimensions — from the cap's `getOptions`. */
-    readonly options: MotionZoneOptions;
-    /** Row-major active-cell grid, length === gridWidth*gridHeight. */
-    readonly cells: readonly boolean[];
-    readonly onCellsChange: (next: boolean[]) => void;
-}
-export declare function MotionGridCanvas({ options, cells, onCellsChange }: MotionGridCanvasProps): import("react/jsx-runtime").JSX.Element;