@m6d/cortex-angular 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m6d/cortex-angular",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Reusable AI agent chat UI library for Angular",
   "license": "MIT",
   "sideEffects": false,

package/theme.css

@@ -63,6 +63,15 @@
   );
   --cortex-font-size: 0.8125rem;
 
+  /* These read --cortex-font-size (or the color named) when unset, so they ship
+   * unset: declaring one here gives that part its own value.
+   *
+   * --cortex-font-size-message: 0.875rem;      message bubbles and the composer
+   * --cortex-font-size-header: 0.875rem;       the chat and history titles
+   * --cortex-color-send-empty: transparent;    the send button with nothing to send
+   * --cortex-color-send-empty-text: var(--cortex-color-text-muted);
+   */
+
   /* The widget's headings read --cortex-font-display and fall back to `inherit`,
    * so it ships unset on purpose — declaring it here is how you opt in:
    *

package/types/m6d-cortex-angular.d.ts

@@ -1,7 +1,7 @@
 // Generated by dts-bundle-generator v9.5.1
 
 import * as i0 from '@angular/core';
-import { Injector, OnInit, Signal, Type } from '@angular/core';
+import { Injector, OnInit, Signal, TemplateRef, Type } from '@angular/core';
 import { ToolCallPart, UIMessage } from '@tanstack/ai';
 import { Observable } from 'rxjs';
 
@@ -92,6 +92,31 @@ export type MediaRenderers = Partial<Record<string, MediaRenderer>>;
 export type Localized<T> = T | Partial<Record<Locale, T>>;
 export type CortexViewMode = "helper" | "full";
 export type CortexTheme = "light" | "dark" | "system";
+/**
+ * What a host's own header receives in place of the widget's: where the
+ * widget is, what to show, and the actions the default header offers. One
+ * header serves both screens; `screen` says which is showing.
+ */
+export type CortexHeaderContext = {
+	screen: "chat" | "threads";
+	viewMode: CortexViewMode;
+	/** The open thread's title; null on a new chat. */
+	title: string | null;
+	/** `agentName` in the widget's locale. */
+	agentName: string | undefined;
+	isWorking: boolean;
+	/** Whether the host enabled the debug switch, and whether it is on. */
+	debug: {
+		shown: boolean;
+		on: boolean;
+	};
+	newChat: () => void;
+	/** Shows the history: the history screen, or in full mode the sidebar where it is hidden. */
+	openHistory: () => void;
+	/** Returns to the open chat from wherever `openHistory` went. */
+	closeHistory: () => void;
+	toggleDebug: () => void;
+};
 export type CortexToolCallContext = {
 	threadId: string;
 };
@@ -315,19 +340,72 @@ declare class CortexChatService {
 	static ɵfac: i0.ɵɵFactoryDeclaration<CortexChatService, never>;
 	static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
+export type HeaderTemplateContext = {
+	$implicit: CortexHeaderContext;
+};
+/**
+ * Marks the host's own header for `<cortex-chat-widget>`. When present it
+ * replaces the default header on both the chat and the history screen, and
+ * receives the widget's state and actions as its context:
+ *
+ *   <cortex-chat-widget [config]="config">
+ *     <ng-template cortexHeader let-chat>
+ *       <div class="cortex-widget__chat-header">{{ chat.title ?? chat.agentName }}</div>
+ *     </ng-template>
+ *   </cortex-chat-widget>
+ */
+export declare class CortexHeaderDirective {
+	readonly template: TemplateRef<HeaderTemplateContext>;
+	static ngTemplateContextGuard(_directive: CortexHeaderDirective, _context: unknown): _context is HeaderTemplateContext;
+	static ɵfac: i0.ɵɵFactoryDeclaration<CortexHeaderDirective, never>;
+	static ɵdir: i0.ɵɵDirectiveDeclaration<CortexHeaderDirective, "ng-template[cortexHeader]", never, {}, {}, never, never, true, never>;
+}
 /** The chat widget: the thread list, the open conversation and its composer, for the agent `config` points at. */
 export declare class CortexChatWidgetComponent implements OnInit {
 	readonly config: import("@angular/core").InputSignal<CortexAngularConfig>;
 	protected readonly debugMode: import("@angular/core").WritableSignal<boolean>;
-	protected readonly screen: import("@angular/core").WritableSignal<"threads" | "chat">;
+	protected readonly screen: import("@angular/core").WritableSignal<"chat" | "threads">;
 	protected readonly sidebarOpen: import("@angular/core").WritableSignal<boolean>;
 	protected readonly viewMode: import("@angular/core").Signal<CortexViewMode>;
 	private readonly composer;
+	/** The host's own header, if it gave one; it replaces the default on both screens. */
+	protected readonly customHeader: import("@angular/core").Signal<CortexHeaderDirective | undefined>;
+	protected readonly chatHeader: import("@angular/core").Signal<{
+		screen: "chat" | "threads";
+		viewMode: CortexViewMode;
+		title: string | null;
+		agentName: string | undefined;
+		isWorking: boolean;
+		debug: {
+			shown: boolean;
+			on: boolean;
+		};
+		newChat: () => void;
+		openHistory: () => void;
+		closeHistory: () => void;
+		toggleDebug: () => void;
+	}>;
+	protected readonly threadsHeader: import("@angular/core").Signal<{
+		screen: "chat" | "threads";
+		viewMode: CortexViewMode;
+		title: string | null;
+		agentName: string | undefined;
+		isWorking: boolean;
+		debug: {
+			shown: boolean;
+			on: boolean;
+		};
+		newChat: () => void;
+		openHistory: () => void;
+		closeHistory: () => void;
+		toggleDebug: () => void;
+	}>;
 	protected chatService: CortexChatService;
 	protected queue: AttachmentQueueService;
 	private readonly injector;
 	private readonly destroyRef;
 	ngOnInit(): void;
+	private headerContext;
 	protected toggleSidebar(): void;
 	protected closeSidebar(): void;
 	protected toggleDebugMode(): void;
@@ -344,7 +422,9 @@ export declare class CortexChatWidgetComponent implements OnInit {
 			"required": true;
 			"isSignal": true;
 		};
-	}, {}, never, never, true, never>;
+	}, {}, [
+		"customHeader"
+	], never, true, never>;
 }
 
 export {};