@nar-bus/ui-shared 1.21.2 → 2.0.0

package/dist/components/detail-layout/types.d.ts

@@ -1,19 +1,4 @@
-/**
- * STORY-222 / D-230 / AD-DETAIL-5
- *
- * Type contract underpinning the shared detail-layout component family.
- *
- * `DetailEntity` is a **discriminated union** on `kind` ("modem" | "meter").
- * The compiler narrows to the per-kind variant inside `if (entity.kind === ...)`
- * branches, so consumers can access modem-only fields (`firmware`, `protocol`,
- * `signalStrength`, `meterCount`) or meter-only fields (`meterType`, `modemSlug`)
- * without optional chaining and without accidentally reaching across kinds.
- *
- * Mock builders + entity literals + the deterministic PRNG live under
- * `ui/lena-ui-kit/src/_preview/DetailLayout/mockData.ts` (preview-only Storybook
- * fixtures). The production adapter contract lives in `./adapters.ts` and is
- * wired against real `ModemDetail` / `MeterDetail` hook output by STORY-223.
- */
+import { ActiveOrdersByPriority, ModemOrderSuitability } from '../../types';
 export type DayStatus = "ok" | "warn" | "crit" | "noData";
 export interface ReadingDay {
     /** ISO yyyy-mm-dd. */
@@ -32,6 +17,17 @@ export interface AlarmEntry {
     /** ISO datetime. */
     at: string;
 }
+/**
+ * NB-DETAIL-LIFECYCLE-01 — header lifecycle value. The four canonical values
+ * keep their coarse fold (and tone); any other backend code (`SCRAPPED`, a
+ * status added later, …) travels VERBATIM instead of being folded into
+ * `INACTIVE` ("Pasif"). The badge reads `detail_status.lifecycle.<code>` and
+ * falls back to the raw code with a neutral tone. `(string & {})` keeps the
+ * four literals visible to autocomplete.
+ */
+export type DetailLifecycle = "ACTIVE" | "INACTIVE" | "MAINTENANCE" | "FAULTY" | (string & {});
+/** NB-DETAIL-LIFECYCLE-01 — consumer-chosen tone for the lifecycle badge. */
+export type DetailLifecycleTone = "ok" | "warn" | "crit" | "muted";
 interface DetailEntityBase {
     slug: string;
     serial: string;
@@ -42,8 +38,16 @@ interface DetailEntityBase {
         district: string;
     };
     tags: string[];
+    /**
+     * NB-DETAIL-LIFECYCLE-01 — overrides the lifecycle badge text (already
+     * translated). Omitted → `detail_status.lifecycle.<status.lifecycle>`, then
+     * the raw code.
+     */
+    lifecycleLabel?: string;
+    /** NB-DETAIL-LIFECYCLE-01 — overrides the lifecycle badge tone. */
+    lifecycleTone?: DetailLifecycleTone;
     status: {
-        lifecycle: "ACTIVE" | "INACTIVE" | "MAINTENANCE" | "FAULTY";
+        lifecycle: DetailLifecycle;
         network: "CONNECTED" | "DISCONNECTED" | "UNKNOWN";
         power?: "ON" | "OFF" | "UNKNOWN";
         /**
@@ -71,12 +75,36 @@ export interface ModemDetailEntity extends DetailEntityBase {
     kind: "modem";
     firmware?: string;
     protocol?: string;
-    /** Transport-layer port (TCP/MQTT). Optional — only rendered when present. */
+    /**
+     * Transport-layer port (TCP/MQTT). Optional — only rendered when present,
+     * labelled "Port". Superseded in the identity card by `reportedPort` when
+     * that field is set (the two-row layout below).
+     */
     port?: number;
+    /**
+     * NB-DETAIL-TCPPORT-01 (LHA-604 K10) — the protocol's default port, shown
+     * as its own row right under "Protocol". `undefined` → no row; `null` → "—".
+     */
+    protocolDefaultPort?: number | null;
+    /**
+     * NB-DETAIL-TCPPORT-01 — the port the device reported, labelled as such so it
+     * cannot be confused with the default. When set (`null` → "—") it replaces the
+     * plain "Port" row; `undefined` keeps the legacy `port` row.
+     */
+    reportedPort?: number | null;
     /** RSSI 0..100. */
     signalStrength?: number;
     /** Number of meters bound to this modem. */
     meterCount?: number;
+    /**
+     * NB-DETAIL-ORDERS-01 — order-processing suitability. When present the
+     * "Active Orders" quick-stat gains a status dot (SUITABLE green · NO_ORDERS
+     * grey · NOT_SUITABLE red · UNKNOWN amber) and a hover/focus tooltip.
+     * Absent / null → the tile renders exactly as before.
+     */
+    orderSuitability?: ModemOrderSuitability | null;
+    /** NB-DETAIL-ORDERS-01 — per-priority split, listed in the same tooltip. */
+    activeOrdersByPriority?: ActiveOrdersByPriority | null;
 }
 export interface MeterDetailEntity extends DetailEntityBase {
     kind: "meter";

package/dist/components/detail-layout/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/detail-layout/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/detail-layout/types.ts"],"names":[],"mappings":"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"}

package/dist/components/form-sheet/FormSheet.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent as ReactMouseEvent, ReactNode } from 'react';
-import { SheetCloseReason } from '../../../../lena-ui-kit/src';
+import { SheetCloseReason } from '@nar-bus/ui-kit';
 import { FormSheetGradient } from './gradientHeader';
 export type { FormSheetGradient };
 /**

package/dist/components/form-sheet/ReadonlySheet.d.ts

@@ -1,5 +1,5 @@
 import { MouseEvent as ReactMouseEvent, ReactNode } from 'react';
-import { SheetCloseReason } from '../../../../lena-ui-kit/src';
+import { SheetCloseReason } from '@nar-bus/ui-kit';
 import { FormSheetGradient } from './gradientHeader';
 /**
  * ReadonlySheet — a footer-less view drawer (same header chrome as `FormSheet`,

package/dist/components/hourly-month-grid/HourStrip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HourStrip.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/HourStrip.tsx"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,KAAK,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,EAAE,cAAc,+BA4BhB"}
+{"version":3,"file":"HourStrip.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/HourStrip.tsx"],"names":[],"mappings":"AAUA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,KAAK,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,SAAS,GACV,EAAE,cAAc,+BAqChB"}

package/dist/components/hourly-month-grid/HourlyGridLegend.d.ts

@@ -1,4 +1,4 @@
-import { HourlyGridStatusColor } from './HourlyMonthGrid';
+import { HourlyGridMarker, HourlyGridStatusColor } from './HourlyMonthGrid';
 export interface HourlyGridLegendItem {
     status: string;
     label: string;
@@ -6,7 +6,9 @@ export interface HourlyGridLegendItem {
 export interface HourlyGridLegendProps {
     items: HourlyGridLegendItem[];
     statusColors?: Record<string, HourlyGridStatusColor>;
+    /** Corner markers to explain, drawn after the status items. Pass the same objects the cells carry. */
+    markers?: HourlyGridMarker[];
     className?: string;
 }
-export declare function HourlyGridLegend({ items, statusColors, className }: HourlyGridLegendProps): import("react").JSX.Element;
+export declare function HourlyGridLegend({ items, statusColors, markers, className }: HourlyGridLegendProps): import("react").JSX.Element;
 //# sourceMappingURL=HourlyGridLegend.d.ts.map

package/dist/components/hourly-month-grid/HourlyGridLegend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HourlyGridLegend.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/HourlyGridLegend.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,qBAAqB,+BAczF"}
+{"version":3,"file":"HourlyGridLegend.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/HourlyGridLegend.tsx"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,sGAAsG;IACtG,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,qBAAqB,+BAsBlG"}

package/dist/components/hourly-month-grid/HourlyMonthGrid.d.ts

@@ -1,9 +1,38 @@
 import { ReactNode } from 'react';
+/**
+ * Named marker tones resolve to the theme's status tokens. Any other string is
+ * used verbatim as a CSS colour (a token reference such as `var(--my-accent)`
+ * or a literal), so a consumer is never forced to mirror package token names.
+ */
+export type HourlyGridMarkerTone = "info" | "success" | "warning" | "danger" | "neutral";
+/**
+ * Corner marker on an hourly cell — a layer ORTHOGONAL to `status`
+ * (NB-HOURLYGRID-BADGE-01). `status` stays what it is: the cell's production
+ * method and its colour key. The marker flags something that happened TO the
+ * hour on top of that (MDM OSF: a meter-fault window applied vs. declared but
+ * not applied, LMA-519 C12.2) without inventing compound status values.
+ *
+ * `label` is human text: it is appended to the cell's accessible name (and to
+ * the HourStrip button's title), and `HourlyGridLegend` can explain it via its
+ * `markers` prop. The cell `tooltip` is consumer-owned and left untouched.
+ */
+export interface HourlyGridMarker {
+    tone: HourlyGridMarkerTone | (string & {});
+    label: string;
+    /**
+     * `"solid"` fills the dot, `"outline"` draws a ring — a second, non-colour
+     * cue so two markers can be told apart without relying on hue alone
+     * (WCAG 1.4.1). @default "solid"
+     */
+    variant?: "solid" | "outline";
+}
 export interface HourlyGridCell {
     value: number | null;
     status: string;
     tooltip?: string;
     locked?: boolean;
+    /** Optional corner marker, independent of `status`. Absent → the cell renders exactly as before. */
+    marker?: HourlyGridMarker;
 }
 export interface HourlyGridRow {
     day: number;
@@ -49,5 +78,21 @@ export interface HourlyMonthGridProps {
 }
 /** Prop override → default token map → `missing` for unknown/absent status. */
 export declare function resolveStatusColor(status: string | undefined, statusColors?: Record<string, HourlyGridStatusColor>): HourlyGridStatusColor;
+/** Named tone → status token; any other non-blank string passes through as a CSS colour. */
+export declare function resolveMarkerColor(tone: string): string;
+/** Trimmed marker label, "" when absent — tolerant of untyped (JS) callers. */
+export declare function markerLabel(marker: HourlyGridMarker | undefined): string;
+/** `", <label>"` for an accessible name, or "" — so an unmarked cell's name is byte-identical. */
+export declare function markerAriaSuffix(marker: HourlyGridMarker | undefined): string;
+/**
+ * The corner dot itself, shared by grid cells, HourStrip and the legend.
+ * Decorative (`aria-hidden`): the label already rides in the owning control's
+ * accessible name, so announcing the dot would read it twice. The colour is
+ * handed over as a custom property and painted with it in CSS, so one rule
+ * serves both variants.
+ */
+export declare function HourlyGridMarkerDot({ marker }: {
+    marker: HourlyGridMarker;
+}): import("react").JSX.Element;
 export declare function HourlyMonthGrid({ rows, daysInMonth, statusColors, onCellClick, selectedCell, renderCellDetail, showTotals, formatValue, formatTotal, lockBoundaryDay, maxHeight, dayLabel, totalLabel, className, }: HourlyMonthGridProps): import("react").JSX.Element;
 //# sourceMappingURL=HourlyMonthGrid.d.ts.map

package/dist/components/hourly-month-grid/HourlyMonthGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HourlyMonthGrid.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/HourlyMonthGrid.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI7E,OAAO,uBAAuB,CAAC;AAK/B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACzE;;;;OAIG;IACH,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,SAAS,CAAC;IACnF,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkCD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GACnD,qBAAqB,CAQvB;AAuFD,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,WAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,UAAiB,EACjB,WAAgC,EAChC,WAAW,EACX,eAAe,EACf,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,GACV,EAAE,oBAAoB,+BA8KtB"}
+{"version":3,"file":"HourlyMonthGrid.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/HourlyMonthGrid.tsx"],"names":[],"mappings":"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"}

package/dist/components/hourly-month-grid/index.d.ts

@@ -1,5 +1,5 @@
 export { HourlyMonthGrid } from './HourlyMonthGrid';
-export type { HourlyMonthGridProps, HourlyGridCell, HourlyGridRow, HourlyGridStatusColor, } from './HourlyMonthGrid';
+export type { HourlyMonthGridProps, HourlyGridCell, HourlyGridRow, HourlyGridStatusColor, HourlyGridMarker, HourlyGridMarkerTone, } from './HourlyMonthGrid';
 export { HourStrip } from './HourStrip';
 export type { HourStripProps } from './HourStrip';
 export { HourlyGridLegend } from './HourlyGridLegend';

package/dist/components/hourly-month-grid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hourly-month-grid/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/index.d.ts

@@ -19,13 +19,13 @@ export type { TimelineProps, TimelineEntry, TimelineStatus } from './Timeline';
 export { LiveMonitorPanel } from './LiveMonitorPanel';
 export type { LiveMonitorPanelProps } from './LiveMonitorPanel';
 export { OrderCreateSheet } from './OrderCreateSheet';
-export type { OrderCreateSheetProps, OrderCreateMode, OrderCreateTargetEntity, BulkOrderSubmitPayload, } from './OrderCreateSheet';
+export type { OrderCreateSheetProps, OrderCreateMode, OrderCreateTargetEntity, BulkOrderSubmitPayload, OrderCreateError, OrderCreateTarget, } from './OrderCreateSheet';
 export { OrderDetailSheet } from './OrderDetailSheet';
 export type { OrderDetailSheetProps } from './OrderDetailSheet';
 export { MapView } from './MapView';
 export type { MapViewProps } from './MapView';
-export { CronBuilder } from './CronBuilder';
-export type { CronBuilderProps } from './CronBuilder';
+export { CronBuilder, hasCronDayOrSemantics } from './CronBuilder';
+export type { CronBuilderProps, CronDayFieldSemantics } from './CronBuilder';
 export { NotificationBell } from './NotificationBell';
 export type { NotificationBellProps } from './NotificationBell';
 export { RealTimeStatusBar } from './RealTimeStatusBar';
@@ -51,7 +51,7 @@ export type { TopErrorCodesMiniProps, TopErrorCodesMiniState, ErrorCodeEntry, }
 export { DetailSection, DetailFieldRow, DetailFieldGrid, DetailPill, DetailContentBlock, DetailTile, } from './detail-glass';
 export type { DetailSectionProps, DetailFieldRowProps, DetailFieldGridProps, DetailPillProps, DetailPillTone, DetailContentBlockProps, DetailTileProps, DetailTileTone, } from './detail-glass';
 export { HourlyMonthGrid, HourStrip, HourlyGridLegend } from './hourly-month-grid';
-export type { HourlyMonthGridProps, HourlyGridCell, HourlyGridRow, HourlyGridStatusColor, HourStripProps, HourlyGridLegendProps, HourlyGridLegendItem, } from './hourly-month-grid';
+export type { HourlyMonthGridProps, HourlyGridCell, HourlyGridRow, HourlyGridStatusColor, HourlyGridMarker, HourlyGridMarkerTone, HourStripProps, HourlyGridLegendProps, HourlyGridLegendItem, } from './hourly-month-grid';
 export { FormSection, FormFieldStack, FormFieldRow, FormSectionGroup, } from './form-glass';
 export type { FormSectionProps, FormFieldStackProps, FormFieldRowProps, FormSectionGroupProps, } from './form-glass';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}

package/dist/components/order-forms/RelayForms.d.ts

@@ -1,14 +1,42 @@
 interface FormProps {
     params: Record<string, string>;
     onChange: (key: string, value: string) => void;
+    /**
+     * Relay picker options. OPTIONAL override — when omitted the form fetches the
+     * modem's relays itself from `/api/modems/{modemId}/relays` (see
+     * `useRelayOptions`). Supply this only to bypass that fetch.
+     *
+     * `value` MUST be the relay's `relayNo` (the physical channel), NOT
+     * `RelayAssignment.id` (the database row id) — `relayNo` is what becomes
+     * `IoInterfaceInfo.id` in the MASS command. The two differ: a record
+     * `{ id: 42, relayNo: 1 }` must yield `value: "1"`.
+     */
     relayOptions?: Array<{
         value: string;
         label: string;
     }>;
+    /** Modem whose relays to offer. Ignored when `relayOptions` is supplied. */
+    modemId?: number;
 }
 /** RelayQueryForm — select relays to query */
-export declare function RelayQueryForm({ params, onChange, relayOptions }: FormProps): import("react").JSX.Element;
-/** RelayChangeForm — select relays and set ON/OFF status */
-export declare function RelayChangeForm({ params, onChange, relayOptions }: FormProps): import("react").JSX.Element;
+export declare function RelayQueryForm({ params, onChange, relayOptions, modemId }: FormProps): import("react").JSX.Element;
+/** RelayChangeForm — select relays and set ON/OFF status
+ *
+ * NB-RELAY-PARAM-01 (N+17, LHA-645): this form used to emit
+ * `onChange("ioInterfaceChanges", ...)` with `status: "true" | "false"` and a
+ * STRING id. MassCommandBuilder reads `ctx.params.get("ioInterfaces")` and
+ * converts to `List<IoInterfaceInfo>` (`status` = Integer 1/0), so the key never
+ * matched: `get("ioInterfaces")` returned null and the relay command reached the
+ * device with an EMPTY ioInterfaces list. Fixed here: key, id type and status type.
+ *
+ * The JSON.stringify stays. The shared order-forms `FormProps.onChange` contract
+ * is string-valued across all 11 forms, and OrderCreateSheet's FIX-166
+ * parsedParams loop parses any `[`/`{`-leading param back before the POST — so a
+ * REAL array goes on the wire, exactly as it already does for astroRelay
+ * (pinned by OrderCreateSheet.astro-wire.test.tsx, and now by
+ * OrderCreateSheet.relay-wire.test.tsx). Widening the onChange signature to carry
+ * a live array would break all 11 forms and buy nothing.
+ */
+export declare function RelayChangeForm({ params, onChange, relayOptions, modemId }: FormProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=RelayForms.d.ts.map

package/dist/components/order-forms/RelayForms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelayForms.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/RelayForms.tsx"],"names":[],"mappings":"AAKA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAiB,EAAE,EAAE,SAAS,+BAchF;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAiB,EAAE,EAAE,SAAS,+BA6EjF"}
+{"version":3,"file":"RelayForms.d.ts","sourceRoot":"","sources":["../../../src/components/order-forms/RelayForms.tsx"],"names":[],"mappings":"AASA,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,SAAS,+BAiBpF;AAiCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,SAAS,+BA+GrF"}

package/dist/hooks/index.d.ts

@@ -7,7 +7,7 @@ export { useSSE, setSSEDefaultMode } from './useSSE';
 export type { SSEConnectionState, SSEOptions, SSEMode, SSEModeOption } from './useSSE';
 export { useNotifications } from './useNotifications';
 export type { UseNotificationsReturn } from './useNotifications';
-export { useEnumValues } from './useEnumValues';
+export { useEnumValues, fetchEnumValues, enumValuesQueryOptions } from './useEnumValues';
 export type { EnumOption, UseEnumValuesReturn } from './useEnumValues';
 export { useOrderDetail } from './useOrderDetail';
 export type { UseOrderDetailOptions } from './useOrderDetail';

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/useEnumValues.d.ts

@@ -1,6 +1,21 @@
 export interface EnumOption {
     value: string;
     label: string;
+    /**
+     * NB-ENUM-EN-01 — the English display label: the catalogue's `enumValueEn` when
+     * the value has one, otherwise `label` — so it is never blank. In an English UI
+     * show `option.labelEn` instead of `option.label`.
+     *
+     * Optional in the type only because consumers build `EnumOption`s themselves
+     * (tests, mocks, their own cache warm-up); `useEnumValues` always fills it.
+     */
+    labelEn?: string;
+    /**
+     * NB-ENUM-EN-01 — the English label exactly as the catalogue stores it, `null`
+     * when the value has no translation. Read it when an untranslated value should
+     * fall back to something other than the Turkish `label` (e.g. a humanized key).
+     */
+    enumValueEn?: string | null;
     /**
      * NB-ENUMOPT-RELKEY-01 — the backend `EnumValueResponse.relationKey` classifies
      * an option (e.g. `FIELD_OPERATION_TITLE` values carry `relationKey="MODEM"`).
@@ -10,15 +25,65 @@ export interface EnumOption {
     relationKey?: string | null;
 }
 export interface UseEnumValuesReturn {
+    /** The catalogue, sorted by `sortOrder`. `[]` while loading and after a failed fetch — see `isError`. */
     options: EnumOption[];
     isLoading: boolean;
+    /**
+     * True when the last fetch failed (server error envelope or transport error) and
+     * there is no catalogue to show. Lets a mandatory picker say "could not load"
+     * instead of looking like an empty catalogue. Cleared by the next successful fetch.
+     *
+     * Optional in the type only because consumers declare `UseEnumValuesReturn` on their
+     * own wrappers and mocks; `useEnumValues` always fills it.
+     */
+    isError?: boolean;
 }
+/**
+ * Fetches one enum catalogue and maps it to `EnumOption`s, sorted by `sortOrder`.
+ *
+ * An error envelope REJECTS instead of resolving to `[]`. The API client reports a
+ * failed request as `{ status: "error" }` rather than throwing; resolving that to an
+ * empty list made TanStack cache "this catalogue has no values" as a SUCCESS for the
+ * full stale time, so a mandatory picker stayed empty for five minutes after a
+ * transient error, even once the server had recovered. Rejecting lets the query's
+ * retry/error semantics run and leaves nothing in the cache, so the next mount or
+ * refetch asks the server again. (HES fixed the same bug in its own prefetch copy,
+ * FIX-817 — this is the package-side root fix.)
+ *
+ * The rejection value is the envelope's `ApiError` (`{ code, … }`), or
+ * `{ code: "UNKNOWN_ERROR" }` when the envelope carries none.
+ */
+export declare function fetchEnumValues(enumCode: string): Promise<EnumOption[]>;
+/**
+ * The exact query `useEnumValues` runs — key, fetch and stale time — for a consumer
+ * that warms the cache ahead of time:
+ *
+ * ```ts
+ * void queryClient.prefetchQuery(enumValuesQueryOptions("ORDER_STATUS"));
+ * ```
+ *
+ * A prefetch built from this writes what the hook would write (same `EnumOption`
+ * shape, `labelEn` included) and follows the same error rule: a failed prefetch
+ * caches nothing, so the hook fetches on demand instead of serving a cached `[]`.
+ */
+export declare function enumValuesQueryOptions(enumCode: string): {
+    queryKey: readonly ["enums", "values", string];
+    queryFn: () => Promise<EnumOption[]>;
+    staleTime: number;
+};
 /**
  * Fetches enum values from the management API for a given enum definition code.
  * Uses TanStack Query with 5-minute stale time for caching.
  *
+ * Each option carries the Turkish `label` and the English `labelEn` (NB-ENUM-EN-01);
+ * the hook does not pick one for you — `label` stays what it always was.
+ *
+ * A failed fetch is an error, not an empty catalogue: `options` is `[]` and
+ * `isError` is true, and nothing is cached, so the next mount refetches (see
+ * `fetchEnumValues`). Retries follow the app's QueryClient defaults.
+ *
  * @param enumCode — The enum definition code (e.g. "LIFECYCLE_STATUS", "PHASE_TYPE")
- * @returns { options, isLoading } — SelectOption-compatible array
+ * @returns { options, isLoading, isError } — SelectOption-compatible array
  */
 export declare function useEnumValues(enumCode: string): UseEnumValuesReturn;
 //# sourceMappingURL=useEnumValues.d.ts.map

package/dist/hooks/useEnumValues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEnumValues.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnumValues.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAwBnE"}
+{"version":3,"file":"useEnumValues.d.ts","sourceRoot":"","sources":["../../src/hooks/useEnumValues.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,yGAAyG;IACzG,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA+CD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAW7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM;;;;EAMtD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAanE"}