@camstack/types 1.2.299 → 1.2.302

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/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