@theseam/ui-common 1.0.2-beta.57 → 1.0.2-beta.58

package/ai/index.d.ts

@@ -1,2 +1,144 @@
+import * as i0 from '@angular/core';
+import { AfterViewInit, InjectionToken, Type } from '@angular/core';
+import { BehaviorSubject, Observable } from 'rxjs';
+import * as _angular_cdk_testing from '@angular/cdk/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
+import { FormGroup, FormControl } from '@angular/forms';
+import { DatatableComponent, ColumnsAlterationState } from '@theseam/ui-common/datatable';
+import { AlterationDisplayItem } from '@theseam/ui-common/datatable-alterations-display';
 
-export { };
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+interface ChatResponse {
+    content: string;
+}
+interface AiProvider {
+    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+}
+
+declare class LmStudioAiProvider implements AiProvider {
+    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+}
+
+declare class OpenRouterAiProvider implements AiProvider {
+    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+}
+
+type MockResponse = string | ((messages: ChatMessage[]) => string);
+declare class MockAiProvider implements AiProvider {
+    private readonly _response;
+    constructor(_response?: MockResponse);
+    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+}
+
+type ChatContentSegment = {
+    type: 'markdown';
+    content: string;
+} | {
+    type: 'custom-block';
+    tag: string;
+    content: string;
+};
+/**
+ * Splits a raw AI response string into an ordered array of segments.
+ * Fenced code blocks with `seam-` prefixed language tags become custom-block
+ * segments; everything else stays as markdown.
+ */
+declare function parseChatResponse(input: string): ChatContentSegment[];
+
+interface ChatMessageDisplayModel {
+    role: 'user' | 'assistant';
+    segments: ChatContentSegment[];
+    timestamp: Date;
+}
+
+declare class TheSeamChatComponent implements AfterViewInit {
+    private readonly _provider;
+    private readonly _cdr;
+    private readonly _ngZone;
+    systemPrompt: string;
+    placeholder: string;
+    private _messageList?;
+    private _messageListScrollbar?;
+    readonly _loadingSubject: BehaviorSubject<boolean>;
+    private _messages;
+    _displayMessages: ChatMessageDisplayModel[];
+    private readonly _pinnedThreshold;
+    private _isPinnedToBottom;
+    private _forceScrollOnNextResize;
+    ngAfterViewInit(): void;
+    _onMessageSent(text: string): Promise<void>;
+    private _updatePinnedState;
+    private _maybeScrollToBottom;
+    private _scrollToBottom;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TheSeamChatComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TheSeamChatComponent, "seam-chat", never, { "systemPrompt": { "alias": "systemPrompt"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare const THESEAM_CHAT_PROVIDER: InjectionToken<AiProvider>;
+
+type ChatBlockRegistry = Map<string, Type<unknown>>;
+declare const THESEAM_CHAT_BLOCK_REGISTRY: InjectionToken<ChatBlockRegistry>;
+
+declare class TheSeamChatMessageHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly _role;
+    private readonly _content;
+    getRole(): Promise<string>;
+    getText(): Promise<string>;
+}
+declare class TheSeamChatInputHarness extends ComponentHarness {
+    static hostSelector: string;
+    getSendButton(): Promise<_angular_cdk_testing.TestElement>;
+    isSendDisabled(): Promise<boolean>;
+}
+declare class TheSeamChatHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly _messages;
+    private readonly _input;
+    private readonly _loading;
+    getMessages(): Promise<TheSeamChatMessageHarness[]>;
+    getInput(): Promise<TheSeamChatInputHarness>;
+    isLoading(): Promise<boolean>;
+}
+
+declare const assistantPrompt = "You are a helpful assistant that provides formatting json code for a datatable.\nA datatable is a table that displays data in rows and columns, similar to a spreadsheet, with column sorting and data filtering.\n\nYour job is not to provide a descriptive analysis of the request or any additional information. The user will ignore anything that is not a JSON object.\n\nThe user will provide a request, and you will respond with a JSON object that contains an array of table alterations.\nThe following is the typescript interface for a datatable column and the alterations you can make to it:\n\n```typescript\ninterface TableColumn {\n  /** Column property */\n  prop: string,\n  /** Column name */\n  name: string,\n  /** Column cell type - determines filter type */\n  cellType?: 'string' | 'integer' | 'decimal' | 'currency' | 'date' | 'phone',\n  /** Whether the column is sortable */\n  sortable?: boolean,\n  /** Whether the column is filterable */\n  filterable?: boolean,\n  /** Whether the column is visible */\n  visible?: boolean,\n  /** Whether the column is resizable */\n  resizable?: boolean,\n  /** Whether the column is draggable */\n  draggable?: boolean,\n  /** Column width */\n  width?: number,\n  /** Column index */\n  index?: number,\n}\n\ninterface SortItem {\n  /** Column property */\n  prop: string,\n  /** Sort direction */\n  dir: 'asc' | 'desc'\n}\n\ninterface SortState {\n  /** The list of sorts */\n  sorts: SortItem[]\n}\n\ninterface OrderRecord {\n  /** Column property */\n  columnProp: string,\n  /** Column order, which is the index that it will be placed in the columns array. */\n  index: number\n}\n\ninterface OrderState {\n  /** The list of column order records */\n  columns: OrderRecord[]\n}\n\ninterface WidthState {\n  /** The column property that this width alteration applies to */\n  columnProp: string\n  /** The width of the column. Number is in pixels. */\n  width?: number\n  /** Whether the column can auto resize. Needs to be false to guarantee a specific width. */\n  canAutoResize: boolean\n}\n\ninterface HideColumnState {\n  /** The column property that this alteration applies to */\n  columnProp: string\n  /** Whether the column is hidden */\n  hidden: boolean\n}\n\ninterface FilterState {\n  /** The column property that this filter applies to */\n  columnProp: string,\n  /** The filter type based on column cellType */\n  filterType: 'text' | 'numeric' | 'date',\n  /** The filter operation */\n  operation: string,\n  /** The filter value (for single value operations) */\n  value?: any,\n  /** The from value (for range operations like 'between') */\n  fromValue?: any,\n  /** The to value (for range operations like 'between') */\n  toValue?: any\n}\n\ninterface TableAlteration<TType extends string, TState> {\n  /**\n   * Unique identifier for the alteration.\n   */\n  id: string\n  /**\n   * The type of alteration.\n   */\n  type: TType\n  /** The alteration state */\n  state: TState\n}\n\n/**\n * Sort alteration for a datatable.\n * \"id\" should always be \"sort\" for this alteration.\n */\ntype SortAlteration = TableAlteration<'sort', SortState>\n\n/**\n * Order alteration for a datatable column.\n *\n * \"id\" should always be \"order\" for this alteration.\n */\ntype OrderAlteration = TableAlteration<'order', OrderState>\n\n/**\n * Width alteration for a datatable column.\n *\n * \"id\" should always be \"width-<prop>\" for this alteration. So, for example, if the column property is \"name\", the id would be \"width-name\".\n */\ntype WidthAlteration = TableAlteration<'width', WidthState>\n\n/**\n * Hide column alteration for a datatable column.\n *\n * \"id\" should always be \"hide-column-<prop>\" for this alteration. So, for example, if the column property is \"name\", the id would be \"hide-column-name\".\n */\ntype HideColumnAlteration = TableAlteration<'hide-column', HideColumnState>\n\n/**\n * Filter alteration for a datatable column.\n * \"id\" should be \"filter--<columnProp>\" for this alteration.\n * For example, if filtering the \"age\" column, the id would be \"filter--age\".\n */\ntype FilterAlteration = TableAlteration<'filter', FilterState>\n```\n\n## Filter Operations by Type\n\n### Text Filters (cellType: 'string', 'phone')\n- 'contains': Text contains the value (case-insensitive)\n- 'eq': Text equals the value exactly\n- 'neq': Text does not equal the value\n- 'ncontains': Text does not contain the value\n- 'blank': Field is empty/null\n- 'not-blank': Field is not empty/null\n\n### Numeric Filters (cellType: 'integer', 'decimal', 'currency')\n- 'eq': Equals the value\n- 'gt': Greater than the value\n- 'gte': Greater than or equal to the value\n- 'lt': Less than the value\n- 'lte': Less than or equal to the value\n- 'between': Between fromValue and toValue (inclusive)\n- 'not-between': Not between fromValue and toValue\n- 'blank': Field is empty/null\n- 'not-blank': Field is not empty/null\n\n### Date Filters (cellType: 'date')\n- 'eq': Date equals the value\n- 'gt': Date is after the value\n- 'gte': Date is on or after the value\n- 'lt': Date is before the value\n- 'lte': Date is on or before the value\n- 'between': Date is between fromValue and toValue (inclusive)\n- 'not-between': Date is not between fromValue and toValue\n- 'blank': Field is empty/null\n- 'not-blank': Field is not empty/null\n\n## Examples\n\nFilter age greater than 30:\n```json\n{\n  \"id\": \"filter--age\",\n  \"type\": \"filter\",\n  \"state\": {\n    \"columnProp\": \"age\",\n    \"filterType\": \"numeric\",\n    \"operation\": \"gt\",\n    \"value\": 30\n  }\n}\n```\n\nFilter color contains \"red\":\n```json\n{\n  \"id\": \"filter--color\",\n  \"type\": \"filter\",\n  \"state\": {\n    \"columnProp\": \"color\",\n    \"filterType\": \"text\",\n    \"operation\": \"contains\",\n    \"value\": \"red\"\n  }\n}\n```\n\nFilter age between 25 and 65:\n```json\n{\n  \"id\": \"filter--age\",\n  \"type\": \"filter\",\n  \"state\": {\n    \"columnProp\": \"age\",\n    \"filterType\": \"numeric\",\n    \"operation\": \"between\",\n    \"fromValue\": 25,\n    \"toValue\": 65\n  }\n}\n```\n\nSort by name ascending:\n```json\n{\n  \"id\": \"sort\",\n  \"type\": \"sort\",\n  \"state\": {\n    \"sorts\": [\n      {\n        \"prop\": \"name\",\n        \"dir\": \"asc\"\n      }\n    ]\n  }\n}\n```\n\nHide the age column:\n```json\n{\n  \"id\": \"hide-column-age\",\n  \"type\": \"hide-column\",\n  \"state\": {\n    \"columnProp\": \"age\",\n    \"hidden\": true\n  }\n}\n```\n\nSet name column width to 300 pixels:\n```json\n{\n  \"id\": \"width-name\",\n  \"type\": \"width\",\n  \"state\": {\n    \"columnProp\": \"name\",\n    \"width\": 300,\n    \"canAutoResize\": false\n  }\n}\n```\n\nReorder columns (name first, age second, color third):\n```json\n{\n  \"id\": \"order\",\n  \"type\": \"order\",\n  \"state\": {\n    \"columns\": [\n      { \"columnProp\": \"name\", \"index\": 0 },\n      { \"columnProp\": \"age\", \"index\": 1 },\n      { \"columnProp\": \"color\", \"index\": 2 }\n    ]\n  }\n}\n```\n";
+declare const getUserPrompt: (columns: any[], request: string) => string;
+declare function parseResponse(responseContent: string, responseFormat: {
+    type: string;
+} | undefined): any;
+declare const THESEAM_DATATABLE_PROMPTER_PROVIDER: InjectionToken<AiProvider>;
+
+declare class TheSeamDatatablePrompterComponent {
+    private readonly _prefsAccessor;
+    private readonly _dtPrefsService;
+    private readonly _aiProvider;
+    readonly _loadingSubject: BehaviorSubject<boolean>;
+    readonly _altsDataSubject: BehaviorSubject<{
+        currentItems: AlterationDisplayItem[];
+        pendingItems: AlterationDisplayItem[];
+    } | undefined>;
+    readonly loading$: Observable<boolean>;
+    diffMode: 'auto' | 'manual';
+    compact: boolean;
+    set prompt(value: string | undefined | null);
+    set datatable(value: DatatableComponent | undefined | null);
+    get datatable(): DatatableComponent | undefined | null;
+    private _datatableSubject;
+    showAlts: boolean;
+    readonly _form: FormGroup<{
+        prompt: FormControl<string | null>;
+    }>;
+    _alterations$: Observable<ColumnsAlterationState[]>;
+    _alterationsDisplayItems$: Observable<AlterationDisplayItem[]>;
+    _pendingAlterationsSubject: BehaviorSubject<ColumnsAlterationState<any>[]>;
+    _pendingAlterationsDisplayItems$: Observable<AlterationDisplayItem[]>;
+    _onSubmit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TheSeamDatatablePrompterComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TheSeamDatatablePrompterComponent, "seam-datatable-prompter", never, { "diffMode": { "alias": "diffMode"; "required": false; }; "compact": { "alias": "compact"; "required": false; }; "prompt": { "alias": "prompt"; "required": false; }; "datatable": { "alias": "datatable"; "required": false; }; "showAlts": { "alias": "showAlts"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+export { LmStudioAiProvider, MockAiProvider, OpenRouterAiProvider, THESEAM_CHAT_BLOCK_REGISTRY, THESEAM_CHAT_PROVIDER, THESEAM_DATATABLE_PROMPTER_PROVIDER, TheSeamChatComponent, TheSeamChatHarness, TheSeamDatatablePrompterComponent, assistantPrompt, getUserPrompt, parseChatResponse, parseResponse };
+export type { AiProvider, ChatBlockRegistry, ChatContentSegment, ChatMessage, ChatResponse };