@krate/app 0.0.0-stage → 0.5.0-rc.6

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 (132) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +88 -2
  3. package/dist/automation.d.ts +11 -0
  4. package/dist/automation.d.ts.map +1 -0
  5. package/dist/automation.js +27 -0
  6. package/dist/badge.d.ts +13 -0
  7. package/dist/badge.d.ts.map +1 -0
  8. package/dist/badge.js +34 -0
  9. package/dist/chrome.d.ts +90 -0
  10. package/dist/chrome.d.ts.map +1 -0
  11. package/dist/chrome.js +133 -0
  12. package/dist/client.d.ts +26 -0
  13. package/dist/client.d.ts.map +1 -0
  14. package/dist/client.js +545 -0
  15. package/dist/clipboard.d.ts +19 -0
  16. package/dist/clipboard.d.ts.map +1 -0
  17. package/dist/clipboard.js +51 -0
  18. package/dist/cookies.d.ts +44 -0
  19. package/dist/cookies.d.ts.map +1 -0
  20. package/dist/cookies.js +45 -0
  21. package/dist/crash.d.ts +35 -0
  22. package/dist/crash.d.ts.map +1 -0
  23. package/dist/crash.js +28 -0
  24. package/dist/db.d.ts +14 -0
  25. package/dist/db.d.ts.map +1 -0
  26. package/dist/db.js +23 -0
  27. package/dist/dialog.d.ts +36 -0
  28. package/dist/dialog.d.ts.map +1 -0
  29. package/dist/dialog.js +23 -0
  30. package/dist/downloads.d.ts +35 -0
  31. package/dist/downloads.d.ts.map +1 -0
  32. package/dist/downloads.js +30 -0
  33. package/dist/driver.d.ts +190 -0
  34. package/dist/driver.d.ts.map +1 -0
  35. package/dist/driver.js +637 -0
  36. package/dist/errors.d.ts +7 -0
  37. package/dist/errors.d.ts.map +1 -0
  38. package/dist/errors.js +11 -0
  39. package/dist/events.d.ts +6 -0
  40. package/dist/events.d.ts.map +1 -0
  41. package/dist/events.js +47 -0
  42. package/dist/extension.d.ts +10 -0
  43. package/dist/extension.d.ts.map +1 -0
  44. package/dist/extension.js +25 -0
  45. package/dist/fakehost.d.ts +18 -0
  46. package/dist/fakehost.d.ts.map +1 -0
  47. package/dist/fakehost.js +199 -0
  48. package/dist/fs.d.ts +26 -0
  49. package/dist/fs.d.ts.map +1 -0
  50. package/dist/fs.js +38 -0
  51. package/dist/host.d.ts +4 -0
  52. package/dist/host.d.ts.map +1 -0
  53. package/dist/host.js +25 -0
  54. package/dist/index.d.ts +19 -0
  55. package/dist/index.d.ts.map +1 -0
  56. package/dist/index.js +40 -0
  57. package/dist/kv.d.ts +6 -0
  58. package/dist/kv.d.ts.map +1 -0
  59. package/dist/kv.js +19 -0
  60. package/dist/lifecycle.d.ts +22 -0
  61. package/dist/lifecycle.d.ts.map +1 -0
  62. package/dist/lifecycle.js +85 -0
  63. package/dist/login.d.ts +10 -0
  64. package/dist/login.d.ts.map +1 -0
  65. package/dist/login.js +8 -0
  66. package/dist/media.d.ts +50 -0
  67. package/dist/media.d.ts.map +1 -0
  68. package/dist/media.js +70 -0
  69. package/dist/menu.d.ts +71 -0
  70. package/dist/menu.d.ts.map +1 -0
  71. package/dist/menu.js +114 -0
  72. package/dist/mock.d.ts +14 -0
  73. package/dist/mock.d.ts.map +1 -0
  74. package/dist/mock.js +47 -0
  75. package/dist/notify.d.ts +25 -0
  76. package/dist/notify.d.ts.map +1 -0
  77. package/dist/notify.js +32 -0
  78. package/dist/offscreen.d.ts +24 -0
  79. package/dist/offscreen.d.ts.map +1 -0
  80. package/dist/offscreen.js +27 -0
  81. package/dist/os.d.ts +20 -0
  82. package/dist/os.d.ts.map +1 -0
  83. package/dist/os.js +43 -0
  84. package/dist/page.d.ts +69 -0
  85. package/dist/page.d.ts.map +1 -0
  86. package/dist/page.js +61 -0
  87. package/dist/permission.d.ts +5 -0
  88. package/dist/permission.d.ts.map +1 -0
  89. package/dist/permission.js +18 -0
  90. package/dist/port.d.ts +35 -0
  91. package/dist/port.d.ts.map +1 -0
  92. package/dist/port.js +159 -0
  93. package/dist/power.d.ts +19 -0
  94. package/dist/power.d.ts.map +1 -0
  95. package/dist/power.js +35 -0
  96. package/dist/remote.d.ts +156 -0
  97. package/dist/remote.d.ts.map +1 -0
  98. package/dist/remote.js +115 -0
  99. package/dist/screen.d.ts +25 -0
  100. package/dist/screen.d.ts.map +1 -0
  101. package/dist/screen.js +23 -0
  102. package/dist/shortcut.d.ts +2 -0
  103. package/dist/shortcut.d.ts.map +1 -0
  104. package/dist/shortcut.js +44 -0
  105. package/dist/testing.d.ts +6 -0
  106. package/dist/testing.d.ts.map +1 -0
  107. package/dist/testing.js +9 -0
  108. package/dist/theme.d.ts +12 -0
  109. package/dist/theme.d.ts.map +1 -0
  110. package/dist/theme.js +13 -0
  111. package/dist/tray.d.ts +18 -0
  112. package/dist/tray.d.ts.map +1 -0
  113. package/dist/tray.js +23 -0
  114. package/dist/types.d.ts +16 -0
  115. package/dist/types.d.ts.map +1 -0
  116. package/dist/types.js +1 -0
  117. package/dist/updater.d.ts +36 -0
  118. package/dist/updater.d.ts.map +1 -0
  119. package/dist/updater.js +58 -0
  120. package/dist/window.d.ts +154 -0
  121. package/dist/window.d.ts.map +1 -0
  122. package/dist/window.js +205 -0
  123. package/dist/wire.d.ts +26 -0
  124. package/dist/wire.d.ts.map +1 -0
  125. package/dist/wire.js +328 -0
  126. package/dist/worker-host.d.ts +6 -0
  127. package/dist/worker-host.d.ts.map +1 -0
  128. package/dist/worker-host.js +36 -0
  129. package/dist/worker.d.ts +62 -0
  130. package/dist/worker.d.ts.map +1 -0
  131. package/dist/worker.js +86 -0
  132. package/package.json +188 -3
