@vmscloud/moz-ui-components-core 0.1.67 → 0.1.68

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.
Files changed (65) hide show
  1. package/MIGRATION.md +50 -0
  2. package/README.md +5 -0
  3. package/dist/components/button/button.core.d.ts +14 -1
  4. package/dist/components/button/circleLoader.d.ts +6 -0
  5. package/dist/components/button/index.d.ts +1 -1
  6. package/dist/components/callout/callout.core.d.ts +4 -0
  7. package/dist/components/callout/index.d.ts +2 -2
  8. package/dist/components/chip/chip.core.d.ts +4 -3
  9. package/dist/components/input/index.d.ts +3 -2
  10. package/dist/components/input/input.core.d.ts +13 -0
  11. package/dist/components/number-input/numberinput.core.d.ts +7 -0
  12. package/dist/components/radio/radio.core.d.ts +2 -0
  13. package/dist/components/select/index.d.ts +1 -1
  14. package/dist/components/select/select.core.d.ts +8 -0
  15. package/dist/components/slider/slider.core.d.ts +1 -1
  16. package/dist/components/textarea/index.d.ts +1 -1
  17. package/dist/components/textarea/textarea.core.d.ts +21 -0
  18. package/dist/components/time-picker/index.d.ts +1 -1
  19. package/dist/components/time-picker/timepicker.core.d.ts +1 -1
  20. package/dist/components/tooltip/index.d.ts +1 -1
  21. package/dist/components/tooltip/tooltip.core.d.ts +19 -1
  22. package/dist/index.cjs +888 -855
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.d.ts +0 -1
  25. package/dist/index.js +3586 -3390
  26. package/dist/index.js.map +1 -1
  27. package/dist/styles/default/avatar.css +184 -1
  28. package/dist/styles/default/badge.css +195 -1
  29. package/dist/styles/default/breadcrumb.css +186 -3
  30. package/dist/styles/default/button.css +360 -1
  31. package/dist/styles/default/calendar.css +212 -1
  32. package/dist/styles/default/callout.css +262 -1
  33. package/dist/styles/default/checkbox.css +187 -1
  34. package/dist/styles/default/chip.css +235 -4
  35. package/dist/styles/default/contextmenu.css +192 -9
  36. package/dist/styles/default/controller.css +185 -2
  37. package/dist/styles/default/dateinput.css +184 -1
  38. package/dist/styles/default/emptystate.css +128 -0
  39. package/dist/styles/default/index.css +1161 -187
  40. package/dist/styles/default/input.css +223 -1
  41. package/dist/styles/default/label.css +184 -1
  42. package/dist/styles/default/multiselect.css +213 -18
  43. package/dist/styles/default/notification.css +185 -2
  44. package/dist/styles/default/numberinput.css +219 -1
  45. package/dist/styles/default/popover.css +186 -3
  46. package/dist/styles/default/popup.css +269 -1
  47. package/dist/styles/default/radio.css +203 -1
  48. package/dist/styles/default/scrollarea.css +184 -1
  49. package/dist/styles/default/select.css +270 -21
  50. package/dist/styles/default/slider.css +285 -15
  51. package/dist/styles/default/splitpane.css +128 -0
  52. package/dist/styles/default/tab.css +192 -1
  53. package/dist/styles/default/tableselect.css +185 -2
  54. package/dist/styles/default/taginput.css +187 -4
  55. package/dist/styles/default/textarea.css +247 -3
  56. package/dist/styles/default/timepicker.css +209 -4
  57. package/dist/styles/default/toast.css +192 -2
  58. package/dist/styles/default/toggle.css +184 -1
  59. package/dist/styles/default/tooltip.css +198 -1
  60. package/dist/styles/default/treeselect.css +280 -12
  61. package/package.json +4 -2
  62. package/dist/components/password-input/index.d.ts +0 -7
  63. package/dist/components/password-input/passwordinput.core.d.ts +0 -35
  64. package/dist/styles/default/passwordinput.css +0 -9
  65. /package/dist/components/{password-input/icons.d.ts → input/passwordIcons.d.ts} +0 -0
