@arbidocs/blocks 0.5.106 → 0.5.107

package/dist/chunk-ZMVF7EYJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboards/chartModel.ts"],"names":["divisor"],"mappings":"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","file":"chunk-ZMVF7EYJ.cjs","sourcesContent":["/**\n * The renderer adapter's first half: a `ChartSpec` and its aggregated `Dataset` (long form: a row\n * per group and series) become a `ChartModel`, the categories and series a drawing component plots.\n * Nothing here knows the drawing library, so it can change without touching specs or sources.\n */\nimport type {\n  AGGREGATE_FIELDS,\n  ChartSpec,\n  Dataset,\n  DatasetField,\n  DatasetValue,\n  TimeBucket,\n} from '@arbidocs/react'\n\n/** The aggregated dataset's field ids (`@arbidocs/react`'s `AGGREGATE_FIELDS`, checked). */\nconst F = {\n  group: 'group',\n  key: 'key',\n  series: 'series',\n  value: 'value',\n} as const satisfies typeof AGGREGATE_FIELDS\n\n/** The drawing types (a metric and a table are not drawn). */\nexport type DrawnChartType = 'bar' | 'line' | 'area' | 'pie' | 'donut'\n\nexport interface ChartModelSeries {\n  id: string\n  label: string\n  /** One per category; `null` where the group has no value. */\n  values: (number | null)[]\n  /** The series' colour as a CSS value (a theme token). */\n  color: string\n}\n\n/** What a chart plots, library-free. */\nexport interface ChartModel {\n  type: DrawnChartType\n  stacked: boolean\n  /** Category labels, in order (x axis, or pie slices). */\n  categories: string[]\n  series: ChartModelSeries[]\n  /** The x axis's name (the grouped field). */\n  xLabel: string\n  /** The value's name (\"count\", \"sum of Fee\"). */\n  valueLabel: string\n  /** Formats a value for ticks, the tooltip and the table. */\n  format: (value: number) => string\n  /** Short form of `format` for axis ticks. */\n  formatTick: (value: number) => string\n}\n\n/** Formats by unit (`gbp`, `bytes`, `tokens`, …); a host passes its own (the SDK's £ formatter). */\nexport type UnitFormatters = Readonly<Record<string, (value: number) => string>>\n\n/** The theme's series colours, then a muted \"Other\". */\nexport const SERIES_COLORS = [1, 2, 3, 4, 5].map((i) => `hsl(var(--chart-${i}))`)\nexport const OTHER_COLOR = 'hsl(var(--muted-foreground))'\n\nconst MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']\n\n/** A date bucket key as people read it: \"12 Jun 2026\", \"W24 2026\", \"Jun 2026\", \"Q2 2026\", \"2026\". */\nexport function formatBucketLabel(key: string, bucket: TimeBucket = 'month'): string {\n  let m: RegExpMatchArray | null\n  if (bucket === 'day' && (m = key.match(/^(\\d{4})-(\\d{2})-(\\d{2})$/)))\n    return `${Number(m[3])} ${MONTHS[Number(m[2]) - 1]} ${m[1]}`\n  if (bucket === 'week' && (m = key.match(/^(\\d{4})-W(\\d{2})$/))) return `W${Number(m[2])} ${m[1]}`\n  if (bucket === 'month' && (m = key.match(/^(\\d{4})-(\\d{2})$/)))\n    return `${MONTHS[Number(m[2]) - 1]} ${m[1]}`\n  if (bucket === 'quarter' && (m = key.match(/^(\\d{4})-Q(\\d)$/))) return `Q${m[2]} ${m[1]}`\n  return key\n}\n\nconst plain = new Intl.NumberFormat('en-GB', { maximumFractionDigits: 2 })\nconst oneDecimal = new Intl.NumberFormat('en-GB', { maximumFractionDigits: 1 })\nconst COMPACT_UNITS: readonly [number, string][] = [\n  [1e12, 'T'],\n  [1e9, 'B'],\n  [1e6, 'M'],\n  [1e3, 'K'],\n]\n\n/**\n * A number in fixed suffixes (950, 1.2K, 1.5M, 3B), the same in every browser and runtime:\n * `Intl`'s compact notation follows the ICU data, which writes \"1.5m\" in some versions.\n */\nfunction formatCompact(value: number): string {\n  const size = Math.abs(value)\n  const at = COMPACT_UNITS.findIndex(([divisor]) => size >= divisor)\n  if (at === -1) return oneDecimal.format(value)\n  // 999,950 rounds to \"1000K\": the next suffix up reads it.\n  const [divisor, suffix] =\n    at > 0 && Math.round((size / COMPACT_UNITS[at][0]) * 10) / 10 >= 1000\n      ? COMPACT_UNITS[at - 1]\n      : COMPACT_UNITS[at]\n  return `${oneDecimal.format(value / divisor)}${suffix}`\n}\n\n/** The default formatters: £ with pence, bytes in KB/MB/GB, tokens compact. */\nexport const DEFAULT_UNIT_FORMATTERS: UnitFormatters = {\n  gbp: (v) =>\n    `${v < 0 ? '-' : ''}£${Math.abs(v).toLocaleString('en-GB', {\n      minimumFractionDigits: Number.isInteger(v) ? 0 : 2,\n      maximumFractionDigits: 2,\n    })}`,\n  bytes: (v) =>\n    v < 1024\n      ? `${v} B`\n      : v < 1024 ** 2\n        ? `${(v / 1024).toFixed(1)} KB`\n        : v < 1024 ** 3\n          ? `${(v / 1024 ** 2).toFixed(1)} MB`\n          : `${(v / 1024 ** 3).toFixed(1)} GB`,\n  tokens: formatCompact,\n}\n\n/** The formatter of a value field: by its unit, a suffix for any other unit, else a number. */\nexport function formatterOf(\n  field: Pick<DatasetField, 'unit'> | undefined,\n  formatters: UnitFormatters = DEFAULT_UNIT_FORMATTERS\n): (value: number) => string {\n  const unit = field?.unit\n  if (!unit) return (v) => plain.format(v)\n  const known = formatters[unit] ?? DEFAULT_UNIT_FORMATTERS[unit]\n  return known ?? ((v) => `${plain.format(v)} ${unit}`)\n}\n\n/** The most series (or pie slices) drawn in their own colour; the rest fold into \"Other\". */\nexport const MAX_COLORED = SERIES_COLORS.length\n\nconst additive = (spec: ChartSpec) =>\n  (spec.aggregate ?? 'count') === 'count' || spec.aggregate === 'sum'\n\nconst num = (v: DatasetValue | undefined) => (typeof v === 'number' ? v : null)\n\nexport interface ChartModelOptions {\n  /** The source's fields, for the x axis's name. */\n  fields?: readonly DatasetField[]\n  formatters?: UnitFormatters\n  /** The words for the folded series and slices. Default \"Other\". */\n  otherLabel?: string\n}\n\n/**\n * Turn an aggregated dataset into what a chart plots. Series (and pie slices) beyond the theme's\n * colours fold into \"Other\" when the values add up (count, sum); otherwise the smallest are left out.\n */\nexport function chartModelOf(\n  spec: ChartSpec & { type: DrawnChartType },\n  dataset: Dataset,\n  options: ChartModelOptions = {}\n): ChartModel {\n  const other = options.otherLabel ?? 'Other'\n  const valueField = dataset.fields.find((f) => f.id === F.value)\n  const xField = options.fields?.find((f) => f.id === spec.x)\n  const isDate = xField?.type === 'date'\n  const keys: string[] = []\n  const labels = new Map<string, string>()\n  const seriesIds: string[] = []\n  const cells = new Map<string, number | null>()\n  for (const row of dataset.rows) {\n    const key = String(row[F.key] ?? row[F.group] ?? '')\n    if (!labels.has(key)) {\n      keys.push(key)\n      const label = String(row[F.group] ?? key)\n      labels.set(key, isDate && key ? formatBucketLabel(key, spec.bucket) : label)\n    }\n    const s = row[F.series] === undefined ? '' : String(row[F.series])\n    if (!seriesIds.includes(s)) seriesIds.push(s)\n    cells.set(`${key}\\u0000${s}`, num(row[F.value]))\n  }\n  const valueLabel = valueField?.label ?? 'value'\n  let series = seriesIds.map((s) => ({\n    id: s || F.value,\n    label: s || valueLabel,\n    values: keys.map((k) => cells.get(`${k}\\u0000${s}`) ?? null),\n  }))\n  let categories = keys.map((k) => labels.get(k) ?? k)\n  const sum = (values: (number | null)[]) => values.reduce<number>((a, v) => a + (v ?? 0), 0)\n\n  if (spec.type === 'pie' || spec.type === 'donut') {\n    const values = series[0]?.values ?? []\n    if (categories.length > MAX_COLORED) {\n      const order = values.map((_, i) => i).sort((a, b) => (values[b] ?? 0) - (values[a] ?? 0))\n      const kept = order.slice(0, MAX_COLORED - 1)\n      const rest = order.slice(MAX_COLORED - 1)\n      categories = [...kept.map((i) => categories[i]), ...(additive(spec) ? [other] : [])]\n      const keptValues = kept.map((i) => values[i])\n      series = [\n        {\n          ...series[0],\n          values: additive(spec) ? [...keptValues, sum(rest.map((i) => values[i]))] : keptValues,\n        },\n      ]\n    }\n  } else if (series.length > MAX_COLORED) {\n    const order = [...series].sort((a, b) => sum(b.values) - sum(a.values))\n    const kept = order.slice(0, MAX_COLORED - 1)\n    const rest = order.slice(MAX_COLORED - 1)\n    series = [\n      ...series.filter((s) => kept.includes(s)),\n      ...(additive(spec)\n        ? [\n            {\n              id: '__other',\n              label: other,\n              values: keys.map((_, i) =>\n                rest.some((s) => s.values[i] !== null) ? sum(rest.map((s) => s.values[i])) : null\n              ),\n            },\n          ]\n        : []),\n    ]\n  }\n\n  const format = formatterOf(valueField, options.formatters)\n  return {\n    type: spec.type,\n    stacked: Boolean(spec.stacked) && (spec.type === 'bar' || spec.type === 'area'),\n    categories,\n    series: series.map((s, i) => ({\n      ...s,\n      color: s.id === '__other' ? OTHER_COLOR : SERIES_COLORS[i % SERIES_COLORS.length],\n    })),\n    xLabel: xField?.label ?? '',\n    valueLabel,\n    format,\n    formatTick: valueField?.unit === 'gbp' || valueField?.unit === 'bytes' ? format : formatCompact,\n  }\n}\n\n/** The pie slice colours (one per category; \"Other\" muted). */\nexport function sliceColors(model: Pick<ChartModel, 'categories'>, otherLabel = 'Other') {\n  return model.categories.map((c, i) =>\n    c === otherLabel && i === model.categories.length - 1 && i >= MAX_COLORED - 1\n      ? OTHER_COLOR\n      : SERIES_COLORS[i % SERIES_COLORS.length]\n  )\n}\n\n/** The single value of a metric (an aggregated dataset with one group), or null. */\nexport function metricValueOf(dataset: Dataset | undefined): number | null {\n  if (!dataset?.rows.length) return null\n  return dataset.rows.reduce<number | null>((total, row) => {\n    const v = num(row[F.value])\n    return v === null ? total : (total ?? 0) + v\n  }, null)\n}\n"]}

