@forgeax/engine-scene 0.1.3 → 0.1.6

package/dist/instances/scene-instances.d.ts

@@ -93,18 +93,10 @@ export interface SceneMembersSpawn {
     readonly totalSlots: number;
 }
 export type SceneAssetResolver = (source: number | string, parentHandle: Handle<'SceneAsset', 'shared'>) => Result<Handle<'SceneAsset', 'shared'>, unknown>;
-export type SceneInstantiateHook = (world: World, root: EntityHandle) => {
-    readonly ok: true;
-} | {
-    readonly ok: false;
-    readonly error: unknown;
-};
 /** @internal */
 export declare function worldSetSceneAssetResolver(world: World, resolver: SceneAssetResolver): void;
 /** @internal */
 export declare function worldGetSceneAssetResolver(world: World): SceneAssetResolver | null;
-/** @internal Install the owner post-instantiate boundary for one World. */
-export declare function worldSetSceneInstantiateHook(world: World, hook: SceneInstantiateHook | null): void;
 /**
  * Materialise a SceneAsset (and any nested SceneAsset references via
  * `mounts[]`) into live entities. Returns the synthetic root Entity that
@@ -127,6 +119,15 @@ export declare function worldSetSceneInstantiateHook(world: World, hook: SceneIn
  *   const member = inst.mapping[0]; // first member entity
  */
 export declare function worldInstantiateScene(world: World, handle: Handle<'SceneAsset', 'shared'>, parent?: EntityHandle): Result<SceneInstantiateOk, EcsError>;
