@cbnventures/nova 0.27.4 → 0.29.0

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 (409) hide show
  1. package/build/package.json +18 -9
  2. package/build/src/cli/generate/docker-image/index.d.ts +9 -0
  3. package/build/src/cli/generate/docker-image/index.d.ts.map +1 -0
  4. package/build/src/cli/generate/docker-image/index.js +189 -0
  5. package/build/src/cli/generate/docker-image/index.js.map +1 -0
  6. package/build/src/cli/generate/github/issue-template.d.ts.map +1 -1
  7. package/build/src/cli/generate/github/issue-template.js +9 -14
  8. package/build/src/cli/generate/github/issue-template.js.map +1 -1
  9. package/build/src/cli/generate/must-haves/read-me.d.ts.map +1 -1
  10. package/build/src/cli/generate/must-haves/read-me.js +55 -22
  11. package/build/src/cli/generate/must-haves/read-me.js.map +1 -1
  12. package/build/src/cli/index.js +178 -14
  13. package/build/src/cli/index.js.map +1 -1
  14. package/build/src/cli/recipe/package-json/normalize-modules.d.ts.map +1 -1
  15. package/build/src/cli/recipe/package-json/normalize-modules.js +1 -0
  16. package/build/src/cli/recipe/package-json/normalize-modules.js.map +1 -1
  17. package/build/src/cli/recipe/read-me/update-badges.d.ts.map +1 -1
  18. package/build/src/cli/recipe/read-me/update-badges.js +0 -4
  19. package/build/src/cli/recipe/read-me/update-badges.js.map +1 -1
  20. package/build/src/cli/scaffold/app/android.d.ts +6 -0
  21. package/build/src/cli/scaffold/app/android.d.ts.map +1 -0
  22. package/build/src/cli/scaffold/app/android.js +60 -0
  23. package/build/src/cli/scaffold/app/android.js.map +1 -0
  24. package/build/src/cli/scaffold/app/apple.d.ts +5 -0
  25. package/build/src/cli/scaffold/app/apple.d.ts.map +1 -0
  26. package/build/src/cli/scaffold/app/apple.js +13 -0
  27. package/build/src/cli/scaffold/app/apple.js.map +1 -0
  28. package/build/src/cli/scaffold/app/astro.d.ts +6 -0
  29. package/build/src/cli/scaffold/app/astro.d.ts.map +1 -0
  30. package/build/src/cli/scaffold/app/astro.js +127 -0
  31. package/build/src/cli/scaffold/app/astro.js.map +1 -0
  32. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts +5 -0
  33. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts.map +1 -0
  34. package/build/src/cli/scaffold/app/cloudflare-workers.js +13 -0
  35. package/build/src/cli/scaffold/app/cloudflare-workers.js.map +1 -0
  36. package/build/src/cli/scaffold/app/discord-bot.d.ts +5 -0
  37. package/build/src/cli/scaffold/app/discord-bot.d.ts.map +1 -0
  38. package/build/src/cli/scaffold/app/discord-bot.js +31 -0
  39. package/build/src/cli/scaffold/app/discord-bot.js.map +1 -0
  40. package/build/src/cli/scaffold/app/docker-image.d.ts +6 -0
  41. package/build/src/cli/scaffold/app/docker-image.d.ts.map +1 -0
  42. package/build/src/cli/scaffold/app/docker-image.js +91 -0
  43. package/build/src/cli/scaffold/app/docker-image.js.map +1 -0
  44. package/build/src/cli/scaffold/app/expressjs.d.ts.map +1 -1
  45. package/build/src/cli/scaffold/app/expressjs.js +24 -1
  46. package/build/src/cli/scaffold/app/expressjs.js.map +1 -1
  47. package/build/src/cli/scaffold/app/nextjs.d.ts +2 -1
  48. package/build/src/cli/scaffold/app/nextjs.d.ts.map +1 -1
  49. package/build/src/cli/scaffold/app/nextjs.js +42 -1
  50. package/build/src/cli/scaffold/app/nextjs.js.map +1 -1
  51. package/build/src/cli/scaffold/app/vite.d.ts +2 -1
  52. package/build/src/cli/scaffold/app/vite.d.ts.map +1 -1
  53. package/build/src/cli/scaffold/app/vite.js +129 -2
  54. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  55. package/build/src/cli/scaffold/docs/docusaurus.d.ts.map +1 -1
  56. package/build/src/cli/scaffold/docs/docusaurus.js +94 -4
  57. package/build/src/cli/scaffold/docs/docusaurus.js.map +1 -1
  58. package/build/src/cli/scaffold/package/github-action.d.ts +5 -0
  59. package/build/src/cli/scaffold/package/github-action.d.ts.map +1 -0
  60. package/build/src/cli/scaffold/package/github-action.js +14 -0
  61. package/build/src/cli/scaffold/package/github-action.js.map +1 -0
  62. package/build/src/cli/scaffold/package/homebridge.d.ts +6 -0
  63. package/build/src/cli/scaffold/package/homebridge.d.ts.map +1 -0
  64. package/build/src/cli/scaffold/package/homebridge.js +56 -0
  65. package/build/src/cli/scaffold/package/homebridge.js.map +1 -0
  66. package/build/src/cli/scaffold/package/node-cli.d.ts +5 -0
  67. package/build/src/cli/scaffold/package/node-cli.d.ts.map +1 -0
  68. package/build/src/cli/scaffold/package/node-cli.js +13 -0
  69. package/build/src/cli/scaffold/package/node-cli.js.map +1 -0
  70. package/build/src/cli/scaffold/package/pfsense.d.ts +5 -0
  71. package/build/src/cli/scaffold/package/pfsense.d.ts.map +1 -0
  72. package/build/src/cli/scaffold/package/pfsense.js +15 -0
  73. package/build/src/cli/scaffold/package/pfsense.js.map +1 -0
  74. package/build/src/cli/scaffold/starter/base.d.ts.map +1 -1
  75. package/build/src/cli/scaffold/starter/base.js +4 -8
  76. package/build/src/cli/scaffold/starter/base.js.map +1 -1
  77. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  78. package/build/src/cli/utility/changelog.js +30 -8
  79. package/build/src/cli/utility/changelog.js.map +1 -1
  80. package/build/src/cli/utility/initialize.d.ts +1 -0
  81. package/build/src/cli/utility/initialize.d.ts.map +1 -1
  82. package/build/src/cli/utility/initialize.js +201 -26
  83. package/build/src/cli/utility/initialize.js.map +1 -1
  84. package/build/src/cli/utility/run-scripts.d.ts.map +1 -1
  85. package/build/src/cli/utility/run-scripts.js +1 -0
  86. package/build/src/cli/utility/run-scripts.js.map +1 -1
  87. package/build/src/lib/nova-config.d.ts +1 -0
  88. package/build/src/lib/nova-config.d.ts.map +1 -1
  89. package/build/src/lib/nova-config.js +121 -4
  90. package/build/src/lib/nova-config.js.map +1 -1
  91. package/build/src/lib/regex.d.ts +16 -0
  92. package/build/src/lib/regex.d.ts.map +1 -1
  93. package/build/src/lib/regex.js +16 -0
  94. package/build/src/lib/regex.js.map +1 -1
  95. package/build/src/lib/run-scripts.d.ts +1 -0
  96. package/build/src/lib/run-scripts.d.ts.map +1 -1
  97. package/build/src/lib/run-scripts.js +23 -4
  98. package/build/src/lib/run-scripts.js.map +1 -1
  99. package/build/src/lib/scaffold.d.ts +5 -3
  100. package/build/src/lib/scaffold.d.ts.map +1 -1
  101. package/build/src/lib/scaffold.js +279 -63
  102. package/build/src/lib/scaffold.js.map +1 -1
  103. package/build/src/presets/eslint/fw-astro.d.ts.map +1 -1
  104. package/build/src/presets/eslint/fw-astro.js +33 -3
  105. package/build/src/presets/eslint/fw-astro.js.map +1 -1
  106. package/build/src/presets/eslint/fw-docusaurus.d.ts.map +1 -1
  107. package/build/src/presets/eslint/fw-docusaurus.js +55 -3
  108. package/build/src/presets/eslint/fw-docusaurus.js.map +1 -1
  109. package/build/src/presets/eslint/fw-expressjs.d.ts.map +1 -1
  110. package/build/src/presets/eslint/fw-expressjs.js +1 -2
  111. package/build/src/presets/eslint/fw-expressjs.js.map +1 -1
  112. package/build/src/presets/eslint/fw-nextjs.d.ts.map +1 -1
  113. package/build/src/presets/eslint/fw-nextjs.js +64 -3
  114. package/build/src/presets/eslint/fw-nextjs.js.map +1 -1
  115. package/build/src/presets/eslint/fw-react.d.ts +4 -0
  116. package/build/src/presets/eslint/fw-react.d.ts.map +1 -0
  117. package/build/src/presets/eslint/fw-react.js +40 -0
  118. package/build/src/presets/eslint/fw-react.js.map +1 -0
  119. package/build/src/presets/eslint/fw-svelte.d.ts +4 -0
  120. package/build/src/presets/eslint/fw-svelte.d.ts.map +1 -0
  121. package/build/src/presets/eslint/fw-svelte.js +21 -0
  122. package/build/src/presets/eslint/fw-svelte.js.map +1 -0
  123. package/build/src/presets/eslint/fw-vue.d.ts +4 -0
  124. package/build/src/presets/eslint/fw-vue.d.ts.map +1 -0
  125. package/build/src/presets/eslint/fw-vue.js +17 -0
  126. package/build/src/presets/eslint/fw-vue.js.map +1 -0
  127. package/build/src/presets/eslint/index.d.ts +3 -0
  128. package/build/src/presets/eslint/index.d.ts.map +1 -1
  129. package/build/src/presets/eslint/index.js +3 -0
  130. package/build/src/presets/eslint/index.js.map +1 -1
  131. package/build/src/presets/eslint/lang-javascript.js +1 -1
  132. package/build/src/presets/eslint/lang-javascript.js.map +1 -1
  133. package/build/src/presets/eslint/runtime-browser.d.ts.map +1 -1
  134. package/build/src/presets/eslint/runtime-browser.js +15 -1
  135. package/build/src/presets/eslint/runtime-browser.js.map +1 -1
  136. package/build/src/presets/eslint/runtime-cloudflare-workers.d.ts.map +1 -1
  137. package/build/src/presets/eslint/runtime-cloudflare-workers.js +11 -2
  138. package/build/src/presets/eslint/runtime-cloudflare-workers.js.map +1 -1
  139. package/build/src/presets/eslint/runtime-edge.d.ts.map +1 -1
  140. package/build/src/presets/eslint/runtime-edge.js +13 -1
  141. package/build/src/presets/eslint/runtime-edge.js.map +1 -1
  142. package/build/src/presets/eslint/runtime-node.d.ts.map +1 -1
  143. package/build/src/presets/eslint/runtime-node.js +5 -0
  144. package/build/src/presets/eslint/runtime-node.js.map +1 -1
  145. package/build/src/presets/eslint/runtime-service-worker.d.ts.map +1 -1
  146. package/build/src/presets/eslint/runtime-service-worker.js +13 -1
  147. package/build/src/presets/eslint/runtime-service-worker.js.map +1 -1
  148. package/build/src/presets/eslint/runtime-web-worker.d.ts.map +1 -1
  149. package/build/src/presets/eslint/runtime-web-worker.js +13 -1
  150. package/build/src/presets/eslint/runtime-web-worker.js.map +1 -1
  151. package/build/src/presets/eslint/tool-vite.d.ts.map +1 -1
  152. package/build/src/presets/eslint/tool-vite.js +15 -2
  153. package/build/src/presets/eslint/tool-vite.js.map +1 -1
  154. package/build/src/presets/tsconfig/fw-astro.json +1 -0
  155. package/build/src/presets/tsconfig/fw-expressjs.json +2 -7
  156. package/build/src/presets/tsconfig/fw-nextjs.json +7 -1
  157. package/build/src/presets/tsconfig/fw-react.json +15 -0
  158. package/build/src/presets/tsconfig/fw-svelte.json +16 -0
  159. package/build/src/presets/tsconfig/fw-vue.json +15 -0
  160. package/build/src/presets/tsconfig/tool-vite.json +1 -0
  161. package/build/src/rules/eslint/index.d.ts +1 -0
  162. package/build/src/rules/eslint/index.d.ts.map +1 -1
  163. package/build/src/rules/eslint/index.js +1 -0
  164. package/build/src/rules/eslint/index.js.map +1 -1
  165. package/build/src/rules/eslint/nova-rules.d.ts +4 -0
  166. package/build/src/rules/eslint/nova-rules.d.ts.map +1 -0
  167. package/build/src/rules/eslint/nova-rules.js +487 -0
  168. package/build/src/rules/eslint/nova-rules.js.map +1 -0
  169. package/build/src/types/cli/generate/docker-image/index.d.ts +102 -0
  170. package/build/src/types/cli/generate/github/issue-template.d.ts +2 -9
  171. package/build/src/types/cli/generate/must-haves/read-me.d.ts +10 -8
  172. package/build/src/types/cli/index.d.ts +2 -0
  173. package/build/src/types/cli/recipe/read-me/update-badges.d.ts +1 -1
  174. package/build/src/types/cli/scaffold/app/android.d.ts +40 -0
  175. package/build/src/types/cli/scaffold/app/apple.d.ts +19 -0
  176. package/build/src/types/cli/scaffold/app/astro.d.ts +46 -0
  177. package/build/src/types/cli/scaffold/app/cloudflare-workers.d.ts +24 -0
  178. package/build/src/types/cli/scaffold/app/discord-bot.d.ts +21 -0
  179. package/build/src/types/cli/scaffold/app/docker-image.d.ts +44 -0
  180. package/build/src/types/cli/scaffold/app/expressjs.d.ts +3 -0
  181. package/build/src/types/cli/scaffold/app/nextjs.d.ts +12 -0
  182. package/build/src/types/cli/scaffold/app/vite.d.ts +34 -0
  183. package/build/src/types/cli/scaffold/docs/docusaurus.d.ts +21 -1
  184. package/build/src/types/cli/scaffold/package/github-action.d.ts +19 -0
  185. package/build/src/types/cli/scaffold/package/homebridge.d.ts +41 -0
  186. package/build/src/types/cli/scaffold/package/node-cli.d.ts +19 -0
  187. package/build/src/types/cli/scaffold/package/pfsense.d.ts +19 -0
  188. package/build/src/types/cli/utility/changelog.d.ts +6 -0
  189. package/build/src/types/cli/utility/initialize.d.ts +70 -1
  190. package/build/src/types/lib/nova-config.d.ts +51 -2
  191. package/build/src/types/lib/regex.d.ts +57 -0
  192. package/build/src/types/lib/run-scripts.d.ts +21 -0
  193. package/build/src/types/lib/scaffold.d.ts +199 -13
  194. package/build/src/types/presets/eslint/fw-docusaurus.d.ts +23 -2
  195. package/build/src/types/presets/eslint/fw-nextjs.d.ts +37 -2
  196. package/build/src/types/presets/eslint/fw-react.d.ts +9 -0
  197. package/build/src/types/presets/eslint/fw-svelte.d.ts +5 -0
  198. package/build/src/types/presets/eslint/fw-vue.d.ts +5 -0
  199. package/build/src/types/rules/eslint/nova-rules.d.ts +10 -0
  200. package/build/src/types/shared.d.ts +93 -3
  201. package/build/src/types/tests/cli/generate/docker-image.test.d.ts +43 -0
  202. package/build/src/types/tests/cli/generate/github/issue-template.test.d.ts +6 -6
  203. package/build/src/types/tests/cli/generate/must-haves/read-me.test.d.ts +16 -0
  204. package/build/src/types/tests/cli/index.test.d.ts +72 -22
  205. package/build/src/types/tests/cli/recipe/package-json/normalize-modules.test.d.ts +19 -0
  206. package/build/src/types/tests/cli/scaffold/app/cloudflare-workers.test.d.ts +85 -0
  207. package/build/src/types/tests/cli/scaffold/app/expressjs.test.d.ts +21 -0
  208. package/build/src/types/tests/cli/utility/changelog.test.d.ts +8 -0
  209. package/build/src/types/tests/cli/utility/run-scripts.test.d.ts +70 -0
  210. package/build/src/types/tests/lib/nova-config.test.d.ts +54 -7
  211. package/build/src/types/tests/lib/scaffold.test.d.ts +28 -4
  212. package/build/src/types/tests/rules/eslint/nova-rules.test.d.ts +45 -0
  213. package/build/src/types/tests/scaffold-output-contract.test.d.ts +50 -0
  214. package/build/src/types/tests/scaffold-template-source.test.d.ts +25 -0
  215. package/build/src/types/tests/scaffold-version-drift.test.d.ts +18 -6
  216. package/build/templates/generators/docker-image/astro-node/Dockerfile +27 -0
  217. package/build/templates/generators/docker-image/astro-node/compose.yml +12 -0
  218. package/build/templates/generators/docker-image/background-service/compose.yml +10 -0
  219. package/build/templates/generators/docker-image/container-native/Dockerfile +10 -0
  220. package/build/templates/generators/docker-image/container-native/compose.yml +8 -0
  221. package/build/templates/generators/docker-image/http-service/compose.yml +11 -0
  222. package/build/templates/generators/docker-image/nextjs-standalone/Dockerfile +26 -0
  223. package/build/templates/generators/docker-image/nextjs-standalone/compose.yml +12 -0
  224. package/build/templates/generators/docker-image/node/Dockerfile +24 -0
  225. package/build/templates/generators/docker-image/static-site/Dockerfile +18 -0
  226. package/build/templates/generators/docker-image/static-site/compose.yml +8 -0
  227. package/build/templates/scaffold/app/android/eslint.config.mts +41 -0
  228. package/build/templates/scaffold/app/android/package.json +33 -0
  229. package/build/templates/scaffold/app/android/scripts/run-gradle.mjs +48 -0
  230. package/build/templates/scaffold/app/android/tests/project.test.ts +24 -0
  231. package/build/templates/scaffold/app/android/tsconfig.scripts.json +19 -0
  232. package/build/templates/scaffold/app/android/tsconfig.tests.json +18 -0
  233. package/build/templates/scaffold/app/android/vitest.config.mts +15 -0
  234. package/build/templates/scaffold/app/apple/Sources/App.swift +10 -0
  235. package/build/templates/scaffold/app/apple/Sources/ContentView.swift +20 -0
  236. package/build/templates/scaffold/app/apple/Tests/AppTests.swift +10 -0
  237. package/build/templates/scaffold/app/apple/package.json +26 -0
  238. package/build/templates/scaffold/app/apple/project.yml +47 -0
  239. package/build/templates/scaffold/app/astro/eslint.config.mts +69 -0
  240. package/build/templates/scaffold/app/astro/package.json +38 -0
  241. package/build/templates/scaffold/app/astro/src/pages/index.astro +18 -0
  242. package/build/templates/scaffold/app/astro/tests/project.test.ts +24 -0
  243. package/build/templates/scaffold/app/astro/tsconfig.astro.json +20 -0
  244. package/build/templates/scaffold/app/astro/tsconfig.config.json +22 -0
  245. package/build/templates/scaffold/app/astro/tsconfig.tests.json +19 -0
  246. package/build/templates/scaffold/app/astro/vitest.config.mts +18 -0
  247. package/build/templates/scaffold/app/cloudflare-workers/eslint.config.mts +42 -0
  248. package/build/templates/scaffold/app/cloudflare-workers/package.json +34 -0
  249. package/build/templates/scaffold/app/cloudflare-workers/src/index.ts +30 -0
  250. package/build/templates/scaffold/app/cloudflare-workers/src/types/index.d.ts +19 -0
  251. package/build/templates/scaffold/app/cloudflare-workers/tests/project.test.ts +24 -0
  252. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.config.json +19 -0
  253. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.tests.json +20 -0
  254. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.worker.json +16 -0
  255. package/build/templates/scaffold/app/cloudflare-workers/vitest.config.mts +18 -0
  256. package/build/templates/scaffold/app/discord-bot/eslint.config.mts +42 -0
  257. package/build/templates/scaffold/app/discord-bot/package.json +38 -0
  258. package/build/templates/scaffold/app/discord-bot/src/index.ts +39 -0
  259. package/build/templates/scaffold/app/discord-bot/tests/project.test.ts +24 -0
  260. package/build/templates/scaffold/app/discord-bot/tsconfig.config.json +19 -0
  261. package/build/templates/scaffold/app/discord-bot/tsconfig.source.json +22 -0
  262. package/build/templates/scaffold/app/discord-bot/tsconfig.tests.json +18 -0
  263. package/build/templates/scaffold/app/discord-bot/vitest.config.mts +18 -0
  264. package/build/templates/scaffold/app/docker-image/eslint.config.mts +41 -0
  265. package/build/templates/scaffold/app/docker-image/package.json +33 -0
  266. package/build/templates/scaffold/app/docker-image/tests/project.test.ts +24 -0
  267. package/build/templates/scaffold/app/docker-image/tsconfig.config.json +19 -0
  268. package/build/templates/scaffold/app/docker-image/tsconfig.tests.json +17 -0
  269. package/build/templates/scaffold/app/docker-image/vitest.config.mts +15 -0
  270. package/build/templates/scaffold/app/express/eslint.config.mts +44 -0
  271. package/build/templates/scaffold/app/express/package.json +14 -6
  272. package/build/templates/scaffold/app/express/src/index.ts +22 -1
  273. package/build/templates/scaffold/app/express/tests/project.test.ts +24 -0
  274. package/build/templates/scaffold/app/express/tsconfig.config.json +19 -0
  275. package/build/templates/scaffold/app/express/tsconfig.source.json +23 -0
  276. package/build/templates/scaffold/app/express/tsconfig.tests.json +18 -0
  277. package/build/templates/scaffold/app/express/vitest.config.mts +18 -0
  278. package/build/templates/scaffold/app/nextjs/eslint.config.mts +68 -0
  279. package/build/templates/scaffold/app/nextjs/next.config.mjs +11 -1
  280. package/build/templates/scaffold/app/nextjs/package.json +13 -5
  281. package/build/templates/scaffold/app/nextjs/src/app/layout.tsx +31 -7
  282. package/build/templates/scaffold/app/nextjs/src/app/page.tsx +15 -1
  283. package/build/templates/scaffold/app/nextjs/src/types/app/layout.d.ts +25 -0
  284. package/build/templates/scaffold/app/nextjs/src/types/app/page.d.ts +8 -0
  285. package/build/templates/scaffold/app/nextjs/tests/project.test.ts +24 -0
  286. package/build/templates/scaffold/app/nextjs/tsconfig.config.json +22 -0
  287. package/build/templates/scaffold/app/nextjs/tsconfig.json +25 -21
  288. package/build/templates/scaffold/app/nextjs/tsconfig.tests.json +19 -0
  289. package/build/templates/scaffold/app/nextjs/vitest.config.mts +18 -0
  290. package/build/templates/scaffold/app/vite/eslint.config.mts +70 -0
  291. package/build/templates/scaffold/app/vite/package.json +12 -6
  292. package/build/templates/scaffold/app/vite/tests/project.test.ts +24 -0
  293. package/build/templates/scaffold/app/vite/vite.config.mts +9 -1
  294. package/build/templates/scaffold/app/vite/vitest.config.mts +18 -0
  295. package/build/templates/scaffold/docs/docusaurus/docusaurus.config.ts +23 -5
  296. package/build/templates/scaffold/docs/docusaurus/eslint.config.mts +69 -0
  297. package/build/templates/scaffold/docs/docusaurus/package.json +7 -5
  298. package/build/templates/scaffold/docs/docusaurus/sidebars.ts +9 -3
  299. package/build/templates/scaffold/docs/docusaurus/src/tests/frontmatter.test.ts +1 -1
  300. package/build/templates/scaffold/docs/docusaurus/src/tests/link.test.ts +1 -1
  301. package/build/templates/scaffold/docs/docusaurus/src/tests/markdown-table.test.ts +1 -1
  302. package/build/templates/scaffold/docs/docusaurus/src/tests/terminology.test.ts +1 -1
  303. package/build/templates/scaffold/docs/docusaurus/src/tests/type-declarations.test.ts +1 -1
  304. package/build/templates/scaffold/docs/docusaurus/tsconfig.json +9 -1
  305. package/build/templates/scaffold/docs/docusaurus/vitest.config.mts +10 -1
  306. package/build/templates/scaffold/docs/docusaurus/vitest.setup.ts +1 -1
  307. package/build/templates/scaffold/package/github-action/eslint.config.mts +42 -0
  308. package/build/templates/scaffold/package/github-action/package.json +41 -0
  309. package/build/templates/scaffold/package/github-action/src/index.ts +9 -0
  310. package/build/templates/scaffold/package/github-action/src/run.test.ts +15 -0
  311. package/build/templates/scaffold/package/github-action/src/run.ts +45 -0
  312. package/build/templates/scaffold/package/github-action/src/types/run.d.ts +17 -0
  313. package/build/templates/scaffold/package/github-action/tsconfig.config.json +19 -0
  314. package/build/templates/scaffold/package/github-action/tsconfig.json +22 -0
  315. package/build/templates/scaffold/package/github-action/tsconfig.tests.json +18 -0
  316. package/build/templates/scaffold/package/github-action/vitest.config.mts +18 -0
  317. package/build/templates/scaffold/package/github-action-root/action.yml +15 -0
  318. package/build/templates/scaffold/package/homebridge/config.schema.json +18 -0
  319. package/build/templates/scaffold/package/homebridge/eslint.config.mts +48 -0
  320. package/build/templates/scaffold/package/homebridge/package.json +47 -0
  321. package/build/templates/scaffold/package/homebridge/src/index.ts +26 -0
  322. package/build/templates/scaffold/package/homebridge/src/platform.ts +88 -0
  323. package/build/templates/scaffold/package/homebridge/src/types/index.d.ts +10 -0
  324. package/build/templates/scaffold/package/homebridge/src/types/platform.d.ts +38 -0
  325. package/build/templates/scaffold/package/homebridge/tests/project.test.ts +24 -0
  326. package/build/templates/scaffold/package/homebridge/tsconfig.config.json +19 -0
  327. package/build/templates/scaffold/package/homebridge/tsconfig.source.json +25 -0
  328. package/build/templates/scaffold/package/homebridge/tsconfig.tests.json +18 -0
  329. package/build/templates/scaffold/package/homebridge/vitest.config.mts +18 -0
  330. package/build/templates/scaffold/package/node-cli/eslint.config.mts +49 -0
  331. package/build/templates/scaffold/package/node-cli/package.json +44 -0
  332. package/build/templates/scaffold/package/node-cli/src/index.test.ts +15 -0
  333. package/build/templates/scaffold/package/node-cli/src/index.ts +5 -0
  334. package/build/templates/scaffold/package/node-cli/src/program.ts +30 -0
  335. package/build/templates/scaffold/package/node-cli/tsconfig.config.json +19 -0
  336. package/build/templates/scaffold/package/node-cli/tsconfig.source.json +22 -0
  337. package/build/templates/scaffold/package/node-cli/tsconfig.tests.json +18 -0
  338. package/build/templates/scaffold/package/node-cli/vitest.config.mts +18 -0
  339. package/build/templates/scaffold/package/pfsense/eslint.config.mts +53 -0
  340. package/build/templates/scaffold/package/pfsense/package.json +41 -0
  341. package/build/templates/scaffold/package/pfsense/port/Makefile.template +39 -0
  342. package/build/templates/scaffold/package/pfsense/port/files/pkg-deinstall.in +3 -0
  343. package/build/templates/scaffold/package/pfsense/port/files/pkg-install.in +7 -0
  344. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +78 -0
  345. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml +68 -0
  346. package/build/templates/scaffold/package/pfsense/port/files/usr/local/sbin/[__WORKSPACE_NAME__] +21 -0
  347. package/build/templates/scaffold/package/pfsense/port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/info.xml +9 -0
  348. package/build/templates/scaffold/package/pfsense/port/pkg-descr +3 -0
  349. package/build/templates/scaffold/package/pfsense/port/pkg-plist +4 -0
  350. package/build/templates/scaffold/package/pfsense/scripts/build-package.sh +72 -0
  351. package/build/templates/scaffold/package/pfsense/scripts/check-package.mjs +92 -0
  352. package/build/templates/scaffold/package/pfsense/scripts/regex.mjs +9 -0
  353. package/build/templates/scaffold/package/pfsense/scripts/stage-package.mjs +135 -0
  354. package/build/templates/scaffold/package/pfsense/tests/project.test.ts +24 -0
  355. package/build/templates/scaffold/package/pfsense/tsconfig.scripts.json +19 -0
  356. package/build/templates/scaffold/package/pfsense/tsconfig.tests.json +18 -0
  357. package/build/templates/scaffold/package/pfsense/vitest.config.mts +15 -0
  358. package/build/templates/scaffold/starter/base/eslint.config.mts +68 -0
  359. package/build/templates/scaffold/starter/base/tests/project.test.ts +24 -0
  360. package/build/templates/scaffold/starter/base/tsconfig.config.json +19 -0
  361. package/build/templates/scaffold/starter/base/tsconfig.tests.json +17 -0
  362. package/build/templates/scaffold/starter/base/vitest.config.mts +19 -0
  363. package/build/templates/scaffold-options/app/astro/cloudflare/astro.config.mjs +18 -0
  364. package/build/templates/scaffold-options/app/astro/node/astro.config.mjs +20 -0
  365. package/build/templates/scaffold-options/app/astro/static/astro.config.mjs +16 -0
  366. package/build/templates/scaffold-options/app/vite/framework/react/config/eslint-framework.mts +3 -0
  367. package/build/templates/scaffold-options/app/vite/framework/react/config/framework-plugins.ts +3 -0
  368. package/build/templates/scaffold-options/app/vite/framework/react/src/app.tsx +13 -0
  369. package/build/templates/scaffold-options/app/vite/framework/react/src/main.ts +18 -0
  370. package/build/templates/scaffold-options/app/vite/framework/react/tsconfig.json +28 -0
  371. package/build/templates/scaffold-options/app/vite/framework/svelte/config/eslint-framework.mts +3 -0
  372. package/build/templates/scaffold-options/app/vite/framework/svelte/config/framework-plugins.ts +3 -0
  373. package/build/templates/scaffold-options/app/vite/framework/svelte/src/app.svelte +5 -0
  374. package/build/templates/scaffold-options/app/vite/framework/svelte/src/main.ts +19 -0
  375. package/build/templates/scaffold-options/app/vite/framework/svelte/src/vite-env.d.ts +3 -0
  376. package/build/templates/scaffold-options/app/vite/framework/svelte/svelte.config.js +1 -0
  377. package/build/templates/scaffold-options/app/vite/framework/svelte/tsconfig.json +27 -0
  378. package/build/templates/scaffold-options/app/vite/framework/vanilla/config/eslint-framework.mts +1 -0
  379. package/build/templates/scaffold-options/app/vite/framework/vanilla/config/framework-plugins.ts +1 -0
  380. package/build/templates/scaffold-options/app/vite/framework/vanilla/src/main.ts +13 -0
  381. package/build/templates/scaffold-options/app/vite/framework/vanilla/tsconfig.json +25 -0
  382. package/build/templates/scaffold-options/app/vite/framework/vue/config/eslint-framework.mts +3 -0
  383. package/build/templates/scaffold-options/app/vite/framework/vue/config/framework-plugins.ts +3 -0
  384. package/build/templates/scaffold-options/app/vite/framework/vue/src/app.vue +7 -0
  385. package/build/templates/scaffold-options/app/vite/framework/vue/src/main.ts +5 -0
  386. package/build/templates/scaffold-options/app/vite/framework/vue/src/vite-env.d.ts +9 -0
  387. package/build/templates/scaffold-options/app/vite/framework/vue/tsconfig.json +27 -0
  388. package/build/templates/scaffold-options/app/vite/pwa/disabled/config/pwa-plugins.ts +1 -0
  389. package/build/templates/scaffold-options/app/vite/pwa/enabled/config/pwa-plugins.ts +5 -0
  390. package/build/templates/scaffold-options/docs/docusaurus/blog/blog/2026-01-01-welcome.mdx +14 -0
  391. package/build/templates/scaffold-options/docs/docusaurus/blog/blog/authors.yml +2 -0
  392. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/index.html +16 -0
  393. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/index.js +5 -0
  394. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/styles.css +12 -0
  395. package/build/templates/scaffold-options/package/homebridge/custom-ui/src/config-ui/server.ts +29 -0
  396. package/package.json +18 -9
  397. package/build/src/cli/scaffold/app/workers.d.ts +0 -5
  398. package/build/src/cli/scaffold/app/workers.d.ts.map +0 -1
  399. package/build/src/cli/scaffold/app/workers.js +0 -8
  400. package/build/src/cli/scaffold/app/workers.js.map +0 -1
  401. package/build/src/types/cli/scaffold/app/workers.d.ts +0 -24
  402. package/build/src/types/tests/cli/scaffold/app/workers.test.d.ts +0 -85
  403. package/build/templates/scaffold/app/express/tsconfig.json +0 -16
  404. package/build/templates/scaffold/app/vite/src/main.ts +0 -5
  405. package/build/templates/scaffold/app/vite/tsconfig.json +0 -16
  406. package/build/templates/scaffold/app/workers/package.json +0 -24
  407. package/build/templates/scaffold/app/workers/src/index.ts +0 -13
  408. package/build/templates/scaffold/app/workers/tsconfig.json +0 -17
  409. /package/build/templates/scaffold/app/{workers → cloudflare-workers}/wrangler.toml +0 -0
