@viamrobotics/test-widgets 0.7.0 → 0.8.0

package/dist/components/widgets/power-sensor/get-power-widget.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import { PowerSensorClient } from '@viamrobotics/sdk'
+	import { createResourceClient, createResourceQuery } from '@viamrobotics/svelte-sdk'
+
+	import ApiSection from '../../api-section.svelte'
+	import Query from '../../query.svelte'
+
+	import PowerReading from './power-reading.svelte'
+
+	interface Props {
+		partID: string
+		resourceName: string
+	}
+
+	const { partID, resourceName }: Props = $props()
+
+	const client = createResourceClient(
+		PowerSensorClient,
+		() => partID,
+		() => resourceName
+	)
+
+	const query = createResourceQuery(client, 'getPower', { refetchInterval: 500 })
+</script>
+
+<ApiSection
+	title="GetPower"
+	class="grow"
+>
+	<Query
+		{query}
+		contentCx="h-6"
+	>
+		{#if query.data !== undefined}
+			<PowerReading data={query.data} />
+		{/if}
+	</Query>
+</ApiSection>

package/dist/components/widgets/power-sensor/get-power-widget.svelte.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    partID: string;
+    resourceName: string;
+}
+declare const GetPowerWidget: import("svelte").Component<Props, {}, "">;
+type GetPowerWidget = ReturnType<typeof GetPowerWidget>;
+export default GetPowerWidget;

package/dist/components/widgets/power-sensor/get-voltage-widget.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import { PowerSensorClient } from '@viamrobotics/sdk'
+	import { createResourceClient, createResourceQuery } from '@viamrobotics/svelte-sdk'
+
+	import ApiSection from '../../api-section.svelte'
+	import Query from '../../query.svelte'
+
+	import VoltageReading from './voltage-reading.svelte'
+
+	interface Props {
+		partID: string
+		resourceName: string
+	}
+
+	const { partID, resourceName }: Props = $props()
+
+	const client = createResourceClient(
+		PowerSensorClient,
+		() => partID,
+		() => resourceName
+	)
+
+	const query = createResourceQuery(client, 'getVoltage', { refetchInterval: 500 })
+</script>
+
+<ApiSection
+	title="GetVoltage"
+	class="grow"
+>
+	<Query
+		{query}
+		contentCx="h-6"
+	>
+		{#if query.data !== undefined}
+			<VoltageReading data={query.data} />
+		{/if}
+	</Query>
+</ApiSection>

package/dist/components/widgets/power-sensor/get-voltage-widget.svelte.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    partID: string;
+    resourceName: string;
+}
+declare const GetVoltageWidget: import("svelte").Component<Props, {}, "">;
+type GetVoltageWidget = ReturnType<typeof GetVoltageWidget>;
+export default GetVoltageWidget;

package/dist/components/widgets/servo/is-moving-widget.svelte

@@ -0,0 +1,20 @@
+<script lang="ts">
+	import { ServoClient } from '@viamrobotics/sdk'
+
+	import IsMoving from '../../is-moving.svelte'
+	import { ResourceTriplets } from '../../../resource-triplet'
+
+	interface Props {
+		partID: string
+		resourceName: string
+	}
+
+	const { partID, resourceName }: Props = $props()
+</script>
+
+<IsMoving
+	client={ServoClient}
+	api={ResourceTriplets.Servo}
+	{partID}
+	{resourceName}
+/>

package/dist/components/widgets/servo/is-moving-widget.svelte.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    partID: string;
+    resourceName: string;
+}
+declare const IsMovingWidget: import("svelte").Component<Props, {}, "">;
+type IsMovingWidget = ReturnType<typeof IsMovingWidget>;
+export default IsMovingWidget;

