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

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 (38) hide show
  1. package/LICENSE-lucide.txt +43 -0
  2. package/dist/components/code-block/code-block.core.d.ts +39 -0
  3. package/dist/components/code-block/code-syntax.d.ts +24 -0
  4. package/dist/components/code-block/index.d.ts +13 -0
  5. package/dist/components/disclosure/disclosure.core.d.ts +37 -0
  6. package/dist/components/disclosure/index.d.ts +12 -0
  7. package/dist/components/gauge-display/gauge-display.core.d.ts +73 -0
  8. package/dist/components/gauge-display/index.d.ts +12 -0
  9. package/dist/components/icon/icon.core.d.ts +62 -0
  10. package/dist/components/icon/index.d.ts +10 -0
  11. package/dist/components/icon/lucide.generated.d.ts +869 -0
  12. package/dist/components/icon-button/icon-button.core.d.ts +50 -0
  13. package/dist/components/icon-button/index.d.ts +11 -0
  14. package/dist/components/link/index.d.ts +11 -0
  15. package/dist/components/link/link.core.d.ts +31 -0
  16. package/dist/components/metric-card/index.d.ts +11 -0
  17. package/dist/components/metric-card/metric-card.core.d.ts +36 -0
  18. package/dist/components/popup/index.d.ts +1 -0
  19. package/dist/components/popup/popup.core.d.ts +14 -0
  20. package/dist/components/spinner/index.d.ts +10 -0
  21. package/dist/components/spinner/spinner.core.d.ts +33 -0
  22. package/dist/index.cjs +1002 -928
  23. package/dist/index.cjs.map +1 -1
  24. package/dist/index.d.ts +8 -0
  25. package/dist/index.js +4546 -3758
  26. package/dist/index.js.map +1 -1
  27. package/dist/locale/types.d.ts +18 -0
  28. package/dist/styles/default/codeblock.css +402 -0
  29. package/dist/styles/default/disclosure.css +360 -0
  30. package/dist/styles/default/gaugedisplay.css +370 -0
  31. package/dist/styles/default/iconbutton.css +371 -0
  32. package/dist/styles/default/index.css +376 -2
  33. package/dist/styles/default/link.css +332 -0
  34. package/dist/styles/default/metriccard.css +356 -0
  35. package/dist/styles/default/numberinput.css +1 -1
  36. package/dist/styles/default/popup.css +1 -1
  37. package/dist/styles/default/spinner.css +348 -0
  38. package/package.json +5 -2
