@withwiz/cms-kit 0.1.0

package/dist/hooks/index.d.ts

@@ -0,0 +1,45 @@
+export { useScrollReveal, useScrollRevealAll } from './useScrollReveal.js';
+import * as react from 'react';
+export { useImageDropZone } from './useImageDropZone.js';
+
+interface UseAdminListOptions<T, S extends string> {
+    initialItems: T[];
+    apiPath: string;
+    defaultSortKey: S;
+    normalizeItem?: (raw: unknown) => T;
+    defaultFilterValue?: string;
+}
+declare function useAdminList<T, S extends string = string>(options: UseAdminListOptions<T, S>): {
+    items: T[];
+    setItems: react.Dispatch<react.SetStateAction<T[]>>;
+    searchQuery: string;
+    setSearchQuery: react.Dispatch<react.SetStateAction<string>>;
+    sortKey: S;
+    setSortKey: react.Dispatch<react.SetStateAction<S>>;
+    filterValue: string;
+    setFilterValue: react.Dispatch<react.SetStateAction<string>>;
+    fetchList: (sort: S) => Promise<void>;
+};
+
+declare function useAdminForm<F extends object>(initialForm: F): {
+    tab: "list" | "edit";
+    setTab: react.Dispatch<react.SetStateAction<"list" | "edit">>;
+    form: F;
+    setForm: react.Dispatch<react.SetStateAction<F>>;
+    updateField: <K extends keyof F>(key: K, value: F[K]) => void;
+    selectedId: string | null;
+    setSelectedId: react.Dispatch<react.SetStateAction<string | null>>;
+    isNew: boolean;
+    setIsNew: react.Dispatch<react.SetStateAction<boolean>>;
+    saving: boolean;
+    setSaving: react.Dispatch<react.SetStateAction<boolean>>;
+    loading: boolean;
+    setLoading: react.Dispatch<react.SetStateAction<boolean>>;
+    mobilePv: boolean;
+    setMobilePv: react.Dispatch<react.SetStateAction<boolean>>;
+    addNew: (emptyForm: F) => void;
+    startEdit: (id: string, emptyForm?: F) => void;
+    backToList: () => void;
+};
+
+export { useAdminForm, useAdminList };

package/dist/hooks/index.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-EL7YGOTY.js');
+
+
+
+var _chunkU6PVJKTBjs = require('../chunk-U6PVJKTB.js');
+
+
+
+var _chunk5JUIMXNFjs = require('../chunk-5JUIMXNF.js');
+
+
+var _chunkYY7K5CXXjs = require('../chunk-YY7K5CXX.js');
+require('../chunk-S7GOXCRM.js');
+require('../chunk-KWKV2GAH.js');
+require('../chunk-EG6NVPP2.js');
+require('../chunk-DGUM43GV.js');
+
+
+
+
+
+
+exports.useAdminForm = _chunk5JUIMXNFjs.useAdminForm; exports.useAdminList = _chunk5JUIMXNFjs.useAdminList; exports.useImageDropZone = _chunkYY7K5CXXjs.useImageDropZone; exports.useScrollReveal = _chunkU6PVJKTBjs.useScrollReveal; exports.useScrollRevealAll = _chunkU6PVJKTBjs.useScrollRevealAll;
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/uni4love/project/workspace/211-withwiz/node-packages/withwiz-cms-kit/dist/hooks/index.js"],"names":[],"mappings":"AAAA,yGAA6B;AAC7B;AACE;AACA;AACF,uDAA6B;AAC7B;AACE;AACA;AACF,uDAA6B;AAC7B;AACE;AACF,uDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACF,uSAAC","file":"/Users/uni4love/project/workspace/211-withwiz/node-packages/withwiz-cms-kit/dist/hooks/index.js"}

package/dist/hooks/index.mjs

