@spfn/cms 0.1.0-alpha.65 → 0.1.0-alpha.66

package/README.md

@@ -406,9 +406,16 @@ const { t: tEn } = await getSection('home', 'en');
 
 ## Documentation
 
-- **[Label Auto-Sync Guide](./LABEL_SYNC_GUIDE.md)** - Detailed configuration guide
+### Getting Started
+- **[Label Auto-Sync Guide](./LABEL_SYNC_GUIDE.md)** - Detailed sync configuration and options
 - **[Examples](./examples/)** - Usage examples
 
+### Advanced Guides
+- **[Advanced Features](./ADVANCED_FEATURES.md)** - Breakpoints, value types, InitCms, Draft Mode
+- **[Locale Management](./LOCALE_GUIDE.md)** - Complete locale guide with 50+ languages
+- **[API Reference](./API_REFERENCE.md)** - Complete API documentation and repository functions
+- **[Draft & Versioning](./DRAFT_AND_VERSIONING.md)** - Draft system, version control, audit logs
+
 ## Architecture
 
 ```

package/dist/{actions-CwvmPG0e.d.ts → actions-BpTAYuBA.d.ts}

@@ -1,105 +1,4 @@
-/**
- * Locale Constants
- *
- * Server/Client 양쪽에서 사용 가능한 locale 관련 상수
- */
-/**
- * Locale 쿠키 키
- */
-declare const LOCALE_COOKIE_KEY = "spfn-locale";
-/**
- * 지원하는 Locale 타입 (Type-safe)
- */
-type SupportedLocale = 'ko' | 'ja' | 'zh' | 'zh-TW' | 'zh-HK' | 'hi' | 'th' | 'vi' | 'id' | 'ms' | 'en' | 'en-GB' | 'en-CA' | 'en-AU' | 'en-NZ' | 'es' | 'es-MX' | 'es-AR' | 'es-CO' | 'fr' | 'de' | 'it' | 'pt' | 'nl' | 'sv' | 'no' | 'da' | 'fi' | 'ru' | 'pl' | 'uk' | 'cs' | 'hu' | 'ro' | 'bg' | 'hr' | 'sr' | 'sk' | 'sl' | 'lt' | 'lv' | 'et' | 'el' | 'tr' | 'ar' | 'fa' | 'he' | 'sw';
-/**
- * 국가/지역 정보 타입
- */
-interface LocaleInfo {
-    /** Locale 코드 (ISO 639-1) */
-    locale: SupportedLocale;
-    /** 국가 코드 (ISO 3166-1 alpha-2) */
-    countryCode: string;
-    /** 국기 이모지 (HTML/React용) */
-    flag: string;
-    /** 전화번호 국가 코드 */
-    dialCode: string;
-    /** 네이티브 이름 (현지어) */
-    nativeName: string;
-    /** 영어 이름 */
-    englishName: string;
-    /** RTL (Right-to-Left) 여부 */
-    rtl?: boolean;
-    /** 통화 코드 (ISO 4217) */
-    currencyCode?: string;
-    /** 날짜 형식 예시 */
-    dateFormat?: string;
-}
-/**
- * 사전 정의된 Locale 정보 맵
- *
- * 주요 언어/국가 정보를 포함합니다.
- * 프로젝트에 맞게 추가/수정 가능합니다.
- */
-declare const LOCALE_INFO_MAP: Record<SupportedLocale, LocaleInfo>;
-/**
- * Locale 정보 가져오기
- *
- * @param locale - Locale 코드 (예: 'ko', 'en', 'ja')
- * @returns LocaleInfo 또는 undefined
- *
- * @example
- * ```typescript
- * const koInfo = getLocaleInfo('ko');
- * console.log(koInfo.flag); // 🇰🇷
- * console.log(koInfo.dialCode); // +82
- * ```
- */
-declare function getLocaleInfo(locale: string): LocaleInfo | undefined;
-/**
- * 지원하는 모든 Locale 목록 가져오기
- *
- * @returns Locale 코드 배열
- */
-declare function getSupportedLocales(): SupportedLocale[];
-/**
- * 국기 이모지만 가져오기
- *
- * @param locale - Locale 코드
- * @returns 국기 이모지 또는 빈 문자열
- *
- * @example
- * ```typescript
- * getFlag('ko'); // 🇰🇷
- * getFlag('en'); // 🇺🇸
- * ```
- */
-declare function getFlag(locale: string): string;
-/**
- * 전화번호 국가 코드 가져오기
- *
- * @param locale - Locale 코드
- * @returns 전화번호 코드 또는 빈 문자열
- *
- * @example
- * ```typescript
- * getDialCode('ko'); // +82
- * getDialCode('en'); // +1
- * ```
- */
-declare function getDialCode(locale: string): string;
-/**
- * RTL (Right-to-Left) 여부 확인
- *
- * @param locale - Locale 코드
- * @returns RTL 여부
- *
- * @example
- * ```typescript
- * isRTL('ar'); // true (Arabic)
- * isRTL('ko'); // false (Korean)
- * ```
- */
-declare function isRTL(locale: string): boolean;
+import { e as LocaleInfo } from './locale.constants-BMBK70YM.js';
 
 /**
  * 현재 locale 가져오기 (Server Action)
@@ -293,4 +192,4 @@ declare function getLocaleWithInfo(): Promise<{
  */
 declare function getLocalesWithInfo(): Promise<LocaleInfo[]>;
 
-export { LOCALE_COOKIE_KEY as L, type SupportedLocale as S, getSupportedLocales as a, getFlag as b, getDialCode as c, LOCALE_INFO_MAP as d, type LocaleInfo as e, getLocale as f, getLocaleInfo as g, getLocales as h, isRTL as i, getLocaleWithInfo as j, getLocalesWithInfo as k, setLocale as s };
+export { getLocales as a, getLocaleWithInfo as b, getLocalesWithInfo as c, getLocale as g, setLocale as s };

package/dist/actions.d.ts

@@ -1 +1,2 @@
-export { L as LOCALE_COOKIE_KEY, f as getLocale, h as getLocales, s as setLocale } from './actions-CwvmPG0e.js';
+export { g as getLocale, a as getLocales, s as setLocale } from './actions-BpTAYuBA.js';
+export { L as LOCALE_COOKIE_KEY } from './locale.constants-BMBK70YM.js';

package/dist/client.d.ts

@@ -1,6 +1,7 @@
 import { SectionData, SectionAPI } from './server.js';
 import * as zustand from 'zustand';
-export { L as LOCALE_COOKIE_KEY, d as LOCALE_INFO_MAP, e as LocaleInfo, S as SupportedLocale, c as getDialCode, b as getFlag, f as getLocale, g as getLocaleInfo, j as getLocaleWithInfo, h as getLocales, k as getLocalesWithInfo, a as getSupportedLocales, i as isRTL, s as setLocale } from './actions-CwvmPG0e.js';
+export { g as getLocale, b as getLocaleWithInfo, a as getLocales, c as getLocalesWithInfo, s as setLocale } from './actions-BpTAYuBA.js';
+export { L as LOCALE_COOKIE_KEY, d as LOCALE_INFO_MAP, e as LocaleInfo, S as SupportedLocale, c as getDialCode, b as getFlag, g as getLocaleInfo, a as getSupportedLocales, i as isRTL } from './locale.constants-BMBK70YM.js';
 import './index-Dh5FjWzR.js';
 import './server/repositories/index.js';
 import './server/entities/cms-labels.js';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { L as LOCALE_COOKIE_KEY, d as LOCALE_INFO_MAP, e as LocaleInfo, S as SupportedLocale, c as getDialCode, b as getFlag, g as getLocaleInfo, a as getSupportedLocales, i as isRTL } from './actions-CwvmPG0e.js';
+export { L as LOCALE_COOKIE_KEY, d as LOCALE_INFO_MAP, e as LocaleInfo, S as SupportedLocale, c as getDialCode, b as getFlag, g as getLocaleInfo, a as getSupportedLocales, i as isRTL } from './locale.constants-BMBK70YM.js';
 export { SectionAPI, SectionData } from './server.js';
 export { F as FlatLabel, a as LabelDefinition, L as LabelType, N as NestedLabels, S as SectionDefinition, b as SyncOptions, c as SyncResult } from './index-Dh5FjWzR.js';
 import './server/repositories/index.js';

package/dist/locale.constants-BMBK70YM.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Locale Constants
+ *
+ * Server/Client 양쪽에서 사용 가능한 locale 관련 상수
+ */
+/**
+ * Locale 쿠키 키
+ */
+declare const LOCALE_COOKIE_KEY = "spfn-locale";
+/**
+ * 지원하는 Locale 타입 (Type-safe)
+ */
+type SupportedLocale = 'ko' | 'ja' | 'zh' | 'zh-TW' | 'zh-HK' | 'hi' | 'th' | 'vi' | 'id' | 'ms' | 'en' | 'en-GB' | 'en-CA' | 'en-AU' | 'en-NZ' | 'es' | 'es-MX' | 'es-AR' | 'es-CO' | 'fr' | 'de' | 'it' | 'pt' | 'nl' | 'sv' | 'no' | 'da' | 'fi' | 'ru' | 'pl' | 'uk' | 'cs' | 'hu' | 'ro' | 'bg' | 'hr' | 'sr' | 'sk' | 'sl' | 'lt' | 'lv' | 'et' | 'el' | 'tr' | 'ar' | 'fa' | 'he' | 'sw';
+/**
+ * 국가/지역 정보 타입
+ */
+interface LocaleInfo {
+    /** Locale 코드 (ISO 639-1) */
+    locale: SupportedLocale;
+    /** 국가 코드 (ISO 3166-1 alpha-2) */
+    countryCode: string;
+    /** 국기 이모지 (HTML/React용) */
+    flag: string;
+    /** 전화번호 국가 코드 */
+    dialCode: string;
+    /** 네이티브 이름 (현지어) */
+    nativeName: string;
+    /** 영어 이름 */
+    englishName: string;
+    /** RTL (Right-to-Left) 여부 */
+    rtl?: boolean;
+    /** 통화 코드 (ISO 4217) */
+    currencyCode?: string;
+    /** 날짜 형식 예시 */
+    dateFormat?: string;
+}
+/**
+ * 사전 정의된 Locale 정보 맵
+ *
+ * 주요 언어/국가 정보를 포함합니다.
+ * 프로젝트에 맞게 추가/수정 가능합니다.
+ */
+declare const LOCALE_INFO_MAP: Record<SupportedLocale, LocaleInfo>;
+/**
+ * Locale 정보 가져오기
+ *
+ * @param locale - Locale 코드 (예: 'ko', 'en', 'ja')
+ * @returns LocaleInfo 또는 undefined
+ *
+ * @example
+ * ```typescript
+ * const koInfo = getLocaleInfo('ko');
+ * console.log(koInfo.flag); // 🇰🇷
+ * console.log(koInfo.dialCode); // +82
+ * ```
+ */
+declare function getLocaleInfo(locale: string): LocaleInfo | undefined;
+/**
+ * 지원하는 모든 Locale 목록 가져오기
+ *
+ * @returns Locale 코드 배열
+ */
+declare function getSupportedLocales(): SupportedLocale[];
+/**
+ * 국기 이모지만 가져오기
+ *
+ * @param locale - Locale 코드
+ * @returns 국기 이모지 또는 빈 문자열
+ *
+ * @example
+ * ```typescript
+ * getFlag('ko'); // 🇰🇷
+ * getFlag('en'); // 🇺🇸
+ * ```
+ */
+declare function getFlag(locale: string): string;
+/**
+ * 전화번호 국가 코드 가져오기
+ *
+ * @param locale - Locale 코드
+ * @returns 전화번호 코드 또는 빈 문자열
+ *
+ * @example
+ * ```typescript
+ * getDialCode('ko'); // +82
+ * getDialCode('en'); // +1
+ * ```
+ */
+declare function getDialCode(locale: string): string;
+/**
+ * RTL (Right-to-Left) 여부 확인
+ *
+ * @param locale - Locale 코드
+ * @returns RTL 여부
+ *
+ * @example
+ * ```typescript
+ * isRTL('ar'); // true (Arabic)
+ * isRTL('ko'); // false (Korean)
+ * ```
+ */
+declare function isRTL(locale: string): boolean;
+
+export { LOCALE_COOKIE_KEY as L, type SupportedLocale as S, getSupportedLocales as a, getFlag as b, getDialCode as c, LOCALE_INFO_MAP as d, type LocaleInfo as e, getLocaleInfo as g, isRTL as i };

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-export { L as LOCALE_COOKIE_KEY, d as LOCALE_INFO_MAP, e as LocaleInfo, S as SupportedLocale, c as getDialCode, b as getFlag, f as getLocale, g as getLocaleInfo, j as getLocaleWithInfo, h as getLocales, k as getLocalesWithInfo, a as getSupportedLocales, i as isRTL, s as setLocale } from './actions-CwvmPG0e.js';
+export { L as LOCALE_COOKIE_KEY, d as LOCALE_INFO_MAP, e as LocaleInfo, S as SupportedLocale, c as getDialCode, b as getFlag, g as getLocaleInfo, a as getSupportedLocales, i as isRTL } from './locale.constants-BMBK70YM.js';
 import { S as SectionDefinition, b as SyncOptions, c as SyncResult } from './index-Dh5FjWzR.js';
 export { e as extractLabels, f as flattenLabels } from './index-Dh5FjWzR.js';
 export { cmsDraftCacheRepository, cmsLabelValuesRepository, cmsLabelsRepository, cmsPublishedCacheRepository } from './server/repositories/index.js';
@@ -12,14 +12,6 @@ export { c as createLabelSyncGenerator } from './label-sync-generator-B0EmvtWM.j
 import 'drizzle-orm/pg-core';
 import '@spfn/core/codegen';
 
-/**
- * Locale 유효성 검사
- *
- * @param locale - 검사할 locale
- * @returns 지원 여부
- */
-declare function isValidLocale(locale: string): Promise<boolean>;
-
 /**
  * CMS Sync Utilities
  *
@@ -175,4 +167,4 @@ declare const getSection: (section: string, locale?: string) => Promise<SectionA
  */
 declare const getSections: (sections: string[], locale?: string) => Promise<Record<string, SectionAPI>>;
 
-export { type SectionAPI, type SectionData, getSection, getSections, initLabelSync, isValidLocale, loadLabelsFromJson, syncAll, syncSection };
+export { type SectionAPI, type SectionData, getSection, getSections, initLabelSync, loadLabelsFromJson, syncAll, syncSection };