@oasys/oecs 0.5.3 → 0.6.0

package/package.json

@@ -1,193 +1,365 @@
 {
-  "name": "@oasys/oecs",
-  "version": "0.5.3",
-  "description": "Archetype-based Entity Component System",
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "development": "./dist/index.development.js",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "development": "./dist/index.development.cjs",
-        "default": "./dist/index.cjs"
-      }
-    },
-    "./dev": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.development.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.development.cjs"
-      }
-    },
-    "./primitives": {
-      "import": {
-        "types": "./dist/primitives.d.ts",
-        "development": "./dist/primitives.development.js",
-        "default": "./dist/primitives.js"
-      },
-      "require": {
-        "types": "./dist/primitives.d.cts",
-        "development": "./dist/primitives.development.cjs",
-        "default": "./dist/primitives.cjs"
-      }
-    },
-    "./reactive": {
-      "import": {
-        "types": "./dist/reactive/index.d.ts",
-        "development": "./dist/reactive/index.development.js",
-        "default": "./dist/reactive/index.js"
-      },
-      "require": {
-        "types": "./dist/reactive/index.d.cts",
-        "development": "./dist/reactive/index.development.cjs",
-        "default": "./dist/reactive/index.cjs"
-      }
-    },
-    "./reactive-sync": {
-      "import": {
-        "types": "./dist/extensions/reactive/index.d.ts",
-        "development": "./dist/extensions/reactive/index.development.js",
-        "default": "./dist/extensions/reactive/index.js"
-      },
-      "require": {
-        "types": "./dist/extensions/reactive/index.d.cts",
-        "development": "./dist/extensions/reactive/index.development.cjs",
-        "default": "./dist/extensions/reactive/index.cjs"
-      }
-    },
-    "./editor": {
-      "import": {
-        "types": "./dist/extensions/editor/index.d.ts",
-        "development": "./dist/extensions/editor/index.development.js",
-        "default": "./dist/extensions/editor/index.js"
-      },
-      "require": {
-        "types": "./dist/extensions/editor/index.d.cts",
-        "development": "./dist/extensions/editor/index.development.cjs",
-        "default": "./dist/extensions/editor/index.cjs"
-      }
-    },
-    "./solid": {
-      "import": {
-        "types": "./dist/extensions/solid/index.d.ts",
-        "development": "./dist/extensions/solid/index.development.js",
-        "default": "./dist/extensions/solid/index.js"
-      },
-      "require": {
-        "types": "./dist/extensions/solid/index.d.cts",
-        "development": "./dist/extensions/solid/index.development.cjs",
-        "default": "./dist/extensions/solid/index.cjs"
-      }
-    },
-    "./shared": {
-      "import": {
-        "types": "./dist/shared.d.ts",
-        "development": "./dist/shared.development.js",
-        "default": "./dist/shared.js"
-      },
-      "require": {
-        "types": "./dist/shared.d.cts",
-        "development": "./dist/shared.development.cjs",
-        "default": "./dist/shared.cjs"
-      }
-    },
-    "./internal": {
-      "import": {
-        "types": "./dist/internal.d.ts",
-        "development": "./dist/internal.development.js",
-        "default": "./dist/internal.js"
-      },
-      "require": {
-        "types": "./dist/internal.d.cts",
-        "development": "./dist/internal.development.cjs",
-        "default": "./dist/internal.cjs"
-      }
-    },
-    "./package.json": "./package.json"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "dev": "vite",
-    "build": "node scripts/build.mjs && node scripts/postbuild.mjs",
-    "test": "vitest",
-    "bench": "vitest bench",
-    "prepublishOnly": "pnpm build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/oasys-works/oecs.git"
-  },
-  "homepage": "https://github.com/oasys-works/oecs#readme",
-  "bugs": {
-    "url": "https://github.com/oasys-works/oecs/issues"
-  },
-  "license": "MIT",
-  "keywords": [
-    "ecs",
-    "entity-component-system",
-    "archetype",
-    "gamedev"
-  ],
-  "peerDependencies": {
-    "solid-js": "^1.9.3"
-  },
-  "peerDependenciesMeta": {
-    "solid-js": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@vitest/coverage-v8": "^4.0.18",
-    "solid-js": "^1.9.3",
-    "typescript": "~5.6.2",
-    "vite": "^6.0.3",
-    "vite-plugin-dts": "^4.5.3",
-    "vitest": "^4.0.18"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "typesVersions": {
-    "*": {
-      "dev": [
-        "./dist/index.d.ts"
-      ],
-      "primitives": [
-        "./dist/primitives.d.ts"
-      ],
-      "reactive": [
-        "./dist/reactive/index.d.ts"
-      ],
-      "reactive-sync": [
-        "./dist/extensions/reactive/index.d.ts"
-      ],
-      "editor": [
-        "./dist/extensions/editor/index.d.ts"
-      ],
-      "solid": [
-        "./dist/extensions/solid/index.d.ts"
-      ],
-      "shared": [
-        "./dist/shared.d.ts"
-      ],
-      "internal": [
-        "./dist/internal.d.ts"
-      ]
-    }
-  }
+	"name": "@oasys/oecs",
+	"version": "0.6.0",
+	"description": "Archetype-based Entity Component System",
+	"type": "module",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"development": "./dist/index.development.js",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"development": "./dist/index.development.cjs",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./dev": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.development.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.development.cjs"
+			}
+		},
+		"./primitives": {
+			"import": {
+				"types": "./dist/primitives.d.ts",
+				"development": "./dist/primitives.development.js",
+				"default": "./dist/primitives.js"
+			},
+			"require": {
+				"types": "./dist/primitives.d.cts",
+				"development": "./dist/primitives.development.cjs",
+				"default": "./dist/primitives.cjs"
+			}
+		},
+		"./editor": {
+			"import": {
+				"types": "./dist/plugins/editor.d.ts",
+				"development": "./dist/plugins/editor.development.js",
+				"default": "./dist/plugins/editor.js"
+			},
+			"require": {
+				"types": "./dist/plugins/editor.d.cts",
+				"development": "./dist/plugins/editor.development.cjs",
+				"default": "./dist/plugins/editor.cjs"
+			}
+		},
+		"./editor/dev": {
+			"import": {
+				"types": "./dist/plugins/editor.d.ts",
+				"default": "./dist/plugins/editor.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/editor.d.cts",
+				"default": "./dist/plugins/editor.development.cjs"
+			}
+		},
+		"./solid": {
+			"import": {
+				"types": "./dist/plugins/solid.d.ts",
+				"development": "./dist/plugins/solid.development.js",
+				"default": "./dist/plugins/solid.js"
+			},
+			"require": {
+				"types": "./dist/plugins/solid.d.cts",
+				"development": "./dist/plugins/solid.development.cjs",
+				"default": "./dist/plugins/solid.cjs"
+			}
+		},
+		"./solid/dev": {
+			"import": {
+				"types": "./dist/plugins/solid.d.ts",
+				"default": "./dist/plugins/solid.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/solid.d.cts",
+				"default": "./dist/plugins/solid.development.cjs"
+			}
+		},
+		"./shared": {
+			"import": {
+				"types": "./dist/shared.d.ts",
+				"development": "./dist/shared.development.js",
+				"default": "./dist/shared.js"
+			},
+			"require": {
+				"types": "./dist/shared.d.cts",
+				"development": "./dist/shared.development.cjs",
+				"default": "./dist/shared.cjs"
+			}
+		},
+		"./internal": {
+			"import": {
+				"types": "./dist/internal.d.ts",
+				"development": "./dist/internal.development.js",
+				"default": "./dist/internal.js"
+			},
+			"require": {
+				"types": "./dist/internal.d.cts",
+				"development": "./dist/internal.development.cjs",
+				"default": "./dist/internal.cjs"
+			}
+		},
+		"./worker": {
+			"import": {
+				"types": "./dist/worker.d.ts",
+				"development": "./dist/worker.development.js",
+				"default": "./dist/worker.js"
+			},
+			"require": {
+				"types": "./dist/worker.d.cts",
+				"development": "./dist/worker.development.cjs",
+				"default": "./dist/worker.cjs"
+			}
+		},
+		"./worker/dev": {
+			"import": {
+				"types": "./dist/worker.d.ts",
+				"default": "./dist/worker.development.js"
+			},
+			"require": {
+				"types": "./dist/worker.d.cts",
+				"default": "./dist/worker.development.cjs"
+			}
+		},
+		"./package.json": "./package.json",
+		"./snapshots": {
+			"import": {
+				"types": "./dist/plugins/snapshots.d.ts",
+				"development": "./dist/plugins/snapshots.development.js",
+				"default": "./dist/plugins/snapshots.js"
+			},
+			"require": {
+				"types": "./dist/plugins/snapshots.d.cts",
+				"development": "./dist/plugins/snapshots.development.cjs",
+				"default": "./dist/plugins/snapshots.cjs"
+			}
+		},
+		"./snapshots/dev": {
+			"import": {
+				"types": "./dist/plugins/snapshots.d.ts",
+				"default": "./dist/plugins/snapshots.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/snapshots.d.cts",
+				"default": "./dist/plugins/snapshots.development.cjs"
+			}
+		},
+		"./events": {
+			"import": {
+				"types": "./dist/plugins/events.d.ts",
+				"development": "./dist/plugins/events.development.js",
+				"default": "./dist/plugins/events.js"
+			},
+			"require": {
+				"types": "./dist/plugins/events.d.cts",
+				"development": "./dist/plugins/events.development.cjs",
+				"default": "./dist/plugins/events.cjs"
+			}
+		},
+		"./events/dev": {
+			"import": {
+				"types": "./dist/plugins/events.d.ts",
+				"default": "./dist/plugins/events.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/events.d.cts",
+				"default": "./dist/plugins/events.development.cjs"
+			}
+		},
+		"./relations": {
+			"import": {
+				"types": "./dist/plugins/relations.d.ts",
+				"development": "./dist/plugins/relations.development.js",
+				"default": "./dist/plugins/relations.js"
+			},
+			"require": {
+				"types": "./dist/plugins/relations.d.cts",
+				"development": "./dist/plugins/relations.development.cjs",
+				"default": "./dist/plugins/relations.cjs"
+			}
+		},
+		"./relations/dev": {
+			"import": {
+				"types": "./dist/plugins/relations.d.ts",
+				"default": "./dist/plugins/relations.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/relations.d.cts",
+				"default": "./dist/plugins/relations.development.cjs"
+			}
+		},
+		"./observers": {
+			"import": {
+				"types": "./dist/plugins/observers.d.ts",
+				"development": "./dist/plugins/observers.development.js",
+				"default": "./dist/plugins/observers.js"
+			},
+			"require": {
+				"types": "./dist/plugins/observers.d.cts",
+				"development": "./dist/plugins/observers.development.cjs",
+				"default": "./dist/plugins/observers.cjs"
+			}
+		},
+		"./observers/dev": {
+			"import": {
+				"types": "./dist/plugins/observers.d.ts",
+				"default": "./dist/plugins/observers.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/observers.d.cts",
+				"default": "./dist/plugins/observers.development.cjs"
+			}
+		},
+		"./workers": {
+			"import": {
+				"types": "./dist/plugins/workers.d.ts",
+				"development": "./dist/plugins/workers.development.js",
+				"default": "./dist/plugins/workers.js"
+			},
+			"require": {
+				"types": "./dist/plugins/workers.d.cts",
+				"development": "./dist/plugins/workers.development.cjs",
+				"default": "./dist/plugins/workers.cjs"
+			}
+		},
+		"./workers/dev": {
+			"import": {
+				"types": "./dist/plugins/workers.d.ts",
+				"default": "./dist/plugins/workers.development.js"
+			},
+			"require": {
+				"types": "./dist/plugins/workers.d.cts",
+				"default": "./dist/plugins/workers.development.cjs"
+			}
+		}
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"CHANGELOG.md"
+	],
+	"sideEffects": false,
+	"scripts": {
+		"dev": "vite",
+		"build": "node scripts/build.mjs && node scripts/postbuild.mjs",
+		"test": "vitest",
+		"typecheck": "tsc --noEmit",
+		"fmt": "oxfmt --write",
+		"fmt:check": "oxfmt --check",
+		"lint": "oxlint",
+		"test:oracle": "vitest run --config bench/net-oracle/vitest.config.ts",
+		"verify": "pnpm fmt:check && pnpm lint && pnpm typecheck && vitest run && pnpm build",
+		"bench": "vitest bench",
+		"prepublishOnly": "pnpm verify"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/oasys-works/oecs.git"
+	},
+	"homepage": "https://github.com/oasys-works/oecs#readme",
+	"bugs": {
+		"url": "https://github.com/oasys-works/oecs/issues"
+	},
+	"license": "MIT",
+	"keywords": [
+		"ecs",
+		"entity-component-system",
+		"archetype",
+		"gamedev"
+	],
+	"peerDependencies": {
+		"solid-js": "^1.9.3"
+	},
+	"peerDependenciesMeta": {
+		"solid-js": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@types/node": "^25.0.3",
+		"@vitest/coverage-v8": "^4.0.18",
+		"oxfmt": "^0.66.0",
+		"oxlint": "^1.81.0",
+		"solid-js": "^1.9.3",
+		"typescript": "~5.6.2",
+		"vite": "^6.0.3",
+		"vite-plugin-dts": "^4.5.3",
+		"vitest": "^4.0.18"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"typesVersions": {
+		"*": {
+			"dev": [
+				"./dist/index.d.ts"
+			],
+			"primitives": [
+				"./dist/primitives.d.ts"
+			],
+			"editor": [
+				"./dist/plugins/editor.d.ts"
+			],
+			"editor/dev": [
+				"./dist/plugins/editor.d.ts"
+			],
+			"solid": [
+				"./dist/plugins/solid.d.ts"
+			],
+			"solid/dev": [
+				"./dist/plugins/solid.d.ts"
+			],
+			"shared": [
+				"./dist/shared.d.ts"
+			],
+			"internal": [
+				"./dist/internal.d.ts"
+			],
+			"worker": [
+				"./dist/worker.d.ts"
+			],
+			"worker/dev": [
+				"./dist/worker.d.ts"
+			],
+			"snapshots": [
+				"./dist/plugins/snapshots.d.ts"
+			],
+			"snapshots/dev": [
+				"./dist/plugins/snapshots.d.ts"
+			],
+			"events": [
+				"./dist/plugins/events.d.ts"
+			],
+			"events/dev": [
+				"./dist/plugins/events.d.ts"
+			],
+			"relations": [
+				"./dist/plugins/relations.d.ts"
+			],
+			"relations/dev": [
+				"./dist/plugins/relations.d.ts"
+			],
+			"observers": [
+				"./dist/plugins/observers.d.ts"
+			],
+			"observers/dev": [
+				"./dist/plugins/observers.d.ts"
+			],
+			"workers": [
+				"./dist/plugins/workers.d.ts"
+			],
+			"workers/dev": [
+				"./dist/plugins/workers.d.ts"
+			]
+		}
+	}
 }

