impact-nova 2.5.16 → 2.6.0-alpha.0

package/dist/components/data/ag-grid-react/chat/chat.types.d.ts

@@ -0,0 +1,319 @@
+import { ReactNode } from 'react';
+export type ChatConversationId = string;
+export type ChatTarget = {
+    rowId: string;
+    conversationId: ChatConversationId;
+};
+export type ChatAttachment = {
+    id: string;
+    name: string;
+    kind: "file" | "image";
+    url: string;
+    mimeType?: string;
+    size?: number;
+};
+export type ChatMessageReplyTo = {
+    id: string;
+    author: string;
+    text: string;
+};
+export type ChatPriority = "high" | "medium" | "low";
+export type ChatNotifyPref = "all" | "mentions" | "nothing";
+export type ChatMember = {
+    id: string;
+    name: string;
+    avatarUrl?: string;
+};
+/** Consumer-owned authorization. Nova never infers this from `member.role`. */
+export type ChatAction = "view" | "create" | "edit" | "delete" | "invite" | "remove-member";
+export type ChatActionContext = {
+    rowId: string;
+    conversationId?: ChatConversationId;
+    message?: ChatMessage;
+    member?: ChatMember;
+};
+export type ChatMembersRenderProps = {
+    members: readonly ChatMember[];
+    canInvite: boolean;
+    canRemoveMember: (member: ChatMember) => boolean;
+    onInvite: () => void;
+    onRemove: (member: ChatMember) => void;
+};
+export type ChatPeoplePickerRenderProps = {
+    members: readonly ChatMember[];
+    listPeople: (request?: ChatPeopleRequest) => Promise<readonly ChatMember[]> | readonly ChatMember[];
+    onAdd: (members: readonly ChatMember[]) => void;
+    onCancel: () => void;
+};
+export type ChatPeopleRequest = {
+    query?: string;
+    limit?: number;
+};
+export type ChatMessage = {
+    id: string;
+    text: string;
+    author: string;
+    createdAt: string;
+    updatedAt?: string;
+    parentId?: string;
+    replyTo?: ChatMessageReplyTo;
+    replyCount?: number;
+    pinned?: boolean;
+    deleted?: boolean;
+    priority?: ChatPriority;
+    attachments?: readonly ChatAttachment[];
+    /** Centered WhatsApp-style event line. Not a user bubble. */
+    system?: boolean;
+};
+export type ChatConversation = {
+    conversationId: ChatConversationId;
+    rowId: string;
+    title?: string;
+    createdBy?: string;
+    createdAt?: string;
+    messages: ChatMessage[];
+    hasMoreOlder?: boolean;
+    hiddenCount?: number;
+    messageCount?: number;
+    priority?: ChatPriority;
+    muted?: boolean;
+    notify?: ChatNotifyPref;
+    includeBroadcast?: boolean;
+    members?: readonly ChatMember[];
+};
+export type ChatSummary = {
+    conversationId: ChatConversationId;
+    rowId: string;
+    title: string;
+    preview: string;
+    author?: string;
+    updatedAt?: string;
+    unreadCount?: number;
+    messageCount: number;
+    priority?: ChatPriority;
+    muted?: boolean;
+};
+export type ChatLocateResult = {
+    status: "ready";
+    rowIndex?: number;
+} | {
+    status: "missing";
+};
+export type ChatRowStatus = "ready" | "locating" | "filtered" | "unloaded" | "missing";
+export type ChatCapabilities = {
+    canView: boolean;
+    canCreate: boolean;
+    canEdit: boolean;
+    canDelete: boolean;
+};
+export type ChatPersistEvent = {
+    type: "create-conversation";
+    rowId: string;
+    conversationId: ChatConversationId;
+    title: string;
+    members?: readonly ChatMember[];
+} | {
+    type: "add-message";
+    rowId: string;
+    conversationId: ChatConversationId;
+    message: ChatMessage;
+} | {
+    type: "edit-message";
+    rowId: string;
+    conversationId: ChatConversationId;
+    message: ChatMessage;
+} | {
+    type: "delete-message";
+    rowId: string;
+    conversationId: ChatConversationId;
+    messageId: string;
+} | {
+    type: "pin-message";
+    rowId: string;
+    conversationId: ChatConversationId;
+    messageId: string;
+    pinned: boolean;
+} | {
+    type: "set-priority";
+    rowId: string;
+    conversationId: ChatConversationId;
+    priority: ChatPriority | null;
+    messageId?: string;
+} | {
+    type: "mute-conversation";
+    rowId: string;
+    conversationId: ChatConversationId;
+    muted: boolean;
+} | {
+    type: "set-notify";
+    rowId: string;
+    conversationId: ChatConversationId;
+    notify: ChatNotifyPref;
+    includeBroadcast: boolean;
+} | {
+    type: "set-members";
+    rowId: string;
+    conversationId: ChatConversationId;
+    members: readonly ChatMember[];
+};
+export type ChatSummaryPageRequest = {
+    cursor?: string;
+    limit: number;
+    query?: {
+        text?: string;
+        rowId?: string;
+    };
+};
+export type ChatSummaryPage = {
+    items: readonly ChatSummary[];
+    nextCursor?: string;
+};
+export type ChatThreadPageRequest = {
+    purpose: "page" | "thread" | "pinned";
+    limit: number;
+    before?: string;
+    parentId?: string;
+};
+export type ChatDrawer = {
+    kind: "pinned";
+} | {
+    kind: "thread";
+    parent: ChatMessage;
+};
+export type ChatColumnConfig = {
+    pinned?: "left" | "right" | null;
+    width?: number;
+};
+export type ChatMenuItem = {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    icon?: ReactNode;
+    onSelect: () => void;
+};
+export type ChatUiAction<TContext> = {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    icon?: ReactNode;
+    onSelect: (context: TContext) => void;
+};
+/**
+ * Shared by every Chat extension point. `close()` dismisses the Chat sheet.
+ * Product verbs (Finalize offer, Resolve ticket, Complete request) stay in the
+ * consumer: persist your row, then call `close()`.
+ */
+export type ChatSessionHandle = {
+    close: () => void;
+};
+export type ChatMessageActionContext = ChatSessionHandle & {
+    rowId: string;
+    conversationId: ChatConversationId;
+    message: ChatMessage;
+};
+export type ChatThreadActionContext = ChatSessionHandle & {
+    rowId: string;
+    conversationId: ChatConversationId;
+};
+export type ChatListActionContext = ChatSessionHandle & {
+    rowId: string;
+    conversationIds: readonly string[];
+    activeConversationId: string | null;
+};
+export type ChatComposerRenderProps = {
+    value: string;
+    onChange: (value: string) => void;
+    onSave: () => void;
+    disabled: boolean;
+    saving: boolean;
+    author: string;
+    placeholder?: string;
+    priority?: ChatPriority;
+    onPriorityChange?: (priority: ChatPriority | null) => void;
+    attachments?: readonly ChatAttachment[];
+    onAttachmentsChange?: (attachments: readonly ChatAttachment[]) => void;
+};
+export type ChatComposerToolContext = ChatThreadActionContext & {
+    insertText: (text: string) => void;
+};
+export type DataTableChatConfig = {
+    hasConversation: (rowId: string) => boolean;
+    unreadCount?: (rowId: string) => number;
+    getRowTitle?: (rowId: string) => string;
+    loadConversation: (target: ChatTarget, request?: ChatThreadPageRequest) => Promise<ChatConversation | undefined>;
+    persist: (event: ChatPersistEvent) => Promise<void>;
+    getAuthor: () => string;
+    getCapabilities?: (rowId: string) => ChatCapabilities;
+    /**
+     * Per-action authorization. Return `true` / `false` to override the default,
+     * or `undefined` to fall through to `getCapabilities` + `listPeople`.
+     * Nova does not own roles, tenants, or backend ACL.
+     */
+    can?: (action: ChatAction, context: ChatActionContext) => boolean | undefined;
+    getSummaries?: (request: ChatSummaryPageRequest) => Promise<ChatSummaryPage>;
+    locateRow?: (rowId: string) => Promise<ChatLocateResult>;
+    /**
+     * Inject the `iv-chat` system column. `false` = toolbar + context menu only.
+     * `{ pinned: null }` injects unpinned (not recommended at 50k columns).
+     */
+    column?: false | ChatColumnConfig;
+    /** Bind to an existing consumer column instead of injecting `iv-chat`. */
+    colId?: string;
+    messageActions?: readonly ChatUiAction<ChatMessageActionContext>[];
+    threadActions?: readonly ChatUiAction<ChatThreadActionContext>[];
+    /**
+     * Extra list-toolbar menu items after built-in Mute. Receives checked conversation ids.
+     * Do not hardcode product verbs here — Archive / Delete belong to the consumer.
+     */
+    listActions?: readonly ChatUiAction<ChatListActionContext>[];
+    /**
+     * Outline buttons under a message (Figma “Finalize”-style). Omitted = nothing extra.
+     * Never hardcode product verbs here — the consumer supplies labels.
+     */
+    quickActions?: readonly ChatUiAction<ChatMessageActionContext>[];
+    /**
+     * Extra composer toolbar tools shown in the Figma “Quick action” menu.
+     * Attach / image / emoji / bold / italic / link are built-in.
+     * File picks stay local until the consumer persist writes them.
+     * Completing a row (finalize / resolve / close-out) is `onSelect` + `context.close()`.
+     */
+    composerTools?: readonly ChatUiAction<ChatComposerToolContext>[];
+    /**
+     * Directory used by Add member in the info drawer.
+     * Nova requests `{ query, limit }` (default 10). Omit = members are read-only.
+     */
+    listPeople?: (request?: ChatPeopleRequest) => Promise<readonly ChatMember[]> | readonly ChatMember[];
+    /**
+     * Cheap row presence for the vanilla Chat cell. Not a React render per row.
+     * Sets `data-iv-chat-priority` on the cell. Omit / undefined = no attribute.
+     */
+    priority?: (rowId: string) => ChatPriority | undefined;
+    renderIndicator?: (props: {
+        rowId: string;
+        unreadCount: number;
+        hasConversation: boolean;
+    }) => ReactNode;
+    renderAvatar?: (props: {
+        author: string;
+        member?: ChatMember;
+    }) => ReactNode;
+    renderMessageBody?: (props: {
+        message: ChatMessage;
+    }) => ReactNode;
+    renderComposer?: (props: ChatComposerRenderProps) => ReactNode;
+    /** Replace the Info-drawer member list. Header + people picker stay Nova unless `renderPeoplePicker` is set. */
+    renderMembers?: (props: ChatMembersRenderProps) => ReactNode;
+    /** Replace the Add-member directory. Host still persists `set-members`. */
+    renderPeoplePicker?: (props: ChatPeoplePickerRenderProps) => ReactNode;
+    renderMessageActions?: (props: {
+        items: ChatMenuItem[];
+        context: ChatMessageActionContext;
+    }) => ReactNode;
+    renderThreadActions?: (props: {
+        items: ChatMenuItem[];
+        context: ChatThreadActionContext;
+    }) => ReactNode;
+    renderPanel?: (props: {
+        children: ReactNode;
+    }) => ReactNode;
+};

