@leviosa-ai/detail-page-editor 0.7.3 → 0.8.0

package/components/detail-page/canvas-selection-tools.tsx

@@ -15,7 +15,11 @@ import { useTranslation } from "react-i18next";
 import { observer } from "./canvas-observer";
 import { CANVAS_MENU_ICONS } from "./canvas-context-menu";
 import { ImageCropOverlay, type CropElement } from "./image-crop-overlay";
-import { SelectionQuickToolbar, type QuickToolbarItem } from "./selection-quick-toolbar";
+import {
+  SelectionQuickToolbar,
+  useQuickPopoverPlacement,
+  type QuickToolbarItem,
+} from "./selection-quick-toolbar";
 import { selectedElementsDeep, type SelectableElement } from "./detail-page-selection";
 import { useEditorAi } from "./editor-ai-context";
 import {
@@ -39,7 +43,13 @@ type ToolStore = CanvasMenuStore & {
   getElementById?: (id: string) => SelectableElement | undefined;
 };
 
-/** 창 하나. 띠 바로 아래에 붙고, 안에 들어가는 것은 우측 패널이 쓰던 부품 그대로다. */
+/**
+ * 창 하나. 안에 들어가는 것은 우측 패널이 쓰던 부품 그대로다.
+ *
+ * 붙는 자리는 띠가 정한다(`useQuickPopoverPlacement`). 아래가 좁으면 위로 뒤집고,
+ * 높이는 그 자리에 실제로 남은 만큼으로 잘린다 — 넘치는 만큼은 스스로 스크롤한다.
+ * 60vh·520px 상한은 그대로 두되, 남은 자리가 더 좁으면 그쪽이 이긴다.
+ */
 function Popover({
   children,
   width = 360,
@@ -47,11 +57,16 @@ function Popover({
   children: React.ReactNode;
   width?: number;
 }) {
+  const { side, maxHeight } = useQuickPopoverPlacement();
   return (
     <div
       data-dp-quick-popover=""
-      style={{ width, maxHeight: "min(60vh, 520px)" }}
-      className="mt-1.5 overflow-y-auto rounded-dpe-xl border border-dpe-ink-200 bg-dpe-surface shadow-lg"
+      data-dp-quick-popover-side={side}
+      style={{ width, maxHeight: `min(60vh, 520px, ${maxHeight}px)` }}
+      className={[
+        "overflow-y-auto rounded-dpe-xl border border-dpe-ink-200 bg-dpe-surface shadow-lg",
+        side === "above" ? "absolute bottom-full left-0 mb-1.5" : "mt-1.5",
+      ].join(" ")}
     >
       {children}
     </div>

package/components/detail-page/detail-page-download-dialog.tsx

@@ -20,6 +20,10 @@ import {
 import type { ExportDocument } from "../../lib/detail-page-canvas/export/document-model";
 import { detectGifPages } from "../../lib/detail-page-canvas/export/gif-plan";
 import { isMp4EncodeSupported } from "../../lib/detail-page-canvas/export/mp4-support";
+import {
+  detailPageEditorProfile,
+  type DetailPageEditorFormat,
+} from "../../lib/detail-page/editor-profile";
 
 /**
  * hookable-style 다운로드 팝오버 — 다운로드 버튼 바로 아래에 떠서 파일 형식 / 등록
@@ -62,7 +66,7 @@ const PLATFORMS = [
   { value: "general", label: "일반(범용)" },
 ] as const;
 
-type Format = "png" | "jpeg" | "psd" | "svg" | "ai";
+type Format = DetailPageEditorFormat;
 type Scope = "all" | "current";
 type AnimationFormat = "webp" | "gif" | "mp4";
 
@@ -134,8 +138,9 @@ export const DetailPageDownloadDialog = observer(function DetailPageDownloadDial
   const { t } = useTranslation("branding");
   const host = useDetailPageHost();
   const s = store as ExportStoreLike;
+  const profile = detailPageEditorProfile();
   const [open, setOpen] = useState(false);
-  const [format, setFormat] = useState<Format>("png");
+  const [format, setFormat] = useState<Format>(profile.exports[0]);
   const [platform, setPlatform] = useState<string>("naver");
   const [scope, setScope] = useState<Scope>("all");
   const [single, setSingle] = useState(true);
@@ -366,11 +371,15 @@ export const DetailPageDownloadDialog = observer(function DetailPageDownloadDial
                   </span>
                 </SelectTrigger>
                 <SelectContent>
-                  <SelectItem value="png">PNG</SelectItem>
-                  <SelectItem value="jpeg">JPG</SelectItem>
-                  <SelectItem value="psd">{t("editor.formatPsd")}</SelectItem>
-                  <SelectItem value="ai">{t("editor.formatAi")}</SelectItem>
-                  <SelectItem value="svg">{t("editor.formatSvg")}</SelectItem>
+                  {profile.exports.map((value) => (
+                    <SelectItem key={value} value={value}>
+                      {value === "png"
+                        ? "PNG"
+                        : value === "jpeg"
+                          ? "JPG"
+                          : t(`editor.format${value[0].toUpperCase()}${value.slice(1)}`)}
+                    </SelectItem>
+                  ))}
                 </SelectContent>
               </Select>
             </div>

package/components/detail-page/detail-page-editor.tsx

@@ -30,6 +30,7 @@ import { collectFontRequests } from "@leviosa-ai/canvas/render/use-document-font
 import { ensureCanvasKey } from "../../lib/detail-page-canvas/canvas-key";
 import { loadEditorFont } from "../../lib/detail-page-canvas/editor-fonts";
 import { normalizeDocumentAssetSrcs } from "../../lib/detail-page/asset-bytes-url";
+import { selectDetailPageEditorProfile } from "../../lib/detail-page/editor-profile";
 import type { DocumentJson } from "@leviosa-ai/canvas/types";
 import { buildDetailPageSections } from "./detail-page-sidebar-sections";
 import { DetailPageProperties } from "./detail-page-properties-panel";
@@ -250,6 +251,7 @@ function buildQaSnapshot(
   document: LeviosaCanvasDocument,
   json: CanvasJson,
 ): TemplateQaSnapshot {
+  const slotBindings = document.slot_bindings ?? {};
   const cleanJson = stripQaOverlayElements(json);
   const pages = asArray(cleanJson.pages) as Array<Record<string, unknown>>;
   const elementById = new Map<string, { element: CanvasJsonElement; pageId?: string }>();
@@ -267,14 +269,14 @@ function buildQaSnapshot(
     }
   });
 
-  for (const [slot, binding] of Object.entries(document.slot_bindings)) {
+  for (const [slot, binding] of Object.entries(slotBindings)) {
     const list = slotByElementId.get(binding.element_id) ?? [];
     list.push(slot);
     slotByElementId.set(binding.element_id, list);
   }
 
   const lint: TemplateLintIssue[] = [];
-  const slots = Object.entries(document.slot_bindings)
+  const slots = Object.entries(slotBindings)
     .sort(([a], [b]) => a.localeCompare(b))
     .map(([slot, binding]) => {
       const target = elementById.get(binding.element_id);
@@ -365,7 +367,7 @@ function buildQaSnapshot(
   }
 
   for (const [slot, target] of slotsFromElements) {
-    if (!document.slot_bindings[slot]) {
+    if (!slotBindings[slot]) {
       lint.push({
         level: "info",
         title: "Unregistered slot marker",
@@ -450,6 +452,7 @@ export function DetailPageEditor({
   onBack,
   headerActions,
 }: DetailPageEditorProps) {
+  selectDetailPageEditorProfile(initialDocument);
   const { t } = useTranslation("branding");
   // 요금제 모달은 호스트가 꽂는다 — 편집기가 열지만 무엇을 얼마에 파는지는 앱이 안다.
   const { slots } = useDetailPageHost();

package/components/detail-page/detail-page-page-toolbar.tsx

@@ -18,6 +18,7 @@ import {
   requestSectionReauthor,
   subscribeSectionReauthorAvailability,
 } from "../../lib/detail-page/section-reauthor-bus";
+import { detailPageEditorProfile } from "../../lib/detail-page/editor-profile";
 
 /**
  * hookable-style per-section (per-page) floating quick toolbar.
@@ -94,17 +95,25 @@ export const DetailPagePageToolbar = observer(function DetailPagePageToolbar({
   );
   const s = store as StoreLike;
   const p = page as PageLike;
+  const profile = detailPageEditorProfile();
   const index = s.pages.findIndex((pg) => pg.id === p.id);
   const isFirst = index <= 0;
   const isLast = index === s.pages.length - 1;
   const canDelete = s.pages.length > 1;
+  const canAdd = s.pages.length < profile.maxPages;
 
   const addAfter = () => {
+    if (!canAdd) return;
     const ref = s.activePage ?? s.pages[index];
     const next = s.addPage({
       bleed: ref?.bleed ?? 0,
-      width: ref?.width ?? "auto",
-      height: ref?.height ?? "auto",
+      width:
+        profile.page.width === "document"
+          ? ref?.width ?? "auto"
+          : profile.page.width,
+      height: profile.page.fixed
+        ? profile.page.height
+        : ref?.height ?? profile.page.height,
     });
     next.setZIndex(index + 1);
   };
@@ -153,10 +162,18 @@ export const DetailPagePageToolbar = observer(function DetailPagePageToolbar({
       <IconButton label={t("detailPage.pageToolbar.moveDown")} onClick={() => p.setZIndex(index + 1)} disabled={isLast}>
         <ChevronDown size={17} />
       </IconButton>
-      <IconButton label={t("detailPage.pageToolbar.duplicate")} onClick={() => p.clone()}>
+      <IconButton
+        label={t("detailPage.pageToolbar.duplicate")}
+        onClick={() => p.clone()}
+        disabled={!canAdd}
+      >
         <Copy size={16} />
       </IconButton>
-      <IconButton label={t("detailPage.pageToolbar.addBelow")} onClick={addAfter}>
+      <IconButton
+        label={t("detailPage.pageToolbar.addBelow")}
+        onClick={addAfter}
+        disabled={!canAdd}
+      >
         <Plus size={17} />
       </IconButton>
 

package/components/detail-page/detail-page-properties-panel.tsx

@@ -94,6 +94,7 @@ import {
 } from "./ai-generate-panel";
 import { toHexColor } from "../../lib/detail-page/css-color";
 import { editorAssetBase } from "../../lib/detail-page/runtime-config";
+import { detailPageEditorProfile } from "../../lib/detail-page/editor-profile";
 import { setZ as setElementZ, zOrderOf } from "../../lib/detail-page/z-order";
 import {
   canDistribute,
@@ -2173,6 +2174,7 @@ const PageHeightSection = observer(function PageHeightSection({
   page?: PageLike;
 }) {
   const { t } = useTranslation("branding");
+  const profile = detailPageEditorProfile();
   if (!page) return null;
   const height = Math.round(num(page.computedHeight, MIN_SECTION_HEIGHT));
   const contentBottom = sectionContentBottom(page);
@@ -2180,7 +2182,13 @@ const PageHeightSection = observer(function PageHeightSection({
   // "사라진" 것처럼 보인다 — 지운 게 아니라 화면 밖으로 나간 것이다.
   const overflow = contentBottom > height;
   return (
-    <Section title={t("detailPage.properties.pageHeight")}>
+    <Section
+      title={t(
+        profile.wording === "section"
+          ? "detailPage.properties.pageHeight"
+          : "detailPage.properties.plateHeight",
+      )}
+    >
       <div className="flex items-center gap-1.5">
         <div className="min-w-0 flex-1">
           <NumberField
@@ -2222,11 +2230,12 @@ const PageInspector = observer(function PageInspector({
   dataGifCreditCost?: number;
 }) {
   const { t } = useTranslation("branding");
+  const profile = detailPageEditorProfile();
   const page = store.activePage ?? store.pages[0];
   const bg = str(page?.background, "#ffffff");
   return (
     <>
-      <PageHeightSection page={page} />
+      {profile.page.fixed ? null : <PageHeightSection page={page} />}
       <Section title={t("detailPage.properties.pageBackground")}>
         <FillControl value={bg} onChange={(c) => page?.set?.({ background: c })} />
         <p className="mt-2 text-xs text-dpe-ink-400">

package/components/detail-page/selection-quick-toolbar.tsx

@@ -13,7 +13,9 @@
  */
 
 import {
+  createContext,
   useCallback,
+  useContext,
   useEffect,
   useLayoutEffect,
   useRef,
@@ -42,6 +44,10 @@ const GAP = 10;
 const EDGE = 8;
 /** 띠의 대략 높이. 실측 전 첫 프레임에만 쓴다. */
 const BAR_HEIGHT = 40;
+/** 띠와 그 아래(또는 위) 창 사이의 여백(px). 클래스의 `mt-1.5`/`mb-1.5`와 같은 값이다. */
+const POPOVER_GAP = 6;
+/** 창이 이보다 낮아지면 접힌 것과 다름없다 — 스스로 스크롤하게 두고 이 높이는 지킨다. */
+const POPOVER_MIN = 200;
 
 /**
  * 띠의 자리. 위가 모자라면 아래로 뒤집고, 좌우는 작업 영역 안으로 민다.
@@ -63,6 +69,40 @@ export function toolbarPosition(
   };
 }
 
+/**
+ * 창이 띠의 위에 설지 아래에 설지, 그리고 얼마나 높을 수 있는지.
+ *
+ * 자리 계산이 재는 것은 **띠**뿐이라(`size`가 `barRef` 것이다) 창은 지금까지 아무에게도
+ * 안 물어보고 띠 아래로 흘렀다. 상세페이지 사진은 대개 한 섹션을 통째로 덮어서 띠가
+ * 작업 영역 맨 아래에 붙는데, 그러면 창은 통째로 화면 밖에 그려진다 — 열려 있고,
+ * 접근성 트리에도 있고, 눈에는 없다. 그 자리에서는 위로 뒤집는다.
+ */
+export function popoverPlacement(
+  barTop: number,
+  barHeight: number,
+  hostHeight: number,
+): { side: "above" | "below"; maxHeight: number } {
+  const below = hostHeight - (barTop + barHeight) - POPOVER_GAP - EDGE;
+  const above = barTop - POPOVER_GAP - EDGE;
+  const side = below >= above ? "below" : "above";
+  return {
+    side,
+    maxHeight: Math.max(POPOVER_MIN, side === "below" ? below : above),
+  };
+}
+
+export type QuickPopoverPlacement = ReturnType<typeof popoverPlacement>;
+
+const QuickPopoverContext = createContext<QuickPopoverPlacement>({
+  side: "below",
+  maxHeight: 520,
+});
+
+/** 창을 그리는 쪽이 자기 자리를 집는 곳. 띠 밖에서 부르면 기본값(아래)이다. */
+export function useQuickPopoverPlacement(): QuickPopoverPlacement {
+  return useContext(QuickPopoverContext);
+}
+
 export function SelectionQuickToolbar({
   els,
   items,
@@ -179,6 +219,7 @@ export function SelectionQuickToolbar({
     { width: host.clientWidth, height: host.clientHeight },
     size,
   );
+  const placement = popoverPlacement(top, size.height, host.clientHeight);
 
   return (
     <div
@@ -217,7 +258,9 @@ export function SelectionQuickToolbar({
           </div>
         ))}
       </div>
-      {children}
+      <QuickPopoverContext.Provider value={placement}>
+        {children}
+      </QuickPopoverContext.Provider>
     </div>
   );
 }

package/config/detail-page-bundle-font-tags.json

@@ -35,5 +35,13 @@
   "samlip-hopang-outline": ["heading", "outline", "rounded"],
   "paperlogy": ["heading", "body", "gothic", "angular"],
   "freesentation": ["body", "gothic"],
-  "diphylleia": ["heading", "myeongjo"]
+  "diphylleia": ["heading", "myeongjo"],
+  "jost": ["heading", "gothic", "rounded"],
+  "bebas-neue": ["heading", "angular"],
+  "anton": ["heading", "angular"],
+  "archivo-black": ["heading", "gothic"],
+  "oswald": ["heading", "gothic", "angular"],
+  "playfair-display": ["heading", "myeongjo", "angular"],
+  "eb-garamond": ["body", "myeongjo"],
+  "parisienne": ["handwriting", "rounded"]
 }

package/i18n/en.json

@@ -112,6 +112,7 @@
         "saveToMyShapes": "Save to brand shapes",
         "aiShapeEdit": "AI shape editing",
         "pageHeight": "Section height",
+        "plateHeight": "Plate height",
         "pageHeightFit": "Fit to content",
         "pageHeightOverflow": "Content reaches {{px}}px and overflows the bottom of this section.",
         "pageHeightHint": "You can also drag the handle below the canvas.",

package/i18n/ko.json

@@ -112,6 +112,7 @@
         "saveToMyShapes": "브랜드 도형에 저장",
         "aiShapeEdit": "AI 도형 편집",
         "pageHeight": "섹션 높이",
+        "plateHeight": "판 높이",
         "pageHeightFit": "내용에 맞추기",
         "pageHeightOverflow": "내용이 {{px}}px까지 내려가 화면 아래로 넘칩니다.",
         "pageHeightHint": "캔버스 아래 손잡이를 끌어서도 바꿀 수 있어요.",

package/lib/cardnews/font-loader.ts

@@ -8,12 +8,12 @@
 
 import {
   FONT_CATALOG,
-  LEVIOSA_KONVA_VERSION,
+  LEVIOSA_CANVAS_FONTS_VERSION,
   catalogFont,
   fontLoadSampleForText,
   resolveFontFamily,
   type CatalogFont,
-} from "@leviosa-ai/konva";
+} from "@leviosa-ai/canvas/fonts";
 
 import { editorAssetBase } from "../detail-page/runtime-config";
 
@@ -84,7 +84,7 @@ const COMMON_HANGUL_SAMPLE =
  * `/render-fonts` 라, 아무것도 안 부른 소비자에게는 주소가 그대로다.
  */
 function bundleUrl(path: string): string {
-  return `${editorAssetBase("fontBundle")}${path}?v=${LEVIOSA_KONVA_VERSION}`;
+  return `${editorAssetBase("fontBundle")}${path}?v=${LEVIOSA_CANVAS_FONTS_VERSION}`;
 }
 
 const localFontCssUrl = () => bundleUrl("/font-css.css");

package/lib/detail-page/editor-profile.ts

@@ -0,0 +1,43 @@
+import type { LeviosaCanvasDocument } from "../../types/detail-page-canvas";
+
+export type DetailPageEditorFormat = "png" | "jpeg" | "psd" | "svg" | "ai";
+
+export type DetailPageEditorProfile = {
+  page: {
+    width: "document" | number;
+    height: "auto" | number;
+    fixed: boolean;
+  };
+  maxPages: number;
+  exports: readonly DetailPageEditorFormat[];
+  wording: "section" | "plate";
+};
+
+const DETAIL_PAGE_PROFILE: DetailPageEditorProfile = {
+  page: { width: "document", height: "auto", fixed: false },
+  maxPages: Number.POSITIVE_INFINITY,
+  exports: ["png", "jpeg", "psd", "ai", "svg"],
+  wording: "section",
+};
+
+const CAROUSEL_PROFILE: DetailPageEditorProfile = {
+  page: { width: 1080, height: 1350, fixed: true },
+  maxPages: 10,
+  exports: ["jpeg"],
+  wording: "plate",
+};
+
+let current = DETAIL_PAGE_PROFILE;
+
+/** 문서 종류를 읽는 유일한 자리. 종류가 없으면 기존 상세페이지 설정을 쓴다. */
+export function selectDetailPageEditorProfile(
+  document: Pick<LeviosaCanvasDocument, "kind">,
+): DetailPageEditorProfile {
+  current = document.kind === "carousel" ? CAROUSEL_PROFILE : DETAIL_PAGE_PROFILE;
+  return current;
+}
+
+/** 편집기 입구에서 고른 설정표. 안쪽 코드는 문서 종류 대신 이 값만 읽는다. */
+export function detailPageEditorProfile(): DetailPageEditorProfile {
+  return current;
+}

package/lib/detail-page/runtime-config.ts

@@ -41,7 +41,7 @@ export type DetailPageEditorEndpoints = {
 
 export type DetailPageEditorAssets = {
   /**
-   * `@leviosa-ai/konva` 의 `leviosa-konva-fonts` 가 구워 두는 폰트 번들의 뿌리.
+   * `@leviosa-ai/canvas` 의 `leviosa-konva-fonts` 가 구워 두는 폰트 번들의 뿌리.
    * 기본 `${basePath}/render-fonts`.
    */
   fontBundle?: string;

package/lib/detail-page-canvas/gif-web-fonts.ts

@@ -13,7 +13,7 @@
  * 그냥 비워 보낸다 — 그 경우 서버의 폴백 폰트로 그려진다.
  */
 
-import { LEVIOSA_KONVA_VERSION } from "@leviosa-ai/konva";
+import { LEVIOSA_CANVAS_FONTS_VERSION } from "@leviosa-ai/canvas/fonts";
 
 import {
   closestDetailPageFontWeight,
@@ -78,7 +78,7 @@ export function resolveGifWebFonts(
     const weight = closestEditorFontWeight(editorFont, face.weight);
     const url = fontBundleAbsoluteUrl(
       origin,
-      `/family-css/${slug}-${weight}.css?v=${LEVIOSA_KONVA_VERSION}`,
+      `/family-css/${slug}-${weight}.css?v=${LEVIOSA_CANVAS_FONTS_VERSION}`,
     );
     // 번들이 상대 경로로 설정돼 있고 오리진도 http 면 서버가 못 받아간다 — 건너뛴다.
     if (!url) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviosa-ai/detail-page-editor",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Leviosa detail-page editor shell. Source-only: consumers compile it through Next transpilePackages. Every app coupling (sourcing server, brand store, cache keys, toast) arrives through the DetailPageHost interface, and every URL it fetches comes from configureDetailPageEditor.",
   "type": "module",
   "license": "UNLICENSED",
@@ -66,8 +66,7 @@
     "woff2-encoder": "2.0.0"
   },
   "peerDependencies": {
-    "@leviosa-ai/canvas": "^0.1.4",
-    "@leviosa-ai/konva": "^0.8.0",
+    "@leviosa-ai/canvas": "0.3.0",
     "@tanstack/react-query": "^5.100.3",
     "konva": "^10.0.0",
     "lucide-react": "^0.563.0 || ^1.0.0",

package/types/detail-page-canvas.ts

@@ -7,13 +7,14 @@ export type CanvasSlotBinding = {
 export type LeviosaCanvasDocument = {
   schema_version: "leviosa-canvas-detail-page-v1";
   renderer: "leviosa_canvas_detail_page";
+  kind?: "detail-page" | "carousel";
   template_id?: string | null;
   template_version?: number | null;
   canvas: {
     width: number;
     background: string;
   };
-  slot_bindings: Record<string, CanvasSlotBinding>;
+  slot_bindings?: Record<string, CanvasSlotBinding>;
   canvas_json: Record<string, unknown>;
   fonts: Array<Record<string, unknown>>;
   source: "leviosa_canvas_editor";