@imj_media/tareas 1.5.53 → 1.5.55

package/dist/src/components/kanban-bulk/KanbanBulkToolbar.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Barra masiva con el **`Toolbar`** del design system (sin tocar `packages/ui`):
+ *
+ * 1. Primera vista: acciones “Mover a …”.
+ * 2. Segunda vista (addons): bloque `(n) Seleccionados` + Cancelar / Confirmar.
+ *
+ * Modo controlado (`activeButtonId`). Tras confirmar con éxito: invalidación vía `invalidateAfterBulkSuccess`.
+ */
+export declare function KanbanBulkToolbar(): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/kanban-bulk/kanbanBulkToolbar.buttons.d.ts

@@ -0,0 +1,21 @@
+import { ToolbarButton } from '@imj_media/ui';
+import { KanbanColumnTitle } from '../../context/kanbanBulkSelection.context';
+import { BulkUpdateTaskStatusEstatus } from '../../core/types/bulk-update-task-status.types';
+export declare const KANBAN_BULK_TOOLBAR_IDS: {
+    readonly MOVE_TO_TRABAJANDO: "kanban-bulk-move-trabajando";
+    readonly MOVE_TO_POR_HACER: "kanban-bulk-move-por-hacer";
+    readonly MOVE_TO_COMPLETADAS: "kanban-bulk-move-completadas";
+};
+type BuildParams = {
+    baseColumn: KanbanColumnTitle | null;
+    setPendingTargetStatus: (status: BulkUpdateTaskStatusEstatus | null) => void;
+    setActiveButtonId: (id: string | null) => void;
+    onConfirmBulkMove: () => void;
+    isBulkLoading: boolean;
+};
+/**
+ * Botones de la primera vista del `Toolbar`: cada “mover” abre la segunda vista (addons) donde el DS
+ * muestra `count` + `text` junto a Cancelar / Confirmar.
+ */
+export declare function buildKanbanBulkToolbarButtons(p: BuildParams): ToolbarButton[];
+export {};

package/dist/src/components/organisms/Board.d.ts

@@ -7,6 +7,8 @@ interface IBoard {
     isFetching?: boolean;
     isLoadingData?: boolean;
     total?: number;
+    /** Tableros con modo masivo: devuelve los ids de la columna (paginado en listado, en memoria en campaña). */
+    bulkSelectAllIds?: () => Promise<number[]>;
 }
-declare const Board: ({ title, tasks, loadNextPage, isFetching, total }: IBoard) => import("react/jsx-runtime").JSX.Element;
+declare const Board: ({ title, tasks, loadNextPage, isFetching, total, bulkSelectAllIds }: IBoard) => import("react/jsx-runtime").JSX.Element;
 export default Board;

package/dist/src/components/organisms/ButtonMoveTask.d.ts

@@ -8,6 +8,11 @@ type ButtonMoveTaskProps = {
     projectID: number;
     atrasoId?: number;
     categoria?: ICategory | null;
+    /**
+     * Kanban general: desactiva el menú «mover» mientras hay multiselección masiva activa en la columna,
+     * para no combinar PUT/POST individuales con el flujo del toolbar (regresión / UX).
+     */
+    disabled?: boolean;
 };
-declare const ButtonMoveTask: ({ status, nameRequiredTask, statusRequiredTask, id, statusLateTask, projectID, atrasoId, categoria }: ButtonMoveTaskProps) => import("react/jsx-runtime").JSX.Element;
+declare const ButtonMoveTask: ({ status, nameRequiredTask, statusRequiredTask, id, statusLateTask, projectID, atrasoId, categoria, disabled, }: ButtonMoveTaskProps) => import("react/jsx-runtime").JSX.Element;
 export default ButtonMoveTask;

