@camstack/ui-library 1.2.324 → 1.2.326

package/dist/lib/resolve-sensor-display.d.ts

@@ -1,20 +1,10 @@
 /**
-* Shared, pure resolution of a sensor's DISPLAY unit + precision + value
-* transform. One function so the two renderers (`SensorValueAtom`,
-* `SensorHeroCard`) can never diverge — they duplicated this precedence before.
-*
-* Resolution order (device override → role default → live slice →
-* ROLE_DESCRIPTOR canonicalUnit). `??` everywhere, never `||`: `precision: 0`
-* is a legal override and must win over a slice `precision: 2`.
-*
-* Conversion happens at RENDER only — storage stays in source units. An
-* override unit converts the raw slice value ONLY when it shares a dimension
-* with the source unit (`canConvertUnit`); on refusal the display falls back to
-* identity + the SOURCE unit so a unit label and its value math can never
-* disagree. Precision applies AFTER conversion (by construction — the caller
-* runs `formatNumeric(toDisplayValue(raw), precision)`).
+* Shared resolution of a sensor's display string. The stored number is always
+* the quantity's base unit (D944 §4). A display preference (default metric)
+* or an operator override picks the label; the value is converted to match.
 */
-import type { DeviceDisplayOverride, RoleDisplayDefault } from "@camstack/types";
+import type { DeviceDisplayOverride, ReadingQuantity, RoleDisplayDefault } from "@camstack/types";
+import { type DisplayPreference } from "@camstack/types";
 export interface SensorDisplayInput {
 	/** Per-device override from the row (`DeviceInfo.display`). */
 	readonly display?: DeviceDisplayOverride;
@@ -22,20 +12,28 @@ export interface SensorDisplayInput {
 	readonly capName?: string;
 	/** Role default (`roleDisplayDefaults[device.role]`). */
 	readonly roleDefault?: RoleDisplayDefault;
-	/** Live slice unit (the unit the raw VALUE is actually in, for generic sensors). */
-	readonly sliceUnit?: string;
-	/** Live slice precision. */
-	readonly slicePrecision?: number;
-	/** ROLE_DESCRIPTOR canonical unit fallback (typed roles). */
-	readonly canonicalUnit?: string;
+	/** Quantity of the stored number. `device` reads `deviceQuantity`. */
+	readonly quantity?: ReadingQuantity;
+	/** The device's chosen quantity when `quantity` is `device`. */
+	readonly deviceQuantity?: ReadingQuantity;
+	/** Precision declared on the reading, when the operator has not overridden it. */
+	readonly declarationPrecision?: number;
+	/** Read-time preference. Defaults to metric. */
+	readonly preference?: DisplayPreference;
 }
 export interface ResolvedSensorDisplay {
-	/** Display unit — `''` when none resolves anywhere. */
+	/** Display unit — `''` when the quantity has none. */
 	readonly unit: string;
 	/** Display precision (int 0-10) or undefined for auto-format. */
 	readonly precision: number | undefined;
-	/** Convert a raw slice value into the display unit. Identity unless an
-	*  override unit differs from the source unit AND both share a dimension. */
+	/** Convert a base-unit value into the display unit. */
 	readonly toDisplayValue: (raw: number) => number;
+	/** Convert a display-unit value back into the stored base. */
+	readonly fromDisplayValue: (shown: number) => number;
+	/** Text and unit for one base-unit sample. */
+	readonly format: (raw: number) => {
+		readonly text: string;
+		readonly unit: string;
+	};
 }
 export declare function resolveSensorDisplay(input: SensorDisplayInput): ResolvedSensorDisplay;

package/package.json

@@ -1,6 +1,15 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.324",
+  "version": "1.2.326",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/camstack/server.git",
+    "directory": "packages/ui-library"
+  },
+  "homepage": "https://camstack-docs.zentik.app",
+  "bugs": {
+    "url": "https://github.com/camstack/server/issues"
+  },
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",