@mandujs/core 0.13.0 → 0.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/README.ko.md +4 -4
  2. package/README.md +653 -653
  3. package/package.json +1 -1
  4. package/src/bundler/build.ts +91 -91
  5. package/src/bundler/css.ts +302 -302
  6. package/src/client/Link.tsx +227 -227
  7. package/src/client/globals.ts +44 -44
  8. package/src/client/hooks.ts +267 -267
  9. package/src/client/index.ts +5 -5
  10. package/src/client/island.ts +8 -8
  11. package/src/client/router.ts +435 -435
  12. package/src/client/runtime.ts +23 -23
  13. package/src/client/serialize.ts +404 -404
  14. package/src/client/window-state.ts +101 -101
  15. package/src/config/mandu.ts +9 -0
  16. package/src/config/validate.ts +12 -0
  17. package/src/config/watcher.ts +311 -311
  18. package/src/constants.ts +40 -40
  19. package/src/content/content-layer.ts +314 -314
  20. package/src/content/content.test.ts +433 -433
  21. package/src/content/data-store.ts +245 -245
  22. package/src/content/digest.ts +133 -133
  23. package/src/content/index.ts +164 -164
  24. package/src/content/loader-context.ts +172 -172
  25. package/src/content/loaders/api.ts +216 -216
  26. package/src/content/loaders/file.ts +169 -169
  27. package/src/content/loaders/glob.ts +252 -252
  28. package/src/content/loaders/index.ts +34 -34
  29. package/src/content/loaders/types.ts +137 -137
  30. package/src/content/meta-store.ts +209 -209
  31. package/src/content/types.ts +282 -282
  32. package/src/content/watcher.ts +135 -135
  33. package/src/contract/client-safe.test.ts +42 -42
  34. package/src/contract/client-safe.ts +114 -114
  35. package/src/contract/client.ts +16 -16
  36. package/src/contract/define.ts +459 -459
  37. package/src/contract/handler.ts +10 -10
  38. package/src/contract/normalize.test.ts +276 -276
  39. package/src/contract/normalize.ts +404 -404
  40. package/src/contract/registry.test.ts +206 -206
  41. package/src/contract/registry.ts +568 -568
  42. package/src/contract/schema.ts +48 -48
  43. package/src/contract/types.ts +58 -58
  44. package/src/contract/validator.ts +32 -32
  45. package/src/devtools/ai/context-builder.ts +375 -375
  46. package/src/devtools/ai/index.ts +25 -25
  47. package/src/devtools/ai/mcp-connector.ts +465 -465
  48. package/src/devtools/client/catchers/error-catcher.ts +327 -327
  49. package/src/devtools/client/catchers/index.ts +18 -18
  50. package/src/devtools/client/catchers/network-proxy.ts +363 -363
  51. package/src/devtools/client/components/index.ts +39 -39
  52. package/src/devtools/client/components/kitchen-root.tsx +362 -362
  53. package/src/devtools/client/components/mandu-character.tsx +241 -241
  54. package/src/devtools/client/components/overlay.tsx +368 -368
  55. package/src/devtools/client/components/panel/errors-panel.tsx +259 -259
  56. package/src/devtools/client/components/panel/guard-panel.tsx +244 -244
  57. package/src/devtools/client/components/panel/index.ts +32 -32
  58. package/src/devtools/client/components/panel/islands-panel.tsx +304 -304
  59. package/src/devtools/client/components/panel/network-panel.tsx +292 -292
  60. package/src/devtools/client/components/panel/panel-container.tsx +259 -259
  61. package/src/devtools/client/filters/context-filters.ts +282 -282
  62. package/src/devtools/client/filters/index.ts +16 -16
  63. package/src/devtools/client/index.ts +63 -63
  64. package/src/devtools/client/persistence.ts +335 -335
  65. package/src/devtools/client/state-manager.ts +478 -478
  66. package/src/devtools/design-tokens.ts +263 -263
  67. package/src/devtools/hook/create-hook.ts +207 -207
  68. package/src/devtools/hook/index.ts +13 -13
  69. package/src/devtools/index.ts +439 -439
  70. package/src/devtools/init.ts +266 -266
  71. package/src/devtools/protocol.ts +237 -237
  72. package/src/devtools/server/index.ts +17 -17
  73. package/src/devtools/server/source-context.ts +444 -444
  74. package/src/devtools/types.ts +319 -319
  75. package/src/devtools/worker/index.ts +25 -25
  76. package/src/devtools/worker/redaction-worker.ts +222 -222
  77. package/src/devtools/worker/worker-manager.ts +409 -409
  78. package/src/error/domains.ts +265 -265
  79. package/src/error/result.ts +46 -46
  80. package/src/error/types.ts +6 -6
  81. package/src/errors/extractor.ts +409 -409
  82. package/src/errors/index.ts +19 -19
  83. package/src/filling/auth.ts +308 -308
  84. package/src/filling/context.ts +24 -1
  85. package/src/filling/deps.ts +238 -238
  86. package/src/filling/index.ts +4 -0
  87. package/src/filling/sse-catchup.test.ts +56 -0
  88. package/src/filling/sse-catchup.ts +67 -0
  89. package/src/filling/sse.test.ts +168 -0
  90. package/src/filling/sse.ts +162 -0
  91. package/src/generator/index.ts +3 -3
  92. package/src/guard/analyzer.ts +360 -360
  93. package/src/guard/ast-analyzer.ts +806 -806
  94. package/src/guard/contract-guard.ts +9 -9
  95. package/src/guard/file-type.test.ts +24 -24
  96. package/src/guard/presets/atomic.ts +70 -70
  97. package/src/guard/presets/clean.ts +77 -77
  98. package/src/guard/presets/fsd.ts +79 -79
  99. package/src/guard/presets/hexagonal.ts +68 -68
  100. package/src/guard/presets/index.ts +291 -291
  101. package/src/guard/reporter.ts +445 -445
  102. package/src/guard/rules.ts +12 -12
  103. package/src/guard/statistics.ts +578 -578
  104. package/src/guard/suggestions.ts +358 -358
  105. package/src/guard/types.ts +348 -348
  106. package/src/guard/validator.ts +834 -834
  107. package/src/guard/watcher.ts +404 -404
  108. package/src/index.ts +6 -1
  109. package/src/intent/index.ts +310 -310
  110. package/src/island/index.ts +304 -304
  111. package/src/logging/index.ts +22 -22
  112. package/src/logging/transports.ts +365 -365
  113. package/src/plugins/index.ts +38 -38
  114. package/src/plugins/registry.ts +377 -377
  115. package/src/plugins/types.ts +363 -363
  116. package/src/report/index.ts +1 -1
  117. package/src/router/fs-patterns.ts +387 -387
  118. package/src/router/fs-scanner.ts +497 -497
  119. package/src/runtime/boundary.tsx +232 -232
  120. package/src/runtime/compose.ts +222 -222
  121. package/src/runtime/escape.ts +44 -0
  122. package/src/runtime/lifecycle.ts +381 -381
  123. package/src/runtime/logger.test.ts +345 -345
  124. package/src/runtime/logger.ts +677 -677
  125. package/src/runtime/router.test.ts +476 -476
  126. package/src/runtime/router.ts +105 -105
  127. package/src/runtime/security.ts +155 -155
  128. package/src/runtime/server.ts +257 -0
  129. package/src/runtime/session-key.ts +328 -328
  130. package/src/runtime/ssr.ts +16 -21
  131. package/src/runtime/streaming-ssr.ts +24 -33
  132. package/src/runtime/trace.ts +144 -144
  133. package/src/seo/index.ts +214 -214
  134. package/src/seo/integration/ssr.ts +307 -307
  135. package/src/seo/render/basic.ts +427 -427
  136. package/src/seo/render/index.ts +143 -143
  137. package/src/seo/render/jsonld.ts +539 -539
  138. package/src/seo/render/opengraph.ts +191 -191
  139. package/src/seo/render/robots.ts +116 -116
  140. package/src/seo/render/sitemap.ts +137 -137
  141. package/src/seo/render/twitter.ts +126 -126
  142. package/src/seo/resolve/index.ts +353 -353
  143. package/src/seo/resolve/opengraph.ts +143 -143
  144. package/src/seo/resolve/robots.ts +73 -73
  145. package/src/seo/resolve/title.ts +94 -94
  146. package/src/seo/resolve/twitter.ts +73 -73
  147. package/src/seo/resolve/url.ts +97 -97
  148. package/src/seo/routes/index.ts +290 -290
  149. package/src/seo/types.ts +575 -575
  150. package/src/slot/validator.ts +39 -39
  151. package/src/spec/index.ts +3 -3
  152. package/src/spec/load.ts +76 -76
  153. package/src/spec/lock.ts +56 -56
  154. package/src/utils/bun.ts +8 -8
  155. package/src/utils/lru-cache.ts +75 -75
  156. package/src/utils/safe-io.ts +188 -188
  157. package/src/utils/string-safe.ts +298 -298
