@onerjs/core 8.53.5 → 8.53.7

package/Misc/decorators.d.ts

@@ -1,35 +1,50 @@
 import { type Nullable } from "../types.js";
-export declare function expandToProperty(callback: string, targetKey?: Nullable<string>): (target: any, propertyKey: string) => void;
-export declare function serialize(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsTexture(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsColor3(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsFresnelParameters(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsVector2(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsVector3(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsMeshReference(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsColorCurves(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsColor4(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsImageProcessingConfiguration(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsQuaternion(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
-export declare function serializeAsMatrix(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
+/**
+ * TC39 decorator context types that serialization decorators can be applied to.
+ * Serialization decorators can be applied to fields, getters, setters, and auto-accessors.
+ * `metadata` can be undefined at runtime when `Symbol.metadata` is not available (e.g. tree-shaken
+ * usage on a runtime that lacks native support and never triggered the polyfill); in that case the
+ * serialization metadata is simply not recorded.
+ */
+type SerializableContext = {
+    name: string | symbol;
+    metadata: DecoratorMetadataObject | undefined;
+};
+export declare function expandToProperty(callback: string, targetKey?: Nullable<string>): <This, V>(_value: ClassAccessorDecoratorTarget<This, V>, context: ClassAccessorDecoratorContext<This, V>) => ClassAccessorDecoratorResult<This, V>;
+export declare function serialize(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsTexture(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsColor3(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsFresnelParameters(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsVector2(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsVector3(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsMeshReference(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsColorCurves(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsColor4(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsImageProcessingConfiguration(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsQuaternion(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsMatrix(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
+export declare function serializeAsVector4(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
 /**
  * Decorator used to define property that can be serialized as reference to a camera
  * @param sourceName defines the name of the property to decorate
  * @returns Property Decorator
  */
-export declare function serializeAsCameraReference(sourceName?: string): (target: any, propertyKey: string | symbol) => void;
+export declare function serializeAsCameraReference(sourceName?: string): (_value: unknown, context: SerializableContext) => void;
 /**
  * Decorator used to redirect a function to a native implementation if available.
  * @internal
  */
-export declare function nativeOverride<T extends (...params: any[]) => boolean>(target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<(...params: Parameters<T>) => any>, predicate?: T): void;
+export declare function nativeOverride<This, Args extends any[], Return>(originalMethod: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>): (this: This, ...args: Args) => Return;
 export declare namespace nativeOverride {
-    var filter: <T extends (...params: any) => boolean>(predicate: T) => (target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<(...params: Parameters<T>) => unknown>) => void;
+    var filter: <T extends (...params: any) => boolean>(predicate: T) => <This, Args extends any[], Return>(originalMethod: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => ((this: This, ...args: Args) => Return);
 }
 /**
  * Adds accessors for a material property.
+ * Applied to an auto-accessor field. Reads/writes from a private backing field named by sourceKey (default: "_" + property name).
+ * The backing field is expected to have a `.value` property.
  * @param setCallback - The name of the callback function to call when the property is set.
- * @param targetKey - The key to use for the target property (defaults to the original property key).
- * @returns A property decorator.
+ * @param sourceKey - The name of the private field that stores the value (defaults to "_" + accessor name).
+ * @returns An accessor decorator.
  */
-export declare function addAccessorsForMaterialProperty(setCallback: string, targetKey?: Nullable<string>): (target: any, propertyKey: string) => void;
+export declare function addAccessorsForMaterialProperty(setCallback: string, sourceKey?: Nullable<string>): <This, V>(_value: ClassAccessorDecoratorTarget<This, V>, context: ClassAccessorDecoratorContext<This, V>) => ClassAccessorDecoratorResult<This, V>;
+export {};

package/Misc/decorators.functions.d.ts

@@ -1,7 +1,38 @@
+/**
+ * Internal helpers for reading and writing decorator metadata used by serialization.
+ *
+ * The serialization store is attached to each class constructor via `Symbol.metadata`. The polyfill
+ * required for `Symbol.metadata` lives in `symbolMetadataPolyfill.ts` and is applied at package
+ * entry points.
+ */
+import { type SerializedPropertyMetadataMap } from "./decorators.serializationUtilities.js";
+/**
+ * The well-known `Symbol.metadata` symbol, resolved once at module-evaluation time.
+ *
+ * Reading (and thereby resolving) this symbol at module load guarantees that `Symbol.metadata`
+ * exists BEFORE any decorated class which imports the decorator infrastructure evaluates its class
+ * body. TypeScript's TC39 decorator emit captures `context.metadata` from `Symbol.metadata` at the
+ * top of the class `static {}` block (before the decorator factory runs), so if the symbol is not
+ * yet installed the metadata object is `void 0` and every metadata-based decorator throws.
+ *
+ * It is intentionally an exported `const` initialized from a function call: bundlers that treat this
+ * module as side-effect-free may drop bare top-level calls, but they cannot drop a `const` whose
+ * value is referenced by the retained decorator helpers below. The tree-shaking side-effect detector
+ * likewise skips `const X = ...` initializers, so this module stays classified as pure and remains
+ * importable from `.pure` modules.
+ * @internal
+ */
+export declare const MetadataSymbol: symbol;
+/**
+ * Returns (creating if necessary) the serialization store owned by the provided decorator metadata.
+ * Used by the TC39 decorators, which receive `context.metadata` directly.
+ * @internal
+ */
+export declare function GetDirectStoreFromMetadata(metadata: DecoratorMetadataObject): SerializedPropertyMetadataMap;
 /** @internal */
-export declare function GetDirectStore(target: any): any;
+export declare function GetDirectStore(target: any): SerializedPropertyMetadataMap;
 /**
  * @returns the list of properties flagged as serializable
  * @param target host object
  */
-export declare function GetMergedStore(target: any): any;
+export declare function GetMergedStore(target: any): SerializedPropertyMetadataMap;

package/Misc/decorators.functions.js

@@ -1,50 +1,129 @@
-const MergedStore = {};
-const DecoratorInitialStore = {};
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const __bjsSerializableKey = "__bjs_serializable__";
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const _mergedStoreCache = new WeakMap();
+// Universal `Object.hasOwn` equivalent. We intentionally avoid the native `Object.hasOwn` (ES2022)
+// because TypeScript does not down-level runtime APIs and some Babylon Native engines (e.g. ChakraCore)
+// do not provide it. `Object.prototype.hasOwnProperty` exists on every engine, and routing through it
+// here also stays safe for the null-prototype metadata objects created below.
+function HasOwn(target, key) {
+    return Object.prototype.hasOwnProperty.call(target, key);
+}
+function GetMetadataSymbol() {
+    let metadataSymbol = Symbol.metadata;
+    if (!metadataSymbol) {
+        // Defensive idempotent fallback for runtimes (or import orders) where the entry-point polyfill
+        // has not yet run. Matches symbolMetadataPolyfill.ts.
+        metadataSymbol = Symbol("Symbol.metadata");
+        Object.defineProperty(Symbol, "metadata", {
+            configurable: true,
+            writable: true,
+            value: metadataSymbol,
+        });
+    }
+    return metadataSymbol;
+}
+/**
+ * The well-known `Symbol.metadata` symbol, resolved once at module-evaluation time.
+ *
+ * Reading (and thereby resolving) this symbol at module load guarantees that `Symbol.metadata`
+ * exists BEFORE any decorated class which imports the decorator infrastructure evaluates its class
+ * body. TypeScript's TC39 decorator emit captures `context.metadata` from `Symbol.metadata` at the
+ * top of the class `static {}` block (before the decorator factory runs), so if the symbol is not
+ * yet installed the metadata object is `void 0` and every metadata-based decorator throws.
+ *
+ * It is intentionally an exported `const` initialized from a function call: bundlers that treat this
+ * module as side-effect-free may drop bare top-level calls, but they cannot drop a `const` whose
+ * value is referenced by the retained decorator helpers below. The tree-shaking side-effect detector
+ * likewise skips `const X = ...` initializers, so this module stays classified as pure and remains
+ * importable from `.pure` modules.
+ * @internal
+ */
+export const MetadataSymbol = GetMetadataSymbol();
+// Returns the constructor for the provided decorator/serialization target.
+// Experimental decorators pass a prototype; serialization passes an instance or a constructor.
+function GetConstructor(target) {
+    return typeof target === "function" ? target : target?.constructor;
+}
+// Returns (creating if necessary) the metadata object owned by the given constructor.
+// The metadata's prototype mirrors the class hierarchy so merged lookups can walk it.
+function GetOwnMetadata(ctor) {
+    if (!ctor) {
+        return undefined;
+    }
+    if (!HasOwn(ctor, MetadataSymbol)) {
+        const parent = Object.getPrototypeOf(ctor);
+        const parentMetadata = parent ? parent[MetadataSymbol] : null;
+        Object.defineProperty(ctor, MetadataSymbol, {
+            value: Object.create(parentMetadata ?? null),
+            configurable: true,
+            writable: true,
+            enumerable: false,
+        });
+    }
+    return ctor[MetadataSymbol];
+}
+/**
+ * Returns (creating if necessary) the serialization store owned by the provided decorator metadata.
+ * Used by the TC39 decorators, which receive `context.metadata` directly.
+ * @internal
+ */
+export function GetDirectStoreFromMetadata(metadata) {
+    if (!metadata) {
+        // `metadata` is `context.metadata`, which is `void 0` when `Symbol.metadata` was not installed
+        // before the class was evaluated. Referencing `MetadataSymbol` here (a) produces an actionable
+        // error instead of a cryptic "Cannot convert undefined to object" and (b) keeps the module-load
+        // polyfill anchored so bundlers cannot tree-shake it away on the decorate-time serialize path.
+        throw new Error(`Decorator metadata is unavailable; the Symbol.metadata (${String(MetadataSymbol)}) polyfill must run before decorated classes are evaluated.`);
+    }
+    if (!HasOwn(metadata, __bjsSerializableKey)) {
+        metadata[__bjsSerializableKey] = {};
+    }
+    return metadata[__bjsSerializableKey];
+}
 /** @internal */
 export function GetDirectStore(target) {
-    const classKey = target.getClassName();
-    if (!DecoratorInitialStore[classKey]) {
-        DecoratorInitialStore[classKey] = {};
+    const metadata = GetOwnMetadata(GetConstructor(target));
+    if (!metadata) {
+        return {};
+    }
+    if (!HasOwn(metadata, __bjsSerializableKey)) {
+        metadata[__bjsSerializableKey] = {};
     }
-    return DecoratorInitialStore[classKey];
+    return metadata[__bjsSerializableKey];
 }
 /**
  * @returns the list of properties flagged as serializable
  * @param target host object
  */
 export function GetMergedStore(target) {
-    const classKey = target.getClassName();
-    if (MergedStore[classKey]) {
-        return MergedStore[classKey];
-    }
-    MergedStore[classKey] = {};
-    const store = MergedStore[classKey];
-    let currentTarget = target;
-    let currentKey = classKey;
-    while (currentKey) {
-        const initialStore = DecoratorInitialStore[currentKey];
-        for (const property in initialStore) {
-            store[property] = initialStore[property];
-        }
-        let parent;
-        let done = false;
-        do {
-            parent = Object.getPrototypeOf(currentTarget);
-            if (!parent.getClassName) {
-                done = true;
-                break;
-            }
-            if (parent.getClassName() !== currentKey) {
-                break;
+    const ctor = GetConstructor(target);
+    const metadata = ctor ? ctor[MetadataSymbol] : undefined;
+    if (!metadata) {
+        return {};
+    }
+    const cached = _mergedStoreCache.get(metadata);
+    if (cached) {
+        return cached;
+    }
+    const store = {};
+    // Walk the metadata prototype chain (most derived first); parents overwrite children to match the
+    // original class-name-keyed merge order.
+    const chain = [];
+    let current = metadata;
+    while (current) {
+        chain.push(current);
+        current = Object.getPrototypeOf(current);
+    }
+    for (const meta of chain) {
+        if (HasOwn(meta, __bjsSerializableKey)) {
+            const initialStore = meta[__bjsSerializableKey];
+            for (const property in initialStore) {
+                store[property] = initialStore[property];
             }
-            currentTarget = parent;
-        } while (parent);
-        if (done) {
-            break;
         }
-        currentKey = parent.getClassName();
-        currentTarget = parent;
     }
+    _mergedStoreCache.set(metadata, store);
     return store;
 }
 //# sourceMappingURL=decorators.functions.js.map

package/Misc/decorators.functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.functions.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/decorators.functions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,gBAAgB;AAChB,MAAM,UAAU,cAAc,CAAC,MAAW;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IAEvC,IAAI,CAAO,qBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,qBAAsB,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IAChD,CAAC;IAED,OAAa,qBAAsB,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAW;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IAEvC,IAAU,WAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAa,WAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAEK,WAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IAElC,MAAM,KAAK,GAAS,WAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,aAAa,GAAG,MAAM,CAAC;IAC3B,IAAI,UAAU,GAAG,QAAQ,CAAC;IAC1B,OAAO,UAAU,EAAE,CAAC;QAChB,MAAM,YAAY,GAAS,qBAAsB,CAAC,UAAU,CAAC,CAAC;QAC9D,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;YAClC,KAAK,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,MAAW,CAAC;QAChB,IAAI,IAAI,GAAG,KAAK,CAAC;QAEjB,GAAG,CAAC;YACA,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;gBACvB,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM;YACV,CAAC;YAED,IAAI,MAAM,CAAC,YAAY,EAAE,KAAK,UAAU,EAAE,CAAC;gBACvC,MAAM;YACV,CAAC;YAED,aAAa,GAAG,MAAM,CAAC;QAC3B,CAAC,QAAQ,MAAM,EAAE;QAEjB,IAAI,IAAI,EAAE,CAAC;YACP,MAAM;QACV,CAAC;QAED,UAAU,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QACnC,aAAa,GAAG,MAAM,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC","sourcesContent":["const MergedStore = {};\r\n\r\nconst DecoratorInitialStore = {};\r\n\r\n/** @internal */\r\nexport function GetDirectStore(target: any): any {\r\n    const classKey = target.getClassName();\r\n\r\n    if (!(<any>DecoratorInitialStore)[classKey]) {\r\n        (<any>DecoratorInitialStore)[classKey] = {};\r\n    }\r\n\r\n    return (<any>DecoratorInitialStore)[classKey];\r\n}\r\n\r\n/**\r\n * @returns the list of properties flagged as serializable\r\n * @param target host object\r\n */\r\nexport function GetMergedStore(target: any): any {\r\n    const classKey = target.getClassName();\r\n\r\n    if ((<any>MergedStore)[classKey]) {\r\n        return (<any>MergedStore)[classKey];\r\n    }\r\n\r\n    (<any>MergedStore)[classKey] = {};\r\n\r\n    const store = (<any>MergedStore)[classKey];\r\n    let currentTarget = target;\r\n    let currentKey = classKey;\r\n    while (currentKey) {\r\n        const initialStore = (<any>DecoratorInitialStore)[currentKey];\r\n        for (const property in initialStore) {\r\n            store[property] = initialStore[property];\r\n        }\r\n\r\n        let parent: any;\r\n        let done = false;\r\n\r\n        do {\r\n            parent = Object.getPrototypeOf(currentTarget);\r\n            if (!parent.getClassName) {\r\n                done = true;\r\n                break;\r\n            }\r\n\r\n            if (parent.getClassName() !== currentKey) {\r\n                break;\r\n            }\r\n\r\n            currentTarget = parent;\r\n        } while (parent);\r\n\r\n        if (done) {\r\n            break;\r\n        }\r\n\r\n        currentKey = parent.getClassName();\r\n        currentTarget = parent;\r\n    }\r\n\r\n    return store;\r\n}\r\n"]}
+{"version":3,"file":"decorators.functions.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/decorators.functions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Internal helpers for reading and writing decorator metadata used by serialization.\n *\n * The serialization store is attached to each class constructor via `Symbol.metadata`. The polyfill\n * required for `Symbol.metadata` lives in `symbolMetadataPolyfill.ts` and is applied at package\n * entry points.\n */\nimport { type SerializedPropertyMetadataMap } from \"./decorators.serializationUtilities\";\n\n// eslint-disable-next-line @typescript-eslint/naming-convention\nconst __bjsSerializableKey = \"__bjs_serializable__\";\n\n// eslint-disable-next-line @typescript-eslint/naming-convention\nconst _mergedStoreCache = new WeakMap<object, any>();\n\n// Universal `Object.hasOwn` equivalent. We intentionally avoid the native `Object.hasOwn` (ES2022)\n// because TypeScript does not down-level runtime APIs and some Babylon Native engines (e.g. ChakraCore)\n// do not provide it. `Object.prototype.hasOwnProperty` exists on every engine, and routing through it\n// here also stays safe for the null-prototype metadata objects created below.\nfunction HasOwn(target: object, key: PropertyKey): boolean {\n    return Object.prototype.hasOwnProperty.call(target, key);\n}\n\nfunction GetMetadataSymbol(): symbol {\n    let metadataSymbol = (Symbol as any).metadata as symbol | undefined;\n    if (!metadataSymbol) {\n        // Defensive idempotent fallback for runtimes (or import orders) where the entry-point polyfill\n        // has not yet run. Matches symbolMetadataPolyfill.ts.\n        metadataSymbol = Symbol(\"Symbol.metadata\");\n        Object.defineProperty(Symbol, \"metadata\", {\n            configurable: true,\n            writable: true,\n            value: metadataSymbol,\n        });\n    }\n    return metadataSymbol;\n}\n\n/**\n * The well-known `Symbol.metadata` symbol, resolved once at module-evaluation time.\n *\n * Reading (and thereby resolving) this symbol at module load guarantees that `Symbol.metadata`\n * exists BEFORE any decorated class which imports the decorator infrastructure evaluates its class\n * body. TypeScript's TC39 decorator emit captures `context.metadata` from `Symbol.metadata` at the\n * top of the class `static {}` block (before the decorator factory runs), so if the symbol is not\n * yet installed the metadata object is `void 0` and every metadata-based decorator throws.\n *\n * It is intentionally an exported `const` initialized from a function call: bundlers that treat this\n * module as side-effect-free may drop bare top-level calls, but they cannot drop a `const` whose\n * value is referenced by the retained decorator helpers below. The tree-shaking side-effect detector\n * likewise skips `const X = ...` initializers, so this module stays classified as pure and remains\n * importable from `.pure` modules.\n * @internal\n */\nexport const MetadataSymbol: symbol = GetMetadataSymbol();\n\n// Returns the constructor for the provided decorator/serialization target.\n// Experimental decorators pass a prototype; serialization passes an instance or a constructor.\nfunction GetConstructor(target: any): any {\n    return typeof target === \"function\" ? target : target?.constructor;\n}\n\n// Returns (creating if necessary) the metadata object owned by the given constructor.\n// The metadata's prototype mirrors the class hierarchy so merged lookups can walk it.\nfunction GetOwnMetadata(ctor: any): any {\n    if (!ctor) {\n        return undefined;\n    }\n    if (!HasOwn(ctor, MetadataSymbol)) {\n        const parent = Object.getPrototypeOf(ctor);\n        const parentMetadata = parent ? parent[MetadataSymbol] : null;\n        Object.defineProperty(ctor, MetadataSymbol, {\n            value: Object.create(parentMetadata ?? null),\n            configurable: true,\n            writable: true,\n            enumerable: false,\n        });\n    }\n    return ctor[MetadataSymbol];\n}\n\n/**\n * Returns (creating if necessary) the serialization store owned by the provided decorator metadata.\n * Used by the TC39 decorators, which receive `context.metadata` directly.\n * @internal\n */\nexport function GetDirectStoreFromMetadata(metadata: DecoratorMetadataObject): SerializedPropertyMetadataMap {\n    if (!metadata) {\n        // `metadata` is `context.metadata`, which is `void 0` when `Symbol.metadata` was not installed\n        // before the class was evaluated. Referencing `MetadataSymbol` here (a) produces an actionable\n        // error instead of a cryptic \"Cannot convert undefined to object\" and (b) keeps the module-load\n        // polyfill anchored so bundlers cannot tree-shake it away on the decorate-time serialize path.\n        throw new Error(`Decorator metadata is unavailable; the Symbol.metadata (${String(MetadataSymbol)}) polyfill must run before decorated classes are evaluated.`);\n    }\n    if (!HasOwn(metadata, __bjsSerializableKey)) {\n        (metadata as any)[__bjsSerializableKey] = {};\n    }\n    return (metadata as any)[__bjsSerializableKey];\n}\n\n/** @internal */\nexport function GetDirectStore(target: any): SerializedPropertyMetadataMap {\n    const metadata = GetOwnMetadata(GetConstructor(target));\n    if (!metadata) {\n        return {};\n    }\n    if (!HasOwn(metadata, __bjsSerializableKey)) {\n        metadata[__bjsSerializableKey] = {};\n    }\n    return metadata[__bjsSerializableKey];\n}\n\n/**\n * @returns the list of properties flagged as serializable\n * @param target host object\n */\nexport function GetMergedStore(target: any): SerializedPropertyMetadataMap {\n    const ctor = GetConstructor(target);\n    const metadata = ctor ? ctor[MetadataSymbol] : undefined;\n    if (!metadata) {\n        return {};\n    }\n\n    const cached = _mergedStoreCache.get(metadata);\n    if (cached) {\n        return cached;\n    }\n\n    const store: SerializedPropertyMetadataMap = {};\n    // Walk the metadata prototype chain (most derived first); parents overwrite children to match the\n    // original class-name-keyed merge order.\n    const chain: any[] = [];\n    let current: any = metadata;\n    while (current) {\n        chain.push(current);\n        current = Object.getPrototypeOf(current);\n    }\n    for (const meta of chain) {\n        if (HasOwn(meta, __bjsSerializableKey)) {\n            const initialStore = meta[__bjsSerializableKey] as SerializedPropertyMetadataMap;\n            for (const property in initialStore) {\n                store[property] = initialStore[property];\n            }\n        }\n    }\n\n    _mergedStoreCache.set(metadata, store);\n    return store;\n}\n"]}

package/Misc/decorators.js

@@ -1,21 +1,30 @@
-import { GetDirectStore } from "./decorators.functions.js";
+import { GetDirectStoreFromMetadata } from "./decorators.functions.js";
 function generateSerializableMember(type, sourceName) {
-    return (target, propertyKey) => {
-        const classStore = GetDirectStore(target);
-        if (!classStore[propertyKey]) {
-            classStore[propertyKey] = { type: type, sourceName: sourceName };
+    return (_value, context) => {
+        if (!context.metadata) {
+            return;
+        }
+        const propertyKey = String(context.name);
+        const store = GetDirectStoreFromMetadata(context.metadata);
+        if (!store[propertyKey]) {
+            store[propertyKey] = { type: type, sourceName: sourceName };
         }
     };
 }
 function generateExpandMember(setCallback, targetKey = null) {
-    return (target, propertyKey) => {
-        const key = targetKey || "_" + propertyKey;
-        Object.defineProperty(target, propertyKey, {
-            get: function () {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return (_value, context) => {
+        const key = targetKey || "_" + String(context.name);
+        return {
+            init(value) {
+                if (value !== undefined || !(key in this)) {
+                    this[key] = value;
+                }
+                return value;
+            },
+            get() {
                 return this[key];
             },
-            set: function (value) {
+            set(value) {
                 // does this object (i.e. vector3) has an equals function? use it!
                 // Note - not using "with epsilon" here, it is expected te behave like the internal cache does.
                 if (typeof this[key]?.equals === "function") {
@@ -27,51 +36,52 @@ function generateExpandMember(setCallback, targetKey = null) {
                     return;
                 }
                 this[key] = value;
-                target[setCallback].apply(this);
+                this[setCallback]();
             },
-            enumerable: true,
-            configurable: true,
-        });
+        };
     };
 }
 export function expandToProperty(callback, targetKey = null) {
     return generateExpandMember(callback, targetKey);
 }
 export function serialize(sourceName) {
-    return generateSerializableMember(0, sourceName); // value member
+    return generateSerializableMember(0 /* SerializedFieldType.VALUE */, sourceName);
 }
 export function serializeAsTexture(sourceName) {
-    return generateSerializableMember(1, sourceName); // texture member
+    return generateSerializableMember(1 /* SerializedFieldType.TEXTURE */, sourceName);
 }
 export function serializeAsColor3(sourceName) {
-    return generateSerializableMember(2, sourceName); // color3 member
+    return generateSerializableMember(2 /* SerializedFieldType.COLOR3 */, sourceName);
 }
 export function serializeAsFresnelParameters(sourceName) {
-    return generateSerializableMember(3, sourceName); // fresnel parameters member
+    return generateSerializableMember(3 /* SerializedFieldType.FRESNEL_PARAMETERS */, sourceName);
 }
 export function serializeAsVector2(sourceName) {
-    return generateSerializableMember(4, sourceName); // vector2 member
+    return generateSerializableMember(4 /* SerializedFieldType.VECTOR2 */, sourceName);
 }
 export function serializeAsVector3(sourceName) {
-    return generateSerializableMember(5, sourceName); // vector3 member
+    return generateSerializableMember(5 /* SerializedFieldType.VECTOR3 */, sourceName);
 }
 export function serializeAsMeshReference(sourceName) {
-    return generateSerializableMember(6, sourceName); // mesh reference member
+    return generateSerializableMember(6 /* SerializedFieldType.MESH */, sourceName);
 }
 export function serializeAsColorCurves(sourceName) {
-    return generateSerializableMember(7, sourceName); // color curves
+    return generateSerializableMember(7 /* SerializedFieldType.COLOR_CURVES */, sourceName);
 }
 export function serializeAsColor4(sourceName) {
-    return generateSerializableMember(8, sourceName); // color 4
+    return generateSerializableMember(8 /* SerializedFieldType.COLOR4 */, sourceName);
 }
 export function serializeAsImageProcessingConfiguration(sourceName) {
-    return generateSerializableMember(9, sourceName); // image processing
+    return generateSerializableMember(9 /* SerializedFieldType.IMAGE_PROCESSING */, sourceName);
 }
 export function serializeAsQuaternion(sourceName) {
-    return generateSerializableMember(10, sourceName); // quaternion member
+    return generateSerializableMember(10 /* SerializedFieldType.QUATERNION */, sourceName);
 }
 export function serializeAsMatrix(sourceName) {
-    return generateSerializableMember(12, sourceName); // matrix member
+    return generateSerializableMember(12 /* SerializedFieldType.MATRIX */, sourceName);
+}
+export function serializeAsVector4(sourceName) {
+    return generateSerializableMember(13 /* SerializedFieldType.VECTOR4 */, sourceName);
 }
 /**
  * Decorator used to define property that can be serialized as reference to a camera
@@ -79,38 +89,47 @@ export function serializeAsMatrix(sourceName) {
  * @returns Property Decorator
  */
 export function serializeAsCameraReference(sourceName) {
-    return generateSerializableMember(11, sourceName); // camera reference member
+    return generateSerializableMember(11 /* SerializedFieldType.CAMERA */, sourceName);
 }
 /**
- * Decorator used to redirect a function to a native implementation if available.
- * @internal
+ * Shared implementation for the {@link nativeOverride} decorator and its `.filter` variant.
+ * Both flavors install a wrapper that, on first invocation, resolves the function to use once:
+ * either the original JS function or (when running in a Babylon Native context) a native-aware
+ * function produced by `resolveNative`. The resolved function then replaces the wrapper on the
+ * target so subsequent calls skip this setup entirely.
+ * @param originalMethod - The decorated JS method.
+ * @param context - The TC39 method decorator context.
+ * @param resolveNative - Builds the function to use when a native override is present, given the
+ * native function and the original JS function.
+ * @returns The wrapper function that replaces the decorated method.
  */
-export function nativeOverride(target, propertyKey, descriptor, predicate) {
-    // Cache the original JS function for later.
-    const jsFunc = descriptor.value;
-    // Override the JS function to check for a native override on first invocation. Setting descriptor.value overrides the function at the early stage of code being loaded/imported.
-    descriptor.value = (...params) => {
-        // Assume the resolved function will be the original JS function, then we will check for the Babylon Native context.
-        let func = jsFunc;
-        // Check if we are executing in a Babylon Native context (e.g. check the presence of the _native global property) and if so also check if a function override is available.
-        if (typeof _native !== "undefined" && _native[propertyKey]) {
-            const nativeFunc = _native[propertyKey];
-            // If a predicate was provided, then we'll need to invoke the predicate on each invocation of the underlying function to determine whether to call the native function or the JS function.
-            if (predicate) {
-                // The resolved function will execute the predicate and then either execute the native function or the JS function.
-                func = (...params) => (predicate(...params) ? nativeFunc(...params) : jsFunc(...params));
+function ApplyNativeOverride(originalMethod, context, resolveNative) {
+    const propertyKey = String(context.name);
+    let resolvedFunc = null;
+    const wrapper = function (...params) {
+        if (resolvedFunc === null) {
+            // Default to the original JS function.
+            resolvedFunc = originalMethod;
+            // Check if we are executing in a Babylon Native context and if so, check for a function override.
+            if (typeof _native !== "undefined" && _native[propertyKey]) {
+                resolvedFunc = resolveNative(_native[propertyKey], originalMethod);
             }
-            else {
-                // The resolved function will directly execute the native function.
-                func = nativeFunc;
+            const target = (this && (context.static ? this : Object.getPrototypeOf(this)));
+            if (target?.[propertyKey] === wrapper) {
+                target[propertyKey] = resolvedFunc;
             }
         }
-        // Override the JS function again with the final resolved target function.
-        target[propertyKey] = func;
-        // The JS function has now been overridden based on whether we're executing in the context of Babylon Native, but we still need to invoke that function.
-        // Future invocations of the function will just directly invoke the final overridden function, not any of the decorator setup logic above.
-        return func(...params);
+        return resolvedFunc.apply(this, params);
     };
+    return wrapper;
+}
+/**
+ * Decorator used to redirect a function to a native implementation if available.
+ * @internal
+ */
+export function nativeOverride(originalMethod, context) {
+    // When a native override exists, use it directly.
+    return ApplyNativeOverride(originalMethod, context, (nativeFunc) => nativeFunc);
 }
 /**
  * Decorator factory that applies the nativeOverride decorator, but determines whether to redirect to the native implementation based on a filter function that evaluates the function arguments.
@@ -120,24 +139,35 @@ export function nativeOverride(target, propertyKey, descriptor, predicate) {
  * @internal
  */
 nativeOverride.filter = function (predicate) {
-    return (target, propertyKey, descriptor) => nativeOverride(target, propertyKey, descriptor, predicate);
+    return (originalMethod, context) => {
+        // When a native override exists, evaluate the predicate on each call to choose between the native and JS function.
+        return ApplyNativeOverride(originalMethod, context, (nativeFunc, jsFunc) => {
+            return function (...args) {
+                if (predicate(...args)) {
+                    // The native function is invoked without a `this` binding, matching the original behavior.
+                    return nativeFunc(...args);
+                }
+                return jsFunc.apply(this, args);
+            };
+        });
+    };
 };
 /**
  * Adds accessors for a material property.
+ * Applied to an auto-accessor field. Reads/writes from a private backing field named by sourceKey (default: "_" + property name).
+ * The backing field is expected to have a `.value` property.
  * @param setCallback - The name of the callback function to call when the property is set.
- * @param targetKey - The key to use for the target property (defaults to the original property key).
- * @returns A property decorator.
+ * @param sourceKey - The name of the private field that stores the value (defaults to "_" + accessor name).
+ * @returns An accessor decorator.
  */
-export function addAccessorsForMaterialProperty(setCallback, targetKey = null) {
-    return (target, propertyKey) => {
-        const key = propertyKey;
-        const newKey = targetKey || "";
-        Object.defineProperty(target, newKey, {
-            get: function () {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-                return this[key].value;
+export function addAccessorsForMaterialProperty(setCallback, sourceKey = null) {
+    return (_value, context) => {
+        const key = sourceKey || "_" + String(context.name);
+        return {
+            get() {
+                return this[key]?.value;
             },
-            set: function (value) {
+            set(value) {
                 // does this object (i.e. vector3) has an equals function? use it!
                 // Note - not using "with epsilon" here, it is expected te behave like the internal cache does.
                 if (typeof this[key]?.value?.equals === "function") {
@@ -149,11 +179,9 @@ export function addAccessorsForMaterialProperty(setCallback, targetKey = null) {
                     return;
                 }
                 this[key].value = value;
-                target[setCallback].apply(this);
+                this[setCallback]();
             },
-            enumerable: true,
-            configurable: true,
-        });
+        };
     };
 }
 //# sourceMappingURL=decorators.js.map