@camstack/types 1.2.406 → 1.2.408

package/dist/generated/customize-catalog.d.ts

@@ -0,0 +1,229 @@
+import { DeviceType } from '../device/device-type.js';
+/**
+ * Customize catalog, projected from every `*.cap.ts` `customize` block.
+ * 5 caps. Field keys are `runtimeState` paths. No Zod.
+ */
+export declare const CAP_CUSTOMIZE_CATALOG: {
+    readonly battery: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'percentage';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat];
+            readonly apply: 'add-or-replace';
+            readonly vocabularyCap: 'battery';
+            readonly vocabularyStateField: 'percentage';
+            readonly sources: readonly [{
+                readonly kind: 'field';
+                readonly valueKinds: readonly ["number", "string"];
+                readonly transformKinds: readonly ["identity", "linear"];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'percentage';
+            readonly valueKind: 'number';
+            readonly nullable: true;
+            readonly companions: readonly [{
+                readonly kind: 'constant';
+                readonly path: 'charging';
+                readonly value: 'unknown';
+                readonly when: 'add';
+            }, {
+                readonly kind: 'constant';
+                readonly path: 'sleeping';
+                readonly value: false;
+                readonly when: 'add';
+            }, {
+                readonly kind: 'clock';
+                readonly path: 'lastUpdated';
+                readonly when: 'add';
+            }];
+        }];
+    };
+    readonly consumables: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'items';
+            readonly cardinality: 'keyedArray';
+            readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'consumables';
+            readonly sources: readonly [];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'items';
+            readonly keyField: 'key';
+            readonly labelField: 'label';
+            readonly nativeItems: 'read-only';
+            readonly fields: readonly [{
+                readonly path: 'level';
+                readonly valueKind: 'number';
+                readonly nullable: true;
+                readonly sources: readonly [{
+                    readonly kind: 'numeric';
+                    readonly transformKinds: readonly ["identity", "linear"];
+                }];
+            }, {
+                readonly path: 'remaining.value';
+                readonly valueKind: 'number';
+                readonly nullable: true;
+                readonly sources: readonly [{
+                    readonly kind: 'numeric';
+                    readonly transformKinds: readonly ["identity"];
+                }];
+                readonly literals: readonly [{
+                    readonly path: 'remaining.unit';
+                    readonly values: readonly ["days", "hours", "cycles"];
+                }];
+            }, {
+                readonly path: 'status';
+                readonly valueKind: 'enum';
+                readonly nullable: true;
+                readonly enumValues: readonly ["ok", "low", "empty", "full", "replace"];
+                readonly sources: readonly [{
+                    readonly kind: 'enum';
+                    readonly transformKinds: readonly ["enum-map"];
+                }];
+            }];
+            readonly traits: readonly [{
+                readonly path: 'kind';
+                readonly values: readonly ["wear", "supply", "waste"];
+                readonly defaultValue: 'wear';
+            }, {
+                readonly path: 'form';
+                readonly values: readonly ["part", "tank", "product", "bin"];
+                readonly defaultValue: 'part';
+            }];
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastChangedAt';
+                readonly when: 'add';
+            }, {
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'add';
+            }];
+        }];
+    };
+    readonly doorbell: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'pressed';
+            readonly cardinality: 'event';
+            readonly deviceTypes: readonly [DeviceType.Camera];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'doorbell';
+            readonly vocabularyEvent: 'onPressed';
+            readonly sources: readonly [{
+                readonly kind: 'binary';
+                readonly transformKinds: readonly [];
+            }, {
+                readonly kind: 'switch';
+                readonly transformKinds: readonly [];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly shape: 'pulse';
+            readonly applyAuthority: {
+                readonly kind: 'composition-claim';
+            };
+            readonly eventName: 'onPressed';
+            readonly combine: 'any';
+            readonly edges: readonly ["rising"];
+            readonly timestampPath: 'lastPressedAt';
+            readonly counterPath: 'pressCountSinceStart';
+            readonly highWater: 'composer-advance';
+            readonly debounceMs: 2000;
+        }];
+    };
+    readonly motion: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'detected';
+            readonly cardinality: 'event';
+            readonly deviceTypes: readonly [DeviceType.Camera];
+            readonly apply: 'replace';
+            readonly vocabularyCap: 'motion';
+            readonly vocabularyEvent: 'onMotionChanged';
+            readonly sources: readonly [{
+                readonly kind: 'binary';
+                readonly transformKinds: readonly [];
+            }, {
+                readonly kind: 'switch';
+                readonly transformKinds: readonly [];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: false;
+            readonly shape: 'span';
+            readonly applyAuthority: {
+                readonly kind: 'camera-sensors';
+                readonly timeoutField: 'motionCooldownMs';
+            };
+            readonly eventName: 'onMotionChanged';
+            readonly combine: 'any';
+            readonly start: 'rising-edge';
+            readonly end: 'falling-edge-or-timeout';
+            readonly timeoutMs: 30000;
+            readonly sourceModes: readonly ["in-addition", "confirm", "replace"];
+        }];
+    };
+    readonly 'running-state': {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'running';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder];
+            readonly apply: 'add-or-replace';
+            readonly vocabularyCap: 'running-state';
+            readonly vocabularyStateField: 'running';
+            readonly sources: readonly [{
+                readonly kind: 'switch';
+                readonly transformKinds: readonly ["identity"];
+            }, {
+                readonly kind: 'binary';
+                readonly transformKinds: readonly ["identity", "invert"];
+            }, {
+                readonly kind: 'numeric';
+                readonly requiredUnit: 'W';
+                readonly transformKinds: readonly ["threshold"];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+                readonly runtimeField: 'source';
+                readonly nativeValue: 'native';
+                readonly assignedValue: 'assigned';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'running';
+            readonly valueKind: 'boolean';
+            readonly nullable: true;
+            readonly companions: readonly [{
+                readonly kind: 'constant';
+                readonly path: 'source';
+                readonly value: 'assigned';
+                readonly when: 'always';
+            }, {
+                readonly kind: 'constant';
+                readonly path: 'phase';
+                readonly value: null;
+                readonly when: 'always';
+            }, {
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }, {
+                readonly kind: 'transition-time';
+                readonly path: 'since';
+                readonly sourceChangedAt: 'prefer';
+            }];
+        }];
+    };
+};

