@shepai/cli 1.60.0 → 1.61.0

package/dist/src/presentation/web/components/common/tech-decisions-review/tech-decisions-review.stories.js

@@ -47,7 +47,7 @@ const meta = {
     ],
 };
 export default meta;
-/** Default — scrollable list of decisions taken. */
+/** Default — scrollable list of decisions taken. "Other Options Considered" toggle plays expand/collapse sounds. */
 export const Default = {
     args: {
         data: mockData,

package/dist/src/presentation/web/components/common/theme-toggle/theme-toggle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-toggle.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/theme-toggle/theme-toggle.tsx"],"names":[],"mappings":"AAMA,wBAAgB,WAAW,4CAyB1B"}
+{"version":3,"file":"theme-toggle.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/theme-toggle/theme-toggle.tsx"],"names":[],"mappings":"AAOA,wBAAgB,WAAW,4CAsC1B"}

package/dist/src/presentation/web/components/common/theme-toggle/theme-toggle.js

@@ -3,9 +3,22 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Moon, Sun } from 'lucide-react';
 import { Button } from '../../ui/button.js';
 import { useTheme } from '../../../hooks/useTheme.js';
+import { useSoundAction } from '../../../hooks/use-sound-action.js';
 export function ThemeToggle() {
     const { theme, resolvedTheme, setTheme } = useTheme();
+    const toggleOnSound = useSoundAction('toggle-on');
+    const toggleOffSound = useSoundAction('toggle-off');
     const toggleTheme = () => {
+        // Determine target theme before switching
+        const currentResolved = theme === 'system' ? resolvedTheme : theme;
+        const goingToDark = currentResolved !== 'dark';
+        // Play sound before setTheme for immediate feedback
+        if (goingToDark) {
+            toggleOnSound.play();
+        }
+        else {
+            toggleOffSound.play();
+        }
         // If system theme, switch to explicit light/dark
         // If explicit, toggle between light and dark
         if (theme === 'system') {

package/dist/src/presentation/web/components/common/theme-toggle/theme-toggle.stories.d.ts

@@ -3,6 +3,8 @@ import { ThemeToggle } from './theme-toggle.js';
 declare const meta: Meta<typeof ThemeToggle>;
 export default meta;
 type Story = StoryObj<typeof meta>;
+/** Default — click to toggle theme. Plays toggle-on (dark) or toggle-off (light) sound. */
 export declare const Default: Story;
+/** In context with label. Sounds play on each toggle click. */
 export declare const InContext: Story;
 //# sourceMappingURL=theme-toggle.stories.d.ts.map

package/dist/src/presentation/web/components/common/theme-toggle/theme-toggle.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-toggle.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/theme-toggle/theme-toggle.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,WAAW,CAOlC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC"}
+{"version":3,"file":"theme-toggle.stories.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/common/theme-toggle/theme-toggle.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,WAAW,CAOlC,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,2FAA2F;AAC3F,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,SAAS,EAAE,KAOvB,CAAC"}

package/dist/src/presentation/web/components/common/theme-toggle/theme-toggle.stories.js

@@ -9,9 +9,11 @@ const meta = {
     tags: ['autodocs'],
 };
 export default meta;
+/** Default — click to toggle theme. Plays toggle-on (dark) or toggle-off (light) sound. */
 export const Default = {
     render: () => _jsx(ThemeToggle, {}),
 };
+/** In context with label. Sounds play on each toggle click. */
 export const InContext = {
     render: () => (_jsxs("div", { className: "flex items-center gap-4 rounded-lg border p-4", children: [_jsx("span", { className: "text-muted-foreground text-sm", children: "Toggle theme:" }), _jsx(ThemeToggle, {})] })),
 };

package/dist/src/presentation/web/components/features/control-center/control-center-inner.js

@@ -14,7 +14,7 @@ import { PrdQuestionnaireDrawer } from '../../common/prd-questionnaire/index.js'
 import { TechDecisionsDrawer } from '../../common/tech-decisions-review/index.js';
 import { MergeReviewDrawer } from '../../common/merge-review/index.js';
 import { NotificationPermissionBanner } from '../../common/notification-permission-banner/index.js';
-import { useSound } from '../../../hooks/use-sound.js';
+import { useSoundAction } from '../../../hooks/use-sound-action.js';
 import { ControlCenterEmptyState } from './control-center-empty-state.js';
 import { useControlCenterState } from './use-control-center-state.js';
 export function ControlCenterInner({ initialNodes, initialEdges }) {
@@ -43,7 +43,7 @@ export function ControlCenterInner({ initialNodes, initialEdges }) {
     const [isLoadingQuestionnaire, setIsLoadingQuestionnaire] = useState(false);
     // Reject state (shared by both drawers)
     const [isRejecting, setIsRejecting] = useState(false);
-    const rejectSound = useSound('caution', { volume: 0.5 });
+    const rejectSound = useSoundAction('reject');
     // Tech decisions drawer state
     const [techDecisionsData, setTechDecisionsData] = useState(null);
     const [isLoadingTechDecisions, setIsLoadingTechDecisions] = useState(false);

package/dist/src/presentation/web/components/features/control-center/use-control-center-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-control-center-state.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/use-control-center-state.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAYhF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,cAAc,CAAC,EAAE,KAAK,IAAI,CAAC;IAC/D,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzE,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,yBAAyB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,CAAC;IACnD,yBAAyB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAChE,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,sBAAsB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,CACjB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KACpC,MAAM,CAAC;IACZ,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAID,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,cAAc,EAAE,EAC9B,YAAY,EAAE,IAAI,EAAE,GACnB,kBAAkB,CAgtBpB"}
+{"version":3,"file":"use-control-center-state.d.ts","sourceRoot":"","sources":["../../../../../../../src/presentation/web/components/features/control-center/use-control-center-state.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAYhF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,cAAc,CAAC,EAAE,KAAK,IAAI,CAAC;IAC/D,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzE,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,yBAAyB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,CAAC;IACnD,yBAAyB,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAChE,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,sBAAsB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,CACjB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KACpC,MAAM,CAAC;IACZ,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAID,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,cAAc,EAAE,EAC9B,YAAY,EAAE,IAAI,EAAE,GACnB,kBAAkB,CA2sBpB"}

package/dist/src/presentation/web/components/features/control-center/use-control-center-state.js

@@ -9,7 +9,7 @@ import { deleteFeature } from '../../../app/actions/delete-feature.js';
 import { addRepository } from '../../../app/actions/add-repository.js';
 import { deleteRepository } from '../../../app/actions/delete-repository.js';
 import { useAgentEventsContext } from '../../../hooks/agent-events-provider.js';
-import { useSound } from '../../../hooks/use-sound.js';
+import { useSoundAction } from '../../../hooks/use-sound-action.js';
 import { mapEventTypeToState, mapPhaseNameToLifecycle, } from '../../common/feature-node/derive-feature-state.js';
 let nextFeatureId = 0;
 export function useControlCenterState(initialNodes, initialEdges) {
@@ -30,9 +30,9 @@ export function useControlCenterState(initialNodes, initialEdges) {
     const [selectedNode, setSelectedNode] = useState(null);
     const [isCreateDrawerOpen, setIsCreateDrawerOpen] = useState(false);
     const [isDeleting, setIsDeleting] = useState(false);
-    const deleteSound = useSound('transition_down', { volume: 0.5 });
-    const createSound = useSound('transition_up', { volume: 0.5 });
-    const clickSound = useSound('tap_01', { volume: 0.3 });
+    const deleteSound = useSoundAction('delete');
+    const createSound = useSoundAction('create');
+    const clickSound = useSoundAction('click');
     const [pendingRepoNodeId, setPendingRepoNodeId] = useState(null);
     // Sync server props into local state when router.refresh() delivers new data
     const initialNodeKey = initialNodes
@@ -189,14 +189,9 @@ export function useControlCenterState(initialNodes, initialEdges) {
     const onNodesChange = useCallback((changes) => {
         setNodes((ns) => applyNodeChanges(changes, ns));
     }, []);
-    const closeSound = useSound('transition_down', { volume: 0.01 });
     const clearSelection = useCallback(() => {
-        setSelectedNode((prev) => {
-            if (prev)
-                closeSound.play();
-            return null;
-        });
-    }, [closeSound]);
+        setSelectedNode(null);
+    }, []);
     const handleNodeClick = useCallback((_event, node) => {
         if (node.type === 'featureNode') {
             const data = node.data;
@@ -395,10 +390,9 @@ export function useControlCenterState(initialNodes, initialEdges) {
         });
     }, [router, createFeatureNode, pendingRepoNodeId, createSound, pendingParentFeatureId, setEdges]);
     const closeCreateDrawer = useCallback(() => {
-        closeSound.play();
         setIsCreateDrawerOpen(false);
         setPendingParentFeatureId(undefined);
-    }, [closeSound]);
+    }, []);
     const handleDeleteFeature = useCallback(async (featureId) => {
         setIsDeleting(true);
         try {

package/dist/src/presentation/web/hooks/use-notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-notifications.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-notifications.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,sBAAsB;IACrC,wBAAwB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AA4CD,wBAAgB,gBAAgB,IAAI,sBAAsB,CAgEzD"}
+{"version":3,"file":"use-notifications.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-notifications.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,wBAAwB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,sBAAsB,EAAE,sBAAsB,CAAC;CAChD;AA4CD,wBAAgB,gBAAgB,IAAI,sBAAsB,CAgEzD"}

package/dist/src/presentation/web/hooks/use-notifications.js

@@ -3,7 +3,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { toast } from 'sonner';
 import { NotificationEventType, NotificationSeverity } from '../../../../packages/core/src/domain/generated/output.js';
 import { useAgentEventsContext } from './agent-events-provider.js';
-import { useSound } from './use-sound.js';
+import { useSoundAction } from './use-sound-action.js';
 const SEVERITY_TO_TOAST = {
     [NotificationSeverity.Success]: 'success',
     [NotificationSeverity.Error]: 'error',
@@ -34,23 +34,23 @@ function dispatchBrowserNotification(event) {
         icon: '/favicon-light.svg',
     });
 }
-const SEVERITY_TO_SOUND = {
-    [NotificationSeverity.Success]: 'celebration',
-    [NotificationSeverity.Error]: 'caution',
-    [NotificationSeverity.Warning]: 'notification',
-    [NotificationSeverity.Info]: 'button',
+const SEVERITY_TO_ACTION = {
+    [NotificationSeverity.Success]: 'notification-success',
+    [NotificationSeverity.Error]: 'notification-error',
+    [NotificationSeverity.Warning]: 'notification-warning',
+    [NotificationSeverity.Info]: 'notification-info',
 };
 export function useNotifications() {
     const { events } = useAgentEventsContext();
-    const successSound = useSound('celebration', { volume: 0.5 });
-    const errorSound = useSound('caution', { volume: 0.5 });
-    const warningSound = useSound('notification', { volume: 0.5 });
-    const infoSound = useSound('button', { volume: 0.5 });
-    const soundsByName = useMemo(() => ({
-        celebration: successSound,
-        caution: errorSound,
-        notification: warningSound,
-        button: infoSound,
+    const successSound = useSoundAction('notification-success');
+    const errorSound = useSoundAction('notification-error');
+    const warningSound = useSoundAction('notification-warning');
+    const infoSound = useSoundAction('notification-info');
+    const soundsByAction = useMemo(() => ({
+        'notification-success': successSound,
+        'notification-error': errorSound,
+        'notification-warning': warningSound,
+        'notification-info': infoSound,
     }), [successSound, errorSound, warningSound, infoSound]);
     const [browserPermissionState, setBrowserPermissionState] = useState(() => {
         if (typeof globalThis.Notification === 'undefined')
@@ -75,10 +75,10 @@ export function useNotifications() {
             }
             dispatchToast(event);
             dispatchBrowserNotification(event);
-            const soundName = SEVERITY_TO_SOUND[event.severity];
-            soundsByName[soundName]?.play();
+            const actionName = SEVERITY_TO_ACTION[event.severity];
+            soundsByAction[actionName]?.play();
         }
-    }, [events, soundsByName]);
+    }, [events, soundsByAction]);
     const requestBrowserPermission = useCallback(async () => {
         if (typeof globalThis.Notification === 'undefined')
             return;

package/dist/src/presentation/web/hooks/use-sound-action.d.ts

@@ -0,0 +1,100 @@
+import type { UseSoundResult } from './use-sound.js';
+/** Maps semantic UI actions to their sound name and volume. */
+export declare const SOUND_ACTION_MAP: {
+    readonly navigate: {
+        readonly sound: "tap_01";
+        readonly volume: 0.2;
+    };
+    readonly 'menu-item': {
+        readonly sound: "tap_01";
+        readonly volume: 0.2;
+    };
+    readonly select: {
+        readonly sound: "select";
+        readonly volume: 0.3;
+    };
+    readonly 'toggle-on': {
+        readonly sound: "toggle_on";
+        readonly volume: 0.3;
+    };
+    readonly 'toggle-off': {
+        readonly sound: "toggle_off";
+        readonly volume: 0.3;
+    };
+    readonly click: {
+        readonly sound: "tap_01";
+        readonly volume: 0.3;
+    };
+    readonly cancel: {
+        readonly sound: "transition_down";
+        readonly volume: 0.3;
+    };
+    readonly expand: {
+        readonly sound: "swipe";
+        readonly volume: 0.3;
+    };
+    readonly collapse: {
+        readonly sound: "swipe";
+        readonly volume: 0.3;
+    };
+    readonly 'menu-open': {
+        readonly sound: "select";
+        readonly volume: 0.3;
+    };
+    readonly copy: {
+        readonly sound: "select";
+        readonly volume: 0.3;
+    };
+    readonly 'drawer-open': {
+        readonly sound: "transition_up";
+        readonly volume: 0.4;
+    };
+    readonly 'drawer-close': {
+        readonly sound: "transition_down";
+        readonly volume: 0.4;
+    };
+    readonly submit: {
+        readonly sound: "button";
+        readonly volume: 0.4;
+    };
+    readonly approve: {
+        readonly sound: "celebration";
+        readonly volume: 0.5;
+    };
+    readonly reject: {
+        readonly sound: "caution";
+        readonly volume: 0.5;
+    };
+    readonly create: {
+        readonly sound: "transition_up";
+        readonly volume: 0.5;
+    };
+    readonly delete: {
+        readonly sound: "transition_down";
+        readonly volume: 0.5;
+    };
+    readonly 'notification-success': {
+        readonly sound: "celebration";
+        readonly volume: 0.5;
+    };
+    readonly 'notification-error': {
+        readonly sound: "caution";
+        readonly volume: 0.5;
+    };
+    readonly 'notification-warning': {
+        readonly sound: "notification";
+        readonly volume: 0.5;
+    };
+    readonly 'notification-info': {
+        readonly sound: "button";
+        readonly volume: 0.5;
+    };
+};
+/** Union of all semantic action names available in the sound system. */
+export type SoundAction = keyof typeof SOUND_ACTION_MAP;
+/**
+ * Returns `{ play, stop, isPlaying }` for the given semantic action.
+ * Sound name and volume are resolved from `SOUND_ACTION_MAP`.
+ */
+export declare function useSoundAction(action: SoundAction): UseSoundResult;
+//# sourceMappingURL=use-sound-action.d.ts.map

package/dist/src/presentation/web/hooks/use-sound-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sound-action.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-sound-action.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B4C,CAAC;AAE1E,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAGlE"}

package/dist/src/presentation/web/hooks/use-sound-action.js

@@ -0,0 +1,42 @@
+'use client';
+import { useSound } from './use-sound.js';
+/* ------------------------------------------------------------------ */
+/*  Sound Action Map — single source of truth for action → sound      */
+/* ------------------------------------------------------------------ */
+/** Maps semantic UI actions to their sound name and volume. */
+export const SOUND_ACTION_MAP = {
+    // Navigation (volume 0.2) — subtle taps for frequent interactions
+    navigate: { sound: 'tap_01', volume: 0.2 },
+    'menu-item': { sound: 'tap_01', volume: 0.2 },
+    // Toggles & selections (volume 0.3) — moderate feedback
+    select: { sound: 'select', volume: 0.3 },
+    'toggle-on': { sound: 'toggle_on', volume: 0.3 },
+    'toggle-off': { sound: 'toggle_off', volume: 0.3 },
+    click: { sound: 'tap_01', volume: 0.3 },
+    cancel: { sound: 'transition_down', volume: 0.3 },
+    expand: { sound: 'swipe', volume: 0.3 },
+    collapse: { sound: 'swipe', volume: 0.3 },
+    'menu-open': { sound: 'select', volume: 0.3 },
+    copy: { sound: 'select', volume: 0.3 },
+    // Drawers & transitions (volume 0.4) — noticeable transitions
+    'drawer-open': { sound: 'transition_up', volume: 0.4 },
+    'drawer-close': { sound: 'transition_down', volume: 0.4 },
+    submit: { sound: 'button', volume: 0.4 },
+    // Significant actions (volume 0.5) — prominent feedback
+    approve: { sound: 'celebration', volume: 0.5 },
+    reject: { sound: 'caution', volume: 0.5 },
+    create: { sound: 'transition_up', volume: 0.5 },
+    delete: { sound: 'transition_down', volume: 0.5 },
+    'notification-success': { sound: 'celebration', volume: 0.5 },
+    'notification-error': { sound: 'caution', volume: 0.5 },
+    'notification-warning': { sound: 'notification', volume: 0.5 },
+    'notification-info': { sound: 'button', volume: 0.5 },
+};
+/**
+ * Returns `{ play, stop, isPlaying }` for the given semantic action.
+ * Sound name and volume are resolved from `SOUND_ACTION_MAP`.
+ */
+export function useSoundAction(action) {
+    const { sound, volume } = SOUND_ACTION_MAP[action];
+    return useSound(sound, { volume });
+}

package/dist/src/presentation/web/hooks/use-sound-action.stories.d.ts

@@ -0,0 +1,6 @@
+import type { Meta, StoryObj } from '@storybook/react';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Catalog: Story;
+//# sourceMappingURL=use-sound-action.stories.d.ts.map

package/dist/src/presentation/web/hooks/use-sound-action.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sound-action.stories.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/hooks/use-sound-action.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA8FvD,QAAA,MAAM,IAAI,EAAE,IAIX,CAAC;AAEF,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC;AAEtB,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC"}

package/dist/src/presentation/web/hooks/use-sound-action.stories.js

@@ -0,0 +1,61 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Button } from '../components/ui/button.js';
+import { useSoundAction, SOUND_ACTION_MAP } from './use-sound-action.js';
+/* ------------------------------------------------------------------ */
+/*  Action categories for display grouping                            */
+/* ------------------------------------------------------------------ */
+const ACTION_CATEGORIES = {
+    'Navigation (0.2)': ['navigate', 'menu-item'],
+    'Toggles & Selections (0.3)': [
+        'select',
+        'toggle-on',
+        'toggle-off',
+        'click',
+        'cancel',
+        'expand',
+        'collapse',
+        'menu-open',
+        'copy',
+    ],
+    'Drawers & Transitions (0.4)': ['drawer-open', 'drawer-close', 'submit'],
+    'Significant Actions (0.5)': ['approve', 'reject', 'create', 'delete'],
+    'Notifications (0.5)': [
+        'notification-success',
+        'notification-error',
+        'notification-warning',
+        'notification-info',
+    ],
+};
+/* ------------------------------------------------------------------ */
+/*  Single action button                                              */
+/* ------------------------------------------------------------------ */
+function ActionSoundButton({ action }) {
+    const { play } = useSoundAction(action);
+    const [playing, setPlaying] = useState(false);
+    const entry = SOUND_ACTION_MAP[action];
+    const handleClick = () => {
+        play();
+        setPlaying(true);
+        setTimeout(() => setPlaying(false), 600);
+    };
+    return (_jsxs(Button, { size: "sm", variant: playing ? 'default' : 'outline', onClick: handleClick, className: "min-w-[160px] font-mono text-xs", children: [action, _jsxs("span", { className: "text-muted-foreground ml-1 text-[10px]", children: ["(", entry.sound, " @ ", entry.volume, ")"] })] }));
+}
+/* ------------------------------------------------------------------ */
+/*  Full catalog                                                      */
+/* ------------------------------------------------------------------ */
+function SoundActionCatalog() {
+    return (_jsxs("div", { className: "flex w-[640px] flex-col gap-6", children: [_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("h2", { className: "text-base font-semibold", children: "Sound Action Map" }), _jsxs("p", { className: "text-muted-foreground text-sm", children: [Object.keys(SOUND_ACTION_MAP).length, " semantic actions mapped to sounds. Volume hierarchy: navigation (0.2) \u2192 toggles (0.3) \u2192 drawers (0.4) \u2192 actions (0.5)."] })] }), Object.entries(ACTION_CATEGORIES).map(([category, actions]) => (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h3", { className: "text-sm font-semibold", children: category }), _jsx("div", { className: "flex flex-wrap gap-2", children: actions.map((action) => (_jsx(ActionSoundButton, { action: action }, action))) })] }, category)))] }));
+}
+/* ------------------------------------------------------------------ */
+/*  Storybook meta                                                    */
+/* ------------------------------------------------------------------ */
+const meta = {
+    title: 'Hooks/useSoundAction',
+    parameters: { layout: 'centered' },
+    tags: ['autodocs'],
+};
+export default meta;
+export const Catalog = {
+    render: () => _jsx(SoundActionCatalog, {}),
+};