@matterfact/embed 0.12.0 → 0.13.0

package/dist/react.d.cts

@@ -108,7 +108,30 @@ interface ToolEvent {
  *  - `chat`         — a chat-turn moment. Content-free: phase + opaque chatId only.
  *  - `tool`         — a host-tool lifecycle event (the `ToolEvent` shape, tagged). Also
  *    still delivered untagged to the legacy `onToolEvent` hook for back-compat.
+ *  - `artifactParams` — an artifact param changed in the widget.
  */
+/**
+ * A value an artifact param can carry. Mirrors the app's `ParamValue`
+ * (`enum` / `enum[]` / `entity` / `date` / `daterange` / `boolean` / `number`)
+ * DELIBERATELY BY COPY, not by import: this is a wire contract between two
+ * independently-deployed artifacts, and a shared type would let a rename
+ * compile on both sides while still breaking the wire. Bump PROTOCOL_VERSION
+ * instead. See this file's header.
+ */
+type ArtifactParamValue = string | string[] | number | boolean
+/** `daterange`: a [from, to] pair of YYYY-MM-DD strings. */
+ | [string, string];
+/**
+ * Artifact params on the wire, keyed by declared param name.
+ *
+ * Values are typed but NOT verified against the artifact's declared spec —
+ * a host can send anything, and the widget's param store coerces each value
+ * to its declared type (or drops it) on arrival. This type says what a
+ * well-behaved host means to send, not what the widget trusts it to have sent.
+ */
+type ArtifactParams = {
+    [name: string]: ArtifactParamValue;
+};
 type MatterfactEvent = {
     type: 'ready';
 } | {
@@ -130,7 +153,11 @@ type MatterfactEvent = {
     chatId?: string;
 } | ({
     type: 'tool';
-} & ToolEvent);
+} & ToolEvent) | {
+    type: 'artifactParams';
+    params: ArtifactParams;
+    source: 'user' | 'context';
+};
 
 /**
  * The Hoist adapter — a pure transform from a `HoistRuntime` (already read out of

package/dist/react.d.ts

@@ -108,7 +108,30 @@ interface ToolEvent {
  *  - `chat`         — a chat-turn moment. Content-free: phase + opaque chatId only.
  *  - `tool`         — a host-tool lifecycle event (the `ToolEvent` shape, tagged). Also
  *    still delivered untagged to the legacy `onToolEvent` hook for back-compat.
+ *  - `artifactParams` — an artifact param changed in the widget.
  */
+/**
+ * A value an artifact param can carry. Mirrors the app's `ParamValue`
+ * (`enum` / `enum[]` / `entity` / `date` / `daterange` / `boolean` / `number`)
+ * DELIBERATELY BY COPY, not by import: this is a wire contract between two
+ * independently-deployed artifacts, and a shared type would let a rename
+ * compile on both sides while still breaking the wire. Bump PROTOCOL_VERSION
+ * instead. See this file's header.
+ */
+type ArtifactParamValue = string | string[] | number | boolean
+/** `daterange`: a [from, to] pair of YYYY-MM-DD strings. */
+ | [string, string];
+/**
+ * Artifact params on the wire, keyed by declared param name.
+ *
+ * Values are typed but NOT verified against the artifact's declared spec —
+ * a host can send anything, and the widget's param store coerces each value
+ * to its declared type (or drops it) on arrival. This type says what a
+ * well-behaved host means to send, not what the widget trusts it to have sent.
+ */
+type ArtifactParams = {
+    [name: string]: ArtifactParamValue;
+};
 type MatterfactEvent = {
     type: 'ready';
 } | {
@@ -130,7 +153,11 @@ type MatterfactEvent = {
     chatId?: string;
 } | ({
     type: 'tool';
-} & ToolEvent);
+} & ToolEvent) | {
+    type: 'artifactParams';
+    params: ArtifactParams;
+    source: 'user' | 'context';
+};
 
 /**
  * The Hoist adapter — a pure transform from a `HoistRuntime` (already read out of

package/dist/react.js

@@ -613,6 +613,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;
     }
   }
   /**
@@ -739,7 +746,7 @@ var EmbedHost = class {
     }
   }
   loadContext() {
-    this.context ?? (this.context = import("./context-ZSPDZWIB.js").then((m) => {
+    this.context ?? (this.context = import("./context-IJK345PN.js").then((m) => {
       m.start(
         this.send,
         this.config.origin,
@@ -758,6 +765,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. */
@@ -775,6 +799,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;
 }