@camstack/types 1.1.19 → 1.1.21

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BabrCASa.js");
+const require_sleep = require("./sleep-DaQgDq90.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,3 +1,3 @@
-import { A as ReadinessRegistry, C as asJsonObject, O as parseJsonUnknown, P as scopeKey, T as asString, a as adminUiCapability, b as DeviceType, gt as DisposerChain, ht as EventCategory, i as deviceOpsCapability, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, st as normalizeAddonInitResult, t as sleep, ut as emitReadiness } from "./sleep-MHm--th-.mjs";
+import { A as ReadinessRegistry, C as asJsonObject, O as parseJsonUnknown, P as scopeKey, T as asString, a as adminUiCapability, b as DeviceType, gt as DisposerChain, ht as EventCategory, i as deviceOpsCapability, j as ReadinessTimeoutError, k as DATAPLANE_SECRET_HEADER, o as createDeviceProxy, ot as BaseAddon, p as expandCapMethods, st as normalizeAddonInitResult, t as sleep, ut as emitReadiness } from "./sleep-BO1nweKv.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep };

package/dist/capabilities/battery.cap.d.ts

@@ -88,6 +88,12 @@ export declare const batteryCapability: {
             binary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
         readonly kind: "push";
+        readonly empty: {
+            readonly percentage: 0;
+            readonly charging: "none";
+            readonly sleeping: false;
+            readonly lastUpdated: 0;
+        };
     };
     /**
      * Runtime-state slice — every provider that registers this cap

package/dist/capabilities/capability-definition.d.ts

@@ -67,10 +67,49 @@ export interface CapabilityEventSchema<TData extends z.ZodType = z.ZodType> {
     readonly data: TData;
 }
 export type CapabilityStatusKind = 'push' | 'poll' | 'command-driven';
+/**
+ * Declares that a cap's status is an ITEM-ARRAY wiring target: the status
+ * holds an array of keyed items (`consumables.items`) that device-links can
+ * populate per item via `DeviceLink.target.itemKey`. Links sharing an
+ * `itemKey` are grouped into ONE item: the merge seeds a new item from
+ * `emptyItem` (with `keyField` — and `labelField` when declared — set to the
+ * itemKey), overlays each link's per-item `fieldPath`, validates the item
+ * against `itemSchema`, then upserts it into the array by `keyField`.
+ */
+export interface CapabilityStatusItemArray {
+    /** Dot-path from the status root to the array field (e.g. 'items'). */
+    readonly path: string;
+    /** Item field carrying the stable per-item key (e.g. 'key'). */
+    readonly keyField: string;
+    /** Optional item field defaulted to the itemKey when a NEW item is seeded
+     *  and no link overlays it (e.g. 'label' — schemas often require it
+     *  non-empty). Existing items keep their value. */
+    readonly labelField?: string;
+    /** Zod schema of ONE array item — the per-item validation gate (a bad
+     *  item is skipped without discarding the other items). */
+    readonly itemSchema: z.ZodType;
+    /** Seed for a NEW item created from links; `keyField`/`labelField` are
+     *  overwritten with the itemKey, links overlay the rest. Must produce an
+     *  `itemSchema`-valid item once seeded. */
+    readonly emptyItem: Readonly<Record<string, unknown>>;
+}
 export interface CapabilityStatusSchema<TStatus extends z.ZodType = z.ZodType> {
     readonly schema: TStatus;
     /** Documentation hint on update cadence — used by the aggregator and UI. */
     readonly kind?: CapabilityStatusKind;
+    /**
+     * Default status used as the merge BASE when a device-link *synthesizes*
+     * this cap (no native provider). Required-but-unlinked fields (enums,
+     * timestamps) come from here so the synthesized status validates against
+     * `schema`. Omit for caps that are never synthesize targets.
+     */
+    readonly empty?: z.infer<TStatus>;
+    /**
+     * Item-array wiring descriptor — set when the status holds an array of
+     * keyed items that device-links populate per item (`itemKey` grouping).
+     * See {@link CapabilityStatusItemArray}. Omit for scalar-only caps.
+     */
+    readonly itemArray?: CapabilityStatusItemArray;
 }
 /** How a contribution's component is resolved by the renderer. */
 export type UiContributionKind = 'remote';

package/dist/capabilities/consumables.cap.d.ts

@@ -84,6 +84,41 @@ export declare const consumablesCapability: {
             lastChangedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: "push";
+        readonly empty: {
+            items: {
+                key: string;
+                label: string;
+                level: number | null;
+                status: "replace" | "ok" | null;
+                lastResetAt: number | null;
+                resettable: boolean;
+            }[];
+            lastChangedAt: number;
+        };
+        readonly itemArray: {
+            readonly path: "items";
+            readonly keyField: "key";
+            readonly labelField: "label";
+            readonly itemSchema: z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                level: z.ZodNullable<z.ZodNumber>;
+                status: z.ZodNullable<z.ZodEnum<{
+                    replace: "replace";
+                    ok: "ok";
+                }>>;
+                lastResetAt: z.ZodNullable<z.ZodNumber>;
+                resettable: z.ZodBoolean;
+            }, z.core.$strip>;
+            readonly emptyItem: {
+                key: string;
+                label: string;
+                level: number | null;
+                status: "replace" | "ok" | null;
+                lastResetAt: number | null;
+                resettable: boolean;
+            };
+        };
     };
     readonly runtimeState: z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{