@burdenoff/planmagnet-fe-sdk 2026.703.2 → 2026.704.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { DragEvent, ReactNode, HTMLAttributes, ComponentType } from 'react';
+import { HTMLAttributes, ReactNode, ComponentType, DragEvent } from 'react';
 import { ApolloClient } from '@apollo/client/core';
 import * as graphql from 'graphql';
 import * as class_variance_authority_types from 'class-variance-authority/types';
@@ -7,6 +7,32 @@ import { VariantProps } from 'class-variance-authority';
 import { LucideProps } from 'lucide-react';
 import { ClassValue } from 'clsx';
 
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "muted" | "secondary" | "accent" | "destructive" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+}
+/**
+ * Badge — a small owned pill primitive used for task status/priority/type.
+ * Semantic-token only.
+ */
+declare function Badge({ className, variant, ...props }: BadgeProps): react.JSX.Element;
+
+declare const SIZES: {
+    readonly sm: "h-5 w-5 text-[9px]";
+    readonly md: "h-6 w-6 text-[10px]";
+    readonly lg: "h-8 w-8 text-xs";
+};
+interface AvatarProps {
+    /** Assignee actor id (used for the deterministic tint + fallback initials). */
+    id?: string | null;
+    /** Resolved display name, if the host has a directory. */
+    name?: string | null;
+    size?: keyof typeof SIZES;
+    className?: string;
+}
+declare function Avatar({ id, name, size, className }: AvatarProps): react.JSX.Element;
+
 /**
  * Domain types for the PlanMagnet task SDK.
  *
@@ -155,6 +181,89 @@ interface ProjectList {
     pageInfo: TaskPageInfo;
     totalCount: number;
 }
+/**
+ * A link between a work item and an external entity owned by another product
+ * (`WorkItemLink`). HealthyBowl pins a task to a Field/Crop/Animal/Pest record
+ * via `sourceProduct: "healthybowl"` + `entityType`/`entityId`, snapshotting a
+ * label + deep-link so a deleted record degrades gracefully. The OUTPUT type is
+ * bare `WorkItemLink`; server-side all ids except `id` are `String`.
+ */
+interface WorkItemLink {
+    id: string;
+    workspaceId: string;
+    workItemId: string;
+    sourceProduct: string;
+    entityType: string;
+    entityId: string;
+    relationType: WorkItemLinkRelation;
+    displayNameSnapshot?: string | null;
+    deepLinkSnapshot?: string | null;
+    metadata?: unknown;
+    createdBy: string;
+    onBehalfOf?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Input for `planmagnetLinkWorkItem` (PlanmagnetCreateWorkItemLinkInput).
+ * Required: workItemId, sourceProduct, entityType, entityId. `relationType` is
+ * optional (server defaults to RELATED_TO).
+ */
+interface CreateWorkItemLinkInput {
+    workItemId: string;
+    sourceProduct: string;
+    entityType: string;
+    entityId: string;
+    relationType?: WorkItemLinkRelation;
+    displayNameSnapshot?: string;
+    deepLinkSnapshot?: string;
+    metadata?: unknown;
+}
+/** Filter for `planmagnetWorkItemLinks` (PlanmagnetWorkItemLinkFilter). */
+interface ListWorkItemLinksInput {
+    workItemId?: string;
+    sourceProduct?: string;
+    entityType?: string;
+    entityId?: string;
+    relationType?: WorkItemLinkRelation;
+}
+/** Shape returned by the ListWorkItemLinks query (PlanmagnetWorkItemLinkList). */
+interface WorkItemLinkList {
+    items: WorkItemLink[];
+    pageInfo: TaskPageInfo;
+    totalCount: number;
+}
+/** Milestone status (MilestoneStatus). */
+type MilestoneStatus = "PENDING" | "IN_PROGRESS" | "COMPLETED" | "MISSED" | "CANCELLED";
+/**
+ * A project milestone (e.g. a harvest window). Rendered as a flag on the
+ * Timeline. `sortOrder`/`tagsV2` are intentionally omitted (see LIST_MILESTONES).
+ */
+interface Milestone {
+    id: string;
+    projectId: string;
+    name: string;
+    description?: string | null;
+    status: MilestoneStatus;
+    dueDate?: string | null;
+    completedAt?: string | null;
+    ownerId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Filter for `planmagnetMilestones` (PlanmagnetMilestoneFilter). */
+interface ListMilestonesInput {
+    ownerId?: string;
+    projectId?: string;
+    search?: string;
+    status?: MilestoneStatus;
+}
+/** Shape returned by LIST_MILESTONES (PlanmagnetMilestoneList). */
+interface MilestoneList {
+    items: Milestone[];
+    pageInfo: TaskPageInfo;
+    totalCount: number;
+}
 /** Board column definition. */
 interface BoardColumn {
     status: TaskStatus;
@@ -179,6 +288,106 @@ declare const TASK_STATUSES: TaskStatus[];
  */
 declare function enumLabel(value: string): string;
 
+/**
+ * Optional host hook to render an icon for a linked entity type (e.g. a leaf
+ * for FIELD, a cow for ANIMAL). The SDK is farm-free, so it renders a generic
+ * link glyph unless the host supplies one.
+ */
+type RenderLinkIcon = (entityType: string) => ReactNode;
+interface LinkChipProps {
+    link: WorkItemLink;
+    renderIcon?: RenderLinkIcon;
+    className?: string;
+}
+/**
+ * LinkChip — a compact chip for a WorkItemLink (the task's linked farm record).
+ * Shows the snapshotted label (falls back to the entity type), tinted with the
+ * primary token so it reads as the mockup's green linked-record chip in the
+ * forest theme. Deep-links via `deepLinkSnapshot` when present; the click is
+ * stopped from bubbling so it doesn't also open the task.
+ */
+declare function LinkChip({ link, renderIcon, className }: LinkChipProps): react.JSX.Element;
+
+/**
+ * Linear-style task indicators — status, priority, type.
+ *
+ * A hard rule of the codebase is "semantic tokens only, never raw colors". The
+ * default token palette only exposes a handful of hues (primary / secondary /
+ * muted / accent / destructive), which is not enough to give each of the six
+ * statuses its own distinct color like a raw-palette design would.
+ *
+ * So — exactly like Linear — status is differentiated primarily by icon SHAPE
+ * (dashed → empty → dotted → filled → check), with a subtle muted→primary tone
+ * progression, and priority by a filled-BAR count. This reads as a polished PM
+ * tool while staying 100% within the semantic-token contract.
+ */
+interface StatusMeta {
+    icon: ComponentType<LucideProps>;
+    /** Icon tone (semantic token). */
+    tone: string;
+}
+/**
+ * Per-status icon + tone. Shape carries the meaning; tone progresses from muted
+ * (not started) toward primary (in flight / done). Overridable by hosts only
+ * via the column labels, never by raw color.
+ */
+declare const STATUS_META: Record<TaskStatus, StatusMeta>;
+interface StatusIconProps {
+    status: TaskStatus;
+    className?: string;
+}
+/** A single status glyph — shape-differentiated, token-toned. */
+declare function StatusIcon({ status, className }: StatusIconProps): react.JSX.Element;
+interface StatusPillProps {
+    status: TaskStatus;
+    className?: string;
+}
+/** Status as a compact bordered pill (icon + label) — used in the list view. */
+declare function StatusPill({ status, className }: StatusPillProps): react.JSX.Element;
+interface PriorityMeta {
+    /** Number of filled bars (0–3). */
+    level: number;
+    /** Fill tone (semantic token) applied to the filled bars + label. */
+    tone: string;
+}
+declare const PRIORITY_META: Record<TaskPriority, PriorityMeta>;
+interface PriorityIndicatorProps {
+    priority: TaskPriority;
+    /** Show the text label next to the bars. */
+    showLabel?: boolean;
+    className?: string;
+}
+/**
+ * Linear-style priority signal — three bars, filled by level. NONE renders all
+ * bars faint (its own recognizable "no priority" look).
+ */
+declare function PriorityIndicator({ priority, showLabel, className, }: PriorityIndicatorProps): react.JSX.Element;
+interface TypeBadgeProps {
+    type: TaskType;
+    className?: string;
+}
+/** Work-item type as a subtle badge. */
+declare function TypeBadge({ type, className }: TypeBadgeProps): react.JSX.Element;
+
+interface ModalProps {
+    open: boolean;
+    onClose: () => void;
+    children: ReactNode;
+    ariaLabel?: string;
+    className?: string;
+}
+/** Centered modal card overlay (owned, semantic-token only). */
+declare function Modal(props: ModalProps): react.JSX.Element;
+interface DrawerProps {
+    open: boolean;
+    onClose: () => void;
+    children: ReactNode;
+    ariaLabel?: string;
+    className?: string;
+}
+/** Right-anchored slide-over drawer overlay (owned, semantic-token only). */
+declare function Drawer(props: DrawerProps): react.JSX.Element;
+
 /**
  * Optional host hook: resolve an assignee id to a display name (the SDK has no
  * user directory). When omitted the avatar falls back to id-initials.
@@ -186,6 +395,11 @@ declare function enumLabel(value: string): string;
 type ResolveAssignee = (assigneeId: string) => {
     name?: string | null;
 } | null | undefined;
+/** A selectable assignee for the create/edit picker (host-provided directory). */
+interface AssigneeOption {
+    id: string;
+    name: string;
+}
 interface TaskCardProps {
     task: Task;
     /** Field names to hide (key/type/priority/labels/storyPoints/assignee/dueDate). */
@@ -198,6 +412,10 @@ interface TaskCardProps {
     /** True while this card is the one being dragged. */
     dragging?: boolean;
     resolveAssignee?: ResolveAssignee;
+    /** Linked farm records for this task (rendered as chips). */
+    links?: WorkItemLink[];
+    /** Optional host hook to render an icon per linked-entity type. */
+    renderLinkIcon?: RenderLinkIcon;
     className?: string;
 }
 /**
@@ -205,7 +423,7 @@ interface TaskCardProps {
  * only real fields (no invented assignee names or entity links). Semantic
  * tokens only.
  */
-declare function TaskCard({ task, hidden, onClick, draggable, onDragStart, onDragEnd, dragging, resolveAssignee, className, }: TaskCardProps): react.JSX.Element;
+declare function TaskCard({ task, hidden, onClick, draggable, onDragStart, onDragEnd, dragging, resolveAssignee, links, renderLinkIcon, className, }: TaskCardProps): react.JSX.Element;
 
 interface TaskBoardCoreProps {
     /** Scope the board to one project (client-side filter for Phase 1). */
@@ -239,6 +457,14 @@ interface TaskBoardCoreProps {
     resolveAssignee?: ResolveAssignee;
     /** Called when a task card is clicked. */
     onTaskClick?: (task: Task) => void;
+    /**
+     * When set, the board fetches WorkItemLinks for this `sourceProduct` (e.g.
+     * "healthybowl") and renders a linked-record chip on each card. Omitted → no
+     * link fetch (SDK stays farm-free).
+     */
+    linkSourceProduct?: string;
+    /** Optional host hook to render an icon per linked-entity type. */
+    renderLinkIcon?: RenderLinkIcon;
     /** Extra classes on the root container. */
     className?: string;
     /**
@@ -257,7 +483,7 @@ interface TaskBoardCoreProps {
  *   (optimistic cache update + `UPDATE_WORK_ITEM`; reverts on error). Filtering
  *   is controlled by the parent toolbar. Farm-free, semantic-token only.
  */
-declare function TaskBoardCore({ projectId, columns, readonly, hideHeader, priority, type, search, assigneeId, hiddenFields, resolveAssignee, onTaskClick, className, workspaceId: workspaceIdProp, }: TaskBoardCoreProps): react.JSX.Element;
+declare function TaskBoardCore({ projectId, columns, readonly, hideHeader, priority, type, search, assigneeId, hiddenFields, resolveAssignee, linkSourceProduct, renderLinkIcon, onTaskClick, className, workspaceId: workspaceIdProp, }: TaskBoardCoreProps): react.JSX.Element;
 
 interface TaskBoardProps extends TaskBoardCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -319,6 +545,8 @@ interface CreateTaskCoreProps {
      * until a project id is present.
      */
     projectId?: string;
+    /** Optional host-provided member directory → renders an assignee picker. */
+    assigneeOptions?: AssigneeOption[];
     /** Field names to hide on the form. */
     hiddenFields?: CreateTaskField[];
     /** Default values applied on first render. */
@@ -346,7 +574,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, hiddenFields, defaultValues, hideHeader, submitLabel, onCreated, onError, onCancel, className, workspaceId: workspaceIdProp, }: CreateTaskCoreProps): react.JSX.Element;
+declare function CreateTaskCore({ projectId: projectIdProp, assigneeOptions, hiddenFields, defaultValues, hideHeader, submitLabel, onCreated, onError, onCancel, className, workspaceId: workspaceIdProp, }: CreateTaskCoreProps): react.JSX.Element;
 
 interface CreateTaskProps extends CreateTaskCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -394,7 +622,7 @@ interface CreateTaskProps extends CreateTaskCoreProps {
 declare function CreateTask({ apiGatewayUrl, authToken, workspaceToken, workspaceId, tenantId, organizationId, trustedOrigins, onAuthError, workspaceClient, ...coreProps }: CreateTaskProps): react.JSX.Element;
 
 /** Columns available in the compact list. */
-type TaskListColumn = "key" | "title" | "type" | "status" | "priority" | "assignee" | "dueDate" | "storyPoints" | "labels";
+type TaskListColumn = "key" | "title" | "type" | "status" | "priority" | "assignee" | "dueDate" | "storyPoints" | "linkedRecord" | "labels";
 /** Sort keys for the list. */
 type TaskListSort = "priority" | "status" | "title" | "type" | "dueDate" | "storyPoints";
 interface TaskListCoreProps {
@@ -422,6 +650,13 @@ interface TaskListCoreProps {
     onSelect?: (id: string) => void;
     /** Optional host hook to resolve an assignee id → display name. */
     resolveAssignee?: ResolveAssignee;
+    /**
+     * When set, fetch WorkItemLinks for this `sourceProduct` and populate the
+     * "linkedRecord" column. Omitted → no link fetch.
+     */
+    linkSourceProduct?: string;
+    /** Optional host hook to render an icon per linked-entity type. */
+    renderLinkIcon?: RenderLinkIcon;
     /** Max items to fetch (pagination.first). Defaults to 200. */
     limit?: number;
     /** Extra classes on the root container. */
@@ -437,7 +672,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, 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, className, workspaceId: workspaceIdProp, }: TaskListCoreProps): react.JSX.Element;
 
 interface TaskListProps extends TaskListCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -496,6 +731,8 @@ interface TaskTimelineCoreProps {
     onSelect?: (id: string) => void;
     /** Optional host hook to resolve an assignee id → display name. */
     resolveAssignee?: ResolveAssignee;
+    /** Fetch + flag project milestones on the timeline (default true). */
+    showMilestones?: boolean;
     className?: string;
     workspaceId?: string;
 }
@@ -508,7 +745,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, className, workspaceId: workspaceIdProp, }: TaskTimelineCoreProps): react.JSX.Element;
+declare function TaskTimelineCore({ projectId, priority, type, search, assigneeId, defaultMode, onSelect, resolveAssignee, showMilestones, className, workspaceId: workspaceIdProp, }: TaskTimelineCoreProps): react.JSX.Element;
 
 /** The three task views the toolbar can switch between. */
 type TaskView = "board" | "list" | "timeline";
@@ -525,6 +762,9 @@ interface TaskToolbarProps {
     onTypeChange: (type: TaskType | "ALL") => void;
     onNewTask?: () => void;
     canCreate?: boolean;
+    /** "My tasks" toggle — only rendered when `onMineChange` is provided. */
+    mine?: boolean;
+    onMineChange?: (mine: boolean) => void;
     className?: string;
 }
 /**
@@ -532,7 +772,7 @@ interface TaskToolbarProps {
  * view tabs (Board / List / Timeline) + search + priority/type filters + a
  * "New task" action. Fully controlled; semantic-token only.
  */
-declare function TaskToolbar({ view, onViewChange, views, search, onSearchChange, priority, onPriorityChange, type, onTypeChange, onNewTask, canCreate, className, }: TaskToolbarProps): react.JSX.Element;
+declare function TaskToolbar({ view, onViewChange, views, search, onSearchChange, priority, onPriorityChange, type, onTypeChange, onNewTask, canCreate, mine, onMineChange, className, }: TaskToolbarProps): react.JSX.Element;
 
 /** Fields that can be hidden / suppressed on the detail view + edit form. */
 type TaskDetailField = "description" | "type" | "status" | "priority" | "assignee" | "dueDate" | "labels" | "storyPoints";
@@ -547,8 +787,14 @@ interface TaskDetailCoreProps {
     hideHeader?: boolean;
     /** Called with the updated work item after a successful save. */
     onUpdated?: (workItem: WorkItemDetail) => void;
-    /** Called when the update mutation errors. */
+    /** Called after a successful delete (with the deleted id). Enables the Delete button. */
+    onDeleted?: (id: string) => void;
+    /** Called when a mutation errors. */
     onError?: (error: Error) => void;
+    /** Optional host hook to resolve an assignee id → display name. */
+    resolveAssignee?: ResolveAssignee;
+    /** Optional host-provided member directory → renders a picker instead of a raw id field. */
+    assigneeOptions?: AssigneeOption[];
     /** Extra classes on the root container. */
     className?: string;
 }
@@ -557,7 +803,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, onError, className, }: TaskDetailCoreProps): react.JSX.Element;
+declare function TaskDetailCore({ id, readonly, hiddenFields, hideHeader, onUpdated, onDeleted, onError, resolveAssignee, assigneeOptions, className, }: TaskDetailCoreProps): react.JSX.Element;
 
 interface TaskDetailProps extends TaskDetailCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -598,6 +844,96 @@ interface TaskDetailProps extends TaskDetailCoreProps {
  */
 declare function TaskDetail({ apiGatewayUrl, authToken, workspaceToken, workspaceId, tenantId, organizationId, trustedOrigins, onAuthError, workspaceClient, ...coreProps }: TaskDetailProps): react.JSX.Element;
 
+/**
+ * TaskLabels — every user-facing string the SDK renders, so a host (e.g.
+ * HealthyBowl, which ships 6 languages) can inject translations. English
+ * defaults are used when no `labels` are provided, so the SDK works standalone.
+ * The SDK stays farm-free + string-agnostic; the host owns translation.
+ */
+interface TaskLabels {
+    board: string;
+    list: string;
+    timeline: string;
+    searchPlaceholder: string;
+    allPriorities: string;
+    allTypes: string;
+    newTask: string;
+    myTasks: string;
+    noTasks: string;
+    noTasksFound: string;
+    dropHere: string;
+    unassigned: string;
+    assigned: string;
+    overdue: string;
+    noDueDate: string;
+    milestones: string;
+    today: string;
+    week: string;
+    month: string;
+    tasksSingular: string;
+    tasksPlural: string;
+    colTask: string;
+    colStatus: string;
+    colPriority: string;
+    colAssignee: string;
+    colDueDate: string;
+    colPoints: string;
+    colLinkedRecord: string;
+    colType: string;
+    colKey: string;
+    colLabels: string;
+    newTaskHeading: string;
+    newTaskSubtitle: string;
+    title: string;
+    titlePlaceholder: string;
+    description: string;
+    descriptionPlaceholder: string;
+    typeLabel: string;
+    statusLabel: string;
+    priorityLabel: string;
+    assigneeLabel: string;
+    assigneePlaceholder: string;
+    dueDateLabel: string;
+    storyPointsLabel: string;
+    labelsLabel: string;
+    labelsPlaceholder: string;
+    create: string;
+    creating: string;
+    cancel: string;
+    edit: string;
+    del: string;
+    deletePrompt: string;
+    yes: string;
+    no: string;
+    save: string;
+    saving: string;
+    taskNotFound: string;
+    projectRequired: string;
+    errorLoading: string;
+    moveFailed: string;
+    failedToCreate: string;
+    failedToSave: string;
+    failedToDelete: string;
+    overdueLabel: string;
+    more: string;
+    status: Record<TaskStatus, string>;
+    priority: Record<TaskPriority, string>;
+    type: Record<TaskType, string>;
+}
+/** English defaults — the SDK renders these when no `labels` prop is provided. */
+declare const DEFAULT_TASK_LABELS: TaskLabels;
+declare const TaskLabelsProvider: react.Provider<TaskLabels>;
+/** Read the active task labels (English defaults if no host override). */
+declare function useTaskLabels(): TaskLabels;
+/** A host may override any subset; missing keys fall back to English. */
+type PartialTaskLabels = Partial<Omit<TaskLabels, "status" | "priority" | "type">> & {
+    status?: Partial<TaskLabels["status"]>;
+    priority?: Partial<TaskLabels["priority"]>;
+    type?: Partial<TaskLabels["type"]>;
+};
+/** Merge a host's partial overrides onto the English defaults. */
+declare function mergeTaskLabels(overrides?: PartialTaskLabels): TaskLabels;
+
 /**
  * Which SDK fields the composed page should suppress. The union of the create
  * form fields and the detail fields — the page fans a single `hiddenFields`
@@ -639,6 +975,23 @@ interface TasksPageCoreProps {
     defaultView?: TaskView;
     /** Optional host hook to resolve an assignee id → display name. */
     resolveAssignee?: ResolveAssignee;
+    /**
+     * When set, the board + list fetch WorkItemLinks for this `sourceProduct`
+     * (e.g. "healthybowl") and render linked-record chips / a "Linked Record"
+     * column. Omitted → no link fetch (SDK stays farm-free).
+     */
+    linkSourceProduct?: string;
+    /** Optional host hook to render an icon per linked-entity type. */
+    renderLinkIcon?: RenderLinkIcon;
+    /** Optional host-provided member directory → renders assignee pickers in create/edit. */
+    assigneeOptions?: AssigneeOption[];
+    /**
+     * The current user's actor id. When provided, the toolbar shows a "My tasks"
+     * toggle that filters every view to items assigned to this actor.
+     */
+    currentActorId?: string;
+    /** Host-provided translations for every UI string (English defaults otherwise). */
+    labels?: PartialTaskLabels;
     /**
      * Header/title slot rendered ABOVE the toolbar. Pass a string for the default
      * heading, or any node to fully own the title area. Omit for no title (e.g.
@@ -663,7 +1016,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, resolveAssignee, header, onTaskSaved, createSurface, detailSurface, className, }: TasksPageCoreProps): react.JSX.Element;
+declare function TasksPageCore({ workspaceId: workspaceIdProp, projectId, boardProjectId, columns, readonly, hiddenFields, views, defaultView, resolveAssignee, linkSourceProduct, renderLinkIcon, assigneeOptions, currentActorId, labels, header, onTaskSaved, createSurface, detailSurface, className, }: TasksPageCoreProps): react.JSX.Element;
 
 interface TasksPageProps extends TasksPageCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -767,6 +1120,38 @@ declare function usePlanMagnetContext(): PlanMagnetContextValue;
  */
 declare function usePlanMagnetContextSafe(): PlanMagnetContextValue | null;
 
+interface UseWorkItemLinksResult {
+    /** Links grouped by the work item they belong to. */
+    linksByItem: Map<string, WorkItemLink[]>;
+    loading: boolean;
+}
+/**
+ * useWorkItemLinks — batch-fetch WorkItemLinks for a workspace (scoped to one
+ * `sourceProduct`, e.g. "healthybowl") in ONE query and group them by
+ * `workItemId`. WorkItem has no `links` field, so the board/list join links to
+ * items client-side. Skips entirely when no `sourceProduct` is provided, so the
+ * SDK stays farm-free and link-fetching is opt-in per host.
+ */
+declare function useWorkItemLinks(workspaceId: string | undefined, sourceProduct: string | undefined, limit?: number): UseWorkItemLinksResult;
+
+interface UseMilestonesResult {
+    milestones: Milestone[];
+    /** Milestones grouped by their due day (yyyy-MM-dd), for timeline flags. */
+    byDay: Map<string, Milestone[]>;
+    loading: boolean;
+}
+/**
+ * useMilestones — fetch a project's milestones (e.g. a harvest window) for the
+ * Timeline to flag. Skips when no workspaceId. Errors are swallowed by Apollo's
+ * error return so a milestone RBAC/serialization hiccup never breaks the board;
+ * `milestones` is simply empty. Farm-free; opt-in via `enabled`.
+ */
+declare function useMilestones(workspaceId: string | undefined, opts?: {
+    projectId?: string;
+    enabled?: boolean;
+    limit?: number;
+}): UseMilestonesResult;
+
 interface PlanMagnetClientConfig {
     /** Workspace API gateway base URL (e.g. https://graphqlworkspaces.burdenoff.com). */
     apiGatewayUrl: string;
@@ -840,6 +1225,13 @@ declare const GET_PROJECTS: graphql.DocumentNode;
 declare const CREATE_WORK_ITEM: graphql.DocumentNode;
 declare const UPDATE_WORK_ITEM: graphql.DocumentNode;
 declare const MOVE_WORK_ITEM: graphql.DocumentNode;
+declare const WORK_ITEM_LINK_FIELDS: graphql.DocumentNode;
+declare const LIST_WORK_ITEM_LINKS: graphql.DocumentNode;
+declare const CREATE_WORK_ITEM_LINK: graphql.DocumentNode;
+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;
 
 /**
  * Configuration module for the PlanMagnet SDK.
@@ -907,112 +1299,6 @@ declare function validateTrustedOrigin(trustedOrigins?: string[]): void;
  */
 declare function getGraphQLEndpoint(baseUrl?: string): string;
 
-declare const badgeVariants: (props?: ({
-    variant?: "default" | "muted" | "secondary" | "accent" | "destructive" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
-}
-/**
- * Badge — a small owned pill primitive used for task status/priority/type.
- * Semantic-token only.
- */
-declare function Badge({ className, variant, ...props }: BadgeProps): react.JSX.Element;
-
-declare const SIZES: {
-    readonly sm: "h-5 w-5 text-[9px]";
-    readonly md: "h-6 w-6 text-[10px]";
-    readonly lg: "h-8 w-8 text-xs";
-};
-interface AvatarProps {
-    /** Assignee actor id (used for the deterministic tint + fallback initials). */
-    id?: string | null;
-    /** Resolved display name, if the host has a directory. */
-    name?: string | null;
-    size?: keyof typeof SIZES;
-    className?: string;
-}
-declare function Avatar({ id, name, size, className }: AvatarProps): react.JSX.Element;
-
-/**
- * Linear-style task indicators — status, priority, type.
- *
- * A hard rule of the codebase is "semantic tokens only, never raw colors". The
- * default token palette only exposes a handful of hues (primary / secondary /
- * muted / accent / destructive), which is not enough to give each of the six
- * statuses its own distinct color like a raw-palette design would.
- *
- * So — exactly like Linear — status is differentiated primarily by icon SHAPE
- * (dashed → empty → dotted → filled → check), with a subtle muted→primary tone
- * progression, and priority by a filled-BAR count. This reads as a polished PM
- * tool while staying 100% within the semantic-token contract.
- */
-interface StatusMeta {
-    icon: ComponentType<LucideProps>;
-    /** Icon tone (semantic token). */
-    tone: string;
-}
-/**
- * Per-status icon + tone. Shape carries the meaning; tone progresses from muted
- * (not started) toward primary (in flight / done). Overridable by hosts only
- * via the column labels, never by raw color.
- */
-declare const STATUS_META: Record<TaskStatus, StatusMeta>;
-interface StatusIconProps {
-    status: TaskStatus;
-    className?: string;
-}
-/** A single status glyph — shape-differentiated, token-toned. */
-declare function StatusIcon({ status, className }: StatusIconProps): react.JSX.Element;
-interface StatusPillProps {
-    status: TaskStatus;
-    className?: string;
-}
-/** Status as a compact bordered pill (icon + label) — used in the list view. */
-declare function StatusPill({ status, className }: StatusPillProps): react.JSX.Element;
-interface PriorityMeta {
-    /** Number of filled bars (0–3). */
-    level: number;
-    /** Fill tone (semantic token) applied to the filled bars + label. */
-    tone: string;
-}
-declare const PRIORITY_META: Record<TaskPriority, PriorityMeta>;
-interface PriorityIndicatorProps {
-    priority: TaskPriority;
-    /** Show the text label next to the bars. */
-    showLabel?: boolean;
-    className?: string;
-}
-/**
- * Linear-style priority signal — three bars, filled by level. NONE renders all
- * bars faint (its own recognizable "no priority" look).
- */
-declare function PriorityIndicator({ priority, showLabel, className, }: PriorityIndicatorProps): react.JSX.Element;
-interface TypeBadgeProps {
-    type: TaskType;
-    className?: string;
-}
-/** Work-item type as a subtle badge. */
-declare function TypeBadge({ type, className }: TypeBadgeProps): react.JSX.Element;
-
-interface ModalProps {
-    open: boolean;
-    onClose: () => void;
-    children: ReactNode;
-    ariaLabel?: string;
-    className?: string;
-}
-/** Centered modal card overlay (owned, semantic-token only). */
-declare function Modal(props: ModalProps): react.JSX.Element;
-interface DrawerProps {
-    open: boolean;
-    onClose: () => void;
-    children: ReactNode;
-    ariaLabel?: string;
-    className?: string;
-}
-/** Right-anchored slide-over drawer overlay (owned, semantic-token only). */
-declare function Drawer(props: DrawerProps): react.JSX.Element;
-
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Avatar, type AvatarProps, Badge, type BadgeProps, type BoardColumn, CREATE_WORK_ITEM, CreateTask, CreateTaskCore, type CreateTaskCoreProps, type CreateTaskField, type CreateTaskInput, type CreateTaskProps, DEFAULT_BOARD_COLUMNS, Drawer, type DrawerProps, GET_PROJECTS, GET_WORK_ITEM, LIST_WORK_ITEMS, type ListTasksInput, MOVE_WORK_ITEM, Modal, type ModalProps, PRIORITY_META, PROJECT_SUMMARY_FIELDS, type PlanMagnetClientConfig, type PlanMagnetConfig, PlanMagnetProvider, type PlanMagnetProviderProps, PriorityIndicator, type PriorityIndicatorProps, type Project, type ProjectList, 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, TaskDetail, TaskDetailCore, type TaskDetailCoreProps, type TaskDetailField, type TaskDetailProps, 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, WORK_ITEM_FIELDS, WORK_ITEM_SUMMARY_FIELDS, type WorkItemDetail, type WorkItemLinkRelation, type WorkItemList, badgeVariants, cn, config, createPlanMagnetClient, enumLabel, getGraphQLEndpoint, getPlanMagnetClient, getPlanMagnetClientSafe, getPlanMagnetConfig, isPlanMagnetClientReady, resetPlanMagnetClient, resetPlanMagnetConfig, setPlanMagnetClient, setPlanMagnetConfig, usePlanMagnetContext, usePlanMagnetContextSafe, validateTrustedOrigin, waitForPlanMagnetClient };
+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, 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 };