@vokril/ui-solid 0.33.5 → 0.35.0

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 (95) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +40 -0
  3. package/dist/Alert-DCIet3Ol.cjs +1 -0
  4. package/dist/Alert-DyBaU25r.js +59 -0
  5. package/dist/Badge-BXLrs2z-.cjs +1 -0
  6. package/dist/Badge-BguTObKo.js +99 -0
  7. package/dist/CommandPalette-3wKYPO9u.cjs +2 -0
  8. package/dist/CommandPalette-BnZwM7DE.js +4130 -0
  9. package/dist/PageSkeleton-3f-2SBNK.cjs +30 -0
  10. package/dist/{PageSkeleton-BRuqaDzr.js → PageSkeleton-lfENszyc.js} +516 -569
  11. package/dist/{StatusBarNotificationBell-DE1jIaBt.js → StatusBarNotificationBell-GbkAwC4w.js} +4242 -4154
  12. package/dist/StatusBarNotificationBell-fegn26_s.cjs +53 -0
  13. package/dist/_internal/contract/browser/workspace.d.cts +5 -0
  14. package/dist/_internal/contract/browser/workspace.d.ts +5 -0
  15. package/dist/_internal/contract/notification.d.cts +30 -4
  16. package/dist/_internal/contract/notification.d.ts +30 -4
  17. package/dist/_internal/contract/notificationCatalog.d.cts +15 -1
  18. package/dist/_internal/contract/notificationCatalog.d.ts +15 -1
  19. package/dist/feedback/index.cjs +1 -1
  20. package/dist/feedback/index.js +38 -36
  21. package/dist/index.cjs +1 -1
  22. package/dist/index.js +430 -428
  23. package/dist/notificationCatalog-DmwTAO09.cjs +1 -0
  24. package/dist/notificationCatalog-otJ1LHFH.js +72 -0
  25. package/dist/notifications/createNotificationPreviewRuntime.d.cts +1 -0
  26. package/dist/notifications/createNotificationPreviewRuntime.d.ts +1 -0
  27. package/dist/notifications/fireNotification.d.cts +14 -7
  28. package/dist/notifications/fireNotification.d.ts +14 -7
  29. package/dist/notifications/index.cjs +1 -1
  30. package/dist/notifications/index.js +2 -2
  31. package/dist/notifications/nativeEngine.d.cts +8 -1
  32. package/dist/notifications/nativeEngine.d.ts +8 -1
  33. package/dist/notifications/notificationService.d.cts +2 -1
  34. package/dist/notifications/notificationService.d.ts +2 -1
  35. package/dist/notifications/notifications.notifications.d.cts +0 -1
  36. package/dist/notifications/notifications.notifications.d.ts +0 -1
  37. package/dist/notifications/toast.d.cts +19 -3
  38. package/dist/notifications/toast.d.ts +19 -3
  39. package/dist/notifications/toastFilterPolicy.d.cts +15 -1
  40. package/dist/notifications/toastFilterPolicy.d.ts +15 -1
  41. package/dist/overlay/ConfirmDialog.d.cts +36 -0
  42. package/dist/overlay/ConfirmDialog.d.ts +36 -0
  43. package/dist/overlay/dialogNudge.d.cts +16 -0
  44. package/dist/overlay/dialogNudge.d.ts +16 -0
  45. package/dist/overlay/index.cjs +1 -1
  46. package/dist/overlay/index.js +1 -1
  47. package/dist/server/Alert-DWGobTUk.js +45 -0
  48. package/dist/server/Alert-DulmzLv9.cjs +1 -0
  49. package/dist/server/Badge-C1Jn--DR.js +68 -0
  50. package/dist/server/Badge-wsDCVlA8.cjs +1 -0
  51. package/dist/server/CommandPalette-B3EE1iMo.js +3376 -0
  52. package/dist/server/CommandPalette-DKURJBBZ.cjs +1 -0
  53. package/dist/server/PageSkeleton-CP8EmxyS.cjs +30 -0
  54. package/dist/server/{PageSkeleton-CFs7AdTA.js → PageSkeleton-HhO6CRZ8.js} +392 -431
  55. package/dist/server/{StatusBarNotificationBell-y5cPAlMY.js → StatusBarNotificationBell-BfBGKXDG.js} +4256 -4168
  56. package/dist/server/StatusBarNotificationBell-CB919YAX.cjs +52 -0
  57. package/dist/server/feedback/index.cjs +1 -1
  58. package/dist/server/feedback/index.js +38 -36
  59. package/dist/server/index.cjs +1 -1
  60. package/dist/server/index.js +294 -292
  61. package/dist/server/notificationCatalog-BKcY-o-R.js +57 -0
  62. package/dist/server/notificationCatalog-DR3ZggWn.cjs +1 -0
  63. package/dist/server/notifications/index.cjs +1 -1
  64. package/dist/server/notifications/index.js +2 -2
  65. package/dist/server/overlay/index.cjs +1 -1
  66. package/dist/server/overlay/index.js +1 -1
  67. package/dist/solid/notifications/NotificationItem.jsx +4 -3
  68. package/dist/solid/notifications/catalogAdapter.js +8 -9
  69. package/dist/solid/notifications/createNotificationPreviewRuntime.js +34 -18
  70. package/dist/solid/notifications/fireNotification.js +9 -5
  71. package/dist/solid/notifications/notificationOverlaySnapshot.js +1 -0
  72. package/dist/solid/notifications/notificationService.js +1 -0
  73. package/dist/solid/notifications/notifications.notifications.js +8 -0
  74. package/dist/solid/notifications/toast.js +70 -31
  75. package/dist/solid/notifications/toastFilterPolicy.js +8 -0
  76. package/dist/solid/overlay/ConfirmDialog.jsx +54 -10
  77. package/dist/solid/overlay/ConfirmDialog.module.css.js +6 -0
  78. package/dist/solid/overlay/DangerousActionDialog.jsx +8 -3
  79. package/dist/solid/overlay/DangerousActionDialog.module.css.js +1 -0
  80. package/dist/solid/overlay/dialogNudge.js +18 -0
  81. package/dist/style.css +1 -1
  82. package/dist/ui.css +1 -1
  83. package/package.json +1 -1
  84. package/dist/CommandPalette-BKa5pT_B.js +0 -4029
  85. package/dist/CommandPalette-Bq5ydWBA.cjs +0 -2
  86. package/dist/PageSkeleton-Cz2bckO4.cjs +0 -30
  87. package/dist/StatusBarNotificationBell-CLrNtOO9.cjs +0 -50
  88. package/dist/notificationCatalog-CRERhjp6.js +0 -168
  89. package/dist/notificationCatalog-DqTkd7M6.cjs +0 -1
  90. package/dist/server/CommandPalette-BU9QCOyy.cjs +0 -1
  91. package/dist/server/CommandPalette-Dj08M64T.js +0 -3305
  92. package/dist/server/PageSkeleton-D0KOKLsb.cjs +0 -30
  93. package/dist/server/StatusBarNotificationBell-fLacxZ0X.cjs +0 -49
  94. package/dist/server/notificationCatalog-CEDltsJS.cjs +0 -1
  95. package/dist/server/notificationCatalog-Cl1dH4aJ.js +0 -122
