siesa-ui-kit 1.0.12 → 1.0.14

package/dist/components/LookupField/LookupField.d.ts

@@ -0,0 +1,6 @@
+import type { LookupFieldProps, LookupFieldRef, LookupRecord } from './LookupField.types';
+import './LookupField.css';
+export declare const LookupField: <TRecord extends LookupRecord = LookupRecord>(props: LookupFieldProps<TRecord> & {
+    ref?: React.Ref<LookupFieldRef<TRecord>>;
+}) => React.ReactElement;
+//# sourceMappingURL=LookupField.d.ts.map

package/dist/components/LookupField/LookupField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LookupField.d.ts","sourceRoot":"","sources":["../../../src/components/LookupField/LookupField.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACzF,OAAO,mBAAmB,CAAA;AA4gC1B,eAAO,MAAM,WAAW,EAAmC,CACzD,OAAO,SAAS,YAAY,GAAG,YAAY,EAE3C,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;CAAE,KAC5E,KAAK,CAAC,YAAY,CAGtB"}

package/dist/components/LookupField/LookupField.types.d.ts

@@ -0,0 +1,285 @@
+import type { FilterExpression, SimpleFilter } from './types/filter.types';
+import type { Fetcher, OrderBy } from './services/api.types';
+/** Generic record type - all records must have an Id (PascalCase standard) */
+export interface LookupRecord {
+    Id: string;
+    [key: string]: unknown;
+}
+/** Data passed to onReady callback [UPDATED v0.4 - removed totalRecords] */
+export interface LookupFieldReadyData {
+    /** Whether the first page of data has been loaded */
+    firstPageLoaded: boolean;
+}
+/** Imperative ref methods for programmatic control */
+export interface LookupFieldRef<TRecord extends LookupRecord = LookupRecord> {
+    /** Clears the current selection */
+    clear: () => void;
+    /** Focuses the component trigger */
+    focus: () => void;
+    /** Forces a fresh data fetch from API */
+    reload: () => void;
+    /** Returns the currently selected record or null */
+    getValue: () => TRecord | null;
+    /** Programmatically selects a record by GUID */
+    setValue: (Id: string) => void;
+    /** Opens the dropdown programmatically */
+    open: () => void;
+    /** Closes the dropdown programmatically */
+    close: () => void;
+    /**
+     * Manually triggers validation and updates internal error state.
+     * Use this before form submission to validate required fields.
+     * Calls onValidationChange callback with the validation result.
+     * @returns true if valid (has selection or not required), false if invalid
+     */
+    validate: () => boolean;
+}
+/** Props for LookupField component */
+export interface LookupFieldProps<TRecord extends LookupRecord = LookupRecord> {
+    /** Entity name for API endpoint (e.g., 'customers', 'products') */
+    entity: string;
+    /** Label displayed above the input. Optional when used in table columns where the column header provides the label. */
+    label?: string;
+    /** Fields to display in dropdown options */
+    displayFields: (keyof TRecord & string)[];
+    /** Currently selected record ID (GUID) or null */
+    value: string | null;
+    /** Callback when selection changes */
+    onChange: (record: TRecord | null, previousRecord: TRecord | null) => void;
+    /**
+     * Fetcher function for API requests (FR29, FR31).
+     * Receives entity name and request, returns the search response.
+     * Gives full control over URL construction, HTTP client, headers, etc.
+     *
+     * Use `createFetcher('/api')` helper for simple cases.
+     *
+     * @example
+     * // Using createFetcher helper
+     * import { createFetcher } from 'siesa-ui-kit'
+     * <LookupField fetcher={createFetcher('/api')} />
+     *
+     * @example
+     * // With auth token
+     * <LookupField
+     *   fetcher={async (entity, request) => {
+     *     const res = await fetch(`/api/${entity}/search`, {
+     *       method: 'POST',
+     *       headers: {
+     *         'Content-Type': 'application/json',
+     *         Authorization: `Bearer ${token}`,
+     *       },
+     *       body: JSON.stringify(request),
+     *     })
+     *     return res.json()
+     *   }}
+     * />
+     *
+     * @example
+     * // With axios
+     * <LookupField
+     *   fetcher={async (entity, request) => {
+     *     const { data } = await axios.post(`/api/${entity}/search`, request)
+     *     return data
+     *   }}
+     * />
+     */
+    fetcher: Fetcher;
+    /** Show clear button to reset selection (default: true) */
+    clearable?: boolean;
+    /** Placeholder text when no value selected */
+    placeholder?: string;
+    /** Additional CSS classes for root element */
+    className?: string;
+    /** Number of records per page (default: 10) */
+    pageSize?: number;
+    /** Callback triggered when an API error occurs */
+    onError?: (error: Error) => void;
+    /** Fields to search against (defaults to displayFields) */
+    searchFields?: (keyof TRecord & string)[];
+    /**
+     * Minimum number of characters required before search is triggered.
+     * When user types fewer characters, a message is shown prompting for more input.
+     * @default 1
+     */
+    minChars?: number;
+    /**
+     * Single field to display for selected value (priority 3).
+     * When set, only this field is shown in the trigger for the selected record.
+     * Priority order: renderSelected > displayTemplate > displayValue > all displayFields concatenated
+     */
+    displayValue?: keyof TRecord & string;
+    /**
+     * Template string with {field} placeholders for selected value display (priority 2).
+     * Example: "{codigo} - {nombre}" displays "C001 - Acme Corporation"
+     * Priority order: renderSelected > displayTemplate > displayValue > all displayFields concatenated
+     */
+    displayTemplate?: string;
+    /**
+     * Custom render function for selected value display (priority 1 - highest).
+     * Receives the selected record and returns the string to display.
+     * Priority order: renderSelected > displayTemplate > displayValue > all displayFields concatenated
+     */
+    renderSelected?: (record: TRecord) => string;
+    /**
+     * Static filters to apply to all API requests.
+     * Accepts simple object format: { activo: true, tipo: "A" }
+     * Or expressive AND/OR format: [[{a:1},{a:2}], [{b:true}]]
+     */
+    filters?: SimpleFilter | FilterExpression;
+    /**
+     * Function that returns dynamic filters.
+     * Called before each API request.
+     * Takes precedence over static `filters` prop when both provided.
+     */
+    getFilters?: () => SimpleFilter | FilterExpression;
+    /**
+     * Array of dependency values that trigger data reload when changed.
+     * Use with `getFilters` to implement cascading lookups.
+     *
+     * **IMPORTANT:** Values must be JSON-serializable (primitives, plain objects, arrays).
+     * Do not include functions, circular references, or non-serializable values.
+     *
+     * @example
+     * // Reload cities when countryId changes
+     * <LookupField
+     *   entity="cities"
+     *   getFilters={() => ({ countryId: selectedCountryId })}
+     *   dependencies={[selectedCountryId]}
+     * />
+     */
+    dependencies?: unknown[];
+    /**
+     * Sort order for API results.
+     * If not specified, defaults to first displayField ascending.
+     *
+     * @example
+     * // Sort by name descending
+     * <LookupField orderBy={{ field: 'nombre', direction: 'desc' }} />
+     */
+    orderBy?: OrderBy;
+    /**
+     * Additional fields to request from API but not display in dropdown.
+     * These fields are available in the record passed to onChange and other callbacks.
+     * Useful for accessing related data for business logic.
+     *
+     * @example
+     * // Request email and phone for use in form logic
+     * <LookupField<Customer>
+     *   entity="customers"
+     *   displayFields={['codigo', 'nombre']}
+     *   bindFields={['email', 'telefono', 'direccion']}
+     *   onChange={(customer) => {
+     *     console.log(customer?.email) // Available!
+     *   }}
+     * />
+     */
+    bindFields?: (keyof TRecord & string)[];
+    /**
+     * Makes the component read-only.
+     * When true: selected value is displayed, dropdown cannot open, no clear button.
+     * Useful for displaying selected values in view-only forms.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * Completely disables the component.
+     * When true:
+     * - Cannot receive focus or be clicked
+     * - Removed from tab navigation order (tabIndex=-1)
+     * - Shows dimmed/grayed appearance (opacity: 0.5)
+     * - Clear button is hidden
+     * - No events fire (onChange, onFocus, onBlur)
+     * - Validation is skipped (always valid)
+     *
+     * Use this for fields that are not applicable in the current context
+     * (e.g., City field disabled until Country is selected).
+     *
+     * Note: Different from `readOnly` which allows focus for accessibility
+     * but prevents editing. Use `readOnly` for view-only forms,
+     * use `disabled` for conditionally unavailable fields.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Indicates validation error state.
+     * When true: red border styling applied, aria-invalid="true".
+     * Component remains interactive so user can fix the error.
+     * @default false
+     */
+    error?: boolean;
+    /**
+     * Callback when component receives focus.
+     * Fires only once when focus enters the component, not on internal focus changes.
+     */
+    onFocus?: (currentRecord: TRecord | null) => void;
+    /**
+     * Callback when component loses focus.
+     * Fires only when focus leaves the entire component, not on internal focus moves.
+     */
+    onBlur?: (currentRecord: TRecord | null) => void;
+    /**
+     * Callback when initial data loads.
+     * Provides data info and imperative ref for programmatic control.
+     * Fires only once per component mount.
+     */
+    onReady?: (data: LookupFieldReadyData, ref: LookupFieldRef<TRecord>) => void;
+    /**
+     * Callback when value prop contains a non-existent GUID.
+     * Use to handle cases where a controlled value no longer exists in the database.
+     */
+    onInvalidValue?: (Id: string) => void;
+    /**
+     * Override text displayed when no results are found.
+     * Bypasses i18n translation when provided.
+     * @default Uses i18n translation for 'noResults' key
+     */
+    noResultsText?: string;
+    /**
+     * Override placeholder text for the search input inside dropdown.
+     * Bypasses i18n translation when provided.
+     * @default Uses i18n translation for 'placeholder' key
+     */
+    searchPlaceholder?: string;
+    /**
+     * Marks the field as required for form validation.
+     * When true: shows asterisk indicator (unless showRequiredIndicator=false),
+     * enables validation on blur (unless validateOnBlur=false),
+     * and sets aria-required="true" for accessibility.
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Controls visibility of the required indicator (asterisk).
+     * When undefined, defaults to the value of `required` prop.
+     * Set to false to hide asterisk even when field is required.
+     * Set to true to show asterisk even when field is not required (unusual).
+     * @default undefined (follows `required` prop)
+     */
+    showRequiredIndicator?: boolean;
+    /**
+     * Enables automatic validation when component loses focus.
+     * When true and required, validates that a selection exists on blur.
+     * Set to false for manual-only validation via ref.validate().
+     * @default true
+     */
+    validateOnBlur?: boolean;
+    /**
+     * Callback fired when validation state changes.
+     * Receives true when validation passes, false when it fails.
+     * Useful for form-level validation state management.
+     */
+    onValidationChange?: (isValid: boolean) => void;
+    /**
+     * Custom error message to display below the field.
+     * When provided, shows a red error message text beneath the input.
+     * Useful for form validation messages from external validation libraries.
+     * @example
+     * <LookupField
+     *   errorText={formErrors.customer}
+     *   error={!!formErrors.customer}
+     * />
+     */
+    errorText?: string;
+}
+//# sourceMappingURL=LookupField.types.d.ts.map

