@emberai-engg/task-board 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -27,6 +27,8 @@ interface StructuredDescription {
      * Not rendered in the current detail UI.
      */
     open_questions: string;
+    /** Long-form markdown rendered under the Technical Details tab on the detail page. */
+    technical_details?: string;
     /** Per-section review status, e.g. `{ problem: "approved" }`. Defaults to draft when absent. */
     section_status?: Record<string, SectionStatus>;
 }
@@ -41,11 +43,25 @@ interface Task {
     created_by: string;
     created_by_name: string;
     comment_count: number;
+    /** Legacy free-form tag slugs (read-only on new tasks). Prefer `applied_tag_ids`. */
     tags?: string[];
+    /** Workspace tag pool IDs applied to this task. */
+    applied_tag_ids?: string[];
     created_at: string;
     updated_at: string;
     has_unread?: boolean;
 }
+/**
+ * A workspace-level tag definition. Tasks reference these by `applied_tag_ids`
+ * so a rename instantly affects every task that carries the tag.
+ */
+interface Tag {
+    id: string;
+    name: string;
+    /** Tailwind class string (e.g. `"bg-red-100 text-red-700"`). */
+    color: string;
+    created_at?: string;
+}
 interface ActivityEntry {
     id: string;
     type: string;
@@ -218,7 +234,8 @@ interface CreateTaskPayload {
     description?: StructuredDescription;
     priority: string;
     status: string;
-    tags: string[];
+    tags?: string[];
+    applied_tag_ids?: string[];
 }
 interface UpdateTaskPayload {
     title?: string;
@@ -227,6 +244,44 @@ interface UpdateTaskPayload {
     status?: string;
     position?: number;
     tags?: string[];
+    applied_tag_ids?: string[];
+}
+interface CreateTagPayload {
+    name: string;
+    color?: string;
+}
+interface UpdateTagPayload {
+    name?: string;
+    color?: string;
+}
+/**
+ * Activity entry enriched with parent task metadata for the Overview feed.
+ * The detail page uses the plainer `ActivityEntry` instead.
+ */
+interface ActivityFeedItem {
+    id: string;
+    type: string;
+    task_id: string;
+    task_title: string;
+    project_slug: string;
+    from_status?: string | null;
+    to_status?: string | null;
+    user: string;
+    user_name: string;
+    created_at: string;
+}
+/** Outstanding question enriched with parent task metadata. */
+interface OutstandingQuestion {
+    id: string;
+    task_id: string;
+    task_title: string;
+    project_slug: string;
+    text: string;
+    status: QuestionStatus;
+    asked_by: string;
+    asked_by_name: string;
+    created_at: string;
+    updated_at: string;
 }
 interface CreateCommentPayload {
     content: string;
@@ -293,6 +348,17 @@ interface TaskCardProps {
     onClick: () => void;
     onShare: (e: React__default.MouseEvent) => void;
     copied: boolean;
+    /**
+     * Workspace tag pool, keyed by ID. When provided, `task.applied_tag_ids` are
+     * resolved through this map; otherwise the card falls back to the legacy
+     * string-based `task.tags` field.
+     */
+    tagsById?: Map<string, Tag>;
+    /**
+     * Optional handler for the dashed "+" tag button on the card. When omitted
+     * the button is hidden — keeps existing consumers backwards-compatible.
+     */
+    onAddTag?: (e: React__default.MouseEvent<HTMLButtonElement>, taskId: string) => void;
 }
 declare const TaskCard: React__default.NamedExoticComponent<TaskCardProps>;
 
@@ -307,17 +373,26 @@ interface KanbanColumnProps {
     onTaskShare: (taskId: string, e: React__default.MouseEvent) => void;
     copiedTaskId: string | null;
     onLoadMore: () => void;
+    /** Workspace tag pool keyed by ID. Forwarded to each TaskCard. */
+    tagsById?: Map<string, Tag>;
+    /** Click handler for the dashed "+" tag button on each card. */
+    onAddTag?: (e: React__default.MouseEvent<HTMLButtonElement>, taskId: string) => void;
 }
-declare function KanbanColumn({ column, tasks, totalCount, unreadCount, loadingMore, onAddTask, onTaskClick, onTaskShare, copiedTaskId, onLoadMore, }: KanbanColumnProps): react_jsx_runtime.JSX.Element;
+declare function KanbanColumn({ column, tasks, totalCount, unreadCount, loadingMore, onAddTask, onTaskClick, onTaskShare, copiedTaskId, onLoadMore, tagsById, onAddTag, }: KanbanColumnProps): react_jsx_runtime.JSX.Element;
 
 interface FilterBarProps {
     projects: Project[];
     selectedProject: string;
     onSelectProject: (slug: string) => void;
-    filterTags: string[];
-    onSetFilterTags: (tags: string[]) => void;
+    /** Workspace tag pool — filter dropdown lists every tag in here. */
+    tagPool?: Tag[];
+    /** Selected workspace tag IDs that the filter is currently active for. */
+    filterTagIds?: string[];
+    onSetFilterTagIds?: (ids: string[]) => void;
+    /** Extra controls rendered on the right of the bar (e.g. layout toggle). */
+    rightSlot?: React__default.ReactNode;
 }
-declare function FilterBar({ projects, selectedProject, onSelectProject, filterTags, onSetFilterTags, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+declare function FilterBar({ projects, selectedProject, onSelectProject, tagPool, filterTagIds, onSetFilterTagIds, rightSlot, }: FilterBarProps): react_jsx_runtime.JSX.Element;
 
 interface NotificationBellProps {
     onOpenTask: (taskId: string, projectSlug: string) => void;
@@ -345,14 +420,21 @@ interface TagBadgeProps {
 }
 declare function TagBadge({ tag, onRemove, size }: TagBadgeProps): react_jsx_runtime.JSX.Element;
 
-/** Renders text with @mentions highlighted as styled badges. */
+/**
+ * Renders text with `@[Name](username)` mention markup highlighted as
+ * styled badges. Plain text is rendered verbatim.
+ *
+ * Splitting and stripping go through hand-written `indexOf` scanners in
+ * `utils/mentions` to keep parsing linear-time on adversarial input
+ * (CodeQL js/polynomial-redos).
+ */
 declare function MentionText({ text, className }: {
     text: string;
     className?: string;
 }): react_jsx_runtime.JSX.Element | null;
-/** Convert stored @[Name](username) to display @Name for textarea */
+/** Convert stored `@[Name](username)` to display `@Name` for textarea. */
 declare function toDisplayText(stored: string): string;
-/** Convert display @Name back to stored @[Name](username) using a mention map */
+/** Convert display `@Name` back to stored `@[Name](username)` using a mention map. */
 declare function toStoredText(display: string, mentionMap: Map<string, string>): string;
 
 interface MentionTextareaProps {
@@ -769,6 +851,46 @@ interface HighlightBubbleProps {
  */
 declare function HighlightBubble({ bubble, onComment }: HighlightBubbleProps): react_jsx_runtime.JSX.Element | null;
 
+interface TagManagerPopoverProps {
+    /** Trigger button rect (viewport coords). Used for fixed positioning. */
+    anchor: DOMRect;
+    /** IDs of tags currently applied to this task. */
+    appliedTagIds: string[];
+    /** The full workspace tag pool. */
+    pool: Tag[];
+    /** Persist the next set of applied tag IDs. */
+    onApplyTagIds: (nextIds: string[]) => void;
+    /** Create a new pool tag and resolve with its persisted form. */
+    onCreateTag: (name: string) => Promise<Tag | null>;
+    /** Rename a pool tag (propagates everywhere). */
+    onRenameTag: (id: string, newName: string) => void;
+    onClose: () => void;
+}
+declare function TagManagerPopover({ anchor, appliedTagIds, pool, onApplyTagIds, onCreateTag, onRenameTag, onClose, }: TagManagerPopoverProps): react_jsx_runtime.JSX.Element;
+
+interface OverviewPanelProps {
+    /** Projects the current user has access to (drives the filter dropdown). */
+    availableProjects: Project[];
+    /** Initial project filter — defaults to "all". */
+    initialProjectSlug?: string;
+    /** Open a task in the consumer's preferred way (route push, slide-over, etc). */
+    onOpenTask?: (taskId: string, projectSlug: string) => void;
+    /** Optional column registry — used to render coloured status pills in moves. */
+    columns?: ColumnConfig[];
+}
+declare function OverviewPanel({ availableProjects, initialProjectSlug, onOpenTask, columns: columnsOverride, }: OverviewPanelProps): react_jsx_runtime.JSX.Element;
+
+interface ListLayoutProps {
+    tasks: Record<string, Task[]>;
+    columnTotals: Record<string, number>;
+    filterTagIds: string[];
+    tagsById: Map<string, Tag>;
+    onTaskClick: (task: Task) => void;
+    onAddTag: (e: React__default.MouseEvent<HTMLButtonElement>, taskId: string) => void;
+    onAddTaskToColumn: (statusKey: string) => void;
+}
+declare function ListLayout({ tasks, columnTotals, filterTagIds, tagsById, onTaskClick, onAddTag, onAddTaskToColumn, }: ListLayoutProps): react_jsx_runtime.JSX.Element;
+
 interface TaskBoardService {
     listTasks(projectSlug: string, perColumn?: number): Promise<Record<string, ColumnResponse>>;
     listColumnTasks(projectSlug: string, statusKey: string, offset: number, limit: number): Promise<Task[]>;
@@ -801,6 +923,12 @@ interface TaskBoardService {
     listNotifications(limit?: number): Promise<Notification[]>;
     markNotificationRead(notificationId: string): Promise<void>;
     markAllNotificationsRead(): Promise<void>;
+    listTags(): Promise<Tag[]>;
+    createTag(data: CreateTagPayload): Promise<Tag>;
+    updateTag(tagId: string, data: UpdateTagPayload): Promise<Tag>;
+    deleteTag(tagId: string): Promise<void>;
+    listActivityFeed(projectSlug?: string, limit?: number): Promise<ActivityFeedItem[]>;
+    listOutstandingQuestions(projectSlug?: string, statusFilter?: QuestionStatus, limit?: number): Promise<OutstandingQuestion[]>;
 }
 declare function createTaskBoardService(apiClient: ApiClient, basePath?: string): TaskBoardService;
 
@@ -946,6 +1074,29 @@ interface UseTaskAttachmentsResult {
  */
 declare function useTaskAttachments(taskId: string | null, initial?: Attachment[]): UseTaskAttachmentsResult;
 
+/**
+ * Workspace-level tag pool. Every consumer reads from the same server-backed
+ * list and mutates through the same CRUD endpoints, so a rename or create on
+ * one surface (e.g. the board's tag popover) is instantly reflected on every
+ * other surface (e.g. the task detail page) on the next render.
+ */
+interface TagPool {
+    tags: Tag[];
+    byId: Map<string, Tag>;
+    loading: boolean;
+    refresh: () => Promise<void>;
+    /** Create a pool tag by name (idempotent — returns the existing one if the name matches). */
+    create: (name: string, color?: string) => Promise<Tag | null>;
+    /** Rename and/or recolor an existing pool tag. */
+    update: (id: string, body: {
+        name?: string;
+        color?: string;
+    }) => Promise<Tag | null>;
+    /** Delete a pool tag (and remove it from every task that references it). */
+    remove: (id: string) => Promise<boolean>;
+}
+declare function useTagPool(): TagPool;
+
 declare function getPriorityStyle(priority: string): PriorityConfig;
 declare function getTagStyle(tag: string): TagConfig;
 declare function getInitials(name: string): string;
@@ -1032,4 +1183,4 @@ 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, 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 };
+export { type ActivityEntry, type ActivityFeedItem, 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, type CreateTagPayload, 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, ListLayout, type ListLayoutProps, ListOrdered, LockIcon, MarkdownEditor, type MarkdownEditorProps, MarkdownView, MentionText, MentionTextarea, type MentionTextareaProps, type MentionUser, MessageSquareIcon, MoreVerticalIcon, type Notification, NotificationBell, type NotificationBellProps, type NotificationCountResponse, type OutstandingQuestion, OutstandingQuestionsSection, type OutstandingQuestionsSectionProps, OverviewPanel, type OverviewPanelProps, 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, type Tag, TagBadge, type TagBadgeProps, type TagConfig, TagManagerPopover, type TagManagerPopoverProps, type TagPool, 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 UpdateTagPayload, 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, useTagPool, useTaskActions, useTaskAttachments, useTaskBoard, useTaskBoardContext, useTaskDetail, useTaskQuestions };

package/dist/index.d.ts

@@ -27,6 +27,8 @@ interface StructuredDescription {
      * Not rendered in the current detail UI.
      */
     open_questions: string;
+    /** Long-form markdown rendered under the Technical Details tab on the detail page. */
+    technical_details?: string;
     /** Per-section review status, e.g. `{ problem: "approved" }`. Defaults to draft when absent. */
     section_status?: Record<string, SectionStatus>;
 }
@@ -41,11 +43,25 @@ interface Task {
     created_by: string;
     created_by_name: string;
     comment_count: number;
+    /** Legacy free-form tag slugs (read-only on new tasks). Prefer `applied_tag_ids`. */
     tags?: string[];
+    /** Workspace tag pool IDs applied to this task. */
+    applied_tag_ids?: string[];
     created_at: string;
     updated_at: string;
     has_unread?: boolean;
 }
+/**
+ * A workspace-level tag definition. Tasks reference these by `applied_tag_ids`
+ * so a rename instantly affects every task that carries the tag.
+ */
+interface Tag {
+    id: string;
+    name: string;
+    /** Tailwind class string (e.g. `"bg-red-100 text-red-700"`). */
+    color: string;
+    created_at?: string;
+}
 interface ActivityEntry {
     id: string;
     type: string;
@@ -218,7 +234,8 @@ interface CreateTaskPayload {
     description?: StructuredDescription;
     priority: string;
     status: string;
-    tags: string[];
+    tags?: string[];
+    applied_tag_ids?: string[];
 }
 interface UpdateTaskPayload {
     title?: string;
@@ -227,6 +244,44 @@ interface UpdateTaskPayload {
     status?: string;
     position?: number;
     tags?: string[];
+    applied_tag_ids?: string[];
+}
+interface CreateTagPayload {
+    name: string;
+    color?: string;
+}
+interface UpdateTagPayload {
+    name?: string;
+    color?: string;
+}
+/**
+ * Activity entry enriched with parent task metadata for the Overview feed.
+ * The detail page uses the plainer `ActivityEntry` instead.
+ */
+interface ActivityFeedItem {
+    id: string;
+    type: string;
+    task_id: string;
+    task_title: string;
+    project_slug: string;
+    from_status?: string | null;
+    to_status?: string | null;
+    user: string;
+    user_name: string;
+    created_at: string;
+}
+/** Outstanding question enriched with parent task metadata. */
+interface OutstandingQuestion {
+    id: string;
+    task_id: string;
+    task_title: string;
+    project_slug: string;
+    text: string;
+    status: QuestionStatus;
+    asked_by: string;
+    asked_by_name: string;
+    created_at: string;
+    updated_at: string;
 }
 interface CreateCommentPayload {
     content: string;
@@ -293,6 +348,17 @@ interface TaskCardProps {
     onClick: () => void;
     onShare: (e: React__default.MouseEvent) => void;
     copied: boolean;
+    /**
+     * Workspace tag pool, keyed by ID. When provided, `task.applied_tag_ids` are
+     * resolved through this map; otherwise the card falls back to the legacy
+     * string-based `task.tags` field.
+     */
+    tagsById?: Map<string, Tag>;
+    /**
+     * Optional handler for the dashed "+" tag button on the card. When omitted
+     * the button is hidden — keeps existing consumers backwards-compatible.
+     */
+    onAddTag?: (e: React__default.MouseEvent<HTMLButtonElement>, taskId: string) => void;
 }
 declare const TaskCard: React__default.NamedExoticComponent<TaskCardProps>;
 
@@ -307,17 +373,26 @@ interface KanbanColumnProps {
     onTaskShare: (taskId: string, e: React__default.MouseEvent) => void;
     copiedTaskId: string | null;
     onLoadMore: () => void;
+    /** Workspace tag pool keyed by ID. Forwarded to each TaskCard. */
+    tagsById?: Map<string, Tag>;
+    /** Click handler for the dashed "+" tag button on each card. */
+    onAddTag?: (e: React__default.MouseEvent<HTMLButtonElement>, taskId: string) => void;
 }
-declare function KanbanColumn({ column, tasks, totalCount, unreadCount, loadingMore, onAddTask, onTaskClick, onTaskShare, copiedTaskId, onLoadMore, }: KanbanColumnProps): react_jsx_runtime.JSX.Element;
+declare function KanbanColumn({ column, tasks, totalCount, unreadCount, loadingMore, onAddTask, onTaskClick, onTaskShare, copiedTaskId, onLoadMore, tagsById, onAddTag, }: KanbanColumnProps): react_jsx_runtime.JSX.Element;
 
 interface FilterBarProps {
     projects: Project[];
     selectedProject: string;
     onSelectProject: (slug: string) => void;
-    filterTags: string[];
-    onSetFilterTags: (tags: string[]) => void;
+    /** Workspace tag pool — filter dropdown lists every tag in here. */
+    tagPool?: Tag[];
+    /** Selected workspace tag IDs that the filter is currently active for. */
+    filterTagIds?: string[];
+    onSetFilterTagIds?: (ids: string[]) => void;
+    /** Extra controls rendered on the right of the bar (e.g. layout toggle). */
+    rightSlot?: React__default.ReactNode;
 }
-declare function FilterBar({ projects, selectedProject, onSelectProject, filterTags, onSetFilterTags, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+declare function FilterBar({ projects, selectedProject, onSelectProject, tagPool, filterTagIds, onSetFilterTagIds, rightSlot, }: FilterBarProps): react_jsx_runtime.JSX.Element;
 
 interface NotificationBellProps {
     onOpenTask: (taskId: string, projectSlug: string) => void;
@@ -345,14 +420,21 @@ interface TagBadgeProps {
 }
 declare function TagBadge({ tag, onRemove, size }: TagBadgeProps): react_jsx_runtime.JSX.Element;
 
-/** Renders text with @mentions highlighted as styled badges. */
+/**
+ * Renders text with `@[Name](username)` mention markup highlighted as
+ * styled badges. Plain text is rendered verbatim.
+ *
+ * Splitting and stripping go through hand-written `indexOf` scanners in
+ * `utils/mentions` to keep parsing linear-time on adversarial input
+ * (CodeQL js/polynomial-redos).
+ */
 declare function MentionText({ text, className }: {
     text: string;
     className?: string;
 }): react_jsx_runtime.JSX.Element | null;
-/** Convert stored @[Name](username) to display @Name for textarea */
+/** Convert stored `@[Name](username)` to display `@Name` for textarea. */
 declare function toDisplayText(stored: string): string;
-/** Convert display @Name back to stored @[Name](username) using a mention map */
+/** Convert display `@Name` back to stored `@[Name](username)` using a mention map. */
 declare function toStoredText(display: string, mentionMap: Map<string, string>): string;
 
 interface MentionTextareaProps {
@@ -769,6 +851,46 @@ interface HighlightBubbleProps {
  */
 declare function HighlightBubble({ bubble, onComment }: HighlightBubbleProps): react_jsx_runtime.JSX.Element | null;
 
+interface TagManagerPopoverProps {
+    /** Trigger button rect (viewport coords). Used for fixed positioning. */
+    anchor: DOMRect;
+    /** IDs of tags currently applied to this task. */
+    appliedTagIds: string[];
+    /** The full workspace tag pool. */
+    pool: Tag[];
+    /** Persist the next set of applied tag IDs. */
+    onApplyTagIds: (nextIds: string[]) => void;
+    /** Create a new pool tag and resolve with its persisted form. */
+    onCreateTag: (name: string) => Promise<Tag | null>;
+    /** Rename a pool tag (propagates everywhere). */
+    onRenameTag: (id: string, newName: string) => void;
+    onClose: () => void;
+}
+declare function TagManagerPopover({ anchor, appliedTagIds, pool, onApplyTagIds, onCreateTag, onRenameTag, onClose, }: TagManagerPopoverProps): react_jsx_runtime.JSX.Element;
+
+interface OverviewPanelProps {
+    /** Projects the current user has access to (drives the filter dropdown). */
+    availableProjects: Project[];
+    /** Initial project filter — defaults to "all". */
+    initialProjectSlug?: string;
+    /** Open a task in the consumer's preferred way (route push, slide-over, etc). */
+    onOpenTask?: (taskId: string, projectSlug: string) => void;
+    /** Optional column registry — used to render coloured status pills in moves. */
+    columns?: ColumnConfig[];
+}
+declare function OverviewPanel({ availableProjects, initialProjectSlug, onOpenTask, columns: columnsOverride, }: OverviewPanelProps): react_jsx_runtime.JSX.Element;
+
+interface ListLayoutProps {
+    tasks: Record<string, Task[]>;
+    columnTotals: Record<string, number>;
+    filterTagIds: string[];
+    tagsById: Map<string, Tag>;
+    onTaskClick: (task: Task) => void;
+    onAddTag: (e: React__default.MouseEvent<HTMLButtonElement>, taskId: string) => void;
+    onAddTaskToColumn: (statusKey: string) => void;
+}
+declare function ListLayout({ tasks, columnTotals, filterTagIds, tagsById, onTaskClick, onAddTag, onAddTaskToColumn, }: ListLayoutProps): react_jsx_runtime.JSX.Element;
+
 interface TaskBoardService {
     listTasks(projectSlug: string, perColumn?: number): Promise<Record<string, ColumnResponse>>;
     listColumnTasks(projectSlug: string, statusKey: string, offset: number, limit: number): Promise<Task[]>;
@@ -801,6 +923,12 @@ interface TaskBoardService {
     listNotifications(limit?: number): Promise<Notification[]>;
     markNotificationRead(notificationId: string): Promise<void>;
     markAllNotificationsRead(): Promise<void>;
+    listTags(): Promise<Tag[]>;
+    createTag(data: CreateTagPayload): Promise<Tag>;
+    updateTag(tagId: string, data: UpdateTagPayload): Promise<Tag>;
+    deleteTag(tagId: string): Promise<void>;
+    listActivityFeed(projectSlug?: string, limit?: number): Promise<ActivityFeedItem[]>;
+    listOutstandingQuestions(projectSlug?: string, statusFilter?: QuestionStatus, limit?: number): Promise<OutstandingQuestion[]>;
 }
 declare function createTaskBoardService(apiClient: ApiClient, basePath?: string): TaskBoardService;
 
@@ -946,6 +1074,29 @@ interface UseTaskAttachmentsResult {
  */
 declare function useTaskAttachments(taskId: string | null, initial?: Attachment[]): UseTaskAttachmentsResult;
 
+/**
+ * Workspace-level tag pool. Every consumer reads from the same server-backed
+ * list and mutates through the same CRUD endpoints, so a rename or create on
+ * one surface (e.g. the board's tag popover) is instantly reflected on every
+ * other surface (e.g. the task detail page) on the next render.
+ */
+interface TagPool {
+    tags: Tag[];
+    byId: Map<string, Tag>;
+    loading: boolean;
+    refresh: () => Promise<void>;
+    /** Create a pool tag by name (idempotent — returns the existing one if the name matches). */
+    create: (name: string, color?: string) => Promise<Tag | null>;
+    /** Rename and/or recolor an existing pool tag. */
+    update: (id: string, body: {
+        name?: string;
+        color?: string;
+    }) => Promise<Tag | null>;
+    /** Delete a pool tag (and remove it from every task that references it). */
+    remove: (id: string) => Promise<boolean>;
+}
+declare function useTagPool(): TagPool;
+
 declare function getPriorityStyle(priority: string): PriorityConfig;
 declare function getTagStyle(tag: string): TagConfig;
 declare function getInitials(name: string): string;
@@ -1032,4 +1183,4 @@ 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, 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 };
+export { type ActivityEntry, type ActivityFeedItem, 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, type CreateTagPayload, 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, ListLayout, type ListLayoutProps, ListOrdered, LockIcon, MarkdownEditor, type MarkdownEditorProps, MarkdownView, MentionText, MentionTextarea, type MentionTextareaProps, type MentionUser, MessageSquareIcon, MoreVerticalIcon, type Notification, NotificationBell, type NotificationBellProps, type NotificationCountResponse, type OutstandingQuestion, OutstandingQuestionsSection, type OutstandingQuestionsSectionProps, OverviewPanel, type OverviewPanelProps, 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, type Tag, TagBadge, type TagBadgeProps, type TagConfig, TagManagerPopover, type TagManagerPopoverProps, type TagPool, 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 UpdateTagPayload, 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, useTagPool, useTaskActions, useTaskAttachments, useTaskBoard, useTaskBoardContext, useTaskDetail, useTaskQuestions };