@ihabdevteam/core 0.220.0 → 0.221.0

package/dist/ihabdevteam-core.d.ts

@@ -9796,6 +9796,13 @@ export declare interface UseWordTablePrintOptions {
     onPopupBlocked?: () => void;
     /** 종이 맨 위에 찍을 한 줄(누구의·언제·무슨 표). 인쇄되는 것은 격자뿐이라
      *  이것이 없으면 뽑아 둔 종이에 아무 단서도 안 남는다. */
+    /**
+     * 쪽마다 종이 **맨 위**에 찍는 한 줄(누구의 · 언제 · 무슨 표).
+     *
+     * **띠(`brand`)를 쓰면 대개 이것은 안 준다** — 띠 위 오른쪽이 표 이름·기관·번호를
+     * 이미 싣는다. 둘 다 주면 번호가 종이에 **두 번** 찍힌다(말귀가 그 잔재를 걷었다,
+     * 2026-09-30). 띠를 안 쓰는 종이(채점지 등)에는 이 줄이 유일한 식별자다.
+     */
     header?: string;
 }
 

package/dist/packages/core/src/components/Word/useWordTablePrint.d.ts

@@ -11,6 +11,13 @@ export interface UseWordTablePrintOptions {
     onPopupBlocked?: () => void;
     /** 종이 맨 위에 찍을 한 줄(누구의·언제·무슨 표). 인쇄되는 것은 격자뿐이라
      *  이것이 없으면 뽑아 둔 종이에 아무 단서도 안 남는다. */
+    /**
+     * 쪽마다 종이 **맨 위**에 찍는 한 줄(누구의 · 언제 · 무슨 표).
+     *
+     * **띠(`brand`)를 쓰면 대개 이것은 안 준다** — 띠 위 오른쪽이 표 이름·기관·번호를
+     * 이미 싣는다. 둘 다 주면 번호가 종이에 **두 번** 찍힌다(말귀가 그 잔재를 걷었다,
+     * 2026-09-30). 띠를 안 쓰는 종이(채점지 등)에는 이 줄이 유일한 식별자다.
+     */
     header?: string;
 }
 /** @public */

package/dist/packages/core/src/components/Word/wordTablePrint.js

@@ -199,6 +199,43 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
     scale();
     window.addEventListener('resize', scale);
 
+    /* **칸 글씨를 이 종이 칸에 맞춰 다시 센다.**
+       화면의 칸은 'ResizeObserver' 로 재서 'transform: scale(n)' 을 칸 안쪽에 직접 써
+       둔다. 그 값이 클론을 타고 여기까지 따라오는데, 여기 칸은 화면 칸이 아니다 —
+       종이(paper-wrap)는 제 치수를 갖고, 인쇄가 걸리면 다시 100% x 100vh 로 바뀐다.
+       사람이 인쇄 대화상자에서 A4 아닌 종이를 고르면 그 100vh 가 또 달라진다. 굳은
+       배율을 그대로 쓰면 화면에서 칸을 꽉 채우던 글씨가 종이에서 작아진다(Letter 가로
+       실측 -3.4%, 사용자 신고 2026-09-30).
+       그래서 칸마다 새겨 둔 기준값(data-ref-w/h)으로 **화면과 똑같은 셈**을 여기서 다시
+       한다 — 'Math.min(w/refW, h/refH)', 1 을 넘겨도 천장을 안 씌운다(2026-09-22 결정).
+       'clientWidth' 는 배치 좌표라 종이에 걸린 'transform: scale()' 에 안 흔들린다. */
+    function refit() {
+      var cells = document.querySelectorAll('.word-table-cell[data-ref-w]');
+      Array.prototype.forEach.call(cells, function (cell) {
+        var inner = cell.querySelector('.word-table-cell__inner');
+        if (!inner) return;
+        var rw = parseFloat(cell.getAttribute('data-ref-w'));
+        var rh = parseFloat(cell.getAttribute('data-ref-h'));
+        if (!(rw > 0) || !(rh > 0)) return;
+        var cs = getComputedStyle(cell);
+        var w = cell.clientWidth  - parseFloat(cs.paddingLeft || 0) - parseFloat(cs.paddingRight  || 0);
+        var h = cell.clientHeight - parseFloat(cs.paddingTop  || 0) - parseFloat(cs.paddingBottom || 0);
+        /* 아직 자리를 못 잡은 칸(0)은 건드리지 않는다 — 화면이 준 배율이 0 보다는 낫다 */
+        if (!(w > 0) || !(h > 0)) return;
+        inner.style.transform = 'scale(' + Math.min(w / rw, h / rh) + ')';
+      });
+    }
+    refit();
+    window.addEventListener('resize', refit);
+    /* 인쇄 배치로 바뀌는 순간을 브라우저마다 다른 신호로 알린다 — 크롬은 beforeprint,
+       파이어폭스는 print 매체 질의가 먼저 켜진다. 둘 다 걸어 두고 두 번 세도 값이 같다. */
+    window.addEventListener('beforeprint', refit);
+    try {
+      var mq = window.matchMedia('print');
+      if (mq.addEventListener) mq.addEventListener('change', refit);
+      else if (mq.addListener) mq.addListener(refit);
+    } catch (e) { /* matchMedia 가 없는 환경 — 위 둘로 충분하다 */ }
+
     function resetWrap(w) {
       var pp = w.querySelector('[data-play-state="play"]');
       var pa = w.querySelector('[data-play-state="pause"]');
@@ -246,6 +283,8 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
         if (printed) return;
         printed = true;
         requestAnimationFrame(function () {
+          /* 그림·글꼴이 다 온 뒤 한 번 더 — 그림이 늦게 오면 칸 높이가 달라진다 */
+          refit();
           requestAnimationFrame(function () { window.print(); });
         });
       }

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