@@ -1,11 +1,21 @@
1
1
  import { promises as fs } from 'node:fs';
2
- import { isAbsolute, join, relative, resolve, sep, } from 'node:path';
2
+ import { dirname, isAbsolute, join, relative, resolve, sep, } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
3
4
  import { minimatch } from 'minimatch';
4
5
  import prompts from 'prompts';
5
6
  import novaPackageJson from '../../package.json' with { type: 'json' };
6
7
  import { Logger } from '../toolkit/index.js';
7
- import { LIB_REGEX_PATTERN_SLUG_SIMPLE, LIB_REGEX_PLACEHOLDER_PROJECT_SLUG, LIB_REGEX_PLACEHOLDER_WORKSPACE_PACKAGE_NAME, } from './regex.js';
8
+ import { LIB_REGEX_PATTERN_NON_ALPHANUMERIC_RUN, LIB_REGEX_PATTERN_SLUG_SIMPLE, LIB_REGEX_PLACEHOLDER_PROJECT_SLUG, LIB_REGEX_PLACEHOLDER_WORKSPACE_IDENTIFIER, LIB_REGEX_PLACEHOLDER_WORKSPACE_NAME, LIB_REGEX_PLACEHOLDER_WORKSPACE_PACKAGE_NAME, LIB_REGEX_PLACEHOLDER_WORKSPACE_RELATIVE_PATH, LIB_REGEX_PLACEHOLDER_WORKSPACE_TITLE, } from './regex.js';
8
9
  import { discoverPathsWithFile, isPlainObject, pathExists, resolveTemplatePath, saveGeneratedFile, } from './utility.js';
