impact-nova 2.5.17 → 2.6.0-alpha.0

package/README.md

@@ -221,52 +221,54 @@ export const CustomAction = ({ analyticsId, ...props }: CustomActionProps) => {
 
 ### Internationalization (i18n)
 
-Impact Nova supports multiple languages via a provider and message overrides. Wrap your app (or subtree) with `ImpactNovaI18nProvider` and set `locale` and optionally `messages`.
-
-**Locale packs** (German, Spanish, Hindi, Kannada) are exported so you can use them as-is or override only the strings you need:
+Formatting locales are BCP 47 tags, not a closed enum. UI copy is a separate opt-in pack. Wrap the app with `ImpactNovaProviders` from `impact-nova/form` (or `ImpactNovaI18nProvider` from `impact-nova/i18n`).
 
 ```tsx
-import { ImpactNovaI18nProvider, de, defaultMessages } from "impact-nova";
+import { ImpactNovaProviders } from "impact-nova/form";
+import { de } from "impact-nova/locale/de";
+import { formatDate, formatNumber, formatCurrency } from "impact-nova/i18n";
 
-// Use a full locale pack as-is
-function App() {
-  return (
-    <ImpactNovaI18nProvider locale="de" messages={de}>
-      <MyApp />
-    </ImpactNovaI18nProvider>
-  );
-}
+<ImpactNovaProviders locale="de-DE" messages={de}>
+  <MyApp />
+</ImpactNovaProviders>
 ```
 
-**Override only a few keys** by spreading a locale pack and then overriding specific sections or keys. The provider merges your `messages` over the built-in English defaults (or over the pack you pass), so you only need to provide the keys you want to change:
+Independent date and number locales:
 
 ```tsx
-import { ImpactNovaI18nProvider, de } from "impact-nova";
+<ImpactNovaProviders
+  locale="de-DE"
+  dateLocale="en-GB"
+  numberLocale="en-US"
+  messages={de}
+>
+```
+
+**Override only a few keys** by spreading a locale pack:
+
+```tsx
+import { de } from "impact-nova/locale/de";
 
-// German with custom labels for calendar only
 const messages = {
   ...de,
   calendar: { ...de.calendar, apply: "Übernehmen", cancel: "Schließen" },
 };
-
-<ImpactNovaI18nProvider locale="de" messages={messages}>
-  <MyApp />
-</ImpactNovaI18nProvider>;
 ```
 
-**Tree-shakeable locale imports** (if you only need one language and want to avoid pulling others into your bundle):
+**Tree-shakeable locale packs:**
 
 ```tsx
 import { de } from "impact-nova/locale/de";
-// or
 import { de, es, hi, kn } from "impact-nova/locale";
 ```
 
-- **`locale`**: BCP 47 code (e.g. `'en'`, `'de'`) used for date/number formatting. Supported: `en`, `en-US`, `en-GB`, `de`, `es`, `hi`, `kn`.
-- **`messages`**: Optional `Partial<ImpactNovaMessages>`. Merged over the built-in English defaults; only provided keys are overridden. Use a locale pack (`de`, `es`, `hi`, `kn`) or spread one and override specific keys.
-- **Per-component overrides**: Components that accept props like `placeholder`, `submitButtonLabel`, or `cancelLabel` use those when provided; otherwise they use values from the provider.
+- **`locale`**: BCP 47 language locale and default for formatting (e.g. `'de-DE'`). Default `'en'`.
+- **`dateLocale` / `numberLocale`**: optional overrides; each falls back to `locale`. `en-GB` is not rewritten to `en-US`.
+- **`messages`**: optional pack. `locale="de-DE"` does not auto-load German copy.
+- Format with `formatDate` / `formatNumber` / `formatCurrency` from `impact-nova/i18n`. Currency is always an explicit ISO code.
+- Explicit `format`, `weekStartsOn`, and `colDef.locale` still win.
 
-Calendar, date pickers, Select, NestedList, DataTableColumnList, and aria labels (e.g. Alert close, Breadcrumb, Chips remove) use the context. See `docs/I18N_PLAN.md` for the full list of message keys and components.
+See Storybook **Locale Lab** and `impact-nova://i18n` (MCP) for the full contract.
 
 ---
 

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

@@ -2,6 +2,9 @@ import { ReactNode } from 'react';
 import { ColDef, ColGroupDef, IHeaderParams, IHeaderGroupParams, Column, ValueFormatterParams } from 'ag-grid-community';
 import { Theme } from 'ag-grid-enterprise';
 import { AgGridReactProps } from 'ag-grid-react';
+import { DataTableCommentsConfig } from './comments/comments.types';
+import { DataTableNotesConfig } from './notes/notes.types';
+import { DataTableChatConfig } from './chat/chat.types';
 /** ColDef extended with Impact Nova runtime metadata set during column processing */
 export interface ImpactNovaColDef<TData = unknown> extends ColDef<TData> {
     /** Original column-level editable before addRowDataEditableCheck wraps the callback */
@@ -42,7 +45,7 @@ export interface ExtendedHeaderComponentParams extends Partial<IHeaderParams> {
     enableDateParsing?: boolean;
     /** Which picker to render for date columns. Default: 'date' */
     datePickerVariant?: 'date' | 'month' | 'week';
-    /** Display format for dates in this column (date-fns token string). Default: "MM/dd/yyyy" */
+    /** Display format for dates in this column (date-fns token string). Omitted → locale-derived pattern. */
     dateDisplayFormat?: string;
     /** Fiscal calendar configuration for week/month picker */
     fiscalConfig?: {
@@ -143,6 +146,30 @@ export interface AgGridWrapperProps<TData = unknown> extends Omit<AgGridReactPro
      * Application code must rely on document CSS variables and the default theme.
      */
     themeOverride?: Theme;
+    /**
+     * Opt-in cell comments. When omitted the grid is unchanged (no comments
+     * overlay or mouse-handler wrap). Requires `getRowId`.
+     * Import helpers from `impact-nova/ag-grid-react/comments`.
+     *
+     * Optional `locateRow` loads SSRM / server-paged rows that are not in memory.
+     */
+    comments?: DataTableCommentsConfig;
+    /**
+     * Opt-in AG Grid cell notes. When omitted the grid does not pass `notesDataSource`.
+     * Requires `getRowId`. Import types from `impact-nova/ag-grid-react/notes`.
+     *
+     * Notes are AG Grid-owned (text on a cell). Comments remain a separate conversation.
+     */
+    notes?: DataTableNotesConfig;
+    /**
+     * Opt-in row Chat. When omitted the grid is unchanged (no Chat column,
+     * host, listeners, or fetch). Requires `getRowId`.
+     * Import helpers from `impact-nova/ag-grid-react/chat`.
+     *
+     * Identity is the stable row id. Optional `locateRow` loads SSRM /
+     * server-paged rows that are not in memory.
+     */
+    chat?: DataTableChatConfig;
 }
 /**
  * Filter operators for advanced filtering.

package/dist/components/data/ag-grid-react/cell-renderers/date-display-renderer.d.ts

@@ -1,10 +1,7 @@
 import { ICellRendererParams } from 'ag-grid-community';
 export interface DateDisplayRendererProps extends ICellRendererParams {
-    /** Date format type: 'date' | 'datetime-local' | 'time' */
     dateType?: 'date' | 'datetime-local' | 'time';
-    /** Placeholder text when no date is selected */
     placeholder?: string;
-    /** Whether the field is disabled */
     disabled?: boolean;
 }
 /**

package/dist/components/data/ag-grid-react/cell-renderers/date-display-renderer.js

@@ -1,57 +1,50 @@
-import { jsx as n, jsxs as b } from "react/jsx-runtime";
-import { Calendar as y } from "impact-nova-icons";
-const D = (t, i) => {
-  if (t == null || t === "") return "";
-  try {
-    const e = t instanceof Date ? t : new Date(String(t));
-    return isNaN(e.getTime()) ? String(t) : i === "time" ? e.toLocaleTimeString(void 0, { hour: "2-digit", minute: "2-digit" }) : i === "datetime-local" ? e.toLocaleString(void 0, {
-      year: "numeric",
-      month: "short",
-      day: "numeric",
-      hour: "2-digit",
-      minute: "2-digit"
-    }) : e.toLocaleDateString(void 0, {
-      year: "numeric",
-      month: "short",
-      day: "numeric"
-    });
-  } catch {
-    return String(t);
-  }
-}, x = (t) => {
-  const {
-    valueFormatted: i,
-    value: e,
-    dateType: m = "date",
-    placeholder: g = "Select date...",
+import { jsx as r, jsxs as g } from "react/jsx-runtime";
+import { Calendar as w } from "impact-nova-icons";
+import { useImpactNovaI18n as v } from "../../../../i18n/use-impact-nova-i18n.js";
+import { DEFAULT_LOCALE as j } from "../../../../i18n/locale-config.js";
+import { formatTime as L, formatDateTime as N, formatDate as E } from "../../../../i18n/format/format-date.js";
+function F(e) {
+  const l = e.context;
+  return e.colDef?.locale || l?.dateLocale || l?.locale || j;
+}
+const M = (e, l, o) => e == null || e === "" ? "" : l === "time" ? L(e, o) : l === "datetime-local" ? N(e, o) : E(e, o, {
+  year: "numeric",
+  month: "short",
+  day: "numeric"
+}), _ = (e) => {
+  const { t: l } = v(), o = F(e), {
+    valueFormatted: p,
+    value: t,
+    dateType: b = "date",
+    placeholder: h,
     disabled: s,
-    colDef: r,
-    data: l
-  } = t, o = e && typeof e == "object" && "cellMetadata" in e ? e.cellMetadata?._isDisabled : void 0, c = l && typeof l == "object" && "rowMetadata" in l ? l.rowMetadata?._isDisabled : void 0;
+    colDef: n,
+    data: i
+  } = e, D = h ?? l("datePicker.selectDate"), c = t && typeof t == "object" && "cellMetadata" in t ? t.cellMetadata?._isDisabled : void 0, d = i && typeof i == "object" && "rowMetadata" in i ? i.rowMetadata?._isDisabled : void 0;
   let a = !1;
   if (!s) {
-    const p = r?._originalEditable;
-    r?.editable === !1 ? a = !1 : o === !1 ? a = !0 : o === !0 ? a = !1 : c === !1 ? a = !0 : c === !0 ? a = !1 : a = p === !0 || r?.editable === !0;
+    const x = n?._originalEditable;
+    n?.editable === !1 ? a = !1 : c === !1 ? a = !0 : c === !0 ? a = !1 : d === !1 ? a = !0 : d === !0 ? a = !1 : a = x === !0 || n?.editable === !0;
   }
-  const d = e && typeof e == "object" && "value" in e, h = d ? e.value : e, u = (d ? null : i) ?? D(h, m), f = !u;
-  return /* @__PURE__ */ n(
+  const f = t && typeof t == "object" && "value" in t, y = f ? t.value : t, m = (f ? null : p) ?? M(y, b, o), u = !m;
+  return /* @__PURE__ */ r(
     "div",
     {
       className: `w-full h-full flex items-center ag-cell-inner-padding ${s ? "opacity-60 cursor-not-allowed" : a ? "in-ag-editable-cell-highlight" : ""}`,
-      children: /* @__PURE__ */ b(
+      children: /* @__PURE__ */ g(
         "div",
         {
           className: `flex w-full items-center justify-between rounded-[8px] px-1.5 h-7 ${a ? "bg-canvas-elevated cursor-pointer" : "bg-inherit"}`,
           children: [
-            /* @__PURE__ */ n("span", { className: `truncate text-sm font-medium text-content ${f ? "text-content-empty" : ""}`, children: f ? g : u }),
-            a && /* @__PURE__ */ n("span", { className: "h-3.5 w-3.5 shrink-0 text-content-icon", children: /* @__PURE__ */ n(y, { className: "h-3.5 w-3.5" }) })
+            /* @__PURE__ */ r("span", { className: `truncate text-sm font-medium text-content ${u ? "text-content-empty" : ""}`, children: u ? D : m }),
+            a && /* @__PURE__ */ r("span", { className: "h-3.5 w-3.5 shrink-0 text-content-icon", children: /* @__PURE__ */ r(w, { className: "h-3.5 w-3.5" }) })
           ]
         }
       )
     }
   );
 };
-x.displayName = "DateDisplayRenderer";
+_.displayName = "DateDisplayRenderer";
 export {
-  x as DateDisplayRenderer
+  _ as DateDisplayRenderer
 };

package/dist/components/data/ag-grid-react/cell-renderers/input-display-renderer.d.ts

@@ -29,7 +29,7 @@ export interface InputDisplayRendererProps extends ICellRendererParams {
  *   singleClickEdit: true,
  *   cellRendererParams: { placeholder: '0.00', isNumeric: true },
  *   cellEditorParams: { inputType: 'number', min: 0, step: 0.01 },
- *   valueFormatter: (p) => p.value ? `$${p.value.toLocaleString()}` : '',
+ *   valueFormatter: (p) => p.value ? formatNumber(p.value, p.context?.numberLocale ?? 'en') : '',
  * }
  * ```
  */

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

@@ -0,0 +1,9 @@
+import { ChatAction, ChatActionContext, ChatCapabilities, DataTableChatConfig } from './chat.types';
+export declare const DEFAULT_CHAT_CAPABILITIES: ChatCapabilities;
+export declare function resolveChatCapabilities(getCapabilities: ((rowId: string) => ChatCapabilities) | undefined, rowId: string): ChatCapabilities;
+/**
+ * Nova asks. The consumer answers.
+ * `can` returning `undefined` falls through to getCapabilities + listPeople.
+ * Invite/remove default to off when `listPeople` is omitted (read-only roster).
+ */
+export declare function chatAllows(config: Pick<DataTableChatConfig, "getCapabilities" | "can" | "listPeople">, action: ChatAction, context: ChatActionContext): boolean;

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

@@ -0,0 +1,22 @@
+const n = {
+  canView: !0,
+  canCreate: !0,
+  canEdit: !1,
+  canDelete: !1
+};
+function l(r, e) {
+  return r?.(e) ?? n;
+}
+function i(r, e, a) {
+  const t = l(r.getCapabilities, a.rowId);
+  return e === "view" ? t.canView : e === "create" ? t.canCreate : e === "edit" ? t.canEdit : e === "delete" ? t.canDelete : t.canCreate && r.listPeople != null;
+}
+function u(r, e, a) {
+  const t = r.can?.(e, a);
+  return typeof t == "boolean" ? t : i(r, e, a);
+}
+export {
+  n as DEFAULT_CHAT_CAPABILITIES,
+  u as chatAllows,
+  l as resolveChatCapabilities
+};

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

@@ -0,0 +1,20 @@
+import { ColDef, ColGroupDef, ICellRendererComp } from 'ag-grid-community';
+import { ChatPriority, DataTableChatConfig } from './chat.types';
+export declare function resolveChatColumnId(config: DataTableChatConfig): string | undefined;
+export declare function shouldInjectChatColumn(config: DataTableChatConfig): boolean;
+type ChatCellPresence = {
+    hasConversation: (rowId: string) => boolean;
+    unreadCount: (rowId: string) => number;
+    priority: (rowId: string) => ChatPriority | undefined;
+    label: (rowId: string, unread: number) => string;
+};
+export declare function createChatCellRenderer(read: () => ChatCellPresence): new () => ICellRendererComp;
+export declare function createChatSystemColumn(args: {
+    headerName: string;
+    cellRenderer: ColDef["cellRenderer"];
+    pinned?: "left" | "right" | null;
+    width?: number;
+}): ColDef;
+export declare function columnDefsIncludeColId(columnDefs: (ColDef | ColGroupDef)[] | undefined, colId: string): boolean;
+export declare function appendChatSystemColumn(columnDefs: (ColDef | ColGroupDef)[] | undefined, chatColumn: ColDef): (ColDef | ColGroupDef)[];
+export {};

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

@@ -0,0 +1,81 @@
+import { IV_CHAT_COL_ID as o, IV_CHAT_COL_WIDTH as h } from "./chat-constants.js";
+const m = new URL("data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='21'%20height='21'%20viewBox='0%200%2021%2021'%20fill='none'%3e%3cpath%20d='M3.88867%204H17.1113C17.3481%204.00006%2017.5748%204.09396%2017.7412%204.25977C17.9074%204.42549%2018%204.65002%2018%204.88281V14.2939C18%2014.5268%2017.9075%2014.7513%2017.7412%2014.917C17.5748%2015.0828%2017.3481%2015.1767%2017.1113%2015.1768H6.4082C5.78401%2015.1768%205.17582%2015.3782%204.67578%2015.752L3%2017.0039V4.88281C3%204.65002%203.09261%204.42549%203.25879%204.25977C3.42517%204.09396%203.65189%204.00006%203.88867%204Z'%20stroke='url(%23iv-chat-message-stroke)'%20stroke-width='2'/%3e%3cdefs%3e%3clinearGradient%20id='iv-chat-message-stroke'%20x1='19'%20y1='11'%20x2='2'%20y2='11'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%234259EE'/%3e%3cstop%20offset='1'%20stop-color='%23F19579'/%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e", import.meta.url).href;
+function v(e) {
+  return e.column === !1 ? e.colId : e.colId ?? o;
+}
+function l(e, r, t, n) {
+  const i = t.node?.id;
+  if (!i) {
+    e.hidden = !0, e.removeAttribute("data-row-id"), e.removeAttribute("data-iv-chat-active"), e.removeAttribute("data-iv-chat-priority"), e.removeAttribute("aria-label"), r.remove();
+    return;
+  }
+  const a = n(), s = Math.max(0, a.unreadCount(i)), u = a.hasConversation(i);
+  e.hidden = !1, e.setAttribute("data-row-id", i), e.setAttribute("aria-label", a.label(i, s)), u ? e.setAttribute("data-iv-chat-active", "") : e.removeAttribute("data-iv-chat-active");
+  const c = a.priority(i);
+  c ? e.setAttribute("data-iv-chat-priority", c) : e.removeAttribute("data-iv-chat-priority"), s > 0 ? (r.textContent = s > 99 ? "99+" : String(s), r.isConnected || (e.querySelector(".iv-chat-cell-icon") ?? e).append(r)) : r.remove();
+}
+function A(e) {
+  return class {
+    button = document.createElement("button");
+    badge = document.createElement("span");
+    init(t) {
+      this.button.type = "button", this.button.className = "iv-chat-cell-button", this.button.setAttribute("data-iv-chat-cell", "");
+      const n = document.createElement("span");
+      n.className = "iv-chat-cell-icon", n.setAttribute("aria-hidden", "true");
+      const i = document.createElement("img");
+      i.src = m, i.alt = "", i.width = 21, i.height = 21, n.append(i), this.button.append(n), this.badge.className = "iv-chat-unread", l(this.button, this.badge, t, e);
+    }
+    getGui() {
+      return this.button;
+    }
+    refresh(t) {
+      return l(this.button, this.badge, t, e), !0;
+    }
+  };
+}
+function b(e) {
+  const r = e.width ?? h, t = e.pinned === void 0 ? "right" : e.pinned;
+  return {
+    colId: o,
+    headerName: e.headerName,
+    width: r,
+    minWidth: r,
+    maxWidth: r,
+    pinned: t,
+    lockPosition: t === "left" ? "left" : "right",
+    lockPinned: !0,
+    suppressMovable: !0,
+    suppressAutoSize: !0,
+    sortable: !1,
+    filter: !1,
+    resizable: !1,
+    suppressHeaderMenuButton: !0,
+    suppressColumnsToolPanel: !0,
+    context: { ivSystemColumn: !0 },
+    cellRenderer: e.cellRenderer,
+    valueGetter: () => ""
+  };
+}
+function d(e, r) {
+  if (!e) return !1;
+  for (const t of e) {
+    if ("children" in t && Array.isArray(t.children)) {
+      if (d(t.children, r)) return !0;
+      continue;
+    }
+    const n = t;
+    if ((n.colId ?? n.field) === r) return !0;
+  }
+  return !1;
+}
+function y(e, r) {
+  const t = e ?? [];
+  return d(t, o) ? t : [...t, r];
+}
+export {
+  y as appendChatSystemColumn,
+  d as columnDefsIncludeColId,
+  A as createChatCellRenderer,
+  b as createChatSystemColumn,
+  v as resolveChatColumnId
+};

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

@@ -0,0 +1,10 @@
+import { ChatComposerRenderProps, ChatComposerToolContext, DataTableChatConfig } from './chat.types';
+export declare function ChatSendIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function ChatComposer({ value, onChange, onSave, disabled, saving, author, placeholder, render, tools, toolContext, hideSend, hideChrome, priority, onPriorityChange, attachments, onAttachmentsChange, }: ChatComposerRenderProps & {
+    placeholder: string;
+    render?: DataTableChatConfig["renderComposer"];
+    tools?: DataTableChatConfig["composerTools"];
+    toolContext?: ChatComposerToolContext;
+    hideSend?: boolean;
+    hideChrome?: boolean;
+}): import("react/jsx-runtime").JSX.Element;