@loafacto/ui 0.1.2 → 0.2.0

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.
@@ -20,12 +20,24 @@ export interface ThemeConfig {
20
20
  /** 스킨 식별자. CSS 에서 `[style*="--admin-ui-skin"]` 분기용 훅으로만 쓴다. */
21
21
  skin?: string;
22
22
  }
23
+ export declare const DARK_THEME: ThemeConfig;
24
+ /**
25
+ * 라이트 팔레트.
26
+ *
27
+ * 강조색을 다크의 #60a5fa 보다 진한 #2563eb 로 쓴다. 밝은 배경 위에서 연한 파랑은
28
+ * 대비가 4.5:1 을 못 넘겨 버튼 글자가 읽히지 않는다.
29
+ * 나머지(텍스트·경계·상태색)는 deriveSemanticPalette 가 배경 밝기를 보고 알아서 뒤집는다.
30
+ */
31
+ export declare const LIGHT_THEME: ThemeConfig;
32
+ /** 하위 호환용 별칭. 예전 코드가 이 이름으로 참조한다. */
23
33
  export declare const DEFAULT_THEME: ThemeConfig;
24
34
  /**
25
35
  * 테마를 CSS 변수로 문서 루트에 적용한다.
26
36
  *
27
37
  * CSS 변수를 쓰는 이유는 이 값들이 라이브러리 경계를 넘어가야 하기 때문이다.
28
- * 플랫폼 셸이 한 번 적용하면 같은 문서 안의 모든 서비스 화면이 —
29
- * 리모트로 붙든 iframe 이든 — 같은 색을 본다. JS 로 전파할 필요가 없다.
38
+ * 플랫폼 셸이 한 번 적용하면 같은 문서 안의 모든 서비스 화면이 같은 색을 본다.
39
+ *
40
+ * 보통은 직접 부르지 않고 useTheme()/initTheme() 을 쓴다. 백엔드에서 받은 색을
41
+ * 그대로 밀어 넣는 것처럼 모드와 무관한 적용이 필요할 때만 직접 호출한다.
30
42
  */
31
43
  export declare function applyTheme(config?: Partial<ThemeConfig>): SemanticPalette;
@@ -0,0 +1,26 @@
1
+ import { type ThemeConfig } from './applyTheme';
2
+ export type ThemeMode = 'light' | 'dark';
3
+ /**
4
+ * 앱 부팅 시 1회. createApp 보다 먼저 부른다 — CSS 변수만 세팅하는 동기 함수라
5
+ * 첫 페인트 전에 끝나고, 그래야 다른 테마가 잠깐 비쳤다가 바뀌는 일이 없다.
6
+ *
7
+ * 저장된 선택이 있으면 그걸 쓰고, 없으면 OS 설정을 따른다.
8
+ */
9
+ export declare function initTheme(options?: {
10
+ light?: ThemeConfig;
11
+ dark?: ThemeConfig;
12
+ }): void;
13
+ /**
14
+ * 테마 상태와 조작.
15
+ *
16
+ * const { mode, toggle } = useTheme()
17
+ */
18
+ export declare function useTheme(): {
19
+ mode: Readonly<import("vue").Ref<ThemeMode, ThemeMode>>;
20
+ /** 사용자가 직접 고른 상태인지. false 면 OS 설정을 따라가는 중이다. */
21
+ isExplicit: Readonly<import("vue").Ref<boolean, boolean>>;
22
+ setMode: (next: ThemeMode) => void;
23
+ toggle: () => void;
24
+ /** 저장된 선택을 지우고 다시 OS 설정을 따르게 한다. */
25
+ followSystem(): void;
26
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@loafacto/ui",
3
- "version": "0.1.2",
3
+ "version": "0.2.0",
4
4
  "description": "Loafacto 공용 UI — 테마(시맨틱 팔레트 파생), 애플리케이션 셸, 공통 오버레이 컴포넌트",
5
5
  "type": "module",
6
6
  "files": [