@camstack/types 1.2.415 → 1.2.417

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

@@ -1,32 +1,31 @@
 import { DeviceType } from '../device/device-type.js';
 /**
  * Customize catalog, projected from every `*.cap.ts` `customize` block.
- * 11 caps. Field keys are `runtimeState` paths. No Zod.
+ * 5 caps. Field keys are `runtimeState` paths. No Zod.
  */
 export declare const CAP_CUSTOMIZE_CATALOG: {
-    readonly 'ambient-light-sensor': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'lux';
-            readonly kind: 'number';
-            readonly label: 'Illuminance';
-            readonly unit: 'lx';
-        }];
-    };
     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 apply: 'add';
             readonly vocabularyCap: 'battery';
             readonly vocabularyStateField: 'percentage';
             readonly sources: readonly [{
                 readonly kind: 'field';
                 readonly valueKinds: readonly ["number", "string"];
                 readonly transformKinds: readonly ["identity", "linear"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }, {
+                    readonly kind: 'linear';
+                    readonly defaultScale: 1;
+                    readonly defaultOffset: 0;
+                    readonly clampMin: 0;
+                    readonly clampMax: 100;
+                }];
             }];
             readonly sourceReport: {
                 readonly status: 'assignment-status';
@@ -51,29 +50,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly when: 'add';
             }];
         }];
-        readonly advancedParameters: readonly [{
-            readonly path: 'binary';
-            readonly kind: 'boolean';
-            readonly label: 'Binary indicator';
-        }, {
-            readonly path: 'charging';
-            readonly kind: 'enum';
-            readonly label: 'Charging source';
-            readonly enumValues: readonly ["dc", "solar", "none", "unknown"];
-        }, {
-            readonly path: 'sleeping';
-            readonly kind: 'boolean';
-            readonly label: 'Sleeping';
-        }];
-    };
-    readonly binary: {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'on';
-            readonly kind: 'boolean';
-            readonly label: 'On';
-        }];
     };
     readonly consumables: {
         readonly version: 1;
@@ -99,6 +75,15 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly sources: readonly [{
                     readonly kind: 'numeric';
                     readonly transformKinds: readonly ["identity", "linear"];
+                    readonly transforms: readonly [{
+                        readonly kind: 'identity';
+                    }, {
+                        readonly kind: 'linear';
+                        readonly defaultScale: 1;
+                        readonly defaultOffset: 0;
+                        readonly clampMin: 0;
+                        readonly clampMax: 100;
+                    }];
                 }];
             }, {
                 readonly path: 'remaining.value';
@@ -107,10 +92,13 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly sources: readonly [{
                     readonly kind: 'numeric';
                     readonly transformKinds: readonly ["identity"];
+                    readonly transforms: readonly [{
+                        readonly kind: 'identity';
+                    }];
                 }];
                 readonly literals: readonly [{
-                    readonly path: 'remaining.unit';
-                    readonly values: readonly ["days", "hours", "cycles"];
+                    readonly path: 'remaining.kind';
+                    readonly values: readonly ["duration", "count"];
                 }];
             }, {
                 readonly path: 'status';
@@ -120,6 +108,11 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly sources: readonly [{
                     readonly kind: 'enum';
                     readonly transformKinds: readonly ["enum-map"];
+                    readonly transforms: readonly [{
+                        readonly kind: 'enum-map';
+                        readonly outputValues: readonly ["ok", "low", "empty", "full", "replace"];
+                        readonly unmapped: null;
+                    }];
                 }];
             }];
             readonly traits: readonly [{
@@ -141,7 +134,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly when: 'add';
             }];
         }];
-        readonly advancedParameters: readonly [];
     };
     readonly doorbell: {
         readonly version: 1;
@@ -155,9 +147,11 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly sources: readonly [{
                 readonly kind: 'binary';
                 readonly transformKinds: readonly [];
+                readonly transforms: readonly [];
             }, {
                 readonly kind: 'switch';
                 readonly transformKinds: readonly [];
+                readonly transforms: readonly [];
             }];
             readonly sourceReport: {
                 readonly status: 'assignment-status';
@@ -170,22 +164,12 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly eventName: 'onPressed';
             readonly combine: 'any';
             readonly edges: readonly ["rising"];
+            readonly defaultEdge: 'rising';
             readonly timestampPath: 'lastPressedAt';
             readonly counterPath: 'pressCountSinceStart';
             readonly highWater: 'composer-advance';
             readonly debounceMs: 2000;
         }];