@@ -0,0 +1,25 @@
+"use client";
+import "../chunk-QACD2U6P.mjs";
+import {
+  useScrollReveal,
+  useScrollRevealAll
+} from "../chunk-I5YMTJV6.mjs";
+import {
+  useAdminForm,
+  useAdminList
+} from "../chunk-FCCCG5Z7.mjs";
+import {
+  useImageDropZone
+} from "../chunk-LF5LOI7K.mjs";
+import "../chunk-J5N76ASB.mjs";
+import "../chunk-T7EVFD4G.mjs";
+import "../chunk-BWKKHCDG.mjs";
+import "../chunk-BJTO5JO5.mjs";
+export {
+  useAdminForm,
+  useAdminList,
+  useImageDropZone,
+  useScrollReveal,
+  useScrollRevealAll
+};
+//# sourceMappingURL=index.mjs.map

package/dist/hooks/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks/useImageDropZone.d.mts

@@ -0,0 +1,37 @@
+import { DragEvent } from 'react';
+
+interface ImageVariantUrls {
+    lg?: string;
+    md?: string;
+    sm?: string;
+    thumb?: string;
+}
+interface UploadResult {
+    url: string;
+    key: string;
+    size: number;
+    variants?: ImageVariantUrls;
+    variantKeys?: string[];
+}
+interface UseImageDropZoneOptions {
+    multiple?: boolean;
+    maxFiles?: number;
+    onUpload: (result: UploadResult) => void;
+    onKeyTracked?: (key: string) => void;
+    disabled?: boolean;
+}
+declare function useImageDropZone(options: UseImageDropZoneOptions): {
+    isDragOver: boolean;
+    isUploading: boolean;
+    isResizing: boolean;
+    error: string | null;
+    dragHandlers: {
+        onDragEnter: (e: DragEvent) => void;
+        onDragOver: (e: DragEvent) => void;
+        onDragLeave: (e: DragEvent) => void;
+        onDrop: (e: DragEvent) => void;
+    };
+    handleFileInput: (fileList: FileList | null) => Promise<void>;
+};
+
+export { useImageDropZone };

package/dist/hooks/useImageDropZone.d.ts

@@ -0,0 +1,37 @@
+import { DragEvent } from 'react';
+
+interface ImageVariantUrls {
+    lg?: string;
+    md?: string;
+    sm?: string;
+    thumb?: string;
+}
+interface UploadResult {
+    url: string;
+    key: string;
+    size: number;
+    variants?: ImageVariantUrls;
+    variantKeys?: string[];
+}
+interface UseImageDropZoneOptions {
+    multiple?: boolean;
+    maxFiles?: number;
+    onUpload: (result: UploadResult) => void;
+    onKeyTracked?: (key: string) => void;
+    disabled?: boolean;
+}
+declare function useImageDropZone(options: UseImageDropZoneOptions): {
+    isDragOver: boolean;
+    isUploading: boolean;
+    isResizing: boolean;
+    error: string | null;
+    dragHandlers: {
+        onDragEnter: (e: DragEvent) => void;
+        onDragOver: (e: DragEvent) => void;
+        onDragLeave: (e: DragEvent) => void;
+        onDrop: (e: DragEvent) => void;
+    };
+    handleFileInput: (fileList: FileList | null) => Promise<void>;
+};
+
+export { useImageDropZone };

package/dist/hooks/useImageDropZone.js

@@ -0,0 +1,13 @@
+"use client";
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+var _chunkYY7K5CXXjs = require('../chunk-YY7K5CXX.js');
+require('../chunk-S7GOXCRM.js');
+require('../chunk-KWKV2GAH.js');
+require('../chunk-EG6NVPP2.js');
+require('../chunk-DGUM43GV.js');
+
+
+exports.useImageDropZone = _chunkYY7K5CXXjs.useImageDropZone;
+//# sourceMappingURL=useImageDropZone.js.map

package/dist/hooks/useImageDropZone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/uni4love/project/workspace/211-withwiz/node-packages/withwiz-cms-kit/dist/hooks/useImageDropZone.js"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACF,uDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACF,6DAAC","file":"/Users/uni4love/project/workspace/211-withwiz/node-packages/withwiz-cms-kit/dist/hooks/useImageDropZone.js"}

package/dist/hooks/useImageDropZone.mjs