@@ -25,19 +25,19 @@ export interface SlotValidationResult {
25
25
  }
26
26
 
27
27
  // 금지된 import 모듈들
28
- const FORBIDDEN_IMPORTS = [
29
- "fs",
30
- "child_process",
31
- "cluster",
32
- "worker_threads",
33
- "node:fs",
34
- "node:child_process",
35
- "node:cluster",
36
- "node:worker_threads",
37
- ];
38
-
39
- // Slot에서 직접 import를 피해야 하는 모듈
40
- const DISCOURAGED_SLOT_IMPORTS = ["zod"];
28
+ const FORBIDDEN_IMPORTS = [
29
+ "fs",
30
+ "child_process",
31
+ "cluster",
32
+ "worker_threads",
33
+ "node:fs",
34
+ "node:child_process",
35
+ "node:cluster",
36
+ "node:worker_threads",
37
+ ];
38
+
39
+ // Slot에서 직접 import를 피해야 하는 모듈
40
+ const DISCOURAGED_SLOT_IMPORTS = ["zod"];
41
41
 
42
42
  // 필수 패턴들 (더 엄격한 검사)
43
43
  const REQUIRED_PATTERNS = {
@@ -147,9 +147,9 @@ export function validateSlotContent(content: string): SlotValidationResult {
147
147
  const codeWithoutComments = stripComments(content);
148
148
 
149
149
  // 1. 금지된 import 검사
150
- for (let i = 0; i < lines.length; i++) {
151
- const line = lines[i];
152
- for (const forbidden of FORBIDDEN_IMPORTS) {
150
+ for (let i = 0; i < lines.length; i++) {
151
+ const line = lines[i];
152
+ for (const forbidden of FORBIDDEN_IMPORTS) {
153
153
  // import 문에서 금지된 모듈 체크
154
154
  const importPattern = new RegExp(
155
155
  `import\\s+.*from\\s+['"]${forbidden.replace("/", "\\/")}['"]`
@@ -167,29 +167,29 @@ export function validateSlotContent(content: string): SlotValidationResult {
167
167
  suggestion: `'${forbidden}' 대신 Bun의 안전한 API 또는 adapter를 사용하세요`,
168
168
  autoFixable: true,
169
169
  });
170
- }
171
- }
172
-
173
- for (const discouraged of DISCOURAGED_SLOT_IMPORTS) {
174
- const importPattern = new RegExp(
175
- `import\\s+.*from\\s+['"]${discouraged}['"]`
176
- );
177
- const requirePattern = new RegExp(
178
- `require\\s*\\(\\s*['"]${discouraged}['"]\\s*\\)`
179
- );
180
-
181
- if (importPattern.test(line) || requirePattern.test(line)) {
182
- issues.push({
183
- code: "ZOD_DIRECT_IMPORT",
184
- severity: "error",
185
- message: `Slot에서 '${discouraged}' 직접 import 금지`,
186
- line: i + 1,
187
- suggestion: "계약은 spec/contracts/*.contract.ts에 정의하고 ctx.input()으로 검증하세요",
188
- autoFixable: false,
189
- });
190
- }
191
- }
192
- }
170
+ }
171
+ }
172
+
173
+ for (const discouraged of DISCOURAGED_SLOT_IMPORTS) {
174
+ const importPattern = new RegExp(
175
+ `import\\s+.*from\\s+['"]${discouraged}['"]`
176
+ );
177
+ const requirePattern = new RegExp(
178
+ `require\\s*\\(\\s*['"]${discouraged}['"]\\s*\\)`
179
+ );
180
+
181
+ if (importPattern.test(line) || requirePattern.test(line)) {
182
+ issues.push({
183
+ code: "ZOD_DIRECT_IMPORT",
184
+ severity: "error",
185
+ message: `Slot에서 '${discouraged}' 직접 import 금지`,
186
+ line: i + 1,
187
+ suggestion: "계약은 spec/contracts/*.contract.ts에 정의하고 ctx.input()으로 검증하세요",
188
+ autoFixable: false,
189
+ });
190
+ }
191
+ }
192
+ }
193
193
 
