1 files changed, 39 insertions, 0 deletions
diff --git a/src/thumbnail.h b/src/thumbnail.h
new file mode 100644
index 0000000..d8bab86
--- /dev/null
+++ b/src/thumbnail.h
@@ -0,0 +1,39 @@
+#ifndef GGAZE_THUMBNAIL_H
+#define GGAZE_THUMBNAIL_H
+
+/*:*
+ * ggaze — thumbnail cache
+ *
+ * freedesktop Thumbnail Managing Standard: ~/.cache/thumbnails/normal (128)
+ * and large (256), plus a custom x-large bucket for >256 (decision #37/T).
+ * Stores PNG with Thumb::URI/MTime/Size; verifies mtime before trust. Decodes
+ * asynchronously in a GTask worker; the GdkTexture is returned on the main
+ * thread. See docs/tech-stack.md "Thumbnail cache".
+ *
+ * Copyright (c) 2026 ggaze contributors
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ *:*/
+
+#include <gdk/gdk.h>
+#include <gio/gio.h>
+#include <glib.h>
+
+G_BEGIN_DECLS
+
+typedef struct Thumbnail Thumbnail;
+
+Thumbnail *thumbnail_new(void);
+void       thumbnail_delete(Thumbnail *p_t);
+
+/* Asynchronously get a thumbnail for p_file at ~i_size px (the nearest TMS
+ * bucket >= i_size is cached). Returns the GdkTexture via p_cb on the main
+ * thread (transfer full in thumbnail_get_finish). */
+void thumbnail_get_async(Thumbnail *p_t, GFile *p_file, int i_size,
+                         GCancellable *p_cancel, GAsyncReadyCallback p_cb,
+                         gpointer p_data);
+GdkTexture *thumbnail_get_finish(Thumbnail *p_t, GAsyncResult *p_res,
+                                 GError **p_err);
+
+G_END_DECLS
+
+#endif /* GGAZE_THUMBNAIL_H */
+\ No newline at end of file