package/dist/{chunk-CEVVGJQX.js → chunk-ZNY5W3VX.js}

@@ -1,15 +1,17 @@
 "use client";
 import { page, minuteUtc, cell, paragraph, documentXml, docxPackage, TABLE_DOCUMENT_STYLES, groupDefinitions, compareDefinitions } from './chunk-IYUKJESY.js';
+import { guidedCursor, useMountedSurface } from './chunk-NFK2SEUD.js';
 import { RowNavigatorControls } from './chunk-ELA7Y5YW.js';
 import { DetailLoading, DetailBody, DetailSection, DetailLinkList, DetailLinkItem, DetailEmpty, DetailFields, DetailField } from './chunk-OC2PD52M.js';
 import { taskActivityHeadline, DEFAULT_TASK_ACTIVITY_LABELS } from './chunk-HTGEAQOA.js';
 import { GridView } from './chunk-IU5CHOEU.js';
 import { DocumentPicker } from './chunk-WNDIVNPT.js';
 import { ModalHeader } from './chunk-TX2ZICS7.js';
-import { useState, useEffect, useMemo, useCallback, useRef } from 'react';
+import { useState, useEffect, useMemo, useSyncExternalStore, useRef, useCallback } from 'react';
+import { createPortal } from 'react-dom';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { Sparkle, Search, Pencil, ArrowUp, ArrowDown, X, Plus, Loader2, ArrowUpRight, ChevronDown, MoreHorizontal, SlidersHorizontal, FileDown, Download, FileText, Lightbulb, MessagesSquare, Workflow, MessageSquare, Activity } from 'lucide-react';
 import { cn, Input, Textarea, Button, Checkbox, TagEntity, Popover, PopoverTrigger, PopoverContent, getEntityLabel, tagKindNouns, tagKindTitle, isImageDocument, getDocumentTitle, Dialog, DialogContent, DialogTitle, DialogDescription } from '@arbidocs/react/ui';
