@arbidocs/blocks 0.4.92 → 0.4.94

package/dist/studio/index.cjs

@@ -10,12 +10,12 @@ require('../chunk-VPPX5XUF.cjs');
 var chunkPCB2BPN3_cjs = require('../chunk-PCB2BPN3.cjs');
 var chunkZW6FPIFC_cjs = require('../chunk-ZW6FPIFC.cjs');
 require('../chunk-OB5F4577.cjs');
+var chunkC54XEN5T_cjs = require('../chunk-C54XEN5T.cjs');
 require('../chunk-MP6FK43E.cjs');
 require('../chunk-VGOFFCMT.cjs');
 require('../chunk-B4SRYJLM.cjs');
 require('../chunk-7UTB4PHM.cjs');
 require('../chunk-PPCATBOY.cjs');
-var chunkC54XEN5T_cjs = require('../chunk-C54XEN5T.cjs');
 var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 require('../chunk-MHVNT4J3.cjs');
 require('../chunk-DES3K4SD.cjs');

package/dist/studio/index.js

@@ -9,12 +9,12 @@ import '../chunk-4EZVCGRL.js';
 import { Callout } from '../chunk-UJE32SST.js';
 import { EmptyState } from '../chunk-P6GHJSLR.js';
 import '../chunk-S7PSMMRG.js';
+import { useBlocksEnvironment } from '../chunk-76JDDMSP.js';
 import '../chunk-EWSEQEPL.js';
 import '../chunk-KZJAG7T3.js';
 import '../chunk-HOXKR26S.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-NPLYHR2E.js';
-import { useBlocksEnvironment } from '../chunk-76JDDMSP.js';
 import { formatCount } from '../chunk-OXF2IFXG.js';
 import '../chunk-7F6CBP3Z.js';
 import '../chunk-VUNV25KB.js';

