#ifndef WSAP_TERM_GSTORE_H
#define WSAP_TERM_GSTORE_H

#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>

struct gstore;
struct term;

/* Create a grapheme store for a terminal. */
struct gstore *term_gstore_new(struct term *t);

/* Free the grapheme store and its memory. */
void term_gstore_free(struct gstore *g);

/* Store a cluster of code points. Return its handle. */
uint32_t term_gstore_intern(struct gstore *g, const uint32_t *cps, int n);

/* Expand a handle to its code points. Return the count. */
int term_gstore_expand(const struct gstore *g, uint32_t handle, uint32_t *cps, int cap);

/* Mark reachable clusters and free unused ones. */
void term_gstore_sweep(struct gstore *g, struct term *t);

/* Mark one cluster handle as reachable. */
void term_gstore_mark(struct gstore *g, uint32_t handle);

/* Return the count of active clusters in the store. */
uint32_t term_gstore_count(const struct gstore *g);

/* Suppress automatic GC sweeps while temporary cell buffers hold handles. */
void term_gstore_pin(struct gstore *g);
void term_gstore_unpin(struct gstore *g);

#endif