@ai-matrx/messaging 0.3.0 → 0.4.0

package/dist/react.d.cts

@@ -828,6 +828,17 @@ interface MessageActionRenderer<TPayload = unknown> {
 type ReferenceRenderer = ComponentType<{
     reference: MatrxReference;
 }>;
+/**
+ * A host's renderer for a raw ```matrx fence — the body between the backticks.
+ *
+ * This package understands one fence dialect: its own. A platform's fences are
+ * its platform's business (Matrx's are `__kind` directive shells resolved
+ * through a kind registry), and only the app can draw them. Give us this and
+ * EVERY fence in a message goes to you, parsed or not.
+ */
+type FenceRenderer = ComponentType<{
+    body: string;
+}>;
 /**
  * App chrome wrapped around ONE message bubble or ONE conversation row.
  *
@@ -858,6 +869,7 @@ interface MessagingHost {
     /** Host surfaces for action kinds whose answer is a card, not a chip. */
     readonly actionRenderers: ReadonlyMap<string, MessageActionRenderer>;
     readonly renderReference: ReferenceRenderer | null;
+    readonly renderFence: FenceRenderer | null;
     readonly wrapMessage: ComponentType<MessageWrapperProps> | null;
     readonly wrapConversationRow: ComponentType<ConversationRowWrapperProps> | null;
 }
