@camstack/ui-library 0.1.56 → 0.1.57

package/dist/lib/cap-error.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared capability-error utilities for the admin UI.
+ *
+ * The primary export `isAbsentProvider` lets UI components distinguish
+ * "this device doesn't have this cap" (expected — hide the widget) from
+ * "something went wrong while calling a present cap" (unexpected — surface
+ * the error to the operator).
+ *
+ * Detection strategy (two-tier):
+ *
+ *   1. **Typed reason** (preferred): tRPC's errorFormatter augments the
+ *      error shape with `data.capRouteReason` when the server throws a
+ *      CapRouteError. Read it from `err.data?.capRouteReason` to avoid
+ *      brittle string matching.
+ *
+ *   2. **Substring fallback** (transitional safety): older error paths
+ *      that don't carry a typed reason still emit the human-readable
+ *      message "provider not available". The fallback is ONLY engaged
+ *      when `capRouteReason` is absent — future clean-up can drop it
+ *      once every throw site has been migrated.
+ */
+/**
+ * Returns `true` when `err` indicates that the requested capability has
+ * no provider bound for the device — i.e. the device legitimately does
+ * not expose this cap and the UI should stay hidden / show a friendly
+ * "not supported" message.
+ *
+ * Returns `false` for real dispatch errors (`transport-failed`) — those
+ * should be surfaced to the operator as unexpected failures.
+ *
+ * ## Absent-provider reasons
+ * - `'no-provider'`  — no provider is registered for this cap/device pair.
+ * - `'node-offline'` — the node that hosts the cap is not reachable; the
+ *   device is effectively unavailable so we treat it as absent.
+ *
+ * ## Not-absent reasons
+ * - `'transport-failed'` — a provider exists but the call failed in transit.
+ * - `'cap-unknown'`      — the cap name isn't registered at all; treat as
+ *   a real error (likely a programming mistake or version skew).
+ */
+export declare function isAbsentProvider(err: unknown): boolean;

package/dist/lib/index.d.ts

@@ -1,4 +1,5 @@
 export { cn } from './cn';
+export { isAbsentProvider } from './cap-error';
 export * from './responsive';
 export { mirror } from './pipeline-mirror';
 export type { MirrorSource, MirrorInput, MirrorOutcome, MirrorResultEntry, } from './pipeline-mirror';

package/package.json

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

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

@@ -1,9 +0,0 @@
-import { MotionZoneOptions } from '@camstack/types';
-export interface MotionGridCanvasProps {
-    /** Fixed lattice dimensions — from the cap's `getOptions`. */
-    readonly options: MotionZoneOptions;
-    /** Row-major active-cell grid, length === gridWidth*gridHeight. */
-    readonly cells: readonly boolean[];
-    readonly onCellsChange: (next: boolean[]) => void;
-}
-export declare function MotionGridCanvas({ options, cells, onCellsChange }: MotionGridCanvasProps): import("react/jsx-runtime").JSX.Element;