@camstack/types 1.2.300 → 1.2.303

package/dist/interfaces/config-ui.d.ts

@@ -80,7 +80,7 @@ export interface ConfigSection {
     readonly immediate?: boolean;
     readonly fields: readonly ConfigField[];
 }
-export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanField | ConfigSelectField | ConfigMultiSelectField | ConfigTimezoneField | ConfigDateTimeField | ConfigColorField | ConfigPasswordField | ConfigTextAreaField | ConfigSliderField | ConfigTagsField | ConfigGroupField | ConfigSubTabsField | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | ConfigEditableArrayField | ConfigModelSelectorField | ConfigStorageLocationField | ConfigProbeField | ConfigButtonField | ConfigPipelineEditorField | ConfigNodeSelectField | ConfigNodeMultiSelectField | ConfigDeviceSelectField | ConfigDeviceMultiSelectField | ConfigWidgetField | ConfigAddonActionSelectField | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;
+export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanField | ConfigSelectField | ConfigMultiSelectField | ConfigTimezoneField | ConfigDateTimeField | ConfigColorField | ConfigPasswordField | ConfigTextAreaField | ConfigSliderField | ConfigTagsField | ConfigScheduleField | ConfigGroupField | ConfigSubTabsField | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | ConfigEditableArrayField | ConfigModelSelectorField | ConfigStorageLocationField | ConfigProbeField | ConfigButtonField | ConfigPipelineEditorField | ConfigNodeSelectField | ConfigNodeMultiSelectField | ConfigDeviceSelectField | ConfigDeviceMultiSelectField | ConfigNotificationTargetSelectField | ConfigNotificationTargetMultiSelectField | ConfigWidgetField | ConfigAddonActionSelectField | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;
 /**
  * Per-MODEL applicability of a pipeline-step setting (D214).
  *
@@ -324,12 +324,31 @@ export interface ConfigBooleanField extends ConfigFieldBase {
 export interface ConfigSelectField extends ConfigFieldBase {
     type: 'select';
     options: readonly ConfigOption[];
+    /**
+     * Key of a sibling stored `string[]` catalog. Each entry becomes an
+     * option `{ value, label }` at hydrate time (merged with `options`).
+     * Same idea as tags `suggestionsFrom`, for a closed dropdown.
+     */
+    optionsFrom?: string;
     dependsOn?: Record<string, unknown>;
 }
 export interface ConfigMultiSelectField extends ConfigFieldBase {
     type: 'multiselect';
     options: readonly ConfigOption[];
+    /**
+     * Key of a sibling stored `string[]` catalog. Each entry becomes an
+     * option `{ value, label }` at hydrate time (merged with `options`).
+     * Same idea as tags `suggestionsFrom`, for a closed multi-picker.
+     */
+    optionsFrom?: string;
     maxItems?: number;
+    /**
+     * When true, the operator may commit values that are not in `options`.
+     * Default false — closed catalogs stay closed.
+     */
+    creatable?: boolean;
+    /** Footer label for the “add value” action in the dropdown. Default “Add new…”. */
+    createLabel?: string;
 }
 /**
  * Friendly timezone picker. The stored value is an IANA timezone id
@@ -423,6 +442,23 @@ export interface ConfigDeviceMultiSelectField extends ConfigFieldBase {
      */
     suggestLocation?: string | null;
 }
