Add target meta ability

.github/workflows/tests.yaml

@@ -21,30 +21,31 @@ jobs:
 
         steps:
             - name: 'Checkout'
-              uses: actions/checkout@v4
+              uses: actions/checkout@v6
 
             # 1. Setup pnpm
             - name: 'Install pnpm'
-              uses: pnpm/action-setup@v4
-              with:
-                  version: 9
+              uses: pnpm/action-setup@v6
 
             # 2. Setup Node 24 (No pnpm cache here to ensure a fresh fetch)
             - name: 'Use Node ${{ matrix.node }}'
-              uses: actions/setup-node@v4
+              uses: actions/setup-node@v6
               with:
                   node-version: ${{ matrix.node }}
 
             # 3. Force Fresh Dependency Resolution
             # We ignore the lockfile and prefer the latest versions in range.
             - name: 'Install latest dependencies'
-              run: pnpm install --no-frozen-lockfile --prefer-latest
+              run: pnpm install --no-frozen-lockfile
 
             # 4. Install Playwright Browsers (Required for Vitest)
             - name: 'Install Playwright Browsers'
               run: pnpm exec playwright install --with-deps chromium firefox
 
             # 5. Run the Pipeline
+            - name: 'Build'
+              run: pnpm build
+
             - name: 'Check Formatting'
               run: pnpm format
 
@@ -54,8 +55,5 @@ jobs:
             - name: 'Type Check'
               run: pnpm type-check
 
-            - name: 'Build'
-              run: pnpm build
-
             - name: 'Test (Node & Headless Browsers)'
               run: pnpm test

CHANGELOG_CLEAN_SLATE.md

@@ -18,6 +18,7 @@ Temporary changelog for feature branch.
 * `scripts/fix-esm-imports.js` util for fixing ESM imports.
 * `toParts()` util function (_support package_).
 * `isException()` util (_support package_).
+* `@inheritMeta()` decorator (_support package_).
 
 ### Changed
 
@@ -41,6 +42,7 @@ Temporary changelog for feature branch.
 * `useCloneable` option has been renamed to `clone` and set to `false` by default, in `MergeOptions` (_contracts and support packages_)
 * Object `merge()` behaviour changed to correctly deal with concat-spreadable objects and arrays (_support package_).
 * `set()`, `get()`, `has()`, `forget()` and `isArrayLike()` no longer use lodash (_support package_).
+* `ObjectId` properties are now set to be private.
 
 **Non-breaking Changes**
 
@@ -49,7 +51,7 @@ Temporary changelog for feature branch.
 * Optimized performance of reflections utilities (_support package_).
 * Optimized performance of objects' `hasAll()`, `hasAny()`, `forgetAll()`, `ObjectId`, `isset()` and `populate()` (_support package_).
 * Improved typing of array `merge()` to work with any amount of arrays (_support package_).
-* `ObjectId` properties are now set to be private.
+* `getClassPropertyDescriptors()` can now also return property descriptors for static defined properties (_support package_).
 * The TypeScript source files are now also published, along with appropriate source maps.
 * dprint is now used for formatting.
 

package.json

@@ -32,11 +32,11 @@
         "@babel/plugin-proposal-decorators": "^7.29.0",
         "@eslint/js": "^10.0.1",
         "@types/luxon": "^3.7.1",
-        "@types/node": "^25.6.2",
-        "@vitest/browser": "^4.1.5",
-        "@vitest/browser-playwright": "^4.1.5",
-        "@vitest/coverage-istanbul": "^4.1.5",
-        "@vitest/coverage-v8": "^4.1.5",
+        "@types/node": "^25.7.0",
+        "@vitest/browser": "^4.1.6",
+        "@vitest/browser-playwright": "^4.1.6",
+        "@vitest/coverage-istanbul": "^4.1.6",
+        "@vitest/coverage-v8": "^4.1.6",
         "@vuepress/bundler-vite": "2.0.0-rc.29",
         "@vuepress/client": "2.0.0-rc.29",
         "@vuepress/plugin-back-to-top": "2.0.0-rc.128",
@@ -47,14 +47,14 @@
         "eslint": "^10.3.0",
         "globals": "^17.6.0",
         "luxon": "^3.7.2",
-        "playwright": "^1.59.1",
+        "playwright": "^1.60.0",
         "sass": "^1.99.0",
         "tslib": "^2.8.1",
         "turbo": "^2.9.12",
         "typescript": "^6.0.3",