package/MIGRATION.md ADDED
@@ -0,0 +1,50 @@
1
+ # Select change 계약 이행 안내
2
+
3
+ > **Breaking change 준비 문서 — 게시·소비처 적용 완료 아님.** 최초 적용 릴리스의 정확 버전, 공급자/소비처 담당자, 공지일·적용 예정일은 **미정(확정 대기)**입니다. 현재 manifest 버전을 신규 계약 공개 버전으로 해석하지 마세요.
4
+
5
+ ## 대상과 변경
6
+
7
+ 대상은 `@vmscloud/moz-ui-components-core` 및 이를 사용하는 `@vmscloud/moz-ui-components-vue`, `@vmscloud/moz-ui-components-react`의 Select입니다. Select의 `change`를 TableSelect와 같은 `(value, originalItem|null)` 계약으로 사용합니다.
8
+
9
+ ```ts
10
+ // 이전: 둘째 인자를 테이블 키로 사용
11
+ (_, tableName) => { /* tableName === 'None' 등 업무 처리 */ }
12
+
13
+ // 신규: 첫째는 바인딩 값, 둘째는 원본 항목 또는 null
14
+ (tableName, item) => { /* tableName === 'None'; item은 null 가능 */ }
15
+
16
+ // 원본 항목을 쓰지 않으면
17
+ (tableName) => { /* 기존 업무 처리를 첫째 인자로 수행 */ }
18
+ ```
19
+
20
+ - 기본 키 바인딩: 첫째는 `keyProp` 값, 둘째는 `itemsSource`에서 그 키로 찾은 원본 항목 또는 `null`입니다.
21
+ - `useObjBinding=true`: 첫째는 모델 객체, 둘째는 그 키로 찾은 원본 항목 또는 `null`입니다. 둘째가 항상 문자열이거나 항상 객체라고 가정하지 마세요. Vue proxy 경계는 별도로 확인합니다.
22
+ - `0`/`false`는 유효 값입니다. `(first ?? second)` 같은 양쪽 계약 추측 shim을 사용하지 마세요.
23
+ - 모델 변경 감지 후 microtask에서 `change`가 발생하므로 클릭 전용 이벤트로 간주하지 마세요. `update:modelValue`와 이번 change 인자 이행은 별개입니다.
24
+
25
+ ## null/clear 주의
26
+
27
+ 모델의 null/undefined는 null로 정규화됩니다. 모델을 null로 비우고 변경이 감지되면 첫째는 null, 둘째는 null 키 조회 결과입니다. 일치 항목이 없으면 null이지만 **null 키 항목이 있으면 그 항목**이므로 `(null, null)`을 무조건 보장하지 않습니다. 미존재 키의 둘째 인자도 null 처리해야 합니다. 이는 모델 clear 경로 설명이며 별도 clear 버튼/API 지원을 뜻하지 않습니다.
28
+
29
+ `'None'`은 업무 옵션 문자열이지 null/clear가 아닙니다. mozart-cloud의 `ReportPropConfigMaster.vue`처럼 둘째 인자를 `'None'`과 비교하던 handler는 첫째 인자로 옮겨야 초기화가 누락되지 않습니다.
30
+
31
+ ## 원자적 적용과 롤백
32
+
33
+ 1. 릴리스 담당이 승인된 Core/Vue(React 사용 시 React 포함) 정확 버전, 실제 공개 artifact, source commit 및 Actions run을 확정합니다. Core 선게시와 wrapper 실제 의존 범위·해석 버전을 확인합니다. 이 문서에는 아직 존재하지 않는 릴리스 링크를 기재하지 않습니다.
34
+ 2. 소비처의 package manifest·lock과 영향받는 change handler를 **같은 변경·검증·배포 단위**로 적용합니다. handler 선변경 또는 package만 갱신하는 분리 배포는 금지합니다. named handler·동적 설정도 확인하되 model-only/native select는 무차별 변경하지 않습니다.
35
+ 3. 실제 신규 npm artifact로 `'None'` 초기화·일반 테이블 첫 컬럼 선택·비활성화, 키/객체 모드, 0/false, 미존재 키, null 키 예외, 모델 update/change 순서를 검증합니다. 타입 통과만으로 의미 호환성을 인증하지 않습니다.
36
+ 4. 문제 발생 시 **검증된 이전 패키지 조합(manifest·lock)과 이전 handler를 함께 복구**합니다. 적용/롤백 증거를 소비처 추적 문서에 기록합니다.
37
+
38
+ ## 전달 및 확정 대기
39
+
40
+ | 항목 | 상태 |
41
+ | --- | --- |
42
+ | 최초 적용 Core / Vue / React 버전 및 이전 조합 | 미정 — 릴리스 승인·artifact 확인 대기 |
43
+ | 공급자 릴리스 담당 / 소비처 유지보수 담당 | 미정 — 지정 대기 |
44
+ | 사전 공지일 / 수신 확인 / 적용 예정일 | 미정 — 직접 전달·확인 미수행 |
45
+ | source commit / Actions run / 공개 artifact 링크 | 미정 — 실제 게시 후 기록 |
46
+ | 소비처 적용·검증·롤백 결과 | 대기 — 이 준비 문서로 완료 판정하지 않음 |
47
+
48
+ 소비처 기록 위치: `mozart-cloud/.github/handoff/select-change-migration/README.md` (소비처 저장소 경로; 외부 링크는 게시 후 확정). 세 패키지의 MIGRATION.md는 동일 본문으로 관리합니다.
49
+
50
+ npm/pnpm update는 이 안내를 자동 팝업하지 않으며 Actions Summary도 수신을 보장하지 않습니다. 공급자 담당의 사전 전달과 소비처 수신·계획 확인, 게시 후 확정 버전/run 보완이 필요합니다. **현재 직접 통지·수신 확인은 미수행**입니다.
package/README.md ADDED
@@ -0,0 +1,5 @@
1
+ # @vmscloud/moz-ui-components-core
2
+
3
+ > **Breaking: Select change 계약 이행 준비** — 둘째 인자를 키로 사용하던 handler는 첫째 인자로 옮겨야 합니다.
4
+
5
+ [Select 이행 안내](./MIGRATION.md)를 먼저 확인하세요. 패키지·lock·handler는 함께 적용하고 함께 롤백합니다. 최초 적용 버전·담당자·일정은 미정(확정 대기)이며, 문서 준비는 게시 또는 소비처 적용 완료를 뜻하지 않습니다.
@@ -10,10 +10,12 @@ import { TemplateResult } from 'lit-html';
10
10
  * - width 가 :style(rem) 과 raw(var) 양쪽에 먹임.