-        readonly advancedParameters: readonly [];
-    };
-    readonly 'humidity-sensor': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'percent';
-            readonly kind: 'number';
-            readonly label: 'Humidity';
-            readonly unit: '%';
-        }];
     };
     readonly motion: {
         readonly version: 1;
@@ -193,15 +177,17 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly id: 'detected';
             readonly cardinality: 'event';
             readonly deviceTypes: readonly [DeviceType.Camera];
-            readonly apply: 'replace';
+            readonly apply: 'add';
             readonly vocabularyCap: 'motion';
             readonly vocabularyEvent: 'onMotionChanged';
             readonly sources: readonly [{
                 readonly kind: 'binary';
                 readonly transformKinds: readonly [];
+                readonly transforms: readonly [];
             }, {
                 readonly kind: 'switch';
                 readonly transformKinds: readonly [];
+                readonly transforms: readonly [];
             }];
             readonly sourceReport: {
                 readonly status: 'assignment-status';
@@ -219,22 +205,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly timeoutMs: 30000;
             readonly sourceModes: readonly ["in-addition", "confirm", "replace"];
         }];
-        readonly advancedParameters: readonly [];
-    };
-    readonly 'power-meter': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'kwhTotal';
-            readonly kind: 'number';
-            readonly label: 'Energy';
-            readonly unit: 'kWh';
-        }, {
-            readonly path: 'watts';
-            readonly kind: 'number';
-            readonly label: 'Power';
-            readonly unit: 'W';
-        }];
     };
     readonly 'running-state': {
         readonly version: 1;
@@ -242,19 +212,36 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             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 apply: 'add';
             readonly vocabularyCap: 'running-state';
             readonly vocabularyStateField: 'running';
             readonly sources: readonly [{
                 readonly kind: 'switch';
                 readonly transformKinds: readonly ["identity"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
             }, {
                 readonly kind: 'binary';
                 readonly transformKinds: readonly ["identity", "invert"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }, {
+                    readonly kind: 'invert';
+                }];
             }, {
                 readonly kind: 'numeric';
                 readonly requiredUnit: 'W';
                 readonly transformKinds: readonly ["threshold"];
+                readonly transforms: readonly [{
+                    readonly kind: 'threshold';
+                    readonly comparisons: readonly ["gte", "lte"];
+                    readonly comparison: 'gte';
+                    readonly defaultThreshold: 5;
+                    readonly defaultStartDwellMs: 30000;
+                    readonly defaultStopDwellMs: 180000;
+                    readonly thresholdUnit: 'W';
+                }];
             }];
             readonly sourceReport: {
                 readonly status: 'assignment-status';
@@ -286,25 +273,10 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly sourceChangedAt: 'prefer';
             }];
         }];
-        readonly advancedParameters: readonly [];
-    };
-    readonly switch: {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'on';
-            readonly kind: 'boolean';
-            readonly label: 'On';
-        }];
-    };
-    readonly 'temperature-sensor': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'celsius';
-            readonly kind: 'number';
-            readonly label: 'Temperature';
-            readonly unit: '°C';
-        }];
     };
 };
+/**
+ * Unit meta on runtime-state fields. The composed-device row reads this;
+ * it is not an override list (D944).
+ */
+export declare const CAP_RUNTIME_FIELD_UNITS: Readonly<Record<string, Readonly<Record<string, string>>>>;

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

@@ -1,7 +1,7 @@
 import type { CapabilityHistoryField, CapabilityHistoryItems } from '../capabilities/capability-definition.js';
 /**
  * Cap history catalog, projected from every `*.cap.ts` `history` block.
- * 41 caps with series (74 series), 30 caps answered `'none'`.
+ * 41 caps with series (75 series), 30 caps answered `'none'`.
  * Field keys are `runtimeState` paths (`a.b` into fixed objects only).
  */
 export declare const HISTORY_CATALOG: Readonly<Record<string, Readonly<Record<string, CapabilityHistoryField>>>>;

package/dist/index.d.ts

@@ -258,10 +258,12 @@ export { isRestoredCap, RESTORED_CAP_NAMES, RUNTIME_STATE_POLICY, runtimeStatePo
 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, CustomizeCatalogAdvancedParameter, CustomizeCatalogField, CustomizeCatalogSource, CustomizeCatalogTarget, } from './capabilities/customize-catalog.js';
+export type { CustomizeCatalog, CustomizeCatalogField, CustomizeCatalogSource, CustomizeCatalogTarget, CustomizeCatalogTransform, } from './capabilities/customize-catalog.js';
+export { CAP_RUNTIME_FIELD_UNITS } from './generated/customize-catalog.js';
+export { runtimeFieldUnit } from './capabilities/runtime-field-unit.js';
 export { compositionFillStatus, decodeCompositionToCards, formulaProblem, primaryCapForRole, problemsBlockSave, } from './composition/cards/index.js';
 export type { CompositionFillStatus } from './composition/cards/index.js';
-export type { CapabilityCustomizeSpec, CapabilityCustomizeTarget, CustomizeCardinality, EventCustomizeTarget, PulseEventCustomizeTarget, SpanEventCustomizeTarget, } from './capabilities/customize-spec.js';
+export type { CapabilityCustomizeSpec, CapabilityCustomizeTarget, CustomizeCardinality, CustomizeEventEdge, 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';