@@ -0,0 +1,12 @@
+"use client";
+import {
+  useImageDropZone
+} from "../chunk-LF5LOI7K.mjs";
+import "../chunk-J5N76ASB.mjs";
+import "../chunk-T7EVFD4G.mjs";
+import "../chunk-BWKKHCDG.mjs";
+import "../chunk-BJTO5JO5.mjs";
+export {
+  useImageDropZone
+};
+//# sourceMappingURL=useImageDropZone.mjs.map

package/dist/hooks/useImageDropZone.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks/useScrollReveal.d.mts

@@ -0,0 +1,6 @@
+import * as react from 'react';
+
+declare function useScrollReveal<T extends HTMLElement>(): react.RefObject<T | null>;
+declare function useScrollRevealAll(selector: string): void;
+
+export { useScrollReveal, useScrollRevealAll };

package/dist/hooks/useScrollReveal.d.ts

@@ -0,0 +1,6 @@
+import * as react from 'react';
+
+declare function useScrollReveal<T extends HTMLElement>(): react.RefObject<T | null>;
+declare function useScrollRevealAll(selector: string): void;
+
+export { useScrollReveal, useScrollRevealAll };

package/dist/hooks/useScrollReveal.js

@@ -0,0 +1,12 @@
+"use client";
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+
+var _chunkU6PVJKTBjs = require('../chunk-U6PVJKTB.js');
+require('../chunk-DGUM43GV.js');
+
+
+
+exports.useScrollReveal = _chunkU6PVJKTBjs.useScrollReveal; exports.useScrollRevealAll = _chunkU6PVJKTBjs.useScrollRevealAll;
+//# sourceMappingURL=useScrollReveal.js.map

package/dist/hooks/useScrollReveal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/uni4love/project/workspace/211-withwiz/node-packages/withwiz-cms-kit/dist/hooks/useScrollReveal.js"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACF,uDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACF,6HAAC","file":"/Users/uni4love/project/workspace/211-withwiz/node-packages/withwiz-cms-kit/dist/hooks/useScrollReveal.js"}

package/dist/hooks/useScrollReveal.mjs

@@ -0,0 +1,11 @@
+"use client";
+import {
+  useScrollReveal,
+  useScrollRevealAll
+} from "../chunk-I5YMTJV6.mjs";
+import "../chunk-BJTO5JO5.mjs";
+export {
+  useScrollReveal,
+  useScrollRevealAll
+};
+//# sourceMappingURL=useScrollReveal.mjs.map

package/dist/hooks/useScrollReveal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/image-drop-zone.css

@@ -0,0 +1,115 @@
+/* ═══ Shared Drag-and-Drop Upload States ═══ */
+
+/* Drag-over visual feedback */
+.af-upload-zone.is-drag-over,
+.nbe-ed-img-up.is-drag-over,
+.nbe-img-upload.is-drag-over,
+.admin-cover-upload.is-drag-over,
+.pm-poster-upload.is-drag-over,
+.rm-pu.is-drag-over,
+.rm-ce-iup.is-drag-over,
+.rm-gal-grid.is-drag-over {
+  border-color: #8c7444 !important;
+  border-style: dashed !important;
+  background: rgba(201, 169, 110, 0.08) !important;
+  box-shadow: inset 0 0 0 2px rgba(201, 169, 110, 0.15);
+  transition: all 0.15s ease;
+}
+
+/* Uploading / Resizing state */
+.af-upload-zone.is-uploading,
+.nbe-ed-img-up.is-uploading,
+.nbe-img-upload.is-uploading,
+.admin-cover-upload.is-uploading,
+.pm-poster-upload.is-uploading,
+.rm-pu.is-uploading,
+.rm-ce-iup.is-uploading,
+.af-upload-zone.is-resizing,
+.nbe-ed-img-up.is-resizing,
+.nbe-img-upload.is-resizing,
+.admin-cover-upload.is-resizing,
+.pm-poster-upload.is-resizing,
+.rm-pu.is-resizing,
+.rm-ce-iup.is-resizing {
+  opacity: 0.6;
+  pointer-events: none;
+}
+
+/* Upload spinner */
+.dz-upload-spinner {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12px;
+  color: #8c7444;
+}
+
+.dz-upload-spinner::before {
+  content: "";
+  width: 14px;
+  height: 14px;
+  border: 2px solid #e8e0d0;
+  border-top-color: #8c7444;
+  border-radius: 50%;
+  animation: dz-spin 0.6s linear infinite;
+}
+
+@keyframes dz-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* Error message */
+.dz-error {
+  font-size: 11px;
+  color: #d44;
+  margin-top: 4px;
+  padding: 4px 8px;
+  background: #fef5f5;
+  border: 1px solid #f0c0c0;
+  border-radius: 4px;
+}
+
+/* Drag hint text */
+.dz-drag-hint {
+  font-size: 12px;
+  color: #8c7444;
+  font-weight: 600;
+  pointer-events: none;
+}
+
+/* Placeholder with guide */
+.dz-placeholder {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 6px;
+  padding: 12px;
+  text-align: center;
+}
+
+.dz-placeholder-icon {
+  font-size: 24px;
+  color: #aaa;
+  line-height: 1;
+}
+
+.dz-placeholder-text {
+  font-size: 13px;
+  color: #888;
+}
+
+.dz-placeholder-guide {
+  font-size: 11px;
+  color: #bbb;
+  line-height: 1.5;
+}
+
+/* Gallery drop zone add button state */
+.rm-gal-add.dz-state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  pointer-events: none;
+}

