import { type AtomType } from "./atom";
type Row<T> = T & {
    id: string;
};
export type StorageListItem<T> = Omit<T, "id"> & {
    id?: string;
};
/**
 * Sync list atom backed by localStorage or sessionStorage.
 * Always an array (default `[]`). `update` is hidden.
 */
export type StorageList<T extends {
    id?: string;
} = {
    id: string;
}> = Omit<AtomType<Row<T>[]>, "update"> & {
    (): Row<T>[];
    get(): Row<T>[];
    set(value: Row<T>[] | ((prev: Row<T>[]) => Row<T>[]), silently?: boolean): void;
    /** Add a row. Assigns `uuid()` when `id` is missing. Returns the id. */
    add(item: StorageListItem<T>): string;
    /** Delete a row by id. */
    delete(id: string): void;
    /** Clear every row. */
    clearAll(): void;
};
/**
 * Reactive list in `localStorage` under `mates_ls_list:${name}`.
 * Synchronous. Defaults to `[]` when missing.
 */
export declare function LSList<T extends {
    id?: string;
} = {
    id: string;
}>(name: string): StorageList<T>;
/**
 * Reactive list in `sessionStorage` under `mates_ss_list:${name}`.
 * Synchronous. Defaults to `[]` when missing. Tab-scoped (no cross-tab sync).
 */
export declare function SSList<T extends {
    id?: string;
} = {
    id: string;
}>(name: string): StorageList<T>;
/** @internal */
export declare function __resetStorageListsForTests(): void;
export {};
//# sourceMappingURL=LSList.d.ts.map