elastic-input 0.1.0

package/dist/utils/cursorUtils.d.ts

@@ -0,0 +1,16 @@
+export declare function getCaretCharOffset(element: HTMLElement): number;
+export declare function getSelectionCharRange(element: HTMLElement): {
+    start: number;
+    end: number;
+};
+export declare function setCaretCharOffset(element: HTMLElement, offset: number): void;
+/** Set a non-collapsed selection range by character offsets within a contentEditable element. */
+export declare function setSelectionCharRange(element: HTMLElement, start: number, end: number): void;
+/**
+ * Find the DOM node and offset corresponding to a character offset,
+ * treating <br> elements as single newline characters.
+ */
+export declare function findNodeAtOffset(parent: Node, targetOffset: number): {
+    node: Node;
+    offset: number;
+} | null;

package/dist/utils/dateUtils.d.ts

@@ -0,0 +1,8 @@
+export declare function isValidDateString(value: string): boolean;
+export declare function formatDate(date: Date): string;
+export declare function parseDate(value: string): Date | null;
+export declare function getDaysInMonth(year: number, month: number): number;
+export declare function getFirstDayOfMonth(year: number, month: number): number;
+export declare function isSameDay(a: Date, b: Date): boolean;
+export declare function isDateInRange(date: Date, start: Date | null, end: Date | null): boolean;
+export declare function getMonthName(month: number): string;

package/dist/utils/domUtils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Insert text at the current selection/cursor, replacing any selected content.
+ * Uses the modern Range API instead of the deprecated document.execCommand.
+ */
+export declare function insertTextAtCursor(text: string): void;
+/**
+ * Insert a line break (<br>) at the current selection/cursor.
+ * Uses the modern Range API instead of the deprecated document.execCommand.
+ */
+export declare function insertLineBreakAtCursor(): void;
+export declare function getCaretRect(): DOMRect | null;
+export declare function getContainerOffset(container: HTMLElement): {
+    top: number;
+    left: number;
+};
+export declare function getDropdownPosition(caretRect: DOMRect, dropdownHeight: number, dropdownWidth: number): {
+    top: number;
+    left: number;
+};

package/dist/utils/expandSelection.d.ts

@@ -0,0 +1,20 @@
+import { ASTNode } from '../parser/ast';
+import { Token } from '../lexer/tokens';
+
+export interface SelectionRange {
+    start: number;
+    end: number;
+}
+/**
+ * Build the expansion hierarchy for a given cursor offset.
+ *
+ * Returns an array of ranges sorted smallest-to-largest, each
+ * representing one "expand selection" level:
+ *   [0] = token under cursor
+ *   [1] = innermost AST node
+ *   ...
+ *   [N] = root (entire query)
+ *
+ * Duplicate ranges are collapsed so each step widens the selection.
+ */
+export declare function getExpansionRanges(ast: ASTNode | null, tokens: Token[], offset: number): SelectionRange[];

package/dist/utils/extractValues.d.ts

@@ -0,0 +1,26 @@
+import { ASTNode } from '../parser/ast';
+
+/**
+ * Describes a content value extracted from the AST.
+ *
+ * Kinds: term, field_value, range_lower, range_upper, group_term, regex.
+ */
+export type ExtractedValueKind = 'term' | 'field_value' | 'range_lower' | 'range_upper' | 'group_term' | 'regex';
+export interface ExtractedValue {
+    kind: ExtractedValueKind;
+    value: string;
+    quoted: boolean;
+    fieldName?: string;
+    start: number;
+    end: number;
+}
+/**
+ * Walk an AST and extract all content values, returning them as an array
+ * of ExtractedValue descriptors in document order.
+ *
+ * Excludes structural elements (operators, parens, field names, colons,
+ * boost/fuzzy markers, saved searches, history refs, and error nodes).
+ *
+ * Pure function -- no DOM or React dependency. Tree-shakeable if unused.
+ */
+export declare function extractValues(ast: ASTNode | null): ExtractedValue[];

package/dist/utils/smartSelect.d.ts

@@ -0,0 +1,13 @@
+import { Token } from '../lexer/tokens';
+
+/**
+ * Determine the selection range for a smart Ctrl+A press.
+ *
+ * Returns the token range if the cursor is inside an eligible token
+ * and the selection doesn't already cover it. Returns null when the
+ * caller should fall through to normal select-all behavior.
+ */
+export declare function getSmartSelectRange(tokens: Token[], selStart: number, selEnd: number): {
+    start: number;
+    end: number;
+} | null;

package/dist/utils/textUtils.d.ts

