@arbidocs/blocks 0.4.129 → 0.4.131

package/dist/connection/ConnectedSettings.d.ts

@@ -6,8 +6,13 @@
  * Every section takes an optional `notify` for toasts and renders the default test ids of its
  * part. Anything the hooks cannot know (the recovery-key download, the billing link of a blocked
  * deletion, the password policy) is a prop.
+ *
+ * The hooks talk to the account client in scope (`useAccountClient` from `@arbidocs/react`):
+ * `ConnectionProvider` provides one over the SDK; a host with its own session and API client
+ * mounts its own `AccountClientProvider` (as ARBI-frontend does), and these sections work alike.
  */
 import { type ReactNode } from 'react';
+import { type IdentityStatus } from '@arbidocs/react/ui';
 import { type IdentityVerificationLabels } from '../settings/IdentityVerification';
 import { type EmailNotificationCategoryDef } from '../settings/account-views';
 export type SettingsNotify = (message: string, kind: 'success' | 'error') => void;
@@ -15,15 +20,23 @@ export interface ConnectedProfileCardProps {
     notify?: SettingsNotify;
     /** Section heading; default `Profile`. */
     title?: ReactNode;
+    /** Classes of the initials avatar shown without a picture (e.g. the host's per-user colour). */
+    avatarClassName?: string;
+    /** More of the section under the card (e.g. `ConnectedIdentityVerification`). */
+    children?: ReactNode;
 }
 /** Avatar, editable name and email change of the signed-in user (`ProfileCard`). */
-export declare function ConnectedProfileCard({ notify, title }: ConnectedProfileCardProps): import("react").JSX.Element;
+export declare function ConnectedProfileCard({ notify, title, avatarClassName, children, }: ConnectedProfileCardProps): import("react").JSX.Element;
 export interface ConnectedIdentityVerificationProps {
     notify?: SettingsNotify;
     labels?: Partial<IdentityVerificationLabels>;
+    /** Open the host's billing (card, plan) when the fee cannot be charged. */
+    onManageBilling?: () => void;
+    /** The host's price format; default `formatIdentityPrice`. */
+    formatPrice?: (status: IdentityStatus) => string;
 }
