@camstack/types 1.2.559 → 1.2.561

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (239) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/dist/addon.js +1 -1
  3. package/dist/addon.mjs +1 -1
  4. package/dist/automation/recipe.d.ts +120 -120
  5. package/dist/capabilities/accessories.cap.d.ts +6 -0
  6. package/dist/capabilities/action-source.cap.d.ts +3 -0
  7. package/dist/capabilities/actions.cap.d.ts +3 -0
  8. package/dist/capabilities/addon-pages-source.cap.d.ts +3 -0
  9. package/dist/capabilities/addon-pages.cap.d.ts +3 -0
  10. package/dist/capabilities/addon-routes.cap.d.ts +3 -0
  11. package/dist/capabilities/addon-settings.cap.d.ts +3 -0
  12. package/dist/capabilities/addon-widgets-source.cap.d.ts +3 -0
  13. package/dist/capabilities/addon-widgets.cap.d.ts +3 -0
  14. package/dist/capabilities/addons.cap.d.ts +3 -0
  15. package/dist/capabilities/admin-ui.cap.d.ts +3 -0
  16. package/dist/capabilities/air-quality-sensor.cap.d.ts +39 -0
  17. package/dist/capabilities/alarm-panel.cap.d.ts +60 -14
  18. package/dist/capabilities/alerts.cap.d.ts +3 -0
  19. package/dist/capabilities/ambient-light-sensor.cap.d.ts +12 -0
  20. package/dist/capabilities/audio-analysis.cap.d.ts +4 -0
  21. package/dist/capabilities/audio-analyzer.cap.d.ts +3 -0
  22. package/dist/capabilities/audio-codec.cap.d.ts +3 -0
  23. package/dist/capabilities/audio-metrics.cap.d.ts +4 -0
  24. package/dist/capabilities/auth-provider.cap.d.ts +3 -0
  25. package/dist/capabilities/automation-control.cap.d.ts +19 -0
  26. package/dist/capabilities/backup.cap.d.ts +3 -0
  27. package/dist/capabilities/battery.cap.d.ts +53 -0
  28. package/dist/capabilities/binary.cap.d.ts +136 -0
  29. package/dist/capabilities/board-key-source.cap.d.ts +3 -0
  30. package/dist/capabilities/brightness.cap.d.ts +13 -0
  31. package/dist/capabilities/broker.cap.d.ts +3 -0
  32. package/dist/capabilities/button.cap.d.ts +4 -0
  33. package/dist/capabilities/calendar-source.cap.d.ts +3 -0
  34. package/dist/capabilities/calendars.cap.d.ts +3 -0
  35. package/dist/capabilities/camera-credentials.cap.d.ts +4 -0
  36. package/dist/capabilities/camera-grid-layout.cap.d.ts +4 -0
  37. package/dist/capabilities/camera-pipeline-config.cap.d.ts +4 -0
  38. package/dist/capabilities/camera-streams.cap.d.ts +4 -0
  39. package/dist/capabilities/capability-definition.d.ts +37 -8
  40. package/dist/capabilities/carbon-monoxide.cap.d.ts +12 -0
  41. package/dist/capabilities/climate-control.cap.d.ts +68 -12
  42. package/dist/capabilities/cluster-update.cap.d.ts +3 -0
  43. package/dist/capabilities/color.cap.d.ts +21 -0
  44. package/dist/capabilities/composer.cap.d.ts +3 -0
  45. package/dist/capabilities/connectivity.cap.d.ts +12 -0
  46. package/dist/capabilities/consumables.cap.d.ts +4 -0
  47. package/dist/capabilities/contact.cap.d.ts +12 -0
  48. package/dist/capabilities/control.cap.d.ts +15 -0
  49. package/dist/capabilities/core-blocks.cap.d.ts +3 -0
  50. package/dist/capabilities/cover.cap.d.ts +110 -0
  51. package/dist/capabilities/custom-model-registry.cap.d.ts +3 -0
  52. package/dist/capabilities/data-store-provider.cap.d.ts +3 -0
  53. package/dist/capabilities/database-snapshot.cap.d.ts +3 -0
  54. package/dist/capabilities/day-night.cap.d.ts +25 -0
  55. package/dist/capabilities/decoder.cap.d.ts +3 -0
  56. package/dist/capabilities/detection-pipeline.cap.d.ts +4 -0
  57. package/dist/capabilities/device-admin-link.cap.d.ts +4 -0
  58. package/dist/capabilities/device-adoption.cap.d.ts +3 -0
  59. package/dist/capabilities/device-credentials.cap.d.ts +3 -0
  60. package/dist/capabilities/device-export.cap.d.ts +3 -0
  61. package/dist/capabilities/device-extension.cap.d.ts +4 -0
  62. package/dist/capabilities/device-history.cap.d.ts +3 -0
  63. package/dist/capabilities/device-manager.cap.d.ts +3 -0
  64. package/dist/capabilities/device-ops.cap.d.ts +4 -0
  65. package/dist/capabilities/device-provider.cap.d.ts +3 -0
  66. package/dist/capabilities/device-removal-hook.cap.d.ts +3 -0
  67. package/dist/capabilities/device-runs.cap.d.ts +6 -0
  68. package/dist/capabilities/device-state.cap.d.ts +3 -0
  69. package/dist/capabilities/device-status.cap.d.ts +25 -0
  70. package/dist/capabilities/device-transitions.cap.d.ts +4 -0
  71. package/dist/capabilities/dishwasher.cap.d.ts +60 -0
  72. package/dist/capabilities/display-palette.cap.d.ts +3 -0
  73. package/dist/capabilities/do-not-disturb.cap.d.ts +12 -0
  74. package/dist/capabilities/doorbell.cap.d.ts +11 -0
  75. package/dist/capabilities/embedding-encoder.cap.d.ts +3 -0
  76. package/dist/capabilities/enum-sensor.cap.d.ts +10 -0
  77. package/dist/capabilities/event-emitter.cap.d.ts +11 -0
  78. package/dist/capabilities/face-gallery.cap.d.ts +3 -0
  79. package/dist/capabilities/failure-contribution.cap.d.ts +3 -0
  80. package/dist/capabilities/fan-control.cap.d.ts +19 -0
  81. package/dist/capabilities/fan-presets.cap.d.ts +3 -0
  82. package/dist/capabilities/feature-probe.cap.d.ts +5 -0
  83. package/dist/capabilities/filesystem-browse.cap.d.ts +3 -0
  84. package/dist/capabilities/flood.cap.d.ts +12 -0
  85. package/dist/capabilities/gas.cap.d.ts +12 -0
  86. package/dist/capabilities/group-active.cap.d.ts +4 -0
  87. package/dist/capabilities/group-commands.cap.d.ts +4 -0
  88. package/dist/capabilities/group-status.cap.d.ts +23 -0
  89. package/dist/capabilities/heat-pump-control.cap.d.ts +4 -0
  90. package/dist/capabilities/heat-pump-status.cap.d.ts +4 -0
  91. package/dist/capabilities/heating-valve.cap.d.ts +12 -0
  92. package/dist/capabilities/hero-layout.cap.d.ts +3 -0
  93. package/dist/capabilities/humidifier.cap.d.ts +19 -0
  94. package/dist/capabilities/humidity-sensor.cap.d.ts +12 -0
  95. package/dist/capabilities/image-settings.cap.d.ts +4 -0
  96. package/dist/capabilities/image.cap.d.ts +4 -0
  97. package/dist/capabilities/index.d.ts +1 -1
  98. package/dist/capabilities/integration-instances.cap.d.ts +3 -0
  99. package/dist/capabilities/integrations.cap.d.ts +3 -0
  100. package/dist/capabilities/intercom.cap.d.ts +13 -0
  101. package/dist/capabilities/ir-transmitter.cap.d.ts +101 -0
  102. package/dist/capabilities/keychain-admin.cap.d.ts +3 -0
  103. package/dist/capabilities/keychain.cap.d.ts +3 -0
  104. package/dist/capabilities/lawn-mower-control.cap.d.ts +36 -0
  105. package/dist/capabilities/llm-runtime.cap.d.ts +3 -0
  106. package/dist/capabilities/llm.cap.d.ts +3 -0
  107. package/dist/capabilities/load-contribution.cap.d.ts +3 -0
  108. package/dist/capabilities/local-network.cap.d.ts +3 -0
  109. package/dist/capabilities/lock-control.cap.d.ts +35 -0
  110. package/dist/capabilities/log-channels.cap.d.ts +3 -0
  111. package/dist/capabilities/log-destination.cap.d.ts +3 -0
  112. package/dist/capabilities/login-method.cap.d.ts +3 -0
  113. package/dist/capabilities/media-player.cap.d.ts +66 -6
  114. package/dist/capabilities/mesh-network.cap.d.ts +3 -0
  115. package/dist/capabilities/meter.cap.d.ts +11 -0
  116. package/dist/capabilities/metrics-provider.cap.d.ts +3 -0
  117. package/dist/capabilities/migrations.cap.d.ts +3 -0
  118. package/dist/capabilities/model-convert.cap.d.ts +3 -0
  119. package/dist/capabilities/model-distributor.cap.d.ts +3 -0
  120. package/dist/capabilities/motion-detection.cap.d.ts +5 -0
  121. package/dist/capabilities/motion-trigger.cap.d.ts +13 -0
  122. package/dist/capabilities/motion-zones.cap.d.ts +4 -0
  123. package/dist/capabilities/motion.cap.d.ts +13 -0
  124. package/dist/capabilities/mqtt-broker.cap.d.ts +3 -0
  125. package/dist/capabilities/native-object-detection.cap.d.ts +19 -0
  126. package/dist/capabilities/navigation.cap.d.ts +36 -0
  127. package/dist/capabilities/network-access.cap.d.ts +3 -0
  128. package/dist/capabilities/network-link.cap.d.ts +31 -0
  129. package/dist/capabilities/network-quality.cap.d.ts +3 -0
  130. package/dist/capabilities/node-certificates.cap.d.ts +3 -0
  131. package/dist/capabilities/node-removal-hook.cap.d.ts +3 -0
  132. package/dist/capabilities/nodes.cap.d.ts +3 -0
  133. package/dist/capabilities/notification-output.cap.d.ts +3 -0
  134. package/dist/capabilities/notification-rules.cap.d.ts +3 -0
  135. package/dist/capabilities/notifier.cap.d.ts +5 -0
  136. package/dist/capabilities/numeric-sensor.cap.d.ts +11 -0
  137. package/dist/capabilities/oauth-integration.cap.d.ts +3 -0
  138. package/dist/capabilities/osd-manager.cap.d.ts +3 -0
  139. package/dist/capabilities/osd.cap.d.ts +5 -0
  140. package/dist/capabilities/pet-feeder.cap.d.ts +35 -9
  141. package/dist/capabilities/pet-fountain.cap.d.ts +19 -0
  142. package/dist/capabilities/pipeline-analytics.cap.d.ts +35 -0
  143. package/dist/capabilities/pipeline-executor.cap.d.ts +3 -0
  144. package/dist/capabilities/pipeline-orchestrator.cap.d.ts +3 -0
  145. package/dist/capabilities/pipeline-runner.cap.d.ts +3 -0
  146. package/dist/capabilities/plate-gallery.cap.d.ts +3 -0
  147. package/dist/capabilities/platform-probe.cap.d.ts +3 -0
  148. package/dist/capabilities/power-meter.cap.d.ts +33 -0
  149. package/dist/capabilities/power-source.cap.d.ts +12 -0
  150. package/dist/capabilities/presence.cap.d.ts +11 -0
  151. package/dist/capabilities/pressure-sensor.cap.d.ts +12 -0
  152. package/dist/capabilities/privacy-mask.cap.d.ts +19 -0
  153. package/dist/capabilities/ptz-autotrack.cap.d.ts +13 -0
  154. package/dist/capabilities/ptz.cap.d.ts +11 -7
  155. package/dist/capabilities/pump-cycle.cap.d.ts +12 -0
  156. package/dist/capabilities/reboot.cap.d.ts +4 -0
  157. package/dist/capabilities/record-entries.cap.d.ts +3 -0
  158. package/dist/capabilities/recording-archive.cap.d.ts +3 -0
  159. package/dist/capabilities/recording-export.cap.d.ts +3 -0
  160. package/dist/capabilities/recording-onboard.cap.d.ts +12 -0
  161. package/dist/capabilities/recording-signal.cap.d.ts +12 -0
  162. package/dist/capabilities/recording.cap.d.ts +4 -0
  163. package/dist/capabilities/records.cap.d.ts +3 -0
  164. package/dist/capabilities/remote-layout-components.cap.d.ts +3 -0
  165. package/dist/capabilities/remote.cap.d.ts +3 -0
  166. package/dist/capabilities/running-state.cap.d.ts +77 -0
  167. package/dist/capabilities/scene-monitor.cap.d.ts +11 -0
  168. package/dist/capabilities/schedulers.cap.d.ts +3 -0
  169. package/dist/capabilities/script-runner.cap.d.ts +12 -0
  170. package/dist/capabilities/server-management.cap.d.ts +3 -0
  171. package/dist/capabilities/settings-store.cap.d.ts +3 -0
  172. package/dist/capabilities/smoke.cap.d.ts +12 -0
  173. package/dist/capabilities/smtp-provider.cap.d.ts +3 -0
  174. package/dist/capabilities/snapshot.cap.d.ts +4 -0
  175. package/dist/capabilities/sso-bridge.cap.d.ts +3 -0
  176. package/dist/capabilities/storage-admin.cap.d.ts +3 -0
  177. package/dist/capabilities/storage-evictable.cap.d.ts +3 -0
  178. package/dist/capabilities/storage-migration.cap.d.ts +3 -0
  179. package/dist/capabilities/storage-occupancy.cap.d.ts +3 -0
  180. package/dist/capabilities/storage-provider.cap.d.ts +3 -0
  181. package/dist/capabilities/storage.cap.d.ts +3 -0
  182. package/dist/capabilities/stream-broker.cap.d.ts +3 -0
  183. package/dist/capabilities/stream-catalog.cap.d.ts +4 -0
  184. package/dist/capabilities/stream-params.cap.d.ts +4 -0
  185. package/dist/capabilities/stream-signals.cap.d.ts +4 -0
  186. package/dist/capabilities/switch.cap.d.ts +208 -0
  187. package/dist/capabilities/system.cap.d.ts +3 -0
  188. package/dist/capabilities/tamper.cap.d.ts +12 -0
  189. package/dist/capabilities/temperature-sensor.cap.d.ts +12 -0
  190. package/dist/capabilities/template.cap.d.ts +3 -0
  191. package/dist/capabilities/terminal-session.cap.d.ts +3 -0
  192. package/dist/capabilities/timed-run.cap.d.ts +4 -0
  193. package/dist/capabilities/toast.cap.d.ts +3 -0
  194. package/dist/capabilities/training-provider.cap.d.ts +3 -0
  195. package/dist/capabilities/training.cap.d.ts +3 -0
  196. package/dist/capabilities/turn-provider.cap.d.ts +3 -0
  197. package/dist/capabilities/update.cap.d.ts +19 -0
  198. package/dist/capabilities/user-management.cap.d.ts +3 -0
  199. package/dist/capabilities/user-passkeys.cap.d.ts +3 -0
  200. package/dist/capabilities/vacuum-control.cap.d.ts +43 -0
  201. package/dist/capabilities/valve.cap.d.ts +38 -0
  202. package/dist/capabilities/vector-store.cap.d.ts +3 -0
  203. package/dist/capabilities/vibration.cap.d.ts +12 -0
  204. package/dist/capabilities/videoclips.cap.d.ts +4 -0
  205. package/dist/capabilities/viewer-ui.cap.d.ts +3 -0
  206. package/dist/capabilities/water-heater.cap.d.ts +33 -4
  207. package/dist/capabilities/weather.cap.d.ts +39 -0
  208. package/dist/capabilities/webrtc-session.cap.d.ts +4 -0
  209. package/dist/capabilities/zone-analytics.cap.d.ts +11 -0
  210. package/dist/capabilities/zone-rules.cap.d.ts +4 -0
  211. package/dist/capabilities/zones.cap.d.ts +4 -0
  212. package/dist/client.js +178 -29
  213. package/dist/client.mjs +178 -29
  214. package/dist/device/cap-vocabulary/declaration.d.ts +107 -0
  215. package/dist/device/cap-vocabulary/index.d.ts +4 -2
  216. package/dist/device/cap-vocabulary/system-reasons.d.ts +17 -0
  217. package/dist/device/cap-vocabulary/types.d.ts +24 -6
  218. package/dist/device/cap-vocabulary/vocabulary.d.ts +15 -3
  219. package/dist/generated/addon-api.d.ts +52 -52
  220. package/dist/generated/addon-cap-facts.d.ts +1 -1
  221. package/dist/generated/cap-vocabulary.d.ts +7 -0
  222. package/dist/generated/device-local-state.d.ts +3 -0
  223. package/dist/generated/device-proxy.d.ts +1 -0
  224. package/dist/generated/history-catalog.d.ts +1 -1
  225. package/dist/generated/runtime-state-durability.d.ts +1 -1
  226. package/dist/i18n/translation.d.ts +3 -2
  227. package/dist/index.d.ts +2 -2
  228. package/dist/index.js +5245 -600
  229. package/dist/index.mjs +5239 -601
  230. package/dist/interfaces/config-ui.d.ts +2 -0
  231. package/dist/{sleep-BvVGLl30.mjs → sleep-C9PbO6Nb.mjs} +5669 -1691
  232. package/dist/{sleep-CyWfD1LJ.js → sleep-CcUFeK6k.js} +5674 -1690
  233. package/package.json +1 -1
  234. package/dist/device/cap-vocabulary/entries/actuators.d.ts +0 -5
  235. package/dist/device/cap-vocabulary/entries/appliances.d.ts +0 -5
  236. package/dist/device/cap-vocabulary/entries/camera.d.ts +0 -5
  237. package/dist/device/cap-vocabulary/entries/heat-pump.d.ts +0 -4
  238. package/dist/device/cap-vocabulary/entries/sensors.d.ts +0 -5
  239. package/dist/device/cap-vocabulary/entries/system.d.ts +0 -8
