@camstack/types 1.2.443 → 1.2.445

package/dist/composition/composition-items.d.ts

@@ -10,15 +10,15 @@
  *
  * The composer sets some item fields itself: the key and label (from the
  * entry) and {@link COMPOSED_ITEM_FIXED_FIELDS}. A source for any of them is
- * refused by name (`item-field-reserved`) — `resettable` is fixed `false`
- * because `reset` is refused until commands arrive (slice 3).
+ * refused by name (`item-field-reserved`) — `resettable` is written from the
+ * item's `reset` forward (D967): `true` with one, `false` without.
  */
 import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
 import { type CompositionFieldsFeature } from './composition.js';
 import type { CompositionFeatureMode } from './composition-report.js';
 import { type CompositionPlanResult } from './plan-result.js';
 import type { CapabilityLookup } from './validate-composition.js';
-/** Item fields the composer writes itself, with the value it writes. */
+/** Item fields the composer writes itself, with the value it writes. `resettable` is the default: an item with a `reset` forward writes `true` (D967). */
 export declare const COMPOSED_ITEM_FIXED_FIELDS: {
     readonly resettable: false;
 };

package/dist/composition/composition-report.d.ts

@@ -4,6 +4,10 @@
  */
 import { z } from 'zod';
 export declare const CompositionProblemCodeSchema: z.ZodEnum<{
+    "command-input-missing": "command-input-missing";
+    "command-input-unknown": "command-input-unknown";
+    "command-method-unknown": "command-method-unknown";
+    "command-source-unknown": "command-source-unknown";
     cycle: "cycle";
     "duplicate-target": "duplicate-target";
     "expression-invalid": "expression-invalid";
@@ -36,6 +40,10 @@ export type CompositionProblemCode = z.infer<typeof CompositionProblemCodeSchema
 /** One refusal, named (D391). `path` points into the composition, e.g. `features[0].fields.temperature`. */
 export declare const CompositionProblemSchema: z.ZodObject<{
     code: z.ZodEnum<{
+        "command-input-missing": "command-input-missing";
+        "command-input-unknown": "command-input-unknown";
+        "command-method-unknown": "command-method-unknown";
+        "command-source-unknown": "command-source-unknown";
         cycle: "cycle";
         "duplicate-target": "duplicate-target";
         "expression-invalid": "expression-invalid";
@@ -106,6 +114,7 @@ export declare const CompositionFieldItemSchema: z.ZodObject<{
     arrayPath: z.ZodString;
     key: z.ZodString;
     label: z.ZodString;
+    resettable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CompositionFieldItem = z.infer<typeof CompositionFieldItemSchema>;
 export declare const CompositionFieldPlanSchema: z.ZodObject<{
@@ -115,6 +124,7 @@ export declare const CompositionFieldPlanSchema: z.ZodObject<{
         arrayPath: z.ZodString;
         key: z.ZodString;
         label: z.ZodString;
+        resettable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     featureIndex: z.ZodNumber;
     kind: z.ZodEnum<{
@@ -256,6 +266,10 @@ export declare const CompositionValidationSchema: z.ZodObject<{
     ok: z.ZodBoolean;
     problems: z.ZodArray<z.ZodObject<{
         code: z.ZodEnum<{
+            "command-input-missing": "command-input-missing";
+            "command-input-unknown": "command-input-unknown";
+            "command-method-unknown": "command-method-unknown";
+            "command-source-unknown": "command-source-unknown";
             cycle: "cycle";
             "duplicate-target": "duplicate-target";
             "expression-invalid": "expression-invalid";
@@ -294,6 +308,7 @@ export declare const CompositionValidationSchema: z.ZodObject<{
             arrayPath: z.ZodString;
             key: z.ZodString;
             label: z.ZodString;
+            resettable: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         featureIndex: z.ZodNumber;
         kind: z.ZodEnum<{
@@ -451,6 +466,7 @@ export declare const CompositionFieldStateSchema: z.ZodObject<{
         arrayPath: z.ZodString;
         key: z.ZodString;
         label: z.ZodString;
+        resettable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     state: z.ZodEnum<{
         fresh: "fresh";
@@ -480,6 +496,7 @@ export declare const CompositionBlockStateSchema: z.ZodObject<{
             arrayPath: z.ZodString;
             key: z.ZodString;
             label: z.ZodString;
+            resettable: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         state: z.ZodEnum<{
             fresh: "fresh";

package/dist/composition/composition.d.ts

@@ -249,7 +249,29 @@ export declare const CompositionFieldSourceSchema: z.ZodDiscriminatedUnion<[z.Zo
     }>;
 }, z.core.$strip>], "kind">;
 export type CompositionFieldSource = z.infer<typeof CompositionFieldSourceSchema>;
-/** `forward`: RESERVED for slice 3. Argument mapping arrives there as an additive optional `args`. */
+/** The marker of a forward argument that takes its value from the built method's input. */
+export declare const FORWARD_INPUT_KEY = "$input";
+/**
+ * One value of a forward's `args` template: a constant, `{ $input: '<field>' }`
+ * (the value of that field of the BUILT method's input), or a nested record of
+ * these — the source method may take a structured input (`control.setValue`).
+ */
+export type CompositionForwardArg = string | number | boolean | {
+    readonly $input: string;
+} | {
+    readonly [key: string]: CompositionForwardArg;
+};
+export declare const CompositionForwardArgSchema: z.ZodType<CompositionForwardArg>;
+/** True for `{ $input: '<field>' }`. */
+export declare function isForwardInputRef(value: CompositionForwardArg): value is {
+    readonly $input: string;
+};
+/**
+ * `forward` (D659, amended by D967): one method of a BUILT capability is one
+ * call of `cap.method` on `source`. Without `args` the built method's input
+ * passes through minus `deviceId`; with `args` the template IS the source's
+ * whole input. `deviceId` is always the source's own, never an argument.
+ */
 export declare const CompositionForwardCommandSchema: z.ZodObject<{
     kind: z.ZodLiteral<"forward">;
     source: z.ZodObject<{
@@ -258,6 +280,7 @@ export declare const CompositionForwardCommandSchema: z.ZodObject<{
     }, z.core.$strip>;
     cap: z.ZodString;
     method: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
 }, z.core.$strip>;
 export type CompositionForwardCommand = z.infer<typeof CompositionForwardCommandSchema>;
 export declare const CompositionCommandTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -268,6 +291,7 @@ export declare const CompositionCommandTargetSchema: z.ZodDiscriminatedUnion<[z.
     }, z.core.$strip>;
     cap: z.ZodString;
     method: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"code">;
     code: z.ZodString;
@@ -364,6 +388,16 @@ export declare const CompositionItemEntrySchema: z.ZodObject<{
             omit: "omit";
         }>;
     }, z.core.$strip>], "kind">>;
+    reset: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"forward">;
+        source: z.ZodObject<{
+            addonId: z.ZodString;
+            stableId: z.ZodString;
+        }, z.core.$strip>;
+        cap: z.ZodString;
+        method: z.ZodString;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CompositionItemEntry = z.infer<typeof CompositionItemEntrySchema>;
 export declare const CompositionFieldsFeatureSchema: z.ZodObject<{
@@ -530,6 +564,16 @@ export declare const CompositionFieldsFeatureSchema: z.ZodObject<{
                 omit: "omit";
             }>;
         }, z.core.$strip>], "kind">>;
+        reset: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"forward">;
+            source: z.ZodObject<{
+                addonId: z.ZodString;
+                stableId: z.ZodString;
+            }, z.core.$strip>;
+            cap: z.ZodString;
+            method: z.ZodString;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"forward">;
@@ -539,6 +583,7 @@ export declare const CompositionFieldsFeatureSchema: z.ZodObject<{
         }, z.core.$strip>;
         cap: z.ZodString;
         method: z.ZodString;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"code">;
         code: z.ZodString;
@@ -720,6 +765,16 @@ export declare const CompositionFeatureSchema: z.ZodDiscriminatedUnion<[z.ZodObj
                 omit: "omit";
             }>;
         }, z.core.$strip>], "kind">>;
+        reset: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"forward">;
+            source: z.ZodObject<{
+                addonId: z.ZodString;
+                stableId: z.ZodString;
+            }, z.core.$strip>;
+            cap: z.ZodString;
+            method: z.ZodString;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"forward">;
@@ -729,6 +784,7 @@ export declare const CompositionFeatureSchema: z.ZodDiscriminatedUnion<[z.ZodObj
         }, z.core.$strip>;
         cap: z.ZodString;
         method: z.ZodString;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"code">;
         code: z.ZodString;
@@ -952,6 +1008,16 @@ export declare const CompositionSchema: z.ZodObject<{
                     omit: "omit";
                 }>;
             }, z.core.$strip>], "kind">>;
+            reset: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"forward">;
+                source: z.ZodObject<{
+                    addonId: z.ZodString;
+                    stableId: z.ZodString;
+                }, z.core.$strip>;
+                cap: z.ZodString;
+                method: z.ZodString;
+                args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>>;
         commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"forward">;
@@ -961,6 +1027,7 @@ export declare const CompositionSchema: z.ZodObject<{
             }, z.core.$strip>;
             cap: z.ZodString;
             method: z.ZodString;
+            args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<CompositionForwardArg, unknown, z.core.$ZodTypeInternals<CompositionForwardArg, unknown>>>>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"code">;
             code: z.ZodString;

package/dist/composition/index.d.ts

@@ -13,6 +13,8 @@ export * from './evaluate-field.js';
 export * from './examples.js';
 export * from './expression-kinds.js';
 export * from './presets/numeric-transforms.js';
+export * from './presets/pet-fountain.js';
 export * from './state-fields.js';
 export * from './validate-composition.js';
+export * from './validate-forward.js';
 export * from './cards/index.js';

package/dist/composition/presets/pet-fountain.d.ts

@@ -0,0 +1,36 @@
+import { type Composition, type CompositionSourceRef } from '../composition.js';
+/** The optional filter of a fountain: its remaining days and the "filter changed" button. */
+export interface PetFountainFilterSources {
+    /** An `enum-sensor` whose value is the days left, as a numeric string. */
+    readonly daysRemaining: CompositionSourceRef;
+    /** A `button` the filter reset presses. */
+    readonly changed: CompositionSourceRef;
+}
+/** The entities a pet fountain is built from. */
+export interface PetFountainEntitySources {
+    /** `enum-sensor.value`: tank level, percent as text. */
+    readonly waterLevel: CompositionSourceRef;
+    /** `enum-sensor.value`: tank volume, millilitres as text. */
+    readonly waterVolume: CompositionSourceRef;
+    /** `switch`: the pump. */
+    readonly pump: CompositionSourceRef;
+    /** `switch`: the on/off duty cycle. */
+    readonly pumpInterval: CompositionSourceRef;
+    /** `control` (numeric): minutes the pump runs per cycle. */
+    readonly pumpOnMinutes: CompositionSourceRef;
+    /** `control` (numeric): minutes the pump rests per cycle. */
+    readonly pumpOffMinutes: CompositionSourceRef;
+    /** `enum-sensor.value`: the last drink, millilitres as text. */
+    readonly lastDrink: CompositionSourceRef;
+    /** `enum-sensor.value`: this hour's drinking, millilitres as text. */
+    readonly currentHourDrink: CompositionSourceRef;
+    /** `enum-sensor.value`: the rolling 24 h drinking, millilitres as text. */
+    readonly last24hDrink: CompositionSourceRef;
+    /** `enum-sensor.value`: today's drinking, millilitres as text. */
+    readonly todayDrink: CompositionSourceRef;
+    /** `button`: clears the rolling daily counters. */
+    readonly clearDaily: CompositionSourceRef;
+    /** Present when the fountain has a filter entity pair; adds a `filter` consumable. */
+    readonly filter?: PetFountainFilterSources;
+}
+export declare function petFountainFromEntitiesComposition(sources: PetFountainEntitySources): Composition;

package/dist/composition/validate-forward.d.ts

@@ -0,0 +1,31 @@
+import type { CapabilityDefinition } from '../capabilities/capability-definition.js';
+import { type Composition, type CompositionFieldsFeature, type CompositionForwardCommand, type CompositionSourceRef } from './composition.js';
+import type { CompositionProblem } from './composition-report.js';
+import type { CapabilityLookup, CompositionSourceDescription } from './validate-composition.js';
+/** A forward and where it sits in the composition, for a refusal that names the place. */
+export interface PlacedForward {
+    /** `features[0].commands.setPump` or `features[0].items.filter.reset`. */
+    readonly at: string;
+    /** The built method it serves. */
+    readonly method: string;
+    /** Set for an item's `reset`: the item key selects the command and is not an argument. */
+    readonly itemKey?: string;
+    readonly command: CompositionForwardCommand;
+}
+export declare const DEVICE_ID_FIELD = "deviceId";
+/** Every forward of a feature: the method commands, then each item's `reset`. */
+export declare function featureForwards(feature: CompositionFieldsFeature, featureIndex: number): readonly PlacedForward[];
+/** Every source a forward of an enabled feature calls, once. */
+export declare function forwardSourceRefs(composition: Composition): readonly CompositionSourceRef[];
+/** The methods a BUILT cap must give a command: served, and not answered by the composer itself. */
+export declare function commandedMethods(def: CapabilityDefinition): readonly string[];
+/** One forward against the built cap's method and the source cap's method. */
+export declare function forwardProblems(built: CapabilityDefinition, forward: PlacedForward, lookupCap: CapabilityLookup): readonly CompositionProblem[];
+/** A command must name a method the built cap serves and the composer does not answer itself. */
+export declare function commandMethodProblems(built: CapabilityDefinition, feature: CompositionFieldsFeature, at: string): readonly CompositionProblem[];
+/**
+ * The source DEVICES of the forwards, read: each must exist and bind the cap it
+ * is called on. A forward onto an unread device is refused rather than stored
+ * unchecked, like every other source (D391).
+ */
+export declare function forwardSourceProblems(composition: Composition, sources: ReadonlyMap<string, CompositionSourceDescription>): readonly CompositionProblem[];

package/dist/{composition-C0dlyG9U.js → composition-CO6Sak-s.js}

@@ -1,4 +1,4 @@
-const require_err_msg = require("./err-msg-COHgq7Mb.js");
+const require_err_msg = require("./err-msg-EJhsFHqa.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 //#region src/ffmpeg/invocation.ts
@@ -3205,12 +3205,32 @@ var CompositionFieldSourceSchema = zod.z.discriminatedUnion("kind", [
 	CompositionAggregateSourceSchema,
 	CompositionSeriesSourceSchema
 ]);
-/** `forward`: RESERVED for slice 3. Argument mapping arrives there as an additive optional `args`. */
+/** The marker of a forward argument that takes its value from the built method's input. */
+var FORWARD_INPUT_KEY = "$input";
+var forwardArgUnion = zod.z.union([
+	zod.z.string(),
+	zod.z.number(),
+	zod.z.boolean(),
+	zod.z.strictObject({ [FORWARD_INPUT_KEY]: zod.z.string().min(1) }),
+	zod.z.record(zod.z.string().min(1), zod.z.lazy(() => forwardArgUnion))
+]);
+var CompositionForwardArgSchema = forwardArgUnion;
+/** True for `{ $input: '<field>' }`. */
+function isForwardInputRef(value) {
+	return typeof value === "object" && typeof value.$input === "string";
+}
+/**
+* `forward` (D659, amended by D967): one method of a BUILT capability is one
+* call of `cap.method` on `source`. Without `args` the built method's input
+* passes through minus `deviceId`; with `args` the template IS the source's
+* whole input. `deviceId` is always the source's own, never an argument.
+*/
 var CompositionForwardCommandSchema = zod.z.object({
 	kind: zod.z.literal("forward"),
 	source: CompositionSourceRefSchema,
 	cap: zod.z.string().min(1),
-	method: zod.z.string().min(1)
+	method: zod.z.string().min(1),
+	args: zod.z.record(zod.z.string().min(1), CompositionForwardArgSchema).optional()
 });
 var CompositionCommandTargetSchema = zod.z.discriminatedUnion("kind", [CompositionForwardCommandSchema, CompositionCodeSourceSchema]);
 /** An item key inside an item-array cap (`consumables.items[<key>]`). */
@@ -3225,7 +3245,13 @@ var COMPOSITION_ITEM_ARRAY_PATH = "items";
 */
 var CompositionItemEntrySchema = zod.z.object({
 	label: zod.z.string().min(1).max(80),
-	fields: zod.z.record(zod.z.string().min(1), CompositionFieldSourceSchema)
+	fields: zod.z.record(zod.z.string().min(1), CompositionFieldSourceSchema),
+	/**
+	* What the cap's `reset` does for THIS item (consumables). Present = the item
+	* is resettable and a `reset` call naming its key forwards here. The item key
+	* selects the command, so it is never an argument: there is no pass-through.
+	*/
+	reset: CompositionForwardCommandSchema.optional()
 });
 var CompositionFieldsFeatureSchema = zod.z.object({
 	kind: zod.z.literal("fields"),
@@ -3237,7 +3263,7 @@ var CompositionFieldsFeatureSchema = zod.z.object({
 	* owns the WHOLE array field: the composed value holds exactly these items.
 	*/
 	items: zod.z.record(zod.z.string().regex(COMPOSITION_ITEM_KEY_RE), CompositionItemEntrySchema).refine((items) => Object.keys(items).length <= 16, { message: `at most 16 items` }).optional(),
-	/** RESERVED for slice 3; refused by the validator when non-empty. */
+	/** Method name → what serves it. Only a BUILT capability takes commands (D967). */
 	commands: zod.z.record(zod.z.string().min(1), CompositionCommandTargetSchema).optional()
 });
 /** RESERVED for slice 3: a media / data-plane cap, whole, from one source. */
@@ -3524,6 +3550,12 @@ Object.defineProperty(exports, "CompositionFieldsFeatureSchema", {
 		return CompositionFieldsFeatureSchema;
 	}
 });
+Object.defineProperty(exports, "CompositionForwardArgSchema", {
+	enumerable: true,
+	get: function() {
+		return CompositionForwardArgSchema;
+	}
+});
 Object.defineProperty(exports, "CompositionForwardCommandSchema", {
 	enumerable: true,
 	get: function() {
@@ -3680,6 +3712,12 @@ Object.defineProperty(exports, "FFMPEG_RELEASE", {
 		return FFMPEG_RELEASE;
 	}
 });
+Object.defineProperty(exports, "FORWARD_INPUT_KEY", {
+	enumerable: true,
+	get: function() {
+		return FORWARD_INPUT_KEY;
+	}
+});
 Object.defineProperty(exports, "Fmp4BoxSplitter", {
 	enumerable: true,
 	get: function() {
@@ -4166,6 +4204,12 @@ Object.defineProperty(exports, "isApplianceKind", {
 		return isApplianceKind;
 	}
 });
+Object.defineProperty(exports, "isForwardInputRef", {
+	enumerable: true,
+	get: function() {
+		return isForwardInputRef;
+	}
+});
 Object.defineProperty(exports, "isHistoryHelper", {
 	enumerable: true,
 	get: function() {

package/dist/{composition-bIBW5_13.mjs → composition-kSuOifuG.mjs}

@@ -1,4 +1,4 @@
-import { a as DeviceType, i as DeviceRole } from "./err-msg-BCdlR2Li.mjs";
+import { a as DeviceType, i as DeviceRole } from "./err-msg-DWXWc0Di.mjs";
 import { z } from "zod";
 import { createHash } from "node:crypto";
 //#region src/ffmpeg/invocation.ts
@@ -3205,12 +3205,32 @@ var CompositionFieldSourceSchema = z.discriminatedUnion("kind", [
 	CompositionAggregateSourceSchema,
 	CompositionSeriesSourceSchema
 ]);
-/** `forward`: RESERVED for slice 3. Argument mapping arrives there as an additive optional `args`. */
+/** The marker of a forward argument that takes its value from the built method's input. */
+var FORWARD_INPUT_KEY = "$input";
+var forwardArgUnion = z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.strictObject({ [FORWARD_INPUT_KEY]: z.string().min(1) }),
+	z.record(z.string().min(1), z.lazy(() => forwardArgUnion))
+]);
+var CompositionForwardArgSchema = forwardArgUnion;
+/** True for `{ $input: '<field>' }`. */
+function isForwardInputRef(value) {
+	return typeof value === "object" && typeof value.$input === "string";
+}
+/**
+* `forward` (D659, amended by D967): one method of a BUILT capability is one
+* call of `cap.method` on `source`. Without `args` the built method's input
+* passes through minus `deviceId`; with `args` the template IS the source's
+* whole input. `deviceId` is always the source's own, never an argument.
+*/
 var CompositionForwardCommandSchema = z.object({
 	kind: z.literal("forward"),
 	source: CompositionSourceRefSchema,
 	cap: z.string().min(1),
-	method: z.string().min(1)
+	method: z.string().min(1),
+	args: z.record(z.string().min(1), CompositionForwardArgSchema).optional()
 });
 var CompositionCommandTargetSchema = z.discriminatedUnion("kind", [CompositionForwardCommandSchema, CompositionCodeSourceSchema]);
 /** An item key inside an item-array cap (`consumables.items[<key>]`). */
@@ -3225,7 +3245,13 @@ var COMPOSITION_ITEM_ARRAY_PATH = "items";
 */
 var CompositionItemEntrySchema = z.object({
 	label: z.string().min(1).max(80),
-	fields: z.record(z.string().min(1), CompositionFieldSourceSchema)
+	fields: z.record(z.string().min(1), CompositionFieldSourceSchema),
+	/**
+	* What the cap's `reset` does for THIS item (consumables). Present = the item
+	* is resettable and a `reset` call naming its key forwards here. The item key
+	* selects the command, so it is never an argument: there is no pass-through.
+	*/
+	reset: CompositionForwardCommandSchema.optional()
 });
 var CompositionFieldsFeatureSchema = z.object({
 	kind: z.literal("fields"),
@@ -3237,7 +3263,7 @@ var CompositionFieldsFeatureSchema = z.object({
 	* owns the WHOLE array field: the composed value holds exactly these items.
 	*/
 	items: z.record(z.string().regex(COMPOSITION_ITEM_KEY_RE), CompositionItemEntrySchema).refine((items) => Object.keys(items).length <= 16, { message: `at most 16 items` }).optional(),
-	/** RESERVED for slice 3; refused by the validator when non-empty. */
+	/** Method name → what serves it. Only a BUILT capability takes commands (D967). */
 	commands: z.record(z.string().min(1), CompositionCommandTargetSchema).optional()
 });
 /** RESERVED for slice 3: a media / data-plane cap, whole, from one source. */
@@ -3350,4 +3376,4 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
-export { GroupTemplateIdSchema as $, validateExpressionSource as $t, composedDeviceStableId as A, sliceActiveValue as An, planResetTier as At, AGGREGATE_REDUCERS as B, AUDIO_PRESETS as Bn, wattMillisecondsToKwh as Bt, CompositionSeriesSourceSchema as C, SOURCE_CAPS as Cn, RollingWindowSchema as Ct, MAX_COMPOSITION_FIELDS_PER_FEATURE as D, evaluateSensorEdge as Dn, nextLocalMidnight as Dt, MAX_COMPOSITION_FEATURES as E, SOURCE_DEVICE_TYPES as En, maxDurationMs as Et, compositionSourceKey as F, FFMPEG_RELEASE as Fn, STATISTIC_STATS as Ft, ArithmeticHelperSpecSchema as G, buildInputArgs as Gn, isApplianceKind as Gt, ActiveCriterionSchema as H, audioPlanFromEncodeProfile as Hn, APPLIANCE_KINDS as Ht, featureFieldEntries as I, getFfmpegArtifact as In, evaluateDerivative as It, DerivativeHelperSpecSchema as J, isSoftwareDecode as Jn, cloneStatefulExpressionMemory as Jt, BINARY_AGGREGATES as K, buildVideoArgs as Kn, sourcePickForAppliance as Kt, featureSources as L, getFfmpegDownloadUrl as Ln, evaluateStatistic as Lt, compositionItemFieldPath as M, FFMPEG_PATH_ENV as Mn, rollingDurationMs as Mt, compositionReadKey as N, chooseFfmpegBinary as Nn, statisticCadenceMs as Nt, MAX_COMPOSITION_ITEMS as O, evaluateSensorLevelEdge as On, openReset as Ot, compositionSliceKey as P, ffmpegBinaryName as Pn, SERIES_KINDS as Pt, GroupHelperSpecSchema as Q, toExpressionValue as Qt, fieldReads as R, canonicalHash as Rn, integrateReading as Rt, CompositionSchema as S, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as Sn, ROLLING_SPANS as St, MAX_COMPOSITION_CODE_LENGTH as T, SOURCE_CAP_CHANGED_AT_FIELD as Tn, integralCadenceMs as Tt, AggregateReducerSchema as U, buildAudioArgs as Un, APPLIANCE_TEMPLATE_ID as Ut, ARITHMETIC_OPS as V, RESTREAM_INPUT_PROBE as Vn, APPLIANCE_DEFAULTS as Vt, ApplianceHelperSpecSchema as W, buildFfmpegArgs as Wn, applianceDeviceType as Wt, ExpressionHelperSpecSchema as X, pickVideoEncoder as Xn, evaluateExpressionSource as Xt, EXPRESSION_OUTPUTS as Y, logBannerArgs as Yn, createStatefulExpressionMemory as Yt, GROUP_TEMPLATE_IDS as Z, resolveStreamMaps as Zn, evaluateStatefulExpressionCall as Zt, CompositionFromSourceSchema as _, evaluateCount as _n, HISTORY_TIERS as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, tokenize as an, NUMERIC_AGGREGATES as at, CompositionNewTargetSchema as b, ExpressionEvalError as bn, MIN_CUSTOM_MINUTES as bt, CompositionCodeSourceSchema as c, MAX_EXPRESSION_AST_NODES as cn, helperMembers as ct, CompositionExpressionSourceSchema as d, MAX_EXPRESSION_EVAL_STEPS as dn, CALENDAR_PERIODS as dt, createExpressionScope as en, HelperMemberSchema as et, CompositionFeatureSchema as f, MAX_EXPRESSION_SOURCE_LENGTH as fn, CalendarWindowSchema as ft, CompositionForwardCommandSchema as g, disarmRoseMemory as gn, HISTORY_SLOW_MS as gt, CompositionFieldsFeatureSchema as h, EXPRESSION_BUILTIN_NAMES as hn, HISTORY_FAST_MS as ht, COMPOSITION_ITEM_KEY_RE as i, parseExpression as in, MAX_HELPER_MEMBERS as it, compositionFeatureEnabled as j, sliceChangedAt as jn, planStatisticTier as jt, composedDeviceRef as k, isSourceCap as kn, openStatistic as kt, CompositionCommandTargetSchema as l, MAX_EXPRESSION_BINDINGS as ln, isHistoryHelper as lt, CompositionFieldSourceSchema as m, EXPRESSION_BUILTINS as mn, DEFAULT_HISTORY_RETENTION as mt, COMPOSER_ADDON_ID as n, compileExpression as nn, INTEGRAL_OUTPUTS as nt, CompositionAggregateSourceSchema as o, EXPRESSION_COMPILE_CACHE_CAPACITY as on, StatisticHelperSpecSchema as ot, CompositionFieldReadSchema as p, RESERVED_BINDING_NAMES as pn, DAY_MS as pt, DERIVATIVE_UNITS as q, invocationFromEncodeProfile as qn, EXPRESSION_INJECTED_NOW as qt, COMPOSITION_ITEM_ARRAY_PATH as r, compileExpressionSafe as rn, IntegralHelperSpecSchema as rt, CompositionBindingSchema as s, EXPRESSION_IDENTIFIER_RE as sn, ThresholdHelperSpecSchema as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, evaluateAst as tn, HelperSpecSchema as tt, CompositionExistingTargetSchema as u, MAX_EXPRESSION_CALL_ARGS as un, CompositionSourceRefSchema as ut, CompositionItemEntrySchema as v, evaluateRose as vn, HOUR_MS as vt, CompositionTargetSchema as w, SOURCE_CAP_ACTIVE_FIELD as wn, StatisticWindowSchema as wt, CompositionPassthroughFeatureSchema as x, ExpressionParseError as xn, RESET_PERIODS as xt, CompositionLiteralBindingSchema as y, isStatefulBuiltin as yn, MINUTE_MS as yt, ACTIVE_CRITERIA as z, Fmp4BoxSplitter as zn, KWH_PER_WATT_MS as zt };
+export { ExpressionHelperSpecSchema as $, pickVideoEncoder as $n, evaluateExpressionSource as $t, MAX_COMPOSITION_ITEMS as A, evaluateSensorEdge as An, nextLocalMidnight as At, fieldReads as B, getFfmpegDownloadUrl as Bn, evaluateStatistic as Bt, CompositionSchema as C, ExpressionEvalError as Cn, MIN_CUSTOM_MINUTES as Ct, MAX_COMPOSITION_CODE_LENGTH as D, SOURCE_CAP_ACTIVE_FIELD as Dn, StatisticWindowSchema as Dt, FORWARD_INPUT_KEY as E, SOURCE_CAPS as En, RollingWindowSchema as Et, compositionReadKey as F, FFMPEG_PATH_ENV as Fn, rollingDurationMs as Ft, ActiveCriterionSchema as G, audioPlanFromEncodeProfile as Gn, APPLIANCE_KINDS as Gt, ACTIVE_CRITERIA as H, Fmp4BoxSplitter as Hn, KWH_PER_WATT_MS as Ht, compositionSliceKey as I, chooseFfmpegBinary as In, statisticCadenceMs as It, ArithmeticHelperSpecSchema as J, buildInputArgs as Jn, isApplianceKind as Jt, AggregateReducerSchema as K, buildAudioArgs as Kn, APPLIANCE_TEMPLATE_ID as Kt, compositionSourceKey as L, ffmpegBinaryName as Ln, SERIES_KINDS as Lt, composedDeviceStableId as M, isSourceCap as Mn, openStatistic as Mt, compositionFeatureEnabled as N, sliceActiveValue as Nn, planResetTier as Nt, MAX_COMPOSITION_FEATURES as O, SOURCE_CAP_CHANGED_AT_FIELD as On, integralCadenceMs as Ot, compositionItemFieldPath as P, sliceChangedAt as Pn, planStatisticTier as Pt, EXPRESSION_OUTPUTS as Q, logBannerArgs as Qn, createStatefulExpressionMemory as Qt, featureFieldEntries as R, FFMPEG_RELEASE as Rn, STATISTIC_STATS as Rt, CompositionPassthroughFeatureSchema as S, isStatefulBuiltin as Sn, MINUTE_MS as St, CompositionTargetSchema as T, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as Tn, ROLLING_SPANS as Tt, AGGREGATE_REDUCERS as U, AUDIO_PRESETS as Un, wattMillisecondsToKwh as Ut, isForwardInputRef as V, canonicalHash as Vn, integrateReading as Vt, ARITHMETIC_OPS as W, RESTREAM_INPUT_PROBE as Wn, APPLIANCE_DEFAULTS as Wt, DERIVATIVE_UNITS as X, invocationFromEncodeProfile as Xn, EXPRESSION_INJECTED_NOW as Xt, BINARY_AGGREGATES as Y, buildVideoArgs as Yn, sourcePickForAppliance as Yt, DerivativeHelperSpecSchema as Z, isSoftwareDecode as Zn, cloneStatefulExpressionMemory as Zt, CompositionForwardCommandSchema as _, EXPRESSION_BUILTINS as _n, DEFAULT_HISTORY_RETENTION as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, compileExpression as an, INTEGRAL_OUTPUTS as at, CompositionLiteralBindingSchema as b, evaluateCount as bn, HISTORY_TIERS as bt, CompositionCodeSourceSchema as c, tokenize as cn, NUMERIC_AGGREGATES as ct, CompositionExpressionSourceSchema as d, MAX_EXPRESSION_AST_NODES as dn, helperMembers as dt, evaluateStatefulExpressionCall as en, resolveStreamMaps as er, GROUP_TEMPLATE_IDS as et, CompositionFeatureSchema as f, MAX_EXPRESSION_BINDINGS as fn, isHistoryHelper as ft, CompositionForwardArgSchema as g, RESERVED_BINDING_NAMES as gn, DAY_MS as gt, CompositionFieldsFeatureSchema as h, MAX_EXPRESSION_SOURCE_LENGTH as hn, CalendarWindowSchema as ht, COMPOSITION_ITEM_KEY_RE as i, evaluateAst as in, HelperSpecSchema as it, composedDeviceRef as j, evaluateSensorLevelEdge as jn, openReset as jt, MAX_COMPOSITION_FIELDS_PER_FEATURE as k, SOURCE_DEVICE_TYPES as kn, maxDurationMs as kt, CompositionCommandTargetSchema as l, EXPRESSION_COMPILE_CACHE_CAPACITY as ln, StatisticHelperSpecSchema as lt, CompositionFieldSourceSchema as m, MAX_EXPRESSION_EVAL_STEPS as mn, CALENDAR_PERIODS as mt, COMPOSER_ADDON_ID as n, validateExpressionSource as nn, GroupTemplateIdSchema as nt, CompositionAggregateSourceSchema as o, compileExpressionSafe as on, IntegralHelperSpecSchema as ot, CompositionFieldReadSchema as p, MAX_EXPRESSION_CALL_ARGS as pn, CompositionSourceRefSchema as pt, ApplianceHelperSpecSchema as q, buildFfmpegArgs as qn, applianceDeviceType as qt, COMPOSITION_ITEM_ARRAY_PATH as r, createExpressionScope as rn, HelperMemberSchema as rt, CompositionBindingSchema as s, parseExpression as sn, MAX_HELPER_MEMBERS as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, toExpressionValue as tn, GroupHelperSpecSchema as tt, CompositionExistingTargetSchema as u, EXPRESSION_IDENTIFIER_RE as un, ThresholdHelperSpecSchema as ut, CompositionFromSourceSchema as v, EXPRESSION_BUILTIN_NAMES as vn, HISTORY_FAST_MS as vt, CompositionSeriesSourceSchema as w, ExpressionParseError as wn, RESET_PERIODS as wt, CompositionNewTargetSchema as x, evaluateRose as xn, HOUR_MS as xt, CompositionItemEntrySchema as y, disarmRoseMemory as yn, HISTORY_SLOW_MS as yt, featureSources as z, getFfmpegArtifact as zn, evaluateDerivative as zt };

package/dist/device/cap-vocabulary/entries/appliances.d.ts

@@ -1,5 +1,5 @@
 import type { CapVocabularySlice } from '../types.js';
-type ApplianceCap = 'vacuum-control' | 'lawn-mower-control' | 'dishwasher' | 'pet-feeder' | 'media-player' | 'consumables' | 'running-state' | 'navigation' | 'script-runner' | 'automation-control' | 'notifier' | 'update';
+type ApplianceCap = 'vacuum-control' | 'lawn-mower-control' | 'dishwasher' | 'pet-feeder' | 'pet-fountain' | 'media-player' | 'consumables' | 'running-state' | 'navigation' | 'script-runner' | 'automation-control' | 'notifier' | 'update';
 /** The appliance family of the vocabulary. */
 export declare const APPLIANCE_CAP_VOCABULARY: CapVocabularySlice<ApplianceCap>;
 export {};

package/dist/device/device-control-resolution.d.ts

@@ -37,7 +37,7 @@ import { DeviceType } from './device-type.js';
  * kind can back several device types (`'switch'` ← Switch + Siren, `'sensor'`
  * ← Sensor + Presence, `'dummy'` ← every placeholder/non-controllable type).
  */
-export type DeviceControlKind = 'cover' | 'valve' | 'humidifier' | 'water-heater' | 'switch' | 'light' | 'fan' | 'sensor' | 'thermostat' | 'climate' | 'button' | 'update' | 'lock' | 'media-player' | 'alarm' | 'control' | 'weather' | 'vacuum' | 'lawn-mower' | 'image' | 'pet-feeder' | 'dishwasher' | 'script' | 'automation' | 'dummy';
+export type DeviceControlKind = 'cover' | 'valve' | 'humidifier' | 'water-heater' | 'switch' | 'light' | 'fan' | 'sensor' | 'thermostat' | 'climate' | 'button' | 'update' | 'lock' | 'media-player' | 'alarm' | 'control' | 'weather' | 'vacuum' | 'lawn-mower' | 'image' | 'pet-feeder' | 'pet-fountain' | 'dishwasher' | 'script' | 'automation' | 'dummy';
 /**
  * Exhaustive `DeviceType` → `DeviceControlKind` map. Omitting a new enum member
  * fails the build here (the single place the type→kind decision is encoded).

package/dist/device/device-type.d.ts

@@ -89,6 +89,10 @@ export declare enum DeviceType {
      *  native PetKit (`nodepetkit` `FeederDevice`), reusable by other feeder
      *  integrations sharing the same food/desiccant/hopper surface. */
     PetFeeder = "pet-feeder",
+    /** Pet water fountain — tank level, water drunk, pump and its duty cycle.
+     *  Installed with the `pet-fountain` cap. Reaches CamStack as loose entities
+     *  of a container and is BUILT as a composed device (D967). */
+    PetFountain = "pet-fountain",
     /** Built-in dishwasher — program lifecycle, door / remote-start gates,
      *  salt and rinse-aid levels. Installed with the `dishwasher` cap.
      *  Sources: native Bosch Home Connect, reusable by similar integrations.

package/dist/{err-msg-BCdlR2Li.mjs → err-msg-DWXWc0Di.mjs}

@@ -90,6 +90,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	*  native PetKit (`nodepetkit` `FeederDevice`), reusable by other feeder
 	*  integrations sharing the same food/desiccant/hopper surface. */
 	DeviceType["PetFeeder"] = "pet-feeder";
+	/** Pet water fountain — tank level, water drunk, pump and its duty cycle.
+	*  Installed with the `pet-fountain` cap. Reaches CamStack as loose entities
+	*  of a container and is BUILT as a composed device (D967). */
+	DeviceType["PetFountain"] = "pet-fountain";
 	/** Built-in dishwasher — program lifecycle, door / remote-start gates,
 	*  salt and rinse-aid levels. Installed with the `dishwasher` cap.
 	*  Sources: native Bosch Home Connect, reusable by similar integrations.

package/dist/{err-msg-COHgq7Mb.js → err-msg-EJhsFHqa.js}

@@ -90,6 +90,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	*  native PetKit (`nodepetkit` `FeederDevice`), reusable by other feeder
 	*  integrations sharing the same food/desiccant/hopper surface. */
 	DeviceType["PetFeeder"] = "pet-feeder";
+	/** Pet water fountain — tank level, water drunk, pump and its duty cycle.
+	*  Installed with the `pet-fountain` cap. Reaches CamStack as loose entities
+	*  of a container and is BUILT as a composed device (D967). */
+	DeviceType["PetFountain"] = "pet-fountain";
 	/** Built-in dishwasher — program lifecycle, door / remote-start gates,
 	*  salt and rinse-aid levels. Installed with the `dishwasher` cap.
 	*  Sources: native Bosch Home Connect, reusable by similar integrations.