@adea-ai/app-framework 0.39.2 → 0.39.4
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.
- package/README.md +158 -52
- package/dist/app/application.d.ts +0 -1
- package/dist/app/application.js +8 -6
- package/dist/app/create-application.js +3 -11
- package/dist/app/service-registry.d.ts +0 -1
- package/dist/app/service-registry.js +3 -3
- package/dist/app/value-guards.d.ts +2 -0
- package/dist/app/value-guards.js +6 -1
- package/dist/appearance/appearance-host.d.ts +1 -1
- package/dist/appearance/appearance-host.js +11 -2
- package/dist/appearance/appearance-preferences.d.ts +0 -1
- package/dist/appearance/custom-theme-import.d.ts +8 -2
- package/dist/appearance/custom-theme-import.js +58 -23
- package/dist/appearance/custom-theme-library.d.ts +3 -3
- package/dist/appearance/custom-theme-library.js +3 -3
- package/dist/appearance/theme-file-importer.d.ts +1 -1
- package/dist/appearance/theme-file-importer.js +2 -1
- package/dist/appearance/theme-library-mutation.d.ts +7 -0
- package/dist/appearance/theme-library-mutation.js +10 -2
- package/dist/appearance/theme-library-store.d.ts +17 -13
- package/dist/appearance/theme-library-store.js +35 -22
- package/dist/appearance/theme-record-adapter.js +1 -2
- package/dist/appearance/theme-registry.js +0 -1
- package/dist/cli/cli-runner.d.ts +3 -2
- package/dist/cli/cli-runner.js +5 -10
- package/dist/cli/release-assets-plan-cli.js +2 -2
- package/dist/cli/release-cut-cli.js +2 -3
- package/dist/cli/release-descriptor-staging-cli.js +2 -2
- package/dist/cli/release-finalize-cli.js +3 -3
- package/dist/cli/release-promote-cli.js +2 -2
- package/dist/cli/release-publish-cli.js +2 -2
- package/dist/cli/release-sign-cli.js +2 -1
- package/dist/cli/release-step-cli.js +2 -2
- package/dist/desktop/channel-proof.js +27 -11
- package/dist/desktop/client-assets.d.ts +6 -1
- package/dist/desktop/client-assets.js +16 -3
- package/dist/desktop/client-dev-proxy.d.ts +0 -2
- package/dist/desktop/client-dev-proxy.js +2 -2
- package/dist/desktop/desktop-client.js +2 -1
- package/dist/desktop/desktop-gateway.js +24 -82
- package/dist/desktop/desktop-host-websocket.d.ts +5 -1
- package/dist/desktop/desktop-host-websocket.js +9 -7
- package/dist/desktop/desktop-host.d.ts +5 -0
- package/dist/desktop/desktop-host.js +3 -0
- package/dist/desktop/desktop-stream.js +5 -10
- package/dist/desktop/typed-array-intrinsics.d.ts +6 -0
- package/dist/desktop/typed-array-intrinsics.js +13 -1
- package/dist/developer-app/developer-app.d.ts +1 -1
- package/dist/developer-app/developer-app.js +26 -13
- package/dist/framework-source.json +1 -1
- package/dist/installer/command-artifact.d.ts +1 -0
- package/dist/installer/command-artifact.js +47 -27
- package/dist/installer/installed-payload.js +3 -1
- package/dist/installer/installer-ci-bootstrap.js +5 -6
- package/dist/installer/installer-ci-preflight.js +3 -3
- package/dist/installer/installer-identity.d.ts +0 -22
- package/dist/installer/installer-identity.js +3 -53
- package/dist/installer/installer-image-mount.d.ts +0 -1
- package/dist/installer/installer-image-mount.js +1 -1
- package/dist/installer/installer-observation.d.ts +5 -5
- package/dist/installer/installer-observation.js +32 -47
- package/dist/installer/installer-process-cleanup.js +2 -2
- package/dist/installer/installer-renderer-evidence.js +7 -28
- package/dist/installer/installer-upgrade-command.js +8 -20
- package/dist/installer/installer-worker-guard.js +3 -3
- package/dist/native/cef-helper.js +4 -4
- package/dist/native/desktop-build.d.ts +0 -3
- package/dist/native/desktop-build.js +2 -2
- package/dist/native/electrobun-source-patch.d.ts +4 -0
- package/dist/native/electrobun-source-patch.js +5 -1
- package/dist/native/native-utilities.js +4 -3
- package/dist/native/pinned-download.d.ts +16 -0
- package/dist/native/pinned-download.js +42 -0
- package/dist/native/posix-launcher-build.js +15 -35
- package/dist/native/posix-tree-removal.js +21 -33
- package/dist/native/sidecar-services.d.ts +0 -2
- package/dist/native/sidecar-services.js +1 -1
- package/dist/native/sidecar.d.ts +3 -0
- package/dist/native/sidecar.js +15 -2
- package/dist/native/window-surface-store.js +3 -3
- package/dist/native/windows-extractor-build.d.ts +6 -16
- package/dist/native/windows-extractor-build.js +11 -14
- package/dist/release/feed-release-cut.d.ts +2 -6
- package/dist/release/feed-release-cut.js +5 -93
- package/dist/release/feed-state.js +1 -5
- package/dist/release/github-release-cut.js +5 -66
- package/dist/release/github-release-provenance.d.ts +2 -0
- package/dist/release/github-release-provenance.js +4 -7
- package/dist/release/github-release-publisher.js +2 -2
- package/dist/release/github-release-qualification.js +3 -3
- package/dist/release/local-release.d.ts +3 -3
- package/dist/release/local-release.js +12 -23
- package/dist/release/qualification-run.js +1 -1
- package/dist/release/release-assets-plan.js +1 -1
- package/dist/release/release-config.d.ts +7 -15
- package/dist/release/release-config.js +25 -29
- package/dist/release/release-cut-command.d.ts +1 -1
- package/dist/release/release-cut-command.js +1 -1
- package/dist/release/release-cut.d.ts +5 -32
- package/dist/release/release-cut.js +9 -55
- package/dist/release/release-descriptor-staging.js +3 -8
- package/dist/release/release-promotion.js +2 -1
- package/dist/release/release-publish-command.js +5 -15
- package/dist/release/release-qualification.js +1 -1
- package/dist/shared/bounded-body.d.ts +33 -0
- package/dist/shared/bounded-body.js +102 -0
- package/dist/shared/file-system.d.ts +12 -0
- package/dist/shared/file-system.js +40 -0
- package/dist/shell/app-shell.js +29 -14
- package/dist/shell/app-utilities.d.ts +2 -1
- package/dist/shell/app-utilities.js +2 -1
- package/dist/shell/application-menu.d.ts +1 -1
- package/dist/shell/application-menu.js +7 -3
- package/dist/shell/poll.d.ts +27 -0
- package/dist/shell/poll.js +88 -0
- package/dist/update-helper.bundle.js +268 -144
- package/dist/updates/channel-update-manager.js +0 -1
- package/dist/updates/desktop-updater.d.ts +9 -0
- package/dist/updates/desktop-updater.js +103 -50
- package/dist/updates/feed/release-feed.d.ts +7 -4
- package/dist/updates/feed/release-feed.js +3 -7
- package/dist/updates/feed/release-location.js +6 -26
- package/dist/updates/feed/release-version.d.ts +7 -2
- package/dist/updates/feed/release-version.js +9 -2
- package/dist/updates/feed/signed-release.d.ts +1 -1
- package/dist/updates/feed/signed-release.js +2 -2
- package/dist/updates/feed/update-discovery.js +2 -6
- package/dist/updates/helper/launch-gate-recovery.js +28 -78
- package/dist/updates/helper/resume-staging.d.ts +14 -3
- package/dist/updates/helper/resume-staging.js +23 -37
- package/dist/updates/helper/update-helper.d.ts +6 -2
- package/dist/updates/helper/update-helper.js +38 -33
- package/dist/updates/helper/update-resume.js +9 -6
- package/dist/updates/install/update-extraction.js +28 -8
- package/dist/updates/install/update-handoff-plan.d.ts +0 -1
- package/dist/updates/install/update-handoff-plan.js +3 -4
- package/dist/updates/install/update-swap-stage.js +1 -6
- package/dist/updates/install/update-swap.d.ts +5 -2
- package/dist/updates/install/update-swap.js +193 -72
- package/dist/updates/launch/helper-exit-wait.d.ts +6 -0
- package/dist/updates/launch/helper-exit-wait.js +18 -0
- package/dist/updates/launch/packaged-update-startup.js +8 -6
- package/dist/updates/launch/update-launch-gate.js +7 -14
- package/dist/updates/locks/stable-file.js +4 -1
- package/dist/updates/locks/update-helper-presence.d.ts +12 -0
- package/dist/updates/locks/update-helper-presence.js +27 -0
- package/dist/updates/retention/retention-cleanup.js +10 -9
- package/dist/updates/retention/retention-maintenance.d.ts +40 -0
- package/dist/updates/retention/retention-maintenance.js +95 -0
- package/dist/updates/retention/retention-prune-progress.js +4 -5
- package/dist/updates/retention/retirement-inventory.d.ts +13 -0
- package/dist/updates/retention/retirement-inventory.js +39 -31
- package/dist/updates/retention/retirement-records.d.ts +1 -4
- package/dist/updates/retention/retirement-records.js +18 -32
- package/dist/updates/retention/update-retention-marker.d.ts +4 -0
- package/dist/updates/retention/update-retention-marker.js +9 -14
- package/dist/updates/retention/update-retirement.d.ts +12 -0
- package/dist/updates/retention/update-retirement.js +59 -31
- package/dist/updates/update-adapter.d.ts +1 -23
- package/dist/updates/update-adapter.js +31 -24
- package/dist/updates/update-channel-store.d.ts +2 -1
- package/dist/updates/update-channel-store.js +6 -4
- package/dist/updates/update-manager.js +2 -2
- package/dist/updates/update-services.d.ts +1 -1
- package/dist/updates/update-services.js +9 -4
- package/dist/updates/update-state-store.d.ts +0 -2
- package/dist/updates/update-state-store.js +5 -12
- package/dist/updates/update-state.d.ts +6 -10
- package/dist/updates/update-state.js +1 -1
- package/dist/views/app-help.d.ts +1 -1
- package/dist/views/app-help.js +1 -3
- package/dist/views/appearance-surface.js +15 -8
- package/dist/views/update-surface.d.ts +1 -3
- package/dist/views/update-surface.js +2 -2
- package/package.json +18 -16
- package/src/app/application.tsx +13 -6
- package/src/appearance/appearance-host.tsx +17 -7
- package/src/appearance/appearance-preferences.ts +0 -1
- package/src/appearance/custom-theme-import.ts +99 -26
- package/src/appearance/custom-theme-library.ts +3 -2
- package/src/appearance/theme-file-importer.ts +3 -2
- package/src/appearance/theme-library-mutation.ts +20 -8
- package/src/appearance/theme-library-schema.ts +7 -0
- package/src/appearance/theme-library-store.ts +41 -26
- package/src/desktop/client-assets.ts +27 -12
- package/src/shell/app-shell.tsx +33 -13
- package/src/shell/app-utilities.tsx +7 -1
- package/src/shell/poll.ts +125 -0
- package/src/updates/feed/release-version.ts +11 -3
- package/src/updates/update-adapter.ts +27 -44
- package/src/updates/update-state.ts +7 -13
- package/src/views/app-help.tsx +1 -1
- package/src/views/appearance-surface.tsx +39 -11
- package/src/views/update-surface.tsx +0 -4
- package/templates/application/.github/workflows/release-assets.yml +2 -2
- package/templates/application/README.md +3 -3
- package/dist/native/cef-helper-download.d.ts +0 -1
- package/dist/native/cef-helper-download.js +0 -35
- package/src/desktop/client-response-lifecycle.ts +0 -305
package/dist/shell/app-shell.js
CHANGED
|
@@ -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 &&
|
|
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 =
|
|
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(
|
|
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 (!
|
|
50
|
-
const
|
|
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(
|
|
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
|
-
|
|
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 =
|
|
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 = () =>
|
|
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 =
|
|
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(
|
|
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() ||
|
|
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
|
|
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
|
|
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;
|
|
@@ -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";
|
|
@@ -347,4 +348,4 @@ function ApplicationUtilities(props) {
|
|
|
347
348
|
}
|
|
348
349
|
})];
|
|
349
350
|
}
|
|
350
|
-
export { ApplicationThemeProvider, ApplicationUtilities, DEFAULT_NARROW_QUERY, createMediaQuery,
|
|
351
|
+
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
|
|
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 ("
|
|
15
|
-
if (
|
|
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 {
|
|
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 };
|