package/dist/components/LookupField/LookupField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LookupField.types.d.ts","sourceRoot":"","sources":["../../../src/components/LookupField/LookupField.types.ts"],"names":[],"mappings":"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"}

package/dist/components/LookupField/__stories__/DocComponents.d.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from 'react';
+type DocBoxType = 'how' | 'tip' | 'example' | 'warning' | 'code' | 'compare';
+interface DocBoxProps {
+    type: DocBoxType;
+    title: string;
+    children: ReactNode;
+}
+export declare function DocBox({ type, title, children }: DocBoxProps): import("react/jsx-runtime").JSX.Element;
+interface CodeBlockProps {
+    children: string;
+}
+export declare function CodeBlock({ children }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
+interface DemoContainerProps {
+    title: string;
+    subtitle?: string;
+    children: ReactNode;
+}
+export declare function DemoContainer({ title, subtitle, children }: DemoContainerProps): import("react/jsx-runtime").JSX.Element;
+interface DemoGridProps {
+    cols?: 1 | 2 | 3;
+    children: ReactNode;
+}
+export declare function DemoGrid({ cols, children }: DemoGridProps): import("react/jsx-runtime").JSX.Element;
+interface PropCodeProps {
+    code: string;
+}
+export declare function PropCode({ code }: PropCodeProps): import("react/jsx-runtime").JSX.Element;
+interface ResultBoxProps {
+    children: ReactNode;
+}
+export declare function ResultBox({ children }: ResultBoxProps): import("react/jsx-runtime").JSX.Element;
+interface TestTipProps {
+    children: ReactNode;
+}
+export declare function TestTip({ children }: TestTipProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=DocComponents.d.ts.map

package/dist/components/LookupField/__stories__/DocComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocComponents.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/__stories__/DocComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,KAAK,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAE5E,UAAU,WAAW;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,SAAS,CAAA;CACpB;AAoBD,wBAAgB,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,WAAW,2CAO5D;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,cAAc,2CAMrD;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB,2CAQ9E;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,QAAQ,CAAC,EAAE,IAAQ,EAAE,QAAQ,EAAE,EAAE,aAAa,2CAQ7D;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,aAAa,2CAE/C;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,cAAc,2CAErD;AAED,UAAU,YAAY;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,YAAY,2CAMjD"}

package/dist/components/LookupField/__stories__/mocks/browser.d.ts

@@ -0,0 +1,2 @@
+export declare const worker: import("msw/browser").SetupWorker;
+//# sourceMappingURL=browser.d.ts.map

package/dist/components/LookupField/__stories__/mocks/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../../src/components/LookupField/__stories__/mocks/browser.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,mCAA2B,CAAA"}

package/dist/components/LookupField/__stories__/mocks/data.d.ts

@@ -0,0 +1,38 @@
+export interface Customer {
+    Id: string;
+    Codigo: string;
+    Nombre: string;
+    Email: string;
+    Ciudad: string;
+    Telefono: string;
+    Activo: boolean;
+    [key: string]: unknown;
+}
+export interface Product {
+    Id: string;
+    Codigo: string;
+    Nombre: string;
+    Precio: number;
+    PrecioDisplay: string;
+    Categoria: string;
+    [key: string]: unknown;
+}
+export interface City {
+    Id: string;
+    Codigo: string;
+    Nombre: string;
+    CountryId: string;
+    Activo: boolean;
+    [key: string]: unknown;
+}
+export interface Country {
+    Id: string;
+    Codigo: string;
+    Nombre: string;
+    [key: string]: unknown;
+}
+export declare const countries: Country[];
+export declare const cities: City[];
+export declare const customers: Customer[];
+export declare const products: Product[];
+//# sourceMappingURL=data.d.ts.map

package/dist/components/LookupField/__stories__/mocks/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../../../src/components/LookupField/__stories__/mocks/data.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,eAAO,MAAM,SAAS,EAAE,OAAO,EAI9B,CAAA;AAED,eAAO,MAAM,MAAM,EAAE,IAAI,EAQxB,CAAA;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAwI/B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,EAiE7B,CAAA"}

package/dist/components/LookupField/__stories__/mocks/handlers.d.ts

@@ -0,0 +1,3 @@
+export declare const setSimulateError: (value: boolean) => void;
+export declare const handlers: import("msw").HttpHandler[];
+//# sourceMappingURL=handlers.d.ts.map

package/dist/components/LookupField/__stories__/mocks/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../../../src/components/LookupField/__stories__/mocks/handlers.ts"],"names":[],"mappings":"AAqHA,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,SAE9C,CAAA;AAED,eAAO,MAAM,QAAQ,6BA2LpB,CAAA"}

package/dist/components/LookupField/hooks/index.d.ts

@@ -0,0 +1,10 @@
+export { useDebouncedSearch } from './useDebouncedSearch';
+export { useKeyboardNavigation } from './useKeyboardNavigation';
+export { useTranslationSafe } from './useTranslationSafe';
+export { useClickOutside } from './useClickOutside';
+export { useFloatingDropdown } from './useFloatingDropdown';
+export { useVirtualList } from './useVirtualList';
+export type { UseKeyboardNavigationOptions, UseKeyboardNavigationResult, } from './useKeyboardNavigation';
+export type { UseFloatingDropdownOptions } from './useFloatingDropdown';
+export type { UseVirtualListOptions, UseVirtualListResult } from './useVirtualList';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/LookupField/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AACvE,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/components/LookupField/hooks/useClickOutside.d.ts

@@ -0,0 +1,11 @@
+import { type RefObject } from 'react';
+/**
+ * Hook to detect clicks outside a referenced element.
+ * Uses mousedown for immediate detection.
+ *
+ * @param ref - Reference to the element to monitor
+ * @param handler - Callback when click outside occurs
+ * @param enabled - Whether the hook is active (default: true)
+ */
+export declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: (event: MouseEvent) => void, enabled?: boolean): void;
+//# sourceMappingURL=useClickOutside.d.ts.map

package/dist/components/LookupField/hooks/useClickOutside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickOutside.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/useClickOutside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA0B,MAAM,OAAO,CAAA;AAE9D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EACnD,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EACpC,OAAO,GAAE,OAAc,GACtB,IAAI,CAoBN"}

package/dist/components/LookupField/hooks/useDebouncedSearch.d.ts

@@ -0,0 +1,2 @@
+export declare function useDebouncedSearch(value: string, delay?: number): string;
+//# sourceMappingURL=useDebouncedSearch.d.ts.map

package/dist/components/LookupField/hooks/useDebouncedSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedSearch.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/useDebouncedSearch.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAoB,GAAG,MAAM,CAcrF"}

package/dist/components/LookupField/hooks/useFloatingDropdown.d.ts

@@ -0,0 +1,38 @@
+import { type Placement } from '@floating-ui/react';
+export interface UseFloatingDropdownOptions {
+    placement?: Placement;
+    offsetPx?: number;
+    enabled?: boolean;
+}
+/**
+ * Hook for dropdown positioning using @floating-ui/react.
+ * Handles viewport boundary detection and auto-positioning.
+ */
+export declare function useFloatingDropdown({ placement, offsetPx, enabled, }?: UseFloatingDropdownOptions): {
+    refs: {
+        reference: import("react").MutableRefObject<import("@floating-ui/react-dom").ReferenceType | null>;
+        floating: React.MutableRefObject<HTMLElement | null>;
+        setReference: (node: import("@floating-ui/react-dom").ReferenceType | null) => void;
+        setFloating: (node: HTMLElement | null) => void;
+    } & import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
+    floatingStyles: import("react").CSSProperties;
+    context: {
+        x: number;
+        y: number;
+        placement: Placement;
+        strategy: import("@floating-ui/utils").Strategy;
+        middlewareData: import("@floating-ui/core").MiddlewareData;
+        isPositioned: boolean;
+        update: () => void;
+        floatingStyles: React.CSSProperties;
+        open: boolean;
+        onOpenChange: (open: boolean, event?: Event, reason?: import("@floating-ui/react").OpenChangeReason) => void;
+        events: import("@floating-ui/react").FloatingEvents;
+        dataRef: React.MutableRefObject<import("@floating-ui/react").ContextData>;
+        nodeId: string | undefined;
+        floatingId: string | undefined;
+        refs: import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
+        elements: import("@floating-ui/react").ExtendedElements<import("@floating-ui/react").ReferenceType>;
+    };
+};
+//# sourceMappingURL=useFloatingDropdown.d.ts.map

package/dist/components/LookupField/hooks/useFloatingDropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingDropdown.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/useFloatingDropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAqB,MAAM,oBAAoB,CAAA;AAEhG,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,SAA0B,EAC1B,QAAY,EACZ,OAAc,GACf,GAAE,0BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BjC"}

package/dist/components/LookupField/hooks/useKeyboardNavigation.d.ts

@@ -0,0 +1,16 @@
+export interface UseKeyboardNavigationOptions<TRecord> {
+    records: TRecord[];
+    isOpen: boolean;
+    onSelect: (record: TRecord) => void;
+    onClose: () => void;
+    onEscape: () => void;
+    onClear: () => void;
+    searchQuery: string;
+}
+export interface UseKeyboardNavigationResult {
+    highlightedIndex: number;
+    setHighlightedIndex: (index: number) => void;
+    handleKeyDown: (event: React.KeyboardEvent) => void;
+}
+export declare function useKeyboardNavigation<TRecord>(options: UseKeyboardNavigationOptions<TRecord>): UseKeyboardNavigationResult;
+//# sourceMappingURL=useKeyboardNavigation.d.ts.map

package/dist/components/LookupField/hooks/useKeyboardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/useKeyboardNavigation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,4BAA4B,CAAC,OAAO;IACnD,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,CAAA;IACxB,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAA;CACpD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAC3C,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAC7C,2BAA2B,CAsF7B"}

package/dist/components/LookupField/hooks/useTranslationSafe.d.ts

@@ -0,0 +1,9 @@
+import { useTranslation } from 'react-i18next';
+type TFunction = (key: string, params?: Record<string, unknown>) => string;
+interface UseTranslationSafeResult {
+    t: TFunction;
+    i18n: ReturnType<typeof useTranslation>['i18n'] | null;
+}
+export declare function useTranslationSafe(): UseTranslationSafeResult;
+export {};
+//# sourceMappingURL=useTranslationSafe.d.ts.map

package/dist/components/LookupField/hooks/useTranslationSafe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslationSafe.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/useTranslationSafe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AA6B9C,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;AAE1E,UAAU,wBAAwB;IAChC,CAAC,EAAE,SAAS,CAAA;IACZ,IAAI,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;CACvD;AAED,wBAAgB,kBAAkB,IAAI,wBAAwB,CAqB7D"}

package/dist/components/LookupField/hooks/useVirtualList.d.ts

@@ -0,0 +1,40 @@
+import { type VirtualItem } from '@tanstack/react-virtual';
+import { type RefObject } from 'react';
+export interface UseVirtualListOptions {
+    /** Total number of items in the list */
+    count: number;
+    /** Reference to the scrollable container element */
+    parentRef: RefObject<HTMLElement | null>;
+    /** Height of each item in pixels (default: 36) */
+    estimateSize?: number;
+    /** Number of extra items to render above/below viewport (default: 5) */
+    overscan?: number;
+    /** Enable/disable virtualization (default: true) */
+    enabled?: boolean;
+}
+export interface UseVirtualListResult {
+    /** Array of virtual items currently visible (plus overscan) */
+    virtualItems: VirtualItem[];
+    /** Total height of all items for scrollbar sizing */
+    totalSize: number;
+    /** Scroll to a specific item index */
+    scrollToIndex: (index: number, options?: {
+        align?: 'start' | 'center' | 'end' | 'auto';
+    }) => void;
+    /** Measure element at index (for dynamic heights if needed) */
+    measureElement: (element: HTMLElement | null) => void;
+}
+/**
+ * Hook for virtualizing a list of items, rendering only visible items in the DOM.
+ * Wraps @tanstack/react-virtual with project-specific defaults.
+ *
+ * @example
+ * ```tsx
+ * const { virtualItems, totalSize } = useVirtualList({
+ *   count: records.length,
+ *   parentRef: scrollContainerRef,
+ * })
+ * ```
+ */
+export declare function useVirtualList({ count, parentRef, estimateSize, overscan, enabled, }: UseVirtualListOptions): UseVirtualListResult;
+//# sourceMappingURL=useVirtualList.d.ts.map

package/dist/components/LookupField/hooks/useVirtualList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualList.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/hooks/useVirtualList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,OAAO,CAAA;AAQnD,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACxC,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACjG,+DAA+D;IAC/D,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CACtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,SAAS,EACT,YAAuC,EACvC,QAA2B,EAC3B,OAAc,GACf,EAAE,qBAAqB,GAAG,oBAAoB,CAc9C"}

package/dist/components/LookupField/index.d.ts

@@ -0,0 +1,7 @@
+export { LookupField } from './LookupField';
+export type { LookupFieldProps, LookupRecord, LookupFieldRef, LookupFieldReadyData, } from './LookupField.types';
+export { createFetcher } from './services/api';
+export type { Fetcher, SearchRequest, SearchResponse, OrderBy, } from './services/api.types';
+export { normalizeFilters, buildExpressiveFilter, mergeFilters, } from './utils/filterBuilder';
+export type { FilterExpression, SimpleFilter, FilterCondition, } from './types/filter.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/LookupField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/LookupField/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,YAAY,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,OAAO,GACR,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,GACb,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,sBAAsB,CAAA"}

package/dist/components/LookupField/parts/LiveRegion.d.ts

@@ -0,0 +1,6 @@
+interface LiveRegionProps {
+    message: string;
+}
+export declare function LiveRegion({ message }: LiveRegionProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=LiveRegion.d.ts.map

package/dist/components/LookupField/parts/LiveRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveRegion.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/parts/LiveRegion.tsx"],"names":[],"mappings":"AAAA,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,eAAe,2CAMtD"}

package/dist/components/LookupField/parts/SearchInput.d.ts

@@ -0,0 +1,11 @@
+interface SearchInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    className?: string;
+    listboxId?: string;
+    activeDescendantId?: string;
+}
+export declare const SearchInput: import("react").ForwardRefExoticComponent<SearchInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export {};
+//# sourceMappingURL=SearchInput.d.ts.map

package/dist/components/LookupField/parts/SearchInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchInput.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/parts/SearchInput.tsx"],"names":[],"mappings":"AAIA,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,eAAO,MAAM,WAAW,+GAoCtB,CAAA"}

package/dist/components/LookupField/services/api.d.ts

@@ -0,0 +1,23 @@
+import type { Fetcher } from './api.types';
+/**
+ * Creates a standard fetcher function for a given base URL.
+ * Use this helper for simple cases where you just need to specify the API base URL.
+ *
+ * @param baseUrl - Base URL for the API (e.g., '/api', 'https://api.example.com')
+ * @returns A fetcher function compatible with LookupField
+ *
+ * @example
+ * // Simple usage
+ * const fetcher = createFetcher('/api')
+ * <LookupField entity="customers" fetcher={fetcher} />
+ *
+ * @example
+ * // With authentication - wrap createFetcher or create custom fetcher
+ * const fetcher = createFetcher('/api', {
+ *   headers: { Authorization: `Bearer ${token}` }
+ * })
+ */
+export declare function createFetcher(baseUrl: string, options?: {
+    headers?: Record<string, string>;
+}): Fetcher;
+//# sourceMappingURL=api.d.ts.map

package/dist/components/LookupField/services/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/components/LookupField/services/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAA;AAOzE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7C,OAAO,CA4BT"}