@designcrowd/fe-shared-lib 1.8.4-edge-fallback-1 → 1.8.4-edge-fallback-3

package/.playwright-cli/page-2026-05-06T01-55-45-770Z.yml

@@ -0,0 +1,22 @@
+- generic [active] [ref=e3]:
+  - generic [ref=e5]:
+    - heading "Control vs Unsupported (side-by-side)" [level=3] [ref=e6]
+    - paragraph [ref=e7]: Both buttons share variant + size. The right one is rendered with the session-disabled latch flipped on, so it shows the new disabled state with the explanatory tooltip. Use this to compare visual treatments for design review.
+    - generic [ref=e8]:
+      - button "Force unsupported" [ref=e9] [cursor=pointer]
+      - button "Reset" [ref=e10] [cursor=pointer]
+    - generic [ref=e11]:
+      - generic [ref=e12]:
+        - button "Start voice input" [ref=e14] [cursor=pointer]:
+          - img [ref=e16]
+        - paragraph [ref=e18]: Control (default state)
+      - generic [ref=e19]:
+        - button "Start voice input" [ref=e21] [cursor=pointer]:
+          - img [ref=e23]
+        - paragraph [ref=e25]: Unsupported (after latch)
+    - paragraph [ref=e26]: "Note: the composable is a singleton, so flipping the latch affects every mounted instance — which is exactly what the production Edge case does. Both buttons will switch together."
+  - generic [ref=e27]:
+    - generic "Toggle devtools panel" [ref=e28] [cursor=pointer]:
+      - img [ref=e29]
+    - generic "Toggle Component Inspector" [ref=e34] [cursor=pointer]:
+      - img [ref=e35]

package/.playwright-cli/page-2026-05-06T01-55-51-522Z.yml

@@ -0,0 +1,22 @@
+- generic [ref=e3]:
+  - generic [ref=e5]:
+    - heading "Control vs Unsupported (side-by-side)" [level=3] [ref=e6]
+    - paragraph [ref=e7]: Both buttons share variant + size. The right one is rendered with the session-disabled latch flipped on, so it shows the new disabled state with the explanatory tooltip. Use this to compare visual treatments for design review.
+    - generic [ref=e8]:
+      - button "Force unsupported" [active] [ref=e9] [cursor=pointer]
+      - button "Reset" [ref=e10] [cursor=pointer]
+    - generic [ref=e11]:
+      - generic [ref=e12]:
+        - button "Voice input not available in this browser" [disabled] [ref=e39] [cursor=pointer]:
+          - img [ref=e16]
+        - paragraph [ref=e18]: Control (default state)
+      - generic [ref=e19]:
+        - button "Voice input not available in this browser" [disabled] [ref=e40] [cursor=pointer]:
+          - img [ref=e23]
+        - paragraph [ref=e25]: Unsupported (after latch)
+    - paragraph [ref=e26]: "Note: the composable is a singleton, so flipping the latch affects every mounted instance — which is exactly what the production Edge case does. Both buttons will switch together."
+  - generic [ref=e27]:
+    - generic "Toggle devtools panel" [ref=e28] [cursor=pointer]:
+      - img [ref=e29]
+    - generic "Toggle Component Inspector" [ref=e34] [cursor=pointer]:
+      - img [ref=e35]

package/.playwright-cli/page-2026-05-06T01-55-57-985Z.yml

