@jgengine/assets 0.4.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./manifest.js";
+export { sources, sourceById, kenneySources, quaterniusSources, kaykitSources } from "./sources/index.js";
+export { singles } from "./singles.js";
+export { aliases } from "./aliases.js";
+export { generatedIndex, generatedBySource } from "./generated/index.js";
+export { buildCatalog, entryUrl, type BuildCatalogOptions } from "./catalogs/build.js";
+export { createStarterCatalog } from "./catalogs/starter.js";
+export { verifyManifest, type VerifyResult } from "./verify.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./manifest.js";
+export { sources, sourceById, kenneySources, quaterniusSources, kaykitSources } from "./sources/index.js";
+export { singles } from "./singles.js";
+export { aliases } from "./aliases.js";
+export { generatedIndex, generatedBySource } from "./generated/index.js";
+export { buildCatalog, entryUrl } from "./catalogs/build.js";
+export { createStarterCatalog } from "./catalogs/starter.js";
+export { verifyManifest } from "./verify.js";

package/dist/indexGen.d.ts

@@ -0,0 +1,12 @@
+import type { AssetSource, IndexEntry } from "./manifest.js";
+export declare function keyFromFile(file: string): string;
+export declare function entryForFile(source: AssetSource, file: string): IndexEntry;
+export declare function indexSourceDir(source: AssetSource, dir: string): IndexEntry[];
+export interface ReindexResult {
+    perSource: {
+        source: string;
+        count: number;
+    }[];
+    total: number;
+}
+export declare function reindex(modelsDir: string, outDir: string): ReindexResult;

package/dist/indexGen.js

@@ -0,0 +1,81 @@
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { sourceById } from "./sources/index.js";
+export function keyFromFile(file) {
+    return file.replace(/\.glb$/i, "");
+}
+export function entryForFile(source, file) {
+    return {
+        id: `${source.id}/${keyFromFile(file)}`,
+        source: source.id,
+        categories: source.categories,
+        file,
+    };
+}
+function collectGlbFiles(dir) {
+    const found = [];
+    for (const name of readdirSync(dir)) {
+        const full = join(dir, name);
+        if (statSync(full).isDirectory()) {
+            found.push(...collectGlbFiles(full));
+        }
+        else if (/\.glb$/i.test(name)) {
+            found.push(name);
+        }
+    }
+    return found;
+}
+export function indexSourceDir(source, dir) {
+    const seen = new Set();
+    const entries = [];
+    for (const file of collectGlbFiles(dir).sort((a, b) => a.localeCompare(b))) {
+        if (seen.has(file))
+            continue;
+        seen.add(file);
+        entries.push(entryForFile(source, file));
+    }
+    return entries;
+}
+function safeIdentifier(sourceId) {
+    return `s_${sourceId.replace(/[^a-zA-Z0-9]/g, "_")}`;
+}
+function renderBarrel(sourceIds) {
+    const ordered = [...sourceIds].sort((a, b) => a.localeCompare(b));
+    const imports = ordered
+        .map((id) => `import ${safeIdentifier(id)} from "./${id}.json" with { type: "json" };`)
+        .join("\n");
+    const table = ordered
+        .map((id) => `  ${JSON.stringify(id)}: ${safeIdentifier(id)} as IndexEntry[],`)
+        .join("\n");
+    return `// AUTO-GENERATED by \`assets reindex\`. Do not edit by hand.
+import type { IndexEntry } from "../manifest";
+${imports}
+
+export const generatedBySource: Record<string, IndexEntry[]> = {
+${table}
+};
+
+export const generatedIndex: IndexEntry[] = Object.values(generatedBySource).flat();
+`;
+}
+export function reindex(modelsDir, outDir) {
+    mkdirSync(outDir, { recursive: true });
+    const perSource = [];
+    const sourceIds = [];
+    const subdirs = existsSync(modelsDir)
+        ? readdirSync(modelsDir).filter((name) => statSync(join(modelsDir, name)).isDirectory())
+        : [];
+    for (const sourceId of subdirs.sort((a, b) => a.localeCompare(b))) {
+        const source = sourceById.get(sourceId);
+        if (source === undefined) {
+            perSource.push({ source: `${sourceId} (unknown, skipped)`, count: 0 });
+            continue;
+        }
+        const entries = indexSourceDir(source, join(modelsDir, sourceId));
+        writeFileSync(join(outDir, `${sourceId}.json`), `${JSON.stringify(entries, null, 2)}\n`);
+        sourceIds.push(sourceId);
+        perSource.push({ source: sourceId, count: entries.length });
+    }
+    writeFileSync(join(outDir, "index.ts"), renderBarrel(sourceIds));
+    return { perSource, total: perSource.reduce((sum, entry) => sum + entry.count, 0) };
+}