package/dist/components/data/ag-grid-react/chat/index.d.ts

@@ -0,0 +1,6 @@
+export type { ChatAction, ChatActionContext, ChatAttachment, ChatComposerToolContext, ChatMember, ChatMembersRenderProps, ChatPeoplePickerRenderProps, ChatPeopleRequest, ChatNotifyPref, ChatPriority, ChatCapabilities, ChatColumnConfig, ChatComposerRenderProps, ChatConversation, ChatConversationId, ChatLocateResult, ChatMenuItem, ChatDrawer, ChatMessage, ChatMessageActionContext, ChatMessageReplyTo, ChatPersistEvent, ChatRowStatus, ChatSummary, ChatSummaryPage, ChatSummaryPageRequest, ChatTarget, ChatSessionHandle, ChatThreadActionContext, ChatListActionContext, ChatThreadPageRequest, ChatUiAction, DataTableChatConfig, } from './chat.types';
+export { defaultChatConversationId, CHAT_THREAD_PAGE_SIZE, CHAT_PANEL_PAGE_SIZE, CHAT_MEMBERS_VISIBLE, IV_CHAT_COL_ID } from './chat-constants';
+export { mintConversationId, mintChatMessageId } from './chat-identity';
+export { chatAllows, resolveChatCapabilities, DEFAULT_CHAT_CAPABILITIES } from './chat-capabilities';
+export { boundLoadedConversation, chatPinnedPageRequest, chatReplyThreadRequest, chatThreadPageRequest, scopeChatMessages, selectChatThreadWindow, } from './chat-window';
+export { ChatToggle, type ChatToggleProps } from './chat-toggle';

