@magicx-eng/ai-autocomplete-vanilla 0.9.0 → 0.10.0

package/dist/index.d.mts

@@ -563,6 +563,14 @@ declare class AIAutocomplete {
     private setupContainer;
     private buildAndRenderFull;
     private buildAndRenderDropdown;
+    /**
+     * Re-render when the viewport crosses the mobile breakpoint, so the options
+     * grid's mobile/web column policy (see computeOptionsGridLayout) updates live
+     * while the dropdown is open and otherwise idle. Mirrors the matchMedia
+     * listener in the React grid and the window:resize HostListener in Angular.
+     * The unsubscribe is registered for cleanup in destroy().
+     */
+    private subscribeViewportBreakpoint;
     /** Batched render subscriber — coalesces multiple store.set calls into one DOM update. */
     private subscribeBatchedRender;
     /** Auto-clear newParamId after shimmer animation. */
@@ -599,6 +607,42 @@ declare class AIAutocomplete {
     private maybePromoteExactMatch;
 }
 
+/**
+ * Rows/columns policy for the dropdown's options grid.
+ *
+ * All three packages render the same grid and must agree on the policy, so it
+ * lives here (in the core) and is imported by the React and Angular shells
+ * rather than reimplemented per package — the way the rest of the shared logic
+ * works. Duplicating it left the row-height and footer-band constants free to
+ * drift three ways with three green suites.
+ */
+/** The viewport width the grid treats as "phone" — same breakpoint as the mobile footer. */
+declare const OPTIONS_GRID_MOBILE_QUERY = "(max-width: 768px)";
+interface OptionsGridLayout {
+    /** Column count for `grid-template-columns`. */
+    cols: number;
+    /** Rows visible before the list scrolls. */
+    rows: number;
+    /** Value for `--aia-grid-max-height` — caps the scroll box at `rows` rows. */
+    maxHeight: string;
+}
+/**
+ * - Mobile: one column, five rows visible (scroll past five).
+ * - Web: one column, four rows visible by default — but when there are exactly
+ *   five or six options, two balanced columns (so 5/6 fit without scrolling).
+ *   Columns fill row-major, so the two columns end up 3/2 (five) or 3/3 (six).
+ */
+declare function computeOptionsGridLayout(count: number, isMobile: boolean): OptionsGridLayout;
+/**
+ * `grid-template-columns` for a fixed column count. Space-separated
+ * `minmax(0,1fr)` tracks (no `repeat()`, no inner spaces) so rows fill
+ * row-major — which the keyboard controller assumes — and the track count reads
+ * back correctly wherever computed styles aren't fully resolved.
+ */
+declare function optionsGridTemplateColumns(cols: number): string;
+/** Whether the current viewport is phone-width. `false` when there's no DOM. */
+declare function isOptionsGridMobileViewport(): boolean;
+
 /**
  * Plain-text caret utilities for contentEditable elements.
  *
@@ -764,4 +808,4 @@ declare function withSkippedParams(completed: CompletedParam[], skipped: Skipped
  */
 declare function buildSubmitResult(text: string, completedParams: CompletedParamState[], skippedParams?: SkippedParamState[]): AutocompleteResult;
 
-export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type IdentifiedParam, type IdentifiedParamState, type InputItem, ModeController, type OptionOverrides, type Product, type ProductsConfig, type RecentlySuggested, type RenderMode, SKIPPED_PARAM_TEXT, type Segment, type SkippedParamState, type Store, type Suggestion, type SuggestionOption, type TaskKind, buildAttributionUrl, buildQuery, buildSubmitResult, createStore, cursorIsAtEnd, extractPlainText, getCursorOffset, getFooterHint, plainTextLength, previousGraphemeBoundary, renderEditableContent, setCursorOffset, withSkippedParams };
+export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type IdentifiedParam, type IdentifiedParamState, type InputItem, ModeController, OPTIONS_GRID_MOBILE_QUERY, type OptionOverrides, type OptionsGridLayout, type Product, type ProductsConfig, type RecentlySuggested, type RenderMode, SKIPPED_PARAM_TEXT, type Segment, type SkippedParamState, type Store, type Suggestion, type SuggestionOption, type TaskKind, buildAttributionUrl, buildQuery, buildSubmitResult, computeOptionsGridLayout, createStore, cursorIsAtEnd, extractPlainText, getCursorOffset, getFooterHint, isOptionsGridMobileViewport, optionsGridTemplateColumns, plainTextLength, previousGraphemeBoundary, renderEditableContent, setCursorOffset, withSkippedParams };

