@spfn/cms 0.1.0-alpha.5 → 0.1.0-alpha.60

package/dist/actions.d.ts

@@ -1,9 +1,143 @@
 /**
- * @spfn/cms/actions
+ * 현재 locale 가져오기 (Server Action)
  *
- * Server Actions
- * 서버/클라이언트 컴포넌트 양쪽에서 사용 가능한 Server Actions
+ * 서버/클라이언트 컴포넌트 모두에서 사용 가능
+ *
+ * 우선순위:
+ * 1. 쿠키 (사용자가 명시적으로 선택한 언어)
+ * 2. 브라우저 언어 감지 (설정에서 활성화된 경우)
+ * 3. 시스템 기본 언어 (CMS 설정)
+ *
+ * @returns 현재 locale (예: 'ko', 'en')
+ *
+ * @example
+ * ```tsx
+ * // Server Component
+ * import { getLocale } from '@spfn/cms';
+ *
+ * export default async function Page()
+ * {
+ *     const locale = await getLocale();
+ *     return <div>Current locale: {locale}</div>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Client Component
+ * 'use client';
+ * import { getLocale } from '@spfn/cms/client';
+ *
+ * export default function LanguageSwitcher()
+ * {
+ *     const [locale, setLocale] = useState('');
+ *
+ *     useEffect(() => {
+ *         getLocale().then(setLocale);
+ *     }, []);
+ *
+ *     return <div>Current locale: {locale}</div>;
+ * }
+ * ```
+ */
+declare function getLocale(): Promise<string>;
+/**
+ * Locale 설정하기 (Server Action)
+ *
+ * 서버/클라이언트 컴포넌트 모두에서 사용 가능
+ * 쿠키에 locale을 저장합니다.
+ *
+ * @param locale - 설정할 locale (예: 'ko', 'en')
+ * @throws {Error} 지원하지 않는 locale인 경우
+ *
+ * @example
+ * ```tsx
+ * // Server Component (Server Action)
+ * import { setLocale } from '@spfn/cms';
+ *
+ * export default async function Page()
+ * {
+ *     await setLocale('en');
+ *     return <div>Locale changed</div>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Client Component (Server Action)
+ * 'use client';
+ * import { setLocale } from '@spfn/cms/client';
+ *
+ * export default function LanguageSwitcher()
+ * {
+ *     const handleChange = async (newLocale: string) =>
+ *     {
+ *         await setLocale(newLocale);
+ *         window.location.reload(); // 페이지 새로고침
+ *     };
+ *
+ *     return (
+ *         <button onClick={() => handleChange('en')}>
+ *             Switch to English
+ *         </button>
+ *     );
+ * }
+ * ```
+ */
+declare function setLocale(locale: string): Promise<void>;
+/**
+ * 지원하는 locale 목록 가져오기 (Server Action)
+ *
+ * 서버/클라이언트 컴포넌트 모두에서 사용 가능
+ *
+ * @returns 지원하는 locale 배열 (예: ['ko', 'en', 'ja'])
+ *
+ * @example
+ * ```tsx
+ * // Server Component
+ * import { getLocales } from '@spfn/cms';
+ *
+ * export default async function Page()
+ * {
+ *     const locales = await getLocales();
+ *     return <div>Supported: {locales.join(', ')}</div>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Client Component
+ * 'use client';
+ * import { getLocales } from '@spfn/cms/client';
+ *
+ * export default function LanguageSwitcher()
+ * {
+ *     const [locales, setLocales] = useState<string[]>([]);
+ *
+ *     useEffect(() => {
+ *         getLocales().then(setLocales);
+ *     }, []);
+ *
+ *     return (
+ *         <div>
+ *             {locales.map(locale => (
+ *                 <button key={locale}>{locale}</button>
+ *             ))}
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+declare function getLocales(): Promise<string[]>;
+
+/**
+ * Locale Constants
+ *
+ * Server/Client 양쪽에서 사용 가능한 locale 관련 상수
+ */
+/**
+ * Locale 쿠키 키
  */
-export { getLocale, setLocale, getLocales, } from './helpers/locale.actions.js';
-export { LOCALE_COOKIE_KEY } from './helpers/locale.constants.js';
-//# sourceMappingURL=actions.d.ts.map
+declare const LOCALE_COOKIE_KEY = "spfn-locale";
+
+export { LOCALE_COOKIE_KEY, getLocale, getLocales, setLocale };