package/dist/tags/definitions.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Defined terms. A definition is an ordinary fact carrying the workspace's "Definitions" label; its
+ * TERM is read from the start of its text — `"Shares" means …`, `**Business Day** shall mean …`,
+ * `Completion: the date …` — and facts defining the same term (one per agreement, say) are grouped,
+ * a confirmed one preferred over the rest, then the most recent. Pure helpers, no React: the Word
+ * editor inserts terms with them and the Tags page prints the glossary with them.
+ */
+/** The label that marks a fact as a definition. */
+export declare const DEFINITIONS_LABEL = "Definitions";
+/** A label on a definition other than {@link DEFINITIONS_LABEL} (e.g. the agreement it is from). */
+export interface DefinitionLabel {
+    id: string;
+    name: string;
+}
+/** A definition fact, as the host reads it. */
+export interface DefinitionSource {
+    /** The fact's id (`fct-…`). */
+    id: string;
+    /** The fact text, as written (it may be Markdown). */
+    text: string;
+    /** A human vouched for it: preferred over unconfirmed definitions of the same term. */
+    confirmed?: boolean;
+    /** ISO time it was last written; the most recent wins between equals. */
+    updatedAt?: string;
+    /** Where it comes from: the cited document's name. */
+    source?: string;
+    /** Its other labels, e.g. the agreement ("SPA") it defines a term of. */
+    labels?: DefinitionLabel[];
+}
+/** A definition's text split into its term and the rest. */
+export interface ParsedDefinition {
+    /** The term as written, without quotes or emphasis (`Business Day`). */
+    term: string;
+    /** What follows the term, its connecting word included (`means a day …`, `: the date …`). */
+    rest: string;
+    /** Just the meaning, the connecting word dropped (`a day …`). */
+    meaning: string;
+}
+/** A parsed definition fact. */
+export interface Definition extends DefinitionSource, ParsedDefinition {
+    /** The term's matching key (case and whitespace folded). */
+    key: string;
+}
+/** Every definition of one term, the preferred one first. */
+export interface DefinedTermGroup {
+    key: string;
+    /** The term as the preferred definition writes it. */
+    term: string;
+    /** The preferred definition (first of {@link DefinedTermGroup.definitions}). */
+    preferred: Definition;
+    definitions: Definition[];
+}
+/** The matching key of a term: case and whitespace folded, quotes and emphasis dropped. */
+export declare function termKey(term: string): string;
+/**
+ * Read a definition's term from the start of its text, or `null` when it does not start with one.
+ *
+ * Optional straight or curly quotes and bold markers around the term are dropped; the term is what
+ * comes before "means", "shall mean", "includes", "has the meaning", a colon, or a dash. A quoted
+ * term is taken whole, so `"Long-Stop Date" means …` keeps its hyphen.
+ */
+export declare function parseDefinition(text: string): ParsedDefinition | null;
+/** A definition parsed, or `null` when its text names no term. */
+export declare function toDefinition(source: DefinitionSource): Definition | null;
+/** Preferred first: confirmed, then most recently written, then by id (stable). */
+export declare function compareDefinitions(a: DefinitionSource, b: DefinitionSource): number;
+/** Alphabetical order of terms, as a reader sorts a glossary (case and accents folded). */
+export declare const compareTerms: (a: string, b: string) => number;
+/**
+ * Definitions grouped by term, alphabetically, each group's preferred definition first. Facts whose
+ * text names no term are returned apart (`unparsed`), so a host can say how many it could not read.
+ * With `labelId`, only definitions carrying that label (one agreement's, say) are kept.
+ */
+export declare function groupDefinitions(sources: readonly DefinitionSource[], options?: {
+    labelId?: string | null;
+}): {
+    groups: DefinedTermGroup[];
+    unparsed: DefinitionSource[];
+};
+/** The labels (agreements) definitions carry besides the Definitions label, by name. */
+export declare function definitionLabels(sources: readonly DefinitionSource[]): DefinitionLabel[];
+/** Groups whose term matches a typed query: prefix matches first, then any word, then anywhere. */
+export declare function filterTermGroups(groups: readonly DefinedTermGroup[], query: string): DefinedTermGroup[];
+/** Prefix of every bookmark a defined term links to: hidden in Word (leading underscore). */
+export declare const DEFINITION_BOOKMARK_PREFIX = "_dt_";
+/**
+ * The Word bookmark of a definition: `_dt_` and the fact id in valid bookmark characters
+ * (`fct-AbC12345` → `_dt_fct_AbC12345`), at most 40 characters as Word requires.
+ */
+export declare function definitionBookmark(factId: string): string;
+/** The fact id a definition bookmark names, or `null` for any other bookmark. */
+export declare function definitionIdOfBookmark(name: string): string | null;

