@forgeax/engine-ecs 0.1.26 → 0.1.28

package/dist/internal.d.ts

@@ -1,6 +1,5 @@
-export * from './component';
-export type { WorldInternal } from './world-internal';
-export { worldInternal } from './world-internal';
+export { componentId, componentSchema } from './component';
+export { componentDefinition } from './component-schema';
 import type { Result } from '@forgeax/engine-types';
 import type { Component } from './component';
 import type { QuerySpanUnavailableError } from './errors';

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AASA,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,yEAAyE;AACzE,eAAO,MAAM,cAAc,EAAE,OAAO,MAEC,CAAC;AAYtC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,SAAS,SAAS,EAAE,EAC9B,CAAC,SAAS,SAAS,SAAS,EAAE,EAC9B,CAAC,SAAS,SAAS,SAAS,EAAE,EAC9B,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAEnB,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACrB,SAAS,EAAE,CAAC,GACX,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAGrE;AAED,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,yEAAyE;AACzE,eAAO,MAAM,cAAc,EAAE,OAAO,MAEC,CAAC;AAYtC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,SAAS,SAAS,EAAE,EAC9B,CAAC,SAAS,SAAS,SAAS,EAAE,EAC9B,CAAC,SAAS,SAAS,SAAS,EAAE,EAC9B,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAEnB,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACrB,SAAS,EAAE,CAAC,GACX,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAGrE;AAED,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC"}

package/dist/internal.mjs

@@ -1,4 +1,4 @@
-import { err, ok } from '@forgeax/engine-types';
+import '@forgeax/engine-types';
 
 // src/component.ts
 
@@ -10,9 +10,6 @@ var definitions = globalSymbols[COMPONENT_REGISTRY] ?? (() => {
   globalSymbols[COMPONENT_REGISTRY] = registry;
   return registry;
 })();
