@haklex/rich-ext-chat 0.4.1 → 0.6.0

package/README.md

@@ -0,0 +1,106 @@
+# @haklex/rich-ext-chat
+
+Static chat-snapshot blocks for assistant / conversation transcripts. Renders multi-participant message lists with variant-aware bubble styling.
+
+## Installation
+
+```bash
+pnpm add @haklex/rich-ext-chat
+```
+
+## Peer Dependencies
+
+| Package   | Version   |
+| --------- | --------- |
+| `lexical` | `^0.44.0` |
+| `react`   | `>= 19`   |
+
+## Usage
+
+### Register nodes
+
+Edit (read + write):
+
+```ts
+import { chatEditNodes } from '@haklex/rich-ext-chat/edit';
+
+const editorConfig = { nodes: [...chatEditNodes] };
+```
+
+Static / read-only:
+
+```ts
+import { chatNodes } from '@haklex/rich-ext-chat/node';
+
+const staticConfig = { nodes: [...chatNodes] };
+```
+
+### Use renderers
+
+```tsx
+import { ChatEditRenderer } from '@haklex/rich-ext-chat/edit';
+import { ChatRenderer } from '@haklex/rich-ext-chat/renderer';
+```
+
+### Tree-shake the default renderer
+
+```ts
+import { CHAT_NODE_KEY, chatNodes } from '@haklex/rich-ext-chat/node';
+import type { RichRendererModule } from '@haklex/rich-compose';
+
+const lightModule: RichRendererModule = {
+  name: 'chat',
+  nodes: chatNodes,
+  renderers: { [CHAT_NODE_KEY]: MyLightChat },
+};
+```
+
+### Import styles
+
+```ts
+import '@haklex/rich-ext-chat/style.css';
+```
+
+## Exports
+
+### Nodes
+
+- `ChatNode` -- static (read-only) node
+- `ChatEditNode` -- edit node
+- `$createChatNode()` / `$isChatNode()` -- Lexical helpers
+- `chatNodes` -- array of static nodes for config registration
+- `chatEditNodes` -- array of edit nodes for config registration
+
+### Renderers
+
+- `ChatRenderer` -- static renderer
+- `ChatEditRenderer` -- edit renderer with participant management
+
+### Slot Key
+
+- `CHAT_NODE_KEY` -- `'Chat'` constant for `RendererConfig` slot lookup
+
+### Types
+
+- `ChatMessage`, `ChatParticipant`, `ChatParticipantKind`, `ChatVariant`
+- `ChatRendererProps` (also flowed into `RendererConfig.Chat` via module augmentation)
+- `SerializedChatNode`
+
+## Sub-path Exports
+
+| Path                              | Description                                               |
+| --------------------------------- | --------------------------------------------------------- |
+| `@haklex/rich-ext-chat`           | Full exports (node + renderer + edit)                     |
+| `@haklex/rich-ext-chat/node`      | Lightweight node + slot key + types — no default renderer |
+| `@haklex/rich-ext-chat/renderer`  | Default `ChatRenderer` (heavy)                            |
+| `@haklex/rich-ext-chat/edit`      | Edit-mode node + `ChatEditRenderer`                       |
+| `@haklex/rich-ext-chat/static`    | Convenience: node + renderer (SSR bundle)                 |
+| `@haklex/rich-ext-chat/style.css` | Stylesheet                                                |
+
+## Part of Haklex
+
+This package is part of the [Haklex](../../README.md) rich editor ecosystem.
+
+## License
+
+MIT

package/dist/ChatNode-DIZ2_6jG.js

