@withwiz/gallery 0.1.0

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@withwiz/gallery",
+  "version": "0.1.0",
+  "description": "Headless gallery module — Prisma 7 + Next 16, host-agnostic. Drop-in admin + public surface.",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.mjs",
+      "require": "./dist/components/index.js"
+    },
+    "./components/gallery.css": "./dist/components/gallery.css",
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.mjs",
+      "require": "./dist/hooks/index.js"
+    },
+    "./validators": {
+      "types": "./dist/validators/index.d.ts",
+      "import": "./dist/validators/index.mjs",
+      "require": "./dist/validators/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "require": "./dist/types/index.js"
+    },
+    "./presets/ballet": {
+      "types": "./dist/presets/ballet.d.ts",
+      "import": "./dist/presets/ballet.mjs",
+      "require": "./dist/presets/ballet.js"
+    }
+  },
+  "files": ["dist", "prisma", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "next": ">=16",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "zod": ">=4",
+    "@prisma/client": ">=7",
+    "clsx": ">=2",
+    "tailwind-merge": ">=3",
+    "sonner": ">=2"
+  },
+  "peerDependenciesMeta": {
+    "sonner": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@types/react": "^19.2.14",
+    "@testing-library/react": "^16.3.2",
+    "@vitejs/plugin-react": "^6.0.1",
+    "clsx": "^2.1.1",
+    "jsdom": "^29.1.1",
+    "next": "^16.2.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5",
+    "zod": "^4.4.3"
+  }
+}

package/prisma/gallery.schema.prisma

@@ -0,0 +1,62 @@
+// @withwiz/gallery-kit 가 제공하는 partial Prisma schema.
+// host 의 prisma/ 디렉토리에 multi-file 로 머지한다 (Prisma 7 multi-file schema GA).
+//
+// 사용법:
+//   1) host package.json 에 prisma schema 디렉토리 설정
+//        "prisma": { "schema": "./prisma" }
+//   2) host 의 prisma/ 디렉토리에 자기 schema.prisma 와 함께 이 파일을 복사 또는 symlink
+//        cp node_modules/@withwiz/gallery-kit/prisma/gallery.schema.prisma prisma/
+//   3) prisma generate / migrate 실행
+//        npx prisma generate
+//        npx prisma migrate dev --create-only
+//
+// Host-independence 원칙:
+//   - 본 partial 은 host 의 User/Admin/Account 등 어떤 모델도 가정하지 않는다.
+//   - Gallery 모델은 authorId 를 String 컬럼으로만 두며, Prisma 의 @relation 을 정의하지 않는다.
+//     → host 모델 이름이 무엇이든 (User/Admin/Account/Member) Prisma validate 가 통과한다.
+//     → 작성자 표시가 필요한 admin UI 는 application layer 가 별도 query 로 join 한다.
+//   - 카테고리 삭제 시 cascade 위험 차단: Gallery.category 의 onDelete = Restrict.
+//     사용 중 카테고리는 CategoryAdminManager 가 삭제 버튼을 비활성화한다.
+
+model GalleryCategory {
+  id        String   @id @default(cuid())
+  slug      String   @unique
+  labelKo   String   @map("label_ko")
+  labelEn   String?  @map("label_en")
+  sortOrder Int      @default(0) @map("sort_order")
+  isActive  Boolean  @default(true) @map("is_active")
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  galleries Gallery[]
+
+  @@index([isActive, sortOrder])
+  @@map("gallery_categories")
+}
+
+model Gallery {
+  id       String  @id @default(cuid())
+  imageUrl String  @map("image_url")
+  imageKey String? @map("image_key")
+  caption  String?
+
+  categoryId String          @map("category_id")
+  category   GalleryCategory @relation(fields: [categoryId], references: [id], onDelete: Restrict, onUpdate: Cascade)
+
+  sortOrder Int     @default(0) @map("sort_order")
+  featured  Boolean @default(false)
+  published Boolean @default(false)
+
+  // Host 의 User/Admin/Account 모델 이름을 가정하지 않기 위해 관계 정의 없이 컬럼만 둔다.
+  // 작성자 정보가 필요한 경우 application layer 가 별도 query 로 join.
+  authorId String @map("author_id")
+
+  createdAt DateTime @default(now()) @map("created_at")
+  updatedAt DateTime @updatedAt @map("updated_at")
+
+  @@index([published, sortOrder])
+  @@index([published, featured])
+  @@index([published, categoryId])
+  @@index([authorId])
+  @@map("galleries")
+}

