@hyperfrontend/project-scope 0.2.1 → 0.2.3

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 (443) hide show
  1. package/CHANGELOG.md +14 -1
  2. package/README.md +3 -4
  3. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.cjs.js +7 -0
  4. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.esm.js +5 -0
  5. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/console/index.cjs.js +13 -0
  6. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/console/index.esm.js +8 -0
  7. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/date/index.cjs.js +10 -0
  8. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/date/index.esm.js +8 -0
  9. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js +6 -0
  10. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.esm.js +5 -0
  11. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/json/index.cjs.js +7 -0
  12. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/json/index.esm.js +5 -0
  13. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/map/index.cjs.js +6 -0
  14. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/map/index.esm.js +5 -0
  15. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/math/index.cjs.js +9 -0
  16. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/math/index.esm.js +6 -0
  17. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/number/index.cjs.js +7 -0
  18. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/number/index.esm.js +7 -0
  19. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.cjs.js +15 -0
  20. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.esm.js +9 -0
  21. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.cjs.js +6 -0
  22. package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.esm.js +5 -0
  23. package/_dependencies/@hyperfrontend/logging/index.cjs.js +191 -0
  24. package/_dependencies/@hyperfrontend/logging/index.d.ts +151 -0
  25. package/_dependencies/@hyperfrontend/logging/index.esm.js +186 -0
  26. package/_shared/core/cache/index.cjs.js +135 -0
  27. package/_shared/core/cache/index.esm.js +128 -0
  28. package/_shared/core/errors/structured-errors/index.cjs.js +28 -0
  29. package/_shared/core/errors/structured-errors/index.esm.js +23 -0
  30. package/_shared/core/fs/guard/index.cjs.js +7 -0
  31. package/_shared/core/fs/guard/index.esm.js +5 -0
  32. package/_shared/core/fs/stat/index.cjs.js +47 -0
  33. package/_shared/core/fs/stat/index.esm.js +41 -0
  34. package/_shared/core/path/confine/index.cjs.js +22 -0
  35. package/_shared/core/path/confine/index.esm.js +19 -0
  36. package/_shared/core/path/join/index.cjs.js +13 -0
  37. package/_shared/core/path/join/index.esm.js +10 -0
  38. package/_shared/core/path/normalize/index.cjs.js +37 -0
  39. package/_shared/core/path/normalize/index.esm.js +31 -0
  40. package/_shared/core/path/resolve/index.cjs.js +47 -0
  41. package/_shared/core/path/resolve/index.esm.js +41 -0
  42. package/_shared/core/path/segments/index.cjs.js +38 -0
  43. package/_shared/core/path/segments/index.esm.js +31 -0
  44. package/_shared/core/patterns/glob/index.cjs.js +145 -0
  45. package/_shared/core/patterns/glob/index.esm.js +136 -0
  46. package/_shared/core/platform/detect/index.cjs.js +103 -0
  47. package/_shared/core/platform/detect/index.esm.js +95 -0
  48. package/_shared/core/platform/line-endings/index.cjs.js +52 -0
  49. package/_shared/core/platform/line-endings/index.esm.js +44 -0
  50. package/_shared/project/config/patterns/index.cjs.js +172 -0
  51. package/_shared/project/config/patterns/index.esm.js +169 -0
  52. package/_shared/tech/monorepo/pnpm-workspaces/index.cjs.js +33 -0
  53. package/_shared/tech/monorepo/pnpm-workspaces/index.esm.js +31 -0
  54. package/_shared/tech/shared-utils/detector-helpers/index.cjs.js +48 -0
  55. package/_shared/tech/shared-utils/detector-helpers/index.esm.js +43 -0
  56. package/_shared/vfs/types/index.cjs.js +14 -0
  57. package/_shared/vfs/types/index.esm.js +12 -0
  58. package/cli/index.cjs.js +1706 -1910
  59. package/cli/index.d.ts +273 -7
  60. package/cli/index.d.ts.map +1 -1
  61. package/cli/index.esm.js +1593 -1797
  62. package/core/encoding/index.cjs.js +86 -401
  63. package/core/encoding/index.d.ts +186 -3
  64. package/core/encoding/index.d.ts.map +1 -1
  65. package/core/encoding/index.esm.js +78 -392
  66. package/core/fs/index.cjs.js +243 -583
  67. package/core/fs/index.d.ts +479 -6
  68. package/core/fs/index.d.ts.map +1 -1
  69. package/core/fs/index.esm.js +233 -573
  70. package/core/index.cjs.js +526 -1746
  71. package/core/index.d.ts +486 -9
  72. package/core/index.d.ts.map +1 -1
  73. package/core/index.esm.js +515 -1732
  74. package/core/path/index.cjs.js +8 -234
  75. package/core/path/index.d.ts +327 -5
  76. package/core/path/index.d.ts.map +1 -1
  77. package/core/path/index.esm.js +8 -235
  78. package/core/platform/index.cjs.js +5 -216
  79. package/core/platform/index.d.ts +185 -3
  80. package/core/platform/index.d.ts.map +1 -1
  81. package/core/platform/index.esm.js +3 -212
  82. package/heuristics/dependencies/index.cjs.js +105 -493
  83. package/heuristics/dependencies/index.d.ts +99 -2
  84. package/heuristics/dependencies/index.d.ts.map +1 -1
  85. package/heuristics/dependencies/index.esm.js +81 -469
  86. package/heuristics/entry-points/index.cjs.js +93 -796
  87. package/heuristics/entry-points/index.d.ts +123 -2
  88. package/heuristics/entry-points/index.d.ts.map +1 -1
  89. package/heuristics/entry-points/index.esm.js +74 -777
  90. package/heuristics/framework/index.cjs.js +1483 -1411
  91. package/heuristics/framework/index.d.ts +104 -2
  92. package/heuristics/framework/index.d.ts.map +1 -1
  93. package/heuristics/framework/index.esm.js +1419 -1347
  94. package/heuristics/index.cjs.js +3220 -3306
  95. package/heuristics/index.d.ts +4 -5
  96. package/heuristics/index.d.ts.map +1 -1
  97. package/heuristics/index.esm.js +3244 -3330
  98. package/heuristics/project-type/index.cjs.js +1489 -1438
  99. package/heuristics/project-type/index.d.ts +64 -2
  100. package/heuristics/project-type/index.d.ts.map +1 -1
  101. package/heuristics/project-type/index.esm.js +1419 -1368
  102. package/index.cjs.js +3058 -3532
  103. package/index.d.ts +44 -10
  104. package/index.d.ts.map +1 -1
  105. package/index.esm.js +2914 -3376
  106. package/models/index.cjs.js +0 -1
  107. package/models/index.d.ts +20 -14
  108. package/models/index.d.ts.map +1 -1
  109. package/models/index.esm.js +0 -1
  110. package/nx/index.cjs.js +166 -579
  111. package/nx/index.d.ts +279 -4
  112. package/nx/index.d.ts.map +1 -1
  113. package/nx/index.esm.js +148 -556
  114. package/package.json +13 -12
  115. package/project/config/index.cjs.js +127 -1063
  116. package/project/config/index.d.ts +202 -4
  117. package/project/config/index.d.ts.map +1 -1
  118. package/project/config/index.esm.js +110 -1044
  119. package/project/index.cjs.js +328 -1101
  120. package/project/index.d.ts +4 -5
  121. package/project/index.d.ts.map +1 -1
  122. package/project/index.esm.js +307 -1077
  123. package/project/package/index.cjs.js +196 -473
  124. package/project/package/index.d.ts +280 -3
  125. package/project/package/index.d.ts.map +1 -1
  126. package/project/package/index.esm.js +183 -459
  127. package/project/root/index.cjs.js +109 -417
  128. package/project/root/index.d.ts +83 -2
  129. package/project/root/index.d.ts.map +1 -1
  130. package/project/root/index.esm.js +98 -406
  131. package/project/traversal/index.cjs.js +96 -622
  132. package/project/traversal/index.d.ts +165 -3
  133. package/project/traversal/index.d.ts.map +1 -1
  134. package/project/traversal/index.esm.js +82 -608
  135. package/tech/backend/index.cjs.js +223 -508
  136. package/tech/backend/index.d.ts +205 -8
  137. package/tech/backend/index.d.ts.map +1 -1
  138. package/tech/backend/index.esm.js +202 -487
  139. package/tech/build/index.cjs.js +350 -636
  140. package/tech/build/index.d.ts +276 -10
  141. package/tech/build/index.d.ts.map +1 -1
  142. package/tech/build/index.esm.js +328 -614
  143. package/tech/frontend/index.cjs.js +507 -685
  144. package/tech/frontend/index.d.ts +379 -15
  145. package/tech/frontend/index.d.ts.map +1 -1
  146. package/tech/frontend/index.esm.js +483 -661
  147. package/tech/index.cjs.js +1581 -1420
  148. package/tech/index.d.ts +55 -32
  149. package/tech/index.d.ts.map +1 -1
  150. package/tech/index.esm.js +1515 -1354
  151. package/tech/legacy/index.cjs.js +99 -449
  152. package/tech/legacy/index.d.ts +125 -7
  153. package/tech/legacy/index.d.ts.map +1 -1
  154. package/tech/legacy/index.esm.js +81 -431
  155. package/tech/linting/index.cjs.js +138 -523
  156. package/tech/linting/index.d.ts +129 -7
  157. package/tech/linting/index.d.ts.map +1 -1
  158. package/tech/linting/index.esm.js +118 -503
  159. package/tech/monorepo/index.cjs.js +246 -573
  160. package/tech/monorepo/index.d.ts +241 -10
  161. package/tech/monorepo/index.d.ts.map +1 -1
  162. package/tech/monorepo/index.esm.js +226 -553
  163. package/tech/testing/index.cjs.js +216 -571
  164. package/tech/testing/index.d.ts +176 -8
  165. package/tech/testing/index.d.ts.map +1 -1
  166. package/tech/testing/index.esm.js +198 -553
  167. package/tech/types/index.cjs.js +123 -506
  168. package/tech/types/index.d.ts +120 -2
  169. package/tech/types/index.d.ts.map +1 -1
  170. package/tech/types/index.esm.js +101 -484
  171. package/vfs/index.cjs.js +647 -1142
  172. package/vfs/index.d.ts +360 -6
  173. package/vfs/index.d.ts.map +1 -1
  174. package/vfs/index.esm.js +672 -1167
  175. package/ARCHITECTURE.md +0 -370
  176. package/analyze.d.ts +0 -33
  177. package/analyze.d.ts.map +0 -1
  178. package/cli/commands/analyze.d.ts +0 -28
  179. package/cli/commands/analyze.d.ts.map +0 -1
  180. package/cli/commands/config.d.ts +0 -27
  181. package/cli/commands/config.d.ts.map +0 -1
  182. package/cli/commands/deps.d.ts +0 -24
  183. package/cli/commands/deps.d.ts.map +0 -1
  184. package/cli/commands/tree.d.ts +0 -36
  185. package/cli/commands/tree.d.ts.map +0 -1
  186. package/cli/index.cjs.js.map +0 -1
  187. package/cli/index.esm.js.map +0 -1
  188. package/cli/run.d.ts +0 -25
  189. package/cli/run.d.ts.map +0 -1
  190. package/cli/types.d.ts +0 -55
  191. package/cli/types.d.ts.map +0 -1
  192. package/core/cache.d.ts +0 -158
  193. package/core/cache.d.ts.map +0 -1
  194. package/core/encoding/convert.d.ts +0 -32
  195. package/core/encoding/convert.d.ts.map +0 -1
  196. package/core/encoding/detect.d.ts +0 -91
  197. package/core/encoding/detect.d.ts.map +0 -1
  198. package/core/encoding/index.cjs.js.map +0 -1
  199. package/core/encoding/index.esm.js.map +0 -1
  200. package/core/errors/structured-errors.d.ts +0 -66
  201. package/core/errors/structured-errors.d.ts.map +0 -1
  202. package/core/fs/directory.d.ts +0 -91
  203. package/core/fs/directory.d.ts.map +0 -1
  204. package/core/fs/index.cjs.js.map +0 -1
  205. package/core/fs/index.esm.js.map +0 -1
  206. package/core/fs/read.d.ts +0 -94
  207. package/core/fs/read.d.ts.map +0 -1
  208. package/core/fs/stat.d.ts +0 -58
  209. package/core/fs/stat.d.ts.map +0 -1
  210. package/core/fs/traversal.d.ts +0 -26
  211. package/core/fs/traversal.d.ts.map +0 -1
  212. package/core/fs/write.d.ts +0 -75
  213. package/core/fs/write.d.ts.map +0 -1
  214. package/core/index.cjs.js.map +0 -1
  215. package/core/index.esm.js.map +0 -1
  216. package/core/logger.d.ts +0 -111
  217. package/core/logger.d.ts.map +0 -1
  218. package/core/path/index.cjs.js.map +0 -1
  219. package/core/path/index.esm.js.map +0 -1
  220. package/core/path/join.d.ts +0 -17
  221. package/core/path/join.d.ts.map +0 -1
  222. package/core/path/normalize.d.ts +0 -37
  223. package/core/path/normalize.d.ts.map +0 -1
  224. package/core/path/resolve.d.ts +0 -52
  225. package/core/path/resolve.d.ts.map +0 -1
  226. package/core/path/segments.d.ts +0 -59
  227. package/core/path/segments.d.ts.map +0 -1
  228. package/core/patterns/glob.d.ts +0 -42
  229. package/core/patterns/glob.d.ts.map +0 -1
  230. package/core/platform/detect.d.ts +0 -66
  231. package/core/platform/detect.d.ts.map +0 -1
  232. package/core/platform/index.cjs.js.map +0 -1
  233. package/core/platform/index.esm.js.map +0 -1
  234. package/core/platform/line-endings.d.ts +0 -48
  235. package/core/platform/line-endings.d.ts.map +0 -1
  236. package/heuristics/dependencies/analyze.d.ts +0 -77
  237. package/heuristics/dependencies/analyze.d.ts.map +0 -1
  238. package/heuristics/dependencies/index.cjs.js.map +0 -1
  239. package/heuristics/dependencies/index.esm.js.map +0 -1
  240. package/heuristics/entry-points/discover.d.ts +0 -113
  241. package/heuristics/entry-points/discover.d.ts.map +0 -1
  242. package/heuristics/entry-points/index.cjs.js.map +0 -1
  243. package/heuristics/entry-points/index.esm.js.map +0 -1
  244. package/heuristics/framework/identify.d.ts +0 -84
  245. package/heuristics/framework/identify.d.ts.map +0 -1
  246. package/heuristics/framework/index.cjs.js.map +0 -1
  247. package/heuristics/framework/index.esm.js.map +0 -1
  248. package/heuristics/index.cjs.js.map +0 -1
  249. package/heuristics/index.esm.js.map +0 -1
  250. package/heuristics/project-type/detect.d.ts +0 -61
  251. package/heuristics/project-type/detect.d.ts.map +0 -1
  252. package/heuristics/project-type/index.cjs.js.map +0 -1
  253. package/heuristics/project-type/index.esm.js.map +0 -1
  254. package/index.cjs.js.map +0 -1
  255. package/index.esm.js.map +0 -1
  256. package/models/index.cjs.js.map +0 -1
  257. package/models/index.esm.js.map +0 -1
  258. package/nx/detect.d.ts +0 -105
  259. package/nx/detect.d.ts.map +0 -1
  260. package/nx/devkit-loader.d.ts +0 -62
  261. package/nx/devkit-loader.d.ts.map +0 -1
  262. package/nx/index.cjs.js.map +0 -1
  263. package/nx/index.esm.js.map +0 -1
  264. package/nx/project-config.d.ts +0 -111
  265. package/nx/project-config.d.ts.map +0 -1
  266. package/project/config/detect.d.ts +0 -77
  267. package/project/config/detect.d.ts.map +0 -1
  268. package/project/config/index.cjs.js.map +0 -1
  269. package/project/config/index.esm.js.map +0 -1
  270. package/project/config/parse.d.ts +0 -53
  271. package/project/config/parse.d.ts.map +0 -1
  272. package/project/config/patterns.d.ts +0 -31
  273. package/project/config/patterns.d.ts.map +0 -1
  274. package/project/index.cjs.js.map +0 -1
  275. package/project/index.esm.js.map +0 -1
  276. package/project/package/dependencies.d.ts +0 -101
  277. package/project/package/dependencies.d.ts.map +0 -1
  278. package/project/package/index.cjs.js.map +0 -1
  279. package/project/package/index.esm.js.map +0 -1
  280. package/project/package/read.d.ts +0 -67
  281. package/project/package/read.d.ts.map +0 -1
  282. package/project/root/detect.d.ts +0 -65
  283. package/project/root/detect.d.ts.map +0 -1
  284. package/project/root/index.cjs.js.map +0 -1
  285. package/project/root/index.esm.js.map +0 -1
  286. package/project/traversal/index.cjs.js.map +0 -1
  287. package/project/traversal/index.esm.js.map +0 -1
  288. package/project/traversal/search.d.ts +0 -59
  289. package/project/traversal/search.d.ts.map +0 -1
  290. package/project/traversal/walk.d.ts +0 -63
  291. package/project/traversal/walk.d.ts.map +0 -1
  292. package/tech/backend/detect-all.d.ts +0 -13
  293. package/tech/backend/detect-all.d.ts.map +0 -1
  294. package/tech/backend/express.d.ts +0 -11
  295. package/tech/backend/express.d.ts.map +0 -1
  296. package/tech/backend/fastify.d.ts +0 -11
  297. package/tech/backend/fastify.d.ts.map +0 -1
  298. package/tech/backend/hono.d.ts +0 -11
  299. package/tech/backend/hono.d.ts.map +0 -1
  300. package/tech/backend/index.cjs.js.map +0 -1
  301. package/tech/backend/index.esm.js.map +0 -1
  302. package/tech/backend/koa.d.ts +0 -11
  303. package/tech/backend/koa.d.ts.map +0 -1
  304. package/tech/backend/nestjs.d.ts +0 -11
  305. package/tech/backend/nestjs.d.ts.map +0 -1
  306. package/tech/backend/types.d.ts +0 -31
  307. package/tech/backend/types.d.ts.map +0 -1
  308. package/tech/build/babel.d.ts +0 -13
  309. package/tech/build/babel.d.ts.map +0 -1
  310. package/tech/build/detect-all.d.ts +0 -13
  311. package/tech/build/detect-all.d.ts.map +0 -1
  312. package/tech/build/esbuild.d.ts +0 -11
  313. package/tech/build/esbuild.d.ts.map +0 -1
  314. package/tech/build/index.cjs.js.map +0 -1
  315. package/tech/build/index.esm.js.map +0 -1
  316. package/tech/build/parcel.d.ts +0 -13
  317. package/tech/build/parcel.d.ts.map +0 -1
  318. package/tech/build/rollup.d.ts +0 -13
  319. package/tech/build/rollup.d.ts.map +0 -1
  320. package/tech/build/swc.d.ts +0 -13
  321. package/tech/build/swc.d.ts.map +0 -1
  322. package/tech/build/types.d.ts +0 -31
  323. package/tech/build/types.d.ts.map +0 -1
  324. package/tech/build/vite.d.ts +0 -13
  325. package/tech/build/vite.d.ts.map +0 -1
  326. package/tech/build/webpack.d.ts +0 -13
  327. package/tech/build/webpack.d.ts.map +0 -1
  328. package/tech/frontend/angular.d.ts +0 -11
  329. package/tech/frontend/angular.d.ts.map +0 -1
  330. package/tech/frontend/astro.d.ts +0 -11
  331. package/tech/frontend/astro.d.ts.map +0 -1
  332. package/tech/frontend/detect-all.d.ts +0 -13
  333. package/tech/frontend/detect-all.d.ts.map +0 -1
  334. package/tech/frontend/gatsby.d.ts +0 -11
  335. package/tech/frontend/gatsby.d.ts.map +0 -1
  336. package/tech/frontend/index.cjs.js.map +0 -1
  337. package/tech/frontend/index.esm.js.map +0 -1
  338. package/tech/frontend/nextjs.d.ts +0 -11
  339. package/tech/frontend/nextjs.d.ts.map +0 -1
  340. package/tech/frontend/nuxt.d.ts +0 -11
  341. package/tech/frontend/nuxt.d.ts.map +0 -1
  342. package/tech/frontend/qwik.d.ts +0 -11
  343. package/tech/frontend/qwik.d.ts.map +0 -1
  344. package/tech/frontend/react.d.ts +0 -11
  345. package/tech/frontend/react.d.ts.map +0 -1
  346. package/tech/frontend/remix.d.ts +0 -11
  347. package/tech/frontend/remix.d.ts.map +0 -1
  348. package/tech/frontend/solid.d.ts +0 -11
  349. package/tech/frontend/solid.d.ts.map +0 -1
  350. package/tech/frontend/svelte.d.ts +0 -11
  351. package/tech/frontend/svelte.d.ts.map +0 -1
  352. package/tech/frontend/sveltekit.d.ts +0 -11
  353. package/tech/frontend/sveltekit.d.ts.map +0 -1
  354. package/tech/frontend/types.d.ts +0 -35
  355. package/tech/frontend/types.d.ts.map +0 -1
  356. package/tech/frontend/vue.d.ts +0 -11
  357. package/tech/frontend/vue.d.ts.map +0 -1
  358. package/tech/index.cjs.js.map +0 -1
  359. package/tech/index.esm.js.map +0 -1
  360. package/tech/legacy/angularjs.d.ts +0 -12
  361. package/tech/legacy/angularjs.d.ts.map +0 -1
  362. package/tech/legacy/backbone.d.ts +0 -11
  363. package/tech/legacy/backbone.d.ts.map +0 -1
  364. package/tech/legacy/detect-all.d.ts +0 -13
  365. package/tech/legacy/detect-all.d.ts.map +0 -1
  366. package/tech/legacy/ember.d.ts +0 -11
  367. package/tech/legacy/ember.d.ts.map +0 -1
  368. package/tech/legacy/index.cjs.js.map +0 -1
  369. package/tech/legacy/index.esm.js.map +0 -1
  370. package/tech/legacy/jquery.d.ts +0 -11
  371. package/tech/legacy/jquery.d.ts.map +0 -1
  372. package/tech/legacy/types.d.ts +0 -33
  373. package/tech/legacy/types.d.ts.map +0 -1
  374. package/tech/linting/biome.d.ts +0 -11
  375. package/tech/linting/biome.d.ts.map +0 -1
  376. package/tech/linting/detect-all.d.ts +0 -13
  377. package/tech/linting/detect-all.d.ts.map +0 -1
  378. package/tech/linting/eslint.d.ts +0 -13
  379. package/tech/linting/eslint.d.ts.map +0 -1
  380. package/tech/linting/index.cjs.js.map +0 -1
  381. package/tech/linting/index.esm.js.map +0 -1
  382. package/tech/linting/prettier.d.ts +0 -13
  383. package/tech/linting/prettier.d.ts.map +0 -1
  384. package/tech/linting/stylelint.d.ts +0 -13
  385. package/tech/linting/stylelint.d.ts.map +0 -1
  386. package/tech/linting/types.d.ts +0 -31
  387. package/tech/linting/types.d.ts.map +0 -1
  388. package/tech/monorepo/detect-all.d.ts +0 -13
  389. package/tech/monorepo/detect-all.d.ts.map +0 -1
  390. package/tech/monorepo/index.cjs.js.map +0 -1
  391. package/tech/monorepo/index.esm.js.map +0 -1
  392. package/tech/monorepo/lerna.d.ts +0 -11
  393. package/tech/monorepo/lerna.d.ts.map +0 -1
  394. package/tech/monorepo/npm-workspaces.d.ts +0 -11
  395. package/tech/monorepo/npm-workspaces.d.ts.map +0 -1
  396. package/tech/monorepo/nx.d.ts +0 -11
  397. package/tech/monorepo/nx.d.ts.map +0 -1
  398. package/tech/monorepo/pnpm-workspaces.d.ts +0 -9
  399. package/tech/monorepo/pnpm-workspaces.d.ts.map +0 -1
  400. package/tech/monorepo/rush.d.ts +0 -11
  401. package/tech/monorepo/rush.d.ts.map +0 -1
  402. package/tech/monorepo/turborepo.d.ts +0 -11
  403. package/tech/monorepo/turborepo.d.ts.map +0 -1
  404. package/tech/monorepo/types.d.ts +0 -39
  405. package/tech/monorepo/types.d.ts.map +0 -1
  406. package/tech/monorepo/yarn-workspaces.d.ts +0 -11
  407. package/tech/monorepo/yarn-workspaces.d.ts.map +0 -1
  408. package/tech/shared-utils/detector-helpers.d.ts +0 -52
  409. package/tech/shared-utils/detector-helpers.d.ts.map +0 -1
  410. package/tech/shared-utils/types.d.ts +0 -41
  411. package/tech/shared-utils/types.d.ts.map +0 -1
  412. package/tech/testing/cypress.d.ts +0 -13
  413. package/tech/testing/cypress.d.ts.map +0 -1
  414. package/tech/testing/detect-all.d.ts +0 -13
  415. package/tech/testing/detect-all.d.ts.map +0 -1
  416. package/tech/testing/index.cjs.js.map +0 -1
  417. package/tech/testing/index.esm.js.map +0 -1
  418. package/tech/testing/jest.d.ts +0 -13
  419. package/tech/testing/jest.d.ts.map +0 -1
  420. package/tech/testing/mocha.d.ts +0 -13
  421. package/tech/testing/mocha.d.ts.map +0 -1
  422. package/tech/testing/playwright.d.ts +0 -13
  423. package/tech/testing/playwright.d.ts.map +0 -1
  424. package/tech/testing/types.d.ts +0 -35
  425. package/tech/testing/types.d.ts.map +0 -1
  426. package/tech/testing/vitest.d.ts +0 -13
  427. package/tech/testing/vitest.d.ts.map +0 -1
  428. package/tech/types/detectors.d.ts +0 -67
  429. package/tech/types/detectors.d.ts.map +0 -1
  430. package/tech/types/index.cjs.js.map +0 -1
  431. package/tech/types/index.esm.js.map +0 -1
  432. package/vfs/commit.d.ts +0 -32
  433. package/vfs/commit.d.ts.map +0 -1
  434. package/vfs/diff.d.ts +0 -73
  435. package/vfs/diff.d.ts.map +0 -1
  436. package/vfs/factory.d.ts +0 -37
  437. package/vfs/factory.d.ts.map +0 -1
  438. package/vfs/fs-tree.d.ts +0 -13
  439. package/vfs/fs-tree.d.ts.map +0 -1
  440. package/vfs/index.cjs.js.map +0 -1
  441. package/vfs/index.esm.js.map +0 -1
  442. package/vfs/types.d.ts +0 -179
  443. package/vfs/types.d.ts.map +0 -1
