@itechchoice/prime-chatkit 0.1.0-alpha.0

package/dist/types/ui/blocks/useFollowLatest.d.ts

@@ -0,0 +1,20 @@
+export type OlderMessages = {
+    hasMore: boolean;
+    loading: boolean;
+    onLoad: () => void;
+};
+/** Layout glue: only follow while the reader remains at the bottom. */
+export declare function useFollowLatest({ messages, older, active }: {
+    messages: readonly {
+        id: string;
+    }[];
+    older?: OlderMessages;
+    active?: boolean;
+}): {
+    viewport: import("react").RefObject<HTMLDivElement | null>;
+    content: import("react").RefObject<HTMLDivElement | null>;
+    away: boolean;
+    onScroll: () => void;
+    jump: () => void;
+    loadOlder: () => void;
+};

package/dist/types/ui/history.d.ts

@@ -0,0 +1,10 @@
+import type { SessionSummary } from "../adapters/bff/client";
+import type { CommandGroup } from "../components/ui/command-menu-clean";
+import type { HistoryCopy } from "./i18n";
+/** Preserve server order within local-calendar groups; ids always stay strings. */
+export declare function historyGroups(items: SessionSummary[], opts: {
+    now: number;
+    copy: HistoryCopy;
+    editingId?: string;
+    confirmingId?: string;
+}): CommandGroup[];

package/dist/types/ui/i18n.d.ts

