@copilotkitnext/angular 0.0.0-max-changeset-20260109174803

package/dist/lib/slots/slot.utils.d.ts

@@ -0,0 +1,110 @@
+import { Type, ViewContainerRef, ComponentRef, EmbeddedViewRef } from "@angular/core";
+import { SlotValue, RenderSlotOptions, SlotRegistryEntry } from "./slot.types";
+/**
+ * Renders a slot value into a ViewContainerRef.
+ * This is the core utility for slot rendering.
+ *
+ * @param viewContainer - The ViewContainerRef to render into
+ * @param options - Options for rendering the slot
+ * @returns The created component or embedded view reference
+ *
+ * @example
+ * ```typescript
+ * export class MyComponent {
+ *   @ViewChild('container', { read: ViewContainerRef }) container!: ViewContainerRef;
+ *
+ *   renderButton() {
+ *     renderSlot(this.container, {
+ *       slot: this.buttonOverride,
+ *       defaultComponent: DefaultButton,
+ *       props: { text: 'Click me' },
+ *       outputs: { click: (event) => this.handleClick(event) }
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare function renderSlot<T = any>(viewContainer: ViewContainerRef, options: RenderSlotOptions<T>): ComponentRef<T> | EmbeddedViewRef<T> | null;
+/**
+ * Checks if a value is a component type.
+ * Simplified check - rely on try/catch for actual validation.
+ */
+export declare function isComponentType(value: any): boolean;
+/**
+ * Checks if a value is a valid slot value.
+ */
+export declare function isSlotValue(value: any): value is SlotValue;
+/**
+ * Normalizes a slot value to a consistent format.
+ */
+export declare function normalizeSlotValue<T = any>(value: SlotValue<T> | undefined, defaultComponent: Type<T> | undefined): SlotRegistryEntry<T>;
+/**
+ * Creates a slot configuration map for a component.
+ *
+ * @example
+ * ```typescript
+ * const slots = createSlotConfig({
+    standalone: true,
+*   sendButton: CustomSendButton,
+ *   toolbar: 'custom-toolbar-class',
+ *   footer: footerTemplate
+ * }, {
+ *   sendButton: DefaultSendButton,
+ *   toolbar: DefaultToolbar,
+ *   footer: DefaultFooter
+ * });
+ * ```
+ */
+export declare function createSlotConfig<T extends Record<string, Type<any>>>(overrides: Partial<Record<keyof T, SlotValue>>, defaults: T): Map<keyof T, SlotRegistryEntry>;
+/**
+ * Provides slot configuration to child components via DI.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+  standalone: true,
+*   providers: [
+ *     provideSlots({
+ *       sendButton: CustomSendButton,
+ *       toolbar: CustomToolbar
+ *     })
+ *   ]
+ * })
+ * ```
+ */
+export declare function provideSlots(slots: Record<string, Type<any>>): {
+    provide: import("@angular/core").InjectionToken<ReadonlyMap<string, SlotRegistryEntry<any>>>;
+    useValue: Map<string, SlotRegistryEntry<any>>;
+};
+/**
+ * Gets slot configuration from DI.
+ * Must be called within an injection context.
+ *
+ * @example
+ * ```typescript
+ * export class MyComponent {
+ *   slots = getSlotConfig();
+ *
+ *   ngOnInit() {
+ *     const sendButton = this.slots?.get('sendButton');
+ *   }
+ * }
+ * ```
+ */
+export declare function getSlotConfig(): ReadonlyMap<string, SlotRegistryEntry> | null;
+/**
+ * Creates a render function for a specific slot.
+ * Useful for creating reusable slot renderers.
+ *
+ * @example
+ * ```typescript
+ * const renderSendButton = createSlotRenderer(
+ *   DefaultSendButton,
+ *   'sendButton'
+ * );
+ *
+ * // Later in template
+ * renderSendButton(this.viewContainer, this.sendButtonOverride);
+ * ```
+ */
+export declare function createSlotRenderer<T>(defaultComponent: Type<T>, slotName?: string): (viewContainer: ViewContainerRef, slot?: SlotValue<T>, props?: Partial<T>, outputs?: Record<string, (event: any) => void>) => ComponentRef<T> | EmbeddedViewRef<T>;

package/dist/lib/tools.d.ts

