@vmscloud/moz-ui-components-core 0.1.42

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 (146) hide show
  1. package/dist/components/avatar/avatar.core.d.ts +39 -0
  2. package/dist/components/avatar/index.d.ts +14 -0
  3. package/dist/components/bread-crumb/breadcrumb.core.d.ts +70 -0
  4. package/dist/components/bread-crumb/icons.d.ts +9 -0
  5. package/dist/components/bread-crumb/index.d.ts +10 -0
  6. package/dist/components/button/button.core.d.ts +59 -0
  7. package/dist/components/button/circleLoader.d.ts +8 -0
  8. package/dist/components/button/index.d.ts +12 -0
  9. package/dist/components/calendar/calendar.core.d.ts +25 -0
  10. package/dist/components/calendar/icons.d.ts +7 -0
  11. package/dist/components/calendar/index.d.ts +7 -0
  12. package/dist/components/checkbox/checkbox.core.d.ts +46 -0
  13. package/dist/components/checkbox/icons.d.ts +9 -0
  14. package/dist/components/checkbox/index.d.ts +10 -0
  15. package/dist/components/collapsible/collapsible.core.d.ts +34 -0
  16. package/dist/components/collapsible/index.d.ts +15 -0
  17. package/dist/components/context-menu/contextmenu.core.d.ts +58 -0
  18. package/dist/components/context-menu/index.d.ts +10 -0
  19. package/dist/components/controller/controller.core.d.ts +44 -0
  20. package/dist/components/controller/icons.d.ts +12 -0
  21. package/dist/components/controller/index.d.ts +12 -0
  22. package/dist/components/date-input/dateinput.core.d.ts +32 -0
  23. package/dist/components/date-input/icons.d.ts +6 -0
  24. package/dist/components/date-input/index.d.ts +7 -0
  25. package/dist/components/empty-state/emptystate.core.d.ts +25 -0
  26. package/dist/components/empty-state/emptystate.types.d.ts +17 -0
  27. package/dist/components/empty-state/index.d.ts +8 -0
  28. package/dist/components/input/icons.d.ts +4 -0
  29. package/dist/components/input/index.d.ts +10 -0
  30. package/dist/components/input/input.core.d.ts +38 -0
  31. package/dist/components/label/index.d.ts +6 -0
  32. package/dist/components/label/label.core.d.ts +22 -0
  33. package/dist/components/multi-select/icons.d.ts +14 -0
  34. package/dist/components/multi-select/index.d.ts +10 -0
  35. package/dist/components/multi-select/multiselect.core.d.ts +60 -0
  36. package/dist/components/number-input/icons.d.ts +7 -0
  37. package/dist/components/number-input/index.d.ts +7 -0
  38. package/dist/components/number-input/numberinput.core.d.ts +30 -0
  39. package/dist/components/password-input/icons.d.ts +7 -0
  40. package/dist/components/password-input/index.d.ts +7 -0
  41. package/dist/components/password-input/passwordinput.core.d.ts +29 -0
  42. package/dist/components/popover/index.d.ts +14 -0
  43. package/dist/components/popover/popover.core.d.ts +65 -0
  44. package/dist/components/popup/icons.d.ts +18 -0
  45. package/dist/components/popup/index.d.ts +14 -0
  46. package/dist/components/popup/popup.core.d.ts +132 -0
  47. package/dist/components/radio/index.d.ts +9 -0
  48. package/dist/components/radio/radio.core.d.ts +35 -0
  49. package/dist/components/scroll-area/index.d.ts +16 -0
  50. package/dist/components/scroll-area/scrollarea.core.d.ts +47 -0
  51. package/dist/components/select/icons.d.ts +16 -0
  52. package/dist/components/select/index.d.ts +10 -0
  53. package/dist/components/select/select.core.d.ts +48 -0
  54. package/dist/components/slider/index.d.ts +6 -0
  55. package/dist/components/slider/slider.core.d.ts +23 -0
  56. package/dist/components/split-pane/index.d.ts +15 -0
  57. package/dist/components/split-pane/splitpane.core.d.ts +24 -0
  58. package/dist/components/tab/icons.d.ts +4 -0
  59. package/dist/components/tab/index.d.ts +10 -0
  60. package/dist/components/tab/tab.core.d.ts +28 -0
  61. package/dist/components/table-select/index.d.ts +10 -0
  62. package/dist/components/table-select/tableselect.core.d.ts +45 -0
  63. package/dist/components/tag-input/icons.d.ts +9 -0
  64. package/dist/components/tag-input/index.d.ts +12 -0
  65. package/dist/components/tag-input/taginput.core.d.ts +32 -0
  66. package/dist/components/textarea/index.d.ts +6 -0
  67. package/dist/components/textarea/textarea.core.d.ts +35 -0
  68. package/dist/components/time-picker/icons.d.ts +9 -0
  69. package/dist/components/time-picker/index.d.ts +10 -0
  70. package/dist/components/time-picker/timepicker.core.d.ts +26 -0
  71. package/dist/components/toast/icons.d.ts +12 -0
  72. package/dist/components/toast/index.d.ts +13 -0
  73. package/dist/components/toast/timer.d.ts +17 -0
  74. package/dist/components/toast/toast.core.d.ts +48 -0
  75. package/dist/components/toast/useToast.d.ts +13 -0
  76. package/dist/components/toggle/index.d.ts +9 -0
  77. package/dist/components/toggle/toggle.core.d.ts +54 -0
  78. package/dist/components/tooltip/index.d.ts +18 -0
  79. package/dist/components/tooltip/placement.d.ts +9 -0
  80. package/dist/components/tooltip/tooltip.core.d.ts +50 -0
  81. package/dist/components/tree-select/icons.d.ts +14 -0
  82. package/dist/components/tree-select/index.d.ts +12 -0
  83. package/dist/components/tree-select/tree-utils.d.ts +63 -0
  84. package/dist/components/tree-select/treeselect.core.d.ts +45 -0
  85. package/dist/index.cjs +1887 -0
  86. package/dist/index.cjs.map +1 -0
  87. package/dist/index.d.ts +51 -0
  88. package/dist/index.js +9233 -0
  89. package/dist/index.js.map +1 -0
  90. package/dist/locale/en.d.ts +3 -0
  91. package/dist/locale/index.d.ts +10 -0
  92. package/dist/locale/ja.d.ts +3 -0
  93. package/dist/locale/ko.d.ts +3 -0
  94. package/dist/locale/types.d.ts +482 -0
  95. package/dist/locale/zh.d.ts +3 -0
  96. package/dist/overlay/DismissStack.d.ts +49 -0
  97. package/dist/overlay/Overlay.d.ts +39 -0
  98. package/dist/overlay/PortalHost.d.ts +11 -0
  99. package/dist/overlay/index.d.ts +5 -0
  100. package/dist/overlay/placement.d.ts +74 -0
  101. package/dist/runtime/ChromeComponent.d.ts +38 -0
  102. package/dist/runtime/Observable.d.ts +18 -0
  103. package/dist/runtime/SlotHost.d.ts +48 -0
  104. package/dist/runtime/defineHeadless.d.ts +28 -0
  105. package/dist/runtime/spread.d.ts +26 -0
  106. package/dist/runtime/types.d.ts +149 -0
  107. package/dist/shared/cn.d.ts +8 -0
  108. package/dist/shared/dayjs.d.ts +10 -0
  109. package/dist/shared/index.d.ts +5 -0
  110. package/dist/shared/utils.d.ts +58 -0
  111. package/dist/styles/default/avatar.css +94 -0
  112. package/dist/styles/default/breadcrumb.css +120 -0
  113. package/dist/styles/default/button.css +220 -0
  114. package/dist/styles/default/calendar.css +158 -0
  115. package/dist/styles/default/checkbox.css +128 -0
  116. package/dist/styles/default/collapsible.css +27 -0
  117. package/dist/styles/default/contextmenu.css +212 -0
  118. package/dist/styles/default/controller.css +157 -0
  119. package/dist/styles/default/dateinput.css +193 -0
  120. package/dist/styles/default/emptystate.css +91 -0
  121. package/dist/styles/default/index.css +3877 -0
  122. package/dist/styles/default/input.css +179 -0
  123. package/dist/styles/default/label.css +65 -0
  124. package/dist/styles/default/multiselect.css +394 -0
  125. package/dist/styles/default/numberinput.css +174 -0
  126. package/dist/styles/default/passwordinput.css +189 -0
  127. package/dist/styles/default/popover.css +92 -0
  128. package/dist/styles/default/popup.css +222 -0
  129. package/dist/styles/default/radio.css +264 -0
  130. package/dist/styles/default/scrollarea.css +133 -0
  131. package/dist/styles/default/select.css +287 -0
  132. package/dist/styles/default/slider.css +123 -0
  133. package/dist/styles/default/splitpane.css +62 -0
  134. package/dist/styles/default/tab.css +172 -0
  135. package/dist/styles/default/tableselect.css +313 -0
  136. package/dist/styles/default/taginput.css +296 -0
  137. package/dist/styles/default/textarea.css +145 -0
  138. package/dist/styles/default/timepicker.css +221 -0
  139. package/dist/styles/default/toast.css +165 -0
  140. package/dist/styles/default/toggle.css +129 -0
  141. package/dist/styles/default/tooltip.css +131 -0
  142. package/dist/styles/default/treeselect.css +382 -0
  143. package/dist/validator/createValidator.d.ts +7 -0
  144. package/dist/validator/index.d.ts +2 -0
  145. package/dist/validator/types.d.ts +26 -0
  146. package/package.json +57 -0