@@ -0,0 +1,203 @@
+import type { ChatComposerLabels } from "../components/ui/chat-composer-clean";
+import type { ToolCallLabels } from "../components/ui/tool-call-card-clean";
+/** Copy used only by the view-model → thread mapping. */
+export type ThreadCopy = {
+    preparing: (tools?: number, mcpServers?: number) => string;
+    prepared: (tools?: number, mcpServers?: number) => string;
+    thinking: (iteration: number) => string;
+    toolFallback: (name: string) => string;
+    emptyAnswer: string;
+    failedAnswer: string;
+};
+export declare const zhThreadCopy: ThreadCopy;
+export declare const enThreadCopy: ThreadCopy;
+export declare const zhComposerLabels: ChatComposerLabels;
+export declare const zhToolCallLabels: ToolCallLabels;
+type ThreadLabels = {
+    composer?: Partial<ChatComposerLabels>;
+    toolCall?: Partial<ToolCallLabels>;
+};
+export declare const zhThreadLabels: {
+    composer: {
+        placeholder: string;
+        requestApproval: string;
+        requestApprovalDescription: string;
+        approveForMe: string;
+        approveForMeDescription: string;
+        fullAccess: string;
+        fullAccessDescription: string;
+        add: string;
+        files: string;
+        attachClaude: string;
+        workInFolder: string;
+        chooseFolder: string;
+        goal: string;
+        goalDescription: string;
+        planMode: string;
+        planOnDescription: string;
+        recordSkill: string;
+        draw: string;
+        drawDescription: string;
+        plugins: string;
+        documents: string;
+        documentsDescription: string;
+        pdf: string;
+        pdfDescription: string;
+        noFolder: string;
+        planOff: string;
+        planOn: string;
+        recording: string;
+        recordingAdded: string;
+        recordingDiscarded: string;
+        messageSent: string;
+        composer: string;
+        message: string;
+        voiceInput: string;
+        sendMessage: string;
+        discardRecording: string;
+        useRecording: string;
+        connectApps: string;
+        addToChat: string;
+        planOffDescription: string;
+        approvalQuestion: string;
+        learnMore: string;
+        selectModel: string;
+        apps: string;
+        workingIn: (folder: string) => string;
+        appConnection: (name: string | undefined, connected: boolean) => string;
+        selected: (name: string | undefined) => string;
+        connectedCount: (n: number) => string;
+    };
+    toolCall: {
+        failed: string;
+        error: string;
+        retry: string;
+        arguments: string;
+        result: string;
+        waiting: string;
+        empty: string;
+        showAll: string;
+        showLess: string;
+        copied: string;
+        copyArguments: string;
+        copyResult: string;
+        running: (name: string) => string;
+        finished: (name: string) => string;
+        failedAnnouncement: (name: string, error?: string) => string;
+        duration: (ms: number, live: boolean) => string;
+        usingTools: string;
+        usedTools: (n: number) => string;
+        failedTools: (n: number) => string;
+        groupAnnouncement: (count: string, failed: number) => string;
+    };
+};
+export declare function threadLabelsFor(locale?: string): {
+    labels: ThreadLabels;
+    copy: ThreadCopy;
+    locale: string;
+};
+export type PanelCopy = {
+    credits: (balance: number, locale: string) => string;
+    history: string;
+    newChat: string;
+    switchLayout: string;
+    close: string;
+    placeholder: string;
+    unavailable: string;
+    provisionTitle: string;
+    provisionAction: string;
+};
+export declare const zhPanelCopy: PanelCopy;
+export declare const enPanelCopy: PanelCopy;
+export declare function panelCopyFor(locale?: string): PanelCopy;
+/** All interface copy for suspension decisions and controller errors. */
+export type HitlCopy = {
+    approvalQuestion: (tool: string) => string;
+    approvalQuestionGeneric: string;
+    approvalTask: string;
+    factTool: string;
+    factCapability: string;
+    questionsTask: string;
+    skip: string;
+    errorText: (code: string, status?: number) => string;
+};
+export declare const zhHitlCopy: HitlCopy;
+export declare const enHitlCopy: HitlCopy;
+export declare function hitlCopyFor(locale?: string): HitlCopy;
+/** Dock/split shell copy is independent of the panel dictionary. */
+export type ShellCopy = {
+    resizeHandle: string;
+    resizeCorner: string;
+    restore: string;
+    restoreText: string;
+};
+export declare function shellCopyFor(locale?: string): ShellCopy;
+type HistoryErrorCode = NonNullable<NonNullable<import("../adapters/bff/controller").ControllerState["sessions"]>["error"]>["code"];
+export type HistoryCopy = {
+    today: string;
+    older: string;
+    untitled: string;
+    rename: string;
+    delete: string;
+    confirmDelete: string;
+    cancel: string;
+    search: string;
+    loading: string;
+    empty: string;
+    errorText: (code: HistoryErrorCode) => string;
+};
+export declare const zhHistoryCopy: HistoryCopy;
+export declare const enHistoryCopy: HistoryCopy;
+export declare function historyCopyFor(locale?: string): HistoryCopy;
+export declare const zhHistoryLabels: import("../components/ui/command-menu-clean").CommandMenuLabels;
+export declare function historyLabelsFor(locale?: string): Partial<import("../components/ui/command-menu-clean").CommandMenuLabels>;
+/** Copy for the blocks panel and its library components. */
+import { type AIAnswerLabels } from "../components/ui/ai-answer-clean";
+import { type DropzoneLabels } from "../components/ui/dropzone-clean";
+export type BlocksCopy = {
+    attachments: {
+        dropzone: DropzoneLabels;
+        collapse: string;
+        closePreview: string;
+        downloadFailed: string;
+        waitUploads: string;
+        fixUploads: string;
+    };
+    answer: Partial<AIAnswerLabels>;
+    latest: string;
+    loadOlder: string;
+    conversation: string;
+    pendingQuestion: string;
+    stop: string;
+    stopped: string;
+    retry: string;
+    approve: string;
+    decline: string;
+    approveAlways: string;
+    process: string;
+    steps: (n: number) => string;
+    runningSteps: (n: number) => string;
+    waiting: string;
+    arguments: string;
+    feedbackReasons: string[];
+    decision: import("../components/ui/decision-card-clean").DecisionCardLabels;
+    questions: {
+        yes: string;
+        no: string;
+        openLink: string;
+        waiting: string;
+        waitingApproval: (tool?: string) => string;
+        waitingFor: (who?: string) => string;
+        numberPlaceholder: string;
+        invalidNumber: string;
+        invalidInteger: string;
+        resubmit: string;
+        refill: string;
+        cancel: string;
+    };
+    trail: Omit<import("../components/ui/agent-trail-clean").AgentTrailLabels, "count" | "duration"> & Partial<import("../components/ui/agent-trail-clean").AgentTrailLabels>;
+};
+export declare const zhBlocksCopy: BlocksCopy;
+export declare const enBlocksCopy: BlocksCopy;
+export declare function blocksCopyFor(locale?: string): BlocksCopy;
+export {};

