@simplysm/core-common 13.0.0-beta.1

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 (202) hide show
  1. package/.cache/typecheck-browser.tsbuildinfo +1 -0
  2. package/.cache/typecheck-node.tsbuildinfo +1 -0
  3. package/.cache/typecheck-tests-browser.tsbuildinfo +1 -0
  4. package/.cache/typecheck-tests-node.tsbuildinfo +1 -0
  5. package/README.md +887 -0
  6. package/dist/common.types.d.ts +74 -0
  7. package/dist/common.types.d.ts.map +1 -0
  8. package/dist/common.types.js +5 -0
  9. package/dist/common.types.js.map +7 -0
  10. package/dist/env.d.ts +6 -0
  11. package/dist/env.d.ts.map +1 -0
  12. package/dist/env.js +9 -0
  13. package/dist/env.js.map +7 -0
  14. package/dist/errors/argument-error.d.ts +25 -0
  15. package/dist/errors/argument-error.d.ts.map +1 -0
  16. package/dist/errors/argument-error.js +18 -0
  17. package/dist/errors/argument-error.js.map +7 -0
  18. package/dist/errors/not-implemented-error.d.ts +29 -0
  19. package/dist/errors/not-implemented-error.d.ts.map +1 -0
  20. package/dist/errors/not-implemented-error.js +14 -0
  21. package/dist/errors/not-implemented-error.js.map +7 -0
  22. package/dist/errors/sd-error.d.ts +27 -0
  23. package/dist/errors/sd-error.d.ts.map +1 -0
  24. package/dist/errors/sd-error.js +23 -0
  25. package/dist/errors/sd-error.js.map +7 -0
  26. package/dist/errors/timeout-error.d.ts +31 -0
  27. package/dist/errors/timeout-error.d.ts.map +1 -0
  28. package/dist/errors/timeout-error.js +17 -0
  29. package/dist/errors/timeout-error.js.map +7 -0
  30. package/dist/extensions/arr-ext.d.ts +15 -0
  31. package/dist/extensions/arr-ext.d.ts.map +1 -0
  32. package/dist/extensions/arr-ext.helpers.d.ts +19 -0
  33. package/dist/extensions/arr-ext.helpers.d.ts.map +1 -0
  34. package/dist/extensions/arr-ext.helpers.js +35 -0
  35. package/dist/extensions/arr-ext.helpers.js.map +7 -0
  36. package/dist/extensions/arr-ext.js +546 -0
  37. package/dist/extensions/arr-ext.js.map +7 -0
  38. package/dist/extensions/arr-ext.types.d.ts +215 -0
  39. package/dist/extensions/arr-ext.types.d.ts.map +1 -0
  40. package/dist/extensions/arr-ext.types.js +1 -0
  41. package/dist/extensions/arr-ext.types.js.map +7 -0
  42. package/dist/extensions/map-ext.d.ts +57 -0
  43. package/dist/extensions/map-ext.d.ts.map +1 -0
  44. package/dist/extensions/map-ext.js +26 -0
  45. package/dist/extensions/map-ext.js.map +7 -0
  46. package/dist/extensions/set-ext.d.ts +36 -0
  47. package/dist/extensions/set-ext.d.ts.map +1 -0
  48. package/dist/extensions/set-ext.js +29 -0
  49. package/dist/extensions/set-ext.js.map +7 -0
  50. package/dist/features/debounce-queue.d.ts +53 -0
  51. package/dist/features/debounce-queue.d.ts.map +1 -0
  52. package/dist/features/debounce-queue.js +80 -0
  53. package/dist/features/debounce-queue.js.map +7 -0
  54. package/dist/features/event-emitter.d.ts +66 -0
  55. package/dist/features/event-emitter.d.ts.map +1 -0
  56. package/dist/features/event-emitter.js +82 -0
  57. package/dist/features/event-emitter.js.map +7 -0
  58. package/dist/features/serial-queue.d.ts +47 -0
  59. package/dist/features/serial-queue.d.ts.map +1 -0
  60. package/dist/features/serial-queue.js +66 -0
  61. package/dist/features/serial-queue.js.map +7 -0
  62. package/dist/globals.d.ts +12 -0
  63. package/dist/globals.d.ts.map +1 -0
  64. package/dist/globals.js +1 -0
  65. package/dist/globals.js.map +7 -0
  66. package/dist/index.d.ts +32 -0
  67. package/dist/index.d.ts.map +1 -0
  68. package/dist/index.js +31 -0
  69. package/dist/index.js.map +7 -0
  70. package/dist/types/date-only.d.ts +152 -0
  71. package/dist/types/date-only.d.ts.map +1 -0
  72. package/dist/types/date-only.js +251 -0
  73. package/dist/types/date-only.js.map +7 -0
  74. package/dist/types/date-time.d.ts +96 -0
  75. package/dist/types/date-time.d.ts.map +1 -0
  76. package/dist/types/date-time.js +220 -0
  77. package/dist/types/date-time.js.map +7 -0
  78. package/dist/types/lazy-gc-map.d.ts +80 -0
  79. package/dist/types/lazy-gc-map.d.ts.map +1 -0
  80. package/dist/types/lazy-gc-map.js +179 -0
  81. package/dist/types/lazy-gc-map.js.map +7 -0
  82. package/dist/types/time.d.ts +68 -0
  83. package/dist/types/time.d.ts.map +1 -0
  84. package/dist/types/time.js +151 -0
  85. package/dist/types/time.js.map +7 -0
  86. package/dist/types/uuid.d.ts +35 -0
  87. package/dist/types/uuid.d.ts.map +1 -0
  88. package/dist/types/uuid.js +71 -0
  89. package/dist/types/uuid.js.map +7 -0
  90. package/dist/utils/bytes.d.ts +51 -0
  91. package/dist/utils/bytes.d.ts.map +1 -0
  92. package/dist/utils/bytes.js +89 -0
  93. package/dist/utils/bytes.js.map +7 -0
  94. package/dist/utils/date-format.d.ts +90 -0
  95. package/dist/utils/date-format.d.ts.map +1 -0
  96. package/dist/utils/date-format.js +106 -0
  97. package/dist/utils/date-format.js.map +7 -0
  98. package/dist/utils/json.d.ts +34 -0
  99. package/dist/utils/json.d.ts.map +1 -0
  100. package/dist/utils/json.js +152 -0
  101. package/dist/utils/json.js.map +7 -0
  102. package/dist/utils/num.d.ts +60 -0
  103. package/dist/utils/num.d.ts.map +1 -0
  104. package/dist/utils/num.js +39 -0
  105. package/dist/utils/num.js.map +7 -0
  106. package/dist/utils/obj.d.ts +258 -0
  107. package/dist/utils/obj.d.ts.map +1 -0
  108. package/dist/utils/obj.js +538 -0
  109. package/dist/utils/obj.js.map +7 -0
  110. package/dist/utils/path.d.ts +23 -0
  111. package/dist/utils/path.d.ts.map +1 -0
  112. package/dist/utils/path.js +21 -0
  113. package/dist/utils/path.js.map +7 -0
  114. package/dist/utils/primitive.d.ts +18 -0
  115. package/dist/utils/primitive.d.ts.map +1 -0
  116. package/dist/utils/primitive.js +20 -0
  117. package/dist/utils/primitive.js.map +7 -0
  118. package/dist/utils/str.d.ts +103 -0
  119. package/dist/utils/str.d.ts.map +1 -0
  120. package/dist/utils/str.js +128 -0
  121. package/dist/utils/str.js.map +7 -0
  122. package/dist/utils/template-strings.d.ts +84 -0
  123. package/dist/utils/template-strings.d.ts.map +1 -0
  124. package/dist/utils/template-strings.js +49 -0
  125. package/dist/utils/template-strings.js.map +7 -0
  126. package/dist/utils/transferable.d.ts +47 -0
  127. package/dist/utils/transferable.d.ts.map +1 -0
  128. package/dist/utils/transferable.js +153 -0
  129. package/dist/utils/transferable.js.map +7 -0
  130. package/dist/utils/wait.d.ts +19 -0
  131. package/dist/utils/wait.d.ts.map +1 -0
  132. package/dist/utils/wait.js +19 -0
  133. package/dist/utils/wait.js.map +7 -0
  134. package/dist/utils/xml.d.ts +36 -0
  135. package/dist/utils/xml.d.ts.map +1 -0
  136. package/dist/utils/xml.js +51 -0
  137. package/dist/utils/xml.js.map +7 -0
  138. package/dist/zip/sd-zip.d.ts +80 -0
  139. package/dist/zip/sd-zip.d.ts.map +1 -0
  140. package/dist/zip/sd-zip.js +153 -0
  141. package/dist/zip/sd-zip.js.map +7 -0
  142. package/package.json +31 -0
  143. package/src/common.types.ts +91 -0
  144. package/src/env.ts +11 -0
  145. package/src/errors/argument-error.ts +40 -0
  146. package/src/errors/not-implemented-error.ts +32 -0
  147. package/src/errors/sd-error.ts +53 -0
  148. package/src/errors/timeout-error.ts +36 -0
  149. package/src/extensions/arr-ext.helpers.ts +53 -0
  150. package/src/extensions/arr-ext.ts +777 -0
  151. package/src/extensions/arr-ext.types.ts +258 -0
  152. package/src/extensions/map-ext.ts +86 -0
  153. package/src/extensions/set-ext.ts +68 -0
  154. package/src/features/debounce-queue.ts +116 -0
  155. package/src/features/event-emitter.ts +112 -0
  156. package/src/features/serial-queue.ts +94 -0
  157. package/src/globals.ts +12 -0
  158. package/src/index.ts +55 -0
  159. package/src/types/date-only.ts +329 -0
  160. package/src/types/date-time.ts +294 -0
  161. package/src/types/lazy-gc-map.ts +244 -0
  162. package/src/types/time.ts +210 -0
  163. package/src/types/uuid.ts +113 -0
  164. package/src/utils/bytes.ts +160 -0
  165. package/src/utils/date-format.ts +239 -0
  166. package/src/utils/json.ts +230 -0
  167. package/src/utils/num.ts +97 -0
  168. package/src/utils/obj.ts +956 -0
  169. package/src/utils/path.ts +40 -0
  170. package/src/utils/primitive.ts +33 -0
  171. package/src/utils/str.ts +252 -0
  172. package/src/utils/template-strings.ts +132 -0
  173. package/src/utils/transferable.ts +269 -0
  174. package/src/utils/wait.ts +40 -0
  175. package/src/utils/xml.ts +105 -0
  176. package/src/zip/sd-zip.ts +218 -0
  177. package/tests/errors/errors.spec.ts +196 -0
  178. package/tests/extensions/array-extension.spec.ts +790 -0
  179. package/tests/extensions/map-extension.spec.ts +147 -0
  180. package/tests/extensions/set-extension.spec.ts +74 -0
  181. package/tests/types/date-only.spec.ts +636 -0
  182. package/tests/types/date-time.spec.ts +391 -0
  183. package/tests/types/lazy-gc-map.spec.ts +692 -0
  184. package/tests/types/time.spec.ts +559 -0
  185. package/tests/types/types.spec.ts +55 -0
  186. package/tests/types/uuid.spec.ts +91 -0
  187. package/tests/utils/bytes-utils.spec.ts +230 -0
  188. package/tests/utils/date-format.spec.ts +371 -0
  189. package/tests/utils/debounce-queue.spec.ts +272 -0
  190. package/tests/utils/json.spec.ts +475 -0
  191. package/tests/utils/number.spec.ts +184 -0
  192. package/tests/utils/object.spec.ts +827 -0
  193. package/tests/utils/path.spec.ts +78 -0
  194. package/tests/utils/primitive.spec.ts +55 -0
  195. package/tests/utils/sd-event-emitter.spec.ts +216 -0
  196. package/tests/utils/serial-queue.spec.ts +365 -0
  197. package/tests/utils/string.spec.ts +294 -0
  198. package/tests/utils/template-strings.spec.ts +96 -0
  199. package/tests/utils/transferable.spec.ts +698 -0
  200. package/tests/utils/wait.spec.ts +145 -0
  201. package/tests/utils/xml.spec.ts +146 -0
  202. package/tests/zip/sd-zip.spec.ts +234 -0
