@jgengine/assets 0.9.0 → 0.11.0

package/dist/generated-sprites/index.d.ts

@@ -0,0 +1,5 @@
+import type { IndexEntry } from "../manifest.js";
+/** Pulled sprite/icon entries grouped by source id. */
+export declare const generatedSpriteBySource: Record<string, IndexEntry[]>;
+/** Every pulled sprite/icon entry across all sources, flattened. */
+export declare const generatedSpriteIndex: IndexEntry[];

package/dist/generated-sprites/index.js

@@ -0,0 +1,4 @@
+/** Pulled sprite/icon entries grouped by source id. */
+export const generatedSpriteBySource = {};
+/** Every pulled sprite/icon entry across all sources, flattened. */
+export const generatedSpriteIndex = Object.values(generatedSpriteBySource).flat();

package/dist/index.d.ts

@@ -1,12 +1,19 @@
 export * from "./manifest.js";
-export { sources, sourceById, kenneySources, quaterniusSources, kaykitSources } from "./sources/index.js";
+export { sources, sourceById, modelSources, materialSources, spriteSources, ambientcgSources, gameiconsSources, quaterniusSources, kaykitSources, } from "./sources/index.js";
+export { buildMaterialCatalog, extractMaterialMaps, materialAliases, MATERIAL_MAP_FILES, type BuildMaterialCatalogOptions, type ExtractedMaterialMap, type MaterialCatalog, type MaterialMapRole, type MaterialMaps, type MaterialRef, } from "./materials.js";
+export { extractSpriteFiles, type ExtractedSpriteFile } from "./download.js";
+export { keyFromSpriteFile, entryForSpriteFile, indexSpriteSourceDir, reindexSprites, type ReindexSpritesResult, } from "./spriteIndexGen.js";
 export { singles } from "./singles.js";
 export { aliases } from "./aliases.js";
 export { generatedIndex, generatedBySource } from "./generated/index.js";
+export { generatedSpriteIndex, generatedSpriteBySource } from "./generated-sprites/index.js";
 export { readGlbDims } from "./dims.js";
 export { buildCatalog, entryUrl, type BuildCatalogOptions } from "./catalogs/build.js";
+export { buildSpriteCatalog, type BuildSpriteCatalogOptions } from "./catalogs/buildSprites.js";
 export { createStarterCatalog } from "./catalogs/starter.js";
+export { STARTER_ASSETS, STARTER_PACKS, STARTER_SOURCE_PACKS, STARTER_THEMES, type StarterAsset, type StarterTheme, } from "./packs/starter.js";
 export { findAssets, rankAssets, type AssetKind, type AssetMatch, type FindOptions, type RankedMatch, } from "./find.js";
 export { registryCatalog, componentInstallUrl, type RegistryCatalog, type RegistryComponent } from "./registry.js";
-export { modelWiringSnippet, componentWiringSnippet, iconWiringSnippet, type ModelSnippetOptions } from "./snippet.js";
+export { modelWiringSnippet, materialWiringSnippet, componentWiringSnippet, iconWiringSnippet, spriteWiringSnippet, type ModelSnippetOptions, } from "./snippet.js";
 export { verifyManifest, type VerifyResult } from "./verify.js";
+export { resolveProvenance, validateAssetReferences, type AssetProvenance, type AssetProvenanceKind, type AssetReference, type ReferenceValidation, type ResolveProvenanceOptions, type ValidateAssetReferencesOptions, type ValidateAssetReferencesResult, } from "./provisioning.js";

package/dist/index.js

@@ -1,12 +1,19 @@
 export * from "./manifest.js";
-export { sources, sourceById, kenneySources, quaterniusSources, kaykitSources } from "./sources/index.js";
+export { sources, sourceById, modelSources, materialSources, spriteSources, ambientcgSources, gameiconsSources, quaterniusSources, kaykitSources, } from "./sources/index.js";
+export { buildMaterialCatalog, extractMaterialMaps, materialAliases, MATERIAL_MAP_FILES, } from "./materials.js";
+export { extractSpriteFiles } from "./download.js";
+export { keyFromSpriteFile, entryForSpriteFile, indexSpriteSourceDir, reindexSprites, } from "./spriteIndexGen.js";
 export { singles } from "./singles.js";
 export { aliases } from "./aliases.js";
 export { generatedIndex, generatedBySource } from "./generated/index.js";
