@arbidocs/blocks 0.4.146 → 0.4.150

package/dist/chunk-C7PTF6BQ.cjs

@@ -0,0 +1,172 @@
+"use client";
+'use strict';
+
+var chunkKDG6FER6_cjs = require('./chunk-KDG6FER6.cjs');
+var react = require('react');
+var lucideReact = require('lucide-react');
+var ui = require('@arbidocs/react/ui');
+var jsxRuntime = require('react/jsx-runtime');
+
+function CitationEditor({
+  value,
+  citations,
+  onChange,
+  activeCitationKey,
+  onCiteDocument,
+  citedDocs,
+  renderDocumentPicker,
+  autoFocus = false,
+  "data-testid": dataTestId,
+  placeholder = "Add a note...",
+  readOnly = false,
+  className,
+  defaultHeight,
+  onHeightChange
+}) {
+  const [localValue, setLocalValue] = react.useState(value);
+  const [isEditing, setIsEditing] = react.useState(autoFocus);
+  const textareaRef = react.useRef(null);
+  const debounceRef = react.useRef(null);
+  react.useEffect(() => {
+    if (!isEditing) {
+      setLocalValue(value);
+    }
+  }, [value, isEditing]);
+  const sources = react.useMemo(() => citations ?? [], [citations]);
+  const hasCitations = sources.length > 0;
+  const byDoc = react.useMemo(() => {
+    const groups = /* @__PURE__ */ new Map();
+    for (const doc of sources) {
+      const chunks = doc.chunks ?? [];
+      const pages = [];
+      for (const c of chunks) if (c.page != null && !pages.includes(c.page)) pages.push(c.page);
+      groups.set(doc.doc_ext_id, { pages, count: chunks.length });
+    }
+    return groups;
+  }, [sources]);
+  const docIds = Array.from(byDoc.keys());
+  const handleRemoveDocument = react.useCallback(
+    (docExtId) => {
+      const remaining = sources.filter((d) => d.doc_ext_id !== docExtId);
+      onChange(localValue, remaining.length ? remaining : null);
+    },
+    [sources, localValue, onChange]
+  );
+  const handleToggleDocument = react.useCallback(
+    (docExtId) => {
+      if (!docExtId) return;
+      if (docIds.includes(docExtId)) {
+        handleRemoveDocument(docExtId);
+        return;
+      }
+      onCiteDocument?.(docExtId);
+    },
+    [docIds, onCiteDocument, handleRemoveDocument]
+  );
+  const renderedContent = react.useMemo(
+    () => localValue ? /* @__PURE__ */ jsxRuntime.jsx("span", { children: localValue }) : null,
+    [localValue]
+  );
+  const handleChange = react.useCallback(
+    (newValue) => {
+      setLocalValue(newValue);
+      if (debounceRef.current) clearTimeout(debounceRef.current);
+      debounceRef.current = setTimeout(() => onChange(newValue, citations ?? null), 400);
+    },
+    [citations, onChange]
+  );
+  const flushPendingChange = react.useCallback(() => {
+    if (!debounceRef.current) return;
+    clearTimeout(debounceRef.current);
+    debounceRef.current = null;
+    onChange(localValue, citations ?? null);
+  }, [localValue, citations, onChange]);
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: ui.cn("space-y-1", className), children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "relative", children: isEditing ? /* @__PURE__ */ jsxRuntime.jsx(
+      ui.Textarea,
+      {
+        ref: textareaRef,
+        dictate: true,
+        value: localValue,
+        onChange: (e) => handleChange(e.target.value),
+        onBlur: () => {
+          flushPendingChange();
+          setIsEditing(false);
+        },
+        onMouseUp: () => {
+          if (textareaRef.current && onHeightChange) {
+            onHeightChange(textareaRef.current.offsetHeight);
+          }
+        },
+        placeholder,
+        readOnly,
+        rows: 2,
+        "data-testid": dataTestId,
+        autoFocus: true,
+        style: defaultHeight ? { height: defaultHeight } : void 0,
+        className: "w-full text-sm p-2 pr-14 border border-border rounded-md resize-y bg-background focus:outline-none focus:ring-2 focus:ring-ring"
+      }
+    ) : /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        onClick: () => !readOnly && setIsEditing(true),
+        style: defaultHeight ? { minHeight: defaultHeight } : void 0,
+        "data-testid": dataTestId,
+        className: ui.cn(
+          "w-full text-sm p-2 pr-14 border border-border rounded-md min-h-[4rem] whitespace-pre-wrap bg-background",
+          !readOnly && "cursor-text hover:border-ring",
+          !localValue && "text-muted-foreground"
+        ),
+        children: renderedContent || placeholder
+      }
+    ) }),
+    (hasCitations || !readOnly) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-1", children: [
+      docIds.map((docId) => {
+        const doc = citedDocs?.[docId];
+        const group = byDoc.get(docId);
+        const pages = (group?.pages ?? []).slice().sort((a, b) => a - b);
+        return /* @__PURE__ */ jsxRuntime.jsxs(
+          "div",
+          {
+            className: "flex items-center gap-1.5 text-sm",
+            "data-testid": `citation-doc-${docId}`,
+            children: [
+              doc ? /* @__PURE__ */ jsxRuntime.jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => !readOnly && onCiteDocument?.(docId),
+                  className: "flex-1 min-w-0 text-left",
+                  title: "Open to tag more passages",
+                  children: /* @__PURE__ */ jsxRuntime.jsx(ui.DocumentEntity, { doc, fullWidth: true, labelMaxWidth: "max-w-full" })
+                }
+              ) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-muted-foreground", children: docId }),
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-muted-foreground shrink-0", children: chunkKDG6FER6_cjs.formatPageRefs(pages) }),
+              !readOnly && /* @__PURE__ */ jsxRuntime.jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => handleRemoveDocument(docId),
+                  "aria-label": "Remove this document",
+                  className: "p-0.5 hover:bg-destructive/20 hover:text-destructive rounded shrink-0",
+                  children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.X, { size: 12 })
+                }
+              )
+            ]
+          },
+          docId
+        );
+      }),
+      !readOnly && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex items-center gap-1", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex-1 min-w-0", "data-testid": "citation-document-picker", children: renderDocumentPicker?.(handleToggleDocument, docIds) }) })
+    ] }),
+    activeCitationKey && /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "text-sm text-blue-text", children: [
+      "Click a passage in the document to add it \u2014 ",
+      /* @__PURE__ */ jsxRuntime.jsx("strong", { children: "shift-click" }),
+      " to take a whole range. Add as many as you like, from as many documents as you like."
+    ] })
+  ] });
+}
+
+exports.CitationEditor = CitationEditor;
+//# sourceMappingURL=chunk-C7PTF6BQ.cjs.map
+//# sourceMappingURL=chunk-C7PTF6BQ.cjs.map