@@ -0,0 +1,38 @@
1
+ import { nothing, TemplateResult } from 'lit-html';
2
+
3
+ /**
4
+ * ChromeComponent — vanilla 컴포넌트의 lit-html 렌더 기반.
5
+ *
6
+ * (moz-ui-grid-wrapper 의 동일 파일에서 패턴을 복사 — grid 패키지에는 의존하지 않는다.)
7
+ *
8
+ * lit-html 은 자체 반응성이 없으므로, 상태 변경 시 `render()` 를 다시 호출하는 단일 경로를
9
+ * 이 베이스가 표준화한다.
10
+ *
11
+ * - `template()` 서브클래스가 현재 상태 → 템플릿 반환
12
+ * - `requestUpdate()` microtask 에 1회로 배치 렌더 (고빈도 갱신 합치기)
13
+ * - `addCleanup()` 구독/리스너 등록 → destroy 시 일괄 해제
14
+ */
15
+ export declare abstract class ChromeComponent {
16
+ protected readonly container: HTMLElement;
17
+ private updateScheduled;
18
+ private mounted;
19
+ private cleanups;
20
+ constructor(container: HTMLElement);
21
+ /** 서브클래스 구현: 현재 상태로부터 lit-html 템플릿을 반환 */
22
+ protected abstract template(): TemplateResult | typeof nothing;
23
+ /** 최초 마운트 (즉시 1회 렌더) */
24
+ mount(): this;
25
+ /** 상태 변경 알림 → microtask 에 1회 렌더 (배치) */
26
+ requestUpdate(): void;
27
+ /** 즉시 동기 렌더 (테스트/긴급 갱신용) */
28
+ protected renderNow(): void;
29
+ /** 구독/리스너 등 정리 대상 등록 */
30
+ protected addCleanup(fn: () => void): void;
31
+ /** 서브클래스 라이프사이클 훅 */
32
+ protected onMount(): void;
33
+ protected onDestroy(): void;
34
+ /** 정리: 훅 → cleanup → lit-html 노드 제거 */
35
+ destroy(): void;
36
+ /** 마운트 상태 */
37
+ get isMounted(): boolean;
38
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Observable — 상태 변경 알림 베이스.
3
+ *
4
+ * (moz-ui-grid-wrapper 의 동일 파일에서 패턴을 복사 — grid 패키지에는 의존하지 않는다.)
5
+ *
6
+ * Vue composable 의 `ref` 반응성을 대체한다. 내부 상태를 바꾸면 `emit()` 하고,
7
+ * 컴포넌트(ChromeComponent)는 `subscribe()` 로 받아 `requestUpdate()` 를 호출한다.
8
+ */
9
+ export type Listener = () => void;
10
+ export declare class Observable {
11
+ private listeners;
12
+ /** 변경 구독 — 해제 함수 반환 */
13
+ subscribe(listener: Listener): () => void;
14
+ /** 구독자 전원에게 변경 알림 */
15
+ protected emit(): void;
16
+ /** 구독 정리 */
17
+ protected clearListeners(): void;
18
+ }
@@ -0,0 +1,48 @@
1
+ import { SlotRenderer } from './types';
2
+
3
+ /**
4
+ * SlotHost — 프레임워크 콘텐츠(slot/template) 주입 지점.
5
+ *
6
+ * (moz-ui-grid-wrapper 의 SlotHost 패턴을 복사하되, grid 전용 SlotName 유니온 대신 임의 문자열
7
+ * 이름을 쓰고, scoped-slot 갱신을 위해 "재마운트 없는 update" 를 지원하도록 확장했다.)
8
+ *
9
+ * - vanilla 코어는 slot 지점마다 빈 outlet(`<span data-moz-slot=name>`) 을 만들고 `fill(name, el, scope)` 호출.
10
+ * - Vue/React 래퍼는 소비자의 slot 콘텐츠를 `SlotRenderer` 로 감싸 `register()` 한다.
11
+ * - 같은 outlet 으로 재-fill 되면 재마운트 대신 `handle.update(scope)` 로 scope 만 갱신 → scoped-slot 반응.
12
+ * - 정리(dispose)는 handle 이 담당 → 메모리 누수 방지.
13
+ */
14
+ export declare class SlotHost {
15
+ private renderers;
16
+ /**
17
+ * 등록되지 않은 이름을 **호출 시점에** 조회하는 resolver. 동적 slot 이름(Tab 의 `${id}-tab`/
18
+ * `${id}` 처럼 데이터에서 파생되는 이름)은 마운트 때 확정할 수 없다 — 어댑터가 이 훅으로
19
+ * "지금 소비자가 그 이름의 콘텐츠를 갖고 있는가" 를 답한다.
20
+ */
21
+ private resolver;
22
+ setResolver(resolver: ((name: string) => SlotRenderer | undefined) | null): void;
23
+ private lookup;
24
+ private mounted;
25
+ /** 어댑터가 slot 콘텐츠 등록 (동일 이름은 덮어쓰기) */
26
+ register(name: string, renderer: SlotRenderer): void;
27
+ /** slot 등록 해제 (+ 이 이름으로 마운트된 인스턴스 전부 정리) */
28
+ unregister(name: string): void;
29
+ /** 해당 slot 에 등록된 렌더러가 있는지 */
30
+ has(name: string): boolean;
31
+ /**
32
+ * 코어가 outlet 지점에서 호출.
33
+ * @param instanceKey outlet 인스턴스 키(name#N) — 반복 slot 의 각 행을 구분.
34
+ * @param rendererName 렌더러 등록 이름.
35
+ * - 미마운트 → 렌더러 실행(마운트).
36
+ * - 같은 outlet 재호출 → `handle.update(scope)` (재마운트 없이 scope 갱신).
37
+ * - outlet element 가 바뀜 → 이전 인스턴스 dispose 후 재마운트.
38
+ */
39
+ fill(instanceKey: string, rendererName: string, el: HTMLElement, scope: unknown): boolean;
40
+ /** 특정 slot 인스턴스 정리 */
41
+ clear(instanceKey: string): void;
42
+ /** 모든 slot 인스턴스 정리 (등록 자체는 유지) */
43
+ clearAll(): void;
44
+ /** 전체 해제 (정리 + 등록 제거) */
45
+ destroy(): void;
46
+ /** 현재 마운트된 slot 인스턴스 수 (누수 검사용) */
47
+ get mountedCount(): number;
48
+ }
@@ -0,0 +1,28 @@
1
+ import { CoreCtx, CoreEmit, CoreFactory, CoreSetupResult } from './types';
2
+
3
+ export interface HeadlessDef<P extends object, E, API> {
4
+ name: string;
5
+ /** prop 기본값 (Vue defineProps default 1:1) */
6
+ defaults?: Partial<P>;
7
+ /**
8
+ * true 면 in-place 대신 body 에 붙인 portal 루트에 렌더 (Vue `<teleport to="body">` 대체).
9
+ * Popup/Toast/ContextMenu 처럼 전체가 body 로 텔레포트되는 컴포넌트용. slot outlet 스캔·
10
+ * onMounted·instance.el 모두 portal 루트를 기준으로 동작하고, 소비자 호스트(container)는 빈다.
11
+ */
12
+ portal?: boolean;
13
+ /** 현재 상태 → { render, api } */
14
+ setup: (ctx: CoreCtx<P, E>) => CoreSetupResult<API>;
15
+ }
16
+ /**
17
+ * defineHeadless — mount-함수 팩토리를 만드는 헤드리스 컴포넌트 정의.
18
+ *
19
+ * ChromeComponent(lit-html 렌더 베이스)를 상속해:
20
+ * - `template()` 은 setup 의 render() 를 호출
21
+ * - 렌더 후 `[data-moz-slot]` outlet 을 찾아 SlotHost.fill (scoped-slot 갱신 포함)
22
+ * - onCleanup 등록분 + slot 인스턴스를 destroy 시 일괄 정리
23
+ *
24
+ * 반환값은 모든 컴포넌트가 공유하는 단일 코어 계약 `CoreFactory`.
25
+ */
26
+ export declare function defineHeadless<P extends object, E, API = void>(def: HeadlessDef<P, E, API>): CoreFactory<P, E, API>;
27
+ /** 편의: 에러 없이 CoreEmit 타입을 좁히기 위한 no-op (트리셰이킹됨) */
28
+ export type { CoreEmit };
@@ -0,0 +1,26 @@
1
+ import { nothing, ElementPart } from 'lit-html';
2
+ import { Directive, PartInfo } from 'lit-html/directive.js';
3
+
4
+ /**
5
+ * spread — 임의 attribute/property/listener 묶음을 element 에 뿌리는 lit-html element-part 디렉티브.
6
+ *
7
+ * Vue `v-bind="$attrs"` / React rest-props 패스스루의 1:1 대체.
8
+ * `<button ${spread(rest)}>` 형태로 쓴다. (class/style/key/ref 는 템플릿에서 별도 처리하므로 제외)
9
+ *
10
+ * - `onXxx` (함수) → addEventListener('xxx', fn) (Vue/React 이벤트 관례)
11
+ * - `true` → 빈 attribute, `false`/`null`/`undefined` → attribute 제거
12
+ * - `aria-*` 는 예외: 열거형 문자열이라 boolean 도 `"true"`/`"false"` 로 쓴다
13
+ * - 그 외 → setAttribute(String(value))
14
+ * - 갱신 시 이전 렌더에서 사라진 키/리스너는 자동 제거 (stale 정리)
15
+ */
16
+ declare class SpreadDirective extends Directive {
17
+ private prevKeys;
18
+ private listeners;
19
+ constructor(partInfo: PartInfo);
20
+ render(_attrs?: Record<string, unknown>): typeof nothing;
21
+ update(part: ElementPart, [attrs]: [Record<string, unknown> | undefined]): symbol;
22
+ private isEventKey;
23
+ private eventName;
24
+ }
25
+ export declare const spread: (_attrs?: Record<string, unknown> | undefined) => import('lit-html/directive.js').DirectiveResult<typeof SpreadDirective>;
26
+ export {};
@@ -0,0 +1,149 @@
1
+ import { TemplateResult, nothing } from 'lit-html';
2
+ import { SlotHost } from './SlotHost';
3
+ import { MozLocaleMessages } from '../locale/types';
4
+ import { ValidatorContext } from '../validator/types';
5
+
6
+ /**
7
+ * 이벤트 맵: 이벤트명 → 인자 튜플. 예: `{ click: [MouseEvent] }`
8
+ * (제약이 아니라 문서용 별칭 — concrete 인터페이스도 그대로 쓸 수 있게 E 는 제약하지 않는다.)
9
+ */
10
+ export type EventMap = Record<string, any[]>;
11
+ /** 코어가 프레임워크로 이벤트를 올려보내는 함수 (Vue emit / React onXxx 로 매핑됨) */
12
+ export type CoreEmit<E> = <K extends keyof E>(name: K, ...args: E[K] extends any[] ? E[K] : never) => void;
13
+ /** slot 마운트 핸들 — 프레임워크 콘텐츠를 outlet 에 붙이고, scope 갱신/정리를 제공 */
14
+ export interface SlotHandle {
15
+ /** scope(scoped-slot props) 변경 시 재마운트 없이 갱신 */
16
+ update?(scope: unknown): void;
17
+ /** outlet 제거/정리 */
18
+ dispose(): void;
19
+ }
20
+ /**
21
+ * 어댑터(Vue/React 래퍼)가 등록하는 렌더러.
22
+ * outlet element 에 프레임워크 콘텐츠를 마운트하고 핸들을 반환한다.
23
+ */
24
+ export type SlotRenderer = (container: HTMLElement, scope: unknown) => SlotHandle;
25
+ /** 코어 setup 에 주입되는 컨텍스트 (mount-함수 팩토리의 심장) */
26
+ export interface CoreCtx<P, E> {
27
+ /** 라이브 props — update() 시 통째로 교체됨 */
28
+ readonly props: P;
29
+ /** 이벤트를 프레임워크로 올려보냄 */
30
+ emit: CoreEmit<E>;
31
+ /** slot 주입 호스트 */
32
+ slots: SlotHost;
33
+ /** 상태 변경 → microtask 배치 렌더 */
34
+ requestUpdate(): void;
35
+ /** destroy 시 실행될 정리 함수 등록 */
36
+ onCleanup(fn: () => void): void;
37
+ /** px → rem 변환 (moz-ui-components 관례 1:1) */
38
+ px(n: number): number;
39
+ /** 현재 로케일 메시지 (래퍼가 provide/inject·context 로 해석해 주입, 기본 koKR) */
40
+ readonly locale: MozLocaleMessages;
41
+ /** 부모 Validator 컨텍스트 (래퍼가 provide/inject·context 로 주입). 없으면 null(standalone). */
42
+ readonly validator: ValidatorContext | null;
43
+ /**
44
+ * slot outlet 을 렌더한다. 등록된 slot 이 있으면 placeholder 를 반환,
45
+ * 없으면 `nothing`(fallback 은 호출부가 처리).
46
+ */
47
+ slot(name: string, scope?: unknown): TemplateResult | typeof nothing;
48
+ /** 해당 prop 이 소비자에 의해 실제로 전달됐는지(controlled 판별) */
49
+ controlled(key: keyof P): boolean;
50
+ }
51
+ export interface CoreSetupResult<API> {
52
+ render(): TemplateResult | typeof nothing;
53
+ /**
54
+ * (선택) body 에 붙인 포털에 렌더할 보조 템플릿 — 드롭다운/오버레이용.
55
+ * 조상의 transform 이 만드는 fixed-containing-block 을 탈출하려면 트리거는 render() 에 in-place 로,
56
+ * 떠 있는 패널은 renderPortal() 로 분리한다(Vue `<teleport to="body">` 대체).
57
+ * nothing 을 반환하면 포털을 닫는다. render() 와 renderPortal() 의 slot outlet 은 모두 스캔된다.
58
+ */
59
+ renderPortal?: () => TemplateResult | typeof nothing;
60
+ /**
61
+ * (선택) renderPortal() 을 body 가 아닌 특정 소비자 element 아래로 텔레포트할 때의 타깃.
62
+ * Vue `<teleport to=".moz-contents-container">` 대체 — 반환 element 아래에 포털 래퍼(append,
63
+ * 기존 콘텐츠 보존)를 만들어 renderPortal() 을 렌더한다. null 을 반환하면 타깃 부재로 보고 포털을
64
+ * 열지 않는다(teleport v-if=false 1:1). 미정의면 기존대로 body 포털.
65
+ */
66
+ getPortalContainer?: () => Element | null;
67
+ api?: API;
68
+ /** 최초 마운트(첫 렌더) 직후 1회 호출 (el = 코어 루트 element). 예: 'mounted' 이벤트 emit. */
69
+ onMounted?: (el: HTMLElement | null) => void;
70
+ }
71
+ export interface CoreInstance<P, API> {
72
+ /**
73
+ * 코어가 그린 루트 element (focus 등 명령형 접근용).
74
+ *
75
+ * 매 접근마다 현재 루트를 읽는다 — 프레임워크 브릿지는 이 값을 그대로 `ref` 로
76
+ * 흘려보내므로, 스냅샷이면 소비자가 낡은 element 를 붙들게 된다.
77
+ */
78
+ readonly el: HTMLElement | null;
79
+ /**
80
+ * props 갱신 (재마운트 없음).
81
+ *
82
+ * 기본은 **병합** — 부분 갱신 호출자(예: date-input → calendar 의 `modelValue`)를 위해서다.
83
+ * `replace: true` 는 `next` 를 그대로 새 props 로 삼아 **이번에 빠진 키를 지운다**.
84
+ * 매 렌더 전체 prop 을 넘기는 프레임워크 브리지(React)는 이 모드를 써야 한다 — 그러지
85
+ * 않으면 소비처가 조건부로 뺀 prop(`aria-label` 등)이 DOM 에 영원히 남는다.
86
+ *
87
+ * `sync: true` 는 microtask 배치를 건너뛰고 **즉시 렌더**한다. 열림 상태가 prop 으로 오는
88
+ * 오버레이(Popover)는 이게 필요하다 — 소비처는 상태를 바꾼 그 커밋에서 패널이 존재한다고
89
+ * 기대하는데(Radix 가 그렇게 동작했다), 배치하면 한 틱 늦어 같은 틱의 조회가 실패한다.
90
+ */
91
+ update(next: Partial<P>, options?: {
92
+ replace?: boolean;
93
+ sync?: boolean;
94
+ }): void;
95
+ /** 정리 */
96
+ destroy(): void;
97
+ /** 로케일 메시지 갱신 (래퍼가 provide/inject·context 변경 시 호출) */
98
+ setLocale(messages: MozLocaleMessages): void;
99
+ /** 명령형 API (open/close/focus/setLoading 등) */
100
+ api: API;
101
+ }
102
+ export interface CoreFactoryOpts {
103
+ slots?: Record<string, SlotRenderer>;
104
+ /**
105
+ * 동적 slot 이름 조회. `slots` 에 없는 이름을 코어가 요청하면 이 훅이 답한다 — Tab 의
106
+ * `${id}-tab`/`${id}` 처럼 데이터에서 파생되는 이름은 마운트 때 확정할 수 없기 때문이다.
107
+ * 반환값이 undefined 면 코어는 fallback 을 그린다.
108
+ */
109
+ slotResolver?: (name: string) => SlotRenderer | undefined;
110
+ /** 초기 로케일 (래퍼가 마운트 시점의 로케일을 넘김 → 첫 렌더부터 정확) */
111
+ locale?: MozLocaleMessages;
112
+ /** 부모 Validator 컨텍스트 (있으면 Input 등이 등록). 없으면 standalone. */
113
+ validator?: ValidatorContext;
114
+ /**
115
+ * 소비자가 "실제로" 전달한 prop 키 목록 (controlled 판별용).
116
+ * 래퍼는 미설정 declared prop 도 undefined 로 넘기므로, 진짜 전달 여부는 이 채널로 받는다.
117
+ * (Vue: vnode.props 키 / React: props 키). 없으면 ctx.controlled 는 initialProps 키로 폴백.
118
+ */
119
+ providedKeys?: string[];
120
+ }
121
+ /** 모든 컴포넌트가 만족하는 단일 코어 계약 — mount-함수 팩토리 */
122
+ export type CoreFactory<P, E, API> = (container: HTMLElement, props: P, emit: CoreEmit<E>, opts?: CoreFactoryOpts) => CoreInstance<P, API>;
123
+ /** v-model(양방향) 바인딩 정의 */
124
+ export interface MozModelBinding {
125
+ /** 코어 props 로 들어갈 값 prop 이름 */
126
+ prop: string;
127
+ /** 이 값을 갱신하는 코어 emit 이벤트 이름 */
128
+ event: string;
129
+ }
130
+ /**
131
+ * 래퍼가 프레임워크 컴포넌트를 찍어내는 데 쓰는 공용 스펙.
132
+ * core 한 번 작성 → Vue/React 래퍼가 이 스펙으로 각각 1줄 정의.
133
+ */
134
+ export interface MozSpec<P, E, API = unknown> {
135
+ name: string;
136
+ core: CoreFactory<P, E, API>;
137
+ props: readonly string[];
138
+ emits: readonly (keyof E & string)[];
139
+ slots?: readonly string[];
140
+ /** vue: model 이름 → 바인딩. `update:<model>` 이 자동 생성됨 */
141
+ models?: Record<string, MozModelBinding>;
142
+ /** 코어 api 를 프레임워크 ref/expose 로 노출할지 */
143
+ expose?: boolean;
144
+ /**
145
+ * prop 갱신을 microtask 로 배치하지 않고 즉시 렌더한다. 열림 상태가 prop 으로 오는
146
+ * 오버레이처럼 "상태를 바꾼 그 틱에 DOM 이 있어야" 하는 컴포넌트만 켠다.
147
+ */
148
+ syncUpdate?: boolean;
149
+ }
@@ -0,0 +1,8 @@
1
+ import { ClassValue } from 'clsx';
2
+
3
+ /**
4
+ * 조건부 클래스 병합 유틸 (moz-ui-components 의 cn 1:1 복사).
5
+ * clsx 로 조건부/배열/객체 클래스를 하나의 문자열로 병합.
6
+ */
7
+ export declare function cn(...inputs: ClassValue[]): string;
8
+ export type { ClassValue };
@@ -0,0 +1,10 @@
1
+ import { default as dayjs, Dayjs } from 'dayjs';
2
+
3
+ declare const configuredDayjs: typeof dayjs;
4
+ declare const timezonedDayjs: {
5
+ (...args: any[]): dayjs.Dayjs;
6
+ unix: (value: number) => dayjs.Dayjs;
7
+ };
8
+ export default timezonedDayjs;
9
+ export { Dayjs };
10
+ export { configuredDayjs as dayjs };
@@ -0,0 +1,5 @@
1
+ export { cn } from './cn';
2
+ export type { ClassValue } from './cn';
3
+ export { generateUUID, pxToRem, uniqueId, shallowEqual, normalizeStyle, pickRest } from './utils';
4
+ export { dayjs } from './dayjs';
5
+ export type { Dayjs } from './dayjs';
@@ -0,0 +1,58 @@
1
+ /**
2
+ * moz-ui-components 의 shared/utils 에서 프레임워크 무관 부분을 1:1 복사.
3
+ */
4
+ /** UUID 생성 */
5
+ export declare function generateUUID(): string;
6
+ /** px 를 rem 으로 변환 */
7
+ export declare function pxToRem(px: number, base?: number): number;
8
+ export declare function uniqueId(prefix?: string): string;
9
+ /** 두 객체의 1차원 키-값 얕은 비교 */
10
+ export declare const shallowEqual: (object1: Record<string, any>, object2: Record<string, any>) => boolean;
11
+ /**
12
+ * 알려진 prop 키를 제외한 나머지(패스스루 대상: id/aria/data/on* 등)를 추린다.
13
+ * (class/style 은 known 에 포함시켜 템플릿에서 별도 처리)
14
+ */
15
+ export declare function pickRest(props: Record<string, unknown>, known: Set<string>): Record<string, unknown>;
16
+ /**
17
+ * rest 를 **ARIA** 와 나머지로 가른다.
18
+ *
19
+ * combobox 계열(select / multi-select / table-select / tree-select)은 값 표시용 `<input>` 이
20
+ * `readonly tabindex="-1"` 이라 접근성 트리에서 컨트롤이 아니다. 실제 컨트롤은 `role="combobox"`
21
+ * 인 아이콘 버튼이다. rest 를 통째로 표시용 input(또는 루트)에 뿌리면 소비자가 준
22
+ * `aria-describedby`·`aria-invalid`·`aria-label` 이 **아무에게도 읽히지 않는 노드**에 붙는다.
23
+ *
24
+ * 그래서 aria 만 갈라 트리거 버튼에 싣고 나머지(data 속성·title·name 등)는 종전 자리에 둔다.
25
+ * 코어가 상태로 소유하는 `aria-haspopup`/`aria-expanded`/`aria-controls` 는 이 spread 뒤에
26
+ * 리터럴로 다시 선언되므로 소비자가 덮어쓰지 못한다(그 셋은 코어가 정답을 안다).
27
+ */
28
+ export declare function splitAria(rest: Record<string, unknown>): {
29
+ aria: Record<string, unknown>;
30
+ dom: Record<string, unknown>;
31
+ };
32
+ /**
33
+ * style 값(string | 객체 | undefined)을 lit-html styleMap 이 받는 객체로 정규화.
34
+ * (프레임워크에서 $attrs.style / style prop 가 문자열/객체 어느 쪽으로 와도 처리)
35
+ */
36
+ export declare function normalizeStyle(style: unknown): Record<string, string>;
37
+ /**
38
+ * 가상 스크롤 폴백 — 레이아웃이 없는 환경에서 목록이 통째로 사라지는 것을 막는다.
39
+ *
40
+ * virtual-core 는 스크롤 컨테이너의 `getBoundingClientRect()` 로 가시 범위를 계산한다.
41
+ * jsdom 처럼 레이아웃 엔진이 없는 환경에서는 높이가 0 이라 **가시 행이 0개**가 되고,
42
+ * 목록이 비어 보인다. 그 경우에만 전체 항목을 순서대로 배치해 돌려준다(가상화 없이).
43
+ *
44
+ * ⚠️ 판별 신호는 "가시 행이 0" 이 아니라 **"컨테이너는 있는데 높이가 0"** 이다.
45
+ * 드롭다운의 첫 렌더에서는 ref 콜백이 아직 실행되지 않아 `scrollElement` 가 null 인데,
46
+ * 그것까지 폴백으로 보면 브라우저에서도 열 때마다 첫 프레임에 전체 항목을 그리게 된다 —
47
+ * 항목이 많을수록 비싸지므로, 가상화를 쓰는 이유 자체를 무너뜨린다. 컨테이너가 아직
48
+ * 없으면 폴백하지 않는다. ref 가 붙는 즉시 재렌더되어 정상 경로로 들어온다.
49
+ */
50
+ export declare function virtualRowsWithFallback(vItems: {
51
+ index: number;
52
+ size: number;
53
+ start: number;
54
+ }[], count: number, itemHeight: number, scrollElement: Element | null): {
55
+ index: number;
56
+ size: number;
57
+ start: number;
58
+ }[];
@@ -0,0 +1,94 @@
1
+ @charset "UTF-8";
2
+ /* moz color tokens — override in :root */
3
+ @layer moz {
4
+ :root {
5
+ /* ── 기본 팔레트 ── */
6
+ --moz-color-accent: #4568e0;
7
+ --moz-color-accent-strong: #3e5dc9;
8
+ --moz-color-accent-subtle: #e2e7fa;
9
+ --moz-color-danger: #dc5a5a;
10
+ --moz-color-warning: #fa9e23;
11
+ --moz-color-success: #357e63;
12
+ --moz-color-surface: #ffffff;
13
+ --moz-color-on-accent: #ffffff;
14
+ --moz-color-surface-subtle: #f4f4f9;
15
+ --moz-color-surface-muted: #f8f8fd;
16
+ --moz-color-border: #bac6d4;
17
+ --moz-color-border-subtle: #e1e3f0;
18
+ --moz-color-text: #28364e;
19
+ --moz-color-text-secondary: #6a7184;
20
+ --moz-color-text-subtle: #96a5be;
21
+ --moz-color-text-muted: #a7b1bc;
22
+ --moz-color-disabled: #e0e1ec;
23
+ /* 반전 표면 — 툴팁처럼 본문과 배경/전경이 뒤집힌 떠 있는 조각 */
24
+ --moz-color-inverse-surface: var(--moz-color-text);
25
+ --moz-color-inverse-text: var(--moz-color-surface);
26
+ /* ── 파생(알파) — 위 solid 토큰을 따라간다 ── */
27
+ --moz-color-accent-ring: color-mix(in srgb, var(--moz-color-accent) 20%, transparent);
28
+ --moz-color-accent-ring-strong: color-mix(in srgb, var(--moz-color-accent) 30%, transparent);
29
+ --moz-color-accent-soft: color-mix(in srgb, var(--moz-color-accent) 16%, transparent);
30
+ --moz-color-accent-ghost: color-mix(in srgb, var(--moz-color-accent) 9%, transparent);
31
+ --moz-color-danger-ring: color-mix(in srgb, var(--moz-color-danger) 20%, transparent);
32
+ --moz-color-danger-ghost: color-mix(in srgb, var(--moz-color-danger) 13%, transparent);
33
+ --moz-color-muted-soft: color-mix(in srgb, var(--moz-color-text-subtle) 16%, transparent);
34
+ /* ── 그림자·스크림 ── */
35
+ --moz-color-shadow: rgb(57 55 122 / 0.1);
36
+ --moz-color-shadow-weak: rgb(0 0 0 / 0.05);
37
+ --moz-color-scrim: rgb(0 0 0 / 0.3);
38
+ --moz-color-scrim-strong: rgb(66 72 83 / 0.5);
39
+ }
40
+ }
41
+ /* moz radius tokens — override in :root */
42
+ @layer moz {
43
+ :root {
44
+ /* 소형 마커 — 체크박스, 칩 내부 요소 */
45
+ --moz-radius-xs: 2px;
46
+ /* 컨트롤 박스 — 버튼·입력·셀렉트·탭·브레드크럼 (가장 많이 쓰이는 값) */
47
+ --moz-radius-control: 4px;
48
+ /* 보조 표면 — 캘린더 컨테이너, 슬라이더 트랙, 세그먼트 그룹 */
49
+ --moz-radius-surface: 6px;
50
+ /* 떠 있는 패널 — 팝업·대화상자 */
51
+ --moz-radius-panel: 10px;
52
+ /* 칩 — 태그 아이템처럼 컨트롤보다 작은 조각 (panel 과 기본값은 같지만 역할이 다르다:
53
+ 소비자가 panel 을 카드값으로 올려도 태그까지 알약이 되지 않도록 분리해 둔다) */
54
+ --moz-radius-chip: 10px;
55
+ /* 알약 — 토글, 토스트, 라디오 도트, 슬라이더 핸들 */
56
+ --moz-radius-pill: 999px;
57
+ /* 원 — 아바타 */
58
+ --moz-radius-circle: 50%;
59
+ }
60
+ }
61
+ /**
62
+ * Avatar 스타일 — 원형 표면 + 이미지 꽉 채우기 + 대체 표시 중앙 정렬.
63
+ *
64
+ * 크기는 소비처가 정한다(클래스든 인라인이든). 여기서 고정하는 것은 "이미지가 비율을
65
+ * 유지하며 잘려 들어간다" 와 "대체 표시가 가운데 온다" 두 가지뿐이다.
66
+ */
67
+ @layer moz {
68
+ .moz-avatar {
69
+ position: relative;
70
+ display: inline-flex;
71
+ flex-shrink: 0;
72
+ overflow: hidden;
73
+ border-radius: var(--moz-radius-pill);
74
+ user-select: none;
75
+ }
76
+ .moz-avatar-image {
77
+ width: 100%;
78
+ height: 100%;
79
+ aspect-ratio: 1/1;
80
+ object-fit: cover;
81
+ }
82
+ .moz-avatar-fallback {
83
+ display: flex;
84
+ width: 100%;
85
+ height: 100%;
86
+ align-items: center;
87
+ justify-content: center;
88
+ background-color: var(--moz-color-surface-muted);
89
+ color: var(--moz-color-text-secondary);
90
+ font-size: 0.75rem;
91
+ font-weight: 600;
92
+ line-height: 1;
93
+ }
94
+ }
@@ -0,0 +1,120 @@
1
+ @charset "UTF-8";
2
+ /* moz color tokens — override in :root */
3
+ @layer moz {
4
+ :root {
5
+ /* ── 기본 팔레트 ── */
6
+ --moz-color-accent: #4568e0;
7
+ --moz-color-accent-strong: #3e5dc9;
8
+ --moz-color-accent-subtle: #e2e7fa;
9
+ --moz-color-danger: #dc5a5a;
10
+ --moz-color-warning: #fa9e23;
11
+ --moz-color-success: #357e63;
12
+ --moz-color-surface: #ffffff;
13
+ --moz-color-on-accent: #ffffff;
14
+ --moz-color-surface-subtle: #f4f4f9;
15
+ --moz-color-surface-muted: #f8f8fd;
16
+ --moz-color-border: #bac6d4;
17
+ --moz-color-border-subtle: #e1e3f0;
18
+ --moz-color-text: #28364e;
19
+ --moz-color-text-secondary: #6a7184;
20
+ --moz-color-text-subtle: #96a5be;
21
+ --moz-color-text-muted: #a7b1bc;
22
+ --moz-color-disabled: #e0e1ec;
23
+ /* 반전 표면 — 툴팁처럼 본문과 배경/전경이 뒤집힌 떠 있는 조각 */
24
+ --moz-color-inverse-surface: var(--moz-color-text);
25
+ --moz-color-inverse-text: var(--moz-color-surface);
26
+ /* ── 파생(알파) — 위 solid 토큰을 따라간다 ── */
27
+ --moz-color-accent-ring: color-mix(in srgb, var(--moz-color-accent) 20%, transparent);
28
+ --moz-color-accent-ring-strong: color-mix(in srgb, var(--moz-color-accent) 30%, transparent);
29
+ --moz-color-accent-soft: color-mix(in srgb, var(--moz-color-accent) 16%, transparent);
30
+ --moz-color-accent-ghost: color-mix(in srgb, var(--moz-color-accent) 9%, transparent);
31
+ --moz-color-danger-ring: color-mix(in srgb, var(--moz-color-danger) 20%, transparent);
32
+ --moz-color-danger-ghost: color-mix(in srgb, var(--moz-color-danger) 13%, transparent);
33
+ --moz-color-muted-soft: color-mix(in srgb, var(--moz-color-text-subtle) 16%, transparent);
34
+ /* ── 그림자·스크림 ── */
35
+ --moz-color-shadow: rgb(57 55 122 / 0.1);
36
+ --moz-color-shadow-weak: rgb(0 0 0 / 0.05);
37
+ --moz-color-scrim: rgb(0 0 0 / 0.3);
38
+ --moz-color-scrim-strong: rgb(66 72 83 / 0.5);
39
+ }
40
+ }
41
+ /* moz radius tokens — override in :root */
42
+ @layer moz {
43
+ :root {
44
+ /* 소형 마커 — 체크박스, 칩 내부 요소 */
45
+ --moz-radius-xs: 2px;
46
+ /* 컨트롤 박스 — 버튼·입력·셀렉트·탭·브레드크럼 (가장 많이 쓰이는 값) */
47
+ --moz-radius-control: 4px;
48
+ /* 보조 표면 — 캘린더 컨테이너, 슬라이더 트랙, 세그먼트 그룹 */
49
+ --moz-radius-surface: 6px;
50
+ /* 떠 있는 패널 — 팝업·대화상자 */
51
+ --moz-radius-panel: 10px;
52
+ /* 칩 — 태그 아이템처럼 컨트롤보다 작은 조각 (panel 과 기본값은 같지만 역할이 다르다:
53
+ 소비자가 panel 을 카드값으로 올려도 태그까지 알약이 되지 않도록 분리해 둔다) */
54
+ --moz-radius-chip: 10px;
55
+ /* 알약 — 토글, 토스트, 라디오 도트, 슬라이더 핸들 */
56
+ --moz-radius-pill: 999px;
57
+ /* 원 — 아바타 */
58
+ --moz-radius-circle: 50%;
59
+ }
60
+ }
61
+ /**
62
+ * BreadCrumb 스타일 — BreadCrumb.vue 의 scoped SCSS 를 별도 파일로 분리 (1:1, 하드코딩 hex 유지).
63
+ */
64
+ @layer moz {
65
+ .moz-bread-crumb {
66
+ display: flex;
67
+ align-items: center;
68
+ gap: 7px;
69
+ user-select: none;
70
+ }
71
+ .moz-bread-crumb .menu-item {
72
+ height: inherit;
73
+ display: flex;
74
+ align-items: baseline;
75
+ justify-content: center;
76
+ font-size: 1rem;
77
+ line-height: normal;
78
+ font-weight: 500;
79
+ white-space: nowrap;
80
+ color: var(--moz-color-text-secondary);
81
+ }
82
+ .moz-bread-crumb .menu-item .current-item {
83
+ color: var(--moz-color-accent);
84
+ }
85
+ .moz-bread-crumb .menu-item .separator {
86
+ margin: 0 4px;
87
+ }
88
+ .moz-bread-crumb .moz-bread-crumb-list {
89
+ display: flex;
90
+ align-items: center;
91
+ gap: 0;
92
+ margin: 0;
93
+ padding: 0;
94
+ list-style: none;
95
+ min-width: 0;
96
+ }
97
+ .moz-bread-crumb .moz-bread-crumb-item {
98
+ display: inline-flex;
99
+ align-items: center;
100
+ min-width: 0;
101
+ }
102
+ .moz-bread-crumb .moz-bread-crumb-separator {
103
+ display: inline-flex;
104
+ align-items: center;
105
+ margin: 0 4px;
106
+ }
107
+ .moz-bread-crumb .favorite-icon {
108
+ display: flex;
109
+ cursor: pointer;
110
+ align-items: center;
111
+ justify-content: center;
112
+ border-radius: var(--moz-radius-control);
113
+ border: none;
114
+ background: transparent;
115
+ padding: 3px;
116
+ }
117
+ .moz-bread-crumb .favorite-icon:has(.empty):hover {
118
+ background-color: var(--moz-color-muted-soft);
119
+ }
120
+ }