package/dist/client.mjs CHANGED
@@ -140,6 +140,8 @@ function method(input, output, options) {
140
140
  ...options?.access !== void 0 ? { access: options.access } : {},
141
141
  ...options?.role !== void 0 ? { role: options.role } : {},
142
142
  ...options?.caller !== void 0 ? { caller: options.caller } : {},
143
+ ...options?.actions !== void 0 ? { actions: options.actions } : {},
144
+ ...options?.notOperatorFacing !== void 0 ? { notOperatorFacing: options.notOperatorFacing } : {},
143
145
  timeoutMs: options?.timeoutMs
144
146
  };
145
147
  }
@@ -593,6 +595,25 @@ var PeerBytesTicketSchema = z.object({
593
595
  declaredBytes: z.number().int().nonnegative().nullable()
594
596
  });
595
597
  //#endregion
598
+ //#region src/device/cap-vocabulary/system-reasons.ts
599
+ /**
600
+ * Why a system-scoped cap is never part of a device's vocabulary (D920): the
601
+ * reasons several caps share, named once. A cap's `vocabulary` block cites
602
+ * one (`vocabulary: { notOperatorFacing: NOT_A_DEVICE.STORAGE }`) or states
603
+ * its own.
604
+ */
605
+ var NOT_A_DEVICE = {
606
+ UI_PLUMBING: "admin UI plumbing — pages, widgets and routes, not something a device does",
607
+ ADDON_ADMIN: "addon administration — installed and configured from the Addons page",
608
+ PIPELINE: "detection pipeline machinery — tuned on the pipeline pages, never actuated per device",
609
+ STORAGE: "storage administration — locations, retention and migrations, not a device action",
610
+ IDENTITY: "identity and access administration — users, sign-in and secrets",
611
+ NETWORK: "network administration of the cluster — addresses, mesh, tunnels",
612
+ CLUSTER: "cluster administration — nodes, server package, metrics",
613
+ ML: "model and training machinery — no device action",
614
+ INTERNAL: "internal plumbing between addons — never operator-facing"
615
+ };
616
+ //#endregion
596
617
  //#region src/retrain-review.ts
