@bitcobblers/wod-wiki-ui 0.37.2137 → 0.37.2140

package/dist/index.cjs

@@ -2382,7 +2382,8 @@ var SOURCE_OPTIONS = wodWikiWql.WQL_SOURCE_VALUES.map((s) => ({
     guides: "Static guide pages",
     playground: "Playground scratch pages",
     dashboards: "Dashboard notes",
-    efforts: "Exercise library notes"
+    efforts: "Exercise library notes",
+    equipment: "Equipment library notes"
   }[s]
 }));
 var PLANE_OPTIONS = wodWikiWql.WQL_RESULT_PLANES.map((v) => ({ value: v, label: v }));
@@ -5475,6 +5476,8 @@ var embedPreviewDecorations = [
   embedPreviewField
 ];
 var frontmatterSuggestions = state.Facet.define({ combine: (providers) => providers[0] ?? null });
+var frontmatterReferenceIndex = state.Facet.define({ combine: (providers) => providers[0] ?? null });
+var referenceIndexReload = state.StateEffect.define();
 var frontmatterVisibility = state.Facet.define({
   combine: (values2) => values2[0] ?? true
 });
@@ -5484,7 +5487,7 @@ var suggestionId = 0;
 function isTagProperty(key) {
   return ["tag", "tags", "category"].includes(key.trim().toLowerCase());
 }
