@camstack/types 1.2.425 → 1.2.426

package/dist/capabilities/power-meter.cap.d.ts

@@ -31,7 +31,7 @@ export declare const powerMeterCapability: {
     readonly scope: 'device';
     readonly deviceNative: true;
     readonly mode: 'singleton';
-    readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher];
+    readonly deviceTypes: readonly [DeviceType.Sensor, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder];
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
@@ -107,5 +107,113 @@ export declare const powerMeterCapability: {
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];
+    readonly customize: {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: string;
+            readonly cardinality: 'scalar';
+            readonly vocabulary: {
+                readonly cap: 'power-meter';
+                readonly stateField: string;
+            };
+            readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
+            readonly apply: 'add';
+            readonly path: string;
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: string;
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+        }, {
+            readonly id: string;
+            readonly cardinality: 'scalar';
+            readonly vocabulary: {
+                readonly cap: 'power-meter';
+                readonly stateField: string;
+            };
+            readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
+            readonly apply: 'add';
+            readonly path: string;
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: string;
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+        }, {
+            readonly id: string;
+            readonly cardinality: 'scalar';
+            readonly vocabulary: {
+                readonly cap: 'power-meter';
+                readonly stateField: string;
+            };
+            readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
+            readonly apply: 'add';
+            readonly path: string;
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: string;
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+        }, {
+            readonly id: string;
+            readonly cardinality: 'scalar';
+            readonly vocabulary: {
+                readonly cap: 'power-meter';
+                readonly stateField: string;
+            };
+            readonly deviceTypes: (DeviceType.Light | DeviceType.Switch | DeviceType.Thermostat | DeviceType.Climate | DeviceType.Humidifier | DeviceType.WaterHeater | DeviceType.Fan | DeviceType.MediaPlayer | DeviceType.Vacuum | DeviceType.LawnMower | DeviceType.PetFeeder | DeviceType.Dishwasher | DeviceType.Washer | DeviceType.Dryer)[];
+            readonly apply: 'add';
+            readonly path: string;
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: string;
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+        }];
+    };
 };
 export type IPowerMeterProvider = InferProvider<typeof powerMeterCapability>;

package/dist/composition/customize/scalar-merge.d.ts

@@ -0,0 +1,21 @@
+import type { CompositionFieldsFeature } from '../composition.js';
+/** How many scalar targets the cap declares: above one, the cap's feature is shared. */
+export declare function scalarTargetCount(cap: string): number;
+/**
+ * The cap's feature with `compiled` (one target's own feature) merged in. A cap
+ * with one scalar target is replaced whole, as before.
+ */
+export declare function mergeScalarTarget(current: CompositionFieldsFeature | null, compiled: CompositionFieldsFeature, cap: string, targetId: string): CompositionFieldsFeature;
+/** The cap's feature without `targetId`'s paths; null when no target value is left. */
+export declare function removeScalarTarget(current: CompositionFieldsFeature | null, cap: string, targetId: string): CompositionFieldsFeature | null;
+/**
+ * The part of a stored feature one target owns — what a decode compares with
+ * its recompiled feature. A cap with one target compares the whole feature.
+ */
+export declare function ownedSlice(stored: CompositionFieldsFeature, cap: string, targetId: string): CompositionFieldsFeature;
+/**
+ * The stored feature as ONE target sees it: null when the cap's feature holds
+ * only its neighbours' readings (no assignment of this target), else the whole
+ * feature. A cap with one target sees what is stored.
+ */
+export declare function targetFeature(stored: CompositionFieldsFeature | null, cap: string, targetId: string): CompositionFieldsFeature | null;

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

@@ -1,7 +1,7 @@
 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.
+ * 6 caps. Field keys are `runtimeState` paths. No Zod.
  */
 export declare const CAP_CUSTOMIZE_CATALOG: {
     readonly battery: {
@@ -206,6 +206,118 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly sourceModes: readonly ["in-addition", "confirm", "replace"];
         }];
     };
+    readonly 'power-meter': {
+        readonly version: 1;
+        readonly targets: readonly [{
+            readonly id: 'watts';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'power-meter';
+            readonly vocabularyStateField: 'watts';
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: 'W';
+                readonly transformKinds: readonly ["identity"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'watts';
+            readonly valueKind: 'number';
+            readonly nullable: false;
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+        }, {
+            readonly id: 'kwhTotal';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'power-meter';
+            readonly vocabularyStateField: 'kwhTotal';
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: 'kWh';
+                readonly transformKinds: readonly ["identity"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'kwhTotal';
+            readonly valueKind: 'number';
+            readonly nullable: false;
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+        }, {
+            readonly id: 'volts';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'power-meter';
+            readonly vocabularyStateField: 'volts';
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: 'V';
+                readonly transformKinds: readonly ["identity"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'volts';
+            readonly valueKind: 'number';
+            readonly nullable: false;
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+        }, {
+            readonly id: 'amps';
+            readonly cardinality: 'scalar';
+            readonly deviceTypes: readonly [DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder];
+            readonly apply: 'add';
+            readonly vocabularyCap: 'power-meter';
+            readonly vocabularyStateField: 'amps';
+            readonly sources: readonly [{
+                readonly kind: 'numeric';
+                readonly requiredUnit: 'A';
+                readonly transformKinds: readonly ["identity"];
+                readonly transforms: readonly [{
+                    readonly kind: 'identity';
+                }];
+            }];
+            readonly sourceReport: {
+                readonly status: 'assignment-status';
+            };
+            readonly advancedExpression: true;
+            readonly path: 'amps';
+            readonly valueKind: 'number';
+            readonly nullable: false;
+            readonly companions: readonly [{
+                readonly kind: 'clock';
+                readonly path: 'lastFetchedAt';
+                readonly when: 'always';
+            }];
+        }];
+    };
     readonly 'running-state': {
         readonly version: 1;
         readonly targets: readonly [{

package/dist/index.d.ts

@@ -268,6 +268,7 @@ export type { CapabilityCustomizeSpec, CapabilityCustomizeTarget, CustomizeCardi
 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 { mergeScalarTarget, targetFeature, ownedSlice, removeScalarTarget, scalarTargetCount, } from './composition/customize/scalar-merge.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';