@burdenoff/planmagnet-fe-sdk 2026.706.7 → 2026.708.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { onError } from '@apollo/client/link/error';
 import { CombinedGraphQLErrors } from '@apollo/client/errors';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { gql } from '@apollo/client';
-import { CircleX, CircleCheckBig, CircleDotDashed, CircleDot, Circle, CircleDashed, User, Link2, CalendarDays, Trash2, ChevronUp, ChevronDown, ChevronLeft, ChevronRight, Flag, Plus, CalendarRange, List, LayoutGrid, Search, Pencil, SmilePlus } from 'lucide-react';
+import { CircleX, CircleCheckBig, CircleDotDashed, CircleDot, Circle, CircleDashed, User, Link2, CalendarDays, Trash2, ChevronUp, ChevronDown, ChevronLeft, ChevronRight, Flag, Plus, CalendarRange, List, LayoutGrid, Search, Bookmark, Check, Pencil, SmilePlus } from 'lucide-react';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { startOfWeek, format, addDays, addWeeks, endOfWeek, eachDayOfInterval, addMonths, startOfMonth, endOfMonth, isToday, isSameMonth, startOfDay, parseISO, isValid } from 'date-fns';
@@ -282,6 +282,12 @@ var WORK_ITEM_SUMMARY_FIELDS = gql`
     storyPoints
     dueDate
     labels
+    # Board reorder ordering. sortOrder maps a Prisma \`position\` column and is
+    # unsafe to SELECT BACK FROM A MUTATION (serialization crash), but SAFE on
+    # this QUERY read path — a WorkItem.sortOrder field resolver maps position →
+    # sortOrder. The board sorts cards by this ascending so a drag-to-reorder
+    # persists across refetch (the list query itself orders by createdAt).
+    sortOrder
   }
 `;
 var WORK_ITEM_FIELDS = gql`
@@ -406,10 +412,11 @@ var UPDATE_WORK_ITEM = gql`
 var MOVE_WORK_ITEM = gql`
   mutation MoveWorkItem($id: ID!, $input: PlanmagnetMoveWorkItemInput!) {
     planmagnetMoveWorkItem(id: $id, input: $input) {
-      ...WorkItemFields
+      id
+      status
+      sprintId
     }
   }
-  ${WORK_ITEM_FIELDS}
 `;
 var WORK_ITEM_LINK_FIELDS = gql`
   fragment WorkItemLinkFields on WorkItemLink {
@@ -808,6 +815,22 @@ var DEFAULT_TASK_LABELS = {
   allTypes: "All types",
   newTask: "New task",
   myTasks: "My tasks",
+  savedViews: "Views",
+  saveView: "Save current view",
+  viewName: "View name",
+  saveViewAction: "Save",
+  deleteView: "Delete",
+  noSavedViews: "No saved views",
+  defaultViewName: "Default",
+  keyboardShortcuts: "Keyboard shortcuts",
+  shortcutNewTask: "New task",
+  shortcutSearch: "Focus search",
+  shortcutBoardView: "Board view",
+  shortcutListView: "List view",
+  shortcutTimelineView: "Timeline view",
+  shortcutMyTasks: "Toggle My tasks",
+  shortcutHelp: "Toggle this help",
+  shortcutClose: "Close overlay",
   noTasks: "No tasks",
   noTasksFound: "No tasks found.",
   dropHere: "Drop here",
@@ -896,6 +919,7 @@ var DEFAULT_TASK_LABELS = {
   projectRequired: "A projectId is required to create a task.",
   errorLoading: "Error loading tasks",
   moveFailed: "Couldn't move the task. Please try again.",
+  reorderFailed: "Couldn't reorder the task. Please try again.",
   failedToCreate: "Failed to create task",
   failedToSave: "Failed to save",
   failedToDelete: "Failed to delete",
@@ -1094,6 +1118,7 @@ function TaskCard({
   draggable,
   onDragStart,
   onDragEnd,
+  onDragOver,
   dragging,
   resolveAssignee,
   links,
@@ -1128,6 +1153,7 @@ function TaskCard({
       draggable,
       onDragStart: draggable ? (e) => onDragStart?.(task, e) : void 0,
       onDragEnd: draggable ? (e) => onDragEnd?.(task, e) : void 0,
+      onDragOver: draggable ? onDragOver : void 0,
       onClick: onClick ? () => onClick(task) : void 0,
       onKeyDown: handleKey,
       className: cn(
@@ -1223,6 +1249,13 @@ function useWorkItemLinks(workspaceId, sourceProduct, limit = 500) {
   }, [data]);
   return { linksByItem, loading };
 }
+function bySortOrder(tasks) {
+  return tasks.map((task, index) => ({ task, index })).sort((a, b) => {
+    const ao = a.task.sortOrder ?? Number.MAX_SAFE_INTEGER;
+    const bo = b.task.sortOrder ?? Number.MAX_SAFE_INTEGER;
+    return ao === bo ? a.index - b.index : ao - bo;
+  }).map((entry) => entry.task);
+}
 function TaskBoardCore({
   projectId,
   columns = DEFAULT_BOARD_COLUMNS,
@@ -1249,9 +1282,11 @@ function TaskBoardCore({
   const { linksByItem } = useWorkItemLinks(workspaceId, linkSourceProduct);
   const [draggingId, setDraggingId] = useState(null);
   const [dragOver, setDragOver] = useState(null);
+  const [dropIndex, setDropIndex] = useState(null);
   const [moveError, setMoveError] = useState(null);
   const [pendingMove, setPendingMove] = useState(null);
   const [updateItem] = useMutation(UPDATE_WORK_ITEM);
+  const [moveItem] = useMutation(MOVE_WORK_ITEM);
   const { data, loading, error } = useQuery(
     LIST_WORK_ITEMS,
     {
@@ -1280,6 +1315,44 @@ function TaskBoardCore({
     },
     [client, updateItem, L]
   );
+  const reorderTask = useCallback(
+    (columnTasks, fromIndex, toIndex) => {
+      if (fromIndex === toIndex || fromIndex < 0) return;
+      const ordered = columnTasks.slice();
+      const [moved] = ordered.splice(fromIndex, 1);
+      if (!moved) return;
+      const insertAt = Math.max(0, Math.min(toIndex, ordered.length));
+      ordered.splice(insertAt, 0, moved);
+      const changed = [];
+      ordered.forEach((task, index) => {
+        const prev = task.sortOrder ?? null;
+        if (prev !== index) {
+          changed.push({ id: task.id, from: prev, to: index });
+        }
+      });
+      if (changed.length === 0) return;
+      setMoveError(null);
+      const setOrder = (id, value) => {
+        const cacheId = client.cache.identify({ __typename: "WorkItem", id });
+        if (cacheId) {
+          client.cache.modify({
+            id: cacheId,
+            fields: { sortOrder: () => value }
+          });
+        }
+      };
+      for (const c of changed) setOrder(c.id, c.to);
+      Promise.all(
+        changed.map(
+          (c) => moveItem({ variables: { id: c.id, input: { sortOrder: c.to } } })
+        )
+      ).catch(() => {
+        for (const c of changed) setOrder(c.id, c.from);
+        setMoveError(L.reorderFailed);
+      });
+    },
+    [client, moveItem, L]
+  );
   if (!workspaceId) {
     return /* @__PURE__ */ jsx("div", { className: cn("p-6 text-sm text-destructive", className), children: "TaskBoard: no workspaceId provided (prop or PlanMagnetProvider)." });
   }
@@ -1306,18 +1379,41 @@ function TaskBoardCore({
     return true;
   });
   const canDrag = !readonly;
+  const columnTasksFor = (status) => bySortOrder(filtered.filter((t) => t.status === status));
   const onColumnDragOver = (status) => (e) => {
     if (!canDrag || !draggingId) return;
     e.preventDefault();
     if (dragOver !== status) setDragOver(status);
+    if (dropIndex === null) setDropIndex(columnTasksFor(status).length);
+  };
+  const onCardDragOver = (status, index) => (e) => {
+    if (!canDrag || !draggingId) return;
+    e.preventDefault();
+    e.stopPropagation();
+    if (dragOver !== status) setDragOver(status);
+    const rect = e.currentTarget.getBoundingClientRect();
+    const after = e.clientY - rect.top > rect.height / 2;
+    const next = after ? index + 1 : index;
+    if (dropIndex !== next) setDropIndex(next);
+  };
+  const clearDrag = () => {
+    setDragOver(null);
+    setDraggingId(null);
+    setDropIndex(null);
   };
   const onColumnDrop = (status) => (e) => {
     if (!canDrag) return;
     e.preventDefault();
     const task = tasks.find((t) => t.id === draggingId);
-    setDragOver(null);
-    setDraggingId(null);
-    if (!task || task.status === status) return;
+    const targetIndex = dropIndex;
+    clearDrag();
+    if (!task) return;
+    if (task.status === status) {
+      const colTasks = columnTasksFor(status);
+      const fromIndex = colTasks.findIndex((t) => t.id === task.id);
+      if (targetIndex !== null) reorderTask(colTasks, fromIndex, targetIndex);
+      return;
+    }
     if (confirmMove) setPendingMove({ task, toStatus: status });
     else moveTask(task, status);
   };
@@ -1332,8 +1428,9 @@ function TaskBoardCore({
     ] }),
     moveError && /* @__PURE__ */ jsx("div", { className: "rounded-md border border-destructive/40 bg-destructive/10 px-3 py-1.5 text-xs text-destructive", children: moveError }),
     /* @__PURE__ */ jsx("div", { className: "flex gap-3 overflow-x-auto pb-2", children: columns.map((col) => {
-      const colTasks = filtered.filter((t) => t.status === col.status);
+      const colTasks = columnTasksFor(col.status);
       const isOver = dragOver === col.status;
+      const showDropLine = canDrag && isOver && dropIndex !== null && colTasks.some((t) => t.id === draggingId);
       return /* @__PURE__ */ jsxs(
         "div",
         {
@@ -1352,29 +1449,45 @@ function TaskBoardCore({
               ] }),
               /* @__PURE__ */ jsx("span", { className: "rounded-full bg-muted px-1.5 text-xs font-medium text-muted-foreground", children: colTasks.length })
             ] }),
-            /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-2 px-2 pb-2", children: colTasks.length === 0 ? /* @__PURE__ */ jsx("div", { className: "rounded-md border border-dashed border-border/70 px-3 py-6 text-center text-xs text-muted-foreground", children: isOver ? L.dropHere : L.noTasks }) : colTasks.map((task) => /* @__PURE__ */ jsx(
-              TaskCard,
-              {
-                task,
-                hidden,
-                onClick: onTaskClick,
-                draggable: canDrag,
-                dragging: draggingId === task.id,
-                resolveAssignee,
-                links: linksByItem.get(task.id),
-                renderLinkIcon,
-                onDragStart: (t, e) => {
-                  setDraggingId(t.id);
-                  e.dataTransfer.effectAllowed = "move";
-                  e.dataTransfer.setData("text/plain", t.id);
-                },
-                onDragEnd: () => {
-                  setDraggingId(null);
-                  setDragOver(null);
+            /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-2 px-2 pb-2", children: colTasks.length === 0 ? /* @__PURE__ */ jsx("div", { className: "rounded-md border border-dashed border-border/70 px-3 py-6 text-center text-xs text-muted-foreground", children: isOver ? L.dropHere : L.noTasks }) : colTasks.map((task, index) => /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2", children: [
+              showDropLine && dropIndex === index && /* @__PURE__ */ jsx(
+                "div",
+                {
+                  "aria-hidden": "true",
+                  "data-testid": "reorder-drop-line",
+                  className: "h-0.5 rounded-full bg-primary"
                 }
-              },
-              task.id
-            )) })
+              ),
+              /* @__PURE__ */ jsx(
+                TaskCard,
+                {
+                  task,
+                  hidden,
+                  onClick: onTaskClick,
+                  draggable: canDrag,
+                  dragging: draggingId === task.id,
+                  resolveAssignee,
+                  links: linksByItem.get(task.id),
+                  renderLinkIcon,
+                  onDragOver: onCardDragOver(col.status, index),
+                  onDragStart: (t, e) => {
+                    setDraggingId(t.id);
+                    setDropIndex(null);
+                    e.dataTransfer.effectAllowed = "move";
+                    e.dataTransfer.setData("text/plain", t.id);
+                  },
+                  onDragEnd: clearDrag
+                }
+              ),
+              showDropLine && index === colTasks.length - 1 && dropIndex >= colTasks.length && /* @__PURE__ */ jsx(
+                "div",
+                {
+                  "aria-hidden": "true",
+                  "data-testid": "reorder-drop-line",
+                  className: "h-0.5 rounded-full bg-primary"
+                }
+              )
+            ] }, task.id)) })
           ]
         },
         col.status
@@ -2796,6 +2909,7 @@ function TaskToolbar({
   views = ["board", "list", "timeline"],
   search,
   onSearchChange,
+  searchInputRef,
   priority,
   onPriorityChange,
   type,
@@ -2804,6 +2918,7 @@ function TaskToolbar({
   canCreate,
   mine,
   onMineChange,
+  leadingActions,
   className
 }) {
   const L = useTaskLabels();
@@ -2852,6 +2967,7 @@ function TaskToolbar({
           }
         ),
         /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [
+          leadingActions,
           /* @__PURE__ */ jsxs("div", { className: "relative", children: [
             /* @__PURE__ */ jsx(
               Search,
@@ -2863,6 +2979,7 @@ function TaskToolbar({
             /* @__PURE__ */ jsx(
               "input",
               {
+                ref: searchInputRef,
                 type: "search",
                 value: search,
                 onChange: (e) => onSearchChange(e.target.value),
@@ -3921,6 +4038,300 @@ function TaskDetail({
     }
   );
 }
+function SavedViewsMenu({
+  views,
+  activeViewId,
+  onSaveView,
+  onApplyView,
+  onDeleteView,
+  className
+}) {
+  const L = useTaskLabels();
+  const [open, setOpen] = useState(false);
+  const [naming, setNaming] = useState(false);
+  const [name, setName] = useState("");
+  const rootRef = useRef(null);
+  useEffect(() => {
+    if (!open) return;
+    const onDown = (e) => {
+      if (rootRef.current && !rootRef.current.contains(e.target)) {
+        setOpen(false);
+        setNaming(false);
+      }
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") {
+        setOpen(false);
+        setNaming(false);
+      }
+    };
+    document.addEventListener("mousedown", onDown);
+    document.addEventListener("keydown", onKey);
+    return () => {
+      document.removeEventListener("mousedown", onDown);
+      document.removeEventListener("keydown", onKey);
+    };
+  }, [open]);
+  const activeName = views.find((v) => v.id === activeViewId)?.name ?? L.defaultViewName;
+  const commitSave = () => {
+    const trimmed = name.trim();
+    if (!trimmed) return;
+    onSaveView(trimmed);
+    setName("");
+    setNaming(false);
+    setOpen(false);
+  };
+  return /* @__PURE__ */ jsxs("div", { ref: rootRef, className: cn("relative", className), children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: () => setOpen((o) => !o),
+        "aria-haspopup": "menu",
+        "aria-expanded": open,
+        "aria-label": L.savedViews,
+        className: cn(
+          "flex h-8 max-w-[10rem] items-center gap-1.5 rounded-md border px-2.5 text-xs font-medium transition-colors",
+          activeViewId ? "border-primary bg-primary/10 text-primary" : "border-border bg-background text-muted-foreground hover:bg-muted/50 hover:text-foreground"
+        ),
+        children: [
+          /* @__PURE__ */ jsx(Bookmark, { className: "h-3.5 w-3.5 shrink-0", "aria-hidden": "true" }),
+          /* @__PURE__ */ jsx("span", { className: "truncate", children: activeName })
+        ]
+      }
+    ),
+    open && /* @__PURE__ */ jsxs(
+      "div",
+      {
+        role: "menu",
+        className: "absolute right-0 top-full z-30 mt-1 w-56 rounded-md border border-border bg-popover p-1 text-popover-foreground shadow-md",
+        children: [
+          /* @__PURE__ */ jsx("div", { className: "px-2 py-1 text-[0.65rem] font-semibold uppercase tracking-wide text-muted-foreground", children: L.savedViews }),
+          views.length === 0 ? /* @__PURE__ */ jsx("div", { className: "px-2 py-1.5 text-xs text-muted-foreground", children: L.noSavedViews }) : /* @__PURE__ */ jsx("ul", { className: "max-h-56 overflow-auto", children: views.map((v) => {
+            const active = v.id === activeViewId;
+            return /* @__PURE__ */ jsxs("li", { className: "flex items-center gap-1", children: [
+              /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  type: "button",
+                  role: "menuitemradio",
+                  "aria-checked": active,
+                  onClick: () => {
+                    onApplyView(v.id);
+                    setOpen(false);
+                  },
+                  className: cn(
+                    "flex min-w-0 flex-1 items-center gap-1.5 rounded px-2 py-1.5 text-left text-xs transition-colors hover:bg-muted/60",
+                    active ? "text-foreground" : "text-muted-foreground"
+                  ),
+                  children: [
+                    /* @__PURE__ */ jsx(
+                      Check,
+                      {
+                        className: cn(
+                          "h-3.5 w-3.5 shrink-0",
+                          active ? "opacity-100" : "opacity-0"
+                        ),
+                        "aria-hidden": "true"
+                      }
+                    ),
+                    /* @__PURE__ */ jsx("span", { className: "truncate", children: v.name })
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => onDeleteView(v.id),
+                  "aria-label": `${L.deleteView}: ${v.name}`,
+                  className: "shrink-0 rounded p-1 text-muted-foreground transition-colors hover:bg-destructive/10 hover:text-destructive",
+                  children: /* @__PURE__ */ jsx(Trash2, { className: "h-3.5 w-3.5", "aria-hidden": "true" })
+                }
+              )
+            ] }, v.id);
+          }) }),
+          /* @__PURE__ */ jsx("div", { className: "my-1 h-px bg-border" }),
+          naming ? /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 p-1", children: [
+            /* @__PURE__ */ jsx(
+              "input",
+              {
+                type: "text",
+                autoFocus: true,
+                value: name,
+                onChange: (e) => setName(e.target.value),
+                onKeyDown: (e) => {
+                  if (e.key === "Enter") commitSave();
+                },
+                placeholder: L.viewName,
+                "aria-label": L.viewName,
+                className: "h-7 min-w-0 flex-1 rounded border border-border bg-background px-2 text-xs text-foreground placeholder:text-muted-foreground focus:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                onClick: commitSave,
+                disabled: !name.trim(),
+                className: "h-7 shrink-0 rounded bg-primary px-2 text-xs font-medium text-primary-foreground transition-colors hover:bg-primary/90 disabled:opacity-50",
+                children: L.saveViewAction
+              }
+            )
+          ] }) : /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              role: "menuitem",
+              onClick: () => setNaming(true),
+              className: "flex w-full items-center gap-1.5 rounded px-2 py-1.5 text-left text-xs font-medium text-foreground transition-colors hover:bg-muted/60",
+              children: [
+                /* @__PURE__ */ jsx(Plus, { className: "h-3.5 w-3.5", "aria-hidden": "true" }),
+                L.saveView
+              ]
+            }
+          )
+        ]
+      }
+    )
+  ] });
+}
+var STORAGE_PREFIX = "planmagnet:views:";
+var DEBOUNCE_MS = 400;
+function makeStorageKey(workspaceId, suffix) {
+  return suffix ? `${STORAGE_PREFIX}${workspaceId}:${suffix}` : `${STORAGE_PREFIX}${workspaceId}`;
+}
+function safeStorage() {
+  try {
+    if (typeof window === "undefined") return null;
+    const ls = window.localStorage;
+    const probe = "__pm_probe__";
+    ls.setItem(probe, probe);
+    ls.removeItem(probe);
+    return ls;
+  } catch {
+    return null;
+  }
+}
+function readPayload(key) {
+  const ls = safeStorage();
+  if (!ls) return null;
+  try {
+    const raw = ls.getItem(key);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed || parsed.v !== 1) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function writePayload(key, payload) {
+  const ls = safeStorage();
+  if (!ls) return;
+  try {
+    ls.setItem(key, JSON.stringify(payload));
+  } catch {
+  }
+}
+function makeId() {
+  const rand = Math.random().toString(36).slice(2, 10);
+  return `v_${Date.now().toString(36)}_${rand}`;
+}
+function useSavedViews({
+  storageKey,
+  enabled,
+  current
+}) {
+  const initial = useMemo(
+    () => enabled ? readPayload(storageKey) : null,
+    [enabled, storageKey]
+  );
+  const [views, setViews] = useState(initial?.views ?? []);
+  const [activeViewId, setActiveViewId] = useState(
+    initial?.activeViewId ?? null
+  );
+  const restored = enabled ? initial?.current ?? null : null;
+  const viewsRef = useRef(views);
+  viewsRef.current = views;
+  const activeViewIdRef = useRef(activeViewId);
+  activeViewIdRef.current = activeViewId;
+  useEffect(() => {
+    if (!enabled) return;
+    const handle = setTimeout(() => {
+      writePayload(storageKey, {
+        v: 1,
+        current,
+        views: viewsRef.current,
+        activeViewId: activeViewIdRef.current
+      });
+    }, DEBOUNCE_MS);
+    return () => clearTimeout(handle);
+  }, [enabled, storageKey, current]);
+  const flush = useCallback(
+    (nextViews, nextActive) => {
+      if (!enabled) return;
+      writePayload(storageKey, {
+        v: 1,
+        current,
+        views: nextViews,
+        activeViewId: nextActive
+      });
+    },
+    [enabled, storageKey, current]
+  );
+  const saveView = useCallback(
+    (name) => {
+      if (!enabled) return null;
+      const trimmed = name.trim();
+      if (!trimmed) return null;
+      const id = makeId();
+      const next = [
+        ...viewsRef.current,
+        { id, name: trimmed, state: current }
+      ];
+      setViews(next);
+      setActiveViewId(id);
+      flush(next, id);
+      return id;
+    },
+    [enabled, current, flush]
+  );
+  const applyView = useCallback(
+    (id) => {
+      const found = viewsRef.current.find((v) => v.id === id);
+      if (!found) return null;
+      setActiveViewId(id);
+      flush(viewsRef.current, id);
+      return found.state;
+    },
+    [flush]
+  );
+  const deleteView = useCallback(
+    (id) => {
+      const next = viewsRef.current.filter((v) => v.id !== id);
+      const nextActive = activeViewIdRef.current === id ? null : activeViewIdRef.current;
+      setViews(next);
+      setActiveViewId(nextActive);
+      flush(next, nextActive);
+    },
+    [flush]
+  );
+  const clearActiveView = useCallback(() => {
+    if (activeViewIdRef.current == null) return;
+    setActiveViewId(null);
+    flush(viewsRef.current, null);
+  }, [flush]);
+  return {
+    restored,
+    views,
+    activeViewId,
+    saveView,
+    applyView,
+    deleteView,
+    clearActiveView
+  };
+}
 function TasksPageCore({
   workspaceId: workspaceIdProp,
   projectId,
@@ -3946,19 +4357,26 @@ function TasksPageCore({
   onTaskSaved,
   createSurface = "modal",
   detailSurface = "drawer",
+  enableSavedViews,
+  persistViewKey,
+  enableShortcuts,
   className
 }) {
   const ctx = usePlanMagnetContextSafe();
   const workspaceId = workspaceIdProp ?? ctx?.workspaceId;
   const client = useApolloClient();
   const mergedLabels = mergeTaskLabels(labels);
+  const savedViewsEnabled = Boolean(enableSavedViews || persistViewKey);
   const [view, setView] = useState(defaultView);
   const [search, setSearch] = useState("");
   const [priority, setPriority] = useState("ALL");
   const [type, setType] = useState("ALL");
   const [mine, setMine] = useState(false);
+  const [savedListColumns, setSavedListColumns] = useState(null);
   const [creating, setCreating] = useState(false);
   const [selectedId, setSelectedId] = useState(null);
+  const [showHelp, setShowHelp] = useState(false);
+  const searchInputRef = useRef(null);
   const [createDefaults, setCreateDefaults] = useState(null);
   useEffect(() => {
     if (openItemId) setSelectedId(openItemId);
@@ -4010,6 +4428,169 @@ function TasksPageCore({
     setSelectedId(task.id);
   }, []);
   const handleSelect = useCallback((id) => setSelectedId(id), []);
+  const persistEnabled = savedViewsEnabled && Boolean(workspaceId);
+  const storageKey = useMemo(
+    () => makeStorageKey(workspaceId ?? "", persistViewKey),
+    [workspaceId, persistViewKey]
+  );
+  const currentViewState = useMemo(
+    () => ({
+      view,
+      priority,
+      type,
+      search,
+      mine,
+      listColumns: savedListColumns
+    }),
+    [view, priority, type, search, mine, savedListColumns]
+  );
+  const applyViewState = useCallback((s) => {
+    setView(s.view);
+    setPriority(s.priority);
+    setType(s.type);
+    setSearch(s.search);
+    setMine(s.mine);
+    setSavedListColumns(s.listColumns);
+  }, []);
+  const {
+    restored,
+    views: savedViews,
+    activeViewId,
+    saveView,
+    applyView,
+    deleteView,
+    clearActiveView
+  } = useSavedViews({
+    storageKey,
+    enabled: persistEnabled,
+    current: currentViewState
+  });
+  const [didRestore, setDidRestore] = useState(false);
+  useEffect(() => {
+    if (didRestore || !persistEnabled) return;
+    if (restored) applyViewState(restored);
+    setDidRestore(true);
+  }, [persistEnabled]);
+  const handleApplySavedView = useCallback(
+    (id) => {
+      const s = applyView(id);
+      if (s) applyViewState(s);
+    },
+    [applyView, applyViewState]
+  );
+  const detachOnEdit = useCallback(() => {
+    if (activeViewId != null) clearActiveView();
+  }, [activeViewId, clearActiveView]);
+  const handleViewChange = useCallback(
+    (v) => {
+      setView(v);
+      detachOnEdit();
+    },
+    [detachOnEdit]
+  );
+  const handleSearchChange = useCallback(
+    (s) => {
+      setSearch(s);
+      detachOnEdit();
+    },
+    [detachOnEdit]
+  );
+  const handlePriorityChange = useCallback(
+    (p) => {
+      setPriority(p);
+      detachOnEdit();
+    },
+    [detachOnEdit]
+  );
+  const handleTypeChange = useCallback(
+    (t) => {
+      setType(t);
+      detachOnEdit();
+    },
+    [detachOnEdit]
+  );
+  const handleMineChange = useCallback(
+    (m) => {
+      setMine(m);
+      detachOnEdit();
+    },
+    [detachOnEdit]
+  );
+  const enabledViews = useMemo(
+    () => views ?? ["board", "list", "timeline"],
+    [views]
+  );
+  const shortcutsCanCreate = !readonly && Boolean(projectId);
+  useEffect(() => {
+    if (!enableShortcuts) return;
+    const onKeyDown = (e) => {
+      if (e.ctrlKey || e.metaKey || e.altKey) return;
+      const target = e.target;
+      if (target) {
+        const tag = target.tagName;
+        if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || target.isContentEditable) {
+          if (e.key !== "Escape") return;
+        }
+      }
+      switch (e.key) {
+        case "c":
+          if (shortcutsCanCreate) {
+            e.preventDefault();
+            startCreate();
+          }
+          break;
+        case "/":
+          e.preventDefault();
+          searchInputRef.current?.focus();
+          break;
+        case "b":
+          if (enabledViews.includes("board")) {
+            e.preventDefault();
+            setView("board");
+          }
+          break;
+        case "l":
+          if (enabledViews.includes("list")) {
+            e.preventDefault();
+            setView("list");
+          }
+          break;
+        case "g":
+          if (enabledViews.includes("timeline")) {
+            e.preventDefault();
+            setView("timeline");
+          }
+          break;
+        case "m":
+          if (currentActorId) {
+            e.preventDefault();
+            setMine((prev) => !prev);
+          }
+          break;
+        case "?":
+          e.preventDefault();
+          setShowHelp((v) => !v);
+          break;
+        case "Escape":
+          if (showHelp) setShowHelp(false);
+          if (creating) cancelCreate();
+          if (selectedId != null) setSelectedId(null);
+          break;
+      }
+    };
+    document.addEventListener("keydown", onKeyDown);
+    return () => document.removeEventListener("keydown", onKeyDown);
+  }, [
+    enableShortcuts,
+    enabledViews,
+    shortcutsCanCreate,
+    currentActorId,
+    creating,
+    selectedId,
+    showHelp,
+    startCreate,
+    cancelCreate
+  ]);
   if (!workspaceId) {
     return /* @__PURE__ */ jsx("div", { className: cn("p-6 text-sm text-destructive", className), children: "TasksPage: no workspaceId provided (prop or PlanMagnetProvider)." });
   }
@@ -4050,32 +4631,37 @@ function TasksPageCore({
   const listPriority = priority === "ALL" ? void 0 : priority;
   const listType = type === "ALL" ? void 0 : type;
   const mineAssignee = mine && currentActorId ? currentActorId : void 0;
-  const listColumns = linkSourceProduct ? [
-    "title",
-    "status",
-    "priority",
-    "assignee",
-    "dueDate",
-    "linkedRecord"
-  ] : void 0;
+  const derivedListColumns = linkSourceProduct ? ["title", "status", "priority", "assignee", "dueDate", "linkedRecord"] : void 0;
+  const listColumns = savedListColumns ?? derivedListColumns;
   return /* @__PURE__ */ jsx(TaskLabelsProvider, { value: mergedLabels, children: /* @__PURE__ */ jsxs("div", { className: cn("space-y-4 p-6", className), children: [
     header && /* @__PURE__ */ jsx("div", { className: "min-w-0", children: typeof header === "string" ? /* @__PURE__ */ jsx("h1", { className: "truncate text-2xl font-semibold text-foreground", children: header }) : header }),
     /* @__PURE__ */ jsx(
       TaskToolbar,
       {
         view,
-        onViewChange: setView,
+        onViewChange: savedViewsEnabled ? handleViewChange : setView,
         views,
         search,
-        onSearchChange: setSearch,
+        onSearchChange: savedViewsEnabled ? handleSearchChange : setSearch,
+        searchInputRef: enableShortcuts ? searchInputRef : void 0,
         priority,
-        onPriorityChange: setPriority,
+        onPriorityChange: savedViewsEnabled ? handlePriorityChange : setPriority,
         type,
-        onTypeChange: setType,
+        onTypeChange: savedViewsEnabled ? handleTypeChange : setType,
         onNewTask: startCreate,
         canCreate,
         mine,
-        onMineChange: currentActorId ? setMine : void 0
+        onMineChange: currentActorId ? savedViewsEnabled ? handleMineChange : setMine : void 0,
+        leadingActions: savedViewsEnabled ? /* @__PURE__ */ jsx(
+          SavedViewsMenu,
+          {
+            views: savedViews,
+            activeViewId,
+            onSaveView: saveView,
+            onApplyView: handleApplySavedView,
+            onDeleteView: deleteView
+          }
+        ) : void 0
       }
     ),
     showInlineCreate && /* @__PURE__ */ jsx("div", { children: createForm }),
@@ -4153,9 +4739,60 @@ function TasksPageCore({
         ariaLabel: "Task detail",
         children: /* @__PURE__ */ jsx("div", { className: "p-2 pt-8", children: detailView })
       }
+    ),
+    enableShortcuts && /* @__PURE__ */ jsx(
+      Modal,
+      {
+        open: showHelp,
+        onClose: () => setShowHelp(false),
+        ariaLabel: mergedLabels.keyboardShortcuts,
+        className: "max-w-sm",
+        children: /* @__PURE__ */ jsx(
+          ShortcutsHelp,
+          {
+            labels: mergedLabels,
+            enabledViews,
+            canCreate,
+            showMine: Boolean(currentActorId)
+          }
+        )
+      }
     )
   ] }) });
 }
+function ShortcutRow({ keys, label }) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-4 py-1.5", children: [
+    /* @__PURE__ */ jsx("span", { className: "text-sm text-foreground", children: label }),
+    /* @__PURE__ */ jsx("span", { className: "flex items-center gap-1", children: keys.map((k) => /* @__PURE__ */ jsx(
+      "kbd",
+      {
+        className: "inline-flex min-w-[1.5rem] items-center justify-center rounded border border-border bg-muted px-1.5 py-0.5 text-xs font-medium text-muted-foreground",
+        children: k
+      },
+      k
+    )) })
+  ] });
+}
+function ShortcutsHelp({
+  labels: L,
+  enabledViews,
+  canCreate,
+  showMine
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "p-6 pt-8", children: [
+    /* @__PURE__ */ jsx("h2", { className: "mb-3 text-base font-semibold text-foreground", children: L.keyboardShortcuts }),
+    /* @__PURE__ */ jsxs("div", { className: "divide-y divide-border", children: [
+      canCreate && /* @__PURE__ */ jsx(ShortcutRow, { keys: ["c"], label: L.shortcutNewTask }),
+      /* @__PURE__ */ jsx(ShortcutRow, { keys: ["/"], label: L.shortcutSearch }),
+      enabledViews.includes("board") && /* @__PURE__ */ jsx(ShortcutRow, { keys: ["b"], label: L.shortcutBoardView }),
+      enabledViews.includes("list") && /* @__PURE__ */ jsx(ShortcutRow, { keys: ["l"], label: L.shortcutListView }),
+      enabledViews.includes("timeline") && /* @__PURE__ */ jsx(ShortcutRow, { keys: ["g"], label: L.shortcutTimelineView }),
+      showMine && /* @__PURE__ */ jsx(ShortcutRow, { keys: ["m"], label: L.shortcutMyTasks }),
+      /* @__PURE__ */ jsx(ShortcutRow, { keys: ["?"], label: L.shortcutHelp }),
+      /* @__PURE__ */ jsx(ShortcutRow, { keys: ["Esc"], label: L.shortcutClose })
+    ] })
+  ] });
+}
 function TasksPage({
   apiGatewayUrl,
   authToken,
@@ -4185,6 +4822,6 @@ function TasksPage({
   );
 }
 
-export { Avatar, BULK_UPDATE_WORK_ITEMS, Badge, CREATE_WORK_ITEM, CREATE_WORK_ITEM_LINK, CreateTask, CreateTaskCore, DEFAULT_BOARD_COLUMNS, DEFAULT_TASK_LABELS, DELETE_WORK_ITEM, DELETE_WORK_ITEM_LINK, Drawer, GET_PROJECTS, GET_WORK_ITEM, LIST_MILESTONES, LIST_WORK_ITEMS, LIST_WORK_ITEM_LINKS, LinkChip, MILESTONE_FIELDS, MOVE_WORK_ITEM, Modal, PRIORITY_META, PROJECT_SUMMARY_FIELDS, PlanMagnetProvider, PriorityIndicator, STATUS_META, StatusIcon, StatusPill, TASK_PRIORITIES, TASK_STATUSES, TASK_TYPES, TaskBoard, TaskBoardCore, TaskCard, TaskCommentsCore, TaskDetail, TaskDetailCore, TaskLabelsProvider, TaskList, TaskListCore, TaskTimelineCore, TaskToolbar, TasksPage, TasksPageCore, TypeBadge, UPDATE_WORK_ITEM, WORK_ITEM_FIELDS, WORK_ITEM_LINK_FIELDS, WORK_ITEM_SUMMARY_FIELDS, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, mergeTaskLabels, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, useMilestones, usePlanMagnetContext, usePlanMagnetContextSafe, useTaskLabels, useWorkItemLinks, validateTrustedOrigin, waitForPlanMagnetClient };
+export { Avatar, BULK_UPDATE_WORK_ITEMS, Badge, CREATE_WORK_ITEM, CREATE_WORK_ITEM_LINK, CreateTask, CreateTaskCore, DEFAULT_BOARD_COLUMNS, DEFAULT_TASK_LABELS, DELETE_WORK_ITEM, DELETE_WORK_ITEM_LINK, Drawer, GET_PROJECTS, GET_WORK_ITEM, LIST_MILESTONES, LIST_WORK_ITEMS, LIST_WORK_ITEM_LINKS, LinkChip, MILESTONE_FIELDS, MOVE_WORK_ITEM, Modal, PRIORITY_META, PROJECT_SUMMARY_FIELDS, PlanMagnetProvider, PriorityIndicator, STATUS_META, SavedViewsMenu, StatusIcon, StatusPill, TASK_PRIORITIES, TASK_STATUSES, TASK_TYPES, TaskBoard, TaskBoardCore, TaskCard, TaskCommentsCore, TaskDetail, TaskDetailCore, TaskLabelsProvider, TaskList, TaskListCore, TaskTimelineCore, TaskToolbar, TasksPage, TasksPageCore, TypeBadge, UPDATE_WORK_ITEM, WORK_ITEM_FIELDS, WORK_ITEM_LINK_FIELDS, WORK_ITEM_SUMMARY_FIELDS, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, makeStorageKey, mergeTaskLabels, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, useMilestones, usePlanMagnetContext, usePlanMagnetContextSafe, useSavedViews, useTaskLabels, useWorkItemLinks, validateTrustedOrigin, waitForPlanMagnetClient };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map