597
618
  /** Every status, in the order a summary lists them. */
598
619
  var RETRAIN_REVIEW_STATUSES = [
@@ -1599,15 +1620,6 @@ z.object({
1599
1620
  app: AppLoginPathSchema.nullable()
1600
1621
  });
1601
1622
  //#endregion
1602
- //#region src/device/cap-vocabulary/l10n.ts
1603
- /** A string in English and Italian. */
1604
- function t(en, it) {
1605
- return {
1606
- en,
1607
- it
1608
- };
1609
- }
1610
- //#endregion
1611
1623
  //#region src/device/icon-catalog.generated.ts
1612
1624
  /** Lucide category ids, alphabetical. `ICON_META` indexes into this. */
1613
1625
  var ICON_CATEGORY_IDS = [
@@ -21752,6 +21764,15 @@ var COCO_TO_MACRO = {
21752
21764
  preserveOriginal: false
21753
21765
  };
21754
21766
  //#endregion
21767
+ //#region src/device/cap-vocabulary/l10n.ts
21768
+ /** A string in English and Italian. */
21769
+ function t(en, it) {
21770
+ return {
21771
+ en,
21772
+ it
21773
+ };
21774
+ }
21775
+ //#endregion
21755
21776
  //#region src/capabilities/alarm-panel.cap.ts
21756
21777
  /**
21757
21778
  * Alarm-panel cap. Models HA `alarm_control_panel.*` on
@@ -21809,24 +21830,151 @@ z.object({
21809
21830
  /** Ms epoch when the slice was last updated. */
21810
21831
  lastChangedAt: z.number()
21811
21832
  });