@@ -1,387 +1,23 @@
1
1
  'use strict';
2
2
 
3
- var node_path = require('node:path');
4
- var node_fs = require('node:fs');
5
-
6
- /**
7
- * Safe copies of Error built-ins via factory functions.
8
- *
9
- * Since constructors cannot be safely captured via Object.assign, this module
10
- * provides factory functions that use Reflect.construct internally.
11
- *
12
- * These references are captured at module initialization time to protect against
13
- * prototype pollution attacks. Import only what you need for tree-shaking.
14
- *
15
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/error
16
- */
17
- const _Error = globalThis.Error;
18
- const _Reflect$1 = globalThis.Reflect;
19
- /**
20
- * (Safe copy) Creates a new Error using the captured Error constructor.
21
- * Use this instead of `new Error()`.
22
- *
23
- * @param message - Optional error message.
24
- * @param options - Optional error options.
25
- * @returns A new Error instance.
26
- */
27
- const createError = (message, options) => _Reflect$1.construct(_Error, [message, options]);
28
-
29
- /**
30
- * Safe copies of JSON built-in methods.
31
- *
32
- * These references are captured at module initialization time to protect against
33
- * prototype pollution attacks. Import only what you need for tree-shaking.
34
- *
35
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/json
36
- */
37
- const _JSON = globalThis.JSON;
38
- /**
39
- * (Safe copy) Converts a JavaScript Object Notation (JSON) string into an object.
40
- */
41
- const parse = _JSON.parse;
42
- /**
43
- * (Safe copy) Converts a JavaScript value to a JavaScript Object Notation (JSON) string.
44
- */
45
- const stringify = _JSON.stringify;
46
-
47
- /**
48
- * Safe copies of Object built-in methods.
49
- *
50
- * These references are captured at module initialization time to protect against
51
- * prototype pollution attacks. Import only what you need for tree-shaking.
52
- *
53
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/object
54
- */
55
- const _Object = globalThis.Object;
56
- /**
57
- * (Safe copy) Prevents modification of existing property attributes and values,
58
- * and prevents the addition of new properties.
59
- */
60
- const freeze = _Object.freeze;
61
- /**
62
- * (Safe copy) Returns the names of the enumerable string properties and methods of an object.
63
- */
64
- const keys = _Object.keys;
65
- /**
66
- * (Safe copy) Returns an array of key/values of the enumerable own properties of an object.
67
- */
68
- const entries = _Object.entries;
69
- /**
70
- * (Safe copy) Returns an array of values of the enumerable own properties of an object.
71
- */
72
- const values = _Object.values;
73
-
74
- /**
75
- * Safe copies of Array built-in static methods.
76
- *
77
- * These references are captured at module initialization time to protect against
78
- * prototype pollution attacks. Import only what you need for tree-shaking.
79
- *
80
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/array
81
- */
82
- const _Array = globalThis.Array;
83
- /**
84
- * (Safe copy) Determines whether the passed value is an Array.
85
- */
86
- const isArray = _Array.isArray;
87
-
88
- /**
89
- * Safe copies of Console built-in methods.
90
- *
91
- * These references are captured at module initialization time to protect against
92
- * prototype pollution attacks. Import only what you need for tree-shaking.
93
- *
94
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/console
95
- */
96
- const _console = globalThis.console;
97
- /**
98
- * (Safe copy) Outputs a message to the console.
99
- */
100
- const log = _console.log.bind(_console);
101
- /**
102
- * (Safe copy) Outputs a warning message to the console.
103
- */
104
- const warn = _console.warn.bind(_console);
105
- /**
106
- * (Safe copy) Outputs an error message to the console.
107
- */
108
- const error = _console.error.bind(_console);
109
- /**
110
- * (Safe copy) Outputs an informational message to the console.
111
- */
112
- const info = _console.info.bind(_console);
113
- /**
114
- * (Safe copy) Outputs a debug message to the console.
115
- */
116
- const debug = _console.debug.bind(_console);
117
- /**
118
- * (Safe copy) Outputs a stack trace to the console.
119
- */
120
- _console.trace.bind(_console);
121
- /**
122
- * (Safe copy) Displays an interactive listing of the properties of a specified object.
123
- */
124
- _console.dir.bind(_console);
125
- /**
126
- * (Safe copy) Displays tabular data as a table.
127
- */
128
- _console.table.bind(_console);
129
- /**
130
- * (Safe copy) Writes an error message to the console if the assertion is false.
131
- */
132
- _console.assert.bind(_console);
133
- /**
134
- * (Safe copy) Clears the console.
135
- */
136
- _console.clear.bind(_console);
137
- /**
138
- * (Safe copy) Logs the number of times that this particular call to count() has been called.
139
- */
140
- _console.count.bind(_console);
141
- /**
142
- * (Safe copy) Resets the counter used with console.count().
143
- */
144
- _console.countReset.bind(_console);
145
- /**
146
- * (Safe copy) Creates a new inline group in the console.
147
- */
148
- _console.group.bind(_console);
149
- /**
150
- * (Safe copy) Creates a new inline group in the console that is initially collapsed.
151
- */
152
- _console.groupCollapsed.bind(_console);
153
- /**
154
- * (Safe copy) Exits the current inline group.
155
- */
156
- _console.groupEnd.bind(_console);
157
- /**
158
- * (Safe copy) Starts a timer with a name specified as an input parameter.
159
- */
160
- _console.time.bind(_console);
161
- /**
162
- * (Safe copy) Stops a timer that was previously started.
163
- */
164
- _console.timeEnd.bind(_console);
165
- /**
166
- * (Safe copy) Logs the current value of a timer that was previously started.
167
- */
168
- _console.timeLog.bind(_console);
169
-
170
- /**
171
- * Safe copies of Set built-in via factory function.
172
- *
173
- * Since constructors cannot be safely captured via Object.assign, this module
174
- * provides a factory function that uses Reflect.construct internally.
175
- *
176
- * These references are captured at module initialization time to protect against
177
- * prototype pollution attacks. Import only what you need for tree-shaking.
178
- *
179
- * @module @hyperfrontend/immutable-api-utils/built-in-copy/set
180
- */
181
- const _Set = globalThis.Set;
182
- const _Reflect = globalThis.Reflect;
183
- /**
184
- * (Safe copy) Creates a new Set using the captured Set constructor.
185
- * Use this instead of `new Set()`.
186
- *
187
- * @param iterable - Optional iterable of values.
188
- * @returns A new Set instance.
189
- */
190
- const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
191
-
192
- const registeredClasses = [];
193
-
194
- /**
195
- * Returns the data type of the target.
196
- * Uses native `typeof` operator, however, makes distinction between `null`, `array`, and `object`.
197
- * Also, when classes are registered via `registerClass`, it checks if objects are instance of any known registered class.
198
- *
199
- * @param target - The target to get the data type of.
200
- * @returns The data type of the target.
201
- */
202
- const getType = (target) => {
203
- if (target === null)
204
- return 'null';
205
- const nativeDataType = typeof target;
206
- if (nativeDataType === 'object') {
207
- if (isArray(target))
208
- return 'array';
209
- for (const registeredClass of registeredClasses) {
210
- if (target instanceof registeredClass)
211
- return registeredClass.name;
212
- }
213
- }
214
- return nativeDataType;
215
- };
216
-
217
- /* eslint-disable @typescript-eslint/no-explicit-any */
218
- /**
219
- * Creates a wrapper function that only executes the wrapped function if the condition function returns true.
220
- *
221
- * @param func - The function to be conditionally executed.
222
- * @param conditionFunc - A function that returns a boolean, determining if `func` should be executed.
223
- * @returns A wrapped version of `func` that executes conditionally.
224
- */
225
- function createConditionalExecutionFunction(func, conditionFunc) {
226
- return function (...args) {
227
- if (conditionFunc()) {
228
- return func(...args);
229
- }
230
- };
231
- }
232
-
233
- /* eslint-disable @typescript-eslint/no-explicit-any */
234
- /**
235
- * Creates a wrapper function that silently ignores any errors thrown by the wrapped void function.
236
- * This function is specifically for wrapping functions that do not return a value (void functions).
237
- * Exceptions are swallowed without any logging or handling.
238
- *
239
- * @param func - The void function to be wrapped.
240
- * @returns A wrapped version of the input function that ignores errors.
241
- */
242
- function createErrorIgnoringFunction(func) {
243
- return function (...args) {
244
- try {
245
- func(...args);
246
- }
247
- catch {
248
- // Deliberately swallowing/ignoring the exception
249
- }
250
- };
251
- }
252
-
253
- /* eslint-disable @typescript-eslint/no-unused-vars */
254
- /**
255
- * A no-operation function (noop) that does nothing regardless of the arguments passed.
256
- * It is designed to be as permissive as possible in its typing without using the `Function` keyword.
257
- *
258
- * @param args - Any arguments passed to the function (ignored)
259
- */
260
- const noop = (...args) => {
261
- // Intentionally does nothing
262
- };
263
-
264
- const logLevels = ['none', 'error', 'warn', 'log', 'info', 'debug'];
265
- const priority = {
266
- error: 4,
267
- warn: 3,
268
- log: 2,
269
- info: 1,
270
- debug: 0,
271
- };
272
- /**
273
- * Validates whether a given string is a valid log level.
274
- *
275
- * @param level - The log level to validate
276
- * @returns True if the level is valid, false otherwise
277
- */
278
- function isValidLogLevel(level) {
279
- return logLevels.includes(level);
280
- }
281
- /**
282
- * Creates a log level configuration manager for controlling logging behavior.
283
- * Provides methods to get, set, and evaluate log levels based on priority.
284
- *
285
- * @param level - The initial log level (defaults to 'error')
286
- * @returns A configuration object with log level management methods
287
- * @throws {Error} When the provided level is not a valid log level
288
- */
289
- function createLogLevelConfig(level = 'error') {
290
- if (!isValidLogLevel(level)) {
291
- throw createError('Cannot create log level configuration with a valid default log level');
292
- }
293
- const state = { level };
294
- const getLogLevel = () => state.level;
295
- const setLogLevel = (level) => {
296
- if (!isValidLogLevel(level)) {
297
- throw createError(`Cannot set value '${level}' level. Expected levels are ${logLevels}.`);
298
- }
299
- state.level = level;
300
- };
301
- const shouldLog = (level) => {
302
- if (state.level === 'none' || level === 'none' || !isValidLogLevel(level)) {
303
- return false;
304
- }
305
- return priority[level] >= priority[state.level];
306
- };
307
- return freeze({
308
- getLogLevel,
309
- setLogLevel,
310
- shouldLog,
311
- });
312
- }
313
-
314
- /**
315
- * Creates a logger instance with configurable log level filtering.
316
- * Each log function is wrapped to respect the current log level setting.
317
- *
318
- * @param error - Function to handle error-level logs (required)
319
- * @param warn - Function to handle warning-level logs (optional, defaults to noop)
320
- * @param log - Function to handle standard logs (optional, defaults to noop)
321
- * @param info - Function to handle info-level logs (optional, defaults to noop)
322
- * @param debug - Function to handle debug-level logs (optional, defaults to noop)
323
- * @returns A frozen logger object with log methods and level control
324
- * @throws {ErrorLevelFn} When any provided log function is invalid
325
- */
326
- function createLogger(error, warn = noop, log = noop, info = noop, debug = noop) {
327
- if (notValidLogFn(error)) {
328
- throw createError(notFnMsg('error'));
329
- }
330
- if (notValidLogFn(warn)) {
331
- throw createError(notFnMsg('warn'));
332
- }
333
- if (notValidLogFn(log)) {
334
- throw createError(notFnMsg('log'));
335
- }
336
- if (notValidLogFn(info)) {
337
- throw createError(notFnMsg('info'));
338
- }
339
- if (notValidLogFn(debug)) {
340
- throw createError(notFnMsg('debug'));
341
- }
342
- const { setLogLevel, getLogLevel, shouldLog } = createLogLevelConfig();
343
- const wrapLogFn = (fn, level) => {
344
- if (fn === noop)
345
- return fn;
346
- const condition = () => shouldLog(level);
347
- return createConditionalExecutionFunction(createErrorIgnoringFunction(fn), condition);
348
- };
349
- return freeze({
350
- error: wrapLogFn(error, 'error'),
351
- warn: wrapLogFn(warn, 'warn'),
352
- log: wrapLogFn(log, 'log'),
353
- info: wrapLogFn(info, 'info'),
354
- debug: wrapLogFn(debug, 'debug'),
355
- setLogLevel,
356
- getLogLevel,
357
- });
358
- }
359
- /**
360
- * Validates whether a given value is a valid log function.
361
- *
362
- * @param fn - The value to validate
363
- * @returns True if the value is not a function (invalid), false if it is valid
364
- */
365
- function notValidLogFn(fn) {
366
- return getType(fn) !== 'function' && fn !== noop;
367
- }
368
- /**
369
- * Generates an error message for invalid log function parameters.
370
- *
371
- * @param label - The name of the log function that failed validation
372
- * @returns A formatted error message string
373
- */
374
- function notFnMsg(label) {
375
- return `Cannot create a logger when ${label} is not a function`;
376
- }
377
-
378
- createLogger(error, warn, log, info, debug);
3
+ const node_path = require('node:path');
4
+ const node_fs = require('node:fs');
5
+ const index_cjs_js$4 = require('../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/array/index.cjs.js');
6
+ const index_cjs_js$3 = require('../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/console/index.cjs.js');
7
+ const index_cjs_js$5 = require('../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/json/index.cjs.js');
8
+ const index_cjs_js$2 = require('../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.cjs.js');
9
+ const index_cjs_js = require('../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/set/index.cjs.js');
10
+ const index_cjs_js$1 = require('../../_dependencies/@hyperfrontend/logging/index.cjs.js');
11
+ const index_cjs_js$6 = require('../../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/error/index.cjs.js');
12
+ const { isSafePath } = require('../../_shared/core/fs/guard/index.cjs.js');
13
+ const { exists } = require('../../_shared/core/fs/stat/index.cjs.js');
14
+ const { join } = require('../../_shared/core/path/join/index.cjs.js');
379
15
 