-function registerComponentDefinition(component, definition) {
-  definitions.definitions.set(component, definition);
-}
 function componentDefinition(component) {
   const definition = definitions.definitions.get(component);
   if (definition === void 0) {
@@ -20,93 +17,6 @@ function componentDefinition(component) {
   }
   return definition;
 }
-function deepFreeze(value) {
-  if (value === null || typeof value !== "object" && typeof value !== "function") {
-    return value;
-  }
-  if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer) {
-    return value;
-  }
-  const object = value;
-  for (const key of Reflect.ownKeys(object)) {
-    const child = object[key];
-    if (child !== null && (typeof child === "object" || typeof child === "function")) {
-      deepFreeze(child);
-    }
-  }
-  return Object.freeze(value);
-}
-function assertComponentStorage(value) {
-  if (value !== "table" && value !== "sparse") {
-    throw new Error(`Unsupported component storage '${value}'. Expected 'table' or 'sparse'.`);
-  }
-}
-
-// src/world-internal.ts
-var worldInternal = /* @__PURE__ */ Symbol.for(
-  "forgeax.ecs.worldInternal"
-);
-
-// src/errors.ts
-var SchemaUnsupportedFieldError = class extends Error {
-  name = "SchemaUnsupportedFieldError";
-  code = "schema-unsupported-field";
-  hint;
-  constructor(fieldName, fieldType) {
-    let hint = "Supported types: f32 / f64 / i32 / u32 / i16 / u16 / i8 / u8 / bool / enum / ref.";
-    if (fieldType.startsWith("handle<") && fieldType.endsWith(">")) {
-      const tag = fieldType.slice(7, -1);
-      hint = `'handle<${tag}>' was removed in feat-20260614 M5; use 'shared<${tag}>' instead. The brand and storage layout are unchanged; only the keyword + write-barrier dispatch (SharedRefStore retain/release) is new.`;
-    } else if (fieldType.startsWith("ref<") && fieldType.endsWith(">")) {
-      const tag = fieldType.slice(4, -1);
-      hint = `'ref<${tag}>' was renamed in feat-20260614 M1; use 'unique<${tag}>' instead. The brand and storage layout are unchanged; the dispatch still routes through UniqueRefStore (single-holder direct release).`;
-    }
-    super(
-      `Schema field "${fieldName}" has unsupported type "${fieldType}".
-  field: ${fieldName}
-  type: ${fieldType}
-  hint: ${hint}`
-    );
-    this.hint = hint;
-  }
-};
-var SparseStorageRequiresTagError = class extends Error {
-  name = "SparseStorageRequiresTagError";
-  code = "sparse-storage-requires-tag";
-  expected = "sparse components have an empty schema and no relationship metadata";
-  hint = "remove all fields and relationship metadata, or use storage: table";
-  detail;
-  constructor(componentName) {
-    super(
-      `Sparse component "${componentName}" must be a zero-field, non-relationship tag.
-  component: ${componentName}
-  hint: remove all fields and relationship metadata, or use storage: table`
-    );
-    this.detail = { componentName };
-  }
-};
-var ManagedArrayElementTypeNotAllowedError = class extends Error {
-  name = "ManagedArrayElementTypeNotAllowedError";
-  code = "managed-array-element-type-not-allowed";
-  hint;
-  expected;
-  detail;
-  constructor(fieldName, elementType) {
-    const hint = `array<T> element type must be a scalar (f32/f64/i32/u32/i16/u16/i8/u8/bool/enum/ref) or entity. ref<X> / handle<X> / buffer:N / nested array<...> are forbidden on field "${fieldName}".`;
-    const expected = "element type in {scalar | entity}";
-    super(
-      `managed-array: element type not allowed.
-  code: managed-array-element-type-not-allowed
-  field: ${fieldName}
-  elementType: ${elementType}
-  expected: ${expected}
-  hint: ${hint}`
-    );
-    this.hint = hint;
-    this.expected = expected;
-    this.detail = { fieldName, elementType, hint };
-  }
-};
 
 // src/component.ts
 var FIELD_SIZE_BYTES = {
@@ -122,88 +32,6 @@ var FIELD_SIZE_BYTES = {
   enum: 4,
   ref: 4
 };
-function fieldTypeToMetaKey(fieldType) {
-  if (fieldType === "entity" || fieldType === "string" || fieldType === "buffer") {
-    return fieldType;
-  }
-  if (fieldType.startsWith("unique<") && fieldType.endsWith(">")) return "ref";
-  if (fieldType.startsWith("shared<") && fieldType.endsWith(">")) return "shared";
-  if (fieldType.startsWith("buffer<") && fieldType.endsWith(">")) return "buffer";
-  if (fieldType.startsWith("array<") && fieldType.endsWith(">")) return "array";
-  if (TYPE_METADATA[fieldType] !== void 0) return fieldType;
-  return null;
-}
-function isManagedField(fieldType) {
-  return TYPE_METADATA[fieldTypeToMetaKey(fieldType) ?? ""]?.isManaged ?? false;
-}
-function isManagedBufferField(fieldType) {
-  return TYPE_METADATA[fieldTypeToMetaKey(fieldType) ?? ""]?.isBuffer ?? false;
-}
-function isEntityField(fieldType) {
-  return TYPE_METADATA[fieldTypeToMetaKey(fieldType) ?? ""]?.isEntityRef ?? false;
-}
-function isManagedArrayField(fieldType) {
-  return TYPE_METADATA[fieldTypeToMetaKey(fieldType) ?? ""]?.isArray ?? false;
-}
-var MANAGED_ARRAY_ELEMENT_TYPES = /* @__PURE__ */ new Set([
-  "f32",
-  "f64",
-  "i32",
-  "u32",
-  "i16",
-  "u16",
-  "i8",
-  "u8",
-  "bool",
-  "enum",
-  "ref",
-  "entity"
-]);
-function isValidArrayElementType(elementType) {
-  if (MANAGED_ARRAY_ELEMENT_TYPES.has(elementType)) return true;
-  if (elementType.startsWith("shared<") && elementType.endsWith(">") && elementType.length > 9)
-    return true;
-  return false;
-}
-function parseManagedArraySchema(fieldType) {
-  if (!fieldType.startsWith("array<") || !fieldType.endsWith(">")) return null;
-  const inner = fieldType.slice(6, -1);
-  const commaIdx = inner.indexOf(",");
-  if (commaIdx === -1) {
-    if (!isValidArrayElementType(inner)) return null;
-    return { elementType: inner, length: void 0 };
-  }
-  const head = inner.slice(0, commaIdx).trim();
-  const tail = inner.slice(commaIdx + 1).trim();
-  if (!isValidArrayElementType(head)) return null;
-  if (!/^[1-9]\d*$/.test(tail)) return null;
-  return { elementType: head, length: Number.parseInt(tail, 10) };
-}
-function bufferFieldByteLength(fieldType) {
-  if (!fieldType.startsWith("buffer<") || !fieldType.endsWith(">")) return Number.NaN;
-  const tail = fieldType.slice(7, -1);
-  if (!/^[1-9]\d*$/.test(tail)) return Number.NaN;
-  return Number.parseInt(tail, 10);
-}
-function isSchemaVocabKeyword(s) {
-  if (s === "string") return true;
-  if (s === "entity") return true;
-  if (s === "buffer") return true;
-  if (s.startsWith("buffer<") && s.endsWith(">")) {
-    const tail = s.slice(7, -1);
-    return /^[1-9]\d*$/.test(tail);
-  }
-  if (s.startsWith("unique<") && s.endsWith(">")) {
-    return /^\w+$/.test(s.slice(7, -1));
-  }
-  if (s.startsWith("shared<") && s.endsWith(">")) {
-    return /^\w+$/.test(s.slice(7, -1));
-  }
-  if (s.startsWith("array<") && s.endsWith(">")) {
-    return parseManagedArraySchema(s) !== null;
-  }
-  return false;
-}
 var COMPONENT_OWNER_REGISTRY = /* @__PURE__ */ Symbol.for("forgeax.ecs.componentOwnerRegistry");
 var ownerSymbols = globalThis;
 var ownerRegistry = ownerSymbols[COMPONENT_OWNER_REGISTRY] ?? (() => {
@@ -215,11 +43,6 @@ var ownerRegistry = ownerSymbols[COMPONENT_OWNER_REGISTRY] ?? (() => {
   ownerSymbols[COMPONENT_OWNER_REGISTRY] = registry;
   return registry;
 })();
-var entityDefinitionSeen = false;
-var componentDefinedBeforeEntity = false;
-function isComponentDefinitionOrderValid() {
-  return !componentDefinedBeforeEntity;
-}
 function componentId(component) {
   const id = ownerRegistry.ids.get(component);
   if (id === void 0) throw new Error(`Component identity missing for '${component.name}'.`);
@@ -257,7 +80,7 @@ function scalarRow(t) {
     isArray: false
   };
 }
-var TYPE_METADATA = Object.freeze({
+Object.freeze({
   f32: scalarRow("f32"),
   f64: scalarRow("f64"),
   i32: scalarRow("i32"),
@@ -329,159 +152,6 @@ var TYPE_METADATA = Object.freeze({
     isArray: true
   }
 });
-function fieldSpecType(fieldName, spec) {
-  if (typeof spec === "string") return spec;
-  const t = spec.type;
-  if (typeof t !== "string") {
-    throw new SchemaUnsupportedFieldError(
-      fieldName,
-      `<field-descriptor missing 'type'> (expected { type, default?, meta? })`
-    );
-  }
-  return t;
-}
-function defineComponent(name, fields, options) {
-  const storage = options?.storage ?? "table";
-  assertComponentStorage(storage);
-  if (storage === "sparse" && Object.keys(fields).length !== 0) {
-    throw new SparseStorageRequiresTagError(name);
-  }
-  const schema = {};
-  const reflectedFields = {};
-  const collectedMeta = {};
-  const collectedDefaults = {};
-  for (const fieldName of Object.keys(fields)) {
-    const spec = fields[fieldName];
-    const fieldType = fieldSpecType(fieldName, spec);
-    let arrayMeta;
-    if (TYPE_METADATA[fieldType]?.isScalar === true) ; else if (fieldType === "string") ; else if (fieldType.startsWith("array<") && fieldType.endsWith(">")) {
-      const parsed = parseManagedArraySchema(fieldType);
-      if (parsed === null) {
-        const elementType = fieldType.slice(6, -1);
-        throw new ManagedArrayElementTypeNotAllowedError(fieldName, elementType);
-      }
-      arrayMeta = deepFreeze(
-        parsed.length === void 0 ? { elementType: parsed.elementType } : { elementType: parsed.elementType, length: parsed.length }
-      );
-    } else if (!isSchemaVocabKeyword(fieldType)) {
-      throw new SchemaUnsupportedFieldError(fieldName, fieldType);
-    }
-    schema[fieldName] = fieldType;
-    const row = {
-      type: fieldType
-    };
-    if (typeof spec !== "string") {
-      const desc = spec;
-      if ("default" in desc) {
-        row.default = desc.default;
-        collectedDefaults[fieldName] = desc.default;
-      }
-      if (desc.shape !== void 0) row.shape = desc.shape;
-      if (desc.meta !== void 0) {
-        Object.assign(collectedMeta, desc.meta);
-      }
-      if (desc.transient !== void 0) row.transient = desc.transient;
-      if (desc.labels !== void 0) row.labels = deepFreeze({ ...desc.labels });
-    }
-    if (arrayMeta !== void 0) row.arrayMeta = arrayMeta;
-    reflectedFields[fieldName] = Object.freeze(row);
-  }
-  if (name === "Entity") {
-    entityDefinitionSeen = true;
-  } else if (!entityDefinitionSeen) {
-    componentDefinedBeforeEntity = true;
-  }
-  const id = name === "Entity" ? 0 : ownerRegistry.nextId++;
-  const frozenDefaults = Object.keys(collectedDefaults).length === 0 ? void 0 : deepFreeze(collectedDefaults);
-  if (options?.meta !== void 0) {
-    Object.assign(collectedMeta, options.meta);
-  }
-  const frozenSchema = deepFreeze(schema);
-  const frozenFields = deepFreeze(reflectedFields);
-  const meta = collectedMeta;
-  const token = Object.freeze({ name, fields: frozenFields, storage });
-  ownerRegistry.ids.set(token, id);
-  ownerRegistry.schemas.set(token, frozenSchema);
-  registerComponentDefinition(token, {
-    fields: frozenFields,
-    defaults: frozenDefaults,
-    policy: {
-      transient: options?.transient ?? false,
-      meta,
-      requires: Object.freeze([...options?.requires ?? []])
-    }
-  });
-  return Object.freeze(token);
-}
-var ComponentInUseError = class extends Error {
-  name = "ComponentInUseError";
-  code = "component-in-use";
-  expected = "the component to have no live entity or scheduled-system references";
-  hint = "Remove owning systems and component values before disposing the registration lease.";
-  detail;
-  constructor(componentName) {
-    super(`Component ${componentName} is still in use.`);
-    this.detail = { componentName };
-  }
-};
-var ComponentNameConflictError = class extends Error {
-  name = "ComponentNameConflictError";
-  code = "component-name-conflict";
-  expected = "one component token per name in a World";
-  hint = "Use the token already registered in this World or choose a distinct component name.";
-  detail;
-  constructor(componentName) {
-    super(`Component ${componentName} is already registered with a different token.`);
-    this.detail = { componentName };
-  }
-};
-var ComponentCatalog = class {
-  constructor(inUse) {
-    this.inUse = inUse;
-  }
-  inUse;
-  registrations = /* @__PURE__ */ new Map();
-  register(component) {
-    const current = this.registrations.get(component.name);
-    if (current !== void 0 && current.component !== component) {
-      return err(new ComponentNameConflictError(component.name));
-    }
-    if (current === void 0) {
-      this.registrations.set(component.name, { component, owners: 1 });
-    } else {
-      current.owners += 1;
-    }
-    let active = true;
-    return ok({
-      component,
-      dispose: () => {
-        if (!active) return ok(void 0);
-        const registration = this.registrations.get(component.name);
-        if (registration === void 0 || registration.component !== component) {
-          active = false;
-          return ok(void 0);
-        }
-        if (registration.owners > 1) {
-          registration.owners -= 1;
-          active = false;
-          return ok(void 0);
-        }
-        if (this.inUse(component)) return err(new ComponentInUseError(component.name));
-        this.registrations.delete(component.name);
-        active = false;
-        return ok(void 0);
-      }
-    });
-  }
-  resolve(name) {
-    return this.registrations.get(name)?.component;
-  }
-  entries() {
-    return new Map(
-      [...this.registrations].map(([name, registration]) => [name, registration.component])
-    );
-  }
-};
 
 // src/internal.ts
 var DERIVED_WRITER = /* @__PURE__ */ Symbol.for(
@@ -492,6 +162,6 @@ function getDerivedWriter(query, component) {
   return internalQuery[DERIVED_WRITER](component);
 }
 
-export { ComponentCatalog, ComponentInUseError, ComponentNameConflictError, DERIVED_WRITER, MANAGED_ARRAY_ELEMENT_TYPES, TYPE_METADATA, bufferFieldByteLength, componentDefinition, componentId, componentSchema, defineComponent, fieldTypeToMetaKey, getDerivedWriter, isComponentDefinitionOrderValid, isEntityField, isManagedArrayField, isManagedBufferField, isManagedField, isSchemaVocabKeyword, parseManagedArraySchema, worldInternal };
+export { DERIVED_WRITER, componentDefinition, componentId, componentSchema, getDerivedWriter };
 //# sourceMappingURL=internal.mjs.map
 //# sourceMappingURL=internal.mjs.map