package/dist/components/widgets/slam/get-position-widget.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import { SlamClient } from '@viamrobotics/sdk'
+	import { createResourceClient, createResourceQuery } from '@viamrobotics/svelte-sdk'
+
+	import ApiSection from '../../api-section.svelte'
+	import Query from '../../query.svelte'
+
+	import Position from './position.svelte'
+
+	interface Props {
+		partID: string
+		resourceName: string
+	}
+
+	const { partID, resourceName }: Props = $props()
+
+	const client = createResourceClient(
+		SlamClient,
+		() => partID,
+		() => resourceName
+	)
+
+	const query = createResourceQuery(client, 'getPosition', { refetchInterval: 1000 })
+</script>
+
+<ApiSection
+	title="GetPosition"
+	class="grow"
+>
+	<Query
+		{query}
+		contentCx="h-6"
+	>
+		{#if query.data !== undefined}
+			<Position position={query.data} />
+		{/if}
+	</Query>
+</ApiSection>

package/dist/components/widgets/slam/get-position-widget.svelte.d.ts

@@ -0,0 +1,7 @@
+interface Props {
+    partID: string;
+    resourceName: string;
+}
+declare const GetPositionWidget: import("svelte").Component<Props, {}, "">;
+type GetPositionWidget = ReturnType<typeof GetPositionWidget>;
+export default GetPositionWidget;

package/dist/components/widgets/vision-service/vision-service.svelte

@@ -147,16 +147,15 @@
 						</Select>
 					</Label>
 				</div>
-				<Label
-					cx="w-fit"
-					position="top"
-				>
-					Is remote?
-					<Switch
-						slot="input"
-						bind:on={isRemote}
-					/>
-				</Label>
+				<div class="w-fit">
+					<Label position="top">
+						Is remote?
+						<Switch
+							slot="input"
+							bind:on={isRemote}
+						/>
+					</Label>
+				</div>
 			</div>
 
 			<h6 class="text-subtle-1 font-semibold">Detections/Classifications</h6>

package/dist/index.d.ts

@@ -4,4 +4,7 @@ export { clientForResource } from './client-map';
 export * from './components';
 export { getResourceAPI } from './get-resource-api';
 export { providePip, usePip } from './pip/context.svelte';
-export { hasWidget, showResourceWidget, widgetForResource } from './resource';
+export { ResourceTriplets } from './resource-triplet';
+export { apiWidgetsForResource, availableAPIWidgets, isKnownResource, 
+/** @deprecated use `isKnownResource` instead. Will be deleted in the next release  */
+isKnownResource as hasWidget, type ResourceAPIWidget, showResourceWidget, widgetForResource, } from './resource-widget';

package/dist/index.js

@@ -4,4 +4,8 @@ export { clientForResource } from './client-map';
 export * from './components';
 export { getResourceAPI } from './get-resource-api';
 export { providePip, usePip } from './pip/context.svelte';
-export { hasWidget, showResourceWidget, widgetForResource } from './resource';
+export { ResourceTriplets } from './resource-triplet';
+export { apiWidgetsForResource, availableAPIWidgets, isKnownResource, 
+// TODO: Delete `hasWidget`
+/** @deprecated use `isKnownResource` instead. Will be deleted in the next release  */
+isKnownResource as hasWidget, showResourceWidget, widgetForResource, } from './resource-widget';

package/dist/pip/context.svelte.d.ts

@@ -2,6 +2,8 @@ interface PipContext {
     /** Called by PictureInPictureButton to start or stop PiP. */
     toggle(resourceName: string): Promise<void>;
     setRate(rate: 'live' | number | false): void;
+    /** Register the media stream from the main camera view when its card is open. */
+    setStream(resourceName: string, stream: MediaStream | null): void;
     error: Error | undefined;
     /** Whether the PictureInPicture is active */
     readyState: 'inactive' | 'loading' | 'active';

package/dist/pip/context.svelte.js

@@ -14,12 +14,21 @@ export function providePip(partID) {
     const canvasCtx = canvas.getContext('2d');
     const canvasStream = canvas.captureStream();
     const img = document.createElement('img');
+    const externalStreams = new Map();
+    let externalStreamVersion = $state(0);
     let error = $state();
     let readyState = $state('inactive');
     let rate = $state('live');
     let activeName = $state();
-    const cameraClient = $derived(activeName ? createResourceClient(CameraClient, partID, () => activeName ?? '') : undefined);
-    const streamClient = $derived(activeName ? createStreamClient(partID, () => activeName ?? '') : undefined);
+    const externalStream = $derived.by(() => {
+        void externalStreamVersion;
+        return activeName ? externalStreams.get(activeName) : undefined;
+    });
+    const needsOwnedStream = $derived(activeName !== undefined && !externalStream);
+    const cameraClient = $derived(needsOwnedStream && activeName
+        ? createResourceClient(CameraClient, partID, () => activeName ?? '')
+        : undefined);
+    const streamClient = $derived(needsOwnedStream && activeName ? createStreamClient(partID, () => activeName ?? '') : undefined);
     const imageQuery = $derived(cameraClient?.current
         ? createResourceQuery(cameraClient, 'getImages', () => ({
             enabled: rate !== 'live',
@@ -27,22 +36,39 @@ export function providePip(partID) {
             refetchIntervalInBackground: activeName === cameraClient?.current?.name,
         }))
         : undefined);
-    const mediaStream = $derived((rate === 'live' ? streamClient?.mediaStream : canvasStream) ?? null);
+    const ownedMediaStream = $derived(needsOwnedStream ? ((rate === 'live' ? streamClient?.mediaStream : canvasStream) ?? null) : null);
+    const playbackStream = $derived(externalStream ?? ownedMediaStream);
+    const setStream = (resourceName, stream) => {
+        if (stream) {
+            externalStreams.set(resourceName, stream);
+        }
+        else {
+            externalStreams.delete(resourceName);
+        }
+        externalStreamVersion++;
+    };
     $effect(() => {
         document.body.append(video);
+        const handleLeave = () => {
+            readyState = 'inactive';
+            activeName = undefined;
+            error = undefined;
+        };
+        video.addEventListener('leavepictureinpicture', handleLeave);
         return () => {
+            video.removeEventListener('leavepictureinpicture', handleLeave);
             video.remove();
         };
     });
     $effect(() => {
-        video.srcObject = mediaStream;
+        video.srcObject = playbackStream;
         return () => {
             video.srcObject = null;
         };
     });
     $effect(() => {
         const currentRate = rate;
-        if (currentRate === 'live')
+        if (!needsOwnedStream || currentRate === 'live')
             return;
         const image = imageQuery?.data?.images[0];
         if (!image)
@@ -64,12 +90,11 @@ export function providePip(partID) {
             img.removeEventListener('load', drawImage);
         };
     });
-    const toggle = async () => {
-        if (activeName === undefined &&
-            readyState === 'active' &&
-            document.pictureInPictureElement === video) {
+    const toggle = async (resourceName) => {
+        if (activeName === resourceName && document.pictureInPictureElement === video) {
             try {
                 await document.exitPictureInPicture();
+                activeName = undefined;
                 readyState = 'inactive';
                 error = undefined;
             }
@@ -78,28 +103,31 @@ export function providePip(partID) {
             }
             return;
         }
+        activeName = resourceName;
         readyState = 'loading';
-        // Wait for the new stream's metadata to load before requesting PiP,
-        // otherwise the browser throws InvalidStateError.
-        if (video.readyState < 1 /* HAVE_METADATA */) {
-            await new Promise((resolve) => {
-                video.addEventListener('loadedmetadata', () => resolve(), { once: true });
-            });
-        }
         try {
+            const stream = ownedMediaStream;
+            video.srcObject = stream;
+            // Wait for the stream's metadata to load before requesting PiP,
+            // otherwise the browser throws InvalidStateError.
+            if (video.readyState < 1 /* HAVE_METADATA */) {
+                await new Promise((resolve) => {
+                    video.addEventListener('loadedmetadata', () => resolve(), { once: true });
+                });
+            }
             await video.requestPictureInPicture();
             readyState = 'active';
             error = undefined;
         }
         catch (nextError) {
+            readyState = 'inactive';
+            activeName = undefined;
             error = nextError;
         }
     };
     const context = {
-        async toggle(resourceName) {
-            activeName = activeName === resourceName ? undefined : resourceName;
-            await toggle();
-        },
+        toggle,
+        setStream,
         setRate(newRate) {
             rate = newRate;
         },

package/dist/resource-triplet.d.ts

@@ -0,0 +1,37 @@
+/** The canonical set of Viam resource API triplets. */
+export declare const ResourceTriplets: {
+    readonly Arm: "rdk:component:arm";
+    readonly AudioInput: "rdk:component:audio_in";
+    readonly AudioOutput: "rdk:component:audio_out";
+    readonly Base: "rdk:component:base";
+    readonly Board: "rdk:component:board";
+    readonly Button: "rdk:component:button";
+    readonly Camera: "rdk:component:camera";
+    readonly Encoder: "rdk:component:encoder";
+    readonly Gantry: "rdk:component:gantry";
+    readonly GenericComponent: "rdk:component:generic";
+    readonly Gripper: "rdk:component:gripper";
+    readonly InputController: "rdk:component:input_controller";
+    readonly Motor: "rdk:component:motor";
+    readonly MovementSensor: "rdk:component:movement_sensor";
+    readonly PoseTracker: "rdk:component:pose_tracker";
+    readonly PowerSensor: "rdk:component:power_sensor";
+    readonly Sensor: "rdk:component:sensor";
+    readonly Servo: "rdk:component:servo";
+    readonly Switch: "rdk:component:switch";
+    readonly BaseRemoteControl: "rdk:service:base_remote_control";
+    readonly DataManager: "rdk:service:data_manager";
+    readonly Discovery: "rdk:service:discovery";
+    readonly GenericService: "rdk:service:generic";
+    readonly MLModel: "rdk:service:mlmodel";
+    readonly Motion: "rdk:service:motion";
+    readonly Navigation: "rdk:service:navigation";
+    readonly Slam: "rdk:service:slam";
+    readonly Sensors: "rdk:service:sensors";
+    readonly Shell: "rdk:service:shell";
+    readonly Video: "rdk:service:video";
+    readonly Vision: "rdk:service:vision";
+    readonly WorldStateStore: "rdk:service:world_state_store";
+};
+/** A Viam resource API triplet, e.g. `'rdk:component:arm'`. */
+export type ResourceTriplet = (typeof ResourceTriplets)[keyof typeof ResourceTriplets];

package/dist/resource-triplet.js

@@ -0,0 +1,37 @@
+/** The canonical set of Viam resource API triplets. */
+export const ResourceTriplets = {
+    // components
+    Arm: 'rdk:component:arm',
+    AudioInput: 'rdk:component:audio_in',
+    AudioOutput: 'rdk:component:audio_out',
+    Base: 'rdk:component:base',
+    Board: 'rdk:component:board',
+    Button: 'rdk:component:button',
+    Camera: 'rdk:component:camera',
+    Encoder: 'rdk:component:encoder',
+    Gantry: 'rdk:component:gantry',
+    GenericComponent: 'rdk:component:generic',
+    Gripper: 'rdk:component:gripper',
+    InputController: 'rdk:component:input_controller',
+    Motor: 'rdk:component:motor',
+    MovementSensor: 'rdk:component:movement_sensor',
+    PoseTracker: 'rdk:component:pose_tracker',
+    PowerSensor: 'rdk:component:power_sensor',
+    Sensor: 'rdk:component:sensor',
+    Servo: 'rdk:component:servo',
+    Switch: 'rdk:component:switch',
+    // services
+    BaseRemoteControl: 'rdk:service:base_remote_control',
+    DataManager: 'rdk:service:data_manager',
+    Discovery: 'rdk:service:discovery',
+    GenericService: 'rdk:service:generic',
+    MLModel: 'rdk:service:mlmodel',
+    Motion: 'rdk:service:motion',
+    Navigation: 'rdk:service:navigation',
+    Slam: 'rdk:service:slam',
+    Sensors: 'rdk:service:sensors',
+    Shell: 'rdk:service:shell',
+    Video: 'rdk:service:video',
+    Vision: 'rdk:service:vision',
+    WorldStateStore: 'rdk:service:world_state_store',
+};

package/dist/resource-widget.js

@@ -0,0 +1,187 @@
+import { ArmGetJointPositionsWidget, ArmIsMovingWidget, ArmMoveToJointPositionsWidget, ArmMoveToPositionWidget, ArmQuickMoveWidget, ArmWidget, AudioInputGetPropertiesWidget, AudioInputWidget, AudioOutputGetPropertiesWidget, AudioOutputWidget, BaseIsMovingWidget, BaseMoveStraightWidget, BaseQuickMoveWidget, BaseSetPowerWidget, BaseSetVelocityWidget, BaseSpinWidget, BaseWidget, BoardWidget, ButtonWidget, CameraWidget, DiscoveryWidget, EncoderGetPositionWidget, EncoderWidget, GantryGetPositionWidget, GantryHomeWidget, GantryIsMovingWidget, GantryMoveToPositionWidget, GantryQuickMoveWidget, GantryWidget, GripperGrabWidget, GripperIsHoldingSomethingWidget, GripperIsMovingWidget, GripperOpenWidget, GripperWidget, InputControllerWidget, MLModelServiceWidget, MotorGoForWidget, MotorGoToWidget, MotorIsMovingWidget, MotorQuickMoveWidget, MotorSetPowerWidget, MotorSetRPMWidget, MotorWidget, MovementSensorGetAccuracyWidget, MovementSensorGetCompassHeadingWidget, MovementSensorGetOrientationWidget, MovementSensorGetPositionWidget, MovementSensorWidget, NavigationServiceWidget, PowerSensorGetCurrentWidget, PowerSensorGetPowerWidget, PowerSensorGetVoltageWidget, PowerSensorWidget, SensorWidget, ServoIsMovingWidget, ServoMoveWidget, ServoQuickMoveWidget, ServoWidget, SlamGetPositionWidget, SlamWidget, SwitchWidget, VisionServiceWidget, } from "./components/index.js";
+import { getResourceAPI } from "./get-resource-api.js";
+import { ResourceTriplets } from "./resource-triplet.js";
+const resourceWidgetRegistry = {
+    // components
+    [ResourceTriplets.Arm]: {
+        widget: ArmWidget,
+        apis: [
+            {
+                id: 'move-to-joint-positions',
+                label: 'MoveToJointPositions',
+                widgets: [ArmMoveToJointPositionsWidget],
+            },
+            { id: 'move-to-position', label: 'MoveToPosition', widgets: [ArmMoveToPositionWidget] },
+            { id: 'quick-move', label: 'Quick move', widgets: [ArmQuickMoveWidget] },
+            {
+                id: 'get-joint-positions',
+                label: 'GetJointPositions',
+                widgets: [ArmGetJointPositionsWidget],
+            },
+            { id: 'is-moving', label: 'IsMoving', widgets: [ArmIsMovingWidget] },
+        ],
+    },
+    [ResourceTriplets.AudioInput]: {
+        widget: AudioInputWidget,
+        apis: [
+            { id: 'get-properties', label: 'GetProperties', widgets: [AudioInputGetPropertiesWidget] },
+        ],
+    },
+    [ResourceTriplets.AudioOutput]: {
+        widget: AudioOutputWidget,
+        apis: [
+            {
+                id: 'get-properties',
+                label: 'GetProperties',
+                widgets: [AudioOutputGetPropertiesWidget],
+            },
+        ],
+    },
+    [ResourceTriplets.Base]: {
+        widget: BaseWidget,
+        apis: [
+            { id: 'quick-move', label: 'Quick move', widgets: [BaseQuickMoveWidget] },
+            { id: 'move-straight', label: 'MoveStraight', widgets: [BaseMoveStraightWidget] },
+            { id: 'spin', label: 'Spin', widgets: [BaseSpinWidget] },
+            { id: 'set-power', label: 'SetPower', widgets: [BaseSetPowerWidget] },
+            { id: 'set-velocity', label: 'SetVelocity', widgets: [BaseSetVelocityWidget] },
+            { id: 'is-moving', label: 'IsMoving', widgets: [BaseIsMovingWidget] },
+        ],
+    },
+    [ResourceTriplets.Board]: { widget: BoardWidget, apis: [] },
+    [ResourceTriplets.Button]: { widget: ButtonWidget, apis: [] },
+    [ResourceTriplets.Camera]: { widget: CameraWidget, apis: [] },
+    [ResourceTriplets.Encoder]: {
+        widget: EncoderWidget,
+        apis: [{ id: 'get-position', label: 'GetPosition', widgets: [EncoderGetPositionWidget] }],
+    },
+    [ResourceTriplets.Gantry]: {
+        widget: GantryWidget,
+        apis: [
+            { id: 'home', label: 'Home', widgets: [GantryHomeWidget] },
+            { id: 'move-to-position', label: 'MoveToPosition', widgets: [GantryMoveToPositionWidget] },
+            { id: 'quick-move', label: 'Quick move', widgets: [GantryQuickMoveWidget] },
+            { id: 'get-position', label: 'GetPosition', widgets: [GantryGetPositionWidget] },
+            { id: 'is-moving', label: 'IsMoving', widgets: [GantryIsMovingWidget] },
+        ],
+    },
+    [ResourceTriplets.Gripper]: {
+        widget: GripperWidget,
+        apis: [
+            { id: 'open-grab', label: 'Open / Grab', widgets: [GripperOpenWidget, GripperGrabWidget] },
+            {
+                id: 'is-holding-something',
+                label: 'IsHoldingSomething',
+                widgets: [GripperIsHoldingSomethingWidget],
+            },
+            { id: 'is-moving', label: 'IsMoving', widgets: [GripperIsMovingWidget] },
+        ],
+    },
+    [ResourceTriplets.InputController]: { widget: InputControllerWidget, apis: [] },
+    [ResourceTriplets.Motor]: {
+        widget: MotorWidget,
+        apis: [
+            { id: 'quick-move', label: 'Quick move', widgets: [MotorQuickMoveWidget] },
+            { id: 'set-power', label: 'SetPower', widgets: [MotorSetPowerWidget] },
+            { id: 'set-rpm', label: 'SetRPM', widgets: [MotorSetRPMWidget] },
+            { id: 'go-for', label: 'GoFor', widgets: [MotorGoForWidget] },
+            { id: 'go-to', label: 'GoTo', widgets: [MotorGoToWidget] },
+            { id: 'is-moving', label: 'IsMoving', widgets: [MotorIsMovingWidget] },
+        ],
+    },
+    [ResourceTriplets.MovementSensor]: {
+        widget: MovementSensorWidget,
+        apis: [
+            { id: 'get-position', label: 'GetPosition', widgets: [MovementSensorGetPositionWidget] },
+            {
+                id: 'get-orientation',
+                label: 'GetOrientation',
+                widgets: [MovementSensorGetOrientationWidget],
+            },
+            {
+                id: 'get-compass-heading',
+                label: 'GetCompassHeading',
+                widgets: [MovementSensorGetCompassHeadingWidget],
+            },
+            { id: 'get-accuracy', label: 'GetAccuracy', widgets: [MovementSensorGetAccuracyWidget] },
+        ],
+    },
+    [ResourceTriplets.PowerSensor]: {
+        widget: PowerSensorWidget,
+        apis: [
+            { id: 'get-voltage', label: 'GetVoltage', widgets: [PowerSensorGetVoltageWidget] },
+            { id: 'get-current', label: 'GetCurrent', widgets: [PowerSensorGetCurrentWidget] },
+            { id: 'get-power', label: 'GetPower', widgets: [PowerSensorGetPowerWidget] },
+        ],
+    },
+    [ResourceTriplets.Sensor]: { widget: SensorWidget, apis: [] },
+    [ResourceTriplets.Servo]: {
+        widget: ServoWidget,
+        apis: [
+            { id: 'move', label: 'Move', widgets: [ServoMoveWidget] },
+            { id: 'quick-move', label: 'Quick move', widgets: [ServoQuickMoveWidget] },
+            { id: 'is-moving', label: 'IsMoving', widgets: [ServoIsMovingWidget] },
+        ],
+    },
+    [ResourceTriplets.Switch]: { widget: SwitchWidget, apis: [] },
+    // services
+    [ResourceTriplets.Discovery]: { widget: DiscoveryWidget, apis: [] },
+    [ResourceTriplets.MLModel]: { widget: MLModelServiceWidget, apis: [] },
+    [ResourceTriplets.Navigation]: { widget: NavigationServiceWidget, apis: [] },
+    [ResourceTriplets.Slam]: {
+        widget: SlamWidget,
+        apis: [{ id: 'get-position', label: 'GetPosition', widgets: [SlamGetPositionWidget] }],
+    },
+    [ResourceTriplets.Vision]: { widget: VisionServiceWidget, apis: [] },
+};
+/**
+ * Returns a resource's individual API widgets. Each entry carries a stable `id`, a
+ * display `label`, and the `widgets` to render with `{ partID, resourceName }`.
+ *
+ * Returns `[]` for a resource with a card but no standalone API widgets, and for
+ * unrecognized resources.
+ *
+ * @example
+ * apiWidgetsForResource(gripperResourceName)
+ * // [{ id: 'open-grab', label: 'Open / Grab', widgets: [GripperOpenWidget, GripperGrabWidget] }, ...]
+ */
+export const apiWidgetsForResource = (resource) => {
+    const api = getResourceAPI(resource);
+    return api in resourceWidgetRegistry
+        ? resourceWidgetRegistry[api].apis
+        : [];
+};
+/**
+ * Returns every resource triplet that has a test card, mapped to its API widgets.
+ * Use this to enumerate the full catalog, e.g. a menu spanning every resource type;
+ * for a single resource, prefer `apiWidgetsForResource`.
+ *
+ * @example
+ * availableAPIWidgets()[ResourceTriplets.Gripper]
+ * // [{ id: 'open-grab', label: 'Open / Grab', widgets: [GripperOpenWidget, GripperGrabWidget] }, ...]
+ */
+export const availableAPIWidgets = () => {
+    const result = {};
+    for (const triplet of Object.keys(resourceWidgetRegistry)) {
+        result[triplet] = resourceWidgetRegistry[triplet].apis;
+    }
+    return result;
+};
+/** Returns the full composite test card for a resource, or `undefined` if none exists. */
+export const widgetForResource = (resource) => {
+    const api = getResourceAPI(resource);
+    return api in resourceWidgetRegistry
+        ? resourceWidgetRegistry[api].widget
+        : undefined;
+};
+const knownResources = new Set(Object.values(ResourceTriplets));
+/** Whether a resource's API is a recognized Viam resource triplet. */
+export const isKnownResource = (resource) => knownResources.has(getResourceAPI(resource));
+const hiddenResources = new Set([
+    ResourceTriplets.DataManager,
+    ResourceTriplets.Motion,
+    ResourceTriplets.Sensors,
+    ResourceTriplets.Shell,
+]);
+/** Whether the control view should surface a card for this resource. */
+export const showResourceWidget = (resource) => resource.namespace !== 'rdk-internal' && !hiddenResources.has(getResourceAPI(resource));

package/dist/resource.d.ts

@@ -1,13 +1,8 @@
 import type { ResourceStatus } from '@viamrobotics/svelte-sdk';
-import type { Component } from 'svelte';
 import { type ResourceName } from '@viamrobotics/sdk';
 export type NamedResourceStatus = ResourceStatus & {
     name: ResourceName;
 };
-interface ResourceWidget {
-    partID: string;
-    resourceName: string;
-}
 export declare const ResourceStatusText: {
     0: string;
     3: string;
@@ -17,7 +12,3 @@ export declare const ResourceStatusText: {
     4: string;
 };
 export declare const sortResourceNames: (names: ResourceName[]) => ResourceName[];
-export declare const hasWidget: (resource: ResourceName) => boolean;
-export declare const widgetForResource: (resource: ResourceName) => Component<ResourceWidget> | undefined;
-export declare const showResourceWidget: (resource: ResourceName) => boolean;
-export {};