lombok-typescript 0.1.0

package/dist/stage3/index.cjs

@@ -0,0 +1,275 @@
+'use strict';
+
+// src/core/metadata-store.ts
+var WeakMapMetadataStore = class {
+  classScopes = /* @__PURE__ */ new WeakMap();
+  memberScopes = /* @__PURE__ */ new WeakMap();
+  set(key, target, propertyKey, value) {
+    const bucket = this.bucket(target, propertyKey, true);
+    bucket.set(key, value);
+  }
+  get(key, target, propertyKey) {
+    const bucket = this.bucket(target, propertyKey, false);
+    return bucket?.get(key);
+  }
+  has(key, target, propertyKey) {
+    const bucket = this.bucket(target, propertyKey, false);
+    return bucket?.has(key) ?? false;
+  }
+  delete(key, target, propertyKey) {
+    const bucket = this.bucket(target, propertyKey, false);
+    if (!bucket) return false;
+    return bucket.delete(key);
+  }
+  list(target, propertyKey) {
+    const bucket = this.bucket(target, propertyKey, false);
+    if (!bucket) return [];
+    return Array.from(bucket.keys());
+  }
+  bucket(target, propertyKey, createIfMissing) {
+    if (propertyKey === void 0) {
+      let bucket2 = this.classScopes.get(target);
+      if (!bucket2 && createIfMissing) {
+        bucket2 = /* @__PURE__ */ new Map();
+        this.classScopes.set(target, bucket2);
+      }
+      return bucket2;
+    }
+    let perTarget = this.memberScopes.get(target);
+    if (!perTarget) {
+      if (!createIfMissing) return void 0;
+      perTarget = /* @__PURE__ */ new Map();
+      this.memberScopes.set(target, perTarget);
+    }
+    let bucket = perTarget.get(propertyKey);
+    if (!bucket) {
+      if (!createIfMissing) return void 0;
+      bucket = /* @__PURE__ */ new Map();
+      perTarget.set(propertyKey, bucket);
+    }
+    return bucket;
+  }
+};
+
+// src/stage3/backend.ts
+var Stage3Backend = class {
+  kind = "stage3";
+  metadata = new WeakMapMetadataStore();
+};
+var stage3Backend = new Stage3Backend();
+
+// src/stage3/decorate.ts
+function defineClassDecorator(logic) {
+  return function decorator(value, context) {
+    return logic(stage3Backend, value, context);
+  };
+}
+function defineFieldDecorator(logic) {
+  return function decorator(_value, context) {
+    return logic(stage3Backend, context);
+  };
+}
+function defineMethodDecorator(logic) {
+  return function decorator(value, context) {
+    return logic(stage3Backend, value, context);
+  };
+}
+function defineGetterDecorator(logic) {
+  return function decorator(value, context) {
+    return logic(stage3Backend, value, context);
+  };
+}
+function defineSetterDecorator(logic) {
+  return function decorator(value, context) {
+    return logic(stage3Backend, value, context);
+  };
+}
+
+// src/core/metadata-keys.ts
+var PREFIX = "lombok-ts:";
+var MetadataKeys = {
+  // Class-level (Lombok)
+  DATA: `${PREFIX}data`,
+  BUILDER: `${PREFIX}builder`,
+  TO_STRING: `${PREFIX}toString`,
+  // Class-level (GoF)
+  SINGLETON: `${PREFIX}singleton`,
+  FACTORY: `${PREFIX}factory`,
+  PROTOTYPE: `${PREFIX}prototype`,
+  NON_NULL: `${PREFIX}nonNull`,
+  // Method-level
+  MEMOIZE: `${PREFIX}memoize`};
+
+// src/decorators/shared/factory.ts
+var factoryRegistry = /* @__PURE__ */ new Map();
+function registerFactory(key, ctor) {
+  factoryRegistry.set(key, ctor);
+}
+function createFromFactory(key, ...args) {
+  const ctor = factoryRegistry.get(key);
+  if (!ctor) {
+    throw new Error(`No factory registered for key "${key}"`);
+  }
+  return new ctor(...args);
+}
+function getFactoryRegistry() {
+  return factoryRegistry;
+}
+function factoryClassStage3(backend, _value, context, key) {
+  backend.metadata.set(MetadataKeys.FACTORY, context.metadata, void 0, key);
+  registerFactory(key, _value);
+}
+function codegenClassMarkerStage3(backend, _value, context, metadataKey) {
+  backend.metadata.set(metadataKey, context.metadata, void 0, true);
+}
+
+// src/decorators/shared/non-null.ts
+function assertNonNull(value, label) {
+  if (value === null || value === void 0) {
+    throw new TypeError(`${label} must not be null or undefined`);
+  }
+}
+function nonNullFieldStage3(backend, context) {
+  backend.metadata.set(MetadataKeys.NON_NULL, context.metadata, context.name, true);
+  const name = String(context.name);
+  return function(initialValue) {
+    assertNonNull(initialValue, name);
+    return initialValue;
+  };
+}
+
+// src/decorators/shared/singleton.ts
+function singletonClassStage3(backend, value, context) {
+  backend.metadata.set(MetadataKeys.SINGLETON, context.metadata, void 0, true);
+  const Singleton2 = class extends value {
+    static #instance;
+    constructor(...args) {
+      if (Singleton2.#instance) {
+        return Singleton2.#instance;
+      }
+      super(...args);
+      Singleton2.#instance = this;
+    }
+  };
+  return Singleton2;
+}
+
+// src/utils/index.ts
+function deepClone(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => deepClone(item));
+  }
+  const cloned = {};
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      cloned[key] = deepClone(obj[key]);
+    }
+  }
+  return cloned;
+}
+
+// src/decorators/shared/prototype.ts
+function prototypeClassStage3(backend, value, context) {
+  backend.metadata.set(MetadataKeys.PROTOTYPE, context.metadata, void 0, true);
+  const Prototype2 = class extends value {
+    constructor(...args) {
+      super(...args);
+      const clone = deepClone(this);
+      return clone;
+    }
+  };
+  return Prototype2;
+}
+
+// src/decorators/shared/memoize.ts
+var CACHE_MISS = /* @__PURE__ */ Symbol("memoize-cache-miss");
+function buildCacheKey(args) {
+  return JSON.stringify(args);
+}
+function getFromCache(cache, key, ttl) {
+  const entry = cache.get(key);
+  if (!entry) return CACHE_MISS;
+  if (ttl !== void 0 && entry.expiresAt !== void 0 && Date.now() > entry.expiresAt) {
+    cache.delete(key);
+    return CACHE_MISS;
+  }
+  return entry.value;
+}
+function memoizeMethod(original, options = {}) {
+  const cache = /* @__PURE__ */ new Map();
+  const ttl = options.ttl;
+  return function(...args) {
+    const key = buildCacheKey(args);
+    const cached = getFromCache(cache, key, ttl);
+    if (cached !== CACHE_MISS) {
+      return cached;
+    }
+    const result = original.apply(this, args);
+    const entry = { value: result };
+    if (ttl !== void 0) {
+      entry.expiresAt = Date.now() + ttl;
+    }
+    cache.set(key, entry);
+    return result;
+  };
+}
+
+// src/decorators/shared/memoize-logic.ts
+function memoizeMethodStage3(backend, value, context, options = {}) {
+  backend.metadata.set(MetadataKeys.MEMOIZE, context.metadata, context.name, options);
+  return memoizeMethod(value, options);
+}
+
+// src/decorators/stage3/index.ts
+var NonNull = defineFieldDecorator(nonNullFieldStage3);
+var Singleton = defineClassDecorator(singletonClassStage3);
+var Prototype = defineClassDecorator(prototypeClassStage3);
+function Memoize(options = {}) {
+  return defineMethodDecorator(
+    (backend, value, context) => memoizeMethodStage3(backend, value, context, options)
+  );
+}
+function Factory(key) {
+  return defineClassDecorator((backend, value, context) => {
+    factoryClassStage3(backend, value, context, key);
+  });
+}
+var Data = defineClassDecorator(
+  (backend, value, context) => codegenClassMarkerStage3(backend, value, context, MetadataKeys.DATA)
+);
+var Builder = defineClassDecorator(
+  (backend, value, context) => codegenClassMarkerStage3(backend, value, context, MetadataKeys.BUILDER)
+);
+var ToString = defineClassDecorator(
+  (backend, value, context) => codegenClassMarkerStage3(backend, value, context, MetadataKeys.TO_STRING)
+);
+
+// src/stage3/index.ts
+function getClassMetadata(cls) {
+  return cls[Symbol.metadata];
+}
+
+exports.Builder = Builder;
+exports.Data = Data;
+exports.Factory = Factory;
+exports.Memoize = Memoize;
+exports.NonNull = NonNull;
+exports.Prototype = Prototype;
+exports.Singleton = Singleton;
+exports.Stage3Backend = Stage3Backend;
+exports.ToString = ToString;
+exports.createFromFactory = createFromFactory;
+exports.defineClassDecorator = defineClassDecorator;
+exports.defineFieldDecorator = defineFieldDecorator;
+exports.defineGetterDecorator = defineGetterDecorator;
+exports.defineMethodDecorator = defineMethodDecorator;
+exports.defineSetterDecorator = defineSetterDecorator;
+exports.getClassMetadata = getClassMetadata;
+exports.getFactoryRegistry = getFactoryRegistry;
+exports.registerFactory = registerFactory;
+exports.stage3Backend = stage3Backend;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/stage3/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/metadata-store.ts","../../src/stage3/backend.ts","../../src/stage3/decorate.ts","../../src/core/metadata-keys.ts","../../src/decorators/shared/factory.ts","../../src/decorators/shared/non-null.ts","../../src/decorators/shared/singleton.ts","../../src/utils/index.ts","../../src/decorators/shared/prototype.ts","../../src/decorators/shared/memoize.ts","../../src/decorators/shared/memoize-logic.ts","../../src/decorators/stage3/index.ts","../../src/stage3/index.ts"],"names":["bucket","Singleton","Prototype"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { MetadataKeyList, PropertyName } from './types.js';\n\n/**\n * Storage interface used by both decorator backends. Legacy delegates to\n * `reflect-metadata`; Stage 3 uses the WeakMap implementation below.\n */\nexport interface MetadataStore {\n  /** Store `value` under `key`. Omit `propertyKey` for class-level scope. */\n  set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void;\n\n  /** Read the value stored under `key`, or `undefined`. */\n  get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined;\n\n  /** True if `key` exists at the given scope. */\n  has(key: string, target: object, propertyKey?: PropertyName): boolean;\n\n  /** Remove the entry. Returns true if it existed. */\n  delete(key: string, target: object, propertyKey?: PropertyName): boolean;\n\n  /** All keys at the given scope. */\n  list(target: object, propertyKey?: PropertyName): MetadataKeyList;\n}\n\n/**\n * WeakMap-backed `MetadataStore`. Used directly by the Stage 3 backend.\n * Layout: target -> (propertyKey or class-level) -> key -> value.\n */\nexport class WeakMapMetadataStore implements MetadataStore {\n  private readonly classScopes = new WeakMap<object, Map<string, unknown>>();\n  private readonly memberScopes = new WeakMap<object, Map<string | symbol, Map<string, unknown>>>();\n\n  set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void {\n    const bucket = this.bucket(target, propertyKey, true)!;\n    bucket.set(key, value);\n  }\n\n  get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined {\n    const bucket = this.bucket(target, propertyKey, false);\n    return bucket?.get(key) as V | undefined;\n  }\n\n  has(key: string, target: object, propertyKey?: PropertyName): boolean {\n    const bucket = this.bucket(target, propertyKey, false);\n    return bucket?.has(key) ?? false;\n  }\n\n  delete(key: string, target: object, propertyKey?: PropertyName): boolean {\n    const bucket = this.bucket(target, propertyKey, false);\n    if (!bucket) return false;\n    return bucket.delete(key);\n  }\n\n  list(target: object, propertyKey?: PropertyName): MetadataKeyList {\n    const bucket = this.bucket(target, propertyKey, false);\n    if (!bucket) return [];\n    return Array.from(bucket.keys());\n  }\n\n  private bucket(\n    target: object,\n    propertyKey: PropertyName | undefined,\n    createIfMissing: boolean,\n  ): Map<string, unknown> | undefined {\n    if (propertyKey === undefined) {\n      let bucket = this.classScopes.get(target);\n      if (!bucket && createIfMissing) {\n        bucket = new Map();\n        this.classScopes.set(target, bucket);\n      }\n      return bucket;\n    }\n\n    let perTarget = this.memberScopes.get(target);\n    if (!perTarget) {\n      if (!createIfMissing) return undefined;\n      perTarget = new Map();\n      this.memberScopes.set(target, perTarget);\n    }\n\n    let bucket = perTarget.get(propertyKey);\n    if (!bucket) {\n      if (!createIfMissing) return undefined;\n      bucket = new Map();\n      perTarget.set(propertyKey, bucket);\n    }\n    return bucket;\n  }\n}\n","import type { Backend } from '../core/backend.js';\nimport type { MetadataStore } from '../core/metadata-store.js';\nimport { WeakMapMetadataStore } from '../core/metadata-store.js';\n\n/**\n * Backend for the Stage 3 ECMAScript decorator standard (TS 5.0+).\n *\n * Stage 3 doesn't use `reflect-metadata`. Each decorator's `context.metadata`\n * is a per-class `Record<PropertyKey, unknown>` accessible at runtime as\n * `MyClass[Symbol.metadata]`. We key the WeakMap on that object so all\n * decorators on the same class share storage and consumers can recover the\n * metadata at runtime via `Class[Symbol.metadata]`.\n *\n * @see https://github.com/tc39/proposal-decorators\n * @see https://github.com/tc39/proposal-decorator-metadata\n */\nexport class Stage3Backend implements Backend {\n  readonly kind = 'stage3' as const;\n  readonly metadata: MetadataStore = new WeakMapMetadataStore();\n}\n\n/** Shared instance. */\nexport const stage3Backend = new Stage3Backend();\n","import type { Backend } from '../core/backend.js';\nimport type { AnyClass } from '../legacy/decorate.js';\nimport { stage3Backend } from './backend.js';\n\n/**\n * Logic shapes for Stage 3 decorator authoring.\n *\n * Stage 3 contexts are richer than legacy: `context.metadata` holds per-class\n * storage, `context.addInitializer(fn)` hooks into instance construction, and\n * `context.access` exposes get/set helpers. Logic functions get the full\n * context so they can use any of it.\n */\nexport type Stage3ClassLogic = (\n  backend: Backend,\n  value: AnyClass,\n  context: ClassDecoratorContext,\n) => AnyClass | void;\n\nexport type Stage3FieldLogic<This = unknown, Value = unknown> = (\n  backend: Backend,\n  context: ClassFieldDecoratorContext<This, Value>,\n) => ((this: This, initialValue: Value) => Value) | void;\n\nexport type Stage3MethodLogic<\n  This = unknown,\n  Args extends unknown[] = unknown[],\n  Return = unknown,\n> = (\n  backend: Backend,\n  value: (this: This, ...args: Args) => Return,\n  context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>,\n) => ((this: This, ...args: Args) => Return) | void;\n\nexport type Stage3GetterLogic<This = unknown, Value = unknown> = (\n  backend: Backend,\n  value: (this: This) => Value,\n  context: ClassGetterDecoratorContext<This, Value>,\n) => ((this: This) => Value) | void;\n\nexport type Stage3SetterLogic<This = unknown, Value = unknown> = (\n  backend: Backend,\n  value: (this: This, v: Value) => void,\n  context: ClassSetterDecoratorContext<This, Value>,\n) => ((this: This, v: Value) => void) | void;\n\n/**\n * Build a Stage 3 class decorator.\n *\n * @example\n * const Tracked = defineClassDecorator((backend, _value, context) => {\n *   backend.metadata.set('tracked', context.metadata as object, undefined, true);\n * });\n */\nexport function defineClassDecorator(\n  logic: Stage3ClassLogic,\n): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void {\n  return function decorator<T extends AnyClass>(\n    value: T,\n    context: ClassDecoratorContext,\n  ): T | void {\n    return logic(stage3Backend, value, context) as T | void;\n  };\n}\n\n/**\n * Build a Stage 3 field decorator. The logic can return an initializer\n * transformer that receives the field's initial value and returns the value\n * to store. Returning `void` leaves the initializer alone.\n */\nexport function defineFieldDecorator<This = unknown, Value = unknown>(\n  logic: Stage3FieldLogic<This, Value>,\n) {\n  return function decorator(\n    _value: undefined,\n    context: ClassFieldDecoratorContext<This, Value>,\n  ): ((this: This, initialValue: Value) => Value) | void {\n    return logic(stage3Backend, context);\n  };\n}\n\n/** Build a Stage 3 method decorator. The logic may return a wrapping function. */\nexport function defineMethodDecorator<\n  This = unknown,\n  Args extends unknown[] = unknown[],\n  Return = unknown,\n>(logic: Stage3MethodLogic<This, Args, Return>) {\n  return function decorator(\n    value: (this: This, ...args: Args) => Return,\n    context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>,\n  ): ((this: This, ...args: Args) => Return) | void {\n    return logic(stage3Backend, value, context);\n  };\n}\n\n/** Build a Stage 3 getter decorator. */\nexport function defineGetterDecorator<This = unknown, Value = unknown>(\n  logic: Stage3GetterLogic<This, Value>,\n) {\n  return function decorator(\n    value: (this: This) => Value,\n    context: ClassGetterDecoratorContext<This, Value>,\n  ): ((this: This) => Value) | void {\n    return logic(stage3Backend, value, context);\n  };\n}\n\n/** Build a Stage 3 setter decorator. */\nexport function defineSetterDecorator<This = unknown, Value = unknown>(\n  logic: Stage3SetterLogic<This, Value>,\n) {\n  return function decorator(\n    value: (this: This, v: Value) => void,\n    context: ClassSetterDecoratorContext<This, Value>,\n  ): ((this: This, v: Value) => void) | void {\n    return logic(stage3Backend, value, context);\n  };\n}\n","/**\n * Metadata keys used across the library. Adding one? Use the `lombok-ts:`\n * prefix and check `metadata-keys.test.ts` so uniqueness stays enforced.\n */\n\nconst PREFIX = 'lombok-ts:';\n\nexport const MetadataKeys = {\n  // Class-level (Lombok)\n  DATA: `${PREFIX}data`,\n  VALUE: `${PREFIX}value`,\n  BUILDER: `${PREFIX}builder`,\n  TO_STRING: `${PREFIX}toString`,\n  EQUALS: `${PREFIX}equals`,\n  UTILITY_CLASS: `${PREFIX}utilityClass`,\n  FIELD_DEFAULTS: `${PREFIX}fieldDefaults`,\n  ACCESSORS: `${PREFIX}accessors`,\n  LOG: `${PREFIX}log`,\n\n  // Class-level (TS-only)\n  OBSERVABLE: `${PREFIX}observable`,\n  SERIALIZABLE: `${PREFIX}serializable`,\n  DEEP_FREEZE: `${PREFIX}deepFreeze`,\n  TRACE: `${PREFIX}trace`,\n\n  // Class-level (GoF)\n  SINGLETON: `${PREFIX}singleton`,\n  FACTORY: `${PREFIX}factory`,\n  ABSTRACT_FACTORY: `${PREFIX}abstractFactory`,\n  PROTOTYPE: `${PREFIX}prototype`,\n  ADAPTER: `${PREFIX}adapter`,\n  BRIDGE: `${PREFIX}bridge`,\n  COMPOSITE: `${PREFIX}composite`,\n  WRAPS: `${PREFIX}wraps`,\n  FACADE: `${PREFIX}facade`,\n  FLYWEIGHT: `${PREFIX}flyweight`,\n  PROXY: `${PREFIX}proxy`,\n  CHAIN_OF_RESPONSIBILITY: `${PREFIX}chainOfResponsibility`,\n  COMMAND: `${PREFIX}command`,\n  INTERPRETER: `${PREFIX}interpreter`,\n  ITERABLE: `${PREFIX}iterable`,\n  MEDIATOR: `${PREFIX}mediator`,\n  MEMENTO: `${PREFIX}memento`,\n  STATE: `${PREFIX}state`,\n  STRATEGY: `${PREFIX}strategy`,\n  TEMPLATE_METHOD: `${PREFIX}templateMethod`,\n  VISITABLE: `${PREFIX}visitable`,\n  VISITOR: `${PREFIX}visitor`,\n\n  // Field-level\n  GETTER: `${PREFIX}getter`,\n  SETTER: `${PREFIX}setter`,\n  NON_NULL: `${PREFIX}nonNull`,\n  WITH: `${PREFIX}with`,\n  DELEGATE: `${PREFIX}delegate`,\n  VALIDATE: `${PREFIX}validate`,\n  TO_STRING_EXCLUDE: `${PREFIX}toString:exclude`,\n  TO_STRING_INCLUDE: `${PREFIX}toString:include`,\n  EQUALS_EXCLUDE: `${PREFIX}equals:exclude`,\n  SERIALIZABLE_EXCLUDE: `${PREFIX}serializable:exclude`,\n  SERIALIZABLE_TRANSFORM: `${PREFIX}serializable:transform`,\n  SERIALIZABLE_ALIAS: `${PREFIX}serializable:alias`,\n  BUILDER_DEFAULT: `${PREFIX}builder:default`,\n  SINGULAR: `${PREFIX}singular`,\n  ITERATE_OVER: `${PREFIX}iterateOver`,\n\n  // Method-level\n  MEMOIZE: `${PREFIX}memoize`,\n  DEBOUNCE: `${PREFIX}debounce`,\n  THROTTLE: `${PREFIX}throttle`,\n  RETRY: `${PREFIX}retry`,\n  HANDLER: `${PREFIX}handler`,\n  TRANSITION: `${PREFIX}transition`,\n  HOOK: `${PREFIX}hook`,\n\n  // Parameter-level\n  NON_NULL_PARAM: `${PREFIX}nonNull:param`,\n\n  // Internal, framework-managed\n  FIELDS: `${PREFIX}internal:fields`,\n  CONSTRUCTOR_PARAMS: `${PREFIX}internal:constructorParams`,\n  BACKEND: `${PREFIX}internal:backend`,\n} as const;\n\nexport type MetadataKey = (typeof MetadataKeys)[keyof typeof MetadataKeys];\n\nexport const METADATA_KEY_PREFIX = PREFIX;\n","import type { Backend } from '../../core/backend.js';\nimport { MetadataKeys } from '../../core/metadata-keys.js';\nimport type { AnyClass } from '../../legacy/decorate.js';\n\n/** Global factory registry keyed by `@Factory('key')` string. */\nconst factoryRegistry = new Map<string, AnyClass>();\n\nexport function registerFactory(key: string, ctor: AnyClass): void {\n  factoryRegistry.set(key, ctor);\n}\n\nexport function createFromFactory<T = unknown>(key: string, ...args: unknown[]): T {\n  const ctor = factoryRegistry.get(key);\n  if (!ctor) {\n    throw new Error(`No factory registered for key \"${key}\"`);\n  }\n  return new ctor(...args) as T;\n}\n\nexport function getFactoryRegistry(): ReadonlyMap<string, AnyClass> {\n  return factoryRegistry;\n}\n\nexport function factoryClassLegacy(backend: Backend, target: AnyClass, key: string): void {\n  backend.metadata.set(MetadataKeys.FACTORY, target, undefined, key);\n  registerFactory(key, target);\n}\n\nexport function factoryClassStage3(\n  backend: Backend,\n  _value: AnyClass,\n  context: ClassDecoratorContext,\n  key: string,\n): void {\n  backend.metadata.set(MetadataKeys.FACTORY, context.metadata as object, undefined, key);\n  registerFactory(key, _value);\n}\n\nexport function codegenClassMarkerLegacy(\n  backend: Backend,\n  target: AnyClass,\n  metadataKey: string,\n): void {\n  backend.metadata.set(metadataKey, target, undefined, true);\n}\n\nexport function codegenClassMarkerStage3(\n  backend: Backend,\n  _value: AnyClass,\n  context: ClassDecoratorContext,\n  metadataKey: string,\n): void {\n  backend.metadata.set(metadataKey, context.metadata as object, undefined, true);\n}\n","import type { Backend } from '../../core/backend.js';\nimport { MetadataKeys } from '../../core/metadata-keys.js';\nimport type { PropertyName } from '../../core/types.js';\n\nexport function assertNonNull(value: unknown, label: string): void {\n  if (value === null || value === undefined) {\n    throw new TypeError(`${label} must not be null or undefined`);\n  }\n}\n\nexport function nonNullFieldLegacy(\n  backend: Backend,\n  targetPrototype: object,\n  propertyKey: PropertyName,\n): void {\n  backend.metadata.set(MetadataKeys.NON_NULL, targetPrototype, propertyKey, true);\n  const key = String(propertyKey);\n  let stored: unknown;\n\n  Object.defineProperty(targetPrototype, propertyKey, {\n    configurable: true,\n    enumerable: true,\n    get() {\n      return stored;\n    },\n    set(value: unknown) {\n      assertNonNull(value, key);\n      stored = value;\n    },\n  });\n}\n\nexport function nonNullParameterLegacy(\n  backend: Backend,\n  targetPrototype: object,\n  propertyKey: PropertyName | undefined,\n  parameterIndex: number,\n): void {\n  backend.metadata.set(MetadataKeys.NON_NULL_PARAM, targetPrototype, propertyKey, parameterIndex);\n}\n\nexport function wrapMethodWithNonNullParams(\n  original: (...args: unknown[]) => unknown,\n  paramIndices: number[],\n  methodName: string,\n): (...args: unknown[]) => unknown {\n  return function (this: unknown, ...args: unknown[]) {\n    for (const index of paramIndices) {\n      assertNonNull(args[index], `${methodName} argument at index ${index}`);\n    }\n    return original.apply(this, args);\n  };\n}\n\nexport function nonNullFieldStage3<This, Value>(\n  backend: Backend,\n  context: ClassFieldDecoratorContext<This, Value>,\n): ((this: This, initialValue: Value) => Value) | void {\n  backend.metadata.set(MetadataKeys.NON_NULL, context.metadata as object, context.name, true);\n  const name = String(context.name);\n  return function (initialValue: Value): Value {\n    assertNonNull(initialValue, name);\n    return initialValue;\n  };\n}\n","import type { Backend } from '../../core/backend.js';\nimport { MetadataKeys } from '../../core/metadata-keys.js';\nimport type { AnyClass } from '../../legacy/decorate.js';\n\nexport function singletonClassLegacy(backend: Backend, target: AnyClass): AnyClass {\n  backend.metadata.set(MetadataKeys.SINGLETON, target, undefined, true);\n\n  const Singleton = class extends target {\n    static #instance: object | undefined;\n\n    constructor(...args: unknown[]) {\n      if (Singleton.#instance) {\n        return Singleton.#instance;\n      }\n      super(...args);\n      Singleton.#instance = this as object;\n    }\n  };\n\n  return Singleton as AnyClass;\n}\n\nexport function singletonClassStage3(\n  backend: Backend,\n  value: AnyClass,\n  context: ClassDecoratorContext,\n): AnyClass {\n  backend.metadata.set(MetadataKeys.SINGLETON, context.metadata as object, undefined, true);\n\n  const Singleton = class extends value {\n    static #instance: object | undefined;\n\n    constructor(...args: unknown[]) {\n      if (Singleton.#instance) {\n        return Singleton.#instance;\n      }\n      super(...args);\n      Singleton.#instance = this as object;\n    }\n  };\n\n  return Singleton as AnyClass;\n}\n","/** Recursively clones primitives, arrays, and plain objects. */\nexport function deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => deepClone(item)) as T;\n  }\n\n  const cloned = {} as T;\n  for (const key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key)) {\n      cloned[key] = deepClone(obj[key]);\n    }\n  }\n  return cloned;\n}\n\n/** Freezes an object and recursively freezes its nested objects. */\nexport function deepFreeze<T extends object>(obj: T): Readonly<T> {\n  Object.freeze(obj);\n\n  for (const key of Object.keys(obj) as (keyof T)[]) {\n    const value = obj[key];\n    if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {\n      deepFreeze(value as object);\n    }\n  }\n\n  return obj;\n}\n\n/** Structural equality for primitives, arrays, and plain objects. */\nexport function deepEquals(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n\n  if (typeof a !== typeof b) return false;\n\n  if (a === null || b === null) return a === b;\n\n  if (typeof a !== 'object' || typeof b !== 'object') return false;\n\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    return a.every((item, index) => deepEquals(item, b[index]));\n  }\n\n  const aKeys = Object.keys(a as object);\n  const bKeys = Object.keys(b as object);\n\n  if (aKeys.length !== bKeys.length) return false;\n\n  return aKeys.every((key) =>\n    deepEquals((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n  );\n}\n\n/** djb2-ish 32-bit hash over the JSON-serialized value. */\nexport function hashCode(obj: unknown): number {\n  const str = JSON.stringify(obj);\n  let hash = 0;\n  for (let i = 0; i < str.length; i++) {\n    const char = str.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash;\n  }\n  return hash;\n}\n\n/** Uppercase the first letter. */\nexport function capitalize(str: string): string {\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/** Strip dashes/underscores, capitalize the next character. */\nexport function toCamelCase(str: string): string {\n  return str.replace(/[-_](.)/g, (_, char) => char.toUpperCase());\n}\n\n/** `toCamelCase` plus uppercase first letter. */\nexport function toPascalCase(str: string): string {\n  const camel = toCamelCase(str);\n  return capitalize(camel);\n}\n","import type { Backend } from '../../core/backend.js';\nimport { MetadataKeys } from '../../core/metadata-keys.js';\nimport type { AnyClass } from '../../legacy/decorate.js';\nimport { deepClone } from '../../utils/index.js';\n\nexport function prototypeClassLegacy(backend: Backend, target: AnyClass): AnyClass {\n  backend.metadata.set(MetadataKeys.PROTOTYPE, target, undefined, true);\n\n  const Prototype = class extends target {\n    constructor(...args: unknown[]) {\n      super(...args);\n      const clone = deepClone(this) as object;\n      return clone;\n    }\n  };\n\n  return Prototype as AnyClass;\n}\n\nexport function prototypeClassStage3(\n  backend: Backend,\n  value: AnyClass,\n  context: ClassDecoratorContext,\n): AnyClass {\n  backend.metadata.set(MetadataKeys.PROTOTYPE, context.metadata as object, undefined, true);\n\n  const Prototype = class extends value {\n    constructor(...args: unknown[]) {\n      super(...args);\n      const clone = deepClone(this) as object;\n      return clone;\n    }\n  };\n\n  return Prototype as AnyClass;\n}\n","export interface MemoizeOptions {\n  /** Time-to-live in milliseconds. Omit for infinite cache. */\n  ttl?: number;\n}\n\ninterface CacheEntry {\n  value: unknown;\n  expiresAt?: number;\n}\n\nconst CACHE_MISS = Symbol('memoize-cache-miss');\n\nfunction buildCacheKey(args: unknown[]): string {\n  return JSON.stringify(args);\n}\n\nfunction getFromCache(\n  cache: Map<string, CacheEntry>,\n  key: string,\n  ttl?: number,\n): unknown | typeof CACHE_MISS {\n  const entry = cache.get(key);\n  if (!entry) return CACHE_MISS;\n  if (ttl !== undefined && entry.expiresAt !== undefined && Date.now() > entry.expiresAt) {\n    cache.delete(key);\n    return CACHE_MISS;\n  }\n  return entry.value;\n}\n\nexport function memoizeMethod<T extends (...args: unknown[]) => unknown>(\n  original: T,\n  options: MemoizeOptions = {},\n): T {\n  const cache = new Map<string, CacheEntry>();\n  const ttl = options.ttl;\n\n  return function (this: unknown, ...args: unknown[]) {\n    const key = buildCacheKey(args);\n    const cached = getFromCache(cache, key, ttl);\n    if (cached !== CACHE_MISS) {\n      return cached;\n    }\n    const result = original.apply(this, args);\n    const entry: CacheEntry = { value: result };\n    if (ttl !== undefined) {\n      entry.expiresAt = Date.now() + ttl;\n    }\n    cache.set(key, entry);\n    return result;\n  } as T;\n}\n","import type { Backend } from '../../core/backend.js';\nimport { MetadataKeys } from '../../core/metadata-keys.js';\nimport type { PropertyName } from '../../core/types.js';\nimport { memoizeMethod, type MemoizeOptions } from './memoize.js';\n\nexport function memoizeMethodLegacy(\n  backend: Backend,\n  targetPrototype: object,\n  propertyKey: PropertyName,\n  descriptor: PropertyDescriptor,\n  options: MemoizeOptions = {},\n): PropertyDescriptor | void {\n  backend.metadata.set(MetadataKeys.MEMOIZE, targetPrototype, propertyKey, options);\n  const original = descriptor.value;\n  if (typeof original !== 'function') return;\n  return {\n    ...descriptor,\n    value: memoizeMethod(original as (...args: unknown[]) => unknown, options),\n  };\n}\n\nexport function memoizeMethodStage3<This, Args extends unknown[], Return>(\n  backend: Backend,\n  value: (this: This, ...args: Args) => Return,\n  context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>,\n  options: MemoizeOptions = {},\n): (this: This, ...args: Args) => Return {\n  backend.metadata.set(MetadataKeys.MEMOIZE, context.metadata as object, context.name, options);\n  return memoizeMethod(value as (...args: unknown[]) => unknown, options) as (\n    this: This,\n    ...args: Args\n  ) => Return;\n}\n","import { MetadataKeys } from '../../core/metadata-keys.js';\nimport {\n  defineClassDecorator,\n  defineFieldDecorator,\n  defineMethodDecorator,\n} from '../../stage3/decorate.js';\nimport {\n  codegenClassMarkerStage3,\n  factoryClassStage3,\n  createFromFactory,\n  getFactoryRegistry,\n  registerFactory,\n} from '../shared/factory.js';\nimport {\n  memoizeMethodStage3,\n  nonNullFieldStage3,\n  prototypeClassStage3,\n  singletonClassStage3,\n} from '../shared/index.js';\nimport type { MemoizeOptions } from '../shared/memoize.js';\n\n/** Validates field initial values are not null or undefined. */\nexport const NonNull = defineFieldDecorator(nonNullFieldStage3);\n\n/** Ensures only one instance of the class exists. */\nexport const Singleton = defineClassDecorator(singletonClassStage3);\n\n/** Returns a deep clone on every `new` call. */\nexport const Prototype = defineClassDecorator(prototypeClassStage3);\n\n/** Caches method return values. Optional TTL in milliseconds. */\nexport function Memoize(options: MemoizeOptions = {}) {\n  return defineMethodDecorator((backend, value, context) =>\n    memoizeMethodStage3(backend, value, context, options),\n  );\n}\n\n/** Registers the class in the global factory registry under `key`. */\nexport function Factory(key: string) {\n  return defineClassDecorator((backend, value, context) => {\n    factoryClassStage3(backend, value, context, key);\n  });\n}\n\n/** Composite Lombok `@Data` — codegen generates getters, setters, toString, equals. */\nexport const Data = defineClassDecorator((backend, value, context) =>\n  codegenClassMarkerStage3(backend, value, context, MetadataKeys.DATA),\n);\n\n/** Fluent builder — codegen generates a companion builder class. */\nexport const Builder = defineClassDecorator((backend, value, context) =>\n  codegenClassMarkerStage3(backend, value, context, MetadataKeys.BUILDER),\n);\n\n/** Auto `toString()` — codegen generates the method body. */\nexport const ToString = defineClassDecorator((backend, value, context) =>\n  codegenClassMarkerStage3(backend, value, context, MetadataKeys.TO_STRING),\n);\n\nexport { createFromFactory, getFactoryRegistry, registerFactory };\n","/**\n * Stage 3 decorator backend, for the modern ECMAScript decorator standard\n * (TS 5.0+, with `experimentalDecorators` set to false or unset).\n *\n * No `reflect-metadata` here. Each decorator's `context.metadata` holds\n * per-class storage, accessible at runtime as `MyClass[Symbol.metadata]`.\n *\n * Stage 3 has no parameter decorators. Reach for the legacy backend if you\n * need them.\n *\n * @example\n * import { defineClassDecorator } from 'lombok-typescript/stage3';\n *\n * const Tracked = defineClassDecorator((backend, _value, context) => {\n *   backend.metadata.set('tracked', context.metadata as object, undefined, true);\n * });\n */\n\nexport { Stage3Backend, stage3Backend } from './backend.js';\nexport {\n  defineClassDecorator,\n  defineFieldDecorator,\n  defineMethodDecorator,\n  defineGetterDecorator,\n  defineSetterDecorator,\n} from './decorate.js';\nexport type {\n  Stage3ClassLogic,\n  Stage3FieldLogic,\n  Stage3MethodLogic,\n  Stage3GetterLogic,\n  Stage3SetterLogic,\n} from './decorate.js';\nexport {\n  NonNull,\n  Singleton,\n  Prototype,\n  Memoize,\n  Factory,\n  Data,\n  Builder,\n  ToString,\n  createFromFactory,\n  getFactoryRegistry,\n  registerFactory,\n} from '../decorators/stage3/index.js';\n\n/** Read the Stage 3 `Symbol.metadata` object from a class, if present. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getClassMetadata(cls: new (...args: any[]) => any): object | undefined {\n  return (cls as { [Symbol.metadata]?: object })[Symbol.metadata];\n}\n"]}

