import { ListRef, ListItem, ListOptions, ListMutationResult, ListSupport } from '@napplet/core';

/**
 * Napplet NAP lists sdk entrypoint.
 *
 * @module
 */
/**
 * @napplet/nap/lists -- SDK helpers wrapping window.napplet.lists.
 */

/**
 * Return the NIP-51 list kinds/types this runtime supports.
 *
 * @returns Promise resolving to supported list descriptions.
 */
declare function listsSupported(): Promise<ListSupport[]>;
/**
 * Add items to a runtime-supported NIP-51 list.
 *
 * @param list     List reference by kind or derived type.
 * @param items    Items to add.
 * @param options  Optional create/metadata hints.
 * @returns Promise resolving to the mutation result.
 */
declare function listsAdd(list: ListRef, items: ListItem[], options?: ListOptions): Promise<ListMutationResult>;
/**
 * Remove items from a runtime-supported NIP-51 list.
 *
 * @param list     List reference by kind or derived type.
 * @param items    Items to remove.
 * @param options  Optional runtime hints.
 * @returns Promise resolving to the mutation result.
 */
declare function listsRemove(list: ListRef, items: ListItem[], options?: ListOptions): Promise<ListMutationResult>;

export { listsAdd, listsRemove, listsSupported };