package/dist/index.d.ts

@@ -563,6 +563,14 @@ declare class AIAutocomplete {
     private setupContainer;
     private buildAndRenderFull;
     private buildAndRenderDropdown;
+    /**
+     * Re-render when the viewport crosses the mobile breakpoint, so the options
+     * grid's mobile/web column policy (see computeOptionsGridLayout) updates live
+     * while the dropdown is open and otherwise idle. Mirrors the matchMedia
+     * listener in the React grid and the window:resize HostListener in Angular.
+     * The unsubscribe is registered for cleanup in destroy().
+     */
+    private subscribeViewportBreakpoint;
     /** Batched render subscriber — coalesces multiple store.set calls into one DOM update. */
     private subscribeBatchedRender;
     /** Auto-clear newParamId after shimmer animation. */
@@ -599,6 +607,42 @@ declare class AIAutocomplete {
     private maybePromoteExactMatch;
 }
 
+/**
+ * Rows/columns policy for the dropdown's options grid.
+ *
+ * All three packages render the same grid and must agree on the policy, so it
+ * lives here (in the core) and is imported by the React and Angular shells
+ * rather than reimplemented per package — the way the rest of the shared logic
+ * works. Duplicating it left the row-height and footer-band constants free to
+ * drift three ways with three green suites.
+ */
+/** The viewport width the grid treats as "phone" — same breakpoint as the mobile footer. */
+declare const OPTIONS_GRID_MOBILE_QUERY = "(max-width: 768px)";
+interface OptionsGridLayout {
+    /** Column count for `grid-template-columns`. */
+    cols: number;
+    /** Rows visible before the list scrolls. */
+    rows: number;
+    /** Value for `--aia-grid-max-height` — caps the scroll box at `rows` rows. */
+    maxHeight: string;
+}
+/**
+ * - Mobile: one column, five rows visible (scroll past five).
+ * - Web: one column, four rows visible by default — but when there are exactly
+ *   five or six options, two balanced columns (so 5/6 fit without scrolling).
+ *   Columns fill row-major, so the two columns end up 3/2 (five) or 3/3 (six).
+ */
+declare function computeOptionsGridLayout(count: number, isMobile: boolean): OptionsGridLayout;
+/**
+ * `grid-template-columns` for a fixed column count. Space-separated
+ * `minmax(0,1fr)` tracks (no `repeat()`, no inner spaces) so rows fill
+ * row-major — which the keyboard controller assumes — and the track count reads
+ * back correctly wherever computed styles aren't fully resolved.
+ */
+declare function optionsGridTemplateColumns(cols: number): string;
+/** Whether the current viewport is phone-width. `false` when there's no DOM. */
+declare function isOptionsGridMobileViewport(): boolean;
+
 /**
  * Plain-text caret utilities for contentEditable elements.
  *
@@ -764,4 +808,4 @@ declare function withSkippedParams(completed: CompletedParam[], skipped: Skipped
  */
 declare function buildSubmitResult(text: string, completedParams: CompletedParamState[], skippedParams?: SkippedParamState[]): AutocompleteResult;
 
-export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type IdentifiedParam, type IdentifiedParamState, type InputItem, ModeController, type OptionOverrides, type Product, type ProductsConfig, type RecentlySuggested, type RenderMode, SKIPPED_PARAM_TEXT, type Segment, type SkippedParamState, type Store, type Suggestion, type SuggestionOption, type TaskKind, buildAttributionUrl, buildQuery, buildSubmitResult, createStore, cursorIsAtEnd, extractPlainText, getCursorOffset, getFooterHint, plainTextLength, previousGraphemeBoundary, renderEditableContent, setCursorOffset, withSkippedParams };
+export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type IdentifiedParam, type IdentifiedParamState, type InputItem, ModeController, OPTIONS_GRID_MOBILE_QUERY, type OptionOverrides, type OptionsGridLayout, type Product, type ProductsConfig, type RecentlySuggested, type RenderMode, SKIPPED_PARAM_TEXT, type Segment, type SkippedParamState, type Store, type Suggestion, type SuggestionOption, type TaskKind, buildAttributionUrl, buildQuery, buildSubmitResult, computeOptionsGridLayout, createStore, cursorIsAtEnd, extractPlainText, getCursorOffset, getFooterHint, isOptionsGridMobileViewport, optionsGridTemplateColumns, plainTextLength, previousGraphemeBoundary, renderEditableContent, setCursorOffset, withSkippedParams };