-import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { assistantCopy, useAssistantCopy } from '@arbidocs/react/shell';
 
 function useTipsPlacement({
@@ -51,6 +53,157 @@ function useTipsPlacement({
     onHoverChange: setPaused
   };
 }
+
+// src/guided/cursor-visuals.json
+var cursor_visuals_default = {
+  color: "#22d3ee",
+  glowColor: "rgba(34,211,238,.85)",
+  glowColorFlash: "rgba(103,232,249,.95)",
+  fillColor: "rgba(34,211,238,.25)",
+  size: 24,
+  borderWidth: 2,
+  mark: {
+    width: 30
+  },
+  ripple: {
+    durationMs: 600,
+    easing: "ease-out",
+    startScale: 0.5,
+    endScale: 3,
+    startOpacity: 0.85,
+    endOpacity: 0
+  },
+  squish: {
+    downMs: 80,
+    upMs: 220,
+    scale: 0.6,
+    downEasing: "ease-in",
+    upEasing: "cubic-bezier(0.34, 1.56, 0.64, 1)"
+  },
+  glowFlash: {
+    durationMs: 300,
+    baseBlur: 12,
+    flashBlur: 24,
+    easing: "ease-out"
+  }
+};
+var RING_STYLE = {
+  position: "fixed",
+  width: cursor_visuals_default.size,
+  height: cursor_visuals_default.size,
+  border: `${cursor_visuals_default.borderWidth}px solid ${cursor_visuals_default.color}`,
+  borderRadius: "50%",
+  pointerEvents: "none"
+};
+var glowFilter = (blur, color) => `drop-shadow(0 0 ${blur}px ${color})`;
+function RippleDot({ x, y }) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: { ...RING_STYLE, left: x, top: y, transform: "translate(-50%, -50%)" },
+      ref: (el) => {
+        const { ripple } = cursor_visuals_default;
+        el?.animate(
+          [
+            {
+              opacity: ripple.startOpacity,
+              transform: `translate(-50%,-50%) scale(${ripple.startScale})`
+            },
+            {
+              opacity: ripple.endOpacity,
+              transform: `translate(-50%,-50%) scale(${ripple.endScale})`
+            }
+          ],
+          { duration: ripple.durationMs, easing: ripple.easing }
+        );
+      }
+    }
+  );
+}
+function playClickFeedback(mark) {
+  const { squish, glowFlash, glowColor, glowColorFlash } = cursor_visuals_default;
+  const downFrac = squish.downMs / (squish.downMs + squish.upMs);
+  mark.animate(
+    [
+      // Per-keyframe easing, not a single easing over the whole timeline: the
+      // spring/back curve on the release overshoots past 1 — applied globally
+      // that overshoot gets clamped and re-entered as eased time crosses the
+      // downFrac boundary, producing a visible double-bounce right at the end.
+      { transform: "translate(-50%,-50%) scale(1)", offset: 0, easing: squish.downEasing },
+      {
+        transform: `translate(-50%,-50%) scale(${squish.scale})`,
+        offset: downFrac,
+        easing: squish.upEasing
+      },
+      { transform: "translate(-50%,-50%) scale(1)", offset: 1 }
+    ],
+    { duration: squish.downMs + squish.upMs }
+  );
+  mark.animate(
+    [
+      { filter: glowFilter(glowFlash.baseBlur, glowColor) },
+      { filter: glowFilter(glowFlash.flashBlur, glowColorFlash), offset: 0.3 },
+      { filter: glowFilter(glowFlash.baseBlur, glowColor) }
+    ],
+    { duration: glowFlash.durationMs, easing: glowFlash.easing }
+  );
+}
+function GuidedCursor({ markSrc }) {
+  const snap = useSyncExternalStore(
+    guidedCursor.subscribe,
+    guidedCursor.getSnapshot,
+    guidedCursor.getSnapshot
+  );
+  const [ripples, setRipples] = useState([]);
+  const markRef = useRef(null);
+  useMountedSurface("cursor");
+  useEffect(() => {
+    let seq = 0;
+    return guidedCursor.onRipple((x, y) => {
+      const id = ++seq;
+      setRipples((rs) => [...rs, { id, x, y }]);
+      setTimeout(() => setRipples((rs) => rs.filter((r) => r.id !== id)), 650);
+      if (!guidedCursor.prefersReducedMotion() && markRef.current) {
+        playClickFeedback(markRef.current);
+      }
+    });
+  }, []);
+  if (typeof document === "undefined") return null;
+  if (!snap.visible && ripples.length === 0) return null;
+  const reduced = guidedCursor.prefersReducedMotion();
+  const markStyle = {
+    position: "fixed",
+    left: snap.x,
+    top: snap.y,
+    transform: "translate(-50%, -50%)",
+    pointerEvents: "none",
+    filter: glowFilter(cursor_visuals_default.glowFlash.baseBlur, cursor_visuals_default.glowColor),
+    transition: reduced ? "none" : `left ${guidedCursor.glideMs}ms cubic-bezier(0.22, 1, 0.36, 1), top ${guidedCursor.glideMs}ms cubic-bezier(0.22, 1, 0.36, 1)`
+  };
+  return createPortal(
+    /* @__PURE__ */ jsxs("div", { "aria-hidden": true, className: "pointer-events-none fixed inset-0 z-[2147483647]", children: [
+      snap.visible && (markSrc ? /* @__PURE__ */ jsx(
+        "img",
+        {
+          ref: markRef,
+          "data-testid": "guided-cursor",
+          src: markSrc,
+          alt: "",
+          style: { ...markStyle, width: cursor_visuals_default.mark.width, height: "auto" }
+        }
+      ) : /* @__PURE__ */ jsx(
+        "div",
+        {
+          ref: markRef,
+          "data-testid": "guided-cursor",
+          style: { ...RING_STYLE, ...markStyle, background: cursor_visuals_default.fillColor }
+        }
+      )),
+      ripples.map((r) => /* @__PURE__ */ jsx(RippleDot, { x: r.x, y: r.y }, r.id))
+    ] }),
+    document.body
+  );
+}
 var SPARKLE_DELAYS = ["0s", "0.1s", "0.2s"];
 var SPLASH_CLASS = "fixed top-0 left-0 w-full h-full flex flex-col items-center justify-center bg-background bg-opacity-50 z-50";
 function useShowAfter(delayMs) {
@@ -339,16 +492,16 @@ function workspaceActivityTarget(item) {
 var quoted = (name, fallback) => name ? `\u201C${name}\u201D` : fallback;
 function workspaceActivityHeadline(item) {
   const thread = quoted(item.conversation_title, "a thread");
-  const document = quoted(item.document_name, "a document");
+  const document2 = quoted(item.document_name, "a document");
   switch (item.kind) {
     case "message_posted":
       return `Posted in ${thread}`;
     case "document_uploaded":
-      return `Uploaded ${document}`;
+      return `Uploaded ${document2}`;
     case "document_version":
-      return item.version ? `Saved version ${item.version} of ${document}` : `Saved a new version of ${document}`;
+      return item.version ? `Saved version ${item.version} of ${document2}` : `Saved a new version of ${document2}`;
     case "document_signed":
-      return `Signed ${document}`;
+      return `Signed ${document2}`;
     case "workflow_run": {
       const run = `Ran ${quoted(item.workflow_name, "a workflow")}`;
       return item.status ? `${run} (${item.status.replace(/_/g, " ")})` : run;
@@ -1896,6 +2049,6 @@ function ExtractEntitiesDialog({
   ) });
 }
 
-export { DEFAULT_GLOSSARY_LABELS, DEFAULT_TAG_COLUMNS_EDITOR_LABELS, DEFAULT_TAG_DETAIL_LABELS, DEFAULT_TAG_TABLE_DOCX_LABELS, DEFAULT_TAG_TABLE_LABELS, DEFAULT_WORKSPACE_ACTIVITY_LABELS, EXTRACT_LIMIT, EntityIdentityBar, ExtractEntitiesDialog, GridRowNavigator, IDENTITY_NAME_MAX_LENGTH, LoadingIndicator, TAG_TABLE_DOCX_LANDSCAPE_AFTER, TagColumnsEditor, TagDetail, TagTable, TagTableCell, Toolbar, WorkspaceActivityList, cellText, cellValue, documentCount, entitiesPhrase, fieldWrites, glossaryDocumentXml, glossaryDocx, glossaryEntries, glossaryFileName, glossaryMarkdown, isGap, parseCell, rowLinks, tagDetailLabels, tagKindDescription, tagNoteLabel, tagTableDocumentXml, tagTableDocx, tagTableLabels, tagTableMarkdown, tagsPageNouns, useTipsPlacement, workspaceActivityHeadline, workspaceActivityTarget };
-//# sourceMappingURL=chunk-CEVVGJQX.js.map
-//# sourceMappingURL=chunk-CEVVGJQX.js.map
+export { DEFAULT_GLOSSARY_LABELS, DEFAULT_TAG_COLUMNS_EDITOR_LABELS, DEFAULT_TAG_DETAIL_LABELS, DEFAULT_TAG_TABLE_DOCX_LABELS, DEFAULT_TAG_TABLE_LABELS, DEFAULT_WORKSPACE_ACTIVITY_LABELS, EXTRACT_LIMIT, EntityIdentityBar, ExtractEntitiesDialog, GridRowNavigator, GuidedCursor, IDENTITY_NAME_MAX_LENGTH, LoadingIndicator, TAG_TABLE_DOCX_LANDSCAPE_AFTER, TagColumnsEditor, TagDetail, TagTable, TagTableCell, Toolbar, WorkspaceActivityList, cellText, cellValue, documentCount, entitiesPhrase, fieldWrites, glossaryDocumentXml, glossaryDocx, glossaryEntries, glossaryFileName, glossaryMarkdown, isGap, parseCell, rowLinks, tagDetailLabels, tagKindDescription, tagNoteLabel, tagTableDocumentXml, tagTableDocx, tagTableLabels, tagTableMarkdown, tagsPageNouns, useTipsPlacement, workspaceActivityHeadline, workspaceActivityTarget };
+//# sourceMappingURL=chunk-ZNY5W3VX.js.map
+//# sourceMappingURL=chunk-ZNY5W3VX.js.map