package/dist/core/ecs/builtin_relations.d.cts

@@ -1,43 +0,0 @@
-import { ECS } from './ecs.cjs';
-import { OnDeleteTarget, RelationDef } from './relation.cjs';
-/** Options for a built-in relation. `exclusive` / `multi` are fixed (always
- * exclusive — required for the chain/tree traversal helpers), so only the
- * target-deletion cleanup policy is tunable. */
-export interface BuiltinRelationOptions {
-    /** What happens to a relation's sources when a target is destroyed.
-     * Defaults per relation (see each registrar). */
-    readonly onDeleteTarget?: OnDeleteTarget;
-}
-/**
- * Register an **`IsA(instance → exemplar)`** relation — a thin instance-of link.
- *
- * - "all instances of exemplar E" is `ecs.relations.sourcesOf(E, IsA)`.
- * - the IsA chain (`instance → exemplar → …`) is walked with
- *   `ecs.relations.ancestorsOf(instance, IsA)` / `rootOf` / `cascadeOf(exemplar, IsA)`.
- * - **No component inheritance** — IsA records the link only; materialization of
- *   an instance from its exemplar stays a spawn-time copy (the template path,
- *   #462), deliberately decoupled (#477 / #478). An exemplar is a real entity,
- *   not a `Template` (a non-entity template can't be a relation target).
- *
- * Default `onDeleteTarget: "clear"` — destroying an exemplar drops its
- * instances' IsA link but leaves the instances alive (the thin analog of
- * flecs's `IsA`-remove, since there is no inherited data to strip). Pass
- * `"delete"` for strong instance-of (exemplar death cascade-destroys instances).
- */
-export declare function registerIsA(ecs: ECS, opts?: BuiltinRelationOptions): RelationDef<"exclusive">;
-/**
- * Register a **`ChildOf(child → parent)`** relation — a thin hierarchy link.
- *
- * - a parent's children are `ecs.relations.sourcesOf(parent, ChildOf)`.
- * - the hierarchy is walked with `ecs.relations.ancestorsOf(child, ChildOf)` (up to the
- *   root), `rootOf`, and `cascadeOf(root, ChildOf)` (down, breadth-first,
- *   parents before children).
- * - unlike flecs's `ChildOf`, this does **not** scope names/lookup — the engine
- *   has no name registry; it is purely the structural parent link.
- *
- * Default `onDeleteTarget: "delete"` — destroying a parent cascade-destroys
- * its whole subtree (flecs's default). Pass `"clear"` to let children survive as
- * roots, or `"orphan"` to leave a dangling `targetOf`.
- */
-export declare function registerChildOf(ecs: ECS, opts?: BuiltinRelationOptions): RelationDef<"exclusive">;
-//# sourceMappingURL=builtin_relations.d.ts.map