package/dist/tags/glossary.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The glossary: every definition fact (optionally one agreement's), alphabetical by term, as a
+ * three-column table — Term, Definition, Source — printed as a Word document or as Markdown with
+ * the same WordprocessingML the tag tables export with (`ooxml.ts`).
+ */
+import { type DefinitionSource } from './definitions';
+/** One glossary row. */
+export interface GlossaryEntry {
+    /** Empty for a definition whose text names no term (listed last, as written). */
+    term: string;
+    definition: string;
+    source: string;
+    factId: string;
+}
+export interface GlossaryLabels {
+    term: string;
+    definition: string;
+    source: string;
+    /** `{at}` is when it was printed, `YYYY-MM-DD HH:MM UTC`. */
+    takenAt: string;
+    empty: string;
+}
+export declare const DEFAULT_GLOSSARY_LABELS: GlossaryLabels;
+export interface GlossaryOptions {
+    title: string;
+    /** When it was printed (ISO); default now. */
+    at?: string;
+    labels?: Partial<GlossaryLabels>;
+}
+/**
+ * The glossary's rows: every definition, alphabetical by term and, within a term, the preferred one
+ * first. Definitions whose text names no term follow, as written. `labelId` keeps one label's.
+ */
+export declare function glossaryEntries(sources: readonly DefinitionSource[], options?: {
+    labelId?: string | null;
+}): GlossaryEntry[];
+/** The glossary as a Markdown document: a heading, when it was printed, and one table. */
+export declare function glossaryMarkdown(entries: readonly GlossaryEntry[], options: GlossaryOptions): string;
+/** `word/document.xml` of the glossary (exposed for tests). */
+export declare function glossaryDocumentXml(entries: readonly GlossaryEntry[], options: GlossaryOptions): string;
+/** The glossary as `.docx` bytes. */
+export declare function glossaryDocx(entries: readonly GlossaryEntry[], options: GlossaryOptions): Uint8Array;
+/** A file name for the glossary: `Glossary - SPA.docx`. */
+export declare function glossaryFileName(title: string, extension: 'docx' | 'md'): string;

package/dist/tags/index.d.ts

@@ -9,3 +9,5 @@ export { TagDetail, DEFAULT_TAG_DETAIL_LABELS, type TagDetailProps, type TagDeta
 export { TagsNav, findTagsNavItem, DEFAULT_TAGS_NAV_LABELS, type TagsNavProps, type TagsNavLabels, type TagsNavGroup, type TagsNavItem, type TagsNavSelection, } from './TagsNav';
 export { tagTableMarkdown, cellValue, cellText, parseCell, isGap, rowLinks, fieldWrites, type TagTableData, type TagTableRow, type TagTableLinks, type TagTableField, type TagTableFieldType, type TagTableFieldWrite, type TagTableMarkdownOptions, } from './tagTableModel';
 export { tagTableDocx, tagTableDocumentXml, DEFAULT_TAG_TABLE_DOCX_LABELS, TAG_TABLE_DOCX_LANDSCAPE_AFTER, type TagTableDocxLabels, type TagTableDocxOptions, } from './tagTableDocx';
+export { DEFINITIONS_LABEL, DEFINITION_BOOKMARK_PREFIX, parseDefinition, toDefinition, termKey, groupDefinitions, definitionLabels, filterTermGroups, compareDefinitions, compareTerms, definitionBookmark, definitionIdOfBookmark, type DefinitionSource, type DefinitionLabel, type Definition, type DefinedTermGroup, type ParsedDefinition, } from './definitions';
+export { glossaryEntries, glossaryMarkdown, glossaryDocx, glossaryDocumentXml, glossaryFileName, DEFAULT_GLOSSARY_LABELS, type GlossaryEntry, type GlossaryLabels, type GlossaryOptions, } from './glossary';

package/dist/tags/ooxml.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The small WordprocessingML vocabulary the tags exports write: escaped runs, paragraphs, table
+ * cells, an A4 page, and the minimal package around a `word/document.xml`. Zipped with `fflate`, so
+ * the result opens in the native Word editor and in Word without pulling the editor engine in.
+ */
+export declare const DOCX_MIME_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+export declare const W_NAMESPACES = "xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"";
+/** Text as XML character data or an attribute value. */
+export declare const esc: (text: string) => string;
+export interface Run {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    muted?: boolean;
+}
+export declare const run: ({ text, bold, italic, muted }: Run) => string;
+export declare const paragraph: (runs: Run[], style?: string) => string;
+/** A table cell: its paragraphs (a cell must hold at least one), shaded when given a fill. */
+export declare const cell: (paragraphs: string[], width: number, fill?: string) => string;
+/** Page geometry in twips (A4), turned for landscape. */
+export declare function page(landscape: boolean): {
+    margin: number;
+    textWidth: number;
+    sectPr: string;
+};
+/** `YYYY-MM-DD HH:MM` (UTC) of an ISO time, for a "taken at" line. */
+export declare const minuteUtc: (at: string) => string;
+/** A `word/document.xml` around body content (paragraphs, tables, then the section). */
+export declare const documentXml: (body: string) => string;
+/** `word/styles.xml` holding the given style definitions. */
+export declare const stylesXml: (defaults: string, styles: string) => string;
+/** Calibri 11pt (en-GB), 8pt after each paragraph: the document defaults the exports share. */
+export declare const DOC_DEFAULTS = "<w:docDefaults><w:rPrDefault><w:rPr><w:rFonts w:ascii=\"Calibri\" w:hAnsi=\"Calibri\" w:eastAsia=\"Calibri\" w:cs=\"Calibri\"/><w:sz w:val=\"22\"/><w:szCs w:val=\"22\"/><w:lang w:val=\"en-GB\"/></w:rPr></w:rPrDefault><w:pPrDefault><w:pPr><w:spacing w:after=\"160\" w:line=\"259\" w:lineRule=\"auto\"/></w:pPr></w:pPrDefault></w:docDefaults>";
+/**
+ * Styles of a document that is a title and a table: `Title`, the compact `TagTableCell` paragraph
+ * and the bordered `TagTableGrid` table.
+ */
+export declare const TABLE_DOCUMENT_STYLES: string;
+/** The minimal `.docx` package: a document, its styles, and its title and time. */
+export declare function docxPackage(parts: {
+    document: string;
+    styles: string;
+    title: string;
+    /** ISO time; default now. */
+    at?: string;
+}): Uint8Array;

package/dist/tags/tagTableDocx.d.ts

@@ -6,7 +6,7 @@
  * in Word without pulling the editor engine into the tags module.
  */
 import { type TagTableData } from './tagTableModel';
-export declare const DOCX_MIME_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+export { DOCX_MIME_TYPE } from './ooxml';
 /** More table columns than this (item, fields, evidence, gaps) turn the page to landscape. */
 export declare const TAG_TABLE_DOCX_LANDSCAPE_AFTER = 6;
 export interface TagTableDocxLabels {

package/dist/workflow-canvas/index.cjs

@@ -2,7 +2,7 @@
 'use strict';
 
 var chunkMUMH3Z6K_cjs = require('../chunk-MUMH3Z6K.cjs');
-var chunkDDYXFALG_cjs = require('../chunk-DDYXFALG.cjs');
+var chunkKKU7MUWE_cjs = require('../chunk-KKU7MUWE.cjs');
 require('../chunk-S5HZBXZA.cjs');
 require('../chunk-ZW6FPIFC.cjs');
 var chunk3US5OIDQ_cjs = require('../chunk-3US5OIDQ.cjs');
@@ -17,13 +17,13 @@ require('../chunk-2EI7NCUA.cjs');
 require('../chunk-Z5VUZ6YD.cjs');
 require('../chunk-7D737FLE.cjs');
 require('../chunk-OB5F4577.cjs');
+require('../chunk-C54XEN5T.cjs');
+require('../chunk-ULWRNGGE.cjs');
+require('../chunk-IXALYQT7.cjs');
 require('../chunk-B4SRYJLM.cjs');
 require('../chunk-7UTB4PHM.cjs');
 require('../chunk-PPCATBOY.cjs');
-require('../chunk-C54XEN5T.cjs');
 require('../chunk-KDG6FER6.cjs');
-require('../chunk-ULWRNGGE.cjs');
-require('../chunk-IXALYQT7.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 require('../chunk-MHVNT4J3.cjs');
 require('../chunk-DES3K4SD.cjs');
@@ -1615,7 +1615,7 @@ function triggerFields(trigger, clearOthers) {
   return {
     timezone: trigger.timezone,
     rrule: trigger.start === "repeat" ? trigger.rrule.trim() : none,
-    run_at: trigger.start === "once" ? chunkDDYXFALG_cjs.localInputToIso(trigger.runAt) : none,
+    run_at: trigger.start === "once" ? chunkKKU7MUWE_cjs.localInputToIso(trigger.runAt) : none,
     event_kind: trigger.start === "event" ? trigger.eventKind.trim() : none,
     // A step signal is `workflow_signal` narrowed to one signal name.
     event_filter: filter ?? none,
@@ -1674,7 +1674,7 @@ function workflowRecordToBuilder(record) {
       ...record.skill_ref ? { workflow: record.skill_ref } : { run: { kind: "prompt", promptTemplate: record.prompt } }
     }
   ] : [];
-  const when = chunkDDYXFALG_cjs.workflowWhen(record);
+  const when = chunkKKU7MUWE_cjs.workflowWhen(record);
   return {
     workflow: {
       id: record.external_id,
@@ -1688,7 +1688,7 @@ function workflowRecordToBuilder(record) {
     trigger: {
       ...DEFAULT_WORKFLOW_TRIGGER,
       start: when === "now" ? "manual" : when,
-      runAt: chunkDDYXFALG_cjs.isoToLocalInput(record.run_at),
+      runAt: chunkKKU7MUWE_cjs.isoToLocalInput(record.run_at),
       rrule: record.rrule ?? "",
       timezone: record.timezone || DEFAULT_WORKFLOW_TRIGGER.timezone,
       eventKind: record.event_kind ?? "",
@@ -1744,7 +1744,7 @@ function triggerSummary(trigger, options = {}) {
     case "once":
       return trigger.runAt ? new Date(trigger.runAt).toLocaleString() : l.starts.once;
     case "repeat":
-      return trigger.rrule ? chunkDDYXFALG_cjs.describeRRule(trigger.rrule) : l.starts.repeat;
+      return trigger.rrule ? chunkKKU7MUWE_cjs.describeRRule(trigger.rrule) : l.starts.repeat;
     case "event":
       if (isSignalTrigger(trigger))
         return trigger.signal ? l.signalSummary.replace("{signal}", trigger.signal) : l.stepSignals;
@@ -1803,7 +1803,7 @@ function TriggerInspector({
         }
       )
     ] }),
-    trigger.start === "repeat" && /* @__PURE__ */ jsxRuntime.jsx(chunkDDYXFALG_cjs.RecurrenceBuilder, { rrule: trigger.rrule, onChange: (rrule) => set({ rrule }) }),
+    trigger.start === "repeat" && /* @__PURE__ */ jsxRuntime.jsx(chunkKKU7MUWE_cjs.RecurrenceBuilder, { rrule: trigger.rrule, onChange: (rrule) => set({ rrule }) }),
     trigger.start === "event" && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.event }),
       /* @__PURE__ */ jsxRuntime.jsxs(
@@ -1855,7 +1855,7 @@ function TriggerInspector({
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "space-y-1.5", children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Label, { className: "text-xs", children: l.agent }),
       /* @__PURE__ */ jsxRuntime.jsx(
-        chunkDDYXFALG_cjs.AgentSelect,
+        chunkKKU7MUWE_cjs.AgentSelect,
         {
           agents,
           value: trigger.agentId,
@@ -2706,7 +2706,7 @@ function WorkflowPreview({
   renderIcon,
   testId
 }) {
-  const run = chunkDDYXFALG_cjs.useWorkflowPreview(workflow, {
+  const run = chunkKKU7MUWE_cjs.useWorkflowPreview(workflow, {
     resolveWorkflow: (id) => workflows.find((w) => w.id === id),
     compose,
     answer

package/dist/workflow-canvas/index.js

@@ -1,6 +1,6 @@
 "use client";
 import { useConnection } from '../chunk-OYMWV45N.js';
-import { workflowWhen, isoToLocalInput, describeRRule, RecurrenceBuilder, AgentSelect, useWorkflowPreview, localInputToIso } from '../chunk-5NQIBJPP.js';
+import { workflowWhen, isoToLocalInput, describeRRule, RecurrenceBuilder, AgentSelect, useWorkflowPreview, localInputToIso } from '../chunk-ZNGDEQBN.js';
 import '../chunk-4XJZ6AAY.js';
 import '../chunk-P6GHJSLR.js';
 import { workflowSteps, dependsOn, stepLevels, isIncompleteSignal, runFields, upstreamSteps, stepDependencies, canAssign, fromPlanSteps, layoutFromPlanSteps, validateWorkflowGraph, stepConfigProblems, WorkflowRunner, skillToWorkflow, assigneeName, orderSteps, toPlanSteps } from '../chunk-PGDL26TQ.js';
@@ -15,13 +15,13 @@ import '../chunk-YU2KUMGE.js';
 import '../chunk-DDF5GPIJ.js';
 import '../chunk-XD2M6LIG.js';
 import '../chunk-S7PSMMRG.js';
+import '../chunk-76JDDMSP.js';
+import '../chunk-TX2ZICS7.js';
+import '../chunk-ZPLG7QYF.js';
 import '../chunk-HOXKR26S.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-NPLYHR2E.js';
-import '../chunk-76JDDMSP.js';
 import '../chunk-OXF2IFXG.js';
-import '../chunk-TX2ZICS7.js';
-import '../chunk-ZPLG7QYF.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-7F6CBP3Z.js';
 import '../chunk-VUNV25KB.js';

package/dist/workspaces/index.cjs

@@ -5,9 +5,9 @@ var chunkXZIYRKLW_cjs = require('../chunk-XZIYRKLW.cjs');
 var chunkXAJIKT6Y_cjs = require('../chunk-XAJIKT6Y.cjs');
 var chunkOB5F4577_cjs = require('../chunk-OB5F4577.cjs');
 require('../chunk-C54XEN5T.cjs');
-var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 var chunk7G2LJMUG_cjs = require('../chunk-7G2LJMUG.cjs');
 var chunkULWRNGGE_cjs = require('../chunk-ULWRNGGE.cjs');
+var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 require('../chunk-DES3K4SD.cjs');
 var react = require('react');
 var lucideReact = require('lucide-react');

package/dist/workspaces/index.js

@@ -3,9 +3,9 @@ import { CollapsibleSection, KeyValueRow } from '../chunk-LGBAZD37.js';
 import { MemberAvatarStack } from '../chunk-XNOASBGW.js';
 import { ActionLink } from '../chunk-S7PSMMRG.js';
 import '../chunk-76JDDMSP.js';
-import { fromNow, fmtDate } from '../chunk-OXF2IFXG.js';
 export { RoleBadge, WorkspaceTypeBadgeView } from '../chunk-NBV56SGU.js';
 import { ModalHeader } from '../chunk-TX2ZICS7.js';
+import { fromNow, fmtDate } from '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';
 import { createContext, useContext, useMemo, useState, useCallback, useId } from 'react';
 import { FileText, MessagesSquare, Users, Check, ChevronRight, UserPlus, LogOut, AlertCircle, Plus, ArrowUpRight, AlignLeft, Globe, CreditCard, Loader2, FolderLock } from 'lucide-react';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/blocks",
-  "version": "0.4.92",
+  "version": "0.4.94",
   "description": "Composable, domain-neutral UI blocks for ARBI apps, organised by capability (retrieval, facts, agents, workspaces, citations, collaboration) plus shell, theme and site primitives, on top of @arbidocs/react.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -266,8 +266,8 @@
     "example:test:e2e": "playwright test -c examples/custom-ui/playwright.config.ts"
   },
   "dependencies": {
-    "@arbidocs/client": "0.4.92",
-    "@arbidocs/coedit": "0.4.92",
+    "@arbidocs/client": "0.4.94",
+    "@arbidocs/coedit": "0.4.94",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -293,7 +293,7 @@
     "zustand": "^5.0.14"
   },
   "peerDependencies": {
-    "@arbidocs/react": "0.4.92",
+    "@arbidocs/react": "0.4.94",
     "@docx-editor.dev/core": "2.28.0",
     "@docx-editor.dev/react": "2.28.0",
     "@lexical/html": "0.35.0",

package/src/docx/README.md

@@ -66,3 +66,14 @@ with tracked operations and refuses stale targets.
 `NativeDocxComparison` uses the same adapter and native editor for the LibreOffice
 Word redline. Pass `baseId`, `revisedId`, `title` and optionally `onCompared` to
 refresh only the generated document in your host cache. Source files stay intact.
+
+Defined terms: give the adapter `definitions` (the workspace's facts labelled "Definitions", as
+`DefinitionSource`s) and the Insert tab offers Defined term and Update definitions, and typing
+`@@` in the body opens the term type-ahead. A picked term is inserted as an internal link
+(`w:hyperlink w:anchor`, the definition as its tooltip) to a hidden `_dt_<fact id>` bookmark on
+its definition, which is added in alphabetical order to the document's Definitions section (a
+heading named "Definitions"/"Definitions and interpretation"…, else a new "Definitions" heading at
+the end). Hovering a term shows its definition. Update definitions adds missing definitions,
+rewords and reorders the ones the section has, and lists those never used. The terms are read from
+the facts with `parseDefinition`/`groupDefinitions` (root entry), which also print the glossary
+(`glossaryDocx`, `glossaryMarkdown`).