package/dist/chunk-C7PTF6BQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/citations/CitationEditor.tsx"],"names":["useState","useRef","useEffect","useMemo","useCallback","jsx","cn","Textarea","jsxs","DocumentEntity","formatPageRefs","X"],"mappings":"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","file":"chunk-C7PTF6BQ.cjs","sourcesContent":["/**\n * CitationEditor Component\n *\n * Note input plus the source passages backing it.\n * - Pick related documents; each opens so its passages can be chosen by reading\n * - Click a passage to add it, shift-click for a range; repeat across documents\n *\n * A note answers ONE question, so it has ONE set of sources. It used to carry a\n * map of citations, each with its own statement and character offsets, rendered\n * as inline highlighted spans with [n] badges — but the statements were copies\n * of the note text and the offsets spanned all of it, so the highlight was the\n * whole field. That machinery is gone; the note renders as plain text.\n *\n * ``activeCitationKey``/``onActiveCitationChange`` are kept because the viewer\n * and store thread them through to decide which field is receiving passages.\n * With a single citation the key is just a sentinel — see ONLY_CITATION_KEY.\n */\n\nimport { useCallback, useState, useRef, useEffect, useMemo } from 'react'\nimport { X } from 'lucide-react'\nimport { cn, DocumentEntity, Textarea, type DocumentLike } from '@arbidocs/react/ui'\nimport { formatPageRefs } from '../lib/format'\n\nimport type { components } from '@arbidocs/client'\n\ntype CitationSources = components['schemas']['CitationSources']\n\ntype Citations = CitationSources | null\n\nexport interface CitationEditorProps {\n  value: string\n  citations: Citations | null\n  onChange: (note: string, citations: Citations | null) => void\n  /** Currently active citation key (controlled from parent) */\n  activeCitationKey?: string | null\n  /**\n   * Open a document in the viewer, armed to collect passages for this field —\n   * and tag its first passage, so a chosen document is immediately a usable\n   * citation. Passages are picked by reading, so citing means opening.\n   *\n   * The caller owns this because resolving \"first passage\" needs the parsed\n   * document, and keeping that fetch out here is what lets this component stay\n   * store- and API-free (and therefore hoistable to @arbidocs/blocks).\n   */\n  onCiteDocument?: (docExtId: string) => void\n  /** Cited documents, already resolved by the caller — keyed by external id. */\n  citedDocs?: Record<string, DocumentLike>\n  /**\n   * The app's document picker, injected as a slot. It is store-coupled, so it\n   * is passed in rather than imported, and receives the chosen document id.\n   */\n  renderDocumentPicker?: (\n    onSelect: (docExtId: string) => void,\n    selectedIds: string[]\n  ) => React.ReactNode\n  placeholder?: string\n  readOnly?: boolean\n  className?: string\n  /** Start in edit mode with the caret in the field (composer behaviour). */\n  autoFocus?: boolean\n  /** Applied to the text field itself, so callers can target it directly. */\n  'data-testid'?: string\n  /** Persisted textarea height in pixels */\n  defaultHeight?: number\n  /** Called after user resizes the textarea */\n  onHeightChange?: (height: number) => void\n}\n\nexport function CitationEditor({\n  value,\n  citations,\n  onChange,\n  activeCitationKey,\n  onCiteDocument,\n  citedDocs,\n  renderDocumentPicker,\n  autoFocus = false,\n  'data-testid': dataTestId,\n  placeholder = 'Add a note...',\n  readOnly = false,\n  className,\n  defaultHeight,\n  onHeightChange,\n}: CitationEditorProps) {\n  const [localValue, setLocalValue] = useState(value)\n  const [isEditing, setIsEditing] = useState(autoFocus)\n  const textareaRef = useRef<HTMLTextAreaElement>(null)\n  const debounceRef = useRef<ReturnType<typeof setTimeout> | null>(null)\n\n  // Sync from parent only when not editing\n  useEffect(() => {\n    if (!isEditing) {\n      setLocalValue(value)\n    }\n  }, [value, isEditing])\n\n  const sources = useMemo(() => citations ?? [], [citations])\n  const hasCitations = sources.length > 0\n\n  // A citation is doc-first: each entry is a document with the pages cited\n  // from it (none = the whole document).\n  const byDoc = useMemo(() => {\n    const groups = new Map<string, { pages: number[]; count: number }>()\n    for (const doc of sources) {\n      const chunks = doc.chunks ?? []\n      const pages: number[] = []\n      for (const c of chunks) if (c.page != null && !pages.includes(c.page)) pages.push(c.page)\n      groups.set(doc.doc_ext_id, { pages, count: chunks.length })\n    }\n    return groups\n  }, [sources])\n\n  const docIds = Array.from(byDoc.keys())\n\n  const handleRemoveDocument = useCallback(\n    (docExtId: string) => {\n      const remaining = sources.filter((d) => d.doc_ext_id !== docExtId)\n      onChange(localValue, remaining.length ? remaining : null)\n    },\n    [sources, localValue, onChange]\n  )\n\n  const handleToggleDocument = useCallback(\n    (docExtId: string) => {\n      if (!docExtId) return\n      // Selecting one already in the list removes it (and its passages) — the\n      // tick in the picker has to mean something you can undo from there.\n      if (docIds.includes(docExtId)) {\n        handleRemoveDocument(docExtId)\n        return\n      }\n      onCiteDocument?.(docExtId)\n    },\n    [docIds, onCiteDocument, handleRemoveDocument]\n  )\n\n  // The note is plain text. Nothing to slice: with one citation per note there\n  // are no per-statement spans to highlight.\n  const renderedContent = useMemo(\n    () => (localValue ? <span>{localValue}</span> : null),\n    [localValue]\n  )\n\n  // Debounced text change. Editing the note no longer has to re-anchor\n  // anything — the sources are attached to the note as a whole.\n  const handleChange = useCallback(\n    (newValue: string) => {\n      setLocalValue(newValue)\n      if (debounceRef.current) clearTimeout(debounceRef.current)\n      debounceRef.current = setTimeout(() => onChange(newValue, citations ?? null), 400)\n    },\n    [citations, onChange]\n  )\n\n  /**\n   * Publish any debounced edit immediately.\n   *\n   * Without this, typing and then clicking Save within the debounce window\n   * silently drops the last keystrokes: the parent still holds the previous\n   * value when it reads state to submit.\n   */\n  const flushPendingChange = useCallback(() => {\n    if (!debounceRef.current) return\n    clearTimeout(debounceRef.current)\n    debounceRef.current = null\n    onChange(localValue, citations ?? null)\n  }, [localValue, citations, onChange])\n\n  return (\n    <div className={cn('space-y-1', className)}>\n      {/* Text area with highlighted citations preview when not editing */}\n      <div className=\"relative\">\n        {isEditing ? (\n          <Textarea\n            ref={textareaRef}\n            dictate\n            value={localValue}\n            onChange={(e) => handleChange(e.target.value)}\n            onBlur={() => {\n              flushPendingChange()\n              setIsEditing(false)\n            }}\n            onMouseUp={() => {\n              if (textareaRef.current && onHeightChange) {\n                onHeightChange(textareaRef.current.offsetHeight)\n              }\n            }}\n            placeholder={placeholder}\n            readOnly={readOnly}\n            rows={2}\n            data-testid={dataTestId}\n            autoFocus\n            style={defaultHeight ? { height: defaultHeight } : undefined}\n            className=\"w-full text-sm p-2 pr-14 border border-border rounded-md resize-y bg-background focus:outline-none focus:ring-2 focus:ring-ring\"\n          />\n        ) : (\n          <div\n            onClick={() => !readOnly && setIsEditing(true)}\n            style={defaultHeight ? { minHeight: defaultHeight } : undefined}\n            data-testid={dataTestId}\n            className={cn(\n              'w-full text-sm p-2 pr-14 border border-border rounded-md min-h-[4rem] whitespace-pre-wrap bg-background',\n              !readOnly && 'cursor-text hover:border-ring',\n              !localValue && 'text-muted-foreground'\n            )}\n          >\n            {renderedContent || placeholder}\n          </div>\n        )}\n      </div>\n\n      {/* Sources — one row per cited document, each showing how many passages\n          were tagged in it. Clicking a document reopens it in the viewer so more\n          passages can be tagged; the passages themselves are chosen by reading,\n          which is why citing is inseparable from opening. */}\n      {(hasCitations || !readOnly) && (\n        <div className=\"flex flex-col gap-1\">\n          {docIds.map((docId) => {\n            const doc = citedDocs?.[docId]\n            const group = byDoc.get(docId)\n            const pages = (group?.pages ?? []).slice().sort((a, b) => a - b)\n            return (\n              <div\n                key={docId}\n                className=\"flex items-center gap-1.5 text-sm\"\n                data-testid={`citation-doc-${docId}`}\n              >\n                {doc ? (\n                  <button\n                    type=\"button\"\n                    onClick={() => !readOnly && onCiteDocument?.(docId)}\n                    // flex-1 so the title gets the row's spare width — the count\n                    // and remove control are shrink-0 and sit at the end.\n                    className=\"flex-1 min-w-0 text-left\"\n                    title=\"Open to tag more passages\"\n                  >\n                    <DocumentEntity doc={doc} fullWidth labelMaxWidth=\"max-w-full\" />\n                  </button>\n                ) : (\n                  <span className=\"text-muted-foreground\">{docId}</span>\n                )}\n                <span className=\"text-muted-foreground shrink-0\">{formatPageRefs(pages)}</span>\n                {!readOnly && (\n                  <button\n                    type=\"button\"\n                    onClick={() => handleRemoveDocument(docId)}\n                    aria-label=\"Remove this document\"\n                    className=\"p-0.5 hover:bg-destructive/20 hover:text-destructive rounded shrink-0\"\n                  >\n                    <X size={12} />\n                  </button>\n                )}\n              </div>\n            )\n          })}\n\n          {!readOnly && (\n            <div className=\"flex items-center gap-1\">\n              {/* The picker is rendered inline rather than behind a button: adding\n                  a source is the primary action here, and hiding it behind\n                  \"+ Document\" cost a click for no benefit. Once a document is\n                  cited, this row becomes \"add another\". */}\n              <div className=\"flex-1 min-w-0\" data-testid=\"citation-document-picker\">\n                {renderDocumentPicker?.(handleToggleDocument, docIds)}\n              </div>\n            </div>\n          )}\n        </div>\n      )}\n\n      {/* Hint when citation is active */}\n      {activeCitationKey && (\n        <p className=\"text-sm text-blue-text\">\n          Click a passage in the document to add it — <strong>shift-click</strong> to take a whole\n          range. Add as many as you like, from as many documents as you like.\n        </p>\n      )}\n    </div>\n  )\n}\n"]}

package/dist/{chunk-T5B7FM7S.js → chunk-COA3S3CZ.js}

@@ -1,8 +1,8 @@
 "use client";
 import { FoldSection, QuickActionDialogHeader, AddFilesFirst, StartTiles, ScopePicker } from './chunk-IXWJGOM2.js';
-import { useControllableState } from './chunk-RLWIUUQ5.js';
 import { DocumentPicker, TriStateFilterMenu } from './chunk-KSHKTOY2.js';
 import { EmptyState } from './chunk-P6GHJSLR.js';
+import { useControllableState } from './chunk-RLWIUUQ5.js';
 import { SelectionBar, SelectionBarAction } from './chunk-NUNKSZKU.js';
 import { FilterInput } from './chunk-YU2KUMGE.js';
 import { GridView } from './chunk-N5YEF3LC.js';
@@ -1598,5 +1598,5 @@ function WorkflowsTable(props) {
 var GRID_OPTIONS = { suppressClickEdit: true };
 
 export { AgentSelect, DEFAULT_AGENT_SELECT_LABELS, DEFAULT_SCHEMA_FORM_LABELS, DEFAULT_TASK_TRIGGER_CHIP_LABELS, DEFAULT_WORKFLOW_CONFIG_DIALOG_LABELS, DEFAULT_WORKFLOW_DOCUMENTS_FIELD_LABELS, DEFAULT_WORKFLOW_LIST_LABELS, PersonPill, SchemaForm, TaskTriggerChip, WORKFLOW_COLUMN_ORDER, WorkflowConfigDialog, WorkflowDocumentsField, WorkflowLauncher, WorkflowsTable, buildWorkflowScopeSource, createWorkflowColumns, documentScopeLabels, hasTrigger, isSkillRow, matchWorkflowScope, workflowRunStatusLabel, workflowStatus, workflowTriggerType };
-//# sourceMappingURL=chunk-T5B7FM7S.js.map
-//# sourceMappingURL=chunk-T5B7FM7S.js.map
+//# sourceMappingURL=chunk-COA3S3CZ.js.map
+//# sourceMappingURL=chunk-COA3S3CZ.js.map