@matterfact/embed 0.12.0 → 0.15.0

package/dist/index.cjs

@@ -466,7 +466,7 @@ function mfTools(win) {
   if (typeof document2 === "function") {
     out.push({
       name: "mf.resolveDocument",
-      description: 'Resolve a matterfact document (dossier, report, briefing) that is NOT on the current page to a concrete id. Call it with the document type and a key (e.g. a ticker) when the site map shows the document lives on another route. Returns {id, label, href}. Cite the result inline as <MFRef kind="document" id="<id>" label="<label>" /> \u2014 it renders as a chip that opens the document in the side panel; href is its "open on page" deeplink.',
+      description: `Resolve a matterfact document (dossier, report, briefing) that is NOT on the current page to a concrete id. Call it with the document type and the subject's key, when the site map shows the document lives on another route. For the key, use the current route parameter VERBATIM when the page context states one (e.g. ticker = BP~+LN+Equity \u2192 key "BP~+LN+Equity"): it is the host's own identifier and often differs from the ticker or name a person would write. Do not normalise, decode or re-spell it, and do not substitute what the user typed. Returns {id, label, href}. Cite the result inline as <MFRef kind="document" id="<id>" label="<label>" /> \u2014 it renders as a chip that opens the document in the side panel; href is its "open on page" deeplink.`,
       inputSchema: {
         type: "object",
         properties: {
@@ -1171,6 +1171,7 @@ async function resolveDeclaredContext() {
 async function publishContext() {
   if (!pageContextOn()) return;
   const declared = await resolveDeclaredContext();
+  if (!pageContextOn()) return;
   send?.({ type: "host.context", context: buildPageContext(declared) });
 }
 function provideContext() {
@@ -1248,6 +1249,7 @@ function navigateHost(href) {
   location.assign(target.href);
 }
 function pushActivity(e) {
+  if (!allowsAuto(effectivePageContextMode())) return;
   activity.push({ ...e, seq: ++activitySeq, ts: Date.now() });
   if (activity.length > MAX_ACTIVITY) activity.shift();
   send?.({ type: "host.activity", events: [activity[activity.length - 1]] });
@@ -1312,6 +1314,7 @@ function watchNavigation() {
     publishSitemap();
     publishTools();
   };
+  if (navFire) return;
   navFire = fire;
   for (const name of ["pushState", "replaceState"]) {
     const orig = history[name];
@@ -1381,6 +1384,7 @@ async function sendSnapshot(emit) {
     return;
   }
   const { snapshot: snapshot2 } = await loadSnapshotModule();
+  if (!allowsAuto(effectivePageContextMode())) return;
   const { yaml, truncated, visibleRefs } = snapshot2();
   emit({
     type: "host.snapshot",
@@ -1392,6 +1396,7 @@ async function sendSnapshot(emit) {
 async function sendRegion(ref, emit) {
   if (!allowsAuto(effectivePageContextMode())) return;
   const { snapshotRegion: snapshotRegion2, resolveRef: resolveRef2 } = await loadSnapshotModule();
+  if (!allowsAuto(effectivePageContextMode())) return;
   const el = resolveRef2(ref);
   if (!el) {
     emit({
@@ -1431,13 +1436,39 @@ async function callTool(call, emit) {
     error: r.error
   });
 }
-function stop() {
+function installAutoObservers() {
+  document.addEventListener("click", onClick, { capture: true, passive: true });
+  document.addEventListener("submit", onSubmit, {
+    capture: true,
+    passive: true
+  });
+  document.addEventListener("change", onChange, {
+    capture: true,
+    passive: true
+  });
+  document.addEventListener("selectionchange", scheduleFocus, { passive: true });
+  document.addEventListener("focusin", scheduleFocus, {
+    capture: true,
+    passive: true
+  });
+  window.addEventListener("scroll", scheduleFocus, {
+    capture: true,
+    passive: true
+  });
+}
+function removeAutoObservers() {
   document.removeEventListener("click", onClick, { capture: true });
   document.removeEventListener("submit", onSubmit, { capture: true });
   document.removeEventListener("change", onChange, { capture: true });
   document.removeEventListener("selectionchange", scheduleFocus);
   document.removeEventListener("focusin", scheduleFocus, { capture: true });
   window.removeEventListener("scroll", scheduleFocus, { capture: true });
+  if (focusTimer) {
+    clearTimeout(focusTimer);
+    focusTimer = null;
+  }
+}
+function unwatchNavigation() {
   if (navFire) {
     window.removeEventListener("popstate", navFire);
     navFire = null;
@@ -1450,10 +1481,10 @@ function stop() {
     history.replaceState = origReplaceState;
     origReplaceState = null;
   }
-  if (focusTimer) {
-    clearTimeout(focusTimer);
-    focusTimer = null;
-  }
+}
+function stop() {
+  removeAutoObservers();
+  unwatchNavigation();
   send = null;
   contextProvider = void 0;
   activity.length = 0;
@@ -1463,6 +1494,22 @@ function stop() {
 }
 function setPageContextMax(max) {
   adminPageContextMax = parsePageContextMode(max);
+  applyObservation();
+}
+function applyObservation() {
+  const mode = effectivePageContextMode();
+  if (allowsAuto(mode)) {
+    installAutoObservers();
+  } else {
+    removeAutoObservers();
+    activity.length = 0;
+    lastFocus = {};
+  }
+  if (allowsDeclared(mode)) {
+    watchNavigation();
+  } else {
+    unwatchNavigation();
+  }
 }
 function start(emit, origin, pageContext = true, provider) {
   stop();
@@ -1475,33 +1522,8 @@ function start(emit, origin, pageContext = true, provider) {
     void publishContext();
     publishArtifactGrants();
     publishSitemap();
-    watchNavigation();
-    if (allowsAuto(effectivePageContextMode())) {
-      document.addEventListener("click", onClick, {
-        capture: true,
-        passive: true
-      });
-      document.addEventListener("submit", onSubmit, {
-        capture: true,
-        passive: true
-      });
-      document.addEventListener("change", onChange, {
-        capture: true,
-        passive: true
-      });
-      document.addEventListener("selectionchange", scheduleFocus, {
-        passive: true
-      });
-      document.addEventListener("focusin", scheduleFocus, {
-        capture: true,
-        passive: true
-      });
-      window.addEventListener("scroll", scheduleFocus, {
-        capture: true,
-        passive: true
-      });
-    }
   }
+  applyObservation();
   const theme = matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
   emit({ type: "host.theme", mode: theme });
   {
@@ -2207,6 +2229,13 @@ var EmbedHost = class {
       case "widget.chat":
         this.emit({ type: "chat", phase: msg.phase, chatId: msg.chatId });
         break;
+      case "widget.artifactParams":
+        this.emit({
+          type: "artifactParams",
+          params: msg.params,
+          source: msg.source
+        });
+        break;
     }
   }
   /**
@@ -2352,6 +2381,23 @@ var EmbedHost = class {
     this.queue = [];
     for (const m of pending) this.send(m);
   }
+  /**
+   * Push artifact param values into the widget — a PARTIAL patch; only the named
+   * params change. Buffered like every other host→widget message until the widget
+   * says it's listening.
+   *
+   * Explicit and deliberate, so it applies even to a param whose page-context binding
+   * the viewer has overridden (spec §7.3).
+   */
+  setArtifactParams(params) {
+    if (params == null || typeof params !== "object" || Array.isArray(params)) {
+      console.error(
+        "[matterfact] setArtifactParams expects an object of param values"
+      );
+      return;
+    }
+    this.send({ type: "host.artifactParams", params });
+  }
   /** Tear down: stop listening and remove the host element. For the React wrapper's
    * unmount — the vanilla `<script>` loader lives for the page's lifetime and never
    * calls this. */
@@ -2369,6 +2415,10 @@ var EmbedHost = class {
 function mount(config) {
   const host = new EmbedHost(config);
   host.mount();
+  window.matterfact = {
+    ...window.matterfact ?? {},
+    setArtifactParams: (params) => host.setArtifactParams(params)
+  };
   return host;
 }