@@ -0,0 +1,57 @@
+import { Token } from '../lexer/tokens';
+
+/**
+ * Normalize typographic/smart characters to their ASCII equivalents.
+ * Handles smart quotes (from Outlook, Word, macOS auto-correct, etc.),
+ * em/en dashes, ellipsis, non-breaking spaces, and other common substitutions.
+ */
+export declare function normalizeTypographicChars(text: string): string;
+/** Bracket/quote pairs for selection wrapping. */
+export declare const WRAP_PAIRS: Record<string, string>;
+/**
+ * Wrap a selection range with an open/close pair.
+ * Returns the new text and cursor position (placed after the closing bracket).
+ */
+export declare function wrapSelection(text: string, selStart: number, selEnd: number, openChar: string, closeChar: string): {
+    newValue: string;
+    newCursorPos: number;
+    newSelStart: number;
+    newSelEnd: number;
+};
+/**
+ * Get the plaintext content from a contenteditable element,
+ * converting `<br>` elements to newline characters.
+ *
+ * When the element has no text content (only `<br>` elements), returns `''`.
+ * Browsers leave a `<br>` artifact in empty contentEditable divs; this
+ * check prevents that phantom newline from persisting through the
+ * lex → highlight → innerHTML cycle.
+ */
+export declare function getPlainText(element: HTMLElement): string;
+/**
+ * Find which token index the cursor (character offset) falls within.
+ */
+export declare function findTokenAtOffset(tokens: Token[], offset: number): number;
+/**
+ * Find the token indices that a character range [start, end] spans.
+ * Returns [startIdx, endIdx]. Both are -1 if no token is found.
+ *
+ * At token boundaries (where one token ends and the next begins),
+ * startIdx resolves to the **later** token and endIdx to the **earlier**
+ * one, so a selection exactly covering a single token always returns
+ * matching indices.
+ */
+export declare function getTokenIndexRange(tokens: Token[], start: number, end: number): [number, number];
+/**
+ * Find the previous non-whitespace token index.
+ */
+export declare function findPrevNonWsToken(tokens: Token[], fromIndex: number): number;
+/**
+ * Get the text range for a given token to be replaced by autocomplete.
+ * For FIELD_NAME tokens followed by a COLON, extends the range to include the colon
+ * so that inserting "field:" doesn't produce "field::".
+ */
+export declare function getReplacementRange(token: Token | undefined, cursorOffset: number, tokens?: Token[]): {
+    start: number;
+    end: number;
+};

package/dist/utils/undoStack.d.ts

@@ -0,0 +1,23 @@
+export interface UndoEntry {
+    value: string;
+    cursorPos: number;
+    /** When present and !== cursorPos, represents a selection range [selStart, cursorPos]. */
+    selStart?: number;
+}
+export declare class UndoStack {
+    private stack;
+    private index;
+    private maxSize;
+    constructor(maxSize?: number);
+    /** Push a new state. Clears any redo entries ahead of current position. */
+    push(entry: UndoEntry): void;
+    /** Replace the current entry (used for grouping consecutive typing). */
+    replaceCurrent(entry: UndoEntry): void;
+    undo(): UndoEntry | null;
+    redo(): UndoEntry | null;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    current(): UndoEntry | null;
+    clear(): void;
+    get length(): number;
+}

package/dist/validation/Validator.d.ts

@@ -0,0 +1,39 @@
+import { ASTNode } from '../parser/ast';
+import { FieldConfig, ValidateReturn, ValidateValueContext } from '../types';
+
+/** Callback type for external value validation. */
+export type ValidateValueFn = (context: ValidateValueContext) => ValidateReturn;
+/** A validation or syntax error with character offsets for squiggly underline display. */
+export interface ValidationError {
+    /** Human-readable error description. */
+    message: string;
+    /** Start character offset (inclusive) in the input string. */
+    start: number;
+    /** End character offset (exclusive) in the input string. */
+    end: number;
+    /** The field name this error relates to, if applicable. */
+    field?: string;
+    /** Severity level. `'warning'` renders amber squiggles; `'error'` (default) renders red. */
+    severity?: 'error' | 'warning';
+}
+export declare class Validator {
+    private fields;
+    constructor(fields: FieldConfig[]);
+    validate(ast: ASTNode | null, validateValueFn?: ValidateValueFn): ValidationError[];
+    private walkNode;
+    /** Walk inside a FieldGroup, validating bare terms / field values against the group's field config. */
+    private walkFieldGroup;
+    /** Validate a value against a field config (shared between FieldValue and FieldGroup terms). */
+    private validateFieldValue;
+    /** Flag empty range bounds (e.g. `[TO]`, `[ TO ]`). */
+    private validateEmptyRangeBounds;
+    /** Validate range bounds against a field config. */
+    private validateRangeBounds;
+    /** Post-validation pass: detect mixed AND/OR without parentheses. */
+    private checkAmbiguousPrecedence;
+    private findAndFlagAmbiguity;
+    /** Collect all BooleanExpr operators at the same group level (stop at Group boundaries). */
+    private collectBoolOps;
+    /** Collect non-BooleanExpr children from a BooleanExpr chain. */
+    private collectLeaves;
+}

package/dist/validation/dateValidator.d.ts

@@ -0,0 +1 @@
+export declare function validateDate(value: string): string | null;

package/dist/validation/numberValidator.d.ts

@@ -0,0 +1 @@
+export declare function validateNumber(value: string): string | null;

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "elastic-input",
+  "version": "0.1.0",
+  "description": "Syntax-aware smart autocomplete input for Elastic query syntax",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/krtools/elastic-input.git"
+  },
+  "homepage": "https://github.com/krtools/elastic-input#readme",
+  "bugs": {
+    "url": "https://github.com/krtools/elastic-input/issues"
+  },
+  "keywords": [
+    "react",
+    "elasticsearch",
+    "query-string",
+    "autocomplete",
+    "search-input",
+    "syntax-highlighting",
+    "contenteditable"
+  ],
+  "sideEffects": false,
+  "main": "dist/elastic-input.es.js",
+  "module": "dist/elastic-input.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/elastic-input.es.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite --config vite.demo.config.js",
+    "build": "vite build",
+    "build:demo": "vite build --config vite.demo.config.js",
+    "deploy:pages": "npm run build:demo && gh-pages -d dist-demo",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npx tsc --noEmit && npm test && vite build"
+  },
+  "browserslist": [
+    "Chrome >= 115",
+    "Firefox >= 140",
+    "Safari >= 18.0",
+    "Edge >= 122",
+    "Samsung >= 23"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.30.0",
+    "@types/react": "^16.14.0",
+    "@types/react-dom": "^16.9.0",
+    "gh-pages": "^6.3.0",
+    "react": "^16.14.0",
+    "react-dom": "^16.14.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^3.9.0",
+    "vitest": "^4.1.0"
+  }
+}