@threadplane/chat 0.0.53 → 0.0.54

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadplane/chat",
-  "version": "0.0.53",
+  "version": "0.0.54",
   "exports": {
     "./chat.css": "./chat.css",
     "./themes/default-dark.css": "./themes/default-dark.css",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@cacheplane/partial-json": ">=0.1.1 <0.3.0",
-    "@cacheplane/partial-markdown": "^0.4.1",
+    "@cacheplane/partial-markdown": "^0.5.3",
     "tslib": "^2.3.0",
     "@threadplane/telemetry": "*"
   },

package/types/threadplane-chat.d.ts

@@ -4,7 +4,7 @@ export { StandardSchemaInferInput, StandardSchemaInferOutput, StandardSchemaV1,
 import { A2uiComponentDef, A2uiSurface, A2uiMessage, A2uiActionMessage } from '@threadplane/a2ui';
 export { A2uiAction, A2uiActionContextEntry, A2uiActionMessage, A2uiChildren, A2uiClientDataModel, A2uiComponent, A2uiComponentDef, A2uiSurface, A2uiTheme, DynamicBoolean, DynamicNumber, DynamicString, isLiteralBoolean, isLiteralNumber, isLiteralString, isPathRef } from '@threadplane/a2ui';
 import * as _angular_core from '@angular/core';
-import { Type, InjectionToken, Signal, TemplateRef, WritableSignal, InputSignal, InputSignalWithTransform } from '@angular/core';
+import { Type, InjectionToken, Signal, TemplateRef, ElementRef, WritableSignal, InputSignal, InputSignalWithTransform } from '@angular/core';
 import * as _json_render_core from '@json-render/core';
 import { StateStore, Spec } from '@json-render/core';
 import { Observable } from 'rxjs';
@@ -558,7 +558,7 @@ interface AgentRef<TState> {
  */
 declare function createAgentRef<TState>(debugName?: string): AgentRef<TState>;
 
-type AgentRuntimeTelemetryEvent = 'ngaf:runtime_instance_created' | 'ngaf:runtime_request_created' | 'ngaf:stream_started' | 'ngaf:stream_ended' | 'ngaf:stream_errored';
+type AgentRuntimeTelemetryEvent = 'tplane:runtime_instance_created' | 'tplane:runtime_request_created' | 'tplane:stream_started' | 'tplane:stream_ended' | 'tplane:stream_errored';
 interface AgentRuntimeTelemetryProperties {
     transport: 'langgraph' | 'ag-ui' | 'custom' | string;
     surface?: string;
@@ -1277,9 +1277,9 @@ declare class ChatGenerativeUiComponent {
  *   [chatWelcomeSuggestions] — projects suggestion rows below the input
  *
  * Host CSS variables (override on :host or any ancestor):
- *   --ngaf-chat-welcome-max-width  default 36rem
- *   --ngaf-chat-welcome-gap        default 1.25rem
- *   --ngaf-chat-welcome-padding    default 24px
+ *   --tplane-chat-welcome-max-width  default 36rem
+ *   --tplane-chat-welcome-gap        default 1.25rem
+ *   --tplane-chat-welcome-padding    default 24px
  */
 declare class ChatWelcomeComponent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatWelcomeComponent, never>;
@@ -1296,6 +1296,22 @@ declare class ChatWelcomeSuggestionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatWelcomeSuggestionComponent, "chat-welcome-suggestion", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; }, { "selected": "selected"; }, never, ["[chatWelcomeSuggestionIcon]"], true, never>;
 }
 
+type HorizontalConnectionPos = 'start' | 'center' | 'end';
+type VerticalConnectionPos = 'top' | 'center' | 'bottom';
+interface ConnectedPosition {
+    originX: HorizontalConnectionPos;
+    originY: VerticalConnectionPos;
+    overlayX: HorizontalConnectionPos;
+    overlayY: VerticalConnectionPos;
+    offsetX?: number;
+    offsetY?: number;
+}
+interface OverlayPositionResult {
+    top: number;
+    left: number;
+    position: ConnectedPosition;
+}
+
 interface ChatSelectOption {
     value: string;
     label: string;
@@ -1303,15 +1319,13 @@ interface ChatSelectOption {
     disabled?: boolean;
 }
 /**
- * Generic single-select dropdown. Designed to slot into the chat input pill
- * (via [chatInputModelSelect]) but usable anywhere.
- *
- * Inputs:
- *   options      — array of { value, label, disabled? }; required
- *   value        — currently selected value (two-way via model())
- *   placeholder  — trigger label when no option matches; default 'Select'
- *   disabled     — disables the trigger; default false
- *   menuLabel    — aria-label for the popover; defaults to placeholder
+ * Generic single-select dropdown. The menu renders through the chat
+ * connected-overlay primitive (a body-level portal), so it is never clipped by
+ * an ancestor's `overflow` and never trapped by an ancestor `transform`.
+ *
+ * Inputs: options (required), value (two-way), placeholder, disabled, menuLabel,
+ * panelClass (extra class(es) on the overlay pane — the menu is portaled, so
+ * `::ng-deep chat-select .chat-select__menu` no longer reaches it).
  */
 declare class ChatSelectComponent {
     readonly options: _angular_core.InputSignal<readonly ChatSelectOption[]>;
@@ -1319,23 +1333,75 @@ declare class ChatSelectComponent {
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly menuLabel: _angular_core.InputSignal<string | undefined>;
+    readonly panelClass: _angular_core.InputSignal<string | string[]>;
     protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly menuId: string;
+    protected readonly overlayPositions: ConnectedPosition[];
+    protected readonly panelClasses: _angular_core.Signal<string[]>;
     protected readonly currentLabel: _angular_core.Signal<string>;
     private readonly hostEl;
     private readonly document;
-    private readonly destroyRef;
-    constructor();
+    private menuPane;
+    protected onAttached(pane: HTMLElement): void;
     protected toggle(): void;
     protected selectOption(opt: ChatSelectOption): void;
     protected onTriggerKeydown(e: KeyboardEvent): void;
     protected onMenuKeydown(e: KeyboardEvent): void;
     private focusOption;
-    private focusTrigger;
     private moveFocus;
     private queryOptions;
     private queryTrigger;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatSelectComponent, "chat-select", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "menuLabel": { "alias": "menuLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatSelectComponent, "chat-select", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "menuLabel": { "alias": "menuLabel"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+/** Marks the anchor element a connected overlay positions against. */
+declare class ChatOverlayOriginDirective {
+    readonly elementRef: ElementRef<HTMLElement>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatOverlayOriginDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChatOverlayOriginDirective, "[chatOverlayOrigin]", ["chatOverlayOrigin"], {}, {}, never, never, true, never>;
+}
+/**
+ * Applied to an `<ng-template>`. When `chatOverlayOpen` is true, the template
+ * content is portaled into the shared body-level overlay container and
+ * positioned connected to `chatOverlayOrigin`, repositioning live on
+ * scroll/resize. Closes on outside mousedown (via the `chatOverlayOutsideClick`
+ * output) and Tab; returns focus to the origin when focus was inside the pane.
+ *
+ * NOTE: the directive does not own the open state — it only emits. To fully
+ * close the overlay, consumers MUST handle BOTH `(chatOverlayOutsideClick)` and
+ * `(chatOverlayDetach)`. Tab-close (and Escape, when the consumer routes it)
+ * surface through `chatOverlayDetach`, so wiring only `chatOverlayOutsideClick`
+ * leaves the overlay stuck open on Tab.
+ */
+declare class ChatConnectedOverlayDirective {
+    readonly origin: _angular_core.InputSignal<ChatOverlayOriginDirective>;
+    readonly open: _angular_core.InputSignal<boolean>;
+    readonly positions: _angular_core.InputSignal<ConnectedPosition[]>;
+    readonly panelClass: _angular_core.InputSignal<string | string[]>;
+    /** Emits the pane element once attached (consumers focus content from it). */
+    readonly attached: _angular_core.OutputEmitterRef<HTMLElement>;
+    readonly outsideClick: _angular_core.OutputEmitterRef<MouseEvent>;
+    readonly detached: _angular_core.OutputEmitterRef<void>;
+    private readonly templateRef;
+    private readonly viewContainerRef;
+    private readonly document;
+    private pane;
+    private viewRef;
+    private resizeObs;
+    private rafId;
+    private previouslyFocused;
+    private readonly onScrollOrResize;
+    private readonly onDocMouseDown;
+    private readonly onKeydown;
+    constructor();
+    private attach;
+    private scheduleReposition;
+    private reposition;
+    private dispose;
+    private normalizePanelClass;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatConnectedOverlayDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChatConnectedOverlayDirective, "[chatConnectedOverlay]", never, { "origin": { "alias": "chatOverlayOrigin"; "required": true; "isSignal": true; }; "open": { "alias": "chatOverlayOpen"; "required": false; "isSignal": true; }; "positions": { "alias": "chatOverlayPositions"; "required": false; "isSignal": true; }; "panelClass": { "alias": "chatOverlayPanelClass"; "required": false; "isSignal": true; }; }, { "attached": "chatOverlayAttached"; "outsideClick": "chatOverlayOutsideClick"; "detached": "chatOverlayDetach"; }, never, never, true, never>;
 }
 
 /**
@@ -2023,6 +2089,7 @@ declare class ChatStreamingMdComponent {
     private parser;
     private prior;
     private finished;
+    private readonly finalizeTick;
     readonly root: _angular_core.Signal<MarkdownDocumentNode | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatStreamingMdComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatStreamingMdComponent, "chat-streaming-md", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "viewRegistry": { "alias": "viewRegistry"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -3004,5 +3071,5 @@ declare function mockAgent(opts?: MockAgentOptions): MockAgent;
 /** Inferred argument type for a schema (alias of StandardSchemaInferOutput). */
 type ToolArgs<S extends StandardSchemaV1> = StandardSchemaInferOutput<S>;
 
-export { A2uiAudioPlayerComponent, A2uiButtonComponent, A2uiCardComponent, A2uiCheckBoxComponent, A2uiColumnComponent, A2uiDateTimeInputComponent, A2uiDividerComponent, A2uiIconComponent, A2uiImageComponent, A2uiListComponent, A2uiModalComponent, A2uiMultipleChoiceComponent, A2uiRowComponent, A2uiSliderComponent, A2uiSurfaceComponent, A2uiTabsComponent, A2uiTextComponent, A2uiTextFieldComponent, A2uiVideoComponent, AGENT_ERROR_MESSAGES, AgentError, CHAT_CONFIG, CHAT_LIFECYCLE, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatPopupComponent, ChatProjectListComponent, ChatReasoningComponent, ChatScrollBubbleComponent, ChatSelectComponent, ChatSidebarComponent, ChatSidenavComponent, ChatSidenavScrimComponent, ChatStreamingMdComponent, ChatSubagentCardComponent, ChatSubagentsComponent, ChatSuggestionsComponent, ChatThreadListComponent, ChatTimelineComponent, ChatTimelineSliderComponent, ChatToolCallCardComponent, ChatToolCallTemplateDirective, ChatToolCallsComponent, ChatToolViewsComponent, ChatTraceComponent, ChatTypingIndicatorComponent, ChatWelcomeComponent, ChatWelcomeSuggestionComponent, ChatWindowComponent, CitationsResolverService, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownHtmlComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownMathComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createAgentRef, createContentClassifier, createParseTreeStore, createPartialArgsBridge, deriveJsonSchema, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, startClientToolExecutor, statusColor, submitMessage, toAgentError, toClientToolSpecs, tools, validateArgs, view };
-export type { A2uiComponentView, A2uiSurfaceState, A2uiSurfaceStore, A2uiViewEntry, A2uiViews, Agent, AgentCheckpoint, AgentCustomEvent, AgentErrorKind, AgentEvent, AgentInterrupt, AgentRef, AgentRuntimeTelemetryEvent, AgentRuntimeTelemetryPayload, AgentRuntimeTelemetryProperties, AgentRuntimeTelemetrySink, AgentStateUpdateEvent, AgentStatus, AgentSubmitInput, AgentSubmitOptions, AgentWithHistory, AnyFunctionToolDef, AskToolDef, ChatApprovalAction, ChatConfig, ChatLifecycle, ChatMessageRole, ChatRenderEvent, ChatScrollBubbleMode, ChatSelectOption, ChatSidenavMode, ChatToolCallTemplateContext, Citation, ClientToolDef, ClientToolRegistry, ClientToolResult, ClientToolSpec, ClientToolsCapability, ClientToolsCoordinator, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, FunctionToolDef, InterruptAction, Message, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ThreadRoutingConfig, ToolArgs, ToolCall, ToolCallInfo, ToolCallStatus, TraceState, ViewProps, ViewToolDef };
+export { A2uiAudioPlayerComponent, A2uiButtonComponent, A2uiCardComponent, A2uiCheckBoxComponent, A2uiColumnComponent, A2uiDateTimeInputComponent, A2uiDividerComponent, A2uiIconComponent, A2uiImageComponent, A2uiListComponent, A2uiModalComponent, A2uiMultipleChoiceComponent, A2uiRowComponent, A2uiSliderComponent, A2uiSurfaceComponent, A2uiTabsComponent, A2uiTextComponent, A2uiTextFieldComponent, A2uiVideoComponent, AGENT_ERROR_MESSAGES, AgentError, CHAT_CONFIG, CHAT_LIFECYCLE, ChatApprovalCardComponent, ChatCitationCardTemplateDirective, ChatCitationsCardComponent, ChatCitationsComponent, ChatComponent, ChatConfirmDialogComponent, ChatConnectedOverlayDirective, ChatErrorComponent, ChatGenerativeUiComponent, ChatGenuiSkeletonComponent, ChatHistorySearchPaletteComponent, ChatInputComponent, ChatInterruptComponent, ChatInterruptPanelComponent, ChatLauncherButtonComponent, ChatMessageActionsComponent, ChatMessageComponent, ChatMessageListComponent, ChatOverflowMenuComponent, ChatOverlayOriginDirective, ChatPopupComponent, ChatProjectListComponent, ChatReasoningComponent, ChatScrollBubbleComponent, ChatSelectComponent, ChatSidebarComponent, ChatSidenavComponent, ChatSidenavScrimComponent, ChatStreamingMdComponent, ChatSubagentCardComponent, ChatSubagentsComponent, ChatSuggestionsComponent, ChatThreadListComponent, ChatTimelineComponent, ChatTimelineSliderComponent, ChatToolCallCardComponent, ChatToolCallTemplateDirective, ChatToolCallsComponent, ChatToolViewsComponent, ChatTraceComponent, ChatTypingIndicatorComponent, ChatWelcomeComponent, ChatWelcomeSuggestionComponent, ChatWindowComponent, CitationsResolverService, IS_HEADER_ROW, MARKDOWN_VIEW_REGISTRY, MarkdownAutolinkComponent, MarkdownBlockquoteComponent, MarkdownChildrenComponent, MarkdownCitationReferenceComponent, MarkdownCodeBlockComponent, MarkdownDocumentComponent, MarkdownEmphasisComponent, MarkdownHardBreakComponent, MarkdownHeadingComponent, MarkdownHtmlComponent, MarkdownImageComponent, MarkdownInlineCodeComponent, MarkdownLinkComponent, MarkdownListComponent, MarkdownListItemComponent, MarkdownMathComponent, MarkdownParagraphComponent, MarkdownSoftBreakComponent, MarkdownStrikethroughComponent, MarkdownStrongComponent, MarkdownTableCellComponent, MarkdownTableComponent, MarkdownTableRowComponent, MarkdownTextComponent, MarkdownThematicBreakComponent, MessageTemplateDirective, a2uiBasicCatalog, action, ask, buildA2uiActionMessage, cacheplaneMarkdownViews, createA2uiSurfaceStore, createAgentRef, createContentClassifier, createParseTreeStore, createPartialArgsBridge, deriveJsonSchema, emitBinding, executeFunctionTool, extractErrorMessage, formatDuration, getInterrupt, getMessageType, injectThreadRouting, isAbortError, isAssistantMessage, isSystemMessage, isToolMessage, isTyping, isUserMessage, messageContent, mockAgent, normalizeEnvelopeArgs, normalizeViewEntry, provideChat, renderMarkdown, startClientToolExecutor, statusColor, submitMessage, toAgentError, toClientToolSpecs, tools, validateArgs, view };
+export type { A2uiComponentView, A2uiSurfaceState, A2uiSurfaceStore, A2uiViewEntry, A2uiViews, Agent, AgentCheckpoint, AgentCustomEvent, AgentErrorKind, AgentEvent, AgentInterrupt, AgentRef, AgentRuntimeTelemetryEvent, AgentRuntimeTelemetryPayload, AgentRuntimeTelemetryProperties, AgentRuntimeTelemetrySink, AgentStateUpdateEvent, AgentStatus, AgentSubmitInput, AgentSubmitOptions, AgentWithHistory, AnyFunctionToolDef, AskToolDef, ChatApprovalAction, ChatConfig, ChatLifecycle, ChatMessageRole, ChatRenderEvent, ChatScrollBubbleMode, ChatSelectOption, ChatSidenavMode, ChatToolCallTemplateContext, Citation, ClientToolDef, ClientToolRegistry, ClientToolResult, ClientToolSpec, ClientToolsCapability, ClientToolsCoordinator, ConnectedPosition, ContentBlock, ContentClassifier, ContentType, ElementAccumulationState, FunctionToolDef, InterruptAction, Message, MessageTemplateType, MockAgent, MockAgentOptions, OverflowMenuItem, OverlayPositionResult, ParseTreeStore, PartialArgsBridge, Project, ProjectActionAdapter, ResolvedCitation, Role, Subagent, SubagentStatus, Thread, ThreadActionAdapter, ThreadMatch, ThreadRoutingConfig, ToolArgs, ToolCall, ToolCallInfo, ToolCallStatus, TraceState, ViewProps, ViewToolDef };