@camstack/types 1.2.248 → 1.2.249

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-9gM_dS-5.js");
+const require_sleep = require("./sleep-CvwUEq16.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_canonical_hash = require("./canonical-hash-CSE4ioRi.js");
 const require_enums = require("./enums.js");
@@ -16654,6 +16654,7 @@ sub("presence", "sensor", "sensor", "#22c55e", "presence", "Presence");
 sub("enum-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "generic", "Sensor state");
 sub("device-event", "sensor", "sensor", "#10b981", "button", "Device event");
 sub("lock", "control", "control", "#0ea5e9", "lock", "Lock");
+sub("cover", "control", "control", "#0ea5e9", "door", "Cover");
 sub("switch", "control", "control", TAXONOMY_COLORS.control, "switch", "Switch");
 sub("siren", "control", "control", "#dc2626", "siren", "Siren");
 sub("button", "control", "control", "#10b981", "button", "Button");
@@ -16998,6 +16999,10 @@ var NcSystemEventKindSchema = zod.z.enum([
 	"alarm-disarmed",
 	"alarm-arming",
 	"alarm-arm-refused",
+	"alarm-pending",
+	"alarm-rearmed",
+	"alarm-sensor-bypass",
+	"alarm-check-failed",
 	"addon-updated",
 	"server-updated",
 	"export-completed",
@@ -17034,9 +17039,13 @@ var NC_AUTHORABLE_SYSTEM_EVENT_KINDS = NcSystemEventKindSchema.options.filter((k
 */
 var NC_ALARM_SYSTEM_EVENT_KINDS = [
 	"alarm-arm-refused",
+	"alarm-check-failed",
 	"alarm-arming",
 	"alarm-armed",
+	"alarm-pending",
 	"alarm-triggered",
+	"alarm-rearmed",
+	"alarm-sensor-bypass",
 	"alarm-disarmed"
 ];
 /**
@@ -17660,6 +17669,19 @@ var NcMediaFrameSchema = zod.z.enum([
 	"full",
 	"boxed"
 ]);
+/**
+* How a SENSOR notification shows the cameras that link the sensor.
+*
+* `mosaic` — one image composed of every linked camera's photograph, taken at
+* the trigger. `each` — one image per camera where the target takes several
+* attachments; a target that takes one keeps the first camera's (the degrade
+* engine drops the rest by order). Either way ONE notification per event.
+* Absent = `mosaic`, applied by the Notification Center and deliberately NOT
+* a Zod default (see NcRulePatchSchema: a default materialises on every
+* partial patch). Meaningless for a rule whose subject is not a sensor, and a
+* sensor linked to one camera ships that camera's plain snapshot either way.
+*/
+var NcLinkedCameraModeSchema = zod.z.enum(["mosaic", "each"]);
 var NcMediaPolicySchema = zod.z.object({
 	attach: zod.z.enum([
 		"best",
@@ -17705,7 +17727,9 @@ var NcMediaPolicySchema = zod.z.object({
 	* A profile that is not assigned falls back to the cheapest, and the render
 	* reports which one actually ran.
 	*/
-	profile: require_sleep.CamProfileSchema.optional()
+	profile: require_sleep.CamProfileSchema.optional(),
+	/** See {@link NcLinkedCameraModeSchema}. */
+	linkedCameras: NcLinkedCameraModeSchema.optional()
 });
 /**
 * Cooldown GRANULARITY over the subject's class — how much a fired
@@ -17826,7 +17850,7 @@ var NcRuleInputSchema = zod.z.object({
 		cooldownSec: 60,
 		scope: "rule-device"
 	}),
-	/** `{{var}}` templating over camera/class/label/zones/confidence/time. */
+	/** `{{var}}` title/body. The variables are declared in `NC_TEMPLATE_VARS` (@camstack/types) and depend on the rule kind — see `templateVarsFor`. */
 	template: zod.z.object({
 		title: zod.z.string().max(500).optional(),
 		body: zod.z.string().max(2e3).optional()
@@ -18006,6 +18030,33 @@ var NcRulePatchSchema = NcRuleInputSchema.partial().extend({
 	throttle: NcThrottleSchema.optional(),
 	priority: zod.z.number().int().min(1).max(5).optional()
 });
+/**
+* Optional rule fields an editor may EMPTY on an update.
+*
+* `updateRule` merges `{ ...existing, ...patch }`, so an omitted key keeps its
+* stored value — which is what a partial patch must do, and exactly why a
+* field emptied in an editor used to survive the save. An editor names here
+* the keys it AUTHORS and found empty; the store removes them before the
+* merge. A `schedule` cannot be sent empty at all (`windows.min(1)`), so this
+* is the only way to remove one.
+*/
+var NC_RULE_CLEARABLE_KEYS = [
+	"template",
+	"schedule",
+	"targetUsers",
+	"snoozeOptions",
+	"snoozeAllowGlobal",
+	"waitForEnhancement",
+	"actions",
+	"confirm",
+	"groupIdleSec"
+];
+var NcRuleClearableKeySchema = zod.z.enum(NC_RULE_CLEARABLE_KEYS);
+var NcRuleUpdateInputSchema = zod.z.object({
+	ruleId: zod.z.string(),
+	patch: NcRulePatchSchema,
+	clear: zod.z.array(NcRuleClearableKeySchema).optional()
+});
 /** A persisted rule. */
 var NcRuleSchema = NcRuleInputSchema.extend({
 	id: zod.z.string(),
@@ -18037,6 +18088,87 @@ var NcTestResultSchema = zod.z.object({
 	className: zod.z.string().optional(),
 	label: zod.z.string().optional()
 });
+/** The five rule kinds, as data. `NcRuleKind` in `notification/rule-kinds.ts`
+*  is the same union; the template-vars spec pins the two together. */
+var NcRuleKindSchema = zod.z.enum([
+	"detection",
+	"sensor",
+	"occupancy",
+	"sound",
+	"system"
+]);
+/** Which producer renders a template: an ordinary rule, a timelapse, a digest. */
+var NcTemplateFamilySchema = zod.z.enum([
+	"rule",
+	"timelapse",
+	"summary"
+]);
+/** Which text field of that producer. `previewText` is the timelapse frame
+*  caption, `captionText` the digest mosaic caption — both see fewer vars. */
+var NcTemplateFieldSchema = zod.z.enum([
+	"title",
+	"body",
+	"previewText",
+	"captionText"
+]);
+var NcTemplateVarGroupSchema = zod.z.enum([
+	"subject",
+	"place",
+	"time",
+	"rule",
+	"occupancy",
+	"sound",
+	"sensor",
+	"system",
+	"digest",
+	"ai"
+]);
+/**
+* ONE `{{var}}` a notification template may name.
+*
+* `families` / `fields` / `kinds` / `deliveries` / `systemEventKinds` say WHERE
+* it has a value; absent = no restriction on that axis. `systemEventKinds` is
+* read only for a `system` rule. `dynamic` declares a FAMILY of names
+* (`count_<class>`): the descriptor's `name` is the example member.
+*/
+var NcTemplateVarDescriptorSchema = zod.z.object({
+	name: zod.z.string().regex(/^\w+$/),
+	label: zod.z.string(),
+	description: zod.z.string().optional(),
+	example: zod.z.string(),
+	group: NcTemplateVarGroupSchema,
+	families: zod.z.array(NcTemplateFamilySchema).min(1),
+	fields: zod.z.array(NcTemplateFieldSchema).optional(),
+	kinds: zod.z.array(NcRuleKindSchema).optional(),
+	deliveries: zod.z.array(NcDeliverySchema).optional(),
+	systemEventKinds: zod.z.array(NcSystemEventKindSchema).optional(),
+	dynamic: zod.z.object({
+		prefix: zod.z.literal("count_"),
+		from: zod.z.literal("classes")
+	}).optional()
+});
+/** What an editor knows about the field being edited. */
+var NcTemplateVarContextSchema = zod.z.object({
+	family: NcTemplateFamilySchema,
+	field: NcTemplateFieldSchema,
+	kind: NcRuleKindSchema.optional(),
+	delivery: NcDeliverySchema.optional(),
+	systemEventKinds: zod.z.array(NcSystemEventKindSchema).optional()
+});
+/** Input to `previewTemplate` — the editor's own context, plus the draft text. */
+var NcTemplatePreviewInputSchema = zod.z.object({
+	context: NcTemplateVarContextSchema,
+	template: zod.z.object({
+		title: zod.z.string().max(500).optional(),
+		body: zod.z.string().max(2e3).optional()
+	})
+});
+var NcTemplatePreviewSchema = zod.z.object({
+	title: zod.z.string().nullable(),
+	body: zod.z.string().nullable(),
+	/** Names the template uses that this context never fills — they render empty. */
+	unknown: zod.z.array(zod.z.string())
+});
 var NcConditionDescriptorSchema = zod.z.object({
 	/** Field id inside `NcConditions` (or `'schedule'` for the rule-level group). */
 	id: zod.z.string(),
@@ -18200,6 +18332,14 @@ var NC_CONDITION_CATALOG = [
 				value: "backup-completed",
 				label: "Backup completed"
 			},
+			{
+				value: "alarm-arm-refused",
+				label: "Alarm arm refused"
+			},
+			{
+				value: "alarm-check-failed",
+				label: "Alarm check failed (armed anyway)"
+			},
 			{
 				value: "alarm-arming",
 				label: "Alarm arming (exit delay)"
@@ -18208,10 +18348,22 @@ var NC_CONDITION_CATALOG = [
 				value: "alarm-armed",
 				label: "Alarm armed"
 			},
+			{
+				value: "alarm-pending",
+				label: "Alarm entry delay started"
+			},
 			{
 				value: "alarm-triggered",
 				label: "Alarm triggered"
 			},
+			{
+				value: "alarm-rearmed",
+				label: "Alarm re-armed after siren"
+			},
+			{
+				value: "alarm-sensor-bypass",
+				label: "Alarm sensor bypass"
+			},
 			{
 				value: "alarm-disarmed",
 				label: "Alarm disarmed"
@@ -18765,8 +18917,22 @@ var NcSnoozeSuppressedSchema = zod.z.object({
 	lastAt: zod.z.number()
 });
 /**
-* The three durations the panel's state machine runs on, plus who hears about
-* an arm.
+* One arm mode's non-blocking list: devices that may be open when that mode
+* arms, without the arm being refused.
+*/
+var NcAlarmNonBlockingSchema = zod.z.object({
+	mode: AlarmArmModeSchema,
+	deviceIds: zod.z.array(zod.z.number().int()).max(200)
+});
+/**
+* The per-mode lists, at most one per mode. Two lists for one mode have no
+* meaning a reader could agree on (union? the last one?), so they are refused
+* at the boundary rather than interpreted.
+*/
+var NcAlarmNonBlockingListSchema = zod.z.array(NcAlarmNonBlockingSchema).max(8).refine((lists) => new Set(lists.map((l) => l.mode)).size === lists.length, { message: "nonBlocking: at most one list per arm mode" });
+/**
+* The three durations the panel's state machine runs on, who hears about its
+* transitions, and which openings each mode tolerates.
 *
 * They live on the NOTIFICATION-RULES cap, not on `alarm-panel`, on purpose:
 * `alarm-panel` is `deviceNative` and its other provider mirrors somebody
@@ -18785,21 +18951,39 @@ var NcAlarmSettingsSchema = zod.z.object({
 	* existed, and therefore what an untouched install keeps doing.
 	*/
 	triggeredDurationSec: zod.z.number().int().min(0).max(3600),
-	/** Send a notification when a mode takes effect. */
-	announceArm: zod.z.boolean(),
 	/**
-	* Where that notification goes. Target ids from `notification-output`.
+	* Deprecated by D630 — every transition is announced. Parsed, never read;
+	* remove after one release. Optional so an older admin's patch (which still
+	* sends it) parses rather than failing the whole save.
+	*/
+	announceArm: zod.z.boolean().optional(),
+	/**
+	* Target ids from `notification-output`: every alarm transition goes here.
 	*
-	* Explicit rather than "everyone": an arm announcement is a household
+	* Explicit rather than "everyone": an alarm announcement is a household
 	* message, and broadcasting it to every configured endpoint (including a
 	* webhook wired to something else) is not a default anybody would choose.
-	* Empty with `announceArm: true` sends nothing, and the server logs that —
-	* silence must be attributable.
+	* Empty sends nothing, and the server logs that — silence must be
+	* attributable.
+	*/
+	announceTargets: zod.z.array(zod.z.string().min(1)).max(16),
+	/**
+	* Per arm mode, the covered devices whose being OPEN does not refuse the
+	* arm (a window left ajar for the cat under `home`, say). At most one entry
+	* per mode is meaningful. Defaulted to `[]` so a blob stored before D630
+	* parses as "every opening blocks" — the behaviour it was written under.
 	*/
-	announceTargets: zod.z.array(zod.z.string().min(1)).max(16)
+	nonBlocking: NcAlarmNonBlockingListSchema.default([])
 });
-/** Every field optional — a tab edits one control at a time. */
-var NcAlarmSettingsPatchSchema = NcAlarmSettingsSchema.partial();
+/**
+* Every field optional — a tab edits one control at a time.
+*
+* `nonBlocking` is re-declared WITHOUT its default: `.partial()` does not
+* remove an inner `.default()`, so a patch that never named the field would
+* parse to `nonBlocking: []` and wipe every mode's list on an unrelated edit
+* (the same trap {@link NcRulePatchSchema} documents).
+*/
+var NcAlarmSettingsPatchSchema = NcAlarmSettingsSchema.extend({ nonBlocking: NcAlarmNonBlockingListSchema }).partial();
 /**
 * What one arm mode actually arms, DERIVED from the enabled rules gated on it.
 * Never authored, never stored — see `alarm-mode-coverage.ts` for why a stored
@@ -18844,6 +19028,36 @@ var NcAlarmModeCoverageSchema = zod.z.object({
 	*/
 	skippedDevices: zod.z.array(NcAlarmSkippedDeviceSchema).default([])
 });
+/** One covered device that reads open, and whether that refuses the arm. */
+var NcAlarmOpeningSchema = zod.z.object({
+	deviceId: zod.z.number().int(),
+	name: zod.z.string(),
+	/** The device's state word as read (`open`, `unlocked`, …). */
+	state: zod.z.string(),
+	/** False when the mode's non-blocking list names this device. */
+	blocking: zod.z.boolean()
+});
+/** A device the panel is currently ignoring, and which side of it it is on. */
+var NcAlarmExclusionViewSchema = zod.z.object({
+	deviceId: zod.z.number().int(),
+	name: zod.z.string(),
+	phase: zod.z.enum(["open", "closed"])
+});
+/** One mode's openings: devices read open, plus those whose state is unknown. */
+var NcAlarmModeOpeningsSchema = zod.z.object({
+	mode: AlarmArmModeSchema,
+	devices: zod.z.array(NcAlarmOpeningSchema),
+	/** Covered devices whose state could not be read (D49): neither open nor closed. */
+	unknown: zod.z.array(zod.z.number().int())
+});
+var NcAlarmLiveSchema = zod.z.object({
+	state: AlarmStateSchema,
+	/** The mode being armed into (exit delay) or held; null when disarmed. */
+	targetMode: AlarmArmModeSchema.nullable(),
+	availableModes: zod.z.array(AlarmArmModeSchema),
+	openings: zod.z.array(NcAlarmModeOpeningsSchema),
+	exclusions: zod.z.array(NcAlarmExclusionViewSchema)
+});
 var NcAlarmConfigSchema = zod.z.object({
 	/**
 	* The panel's device id, or null when this install has no panel (the ensure
@@ -18853,7 +19067,13 @@ var NcAlarmConfigSchema = zod.z.object({
 	*/
 	deviceId: zod.z.number().int().nullable(),
 	settings: NcAlarmSettingsSchema,
-	coverage: zod.z.array(NcAlarmModeCoverageSchema)
+	coverage: zod.z.array(NcAlarmModeCoverageSchema),
+	/**
+	* The panel as it is NOW — state, what each mode would find open, what is
+	* excluded. Optional: a panel-less hub answers without it, and a client
+	* must not read its absence as "nothing is open".
+	*/
+	live: NcAlarmLiveSchema.optional()
 });
 /**
 * The most seconds of footage any notification rule may ask a camera to retain.
@@ -18927,10 +19147,7 @@ var notificationRulesCapability = {
 			auth: "admin",
 			caller: "required"
 		}),
-		updateRule: require_sleep.method(zod.z.object({
-			ruleId: zod.z.string(),
-			patch: NcRulePatchSchema
-		}), zod.z.object({ rule: NcRuleSchema }), {
+		updateRule: require_sleep.method(NcRuleUpdateInputSchema, zod.z.object({ rule: NcRuleSchema }), {
 			kind: "mutation",
 			auth: "admin",
 			caller: "required"
@@ -19018,6 +19235,18 @@ var notificationRulesCapability = {
 			catalog: zod.z.array(NcConditionDescriptorSchema),
 			taxonomy: NcTaxonomySchema.optional()
 		})),
+		/** The declared `{{var}}` vocabulary; editors filter it with `templateVarsFor`. */
+		getTemplateCatalog: require_sleep.method(zod.z.object({}), zod.z.object({ vars: zod.z.array(NcTemplateVarDescriptorSchema) })),
+		/**
+		* Render a template with example values, through the hub's text catalog.
+		* Pure: sends nothing. A MUTATION only for transport — a 2.5k-char draft in
+		* a batched GET URL risks length limits — so access stays `view`, the same
+		* as `getTemplateCatalog`.
+		*/
+		previewTemplate: require_sleep.method(NcTemplatePreviewInputSchema, NcTemplatePreviewSchema, {
+			kind: "mutation",
+			access: "view"
+		}),
 		/**
 		* Queryable delivery history — a read-only view over the durable outbox
 		* (fired rule, subject summary, target, status, timestamps, error on a
@@ -19072,7 +19301,10 @@ var notificationRulesCapability = {
 			caller: "required"
 		}),
 		/**
-		* The alarm panel's durations, plus what each mode ACTUALLY arms.
+		* The alarm panel's settings, what each mode ACTUALLY arms, and — when a
+		* panel exists — its `live` state: current state and target mode, what
+		* each mode would find open (blocking or not, and what is unknown), and
+		* the devices currently excluded.
 		*
 		* Coverage is returned by the same call as the settings on purpose: they
 		* are read together or not at all. An editor that showed the delays
@@ -19082,7 +19314,9 @@ var notificationRulesCapability = {
 		*/
 		getAlarmConfig: require_sleep.method(zod.z.object({}), NcAlarmConfigSchema, { auth: "admin" }),
 		/**
-		* Patch the durations. Returns the WHOLE config, coverage included, so a
+		* Patch the settings (durations, recipients, per-mode non-blocking lists;
+		* `announceArm` is accepted and ignored — D630). Returns the WHOLE config,
+		* coverage and `live` included, so a
 		* client never has to guess what the server settled on — the panel clamps
 		* and normalises, and a form that re-rendered from its own input would
 		* show a value the alarm is not using.
@@ -25315,6 +25549,7 @@ var CAP_TO_KIND = {
 	"enum-sensor": "enum-sensor",
 	"event-emitter": "device-event",
 	"lock-control": "lock",
+	cover: "cover",
 	switch: "switch",
 	button: "button",
 	doorbell: "doorbell"
@@ -42463,9 +42698,8 @@ var DEVICE_STATE_READERS = [
 		field: "state"
 	},
 	{
-		cap: "lock",
-		field: "locked",
-		booleanWords: ["locked", "unlocked"]
+		cap: "lock-control",
+		field: "state"
 	},
 	{
 		cap: "contact",
@@ -52167,6 +52401,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationRules.getTemplateCatalog": {
+		capName: "notification-rules",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"notificationRules.listDeviceMutes": {
 		capName: "notification-rules",
 		capScope: "system",
@@ -52185,6 +52425,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"notificationRules.previewTemplate": {
+		capName: "notification-rules",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"notificationRules.resolveArtifactUrl": {
 		capName: "notification-rules",
 		capScope: "system",
@@ -60416,6 +60662,761 @@ function isScheduleActive(schedule, atMs) {
 	return schedule.invert === true ? !inside : inside;
 }
 //#endregion
+//#region src/notification/template-vars.ts
+var RULE_BODY_ONLY = ["body"];
+var RULE_TEXT = ["title", "body"];
+var BATTERY = ["device-battery-low", "device-battery-normal"];
+var CONSUMABLE = ["device-consumable-low", "device-consumable-normal"];
+var UPDATES = [
+	"addon-update-available",
+	"server-update-available",
+	"wrapper-update-available"
+];
+var PACKAGE_UPDATES = ["addon-update-available", "server-update-available"];
+var ALARM = [
+	"alarm-triggered",
+	"alarm-armed",
+	"alarm-disarmed",
+	"alarm-arming",
+	"alarm-arm-refused"
+];
+var COMBINED_ALARM = ["alarm-triggered"];
+var DEVICE_EVENTS = [
+	"device-online",
+	"device-offline",
+	"device-disabled",
+	"device-enabled",
+	...BATTERY,
+	...CONSUMABLE,
+	"stream-online",
+	"stream-offline",
+	"detection-blind",
+	...ALARM
+];
+var NC_TEMPLATE_VARS = [
+	{
+		name: "camera",
+		label: "Camera",
+		example: "Ingresso",
+		group: "subject",
+		families: ["rule", "timelapse"],
+		systemEventKinds: [...DEVICE_EVENTS, "export-completed"]
+	},
+	{
+		name: "class",
+		label: "Detected class",
+		description: "The counted class on an occupancy row (e.g. \"person\"); the detected class elsewhere.",
+		example: "person",
+		group: "subject",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: [
+			"detection",
+			"sensor",
+			"sound",
+			"occupancy",
+			"system"
+		],
+		systemEventKinds: [...COMBINED_ALARM]
+	},
+	{
+		name: "label",
+		label: "Name or plate",
+		description: "Recognised person or read plate; empty otherwise.",
+		example: "Mario",
+		group: "subject",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["detection", "system"],
+		systemEventKinds: [...COMBINED_ALARM]
+	},
+	{
+		name: "subject",
+		label: "Subject sentence",
+		description: "Composed in the notification language, e.g. \"person (Mario)\".",
+		example: "persona (Mario)",
+		group: "subject",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: [
+			"detection",
+			"sensor",
+			"sound",
+			"occupancy"
+		]
+	},
+	{
+		name: "confidence",
+		label: "Confidence",
+		example: "87%",
+		group: "subject",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["detection", "system"],
+		systemEventKinds: [...COMBINED_ALARM]
+	},
+	{
+		name: "count",
+		label: "Count",
+		description: "Occupancy count, subjects in a grouped notification, or the event count of a system notice.",
+		example: "3",
+		group: "subject",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: [
+			"detection",
+			"occupancy",
+			"system"
+		],
+		systemEventKinds: [
+			"addon-crash-loop",
+			...PACKAGE_UPDATES,
+			"addon-updated"
+		]
+	},
+	{
+		name: "detectionSummary",
+		label: "Detection summary",
+		description: "Class composition, e.g. \"2 persons and 1 car\".",
+		example: "2 persone e 1 auto",
+		group: "subject",
+		families: [
+			"rule",
+			"timelapse",
+			"summary"
+		],
+		fields: [...RULE_TEXT],
+		kinds: ["detection"]
+	},
+	{
+		name: "zones",
+		label: "Zones",
+		example: "Cancello, Vialetto",
+		group: "place",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["detection", "system"],
+		systemEventKinds: [...COMBINED_ALARM]
+	},
+	{
+		name: "zone",
+		label: "Zone",
+		example: "Cancello",
+		group: "place",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: [
+			"detection",
+			"occupancy",
+			"system"
+		],
+		systemEventKinds: [...COMBINED_ALARM]
+	},
+	{
+		name: "inZones",
+		label: "\"in <zones>\" fragment",
+		description: "Leading space included; empty when no zone.",
+		example: " in Cancello",
+		group: "place",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["detection", "system"],
+		systemEventKinds: [...COMBINED_ALARM]
+	},
+	{
+		name: "scope",
+		label: "Occupancy scope",
+		example: "Cancello",
+		group: "place",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["occupancy"]
+	},
+	{
+		name: "time",
+		label: "Time",
+		description: "Hours and minutes, in the notification language.",
+		example: "20:05",
+		group: "time",
+		families: [
+			"rule",
+			"timelapse",
+			"summary"
+		],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "rule",
+		label: "Rule name",
+		example: "Ingresso notte",
+		group: "rule",
+		families: [
+			"rule",
+			"timelapse",
+			"summary"
+		]
+	},
+	{
+		name: "from",
+		label: "Window start",
+		example: "07:00",
+		group: "time",
+		families: ["timelapse", "summary"]
+	},
+	{
+		name: "to",
+		label: "Window end",
+		example: "08:00",
+		group: "time",
+		families: ["timelapse", "summary"]
+	},
+	{
+		name: "capacity",
+		label: "Capacity",
+		example: "2",
+		group: "occupancy",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["occupancy"]
+	},
+	{
+		name: "op",
+		label: "Occupied / free",
+		example: "occupata",
+		group: "occupancy",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["occupancy"]
+	},
+	{
+		name: "sounds",
+		label: "Sounds heard",
+		example: "abbaio, clacson",
+		group: "sound",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sound"]
+	},
+	{
+		name: "hitPercent",
+		label: "Share of the window",
+		description: "Level mode only: percentage of samples above the threshold.",
+		example: "42",
+		group: "sound",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sound"]
+	},
+	{
+		name: "db",
+		label: "Peak level (dBFS)",
+		example: "-18",
+		group: "sound",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sound"]
+	},
+	{
+		name: "eventType",
+		label: "Event type",
+		description: "Raw device event token, e.g. \"press\" or \"open\"; empty when the device sends none.",
+		example: "press",
+		group: "sensor",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sensor"]
+	},
+	{
+		name: "ai",
+		label: "AI sentence",
+		description: "Where the AI description goes; appended on its own line when absent.",
+		example: "Una persona lascia un pacco.",
+		group: "ai",
+		families: ["rule", "summary"],
+		fields: [...RULE_BODY_ONLY],
+		kinds: ["detection", "occupancy"]
+	},
+	{
+		name: "eventKind",
+		label: "Event kind",
+		example: "device-offline",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"]
+	},
+	{
+		name: "deviceName",
+		label: "Device",
+		example: "Ingresso",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...DEVICE_EVENTS]
+	},
+	{
+		name: "deviceId",
+		label: "Device id",
+		example: "617",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...DEVICE_EVENTS, "export-completed"]
+	},
+	{
+		name: "percentage",
+		label: "Percentage",
+		example: "15",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...BATTERY, ...CONSUMABLE]
+	},
+	{
+		name: "item",
+		label: "Consumable",
+		example: "Filtro",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...CONSUMABLE]
+	},
+	{
+		name: "profile",
+		label: "Stream profile",
+		example: "high",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["stream-online", "stream-offline"]
+	},
+	{
+		name: "node",
+		label: "Node",
+		example: "hub",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [
+			"node-online",
+			"node-offline",
+			"node-inference-unavailable",
+			"addon-crash-loop",
+			...UPDATES,
+			"addon-updated",
+			"server-updated"
+		]
+	},
+	{
+		name: "nodeId",
+		label: "Node id",
+		example: "hub",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [
+			"node-online",
+			"node-offline",
+			"node-inference-unavailable",
+			"addon-crash-loop",
+			...UPDATES,
+			"server-updated"
+		]
+	},
+	{
+		name: "devices",
+		label: "Devices",
+		description: "node-inference-unavailable: the affected cameras, comma-joined. Alarm arm / refusal: HOW MANY devices are armed (or open).",
+		example: "Ingresso, Garage",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [
+			"node-inference-unavailable",
+			"alarm-armed",
+			"alarm-arm-refused"
+		]
+	},
+	{
+		name: "addons",
+		label: "Addons",
+		example: "stream-broker",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["addon-crash-loop"]
+	},
+	{
+		name: "minutes",
+		label: "Minutes",
+		example: "12",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["detection-blind"]
+	},
+	{
+		name: "package",
+		label: "Package",
+		example: "@camstack/addon-recorder",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [
+			...UPDATES,
+			"addon-updated",
+			"server-updated"
+		]
+	},
+	{
+		name: "packageName",
+		label: "Package",
+		example: "@camstack/addon-recorder",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...PACKAGE_UPDATES, "server-updated"]
+	},
+	{
+		name: "nodes",
+		label: "Nodes",
+		description: "Comma-joined node ids, when an update spans more than one — the single-node case names it through {{nodeId}} instead. `incomingFromUpdateAvailable` (event-intake.ts) fills `nodes` from ONE shared textParams object for both addon- and server-update-available, exactly like packageName/currentVersion/latestVersion/count — only the shipped TEXT (system.server-update-available.body.onNodes) reads it today, but the var is real on both kinds.",
+		example: "hub, little-unraid",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...PACKAGE_UPDATES]
+	},
+	{
+		name: "currentVersion",
+		label: "Current version",
+		example: "1.2.377",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...UPDATES]
+	},
+	{
+		name: "latestVersion",
+		label: "Latest version",
+		example: "1.2.378",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...UPDATES]
+	},
+	{
+		name: "list",
+		label: "Updated packages",
+		description: "One line per package. `incomingFromUpdateAvailable` fills it for addon-/server-update-available too (the SAME shared textParams object as `nodes`) — `system.addon-update-available.body` reads it; `incomingFromAddonUpdates` fills it again, independently, for the completed `addon-updated` event.",
+		example: "recorder, notifiers",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [...PACKAGE_UPDATES, "addon-updated"]
+	},
+	{
+		name: "fromVersion",
+		label: "From version",
+		example: "1.2.377",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["server-updated"]
+	},
+	{
+		name: "toVersion",
+		label: "To version",
+		example: "1.2.378",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["server-updated"]
+	},
+	{
+		name: "destinationsOk",
+		label: "Destinations ok",
+		example: "2",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["backup-completed"]
+	},
+	{
+		name: "destinationsTotal",
+		label: "Destinations",
+		example: "2",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["backup-completed"]
+	},
+	{
+		name: "destinationsFailed",
+		label: "Destinations failed",
+		example: "0",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["backup-completed"]
+	},
+	{
+		name: "sizeMB",
+		label: "Size (MB)",
+		example: "412",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["backup-completed"]
+	},
+	{
+		name: "backupId",
+		label: "Backup id",
+		example: "bk-20260924",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["backup-completed"]
+	},
+	{
+		name: "title",
+		label: "Export title",
+		example: "Ingresso 08:00",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["export-completed"]
+	},
+	{
+		name: "exportId",
+		label: "Export id",
+		example: "exp-20260924",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["export-completed"]
+	},
+	{
+		name: "bytes",
+		label: "Export size (bytes)",
+		example: "10485760",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["export-completed"]
+	},
+	{
+		name: "mode",
+		label: "Alarm mode",
+		example: "away",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [
+			"alarm-armed",
+			"alarm-arming",
+			"alarm-arm-refused"
+		]
+	},
+	{
+		name: "seconds",
+		label: "Seconds",
+		description: "Arming: the exit delay left. Refusal: how long the retry-to-arm-anyway lasts.",
+		example: "30",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["alarm-arming", "alarm-arm-refused"]
+	},
+	{
+		name: "rules",
+		label: "Covering rules",
+		description: "How many enabled rules the armed mode gates.",
+		example: "2",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["alarm-armed"]
+	},
+	{
+		name: "names",
+		label: "Device names",
+		description: "Armed: the devices armed. Arming: the devices this mode cannot arm. Refusal: the open sensors.",
+		example: "Ingresso, Garage",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: [
+			"alarm-armed",
+			"alarm-arming",
+			"alarm-arm-refused"
+		]
+	},
+	{
+		name: "skippedNames",
+		label: "Skipped devices",
+		description: "Devices the mode names but cannot arm (muted, detection off, offline).",
+		example: "Garage",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["alarm-armed"]
+	},
+	{
+		name: "bypassedNames",
+		label: "Bypassed sensors",
+		description: "Sensors the operator armed around because they were open.",
+		example: "Finestra veranda",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["alarm-armed", "alarm-arming"]
+	},
+	{
+		name: "coverage",
+		label: "Coverage %",
+		example: "96",
+		group: "digest",
+		families: ["timelapse"],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "events",
+		label: "Events",
+		example: "4",
+		group: "digest",
+		families: ["timelapse", "summary"],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "detections",
+		label: "Detections",
+		example: "7",
+		group: "digest",
+		families: ["timelapse", "summary"],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "count_person",
+		label: "Count of one class",
+		description: "count_<class>, e.g. count_person, count_car.",
+		example: "3",
+		group: "digest",
+		families: ["timelapse", "summary"],
+		fields: [...RULE_TEXT],
+		dynamic: {
+			prefix: "count_",
+			from: "classes"
+		}
+	},
+	{
+		name: "cameras",
+		label: "Cameras",
+		example: "3",
+		group: "digest",
+		families: ["summary"],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "matched",
+		label: "Matched events",
+		example: "12",
+		group: "digest",
+		families: ["summary"],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "shown",
+		label: "Events shown",
+		example: "9",
+		group: "digest",
+		families: ["summary"],
+		fields: [...RULE_TEXT]
+	},
+	{
+		name: "total",
+		label: "Events total",
+		example: "12",
+		group: "digest",
+		families: ["summary"],
+		fields: [...RULE_TEXT]
+	}
+];
+/** The caption fields see a fixed, smaller vocabulary (`timelapsePreviewText`,
+*  `summaryCaptionText`). Declared here rather than as `fields` on every
+*  descriptor so the whole rule stays in one line of code. */
+var CAPTION_VARS = {
+	previewText: [
+		"camera",
+		"rule",
+		"from",
+		"to"
+	],
+	captionText: [
+		"rule",
+		"from",
+		"to"
+	]
+};
+function onAxis(declared, asked) {
+	return declared === void 0 || asked === void 0 || declared.includes(asked);
+}
+function onSystemAxis(d, ctx) {
+	if (ctx.kind !== "system" || d.systemEventKinds === void 0) return true;
+	const asked = ctx.systemEventKinds ?? [];
+	return asked.length === 0 || asked.some((k) => d.systemEventKinds?.includes(k) === true);
+}
+/**
+* The variables that have a value in `ctx`, in catalog order. Pure.
+*
+* `ctx` is trusted, typed input — untrusted input (a served/RPC boundary) is
+* validated once against {@link NcTemplateVarContextSchema} at the cap/bridge
+* boundary, not re-parsed on every call here (Task 4).
+*/
+function templateVarsFor(ctx) {
+	if (ctx.field === "previewText" || ctx.field === "captionText") {
+		const allowed = CAPTION_VARS[ctx.field];
+		return NC_TEMPLATE_VARS.filter((d) => d.families.includes(ctx.family) && allowed.includes(d.name) && d.dynamic === void 0);
+	}
+	return NC_TEMPLATE_VARS.filter((d) => d.families.includes(ctx.family) && onAxis(d.fields, ctx.field) && onAxis(d.kinds, ctx.kind) && onAxis(d.deliveries, ctx.delivery) && onSystemAxis(d, ctx));
+}
+/** True when `name` is supplied in `ctx`, dynamic families (`count_<class>`) included. */
+function isKnownTemplateVar(name, ctx) {
+	return templateVarsFor(ctx).some((d) => d.dynamic !== void 0 ? name.startsWith(d.dynamic.prefix) && name.length > d.dynamic.prefix.length : d.name === name);
+}
+//#endregion
 //#region src/notification/system-event-filters.ts
 /** Every filter, for the callers that must cover all four (guards, tests). */
 var NC_SYSTEM_EVENT_FILTER_KEYS = [
@@ -64022,6 +65023,7 @@ exports.NC_HISTORY_LIMIT_DEFAULT = NC_HISTORY_LIMIT_DEFAULT;
 exports.NC_HISTORY_LIMIT_MAX = NC_HISTORY_LIMIT_MAX;
 exports.NC_MAX_PER_TRACK_IMMEDIATE = NC_MAX_PER_TRACK_IMMEDIATE;
 exports.NC_OCCUPANCY_DEFAULTS = NC_OCCUPANCY_DEFAULTS;
+exports.NC_RULE_CLEARABLE_KEYS = NC_RULE_CLEARABLE_KEYS;
 exports.NC_RULE_EDITOR_SECTION_ORDER = NC_RULE_EDITOR_SECTION_ORDER;
 exports.NC_RULE_KIND_SPECS = NC_RULE_KIND_SPECS;
 exports.NC_RULE_SECTIONS = NC_RULE_SECTIONS;
@@ -64029,6 +65031,7 @@ exports.NC_SNOOZE_MAX_MINUTES = NC_SNOOZE_MAX_MINUTES;
 exports.NC_SYSTEM_DELIVERY = NC_SYSTEM_DELIVERY;
 exports.NC_SYSTEM_EVENT_FILTER_KEYS = NC_SYSTEM_EVENT_FILTER_KEYS;
 exports.NC_TAXONOMY = NC_TAXONOMY;
+exports.NC_TEMPLATE_VARS = NC_TEMPLATE_VARS;
 exports.NETWORK_LINK_TYPES = NETWORK_LINK_TYPES;
 exports.NETWORK_LINK_UNKNOWN = NETWORK_LINK_UNKNOWN;
 exports.NativeCropBboxSchema = NativeCropBboxSchema;
@@ -64074,6 +65077,7 @@ exports.NcHistoryFilterSchema = NcHistoryFilterSchema;
 exports.NcHistoryRecordKindSchema = NcHistoryRecordKindSchema;
 exports.NcHistoryStatusSchema = NcHistoryStatusSchema;
 exports.NcHistorySubjectSchema = NcHistorySubjectSchema;
+exports.NcLinkedCameraModeSchema = NcLinkedCameraModeSchema;
 exports.NcMediaFrameSchema = NcMediaFrameSchema;
 exports.NcMediaPolicySchema = NcMediaPolicySchema;
 exports.NcOccupancyConditionSchema = NcOccupancyConditionSchema;
@@ -64081,11 +65085,14 @@ exports.NcPlateMatcherSchema = NcPlateMatcherSchema;
 exports.NcRuleActionSchema = NcRuleActionSchema;
 exports.NcRuleActionSequenceSchema = NcRuleActionSequenceSchema;
 exports.NcRuleActionsSchema = NcRuleActionsSchema;
+exports.NcRuleClearableKeySchema = NcRuleClearableKeySchema;
 exports.NcRuleInputSchema = NcRuleInputSchema;
+exports.NcRuleKindSchema = NcRuleKindSchema;
 exports.NcRuleNotificationButtonSchema = NcRuleNotificationButtonSchema;
 exports.NcRulePatchSchema = NcRulePatchSchema;
 exports.NcRuleSchema = NcRuleSchema;
 exports.NcRuleTargetSchema = NcRuleTargetSchema;
+exports.NcRuleUpdateInputSchema = NcRuleUpdateInputSchema;
 exports.NcSceneConditionSchema = NcSceneConditionSchema;
 exports.NcScheduleSchema = NcScheduleSchema;
 exports.NcScheduleWindowSchema = NcScheduleWindowSchema;
@@ -64097,6 +65104,13 @@ exports.NcSystemEventConditionSchema = NcSystemEventConditionSchema;
 exports.NcSystemEventKindSchema = NcSystemEventKindSchema;
 exports.NcTaxonomyEntrySchema = NcTaxonomyEntrySchema;
 exports.NcTaxonomySchema = NcTaxonomySchema;
+exports.NcTemplateFamilySchema = NcTemplateFamilySchema;
+exports.NcTemplateFieldSchema = NcTemplateFieldSchema;
+exports.NcTemplatePreviewInputSchema = NcTemplatePreviewInputSchema;
+exports.NcTemplatePreviewSchema = NcTemplatePreviewSchema;
+exports.NcTemplateVarContextSchema = NcTemplateVarContextSchema;
+exports.NcTemplateVarDescriptorSchema = NcTemplateVarDescriptorSchema;
+exports.NcTemplateVarGroupSchema = NcTemplateVarGroupSchema;
 exports.NcTestResultSchema = NcTestResultSchema;
 exports.NcThrottleGranularitySchema = NcThrottleGranularitySchema;
 exports.NcThrottleSchema = NcThrottleSchema;
@@ -64797,6 +65811,7 @@ exports.isEvent = require_sleep.isEvent;
 exports.isEventOwnerType = isEventOwnerType;
 exports.isFirstLevelMacroClass = isFirstLevelMacroClass;
 exports.isIsolatedBuiltin = isIsolatedBuiltin;
+exports.isKnownTemplateVar = isKnownTemplateVar;
 exports.isLocationEnabled = isLocationEnabled;
 exports.isMediaOwnerType = isMediaOwnerType;
 exports.isNode = isNode;
@@ -65036,6 +66051,7 @@ exports.taskLogEntrySchema = taskLogEntrySchema;
 exports.taskPhaseSchema = taskPhaseSchema;
 exports.taskTargetSchema = taskTargetSchema;
 exports.temperatureSensorCapability = temperatureSensorCapability;
+exports.templateVarsFor = templateVarsFor;
 exports.terminalSessionCapability = terminalSessionCapability;
 exports.textToHtml = textToHtml;
 exports.timeOfDayToMinutes = timeOfDayToMinutes;