+export { generatedSpriteIndex, generatedSpriteBySource } from "./generated-sprites/index.js";
 export { readGlbDims } from "./dims.js";
 export { buildCatalog, entryUrl } from "./catalogs/build.js";
+export { buildSpriteCatalog } from "./catalogs/buildSprites.js";
 export { createStarterCatalog } from "./catalogs/starter.js";
+export { STARTER_ASSETS, STARTER_PACKS, STARTER_SOURCE_PACKS, STARTER_THEMES, } from "./packs/starter.js";
 export { findAssets, rankAssets, } from "./find.js";
 export { registryCatalog, componentInstallUrl } from "./registry.js";
-export { modelWiringSnippet, componentWiringSnippet, iconWiringSnippet } from "./snippet.js";
+export { modelWiringSnippet, materialWiringSnippet, componentWiringSnippet, iconWiringSnippet, spriteWiringSnippet, } from "./snippet.js";
 export { verifyManifest } from "./verify.js";
+export { resolveProvenance, validateAssetReferences, } from "./provisioning.js";

package/dist/indexGen.js

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import { readGlbDims } from "./dims.js";
 import { sourceById } from "./sources/index.js";
 export function keyFromFile(file) {
-    return file.replace(/\.glb$/i, "");
+    return file.replace(/\.gltf\.glb$/i, "").replace(/\.glb$/i, "");
 }
 export function entryForFile(source, file, dims) {
     return {
@@ -87,7 +87,6 @@ export const generatedIndex = 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())
         : [];
@@ -99,14 +98,17 @@ export function reindex(modelsDir, outDir) {
         }
         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"), renderTsBarrel(sourceIds));
+    const barrelIds = readdirSync(outDir)
+        .filter((name) => name.endsWith(".json"))
+        .map((name) => name.slice(0, -".json".length))
+        .filter((id) => sourceById.has(id));
+    writeFileSync(join(outDir, "index.ts"), renderTsBarrel(barrelIds));
     // Published installs only ship dist/; write a JS barrel there so buildCatalog can re-import after reindex.
     // Source-tree reindex keeps the TypeScript barrel that the package build compiles.
     if (!/[/\\]src[/\\]generated$/i.test(outDir)) {
-        writeFileSync(join(outDir, "index.js"), renderJsBarrel(sourceIds));
+        writeFileSync(join(outDir, "index.js"), renderJsBarrel(barrelIds));
     }
     return { perSource, total: perSource.reduce((sum, entry) => sum + entry.count, 0) };
 }

package/dist/manifest.d.ts

@@ -1,6 +1,13 @@
 import type { ModelDims } from "@jgengine/core/scene/assetCatalog";
+import type { AssetSpace } from "@jgengine/core/scene/assetSpace";
 export type { ModelDims };
