@emberai-engg/task-board 0.3.6 → 0.4.1

package/dist/index.d.mts

@@ -6,12 +6,29 @@ interface Project {
     slug: string;
     name: string;
 }
+/**
+ * The four description sections that support inline editing, Draft/Approved
+ * status, and highlight-to-comment anchors.
+ *
+ * `open_questions` is kept on `StructuredDescription` for backwards
+ * compatibility but is no longer surfaced in the description UI — the
+ * Outstanding Questions section uses a structured collection instead.
+ */
+type SectionKey = "problem" | "user_story" | "proposed_behavior" | "acceptance_criteria";
+type SectionStatus = "draft" | "approved";
 interface StructuredDescription {
     problem: string;
     user_story: string;
     proposed_behavior: string;
     acceptance_criteria: string;
+    /**
+     * Legacy free-text questions field. Kept for backwards compatibility with
+     * tasks created before the structured Outstanding Questions feature.
+     * Not rendered in the current detail UI.
+     */
     open_questions: string;
+    /** Per-section review status, e.g. `{ problem: "approved" }`. Defaults to draft when absent. */
+    section_status?: Record<string, SectionStatus>;
 }
 interface Task {
     id: string;
@@ -38,6 +55,11 @@ interface ActivityEntry {
     user_name: string;
     created_at: string;
 }
+type ThreadStatus = "active" | "complete";
+interface ThreadAnchor {
+    section: SectionKey;
+    snippet: string;
+}
 interface Comment {
     id: string;
     task_id: string;
@@ -48,6 +70,50 @@ interface Comment {
     edited?: boolean;
     edited_at?: string;
     created_at: string;
+    /** Set on replies; null/undefined for top-level (thread root) comments. */
+    parent_id?: string | null;
+    /** Top-level (thread) metadata. Ignored on replies. */
+    title?: string | null;
+    thread_status?: ThreadStatus;
+    anchor?: ThreadAnchor | null;
+    attachment_ids?: string[];
+}
+type QuestionStatus = "awaiting" | "answered";
+interface QuestionReply {
+    id: string;
+    question_id: string;
+    task_id: string;
+    content: string;
+    author_id: string;
+    author_name: string;
+    created_at: string;
+}
+interface Question {
+    id: string;
+    task_id: string;
+    text: string;
+    status: QuestionStatus;
+    asked_by: string;
+    asked_by_name: string;
+    answered_by_reply_id?: string | null;
+    replies: QuestionReply[];
+    created_at: string;
+    updated_at: string;
+}
+type AttachmentKind = "image" | "file" | "link";
+interface Attachment {
+    id: string;
+    task_id: string;
+    kind: AttachmentKind;
+    name: string;
+    size?: number | null;
+    content_type?: string | null;
+    /** Read URL — signed GCS URL for image/file uploads, raw URL for links. */
+    url: string;
+    storage_path?: string | null;
+    uploaded_by: string;
+    uploaded_by_name: string;
+    created_at: string;
 }
 interface Notification {
     id: string;
@@ -73,13 +139,19 @@ type ColumnUnreads = Record<string, number>;
 interface ColumnConfig {
     key: string;
     label: string;
+    /** Tailwind class for the round status dot, e.g. `bg-amber-500`. */
     color: string;
+    /** Optional Tailwind classes for the inline status pill (background + text). */
+    chip?: string;
     description: string;
 }
 interface PriorityConfig {
     value: string;
     label: string;
+    /** Tailwind classes for the priority pill (bg + text + border). */
     className: string;
+    /** Optional Tailwind class for a small priority dot, e.g. `bg-amber-500`. */
+    dot?: string;
 }
 interface TagConfig {
     value: string;
@@ -87,8 +159,10 @@ interface TagConfig {
     className: string;
 }
 interface DescriptionSectionConfig {
-    key: keyof StructuredDescription;
+    key: SectionKey;
     label: string;
+    /** Placeholder text shown in the editor when the section is empty. */
+    placeholder?: string;
 }
 interface TaskBoardUser {
     username: string;
@@ -130,6 +204,10 @@ interface ColumnResponse {
 interface TaskDetailResponse extends Task {
     comments: Comment[];
     activity: ActivityEntry[];
+    /** Embedded structured questions (with their replies). */
+    questions?: Question[];
+    /** Embedded attachments with read URLs already computed server-side. */
+    attachments?: Attachment[];
 }
 interface NotificationCountResponse {
     count: number;
@@ -153,10 +231,36 @@ interface UpdateTaskPayload {
 interface CreateCommentPayload {
     content: string;
     is_internal?: boolean;
+    /** Set on replies. Top-level (thread) comments leave this null/undefined. */
+    parent_id?: string | null;
+    /** Optional title for top-level threads. */
+    title?: string | null;
+    /** Anchor metadata for highlight-to-comment threads. */
+    anchor?: ThreadAnchor | null;
+    /** Attachment IDs referenced from this comment. */
+    attachment_ids?: string[];
 }
 interface EditCommentPayload {
     content: string;
 }
+interface UpdateThreadPayload {
+    title?: string;
+    thread_status?: ThreadStatus;
+}
+interface CreateQuestionPayload {
+    text: string;
+}
+interface UpdateQuestionPayload {
+    text?: string;
+    status?: QuestionStatus;
+}
+interface CreateQuestionReplyPayload {
+    content: string;
+}
+interface CreateLinkAttachmentPayload {
+    url: string;
+    name?: string;
+}
 
 interface TaskBoardProps {
     /** Optional class name for the outer container */
@@ -284,6 +388,355 @@ interface TaskDetailPanelProps {
 }
 declare function TaskDetailPanel({ task, projectSlug, onClose, onUpdate }: TaskDetailPanelProps): react_jsx_runtime.JSX.Element;
 
+interface TaskDetailViewProps {
+    taskId: string;
+    /** href for the "Back to Task Board" link. Ignored if `onBack` is provided. */
+    backHref?: string;
+    /** Called when the back link is clicked. Use this for SPA routing. */
+    onBack?: () => void;
+    /** Optional slot above the main content (e.g. consumer's breadcrumb bar). */
+    breadcrumb?: React__default.ReactNode;
+    /** Called after a successful delete; consumer should navigate away. */
+    onDeleted?: (task: Task) => void;
+    /**
+     * Provide this to enable the prev/next buttons. The view fetches the
+     * project's task list and computes neighbors; on click, the consumer
+     * is responsible for navigating to /task-board/[id]?project=<slug>.
+     */
+    onNavigateToTask?: (taskId: string, projectSlug: string) => void;
+    /** Build a share URL for the task. Defaults to `${origin}/task-board/${id}?project=${slug}`. */
+    buildShareUrl?: (task: Task) => string;
+}
+/**
+ * Full-page task detail orchestrator. Renders the breadcrumb slot, back +
+ * prev/next chrome, the task ID/project header, inline-editable title,
+ * status/priority/menu action cluster, all description sections, outstanding
+ * questions, attachments, and the right-side threads panel with
+ * highlight-to-comment.
+ *
+ * Consumers are responsible for app chrome (sidebar, breadcrumb bar) — pass
+ * the breadcrumb via `breadcrumb` and place this inside your existing layout.
+ */
+declare function TaskDetailView({ taskId, backHref, onBack, breadcrumb, onDeleted, onNavigateToTask, buildShareUrl, }: TaskDetailViewProps): react_jsx_runtime.JSX.Element;
+
+interface DescriptionSectionProps {
+    sectionKey: SectionKey;
+    label: string;
+    placeholder: string;
+    /** Markdown content. */
+    value: string;
+    /** Called with the new markdown when the user commits an edit. */
+    onChange: (next: string) => void;
+    /** Current Draft/Approved status; defaults to "draft" when omitted. */
+    status: SectionStatus;
+    /** Toggle Draft ↔ Approved. */
+    onStatusChange: (next: SectionStatus) => void;
+    /** Optional saving indicator passed through to the editor. */
+    saving?: boolean;
+}
+/**
+ * One free-text description section (Problem / User Story / etc.) with:
+ *   - segmented Draft/Approved toggle and hover-card explanations
+ *   - read-mode `MarkdownView`
+ *   - click-to-focus WYSIWYG `MarkdownEditor`
+ *   - `data-section={sectionKey}` so highlight-to-comment can anchor here
+ */
+declare function DescriptionSection({ sectionKey, label, placeholder, value, onChange, status, onStatusChange, saving, }: DescriptionSectionProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Lightweight read-mode markdown renderer for description sections, thread
+ * messages, and other static markdown content. Supports H1/H2/H3, bullet lists,
+ * numbered lists, blockquotes, task lists (`- [ ] foo`), inline bold (`**`),
+ * inline code, and `@[Name](username)` mentions rendered as styled pills.
+ *
+ * For editing, use `MarkdownEditor` (WYSIWYG, contenteditable).
+ */
+declare function MarkdownView({ content, className }: {
+    content: string;
+    className?: string;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface MarkdownEditorProps {
+    /** Markdown content. Used once on mount; the contenteditable owns state from then on. */
+    value: string;
+    /** Called with the canonical markdown when the user blurs the editor. */
+    onCommit: (md: string) => void;
+    /** Called when the user presses Escape. */
+    onCancel: () => void;
+    /** Placeholder shown when the editor is empty. */
+    placeholder: string;
+    /** Optional saving indicator. */
+    saving?: boolean;
+}
+/**
+ * WYSIWYG markdown editor. Uses a contenteditable div with execCommand
+ * formatting so users never see raw `**` / `- ` / `# ` syntax. Storage
+ * format remains markdown via `mdToHtml`/`htmlToMd` round-trip helpers,
+ * so existing readers (`MarkdownView`, server-side previews) keep working.
+ *
+ * Pair with the CSS in `task-board.css` (`.eb-tb-markdown-editor`).
+ */
+declare function MarkdownEditor({ value, onCommit, onCancel, placeholder, saving }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
+
+interface OutstandingQuestionsSectionProps {
+    /** All questions for the task. */
+    questions: Question[];
+    /** Username of the logged-in user, for permission checks (delete-own). */
+    currentUsername: string;
+    /** Create a new question. */
+    onCreate: (text: string) => Promise<void> | void;
+    /** Toggle question status (awaiting ↔ answered). */
+    onSetStatus: (questionId: string, status: 'awaiting' | 'answered') => Promise<void> | void;
+    /** Delete a question (and its replies). */
+    onDelete: (questionId: string) => Promise<void> | void;
+    /** Add a reply to a question. */
+    onAddReply: (questionId: string, content: string) => Promise<void> | void;
+}
+/**
+ * Structured list of outstanding questions with awaiting/answered filter,
+ * inline composer, and per-question collapsible threads. Replaces the legacy
+ * free-text `open_questions` description field.
+ */
+declare function OutstandingQuestionsSection({ questions, currentUsername, onCreate, onSetStatus, onDelete, onAddReply, }: OutstandingQuestionsSectionProps): react_jsx_runtime.JSX.Element;
+
+interface AttachmentsSectionProps {
+    attachments: Attachment[];
+    /** Upload a file (image or document). */
+    onUpload: (file: File) => Promise<unknown> | void;
+    /** Add an external link/recording. */
+    onAddLink: (url: string, name?: string) => Promise<unknown> | void;
+    /** Delete an attachment by id. */
+    onDelete: (attachmentId: string) => Promise<unknown> | void;
+}
+/**
+ * Three-subgroup attachments display (Images / Files / Links & recordings)
+ * with an "Add attachment" popover and an "Add link or recording" modal.
+ *
+ * Bug #3 fix: Cancel/Save buttons in the link modal use `inline-flex
+ * items-center justify-center` (without these, the button text wasn't
+ * vertically centered) and `text-[13px]` (was `text-[12px]`).
+ */
+declare function AttachmentsSection({ attachments, onUpload, onAddLink, onDelete, }: AttachmentsSectionProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * UI shape derived from Comment + Attachment data. A `Thread` is a top-level
+ * comment (no `parent_id`) augmented with metadata, replies, and resolved
+ * attachment objects (looked up by id).
+ */
+interface Thread {
+    id: string;
+    title: string;
+    /** True when title was derived from content rather than persisted on the row. */
+    titleDerived: boolean;
+    preview: string;
+    author_id: string;
+    author_name: string;
+    created_at: string;
+    is_internal: boolean;
+    status: ThreadStatus;
+    /** Original mention-tagged text, used when rendering the message. */
+    rawContent: string;
+    anchor?: ThreadAnchor | null;
+    attachments: Attachment[];
+    replies: ThreadReply[];
+}
+interface ThreadReply {
+    id: string;
+    author_id: string;
+    author_name: string;
+    content: string;
+    created_at: string;
+    is_internal: boolean;
+}
+/** Group a flat comments list into threads (top-level + replies + resolved attachments). */
+declare function deriveThreads(comments: Comment[], attachments: Attachment[]): Thread[];
+/** Display label for a description section key, falling back to the key itself. */
+declare function sectionLabel(key: SectionKey): string;
+/** Compact relative time like "5m ago", "3h ago", "2d ago", or a short date. */
+declare function timeAgo(dateStr: string): string;
+
+interface ThreadsPanelProps {
+    threads: Thread[];
+    activity: ActivityEntry[];
+    attachments: Attachment[];
+    /** Open / close state. Lift this to the page so the bubble + main padding can coordinate. */
+    open: boolean;
+    onToggle: () => void;
+    /** Currently-open thread (null = list view). Lifted so panel + page agree. */
+    openThreadId: string | null;
+    onOpenThread: (id: string | null) => void;
+    /** Highlight-to-comment anchor pending placement on a new thread. */
+    pendingAnchor: ThreadAnchor | null;
+    onClearAnchor: () => void;
+    /** Click handler for anchor pills — should scroll/pulse the anchored section. */
+    onAnchorClick: (anchor: ThreadAnchor) => void;
+    /** Set of thread ids currently shimmering (no user-supplied title yet). */
+    shimmeringThreadIds: Set<string>;
+    /** Whether the current user is allowed to post internal-only threads/replies. */
+    isInternalUser: boolean;
+    /** Submit a brand-new top-level thread. */
+    onCreateThread: (data: {
+        title: string;
+        content: string;
+        isInternal: boolean;
+        anchor: ThreadAnchor | null;
+        attachmentIds: string[];
+    }) => Promise<void>;
+    /** Submit a reply on an existing thread. */
+    onCreateReply: (parentId: string, content: string, isInternal: boolean) => Promise<void>;
+    /** Update title or status on an existing thread. */
+    onUpdateThread: (threadId: string, body: {
+        title?: string;
+        thread_status?: ThreadStatus;
+    }) => Promise<void>;
+    /** Upload a file attachment for the current task. Returns the new row. */
+    onUploadAttachment: (file: File) => Promise<Attachment>;
+    /** Add a link/recording attachment for the current task. */
+    onAddLinkAttachment: (url: string, name?: string) => Promise<Attachment>;
+}
+/**
+ * Right-side panel with Threads / Activity tabs, collapse toggle, thread list,
+ * thread detail view, and the new-thread composer. Designed to be `xl:flex
+ * hidden` and `fixed` to the right edge by the consuming page.
+ */
+declare function ThreadsPanel({ threads, activity, attachments, open, onToggle, openThreadId, onOpenThread, pendingAnchor, onClearAnchor, onAnchorClick, shimmeringThreadIds, isInternalUser, onCreateThread, onCreateReply, onUpdateThread, onUploadAttachment, onAddLinkAttachment, }: ThreadsPanelProps): react_jsx_runtime.JSX.Element;
+
+interface ThreadCardProps {
+    thread: Thread;
+    /** Open the full thread detail view. */
+    onOpen: () => void;
+    /** Click handler for an anchor pill — should scroll/pulse the anchored section. */
+    onAnchorClick: (anchor: ThreadAnchor) => void;
+    /** When true, render the title as a shimmer placeholder ("AI is generating a title"). */
+    shimmer?: boolean;
+}
+/**
+ * One row in the threads list. Click anywhere on the card to open the
+ * thread detail view. Anchor pills stop propagation so they can scroll
+ * back to the highlighted description section instead.
+ */
+declare function ThreadCard({ thread, onOpen, onAnchorClick, shimmer }: ThreadCardProps): react_jsx_runtime.JSX.Element;
+
+interface ThreadDetailViewProps {
+    thread: Thread;
+    onBack: () => void;
+    onReply: (content: string, isInternal: boolean) => Promise<void>;
+    onUpdateThread: (body: {
+        title?: string;
+        thread_status?: ThreadStatus;
+    }) => Promise<void>;
+    onAnchorClick: (anchor: ThreadAnchor) => void;
+    /** Whether the current user can post internal-only replies. */
+    isInternalUser: boolean;
+}
+/** Detail view shown inside the threads panel when a thread card is clicked. */
+declare function ThreadDetailView({ thread, onBack, onReply, onUpdateThread, onAnchorClick, isInternalUser, }: ThreadDetailViewProps): react_jsx_runtime.JSX.Element;
+
+interface ThreadComposerProps {
+    /** Existing attachments on the task — used to render chips for already-uploaded files. */
+    attachments: Attachment[];
+    /** Anchor to attach when posting (set by highlight-to-comment). */
+    pendingAnchor: ThreadAnchor | null;
+    /** Clear the pending anchor (e.g. user dismisses the highlight). */
+    onClearAnchor: () => void;
+    /** Submit the new thread. */
+    onSubmit: (data: {
+        title: string;
+        content: string;
+        isInternal: boolean;
+        anchor: ThreadAnchor | null;
+        attachmentIds: string[];
+    }) => Promise<void>;
+    /** Upload a file as an attachment to this task. Returns the new attachment row. */
+    onUpload: (file: File) => Promise<Attachment>;
+    /** Add a link/recording as an attachment. Returns the new attachment row. */
+    onAddLink: (url: string, name?: string) => Promise<Attachment>;
+    /** Whether the current user is allowed to post internal-only threads. */
+    isInternalUser: boolean;
+    /** When false, render the collapsed "Start a thread" button instead. */
+    open: boolean;
+    /** Open the composer (e.g. user clicks the start button). */
+    onOpen: () => void;
+    /** Close + reset the composer. */
+    onClose: () => void;
+}
+/**
+ * Composer for new threads. Renders a single button when collapsed; when
+ * open, renders an optional anchor strip, optional title input, body
+ * textarea with @mentions, attachment buttons + chips, internal toggle,
+ * and the Post button.
+ */
+declare function ThreadComposer({ attachments, pendingAnchor, onClearAnchor, onSubmit, onUpload, onAddLink, isInternalUser, open, onOpen, onClose, }: ThreadComposerProps): react_jsx_runtime.JSX.Element;
+
+interface ActivityListProps {
+    activity: ActivityEntry[];
+}
+/** Status-change activity log shown in the Activity tab of the threads panel. */
+declare function ActivityList({ activity }: ActivityListProps): react_jsx_runtime.JSX.Element;
+
+type ContextPillVariant = 'amber' | 'purple' | 'blue' | 'emerald' | 'neutral';
+interface ContextPillProps {
+    variant: ContextPillVariant;
+    icon: React__default.ComponentType<{
+        className?: string;
+        strokeWidth?: number;
+        size?: number;
+    }>;
+    label: string;
+    onClick?: (e: React__default.MouseEvent) => void;
+}
+/** A small color-coded pill used on thread cards (highlights, attachments, etc.). */
+declare function ContextPill({ variant, icon: IconC, label, onClick }: ContextPillProps): react_jsx_runtime.JSX.Element;
+
+interface BubbleState {
+    /** X coordinate (page-relative, viewport center of the selection rect). */
+    x: number;
+    /** Y coordinate (page-relative, scroll-aware). */
+    y: number;
+    section: SectionKey;
+    snippet: string;
+}
+interface UseHighlightAnchorResult {
+    /** Transient bubble state — set when the user has selected text inside a [data-section] block. */
+    bubble: BubbleState | null;
+    /** Manually clear the bubble (e.g. after user clicks the Comment button). */
+    clearBubble: () => void;
+    /** The anchor pending placement on a new thread, or null. */
+    pendingAnchor: ThreadAnchor | null;
+    /** Promote the current bubble to a pendingAnchor (the new-thread composer should react to this). */
+    beginAnchoredThread: () => ThreadAnchor | null;
+    /** Clear `pendingAnchor` after the thread is posted or the composer is dismissed. */
+    clearPendingAnchor: () => void;
+    /** Scroll the anchored section into view and pulse it briefly. Pass to ThreadCard / ThreadDetailView. */
+    focusAnchor: (anchor: ThreadAnchor) => void;
+}
+/**
+ * Wires up highlight-to-comment selection behaviour. The consuming page
+ * needs to render the description sections with `data-section={sectionKey}`
+ * for the bubble + focusAnchor to find the right element. Pair this hook
+ * with `<HighlightBubble bubble={bubble} onComment={beginAnchoredThread} />`
+ * and pass `pendingAnchor` / `clearPendingAnchor` to `<ThreadsPanel>`.
+ *
+ * Bug #1 fix lives in `<HighlightBubble>`: the button uses
+ * onMouseDown.preventDefault so clicking it doesn't blow away the selection.
+ */
+declare function useHighlightAnchor(): UseHighlightAnchorResult;
+
+interface HighlightBubbleProps {
+    bubble: BubbleState | null;
+    /** Called when the user clicks the bubble to start a new anchored thread. */
+    onComment: () => void;
+}
+/**
+ * Floating "Comment" button shown above a text selection inside a
+ * `[data-section]` block. The page should render this once at top level
+ * and pass `bubble` / `onComment` from `useHighlightAnchor`.
+ *
+ * Bug #1 fix: onMouseDown.preventDefault keeps focus on the selection so
+ * the snippet survives until onClick reads it.
+ */
+declare function HighlightBubble({ bubble, onComment }: HighlightBubbleProps): react_jsx_runtime.JSX.Element | null;
+
 interface TaskBoardService {
     listTasks(projectSlug: string, perColumn?: number): Promise<Record<string, ColumnResponse>>;
     listColumnTasks(projectSlug: string, statusKey: string, offset: number, limit: number): Promise<Task[]>;
@@ -296,6 +749,20 @@ interface TaskBoardService {
     addComment(taskId: string, data: CreateCommentPayload): Promise<Comment>;
     editComment(taskId: string, commentId: string, data: EditCommentPayload): Promise<Comment>;
     deleteComment(taskId: string, commentId: string): Promise<void>;
+    /** Update a top-level comment's title and/or thread_status. */
+    updateThread(taskId: string, threadId: string, data: UpdateThreadPayload): Promise<Comment>;
+    listQuestions(taskId: string): Promise<Question[]>;
+    createQuestion(taskId: string, data: CreateQuestionPayload): Promise<Question>;
+    updateQuestion(taskId: string, questionId: string, data: UpdateQuestionPayload): Promise<Question>;
+    deleteQuestion(taskId: string, questionId: string): Promise<void>;
+    addQuestionReply(taskId: string, questionId: string, data: CreateQuestionReplyPayload): Promise<{
+        id: string;
+    }>;
+    deleteQuestionReply(taskId: string, questionId: string, replyId: string): Promise<void>;
+    listAttachments(taskId: string): Promise<Attachment[]>;
+    uploadAttachment(taskId: string, file: File): Promise<Attachment>;
+    addLinkAttachment(taskId: string, data: CreateLinkAttachmentPayload): Promise<Attachment>;
+    deleteAttachment(taskId: string, attachmentId: string): Promise<void>;
     listProjects(): Promise<Project[]>;
     searchMentionUsers(query: string): Promise<MentionUser[]>;
     getNotificationCount(): Promise<number>;
@@ -320,6 +787,8 @@ interface TaskBoardConfig {
     tags?: TagConfig[];
     /** Base API path (defaults to '/api/v1/taskboard') */
     apiBasePath?: string;
+    /** Label shown on internal-only comment chips. Defaults to "Internal". */
+    internalLabel?: string;
     /** Callbacks */
     onTaskCreate?: (task: Task) => void;
     onTaskUpdate?: (task: Task) => void;
@@ -346,6 +815,7 @@ interface TaskBoardContextValue {
     columns: ColumnConfig[];
     priorities: PriorityConfig[];
     tags: TagConfig[];
+    internalLabel: string;
     config: TaskBoardConfig;
     features: Required<NonNullable<TaskBoardConfig['features']>>;
 }
@@ -399,11 +869,60 @@ declare function useShareLink(): {
     copyShareLink: (taskId: string, projectSlug: string) => void;
 };
 
+interface UseTaskQuestionsResult {
+    questions: Question[];
+    loading: boolean;
+    /** Re-fetch from the server. Use after mutations to refresh state. */
+    refresh: () => Promise<void>;
+    /** Optimistic local replace (e.g. when the parent page re-fetches the whole task). */
+    setQuestions: (next: Question[]) => void;
+    createQuestion: (text: string) => Promise<void>;
+    updateQuestion: (questionId: string, text: string) => Promise<void>;
+    setStatus: (questionId: string, status: QuestionStatus) => Promise<void>;
+    deleteQuestion: (questionId: string) => Promise<void>;
+    addReply: (questionId: string, content: string) => Promise<void>;
+    deleteReply: (questionId: string, replyId: string) => Promise<void>;
+}
+/**
+ * Manage the structured Outstanding Questions list for a single task.
+ *
+ * The hook owns its own loading state and re-fetches after each mutation
+ * so the parent component can stay simple. Pass `initial` from the
+ * embedded `TaskDetailResponse.questions` to avoid an extra request on
+ * mount.
+ */
+declare function useTaskQuestions(taskId: string | null, initial?: Question[]): UseTaskQuestionsResult;
+
+interface UseTaskAttachmentsResult {
+    attachments: Attachment[];
+    loading: boolean;
+    /** Re-fetch from the server. */
+    refresh: () => Promise<void>;
+    setAttachments: (next: Attachment[]) => void;
+    /** Upload a single file (image or document). Returns the new attachment. */
+    uploadFile: (file: File) => Promise<Attachment>;
+    /** Add an external link / recording. Returns the new attachment. */
+    addLink: (payload: CreateLinkAttachmentPayload) => Promise<Attachment>;
+    /** Delete an attachment (and its underlying GCS object, if any). */
+    remove: (attachmentId: string) => Promise<void>;
+}
+/**
+ * Manage the attachments collection for a single task.
+ *
+ * Pass `initial` from the embedded `TaskDetailResponse.attachments` to
+ * avoid an extra request on mount.
+ */
+declare function useTaskAttachments(taskId: string | null, initial?: Attachment[]): UseTaskAttachmentsResult;
+
 declare function getPriorityStyle(priority: string): PriorityConfig;
 declare function getTagStyle(tag: string): TagConfig;
 declare function getInitials(name: string): string;
+/** Parse a date string, treating timezone-naive Mongo timestamps as UTC. */
+declare function parseDate(dateStr: string): Date;
 declare function formatDate(dateStr: string): string;
 declare function formatDateTime(dateStr: string): string;
+/** Build a short task ID label like "T-AB12CD" from a Mongo ObjectId. */
+declare function formatTaskId(id: string): string;
 declare function getDescriptionPreview(desc: StructuredDescription | string | undefined): string;
 declare function hasDescription(desc: StructuredDescription | string | undefined): boolean;
 declare function getUserProjects(apps: string[], allProjects: {
@@ -414,6 +933,20 @@ declare function getUserProjects(apps: string[], allProjects: {
     name: string;
 }[];
 
+/**
+ * Markdown ⇄ HTML round-trip helpers used by the WYSIWYG `MarkdownEditor`.
+ *
+ * Storage format: markdown (so existing readers, the backend, and previews
+ * keep working). Editing format: HTML in a contenteditable div, so users
+ * never see raw `**` / `- ` / `# ` syntax.
+ *
+ * Mentions stored as `@[Name](username)` round-trip through the
+ * `<span class="mention-pill" data-mention-username="...">@Name</span>`
+ * representation.
+ */
+declare function mdToHtml(md: string): string;
+declare function htmlToMd(html: string): string;
+
 declare const DEFAULT_COLUMNS: ColumnConfig[];
 declare const DEFAULT_PRIORITIES: PriorityConfig[];
 declare const PREDEFINED_TAGS: TagConfig[];
@@ -421,6 +954,8 @@ declare const DESCRIPTION_SECTIONS: DescriptionSectionConfig[];
 declare const EMPTY_DESCRIPTION: StructuredDescription;
 declare const POSITION_GAP = 1000;
 declare const DEFAULT_PAGE_SIZE = 10;
+/** Default label shown on internal-only comments. Override via TaskBoardProvider's `internalLabel` prop. */
+declare const DEFAULT_INTERNAL_LABEL = "Internal";
 
 interface IconProps {
     className?: string;
@@ -430,15 +965,39 @@ interface IconProps {
 declare const PlusIcon: React__default.FC<IconProps>;
 declare const XIcon: React__default.FC<IconProps>;
 declare const ChevronDownIcon: React__default.FC<IconProps>;
+declare const ChevronLeftIcon: React__default.FC<IconProps>;
+declare const ChevronRightIcon: React__default.FC<IconProps>;
+declare const ArrowLeftIcon: React__default.FC<IconProps>;
+declare const MoreVerticalIcon: React__default.FC<IconProps>;
+declare const Share2Icon: React__default.FC<IconProps>;
 declare const MessageSquareIcon: React__default.FC<IconProps>;
 declare const KanbanIcon: React__default.FC<IconProps>;
 declare const LinkIcon: React__default.FC<IconProps>;
+declare const Link2Icon: React__default.FC<IconProps>;
+declare const ExternalLinkIcon: React__default.FC<IconProps>;
+declare const ImageIcon: React__default.FC<IconProps>;
+declare const FileTextIcon: React__default.FC<IconProps>;
 declare const CheckIcon: React__default.FC<IconProps>;
+declare const CheckCircle2Icon: React__default.FC<IconProps>;
 declare const BellIcon: React__default.FC<IconProps>;
 declare const FilterIcon: React__default.FC<IconProps>;
 declare const PencilIcon: React__default.FC<IconProps>;
 declare const TrashIcon: React__default.FC<IconProps>;
 declare const LockIcon: React__default.FC<IconProps>;
 declare const FeedbackIcon: React__default.FC<IconProps>;
+declare const HelpCircleIcon: React__default.FC<IconProps>;
+declare const CornerUpLeftIcon: React__default.FC<IconProps>;
+declare const RotateCcwIcon: React__default.FC<IconProps>;
+declare const Bold: React__default.FC<IconProps>;
+declare const Italic: React__default.FC<IconProps>;
+declare const List: React__default.FC<IconProps>;
+declare const ListOrdered: React__default.FC<IconProps>;
+declare const Heading2: React__default.FC<IconProps>;
+declare const Quote: React__default.FC<IconProps>;
+declare const Code: React__default.FC<IconProps>;
+declare const ChatDotsIcon: React__default.FC<IconProps>;
+declare const HistoryIcon: React__default.FC<IconProps>;
+/** Sidebar-toggle icon used to collapse / re-open the threads panel. */
+declare const SidebarToggleIcon: React__default.FC<IconProps>;
 
-export { type ActivityEntry, type ApiClient, type ApiClientConfig, BellIcon, BoardSkeleton, CheckIcon, ChevronDownIcon, type ColumnConfig, type ColumnResponse, type ColumnTotals, type ColumnUnreads, type Comment, type CreateCommentPayload, CreateTaskModal, type CreateTaskModalProps, type CreateTaskPayload, DEFAULT_COLUMNS, DEFAULT_PAGE_SIZE, DEFAULT_PRIORITIES, DESCRIPTION_SECTIONS, type DescriptionSectionConfig, EMPTY_DESCRIPTION, type EditCommentPayload, FeedbackIcon, FilterBar, type FilterBarProps, FilterIcon, KanbanColumn, type KanbanColumnProps, KanbanIcon, LinkIcon, LockIcon, MentionText, MentionTextarea, type MentionTextareaProps, type MentionUser, MessageSquareIcon, type Notification, NotificationBell, type NotificationBellProps, type NotificationCountResponse, POSITION_GAP, PREDEFINED_TAGS, PencilIcon, PlusIcon, PriorityBadge, type PriorityBadgeProps, type PriorityConfig, type Project, SkeletonCard, SkeletonPulse, type StructuredDescription, TagBadge, type TagBadgeProps, type TagConfig, type Task, TaskBoard, type TaskBoardConfig, type TaskBoardContextValue, type TaskBoardProps, TaskBoardProvider, type TaskBoardService, type TaskBoardUser, TaskCard, type TaskCardProps, TaskDetailPanel, type TaskDetailPanelProps, type TaskDetailResponse, type TasksByStatus, TrashIcon, type UpdateTaskPayload, UserAvatar, type UserAvatarProps, XIcon, createTaskBoardService, formatDate, formatDateTime, getDescriptionPreview, getInitials, getPriorityStyle, getTagStyle, getUserProjects, hasDescription, toDisplayText, toStoredText, useShareLink, useTaskActions, useTaskBoard, useTaskBoardContext, useTaskDetail };
+export { type ActivityEntry, ActivityList, type ActivityListProps, type ApiClient, type ApiClientConfig, ArrowLeftIcon, type Attachment, type AttachmentKind, AttachmentsSection, type AttachmentsSectionProps, BellIcon, BoardSkeleton, Bold, type BubbleState, ChatDotsIcon, CheckCircle2Icon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, Code, type ColumnConfig, type ColumnResponse, type ColumnTotals, type ColumnUnreads, type Comment, ContextPill, type ContextPillProps, type ContextPillVariant, CornerUpLeftIcon, type CreateCommentPayload, type CreateLinkAttachmentPayload, type CreateQuestionPayload, type CreateQuestionReplyPayload, CreateTaskModal, type CreateTaskModalProps, type CreateTaskPayload, DEFAULT_COLUMNS, DEFAULT_INTERNAL_LABEL, DEFAULT_PAGE_SIZE, DEFAULT_PRIORITIES, DESCRIPTION_SECTIONS, DescriptionSection, type DescriptionSectionConfig, type DescriptionSectionProps, EMPTY_DESCRIPTION, type EditCommentPayload, ExternalLinkIcon, FeedbackIcon, FileTextIcon, FilterBar, type FilterBarProps, FilterIcon, Heading2, HelpCircleIcon, HighlightBubble, type HighlightBubbleProps, HistoryIcon, ImageIcon, Italic, KanbanColumn, type KanbanColumnProps, KanbanIcon, Link2Icon, LinkIcon, List, ListOrdered, LockIcon, MarkdownEditor, type MarkdownEditorProps, MarkdownView, MentionText, MentionTextarea, type MentionTextareaProps, type MentionUser, MessageSquareIcon, MoreVerticalIcon, type Notification, NotificationBell, type NotificationBellProps, type NotificationCountResponse, OutstandingQuestionsSection, type OutstandingQuestionsSectionProps, POSITION_GAP, PREDEFINED_TAGS, PencilIcon, PlusIcon, PriorityBadge, type PriorityBadgeProps, type PriorityConfig, type Project, type Question, type QuestionReply, type QuestionStatus, Quote, RotateCcwIcon, type SectionKey, type SectionStatus, Share2Icon, SidebarToggleIcon, SkeletonCard, SkeletonPulse, type StructuredDescription, TagBadge, type TagBadgeProps, type TagConfig, type Task, TaskBoard, type TaskBoardConfig, type TaskBoardContextValue, type TaskBoardProps, TaskBoardProvider, type TaskBoardService, type TaskBoardUser, TaskCard, type TaskCardProps, TaskDetailPanel, type TaskDetailPanelProps, type TaskDetailResponse, TaskDetailView, type TaskDetailViewProps, type TasksByStatus, type Thread, type ThreadAnchor, ThreadCard, type ThreadCardProps, ThreadComposer, type ThreadComposerProps, ThreadDetailView, type ThreadDetailViewProps, type ThreadReply, type ThreadStatus, ThreadsPanel, type ThreadsPanelProps, TrashIcon, type UpdateQuestionPayload, type UpdateTaskPayload, type UpdateThreadPayload, type UseHighlightAnchorResult, type UseTaskAttachmentsResult, type UseTaskQuestionsResult, UserAvatar, type UserAvatarProps, XIcon, createTaskBoardService, deriveThreads, formatDate, formatDateTime, formatTaskId, getDescriptionPreview, getInitials, getPriorityStyle, getTagStyle, getUserProjects, hasDescription, htmlToMd, mdToHtml, parseDate, sectionLabel, timeAgo, toDisplayText, toStoredText, useHighlightAnchor, useShareLink, useTaskActions, useTaskAttachments, useTaskBoard, useTaskBoardContext, useTaskDetail, useTaskQuestions };