package/dist/src/components/organisms/PauseTaskFloatingMenu.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode, RefObject } from 'react';
+type PauseTaskFloatingMenuProps = {
+    idTask: number;
+    paused: boolean;
+    popupId: string;
+    children: (triggerRef: RefObject<HTMLButtonElement>) => ReactNode;
+};
+/**
+ * Encapsula el patrón del menú flotante de pausa/reanudar para reutilizarlo
+ * en `Task` y `ChildTask` sin duplicar la lógica de apertura/cierre.
+ */
+declare const PauseTaskFloatingMenu: ({ idTask, paused, popupId, children }: PauseTaskFloatingMenuProps) => import("react/jsx-runtime").JSX.Element;
+export default PauseTaskFloatingMenu;

package/dist/src/components/organisms/Task.d.ts

@@ -1,3 +1,13 @@
+import { KanbanColumnTitle } from '../../context/kanbanBulkSelection.context';
 import { TasksKanbanGeneral } from '../../infraestructure/interfaces/tasks-kanban-general';
-declare const Task: ({ id, task, endDate, users, willBePaused, nameProject, comments, priority, difficulty, responsible, nameRequiredTask, nameRequiredTaskResponsible, statusRequiredTask, status, repeatsToDo, repeats, medioName, paused, idProject, atraso, categoria, cambio_arte, name_father_required_task, name_father_required_task_responsible, }: TasksKanbanGeneral) => import("react/jsx-runtime").JSX.Element;
+type TaskProps = TasksKanbanGeneral & {
+    /**
+     * Kanban general: columna de la tarjeta; `Board` lo envía cuando existe el provider de multiselección.
+     * Sin esto no hay lógica de selección masiva (p. ej. campaña).
+     */
+    boardColumnTitle?: KanbanColumnTitle;
+    /** Columna no base durante una sesión masiva: sin interacción con las cards. */
+    isBulkColumnLocked?: boolean;
+};
+declare const Task: ({ id, task, endDate, users, willBePaused, nameProject, comments, priority, difficulty, responsible, nameRequiredTask, nameRequiredTaskResponsible, statusRequiredTask, status, repeatsToDo, repeats, medioName, paused, idProject, atraso, categoria, cambio_arte, name_father_required_task, name_father_required_task_responsible, boardColumnTitle, isBulkColumnLocked, }: TaskProps) => import("react/jsx-runtime").JSX.Element;
 export default Task;

package/dist/src/context/kanbanBulkSelection.context.d.ts

