@camstack/ui-library 1.2.192 → 1.2.193

package/dist/composites/clips/clip-view-state.d.ts

@@ -11,6 +11,17 @@ export interface ClipsViewInput {
      * will stay `pending` for ever.
      */
     readonly plan: ClipBandPlan;
+    /**
+     * The provider the clip list was asked of, or `null` when the camera lists
+     * NO source to ask.
+     *
+     * Naming one is required (D554 amended), so "nobody to ask" is a real state and it
+     * has to be told apart from "not answered yet": the query never fires, its
+     * status stays `pending` for ever, and a surface that only consults the
+     * status spins against a question with no addressee. Exactly the trap
+     * `too-wide` has, arriving from the other end.
+     */
+    readonly provider: string | null;
     readonly clipsStatus: ClipQueryStatus;
     readonly clips: readonly Clip[];
     readonly sourcesStatus: ClipQueryStatus;

package/dist/index.cjs

@@ -19593,11 +19593,18 @@ function resolveClipsView(input) {
 		kind: "failed",
 		message: input.sourcesError ?? "The source list could not be read"
 	};
-	if (input.clipsStatus === "pending" || input.sourcesStatus === "pending") return { kind: "loading" };
 	const notices = input.sources.map(describeSource);
 	const answered = notices.filter((notice) => notice.answered);
 	const silent = notices.filter((notice) => !notice.answered);
 	const clips = input.clips;
+	if (input.provider === null && input.sourcesStatus === "success") return {
+		kind: "empty",
+		band: input.plan.band,
+		answered,
+		silent,
+		nobodyAnswered: true
+	};
+	if (input.clipsStatus === "pending" || input.sourcesStatus === "pending") return { kind: "loading" };
 	if (clips.length === 0) return {
 		kind: "empty",
 		band: input.plan.band,
@@ -19689,23 +19696,34 @@ function resolveClipsView(input) {
 * ## Why the picker is a SELECT and not a multiselect
 *
 * The operator asked for *"un multiselect common"* while `listClips` still
-* took `sources?: string[]`. It now takes ONE `provider` — *"il get videoclips
-* prendere un provider opzionale, di default va su camstack … l'utilizzatore è
-* uno solo"* — and a multi-pick control over a one-at-a-time argument offers a
-* sum the hub cannot answer. So the control is the shared single-choice one,
-* `Select`: the same component the Recordings page's own camera picker uses,
-* which is what *"segue la nostra UI"* means here. Absent means the camera's
-* BOUND provider, and the option that carries it is labelled with that
-* provider's own sources rather than the word "default".
+* took `sources?: string[]`. It now takes ONE `provider` —
+* *"l'utilizzatore è uno solo"* — and a multi-pick control over a
+* one-at-a-time argument offers a sum the hub cannot answer. So the control is
+* the shared single-choice one, `Select`: the same component the Recordings
+* page's own camera picker uses, which is what *"segue la nostra UI"* means
+* here.
+*
+* ## The control's value is ALWAYS what the query carries
+*
+* There is no "default" option and no empty value. This section used to send
+* no `provider` at all until the operator chose, because the cap documented
+* absence as "the device's bound provider, which is CamStack on every camera".
+* No code implemented that: measured on device 592 (2026-09-20, bound to
+* `recorder` AND `provider-reolink`) a bare `listClips` with `limit: 3`
+* answered SIX rows — three per source, merged — while the default option read
+* "CamStack recordings". The label named one thing and the query asked two.
+*
+* Naming a provider is now required (D554 amended), and the default is this surface's
+* to make: the FIRST source the camera lists, shown selected in the control, so
+* what is on screen and what was asked are the same fact. A camera that lists
+* no source is asked NOTHING — the query never fires and the body says nobody
+* answered, rather than spinning against a question with no addressee.
 *
 * ## One provider is a fleet STATE
 *
-* `listSources` derives from `deviceManager.getBindings`, and today nothing
-* binds `provider-reolink` for `videoclips`, so a real camera answers with one
-* provider. The selector is then inert and SAYS why. An empty or silently
-* single-entry control would read as a defect; the binding store learning to
-* hold several providers for a collection cap is what changes this, and
-* nothing here needs to change with it.
+* `listSources` derives from `deviceManager.getBindings`. A camera bound to one
+* provider makes the selector inert, and it SAYS why: an empty or silently
+* single-entry control would read as a defect.
 */
 /** Newest-first, and bounded: a busy day on 592 lists 546 clips. */
 var CLIP_PAGE_LIMIT = 500;
@@ -19820,16 +19838,26 @@ function ClipsSection({ deviceId }) {
 	}), [view, selected]);
 	const plan = planClipBand(band);
 	const sources = useVideoclipsListSources({ deviceId });
+	const sourceRows = sources.data ?? [];
+	/**
+	* The provider the list is ASKED of: the operator's pick, else the first
+	* source the camera lists. Empty only while the camera has no source at all
+	* — and then nothing is asked, because there is nobody to ask.
+	*/
+	const askedProvider = (0, react$1.useMemo)(() => {
+		if (provider !== "") return provider;
+		return sourceRows.find((row) => row.addonId !== void 0)?.addonId ?? "";
+	}, [provider, sourceRows]);
 	const clips = useVideoclipsListClips({
 		deviceId,
 		since: band.fromMs,
 		until: band.toMs,
 		limit: CLIP_PAGE_LIMIT,
-		...provider === "" ? {} : { provider }
-	}, { enabled: plan.kind === "askable" });
-	const sourceRows = sources.data ?? [];
+		provider: askedProvider
+	}, { enabled: plan.kind === "askable" && askedProvider !== "" });
 	const clipsView = resolveClipsView({
 		plan,
+		provider: askedProvider === "" ? null : askedProvider,
 		clipsStatus: clips.status,
 		clips: clips.data ?? [],
 		sourcesStatus: sources.status,
@@ -19847,15 +19875,10 @@ function ClipsSection({ deviceId }) {
 			if (labels === void 0) byAddon.set(addonId, [row.label]);
 			else labels.push(row.label);
 		}
-		const rest = [...byAddon].map(([value, labels]) => ({
+		return [...byAddon].map(([value, labels]) => ({
 			value,
 			label: labels.join(" · ")
 		}));
-		const first = rest[0];
-		return [{
-			value: "",
-			label: first === void 0 ? "The camera’s bound provider" : first.label
-		}, ...rest.slice(1)];
 	}, [sourceRows]);
 	const tableRows = (0, react$1.useMemo)(() => sourceRows.map((row) => ({
 		notice: describeSource(row),
@@ -19933,7 +19956,7 @@ function ClipsSection({ deviceId }) {
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Select, {
 							id: "clips-provider",
 							options,
-							value: provider,
+							value: askedProvider,
 							disabled: options.length < 2,
 							onChange: (e) => pick(e.target.value)
 						})

package/dist/index.js

@@ -19569,11 +19569,18 @@ function resolveClipsView(input) {
 		kind: "failed",
 		message: input.sourcesError ?? "The source list could not be read"
 	};
-	if (input.clipsStatus === "pending" || input.sourcesStatus === "pending") return { kind: "loading" };
 	const notices = input.sources.map(describeSource);
 	const answered = notices.filter((notice) => notice.answered);
 	const silent = notices.filter((notice) => !notice.answered);
 	const clips = input.clips;
+	if (input.provider === null && input.sourcesStatus === "success") return {
+		kind: "empty",
+		band: input.plan.band,
+		answered,
+		silent,
+		nobodyAnswered: true
+	};
+	if (input.clipsStatus === "pending" || input.sourcesStatus === "pending") return { kind: "loading" };
 	if (clips.length === 0) return {
 		kind: "empty",
 		band: input.plan.band,
@@ -19665,23 +19672,34 @@ function resolveClipsView(input) {
 * ## Why the picker is a SELECT and not a multiselect
 *
 * The operator asked for *"un multiselect common"* while `listClips` still
-* took `sources?: string[]`. It now takes ONE `provider` — *"il get videoclips
-* prendere un provider opzionale, di default va su camstack … l'utilizzatore è
-* uno solo"* — and a multi-pick control over a one-at-a-time argument offers a
-* sum the hub cannot answer. So the control is the shared single-choice one,
-* `Select`: the same component the Recordings page's own camera picker uses,
-* which is what *"segue la nostra UI"* means here. Absent means the camera's
-* BOUND provider, and the option that carries it is labelled with that
-* provider's own sources rather than the word "default".
+* took `sources?: string[]`. It now takes ONE `provider` —
+* *"l'utilizzatore è uno solo"* — and a multi-pick control over a
+* one-at-a-time argument offers a sum the hub cannot answer. So the control is
+* the shared single-choice one, `Select`: the same component the Recordings
+* page's own camera picker uses, which is what *"segue la nostra UI"* means
+* here.
+*
+* ## The control's value is ALWAYS what the query carries
+*
+* There is no "default" option and no empty value. This section used to send
+* no `provider` at all until the operator chose, because the cap documented
+* absence as "the device's bound provider, which is CamStack on every camera".
+* No code implemented that: measured on device 592 (2026-09-20, bound to
+* `recorder` AND `provider-reolink`) a bare `listClips` with `limit: 3`
+* answered SIX rows — three per source, merged — while the default option read
+* "CamStack recordings". The label named one thing and the query asked two.
+*
+* Naming a provider is now required (D554 amended), and the default is this surface's
+* to make: the FIRST source the camera lists, shown selected in the control, so
+* what is on screen and what was asked are the same fact. A camera that lists
+* no source is asked NOTHING — the query never fires and the body says nobody
+* answered, rather than spinning against a question with no addressee.
 *
 * ## One provider is a fleet STATE
 *
-* `listSources` derives from `deviceManager.getBindings`, and today nothing
-* binds `provider-reolink` for `videoclips`, so a real camera answers with one
-* provider. The selector is then inert and SAYS why. An empty or silently
-* single-entry control would read as a defect; the binding store learning to
-* hold several providers for a collection cap is what changes this, and
-* nothing here needs to change with it.
+* `listSources` derives from `deviceManager.getBindings`. A camera bound to one
+* provider makes the selector inert, and it SAYS why: an empty or silently
+* single-entry control would read as a defect.
 */
 /** Newest-first, and bounded: a busy day on 592 lists 546 clips. */
 var CLIP_PAGE_LIMIT = 500;
@@ -19796,16 +19814,26 @@ function ClipsSection({ deviceId }) {
 	}), [view, selected]);
 	const plan = planClipBand(band);
 	const sources = useVideoclipsListSources({ deviceId });
+	const sourceRows = sources.data ?? [];
+	/**
+	* The provider the list is ASKED of: the operator's pick, else the first
+	* source the camera lists. Empty only while the camera has no source at all
+	* — and then nothing is asked, because there is nobody to ask.
+	*/
+	const askedProvider = useMemo(() => {
+		if (provider !== "") return provider;
+		return sourceRows.find((row) => row.addonId !== void 0)?.addonId ?? "";
+	}, [provider, sourceRows]);
 	const clips = useVideoclipsListClips({
 		deviceId,
 		since: band.fromMs,
 		until: band.toMs,
 		limit: CLIP_PAGE_LIMIT,
-		...provider === "" ? {} : { provider }
-	}, { enabled: plan.kind === "askable" });
-	const sourceRows = sources.data ?? [];
+		provider: askedProvider
+	}, { enabled: plan.kind === "askable" && askedProvider !== "" });
 	const clipsView = resolveClipsView({
 		plan,
+		provider: askedProvider === "" ? null : askedProvider,
 		clipsStatus: clips.status,
 		clips: clips.data ?? [],
 		sourcesStatus: sources.status,
@@ -19823,15 +19851,10 @@ function ClipsSection({ deviceId }) {
 			if (labels === void 0) byAddon.set(addonId, [row.label]);
 			else labels.push(row.label);
 		}
-		const rest = [...byAddon].map(([value, labels]) => ({
+		return [...byAddon].map(([value, labels]) => ({
 			value,
 			label: labels.join(" · ")
 		}));
-		const first = rest[0];
-		return [{
-			value: "",
-			label: first === void 0 ? "The camera’s bound provider" : first.label
-		}, ...rest.slice(1)];
 	}, [sourceRows]);
 	const tableRows = useMemo(() => sourceRows.map((row) => ({
 		notice: describeSource(row),
@@ -19909,7 +19932,7 @@ function ClipsSection({ deviceId }) {
 						children: /* @__PURE__ */ jsx(Select, {
 							id: "clips-provider",
 							options,
-							value: provider,
+							value: askedProvider,
 							disabled: options.length < 2,
 							onChange: (e) => pick(e.target.value)
 						})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.192",
+  "version": "1.2.193",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",