@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
@@ -0,0 +1,78 @@
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ require_once('config.inc');
6
+ require_once('pfsense-utils.inc');
7
+ require_once('services.inc');
8
+
9
+ /**
10
+ * Returns the saved package settings.
11
+ *
12
+ * @return array<string, mixed> Package settings.
13
+ */
14
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings(): array
15
+ {
16
+ $settings = config_get_path('installedpackages/[__WORKSPACE_NAME__]/config/0', []);
17
+
18
+ return is_array($settings) ? $settings : [];
19
+ }
20
+
21
+ /**
22
+ * Maps the WebGUI schedule value to cron fields.
23
+ *
24
+ * @param string $schedule Selected schedule.
25
+ *
26
+ * @return array{string, string, string, string, string} Cron fields.
27
+ */
28
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSchedule(string $schedule): array
29
+ {
30
+ return match ($schedule) {
31
+ 'daily' => ['0', '0', '*', '*', '*'],
32
+ 'weekly' => ['0', '0', '*', '*', '0'],
33
+ default => ['0', '*', '*', '*', '*'],
34
+ };
35
+ }
36
+
37
+ /**
38
+ * Synchronizes the package cron job with the saved WebGUI settings.
39
+ */
40
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync(): void
41
+ {
42
+ $command = '/usr/local/sbin/[__WORKSPACE_NAME__]';
43
+
44
+ install_cron_job($command, false);
45
+
46
+ $settings = pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings();
47
+
48
+ if (($settings['enabled'] ?? '') !== 'on') {
49
+ return;
50
+ }
51
+
52
+ [$minute, $hour, $dayOfMonth, $month, $dayOfWeek] = pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSchedule((string) ($settings['schedule'] ?? 'hourly'));
53
+
54
+ install_cron_job($command, true, $minute, $hour, $dayOfMonth, $month, $dayOfWeek, 'root');
55
+ }
56
+
57
+ /**
58
+ * Removes the package cron job.
59
+ */
60
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Remove(): void
61
+ {
62
+ install_cron_job('/usr/local/sbin/[__WORKSPACE_NAME__]', false);
63
+ }
64
+
65
+ /**
66
+ * Validates values submitted by the package WebGUI.
67
+ *
68
+ * @param array<string, mixed> $post Submitted values.
69
+ * @param string[] $inputErrors Validation errors.
70
+ */
71
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Validate(array $post, array &$inputErrors): void
72
+ {
73
+ $message = trim((string) ($post['message'] ?? ''));
74
+
75
+ if ($message === '') {
76
+ $inputErrors[] = 'The task message cannot be empty.';
77
+ }
78
+ }
@@ -0,0 +1,68 @@
1
+ <?xml version="1.0" encoding="utf-8" ?>
2
+ <!DOCTYPE packagegui SYSTEM "../schema/packages.dtd">
3
+ <?xml-stylesheet type="text/xsl" href="../xsl/package.xsl"?>
4
+ <packagegui>
5
+ <copyright>
6
+ <![CDATA[
7
+ /*
8
+ * Generated by Nova for [__PROJECT_SLUG__].
9
+ * SPDX-License-Identifier: MIT
10
+ */
11
+ ]]>
12
+ </copyright>
13
+ <name>[__WORKSPACE_NAME__]</name>
14
+ <version>%%PKGVERSION%%</version>
15
+ <title>Services: [__WORKSPACE_TITLE__]</title>
16
+ <include_file>/usr/local/pkg/[__WORKSPACE_NAME__].inc</include_file>
17
+ <aftersaveredirect>/pkg.php?xml=[__WORKSPACE_NAME__].xml</aftersaveredirect>
18
+ <menu>
19
+ <name>[__WORKSPACE_TITLE__]</name>
20
+ <section>Services</section>
21
+ <configfile>[__WORKSPACE_NAME__].xml</configfile>
22
+ <url>/pkg.php?xml=[__WORKSPACE_NAME__].xml</url>
23
+ </menu>
24
+ <fields>
25
+ <field>
26
+ <type>listtopic</type>
27
+ <name>[__WORKSPACE_TITLE__] Settings</name>
28
+ </field>
29
+ <field>
30
+ <fielddescr>Enable Scheduled Task</fielddescr>
31
+ <fieldname>enabled</fieldname>
32
+ <type>checkbox</type>
33
+ <description>Run the package's background task on the selected schedule.</description>
34
+ </field>
35
+ <field>
36
+ <fielddescr>Schedule</fielddescr>
37
+ <fieldname>schedule</fieldname>
38
+ <type>select</type>
39
+ <options>
40
+ <option><name>Hourly</name><value>hourly</value></option>
41
+ <option><name>Daily at midnight</name><value>daily</value></option>
42
+ <option><name>Weekly on Sunday</name><value>weekly</value></option>
43
+ </options>
44
+ <description>Choose how often pfSense runs the background task.</description>
45
+ </field>
46
+ <field>
47
+ <fielddescr>Task Message</fielddescr>
48
+ <fieldname>message</fieldname>
49
+ <type>input</type>
50
+ <size>60</size>
51
+ <default_value>Scheduled [__WORKSPACE_TITLE__] task completed.</default_value>
52
+ <description>Starter value written to the pfSense system log by the generated task.</description>
53
+ <required/>
54
+ </field>
55
+ </fields>
56
+ <custom_php_install_command>
57
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync();
58
+ </custom_php_install_command>
59
+ <custom_php_resync_config_command>
60
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync();
61
+ </custom_php_resync_config_command>
62
+ <custom_delete_php_command>
63
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Remove();
64
+ </custom_delete_php_command>
65
+ <custom_php_validation_command>
66
+ pfsensePackage[__WORKSPACE_IDENTIFIER__]Validate($_POST, $input_errors);
67
+ </custom_php_validation_command>
68
+ </packagegui>
@@ -0,0 +1,21 @@
1
+ #!/usr/local/bin/php -f
2
+ <?php
3
+
4
+ declare(strict_types=1);
5
+
6
+ require_once('/etc/inc/config.inc');
7
+ require_once('/etc/inc/util.inc');
8
+
9
+ $settings = config_get_path('installedpackages/[__WORKSPACE_NAME__]/config/0', []);
10
+
11
+ if (!is_array($settings) || ($settings['enabled'] ?? '') !== 'on') {
12
+ exit(0);
13
+ }
14
+
15
+ $message = trim((string) ($settings['message'] ?? ''));
16
+
17
+ if ($message === '') {
18
+ $message = 'Scheduled [__WORKSPACE_TITLE__] task completed.';
19
+ }
20
+
21
+ log_error(sprintf('[__WORKSPACE_TITLE__]: %s', $message));
@@ -0,0 +1,9 @@
1
+ <?xml version="1.0"?>
2
+ <pfsensepkgs>
3
+ <package>
4
+ <name>[__WORKSPACE_TITLE__]</name>
5
+ <descr><![CDATA[[__WORKSPACE_TITLE__] adds a WebGUI-managed scheduled task to pfSense.]]></descr>
6
+ <version>%%PKGVERSION%%</version>
7
+ <configurationfile>[__WORKSPACE_NAME__].xml</configurationfile>
8
+ </package>
9
+ </pfsensepkgs>
@@ -0,0 +1,3 @@
1
+ [__WORKSPACE_TITLE__] adds a WebGUI settings page and a scheduled background
2
+ task to pfSense. The task is configured from Services > [__WORKSPACE_TITLE__]
3
+ and runs without an interactive command-line interface.
@@ -0,0 +1,4 @@
1
+ pkg/[__WORKSPACE_NAME__].inc
2
+ pkg/[__WORKSPACE_NAME__].xml
3
+ sbin/[__WORKSPACE_NAME__]
4
+ %%DATADIR%%/info.xml
@@ -0,0 +1,72 @@
1
+ #!/bin/sh
2
+
3
+ set -eu
4
+
5
+ SCRIPT_DIR="$(CDPATH='' cd -- "$(dirname -- "$0")" && pwd)"
6
+ WORKSPACE_DIR="$(CDPATH='' cd -- "${SCRIPT_DIR}/.." && pwd)"
7
+ STAGED_PORT_DIR="${WORKSPACE_DIR}/build/port"
8
+ PORTS_DIR="${PFSENSE_PORTS_DIR:-}"
9
+ PORT_DESTINATION="${PORTS_DIR}/sysutils/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]"
10
+ RELEASE_DIR="${WORKSPACE_DIR}/build/release"
11
+ CREATED_PORT_DESTINATION='false'
12
+
13
+ cleanup() {
14
+ if [ "${CREATED_PORT_DESTINATION}" = 'true' ] && [ -d "${PORT_DESTINATION}" ]; then
15
+ rm -rf -- "${PORT_DESTINATION}"
16
+ fi
17
+ }
18
+
19
+ main() {
20
+ if [ "$(uname -s)" != 'FreeBSD' ]; then
21
+ echo 'The final pfSense package must be built on FreeBSD.' >&2
22
+ exit 1
23
+ fi
24
+
25
+ if [ -z "${PORTS_DIR}" ] || [ ! -f "${PORTS_DIR}/Mk/bsd.port.mk" ]; then
26
+ echo 'Set PFSENSE_PORTS_DIR to a pfSense FreeBSD-ports checkout.' >&2
27
+ exit 1
28
+ fi
29
+
30
+ if [ ! -f "${STAGED_PORT_DIR}/Makefile" ]; then
31
+ echo 'Run npm run build before packaging so build/port is staged.' >&2
32
+ exit 1
33
+ fi
34
+
35
+ if [ -e "${PORT_DESTINATION}" ]; then
36
+ echo "The temporary port destination already exists: ${PORT_DESTINATION}" >&2
37
+ exit 1
38
+ fi
39
+
40
+ trap cleanup EXIT HUP INT TERM
41
+
42
+ mkdir -p -- "$(dirname -- "${PORT_DESTINATION}")"
43
+ cp -R -- "${STAGED_PORT_DIR}" "${PORT_DESTINATION}"
44
+ CREATED_PORT_DESTINATION='true'
45
+
46
+ make -C "${PORT_DESTINATION}" package BATCH=yes DISABLE_VULNERABILITIES=yes
47
+
48
+ artifact=''
49
+
50
+ for candidate in "${PORT_DESTINATION}"/work/pkg/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]-*.pkg "${PORT_DESTINATION}"/work/pkg/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]-*.txz; do
51
+ if [ -f "${candidate}" ]; then
52
+ artifact="${candidate}"
53
+ break
54
+ fi
55
+ done
56
+
57
+ if [ -z "${artifact}" ]; then
58
+ echo 'The FreeBSD ports build completed without a pfSense package artifact.' >&2
59
+ exit 1
60
+ fi
61
+
62
+ mkdir -p -- "${RELEASE_DIR}"
63
+ cp -- "${artifact}" "${RELEASE_DIR}/"
64
+
65
+ artifact_name="$(basename -- "${artifact}")"
66
+
67
+ sha256 -q "${RELEASE_DIR}/${artifact_name}" > "${RELEASE_DIR}/${artifact_name}.sha256"
68
+
69
+ echo "Created ${RELEASE_DIR}/${artifact_name} and its SHA-256 checksum."
70
+ }
71
+
72
+ main "$@"
@@ -0,0 +1,92 @@
1
+ import { access, readFile } from 'node:fs/promises';
2
+ import { dirname, join, resolve } from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+
5
+ import { semanticVersionPattern } from './regex.mjs';
6
+
7
+ /**
8
+ * Check Package - Workspace Directory.
9
+ *
10
+ * Resolves the generated pfSense package workspace from this script file.
11
+ * Every structural check uses this stable absolute directory as its base.
12
+ *
13
+ * @since 0.0.0
14
+ */
15
+ const workspaceDirectory = resolve(dirname(fileURLToPath(import.meta.url)), '..');
16
+
17
+ /**
18
+ * Check Package - Required Files.
19
+ *
20
+ * Lists every source artifact needed to stage and publish the pfSense package.
21
+ * A missing entry fails validation before a release archive is attempted.
22
+ *
23
+ * @since 0.0.0
24
+ */
25
+ const requiredFiles = [
26
+ 'package.json',
27
+ 'port/Makefile.template',
28
+ 'port/pkg-descr',
29
+ 'port/pkg-plist',
30
+ 'port/files/pkg-deinstall.in',
31
+ 'port/files/pkg-install.in',
32
+ 'port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc',
33
+ 'port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml',
34
+ 'port/files/usr/local/sbin/[__WORKSPACE_NAME__]',
35
+ 'port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/info.xml',
36
+ ];
37
+
38
+ await Promise.all(requiredFiles.map(async (requiredFile) => {
39
+ await access(join(workspaceDirectory, requiredFile));
40
+
41
+ return;
42
+ }));
43
+
44
+ /**
45
+ * Check Package - package.json Raw.
46
+ *
47
+ * Reads the workspace manifest before its release version is validated.
48
+ * The raw value remains separate from the parsed object for clear diagnostics.
49
+ *
50
+ * @since 0.0.0
51
+ */
52
+ const packageJsonRaw = await readFile(join(workspaceDirectory, 'package.json'), 'utf-8');
53
+
54
+ /**
55
+ * Check Package - package.json.
56
+ *
57
+ * Parses the workspace manifest used to stage the FreeBSD port version.
58
+ * Validation below rejects missing and malformed release values.
59
+ *
60
+ * @since 0.0.0
61
+ */
62
+ const packageJson = JSON.parse(packageJsonRaw);
63
+
64
+ /**
65
+ * Check Package - Version.
66
+ *
67
+ * Selects the manifest version embedded into the staged FreeBSD port.
68
+ * Semantic-version validation keeps generated release metadata predictable.
69
+ *
70
+ * @since 0.0.0
71
+ */
72
+ const version = packageJson['version'];
73
+
74
+ if (typeof version !== 'string' || semanticVersionPattern.test(version) === false) {
75
+ throw new Error('package.json must contain a semantic version that can be staged as a FreeBSD port version.');
76
+ }
77
+
78
+ /**
79
+ * Check Package - Makefile Template.
80
+ *
81
+ * Reads the port Makefile template so its Nova version token can be checked.
82
+ * The staging command replaces this token with the validated package version.
83
+ *
84
+ * @since 0.0.0
85
+ */
86
+ const makefileTemplate = await readFile(join(workspaceDirectory, 'port', 'Makefile.template'), 'utf-8');
87
+
88
+ if (makefileTemplate.includes('%%NOVA_PORTVERSION%%') === false) {
89
+ throw new Error('port/Makefile.template must retain the %%NOVA_PORTVERSION%% build placeholder.');
90
+ }
91
+
92
+ process.stdout.write('pfSense package sources are structurally valid.\n');
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Regex - Semantic Version Pattern.
3
+ *
4
+ * Matches the release versions supported by the generated pfSense package.
5
+ * Keeping the pattern shared prevents validation logic from mixing with I/O.
6
+ *
7
+ * @since 0.0.0
8
+ */
9
+ export const semanticVersionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
@@ -0,0 +1,135 @@
1
+ import {
2
+ cp,
3
+ mkdir,
4
+ readFile,
5
+ rm,
6
+ writeFile,
7
+ } from 'node:fs/promises';
8
+ import { dirname, join, resolve } from 'node:path';
9
+ import { fileURLToPath } from 'node:url';
10
+
11
+ /**
12
+ * Stage Package - Workspace Directory.
13
+ *
14
+ * Resolves the generated pfSense package workspace from this script file.
15
+ * Every staging path derives from this stable absolute directory.
16
+ *
17
+ * @since 0.0.0
18
+ */
19
+ const workspaceDirectory = resolve(dirname(fileURLToPath(import.meta.url)), '..');
20
+
21
+ /**
22
+ * Stage Package - Source Directory.
23
+ *
24
+ * Points at the source-controlled FreeBSD port template.
25
+ * Staging copies this directory without modifying the checked-in sources.
26
+ *
27
+ * @since 0.0.0
28
+ */
29
+ const sourceDirectory = join(workspaceDirectory, 'port');
30
+
31
+ /**
32
+ * Stage Package - Build Directory.
33
+ *
34
+ * Points at the generated build output owned by this workspace.
35
+ * Clean and build commands may replace its contents safely.
36
+ *
37
+ * @since 0.0.0
38
+ */
39
+ const buildDirectory = join(workspaceDirectory, 'build');
40
+
41
+ /**
42
+ * Stage Package - Staged Port Directory.
43
+ *
44
+ * Points at the copied FreeBSD port tree ready for packaging.
45
+ * The directory is recreated for every production build.
46
+ *
47
+ * @since 0.0.0
48
+ */
49
+ const stagedPortDirectory = join(buildDirectory, 'port');
50
+
51
+ /**
52
+ * Stage Package - package.json Raw.
53
+ *
54
+ * Reads the workspace manifest before extracting its release version.
55
+ * The raw value remains separate from the parsed manifest object.
56
+ *
57
+ * @since 0.0.0
58
+ */
59
+ const packageJsonRaw = await readFile(join(workspaceDirectory, 'package.json'), 'utf-8');
60
+
61
+ /**
62
+ * Stage Package - package.json.
63
+ *
64
+ * Parses the workspace manifest used by the staging process.
65
+ * Its version becomes the FreeBSD port version in the generated Makefile.
66
+ *
67
+ * @since 0.0.0
68
+ */
69
+ const packageJson = JSON.parse(packageJsonRaw);
70
+
71
+ /**
72
+ * Stage Package - Version.
73
+ *
74
+ * Selects the package release version written into the staged port.
75
+ * Empty and non-string values are rejected before files are copied.
76
+ *
77
+ * @since 0.0.0
78
+ */
79
+ const version = packageJson['version'];
80
+
81
+ if (typeof version !== 'string' || version.length === 0) {
82
+ throw new Error('package.json must contain a version before the pfSense port can be staged.');
83
+ }
84
+
85
+ await rm(stagedPortDirectory, {
86
+ force: true,
87
+ recursive: true,
88
+ });
89
+ await mkdir(buildDirectory, { recursive: true });
90
+ await cp(sourceDirectory, stagedPortDirectory, { recursive: true });
91
+
92
+ /**
93
+ * Stage Package - Makefile Template Path.
94
+ *
95
+ * Points at the copied Makefile template inside the staging tree.
96
+ * The template is removed after its version token is replaced.
97
+ *
98
+ * @since 0.0.0
99
+ */
100
+ const makefileTemplatePath = join(stagedPortDirectory, 'Makefile.template');
101
+
102
+ /**
103
+ * Stage Package - Makefile Path.
104
+ *
105
+ * Points at the final FreeBSD port Makefile produced by this build.
106
+ * Package tooling reads this file from the staged output directory.
107
+ *
108
+ * @since 0.0.0
109
+ */
110
+ const makefilePath = join(stagedPortDirectory, 'Makefile');
111
+
112
+ /**
113
+ * Stage Package - Makefile Template.
114
+ *
115
+ * Reads the copied Makefile template before token replacement.
116
+ * Source-controlled templates remain unchanged by the staging process.
117
+ *
118
+ * @since 0.0.0
119
+ */
120
+ const makefileTemplate = await readFile(makefileTemplatePath, 'utf-8');
121
+
122
+ /**
123
+ * Stage Package - Makefile.
124
+ *
125
+ * Produces the final Makefile with the current package version embedded.
126
+ * This generated content exists only under the build directory.
127
+ *
128
+ * @since 0.0.0
129
+ */
130
+ const makefile = makefileTemplate.replaceAll('%%NOVA_PORTVERSION%%', version);
131
+
132
+ await writeFile(makefilePath, makefile, 'utf-8');
133
+ await rm(makefileTemplatePath);
134
+
135
+ process.stdout.write(`Staged pfSense port version ${version} in "${stagedPortDirectory}".\n`);
@@ -0,0 +1,24 @@
1
+ import {
2
+ describe,
3
+ expect,
4
+ it,
5
+ } from 'vitest';
6
+
7
+ import packageJson from '../package.json' with { type: 'json' };
8
+
9
+ /**
10
+ * Project - Workspace Identity.
11
+ *
12
+ * Confirms the generated workspace keeps its registered package identity.
13
+ *
14
+ * @since 0.0.0
15
+ */
16
+ describe('Workspace identity', () => {
17
+ it('uses the generated package name', () => {
18
+ expect(packageJson['name']).toBe('[__WORKSPACE_PACKAGE_NAME__]');
19
+
20
+ return;
21
+ });
22
+
23
+ return;
24
+ });
@@ -0,0 +1,19 @@
1
+ {
2
+ "extends": [
3
+ "@cbnventures/nova/presets/tsconfig/dx-essentials.json",
4
+ "@cbnventures/nova/presets/tsconfig/dx-strict.json",
5
+ "@cbnventures/nova/presets/tsconfig/runtime-node.json"
6
+ ],
7
+ "compilerOptions": {
8
+ "allowJs": true,
9
+ "checkJs": true,
10
+ "noEmit": true,
11
+ "types": [
12
+ "node"
13
+ ]
14
+ },
15
+ "include": [
16
+ "./eslint.config.mts",
17
+ "./scripts/**/*.mjs"
18
+ ]
19
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "extends": [
3
+ "@cbnventures/nova/presets/tsconfig/dx-essentials.json",
4
+ "@cbnventures/nova/presets/tsconfig/dx-strict.json",
5
+ "@cbnventures/nova/presets/tsconfig/runtime-node.json"
6
+ ],
7
+ "compilerOptions": {
8
+ "noEmit": true,
9
+ "types": [
10
+ "node",
11
+ "vitest/globals"
12
+ ]
13
+ },
14
+ "include": [
15
+ "./tests/**/*.test.ts",
16
+ "./vitest.config.mts"
17
+ ]
18
+ }
@@ -0,0 +1,15 @@
1
+ import { defineConfig } from 'vitest/config';
2
+
3
+ /**
4
+ * Vitest Configuration.
5
+ *
6
+ * Discovers tests for the Node.js helpers surrounding the pfSense package sources.
7
+ * FreeBSD package validation remains available through the package-specific check.
8
+ *
9
+ * @since 0.0.0
10
+ */
11
+ export default defineConfig({
12
+ test: {
13
+ include: ['tests/**/*.test.ts'],
14
+ },
15
+ });
@@ -0,0 +1,68 @@
1
+ import {
2
+ dxCodeStyle,
3
+ dxIgnore,
4
+ langJavascript,
5
+ langTypescript,
6
+ runtimeNode,
7
+ } from '@cbnventures/nova/presets/eslint';
8
+ import { novaRules } from '@cbnventures/nova/rules/eslint';
9
+
10
+ /**
11
+ * ESLint Configuration.
12
+ *
13
+ * Lints the TypeScript project root while each JavaScript or TypeScript
14
+ * workspace owns its framework-specific configuration.
15
+ *
16
+ * @since 0.0.0
17
+ */
18
+ export default [
19
+ ...dxIgnore,
20
+ ...dxCodeStyle,
21
+ ...langJavascript,
22
+ ...langTypescript,
23
+ ...runtimeNode,
24
+ {
25
+ name: 'custom-ignores',
26
+ ignores: [
27
+ 'apps/**',
28
+ 'packages/**',
29
+ 'tools/**',
30
+ ],
31
+ },
32
+ {
33
+ name: 'custom-tsconfig',
34
+ files: [
35
+ '**/*.cts',
36
+ '**/*.mts',
37
+ '**/*.ts',
38
+ '**/*.tsx',
39
+ ],
40
+ languageOptions: {
41
+ parserOptions: {
42
+ project: [
43
+ './tsconfig.config.json',
44
+ './tsconfig.tests.json',
45
+ ],
46
+ },
47
+ },
48
+ },
49
+ ...novaRules,
50
+ {
51
+ name: 'scripts-overrides',
52
+ files: ['scripts/**/*.mjs'],
53
+ rules: {
54
+ // Run-directly scripts are entry points (invoked as `node scripts/x.mjs`,
55
+ // never imported), so process.exit is the correct way to set a precise
56
+ // exit code. Throwing would collapse every failure to code 1. The rule
57
+ // targets importable modules, so it is a false positive on these files.
58
+ 'no-process-exit': 'off',
59
+ 'n/no-process-exit': 'off',
60
+
61
+ // no-inline-type-annotation is a TypeScript-only rule (it wants a named
62
+ // .d.ts type in place of an inferred one), which untyped .mjs JavaScript
63
+ // cannot satisfy. Keep it enabled globally and disable it only for these
64
+ // generated run-directly scripts.
65
+ '@cbnventures/nova/no-inline-type-annotation': 'off',
66
+ },
67
+ },
68
+ ];
@@ -0,0 +1,24 @@
1
+ import {
2
+ describe,
3
+ expect,
4
+ it,
5
+ } from 'vitest';
6
+
7
+ import packageJson from '../package.json' with { type: 'json' };
8
+
9
+ /**
10
+ * Project - Project Root.
11
+ *
12
+ * Confirms the generated root remains a private monorepo coordinator.
13
+ *
14
+ * @since 0.0.0
15
+ */
16
+ describe('Project root', () => {
17
+ it('stays private', () => {
18
+ expect(packageJson['private']).toBe(true);
19
+
20
+ return;
21
+ });
22
+
23
+ return;
24
+ });