-function attachSuggestions(input, view, root, kind, key, excluded, commit) {
+function attachSuggestions(input, view, root, kind, key, excluded, commit, valueKind = "tags") {
   const provider = view.state.facet(frontmatterSuggestions);
   if (!provider || !input.parentElement) return;
   const parent = input.parentElement;
@@ -5510,8 +5513,8 @@ function attachSuggestions(input, view, root, kind, key, excluded, commit) {
     input.setAttribute("aria-expanded", "false");
     input.removeAttribute("aria-activedescendant");
   };
-  const select = (label) => {
-    input.value = label;
+  const select = (choice) => {
+    input.value = choice.value;
     close();
     commit();
   };
@@ -5534,21 +5537,35 @@ function attachSuggestions(input, view, root, kind, key, excluded, commit) {
     try {
       const catalog = await provider();
       if (request !== generation || !input.isConnected || document.activeElement !== input) return;
-      const candidates = kind === "key" ? catalog.types : catalog.tags.filter((tag) => isTagProperty(key) || tag.type?.toLowerCase() === key.trim().toLowerCase()).map((tag) => tag.label);
+      let candidates;
+      if (kind === "key") {
+        candidates = catalog.types.map((name) => ({ value: name, label: name, haystack: name }));
+      } else if (valueKind === "effort" || valueKind === "equipment") {
+        const entries = valueKind === "effort" ? catalog.efforts ?? [] : catalog.equipment ?? [];
+        candidates = entries.map((entry) => ({
+          value: entry.slug,
+          label: `${entry.label} (${entry.slug})`,
+          haystack: [entry.label, entry.slug, ...entry.aliases].join(" ").toLowerCase()
+        }));
+      } else {
+        candidates = catalog.tags.filter((tag) => isTagProperty(key) || tag.type?.toLowerCase() === key.trim().toLowerCase()).map((tag) => ({ value: tag.label, label: tag.label, haystack: tag.label.toLowerCase() }));
+      }
       const selected = new Set(excluded.map((label) => label.toLowerCase()));
-      choices = [...new Set(candidates)].filter((label) => label.toLowerCase().includes(query) && !selected.has(label.toLowerCase()));
+      choices = candidates.filter(
+        (candidate) => (query === "" || candidate.haystack.includes(query)) && !selected.has(candidate.value.toLowerCase())
+      );
       active = -1;
       input.removeAttribute("aria-activedescendant");
       list.replaceChildren();
-      choices.forEach((label, index) => {
+      choices.forEach((choice, index) => {
         const option = document.createElement("div");
         option.id = `${list.id}-${index}`;
         option.setAttribute("role", "option");
         option.setAttribute("aria-selected", "false");
         option.className = "cursor-pointer px-2 py-1.5 hover:bg-muted";
-        option.textContent = label;
+        option.textContent = choice.label;
         option.addEventListener("mousedown", (event) => event.preventDefault());
-        option.addEventListener("click", () => select(label));
+        option.addEventListener("click", () => select(choice));
         list.appendChild(option);
       });
       list.hidden = choices.length === 0;
@@ -5591,45 +5608,66 @@ function parseTagList(val) {
   }
   return [];
 }
-function updateFrontmatter(view, sectionId, meta) {
+function patchPropertyInView(view, _sectionId, path, value) {
   if (view.state.readOnly) return;
-  const { sections } = view.state.field(sectionField);
-  const section = sections.find((s) => s.id === sectionId && s.type === "frontmatter") || sections.find((s) => s.type === "frontmatter");
-  if (!section) {
-    const nextBody2 = wodWikiWql.serializeFrontmatter(meta);
-    view.dispatch({
-      changes: {
-        from: 0,
-        to: 0,
-        insert: `---
-${nextBody2}
----
-
-`
-      }
-    });
-    return;
-  }
-  const nextBody = wodWikiWql.serializeFrontmatter(meta);
-  if (section.contentFrom !== void 0 && section.contentTo !== void 0) {
-    view.dispatch({
-      changes: {
-        from: section.contentFrom,
-        to: section.contentTo,
-        insert: nextBody
-      }
-    });
-  } else {
-    view.dispatch({
-      changes: {
-        from: section.from,
-        to: section.to,
-        insert: `---
-${nextBody}
----`
-      }
-    });
+  const wholeDoc = view.state.doc.toString();
+  const next = wodWikiCore.patchFrontmatterProperty(wholeDoc, path, value);
+  if (next === wholeDoc) return;
+  view.dispatch({ changes: { from: 0, to: wholeDoc.length, insert: next } });
+}
+function renamePropertyInView(view, _sectionId, fromKey, toKey, value) {
+  if (view.state.readOnly) return;
+  const wholeDoc = view.state.doc.toString();
+  const next = wodWikiCore.patchFrontmatterProperty(
+    wodWikiCore.patchFrontmatterProperty(wholeDoc, [toKey], value),
+    [fromKey],
+    null
+  );
+  if (next === wholeDoc) return;
+  view.dispatch({ changes: { from: 0, to: wholeDoc.length, insert: next } });
+}
+function detectDefinitionKind(meta) {
+  const type = typeof meta.type === "string" ? meta.type.trim().toLowerCase() : "";
+  if (type === "effort") return "effort";
+  if (type === "equipment") return "equipment";
+  if (meta.registrySource !== void 0 || meta.baseAttributes !== void 0) return "effort";
+  return null;
+}
+function readBaseAttributes(body) {
+  const out = {};
+  let inBase = false;
+  for (const line of body.split(/\r?\n/)) {
+    if (/^baseAttributes:\s*(#.*)?$/.test(line)) {
+      inBase = true;
+      continue;
+    }
+    if (!inBase) continue;
+    if (/^\S/.test(line)) break;
+    const match = line.match(/^\s+([\w-]+):\s*(.*)$/);
+    if (!match) continue;
+    if (match[1] === "met" || match[1] === "discipline" || match[1] === "intensityTier") {
+      out[match[1]] = unquoteYamlScalar(match[2].trim());
+    }
   }
+  return out;
+}
+function unquoteYamlScalar(val) {
+  if (val.startsWith('"') && val.endsWith('"')) return val.slice(1, -1).replace(/\\(["\\])/g, "$1");
+  if (val.startsWith("'") && val.endsWith("'")) return val.slice(1, -1).replace(/\\'/g, "'");
+  return val;
+}
+function referenceValueKind(key, docKind) {
+  const normalized = key.trim().toLowerCase();
+  if (normalized === "metrics.effort") return "effort";
+  if (normalized === "metrics.equipment" || normalized === "equipment") return "equipment";
+  if (normalized === "aliases" && docKind === "equipment") return "equipment";
+  if (normalized === "aliases" && docKind === "effort") return "effort";
+  return "tags";
+}
+function isReferenceKey(key, docKind) {
+  const normalized = key.trim().toLowerCase();
+  if (normalized === "metrics.effort" || normalized === "metrics.equipment") return true;
+  return normalized === "equipment" && docKind === "effort";
 }
 function createTagDraftRow(view, root, key, onCommit) {
   const row = document.createElement("div");
@@ -5684,6 +5722,117 @@ function createTagDraftRow(view, root, key, onCommit) {
   }));
   return row;
 }
+function ownsNestedBlock(body, key) {
+  const lines = body.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    if (!new RegExp(`^${key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}:\\s*$`).test(lines[i])) continue;
+    return i + 1 < lines.length && /^\s+\S/.test(lines[i + 1]);
+  }
+  return false;
+}
+function renderEffortValueDiagnostics(provider, token, onPick) {
+  const trimmed = token.trim();
+  if (!trimmed || provider.resolveEffort(trimmed)) return null;
+  const diagnostics = provider.resolve(trimmed).diagnostics;
+  const box = document.createElement("div");
+  box.setAttribute("data-testid", "editor-ref-unknown");
+  box.className = "w-full basis-full flex flex-wrap items-center gap-2 text-[10px] text-destructive";
+  const message = document.createElement("span");
+  message.textContent = diagnostics[0]?.message || `Unknown effort: ${trimmed}`;
+  box.appendChild(message);
+  for (const candidate of diagnostics[0]?.candidates ?? []) {
+    const pickBtn = document.createElement("button");
+    pickBtn.type = "button";
+    pickBtn.textContent = `Use ${candidate}`;
+    pickBtn.className = "underline hover:text-foreground cursor-pointer";
+    pickBtn.addEventListener("click", (e) => {
+      e.preventDefault();
+      onPick(candidate);
+    });
+    box.appendChild(pickBtn);
+  }
+  const createLink = document.createElement("a");
+  createLink.href = provider.createHref("effort");
+  createLink.textContent = "Create page";
+  createLink.className = "underline hover:text-foreground";
+  box.appendChild(createLink);
+  return box;
+}
+var METRIC_DRAFT_KINDS = {
+  effort: { label: "Effort", path: "metrics.effort", kind: "effort" },
+  equipment: { label: "Equipment", path: "metrics.equipment", kind: "equipment" },
+  rpe: { label: "RPE", path: "metrics.rpe", kind: "number" }
+};
+function createMetricDraftRow(view, root, referenceProvider, commit) {
+  const row = document.createElement("div");
+  row.className = "flex items-center min-h-[34px] border-b border-dashed border-border/60 last:border-b-0 group hover:bg-muted/10 transition-colors max-[479px]:flex-col max-[479px]:items-stretch";
+  row.setAttribute("data-frontmatter-metric-draft", "true");
+  const select = document.createElement("select");
+  select.setAttribute("aria-label", "Metric kind");
+  select.className = "mx-3 my-1.5 h-7 w-28 shrink-0 rounded-md border border-input bg-background px-1.5 text-[11px] text-muted-foreground outline-none";
+  for (const [value, spec] of Object.entries(METRIC_DRAFT_KINDS)) {
+    const option = document.createElement("option");
+    option.value = value;
+    option.textContent = spec.label;
+    select.appendChild(option);
+  }
+  row.appendChild(select);
+  const valCol = document.createElement("div");
+  valCol.className = "flex items-center flex-wrap gap-1.5 px-3 py-1.5 flex-1 min-w-0";
+  const input = document.createElement("input");
+  input.className = "flex-1 min-w-[70px] bg-transparent text-xs text-foreground outline-none px-1 py-0.5 placeholder:text-muted-foreground/40";
+  input.placeholder = "Value\u2026";
+  input.setAttribute("aria-label", "Metric value");
+  valCol.appendChild(input);
+  row.appendChild(valCol);
+  let settled = false;
+  const settle = (doCommit) => {
+    if (settled) return;
+    settled = true;
+    const spec = METRIC_DRAFT_KINDS[select.value];
+    const raw = input.value.trim();
+    if (doCommit && spec && raw) {
+      if (spec.kind === "equipment") commit([spec.path], [raw]);
+      else if (spec.kind === "number") {
+        const num = Number(raw);
+        if (!Number.isNaN(num)) commit([spec.path], num);
+      } else commit([spec.path], raw);
+    }
+    row.remove();
+    view.requestMeasure();
+  };
+  const attachFor = () => {
+    const spec = METRIC_DRAFT_KINDS[select.value];
+    if (spec && (spec.kind === "effort" || spec.kind === "equipment") && referenceProvider) {
+      attachSuggestions(input, view, root, "value", spec.path, [], () => settle(true), spec.kind);
+    }
+  };
+  attachFor();
+  select.addEventListener("change", attachFor);
+  input.addEventListener("keydown", (e) => {
+    if (e.defaultPrevented && e.key !== "Escape") return;
+    if (e.key === "Escape") {
+      e.preventDefault();
+      settle(false);
+      return;
+    }
+    if (e.key === "Enter") {
+      e.preventDefault();
+      settle(true);
+    }
+  });
+  input.addEventListener("blur", () => queueMicrotask(() => {
+    if (!input.isConnected) return;
+    settle(input.value.trim().length > 0);
+  }));
+  select.addEventListener("keydown", (e) => {
+    if (e.key === "Escape") {
+      e.preventDefault();
+      settle(false);
+    }
+  });
+  return row;
+}
 function createTagIcon() {
   const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
   svg.setAttribute("viewBox", "0 0 24 24");
@@ -5796,26 +5945,11 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
   sectionId;
   rawContent;
   readOnly;
-  constructor(sectionIdOrProps, rawContent, readOnly = false) {
+  constructor(sectionId, rawContent, readOnly = false) {
     super();
-    if (typeof sectionIdOrProps === "string") {
-      this.sectionId = sectionIdOrProps;
-      this.rawContent = rawContent ?? "";
-      this.readOnly = readOnly;
-    } else {
-      this.sectionId = "legacy";
-      this.rawContent = wodWikiWql.serializeFrontmatter(sectionIdOrProps);
-      this.readOnly = readOnly;
-    }
-  }
-  get props() {
-    const body = this.rawContent.replace(/^---\r?\n?/, "").replace(/\r?\n?---\r?$/, "");
-    const meta = wodWikiWql.parseFrontmatterBody(body);
-    const result = {};
-    for (const [k, v] of Object.entries(meta)) {
-      result[k] = Array.isArray(v) ? v.join(", ") : String(v ?? "");
-    }
-    return result;
+    this.sectionId = sectionId;
+    this.rawContent = rawContent ?? "";
+    this.readOnly = readOnly;
   }
   eq(other) {
     return this.sectionId === other.sectionId && this.rawContent === other.rawContent && this.readOnly === other.readOnly;
@@ -5837,6 +5971,9 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
     const body = this.rawContent.replace(/^---\r?\n?/, "").replace(/\r?\n?---\r?$/, "");
     const meta = wodWikiWql.parseFrontmatterBody(body);
     const entries = Object.entries(meta);
+    const docKind = detectDefinitionKind(meta);
+    const referenceProvider = view.state.facet(frontmatterReferenceIndex)?.() ?? null;
+    const base = docKind === "effort" ? readBaseAttributes(body) : {};
     if (entries.length === 0) {
       const emptyRow = document.createElement("div");
       emptyRow.className = "px-3 py-2 text-xs text-muted-foreground/60 italic";
@@ -5845,13 +5982,16 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
     }
     for (const [key, value] of entries) {
       const isTags = isTagProperty(key);
+      const valueKind = referenceValueKind(key, docKind);
+      const isReferenceList = (isReferenceKey(key, docKind) || key === "aliases") && Array.isArray(value);
+      const nested = value === "" && ownsNestedBlock(body, key);
       const row = document.createElement("div");
       row.className = "flex items-center min-h-[34px] border-b border-dashed border-border/60 last:border-b-0 group hover:bg-muted/10 transition-colors max-[479px]:flex-col max-[479px]:items-stretch";
       box.appendChild(row);
       const keyCol = document.createElement("div");
       keyCol.className = "flex items-center gap-2 px-3 py-1.5 w-36 shrink-0 border-r border-dashed border-border/60 text-muted-foreground max-[479px]:w-auto max-[479px]:border-r-0 max-[479px]:border-b";
-      keyCol.appendChild(isTags ? createTagIcon() : createListIcon());
-      if (this.readOnly) {
+      keyCol.appendChild(isTags || isReferenceList ? createTagIcon() : createListIcon());
+      if (this.readOnly || nested) {
         const keyLabel = document.createElement("span");
         keyLabel.className = "truncate font-medium text-foreground/90";
         keyLabel.textContent = key;
@@ -5873,15 +6013,10 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
             keyInput.value = currentKey;
             return;
           }
-          const newMeta = {};
-          for (const [k, v] of Object.entries(meta)) {
-            if (k === currentKey) newMeta[nextKey] = v;
-            else newMeta[k] = v;
-          }
+          renamePropertyInView(view, this.sectionId, currentKey, nextKey, value);
           delete meta[currentKey];
-          meta[nextKey] = newMeta[nextKey];
+          meta[nextKey] = value;
           currentKey = nextKey;
-          updateFrontmatter(view, this.sectionId, newMeta);
         };
         const commitKeyIfAttached = () => queueMicrotask(() => {
           if (keyInput.isConnected) commitKey();
@@ -5910,71 +6045,117 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
       row.appendChild(keyCol);
       const valCol = document.createElement("div");
       valCol.className = "flex items-center flex-wrap gap-1.5 px-3 py-1.5 flex-1 min-w-0";
-      if (isTags) {
-        const tags7 = parseTagList(value);
-        for (let idx = 0; idx < tags7.length; idx++) {
-          const tag = tags7[idx];
+      const commitList = (next) => {
+        meta[key] = next;
+        patchPropertyInView(view, this.sectionId, [key], next.length > 0 ? next : "");
+      };
+      const refMatch = (token) => {
+        if (!referenceProvider) return null;
+        return valueKind === "effort" ? referenceProvider.resolveEffort(token) : valueKind === "equipment" ? referenceProvider.resolveEquipment(token) : null;
+      };
+      if (isTags || isReferenceList) {
+        const chips = parseTagList(value);
+        const chipIsReference = valueKind !== "tags";
+        for (let idx = 0; idx < chips.length; idx++) {
+          const chip = chips[idx];
+          const match = chipIsReference ? refMatch(chip) : null;
           const pill = document.createElement("span");
-          pill.className = "inline-flex items-center gap-1 px-2 py-0.5 rounded-md text-xs font-medium bg-amber-500/10 text-amber-800 dark:text-amber-300 border border-amber-500/20 dark:border-amber-500/30";
-          const tagText = document.createElement("span");
-          tagText.textContent = tag;
-          pill.appendChild(tagText);
+          pill.className = match ? "inline-flex items-center gap-1 px-2 py-0.5 rounded-md text-xs font-medium bg-muted/60 text-foreground border border-border/60" : chipIsReference ? "inline-flex items-center gap-1 px-2 py-0.5 rounded-md text-xs font-medium bg-destructive/10 text-destructive border border-destructive/30" : "inline-flex items-center gap-1 px-2 py-0.5 rounded-md text-xs font-medium bg-amber-500/10 text-amber-800 dark:text-amber-300 border border-amber-500/20 dark:border-amber-500/30";
+          const pillText = document.createElement("span");
+          pillText.textContent = match ? match.label : chip;
+          pill.appendChild(pillText);
+          if (match && referenceProvider) {
+            const openLink = document.createElement("a");
+            openLink.href = referenceProvider.openHref(valueKind, match.slug);
+            openLink.title = `Open ${match.label} page`;
+            openLink.setAttribute("aria-label", `Open ${match.label} page`);
+            openLink.className = "inline-flex items-center justify-center text-muted-foreground/60 hover:text-foreground cursor-pointer";
+            openLink.appendChild(createExternalIcon());
+            pill.appendChild(openLink);
+          }
           if (!this.readOnly) {
             const rmBtn = document.createElement("button");
             rmBtn.type = "button";
-            rmBtn.setAttribute("aria-label", `Remove tag ${tag}`);
-            rmBtn.className = "inline-flex items-center justify-center text-amber-700/60 hover:text-amber-950 dark:text-amber-400/60 dark:hover:text-amber-100 cursor-pointer";
+            rmBtn.setAttribute("aria-label", isTags ? `Remove tag ${chip}` : `Remove ${chip}`);
+            rmBtn.className = "inline-flex items-center justify-center text-muted-foreground/60 hover:text-foreground dark:hover:text-foreground cursor-pointer";
             rmBtn.appendChild(createCloseIcon("sm"));
             rmBtn.addEventListener("click", (e) => {
               e.preventDefault();
               e.stopPropagation();
-              const nextTags = tags7.filter((_, i) => i !== idx);
-              meta[key] = nextTags;
-              updateFrontmatter(view, this.sectionId, meta);
+              commitList(chips.filter((_, i) => i !== idx));
             });
             pill.appendChild(rmBtn);
           }
           valCol.appendChild(pill);
         }
         if (!this.readOnly) {
-          const tagInput = document.createElement("input");
-          tagInput.className = "flex-1 min-w-[70px] bg-transparent text-xs text-foreground outline-none px-1 py-0.5 placeholder:text-muted-foreground/40";
-          tagInput.placeholder = tags7.length === 0 ? "Add tags\u2026" : "Add tag\u2026";
-          tagInput.setAttribute("aria-label", `Add tag to ${key}`);
-          const commitNewTag = () => {
-            const val = tagInput.value.trim().replace(/^,|,$/g, "");
-            if (val && !tags7.some((tag) => tag.toLowerCase() === val.toLowerCase())) {
-              meta[key] = [...tags7, val];
-              tagInput.value = "";
+          const chipInput = document.createElement("input");
+          chipInput.className = "flex-1 min-w-[70px] bg-transparent text-xs text-foreground outline-none px-1 py-0.5 placeholder:text-muted-foreground/40";
+          chipInput.placeholder = chips.length === 0 ? isReferenceList ? `Add ${valueKind === "effort" ? "effort" : "equipment"}\u2026` : "Add tags\u2026" : isTags ? "Add tag\u2026" : "Add\u2026";
+          chipInput.setAttribute("aria-label", isTags ? `Add tag to ${key}` : `Add to ${key}`);
+          const commitNewChip = () => {
+            const val = chipInput.value.trim().replace(/^,|,$/g, "");
+            if (val && !chips.some((chip) => chip.toLowerCase() === val.toLowerCase())) {
+              chipInput.value = "";
               pendingFocus.set(view, { kind: "tag", key });
-              updateFrontmatter(view, this.sectionId, meta);
+              commitList([...chips, val]);
             }
           };
-          valCol.appendChild(tagInput);
-          attachSuggestions(tagInput, view, root, "value", key, tags7, commitNewTag);
-          tagInput.addEventListener("keydown", (e) => {
+          valCol.appendChild(chipInput);
+          attachSuggestions(chipInput, view, root, "value", key, chips, commitNewChip, valueKind);
+          chipInput.addEventListener("keydown", (e) => {
             if (e.defaultPrevented) return;
             if (e.key === "Enter" || e.key === ",") {
               e.preventDefault();
-              commitNewTag();
-            } else if (e.key === "Backspace" && !tagInput.value && tags7.length > 0) {
+              commitNewChip();
+            } else if (e.key === "Backspace" && !chipInput.value && chips.length > 0) {
               e.preventDefault();
-              meta[key] = tags7.slice(0, -1);
               pendingFocus.set(view, { kind: "tag", key });
-              updateFrontmatter(view, this.sectionId, meta);
+              commitList(chips.slice(0, -1));
             }
           });
-          tagInput.addEventListener("blur", () => queueMicrotask(() => {
-            if (tagInput.isConnected && tagInput.value.trim()) commitNewTag();
+          chipInput.addEventListener("blur", () => queueMicrotask(() => {
+            if (chipInput.isConnected && chipInput.value.trim()) commitNewChip();
           }));
           const focus = pendingFocus.get(view);
           if (focus?.kind === "tag" && focus.key === key) {
             setTimeout(() => {
-              if (tagInput.isConnected) tagInput.focus();
+              if (chipInput.isConnected) chipInput.focus();
             }, 0);
             pendingFocus.delete(view);
           }
+          if (chipIsReference && referenceProvider) {
+            const unknown = chips.filter((chip) => !refMatch(chip));
+            if (unknown.length > 0) {
+              const diag = document.createElement("div");
+              diag.setAttribute("data-testid", "editor-ref-unknown");
+              diag.className = "w-full basis-full flex flex-wrap items-center gap-2 text-[10px] text-destructive";
+              const label = document.createElement("span");
+              label.textContent = `Unknown ${valueKind === "effort" ? "effort" : "equipment"}: ${unknown.join(", ")}`;
+              diag.appendChild(label);
+              const selectBtn = document.createElement("button");
+              selectBtn.type = "button";
+              selectBtn.textContent = "Select existing";
+              selectBtn.className = "underline hover:text-foreground cursor-pointer";
+              selectBtn.addEventListener("click", (e) => {
+                e.preventDefault();
+                chipInput.focus();
+              });
+              diag.appendChild(selectBtn);
+              const createLink = document.createElement("a");
+              createLink.href = referenceProvider.createHref(valueKind);
+              createLink.textContent = "Create page";
+              createLink.className = "underline hover:text-foreground";
+              diag.appendChild(createLink);
+              valCol.appendChild(diag);
+            }
+          }
         }
+      } else if (nested) {
+        const valSpan = document.createElement("span");
+        valSpan.className = "text-xs text-muted-foreground/60 italic py-0.5 truncate";
+        valSpan.textContent = "Nested block \u2014 edit in YAML";
+        valCol.appendChild(valSpan);
       } else {
         const strVal = Array.isArray(value) ? value.join(", ") : String(value ?? "");
         if (this.readOnly) {
@@ -5994,8 +6175,9 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
             if (cur !== committedVal) {
               committedVal = cur;
               const num = Number(cur);
-              meta[key] = cur !== "" && !isNaN(num) ? num : cur;
-              updateFrontmatter(view, this.sectionId, meta);
+              const next = cur !== "" && !isNaN(num) ? num : cur;
+              meta[key] = next;
+              patchPropertyInView(view, this.sectionId, [key], next);
             }
           };
           const commitValIfAttached = () => queueMicrotask(() => {
@@ -6003,7 +6185,16 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
           });
           valInput.addEventListener("change", commitValIfAttached);
           valCol.appendChild(valInput);
-          attachSuggestions(valInput, view, root, "value", key, [strVal], commitVal);
+          attachSuggestions(
+            valInput,
+            view,
+            root,
+            "value",
+            key,
+            [strVal],
+            commitVal,
+            key.trim().toLowerCase() === "metrics.effort" ? "effort" : "tags"
+          );
           valInput.addEventListener("blur", commitValIfAttached);
           valInput.addEventListener("keydown", (e) => {
             if (e.defaultPrevented) return;
@@ -6012,6 +6203,34 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
               valInput.blur();
             }
           });
+          if (key.trim().toLowerCase() === "metrics.effort" && referenceProvider) {
+            const match = referenceProvider.resolveEffort(strVal);
+            if (match) {
+              const pill = document.createElement("span");
+              pill.className = "inline-flex items-center gap-1 px-2 py-0.5 rounded-md text-xs font-medium bg-muted/60 text-foreground border border-border/60 shrink-0";
+              const pillText = document.createElement("span");
+              pillText.textContent = match.label;
+              pill.appendChild(pillText);
+              const openLink = document.createElement("a");
+              openLink.href = referenceProvider.openHref("effort", match.slug);
+              openLink.title = `Open ${match.label} page`;
+              openLink.setAttribute("aria-label", `Open ${match.label} page`);
+              openLink.className = "inline-flex items-center justify-center text-muted-foreground/60 hover:text-foreground cursor-pointer";
+              openLink.appendChild(createExternalIcon());
+              pill.appendChild(openLink);
+              valCol.insertBefore(pill, valInput);
+              valInput.className = "flex-1 min-w-[70px] bg-transparent text-xs text-foreground outline-none py-0.5 hover:bg-muted/20 focus:bg-background focus:ring-1 focus:ring-ring rounded px-1 -mx-1 transition-colors";
+            }
+            const diag = renderEffortValueDiagnostics(
+              referenceProvider,
+              strVal,
+              (slug) => {
+                meta[key] = slug;
+                patchPropertyInView(view, this.sectionId, [key], slug);
+              }
+            );
+            if (diag) valCol.appendChild(diag);
+          }
         }
         if (/^https?:\/\/\S+$/i.test(strVal)) {
           const openLink = document.createElement("a");
@@ -6026,7 +6245,7 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
         }
       }
       row.appendChild(valCol);
-      if (!this.readOnly) {
+      if (!this.readOnly && !nested) {
         const actionsCol = document.createElement("div");
         actionsCol.className = "flex items-center pr-2";
         const delBtn = document.createElement("button");
@@ -6037,14 +6256,16 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
         delBtn.addEventListener("click", (e) => {
           e.preventDefault();
           e.stopPropagation();
-          const newMeta = { ...meta };
-          delete newMeta[key];
-          updateFrontmatter(view, this.sectionId, newMeta);
+          delete meta[key];
+          patchPropertyInView(view, this.sectionId, [key], null);
         });
         actionsCol.appendChild(delBtn);
         row.appendChild(actionsCol);
       }
     }
+    if (docKind === "effort" && !this.readOnly) {
+      box.appendChild(this.buildDefinitionRows(view, base));
+    }
     if (!this.readOnly) {
       const existingTagKey = entries.find(([key]) => isTagProperty(key))?.[0];
       const actionsRow = document.createElement("div");
@@ -6067,10 +6288,36 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
           newKey = `property_${count2}`;
         }
         pendingFocus.set(view, { kind: "key", key: newKey });
-        const newMeta = { ...meta, [newKey]: "" };
-        updateFrontmatter(view, this.sectionId, newMeta);
+        patchPropertyInView(view, this.sectionId, [newKey], "");
       });
       actionsRow.appendChild(addBtn);
+      {
+        const addMetricBtn = document.createElement("button");
+        addMetricBtn.type = "button";
+        addMetricBtn.setAttribute("aria-label", "Add metric");
+        addMetricBtn.setAttribute("data-testid", "editor-add-metric-note");
+        addMetricBtn.className = "inline-flex items-center gap-1.5 text-xs font-medium text-muted-foreground hover:text-foreground px-1 py-1 cursor-pointer transition-colors select-none";
+        addMetricBtn.appendChild(createPlusIcon());
+        const addMetricLabel = document.createElement("span");
+        addMetricLabel.textContent = "Add metric";
+        addMetricBtn.appendChild(addMetricLabel);
+        addMetricBtn.addEventListener("click", (e) => {
+          e.preventDefault();
+          e.stopPropagation();
+          const existing = root.querySelector("[data-frontmatter-metric-draft] input");
+          if (existing) {
+            existing.focus();
+            return;
+          }
+          const draftRow = createMetricDraftRow(view, root, referenceProvider, (path, value) => {
+            patchPropertyInView(view, this.sectionId, path, value);
+          });
+          box.appendChild(draftRow);
+          draftRow.querySelector("input")?.focus();
+          view.requestMeasure();
+        });
+        actionsRow.appendChild(addMetricBtn);
+      }
       {
         const addTagBtn = document.createElement("button");
         addTagBtn.type = "button";
@@ -6095,7 +6342,7 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
           }
           const draftRow = createTagDraftRow(view, root, "tags", (val) => {
             pendingFocus.set(view, { kind: "tag", key: "tags" });
-            updateFrontmatter(view, this.sectionId, { ...meta, tags: [val] });
+            patchPropertyInView(view, this.sectionId, ["tags"], [val]);
           });
           box.appendChild(draftRow);
           draftRow.querySelector("input")?.focus();
@@ -6107,6 +6354,7 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
         const editYamlBtn = document.createElement("button");
         editYamlBtn.type = "button";
         editYamlBtn.setAttribute("aria-label", "Edit YAML");
+        editYamlBtn.setAttribute("data-testid", "editor-property-edit-yaml");
         editYamlBtn.className = "inline-flex items-center gap-1.5 text-xs font-medium text-muted-foreground hover:text-foreground px-1 py-1 cursor-pointer transition-colors select-none";
         const editYamlLabel = document.createElement("span");
         editYamlLabel.textContent = "Edit YAML";
@@ -6126,6 +6374,82 @@ var DefaultFrontmatterWidget = class extends view.WidgetType {
     }
     return root;
   }
+  /**
+   * Effort-definition attribute rows (MET / discipline / intensity tier).
+   * Values live in the nested baseAttributes block; each edit patches that
+   * one path, so unknown sibling keys and comments elsewhere survive.
+   */
+  buildDefinitionRows(view, base) {
+    const wrap = document.createElement("div");
+    wrap.setAttribute("data-frontmatter-definition", "true");
+    wrap.className = "border-t border-dashed border-border/60";
+    const header = document.createElement("div");
+    header.className = "px-3 pt-2 text-[10px] font-semibold uppercase tracking-wide text-muted-foreground";
+    header.textContent = "Definition";
+    wrap.appendChild(header);
+    const commitField = (field, raw) => {
+      if (field === "met") {
+        const num = Number(raw);
+        patchPropertyInView(view, this.sectionId, ["baseAttributes", "met"], raw !== "" && !Number.isNaN(num) ? num : null);
+        return;
+      }
+      patchPropertyInView(view, this.sectionId, ["baseAttributes", field], raw === "" ? null : raw);
+    };
+    const fieldRow = (label, child) => {
+      const row = document.createElement("label");
+      row.className = "flex items-center gap-2 px-3 py-1.5 min-h-[34px] border-b border-dashed border-border/60 last:border-b-0 max-[479px]:flex-col max-[479px]:items-stretch";
+      const name = document.createElement("span");
+      name.className = "w-28 shrink-0 text-muted-foreground";
+      name.textContent = label;
+      row.appendChild(name);
+      child.className = "flex-1 min-w-0 bg-transparent text-xs text-foreground outline-none py-0.5";
+      row.appendChild(child);
+      wrap.appendChild(row);
+    };
+    const met = document.createElement("input");
+    met.type = "number";
+    met.step = "0.1";
+    met.inputMode = "decimal";
+    met.value = base.met ?? "";
+    met.setAttribute("aria-label", "MET value");
+    met.addEventListener("change", () => queueMicrotask(() => {
+      if (met.isConnected) commitField("met", met.value.trim());
+    }));
+    fieldRow("MET", met);
+    const discipline = document.createElement("select");
+    discipline.setAttribute("aria-label", "Discipline");
+    discipline.className = "flex-1 min-w-0 rounded-md border border-input bg-background px-1.5 text-[11px] text-muted-foreground outline-none";
+    const unset = document.createElement("option");
+    unset.value = "";
+    unset.textContent = "Unset";
+    discipline.appendChild(unset);
+    for (const option of wodWikiLang.EFFORT_DISCIPLINES) {
+      const opt = document.createElement("option");
+      opt.value = option;
+      opt.textContent = option;
+      discipline.appendChild(opt);
+    }
+    discipline.value = base.discipline ?? "";
+    discipline.addEventListener("change", () => commitField("discipline", discipline.value));
+    fieldRow("Discipline", discipline);
+    const tier = document.createElement("select");
+    tier.setAttribute("aria-label", "Intensity tier");
+    tier.className = "flex-1 min-w-0 rounded-md border border-input bg-background px-1.5 text-[11px] text-muted-foreground outline-none";
+    const tierUnset = document.createElement("option");
+    tierUnset.value = "";
+    tierUnset.textContent = "Unset";
+    tier.appendChild(tierUnset);
+    for (const option of ["low", "moderate", "high"]) {
+      const opt = document.createElement("option");
+      opt.value = option;
+      opt.textContent = option;
+      tier.appendChild(opt);
+    }
+    tier.value = base.intensityTier ?? "";
+    tier.addEventListener("change", () => commitField("intensityTier", tier.value));
+    fieldRow("Intensity tier", tier);
+    return wrap;
+  }
   destroy(dom) {
     widgetCleanup.get(dom)?.forEach((close) => close());
     widgetCleanup.delete(dom);
@@ -6159,7 +6483,7 @@ var EmptyFrontmatterWidget = class extends view.WidgetType {
       e.preventDefault();
       e.stopPropagation();
       pendingFocus.set(view, { kind: "key", key: "property" });
-      updateFrontmatter(view, "new", { property: "" });
+      patchPropertyInView(view, "new", ["property"], "");
     });
     actionsRow.appendChild(addBtn);
     const addTagBtn = document.createElement("button");
@@ -6180,7 +6504,7 @@ var EmptyFrontmatterWidget = class extends view.WidgetType {
       }
       const draftRow = createTagDraftRow(view, root, "tags", (val) => {
         pendingFocus.set(view, { kind: "tag", key: "tags" });
-        updateFrontmatter(view, "new", { tags: [val] });
+        patchPropertyInView(view, "new", ["tags"], [val]);
       });
       root.appendChild(draftRow);
       draftRow.querySelector("input")?.focus();
@@ -6234,7 +6558,7 @@ var frontmatterPreviewField = state.StateField.define({
     return buildFrontmatterDecos(state);
   },
   update(deco, tr) {
-    if (tr.docChanged || tr.reconfigured || tr.selection) {
+    if (tr.docChanged || tr.reconfigured || tr.selection || tr.effects.some((e) => e.is(referenceIndexReload))) {
       return buildFrontmatterDecos(tr.state);
     }
     return deco;
@@ -13025,13 +13349,13 @@ function editorPreset(optionsOrDialect = "markdown") {
 }
 
 // src/version.ts
-var VERSION = "0.37.2137";
-var GIT_SHA = "b82a721";
-var BUILD_TIME = "2026-10-16T20:56:02.597Z";
+var VERSION = "0.37.2140";
+var GIT_SHA = "bcf7960";
+var BUILD_TIME = "2026-10-18T21:43:29.081Z";
 var SEMVER = {
-  version: "0.37.2137",
-  gitSha: "b82a721",
-  buildTime: "2026-10-16T20:56:02.597Z"
+  version: "0.37.2140",
+  gitSha: "bcf7960",
+  buildTime: "2026-10-18T21:43:29.081Z"
 };
 
 Object.defineProperty(exports, "CONTENT_GROUPING_DIMENSIONS", {
@@ -13136,6 +13460,7 @@ exports.formatMMSS = formatMMSS;
 exports.formatTimestamp = formatTimestamp;
 exports.frontmatterPreview = frontmatterPreview;
 exports.frontmatterPreviewField = frontmatterPreviewField;
+exports.frontmatterReferenceIndex = frontmatterReferenceIndex;
 exports.frontmatterSuggestions = frontmatterSuggestions;
 exports.frontmatterVisibility = frontmatterVisibility;
 exports.getClauseMeta = getClauseMeta;
@@ -13168,6 +13493,7 @@ exports.previewDecorations = previewDecorations;
 exports.queryBlockPreview = queryBlockPreview;
 exports.readSessionRpe = readSessionRpe;
 exports.readStoredUnit = readStoredUnit;
+exports.referenceIndexReload = referenceIndexReload;
 exports.registerCustomCompletionSource = registerCustomCompletionSource;
 exports.registeredSectionWidgets = registeredSectionWidgets;
 exports.removeRuntimePanel = removeRuntimePanel;