@@ -0,0 +1,163 @@
+import { DecoratorNode } from "lexical";
+import { customAlphabet } from "nanoid";
+import { createRendererDecoration } from "@haklex/rich-editor/renderers";
+//#region src/utils.ts
+var idAlphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
+var makeParticipantId = customAlphabet(idAlphabet, 6);
+var makeMessageId = customAlphabet(idAlphabet, 8);
+function createParticipantId() {
+	return `p_${makeParticipantId()}`;
+}
+function createMessageId() {
+	return `m_${makeMessageId()}`;
+}
+function createDefaultParticipants(variant) {
+	if (variant === "user-agent") return [{
+		id: createParticipantId(),
+		kind: "user"
+	}, {
+		id: createParticipantId(),
+		kind: "agent"
+	}];
+	return [{
+		id: createParticipantId(),
+		kind: "user"
+	}, {
+		id: createParticipantId(),
+		kind: "user"
+	}];
+}
+//#endregion
+//#region src/slot.ts
+/**
+* RendererConfig slot key for `@haklex/rich-ext-chat`.
+*
+* Override modules should reference this constant instead of the bare string
+* literal so renames stay searchable across the workspace.
+*/
+var CHAT_NODE_KEY = "Chat";
+//#endregion
+//#region \0@oxc-project+runtime@0.127.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.127.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.127.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.127.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+//#endregion
+//#region src/nodes/ChatNode.ts
+var ChatNode = class ChatNode extends DecoratorNode {
+	static getType() {
+		return "chat";
+	}
+	static clone(node) {
+		return new ChatNode({
+			variant: node.__variant,
+			participants: node.__participants,
+			messages: node.__messages
+		}, node.__key);
+	}
+	constructor(payload, key) {
+		super(key);
+		_defineProperty(this, "__variant", void 0);
+		_defineProperty(this, "__participants", void 0);
+		_defineProperty(this, "__messages", void 0);
+		this.__variant = payload.variant;
+		this.__participants = payload.participants && payload.participants.length > 0 ? payload.participants : createDefaultParticipants(payload.variant);
+		this.__messages = payload.messages ?? [];
+	}
+	createDOM(_config) {
+		const div = document.createElement("div");
+		div.className = "rich-chat-wrapper";
+		return div;
+	}
+	updateDOM() {
+		return false;
+	}
+	isInline() {
+		return false;
+	}
+	getVariant() {
+		return this.getLatest().__variant;
+	}
+	setVariant(variant) {
+		const writable = this.getWritable();
+		writable.__variant = variant;
+	}
+	getParticipants() {
+		return this.getLatest().__participants;
+	}
+	setParticipants(participants) {
+		const writable = this.getWritable();
+		writable.__participants = participants;
+	}
+	getMessages() {
+		return this.getLatest().__messages;
+	}
+	setMessages(messages) {
+		const writable = this.getWritable();
+		writable.__messages = messages;
+	}
+	static importJSON(serializedNode) {
+		return new ChatNode({
+			variant: serializedNode.variant,
+			participants: serializedNode.participants,
+			messages: serializedNode.messages
+		});
+	}
+	exportJSON() {
+		return {
+			...super.exportJSON(),
+			type: "chat",
+			variant: this.__variant,
+			participants: this.__participants,
+			messages: this.__messages,
+			version: 1
+		};
+	}
+	decorate(_editor, _config) {
+		return createRendererDecoration(CHAT_NODE_KEY, void 0, {
+			variant: this.__variant,
+			participants: this.__participants,
+			messages: this.__messages
+		});
+	}
+};
+function $createChatNode(payload) {
+	return new ChatNode(payload);
+}
+function $isChatNode(node) {
+	return node instanceof ChatNode;
+}
+//#endregion
+export { CHAT_NODE_KEY as a, _defineProperty as i, $isChatNode as n, createMessageId as o, ChatNode as r, $createChatNode as t };

package/dist/{ChatNode-D4OK247K.js → ChatRenderer-DYZpPFed.js}

@@ -1,9 +1,6 @@
-import { DecoratorNode } from "lexical";
-import { customAlphabet } from "nanoid";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { code } from "@streamdown/code";
 import { Streamdown } from "streamdown";
-import { createRendererDecoration } from "@haklex/rich-editor/renderers";
 //#region src/styles.css.ts
 var container = "_7z1aq60";
 var row = "_7z1aq61";
@@ -68,33 +65,6 @@ var button = "_7z1aq61b";
 var buttonPrimary = "_7z1aq61c";
 var buttonGhost = "_7z1aq61d";
 //#endregion
-//#region src/utils.ts
-var idAlphabet = "abcdefghijklmnopqrstuvwxyz0123456789";
-var makeParticipantId = customAlphabet(idAlphabet, 6);
-var makeMessageId = customAlphabet(idAlphabet, 8);
-function createParticipantId() {
-	return `p_${makeParticipantId()}`;
-}
-function createMessageId() {
-	return `m_${makeMessageId()}`;
-}
-function createDefaultParticipants(variant) {
-	if (variant === "user-agent") return [{
-		id: createParticipantId(),
-		kind: "user"
-	}, {
-		id: createParticipantId(),
-		kind: "agent"
-	}];
-	return [{
-		id: createParticipantId(),
-		kind: "user"
-	}, {
-		id: createParticipantId(),
-		kind: "user"
-	}];
-}
-//#endregion
 //#region src/ChatRenderer.tsx
 var streamdownPlugins = { code };
 var UNKNOWN = {
@@ -215,127 +185,4 @@ var ChatRenderer = ({ variant, participants, messages }) => {
 	});
 };
 //#endregion
