elastic-input 0.1.0 → 0.3.0

package/dist/highlighting/rangeHighlight.d.ts

@@ -7,4 +7,4 @@ export interface RangePart {
     text: string;
 }
 export declare function tokenizeRangeContent(value: string): RangePart[];
-export declare function buildRangeHTML(token: Token, colors: Required<ColorConfig>): string;
+export declare function buildRangeHTML(token: Token, colors: Required<ColorConfig>, tokenClassName?: string): string;

package/dist/highlighting/regexHighlight.d.ts

@@ -7,4 +7,4 @@ export interface RegexPart {
     text: string;
 }
 export declare function tokenizeRegexContent(value: string): RegexPart[];
-export declare function buildRegexHTML(token: Token, colors: Required<ColorConfig>): string;
+export declare function buildRegexHTML(token: Token, colors: Required<ColorConfig>, tokenClassName?: string): string;

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export type { AutocompleteOptions } from './autocomplete/AutocompleteEngine';
 export { extractValues } from './utils/extractValues';
 export type { ExtractedValue, ExtractedValueKind } from './utils/extractValues';
 export { DEFAULT_COLORS, DARK_COLORS, DEFAULT_STYLES, DARK_STYLES } from './constants';
-export type { ElasticInputProps, ElasticInputAPI, FieldConfig, FieldsSource, FieldType, SavedSearch, HistoryEntry, SuggestionItem, ColorConfig, StyleConfig, ValidateValueContext, ValidationResult, ValidateReturn, TabContext, TabActionResult, DropdownConfig, FeaturesConfig, } from './types';
+export type { ElasticInputProps, ElasticInputAPI, FieldConfig, FieldsSource, FieldType, SavedSearch, HistoryEntry, SuggestionItem, ColorConfig, StyleConfig, ValidateValueContext, ValidationResult, ValidateReturn, TabContext, TabActionResult, DropdownConfig, DropdownOpenContext, DropdownOpenProp, FeaturesConfig, ClassNamesConfig, } from './types';
 export type { Token, TokenType } from './lexer/tokens';
 export type { ASTNode } from './parser/ast';
 export type { CursorContext, CursorContextType } from './parser/Parser';

package/dist/types.d.ts

