feat(registry): add registry index, cache and workers

Author: GaspardKirira

vix-site/package.json

@@ -13,7 +13,8 @@
     "docs:preview": "vitepress preview docs",
     "release": "npm run build && npm run docs:build && node scripts/deploy.js",
     "deploy": "npm run release",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "registry:build": "node tools/build_registry_index.js"
   },
   "dependencies": {
     "vue": "^3.5.24",

vix-site/public/registry/index/all.min.json

@@ -0,0 +1 @@
+{"meta":{"registryId":"vixcpp-registry","specVersion":"1.0.0","generatedAt":"2026-02-10T15:36:29.772Z","sourceRepo":"https://github.com/vixcpp/registry","indexFormat":"json-per-package","entryCount":2},"entries":[{"description":"","displayName":"binary_search","homepage":"https://github.com/Gaspardkirira/binary_search","keywords":[],"latest":"0.1.1","license":"MIT","maintainers":[{"github":"","name":""}],"manifestPath":"vix.json","name":"binary_search","namespace":"gaspardkirira","repo":{"defaultBranch":"main","url":"https://github.com/Gaspardkirira/binary_search"},"type":"header-only","versions":{"0.1.1":{"commit":"b2cc3302637f336f2a798f8bf4e855c4b20f7522","notes":"Fix registry id + publishable commit","tag":"v0.1.1"}}},{"description":"Tiny header-only example library for demonstrating the Vix Registry workflow.","displayName":"tree","homepage":"https://github.com/GaspardKirira/tree","keywords":["c++","header-only","demo","registry","vix"],"latest":"0.7.0","license":"MIT","maintainers":[{"github":"GaspardKirira","name":"Gaspard Kirira"}],"manifestPath":"vix.json","name":"tree","namespace":"gaspardkirira","repo":{"defaultBranch":"main","url":"https://github.com/GaspardKirira/tree"},"type":"header-only","versions":{"0.1.0":{"commit":"ffcf9d703e6113f5ac5887c99b45baaccf7e4937","notes":"Initial demo release","tag":"v0.1.0"},"0.2.0":{"commit":"b79ba53ca60a78a3c4b7baaa1da728907ee0a5fa","notes":"Add count_leaves helper","tag":"v0.2.0"},"0.5.0":{"commit":"b184d0cf2220f825ca41139bede5543c5e717df4","notes":"Add index_by_id helper","tag":"v0.5.0"},"0.6.0":{"commit":"6d6a9abdf1b80a85b2f97832153b754f9f746629","notes":"Add count_internal_nodes helper","tag":"v0.6.0"},"0.7.0":{"commit":"18363babf297b4050d2585596238012faee65d52","notes":"Add tree helper","tag":"v0.7.0"}}}]}

vix-site/src/data/github_stats.json

@@ -1,6 +1,6 @@
 {
   "repo": "vixcpp/vix",
-  "fetched_at": "2026-02-10T15:24:19.487Z",
+  "fetched_at": "2026-02-10T15:36:35.833Z",
   "stars": 267,
   "forks": 22,
   "open_issues": 182,

vix-site/src/lib/loadRegistryIndex.js

@@ -0,0 +1,46 @@
+import { getCachedRegistry, setCachedRegistry } from "@/lib/registryCache";
+
+const REGISTRY_URL = "/registry/index/all.min.json";
+
+async function safeFetchJson(url, timeoutMs = 2500) {
+  const ctrl = new AbortController();
+  const t = setTimeout(() => ctrl.abort(), timeoutMs);
+
+  try {
+    const res = await fetch(url, {
+      cache: "no-cache",
+      signal: ctrl.signal,
+    });
+    if (!res.ok) throw new Error(`http_${res.status}`);
+    return await res.json();
+  } finally {
+    clearTimeout(t);
+  }
+}
+
+export async function loadRegistryIndex() {
+  // 1) instant: cache d'abord
+  const cached = await getCachedRegistry();
+  if (cached?.data) {
+    // on tente un refresh en parallèle (mais sans bloquer l'UI)
+    refreshInBackground(cached.meta?.generatedAt || "");
+    return { source: "cache", data: cached.data };
+  }
+
+  // 2) sinon: réseau
+  const data = await safeFetchJson(REGISTRY_URL, 6000);
+  await setCachedRegistry(data.meta || null, data);
+  return { source: "network", data };
+}
+
+async function refreshInBackground(currentVersion) {
+  try {
+    const data = await safeFetchJson(REGISTRY_URL, 2500);
+    const v = data?.meta?.generatedAt || "";
+    if (v && v !== currentVersion) {
+      await setCachedRegistry(data.meta || null, data);
+    }
+  } catch {
+    // ignore: réseau instable
+  }
+}

vix-site/src/lib/registryCache.js

@@ -0,0 +1,73 @@
+const DB_NAME = "vix_registry_cache";
+const DB_VERSION = 1;
+
+const STORE_META = "meta";
+const STORE_BLOBS = "blobs";
+
+function openDb() {
+  return new Promise((resolve, reject) => {
+    const req = indexedDB.open(DB_NAME, DB_VERSION);
+
+    req.onupgradeneeded = () => {
+      const db = req.result;
+
+      if (!db.objectStoreNames.contains(STORE_META)) {
+        db.createObjectStore(STORE_META, { keyPath: "key" });
+      }
+      if (!db.objectStoreNames.contains(STORE_BLOBS)) {
+        db.createObjectStore(STORE_BLOBS, { keyPath: "key" });
+      }
+    };
+
+    req.onsuccess = () => resolve(req.result);
+    req.onerror = () => reject(req.error);
+  });
+}
+
+function txGet(store, key) {
+  return new Promise((resolve, reject) => {
+    const req = store.get(key);
+    req.onsuccess = () => resolve(req.result || null);
+    req.onerror = () => reject(req.error);
+  });
+}
+
+function txPut(store, value) {
+  return new Promise((resolve, reject) => {
+    const req = store.put(value);
+    req.onsuccess = () => resolve(true);
+    req.onerror = () => reject(req.error);
+  });
+}
+
+export async function getCachedRegistry() {
+  const db = await openDb();
+  const tx = db.transaction([STORE_META, STORE_BLOBS], "readonly");
+  const metaStore = tx.objectStore(STORE_META);
+  const blobStore = tx.objectStore(STORE_BLOBS);
+
+  const meta = await txGet(metaStore, "registry_meta");
+  const blob = await txGet(blobStore, "registry_all_json");
+
+  db.close();
+
+  if (!meta || !blob || !blob.json) return null;
+
+  return {
+    meta: meta.value || null,
+    data: blob.json,
+  };
+}
+
+export async function setCachedRegistry(meta, json) {
+  const db = await openDb();
+  const tx = db.transaction([STORE_META, STORE_BLOBS], "readwrite");
+  const metaStore = tx.objectStore(STORE_META);
+  const blobStore = tx.objectStore(STORE_BLOBS);
+
+  await txPut(metaStore, { key: "registry_meta", value: meta });
+  await txPut(blobStore, { key: "registry_all_json", json });
+
+  db.close();
+  return true;
+}

vix-site/src/pages/registry/RegistryBrowse.vue

@@ -1,5 +1,184 @@
+<script setup>
+import { ref, onMounted, watch, onBeforeUnmount } from "vue";
+import { useRoute } from "vue-router";
+import { loadRegistryIndex } from "@/lib/loadRegistryIndex";
+
+import RegistrySearchWorker from "@/workers/registrySearch.worker.js?worker";
+
+const route = useRoute();
+
+const q = ref((route.query.q || "").toString());
+const hits = ref([]);
+const total = ref(0);
+const loading = ref(true);
+const version = ref("");
+const error = ref("");
+
+const worker = new RegistrySearchWorker();
+
+function doSearch() {
+  worker.postMessage({
+    type: "search",
+    query: q.value || "",
+    limit: 20
+  });
+}
+
+onMounted(async () => {
+  worker.onmessage = (ev) => {
+    const msg = ev.data || {};
+    if (msg.type === "loaded") {
+      version.value = msg.version || "";
+      loading.value = false;
+      doSearch();
+    }
+    if (msg.type === "searchResult") {
+      hits.value = msg.hits || [];
+      total.value = msg.total || 0;
+      version.value = msg.version || version.value;
+    }
+    if (msg.type === "error") {
+      error.value = msg.error || "worker_error";
+    }
+  };
+
+  try {
+    const { data } = await loadRegistryIndex();
+    worker.postMessage({ type: "load", data });
+  } catch {
+    loading.value = false;
+    error.value = "cannot_load_registry";
+  }
+});
+
+onBeforeUnmount(() => {
+  worker.terminate();
+});
+
+watch(
+  () => route.query.q,
+  (v) => {
+    q.value = (v || "").toString();
+    doSearch();
+  }
+);
+</script>
+
 <template>
-  <h1>Registry Browse</h1>
+  <section class="reg-browse">
+    <header class="top">
+      <div>
+        <h1 class="title">Browse packages</h1>
+        <p v-if="version" class="muted">Index: {{ version }}</p>
+      </div>
+
+      <div v-if="q" class="muted">Query: "{{ q }}"</div>
+    </header>
+
+    <div v-if="loading" class="muted">Loading registry…</div>
+    <div v-else-if="error" class="muted">Error: {{ error }}</div>
+
+    <div v-else>
+      <div v-if="!q" class="muted">Type a query to search.</div>
+
+      <div v-else-if="total === 0" class="muted">
+        No results for "{{ q }}".
+      </div>
+
+      <div v-else class="muted">Found {{ total }} result(s).</div>
+
+      <ul class="list">
+        <li v-for="h in hits" :key="h.id" class="item">
+          <div class="row">
+            <div class="id">{{ h.id }}</div>
+            <div class="ver">{{ h.latest }}</div>
+          </div>
+
+          <div v-if="h.description" class="desc">{{ h.description }}</div>
+
+          <a
+            v-if="h.repo"
+            class="repo"
+            :href="h.repo"
+            target="_blank"
+            rel="noreferrer"
+          >
+            {{ h.repo }}
+          </a>
+        </li>
+      </ul>
+    </div>
+  </section>
 </template>
 
+<style scoped>
+.reg-browse{
+  padding: 26px 18px;
+  max-width: 980px;
+  margin: 0 auto;
+}
+
+.top{
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  gap: 16px;
+  flex-wrap: wrap;
+}
+
+.title{
+  margin: 0;
+  font-size: 1.55rem;
+  font-weight: 900;
+  color: #e5f9f6;
+}
+
+.muted{
+  color: rgba(148,163,184,.95);
+}
+
+.list{
+  list-style: none;
+  padding: 0;
+  margin: 18px 0 0;
+  display: grid;
+  gap: 14px;
+}
+
+.item{
+  border: 1px solid rgba(148,163,184,.18);
+  border-radius: 12px;
+  padding: 14px;
+  background: rgba(2,6,23,.35);
+}
+
+.row{
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+  align-items: baseline;
+}
+
+.id{
+  font-weight: 900;
+  color: #e5f9f6;
+}
+
+.ver{
+  font-weight: 800;
+  color: rgba(94,234,212,.95);
+}
+
+.desc{
+  margin-top: 6px;
+  color: rgba(226,232,240,.92);
+}
 
+.repo{
+  display: inline-block;
+  margin-top: 8px;
+  color: rgba(147,197,253,.95);
+  text-decoration: underline;
+  text-underline-offset: 3px;
+}
+</style>