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

/**
 * Napplet NAP lists shim entrypoint.
 *
 * @module
 */

/**
 * Handle lists.* messages from the shell via the central message listener.
 */
declare function handleListsMessage(msg: {
    type: string;
    [key: string]: unknown;
}): void;
/**
 * Return the NIP-51 list kinds/types this runtime supports by policy and
 * implementation.
 *
 * @returns Promise resolving to the supported list descriptions.
 */
declare function supported(): Promise<ListSupport[]>;
/**
 * Add items to a runtime-supported NIP-51 list.
 *
 * The runtime owns lookup, NIP-51 tag formatting, private item encryption,
 * signing, and publishing.
 *
 * @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 add(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 remove(list: ListRef, items: ListItem[], options?: ListOptions): Promise<ListMutationResult>;
/**
 * Install the lists shim. Registration-only -- mutations are issued on demand.
 *
 * @returns cleanup function that rejects pending requests and clears state.
 */
declare function installListsShim(): () => void;

export { add, handleListsMessage, installListsShim, remove, supported };