lombok-typescript 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+import { B as BackendKind } from './backend-CkLBcDd8.js';
+export { a as Backend, D as DecoratorKind, M as MetadataStore, P as PropertyName, W as WeakMapMetadataStore } from './backend-CkLBcDd8.js';
+export { METADATA_KEY_PREFIX, MetadataKey, MetadataKeys } from './core/index.js';
+
+interface LogConfig {
+    /** Logging provider. Default `'console'`. */
+    provider: 'console' | 'winston' | 'pino' | 'bunyan';
+    /** Default log level. Default `'info'`. */
+    defaultLevel: 'debug' | 'info' | 'warn' | 'error';
+}
+interface BuilderConfig {
+    /** Prefix for builder setter methods. Default `''` (so `name()`, not `withName()`). */
+    prefix: string;
+    /** Name of the build method. Default `'build'`. */
+    buildMethodName: string;
+    /** Name of the static builder method. Default `'builder'`. */
+    builderMethodName: string;
+}
+interface ToStringConfig {
+    /** Output format. Default `'pretty'`. */
+    format: 'pretty' | 'json' | 'compact';
+    /** Include the class name in output. Default `true`. */
+    includeClassName: boolean;
+}
+interface ValidateConfig {
+    /** Validation library. Default `'zod'`. */
+    provider: 'zod' | 'yup' | 'class-validator';
+    /** Throw on validation failure. Default `true`. */
+    throwOnError: boolean;
+}
+interface CodegenConfig {
+    /** Where to write generated companion files. Default `'.lombok'`. */
+    outputDir: string;
+    /** Glob patterns for files to process. Default `['src/** /*.ts']`. */
+    include: string[];
+    /** Glob patterns for files to skip. Defaults exclude tests, `dist`, and `.lombok`. */
+    exclude: string[];
+    /** Path to the project's tsconfig. Default `'tsconfig.json'`. */
+    tsConfigPath: string;
+    /** Watch for source changes. Not implemented yet. Default `false`. */
+    watch: boolean;
+}
+/**
+ * Top-level lombok-typescript config.
+ *
+ * `backend` chooses which decorator standard to assume:
+ * - `'legacy'`: `experimentalDecorators` (NestJS / class-validator ecosystem)
+ * - `'stage3'`: Stage 3 ECMAScript decorators (TS 5.0+)
+ * - `'auto'`: detect from the project's tsconfig
+ *
+ * The `@ToString` config field is named `formatToString` (not `toString`) so it
+ * doesn't clash with `Object.prototype.toString`.
+ */
+interface LombokConfig {
+    /** Decorator backend. Default `'auto'`. */
+    backend?: BackendKind | 'auto';
+    log?: Partial<LogConfig>;
+    builder?: Partial<BuilderConfig>;
+    /** Settings for the `@ToString` decorator. */
+    formatToString?: Partial<ToStringConfig>;
+    validate?: Partial<ValidateConfig>;
+    codegen?: Partial<CodegenConfig>;
+}
+/**
+ * Identity helper that gives you autocomplete in `lombok.config.ts`.
+ *
+ * @example
+ * import { defineConfig } from 'lombok-typescript';
+ *
+ * export default defineConfig({
+ *   backend: 'legacy',
+ *   log: { provider: 'winston' },
+ *   builder: { prefix: 'with' },
+ * });
+ */
+declare function defineConfig(config: LombokConfig): LombokConfig;
+
+/**
+ * `lombok-typescript`: a TypeScript port of Project Lombok plus GoF design
+ * patterns as decorators.
+ *
+ * Sub-paths:
+ * - `lombok-typescript/legacy`: legacy `experimentalDecorators` backend
+ * - `lombok-typescript/stage3`: Stage 3 ECMAScript decorators backend
+ * - `lombok-typescript/core`: backend-agnostic primitives
+ * - `lombok-typescript/codegen`: ts-morph powered code generation
+ *
+ * @see https://github.com/A-Dev-Kit/lombok-typescript
+ */
+
+declare const VERSION = "0.1.0-pre";
+
+export { BackendKind, type BuilderConfig, type CodegenConfig, type LogConfig, type LombokConfig, type ToStringConfig, VERSION, type ValidateConfig, defineConfig };