package/dist/manifest.d.ts

@@ -0,0 +1,37 @@
+export type AssetProvider = "kenney" | "quaternius" | "kaykit" | "polypizza" | "itch" | "custom";
+export interface PinnedDownload {
+    url: string;
+    sha256?: string;
+}
+export interface ScrapeDownload {
+    scrape: string;
+}
+export type AssetDownload = PinnedDownload | ScrapeDownload;
+export declare function isScrapeDownload(download: AssetDownload): download is ScrapeDownload;
+export interface AssetSource {
+    id: string;
+    provider: AssetProvider;
+    title: string;
+    license: string;
+    author: string;
+    categories: readonly string[];
+    download: AssetDownload;
+    homepage?: string;
+}
+export interface IndexEntry {
+    id: string;
+    source: string;
+    categories: readonly string[];
+    file: string;
+}
+export interface AssetAlias {
+    key: string;
+    target: string;
+}
+export interface SingleAsset {
+    id: string;
+    url: string;
+    license: string;
+    author: string;
+    categories: readonly string[];
+}

package/dist/manifest.js

@@ -0,0 +1,3 @@
+export function isScrapeDownload(download) {
+    return "scrape" in download;
+}

package/dist/singles.d.ts

@@ -0,0 +1,2 @@
+import type { SingleAsset } from "./manifest.js";
+export declare const singles: readonly SingleAsset[];

package/dist/singles.js

@@ -0,0 +1,2 @@
+import data from "./singles.json" with { type: "json" };
+export const singles = data;

package/dist/singles.json

@@ -0,0 +1 @@
+[]

package/dist/sources/index.d.ts

@@ -0,0 +1,7 @@
+import type { AssetSource } from "../manifest.js";
+import { kaykitSources } from "./kaykit.js";
+import { kenneySources } from "./kenney.js";
+import { quaterniusSources } from "./quaternius.js";
+export declare const sources: readonly AssetSource[];
+export declare const sourceById: ReadonlyMap<string, AssetSource>;
+export { kaykitSources, kenneySources, quaterniusSources };

package/dist/sources/index.js

@@ -0,0 +1,10 @@
+import { kaykitSources } from "./kaykit.js";
+import { kenneySources } from "./kenney.js";
+import { quaterniusSources } from "./quaternius.js";
+export const sources = [
+    ...kenneySources,
+    ...quaterniusSources,
+    ...kaykitSources,
+];
+export const sourceById = new Map(sources.map((source) => [source.id, source]));
+export { kaykitSources, kenneySources, quaterniusSources };

package/dist/sources/kaykit.d.ts

@@ -0,0 +1,2 @@
+import type { AssetSource } from "../manifest.js";
+export declare const kaykitSources: readonly AssetSource[];

package/dist/sources/kaykit.js

@@ -0,0 +1,16 @@
+const KAYKIT_PACKS = [
+    { id: "kaykit-adventurers", slug: "kaykit-adventurers", title: "KayKit Adventurers", categories: ["character", "rigged", "fantasy"] },
+    { id: "kaykit-skeletons", slug: "kaykit-skeletons", title: "KayKit Skeletons", categories: ["character", "rigged", "halloween"] },
+    { id: "kaykit-dungeon", slug: "kaykit-dungeon-remastered", title: "KayKit Dungeon (Remastered)", categories: ["dungeon", "environment", "prop"] },
+    { id: "kaykit-medieval-hexagon", slug: "kaykit-medieval-hexagon-pack", title: "KayKit Medieval Hexagon Pack", categories: ["hexagon", "medieval", "environment"] },
+];
+export const kaykitSources = KAYKIT_PACKS.map((pack) => ({
+    id: pack.id,
+    provider: "kaykit",
+    title: pack.title,
+    license: "CC0-1.0",
+    author: "Kay Lousberg",
+    categories: pack.categories,
+    download: { scrape: `https://kaylousberg.itch.io/${pack.slug}` },
+    homepage: `https://kaylousberg.itch.io/${pack.slug}`,
+}));