package/prisma/migrations/2026-05-24-enum-to-table.sql

@@ -0,0 +1,65 @@
+-- ═══════════════════════════════════════════════════════════════════════════
+-- @withwiz/gallery-kit — ballet enum → table backfill migration
+-- ───────────────────────────────────────────────────────────────────────────
+-- 1회용 마이그레이션 스크립트.
+-- ballet 의 기존 schema:
+--   enum GalleryCategory { PERFORMANCE | REHEARSAL | ACTIVITY | ARTIST }
+--   galleries.category  ← enum 컬럼
+-- 본 패키지의 새 schema:
+--   gallery_categories  ← 4 row seed
+--   galleries.category_id  ← cuid FK
+--
+-- ───────────────────────────────────────────────────────────────────────────
+-- 실행 절차 (ballet 환경):
+--   1. host prisma/ 에 본 패키지의 gallery.schema.prisma 를 머지.
+--   2. `npx prisma migrate dev --create-only` 로 마이그레이션 SQL 자동 생성.
+--      Prisma 가 만들어준 migration.sql 에서 `DROP COLUMN category` /
+--      `DROP TYPE "GalleryCategory"` 부분은 수동으로 제거하고, 본 파일의 SQL 을
+--      그 위치에 삽입 (즉, gallery_categories 테이블 / categoryId 컬럼 생성 직후,
+--      enum 컬럼 DROP 이전에 실행되어야 한다).
+--   3. `npx prisma migrate dev` 로 마이그레이션 실행 + 검증.
+--   4. 검증 통과 시 별도 후속 마이그레이션에서 enum 컬럼/타입을 DROP.
+-- ───────────────────────────────────────────────────────────────────────────
+
+BEGIN;
+
+-- ─── 1) 새 테이블 / 컬럼 생성 ──────────────────────────────────────────────
+-- gallery_categories 와 galleries.category_id 컬럼은 prisma migrate 결과로
+-- 이미 생성되어 있다고 가정 (위 실행 절차 2 단계).
+
+-- ─── 2) 4개 카테고리 seed (slug = 기존 enum value) ─────────────────────────
+INSERT INTO gallery_categories (id, slug, label_ko, label_en, sort_order, is_active, created_at, updated_at) VALUES
+  ('cat_performance', 'PERFORMANCE', '공연',     'Performance', 0, true, NOW(), NOW()),
+  ('cat_rehearsal',   'REHEARSAL',   '연습',     'Rehearsal',   1, true, NOW(), NOW()),
+  ('cat_activity',    'ACTIVITY',    '활동',     'Activity',    2, true, NOW(), NOW()),
+  ('cat_artist',      'ARTIST',      '아티스트', 'Artist',      3, true, NOW(), NOW());
+
+-- ─── 3) 기존 galleries.category (enum) → category_id 백필 ──────────────────
+-- 전제: enum 컬럼이 아직 살아있어야 backfill 가능.
+-- prisma migrate 가 enum 컬럼 DROP 을 같은 트랜잭션에 만들었다면, 위 실행 절차
+-- 2 단계에서 DROP 부분을 잘라내고 본 SQL 다음에 별도 마이그레이션으로 분리.
+
+UPDATE galleries g
+SET category_id = c.id
+FROM gallery_categories c
+WHERE c.slug = g.category::text;
+
+-- ─── 4) 검증 ───────────────────────────────────────────────────────────────
+-- 미매핑 row 가 있으면 트랜잭션 롤백.
+DO $$
+DECLARE
+  unmapped_count INT;
+BEGIN
+  SELECT COUNT(*) INTO unmapped_count FROM galleries WHERE category_id IS NULL;
+  IF unmapped_count > 0 THEN
+    RAISE EXCEPTION 'Unmapped gallery rows: % — backfill 실패. enum 값과 slug 매핑을 확인하라.', unmapped_count;
+  END IF;
+END $$;
+
+COMMIT;
+
+-- ───────────────────────────────────────────────────────────────────────────
+-- 후속 마이그레이션 (별도 파일 / 별도 트랜잭션으로 실행):
+--   ALTER TABLE galleries DROP COLUMN category;
+--   DROP TYPE "GalleryCategory";
+-- ───────────────────────────────────────────────────────────────────────────