package/dist/index.js

@@ -0,0 +1,136 @@
+// 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/core/metadata-keys.ts
+var PREFIX = "lombok-ts:";
+var MetadataKeys = {
+  // Class-level (Lombok)
+  DATA: `${PREFIX}data`,
+  VALUE: `${PREFIX}value`,
+  BUILDER: `${PREFIX}builder`,
+  TO_STRING: `${PREFIX}toString`,
+  EQUALS: `${PREFIX}equals`,
+  UTILITY_CLASS: `${PREFIX}utilityClass`,
+  FIELD_DEFAULTS: `${PREFIX}fieldDefaults`,
+  ACCESSORS: `${PREFIX}accessors`,
+  LOG: `${PREFIX}log`,
+  // Class-level (TS-only)
+  OBSERVABLE: `${PREFIX}observable`,
+  SERIALIZABLE: `${PREFIX}serializable`,
+  DEEP_FREEZE: `${PREFIX}deepFreeze`,
+  TRACE: `${PREFIX}trace`,
+  // Class-level (GoF)
+  SINGLETON: `${PREFIX}singleton`,
+  FACTORY: `${PREFIX}factory`,
+  ABSTRACT_FACTORY: `${PREFIX}abstractFactory`,
+  PROTOTYPE: `${PREFIX}prototype`,
+  ADAPTER: `${PREFIX}adapter`,
+  BRIDGE: `${PREFIX}bridge`,
+  COMPOSITE: `${PREFIX}composite`,
+  WRAPS: `${PREFIX}wraps`,
+  FACADE: `${PREFIX}facade`,
+  FLYWEIGHT: `${PREFIX}flyweight`,
+  PROXY: `${PREFIX}proxy`,
+  CHAIN_OF_RESPONSIBILITY: `${PREFIX}chainOfResponsibility`,
+  COMMAND: `${PREFIX}command`,
+  INTERPRETER: `${PREFIX}interpreter`,
+  ITERABLE: `${PREFIX}iterable`,
+  MEDIATOR: `${PREFIX}mediator`,
+  MEMENTO: `${PREFIX}memento`,
+  STATE: `${PREFIX}state`,
+  STRATEGY: `${PREFIX}strategy`,
+  TEMPLATE_METHOD: `${PREFIX}templateMethod`,
+  VISITABLE: `${PREFIX}visitable`,
+  VISITOR: `${PREFIX}visitor`,
+  // Field-level
+  GETTER: `${PREFIX}getter`,
+  SETTER: `${PREFIX}setter`,
+  NON_NULL: `${PREFIX}nonNull`,
+  WITH: `${PREFIX}with`,
+  DELEGATE: `${PREFIX}delegate`,
+  VALIDATE: `${PREFIX}validate`,
+  TO_STRING_EXCLUDE: `${PREFIX}toString:exclude`,
+  TO_STRING_INCLUDE: `${PREFIX}toString:include`,
+  EQUALS_EXCLUDE: `${PREFIX}equals:exclude`,
+  SERIALIZABLE_EXCLUDE: `${PREFIX}serializable:exclude`,
+  SERIALIZABLE_TRANSFORM: `${PREFIX}serializable:transform`,
+  SERIALIZABLE_ALIAS: `${PREFIX}serializable:alias`,
+  BUILDER_DEFAULT: `${PREFIX}builder:default`,
+  SINGULAR: `${PREFIX}singular`,
+  ITERATE_OVER: `${PREFIX}iterateOver`,
+  // Method-level
+  MEMOIZE: `${PREFIX}memoize`,
+  DEBOUNCE: `${PREFIX}debounce`,
+  THROTTLE: `${PREFIX}throttle`,
+  RETRY: `${PREFIX}retry`,
+  HANDLER: `${PREFIX}handler`,
+  TRANSITION: `${PREFIX}transition`,
+  HOOK: `${PREFIX}hook`,
+  // Parameter-level
+  NON_NULL_PARAM: `${PREFIX}nonNull:param`,
+  // Internal, framework-managed
+  FIELDS: `${PREFIX}internal:fields`,
+  CONSTRUCTOR_PARAMS: `${PREFIX}internal:constructorParams`,
+  BACKEND: `${PREFIX}internal:backend`
+};
+var METADATA_KEY_PREFIX = PREFIX;
+
+// src/config.ts
+function defineConfig(config) {
+  return config;
+}
+
+// src/index.ts
+var VERSION = "0.1.0-pre";
+
+export { METADATA_KEY_PREFIX, MetadataKeys, VERSION, WeakMapMetadataStore, defineConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/metadata-store.ts","../src/core/metadata-keys.ts","../src/config.ts","../src/index.ts"],"names":["bucket"],"mappings":"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","file":"index.js","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","/**\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 { BackendKind } from './core/types.js';\n\nexport interface LogConfig {\n  /** Logging provider. Default `'console'`. */\n  provider: 'console' | 'winston' | 'pino' | 'bunyan';\n\n  /** Default log level. Default `'info'`. */\n  defaultLevel: 'debug' | 'info' | 'warn' | 'error';\n}\n\nexport interface BuilderConfig {\n  /** Prefix for builder setter methods. Default `''` (so `name()`, not `withName()`). */\n  prefix: string;\n\n  /** Name of the build method. Default `'build'`. */\n  buildMethodName: string;\n\n  /** Name of the static builder method. Default `'builder'`. */\n  builderMethodName: string;\n}\n\nexport interface ToStringConfig {\n  /** Output format. Default `'pretty'`. */\n  format: 'pretty' | 'json' | 'compact';\n\n  /** Include the class name in output. Default `true`. */\n  includeClassName: boolean;\n}\n\nexport interface ValidateConfig {\n  /** Validation library. Default `'zod'`. */\n  provider: 'zod' | 'yup' | 'class-validator';\n\n  /** Throw on validation failure. Default `true`. */\n  throwOnError: boolean;\n}\n\nexport interface CodegenConfig {\n  /** Where to write generated companion files. Default `'.lombok'`. */\n  outputDir: string;\n\n  /** Glob patterns for files to process. Default `['src/** /*.ts']`. */\n  include: string[];\n\n  /** Glob patterns for files to skip. Defaults exclude tests, `dist`, and `.lombok`. */\n  exclude: string[];\n\n  /** Path to the project's tsconfig. Default `'tsconfig.json'`. */\n  tsConfigPath: string;\n\n  /** Watch for source changes. Not implemented yet. Default `false`. */\n  watch: boolean;\n}\n\n/**\n * Top-level lombok-typescript config.\n *\n * `backend` chooses which decorator standard to assume:\n * - `'legacy'`: `experimentalDecorators` (NestJS / class-validator ecosystem)\n * - `'stage3'`: Stage 3 ECMAScript decorators (TS 5.0+)\n * - `'auto'`: detect from the project's tsconfig\n *\n * The `@ToString` config field is named `formatToString` (not `toString`) so it\n * doesn't clash with `Object.prototype.toString`.\n */\nexport interface LombokConfig {\n  /** Decorator backend. Default `'auto'`. */\n  backend?: BackendKind | 'auto';\n\n  log?: Partial<LogConfig>;\n  builder?: Partial<BuilderConfig>;\n  /** Settings for the `@ToString` decorator. */\n  formatToString?: Partial<ToStringConfig>;\n  validate?: Partial<ValidateConfig>;\n  codegen?: Partial<CodegenConfig>;\n}\n\n/**\n * Identity helper that gives you autocomplete in `lombok.config.ts`.\n *\n * @example\n * import { defineConfig } from 'lombok-typescript';\n *\n * export default defineConfig({\n *   backend: 'legacy',\n *   log: { provider: 'winston' },\n *   builder: { prefix: 'with' },\n * });\n */\nexport function defineConfig(config: LombokConfig): LombokConfig {\n  return config;\n}\n","/**\n * `lombok-typescript`: a TypeScript port of Project Lombok plus GoF design\n * patterns as decorators.\n *\n * Sub-paths:\n * - `lombok-typescript/legacy`: legacy `experimentalDecorators` backend\n * - `lombok-typescript/stage3`: Stage 3 ECMAScript decorators backend\n * - `lombok-typescript/core`: backend-agnostic primitives\n * - `lombok-typescript/codegen`: ts-morph powered code generation\n *\n * @see https://github.com/A-Dev-Kit/lombok-typescript\n */\n\nexport type {\n  Backend,\n  MetadataStore,\n  BackendKind,\n  DecoratorKind,\n  PropertyName,\n} from './core/index.js';\nexport { MetadataKeys, METADATA_KEY_PREFIX, WeakMapMetadataStore } from './core/index.js';\nexport type { MetadataKey } from './core/index.js';\n\nexport { defineConfig } from './config.js';\nexport type {\n  LombokConfig,\n  LogConfig,\n  BuilderConfig,\n  ToStringConfig,\n  ValidateConfig,\n  CodegenConfig,\n} from './config.js';\n\nexport const VERSION = '0.1.0-pre';\n"]}

