@djangocfg/ui-tools 2.1.385 → 2.1.389

package/README.md

@@ -33,7 +33,7 @@ Sixteen tools, each one lazy-loaded so it doesn't ship until used. Bundle size i
 | `Chat` | ~150KB | Streaming chat (SSE + tool calls + attachments). [README](src/tools/Chat/README.md) |
 | `SpeechRecognition` | ~40KB | Mic capture + STT with pluggable engines (Web Speech / HTTP / WS). [README](src/tools/SpeechRecognition/README.md) |
 | `VideoPlayer` | ~150KB | Vidstack-based pro player |
-| `MarkdownMessage` | ~120KB | Read-only chat-tuned markdown. [README](src/components/markdown/MarkdownMessage/README.md) |
+| `MarkdownMessage` | ~120KB | Read-only chat-tuned markdown. **SSR-safe** — use as a Client Component, the result is server-rendered. [README](src/components/markdown/MarkdownMessage/README.md) |
 | `JsonTree` | ~100KB | JSON visualization (full/compact/inline modes) |
 | `AudioPlayer` | ~80KB | WebView-safe waveform player |
 | `Gallery` | ~50KB | Image/video gallery + lightbox |
@@ -57,19 +57,33 @@ For bundle splitting, import from the tool's subpath — only that tool ships:
 ```tsx
 import { LazyJsonTree } from '@djangocfg/ui-tools/json-tree';
 import { Gallery } from '@djangocfg/ui-tools/gallery';
-import { MapContainer } from '@djangocfg/ui-tools/map';
-import { Editor, DiffEditor } from '@djangocfg/ui-tools/code-editor';
-import { LazyChat } from '@djangocfg/ui-tools/chat';
-import { MarkdownEditor } from '@djangocfg/ui-tools/markdown-editor';
+import { LazyMapContainer, MapMarker } from '@djangocfg/ui-tools/map';
+import { MarkdownMessage } from '@djangocfg/ui-tools/markdown-message';
+import { LazyEditor, useMonaco } from '@djangocfg/ui-tools/code-editor';
+import { LazyChat, createPydanticAIChatTransport } from '@djangocfg/ui-tools/chat';
+import { LazyMarkdownEditor, mentionPresets } from '@djangocfg/ui-tools/markdown-editor';
+import { LazyPlayer, PlayerProvider } from '@djangocfg/ui-tools/audio-player';
 // …same pattern for every tool
 ```
 
-| Subpath | Ships |
-|---------|-------|
-| `@djangocfg/ui-tools` | All tools (lazy) |
-| `@djangocfg/ui-tools/<tool-name>` | One tool — `map`, `mermaid`, `chat`, `speech-recognition`, `json-tree`, `code-editor`, `pretty-code`, `openapi-viewer`, `json-form`, `markdown-editor`, `lottie-player`, `audio-player`, `video-player`, `image-viewer`, `cron-scheduler`, `gallery`, `tour`, `tree`, `file-icon`, `upload` |
-| `@djangocfg/ui-tools/styles` | Tailwind source CSS |
-| `@djangocfg/ui-tools/dist.css` | Pre-compiled CSS |
+Subpaths come in three flavors:
+
+- **Lazy + light surface.** The heavy component is exported only as a `Lazy*` wrapper; types, hooks, transports, slot components, and pure helpers are exported synchronously. This is the standard pattern.
+- **Lazy primitives co-exist with light primitives.** `./map` exports `LazyMapContainer` (heavy MapLibre GL) plus `MapMarker` / `MapPopup` etc. — the markers are thin `react-map-gl` wrappers that don't import the heavy lib at module scope.
+- **Synchronous, SSR-safe.** `./markdown-message` is intentionally not lazy — the component is `'use client'` but produces plain HTML, so Next renders it on the server.
+
+| Subpath | Ships | Notes |
+|---------|-------|-------|
+| `@djangocfg/ui-tools` | All tools (lazy) | App-level barrel. Treeshakes per-tool when used via subpaths. |
+| `@djangocfg/ui-tools/chat` | `LazyChat`, `LazyChatLauncher`, transports (`createPydanticAIChatTransport`, `createHttpTransport`, …), hooks (`useChat`, `useChatAudio`, …), reducer/core/types/style tokens | Heavy `ChatRoot` + `ChatLauncher` only load via the `Lazy*` wrappers. Custom layouts that need raw `MessageBubble` / `Composer` should import from the root barrel. |
+| `@djangocfg/ui-tools/code-editor` | `LazyEditor`, `LazyDiffEditor`, `useMonaco`, `useEditor`, `useLanguage`, `useEditorTheme`, `EditorProvider`, types | Monaco (~550 KB) loads only when an editor mounts. `useMonaco` does its own dynamic import. |
+| `@djangocfg/ui-tools/audio-player` | `LazyPlayer`, `PlayerProvider`, selector hooks, slot components (`Cover`, `Title`, `PlayButton`, `Waveform`, …), peaks-cache helpers, store, types | Slot components are presentational — safe synchronous re-exports. They only do anything inside a `<LazyPlayer>` provider. |
+| `@djangocfg/ui-tools/markdown-editor` | `LazyMarkdownEditor`, `mentionPresets`, types | TipTap + ProseMirror (~200 KB) only loads via the lazy wrapper. |
+| `@djangocfg/ui-tools/map` | `LazyMapContainer`, `LazyMapView`, plus light primitives (`MapMarker`, `MapPopup`, `MapCluster`, `MapSource`, `MapLayer`, `MapControls`, `MapProvider`, types) | The heavy MapLibre GL chunk (~800 KB) only loads when `LazyMapContainer` actually mounts. Markers and popups are thin `react-map-gl` wrappers — exported synchronously. |
+| `@djangocfg/ui-tools/markdown-message` | `MarkdownMessage`, `ChatMessageRow`, `ActionRow`, `extractTextFromChildren`, types | **SSR-safe.** The component itself is `'use client'`, but rendering produces plain HTML — Next.js will pre-render it on the server when imported from a Client Component. Use this when you want the markdown renderer without dragging in the full chat. |
+| `@djangocfg/ui-tools/<tool-name>` | One tool | `mermaid`, `speech-recognition`, `json-tree`, `pretty-code`, `openapi-viewer`, `json-form`, `lottie-player`, `video-player`, `image-viewer`, `cron-scheduler`, `gallery`, `tour`, `tree`, `file-icon`, `upload` |
+| `@djangocfg/ui-tools/styles` | Tailwind source CSS | |
+| `@djangocfg/ui-tools/dist.css` | Pre-compiled CSS | |
 
 ---
 