11
11
  * - $attrs 패스스루(native click 버블 포함).
12
12
  */
13
- export type ButtonType = 'contained' | 'contained-large' | 'contained-small' | 'outline' | 'outline-small' | 'outline-icon' | 'ghost' | 'ghost-small' | 'ghost-xsmall' | 'contained-icon' | 'contained-icon-large' | 'contained-icon-small' | 'icon' | 'icon-active' | 'icon-accent' | 'text' | 'no-interaction' | 'default';
13
+ export type ButtonType = 'contained' | 'contained-critical' | 'contained-critical-weak' | 'contained-large' | 'contained-small' | 'outline' | 'outline-small' | 'outline-icon' | 'ghost' | 'ghost-small' | 'ghost-xsmall' | 'contained-icon' | 'contained-icon-large' | 'contained-icon-small' | 'icon' | 'icon-active' | 'icon-accent' | 'text' | 'no-interaction' | 'rail' | 'rail-home' | 'rail-profile' | 'default';
14
14
  /** Button 크기 어휘. 문서상 기본값은 medium 이지만 코드 defaults 에는 넣지 않는다(resolveButtonSize 참고). */
15
15
  export type ButtonSize = 'large' | 'medium' | 'small';
16
16
  export declare const BUTTON_SIZES: readonly ["large", "medium", "small"];
17
+ /** text Button 의 색 어휘. accent 는 기존 외형, neutral 은 중립 전경 + hover/active 행 바탕(VDP-020). */
18
+ export type ButtonTone = 'accent' | 'neutral';
17
19
  export type ButtonAction = 'Add' | 'Remove' | 'Edit' | 'Save' | 'Search' | 'Run' | 'Copy';
