@intentface/chat 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The minimal part contract. Every part has a `type`; parts this package does
+ * not understand (e.g. `step-start`, `dynamic-tool`, future additions) are
+ * carried through untouched.
+ */
+export type UnknownPart = {
+    type: string;
+};
+export type TextPart = {
+    type: "text";
+    text: string;
+    state?: "streaming" | "done";
+};
+export type ReasoningPart = {
+    type: "reasoning";
+    text: string;
+    state?: "streaming" | "done";
+};
+export type FilePart = {
+    type: "file";
+    mediaType: string;
+    url: string;
+    filename?: string;
+};
+export type SourceUrlPart = {
+    type: "source-url";
+    sourceId: string;
+    url: string;
+    title?: string;
+};
+export type ToolPartState = "input-streaming" | "input-available" | "output-available" | "output-error";
+export type ToolPart<Input = unknown, Output = unknown> = {
+    type: `tool-${string}`;
+    toolCallId: string;
+    state: ToolPartState;
+    input?: Input;
+    output?: Output;
+    errorText?: string;
+};
+export type DataPart = {
+    type: `data-${string}`;
+    id?: string;
+    data?: unknown;
+};
+export type MessagePart = TextPart | ReasoningPart | FilePart | SourceUrlPart | ToolPart | DataPart | UnknownPart;
+export type ChatMessage<Metadata = unknown, Part extends UnknownPart = MessagePart> = {
+    id: string;
+    role: string;
+    metadata?: Metadata;
+    parts: Part[];
+};
+/** Structurally identical to the AI SDK's `ChatStatus`. */
+export type ChatStatus = "submitted" | "streaming" | "ready" | "error";
+export declare const isTextPart: (part: UnknownPart) => part is TextPart;
+export declare const isReasoningPart: (part: UnknownPart) => part is ReasoningPart;
+export declare const isFilePart: (part: UnknownPart) => part is FilePart;
+export declare const isSourceUrlPart: (part: UnknownPart) => part is SourceUrlPart;
+export declare const isToolPart: (part: UnknownPart) => part is ToolPart;

package/dist/types.js

@@ -0,0 +1,17 @@
+// Structural message contract. These types are deliberately framework- and
+// SDK-agnostic: an AI SDK `UIMessage` satisfies `ChatMessage` structurally, so
+// no adapter or translation layer is needed. Extend via the generics.
+// ---------------------------------------------------------------------------
+// Ask-user contract
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Part guards
+//
+// `UnknownPart` sits in the `MessagePart` union, so a raw discriminant check
+// (`part.type === "text"`) cannot narrow. Use these guards instead.
+// ---------------------------------------------------------------------------
+export const isTextPart = (part) => part.type === "text";
+export const isReasoningPart = (part) => part.type === "reasoning";
+export const isFilePart = (part) => part.type === "file";
+export const isSourceUrlPart = (part) => part.type === "source-url";
+export const isToolPart = (part) => part.type.startsWith("tool-") && "state" in part && "toolCallId" in part;

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@intentface/chat",
+  "version": "0.1.0",
+  "description": "Headless chat UI primitives — unstyled compound components, hooks, and wire formats for building AI chat interfaces.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "author": "Intentface",
+  "homepage": "https://intentface.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Intentface/intentface-chat.git",
+    "directory": "packages/chat"
+  },
+  "bugs": {
+    "url": "https://github.com/Intentface/intentface-chat/issues"
+  },
+  "keywords": [
+    "react",
+    "chat",
+    "ai",
+    "headless",
+    "ui",
+    "components",
+    "composer",
+    "ai-sdk"
+  ],
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./composer": {
+      "types": "./dist/composer/index.d.ts",
+      "default": "./dist/composer/index.js"
+    },
+    "./chip": {
+      "types": "./dist/chip/index.d.ts",
+      "default": "./dist/chip/index.js"
+    },
+    "./thread": {
+      "types": "./dist/thread/index.d.ts",
+      "default": "./dist/thread/index.js"
+    },
+    "./reasoning": {
+      "types": "./dist/reasoning/index.d.ts",
+      "default": "./dist/reasoning/index.js"
+    },
+    "./steps": {
+      "types": "./dist/steps/index.d.ts",
+      "default": "./dist/steps/index.js"
+    },
+    "./attachments": {
+      "types": "./dist/attachments/index.d.ts",
+      "default": "./dist/attachments/index.js"
+    },
+    "./ask-user": {
+      "types": "./dist/ask-user/index.d.ts",
+      "default": "./dist/ask-user/index.js"
+    },
+    "./message": {
+      "types": "./dist/message/index.d.ts",
+      "default": "./dist/message/index.js"
+    },
+    "./message-utils": {
+      "types": "./dist/message-utils.d.ts",
+      "default": "./dist/message-utils.js"
+    },
+    "./chip-markdown": {
+      "types": "./dist/chip-markdown.d.ts",
+      "default": "./dist/chip-markdown.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/add-dist-extensions.mjs",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepack": "bun run build && node scripts/swap-exports.mjs pre",
+    "postpack": "node scripts/swap-exports.mjs post"
+  },
+  "dependencies": {
+    "@floating-ui/dom": "^1.7.6",
+    "nanoid": "^5.1.11"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^20.10.6",
+    "@testing-library/react": "^16.3.2",
+    "@types/bun": "^1",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "axe-core": "^4.12.1",
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}