-        "typescript-eslint": "^8.59.2",
-        "vite": "^8.0.11",
-        "vitest": "^4.1.5",
+        "typescript-eslint": "^8.59.3",
+        "vite": "^8.0.12",
+        "vitest": "^4.1.6",
         "vue": "^3.5.34",
         "vuepress": "2.0.0-rc.29"
     },
@@ -67,13 +67,13 @@
         "--- [ Development & Docs ] ---": "echo",
         "docs:dev": "vuepress dev docs",
         "docs:build": "vuepress build docs",
-        "type-check": "turbo run type-check && tsc -p tsconfig.json --noEmit",
         "--- [ Quality Control (Lint/Format/Test) ] ---": "echo",
         "lint": "eslint .",
         "lint:fix": "eslint . --fix",
         "format": "dprint check",
         "format:fix": "dprint fmt",
         "fix:all": "npm run format:fix && npm run lint:fix && npm run fix:imports",
+        "type-check": "turbo run type-check && tsc -p tsconfig.json --noEmit",
         "test": "vitest run",
         "test:watch": "vitest",
         "--- [ Build & Release ] ---": "echo",
@@ -104,5 +104,5 @@
         "publish-check": "Simulates a workspace-wide npm publish (dry-run).",
         "publish": "Full release workflow: sync, build, tag, and publish."
     },
-    "packageManager": "pnpm@10.33.2+sha512.a90faf6feeab71ad6c6e57f94e0fe1a12f5dcc22cd754db40ae9593eb6a3e0b6b12e3540218bb37ae083404b1f2ce6db2a4121e979829b4aff94b99f49da1cf8"
+    "packageManager": "pnpm@11.1.1"
 }

packages/contracts/src/support/meta/MemberAddress.ts

@@ -0,0 +1,51 @@
+import { Key } from '../types.js';
+import OwnerContext from './OwnerContext.js';
+
+/**
+ * Member Address
+ */
+export default interface MemberAddress {
+    /**
+     * Owner Context
+     *
+     * @type {OwnerContext | undefined}
+     */
+    ctx: OwnerContext | undefined;
+
+    /**
+     * Indicates whether the member is static (`true`) or otherwise (`false`)
+     *
+     * @type {boolean}
+     */
+    readonly static: boolean;
+
+    /**
+     * The kind of member
+     *
+     * @type {string}
+     */
+    readonly kind: string;
+
+    /**
+     * Name of the member
+     *
+     * @type {string|symbol}
+     */
+    readonly name: string | symbol;
+
+    /**
+     * The "base" path to where metadata is stored inside a Meta Repository
+     *
+     * @type {Key}
+     */
+    readonly basePath: Key;
+
+    /**
+     * Returns the full path to the given key in a Meta Repository, for the member
+     *
+     * @param {Key} [key]
+     *
+     * @returns {Key} {@link basePath} if no key provided
+     */
+    path(key?: Key): Key;
+}

packages/contracts/src/support/meta/OwnerContext.ts

@@ -0,0 +1,11 @@
+/**
+ * Owner Context
+ */
+export default interface OwnerContext {
+    /**
+     * Reference to the owner of a Meta Repository
+     *
+     * @type {WeakRef<object>}
+     */
+    readonly ownerRef: WeakRef<object>;
+}

packages/contracts/src/support/meta/Repository.ts