@@ -0,0 +1 @@
1
+ "use strict";const s=require("solid-js/web"),z="vk_track_8sxq6",k="vk_size2xs_PFVQU",g="vk_sizeXs_uv795",S="vk_sizeSm_PXflS",b="vk_sizeMd_D7fn9",x="vk_fill_WzdHy",N="vk_toneBrand_Tv6r-",h="vk_toneSuccess_zqjLa",A="vk_toneWarning_xuA11",M="vk_toneDanger_eWHhk",y="vk_toneNeutral_-Ko2R",D="vk_indeterminate_94QkD",i={track:z,size2xs:k,sizeXs:g,sizeSm:S,sizeMd:b,fill:x,toneBrand:N,toneSuccess:h,toneWarning:A,toneDanger:M,toneNeutral:y,indeterminate:D};var W=s.template("<div role=progressbar><span>");const X={brand:i.toneBrand,success:i.toneSuccess,warning:i.toneWarning,danger:i.toneDanger,neutral:i.toneNeutral},B={"2xs":i.size2xs,xs:i.sizeXs,sm:i.sizeSm,md:i.sizeMd};function L(t){const a=()=>{if(t.indeterminate)return 0;const n=t.max??100;return n<=0?0:Math.max(0,Math.min(100,t.value/n*100))},r=()=>t.indeterminate===!0;return(()=>{var n=W(),o=n.firstChild;return s.effect(e=>{var c=`${i.track} ${B[t.size??"md"]} ${X[t.tone??"brand"]} ${r()?i.indeterminate:""} ${t.class??""}`,v=r()?void 0:Math.round(a()),d=r()?void 0:0,u=r()?void 0:100,l=r()?"true":void 0,m=t.ariaLabel,f=i.fill,_=r()?void 0:{"--progress-pct":`${a()}%`};return c!==e.e&&s.className(n,e.e=c),v!==e.t&&s.setAttribute(n,"aria-valuenow",e.t=v),d!==e.a&&s.setAttribute(n,"aria-valuemin",e.a=d),u!==e.o&&s.setAttribute(n,"aria-valuemax",e.o=u),l!==e.i&&s.setAttribute(n,"aria-busy",e.i=l),m!==e.n&&s.setAttribute(n,"aria-label",e.n=m),f!==e.s&&s.className(o,e.s=f),e.h=s.style(o,_,e.h),e},{e:void 0,t:void 0,a:void 0,o:void 0,i:void 0,n:void 0,s:void 0,h:void 0}),n})()}function P(t,a){return{...t,category:t.category??t.id.split(".")[0]??"general",build:a}}function q(t,a,r){return{id:t,notification:a,resolve:n=>a.build(r,n)}}exports.Progress=L;exports.defineNotification=P;exports.defineNotificationScenario=q;
@@ -0,0 +1,72 @@
1
+ import { effect as k, className as z, setAttribute as r, style as g, template as S } from "solid-js/web";
2
+ const x = "vk_track_8sxq6", b = "vk_size2xs_PFVQU", h = "vk_sizeXs_uv795", N = "vk_sizeSm_PXflS", M = "vk_sizeMd_D7fn9", y = "vk_fill_WzdHy", D = "vk_toneBrand_Tv6r-", W = "vk_toneSuccess_zqjLa", X = "vk_toneWarning_xuA11", A = "vk_toneDanger_eWHhk", B = "vk_toneNeutral_-Ko2R", L = "vk_indeterminate_94QkD", i = {
3
+ track: x,
4
+ size2xs: b,
5
+ sizeXs: h,
6
+ sizeSm: N,
7
+ sizeMd: M,
8
+ fill: y,
9
+ toneBrand: D,
10
+ toneSuccess: W,
11
+ toneWarning: X,
12
+ toneDanger: A,
13
+ toneNeutral: B,
14
+ indeterminate: L
15
+ };
16
+ var P = /* @__PURE__ */ S("<div role=progressbar><span>");
17
+ const C = {
18
+ brand: i.toneBrand,
19
+ success: i.toneSuccess,
20
+ warning: i.toneWarning,
21
+ danger: i.toneDanger,
22
+ neutral: i.toneNeutral
23
+ }, q = {
24
+ "2xs": i.size2xs,
25
+ xs: i.sizeXs,
26
+ sm: i.sizeSm,
27
+ md: i.sizeMd
28
+ };
29
+ function E(n) {
30
+ const a = () => {
31
+ if (n.indeterminate) return 0;
32
+ const t = n.max ?? 100;
33
+ return t <= 0 ? 0 : Math.max(0, Math.min(100, n.value / t * 100));
34
+ }, s = () => n.indeterminate === !0;
35
+ return (() => {
36
+ var t = P(), o = t.firstChild;
37
+ return k((e) => {
38
+ var c = `${i.track} ${q[n.size ?? "md"]} ${C[n.tone ?? "brand"]} ${s() ? i.indeterminate : ""} ${n.class ?? ""}`, v = s() ? void 0 : Math.round(a()), d = s() ? void 0 : 0, l = s() ? void 0 : 100, u = s() ? "true" : void 0, m = n.ariaLabel, _ = i.fill, f = s() ? void 0 : {
39
+ "--progress-pct": `${a()}%`
40
+ };
41
+ return c !== e.e && z(t, e.e = c), v !== e.t && r(t, "aria-valuenow", e.t = v), d !== e.a && r(t, "aria-valuemin", e.a = d), l !== e.o && r(t, "aria-valuemax", e.o = l), u !== e.i && r(t, "aria-busy", e.i = u), m !== e.n && r(t, "aria-label", e.n = m), _ !== e.s && z(o, e.s = _), e.h = g(o, f, e.h), e;
42
+ }, {
43
+ e: void 0,
44
+ t: void 0,
45
+ a: void 0,
46
+ o: void 0,
47
+ i: void 0,
48
+ n: void 0,
49
+ s: void 0,
50
+ h: void 0
51
+ }), t;
52
+ })();
53
+ }
54
+ function H(n, a) {
55
+ return {
56
+ ...n,
57
+ category: n.category ?? n.id.split(".")[0] ?? "general",
58
+ build: a
59
+ };
60
+ }
61
+ function Q(n, a, s) {
62
+ return {
63
+ id: n,
64
+ notification: a,
65
+ resolve: (t) => a.build(s, t)
66
+ };
67
+ }
68
+ export {
69
+ E as P,
70
+ Q as a,
71
+ H as d
72
+ };
@@ -10,6 +10,7 @@ import type { NotificationItemController } from './NotificationItem.cjs';
10
10
  export interface NotificationPreviewDelivery {
11
11
  readonly definition: NotificationCatalogMetadata;
12
12
  readonly payload: NotificationCatalogPayload;
13
+ /** The channel the notification took: its definition's `delivery`, `in-app-only` for a `user-action` one. */
13
14
  readonly channel: NotificationDelivery;
14
15
  readonly decision: FilterDecision;
15
16
  readonly outcome: 'shown' | 'timeline-only' | 'suppressed' | 'mock-os' | 'spam-dropped';
@@ -10,6 +10,7 @@ import type { NotificationItemController } from './NotificationItem.js';
10
10
  export interface NotificationPreviewDelivery {
11
11
  readonly definition: NotificationCatalogMetadata;
12
12
  readonly payload: NotificationCatalogPayload;
13
+ /** The channel the notification took: its definition's `delivery`, `in-app-only` for a `user-action` one. */
13
14
  readonly channel: NotificationDelivery;
14
15
  readonly decision: FilterDecision;
15
16
  readonly outcome: 'shown' | 'timeline-only' | 'suppressed' | 'mock-os' | 'spam-dropped';
@@ -21,7 +21,7 @@ import type { WebhookDelivery } from './webhookDelivery.cjs';
21
21
  import type { EmailDigest } from './emailDigest.cjs';
22
22
  import type { NotificationAnalytics } from './notificationAnalytics.cjs';
23
23
  import { type NativeNotificationEngine, type NotificationSeverity, type NotificationAction as NativeAction, type NotificationHandle, type NotificationInput } from './nativeEngine.cjs';
24
- import type { NotificationPriority, NotificationSourceId, ToastAction, ToastCommonOptions } from '../_internal/contract/notification.cjs';
24
+ import type { NotificationOrigin, NotificationPriority, NotificationSourceId, ToastAction, ToastCommonOptions } from '../_internal/contract/notification.cjs';
25
25
  import type { VendorErrorRef } from '../_internal/contract/vendorErrorRef.cjs';
26
26
  export type { FilterDecision };
27
27
  /** Where a fired notification goes — the sinks of one notification service. */
@@ -51,11 +51,13 @@ export interface IssueDecisionInput extends IssueKeys {
51
51
  readonly recordTimeline: boolean | undefined;
52
52
  /** The realm's run-time filter at the issue (`Notifications.getFilter`). */
53
53
  readonly filter: NotificationFilter;
54
+ /** Whom the issue answers (`ToastCommonOptions.origin`); a `user-action` one is always shown. */
55
+ readonly origin?: NotificationOrigin | undefined;
54
56
  }
55
57
  /**
56
58
  * The filter decision with its gates computed: the pure policy takes the suppression answers as
57
59
  * precomputed booleans, and they are asked here, in one place. The run-time filter decides through the
58
- * priority ({@link filteredPriority}).
60
+ * priority ({@link filteredPriority}); a `user-action` issue passes it as it passes the settings.
59
61
  */
60
62
  export declare function decideFilter(issue: IssueDecisionInput): FilterDecision;
61
63
  /**
@@ -68,9 +70,10 @@ export declare function turnedDownOnCard(source: string, title: string, keys: Is
68
70
  * Whether the user turned a shown card's notification down — the keys its gear menu writes (`NotificationItem`):
69
71
  * "don't show again" on its `neverShowAgainKey`, "remind me later" on the card's remind key ({@link cardRemindKey}).
70
72
  * The engine ends a running card the user closes under such a choice instead of sending it to the notification center
71
- * (`NativeNotificationEngineDependencies.isTurnedDown`).
73
+ * (`NativeNotificationEngineDependencies.isTurnedDown`). A `user-action` card is never turned down: its menu offers
74
+ * neither choice, and one made on another card of its key or text does not reach it, as it does not reach its issue.
72
75
  */
73
- export declare function turnedDownCard(item: Pick<NotificationInput, 'neverShowAgainKey' | 'remindKey' | 'source' | 'title'>): boolean;
76
+ export declare function turnedDownCard(item: Pick<NotificationInput, 'neverShowAgainKey' | 'remindKey' | 'source' | 'title' | 'origin'>): boolean;
74
77
  /**
75
78
  * Whether the notification settings — and the realm's run-time filter — now keep a card of this source, severity and
76
79
  * priority off the screen: an issue's decision without the per-key choices. "Don't show again" and "remind me later"
@@ -86,13 +89,17 @@ export declare function silencedBySettings(source: string, severity: Notificatio
86
89
  export declare function nativeActionsOf(sinks: NotificationSinks, primary: ToastAction | undefined, others: readonly ToastAction[] | undefined, cardId: () => string | undefined, source: string): NativeAction[];
87
90
  /**
88
91
  * A card's presentation from a verb's options — one mapping for the message verbs and the progress, so a progress no
89
- * longer drops what its catalog payload carries and the catalog preview paints: the body, markdown, icon,
90
- * announcement, page, duration, "don't show again" key and the issuer's remind key.
92
+ * longer drops what its catalog payload carries and the catalog preview paints: markdown, icon, announcement, page,
93
+ * duration, "don't show again" key, the issuer's remind key and whom the card answers. The title line and the body are
94
+ * the verb's (`cardLines`): the message, the `title`, the description and an error's vendor code make them.
91
95
  */
92
- export declare function cardPresentation(options: ToastCommonOptions): Pick<NotificationInput, 'body' | 'markdown' | 'durationMs' | 'neverShowAgainKey' | 'remindKey' | 'icon' | 'announce' | 'defaultRoute'>;
96
+ export declare function cardPresentation(options: ToastCommonOptions): Pick<NotificationInput, 'markdown' | 'durationMs' | 'neverShowAgainKey' | 'remindKey' | 'icon' | 'announce' | 'defaultRoute' | 'origin'>;
93
97
  export interface FireOptions {
94
98
  severity: NotificationSeverity;
99
+ /** The card's title line. */
95
100
  title: string;
101
+ /** The card's body — under it, the external channels' body. */
102
+ body: string | undefined;
96
103
  options: ToastCommonOptions;
97
104
  decision: FilterDecision;
98
105
  primaryAction?: ToastAction;
@@ -21,7 +21,7 @@ import type { WebhookDelivery } from './webhookDelivery.js';
21
21
  import type { EmailDigest } from './emailDigest.js';
22
22
  import type { NotificationAnalytics } from './notificationAnalytics.js';
23
23
  import { type NativeNotificationEngine, type NotificationSeverity, type NotificationAction as NativeAction, type NotificationHandle, type NotificationInput } from './nativeEngine.js';
24
- import type { NotificationPriority, NotificationSourceId, ToastAction, ToastCommonOptions } from '../_internal/contract/notification.js';
24
+ import type { NotificationOrigin, NotificationPriority, NotificationSourceId, ToastAction, ToastCommonOptions } from '../_internal/contract/notification.js';
25
25
  import type { VendorErrorRef } from '../_internal/contract/vendorErrorRef.js';
26
26
  export type { FilterDecision };
27
27
  /** Where a fired notification goes — the sinks of one notification service. */
@@ -51,11 +51,13 @@ export interface IssueDecisionInput extends IssueKeys {
51
51
  readonly recordTimeline: boolean | undefined;
52
52
  /** The realm's run-time filter at the issue (`Notifications.getFilter`). */
53
53
  readonly filter: NotificationFilter;
54
+ /** Whom the issue answers (`ToastCommonOptions.origin`); a `user-action` one is always shown. */
55
+ readonly origin?: NotificationOrigin | undefined;
54
56
  }
55
57
  /**
56
58
  * The filter decision with its gates computed: the pure policy takes the suppression answers as
57
59
  * precomputed booleans, and they are asked here, in one place. The run-time filter decides through the
58
- * priority ({@link filteredPriority}).
60
+ * priority ({@link filteredPriority}); a `user-action` issue passes it as it passes the settings.
59
61
  */
60
62
  export declare function decideFilter(issue: IssueDecisionInput): FilterDecision;
61
63
  /**
@@ -68,9 +70,10 @@ export declare function turnedDownOnCard(source: string, title: string, keys: Is
68
70
  * Whether the user turned a shown card's notification down — the keys its gear menu writes (`NotificationItem`):
69
71
  * "don't show again" on its `neverShowAgainKey`, "remind me later" on the card's remind key ({@link cardRemindKey}).
70
72
  * The engine ends a running card the user closes under such a choice instead of sending it to the notification center
71
- * (`NativeNotificationEngineDependencies.isTurnedDown`).
73
+ * (`NativeNotificationEngineDependencies.isTurnedDown`). A `user-action` card is never turned down: its menu offers
74
+ * neither choice, and one made on another card of its key or text does not reach it, as it does not reach its issue.
72
75
  */
73
- export declare function turnedDownCard(item: Pick<NotificationInput, 'neverShowAgainKey' | 'remindKey' | 'source' | 'title'>): boolean;
76
+ export declare function turnedDownCard(item: Pick<NotificationInput, 'neverShowAgainKey' | 'remindKey' | 'source' | 'title' | 'origin'>): boolean;
74
77
  /**
75
78
  * Whether the notification settings — and the realm's run-time filter — now keep a card of this source, severity and
76
79
  * priority off the screen: an issue's decision without the per-key choices. "Don't show again" and "remind me later"
@@ -86,13 +89,17 @@ export declare function silencedBySettings(source: string, severity: Notificatio
86
89
  export declare function nativeActionsOf(sinks: NotificationSinks, primary: ToastAction | undefined, others: readonly ToastAction[] | undefined, cardId: () => string | undefined, source: string): NativeAction[];
87
90
  /**
88
91
  * A card's presentation from a verb's options — one mapping for the message verbs and the progress, so a progress no
89
- * longer drops what its catalog payload carries and the catalog preview paints: the body, markdown, icon,
90
- * announcement, page, duration, "don't show again" key and the issuer's remind key.
92
+ * longer drops what its catalog payload carries and the catalog preview paints: markdown, icon, announcement, page,
93
+ * duration, "don't show again" key, the issuer's remind key and whom the card answers. The title line and the body are
94
+ * the verb's (`cardLines`): the message, the `title`, the description and an error's vendor code make them.
91
95
  */
92
- export declare function cardPresentation(options: ToastCommonOptions): Pick<NotificationInput, 'body' | 'markdown' | 'durationMs' | 'neverShowAgainKey' | 'remindKey' | 'icon' | 'announce' | 'defaultRoute'>;
96
+ export declare function cardPresentation(options: ToastCommonOptions): Pick<NotificationInput, 'markdown' | 'durationMs' | 'neverShowAgainKey' | 'remindKey' | 'icon' | 'announce' | 'defaultRoute' | 'origin'>;
93
97
  export interface FireOptions {
94
98
  severity: NotificationSeverity;
99
+ /** The card's title line. */
95
100
  title: string;
101
+ /** The card's body — under it, the external channels' body. */
102
+ body: string | undefined;
96
103
  options: ToastCommonOptions;
97
104
  decision: FilterDecision;
98
105
  primaryAction?: ToastAction;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../StatusBarNotificationBell-CLrNtOO9.cjs"),e=require("../notificationCatalog-DqTkd7M6.cjs"),t=require("../useSettingsSubscription-DKjCwmRd.cjs");exports.ACCEPT_PRIMARY_ACTION_NOTIFICATION=i.ACCEPT_PRIMARY_ACTION_NOTIFICATION;exports.CLEAR_NOTIFICATION=i.CLEAR_NOTIFICATION;exports.HIDE_NOTIFICATION_TOASTS=i.HIDE_NOTIFICATION_TOASTS;exports.LogFilterBar=i.LogFilterBar;exports.NOTIFICATION_SOURCES=i.NOTIFICATION_SOURCES;exports.NOTIFICATION_SOURCE_IDS=i.NOTIFICATION_SOURCE_IDS;exports.NO_NOTIFICATION_OVERLAY=i.NO_NOTIFICATION_OVERLAY;exports.NotificationHost=i.NotificationHost;exports.NotificationItem=i.NotificationItem;exports.NotificationPanel=i.NotificationPanel;exports.NotificationService=i.NotificationService;exports.NotificationTimeline=i.NotificationTimeline;exports.NotificationsCenter=i.NotificationsCenter;exports.SEVERITY_ORDER=i.SEVERITY_ORDER;exports.SEVERITY_TONES=i.SEVERITY_TONES;exports.StatusBarNotificationBell=i.StatusBarNotificationBell;exports.appWindowNotificationOverlay=i.appWindowNotificationOverlay;exports.applyNotificationRules=i.applyNotificationRules;exports.cardRemindKey=i.cardRemindKey;exports.clearCompiledRuleRegexCache=i.clearCompiledRuleRegexCache;exports.compileNotificationSearchMatcher=i.compileNotificationSearchMatcher;exports.createNativeNotificationEngine=i.createNativeNotificationEngine;exports.createNotificationPreviewRuntime=i.createNotificationPreviewRuntime;exports.decideFilter=i.decideFilter;exports.deleteWebhookUrl=i.deleteWebhookUrl;exports.deriveImplicitRemindKey=i.deriveImplicitRemindKey;exports.dismissKey=i.dismissKey;exports.dismissableToastIds=i.dismissableToastIds;exports.entryVendorMatch=i.entryVendorMatch;exports.exportTimelineAsCsv=i.exportTimelineAsCsv;exports.exportTimelineAsJson=i.exportTimelineAsJson;exports.filterNotificationTimeline=i.filterNotificationTimeline;exports.filteredPriority=i.filteredPriority;exports.focusFirstNotificationEntry=i.focusFirstNotificationEntry;exports.getSmtpPass=i.getSmtpPass;exports.getWebhookUrl=i.getWebhookUrl;exports.groupTimelineEntries=i.groupTimelineEntries;exports.hiddenRunningProgress=i.hiddenRunningProgress;exports.isInQuietHours=i.isInQuietHours;exports.isKeyDismissed=i.isKeyDismissed;exports.isKeyRemindSuppressed=i.isKeyRemindSuppressed;exports.isNotificationSourceId=i.isNotificationSourceId;exports.isNotificationSticky=i.isNotificationSticky;exports.isOnToastStack=i.isOnToastStack;exports.isProgressRunning=i.isProgressRunning;exports.isSourceMuted=i.isSourceMuted;exports.isSpamDropHandle=i.isSpamDropHandle;exports.listNotificationSources=i.listNotificationSources;exports.nextQuietHoursStart=i.nextQuietHoursStart;exports.pruneOrphanWebhookSecrets=i.pruneOrphanWebhookSecrets;exports.registerFenceAliases=i.registerFenceAliases;exports.registerNotificationCommands=i.registerNotificationCommands;exports.remindLater=i.remindLater;exports.resolveCatalogPreviewPriority=i.resolveCatalogPreviewPriority;exports.resolveNotificationDuration=i.resolveNotificationDuration;exports.resolveNotificationSource=i.resolveNotificationSource;exports.resolveSeverityTone=i.resolveSeverityTone;exports.restoreAllKeys=i.restoreAllKeys;exports.restoreKey=i.restoreKey;exports.setSmtpPass=i.setSmtpPass;exports.setSourceMuted=i.setSourceMuted;exports.setWebhookUrl=i.setWebhookUrl;exports.shouldFireOsNative=i.shouldFireOsNative;exports.toTimelineActions=i.toTimelineActions;exports.unmuteAllSources=i.unmuteAllSources;exports.defineNotification=e.defineNotification;exports.defineNotificationScenario=e.defineNotificationScenario;exports.notificationSettings=t.notificationSettings;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../StatusBarNotificationBell-fegn26_s.cjs"),e=require("../notificationCatalog-DmwTAO09.cjs"),t=require("../useSettingsSubscription-DKjCwmRd.cjs");exports.ACCEPT_PRIMARY_ACTION_NOTIFICATION=i.ACCEPT_PRIMARY_ACTION_NOTIFICATION;exports.CLEAR_NOTIFICATION=i.CLEAR_NOTIFICATION;exports.HIDE_NOTIFICATION_TOASTS=i.HIDE_NOTIFICATION_TOASTS;exports.LogFilterBar=i.LogFilterBar;exports.NOTIFICATION_SOURCES=i.NOTIFICATION_SOURCES;exports.NOTIFICATION_SOURCE_IDS=i.NOTIFICATION_SOURCE_IDS;exports.NO_NOTIFICATION_OVERLAY=i.NO_NOTIFICATION_OVERLAY;exports.NotificationHost=i.NotificationHost;exports.NotificationItem=i.NotificationItem;exports.NotificationPanel=i.NotificationPanel;exports.NotificationService=i.NotificationService;exports.NotificationTimeline=i.NotificationTimeline;exports.NotificationsCenter=i.NotificationsCenter;exports.SEVERITY_ORDER=i.SEVERITY_ORDER;exports.SEVERITY_TONES=i.SEVERITY_TONES;exports.StatusBarNotificationBell=i.StatusBarNotificationBell;exports.appWindowNotificationOverlay=i.appWindowNotificationOverlay;exports.applyNotificationRules=i.applyNotificationRules;exports.cardRemindKey=i.cardRemindKey;exports.clearCompiledRuleRegexCache=i.clearCompiledRuleRegexCache;exports.compileNotificationSearchMatcher=i.compileNotificationSearchMatcher;exports.createNativeNotificationEngine=i.createNativeNotificationEngine;exports.createNotificationPreviewRuntime=i.createNotificationPreviewRuntime;exports.decideFilter=i.decideFilter;exports.deleteWebhookUrl=i.deleteWebhookUrl;exports.deriveImplicitRemindKey=i.deriveImplicitRemindKey;exports.dismissKey=i.dismissKey;exports.dismissableToastIds=i.dismissableToastIds;exports.entryVendorMatch=i.entryVendorMatch;exports.exportTimelineAsCsv=i.exportTimelineAsCsv;exports.exportTimelineAsJson=i.exportTimelineAsJson;exports.filterNotificationTimeline=i.filterNotificationTimeline;exports.filteredPriority=i.filteredPriority;exports.focusFirstNotificationEntry=i.focusFirstNotificationEntry;exports.getSmtpPass=i.getSmtpPass;exports.getWebhookUrl=i.getWebhookUrl;exports.groupTimelineEntries=i.groupTimelineEntries;exports.hiddenRunningProgress=i.hiddenRunningProgress;exports.isInQuietHours=i.isInQuietHours;exports.isKeyDismissed=i.isKeyDismissed;exports.isKeyRemindSuppressed=i.isKeyRemindSuppressed;exports.isNotificationSourceId=i.isNotificationSourceId;exports.isNotificationSticky=i.isNotificationSticky;exports.isOnToastStack=i.isOnToastStack;exports.isProgressRunning=i.isProgressRunning;exports.isSourceMuted=i.isSourceMuted;exports.isSpamDropHandle=i.isSpamDropHandle;exports.listNotificationSources=i.listNotificationSources;exports.nextQuietHoursStart=i.nextQuietHoursStart;exports.pruneOrphanWebhookSecrets=i.pruneOrphanWebhookSecrets;exports.registerFenceAliases=i.registerFenceAliases;exports.registerNotificationCommands=i.registerNotificationCommands;exports.remindLater=i.remindLater;exports.resolveCatalogPreviewPriority=i.resolveCatalogPreviewPriority;exports.resolveNotificationDuration=i.resolveNotificationDuration;exports.resolveNotificationSource=i.resolveNotificationSource;exports.resolveSeverityTone=i.resolveSeverityTone;exports.restoreAllKeys=i.restoreAllKeys;exports.restoreKey=i.restoreKey;exports.setSmtpPass=i.setSmtpPass;exports.setSourceMuted=i.setSourceMuted;exports.setWebhookUrl=i.setWebhookUrl;exports.shouldFireOsNative=i.shouldFireOsNative;exports.toTimelineActions=i.toTimelineActions;exports.unmuteAllSources=i.unmuteAllSources;exports.defineNotification=e.defineNotification;exports.defineNotificationScenario=e.defineNotificationScenario;exports.notificationSettings=t.notificationSettings;
@@ -1,5 +1,5 @@
1
- import { A as e, C as s, H as t, L as o, N as r, a as n, b as c, c as l, d as N, e as f, f as d, g as I, h as S, S as T, i as m, j as u, k as O, l as p, m as R, n as A, o as C, p as y, q as E, r as g, s as v, t as _, u as h, v as F, w as P, x, y as K, z as k, B as D, D as b, E as H, F as M, G as U, I as W, J as L, K as V, M as Y, O as w, P as B, Q, R as J, T as j, U as q, V as z, W as G, X, Y as Z, Z as $, _ as ii, $ as ai, a0 as ei, a1 as si, a2 as ti, a3 as oi, a4 as ri, a5 as ni, a6 as ci, a7 as li, a8 as Ni, a9 as fi, aa as di } from "../StatusBarNotificationBell-DE1jIaBt.js";
2
- import { d as Si, a as Ti } from "../notificationCatalog-CRERhjp6.js";
1
+ import { A as e, C as s, H as t, L as o, N as r, a as n, b as c, c as l, d as N, e as f, f as d, g as I, h as S, S as T, i as m, j as u, k as O, l as p, m as R, n as A, o as C, p as y, q as E, r as g, s as v, t as _, u as h, v as F, w as P, x, y as K, z as k, B as D, D as b, E as H, F as M, G as U, I as W, J as L, K as V, M as Y, O as w, P as B, Q, R as J, T as j, U as q, V as z, W as G, X, Y as Z, Z as $, _ as ii, $ as ai, a0 as ei, a1 as si, a2 as ti, a3 as oi, a4 as ri, a5 as ni, a6 as ci, a7 as li, a8 as Ni, a9 as fi, aa as di } from "../StatusBarNotificationBell-GbkAwC4w.js";
2
+ import { d as Si, a as Ti } from "../notificationCatalog-otJ1LHFH.js";
3
3
  import { n as ui } from "../useSettingsSubscription-DLEk4k4j.js";
4
4
  export {
5
5
  e as ACCEPT_PRIMARY_ACTION_NOTIFICATION,
@@ -1,4 +1,4 @@
1
- import type { NotificationAnnouncement, NotificationCardState, NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.cjs';
1
+ import type { NotificationAnnouncement, NotificationCardState, NotificationOrigin, NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.cjs';
2
2
  import type { VendorErrorRef } from '../_internal/contract/vendorErrorRef.cjs';
3
3
  import type { NotificationSettings } from '../_internal/platform/settings/settingsTypes.cjs';
4
4
  import { type Event } from '../_internal/base/event.cjs';
@@ -64,6 +64,13 @@ export interface NotificationInput extends NotificationInputBase {
64
64
  vendorError?: VendorErrorRef;
65
65
  /** How the card is read to a screen reader; unset, the severity decides — an error assertively, the rest politely. */
66
66
  announce?: NotificationAnnouncement;
67
+ /**
68
+ * Whom the card answers; unset, `system`. A `user-action` card — the visible result of the user's own action — is
69
+ * never silenced or taken back by a setting (the notification service's `isSilenced`), is never turned down, and
70
+ * its gear menu offers no choice that would do nothing for it: muting its source, "remind me later", "don't show
71
+ * again".
72
+ */
73
+ origin?: NotificationOrigin;
67
74
  }
68
75
  export interface NotificationItem extends NotificationInput {
69
76
  id: string;
@@ -1,4 +1,4 @@
1
- import type { NotificationAnnouncement, NotificationCardState, NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.js';
1
+ import type { NotificationAnnouncement, NotificationCardState, NotificationOrigin, NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.js';
2
2
  import type { VendorErrorRef } from '../_internal/contract/vendorErrorRef.js';
3
3
  import type { NotificationSettings } from '../_internal/platform/settings/settingsTypes.js';
4
4
  import { type Event } from '../_internal/base/event.js';
@@ -64,6 +64,13 @@ export interface NotificationInput extends NotificationInputBase {
64
64
  vendorError?: VendorErrorRef;
65
65
  /** How the card is read to a screen reader; unset, the severity decides — an error assertively, the rest politely. */
66
66
  announce?: NotificationAnnouncement;
67
+ /**
68
+ * Whom the card answers; unset, `system`. A `user-action` card — the visible result of the user's own action — is
69
+ * never silenced or taken back by a setting (the notification service's `isSilenced`), is never turned down, and
70
+ * its gear menu offers no choice that would do nothing for it: muting its source, "remind me later", "don't show
71
+ * again".
72
+ */
73
+ origin?: NotificationOrigin;
67
74
  }
68
75
  export interface NotificationItem extends NotificationInput {
69
76
  id: string;
@@ -135,7 +135,8 @@ export declare class NotificationService implements Notifications, IDisposable {
135
135
  * — do not disturb, quiet hours, a muted source, the master switch, "urgent to the center only", the run-time filter:
136
136
  * the decision an issue would get now. A running progress is not the settings' to end: it goes to the notification center, its
137
137
  * handles still `open`, as the reference removes the toast and keeps the notification in its center; the other cards
138
- * close and their handles report `suppressed`, the timeline keeping their records.
138
+ * close and their handles report `suppressed`, the timeline keeping their records. The visible result of the user's
139
+ * own action (`origin: 'user-action'`) and an acknowledgment stay where they are.
139
140
  *
140
141
  * The reference reacts to the same moment (`notificationsToasts.ts:143-153`) under its own policy, which the kit
141
142
  * does not share: its do not disturb (the error-only filter) hides every toast, urgent ones and errors too, and a
@@ -135,7 +135,8 @@ export declare class NotificationService implements Notifications, IDisposable {
135
135
  * — do not disturb, quiet hours, a muted source, the master switch, "urgent to the center only", the run-time filter:
136
136
  * the decision an issue would get now. A running progress is not the settings' to end: it goes to the notification center, its
137
137
  * handles still `open`, as the reference removes the toast and keeps the notification in its center; the other cards
138
- * close and their handles report `suppressed`, the timeline keeping their records.
138
+ * close and their handles report `suppressed`, the timeline keeping their records. The visible result of the user's
139
+ * own action (`origin: 'user-action'`) and an acknowledgment stay where they are.
139
140
  *
140
141
  * The reference reacts to the same moment (`notificationsToasts.ts:143-153`) under its own policy, which the kit
141
142
  * does not share: its do not disturb (the error-only filter) hides every toast, urgent ones and errors too, and a
@@ -1,6 +1,5 @@
1
1
  import type { ToastCommonOptions } from '../_internal/contract/notification.cjs';
2
2
  type Options = ToastCommonOptions & {
3
- readonly title?: string;
4
3
  readonly onCancel?: () => void;
5
4
  };
6
5
  export declare const notificationReplayError: import("./index.cjs").NotificationDefinition<{
@@ -1,6 +1,5 @@
1
1
  import type { ToastCommonOptions } from '../_internal/contract/notification.js';
2
2
  type Options = ToastCommonOptions & {
3
- readonly title?: string;
4
3
  readonly onCancel?: () => void;
5
4
  };
6
5
  export declare const notificationReplayError: import("./index.js").NotificationDefinition<{
@@ -14,6 +14,17 @@ import { type NotificationTimeline } from './notificationTimeline.cjs';
14
14
  import { type VendorErrorMatch, type VendorErrorSource } from '../_internal/platform/vendorErrors/index.cjs';
15
15
  import { type NotificationFilter } from './toastFilterPolicy.cjs';
16
16
  import { type NotificationSinks } from './fireNotification.cjs';
17
+ /** A card's two lines: the title line and the body under it. */
18
+ export interface CardLines {
19
+ readonly title: string;
20
+ readonly body: string | undefined;
21
+ }
22
+ /**
23
+ * A card's lines from a verb's message and options — one rule for every verb and kind, the catalog's OS-only route and
24
+ * the previews (`ToastCommonOptions.title`): under a `title` the title line is the title, and the body the message,
25
+ * then the description; without one the message is the title line and the description the body.
26
+ */
27
+ export declare function cardLines(message: string, options: Pick<ToastCommonOptions, 'title' | 'subtitle' | 'description'>): CardLines;
17
28
  export interface ErrorToastEnrichment {
18
29
  readonly text: string;
19
30
  readonly displayText: string;
@@ -25,7 +36,9 @@ export interface ErrorToastEnrichment {
25
36
  * and developer preview share this function so vendor-code splitting and the
26
37
  * documentation affordance cannot drift; the caller supplies the docs callback,
27
38
  * so a preview keeps its action inert. The vendor match comes from the caller's
28
- * structured reference — the message text is never probed for a code.
39
+ * structured reference — the message text is never probed for a code. The lines
40
+ * are every verb's ({@link cardLines}); without a `title`, a message that opens
41
+ * with the vendor's code is split into the code (the title line) and the rest.
29
42
  */
30
43
  export declare function enrichErrorToast(message: unknown, options: ToastErrorOptions, vendorMatch: VendorErrorMatch | null, onOpenDocs: (url: string) => void): ErrorToastEnrichment;
31
44
  /**
@@ -42,7 +55,8 @@ export interface Toast {
42
55
  /**
43
56
  * Long-running progress toast. Returns a handle that can `update` the message in place and then
44
57
  * resolve as `success`/`fail`, or end it with `dismiss` — the program's close. Source mutes still
45
- * apply unless `priority` is `urgent`.
58
+ * apply unless `priority` is `urgent`. Under a `title` the card keeps that title line, and the
59
+ * message — the one `update`, `success` and `fail` replace — opens its body.
46
60
  *
47
61
  * The operation ends a running progress, not the user and not a setting:
48
62
  * - an issue a setting silences (do not disturb, quiet hours, a muted source, the master switch,
@@ -57,7 +71,9 @@ export interface Toast {
57
71
  * setting silences it then: the card ends `suppressed` and the timeline keeps the outcome's record;
58
72
  * - an issue the user turned down on a card ("don't show again", "remind me later") gets no card,
59
73
  * and its handle stays `suppressed`; so does an acknowledgment the master switch silences, which
60
- * the center does not hold.
74
+ * the center does not hold;
75
+ * - none of these settings and choices reaches a `user-action` progress (`origin`): it opens on the
76
+ * toast stack, its outcome comes back there, and a setting that turns on leaves it where it is.
61
77
  *
62
78
  * An explicit `id` addresses the card. An issue under the id of a card updates that card in place:
63
79
  * its age, place and focus stay — a card the center held comes back on the toast stack, newest — and
@@ -14,6 +14,17 @@ import { type NotificationTimeline } from './notificationTimeline.js';
14
14
  import { type VendorErrorMatch, type VendorErrorSource } from '../_internal/platform/vendorErrors/index.js';
15
15
  import { type NotificationFilter } from './toastFilterPolicy.js';
16
16
  import { type NotificationSinks } from './fireNotification.js';
17
+ /** A card's two lines: the title line and the body under it. */
18
+ export interface CardLines {
19
+ readonly title: string;
20
+ readonly body: string | undefined;
21
+ }
22
+ /**
23
+ * A card's lines from a verb's message and options — one rule for every verb and kind, the catalog's OS-only route and
24
+ * the previews (`ToastCommonOptions.title`): under a `title` the title line is the title, and the body the message,
25
+ * then the description; without one the message is the title line and the description the body.
26
+ */
27
+ export declare function cardLines(message: string, options: Pick<ToastCommonOptions, 'title' | 'subtitle' | 'description'>): CardLines;
17
28
  export interface ErrorToastEnrichment {
18
29
  readonly text: string;
19
30
  readonly displayText: string;
@@ -25,7 +36,9 @@ export interface ErrorToastEnrichment {
25
36
  * and developer preview share this function so vendor-code splitting and the
26
37
  * documentation affordance cannot drift; the caller supplies the docs callback,
27
38
  * so a preview keeps its action inert. The vendor match comes from the caller's
28
- * structured reference — the message text is never probed for a code.
39
+ * structured reference — the message text is never probed for a code. The lines
40
+ * are every verb's ({@link cardLines}); without a `title`, a message that opens
41
+ * with the vendor's code is split into the code (the title line) and the rest.
29
42
  */
30
43
  export declare function enrichErrorToast(message: unknown, options: ToastErrorOptions, vendorMatch: VendorErrorMatch | null, onOpenDocs: (url: string) => void): ErrorToastEnrichment;
31
44
  /**
@@ -42,7 +55,8 @@ export interface Toast {
42
55
  /**
43
56
  * Long-running progress toast. Returns a handle that can `update` the message in place and then
44
57
  * resolve as `success`/`fail`, or end it with `dismiss` — the program's close. Source mutes still
45
- * apply unless `priority` is `urgent`.
58
+ * apply unless `priority` is `urgent`. Under a `title` the card keeps that title line, and the
59
+ * message — the one `update`, `success` and `fail` replace — opens its body.
46
60
  *
47
61
  * The operation ends a running progress, not the user and not a setting:
48
62
  * - an issue a setting silences (do not disturb, quiet hours, a muted source, the master switch,
@@ -57,7 +71,9 @@ export interface Toast {
57
71
  * setting silences it then: the card ends `suppressed` and the timeline keeps the outcome's record;
58
72
  * - an issue the user turned down on a card ("don't show again", "remind me later") gets no card,
59
73
  * and its handle stays `suppressed`; so does an acknowledgment the master switch silences, which
60
- * the center does not hold.
74
+ * the center does not hold;
75
+ * - none of these settings and choices reaches a `user-action` progress (`origin`): it opens on the
76
+ * toast stack, its outcome comes back there, and a setting that turns on leaves it where it is.
61
77
  *
62
78
  * An explicit `id` addresses the card. An issue under the id of a card updates that card in place:
63
79
  * its age, place and focus stay — a card the center held comes back on the toast stack, newest — and
@@ -14,6 +14,13 @@
14
14
  * switch · "don't show again" · "remind me later"), and in all three the user has EXPLICITLY
15
15
  * rejected the notification.
16
16
  *
17
+ * ## The user's own action comes FIRST
18
+ *
19
+ * A `user-action` notification (`NotificationOrigin`) is the visible result of what the user just
20
+ * did — like a dialog, it is always shown and recorded, so no branch below reaches it: none of the
21
+ * settings, none of the three rejections (made on another card of the same key or text), no
22
+ * priority. It only plays no sound where the settings would have kept it off the screen.
23
+ *
17
24
  * ## Why the gates are PARAMETERS
18
25
  *
19
26
  * The suppression queries (`isKeyDismissed`, `isKeyRemindSuppressed`, `isSourceMuted`) and the
@@ -22,7 +29,7 @@
22
29
  * cannot import from the app anyway, so this is not a stylistic choice but a structural
23
30
  * necessity.
24
31
  */
25
- import type { NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.cjs';
32
+ import type { NotificationOrigin, NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.cjs';
26
33
  /**
27
34
  * A run-time notification filter — not a setting: a host sets it while a state of its own lasts and turns it off
28
35
  * after, and nothing of it is stored (the reference's `NotificationsFilter`).
@@ -42,6 +49,11 @@ export declare function filteredPriority(priority: NotificationPriority, severit
42
49
  export interface FilterDecision {
43
50
  showToast: boolean;
44
51
  recordTimeline: boolean;
52
+ /**
53
+ * A `user-action` notification the settings would have kept off the screen: it is shown — the visible result of the
54
+ * user's own action — without its severity tone. Unset for every other decision.
55
+ */
56
+ withoutSound?: boolean;
45
57
  }
46
58
  /** The settings FIELDS the decision reads — not the whole `NotificationSettings`. */
47
59
  export interface ToastFilterSettings {
@@ -66,6 +78,8 @@ export interface ToastFilterInput {
66
78
  readonly priority: NotificationPriority;
67
79
  /** The caller's explicit request; `false` overrides everything. */
68
80
  readonly recordTimeline: boolean | undefined;
81
+ /** Whom the notification answers; unset, `system`. A `user-action` one is always shown. */
82
+ readonly origin?: NotificationOrigin | undefined;
69
83
  }
70
84
  /**
71
85
  * The IMPLICIT key derived from source+title, so that the "Remind me later" option in
@@ -14,6 +14,13 @@
14
14
  * switch · "don't show again" · "remind me later"), and in all three the user has EXPLICITLY
15
15
  * rejected the notification.
16
16
  *
17
+ * ## The user's own action comes FIRST
18
+ *
19
+ * A `user-action` notification (`NotificationOrigin`) is the visible result of what the user just
20
+ * did — like a dialog, it is always shown and recorded, so no branch below reaches it: none of the
21
+ * settings, none of the three rejections (made on another card of the same key or text), no
22
+ * priority. It only plays no sound where the settings would have kept it off the screen.
23
+ *
17
24
  * ## Why the gates are PARAMETERS
18
25
  *
19
26
  * The suppression queries (`isKeyDismissed`, `isKeyRemindSuppressed`, `isSourceMuted`) and the
@@ -22,7 +29,7 @@
22
29
  * cannot import from the app anyway, so this is not a stylistic choice but a structural
23
30
  * necessity.
24
31
  */
25
- import type { NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.js';
32
+ import type { NotificationOrigin, NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.js';
26
33
  /**
27
34
  * A run-time notification filter — not a setting: a host sets it while a state of its own lasts and turns it off
28
35
  * after, and nothing of it is stored (the reference's `NotificationsFilter`).
@@ -42,6 +49,11 @@ export declare function filteredPriority(priority: NotificationPriority, severit
42
49
  export interface FilterDecision {
43
50
  showToast: boolean;
44
51
  recordTimeline: boolean;
52
+ /**
53
+ * A `user-action` notification the settings would have kept off the screen: it is shown — the visible result of the
54
+ * user's own action — without its severity tone. Unset for every other decision.
55
+ */
56
+ withoutSound?: boolean;
45
57
  }
46
58
  /** The settings FIELDS the decision reads — not the whole `NotificationSettings`. */
47
59
  export interface ToastFilterSettings {
@@ -66,6 +78,8 @@ export interface ToastFilterInput {
66
78
  readonly priority: NotificationPriority;
67
79
  /** The caller's explicit request; `false` overrides everything. */
68
80
  readonly recordTimeline: boolean | undefined;
81
+ /** Whom the notification answers; unset, `system`. A `user-action` one is always shown. */
82
+ readonly origin?: NotificationOrigin | undefined;
69
83
  }
70
84
  /**
71
85
  * The IMPLICIT key derived from source+title, so that the "Remind me later" option in
@@ -1,4 +1,5 @@
1
1
  import type { Accessor, JSX } from 'solid-js';
2
+ import { type BadgeTone } from '../feedback/Badge.cjs';
2
3
  import type { ActionPlace } from './actionPlace.cjs';
3
4
  /** A checkbox under a confirmation's message — "do not ask me again" (reference `ICheckbox`). */
4
5
  export interface ConfirmCheckbox {
@@ -21,6 +22,12 @@ export interface ConfirmationResult extends ConfirmCheckboxResult {
21
22
  /** Whether the confirm button answered it. */
22
23
  readonly confirmed: boolean;
23
24
  }
25
+ /** A tag above a confirmation's title — the context it is asked in (an environment such as Production, a scope). */
26
+ export interface ConfirmBadge {
27
+ readonly label: string;
28
+ /** Default 'neutral'. */
29
+ readonly tone?: BadgeTone;
30
+ }
24
31
  export interface ConfirmDialogProps {
25
32
  /**
26
33
  * Whether the dialog shows. One opening is one question: the countdown, the checkbox and the first focus start over
@@ -33,7 +40,27 @@ export interface ConfirmDialogProps {
33
40
  message: string | JSX.Element;
34
41
  confirmLabel?: string;
35
42
  cancelLabel?: string;
43
+ /**
44
+ * `danger`: the question confirms something destructive or security-loosening. The confirm button is red, the
45
+ * first focus is the safe button, and the backdrop does not answer: a click on it nudges the box (a short pop and a
46
+ * ring) and the question stays until a button or Escape answers it — a stray click beside a red question is not a
47
+ * "no", and it must not look like nothing happened. `default`: a click on the backdrop cancels.
48
+ */
36
49
  variant?: 'default' | 'danger';
50
+ /** Tags above the title — the context the question is asked in (e.g. the environment). */
51
+ badges?: readonly ConfirmBadge[];
52
+ /** Facts about what confirming changes — one per line, under the message. */
53
+ details?: readonly string[];
54
+ /**
55
+ * What the user must know before confirming — one per line, in a callout under the details (danger-toned in a
56
+ * `danger` question, warning-toned otherwise) and part of the question's description.
57
+ */
58
+ warnings?: readonly string[];
59
+ /**
60
+ * An acknowledgement, not a question: one button (`confirmLabel`, "Close" by default) answers it with `onConfirm`;
61
+ * Escape and the backdrop dismiss it with `onCancel`. For the result of a verb the user asked for.
62
+ */
63
+ acknowledge?: boolean;
37
64
  /**
38
65
  * The thing being confirmed ITSELF — shown in a read-only block.
39
66
  *
@@ -86,7 +113,16 @@ export interface ConfirmOptions {
86
113
  message: string | JSX.Element;
87
114
  confirmLabel?: string;
88
115
  cancelLabel?: string;
116
+ /** `danger`: red confirm, safe first focus, and the backdrop nudges instead of cancelling (see {@link ConfirmDialogProps.variant}). */
89
117
  variant?: 'default' | 'danger';
118
+ /** Tags above the title (see {@link ConfirmDialogProps.badges}). */
119
+ badges?: readonly ConfirmBadge[];
120
+ /** Facts about what confirming changes, one per line (see {@link ConfirmDialogProps.details}). */
121
+ details?: readonly string[];
122
+ /** What to know before confirming, in a callout (see {@link ConfirmDialogProps.warnings}). */
123
+ warnings?: readonly string[];
124
+ /** An acknowledgement with one button (see {@link ConfirmDialogProps.acknowledge}). */
125
+ acknowledge?: boolean;
90
126
  /** The thing being confirmed itself (SQL etc.) — shown in a read-only block. */
91
127
  code?: string;
92
128
  /** Seconds the confirm button stays disabled. If absent, there is no delay. */