380
16
  /**
381
17
  * Global log level registry.
382
18
  * Tracks all created scoped loggers to allow global log level changes.
383
19
  */
384
- const loggerRegistry = createSet();
20
+ const loggerRegistry = index_cjs_js.createSet();
385
21
  /** Redacted placeholder for sensitive values */
386
22
  const REDACTED = '[REDACTED]';
387
23
  /**
@@ -415,17 +51,24 @@ function isSensitiveKey(key) {
415
51
  *
416
52
  * @param obj - Object to sanitize
417
53
  * @returns New object with sensitive values redacted
54
+ *
55
+ * @example Sanitizing sensitive data
56
+ * ```typescript
57
+ * const config = { apiKey: 'secret123', endpoint: 'https://api.example.com' }
58
+ * const safe = sanitize(config)
59
+ * // => { apiKey: '[REDACTED]', endpoint: 'https://api.example.com' }
60
+ * ```
418
61
  */
419
62
  function sanitize(obj) {
420
63
  if (obj === null || obj === undefined) {
421
64
  return obj;
422
65
  }
423
- if (isArray(obj)) {
66
+ if (index_cjs_js$4.isArray(obj)) {
424
67
  return obj.map((item) => sanitize(item));
425
68
  }
426
69
  if (typeof obj === 'object') {
427
70
  const result = {};
428
- for (const [key, value] of entries(obj)) {
71
+ for (const [key, value] of index_cjs_js$2.entries(obj)) {
429
72
  if (isSensitiveKey(key)) {
430
73
  result[key] = REDACTED;
431
74
  }
@@ -450,9 +93,9 @@ function sanitize(obj) {
450
93
  */
451
94
  function formatMessage(namespace, message, meta) {
452
95
  const prefix = `[${namespace}]`;
453
- if (meta && keys(meta).length > 0) {
96
+ if (meta && index_cjs_js$2.keys(meta).length > 0) {
454
97
  const sanitizedMeta = sanitize(meta);
455
- return `${prefix} ${message} ${stringify(sanitizedMeta)}`;
98
+ return `${prefix} ${message} ${index_cjs_js$5.stringify(sanitizedMeta)}`;
456
99
  }
457
100
  return `${prefix} ${message}`;
458
101
  }
@@ -465,7 +108,7 @@ function formatMessage(namespace, message, meta) {
465
108
  * @param options - Logger configuration options
466
109
  * @returns A configured scoped logger instance
467
110
  *
468
- * @example
111
+ * @example Creating a scoped logger
469
112
  * ```typescript
470
113
  * const logger = createScopedLogger('project-scope')
471
114
  * logger.setLogLevel('debug')
@@ -484,9 +127,9 @@ function createScopedLogger(namespace, options = {}) {
484
127
  const processedMeta = sanitizeSecrets && meta ? sanitize(meta) : meta;
485
128
  baseFn(formatMessage(namespace, message, processedMeta));
486
129
  };
487
- const baseLogger = createLogger(createLogFn(error), createLogFn(warn), createLogFn(log), createLogFn(info), createLogFn(debug));
130
+ const baseLogger = index_cjs_js$1.createLogger(createLogFn(index_cjs_js$3.error), createLogFn(index_cjs_js$3.warn), createLogFn(index_cjs_js$3.log), createLogFn(index_cjs_js$3.info), createLogFn(index_cjs_js$3.debug));
488
131
  baseLogger.setLogLevel(level);
489
- const scopedLogger = freeze({
132
+ const scopedLogger = index_cjs_js$2.freeze({
490
133
  error: (message, meta) => baseLogger.error(message, meta),
491
134
  warn: (message, meta) => baseLogger.warn(message, meta),
492
135
  log: (message, meta) => baseLogger.log(message, meta),
@@ -502,7 +145,7 @@ function createScopedLogger(namespace, options = {}) {
502
145
  * Default logger instance for the project-scope library.
503
146
  * Use this for general logging within the library.
504
147
  *
505
- * @example
148
+ * @example Using the default logger
506
149
  * ```typescript
507
150
  * import { logger } from '@hyperfrontend/project-scope/core'
508
151
  *
@@ -519,9 +162,17 @@ createScopedLogger('project-scope:fs');
519
162
  * @param filePath - Path to file
520
163
  * @param encoding - File encoding (default: utf-8)
521
164
  * @returns File contents or null if file doesn't exist
165
+ *
166
+ * @example Reading file if it exists
167
+ * ```typescript
168
+ * const content = readFileIfExists('./optional-config.json')
169
+ * if (content) {
170
+ * // File existed, use content
171
+ * }
172
+ * ```
522
173
  */
523
174
  function readFileIfExists(filePath, encoding = 'utf-8') {
524
- if (!node_fs.existsSync(filePath)) {
175
+ if (!isSafePath(filePath) || !node_fs.existsSync(filePath)) {
525
176
  return null;
526
177
  }
527
178
  try {
@@ -532,31 +183,8 @@ function readFileIfExists(filePath, encoding = 'utf-8') {
532
183
  }
533
184
  }
534
185
 
535
- createScopedLogger('project-scope:fs:write');
536
-
537
- /**
538
- * Check if path exists.
539
- *
540
- * @param filePath - Path to check
541
- * @returns True if path exists
542
- */
543
- function exists(filePath) {
544
- return node_fs.existsSync(filePath);
545
- }
546
-
547
186
  createScopedLogger('project-scope:fs:dir');
548
187
 
549
- /**
550
- * Join path segments.
551
- * Uses platform-specific separators (e.g., / or \).
552
- *
553
- * @param paths - Path segments to join
554
- * @returns Joined path
555
- */
556
- function join(...paths) {
557
- return node_path.join(...paths);
558
- }
559
-
560
188
  const fsTraversalLogger = createScopedLogger('project-scope:fs:traversal');
561
189
  /**
562
190
  * Generic upward directory traversal.
@@ -565,6 +193,15 @@ const fsTraversalLogger = createScopedLogger('project-scope:fs:traversal');
565
193
  * @param startPath - Starting directory
566
194
  * @param predicate - Function to test each directory
567
195
  * @returns First matching directory or null
196
+ *
197
+ * @example Finding directory containing README
198
+ * ```typescript
199
+ * // Find first directory containing a README
200
+ * const readmeDir = traverseUpward('./src/utils', (dir) =>
201
+ * existsSync(join(dir, 'README.md'))
202
+ * )
203
+ * // => '/project' or null
204
+ * ```
568
205
  */
569
206
  function traverseUpward(startPath, predicate) {
570
207
  fsTraversalLogger.debug('Starting upward traversal', { startPath });
@@ -590,6 +227,17 @@ function traverseUpward(startPath, predicate) {
590
227
  * @param startPath - Starting directory
591
228
  * @param markers - Array of marker file names to search for
592
229
  * @returns First directory containing any marker, or null
230
+ *
231
+ * @example Finding project root by marker files
232
+ * ```typescript
233
+ * // Find project root by looking for common marker files
234
+ * const projectRoot = locateByMarkers('./src/components', [
235
+ * 'package.json',
236
+ * 'nx.json',
237
+ * 'tsconfig.base.json'
238
+ * ])
239
+ * // => '/workspace/my-project'
240
+ * ```
593
241
  */
594
242
  function locateByMarkers(startPath, markers) {
595
243
  fsTraversalLogger.debug('Locating by markers', { startPath, markers });
@@ -605,12 +253,22 @@ function locateByMarkers(startPath, markers) {
605
253
  * @param startPath - Starting directory
606
254
  * @param test - Function to test if directory matches criteria
607
255
  * @returns Matching directory path or null
256
+ *
257
+ * @example Finding directory with specific config
258
+ * ```typescript
259
+ * // Find directory with a specific config
260
+ * const configDir = findUpwardWhere('./deep/nested/path', (dir) =>
261
+ * existsSync(join(dir, '.eslintrc.js'))
262
+ * )
263
+ * ```
608
264
  */
609
265
  function findUpwardWhere(startPath, test) {
610
266
  fsTraversalLogger.debug('Finding upward where condition met', { startPath });
611
267
  return traverseUpward(startPath, test);
612
268
  }
613
269
 
270
+ createScopedLogger('project-scope:fs:write');
271
+
614
272
  const packageLogger = createScopedLogger('project-scope:project:package');
615
273
  /**
616
274
  * Verifies that a value is an object with only string values,
@@ -622,7 +280,7 @@ const packageLogger = createScopedLogger('project-scope:project:package');
622
280
  function isStringRecord(value) {
623
281
  if (typeof value !== 'object' || value === null)
624
282
  return false;
625
- return values(value).every((v) => typeof v === 'string');
283
+ return index_cjs_js$2.values(value).every((v) => typeof v === 'string');
626
284
  }
627
285
  /**
628
286
  * Extracts and normalizes the workspaces field from package.json,
@@ -632,12 +290,12 @@ function isStringRecord(value) {
632
290
  * @returns Normalized workspace patterns or undefined if invalid
633
291
  */
634
292
  function parseWorkspaces(value) {
635
- if (isArray(value) && value.every((v) => typeof v === 'string')) {
293
+ if (index_cjs_js$4.isArray(value) && value.every((v) => typeof v === 'string')) {
636
294
  return value;
637
295
  }
638
296
  if (typeof value === 'object' && value !== null) {
639
297
  const obj = value;
640
- if (isArray(obj['packages'])) {
298
+ if (index_cjs_js$4.isArray(obj['packages'])) {
641
299
  return { packages: obj['packages'] };
642
300
  }
643
301
  }
@@ -651,7 +309,7 @@ function parseWorkspaces(value) {
651
309
  */
652
310
  function validatePackageJson(data) {
653
311
  if (typeof data !== 'object' || data === null) {
654
- throw createError('package.json must be an object');
312
+ throw index_cjs_js$6.createError('package.json must be an object');
655
313
  }
656
314
  const pkg = data;
657
315
  return {
@@ -680,6 +338,16 @@ function validatePackageJson(data) {
680
338
  *
681
339
  * @param projectPath - Project directory path or path to package.json
682
340
  * @returns Parsed package.json or null if not found
341
+ *
342
+ * @example Reading package.json if it exists
343
+ * ```typescript
344
+ * import { readPackageJsonIfExists } from '@hyperfrontend/project-scope'
345
+ *
346
+ * const pkg = readPackageJsonIfExists('/path/to/project')
347
+ * if (pkg) {
348
+ * console.log('Found:', pkg.name)
349
+ * }
350
+ * ```
683
351
  */
684
352
  function readPackageJsonIfExists(projectPath) {
685
353
  const packageJsonPath = projectPath.endsWith('package.json') ? projectPath : node_path.join(projectPath, 'package.json');
@@ -689,7 +357,7 @@ function readPackageJsonIfExists(projectPath) {
689
357
  return null;
690
358
  }
691
359
  try {
692
- const validated = validatePackageJson(parse(content));
360
+ const validated = validatePackageJson(index_cjs_js$5.parse(content));
693
361
  packageLogger.debug('Package.json loaded', { path: packageJsonPath, name: validated.name });
694
362
  return validated;
695
363
  }
@@ -703,6 +371,14 @@ function readPackageJsonIfExists(projectPath) {
703
371
  *
704
372
  * @param startPath - Starting path
705
373
  * @returns Path to directory containing package.json, or null if not found
374
+ *
375
+ * @example Finding nearest package.json
376
+ * ```typescript
377
+ * import { findNearestPackageJson } from '@hyperfrontend/project-scope'
378
+ *
379
+ * const pkgDir = findNearestPackageJson('./src/deep/nested/file.ts')
380
+ * // => '/path/to/project'
381
+ * ```
706
382
  */
707
383
  function findNearestPackageJson(startPath) {
708
384
  return locateByMarkers(startPath, ['package.json']);
@@ -746,7 +422,7 @@ function looksLikeProjectDir(dirPath) {
746
422
  * @param startPath - Starting path
747
423
  * @returns Project root path or null
748
424
  *
749
- * @example
425
+ * @example Finding project root
750
426
  * ```typescript
751
427
  * import { findProjectRoot } from '@hyperfrontend/project-scope'
752
428
  *
@@ -786,7 +462,7 @@ function findProjectRoot(startPath) {
786
462
  * @param startPath - Starting path
787
463
  * @returns Workspace root path or null
788
464
  *
789
- * @example
465
+ * @example Finding workspace root
790
466
  * ```typescript
791
467
  * import { findWorkspaceRoot } from '@hyperfrontend/project-scope'
792
468
  *
@@ -826,6 +502,15 @@ function findWorkspaceRoot(startPath) {
826
502
  * @param startPath - Starting path
827
503
  * @param markers - Files to search for
828
504
  * @returns Root directory path or null
505
+ *
506
+ * @example Finding root by marker files
507
+ * ```typescript
508
+ * import { findRootDirectory } from '@hyperfrontend/project-scope'
509
+ *
510
+ * // Find monorepo root by looking for nx.json or lerna.json
511
+ * const root = findRootDirectory('./libs/my-lib', ['nx.json', 'lerna.json'])
512
+ * // => '/path/to/monorepo'
513
+ * ```
829
514
  */
830
515
  function findRootDirectory(startPath, markers) {
831
516
  return locateByMarkers(startPath, markers);
@@ -835,6 +520,14 @@ function findRootDirectory(startPath, markers) {
835
520
  *
836
521
  * @param startPath - Starting path
837
522
  * @returns Git root path or null
523
+ *
524
+ * @example Finding Git repository root
525
+ * ```typescript
526
+ * import { findGitRoot } from '@hyperfrontend/project-scope'
527
+ *
528
+ * const gitRoot = findGitRoot('./src/deep/nested/file.ts')
529
+ * // => '/path/to/repository'
530
+ * ```
838
531
  */
839
532
  function findGitRoot(startPath) {
840
533
  return locateByMarkers(startPath, ['.git']);
@@ -846,4 +539,3 @@ exports.findGitRoot = findGitRoot;
846
539
  exports.findProjectRoot = findProjectRoot;
847
540
  exports.findRootDirectory = findRootDirectory;
848
541
  exports.findWorkspaceRoot = findWorkspaceRoot;
849
- //# sourceMappingURL=index.cjs.js.map