@camstack/ui-library 1.2.51 → 1.2.52

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

@@ -26,13 +26,23 @@
  *    and Night (IR), each forcing a fresh snapshot. The variant is DETECTED
  *    from the frame and shown rather than asked; the buttons exist so the
  *    operator can say "capture this as the night reference" while standing
- *    outside at 22:00.
- * 3. **Read the coverage line.** "Daylight ✓ · Night (IR) ✗ — reports 'can't
- *    tell' in night (ir)". This feature's failure mode is silence that reads as
- *    "nothing has happened", and that one line is the difference between a
- *    five-minute fix and a session of guessing.
+ *    outside at 22:00 — which is exactly why **Night (IR) is labelled
+ *    optional**. Almost nobody does that, and a scene captured only in daylight
+ *    is a configuration, not a defect: under the default
+ *    `onUncoveredCondition: 'skip'` the infrared hours are simply sat out.
+ * 3. **Read the coverage line.** "Daylight ✓ · Night (IR) ✗ — optional; checks
+ *    in night (ir) are skipped". This feature's failure mode is silence that
+ *    reads as "nothing has happened", and that one line is the difference
+ *    between a five-minute fix and a session of guessing — but it must say what
+ *    HAPPENS, not complain. It used to end "reports 'can't tell'", which made a
+ *    correctly configured scene look broken every night.
  * 4. **Reset.** Clears the flag AND re-captures the baseline for the current
  *    light, because the bin never goes back in exactly the same spot.
+ * 5. **Settings.** Every knob the model has actually carried since the provider
+ *    shipped — how often it looks, how closely it has to match, how many
+ *    agreeing checks a change costs, what a missing light means, which boolean
+ *    drives notifications, and whether a vision model adjudicates a flip. None
+ *    of it was reachable before; see `SceneSettingsForm`.
  *
  * Live state arrives through the cap's `status.kind: 'push'` runtime slice, so
  * the card updates itself without polling.

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

@@ -0,0 +1,36 @@
+import { SceneMonitor, SceneReference } from '@camstack/types';
+/** The hub-proxied prefix for the pipeline-analytics event-media data plane. */
+export declare const SCENE_MEDIA_BASE = "/addon/pipeline-analytics/event-media";
+/** One reference, with the coordinates `deleteReference` addresses it by. */
+export interface SceneReferenceTile {
+    readonly stateId: string;
+    /** Index into THAT state's `references` array — the cap's own addressing. */
+    readonly index: number;
+    readonly reference: SceneReference;
+}
+export interface SceneReferenceGroup {
+    readonly condition: string;
+    readonly tiles: readonly SceneReferenceTile[];
+}
+/**
+ * Flatten `states[].references[]` into per-condition groups while keeping each
+ * reference's `(stateId, index)` — the pair `deleteReference` takes.
+ *
+ * The index is deliberately the position in the state's OWN array rather than
+ * anything derived from the grouping: an index computed over the grouped view
+ * would address a different reference the moment a scene holds two conditions,
+ * and the operator would delete the wrong photograph with no way to tell.
+ */
+export declare function groupReferences(monitor: SceneMonitor): readonly SceneReferenceGroup[];
+/** Total references across every state — the count that decides whether a
+ *  delete leaves the scene with no idea what "normal" looks like. */
+export declare function totalReferences(monitor: SceneMonitor): number;
+export interface SceneReferenceGalleryProps {
+    readonly monitor: SceneMonitor;
+    readonly disabled: boolean;
+    readonly onDelete: (input: {
+        stateId: string;
+        index: number;
+    }) => void;
+}
+export declare function SceneReferenceGallery({ monitor, disabled, onDelete }: SceneReferenceGalleryProps): import("react").JSX.Element;

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

@@ -0,0 +1,21 @@
+import { SceneCheck, SceneMonitor, SceneUncoveredPolicy } from '@camstack/types';
+/** The subset of `updateScene`'s patch this form can produce. */
+export interface SceneSettingsPatch {
+    readonly label?: string;
+    readonly enabled?: boolean;
+    readonly triggerMode?: SceneMonitor['triggerMode'];
+    readonly checkIntervalSec?: number;
+    readonly check?: SceneCheck;
+    readonly quietSeconds?: number;
+    readonly minObservationSpacingSec?: number;
+    readonly emit?: SceneMonitor['emit'];
+    readonly autoRestore?: boolean;
+    readonly onUncoveredCondition?: SceneUncoveredPolicy;
+    readonly confirm?: SceneMonitor['confirm'] | null;
+}
+export interface SceneSettingsFormProps {
+    readonly monitor: SceneMonitor;
+    readonly disabled: boolean;
+    readonly onPatch: (patch: SceneSettingsPatch) => void;
+}
+export declare function SceneSettingsForm({ monitor, disabled, onPatch }: SceneSettingsFormProps): import("react").JSX.Element;