package/dist/index-00a40-FQ.d.mts

@@ -0,0 +1,136 @@
+/**
+ * @withwiz/cms-kit — 중앙 설정/주입 경계 (spec.md §5).
+ *
+ * 모든 외부 자원/소비자 종속 값(brand/nav, route map, JWT, sanitizer 신뢰
+ * origin, R2 prefix 규칙, rate-limit identity 추출)은 이 모듈을 통해서만
+ * 흘러간다. `src/infrastructure/prisma.ts` 의 `setPrismaClient`/`getPrisma`
+ * 패턴을 모델로 한다.
+ *
+ * 결정 규칙 (모든 표면에 일관 적용):
+ *  - 우선순위: 명시적 주입(inject) > 레거시 환경변수 fallback(현재 이름 유지)
+ *    > 내장 기본값.
+ *  - lazy / point-of-use: 모듈 import 만으로는 절대 throw 하지 않는다. 실패/
+ *    경고는 자원을 *사용*할 때 발생한다 (prisma proxy 와 동일).
+ *  - safe-default 존재 → `@withwiz/cms-kit:` 네임스페이스 warn 1회(설정명 명시) 후
+ *    기본값 사용. safe-default 없음(JWT 서명 비밀) → `@withwiz/cms-kit:`
+ *    네임스페이스 error 로 point-of-use fail-fast.
+ *  - 환경변수 읽기는 이 모듈 안에서만 발생한다 (이번 스프린트가 라우팅하는
+ *    표면 한정 — spec.md §4.2 전체 sweep 은 Sprint 2).
+ */
+/** 사이드바 네비게이션 항목 (label + href + 접힘 글리프) */
+interface CmsNavItem {
+    /** 펼친 상태에서 보이는 라벨 */
+    label: string;
+    /** 링크 대상 경로 */
+    href: string;
+    /** 접힌 상태에서 보이는 1글자 글리프 */
+    glyph: string;
+}
+/** brand / navigation 설정 */
+interface CmsBrandConfig {
+    /** 브랜드 라벨 (사이드바 홈 링크 텍스트) */
+    brandLabel?: string;
+    /** 브랜드 홈 링크 href (사이트 보기) */
+    brandHref?: string;
+    /** admin 링크 대상 */
+    adminHref?: string;
+    /** 순서 있는 nav 항목 목록 */
+    navItems?: CmsNavItem[];
+}
+/** auth/route 엔드포인트 맵 */
+interface CmsRouteConfig {
+    /** 로그인 페이지 경로 */
+    loginPath?: string;
+    /** 로그인 후 리다이렉트 대상 (홈/대시보드) */
+    postLoginRedirect?: string;
+    /** "현재 사용자" 엔드포인트 */
+    meEndpoint?: string;
+    /** 로그아웃 엔드포인트 */
+    logoutEndpoint?: string;
+    /** 토큰 refresh 엔드포인트 */
+    refreshEndpoint?: string;
+    /** 업로드 엔드포인트 */
+    uploadEndpoint?: string;
+}
+/** JWT 설정 (서명 비밀에는 안전한 기본값이 없음 — fail-fast) */
+interface CmsJwtConfig {
+    /** HMAC 서명 비밀 (필수, 안전한 기본값 없음) */
+    secret?: string;
+    /** access token 만료 (기본 '2h') */
+    accessTokenExpiry?: string;
+    /** refresh token 만료 (기본 '7d') */
+    refreshTokenExpiry?: string;
+    /** 알고리즘 (기본 'HS256') */
+    algorithm?: string;
+}
+/** sanitizer 설정 */
+interface CmsSanitizerConfig {
+    /** 신뢰 iframe origin prefix 목록 (기본 = YouTube/Vimeo) */
+    trustedIframeOrigins?: readonly string[];
+}
+/**
+ * R2 자격 증명 설정. 모든 항목 안전한 기본값이 없음 — credentials 누락 시
+ * point-of-use(`uploadToR2`/`deleteFromR2`/`getClient`) 에서 namespaced
+ * fail-fast. 부분 설정 가능 (예: bucketName 만 inject, 나머지는 legacy env).
+ */
+interface CmsR2CredentialsConfig {
+    /** Cloudflare R2 계정 ID (endpoint host 구성에 사용) */
+    accountId?: string;
+    /** R2 access key ID */
+    accessKeyId?: string;
+    /** R2 secret access key */
+    secretAccessKey?: string;
+    /** R2 버킷 이름 */
+    bucketName?: string;
+}
+/** R2/storage 설정 */
+interface CmsStorageConfig {
+    /**
+     * inline `<img src>` 에서 storage key 로 인정할 최상위 prefix 목록.
+     * 미설정 시 origin/base 기반의 안전 기본 동작(아무 prefix 도 silent drop
+     * 하지 않음)을 사용한다 — `news/` 전용 하드코딩과 달리 비-`news` 키도
+     * 수집된다 (spec.md §4.1 orphan-bug fix).
+     */
+    inlineKeyPrefixes?: readonly string[];
+    /**
+     * storage 공개 base URL/origin. 지정 시:
+     *  - inline `<img src>` 의 path 가 폴더 무관하게 key 로 수집된다 (r2-helpers).
+     *  - 업로드 결과 public URL 의 prefix 로 사용된다 (r2-storage).
+     * 미설정 시 r2-storage 는 legacy `R2_PUBLIC_URL` env, 그것도 없으면
+     * `https://${bucketName}.r2.dev` 로 fallback 한다.
+     */
+    publicBaseUrl?: string;
+    /** R2 자격 증명 (계정/키/버킷). 미주입 시 legacy R2_* 환경변수 fallback. */
+    r2?: CmsR2CredentialsConfig;
+}
+/** rate-limit client-identity / IP 추출 전략 */
+type CmsIdentityExtractor = (headers: Headers) => string;
+/** rate-limit 설정 */
+interface CmsRateLimitConfig {
+    /** consumer 가 주입하는 client-identity 추출 함수 */
+    identityExtractor?: CmsIdentityExtractor;
+    /** rate-limit 활성화 (기본: legacy RATE_LIMIT_ENABLED env, 그 외 true) */
+    enabled?: boolean;
+}
+/** 전체 §5 설정 */
+interface CmsConfig {
+    brand?: CmsBrandConfig;
+    routes?: CmsRouteConfig;
+    jwt?: CmsJwtConfig;
+    sanitizer?: CmsSanitizerConfig;
+    storage?: CmsStorageConfig;
+    rateLimit?: CmsRateLimitConfig;
+}
+/** JWT 서명 비밀 최소 길이 (문서화된 정책, spec.md §4.6 / S3). */
+declare const JWT_SECRET_MIN_LENGTH = 32;
+/**
+ * 전체 §5 설정을 주입한다 (prisma 의 `setPrismaClient` 와 동형).
+ * 부분 주입을 병합하며, 같은 키 재주입 시 새 값이 우선한다.
+ */
+declare function setCmsConfig(config: CmsConfig): void;
+/** 주입된 설정을 모두 비운다 (테스트/재초기화 용도). */
+declare function resetCmsConfig(): void;
+/** 현재 병합된 raw 설정 (디버깅/테스트 용). */
+declare function getCmsConfig(): CmsConfig;
+
+export { type CmsBrandConfig as C, JWT_SECRET_MIN_LENGTH as J, type CmsConfig as a, type CmsIdentityExtractor as b, type CmsJwtConfig as c, type CmsNavItem as d, type CmsR2CredentialsConfig as e, type CmsRateLimitConfig as f, type CmsRouteConfig as g, type CmsSanitizerConfig as h, type CmsStorageConfig as i, getCmsConfig as j, resetCmsConfig as r, setCmsConfig as s };