@@ -889,6 +901,8 @@ interface MessagingProviderProps {
     onOpenReference?: ((reference: MatrxReference) => void) | undefined;
     /** Draw references with the app's own renderer instead of the package card. */
     renderReference?: ReferenceRenderer | undefined;
+    /** Draw ```matrx fences with the app's own renderer — every fence, parsed or not. */
+    renderFence?: FenceRenderer | undefined;
     /** App chrome (a right-click menu, a drop target) around each message bubble. */
     wrapMessage?: ComponentType<MessageWrapperProps> | undefined;
     /** App chrome around each conversation row. */
@@ -1077,11 +1091,6 @@ declare function Avatar(props: {
 declare function DeliveryTick(props: {
     state: DeliveryState;
 }): React.ReactElement | null;
-/**
- * A reference card. NO DEAD ENDS: when the host wired `onOpenReference` it is a
- * button that opens; when it did not, it renders as a labeled, non-interactive
- * card with a title explaining why — never a button that does nothing.
- */
 declare function ReferenceCard(props: {
     reference: MatrxReference;
     onOpen?: ((reference: MatrxReference) => void) | null;
@@ -1363,6 +1372,20 @@ type TextSegment = {
 } | {
     readonly type: "reference";
     readonly reference: MatrxReference;
+}
+/**
+ * A ```matrx fence this package could not resolve into references.
+ *
+ * It is NOT dropped. Platforms carry richer fence dialects than this
+ * package's own array shape — Matrx's is a `__kind` directive shell whose
+ * items are typed per noun, resolvable only by the app's kind registry — and
+ * a fence silently deleted on render is a message that lost a paragraph
+ * between the sender and the reader. The host draws it (`renderFence`), or
+ * the package draws an honest inert card. Never a code block of JSON.
+ */
+ | {
+    readonly type: "fence";
+    readonly body: string;
 };
 /** Every reference a message carries, from both transports, de-duplicated. */
 declare function extractReferences(content: string, structured?: readonly MatrxReference[]): readonly MatrxReference[];

package/dist/react.d.ts

@@ -828,6 +828,17 @@ interface MessageActionRenderer<TPayload = unknown> {
 type ReferenceRenderer = ComponentType<{
     reference: MatrxReference;
 }>;
+/**
+ * A host's renderer for a raw ```matrx fence — the body between the backticks.
+ *
+ * This package understands one fence dialect: its own. A platform's fences are
+ * its platform's business (Matrx's are `__kind` directive shells resolved
+ * through a kind registry), and only the app can draw them. Give us this and
+ * EVERY fence in a message goes to you, parsed or not.
+ */
+type FenceRenderer = ComponentType<{
+    body: string;
+}>;
 /**
  * App chrome wrapped around ONE message bubble or ONE conversation row.
  *
@@ -858,6 +869,7 @@ interface MessagingHost {
     /** Host surfaces for action kinds whose answer is a card, not a chip. */
     readonly actionRenderers: ReadonlyMap<string, MessageActionRenderer>;
     readonly renderReference: ReferenceRenderer | null;
+    readonly renderFence: FenceRenderer | null;
     readonly wrapMessage: ComponentType<MessageWrapperProps> | null;
     readonly wrapConversationRow: ComponentType<ConversationRowWrapperProps> | null;
 }
@@ -889,6 +901,8 @@ interface MessagingProviderProps {
     onOpenReference?: ((reference: MatrxReference) => void) | undefined;
     /** Draw references with the app's own renderer instead of the package card. */
     renderReference?: ReferenceRenderer | undefined;
+    /** Draw ```matrx fences with the app's own renderer — every fence, parsed or not. */
+    renderFence?: FenceRenderer | undefined;
     /** App chrome (a right-click menu, a drop target) around each message bubble. */
     wrapMessage?: ComponentType<MessageWrapperProps> | undefined;
     /** App chrome around each conversation row. */
@@ -1077,11 +1091,6 @@ declare function Avatar(props: {
 declare function DeliveryTick(props: {
     state: DeliveryState;
 }): React.ReactElement | null;
-/**
- * A reference card. NO DEAD ENDS: when the host wired `onOpenReference` it is a
- * button that opens; when it did not, it renders as a labeled, non-interactive
- * card with a title explaining why — never a button that does nothing.
- */
 declare function ReferenceCard(props: {
     reference: MatrxReference;
     onOpen?: ((reference: MatrxReference) => void) | null;
@@ -1363,6 +1372,20 @@ type TextSegment = {
 } | {
     readonly type: "reference";
     readonly reference: MatrxReference;
+}
+/**
+ * A ```matrx fence this package could not resolve into references.
+ *
+ * It is NOT dropped. Platforms carry richer fence dialects than this
+ * package's own array shape — Matrx's is a `__kind` directive shell whose
+ * items are typed per noun, resolvable only by the app's kind registry — and
+ * a fence silently deleted on render is a message that lost a paragraph
+ * between the sender and the reader. The host draws it (`renderFence`), or
+ * the package draws an honest inert card. Never a code block of JSON.
+ */
+ | {
+    readonly type: "fence";
+    readonly body: string;
 };
 /** Every reference a message carries, from both transports, de-duplicated. */
 declare function extractReferences(content: string, structured?: readonly MatrxReference[]): readonly MatrxReference[];

package/dist/react.js

@@ -222,21 +222,32 @@ function splitText(content) {
     if (start > cursor) {
       segments.push({ type: "text", value: content.slice(cursor, start) });
     }
-    parseFenceBody(match[1] ?? "").forEach((reference) => {
-      segments.push({ type: "reference", reference });
-    });
+    const body = match[1] ?? "";
+    const references = parseFenceBody(body);
+    if (references.length === 0) {
+      segments.push({ type: "fence", body });
+    } else {
+      references.forEach((reference) => {
+        segments.push({ type: "reference", reference });
+      });
+    }
     cursor = start + match[0].length;
   }
   if (cursor < content.length) {
     segments.push({ type: "text", value: content.slice(cursor) });
   }
   return segments.filter(
-    (segment) => segment.type === "reference" || segment.value.trim().length > 0
+    (segment) => segment.type !== "text" || segment.value.trim().length > 0
   );
 }
 function summarizeText(content, maxLength = 140) {
   const parts = splitText(content).map(
-    (segment) => segment.type === "text" ? segment.value : segment.reference.label
+    (segment) => segment.type === "text" ? segment.value : segment.type === "reference" ? segment.reference.label : (
+      // A fence we cannot read still SAYS something. Collapsing it to
+      // nothing is how a reference-only message becomes an inbox row that
+      // reads "No messages yet" — a screen telling a lie.
+      "Reference"
+    )
   );
   const flattened = parts.join(" ").replace(/\s+/g, " ").trim();
   if (flattened.length <= maxLength) return flattened;
@@ -1794,6 +1805,7 @@ function MessagingRuntime(props) {
     return map;
   }, [renderers]);
   const renderReference = props.renderReference ?? null;
+  const renderFence = props.renderFence ?? null;
   const wrapMessage = props.wrapMessage ?? null;
   const wrapConversationRow = props.wrapConversationRow ?? null;
   const host = useMemo(() => {
@@ -1806,10 +1818,20 @@ function MessagingRuntime(props) {
       openReference: referenceRef.current ?? null,
       actionRenderers: rendererMap,
       renderReference,
+      renderFence,
       wrapMessage,
       wrapConversationRow
     };
-  }, [engine, actionRegistry, ai, rendererMap, renderReference, wrapMessage, wrapConversationRow]);
+  }, [
+    engine,
+    actionRegistry,
+    ai,
+    rendererMap,
+    renderReference,
+    renderFence,
+    wrapMessage,
+    wrapConversationRow
+  ]);
   const MessagingContext = messagingContext();
   return /* @__PURE__ */ jsx(MessagingContext.Provider, { value: host, children });
 }
@@ -2400,6 +2422,20 @@ function DeliveryTick(props) {
       return null;
   }
 }
+function UnreadableReference() {
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: "mx-msg__reference mx-msg__reference--inert",
+      title: "This message names something in a reference format this app has not wired. Pass renderFence to <MessagingProvider> to render it.",
+      children: [
+        /* @__PURE__ */ jsx3(LinkIcon, {}),
+        /* @__PURE__ */ jsx3("span", { className: "mx-msg__reference-type", children: "reference" }),
+        "Reference"
+      ]
+    }
+  );
+}
 function ReferenceCard(props) {
   const { reference, onOpen } = props;
   const href = reference.href;
@@ -2764,6 +2800,7 @@ function MessageBubble(props) {
   const { message, isMine } = props;
   const host = useMessagingHost();
   const HostReference = host?.renderReference ?? null;
+  const HostFence = host?.renderFence ?? null;
   const MessageChrome = host?.wrapMessage ?? null;
   if (message.deletedAt !== null) {
     return /* @__PURE__ */ jsx4("div", { className: "mx-msg__bubble mx-msg__bubble--deleted", children: "Message deleted" });
@@ -2778,7 +2815,7 @@ function MessageBubble(props) {
   const bubble = /* @__PURE__ */ jsxs2(Fragment, { children: [
     /* @__PURE__ */ jsxs2("div", { className: classes, children: [
       splitText(message.content).map(
-        (segment, index) => segment.type === "text" ? /* @__PURE__ */ jsx4("span", { children: segment.value }, index) : HostReference !== null ? /* @__PURE__ */ jsx4(
+        (segment, index) => segment.type === "text" ? /* @__PURE__ */ jsx4("span", { children: segment.value }, index) : segment.type === "fence" ? HostFence !== null ? /* @__PURE__ */ jsx4(HostFence, { body: segment.body }, `fence:${index}`) : /* @__PURE__ */ jsx4(UnreadableReference, {}, `fence:${index}`) : HostReference !== null ? /* @__PURE__ */ jsx4(
           HostReference,
           {
             reference: segment.reference