@corti/dictation-web 0.6.0 → 0.6.1-rc.1

package/dist/utils/devices.d.ts

@@ -1,19 +1,23 @@
 /**
- * Requests access to the microphone.
+ * Primes the document with an active microphone stream.
  *
- * This function checks if the microphone permission is in "prompt" state, then requests
- * access and stops any active tracks immediately.
+ * Opens (and immediately stops) a media stream so the document holds an
+ * active mic permission for this session. In Firefox this is what makes
+ * real deviceIds and labels appear in subsequent enumerateDevices() calls.
+ * Throws early if the user has already denied permission.
  *
- * @returns A promise that resolves when the permission request is complete.
+ * @returns A promise that resolves once the stream has been opened and stopped.
  * @throws Error if microphone access is denied or unavailable.
  */
-export declare function requestMicAccess(): Promise<void>;
+export declare function primeMicStream(): Promise<void>;
 /**
  * Retrieves available audio input devices.
  *
- * This function uses the mediaDevices API to enumerate devices and filters out those
- * which are audio inputs. In some browsers, you may need to request user media before
- * device labels are populated.
+ * Enumerates devices first; if the result looks like Firefox's pre-permission
+ * placeholder (an entry with empty deviceId/label even though the Permissions
+ * API reports access), primes the document with getUserMedia and re-enumerates.
+ * Browsers that already return populated entries (Chrome, Safari) skip the
+ * priming call entirely.
  *
  * @returns A promise that resolves with an object containing:
  *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.

package/dist/utils/devices.js

@@ -1,39 +1,36 @@
 /**
- * Requests access to the microphone.
+ * Primes the document with an active microphone stream.
  *
- * This function checks if the microphone permission is in "prompt" state, then requests
- * access and stops any active tracks immediately.
+ * Opens (and immediately stops) a media stream so the document holds an
+ * active mic permission for this session. In Firefox this is what makes
+ * real deviceIds and labels appear in subsequent enumerateDevices() calls.
+ * Throws early if the user has already denied permission.
  *
- * @returns A promise that resolves when the permission request is complete.
+ * @returns A promise that resolves once the stream has been opened and stopped.
  * @throws Error if microphone access is denied or unavailable.
  */
