diff --git a/changelog.md b/changelog.md index cfdbc87..7f2c964 100644 --- a/changelog.md +++ b/changelog.md @@ -1,5 +1,11 @@ # Changelog +## 2025-12-01 - 7.0.15 - fix(classes.doc) +Avoid emitting instance fields for collection and manager to preserve decorator-defined prototype getters + +- ts/classes.doc.ts: changed instance properties `collection` and `manager` to `declare` so TypeScript does not emit them as own properties — prevents ES2022 class fields from shadowing prototype getters created by @Collection and @managed decorators. +- readme.hints.md: added documentation explaining the ES2022 class fields issue and recommending use of `declare` for type-only instance properties; marks the fix as v7.0.15. + ## 2025-11-28 - 7.0.14 - fix(classes.collection) Centralize TC39 decorator metadata initialization and use context.metadata in class decorators diff --git a/readme.hints.md b/readme.hints.md index db0e1ff..19a4da7 100644 --- a/readme.hints.md +++ b/readme.hints.md @@ -78,3 +78,21 @@ All 157 tests passing across 10 test files: 3. `Symbol.metadata` on constructors is read-only (managed by runtime) 4. Field decorators run before class decorators (guaranteed order) 5. TypeScript 5.2+ has built-in TC39 decorator support + +## ES2022 Class Fields & Prototype Getters - Fixed in v7.0.15 + +### Issue +ES2022 class fields (`useDefineForClassFields: true`) create own properties during construction that shadow prototype getters defined by decorators. + +### Solution +Use `declare` keyword for instance properties that are accessed via prototype getters: +```typescript +// In SmartDataDbDoc (ts/classes.doc.ts): +declare public collection: SmartdataCollection; // Type-only, no JS emitted +declare public manager: TManager; // Type-only, no JS emitted +``` + +### Key Insight +- `declare` tells TypeScript this is a type-only declaration +- No JavaScript code is emitted for `declare` properties +- Prototype getters defined by `@Collection` and `@managed` decorators are no longer shadowed diff --git a/ts/00_commitinfo_data.ts b/ts/00_commitinfo_data.ts index 74d50cd..c5065d2 100644 --- a/ts/00_commitinfo_data.ts +++ b/ts/00_commitinfo_data.ts @@ -3,6 +3,6 @@ */ export const commitinfo = { name: '@push.rocks/smartdata', - version: '7.0.14', + version: '7.0.15', description: 'An advanced library for NoSQL data organization and manipulation using TypeScript with support for MongoDB, data validation, collections, and custom data types.' } diff --git a/ts/classes.doc.ts b/ts/classes.doc.ts index 781d8cc..4e6a31b 100644 --- a/ts/classes.doc.ts +++ b/ts/classes.doc.ts @@ -436,10 +436,10 @@ export class SmartDataDbDoc; - public collection: SmartdataCollection; + declare public collection: SmartdataCollection; public static defaultManager; public static manager; - public manager: TManager; + declare public manager: TManager; /** * Helper to get collection with fallback to static for Deno compatibility