@flamingo-stack/openframe-frontend-core 0.0.489 → 0.0.490-1506.3944.1

package/dist/components/chat/hooks/use-realtime-chunk-processor.d.ts

@@ -1,6 +0,0 @@
-import type { UseRealtimeChunkProcessorReturn, UseRealtimeChunkProcessorOptions } from '../types';
-/**
- * Hook for processing real-time NATS chunks into message segments
- */
-export declare function useRealtimeChunkProcessor(options: UseRealtimeChunkProcessorOptions): UseRealtimeChunkProcessorReturn;
-//# sourceMappingURL=use-realtime-chunk-processor.d.ts.map

package/dist/components/chat/hooks/use-realtime-chunk-processor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-realtime-chunk-processor.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-realtime-chunk-processor.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,+BAA+B,EAAE,gCAAgC,EAAmF,MAAM,UAAU,CAAA;AAQlL;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,+BAA+B,CAocjC"}

package/dist/components/chat/utils/chunk-parser.d.ts

@@ -1,25 +0,0 @@
-/**
- * Utilities for parsing NATS chunks into structured actions
- */
-import { type ParsedChunkAction } from '../types';
-/**
- * Parse a raw NATS chunk into a structured action
- */
-export declare function parseChunkToAction(chunk: unknown): ParsedChunkAction | null;
-/**
- * Check if a chunk represents a control message (start/end)
- */
-export declare function isControlChunk(chunk: unknown): boolean;
-/**
- * Check if a chunk represents an error
- */
-export declare function isErrorChunk(chunk: unknown): boolean;
-/**
- * Check if a chunk represents metadata
- */
-export declare function isMetadataChunk(chunk: unknown): boolean;
-/**
- * Extract text content from a chunk if it's a text chunk
- */
-export declare function extractTextFromChunk(chunk: unknown): string | null;
-//# sourceMappingURL=chunk-parser.d.ts.map

package/dist/components/chat/utils/chunk-parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk-parser.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/chunk-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgC,KAAK,iBAAiB,EAAuD,MAAM,UAAU,CAAA;AAqBpI;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CA2L3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlE"}

package/dist/components/ui/rich-markdown-renderer.d.ts

@@ -1,34 +0,0 @@
-import React from 'react';
-import { type RichMarkdownRuntime } from '../embeds/rich-markdown-runtime';
-/**
- * Props for `<RichMarkdownRenderer>`. Aside from the four runtime knobs
- * lifted from {@link RichMarkdownRuntime}, this is the same shape the hub's
- * `SimpleMarkdownRenderer` ever had — every legacy call site can be moved
- * over without other changes.
- */
-export interface RichMarkdownRendererProps extends Partial<RichMarkdownRuntime> {
-    content: string;
-    className?: string;
-    sectionIds?: Array<{
-        id: string;
-        title: string;
-        level: number;
-    }>;
-    /** Callback for internal navigation (called after the resolver returns) */
-    onInternalLinkClick?: (path: string, options?: {
-        expandFolder?: boolean;
-        fromInternalLink?: boolean;
-    }) => void;
-    /** List of broken links detected server-side */
-    brokenLinks?: string[];
-    /** Current documentation path for resolving relative links */
-    currentPath?: string;
-    /** Source for resolving internal links (default: 'openframe-docs'). Registry id from DOC_SOURCES. */
-    resolveSource?: string;
-    /** Path of the internal link-resolver endpoint. Default '/api/docs/resolve-link'. */
-    resolveLinkEndpointUrl?: string;
-    /** When the page already has an H1, render markdown `#` as `h2` (e.g. legal pages). */
-    demoteMarkdownH1ToH2?: boolean;
-}
-export declare const RichMarkdownRenderer: React.FC<RichMarkdownRendererProps>;
-//# sourceMappingURL=rich-markdown-renderer.d.ts.map

package/dist/components/ui/rich-markdown-renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rich-markdown-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/ui/rich-markdown-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAgBjF,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AA4czC;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/G,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uFAAuF;IACvF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAoCpE,CAAC"}

package/dist/components/ui/simple-markdown-renderer.d.ts