@@ -43,18 +43,12 @@ export interface FieldConfig {
     label?: string;
     /** Data type that determines validation and autocomplete behavior. */
     type: FieldType;
-    /** Allowed values for `enum` fields, or value hints for other types. Shown in autocomplete. */
-    suggestions?: string[];
     /** Allowed comparison operators. Defaults to `>`, `>=`, `<`, `<=` for number/date fields. */
     operators?: string[];
     /** Description shown alongside the field in autocomplete suggestions. */
     description?: string;
     /** Custom placeholder hint shown in the dropdown while typing a value for this field (e.g. "Search by company name..."). Overrides the default type-based hint. Set to `false` to suppress the hint entirely. */
     placeholder?: string | false;
-    /** When `true`, the dropdown shows a "Searching..." spinner immediately when entering this field's value (instead of the sync hint). Use for fields whose values are provided by `fetchSuggestions`. @default false */
-    asyncSearch?: boolean;
-    /** Label shown next to the loading spinner for async fields. Accepts a static string or a callback receiving the current partial text. @default "Searching..." */
-    asyncSearchLabel?: string | ((partial: string) => string);
 }
 /** A saved/named search that users can reference with `#name` syntax. */
 export interface SavedSearch {
@@ -199,9 +193,32 @@ export interface StyleConfig {
  * Configuration for the autocomplete dropdown: when it appears, what it shows, and
  * how suggestion items are rendered. All properties are optional with sensible defaults.
  */
+/** Context passed to a `dropdown.open` callback. */
+export interface DropdownOpenContext {
+    /** What caused this evaluation. */
+    trigger: 'input' | 'navigation' | 'ctrlSpace' | 'modeChange';
+    /** Current cursor context from the parser. */
+    context: CursorContext;
+    /** Suggestions the engine has computed (may be empty). */
+    suggestions: Suggestion[];
+    /** Whether the dropdown is currently visible. */
+    isOpen: boolean;
+}
+/**
+ * Value for `dropdown.open`. A string constant for common presets,
+ * or a callback for custom logic.
+ *
+ * Callback return values:
+ * - `true` — force the dropdown open (the engine still decides *what* to show)
+ * - `false` — force the dropdown closed
+ * - `null` — no opinion; let the engine decide
+ */
+export type DropdownOpenProp = 'always' | 'never' | 'manual' | 'input' | ((ctx: DropdownOpenContext) => boolean | null);
 export interface DropdownConfig {
-    /** Controls when the dropdown appears. `'always'` (default) shows it as you type.
-     *  `'never'` disables it entirely. `'manual'` requires Ctrl+Space. @default 'always' */
+    /** Controls when the dropdown appears. Accepts a preset string or a callback.
+     *  @default 'always' */
+    open?: DropdownOpenProp;
+    /** @deprecated Use `open` instead. */
     mode?: 'always' | 'never' | 'manual' | 'input';
     /** When true, the dropdown spans the full input width instead of following the caret. @default false */
     alignToInput?: boolean;
@@ -305,6 +322,32 @@ export interface TabActionResult {
     /** Trigger `onSearch` with the current (post-accept) query. */
     submit?: boolean;
 }
+/**
+ * Custom CSS class names for key DOM elements.
+ * Applied alongside the static `ei-*` classes (not replacing them).
+ */
+export interface ClassNamesConfig {
+    /** Outer container div. */
+    container?: string;
+    /** The contentEditable editor div. */
+    editor?: string;
+    /** The placeholder text div. */
+    placeholder?: string;
+    /** The autocomplete dropdown container. */
+    dropdown?: string;
+    /** The dropdown header div. */
+    dropdownHeader?: string;
+    /** Each dropdown suggestion item div. */
+    dropdownItem?: string;
+    /** Each syntax-highlighted token span (in the HTML output). */
+    token?: string;
+    /** Validation squiggly underline divs. */
+    squiggly?: string;
+    /** Error/warning tooltip div. */
+    tooltip?: string;
+    /** The date picker container. */
+    datePicker?: string;
+}
 /** Field definitions — either a static array or an async loader function. */
 export type FieldsSource = FieldConfig[] | (() => Promise<FieldConfig[]>);
 export interface ElasticInputProps {
@@ -320,10 +363,10 @@ export interface ElasticInputProps {
     value?: string;
     /** Initial value for uncontrolled usage. Ignored if `value` is provided. */
     defaultValue?: string;
-    /** Saved searches available via `#name` syntax. Can be an array or async loader. */
-    savedSearches?: SavedSearch[] | (() => Promise<SavedSearch[]>);
-    /** Search history available via `!` syntax. Can be an array or async loader. */
-    searchHistory?: HistoryEntry[] | (() => Promise<HistoryEntry[]>);
+    /** Saved searches available via `#name` syntax. Array is passed through as-is; callback is called per-keystroke (debounced) with the partial. */
+    savedSearches?: SavedSearch[] | ((partial: string) => Promise<SavedSearch[]>);
+    /** Search history available via `!` syntax. Array is passed through as-is; callback is called per-keystroke (debounced) with the partial. */
+    searchHistory?: HistoryEntry[] | ((partial: string) => Promise<HistoryEntry[]>);
     /** Async callback for fetching field value suggestions. Called with field name and partial text. */
     fetchSuggestions?: (fieldName: string, partial: string) => Promise<SuggestionItem[]>;
     /** Color overrides for syntax highlighting and UI elements. Merged with `DEFAULT_COLORS`. */
@@ -334,6 +377,8 @@ export interface ElasticInputProps {
     placeholder?: string;
     /** CSS class name applied to the outer container `<div>`. */
     className?: string;
+    /** Custom CSS classes for key DOM elements (container, editor, dropdown, etc.). */
+    classNames?: ClassNamesConfig;
     /** Inline styles applied to the outer container `<div>`. */
     style?: React.CSSProperties;
     /** Dropdown behavior, rendering, and appearance configuration. */
@@ -380,4 +425,11 @@ export interface ElasticInputProps {
      * severity), a `{ message, severity }` object, or `null` if valid.
      */
     validateValue?: (context: ValidateValueContext) => ValidateReturn;
+    /**
+     * Custom date parser for date-typed fields. Called during validation and date picker
+     * initialization. Return a `Date` if the string is a valid date, or `null` if not.
+     * When provided, values accepted by this parser bypass the built-in date format checks.
+     * The built-in parser handles YYYY-MM-DD, ISO 8601, and `now±Xd` syntax.
+     */
+    parseDate?: (value: string) => Date | null;
 }

package/dist/utils/cx.d.ts

@@ -0,0 +1,2 @@
+/** Join class names, filtering out falsy values. */
+export declare function cx(...classes: (string | undefined | null | false)[]): string;

package/dist/utils/domUtils.d.ts

@@ -13,6 +13,12 @@ export declare function getContainerOffset(container: HTMLElement): {
     top: number;
     left: number;
 };
+/**
+ * Cap the height used for dropdown positioning to the rendered max height.
+ * The CSS maxHeight clips the dropdown visually, but the flip logic needs
+ * the actual rendered size to avoid positioning the dropdown off-screen.
+ */
+export declare function capDropdownHeight(contentHeight: number, maxHeightPx: number): number;
 export declare function getDropdownPosition(caretRect: DOMRect, dropdownHeight: number, dropdownWidth: number): {
     top: number;
     left: number;

package/dist/validation/Validator.d.ts

@@ -1,5 +1,6 @@
 import { ASTNode } from '../parser/ast';
 import { FieldConfig, ValidateReturn, ValidateValueContext } from '../types';
+import { ParseDateFn } from './dateValidator';
 
 /** Callback type for external value validation. */
 export type ValidateValueFn = (context: ValidateValueContext) => ValidateReturn;
@@ -19,7 +20,7 @@ export interface ValidationError {
 export declare class Validator {
     private fields;
     constructor(fields: FieldConfig[]);
-    validate(ast: ASTNode | null, validateValueFn?: ValidateValueFn): ValidationError[];
+    validate(ast: ASTNode | null, validateValueFn?: ValidateValueFn, parseDateFn?: ParseDateFn): ValidationError[];
     private walkNode;
     /** Walk inside a FieldGroup, validating bare terms / field values against the group's field config. */
     private walkFieldGroup;

package/dist/validation/dateValidator.d.ts

@@ -1 +1,2 @@
-export declare function validateDate(value: string): string | null;
+export type ParseDateFn = (value: string) => Date | null;
+export declare function validateDate(value: string, parseDateFn?: ParseDateFn): string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elastic-input",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Syntax-aware smart autocomplete input for Elastic query syntax",
   "license": "MIT",
   "repository": {