@digithings-ai/digichat-ui 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# @digithings-ai/digichat-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared digichat CSS and helpers: the `.dc-*` session grammar, the caret styles,
+the slash palette, the brand mark and the transcript markdown export.
+
+It is **not** a session shell. digichat 2.0 renders its session through the
+stock `assistant-ui` Thread in `apps/digichat`; parents (digithings-web, the
+dashboard popup, `widget.js`) embed digichat through `/embed`. The transcript
+helpers live in `@digithings-ai/ui/chat/transcript` and are re-exported here.
+
+| Entry | What it is |
+|---|---|
+| `@digithings-ai/digichat-ui` | `DigiChatMark`, the slash-command helpers, the transcript helpers |
+| `@digithings-ai/digichat-ui/styles/session.css` | The `.dc-*` session grammar |
+| `@digithings-ai/digichat-ui/styles/cursor.css` | The caret and keyframe tokens |
+
+```tsx
+import { DigiChatMark } from "@digithings-ai/digichat-ui";
+import "@digithings-ai/digichat-ui/styles/session.css";
+```
+
+[`ARCHITECTURE.md`](ARCHITECTURE.md) has the module map and the public API
+contract.
+
+## Publishing
+
+This package is published to npm as part of the digithings R0 release. Its
+`exports` point at **TypeScript source** and raw CSS, not a build output, so the
+published tarball is the same code the workspace consumes.
+
+A Next.js consumer must therefore transpile it — add the package to
+`transpilePackages` in `next.config.mjs`:
+
+```js
+const nextConfig = {
+  transpilePackages: ["@digithings-ai/digichat-ui", "@digithings-ai/ui"],
+};
+```
+
+A bundler that already compiles TS (Vite, tsup, Bun) resolves the source
+directly and needs no extra configuration. `react` and `react-dom` are peers.
+
+Tests: `npm test --workspace @digithings-ai/digichat-ui`.

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@digithings-ai/digichat-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Shared digichat CSS, slash helpers, brand marks, and transcript markdown. digichat 2.0 session UI is the stock assistant-ui Thread in apps/digichat; parents iframe /embed; backends are digigraph | foundry.",
+  "license": "MIT",
+  "homepage": "https://digithings.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/digithings-ai/digithings.git",
+    "directory": "packages/digichat-ui"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./styles/session.css": "./src/styles/session.css",
+    "./styles/cursor.css": "./src/styles/cursor.css"
+  },
+  "files": [
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "lint": "eslint ."
+  },
+  "peerDependencies": {
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4"
+  },
+  "dependencies": {
+    "@digithings-ai/ui": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.0"
+  }
+}

package/src/components/DigiChatMark.tsx

@@ -0,0 +1,31 @@
+export function DigiChatMark({ size = 18, title }: { size?: number; title?: string }) {
+  return (
+    <svg
+      viewBox="0 0 56 56"
+      width={size}
+      height={size}
+      fill="none"
+      role={title ? "img" : undefined}
+      aria-hidden={title ? undefined : true}
+      aria-label={title}
+    >
+      {title ? <title>{title}</title> : null}
+      <rect x="5" y="8" width="46" height="33" rx="10" stroke="currentColor" strokeWidth="2.6" />
+      <path
+        d="M17 41 L17 50 L28 41"
+        stroke="currentColor"
+        strokeWidth="2.6"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+      <path
+        d="M16 18 L23 24.5 L16 31"
+        stroke="currentColor"
+        strokeWidth="2.6"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+      <rect x="27" y="29" width="12" height="2.6" rx="1.3" fill="currentColor" />
+    </svg>
+  );
+}

package/src/components/DocumentPane.tsx

