@fps-games/editor 0.2.0-beta.4 → 0.2.1-beta.2

package/node_modules/@fps-games/plugin-scene/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAuB,CAAC","sourcesContent":["export const FPS_PLUGIN_VERSION = '0.2.0-beta.4' as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAuB,CAAC","sourcesContent":["export const FPS_PLUGIN_VERSION = '0.2.1-beta.2' as const;\n"]}

package/node_modules/@fps-games/plugin-scene/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/plugin-scene",
-  "version": "0.2.0-beta.4",
+  "version": "0.2.1-beta.2",
   "private": true,
   "type": "module",
   "description": "First-party Scene Plugin for fps-games runtime and editor hosts.",
@@ -19,7 +19,7 @@
   },
   "fpsGamePlugin": {
     "id": "fps.plugin.scene",
-    "version": "0.2.0-beta.4",
+    "version": "0.2.1-beta.2",
     "apiVersion": 1,
     "requires": {},
     "provides": {
@@ -46,8 +46,8 @@
     }
   },
   "dependencies": {
-    "@fps-games/playable-contracts": "0.2.0-beta.4",
-    "@fps-games/playable-runtime-data": "0.2.0-beta.4",
-    "@fps-games/plugin-api": "0.2.0-beta.4"
+    "@fps-games/playable-contracts": "0.2.1-beta.2",
+    "@fps-games/playable-runtime-data": "0.2.1-beta.2",
+    "@fps-games/plugin-api": "0.2.1-beta.2"
   }
 }

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/reference.d.ts

@@ -0,0 +1,8 @@
+import { type ShadowMapExperimentPlan } from '@fps-games/playable-rendering/runtime';
+import { type FpsPluginManifest, type FpsPluginReference } from '@fps-games/plugin-api';
+export { FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID } from '@fps-games/playable-rendering/runtime';
+export declare function shadowMapExperimentPlugin(): Readonly<FpsPluginReference<null>>;
+export declare function createFpsShadowMapExperimentPluginManifest(): Readonly<FpsPluginManifest>;
+export declare function createFpsShadowMapExperimentPluginDataSnapshot(value: unknown): ShadowMapExperimentPlan;
+export declare function assertFpsShadowMapExperimentPluginData(value: unknown): void;
+//# sourceMappingURL=reference.d.ts.map

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAE5F,wBAAgB,yBAAyB,IAAI,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAO9E;AAED,wBAAgB,0CAA0C,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAexF;AAED,wBAAgB,8CAA8C,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAItG;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE3E"}

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/reference.js