package/dist/sources/kenney.d.ts

@@ -0,0 +1,2 @@
+import type { AssetSource } from "../manifest.js";
+export declare const kenneySources: readonly AssetSource[];

package/dist/sources/kenney.js

@@ -0,0 +1,32 @@
+const KENNEY_PACKS = [
+    { id: "kenney-nature", slug: "nature-kit", title: "Nature Kit", categories: ["nature", "environment", "prop"] },
+    { id: "kenney-castle", slug: "castle-kit", title: "Castle Kit", categories: ["building", "medieval", "environment"] },
+    { id: "kenney-city-commercial", slug: "city-kit-commercial", title: "City Kit (Commercial)", categories: ["building", "city", "environment"] },
+    { id: "kenney-city-suburban", slug: "city-kit-suburban", title: "City Kit (Suburban)", categories: ["building", "city", "environment"] },
+    { id: "kenney-city-roads", slug: "city-kit-roads", title: "City Kit (Roads)", categories: ["road", "city", "environment"] },
+    { id: "kenney-fantasy-town", slug: "fantasy-town-kit", title: "Fantasy Town Kit", categories: ["building", "fantasy", "environment"] },
+    { id: "kenney-graveyard", slug: "graveyard-kit", title: "Graveyard Kit", categories: ["environment", "halloween", "prop"] },
+    { id: "kenney-holiday", slug: "holiday-kit", title: "Holiday Kit", categories: ["prop", "holiday", "environment"] },
+    { id: "kenney-mini-arena", slug: "mini-arena", title: "Mini Arena", categories: ["character", "arena", "prop"] },
+    { id: "kenney-mini-dungeon", slug: "mini-dungeon", title: "Mini Dungeon", categories: ["dungeon", "environment", "prop"] },
+    { id: "kenney-mini-skate", slug: "mini-skate", title: "Mini Skate", categories: ["character", "vehicle", "prop"] },
+    { id: "kenney-pirate", slug: "pirate-kit", title: "Pirate Kit", categories: ["ship", "pirate", "environment"] },
+    { id: "kenney-platformer", slug: "platformer-kit", title: "Platformer Kit", categories: ["platform", "environment", "prop"] },
+    { id: "kenney-prototype", slug: "prototype-kit", title: "Prototype Kit", categories: ["prototype", "environment"] },
+    { id: "kenney-racing", slug: "racing-kit", title: "Racing Kit", categories: ["vehicle", "racing", "environment"] },
+    { id: "kenney-space", slug: "space-kit", title: "Space Kit", categories: ["space", "vehicle", "prop"] },
+    { id: "kenney-survival", slug: "survival-kit", title: "Survival Kit", categories: ["survival", "prop", "environment"] },
+    { id: "kenney-tower-defense", slug: "tower-defense-kit", title: "Tower Defense Kit", categories: ["tower", "environment", "prop"] },
+    { id: "kenney-food", slug: "food-kit", title: "Food Kit", categories: ["food", "prop"] },
+    { id: "kenney-blaster", slug: "blaster-kit", title: "Blaster Kit", categories: ["weapon", "prop"] },
+];
+export const kenneySources = KENNEY_PACKS.map((pack) => ({
+    id: pack.id,
+    provider: "kenney",
+    title: pack.title,
+    license: "CC0-1.0",
+    author: "Kenney",
+    categories: pack.categories,
+    download: { scrape: `https://kenney.nl/assets/${pack.slug}` },
+    homepage: `https://kenney.nl/assets/${pack.slug}`,
+}));

package/dist/sources/quaternius.d.ts

@@ -0,0 +1,2 @@
+import type { AssetSource } from "../manifest.js";
+export declare const quaterniusSources: readonly AssetSource[];

package/dist/sources/quaternius.js

