@adea-ai/asset-manifests 0.10.8

package/README.md

@@ -0,0 +1,5 @@
+# Asset manifests
+
+Typed metadata for lazy scene assets, URLs, zones, colliders, preload hints, and
+scene start positions. Manifests stay lightweight so the runtime can stream a
+scene without importing unrelated asset catalogs.

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@adea-ai/asset-manifests",
+  "version": "0.10.8",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,95 @@
+export type SceneAvailability = "ready" | "planned";
+
+export type SceneZone = {
+  id: string;
+  assetUrl: string;
+  /** Optional collision layer that follows this visual zone. */
+  collisionAssetUrl?: string;
+  /** Additional visual layers that load and unload with this zone. */
+  assetUrls?: readonly string[];
+  /** Exact-triangle field colliders that load and unload with this zone. */
+  collisionAssetUrls?: readonly string[];
+  preload?: boolean;
+  /** Load the zone automatically when the player enters this radius. */
+  preloadDistance?: number;
+  /** Optional transform for a model authored in local building space. */
+  transform?: {
+    position?: readonly [number, number, number];
+    quaternion?: readonly [number, number, number, number];
+    scale?: readonly [number, number, number];
+  };
+};
+
+export type SceneStartPosition = {
+  x: number;
+  y: number;
+  z: number;
+  yaw?: number;
+  pitch?: number;
+  /** Keep an authored start height instead of snapping to the first ray hit. */
+  snapToGround?: boolean;
+};
+
+export type StaticFieldAssetUrls = {
+  foliage?: string;
+  props?: string;
+};
+
+export type AssignedPropManifestPlacement = {
+  id?: string;
+  p?: readonly [number, number, number];
+  q?: readonly [number, number, number, number];
+  s?: readonly [number, number, number];
+  footprint?: readonly [number, number];
+};
+
+export type AssignedPropManifestAsset = {
+  assetUrl: string;
+  defaultScale: number;
+  footprint?: readonly [number, number];
+  placementSurface?: "floor" | "wall";
+  wallMountHeight?: number;
+  floorLift?: number;
+  placeableOnTop?: boolean;
+};
+
+/** Runtime-only room content for props already assigned to a scene. */
+export type AssignedPropsManifest = {
+  version?: number;
+  scene?: string;
+  assets: Record<string, AssignedPropManifestAsset>;
+  placements: Record<string, AssignedPropManifestPlacement[]>;
+};
+
+export type SceneManifest = {
+  id: string;
+  label: string;
+  availability?: SceneAvailability;
+  entryAssetUrl: string;
+  /** Optional id for making the initially loaded asset unloadable as a zone. */
+  entryZoneId?: string;
+  /** Keep the entry collision layer active while visual zones transition. */
+  preserveEntryCollision?: boolean;
+  collisionAssetUrl?: string;
+  /** Additional collision layers kept active for multi-level scenes. */
+  additionalCollisionAssetUrls?: readonly string[];
+  additionalAssetUrls?: readonly string[];
+  zones?: SceneZone[];
+  startPosition?: SceneStartPosition;
+  /** Build-generated instanced fields for static scenes (preferred over runtime manifests). */
+  staticFieldAssetUrls?: StaticFieldAssetUrls;
+  /** Render-free exact-triangle companions for the generated static fields. */
+  staticFieldCollisionAssetUrls?: StaticFieldAssetUrls;
+  /** Optional foliage placement manifest (instanced from the foliage catalog at runtime). */
+  foliageManifestUrl?: string;
+  /** Optional props placement manifest (instanced from the props catalog at runtime). */
+  propsManifestUrl?: string;
+  /** Runtime-only manifest for props explicitly assigned to this workspace. */
+  assignedPropsManifestUrl?: string;
+  /** Public URL for persisted authored-object editor overrides. */
+  editorOverridesUrl?: string;
+  /** Optional repository-relative source path for persisted overrides. */
+  editorOverridesSourcePath?: string;
+  /** Optional repository-relative public copy path for persisted overrides. */
+  editorOverridesPublicPath?: string;
+};

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "rootDir": "src", "outDir": "dist", "declaration": true },
+  "include": ["src"]
+}