@@ -0,0 +1,35 @@
+import { FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID, createShadowMapExperimentPlanSnapshot, } from '@fps-games/playable-rendering/runtime';
+import { defineFpsPluginManifest, defineFpsPluginReference, snapshotFpsPluginConfig, } from '@fps-games/plugin-api';
+import { FPS_PLUGIN_VERSION } from './version.js';
+export { FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID } from '@fps-games/playable-rendering/runtime';
+export function shadowMapExperimentPlugin() {
+    return defineFpsPluginReference({
+        packageName: '@fps-games/plugin-shadow-map-experiment',
+        pluginId: FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,
+        config: null,
+        hostServices: { runtime: ['fps.runtime.data'] },
+    });
+}
+export function createFpsShadowMapExperimentPluginManifest() {
+    return defineFpsPluginManifest({
+        id: FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,
+        version: FPS_PLUGIN_VERSION,
+        apiVersion: 1,
+        requires: {},
+        provides: { features: ['fps.shadow-map-experiment'] },
+        entries: { runtime: './runtime' },
+        environmentContracts: {
+            runtime: {
+                requires: { services: ['fps.runtime.data'] },
+                provides: { services: ['fps.runtime.shadow-map-experiment'] },
+            },
+        },
+    });
+}
+export function createFpsShadowMapExperimentPluginDataSnapshot(value) {
+    return createShadowMapExperimentPlanSnapshot(snapshotFpsPluginConfig(value, 'Shadow Map experiment Plugin data'));
+}
+export function assertFpsShadowMapExperimentPluginData(value) {
+    createFpsShadowMapExperimentPluginDataSnapshot(value);
+}
+//# sourceMappingURL=reference.js.map

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,qCAAqC,GAEtC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,GAGxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAE5F,MAAM,UAAU,yBAAyB;IACvC,OAAO,wBAAwB,CAAC;QAC9B,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE,mCAAmC;QAC7C,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0CAA0C;IACxD,OAAO,uBAAuB,CAAC;QAC7B,EAAE,EAAE,mCAAmC;QACvC,OAAO,EAAE,kBAAkB;QAC3B,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,2BAA2B,CAAC,EAAE;QACrD,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;QACjC,oBAAoB,EAAE;YACpB,OAAO,EAAE;gBACP,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,kBAAkB,CAAC,EAAE;gBAC5C,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,mCAAmC,CAAC,EAAE;aAC9D;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8CAA8C,CAAC,KAAc;IAC3E,OAAO,qCAAqC,CAC1C,uBAAuB,CAAC,KAAK,EAAE,mCAAmC,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,KAAc;IACnE,8CAA8C,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import {\n  FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,\n  createShadowMapExperimentPlanSnapshot,\n  type ShadowMapExperimentPlan,\n} from '@fps-games/playable-rendering/runtime';\nimport {\n  defineFpsPluginManifest,\n  defineFpsPluginReference,\n  snapshotFpsPluginConfig,\n  type FpsPluginManifest,\n  type FpsPluginReference,\n} from '@fps-games/plugin-api';\nimport { FPS_PLUGIN_VERSION } from './version.js';\n\nexport { FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID } from '@fps-games/playable-rendering/runtime';\n\nexport function shadowMapExperimentPlugin(): Readonly<FpsPluginReference<null>> {\n  return defineFpsPluginReference({\n    packageName: '@fps-games/plugin-shadow-map-experiment',\n    pluginId: FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,\n    config: null,\n    hostServices: { runtime: ['fps.runtime.data'] },\n  });\n}\n\nexport function createFpsShadowMapExperimentPluginManifest(): Readonly<FpsPluginManifest> {\n  return defineFpsPluginManifest({\n    id: FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,\n    version: FPS_PLUGIN_VERSION,\n    apiVersion: 1,\n    requires: {},\n    provides: { features: ['fps.shadow-map-experiment'] },\n    entries: { runtime: './runtime' },\n    environmentContracts: {\n      runtime: {\n        requires: { services: ['fps.runtime.data'] },\n        provides: { services: ['fps.runtime.shadow-map-experiment'] },\n      },\n    },\n  });\n}\n\nexport function createFpsShadowMapExperimentPluginDataSnapshot(value: unknown): ShadowMapExperimentPlan {\n  return createShadowMapExperimentPlanSnapshot(\n    snapshotFpsPluginConfig(value, 'Shadow Map experiment Plugin data'),\n  );\n}\n\nexport function assertFpsShadowMapExperimentPluginData(value: unknown): void {\n  createFpsShadowMapExperimentPluginDataSnapshot(value);\n}\n"]}

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/runtime.d.ts

@@ -0,0 +1,11 @@
+import type { ShadowMapExperimentPlan } from '@fps-games/playable-rendering/runtime';
+export interface FpsRuntimeShadowMapExperimentService {
+    readonly plan: ShadowMapExperimentPlan | null;
+}
+export declare const FPS_RUNTIME_SHADOW_MAP_EXPERIMENT: import("@fps-games/plugin-api").FpsServiceToken<FpsRuntimeShadowMapExperimentService>;
+export declare const pluginEntry: Readonly<{
+    pluginId: "fps.shadow-map-experiment";
+    environment: "runtime";
+    register(context: import("@fps-games/plugin-api").FpsPluginContext): void;
+}>;
+//# sourceMappingURL=runtime.d.ts.map

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAQrF,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC/C;AAED,eAAO,MAAM,iCAAiC,uFAE7C,CAAC;AAEF,eAAO,MAAM,WAAW;;;;EAWtB,CAAC"}

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/runtime.js