-/** The ID check card and its dialog, bound to the SDK. Renders nothing when not offered. */
-export declare function ConnectedIdentityVerification({ notify, labels, }: ConnectedIdentityVerificationProps): import("react").JSX.Element;
+/** The ID check card and its dialog, bound to the account. Renders nothing when not offered. */
+export declare function ConnectedIdentityVerification({ notify, labels, onManageBilling, formatPrice, }: ConnectedIdentityVerificationProps): import("react").JSX.Element;
 export interface ConnectedRequireVerifiedProps {
     children?: ReactNode;
     labels?: Partial<IdentityVerificationLabels>;
@@ -32,6 +45,19 @@ export interface ConnectedRequireVerifiedProps {
 export declare function ConnectedRequireVerified({ children, labels }: ConnectedRequireVerifiedProps): import("react").JSX.Element;
 /** The default password policy: 8 characters, an uppercase letter or symbol, a digit. */
 export declare function defaultUnmetPasswordRequirement(password: string): string | null;
+export interface ConnectedPasswordChangeDialogProps {
+    open: boolean;
+    onClose: () => void;
+    notify?: SettingsNotify;
+    /** The host's password policy; default is {@link defaultUnmetPasswordRequirement}. */
+    getUnmetRequirement?: (password: string) => string | null;
+    /** After signing in with a recovery key: set a new password, no current one asked for. */
+    recoveryMode?: boolean;
+    /** Recovery finished: continue into the app (recovery closes itself, with no success screen). */
+    onRecoveryComplete?: () => void;
+}
+/** Change (or, in recovery mode, set) the master password (`PasswordChangeDialog`). */
+export declare function ConnectedPasswordChangeDialog({ open, onClose, notify, getUnmetRequirement, recoveryMode, onRecoveryComplete, }: ConnectedPasswordChangeDialogProps): import("react").JSX.Element;
 export interface ConnectedSecuritySectionProps {
     notify?: SettingsNotify;
     /** The host's password policy; default is {@link defaultUnmetPasswordRequirement}. */
@@ -39,7 +65,7 @@ export interface ConnectedSecuritySectionProps {
     /** Extra rows under "Change password" (e.g. "Save recovery key"). */
     children?: ReactNode;
 }
-/** The Security card: "Change password" and the dialog behind it (`PasswordChangeDialog`). */
+/** The Security card: "Change password" and the dialog behind it. */
 export declare function ConnectedSecuritySection({ notify, getUnmetRequirement, children, }: ConnectedSecuritySectionProps): import("react").JSX.Element;
 export interface ConnectedNotificationPreferencesProps {
     /** Categories to offer; default {@link EMAIL_NOTIFICATION_CATEGORIES}. */
@@ -60,11 +86,20 @@ export declare function ConnectedSessionsRow({ notify, confirm, renderSessionIco
 export interface ConnectedLogoutDialogProps {
     open: boolean;
     onClose: () => void;
-    isOnline?: boolean;
+    /** Offer "All sessions"; default true (e.g. false for agent accounts). */
+    canLogoutAll?: boolean;
+    /**
+     * Ask before signing out (e.g. unsent work kept only on this device); resolve `false` to stay
+     * signed in. Default: sign out at once.
+     */
+    confirmSignOut?: () => Promise<boolean> | boolean;
     renderSessionIcon?: (status: string) => ReactNode;
 }
-/** Sign out of this device or all devices (`LogoutDialog`), listing the active sessions. */
-export declare function ConnectedLogoutDialog({ open, onClose, isOnline, renderSessionIcon, }: ConnectedLogoutDialogProps): import("react").JSX.Element;
+/**
+ * Sign out of this device or all devices (`LogoutDialog`), listing the active sessions. "All
+ * sessions" must reach the server, so it is disabled offline; "This session" always works.
+ */
+export declare function ConnectedLogoutDialog({ open, onClose, canLogoutAll, confirmSignOut, renderSessionIcon, }: ConnectedLogoutDialogProps): import("react").JSX.Element;
 export interface ConnectedDangerZoneProps {
     notify?: SettingsNotify;
     /** Link to the billing page for a deletion blocked by an active subscription. */

package/dist/document-tools/index.cjs

@@ -2,8 +2,8 @@
 'use strict';
 
 var chunk6MG62I5B_cjs = require('../chunk-6MG62I5B.cjs');
-var chunkUWIILWDI_cjs = require('../chunk-UWIILWDI.cjs');
 var chunkJH6JTI76_cjs = require('../chunk-JH6JTI76.cjs');
+var chunkUWIILWDI_cjs = require('../chunk-UWIILWDI.cjs');
 require('../chunk-ULWRNGGE.cjs');
 require('../chunk-DES3K4SD.cjs');
 var lucideReact = require('lucide-react');

package/dist/document-tools/index.js

@@ -1,7 +1,7 @@
 "use client";
 export { AdoptSignatureDialog, TYPED_SIGNATURE_STYLE } from '../chunk-EQB3WELX.js';
-import { ViewerStatusNote } from '../chunk-6HKLTYNN.js';
 export { SignDocumentDialog } from '../chunk-2YOVK524.js';
+import { ViewerStatusNote } from '../chunk-6HKLTYNN.js';
 import '../chunk-TX2ZICS7.js';
 import '../chunk-VUNV25KB.js';
 import { PencilLine, FileText, PenLine, Users, Send, FilePenLine, Download } from 'lucide-react';

package/dist/facts/fact-citations.d.ts

@@ -0,0 +1,56 @@
+/** One cited passage — mirrors the backend `CitedChunk`. */
+export interface FactCitedChunk {
+    chunk_id: string;
+    page?: number | null;
+}
+/** One cited document — mirrors the backend `CitedDocument`. */
+export interface FactCitedDoc {
+    doc_ext_id: string;
+    /** The document version quoted; missing = its current version (the backend pins it on save). */
+    version?: number | null;
+    chunks: FactCitedChunk[];
+}
+export type FactCitations = FactCitedDoc[];
+type MaybeCitations = FactCitations | null | undefined;
+/**
+ * Adopt a server citation list as a local one. The generated `CitedDocument`
+ * leaves `chunks` optional (a whole-document source may omit it); everything in
+ * the UI wants it present, so it is filled in ONCE, here, where server facts
+ * enter the composer — rather than casting at every call site.
+ */
+export declare function toFactCitations(citations: {
+    doc_ext_id: string;
+    version?: number | null;
+    chunks?: FactCitedChunk[] | null;
+}[] | null | undefined): FactCitations | null;
+/** A whole-document source: the picker ticked it without choosing passages. */
+export declare function isWholeDoc(doc: FactCitedDoc): boolean;
+export declare function docIdsOf(citations: MaybeCitations): string[];
+export declare function chunkIdsOf(citations: MaybeCitations): string[];
+export declare function hasChunk(citations: MaybeCitations, chunkId: string): boolean;
+/** Cite a whole document. No-op when it is already a source. */
+export declare function withDoc(citations: MaybeCitations, docExtId: string): FactCitations;
+/** Drop a document and every passage cited from it. Null once nothing remains. */
+export declare function withoutDoc(citations: MaybeCitations, docExtId: string): FactCitations | null;
+/** Cite a passage; creates the document entry if needed. No-op on a duplicate. */
+export declare function withChunk(citations: MaybeCitations, docExtId: string, chunk: FactCitedChunk): FactCitations;
+/**
+ * Un-cite a passage. By default the document STAYS a source (as a whole-doc
+ * reference) when it loses its last passage — removing the source itself is a
+ * separate act (`withoutDoc`). Pass `keepDoc: false` to drop it too.
+ */
+export declare function withoutChunk(citations: MaybeCitations, chunkId: string, opts?: {
+    keepDoc?: boolean;
+}): FactCitations | null;
+/**
+ * Build a fact's clean text + citations from an assistant answer.
+ *
+ * @param content         Answer markdown, WITH `[text](#cite-N)` markers.
+ * @param activeCitations `model_citations`: citation number → chunk_ids.
+ * @param citationData    Retrieval chunks, keyed by file (holds the metadata).
+ */
+export declare function buildFactCitations(content: string, activeCitations: Record<string, string[]> | null, citationData: Record<string, unknown>): {
+    text: string;
+    citations: FactCitations | null;
+};
+export {};

package/dist/facts/fact-table-column-resize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Drag-to-resize columns for the tables rendered inside the fact editor's
+ * MDXEditor.
+ *
+ * MDXEditor's table has no built-in column resizing, but it renders a
+ * `<colgroup>` of `<col>` elements — one per column plus the leading/trailing
+ * tool columns. Column widths are honoured by setting a width on those `<col>`
+ * elements and switching the table to `table-layout: fixed`. MDXEditor only
+ * manages each `<col>`'s `className` (alignment), so an inline `style.width`
+ * survives typing edits; it only resets when the column count changes (a new
+ * `<colgroup>` is rendered) — acceptable for an editing-time affordance, since
+ * markdown tables can't store widths anyway.
+ *
+ * Wiring: attach once to the editor container. Listeners are delegated, so
+ * they work for tables that appear/disappear as the user edits. Returns a
+ * cleanup that removes every listener and any lingering drag state.
+ */
+export declare function enableFactTableColumnResize(container: HTMLElement): () => void;

package/dist/facts/index.cjs

@@ -1,15 +1,15 @@
 "use client";
 'use strict';
 
-var chunk2WLXQGWC_cjs = require('../chunk-2WLXQGWC.cjs');
 var chunk5FYU7ZIU_cjs = require('../chunk-5FYU7ZIU.cjs');
+var chunk2WLXQGWC_cjs = require('../chunk-2WLXQGWC.cjs');
 var chunkOUW6G4O2_cjs = require('../chunk-OUW6G4O2.cjs');
 var chunkVPPX5XUF_cjs = require('../chunk-VPPX5XUF.cjs');
 var chunkRC25WMVB_cjs = require('../chunk-RC25WMVB.cjs');
 var chunkV4ISCZJ7_cjs = require('../chunk-V4ISCZJ7.cjs');
 var chunk2EI7NCUA_cjs = require('../chunk-2EI7NCUA.cjs');
 var chunkC2CWWEHO_cjs = require('../chunk-C2CWWEHO.cjs');
-var chunkTGWTLNXW_cjs = require('../chunk-TGWTLNXW.cjs');
+var chunkBIXHB4LV_cjs = require('../chunk-BIXHB4LV.cjs');
 var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 var chunkPPCATBOY_cjs = require('../chunk-PPCATBOY.cjs');
@@ -21,6 +21,7 @@ var lucideReact = require('lucide-react');
 var ui = require('@arbidocs/react/ui');
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
+var artifacts = require('@arbidocs/react/artifacts');
 
 var DEFAULT_FACT_COLUMN_LABELS = {
   inChatHeaderTooltip: "Facts added to this chat are always in context for this chat",
@@ -804,7 +805,7 @@ function factDateSpanToFields(dateStart, dateEnd, timezone) {
 }
 function factDateFieldsToSpan(fields) {
   if (!fields.date) return { date: null, date_end: null, timezone: null };
-  const tz = fields.timezone || chunkTGWTLNXW_cjs.detectTimeZone();
+  const tz = fields.timezone || chunkBIXHB4LV_cjs.detectTimeZone();
   const startIso = fields.time ? zonedPartsToIso(fields.date, fields.time, tz) : `${fields.date}T00:00:00.000Z`;
   let endIso;
   if (fields.endDate) {
@@ -989,7 +990,7 @@ function MonthCalendar({
 function FactDateInput({ value, onChange, idPrefix, labels, testIds }) {
   const l = { ...DEFAULT_FACT_DATE_INPUT_LABELS, ...labels };
   const [open, setOpen] = react.useState(false);
-  const timezones = react.useMemo(() => chunkTGWTLNXW_cjs.listTimeZones(), []);
+  const timezones = react.useMemo(() => chunkBIXHB4LV_cjs.listTimeZones(), []);
   const timezoneListId = `${idPrefix}-timezone-options`;
   const span = factDateFieldsToSpan(value);
   const summary = value.time || value.endTime ? summarizeWithTimes(value) : chunkVPPX5XUF_cjs.formatSpan(span.date, span.date_end, span.timezone);
@@ -997,7 +998,7 @@ function FactDateInput({ value, onChange, idPrefix, labels, testIds }) {
   const setStartTime = (time) => onChange({
     ...value,
     time,
-    timezone: time ? value.timezone || chunkTGWTLNXW_cjs.detectTimeZone() : "",
+    timezone: time ? value.timezone || chunkBIXHB4LV_cjs.detectTimeZone() : "",
     endTime: time ? value.endTime : ""
   });
   const setEndTime = (endTime) => onChange({
@@ -1062,7 +1063,7 @@ function FactDateInput({ value, onChange, idPrefix, labels, testIds }) {
               list: timezoneListId,
               value: value.timezone,
               onChange: (e) => onChange({ ...value, timezone: e.target.value }),
-              placeholder: chunkTGWTLNXW_cjs.detectTimeZone(),
+              placeholder: chunkBIXHB4LV_cjs.detectTimeZone(),
               className: "h-8 text-xs",
               "data-testid": `${idPrefix}-timezone`
             }
@@ -1109,7 +1110,7 @@ var DEFAULT_FACT_SOURCE_GROUP_LABELS = {
 };
 function FactSourceGroup({
   docId,
-  document,
+  document: document2,
   isViewing,
   onRemove,
   children,
@@ -1127,7 +1128,7 @@ function FactSourceGroup({
       "data-slot": "fact-source-group",
       children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-1.5 px-1 text-sm", children: [
-          document,
+          document2,
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-1" }),
           onRemove && /* @__PURE__ */ jsxRuntime.jsx(
             "button",
@@ -2113,6 +2114,180 @@ function FactSearchResult({
     )
   ] });
 }
+function toFactCitations(citations) {
+  if (!citations) return null;
+  return citations.map((d) => ({
+    doc_ext_id: d.doc_ext_id,
+    ...d.version ? { version: d.version } : {},
+    chunks: d.chunks ?? []
+  }));
+}
+function isWholeDoc(doc) {
+  return doc.chunks.length === 0;
+}
+function docIdsOf(citations) {
+  return (citations ?? []).map((d) => d.doc_ext_id);
+}
+function chunkIdsOf(citations) {
+  return (citations ?? []).flatMap((d) => d.chunks.map((c) => c.chunk_id));
+}
+function hasChunk(citations, chunkId) {
+  return (citations ?? []).some((d) => d.chunks.some((c) => c.chunk_id === chunkId));
+}
+function withDoc(citations, docExtId) {
+  const list = citations ?? [];
+  if (list.some((d) => d.doc_ext_id === docExtId)) return list;
+  return [...list, { doc_ext_id: docExtId, chunks: [] }];
+}
+function withoutDoc(citations, docExtId) {
+  const remaining = (citations ?? []).filter((d) => d.doc_ext_id !== docExtId);
+  return remaining.length ? remaining : null;
+}
+function withChunk(citations, docExtId, chunk) {
+  const list = citations ?? [];
+  const idx = list.findIndex((d) => d.doc_ext_id === docExtId);
+  if (idx === -1) return [...list, { doc_ext_id: docExtId, chunks: [chunk] }];
+  const doc = list[idx];
+  if (doc.chunks.some((c) => c.chunk_id === chunk.chunk_id)) return list;
+  const next = [...list];
+  next[idx] = { ...doc, chunks: [...doc.chunks, chunk] };
+  return next;
+}
+function withoutChunk(citations, chunkId, opts = {}) {
+  const keepDoc = opts.keepDoc ?? true;
+  const list = citations ?? [];
+  if (!hasChunk(list, chunkId)) return citations ?? null;
+  const next = [];
+  for (const doc of list) {
+    if (!doc.chunks.some((c) => c.chunk_id === chunkId)) {
+      next.push(doc);
+      continue;
+    }
+    const chunks = doc.chunks.filter((c) => c.chunk_id !== chunkId);
+    if (chunks.length || keepDoc) next.push({ ...doc, chunks });
+  }
+  return next.length ? next : null;
+}
+function repairBoldFlanking(md) {
+  return md.replace(/([.,;:!?"'’”)\]])(\*\*|__)(?=[A-Za-z0-9])/g, "$1$2 ");
+}
+var CHAT_LEAD_IN = /^(?:here(?:'s| is| are)|below (?:is|are)|sure|certainly)\b[^\n]*:[ \t]*(?:\n+|$)/i;
+function dropChatLeadIn(md) {
+  const body = md.replace(CHAT_LEAD_IN, "");
+  return body.trim() ? body : md;
+}
+function buildFactCitations(content, activeCitations, citationData) {
+  const text = dropChatLeadIn(repairBoldFlanking(artifacts.unwrapCitationLinks(content)).trim()).trim();
+  if (!activeCitations) return { text, citations: null };
+  const chunkMeta = /* @__PURE__ */ new Map();
+  for (const chunks of Object.values(citationData)) {
+    if (!Array.isArray(chunks)) continue;
+    for (const chunk of chunks) {
+      const meta = {
+        doc_ext_id: chunk.metadata?.doc_ext_id ?? null,
+        page: chunk.metadata?.page_number ?? null
+      };
+      for (const key of [chunk.metadata?.chunk_ext_id, chunk.chunk_id]) {
+        if (key && !chunkMeta.has(key)) chunkMeta.set(key, meta);
+      }
+    }
+  }
+  let citations = null;
+  for (const chunkIds of Object.values(activeCitations)) {
+    for (const chunkId of chunkIds) {
+      const meta = chunkMeta.get(chunkId);
+      if (!meta?.doc_ext_id) continue;
+      citations = withChunk(citations, meta.doc_ext_id, { chunk_id: chunkId, page: meta.page });
+    }
+  }
+  return { text, citations };
+}
+
+// src/facts/fact-table-column-resize.ts
+var EDGE = 6;
+var MIN_WIDTH = 48;
+function enableFactTableColumnResize(container) {
+  let drag = null;
+  const cellFromEvent = (e) => {
+    const el = e.target;
+    const cell = el?.closest?.("td, th");
+    if (!cell || cell.hasAttribute("data-tool-cell")) return null;
+    if (!container.contains(cell)) return null;
+    return cell;
+  };
+  const nearRightEdge = (cell, clientX) => {
+    const rect = cell.getBoundingClientRect();
+    return clientX >= rect.right - EDGE && clientX <= rect.right + 2;
+  };
+  const colForCell = (cell) => {
+    const row = cell.parentElement;
+    const table = cell.closest("table");
+    const colgroup = table?.querySelector("colgroup");
+    if (!row || !table || !colgroup) return null;
+    const index = Array.prototype.indexOf.call(row.children, cell);
+    return colgroup.children[index] ?? null;
+  };
+  const freezeWidths = (table) => {
+    const colgroup = table.querySelector("colgroup");
+    if (!colgroup) return;
+    const ruler = table.querySelector("thead tr") ?? table.querySelector("tbody tr");
+    const cells = ruler ? Array.from(ruler.children) : [];
+    Array.from(colgroup.children).forEach((node, i) => {
+      const col = node;
+      const cell = cells[i];
+      if (!col.style.width && cell) col.style.width = `${cell.getBoundingClientRect().width}px`;
+    });
+    table.style.tableLayout = "fixed";
+  };
+  const onPointerMove = (e) => {
+    if (drag) {
+      const next = Math.max(MIN_WIDTH, drag.startWidth + (e.clientX - drag.startX));
+      drag.col.style.width = `${next}px`;
+      e.preventDefault();
+      return;
+    }
+    const cell = cellFromEvent(e);
+    if (cell && nearRightEdge(cell, e.clientX)) {
+      cell.style.cursor = "col-resize";
+    } else if (cell) {
+      cell.style.cursor = "";
+    }
+  };
+  const endDrag = () => {
+    if (!drag) return;
+    drag = null;
+    document.documentElement.classList.remove("fact-col-resizing");
+    document.removeEventListener("pointermove", onPointerMove, true);
+    document.removeEventListener("pointerup", endDrag, true);
+  };
+  const onPointerDown = (e) => {
+    if (e.button !== 0) return;
+    const cell = cellFromEvent(e);
+    if (!cell || !nearRightEdge(cell, e.clientX)) return;
+    const table = cell.closest("table");
+    if (!table) return;
+    freezeWidths(table);
+    const col = colForCell(cell);
+    if (!col) return;
+    drag = {
+      col,
+      table,
+      startX: e.clientX,
+      startWidth: parseFloat(col.style.width) || cell.getBoundingClientRect().width
+    };
+    e.preventDefault();
+    document.documentElement.classList.add("fact-col-resizing");
+    document.addEventListener("pointermove", onPointerMove, true);
+    document.addEventListener("pointerup", endDrag, true);
+  };
+  container.addEventListener("pointerdown", onPointerDown);
+  container.addEventListener("pointermove", onPointerMove);
+  return () => {
+    endDrag();
+    container.removeEventListener("pointerdown", onPointerDown);
+    container.removeEventListener("pointermove", onPointerMove);
+  };
+}
 
 Object.defineProperty(exports, "DEFAULT_FACT_PASSAGES_LABELS", {
   enumerable: true,
@@ -2190,11 +2365,22 @@ exports.FactsTable = FactsTable;
 exports.FactsToolbar = FactsToolbar;
 exports.FactsViewToggle = FactsViewToggle;
 exports.ISO_DATE_FILTER_PARAMS = ISO_DATE_FILTER_PARAMS;
+exports.buildFactCitations = buildFactCitations;
+exports.chunkIdsOf = chunkIdsOf;
 exports.createFactColumns = createFactColumns;
+exports.docIdsOf = docIdsOf;
+exports.enableFactTableColumnResize = enableFactTableColumnResize;
 exports.factDateFieldsToSpan = factDateFieldsToSpan;
 exports.factDateSpanToFields = factDateSpanToFields;
+exports.hasChunk = hasChunk;
+exports.isWholeDoc = isWholeDoc;
 exports.sourceDocCount = sourceDocCount;
+exports.toFactCitations = toFactCitations;
 exports.toFactRow = toFactRow;
 exports.toFactRows = toFactRows;
+exports.withChunk = withChunk;
+exports.withDoc = withDoc;
+exports.withoutChunk = withoutChunk;
+exports.withoutDoc = withoutDoc;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map