+/**
+ * Pick a SINGLE `notification-output` target from the live catalog
+ * (`listTargets`). Stored value is the target id string. Same control the
+ * Notification Center editors use — scripts and addon settings must not
+ * invent a parallel free-text "target id" field.
+ */
+export interface ConfigNotificationTargetSelectField extends ConfigFieldBase {
+    type: 'notification-target-select';
+}
+/**
+ * Pick MULTIPLE `notification-output` targets. Stored value is a `string[]`
+ * of target ids.
+ */
+export interface ConfigNotificationTargetMultiSelectField extends ConfigFieldBase {
+    type: 'notification-target-multiselect';
+    maxItems?: number;
+}
 export interface ConfigPasswordField extends ConfigFieldBase {
     type: 'password';
     showToggle?: boolean;
@@ -469,7 +505,49 @@ export interface ConfigSliderField extends ConfigFieldBase {
 export interface ConfigTagsField extends ConfigFieldBase {
     type: 'tags';
     suggestions?: string[];
+    /**
+     * Key of a sibling stored value that holds a `string[]` of extra
+     * suggestions (e.g. a scrape-filled `channelCatalog`). Merged into
+     * `suggestions` at hydrate time so a form can offer a live catalog
+     * without baking it into the static schema.
+     */
+    suggestionsFrom?: string;
     maxTags?: number;
+    /**
+     * When true (default for tags fields), the operator may add values outside
+     * the suggestion catalog. Set false to restrict to known suggestions only.
+     */
+    creatable?: boolean;
+    /** Footer label for the “add value” action. Default “Add new…”. */
+    createLabel?: string;
+}
+/**
+ * Weekly schedule — the same `NcSchedule` editor used by Notification Center.
+ * Value shape is {@link NcSchedule} (or `undefined` = always / unset).
+ *
+ * Two authoring modes, one wire shape:
+ *   - `windows` (default) — start→end bands ("active WHILE inside")
+ *   - `times` — one HH:MM per row ("fire AT"), stored as one-minute windows
+ *
+ * The consumer decides what a window means at evaluation time.
+ */
+export interface ConfigScheduleField extends ConfigFieldBase {
+    type: 'schedule';
+    /**
+     * `windows` — start→end activation bands (default).
+     * `times` — punctual send/fire times (single clock per row).
+     */
+    mode?: 'windows' | 'times';
+    /** Default windows when the store has no value yet. */
+    default?: {
+        readonly windows: readonly {
+            readonly days: readonly number[];
+            readonly startMinute: number;
+            readonly endMinute: number;
+        }[];
+        readonly timezone?: string;
+        readonly invert?: boolean;
+    };
 }
 export interface ConfigGroupField extends ConfigFieldBase {
     type: 'group';
@@ -914,6 +992,8 @@ export type ConfigFieldWithValue = (ConfigTextField & {
     readonly value: unknown;
 }) | (ConfigTagsField & {
     readonly value: unknown;
+}) | (ConfigScheduleField & {
+    readonly value: unknown;
 }) | ConfigGroupFieldWithValue | ConfigSubTabsFieldWithValue | ConfigSeparatorField | ConfigInfoField | ConfigQrCodeField | ConfigObjectArrayField | (ConfigEditableArrayField & {
     readonly value: unknown;
 }) | (ConfigModelSelectorField & {
@@ -932,6 +1012,10 @@ export type ConfigFieldWithValue = (ConfigTextField & {
     readonly value: unknown;
 }) | (ConfigDeviceMultiSelectField & {
     readonly value: unknown;
+}) | (ConfigNotificationTargetSelectField & {
+    readonly value: unknown;
+}) | (ConfigNotificationTargetMultiSelectField & {
+    readonly value: unknown;
 }) | ConfigWidgetField | (ConfigAddonActionSelectField & {
     readonly value: unknown;
 }) | ConfigAddonActionButtonField | ConfigDeviceActionButtonField;

package/dist/notification/alarm-membership.d.ts

@@ -42,6 +42,8 @@ export interface NcAlarmMembershipSubject {
      */
     readonly sequenceActionsOf?: (sequenceId: string) => readonly NcRuleAction[] | undefined;
 }
+/** True when the rule's deviceState gate names any `armed_*` word. */
+export declare function ruleGatedOnArmedState(rule: NcAlarmMembershipSubject): boolean;
 /**
  * A rule belongs to the alarm when its `deviceState` gate names ANY device's
  * `armed_*` word, or an on-match binding pulls the alarm panel's trigger
@@ -49,6 +51,13 @@ export interface NcAlarmMembershipSubject {
  * escalation.
  */
 export declare function ruleBelongsToAlarm(rule: NcAlarmMembershipSubject): boolean;
+/**
+ * A rule gated on `armed_*` auto-triggers the CamStack `alarm-panel` on match
+ * — no `onTrigger` sequence required. Sirens are never part of this path.
+ * An explicit `alarm-panel.trigger` binding without an armed gate stays
+ * explicit actuation only ({@link ruleBelongsToAlarm}).
+ */
+export declare function ruleAutoTriggersAlarm(rule: NcAlarmMembershipSubject): boolean;
 /** Copy the editors show when {@link sensorTransitionNeverFires} is true. */
 export declare const NC_SENSOR_TRANSITION_NEVER_FIRES_WARNING = "This rule belongs to the alarm, and an alarm rule fires only when an opening OPENS. Set to \u201Conly when it clears\u201D, it can never fire.";
 /**

package/dist/notification/alarm-profiles.d.ts

@@ -14,11 +14,12 @@ import type { NcAlarmSettings } from '../capabilities/notification-rules.cap.js'
 /** Stable id of the always-present Default profile (migrated from flat settings). */
 export declare const NC_ALARM_DEFAULT_PROFILE_ID = "default";
 export declare const NC_ALARM_DEFAULT_PROFILE_NAME = "Default";
-/** Stock delays — same numbers the panel shipped with before any editor existed. */
+/** Stock delays — re-arm 10 s after trigger (inherited by every mode). */
 export declare const NC_ALARM_SYSTEM_DEFAULT_DELAYS: {
-    readonly exitDelaySec: 30;
-    readonly entryDelaySec: 20;
-    readonly triggeredDurationSec: 0;
+    exitDelaySec: number;
+    entryDelaySec: number;
+    triggeredDurationSec: number;
+    postTriggeredAction: "rearmAfter";
 };
 /** Empty memberships + stock delays + no announce targets. */
 export declare function ncAlarmSystemDefaultSettings(): NcAlarmSettings;

package/dist/notification/alarm-settings.d.ts

@@ -5,15 +5,21 @@
  * The engine and both clients call these; nobody re-implements them. No I/O, no clock.
  */
 import type { AlarmArmMode } from '../capabilities/alarm-panel.cap.js';
-import { type NcAlarmBlocking, type NcAlarmBlockingEdit, type NcAlarmModeDelays, type NcAlarmModeDelaysEdit, type NcAlarmModeDeviceList, type NcAlarmNonBlocking, type NcAlarmNonBlockingEdit, type NcAlarmSecureOnArmEdit, type NcAlarmSecureOnArmOff, type NcAlarmSettings, type NcAlarmSettingsPatch } from '../capabilities/notification-rules.cap.js';
+import { type NcAlarmBlocking, type NcAlarmBlockingEdit, type NcAlarmModeDelays, type NcAlarmModeDelaysEdit, type NcAlarmModeDeviceList, type NcAlarmNonBlocking, type NcAlarmNonBlockingEdit, type NcAlarmPostTriggeredAction, type NcAlarmSecureOnArmEdit, type NcAlarmSecureOnArmOff, type NcAlarmSettings, type NcAlarmSettingsPatch } from '../capabilities/notification-rules.cap.js';
 export type NcAlarmDelayField = 'exitDelaySec' | 'entryDelaySec' | 'triggeredDurationSec';
 export declare const NC_ALARM_DELAY_FIELDS: readonly NcAlarmDelayField[];
 export type NcAlarmDelaySource = 'mode' | 'default';
+/**
+ * Derive the post-triggered action from a stored blob that may predate the field:
+ * a positive duration meant re-arm; zero/absent meant stay triggered.
+ */
+export declare function derivePostTriggeredAction(action: NcAlarmPostTriggeredAction | undefined, triggeredDurationSec: number): NcAlarmPostTriggeredAction;
 export interface NcAlarmResolvedDelays {
     readonly exitDelaySec: number;
     readonly entryDelaySec: number;
     readonly triggeredDurationSec: number;
-    readonly source: Readonly<Record<NcAlarmDelayField, NcAlarmDelaySource>>;
+    readonly postTriggeredAction: NcAlarmPostTriggeredAction;
+    readonly source: Readonly<Record<NcAlarmDelayField | 'postTriggeredAction', NcAlarmDelaySource>>;
 }
 /**
  * A settings answer as it travels on the wire. Clients do not parse answers, so a hub older
@@ -27,7 +33,7 @@ export type NcAlarmSettingsAnswer = Omit<NcAlarmSettings, 'modeDelays' | 'nonBlo
     readonly blocking?: readonly NcAlarmBlocking[];
     readonly secureOnArmOff?: readonly NcAlarmSecureOnArmOff[];
 };
-export type NcAlarmDelaySettings = Pick<NcAlarmSettingsAnswer, NcAlarmDelayField | 'modeDelays'>;
+export type NcAlarmDelaySettings = Pick<NcAlarmSettingsAnswer, NcAlarmDelayField | 'modeDelays' | 'postTriggeredAction'>;
 /** What `mode` actually runs on: its own overrides, the global value for every other field. */
 export declare function resolveModeDelays(settings: NcAlarmDelaySettings, mode: AlarmArmMode): NcAlarmResolvedDelays;
 /**

package/dist/notification/system-event-summary.d.ts

@@ -80,6 +80,19 @@ export declare function scheduleForSendTimes(times: readonly NcSummarySendTime[]
  * the raw windows and says the summary is sent when each one ENDS.
  */
 export declare function sendTimesOfSchedule(schedule: NcSchedule): readonly NcSummarySendTime[] | null;
+/**
+ * Punctual times for a `mode: 'times'` editor.
+ *
+ * Exact one-minute windows win. Otherwise each window's END is the fire time
+ * (summary delivery fires when a window closes) — so a legacy 17:00→18:00 band
+ * authored as a range still opens as a single "At 18:00" row instead of two
+ * clocks. `null` only when inverted (cannot map to punctual rows).
+ */
+export declare function sendTimesForEditor(schedule: NcSchedule): {
+    readonly times: readonly NcSummarySendTime[];
+    /** True when at least one window was longer than one minute. */
+    readonly approximated: boolean;
+} | null;
 /**
  * Does a custom BODY carry the summary's content (`{{summaryText}}` or a
  * section variable)? A body that does not would send a summary with nothing