+/**
+ * Materialise a projected `SceneAsset` payload without exposing the temporary
+ * shared-ref handle to the caller. The World remains the owner of both the
+ * handle and the instantiated SceneInstance: the producer grant is released
+ * after the SceneInstance retains its source, including when instantiation
+ * fails. This is the payload-shaped counterpart to `worldInstantiateScene` for
+ * hosts that load a SceneAsset directly from the Engine AssetRegistry.
+ */
+export declare function worldInstantiateScenePayload(world: World, asset: SceneAsset, parent?: EntityHandle): Result<SceneInstantiateOk, EcsError>;
 /**
  * Materialise a SceneAsset FLAT — the "edit the scene itself" primitive.
  * Unlike `instantiateScene`, this mints NO synthetic SceneInstance root and

package/dist/instances/scene-instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-instances.d.ts","sourceRoot":"","sources":["../../src/instances/scene-instances.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scene-instances.d.ts","sourceRoot":"","sources":["../../src/instances/scene-instances.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-scene",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -22,10 +22,9 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-ecs": "0.1.3",
-    "@forgeax/engine-math": "0.1.3",
-    "@forgeax/engine-pack": "0.1.3",
-    "@forgeax/engine-plugin": "0.1.3"
+    "@forgeax/engine-ecs": "0.1.6",
+    "@forgeax/engine-math": "0.1.6",
+    "@forgeax/engine-plugin": "0.1.6"
   },
   "forgeax": {
     "metrics": {

package/src/__tests__/asset-owner.integration.test.ts

@@ -1,34 +1,17 @@
 import { defineComponent, World } from '@forgeax/engine-ecs';
-import { AssetGuid } from '@forgeax/engine-pack/guid';
-import { err, ok, type SceneAsset } from '@forgeax/engine-types';
+import type { SceneAsset } from '@forgeax/engine-types';
 import { describe, expect, it } from 'vitest';
-import { sceneAssetDecoder } from '../assets/scene-decoder';
-import {
-  projectSceneAsset,
-  SCENE_ASSET_MESH_DEFAULT_RESOLVER_RESOURCE_KEY,
-  type SceneAssetMeshDefaultResolver,
-} from '../assets/scene-projection';
-import { ChildOf, Children } from '../components/children';
-import {
-  worldInstantiateScene,
-  worldInstantiateSceneFlat,
-  worldSetSceneInstantiateHook,
-} from '../instances/scene-instances';
+import { ChildOf, Children, worldDespawnScene, worldInstantiateScenePayload } from '../index';
 
 const SceneInstance = defineComponent('SceneInstance', {
   source: { type: 'shared<SceneAsset>' },
   mapping: { type: 'array<entity>' },
   state: { type: 'unique<SceneInstanceState>' },
 });
-const SceneMarker = defineComponent('M2SceneOwnerMarker', { value: 'i32' });
-const SceneAssetRefs = defineComponent('M2SceneAssetRefs', {
-  mesh: 'shared<MeshAsset>',
-  materials: 'array<shared<MaterialAsset>>',
-});
-void SceneAssetRefs;
+const SceneMarker = defineComponent('ScenePayloadMarker', { value: 'i32' });
 
 function registerSceneWorld(world: World): void {
-  for (const component of [SceneInstance, ChildOf, Children, SceneMarker, SceneAssetRefs]) {
+  for (const component of [SceneInstance, ChildOf, Children, SceneMarker]) {
     world.components.register(component).unwrap();
   }
 }
@@ -39,207 +22,36 @@ function scene(): SceneAsset {
     entities: [
       {
         localId: 0 as never,
-        components: { M2SceneOwnerMarker: { value: 7 } },
+        components: { ScenePayloadMarker: { value: 7 } },
       },
     ],
   };
 }
 
-describe('scene owner direct contract', () => {
-  it('instantiates a real SceneAsset through a World and keeps the payload identity', () => {
+describe('scene payload ownership', () => {
+  it('retains the payload for the mounted instance and releases it on despawn', () => {
     const world = new World();
     registerSceneWorld(world);
-    const handle = world.allocSharedRef('SceneAsset', scene());
 
-    const result = worldInstantiateSceneFlat(world, handle);
+    const result = worldInstantiateScenePayload(world, scene());
 
     expect(result.ok).toBe(true);
-    expect(world.sharedRefs.resolve(handle)).toMatchObject({ ok: true, value: { kind: 'scene' } });
+    expect(world.sharedRefs._liveCount()).toBe(1);
     if (!result.ok) return;
-    expect(result.value.roots).toHaveLength(1);
-    expect(world.get(result.value.roots[0] as never, SceneMarker)).toMatchObject({
-      ok: true,
-      value: { value: 7 },
-    });
+    expect(worldDespawnScene(world, result.value.root).ok).toBe(true);
+    expect(world.sharedRefs._liveCount()).toBe(0);
   });
 
-  it('rolls back a failed scene mount without leaving a partial entity', () => {
+  it('releases the temporary producer grant when materialisation fails', () => {
     const world = new World();
     registerSceneWorld(world);
-    const invalid = world.allocSharedRef('SceneAsset', {
+
+    const result = worldInstantiateScenePayload(world, {
       kind: 'scene',
       entities: [{ localId: 0 as never, components: { MissingComponent: { value: 1 } } }],
     } as SceneAsset);
 
-    const result = worldInstantiateSceneFlat(world, invalid);
-
     expect(result.ok).toBe(false);
-    const query = world.query({ read: [SceneMarker] });
-    expect(query.ok ? Array.from(query.value) : []).toHaveLength(0);
-  });
-
-  it('rolls back the materialized subtree when an owner hook fails', () => {
-    const world = new World();
-    registerSceneWorld(world);
-    const handle = world.allocSharedRef('SceneAsset', scene());
-    const expected = { code: 'scene-owner-hook-failed' };
-    worldSetSceneInstantiateHook(world, () => ({ ok: false, error: expected }));
-
-    const result = worldInstantiateScene(world, handle);
-
-    expect(result).toEqual({ ok: false, error: expected });
-    const query = world.query({ read: [SceneMarker] });
-    expect(query.ok ? Array.from(query.value) : []).toHaveLength(0);
-  });
-
-  it('keeps Pack refs[] indices for World-local shared-field projection', async () => {
-    const decoded = await sceneAssetDecoder.decode({
-      envelope: {
-        guid: 'scene-guid',
-        kind: 'scene',
-        refs: ['mesh-guid', 'material-guid'],
-        artifacts: {},
-        payload: {
-          kind: 'scene',
-          entities: [
-            {
-              localId: 0 as never,
-              components: {
-                M2SceneAssetRefs: { mesh: 0, materials: [1] },
-              },
-            },
-          ],
-        } as unknown as SceneAsset,
-      },
-      artifacts: { read: async () => err({ code: 'asset-artifact-missing' } as never) },
-      signal: new AbortController().signal,
-    });
-
-    expect(decoded.ok).toBe(true);
-    if (!decoded.ok) return;
-    expect(decoded.value.entities[0]?.components.M2SceneAssetRefs).toEqual({
-      mesh: 0,
-      materials: [1],
-    });
-
-    const world = new World();
-    registerSceneWorld(world);
-    const projected = await projectSceneAsset(world, decoded.value, async (guid, kind) =>
-      ok({ kind, guid }),
-    );
-    expect(projected.ok).toBe(true);
-    if (!projected.ok) return;
-    const fields = projected.value.entities[0]?.components.M2SceneAssetRefs as Record<
-      string,
-      unknown
-    >;
-    expect(world.sharedRefs.resolve(fields.mesh as never)).toMatchObject({
-      value: { kind: 'mesh', guid: 'mesh-guid' },
-    });
-    expect(world.sharedRefs.resolve((fields.materials as unknown[])[0] as never)).toMatchObject({
-      value: { kind: 'material', guid: 'material-guid' },
-    });
-  });
-
-  it('projects GUID fields and nested mounts into World-owned shared refs', async () => {
-    const world = new World();
-    registerSceneWorld(world);
-    const child: SceneAsset = {
-      kind: 'scene',
-      entities: [{ localId: 0 as never, components: { M2SceneOwnerMarker: { value: 1 } } }],
-    };
-    const root: SceneAsset = {
-      kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
-          components: {
-            M2SceneAssetRefs: { mesh: 'mesh-guid', materials: ['material-guid'] },
-          },
-        },
-      ],
-      mounts: [
-        {
-          localId: 1 as never,
-          source: 'child-guid',
-          memberFirst: 2 as never,
-          memberCount: 1,
-          components: { M2SceneOwnerMarker: { value: 2 } },
-        },
-      ],
-    };
-    const payloads: Record<string, unknown> = {
-      'mesh-guid': { kind: 'mesh' },
-      'material-guid': { kind: 'material' },
-      'child-guid': child,
-    };
-
-    const projected = await projectSceneAsset(world, root, async (guid, kind) => {
-      const payload = payloads[guid];
-      if (payload === undefined) return err({ code: 'asset-not-found' } as never);
-      expect((payload as { readonly kind: string }).kind).toBe(kind);
-      return ok(payload);
-    });
-
-    expect(projected.ok).toBe(true);
-    if (!projected.ok) return;
-    const fields = projected.value.entities[0]?.components.M2SceneAssetRefs as Record<
-      string,
-      unknown
-    >;
-    expect(typeof fields.mesh).toBe('number');
-    expect(Array.isArray(fields.materials)).toBe(true);
-    const mountSource = projected.value.mounts?.[0]?.source;
-    expect(typeof mountSource).toBe('number');
-    expect(world.sharedRefs.resolve(fields.mesh as never)).toMatchObject({
-      value: { kind: 'mesh' },
-    });
-    expect(world.sharedRefs.resolve(mountSource as never)).toMatchObject({
-      value: { kind: 'scene' },
-    });
-
-    const sceneHandle = world.allocSharedRef('SceneAsset', projected.value);
-    const instantiated = worldInstantiateScene(world, sceneHandle);
-    expect(instantiated.ok).toBe(true);
-  });
-
-  it('projects mesh-owned material defaults into the World render view', async () => {
-    const world = new World();
-    registerSceneWorld(world);
-    const materialGuid = '019eb2cf-0001-7000-8000-deadbeef0002';
-    const parsedGuid = AssetGuid.parse(materialGuid);
-    expect(parsedGuid.ok).toBe(true);
-    if (!parsedGuid.ok) return;
-
-    const root: SceneAsset = {
-      kind: 'scene',
-      entities: [
-        {
-          localId: 0 as never,
-          components: { M2SceneAssetRefs: { mesh: 'mesh-guid', materials: [] } },
-        },
-      ],
-    };
-    const payloads: Record<string, unknown> = {
-      'mesh-guid': {
-        kind: 'mesh',
-        materialSlots: [{ slotName: 'Default', defaultMaterial: parsedGuid.value }],
-      },
-      [materialGuid]: { kind: 'material' },
-    };
-
-    const projected = await projectSceneAsset(world, root, async (guid, kind) => {
-      const payload = payloads[guid.toLowerCase()];
-      if (payload === undefined) return err({ code: 'asset-not-found' } as never);
-      expect((payload as { readonly kind: string }).kind).toBe(kind);
-      return ok(payload);
-    });
-
-    expect(projected.ok).toBe(true);
-    if (!projected.ok) return;
-    const resolver = world.getResource<SceneAssetMeshDefaultResolver>(
-      SCENE_ASSET_MESH_DEFAULT_RESOLVER_RESOURCE_KEY,
-    );
-    expect(resolver.resolveMeshDefaultMaterial(materialGuid)).toBeGreaterThan(0);
+    expect(world.sharedRefs._liveCount()).toBe(0);
   });
 });

package/src/collect-subtree.ts

@@ -0,0 +1,30 @@
+// Scene-owned hierarchy traversal shared by scene collection and render hooks.
+
+import type { EntityHandle, World } from '@forgeax/engine-ecs';
+
+import { Children } from './components/children';
+
+/** Walk a Children hierarchy breadth-first, reusing an optional visited set. */
+export function collectSubtree(
+  world: World,
+  spawnRoot: EntityHandle,
+  visited?: Set<number>,
+): Set<number> {
+  if (visited === undefined) visited = new Set<number>();
+  if (visited.has(spawnRoot as number)) return visited;
+  const queue: number[] = [spawnRoot as number];
+  visited.add(spawnRoot as number);
+  while (queue.length > 0) {
+    const current = queue.shift() as number;
+    const children = world.get(current as EntityHandle, Children);
+    if (!children.ok) continue;
+    const entities = children.value.entities as ArrayLike<number>;
+    for (let index = 0; index < entities.length; index += 1) {
+      const child = entities[index] as number;
+      if (visited.has(child)) continue;
+      visited.add(child);
+      queue.push(child);
+    }
+  }
+  return visited;
+}