18
20
  export interface ButtonProps {
19
21
  action?: ButtonAction;
@@ -36,8 +38,19 @@ export interface ButtonProps {
36
38
  * 지정하지 않으면 type 별 기존 외형을 유지한다(`text` 는 13px 유지).
37
39
  */
38
40
  size?: ButtonSize;
41
+ /**
42
+ * `text` 전용 색. 생략·`'accent'` 는 기존 accent 외형, `'neutral'` 은 text-secondary 전경과
43
+ * hover/순간 active 의 muted-soft 바탕. text 외 type 과 알 수 없는 값은 무시한다(기존 외형).
44
+ */
45
+ tone?: ButtonTone;
39
46
  loading?: boolean;
40
47
  disabled?: boolean;
48
+ /**
49
+ * 지속 선택(토글) 상태. 소비자가 제어한다 — 코어는 click 만 emit 하고 스스로 바꾸지 않는다.
50
+ * boolean 이면 루트 button 의 `aria-pressed="true"|"false"` 로 출력되며 전달받은 raw `aria-pressed` 보다 우선한다.
51
+ * 생략하면 raw `aria-pressed` 를 그대로 두고, 최종값이 `"true"` 일 때만 선택 외형이 켜진다(`mixed` 는 외형 없음).
52
+ */
53
+ pressed?: boolean;
41
54
  /** 패스스루 (Vue $attrs / React className·style·rest) */
42
55
  class?: unknown;
43
56
  style?: unknown;
@@ -1,5 +1,11 @@
1
1
  import { TemplateResult } from 'lit-html';
2
2
 
3
+ /** Brand/Critical Solid: exact Figma 1966:388 / 1966:405 geometry and paint. */
4
+ export declare function brandSolidCircleLoader(): TemplateResult;
5
+ /** Side Toolbar rail (VDP-044): Brand Solid geometry and opacities in a fixed rail foreground role. */
6
+ export declare function railCircleLoader(fill: string): TemplateResult;
7
+ /** Critical Weak: Figma 1966:458, opaque pale track and danger progress. */
8
+ export declare function criticalWeakCircleLoader(): TemplateResult;
3
9
  /** CircleLoader.vue 의 lit-html 1:1 포팅 (내부 스피너). SVG path/색상 동일. */
4
10
  export interface CircleLoaderProps {
5
11
  circleClass?: string;
@@ -2,7 +2,7 @@ import { MozSpec } from '../../runtime/types';
2
2
  import { ButtonProps, ButtonEmits, ButtonApi } from './button.core';
3
3
 
4
4
  export { createButton, buttonTemplate, BUTTON_SIZES } from './button.core';
5
- export type { ButtonProps, ButtonEmits, ButtonApi, ButtonType, ButtonSize, ButtonAction, ButtonTemplateOptions } from './button.core';
5
+ export type { ButtonProps, ButtonEmits, ButtonApi, ButtonType, ButtonSize, ButtonTone, ButtonAction, ButtonTemplateOptions } from './button.core';
6
6
  export { circleLoader } from './circleLoader';
7
7
  export type { CircleLoaderProps } from './circleLoader';
8
8
  /**
@@ -18,7 +18,11 @@
18
18
  */
19
19
  export declare const CALLOUT_TONES: readonly ["info", "success", "warning", "danger", "neutral", "accent"];
20
20
  export type CalloutTone = (typeof CALLOUT_TONES)[number];
21
+ export declare const CALLOUT_MODES: readonly ["block", "inline", "banner"];
22
+ export type CalloutMode = (typeof CALLOUT_MODES)[number];
21
23
  export interface CalloutProps {
24
+ /** 표현. 기본/미지원 값은 block. inline/banner는 compact와 무관하게 한 줄 밀도를 쓴다. */
25
+ mode?: CalloutMode;
22
26
  /** 색 의미. 어휘 밖·미지정은 `info` */
23
27
  tone?: CalloutTone;
24
28
  /**
@@ -1,6 +1,6 @@
1
1
  import { MozSpec } from '../../runtime/types';
2
2
  import { CalloutProps, CalloutEmits } from './callout.core';
3
3
 
4
- export { createCallout, CALLOUT_TONES } from './callout.core';
5
- export type { CalloutProps, CalloutEmits, CalloutTone } from './callout.core';
4
+ export { createCallout, CALLOUT_TONES, CALLOUT_MODES } from './callout.core';
5
+ export type { CalloutProps, CalloutEmits, CalloutTone, CalloutMode } from './callout.core';
6
6
  export declare const CALLOUT_SPEC: MozSpec<CalloutProps, CalloutEmits, void>;
@@ -13,20 +13,21 @@
13
13
  *
14
14
  * 색 어휘는 Badge/Radio segment 와 같다 — `tone` 6종 → `data-tone`, `appearance`(비선택 룩)
15
15
  * outline|soft → `data-appearance`, 선택은 `.is-selected`. 어휘 밖 값은 기본값으로 정규화한다.
16
- * 기본 스타일에서 비제거형 `md` 높이는 28px, `sm` 및 제거 가능 칩은 24px이다.
16
+ * 기본 스타일에서 비제거형 높이는 sm 24px / md 28px / lg 32px, 제거형은 sm 24px / md·lg 32px이다.
17
+ * lg 는 Figma Large 1652:11056(사용자 결정 chip-large-api, 2026-11-03)이다.
17
18
  */
18
19
  export declare const CHIP_TONES: readonly ["accent", "neutral", "info", "success", "warning", "danger"];
19
20
  export type ChipTone = (typeof CHIP_TONES)[number];
20
21
  export declare const CHIP_APPEARANCES: readonly ["outline", "soft"];
21
22
  export type ChipAppearance = (typeof CHIP_APPEARANCES)[number];
22
- export declare const CHIP_SIZES: readonly ["sm", "md"];
23
+ export declare const CHIP_SIZES: readonly ["sm", "md", "lg"];
23
24
  export type ChipSize = (typeof CHIP_SIZES)[number];
24
25
  export interface ChipProps {
25
26
  /** 색 의미. 어휘 밖·미지정은 `accent` */
26
27
  tone?: ChipTone;
27
28
  /** 비선택 상태의 룩. 어휘 밖·미지정은 `outline` */
28
29
  appearance?: ChipAppearance;
29
- /** 크기 tier. 기본 스타일의 비제거형 높이는 sm 24px / md 28px, 제거형은 24px. 어휘 밖·미지정은 `md` */
30
+ /** 크기 tier. 기본 스타일의 비제거형 높이는 sm 24px / md 28px / lg 32px, 제거형은 sm 24px / md·lg 32px. 어휘 밖·미지정은 `md` */
30
31
  size?: ChipSize;
31
32
  /** 토글 칩의 선택 상태(제어형). removable 이면 무시 */
32
33
  selected?: boolean;
@@ -2,9 +2,10 @@ import { MozSpec } from '../../runtime/types';
2
2
  import { InputProps, InputEmits } from './input.core';
3
3
 
4
4
  export { createInput } from './input.core';
5
- export type { InputProps, InputEmits } from './input.core';
5
+ export type { InputProps, InputEmits, InputPrefixIconScope } from './input.core';
6
6
  export { iconInfo } from './icons';
7
7
  /**
8
- * v-model(modelValue) + validator. slot: invalidTooltip(v2 아이콘 커스터마이징).
8
+ * v-model(modelValue) + validator. slot: invalidTooltip(v2 아이콘 커스터마이징),
9
+ * prefixIcon(입력 왼쪽 장식 아이콘, scope `InputPrefixIconScope`).
9
10
  */
10
11
  export declare const INPUT_SPEC: MozSpec<InputProps, InputEmits, void>;
@@ -21,6 +21,12 @@ import { CoreCtx, CoreSetupResult } from '../../runtime/types';
21
21
  * - 토글 버튼: locale PasswordInput.showPassword/hidePassword aria-label + aria-pressed.
22
22
  * - 나머지(isReadOnly·rules·useInvalidV2·invalidTooltip·emit)는 Input 계약 그대로.
23
23
  * - PasswordInput 은 이 구현의 호환 래퍼(setupInput 의 legacyPassword 옵션)다.
24
+ *
25
+ * prefixIcon slot(VDP-021): 입력 왼쪽의 장식 아이콘(검색 돋보기 등). 콘텐츠는 소비자가 준다.
26
+ * - slot 이 있을 때만 장식 영역과 왼쪽 여백(has-prefix-icon)을 만든다. 같은 템플릿 안의 별도 part 라
27
+ * 추가·교체·제거해도 native input 은 다시 만들지 않는다(값·포커스·selection 유지).
28
+ * - 장식 전용: aria-hidden + inert 라 보조기술·탭 순서·클릭 대상에서 빠진다. input 의 이름을 대신하지 않는다.
29
+ * - scope `{ disabled, isReadOnly, invalid }` — invalid 는 오류 표시 기준(invalidMessage)과 같다.
24
30
  */
25
31
  export interface InputProps {
26
32
  /** Native input id; omitted values receive a stable instance id for the label. */
@@ -48,6 +54,13 @@ export interface InputEmits {
48
54
  mounted: [HTMLInputElement | null];
49
55
  'update:modelValue': [string];
50
56
  }
57
+ /** prefixIcon slot scope — 장식 아이콘이 Input 상태를 따라 그릴 때 쓴다. 색은 기본적으로 currentColor 로 상속된다. */
58
+ export interface InputPrefixIconScope {
59
+ disabled: boolean;
60
+ isReadOnly: boolean;
61
+ /** 오류 문구·아이콘이 표시되는 상태. disabled 로 바뀌어도 남은 오류는 지우지 않는다. */
62
+ invalid: boolean;
63
+ }
51
64
  export declare const INPUT_DEFAULTS: Partial<InputProps>;
52
65
  /** @internal PasswordInput 호환 래퍼 전용 옵션. */
53
66
  export interface InputSetupOptions {
@@ -1,3 +1,5 @@
1
+ import { Rule } from '../../validator/types';
2
+
1
3
  /**
2
4
  * NumberInput 코어 — NumberInput.vue 1:1 포팅.
3
5
  *
@@ -12,6 +14,11 @@ export interface NumberInputProps {
12
14
  name?: string;
13
15
  width?: string | number;
14
16
  required?: boolean;
17
+ requiredMessage?: string;
18
+ rules?: Rule[];
19
+ messagePosition?: 'outside' | 'inside';
20
+ useInvalidV2?: boolean;
21
+ isReadOnly?: boolean;
15
22
  step?: number;
16
23
  min?: number;
17
24
  max?: number;
@@ -87,6 +87,8 @@ export interface RadioProps {
87
87
  variant?: 'borderless' | 'boxed' | 'segment';
88
88
  /** segment 컨테이너 높이 tier — md 32px(기본) / sm 24px. 다른 variant 에서는 무시된다. */
89
89
  size?: 'md' | 'sm';
90
+ /** Segment width: hug preserves intrinsic sizing; fixed uses style.width; full fills available width with equal items. */
91
+ widthMode?: 'hug' | 'fixed' | 'full';
90
92
  /**
91
93
  * segment 전용 — 항목 텍스트를 그리지 않고 `aria-label` 로만 남긴다(아이콘 slot 과 함께 쓴다).
92
94
  * 배지 slot 도 그리지 않는다. 다른 variant 에서는 무시된다.
@@ -2,7 +2,7 @@ import { MozSpec } from '../../runtime/types';
2
2
  import { SelectProps, SelectEmits, SelectApi } from './select.core';
3
3
 
4
4
  export { createSelect } from './select.core';
5
- export type { SelectProps, SelectEmits, SelectApi, DisplayFormatter, SelectDisplayColumn } from './select.core';
5
+ export type { SelectProps, SelectEmits, SelectApi, DisplayFormatter, SelectDisplayColumn, SelectVariant, SelectSize } from './select.core';
6
6
  /**
7
7
  * Select — 단일 선택 드롭다운(가상 스크롤 + 필터 + 검증). 스타일은 select.css + label.css 를 import.
8
8
  * modelValue 는 v-model(controlled)/uncontrolled 이중 모드. useObjBinding=true 면 model 이 item 객체.
@@ -14,6 +14,10 @@ import { Rule, RuleEventTarget } from '../../validator/types';
14
14
  * - 키보드 접근성(icon Tab→list, list Tab wrap, row Tab scroll, Esc 닫기) 이식.
15
15
  */
16
16
  export type DisplayFormatter = (item: Record<string, unknown>) => string;
17
+ /** trigger 외형. `text` 는 선·고리 없이 글자와 화살표만 보인다(메뉴 외형은 같다). */
18
+ export type SelectVariant = 'default' | 'text';
19
+ /** trigger 높이. `medium` 32px(기존), `small` 24px. 메뉴 행 높이는 바꾸지 않는다. */
20
+ export type SelectSize = 'medium' | 'small';
17
21
  export interface SelectDisplayColumn {
18
22
  key: string;
19
23
  header?: string;
@@ -23,6 +27,10 @@ export interface SelectProps {
23
27
  itemsSource: readonly Record<string, unknown>[] | Record<string, unknown>[];
24
28
  label?: string | null;
25
29
  width?: string | number;
30
+ /** trigger 외형. `text` 는 테두리·focus 고리 없이 글자와 화살표만 표시한다. */
31
+ variant?: SelectVariant;
32
+ /** trigger 높이. `small` 은 24px, 기본 `medium` 은 32px. */
33
+ size?: SelectSize;
26
34
  required?: boolean;
27
35
  readonly?: boolean;
28
36
  disabled?: boolean;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Slider 코어 — Slider.vue 1:1 포팅.
3
3
  * 보존: v-model + change emit, mousedown 드래그(window mousemove/mouseup), 좌/우 화살표 step,
4
- * thumbPosition = ratio*(sliderWidth-18) (음수면 0). 언마운트 시 window 리스너 정리 보장(원본 누수 방지).
4
+ * thumbPosition = ratio*(sliderWidth-16) (음수면 0). 언마운트 시 window 리스너 정리 보장(원본 누수 방지).
5
5
  */
6
6
  export interface SliderProps {
7
7
  id?: string;
@@ -2,5 +2,5 @@ import { MozSpec } from '../../runtime/types';
2
2
  import { TextAreaProps, TextAreaEmits } from './textarea.core';
3
3
 
4
4
  export { createTextArea } from './textarea.core';
5
- export type { TextAreaProps, TextAreaEmits } from './textarea.core';
5
+ export type { TextAreaProps, TextAreaEmits, TextAreaVariant, TextAreaSuffixScope } from './textarea.core';
6
6
  export declare const TEXTAREA_SPEC: MozSpec<TextAreaProps, TextAreaEmits, void>;
@@ -5,7 +5,16 @@ import { Rule } from '../../validator/types';
5
5
  * 보존: maxLength 초과 시 silent truncation + char counter, invalid 메시지는 focus 무관 항상 표시,
6
6
  * width 는 number 일 때 pxToRem rem, immediatelyFocus, $attrs(rows/placeholder 등) → textarea.
7
7
  * emit 은 update:modelValue 뿐.
8
+ *
9
+ * `variant="pill"`·`suffix` 슬롯(VDP-018, Figma 87:5168)과 `variant="borderless"`(VDP-023)는 하위 호환
10
+ * 추가다 — 미지정이면 종전 DOM·외형.
8
11
  */
12
+ /** 외형 어휘. 어휘 밖 값은 `'default'` 로 본다. */
13
+ export type TextAreaVariant = 'default' | 'pill' | 'borderless';
14
+ /** `suffix` 슬롯 scope — 보조 액션(Button)의 disabled 에 연결한다. */
15
+ export interface TextAreaSuffixScope {
16
+ disabled: boolean;
17
+ }
9
18
  export interface TextAreaProps {
10
19
  id?: string;
11
20
  label?: string;
@@ -22,6 +31,18 @@ export interface TextAreaProps {
22
31
  * 한다 — 고정 `height` 를 유지하면 textarea 만 커지고 상자를 넘쳐 흐른다.
23
32
  */
24
33
  resize?: 'none' | 'vertical' | 'horizontal' | 'both';
34
+ /**
35
+ * 입력 상자 외형. `'pill'` 은 모서리 27px 상한의 캡슐형이며 높이는 바꾸지 않는다.
36
+ *
37
+ * 27px 은 한 줄 54px 캡슐의 절반이다 — 높이를 늘려도 큰 타원 모서리가 편집 영역을 먹지 않게
38
+ * 상한으로 둔다. 한 줄 캡슐은 소비자가 `height=54`·`rows=1` 을 함께 준다(기본 height 80 유지).
39
+ * 내용 기반 자동 높이·Enter 제출은 없다.
40
+ *
41
+ * `'borderless'` 는 바깥 판 안에 놓는 입력이다 — 상자의 선·포커스 고리·배경과 여백을 모든 상태에서
42
+ * 그리지 않으며, 글자·높이·resize·오류 문구·suffix 열은 기본과 같다. 포커스 표시는 바깥 판이
43
+ * `:focus-within` 으로 맡는다.
44
+ */
45
+ variant?: TextAreaVariant;
25
46
  immediatelyFocus?: boolean;
26
47
  requiredMessage?: string;
27
48
  modelValue?: string;
@@ -5,6 +5,6 @@ export { createTimePicker } from './timepicker.core';
5
5
  export type { TimePickerProps, TimePickerEmits } from './timepicker.core';
6
6
  /**
7
7
  * TimePicker — 마스크 입력 + 시/분 드롭다운(현재시각 푸터). 스타일: timepicker.css + label.css.
8
- * modelValue 'HH:mm' v-model. 드롭다운은 body 포털 + Overlay(고정 너비 160px).
8
+ * modelValue 'HH:mm' v-model. 드롭다운은 body 포털 + Overlay(고정 너비 180px; trigger 기본 160px).
9
9
  */
10
10
  export declare const TIMEPICKER_SPEC: MozSpec<TimePickerProps, TimePickerEmits, void>;
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * 보존 포인트(1:1):
5
5
  * - 마스크 입력(투명 텍스트 input + __:__ 오버레이 span). HH:MM 자동 콜론, 커서 관리.
6
- * - 드롭다운(시/분 컬럼 + 현재시각 푸터)은 body 포털 + Overlay(useDropdownPosition 1:1, listWidth 160px).
6
+ * - 드롭다운(시/분 컬럼 + 현재시각 푸터)은 body 포털 + Overlay(useDropdownPosition 1:1, listWidth 180px; trigger 기본 160px).
7
7
  * - blur 시 파싱/클램프(0~23시, 0~59분), 완전한 HH:MM 이면 타이핑 중에도 즉시 update:modelValue.
8
8
  * - 열릴 때 시/분 목록을 선택값 중앙으로 스크롤. modelValue 기본 '09:00'.
9
9
  */
@@ -2,7 +2,7 @@ import { MozSpec } from '../../runtime/types';
2
2
  import { TooltipProps, TooltipEmits, TooltipApi } from './tooltip.core';
3
3
 
4
4
  export { createTooltip } from './tooltip.core';
5
- export type { TooltipProps, TooltipEmits, TooltipApi } from './tooltip.core';
5
+ export type { TooltipProps, TooltipEmits, TooltipApi, TooltipAppearance } from './tooltip.core';
6
6
  export { computeTooltipPlacement } from './placement';
7
7
  export type { TooltipSide, TooltipAlign, TooltipRect, TooltipSize, TooltipPlacement, TooltipPlacementOptions, } from './placement';
8
8
  /**
@@ -1,4 +1,4 @@
1
- import { TooltipAlign, TooltipSide } from './placement';
1
+ import { OverlayRect, TooltipAlign, TooltipSide } from './placement';
2
2
 
3
3
  /**
4
4
  * Tooltip 코어 — 앵커에 붙는 설명 버블.
@@ -18,6 +18,8 @@ import { TooltipAlign, TooltipSide } from './placement';
18
18
  * 배치는 `placement.ts` 의 순수 함수가 계산한다(flip/shift/화살표 오프셋). 코어는 측정과
19
19
  * 재배치 트리거만 담당한다.
20
20
  */
21
+ /** 버블 외형. `rail` 은 어두운 Side Toolbar 레일용 고정 역할(VDP-044) */
22
+ export type TooltipAppearance = 'default' | 'rail';
21
23
  export interface TooltipProps {
22
24
  /** 열림 여부 — 지연·hover 판단은 래퍼 몫이고 코어는 결과만 받는다 */
23
25
  open?: boolean;
@@ -33,6 +35,16 @@ export interface TooltipProps {
33
35
  collisionPadding?: number;
34
36
  /** 화살표 렌더 여부 */
35
37
  arrow?: boolean;
38
+ /**
39
+ * 버블 외형. `'rail'` 은 Side Toolbar 레일의 고정 색·곡률(`--moz-color-rail-tooltip-*`, `--moz-radius-rail-tooltip`)로 칠한다.
40
+ * 생략·`'default'`·알 수 없는 값은 기존 외형.
41
+ */
42
+ appearance?: TooltipAppearance;
43
+ /**
44
+ * 주축 경계 기준 element(예: 레일 컨테이너). right/left 는 이 요소의 오른쪽/왼쪽 끝, top/bottom 은 위/아래 끝에서 sideOffset 만큼 띄운다.
45
+ * 교차축 정렬·화살표는 anchor(트리거) 기준. 생략·null·분리·무효 rect 면 anchor 로 대체한다.
46
+ */
47
+ sideAnchor?: HTMLElement | null;
36
48
  /** 버블 element id — 트리거의 `aria-describedby` 가 가리킬 값 */
37
49
  tooltipId?: string;
38
50
  class?: unknown;
@@ -47,4 +59,10 @@ export interface TooltipApi {
47
59
  /** 앵커가 움직였을 때 재측정 (스크롤·리사이즈는 코어가 알아서 건다) */
48
60
  reposition(): void;
49
61
  }
62
+ /**
63
+ * 주축은 sideAnchor 경계, 교차축은 trigger 인 합성 rect. 공유 배치 함수는 주축 위치·flip 판정에 주축 성분만,
64
+ * 교차축 정렬·clamp·화살표에 교차축 성분만 쓰므로 overlay 계산(Popover 공용)을 바꾸지 않고 의미를 나눈다.
65
+ * flip 은 같은 축 안에서만 일어나 선호 side 의 축 하나로 충분하다. 쓸 수 없는 sideAnchor 는 trigger 그대로.
66
+ */
67
+ export declare function resolveSideAnchorRect(trigger: OverlayRect, sideAnchor: HTMLElement | null | undefined, side: TooltipSide): OverlayRect;
50
68
  export declare const createTooltip: import('../..').CoreFactory<TooltipProps, TooltipEmits, TooltipApi>;