package/dist/index-00a40-FQ.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @withwiz/cms-kit — 중앙 설정/주입 경계 (spec.md §5).
+ *
+ * 모든 외부 자원/소비자 종속 값(brand/nav, route map, JWT, sanitizer 신뢰
+ * origin, R2 prefix 규칙, rate-limit identity 추출)은 이 모듈을 통해서만
+ * 흘러간다. `src/infrastructure/prisma.ts` 의 `setPrismaClient`/`getPrisma`
+ * 패턴을 모델로 한다.
+ *
+ * 결정 규칙 (모든 표면에 일관 적용):
+ *  - 우선순위: 명시적 주입(inject) > 레거시 환경변수 fallback(현재 이름 유지)
+ *    > 내장 기본값.
+ *  - lazy / point-of-use: 모듈 import 만으로는 절대 throw 하지 않는다. 실패/
+ *    경고는 자원을 *사용*할 때 발생한다 (prisma proxy 와 동일).
+ *  - safe-default 존재 → `@withwiz/cms-kit:` 네임스페이스 warn 1회(설정명 명시) 후
+ *    기본값 사용. safe-default 없음(JWT 서명 비밀) → `@withwiz/cms-kit:`
+ *    네임스페이스 error 로 point-of-use fail-fast.
+ *  - 환경변수 읽기는 이 모듈 안에서만 발생한다 (이번 스프린트가 라우팅하는
+ *    표면 한정 — spec.md §4.2 전체 sweep 은 Sprint 2).
+ */
+/** 사이드바 네비게이션 항목 (label + href + 접힘 글리프) */
+interface CmsNavItem {
+    /** 펼친 상태에서 보이는 라벨 */
+    label: string;
+    /** 링크 대상 경로 */
+    href: string;
+    /** 접힌 상태에서 보이는 1글자 글리프 */
+    glyph: string;
+}
+/** brand / navigation 설정 */
+interface CmsBrandConfig {
+    /** 브랜드 라벨 (사이드바 홈 링크 텍스트) */
+    brandLabel?: string;
+    /** 브랜드 홈 링크 href (사이트 보기) */
+    brandHref?: string;
+    /** admin 링크 대상 */
+    adminHref?: string;
+    /** 순서 있는 nav 항목 목록 */
+    navItems?: CmsNavItem[];
+}
+/** auth/route 엔드포인트 맵 */
+interface CmsRouteConfig {
+    /** 로그인 페이지 경로 */
+    loginPath?: string;
+    /** 로그인 후 리다이렉트 대상 (홈/대시보드) */
+    postLoginRedirect?: string;
+    /** "현재 사용자" 엔드포인트 */
+    meEndpoint?: string;
+    /** 로그아웃 엔드포인트 */
+    logoutEndpoint?: string;
+    /** 토큰 refresh 엔드포인트 */
+    refreshEndpoint?: string;
+    /** 업로드 엔드포인트 */
+    uploadEndpoint?: string;
+}
+/** JWT 설정 (서명 비밀에는 안전한 기본값이 없음 — fail-fast) */
+interface CmsJwtConfig {
+    /** HMAC 서명 비밀 (필수, 안전한 기본값 없음) */
+    secret?: string;
+    /** access token 만료 (기본 '2h') */
+    accessTokenExpiry?: string;
+    /** refresh token 만료 (기본 '7d') */
+    refreshTokenExpiry?: string;
+    /** 알고리즘 (기본 'HS256') */
+    algorithm?: string;
+}
+/** sanitizer 설정 */
+interface CmsSanitizerConfig {
+    /** 신뢰 iframe origin prefix 목록 (기본 = YouTube/Vimeo) */
+    trustedIframeOrigins?: readonly string[];
+}
+/**
+ * R2 자격 증명 설정. 모든 항목 안전한 기본값이 없음 — credentials 누락 시
+ * point-of-use(`uploadToR2`/`deleteFromR2`/`getClient`) 에서 namespaced
+ * fail-fast. 부분 설정 가능 (예: bucketName 만 inject, 나머지는 legacy env).
+ */
+interface CmsR2CredentialsConfig {
+    /** Cloudflare R2 계정 ID (endpoint host 구성에 사용) */
+    accountId?: string;
+    /** R2 access key ID */
+    accessKeyId?: string;
+    /** R2 secret access key */
+    secretAccessKey?: string;
+    /** R2 버킷 이름 */
+    bucketName?: string;
+}
+/** R2/storage 설정 */
+interface CmsStorageConfig {
+    /**
+     * inline `<img src>` 에서 storage key 로 인정할 최상위 prefix 목록.
+     * 미설정 시 origin/base 기반의 안전 기본 동작(아무 prefix 도 silent drop
+     * 하지 않음)을 사용한다 — `news/` 전용 하드코딩과 달리 비-`news` 키도
+     * 수집된다 (spec.md §4.1 orphan-bug fix).
+     */
+    inlineKeyPrefixes?: readonly string[];
+    /**
+     * storage 공개 base URL/origin. 지정 시:
+     *  - inline `<img src>` 의 path 가 폴더 무관하게 key 로 수집된다 (r2-helpers).
+     *  - 업로드 결과 public URL 의 prefix 로 사용된다 (r2-storage).
+     * 미설정 시 r2-storage 는 legacy `R2_PUBLIC_URL` env, 그것도 없으면
+     * `https://${bucketName}.r2.dev` 로 fallback 한다.
+     */
+    publicBaseUrl?: string;
+    /** R2 자격 증명 (계정/키/버킷). 미주입 시 legacy R2_* 환경변수 fallback. */
+    r2?: CmsR2CredentialsConfig;
+}
+/** rate-limit client-identity / IP 추출 전략 */
+type CmsIdentityExtractor = (headers: Headers) => string;
+/** rate-limit 설정 */
+interface CmsRateLimitConfig {
+    /** consumer 가 주입하는 client-identity 추출 함수 */
+    identityExtractor?: CmsIdentityExtractor;
+    /** rate-limit 활성화 (기본: legacy RATE_LIMIT_ENABLED env, 그 외 true) */
+    enabled?: boolean;
+}
+/** 전체 §5 설정 */
+interface CmsConfig {
+    brand?: CmsBrandConfig;
+    routes?: CmsRouteConfig;
+    jwt?: CmsJwtConfig;
+    sanitizer?: CmsSanitizerConfig;
+    storage?: CmsStorageConfig;
+    rateLimit?: CmsRateLimitConfig;
+}
+/** JWT 서명 비밀 최소 길이 (문서화된 정책, spec.md §4.6 / S3). */
+declare const JWT_SECRET_MIN_LENGTH = 32;
+/**
+ * 전체 §5 설정을 주입한다 (prisma 의 `setPrismaClient` 와 동형).
+ * 부분 주입을 병합하며, 같은 키 재주입 시 새 값이 우선한다.
+ */
+declare function setCmsConfig(config: CmsConfig): void;
+/** 주입된 설정을 모두 비운다 (테스트/재초기화 용도). */
+declare function resetCmsConfig(): void;
+/** 현재 병합된 raw 설정 (디버깅/테스트 용). */
+declare function getCmsConfig(): CmsConfig;
+
+export { type CmsBrandConfig as C, JWT_SECRET_MIN_LENGTH as J, type CmsConfig as a, type CmsIdentityExtractor as b, type CmsJwtConfig as c, type CmsNavItem as d, type CmsR2CredentialsConfig as e, type CmsRateLimitConfig as f, type CmsRouteConfig as g, type CmsSanitizerConfig as h, type CmsStorageConfig as i, getCmsConfig as j, resetCmsConfig as r, setCmsConfig as s };