@withwiz/gallery 0.1.0

package/dist/presets/ballet.mjs

@@ -0,0 +1,162 @@
+"use client";
+import {
+  cn
+} from "../chunk-BTLELFKC.mjs";
+import {
+  useGalleryLightbox,
+  useScrollReveal
+} from "../chunk-B3MQL6ZR.mjs";
+
+// src/presets/ballet.tsx
+import { useEffect } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var FALLBACK_I18N = {
+  sectionLabel: "\uAC24\uB7EC\uB9AC",
+  moments: "\uACF5\uC5F0\uC758 \uC21C\uAC04\uB4E4",
+  expandAria: "\uC774\uBBF8\uC9C0 \uD655\uB300",
+  lbClose: "\uB2EB\uAE30",
+  lbPrev: "\uC774\uC804 \uC774\uBBF8\uC9C0",
+  lbNext: "\uB2E4\uC74C \uC774\uBBF8\uC9C0"
+};
+function PublicGalleryMosaic(props) {
+  const {
+    images: rawImages,
+    count = 7,
+    i18n: i18nOverride,
+    className,
+    scrollReveal = true,
+    hideHeader = false
+  } = props;
+  const i18n = { ...FALLBACK_I18N, ...i18nOverride ?? {} };
+  const images = rawImages.slice(0, count);
+  const lightbox = useGalleryLightbox(images);
+  const { ref: revealRef, isVisible } = useScrollReveal({ once: true });
+  useEffect(() => {
+    if (!lightbox.isOpen) return;
+    if (typeof document === "undefined") return;
+    const prev = document.body.style.overflow;
+    document.body.style.overflow = "hidden";
+    return () => {
+      document.body.style.overflow = prev;
+    };
+  }, [lightbox.isOpen]);
+  if (images.length === 0) return null;
+  const showReveal = scrollReveal ? isVisible : true;
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      ref: revealRef,
+      className: cn(
+        "gallery-public-mosaic-section",
+        showReveal && "gallery-public-mosaic-section--visible",
+        className
+      ),
+      "aria-label": i18n.sectionLabel,
+      children: [
+        !hideHeader && /* @__PURE__ */ jsxs("header", { className: "gallery-public-mosaic__head", children: [
+          /* @__PURE__ */ jsx("div", { className: "gallery-public-mosaic__label", children: i18n.sectionLabel }),
+          /* @__PURE__ */ jsx("h2", { className: "gallery-public-mosaic__title", children: i18n.moments })
+        ] }),
+        /* @__PURE__ */ jsx("div", { className: "gallery-public-mosaic", "data-count": images.length, children: images.map((img, i) => /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "gallery-public-mosaic__item",
+            role: "button",
+            tabIndex: 0,
+            "aria-label": img.alt ?? i18n.expandAria,
+            onClick: () => lightbox.open(i),
+            onKeyDown: (e) => {
+              if (e.key === "Enter" || e.key === " ") {
+                e.preventDefault();
+                lightbox.open(i);
+              }
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                "img",
+                {
+                  src: img.src,
+                  alt: img.alt ?? "",
+                  className: "gallery-public-mosaic__img",
+                  loading: "lazy"
+                }
+              ),
+              /* @__PURE__ */ jsx("div", { className: "gallery-public-mosaic__hover", children: /* @__PURE__ */ jsx("div", { className: "gallery-public-mosaic__icon", "aria-hidden": "true", children: "+" }) })
+            ]
+          },
+          `${img.src}-${i}`
+        )) }),
+        lightbox.isOpen && lightbox.current && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "gallery-lightbox",
+            role: "dialog",
+            "aria-modal": "true",
+            "aria-label": i18n.moments,
+            onClick: lightbox.close,
+            children: [
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  className: "gallery-lightbox__close",
+                  "aria-label": i18n.lbClose,
+                  onClick: (e) => {
+                    e.stopPropagation();
+                    lightbox.close();
+                  },
+                  children: "\xD7"
+                }
+              ),
+              images.length > 1 && /* @__PURE__ */ jsxs(Fragment, { children: [
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "gallery-lightbox__nav gallery-lightbox__prev",
+                    "aria-label": i18n.lbPrev,
+                    onClick: (e) => {
+                      e.stopPropagation();
+                      lightbox.prev();
+                    },
+                    children: "\u2039"
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "gallery-lightbox__nav gallery-lightbox__next",
+                    "aria-label": i18n.lbNext,
+                    onClick: (e) => {
+                      e.stopPropagation();
+                      lightbox.next();
+                    },
+                    children: "\u203A"
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsx("div", { className: "gallery-lightbox__content", onClick: (e) => e.stopPropagation(), children: /* @__PURE__ */ jsx(
+                "img",
+                {
+                  src: lightbox.current.src,
+                  alt: lightbox.current.alt ?? "",
+                  className: "gallery-lightbox__img"
+                }
+              ) }),
+              images.length > 1 && /* @__PURE__ */ jsxs("div", { className: "gallery-lightbox__counter", children: [
+                lightbox.currentIndex + 1,
+                " / ",
+                images.length
+              ] })
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+export {
+  PublicGalleryMosaic
+};
+//# sourceMappingURL=ballet.mjs.map

package/dist/presets/ballet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/presets/ballet.tsx"],"sourcesContent":["/**\n * @withwiz/gallery/presets/ballet\n *\n * 발레용 reference public 컴포넌트. ballet 의\n *   `src/components/sections/Gallery.tsx`\n * 의 모자이크 + 라이트박스 결합을 host 독립으로 추출.\n *\n * 사용 예 (host RSC + client mount):\n *\n *   import { PublicGalleryMosaic } from \"@withwiz/gallery/presets/ballet\";\n *   import { getFeaturedGalleries } from \"@withwiz/gallery/server\";\n *   import \"@withwiz/gallery/components/gallery.css\";\n *\n *   export default async function HomePage() {\n *     const featured = await getFeaturedGalleries(config, 7);\n *     const images = featured.map((g) => ({ src: g.imageUrl, alt: g.caption ?? \"갤러리\" }));\n *     return <PublicGalleryMosaic images={images} count={7} />;\n *   }\n *\n * yeroom 등 다른 host 는 이 preset 을 fork 하거나 `useGalleryLightbox` hook 만\n * 가져다 직접 그릴 수 있다.\n *\n * Host-independence:\n *   - `next/image`, `next/navigation`, `useI18n`, `@withwiz/pms` 등 직접 의존 0\n *   - 이미지는 plain `<img>` 사용. host 가 next/image 로 그리고 싶다면 fork.\n *   - 모든 라벨은 props.i18n 으로만 (fallback 한글).\n */\n\nimport { useEffect, type JSX } from \"react\";\nimport { useGalleryLightbox, type LightboxImage } from \"../hooks/useGalleryLightbox\";\nimport { useScrollReveal } from \"../hooks/useScrollReveal\";\nimport { cn } from \"../utils/cn\";\n\nconst FALLBACK_I18N = {\n  sectionLabel: \"갤러리\",\n  moments: \"공연의 순간들\",\n  expandAria: \"이미지 확대\",\n  lbClose: \"닫기\",\n  lbPrev: \"이전 이미지\",\n  lbNext: \"다음 이미지\",\n} as const;\n\nexport interface PublicGalleryMosaicProps {\n  /** 표시할 이미지 목록 (host 가 loaders 등에서 받아온 src/alt 매핑) */\n  images: LightboxImage[];\n  /** 모자이크 그리드 칸 수 (default 7). images.length > count 이면 slice. */\n  count?: number;\n  /** UI 라벨 i18n override. 미주입 키는 한글 fallback. */\n  i18n?: Partial<Record<keyof typeof FALLBACK_I18N, string>>;\n  /** 외부 className 추가 */\n  className?: string;\n  /** 스크롤 reveal (IntersectionObserver) 사용 여부 (default true). false 면 즉시 visible. */\n  scrollReveal?: boolean;\n  /** 섹션 헤더 비노출 (default false). host 가 자체 헤더를 두는 경우 true. */\n  hideHeader?: boolean;\n}\n\n/**\n * 발레 home gallery 의 모자이크 + 라이트박스.\n *\n *   - useGalleryLightbox 가 ESC / Arrow 키바인딩과 wrap-around 를 담당.\n *   - useScrollReveal 로 fade-in (scrollReveal=true 일 때).\n *   - lightbox open 시 body scroll lock (overflow:hidden).\n *   - images 가 빈 배열이면 null 반환.\n */\nexport function PublicGalleryMosaic(props: PublicGalleryMosaicProps): JSX.Element | null {\n  const {\n    images: rawImages,\n    count = 7,\n    i18n: i18nOverride,\n    className,\n    scrollReveal = true,\n    hideHeader = false,\n  } = props;\n\n  const i18n = { ...FALLBACK_I18N, ...(i18nOverride ?? {}) };\n\n  // count 만큼 잘라 사용 (images.length > count 인 경우 super-fluous 제거)\n  const images = rawImages.slice(0, count);\n\n  const lightbox = useGalleryLightbox(images);\n  const { ref: revealRef, isVisible } = useScrollReveal({ once: true });\n\n  // body scroll lock — lightbox 가 열린 동안 host 페이지의 스크롤을 막는다.\n  // SSR safe: document 가 정의된 환경에서만 동작.\n  useEffect(() => {\n    if (!lightbox.isOpen) return;\n    if (typeof document === \"undefined\") return;\n    const prev = document.body.style.overflow;\n    document.body.style.overflow = \"hidden\";\n    return () => {\n      document.body.style.overflow = prev;\n    };\n  }, [lightbox.isOpen]);\n\n  if (images.length === 0) return null;\n\n  const showReveal = scrollReveal ? isVisible : true;\n\n  return (\n    <section\n      ref={revealRef}\n      className={cn(\n        \"gallery-public-mosaic-section\",\n        showReveal && \"gallery-public-mosaic-section--visible\",\n        className,\n      )}\n      aria-label={i18n.sectionLabel}\n    >\n      {!hideHeader && (\n        <header className=\"gallery-public-mosaic__head\">\n          <div className=\"gallery-public-mosaic__label\">{i18n.sectionLabel}</div>\n          <h2 className=\"gallery-public-mosaic__title\">{i18n.moments}</h2>\n        </header>\n      )}\n\n      <div className=\"gallery-public-mosaic\" data-count={images.length}>\n        {images.map((img, i) => (\n          <div\n            key={`${img.src}-${i}`}\n            className=\"gallery-public-mosaic__item\"\n            role=\"button\"\n            tabIndex={0}\n            aria-label={img.alt ?? i18n.expandAria}\n            onClick={() => lightbox.open(i)}\n            onKeyDown={(e) => {\n              if (e.key === \"Enter\" || e.key === \" \") {\n                e.preventDefault();\n                lightbox.open(i);\n              }\n            }}\n          >\n            <img\n              src={img.src}\n              alt={img.alt ?? \"\"}\n              className=\"gallery-public-mosaic__img\"\n              loading=\"lazy\"\n            />\n            <div className=\"gallery-public-mosaic__hover\">\n              <div className=\"gallery-public-mosaic__icon\" aria-hidden=\"true\">\n                +\n              </div>\n            </div>\n          </div>\n        ))}\n      </div>\n\n      {lightbox.isOpen && lightbox.current && (\n        <div\n          className=\"gallery-lightbox\"\n          role=\"dialog\"\n          aria-modal=\"true\"\n          aria-label={i18n.moments}\n          onClick={lightbox.close}\n        >\n          <button\n            type=\"button\"\n            className=\"gallery-lightbox__close\"\n            aria-label={i18n.lbClose}\n            onClick={(e) => {\n              e.stopPropagation();\n              lightbox.close();\n            }}\n          >\n            ×\n          </button>\n\n          {images.length > 1 && (\n            <>\n              <button\n                type=\"button\"\n                className=\"gallery-lightbox__nav gallery-lightbox__prev\"\n                aria-label={i18n.lbPrev}\n                onClick={(e) => {\n                  e.stopPropagation();\n                  lightbox.prev();\n                }}\n              >\n                ‹\n              </button>\n              <button\n                type=\"button\"\n                className=\"gallery-lightbox__nav gallery-lightbox__next\"\n                aria-label={i18n.lbNext}\n                onClick={(e) => {\n                  e.stopPropagation();\n                  lightbox.next();\n                }}\n              >\n                ›\n              </button>\n            </>\n          )}\n\n          <div className=\"gallery-lightbox__content\" onClick={(e) => e.stopPropagation()}>\n            <img\n              src={lightbox.current.src}\n              alt={lightbox.current.alt ?? \"\"}\n              className=\"gallery-lightbox__img\"\n            />\n          </div>\n\n          {images.length > 1 && (\n            <div className=\"gallery-lightbox__counter\">\n              {lightbox.currentIndex + 1} / {images.length}\n            </div>\n          )}\n        </div>\n      )}\n    </section>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/server/index.d.mts

@@ -0,0 +1,157 @@
+import { PaginatedResult, GalleryConfig, GalleryCategoryItem, CreateCategoryInput, UpdateCategoryInput, GalleryListItem, GalleryDetail, CreateGalleryInput, UpdateGalleryInput, RouteHandler } from '../types/index.mjs';
+export { ApiContext, ApiWrapper, GalleryI18nKey, GallerySlotName, PaginationMeta, PrismaLike, SortOrder } from '../types/index.mjs';
+export { C as CategoryInUseError, a as CategoryNotFoundError, G as GalleryError, b as GalleryNotFoundError, P as PermissionDeniedError, g as getGalleryConfig, s as setGalleryConfig } from '../errors-DYrlDCzP.mjs';
+import 'next/server';
+import 'react';
+
+/**
+ * pagination math 를 일관되게 처리. ballet 의 `buildPaginatedResult` 와 동일 시맨틱.
+ *
+ * - total === 0 일 때 totalPages = 0 (clamp 안 함; UI 에서 "결과 없음" 로 처리)
+ * - page > totalPages 여도 결과 자체는 caller 의 query 가 결정 — meta 만 계산
+ */
+declare function buildPaginatedResult<T>(items: T[], page: number, limit: number, total: number): PaginatedResult<T>;
+
+/**
+ * spec §9-2 의 categoryService.
+ *
+ * 호스트 독립성을 위해 Prisma delegate 는 `config.prisma[modelName]` 패턴으로 접근한다
+ * (modelName 기본값 = "galleryCategory", gallery 본체 modelName 기본값 = "gallery").
+ *
+ * remove() 는 `onDelete: Restrict` 보강 — 사전 gallery.count() 후 throw.
+ * admin UX 가 친화적 에러 메시지를 표시하도록 명시적 throw 를 사용.
+ */
+declare function createCategoryService(config: GalleryConfig): {
+    list: (opts?: {
+        isActive?: boolean;
+    }) => Promise<GalleryCategoryItem[]>;
+    getBySlug: (slug: string) => Promise<GalleryCategoryItem | null>;
+    getById: (id: string) => Promise<GalleryCategoryItem | null>;
+    create: (data: CreateCategoryInput) => Promise<GalleryCategoryItem>;
+    update: (id: string, data: UpdateCategoryInput) => Promise<GalleryCategoryItem>;
+    remove: (id: string) => Promise<void>;
+    reorder: (ids: string[]) => Promise<void>;
+};
+type CategoryService = ReturnType<typeof createCategoryService>;
+
+type SortKey$1 = "sortOrder" | "createdAt" | "updatedAt" | "caption";
+/**
+ * spec §9-2 의 createGalleryService.
+ *
+ * 핵심 규칙:
+ * - Prisma delegate 는 `config.prisma[config.modelName ?? "gallery"]` 패턴.
+ * - `include: { category: true }` 만 사용. **author include 금지** (Gallery 모델에 author 관계 없음, §3 호스트 독립 원칙).
+ * - 삭제 시 `config.storage` 가 isEnabled() true 면 collectKeys → deleteKeys.
+ * - `revalidate` 는 service 에서 호출하지 않음 (route handler 책임).
+ */
+declare function createGalleryService(config: GalleryConfig): {
+    listFeatured: (limit?: number) => Promise<GalleryListItem[]>;
+    listPublished: (limit?: number) => Promise<GalleryListItem[]>;
+    listPublishedByCategory: (categorySlug: string, limit?: number) => Promise<GalleryListItem[]>;
+    listAll: (opts: {
+        page?: number;
+        limit?: number;
+        categoryId?: string;
+        published?: boolean;
+        search?: string;
+        sortBy?: SortKey$1;
+    }) => Promise<PaginatedResult<GalleryListItem>>;
+    getById: (id: string) => Promise<GalleryDetail | null>;
+    create: (data: CreateGalleryInput, authorId: string) => Promise<GalleryDetail>;
+    createMany: (items: CreateGalleryInput[], authorId: string) => Promise<{
+        count: number;
+    }>;
+    update: (id: string, data: UpdateGalleryInput) => Promise<GalleryDetail>;
+    remove: (id: string) => Promise<void>;
+    removeMany: (ids: string[]) => Promise<{
+        count: number;
+    }>;
+    bulkUpdatePublished: (ids: string[], published: boolean) => Promise<{
+        count: number;
+    }>;
+    bulkUpdateFeatured: (ids: string[], featured: boolean) => Promise<{
+        count: number;
+    }>;
+    togglePublish: (id: string) => Promise<GalleryDetail>;
+    count: (opts?: {
+        published?: boolean;
+    }) => Promise<number>;
+    listRecent: (limit: number) => Promise<GalleryListItem[]>;
+};
+type GalleryService = ReturnType<typeof createGalleryService>;
+
+interface GalleryRoutes {
+    collection: {
+        GET: RouteHandler;
+        POST: RouteHandler;
+        DELETE: RouteHandler;
+    };
+    item: {
+        GET: RouteHandler;
+        PUT: RouteHandler;
+        DELETE: RouteHandler;
+    };
+    publishToggle: {
+        PATCH: RouteHandler;
+    };
+    bulk: {
+        POST: RouteHandler;
+        PATCH: RouteHandler;
+    };
+    categoryCollection: {
+        GET: RouteHandler;
+        POST: RouteHandler;
+    };
+    categoryItem: {
+        GET: RouteHandler;
+        PUT: RouteHandler;
+        DELETE: RouteHandler;
+    };
+}
+declare function createGalleryRoutes(config: GalleryConfig): GalleryRoutes;
+
+/**
+ * RSC loaders — spec §9-4.
+ *
+ * Server Components 가 직접 호출하는 함수. 각 함수는 service 의 대응 메서드를
+ * 얇게 감싸기만 한다. host 가 매번 `config` 를 주입해 explicit DI 를 유지한다
+ * (setGalleryConfig 의존 회피 — host 의 layout/page 에서 config 를 명시적으로
+ * 주입하는 것이 RSC graph 캐싱과 호환성 면에서 더 안전).
+ */
+
+type SortKey = "sortOrder" | "createdAt" | "updatedAt" | "caption";
+/**
+ * spec §9-4: `getGalleryItems(config, opts) → PaginatedResult<GalleryListItem>`
+ *
+ * admin 페이지의 RSC 가 직접 호출. fetch 라운드트립 없이 service 호출.
+ */
+declare function getGalleryItems(config: GalleryConfig, opts: {
+    page?: number;
+    limit?: number;
+    categoryId?: string;
+    published?: boolean;
+    search?: string;
+    sortBy?: SortKey;
+}): Promise<PaginatedResult<GalleryListItem>>;
+/**
+ * spec §9-4: `getFeaturedGalleries(config, limit?) → GalleryListItem[]`
+ *
+ * 홈 페이지의 모자이크 그리드 등 featured 영역에서 호출.
+ */
+declare function getFeaturedGalleries(config: GalleryConfig, limit?: number): Promise<GalleryListItem[]>;
+/**
+ * spec §9-4: `getRecentGalleries(config, limit) → GalleryListItem[]`
+ *
+ * 대시보드의 최근 항목 위젯 등에서 호출.
+ */
+declare function getRecentGalleries(config: GalleryConfig, limit: number): Promise<GalleryListItem[]>;
+/**
+ * spec §9-4: `getGalleryCount(config, opts?) → number`
+ *
+ * 대시보드 통계 등에서 호출. `opts.published` 미지정 시 전체 count.
+ */
+declare function getGalleryCount(config: GalleryConfig, opts?: {
+    published?: boolean;
+}): Promise<number>;
+
+export { type CategoryService, CreateCategoryInput, CreateGalleryInput, GalleryCategoryItem, GalleryConfig, GalleryDetail, GalleryListItem, type GalleryRoutes, type GalleryService, PaginatedResult, RouteHandler, UpdateCategoryInput, UpdateGalleryInput, buildPaginatedResult, createCategoryService, createGalleryRoutes, createGalleryService, getFeaturedGalleries, getGalleryCount, getGalleryItems, getRecentGalleries };

package/dist/server/index.d.ts

@@ -0,0 +1,157 @@
+import { PaginatedResult, GalleryConfig, GalleryCategoryItem, CreateCategoryInput, UpdateCategoryInput, GalleryListItem, GalleryDetail, CreateGalleryInput, UpdateGalleryInput, RouteHandler } from '../types/index.js';
+export { ApiContext, ApiWrapper, GalleryI18nKey, GallerySlotName, PaginationMeta, PrismaLike, SortOrder } from '../types/index.js';
+export { C as CategoryInUseError, a as CategoryNotFoundError, G as GalleryError, b as GalleryNotFoundError, P as PermissionDeniedError, g as getGalleryConfig, s as setGalleryConfig } from '../errors-B9gzUsX-.js';
+import 'next/server';
+import 'react';
+
+/**
+ * pagination math 를 일관되게 처리. ballet 의 `buildPaginatedResult` 와 동일 시맨틱.
+ *
+ * - total === 0 일 때 totalPages = 0 (clamp 안 함; UI 에서 "결과 없음" 로 처리)
+ * - page > totalPages 여도 결과 자체는 caller 의 query 가 결정 — meta 만 계산
+ */
+declare function buildPaginatedResult<T>(items: T[], page: number, limit: number, total: number): PaginatedResult<T>;
+
+/**
+ * spec §9-2 의 categoryService.
+ *
+ * 호스트 독립성을 위해 Prisma delegate 는 `config.prisma[modelName]` 패턴으로 접근한다
+ * (modelName 기본값 = "galleryCategory", gallery 본체 modelName 기본값 = "gallery").
+ *
+ * remove() 는 `onDelete: Restrict` 보강 — 사전 gallery.count() 후 throw.
+ * admin UX 가 친화적 에러 메시지를 표시하도록 명시적 throw 를 사용.
+ */
+declare function createCategoryService(config: GalleryConfig): {
+    list: (opts?: {
+        isActive?: boolean;
+    }) => Promise<GalleryCategoryItem[]>;
+    getBySlug: (slug: string) => Promise<GalleryCategoryItem | null>;
+    getById: (id: string) => Promise<GalleryCategoryItem | null>;
+    create: (data: CreateCategoryInput) => Promise<GalleryCategoryItem>;
+    update: (id: string, data: UpdateCategoryInput) => Promise<GalleryCategoryItem>;
+    remove: (id: string) => Promise<void>;
+    reorder: (ids: string[]) => Promise<void>;
+};
+type CategoryService = ReturnType<typeof createCategoryService>;
+
+type SortKey$1 = "sortOrder" | "createdAt" | "updatedAt" | "caption";
+/**
+ * spec §9-2 의 createGalleryService.
+ *
+ * 핵심 규칙:
+ * - Prisma delegate 는 `config.prisma[config.modelName ?? "gallery"]` 패턴.
+ * - `include: { category: true }` 만 사용. **author include 금지** (Gallery 모델에 author 관계 없음, §3 호스트 독립 원칙).
+ * - 삭제 시 `config.storage` 가 isEnabled() true 면 collectKeys → deleteKeys.
+ * - `revalidate` 는 service 에서 호출하지 않음 (route handler 책임).
+ */
+declare function createGalleryService(config: GalleryConfig): {
+    listFeatured: (limit?: number) => Promise<GalleryListItem[]>;
+    listPublished: (limit?: number) => Promise<GalleryListItem[]>;
+    listPublishedByCategory: (categorySlug: string, limit?: number) => Promise<GalleryListItem[]>;
+    listAll: (opts: {
+        page?: number;
+        limit?: number;
+        categoryId?: string;
+        published?: boolean;
+        search?: string;
+        sortBy?: SortKey$1;
+    }) => Promise<PaginatedResult<GalleryListItem>>;
+    getById: (id: string) => Promise<GalleryDetail | null>;
+    create: (data: CreateGalleryInput, authorId: string) => Promise<GalleryDetail>;
+    createMany: (items: CreateGalleryInput[], authorId: string) => Promise<{
+        count: number;
+    }>;
+    update: (id: string, data: UpdateGalleryInput) => Promise<GalleryDetail>;
+    remove: (id: string) => Promise<void>;
+    removeMany: (ids: string[]) => Promise<{
+        count: number;
+    }>;
+    bulkUpdatePublished: (ids: string[], published: boolean) => Promise<{
+        count: number;
+    }>;
+    bulkUpdateFeatured: (ids: string[], featured: boolean) => Promise<{
+        count: number;
+    }>;
+    togglePublish: (id: string) => Promise<GalleryDetail>;
+    count: (opts?: {
+        published?: boolean;
+    }) => Promise<number>;
+    listRecent: (limit: number) => Promise<GalleryListItem[]>;
+};
+type GalleryService = ReturnType<typeof createGalleryService>;
+
+interface GalleryRoutes {
+    collection: {
+        GET: RouteHandler;
+        POST: RouteHandler;
+        DELETE: RouteHandler;
+    };
+    item: {
+        GET: RouteHandler;
+        PUT: RouteHandler;
+        DELETE: RouteHandler;
+    };
+    publishToggle: {
+        PATCH: RouteHandler;
+    };
+    bulk: {
+        POST: RouteHandler;
+        PATCH: RouteHandler;
+    };
+    categoryCollection: {
+        GET: RouteHandler;
+        POST: RouteHandler;
+    };
+    categoryItem: {
+        GET: RouteHandler;
+        PUT: RouteHandler;
+        DELETE: RouteHandler;
+    };
+}
+declare function createGalleryRoutes(config: GalleryConfig): GalleryRoutes;
+
+/**
+ * RSC loaders — spec §9-4.
+ *
+ * Server Components 가 직접 호출하는 함수. 각 함수는 service 의 대응 메서드를
+ * 얇게 감싸기만 한다. host 가 매번 `config` 를 주입해 explicit DI 를 유지한다
+ * (setGalleryConfig 의존 회피 — host 의 layout/page 에서 config 를 명시적으로
+ * 주입하는 것이 RSC graph 캐싱과 호환성 면에서 더 안전).
+ */
+
+type SortKey = "sortOrder" | "createdAt" | "updatedAt" | "caption";
+/**
+ * spec §9-4: `getGalleryItems(config, opts) → PaginatedResult<GalleryListItem>`
+ *
+ * admin 페이지의 RSC 가 직접 호출. fetch 라운드트립 없이 service 호출.
+ */
+declare function getGalleryItems(config: GalleryConfig, opts: {
+    page?: number;
+    limit?: number;
+    categoryId?: string;
+    published?: boolean;
+    search?: string;
+    sortBy?: SortKey;
+}): Promise<PaginatedResult<GalleryListItem>>;
+/**
+ * spec §9-4: `getFeaturedGalleries(config, limit?) → GalleryListItem[]`
+ *
+ * 홈 페이지의 모자이크 그리드 등 featured 영역에서 호출.
+ */
+declare function getFeaturedGalleries(config: GalleryConfig, limit?: number): Promise<GalleryListItem[]>;
+/**
+ * spec §9-4: `getRecentGalleries(config, limit) → GalleryListItem[]`
+ *
+ * 대시보드의 최근 항목 위젯 등에서 호출.
+ */
+declare function getRecentGalleries(config: GalleryConfig, limit: number): Promise<GalleryListItem[]>;
+/**
+ * spec §9-4: `getGalleryCount(config, opts?) → number`
+ *
+ * 대시보드 통계 등에서 호출. `opts.published` 미지정 시 전체 count.
+ */
+declare function getGalleryCount(config: GalleryConfig, opts?: {
+    published?: boolean;
+}): Promise<number>;
+
+export { type CategoryService, CreateCategoryInput, CreateGalleryInput, GalleryCategoryItem, GalleryConfig, GalleryDetail, GalleryListItem, type GalleryRoutes, type GalleryService, PaginatedResult, RouteHandler, UpdateCategoryInput, UpdateGalleryInput, buildPaginatedResult, createCategoryService, createGalleryRoutes, createGalleryService, getFeaturedGalleries, getGalleryCount, getGalleryItems, getRecentGalleries };