@forgeax/engine-scene 0.1.7 → 0.1.20

package/dist/index.mjs

@@ -1,182 +1,8 @@
-// ../types/dist/index.mjs
-var OK_PROTO = {
-  unwrap() {
-    return this.value;
-  },
-  unwrapOr(_defaultValue) {
-    return this.value;
-  }
-};
-var ERR_PROTO = {
-  unwrap() {
-    throw this.error;
-  },
-  unwrapOr(defaultValue) {
-    return defaultValue;
-  }
-};
-function ok(value) {
-  const r = Object.create(OK_PROTO);
-  r.ok = true;
-  r.value = value;
-  return r;
-}
-function err(error) {
-  const r = Object.create(ERR_PROTO);
-  r.ok = false;
-  r.error = error;
-  return r;
-}
-function toUnique(raw) {
-  return raw;
-}
-function unwrapHandle(h) {
-  return h;
-}
-var MAX_SLOT = (1 << 24) - 1;
-var MATERIAL_ERROR_CODES = [
-  "material-parent-not-found",
-  "material-circular-inheritance",
-  "material-no-effective-pass",
-  "material-value-unknown",
-  "material-value-type-mismatch",
-  "material-contract-program-mismatch",
-  "shader-module-id-missing",
-  "shader-module-id-duplicate",
-  "shader-module-not-found",
-  "shader-module-namespace-reserved",
-  "material-reflection-binding-mismatch",
-  "material-specialization-not-cooked",
-  "material-specialization-stale-generation",
-  "gltf-material-uv-set-missing",
-  "material-derived-interface-mismatch",
-  "material-texture-coordinate-invalid",
-  "material-payload-bounds"
-];
-var MATERIAL_ERROR_POLICY = {
-  "material-parent-not-found": {
-    expected: "every parent GUID resolves to a MaterialAsset",
-    hint: "fix the parent GUID and resolve the material again"
-  },
-  "material-circular-inheritance": {
-    expected: "the parent chain is acyclic",
-    hint: "remove the repeated GUID from the parent chain"
-  },
-  "material-no-effective-pass": {
-    expected: "the resolved material has at least one pass",
-    hint: "add a pass to the root material or an inherited parent"
-  },
-  "material-value-unknown": {
-    expected: "every value name is declared by the effective contract",
-    hint: "remove the value or declare the parameter in the root contract"
-  },
-  "material-value-type-mismatch": {
-    expected: "each value matches its declared parameter type",
-    hint: "change the value to the declared parameter type"
-  },
-  "material-contract-program-mismatch": {
-    expected: "the program satisfies the material contract",
-    hint: "align the program entries with the root contract"
-  },
-  "shader-module-id-missing": {
-    expected: "each WGSL source declares a module ID",
-    hint: "add a compiler-native module ID declaration to the WGSL source"
-  },
-  "shader-module-id-duplicate": {
-    expected: "each module ID has one source provenance",
-    hint: "rename one module or remove the duplicate source"
-  },
-  "shader-module-not-found": {
-    expected: "every referenced module exists in the source catalog",
-    hint: "add the module to the source catalog or fix the reference"
-  },
-  "shader-module-namespace-reserved": {
-    expected: "user modules use a non-reserved namespace",
-    hint: "choose a module ID outside the reserved namespace"
-  },
-  "material-reflection-binding-mismatch": {
-    expected: "reflection matches the material contract bindings",
-    hint: "update the contract or WGSL binding and cook again"
-  },
-  "material-specialization-not-cooked": {
-    expected: "the requested specialization has a cooked artifact",
-    hint: "run the build or development cook path for this selection"
-  },
-  "material-specialization-stale-generation": {
-    expected: "all specialization dependencies share one generation",
-    hint: "retry after dependent assets and sources settle"
-  },
-  "gltf-material-uv-set-missing": {
-    expected: "each texture slot references an available primitive UV set",
-    hint: "add the requested UV set to the primitive and re-import it"
-  },
-  "material-derived-interface-mismatch": {
-    expected: "the generated material interface matches the derived schema interface",
-    hint: "repair the schema or WGSL producer and recook the material"
-  },
-  "material-texture-coordinate-invalid": {
-    expected: "every texture coordinate record is finite and complete",
-    hint: "repair the texture metadata or coordinates and recook the material"
-  },
-  "material-payload-bounds": {
-    expected: "every material payload write stays within the derived payload",
-    hint: "repair the derived payload owner before submitting the draw"
-  }
-};
-var MATERIAL_ERROR_EXPECTED = Object.fromEntries(
-  MATERIAL_ERROR_CODES.map((code) => [code, MATERIAL_ERROR_POLICY[code].expected])
-);
-var MATERIAL_ERROR_HINTS = Object.fromEntries(
-  MATERIAL_ERROR_CODES.map((code) => [code, MATERIAL_ERROR_POLICY[code].hint])
-);
-var NUMERIC_TYPES = /* @__PURE__ */ new Set([
-  "f32",
-  "i32",
-  "u32",
-  "vec2",
-  "vec3",
-  "vec4",
-  "color"
-]);
-var TEXTURE_VIEW_TYPES = /* @__PURE__ */ new Set([
-  "texture2d",
-  "texture_cube",
-  "texture_depth_2d",
-  "texture_cube_array"
-]);
-var SAMPLER_TYPES = /* @__PURE__ */ new Set([
-  "sampler",
-  "sampler_comparison"
-]);
-var ALL_TYPES = /* @__PURE__ */ new Set([
-  ...NUMERIC_TYPES,
-  ...TEXTURE_VIEW_TYPES,
-  ...SAMPLER_TYPES,
-  "storage_buffer"
-]);
-var PACK_ERROR_HINTS = {
-  "pack-malformed-meta": "check guid is a valid RFC 4122 UUID; validate with: ajv validate -s schema/meta.schema.json -d <file>",
-  "pack-malformed-pack": "check all asset guid and refs[] fields are 36-char dash-form UUIDs; validate with pack.schema.json",
-  "pack-guid-malformed": "use AssetGuid.random() or a UUIDv7 generator; all GUID fields must be 36-char RFC 4122 dash-form",
-  "pack-orphan-meta": "remove the orphan .meta.json or add the missing source file next to it",
-  "pack-meta-missing": "run forgeax-engine-remote-asset scan --roots <dir> to list source files without .meta.json",
-  "pack-guid-collision": "run forgeax-engine-remote-asset verify to list all GUID collisions; each GUID must be globally unique",
-  "pack-cyclic-reference": "run forgeax-engine-remote-asset verify to print the cycle path; break the cycle by removing a refs[] entry",
-  "pack-subasset-index-out-of-range": "check subAssets[].sourceIndex does not exceed the actual sub-image count in the source file",
-  // === 1 new hint (feat-20260523-shader-template-instance-split M1-T02) ===
-  "payload-schema-mismatch": "material asset payload failed schema validation; check paramSchema entries all use valid types from MATERIAL_PARAM_TYPES and materialShader is a non-empty string",
-  // === 4 new hints (feat-20260608-scene-nesting-ecs-fication M1 / w8;
-  // plan-strategy D-8) ===
-  "pack-mount-localid-overlap": "check parent SceneAsset.mounts[].memberFirst windows do not overlap with each other or with entities[].localId; rebuild mount sidecar after the child SceneAsset reimport",
-  "pack-mount-count-mismatch": "mount.memberCount must equal the referenced child SceneAsset totalSlots (entities.length + sum(mounts[].memberCount) + mounts.length); rebuild mount sidecar via forgeax-engine-remote-asset verify <dir> after the child SceneAsset reimport",
-  "pack-mount-override-localid-out-of-range": "override.localId must be in [0, mount.memberCount); shrink the override or extend memberCount to match the child SceneAsset",
-  "pack-mount-override-unknown-field": "override.comp / override.field must match a defined component schema; check defineComponent registry or rebuild mount sidecar after the child SceneAsset reimport",
-  // === 2 new hints (feat-20260625-asset-meta-source-mount-prefix M1 / w1) ===
-  "pack-unknown-path": "the @name in source is not declared in package.json#forgeax.assets.paths; add it there or use a known name from the list in error.detail.knownNames",
-  "pack-malformed-path-ref": "source must be @<name>/<rest> where name is a key in package.json#forgeax.assets.paths; the resolved path must not escape the declared directory"
-};
-
 // src/assets/scene-decoder.ts