@@ -1,73 +0,0 @@
-import React from 'react';
-import { type Components } from 'react-markdown';
-import type { PluggableList } from 'unified';
-import type { ResolveLinkResult } from '../../types/doc-source';
-export type { ResolveLinkResult };
-export type TextSizeElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'li' | 'blockquote' | 'code' | 'th' | 'td';
-export type TextSizeClassMap = Partial<Record<TextSizeElement, string>>;
-export type TextSizePreset = 'default' | 'compact' | 'large';
-export type TextSizeConfig = TextSizePreset | TextSizeClassMap | {
-    preset: TextSizePreset;
-    overrides: TextSizeClassMap;
-};
-export interface SimpleMarkdownRendererProps {
-    content: string;
-    className?: string;
-    /** Backend-provided heading IDs for deep-link anchors */
-    sectionIds?: Array<{
-        id: string;
-        title: string;
-        level: number;
-    }>;
-    /** When the page already has an H1, render markdown `#` as `<h2>` */
-    demoteMarkdownH1ToH2?: boolean;
-    /** List of broken link hrefs detected server-side (shown with [BROKEN] badge) */
-    brokenLinks?: string[];
-    /** Callback for internal (non-http, non-anchor) link clicks */
-    onInternalLinkClick?: (path: string, options?: {
-        expandFolder?: boolean;
-        fromInternalLink?: boolean;
-    }) => void;
-    /** Current documentation path — enables internal-link mode when set */
-    currentPath?: string;
-    /**
-     * Resolve an internal link href to a navigation path.
-     * Called when a user clicks an internal doc link.
-     */
-    onResolveLink?: (href: string, currentPath: string) => Promise<ResolveLinkResult>;
-    /** Pre-process the raw markdown string before rendering (e.g. shortcode expansion) */
-    preprocessContent?: (content: string) => string;
-    /** Merge additional or override react-markdown component renderers */
-    componentOverrides?: Partial<Components>;
-    /**
-     * Extra remark plugins appended after the built-in `remarkGfm` and
-     * `remarkBreaks`. Used by chat consumers to inject `remarkCardLinks`,
-     * which converts `[card://<type>:<id>]` markers into synthetic `link`
-     * nodes; the host's `componentOverrides.a` then swaps those for whatever
-     * inline entity-card component it provides.
-     *
-     * Each entry is either a Plugin reference or a [Plugin, options] tuple
-     * — same shape as react-markdown's own `remarkPlugins` prop. Pass an
-     * empty array (or omit) to keep the default plugin set.
-     */
-    additionalRemarkPlugins?: PluggableList;
-    /**
-     * Configure text sizing for all rendered elements.
-     * - `"default"` — current behavior (large article-style typography)
-     * - `"compact"` — smaller sizes for sidebars, cards, changelogs
-     * - `"large"` — extra-large sizes for hero/landing content
-     * - `{ p: "text-sm", h1: "text-2xl" }` — per-element overrides (merged onto default)
-     * - `{ preset: "compact", overrides: { h1: "text-heading-1" } }` — preset + tweaks
-     */
-    textSize?: TextSizeConfig;
-}
-/**
- * Memoized so a parent re-render with UNCHANGED props (same `content` string,
- * same memoized `componentOverrides`/plugins) does NOT re-parse the markdown.
- * Re-parsing rebuilds the entire react-markdown subtree, which RE-MOUNTS any
- * embedded inline entity cards — closing their open menus and re-triggering
- * their fetch on every chat re-render (streaming chunk AND scroll). With
- * stable props the renderer bails, so completed messages' cards stay mounted.
- */
-export declare const SimpleMarkdownRenderer: React.NamedExoticComponent<SimpleMarkdownRendererProps>;
-//# sourceMappingURL=simple-markdown-renderer.d.ts.map

package/dist/components/ui/simple-markdown-renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-markdown-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/ui/simple-markdown-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkE,MAAM,OAAO,CAAC;AACvF,OAAsB,EAAE,KAAK,UAAU,EAAuB,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAU7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAyflC,MAAM,MAAM,eAAe,GACvB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,GAAG,GAAG,IAAI,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAC7D,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,gBAAgB,GAChB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,CAAC;AA+D5D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/G,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClF,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,aAAa,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA+TD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,yDAAmC,CAAC"}

package/src/components/chat/hooks/.use-realtime-chunk-processor.md