package/dist/composites/cap-settings/scene-monitor-copy.d.ts

@@ -1,26 +1,58 @@
 import { SceneMonitor } from '@camstack/types';
-/** The lighting variants an operator is asked to capture. The resolver can also
- *  report `night`, `dawn` and `dusk`; those are shown when present but never
- *  demanded, because most installs only ever see day and IR. */
+/** The lighting variants an operator is OFFERED. The resolver can also report
+ *  `night`, `dawn` and `dusk`; those are shown when present but never demanded,
+ *  because most installs only ever see day and IR. */
 export declare const SCENE_CAPTURE_VARIANTS: readonly ["day", "ir"];
 export type SceneCaptureVariant = (typeof SCENE_CAPTURE_VARIANTS)[number];
+/**
+ * The one variant that is genuinely optional.
+ *
+ * Nobody stands outside at 22:00 to photograph a wheelie bin in infrared, and
+ * plenty of scenes are daytime questions that never need a night reference at
+ * all. Every sentence about IR in this file is written from that premise: a
+ * missing night reference is a CHOICE the scene accommodates, never a fault it
+ * reports. The engine backs that up — under the default
+ * `onUncoveredCondition: 'skip'` the night checks are simply not made.
+ */
+export declare const SCENE_OPTIONAL_VARIANT: SceneCaptureVariant;
 export declare const VARIANT_LABEL: Readonly<Record<string, string>>;
 export declare function variantLabel(condition: string): string;
 /**
- * "day ✓ · ir ✗ — this scene reports UNKNOWN at night."
+ * "Daylight ✓ · Night (IR) ✗ — optional; checks in night (ir) are skipped."
  *
  * Converts the silent cross-condition fallback this engine used to have into an
  * operator-visible fact. Without it, a scene with only a daylight reference
  * simply stops answering after sunset and nothing anywhere says why.
+ *
+ * It used to end *"reports 'can't tell' in night (ir)"*, which was accurate and
+ * read as a defect: the operator saw a ✗ and a complaint for a scene that was
+ * configured exactly as they meant it. The missing half is now named as what it
+ * is — the part you do not have to do — and the sentence says what actually
+ * happens instead, which differs by the scene's own policy.
  */
 export declare function coverageLine(monitor: SceneMonitor): string;
