lombok-typescript 0.7.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 { q as AnyClass, A as AccessorsOptions, F as FieldDefaultsOptions, a as FlyweightOptions, H as HandlerOptions, L as LogOptions, M as MemoizeOptions, P as ProxyHooks, S as StateOptions, T as TransitionOptions } from '../proxy-BJ6_DDQ0.cjs';
-export { b as CommandHistory, f as StrategyRegistry, g as createFromFactory, l as getFactoryRegistry, m as getStrategyFromRegistry, n as getStrategyRegistry, o as listStrategies, r as registerFactory, p as registerStrategy } from '../proxy-BJ6_DDQ0.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+).
@@ -127,6 +127,21 @@ declare function Flyweight(options: FlyweightOptions): <T extends AnyClass>(valu
 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
@@ -149,4 +164,4 @@ declare function Proxy(hooks?: ProxyHooks): <T extends AnyClass>(value: T, conte
 /** 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, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, 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, 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 { q as AnyClass, A as AccessorsOptions, F as FieldDefaultsOptions, a as FlyweightOptions, H as HandlerOptions, L as LogOptions, M as MemoizeOptions, P as ProxyHooks, S as StateOptions, T as TransitionOptions } from '../proxy-BQ3WvvT_.js';
-export { b as CommandHistory, f as StrategyRegistry, g as createFromFactory, l as getFactoryRegistry, m as getStrategyFromRegistry, n as getStrategyRegistry, o as listStrategies, r as registerFactory, p as registerStrategy } from '../proxy-BQ3WvvT_.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+).
@@ -127,6 +127,21 @@ declare function Flyweight(options: FlyweightOptions): <T extends AnyClass>(valu
 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
@@ -149,4 +164,4 @@ declare function Proxy(hooks?: ProxyHooks): <T extends AnyClass>(value: T, conte
 /** 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, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, 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, 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,8 +101,10 @@ 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`,
@@ -112,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`,
@@ -123,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();
@@ -999,6 +1005,83 @@ function proxyClassStage3(backend, value, context, 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);
@@ -1121,12 +1204,39 @@ function Proxy2(hooks = {}) {
     (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, Composite, Data, Delegate, Equals, EqualsExclude, Factory, FieldDefaults, Flyweight, Getter, Handler, Iterable, IterateOver, Log, Memento, Memoize, NonNull, Observable, Observer, Prototype, Proxy2 as Proxy, 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