1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
//! # Debug Macro Implementation
//!
//! The `Debug` macro generates a human-readable `toString()` method for
//! TypeScript classes, interfaces, enums, and type aliases.
//!
//! ## Generated Output
//!
//! **Classes**: Generates a standalone function `{className}ToString(value)` and a static wrapper
//! method `static toString(value)` returning a string like `"ClassName { field1: value1, field2: value2 }"`.
//!
//! **Enums**: Generates a standalone function `{enumName}ToString(value)` that performs
//! reverse lookup on numeric enums.
//!
//! **Interfaces**: Generates a standalone function `{ifaceName}ToString(value)`.
//!
//! **Type Aliases**: Generates a standalone function using JSON.stringify for
//! complex types, or field enumeration for object types.
//!
//! Names use **camelCase** conversion (e.g., `User` -> `userToString`).
//!
//!
//! ## Field-Level Options
//!
//! The `@debug` decorator supports:
//!
//! - `skip` - Exclude the field from debug output
//! - `rename = "label"` - Use a custom label instead of the field name
//!
//! ## Example
//!
//! ```typescript
//! /** @derive(Debug) */
//! class User {
//! /** @debug({ rename: "id" }) */
//! userId: number;
//!
//! /** @debug({ skip: true }) */
//! password: string;
//!
//! email: string;
//! }
//! ```
//!
//! Generated output:
//!
//! ```typescript
//! class User {
//! userId: number;
//!
//! password: string;
//!
//! email: string;
//!
//! static toString(value: User): string {
//! return userToString(value);
//! }
//! }
//!
//! export function userToString(value: User): string {
//! const parts: string[] = [];
//! parts.push('id: ' + value.userId);
//! parts.push('email: ' + value.email);
//! return 'User { ' + parts.join(', ') + ' }';
//! }
//! ```