+/**
+ * The calm sentence for a scene that is sitting the current light out — `null`
+ * whenever it is checking normally.
+ *
+ * Separate from {@link statusLine} because it is not a verdict and must not
+ * read like one. A paused scene has not failed, has not lost its flag, and
+ * needs nothing from the operator; the only thing worth saying is which light
+ * it is waiting out and that it will pick itself back up.
+ */
+export declare function suspensionLine(monitor: SceneMonitor): string | null;
 /**
  * The one line under a scene's name. It answers, in order: can it judge, what
  * does it say, and how long has it said it.
  */
 export declare function statusLine(monitor: SceneMonitor, now: number): string;
 /** The badge word. `latched` wins over `verdict`, because the latch is the
- *  thing the operator asked to be told and it outlives the live state. */
+ *  thing the operator asked to be told and it outlives the live state.
+ *
+ *  A scene sitting out an uncovered light reads `Paused`, in the NEUTRAL tone —
+ *  never `alarm`, and never the `danger` variant the page maps that to. A
+ *  missing IR reference must not be able to paint a red badge on a scene that
+ *  is doing exactly what it was configured to do. */
 export declare function badgeFor(monitor: SceneMonitor): {
     text: string;
     tone: 'alarm' | 'ok' | 'unknown';

package/dist/index.cjs

@@ -22758,7 +22758,13 @@ var Skeleton = (0, react$1.forwardRef)(({ className, ...props }, ref) => {
 Skeleton.displayName = "Skeleton";
 //#endregion
 //#region src/primitives/input.tsx
-var inputVariants = cva("h-7 w-full px-2.5 text-xs bg-surface border rounded-md text-foreground placeholder:text-foreground-subtle focus:outline-none focus:ring-1 focus:ring-primary transition-colors", {
+/**
+* `disabled:opacity-50 disabled:cursor-not-allowed` for the same reason as
+* `Select` — an explicit `bg-surface` / `text-foreground` overrides the greying
+* a browser would otherwise apply, leaving an inert field indistinguishable
+* from a live one. See `disabled-affordance.test.tsx`.
+*/
+var inputVariants = cva("h-7 w-full px-2.5 text-xs bg-surface border rounded-md text-foreground placeholder:text-foreground-subtle focus:outline-none focus:ring-1 focus:ring-primary transition-colors disabled:opacity-50 disabled:cursor-not-allowed", {
 	variants: { state: {
 		default: "border-border",
 		error: "border-danger"
@@ -22793,19 +22799,36 @@ var Input = (0, react$1.forwardRef)(({ className, state, leftSlot, rightSlot, ..
 Input.displayName = "Input";
 //#endregion
 //#region src/primitives/select.tsx
-var Select = (0, react$1.forwardRef)(({ className, options, ...props }, ref) => {
+/**
+* A native `<select>` styled to match the rest of the field set.
+*
+* `appearance-none` plus an explicit `bg-surface` / `text-foreground` is what
+* makes it match — and it is also what USED to make a disabled one a lie. A
+* browser greys a disabled control by rendering its own background and text
+* colour; all three of those are overridden here, so a `disabled` dropdown
+* looked exactly like a live one and simply ignored the click. That is the
+* whole of the "the language selector does not open" report of 2026-08-15:
+* the AI section's switch was off, every control under it was correctly inert,
+* and nothing on screen said so.
+*
+* `disabled:` classes belong HERE and not on each call site: there are dozens
+* of `<Select disabled>` in this app and the one that gets forgotten is the one
+* that generates the ticket. Guarded by `disabled-affordance.test.tsx`.
+*/
+var Select = (0, react$1.forwardRef)(({ className, options, disabled, ...props }, ref) => {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "relative w-full",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
 			ref,
-			className: cn("h-7 w-full px-2.5 text-xs bg-surface border border-border rounded-md text-foreground appearance-none pr-7 focus:outline-none focus:ring-1 focus:ring-primary", className),
+			disabled,
+			className: cn("h-7 w-full px-2.5 text-xs bg-surface border border-border rounded-md text-foreground appearance-none pr-7 focus:outline-none focus:ring-1 focus:ring-primary", "disabled:opacity-50 disabled:cursor-not-allowed", className),
 			...props,
 			children: options.map((option) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
 				value: option.value,
 				children: option.label
 			}, option.value))
 		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-			className: "absolute right-2 top-1/2 -translate-y-1/2 pointer-events-none text-foreground-muted",
+			className: cn("absolute right-2 top-1/2 -translate-y-1/2 pointer-events-none text-foreground-muted", disabled === true ? "opacity-50" : ""),
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ChevronDown, { className: "h-3.5 w-3.5" })
 		})]
 	});
@@ -25567,9 +25590,9 @@ async function waitForIceGathering(pc) {
 }
 //#endregion
 //#region src/composites/cap-settings/scene-monitor-copy.ts
-/** The lighting variants an operator is asked to capture. The resolver can also
-*  report `night`, `dawn` and `dusk`; those are shown when present but never
-*  demanded, because most installs only ever see day and IR. */
+/** The lighting variants an operator is OFFERED. The resolver can also report
+*  `night`, `dawn` and `dusk`; those are shown when present but never demanded,
+*  because most installs only ever see day and IR. */
 var SCENE_CAPTURE_VARIANTS = ["day", "ir"];
 var VARIANT_LABEL = {
 	day: "Daylight",
@@ -25582,11 +25605,17 @@ function variantLabel(condition) {
 	return VARIANT_LABEL[condition] ?? condition;
 }
 /**
-* "day ✓ · ir ✗ — this scene reports UNKNOWN at night."
+* "Daylight ✓ · Night (IR) ✗ — optional; checks in night (ir) are skipped."
 *
 * Converts the silent cross-condition fallback this engine used to have into an
 * operator-visible fact. Without it, a scene with only a daylight reference
 * simply stops answering after sunset and nothing anywhere says why.
+*
+* It used to end *"reports 'can't tell' in night (ir)"*, which was accurate and
+* read as a defect: the operator saw a ✗ and a complaint for a scene that was
+* configured exactly as they meant it. The missing half is now named as what it
+* is — the part you do not have to do — and the sentence says what actually
+* happens instead, which differs by the scene's own policy.
 */
 function coverageLine(monitor) {
 	const covered = new Set(monitor.coveredConditions);
@@ -25595,10 +25624,26 @@ function coverageLine(monitor) {
 	for (const c of extra) parts.push(`${variantLabel(c)} ✓`);
 	const missing = SCENE_CAPTURE_VARIANTS.filter((v) => !covered.has(v));
 	if (missing.length === 0) return parts.join(" · ");
-	return `${parts.join(" · ")} — reports “can’t tell” in ${missing.map((v) => variantLabel(v).toLowerCase()).join(" and ")}`;
+	if (covered.size === 0) return `${parts.join(" · ")} — nothing captured yet, so this scene is not watching.`;
+	const names = missing.map((v) => variantLabel(v).toLowerCase()).join(" and ");
+	return monitor.onUncoveredCondition === "judge-anyway" ? `${parts.join(" · ")} — ${names} judged against the references you do have.` : `${parts.join(" · ")} — optional; checks in ${names} are skipped.`;
+}
+/**
+* The calm sentence for a scene that is sitting the current light out — `null`
+* whenever it is checking normally.
+*
+* Separate from {@link statusLine} because it is not a verdict and must not
+* read like one. A paused scene has not failed, has not lost its flag, and
+* needs nothing from the operator; the only thing worth saying is which light
+* it is waiting out and that it will pick itself back up.
+*/
+function suspensionLine(monitor) {
+	if (monitor.suspendedCondition === null) return null;
+	const light = variantLabel(monitor.suspendedCondition).toLowerCase();
+	return `Paused — nothing was captured in ${light}, so checks are on hold until the light changes back. Capture ${light} if you want it watched around the clock.`;
 }
 var UNAVAILABLE_SENTENCE = {
-	"no-reference-for-condition": "can’t tell — nothing was captured in this light yet. Use “Capture now” when the camera is in it.",
+	"no-reference-for-condition": "can’t tell — nothing has been captured for this scene yet. Press “Capture daylight” to photograph what normal looks like.",
 	"view-shifted": "can’t tell — the camera view has moved since the reference was captured. Re-capture it.",
 	"no-vision-profile": "can’t tell — the vision model is unreachable, so the change is on hold.",
 	"encoder-model-changed": "can’t tell — the embedding model changed, so the stored references are unreadable. Re-capture them.",
@@ -25614,10 +25659,17 @@ function statusLine(monitor, now) {
 	const since = monitor.verdict === "diverged" ? monitor.divergedAt : monitor.armedAt;
 	const held = since !== null ? ` for ${humanDuration(Math.max(0, now - since))}` : "";
 	if (monitor.latched) return monitor.verdict === "diverged" ? `CHANGED${held} — press Reset when you have dealt with it.` : `Back to normal, but still flagged as changed${held}. Press Reset to clear it.`;
+	const paused = suspensionLine(monitor);
+	if (paused !== null) return paused;
 	return monitor.verdict === "diverged" ? `CHANGED${held}` : `Normal${held}`;
 }
 /** The badge word. `latched` wins over `verdict`, because the latch is the
-*  thing the operator asked to be told and it outlives the live state. */
+*  thing the operator asked to be told and it outlives the live state.
+*
+*  A scene sitting out an uncovered light reads `Paused`, in the NEUTRAL tone —
+*  never `alarm`, and never the `danger` variant the page maps that to. A
+*  missing IR reference must not be able to paint a red badge on a scene that
+*  is doing exactly what it was configured to do. */
 function badgeFor(monitor) {
 	if (monitor.states.length === 0) return {
 		text: "Not armed",
@@ -25627,6 +25679,10 @@ function badgeFor(monitor) {
 		text: "Changed",
 		tone: "alarm"
 	};
+	if (monitor.suspendedCondition !== null) return {
+		text: "Paused",
+		tone: "unknown"
+	};
 	if (monitor.verdict === "unknown") return {
 		text: "Can’t tell",
 		tone: "unknown"
@@ -48647,7 +48703,7 @@ var MotionZonesSettings = (0, react$1.lazy)(() => Promise.resolve().then(() => r
 /** Lazy-wrapped `SceneMonitorEditor` — code-split off the main bundle for the
 *  same reason: it mounts `MaskShapeCanvas`, which chains react-konva. Render
 *  inside `<Suspense>`; the admin-ui `/scenes` dialog is its only caller. */
-var SceneMonitorEditor = (0, react$1.lazy)(() => Promise.resolve().then(() => require("./SceneMonitorEditor-CfSrNccC.cjs")).then((m) => ({ default: m.SceneMonitorEditor })));
+var SceneMonitorEditor = (0, react$1.lazy)(() => Promise.resolve().then(() => require("./SceneMonitorEditor-DN2ILWCf.cjs")).then((m) => ({ default: m.SceneMonitorEditor })));
 /** Lazy-wrapped `PrivacyMaskSettings` — code-split off the main bundle. */
 var PrivacyMaskSettings = (0, react$1.lazy)(() => Promise.resolve().then(() => require("./PrivacyMaskSettings-Oo7gyB4E.cjs")).then((m) => ({ default: m.PrivacyMaskSettings })));
 //#endregion
@@ -48783,6 +48839,7 @@ exports.IconAction = IconAction;
 exports.IconButton = IconButton;
 exports.ImageHeroCard = ImageHeroCard;
 exports.ImageInlineControl = ImageInlineControl;
+exports.ImageOff = ImageOff;
 exports.ImageSelector = ImageSelector;
 exports.InferenceConfigSelector = InferenceConfigSelector;
 exports.Input = Input;