21812
- DeviceType.AlarmPanel, method(z.object({
21833
+ DeviceType.AlarmPanel, method(z.object({ deviceId: z.number().int().nonnegative() }), z.void(), {
21834
+ kind: "mutation",
21835
+ auth: "protected",
21836
+ actions: [{
21837
+ id: "alarm.trigger",
21838
+ label: t("Trigger alarm", "Fai scattare l’allarme"),
21839
+ phrase: t("Trigger the alarm on {device}", "Fai scattare l’allarme su {device}"),
21840
+ icon: "siren"
21841
+ }]
21842
+ }), method(z.object({
21813
21843
  deviceId: z.number().int().nonnegative(),
21814
- mode: AlarmArmModeSchema,
21815
- /** Optional PIN code. Required when `requiresCode === true`.
21816
- * Passed through to the upstream service; never persisted. */
21817
21844
  code: z.string().min(1).optional()
21818
21845
  }), z.void(), {
21819
21846
  kind: "mutation",
21820
- auth: "protected"
21847
+ auth: "protected",
21848
+ actions: [{
21849
+ id: "alarm.disarm",
21850
+ label: t("Disarm", "Disinserisci"),
21851
+ phrase: t("Disarm {device}", "Disinserisci {device}"),
21852
+ icon: "shield-off",
21853
+ effect: {
21854
+ field: "state",
21855
+ value: "disarmed"
21856
+ },
21857
+ openArgs: [{
21858
+ key: "code",
21859
+ label: t("PIN code", "Codice PIN"),
21860
+ offer: {
21861
+ kind: "text",
21862
+ secret: true
21863
+ },
21864
+ optional: true
21865
+ }]
21866
+ }]
21821
21867
  }), method(z.object({
21822
21868
  deviceId: z.number().int().nonnegative(),
21869
+ mode: AlarmArmModeSchema,
21870
+ /** Optional PIN code. Required when `requiresCode === true`.
21871
+ * Passed through to the upstream service; never persisted. */
21823
21872
  code: z.string().min(1).optional()
21824
21873
  }), z.void(), {
21825
21874
  kind: "mutation",
21826
- auth: "protected"
21827
- }), method(z.object({ deviceId: z.number().int().nonnegative() }), z.void(), {
21828
- kind: "mutation",
21829
- auth: "protected"
21875
+ auth: "protected",
21876
+ actions: [
21877
+ {
21878
+ id: "alarm.arm.home",
21879
+ label: t("Arm home", "Inserisci in casa"),
21880
+ phrase: t("Arm {device} for home", "Inserisci {device} in modalità casa"),
21881
+ icon: "house",
21882
+ effect: {
21883
+ field: "state",
21884
+ value: "armed_home"
21885
+ },
21886
+ args: { mode: "home" },
21887
+ openArgs: [{
21888
+ key: "code",
21889
+ label: t("PIN code", "Codice PIN"),
21890
+ offer: {
21891
+ kind: "text",
21892
+ secret: true
21893
+ },
21894
+ optional: true
21895
+ }]
21896
+ },
21897
+ {
21898
+ id: "alarm.arm.away",
21899
+ label: t("Arm away", "Inserisci fuori casa"),
21900
+ phrase: t("Arm {device} for away", "Inserisci {device} in modalità fuori casa"),
21901
+ icon: "shield-check",
21902
+ effect: {
21903
+ field: "state",
21904
+ value: "armed_away"
21905
+ },
21906
+ args: { mode: "away" },
21907
+ openArgs: [{
21908
+ key: "code",
21909
+ label: t("PIN code", "Codice PIN"),
21910
+ offer: {
21911
+ kind: "text",
21912
+ secret: true
21913
+ },
21914
+ optional: true
21915
+ }]
21916
+ },
21917
+ {
21918
+ id: "alarm.arm.night",
21919
+ label: t("Arm night", "Inserisci notte"),
21920
+ phrase: t("Arm {device} for the night", "Inserisci {device} in modalità notte"),
21921
+ icon: "moon",
21922
+ effect: {
21923
+ field: "state",
21924
+ value: "armed_night"
21925
+ },
21926
+ args: { mode: "night" },
21927
+ openArgs: [{
21928
+ key: "code",
21929
+ label: t("PIN code", "Codice PIN"),
21930
+ offer: {
21931
+ kind: "text",
21932
+ secret: true
21933
+ },
21934
+ optional: true
21935
+ }]
21936
+ },
21937
+ {
21938
+ id: "alarm.arm.vacation",
21939
+ label: t("Arm vacation", "Inserisci vacanza"),
21940
+ phrase: t("Arm {device} for vacation", "Inserisci {device} in modalità vacanza"),
21941
+ icon: "plane",
21942
+ effect: {
21943
+ field: "state",
21944
+ value: "armed_vacation"
21945
+ },
21946
+ args: { mode: "vacation" },
21947
+ openArgs: [{
21948
+ key: "code",
21949
+ label: t("PIN code", "Codice PIN"),
21950
+ offer: {
21951
+ kind: "text",
21952
+ secret: true
21953
+ },
21954
+ optional: true
21955
+ }]
21956
+ },
21957
+ {
21958
+ id: "alarm.arm.custom_bypass",
21959
+ label: t("Arm custom bypass", "Inserisci con esclusioni"),
21960
+ phrase: t("Arm {device} with its custom bypass", "Inserisci {device} con le zone escluse"),
21961
+ icon: "shield-half",
21962
+ effect: {
21963
+ field: "state",
21964
+ value: "armed_custom_bypass"
21965
+ },
21966
+ args: { mode: "custom_bypass" },
21967
+ openArgs: [{
21968
+ key: "code",
21969
+ label: t("PIN code", "Codice PIN"),
21970
+ offer: {
21971
+ kind: "text",
21972
+ secret: true
21973
+ },
21974
+ optional: true
21975
+ }]
21976
+ }
21977
+ ]
21830
21978
  });
21831
21979
  //#endregion
21832
21980
  //#region src/remote/remote-roles.ts
@@ -22558,7 +22706,7 @@ method(z.void(), z.array(TopologyNodeSchema).readonly(), { auth: "admin" }), met
22558
22706
  }), z.unknown(), {
22559
22707
  kind: "mutation",
22560
22708
  auth: "admin"
22561
- });
22709
+ }), NOT_A_DEVICE.CLUSTER;
22562
22710
  //#endregion
