@camstack/ui-library 0.1.57 → 0.1.58

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,7 @@
 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';

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.57",
+  "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"