@camstack/types 1.2.305 → 1.2.307

package/dist/composition/evaluate-field.d.ts

@@ -26,6 +26,12 @@ export interface FieldValueOutcome {
     readonly reason: string | null;
     /** When a windowed builtin's answer flips on its own; null when nothing will. */
     readonly deadline: number | null;
+    /**
+     * The value is the field's LAST output, held over a source that did not
+     * answer: the expression did not run. Set by the composer for an
+     * edge-latched (`rose`) field (D713) — a recovery from it is a recovery from unavailable.
+     */
+    readonly held?: true;
 }
 export interface FieldUnavailableOutcome {
     readonly state: 'unavailable';
@@ -35,6 +41,12 @@ export interface FieldUnavailableOutcome {
     readonly fatal: boolean;
     /** Fatal, or a non-fatal unavailability that is an answer (see the header). Absent = not confirmed. */
     readonly confirmed?: boolean;
+    /**
+     * Every source answered and the expression failed on the values. Absent =
+     * a source did not answer. Only the latter is an outage a stateful edge
+     * must re-baseline after (D716).
+     */
+    readonly expressionFailed?: true;
 }
 export type FieldOutcome = FieldValueOutcome | FieldUnavailableOutcome;
 export interface EvaluateCompositionFieldInput {

package/dist/device/hub-motion-read.d.ts

@@ -3,13 +3,25 @@
  *
  * The orchestrator is the only writer of a camera's `motion` runtime slice, and
  * it writes the EFFECTIVE value on the hub. A camera provider's local runtime
- * state therefore holds no `motion` slice, and its `motion.isDetected` answers
- * from here. Two answers are UNKNOWN, and both make the call fail rather than
- * answer `false` (D49, D393):
- * - the read did not answer (the hub is unreachable, the call threw);
- * - the read answered with no `detected`: nobody has published the camera's
- *   motion since the hub started (the slice is session-durable).
+ * state therefore holds no `motion` slice, and BOTH of its `motion` reads —
+ * `isDetected` and `getStatus` — answer from here. Build the provider with
+ * {@link hubMotionNativeProvider}: a provider that serves only `isDetected`
+ * gets the framework's default `getStatus`, which reads the provider's LOCAL
+ * runtime state, and that answered `null` for every camera on the fleet while
+ * the hub's slice was written (the viewer's Motion order ranked one composite
+ * grid above every camera, 2026-10-06).
+ *
+ * The two reads say "unknown" in the shape their contract allows:
+ * - the read did not answer (the hub is unreachable, the call threw): both
+ *   fail, neither answers "no motion" (D49, D393);
+ * - nobody has published the camera's motion since the hub started (the slice
+ *   is session-durable): `getStatus` answers `null` — the status contract's
+ *   own "no status" — and `isDetected`, a bare boolean with no room for it,
+ *   fails;
+ * - a slice that is not a `MotionStatus`: both fail, naming the device.
  */
+import { type InferNativeProvider } from '../capabilities/capability-definition.js';
+import { type MotionStatus, type motionCapability } from '../capabilities/motion.cap.js';
 /** The one `deviceState` read this needs. `ctx.api.deviceState` satisfies it. */
 export interface HubMotionSliceReader {
     readonly getCapSlice: {
@@ -19,4 +31,16 @@ export interface HubMotionSliceReader {
         }) => Promise<Readonly<Record<string, unknown>> | null>;
     };
 }
+/**
+ * The hub's `motion` slice as a `MotionStatus`, or `null` when nobody has
+ * published it since the hub started. Throws when the hub does not answer or
+ * the slice is malformed — never a made-up "no motion".
+ */
+export declare function readHubMotionStatus(deviceState: HubMotionSliceReader, deviceId: number): Promise<MotionStatus | null>;
 export declare function readHubMotionDetected(deviceState: HubMotionSliceReader, deviceId: number): Promise<boolean>;