@@ -160,7 +160,7 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
         obs.observe(el);
         return () => obs.disconnect();
     }, [refW, refH]);
-    return (_jsxs("div", { ref: outerRef, className: cx('word-table-cell', hasImage ? 'word-table-cell--with-image' : ''), children: [_jsxs("div", { className: "word-table-cell__inner", style: { transform: `scale(${scale})` }, children: [hasImage && (_jsxs("div", { className: "word-table-cell__image-wrap", children: [imgLoading && _jsx("div", { className: "word-table-cell__spinner" }), _jsx("img", { ref: imgRef, className: "word-table-cell__image", src: imageUrl, alt: label, draggable: false, style: { opacity: imgLoading ? 0 : 1 }, onLoad: handleImgLoad, onError: handleImgError })] })), showWord && _jsx("span", { className: "word-table-cell__word h0", children: label }), showPronunciation && pron && _jsxs("span", { className: "word-table-cell__sub h3", children: ["[", pron, "]"] }), showColloquial && colloquialLabel && _jsxs("span", { className: "word-table-cell__colloquial h5", children: ["[", colloquialLabel, "]"] })] }), _jsxs("div", { className: "word-table-cell__play-button", "data-audio-src": audioUrl, children: [_jsx("span", { "data-play-state": "play", style: { display: playing ? 'none' : undefined }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "play", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: t('common.play', '재생'), onClick: handlePlay }) }), _jsx("span", { "data-play-state": "pause", style: { display: playing ? undefined : 'none' }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "pause", useBorder: false, selected: true, showTooltipInfo: t('common.pause', '멈춤'), onClick: handlePlay }) })] }), wordInfo && (_jsxs("div", { ref: infoRef, className: "word-table-cell__info-button", onPointerEnter: (e) => { if (!isTouchPointer(e))
+    return (_jsxs("div", { ref: outerRef, className: cx('word-table-cell', hasImage ? 'word-table-cell--with-image' : ''), "data-ref-w": refW, "data-ref-h": refH, children: [_jsxs("div", { className: "word-table-cell__inner", style: { transform: `scale(${scale})` }, children: [hasImage && (_jsxs("div", { className: "word-table-cell__image-wrap", children: [imgLoading && _jsx("div", { className: "word-table-cell__spinner" }), _jsx("img", { ref: imgRef, className: "word-table-cell__image", src: imageUrl, alt: label, draggable: false, style: { opacity: imgLoading ? 0 : 1 }, onLoad: handleImgLoad, onError: handleImgError })] })), showWord && _jsx("span", { className: "word-table-cell__word h0", children: label }), showPronunciation && pron && _jsxs("span", { className: "word-table-cell__sub h3", children: ["[", pron, "]"] }), showColloquial && colloquialLabel && _jsxs("span", { className: "word-table-cell__colloquial h5", children: ["[", colloquialLabel, "]"] })] }), _jsxs("div", { className: "word-table-cell__play-button", "data-audio-src": audioUrl, children: [_jsx("span", { "data-play-state": "play", style: { display: playing ? 'none' : undefined }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "play", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: t('common.play', '재생'), onClick: handlePlay }) }), _jsx("span", { "data-play-state": "pause", style: { display: playing ? undefined : 'none' }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "pause", useBorder: false, selected: true, showTooltipInfo: t('common.pause', '멈춤'), onClick: handlePlay }) })] }), wordInfo && (_jsxs("div", { ref: infoRef, className: "word-table-cell__info-button", onPointerEnter: (e) => { if (!isTouchPointer(e))
                     handleInfoEnter(); }, onPointerLeave: (e) => { if (!isTouchPointer(e))
                     handleInfoLeave(); }, 
                 // 이 div 자체는 포커스 대상이 아니지만 안의 Button이 포커스를 받으면

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ihabdevteam/core",
-  "version": "0.220.0",
+  "version": "0.221.0",
   "private": false,
   "main": "dist/ihabdevteam-core.cjs.js",
   "module": "dist/packages/core/src/index.js",