@adea-ai/app-framework 0.39.3 → 0.40.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 (199) hide show
  1. package/README.md +160 -53
  2. package/dist/app/application.d.ts +0 -1
  3. package/dist/app/application.js +8 -6
  4. package/dist/app/create-application.js +3 -11
  5. package/dist/app/service-registry.d.ts +0 -1
  6. package/dist/app/service-registry.js +3 -3
  7. package/dist/app/value-guards.d.ts +2 -0
  8. package/dist/app/value-guards.js +6 -1
  9. package/dist/appearance/appearance-host.d.ts +1 -1
  10. package/dist/appearance/appearance-host.js +11 -2
  11. package/dist/appearance/appearance-preferences.d.ts +0 -1
  12. package/dist/appearance/custom-theme-import.d.ts +8 -2
  13. package/dist/appearance/custom-theme-import.js +58 -23
  14. package/dist/appearance/custom-theme-library.d.ts +3 -3
  15. package/dist/appearance/custom-theme-library.js +3 -3
  16. package/dist/appearance/theme-file-importer.d.ts +1 -1
  17. package/dist/appearance/theme-file-importer.js +2 -1
  18. package/dist/appearance/theme-library-mutation.d.ts +7 -0
  19. package/dist/appearance/theme-library-mutation.js +10 -2
  20. package/dist/appearance/theme-library-store.d.ts +17 -13
  21. package/dist/appearance/theme-library-store.js +35 -22
  22. package/dist/appearance/theme-record-adapter.js +1 -2
  23. package/dist/appearance/theme-registry.js +0 -1
  24. package/dist/cli/cli-runner.d.ts +3 -2
  25. package/dist/cli/cli-runner.js +5 -10
  26. package/dist/cli/release-assets-plan-cli.js +2 -2
  27. package/dist/cli/release-cut-cli.js +2 -3
  28. package/dist/cli/release-descriptor-staging-cli.js +2 -2
  29. package/dist/cli/release-finalize-cli.js +3 -3
  30. package/dist/cli/release-promote-cli.js +2 -2
  31. package/dist/cli/release-publish-cli.js +2 -2
  32. package/dist/cli/release-sign-cli.js +2 -1
  33. package/dist/cli/release-step-cli.js +2 -2
  34. package/dist/desktop/channel-proof.js +27 -11
  35. package/dist/desktop/client-assets.d.ts +6 -1
  36. package/dist/desktop/client-assets.js +16 -3
  37. package/dist/desktop/client-dev-proxy.d.ts +0 -2
  38. package/dist/desktop/client-dev-proxy.js +2 -2
  39. package/dist/desktop/desktop-client.js +2 -1
  40. package/dist/desktop/desktop-gateway.js +24 -82
  41. package/dist/desktop/desktop-host-websocket.d.ts +5 -1
  42. package/dist/desktop/desktop-host-websocket.js +9 -7
  43. package/dist/desktop/desktop-host.d.ts +5 -0
  44. package/dist/desktop/desktop-host.js +3 -0
  45. package/dist/desktop/desktop-stream.js +5 -10
  46. package/dist/desktop/typed-array-intrinsics.d.ts +6 -0
  47. package/dist/desktop/typed-array-intrinsics.js +13 -1
  48. package/dist/developer-app/developer-app.d.ts +1 -1
  49. package/dist/developer-app/developer-app.js +26 -13
  50. package/dist/framework-source.json +1 -1
  51. package/dist/installer/command-artifact.d.ts +1 -0
  52. package/dist/installer/command-artifact.js +47 -27
  53. package/dist/installer/installed-payload.js +3 -1
  54. package/dist/installer/installer-ci-bootstrap.js +5 -6
  55. package/dist/installer/installer-ci-preflight.js +3 -3
  56. package/dist/installer/installer-identity.d.ts +0 -22
  57. package/dist/installer/installer-identity.js +3 -53
  58. package/dist/installer/installer-image-mount.d.ts +0 -1
  59. package/dist/installer/installer-image-mount.js +1 -1
  60. package/dist/installer/installer-observation.d.ts +5 -5
  61. package/dist/installer/installer-observation.js +32 -47
  62. package/dist/installer/installer-process-cleanup.js +2 -2
  63. package/dist/installer/installer-renderer-evidence.js +7 -28
  64. package/dist/installer/installer-upgrade-command.js +8 -20
  65. package/dist/installer/installer-worker-guard.js +3 -3
  66. package/dist/native/cef-helper.js +4 -4
  67. package/dist/native/desktop-build.d.ts +0 -3
  68. package/dist/native/desktop-build.js +2 -2
  69. package/dist/native/electrobun-source-patch.d.ts +4 -0
  70. package/dist/native/electrobun-source-patch.js +5 -1
  71. package/dist/native/native-utilities.js +4 -3
  72. package/dist/native/pinned-download.d.ts +16 -0
  73. package/dist/native/pinned-download.js +42 -0
  74. package/dist/native/posix-launcher-build.js +15 -35
  75. package/dist/native/posix-tree-removal.js +21 -33
  76. package/dist/native/sidecar-services.d.ts +0 -2
  77. package/dist/native/sidecar-services.js +1 -1
  78. package/dist/native/sidecar.d.ts +3 -0
  79. package/dist/native/sidecar.js +15 -2
  80. package/dist/native/window-surface-store.js +3 -3
  81. package/dist/native/windows-extractor-build.d.ts +6 -16
  82. package/dist/native/windows-extractor-build.js +11 -14
  83. package/dist/release/feed-release-cut.d.ts +2 -6
  84. package/dist/release/feed-release-cut.js +5 -93
  85. package/dist/release/feed-state.js +1 -5
  86. package/dist/release/github-release-cut.js +5 -66
  87. package/dist/release/github-release-provenance.d.ts +2 -0
  88. package/dist/release/github-release-provenance.js +4 -7
  89. package/dist/release/github-release-publisher.js +2 -2
  90. package/dist/release/github-release-qualification.js +3 -3
  91. package/dist/release/local-release.d.ts +3 -3
  92. package/dist/release/local-release.js +12 -23
  93. package/dist/release/qualification-run.js +1 -1
  94. package/dist/release/release-assets-plan.js +1 -1
  95. package/dist/release/release-config.d.ts +7 -15
  96. package/dist/release/release-config.js +25 -29
  97. package/dist/release/release-cut-command.d.ts +1 -1
  98. package/dist/release/release-cut-command.js +1 -1
  99. package/dist/release/release-cut.d.ts +5 -32
  100. package/dist/release/release-cut.js +9 -55
  101. package/dist/release/release-descriptor-staging.js +3 -8
  102. package/dist/release/release-promotion.js +2 -1
  103. package/dist/release/release-publish-command.js +5 -15
  104. package/dist/release/release-qualification.js +1 -1
  105. package/dist/shared/bounded-body.d.ts +33 -0
  106. package/dist/shared/bounded-body.js +102 -0
  107. package/dist/shared/file-system.d.ts +12 -0
  108. package/dist/shared/file-system.js +40 -0
  109. package/dist/shell/app-shell.js +29 -14
  110. package/dist/shell/app-utilities.d.ts +4 -1
  111. package/dist/shell/app-utilities.js +5 -1
  112. package/dist/shell/application-menu.d.ts +1 -1
  113. package/dist/shell/application-menu.js +7 -3
  114. package/dist/shell/poll.d.ts +27 -0
  115. package/dist/shell/poll.js +88 -0
  116. package/dist/update-helper.bundle.js +268 -144
  117. package/dist/updates/channel-update-manager.js +0 -1
  118. package/dist/updates/desktop-updater.d.ts +9 -0
  119. package/dist/updates/desktop-updater.js +103 -50
  120. package/dist/updates/feed/release-feed.d.ts +7 -4
  121. package/dist/updates/feed/release-feed.js +3 -7
  122. package/dist/updates/feed/release-location.js +6 -26
  123. package/dist/updates/feed/release-version.d.ts +7 -2
  124. package/dist/updates/feed/release-version.js +9 -2
  125. package/dist/updates/feed/signed-release.d.ts +1 -1
  126. package/dist/updates/feed/signed-release.js +2 -2
  127. package/dist/updates/feed/update-discovery.js +2 -6
  128. package/dist/updates/helper/launch-gate-recovery.js +28 -78
  129. package/dist/updates/helper/resume-staging.d.ts +14 -3
  130. package/dist/updates/helper/resume-staging.js +23 -37
  131. package/dist/updates/helper/update-helper.d.ts +6 -2
  132. package/dist/updates/helper/update-helper.js +38 -33
  133. package/dist/updates/helper/update-resume.js +9 -6
  134. package/dist/updates/install/update-extraction.js +28 -8
  135. package/dist/updates/install/update-handoff-plan.d.ts +0 -1
  136. package/dist/updates/install/update-handoff-plan.js +3 -4
  137. package/dist/updates/install/update-swap-stage.js +1 -6
  138. package/dist/updates/install/update-swap.d.ts +5 -2
  139. package/dist/updates/install/update-swap.js +193 -72
  140. package/dist/updates/launch/helper-exit-wait.d.ts +6 -0
  141. package/dist/updates/launch/helper-exit-wait.js +18 -0
  142. package/dist/updates/launch/packaged-update-startup.js +8 -6
  143. package/dist/updates/launch/update-launch-gate.js +7 -14
  144. package/dist/updates/locks/stable-file.js +4 -1
  145. package/dist/updates/locks/update-helper-presence.d.ts +12 -0
  146. package/dist/updates/locks/update-helper-presence.js +27 -0
  147. package/dist/updates/retention/retention-cleanup.js +10 -9
  148. package/dist/updates/retention/retention-maintenance.d.ts +40 -0
  149. package/dist/updates/retention/retention-maintenance.js +95 -0
  150. package/dist/updates/retention/retention-prune-progress.js +4 -5
  151. package/dist/updates/retention/retirement-inventory.d.ts +13 -0
  152. package/dist/updates/retention/retirement-inventory.js +39 -31
  153. package/dist/updates/retention/retirement-records.d.ts +1 -4
  154. package/dist/updates/retention/retirement-records.js +18 -32
  155. package/dist/updates/retention/update-retention-marker.d.ts +4 -0
  156. package/dist/updates/retention/update-retention-marker.js +9 -14
  157. package/dist/updates/retention/update-retirement.d.ts +12 -0
  158. package/dist/updates/retention/update-retirement.js +59 -31
  159. package/dist/updates/update-adapter.d.ts +1 -23
  160. package/dist/updates/update-adapter.js +31 -24
  161. package/dist/updates/update-channel-store.d.ts +2 -1
  162. package/dist/updates/update-channel-store.js +6 -4
  163. package/dist/updates/update-manager.js +2 -2
  164. package/dist/updates/update-services.d.ts +1 -1
  165. package/dist/updates/update-services.js +9 -4
  166. package/dist/updates/update-state-store.d.ts +0 -2
  167. package/dist/updates/update-state-store.js +5 -12
  168. package/dist/updates/update-state.d.ts +6 -10
  169. package/dist/updates/update-state.js +1 -1
  170. package/dist/views/app-help.d.ts +1 -1
  171. package/dist/views/app-help.js +1 -3
  172. package/dist/views/appearance-surface.js +15 -8
  173. package/dist/views/update-surface.d.ts +1 -3
  174. package/dist/views/update-surface.js +2 -2
  175. package/package.json +20 -18
  176. package/src/app/application.tsx +13 -6
  177. package/src/appearance/appearance-host.tsx +17 -7
  178. package/src/appearance/appearance-preferences.ts +0 -1
  179. package/src/appearance/custom-theme-import.ts +99 -26
  180. package/src/appearance/custom-theme-library.ts +3 -2
  181. package/src/appearance/theme-file-importer.ts +3 -2
  182. package/src/appearance/theme-library-mutation.ts +20 -8
  183. package/src/appearance/theme-library-schema.ts +7 -0
  184. package/src/appearance/theme-library-store.ts +41 -26
  185. package/src/desktop/client-assets.ts +27 -12
  186. package/src/shell/app-shell.tsx +33 -13
  187. package/src/shell/app-utilities.tsx +10 -1
  188. package/src/shell/poll.ts +125 -0
  189. package/src/updates/feed/release-version.ts +11 -3
  190. package/src/updates/update-adapter.ts +27 -44
  191. package/src/updates/update-state.ts +7 -13
  192. package/src/views/app-help.tsx +1 -1
  193. package/src/views/appearance-surface.tsx +36 -8
  194. package/src/views/update-surface.tsx +0 -4
  195. package/templates/application/.github/workflows/release-assets.yml +2 -2
  196. package/templates/application/README.md +3 -3
  197. package/dist/native/cef-helper-download.d.ts +0 -1
  198. package/dist/native/cef-helper-download.js +0 -35
  199. package/src/desktop/client-response-lifecycle.ts +0 -305
