lombok-typescript 0.6.0 → 0.8.0

package/dist/legacy/index.d.cts

@@ -1,6 +1,6 @@
 import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.cjs';
-import { A as AccessorsOptions, F as FieldDefaultsOptions, H as HandlerOptions, L as LogOptions, M as MemoizeOptions, S as StateOptions, T as TransitionOptions } from '../chain-of-responsibility-CQ7votcC.cjs';
-export { C as ClassDecoratorLogic, a as CommandHistory, b as FieldDecoratorLogic, c as MethodDecoratorLogic, P as ParameterDecoratorLogic, d as StrategyRegistry, e as createFromFactory, f as defineClassDecorator, g as defineFieldDecorator, h as defineMethodDecorator, i as defineParameterDecorator, j as getFactoryRegistry, k as getStrategyFromRegistry, l as getStrategyRegistry, m as listStrategies, r as registerFactory, n as registerStrategy } from '../chain-of-responsibility-CQ7votcC.cjs';
+import { A as AccessorsOptions, F as FieldDefaultsOptions, a as FlyweightOptions, H as HandlerOptions, b as HookOptions, L as LogOptions, M as MemoizeOptions, P as ProxyHooks, S as StateOptions, T as TemplateMethodOptions, c as TransitionOptions, V as VisitorOptions, d as AnyClass } from '../visitor-B5ByGIWE.cjs';
+export { C as ClassDecoratorLogic, e as CommandHistory, f as FieldDecoratorLogic, g as MethodDecoratorLogic, h as ParameterDecoratorLogic, i as StrategyRegistry, j as createFromFactory, k as defineClassDecorator, l as defineFieldDecorator, m as defineMethodDecorator, n as defineParameterDecorator, o as getFactoryRegistry, p as getStrategyFromRegistry, q as getStrategyRegistry, r as getVisitableRegistry, s as listStrategies, t as registerFactory, u as registerStrategy } from '../visitor-B5ByGIWE.cjs';
 
 /** Backend for the legacy `experimentalDecorators` standard. Use the singleton `legacyBackend`. */
 declare class LegacyBackend implements Backend {
@@ -75,5 +75,26 @@ declare function Handler(options: HandlerOptions): MethodDecorator;
 declare const Iterable: ClassDecorator;
 /** Marks the collection field iterated by `@Iterable`. */
 declare const IterateOver: PropertyDecorator;
+/** Shared instance pool keyed by constructor arguments. */
+declare function Flyweight(options: FlyweightOptions): ClassDecorator;
+/** Tree composite API — add, remove, traverse children. */
+declare const Composite: ClassDecorator;
+/** Runtime method interception via Proxy. */
+declare function Proxy(hooks?: ProxyHooks): ClassDecorator;
+/**
+ * GoF Decorator — wraps an inner instance as `protected inner`.
+ * @see GoF Decorator Pattern (ADR-15)
+ */
+declare function Wraps(InnerClass: AnyClass): ClassDecorator;
+/** Codegen template method with ordered `@Hook` steps. */
+declare function TemplateMethod(options: TemplateMethodOptions): ClassDecorator;
+/** Marks a method as a template hook step. */
+declare function Hook(options?: Partial<HookOptions>): MethodDecorator;
+/** Helper scaffold — codegen emits abstract product factory methods. */
+declare function AbstractFactory(products: string[]): ClassDecorator;
+/** Double-dispatch visitor — calls `visit{ClassName}` on the visitor. */
+declare function Visitor(options: VisitorOptions): ClassDecorator;
+/** Registers a node type for visitor dispatch. */
+declare const Visitable: ClassDecorator;
 
-export { Accessors, Builder, ChainOfResponsibility, Command, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Getter, Handler, Iterable, IterateOver, LegacyBackend, Log, Memento, Memoize, NonNull, NonNullParam, Observable, Observer, Prototype, Setter, Singleton, State, Strategy, ToString, Transition, UtilityClass, Value, With, legacyBackend };
+export { AbstractFactory, Accessors, Builder, ChainOfResponsibility, Command, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Hook, Iterable, IterateOver, LegacyBackend, Log, Memento, Memoize, NonNull, NonNullParam, Observable, Observer, Prototype, Proxy, Setter, Singleton, State, Strategy, TemplateMethod, ToString, Transition, UtilityClass, Value, Visitable, Visitor, With, Wraps, legacyBackend };

package/dist/legacy/index.d.ts

@@ -1,6 +1,6 @@
 import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.js';
-import { A as AccessorsOptions, F as FieldDefaultsOptions, H as HandlerOptions, L as LogOptions, M as MemoizeOptions, S as StateOptions, T as TransitionOptions } from '../chain-of-responsibility-Dwsaoe4x.js';
-export { C as ClassDecoratorLogic, a as CommandHistory, b as FieldDecoratorLogic, c as MethodDecoratorLogic, P as ParameterDecoratorLogic, d as StrategyRegistry, e as createFromFactory, f as defineClassDecorator, g as defineFieldDecorator, h as defineMethodDecorator, i as defineParameterDecorator, j as getFactoryRegistry, k as getStrategyFromRegistry, l as getStrategyRegistry, m as listStrategies, r as registerFactory, n as registerStrategy } from '../chain-of-responsibility-Dwsaoe4x.js';
+import { A as AccessorsOptions, F as FieldDefaultsOptions, a as FlyweightOptions, H as HandlerOptions, b as HookOptions, L as LogOptions, M as MemoizeOptions, P as ProxyHooks, S as StateOptions, T as TemplateMethodOptions, c as TransitionOptions, V as VisitorOptions, d as AnyClass } from '../visitor-BqARKwCX.js';
+export { C as ClassDecoratorLogic, e as CommandHistory, f as FieldDecoratorLogic, g as MethodDecoratorLogic, h as ParameterDecoratorLogic, i as StrategyRegistry, j as createFromFactory, k as defineClassDecorator, l as defineFieldDecorator, m as defineMethodDecorator, n as defineParameterDecorator, o as getFactoryRegistry, p as getStrategyFromRegistry, q as getStrategyRegistry, r as getVisitableRegistry, s as listStrategies, t as registerFactory, u as registerStrategy } from '../visitor-BqARKwCX.js';
 
 /** Backend for the legacy `experimentalDecorators` standard. Use the singleton `legacyBackend`. */
 declare class LegacyBackend implements Backend {
@@ -75,5 +75,26 @@ declare function Handler(options: HandlerOptions): MethodDecorator;
 declare const Iterable: ClassDecorator;
 /** Marks the collection field iterated by `@Iterable`. */
 declare const IterateOver: PropertyDecorator;
+/** Shared instance pool keyed by constructor arguments. */
+declare function Flyweight(options: FlyweightOptions): ClassDecorator;
+/** Tree composite API — add, remove, traverse children. */
+declare const Composite: ClassDecorator;
+/** Runtime method interception via Proxy. */
+declare function Proxy(hooks?: ProxyHooks): ClassDecorator;
+/**
+ * GoF Decorator — wraps an inner instance as `protected inner`.
+ * @see GoF Decorator Pattern (ADR-15)
+ */
+declare function Wraps(InnerClass: AnyClass): ClassDecorator;
+/** Codegen template method with ordered `@Hook` steps. */
+declare function TemplateMethod(options: TemplateMethodOptions): ClassDecorator;
+/** Marks a method as a template hook step. */
+declare function Hook(options?: Partial<HookOptions>): MethodDecorator;
+/** Helper scaffold — codegen emits abstract product factory methods. */
+declare function AbstractFactory(products: string[]): ClassDecorator;
+/** Double-dispatch visitor — calls `visit{ClassName}` on the visitor. */
+declare function Visitor(options: VisitorOptions): ClassDecorator;
+/** Registers a node type for visitor dispatch. */
+declare const Visitable: ClassDecorator;
 
-export { Accessors, Builder, ChainOfResponsibility, Command, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Getter, Handler, Iterable, IterateOver, LegacyBackend, Log, Memento, Memoize, NonNull, NonNullParam, Observable, Observer, Prototype, Setter, Singleton, State, Strategy, ToString, Transition, UtilityClass, Value, With, legacyBackend };
+export { AbstractFactory, Accessors, Builder, ChainOfResponsibility, Command, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Hook, Iterable, IterateOver, LegacyBackend, Log, Memento, Memoize, NonNull, NonNullParam, Observable, Observer, Prototype, Proxy, Setter, Singleton, State, Strategy, TemplateMethod, ToString, Transition, UtilityClass, Value, Visitable, Visitor, With, Wraps, legacyBackend };

package/dist/legacy/index.js

@@ -82,7 +82,12 @@ var MetadataKeys = {
   // Class-level (GoF)
   SINGLETON: `${PREFIX}singleton`,
   FACTORY: `${PREFIX}factory`,
+  ABSTRACT_FACTORY: `${PREFIX}abstractFactory`,
   PROTOTYPE: `${PREFIX}prototype`,
+  COMPOSITE: `${PREFIX}composite`,
+  WRAPS: `${PREFIX}wraps`,
+  FLYWEIGHT: `${PREFIX}flyweight`,
+  PROXY: `${PREFIX}proxy`,
   CHAIN_OF_RESPONSIBILITY: `${PREFIX}chainOfResponsibility`,
   COMMAND: `${PREFIX}command`,
   ITERABLE: `${PREFIX}iterable`,
@@ -90,6 +95,9 @@ var MetadataKeys = {
   MEMENTO_EXCLUDE: `${PREFIX}memento:exclude`,
   STATE: `${PREFIX}state`,
   STRATEGY: `${PREFIX}strategy`,
+  TEMPLATE_METHOD: `${PREFIX}templateMethod`,
+  VISITABLE: `${PREFIX}visitable`,
+  VISITOR: `${PREFIX}visitor`,
   // Field-level
   GETTER: `${PREFIX}getter`,
   SETTER: `${PREFIX}setter`,
@@ -102,6 +110,7 @@ var MetadataKeys = {
   MEMOIZE: `${PREFIX}memoize`,
   HANDLER: `${PREFIX}handler`,
   TRANSITION: `${PREFIX}transition`,
+  HOOK: `${PREFIX}hook`,
   // Parameter-level
   NON_NULL_PARAM: `${PREFIX}nonNull:param`};
 
@@ -847,6 +856,198 @@ function iterateOverFieldLegacy(backend, targetPrototype, propertyKey) {
   registerLegacyIterateField(targetPrototype, propertyKey);
 }
 
+// src/decorators/shared/flyweight.ts
+var pools = /* @__PURE__ */ new WeakMap();
+function getPool(ctor) {
+  let pool = pools.get(ctor);
+  if (!pool) {
+    pool = /* @__PURE__ */ new Map();
+    pools.set(ctor, pool);
+  }
+  return pool;
+}
+function wrapFlyweightClass(target, options) {
+  const pool = getPool(target);
+  const FlyweightClass = class extends target {
+    constructor(...args) {
+      const key = options.key(...args);
+      const existing = pool.get(key);
+      if (existing) {
+        return existing;
+      }
+      super(...args);
+      pool.set(key, this);
+    }
+  };
+  return FlyweightClass;
+}
+function flyweightClassLegacy(backend, target, options) {
+  if (typeof options?.key !== "function") {
+    throw new Error("@Flyweight requires a `key` function in options");
+  }
+  backend.metadata.set(MetadataKeys.FLYWEIGHT, target, void 0, options);
+  return wrapFlyweightClass(target, options);
+}
+
+// src/decorators/shared/composite.ts
+var CHILDREN = /* @__PURE__ */ Symbol("lombok-ts:composite-children");
+function getChildren(instance) {
+  const bag = instance;
+  if (!bag[CHILDREN]) {
+    bag[CHILDREN] = [];
+  }
+  return bag[CHILDREN];
+}
+function wrapCompositeClass(target) {
+  const CompositeClass = class extends target {
+    add(child) {
+      getChildren(this).push(child);
+    }
+    remove(child) {
+      const children = getChildren(this);
+      const index = children.indexOf(child);
+      if (index >= 0) {
+        children.splice(index, 1);
+      }
+    }
+    getChild(index) {
+      const children = getChildren(this);
+      const child = children[index];
+      if (child === void 0) {
+        throw new RangeError(`@Composite: no child at index ${index}`);
+      }
+      return child;
+    }
+    getChildren() {
+      return [...getChildren(this)];
+    }
+    traverse(callback) {
+      const visit = (node) => {
+        callback(node);
+        for (const child of getChildren(node)) {
+          visit(child);
+        }
+      };
+      visit(this);
+    }
+    *[Symbol.iterator]() {
+      yield* getChildren(this);
+    }
+  };
+  return CompositeClass;
+}
+function compositeClassLegacy(backend, target) {
+  backend.metadata.set(MetadataKeys.COMPOSITE, target, void 0, true);
+  return wrapCompositeClass(target);
+}
+
+// src/decorators/shared/proxy.ts
+function isMethod(key, value) {
+  return typeof key === "string" && key !== "constructor" && typeof value === "function";
+}
+function wrapProxyInstance(instance, hooks) {
+  const proto = Object.getPrototypeOf(instance);
+  return new Proxy(instance, {
+    get(target, prop, receiver) {
+      const value = Reflect.get(target, prop, receiver);
+      if (!isMethod(prop, value)) {
+        return value;
+      }
+      const original = Object.getOwnPropertyDescriptor(proto, prop)?.value ?? value;
+      return (...args) => {
+        const methodName = String(prop);
+        hooks.before?.(methodName, args);
+        const result = original.apply(target, args);
+        hooks.after?.(methodName, result);
+        return result;
+      };
+    }
+  });
+}
+function wrapProxyClass(target, hooks) {
+  const ProxyClass = class extends target {
+    constructor(...args) {
+      super(...args);
+      return wrapProxyInstance(this, hooks);
+    }
+  };
+  return ProxyClass;
+}
+function proxyClassLegacy(backend, target, hooks = {}) {
+  backend.metadata.set(MetadataKeys.PROXY, target, void 0, hooks);
+  return wrapProxyClass(target, hooks);
+}
+
+// src/decorators/shared/wraps.ts
+var INNER = /* @__PURE__ */ Symbol("lombok-ts:wraps-inner");
+function wrapWrapsClass(target, InnerClass) {
+  if (typeof InnerClass !== "function") {
+    throw new TypeError("@Wraps requires a constructor function");
+  }
+  const WrapsClass = class extends target {
+    inner;
+    constructor(...args) {
+      super();
+      const inner = args[0];
+      if (inner === void 0 || !(inner instanceof InnerClass)) {
+        throw new TypeError(`@Wraps(${InnerClass.name}) expects an instance as the first argument`);
+      }
+      this.inner = inner;
+      this[INNER] = inner;
+    }
+  };
+  return WrapsClass;
+}
+function wrapsClassLegacy(backend, target, InnerClass) {
+  backend.metadata.set(MetadataKeys.WRAPS, target, void 0, InnerClass);
+  return wrapWrapsClass(target, InnerClass);
+}
+
+// src/decorators/shared/template-method.ts
+function templateMethodClassLegacy(backend, target, options) {
+  if (!Array.isArray(options?.steps) || options.steps.length === 0) {
+    throw new Error("@TemplateMethod requires a non-empty `steps` array");
+  }
+  backend.metadata.set(MetadataKeys.TEMPLATE_METHOD, target, void 0, options);
+}
+
+// src/decorators/shared/hook.ts
+function hookMethodLegacy(backend, targetPrototype, propertyKey, options) {
+  backend.metadata.set(MetadataKeys.HOOK, targetPrototype, propertyKey, options);
+}
+
+// src/decorators/shared/abstract-factory.ts
+function normalizeProducts(productsOrOptions) {
+  const products = Array.isArray(productsOrOptions) ? productsOrOptions : productsOrOptions.products;
+  if (!Array.isArray(products) || products.length === 0) {
+    throw new Error("@AbstractFactory requires a non-empty product list");
+  }
+  return products;
+}
+function abstractFactoryClassLegacy(backend, target, productsOrOptions) {
+  const products = normalizeProducts(productsOrOptions);
+  backend.metadata.set(MetadataKeys.ABSTRACT_FACTORY, target, void 0, { products });
+}
+
+// src/decorators/shared/visitor.ts
+var visitableRegistry = /* @__PURE__ */ new Map();
+function registerVisitable(name, ctor) {
+  visitableRegistry.set(name, ctor);
+}
+function getVisitableRegistry() {
+  return visitableRegistry;
+}
+function visitorClassLegacy(backend, target, options) {
+  if (!options?.visitMethods || typeof options.visitMethods !== "object") {
+    throw new Error("@Visitor requires a `visitMethods` map");
+  }
+  backend.metadata.set(MetadataKeys.VISITOR, target, void 0, options);
+}
+function visitableClassLegacy(backend, target, options = {}) {
+  backend.metadata.set(MetadataKeys.VISITABLE, target, void 0, options);
+  registerVisitable(target.name, target);
+}
+
 // src/decorators/legacy/index.ts
 var NonNull = defineFieldDecorator(nonNullFieldLegacy);
 function NonNullParam() {
@@ -952,7 +1153,37 @@ function Handler(options) {
 }
 var Iterable = defineClassDecorator(iterableClassLegacy);
 var IterateOver = defineFieldDecorator(iterateOverFieldLegacy);
+function Flyweight(options) {
+  return defineClassDecorator((backend, target) => flyweightClassLegacy(backend, target, options));
+}
+var Composite = defineClassDecorator(compositeClassLegacy);
+function Proxy2(hooks = {}) {
+  return defineClassDecorator((backend, target) => proxyClassLegacy(backend, target, hooks));
+}
+function Wraps(InnerClass) {
+  return defineClassDecorator((backend, target) => wrapsClassLegacy(backend, target, InnerClass));
+}
+function TemplateMethod(options) {
+  return defineClassDecorator(
+    (backend, target) => templateMethodClassLegacy(backend, target, options)
+  );
+}
+function Hook(options) {
+  return defineMethodDecorator((backend, target, key) => {
+    const name = options?.name ?? String(key);
+    hookMethodLegacy(backend, target, key, { name });
+  });
+}
+function AbstractFactory(products) {
+  return defineClassDecorator(
+    (backend, target) => abstractFactoryClassLegacy(backend, target, products)
+  );
+}
+function Visitor(options) {
+  return defineClassDecorator((backend, target) => visitorClassLegacy(backend, target, options));
+}
+var Visitable = defineClassDecorator(visitableClassLegacy);
 
-export { Accessors, Builder, ChainOfResponsibility, Command, CommandHistory, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Getter, Handler, Iterable, IterateOver, LegacyBackend, Log, Memento, Memoize, NonNull, NonNullParam, Observable, Observer, Prototype, Setter, Singleton, State, Strategy, StrategyRegistry, ToString, Transition, UtilityClass, Value, With, createFromFactory, defineClassDecorator, defineFieldDecorator, defineMethodDecorator, defineParameterDecorator, getFactoryRegistry, getStrategyFromRegistry, getStrategyRegistry, legacyBackend, listStrategies, registerFactory, registerStrategy };
+export { AbstractFactory, Accessors, Builder, ChainOfResponsibility, Command, CommandHistory, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Hook, Iterable, IterateOver, LegacyBackend, Log, Memento, Memoize, NonNull, NonNullParam, Observable, Observer, Prototype, Proxy2 as Proxy, Setter, Singleton, State, Strategy, StrategyRegistry, TemplateMethod, ToString, Transition, UtilityClass, Value, Visitable, Visitor, With, Wraps, createFromFactory, defineClassDecorator, defineFieldDecorator, defineMethodDecorator, defineParameterDecorator, getFactoryRegistry, getStrategyFromRegistry, getStrategyRegistry, getVisitableRegistry, legacyBackend, listStrategies, registerFactory, registerStrategy };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map