mypgs 1.5.0 → 1.6.0

package/dist/index.d.ts

@@ -17,8 +17,12 @@ declare global {
   }
 
   interface PgsOptionApi {
+    add(...values: PgsStateValue[]): PgsOptionApi;
+    remove(...values: PgsStateValue[]): PgsOptionApi;
+    toggle(value: string, force?: boolean): boolean;
     contains(key: string): boolean;
     getValueBrackets(key: string): string | undefined;
+    setValueBrackets(key: string, value?: string): PgsOptionApi;
     value: string | null;
   }
 
@@ -39,6 +43,71 @@ declare global {
 
   type PgsApi = PgsElementApi | PgsDocumentApi;
 
+  type PgsSearchSuggestionInput = string | number | {
+    label?: string;
+    value?: string | number;
+    disabled?: boolean;
+    data?: unknown;
+  };
+
+  interface PgsSearchSuggestion {
+    label: string;
+    value: string;
+    disabled: boolean;
+    data: unknown;
+  }
+
+  interface PgsSearchSourceContext {
+    query: string;
+    signal: AbortSignal;
+    limit: number;
+    element: Element;
+    input: HTMLInputElement;
+  }
+
+  interface PgsSearchSelectDetail {
+    item: PgsSearchSuggestion;
+    index: number;
+    value: string;
+    input: HTMLInputElement;
+    element: Element;
+  }
+
+  interface PgsSearchOptions {
+    minLength: number;
+    debounce: number;
+    limit: number;
+    submitOnSelect: boolean;
+    searchOnFocus: boolean;
+    source: PgsSearchSuggestionInput[] | ((context: PgsSearchSourceContext) => PgsSearchSuggestionInput[] | Promise<PgsSearchSuggestionInput[]>) | null;
+    onSelect: ((detail: PgsSearchSelectDetail) => void) | null;
+  }
+
+  interface PgsSearchInstance {
+    element: Element;
+    input: HTMLInputElement;
+    list: Element;
+    configure(options: Partial<PgsSearchOptions>): PgsSearchInstance;
+    setSource(source: PgsSearchOptions["source"]): PgsSearchInstance;
+    search(query?: string): Promise<PgsSearchSuggestion[]>;
+    open(): void;
+    close(): void;
+    clear(): void;
+    cancel(): void;
+    select(index?: number, submit?: boolean): PgsSearchSuggestion | null;
+    refresh(): Promise<PgsSearchSuggestion[]>;
+    destroy(): void;
+    items(): PgsSearchSuggestion[];
+    isOpen(): boolean;
+    isLoading(): boolean;
+    setActiveIndex(index: number): void;
+  }
+
+  interface PgsSearchModule {
+    init(root?: Document | Element): void;
+    api(selector: Element): PgsSearchInstance | undefined;
+  }
+
   interface PgsFunction {
     (root: Document): PgsDocumentApi;
     (root: Element): PgsElementApi;
@@ -51,6 +120,7 @@ declare global {
     menu?: any;
     modal?: any;
     notification?: any;
+    search?: PgsSearchModule;
     slides?: any;
     stepTabs?: any;
     steps?: any;
@@ -61,6 +131,14 @@ declare global {
 
   interface PgsBag extends PgsElementApi {}
 
+  namespace React {
+    interface HTMLAttributes<T> {
+      /** Use pgsHtml in JSX/TSX. The Vite plugin converts it to pgs. */
+      pgs?: never;
+      pgsHtml?: string;
+    }
+  }
+
   var pgs: PgsFunction;
 }