+/**
+ * The native `motion` provider of a camera whose slice the orchestrator writes
+ * (D696): `isDetected` AND `getStatus`, both from the hub. `owner` names the
+ * provider class in the deviceId-mismatch error.
+ */
+export declare function hubMotionNativeProvider(deviceState: HubMotionSliceReader, deviceId: number, owner: string): InferNativeProvider<typeof motionCapability>;

package/dist/device/location-icon.d.ts

@@ -88,6 +88,8 @@ export declare const LOCATION_ICON_FALLBACK: LocationIconId;
 /** Wire/storage schema for one icon id. */
 export declare const LocationIconIdSchema: z.ZodEnum<{
     package: "package";
+    car: "car";
+    umbrella: "umbrella";
     "map-pin": "map-pin";
     house: "house";
     "door-open": "door-open";
@@ -96,11 +98,9 @@ export declare const LocationIconIdSchema: z.ZodEnum<{
     "bed-double": "bed-double";
     bath: "bath";
     briefcase: "briefcase";
-    car: "car";
     "circle-parking": "circle-parking";
     route: "route";
     trees: "trees";
-    umbrella: "umbrella";
     "waves-ladder": "waves-ladder";
     fence: "fence";
     warehouse: "warehouse";
@@ -122,6 +122,8 @@ export declare const LocationIconAssignmentSchema: z.ZodObject<{
     locationKey: z.ZodString;
     icon: z.ZodEnum<{
         package: "package";
+        car: "car";
+        umbrella: "umbrella";
         "map-pin": "map-pin";
         house: "house";
         "door-open": "door-open";
@@ -130,11 +132,9 @@ export declare const LocationIconAssignmentSchema: z.ZodObject<{
         "bed-double": "bed-double";
         bath: "bath";
         briefcase: "briefcase";
-        car: "car";
         "circle-parking": "circle-parking";
         route: "route";
         trees: "trees";
-        umbrella: "umbrella";
         "waves-ladder": "waves-ladder";
         fence: "fence";
         warehouse: "warehouse";

package/dist/device/site-zone.d.ts

@@ -45,6 +45,8 @@ export declare const SiteZoneSchema: z.ZodObject<{
     label: z.ZodString;
     icon: z.ZodNullable<z.ZodEnum<{
         package: "package";
+        car: "car";
+        umbrella: "umbrella";
         "map-pin": "map-pin";
         house: "house";
         "door-open": "door-open";
@@ -53,11 +55,9 @@ export declare const SiteZoneSchema: z.ZodObject<{
         "bed-double": "bed-double";
         bath: "bath";
         briefcase: "briefcase";
-        car: "car";
         "circle-parking": "circle-parking";
         route: "route";
         trees: "trees";
-        umbrella: "umbrella";
         "waves-ladder": "waves-ladder";
         fence: "fence";
         warehouse: "warehouse";

package/dist/index.d.ts

@@ -152,6 +152,8 @@ export * from './device-extension/index.js';
 export * from './composition/index.js';
 export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, getAudioMacroClassIds, mapAudioLabelToMacro, YAMNET_TO_MACRO, } from './catalogs/audio-classmap.js';
 export { COCO_80_LABELS, COCO_TO_MACRO, DETECTION_MACRO_CLASSES, isDetectionMacroClass, MACRO_LABELS, } from './catalogs/coco-classmap.js';
+export { buildFrigateClassMap, type ClassMapMacroTarget, FRIGATE_PLUS_TO_MACRO, FRIGATE_PLUS_UNMAPPED_LABELS, type FrigateLabelFields, frigateLabelFields, } from './catalogs/frigate-plus-classmap.js';
+export { type ClassifierFillDeclaration, DEFAULT_LABEL_LINK_POLICY, deriveClassifierFills, FILLABLE_STEP_IDS, FILLABLE_STEP_MACRO, FILLABLE_STEP_VOCABULARIES, type FillableStepId, fillFor, isCocoLabelmap, isFillableStepId, LABEL_LINK_POLICIES, LABEL_LINK_SETTING_KEY, type LabelLinkDecision, type LabelLinkPolicy, type LinkedStepState, LINKED_LABEL_STEP_PREFIX, linkedLabelStepId, linkedStepOf, readLabelLinkPolicy, resolveLabelLink, } from './catalogs/classifier-fill.js';
 export { DEVICE_STATE_READERS, readDeviceStateFrom, stateVocabularyFor, } from './catalogs/device-state-vocabulary.js';
 export { colorForKind, DEFAULT_EVENT_COLOR, EVENT_TAXONOMY, type EventTaxonomyCategory, type EventTaxonomyEntry, type EventTaxonomyLevel, getTaxonomyEntry, subKindsOf, TAXONOMY_COLORS, } from './catalogs/event-taxonomy.js';
 export { buildNcTaxonomy, NC_TAXONOMY, type NcTaxonomy, type NcTaxonomyEntry, NcTaxonomyEntrySchema, NcTaxonomySchema, } from './catalogs/nc-taxonomy.js';
@@ -261,7 +263,7 @@ export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseG
 export { CLUSTER_MODEL_SCOPED_STEPS, CLUSTER_MODEL_SECTION_ID, CLUSTER_STEP_SETTING_FIELDS, type ClusterModelScopedStep, type ClusterStepModels, type ClusterStepSettingField, type ClusterStepSettings, clusterModelSettingKey, clusterStepSettingFieldsFor, clusterStepSettingKey, DEFAULT_CLUSTER_STEP_MODELS, DEFAULT_CLUSTER_STEP_SETTINGS, DEFAULT_MIN_LANDMARK_FACE_SIZE_PX, type HydratedClusterSection, type HydratedClusterView, interpretStoredClusterModel, type InvalidClusterStepModelEntry, invalidClusterStepModelEntries, isClusterScopedStep, overlayClusterStepSettings, pickClusterStepModels, pickClusterStepSettings, pickInvalidClusterStepModels, readClusterStepModels, readClusterStepSettings, resolveClusterStepModelId, type StepModelScope, type StoredClusterModelInterpretation, } from './pipeline/cluster-model-scope.js';
 export { CAMERA_SENSORS_NOT_LOADED, CAMERA_SENSORS_SETTINGS_KEY, CAMERA_TRIGGER, type CameraSensorAttachment, CameraSensorAttachmentSchema, type CameraSensorRef, CameraSensorRefSchema, cameraSensorRefKey, type CameraSensorsConfig, CameraSensorsConfigSchema, type CameraOwnMotion, CameraOwnMotionSchema, type CameraRawLevel, CameraRawLevelSchema, type CameraSensorEntry, CameraSensorEntrySchema, type CameraSensorMode, CameraSensorModeSchema, type CameraSensorsNotEnforced, CameraSensorsNotEnforcedSchema, type CameraSensorsNotForwarded, CameraSensorsNotForwardedSchema, type CameraSensorsStatus, CameraSensorsStatusSchema, DEFAULT_CAMERA_SENSOR_MODE, MAX_CAMERA_SENSORS, type MotionTriggeredBy, type MotionTriggeredByReading, MotionTriggeredBySchema, readMotionTriggeredBy, } from './pipeline/camera-sensors.js';
 export { cameraOwnsMotionViaSensor } from './pipeline/motion-ownership.js';
-export { readHubMotionDetected } from './device/hub-motion-read.js';
+export { hubMotionNativeProvider, readHubMotionDetected, readHubMotionStatus, } from './device/hub-motion-read.js';
 export { type ProviderMotionData, ProviderMotionDataSchema, providerMotionEvent, } from './pipeline/provider-motion.js';
 export { type FormatRunnableModel, stepModelRunsOnFormat, } from './pipeline/step-format-runnable.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, FULL_IMAGE_BBOX, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';