package/dist/index.d.ts

@@ -164,7 +164,6 @@ export type { AutomationAction, AutomationCondition, AutomationConditionAll, Aut
 export { AutomationActionSchema, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationRecipeSchema, AutomationTriggerSchema, conditionDepth, countConditionLeaves, generateAutomationBlock, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, validateRecipeBounds, } from './automation/index.js';
 export * from './cap-call-context.js';
 export * from './capabilities/index.js';
-export * from './running-state/assignment.js';
 export * from './running-state/defaults.js';
 export * from './running-state/from-operation.js';
 export * from './clips/clip-event-labels.js';
@@ -255,6 +254,20 @@ export type { RuntimeStatePolicy } from './generated/runtime-state-durability.js
 export { isRestoredCap, RESTORED_CAP_NAMES, RUNTIME_STATE_POLICY, runtimeStatePolicyFor, } from './generated/runtime-state-durability.js';
 export { BucketAccumulator, bucketStartOf, type ClosedHistoryBucket, HISTORY_BUCKET_MS, MAX_REQUEUED_BUCKETS_PER_SERIES, } from './history/bucket-accumulator.js';
 export { HISTORY_CATALOG, HISTORY_ITEM_CATALOG, HISTORY_NONE_CAPS, historyFieldsFor, } from './generated/history-catalog.js';
+export { CAP_CUSTOMIZE_CATALOG } from './generated/customize-catalog.js';
+export type { CustomizeCatalog, CustomizeCatalogField, CustomizeCatalogSource, CustomizeCatalogTarget, } from './capabilities/customize-catalog.js';
+export type { CapabilityCustomizeSpec, CapabilityCustomizeTarget, CustomizeCardinality, EventCustomizeTarget, PulseEventCustomizeTarget, SpanEventCustomizeTarget, } from './capabilities/customize-spec.js';
+export { CustomizeAssignmentStatusSchema, OverrideDraftSchema, type CustomizeAssignmentStatus, type OverrideDraft, } from './composition/customize/override-draft.js';
+export { compileScalarOverride, type ScalarCompileInput, type ScalarValueKind, } from './composition/customize/scalar-compile.js';
+export { decodeScalarOverride, type ScalarDecoded, type ScalarDecodeInput, } from './composition/customize/scalar-decode.js';
+export { projectScalarAssignment, type ScalarAssignmentProjection, type ScalarRead, type ScalarSourcePresence, type ScalarStatusInput, } from './composition/customize/scalar-status.js';
+export { compilePulseOverride, compileSpanOverride, type PulseCompileInput, type SpanCompileInput, type SpanCompiled, } from './composition/customize/event-compile.js';
+export { decodePulseOverride, type PulseDecodeInput, type PulseDecoded, } from './composition/customize/event-decode.js';
+export { INITIAL_PULSE, INITIAL_SPAN, stepPulse, stepSpan, type LevelSample, type PulseState, type SpanState, type SpanTiming, } from './composition/customize/event-eval.js';
+export { projectPulseAssignment, projectSpanAssignment, type PulseAssignmentProjection, type PulseStatusInput, type SpanAssignmentProjection, type SpanRead, type SpanSensorRow, } from './composition/customize/event-status.js';
+export { compileKeyedArrayOverride, mergeKeyedArrayItem, withoutKeyedArrayItem, type KeyedArrayCompileInput, type KeyedArrayItemCompile, type KeyedArrayLiteral, type KeyedSourceValueKind, } from './composition/customize/keyed-array-compile.js';
+export { decodeKeyedArrayOverride, readKeyedArrayItems, type KeyedArrayItemView, type KeyedArrayRead, } from './composition/customize/keyed-array-decode.js';
+export { projectKeyedArrayAssignment, type KeyedArrayAssignmentProjection, type KeyedArrayStatusInput, } from './composition/customize/keyed-array-status.js';
 export type { ScopePresetId, ScopePresetSpec } from './generated/scope-presets.js';
 export { SCOPE_PRESETS } from './generated/scope-presets.js';
 export type { SystemProxy } from './generated/system-proxy.js';