package/src/index.ts

@@ -1,17 +1,5 @@
-export {
-  sceneAssetContribution,
-  sceneAssetDecoder,
-  sceneAssetKind,
-} from './assets/scene-decoder';
-export {
-  projectSceneAsset,
-  SCENE_ASSET_MESH_DEFAULT_RESOLVER_RESOURCE_KEY,
-  SCENE_ASSET_SKIN_RESOLVER_RESOURCE_KEY,
-  type SceneAssetMeshDefaultResolver,
-  type SceneAssetProjectionError,
-  type SceneAssetReferenceLoader,
-  type SceneAssetSkinResolver,
-} from './assets/scene-projection';
+export { sceneAssetContribution } from './assets/scene-decoder';
+export { collectSubtree } from './collect-subtree';
 export { ChildOf } from './components/child-of';
 export { Children } from './components/children';
 export { MorphWeights } from './components/morph-weights';
@@ -35,7 +23,6 @@ export {
   type SceneInstanceStatePayload,
   type SceneInstantiateDiagnostic,
   type SceneInstantiateFlatOk,
-  type SceneInstantiateHook,
   type SceneInstantiateOk,
   type SceneMembersSpawn,
   worldApplyMountOverride,
@@ -50,6 +37,7 @@ export {
   worldInstantiateSceneAsset,
   worldInstantiateSceneAssetFlat,
   worldInstantiateSceneFlat,
+  worldInstantiateScenePayload,
   worldInstantiateSceneRec,
   worldMountOverridesToStateMap,
   worldReattachSceneMember,
@@ -58,7 +46,6 @@ export {
   worldResolveSceneAsset,
   worldResolveSceneInstanceStatePayload,
   worldSetSceneAssetResolver,
-  worldSetSceneInstantiateHook,
   worldSetSceneOverride,
   worldSpawnMountEntity,
   worldSpawnSceneMembers,

package/src/instances/scene-instances.ts

@@ -139,24 +139,14 @@ export type SceneAssetResolver = (
 interface SceneWorldState {
   resolver: SceneAssetResolver | null;
   readonly statePayloads: Map<number, unknown>;
-  instantiateHook: SceneInstantiateHook | null;
 }
 
-export type SceneInstantiateHook = (
-  world: World,
-  root: EntityHandle,
-) => { readonly ok: true } | { readonly ok: false; readonly error: unknown };
-
 const sceneWorldStates = new WeakMap<World, SceneWorldState>();
 
 function sceneWorldState(world: World): SceneWorldState {
   const current = sceneWorldStates.get(world);
   if (current !== undefined) return current;
-  const created = {
-    resolver: null,
-    statePayloads: new Map<number, unknown>(),
-    instantiateHook: null,
-  };
+  const created = { resolver: null, statePayloads: new Map<number, unknown>() };
   sceneWorldStates.set(world, created);
   return created;
 }
@@ -171,14 +161,6 @@ export function worldGetSceneAssetResolver(world: World): SceneAssetResolver | n
   return sceneWorldState(world).resolver;
 }
 
-/** @internal Install the owner post-instantiate boundary for one World. */
-export function worldSetSceneInstantiateHook(
-  world: World,
-  hook: SceneInstantiateHook | null,
-): void {
-  sceneWorldState(world).instantiateHook = hook;
-}
-
 /**
  * Materialise a SceneAsset (and any nested SceneAsset references via
  * `mounts[]`) into live entities. Returns the synthetic root Entity that
@@ -212,16 +194,33 @@ export function worldInstantiateScene(
   const diagnostics: SceneInstantiateDiagnostic[] = [];
   const r = worldInstantiateSceneRec(world, handle, parent, stack, diagnostics);
   if (!r.ok) return r;
-  const hook = sceneWorldState(world).instantiateHook;
-  if (hook !== null) {
-    const hooked = hook(world, r.value);
-    if (!hooked.ok) {
-      worldDespawnScene(world, r.value);
-      return err(hooked.error as EcsError);
-    }
-  }
   return ok({ root: r.value, diagnostics });
 }
+
+/**
+ * Materialise a projected `SceneAsset` payload without exposing the temporary
+ * shared-ref handle to the caller. The World remains the owner of both the
+ * handle and the instantiated SceneInstance: the producer grant is released
+ * after the SceneInstance retains its source, including when instantiation
+ * fails. This is the payload-shaped counterpart to `worldInstantiateScene` for
+ * hosts that load a SceneAsset directly from the Engine AssetRegistry.
+ */
+export function worldInstantiateScenePayload(
+  world: World,
+  asset: SceneAsset,
+  parent?: EntityHandle,
+): Result<SceneInstantiateOk, EcsError> {
+  const handle = world.allocSharedRef('SceneAsset', asset);
+  try {
+    return worldInstantiateScene(world, handle, parent);
+  } finally {
+    // The SceneInstance source column retains the handle on success. On a
+    // failed materialisation there should be no remaining holder; either way
+    // release the producer grant owned by this convenience entrypoint.
+    world.sharedRefs.release(handle);
+  }
+}
+
 /**
  * Materialise a SceneAsset FLAT — the "edit the scene itself" primitive.
  * Unlike `instantiateScene`, this mints NO synthetic SceneInstance root and

package/dist/assets/instantiate-scene.d.ts

@@ -1,7 +0,0 @@
-import type { EntityHandle, World } from '@forgeax/engine-ecs';
-import type { Handle, SceneAsset } from '@forgeax/engine-types';
-import { worldInstantiateScene } from '../instances/scene-instances';
-/** Scene-owned entry point for materialising a validated SceneAsset in a World. */
-export declare function instantiateScene(world: World, handle: Handle<'SceneAsset', 'shared'>, parent?: EntityHandle): ReturnType<typeof worldInstantiateScene>;
-export type SceneInstanceAsset = SceneAsset;
-//# sourceMappingURL=instantiate-scene.d.ts.map

package/dist/assets/instantiate-scene.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instantiate-scene.d.ts","sourceRoot":"","sources":["../../src/assets/instantiate-scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,mFAAmF;AACnF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,EACtC,MAAM,CAAC,EAAE,YAAY,GACpB,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAE1C;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC"}

package/dist/assets/publication-observer.d.ts

@@ -1,13 +0,0 @@
-import { type AssetPublicationTuple, type Result } from '@forgeax/engine-types';
-export interface ScenePublicationObservation {
-    readonly guid: string;
-    readonly generation: number;
-    readonly digest: string;
-}
-/** Read-only projection of a published scene envelope for consumers. */
-export declare function observeScenePublication(envelope: AssetPublicationTuple): Result<ScenePublicationObservation, {
-    readonly code: 'scene-publication-invalid';
-    readonly expected: string;
-    readonly hint: string;
-}>;
-//# sourceMappingURL=publication-observer.d.ts.map

package/dist/assets/publication-observer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"publication-observer.d.ts","sourceRoot":"","sources":["../../src/assets/publication-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CACP,2BAA2B,EAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CACjG,CASA"}

package/dist/assets/scene-projection.d.ts

@@ -1,70 +0,0 @@
-import type { World } from '@forgeax/engine-ecs';
-import { type BuiltinAssetKind, type Result, type SceneAsset, type SkinAsset } from '@forgeax/engine-types';
-/** World resource key for the scene projection's skin dependency view. */
-export declare const SCENE_ASSET_SKIN_RESOLVER_RESOURCE_KEY = "SceneAssetSkinResolver";
-/** World resource key for mesh-owned material default resolution. */
-export declare const SCENE_ASSET_MESH_DEFAULT_RESOLVER_RESOURCE_KEY = "SceneAssetMeshDefaultResolver";
-/**
- * Scene projection output consumed by the renderer's post-instantiate hook.
- * Scene owns the GUID-to-payload dependency view; ECS and Render only depend
- * on this narrow resolver shape.
- */
-export interface SceneAssetSkinResolver {
-    resolveSkinAsset(skeletonHandle: number): SkinAsset | undefined;
-}
-/**
- * Render-facing view of material defaults loaded while projecting a scene.
- * MeshAsset keeps these defaults as GUID facts; Render consumes World handles
- * without importing the AssetRegistry or teaching the scene component about
- * renderer policy.
- */
-export interface SceneAssetMeshDefaultResolver {
-    resolveMeshDefaultMaterial(guid: string): number | undefined;
-}
-/** Errors raised while projecting a decoded SceneAsset into one World. */
-export type SceneAssetProjectionError = {
-    readonly code: 'scene-reference-target-unsupported';
-    readonly expected: string;
-    readonly hint: string;
-    readonly detail: {
-        readonly guid: string;
-        readonly target: string;
-        readonly field: string;
-    };
-} | {
-    readonly code: 'scene-reference-kind-mismatch';
-    readonly expected: string;
-    readonly hint: string;
-    readonly detail: {
-        readonly guid: string;
-        readonly target: string;
-        readonly expectedKind: BuiltinAssetKind;
-        readonly actualKind: string;
-        readonly field: string;
-    };
-} | {
-    readonly code: 'scene-reference-cycle';
-    readonly expected: string;
-    readonly hint: string;
-    readonly detail: {
-        readonly cycle: readonly string[];
-    };
-} | {
-    readonly code: 'scene-reference-unresolved';
-    readonly expected: string;
-    readonly hint: string;
-    readonly detail: {
-        readonly source: string;
-    };
-};
-/** Loader seam supplied by the current App-owned AssetRegistry. */
-export type SceneAssetReferenceLoader<E = unknown> = (guid: string, kind: BuiltinAssetKind) => Promise<Result<unknown, E>>;
-type ProjectError<E> = E | SceneAssetProjectionError;
-/**
- * Convert decoded GUID fields and nested SceneAsset mounts into references
- * owned by one World. The AssetRegistry remains a loader; this World-facing
- * projection belongs to Scene and is intentionally explicit at each consumer.
- */
-export declare function projectSceneAsset<E = unknown>(world: World, asset: SceneAsset, load: SceneAssetReferenceLoader<E>): Promise<Result<SceneAsset, ProjectError<E>>>;
-export {};
-//# sourceMappingURL=scene-projection.d.ts.map

package/dist/assets/scene-projection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scene-projection.d.ts","sourceRoot":"","sources":["../../src/assets/scene-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,OAAO,EACL,KAAK,gBAAgB,EAOrB,KAAK,MAAM,EACX,KAAK,UAAU,EAGf,KAAK,SAAS,EAEf,MAAM,uBAAuB,CAAC;AAI/B,0EAA0E;AAC1E,eAAO,MAAM,sCAAsC,2BAA2B,CAAC;AAE/E,qEAAqE;AACrE,eAAO,MAAM,8CAA8C,kCAAkC,CAAC;AAE9F;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED,0EAA0E;AAC1E,MAAM,MAAM,yBAAyB,GACjC;IACE,QAAQ,CAAC,IAAI,EAAE,oCAAoC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7F,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;QACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CACxD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,CAAC;AAEN,mEAAmE;AACnE,MAAM,MAAM,yBAAyB,CAAC,CAAC,GAAG,OAAO,IAAI,CACnD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,KACnB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAqBjC,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC;AAigBrD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACjD,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAiB9C"}

package/src/assets/instantiate-scene.ts

@@ -1,14 +0,0 @@
-import type { EntityHandle, World } from '@forgeax/engine-ecs';
-import type { Handle, SceneAsset } from '@forgeax/engine-types';
-import { worldInstantiateScene } from '../instances/scene-instances';
-
-/** Scene-owned entry point for materialising a validated SceneAsset in a World. */
-export function instantiateScene(
-  world: World,
-  handle: Handle<'SceneAsset', 'shared'>,
-  parent?: EntityHandle,
-): ReturnType<typeof worldInstantiateScene> {
-  return worldInstantiateScene(world, handle, parent);
-}
-
-export type SceneInstanceAsset = SceneAsset;

package/src/assets/publication-observer.ts

@@ -1,24 +0,0 @@
-import { type AssetPublicationTuple, err, ok, type Result } from '@forgeax/engine-types';
-
-export interface ScenePublicationObservation {
-  readonly guid: string;
-  readonly generation: number;
-  readonly digest: string;
-}
-
-/** Read-only projection of a published scene envelope for consumers. */
-export function observeScenePublication(
-  envelope: AssetPublicationTuple,
-): Result<
-  ScenePublicationObservation,
-  { readonly code: 'scene-publication-invalid'; readonly expected: string; readonly hint: string }
-> {
-  if (!Number.isSafeInteger(envelope.generation) || envelope.generation < 1) {
-    return err({
-      code: 'scene-publication-invalid',
-      expected: 'a positive publication generation',
-      hint: 'publish the scene envelope with a monotonic generation',
-    });
-  }
-  return ok({ guid: envelope.scopeId, generation: envelope.generation, digest: envelope.digest });
-}