package/dist/legacy/index.cjs

@@ -0,0 +1,271 @@
+'use strict';
+
+require('reflect-metadata');
+
+// src/legacy/backend.ts
+var ReflectMetadataStore = class {
+  set(key, target, propertyKey, value) {
+    if (propertyKey === void 0) {
+      Reflect.defineMetadata(key, value, target);
+    } else {
+      Reflect.defineMetadata(key, value, target, propertyKey);
+    }
+  }
+  get(key, target, propertyKey) {
+    if (propertyKey === void 0) {
+      return Reflect.getOwnMetadata(key, target);
+    }
+    return Reflect.getOwnMetadata(key, target, propertyKey);
+  }
+  has(key, target, propertyKey) {
+    if (propertyKey === void 0) {
+      return Reflect.hasOwnMetadata(key, target);
+    }
+    return Reflect.hasOwnMetadata(key, target, propertyKey);
+  }
+  delete(key, target, propertyKey) {
+    const had = this.has(key, target, propertyKey);
+    if (!had) return false;
+    if (propertyKey === void 0) {
+      Reflect.deleteMetadata(key, target);
+    } else {
+      Reflect.deleteMetadata(key, target, propertyKey);
+    }
+    return true;
+  }
+  list(target, propertyKey) {
+    if (propertyKey === void 0) {
+      return Reflect.getOwnMetadataKeys(target).map(String);
+    }
+    return Reflect.getOwnMetadataKeys(target, propertyKey).map(String);
+  }
+};
+var LegacyBackend = class {
+  kind = "legacy";
+  metadata = new ReflectMetadataStore();
+};
+var legacyBackend = new LegacyBackend();
+
+// src/legacy/decorate.ts
+function defineClassDecorator(logic) {
+  return ((target) => logic(legacyBackend, target));
+}
+function defineFieldDecorator(logic) {
+  return ((target, propertyKey) => {
+    logic(legacyBackend, target, propertyKey);
+  });
+}
+function defineMethodDecorator(logic) {
+  return ((target, propertyKey, descriptor) => {
+    return logic(legacyBackend, target, propertyKey, descriptor);
+  });
+}
+function defineParameterDecorator(logic) {
+  return ((target, propertyKey, parameterIndex) => {
+    logic(legacyBackend, target, propertyKey, parameterIndex);
+  });
+}
+
+// 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`,
+  // Parameter-level
+  NON_NULL_PARAM: `${PREFIX}nonNull:param`};
+
+// 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 factoryClassLegacy(backend, target, key) {
+  backend.metadata.set(MetadataKeys.FACTORY, target, void 0, key);
+  registerFactory(key, target);
+}
+function codegenClassMarkerLegacy(backend, target, metadataKey) {
+  backend.metadata.set(metadataKey, target, 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 nonNullFieldLegacy(backend, targetPrototype, propertyKey) {
+  backend.metadata.set(MetadataKeys.NON_NULL, targetPrototype, propertyKey, true);
+  const key = String(propertyKey);
+  let stored;
+  Object.defineProperty(targetPrototype, propertyKey, {
+    configurable: true,
+    enumerable: true,
+    get() {
+      return stored;
+    },
+    set(value) {
+      assertNonNull(value, key);
+      stored = value;
+    }
+  });
+}
+function nonNullParameterLegacy(backend, targetPrototype, propertyKey, parameterIndex) {
+  backend.metadata.set(MetadataKeys.NON_NULL_PARAM, targetPrototype, propertyKey, parameterIndex);
+}
+
+// src/decorators/shared/singleton.ts
+function singletonClassLegacy(backend, target) {
+  backend.metadata.set(MetadataKeys.SINGLETON, target, void 0, true);
+  const Singleton2 = class extends target {
+    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 prototypeClassLegacy(backend, target) {
+  backend.metadata.set(MetadataKeys.PROTOTYPE, target, void 0, true);
+  const Prototype2 = class extends target {
+    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 memoizeMethodLegacy(backend, targetPrototype, propertyKey, descriptor, options = {}) {
+  backend.metadata.set(MetadataKeys.MEMOIZE, targetPrototype, propertyKey, options);
+  const original = descriptor.value;
+  if (typeof original !== "function") return;
+  return {
+    ...descriptor,
+    value: memoizeMethod(original, options)
+  };
+}
+
+// src/decorators/legacy/index.ts
+var NonNull = defineFieldDecorator(nonNullFieldLegacy);
+function NonNullParam() {
+  return defineParameterDecorator(nonNullParameterLegacy);
+}
+var Singleton = defineClassDecorator(singletonClassLegacy);
+var Prototype = defineClassDecorator(prototypeClassLegacy);
+function Memoize(options = {}) {
+  return defineMethodDecorator(
+    (backend, target, key, descriptor) => memoizeMethodLegacy(backend, target, key, descriptor, options)
+  );
+}
+function Factory(key) {
+  return defineClassDecorator((backend, target) => {
+    factoryClassLegacy(backend, target, key);
+  });
+}
+var Data = defineClassDecorator(
+  (backend, target) => codegenClassMarkerLegacy(backend, target, MetadataKeys.DATA)
+);
+var Builder = defineClassDecorator(
+  (backend, target) => codegenClassMarkerLegacy(backend, target, MetadataKeys.BUILDER)
+);
+var ToString = defineClassDecorator(
+  (backend, target) => codegenClassMarkerLegacy(backend, target, MetadataKeys.TO_STRING)
+);
+
+exports.Builder = Builder;
+exports.Data = Data;
+exports.Factory = Factory;
+exports.LegacyBackend = LegacyBackend;
+exports.Memoize = Memoize;
+exports.NonNull = NonNull;
+exports.NonNullParam = NonNullParam;
+exports.Prototype = Prototype;
+exports.Singleton = Singleton;
+exports.ToString = ToString;
+exports.createFromFactory = createFromFactory;
+exports.defineClassDecorator = defineClassDecorator;
+exports.defineFieldDecorator = defineFieldDecorator;
+exports.defineMethodDecorator = defineMethodDecorator;
+exports.defineParameterDecorator = defineParameterDecorator;
+exports.getFactoryRegistry = getFactoryRegistry;
+exports.legacyBackend = legacyBackend;
+exports.registerFactory = registerFactory;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/legacy/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/legacy/backend.ts","../../src/legacy/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/legacy/index.ts"],"names":["Singleton","Prototype"],"mappings":"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","file":"index.cjs","sourcesContent":["import 'reflect-metadata';\nimport type { Backend } from '../core/backend.js';\nimport type { MetadataStore } from '../core/metadata-store.js';\nimport type { MetadataKeyList, PropertyName } from '../core/types.js';\n\n/**\n * `MetadataStore` that delegates to the global `Reflect.metadata` registry from\n * `reflect-metadata`. Storage layer for the legacy `experimentalDecorators`\n * standard.\n */\nclass ReflectMetadataStore implements MetadataStore {\n  set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void {\n    if (propertyKey === undefined) {\n      Reflect.defineMetadata(key, value, target);\n    } else {\n      Reflect.defineMetadata(key, value, target, propertyKey);\n    }\n  }\n\n  get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined {\n    if (propertyKey === undefined) {\n      return Reflect.getOwnMetadata(key, target) as V | undefined;\n    }\n    return Reflect.getOwnMetadata(key, target, propertyKey) as V | undefined;\n  }\n\n  has(key: string, target: object, propertyKey?: PropertyName): boolean {\n    if (propertyKey === undefined) {\n      return Reflect.hasOwnMetadata(key, target);\n    }\n    return Reflect.hasOwnMetadata(key, target, propertyKey);\n  }\n\n  delete(key: string, target: object, propertyKey?: PropertyName): boolean {\n    const had = this.has(key, target, propertyKey);\n    if (!had) return false;\n    if (propertyKey === undefined) {\n      Reflect.deleteMetadata(key, target);\n    } else {\n      Reflect.deleteMetadata(key, target, propertyKey);\n    }\n    return true;\n  }\n\n  list(target: object, propertyKey?: PropertyName): MetadataKeyList {\n    if (propertyKey === undefined) {\n      return (Reflect.getOwnMetadataKeys(target) as PropertyName[]).map(String);\n    }\n    return (Reflect.getOwnMetadataKeys(target, propertyKey) as PropertyName[]).map(String);\n  }\n}\n\n/** Backend for the legacy `experimentalDecorators` standard. Use the singleton `legacyBackend`. */\nexport class LegacyBackend implements Backend {\n  readonly kind = 'legacy' as const;\n  readonly metadata: MetadataStore = new ReflectMetadataStore();\n}\n\n/** Shared instance. Legacy decorators rely on global metadata storage anyway. */\nexport const legacyBackend = new LegacyBackend();\n","import type { Backend } from '../core/backend.js';\nimport type { PropertyName } from '../core/types.js';\nimport { legacyBackend } from './backend.js';\n\n/** A class constructor, used in place of bare `Function` in decorator signatures. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyClass = new (...args: any[]) => any;\n\n/** Logic shapes for legacy decorator authoring. */\nexport interface ClassDecoratorLogic {\n  (backend: Backend, target: AnyClass): AnyClass | void;\n}\n\nexport interface FieldDecoratorLogic {\n  (backend: Backend, targetPrototype: object, propertyKey: PropertyName): void;\n}\n\nexport interface MethodDecoratorLogic<T = unknown> {\n  (\n    backend: Backend,\n    targetPrototype: object,\n    propertyKey: PropertyName,\n    descriptor: TypedPropertyDescriptor<T>,\n  ): TypedPropertyDescriptor<T> | void;\n}\n\nexport interface ParameterDecoratorLogic {\n  (\n    backend: Backend,\n    targetPrototype: object,\n    propertyKey: PropertyName | undefined,\n    parameterIndex: number,\n  ): void;\n}\n\n/**\n * Build a class decorator with the legacy signature. The constructor comes in\n * as `target`; an optional replacement constructor can be returned.\n *\n * @example\n * const Tracked = defineClassDecorator((backend, target) => {\n *   backend.metadata.set('tracked', target, undefined, true);\n * });\n */\nexport function defineClassDecorator(logic: ClassDecoratorLogic): ClassDecorator {\n  return ((target: AnyClass) => logic(legacyBackend, target)) as ClassDecorator;\n}\n\n/**\n * Build a field/property decorator with the legacy signature. Field decorators\n * can't return a replacement value here; use a method decorator or the codegen\n * path for that.\n */\nexport function defineFieldDecorator(logic: FieldDecoratorLogic): PropertyDecorator {\n  return ((target: object, propertyKey: string | symbol) => {\n    logic(legacyBackend, target, propertyKey);\n  }) as PropertyDecorator;\n}\n\n/** Build a method decorator with the legacy signature. */\nexport function defineMethodDecorator<T = unknown>(\n  logic: MethodDecoratorLogic<T>,\n): MethodDecorator {\n  return ((\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: TypedPropertyDescriptor<T>,\n  ) => {\n    return logic(legacyBackend, target, propertyKey, descriptor);\n  }) as MethodDecorator;\n}\n\n/** Build a parameter decorator with the legacy signature. */\nexport function defineParameterDecorator(logic: ParameterDecoratorLogic): ParameterDecorator {\n  return ((target: object, propertyKey: string | symbol | undefined, parameterIndex: number) => {\n    logic(legacyBackend, target, propertyKey, parameterIndex);\n  }) as ParameterDecorator;\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  defineParameterDecorator,\n} from '../../legacy/decorate.js';\nimport {\n  codegenClassMarkerLegacy,\n  factoryClassLegacy,\n  createFromFactory,\n  getFactoryRegistry,\n  registerFactory,\n} from '../shared/factory.js';\nimport {\n  memoizeMethodLegacy,\n  nonNullFieldLegacy,\n  nonNullParameterLegacy,\n  prototypeClassLegacy,\n  singletonClassLegacy,\n} from '../shared/index.js';\nimport type { MemoizeOptions } from '../shared/memoize.js';\n\n/** Validates field assignments are not null or undefined. */\nexport const NonNull = defineFieldDecorator(nonNullFieldLegacy);\n\n/** Validates method parameters marked with `@NonNull`. Legacy backend only. */\nexport function NonNullParam(): ParameterDecorator {\n  return defineParameterDecorator(nonNullParameterLegacy);\n}\n\n/** Ensures only one instance of the class exists. */\nexport const Singleton = defineClassDecorator(singletonClassLegacy);\n\n/** Returns a deep clone on every `new` call. */\nexport const Prototype = defineClassDecorator(prototypeClassLegacy);\n\n/** Caches method return values. Optional TTL in milliseconds. */\nexport function Memoize(options: MemoizeOptions = {}): MethodDecorator {\n  return defineMethodDecorator((backend, target, key, descriptor) =>\n    memoizeMethodLegacy(backend, target, key, descriptor, options),\n  );\n}\n\n/** Registers the class in the global factory registry under `key`. */\nexport function Factory(key: string): ClassDecorator {\n  return defineClassDecorator((backend, target) => {\n    factoryClassLegacy(backend, target, key);\n  });\n}\n\n/** Composite Lombok `@Data` — codegen generates getters, setters, toString, equals. */\nexport const Data = defineClassDecorator((backend, target) =>\n  codegenClassMarkerLegacy(backend, target, MetadataKeys.DATA),\n);\n\n/** Fluent builder — codegen generates a companion builder class. */\nexport const Builder = defineClassDecorator((backend, target) =>\n  codegenClassMarkerLegacy(backend, target, MetadataKeys.BUILDER),\n);\n\n/** Auto `toString()` — codegen generates the method body. */\nexport const ToString = defineClassDecorator((backend, target) =>\n  codegenClassMarkerLegacy(backend, target, MetadataKeys.TO_STRING),\n);\n\nexport { createFromFactory, getFactoryRegistry, registerFactory };\n"]}

package/dist/legacy/index.d.cts

@@ -0,0 +1,32 @@
+import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.cjs';
+import { M as MemoizeOptions } from '../memoize-Bj9pm_cK.cjs';
+export { C as ClassDecoratorLogic, F as FieldDecoratorLogic, a as MethodDecoratorLogic, P as ParameterDecoratorLogic, c as createFromFactory, d as defineClassDecorator, b as defineFieldDecorator, e as defineMethodDecorator, f as defineParameterDecorator, g as getFactoryRegistry, r as registerFactory } from '../memoize-Bj9pm_cK.cjs';
+
+/** Backend for the legacy `experimentalDecorators` standard. Use the singleton `legacyBackend`. */
+declare class LegacyBackend implements Backend {
+    readonly kind: "legacy";
+    readonly metadata: MetadataStore;
+}
+/** Shared instance. Legacy decorators rely on global metadata storage anyway. */
+declare const legacyBackend: LegacyBackend;
+
+/** Validates field assignments are not null or undefined. */
+declare const NonNull: PropertyDecorator;
+/** Validates method parameters marked with `@NonNull`. Legacy backend only. */
+declare function NonNullParam(): ParameterDecorator;
+/** Ensures only one instance of the class exists. */
+declare const Singleton: ClassDecorator;
+/** Returns a deep clone on every `new` call. */
+declare const Prototype: ClassDecorator;
+/** Caches method return values. Optional TTL in milliseconds. */
+declare function Memoize(options?: MemoizeOptions): MethodDecorator;
+/** Registers the class in the global factory registry under `key`. */
+declare function Factory(key: string): ClassDecorator;
+/** Composite Lombok `@Data` — codegen generates getters, setters, toString, equals. */
+declare const Data: ClassDecorator;
+/** Fluent builder — codegen generates a companion builder class. */
+declare const Builder: ClassDecorator;
+/** Auto `toString()` — codegen generates the method body. */
+declare const ToString: ClassDecorator;
+
+export { Builder, Data, Factory, LegacyBackend, Memoize, NonNull, NonNullParam, Prototype, Singleton, ToString, legacyBackend };