-export type AssetProvider = "kenney" | "quaternius" | "kaykit" | "polypizza" | "itch" | "custom";
+export type { AssetSpace };
+export type AssetProvider = "quaternius" | "kaykit" | "polypizza" | "itch" | "ambientcg" | "gameicons" | "custom";
+/**
+ * What a source's archive contains: GLB models (default), one PBR material's
+ * texture maps, or a pack of individual 2D sprite/icon files (SVG/PNG).
+ */
+export type AssetSourceKind = "model" | "material" | "sprite";
 export interface PinnedDownload {
     url: string;
     sha256?: string;
@@ -12,6 +19,8 @@ export type AssetDownload = PinnedDownload | ScrapeDownload;
 export declare function isScrapeDownload(download: AssetDownload): download is ScrapeDownload;
 export interface AssetSource {
     id: string;
+    /** What the archive contains: GLB models (default), a PBR material's texture maps, or a sprite/icon pack. */
+    kind?: AssetSourceKind;
     provider: AssetProvider;
     title: string;
     license: string;
@@ -29,6 +38,8 @@ export interface IndexEntry {
     file: string;
     /** Footprint/center/minY measured from the GLB at reindex; absent when the model could not be read. */
     dims?: ModelDims;
+    /** Authored asset-space metadata (canonical facing, unit scale, footprint, anchor, bounds, rotation policy); absent unless a curator overrides the measured defaults. */
+    space?: AssetSpace;
 }
 export interface AssetAlias {
     key: string;

package/dist/materials.d.ts

@@ -0,0 +1,61 @@
+import type { AssetAlias } from "./manifest.js";
+/** Normalized filenames a pulled material directory contains, keyed by map role. */
+export declare const MATERIAL_MAP_FILES: {
+    readonly color: "color.jpg";
+    readonly normal: "normal.jpg";
+    readonly roughness: "roughness.jpg";
+    readonly ao: "ao.jpg";
+    readonly displacement: "displacement.jpg";
+};
+/** One PBR map's role within a material: color, normal, roughness, ao, or displacement. */
+export type MaterialMapRole = keyof typeof MATERIAL_MAP_FILES;
+/** One normalized map pulled out of a material archive by `extractMaterialMaps`. */
+export interface ExtractedMaterialMap {
+    /** Normalized output filename (`color.jpg`, `normal.jpg`, …). */
+    file: string;
+    role: MaterialMapRole;
+    bytes: Uint8Array;
+}
+/**
+ * Pulls the recognized PBR maps out of a material archive (ambientCG's flat
+ * `<Asset>_<Res>_<Map>.jpg` layout) and normalizes their names so resolved
+ * URLs never depend on the provider's naming or the pulled resolution.
+ */
+export declare function extractMaterialMaps(archive: Uint8Array): ExtractedMaterialMap[];
+/** URLs of one material's PBR maps; `ao`/`displacement` files may be absent from a rare pack. */
+export interface MaterialMaps {
+    color: string;
+    normal: string;
+    roughness: string;
+    ao: string;
+    displacement: string;
+}
+/** A resolved material: identity, attribution, and its normalized map URLs. */
+export interface MaterialRef {
+    id: string;
+    title: string;
+    license: string;
+    author: string;
+    categories: readonly string[];
+    maps: MaterialMaps;
+}
+/** Semantic keys onto the ambientCG catalog, mirroring the model alias layer. */
+export declare const materialAliases: readonly AssetAlias[];
+/** Options for `buildMaterialCatalog`. */
+export interface BuildMaterialCatalogOptions {
+    /** URL prefix where pulled material maps live (consumer's `public/materials`). */
+    basePath?: string;
+    includeAliases?: boolean;
+}
+/** Resolves material ids and `material/…` aliases to `MaterialRef`s. */
+export interface MaterialCatalog {
+    resolve(idOrAlias: string): MaterialRef | null;
+    ids(): readonly string[];
+}
+/**
+ * A resolvable catalog over every `kind: "material"` source. Ids are source
+ * ids (`ambientcg-grass001`) plus the `material/…` aliases; every resolve
+ * returns the normalized map URLs under `basePath`, matching what
+ * `assets pull` writes into `<dir>/materials/<id>/`.
+ */
+export declare function buildMaterialCatalog(options?: BuildMaterialCatalogOptions): MaterialCatalog;

package/dist/materials.js

@@ -0,0 +1,98 @@
+import { unzipSync } from "fflate";
+import { materialSources, sourceById } from "./sources/index.js";
+/** Normalized filenames a pulled material directory contains, keyed by map role. */
+export const MATERIAL_MAP_FILES = {
+    color: "color.jpg",
+    normal: "normal.jpg",
+    roughness: "roughness.jpg",
+    ao: "ao.jpg",
+    displacement: "displacement.jpg",
+};
+const MAP_SUFFIXES = [
+    { role: "color", pattern: /_Color\.(jpe?g|png)$/i },
+    { role: "normal", pattern: /_NormalGL\.(jpe?g|png)$/i },
+    { role: "roughness", pattern: /_Roughness\.(jpe?g|png)$/i },
+    { role: "ao", pattern: /_AmbientOcclusion\.(jpe?g|png)$/i },
+    { role: "displacement", pattern: /_Displacement\.(jpe?g|png)$/i },
+];
+/**
+ * Pulls the recognized PBR maps out of a material archive (ambientCG's flat
+ * `<Asset>_<Res>_<Map>.jpg` layout) and normalizes their names so resolved
+ * URLs never depend on the provider's naming or the pulled resolution.
+ */
+export function extractMaterialMaps(archive) {
+    const entries = unzipSync(archive);
+    const byRole = new Map();
+    for (const [path, bytes] of Object.entries(entries)) {
+        for (const { role, pattern } of MAP_SUFFIXES) {
+            if (pattern.test(path) && !byRole.has(role)) {
+                byRole.set(role, { file: MATERIAL_MAP_FILES[role], role, bytes });
+            }
+        }
+    }
+    return Array.from(byRole.values()).sort((a, b) => a.file.localeCompare(b.file));
+}
+/** Semantic keys onto the ambientCG catalog, mirroring the model alias layer. */
+export const materialAliases = [
+    { key: "material/grass", target: "ambientcg-grass001" },
+    { key: "material/dirt", target: "ambientcg-ground001" },
+    { key: "material/rock", target: "ambientcg-rock001" },
+    { key: "material/gravel", target: "ambientcg-gravel001" },
+    { key: "material/snow", target: "ambientcg-snow001" },
+    { key: "material/sand", target: "ambientcg-ground002" },
+    { key: "material/wood", target: "ambientcg-wood001" },
+    { key: "material/planks", target: "ambientcg-planks001" },
+    { key: "material/brick", target: "ambientcg-bricks001" },
+    { key: "material/paving", target: "ambientcg-pavingstones001" },
+    { key: "material/tile", target: "ambientcg-tiles001" },
+    { key: "material/concrete", target: "ambientcg-concrete001" },
+    { key: "material/asphalt", target: "ambientcg-asphalt001" },
+    { key: "material/metal", target: "ambientcg-metal001" },
+    { key: "material/fabric", target: "ambientcg-fabric001" },
+    { key: "material/lava", target: "ambientcg-lava001" },
+    { key: "material/ice", target: "ambientcg-ice001" },
+    { key: "material/marble", target: "ambientcg-marble001" },
+];
+function refFor(source, basePath) {
+    const base = `${basePath.replace(/\/+$/, "")}/${source.id}`;
+    return {
+        id: source.id,
+        title: source.title,
+        license: source.license,
+        author: source.author,
+        categories: source.categories,
+        maps: {
+            color: `${base}/${MATERIAL_MAP_FILES.color}`,
+            normal: `${base}/${MATERIAL_MAP_FILES.normal}`,
+            roughness: `${base}/${MATERIAL_MAP_FILES.roughness}`,
+            ao: `${base}/${MATERIAL_MAP_FILES.ao}`,
+            displacement: `${base}/${MATERIAL_MAP_FILES.displacement}`,
+        },
+    };
+}
+/**
+ * A resolvable catalog over every `kind: "material"` source. Ids are source
+ * ids (`ambientcg-grass001`) plus the `material/…` aliases; every resolve
+ * returns the normalized map URLs under `basePath`, matching what
+ * `assets pull` writes into `<dir>/materials/<id>/`.
+ */
+export function buildMaterialCatalog(options = {}) {
+    const basePath = options.basePath ?? "/materials";
+    const includeAliases = options.includeAliases ?? true;
+    const byKey = new Map();
+    for (const source of materialSources) {
+        byKey.set(source.id, refFor(source, basePath));
+    }
+    if (includeAliases) {
+        for (const alias of materialAliases) {
+            const target = sourceById.get(alias.target);
+            if (target === undefined || target.kind !== "material")
+                continue;
+            byKey.set(alias.key, refFor(target, basePath));
+        }
+    }
+    return {
+        resolve: (idOrAlias) => byKey.get(idOrAlias) ?? null,
+        ids: () => materialSources.map((source) => source.id),
+    };
+}

package/dist/packs/starter.d.ts

@@ -0,0 +1,46 @@
+import type { AssetAlias } from "../manifest.js";
+/**
+ * Curated drop-in starter themes for new games. Each entry maps a short semantic
+ * id (also registered as `asset:<id>`) to a live catalog GLB that is already
+ * measured (dims/anchor flow from the generated index via the alias target).
+ * Games wire them as `entityModels: { guest: "asset:person_casual" }`.
+ * Never Kenney — Quaternius / KayKit only.
+ * @capability starter-packs themed CC0 model ids (people/props/nature/urban) ready for entityModels
+ */
+/** people | props | nature | urban — the four curated starter themes. */
+export type StarterTheme = "people" | "props" | "nature" | "urban";
+/** One curated starter model: short id, theme, live catalog target, license, suggested height. */
+export interface StarterAsset {
+    /** Short id — also registered as `asset:<id>` and `starter/<id>`. */
+    id: string;
+    theme: StarterTheme;
+    /** Live catalog id (pack/file); must exist in the generated index. */
+    target: string;
+    /** Suggested height when used as a character/prop figure. */
+    targetHeight?: number;
+    title: string;
+    license: "CC0-1.0";
+    author: string;
+    provider: "kaykit" | "quaternius";
+}
+/** Flat list of every curated starter asset across themes. */
+export declare const STARTER_ASSETS: readonly StarterAsset[];
+/** Theme → assets table for browse/docs (`STARTER_PACKS.people`, …). */
+export declare const STARTER_PACKS: Readonly<Record<StarterTheme, readonly StarterAsset[]>>;
+/** Ordered starter theme ids: people, props, nature, urban. */
+export declare const STARTER_THEMES: readonly StarterTheme[];
+/** Source pack ids a game must pull so every starter asset URL resolves on disk. */
+export declare const STARTER_SOURCE_PACKS: readonly string[];
+/**
+ * Alias rows for the curated starter ids. Registered in the package aliases table so
+ * `buildCatalog` resolves `asset:person_casual`, `person_casual`, and
+ * `starter/person_casual` to the same measured GLB.
+ * @internal
+ */
+export declare function starterAliases(): readonly AssetAlias[];
+/** @internal */
+export declare function starterAssetById(id: string): StarterAsset | undefined;
+/** @internal */
+export declare function starterStyle(id: string): {
+    targetHeight?: number;
+} | undefined;

package/dist/packs/starter.js

@@ -0,0 +1,248 @@
+const PEOPLE = [
+    {
+        id: "person_casual",
+        theme: "people",
+        target: "kaykit-adventurers/Rogue",
+        targetHeight: 1.8,
+        title: "Casual person (rogue kit)",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "person_hooded",
+        theme: "people",
+        target: "kaykit-adventurers/Rogue_Hooded",
+        targetHeight: 1.8,
+        title: "Hooded person",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "person_armored",
+        theme: "people",
+        target: "kaykit-adventurers/Knight",
+        targetHeight: 1.85,
+        title: "Armored person",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "person_mage",
+        theme: "people",
+        target: "kaykit-adventurers/Mage",
+        targetHeight: 1.8,
+        title: "Robe person",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "person_heavy",
+        theme: "people",
+        target: "kaykit-adventurers/Barbarian",
+        targetHeight: 1.9,
+        title: "Heavy person",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+];
+const PROPS = [
+    {
+        id: "prop_crate",
+        theme: "props",
+        target: "kaykit-dungeon/crates_stacked",
+        targetHeight: 1.2,
+        title: "Stacked crates",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "prop_barrel",
+        theme: "props",
+        target: "kaykit-dungeon/barrel_large",
+        targetHeight: 1.1,
+        title: "Barrel",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "prop_chest",
+        theme: "props",
+        target: "kaykit-dungeon/chest",
+        targetHeight: 0.9,
+        title: "Chest",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "prop_table",
+        theme: "props",
+        target: "kaykit-furniture/table_medium",
+        targetHeight: 0.85,
+        title: "Table",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "prop_bench",
+        theme: "props",
+        target: "kaykit-city-builder/bench",
+        targetHeight: 0.7,
+        title: "Bench",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+];
+const NATURE = [
+    {
+        id: "nature_tree",
+        theme: "nature",
+        target: "quaternius-stylized-nature/CommonTree_1",
+        targetHeight: 4.5,
+        title: "Common tree",
+        license: "CC0-1.0",
+        author: "Quaternius",
+        provider: "quaternius",
+    },
+    {
+        id: "nature_pine",
+        theme: "nature",
+        target: "quaternius-stylized-nature/Pine_1",
+        targetHeight: 5,
+        title: "Pine tree",
+        license: "CC0-1.0",
+        author: "Quaternius",
+        provider: "quaternius",
+    },
+    {
+        id: "nature_bush",
+        theme: "nature",
+        target: "quaternius-stylized-nature/Bush_Common",
+        targetHeight: 1.2,
+        title: "Bush",
+        license: "CC0-1.0",
+        author: "Quaternius",
+        provider: "quaternius",
+    },
+    {
+        id: "nature_rock",
+        theme: "nature",
+        target: "quaternius-stylized-nature/Rock_Medium_1",
+        targetHeight: 1.4,
+        title: "Rock",
+        license: "CC0-1.0",
+        author: "Quaternius",
+        provider: "quaternius",
+    },
+    {
+        id: "nature_dead_tree",
+        theme: "nature",
+        target: "quaternius-stylized-nature/DeadTree_1",
+        targetHeight: 4,
+        title: "Dead tree",
+        license: "CC0-1.0",
+        author: "Quaternius",
+        provider: "quaternius",
+    },
+];
+const URBAN = [
+    {
+        id: "urban_building",
+        theme: "urban",
+        target: "kaykit-city-builder/building_A",
+        targetHeight: 8,
+        title: "City building",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "urban_car",
+        theme: "urban",
+        target: "kaykit-city-builder/car_sedan",
+        targetHeight: 1.4,
+        title: "Sedan",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "urban_streetlight",
+        theme: "urban",
+        target: "kaykit-city-builder/streetlight",
+        targetHeight: 4,
+        title: "Streetlight",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+    {
+        id: "urban_box",
+        theme: "urban",
+        target: "kaykit-city-builder/box_A",
+        targetHeight: 0.8,
+        title: "Street box",
+        license: "CC0-1.0",
+        author: "Kay Lousberg (KayKit)",
+        provider: "kaykit",
+    },
+];
+/** Flat list of every curated starter asset across themes. */
+export const STARTER_ASSETS = [...PEOPLE, ...PROPS, ...NATURE, ...URBAN];
+/** Theme → assets table for browse/docs (`STARTER_PACKS.people`, …). */
+export const STARTER_PACKS = {
+    people: PEOPLE,
+    props: PROPS,
+    nature: NATURE,
+    urban: URBAN,
+};
+/** Ordered starter theme ids: people, props, nature, urban. */
+export const STARTER_THEMES = ["people", "props", "nature", "urban"];
+/** Source pack ids a game must pull so every starter asset URL resolves on disk. */
+export const STARTER_SOURCE_PACKS = [
+    "kaykit-adventurers",
+    "kaykit-dungeon",
+    "kaykit-furniture",
+    "kaykit-city-builder",
+    "quaternius-stylized-nature",
+];
+/**
+ * Alias rows for the curated starter ids. Registered in the package aliases table so
+ * `buildCatalog` resolves `asset:person_casual`, `person_casual`, and
+ * `starter/person_casual` to the same measured GLB.
+ * @internal
+ */
+export function starterAliases() {
+    const rows = [];
+    for (const asset of STARTER_ASSETS) {
+        rows.push({ key: asset.id, target: asset.target });
+        rows.push({ key: `asset:${asset.id}`, target: asset.target });
+        rows.push({ key: `starter/${asset.id}`, target: asset.target });
+    }
+    return rows;
+}
+/** @internal */
+export function starterAssetById(id) {
+    const bare = id.startsWith("asset:")
+        ? id.slice("asset:".length)
+        : id.startsWith("starter/")
+            ? id.slice("starter/".length)
+            : id;
+    return STARTER_ASSETS.find((entry) => entry.id === bare);
+}
+/** @internal */
+export function starterStyle(id) {
+    const asset = starterAssetById(id);
+    if (asset === undefined)
+        return undefined;
+    return asset.targetHeight === undefined ? {} : { targetHeight: asset.targetHeight };
+}