22563
22711
  //#region src/catalogs/audio-classmap.ts
22564
22712
  var AUDIO_MACRO_LABELS = [
@@ -27368,9 +27516,9 @@ function createDeviceProxy(api, binding, opts) {
27368
27516
  };
27369
27517
  const airQualitySensorInterface = { getStatus: (input) => dispatch("air-quality-sensor", "airQualitySensor", "getStatus", "query", input) };
27370
27518
  const alarmPanelInterface = {
27371
- arm: (input) => dispatch("alarm-panel", "alarmPanel", "arm", "mutation", input),
27372
- disarm: (input) => dispatch("alarm-panel", "alarmPanel", "disarm", "mutation", input),
27373
27519
  trigger: (input) => dispatch("alarm-panel", "alarmPanel", "trigger", "mutation", input),
27520
+ disarm: (input) => dispatch("alarm-panel", "alarmPanel", "disarm", "mutation", input),
27521
+ arm: (input) => dispatch("alarm-panel", "alarmPanel", "arm", "mutation", input),
27374
27522
  getStatus: (input) => dispatch("alarm-panel", "alarmPanel", "getStatus", "query", input)
27375
27523
  };
27376
27524
  const ambientLightSensorInterface = { getStatus: (input) => dispatch("ambient-light-sensor", "ambientLightSensor", "getStatus", "query", input) };
@@ -27426,11 +27574,11 @@ function createDeviceProxy(api, binding, opts) {
27426
27574
  const carbonMonoxideInterface = { getStatus: (input) => dispatch("carbon-monoxide", "carbonMonoxide", "getStatus", "query", input) };
27427
27575
  const climateControlInterface = {
27428
27576
  setMode: (input) => dispatch("climate-control", "climateControl", "setMode", "mutation", input),
27429
- setFanMode: (input) => dispatch("climate-control", "climateControl", "setFanMode", "mutation", input),
27430
- setPreset: (input) => dispatch("climate-control", "climateControl", "setPreset", "mutation", input),
27431
27577
  setTarget: (input) => dispatch("climate-control", "climateControl", "setTarget", "mutation", input),
27432
27578
  setTargetRange: (input) => dispatch("climate-control", "climateControl", "setTargetRange", "mutation", input),
27433
27579
  setTargetHumidity: (input) => dispatch("climate-control", "climateControl", "setTargetHumidity", "mutation", input),
27580
+ setFanMode: (input) => dispatch("climate-control", "climateControl", "setFanMode", "mutation", input),
27581
+ setPreset: (input) => dispatch("climate-control", "climateControl", "setPreset", "mutation", input),
27434
27582
  setSwingVertical: (input) => dispatch("climate-control", "climateControl", "setSwingVertical", "mutation", input),
27435
27583
  setSwingHorizontal: (input) => dispatch("climate-control", "climateControl", "setSwingHorizontal", "mutation", input),
27436
27584
  getStatus: (input) => dispatch("climate-control", "climateControl", "getStatus", "query", input)
@@ -27603,12 +27751,12 @@ function createDeviceProxy(api, binding, opts) {
27603
27751
  stop: (input) => dispatch("media-player", "mediaPlayer", "stop", "mutation", input),
27604
27752
  next: (input) => dispatch("media-player", "mediaPlayer", "next", "mutation", input),
27605
27753
  previous: (input) => dispatch("media-player", "mediaPlayer", "previous", "mutation", input),
27606
- seek: (input) => dispatch("media-player", "mediaPlayer", "seek", "mutation", input),
27607
27754
  setVolume: (input) => dispatch("media-player", "mediaPlayer", "setVolume", "mutation", input),
27608
27755
  setMute: (input) => dispatch("media-player", "mediaPlayer", "setMute", "mutation", input),
27609
27756
  setShuffle: (input) => dispatch("media-player", "mediaPlayer", "setShuffle", "mutation", input),
27610
27757
  setRepeat: (input) => dispatch("media-player", "mediaPlayer", "setRepeat", "mutation", input),
27611
27758
  selectSource: (input) => dispatch("media-player", "mediaPlayer", "selectSource", "mutation", input),
27759
+ seek: (input) => dispatch("media-player", "mediaPlayer", "seek", "mutation", input),
27612
27760
  playMedia: (input) => dispatch("media-player", "mediaPlayer", "playMedia", "mutation", input),
27613
27761
  getStatus: (input) => dispatch("media-player", "mediaPlayer", "getStatus", "query", input)
27614
27762
  };
@@ -27667,10 +27815,10 @@ function createDeviceProxy(api, binding, opts) {
27667
27815
  const petFeederInterface = {
27668
27816
  feed: (input) => dispatch("pet-feeder", "petFeeder", "feed", "mutation", input),
27669
27817
  cancelFeed: (input) => dispatch("pet-feeder", "petFeeder", "cancelFeed", "mutation", input),
27670
- resetDesiccant: (input) => dispatch("pet-feeder", "petFeeder", "resetDesiccant", "mutation", input),
27671
- markFoodReplenished: (input) => dispatch("pet-feeder", "petFeeder", "markFoodReplenished", "mutation", input),
27672
27818
  callPet: (input) => dispatch("pet-feeder", "petFeeder", "callPet", "mutation", input),
27673
27819
  playSound: (input) => dispatch("pet-feeder", "petFeeder", "playSound", "mutation", input),
27820
+ resetDesiccant: (input) => dispatch("pet-feeder", "petFeeder", "resetDesiccant", "mutation", input),
27821
+ markFoodReplenished: (input) => dispatch("pet-feeder", "petFeeder", "markFoodReplenished", "mutation", input),
27674
27822
  setChildLock: (input) => dispatch("pet-feeder", "petFeeder", "setChildLock", "mutation", input),
27675
27823
  setIndicatorLight: (input) => dispatch("pet-feeder", "petFeeder", "setIndicatorLight", "mutation", input),
27676
27824
  setFeedSound: (input) => dispatch("pet-feeder", "petFeeder", "setFeedSound", "mutation", input),
@@ -27790,13 +27938,13 @@ function createDeviceProxy(api, binding, opts) {
27790
27938
  const ptzInterface = {
27791
27939
  move: (input) => dispatch("ptz", "ptz", "move", "mutation", input),
27792
27940
  continuousMove: (input) => dispatch("ptz", "ptz", "continuousMove", "mutation", input),
27793
- stop: (input) => dispatch("ptz", "ptz", "stop", "mutation", input),
27941
+ goHome: (input) => dispatch("ptz", "ptz", "goHome", "mutation", input),
27794
27942
  getPresets: (input) => dispatch("ptz", "ptz", "getPresets", "query", input),
27795
27943
  goToPreset: (input) => dispatch("ptz", "ptz", "goToPreset", "mutation", input),
27796
27944
  savePreset: (input) => dispatch("ptz", "ptz", "savePreset", "mutation", input),
27797
27945
  deletePreset: (input) => dispatch("ptz", "ptz", "deletePreset", "mutation", input),
27798
27946
  getOptions: (input) => dispatch("ptz", "ptz", "getOptions", "query", input),
27799
- goHome: (input) => dispatch("ptz", "ptz", "goHome", "mutation", input),
27947
+ stop: (input) => dispatch("ptz", "ptz", "stop", "mutation", input),
27800
27948
  getHomePreset: (input) => dispatch("ptz", "ptz", "getHomePreset", "query", input),
27801
27949
  setHomePreset: (input) => dispatch("ptz", "ptz", "setHomePreset", "mutation", input),
27802
27950
  captureHomeHere: (input) => dispatch("ptz", "ptz", "captureHomeHere", "mutation", input),
@@ -27914,9 +28062,9 @@ function createDeviceProxy(api, binding, opts) {
27914
28062
  getPlaybackOptions: (input) => dispatch("videoclips", "videoclips", "getPlaybackOptions", "query", input)
27915
28063
  };
27916
28064
  const waterHeaterInterface = {
27917
- setTargetTemp: (input) => dispatch("water-heater", "waterHeater", "setTargetTemp", "mutation", input),
27918
28065
  setOperationMode: (input) => dispatch("water-heater", "waterHeater", "setOperationMode", "mutation", input),
27919
28066
  setAway: (input) => dispatch("water-heater", "waterHeater", "setAway", "mutation", input),
28067
+ setTargetTemp: (input) => dispatch("water-heater", "waterHeater", "setTargetTemp", "mutation", input),
27920
28068
  getStatus: (input) => dispatch("water-heater", "waterHeater", "getStatus", "query", input)
27921
28069
  };
27922
28070
  const weatherInterface = { getStatus: (input) => dispatch("weather", "weather", "getStatus", "query", input) };
@@ -28160,6 +28308,7 @@ function createDeviceProxy(api, binding, opts) {
28160
28308
  image: createSliceHandle(stateSource, binding.deviceId, "image"),
28161
28309
  imageSettings: createSliceHandle(stateSource, binding.deviceId, "image-settings"),
28162
28310
  intercom: createSliceHandle(stateSource, binding.deviceId, "intercom"),
28311
+ irTransmitter: createSliceHandle(stateSource, binding.deviceId, "ir-transmitter"),
28163
28312
  lawnMowerControl: createSliceHandle(stateSource, binding.deviceId, "lawn-mower-control"),
28164
28313
  lockControl: createSliceHandle(stateSource, binding.deviceId, "lock-control"),
28165
28314
  mediaPlayer: createSliceHandle(stateSource, binding.deviceId, "media-player"),
@@ -0,0 +1,107 @@
1
+ /**
2
+ * How a capability DECLARES its vocabulary in its own `*.cap.ts` (D1050). The
3
+ * cap vocabulary (D920) is generated from these declarations by
4
+ * `npm run codegen` into `generated/cap-vocabulary.ts`; nothing hand-writes an
5
+ * entry of the map any more (`scripts/check-no-handwritten-cap-vocabulary.ts`).
6
+ *
7
+ * Three places, each next to what it phrases:
8
+ *
9
+ * - an ACTION is declared on the method it calls — `method(input, output,
10
+ * { kind: 'mutation', actions: [...] })`, typed against that method's Zod
11
+ * input (fixed `args` and `openArgs` keys) — and a mutation that must never
12
+ * become a step says why with `notOperatorFacing` there. A method with
13
+ * neither is refused by `check-cap-vocabulary`: no mutation is offered by
14
+ * default.
15
+ * - an EVENT's trigger wording (or its excuse) sits on the event declaration.
16
+ * - the rest — the cap's noun, its state triggers, wording overrides by device
17
+ * type or role, bus events with no declared cap event, and the picker order —
18
+ * is the cap's `vocabulary` block. A system-scoped cap's block is only the
19
+ * reason it is never a device's vocabulary.
20
+ *
21
+ * These shapes are string-keyed: a status field, a dynamic-offer method or an
22
+ * effect field cannot be named by its cap's TYPE inside the very object that
23
+ * defines the cap. The generated map is typed `CapVocabularyMap`, which checks
24
+ * every one of those names against the cap definition, and
25
+ * `check-cap-vocabulary` checks values against the Zod schemas.
26
+ */
27
+ import type { L10n, LooseVocabEffect, LooseVocabOffer, LooseVocabOverrides, LooseVocabStateTrigger, VocabEffectValue, VocabEventTrigger, VocabIcon } from './types.js';
28
+ /** The operator-supplied keys of a method input (`deviceId` is the target). */
29
+ export type MethodActionArgs<TInput> = TInput extends object ? Omit<TInput, 'deviceId'> : Record<never, never>;
30
+ /** An open arg of a method action, keyed by the method's own input. */
31
+ export interface MethodActionOpenArg<TKey extends string = string> {
32
+ readonly key: TKey;
33
+ readonly label: L10n;
34
+ readonly offer: LooseVocabOffer;
35
+ /** The method accepts the call without it. */
36
+ readonly optional?: boolean;
37
+ }
38
+ /** The state a method action leads to (D983) — see `VocabEffectFor`. */
39
+ export type MethodActionEffect<TKey extends string = string> = {
40
+ readonly field: string;
41
+ readonly value: VocabEffectValue;
42
+ } | {
43
+ readonly field: string;
44
+ readonly fromArg: TKey;
45
+ };
46
+ /**
47
+ * One operator-facing action declared on the method it calls. `TInput` is the
48
+ * method's Zod input; the action's `method` is the key the method is declared
49
+ * under, filled in by codegen.
50
+ */
51
+ export interface MethodActionDecl<TInput = Readonly<Record<string, unknown>>> {
52
+ /** Stable id — persisted by steps as their `actionId` (`switch.on`). */
53
+ readonly id: string;
54
+ /** Short label for a picker ("Turn on"). */
55
+ readonly label: L10n;
56
+ /** The sentence ("Turn on {device}"); placeholders are `{device}` and arg keys. */
57
+ readonly phrase: L10n;
58
+ readonly icon: VocabIcon;
59
+ /** Args baked into the action — never asked. */
60
+ readonly args?: Partial<MethodActionArgs<TInput>>;
61
+ /** Args the operator fills. */
62
+ readonly openArgs?: readonly MethodActionOpenArg<keyof MethodActionArgs<TInput> & string>[];
63
+ /** The state this action leads to, when it is one. */
64
+ readonly effect?: MethodActionEffect<keyof MethodActionArgs<TInput> & string>;
65
+ }
66
+ /** A method action as codegen reads it off a method schema, string-keyed. */
67
+ export interface LooseMethodActionDecl {
68
+ readonly id: string;
69
+ readonly label: L10n;
70
+ readonly phrase: L10n;
71
+ readonly icon: VocabIcon;
72
+ readonly args?: Readonly<Record<string, unknown>>;
73
+ readonly openArgs?: readonly MethodActionOpenArg[];
74
+ readonly effect?: LooseVocabEffect;
75
+ }
76
+ /** What a declared cap event is to an automation: a trigger, or an excuse. */
77
+ export type EventVocabularyDecl = {
78
+ readonly trigger: VocabEventTrigger;
79
+ readonly notOperatorFacing?: undefined;
80
+ } | {
81
+ readonly notOperatorFacing: string;
82
+ readonly trigger?: undefined;
83
+ };
84
+ /** The `vocabulary` block of a device-scoped cap. */
85
+ export interface DeviceCapVocabularyDecl {
86
+ /** What the cap is, for grouping ("Switch" / "Interruttore"). */
87
+ readonly noun: L10n;
88
+ /**
89
+ * Where the cap's actions and triggers sit among a device's caps in a
90
+ * picker — lower first. Caps of one family share a thousand
91
+ * (actuators 1xxx, appliances 2xxx, camera 3xxx, heat pump 4xxx, sensors 5xxx).
92
+ */
93
+ readonly order: number;
94
+ readonly state?: readonly LooseVocabStateTrigger[];
95
+ /** Bus events the cap's devices emit with no declared cap event behind them. */
96
+ readonly extraEvents?: readonly VocabEventTrigger[];
97
+ /** Wording that differs for a device type or role (a switch that is a siren). */
98
+ readonly overrides?: LooseVocabOverrides;
99
+ readonly notOperatorFacing?: undefined;
100
+ }
101
+ /** The `vocabulary` block of a system-scoped cap: why it is no device's vocabulary. */
102
+ export interface SystemCapVocabularyDecl {
103
+ readonly notOperatorFacing: string;
104
+ readonly noun?: undefined;
105
+ }
106
+ /** A cap's `vocabulary` block. */
107
+ export type CapVocabularyDecl = DeviceCapVocabularyDecl | SystemCapVocabularyDecl;
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * The cap vocabulary (D920) — what every capability lets an operator DO to a
3
- * device and WATCH it for, in one cap-keyed map outside the caps.
3
+ * device and WATCH it for, in one cap-keyed map generated from the caps (D1050).
4
4
  */
5
5
  export type { ResolvedBooleanTrigger, ResolvedEnumTrigger, ResolvedEnumValue, ResolvedEventTrigger, ResolvedNumericTrigger, ResolvedValueTrigger, ResolvedVocabAction, ResolvedVocabTrigger, VocabBindingsInput, } from './resolve.js';
6
6
  export { actionsForDevice, renderVocabPhrase, triggersForDevice, } from './resolve.js';
@@ -9,5 +9,7 @@ export { actionEffect, allVocabActions, assertDeviceOffers, findVocabAction, Voc
9
9
  export type { CommandEffect } from './command-catalog.js';
10
10
  export { auditedFields, commandEffect, isCommand } from './command-catalog.js';
11
11
  export { VOCAB_TEMPLATES } from './templates.js';
12
- export type { ActionArgKey, ActionArgs, BooleanOffer, CapEventName, CapMethodName, CapStatusField, CapVocabularyEntry, CapVocabularyMap, CapVocabularySlice, DeviceCapVocabulary, DeviceVocabCapName, DynamicOffer, EnumOffer, EnumStateValue, L10n, LooseCapVocabularyEntry, LooseDynamicOffer, LooseVocabAction, LooseVocabEffect, LooseVocabOffer, LooseVocabOpenArg, LooseVocabStateTrigger, NumberOffer, SystemCapVocabulary, SystemVocabCapName, TextOffer, VocabAction, VocabCapName, VocabChoice, VocabEffectFor, VocabEffectValue, VocabEventTrigger, VocabIcon, VocabLocale, VocabOffer, VocabOpenArg, VocabStateTrigger, } from './types.js';
12
+ export type { ActionArgKey, ActionArgs, BooleanOffer, CapEventName, CapMethodName, CapStatusField, CapVocabularyEntry, CapVocabularyMap, DeviceCapVocabulary, DeviceVocabCapName, DynamicOffer, EnumOffer, EnumStateValue, L10n, LooseCapVocabularyEntry, LooseDynamicOffer, LooseVocabAction, LooseVocabEffect, LooseVocabOffer, LooseVocabOpenArg, LooseVocabStateTrigger, NumberOffer, SystemCapVocabulary, SystemVocabCapName, TextOffer, VocabAction, VocabCapName, VocabChoice, VocabEffectFor, VocabEffectValue, VocabEventTrigger, VocabIcon, VocabLocale, VocabOffer, VocabOpenArg, VocabStateTrigger, } from './types.js';
13
13
  export { CAP_VOCABULARY, CAP_VOCABULARY_BY_NAME } from './vocabulary.js';
14
+ export type { CapVocabularyDecl, DeviceCapVocabularyDecl, EventVocabularyDecl, LooseMethodActionDecl, MethodActionArgs, MethodActionDecl, MethodActionEffect, MethodActionOpenArg, SystemCapVocabularyDecl, } from './declaration.js';
15
+ export { NOT_A_DEVICE } from './system-reasons.js';
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Why a system-scoped cap is never part of a device's vocabulary (D920): the
3
+ * reasons several caps share, named once. A cap's `vocabulary` block cites
4
+ * one (`vocabulary: { notOperatorFacing: NOT_A_DEVICE.STORAGE }`) or states
5
+ * its own.
6
+ */
7
+ export declare const NOT_A_DEVICE: {
8
+ readonly UI_PLUMBING: 'admin UI plumbing — pages, widgets and routes, not something a device does';
9
+ readonly ADDON_ADMIN: 'addon administration — installed and configured from the Addons page';
10
+ readonly PIPELINE: 'detection pipeline machinery — tuned on the pipeline pages, never actuated per device';
11
+ readonly STORAGE: 'storage administration — locations, retention and migrations, not a device action';
12
+ readonly IDENTITY: 'identity and access administration — users, sign-in and secrets';
13
+ readonly NETWORK: 'network administration of the cluster — addresses, mesh, tunnels';
14
+ readonly CLUSTER: 'cluster administration — nodes, server package, metrics';
15
+ readonly ML: 'model and training machinery — no device action';
16
+ readonly INTERNAL: 'internal plumbing between addons — never operator-facing';
17
+ };
@@ -109,7 +109,8 @@ export interface BooleanOffer {
109
109
  readonly kind: 'boolean';
110
110
  }
111
111
  /**
112
- * Values the DEVICE knows, read at authoring time from the same cap:
112
+ * Values the DEVICE knows, read at authoring time from the same cap (or, for a
113
+ * status list, a sibling cap of the same device — {@link SiblingStatusOffer}):
113
114
  * a status field holding a list, or a read method returning one.
114
115
  * `valueKey` / `labelKey` pick the fields of an object item (omit both for a
115
116
  * list of strings); `where` keeps only items whose field equals a value.
@@ -137,7 +138,26 @@ export type DynamicOffer<C extends VocabCapName> = {
137
138
  readonly equals: string | number | boolean;
138
139
  };
139
140
  readonly valueKind?: 'string' | 'number';
140
- };
141
+ } | SiblingStatusOffer;
142
+ /**
143
+ * Values read from the status of ANOTHER cap the same device binds (D1050):
144
+ * `heat-pump-control.setCircuitComfortSetpoint` offers the circuits that
145
+ * `heat-pump-status` reports. `field` is a status field of `cap`, checked by
146
+ * `scripts/check-cap-vocabulary.ts`.
147
+ */
148
+ export interface SiblingStatusOffer {
149
+ readonly kind: 'dynamic';
150
+ readonly from: 'status';
151
+ readonly cap: DeviceVocabCapName;
152
+ readonly field: string;
153
+ readonly valueKey?: string;
154
+ readonly labelKey?: string;
155
+ readonly where?: {
156
+ readonly key: string;
157
+ readonly equals: string | number | boolean;
158
+ };
159
+ readonly valueKind?: 'string' | 'number';
160
+ }
141
161
  /** How the authoring UI offers a value for an open arg. */
142
162
  export type VocabOffer<C extends VocabCapName> = EnumOffer | NumberOffer | TextOffer | BooleanOffer | DynamicOffer<C>;
143
163
  /** An arg the operator fills after picking the action. */
@@ -324,14 +344,12 @@ export type CapVocabularyEntry<C extends VocabCapName> = CapDef<C>['scope'] exte
324
344
  export type CapVocabularyMap = {
325
345
  readonly [C in VocabCapName]: CapVocabularyEntry<C>;
326
346
  };
327
- /** A slice of the map, for files that hold a family of caps. */
328
- export type CapVocabularySlice<K extends VocabCapName> = {
329
- readonly [C in K]: CapVocabularyEntry<C>;
330
- };
331
347
  /** A dynamic offer with no cap-specific key type. */
332
348
  export type LooseDynamicOffer = {
333
349
  readonly kind: 'dynamic';
334
350
  readonly from: 'status';
351
+ /** A sibling cap of the same device whose status holds the list; absent = this cap. */
352
+ readonly cap?: string;
335
353
  readonly field: string;
336
354
  readonly valueKey?: string;
337
355
  readonly labelKey?: string;
@@ -1,5 +1,17 @@
1
- import type { CapVocabularyMap, LooseCapVocabularyEntry } from './types.js';
2
- /** Every capability's vocabulary, keyed by cap name. */
3
- export declare const CAP_VOCABULARY: CapVocabularyMap;
1
+ /**
2
+ * THE cap vocabulary (D920): one complete, cap-keyed map of what every
3
+ * capability lets an operator DO to a device and WATCH it for — so a picker,
4
+ * a script editor and a phrase renderer all read one map.
5
+ *
6
+ * Declared on the caps, generated here (D1050): an action sits on the method
7
+ * it calls, an event's wording on the event, the rest in the cap's
8
+ * `vocabulary` block (`declaration.ts`); `npm run codegen` projects them into
9
+ * `generated/cap-vocabulary.ts`, typed {@link CapVocabularyMap} — a cap with
10
+ * no entry, or a name its cap does not have, is a TypeScript error there.
11
+ * Nothing hand-writes an entry (`scripts/check-no-handwritten-cap-vocabulary.ts`).
12
+ */
13
+ import { CAP_VOCABULARY } from '../../generated/cap-vocabulary.js';
14
+ import type { LooseCapVocabularyEntry } from './types.js';
15
+ export { CAP_VOCABULARY };
4
16
  /** The same map, read by a string cap name (a binding names caps as strings). */
5
17
  export declare const CAP_VOCABULARY_BY_NAME: Readonly<Record<string, LooseCapVocabularyEntry>>;