package/dist/ChatRoot-EFNXQXXN.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunk4LFB7I5K_cjs = require('./chunk-4LFB7I5K.cjs');
+require('./chunk-TBSHZO5R.cjs');
+require('./chunk-7IYXZUJO.cjs');
+require('./chunk-OLISEQHS.cjs');
+
+
+
+Object.defineProperty(exports, "ChatRoot", {
+  enumerable: true,
+  get: function () { return chunk4LFB7I5K_cjs.ChatRoot; }
+});
+//# sourceMappingURL=ChatRoot-EFNXQXXN.cjs.map
+//# sourceMappingURL=ChatRoot-EFNXQXXN.cjs.map

package/dist/{ChatRoot-JVR3M3H2.mjs.map → ChatRoot-EFNXQXXN.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"ChatRoot-JVR3M3H2.mjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ChatRoot-EFNXQXXN.cjs"}

package/dist/ChatRoot-FITF5RVP.mjs

@@ -0,0 +1,6 @@
+export { ChatRoot } from './chunk-6ZX2G25W.mjs';
+import './chunk-DMX7W4XZ.mjs';
+import './chunk-2NG4SXEP.mjs';
+import './chunk-N2XQF2OL.mjs';
+//# sourceMappingURL=ChatRoot-FITF5RVP.mjs.map
+//# sourceMappingURL=ChatRoot-FITF5RVP.mjs.map

package/dist/{ChatRoot-LXIUBOXF.cjs.map → ChatRoot-FITF5RVP.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"ChatRoot-LXIUBOXF.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ChatRoot-FITF5RVP.mjs"}

package/dist/{DocsLayout-2P3ONDWJ.mjs → DocsLayout-EKASBSP7.mjs}

@@ -1,5 +1,5 @@
 import { deduplicateEndpoints, dereferenceSchema, resolveBaseUrl, usePlaygroundContext, relativePath, toMarkdown, toCompactJson, toRawJson, formatBytes, CODE_SAMPLE_TARGETS, buildHarRequest, resolveAbsolute, renderSnippet, endpointToMarkdown, isValidJson, findApiKeyById, parseRequestHeaders, UrlBuilder, sampleSchemaJson, joinUrl } from './chunk-Y6UTOBF6.mjs';
-import { MarkdownMessage, PrettyCode_default } from './chunk-HIK6BPL7.mjs';
+import { MarkdownMessage, PrettyCode_default } from './chunk-2NG4SXEP.mjs';
 import { JsonTree_default } from './chunk-ECONRHIG.mjs';
 import './chunk-KNEQRUBA.mjs';
 import { __name } from './chunk-N2XQF2OL.mjs';
@@ -3444,5 +3444,5 @@ var DocsLayout = /* @__PURE__ */ __name(() => {
 }, "DocsLayout");
 
 export { DocsLayout };
-//# sourceMappingURL=DocsLayout-2P3ONDWJ.mjs.map
-//# sourceMappingURL=DocsLayout-2P3ONDWJ.mjs.map
+//# sourceMappingURL=DocsLayout-EKASBSP7.mjs.map
+//# sourceMappingURL=DocsLayout-EKASBSP7.mjs.map