@namche/imagery

Typed index of the NAMCHE curated imagery — Jodok's own photos, CLIP-curated in NamcheAI/imagery and published as immutable versioned releases on cdn.namche.ai. This package ships no binaries: only slugs, metadata and absolute CDN URLs, so products depend on a tiny public npm package while the images stay on the CDN.

The package version mirrors the imagery release it indexes (@namche/[email protected] ↔ images/curated/v1.2.0), and every URL it produces is immutable (one-year cache). Browse the set at the release's gallery.

import { byTheme, url, images, GALLERY_URL } from "@namche/imagery";

byTheme("texture_porous");            // all porous-texture entries
url("848c4dfc-img-4459", "tile");     // absolute immutable URL, typed slugs
url("848c4dfc-img-4459", "normal");   // texture themes also carry normal/rough maps
images[0].colors;                     // dominant colors, most frequent first

Derivative kinds: web (≤1600px WebP), thumb (≤480px WebP), and for the texture themes tile (seamless 1024px WebP), normal, rough (PNG maps for the metaball renderer).

Updating to a new imagery release

pnpm sync:imagery v1.3.0   # vendors images.json, aligns the package version
pnpm build                 # regenerates index.js + index.d.ts

Commit all three; CI fails on drift between images.json and the generated module.