@@ -0,0 +1,147 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import "../../src/extensions/map-ext";
3
+
4
+ describe("Map.prototype 확장", () => {
5
+ //#region getOrCreate
6
+
7
+ describe("getOrCreate()", () => {
8
+ it("키가 없으면 직접 값을 설정하고 반환한다", () => {
9
+ const map = new Map<string, number>();
10
+
11
+ const result = map.getOrCreate("key", 100);
12
+
13
+ expect(result).toBe(100);
14
+ expect(map.get("key")).toBe(100);
15
+ expect(map.size).toBe(1);
16
+ });
17
+
18
+ it("키가 없으면 팩토리 함수를 호출하여 설정하고 반환한다", () => {
19
+ const map = new Map<string, number[]>();
20
+ let factoryCalled = false;
21
+
22
+ const result = map.getOrCreate("key", () => {
23
+ factoryCalled = true;
24
+ return [1, 2, 3];
25
+ });
26
+
27
+ expect(factoryCalled).toBe(true);
28
+ expect(result).toEqual([1, 2, 3]);
29
+ expect(map.get("key")).toEqual([1, 2, 3]);
30
+ });
31
+
32
+ it("키가 있으면 기존 값을 반환하고 팩토리 함수를 호출하지 않는다", () => {
33
+ const map = new Map<string, number>();
34
+ map.set("key", 50);
35
+ let factoryCalled = false;
36
+
37
+ const result = map.getOrCreate("key", () => {
38
+ factoryCalled = true;
39
+ return 100;
40
+ });
41
+
42
+ expect(factoryCalled).toBe(false);
43
+ expect(result).toBe(50);
44
+ expect(map.get("key")).toBe(50);
45
+ });
46
+
47
+ it("키가 있으면 기존 값을 반환한다 (직접 값)", () => {
48
+ const map = new Map<string, number>();
49
+ map.set("key", 50);
50
+
51
+ const result = map.getOrCreate("key", 100);
52
+
53
+ expect(result).toBe(50);
54
+ expect(map.size).toBe(1);
55
+ });
56
+
57
+ it("빈 배열을 기본값으로 설정할 수 있다", () => {
58
+ const map = new Map<string, number[]>();
59
+
60
+ const arr = map.getOrCreate("key", []);
61
+ arr.push(1, 2, 3);
62
+
63
+ expect(map.get("key")).toEqual([1, 2, 3]);
64
+ });
65
+
66
+ it("팩토리 함수로 복잡한 객체를 생성할 수 있다", () => {
67
+ const map = new Map<string, { count: number; items: string[] }>();
68
+
69
+ const obj = map.getOrCreate("key", () => ({ count: 0, items: [] }));
70
+ obj.count++;
71
+ obj.items.push("item1");
72
+
73
+ expect(map.get("key")).toEqual({ count: 1, items: ["item1"] });
74
+ });
75
+
76
+ it("V 타입이 함수인 경우 팩토리로 감싸서 저장한다", () => {
77
+ const map = new Map<string, () => number>();
78
+ const fn = () => 42;
79
+
80
+ // 함수를 값으로 저장하려면 팩토리로 감싸야 함
81
+ const result = map.getOrCreate("key", () => fn);
82
+
83
+ expect(result).toBe(fn);
84
+ expect(result()).toBe(42);
85
+ expect(map.get("key")).toBe(fn);
86
+ });
87
+ });
88
+
89
+ //#endregion
90
+
91
+ //#region update
92
+
93
+ describe("update()", () => {
94
+ it("존재하는 키의 값을 업데이트한다", () => {
95
+ const map = new Map<string, number>();
96
+ map.set("key", 10);
97
+
98
+ map.update("key", (v) => (v ?? 0) + 5);
99
+
100
+ expect(map.get("key")).toBe(15);
101
+ });
102
+
103
+ it("존재하지 않는 키에 대해 undefined를 전달한다", () => {
104
+ const map = new Map<string, number>();
105
+ let receivedValue: number | undefined;
106
+
107
+ map.update("key", (v) => {
108
+ receivedValue = v;
109
+ return 100;
110
+ });
111
+
112
+ expect(receivedValue).toBeUndefined();
113
+ expect(map.get("key")).toBe(100);
114
+ });
115
+
116
+ it("콜백의 반환값으로 값을 교체한다", () => {
117
+ const map = new Map<string, string>();
118
+ map.set("key", "hello");
119
+
120
+ map.update("key", (v) => (v ?? "") + " world");
121
+
122
+ expect(map.get("key")).toBe("hello world");
123
+ });
124
+
125
+ it("객체 값을 업데이트할 수 있다", () => {
126
+ const map = new Map<string, { count: number }>();
127
+ map.set("key", { count: 5 });
128
+
129
+ map.update("key", (v) => ({ count: (v?.count ?? 0) + 1 }));
130
+
131
+ expect(map.get("key")).toEqual({ count: 6 });
132
+ });
133
+
134
+ it("여러 번 연속으로 업데이트할 수 있다", () => {
135
+ const map = new Map<string, number>();
136
+ map.set("counter", 0);
137
+
138
+ map.update("counter", (v) => (v ?? 0) + 1);
139
+ map.update("counter", (v) => (v ?? 0) + 1);
140
+ map.update("counter", (v) => (v ?? 0) + 1);
141
+
142
+ expect(map.get("counter")).toBe(3);
143
+ });
144
+ });
145
+
146
+ //#endregion
147
+ });
@@ -0,0 +1,74 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import "../../src/extensions/set-ext";
3
+
4
+ describe("Set.prototype 확장", () => {
5
+ //#region adds
6
+
7
+ describe("adds()", () => {
8
+ it("여러 항목을 한 번에 추가한다", () => {
9
+ const set = new Set([1, 2, 3]);
10
+ const result = set.adds(4, 5, 6);
11
+
12
+ expect(result).toBe(set); // 원본 반환
13
+ expect(set.size).toBe(6);
14
+ expect(set.has(4)).toBe(true);
15
+ expect(set.has(5)).toBe(true);
16
+ expect(set.has(6)).toBe(true);
17
+ });
18
+
19
+ it("중복된 항목은 자동으로 제거된다", () => {
20
+ const set = new Set([1, 2, 3]);
21
+ set.adds(2, 3, 4);
22
+
23
+ expect(set.size).toBe(4); // 1, 2, 3, 4
24
+ });
25
+
26
+ it("빈 Set에 여러 항목을 추가한다", () => {
27
+ const set = new Set<number>();
28
+ set.adds(1, 2, 3);
29
+
30
+ expect(set.size).toBe(3);
31
+ });
32
+ });
33
+
34
+ //#endregion
35
+
36
+ //#region toggle
37
+
38
+ describe("toggle()", () => {
39
+ it("없는 항목을 추가한다", () => {
40
+ const set = new Set([1, 2, 3]);
41
+ const result = set.toggle(4);
42
+
43
+ expect(result).toBe(set); // 원본 반환
44
+ expect(set.has(4)).toBe(true);
45
+ expect(set.size).toBe(4);
46
+ });
47
+
48
+ it("있는 항목을 제거한다", () => {
49
+ const set = new Set([1, 2, 3]);
50
+ set.toggle(2);
51
+
52
+ expect(set.has(2)).toBe(false);
53
+ expect(set.size).toBe(2);
54
+ });
55
+
56
+ it("addOrDel='add'로 강제로 추가한다", () => {
57
+ const set = new Set([1, 2, 3]);
58
+ set.toggle(2, "add"); // 이미 있지만 add 옵션
59
+
60
+ expect(set.has(2)).toBe(true);
61
+ expect(set.size).toBe(3); // 변화 없음
62
+ });
63
+
64
+ it("addOrDel='del'로 강제로 제거한다", () => {
65
+ const set = new Set([1, 2, 3]);
66
+ set.toggle(4, "del"); // 없지만 del 옵션
67
+
68
+ expect(set.has(4)).toBe(false);
69
+ expect(set.size).toBe(3); // 변화 없음
70
+ });
71
+ });
72
+
73
+ //#endregion
74
+ });