@burdenoff/planmagnet-fe-sdk 2026.706.5 → 2026.706.7

package/dist/index.d.ts

@@ -666,6 +666,17 @@ interface TaskListCoreProps {
     renderLinkIcon?: RenderLinkIcon;
     /** Max items to fetch (pagination.first). Defaults to 200. */
     limit?: number;
+    /**
+     * Opt-in bulk select: prepend a checkbox column + show a bulk-action bar
+     * (set status / priority / assignee, delete) for the selected rows. Defaults
+     * to `false` so existing embeds render unchanged.
+     */
+    selectable?: boolean;
+    /**
+     * Host-provided member directory. When passed (and `selectable`), the bulk bar
+     * offers an "Assign" picker; otherwise the assignee bulk action is hidden.
+     */
+    assigneeOptions?: AssigneeOption[];
     /** Extra classes on the root container. */
     className?: string;
     /** Explicit workspace ID. Falls back to PlanMagnetProvider context. */
@@ -679,7 +690,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, 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, className, workspaceId: workspaceIdProp, }: TaskListCoreProps): react.JSX.Element;
 
 interface TaskListProps extends TaskListCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -740,6 +751,25 @@ interface TaskTimelineCoreProps {
     resolveAssignee?: ResolveAssignee;
     /** Fetch + flag project milestones on the timeline (default true). */
     showMilestones?: boolean;
+    /**
+     * Allow creating milestones from the timeline (an inline name + due-date
+     * form in the milestones strip). Requires a create project (see
+     * `milestoneProjectId`). Gate on the host's manage permission. Default false.
+     */
+    canCreateMilestone?: boolean;
+    /**
+     * Project new milestones are created under. Defaults to `projectId`. Set this
+     * when the timeline's task-filter project differs from the project milestones
+     * should belong to — e.g. an unscoped "all tasks" board that still has a
+     * default create-project.
+     */
+    milestoneProjectId?: string;
+    /**
+     * BCP-47 language code (e.g. "hi", "zh", "ar") for localizing the calendar's
+     * weekday/month names via date-fns. Defaults to English. The task strings
+     * themselves come from the `TaskLabels` contract; this covers only the dates.
+     */
+    locale?: string;
     className?: string;
     workspaceId?: string;
 }
