@lv-x-software-house/x_view 1.2.6-dev.23 → 1.2.6-dev.25

package/dist/index.js

@@ -13311,12 +13311,12 @@ var BoardItem = ({
   const isNested = onOutdent !== void 0;
   const getIndentUpTooltip = () => {
     if (!prevItem) return null;
-    const typeLabel = prevItem.type === "folder" ? "folder" : "text_group";
+    const typeLabel = prevItem.type === "folder" ? "pasta" : "grupo de texto";
     return isFolder ? prevItem.type === "folder" ? "Aninhar na pasta acima" : null : `Mover para dentro do ${typeLabel} acima`;
   };
   const getIndentDownTooltip = () => {
     if (!nextItem) return null;
-    const typeLabel = nextItem.type === "folder" ? "folder" : "text_group";
+    const typeLabel = nextItem.type === "folder" ? "pasta" : "grupo de texto";
     return isFolder ? nextItem.type === "folder" ? "Aninhar na pasta abaixo" : null : `Mover para dentro do ${typeLabel} abaixo`;
   };
   const showIndentUp = !!getIndentUpTooltip();
@@ -13420,14 +13420,14 @@ var BoardItem = ({
       onMentionClick,
       searchItems,
       readOnly: !canEdit,
-      placeholder: "Escreva sobre este grupo\u2026 ou @ para mencionar"
+      placeholder: "Escreva sobre este grupo de texto\u2026 ou @ para mencionar"
     }
   ), canEdit && /* @__PURE__ */ import_react29.default.createElement("div", { className: "flex items-center justify-between pt-2 mt-1 border-t border-white/5 opacity-40 group-hover/item:opacity-100 transition-opacity" }, /* @__PURE__ */ import_react29.default.createElement("div", { className: "flex items-center gap-1" }, /* @__PURE__ */ import_react29.default.createElement(
     "button",
     {
-      onClick: () => onAddSubgroup(item.id, "group"),
+      onClick: () => onAddSubgroup(item.id, "text_group"),
       className: "flex items-center gap-1 px-1.5 py-1 text-[10px] uppercase font-bold tracking-wider text-slate-500 hover:text-white hover:bg-white/10 rounded transition-colors",
-      title: "Criar Subgrupo"
+      title: "Criar Subgrupo de Texto"
     },
     /* @__PURE__ */ import_react29.default.createElement(import_fi23.FiPlus, { size: 12 }),
     /* @__PURE__ */ import_react29.default.createElement("span", null, "Subgrupo")
@@ -13469,7 +13469,7 @@ var BoardItem = ({
       className: `p-1.5 rounded transition-colors ${!onOutdent ? "text-slate-800 cursor-not-allowed" : "text-slate-500 hover:text-white hover:bg-white/10"}`
     },
     /* @__PURE__ */ import_react29.default.createElement(import_fi23.FiCornerUpLeft, { size: 14 })
-  )), /* @__PURE__ */ import_react29.default.createElement("div", { className: "w-px h-3 bg-white/10 mx-1" }), /* @__PURE__ */ import_react29.default.createElement(Tooltip, { text: "Remover Grupo" }, /* @__PURE__ */ import_react29.default.createElement(
+  )), /* @__PURE__ */ import_react29.default.createElement("div", { className: "w-px h-3 bg-white/10 mx-1" }), /* @__PURE__ */ import_react29.default.createElement(Tooltip, { text: "Remover Grupo de Texto" }, /* @__PURE__ */ import_react29.default.createElement(
     "button",
     {
       onClick: () => onDelete(item.id),
@@ -13506,29 +13506,35 @@ function AncestryBoard({
   onSelect,
   availableAncestries = [],
   availableNodes = [],
-  initialGroups = [],
+  initialBoardItems = [],
   onSave,
   userRole
 }) {
-  const [groups, setGroups] = (0, import_react29.useState)([]);
+  const [boardItems, setBoardItems] = (0, import_react29.useState)([]);
   const [isLoaded, setIsLoaded] = (0, import_react29.useState)(false);
   const [saveStatus, setSaveStatus] = (0, import_react29.useState)("idle");
   const [navigationStack, setNavigationStack] = (0, import_react29.useState)([]);
-  const lastSavedGroupsRef = (0, import_react29.useRef)(null);
+  const lastSavedBoardItemsRef = (0, import_react29.useRef)(null);
   const canEdit = (0, import_react29.useMemo)(() => userRole !== "viewer", [userRole]);
   (0, import_react29.useEffect)(() => {
-    if (initialGroups && !isLoaded) {
-      const migrate = (list) => list.map((g) => ({
-        id: g.id || (0, import_uuid11.v4)(),
-        type: g.type || "group",
-        name: g.name || "",
-        content: Array.isArray(g.content) ? g.content : [],
-        children: migrate(g.children || [])
-      }));
-      setGroups(migrate(initialGroups));
+    if (initialBoardItems && !isLoaded) {
+      const hasLegacyTypes = (list) => list.some((g) => g.type === "group" || hasLegacyTypes(g.children || []));
+      if (hasLegacyTypes(initialBoardItems)) {
+        console.warn("Legacy AncestryBoard detected. Resetting board to empty list.");
+        setBoardItems([]);
+      } else {
+        const prepare = (list) => list.map((g) => ({
+          id: g.id || (0, import_uuid11.v4)(),
+          type: g.type || "text_group",
+          name: g.name || "",
+          content: Array.isArray(g.content) ? g.content : [],
+          children: prepare(g.children || [])
+        }));
+        setBoardItems(prepare(initialBoardItems));
+      }
       setIsLoaded(true);
     }
-  }, [initialGroups, isLoaded]);
+  }, [initialBoardItems, isLoaded]);
   const allSearchableItems = (0, import_react29.useMemo)(() => {
     const items = [];
     availableAncestries.forEach((anc) => {
@@ -13555,23 +13561,23 @@ function AncestryBoard({
     });
     return items;
   }, [availableAncestries, availableNodes]);
-  const sanitizeGroups = (list) => list.map((g) => ({
+  const sanitizeBoardItems = (list) => list.map((g) => ({
     id: g.id,
-    type: g.type || "group",
+    type: g.type || "text_group",
     name: g.name || "",
     content: g.content || [],
-    children: sanitizeGroups(g.children || [])
+    children: sanitizeBoardItems(g.children || [])
   }));
   (0, import_react29.useEffect)(() => {
     if (!isLoaded || !onSave) return;
     const id = setTimeout(async () => {
-      const currentSanitized = sanitizeGroups(groups);
+      const currentSanitized = sanitizeBoardItems(boardItems);
       const currentJson = JSON.stringify(currentSanitized);
-      if (currentJson === lastSavedGroupsRef.current) return;
+      if (currentJson === lastSavedBoardItemsRef.current) return;
       setSaveStatus("saving");
       try {
         await onSave(currentSanitized);
-        lastSavedGroupsRef.current = currentJson;
+        lastSavedBoardItemsRef.current = currentJson;
         setSaveStatus("saved");
         setTimeout(() => setSaveStatus("idle"), 3e3);
       } catch (err) {
@@ -13580,12 +13586,12 @@ function AncestryBoard({
       }
     }, 3e3);
     return () => clearTimeout(id);
-  }, [groups, isLoaded, onSave]);
-  const triggerInstantSave = async (updatedGroups) => {
+  }, [boardItems, isLoaded, onSave]);
+  const triggerInstantSave = async (updatedBoardItems) => {
     if (!onSave) return;
-    const sanitized = sanitizeGroups(updatedGroups);
+    const sanitized = sanitizeBoardItems(updatedBoardItems);
     const sanitizedJson = JSON.stringify(sanitized);
-    lastSavedGroupsRef.current = sanitizedJson;
+    lastSavedBoardItemsRef.current = sanitizedJson;
     setSaveStatus("saving");
     try {
       await onSave(sanitized);
@@ -13610,7 +13616,7 @@ function AncestryBoard({
   }, [isOpen, onClose]);
   const currentPath = (0, import_react29.useMemo)(() => {
     const path = [];
-    let currentLevel = groups;
+    let currentLevel = boardItems;
     for (const folderId of navigationStack) {
       const folder = currentLevel.find((f) => f.id === folderId);
       if (folder) {
@@ -13619,11 +13625,11 @@ function AncestryBoard({
       }
     }
     return path;
-  }, [groups, navigationStack]);
-  const currentGroups = (0, import_react29.useMemo)(() => {
+  }, [boardItems, navigationStack]);
+  const currentBoardItems = (0, import_react29.useMemo)(() => {
     const lastFolder = currentPath[currentPath.length - 1];
-    return lastFolder ? lastFolder.children : groups;
-  }, [groups, currentPath]);
+    return lastFolder ? lastFolder.children : boardItems;
+  }, [boardItems, currentPath]);
   const navigateUp = () => {
     setNavigationStack((prev) => prev.slice(0, -1));
   };
@@ -13636,7 +13642,7 @@ function AncestryBoard({
   const navigateHome = () => {
     setNavigationStack([]);
   };
-  const handleAddItem = (type = "group") => {
+  const handleAddItem = (type = "text_group") => {
     const newItem = {
       id: (0, import_uuid11.v4)(),
       type,
@@ -13645,19 +13651,19 @@ function AncestryBoard({
       children: []
     };
     if (navigationStack.length === 0) {
-      setGroups((prev) => [...prev, newItem]);
+      setBoardItems((prev) => [...prev, newItem]);
     } else {
       const parentId = navigationStack[navigationStack.length - 1];
       const add = (list) => list.map(
         (g) => g.id === parentId ? { ...g, children: [...g.children, newItem] } : { ...g, children: add(g.children) }
       );
-      setGroups((prev) => add(prev));
+      setBoardItems((prev) => add(prev));
     }
   };
-  const handleAddSubgroup = (parentId, type = "group") => {
+  const handleAddSubgroup = (parentId, type = "text_group") => {
     const add = (list) => list.map((g) => {
       if (g.id === parentId) {
-        if (g.type === "group" && type === "folder") return g;
+        if (g.type === "text_group" && type === "folder") return g;
         const newItem = {
           id: (0, import_uuid11.v4)(),
           type,
@@ -13669,17 +13675,17 @@ function AncestryBoard({
       }
       return { ...g, children: add(g.children) };
     });
-    setGroups((prev) => add(prev));
+    setBoardItems((prev) => add(prev));
   };
   const handleUpdateItem = (id, newData) => {
     const update = (list) => list.map(
       (g) => g.id === id ? newData : { ...g, children: update(g.children) }
     );
-    setGroups((prev) => update(prev));
+    setBoardItems((prev) => update(prev));
   };
   const handleDeleteItem = (id) => {
     const del = (list) => list.filter((g) => g.id !== id).map((g) => ({ ...g, children: del(g.children) }));
-    setGroups((prev) => del(prev));
+    setBoardItems((prev) => del(prev));
   };
   const findGroupAndParent = (list, targetId, parent = null) => {
     for (let i = 0; i < list.length; i++) {
@@ -13693,35 +13699,35 @@ function AncestryBoard({
     return null;
   };
   const handleIndent = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === 0) return;
     const { group, siblings, index } = found;
     const targetParent = siblings[index - 1];
-    if (group.type === "folder" && targetParent.type === "group") {
+    if (group.type === "folder" && targetParent.type === "text_group") {
       return;
     }
     siblings.splice(index, 1);
     targetParent.children.push(group);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleIndentDown = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === found.siblings.length - 1) return;
     const { group, siblings, index } = found;
     const targetParent = siblings[index + 1];
-    if (group.type === "folder" && targetParent.type === "group") {
+    if (group.type === "folder" && targetParent.type === "text_group") {
       return;
     }
     siblings.splice(index, 1);
     targetParent.children.push(group);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleOutdent = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || !found.parent) return;
     const { group, siblings, index, parent } = found;
@@ -13732,29 +13738,29 @@ function AncestryBoard({
     } else {
       next.push(group);
     }
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleMoveUp = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === 0) return;
     const { siblings, index } = found;
     const item = siblings[index];
     siblings.splice(index, 1);
     siblings.splice(index - 1, 0, item);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleMoveDown = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === found.siblings.length - 1) return;
     const { siblings, index } = found;
     const item = siblings[index];
     siblings.splice(index, 1);
     siblings.splice(index + 1, 0, item);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleMentionClick = (item) => {
@@ -13784,11 +13790,11 @@ function AncestryBoard({
       ), /* @__PURE__ */ import_react29.default.createElement(
         "button",
         {
-          onClick: () => handleAddItem("group"),
+          onClick: () => handleAddItem("text_group"),
           className: "flex items-center gap-2 px-3 py-1.5 bg-white/5 hover:bg-white/10 border border-white/10 hover:border-white/20 backdrop-blur-sm text-slate-200 hover:text-white rounded-md transition-all duration-200 text-xs font-medium shadow-sm"
         },
         /* @__PURE__ */ import_react29.default.createElement(import_fi23.FiPlus, { size: 14, className: "text-indigo-400" }),
-        /* @__PURE__ */ import_react29.default.createElement("span", { className: "hidden sm:inline" }, "Novo Grupo")
+        /* @__PURE__ */ import_react29.default.createElement("span", { className: "hidden sm:inline" }, "Novo Grupo de Texto")
       )), /* @__PURE__ */ import_react29.default.createElement(
         "button",
         {
@@ -13820,13 +13826,13 @@ function AncestryBoard({
         /* @__PURE__ */ import_react29.default.createElement(import_fi23.FiArrowLeft, { size: 10 }),
         /* @__PURE__ */ import_react29.default.createElement("span", null, "Voltar")
       ))),
-      /* @__PURE__ */ import_react29.default.createElement("div", { className: "flex-1 overflow-y-auto custom-scrollbar bg-slate-950/30 p-6 space-y-4" }, currentGroups.length === 0 ? /* @__PURE__ */ import_react29.default.createElement("div", { className: "flex flex-col items-center justify-center h-full text-slate-500 gap-3 border-2 border-dashed border-white/5 rounded-xl bg-slate-900/20" }, /* @__PURE__ */ import_react29.default.createElement(import_fi23.FiLayers, { size: 24, className: "opacity-20" }), /* @__PURE__ */ import_react29.default.createElement("p", { className: "text-xs text-center px-4" }, canEdit ? /* @__PURE__ */ import_react29.default.createElement(import_react29.default.Fragment, null, "Esta pasta est\xE1 vazia.", /* @__PURE__ */ import_react29.default.createElement("br", null), "Use os bot\xF5es acima para criar conte\xFAdo.") : /* @__PURE__ */ import_react29.default.createElement(import_react29.default.Fragment, null, "Nenhum conte\xFAdo dispon\xEDvel nesta pasta."))) : currentGroups.map((item, index) => /* @__PURE__ */ import_react29.default.createElement(
+      /* @__PURE__ */ import_react29.default.createElement("div", { className: "flex-1 overflow-y-auto custom-scrollbar bg-slate-950/30 p-6 space-y-4" }, currentBoardItems.length === 0 ? /* @__PURE__ */ import_react29.default.createElement("div", { className: "flex flex-col items-center justify-center h-full text-slate-500 gap-3 border-2 border-dashed border-white/5 rounded-xl bg-slate-900/20" }, /* @__PURE__ */ import_react29.default.createElement(import_fi23.FiLayers, { size: 24, className: "opacity-20" }), /* @__PURE__ */ import_react29.default.createElement("p", { className: "text-xs text-center px-4" }, canEdit ? /* @__PURE__ */ import_react29.default.createElement(import_react29.default.Fragment, null, "Esta pasta est\xE1 vazia.", /* @__PURE__ */ import_react29.default.createElement("br", null), "Use os bot\xF5es acima para criar conte\xFAdo.") : /* @__PURE__ */ import_react29.default.createElement(import_react29.default.Fragment, null, "Nenhum conte\xFAdo dispon\xEDvel nesta pasta."))) : currentBoardItems.map((item, index) => /* @__PURE__ */ import_react29.default.createElement(
         BoardItem,
         {
           key: item.id,
           index,
-          prevItem: currentGroups[index - 1],
-          nextItem: currentGroups[index + 1],
+          prevItem: currentBoardItems[index - 1],
+          nextItem: currentBoardItems[index + 1],
           item,
           onUpdate: handleUpdateItem,
           onDelete: handleDeleteItem,
@@ -13843,7 +13849,7 @@ function AncestryBoard({
           isAtRoot: navigationStack.length === 0
         }
       ))),
-      /* @__PURE__ */ import_react29.default.createElement("div", { className: "px-5 py-2 border-t border-white/10 bg-slate-950/50 text-xs text-slate-500 flex justify-end flex-shrink-0" }, /* @__PURE__ */ import_react29.default.createElement("span", null, currentGroups.length, " itens nesta visualiza\xE7\xE3o"))
+      /* @__PURE__ */ import_react29.default.createElement("div", { className: "px-5 py-2 border-t border-white/10 bg-slate-950/50 text-xs text-slate-500 flex justify-end flex-shrink-0" }, /* @__PURE__ */ import_react29.default.createElement("span", null, currentBoardItems.length, " itens nesta visualiza\xE7\xE3o"))
     )
   );
 }
@@ -14189,7 +14195,7 @@ function XViewScene({
   const [invalidTargetError, setInvalidTargetError] = (0, import_react31.useState)(null);
   const [highlightedNodeId, setHighlightedNodeId] = (0, import_react31.useState)(null);
   const [isAncestryBoardOpen, setIsAncestryBoardOpen] = (0, import_react31.useState)(false);
-  const [ancestryBoardData, setAncestryBoardData] = (0, import_react31.useState)([]);
+  const [boardItems, setBoardItems] = (0, import_react31.useState)([]);
   const [isSidebarOpen, setIsSidebarOpen] = (0, import_react31.useState)(false);
   const [isMilestoneManagerOpen, setIsMilestoneManagerOpen] = (0, import_react31.useState)(false);
   const mountRef = (0, import_react31.useRef)(null);
@@ -18076,13 +18082,13 @@ function XViewScene({
     [handleStartReadingAncestry, handleOpenReference]
   );
   const handleSaveAncestryBoard = (0, import_react31.useCallback)(
-    async (groups) => {
+    async (boardItems2) => {
       if (!sceneConfigId || !viewParams || !session) return;
       const sceneType = (viewParams.type || "").toLowerCase().includes("database") ? "database" : "view";
       await save_ancestry_board_action(
         sceneConfigId,
         sceneType,
-        groups,
+        boardItems2,
         session,
         ownerId
       );
@@ -18897,7 +18903,7 @@ function XViewScene({
         onSelect: handleSelectAncestryFromBoard,
         availableAncestries: allAvailableAncestries,
         availableNodes: allAvailableNodes,
-        initialGroups: ancestryBoardData,
+        initialBoardItems: boardItems,
         onSave: handleSaveAncestryBoard,
         userRole: userPermissionRole
       }
@@ -19396,10 +19402,10 @@ async function get_ancestry_file_logic(db_services, file_id, owner_id) {
     return { success: false, error: error.message };
   }
 }
-async function save_ancestry_board_logic(db_services, scene_id, type, groups, session, owner_id) {
+async function save_ancestry_board_logic(db_services, scene_id, type, boardItems, session, owner_id) {
   try {
     const targetOwnerId = owner_id || session.user.id;
-    return await db_services.save_ancestry_board(session, scene_id, type, groups, targetOwnerId);
+    return await db_services.save_ancestry_board(session, scene_id, type, boardItems, targetOwnerId);
   } catch (error) {
     console.error("Erro em save_ancestry_board_logic:", error);
     return { success: false, error: error.message };

package/dist/index.mjs

@@ -13361,12 +13361,12 @@ var BoardItem = ({
   const isNested = onOutdent !== void 0;
   const getIndentUpTooltip = () => {
     if (!prevItem) return null;
-    const typeLabel = prevItem.type === "folder" ? "folder" : "text_group";
+    const typeLabel = prevItem.type === "folder" ? "pasta" : "grupo de texto";
     return isFolder ? prevItem.type === "folder" ? "Aninhar na pasta acima" : null : `Mover para dentro do ${typeLabel} acima`;
   };
   const getIndentDownTooltip = () => {
     if (!nextItem) return null;
-    const typeLabel = nextItem.type === "folder" ? "folder" : "text_group";
+    const typeLabel = nextItem.type === "folder" ? "pasta" : "grupo de texto";
     return isFolder ? nextItem.type === "folder" ? "Aninhar na pasta abaixo" : null : `Mover para dentro do ${typeLabel} abaixo`;
   };
   const showIndentUp = !!getIndentUpTooltip();
@@ -13470,14 +13470,14 @@ var BoardItem = ({
       onMentionClick,
       searchItems,
       readOnly: !canEdit,
-      placeholder: "Escreva sobre este grupo\u2026 ou @ para mencionar"
+      placeholder: "Escreva sobre este grupo de texto\u2026 ou @ para mencionar"
     }
   ), canEdit && /* @__PURE__ */ React28.createElement("div", { className: "flex items-center justify-between pt-2 mt-1 border-t border-white/5 opacity-40 group-hover/item:opacity-100 transition-opacity" }, /* @__PURE__ */ React28.createElement("div", { className: "flex items-center gap-1" }, /* @__PURE__ */ React28.createElement(
     "button",
     {
-      onClick: () => onAddSubgroup(item.id, "group"),
+      onClick: () => onAddSubgroup(item.id, "text_group"),
       className: "flex items-center gap-1 px-1.5 py-1 text-[10px] uppercase font-bold tracking-wider text-slate-500 hover:text-white hover:bg-white/10 rounded transition-colors",
-      title: "Criar Subgrupo"
+      title: "Criar Subgrupo de Texto"
     },
     /* @__PURE__ */ React28.createElement(FiPlus10, { size: 12 }),
     /* @__PURE__ */ React28.createElement("span", null, "Subgrupo")
@@ -13519,7 +13519,7 @@ var BoardItem = ({
       className: `p-1.5 rounded transition-colors ${!onOutdent ? "text-slate-800 cursor-not-allowed" : "text-slate-500 hover:text-white hover:bg-white/10"}`
     },
     /* @__PURE__ */ React28.createElement(FiCornerUpLeft3, { size: 14 })
-  )), /* @__PURE__ */ React28.createElement("div", { className: "w-px h-3 bg-white/10 mx-1" }), /* @__PURE__ */ React28.createElement(Tooltip, { text: "Remover Grupo" }, /* @__PURE__ */ React28.createElement(
+  )), /* @__PURE__ */ React28.createElement("div", { className: "w-px h-3 bg-white/10 mx-1" }), /* @__PURE__ */ React28.createElement(Tooltip, { text: "Remover Grupo de Texto" }, /* @__PURE__ */ React28.createElement(
     "button",
     {
       onClick: () => onDelete(item.id),
@@ -13556,29 +13556,35 @@ function AncestryBoard({
   onSelect,
   availableAncestries = [],
   availableNodes = [],
-  initialGroups = [],
+  initialBoardItems = [],
   onSave,
   userRole
 }) {
-  const [groups, setGroups] = useState27([]);
+  const [boardItems, setBoardItems] = useState27([]);
   const [isLoaded, setIsLoaded] = useState27(false);
   const [saveStatus, setSaveStatus] = useState27("idle");
   const [navigationStack, setNavigationStack] = useState27([]);
-  const lastSavedGroupsRef = useRef20(null);
+  const lastSavedBoardItemsRef = useRef20(null);
   const canEdit = useMemo12(() => userRole !== "viewer", [userRole]);
   useEffect23(() => {
-    if (initialGroups && !isLoaded) {
-      const migrate = (list) => list.map((g) => ({
-        id: g.id || uuidv411(),
-        type: g.type || "group",
-        name: g.name || "",
-        content: Array.isArray(g.content) ? g.content : [],
-        children: migrate(g.children || [])
-      }));
-      setGroups(migrate(initialGroups));
+    if (initialBoardItems && !isLoaded) {
+      const hasLegacyTypes = (list) => list.some((g) => g.type === "group" || hasLegacyTypes(g.children || []));
+      if (hasLegacyTypes(initialBoardItems)) {
+        console.warn("Legacy AncestryBoard detected. Resetting board to empty list.");
+        setBoardItems([]);
+      } else {
+        const prepare = (list) => list.map((g) => ({
+          id: g.id || uuidv411(),
+          type: g.type || "text_group",
+          name: g.name || "",
+          content: Array.isArray(g.content) ? g.content : [],
+          children: prepare(g.children || [])
+        }));
+        setBoardItems(prepare(initialBoardItems));
+      }
       setIsLoaded(true);
     }
-  }, [initialGroups, isLoaded]);
+  }, [initialBoardItems, isLoaded]);
   const allSearchableItems = useMemo12(() => {
     const items = [];
     availableAncestries.forEach((anc) => {
@@ -13605,23 +13611,23 @@ function AncestryBoard({
     });
     return items;
   }, [availableAncestries, availableNodes]);
-  const sanitizeGroups = (list) => list.map((g) => ({
+  const sanitizeBoardItems = (list) => list.map((g) => ({
     id: g.id,
-    type: g.type || "group",
+    type: g.type || "text_group",
     name: g.name || "",
     content: g.content || [],
-    children: sanitizeGroups(g.children || [])
+    children: sanitizeBoardItems(g.children || [])
   }));
   useEffect23(() => {
     if (!isLoaded || !onSave) return;
     const id = setTimeout(async () => {
-      const currentSanitized = sanitizeGroups(groups);
+      const currentSanitized = sanitizeBoardItems(boardItems);
       const currentJson = JSON.stringify(currentSanitized);
-      if (currentJson === lastSavedGroupsRef.current) return;
+      if (currentJson === lastSavedBoardItemsRef.current) return;
       setSaveStatus("saving");
       try {
         await onSave(currentSanitized);
-        lastSavedGroupsRef.current = currentJson;
+        lastSavedBoardItemsRef.current = currentJson;
         setSaveStatus("saved");
         setTimeout(() => setSaveStatus("idle"), 3e3);
       } catch (err) {
@@ -13630,12 +13636,12 @@ function AncestryBoard({
       }
     }, 3e3);
     return () => clearTimeout(id);
-  }, [groups, isLoaded, onSave]);
-  const triggerInstantSave = async (updatedGroups) => {
+  }, [boardItems, isLoaded, onSave]);
+  const triggerInstantSave = async (updatedBoardItems) => {
     if (!onSave) return;
-    const sanitized = sanitizeGroups(updatedGroups);
+    const sanitized = sanitizeBoardItems(updatedBoardItems);
     const sanitizedJson = JSON.stringify(sanitized);
-    lastSavedGroupsRef.current = sanitizedJson;
+    lastSavedBoardItemsRef.current = sanitizedJson;
     setSaveStatus("saving");
     try {
       await onSave(sanitized);
@@ -13660,7 +13666,7 @@ function AncestryBoard({
   }, [isOpen, onClose]);
   const currentPath = useMemo12(() => {
     const path = [];
-    let currentLevel = groups;
+    let currentLevel = boardItems;
     for (const folderId of navigationStack) {
       const folder = currentLevel.find((f) => f.id === folderId);
       if (folder) {
@@ -13669,11 +13675,11 @@ function AncestryBoard({
       }
     }
     return path;
-  }, [groups, navigationStack]);
-  const currentGroups = useMemo12(() => {
+  }, [boardItems, navigationStack]);
+  const currentBoardItems = useMemo12(() => {
     const lastFolder = currentPath[currentPath.length - 1];
-    return lastFolder ? lastFolder.children : groups;
-  }, [groups, currentPath]);
+    return lastFolder ? lastFolder.children : boardItems;
+  }, [boardItems, currentPath]);
   const navigateUp = () => {
     setNavigationStack((prev) => prev.slice(0, -1));
   };
@@ -13686,7 +13692,7 @@ function AncestryBoard({
   const navigateHome = () => {
     setNavigationStack([]);
   };
-  const handleAddItem = (type = "group") => {
+  const handleAddItem = (type = "text_group") => {
     const newItem = {
       id: uuidv411(),
       type,
@@ -13695,19 +13701,19 @@ function AncestryBoard({
       children: []
     };
     if (navigationStack.length === 0) {
-      setGroups((prev) => [...prev, newItem]);
+      setBoardItems((prev) => [...prev, newItem]);
     } else {
       const parentId = navigationStack[navigationStack.length - 1];
       const add = (list) => list.map(
         (g) => g.id === parentId ? { ...g, children: [...g.children, newItem] } : { ...g, children: add(g.children) }
       );
-      setGroups((prev) => add(prev));
+      setBoardItems((prev) => add(prev));
     }
   };
-  const handleAddSubgroup = (parentId, type = "group") => {
+  const handleAddSubgroup = (parentId, type = "text_group") => {
     const add = (list) => list.map((g) => {
       if (g.id === parentId) {
-        if (g.type === "group" && type === "folder") return g;
+        if (g.type === "text_group" && type === "folder") return g;
         const newItem = {
           id: uuidv411(),
           type,
@@ -13719,17 +13725,17 @@ function AncestryBoard({
       }
       return { ...g, children: add(g.children) };
     });
-    setGroups((prev) => add(prev));
+    setBoardItems((prev) => add(prev));
   };
   const handleUpdateItem = (id, newData) => {
     const update = (list) => list.map(
       (g) => g.id === id ? newData : { ...g, children: update(g.children) }
     );
-    setGroups((prev) => update(prev));
+    setBoardItems((prev) => update(prev));
   };
   const handleDeleteItem = (id) => {
     const del = (list) => list.filter((g) => g.id !== id).map((g) => ({ ...g, children: del(g.children) }));
-    setGroups((prev) => del(prev));
+    setBoardItems((prev) => del(prev));
   };
   const findGroupAndParent = (list, targetId, parent = null) => {
     for (let i = 0; i < list.length; i++) {
@@ -13743,35 +13749,35 @@ function AncestryBoard({
     return null;
   };
   const handleIndent = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === 0) return;
     const { group, siblings, index } = found;
     const targetParent = siblings[index - 1];
-    if (group.type === "folder" && targetParent.type === "group") {
+    if (group.type === "folder" && targetParent.type === "text_group") {
       return;
     }
     siblings.splice(index, 1);
     targetParent.children.push(group);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleIndentDown = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === found.siblings.length - 1) return;
     const { group, siblings, index } = found;
     const targetParent = siblings[index + 1];
-    if (group.type === "folder" && targetParent.type === "group") {
+    if (group.type === "folder" && targetParent.type === "text_group") {
       return;
     }
     siblings.splice(index, 1);
     targetParent.children.push(group);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleOutdent = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || !found.parent) return;
     const { group, siblings, index, parent } = found;
@@ -13782,29 +13788,29 @@ function AncestryBoard({
     } else {
       next.push(group);
     }
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleMoveUp = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === 0) return;
     const { siblings, index } = found;
     const item = siblings[index];
     siblings.splice(index, 1);
     siblings.splice(index - 1, 0, item);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleMoveDown = (id) => {
-    const next = JSON.parse(JSON.stringify(groups));
+    const next = JSON.parse(JSON.stringify(boardItems));
     const found = findGroupAndParent(next, id);
     if (!found || found.index === found.siblings.length - 1) return;
     const { siblings, index } = found;
     const item = siblings[index];
     siblings.splice(index, 1);
     siblings.splice(index + 1, 0, item);
-    setGroups(next);
+    setBoardItems(next);
     triggerInstantSave(next);
   };
   const handleMentionClick = (item) => {
@@ -13834,11 +13840,11 @@ function AncestryBoard({
       ), /* @__PURE__ */ React28.createElement(
         "button",
         {
-          onClick: () => handleAddItem("group"),
+          onClick: () => handleAddItem("text_group"),
           className: "flex items-center gap-2 px-3 py-1.5 bg-white/5 hover:bg-white/10 border border-white/10 hover:border-white/20 backdrop-blur-sm text-slate-200 hover:text-white rounded-md transition-all duration-200 text-xs font-medium shadow-sm"
         },
         /* @__PURE__ */ React28.createElement(FiPlus10, { size: 14, className: "text-indigo-400" }),
-        /* @__PURE__ */ React28.createElement("span", { className: "hidden sm:inline" }, "Novo Grupo")
+        /* @__PURE__ */ React28.createElement("span", { className: "hidden sm:inline" }, "Novo Grupo de Texto")
       )), /* @__PURE__ */ React28.createElement(
         "button",
         {
@@ -13870,13 +13876,13 @@ function AncestryBoard({
         /* @__PURE__ */ React28.createElement(FiArrowLeft3, { size: 10 }),
         /* @__PURE__ */ React28.createElement("span", null, "Voltar")
       ))),
-      /* @__PURE__ */ React28.createElement("div", { className: "flex-1 overflow-y-auto custom-scrollbar bg-slate-950/30 p-6 space-y-4" }, currentGroups.length === 0 ? /* @__PURE__ */ React28.createElement("div", { className: "flex flex-col items-center justify-center h-full text-slate-500 gap-3 border-2 border-dashed border-white/5 rounded-xl bg-slate-900/20" }, /* @__PURE__ */ React28.createElement(FiLayers7, { size: 24, className: "opacity-20" }), /* @__PURE__ */ React28.createElement("p", { className: "text-xs text-center px-4" }, canEdit ? /* @__PURE__ */ React28.createElement(React28.Fragment, null, "Esta pasta est\xE1 vazia.", /* @__PURE__ */ React28.createElement("br", null), "Use os bot\xF5es acima para criar conte\xFAdo.") : /* @__PURE__ */ React28.createElement(React28.Fragment, null, "Nenhum conte\xFAdo dispon\xEDvel nesta pasta."))) : currentGroups.map((item, index) => /* @__PURE__ */ React28.createElement(
+      /* @__PURE__ */ React28.createElement("div", { className: "flex-1 overflow-y-auto custom-scrollbar bg-slate-950/30 p-6 space-y-4" }, currentBoardItems.length === 0 ? /* @__PURE__ */ React28.createElement("div", { className: "flex flex-col items-center justify-center h-full text-slate-500 gap-3 border-2 border-dashed border-white/5 rounded-xl bg-slate-900/20" }, /* @__PURE__ */ React28.createElement(FiLayers7, { size: 24, className: "opacity-20" }), /* @__PURE__ */ React28.createElement("p", { className: "text-xs text-center px-4" }, canEdit ? /* @__PURE__ */ React28.createElement(React28.Fragment, null, "Esta pasta est\xE1 vazia.", /* @__PURE__ */ React28.createElement("br", null), "Use os bot\xF5es acima para criar conte\xFAdo.") : /* @__PURE__ */ React28.createElement(React28.Fragment, null, "Nenhum conte\xFAdo dispon\xEDvel nesta pasta."))) : currentBoardItems.map((item, index) => /* @__PURE__ */ React28.createElement(
         BoardItem,
         {
           key: item.id,
           index,
-          prevItem: currentGroups[index - 1],
-          nextItem: currentGroups[index + 1],
+          prevItem: currentBoardItems[index - 1],
+          nextItem: currentBoardItems[index + 1],
           item,
           onUpdate: handleUpdateItem,
           onDelete: handleDeleteItem,
@@ -13893,7 +13899,7 @@ function AncestryBoard({
           isAtRoot: navigationStack.length === 0
         }
       ))),
-      /* @__PURE__ */ React28.createElement("div", { className: "px-5 py-2 border-t border-white/10 bg-slate-950/50 text-xs text-slate-500 flex justify-end flex-shrink-0" }, /* @__PURE__ */ React28.createElement("span", null, currentGroups.length, " itens nesta visualiza\xE7\xE3o"))
+      /* @__PURE__ */ React28.createElement("div", { className: "px-5 py-2 border-t border-white/10 bg-slate-950/50 text-xs text-slate-500 flex justify-end flex-shrink-0" }, /* @__PURE__ */ React28.createElement("span", null, currentBoardItems.length, " itens nesta visualiza\xE7\xE3o"))
     )
   );
 }
@@ -14239,7 +14245,7 @@ function XViewScene({
   const [invalidTargetError, setInvalidTargetError] = useState29(null);
   const [highlightedNodeId, setHighlightedNodeId] = useState29(null);
   const [isAncestryBoardOpen, setIsAncestryBoardOpen] = useState29(false);
-  const [ancestryBoardData, setAncestryBoardData] = useState29([]);
+  const [boardItems, setBoardItems] = useState29([]);
   const [isSidebarOpen, setIsSidebarOpen] = useState29(false);
   const [isMilestoneManagerOpen, setIsMilestoneManagerOpen] = useState29(false);
   const mountRef = useRef21(null);
@@ -18126,13 +18132,13 @@ function XViewScene({
     [handleStartReadingAncestry, handleOpenReference]
   );
   const handleSaveAncestryBoard = useCallback5(
-    async (groups) => {
+    async (boardItems2) => {
       if (!sceneConfigId || !viewParams || !session) return;
       const sceneType = (viewParams.type || "").toLowerCase().includes("database") ? "database" : "view";
       await save_ancestry_board_action(
         sceneConfigId,
         sceneType,
-        groups,
+        boardItems2,
         session,
         ownerId
       );
@@ -18947,7 +18953,7 @@ function XViewScene({
         onSelect: handleSelectAncestryFromBoard,
         availableAncestries: allAvailableAncestries,
         availableNodes: allAvailableNodes,
-        initialGroups: ancestryBoardData,
+        initialBoardItems: boardItems,
         onSave: handleSaveAncestryBoard,
         userRole: userPermissionRole
       }
@@ -19446,10 +19452,10 @@ async function get_ancestry_file_logic(db_services, file_id, owner_id) {
     return { success: false, error: error.message };
   }
 }
-async function save_ancestry_board_logic(db_services, scene_id, type, groups, session, owner_id) {
+async function save_ancestry_board_logic(db_services, scene_id, type, boardItems, session, owner_id) {
   try {
     const targetOwnerId = owner_id || session.user.id;
-    return await db_services.save_ancestry_board(session, scene_id, type, groups, targetOwnerId);
+    return await db_services.save_ancestry_board(session, scene_id, type, boardItems, targetOwnerId);
   } catch (error) {
     console.error("Erro em save_ancestry_board_logic:", error);
     return { success: false, error: error.message };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lv-x-software-house/x_view",
-  "version": "1.2.6-dev.23",
+  "version": "1.2.6-dev.25",
   "description": "Pacote privado contendo os componentes e lógica de renderização 3D do X View.",
   "author": "iv.x - Engenharia de Software - ivxsoftwarehouse@gmail.com",
   "license": "UNLICENSED",