-//#region \0@oxc-project+runtime@0.127.0/helpers/typeof.js
-function _typeof(o) {
-	"@babel/helpers - typeof";
-	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
-		return typeof o;
-	} : function(o) {
-		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-	}, _typeof(o);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.127.0/helpers/toPrimitive.js
-function toPrimitive(t, r) {
-	if ("object" != _typeof(t) || !t) return t;
-	var e = t[Symbol.toPrimitive];
-	if (void 0 !== e) {
-		var i = e.call(t, r || "default");
-		if ("object" != _typeof(i)) return i;
-		throw new TypeError("@@toPrimitive must return a primitive value.");
-	}
-	return ("string" === r ? String : Number)(t);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.127.0/helpers/toPropertyKey.js
-function toPropertyKey(t) {
-	var i = toPrimitive(t, "string");
-	return "symbol" == _typeof(i) ? i : i + "";
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.127.0/helpers/defineProperty.js
-function _defineProperty(e, r, t) {
-	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-		value: t,
-		enumerable: !0,
-		configurable: !0,
-		writable: !0
-	}) : e[r] = t, e;
-}
-//#endregion
-//#region src/nodes/ChatNode.ts
-var ChatNode = class ChatNode extends DecoratorNode {
-	static getType() {
-		return "chat";
-	}
-	static clone(node) {
-		return new ChatNode({
-			variant: node.__variant,
-			participants: node.__participants,
-			messages: node.__messages
-		}, node.__key);
-	}
-	constructor(payload, key) {
-		super(key);
-		_defineProperty(this, "__variant", void 0);
-		_defineProperty(this, "__participants", void 0);
-		_defineProperty(this, "__messages", void 0);
-		this.__variant = payload.variant;
-		this.__participants = payload.participants && payload.participants.length > 0 ? payload.participants : createDefaultParticipants(payload.variant);
-		this.__messages = payload.messages ?? [];
-	}
-	createDOM(_config) {
-		const div = document.createElement("div");
-		div.className = "rich-chat-wrapper";
-		return div;
-	}
-	updateDOM() {
-		return false;
-	}
-	isInline() {
-		return false;
-	}
-	getVariant() {
-		return this.getLatest().__variant;
-	}
-	setVariant(variant) {
-		const writable = this.getWritable();
-		writable.__variant = variant;
-	}
-	getParticipants() {
-		return this.getLatest().__participants;
-	}
-	setParticipants(participants) {
-		const writable = this.getWritable();
-		writable.__participants = participants;
-	}
-	getMessages() {
-		return this.getLatest().__messages;
-	}
-	setMessages(messages) {
-		const writable = this.getWritable();
-		writable.__messages = messages;
-	}
-	static importJSON(serializedNode) {
-		return new ChatNode({
-			variant: serializedNode.variant,
-			participants: serializedNode.participants,
-			messages: serializedNode.messages
-		});
-	}
-	exportJSON() {
-		return {
-			...super.exportJSON(),
-			type: "chat",
-			variant: this.__variant,
-			participants: this.__participants,
-			messages: this.__messages,
-			version: 1
-		};
-	}
-	decorate(_editor, _config) {
-		return createRendererDecoration("Chat", ChatRenderer, {
-			variant: this.__variant,
-			participants: this.__participants,
-			messages: this.__messages
-		});
-	}
-};
-function $createChatNode(payload) {
-	return new ChatNode(payload);
-}
-function $isChatNode(node) {
-	return node instanceof ChatNode;
-}
-//#endregion
-export { participantPillUser as A, modalFooter as C, participantInput as D, participantCard as E, variantPill as F, variantPillActive as I, variantPillHint as L, rail as M, sectionLabel as N, participantLabel as O, semanticClassNames as P, variantPillName as R, modalBody as S, pane as T, messageCard as _, ChatRenderer as a, messageTextarea as b, addMessageButton as c, buttonPrimary as d, editContainer as f, messageActions as g, editorDialogPopup as h, _defineProperty as i, participantRow as j, participantPill as k, button as l, editOverlay as m, $isChatNode as n, createMessageId as o, editLabel as p, ChatNode as r, addMessage as s, $createChatNode as t, buttonGhost as u, messageHead as v, modalHeader as w, modal as x, messageSelect as y, variantStack as z };
+export { variantPill as A, participantLabel as C, rail as D, participantRow as E, variantPillHint as M, variantPillName as N, sectionLabel as O, variantStack as P, participantInput as S, participantPillUser as T, modalBody as _, buttonGhost as a, pane as b, editLabel as c, messageActions as d, messageCard as f, modal as g, messageTextarea as h, button as i, variantPillActive as j, semanticClassNames as k, editOverlay as l, messageSelect as m, addMessage as n, buttonPrimary as o, messageHead as p, addMessageButton as r, editContainer as s, ChatRenderer as t, editorDialogPopup as u, modalFooter as v, participantPill as w, participantCard as x, modalHeader as y };

package/dist/augment.d.ts

@@ -0,0 +1,9 @@
+import { ComponentType } from 'react';
+import { ChatRendererProps } from './types';
+declare module '@haklex/rich-editor' {
+    interface RendererConfig {
+        Chat?: ComponentType<ChatRendererProps>;
+    }
+}
+export {};
+//# sourceMappingURL=augment.d.ts.map

package/dist/augment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.d.ts","sourceRoot":"","sources":["../src/augment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,cAAc;QACtB,IAAI,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;KACzC;CACF;AAED,OAAO,EAAE,CAAC"}