package/dist/components/data/ag-grid-react/chat/index.js

@@ -0,0 +1,24 @@
+import { CHAT_MEMBERS_VISIBLE as a, CHAT_PANEL_PAGE_SIZE as o, CHAT_THREAD_PAGE_SIZE as r, IV_CHAT_COL_ID as C, defaultChatConversationId as s } from "./chat-constants.js";
+import { mintChatMessageId as A, mintConversationId as _ } from "./chat-identity.js";
+import { DEFAULT_CHAT_CAPABILITIES as n, chatAllows as I, resolveChatCapabilities as T } from "./chat-capabilities.js";
+import { boundLoadedConversation as i, chatPinnedPageRequest as l, chatReplyThreadRequest as p, chatThreadPageRequest as m, scopeChatMessages as P, selectChatThreadWindow as c } from "./chat-window.js";
+import { ChatToggle as g } from "./chat-toggle.js";
+export {
+  a as CHAT_MEMBERS_VISIBLE,
+  o as CHAT_PANEL_PAGE_SIZE,
+  r as CHAT_THREAD_PAGE_SIZE,
+  g as ChatToggle,
+  n as DEFAULT_CHAT_CAPABILITIES,
+  C as IV_CHAT_COL_ID,
+  i as boundLoadedConversation,
+  I as chatAllows,
+  l as chatPinnedPageRequest,
+  p as chatReplyThreadRequest,
+  m as chatThreadPageRequest,
+  s as defaultChatConversationId,
+  A as mintChatMessageId,
+  _ as mintConversationId,
+  T as resolveChatCapabilities,
+  P as scopeChatMessages,
+  c as selectChatThreadWindow
+};