10
+ function applyTemplateReplacements(input, replacements) {
11
+ let output = input;
12
+ for (const replacement of replacements) {
13
+ const pattern = replacement[0];
14
+ const value = replacement[1];
15
+ output = output.replace(new RegExp(pattern.source, 'g'), value);
16
+ }
17
+ return output;
18
+ }
9
19
  function reportError(message) {
10
20
  Logger.customize({
11
21
  name: 'CliScaffold.run',
@@ -15,6 +25,9 @@ function reportError(message) {
15
25
  return;
16
26
  }
17
27
  export function resolveWorkspacePackageName(projectSlug, workspaceName, category) {
28
+ if (category === 'package') {
29
+ return workspaceName;
30
+ }
18
31
  return (category === 'docs') ? `${projectSlug}-docs` : `${projectSlug}-app-${workspaceName}`;
19
32
  }
20
33
  export function normalizeWorkspaceRelativePath(rootDirectory, workspaceDirectory) {
@@ -285,7 +298,7 @@ export async function promptScaffoldOptions(context, defaults) {
285
298
  }
286
299
  const resolveInitialOutput = (_initialPrev, initialAnswers) => {
287
300
  const resolvedInitialWorkspaceName = (workspaceNameValue ?? initialAnswers['workspaceName']);
288
- return `./apps/${resolvedInitialWorkspaceName}`;
301
+ return `./${defaults['workspaceBaseDirectory']}/${resolvedInitialWorkspaceName}`;
289
302
  };
290
303
  if (outputValue === undefined) {
291
304
  questions.push({
@@ -324,30 +337,72 @@ export async function promptScaffoldOptions(context, defaults) {
324
337
  };
325
338
  }
326
339
  export async function resolveTemplateAnswers(options, questions, isNonInteractive) {
340
+ const resolvedAnswers = new Map();
327
341
  const replacements = new Map();
328
342
  for (const question of questions) {
343
+ let isActive = true;
344
+ if (question['dependsOn'] !== undefined) {
345
+ const dependencyValue = resolvedAnswers.get(question['dependsOn']['name']);
346
+ isActive = dependencyValue !== undefined && question['dependsOn']['values'].some((value) => value === dependencyValue);
347
+ }
348
+ if (isActive === false) {
349
+ const inactiveDefaultChoice = question['defaultValue'];
350
+ if (inactiveDefaultChoice !== undefined) {
351
+ const inactiveDefaultChoiceDefinition = question['choices'].find((choice) => choice['value'] === inactiveDefaultChoice);
352
+ if (inactiveDefaultChoiceDefinition === undefined) {
353
+ const inactiveAllowedValues = question['choices'].map((choice) => choice['value']).join(', ');
354
+ Logger.customize({
355
+ name: 'resolveTemplateAnswers',
356
+ purpose: 'validate',
357
+ }).error(`Invalid default for ${question['flag']}: "${inactiveDefaultChoice}". Expected one of: ${inactiveAllowedValues}.`);
358
+ process.exitCode = 1;
359
+ return undefined;
360
+ }
361
+ resolvedAnswers.set(question['name'], inactiveDefaultChoice);
362
+ replacements.set(question['placeholder'], inactiveDefaultChoiceDefinition['replacement'] ?? inactiveDefaultChoice);
363
+ }
364
+ continue;
365
+ }
329
366
  const providedValue = Reflect.get(options, question['name']);
367
+ const flagValue = question['flagValue'];
330
368
  let resolvedValue = undefined;
331
- if (providedValue !== undefined) {
369
+ if (flagValue !== undefined && providedValue === true) {
370
+ resolvedValue = flagValue;
371
+ }
372
+ else if (flagValue !== undefined
373
+ && providedValue !== undefined
374
+ && providedValue !== false) {
375
+ Logger.customize({
376
+ name: 'resolveTemplateAnswers',
377
+ purpose: 'validate',
378
+ }).error(`Invalid ${question['flag']} value "${String(providedValue)}". This option is a boolean flag.`);
379
+ process.exitCode = 1;
380
+ return undefined;
381
+ }
382
+ else if (flagValue === undefined && providedValue !== undefined) {
332
383
  if (typeof providedValue !== 'string'
333
384
  || question['choices'].some((choice) => choice['value'] === providedValue) !== true) {
334
- const allowedValues = question['choices'].map((choice) => choice['value']).join(', ');
385
+ const providedAllowedValues = question['choices'].map((choice) => choice['value']).join(', ');
335
386
  Logger.customize({
336
387
  name: 'resolveTemplateAnswers',
337
388
  purpose: 'validate',
338
- }).error(`Invalid ${question['flag']} value "${String(providedValue)}". Expected one of: ${allowedValues}.`);
389
+ }).error(`Invalid ${question['flag']} value "${String(providedValue)}". Expected one of: ${providedAllowedValues}.`);
339
390
  process.exitCode = 1;
340
391
  return undefined;
341
392
  }
342
393
  resolvedValue = providedValue;
343
394
  }
344
395
  else if (isNonInteractive === true) {
345
- Logger.customize({
346
- name: 'resolveTemplateAnswers',
347
- purpose: 'validate',
348
- }).error(`Non-interactive scaffolding requires ${question['flag']}.`);
349
- process.exitCode = 1;
350
- return undefined;
396
+ const nonInteractiveDefaultChoice = question['defaultValue'];
397
+ if (nonInteractiveDefaultChoice === undefined) {
398
+ Logger.customize({
399
+ name: 'resolveTemplateAnswers',
400
+ purpose: 'validate',
401
+ }).error(`Non-interactive scaffolding requires ${question['flag']}.`);
402
+ process.exitCode = 1;
403
+ return undefined;
404
+ }
405
+ resolvedValue = nonInteractiveDefaultChoice;
351
406
  }
352
407
  else {
353
408
  const answers = await prompts({
@@ -365,9 +420,24 @@ export async function resolveTemplateAnswers(options, questions, isNonInteractiv
365
420
  }
366
421
  resolvedValue = answer;
367
422
  }
368
- replacements.set(question['placeholder'], resolvedValue);
423
+ if (question['choices'].some((choice) => choice['value'] === resolvedValue) !== true) {
424
+ const resolvedAllowedValues = question['choices'].map((choice) => choice['value']).join(', ');
425
+ Logger.customize({
426
+ name: 'resolveTemplateAnswers',
427
+ purpose: 'validate',
428
+ }).error(`Invalid default for ${question['flag']}: "${String(resolvedValue)}". Expected one of: ${resolvedAllowedValues}.`);
429
+ process.exitCode = 1;
430
+ return undefined;
431
+ }
432
+ const resolvedChoiceDefinition = question['choices'].find((choice) => choice['value'] === resolvedValue);
433
+ const replacementValue = (resolvedChoiceDefinition === undefined) ? resolvedValue : (resolvedChoiceDefinition['replacement'] ?? resolvedValue);
434
+ resolvedAnswers.set(question['name'], resolvedValue);
435
+ replacements.set(question['placeholder'], replacementValue);
369
436
  }
370
- return replacements;
437
+ return {
438
+ answers: resolvedAnswers,
439
+ replacements,
440
+ };
371
441
  }
372
442
  export async function createWorkspaceDirectory(basePath, workspaceName) {
373
443
  const workspaceDirectory = join(basePath, workspaceName);
@@ -383,13 +453,10 @@ export async function writeTemplateFiles(templateDirectory, targetDirectory, rep
383
453
  const entries = await collectFiles(templateDirectory, '');
384
454
  for (const entry of entries) {
385
455
  const sourcePath = join(templateDirectory, entry);
386
- const targetPath = join(targetDirectory, entry);
387
- let content = await fs.readFile(sourcePath, 'utf-8');
388
- for (const replacement of replacements) {
389
- const pattern = replacement[0];
390
- const value = replacement[1];
391
- content = content.replace(new RegExp(pattern.source, 'g'), value);
392
- }
456
+ const targetEntry = applyTemplateReplacements(entry, replacements);
457
+ const targetPath = join(targetDirectory, targetEntry);
458
+ const sourceContent = await fs.readFile(sourcePath, 'utf-8');
459
+ const content = applyTemplateReplacements(sourceContent, replacements);
393
460
  await saveGeneratedFile(targetPath, content, true);
394
461
  const relativePath = relative(currentDirectory, targetPath);
395
462
  Logger.customize({
@@ -399,6 +466,35 @@ export async function writeTemplateFiles(templateDirectory, targetDirectory, rep
399
466
  }
400
467
  return;
401
468
  }
469
+ export async function updateScaffoldPackageJson(workspaceDirectory, updates) {
470
+ const packageJsonPath = join(workspaceDirectory, 'package.json');
471
+ const raw = await fs.readFile(packageJsonPath, 'utf-8');
472
+ const parsed = JSON.parse(raw);
473
+ if (isPlainObject(parsed) === false) {
474
+ throw new Error(`The scaffold package manifest at "${packageJsonPath}" must contain a JSON object.`);
475
+ }
476
+ const packageJson = parsed;
477
+ for (const updateEntry of Object.entries(updates)) {
478
+ const sectionValue = packageJson[updateEntry[0]];
479
+ if (sectionValue !== undefined && isPlainObject(sectionValue) === false) {
480
+ throw new Error(`The "${updateEntry[0]}" field in "${packageJsonPath}" must contain a JSON object.`);
481
+ }
482
+ const section = (isPlainObject(sectionValue) === true) ? sectionValue : {};
483
+ for (const valueEntry of Object.entries(updateEntry[1])) {
484
+ Reflect.set(section, valueEntry[0], valueEntry[1]);
485
+ }
486
+ const isSortedSection = [
487
+ 'dependencies',
488
+ 'devDependencies',
489
+ 'optionalDependencies',
490
+ 'peerDependencies',
491
+ ].includes(updateEntry[0]);
492
+ Reflect.set(packageJson, updateEntry[0], (isSortedSection === true) ? Object.fromEntries(Object.entries(section).sort((firstEntry, secondEntry) => firstEntry[0].localeCompare(secondEntry[0]))) : section);
493
+ }
494
+ const content = `${JSON.stringify(packageJson, null, 2)}\n`;
495
+ await fs.writeFile(packageJsonPath, content, 'utf-8');
496
+ return;
497
+ }
402
498
  async function collectFiles(directory, prefix) {
403
499
  const entries = await fs.readdir(directory, { withFileTypes: true });
404
500
  const files = [];
@@ -416,6 +512,20 @@ async function collectFiles(directory, prefix) {
416
512
  }
417
513
  return files;
418
514
  }
515
+ function resolveMonorepoRootTemplateDirectory() {
516
+ const currentDirectory = dirname(fileURLToPath(import.meta.url));
517
+ return join(currentDirectory, '..', '..', 'templates', 'scaffold', 'starter', 'base');
518
+ }
519
+ export async function getMonorepoRootPlannedPaths(outputDirectory) {
520
+ const templateDirectory = resolveMonorepoRootTemplateDirectory();
521
+ const templateEntries = await collectFiles(templateDirectory, '');
522
+ return [
523
+ join(outputDirectory, 'package.json'),
524
+ join(outputDirectory, 'nova.config.json'),
525
+ join(outputDirectory, 'turbo.json'),
526
+ ...templateEntries.map((templateEntry) => join(outputDirectory, templateEntry)),
527
+ ];
528
+ }
419
529
  export async function createMonorepoRoot(outputDirectory, projectSlug) {
420
530
  const currentDirectory = process.cwd();
421
531
  await fs.mkdir(outputDirectory, { recursive: true });
@@ -427,16 +537,21 @@ export async function createMonorepoRoot(outputDirectory, projectSlug) {
427
537
  name: `${projectSlug}-project`,
428
538
  version: '0.0.0',
429
539
  private: true,
540
+ type: 'module',
430
541
  scripts: {
431
- 'dev': 'nova utility run-scripts --parallel \'dev:*\'',
542
+ 'dev': 'nova utility run-scripts --parallel --node-env development \'dev:*\'',
432
543
  'dev:workspaces': 'turbo run dev',
433
- 'prod': 'nova utility run-scripts --sequential \'prod:*\'',
544
+ 'prod': 'nova utility run-scripts --sequential --node-env production \'prod:*\'',
434
545
  'prod:workspaces': 'turbo run prod',
435
546
  'check': 'nova utility run-scripts --sequential \'check:*\'',
547
+ 'check:lint': 'eslint ./ --max-warnings=0',
548
+ 'check:types-config': 'nova utility type-check --project tsconfig.config.json',
549
+ 'check:types-tests': 'nova utility type-check --project tsconfig.tests.json',
550
+ 'check:test': 'vitest run',
436
551
  'check:workspaces': 'turbo run check --concurrency=2',
437
- 'build': 'nova utility run-scripts --sequential \'build:*\'',
552
+ 'build': 'nova utility run-scripts --sequential --node-env production \'build:*\'',
438
553
  'build:workspaces': 'turbo run build --concurrency=2',
439
- 'deploy': 'nova utility run-scripts --sequential \'deploy:*\'',
554
+ 'deploy': 'nova utility run-scripts --sequential --node-env production \'deploy:*\'',
440
555
  'deploy:workspaces': 'turbo run deploy --concurrency=2',
441
556
  'clean': 'nova utility run-scripts --parallel \'clean:*\'',
442
557
  'clean:workspaces': 'turbo run clean',
@@ -448,6 +563,7 @@ export async function createMonorepoRoot(outputDirectory, projectSlug) {
448
563
  'core-js-pure': false,
449
564
  'es5-ext': false,
450
565
  'esbuild': false,
566
+ 'fsevents': true,
451
567
  'sharp': false,
452
568
  'unrs-resolver': false,
453
569
  'workerd': false,
@@ -460,9 +576,16 @@ export async function createMonorepoRoot(outputDirectory, projectSlug) {
460
576
  engines: {
461
577
  node: '^22 || ^24',
462
578
  },
463
- devDependencies: {
579
+ dependencies: {
464
580
  '@cbnventures/nova': novaPackageJson['version'],
581
+ },
582
+ devDependencies: {
583
+ '@types/node': novaPackageJson['devDependencies']['@types/node'],
584
+ 'eslint': novaPackageJson['devDependencies']['eslint'],
585
+ 'jiti': '2.7.0',
465
586
  'turbo': novaPackageJson['devDependencies']['turbo'],
587
+ 'typescript': novaPackageJson['devDependencies']['typescript'],
588
+ 'vitest': novaPackageJson['devDependencies']['vitest'],
466
589
  },
467
590
  };
468
591
  const packageJsonPath = join(outputDirectory, 'package.json');
@@ -572,6 +695,12 @@ export async function createMonorepoRoot(outputDirectory, projectSlug) {
572
695
  name: 'createMonorepoRoot',
573
696
  purpose: 'written',
574
697
  }).info(`Created "${novaConfigRelativePath}".`);
698
+ const rootTemplateDirectory = resolveMonorepoRootTemplateDirectory();
699
+ const replacements = new Map([[
700
+ LIB_REGEX_PLACEHOLDER_PROJECT_SLUG,
701
+ projectSlug,
702
+ ]]);
703
+ await writeTemplateFiles(rootTemplateDirectory, outputDirectory, replacements);
575
704
  return;
576
705
  }
577
706
  export async function promptPostScaffoldGenerators(outputDirectory) {
@@ -727,7 +856,7 @@ async function loadGenerator(name) {
727
856
  }
728
857
  }
729
858
  }
730
- export async function registerWorkspaceInConfig(configFilePath, workspaceRelPath, workspaceName, category) {
859
+ export async function registerWorkspaceInConfig(configFilePath, workspaceRelPath, workspacePackageName, category) {
731
860
  let parsedConfig = undefined;
732
861
  try {
733
862
  const raw = await fs.readFile(configFilePath, 'utf-8');
@@ -752,8 +881,15 @@ export async function registerWorkspaceInConfig(configFilePath, workspaceRelPath
752
881
  reportError('The root nova.config.json must define a valid project.name.slug before registering a workspace.');
753
882
  return;
754
883
  }
755
- const role = (category === 'docs') ? 'docs' : 'app';
756
- const configName = resolveWorkspacePackageName(projectSlug, workspaceName, category);
884
+ const role = (category === 'package') ? 'package' : category;
885
+ let policy = 'trackable';
886
+ if (category === 'package') {
887
+ policy = 'distributable';
888
+ }
889
+ else if (category === 'docs') {
890
+ policy = 'freezable';
891
+ }
892
+ const configName = workspacePackageName;
757
893
  const parsedWorkspaces = parsedConfig['workspaces'];
758
894
  if (parsedWorkspaces !== undefined && isPlainObject(parsedWorkspaces) === false) {
759
895
  reportError('The root nova.config.json "workspaces" field must be an object.');
@@ -763,7 +899,7 @@ export async function registerWorkspaceInConfig(configFilePath, workspaceRelPath
763
899
  Reflect.set(workspaces, workspaceRelPath, {
764
900
  name: configName,
765
901
  role,
766
- policy: 'freezable',
902
+ policy,
767
903
  });
768
904
  Reflect.set(parsedConfig, 'workspaces', workspaces);
769
905
  await fs.writeFile(configFilePath, `${JSON.stringify(parsedConfig, null, 2)}\n`, 'utf-8');
@@ -773,7 +909,7 @@ export async function registerWorkspaceInConfig(configFilePath, workspaceRelPath
773
909
  }).info(`Registered workspace "${configName}" in nova.config.json.`);
774
910
  return;
775
911
  }
776
- export async function runScaffold(options, category, typeName, templateSubpath, importMetaUrl, templateQuestions = []) {
912
+ export async function runScaffold(options, definition) {
777
913
  const currentDirectory = process.cwd();
778
914
  const isDryRun = options['dryRun'] === true;
779
915
  const isNonInteractive = options['nonInteractive'] === true;
@@ -830,7 +966,8 @@ export async function runScaffold(options, category, typeName, templateSubpath,
830
966
  const config = await promptScaffoldOptions(context, {
831
967
  name: configNameDefault,
832
968
  output: options['output'],
833
- typeName,
969
+ typeName: definition['typeName'],
970
+ workspaceBaseDirectory: (definition['category'] === 'package') ? 'packages' : 'apps',
834
971
  workspaceName: options['workspaceName'],
835
972
  });
836
973
  if (config === undefined) {
@@ -849,16 +986,48 @@ export async function runScaffold(options, category, typeName, templateSubpath,
849
986
  return;
850
987
  }
851
988
  const projectSlug = config['name'];
852
- const workspacePackageName = resolveWorkspacePackageName(projectSlug, config['workspaceName'], category);
989
+ const workspacePackageNameBase = resolveWorkspacePackageName(projectSlug, config['workspaceName'], definition['category']);
990
+ const workspacePackageNamePrefix = definition['workspacePackageNamePrefix'] ?? '';
991
+ const workspacePackageName = (workspacePackageNamePrefix !== '' && workspacePackageNameBase.startsWith(workspacePackageNamePrefix) === false) ? `${workspacePackageNamePrefix}${workspacePackageNameBase}` : workspacePackageNameBase;
853
992
  const configRoot = (config['mode'] === 'monorepo') ? config['outputDirectory'] : currentDirectory;
854
993
  const configFilePath = join(configRoot, 'nova.config.json');
855
- const workspaceDirectory = (config['mode'] === 'monorepo') ? join(configRoot, 'apps', config['workspaceName']) : config['outputDirectory'];
994
+ const workspaceBaseDirectory = (definition['category'] === 'package') ? 'packages' : 'apps';
995
+ const workspaceDirectory = (config['mode'] === 'monorepo') ? join(configRoot, workspaceBaseDirectory, config['workspaceName']) : config['outputDirectory'];
856
996
  const workspaceRelPath = normalizeWorkspaceRelativePath(configRoot, workspaceDirectory);
857
997
  if (workspaceRelPath === undefined) {
858
998
  reportError('The workspace output must be a child directory of the monorepo root. No scaffold files were written.');
859
999
  return;
860
1000
  }
861
1001
  const normalizedWorkspaceRelPath = workspaceRelPath.slice(2);
1002
+ const workspaceNameSegments = config['workspaceName'].split(LIB_REGEX_PATTERN_NON_ALPHANUMERIC_RUN);
1003
+ const workspaceTitle = workspaceNameSegments.map((workspaceNameSegment) => `${workspaceNameSegment.charAt(0).toUpperCase()}${workspaceNameSegment.slice(1)}`).join(' ');
1004
+ const workspaceIdentifier = workspaceNameSegments.map((workspaceNameSegment) => `${workspaceNameSegment.charAt(0).toUpperCase()}${workspaceNameSegment.slice(1)}`).join('');
1005
+ const coreReplacements = new Map([
1006
+ [
1007
+ LIB_REGEX_PLACEHOLDER_PROJECT_SLUG,
1008
+ projectSlug,
1009
+ ],
1010
+ [
1011
+ LIB_REGEX_PLACEHOLDER_WORKSPACE_PACKAGE_NAME,
1012
+ workspacePackageName,
1013
+ ],
1014
+ [
1015
+ LIB_REGEX_PLACEHOLDER_WORKSPACE_IDENTIFIER,
1016
+ workspaceIdentifier,
1017
+ ],
1018
+ [
1019
+ LIB_REGEX_PLACEHOLDER_WORKSPACE_NAME,
1020
+ config['workspaceName'],
1021
+ ],
1022
+ [
1023
+ LIB_REGEX_PLACEHOLDER_WORKSPACE_RELATIVE_PATH,
1024
+ normalizedWorkspaceRelPath,
1025
+ ],
1026
+ [
1027
+ LIB_REGEX_PLACEHOLDER_WORKSPACE_TITLE,
1028
+ workspaceTitle,
1029
+ ],
1030
+ ]);
862
1031
  if (existingRoot !== undefined) {
863
1032
  const existingWorkspaceEntries = Object.entries(existingRoot['workspaces']);
864
1033
  for (const existingWorkspaceEntry of existingWorkspaceEntries) {
@@ -886,7 +1055,7 @@ export async function runScaffold(options, category, typeName, templateSubpath,
886
1055
  reportError(`The nova.config.json workspace "${existingWorkspacePath}" must define string name and role fields. No scaffold files were written.`);
887
1056
  return;
888
1057
  }
889
- if (category === 'docs' && existingWorkspaceRole === 'docs') {
1058
+ if (definition['category'] === 'docs' && existingWorkspaceRole === 'docs') {
890
1059
  reportError(`A documentation workspace is already registered at "${existingWorkspacePath}". Nova projects support one canonical docs workspace. No scaffold files were written.`);
891
1060
  return;
892
1061
  }
@@ -896,11 +1065,54 @@ export async function runScaffold(options, category, typeName, templateSubpath,
896
1065
  }
897
1066
  }
898
1067
  }
899
- const templateDirectory = resolveTemplatePath(importMetaUrl, templateSubpath);
900
- const templateEntries = await collectFiles(templateDirectory, '');
901
- const plannedPaths = templateEntries.map((templateEntry) => join(workspaceDirectory, templateEntry));
1068
+ const templateResolution = await resolveTemplateAnswers(options, definition['templateQuestions'] ?? [], isNonInteractive);
1069
+ if (templateResolution === undefined) {
1070
+ if (process.exitCode !== 1) {
1071
+ Logger.customize({
1072
+ name: 'CliScaffold.run',
1073
+ purpose: 'cancelled',
1074
+ }).warn('Scaffold cancelled.');
1075
+ }
1076
+ return;
1077
+ }
1078
+ const templateAnswers = templateResolution['answers'];
1079
+ const templateReplacements = templateResolution['replacements'];
1080
+ const templateValidationError = (definition['validateTemplateAnswers'] === undefined) ? undefined : definition.validateTemplateAnswers(templateAnswers);
1081
+ if (templateValidationError !== undefined) {
1082
+ reportError(`${templateValidationError} No scaffold files were written.`);
1083
+ return;
1084
+ }
1085
+ const replacements = new Map([
1086
+ ...coreReplacements,
1087
+ ...templateReplacements,
1088
+ ]);
1089
+ const workspaceTemplateSubpaths = [definition['templateSubpath']];
1090
+ if (definition['resolveWorkspaceTemplateSubpaths'] !== undefined) {
1091
+ workspaceTemplateSubpaths.push(...definition.resolveWorkspaceTemplateSubpaths(templateAnswers));
1092
+ }
1093
+ const workspaceTemplateDirectories = workspaceTemplateSubpaths.map((workspaceTemplateSubpath) => resolveTemplatePath(definition['importMetaUrl'], workspaceTemplateSubpath));
1094
+ const workspacePlannedPathGroups = await Promise.all(workspaceTemplateDirectories.map(async (workspaceTemplateDirectory) => {
1095
+ const templateEntries = await collectFiles(workspaceTemplateDirectory, '');
1096
+ return templateEntries.map((templateEntry) => join(workspaceDirectory, applyTemplateReplacements(templateEntry, replacements)));
1097
+ }));
1098
+ const rootTemplateSubpaths = [];
1099
+ if (definition['rootTemplateSubpath'] !== undefined) {
1100
+ rootTemplateSubpaths.push(definition['rootTemplateSubpath']);
1101
+ }
1102
+ if (definition['resolveRootTemplateSubpaths'] !== undefined) {
1103
+ rootTemplateSubpaths.push(...definition.resolveRootTemplateSubpaths(templateAnswers));
1104
+ }
1105
+ const rootTemplateDirectories = rootTemplateSubpaths.map((rootTemplateSubpath) => resolveTemplatePath(definition['importMetaUrl'], rootTemplateSubpath));
1106
+ const rootPlannedPathGroups = await Promise.all(rootTemplateDirectories.map(async (rootTemplateDirectory) => {
1107
+ const rootTemplateEntries = await collectFiles(rootTemplateDirectory, '');
1108
+ return rootTemplateEntries.map((rootTemplateEntry) => join(configRoot, applyTemplateReplacements(rootTemplateEntry, replacements)));
1109
+ }));
1110
+ const plannedPaths = [
1111
+ ...workspacePlannedPathGroups.flat(),
1112
+ ...rootPlannedPathGroups.flat(),
1113
+ ];
902
1114
  if (config['mode'] === 'monorepo') {
903
- plannedPaths.push(join(configRoot, 'package.json'), configFilePath, join(configRoot, 'turbo.json'));
1115
+ plannedPaths.push(...await getMonorepoRootPlannedPaths(configRoot));
904
1116
  }
905
1117
  const conflictingPaths = await findFileConflicts(plannedPaths);
906
1118
  if (conflictingPaths.length > 0) {
@@ -918,20 +1130,10 @@ export async function runScaffold(options, category, typeName, templateSubpath,
918
1130
  }
919
1131
  }
920
1132
  }
921
- const templateReplacements = await resolveTemplateAnswers(options, templateQuestions, isNonInteractive);
922
- if (templateReplacements === undefined) {
923
- if (process.exitCode !== 1) {
924
- Logger.customize({
925
- name: 'CliScaffold.run',
926
- purpose: 'cancelled',
927
- }).warn('Scaffold cancelled.');
928
- }
929
- return;
930
- }
931
1133
  Logger.customize({
932
1134
  name: 'CliScaffold.run',
933
1135
  purpose: 'config',
934
- }).info(`Scaffolding ${category} ${typeName} workspace "${workspacePackageName}" in "${workspaceDirectory}".`);
1136
+ }).info(`Scaffolding ${definition['category']} ${definition['typeName']} workspace "${workspacePackageName}" in "${workspaceDirectory}".`);
935
1137
  if (isDryRun === true) {
936
1138
  if (config['mode'] === 'monorepo') {
937
1139
  Logger.customize({
@@ -943,6 +1145,12 @@ export async function runScaffold(options, category, typeName, templateSubpath,
943
1145
  name: 'CliScaffold.run',
944
1146
  purpose: 'dryRunWorkspace',
945
1147
  }).info(`Would create workspace at "${workspaceDirectory}" and register "${workspaceRelPath}".`);
1148
+ if (rootTemplateDirectories.length > 0) {
1149
+ Logger.customize({
1150
+ name: 'CliScaffold.run',
1151
+ purpose: 'dryRunRootFiles',
1152
+ }).info(`Would create companion files at the monorepo root "${configRoot}".`);
1153
+ }
946
1154
  if (existingRoot !== undefined && isWorkspaceCovered === false) {
947
1155
  Logger.customize({
948
1156
  name: 'CliScaffold.run',
@@ -955,18 +1163,26 @@ export async function runScaffold(options, category, typeName, templateSubpath,
955
1163
  await createMonorepoRoot(configRoot, projectSlug);
956
1164
  }
957
1165
  await fs.mkdir(workspaceDirectory, { recursive: true });
958
- const replacements = new Map([
959
- [
960
- LIB_REGEX_PLACEHOLDER_PROJECT_SLUG,
961
- projectSlug,
962
- ],
963
- [
964
- LIB_REGEX_PLACEHOLDER_WORKSPACE_PACKAGE_NAME,
965
- workspacePackageName,
966
- ],
967
- ...templateReplacements,
1166
+ const workspaceTemplateWrites = workspaceTemplateDirectories.map((workspaceTemplateDirectory) => writeTemplateFiles(workspaceTemplateDirectory, workspaceDirectory, replacements));
1167
+ const rootTemplateWrites = rootTemplateDirectories.map((rootTemplateDirectory) => writeTemplateFiles(rootTemplateDirectory, configRoot, replacements));
1168
+ await Promise.all([
1169
+ ...workspaceTemplateWrites,
1170
+ ...rootTemplateWrites,
968
1171
  ]);
969
- await writeTemplateFiles(templateDirectory, workspaceDirectory, replacements);
1172
+ if (definition['workspaceFinalizer'] !== undefined) {
1173
+ try {
1174
+ await definition.workspaceFinalizer(workspaceDirectory, config['workspaceName'], configRoot, templateAnswers, replacements);
1175
+ }
1176
+ catch (error) {
1177
+ const workspaceFinalizerError = error;
1178
+ Logger.customize({
1179
+ name: 'CliScaffold.run',
1180
+ purpose: 'workspaceFinalizer',
1181
+ }).debug(workspaceFinalizerError);
1182
+ reportError(`The ${definition['typeName']} framework could not finish preparing the workspace. The generated files were left in place for inspection, but the workspace was not registered.`);
1183
+ return;
1184
+ }
1185
+ }
970
1186
  if (existingRoot !== undefined && isWorkspaceCovered === false) {
971
1187
  existingRoot['workspacePatterns'].push(normalizedWorkspaceRelPath);
972
1188
  const rootPackageJsonPath = join(configRoot, 'package.json');
@@ -985,11 +1201,11 @@ export async function runScaffold(options, category, typeName, templateSubpath,
985
1201
  purpose: 'workspaces',
986
1202
  }).info(`Added "${normalizedWorkspaceRelPath}" to the root package.json workspaces.`);
987
1203
  }
988
- await registerWorkspaceInConfig(configFilePath, workspaceRelPath, config['workspaceName'], category);
1204
+ await registerWorkspaceInConfig(configFilePath, workspaceRelPath, workspacePackageName, definition['category']);
989
1205
  Logger.customize({
990
1206
  name: 'CliScaffold.run',
991
1207
  purpose: 'complete',
992
- }).info(`Scaffold complete for ${category} ${typeName}.`);
1208
+ }).info(`Scaffold complete for ${definition['category']} ${definition['typeName']}.`);
993
1209
  if (config['mode'] === 'monorepo' && isNonInteractive === false) {
994
1210
  await promptPostScaffoldGenerators(configRoot);
995
1211
  }