package/dist/types/ui/start-icons.d.ts

@@ -0,0 +1,2 @@
+import { type ReactElement } from "react";
+export declare function startIcon(name?: string): ReactElement | undefined;

package/dist/types/ui/thread.d.ts

@@ -0,0 +1,71 @@
+import type { ChatMessage } from "../core/types";
+import type { ThreadCopy } from "./i18n";
+/** View-model shapes shared by the mapping and the blocks panel. */
+export type ThreadTool = {
+    id: string;
+    label: string;
+    name?: string;
+    args?: unknown;
+    result?: unknown;
+    error?: string;
+    status: "running" | "done" | "failed" | "stopped";
+    startedAt?: number;
+    ms?: number;
+};
+export type ThreadDecision = {
+    id: string;
+    question: string;
+    task: string;
+    kind?: "decision" | "pick" | "approval" | "question";
+    options?: {
+        id: string;
+        title: string;
+        summary?: string;
+    }[];
+    facts?: {
+        label: string;
+        value: string;
+    }[];
+};
+export type ThreadPart = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "tools";
+    id: string;
+    tools: ThreadTool[];
+} | {
+    kind: "decision";
+    ask: ThreadDecision;
+} | {
+    kind: "artifacts";
+    names: string[];
+} | {
+    kind: "error";
+    text: string;
+    retry?: boolean;
+};
+export type ThreadAgentMessage = {
+    id: string;
+    role: "agent";
+    at: number;
+    parts: ThreadPart[];
+    streaming?: boolean;
+    stopped?: boolean;
+};
+export type ThreadMessage = ThreadAgentMessage | {
+    id: string;
+    role: "user";
+    text: string;
+    at: number;
+    attachments?: {
+        id: string;
+        name: string;
+        size: number;
+        kind: "image" | "file";
+    }[];
+};
+export declare function toThreadMessages(messages: ChatMessage[], copy: ThreadCopy, options?: {
+    processView?: "full" | "replies";
+}): ThreadMessage[];
+export declare function toDecisions(messages: ChatMessage[]): ThreadDecision[];

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@itechchoice/prime-chatkit",
+  "version": "0.1.0-alpha.0",
+  "description": "PrimeChatKit: React chat UI for products built on the prime-chatkit SDK BFF contract. Shows the agent's work: thinking, tool calls, approvals, sources and cost.",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "type": "module",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": ["dist"],
+  "sideEffects": ["*.css"],
+  "scripts": {
+    "dev": "vite --config vite.demo.config.ts",
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "typecheck": "node scripts/check-charter.mjs && tsc --noEmit",
+    "test": "vitest run && node --test scripts/check-charter.test.mjs scripts/check-workorder-assertions.test.mjs scripts/shell-hygiene.test.mjs"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "dependencies": {
+    "@hugeicons/core-free-icons": "^4.4.0",
+    "@hugeicons/react": "^1.1.10",
+    "react-markdown": "^10.1.0",
+    "remark-cjk-friendly": "^2.3.4",
+    "remark-gfm": "^4.0.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "^26.6.6",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^5.2.0",
+    "jsdom": "^31.0.0",
+    "playwright": "1.63.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.3.1",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.7",
+    "vitest": "^4.1.12"
+  }
+}