@@ -1,77 +0,0 @@
-<!-- source-hash: 681c783784fdc89f0c86eb3e539c482b -->
-Processes real-time NATS streaming chunks into structured message segments, managing streaming state, approval flows, direct-mode barriers, and tool execution events for AI assistant chat interfaces.
-
-## Key Components
-
-### `useRealtimeChunkProcessor(options)`
-
-Main hook export. Accepts `UseRealtimeChunkProcessorOptions` and returns `UseRealtimeChunkProcessorReturn`.
-
-**Options:**
-
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `callbacks` | `object` | required | Event handlers (`onSegmentsUpdate`, `onStreamStart`, `onStreamEnd`, `onApprove`, `onReject`, etc.) |
-| `displayApprovalTypes` | `string[]` | `['CLIENT']` | Approval types rendered inline; others are escalated |
-| `approvalStatuses` | `object` | `{}` | Current status map keyed by `requestId` |
-| `initialState` | `object` | — | Hydrates accumulator for resumed dialogs |
-| `batchApprovalsEnabled` | `boolean` | `true` | Renders batch approvals as a single card; `false` unfolds into individual cards |
-| `isDirectMode` | `boolean` | `false` | Activates the direct-mode barrier, dropping AI assistant chunks |
-
-### Internal Refs
-
-| Ref | Purpose |
-|---|---|
-| `accumulatorRef` | `MessageSegmentAccumulator` instance managing segment state |
-| `isInStreamRef` | Tracks open/closed stream window (`MESSAGE_START` → `MESSAGE_END`) |
-| `hasEverStreamedRef` | Distinguishes cold-start vs. post-stream continuation for append mode |
-| `directModeFlagRef` / `sawDirectMessageRef` | Direct-mode barrier gate |
-| `directTeardownFiredRef` | One-shot guard: ensures teardown fires exactly once on barrier entry |
-| `pendingEscalatedRef` | Map of escalated approval requests not shown inline |
-
-### Supported Chunk Actions
-
-| Action | Behavior |
-|---|---|
-| `message_start` / `message_end` | Opens/closes stream, resets accumulator |
-| `text` / `thinking` | Appends to accumulator; uses append-mode after `MESSAGE_END` |
-| `tool_execution` | Routes in-stream to accumulator; post-stream to `onToolExecuted` callback |
-| `approval_request` | Inline or escalated based on `displayApprovalTypes` |
-| `approval_batch` | Single batch card, legacy card fan-out, or escalated |
-| `metadata` | Forwarded directly to `onMetadata` |
-| `direct_message` | Activates direct-mode barrier |
-
-## Usage Example
-
-```typescript
-const { processChunk } = useRealtimeChunkProcessor({
-  callbacks: {
-    onSegmentsUpdate: (segments, meta) => setSegments(segments),
-    onStreamStart: () => setIsStreaming(true),
-    onStreamEnd: () => setIsStreaming(false),
-    onApprove: (requestId) => approveAction(requestId),
-    onReject: (requestId) => rejectAction(requestId),
-    onEscalatedApproval: (requestId, data) => notifyAdmin(requestId, data),
-    onToolExecuted: (segment) => updateToolCard(segment),
-    onAgentBusy: () => showTypingIndicator(),
-    onMetadata: (meta) => handleMetadata(meta),
-  },
-  displayApprovalTypes: ['CLIENT'],
-  batchApprovalsEnabled: true,
-  isDirectMode: false,
-  approvalStatuses: { 'req-123': 'approved' },
-})
-
-// Wire to your NATS subscription
-natsSubscription.onMessage((rawChunk) => {
-  processChunk(rawChunk)
-})
-```
-
-## Direct-Mode Barrier
-
-When `isDirectMode` is `true` or a `direct_message` chunk arrives, the hook drops all subsequent AI-assistant chunks (everything not in `DIRECT_MODE_ALLOWED`). Teardown fires exactly once — clearing the typing indicator, composer lock, and in-progress bubble — even if no stream is currently open (e.g., during post-approval tool execution).
-
-## Source
-
-[`use-realtime-chunk-processor.ts`](https://github.com/flamingo-stack/openframe-oss-lib/blob/main/use-realtime-chunk-processor.ts)