From 38f63d736b88526548739cb4ce1935802241dad1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 6 Nov 2025 13:09:21 +0000
Subject: [PATCH 1/2] Initial plan


From 93bc2a81eace60207ff70b91e648ed5ce3960862 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 6 Nov 2025 13:17:09 +0000
Subject: [PATCH 2/2] docs: replace Legacy API section with ECS-only migration
 note

Co-authored-by: kalwalt <1275858+kalwalt@users.noreply.github.com>
---
 README.md | 32 ++++++++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 387a083..34d6ef9 100644
--- a/README.md
+++ b/README.md
@@ -269,12 +269,36 @@ Use this checklist when the example or your integration doesn’t behave as expe
 - Prefer `HTMLVideoElement.requestVideoFrameCallback` when available; it syncs to decoder frames.
 - If needed, throttle frame emission in the pump to reduce CPU usage (e.g., skip frames).
 
-## Legacy API
+## Migration to ECS-only Core
 
-The original Source and Profile classes are still available and fully supported:
+AR.js Core has been refactored to be **ECS-only** as the foundation for AR.js-next. The legacy Source, Profile, Session, and SessionDebugUI classes have been **removed from the core library**.
+
+### What this means
+
+- **ECS and Plugin Architecture**: The core now focuses exclusively on the modern Entity-Component-System architecture with a clean plugin system.
+- **Legacy API Removed**: The old Source, Profile, Session, and SessionDebugUI classes are no longer exported from `ar.js-core`.
+- **Adapter Package (Future)**: If you need legacy API compatibility, a separate adapter package may be provided in the future that wraps the ECS core with the old API.
+- **Three.js Integration**: Three.js-specific functionality will be developed in a separate repository: **arjs-plugin-threejs**.
+
+### Importing from the bundled library
+
+**ES Modules (ESM):**
+
+```javascript
+import { Engine, CaptureSystem, SOURCE_TYPES, webcamPlugin } from 'ar.js-core';
+// or with explicit file reference:
+import { Engine } from '../../dist/arjs-core.mjs';
+```
+
+**CommonJS (CJS):**
 
 ```javascript
-import { Source, Profile } from 'arjs-core';
+const { Engine, CaptureSystem, SOURCE_TYPES } = require('ar.js-core');
 ```
 
-See existing documentation for legacy API usage.
+The package.json `exports` field maps to:
+
+- ESM: `dist/arjs-core.mjs` (via `import` or `module`)
+- CJS: `dist/arjs-core.js` (via `require` or `main`)
+
+See the examples in the `examples/` directory for complete usage patterns with the ECS architecture.