package/dist/stage3/index.d.cts

@@ -0,0 +1,97 @@
+import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.cjs';
+import { A as AnyClass, M as MemoizeOptions } from '../memoize-Bj9pm_cK.cjs';
+export { c as createFromFactory, g as getFactoryRegistry, r as registerFactory } from '../memoize-Bj9pm_cK.cjs';
+
+/**
+ * Backend for the Stage 3 ECMAScript decorator standard (TS 5.0+).
+ *
+ * Stage 3 doesn't use `reflect-metadata`. Each decorator's `context.metadata`
+ * is a per-class `Record<PropertyKey, unknown>` accessible at runtime as
+ * `MyClass[Symbol.metadata]`. We key the WeakMap on that object so all
+ * decorators on the same class share storage and consumers can recover the
+ * metadata at runtime via `Class[Symbol.metadata]`.
+ *
+ * @see https://github.com/tc39/proposal-decorators
+ * @see https://github.com/tc39/proposal-decorator-metadata
+ */
+declare class Stage3Backend implements Backend {
+    readonly kind: "stage3";
+    readonly metadata: MetadataStore;
+}
+/** Shared instance. */
+declare const stage3Backend: Stage3Backend;
+
+/**
+ * Logic shapes for Stage 3 decorator authoring.
+ *
+ * Stage 3 contexts are richer than legacy: `context.metadata` holds per-class
+ * storage, `context.addInitializer(fn)` hooks into instance construction, and
+ * `context.access` exposes get/set helpers. Logic functions get the full
+ * context so they can use any of it.
+ */
+type Stage3ClassLogic = (backend: Backend, value: AnyClass, context: ClassDecoratorContext) => AnyClass | void;
+type Stage3FieldLogic<This = unknown, Value = unknown> = (backend: Backend, context: ClassFieldDecoratorContext<This, Value>) => ((this: This, initialValue: Value) => Value) | void;
+type Stage3MethodLogic<This = unknown, Args extends unknown[] = unknown[], Return = unknown> = (backend: Backend, value: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => ((this: This, ...args: Args) => Return) | void;
+type Stage3GetterLogic<This = unknown, Value = unknown> = (backend: Backend, value: (this: This) => Value, context: ClassGetterDecoratorContext<This, Value>) => ((this: This) => Value) | void;
+type Stage3SetterLogic<This = unknown, Value = unknown> = (backend: Backend, value: (this: This, v: Value) => void, context: ClassSetterDecoratorContext<This, Value>) => ((this: This, v: Value) => void) | void;
+/**
+ * Build a Stage 3 class decorator.
+ *
+ * @example
+ * const Tracked = defineClassDecorator((backend, _value, context) => {
+ *   backend.metadata.set('tracked', context.metadata as object, undefined, true);
+ * });
+ */
+declare function defineClassDecorator(logic: Stage3ClassLogic): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/**
+ * Build a Stage 3 field decorator. The logic can return an initializer
+ * transformer that receives the field's initial value and returns the value
+ * to store. Returning `void` leaves the initializer alone.
+ */
+declare function defineFieldDecorator<This = unknown, Value = unknown>(logic: Stage3FieldLogic<This, Value>): (_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => ((this: This, initialValue: Value) => Value) | void;
+/** Build a Stage 3 method decorator. The logic may return a wrapping function. */
+declare function defineMethodDecorator<This = unknown, Args extends unknown[] = unknown[], Return = unknown>(logic: Stage3MethodLogic<This, Args, Return>): (value: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => ((this: This, ...args: Args) => Return) | void;
+/** Build a Stage 3 getter decorator. */
+declare function defineGetterDecorator<This = unknown, Value = unknown>(logic: Stage3GetterLogic<This, Value>): (value: (this: This) => Value, context: ClassGetterDecoratorContext<This, Value>) => ((this: This) => Value) | void;
+/** Build a Stage 3 setter decorator. */
+declare function defineSetterDecorator<This = unknown, Value = unknown>(logic: Stage3SetterLogic<This, Value>): (value: (this: This, v: Value) => void, context: ClassSetterDecoratorContext<This, Value>) => ((this: This, v: Value) => void) | void;
+
+/** Validates field initial values are not null or undefined. */
+declare const NonNull: <This, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void | ((this: This, initialValue: Value) => Value);
+/** Ensures only one instance of the class exists. */
+declare const Singleton: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Returns a deep clone on every `new` call. */
+declare const Prototype: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Caches method return values. Optional TTL in milliseconds. */
+declare function Memoize(options?: MemoizeOptions): (value: (this: unknown, ...args: unknown[]) => unknown, context: ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>) => void | ((this: unknown, ...args: unknown[]) => unknown);
+/** Registers the class in the global factory registry under `key`. */
+declare function Factory(key: string): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Composite Lombok `@Data` — codegen generates getters, setters, toString, equals. */
+declare const Data: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Fluent builder — codegen generates a companion builder class. */
+declare const Builder: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Auto `toString()` — codegen generates the method body. */
+declare const ToString: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+
+/**
+ * Stage 3 decorator backend, for the modern ECMAScript decorator standard
+ * (TS 5.0+, with `experimentalDecorators` set to false or unset).
+ *
+ * No `reflect-metadata` here. Each decorator's `context.metadata` holds
+ * per-class storage, accessible at runtime as `MyClass[Symbol.metadata]`.
+ *
+ * Stage 3 has no parameter decorators. Reach for the legacy backend if you
+ * need them.
+ *
+ * @example
+ * import { defineClassDecorator } from 'lombok-typescript/stage3';
+ *
+ * const Tracked = defineClassDecorator((backend, _value, context) => {
+ *   backend.metadata.set('tracked', context.metadata as object, undefined, true);
+ * });
+ */
+
+/** Read the Stage 3 `Symbol.metadata` object from a class, if present. */
+declare function getClassMetadata(cls: new (...args: any[]) => any): object | undefined;
+
+export { Builder, Data, Factory, Memoize, NonNull, Prototype, Singleton, Stage3Backend, type Stage3ClassLogic, type Stage3FieldLogic, type Stage3GetterLogic, type Stage3MethodLogic, type Stage3SetterLogic, ToString, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, stage3Backend };

package/dist/stage3/index.d.ts

@@ -0,0 +1,97 @@
+import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.js';
+import { A as AnyClass, M as MemoizeOptions } from '../memoize-DvelzGDl.js';
+export { c as createFromFactory, g as getFactoryRegistry, r as registerFactory } from '../memoize-DvelzGDl.js';
+
+/**
+ * Backend for the Stage 3 ECMAScript decorator standard (TS 5.0+).
+ *
+ * Stage 3 doesn't use `reflect-metadata`. Each decorator's `context.metadata`
+ * is a per-class `Record<PropertyKey, unknown>` accessible at runtime as
+ * `MyClass[Symbol.metadata]`. We key the WeakMap on that object so all
+ * decorators on the same class share storage and consumers can recover the
+ * metadata at runtime via `Class[Symbol.metadata]`.
+ *
+ * @see https://github.com/tc39/proposal-decorators
+ * @see https://github.com/tc39/proposal-decorator-metadata
+ */
+declare class Stage3Backend implements Backend {
+    readonly kind: "stage3";
+    readonly metadata: MetadataStore;
+}
+/** Shared instance. */
+declare const stage3Backend: Stage3Backend;
+
+/**
+ * Logic shapes for Stage 3 decorator authoring.
+ *
+ * Stage 3 contexts are richer than legacy: `context.metadata` holds per-class
+ * storage, `context.addInitializer(fn)` hooks into instance construction, and
+ * `context.access` exposes get/set helpers. Logic functions get the full
+ * context so they can use any of it.
+ */
+type Stage3ClassLogic = (backend: Backend, value: AnyClass, context: ClassDecoratorContext) => AnyClass | void;
+type Stage3FieldLogic<This = unknown, Value = unknown> = (backend: Backend, context: ClassFieldDecoratorContext<This, Value>) => ((this: This, initialValue: Value) => Value) | void;
+type Stage3MethodLogic<This = unknown, Args extends unknown[] = unknown[], Return = unknown> = (backend: Backend, value: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => ((this: This, ...args: Args) => Return) | void;
+type Stage3GetterLogic<This = unknown, Value = unknown> = (backend: Backend, value: (this: This) => Value, context: ClassGetterDecoratorContext<This, Value>) => ((this: This) => Value) | void;
+type Stage3SetterLogic<This = unknown, Value = unknown> = (backend: Backend, value: (this: This, v: Value) => void, context: ClassSetterDecoratorContext<This, Value>) => ((this: This, v: Value) => void) | void;
+/**
+ * Build a Stage 3 class decorator.
+ *
+ * @example
+ * const Tracked = defineClassDecorator((backend, _value, context) => {
+ *   backend.metadata.set('tracked', context.metadata as object, undefined, true);
+ * });
+ */
+declare function defineClassDecorator(logic: Stage3ClassLogic): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/**
+ * Build a Stage 3 field decorator. The logic can return an initializer
+ * transformer that receives the field's initial value and returns the value
+ * to store. Returning `void` leaves the initializer alone.
+ */
+declare function defineFieldDecorator<This = unknown, Value = unknown>(logic: Stage3FieldLogic<This, Value>): (_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => ((this: This, initialValue: Value) => Value) | void;
+/** Build a Stage 3 method decorator. The logic may return a wrapping function. */
+declare function defineMethodDecorator<This = unknown, Args extends unknown[] = unknown[], Return = unknown>(logic: Stage3MethodLogic<This, Args, Return>): (value: (this: This, ...args: Args) => Return, context: ClassMethodDecoratorContext<This, (this: This, ...args: Args) => Return>) => ((this: This, ...args: Args) => Return) | void;
+/** Build a Stage 3 getter decorator. */
+declare function defineGetterDecorator<This = unknown, Value = unknown>(logic: Stage3GetterLogic<This, Value>): (value: (this: This) => Value, context: ClassGetterDecoratorContext<This, Value>) => ((this: This) => Value) | void;
+/** Build a Stage 3 setter decorator. */
+declare function defineSetterDecorator<This = unknown, Value = unknown>(logic: Stage3SetterLogic<This, Value>): (value: (this: This, v: Value) => void, context: ClassSetterDecoratorContext<This, Value>) => ((this: This, v: Value) => void) | void;
+
+/** Validates field initial values are not null or undefined. */
+declare const NonNull: <This, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void | ((this: This, initialValue: Value) => Value);
+/** Ensures only one instance of the class exists. */
+declare const Singleton: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Returns a deep clone on every `new` call. */
+declare const Prototype: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Caches method return values. Optional TTL in milliseconds. */
+declare function Memoize(options?: MemoizeOptions): (value: (this: unknown, ...args: unknown[]) => unknown, context: ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>) => void | ((this: unknown, ...args: unknown[]) => unknown);
+/** Registers the class in the global factory registry under `key`. */
+declare function Factory(key: string): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Composite Lombok `@Data` — codegen generates getters, setters, toString, equals. */
+declare const Data: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Fluent builder — codegen generates a companion builder class. */
+declare const Builder: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Auto `toString()` — codegen generates the method body. */
+declare const ToString: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+
+/**
+ * Stage 3 decorator backend, for the modern ECMAScript decorator standard
+ * (TS 5.0+, with `experimentalDecorators` set to false or unset).
+ *
+ * No `reflect-metadata` here. Each decorator's `context.metadata` holds
+ * per-class storage, accessible at runtime as `MyClass[Symbol.metadata]`.
+ *
+ * Stage 3 has no parameter decorators. Reach for the legacy backend if you
+ * need them.
+ *
+ * @example
+ * import { defineClassDecorator } from 'lombok-typescript/stage3';
+ *
+ * const Tracked = defineClassDecorator((backend, _value, context) => {
+ *   backend.metadata.set('tracked', context.metadata as object, undefined, true);
+ * });
+ */
+
+/** Read the Stage 3 `Symbol.metadata` object from a class, if present. */
+declare function getClassMetadata(cls: new (...args: any[]) => any): object | undefined;
+
+export { Builder, Data, Factory, Memoize, NonNull, Prototype, Singleton, Stage3Backend, type Stage3ClassLogic, type Stage3FieldLogic, type Stage3GetterLogic, type Stage3MethodLogic, type Stage3SetterLogic, ToString, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, stage3Backend };