@@ -752,7 +782,7 @@ interface TaskTimelineCoreProps {
  * honest to the data. Overdue and undated work is surfaced explicitly so nothing
  * hides. BYO-Apollo, semantic-token only, farm-free.
  */
-declare function TaskTimelineCore({ projectId, priority, type, search, assigneeId, defaultMode, onSelect, resolveAssignee, showMilestones, className, workspaceId: workspaceIdProp, }: TaskTimelineCoreProps): react.JSX.Element;
+declare function TaskTimelineCore({ projectId, priority, type, search, assigneeId, defaultMode, onSelect, resolveAssignee, showMilestones, canCreateMilestone, milestoneProjectId, locale, className, workspaceId: workspaceIdProp, }: TaskTimelineCoreProps): react.JSX.Element;
 
 /** The three task views the toolbar can switch between. */
 type TaskView = "board" | "list" | "timeline";
@@ -946,11 +976,21 @@ interface TaskLabels {
     overdue: string;
     noDueDate: string;
     milestones: string;
+    addMilestone: string;
+    milestoneNamePlaceholder: string;
+    failedToCreateMilestone: string;
     today: string;
     week: string;
     month: string;
     tasksSingular: string;
     tasksPlural: string;
+    bulkSelected: string;
+    bulkSetStatus: string;
+    bulkSetPriority: string;
+    bulkAssign: string;
+    bulkDelete: string;
+    bulkClear: string;
+    bulkApplying: string;
     colTask: string;
     colStatus: string;
     colPriority: string;
@@ -989,8 +1029,13 @@ interface TaskLabels {
     noComments: string;
     you: string;
     editedTag: string;
+    editComment: string;
+    saveComment: string;
+    addReaction: string;
     failedToComment: string;
     failedToDeleteComment: string;
+    failedToEditComment: string;
+    failedToReact: string;
     reply: string;
     replyPlaceholder: string;
     repliesCount: string;
@@ -1061,6 +1106,16 @@ interface TasksPageCoreProps {
     columns?: BoardColumn[];
     /** Read-only — hides the "New task" button, disables drag + detail editing. */
     readonly?: boolean;
+    /**
+     * Allow creating milestones from the Timeline view (inline form in the
+     * milestones strip). Requires a `boardProjectId`. Defaults to `!readonly`.
+     */
+    canCreateMilestone?: boolean;
+    /**
+     * BCP-47 language code (e.g. "hi", "ar") for localizing the Timeline's
+     * weekday/month names. Task strings come from `labels`; this covers dates.
+     */
+    locale?: string;
     /**
      * Field names to hide across the board cards, create form, and detail view.
      * A product-agnostic hook so hosts can suppress fields that don't apply.
@@ -1137,7 +1192,7 @@ interface TasksPageCoreProps {
  * BYO-Apollo: reads the ambient `<ApolloProvider>` and takes `workspaceId` from
  * a prop or the PlanMagnetProvider context. Semantic tokens only, farm-free.
  */
-declare function TasksPageCore({ workspaceId: workspaceIdProp, projectId, boardProjectId, columns, readonly, hiddenFields, views, defaultView, confirmMove, resolveAssignee, linkSourceProduct, renderLinkIcon, assigneeOptions, currentActorId, commentsEntityType, onMention, labels, openItemId, header, onTaskSaved, createSurface, detailSurface, className, }: TasksPageCoreProps): react.JSX.Element;
+declare function TasksPageCore({ workspaceId: workspaceIdProp, projectId, boardProjectId, columns, readonly, canCreateMilestone, locale, hiddenFields, views, defaultView, confirmMove, resolveAssignee, linkSourceProduct, renderLinkIcon, assigneeOptions, currentActorId, commentsEntityType, onMention, labels, openItemId, header, onTaskSaved, createSurface, detailSurface, className, }: TasksPageCoreProps): react.JSX.Element;
 
 interface TasksPageProps extends TasksPageCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -1255,11 +1310,28 @@ interface UseWorkItemLinksResult {
  */
 declare function useWorkItemLinks(workspaceId: string | undefined, sourceProduct: string | undefined, limit?: number): UseWorkItemLinksResult;
 
+/** Args for creating a milestone (subset of PlanmagnetCreateMilestoneInput). */
+interface CreateMilestoneArgs {
+    projectId: string;
+    name: string;
+    /** A `yyyy-MM-dd` day; stored on the DateTime column at local noon. */
+    dueDate?: string | null;
+    status?: MilestoneStatus;
+    description?: string | null;
+}
 interface UseMilestonesResult {
     milestones: Milestone[];
     /** Milestones grouped by their due day (yyyy-MM-dd), for timeline flags. */
     byDay: Map<string, Milestone[]>;
     loading: boolean;
+    /** True while a create mutation is in flight. */
+    creating: boolean;
+    /**
+     * Create a milestone and refetch the list. Returns the created milestone, or
+     * throws so the caller can surface a toast. A `yyyy-MM-dd` dueDate is stored
+     * at local noon so it lands on the intended day regardless of timezone.
+     */
+    createMilestone: (args: CreateMilestoneArgs) => Promise<Milestone | null>;
 }
 /**
  * useMilestones — fetch a project's milestones (e.g. a harvest window) for the
@@ -1353,6 +1425,7 @@ declare const DELETE_WORK_ITEM_LINK: graphql.DocumentNode;
 declare const MILESTONE_FIELDS: graphql.DocumentNode;
 declare const LIST_MILESTONES: graphql.DocumentNode;
 declare const DELETE_WORK_ITEM: graphql.DocumentNode;
+declare const BULK_UPDATE_WORK_ITEMS: graphql.DocumentNode;
 
 /**
  * Configuration module for the PlanMagnet SDK.
@@ -1422,4 +1495,4 @@ declare function getGraphQLEndpoint(baseUrl?: string): string;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AssigneeOption, Avatar, type AvatarProps, Badge, type BadgeProps, type BoardColumn, CREATE_WORK_ITEM, CREATE_WORK_ITEM_LINK, CreateTask, CreateTaskCore, type CreateTaskCoreProps, type CreateTaskField, type CreateTaskInput, type CreateTaskProps, type CreateWorkItemLinkInput, DEFAULT_BOARD_COLUMNS, DEFAULT_TASK_LABELS, DELETE_WORK_ITEM, DELETE_WORK_ITEM_LINK, Drawer, type DrawerProps, GET_PROJECTS, GET_WORK_ITEM, LIST_MILESTONES, LIST_WORK_ITEMS, LIST_WORK_ITEM_LINKS, LinkChip, type LinkChipProps, type ListMilestonesInput, type ListTasksInput, type ListWorkItemLinksInput, MILESTONE_FIELDS, MOVE_WORK_ITEM, type Milestone, type MilestoneList, type MilestoneStatus, Modal, type ModalProps, PRIORITY_META, PROJECT_SUMMARY_FIELDS, type PartialTaskLabels, type PlanMagnetClientConfig, type PlanMagnetConfig, PlanMagnetProvider, type PlanMagnetProviderProps, PriorityIndicator, type PriorityIndicatorProps, type Project, type ProjectList, type RenderLinkIcon, type ResolveAssignee, STATUS_META, StatusIcon, type StatusIconProps, StatusPill, type StatusPillProps, TASK_PRIORITIES, TASK_STATUSES, TASK_TYPES, type Task, TaskBoard, TaskBoardCore, type TaskBoardCoreProps, type TaskBoardProps, TaskCard, type TaskCardProps, TaskCommentsCore, type TaskCommentsCoreProps, TaskDetail, TaskDetailCore, type TaskDetailCoreProps, type TaskDetailField, type TaskDetailProps, type TaskLabels, TaskLabelsProvider, TaskList, type TaskListColumn, TaskListCore, type TaskListCoreProps, type TaskListProps, type TaskListSort, type TaskPageInfo, type TaskPaginationInput, type TaskPriority, type TaskSavedResult, type TaskStatus, TaskTimelineCore, type TaskTimelineCoreProps, TaskToolbar, type TaskToolbarProps, type TaskType, type TaskView, TasksPage, TasksPageCore, type TasksPageCoreProps, type TasksPageField, type TasksPageProps, type TasksPageSaved, TypeBadge, type TypeBadgeProps, UPDATE_WORK_ITEM, type UpdateTaskInput, type UseMilestonesResult, type UseWorkItemLinksResult, WORK_ITEM_FIELDS, WORK_ITEM_LINK_FIELDS, WORK_ITEM_SUMMARY_FIELDS, type WorkItemDetail, type WorkItemLink, type WorkItemLinkList, type WorkItemLinkRelation, type WorkItemList, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, mergeTaskLabels, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, useMilestones, usePlanMagnetContext, usePlanMagnetContextSafe, useTaskLabels, useWorkItemLinks, validateTrustedOrigin, waitForPlanMagnetClient };
+export { type AssigneeOption, Avatar, type AvatarProps, BULK_UPDATE_WORK_ITEMS, Badge, type BadgeProps, type BoardColumn, CREATE_WORK_ITEM, CREATE_WORK_ITEM_LINK, CreateTask, CreateTaskCore, type CreateTaskCoreProps, type CreateTaskField, type CreateTaskInput, type CreateTaskProps, type CreateWorkItemLinkInput, DEFAULT_BOARD_COLUMNS, DEFAULT_TASK_LABELS, DELETE_WORK_ITEM, DELETE_WORK_ITEM_LINK, Drawer, type DrawerProps, GET_PROJECTS, GET_WORK_ITEM, LIST_MILESTONES, LIST_WORK_ITEMS, LIST_WORK_ITEM_LINKS, LinkChip, type LinkChipProps, type ListMilestonesInput, type ListTasksInput, type ListWorkItemLinksInput, MILESTONE_FIELDS, MOVE_WORK_ITEM, type Milestone, type MilestoneList, type MilestoneStatus, Modal, type ModalProps, PRIORITY_META, PROJECT_SUMMARY_FIELDS, type PartialTaskLabels, type PlanMagnetClientConfig, type PlanMagnetConfig, PlanMagnetProvider, type PlanMagnetProviderProps, PriorityIndicator, type PriorityIndicatorProps, type Project, type ProjectList, type RenderLinkIcon, type ResolveAssignee, STATUS_META, StatusIcon, type StatusIconProps, StatusPill, type StatusPillProps, TASK_PRIORITIES, TASK_STATUSES, TASK_TYPES, type Task, TaskBoard, TaskBoardCore, type TaskBoardCoreProps, type TaskBoardProps, TaskCard, type TaskCardProps, TaskCommentsCore, type TaskCommentsCoreProps, TaskDetail, TaskDetailCore, type TaskDetailCoreProps, type TaskDetailField, type TaskDetailProps, type TaskLabels, TaskLabelsProvider, TaskList, type TaskListColumn, TaskListCore, type TaskListCoreProps, type TaskListProps, type TaskListSort, type TaskPageInfo, type TaskPaginationInput, type TaskPriority, type TaskSavedResult, type TaskStatus, TaskTimelineCore, type TaskTimelineCoreProps, TaskToolbar, type TaskToolbarProps, type TaskType, type TaskView, TasksPage, TasksPageCore, type TasksPageCoreProps, type TasksPageField, type TasksPageProps, type TasksPageSaved, TypeBadge, type TypeBadgeProps, UPDATE_WORK_ITEM, type UpdateTaskInput, type UseMilestonesResult, type UseWorkItemLinksResult, WORK_ITEM_FIELDS, WORK_ITEM_LINK_FIELDS, WORK_ITEM_SUMMARY_FIELDS, type WorkItemDetail, type WorkItemLink, type WorkItemLinkList, type WorkItemLinkRelation, type WorkItemList, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, mergeTaskLabels, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, useMilestones, usePlanMagnetContext, usePlanMagnetContextSafe, useTaskLabels, useWorkItemLinks, validateTrustedOrigin, waitForPlanMagnetClient };