winui-svelte 0.0.4 → 0.0.6

package/dist/app/activation/registration.js

@@ -0,0 +1,248 @@
+import { commandLineOf } from "./command.js";
+import { normalizeExtension, normalizeScheme, requireIdentifier } from "./scheme.js";
+import { DomErrorName, domException } from "../../web-apis/dom-exception.js";
+// What the package writes under HKEY_CURRENT_USER so that Windows starts the
+// app: the protocol and file type classes, and the startup entry. Every key
+// it creates carries OWNER_VALUE, and it overwrites or deletes only keys that
+// carry it, so it never touches another program's registration.
+/** The argument the startup entry adds; an activation that has it is a `startup` one. */
+export const STARTUP_ARGUMENT = "--winui-svelte-startup";
+const CLASSES = "Software\\Classes";
+const RUN_KEY = "Software\\Microsoft\\Windows\\CurrentVersion\\Run";
+/** The value every key this package creates carries. */
+export const OWNER_VALUE = "WinuiSvelte";
+/** What `OWNER_VALUE` holds. */
+export const OWNED = "1";
+const OPEN_COMMAND = "shell\\open\\command";
+const OPEN_WITH_PROGIDS = "OpenWithProgids";
+const URL_PROTOCOL_VALUE = "URL Protocol";
+const DEFAULT_VALUE = "";
+/**
+ * Whether this package created a key: it carries the marker value.
+ *
+ * @param options - The registry and the key.
+ * @returns True when the key has the marker.
+ */
+export function isOwned({ registry, key }) {
+    return registry.readString({
+        key,
+        name: OWNER_VALUE
+    }) === OWNED;
+}
+function requireFree({ registry, key, label }) {
+    const isTaken = registry.hasKey(key) && !isOwned({
+        registry,
+        key
+    });
+    if (isTaken) {
+        throw domException({
+            name: DomErrorName.INVALID_STATE,
+            message: `${label} is already registered by another program`
+        });
+    }
+}
+function writeClass({ registry, key, description, commandLine }) {
+    registry.setString({
+        key,
+        name: DEFAULT_VALUE,
+        value: description
+    });
+    registry.setString({
+        key,
+        name: OWNER_VALUE,
+        value: OWNED
+    });
+    registry.setString({
+        key: `${key}\\${OPEN_COMMAND}`,
+        name: DEFAULT_VALUE,
+        value: commandLine
+    });
+}
+/**
+ * Makes `scheme:` links start the app: writes the class under
+ * `HKEY_CURRENT_USER\Software\Classes\<scheme>` with a command that ends in
+ * the link as one quoted argument.
+ *
+ * @param options - The scheme, a name for it and the registry and command to use.
+ * @throws {DOMException} `SecurityError` for a malformed or reserved scheme;
+ *   `InvalidStateError` when another program already owns that class.
+ */
+export function addProtocol({ scheme, displayName, registry, command }) {
+    const name = normalizeScheme(scheme);
+    const key = `${CLASSES}\\${name}`;
+    requireFree({
+        registry,
+        key,
+        label: `the scheme '${name}'`
+    });
+    writeClass({
+        registry,
+        key,
+        description: `URL:${displayName ?? name}`,
+        commandLine: commandLineOf({
+            command,
+            hasPlaceholder: true
+        })
+    });
+    registry.setString({
+        key,
+        name: URL_PROTOCOL_VALUE,
+        value: ""
+    });
+}
+/**
+ * Takes the registration of a scheme away, if this package made it.
+ *
+ * @param options - The scheme and the registry.
+ * @returns True when a registration was removed; false when there was none or
+ *   another program owns the class, which is left alone.
+ * @throws {DOMException} `SecurityError` for a malformed or reserved scheme.
+ */
+export function removeProtocol({ scheme, registry }) {
+    const key = `${CLASSES}\\${normalizeScheme(scheme)}`;
+    const isRemovable = isOwned({
+        registry,
+        key
+    });
+    if (!isRemovable) {
+        return false;
+    }
+    registry.deleteTree(key);
+    return true;
+}
+/**
+ * The ProgID of a file type this package registers for an app.
+ *
+ * @param options - The app's identifier and the extension with its dot.
+ * @returns The identifier followed by the extension.
+ */
+function progIdOf({ id, extension }) {
+    return `${requireIdentifier(id)}${normalizeExtension(extension)}`;
+}
+/**
+ * Lists the app among the programs that can open files with these
+ * extensions: a ProgID class with the open command, and its name under each
+ * extension's `OpenWithProgids`. It does not make the app the default;
+ * Windows protects that choice for the user.
+ *
+ * @param options - The app's identifier, the extensions with their dots, a description and the registry and command.
+ * @throws {DOMException} `SecurityError` for a malformed or executable extension;
+ *   `InvalidStateError` when another program owns the ProgID.
+ * @throws {TypeError} For an `id` that is not an identifier.
+ */
+export function addFileTypes({ id, extensions, description, registry, command }) {
+    const types = extensions.map(extension => ({
+        extension: normalizeExtension(extension),
+        progId: progIdOf({
+            id,
+            extension
+        })
+    }));
+    for (const { progId } of types) {
+        requireFree({
+            registry,
+            key: `${CLASSES}\\${progId}`,
+            label: `the file type '${progId}'`
+        });
+    }
+    const commandLine = commandLineOf({
+        command,
+        hasPlaceholder: true
+    });
+    for (const { extension, progId } of types) {
+        writeClass({
+            registry,
+            key: `${CLASSES}\\${progId}`,
+            description: description ?? `${extension} file`,
+            commandLine
+        });
+        registry.setString({
+            key: `${CLASSES}\\${extension}\\${OPEN_WITH_PROGIDS}`,
+            name: progId,
+            value: ""
+        });
+    }
+}
+/**
+ * Takes the file types away that `registerFileTypes` made, and the empty keys
+ * they leave under the extensions.
+ *
+ * @param options - The app's identifier, the extensions and the registry.
+ * @returns The extensions whose registration was removed.
+ */
+export function removeFileTypes({ id, extensions, registry }) {
+    const removed = [];
+    for (const extension of extensions) {
+        const lower = normalizeExtension(extension);
+        const progId = progIdOf({
+            id,
+            extension
+        });
+        const key = `${CLASSES}\\${progId}`;
+        const isRemovable = isOwned({
+            registry,
+            key
+        });
+        if (!isRemovable) {
+            continue;
+        }
+        registry.deleteTree(key);
+        const withProgIds = `${CLASSES}\\${lower}\\${OPEN_WITH_PROGIDS}`;
+        registry.deleteValue({
+            key: withProgIds,
+            name: progId
+        });
+        registry.deleteKeyIfEmpty(withProgIds);
+        registry.deleteKeyIfEmpty(`${CLASSES}\\${lower}`);
+        removed.push(lower);
+    }
+    return removed;
+}
+/**
+ * Adds the app's entry to the per-user Run key; Windows lists it under
+ * Settings, Apps, Startup. The command adds `STARTUP_ARGUMENT` so that the app
+ * can tell a start at sign-in from a start by hand.
+ *
+ * @param options - The entry's name, extra arguments and the registry and command.
+ * @throws {TypeError} For an `id` that is not an identifier.
+ */
+export function enableLaunchAtLogin({ id, arguments: extra = [], registry, command }) {
+    registry.setString({
+        key: RUN_KEY,
+        name: requireIdentifier(id),
+        value: commandLineOf({
+            command,
+            extra: [STARTUP_ARGUMENT, ...extra]
+        })
+    });
+}
+/**
+ * Removes the app's entry from the per-user Run key.
+ *
+ * @param options - The entry's name and the registry.
+ * @throws {TypeError} For an `id` that is not an identifier.
+ */
+export function disableLaunchAtLogin({ id, registry }) {
+    registry.deleteValue({
+        key: RUN_KEY,
+        name: requireIdentifier(id)
+    });
+}
+/**
+ * Reads the startup entry back.
+ *
+ * @param options - The entry's name and the registry.
+ * @returns Whether it exists and what it runs.
+ * @throws {TypeError} For an `id` that is not an identifier.
+ */
+export function readLaunchAtLogin({ id, registry }) {
+    const commandLine = registry.readString({
+        key: RUN_KEY,
+        name: requireIdentifier(id)
+    });
+    return {
+        isEnabled: commandLine !== undefined,
+        commandLine
+    };
+}
+//# sourceMappingURL=registration.js.map