@@ -0,0 +1,14 @@
+import { FPS_RUNTIME_DATA, getFpsRuntimePluginData } from '@fps-games/playable-runtime-data';
+import { defineFpsPluginEntry, defineFpsServiceToken } from '@fps-games/plugin-api';
+import { FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID, createFpsShadowMapExperimentPluginDataSnapshot, } from './reference.js';
+export const FPS_RUNTIME_SHADOW_MAP_EXPERIMENT = defineFpsServiceToken('fps.runtime.shadow-map-experiment');
+export const pluginEntry = defineFpsPluginEntry({
+    pluginId: FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,
+    environment: 'runtime',
+    register(context) {
+        const pluginData = getFpsRuntimePluginData(context.services.get(FPS_RUNTIME_DATA), FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID);
+        const plan = pluginData ? createFpsShadowMapExperimentPluginDataSnapshot(pluginData.data) : null;
+        context.add(context.services.register(FPS_RUNTIME_SHADOW_MAP_EXPERIMENT, Object.freeze({ plan })));
+    },
+});
+//# sourceMappingURL=runtime.js.map

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EACL,mCAAmC,EACnC,8CAA8C,GAC/C,MAAM,gBAAgB,CAAC;AAMxB,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,CACpE,mCAAmC,CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;IAC9C,QAAQ,EAAE,mCAAmC;IAC7C,WAAW,EAAE,SAAS;IACtB,QAAQ,CAAC,OAAO;QACd,MAAM,UAAU,GAAG,uBAAuB,CACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,EACtC,mCAAmC,CACpC,CAAC;QACF,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,8CAA8C,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,iCAAiC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrG,CAAC;CACF,CAAC,CAAC","sourcesContent":["import type { ShadowMapExperimentPlan } from '@fps-games/playable-rendering/runtime';\nimport { FPS_RUNTIME_DATA, getFpsRuntimePluginData } from '@fps-games/playable-runtime-data';\nimport { defineFpsPluginEntry, defineFpsServiceToken } from '@fps-games/plugin-api';\nimport {\n  FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,\n  createFpsShadowMapExperimentPluginDataSnapshot,\n} from './reference.js';\n\nexport interface FpsRuntimeShadowMapExperimentService {\n  readonly plan: ShadowMapExperimentPlan | null;\n}\n\nexport const FPS_RUNTIME_SHADOW_MAP_EXPERIMENT = defineFpsServiceToken<FpsRuntimeShadowMapExperimentService>(\n  'fps.runtime.shadow-map-experiment',\n);\n\nexport const pluginEntry = defineFpsPluginEntry({\n  pluginId: FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,\n  environment: 'runtime',\n  register(context) {\n    const pluginData = getFpsRuntimePluginData(\n      context.services.get(FPS_RUNTIME_DATA),\n      FPS_SHADOW_MAP_EXPERIMENT_PLUGIN_ID,\n    );\n    const plan = pluginData ? createFpsShadowMapExperimentPluginDataSnapshot(pluginData.data) : null;\n    context.add(context.services.register(FPS_RUNTIME_SHADOW_MAP_EXPERIMENT, Object.freeze({ plan })));\n  },\n});\n"]}

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const FPS_PLUGIN_VERSION: "0.2.1-beta.2";
+//# sourceMappingURL=version.d.ts.map

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,EAAG,cAAuB,CAAC"}

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/version.js

@@ -0,0 +1,2 @@
+export const FPS_PLUGIN_VERSION = '0.2.1-beta.2';
+//# sourceMappingURL=version.js.map

package/node_modules/@fps-games/plugin-shadow-map-experiment/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAuB,CAAC","sourcesContent":["export const FPS_PLUGIN_VERSION = '0.2.1-beta.2' as const;\n"]}

