@harborclient/core 0.1.1

package/dist/search/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Search domains surfaced in the global command palette and grouped result lists.
+ */
+export type SearchDomain = 'collection' | 'folder' | 'request' | 'environment' | 'setting' | 'page' | 'plugin' | 'theme' | 'snippet';
+/**
+ * Display order for grouped search results in the command palette.
+ */
+export declare const SEARCH_DOMAIN_ORDER: SearchDomain[];
+/**
+ * Human-readable group labels keyed by search domain.
+ */
+export declare const SEARCH_DOMAIN_LABELS: Record<SearchDomain, string>;
+/**
+ * Maximum number of results shown in the global command palette.
+ */
+export declare const SEARCH_ANYTHING_MAX_RESULTS = 8;
+/**
+ * Whether a plugin or theme hit comes from the installed list or marketplace catalog.
+ */
+export type PluginListingSource = 'installed' | 'marketplace';
+/**
+ * One normalized hit returned by {@link searchAll} for rendering and navigation.
+ */
+export interface UnifiedSearchHit {
+    /** Result category used for grouping and navigation dispatch. */
+    domain: SearchDomain;
+    /** Stable identifier within the domain (composite sidebar id, setting id, plugin or theme id). */
+    id: string;
+    /** Primary label shown in the result row. */
+    title: string;
+    /** Secondary context line (collection name, setting description, plugin summary). */
+    subtitle?: string;
+    /** HTTP method badge for request hits. */
+    method?: string;
+    /** Orama relevance score for ordering within a domain. */
+    score: number;
+    /** Numeric collection id when the hit belongs to the collections tree. */
+    collectionId?: number;
+    /** Numeric folder id when the hit is scoped to a folder. */
+    folderId?: number | null;
+    /** Distinguishes installed vs marketplace plugin/theme hits in Action menu. */
+    pluginListingSource?: PluginListingSource;
+}
+/**
+ * Shared Orama full-text options used across HarborClient search indexes.
+ */
+export declare const DEFAULT_SEARCH_OPTIONS: {
+    /** Edit distance for typo-tolerant matching (approximates prior MiniSearch fuzzy). */
+    readonly tolerance: 1;
+    /** Match any query term; sidebar and settings override to 0 for AND matching. */
+    readonly threshold: 1;
+};
+/**
+ * Orama options requiring every query term to match (sidebar and settings search).
+ */
+export declare const AND_SEARCH_OPTIONS: {
+    readonly tolerance: 1;
+    readonly threshold: 0;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,QAAQ,GACR,SAAS,GACT,aAAa,GACb,SAAS,GACT,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAAY,EAU7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAU7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,EAAE,YAAY,CAAC;IACrB,kGAAkG;IAClG,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,sFAAsF;;IAEtF,iFAAiF;;CAEzE,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC"}

package/dist/search/types.js

@@ -0,0 +1,49 @@
+/**
+ * Display order for grouped search results in the command palette.
+ */
+export const SEARCH_DOMAIN_ORDER = [
+    'collection',
+    'folder',
+    'request',
+    'environment',
+    'setting',
+    'page',
+    'plugin',
+    'theme',
+    'snippet'
+];
+/**
+ * Human-readable group labels keyed by search domain.
+ */
+export const SEARCH_DOMAIN_LABELS = {
+    collection: 'Collections',
+    folder: 'Folders',
+    request: 'Requests',
+    environment: 'Environments',
+    setting: 'Settings',
+    page: 'Pages',
+    plugin: 'Plugins',
+    theme: 'Themes',
+    snippet: 'Snippet bundles'
+};
+/**
+ * Maximum number of results shown in the global command palette.
+ */
+export const SEARCH_ANYTHING_MAX_RESULTS = 8;
+/**
+ * Shared Orama full-text options used across HarborClient search indexes.
+ */
+export const DEFAULT_SEARCH_OPTIONS = {
+    /** Edit distance for typo-tolerant matching (approximates prior MiniSearch fuzzy). */
+    tolerance: 1,
+    /** Match any query term; sidebar and settings override to 0 for AND matching. */
+    threshold: 1
+};
+/**
+ * Orama options requiring every query term to match (sidebar and settings search).
+ */
+export const AND_SEARCH_OPTIONS = {
+    tolerance: DEFAULT_SEARCH_OPTIONS.tolerance,
+    threshold: 0
+};
+//# sourceMappingURL=types.js.map

package/dist/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,aAAa;IACb,SAAS;IACT,MAAM;IACN,QAAQ;IACR,OAAO;IACP,SAAS;CACV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,UAAU,EAAE,aAAa;IACzB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,UAAU;IACnB,WAAW,EAAE,cAAc;IAC3B,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AA+B7C;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,sFAAsF;IACtF,SAAS,EAAE,CAAC;IACZ,iFAAiF;IACjF,SAAS,EAAE,CAAC;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,sBAAsB,CAAC,SAAS;IAC3C,SAAS,EAAE,CAAC;CACJ,CAAC"}

package/dist/search/unified.d.ts

@@ -0,0 +1,57 @@
+import type { PluginCatalogEntry } from '../plugin/catalog';
+import type { PluginInfo } from '../plugin/types';
+import type { SnippetCatalogEntry } from '../snippet/catalog';
+import { type buildInstalledPluginSearchIndex } from './installedPlugins';
+import { type buildPluginCatalogSearchIndex } from './plugins';
+import { type buildSettingsSearchIndex } from './settings';
+import { type buildSnippetCatalogSearchIndexForSearch } from './snippets';
+import { type SidebarSearchInput, type buildSidebarSearchIndex } from './sidebar';
+import { type SearchDomain, type UnifiedSearchHit } from './types';
+/**
+ * Live search indexes and source data used by {@link searchAll}.
+ */
+export interface SearchAllContext {
+    /** Sidebar Orama index, or null when sidebar data is not ready. */
+    sidebarIndex: ReturnType<typeof buildSidebarSearchIndex> | null;
+    /** Settings Orama index (always available once built). */
+    settingsIndex: ReturnType<typeof buildSettingsSearchIndex>;
+    /** Plugin catalog Orama index, or null when catalog has not loaded. */
+    pluginsIndex: ReturnType<typeof buildPluginCatalogSearchIndex> | null;
+    /** Installed plugins Orama index, or null when the list is empty. */
+    installedPluginsIndex: ReturnType<typeof buildInstalledPluginSearchIndex> | null;
+    /** Sidebar entities for subtitle resolution and navigation. */
+    sidebarInput: SidebarSearchInput;
+    /** Loaded marketplace catalog rows. */
+    plugins: PluginCatalogEntry[];
+    /** Installed plugin rows from the main process. */
+    installedPlugins: PluginInfo[];
+    /** Snippet catalog Orama index, or null when catalog has not loaded. */
+    snippetsIndex: ReturnType<typeof buildSnippetCatalogSearchIndexForSearch> | null;
+    /** Loaded marketplace snippet bundle rows. */
+    snippets: SnippetCatalogEntry[];
+}
+/**
+ * Merges per-domain hit lists with round-robin selection up to the global cap.
+ *
+ * @param grouped - Hits keyed by domain in display order.
+ * @param maxResults - Maximum total hits to return.
+ */
+export declare function mergeSearchHitsRoundRobin(grouped: Record<SearchDomain, UnifiedSearchHit[]>, maxResults: number): UnifiedSearchHit[];
+/**
+ * Groups flat unified hits by domain for rendering section headings.
+ *
+ * @param hits - Flat result list from {@link searchAll}.
+ */
+export declare function groupUnifiedSearchHits(hits: UnifiedSearchHit[]): Array<{
+    domain: SearchDomain;
+    hits: UnifiedSearchHit[];
+}>;
+/**
+ * Runs unified search across sidebar, settings, and plugin indexes.
+ *
+ * @param query - Raw user search text.
+ * @param context - Warm indexes and lookup data.
+ * @returns Up to {@link SEARCH_ANYTHING_MAX_RESULTS} hits grouped via round-robin across domains.
+ */
+export declare function searchAll(query: string, context: SearchAllContext): UnifiedSearchHit[];
+//# sourceMappingURL=unified.d.ts.map

package/dist/search/unified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified.d.ts","sourceRoot":"","sources":["../../src/search/unified.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM9D,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAoB,KAAK,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAEjF,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAqB,KAAK,uCAAuC,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,YAAY,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,GAAG,IAAI,CAAC;IAChE,0DAA0D;IAC1D,aAAa,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC3D,uEAAuE;IACvE,YAAY,EAAE,UAAU,CAAC,OAAO,6BAA6B,CAAC,GAAG,IAAI,CAAC;IACtE,qEAAqE;IACrE,qBAAqB,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,GAAG,IAAI,CAAC;IACjF,+DAA+D;IAC/D,YAAY,EAAE,kBAAkB,CAAC;IACjC,uCAAuC;IACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,mDAAmD;IACnD,gBAAgB,EAAE,UAAU,EAAE,CAAC;IAC/B,wEAAwE;IACxE,aAAa,EAAE,UAAU,CAAC,OAAO,uCAAuC,CAAC,GAAG,IAAI,CAAC;IACjF,8CAA8C;IAC9C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC,EACjD,UAAU,EAAE,MAAM,GACjB,gBAAgB,EAAE,CA2BpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,gBAAgB,EAAE,GACvB,KAAK,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAS3D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAoGtF"}

package/dist/search/unified.js

@@ -0,0 +1,153 @@
+import { catalogEntryIsTheme, formatThemeDisplayName, pluginIsTheme } from '../plugin/themeCategory';
+import { searchInstalledPluginHits } from './installedPlugins';
+import { searchPluginHits } from './plugins';
+import { searchPageHits } from './pagesCatalog';
+import { searchSettingsHits } from './settings';
+import { searchSnippetHits } from './snippets';
+import { searchSidebarEntities, sidebarEntitySubtitle } from './sidebar';
+import { SEARCH_ANYTHING_MAX_RESULTS, SEARCH_DOMAIN_ORDER } from './types';
+/**
+ * Merges per-domain hit lists with round-robin selection up to the global cap.
+ *
+ * @param grouped - Hits keyed by domain in display order.
+ * @param maxResults - Maximum total hits to return.
+ */
+export function mergeSearchHitsRoundRobin(grouped, maxResults) {
+    const merged = [];
+    const indices = Object.fromEntries(SEARCH_DOMAIN_ORDER.map((domain) => [domain, 0]));
+    while (merged.length < maxResults) {
+        let added = false;
+        for (const domain of SEARCH_DOMAIN_ORDER) {
+            const list = grouped[domain];
+            const index = indices[domain];
+            if (index < list.length) {
+                merged.push(list[index]);
+                indices[domain] = index + 1;
+                added = true;
+                if (merged.length >= maxResults) {
+                    break;
+                }
+            }
+        }
+        if (!added) {
+            break;
+        }
+    }
+    return merged;
+}
+/**
+ * Groups flat unified hits by domain for rendering section headings.
+ *
+ * @param hits - Flat result list from {@link searchAll}.
+ */
+export function groupUnifiedSearchHits(hits) {
+    const groups = [];
+    for (const domain of SEARCH_DOMAIN_ORDER) {
+        const domainHits = hits.filter((hit) => hit.domain === domain);
+        if (domainHits.length > 0) {
+            groups.push({ domain, hits: domainHits });
+        }
+    }
+    return groups;
+}
+/**
+ * Runs unified search across sidebar, settings, and plugin indexes.
+ *
+ * @param query - Raw user search text.
+ * @param context - Warm indexes and lookup data.
+ * @returns Up to {@link SEARCH_ANYTHING_MAX_RESULTS} hits grouped via round-robin across domains.
+ */
+export function searchAll(query, context) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return [];
+    }
+    const grouped = {
+        collection: [],
+        folder: [],
+        request: [],
+        environment: [],
+        setting: [],
+        page: [],
+        plugin: [],
+        theme: [],
+        snippet: []
+    };
+    if (context.sidebarIndex != null) {
+        for (const hit of searchSidebarEntities(context.sidebarInput, context.sidebarIndex, trimmed)) {
+            grouped[hit.kind].push({
+                domain: hit.kind,
+                id: `${hit.kind}:${hit.entityId}`,
+                title: hit.name,
+                subtitle: sidebarEntitySubtitle(context.sidebarInput, hit),
+                method: hit.method,
+                score: hit.score,
+                collectionId: hit.collectionId,
+                folderId: hit.folderId
+            });
+        }
+    }
+    for (const hit of searchSettingsHits(context.settingsIndex, trimmed)) {
+        grouped.setting.push({
+            domain: 'setting',
+            id: hit.id,
+            title: hit.label,
+            subtitle: hit.description,
+            score: hit.score
+        });
+    }
+    for (const hit of searchPageHits(trimmed)) {
+        grouped.page.push({
+            domain: 'page',
+            id: hit.id,
+            title: hit.label,
+            subtitle: hit.description,
+            score: hit.score
+        });
+    }
+    if (context.pluginsIndex != null) {
+        const catalogById = new Map(context.plugins.map((entry) => [entry.id, entry]));
+        for (const hit of searchPluginHits(context.pluginsIndex, trimmed)) {
+            const entry = catalogById.get(hit.id);
+            const domain = entry != null && catalogEntryIsTheme(entry) ? 'theme' : 'plugin';
+            grouped[domain].push({
+                domain,
+                id: hit.id,
+                title: domain === 'theme' ? formatThemeDisplayName(hit.name) : hit.name,
+                subtitle: hit.summary,
+                score: hit.score,
+                pluginListingSource: 'marketplace'
+            });
+        }
+    }
+    if (context.installedPluginsIndex != null) {
+        const installedById = new Map(context.installedPlugins.map((plugin) => [plugin.id, plugin]));
+        for (const hit of searchInstalledPluginHits(context.installedPluginsIndex, trimmed)) {
+            const plugin = installedById.get(hit.id);
+            const domain = plugin != null && pluginIsTheme(plugin) ? 'theme' : 'plugin';
+            grouped[domain].push({
+                domain,
+                id: hit.id,
+                title: domain === 'theme' ? formatThemeDisplayName(hit.name) : hit.name,
+                subtitle: hit.summary,
+                score: hit.score,
+                pluginListingSource: 'installed'
+            });
+        }
+    }
+    if (context.snippetsIndex != null) {
+        const catalogById = new Map(context.snippets.map((entry) => [entry.id, entry]));
+        for (const hit of searchSnippetHits(context.snippetsIndex, trimmed)) {
+            const entry = catalogById.get(hit.id);
+            grouped.snippet.push({
+                domain: 'snippet',
+                id: hit.id,
+                title: hit.name,
+                subtitle: entry?.summary ?? hit.summary,
+                score: hit.score
+            });
+        }
+    }
+    return mergeSearchHitsRoundRobin(grouped, SEARCH_ANYTHING_MAX_RESULTS);
+}
+//# sourceMappingURL=unified.js.map