package/dist/app/activation/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../src/app/activation/registration.ts"],"names":[],"mappings":"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"}

package/dist/app/activation/registry.d.ts

@@ -0,0 +1,23 @@
+/** Where a value is: a key below `HKEY_CURRENT_USER` and a value name (empty for the key's default value). */
+export interface ValueAddress {
+    readonly key: string;
+    readonly name: string;
+}
+/** The registry operations the registrations need; a test gives a fake. */
+export interface RegistryBackend {
+    /** Writes a string value, creating the key and its parents. */
+    setString(options: ValueAddress & {
+        value: string;
+    }): void;
+    /** Reads a string value; `undefined` when the key or the value is missing. */
+    readString(address: ValueAddress): string | undefined;
+    /** Whether the key exists. */
+    hasKey(key: string): boolean;
+    /** Deletes the key and everything under it; nothing happens when it is missing. */
+    deleteTree(key: string): void;
+    /** Deletes one value; nothing happens when it is missing. */
+    deleteValue(address: ValueAddress): void;
+    /** Deletes the key only when it has no values and no subkeys; returns whether it was deleted. */
+    deleteKeyIfEmpty(key: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/app/activation/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/app/activation/registry.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE3D,8EAA8E;IAC9E,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IAEtD,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B,mFAAmF;IACnF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,6DAA6D;IAC7D,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEzC,iGAAiG;IACjG,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC"}

package/dist/app/activation/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/app/activation/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/app/activation/registry.ts"],"names":[],"mappings":""}

package/dist/app/activation/scheme.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Checks a URL scheme against RFC 3986 (a letter, then letters, digits, `+`,
+ * `-` and `.`), the system's and the browsers' schemes, and drive letters
+ * (a scheme is two characters or more).
+ *
+ * @param scheme - The scheme, without the colon; any case.
+ * @returns The scheme in lower case.
+ * @throws {DOMException} `SecurityError` when it is malformed, too long or reserved.
+ */
+export declare function normalizeScheme(scheme: string): string;
+/**
+ * Checks a file extension: a dot and lower case letters, digits, `_` or `-`,
+ * and not one that runs code.
+ *
+ * @param extension - The extension with its dot, any case.
+ * @returns The extension in lower case.
+ * @throws {DOMException} `SecurityError` when it is malformed or executable.
+ */
+export declare function normalizeExtension(extension: string): string;
+/**
+ * Whether a name is an identifier (see `requireIdentifier`), without throwing.
+ *
+ * @param identifier - The name.
+ * @returns True when it is one.
+ */
+export declare function isIdentifier(identifier: string): boolean;
+/**
+ * Checks the name an app picks for itself (a startup entry, a file type's
+ * ProgID prefix): letters, digits, `.`, `_` and `-`, starting with a letter or digit.
+ *
+ * @param identifier - The name.
+ * @returns The same name.
+ * @throws {TypeError} When it is empty, too long or has another character.
+ */
+export declare function requireIdentifier(identifier: string): string;
+/**
+ * Whether a scheme is acceptable, without throwing.
+ *
+ * @param scheme - The scheme.
+ * @returns True when `normalizeScheme` would accept it.
+ */
+export declare function isRegistrableScheme(scheme: string): boolean;
+//# sourceMappingURL=scheme.d.ts.map

package/dist/app/activation/scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../../../src/app/activation/scheme.ts"],"names":[],"mappings":"AAsCA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,UAa7C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,UAYnD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,WAE9C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,UAOnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,WAOjD"}

package/dist/app/activation/scheme.js

@@ -0,0 +1,112 @@
+import { DomErrorName, domException } from "../../web-apis/dom-exception.js";
+const SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*$/u;
+const MAX_SCHEME_LENGTH = 64;
+const MIN_SCHEME_LENGTH = 2;
+const IDENTIFIER_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/u;
+const MAX_IDENTIFIER_LENGTH = 64;
+const EXTENSION_PATTERN = /^\.[a-z0-9_-]+$/u;
+const MAX_EXTENSION_LENGTH = 32;
+const RESERVED_PREFIXES = ["ms-", "microsoft", "windows", "ie."];
+// Schemes the system or a browser owns: a link of these must never reach an
+// app by a registration this package makes.
+const RESERVED_SCHEMES = new Set([
+    "about", "blob", "callto", "data", "feed", "file", "ftp", "ftps", "gopher", "http", "https", "irc", "javascript",
+    "ldap", "ldaps", "mailto", "mk", "mms", "news", "nntp", "res", "rtsp", "search", "search-ms", "shell", "sms",
+    "ssh", "tel", "telnet", "view-source", "vbscript", "webcal", "ws", "wss"
+]);
+// Extensions that run code or change the system when opened.
+const EXECUTABLE_EXTENSIONS = new Set([
+    ".appx", ".bat", ".cmd", ".com", ".cpl", ".dll", ".exe", ".hta", ".inf", ".js", ".jse", ".lnk", ".msc", ".msi",
+    ".msix", ".pif", ".ps1", ".reg", ".scr", ".sys", ".url", ".vbe", ".vbs", ".wsf", ".wsh"
+]);
+function isReserved(scheme) {
+    const isListed = RESERVED_SCHEMES.has(scheme);
+    const hasReservedPrefix = RESERVED_PREFIXES.some(prefix => scheme.startsWith(prefix));
+    return isListed || hasReservedPrefix;
+}
+function rejected(message) {
+    return domException({
+        name: DomErrorName.SECURITY,
+        message
+    });
+}
+/**
+ * Checks a URL scheme against RFC 3986 (a letter, then letters, digits, `+`,
+ * `-` and `.`), the system's and the browsers' schemes, and drive letters
+ * (a scheme is two characters or more).
+ *
+ * @param scheme - The scheme, without the colon; any case.
+ * @returns The scheme in lower case.
+ * @throws {DOMException} `SecurityError` when it is malformed, too long or reserved.
+ */
+export function normalizeScheme(scheme) {
+    const lower = scheme.toLowerCase();
+    const isLengthValid = lower.length >= MIN_SCHEME_LENGTH && lower.length <= MAX_SCHEME_LENGTH;
+    const isWellFormed = SCHEME_PATTERN.test(lower) && isLengthValid;
+    if (!isWellFormed) {
+        throw rejected(`'${scheme}' is not a URL scheme: a letter, then letters, digits, + - or ., ${MIN_SCHEME_LENGTH} to ${MAX_SCHEME_LENGTH} characters`);
+    }
+    if (isReserved(lower)) {
+        throw rejected(`the scheme '${lower}' belongs to the system or the browsers and cannot be registered`);
+    }
+    return lower;
+}
+/**
+ * Checks a file extension: a dot and lower case letters, digits, `_` or `-`,
+ * and not one that runs code.
+ *
+ * @param extension - The extension with its dot, any case.
+ * @returns The extension in lower case.
+ * @throws {DOMException} `SecurityError` when it is malformed or executable.
+ */
+export function normalizeExtension(extension) {
+    const lower = extension.toLowerCase();
+    const isWellFormed = EXTENSION_PATTERN.test(lower) && lower.length <= MAX_EXTENSION_LENGTH;
+    if (!isWellFormed) {
+        throw rejected(`'${extension}' is not a file extension: a dot, then letters, digits, _ or -`);
+    }
+    if (EXECUTABLE_EXTENSIONS.has(lower)) {
+        throw rejected(`the extension '${lower}' runs code and cannot be registered`);
+    }
+    return lower;
+}
+/**
+ * Whether a name is an identifier (see `requireIdentifier`), without throwing.
+ *
+ * @param identifier - The name.
+ * @returns True when it is one.
+ */
+export function isIdentifier(identifier) {
+    return IDENTIFIER_PATTERN.test(identifier) && identifier.length <= MAX_IDENTIFIER_LENGTH;
+}
+/**
+ * Checks the name an app picks for itself (a startup entry, a file type's
+ * ProgID prefix): letters, digits, `.`, `_` and `-`, starting with a letter or digit.
+ *
+ * @param identifier - The name.
+ * @returns The same name.
+ * @throws {TypeError} When it is empty, too long or has another character.
+ */
+export function requireIdentifier(identifier) {
+    const isValid = isIdentifier(identifier);
+    if (!isValid) {
+        throw new TypeError(`'${identifier}' is not an identifier: letters, digits, . _ and -, up to ${MAX_IDENTIFIER_LENGTH} characters`);
+    }
+    return identifier;
+}
+/**
+ * Whether a scheme is acceptable, without throwing.
+ *
+ * @param scheme - The scheme.
+ * @returns True when `normalizeScheme` would accept it.
+ */
+export function isRegistrableScheme(scheme) {
+    try {
+        normalizeScheme(scheme);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=scheme.js.map

package/dist/app/activation/scheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.js","sourceRoot":"","sources":["../../../src/app/activation/scheme.ts"],"names":[],"mappings":"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"}

package/dist/app/hotkeys/errors.d.ts

@@ -0,0 +1,22 @@
+/** Why a hotkey could not be registered. */
+export declare class HotkeyError extends Error {
+    readonly name: string;
+}
+/** The keys are not a hotkey: an empty or unknown part, a modifier named twice, or no key. */
+export declare class HotkeyParseError extends HotkeyError {
+    readonly name: string;
+}
+/** Another app, or this one, already owns the combination (`ERROR_HOTKEY_ALREADY_REGISTERED`). */
+export declare class HotkeyConflictError extends HotkeyError {
+    readonly name: string;
+}
+/** Windows refused the hotkey for another reason, such as a reserved combination; `code` is its error code. */
+export declare class HotkeyRefusedError extends HotkeyError {
+    readonly name: string;
+    readonly code: number;
+    constructor({ message, code }: {
+        message: string;
+        code: number;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/app/hotkeys/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/app/hotkeys/errors.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,EAAE,MAAM,CAAiB;CAChD;AAED,8FAA8F;AAC9F,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,SAAkB,IAAI,EAAE,MAAM,CAAsB;CACrD;AAED,kGAAkG;AAClG,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,SAAkB,IAAI,EAAE,MAAM,CAAyB;CACxD;AAED,+GAA+G;AAC/G,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,SAAkB,IAAI,EAAE,MAAM,CAAwB;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd;CAIF"}

package/dist/app/hotkeys/errors.js

@@ -0,0 +1,23 @@
+// What registering a hotkey can fail with.
+/** Why a hotkey could not be registered. */
+export class HotkeyError extends Error {
+    name = "HotkeyError";
+}
+/** The keys are not a hotkey: an empty or unknown part, a modifier named twice, or no key. */
+export class HotkeyParseError extends HotkeyError {
+    name = "HotkeyParseError";
+}
+/** Another app, or this one, already owns the combination (`ERROR_HOTKEY_ALREADY_REGISTERED`). */
+export class HotkeyConflictError extends HotkeyError {
+    name = "HotkeyConflictError";
+}
+/** Windows refused the hotkey for another reason, such as a reserved combination; `code` is its error code. */
+export class HotkeyRefusedError extends HotkeyError {
+    name = "HotkeyRefusedError";
+    code;
+    constructor({ message, code }) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/app/hotkeys/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/app/hotkeys/errors.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,4CAA4C;AAC5C,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClB,IAAI,GAAW,aAAa,CAAC;CAChD;AAED,8FAA8F;AAC9F,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC7B,IAAI,GAAW,kBAAkB,CAAC;CACrD;AAED,kGAAkG;AAClG,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAChC,IAAI,GAAW,qBAAqB,CAAC;CACxD;AAED,+GAA+G;AAC/G,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IAC/B,IAAI,GAAW,oBAAoB,CAAC;IAC7C,IAAI,CAAS;IAEtB,YAAY,EAAE,OAAO,EAAE,IAAI,EAG1B;QACC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/app/hotkeys/index.d.ts

@@ -0,0 +1,30 @@
+import type { HotkeyOptions } from "./registry.js";
+export type { HotkeyChord, HotkeyKeyName, HotkeyKeys } from "./keys.js";
+export { HotkeyModifier } from "./keys.js";
+export { HotkeyConflictError, HotkeyError, HotkeyParseError, HotkeyRefusedError } from "./errors.js";
+export type { Hotkey, HotkeyEvent, HotkeyOptions } from "./registry.js";
+/**
+ * Registers a system-wide hotkey: `onpressed` runs on the UI thread each time
+ * the combination is pressed, whichever app has the focus. There is no web
+ * analogue (a page cannot own a global key), so the callback is told a
+ * `KeyboardEvent`-like object.
+ *
+ * Call it on the thread whose message pump runs (the UI thread, from
+ * `onStart` or a component); the hotkeys belong to that thread, are given back
+ * by `unregister`, and are freed by Windows when the thread ends. Nothing is
+ * heard while that pump is not running. The combination is not repeated while
+ * the keys stay down unless `isRepeatAllowed` is true.
+ *
+ * @param options - The combination and the callback.
+ * @returns The registration; call `unregister` to give the combination back.
+ * @throws HotkeyParseError When `keys` is not a hotkey.
+ * @throws HotkeyConflictError When another app already owns the combination.
+ * @throws HotkeyRefusedError When Windows refuses it, as it does for the ones it reserves (Win+L).
+ */
+export declare function registerHotkey(options: HotkeyOptions): {
+    id: number;
+    keys: string;
+    readonly isRegistered: boolean;
+    unregister(): void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/app/hotkeys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/hotkeys/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAUnD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACrG,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAwCxE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa;;;;;EAEpD"}

package/dist/app/hotkeys/index.js

@@ -0,0 +1,59 @@
+import { createHotkeyWin32 } from "./native.js";
+import { createHotkeyRegistry, WM_HOTKEY } from "./registry.js";
+import { reportUiError } from "../../ui-errors.js";
+import { addMessageHook } from "../../window/message-hooks.js";
+export { HotkeyModifier } from "./keys.js";
+export { HotkeyConflictError, HotkeyError, HotkeyParseError, HotkeyRefusedError } from "./errors.js";
+const NO_WINDOW = 0n;
+const SHARED_KEY = Symbol.for("winui-svelte.hotkeys");
+function createThreadRegistry() {
+    const registry = createHotkeyRegistry({
+        win32: createHotkeyWin32(),
+        onerror(error) {
+            reportUiError({
+                error,
+                origin: "hotkey onpressed"
+            });
+        }
+    });
+    addMessageHook(({ hwnd, id, wParam }) => {
+        const isThreadMessage = hwnd === NO_WINDOW;
+        const isHotkey = isThreadMessage && id === WM_HOTKEY;
+        return isHotkey && registry.press(Number(wParam));
+    });
+    return registry;
+}
+function isThreadRegistry(value) {
+    return typeof value === "object" && value !== null && "register" in value && "press" in value;
+}
+function registryOfThread() {
+    const existing = Object.getOwnPropertyDescriptor(globalThis, SHARED_KEY)?.value;
+    if (isThreadRegistry(existing)) {
+        return existing;
+    }
+    const created = createThreadRegistry();
+    Object.defineProperty(globalThis, SHARED_KEY, { value: created });
+    return created;
+}
+/**
+ * Registers a system-wide hotkey: `onpressed` runs on the UI thread each time
+ * the combination is pressed, whichever app has the focus. There is no web
+ * analogue (a page cannot own a global key), so the callback is told a
+ * `KeyboardEvent`-like object.
+ *
+ * Call it on the thread whose message pump runs (the UI thread, from
+ * `onStart` or a component); the hotkeys belong to that thread, are given back
+ * by `unregister`, and are freed by Windows when the thread ends. Nothing is
+ * heard while that pump is not running. The combination is not repeated while
+ * the keys stay down unless `isRepeatAllowed` is true.
+ *
+ * @param options - The combination and the callback.
+ * @returns The registration; call `unregister` to give the combination back.
+ * @throws HotkeyParseError When `keys` is not a hotkey.
+ * @throws HotkeyConflictError When another app already owns the combination.
+ * @throws HotkeyRefusedError When Windows refuses it, as it does for the ones it reserves (Win+L).
+ */
+export function registerHotkey(options) {
+    return registryOfThread().register(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/app/hotkeys/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/app/hotkeys/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAS9D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGrG,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAEtD,SAAS,oBAAoB;IAC3B,MAAM,QAAQ,GAAG,oBAAoB,CAAC;QACpC,KAAK,EAAE,iBAAiB,EAAE;QAC1B,OAAO,CAAC,KAAK;YACX,aAAa,CAAC;gBACZ,KAAK;gBACL,MAAM,EAAE,kBAAkB;aAC3B,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;IACH,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,MAAM,eAAe,GAAG,IAAI,KAAK,SAAS,CAAC;QAC3C,MAAM,QAAQ,GAAG,eAAe,IAAI,EAAE,KAAK,SAAS,CAAC;QACrD,OAAO,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAID,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CAAC;AAChG,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAY,MAAM,CAAC,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IACzF,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAClE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,OAAO,gBAAgB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/app/hotkeys/keys.d.ts

@@ -0,0 +1,43 @@
+import { KeyCode } from "../../key-code.js";
+import type { KeyCodeName } from "../../key-code.js";
+/** The modifiers a hotkey takes; the order here is the order a combination is spelled in. */
+export declare const HotkeyModifier: {
+    readonly control: "control";
+    readonly alt: "alt";
+    readonly shift: "shift";
+    readonly windows: "windows";
+};
+/** One of `HotkeyModifier`'s values. */
+export type HotkeyModifier = typeof HotkeyModifier[keyof typeof HotkeyModifier];
+type NameOf<Code extends string> = Code extends `key${infer Letter}` ? Lowercase<Letter> : Lowercase<Code>;
+/**
+ * The name of a key a hotkey can bind: `KeyCode`'s names in lowercase, with the
+ * letters bare (`k`, `digit5`, `arrowleft`, `f23`).
+ */
+export type HotkeyKeyName = NameOf<KeyCodeName>;
+/** A hotkey as an object: the modifiers held and the key pressed. */
+export interface HotkeyChord {
+    readonly modifiers?: readonly HotkeyModifier[] | undefined;
+    readonly key: HotkeyKeyName;
+}
+/** What a hotkey is written as: `"ctrl+alt+k"`, or a `HotkeyChord`. */
+export type HotkeyKeys = string | HotkeyChord;
+/**
+ * Reads a hotkey. A string is modifiers and one key joined by `+`, in any
+ * case: `ctrl+alt+k`, `win+shift+f23`, `ctrl+5`; `ctrl`, `control`, `alt`,
+ * `option`, `shift`, `win`, `windows`, `meta` and `super` are modifiers, and
+ * the key is a `KeyCode` name in lowercase or one of a few aliases (`esc`, `del`, `left`).
+ *
+ * @param keys - The string or the object.
+ * @returns The canonical form.
+ * @throws HotkeyParseError When the string is empty, names an unknown part, a modifier twice or no key.
+ */
+export declare function parseHotkey(keys: HotkeyKeys): {
+    modifiers: ("shift" | "control" | "alt" | "windows")[];
+    keyName: HotkeyKeyName;
+    virtualKey: KeyCode;
+    keys: string;
+    modifierFlags: number;
+};
+export {};
+//# sourceMappingURL=keys.d.ts.map