@flamingo-stack/openframe-frontend-core 0.0.467 → 0.0.468-snapshot.20260723140929

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,CA0L3E;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;AAS7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAqclC,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;AAqXD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,yDAAmC,CAAC"}

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

@@ -1,50 +0,0 @@
-<!-- source-hash: e37a3772ece6c09122bfe5d89ce800e0 -->
-Real-time NATS streaming chunk processor hook that converts raw streaming messages into typed message segments, managing stream state, tool execution, and approval workflows.
-
-## Key Components
-
-| Export | Type | Description |
-|--------|------|-------------|
-| `useRealtimeChunkProcessor` | Hook | Primary hook for processing NATS stream chunks into UI-ready message segments |
-| `accumulatorRef` | Internal Ref | Holds a `MessageSegmentAccumulator` instance that tracks and builds segments across chunk events |
-| `isInStreamRef` | Internal Ref | Tracks whether a `MESSAGE_START`/`MESSAGE_END` boundary is active |
-| `hasEverStreamedRef` | Internal Ref | Distinguishes cold-start vs. resumed-dialog continuation mode |
-| `pendingEscalatedRef` | Internal Ref | Tracks escalated (non-display) approval requests awaiting results |
-
-### Handled Chunk Actions
-
-| Action | Behavior |
-|--------|----------|
-| `message_start` / `message_end` | Opens/closes stream window, resets segment accumulator |
-| `text` / `thinking` | Appends to accumulator; uses append mode post-stream |
-| `tool_execution` | Routes to accumulator in-stream, or `onToolExecuted` post-stream |
-| `approval_request` | Renders inline or escalates based on `displayApprovalTypes` |
-| `approval_batch` | Renders batch card or unfolds into legacy cards if `batchApprovalsEnabled = false` |
-| `approval_result` | Resolves escalated or inline approvals, updates accumulator status |
-| `error` | Parses error detail and emits error segment |
-
-## Usage Example
-
-```typescript
-const { processChunk } = useRealtimeChunkProcessor({
-  callbacks: {
-    onSegmentsUpdate: (segments, opts) => updateMessage(segments, opts),
-    onStreamStart: () => setStreaming(true),
-    onStreamEnd: () => setStreaming(false),
-    onApprove: (requestId) => approveToolCall(requestId),
-    onReject: (requestId) => rejectToolCall(requestId),
-    onEscalatedApproval: (requestId, data) => notifyTechnician(requestId, data),
-    onApprovalResolved: (requestId, status) => syncStatus(requestId, status),
-    onError: (error) => console.error(error),
-  },
-  displayApprovalTypes: ['CLIENT'],
-  approvalStatuses: { 'req-123': 'pending' },
-  enableThinking: false,
-  batchApprovalsEnabled: true,
-})
-
-// Feed raw NATS chunks directly
-natsSubscription.on('message', (msg) => processChunk(msg.data))
-```
-
-> **Note:** `batchApprovalsEnabled` defaults to `true`. Pass `false` to fall back to legacy per-call approval cards. Consumers using `onApprovalResolved` should omit `onSegmentsUpdate` handling for approval results to avoid bubble overwrites during status flips.