@@ -0,0 +1,22 @@
+- generic [ref=e3]:
+  - generic [ref=e5]:
+    - heading "Control vs Unsupported (side-by-side)" [level=3] [ref=e6]
+    - paragraph [ref=e7]: Both buttons share variant + size. The right one is rendered with the session-disabled latch flipped on, so it shows the new disabled state with the explanatory tooltip. Use this to compare visual treatments for design review.
+    - generic [ref=e8]:
+      - button "Force unsupported" [ref=e9] [cursor=pointer]
+      - button "Reset" [active] [ref=e10] [cursor=pointer]
+    - generic [ref=e11]:
+      - generic [ref=e12]:
+        - button "Start voice input" [ref=e41] [cursor=pointer]:
+          - img [ref=e16]
+        - paragraph [ref=e18]: Control (default state)
+      - generic [ref=e19]:
+        - button "Start voice input" [ref=e42] [cursor=pointer]:
+          - img [ref=e23]
+        - paragraph [ref=e25]: Unsupported (after latch)
+    - paragraph [ref=e26]: "Note: the composable is a singleton, so flipping the latch affects every mounted instance — which is exactly what the production Edge case does. Both buttons will switch together."
+  - generic [ref=e27]:
+    - generic "Toggle devtools panel" [ref=e28] [cursor=pointer]:
+      - img [ref=e29]
+    - generic "Toggle Component Inspector" [ref=e34] [cursor=pointer]:
+      - img [ref=e35]

package/index.js

@@ -23,6 +23,7 @@ export { WEBSITE_UPGRADE_CONTEXT_TYPES } from './src/experiences/models/websiteC
 
 export { setSharedLibLocaleAsync, tr } from './src/useSharedLibTranslate';
 export { useVoiceToText } from './src/useVoiceToText';
+export { setVoiceToTextSessionDisabledForTesting, VOICE_UNAVAILABLE_MESSAGE } from './src/useVoiceToText';
 
 export { default as Button } from './src/atoms/components/Button/Button.vue';
 export { default as ButtonGroup } from './src/atoms/components/ButtonGroup/ButtonGroup.vue';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@designcrowd/fe-shared-lib",
