neeter 0.6.0

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { ComponentType } from "react";
+export interface SSEEvent {
+    event: string;
+    data: string;
+}
+export interface CustomEvent<T = unknown> {
+    name: string;
+    value: T;
+}
+export type ToolCallPhase = "pending" | "streaming_input" | "running" | "complete" | "error";
+export interface ToolCallInfo {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+    partialInput?: string;
+    result?: string;
+    error?: string;
+    status: ToolCallPhase;
+}
+export interface ChatMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    thinking?: string;
+    toolCalls?: ToolCallInfo[];
+}
+export interface WidgetProps<TResult = unknown> {
+    phase: ToolCallPhase;
+    toolUseId: string;
+    input: Record<string, unknown>;
+    partialInput?: string;
+    result?: TResult;
+    error?: string;
+}
+export interface WidgetRegistration<TResult = unknown> {
+    toolName: string;
+    label: string;
+    richLabel?: (result: TResult, input: Record<string, unknown>) => string | null;
+    inputRenderer?: ComponentType<{
+        input: Record<string, unknown>;
+    }>;
+    component: ComponentType<WidgetProps<TResult>>;
+}
+export interface ToolApprovalRequest {
+    kind: "tool_approval";
+    requestId: string;
+    toolName: string;
+    toolUseId?: string;
+    input: Record<string, unknown>;
+    description?: string;
+}
+export interface UserQuestionOption {
+    label: string;
+    description?: string;
+}
+export interface UserQuestion {
+    question: string;
+    header?: string;
+    options?: UserQuestionOption[];
+    multiSelect?: boolean;
+}
+export interface UserQuestionRequest {
+    kind: "user_question";
+    requestId: string;
+    questions: UserQuestion[];
+}
+export type PermissionRequest = ToolApprovalRequest | UserQuestionRequest;
+export interface ToolApprovalResponse {
+    kind: "tool_approval";
+    requestId: string;
+    behavior: "allow" | "deny";
+    message?: string;
+}
+export interface UserQuestionResponse {
+    kind: "user_question";
+    requestId: string;
+    answers: Record<string, string>;
+}
+export type PermissionResponse = ToolApprovalResponse | UserQuestionResponse;

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "neeter",
+  "version": "0.6.0",
+  "description": "React + Hono toolkit for building chat UIs on top of the Claude Agent SDK",
+  "license": "MIT",
+  "author": "Dan Leeper",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quantumleeps/neeter.git"
+  },
+  "homepage": "https://github.com/quantumleeps/neeter#readme",
+  "bugs": {
+    "url": "https://github.com/quantumleeps/neeter/issues"
+  },
+  "keywords": [
+    "claude",
+    "agent-sdk",
+    "react",
+    "hono",
+    "sse",
+    "chat-ui",
+    "anthropic"
+  ],
+  "packageManager": "pnpm@10.22.0",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./theme.css": "./src/theme.css"
+  },
+  "files": [
+    "dist",
+    "src/theme.css"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "check": "biome check src/",
+    "prepare": "lefthook install",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.4.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.2.0",
+    "hono": ">=4.0.0",
+    "react": ">=18.0.0",
+    "react-markdown": ">=10.0.0",
+    "zustand": ">=5.0.0",
+    "immer": ">=10.0.0"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "latest",
+    "@biomejs/biome": "^2.3.14",
+    "@types/react": "^19.2.7",
+    "hono": "^4.11.9",
+    "lefthook": "^2.1.1",
+    "immer": "^11.1.4",
+    "react": "^19.2.0",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.18",
+    "zustand": "^5.0.11"
+  }
+}

package/src/theme.css

@@ -0,0 +1,170 @@
+/*
+ * neeter/theme.css — default theme for neeter components.
+ *
+ * Provides the CSS variable bridge (via @theme inline) and a neutral color
+ * palette so neeter components render correctly out of the box.
+ *
+ * If your app already uses shadcn/ui you don't need this file — neeter
+ * components use only standard shadcn variables plus Tailwind's built-in
+ * color palette (amber, emerald, blue) for status indicators.
+ *
+ * Usage (non-shadcn apps):
+ *   @import "neeter/theme.css";
+ */
+
+/* -- Source scanning ------------------------------------------------------- */
+/* Tells Tailwind to scan neeter's component source for utility classes. */
+
+@source "./react";
+
+/* -- Tailwind v4 variable bridge ------------------------------------------ */
+/* Maps CSS custom properties to Tailwind utility classes.                     */
+/* Same mappings as shadcn/tailwind.css — if you have that, skip this file.   */
+
+@theme inline {
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-warning: var(--warning);
+  --color-success: var(--success);
+  --color-info: var(--info);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+}
+
+/* -- Light mode (default) ------------------------------------------------- */
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --warning: oklch(0.795 0.184 86.047);
+  --success: oklch(0.723 0.219 149.579);
+  --info: oklch(0.623 0.214 259.815);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+}
+
+/* -- Dark mode (class-based) ---------------------------------------------- */
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --warning: oklch(0.852 0.199 91.936);
+  --success: oklch(0.792 0.209 151.711);
+  --info: oklch(0.707 0.165 254.624);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+}
+
+/* -- Dark mode (system preference) ---------------------------------------- */
+/* Activates automatically unless .light is set on :root.                     */
+
+@media (prefers-color-scheme: dark) {
+  :root:not(.light) {
+    --background: oklch(0.145 0 0);
+    --foreground: oklch(0.985 0 0);
+    --card: oklch(0.205 0 0);
+    --card-foreground: oklch(0.985 0 0);
+    --popover: oklch(0.205 0 0);
+    --popover-foreground: oklch(0.985 0 0);
+    --primary: oklch(0.922 0 0);
+    --primary-foreground: oklch(0.205 0 0);
+    --secondary: oklch(0.269 0 0);
+    --secondary-foreground: oklch(0.985 0 0);
+    --muted: oklch(0.269 0 0);
+    --muted-foreground: oklch(0.708 0 0);
+    --accent: oklch(0.269 0 0);
+    --accent-foreground: oklch(0.985 0 0);
+    --destructive: oklch(0.704 0.191 22.216);
+    --warning: oklch(0.852 0.199 91.936);
+    --success: oklch(0.792 0.209 151.711);
+    --info: oklch(0.707 0.165 254.624);
+    --border: oklch(1 0 0 / 10%);
+    --input: oklch(1 0 0 / 15%);
+    --ring: oklch(0.556 0 0);
+  }
+}
+
+/* -- Base resets ---------------------------------------------------------- */
+
+*,
+*::before,
+*::after {
+  border-color: var(--border);
+}
+
+body {
+  background-color: var(--background);
+  color: var(--foreground);
+}
+
+/* -- Scrollbar styling --------------------------------------------------- */
+
+* {
+  scrollbar-color: var(--muted-foreground) transparent;
+  scrollbar-width: thin;
+}
+
+::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--muted-foreground);
+  border-radius: 3px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--foreground);
+}