@vmscloud/moz-ui-components-core 0.1.43 → 0.1.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5,7 +5,11 @@ export { createRadio } from './radio.core';
5
5
  export type { RadioProps, RadioEmits } from './radio.core';
6
6
  /**
7
7
  * modelValue(v-model)만으로 동작 (원본에 change 이벤트 없음). update:modelValue 직접 emit.
8
- * `disabledExpr`·`size` 는 segment 접근성 보강(ITSM-2026-002578)에서 추가 — 여기 없으면 브리지가
9
- * rest 로 흘려 DOM attribute 가 된다.
8
+ * `disabledExpr`·`size` 는 segment 접근성 보강(ITSM-2026-002578)에서, `iconOnly` 는 segment 항목
9
+ * slot 계약(ITSM-2026-002607)에서 추가 — 여기 없으면 브리지가 rest 로 흘려 DOM attribute 가 된다.
10
+ *
11
+ * slots 는 동적(segment 의 `item-icon` / `item-badge`, scope `{ item, index, active, disabled }`) —
12
+ * Tab 과 같은 방식. Vue 래퍼는 소비자가 준 모든 slot 을 등록하고, React 는 `slots={{ … }}` prop 으로
13
+ * 받는다. 여기 정적으로 등재하면 React 가 항목 수만큼 독립 root 를 만들고 소비자 context 가 끊긴다.
10
14
  */
11
15
  export declare const RADIO_SPEC: MozSpec<RadioProps, RadioEmits, void>;
@@ -29,6 +29,25 @@
29
29
  * group 모드에서도 같은 항목이 native disabled 가 된다. `size`('md' 32px 기본 / 'sm' 24px) —
30
30
  * segment 컨테이너 높이 tier(높이 토큰이 없어 클래스로 푼다).
31
31
  *
32
+ * ## segment 항목 slot 계약 (ITSM-2026-002607)
33
+ *
34
+ * 세그먼트 버튼은 기본으로 `item[displayExpr]` 텍스트 노드 하나만 그린다. 소비자가 아이콘·배지를
35
+ * 넣을 수 있도록 **반복 scoped slot** 두 개를 연다 — 이름은 항목 값에서 파생하지 않고 하나로
36
+ * 고정하며(Select `list-item` 과 같은 방식), 코어가 같은 이름의 N번째 outlet 에 고유 인스턴스키를
37
+ * 붙여 행마다 독립 마운트·scope 갱신을 한다. `RADIO_SPEC.slots` 에는 넣지 않는다(Tab 과 같은
38
+ * 동적 slot) — 정적으로 등재하면 React 브릿지가 항목 수만큼 독립 root 를 만들고 소비자 context
39
+ * 가 끊긴다. React 는 `slots={{ 'item-icon': (scope) => … }}`, Vue 는 `#item-icon="scope"`.
40
+ * - `item-icon`: 텍스트 **앞**. `item-badge`: 텍스트 **뒤**(`iconOnly` 면 그리지 않는다).
41
+ * - scope: `{ item, index, active, disabled }` — `active` 는 `aria-checked` 와 같은 값이라
42
+ * 소비자가 활성 여부로 아이콘 weight 를 바꿀 수 있다.
43
+ * - 새 prop `iconOnly`(기본 false): 텍스트 노드를 그리지 않고 각 버튼에 `aria-label` 로 항목
44
+ * 텍스트를 준다(리터럴이 아니라 데이터, 텍스트가 비면 `item[valueExpr]` 로 폴백). 접근명은
45
+ * 벤더가 보장하고, 툴팁은 소비자 몫이다 —
46
+ * 코어끼리 합성하는 선례가 없고 native `title` 은 소비처가 금지한다. 컨테이너에 `icon-only`
47
+ * 클래스가 붙어 정사각 패딩으로 바뀐다.
48
+ * - slot 을 넘기지 않고 `iconOnly` 도 아니면 버튼 안은 종전과 같은 텍스트 노드 하나다 —
49
+ * 래퍼·속성을 추가하지 않는다(텍스트 전용 소비처의 DOM 보존이 계약이다).
50
+ *
32
51
  * 레거시 트랙 `src/ui/radio/Radio.vue` 는 코드를 공유하지 않는 별도 패키지라 손대지 않는다.
33
52
  * "1:1 포팅" 과 `-vue` 의 `Radio.parity.test.ts` 는 **레거시 동작을 보존한다** 는 회귀 계약이지
34
53
  * 레거시를 같이 고쳐야 한다는 뜻이 아니다 — 위 보강은 순수 추가라 parity 테스트를 무수정 통과한다.
@@ -50,6 +69,11 @@ export interface RadioProps {
50
69
  variant?: 'borderless' | 'boxed' | 'segment';
51
70
  /** segment 컨테이너 높이 tier — md 32px(기본) / sm 24px. 다른 variant 에서는 무시된다. */
52
71
  size?: 'md' | 'sm';
72
+ /**
73
+ * segment 전용 — 항목 텍스트를 그리지 않고 `aria-label` 로만 남긴다(아이콘 slot 과 함께 쓴다).
74
+ * 배지 slot 도 그리지 않는다. 다른 variant 에서는 무시된다.
75
+ */
76
+ iconOnly?: boolean;
53
77
  labelPosition?: 'top' | 'left';
54
78
  modelValue?: unknown;
55
79
  class?: unknown;