@flowtomic/logic 0.1.2 → 0.1.4

package/dist/hooks/useDashboardLayout/useDashboardLayout.d.ts

@@ -0,0 +1,120 @@
+/**
+ * useDashboardLayout - Headless UI Hook
+ *
+ * Fornece apenas: lógica, estado, processamento e API
+ * NÃO fornece: markup, styles ou implementações pré-construídas
+ *
+ * Padrão Headless UI: você controla o markup e styles
+ *
+ * @example
+ * ```tsx
+ * function MyDashboard() {
+ *   const [widgets, setWidgets] = useState<WidgetLayout[]>([]);
+ *   const gridConfig: GridConfig = { columns: 12, cellSize: 50, gap: 16 };
+ *
+ *   const {
+ *     getWidgetGridPosition,
+ *     moveWidget,
+ *     resizeWidget,
+ *     findNextAvailablePosition,
+ *   } = useDashboardLayout({
+ *     widgetsLayout: widgets,
+ *     gridConfig,
+ *     onUpdateLayout: setWidgets,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {widgets.map(widget => (
+ *         <div style={getWidgetGridPosition(widget)}>
+ *           Widget Content
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export interface WidgetLayout {
+    id: string;
+    type: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    config?: Record<string, unknown>;
+    minimized?: boolean;
+}
+export interface GridConfig {
+    columns: number;
+    cellSize?: number;
+    gap?: number;
+}
+export interface UseDashboardLayoutProps {
+    /**
+     * Layout atual de widgets
+     */
+    widgetsLayout: WidgetLayout[];
+    /**
+     * Configuração do grid
+     */
+    gridConfig: GridConfig;
+    /**
+     * Callback para atualizar o layout completo
+     */
+    onUpdateLayout: (layout: WidgetLayout[]) => void;
+}
+export interface UseDashboardLayoutReturn {
+    /**
+     * Configuração do grid (normalizada com defaults)
+     */
+    gridConfig: GridConfig;
+    /**
+     * Calcula posição CSS Grid para um widget
+     */
+    getWidgetGridPosition: (widget: WidgetLayout) => {
+        gridColumnStart: number;
+        gridColumnEnd: number;
+        gridRowStart: number;
+        gridRowEnd: number;
+    };
+    /**
+     * Verifica se uma posição está ocupada
+     */
+    isPositionOccupied: (x: number, y: number, w: number, h: number, excludeWidgetId?: string) => boolean;
+    /**
+     * Encontra próxima posição disponível
+     */
+    findNextAvailablePosition: (w: number, h: number) => {
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Valida se um widget pode ser movido para uma posição
+     */
+    canMoveToPosition: (widgetId: string, x: number, y: number) => boolean;
+    /**
+     * Valida se um widget pode ser redimensionado
+     */
+    canResize: (widgetId: string, newW: number, newH: number) => boolean;
+    /**
+     * Move widget para nova posição
+     */
+    moveWidget: (widgetId: string, x: number, y: number) => void;
+    /**
+     * Redimensiona widget
+     */
+    resizeWidget: (widgetId: string, w: number, h: number) => void;
+    /**
+     * Atualiza layout completo
+     */
+    updateLayout: (layout: WidgetLayout[]) => void;
+}
+/**
+ * Hook para gerenciar layout do dashboard
+ *
+ * Hook headless que fornece apenas lógica de layout, sem UI.
+ * Você controla o markup e styles.
+ */
+export declare function useDashboardLayout({ widgetsLayout, gridConfig, onUpdateLayout, }: UseDashboardLayoutProps): UseDashboardLayoutReturn;
+//# sourceMappingURL=useDashboardLayout.d.ts.map

package/dist/hooks/useDashboardLayout/useDashboardLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboardLayout.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDashboardLayout/useDashboardLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAOH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,aAAa,EAAE,YAAY,EAAE,CAAC;IAE9B;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,UAAU,EAAE,UAAU,CAAC;IAEvB;;OAEG;IACH,qBAAqB,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK;QAChD,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,kBAAkB,EAAE,CACnB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,eAAe,CAAC,EAAE,MAAM,KACpB,OAAO,CAAC;IAEb;;OAEG;IACH,yBAAyB,EAAE,CAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,KACL;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAEvE;;OAEG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAErE;;OAEG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7D;;OAEG;IACH,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/D;;OAEG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;CAC/C;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAClC,aAAa,EACb,UAAU,EACV,cAAc,GACd,EAAE,uBAAuB,GAAG,wBAAwB,CA+KpD"}

package/dist/hooks/useDashboardLayout/useDashboardLayout.js

@@ -0,0 +1,175 @@
+/**
+ * useDashboardLayout - Headless UI Hook
+ *
+ * Fornece apenas: lógica, estado, processamento e API
+ * NÃO fornece: markup, styles ou implementações pré-construídas
+ *
+ * Padrão Headless UI: você controla o markup e styles
+ *
+ * @example
+ * ```tsx
+ * function MyDashboard() {
+ *   const [widgets, setWidgets] = useState<WidgetLayout[]>([]);
+ *   const gridConfig: GridConfig = { columns: 12, cellSize: 50, gap: 16 };
+ *
+ *   const {
+ *     getWidgetGridPosition,
+ *     moveWidget,
+ *     resizeWidget,
+ *     findNextAvailablePosition,
+ *   } = useDashboardLayout({
+ *     widgetsLayout: widgets,
+ *     gridConfig,
+ *     onUpdateLayout: setWidgets,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {widgets.map(widget => (
+ *         <div style={getWidgetGridPosition(widget)}>
+ *           Widget Content
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import { useCallback, useMemo } from "react";
+const DEFAULT_GRID_CONFIG = {
+    columns: 12,
+    cellSize: 50,
+    gap: 16,
+};
+/**
+ * Hook para gerenciar layout do dashboard
+ *
+ * Hook headless que fornece apenas lógica de layout, sem UI.
+ * Você controla o markup e styles.
+ */
+export function useDashboardLayout({ widgetsLayout, gridConfig, onUpdateLayout, }) {
+    // Normaliza gridConfig com defaults
+    const normalizedGridConfig = useMemo(() => {
+        return {
+            ...DEFAULT_GRID_CONFIG,
+            ...gridConfig,
+        };
+    }, [gridConfig]);
+    /**
+     * Calcula posição CSS Grid para um widget
+     */
+    const getWidgetGridPosition = useCallback((widget) => {
+        return {
+            gridColumnStart: widget.x + 1, // CSS Grid é 1-indexed
+            gridColumnEnd: widget.x + widget.w + 1,
+            gridRowStart: widget.y + 1,
+            gridRowEnd: widget.y + widget.h + 1,
+        };
+    }, []);
+    /**
+     * Verifica se uma posição está ocupada
+     */
+    const isPositionOccupied = useCallback((x, y, w, h, excludeWidgetId) => {
+        return widgetsLayout.some((widget) => {
+            if (excludeWidgetId && widget.id === excludeWidgetId) {
+                return false;
+            }
+            // Verifica sobreposição
+            const widgetRight = widget.x + widget.w;
+            const widgetBottom = widget.y + widget.h;
+            const newRight = x + w;
+            const newBottom = y + h;
+            return !(widgetRight <= x ||
+                widget.x >= newRight ||
+                widgetBottom <= y ||
+                widget.y >= newBottom);
+        });
+    }, [widgetsLayout]);
+    /**
+     * Encontra próxima posição disponível
+     */
+    const findNextAvailablePosition = useCallback((w, h) => {
+        const maxColumns = normalizedGridConfig.columns;
+        const maxRows = 100; // Limite razoável
+        for (let y = 0; y < maxRows; y++) {
+            for (let x = 0; x <= maxColumns - w; x++) {
+                if (!isPositionOccupied(x, y, w, h)) {
+                    return { x, y };
+                }
+            }
+        }
+        return null;
+    }, [normalizedGridConfig.columns, isPositionOccupied]);
+    /**
+     * Valida se um widget pode ser movido para uma posição
+     */
+    const canMoveToPosition = useCallback((widgetId, x, y) => {
+        const widget = widgetsLayout.find((w) => w.id === widgetId);
+        if (!widget)
+            return false;
+        // Valida limites do grid
+        if (x < 0 || y < 0)
+            return false;
+        if (x + widget.w > normalizedGridConfig.columns)
+            return false;
+        // Verifica colisões
+        return !isPositionOccupied(x, y, widget.w, widget.h, widgetId);
+    }, [widgetsLayout, normalizedGridConfig.columns, isPositionOccupied]);
+    /**
+     * Valida se um widget pode ser redimensionado
+     */
+    const canResize = useCallback((widgetId, newW, newH) => {
+        const widget = widgetsLayout.find((w) => w.id === widgetId);
+        if (!widget)
+            return false;
+        // Valida tamanhos mínimos e máximos
+        if (newW < 2 || newH < 2)
+            return false; // Mínimo 2x2
+        if (newW > normalizedGridConfig.columns)
+            return false;
+        if (newH > 20)
+            return false; // Máximo 20 linhas
+        // Valida limites do grid
+        if (widget.x + newW > normalizedGridConfig.columns)
+            return false;
+        // Verifica colisões
+        return !isPositionOccupied(widget.x, widget.y, newW, newH, widgetId);
+    }, [widgetsLayout, normalizedGridConfig.columns, isPositionOccupied]);
+    /**
+     * Move widget para nova posição
+     */
+    const moveWidget = useCallback((widgetId, x, y) => {
+        if (!canMoveToPosition(widgetId, x, y)) {
+            return;
+        }
+        const updatedLayout = widgetsLayout.map((widget) => widget.id === widgetId ? { ...widget, x, y } : widget);
+        onUpdateLayout(updatedLayout);
+    }, [widgetsLayout, canMoveToPosition, onUpdateLayout]);
+    /**
+     * Redimensiona widget
+     */
+    const resizeWidget = useCallback((widgetId, w, h) => {
+        if (!canResize(widgetId, w, h)) {
+            return;
+        }
+        const updatedLayout = widgetsLayout.map((widget) => widget.id === widgetId ? { ...widget, w, h } : widget);
+        onUpdateLayout(updatedLayout);
+    }, [widgetsLayout, canResize, onUpdateLayout]);
+    /**
+     * Atualiza layout completo
+     */
+    const updateLayout = useCallback((layout) => {
+        onUpdateLayout(layout);
+    }, [onUpdateLayout]);
+    return {
+        gridConfig: normalizedGridConfig,
+        getWidgetGridPosition,
+        isPositionOccupied,
+        findNextAvailablePosition,
+        canMoveToPosition,
+        canResize,
+        moveWidget,
+        resizeWidget,
+        updateLayout,
+    };
+}

package/dist/hooks/useGenealogy/useGenealogy.js

@@ -16,8 +16,9 @@ function calculateLevels(hierarchy) {
     const visited = new Set();
     // Função recursiva para calcular nível
     const calculateLevel = (entityId) => {
-        if (levels.has(entityId)) {
-            return levels.get(entityId);
+        const cachedLevel = levels.get(entityId);
+        if (cachedLevel !== undefined) {
+            return cachedLevel;
         }
         if (visited.has(entityId)) {
             // Ciclo detectado, retornar 0 como fallback
@@ -46,7 +47,7 @@ function calculateLevels(hierarchy) {
 /**
  * Organiza entidades por nível (geração) e calcula posições hierárquicas
  */
-function calculateHierarchicalPositions(data, hierarchy, nodeWidth, nodeHeight, horizontalSpacing, verticalSpacing) {
+function calculateHierarchicalPositions(_data, hierarchy, nodeWidth, nodeHeight, horizontalSpacing, verticalSpacing) {
     const positions = new Map();
     const levels = calculateLevels(hierarchy);
     // Agrupar entidades por nível
@@ -55,12 +56,14 @@ function calculateHierarchicalPositions(data, hierarchy, nodeWidth, nodeHeight,
         if (!entitiesByLevel.has(level)) {
             entitiesByLevel.set(level, []);
         }
-        entitiesByLevel.get(level).push(entityId);
+        entitiesByLevel.get(level)?.push(entityId);
     });
     // Calcular posições para cada nível, começando do nível 0 (raiz)
     const sortedLevels = Array.from(entitiesByLevel.keys()).sort((a, b) => a - b);
     sortedLevels.forEach((level) => {
         const entityIds = entitiesByLevel.get(level);
+        if (!entityIds)
+            return;
         // Ordenar entidades do mesmo nível (por ID para consistência)
         entityIds.sort();
         // Calcular posição Y baseada no nível (pais acima, filhos abaixo)
@@ -91,10 +94,13 @@ function calculateHierarchicalPositions(data, hierarchy, nodeWidth, nodeHeight,
         // Ajustar posições para evitar sobreposição
         entityIds.forEach((entityId, index) => {
             const currentPos = positions.get(entityId);
-            const minX = currentPos.x;
+            if (!currentPos)
+                return;
             // Verificar se há sobreposição com outros nós do mesmo nível
             entityIds.slice(0, index).forEach((otherId) => {
                 const otherPos = positions.get(otherId);
+                if (!otherPos)
+                    return;
                 if (Math.abs(currentPos.x - otherPos.x) < nodeWidth + horizontalSpacing) {
                     // Ajustar para evitar sobreposição
                     currentPos.x = otherPos.x + nodeWidth + horizontalSpacing;

package/dist/index.d.ts

@@ -15,4 +15,6 @@ export * from "./hooks/useResizable";
 export * from "./hooks/useScriptEditor";
 export * from "./hooks/useStatCard";
 export * from "./hooks/useTimeTracker";
+export * from "./hooks/useAutocomplete";
+export * from "./hooks/useDashboardLayout";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AAErC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AAErC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}