package/node_modules/@fps-games/plugin-shadow-map-experiment/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@fps-games/plugin-shadow-map-experiment",
+  "version": "0.2.1-beta.2",
+  "private": true,
+  "type": "module",
+  "description": "Independent Babylon Shadow Map experiment Runtime Plugin.",
+  "sideEffects": false,
+  "main": "./dist/reference.js",
+  "types": "./dist/reference.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/reference.d.ts",
+      "import": "./dist/reference.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    }
+  },
+  "fpsGamePlugin": {
+    "id": "fps.shadow-map-experiment",
+    "version": "0.2.1-beta.2",
+    "apiVersion": 1,
+    "requires": {},
+    "provides": {
+      "features": [
+        "fps.shadow-map-experiment"
+      ]
+    },
+    "entries": {
+      "runtime": "./runtime"
+    },
+    "environmentContracts": {
+      "runtime": {
+        "requires": {
+          "services": [
+            "fps.runtime.data"
+          ]
+        },
+        "provides": {
+          "services": [
+            "fps.runtime.shadow-map-experiment"
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@fps-games/playable-rendering": "0.2.1-beta.2",
+    "@fps-games/playable-runtime-data": "0.2.1-beta.2",
+    "@fps-games/plugin-api": "0.2.1-beta.2"
+  }
+}

package/node_modules/@fps-games/plugin-shadows/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const FPS_PLUGIN_VERSION: "0.2.0-beta.4";
+export declare const FPS_PLUGIN_VERSION: "0.2.1-beta.2";
 //# sourceMappingURL=version.d.ts.map

package/node_modules/@fps-games/plugin-shadows/dist/version.js

@@ -1,2 +1,2 @@
-export const FPS_PLUGIN_VERSION = '0.2.0-beta.4';
+export const FPS_PLUGIN_VERSION = '0.2.1-beta.2';
 //# sourceMappingURL=version.js.map

package/node_modules/@fps-games/plugin-shadows/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAuB,CAAC","sourcesContent":["export const FPS_PLUGIN_VERSION = '0.2.0-beta.4' as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAuB,CAAC","sourcesContent":["export const FPS_PLUGIN_VERSION = '0.2.1-beta.2' as const;\n"]}

package/node_modules/@fps-games/plugin-shadows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/plugin-shadows",
-  "version": "0.2.0-beta.4",
+  "version": "0.2.1-beta.2",
   "private": true,
   "type": "module",
   "description": "First-party Shadows Plugin for fps-games runtime and editor hosts.",
@@ -19,7 +19,7 @@
   },
   "fpsGamePlugin": {
     "id": "fps.plugin.shadows",
-    "version": "0.2.0-beta.4",
+    "version": "0.2.1-beta.2",
     "apiVersion": 1,
     "requires": {},
     "provides": {
@@ -47,10 +47,10 @@
     }
   },
   "dependencies": {
-    "@fps-games/playable-contracts": "0.2.0-beta.4",
-    "@fps-games/playable-rendering": "0.2.0-beta.4",
-    "@fps-games/plugin-api": "0.2.0-beta.4",
-    "@fps-games/plugin-rendering": "0.2.0-beta.4",
-    "@fps-games/plugin-scene": "0.2.0-beta.4"
+    "@fps-games/playable-contracts": "0.2.1-beta.2",
+    "@fps-games/playable-rendering": "0.2.1-beta.2",
+    "@fps-games/plugin-api": "0.2.1-beta.2",
+    "@fps-games/plugin-rendering": "0.2.1-beta.2",
+    "@fps-games/plugin-scene": "0.2.1-beta.2"
   }
 }

package/node_modules/@playcanvas/observer/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011-2026 PlayCanvas Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/node_modules/@playcanvas/observer/README.md

@@ -0,0 +1,72 @@
+# Observer - Observer Pattern for JS/TS
+
+[![NPM Version](https://img.shields.io/npm/v/@playcanvas/observer)](https://www.npmjs.com/package/@playcanvas/observer)
+[![NPM Downloads](https://img.shields.io/npm/dw/@playcanvas/observer)](https://npmtrends.com/@playcanvas/observer)
+[![License](https://img.shields.io/npm/l/@playcanvas/observer)](https://github.com/playcanvas/observer/blob/main/LICENSE)
+[![Discord](https://img.shields.io/badge/Discord-5865F2?style=flat&logo=discord&logoColor=white&color=black)](https://discord.gg/RSaMRzg)
+[![Reddit](https://img.shields.io/badge/Reddit-FF4500?style=flat&logo=reddit&logoColor=white&color=black)](https://www.reddit.com/r/PlayCanvas)
+[![X](https://img.shields.io/badge/X-000000?style=flat&logo=x&logoColor=white&color=black)](https://x.com/intent/follow?screen_name=playcanvas)
+
+| [User Manual](https://developer.playcanvas.com) | [API Reference](https://api.playcanvas.com/observer) | [Blog](https://blog.playcanvas.com) | [Forum](https://forum.playcanvas.com) |
+
+The PlayCanvas Observer is a powerful TypeScript library for managing and observing changes to objects. It allows tracking modifications to nested properties, emitting events on changes, and maintaining state consistency. This is particularly useful in applications where state management and change tracking are critical, such as in data-driven interfaces or collaborative applications.
+
+## Installing
+
+To install the NPM package, do:
+
+```
+npm install @playcanvas/observer --save-dev
+```
+
+## Usage
+
+### Creating an Observer
+
+```javascript
+import Observer from '@playcanvas/observer';
+
+const data = {
+    name: 'John',
+    age: 30,
+    address: {
+        city: 'New York',
+        zip: '10001'
+    }
+};
+
+const observer = new Observer(data);
+```
+
+### Listening for Changes
+
+You can listen for changes to specific properties using the `on` method:
+
+```javascript
+observer.on('address.city:set', (newValue, oldValue) => {
+    console.log(`City changed from ${oldValue} to ${newValue}`);
+});
+
+observer.set('address.city', 'San Francisco'); // Logs: City changed from New York to San Francisco
+```
+
+## Building
+
+To generate a UMD and ESM build of the Observer library, run:
+
+```
+npm install
+npm run build
+```
+
+The UMD build is `dist/index.js`. The ESM build is `dist/index.mjs`.
+
+## API Docs
+
+To build the API reference manual, run:
+
+```
+npm run docs
+```
+
+A pre-built API reference manual is hosted [here](https://api.playcanvas.com/observer/).