"use strict"; const $ = (s) => document.querySelector(s); const $$ = (s) => [...document.querySelectorAll(s)]; const esc = (s) => String(s ?? "").replace(/[&<>"']/g, (c) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[c]); const gb = (b) => (b >= 2 ** 30 ? `${(b / 2 ** 30).toFixed(1)} GB` : `${Math.max(1, Math.round(b / 2 ** 20))} MB`); const store = { get(k, d) { try { return JSON.parse(localStorage.getItem(k)) ?? d; } catch { return d; } }, set(k, v) { try { localStorage.setItem(k, JSON.stringify(v)); } catch {} }, }; const S = { cfg: null, cid: null, collections: [], rows: [], byId: new Map(), groups: new Map(), order: [], basket: new Set(), filtered: [], lastClicked: null, user: null, cats: new Set(), allLatents: false, }; // file URL for a manifest path template like "objects/{id}/tile.webp" const asset = (tmpl, id) => S.cfg.asset_base + tmpl.replace("{id}", encodeURIComponent(id)); const tileUrl = (id) => asset(S.cfg.paths.tile, id); const variantWord = () => (S.cid === "gso" ? "colors" : "versions"); const plural = (n, one, many = one + "s") => `${n.toLocaleString()} ${n === 1 ? one : many}`; const pretty = (name) => name.replace(/_/g, " "); // ----------------------------------------------------------------- share links // A subset is a bitset over the catalog sorted by object_id: ~180 chars for all 1,030 objects. function encodeSubset() { const bytes = new Uint8Array(Math.ceil(S.order.length / 8)); S.order.forEach((id, i) => { if (S.basket.has(id)) bytes[i >> 3] |= 1 << (i & 7); }); let s = ""; bytes.forEach((b) => (s += String.fromCharCode(b))); return "s1." + btoa(s).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, ""); } function decodeSubset(code) { if (!code.startsWith("s1.")) return null; const bin = atob(code.slice(3).replace(/-/g, "+").replace(/_/g, "/")); const ids = []; S.order.forEach((id, i) => { if ((bin.charCodeAt(i >> 3) || 0) & (1 << (i & 7))) ids.push(id); }); return ids; } function shareUrl() { const base = S.cfg.app_url || location.origin + location.pathname; return `${base}#${S.cid}:${encodeSubset()}`; } // "#:s1."; links made before collections existed are "#s1." over GSO function parseHash() { const h = location.hash.slice(1); if (!h) return {}; const [cid, code] = h.includes(":") ? h.split(":", 2) : ["gso", h]; return { cid, code }; } // ----------------------------------------------------------------- boot async function boot() { const [cols, me] = await Promise.all([ fetch("/api/collections").then((r) => r.json()), fetch("/api/me").then((r) => r.json()).catch(() => ({ user: null })), ]); S.collections = cols.collections; S.user = me.user ? me : null; const known = (c) => S.collections.some((x) => x.id === c); const hash = parseHash(); const cid = [hash.cid, store.get("collection", null), cols.default].find(known); bindFilters(); bindBasket(); bindTour(); bindLibraries(); renderAuth(); await loadCollection(cid, hash.cid === cid ? hash.code : null); if (!store.get("tour_done", false)) setTimeout(() => startTour(0), 400); } async function loadCollection(cid, code = null) { const cfg = await fetch(`/api/catalog?c=${encodeURIComponent(cid)}`).then((r) => r.json()); S.cfg = cfg; S.cid = cid; S.rows = cfg.rows; S.byId = new Map(); S.groups = new Map(); S.rows.forEach((r) => { S.byId.set(r.object_id, r); if (!S.groups.has(r.group)) S.groups.set(r.group, []); S.groups.get(r.group).push(r.object_id); }); S.order = S.rows.map((r) => r.object_id).sort(); S.allLatents = S.rows.every((r) => r.latents_repo); // then the badge and filter carry no information store.set("collection", cid); const fromHash = code ? decodeSubset(code) : null; const legacy = cid === "gso" ? store.get("basket", []) : []; // before collections, one GSO basket S.basket = new Set((fromHash ?? store.get(`basket:${cid}`, legacy)).filter((id) => S.byId.has(id))); if (fromHash) toast(`Loaded a shared selection of ${S.basket.size} objects from ${cfg.title}`); $("#lib-name").textContent = cfg.title; $("#latents-group").hidden = S.allLatents; $("#size-group").hidden = !cfg.real_size; $("#sort option[value=size]").hidden = !cfg.real_size; if (!cfg.real_size && $("#sort").value === "size") $("#sort").value = "name"; $("#objects-link").href = `https://huggingface.co/datasets/${cfg.objects_repo}`; $("#credit").textContent = cfg.credit; $("#q").placeholder = `Search ${S.rows.length.toLocaleString()} objects in ${cfg.title}…`; $("#q").value = $("#size-min").value = $("#size-max").value = ""; ["#flat", "#watertight", "#one-per-group", "#latents"].forEach((sel) => ($(sel).checked = false)); S.cats.clear(); if (!$("#name").dataset.edited) $("#name").value = `my-${cid}-subset`; renderFacets(); renderFormats(); renderCats(); apply(); renderBasket(); } function renderAuth() { const a = $("#auth"); if (S.user) { a.innerHTML = `${esc(S.user.user)}Sign out`; $("#owner").innerHTML = [S.user.user, ...S.user.orgs].map((o) => ``).join(""); } else { a.innerHTML = `Sign in with Hugging Face`; } $("#hub-export").hidden = !S.user; $("#hub-login").hidden = !!S.user; } // ----------------------------------------------------------------- filters const TOP_CATS = 7; // more chips than this hide behind "More" function renderCats() { const counts = {}; S.rows.forEach((r) => { const c = r.category || "Other"; counts[c] = (counts[c] || 0) + 1; }); const cats = Object.entries(counts).sort((a, b) => (a[0] === "Other") - (b[0] === "Other") || b[1] - a[1]); $("#cats").innerHTML = `` + cats.map(([c, n], i) => ``).join("") + (cats.length > TOP_CATS ? `` : ""); $$("#cats .chip[data-cat]").forEach((b) => b.addEventListener("click", () => { const c = b.dataset.cat; if (!c) S.cats.clear(); else S.cats.has(c) ? S.cats.delete(c) : S.cats.add(c); syncCats(); apply(); })); $("#cats-more")?.addEventListener("click", (e) => { const open = e.currentTarget.dataset.open !== "1"; e.currentTarget.dataset.open = open ? "1" : ""; $$("#cats .chip.extra").forEach((b) => (b.hidden = !open && !S.cats.has(b.dataset.cat))); e.currentTarget.textContent = open ? "Fewer" : `+ ${$$("#cats .chip.extra").length} more`; }); } function syncCats() { $$("#cats .chip[data-cat]").forEach((b) => b.setAttribute("aria-pressed", b.dataset.cat ? S.cats.has(b.dataset.cat) : !S.cats.size)); } // facets beyond `category` (e.g. Smithsonian's museum) become dropdowns in the Filters panel function renderFacets() { const extra = Object.entries(S.cfg.facets).filter(([k]) => k !== "category"); $("#facet-extra").innerHTML = extra.map(([k, label]) => { const counts = {}; S.rows.forEach((r) => { if (r[k]) counts[r[k]] = (counts[r[k]] || 0) + 1; }); const opts = Object.entries(counts).sort((a, b) => b[1] - a[1]); return `

${esc(label)}

`; }).join(""); $$("#facet-extra select").forEach((sel) => sel.addEventListener("change", apply)); } function advancedCount() { return [$("#size-min").value, $("#size-max").value].filter((v) => v !== "").length + ["#flat", "#watertight", "#one-per-group", "#latents"].filter((s) => $(s).checked).length + $$("#facet-extra select").filter((sel) => sel.value).length; } function bindFilters() { ["#q", "#size-min", "#size-max"].forEach((s) => $(s).addEventListener("input", apply)); ["#flat", "#watertight", "#one-per-group", "#latents", "#sort"].forEach((s) => $(s).addEventListener("change", apply)); $("#reset").addEventListener("click", () => { $("#q").value = $("#size-min").value = $("#size-max").value = ""; ["#flat", "#watertight", "#one-per-group", "#latents"].forEach((s) => ($(s).checked = false)); $$("#facet-extra select").forEach((sel) => (sel.value = "")); S.cats.clear(); syncCats(); apply(); }); $("#filters-btn").addEventListener("click", () => { const open = $("#more-filters").hidden; $("#more-filters").hidden = !open; $("#filters-btn").setAttribute("aria-expanded", open); }); $("#add-all").addEventListener("click", () => { S.filtered.forEach((r) => S.basket.add(r.object_id)); changed(); }); $("#remove-all").addEventListener("click", () => { S.filtered.forEach((r) => S.basket.delete(r.object_id)); changed(); }); } function apply() { const q = $("#q").value.trim().toLowerCase().split(/\s+/).filter(Boolean); const lo = parseFloat($("#size-min").value), hi = parseFloat($("#size-max").value); const flat = $("#flat").checked, wt = $("#watertight").checked, lat = $("#latents").checked; const facets = $$("#facet-extra select").filter((sel) => sel.value).map((sel) => [sel.dataset.facet, sel.value]); const fields = S.cfg.search_fields; let out = S.rows.filter((r) => { if (S.cats.size && !S.cats.has(r.category || "Other")) return false; if (facets.some(([k, v]) => r[k] !== v)) return false; if (!isNaN(lo) && r.max_dim_cm < lo) return false; if (!isNaN(hi) && r.max_dim_cm > hi) return false; if (flat && !(r.flatness < 0.25)) return false; if (wt && !r.is_watertight) return false; if (lat && !r.latents_repo) return false; if (q.length) { const hay = fields.map((f) => r[f] ?? "").join(" ").toLowerCase(); if (!q.every((t) => hay.includes(t))) return false; } return true; }); if ($("#one-per-group").checked) { const seen = new Set(); out = out.filter((r) => (seen.has(r.group) ? false : seen.add(r.group))); } const key = $("#sort").value; const cmp = { name: (a, b) => a.name.localeCompare(b.name), size: (a, b) => a.max_dim_cm - b.max_dim_cm, faces: (a, b) => (b.faces ?? 0) - (a.faces ?? 0), category: (a, b) => (a.category || "~").localeCompare(b.category || "~") || a.name.localeCompare(b.name), }[key]; S.filtered = out.sort(cmp); const n = advancedCount(); $("#filters-count").hidden = !n; $("#filters-count").textContent = n; renderGrid(); } function renderToolbar() { const n = S.filtered.length, all = S.filtered.length === S.rows.length; const inB = S.filtered.filter((r) => S.basket.has(r.object_id)).length; $("#count").textContent = all ? `${plural(n, "object")}` : `${plural(n, "object")} match`; $("#add-all").textContent = all ? `Add all ${n.toLocaleString()}` : `Add these ${n.toLocaleString()}`; $("#add-all").disabled = !n || inB === n; $("#remove-all").hidden = !inB; $("#remove-all").textContent = inB === n ? "Remove these" : `Remove ${inB} picked`; } // ----------------------------------------------------------------- grid function renderGrid() { renderToolbar(); $("#grid").innerHTML = S.filtered.length ? S.filtered.map((r, i) => { const sibs = S.groups.get(r.group).length; const inB = S.basket.has(r.object_id); return `
${sibs > 1 ? `${sibs} ${variantWord()}` : ""}${r.latents_repo && !S.allLatents ? `ready to train` : ""}
${esc(pretty(r.name))}${esc(r.category || "Other")}${S.cfg.real_size && r.max_dim_cm ? ` · ${Math.round(r.max_dim_cm)} cm` : ""}
`; }).join("") : `
No objects match.Try another word, or .
`; $("#empty-reset")?.addEventListener("click", () => $("#reset").click()); } $("#grid").addEventListener("click", (e) => { const tile = e.target.closest(".tile"); if (!tile) return; const id = tile.dataset.id, i = +tile.dataset.i; if (e.target.closest(".add")) { if (e.shiftKey && S.lastClicked !== null) { const [a, b] = [Math.min(S.lastClicked, i), Math.max(S.lastClicked, i)]; S.filtered.slice(a, b + 1).forEach((r) => S.basket.add(r.object_id)); } else { S.basket.has(id) ? S.basket.delete(id) : S.basket.add(id); } S.lastClicked = i; changed(); } else if (e.target.closest(".open")) { openDetail(id); } }); function changed() { store.set(`basket:${S.cid}`, [...S.basket]); if (location.hash) history.replaceState(null, "", location.pathname); $$("#grid .tile").forEach((t) => { const inB = S.basket.has(t.dataset.id); t.classList.toggle("in", inB); const b = t.querySelector(".add"); b.textContent = inB ? "✓" : "+"; b.setAttribute("aria-pressed", inB); }); renderToolbar(); renderBasket(); if ($("#detail").open) openDetail($("#detail").dataset.id); } // ----------------------------------------------------------------- detail function openDetail(id) { const r = S.byId.get(id), d = $("#detail"); d.dataset.id = id; const glb = asset(S.cfg.paths.preview_glb, id); if ($("#mv").getAttribute("src") !== glb) { const thumbs = (S.cfg.paths.files.thumbnails || []).map((t) => asset(t, id)); $("#mv").setAttribute("src", glb); $("#mv").setAttribute("poster", thumbs[0] || tileUrl(id)); $("#thumbs").innerHTML = thumbs.length > 1 ? thumbs.map((u, k) => `render ${k + 1}`).join("") : ""; } $("#d-name").textContent = pretty(r.name); $("#d-desc").textContent = r.description; const facetRows = Object.entries(S.cfg.facets).filter(([k]) => r[k]).map(([k, label]) => [label, r[k]]); const props = [ ...facetRows, ...(r.brand ? [["Brand", r.brand]] : []), ...(S.cfg.real_size && r.size_x_cm ? [["Real size", `${r.size_x_cm} × ${r.size_y_cm} × ${r.size_z_cm} cm`]] : []), ...(r.faces ? [["Detail", `${r.faces.toLocaleString()} triangles${r.is_watertight ? ", closed mesh" : ""}`]] : []), ["Download size", `${gb(r.glb_bytes)} as GLB` + (S.cfg.formats.original ? `, ${gb(r.all_bytes - r.glb_bytes)} as original scan` : "")], ["License", r.license || S.cfg.license], ...(S.allLatents ? [] : [["TRELLIS.2", r.latents_repo ? "ready to train" : "needs preprocessing"]]), ["Object id", r.object_id], ]; $("#d-props").innerHTML = props.map(([k, v]) => `
${esc(k)}
${esc(v)}
`).join("") + (r.source_url ? `
Source
original record ↗
` : ""); const inB = S.basket.has(id); $("#d-toggle").textContent = inB ? "✓ In your dataset (remove)" : "+ Add to my dataset"; $("#d-toggle").className = inB ? "" : "primary"; $("#d-toggle").onclick = () => { inB ? S.basket.delete(id) : S.basket.add(id); changed(); }; const sibs = S.groups.get(r.group); $("#d-group").hidden = sibs.length < 2; const allIn = sibs.every((s) => S.basket.has(s)); $("#d-group").textContent = allIn ? `Remove all ${sibs.length} ${variantWord()}` : `Add all ${sibs.length} ${variantWord()}`; $("#d-group").onclick = () => { sibs.forEach((s) => (allIn ? S.basket.delete(s) : S.basket.add(s))); changed(); }; $("#d-siblings").innerHTML = sibs.length < 2 ? "" : `

${S.cid === "gso" ? "Same shape, other colors" : "Other versions of this object"}

${sibs.map((s) => ``).join("")}
`; $$("#d-siblings .sib").forEach((b) => b.addEventListener("click", () => openDetail(b.dataset.id))); $("#d-cmd").textContent = `hf download ${S.cfg.objects_repo} --repo-type dataset --include "objects/${id}/*" --local-dir ${S.cid}`; if (!d.open) d.showModal(); } $("#detail").addEventListener("click", (e) => { if (e.target === $("#detail")) $("#detail").close(); }); // ----------------------------------------------------------------- basket function formats() { return $$("input[name=fmt]:checked").map((c) => c.value); } function sizes(rows) { const sum = (f) => rows.reduce((a, r) => a + (f(r) || 0), 0); return { original: sum((r) => r.all_bytes - r.glb_bytes), glb: sum((r) => r.glb_bytes), preview: sum((r) => r.preview_glb_bytes), metadata: rows.length * 3000, thumbnails: rows.length * 70000 * (S.cfg.paths.files.thumbnails || []).length, }; } // step 2's file cards come from the collection's manifest function renderFormats() { const defaults = new Set(S.cfg.default_formats); $("#formats").innerHTML = Object.entries(S.cfg.formats).map(([f, [label, desc]]) => ``).join(""); } // does an export with these formats carry the files trellis2-prep reads? function hasPrepFiles(fmts) { const want = S.cfg.prep_include.map((g) => g.split("/").pop()); return fmts.some((f) => (S.cfg.paths.files[f] || []).some((p) => want.includes(p.split("/").pop()))); } function renderBasket() { const rows = [...S.basket].map((id) => S.byId.get(id)).sort((a, b) => a.name.localeCompare(b.name)); const groups = new Set(rows.map((r) => r.group)); const withLat = rows.filter((r) => r.latents_repo).length; const sz = sizes(rows); const total = formats().reduce((a, f) => a + sz[f], 0); $("#stats").innerHTML = `
${rows.length.toLocaleString()}${rows.length === 1 ? "object" : "objects"}
${groups.size.toLocaleString()}distinct objects
${rows.length ? gb(total) : "—"}to download
`; // only matters to people training on it, so it sits in a collapsed "tips" section const warn = []; if (rows.length && groups.size < rows.length * 0.6) warn.push(`Only ${groups.size} distinct objects among ${rows.length}: many are ${variantWord()} of the same object, which teach a shape model little.`); if (rows.length && groups.size < 40) warn.push(`Fairly small for training (the reference footwear run used about 180 objects). Expect overfitting; keep the step count low.`); const cats = {}; rows.forEach((r) => { const c = r.category || "Other"; cats[c] = (cats[c] || 0) + 1; }); if (Object.keys(cats).length > 3 && rows.length) warn.push(`Mixes ${Object.keys(cats).length} categories. A LoRA learns one coherent kind of object (and its usual pose) best.`); if (rows.length && withLat < rows.length) warn.push(`${plural(rows.length - withLat, "object")} still need TRELLIS.2 preprocessing; the dataset's README has the trellis2-prep command.`); if (rows.length && S.cfg.training_note) warn.push(esc(S.cfg.training_note)); $("#warnings").innerHTML = warn.map((w) => `

${w}

`).join(""); $("#tips-wrap").hidden = !warn.length; $("#tips-count").textContent = warn.length; const top = Object.entries(cats).sort((a, b) => b[1] - a[1]); $("#cat-bars").innerHTML = top.slice(0, 6).map(([c, n]) => `
${esc(c)}
${n}
`).join("") + (top.length > 6 ? `

+ ${top.length - 6} more categories

` : ""); $("#list-count").textContent = `(${rows.length})`; $("#basket-list").innerHTML = rows.map((r) => `
  • ${esc(pretty(r.name))}
  • `).join(""); $$(".size").forEach((s) => (s.textContent = rows.length ? gb(sz[s.dataset.fmt]) : "")); const tooBig = total > S.cfg.zip_max_bytes; $("#dl-zip").disabled = !rows.length || !formats().length || tooBig; $("#dl-script").disabled = !rows.length || !formats().length; renderExportButton(rows.length, total); $("#zip-note").textContent = !rows.length ? "Add objects to export them." : !formats().length ? "Pick at least one kind of file in step 2." : tooBig ? `About ${gb(total)}: too big for a zip (limit ${gb(S.cfg.zip_max_bytes)}). Use the Python script or save to Hugging Face.` : `About ${gb(total)}.`; $("#repo-name").textContent = $("#name").value; renderSelbar(rows, groups.size); } // ---- Hub export guards: one dataset per selection, and only into a name that doesn't exist yet const fnv = (str) => { let h = 0x811c9dc5; for (let i = 0; i < str.length; i++) { h ^= str.charCodeAt(i); h = Math.imul(h, 0x01000193); } return (h >>> 0).toString(16); }; const selectionSig = () => `${S.cid}:${S.basket.size}:${fnv([...S.basket].sort().join("\n"))}`; const exportedFor = () => { const e = store.get(`exported:${S.cid}`, null); return e && e.sig === selectionSig() ? e : null; }; const repoId = () => `${$("#owner").value}/${$("#name").value}`; S.name = { repo: null, available: null, reason: "" }; S.exporting = false; function renderExportButton(n = S.basket.size, total = 0) { const done = exportedFor(); $("#exported-note").hidden = !done; if (done) $("#exported-note").innerHTML = `This selection is already saved as ${esc(done.repo_id)}. Change which objects are in it to create another dataset.`; const nameOk = S.name.repo === repoId() && S.name.available === true; $("#export").disabled = S.exporting || !S.user || !n || !formats().length || total > S.cfg.export_max_bytes || !!done || !nameOk; } let nameTimer = null; function checkName() { if (!S.user) return; const repo = repoId(); if (!$("#name").value) { setNameStatus(repo, false, "Pick a name"); return; } setNameStatus(repo, null, "Checking the name…"); clearTimeout(nameTimer); nameTimer = setTimeout(async () => { try { const r = await fetch(`/api/repo-available?repo_id=${encodeURIComponent(repo)}`); const b = await r.json(); if (repo !== repoId()) return; // the name changed while we were asking setNameStatus(repo, r.ok && b.available, r.ok ? (b.available ? `✓ ${repo} is available` : `✗ ${b.reason}. Choose another name.`) : (b.detail || "Couldn't check this name")); } catch { setNameStatus(repo, null, "Couldn't check this name"); } }, 350); } function setNameStatus(repo, available, text) { S.name = { repo, available, reason: text }; const el = $("#name-status"); el.textContent = text; el.className = "name-status" + (available === true ? " ok" : available === false ? " bad" : ""); renderExportButton(S.basket.size, formats().reduce((a, f) => a + sizes([...S.basket].map((id) => S.byId.get(id)))[f], 0)); } function renderSelbar(rows, shapes) { const n = rows.length; $("#sel-count").textContent = n ? `${plural(n, "object")} in your dataset` : "Nothing picked yet"; $("#sel-sub").innerHTML = n ? `${plural(shapes, "distinct object")} · ${esc(S.cfg.title)}` : "Click + on any object to add it to your dataset."; $("#sel-thumbs").innerHTML = rows.slice(-5).reverse().map((r) => ``).join(""); $("#review-btn").disabled = !n; $("#clear").hidden = !n; $("#selbar").classList.toggle("has", n > 0); } function bindBasket() { $("#basket-list").addEventListener("click", (e) => { const b = e.target.closest(".x"); if (b) { S.basket.delete(b.dataset.id); changed(); } }); $("#clear").addEventListener("click", () => { if (confirm("Remove every object from your dataset?")) { S.basket.clear(); changed(); } }); $("#review-btn").addEventListener("click", () => { $("#drawer").showModal(); checkName(); }); $("#drawer-close").addEventListener("click", () => $("#drawer").close()); $("#drawer").addEventListener("click", (e) => { if (e.target === $("#drawer")) $("#drawer").close(); }); $("#formats").addEventListener("change", renderBasket); $("#name").addEventListener("input", () => { $("#name").value = $("#name").value.replace(/[^A-Za-z0-9._-]/g, "-"); $("#name").dataset.edited = "1"; renderBasket(); checkName(); }); $("#owner").addEventListener("change", checkName); $("#dl-zip").addEventListener("click", () => { const f = $("#zip-form"); f.payload.value = JSON.stringify({ collection: S.cid, ids: [...S.basket], formats: formats(), name: $("#name").value, share_url: shareUrl() }); f.submit(); toast("Your zip is being built and will download shortly"); }); $("#dl-script").addEventListener("click", () => { const ids = [...S.basket].sort(); const py = scriptFor(ids, formats()); const a = Object.assign(document.createElement("a"), { href: URL.createObjectURL(new Blob([py], { type: "text/x-python" })), download: "download_subset.py", }); a.click(); URL.revokeObjectURL(a.href); }); $("#share").addEventListener("click", async () => { const url = shareUrl(); try { await navigator.clipboard.writeText(url); toast("Link copied"); } catch { prompt("Copy this link", url); } }); $("#import-btn").addEventListener("click", () => ($("#import-box").hidden = !$("#import-box").hidden)); $("#import-go").addEventListener("click", () => { const shaToId = new Map(S.rows.map((r) => [r.prep_sha256, r.object_id])); const tokens = $("#import-text").value.split(/\s+/).filter((t) => t && !t.startsWith("#")); let n = 0; tokens.forEach((t) => { const id = S.byId.has(t) ? t : shaToId.get(t); if (id && !S.basket.has(id)) { S.basket.add(id); n++; } }); toast(`Added ${n} objects`); $("#import-text").value = ""; changed(); }); $("#export").addEventListener("click", startExport); } function scriptFor(ids, fmts) { const paths = Object.fromEntries(fmts.map((f) => [f, S.cfg.paths.files[f]])); return `"""Download ${ids.length} objects from ${S.cfg.title} (${S.cfg.objects_repo}). pip install huggingface_hub && python download_subset.py [out_dir] Selection: ${shareUrl()} ${S.cfg.credit} """ import sys from huggingface_hub import snapshot_download IDS = ${JSON.stringify(ids, null, 1)} FORMATS = ${JSON.stringify(paths, null, 1)} patterns = [p.format(id=i) for i in IDS for paths in FORMATS.values() for p in paths] out = snapshot_download("${S.cfg.objects_repo}", repo_type="dataset", allow_patterns=patterns, local_dir=sys.argv[1] if len(sys.argv) > 1 else "${S.cid}_subset") print("downloaded to", out) `; } async function startExport() { const repo_id = repoId(), ids = [...S.basket], fmts = formats(), sig = selectionSig(); S.exporting = true; renderExportButton(); $("#export-status").hidden = false; $("#export-msg").textContent = "starting"; $("#export-bar").style.width = "0%"; const finish = () => { S.exporting = false; renderBasket(); }; const res = await fetch("/api/export", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ collection: S.cid, ids, formats: fmts, repo_id, private: $("#private").checked, share_url: shareUrl() }), }); const body = await res.json(); if (!res.ok) { $("#export-msg").textContent = body.detail || "export failed"; if (res.status === 409) setNameStatus(repo_id, false, `✗ ${body.detail}`); finish(); return; } const poll = async () => { const st = await fetch(`/api/export/${body.job}`).then((r) => r.json()); $("#export-bar").style.width = `${Math.round(st.progress * 100)}%`; if (st.status === "done") { store.set(`exported:${S.cid}`, { sig, repo_id, url: st.url }); $("#export-msg").innerHTML = `Done: ${esc(repo_id)}. Its card has the download and TRELLIS.2 training commands.`; setNameStatus(repo_id, false, `✗ ${repo_id} now holds this dataset`); showTrainLink({ repo_id, ids, formats: fmts }); finish(); } else if (st.status === "error") { $("#export-msg").textContent = st.message; finish(); checkName(); // a failed export may have created the repo: re-check before allowing a retry } else { $("#export-msg").textContent = st.message; setTimeout(poll, 1500); } }; poll(); } // ----------------------------------------------------------------- training // Training happens in the trainer Space (it asks for the "jobs" permission; this Space never does). // The link prefills it: straight from existing latents when subset training is on, otherwise the // exported OBJs for preprocessing. Never latents without a subset, which would train on everything. function showTrainLink(exported) { const rows = exported.ids.map((id) => S.byId.get(id)); const latents = rows.every((r) => r.latents_repo) && new Set(rows.map((r) => r.latents_repo)).size === 1 ? rows[0].latents_repo : null; const name = exported.repo_id.split("/")[1]; const q = new URLSearchParams({ name }); let note; if (latents && S.cfg.subset_enabled) { q.set("latents", latents); q.set("subset", exported.repo_id); note = "Every object is already preprocessed, so training starts right away."; } else if (hasPrepFiles(exported.formats)) { q.set("meshes", exported.repo_id); q.set("include", S.cfg.prep_include.join(" ")); note = "The trainer will preprocess your objects first, then train."; } else { const need = Object.entries(S.cfg.formats).filter(([f]) => hasPrepFiles([f])).map(([, [label]]) => `${esc(label)}`); note = `Tip: include ${need.join(" or ")} in step 2 so the trainer can preprocess your objects; this export has none.`; } $("#train-go").href = `${S.cfg.trainer_url}?${q}`; $("#train-note").innerHTML = note; $("#train-link").hidden = false; } // ----------------------------------------------------------------- libraries function bindLibraries() { $("#lib-btn").addEventListener("click", () => { $("#libs-list").innerHTML = S.collections.map((c) => { const picked = store.get(`basket:${c.id}`, c.id === "gso" ? store.get("basket", []) : []).length; return ``; }).join(""); $("#libs").showModal(); }); $("#libs-list").addEventListener("click", async (e) => { const b = e.target.closest(".lib"); if (!b) return; $("#libs").close(); if (b.dataset.id !== S.cid) { if (location.hash) history.replaceState(null, "", location.pathname); await loadCollection(b.dataset.id); window.scrollTo({ top: 0 }); } }); $("#libs").addEventListener("click", (e) => { if (e.target === $("#libs")) $("#libs").close(); }); } // ----------------------------------------------------------------- first-timer tour // A welcome card, then coach marks that spotlight each part of the page. Shown once // (remembered in localStorage); "How it works" replays it. const TOUR = [ { title: "Welcome! Build your own 3D dataset", body: `

    Browse free 3D libraries, like {title} ({tagline}). Pick the objects you want and take them with you, for a game, a render, 3D printing, or training an AI model.

    1. Pick objects you like
    2. Review your picks
    3. Download them, or save them to Hugging Face

    Takes 30 seconds. You can replay it any time from "How it works".

    `, next: "Show me around" }, { target: "#lib-btn", title: "Choose a library", body: "

    Switch between 3D libraries here. Each one keeps its own selection, so you can come back to it.

    " }, { target: "#find", title: "Find objects", body: "

    Type what you're after, or tap a category. Filters has more options, like shape and size.

    " }, { target: "#grid .tile", title: "Look, then pick", body: "

    Click a picture to spin the object in 3D. Click + to add it to your dataset.

    Tip: shift-click + to add a whole row at once.

    " }, { target: "#add-all", title: "Or grab them all", body: "

    Adds every object matching your search in one click: pick a category, then add them all.

    " }, { target: "#selbar", title: "Your dataset lives here", body: "

    Everything you pick collects in this bar, and it's remembered if you come back later.

    " }, { target: "#review-btn", title: "Get your files", body: "

    When you're ready, open this to check your picks, choose file types and download a zip. Signed in, you can also save it as a dataset on your Hugging Face account, and even train a TRELLIS.2 model on it.

    ", next: "Start exploring" }, ]; let tourAt = -1; function bindTour() { $("#help-btn").addEventListener("click", () => startTour(0)); $("#tour-next").addEventListener("click", () => (tourAt + 1 < TOUR.length ? showTourStep(tourAt + 1) : endTour())); $("#tour-back").addEventListener("click", () => showTourStep(tourAt - 1)); $("#tour-skip").addEventListener("click", endTour); document.addEventListener("keydown", (e) => { if (tourAt < 0) return; if (e.key === "Escape") endTour(); if (e.key === "ArrowRight") $("#tour-next").click(); if (e.key === "ArrowLeft" && tourAt > 0) $("#tour-back").click(); }); window.addEventListener("resize", () => tourAt >= 0 && placeTour()); window.addEventListener("scroll", () => tourAt >= 0 && placeTour(), { passive: true }); } function startTour(i) { ["#drawer", "#detail", "#libs"].forEach((d) => $(d).open && $(d).close()); $("#tour").hidden = false; document.body.classList.add("touring"); showTourStep(i); } function showTourStep(i) { tourAt = i; const s = TOUR[i]; $("#tour-step").textContent = i ? `Step ${i} of ${TOUR.length - 1}` : ""; $("#tour-title").textContent = s.title; $("#tour-body").innerHTML = s.body.replace("{title}", esc(S.cfg.title)).replace("{tagline}", esc(S.cfg.tagline)); $("#tour-back").hidden = i === 0; $("#tour-skip").textContent = i === 0 ? "No thanks" : "Skip tour"; $("#tour-next").textContent = s.next || "Next"; const el = s.target && document.querySelector(s.target); if (el) el.scrollIntoView({ block: "center", behavior: "instant" }); placeTour(); $("#tour-next").focus(); } function placeTour() { const s = TOUR[tourAt], card = $("#tour-card"), spot = $("#tour-spot"); const el = s.target && document.querySelector(s.target); card.classList.toggle("center", !el); spot.hidden = !el; if (!el) { card.style.left = card.style.top = ""; return; } const r = el.getBoundingClientRect(), pad = 6; Object.assign(spot.style, { left: `${r.left - pad}px`, top: `${r.top - pad}px`, width: `${r.width + 2 * pad}px`, height: `${r.height + 2 * pad}px` }); const cw = card.offsetWidth, ch = card.offsetHeight, vw = innerWidth, vh = innerHeight, gap = 14; const below = r.bottom + gap + ch < vh; const top = below ? r.bottom + gap : Math.max(gap, r.top - gap - ch); const left = Math.min(Math.max(gap, r.left + r.width / 2 - cw / 2), vw - cw - gap); Object.assign(card.style, { left: `${left}px`, top: `${top}px` }); } function endTour() { tourAt = -1; $("#tour").hidden = true; document.body.classList.remove("touring"); store.set("tour_done", true); } function toast(msg) { const t = $("#toast"); t.textContent = msg; t.hidden = false; clearTimeout(toast.h); toast.h = setTimeout(() => (t.hidden = true), 3000); } boot().catch((e) => { $("#grid").innerHTML = `

    Could not load the catalog: ${esc(e.message)}

    `; });