@@ -0,0 +1,62 @@
+"use client";
+
+import { IconButton } from "@digithings-ai/ui/ui";
+
+import { MiniMarkdown } from "./MiniMarkdown";
+import { readableSnippet, type VaultHitSummary } from "@digithings-ai/ui/chat/transcript";
+
+function isHttpUrl(path: string): boolean {
+  return /^https?:\/\//i.test(path);
+}
+
+function isPdfPath(path: string): boolean {
+  return /\.pdf(\?|#|$)/i.test(path);
+}
+
+/**
+ * Side pane for an original document (#3419). Paths without an http(s) URL
+ * never become links — vault notes render from `body` loaded via get_note.
+ */
+export function DocumentPane({
+  hit,
+  onClose,
+}: {
+  hit: VaultHitSummary;
+  onClose: () => void;
+}) {
+  const http = isHttpUrl(hit.path);
+  const pdf = http && isPdfPath(hit.path);
+  const markdown = hit.body?.trim() || "";
+  return (
+    <aside className="dc-doc-pane" aria-label="Document">
+      <header className="dc-doc-pane-head">
+        <strong className="dc-doc-pane-title">{hit.title}</strong>
+        <IconButton className="dc-doc-pane-close" onClick={onClose} aria-label="Close document">
+          ×
+        </IconButton>
+      </header>
+      {http ? (
+        <p className="dc-doc-pane-path">
+          <a href={hit.path} target="_blank" rel="noreferrer noopener">
+            Download
+          </a>
+        </p>
+      ) : hit.path && hit.path !== hit.title ? (
+        <p className="dc-doc-pane-path">{hit.path}</p>
+      ) : null}
+      {pdf ? (
+        <object data={hit.path} type="application/pdf" className="dc-doc-pane-frame" title={hit.title}>
+          <p>PDF preview is unavailable in this browser.</p>
+        </object>
+      ) : markdown ? (
+        <div className="dc-doc-pane-body">
+          <MiniMarkdown text={markdown} />
+        </div>
+      ) : hit.snippet ? (
+        <p className="dc-doc-pane-snippet">{readableSnippet(hit.snippet)}</p>
+      ) : (
+        <p className="dc-doc-pane-empty">No preview available.</p>
+      )}
+    </aside>
+  );
+}

package/src/components/MiniMarkdown.tsx

@@ -0,0 +1,9 @@
+import { ChatMarkdown } from "@digithings-ai/ui";
+
+/**
+ * Thin delegate to `@digithings-ai/ui` `ChatMarkdown` (`.chat-md`).
+ * An edit here lands on digichat `/embed` and digithings.ai/chat together.
+ */
+export function MiniMarkdown({ text }: { text: string }) {
+  return <ChatMarkdown source={text} />;
+}

package/src/index.ts

@@ -0,0 +1,91 @@
+export { DigiChatMark } from "./components/DigiChatMark";
+export { MiniMarkdown } from "./components/MiniMarkdown";
+export { DocumentPane } from "./components/DocumentPane";
+export {
+  toCanonRows,
+  outcomeMeta,
+  citationHits,
+  readableSnippet,
+  toolDisplayName,
+  stripFoundryCitationMarkers,
+  type CanonActivityRow,
+} from "@digithings-ai/ui/chat/transcript";
+export {
+  serializeAssistantMarkdown,
+  serializeThreadMarkdown,
+  copyMarkdownWithFallback,
+  downloadMarkdown,
+  downloadTextFile,
+  downloadPlainText,
+  downloadHtml,
+  markdownToPlainText,
+  markdownToHtmlDocument,
+  truncateForMailto,
+  buildMailtoUrl,
+  buildAnswerMailto,
+  buildThreadMailto,
+  openMailtoWithFallback,
+  printTranscriptWithFallback,
+  MAILTO_MAX_ENCODED_LEN,
+  MAILTO_TRUNCATION_NOTE,
+  type TranscriptTurn,
+  type TranscriptSource,
+  type CopyMarkdownResult,
+  type TruncateForMailtoResult,
+  type MailtoOpenResult,
+  type PrintTranscriptResult,
+} from "@digithings-ai/ui/chat/transcript";
+export {
+  parseSlashInput,
+  matchingSlashCommands,
+  slashHelpText,
+  nextPaletteIndex,
+  formatCliSettingLine,
+  isLangCode,
+  commandOpensPane,
+  menuIdForCommand,
+  paletteFrame,
+  paletteSurfaces,
+  applyPaletteFrame,
+  paneDraftForId,
+  optionDraft,
+  submenuRows,
+  SLASH_COMMANDS,
+  SLASH_CATEGORIES,
+  LANG_CODES,
+  LANG_LABELS,
+  LANG_CHOICES,
+  EFFORT_CODES,
+  EFFORT_CHOICES,
+  isEffortCode,
+  SEARCH_ENGINE_CODES,
+  SEARCH_ENGINE_CHOICES,
+  isSearchEngine,
+  VIEW_CODES,
+  VIEW_LABELS,
+  VIEW_CHOICES,
+  isViewCode,
+  THINKING_CODES,
+  THINKING_CHOICES,
+  isThinkingCode,
+  type SlashDef,
+  type SlashId,
+  type SlashCategory,
+  type SlashVisibility,
+  type PaletteFrame,
+  type PaletteKind,
+  type PaletteApply,
+  type SubmenuOption,
+  type CliSettingRow,
+  type LangCode,
+  type SearchEngineCode,
+  type ViewCode,
+  type ThinkingCode,
+  EXPORT_CHOICES,
+} from "./slash-commands";
+export type {
+  DigiChatActivity,
+  DigiChatController,
+  DigiChatMessage,
+  VaultHitSummary,
+} from "@digithings-ai/ui/chat/transcript";