194
194
  // 2. Mandu import 검사
195
195
  if (!REQUIRED_PATTERNS.manduImport.test(content)) {
package/src/spec/index.ts CHANGED
@@ -1,3 +1,3 @@
1
- export * from "./schema";
2
- export * from "./load";
3
- export * from "./lock";
1
+ export * from "./schema";
2
+ export * from "./load";
3
+ export * from "./lock";
package/src/spec/load.ts CHANGED
@@ -1,76 +1,76 @@
1
- import { RoutesManifest, type RoutesManifest as RoutesManifestType } from "./schema";
2
- import { ZodError } from "zod";
3
-
4
- export interface LoadResult {
5
- success: boolean;
6
- data?: RoutesManifestType;
7
- errors?: string[];
8
- }
9
-
10
- export function formatZodError(error: ZodError): string[] {
11
- return error.errors.map((e) => {
12
- const path = e.path.length > 0 ? `[${e.path.join(".")}] ` : "";
13
- return `${path}${e.message}`;
14
- });
15
- }
16
-
17
- export async function loadManifest(filePath: string): Promise<LoadResult> {
18
- try {
19
- const file = Bun.file(filePath);
20
- const exists = await file.exists();
21
-
22
- if (!exists) {
23
- return {
24
- success: false,
25
- errors: [`파일을 찾을 수 없습니다: ${filePath}`],
26
- };
27
- }
28
-
29
- const content = await file.text();
30
- let json: unknown;
31
-
32
- try {
33
- json = JSON.parse(content);
34
- } catch {
35
- return {
36
- success: false,
37
- errors: ["JSON 파싱 실패: 올바른 JSON 형식이 아닙니다"],
38
- };
39
- }
40
-
41
- const result = RoutesManifest.safeParse(json);
42
-
43
- if (!result.success) {
44
- return {
45
- success: false,
46
- errors: formatZodError(result.error),
47
- };
48
- }
49
-
50
- return {
51
- success: true,
52
- data: result.data,
53
- };
54
- } catch (error) {
55
- return {
56
- success: false,
57
- errors: [`예상치 못한 오류: ${error instanceof Error ? error.message : String(error)}`],
58
- };
59
- }
60
- }
61
-
62
- export function validateManifest(data: unknown): LoadResult {
63
- const result = RoutesManifest.safeParse(data);
64
-
65
- if (!result.success) {
66
- return {
67
- success: false,
68
- errors: formatZodError(result.error),
69
- };
70
- }
71
-
72
- return {
73
- success: true,
74
- data: result.data,
75
- };
76
- }
1
+ import { RoutesManifest, type RoutesManifest as RoutesManifestType } from "./schema";
2
+ import { ZodError } from "zod";
3
+
4
+ export interface LoadResult {
5
+ success: boolean;
6
+ data?: RoutesManifestType;
7
+ errors?: string[];
8
+ }
9
+
10
+ export function formatZodError(error: ZodError): string[] {
11
+ return error.errors.map((e) => {
12
+ const path = e.path.length > 0 ? `[${e.path.join(".")}] ` : "";
13
+ return `${path}${e.message}`;
14
+ });
15
+ }
16
+
17
+ export async function loadManifest(filePath: string): Promise<LoadResult> {
18
+ try {
19
+ const file = Bun.file(filePath);
20
+ const exists = await file.exists();
21
+
22
+ if (!exists) {
23
+ return {
24
+ success: false,
25
+ errors: [`파일을 찾을 수 없습니다: ${filePath}`],
26
+ };
27
+ }
28
+
29
+ const content = await file.text();
30
+ let json: unknown;
31
+
32
+ try {
33
+ json = JSON.parse(content);
34
+ } catch {
35
+ return {
36
+ success: false,
37
+ errors: ["JSON 파싱 실패: 올바른 JSON 형식이 아닙니다"],
38
+ };
39
+ }
40
+
41
+ const result = RoutesManifest.safeParse(json);
42
+
43
+ if (!result.success) {
44
+ return {
45
+ success: false,
46
+ errors: formatZodError(result.error),
47
+ };
48
+ }
49
+
50
+ return {
51
+ success: true,
52
+ data: result.data,
53
+ };
54
+ } catch (error) {
55
+ return {
56
+ success: false,
57
+ errors: [`예상치 못한 오류: ${error instanceof Error ? error.message : String(error)}`],
58
+ };
59
+ }
60
+ }
61
+
62
+ export function validateManifest(data: unknown): LoadResult {
63
+ const result = RoutesManifest.safeParse(data);
64
+
65
+ if (!result.success) {
66
+ return {
67
+ success: false,
68
+ errors: formatZodError(result.error),
69
+ };
70
+ }
71
+
72
+ return {
73
+ success: true,
74
+ data: result.data,
75
+ };
76
+ }
package/src/spec/lock.ts CHANGED
@@ -1,56 +1,56 @@
1
- import { createHash } from "crypto";
2
- import type { RoutesManifest } from "./schema";
3
-
4
- export interface SpecLock {
5
- routesHash: string;
6
- updatedAt: string;
7
- }
8
-
9
- export function computeHash(manifest: RoutesManifest): string {
10
- const content = JSON.stringify(manifest, null, 2);
11
- return createHash("sha256").update(content).digest("hex");
12
- }
13
-
14
- export async function readLock(lockPath: string): Promise<SpecLock | null> {
15
- try {
16
- const file = Bun.file(lockPath);
17
- const exists = await file.exists();
18
-
19
- if (!exists) {
20
- return null;
21
- }
22
-
23
- const content = await file.text();
24
- return JSON.parse(content) as SpecLock;
25
- } catch {
26
- return null;
27
- }
28
- }
29
-
30
- export async function writeLock(lockPath: string, manifest: RoutesManifest): Promise<SpecLock> {
31
- const lock: SpecLock = {
32
- routesHash: computeHash(manifest),
33
- updatedAt: new Date().toISOString(),
34
- };
35
-
36
- await Bun.write(lockPath, JSON.stringify(lock, null, 2));
37
- return lock;
38
- }
39
-
40
- export async function verifyLock(
41
- lockPath: string,
42
- manifest: RoutesManifest
43
- ): Promise<{ valid: boolean; currentHash: string; lockHash: string | null }> {
44
- const currentHash = computeHash(manifest);
45
- const lock = await readLock(lockPath);
46
-
47
- if (!lock) {
48
- return { valid: false, currentHash, lockHash: null };
49
- }
50
-
51
- return {
52
- valid: lock.routesHash === currentHash,
53
- currentHash,
54
- lockHash: lock.routesHash,
55
- };
56
- }
1
+ import { createHash } from "crypto";
2
+ import type { RoutesManifest } from "./schema";
3
+
4
+ export interface SpecLock {
5
+ routesHash: string;
6
+ updatedAt: string;
7
+ }
8
+
9
+ export function computeHash(manifest: RoutesManifest): string {
10
+ const content = JSON.stringify(manifest, null, 2);
11
+ return createHash("sha256").update(content).digest("hex");
12
+ }
13
+
14
+ export async function readLock(lockPath: string): Promise<SpecLock | null> {
15
+ try {
16
+ const file = Bun.file(lockPath);
17
+ const exists = await file.exists();
18
+
19
+ if (!exists) {
20
+ return null;
21
+ }
22
+
23
+ const content = await file.text();
24
+ return JSON.parse(content) as SpecLock;
25
+ } catch {
26
+ return null;
27
+ }
28
+ }
29
+
30
+ export async function writeLock(lockPath: string, manifest: RoutesManifest): Promise<SpecLock> {
31
+ const lock: SpecLock = {
32
+ routesHash: computeHash(manifest),
33
+ updatedAt: new Date().toISOString(),
34
+ };
35
+
36
+ await Bun.write(lockPath, JSON.stringify(lock, null, 2));
37
+ return lock;
38
+ }
39
+
40
+ export async function verifyLock(
41
+ lockPath: string,
42
+ manifest: RoutesManifest
43
+ ): Promise<{ valid: boolean; currentHash: string; lockHash: string | null }> {
44
+ const currentHash = computeHash(manifest);
45
+ const lock = await readLock(lockPath);
46
+
47
+ if (!lock) {
48
+ return { valid: false, currentHash, lockHash: null };
49
+ }
50
+
51
+ return {
52
+ valid: lock.routesHash === currentHash,
53
+ currentHash,
54
+ lockHash: lock.routesHash,
55
+ };
56
+ }
package/src/utils/bun.ts CHANGED
@@ -1,8 +1,8 @@
1
- export async function readJsonFile(filePath: string): Promise<unknown> {
2
- try {
3
- return await Bun.file(filePath).json();
4
- } catch (error) {
5
- const message = error instanceof Error ? error.message : String(error);
6
- throw new Error(`Failed to parse JSON in ${filePath}: ${message}`);
7
- }
8
- }
1
+ export async function readJsonFile(filePath: string): Promise<unknown> {
2
+ try {
3
+ return await Bun.file(filePath).json();
4
+ } catch (error) {
5
+ const message = error instanceof Error ? error.message : String(error);
6
+ throw new Error(`Failed to parse JSON in ${filePath}: ${message}`);
7
+ }
8
+ }
@@ -1,75 +1,75 @@
1
- /**
2
- * 간단한 LRU (Least Recently Used) 캐시 구현
3
- */
4
- export class LRUCache<K, V> {
5
- private cache: Map<K, V>;
6
- private readonly maxSize: number;
7
- private _hits = 0;
8
- private _misses = 0;
9
-
10
- constructor(maxSize: number = 100) {
11
- this.cache = new Map();
12
- this.maxSize = maxSize;
13
- }
14
-
15
- get(key: K): V | undefined {
16
- const value = this.cache.get(key);
17
- if (value !== undefined) {
18
- this.cache.delete(key);
19
- this.cache.set(key, value);
20
- }
21
- return value;
22
- }
23
-
24
- getWithStats(key: K): V | undefined {
25
- const value = this.get(key);
26
- if (value !== undefined) {
27
- this._hits++;
28
- } else {
29
- this._misses++;
30
- }
31
- return value;
32
- }
33
-
34
- set(key: K, value: V): void {
35
- if (this.cache.has(key)) {
36
- this.cache.delete(key);
37
- } else if (this.cache.size >= this.maxSize) {
38
- const firstKey = this.cache.keys().next().value;
39
- if (firstKey !== undefined) {
40
- this.cache.delete(firstKey);
41
- }
42
- }
43
- this.cache.set(key, value);
44
- }
45
-
46
- has(key: K): boolean {
47
- return this.cache.has(key);
48
- }
49
-
50
- delete(key: K): boolean {
51
- return this.cache.delete(key);
52
- }
53
-
54
- clear(): void {
55
- this.cache.clear();
56
- }
57
-
58
- get size(): number {
59
- return this.cache.size;
60
- }
61
-
62
- getStats(): { hits: number; misses: number; hitRate: number } {
63
- const total = this._hits + this._misses;
64
- return {
65
- hits: this._hits,
66
- misses: this._misses,
67
- hitRate: total > 0 ? this._hits / total : 0,
68
- };
69
- }
70
-
71
- resetStats(): void {
72
- this._hits = 0;
73
- this._misses = 0;
74
- }
75
- }
1
+ /**
2
+ * 간단한 LRU (Least Recently Used) 캐시 구현
3
+ */
4
+ export class LRUCache<K, V> {
5
+ private cache: Map<K, V>;
6
+ private readonly maxSize: number;
7
+ private _hits = 0;
8
+ private _misses = 0;
9
+
10
+ constructor(maxSize: number = 100) {
11
+ this.cache = new Map();
12
+ this.maxSize = maxSize;
13
+ }
14
+
15
+ get(key: K): V | undefined {
16
+ const value = this.cache.get(key);
17
+ if (value !== undefined) {
18
+ this.cache.delete(key);
19
+ this.cache.set(key, value);
20
+ }
21
+ return value;
22
+ }
23
+
24
+ getWithStats(key: K): V | undefined {
25
+ const value = this.get(key);
26
+ if (value !== undefined) {
27
+ this._hits++;
28
+ } else {
29
+ this._misses++;
30
+ }
31
+ return value;
32
+ }
33
+
34
+ set(key: K, value: V): void {
35
+ if (this.cache.has(key)) {
36
+ this.cache.delete(key);
37
+ } else if (this.cache.size >= this.maxSize) {
38
+ const firstKey = this.cache.keys().next().value;
39
+ if (firstKey !== undefined) {
40
+ this.cache.delete(firstKey);
41
+ }
42
+ }
43
+ this.cache.set(key, value);
44
+ }
45
+
46
+ has(key: K): boolean {
47
+ return this.cache.has(key);
48
+ }
49
+
50
+ delete(key: K): boolean {
51
+ return this.cache.delete(key);
52
+ }
53
+
54
+ clear(): void {
55
+ this.cache.clear();
56
+ }
57
+
58
+ get size(): number {
59
+ return this.cache.size;
60
+ }
61
+
62
+ getStats(): { hits: number; misses: number; hitRate: number } {
63
+ const total = this._hits + this._misses;
64
+ return {
65
+ hits: this._hits,
66
+ misses: this._misses,
67
+ hitRate: total > 0 ? this._hits / total : 0,
68
+ };
69
+ }
70
+
71
+ resetStats(): void {
72
+ this._hits = 0;
73
+ this._misses = 0;
74
+ }
75
+ }