+import {
+  err,
+  ok
+} from "@forgeax/engine-types";
 var sceneAssetKind = {
   kind: "scene"
 };
@@ -356,6 +182,7 @@ var SCENE_COLLECT_PROFILE = Object.freeze({
 });
 
 // src/instances/externalization.ts
+import { err as err2, ok as ok2 } from "@forgeax/engine-types";
 function sharedKind(type) {
   if (type?.startsWith("shared<")) return "one";
   if (type?.startsWith("array<shared<")) return "many";
@@ -433,10 +260,10 @@ function externalizeSceneAsset(scene, resolveSchema) {
     };
   });
   for (const [arrayIndex, guid] of (scene.skinGuids ?? []).entries()) {
-    if (typeof guid !== "string") return err({ field: "skinGuids", value: guid });
+    if (typeof guid !== "string") return err2({ field: "skinGuids", value: guid });
     addRef(guid, { componentName: "<scene>", fieldName: "skinGuids", arrayIndex });
   }
-  return ok({
+  return ok2({
     payload: {
       entities,
       ...mounts === void 0 || mounts.length === 0 ? {} : { mounts },
@@ -453,6 +280,13 @@ import {
 import { classifyEntityField, remapEntityFieldValue } from "@forgeax/engine-ecs/externalization";
 import { componentSchema } from "@forgeax/engine-ecs/internal";
 import { fillComponentDefaults, StaleEntityError } from "@forgeax/engine-ecs/projection";
+import {
+  err as err3,
+  ok as ok3,
+  PACK_ERROR_HINTS,
+  toUnique,
+  unwrapHandle
+} from "@forgeax/engine-types";
 var entityIndex = (entity) => entity & 16777215;
 var entityGeneration = (entity) => entity >>> 24 & 255;
 var sceneWorldStates = /* @__PURE__ */ new WeakMap();
@@ -474,7 +308,7 @@ function worldInstantiateScene(world, handle, parent) {
   const diagnostics = [];
   const r = worldInstantiateSceneRec(world, handle, parent, stack, diagnostics);
   if (!r.ok) return r;
-  return ok({ root: r.value, diagnostics });
+  return ok3({ root: r.value, diagnostics });
 }
 function worldInstantiateScenePayload(world, asset, parent) {
   const handle = world.allocSharedRef("SceneAsset", asset);
@@ -498,7 +332,7 @@ function worldInstantiateSceneFlat(world, handle) {
     stack.delete(handleKey);
   }
   if (!r.ok) return r;
-  return ok({ ...r.value, diagnostics });
+  return ok3({ ...r.value, diagnostics });
 }
 function worldInstantiateSceneRec(world, handle, parent, stack, diagnostics) {
   const handleKey = unwrapHandle(handle);
@@ -511,7 +345,7 @@ function worldInstantiateSceneRec(world, handle, parent, stack, diagnostics) {
       kind: "mount-asset",
       cycle: cycleArr
     };
-    return err({
+    return err3({
       code: "pack-cyclic-reference",
       expected: "acyclic SceneAsset mount graph",
       hint: PACK_ERROR_HINTS["pack-cyclic-reference"],
@@ -531,14 +365,14 @@ function worldInstantiateSceneRec(world, handle, parent, stack, diagnostics) {
 function worldResolveSceneAsset(world, handle) {
   const r = world.sharedRefs.resolve(handle);
   if (!r.ok) {
-    return err(r.error);
+    return err3(r.error);
   }
-  return ok(r.value);
+  return ok3(r.value);
 }
 function worldSpawnSceneMembers(world, handle, asset, stack, diagnostics) {
   const sceneInstanceToken = world.components.resolve("SceneInstance");
   if (sceneInstanceToken === void 0) {
-    return err(new ComponentNotDefinedError("SceneInstance"));
+    return err3(new ComponentNotDefinedError("SceneInstance"));
   }
   const childOfToken = world.components.resolve("ChildOf");
   const ownEntities = asset.entities;
@@ -583,7 +417,7 @@ function worldSpawnSceneMembers(world, handle, asset, stack, diagnostics) {
     }
     if (overlapLids.size > 0) {
       const overlapping = Array.from(overlapLids).sort((a, b) => a - b);
-      return err({
+      return err3({
         code: "pack-mount-localid-overlap",
         expected: "each LocalEntityId claimed by exactly one entity or mount slot",
         hint: PACK_ERROR_HINTS["pack-mount-localid-overlap"],
@@ -623,7 +457,7 @@ function worldSpawnSceneMembers(world, handle, asset, stack, diagnostics) {
     const childMapping = childInstRes.value.mapping;
     mountInstances.push({ mount, root: childRes.value, mapping: childMapping });
     if (childMapping.length !== mount.memberCount) {
-      return err({
+      return err3({
         code: "pack-mount-count-mismatch",
         expected: "mount.memberCount === child SceneAsset totalSlots",
         hint: PACK_ERROR_HINTS["pack-mount-count-mismatch"],
@@ -694,7 +528,7 @@ function worldSpawnSceneMembers(world, handle, asset, stack, diagnostics) {
       }
     }
   }
-  return ok({
+  return ok3({
     mapping,
     entityToLocalId,
     rootEntities,
@@ -707,7 +541,7 @@ function worldSpawnSceneMembers(world, handle, asset, stack, diagnostics) {
 function worldInstantiateSceneAsset(world, handle, asset, parent, stack, diagnostics) {
   const sceneInstanceToken = world.components.resolve("SceneInstance");
   if (sceneInstanceToken === void 0) {
-    return err(new ComponentNotDefinedError("SceneInstance"));
+    return err3(new ComponentNotDefinedError("SceneInstance"));
   }
   const childOfToken = world.components.resolve("ChildOf");
   const membersRes = worldSpawnSceneMembers(world, handle, asset, stack, diagnostics);
@@ -807,7 +641,7 @@ function worldInstantiateSceneAsset(world, handle, asset, parent, stack, diagnos
       if (!r.ok) return r;
     }
   }
-  return ok(rootEntity);
+  return ok3(rootEntity);
 }
 function worldInstantiateSceneAssetFlat(world, handle, asset, stack, diagnostics) {
   const membersRes = worldSpawnSceneMembers(world, handle, asset, stack, diagnostics);
@@ -846,7 +680,7 @@ function worldInstantiateSceneAssetFlat(world, handle, asset, stack, diagnostics
       }
     }
   }
-  return ok({ roots: [...rootEntities, ...mountEntitiesNeedingRootParent], mountEntities });
+  return ok3({ roots: [...rootEntities, ...mountEntitiesNeedingRootParent], mountEntities });
 }
 function worldBuildSceneEntityComponentDatas(world, node, mapping, diagnostics) {
   const out = [];
@@ -854,7 +688,7 @@ function worldBuildSceneEntityComponentDatas(world, node, mapping, diagnostics)
   for (const compName of Object.keys(node.components)) {
     const token = world.components.resolve(compName);
     if (token === void 0) {
-      return err(new ComponentNotDefinedError(compName));
+      return err3(new ComponentNotDefinedError(compName));
     }
     const raw = node.components[compName] ?? {};
     const schema = componentSchema(token);
@@ -881,11 +715,11 @@ function worldBuildSceneEntityComponentDatas(world, node, mapping, diagnostics)
     const filled = fillComponentDefaults(token, remappedRaw);
     out.push({ component: token, data: filled });
   }
-  return ok(out);
+  return ok3(out);
 }
 function worldApplyMountOverride(world, member, ov) {
   const ovToken = world.components.resolve(ov.comp);
-  if (ovToken === void 0) return ok(void 0);
+  if (ovToken === void 0) return ok3(void 0);
   if (ov.field !== void 0) {
     return world.set(member, ovToken, { [ov.field]: ov.value });
   }
@@ -899,7 +733,7 @@ function worldApplyMountOverride(world, member, ov) {
 }
 function worldValidateMountOverrides(world, mount) {
   const overrides = mount.overrides;
-  if (overrides === void 0) return ok(void 0);
+  if (overrides === void 0) return ok3(void 0);
   const memberFirst = mount.memberFirst;
   const memberCount = mount.memberCount;
   const memberLast = memberFirst + memberCount;
@@ -907,7 +741,7 @@ function worldValidateMountOverrides(world, mount) {
   for (const ov of overrides) {
     const ovLid = ov.localId;
     if (ovLid < memberFirst || ovLid >= memberLast) {
-      return err({
+      return err3({
         code: "pack-mount-override-localid-out-of-range",
         expected: `override.localId in [${memberFirst}, ${memberLast})`,
         hint: PACK_ERROR_HINTS["pack-mount-override-localid-out-of-range"],
@@ -924,7 +758,7 @@ function worldValidateMountOverrides(world, mount) {
       if (ovToken !== void 0) {
         const schema = componentSchema(ovToken);
         if (!(ov.field in schema)) {
-          return err({
+          return err3({
             code: "pack-mount-override-unknown-field",
             expected: `override.field defined on component '${ov.comp}'`,
             hint: PACK_ERROR_HINTS["pack-mount-override-unknown-field"],
@@ -939,13 +773,13 @@ function worldValidateMountOverrides(world, mount) {
       }
     } else {
       if (ovToken === void 0) {
-        return err(new ComponentNotDefinedError(ov.comp));
+        return err3(new ComponentNotDefinedError(ov.comp));
       }
       const schema = componentSchema(ovToken);
       const valueMap = ov.value ?? {};
       for (const key of Object.keys(valueMap)) {
         if (!(key in schema)) {
-          return err({
+          return err3({
             code: "pack-mount-override-unknown-field",
             expected: `override.value keys defined on component '${ov.comp}'`,
             hint: PACK_ERROR_HINTS["pack-mount-override-unknown-field"],
@@ -960,7 +794,7 @@ function worldValidateMountOverrides(world, mount) {
       }
     }
   }
-  return ok(void 0);
+  return ok3(void 0);
 }
 function worldSpawnMountEntity(world, mount, mapping, diagnostics) {
   const fakeNode = {
@@ -979,7 +813,7 @@ function worldSpawnMountEntity(world, mount, mapping, diagnostics) {
   if (cdRes.value.length === 0) {
     const childOfToken = world.components.resolve("ChildOf");
     if (childOfToken === void 0) {
-      return err(new ComponentNotDefinedError("ChildOf"));
+      return err3(new ComponentNotDefinedError("ChildOf"));
     }
     cdRes.value.push({
       component: childOfToken,
@@ -991,7 +825,7 @@ function worldSpawnMountEntity(world, mount, mapping, diagnostics) {
 function worldResolveMountSource(world, source, parentHandle) {
   const resolver = worldGetSceneAssetResolver(world);
   if (resolver === null) {
-    return err({
+    return err3({
       code: "stale-entity",
       expected: "wired SceneAssetResolver (auto-wired by engine.assets.instantiate)",
       hint: "engine.assets.instantiate sugar wires this for you; call worldSetSceneAssetResolver before nested scene expansion.",
@@ -1000,9 +834,9 @@ function worldResolveMountSource(world, source, parentHandle) {
   }
   const r = resolver(source, parentHandle);
   if (!r.ok) {
-    return err(r.error);
+    return err3(r.error);
   }
-  return ok(r.value);
+  return ok3(r.value);
 }
 function worldMountOverridesToStateMap(src) {
   const out = /* @__PURE__ */ new Map();
@@ -1025,7 +859,7 @@ function worldSetUniqueRefPayload(world, handle, payload) {
 function worldResolveSceneInstanceStatePayload(world, root) {
   const sceneInstanceToken = world.components.resolve("SceneInstance");
   if (sceneInstanceToken === void 0) {
-    return err(new ComponentNotDefinedError("SceneInstance"));
+    return err3(new ComponentNotDefinedError("SceneInstance"));
   }
   const r = world.get(root, sceneInstanceToken);
   if (!r.ok) return r;
@@ -1033,7 +867,7 @@ function worldResolveSceneInstanceStatePayload(world, root) {
   const stateRefHandle = toUnique(stateRefRaw);
   const payload = sceneWorldState(world).statePayloads.get(Number(stateRefHandle));
   if (payload === void 0) {
-    return err(
+    return err3(
       new StaleEntityError(root, entityIndex(root), entityGeneration(root), {
         operation: "resolveSceneInstanceState",
         component: "SceneInstance",
@@ -1042,7 +876,7 @@ function worldResolveSceneInstanceStatePayload(world, root) {
       })
     );
   }
-  return ok(payload);
+  return ok3(payload);
 }
 function worldGetSceneInstanceState(world, root) {
   return worldResolveSceneInstanceStatePayload(world, root);
@@ -1052,7 +886,7 @@ function worldDespawnScene(world, root, opts) {
   if (!dRes.ok) return dRes;
   const drop = world.despawn(root);
   if (!drop.ok) return drop;
-  return ok(dRes.value + 1);
+  return ok3(dRes.value + 1);
 }
 function worldDespawnDescendants(world, root, opts) {
   let detached = null;
@@ -1129,7 +963,7 @@ function worldDespawnDescendants(world, root, opts) {
     }
     count += 1;
   }
-  return ok(count);
+  return ok3(count);
 }
 function worldSetSceneOverride(world, root, member, component, field, value) {
   const stateRes = worldResolveSceneInstanceStatePayload(world, root);
@@ -1137,7 +971,7 @@ function worldSetSceneOverride(world, root, member, component, field, value) {
   const state = stateRes.value;
   const lid = state.entityToLocalId.get(member);
   if (lid === void 0) {
-    return err(
+    return err3(
       new StaleEntityError(
         member,
         entityIndex(member),
@@ -1156,7 +990,7 @@ function worldSetSceneOverride(world, root, member, component, field, value) {
     const expectJsType = primitiveJsType(schemaType);
     const actualJsType = typeof value;
     if (expectJsType !== actualJsType) {
-      return err({
+      return err3({
         code: "scene-override-type-mismatch",
         expected: `value typeof === ${expectJsType}`,
         hint: `setSceneOverride(${component.name}.${field}) expected ${expectJsType}, got ${actualJsType}; coerce or pick a different override path.`,
@@ -1182,14 +1016,14 @@ function worldSetSceneOverride(world, root, member, component, field, value) {
     field,
     value
   });
-  return ok(void 0);
+  return ok3(void 0);
 }
 function worldRemoveSceneOverride(world, root, member, component, field) {
   const stateRes = worldResolveSceneInstanceStatePayload(world, root);
   if (!stateRes.ok) return stateRes;
   const state = stateRes.value;
   const lid = state.entityToLocalId.get(member);
-  if (lid === void 0) return ok(void 0);
+  if (lid === void 0) return ok3(void 0);
   const fieldMap = state.overrides.get(lid);
   if (fieldMap !== void 0) {
     fieldMap.delete(`${component.name}:${field}`);
@@ -1205,34 +1039,34 @@ function worldRemoveSceneOverride(world, root, member, component, field) {
     const r = world.set(member, component, { [field]: layer1[field] });
     if (!r.ok) return r;
   }
-  return ok(void 0);
+  return ok3(void 0);
 }
 function worldDetachSceneMember(world, root, member) {
   const sceneInstanceToken = world.components.resolve("SceneInstance");
   if (sceneInstanceToken === void 0) {
-    return err(new ComponentNotDefinedError("SceneInstance"));
+    return err3(new ComponentNotDefinedError("SceneInstance"));
   }
   const stateRes = worldResolveSceneInstanceStatePayload(world, root);
   if (!stateRes.ok) return stateRes;
   const state = stateRes.value;
   const lid = state.entityToLocalId.get(member);
-  if (lid === void 0) return ok(void 0);
+  if (lid === void 0) return ok3(void 0);
   state.detachedLocalIds.add(lid);
-  return ok(void 0);
+  return ok3(void 0);
 }
 function worldReattachSceneMember(world, root, member) {
   const stateRes = worldResolveSceneInstanceStatePayload(world, root);
   if (!stateRes.ok) return stateRes;
   const state = stateRes.value;
   const lid = state.entityToLocalId.get(member);
-  if (lid === void 0) return ok(void 0);
+  if (lid === void 0) return ok3(void 0);
   state.detachedLocalIds.delete(lid);
-  return ok(void 0);
+  return ok3(void 0);
 }
 function worldGetSceneAssetForInstance(world, root) {
   const stateRes = worldResolveSceneInstanceStatePayload(world, root);
   if (!stateRes.ok) return stateRes;
-  return ok(stateRes.value.source);
+  return ok3(stateRes.value.source);
 }
 function sceneTopoSort(nodes) {
   const n = nodes.length;
@@ -1303,6 +1137,7 @@ import {
   setDerivedComponent
 } from "@forgeax/engine-ecs/projection";
 import { mat4 } from "@forgeax/engine-math";
+import { err as err4, ok as ok4 } from "@forgeax/engine-types";
 
 // src/systems/hierarchy-projection.ts
 import { Entity } from "@forgeax/engine-ecs";
@@ -1450,8 +1285,8 @@ function descendants(childrenOf, roots) {
 }
 function hierarchyError(hierarchy) {
   const first = hierarchy.diagnostics[0];
-  if (first === void 0) return ok(void 0);
-  return err(
+  if (first === void 0) return ok4(void 0);
+  return err4(
     new SceneError({
       code: first.code,
       expected: first.expected,
@@ -1481,17 +1316,17 @@ function buildCache(world, projection) {
     entities,
     locals,
     derived: /* @__PURE__ */ new Map(),
-    result: ok(void 0)
+    result: ok4(void 0)
   };
 }
 function deriveEntity(world, entity, cache, affected, visiting, published) {
-  if (!affected.has(entity) || cache.derived.has(entity)) return ok(void 0);
-  if (visiting.has(entity)) return ok(void 0);
+  if (!affected.has(entity) || cache.derived.has(entity)) return ok4(void 0);
+  if (visiting.has(entity)) return ok4(void 0);
   visiting.add(entity);
   const local = cache.locals.get(entity);
   if (local === void 0) {
     visiting.delete(entity);
-    return ok(void 0);
+    return ok4(void 0);
   }
   const parent = cache.parentOf.get(entity);
   if (parent !== void 0 && cache.entities.has(parent)) {
@@ -1507,7 +1342,7 @@ function deriveEntity(world, entity, cache, affected, visiting, published) {
   const write = setDerivedComponent(world, entity, Transform, { world: resolved });
   if (!write.ok) {
     visiting.delete(entity);
-    return err(
+    return err4(
       new SceneError({
         code: "hierarchy-broken",
         expected: "the derived Transform.world write to succeed",
@@ -1519,7 +1354,7 @@ function deriveEntity(world, entity, cache, affected, visiting, published) {
   cache.derived.set(entity, resolved);
   published.add(entity);
   visiting.delete(entity);
-  return ok(void 0);
+  return ok4(void 0);
 }
 function drainPublishedChanges(cache, published) {
   const drained = cache.projection.poll();