package/dist/actions.js

@@ -1,11 +1,98 @@
-/**
- * @spfn/cms/actions
- *
- * Server Actions
- * 서버/클라이언트 컴포넌트 양쪽에서 사용 가능한 Server Actions
- */
-// Locale Server Actions
-export { getLocale, setLocale, getLocales, } from './helpers/locale.actions.js';
-// Locale Constants
-export { LOCALE_COOKIE_KEY } from './helpers/locale.constants.js';
+// src/helpers/locale.actions.ts
+import { cookies, headers } from "next/headers.js";
+
+// src/cms.config.ts
+function getEnvVar(key, defaultValue) {
+  return process.env[key] || defaultValue;
+}
+function getEnvBoolean(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  return value === "true" || value === "1";
+}
+function loadConfigFromEnv() {
+  const defaultLocale = getEnvVar("SPFN_CMS_DEFAULT_LOCALE", "en");
+  const supportedLocalesStr = getEnvVar("SPFN_CMS_SUPPORTED_LOCALES", "en,ko");
+  const detectBrowserLanguage2 = getEnvBoolean("SPFN_CMS_DETECT_BROWSER_LANGUAGE", true);
+  const supportedLocales = supportedLocalesStr.split(",").map((locale) => locale.trim()).filter((locale) => locale.length > 0);
+  if (!supportedLocales.includes(defaultLocale)) {
+    supportedLocales.unshift(defaultLocale);
+  }
+  return {
+    defaultLocale,
+    supportedLocales,
+    detectBrowserLanguage: detectBrowserLanguage2
+  };
+}
+var currentConfig = loadConfigFromEnv();
+function getCmsConfig() {
+  return currentConfig;
+}
+
+// src/helpers/locale.constants.ts
+var LOCALE_COOKIE_KEY = "spfn-locale";
+
+// src/helpers/locale.actions.ts
+async function detectBrowserLanguage() {
+  try {
+    const headersList = await headers();
+    const acceptLanguage = headersList.get("accept-language");
+    if (!acceptLanguage) {
+      return null;
+    }
+    const languages = acceptLanguage.split(",").map((lang) => {
+      const [code] = lang.split(";");
+      return code.split("-")[0].trim();
+    });
+    const config = getCmsConfig();
+    for (const lang of languages) {
+      if (config.supportedLocales.includes(lang)) {
+        return lang;
+      }
+    }
+    return null;
+  } catch (error) {
+    return null;
+  }
+}
+async function getLocale() {
+  const config = getCmsConfig();
+  const cookieStore = await cookies();
+  const cookieLocale = cookieStore.get(LOCALE_COOKIE_KEY)?.value;
+  if (cookieLocale && config.supportedLocales.includes(cookieLocale)) {
+    return cookieLocale;
+  }
+  if (config.detectBrowserLanguage) {
+    const browserLang = await detectBrowserLanguage();
+    if (browserLang) {
+      return browserLang;
+    }
+  }
+  return config.defaultLocale;
+}
+async function setLocale(locale) {
+  const config = getCmsConfig();
+  if (!config.supportedLocales.includes(locale)) {
+    throw new Error(
+      `Unsupported locale: ${locale}. Supported locales: ${config.supportedLocales.join(", ")}`
+    );
+  }
+  const cookieStore = await cookies();
+  cookieStore.set(LOCALE_COOKIE_KEY, locale, {
+    path: "/",
+    maxAge: 60 * 60 * 24 * 365,
+    // 1년
+    sameSite: "lax"
+  });
+}
+async function getLocales() {
+  const config = getCmsConfig();
+  return config.supportedLocales;
+}
+export {
+  LOCALE_COOKIE_KEY,
+  getLocale,
+  getLocales,
+  setLocale
+};
 //# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAwB;AACxB,OAAO,EACH,SAAS,EACT,SAAS,EACT,UAAU,GACb,MAAM,6BAA6B,CAAC;AAErC,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"sources":["../src/helpers/locale.actions.ts","../src/cms.config.ts","../src/helpers/locale.constants.ts"],"sourcesContent":["\"use server\";\n\n/**\n * Locale Management Server Actions\n *\n * Server Actions으로 구현된 locale 관리 함수\n * - 서버 컴포넌트: 일반 함수 호출로 동작\n * - 클라이언트 컴포넌트: Server Action으로 자동 처리\n */\n\nimport { cookies, headers } from 'next/headers.js';\nimport { getCmsConfig } from '../cms.config.js';\nimport { LOCALE_COOKIE_KEY } from './locale.constants.js';\n\n/**\n * 브라우저 언어 감지\n *\n * Accept-Language 헤더에서 지원하는 언어를 찾습니다.\n *\n * @returns 감지된 언어 코드 또는 null\n */\nasync function detectBrowserLanguage(): Promise<string | null>\n{\n    try\n    {\n        const headersList = await headers();\n        const acceptLanguage = headersList.get('accept-language');\n\n        if (!acceptLanguage)\n        {\n            return null;\n        }\n\n        // \"ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7\" 형식 파싱\n        const languages = acceptLanguage\n            .split(',')\n            .map(lang =>\n            {\n                const [code] = lang.split(';');\n                return code.split('-')[0].trim();\n            });\n\n        const config = getCmsConfig();\n\n        // 지원하는 언어 중 첫 번째 매칭되는 언어 반환\n        for (const lang of languages)\n        {\n            if (config.supportedLocales.includes(lang))\n            {\n                return lang;\n            }\n        }\n\n        return null;\n    }\n    catch (error)\n    {\n        // 헤더 접근 실패 시\n        return null;\n    }\n}\n\n/**\n * 현재 locale 가져오기 (Server Action)\n *\n * 서버/클라이언트 컴포넌트 모두에서 사용 가능\n *\n * 우선순위:\n * 1. 쿠키 (사용자가 명시적으로 선택한 언어)\n * 2. 브라우저 언어 감지 (설정에서 활성화된 경우)\n * 3. 시스템 기본 언어 (CMS 설정)\n *\n * @returns 현재 locale (예: 'ko', 'en')\n *\n * @example\n * ```tsx\n * // Server Component\n * import { getLocale } from '@spfn/cms';\n *\n * export default async function Page()\n * {\n *     const locale = await getLocale();\n *     return <div>Current locale: {locale}</div>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Client Component\n * 'use client';\n * import { getLocale } from '@spfn/cms/client';\n *\n * export default function LanguageSwitcher()\n * {\n *     const [locale, setLocale] = useState('');\n *\n *     useEffect(() => {\n *         getLocale().then(setLocale);\n *     }, []);\n *\n *     return <div>Current locale: {locale}</div>;\n * }\n * ```\n */\nexport async function getLocale(): Promise<string>\n{\n    const config = getCmsConfig();\n\n    // 1순위: 쿠키 (사용자가 명시적으로 선택한 언어)\n    const cookieStore = await cookies();\n    const cookieLocale = cookieStore.get(LOCALE_COOKIE_KEY)?.value;\n\n    if (cookieLocale && config.supportedLocales.includes(cookieLocale))\n    {\n        return cookieLocale;\n    }\n\n    // 2순위: 브라우저 언어 감지 (설정에서 활성화된 경우)\n    if (config.detectBrowserLanguage)\n    {\n        const browserLang = await detectBrowserLanguage();\n        if (browserLang)\n        {\n            return browserLang;\n        }\n    }\n\n    // 3순위: 시스템 기본 언어\n    return config.defaultLocale;\n}\n\n/**\n * Locale 설정하기 (Server Action)\n *\n * 서버/클라이언트 컴포넌트 모두에서 사용 가능\n * 쿠키에 locale을 저장합니다.\n *\n * @param locale - 설정할 locale (예: 'ko', 'en')\n * @throws {Error} 지원하지 않는 locale인 경우\n *\n * @example\n * ```tsx\n * // Server Component (Server Action)\n * import { setLocale } from '@spfn/cms';\n *\n * export default async function Page()\n * {\n *     await setLocale('en');\n *     return <div>Locale changed</div>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Client Component (Server Action)\n * 'use client';\n * import { setLocale } from '@spfn/cms/client';\n *\n * export default function LanguageSwitcher()\n * {\n *     const handleChange = async (newLocale: string) =>\n *     {\n *         await setLocale(newLocale);\n *         window.location.reload(); // 페이지 새로고침\n *     };\n *\n *     return (\n *         <button onClick={() => handleChange('en')}>\n *             Switch to English\n *         </button>\n *     );\n * }\n * ```\n */\nexport async function setLocale(locale: string): Promise<void>\n{\n    const config = getCmsConfig();\n\n    // 유효성 검사\n    if (!config.supportedLocales.includes(locale))\n    {\n        throw new Error(\n            `Unsupported locale: ${locale}. Supported locales: ${config.supportedLocales.join(', ')}`\n        );\n    }\n\n    const cookieStore = await cookies();\n\n    cookieStore.set(LOCALE_COOKIE_KEY, locale, {\n        path: '/',\n        maxAge: 60 * 60 * 24 * 365, // 1년\n        sameSite: 'lax',\n    });\n}\n\n/**\n * 지원하는 locale 목록 가져오기 (Server Action)\n *\n * 서버/클라이언트 컴포넌트 모두에서 사용 가능\n *\n * @returns 지원하는 locale 배열 (예: ['ko', 'en', 'ja'])\n *\n * @example\n * ```tsx\n * // Server Component\n * import { getLocales } from '@spfn/cms';\n *\n * export default async function Page()\n * {\n *     const locales = await getLocales();\n *     return <div>Supported: {locales.join(', ')}</div>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Client Component\n * 'use client';\n * import { getLocales } from '@spfn/cms/client';\n *\n * export default function LanguageSwitcher()\n * {\n *     const [locales, setLocales] = useState<string[]>([]);\n *\n *     useEffect(() => {\n *         getLocales().then(setLocales);\n *     }, []);\n *\n *     return (\n *         <div>\n *             {locales.map(locale => (\n *                 <button key={locale}>{locale}</button>\n *             ))}\n *         </div>\n *     );\n * }\n * ```\n */\nexport async function getLocales(): Promise<string[]>\n{\n    const config = getCmsConfig();\n    return config.supportedLocales;\n}","/**\n * CMS Configuration Module\n *\n * 환경변수 기반 CMS 설정 관리\n * - SPFN_CMS_DEFAULT_LOCALE: 기본 언어 (기본값: 'ko')\n * - SPFN_CMS_SUPPORTED_LOCALES: 지원 언어 목록, 쉼표로 구분 (기본값: 'ko,en')\n * - SPFN_CMS_DETECT_BROWSER_LANGUAGE: 브라우저 언어 자동 감지 (기본값: 'false')\n */\n\n/**\n * CMS 설정 타입\n */\nexport interface CmsConfig\n{\n    /**\n     * 기본 언어 코드\n     * @example 'ko', 'en', 'ja'\n     */\n    defaultLocale: string;\n\n    /**\n     * 지원하는 언어 목록\n     * @example ['ko', 'en', 'ja']\n     */\n    supportedLocales: string[];\n\n    /**\n     * 브라우저 언어 자동 감지 여부\n     * @default false\n     */\n    detectBrowserLanguage: boolean;\n}\n\n/**\n * 환경변수 읽기 헬퍼\n */\nfunction getEnvVar(key: string, defaultValue: string): string\n{\n    return process.env[key] || defaultValue;\n}\n\n/**\n * 환경변수에서 boolean 읽기\n */\nfunction getEnvBoolean(key: string, defaultValue: boolean): boolean\n{\n    const value = process.env[key];\n    if (value === undefined) return defaultValue;\n    return value === 'true' || value === '1';\n}\n\n/**\n * 환경변수에서 설정 로드\n */\nfunction loadConfigFromEnv(): CmsConfig\n{\n    const defaultLocale = getEnvVar('SPFN_CMS_DEFAULT_LOCALE', 'en');\n    const supportedLocalesStr = getEnvVar('SPFN_CMS_SUPPORTED_LOCALES', 'en,ko');\n    const detectBrowserLanguage = getEnvBoolean('SPFN_CMS_DETECT_BROWSER_LANGUAGE', true);\n\n    const supportedLocales = supportedLocalesStr\n        .split(',')\n        .map(locale => locale.trim())\n        .filter(locale => locale.length > 0);\n\n    // 기본 언어가 지원 목록에 없으면 추가\n    if (!supportedLocales.includes(defaultLocale))\n    {\n        supportedLocales.unshift(defaultLocale);\n    }\n\n    return {\n        defaultLocale,\n        supportedLocales,\n        detectBrowserLanguage,\n    };\n}\n\n/**\n * 현재 설정 (환경변수에서 초기화)\n */\nlet currentConfig: CmsConfig = loadConfigFromEnv();\n\n/**\n * CMS 설정 조회\n *\n * @returns 현재 CMS 설정\n *\n * @example\n * ```tsx\n * import { getCmsConfig } from '@spfn/cms';\n *\n * const config = getCmsConfig();\n * console.log(config.defaultLocale); // 'ko'\n * console.log(config.supportedLocales); // ['ko', 'en']\n * ```\n */\nexport function getCmsConfig(): Readonly<CmsConfig>\n{\n    return currentConfig;\n}\n\n/**\n * CMS 설정 변경 (런타임 오버라이드)\n *\n * 환경변수 설정을 런타임에 오버라이드합니다.\n * 주로 테스트나 특수한 경우에 사용됩니다.\n *\n * @param config - 변경할 설정 (부분 업데이트 가능)\n *\n * @example\n * ```tsx\n * import { configureCms } from '@spfn/cms';\n *\n * // 앱 초기화 시 (선택적)\n * configureCms({\n *     defaultLocale: 'en',\n *     supportedLocales: ['en', 'ko', 'ja'],\n *     detectBrowserLanguage: true,\n * });\n * ```\n */\nexport function configureCms(config: Partial<CmsConfig>): void\n{\n    currentConfig = {\n        ...currentConfig,\n        ...config,\n    };\n\n    // 기본 언어가 지원 목록에 있는지 확인\n    if (config.defaultLocale && !currentConfig.supportedLocales.includes(config.defaultLocale))\n    {\n        console.warn(\n            `[CMS Config] Default locale '${config.defaultLocale}' not in supported locales, adding automatically.`,\n            `Supported locales: [${currentConfig.supportedLocales.join(', ')}]`\n        );\n\n        currentConfig.supportedLocales.unshift(config.defaultLocale);\n    }\n}\n\n/**\n * 설정 초기화 (환경변수에서 재로드)\n *\n * @example\n * ```tsx\n * import { resetCmsConfig } from '@spfn/cms';\n *\n * // 환경변수 설정으로 되돌리기\n * resetCmsConfig();\n * ```\n */\nexport function resetCmsConfig(): void\n{\n    currentConfig = loadConfigFromEnv();\n}","/**\n * Locale Constants\n *\n * Server/Client 양쪽에서 사용 가능한 locale 관련 상수\n */\n\n/**\n * Locale 쿠키 키\n */\nexport const LOCALE_COOKIE_KEY = 'spfn-locale';"],"mappings":";AAUA,SAAS,SAAS,eAAe;;;AC0BjC,SAAS,UAAU,KAAa,cAChC;AACI,SAAO,QAAQ,IAAI,GAAG,KAAK;AAC/B;AAKA,SAAS,cAAc,KAAa,cACpC;AACI,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,UAAU,UAAU,UAAU;AACzC;AAKA,SAAS,oBACT;AACI,QAAM,gBAAgB,UAAU,2BAA2B,IAAI;AAC/D,QAAM,sBAAsB,UAAU,8BAA8B,OAAO;AAC3E,QAAMA,yBAAwB,cAAc,oCAAoC,IAAI;AAEpF,QAAM,mBAAmB,oBACpB,MAAM,GAAG,EACT,IAAI,YAAU,OAAO,KAAK,CAAC,EAC3B,OAAO,YAAU,OAAO,SAAS,CAAC;AAGvC,MAAI,CAAC,iBAAiB,SAAS,aAAa,GAC5C;AACI,qBAAiB,QAAQ,aAAa;AAAA,EAC1C;AAEA,SAAO;AAAA,IACH;AAAA,IACA;AAAA,IACA,uBAAAA;AAAA,EACJ;AACJ;AAKA,IAAI,gBAA2B,kBAAkB;AAgB1C,SAAS,eAChB;AACI,SAAO;AACX;;;AC3FO,IAAM,oBAAoB;;;AFYjC,eAAe,wBACf;AACI,MACA;AACI,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,iBAAiB,YAAY,IAAI,iBAAiB;AAExD,QAAI,CAAC,gBACL;AACI,aAAO;AAAA,IACX;AAGA,UAAM,YAAY,eACb,MAAM,GAAG,EACT,IAAI,UACL;AACI,YAAM,CAAC,IAAI,IAAI,KAAK,MAAM,GAAG;AAC7B,aAAO,KAAK,MAAM,GAAG,EAAE,CAAC,EAAE,KAAK;AAAA,IACnC,CAAC;AAEL,UAAM,SAAS,aAAa;AAG5B,eAAW,QAAQ,WACnB;AACI,UAAI,OAAO,iBAAiB,SAAS,IAAI,GACzC;AACI,eAAO;AAAA,MACX;AAAA,IACJ;AAEA,WAAO;AAAA,EACX,SACO,OACP;AAEI,WAAO;AAAA,EACX;AACJ;AA4CA,eAAsB,YACtB;AACI,QAAM,SAAS,aAAa;AAG5B,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,eAAe,YAAY,IAAI,iBAAiB,GAAG;AAEzD,MAAI,gBAAgB,OAAO,iBAAiB,SAAS,YAAY,GACjE;AACI,WAAO;AAAA,EACX;AAGA,MAAI,OAAO,uBACX;AACI,UAAM,cAAc,MAAM,sBAAsB;AAChD,QAAI,aACJ;AACI,aAAO;AAAA,IACX;AAAA,EACJ;AAGA,SAAO,OAAO;AAClB;AA6CA,eAAsB,UAAU,QAChC;AACI,QAAM,SAAS,aAAa;AAG5B,MAAI,CAAC,OAAO,iBAAiB,SAAS,MAAM,GAC5C;AACI,UAAM,IAAI;AAAA,MACN,uBAAuB,MAAM,wBAAwB,OAAO,iBAAiB,KAAK,IAAI,CAAC;AAAA,IAC3F;AAAA,EACJ;AAEA,QAAM,cAAc,MAAM,QAAQ;AAElC,cAAY,IAAI,mBAAmB,QAAQ;AAAA,IACvC,MAAM;AAAA,IACN,QAAQ,KAAK,KAAK,KAAK;AAAA;AAAA,IACvB,UAAU;AAAA,EACd,CAAC;AACL;AA6CA,eAAsB,aACtB;AACI,QAAM,SAAS,aAAa;AAC5B,SAAO,OAAO;AAClB;","names":["detectBrowserLanguage"]}

