lombok-typescript 0.6.0 → 0.8.0

package/dist/stage3/index.d.cts

@@ -1,6 +1,6 @@
 import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.cjs';
-import { o as AnyClass, 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 { a as CommandHistory, d as StrategyRegistry, e as createFromFactory, 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 { d as AnyClass, 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 } from '../visitor-B5ByGIWE.cjs';
+export { e as CommandHistory, i as StrategyRegistry, j as createFromFactory, 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 Stage 3 ECMAScript decorator standard (TS 5.0+).
@@ -121,6 +121,27 @@ declare function Handler(options: HandlerOptions): (value: (this: unknown, ...ar
 declare const Iterable: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
 /** Marks the collection field iterated by `@Iterable`. */
 declare const IterateOver: <This, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void | ((this: This, initialValue: Value) => Value);
+/** Shared instance pool keyed by constructor arguments. */
+declare function Flyweight(options: FlyweightOptions): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Tree composite API — add, remove, traverse children. */
+declare const Composite: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Runtime method interception via Proxy. */
+declare function Proxy(hooks?: ProxyHooks): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/**
+ * GoF Decorator — wraps an inner instance as `protected inner`.
+ * @see GoF Decorator Pattern (ADR-15)
+ */
+declare function Wraps(InnerClass: AnyClass): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Codegen template method with ordered `@Hook` steps. */
+declare function TemplateMethod(options: TemplateMethodOptions): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Marks a method as a template hook step. */
+declare function Hook(options?: Partial<HookOptions>): (value: (this: unknown, ...args: unknown[]) => unknown, context: ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>) => void | ((this: unknown, ...args: unknown[]) => unknown);
+/** Helper scaffold — codegen emits abstract product factory methods. */
+declare function AbstractFactory(products: string[]): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Double-dispatch visitor — calls `visit{ClassName}` on the visitor. */
+declare function Visitor(options: VisitorOptions): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Registers a node type for visitor dispatch. */
+declare const Visitable: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
 
 /**
  * Stage 3 decorator backend, for the modern ECMAScript decorator standard
@@ -143,4 +164,4 @@ declare const IterateOver: <This, Value>(_value: undefined, context: ClassFieldD
 /** Read the Stage 3 `Symbol.metadata` object from a class, if present. */
 declare function getClassMetadata(cls: new (...args: any[]) => any): object | undefined;
 
-export { Accessors, Builder, ChainOfResponsibility, Command, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Getter, Handler, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Setter, Singleton, Stage3Backend, type Stage3ClassLogic, type Stage3FieldLogic, type Stage3GetterLogic, type Stage3MethodLogic, type Stage3SetterLogic, State, Strategy, ToString, Transition, UtilityClass, Value, With, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, stage3Backend };
+export { AbstractFactory, Accessors, Builder, ChainOfResponsibility, Command, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Hook, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Proxy, Setter, Singleton, Stage3Backend, type Stage3ClassLogic, type Stage3FieldLogic, type Stage3GetterLogic, type Stage3MethodLogic, type Stage3SetterLogic, State, Strategy, TemplateMethod, ToString, Transition, UtilityClass, Value, Visitable, Visitor, With, Wraps, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, stage3Backend };

package/dist/stage3/index.d.ts

@@ -1,6 +1,6 @@
 import { a as Backend, M as MetadataStore } from '../backend-CkLBcDd8.js';
-import { o as AnyClass, 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 { a as CommandHistory, d as StrategyRegistry, e as createFromFactory, 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 { d as AnyClass, 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 } from '../visitor-BqARKwCX.js';
+export { e as CommandHistory, i as StrategyRegistry, j as createFromFactory, 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 Stage 3 ECMAScript decorator standard (TS 5.0+).
@@ -121,6 +121,27 @@ declare function Handler(options: HandlerOptions): (value: (this: unknown, ...ar
 declare const Iterable: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
 /** Marks the collection field iterated by `@Iterable`. */
 declare const IterateOver: <This, Value>(_value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void | ((this: This, initialValue: Value) => Value);
+/** Shared instance pool keyed by constructor arguments. */
+declare function Flyweight(options: FlyweightOptions): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Tree composite API — add, remove, traverse children. */
+declare const Composite: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Runtime method interception via Proxy. */
+declare function Proxy(hooks?: ProxyHooks): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/**
+ * GoF Decorator — wraps an inner instance as `protected inner`.
+ * @see GoF Decorator Pattern (ADR-15)
+ */
+declare function Wraps(InnerClass: AnyClass): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Codegen template method with ordered `@Hook` steps. */
+declare function TemplateMethod(options: TemplateMethodOptions): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Marks a method as a template hook step. */
+declare function Hook(options?: Partial<HookOptions>): (value: (this: unknown, ...args: unknown[]) => unknown, context: ClassMethodDecoratorContext<unknown, (this: unknown, ...args: unknown[]) => unknown>) => void | ((this: unknown, ...args: unknown[]) => unknown);
+/** Helper scaffold — codegen emits abstract product factory methods. */
+declare function AbstractFactory(products: string[]): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Double-dispatch visitor — calls `visit{ClassName}` on the visitor. */
+declare function Visitor(options: VisitorOptions): <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
+/** Registers a node type for visitor dispatch. */
+declare const Visitable: <T extends AnyClass>(value: T, context: ClassDecoratorContext) => T | void;
 
 /**
  * Stage 3 decorator backend, for the modern ECMAScript decorator standard
@@ -143,4 +164,4 @@ declare const IterateOver: <This, Value>(_value: undefined, context: ClassFieldD
 /** Read the Stage 3 `Symbol.metadata` object from a class, if present. */
 declare function getClassMetadata(cls: new (...args: any[]) => any): object | undefined;
 
-export { Accessors, Builder, ChainOfResponsibility, Command, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Getter, Handler, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Setter, Singleton, Stage3Backend, type Stage3ClassLogic, type Stage3FieldLogic, type Stage3GetterLogic, type Stage3MethodLogic, type Stage3SetterLogic, State, Strategy, ToString, Transition, UtilityClass, Value, With, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, stage3Backend };
+export { AbstractFactory, Accessors, Builder, ChainOfResponsibility, Command, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Hook, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Proxy, Setter, Singleton, Stage3Backend, type Stage3ClassLogic, type Stage3FieldLogic, type Stage3GetterLogic, type Stage3MethodLogic, type Stage3SetterLogic, State, Strategy, TemplateMethod, ToString, Transition, UtilityClass, Value, Visitable, Visitor, With, Wraps, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, stage3Backend };

package/dist/stage3/index.js

@@ -101,7 +101,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`,
@@ -109,6 +114,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`,
@@ -120,7 +128,8 @@ var MetadataKeys = {
   // Method-level
   MEMOIZE: `${PREFIX}memoize`,
   HANDLER: `${PREFIX}handler`,
-  TRANSITION: `${PREFIX}transition`};
+  TRANSITION: `${PREFIX}transition`,
+  HOOK: `${PREFIX}hook`};
 
 // src/decorators/shared/factory.ts
 var factoryRegistry = /* @__PURE__ */ new Map();
@@ -874,6 +883,205 @@ function iterateOverFieldStage3(backend, context) {
   registerStage3IterateField(context.metadata, context.name);
 }
 
+// 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 flyweightClassStage3(backend, value, context, options) {
+  if (typeof options?.key !== "function") {
+    throw new Error("@Flyweight requires a `key` function in options");
+  }
+  backend.metadata.set(MetadataKeys.FLYWEIGHT, context.metadata, void 0, options);
+  return wrapFlyweightClass(value, 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 compositeClassStage3(backend, value, context) {
+  backend.metadata.set(MetadataKeys.COMPOSITE, context.metadata, void 0, true);
+  return wrapCompositeClass(value);
+}
+
+// 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 proxyClassStage3(backend, value, context, hooks = {}) {
+  backend.metadata.set(MetadataKeys.PROXY, context.metadata, void 0, hooks);
+  return wrapProxyClass(value, 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 wrapsClassStage3(backend, value, context, InnerClass) {
+  backend.metadata.set(MetadataKeys.WRAPS, context.metadata, void 0, InnerClass);
+  return wrapWrapsClass(value, InnerClass);
+}
+
+// src/decorators/shared/template-method.ts
+function templateMethodClassStage3(backend, _value, context, 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,
+    context.metadata,
+    void 0,
+    options
+  );
+}
+
+// src/decorators/shared/hook.ts
+function hookMethodStage3(backend, _value, context, options) {
+  backend.metadata.set(MetadataKeys.HOOK, context.metadata, context.name, 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 abstractFactoryClassStage3(backend, _value, context, productsOrOptions) {
+  const products = normalizeProducts(productsOrOptions);
+  backend.metadata.set(MetadataKeys.ABSTRACT_FACTORY, context.metadata, 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 visitorClassStage3(backend, _value, context, options) {
+  if (!options?.visitMethods || typeof options.visitMethods !== "object") {
+    throw new Error("@Visitor requires a `visitMethods` map");
+  }
+  backend.metadata.set(MetadataKeys.VISITOR, context.metadata, void 0, options);
+}
+function visitableClassStage3(backend, value, context, options = {}) {
+  backend.metadata.set(MetadataKeys.VISITABLE, context.metadata, void 0, options);
+  registerVisitable(value.name, value);
+}
+
 // src/decorators/stage3/index.ts
 var NonNull = defineFieldDecorator(nonNullFieldStage3);
 var Singleton = defineClassDecorator(singletonClassStage3);
@@ -985,12 +1193,50 @@ function Handler(options) {
 }
 var Iterable = defineClassDecorator(iterableClassStage3);
 var IterateOver = defineFieldDecorator(iterateOverFieldStage3);
+function Flyweight(options) {
+  return defineClassDecorator(
+    (backend, value, context) => flyweightClassStage3(backend, value, context, options)
+  );
+}
+var Composite = defineClassDecorator(compositeClassStage3);
+function Proxy2(hooks = {}) {
+  return defineClassDecorator(
+    (backend, value, context) => proxyClassStage3(backend, value, context, hooks)
+  );
+}
+function Wraps(InnerClass) {
+  return defineClassDecorator(
+    (backend, value, context) => wrapsClassStage3(backend, value, context, InnerClass)
+  );
+}
+function TemplateMethod(options) {
+  return defineClassDecorator(
+    (backend, value, context) => templateMethodClassStage3(backend, value, context, options)
+  );
+}
+function Hook(options) {
+  return defineMethodDecorator((backend, value, context) => {
+    const name = options?.name ?? String(context.name);
+    hookMethodStage3(backend, value, context, { name });
+  });
+}
+function AbstractFactory(products) {
+  return defineClassDecorator(
+    (backend, value, context) => abstractFactoryClassStage3(backend, value, context, products)
+  );
+}
+function Visitor(options) {
+  return defineClassDecorator(
+    (backend, value, context) => visitorClassStage3(backend, value, context, options)
+  );
+}
+var Visitable = defineClassDecorator(visitableClassStage3);
 
 // src/stage3/index.ts
 function getClassMetadata(cls) {
   return cls[Symbol.metadata];
 }
 
-export { Accessors, Builder, ChainOfResponsibility, Command, CommandHistory, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Getter, Handler, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Setter, Singleton, Stage3Backend, State, Strategy, StrategyRegistry, ToString, Transition, UtilityClass, Value, With, createFromFactory, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, getFactoryRegistry, getStrategyFromRegistry, getStrategyRegistry, listStrategies, registerFactory, registerStrategy, stage3Backend };
+export { AbstractFactory, Accessors, Builder, ChainOfResponsibility, Command, CommandHistory, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Hook, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Proxy2 as Proxy, Setter, Singleton, Stage3Backend, State, Strategy, StrategyRegistry, TemplateMethod, ToString, Transition, UtilityClass, Value, Visitable, Visitor, With, Wraps, createFromFactory, defineClassDecorator, defineFieldDecorator, defineGetterDecorator, defineMethodDecorator, defineSetterDecorator, getClassMetadata, getFactoryRegistry, getStrategyFromRegistry, getStrategyRegistry, getVisitableRegistry, listStrategies, registerFactory, registerStrategy, stage3Backend };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map