@@ -0,0 +1,50 @@
1
+ import { IconName } from '../icon/icon.core';
2
+ import { TooltipSide } from '../tooltip/placement';
3
+
4
+ /**
5
+ * IconButton 코어 — 글자 없이 공용 아이콘 하나만 보이는 버튼(ITSM-2026-004955, SW IconButton 기준).
6
+ *
7
+ * 새 버튼을 만들지 않는다. 실제 `<button>` 은 Button 의 `buttonTemplate`(type `icon`)이 그리므로
8
+ * nativeType 기본 `button`·disabled/loading 클릭 차단·aria-busy·제어형 pressed·raw ARIA 패스스루가
9
+ * Button 과 같다. 버블은 Tooltip 코어 인스턴스 하나를 이 버튼을 앵커로 붙여 재사용한다
10
+ * (래퍼가 트리거 ref 를 넘기지 않으므로 React 브릿지 handle 이 앵커로 새는 문제가 없다).
11
+ *
12
+ * - `label` 이 접근 이름(aria-label)이자 툴팁 문구다. 아이콘 SVG 는 장식(aria-hidden)이다.
13
+ * - 마우스 진입·키보드 포커스에서 열고, 이탈·blur·누름·Escape 에서 닫는다. 누름·Escape 로 닫은 뒤에는
14
+ * 포인터와 포커스가 모두 떠날 때까지 다시 열지 않는다(클릭 직후 포커스로 다시 뜨지 않게).
15
+ * - 열린 동안 버튼의 `aria-describedby` 가 버블 id 를 가리키고, 버블은 label 과 `shortcut` 의 `<kbd>` 를
16
+ * 싣는다. shortcut 은 표시만 하며 키 처리는 소비처 몫이다.
17
+ * - 동시에 하나만 연다(다른 IconButton 툴팁은 닫는다).
18
+ */
19
+ export type IconButtonSize = 'md' | 'sm';
20
+ export declare const ICON_BUTTON_SIZES: readonly ["md", "sm"];
21
+ export interface IconButtonProps {
22
+ /** 공용 아이콘 이름. 목록에 없으면 버튼만 그리고 아이콘은 비운다. */
23
+ icon: IconName;
24
+ /** 접근 이름이자 툴팁 문구. 아이콘 버튼은 글자가 없어서 필수다. */
25
+ label: string;
26
+ /** md 32px, sm 28px(`--moz-icon-btn-size(-sm)`). 기본 md. 알 수 없는 값은 md. */
27
+ size?: IconButtonSize;
28
+ /** 툴팁에 흐리게 덧붙일 단축키 표시(`<kbd>`). 키 처리는 소비처 몫이다. */
29
+ shortcut?: string;
30
+ /** 툴팁 방향. 기본 top, 공간이 없으면 반대쪽으로 뒤집힌다. */
31
+ tooltipPlacement?: TooltipSide;
32
+ /** 툴팁 버블에 더할 class. */
33
+ tooltipClassName?: string;
34
+ /** native HTML `button[type]`. 기본 `'button'`(폼 미제출) — 제출은 `'submit'` 을 명시한다. */
35
+ nativeType?: 'button' | 'submit' | 'reset';
36
+ /** 로딩 표시. 켜져 있으면 클릭을 막고 aria-busy="true". */
37
+ loading?: boolean;
38
+ /** 사용자 조작 비활성화. */
39
+ disabled?: boolean;
40
+ /** 지속 선택(토글) 상태. 소비자가 제어하며 aria-pressed 로 출력된다(Button 과 같음). */
41
+ pressed?: boolean;
42
+ /** 패스스루 (Vue $attrs / React className·style·rest) — 버튼 루트에 붙는다 */
43
+ class?: unknown;
44
+ style?: unknown;
45
+ [attr: string]: unknown;
46
+ }
47
+ export interface IconButtonEmits {
48
+ click: [MouseEvent];
49
+ }
50
+ export declare const createIconButton: import('../..').CoreFactory<IconButtonProps, IconButtonEmits, void>;
@@ -0,0 +1,11 @@
1
+ import { MozSpec } from '../../runtime/types';
2
+ import { IconButtonProps, IconButtonEmits } from './icon-button.core';
3
+
4
+ export { createIconButton, ICON_BUTTON_SIZES } from './icon-button.core';
5
+ export type { IconButtonProps, IconButtonEmits, IconButtonSize } from './icon-button.core';
6
+ /**
7
+ * ICON_BUTTON_SPEC — Vue/React 래퍼가 각각 1줄로 IconButton 을 찍어내는 공용 스펙.
8
+ * (스타일: `@vmscloud/moz-ui-components-core/styles/default/button.css` + `iconbutton.css` + `tooltip.css`,
9
+ * 또는 기본 테마 배럴 `styles/default`)
10
+ */
11
+ export declare const ICON_BUTTON_SPEC: MozSpec<IconButtonProps, IconButtonEmits>;
@@ -0,0 +1,11 @@
1
+ import { MozSpec } from '../../runtime/types';
2
+ import { LinkProps, LinkEmits } from './link.core';
3
+
4
+ export { createLink, LINK_CLASS } from './link.core';
5
+ export type { LinkProps, LinkEmits } from './link.core';
6
+ /**
7
+ * LINK_SPEC — Core 단독 소비자가 마운트하는 Link 스펙.
8
+ * React(`forwardRef` → HTMLAnchorElement)·Vue(루트 `$el` = HTMLAnchorElement) 는 `<a>` 를 직접 그리는 전용 `Link` 를 쓴다.
9
+ * (스타일: `styles/default/button.css` + `link.css`, 또는 기본 테마 배럴 `styles/default`)
10
+ */
11
+ export declare const LINK_SPEC: MozSpec<LinkProps, LinkEmits, void>;
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Link 코어 — 버튼 외형의 실제 링크(ITSM-2026-004955, SW `Link` 기준).
3
+ *
4
+ * 렌더 대상은 `<a>` 다. 주소 이동·새 탭·다운로드·브라우저 링크 메뉴·수정키 클릭(Ctrl/⌘/Shift/가운데)은
5
+ * 브라우저 기본 동작 그대로이며 코어는 클릭을 가로채거나 `preventDefault` 하지 않는다. 소비처 클릭
6
+ * 핸들러(`onClick` 등)는 앵커에 그대로 붙고, 소비처가 `preventDefault` 하면 그대로 취소된다.
7
+ *
8
+ * 외형은 Button 기본(contained) 클래스 `moz-button moz-default-button` 을 재사용하고 `moz-link` 를 더한다.
9
+ * React·Vue 는 브릿지 호스트 없이 같은 클래스로 `<a>` 를 직접 그리는 전용 `Link` 를 쓴다(ref 가 실제 앵커).
10
+ */
11
+ export interface LinkProps {
12
+ /** 이동할 주소. 없으면 브라우저 기준 placeholder 링크(포커스 불가)다. */
13
+ href?: string;
14
+ /** 열 대상(`_blank` 등). 새 탭이면 `rel="noopener noreferrer"` 를 함께 주는 것을 권장한다. */
15
+ target?: string;
16
+ /** 링크 관계(`noopener noreferrer` 등). */
17
+ rel?: string;
18
+ /** 내려받기 파일 이름. 빈 문자열이면 이름 없이 내려받기다. */
19
+ download?: string | boolean;
20
+ /** 표시 텍스트. 기본 slot 이 있으면 slot 이 우선한다. */
21
+ text?: string;
22
+ /** 패스스루 — 앵커에 붙는다(aria-*·data-*·onClick 등) */
23
+ class?: unknown;
24
+ style?: unknown;
25
+ [attr: string]: unknown;
26
+ }
27
+ export interface LinkEmits {
28
+ }
29
+ /** 앵커에 붙는 외형 클래스 — React·Vue 래퍼도 같은 값을 쓴다. */
30
+ export declare const LINK_CLASS = "moz-button moz-default-button moz-link";
31
+ export declare const createLink: import('../..').CoreFactory<LinkProps, LinkEmits, void>;
@@ -0,0 +1,11 @@
1
+ import { MozSpec } from '../../runtime/types';
2
+ import { MetricCardProps, MetricCardEmits } from './metric-card.core';
3
+
4
+ export { createMetricCard, hasMetricContent } from './metric-card.core';
5
+ export type { MetricCardProps, MetricCardEmits, MetricCardAlign } from './metric-card.core';
6
+ /**
7
+ * METRIC_CARD_SPEC — Core 단독 소비자가 마운트하는 MetricCard 스펙(`title`·`value`·`unit`·`footer` slot).
8
+ * React(노드 props·`valueRef`)·Vue(이름 slot·노출 `valueEl`)는 같은 DOM 을 직접 그리는 전용 `MetricCard` 를 쓴다.
9
+ * (스타일: `styles/default/metriccard.css`, 또는 기본 테마 배럴 `styles/default`)
10
+ */
11
+ export declare const METRIC_CARD_SPEC: MozSpec<MetricCardProps, MetricCardEmits, void>;
@@ -0,0 +1,36 @@
1
+ /**
2
+ * MetricCard 코어 — 계산된 지표 한 개(제목·값·단위·하단)를 보여 주는 표시 골격(ITSM-2026-004955, SW `MetricCard` 기준).
3
+ *
4
+ * 데이터 계산·형식·상태 판정(로딩·실패 문구, 목표 대비 등)은 소비자 몫이다. 소비자가 만든 값을 그대로 그린다.
5
+ * DOM: `div.moz-metric-card > label.moz-metric-card__title + strong.moz-metric-card__value(+ small.moz-metric-card__unit) + 하단`.
6
+ * - 값 `0` 도 그린다. 단위가 비면 `small` 을 그리지 않는다(값을 오류 문구로 바꾸면 지난 단위가 사라진다).
7
+ * - `footer` 는 값과 무관하게 유지되며 루트의 직계 자식으로 온다(소비자 `.카드 > small` 같은 배치 훅). Core 문자열 footer 는
8
+ * `small.moz-metric-card__footer`, React·Vue 노드는 감싸지 않고 그대로 그린다. `valueAlign`·`titleAlign` 은 각 줄의 text-align 이다.
9
+ * React 는 노드 props 와 `valueRef`(값 strong), Vue 는 이름 slot 과 노출 `valueEl` 로 값 요소에 닿는 전용 래퍼를 쓴다.
10
+ */
11
+ export type MetricCardAlign = 'left' | 'center' | 'right' | 'start' | 'end';
12
+ export interface MetricCardProps {
13
+ /** 제목. `title` slot 이 있으면 slot 이 우선한다. */
14
+ title?: string;
15
+ /** 표시 값(소비자가 형식화한 문자열·숫자, 0 포함). `value` slot 이 우선한다. */
16
+ value?: string | number;
17
+ /** 값 뒤 작은 단위. 비면 그리지 않는다. `unit` slot 이 우선한다. */
18
+ unit?: string;
19
+ /** 카드 하단 내용(목표·기준 시각 등). `footer` slot 이 우선한다. */
20
+ footer?: string;
21
+ /** 값 요소(strong)에 더할 class(상태 색 등은 소비자가 정한다). */
22
+ valueClass?: string;
23
+ /** 값 줄 정렬. 기본 left. */
24
+ valueAlign?: MetricCardAlign;
25
+ /** 제목 줄 정렬. 기본 left. */
26
+ titleAlign?: MetricCardAlign;
27
+ /** 패스스루 — 루트 div 에 붙는다 */
28
+ class?: unknown;
29
+ style?: unknown;
30
+ [attr: string]: unknown;
31
+ }
32
+ export interface MetricCardEmits {
33
+ }
34
+ /** 값이 "있음" — null·undefined·빈 문자열·false 만 비어 있다(0 은 값이다). */
35
+ export declare function hasMetricContent(value: unknown): boolean;
36
+ export declare const createMetricCard: import('../..').CoreFactory<MetricCardProps, MetricCardEmits, void>;
@@ -7,6 +7,7 @@ export type { PopupProps, PopupEmits, PopupApi, PopupPreset, DialogIcon, PopupSi
7
7
  * Popup — body portal 로 렌더되는 모달. 스타일은 popup.css + button.css 를 소비자가 import.
8
8
  * visible/width/height 는 v-model(controlled)/uncontrolled 이중 모드. title/default/footer 슬롯 지원.
9
9
  * focusTrap/lockScroll/side/showBackdrop 은 opt-in 접근성·드로어 확장(mozart-cloud #890) — 기본값은 종전 동작.
10
+ * fitViewport/returnFocusTo/`[data-autofocus]` 는 SW `Modal` 대응(ITSM-2026-004955) — 별도 Modal 부품 없이 Popup 으로 표현한다.
10
11
  * description slot 은 제목 아래 설명 문단이며 값이 있을 때만 aria-describedby 로 연결된다(issue 892).
11
12
  * React 에서는 `description={문자열|노드}` 가 그대로 이 slot 을 채운다(브릿지 정적 slot 경로).
12
13
  * ESC 닫힘은 공용 dismiss 스택이 관리한다 — 가장 위에 열린 레이어 하나만 닫힌다(#892).
@@ -115,6 +115,20 @@ export interface PopupProps {
115
115
  * 중첩되면 안쪽이 바깥 창까지 가리고, 닫히면 자기가 가린 것만 되돌린다.
116
116
  */
117
117
  hideOthers?: boolean;
118
+ /**
119
+ * 화면 맞춤 모달(SW `Modal` 대응, ITSM-2026-004955). 기본 false.
120
+ *
121
+ * 켜면 창을 CSS 로 화면 중앙(`left/top 50%` + `translate(-50%, -50%)`)에 고정하고 크기를
122
+ * `min(minWidth·maxWidth·minHeight·maxHeight 값, 100dvw 또는 100dvh - 32px)` 로 제한한다 — 창 크기가 바뀌어도 코어가 위치를 다시 계산하지 않고
123
+ * 화면 밖으로 밀리지 않는다. 드래그와 리사이즈 손잡이는 끈다(`draggable`·`resizeable` 무시). 본문은 기존대로
124
+ * 창 안에서 스크롤한다. 드로어(`side`)·`autoPosition=false` 가 있으면 그쪽이 우선한다.
125
+ */
126
+ fitViewport?: boolean;
127
+ /**
128
+ * `focusTrap` 창이 닫히거나 언마운트될 때 포커스를 돌려줄 요소(ITSM-2026-004955). 생략하면 열기 직전
129
+ * 포커스 요소로 돌아간다(기존 동작). 연 메뉴 항목이 닫힘과 함께 사라지는 경우 메뉴 트리거 등을 준다.
130
+ */
131
+ returnFocusTo?: HTMLElement | null;
118
132
  [attr: string]: unknown;
119
133
  }
120
134
  export interface PopupEmits {
@@ -0,0 +1,10 @@
1
+ import { MozSpec } from '../../runtime/types';
2
+ import { SpinnerProps, SpinnerEmits } from './spinner.core';
3
+
4
+ export { createSpinner, spinnerSize, spinnerLabel, SPINNER_DEFAULT_SIZE } from './spinner.core';
5
+ export type { SpinnerProps, SpinnerEmits } from './spinner.core';
6
+ /**
7
+ * SPINNER_SPEC — 독립 진행 표시. React·Vue 는 공용 브릿지 1줄로 찍는다.
8
+ * (스타일: `@vmscloud/moz-ui-components-core/styles/default/spinner.css`, 또는 기본 테마 배럴 `styles/default`)
9
+ */
10
+ export declare const SPINNER_SPEC: MozSpec<SpinnerProps, SpinnerEmits, void>;
@@ -0,0 +1,33 @@
1
+ import { MozLocaleMessages } from '../../locale/types';
2
+
3
+ /**
4
+ * Spinner 코어 — 독립 진행 표시(ITSM-2026-004955, SW `moz-sw/src/core/spinner` 기준).
5
+ *
6
+ * 버튼 안 로딩은 Button `loading` 이 맡는다(실제 버튼 비활성·aria-busy). Spinner 는 영역·목록·패널이
7
+ * 불러오는 중임을 알리는 독립 표시다.
8
+ *
9
+ * - 루트는 `role="status"`·`aria-live="polite"`·`aria-atomic="true"` 이고 접근 이름은 `label`,
10
+ * 없으면 로케일 `Spinner.label`(기본 4개 언어)이다. 사전에 키가 없으면 한국어 기본값을 쓴다.
11
+ * - 도형 SVG 는 장식(aria-hidden·포커스 제외)이다. 색은 `currentColor`(기본 강조색)다.
12
+ * - `size` 는 양수 px. 0·음수·NaN·Infinity 는 20px 로 대체한다. `--moz-spinner-size` 로 싣는다.
13
+ * - 회전 한 바퀴는 `--moz-dur-spin`(기본 900ms, SW 800ms 와 다름)이고 모션 줄이기에서는 멈춘다(CSS).
14
+ */
15
+ export interface SpinnerProps {
16
+ /** 지름(px). 양수만 받고 그 밖의 값은 20 으로 대체한다. 기본 20. */
17
+ size?: number;
18
+ /** 접근 이름. 생략하면 로케일 문구(ko 불러오는 중 · en Loading · ja 読み込み中 · zh 加载中). */
19
+ label?: string;
20
+ /** 패스스루 (Vue $attrs / React className·style·rest) — 루트 span 에 붙는다 */
21
+ class?: unknown;
22
+ style?: unknown;
23
+ [attr: string]: unknown;
24
+ }
25
+ export interface SpinnerEmits {
26
+ }
27
+ /** 기본 지름(px) */
28
+ export declare const SPINNER_DEFAULT_SIZE = 20;
29
+ /** 양수 유한수만 크기로 인정한다. */
30
+ export declare function spinnerSize(size: unknown): number;
31
+ /** label 이 비어 있으면 로케일 문구, 사전에 없으면 한국어 기본값. */
32
+ export declare function spinnerLabel(label: unknown, locale?: Partial<MozLocaleMessages> | null): string;
33
+ export declare const createSpinner: import('../..').CoreFactory<SpinnerProps, SpinnerEmits, void>;