-  "version": "1.8.4-edge-fallback-1",
+  "version": "1.8.4-edge-fallback-3",
   "scripts": {
     "start": "run-p storybook watch:translation",
     "build": "npm run build:css --production",

package/src/atoms/components/VoiceToTextButton/VoiceToTextButton.stories.ts

@@ -1,5 +1,5 @@
 import VoiceToTextButton from './VoiceToTextButton.vue';
-import { __setVoiceToTextSessionDisabled } from '../../../useVoiceToText';
+import { setVoiceToTextSessionDisabledForTesting } from '../../../useVoiceToText';
 
 export default {
   title: 'Components/VoiceToTextButton',
@@ -244,22 +244,12 @@ SideBySide.story = {
 
 export const ForceUnsupported = () => ({
   components: { VoiceToTextButton },
-  data() {
-    return {
-      // Reactive ping so the button re-renders when we flip the session flag.
-      // The composable's isSupported is reactive on its own, but the parent
-      // template uses :key to make the toggle obvious in Storybook.
-      tick: 0,
-    };
-  },
   methods: {
     forceUnsupported() {
-      __setVoiceToTextSessionDisabled(true);
-      this.tick += 1;
+      setVoiceToTextSessionDisabledForTesting(true);
     },
     reset() {
-      __setVoiceToTextSessionDisabled(false);
-      this.tick += 1;
+      setVoiceToTextSessionDisabledForTesting(false);
     },
   },
   template: `
@@ -267,8 +257,8 @@ export const ForceUnsupported = () => ({
       <h3 class="tw-text-grayscale-800 tw-text-lg tw-font-semibold tw-mb-2">Force unsupported preview</h3>
       <p class="tw-text-grayscale-600 tw-text-sm tw-mb-6 tw-text-center tw-max-w-md">
         Simulates the Edge fallback: after a 'network' SpeechRecognitionError, the composable latches
-        <code class="tw-bg-grayscale-100 tw-px-1 tw-rounded">isSupported</code> to false for the rest of the session
-        and the button hides itself. Reset clears the session flag.
+        <code class="tw-bg-grayscale-100 tw-px-1 tw-rounded">isSupported</code> to false for the rest of the session.
+        The button now stays visible but disabled, with a tooltip explaining the situation. Reset clears the session flag.
       </p>
 
       <div class="tw-flex tw-gap-3 tw-mb-6">
@@ -294,7 +284,7 @@ export const ForceUnsupported = () => ({
           placeholder="Voice input would appear on the right..."
           class="tw-flex-1 tw-bg-transparent tw-border-none tw-text-grayscale-800 tw-placeholder-grayscale-500 focus:tw-outline-none tw-text-base"
         />
-        <VoiceToTextButton :key="tick" variant="light" size="md" />
+        <VoiceToTextButton variant="light" size="md" />
       </div>
 
       <p class="tw-text-grayscale-500 tw-text-xs tw-mt-4">
@@ -308,3 +298,67 @@ export const ForceUnsupported = () => ({
 ForceUnsupported.story = {
   name: 'Force Unsupported (Edge Fallback)',
 };
+
+export const ControlVsUnsupported = () => ({
+  components: { VoiceToTextButton },
+  methods: {
+    forceUnsupported() {
+      setVoiceToTextSessionDisabledForTesting(true);
+    },
+    reset() {
+      setVoiceToTextSessionDisabledForTesting(false);
+    },
+  },
+  template: `
+    <div class="tw-min-h-[400px] tw-p-8" style="background: #1a1a2e;">
+      <h3 class="tw-text-white tw-text-lg tw-font-semibold tw-mb-2">Control vs Unsupported (side-by-side)</h3>
+      <p class="tw-text-grayscale-400 tw-text-sm tw-mb-6 tw-max-w-2xl">
+        Both buttons share variant + size. The right one is rendered with the session-disabled latch
+        flipped on, so it shows the new disabled state with the explanatory tooltip. Use this to compare
+        visual treatments for design review.
+      </p>
+
+      <div class="tw-flex tw-gap-3 tw-mb-6">
+        <button
+          type="button"
+          @click="forceUnsupported"
+          class="tw-px-4 tw-py-2 tw-rounded tw-bg-error-500 tw-text-white tw-text-sm hover:tw-bg-error-600"
+        >
+          Force unsupported
+        </button>
+        <button
+          type="button"
+          @click="reset"
+          class="tw-px-4 tw-py-2 tw-rounded tw-bg-grayscale-200 tw-text-grayscale-800 tw-text-sm hover:tw-bg-grayscale-300"
+        >
+          Reset
+        </button>
+      </div>
+
+      <div class="tw-flex tw-gap-12 tw-items-start">
+        <div class="tw-text-center">
+          <div class="tw-mb-2 tw-p-4 tw-bg-grayscale-800 tw-rounded-lg tw-inline-block">
+            <VoiceToTextButton variant="dark" size="md" />
+          </div>
+          <p class="tw-text-grayscale-400 tw-text-xs">Control (default state)</p>
+        </div>
+
+        <div class="tw-text-center">
+          <div class="tw-mb-2 tw-p-4 tw-bg-grayscale-800 tw-rounded-lg tw-inline-block">
+            <VoiceToTextButton variant="dark" size="md" />
+          </div>
+          <p class="tw-text-grayscale-400 tw-text-xs">Unsupported (after latch)</p>
+        </div>
+      </div>
+
+      <p class="tw-text-grayscale-500 tw-text-xs tw-mt-6">
+        Note: the composable is a singleton, so flipping the latch affects every mounted instance —
+        which is exactly what the production Edge case does. Both buttons will switch together.
+      </p>
+    </div>
+  `,
+});
+
+ControlVsUnsupported.story = {
+  name: 'Control vs Unsupported',
+};

package/src/atoms/components/VoiceToTextButton/VoiceToTextButton.vue

@@ -1,16 +1,23 @@
 <template>
   <button
-    v-if="isSupported"
     type="button"
-    :disabled="disabled"
-    :aria-label="isListening ? 'Stop voice input' : 'Start voice input'"
+    :disabled="disabled || unavailableForSession"
+    :aria-label="
+      unavailableForSession
+        ? 'Voice input not available in this browser'
+        : isListening
+          ? 'Stop voice input'
+          : 'Start voice input'
+    "
+    :title="effectiveTitle"
     data-test="voice-to-text-button"
     class="voice-prompt-button tw-rounded-full tw-border-0 tw-flex tw-items-center tw-justify-center tw-transition-all tw-duration-200 tw-cursor-pointer focus:tw-outline-none focus-visible:tw-ring-2 focus-visible:tw-ring-offset-2 focus-visible:tw-ring-primary-500"
     :class="[
       sizeClasses,
       variantClasses.button,
       isListening ? 'voice-prompt-listening' : '',
-      disabled ? 'tw-opacity-50 tw-cursor-not-allowed' : '',
+      (disabled || unavailableForSession) ? 'tw-opacity-50 tw-cursor-not-allowed' : '',
+      unavailableForSession ? 'voice-prompt-unavailable' : '',
     ]"
     :style="isListening ? { '--voice-bg': variantClasses.recordingBg } : {}"
     @click="toggle"
@@ -27,7 +34,7 @@
 <script setup lang="ts">
 import { watch, toRef, computed } from 'vue';
 import Icon from '../Icon/Icon.vue';
-import { useVoiceToText } from '../../../useVoiceToText';
+import { useVoiceToText, VOICE_UNAVAILABLE_MESSAGE } from '../../../useVoiceToText';
 
 type ButtonSize = 'sm' | 'md' | 'lg';
 type ButtonVariant = 'light' | 'dark';
@@ -37,6 +44,7 @@ interface VoiceToTextButtonProps {
   disabled?: boolean;
   size?: ButtonSize;
   variant?: ButtonVariant;
+  title?: string;
 }
 
 const props = withDefaults(defineProps<VoiceToTextButtonProps>(), {
@@ -44,6 +52,7 @@ const props = withDefaults(defineProps<VoiceToTextButtonProps>(), {
   disabled: false,
   size: 'md',
   variant: 'dark',
+  title: undefined,
 });
 
 const sizeClasses = computed(() => {
@@ -91,6 +100,9 @@ const variantClasses = computed(() => {
   };
 });
 
+const unavailableForSession = computed(() => !isSupported.value);
+const effectiveTitle = computed(() => (unavailableForSession.value ? VOICE_UNAVAILABLE_MESSAGE : props.title));
+
 // Keep recognition language in sync with prop
 watch(toRef(props, 'lang'), setLang);
 
@@ -144,4 +156,23 @@ watch(error, (newError) => {
     opacity: 0.5;
   }
 }
+
+.voice-prompt-unavailable {
+  position: relative;
+}
+
+.voice-prompt-unavailable::after {
+  content: '';
+  position: absolute;
+  inset: 18%;
+  background: linear-gradient(
+    135deg,
+    transparent calc(50% - 1px),
+    #E34935 calc(50% - 1px),
+    #E34935 calc(50% + 1px),
+    transparent calc(50% + 1px)
+  );
+  pointer-events: none;
+  border-radius: inherit;
+}
 </style>

package/src/useVoiceToText.ts

@@ -31,6 +31,7 @@ let isInitialized = false;
 let errorClearTimeout: ReturnType<typeof setTimeout> | null = null;
 let state: VoiceToTextState | null = null;
 let sessionDisabled: Ref<boolean> | null = null;
+let hasReceivedResult = false;
 
 // Edge ships window.SpeechRecognition but routes it through Microsoft's Online
 // Speech service, which is gated by a Windows privacy toggle that's commonly
@@ -47,8 +48,24 @@ const ERROR_MESSAGES: Record<string, string> = {
   'audio-capture': 'No microphone was found or microphone is not working.',
 };
 
+export const VOICE_UNAVAILABLE_MESSAGE =
+  "Voice input isn't available in this browser. Try Chrome or Safari for the best experience.";
+
 const ERROR_CLEAR_DELAY = 5000;
 
+async function checkMicPermission(): Promise<'granted' | 'denied' | 'prompt' | 'unknown'> {
+  try {
+    if (typeof navigator === 'undefined' || !navigator.permissions?.query) {
+      return 'unknown';
+    }
+    const result = await navigator.permissions.query({ name: 'microphone' as PermissionName });
+    return result.state as 'granted' | 'denied' | 'prompt';
+  } catch {
+    // Permissions API or the 'microphone' descriptor isn't supported (older Safari, Firefox quirks).
+    return 'unknown';
+  }
+}
+
 function getState(): VoiceToTextState {
   if (!state) {
     state = {
@@ -89,12 +106,23 @@ function setSessionDisabled(disabled: boolean): void {
   }
 }
 
+function latchAsUnavailable(): void {
+  const { error: errorRef } = getState();
+  setSessionDisabled(true);
+  errorRef.value = VOICE_UNAVAILABLE_MESSAGE;
+  if (errorClearTimeout) {
+    clearTimeout(errorClearTimeout);
+  }
+  errorClearTimeout = setTimeout(() => {
+    errorRef.value = null;
+  }, ERROR_CLEAR_DELAY);
+}
+
 /**
  * Test/Storybook helper: force the session-disabled latch on or off without
  * needing a real network error. Not part of the public consumer API.
  */
-// eslint-disable-next-line no-underscore-dangle
-export function __setVoiceToTextSessionDisabled(disabled: boolean): void {
+export function setVoiceToTextSessionDisabledForTesting(disabled: boolean): void {
   setSessionDisabled(disabled);
 }
 
@@ -134,27 +162,67 @@ export function useVoiceToText(options: UseVoiceToTextOptions = {}): UseVoiceToT
         }
       }
 
+      if (finalTranscript.length > 0 || interimTranscript.length > 0) {
+        hasReceivedResult = true;
+      }
+
       transcript.value = finalTranscript + interimTranscript;
       isFinal.value = interimTranscript === '';
     };
 
-    recognition.onerror = (event: SpeechRecognitionErrorEvent) => {
+    recognition.onerror = async (event: SpeechRecognitionErrorEvent) => {
       // Suppress no-speech and aborted errors per spec
       if (event.error === 'no-speech' || event.error === 'aborted') {
         return;
       }
 
-      // Latch on first network error: Edge exposes SpeechRecognition but the
-      // backend doesn't actually work for most users. Hide the feature for the
-      // rest of the session rather than surfacing a recurring toast.
+      // Diagnostic instrumentation: capture state at every non-suppressed error
+      // so QA has a data point on first failure across browser/permission combos.
+      const micPermission = await checkMicPermission();
+      const sessionDisabledFlag = getSessionDisabled().value;
+      // eslint-disable-next-line no-console
+      console.warn('[useVoiceToText] error event', {
+        error: event.error,
+        micPermission,
+        hasReceivedResult,
+        sessionDisabled: sessionDisabledFlag,
+      });
+
       if (event.error === 'network') {
-        // eslint-disable-next-line no-console
-        console.warn('[useVoiceToText] network error — disabling voice input for this session');
-        isListening.value = false;
-        setSessionDisabled(true);
+        if (!hasReceivedResult) {
+          // First-attempt network failure on Edge with the privacy toggle off (or
+          // an actually-broken network). Latch the feature off for the session.
+          // eslint-disable-next-line no-console
+          console.warn('[useVoiceToText] network error before any result — disabling voice input for this session');
+          isListening.value = false;
+          latchAsUnavailable();
+        } else {
+          // Trailing network error after a successful result is a known Edge teardown
+          // quirk — swallow it instead of latching, since voice clearly works for this user.
+          // eslint-disable-next-line no-console
+          console.warn('[useVoiceToText] swallowing trailing network error after successful result');
+          isListening.value = false;
+        }
         return;
       }
 
+      if (event.error === 'not-allowed') {
+        if (micPermission === 'granted') {
+          // Page-level mic permission was granted but the underlying speech backend
+          // (Edge's Microsoft Online Speech service) refused. This is the Mac
+          // InPrivate / Windows-toggle-off failure mode. Latch instead of showing a
+          // misleading "permission denied" toast.
+          // eslint-disable-next-line no-console
+          console.warn(
+            '[useVoiceToText] not-allowed despite granted mic permission — disabling voice input for this session',
+          );
+          isListening.value = false;
+          latchAsUnavailable();
+          return;
+        }
+        // Otherwise fall through to the existing "permission was denied" toast.
+      }
+
       const message = ERROR_MESSAGES[event.error] || 'An error occurred with speech recognition.';
       error.value = message;