@camstack/ui-library 1.2.347 → 1.2.348

package/dist/lib/index.d.ts

@@ -5,6 +5,8 @@ export type { ControlDateTimeFormat } from "./format-control-datetime";
 export { formatNumeric } from "./format-numeric";
 export { resolveSensorDisplay } from "./resolve-sensor-display";
 export type { SensorDisplayInput, ResolvedSensorDisplay } from "./resolve-sensor-display";
+export { DEFAULT_UNIT_PREFERENCES, TEMPERATURE_SCALES, UNIT_PREFERENCES_NAMESPACE, preferenceForQuantity, readUnitPreferences } from "./unit-preferences";
+export type { ParsedUnitPreferences, TemperatureScale, UnitPreferences } from "./unit-preferences";
 export { isAbsentProvider } from "./cap-error";
 export * from "./responsive";
 export { PHASE_CONFIG, getPhaseVisual } from "./phase-config";

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

@@ -5,6 +5,7 @@
 */
 import type { DeviceDisplayOverride, ReadingQuantity, RoleDisplayDefault } from "@camstack/types";
 import { type DisplayPreference } from "@camstack/types";
+import { type UnitPreferences } from "./unit-preferences";
 export interface SensorDisplayInput {
 	/** Per-device override from the row (`DeviceInfo.display`). */
 	readonly display?: DeviceDisplayOverride;
@@ -18,8 +19,10 @@ export interface SensorDisplayInput {
 	readonly deviceQuantity?: ReadingQuantity;
 	/** Precision declared on the reading, when the operator has not overridden it. */
 	readonly declarationPrecision?: number;
-	/** Read-time preference. Defaults to metric. */
+	/** Read-time preference for this one reading. Wins over `unitPreferences`. */
 	readonly preference?: DisplayPreference;
+	/** The user's unit preferences (`useUnitPreferences()`); metric and °C when absent. */
+	readonly unitPreferences?: UnitPreferences;
 }
 export interface ResolvedSensorDisplay {
 	/** Display unit — `''` when the quantity has none. */

package/dist/lib/unit-preferences.d.ts

@@ -0,0 +1,28 @@
+/**
+* The signed-in user's unit preferences (account preference, namespace
+* `admin.units`). Stored numbers stay in each quantity's base unit (D944); a
+* preference only picks the label and the conversion at display time.
+*
+* Two independent choices: the temperature scale, and metric or imperial for
+* every other quantity. The default is metric and °C, so a user who never
+* opens the page sees what they always saw.
+*/
+import { type DisplayPreference, type ReadingQuantity } from "@camstack/types";
+export declare const UNIT_PREFERENCES_NAMESPACE = "admin.units";
+export declare const TEMPERATURE_SCALES: readonly ["celsius", "fahrenheit"];
+export type TemperatureScale = (typeof TEMPERATURE_SCALES)[number];
+export interface UnitPreferences {
+	/** Metric or imperial, for every quantity except temperature. */
+	readonly system: DisplayPreference;
+	readonly temperature: TemperatureScale;
+}
+export declare const DEFAULT_UNIT_PREFERENCES: UnitPreferences;
+export interface ParsedUnitPreferences {
+	readonly value: UnitPreferences;
+	/** False when the stored row holds a field this client cannot read. */
+	readonly parsed: boolean;
+}
+/** A missing row or field is the default; a field of the wrong shape is unreadable. */
+export declare function readUnitPreferences(raw: unknown): ParsedUnitPreferences;
+/** The display preference to hand `formatReading` for one quantity. */
+export declare function preferenceForQuantity(preferences: UnitPreferences, quantity: ReadingQuantity | undefined): DisplayPreference;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.347",
+  "version": "1.2.348",
   "repository": {
     "type": "git",
     "url": "https://github.com/camstack/server.git",