@@ -0,0 +1,18 @@
+const QUATERNIUS_PACKS = [
+    { id: "quaternius-stylized-nature", slug: "stylizednaturemegakit", title: "Stylized Nature MegaKit", categories: ["nature", "environment", "prop"] },
+    { id: "quaternius-medieval-village", slug: "medievalvillagemegakit", title: "Medieval Village MegaKit", categories: ["building", "medieval", "environment"] },
+    { id: "quaternius-downtown-city", slug: "downtowncitymegakit", title: "Downtown City MegaKit", categories: ["building", "city", "environment"] },
+    { id: "quaternius-modular-scifi", slug: "modularscifimegakit", title: "Modular SciFi MegaKit", categories: ["scifi", "environment", "prop"] },
+    { id: "quaternius-fantasy-props", slug: "fantasypropsmegakit", title: "Fantasy Props MegaKit", categories: ["fantasy", "prop"] },
+    { id: "quaternius-base-characters", slug: "universalbasecharacters", title: "Universal Base Characters", categories: ["character", "rigged"] },
+];
+export const quaterniusSources = QUATERNIUS_PACKS.map((pack) => ({
+    id: pack.id,
+    provider: "quaternius",
+    title: pack.title,
+    license: "CC0-1.0",
+    author: "Quaternius",
+    categories: pack.categories,
+    download: { scrape: `https://quaternius.com/packs/${pack.slug}.html` },
+    homepage: `https://quaternius.com/packs/${pack.slug}.html`,
+}));

package/dist/verify.d.ts

@@ -0,0 +1,13 @@
+import type { AssetAlias, AssetSource, IndexEntry, SingleAsset } from "./manifest.js";
+export interface VerifyResult {
+    ok: boolean;
+    errors: string[];
+}
+export interface VerifyInput {
+    sources: readonly AssetSource[];
+    singles: readonly SingleAsset[];
+    aliases: readonly AssetAlias[];
+    index: readonly IndexEntry[];
+}
+export declare function verifyData(input: VerifyInput): VerifyResult;
+export declare function verifyManifest(): VerifyResult;

package/dist/verify.js

@@ -0,0 +1,34 @@
+import { aliases } from "./aliases.js";
+import { generatedIndex } from "./generated/index.js";
+import { singles } from "./singles.js";
+import { sources } from "./sources/index.js";
+export function verifyData(input) {
+    const errors = [];
+    for (const source of input.sources) {
+        if (source.license.trim().length === 0)
+            errors.push(`source ${source.id}: missing license`);
+        if (source.author.trim().length === 0)
+            errors.push(`source ${source.id}: missing author`);
+    }
+    for (const single of input.singles) {
+        if (single.license.trim().length === 0)
+            errors.push(`single ${single.id}: missing license`);
+        if (single.author.trim().length === 0)
+            errors.push(`single ${single.id}: missing author`);
+        if (single.url.trim().length === 0)
+            errors.push(`single ${single.id}: missing url`);
+    }
+    const knownIds = new Set([
+        ...input.index.map((entry) => entry.id),
+        ...input.singles.map((single) => single.id),
+    ]);
+    for (const alias of input.aliases) {
+        if (!knownIds.has(alias.target)) {
+            errors.push(`alias ${alias.key}: target "${alias.target}" not found in index or singles`);
+        }
+    }
+    return { ok: errors.length === 0, errors };
+}
+export function verifyManifest() {
+    return verifyData({ sources, singles, aliases, index: generatedIndex });
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@jgengine/assets",
+  "version": "0.4.0",
+  "description": "Self-generating, license-verified index of thousands of CC0 3D models for JGengine. Sources fetch from providers' own CDNs at pull time; the npm tarball ships only the typed index and CLI (no GLB bytes).",
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Noisemaker111/jgengine.git",
+    "directory": "packages/assets"
+  },
+  "files": ["dist"],
+  "bin": {
+    "assets": "dist/cli/pull.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "scripts": {
+    "build": "tsgo -p tsconfig.build.json && bun ../../scripts/fix-extensions.ts dist && bun scripts/postbuild.ts",
+    "check-types": "tsgo --noEmit -p tsconfig.json",
+    "test": "bun test src"
+  },
+  "dependencies": {
+    "@jgengine/core": "^0.4.0",
+    "fflate": "^0.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}