package/dist/components/data/ag-grid-react/chat.story-data.d.ts

@@ -0,0 +1,34 @@
+import { ChatConversation, ChatMember, ChatMessage, ChatPeopleRequest, ChatPersistEvent, ChatPriority, ChatSummary, ChatTarget, ChatThreadPageRequest } from './chat/chat.types';
+import { PlanRow } from './comments.story-data';
+export { PLAN_COLUMNS, PLAN_ROWS, PLAN_PAGE_SIZE, PLAN_LOCATE_MS, type PlanRow } from './comments.story-data';
+export declare const CHAT_SERVER_ROWS: PlanRow[];
+export declare const CHAT_DIRECTORY: readonly ChatMember[];
+export declare function listChatDirectory(request?: ChatPeopleRequest): readonly ChatMember[];
+export declare function seedConversation(rowId: string, messages: ChatMessage[], title: string, conversationId?: string): ChatConversation;
+export declare const QUICK_START_CHATS: ChatConversation[];
+/** QuickStart list only — ~30 chats on the oak dining table row so mute + scroll are visible. */
+export declare const QUICK_START_LIST_CHATS: ChatConversation[];
+export declare function createChatMemoryStore(seed?: ChatConversation[]): {
+    hasConversation: (rowId: string) => boolean;
+    priority: (rowId: string) => ChatPriority | undefined;
+    unreadCount: (rowId: string) => number;
+    getRowTitle: (rowId: string) => string;
+    getCapabilities: () => {
+        canView: boolean;
+        canCreate: boolean;
+        canEdit: boolean;
+        canDelete: boolean;
+    };
+    loadConversation: (target: ChatTarget, request?: ChatThreadPageRequest) => Promise<ChatConversation>;
+    persist: (event: ChatPersistEvent) => Promise<void>;
+    getAuthor: () => string;
+    getSummaries: ({ query, }: {
+        query?: {
+            text?: string;
+            rowId?: string;
+        };
+    }) => Promise<{
+        items: ChatSummary[];
+    }>;
+};
+export declare function longConversation(rowId: string, count: number): ChatConversation;