@@ -0,0 +1,25 @@
1
+ import { type SubscribeOptions } from "./events.js";
2
+ export interface Display {
3
+ id: string;
4
+ name: string;
5
+ x: number;
6
+ y: number;
7
+ width: number;
8
+ height: number;
9
+ workX: number;
10
+ workY: number;
11
+ workWidth: number;
12
+ workHeight: number;
13
+ scale: number;
14
+ primary: boolean;
15
+ refreshHz: number;
16
+ }
17
+ export interface ScreenEvent {
18
+ displays: Display[];
19
+ }
20
+ export declare function listDisplays(): Promise<Display[]>;
21
+ export declare function primaryDisplay(): Promise<Display>;
22
+ export declare function displayOfWindow(window?: string): Promise<Display>;
23
+ export declare function centerWindow(window?: string, display?: string): Promise<void>;
24
+ export declare function onDisplaysChanged(fn: (e: ScreenEvent) => void, opts?: SubscribeOptions): () => void;
25
+ //# sourceMappingURL=screen.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,OAAO;IAEtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IAEb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IAEjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAE1B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAgB,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAEjD;AAED,wBAAgB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAEjD;AAGD,wBAAgB,eAAe,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAID,wBAAgB,YAAY,CAAC,MAAM,SAAK,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAID,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAEnG"}
package/dist/screen.js ADDED
@@ -0,0 +1,23 @@
1
+ // Displays and window placement. Needs the "screen" permission.
2
+ import { call } from "./index.js";
3
+ import { subscribe } from "./events.js";
4
+ export function listDisplays() {
5
+ return call("krate/screen.list", []);
6
+ }
7
+ export function primaryDisplay() {
8
+ return call("krate/screen.primary", []);
9
+ }
10
+ // ofWindow resolves the display most of the window is on ("" is the main window).
11
+ export function displayOfWindow(window = "") {
12
+ return call("krate/screen.ofWindow", [window]);
13
+ }
14
+ // centerWindow moves the window to the middle of the work area of a display
15
+ // (the one it is on when display is omitted).
16
+ export function centerWindow(window = "", display = "") {
17
+ return call("krate/screen.centerWindow", [window, display]);
18
+ }
19
+ // onChange calls fn when a display is added, removed or changes geometry or
20
+ // scale.
21
+ export function onDisplaysChanged(fn, opts) {
22
+ return subscribe("krate/screen.events", fn, opts);
23
+ }
@@ -0,0 +1,2 @@
1
+ export declare function register(accelerator: string, fn: () => void): Promise<() => Promise<void>>;
2
+ //# sourceMappingURL=shortcut.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shortcut.d.ts","sourceRoot":"","sources":["../src/shortcut.ts"],"names":[],"mappings":"AA0BA,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAkBhG"}
@@ -0,0 +1,44 @@
1
+ // Global (system-wide) keyboard shortcuts. Needs the "shortcut" permission.
2
+ // Works on X11; on Wayland it needs the GlobalShortcuts portal and otherwise
3
+ // register() rejects with code "unsupported".
4
+ import { call } from "./index.js";
5
+ import { subscribe } from "./events.js";
6
+ const handlers = new Map();
7
+ let stop;
8
+ let counter = 0;
9
+ function ensureSubscribed() {
10
+ if (stop)
11
+ return;
12
+ stop = subscribe("krate/shortcut.events", (e) => handlers.get(e.id)?.(), {
13
+ onError: () => {
14
+ stop = undefined;
15
+ },
16
+ });
17
+ }
18
+ function newHandle() {
19
+ const c = globalThis.crypto;
20
+ return "ui-" + ++counter + "-" + (c?.randomUUID?.() ?? Math.random().toString(36).slice(2));
21
+ }
22
+ // register grabs the accelerator ("Ctrl+Shift+K", "Alt+F4") and calls fn on
23
+ // each press. It resolves to a function that releases the shortcut.
24
+ export async function register(accelerator, fn) {
25
+ const handle = newHandle();
26
+ handlers.set(handle, fn);
27
+ ensureSubscribed();
28
+ try {
29
+ await call("krate/shortcut.register", [handle, accelerator]);
30
+ }
31
+ catch (e) {
32
+ handlers.delete(handle);
33
+ throw e;
34
+ }
35
+ return async () => {
36
+ if (!handlers.delete(handle))
37
+ return;
38
+ await call("krate/shortcut.unregister", [handle]);
39
+ if (handlers.size === 0) {
40
+ stop?.();
41
+ stop = undefined;
42
+ }
43
+ };
44
+ }
@@ -0,0 +1,6 @@
1
+ import type { Impl } from "./types.js";
2
+ export { createFakeHost } from "./fakehost.js";
3
+ export type { FakeHost, FakeHandler } from "./fakehost.js";
4
+ export declare function mockHost(moduleId: string, impl: Impl): void;
5
+ export declare function resetHostMocks(): void;
6
+ //# sourceMappingURL=testing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3D,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
@@ -0,0 +1,9 @@
1
+ import { clearMocks, setMock } from "./mock.js";
2
+ export { createFakeHost } from "./fakehost.js";
3
+ // mockHost routes call/stream/signal for one module to impl, with no network.
4
+ export function mockHost(moduleId, impl) {
5
+ setMock(moduleId, impl);
6
+ }
7
+ export function resetHostMocks() {
8
+ clearMocks();
9
+ }
@@ -0,0 +1,12 @@
1
+ import { type SubscribeOptions } from "./events.js";
2
+ export type ThemeSource = "system" | "light" | "dark";
3
+ export interface Theme {
4
+ scheme: "light" | "dark";
5
+ highContrast: boolean;
6
+ system: "light" | "dark";
7
+ source: ThemeSource;
8
+ }
9
+ export declare function getTheme(): Promise<Theme>;
10
+ export declare function setTheme(source: ThemeSource): Promise<void>;
11
+ export declare function onThemeChange(fn: (t: Theme) => void, opts?: SubscribeOptions): () => void;
12
+ //# sourceMappingURL=theme.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,KAAK;IAEpB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IAEtB,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,CAEzC;AAGD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAEzF"}
package/dist/theme.js ADDED
@@ -0,0 +1,13 @@
1
+ // The system appearance and the app's title bars. Needs the "theme" permission.
2
+ import { call } from "./index.js";
3
+ import { subscribe } from "./events.js";
4
+ export function getTheme() {
5
+ return call("krate/theme.get", []);
6
+ }
7
+ // set makes native title bars and dialogs light, dark or follow the system.
8
+ export function setTheme(source) {
9
+ return call("krate/theme.set", [source]);
10
+ }
11
+ export function onThemeChange(fn, opts) {
12
+ return subscribe("krate/theme.events", fn, opts);
13
+ }
package/dist/tray.d.ts ADDED
@@ -0,0 +1,18 @@
1
+ import { type SubscribeOptions } from "./events.js";
2
+ import { type MenuItem } from "./menu.js";
3
+ export interface TrayOptions {
4
+ tooltip?: string;
5
+ title?: string;
6
+ icon?: Uint8Array;
7
+ menu?: MenuItem[];
8
+ }
9
+ export type TrayEventKind = "click" | "middle-click" | "right-click" | "menu";
10
+ export interface TrayEvent {
11
+ kind: TrayEventKind;
12
+ id: string;
13
+ }
14
+ export declare function set(o: TrayOptions): Promise<void>;
15
+ export declare function remove(): Promise<void>;
16
+ export declare function onEvent(fn: (e: TrayEvent) => void, opts?: SubscribeOptions): () => void;
17
+ export declare function onClick(fn: () => void, opts?: SubscribeOptions): () => void;
18
+ //# sourceMappingURL=tray.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../src/tray.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,EAAE,UAAU,CAAC;IAGlB,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IAEpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAGD,wBAAgB,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjD;AAED,wBAAgB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtC;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAEvF;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAI3E"}
package/dist/tray.js ADDED
@@ -0,0 +1,23 @@
1
+ // System tray icon. Needs the "tray" permission. Linux needs a
2
+ // StatusNotifier host; without one set() rejects with code "unsupported".
3
+ import { call } from "./index.js";
4
+ import { subscribe } from "./events.js";
5
+ import { toWire } from "./menu.js";
6
+ // set shows or updates the tray icon.
7
+ export function set(o) {
8
+ return call("krate/tray.set", [
9
+ { tooltip: o.tooltip ?? "", title: o.title ?? "", icon: o.icon ?? new Uint8Array(0), menu: toWire(o.menu ?? []) },
10
+ ]);
11
+ }
12
+ export function remove() {
13
+ return call("krate/tray.remove");
14
+ }
15
+ export function onEvent(fn, opts) {
16
+ return subscribe("krate/tray.events", fn, opts);
17
+ }
18
+ export function onClick(fn, opts) {
19
+ return onEvent((e) => {
20
+ if (e.kind === "click")
21
+ fn();
22
+ }, opts);
23
+ }
@@ -0,0 +1,16 @@
1
+ export interface HostSignal<T> {
2
+ get(): T;
3
+ set(v: T): void;
4
+ update(f: (prev: T) => T): void;
5
+ subscribe(fn: (v: T) => void): () => void;
6
+ }
7
+ export interface ReadonlyHostSignal<T, R = T> {
8
+ (): R;
9
+ subscribe(fn: (v: T) => void): () => void;
10
+ }
11
+ export interface CallOptions {
12
+ signal?: AbortSignal;
13
+ dedupe?: boolean;
14
+ }
15
+ export type Impl = Record<string, any>;
16
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,GAAG,IAAI,CAAC,CAAC;IACT,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3C;AAKD,MAAM,WAAW,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;IAC1C,IAAI,CAAC,CAAC;IACN,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC"}
package/dist/types.js ADDED
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,36 @@
1
+ export interface UpdateInfo {
2
+ version: string;
3
+ notes: string;
4
+ pubDate: string;
5
+ size: number;
6
+ critical: boolean;
7
+ required: boolean;
8
+ delta: boolean;
9
+ downloadSize: number;
10
+ }
11
+ export interface RollbackEvent {
12
+ failed: string;
13
+ restored: string;
14
+ reason: string;
15
+ at: string;
16
+ }
17
+ export interface UpdaterStatus {
18
+ version: string;
19
+ channel: string;
20
+ unconfirmed: boolean;
21
+ rollback: RollbackEvent | null;
22
+ }
23
+ export interface DownloadProgress {
24
+ done: number;
25
+ total: number;
26
+ }
27
+ export declare function check(): Promise<UpdateInfo | null>;
28
+ export declare function download(onProgress?: (p: DownloadProgress) => void): Promise<void>;
29
+ export declare function apply(): Promise<void>;
30
+ export declare function relaunch(): Promise<void>;
31
+ export declare function markHealthy(): Promise<void>;
32
+ export declare function status(): Promise<UpdaterStatus>;
33
+ export declare function ackRollback(): Promise<void>;
34
+ export declare function setChannel(channel: string): Promise<void>;
35
+ export declare function update(onProgress?: (p: DownloadProgress) => void): Promise<UpdateInfo | null>;
36
+ //# sourceMappingURL=updater.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,OAAO,CAAC;IAGlB,QAAQ,EAAE,OAAO,CAAC;IAGlB,KAAK,EAAE,OAAO,CAAC;IAEf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAE5B,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAEf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,OAAO,CAAC;IAErB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,KAAK,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAElD;AAMD,wBAAsB,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxF;AAKD,wBAAgB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErC;AAGD,wBAAgB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExC;AAMD,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;AAGD,wBAAgB,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAE/C;AAGD,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3C;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzD;AAID,wBAAsB,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAMnG"}
@@ -0,0 +1,58 @@
1
+ // In-app updates: check a feed, download with progress, apply and relaunch.
2
+ // Needs the "updater" permission and native.updater.{url,publicKey} in the
3
+ // app configuration. Host ids krate/updater.*.
4
+ import { call, stream } from "./index.js";
5
+ // Asks the update feed. Resolves null when the app is up to date.
6
+ // Rejects with code "unsupported" when native.updater is not configured.
7
+ export function check() {
8
+ return call("krate/updater.check");
9
+ }
10
+ // Downloads and verifies the update found by check(). onProgress is called
11
+ // as bytes arrive. Rejects with code "bad_signature" when the file does not
12
+ // match the signature in the feed; the file is then deleted. An interrupted
13
+ // download resumes on the next call.
14
+ export async function download(onProgress) {
15
+ for await (const p of stream("krate/updater.download")) {
16
+ onProgress?.(p);
17
+ }
18
+ }
19
+ // Replaces the installed app with the downloaded update. The running process
20
+ // keeps running the old code until relaunch(). Rejects with code
21
+ // "not_downloaded" before download() has finished.
22
+ export function apply() {
23
+ return call("krate/updater.apply");
24
+ }
25
+ // Starts the new version and quits this process.
26
+ export function relaunch() {
27
+ return call("krate/updater.relaunch");
28
+ }
29
+ // Confirms that this version started fine. The shell does this by itself a
30
+ // few seconds after the first page was served; call it yourself when
31
+ // native.updater.confirm is "app". Until it runs, a crash or exit makes the
32
+ // next launch restore the previous version.
33
+ export function markHealthy() {
34
+ return call("krate/updater.markHealthy");
35
+ }
36
+ // The running version, the update channel and, after a rollback, the event.
37
+ export function status() {
38
+ return call("krate/updater.status");
39
+ }
40
+ // Clears the rollback event reported by status().
41
+ export function ackRollback() {
42
+ return call("krate/updater.ackRollback");
43
+ }
44
+ // Chooses the update channel ("stable", "beta", ...) for this install; it is
45
+ // kept across runs and fills {channel} in native.updater.url.
46
+ export function setChannel(channel) {
47
+ return call("krate/updater.setChannel", [channel]);
48
+ }
49
+ // check, download, apply: resolves the applied version, or null when up to
50
+ // date. The caller decides when to relaunch.
51
+ export async function update(onProgress) {
52
+ const info = await check();
53
+ if (!info)
54
+ return null;
55
+ await download(onProgress);
56
+ await apply();
57
+ return info;
58
+ }
@@ -0,0 +1,154 @@
1
+ import { type SubscribeOptions } from "./events.js";
2
+ export interface WindowOptions {
3
+ title?: string;
4
+ width?: number;
5
+ height?: number;
6
+ path?: string;
7
+ fixed?: boolean;
8
+ frameless?: boolean;
9
+ alwaysOnTop?: boolean;
10
+ fullscreen?: boolean;
11
+ maximized?: boolean;
12
+ position?: {
13
+ x: number;
14
+ y: number;
15
+ };
16
+ titleBar?: "native" | "hidden" | "none";
17
+ transparent?: boolean;
18
+ backdrop?: "none" | "mica" | "micaAlt" | "acrylic";
19
+ vibrancy?: string;
20
+ titleBarOverlay?: boolean | {
21
+ color?: string;
22
+ symbolColor?: string;
23
+ height?: number;
24
+ };
25
+ trafficLightPosition?: {
26
+ x: number;
27
+ y: number;
28
+ };
29
+ tabbingIdentifier?: string;
30
+ tabbingMode?: "auto" | "preferred" | "disallowed";
31
+ preventClose?: boolean;
32
+ permissions?: string[];
33
+ }
34
+ export interface HideOptions {
35
+ release?: boolean;
36
+ }
37
+ export interface WindowState {
38
+ x: number;
39
+ y: number;
40
+ width: number;
41
+ height: number;
42
+ maximized: boolean;
43
+ minimized: boolean;
44
+ fullscreen: boolean;
45
+ alwaysOnTop: boolean;
46
+ decorated: boolean;
47
+ visible: boolean;
48
+ focused: boolean;
49
+ title: string;
50
+ }
51
+ export type WindowEventKind = "close-requested" | "closed" | "focus" | "blur" | "released" | "restored";
52
+ export interface WindowEvent {
53
+ window: string;
54
+ kind: WindowEventKind;
55
+ }
56
+ export declare class Window {
57
+ readonly id: string;
58
+ constructor(id: string);
59
+ private cmd;
60
+ close(): Promise<void>;
61
+ setTitle(title: string): Promise<void>;
62
+ setSize(width: number, height: number): Promise<void>;
63
+ setPosition(x: number, y: number): Promise<void>;
64
+ setAlwaysOnTop(on: boolean): Promise<void>;
65
+ setFullscreen(on: boolean): Promise<void>;
66
+ setFrameless(on: boolean): Promise<void>;
67
+ minimize(): Promise<void>;
68
+ maximize(): Promise<void>;
69
+ restore(): Promise<void>;
70
+ focus(): Promise<void>;
71
+ show(): Promise<void>;
72
+ hide(opts?: HideOptions): Promise<void>;
73
+ setPreventClose(on: boolean): Promise<void>;
74
+ navigate(path: string): Promise<void>;
75
+ state(): Promise<WindowState>;
76
+ addView(o?: ViewOptions): Promise<View>;
77
+ views(): Promise<ViewInfo[]>;
78
+ setLayout(layout: Layout): Promise<void>;
79
+ layout(): Promise<Layout>;
80
+ onCloseRequested(fn: () => void, opts?: SubscribeOptions): () => void;
81
+ }
82
+ export type Side = "right" | "left" | "top" | "bottom";
83
+ export interface ViewOptions {
84
+ id?: string;
85
+ path?: string;
86
+ beside?: string | View;
87
+ side?: Side;
88
+ size?: number;
89
+ minWidth?: number;
90
+ minHeight?: number;
91
+ permissions?: string[];
92
+ }
93
+ export interface ViewInfo {
94
+ id: string;
95
+ window: string;
96
+ path: string;
97
+ primary: boolean;
98
+ }
99
+ export type Layout = {
100
+ view: string | View;
101
+ minWidth?: number;
102
+ minHeight?: number;
103
+ } | {
104
+ direction: "horizontal" | "vertical";
105
+ ratio?: number;
106
+ first: Layout;
107
+ second: Layout;
108
+ };
109
+ export type ViewEventKind = "added" | "removed" | "navigated" | "closed";
110
+ export interface ViewEvent {
111
+ view: string;
112
+ window: string;
113
+ kind: ViewEventKind;
114
+ path: string;
115
+ }
116
+ export interface ViewMessage {
117
+ from: string;
118
+ data: unknown;
119
+ }
120
+ export declare function pane(view: string | View, min?: {
121
+ minWidth?: number;
122
+ minHeight?: number;
123
+ }): Layout;
124
+ export declare function split(direction: "horizontal" | "vertical", first: Layout, second: Layout, ratio?: number): Layout;
125
+ export declare class View {
126
+ readonly id: string;
127
+ constructor(id: string);
128
+ remove(): Promise<void>;
129
+ focus(): Promise<void>;
130
+ navigate(path: string): Promise<void>;
131
+ post(data: unknown): Promise<void>;
132
+ }
133
+ export declare function getView(id: string): View;
134
+ export declare function views(): Promise<ViewInfo[]>;
135
+ export declare function onViewEvent(fn: (e: ViewEvent) => void, opts?: SubscribeOptions): () => void;
136
+ export declare function onViewMessage(fn: (m: ViewMessage) => void): () => void;
137
+ export declare function main(): Window;
138
+ export declare function get(id: string): Window;
139
+ export declare function open(o?: WindowOptions): Promise<Window>;
140
+ export declare function list(): Promise<string[]>;
141
+ export declare function onEvent(fn: (e: WindowEvent) => void, opts?: SubscribeOptions): () => void;
142
+ export declare function onMemoryPressure(fn: () => void): () => void;
143
+ export interface FileDropEvent {
144
+ view: string;
145
+ window: string;
146
+ paths: string[];
147
+ x: number;
148
+ y: number;
149
+ }
150
+ export interface FileDropOptions extends SubscribeOptions {
151
+ all?: boolean;
152
+ }
153
+ export declare function onFileDrop(fn: (e: FileDropEvent) => void, opts?: FileDropOptions): () => void;
154
+ //# sourceMappingURL=window.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"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"}