-export async function requestMicAccess() {
-    if (!navigator.permissions) {
-        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-        stream.getTracks().forEach((track) => {
-            track.stop();
+export async function primeMicStream() {
+    if (navigator.permissions) {
+        const permissionStatus = await navigator.permissions.query({
+            name: "microphone",
         });
-        return;
+        if (permissionStatus.state === "denied") {
+            throw new Error("Microphone permission is denied");
+        }
     }
-    const permissionStatus = await navigator.permissions.query({
-        name: "microphone",
+    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+    stream.getTracks().forEach((track) => {
+        track.stop();
     });
-    if (permissionStatus.state === "denied") {
-        throw new Error("Microphone permission is denied");
-    }
-    if (permissionStatus.state === "prompt") {
-        const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
-        stream.getTracks().forEach((track) => {
-            track.stop();
-        });
-    }
 }
 /**
  * Retrieves available audio input devices.
  *
- * This function uses the mediaDevices API to enumerate devices and filters out those
- * which are audio inputs. In some browsers, you may need to request user media before
- * device labels are populated.
+ * Enumerates devices first; if the result looks like Firefox's pre-permission
+ * placeholder (an entry with empty deviceId/label even though the Permissions
+ * API reports access), primes the document with getUserMedia and re-enumerates.
+ * Browsers that already return populated entries (Chrome, Safari) skip the
+ * priming call entirely.
  *
  * @returns A promise that resolves with an object containing:
  *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.
@@ -44,10 +41,24 @@ export async function getAudioDevices() {
     if (!navigator.mediaDevices?.enumerateDevices) {
         throw new Error("MediaDevices API is not available");
     }
-    await requestMicAccess();
+    let audioDevices = await listAudioInputs();
+    if (needsMicPriming(audioDevices)) {
+        await primeMicStream();
+        audioDevices = await listAudioInputs();
+    }
+    return {
+        defaultDevice: audioDevices[0],
+        devices: audioDevices,
+    };
+}
+async function listAudioInputs() {
     const devices = await navigator.mediaDevices.enumerateDevices();
-    const audioDevices = devices.filter((device) => device.kind === "audioinput");
-    const defaultDevice = audioDevices.length > 0 ? audioDevices[0] : undefined;
-    return { defaultDevice, devices: audioDevices };
+    return devices.filter((device) => device.kind === "audioinput");
+}
+function needsMicPriming(audioInputs) {
+    if (audioInputs.length === 0) {
+        return false; // no mic hardware — don't trigger a permission prompt
+    }
+    return audioInputs.some((d) => d.deviceId === "" || d.label === "");
 }
 //# sourceMappingURL=devices.js.map

package/dist/utils/devices.js.map

@@ -1 +1 @@
-{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/utils/devices.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1E,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;QACzD,IAAI,EAAE,YAA8B;KACrC,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1E,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IAInC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,gBAAgB,EAAE,CAAC;IAEzB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAClD,CAAC","sourcesContent":["/**\n * Requests access to the microphone.\n *\n * This function checks if the microphone permission is in \"prompt\" state, then requests\n * access and stops any active tracks immediately.\n *\n * @returns A promise that resolves when the permission request is complete.\n * @throws Error if microphone access is denied or unavailable.\n */\nexport async function requestMicAccess(): Promise<void> {\n  if (!navigator.permissions) {\n    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n\n    stream.getTracks().forEach((track) => {\n      track.stop();\n    });\n\n    return;\n  }\n\n  const permissionStatus = await navigator.permissions.query({\n    name: \"microphone\" as PermissionName,\n  });\n\n  if (permissionStatus.state === \"denied\") {\n    throw new Error(\"Microphone permission is denied\");\n  }\n\n  if (permissionStatus.state === \"prompt\") {\n    const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n\n    stream.getTracks().forEach((track) => {\n      track.stop();\n    });\n  }\n}\n\n/**\n * Retrieves available audio input devices.\n *\n * This function uses the mediaDevices API to enumerate devices and filters out those\n * which are audio inputs. In some browsers, you may need to request user media before\n * device labels are populated.\n *\n * @returns A promise that resolves with an object containing:\n *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.\n *  - `defaultDevice`: the first audio input device, if available.\n * @throws Error if mediaDevices API is unavailable or device enumeration fails.\n */\nexport async function getAudioDevices(): Promise<{\n  devices: MediaDeviceInfo[];\n  defaultDevice?: MediaDeviceInfo;\n}> {\n  if (!navigator.mediaDevices?.enumerateDevices) {\n    throw new Error(\"MediaDevices API is not available\");\n  }\n\n  await requestMicAccess();\n\n  const devices = await navigator.mediaDevices.enumerateDevices();\n  const audioDevices = devices.filter((device) => device.kind === \"audioinput\");\n  const defaultDevice = audioDevices.length > 0 ? audioDevices[0] : undefined;\n\n  return { defaultDevice, devices: audioDevices };\n}\n"]}
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../src/utils/devices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;YACzD,IAAI,EAAE,YAA8B;SACrC,CAAC,CAAC;QAEH,IAAI,gBAAgB,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1E,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,KAAK,CAAC,IAAI,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IAInC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,YAAY,GAAG,MAAM,eAAe,EAAE,CAAC;IAE3C,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,MAAM,cAAc,EAAE,CAAC;QACvB,YAAY,GAAG,MAAM,eAAe,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACL,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9B,OAAO,EAAE,YAAY;KACtB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,WAA8B;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,CAAC,sDAAsD;IACtE,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC","sourcesContent":["/**\n * Primes the document with an active microphone stream.\n *\n * Opens (and immediately stops) a media stream so the document holds an\n * active mic permission for this session. In Firefox this is what makes\n * real deviceIds and labels appear in subsequent enumerateDevices() calls.\n * Throws early if the user has already denied permission.\n *\n * @returns A promise that resolves once the stream has been opened and stopped.\n * @throws Error if microphone access is denied or unavailable.\n */\nexport async function primeMicStream(): Promise<void> {\n  if (navigator.permissions) {\n    const permissionStatus = await navigator.permissions.query({\n      name: \"microphone\" as PermissionName,\n    });\n\n    if (permissionStatus.state === \"denied\") {\n      throw new Error(\"Microphone permission is denied\");\n    }\n  }\n\n  const stream = await navigator.mediaDevices.getUserMedia({ audio: true });\n\n  stream.getTracks().forEach((track) => {\n    track.stop();\n  });\n}\n\n/**\n * Retrieves available audio input devices.\n *\n * Enumerates devices first; if the result looks like Firefox's pre-permission\n * placeholder (an entry with empty deviceId/label even though the Permissions\n * API reports access), primes the document with getUserMedia and re-enumerates.\n * Browsers that already return populated entries (Chrome, Safari) skip the\n * priming call entirely.\n *\n * @returns A promise that resolves with an object containing:\n *  - `devices`: an array of MediaDeviceInfo objects for audio inputs.\n *  - `defaultDevice`: the first audio input device, if available.\n * @throws Error if mediaDevices API is unavailable or device enumeration fails.\n */\nexport async function getAudioDevices(): Promise<{\n  devices: MediaDeviceInfo[];\n  defaultDevice?: MediaDeviceInfo;\n}> {\n  if (!navigator.mediaDevices?.enumerateDevices) {\n    throw new Error(\"MediaDevices API is not available\");\n  }\n\n  let audioDevices = await listAudioInputs();\n\n  if (needsMicPriming(audioDevices)) {\n    await primeMicStream();\n    audioDevices = await listAudioInputs();\n  }\n\n  return {\n    defaultDevice: audioDevices[0],\n    devices: audioDevices,\n  };\n}\n\nasync function listAudioInputs(): Promise<MediaDeviceInfo[]> {\n  const devices = await navigator.mediaDevices.enumerateDevices();\n  return devices.filter((device) => device.kind === \"audioinput\");\n}\n\nfunction needsMicPriming(audioInputs: MediaDeviceInfo[]): boolean {\n  if (audioInputs.length === 0) {\n    return false; // no mic hardware — don't trigger a permission prompt\n  }\n  return audioInputs.some((d) => d.deviceId === \"\" || d.label === \"\");\n}\n"]}

package/dist/utils/keybinding.d.ts

@@ -5,8 +5,9 @@
  * @returns Normalized keybinding string or null if empty
  *
  * @example
- * normalizeKeybinding("k") // "k"
+ * normalizeKeybinding("k") // "K"
  * normalizeKeybinding("meta") // "Cmd" on Mac
+ * normalizeKeybinding(" ") // "Space"
  * normalizeKeybinding(" space ") // "Space"
  */
 export declare function normalizeKeybinding(keybinding: string | null | undefined): string | null;

package/dist/utils/keybinding.js

@@ -27,7 +27,7 @@ function capitalize(str) {
  * Normalizes a key string to the keybinding format.
  * Handles platform-specific mappings and capitalization.
  *
- * @param key - Key string to normalize (will be trimmed and lowercased)
+ * @param key - Key string to normalize (will be trimmed and uppercased)
  * @returns Formatted key string for keybinding
  *
  * @example
@@ -35,7 +35,8 @@ function capitalize(str) {
  * normalizeKeyForKeybinding("META") // "Cmd" on Mac, "Meta" elsewhere
  * normalizeKeyForKeybinding(" alt ") // "Opt" on Mac, "Alt" elsewhere
  * normalizeKeyForKeybinding("shift") // "Shift"
- * normalizeKeyForKeybinding("k") // "k"
+ * normalizeKeyForKeybinding("k") // "K"
+ * normalizeKeyForKeybinding(" ") // "Space"
  */
 function normalizeKeyForKeybinding(key) {
     if (key === " ") {
@@ -54,6 +55,11 @@ function normalizeKeyForKeybinding(key) {
     if (normalized === "space") {
         return "Space";
     }
+    // TODO: Uncomment this for v1 to avoid breaking changes now
+    // Capitalize single letters (a-z) for consistent display
+    // if (/^[a-z]$/.test(normalized)) {
+    //   return normalized.toUpperCase();
+    // }
     return normalized.length > 1 ? capitalize(normalized) : normalized;
 }
 /**
@@ -63,19 +69,19 @@ function normalizeKeyForKeybinding(key) {
  * @returns Normalized keybinding string or null if empty
  *
  * @example
- * normalizeKeybinding("k") // "k"
+ * normalizeKeybinding("k") // "K"
  * normalizeKeybinding("meta") // "Cmd" on Mac
+ * normalizeKeybinding(" ") // "Space"
  * normalizeKeybinding(" space ") // "Space"
  */
 export function normalizeKeybinding(keybinding) {
     if (!keybinding) {
         return null;
     }
-    const trimmed = keybinding.trim();
-    if (trimmed === "") {
+    if (keybinding !== " " && keybinding.trim() === "") {
         return null;
     }
-    return normalizeKeyForKeybinding(trimmed);
+    return normalizeKeyForKeybinding(keybinding);
 }
 /**
  * Checks if a pressed key matches the keybinding.

package/dist/utils/keybinding.js.map

@@ -1 +1 @@
-{"version":3,"file":"keybinding.js","sourceRoot":"","sources":["../../src/utils/keybinding.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Checks if the current platform is macOS.\n * Uses userAgent string for reliable cross-browser detection.\n *\n * @returns true if running on macOS\n */\nfunction isMac(): boolean {\n  if (typeof navigator === \"undefined\") {\n    return false;\n  }\n\n  // Check user agent for Mac patterns (most reliable method)\n  return /Mac|iPhone|iPad|iPod/.test(navigator.userAgent);\n}\n\n/**\n * Capitalizes the first letter of a string.\n *\n * @param str - String to capitalize\n * @returns String with first letter capitalized\n */\nfunction capitalize(str: string): string {\n  if (str.length === 0) {\n    return str;\n  }\n\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Normalizes a key string to the keybinding format.\n * Handles platform-specific mappings and capitalization.\n *\n * @param key - Key string to normalize (will be trimmed and lowercased)\n * @returns Formatted key string for keybinding\n *\n * @example\n * normalizeKeyForKeybinding(\"Control\") // \"Ctrl\"\n * normalizeKeyForKeybinding(\"META\") // \"Cmd\" on Mac, \"Meta\" elsewhere\n * normalizeKeyForKeybinding(\" alt \") // \"Opt\" on Mac, \"Alt\" elsewhere\n * normalizeKeyForKeybinding(\"shift\") // \"Shift\"\n * normalizeKeyForKeybinding(\"k\") // \"k\"\n */\nfunction normalizeKeyForKeybinding(key: string): string {\n  if (key === \" \") {\n    return \"Space\";\n  }\n\n  const normalized = key.trim().toLowerCase();\n\n  if (normalized === \"control\") {\n    return \"Ctrl\";\n  }\n  if (normalized === \"meta\" || normalized === \"cmd\") {\n    return isMac() ? \"Cmd\" : \"Meta\";\n  }\n  if (normalized === \"alt\" || normalized === \"opt\") {\n    return isMac() ? \"Opt\" : \"Alt\";\n  }\n  if (normalized === \"space\") {\n    return \"Space\";\n  }\n\n  return normalized.length > 1 ? capitalize(normalized) : normalized;\n}\n\n/**\n * Normalizes a keybinding string.\n *\n * @param keybinding - Keybinding string to normalize\n * @returns Normalized keybinding string or null if empty\n *\n * @example\n * normalizeKeybinding(\"k\") // \"k\"\n * normalizeKeybinding(\"meta\") // \"Cmd\" on Mac\n * normalizeKeybinding(\" space \") // \"Space\"\n */\nexport function normalizeKeybinding(\n  keybinding: string | null | undefined,\n): string | null {\n  if (!keybinding) {\n    return null;\n  }\n\n  const trimmed = keybinding.trim();\n\n  if (trimmed === \"\") {\n    return null;\n  }\n\n  return normalizeKeyForKeybinding(trimmed);\n}\n\n/**\n * Checks if a pressed key matches the keybinding.\n * Checks both event.key and event.code for better reliability.\n *\n * @param event - KeyboardEvent to check\n * @param keybinding - Keybinding string to match against\n * @returns true if either the key or code matches the keybinding\n *\n * @example\n * matchesKeybinding(event, \"k\") // true if event.key is \"k\" or event.code is \"KeyK\"\n * matchesKeybinding(event, \"`\") // true if event.key is \"`\" or event.code is \"Backquote\"\n */\nexport function matchesKeybinding(\n  event: KeyboardEvent,\n  keybinding: string | null | undefined,\n): boolean {\n  const normalizedKeybinding = normalizeKeybinding(keybinding);\n\n  if (!normalizedKeybinding) {\n    return false;\n  }\n\n  const normalizedKey = normalizeKeyForKeybinding(event.key);\n  const normalizedCode = normalizeKeyForKeybinding(event.code);\n\n  return (\n    normalizedKey === normalizedKeybinding ||\n    normalizedCode === normalizedKeybinding\n  );\n}\n\n/**\n * Checks if keybindings should be ignored for the current active element.\n * Returns true if the user is typing in an input field.\n *\n * @param element - Element to check\n * @returns true if keybindings should be ignored for this element\n *\n * @example\n * shouldIgnoreKeybinding(document.activeElement) // true if input/textarea/contenteditable\n */\nexport function shouldIgnoreKeybinding(element: Element | null): boolean {\n  if (!element) {\n    return false;\n  }\n\n  const tagName = element.tagName.toLowerCase();\n\n  if (tagName === \"input\" || tagName === \"textarea\") {\n    return true;\n  }\n\n  if (element instanceof HTMLElement && element.contentEditable === \"true\") {\n    return true;\n  }\n\n  return false;\n}\n"]}
+{"version":3,"file":"keybinding.js","sourceRoot":"","sources":["../../src/utils/keybinding.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Checks if the current platform is macOS.\n * Uses userAgent string for reliable cross-browser detection.\n *\n * @returns true if running on macOS\n */\nfunction isMac(): boolean {\n  if (typeof navigator === \"undefined\") {\n    return false;\n  }\n\n  // Check user agent for Mac patterns (most reliable method)\n  return /Mac|iPhone|iPad|iPod/.test(navigator.userAgent);\n}\n\n/**\n * Capitalizes the first letter of a string.\n *\n * @param str - String to capitalize\n * @returns String with first letter capitalized\n */\nfunction capitalize(str: string): string {\n  if (str.length === 0) {\n    return str;\n  }\n\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Normalizes a key string to the keybinding format.\n * Handles platform-specific mappings and capitalization.\n *\n * @param key - Key string to normalize (will be trimmed and uppercased)\n * @returns Formatted key string for keybinding\n *\n * @example\n * normalizeKeyForKeybinding(\"Control\") // \"Ctrl\"\n * normalizeKeyForKeybinding(\"META\") // \"Cmd\" on Mac, \"Meta\" elsewhere\n * normalizeKeyForKeybinding(\" alt \") // \"Opt\" on Mac, \"Alt\" elsewhere\n * normalizeKeyForKeybinding(\"shift\") // \"Shift\"\n * normalizeKeyForKeybinding(\"k\") // \"K\"\n * normalizeKeyForKeybinding(\" \") // \"Space\"\n */\nfunction normalizeKeyForKeybinding(key: string): string {\n  if (key === \" \") {\n    return \"Space\";\n  }\n\n  const normalized = key.trim().toLowerCase();\n\n  if (normalized === \"control\") {\n    return \"Ctrl\";\n  }\n  if (normalized === \"meta\" || normalized === \"cmd\") {\n    return isMac() ? \"Cmd\" : \"Meta\";\n  }\n  if (normalized === \"alt\" || normalized === \"opt\") {\n    return isMac() ? \"Opt\" : \"Alt\";\n  }\n  if (normalized === \"space\") {\n    return \"Space\";\n  }\n\n  // TODO: Uncomment this for v1 to avoid breaking changes now\n  // Capitalize single letters (a-z) for consistent display\n  // if (/^[a-z]$/.test(normalized)) {\n  //   return normalized.toUpperCase();\n  // }\n\n  return normalized.length > 1 ? capitalize(normalized) : normalized;\n}\n\n/**\n * Normalizes a keybinding string.\n *\n * @param keybinding - Keybinding string to normalize\n * @returns Normalized keybinding string or null if empty\n *\n * @example\n * normalizeKeybinding(\"k\") // \"K\"\n * normalizeKeybinding(\"meta\") // \"Cmd\" on Mac\n * normalizeKeybinding(\" \") // \"Space\"\n * normalizeKeybinding(\" space \") // \"Space\"\n */\nexport function normalizeKeybinding(\n  keybinding: string | null | undefined,\n): string | null {\n  if (!keybinding) {\n    return null;\n  }\n  if (keybinding !== \" \" && keybinding.trim() === \"\") {\n    return null;\n  }\n\n  return normalizeKeyForKeybinding(keybinding);\n}\n\n/**\n * Checks if a pressed key matches the keybinding.\n * Checks both event.key and event.code for better reliability.\n *\n * @param event - KeyboardEvent to check\n * @param keybinding - Keybinding string to match against\n * @returns true if either the key or code matches the keybinding\n *\n * @example\n * matchesKeybinding(event, \"k\") // true if event.key is \"k\" or event.code is \"KeyK\"\n * matchesKeybinding(event, \"`\") // true if event.key is \"`\" or event.code is \"Backquote\"\n */\nexport function matchesKeybinding(\n  event: KeyboardEvent,\n  keybinding: string | null | undefined,\n): boolean {\n  const normalizedKeybinding = normalizeKeybinding(keybinding);\n\n  if (!normalizedKeybinding) {\n    return false;\n  }\n\n  const normalizedKey = normalizeKeyForKeybinding(event.key);\n  const normalizedCode = normalizeKeyForKeybinding(event.code);\n\n  return (\n    normalizedKey === normalizedKeybinding ||\n    normalizedCode === normalizedKeybinding\n  );\n}\n\n/**\n * Checks if keybindings should be ignored for the current active element.\n * Returns true if the user is typing in an input field.\n *\n * @param element - Element to check\n * @returns true if keybindings should be ignored for this element\n *\n * @example\n * shouldIgnoreKeybinding(document.activeElement) // true if input/textarea/contenteditable\n */\nexport function shouldIgnoreKeybinding(element: Element | null): boolean {\n  if (!element) {\n    return false;\n  }\n\n  const tagName = element.tagName.toLowerCase();\n\n  if (tagName === \"input\" || tagName === \"textarea\") {\n    return true;\n  }\n\n  if (element instanceof HTMLElement && element.contentEditable === \"true\") {\n    return true;\n  }\n\n  return false;\n}\n"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@corti/dictation-web",
   "description": "Web component for Corti Dictation",
   "author": "Corti ApS",
-  "version": "0.6.0",
+  "version": "0.6.1-rc.1",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",