@@ -0,0 +1,65 @@
+import { Signal, Type } from "@angular/core";
+import { FrontendTool } from "@copilotkitnext/core";
+import { z } from "zod";
+export type AngularToolCall<Args extends Record<string, unknown> = Record<string, unknown>> = {
+    args: Partial<Args>;
+    status: "in-progress";
+    result: undefined;
+} | {
+    args: Args;
+    status: "executing";
+    result: undefined;
+} | {
+    args: Args;
+    status: "complete";
+    result: string;
+};
+export type HumanInTheLoopToolCall<Args extends Record<string, unknown> = Record<string, unknown>> = {
+    args: Partial<Args>;
+    status: "in-progress";
+    result: undefined;
+    respond: (result: unknown) => void;
+} | {
+    args: Args;
+    status: "executing";
+    result: undefined;
+    respond: (result: unknown) => void;
+} | {
+    args: Args;
+    status: "complete";
+    result: string;
+    respond: (result: unknown) => void;
+};
+export interface ToolRenderer<Args extends Record<string, unknown> = Record<string, unknown>> {
+    toolCall: Signal<AngularToolCall<Args>>;
+}
+export interface HumanInTheLoopToolRenderer<Args extends Record<string, unknown> = Record<string, unknown>> {
+    toolCall: Signal<HumanInTheLoopToolCall<Args>>;
+}
+export type ClientTool<Args extends Record<string, unknown> = Record<string, unknown>> = Omit<FrontendTool<Args>, "handler"> & {
+    renderer?: Type<ToolRenderer<Args>>;
+};
+export interface RenderToolCallConfig<Args extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    args: z.ZodType<Args>;
+    component: Type<ToolRenderer<Args>>;
+    agentId?: string;
+}
+export interface FrontendToolConfig<Args extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    description: string;
+    parameters: z.ZodType<Args>;
+    component?: Type<ToolRenderer<Args>>;
+    handler: (args: Args) => Promise<unknown>;
+    agentId?: string;
+}
+export interface HumanInTheLoopConfig<Args extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    description: string;
+    parameters: z.ZodType<Args>;
+    component: Type<HumanInTheLoopToolRenderer<Args>>;
+    agentId?: string;
+}
+export declare function registerRenderToolCall<Args extends Record<string, unknown> = Record<string, unknown>>(renderToolCall: RenderToolCallConfig<Args>): void;
+export declare function registerFrontendTool<Args extends Record<string, unknown> = Record<string, unknown>>(frontendTool: FrontendToolConfig<Args>): void;
+export declare function registerHumanInTheLoop<Args extends Record<string, unknown> = Record<string, unknown>>(humanInTheLoop: HumanInTheLoopConfig<Args>): void;

package/dist/lib/utils.d.ts

@@ -0,0 +1,6 @@
+import { type ClassValue } from "clsx";
+/**
+ * Utility function to merge Tailwind CSS classes
+ * Combines clsx for conditional classes and tailwind-merge for proper Tailwind class merging
+ */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/public-api.d.ts

@@ -0,0 +1,47 @@
+export * from "./lib/config";
+export * from "./lib/copilotkit";
+export * from "./lib/tools";
+export * from "./lib/render-tool-calls";
+export * from "./lib/agent";
+export * from "./lib/chat-config";
+export * from "./lib/chat-state";
+export * from "./lib/scroll-position";
+export * from "./lib/resize-observer";
+export * from "./lib/utils";
+export * from "./lib/agent-context";
+export * from "./lib/slots";
+export * from "./lib/directives/copilotkit-agent-context";
+export * from "./lib/directives/stick-to-bottom";
+export * from "./lib/directives/tooltip";
+export * from "./lib/components/chat/copilot-chat";
+export * from "./lib/components/chat/copilot-chat-assistant-message";
+export * from "./lib/components/chat/copilot-chat-assistant-message-buttons";
+export * from "./lib/components/chat/copilot-chat-assistant-message-renderer";
+export * from "./lib/components/chat/copilot-chat-assistant-message-toolbar";
+export * from "./lib/components/chat/copilot-chat-assistant-message.types";
+export * from "./lib/components/chat/copilot-chat-audio-recorder";
+export * from "./lib/components/chat/copilot-chat-buttons";
+export * from "./lib/components/chat/copilot-chat-input";
+export * from "./lib/components/chat/copilot-chat-input-defaults";
+export * from "./lib/components/chat/copilot-chat-input.types";
+export * from "./lib/components/chat/copilot-chat-message-view";
+export * from "./lib/components/chat/copilot-chat-message-view-cursor";
+export * from "./lib/components/chat/copilot-chat-message-view.types";
+export * from "./lib/components/chat/copilot-chat-textarea";
+export * from "./lib/components/chat/copilot-chat-tool-calls-view";
+export * from "./lib/components/chat/copilot-chat-toolbar";
+export * from "./lib/components/chat/copilot-chat-tools-menu";
+export * from "./lib/components/chat/copilot-chat-user-message";
+export * from "./lib/components/chat/copilot-chat-user-message-branch-navigation";
+export * from "./lib/components/chat/copilot-chat-user-message-buttons";
+export * from "./lib/components/chat/copilot-chat-user-message-renderer";
+export * from "./lib/components/chat/copilot-chat-user-message-toolbar";
+export * from "./lib/components/chat/copilot-chat-user-message.types";
+export * from "./lib/components/chat/copilot-chat-view";
+export * from "./lib/components/chat/copilot-chat-view-disclaimer";
+export * from "./lib/components/chat/copilot-chat-view-feather";
+export * from "./lib/components/chat/copilot-chat-view-handlers";
+export * from "./lib/components/chat/copilot-chat-view-input-container";
+export * from "./lib/components/chat/copilot-chat-view-scroll-to-bottom-button";
+export * from "./lib/components/chat/copilot-chat-view-scroll-view";
+export * from "./lib/components/chat/copilot-chat-view.types";