@@ -1,7 +1,7 @@
1
1
  import { hasEditableKeyboardTarget } from "./keyboard-target.js";
2
2
  import { createMediaQuery } from "./media-query.js";
3
3
  import { className, createComponent, effect, insert, memo, mergeProps, template } from "solid-js/web";
4
- import { For, Show, Suspense, children, createComputed, createEffect, createSignal, lazy, onCleanup, onMount, untrack } from "solid-js";
4
+ import { For, Show, Suspense, children, createComputed, createEffect, createMemo, createSignal, lazy, onCleanup, onMount, untrack } from "solid-js";
5
5
  import { AppShell, AppShellBody, AppShellContent, AppShellMain, SkipLink } from "@adea-ai/ui/components/layout/app-shell";
6
6
  import { ContextualSidebar } from "@adea-ai/ui/components/layout/contextual-sidebar";
7
7
  import { PixelPane } from "@adea-ai/ui/components/layout/pixel-pane";
@@ -21,13 +21,20 @@ function getSidebarResponsiveMode(sidebar) {
21
21
  /** Shared chrome and navigation composition; applications own routes and services. */
22
22
  function ApplicationShell(props) {
23
23
  let sidebarToggle;
24
+ const sidebarProps = createMemo(() => props.sidebar);
25
+ const sidebarContent = createMemo(() => sidebarProps()?.content);
26
+ const sidebarHeader = createMemo(() => sidebarProps()?.header);
27
+ const sidebarFooter = createMemo(() => sidebarProps()?.footer);
28
+ const renderSidebarContent = (context) => sidebarContent()?.(context);
29
+ const renderSidebarHeader = (context) => sidebarHeader()?.(context);
30
+ const renderSidebarFooter = (context) => sidebarFooter()?.(context);
24
31
  const narrow = createMediaQuery(() => props.drawer ? props.narrowQuery ?? "(max-width: 799px)" : void 0);
25
- const sidebarMobile = createMediaQuery(() => !props.drawer && props.sidebar ? "(max-width: 48rem)" : void 0);
32
+ const sidebarMobile = createMediaQuery(() => !props.drawer && sidebarProps() ? "(max-width: 48rem)" : void 0);
26
33
  const [sidebarElementMobile, setSidebarElementMobile] = createSignal();
27
34
  const sidebarElements = /* @__PURE__ */ new Map();
28
35
  const sidebarElementCallbacks = /* @__PURE__ */ new Map();
29
36
  createEffect(() => {
30
- const nextCallback = props.sidebar?.onSidebarElement;
37
+ const nextCallback = sidebarProps()?.onSidebarElement;
31
38
  for (const [mobile, element] of sidebarElements) {
32
39
  const previousCallback = sidebarElementCallbacks.get(mobile);
33
40
  if (previousCallback === nextCallback) continue;
@@ -39,34 +46,35 @@ function ApplicationShell(props) {
39
46
  const isSidebarMobile = () => {
40
47
  const mountedMode = sidebarElementMobile();
41
48
  if (mountedMode !== void 0) return mountedMode;
42
- const mode = getSidebarResponsiveMode(props.sidebar);
49
+ const mode = getSidebarResponsiveMode(sidebarProps());
43
50
  if (mode === "mobile") return true;
44
51
  if (mode === "desktop") return false;
45
52
  return sidebarMobile();
46
53
  };
47
54
  const restoreSidebarFocus = (sidebar) => {
48
55
  const active = sidebar?.ownerDocument.activeElement;
49
- if (!props.sidebar || sidebar?.dataset.open !== "true" || !sidebar.isConnected || !active || !sidebar.contains(active)) return;
50
- const target = props.sidebar.restoreFocusRef ? props.sidebar.restoreFocusRef() : sidebarToggle;
56
+ if (!sidebarProps() || sidebar?.dataset.open !== "true" || !sidebar.isConnected || !active || !sidebar.contains(active)) return;
57
+ const restoreFocusRef = sidebarProps()?.restoreFocusRef;
58
+ const target = restoreFocusRef ? restoreFocusRef() : sidebarToggle;
51
59
  if (target?.isConnected) target.focus({ preventScroll: true });
52
60
  };
53
61
  let requestedModeInitialized = false;
54
62
  let previousRequestedMode;
55
63
  createComputed(() => {
56
- const next = getSidebarResponsiveMode(props.sidebar);
64
+ const next = getSidebarResponsiveMode(sidebarProps());
57
65
  const shouldRestore = requestedModeInitialized && next === "mobile" && previousRequestedMode !== "mobile";
58
66
  previousRequestedMode = next;
59
67
  requestedModeInitialized = true;
60
68
  if (shouldRestore) untrack(() => restoreSidebarFocus(sidebarElements.get(false)));
61
69
  });
62
70
  const handleSidebarModeTransition = (event) => {
63
- props.sidebar?.onResponsiveModeTransition?.(event);
71
+ sidebarProps()?.onResponsiveModeTransition?.(event);
64
72
  if (event.phase === "before" && event.from === "desktop" && event.to === "mobile") restoreSidebarFocus(event.desktopSidebar);
65
73
  };
66
74
  const handleSidebarElement = (element, mobile) => {
67
75
  if (element) {
68
76
  sidebarElements.set(mobile, element);
69
- const callback = props.sidebar?.onSidebarElement;
77
+ const callback = sidebarProps()?.onSidebarElement;
70
78
  sidebarElementCallbacks.set(mobile, callback);
71
79
  setSidebarElementMobile(mobile);
72
80
  callback?.(element, mobile);
@@ -84,12 +92,12 @@ function ApplicationShell(props) {
84
92
  if (narrow()) setDrawerMounted(true);
85
93
  else setDrawerOpen(false);
86
94
  });
87
- const leading = () => props.sidebar ?? props.pane;
95
+ const leading = () => sidebarProps() ?? props.pane;
88
96
  const toggleVisible = () => narrow() || Boolean(leading());
89
97
  const expanded = () => narrow() ? drawerOpen() : Boolean(leading()?.open);
90
98
  const toggleLabel = () => {
91
99
  if (narrow()) return "Toggle navigation";
92
- const noun = props.sidebar ? "contextual sidebar" : props.pane?.label ?? "sidebar";
100
+ const noun = sidebarProps() ? "contextual sidebar" : props.pane?.label ?? "sidebar";
93
101
  return leading()?.open ? `Collapse ${noun}` : `Expand ${noun}`;
94
102
  };
95
103
  const toggle = () => {
@@ -182,7 +190,7 @@ function ApplicationShell(props) {
182
190
  return memo(() => !!(!narrow() && leading()?.open))() && !isSidebarMobile();
183
191
  },
184
192
  get alignSidebarAtNarrow() {
185
- return getSidebarResponsiveMode(props.sidebar) === "desktop";
193
+ return getSidebarResponsiveMode(sidebarProps()) === "desktop";
186
194
  },
187
195
  get sidebarWidth() {
188
196
  return leading()?.width;
@@ -225,7 +233,7 @@ function ApplicationShell(props) {
225
233
  return expanded();
226
234
  },
227
235
  get ["aria-controls"]() {
228
- return memo(() => !!(narrow() || props.sidebar))() ? void 0 : props.pane?.id;
236
+ return memo(() => !!(narrow() || sidebarProps()))() ? void 0 : props.pane?.id;
229
237
  },
230
238
  onClick: toggle,
231
239
  get children() {
@@ -295,7 +303,7 @@ function ApplicationShell(props) {
295
303
  return [createComponent(AppShellContent, { get children() {
296
304
  return [createComponent(Show, {
297
305
  get when() {
298
- return props.sidebar;
306
+ return sidebarProps();
299
307
  },
300
308
  children: (sidebar) => createComponent(PixelPane, {
301
309
  "class": "overflow-visible",
@@ -312,6 +320,13 @@ function ApplicationShell(props) {
312
320
  },
313
321
  get children() {
314
322
  return createComponent(ContextualSidebar, mergeProps(sidebar, {
323
+ content: renderSidebarContent,
324
+ get header() {
325
+ return sidebarHeader() && renderSidebarHeader;
326
+ },
327
+ get footer() {
328
+ return sidebarFooter() && renderSidebarFooter;
329
+ },
315
330
  onSidebarElement: handleSidebarElement,
316
331
  onResponsiveModeTransition: handleSidebarModeTransition,
317
332
  get restoreFocusRef() {
@@ -6,8 +6,9 @@ import { type HelpLink, type HelpShortcut } from './help-shortcuts';
6
6
  import { type ApplicationSettingsSection } from './settings-sections';
7
7
  import { type ShortcutPlatform } from './shortcut-platform';
8
8
  import { type UpdateChannelSource } from '../updates/update-adapter';
9
- export * from './shortcut-platform';
9
+ export { detectShortcutPlatform, settingsShortcutLabel, shortcutModifierKey, type ShortcutPlatform, } from './shortcut-platform';
10
10
  export { createMediaQuery, DEFAULT_NARROW_QUERY } from './media-query';
11
+ export { createPoll, type Poll, type PollOptions } from './poll';
11
12
  export type ApplicationIdentity = Readonly<{
12
13
  name: string;
13
14
  icon: string;
@@ -73,6 +74,8 @@ export type ApplicationHelpConfig = Readonly<{
73
74
  export type ApplicationAccountMenuConfig = Readonly<{
74
75
  /** The trigger's accessible name; defaults to `Application settings`. */
75
76
  label?: string;
77
+ /** A profile photo drawn on the trigger in place of the user glyph. */
78
+ avatarSrc?: string;
76
79
  /** Disable the session row while a sign-in or sign-out is in flight. */
77
80
  busy?: boolean;
78
81
  /** Fires on hover or focus of the trigger, e.g. to prefetch. */
@@ -4,6 +4,7 @@ import { detectShortcutPlatform, resolveShortcutPlatform, settingsShortcutLabel,
4
4
  import { hasEditableKeyboardTarget } from "./keyboard-target.js";
5
5
  import { browserUpdateAdapter } from "../updates/update-adapter.js";
6
6
  import { DEFAULT_NARROW_QUERY, createMediaQuery } from "./media-query.js";
7
+ import { createPoll } from "./poll.js";
7
8
  import { createComponent, memo, mergeProps, template } from "solid-js/web";
8
9
  import { Show, Suspense, createEffect, createMemo, createSignal, lazy, on, onCleanup, onMount } from "solid-js";
9
10
  import { Palette } from "lucide-solid";
@@ -212,6 +213,9 @@ function ApplicationUtilities(props) {
212
213
  get label() {
213
214
  return props.accountMenu?.label ?? "Application settings";
214
215
  },
216
+ get avatarSrc() {
217
+ return props.accountMenu?.avatarSrc;
218
+ },
215
219
  railTrigger: true,
216
220
  placement: "right-end",
217
221
  gutter: 4,
@@ -347,4 +351,4 @@ function ApplicationUtilities(props) {
347
351
  }
348
352
  })];
349
353
  }
350
- export { ApplicationThemeProvider, ApplicationUtilities, DEFAULT_NARROW_QUERY, createMediaQuery, detectShortcutPlatform, resolveShortcutPlatform, settingsShortcutLabel, shortcutModifierKey };
354
+ export { ApplicationThemeProvider, ApplicationUtilities, DEFAULT_NARROW_QUERY, createMediaQuery, createPoll, detectShortcutPlatform, settingsShortcutLabel, shortcutModifierKey };
@@ -1,6 +1,6 @@
1
1
  import type { createDesktopStreams } from '../desktop/desktop-stream';
2
2
  import { type ApplicationMenuCommand } from './application-menu-commands';
3
- export * from './application-menu-commands';
3
+ export type { ApplicationMenuCommand };
4
4
  /** The subset of Electrobun's application menu item configuration the framework emits. */
5
5
  export type ApplicationMenuItem = {
6
6
  type: 'separator';
@@ -11,8 +11,12 @@ function label(value) {
11
11
  function validateItems(items, depth = 0) {
12
12
  if (!Array.isArray(items) || items.length > 64 || depth > 2) throw new Error("Invalid menu items");
13
13
  return items.map((item) => {
14
- if ("type" in item) return separator;
15
- if (item.label !== void 0 && !label(item.label) || item.action !== void 0 && (!appAction.test(item.action) || item.action.startsWith(prefix)) || item.role !== void 0 && !/^[a-zA-Z]+$/.test(item.role) || item.action === void 0 && item.role === void 0 && item.submenu === void 0 || item.label === void 0 && item.role === void 0) throw new Error("Invalid menu item");
14
+ if (typeof item !== "object" || item === null || Array.isArray(item)) throw new Error("Invalid menu item");
15
+ if ("type" in item) {
16
+ if (item.type === "separator") return separator;
17
+ throw new Error("Invalid menu item");
18
+ }
19
+ if (item.label !== void 0 && !label(item.label) || item.action !== void 0 && (typeof item.action !== "string" || !appAction.test(item.action) || item.action.startsWith(prefix)) || item.role !== void 0 && (typeof item.role !== "string" || !/^[a-zA-Z]+$/.test(item.role)) || item.accelerator !== void 0 && (typeof item.accelerator !== "string" || !item.accelerator || item.accelerator.length > 64 || containsAsciiControl(item.accelerator)) || item.enabled !== void 0 && typeof item.enabled !== "boolean" || item.action === void 0 && item.role === void 0 && item.submenu === void 0 || item.label === void 0 && item.role === void 0) throw new Error("Invalid menu item");
16
20
  return {
17
21
  ...item,
18
22
  ...item.submenu ? { submenu: validateItems(item.submenu, depth + 1) } : {}
@@ -218,4 +222,4 @@ function createApplicationCommandBroadcaster(options) {
218
222
  }
219
223
  };
220
224
  }
221
- export { applicationCommandStream, applicationMenuCommands, createApplicationCommandBroadcaster, createApplicationMenu, createApplicationMenuHandler };
225
+ export { createApplicationCommandBroadcaster, createApplicationMenu, createApplicationMenuHandler };
@@ -0,0 +1,27 @@
1
+ export type PollOptions = Readonly<{
2
+ /** Time from one run settling to the next starting. */
3
+ intervalMs: number;
4
+ /** One tick. Its signal aborts when the poll stops, is disabled or its owner is disposed. */
5
+ run: (signal: AbortSignal) => unknown;
6
+ /** Pause while the document is hidden and catch up when it is shown. Default true. */
7
+ visibleOnly?: boolean;
8
+ /** Run once as soon as the poll starts. Default true. */
9
+ immediate?: boolean;
10
+ /** Reactive switch; the poll stops while it reads false. */
11
+ enabled?: () => boolean;
12
+ /** A tick's rejection. Polling continues either way. */
13
+ onError?: (error: unknown) => void;
14
+ }>;
15
+ export type Poll = Readonly<{
16
+ /** Run now, unless a tick is already running, and restart the interval from it. */
17
+ refresh(): void;
18
+ /** Stop for good. Only needed outside a reactive owner, whose disposal stops the poll. */
19
+ stop(): void;
20
+ }>;
21
+ /**
22
+ * A polling loop owned by the current reactive scope. Ticks never overlap: the next one is
23
+ * scheduled when the previous settles. With `visibleOnly` (the default) a hidden window holds
24
+ * no timer at all, and on being shown it runs at once if a tick is due. Disposal clears the
25
+ * timer and aborts the tick in flight, so a late answer can check its signal and drop itself.
26
+ */
27
+ export declare function createPoll(options: PollOptions): Poll;
@@ -0,0 +1,88 @@
1
+ import { createEffect, getOwner, onCleanup, untrack } from "solid-js";
2
+ // src/shell/poll.ts
3
+ var hidden = () => typeof document !== "undefined" && document.visibilityState === "hidden";
4
+ /**
5
+ * A polling loop owned by the current reactive scope. Ticks never overlap: the next one is
6
+ * scheduled when the previous settles. With `visibleOnly` (the default) a hidden window holds
7
+ * no timer at all, and on being shown it runs at once if a tick is due. Disposal clears the
8
+ * timer and aborts the tick in flight, so a late answer can check its signal and drop itself.
9
+ */
10
+ function createPoll(options) {
11
+ if (!Number.isFinite(options.intervalMs) || options.intervalMs <= 0) throw new RangeError("Invalid poll interval");
12
+ const visibleOnly = options.visibleOnly ?? true;
13
+ let timer;
14
+ let controller;
15
+ let running = false;
16
+ let active = false;
17
+ let lastStart = Number.NEGATIVE_INFINITY;
18
+ const clear = () => {
19
+ if (timer !== void 0) clearTimeout(timer);
20
+ timer = void 0;
21
+ };
22
+ const schedule = () => {
23
+ clear();
24
+ if (!active || running || visibleOnly && hidden()) return;
25
+ const wait = Math.max(0, lastStart + options.intervalMs - performance.now());
26
+ timer = setTimeout(tick, wait);
27
+ };
28
+ const tick = () => {
29
+ clear();
30
+ if (!active || running) return;
31
+ running = true;
32
+ lastStart = performance.now();
33
+ const signal = controller.signal;
34
+ let result;
35
+ try {
36
+ result = options.run(signal);
37
+ } catch (error) {
38
+ result = Promise.reject(error);
39
+ }
40
+ Promise.resolve(result).catch((error) => {
41
+ if (!signal.aborted) options.onError?.(error);
42
+ }).finally(() => {
43
+ if (signal.aborted) return;
44
+ running = false;
45
+ lastStart = performance.now();
46
+ schedule();
47
+ });
48
+ };
49
+ const onVisibility = () => hidden() ? clear() : schedule();
50
+ const start = () => {
51
+ active = true;
52
+ controller = new AbortController();
53
+ if (visibleOnly && typeof document !== "undefined") document.addEventListener("visibilitychange", onVisibility);
54
+ if (options.immediate ?? true) {
55
+ if (visibleOnly && hidden()) lastStart = Number.NEGATIVE_INFINITY;
56
+ else return tick();
57
+ } else lastStart = performance.now();
58
+ schedule();
59
+ };
60
+ const stop = () => {
61
+ active = false;
62
+ clear();
63
+ controller?.abort();
64
+ controller = void 0;
65
+ running = false;
66
+ if (typeof document !== "undefined") document.removeEventListener("visibilitychange", onVisibility);
67
+ };
68
+ if (options.enabled) {
69
+ const enabled = options.enabled;
70
+ createEffect(() => {
71
+ if (!enabled()) return;
72
+ untrack(start);
73
+ onCleanup(stop);
74
+ });
75
+ } else if (getOwner()) createEffect(() => {
76
+ untrack(start);
77
+ onCleanup(stop);
78
+ });
79
+ else start();
80
+ return {
81
+ refresh() {
82
+ if (!active || running) return;
83
+ tick();
84
+ },
85
+ stop
86
+ };
87
+ }
88
+ export { createPoll };