@ihabdevteam/core 0.18.0 → 0.19.0

package/dist/ihabdevteam-core.d.ts

@@ -5119,7 +5119,7 @@ export declare interface SliderProps {
 export declare function sortToValue(key: string, asc: boolean): string | undefined;
 
 /** @public */
-export declare function SoundCompass({ speakers, size, viewT, activeSpeakerId, playedIds, selectedId, answerId, showFeedback, pulseSelected, clickable, onSelectSpeaker, buttonSize, showIcon, shortcutAnchor, shortcutScale, scaleShortcut, }: SoundCompassProps): JSX.Element;
+export declare function SoundCompass({ speakers, size, viewT, activeSpeakerId, playedIds, selectedId, answerId, showFeedback, pulseSelected, pulseSelectedDuration, clickable, onSelectSpeaker, buttonSize, showIcon, shortcutAnchor, shortcutScale, scaleShortcut, }: SoundCompassProps): JSX.Element;
 
 export declare interface SoundCompassExam {
     /** `<SoundCompass {...bind} />` 로 펼쳐 넣는 제어 props */
@@ -5200,6 +5200,18 @@ export declare interface SoundCompassProps {
      * 일어난 순간을 알리는 것이라 되풀이할 까닭이 없다.
      */
     pulseSelected?: boolean;
+    /**
+     * 고른 자리 울림이 번지는 시간(ms). 기본 1000.
+     *
+     * 고른 상태를 짧게만 잡아 두는 검사에서는 울림이 중간에 끊긴다 — 소비 앱 실측:
+     * 선택을 350ms 만 잡아 두니 울림이 35% 지점(퍼짐 1.6배)에서 통째로 사라져,
+     * 가장 잘 보이는 확산 구간이 잘려 나갔다. 상태를 오래 잡아 두는 대신 울림을
+     * 그 시간에 맞추는 편이 검사를 늘리지 않는다.
+     *
+     * 소리가 나는 동안의 울림(`activeSpeakerId`)은 1s 고정이다 — 그쪽은 이어지는
+     * 상태를 알리는 것이라 짧을 까닭이 없다. 필요해지면 그때 연다.
+     */
+    pulseSelectedDuration?: number;
     /** 스피커 클릭 가능 여부. 기본 false */
     clickable?: boolean;
     /** 스피커 선택 시 호출 */

package/dist/packages/core/src/components/SoundCompass.css

@@ -140,6 +140,8 @@
    되풀이를 끊는 것만으로 그대로 사라진다. */
 .sound-compass__pulse--once {
   animation-iteration-count: 1;
+  /* 고른 상태를 짧게만 잡아 두는 검사에서는 이 시간을 줄여야 울림이 안 끊긴다. */
+  animation-duration: var(--sc-pulse-duration-once, 1s);
 }
 
 /* 스피커 버튼 wrap의 정적 속성만 분리(나머지는 상태·좌표 기반 동적 값이라 인라인 유지) */

package/dist/packages/core/src/components/SoundCompass.d.ts

@@ -44,6 +44,18 @@ export interface SoundCompassProps {
      * 일어난 순간을 알리는 것이라 되풀이할 까닭이 없다.
      */
     pulseSelected?: boolean;
+    /**
+     * 고른 자리 울림이 번지는 시간(ms). 기본 1000.
+     *
+     * 고른 상태를 짧게만 잡아 두는 검사에서는 울림이 중간에 끊긴다 — 소비 앱 실측:
+     * 선택을 350ms 만 잡아 두니 울림이 35% 지점(퍼짐 1.6배)에서 통째로 사라져,
+     * 가장 잘 보이는 확산 구간이 잘려 나갔다. 상태를 오래 잡아 두는 대신 울림을
+     * 그 시간에 맞추는 편이 검사를 늘리지 않는다.
+     *
+     * 소리가 나는 동안의 울림(`activeSpeakerId`)은 1s 고정이다 — 그쪽은 이어지는
+     * 상태를 알리는 것이라 짧을 까닭이 없다. 필요해지면 그때 연다.
+     */
+    pulseSelectedDuration?: number;
     /** 스피커 클릭 가능 여부. 기본 false */
     clickable?: boolean;
     /** 스피커 선택 시 호출 */
@@ -79,4 +91,4 @@ export interface SoundCompassProps {
     scaleShortcut?: boolean;
 }
 /** @public */
-export default function SoundCompass({ speakers, size, viewT, activeSpeakerId, playedIds, selectedId, answerId, showFeedback, pulseSelected, clickable, onSelectSpeaker, buttonSize, showIcon, shortcutAnchor, shortcutScale, scaleShortcut, }: SoundCompassProps): import("react").JSX.Element;
+export default function SoundCompass({ speakers, size, viewT, activeSpeakerId, playedIds, selectedId, answerId, showFeedback, pulseSelected, pulseSelectedDuration, clickable, onSelectSpeaker, buttonSize, showIcon, shortcutAnchor, shortcutScale, scaleShortcut, }: SoundCompassProps): import("react").JSX.Element;

package/dist/packages/core/src/components/SoundCompass.js

@@ -14,7 +14,7 @@ import ShortcutBadge from './ShortcutBadge';
 import './SoundCompass.css';
 const lerp = (a, b, t) => a + (b - a) * t;
 /** @public */
-export default function SoundCompass({ speakers, size = 300, viewT = 0, activeSpeakerId = null, playedIds, selectedId = null, answerId = null, showFeedback = false, pulseSelected = false, clickable = false, onSelectSpeaker, buttonSize = 40, showIcon = true, shortcutAnchor = 'top-right', shortcutScale, scaleShortcut = false, }) {
+export default function SoundCompass({ speakers, size = 300, viewT = 0, activeSpeakerId = null, playedIds, selectedId = null, answerId = null, showFeedback = false, pulseSelected = false, pulseSelectedDuration, clickable = false, onSelectSpeaker, buttonSize = 40, showIcon = true, shortcutAnchor = 'top-right', shortcutScale, scaleShortcut = false, }) {
     const t = Math.max(0, Math.min(1, viewT));
     const CENTER = size / 2;
     // ── 탑뷰 좌표 ──────────────────────────────────────────────────────────
@@ -192,6 +192,12 @@ export default function SoundCompass({ speakers, size = 300, viewT = 0, activeSp
                     const iconSize = Math.round(Math.max(10, Math.min(56, BTN * 0.38)));
                     const numberSize = Math.round(Math.max(7, Math.min(18, BTN * 0.2)));
                     const numberOnlySize = Math.round(Math.max(10, Math.min(56, BTN * 0.4)));
-                    return (_jsxs("div", { className: "sound-compass__speaker-pos", style: { ...baseStyle, left: x - BTN / 2, top: y - BTN / 2 }, children: [pulse && (_jsx("div", { className: `sound-compass__pulse${pulse === 'once' ? ' sound-compass__pulse--once' : ''}`, style: { width: BTN, height: BTN } })), _jsxs("button", { type: "button", tabIndex: clickable ? 0 : -1, "aria-disabled": clickable ? undefined : true, onClick: clickable ? () => onSelectSpeaker?.(sp.id) : undefined, className: `sound-compass__speaker-btn sound-compass__speaker-btn--${state}`, style: { width: BTN, height: BTN }, "aria-label": sp.label, children: [showIcon && getStateIcon(state, iconSize), _jsx("span", { className: "sound-compass__speaker-number", style: { fontSize: showIcon ? numberSize : numberOnlySize }, children: idx + 1 })] }), sp.shortcut && (_jsx(ShortcutBadge, { keys: sp.shortcut, anchor: shortcutAnchor, className: "sound-compass__speaker-shortcut" }))] }, sp.id));
+                    return (_jsxs("div", { className: "sound-compass__speaker-pos", style: { ...baseStyle, left: x - BTN / 2, top: y - BTN / 2 }, children: [pulse && (_jsx("div", { className: `sound-compass__pulse${pulse === 'once' ? ' sound-compass__pulse--once' : ''}`, style: {
+                                    width: BTN, height: BTN,
+                                    // 안 주면 아예 얹지 않는다 — CSS 의 기본 1s 가 살아 있게.
+                                    ...(pulse === 'once' && pulseSelectedDuration !== undefined
+                                        ? { ['--sc-pulse-duration-once']: `${pulseSelectedDuration}ms` }
+                                        : null),
+                                } })), _jsxs("button", { type: "button", tabIndex: clickable ? 0 : -1, "aria-disabled": clickable ? undefined : true, onClick: clickable ? () => onSelectSpeaker?.(sp.id) : undefined, className: `sound-compass__speaker-btn sound-compass__speaker-btn--${state}`, style: { width: BTN, height: BTN }, "aria-label": sp.label, children: [showIcon && getStateIcon(state, iconSize), _jsx("span", { className: "sound-compass__speaker-number", style: { fontSize: showIcon ? numberSize : numberOnlySize }, children: idx + 1 })] }), sp.shortcut && (_jsx(ShortcutBadge, { keys: sp.shortcut, anchor: shortcutAnchor, className: "sound-compass__speaker-shortcut" }))] }, sp.id));
                 })] }) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ihabdevteam/core",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "private": false,
   "main": "dist/ihabdevteam-core.cjs.js",
   "module": "dist/ihabdevteam-core.esm.js",