@@ -1,8 +1,7 @@
-// @aedart/contracts/support/meta/Repository.js
 import { Key } from '../types.js';
 
 /**
- * Metadata Repository Contract
+ * Metadata Repository
  */
 export default interface Repository {
     /**

packages/contracts/src/support/meta/index.ts

@@ -5,8 +5,10 @@
  */
 export const SUPPORT_META: unique symbol = Symbol('@aedart/contracts/support/meta');
 
+import MemberAddress from './MemberAddress.js';
 import MetaEntry from './MetaEntry.js';
+import OwnerContext from './OwnerContext.js';
 import Repository from './Repository.js';
-export { type MetaEntry, type Repository };
+export { type MemberAddress, type MetaEntry, type OwnerContext, type Repository };
 
 export type * from './types.js';

packages/support/src/meta/Address.ts

@@ -0,0 +1,109 @@
+import { type Key } from '@aedart/contracts/support';
+import { type MemberAddress, type OwnerContext } from '@aedart/contracts/support/meta';
+import { toParts } from '../objects/toParts.js';
+
+/**
+ * Member Address
+ */
+export default class Address implements MemberAddress
+{
+    /**
+     * @inheritdoc
+     */
+    ctx: OwnerContext | undefined;
+
+    /**
+     * @inheritdoc
+     */
+    readonly static: boolean;
+
+    /**
+     * @inheritdoc
+     */
+    readonly kind: string;
+
+    /**
+     * @inheritdoc
+     */
+    readonly name: string | symbol;
+
+    /**
+     * @inheritdoc
+     */
+    readonly basePath: Key;
+
+    /**
+     * Create a new member address instance
+     *
+     * @param {OwnerContext | undefined} ctx
+     * @param {boolean} isStatic
+     * @param {string} kind
+     * @param {string | symbol} name
+     */
+    constructor(
+        ctx: OwnerContext | undefined,
+        isStatic: boolean,
+        kind: string,
+        name: string | symbol,
+    )
+    {
+        this.ctx = ctx;
+        this.static = isStatic;
+        this.kind = kind;
+        this.name = name;
+        this.basePath = this.resolveBasePath();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    path(key?: Key): Key
+    {
+        if (key === undefined || key === null) {
+            return this.basePath;
+        }
+
+        const base = this.basePath as PropertyKey[];
+        const parts = toParts(key);
+
+        if (parts.length === 0) {
+            return this.basePath;
+        }
+
+        // Pre-allocate the exact array size needed.
+        // This avoids V8 inner-loop array resizing and memory reallocation steps.
+        const output = new Array<PropertyKey>(base.length + parts.length);
+
+        // Linear copy operations (highly optimized by V8 runtime JIT)
+        for (let i = 0; i < base.length; ++i) {
+            output[i] = base[i];
+        }
+
+        for (let i = 0; i < parts.length; ++i) {
+            output[base.length + i] = parts[i];
+        }
+
+        return output;
+    }
+
+    /**
+     * Resolves the base path
+     *
+     * @returns {Key}
+     *
+     * @protected
+     */
+    protected resolveBasePath(): Key
+    {
+        const kind = this.kind === 'method' ? 'methods' : 'fields';
+
+        // Direct layout construction avoids slow unshift structural re-indexes
+        // E.g. [ 'static', 'methods', 'playSound' ], or [ 'methods', 'playSound' ]
+        const path = this.static
+            ? ['static', kind, this.name]
+            : [kind, this.name];
+
+        // Freezing stops V8 from keeping hidden "growth memory buffers"
+        return Object.freeze(path) as unknown as Key;
+    }
+}

packages/support/src/meta/Metadata.ts

@@ -3,6 +3,8 @@ import { Key } from '@aedart/contracts/support';
 import { toParts } from '../objects/toParts.js';
 import { isConstructor } from '../reflections/isConstructor.js';
 import { getOrCreateRepository } from './getOrCreateRepository.js';
+import { addressRegistry } from './registries.js';
+import type Resolved from './Resolved.js';
 
 /**
  * Metadata Helper
@@ -23,9 +25,9 @@ export default class Metadata
      */
     static get<T>(target: object, key: Key, defaultValue?: T): T | undefined
     {
-        const resolved = this.resolveTarget(target, key);
+        const { resolvedTarget, resolvedKey } = this.resolveTargetAndKey(target, key);
 
-        return getOrCreateRepository(resolved).get<T>(key, defaultValue);
+        return getOrCreateRepository(resolvedTarget).get<T>(resolvedKey, defaultValue);
     }
 
     /**
@@ -38,9 +40,9 @@ export default class Metadata
      */
     static has(target: object, key: Key): boolean
     {
-        const resolved = this.resolveTarget(target, key);
+        const { resolvedTarget, resolvedKey } = this.resolveTargetAndKey(target, key);
 
-        return getOrCreateRepository(resolved).has(key);
+        return getOrCreateRepository(resolvedTarget).has(resolvedKey);
     }
 
     /**
@@ -55,6 +57,37 @@ export default class Metadata
         return getOrCreateRepository(target).all();
     }
 
+    /**
+     *  Resolve the actual target and key for metadata lookup
+     *
+     * @param {object} target
+     * @param {Key} key
+     *
+     * @returns {Resolved}
+     *
+     * @protected
+     */
+    protected static resolveTargetAndKey(target: object, key: Key): Resolved
+    {
+        let owner = target;
+        let resolvedKey = key;
+
+        const address = addressRegistry.get(target);
+        if (address !== undefined) {
+            const resolvedOwner = address.ctx?.ownerRef?.deref();
+            if (resolvedOwner !== undefined) {
+                owner = resolvedOwner;
+            }
+
+            resolvedKey = address.path(key);
+        }
+
+        return {
+            resolvedTarget: this.resolveTarget(owner, resolvedKey),
+            resolvedKey,
+        };
+    }
+
     /**
      * Resolves the actual target for metadata lookup
      *