@magicx-eng/ai-autocomplete-vanilla 0.1.19 → 0.1.20

package/{index.d.mts → dist/index.d.mts}

@@ -19,6 +19,37 @@ interface Suggestion {
     required: boolean;
     options?: SuggestionOption[];
 }
+interface InputItem {
+    type: string;
+    text: string;
+    state: "completed" | "in_progress";
+}
+interface AutocompleteRequest {
+    data: {
+        raw_query: string;
+        completed_params: CompletedParam[];
+        contact_account_count?: number;
+    };
+    meta: {
+        request_id: string;
+        request_at: string;
+        language: string;
+        client_version: string;
+        session_id: string;
+    };
+}
+interface AutocompleteResponse {
+    data: {
+        raw_query: string;
+        input: InputItem[];
+        suggestions: Suggestion[];
+        is_ready?: boolean;
+    };
+    meta: {
+        request_id: string;
+        request_at: string;
+    };
+}
 interface CompletedParamState extends CompletedParam {
     id: string;
     text: string;
@@ -303,6 +334,65 @@ declare class AIAutocomplete {
     private maybePromoteExactMatch;
 }
 
+/**
+ * Plain-text caret utilities for contentEditable elements.
+ *
+ * Offsets are measured in plain-text characters that come from the editable
+ * region only — subtrees inside `[contenteditable="false"]` (e.g. pills)
+ * contribute zero characters. Callers can think in string offsets without
+ * touching DOM Ranges directly.
+ */
+declare function extractPlainText(root: HTMLElement): string;
+declare function plainTextLength(root: HTMLElement): number;
+/**
+ * Read the current caret offset (in plain-text characters) within `root`.
+ * Returns null when no selection is anchored inside `root`.
+ */
+declare function getCursorOffset(root: HTMLElement): number | null;
+/**
+ * Set the caret at the given plain-text offset within `root`.
+ *
+ * Boundary policy: when the offset falls at the seam between text nodes, the
+ * caret is placed at the START of the *following* text node so newly typed
+ * characters do not inherit a preceding `<strong>`'s bold styling. When the
+ * caret would land at the trailing edge of a text node inside a `<strong>`
+ * with no following text node, we use `setStartAfter(strong)` so the caret
+ * sits OUTSIDE the bold subtree — otherwise a caret at the end of a strong's
+ * text is still "inside" the strong, which would falsely trigger re-edit mode.
+ */
+declare function setCursorOffset(root: HTMLElement, offset: number): void;
+/**
+ * True when the caret offset equals the editable's plain-text length —
+ * meaning the only content to the right is non-editable (e.g. trailing pills).
+ */
+declare function cursorIsAtEnd(root: HTMLElement): boolean;
+/**
+ * Step back one grapheme from a plain-text offset, falling back to one UTF-16
+ * code unit when Intl.Segmenter is unavailable. Used by Backspace handling so
+ * emoji and combining marks are deleted as a single user-perceived character.
+ */
+declare function previousGraphemeBoundary(text: string, offset: number): number;
+
+interface RenderEditableArgs {
+    input: HTMLElement;
+    segments: Segment[];
+    newParamId: string | null;
+    /** When set, the matching `<strong>` is decorated with the editing class. */
+    editingParamId: string | null;
+    placeholderText: string;
+    isFocused: boolean;
+}
+/**
+ * Renders text segments — including bold `<strong>` runs for completed params
+ * — into the contentEditable input. Pills are NOT rendered here; they live as
+ * a sibling element so the editable's subtree never contains non-editable
+ * children. See renderInput.ts for the pill list placement.
+ *
+ * Skips rebuilds when the segment key is unchanged so an in-flight shimmer
+ * animation isn't interrupted by unrelated state churn.
+ */
+declare function renderEditableContent(args: RenderEditableArgs): void;
+
 type Listener<S> = (next: S, prev: S) => void;
 interface Store<S> {
     get: () => S;
@@ -311,4 +401,30 @@ interface Store<S> {
 }
 declare function createStore<S>(initial: S): Store<S>;
 
-export { AIAutocomplete, type APIConfig, type APIKeyConfig, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type RenderMode, type Segment, type Store, type Suggestion, type SuggestionOption, createStore };
+interface BuildQueryResult {
+    rawQuery: string;
+    completedParams: CompletedParamState[];
+}
+/**
+ * Takes the raw input text and completed params (without placeholders),
+ * replaces each completed param's text in the string with a {{TYPE_N}} token,
+ * and returns the transformed query + params with placeholders filled in.
+ *
+ * Replacements happen left-to-right, first occurrence only per param.
+ * Counter is per-type (e.g. {{TASK_1}}, {{GOAL_1}}, {{GOAL_2}}).
+ */
+declare function buildQuery(text: string, completedParams: CompletedParamState[]): BuildQueryResult;
+
+declare class ModeController {
+    private container;
+    private mode;
+    private mediaQuery;
+    constructor(container: HTMLElement, mode?: AppearanceMode);
+    setMode(mode: AppearanceMode): void;
+    destroy(): void;
+    private apply;
+    private onSystemChange;
+    private detachListener;
+}
+
+export { AIAutocomplete, type APIConfig, type APIKeyConfig, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type InputItem, ModeController, type OptionOverrides, type RenderMode, type Segment, type Store, type Suggestion, type SuggestionOption, type TaskKind, buildQuery, createStore, cursorIsAtEnd, extractPlainText, getCursorOffset, plainTextLength, previousGraphemeBoundary, renderEditableContent, setCursorOffset };

package/{index.d.ts → dist/index.d.ts}

@@ -19,6 +19,37 @@ interface Suggestion {
     required: boolean;
     options?: SuggestionOption[];
 }
+interface InputItem {
+    type: string;
+    text: string;
+    state: "completed" | "in_progress";
+}
+interface AutocompleteRequest {
+    data: {
+        raw_query: string;
+        completed_params: CompletedParam[];
+        contact_account_count?: number;
+    };
+    meta: {
+        request_id: string;
+        request_at: string;
+        language: string;
+        client_version: string;
+        session_id: string;
+    };
+}
+interface AutocompleteResponse {
+    data: {
+        raw_query: string;
+        input: InputItem[];
+        suggestions: Suggestion[];
+        is_ready?: boolean;
+    };
+    meta: {
+        request_id: string;
+        request_at: string;
+    };
+}
 interface CompletedParamState extends CompletedParam {
     id: string;
     text: string;
@@ -303,6 +334,65 @@ declare class AIAutocomplete {
     private maybePromoteExactMatch;
 }
 
+/**
+ * Plain-text caret utilities for contentEditable elements.
+ *
+ * Offsets are measured in plain-text characters that come from the editable
+ * region only — subtrees inside `[contenteditable="false"]` (e.g. pills)
+ * contribute zero characters. Callers can think in string offsets without
+ * touching DOM Ranges directly.
+ */
+declare function extractPlainText(root: HTMLElement): string;
+declare function plainTextLength(root: HTMLElement): number;
+/**
+ * Read the current caret offset (in plain-text characters) within `root`.
+ * Returns null when no selection is anchored inside `root`.
+ */
+declare function getCursorOffset(root: HTMLElement): number | null;
+/**
+ * Set the caret at the given plain-text offset within `root`.
+ *
+ * Boundary policy: when the offset falls at the seam between text nodes, the
+ * caret is placed at the START of the *following* text node so newly typed
+ * characters do not inherit a preceding `<strong>`'s bold styling. When the
+ * caret would land at the trailing edge of a text node inside a `<strong>`
+ * with no following text node, we use `setStartAfter(strong)` so the caret
+ * sits OUTSIDE the bold subtree — otherwise a caret at the end of a strong's
+ * text is still "inside" the strong, which would falsely trigger re-edit mode.
+ */
+declare function setCursorOffset(root: HTMLElement, offset: number): void;
+/**
+ * True when the caret offset equals the editable's plain-text length —
+ * meaning the only content to the right is non-editable (e.g. trailing pills).
+ */
+declare function cursorIsAtEnd(root: HTMLElement): boolean;
+/**
+ * Step back one grapheme from a plain-text offset, falling back to one UTF-16
+ * code unit when Intl.Segmenter is unavailable. Used by Backspace handling so
+ * emoji and combining marks are deleted as a single user-perceived character.
+ */
+declare function previousGraphemeBoundary(text: string, offset: number): number;
+
+interface RenderEditableArgs {
+    input: HTMLElement;
+    segments: Segment[];
+    newParamId: string | null;
+    /** When set, the matching `<strong>` is decorated with the editing class. */
+    editingParamId: string | null;
+    placeholderText: string;
+    isFocused: boolean;
+}
+/**
+ * Renders text segments — including bold `<strong>` runs for completed params
+ * — into the contentEditable input. Pills are NOT rendered here; they live as
+ * a sibling element so the editable's subtree never contains non-editable
+ * children. See renderInput.ts for the pill list placement.
+ *
+ * Skips rebuilds when the segment key is unchanged so an in-flight shimmer
+ * animation isn't interrupted by unrelated state churn.
+ */
+declare function renderEditableContent(args: RenderEditableArgs): void;
+
 type Listener<S> = (next: S, prev: S) => void;
 interface Store<S> {
     get: () => S;
@@ -311,4 +401,30 @@ interface Store<S> {
 }
 declare function createStore<S>(initial: S): Store<S>;
 
-export { AIAutocomplete, type APIConfig, type APIKeyConfig, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type RenderMode, type Segment, type Store, type Suggestion, type SuggestionOption, createStore };
+interface BuildQueryResult {
+    rawQuery: string;
+    completedParams: CompletedParamState[];
+}
+/**
+ * Takes the raw input text and completed params (without placeholders),
+ * replaces each completed param's text in the string with a {{TYPE_N}} token,
+ * and returns the transformed query + params with placeholders filled in.
+ *
+ * Replacements happen left-to-right, first occurrence only per param.
+ * Counter is per-type (e.g. {{TASK_1}}, {{GOAL_1}}, {{GOAL_2}}).
+ */
+declare function buildQuery(text: string, completedParams: CompletedParamState[]): BuildQueryResult;
+
+declare class ModeController {
+    private container;
+    private mode;
+    private mediaQuery;
+    constructor(container: HTMLElement, mode?: AppearanceMode);
+    setMode(mode: AppearanceMode): void;
+    destroy(): void;
+    private apply;
+    private onSystemChange;
+    private detachListener;
+}
+
+export { AIAutocomplete, type APIConfig, type APIKeyConfig, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type InputItem, ModeController, type OptionOverrides, type RenderMode, type Segment, type Store, type Suggestion, type SuggestionOption, type TaskKind, buildQuery, createStore, cursorIsAtEnd, extractPlainText, getCursorOffset, plainTextLength, previousGraphemeBoundary, renderEditableContent, setCursorOffset };