convert transient component/entities to ephemeral to avoid confusion with transient operations (#89)

* convert transient component/entities to ephemeral to avoid confusion with transient operations

* Add ephemeral flag to TransactionResult and unify ephemeral resources

- Add `ephemeral: boolean` to TransactionResult, true when all changed
  entities have negative IDs (ephemeral entities)
- Refactor Entity into namespace folder with Entity.isEphemeral utility
- Resources with schema.ephemeral now create ephemeral entities (negative IDs)
  instead of only resetting values on deserialize
- Update coalesceTransactions, observed database, and storage persistence
  to propagate and respect the ephemeral flag
- Skip ephemeral-only transactions in createStoragePersistenceService
- Add comprehensive tests for ephemeral flag across entity operations,
  resource mutations, mixed changes, and transaction coalescing

Made-with: Cursor

* bumped

Author: krisnye

package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-monorepo",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "private": true,
   "scripts": {
     "build": "pnpm -r run build",

packages/data-lit-tictactoe/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-lit-tictactoe",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "description": "Tic-Tac-Toe sample - Lit web components with @adobe/data-lit and AgenticService",
   "type": "module",
   "private": true,

packages/data-lit-todo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-lit-todo",
-  "version": "0.9.43",
+  "version": "0.9.45",
   "description": "Todo sample app demonstrating @adobe/data with Lit",
   "type": "module",
   "private": true,

packages/data-lit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,

packages/data-react-hello/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-react-hello",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "description": "Hello World sample - click counter using @adobe/data-react",
   "type": "module",
   "private": true,

packages/data-react-pixie/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-react-pixie",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "description": "PixiJS React sample - ECS sprites (bunny, fox) with @adobe/data-react",
   "type": "module",
   "private": true,

packages/data-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-react",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "description": "Adobe data React bindings — hooks and context for ECS database",
   "type": "module",
   "private": false,

packages/data/AGENTS.md

@@ -72,7 +72,7 @@ Source lives under `src/` with one main `index.ts` per area; built output is in
 |----------|---------|
 | `extends` | Base plugin to extend (single parent only) |
 | `services` | `(db) => ServiceInstance` — singleton service factories; extended plugin services initialize first |
-| `components` | Schema object for ECS component data. Use `transient: true` for non-persistable values (DOM refs, HTML elements). |
+| `components` | Schema object for ECS component data. Use `ephemeral: true` for non-persistable values (DOM refs, HTML elements). |
 | `resources` | `{ default: value as Type }` — global state. Use `as Type` for compile-time type; use `null as unknown as Type` for resources initialized later in a system. |
 | `archetypes` | `['comp1', 'comp2']` — standard ECS archetypes for querying and inserting related components |
 | `computed` | `(db) => Observe<T>` — factory returning observable; receives full db |

packages/data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data",
-  "version": "0.9.45",
+  "version": "0.9.47",
   "description": "Adobe data oriented programming library",
   "type": "module",
   "sideEffects": false,

packages/data/src/ecs/archetype/archetype.ts

@@ -1,6 +1,6 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 import { RequiredComponents } from "../required-components.js";
-import { Entity } from "../entity.js";
+import { Entity } from "../entity/entity.js";
 import { Table, ReadonlyTable } from "../../table/index.js";
 import { Assert } from "../../types/assert.js";
 import { Equal } from "../../types/equal.js";