lombok-typescript 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lombok-typescript contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# lombok-typescript
+
+[![CI](https://github.com/A-Dev-Kit/lombok-typescript/actions/workflows/ci.yml/badge.svg)](https://github.com/A-Dev-Kit/lombok-typescript/actions/workflows/ci.yml)
+[![Docs](https://github.com/A-Dev-Kit/lombok-typescript/actions/workflows/docs.yml/badge.svg)](https://a-dev-kit.github.io/lombok-typescript/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/lombok-typescript.svg?label=npm)](https://www.npmjs.com/package/lombok-typescript)
+[![coverage](https://img.shields.io/codecov/c/github/A-Dev-Kit/lombok-typescript/main?label=coverage)](https://codecov.io/gh/A-Dev-Kit/lombok-typescript)
+[![Node](https://img.shields.io/badge/node-%E2%89%A522-brightgreen)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-%E2%89%A55.0-blue?logo=typescript)](https://www.typescriptlang.org/)
+
+A TypeScript port of Java's [Project Lombok](https://projectlombok.org/) with Gang-of-Four design patterns as decorators. Legacy `experimentalDecorators` and Stage 3 ECMAScript decorators are supported side-by-side.
+
+## Status
+
+**Version `0.1.0` — code-complete, not on npm yet.** Batch publish is deferred until the full release queue is ready. See [CHANGELOG.md](./CHANGELOG.md).
+
+Phase 1 decorators are implemented: `@NonNull`, `@ToString`, `@Builder`, `@Data`, `@Singleton`, `@Prototype`, `@Factory`, `@Memoize`.
+
+Documentation site: [a-dev-kit.github.io/lombok-typescript](https://a-dev-kit.github.io/lombok-typescript/) (after GitHub Pages deploy).
+
+## Install
+
+```bash
+# Not on npm yet — clone and link locally:
+git clone https://github.com/A-Dev-Kit/lombok-typescript.git
+cd lombok-typescript && pnpm install && pnpm build && pnpm link --global
+
+# When published (preview tag):
+npm install lombok-typescript@preview
+```
+
+## Pick a decorator standard
+
+### Legacy (`lombok-typescript/legacy`)
+
+For NestJS, TypeORM, and most existing decorator-based projects.
+
+```jsonc
+{ "compilerOptions": { "experimentalDecorators": true, "emitDecoratorMetadata": true } }
+```
+
+### Stage 3 (`lombok-typescript/stage3`)
+
+For TS 5.0+ projects without `experimentalDecorators`.
+
+```jsonc
+{ "compilerOptions": { "experimentalDecorators": false } }
+```
+
+## Quick start
+
+```bash
+npx lombok-ts init
+npx lombok-ts generate
+```
+
+```ts
+import { Data, Builder, NonNull, Memoize, Singleton } from 'lombok-typescript/legacy';
+
+@Data
+@Builder
+class User {
+  @NonNull name!: string;
+  age!: number;
+}
+
+@Singleton
+class Cache {
+  @Memoize()
+  get(key: string) {
+    return key;
+  }
+}
+```
+
+After codegen, import and call `applyAllGenerated` from the `.lombok/` companion file. See [docs-site/guide/getting-started.md](./docs-site/guide/getting-started.md).
+
+## CLI
+
+| Command              | Description                                   |
+| -------------------- | --------------------------------------------- |
+| `lombok-ts generate` | Emit `.lombok.ts` + `.lombok.d.ts` companions |
+| `lombok-ts init`     | Create `lombok.config.ts`                     |
+| `lombok-ts clean`    | Remove `.lombok/`, `dist/`, `coverage/`       |
+| `lombok-ts watch`    | Phase 2 stub                                  |
+
+## Examples
+
+- [examples/plain-ts](./examples/plain-ts/) — legacy backend + codegen
+- [examples/nestjs](./examples/nestjs/) — `@Injectable()` with `@Singleton`, `@Factory`, `@Memoize`
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md). Tests require **95%+** coverage on changed code.
+
+## License
+
+[MIT](./LICENSE)

package/dist/backend-CkLBcDd8.d.cts

@@ -0,0 +1,59 @@
+/** Decorator target kind. */
+type DecoratorKind = 'class' | 'field' | 'method' | 'getter' | 'setter' | 'parameter';
+/** Which decorator standard a backend implements. */
+type BackendKind = 'legacy' | 'stage3';
+/** Property identifier (string or symbol). */
+type PropertyName = string | symbol;
+/** Where metadata sits. `propertyKey` undefined means class-level. */
+interface MetadataScope {
+    readonly target: object;
+    readonly propertyKey?: PropertyName;
+}
+/** Returned from `MetadataStore.list()`. */
+type MetadataKeyList = readonly string[];
+
+/**
+ * Storage interface used by both decorator backends. Legacy delegates to
+ * `reflect-metadata`; Stage 3 uses the WeakMap implementation below.
+ */
+interface MetadataStore {
+    /** Store `value` under `key`. Omit `propertyKey` for class-level scope. */
+    set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void;
+    /** Read the value stored under `key`, or `undefined`. */
+    get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined;
+    /** True if `key` exists at the given scope. */
+    has(key: string, target: object, propertyKey?: PropertyName): boolean;
+    /** Remove the entry. Returns true if it existed. */
+    delete(key: string, target: object, propertyKey?: PropertyName): boolean;
+    /** All keys at the given scope. */
+    list(target: object, propertyKey?: PropertyName): MetadataKeyList;
+}
+/**
+ * WeakMap-backed `MetadataStore`. Used directly by the Stage 3 backend.
+ * Layout: target -> (propertyKey or class-level) -> key -> value.
+ */
+declare class WeakMapMetadataStore implements MetadataStore {
+    private readonly classScopes;
+    private readonly memberScopes;
+    set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void;
+    get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined;
+    has(key: string, target: object, propertyKey?: PropertyName): boolean;
+    delete(key: string, target: object, propertyKey?: PropertyName): boolean;
+    list(target: object, propertyKey?: PropertyName): MetadataKeyList;
+    private bucket;
+}
+
+/**
+ * Abstraction over a TypeScript decorator standard.
+ *
+ * Two implementations: `LegacyBackend` (wraps `reflect-metadata` for
+ * `experimentalDecorators`) and `Stage3Backend` (uses `Symbol.metadata`).
+ * Decorator authors target this interface so the same logic can be exposed
+ * under both standards.
+ */
+interface Backend {
+    readonly kind: BackendKind;
+    readonly metadata: MetadataStore;
+}
+
+export { type BackendKind as B, type DecoratorKind as D, type MetadataStore as M, type PropertyName as P, WeakMapMetadataStore as W, type Backend as a, type MetadataKeyList as b, type MetadataScope as c };

package/dist/backend-CkLBcDd8.d.ts

@@ -0,0 +1,59 @@
+/** Decorator target kind. */
+type DecoratorKind = 'class' | 'field' | 'method' | 'getter' | 'setter' | 'parameter';
+/** Which decorator standard a backend implements. */
+type BackendKind = 'legacy' | 'stage3';
+/** Property identifier (string or symbol). */
+type PropertyName = string | symbol;
+/** Where metadata sits. `propertyKey` undefined means class-level. */
+interface MetadataScope {
+    readonly target: object;
+    readonly propertyKey?: PropertyName;
+}
+/** Returned from `MetadataStore.list()`. */
+type MetadataKeyList = readonly string[];
+
+/**
+ * Storage interface used by both decorator backends. Legacy delegates to
+ * `reflect-metadata`; Stage 3 uses the WeakMap implementation below.
+ */
+interface MetadataStore {
+    /** Store `value` under `key`. Omit `propertyKey` for class-level scope. */
+    set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void;
+    /** Read the value stored under `key`, or `undefined`. */
+    get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined;
+    /** True if `key` exists at the given scope. */
+    has(key: string, target: object, propertyKey?: PropertyName): boolean;
+    /** Remove the entry. Returns true if it existed. */
+    delete(key: string, target: object, propertyKey?: PropertyName): boolean;
+    /** All keys at the given scope. */
+    list(target: object, propertyKey?: PropertyName): MetadataKeyList;
+}
+/**
+ * WeakMap-backed `MetadataStore`. Used directly by the Stage 3 backend.
+ * Layout: target -> (propertyKey or class-level) -> key -> value.
+ */
+declare class WeakMapMetadataStore implements MetadataStore {
+    private readonly classScopes;
+    private readonly memberScopes;
+    set<V>(key: string, target: object, propertyKey: PropertyName | undefined, value: V): void;
+    get<V>(key: string, target: object, propertyKey?: PropertyName): V | undefined;
+    has(key: string, target: object, propertyKey?: PropertyName): boolean;
+    delete(key: string, target: object, propertyKey?: PropertyName): boolean;
+    list(target: object, propertyKey?: PropertyName): MetadataKeyList;
+    private bucket;
+}
+
+/**
+ * Abstraction over a TypeScript decorator standard.
+ *
+ * Two implementations: `LegacyBackend` (wraps `reflect-metadata` for
+ * `experimentalDecorators`) and `Stage3Backend` (uses `Symbol.metadata`).
+ * Decorator authors target this interface so the same logic can be exposed
+ * under both standards.
+ */
+interface Backend {
+    readonly kind: BackendKind;
+    readonly metadata: MetadataStore;
+}
+
+export { type BackendKind as B, type DecoratorKind as D, type MetadataStore as M, type PropertyName as P, WeakMapMetadataStore as W, type Backend as a, type MetadataKeyList as b, type MetadataScope as c };