package/dist/search/unified.js.map

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

package/dist/shortcuts.d.ts

@@ -0,0 +1,174 @@
+import type { MenuActionId } from './types/app';
+/**
+ * Identifiers for user-configurable keyboard shortcuts.
+ */
+export type ShortcutId = 'new-request' | 'new-collection' | 'sync' | 'save' | 'settings' | 'plugins' | 'themes' | 'snippets' | 'team-hubs' | 'accept-team-hub-invite' | 'sharing-keys' | 'join-shared-collection' | 'import' | 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'select-all' | 'toggle-sidebar' | 'focus-sidebar-search' | 'focus-request-url' | 'focus-first-collection' | 'focus-first-environment' | 'focus-first-request-tab' | 'focus-response-editor' | 'focus-main-nav' | 'next-sidebar-list-item' | 'previous-sidebar-list-item' | 'toggle-variables' | 'toggle-console' | 'toggle-ai-sidebar' | 'toggle-git-sidebar' | 'toggle-request-editor' | 'toggle-response-editor' | 'toggle-collections-section' | 'toggle-environments-section' | 'toggle-run-results-section' | 'send-request' | 'previous-request-tab' | 'next-request-tab' | 'set-method-get' | 'set-method-post' | 'set-method-put' | 'set-method-patch' | 'set-method-delete' | 'set-method-head' | 'set-method-options' | 'toggle-fullscreen' | 'zoom-in' | 'zoom-out' | 'reset-zoom' | 'documentation' | 'report-issue' | 'check-for-updates' | 'about' | 'shortcuts-reference' | 'action-menu' | 'new-collection-git' | 'git-create-branch' | 'git-delete-branch' | 'git-commit' | 'git-merge' | 'git-fetch' | 'git-pull' | 'git-push' | 'git-settings';
+/**
+ * Electron menu role names used by built-in shortcuts.
+ */
+export type ShortcutRole = 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'selectAll' | 'togglefullscreen' | 'zoomIn' | 'zoomOut' | 'resetZoom';
+/**
+ * Definition of a configurable shortcut in the central registry.
+ */
+export interface ShortcutDef {
+    /** Stable shortcut identifier. */
+    id: ShortcutId;
+    /** User-facing label shown in the settings table. */
+    label: string;
+    /** Default Electron accelerator string. */
+    defaultAccelerator: string;
+    /** Whether the shortcut dispatches a custom menu action or uses an Electron role. */
+    kind: 'action' | 'role';
+    /** Custom menu action id when `kind` is `action`. */
+    actionId?: MenuActionId;
+    /** Electron menu role when `kind` is `role`. */
+    role?: ShortcutRole;
+    /**
+     * When true, the main process does not dispatch this shortcut; the renderer
+     * handles it with context-sensitive logic (for example sidebar list navigation).
+     */
+    rendererOnly?: boolean;
+}
+/**
+ * Persisted user overrides keyed by shortcut id.
+ */
+export type ShortcutOverrides = Partial<Record<ShortcutId, string>>;
+/**
+ * Resolved shortcut binding returned to the renderer and used when building menus.
+ */
+export interface ShortcutBinding {
+    /** Stable shortcut identifier. */
+    id: ShortcutId;
+    /** User-facing label. */
+    label: string;
+    /** Effective accelerator after applying overrides. */
+    accelerator: string;
+    /** Default accelerator from the registry. */
+    defaultAccelerator: string;
+}
+/**
+ * Validation result for shortcut override maps.
+ */
+export interface ShortcutValidationResult {
+    /** True when all bindings are valid and non-conflicting. */
+    valid: boolean;
+    /** Per-shortcut error messages keyed by shortcut id. */
+    errors: Partial<Record<ShortcutId, string>>;
+}
+/**
+ * Canonical list of configurable shortcuts in display order.
+ */
+export declare const SHORTCUT_DEFS: ShortcutDef[];
+/**
+ * Returns the shortcut definition for an id, if known.
+ *
+ * @param id - Shortcut identifier.
+ * @returns Matching definition or undefined.
+ */
+export declare function getShortcutDef(id: ShortcutId): ShortcutDef | undefined;
+/**
+ * Normalizes persisted shortcut overrides by dropping unknown ids and invalid values.
+ *
+ * @param raw - Raw value from storage or IPC input.
+ * @returns Sanitized override map.
+ */
+export declare function normalizeShortcutOverrides(raw: unknown): ShortcutOverrides;
+/**
+ * Merges defaults with user overrides into resolved shortcut bindings.
+ *
+ * @param overrides - User overrides keyed by shortcut id.
+ * @returns Resolved bindings in registry order.
+ */
+export declare function resolveShortcuts(overrides: ShortcutOverrides): ShortcutBinding[];
+/**
+ * Builds a lookup map from shortcut id to effective accelerator.
+ *
+ * @param overrides - User overrides keyed by shortcut id.
+ * @returns Map of shortcut id to accelerator string.
+ */
+export declare function resolveAcceleratorMap(overrides: ShortcutOverrides): Map<ShortcutId, string>;
+/**
+ * Converts resolved bindings to a persisted override map (non-default values only).
+ *
+ * @param bindings - Resolved shortcut bindings.
+ * @returns Overrides containing only values that differ from defaults.
+ */
+export declare function bindingsToOverrides(bindings: ShortcutBinding[]): ShortcutOverrides;
+/**
+ * Validates shortcut overrides for shape, modifier requirements, and conflicts.
+ *
+ * @param overrides - User overrides keyed by shortcut id.
+ * @returns Validation result with per-shortcut error messages.
+ */
+export declare function validateShortcutOverrides(overrides: ShortcutOverrides): ShortcutValidationResult;
+/**
+ * Formats an Electron accelerator for display in the settings table.
+ *
+ * @param accelerator - Electron accelerator string.
+ * @returns Human-readable accelerator such as `ctrl+s`.
+ */
+export declare function formatAcceleratorDisplay(accelerator: string): string;
+/**
+ * Formats an Electron accelerator for display beside application menu items.
+ *
+ * Maps `CmdOrCtrl` to `Cmd` on macOS and `Ctrl` on Windows and Linux so custom
+ * in-app menus show the same labels users expect from native OS menus.
+ *
+ * @param accelerator - Electron accelerator string.
+ * @param platform - Node.js platform from `process.platform`.
+ * @returns Human-readable accelerator such as `Ctrl+Shift+N` or `Cmd+,`.
+ */
+export declare function formatMenuAcceleratorDisplay(accelerator: string, platform: NodeJS.Platform): string;
+/**
+ * Modifier and key state from an Electron `before-input-event` or DOM keyboard event.
+ */
+export interface KeyChord {
+    /** Normalized key value (for example `F5`, `f`, `,`). */
+    key: string;
+    /**
+     * Physical key code from Electron or DOM (for example `KeyO`, `Digit1`).
+     * Used when Alt or layout changes make `key` an unmapped character.
+     */
+    code?: string;
+    /** Whether the control key is pressed. */
+    control: boolean;
+    /** Whether the meta (command) key is pressed. */
+    meta: boolean;
+    /** Whether the alt key is pressed. */
+    alt: boolean;
+    /** Whether the shift key is pressed. */
+    shift: boolean;
+}
+/**
+ * US keyboard shifted digit-row symbols mapped to their base digit tokens.
+ *
+ * Shift+1 reports as `!` in DOM and Electron key events, but accelerators store
+ * the unshifted digit when Shift is a modifier (e.g. `Alt+Shift+1`).
+ */
+export declare const SHIFTED_SYMBOL_TO_DIGIT: Record<string, string>;
+/**
+ * Builds an Electron accelerator string from a key chord.
+ *
+ * @param chord - Modifier and key state from a keyboard event.
+ * @returns Electron accelerator string, or null when the chord should be ignored.
+ */
+export declare function acceleratorFromChord(chord: KeyChord): string | null;
+/**
+ * Canonicalizes an Electron accelerator for chord comparison.
+ *
+ * Modifiers collapse to sorted `alt`, `mod`, and `shift` tokens so stored
+ * accelerators match chords regardless of Cmd vs Ctrl spelling.
+ *
+ * @param accelerator - Electron accelerator string.
+ * @returns Canonical compare string such as `mod+shift+comma`.
+ */
+export declare function normalizeAcceleratorForCompare(accelerator: string): string;
+/**
+ * Returns true when a keyboard chord matches a configured accelerator.
+ *
+ * @param accelerator - Electron accelerator string from shortcut settings.
+ * @param chord - Modifier and key state from a keyboard event.
+ * @returns Whether the chord triggers the accelerator.
+ */
+export declare function acceleratorMatchesChord(accelerator: string, chord: KeyChord): boolean;
+//# sourceMappingURL=shortcuts.d.ts.map

package/dist/shortcuts.d.ts.map

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