package/dist/components/data/ag-grid-react/chat.story-sources.d.ts

@@ -0,0 +1,4 @@
+/** Copy-paste blocks for Data Display / DataTable / Chat Docs tab. Consumer imports only. */
+export declare const CHAT_QUICK_START_SOURCE = "import { DataTable, DataTableContent, DataTableToolbar } from \"impact-nova/data-table\";\nimport { ChatToggle, type DataTableChatConfig } from \"impact-nova/ag-grid-react/chat\";\n\n<DataTable className=\"h-[640px]\">\n  <DataTableToolbar>\n    <ChatToggle pressed={chatOpen} onPressedChange={setChatOpen} />\n  </DataTableToolbar>\n  <DataTableContent\n    getRowId={(params) => params.data.id}\n    columnDefs={columnDefs}\n    rowData={rowData}\n    chat={chat}\n  />\n</DataTable>\n\nconst chat: DataTableChatConfig = {\n  hasConversation: (rowId) => store.has(rowId),\n  unreadCount: (rowId) => unread.get(rowId) ?? 0,\n  loadConversation: async (target, request) => fetchPage(target, request),\n  persist: async (event) => { /* write one message, not the whole history */ },\n  getAuthor: () => currentUserName,\n  getSummaries: async ({ cursor, limit, query }) => fetchSummaries({ cursor, limit, query }),\n  locateRow: async (rowId) => loadServerPageForRow(rowId), // required for app-paged / SSRM\n  composerTools: [\n    {\n      id: \"complete\",\n      label: \"Finalize offer\", // consumer copy \u2014 Resolve ticket, Complete request, \u2026\n      onSelect: async (ctx) => {\n        await completeRow(ctx.rowId); // your API\n        ctx.close();\n      },\n    },\n  ],\n};\n";
+export declare const CHAT_SERVER_PAGE_SOURCE = "locateRow: async (rowId) => {\n  const index = allRows.findIndex((row) => row.id === rowId);\n  if (index < 0) return { status: \"missing\" };\n  flushSync(() => setRowPage(Math.floor(index / pageSize)));\n  return { status: \"ready\" };\n}";
+export declare const CHAT_MEMBER_MAPPING_SOURCE = "type PeopleDto = {\n  user_id: string\n  display_name: string\n  avatar_url?: string\n}\n\nasync function listPeople({ query, limit }: { query?: string; limit?: number } = {}) {\n  const page = await fetch(`/conversations/people?q=${query ?? \"\"}&limit=${limit ?? 10}`)\n  const json: { users: PeopleDto[] } = await page.json()\n  return json.users.map((row) => ({\n    id: row.user_id,\n    name: row.display_name,\n    avatarUrl: row.avatar_url,\n  }))\n}\n\nchat.listPeople = listPeople\nchat.can = (action, context) => {\n  if (action === \"invite\" || action === \"remove-member\") return isConversationAdmin(context.rowId)\n  return undefined\n}\n";