@@ -0,0 +1,58 @@
+import { QueryClient } from '@tanstack/react-query';
+import { ReactNode } from 'react';
+import { BulkUpdateTaskStatusEstatus } from '../core/types/bulk-update-task-status.types';
+/**
+ * Tras un bulk-update exitoso, el tablero que montó el provider decide qué queries invalidar
+ * (listado infinito vs campaña `tasksProject`, etc.). Misma firma para ambos Kanban.
+ */
+export type KanbanBulkInvalidateAfterSuccess = (queryClient: QueryClient) => Promise<void>;
+/** Títulos de columna compartidos por Kanban listado y Kanban campaña (`Board`). */
+export type KanbanColumnTitle = 'Por hacer' | 'Trabajando' | 'Completadas';
+export type KanbanBulkSelectionContextValue = {
+    selectedTaskIds: number[];
+    baseColumn: KanbanColumnTitle | null;
+    /** Hay al menos un id seleccionado (útil para contadores en toolbar). */
+    isMultiSelectActive: boolean;
+    /** Hay “sesión” de selección masiva: columna base fijada; otras columnas bloqueadas hasta la X del toolbar. */
+    isBulkSessionActive: boolean;
+    isFullColumnSelected: boolean;
+    /**
+     * Destino del POST masivo (`BulkUpdateTaskStatusParams.estatus`: 0 por hacer, 1 trabajando, 2 completadas).
+     * Se asigna al elegir “Mover a …”; `null` si no hay confirmación pendiente.
+     */
+    pendingTargetStatus: BulkUpdateTaskStatusEstatus | null;
+    isBulkLoading: boolean;
+    /** Lo inyecta el provider padre; la toolbar lo usa tras un bulk exitoso. */
+    invalidateAfterBulkSuccess: KanbanBulkInvalidateAfterSuccess;
+    toggleTaskSelection: (taskId: number, columnTitle: KanbanColumnTitle) => void;
+    /**
+     * Quita todos los ids y el flag «toda la columna seleccionada».
+     * Si al quedar 0 ids sigue había sesión masiva (`baseColumn` no nulo), el efecto de sincronización
+     * del provider llama a `exitBulkSelectionMode()` y cierra el modo por completo (igual que la X de la toolbar).
+     */
+    deselectAllSelectedTasks: () => void;
+    /**
+     * Cierra el modo por completo (toolbar X): ids, columna base, fases y loading.
+     */
+    exitBulkSelectionMode: () => void;
+    /**
+     * “Seleccionar todas” en la columna indicada: obtiene ids (paginado en listado, o en memoria en campaña) y los asigna.
+     * Si aún no hay baseColumn, la fija en `columnTitle`.
+     */
+    selectEntireColumn: (columnTitle: KanbanColumnTitle, fetchAllIds: () => Promise<number[]>) => Promise<void>;
+    setPendingTargetStatus: (status: BulkUpdateTaskStatusEstatus | null) => void;
+    setIsBulkLoading: (loading: boolean) => void;
+};
+type KanbanBulkSelectionProviderProps = {
+    children: ReactNode;
+    invalidateAfterBulkSuccess: KanbanBulkInvalidateAfterSuccess;
+};
+/**
+ * Estado de multiselección masiva para cualquier tablero que use `Board`/`Task` con las tres columnas estándar.
+ * Cada vista (Kanban listado, Kanban campaña) monta su propio provider y pasa la invalidación de queries que corresponda.
+ */
+export declare function KanbanBulkSelectionProvider({ children, invalidateAfterBulkSuccess, }: KanbanBulkSelectionProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useKanbanBulkSelection(): KanbanBulkSelectionContextValue;
+/** Sin provider: `undefined` (p. ej. Kanban de campaña sin modo masivo o vistas sin tablero). */
+export declare function useKanbanBulkSelectionOptional(): KanbanBulkSelectionContextValue;
+export {};

package/dist/src/core/actions/bulk-update-task-status.action.d.ts

@@ -0,0 +1,16 @@
+import { AxiosInstance } from 'axios';
+import { BulkUpdateTaskStatusParams, BulkUpdateTaskStatusResponse } from '../types/bulk-update-task-status.types';
+/**
+ * POST masivo sobre `tasks_api` (misma baseURL que el resto de tareas). Debe coincidir con backend/doc desplegados;
+ * evitar rutas duplicadas tipo `…/tareas/tareas/…`.
+ */
+export declare const BULK_UPDATE_TASK_STATUS_PATH = "/api/tareas/bulk-update-status";
+/**
+ * Envía el POST masivo usando la instancia `tasks_api` del contexto (Bearer y baseURL ya configurados).
+ * No lanza si el 200 incluye `notFoundIds`: es parte del contrato exitoso; el consumidor decide cómo reconciliar.
+ */
+export declare function bulkUpdateTaskStatus(tasks_api: AxiosInstance, params: BulkUpdateTaskStatusParams): Promise<BulkUpdateTaskStatusResponse>;
+/**
+ * Mensaje legible para errores de red o HTTP al llamar al bulk-update (p. ej. para `mutation.error.message` o toasts en pasos posteriores).
+ */
+export declare function getBulkUpdateTaskStatusErrorMessage(error: unknown): string;

package/dist/src/core/types/bulk-update-task-status.types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Contrato del endpoint de actualización masiva de estatus (Kanban general).
+ * Campos del JSON: `tasks_ids`, `estatus`, `user_id`; `ended_at` opcional cuando el destino es completadas.
+ */
+export type BulkUpdateTaskStatusEstatus = 0 | 1 | 2;
+export interface BulkUpdateTaskStatusParams {
+    tasks_ids: number[];
+    estatus: BulkUpdateTaskStatusEstatus;
+    user_id: number;
+    /** ISO 8601; aplica cuando `estatus === 2`; si se omite, el backend puede usar la fecha actual. */
+    ended_at?: string;
+}
+/** Cuerpo de respuesta HTTP 200 del bulk-update (persistencia aplicada o ids no encontrados sin fallar la petición). */
+export interface BulkUpdateTaskStatusResponse {
+    updatedCount: number;
+    updatedIds: number[];
+    notFoundIds: number[];
+}

package/dist/src/hooks/useBulkUpdateTaskStatus.d.ts

@@ -0,0 +1,18 @@
+import { UseMutationResult } from '@tanstack/react-query';
+import { BulkUpdateTaskStatusParams, BulkUpdateTaskStatusResponse } from '../core/types/bulk-update-task-status.types';
+/**
+ * Variables que puede pasar la UI al mutar: mismos campos que el API excepto `user_id`,
+ * que el hook rellena con el usuario de sesión si no viene en el objeto.
+ */
+export type BulkUpdateTaskStatusMutationPayload = Omit<BulkUpdateTaskStatusParams, 'user_id'> & {
+    user_id?: number;
+};
+/**
+ * Mutación TanStack Query para el bulk-update de estatus (tablero listado y tablero campaña).
+ *
+ * - HTTP: `tasks_api` + `bulkUpdateTaskStatus` (POST a `BULK_UPDATE_TASK_STATUS_PATH`).
+ * - Sin toasts ni logs: el consumidor (p. ej. paso 4) usa `onSuccess` / `onError` o el estado de la mutación.
+ * - Errores axios se convierten en `Error` con texto útil vía `getBulkUpdateTaskStatusErrorMessage`.
+ */
+export declare function useBulkUpdateTaskStatus(): UseMutationResult<BulkUpdateTaskStatusResponse, Error, BulkUpdateTaskStatusMutationPayload>;
+export type { BulkUpdateTaskStatusParams, BulkUpdateTaskStatusResponse };

package/dist/src/hooks/useDoneTasks.d.ts

@@ -1,5 +1,13 @@
 declare const useDoneTasks: () => {
     doneTasks: import('@tanstack/react-query').UseInfiniteQueryResult<import('@tanstack/query-core').InfiniteData<any, unknown>, Error>;
     total: number;
+    filtersToSend: {
+        owner: {
+            user: number;
+            config: any;
+            role: string;
+        };
+        status: string;
+    };
 };
 export default useDoneTasks;

package/dist/src/hooks/useWorkingTasks.d.ts

@@ -1,5 +1,13 @@
 declare const useWorkingTasks: () => {
     workingTasks: import('@tanstack/react-query').UseInfiniteQueryResult<import('@tanstack/query-core').InfiniteData<any, unknown>, Error>;
     total: number;
+    filtersToSend: {
+        owner: {
+            user: number;
+            config: any;
+            role: string;
+        };
+        status: string;
+    };
 };
 export default useWorkingTasks;

package/dist/src/utils/fetchAllKanbanListadoTaskIds.d.ts

@@ -0,0 +1,15 @@
+import { AxiosInstance } from 'axios';
+type KanbanListadoListStatus = 'por_hacer' | 'trabajando' | 'completadas';
+/**
+ * Ids de una columna del tablero **listado** (infinite query + `getTasksResponse`), paginando en cliente.
+ * No aplica al Kanban campaña (ahí los datos vienen en una sola query y los ids se derivan en memoria).
+ *
+ * Solo incluye tareas elegibles para el flujo masivo (misma regla que el menú «mover» en la card),
+ * para que «Seleccionar todas» no marque dependencias aún bloqueadas.
+ */
+export declare function fetchAllKanbanListadoTaskIds(params: {
+    tasks_api: AxiosInstance;
+    filters: Record<string, unknown>;
+    status: KanbanListadoListStatus;
+}): Promise<number[]>;
+export {};

package/dist/src/utils/kanbanTasksQueries.d.ts

@@ -0,0 +1,29 @@
+import { QueryClient } from '@tanstack/react-query';
+/**
+ * Invalidación centralizada de queries de tareas en tableros Kanban (`@tanstack/react-query`).
+ *
+ * **Listado (tres columnas infinitas):** claves `['to_do_tasks', filters]`, etc. Se invalida por **prefijo**
+ * `[root]` para cubrir todas las variantes de filtros (bulk, refresco layout).
+ *
+ * **Campaña:** una sola familia `['tasksProject', filtersToSend, project]`; el prefijo `['tasksProject']`
+ * invalida todas las instancias tras un bulk en el tablero campaña.
+ *
+ * En otros flujos (p. ej. pausa o mover una sola tarea) puede convenir invalidar con la `queryKey` completa
+ * en la mutación concreta; aquí solo agrupamos los casos «invalidar todo el tablero» por familia de clave.
+ */
+/** Raíces alineadas con `useToDoTasks`, `useWorkingTasks` y `useDoneTasks` (tablero listado). */
+export declare const KANBAN_LISTADO_COLUMN_QUERY_ROOTS: readonly ["to_do_tasks", "working_tasks", "done_tasks"];
+/** Raíz de `useQuery` en `InfoCampaniaProvider` (`tasksProject`). */
+export declare const KANBAN_CAMPAIGN_TASKS_QUERY_ROOT: "tasksProject";
+/**
+ * Tras un bulk-update en el tablero **listado**: obsoletas todas las variantes de filtros por columna.
+ */
+export declare function invalidateKanbanListadoTasksQueries(queryClient: QueryClient): Promise<void>;
+/**
+ * Botón “refrescar” del layout en tablero listado: invalida y refetch explícito de las tres columnas.
+ */
+export declare function invalidateAndRefetchKanbanListadoTasks(queryClient: QueryClient): Promise<void>;
+/**
+ * Tras un bulk-update en el tablero **campaña**: obsoleta la query de proyecto (cualquier filtro/proyecto activo).
+ */
+export declare function invalidateKanbanCampaignTasksQueries(queryClient: QueryClient): Promise<void>;

package/dist/src/utils/tanstack.functions.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Tamaño de página del infinite query de las columnas del Kanban **listado** (`useToDoTasks`, etc.).
+ * `fetchAllKanbanListadoTaskIds` y `fetchNextPage` deben usar el mismo valor para no cortar mal el bucle.
+ */
+export declare const KANBAN_LISTADO_INFINITE_PAGE_SIZE = 30;
 export declare const fetchNextPage: (key: any) => void;
 export declare const getPaginationEstructure: (page: number) => {
     pagination: {

package/dist/src/utils/taskKanbanBulkEligibility.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Elegibilidad para multiselección masiva del Kanban (listado y campaña) y para mostrar el menú «mover»
+ * en la card (`Task` → `ButtonMoveTask`): una sola fuente de verdad.
+ *
+ * Incluye:
+ * - **Unidades / repeticiones (rutas):** si la tarea tiene cuota (`repeatsToDo > 0`), no se puede mover ni
+ *   seleccionar en bloque hasta que el contador esté completo (`repeats === repeatsToDo`). Antes, el caso
+ *   `repeatsToDo === 1` se trataba como «sin repeticiones» y permitía `0/1` con menú mover y bulk.
+ * - **Dependencia:** misma regla que el render de `ButtonMoveTask` (tarea previa obligatoria incompleta bloquea).
+ */
+export type TaskKanbanBulkEligibilityInput = {
+    status: number;
+    nameRequiredTask: string | null | undefined;
+    statusRequiredTask: number | null | undefined;
+    repeatsToDo?: number | null | undefined;
+    repeats?: number | null | undefined;
+};
+export declare function isTaskEligibleForKanbanBulkSelection(t: TaskKanbanBulkEligibilityInput): boolean;