package/dist/core/ecs/builtin_relations.d.ts

@@ -1,43 +0,0 @@
-import { ECS } from './ecs.js';
-import { OnDeleteTarget, RelationDef } from './relation.js';
-/** Options for a built-in relation. `exclusive` / `multi` are fixed (always
- * exclusive — required for the chain/tree traversal helpers), so only the
- * target-deletion cleanup policy is tunable. */
-export interface BuiltinRelationOptions {
-    /** What happens to a relation's sources when a target is destroyed.
-     * Defaults per relation (see each registrar). */
-    readonly onDeleteTarget?: OnDeleteTarget;
-}
-/**
- * Register an **`IsA(instance → exemplar)`** relation — a thin instance-of link.
- *
- * - "all instances of exemplar E" is `ecs.relations.sourcesOf(E, IsA)`.
- * - the IsA chain (`instance → exemplar → …`) is walked with
- *   `ecs.relations.ancestorsOf(instance, IsA)` / `rootOf` / `cascadeOf(exemplar, IsA)`.
- * - **No component inheritance** — IsA records the link only; materialization of
- *   an instance from its exemplar stays a spawn-time copy (the template path,
- *   #462), deliberately decoupled (#477 / #478). An exemplar is a real entity,
- *   not a `Template` (a non-entity template can't be a relation target).
- *
- * Default `onDeleteTarget: "clear"` — destroying an exemplar drops its
- * instances' IsA link but leaves the instances alive (the thin analog of
- * flecs's `IsA`-remove, since there is no inherited data to strip). Pass
- * `"delete"` for strong instance-of (exemplar death cascade-destroys instances).
- */
-export declare function registerIsA(ecs: ECS, opts?: BuiltinRelationOptions): RelationDef<"exclusive">;
-/**
- * Register a **`ChildOf(child → parent)`** relation — a thin hierarchy link.
- *
- * - a parent's children are `ecs.relations.sourcesOf(parent, ChildOf)`.
- * - the hierarchy is walked with `ecs.relations.ancestorsOf(child, ChildOf)` (up to the
- *   root), `rootOf`, and `cascadeOf(root, ChildOf)` (down, breadth-first,
- *   parents before children).
- * - unlike flecs's `ChildOf`, this does **not** scope names/lookup — the engine
- *   has no name registry; it is purely the structural parent link.
- *
- * Default `onDeleteTarget: "delete"` — destroying a parent cascade-destroys
- * its whole subtree (flecs's default). Pass `"clear"` to let children survive as
- * roots, or `"orphan"` to leave a dangling `targetOf`.
- */
-export declare function registerChildOf(ecs: ECS, opts?: BuiltinRelationOptions): RelationDef<"exclusive">;
-//# sourceMappingURL=builtin_relations.d.ts.map

package/dist/core/ecs/builtin_relations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtin_relations.d.ts","sourceRoot":"","sources":["../../../src/core/ecs/builtin_relations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;KAsBK;AAEL,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D;;gDAEgD;AAChD,MAAM,WAAW,sBAAsB;IACtC;qDACiD;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CACzC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,WAAW,CAAC,WAAW,CAAC,CAK7F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,WAAW,CAAC,WAAW,CAAC,CAKjG"}