@echothink-ui/documents 0.1.0

package/dist/index.cjs

@@ -0,0 +1,715 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.tsx
+var index_exports = {};
+__export(index_exports, {
+  AgentLockedDocumentPanel: () => AgentLockedDocumentPanel,
+  DocumentEditorShell: () => DocumentEditorShell,
+  DocumentLockBadge: () => DocumentLockBadge,
+  DocumentOutline: () => DocumentOutline,
+  DocumentToolbar: () => DocumentToolbar,
+  DocumentViewer: () => DocumentViewer,
+  DocumentWorkspaceTemplate: () => DocumentWorkspaceTemplate,
+  DocumentsComponentNames: () => DocumentsComponentNames
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/components/DocumentEditorShell.tsx
+var React = __toESM(require("react"), 1);
+var import_core2 = require("@echothink-ui/core");
+var import_icons3 = require("@echothink-ui/icons");
+
+// src/components/DocumentLockBadge.tsx
+var import_core = require("@echothink-ui/core");
+var import_icons2 = require("@echothink-ui/icons");
+
+// src/components/utils.tsx
+var import_icons = require("@echothink-ui/icons");
+var import_jsx_runtime = require("react/jsx-runtime");
+function cx(...classes) {
+  return classes.filter(Boolean).join(" ");
+}
+function documentRefLabel(documentRef) {
+  if (typeof documentRef === "string") return documentRef;
+  if (documentRef.label) return documentRef.label;
+  return documentRef.id;
+}
+function formatDateTime(value) {
+  if (!value) return "Unknown";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toLocaleString(void 0, {
+    dateStyle: "medium",
+    timeStyle: "short"
+  });
+}
+function modeLabel(mode) {
+  return mode.charAt(0).toUpperCase() + mode.slice(1);
+}
+function actionIcon(action) {
+  const key = `${action.id} ${action.label}`.toLowerCase();
+  if (key.includes("bold"))
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { className: "eth-doc-toolbar__format-symbol", "aria-hidden": true, children: "B" });
+  if (key.includes("italic"))
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("em", { className: "eth-doc-toolbar__format-symbol", "aria-hidden": true, children: "I" });
+  if (key.includes("underline"))
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "span",
+      {
+        className: "eth-doc-toolbar__format-symbol eth-doc-toolbar__format-symbol--underline",
+        "aria-hidden": true,
+        children: "U"
+      }
+    );
+  if (key.includes("strike"))
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "span",
+      {
+        className: "eth-doc-toolbar__format-symbol eth-doc-toolbar__format-symbol--strike",
+        "aria-hidden": true,
+        children: "S"
+      }
+    );
+  if (key.includes("code"))
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "eth-doc-toolbar__format-symbol", "aria-hidden": true, children: "<>" });
+  if (key.includes("download") || key.includes("export")) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.DownloadIcon, { size: 16 });
+  if (key.includes("share") || key.includes("open")) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.ExternalLinkIcon, { size: 16 });
+  if (key.includes("link") || action.href) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.ExternalLinkIcon, { size: 16 });
+  if (key.includes("search") || key.includes("find")) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.SearchIcon, { size: 16 });
+  if (key.includes("agent")) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.AgentRunningIcon, { size: 16 });
+  if (key.includes("approve") || key.includes("review")) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.ApprovalRequiredIcon, { size: 16 });
+  if (key.includes("status")) return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.StatusIcon, { size: 16 });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_icons.DocumentIcon, { size: 16 });
+}
+
+// src/components/DocumentLockBadge.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var lockConfig = {
+  unlocked: {
+    label: "Unlocked",
+    severity: "success",
+    tooltip: "This document is available for editing."
+  },
+  "locked-by-user": {
+    label: "Locked by you",
+    severity: "info",
+    tooltip: "You currently hold the document lock."
+  },
+  "locked-by-agent": {
+    label: "Agent lock",
+    severity: "warning",
+    tooltip: "An agent currently holds the document lock."
+  },
+  "locked-by-other": {
+    label: "Locked",
+    severity: "danger",
+    tooltip: "Another user currently holds the document lock."
+  }
+};
+function DocumentLockBadge({
+  lockState,
+  owner,
+  since,
+  density = "compact",
+  className,
+  ...props
+}) {
+  const config = lockConfig[lockState];
+  const Icon = lockState === "unlocked" ? import_icons2.UnlockIcon : import_icons2.LockIcon;
+  const visibleDetail = getVisibleDetail(lockState, owner, since);
+  const ownerText = owner ? ` Owner: ${owner.label}.` : "";
+  const sinceText = since ? ` Since: ${formatDateTime(since)}.` : "";
+  const tooltip = `${config.tooltip}${ownerText}${sinceText}`;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_core.Tooltip, { label: tooltip, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    "span",
+    {
+      ...props,
+      className: cx("eth-doc-lock-badge", `eth-doc-lock-badge--${density}`, className),
+      "aria-label": tooltip,
+      "data-lock-state": lockState,
+      "data-eth-component": "DocumentLockBadge",
+      children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        import_core.Badge,
+        {
+          severity: config.severity,
+          className: cx("eth-doc-lock-badge__tag", `eth-doc-lock-badge__tag--${lockState}`),
+          children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { className: "eth-doc-lock-badge__content", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Icon, { className: "eth-doc-lock-badge__icon", size: 12 }),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "eth-doc-lock-badge__label", children: config.label }),
+            visibleDetail ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "eth-doc-lock-badge__detail", children: visibleDetail }) : null
+          ] })
+        }
+      )
+    }
+  ) });
+}
+function getVisibleDetail(lockState, owner, since) {
+  const sinceLabel = since ? formatDateTime(since) : void 0;
+  if (lockState === "unlocked") return sinceLabel;
+  if (lockState === "locked-by-user") return sinceLabel;
+  return [owner?.label, sinceLabel].filter(Boolean).join(" / ") || void 0;
+}
+
+// src/components/DocumentEditorShell.tsx
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function DocumentEditorShell({
+  title,
+  documentRef,
+  mode = "edit",
+  lockState = "unlocked",
+  lockOwner,
+  toolbar,
+  outline,
+  inspector,
+  children,
+  density = "default",
+  className,
+  ...props
+}) {
+  const [outlineOpen, setOutlineOpen] = React.useState(Boolean(outline));
+  const hasOutline = Boolean(outline);
+  const hasInspector = Boolean(inspector);
+  const gridTemplateColumns = [
+    hasOutline && outlineOpen ? "minmax(180px, 260px)" : null,
+    "minmax(0, 1fr)",
+    hasInspector ? "minmax(220px, 320px)" : null
+  ].filter(Boolean).join(" ");
+  const gridStyle = {
+    "--eth-doc-editor-shell-grid-template": gridTemplateColumns
+  };
+  const ethComponent = props["data-eth-component"] ?? "DocumentEditorShell";
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+    "section",
+    {
+      ...props,
+      className: cx(
+        "eth-doc-editor-shell",
+        `eth-doc-editor-shell--${density}`,
+        hasOutline && "eth-doc-editor-shell--has-outline",
+        hasOutline && outlineOpen && "eth-doc-editor-shell--outline-open",
+        hasInspector && "eth-doc-editor-shell--has-inspector",
+        className
+      ),
+      "data-eth-component": ethComponent,
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("header", { className: "eth-doc-editor-shell__bar", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "eth-doc-editor-shell__title", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("p", { className: "eth-eyebrow", children: documentRefLabel(documentRef) }),
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("h2", { children: title })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "eth-doc-editor-shell__status", children: [
+            hasOutline ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+              import_core2.IconButton,
+              {
+                label: outlineOpen ? "Collapse outline" : "Expand outline",
+                intent: "ghost",
+                density,
+                icon: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
+                  import_icons3.ChevronRightIcon,
+                  {
+                    size: 16,
+                    style: { transform: outlineOpen ? "rotate(180deg)" : void 0 }
+                  }
+                ),
+                "aria-expanded": outlineOpen,
+                onClick: () => setOutlineOpen((current) => !current)
+              }
+            ) : null,
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_core2.Badge, { severity: "neutral", children: modeLabel(mode) }),
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(DocumentLockBadge, { lockState, owner: lockOwner })
+          ] })
+        ] }),
+        toolbar ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("div", { className: "eth-doc-editor-shell__toolbar", children: toolbar }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "eth-doc-editor-shell__grid", style: gridStyle, children: [
+          hasOutline && outlineOpen ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("aside", { className: "eth-doc-editor-shell__outline", "aria-label": "Document outline", children: outline }) : null,
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("main", { className: "eth-doc-editor-shell__editor", "aria-label": "Document editor", children }),
+          inspector ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("aside", { className: "eth-doc-editor-shell__inspector", "aria-label": "Document inspector", children: inspector }) : null
+        ] })
+      ]
+    }
+  );
+}
+
+// src/components/DocumentViewer.tsx
+var React2 = __toESM(require("react"), 1);
+var import_core3 = require("@echothink-ui/core");
+var import_jsx_runtime4 = require("react/jsx-runtime");
+function DocumentViewer({
+  title,
+  content,
+  metadata = [],
+  versionRef,
+  annotations = [],
+  className,
+  ...props
+}) {
+  const titleId = React2.useId();
+  const meta = versionRef ? [...metadata, { label: "Version", value: versionRef }] : metadata;
+  const labelledBy = props["aria-labelledby"] ?? titleId;
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+    "article",
+    {
+      ...props,
+      "aria-labelledby": labelledBy,
+      className: cx(
+        "eth-doc-viewer",
+        annotations.length > 0 && "eth-doc-viewer--with-annotations",
+        className
+      ),
+      "data-eth-component": "DocumentViewer",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("header", { className: "eth-doc-viewer__header", children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h2", { id: titleId, children: title }) }),
+        meta.length ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("dl", { className: "eth-meta-grid eth-doc-viewer__metadata", children: meta.map((item, index) => /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { children: [
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("dt", { children: item.label }),
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("dd", { children: item.value })
+        ] }, `${String(item.label)}-${index}`)) }) : null,
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "eth-doc-viewer__body", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "eth-doc-viewer__content", children: content }),
+          annotations.length ? /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("aside", { className: "eth-doc-viewer__annotations", "aria-label": "Annotations", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h3", { children: "Annotations" }),
+            /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("ul", { children: annotations.map((annotation) => /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("li", { className: "eth-doc-viewer__annotation", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "eth-doc-viewer__annotation-header", children: [
+                /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("strong", { children: annotation.author }),
+                annotation.range ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_core3.Badge, { severity: "neutral", children: annotation.range }) : null,
+                /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("time", { dateTime: annotation.createdAt, children: formatDateTime(annotation.createdAt) })
+              ] }),
+              /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { children: annotation.comment })
+            ] }, annotation.id)) })
+          ] }) : null
+        ] })
+      ]
+    }
+  );
+}
+
+// src/components/DocumentToolbar.tsx
+var import_core4 = require("@echothink-ui/core");
+var import_jsx_runtime5 = require("react/jsx-runtime");
+var modes = ["edit", "review", "view"];
+function DocumentToolbar({
+  actions,
+  formattingActions = [],
+  mode,
+  onModeChange,
+  density = "default",
+  className,
+  ...props
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+    "div",
+    {
+      ...props,
+      className: cx("eth-doc-toolbar", className),
+      role: "toolbar",
+      "aria-label": "Document toolbar",
+      "data-eth-component": "DocumentToolbar",
+      children: [
+        formattingActions.length ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+          "div",
+          {
+            className: "eth-doc-toolbar__group eth-doc-toolbar__group--formatting",
+            role: "group",
+            "aria-label": "Formatting",
+            children: formattingActions.map((action) => renderToolbarAction(action, density, "icon"))
+          }
+        ) : null,
+        mode && onModeChange ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+          "div",
+          {
+            className: "eth-doc-toolbar__group eth-doc-toolbar__group--mode",
+            role: "group",
+            "aria-label": "Document mode",
+            children: modes.map((candidate) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+              import_core4.Button,
+              {
+                className: "eth-doc-toolbar__mode-button",
+                density,
+                intent: candidate === mode ? "primary" : "secondary",
+                "aria-pressed": candidate === mode,
+                onClick: () => onModeChange(candidate),
+                children: modeLabel(candidate)
+              },
+              candidate
+            ))
+          }
+        ) : null,
+        actions.length ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+          "div",
+          {
+            className: "eth-doc-toolbar__group eth-doc-toolbar__group--actions",
+            role: "group",
+            "aria-label": "Document actions",
+            children: actions.map((action) => renderToolbarAction(action, density, "button"))
+          }
+        ) : null
+      ]
+    }
+  );
+}
+function renderToolbarAction(action, density, variant) {
+  const icon = actionIcon(action);
+  if (variant === "button") {
+    if (action.href) {
+      return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(
+        import_core4.LinkButton,
+        {
+          href: action.href,
+          density,
+          intent: action.intent ?? "secondary",
+          "aria-disabled": action.disabled,
+          tabIndex: action.disabled ? -1 : void 0,
+          className: cx(
+            "eth-doc-toolbar__action",
+            action.disabled && "eth-doc-toolbar__link--disabled"
+          ),
+          onClick: (event) => {
+            if (action.disabled) {
+              event.preventDefault();
+              return;
+            }
+            action.onSelect?.();
+          },
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "eth-doc-toolbar__action-icon", "aria-hidden": "true", children: icon }),
+            /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { children: action.label })
+          ]
+        },
+        action.id
+      );
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+      import_core4.Button,
+      {
+        className: "eth-doc-toolbar__action",
+        density,
+        intent: action.intent ?? "secondary",
+        icon,
+        disabled: action.disabled,
+        onClick: action.onSelect,
+        children: action.label
+      },
+      action.id
+    );
+  }
+  if (action.href) {
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+      "a",
+      {
+        href: action.href,
+        "aria-label": action.label,
+        tabIndex: action.disabled ? -1 : void 0,
+        className: cx(
+          "eth-button",
+          "eth-icon-button",
+          "eth-doc-toolbar__icon-link",
+          `eth-button--${action.intent ?? "ghost"}`,
+          `eth-button--${density}`,
+          action.disabled && "eth-doc-toolbar__link--disabled"
+        ),
+        "aria-disabled": action.disabled,
+        onClick: (event) => {
+          if (action.disabled) {
+            event.preventDefault();
+            return;
+          }
+          action.onSelect?.();
+        },
+        children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("span", { className: "eth-button__icon", children: icon })
+      },
+      action.id
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+    import_core4.IconButton,
+    {
+      density,
+      intent: action.intent ?? "ghost",
+      label: action.label,
+      icon,
+      disabled: action.disabled,
+      onClick: action.onSelect
+    },
+    action.id
+  );
+}
+
+// src/components/DocumentOutline.tsx
+var React3 = __toESM(require("react"), 1);
+var import_jsx_runtime6 = require("react/jsx-runtime");
+function DocumentOutline({
+  headings,
+  activeHeadingId,
+  onSelect,
+  className,
+  "aria-label": ariaLabel,
+  ...props
+}) {
+  const tree = React3.useMemo(() => buildOutlineTree(headings), [headings]);
+  const headingCountLabel = `${headings.length} section${headings.length === 1 ? "" : "s"}`;
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+    "nav",
+    {
+      ...props,
+      className: cx("eth-doc-outline", className),
+      "aria-label": ariaLabel ?? "Document outline",
+      "data-eth-component": "DocumentOutline",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "eth-doc-outline__header", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "eth-doc-outline__label", children: "On this page" }),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "eth-doc-outline__count", children: headingCountLabel })
+        ] }),
+        tree.length ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("ol", { className: "eth-doc-outline__list", children: renderNodes(tree, activeHeadingId, onSelect) }) : /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { className: "eth-doc-outline__empty", role: "status", children: "No headings available." })
+      ]
+    }
+  );
+}
+function renderNodes(nodes, activeHeadingId, onSelect) {
+  return nodes.map((node) => {
+    const href = node.href ?? `#${node.id}`;
+    const isActive = node.id === activeHeadingId;
+    const containsActiveHeading = activeHeadingId ? node.children.some((child) => containsHeading(child, activeHeadingId)) : false;
+    return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+      "li",
+      {
+        className: cx(
+          "eth-doc-outline__item",
+          `eth-doc-outline__item--level-${node.level}`,
+          isActive && "eth-doc-outline__item--active",
+          containsActiveHeading && "eth-doc-outline__item--contains-active"
+        ),
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+            "a",
+            {
+              className: "eth-doc-outline__link",
+              href,
+              "aria-current": isActive ? "location" : void 0,
+              onClick: (event) => {
+                if (!href.startsWith("#") && !onSelect) return;
+                event.preventDefault();
+                onSelect?.(node.id);
+                scrollHeadingIntoView(node.href, node.id);
+              },
+              children: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { className: "eth-doc-outline__text", children: node.text })
+            }
+          ),
+          node.children.length ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("ol", { className: "eth-doc-outline__list", children: renderNodes(node.children, activeHeadingId, onSelect) }) : null
+        ]
+      },
+      node.id
+    );
+  });
+}
+function containsHeading(node, id) {
+  return node.id === id || node.children.some((child) => containsHeading(child, id));
+}
+function buildOutlineTree(headings) {
+  const roots = [];
+  const stack = [{ level: 0, children: roots }];
+  for (const heading of headings) {
+    const node = { ...heading, children: [] };
+    while (stack.length > 1 && stack[stack.length - 1].level >= heading.level) stack.pop();
+    stack[stack.length - 1].children.push(node);
+    stack.push(node);
+  }
+  return roots;
+}
+function scrollHeadingIntoView(href, id) {
+  const targetId = href?.startsWith("#") ? href.slice(1) : id;
+  const target = globalThis.document?.getElementById(targetId);
+  target?.scrollIntoView({ block: "start", behavior: "smooth" });
+}
+
+// src/components/AgentLockedDocumentPanel.tsx
+var React4 = __toESM(require("react"), 1);
+var import_core5 = require("@echothink-ui/core");
+var import_jsx_runtime7 = require("react/jsx-runtime");
+function AgentLockedDocumentPanel({
+  documentRef,
+  lockOwner,
+  pendingChanges = [],
+  onTakeover,
+  onRelease,
+  onReviewChanges,
+  density = "default",
+  className,
+  ...props
+}) {
+  const headingId = React4.useId();
+  const ownerLabel = lockOwner?.label ?? "An agent";
+  const documentLabel = documentRefLabel(documentRef);
+  const documentVersion = typeof documentRef === "string" ? void 0 : documentRef.version;
+  const pendingCountLabel = `${pendingChanges.length} ${pendingChanges.length === 1 ? "change" : "changes"}`;
+  const hasActions = Boolean(onReviewChanges || onRelease || onTakeover);
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+    import_core5.Surface,
+    {
+      ...props,
+      title: "Agent document lock",
+      subtitle: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_jsx_runtime7.Fragment, { children: [
+        ownerLabel,
+        " holds the editing lock for ",
+        documentLabel,
+        "."
+      ] }),
+      severity: "warning",
+      density,
+      metadata: [
+        {
+          label: "Lock state",
+          value: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DocumentLockBadge, { lockState: "locked-by-agent", owner: lockOwner })
+        },
+        { label: "Document", value: documentLabel },
+        ...documentVersion ? [{ label: "Version", value: documentVersion }] : [],
+        { label: "Pending changes", value: pendingCountLabel }
+      ],
+      className: cx("eth-doc-agent-lock-panel", className),
+      "data-eth-component": "AgentLockedDocumentPanel",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "eth-doc-agent-lock-panel__notice", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_core5.InlineNotification, { severity: "warning", title: "Document locked by agent", children: [
+          ownerLabel,
+          " is preparing changes for ",
+          documentLabel,
+          ". Review staged updates before releasing the lock or taking over."
+        ] }) }),
+        /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("section", { className: "eth-doc-agent-lock-panel__changes-section", "aria-labelledby": headingId, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "eth-doc-agent-lock-panel__changes-header", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("h3", { id: headingId, children: "Pending changes" }),
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "eth-doc-agent-lock-panel__count", children: pendingCountLabel })
+          ] }),
+          pendingChanges.length ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("ol", { className: "eth-doc-agent-lock-panel__changes", children: pendingChanges.map((change) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("li", { className: "eth-doc-agent-lock-panel__change", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "eth-doc-agent-lock-panel__change-body", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("strong", { className: "eth-doc-agent-lock-panel__summary", children: change.summary }),
+            change.diffSnippet ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("pre", { className: "eth-doc-agent-lock-panel__diff", children: change.diffSnippet }) : null
+          ] }) }, change.id)) }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "eth-doc-agent-lock-panel__empty", role: "status", children: "The agent holds the lock but has not staged changes." })
+        ] }),
+        hasActions ? /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "eth-actions eth-doc-agent-lock-panel__actions", children: [
+          onReviewChanges ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_core5.Button, { intent: "primary", density, onClick: onReviewChanges, children: "Review changes" }) : null,
+          onRelease ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_core5.Button, { intent: "secondary", density, onClick: onRelease, children: "Release lock" }) : null,
+          onTakeover ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_core5.Button, { intent: "danger", density, onClick: onTakeover, children: "Take over" }) : null
+        ] }) : null
+      ]
+    }
+  );
+}
+
+// src/components/DocumentWorkspaceTemplate.tsx
+var import_core6 = require("@echothink-ui/core");
+var import_jsx_runtime8 = require("react/jsx-runtime");
+function DocumentWorkspaceTemplate({
+  title,
+  documentRef,
+  mode = "edit",
+  lockState = "unlocked",
+  lockOwner,
+  actions = [],
+  formattingActions,
+  onModeChange,
+  headings = [],
+  activeHeadingId,
+  onSelectHeading,
+  inspector,
+  toolbar,
+  metadata,
+  versionRef,
+  annotations,
+  content,
+  children,
+  density,
+  ...props
+}) {
+  const outline = headings.length ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    DocumentOutline,
+    {
+      headings,
+      activeHeadingId,
+      onSelect: onSelectHeading
+    }
+  ) : null;
+  const resolvedToolbar = toolbar ?? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    DocumentToolbar,
+    {
+      actions,
+      formattingActions,
+      mode,
+      onModeChange,
+      density
+    }
+  );
+  const body = mode === "view" && content !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    DocumentViewer,
+    {
+      title,
+      content,
+      metadata,
+      versionRef,
+      annotations
+    }
+  ) : children ?? content ?? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_core6.EmptyState, { title: "No document content" });
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+    DocumentEditorShell,
+    {
+      ...props,
+      title,
+      documentRef,
+      mode,
+      lockState,
+      lockOwner,
+      toolbar: resolvedToolbar,
+      outline,
+      inspector,
+      density,
+      "data-eth-component": "DocumentWorkspaceTemplate",
+      children: body
+    }
+  );
+}
+
+// src/index.tsx
+var DocumentsComponentNames = [
+  "DocumentEditorShell",
+  "DocumentViewer",
+  "DocumentToolbar",
+  "DocumentOutline",
+  "DocumentLockBadge",
+  "AgentLockedDocumentPanel",
+  "DocumentWorkspaceTemplate"
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentLockedDocumentPanel,
+  DocumentEditorShell,
+  DocumentLockBadge,
+  DocumentOutline,
+  DocumentToolbar,
+  DocumentViewer,
+  DocumentWorkspaceTemplate,
+  DocumentsComponentNames
+});
+//# sourceMappingURL=index.cjs.map