@burdenoff/planmagnet-fe-sdk 2026.708.1 → 2026.831.1

package/dist/index.d.ts

@@ -570,6 +570,18 @@ interface CreateTaskCoreProps {
     assigneeOptions?: AssigneeOption[];
     /** Field names to hide on the form. */
     hiddenFields?: CreateTaskField[];
+    /**
+     * Statuses a user may SET, defaulting to every {@link TASK_STATUSES} value.
+     *
+     * ★ A host that narrows the board's `columns` must narrow this too. The board
+     * renders one column per entry and filters by exact status, so a work item in
+     * a status with no column renders NOWHERE — setting it would lose the task.
+     * `TasksPageCore` derives this from `columns` for exactly that reason.
+     *
+     * The item's CURRENT status is always offered even when absent from this list,
+     * so opening a task that predates a narrowing never silently rewrites it.
+     */
+    statuses?: TaskStatus[];
     /** Default values applied on first render. */
     defaultValues?: Partial<CreateTaskInput>;
     /** Hide the form header (title + subtitle). */
@@ -595,7 +607,7 @@ interface CreateTaskCoreProps {
  * Mirrors the TaskBoardCore contract: `workspaceId` from a prop or the
  * PlanMagnetProvider context, `hiddenFields` for host-driven field suppression.
  */
-declare function CreateTaskCore({ projectId: projectIdProp, assigneeOptions, hiddenFields, defaultValues, hideHeader, submitLabel, onCreated, onError, onCancel, className, workspaceId: workspaceIdProp, }: CreateTaskCoreProps): react.JSX.Element;
+declare function CreateTaskCore({ projectId: projectIdProp, assigneeOptions, hiddenFields, statuses, defaultValues, hideHeader, submitLabel, onCreated, onError, onCancel, className, workspaceId: workspaceIdProp, }: CreateTaskCoreProps): react.JSX.Element;
 
 interface CreateTaskProps extends CreateTaskCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -660,6 +672,18 @@ interface TaskListCoreProps {
     /** Free-text search (server-side). */
     search?: string;
     /** Columns to render (order preserved). */
+    /**
+     * Statuses a user may SET, defaulting to every {@link TASK_STATUSES} value.
+     *
+     * ★ A host that narrows the board's `columns` must narrow this too. The board
+     * renders one column per entry and filters by exact status, so a work item in
+     * a status with no column renders NOWHERE — setting it would lose the task.
+     * `TasksPageCore` derives this from `columns` for exactly that reason.
+     *
+     * The item's CURRENT status is always offered even when absent from this list,
+     * so opening a task that predates a narrowing never silently rewrites it.
+     */
+    statuses?: TaskStatus[];
     columns?: TaskListColumn[];
     /** Initial sort key. */
     sortBy?: TaskListSort;
@@ -704,7 +728,7 @@ interface TaskListCoreProps {
  * headers. Filters map to the server-side filter; sort is client-side.
  * BYO-Apollo, semantic-token only, farm-free.
  */
-declare function TaskListCore({ projectId, status, type, priority, assigneeId, search, columns, sortBy, sortDir, hideHeader, onSelect, resolveAssignee, linkSourceProduct, renderLinkIcon, limit, selectable, assigneeOptions, className, workspaceId: workspaceIdProp, }: TaskListCoreProps): react.JSX.Element;
+declare function TaskListCore({ projectId, status, type, priority, assigneeId, search, columns, sortBy, sortDir, hideHeader, onSelect, resolveAssignee, linkSourceProduct, renderLinkIcon, limit, selectable, assigneeOptions, statuses, className, workspaceId: workspaceIdProp, }: TaskListCoreProps): react.JSX.Element;
 
 interface TaskListProps extends TaskListCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -844,6 +868,18 @@ interface TaskDetailCoreProps {
     readonly?: boolean;
     /** Field names to hide. */
     hiddenFields?: TaskDetailField[];
+    /**
+     * Statuses a user may SET, defaulting to every {@link TASK_STATUSES} value.
+     *
+     * ★ A host that narrows the board's `columns` must narrow this too. The board
+     * renders one column per entry and filters by exact status, so a work item in
+     * a status with no column renders NOWHERE — setting it would lose the task.
+     * `TasksPageCore` derives this from `columns` for exactly that reason.
+     *
+     * The item's CURRENT status is always offered even when absent from this list,
+     * so opening a task that predates a narrowing never silently rewrites it.
+     */
+    statuses?: TaskStatus[];
     /** Hide the header (key + title). */
     hideHeader?: boolean;
     /** Called with the updated work item after a successful save. */
@@ -894,7 +930,7 @@ interface TaskDetailCoreProps {
  * edit. Fetches via `planmagnetWorkItem(id)`, saves via
  * `planmagnetUpdateWorkItem`. BYO-Apollo, semantic-token only, farm-free.
  */
-declare function TaskDetailCore({ id, readonly, hiddenFields, hideHeader, onUpdated, onDeleted, onError, resolveAssignee, assigneeOptions, linkSourceProduct, renderLinkIcon, onOpenItem, onAddSubtask, commentsEntityType, currentActorId, onMention, className, }: TaskDetailCoreProps): react.JSX.Element;
+declare function TaskDetailCore({ id, readonly, hiddenFields, statuses, hideHeader, onUpdated, onDeleted, onError, resolveAssignee, assigneeOptions, linkSourceProduct, renderLinkIcon, onOpenItem, onAddSubtask, commentsEntityType, currentActorId, onMention, className, }: TaskDetailCoreProps): react.JSX.Element;
 
 interface TaskDetailProps extends TaskDetailCoreProps {
     /** Workspace API gateway URL (URL mode). */

package/dist/index.js

@@ -1568,6 +1568,7 @@ function CreateTaskCore({
   projectId: projectIdProp,
   assigneeOptions,
   hiddenFields,
+  statuses,
   defaultValues,
   hideHeader,
   submitLabel,
@@ -1577,6 +1578,7 @@ function CreateTaskCore({
   className,
   workspaceId: workspaceIdProp
 }) {
+  const statusOptions = statuses ?? TASK_STATUSES;
   const ctx = usePlanMagnetContextSafe();
   const workspaceId = workspaceIdProp ?? ctx?.workspaceId;
   const projectId = projectIdProp ?? defaultValues?.projectId;
@@ -1721,7 +1723,7 @@ function CreateTaskCore({
             className: cn(fieldClass, "capitalize"),
             value: status,
             onChange: (e) => setStatus(e.target.value),
-            children: TASK_STATUSES.map((s) => /* @__PURE__ */ jsx("option", { value: s, children: L.status[s] }, s))
+            children: statusOptions.map((s) => /* @__PURE__ */ jsx("option", { value: s, children: L.status[s] }, s))
           }
         )
       ] }),
@@ -1960,9 +1962,11 @@ function TaskListCore({
   limit = 200,
   selectable = false,
   assigneeOptions,
+  statuses,
   className,
   workspaceId: workspaceIdProp
 }) {
+  const statusOptions = statuses ?? TASK_STATUSES;
   const ctx = usePlanMagnetContextSafe();
   const workspaceId = workspaceIdProp ?? ctx?.workspaceId;
   const { linksByItem } = useWorkItemLinks(workspaceId, linkSourceProduct);
@@ -2104,7 +2108,7 @@ function TaskListCore({
           className: bulkFieldClass,
           children: [
             /* @__PURE__ */ jsx("option", { value: "", children: L.bulkSetStatus }),
-            TASK_STATUSES.map((s) => /* @__PURE__ */ jsx("option", { value: s, children: L.status[s] }, s))
+            statusOptions.map((s) => /* @__PURE__ */ jsx("option", { value: s, children: L.status[s] }, s))
           ]
         }
       ),
@@ -3523,6 +3527,7 @@ function TaskDetailCore({
   id,
   readonly,
   hiddenFields,
+  statuses,
   hideHeader,
   onUpdated,
   onDeleted,
@@ -3574,6 +3579,8 @@ function TaskDetailCore({
   const [description, setDescription] = useState("");
   const [type, setType] = useState("TASK");
   const [status, setStatus] = useState("BACKLOG");
+  const allowedStatuses = statuses ?? TASK_STATUSES;
+  const statusOptions = allowedStatuses.includes(status) ? allowedStatuses : [...allowedStatuses, status];
   const [priority, setPriority] = useState("NONE");
   const [assigneeId, setAssigneeId] = useState("");
   const [dueDate, setDueDate] = useState("");
@@ -3890,7 +3897,7 @@ function TaskDetailCore({
               className: cn(fieldClass3, "capitalize"),
               value: status,
               onChange: (e) => setStatus(e.target.value),
-              children: TASK_STATUSES.map((s) => /* @__PURE__ */ jsx("option", { value: s, children: L.status[s] }, s))
+              children: statusOptions.map((s) => /* @__PURE__ */ jsx("option", { value: s, children: L.status[s] }, s))
             }
           )
         ] }),
@@ -4362,6 +4369,7 @@ function TasksPageCore({
   enableShortcuts,
   className
 }) {
+  const allowedStatuses = columns?.map((c) => c.status);
   const ctx = usePlanMagnetContextSafe();
   const workspaceId = workspaceIdProp ?? ctx?.workspaceId;
   const client = useApolloClient();
@@ -4602,6 +4610,7 @@ function TasksPageCore({
     {
       workspaceId,
       projectId,
+      statuses: allowedStatuses,
       assigneeOptions,
       hiddenFields,
       defaultValues: createDefaults ?? void 0,
@@ -4614,6 +4623,7 @@ function TasksPageCore({
     {
       id: selectedId,
       readonly,
+      statuses: allowedStatuses,
       hiddenFields,
       resolveAssignee,
       assigneeOptions,
@@ -4690,6 +4700,7 @@ function TasksPageCore({
       {
         workspaceId,
         projectId: boardProjectId,
+        statuses: allowedStatuses,
         priority: listPriority,
         type: listType,
         search: search || void 0,