package/dist/client.d.ts

@@ -1,17 +1,52 @@
+import { InferContract } from '@spfn/core';
+import { getLabelsContract, getLabelContract, createLabelContract, updateLabelContract, deleteLabelContract } from './contracts/labels.js';
+import { getPublishedCacheContract } from './contracts/published-cache.js';
+export { useCmsStore, useSection, useSections } from './store.js';
+import { SectionAPI } from './server.js';
+import '@sinclair/typebox';
+import 'zustand';
+
+/**
+ * CMS Store Initializer
+ *
+ * 서버 컴포넌트에서 로드한 섹션 데이터를 클라이언트 store에 초기화
+ */
+
+interface InitCmsProps {
+    /**
+     * 서버에서 로드한 섹션 데이터
+     * { home: { t, data }, ... }
+     */
+    sections: Record<string, SectionAPI>;
+}
+/**
+ * CMS Store 초기화 컴포넌트
+ *
+ * 서버 컴포넌트에서 로드한 데이터를  클라이언트 store에 주입
+ * 이후 하위 클라이언트 컴포넌트에서 useSection() 사용 가능
+ *
+ * @param props - InitCmsProps
+ * @param props.sections - 서버에서 로드한 섹션 데이터
+ *
+ * @example
+ * // Server Component
+ * const home = await getSection('home');
+ * <InitCms sections={{ home }} />
+ * // 이후 하위 클라이언트 컴포넌트에서 useSection('home') 사용 가능
+ */
+declare function InitCms({ sections }: InitCmsProps): null;
+
 /**
  * @spfn/cms/client
  *
  * Client Components Only
  * 클라이언트 컴포넌트 전용 (브라우저에서 실행)
  */
-import type { InferContract } from '@spfn/core';
-import { getLabelsContract, createLabelContract } from './routes/labels/contract';
-import { getLabelContract, updateLabelContract, deleteLabelContract } from './routes/labels/[id]/contract';
-import { getPublishedCacheContract } from './routes/published-cache/contract';
+
 /**
  * CMS API Client
  */
-export declare const cmsApi: {
+declare const cmsApi: {
     /**
      * Labels API
      */
@@ -132,7 +167,6 @@ export declare const cmsApi: {
 /**
  * Type exports
  */
-export type CmsApi = typeof cmsApi;
-export { useCmsStore, useSection, useSections } from './store';
-export { InitCms } from './init';
-//# sourceMappingURL=client.d.ts.map
+type CmsApi = typeof cmsApi;
+
+export { type CmsApi, InitCms, cmsApi };