ima2-gen 1.1.7 → 1.1.9

package/lib/cardNewsPlannerSchema.ts

@@ -0,0 +1,259 @@
+export const CARD_NEWS_TEXT_KINDS = ["headline", "body", "caption", "cta", "badge", "number"];
+export const CARD_NEWS_RENDER_MODES = ["in-image", "ui-only"];
+export const CARD_NEWS_PLACEMENTS = [
+  "top-left",
+  "top-center",
+  "top-right",
+  "center-left",
+  "center",
+  "center-right",
+  "bottom-left",
+  "bottom-center",
+  "bottom-right",
+  "free",
+];
+export const CARD_NEWS_HIERARCHIES = ["primary", "secondary", "supporting"];
+export const CARD_NEWS_TEXT_SOURCES = ["planner", "user"];
+
+const TEXT_FIELD_SCHEMA = {
+  type: "object",
+  additionalProperties: false,
+  required: [
+    "id",
+    "kind",
+    "text",
+    "renderMode",
+    "placement",
+    "slotId",
+    "hierarchy",
+    "maxChars",
+    "language",
+    "source",
+  ],
+  properties: {
+    id: { type: "string" },
+    kind: { type: "string", enum: CARD_NEWS_TEXT_KINDS },
+    text: { type: "string" },
+    renderMode: { type: "string", enum: CARD_NEWS_RENDER_MODES },
+    placement: { type: "string", enum: CARD_NEWS_PLACEMENTS },
+    slotId: { type: ["string", "null"] },
+    hierarchy: { type: "string", enum: CARD_NEWS_HIERARCHIES },
+    maxChars: { type: ["integer", "null"] },
+    language: { type: ["string", "null"] },
+    source: { type: "string", enum: CARD_NEWS_TEXT_SOURCES },
+  },
+};
+
+export const CARD_NEWS_PLANNER_SCHEMA = {
+  type: "object",
+  additionalProperties: false,
+  required: ["title", "topic", "cards"],
+  properties: {
+    title: { type: "string" },
+    topic: { type: "string" },
+    audience: { type: "string" },
+    goal: { type: "string" },
+    cards: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["order", "role", "headline", "body", "visualPrompt", "textFields", "references", "locked"],
+        properties: {
+          order: { type: "integer" },
+          role: { type: "string" },
+          headline: { type: "string" },
+          body: { type: "string" },
+          visualPrompt: { type: "string" },
+          textFields: { type: "array", items: TEXT_FIELD_SCHEMA },
+          references: { type: "array", items: { type: "string" } },
+          locked: { type: "boolean" },
+        },
+      },
+    },
+  },
+};
+
+function asText(value, fallback = "") {
+  return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+
+function detectBriefLanguage(input: any = {}) {
+  const text = [input.topic, input.audience, input.goal, input.contentBrief].filter(Boolean).join(" ");
+  if (/[가-힣]/.test(text)) return "ko";
+  if (/[A-Za-z]/.test(text)) return "en";
+  return "und";
+}
+
+function fallbackCopy(input: any = {}, kind = "body") {
+  const lang = detectBriefLanguage(input);
+  const topic = asText(input.topic, asText(input.title, "Card news"));
+  const goal = asText(input.goal, topic);
+  const brief = asText(input.contentBrief, goal);
+  if (kind === "headline") return topic;
+  if (lang === "ko") return brief || `${topic} 핵심 내용을 정리합니다.`;
+  if (lang === "en") return brief || `Summarize the key point for ${topic}.`;
+  return brief || topic;
+}
+
+function normalizeTextField(field, index) {
+  if (!field || typeof field !== "object") return null;
+  const text = asText(field.text);
+  if (!text) return null;
+  return {
+    id: asText(field.id, `tf_${index + 1}`),
+    kind: CARD_NEWS_TEXT_KINDS.includes(field.kind) ? field.kind : "body",
+    text,
+    renderMode: CARD_NEWS_RENDER_MODES.includes(field.renderMode) ? field.renderMode : "in-image",
+    placement: CARD_NEWS_PLACEMENTS.includes(field.placement) ? field.placement : "free",
+    slotId: typeof field.slotId === "string" && field.slotId.trim() ? field.slotId.trim() : null,
+    hierarchy: CARD_NEWS_HIERARCHIES.includes(field.hierarchy) ? field.hierarchy : "supporting",
+    maxChars: Number.isInteger(field.maxChars) ? field.maxChars : null,
+    language: typeof field.language === "string" && field.language.trim() ? field.language.trim() : null,
+    source: CARD_NEWS_TEXT_SOURCES.includes(field.source) ? field.source : "planner",
+  };
+}
+
+function normalizeTextFields(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map(normalizeTextField).filter(Boolean);
+}
+
+function stripExactVisibleText(visualPrompt, textFields) {
+  let next = asText(visualPrompt);
+  for (const field of textFields) {
+    const text = asText(field.text);
+    if (text.length >= 4 && next.includes(text)) {
+      next = next.split(text).join("visible text box");
+    }
+  }
+  return next.trim();
+}
+
+function normalizeCard(card, role, index, input) {
+  const topic = asText(input.topic, "Card news");
+  const textFields = normalizeTextFields(card?.textFields);
+  return {
+    order: index + 1,
+    role: role.role,
+    headline: asText(card?.headline, index === 0 ? topic : fallbackCopy(input, "headline")),
+    body: asText(card?.body, fallbackCopy(input, "body")),
+    visualPrompt: stripExactVisibleText(
+      asText(card?.visualPrompt, `${asText(role.promptHint, role.role)}, ${topic}`),
+      textFields,
+    ),
+    textFields,
+    references: Array.isArray(card?.references)
+      ? card.references.filter((ref) => typeof ref === "string")
+      : [],
+    locked: false,
+  };
+}
+
+export function repairPlannerOutput(output, input: any = {}) {
+  const roles = input.roleTemplate?.roles || [];
+  const cards = roles.map((role, index) => {
+    const original = Array.isArray(output?.cards) ? output.cards[index] : null;
+    return normalizeCard(original, role, index, input);
+  });
+  return {
+    ok: true,
+    repaired: true,
+    errors: [],
+    plan: {
+      title: asText(output?.title, asText(input.topic, "Untitled card news")),
+      topic: asText(output?.topic, asText(input.topic, "Untitled card news")),
+      audience: asText(output?.audience, asText(input.audience)),
+      goal: asText(output?.goal, asText(input.goal)),
+      cards,
+    },
+  };
+}
+
+function validateTextField(field, path, errors) {
+  if (!field || typeof field !== "object") {
+    errors.push(`${path} must be object`);
+    return;
+  }
+  if (typeof field.id !== "string") errors.push(`${path}.id must be string`);
+  if (!CARD_NEWS_TEXT_KINDS.includes(field.kind)) errors.push(`${path}.kind invalid`);
+  if (typeof field.text !== "string") errors.push(`${path}.text must be string`);
+  if (typeof field.text === "string" && !field.text.trim()) errors.push(`${path}.text must not be empty`);
+  if (!CARD_NEWS_RENDER_MODES.includes(field.renderMode)) errors.push(`${path}.renderMode invalid`);
+  if (!CARD_NEWS_PLACEMENTS.includes(field.placement)) errors.push(`${path}.placement invalid`);
+  if (!(typeof field.slotId === "string" || field.slotId === null)) errors.push(`${path}.slotId invalid`);
+  if (!CARD_NEWS_HIERARCHIES.includes(field.hierarchy)) errors.push(`${path}.hierarchy invalid`);
+  if (!(Number.isInteger(field.maxChars) || field.maxChars === null)) errors.push(`${path}.maxChars invalid`);
+  if (!(typeof field.language === "string" || field.language === null)) errors.push(`${path}.language invalid`);
+  if (!CARD_NEWS_TEXT_SOURCES.includes(field.source)) errors.push(`${path}.source invalid`);
+}
+
+export function validatePlannerOutput(output, roleTemplate) {
+  const errors = [];
+  if (!output || typeof output !== "object" || Array.isArray(output)) {
+    return { ok: false, repaired: false, errors: ["output must be an object"] };
+  }
+  if (typeof output.title !== "string") errors.push("title must be a string");
+  if (typeof output.topic !== "string") errors.push("topic must be a string");
+  if (!Array.isArray(output.cards)) errors.push("cards must be an array");
+
+  const roles = roleTemplate?.roles || [];
+  if (Array.isArray(output.cards) && output.cards.length !== roles.length) {
+    errors.push("cards length must match role template");
+  }
+
+  const cards = Array.isArray(output.cards) ? output.cards : [];
+  cards.forEach((card, index) => {
+    const expected = roles[index];
+    if (!card || typeof card !== "object") {
+      errors.push(`card ${index + 1} must be an object`);
+      return;
+    }
+    if (card.order !== index + 1) errors.push(`card ${index + 1} order mismatch`);
+    if (expected && card.role !== expected.role) errors.push(`card ${index + 1} role mismatch`);
+    for (const key of ["headline", "body", "visualPrompt"]) {
+      if (typeof card[key] !== "string") errors.push(`card ${index + 1} ${key} must be string`);
+    }
+    if (!Array.isArray(card.textFields)) errors.push(`card ${index + 1} textFields must be array`);
+    if (Array.isArray(card.textFields)) {
+      card.textFields.forEach((field, fieldIndex) =>
+        validateTextField(field, `card ${index + 1} textFields ${fieldIndex + 1}`, errors));
+      for (const field of card.textFields) {
+        if (
+          field?.renderMode === "in-image" &&
+          typeof field.text === "string" &&
+          field.text.trim().length >= 4 &&
+          typeof card.visualPrompt === "string" &&
+          card.visualPrompt.includes(field.text.trim())
+        ) {
+          errors.push(`card ${index + 1} visualPrompt must not duplicate exact visible text`);
+        }
+      }
+    }
+    if (!Array.isArray(card.references)) errors.push(`card ${index + 1} references must be array`);
+    if (card.locked !== false) errors.push(`card ${index + 1} locked must be false`);
+  });
+
+  if (errors.length) return { ok: false, repaired: false, errors };
+  return {
+    ok: true,
+    repaired: false,
+    errors: [],
+    plan: {
+      title: output.title.trim(),
+      topic: output.topic.trim(),
+      audience: asText(output.audience),
+      goal: asText(output.goal),
+      cards: cards.map((card) => ({
+        order: card.order,
+        role: card.role,
+        headline: card.headline.trim(),
+        body: card.body.trim(),
+        visualPrompt: card.visualPrompt.trim(),
+        textFields: normalizeTextFields(card.textFields),
+        references: card.references.filter((ref) => typeof ref === "string"),
+        locked: false,
+      })),
+    },
+  };
+}

package/lib/cardNewsRoleTemplateStore.js

@@ -1,47 +1,45 @@
 const ROLE_TEMPLATES = [
-  {
-    id: "short-3",
-    name: "Short 3",
-    defaultCount: 3,
-    roles: [
-      { role: "hook", required: true, promptHint: "strong opening card", preferredSlots: ["title", "visual"] },
-      { role: "core", required: true, promptHint: "main explanation card", preferredSlots: ["visual", "body"] },
-      { role: "cta", required: true, promptHint: "clear call to action card", preferredSlots: ["cta"] },
-    ],
-  },
-  {
-    id: "mid-5",
-    name: "Mid 5",
-    defaultCount: 5,
-    roles: [
-      { role: "cover", required: true, promptHint: "cover card with strong headline", preferredSlots: ["title", "visual"] },
-      { role: "problem", required: true, promptHint: "problem framing card", preferredSlots: ["title", "body"] },
-      { role: "insight", required: true, promptHint: "insight or solution card", preferredSlots: ["visual", "body"] },
-      { role: "example", required: true, promptHint: "example or proof card", preferredSlots: ["visual", "body"] },
-      { role: "cta", required: true, promptHint: "closing call to action card", preferredSlots: ["cta"] },
-    ],
-  },
-  {
-    id: "long-8",
-    name: "Long 8",
-    defaultCount: 8,
-    roles: [
-      { role: "cover", required: true, promptHint: "cover card", preferredSlots: ["title"] },
-      { role: "problem", required: true, promptHint: "problem card", preferredSlots: ["body"] },
-      { role: "data", required: true, promptHint: "data card", preferredSlots: ["visual"] },
-      { role: "tip1", required: true, promptHint: "first tip card", preferredSlots: ["body"] },
-      { role: "tip2", required: true, promptHint: "second tip card", preferredSlots: ["body"] },
-      { role: "example", required: true, promptHint: "example card", preferredSlots: ["visual"] },
-      { role: "summary", required: true, promptHint: "summary card", preferredSlots: ["body"] },
-      { role: "cta", required: true, promptHint: "call to action card", preferredSlots: ["cta"] },
-    ],
-  },
+    {
+        id: "short-3",
+        name: "Short 3",
+        defaultCount: 3,
+        roles: [
+            { role: "hook", required: true, promptHint: "strong opening card", preferredSlots: ["title", "visual"] },
+            { role: "core", required: true, promptHint: "main explanation card", preferredSlots: ["visual", "body"] },
+            { role: "cta", required: true, promptHint: "clear call to action card", preferredSlots: ["cta"] },
+        ],
+    },
+    {
+        id: "mid-5",
+        name: "Mid 5",
+        defaultCount: 5,
+        roles: [
+            { role: "cover", required: true, promptHint: "cover card with strong headline", preferredSlots: ["title", "visual"] },
+            { role: "problem", required: true, promptHint: "problem framing card", preferredSlots: ["title", "body"] },
+            { role: "insight", required: true, promptHint: "insight or solution card", preferredSlots: ["visual", "body"] },
+            { role: "example", required: true, promptHint: "example or proof card", preferredSlots: ["visual", "body"] },
+            { role: "cta", required: true, promptHint: "closing call to action card", preferredSlots: ["cta"] },
+        ],
+    },
+    {
+        id: "long-8",
+        name: "Long 8",
+        defaultCount: 8,
+        roles: [
+            { role: "cover", required: true, promptHint: "cover card", preferredSlots: ["title"] },
+            { role: "problem", required: true, promptHint: "problem card", preferredSlots: ["body"] },
+            { role: "data", required: true, promptHint: "data card", preferredSlots: ["visual"] },
+            { role: "tip1", required: true, promptHint: "first tip card", preferredSlots: ["body"] },
+            { role: "tip2", required: true, promptHint: "second tip card", preferredSlots: ["body"] },
+            { role: "example", required: true, promptHint: "example card", preferredSlots: ["visual"] },
+            { role: "summary", required: true, promptHint: "summary card", preferredSlots: ["body"] },
+            { role: "cta", required: true, promptHint: "call to action card", preferredSlots: ["cta"] },
+        ],
+    },
 ];
-
 export function listRoleTemplates() {
-  return ROLE_TEMPLATES;
+    return ROLE_TEMPLATES;
 }
-
 export function getRoleTemplate(roleTemplateId = "mid-5") {
-  return ROLE_TEMPLATES.find((t) => t.id === roleTemplateId) || ROLE_TEMPLATES[1];
+    return ROLE_TEMPLATES.find((t) => t.id === roleTemplateId) || ROLE_TEMPLATES[1];
 }

package/lib/cardNewsRoleTemplateStore.ts

@@ -0,0 +1,47 @@
+const ROLE_TEMPLATES = [
+  {
+    id: "short-3",
+    name: "Short 3",
+    defaultCount: 3,
+    roles: [
+      { role: "hook", required: true, promptHint: "strong opening card", preferredSlots: ["title", "visual"] },
+      { role: "core", required: true, promptHint: "main explanation card", preferredSlots: ["visual", "body"] },
+      { role: "cta", required: true, promptHint: "clear call to action card", preferredSlots: ["cta"] },
+    ],
+  },
+  {
+    id: "mid-5",
+    name: "Mid 5",
+    defaultCount: 5,
+    roles: [
+      { role: "cover", required: true, promptHint: "cover card with strong headline", preferredSlots: ["title", "visual"] },
+      { role: "problem", required: true, promptHint: "problem framing card", preferredSlots: ["title", "body"] },
+      { role: "insight", required: true, promptHint: "insight or solution card", preferredSlots: ["visual", "body"] },
+      { role: "example", required: true, promptHint: "example or proof card", preferredSlots: ["visual", "body"] },
+      { role: "cta", required: true, promptHint: "closing call to action card", preferredSlots: ["cta"] },
+    ],
+  },
+  {
+    id: "long-8",
+    name: "Long 8",
+    defaultCount: 8,
+    roles: [
+      { role: "cover", required: true, promptHint: "cover card", preferredSlots: ["title"] },
+      { role: "problem", required: true, promptHint: "problem card", preferredSlots: ["body"] },
+      { role: "data", required: true, promptHint: "data card", preferredSlots: ["visual"] },
+      { role: "tip1", required: true, promptHint: "first tip card", preferredSlots: ["body"] },
+      { role: "tip2", required: true, promptHint: "second tip card", preferredSlots: ["body"] },
+      { role: "example", required: true, promptHint: "example card", preferredSlots: ["visual"] },
+      { role: "summary", required: true, promptHint: "summary card", preferredSlots: ["body"] },
+      { role: "cta", required: true, promptHint: "call to action card", preferredSlots: ["cta"] },
+    ],
+  },
+];
+
+export function listRoleTemplates() {
+  return ROLE_TEMPLATES;
+}
+
+export function getRoleTemplate(roleTemplateId = "mid-5") {
+  return ROLE_TEMPLATES.find((t) => t.id === roleTemplateId) || ROLE_TEMPLATES[1];
+}