@cbnventures/nova 0.31.1 → 0.32.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 (456) hide show
  1. package/build/package.json +5 -6
  2. package/build/scaffold-versions.json +828 -0
  3. package/build/src/cli/generate/github/workflows-blueprint.d.ts +3 -3
  4. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  5. package/build/src/cli/generate/github/workflows-blueprint.js +47 -69
  6. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  7. package/build/src/cli/generate/must-haves/ignore-files.d.ts +5 -0
  8. package/build/src/cli/generate/must-haves/ignore-files.d.ts.map +1 -0
  9. package/build/src/cli/generate/must-haves/ignore-files.js +77 -0
  10. package/build/src/cli/generate/must-haves/ignore-files.js.map +1 -0
  11. package/build/src/cli/index.js +65 -68
  12. package/build/src/cli/index.js.map +1 -1
  13. package/build/src/cli/recipe/index.d.ts.map +1 -1
  14. package/build/src/cli/recipe/index.js +9 -2
  15. package/build/src/cli/recipe/index.js.map +1 -1
  16. package/build/src/cli/recipe/miscellaneous/fix-markdown-tables.d.ts.map +1 -1
  17. package/build/src/cli/recipe/miscellaneous/fix-markdown-tables.js +0 -1
  18. package/build/src/cli/recipe/miscellaneous/fix-markdown-tables.js.map +1 -1
  19. package/build/src/cli/recipe/miscellaneous/remove-operating-system-files.d.ts +9 -0
  20. package/build/src/cli/recipe/miscellaneous/remove-operating-system-files.d.ts.map +1 -0
  21. package/build/src/cli/recipe/miscellaneous/remove-operating-system-files.js +173 -0
  22. package/build/src/cli/recipe/miscellaneous/remove-operating-system-files.js.map +1 -0
  23. package/build/src/cli/recipe/package-json/normalize-tooling.d.ts.map +1 -1
  24. package/build/src/cli/recipe/package-json/normalize-tooling.js +65 -28
  25. package/build/src/cli/recipe/package-json/normalize-tooling.js.map +1 -1
  26. package/build/src/cli/scaffold/app/apple.d.ts +5 -0
  27. package/build/src/cli/scaffold/app/apple.d.ts.map +1 -1
  28. package/build/src/cli/scaffold/app/apple.js +91 -0
  29. package/build/src/cli/scaffold/app/apple.js.map +1 -1
  30. package/build/src/cli/scaffold/app/astro.d.ts.map +1 -1
  31. package/build/src/cli/scaffold/app/astro.js +6 -5
  32. package/build/src/cli/scaffold/app/astro.js.map +1 -1
  33. package/build/src/cli/scaffold/app/discord-bot.js +2 -2
  34. package/build/src/cli/scaffold/app/discord-bot.js.map +1 -1
  35. package/build/src/cli/scaffold/app/expressjs.js +2 -2
  36. package/build/src/cli/scaffold/app/expressjs.js.map +1 -1
  37. package/build/src/cli/scaffold/app/nextjs.js +2 -2
  38. package/build/src/cli/scaffold/app/nextjs.js.map +1 -1
  39. package/build/src/cli/scaffold/app/vite.d.ts.map +1 -1
  40. package/build/src/cli/scaffold/app/vite.js +13 -12
  41. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  42. package/build/src/cli/scaffold/docs/docusaurus.js +2 -2
  43. package/build/src/cli/scaffold/docs/docusaurus.js.map +1 -1
  44. package/build/src/cli/scaffold/package/homebridge.d.ts.map +1 -1
  45. package/build/src/cli/scaffold/package/homebridge.js +2 -1
  46. package/build/src/cli/scaffold/package/homebridge.js.map +1 -1
  47. package/build/src/cli/scaffold/starter/base.d.ts.map +1 -1
  48. package/build/src/cli/scaffold/starter/base.js.map +1 -1
  49. package/build/src/cli/scaffold/tool/serverless.d.ts +6 -0
  50. package/build/src/cli/scaffold/tool/serverless.d.ts.map +1 -0
  51. package/build/src/cli/scaffold/tool/serverless.js +43 -0
  52. package/build/src/cli/scaffold/tool/serverless.js.map +1 -0
  53. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  54. package/build/src/cli/utility/changelog.js +57 -5
  55. package/build/src/cli/utility/changelog.js.map +1 -1
  56. package/build/src/cli/utility/configure.d.ts +22 -1
  57. package/build/src/cli/utility/configure.d.ts.map +1 -1
  58. package/build/src/cli/utility/configure.js +1995 -247
  59. package/build/src/cli/utility/configure.js.map +1 -1
  60. package/build/src/cli/utility/run-workspaces.d.ts +10 -0
  61. package/build/src/cli/utility/run-workspaces.d.ts.map +1 -0
  62. package/build/src/cli/utility/run-workspaces.js +48 -0
  63. package/build/src/cli/utility/run-workspaces.js.map +1 -0
  64. package/build/src/lib/corepack.d.ts +2 -1
  65. package/build/src/lib/corepack.d.ts.map +1 -1
  66. package/build/src/lib/corepack.js +21 -0
  67. package/build/src/lib/corepack.js.map +1 -1
  68. package/build/src/lib/docker-packaging.d.ts +7 -0
  69. package/build/src/lib/docker-packaging.d.ts.map +1 -0
  70. package/build/src/{cli/generate/docker-image/index.js → lib/docker-packaging.js} +22 -96
  71. package/build/src/lib/docker-packaging.js.map +1 -0
  72. package/build/src/lib/ignore-files.d.ts +5 -0
  73. package/build/src/lib/ignore-files.d.ts.map +1 -0
  74. package/build/src/lib/ignore-files.js +77 -0
  75. package/build/src/lib/ignore-files.js.map +1 -0
  76. package/build/src/lib/item.d.ts +3 -1
  77. package/build/src/lib/item.d.ts.map +1 -1
  78. package/build/src/lib/item.js +21 -0
  79. package/build/src/lib/item.js.map +1 -1
  80. package/build/src/lib/nova-config.d.ts +3 -1
  81. package/build/src/lib/nova-config.d.ts.map +1 -1
  82. package/build/src/lib/nova-config.js +163 -11
  83. package/build/src/lib/nova-config.js.map +1 -1
  84. package/build/src/lib/package-scripts.d.ts +11 -0
  85. package/build/src/lib/package-scripts.d.ts.map +1 -0
  86. package/build/src/lib/package-scripts.js +227 -0
  87. package/build/src/lib/package-scripts.js.map +1 -0
  88. package/build/src/lib/regex.d.ts +3 -1
  89. package/build/src/lib/regex.d.ts.map +1 -1
  90. package/build/src/lib/regex.js +5 -3
  91. package/build/src/lib/regex.js.map +1 -1
  92. package/build/src/lib/run-scripts.d.ts +0 -1
  93. package/build/src/lib/run-scripts.d.ts.map +1 -1
  94. package/build/src/lib/run-scripts.js +9 -12
  95. package/build/src/lib/run-scripts.js.map +1 -1
  96. package/build/src/lib/run-workspaces-cache.d.ts +7 -0
  97. package/build/src/lib/run-workspaces-cache.d.ts.map +1 -0
  98. package/build/src/lib/run-workspaces-cache.js +168 -0
  99. package/build/src/lib/run-workspaces-cache.js.map +1 -0
  100. package/build/src/lib/run-workspaces.d.ts +18 -0
  101. package/build/src/lib/run-workspaces.d.ts.map +1 -0
  102. package/build/src/lib/run-workspaces.js +782 -0
  103. package/build/src/lib/run-workspaces.js.map +1 -0
  104. package/build/src/lib/scaffold-presentation.d.ts.map +1 -1
  105. package/build/src/lib/scaffold-presentation.js.map +1 -1
  106. package/build/src/lib/scaffold-versions.d.ts +4 -0
  107. package/build/src/lib/scaffold-versions.d.ts.map +1 -0
  108. package/build/src/lib/scaffold-versions.js +17 -0
  109. package/build/src/lib/scaffold-versions.js.map +1 -0
  110. package/build/src/lib/scaffold.d.ts.map +1 -1
  111. package/build/src/lib/scaffold.js +133 -130
  112. package/build/src/lib/scaffold.js.map +1 -1
  113. package/build/src/lib/transpile.d.ts.map +1 -1
  114. package/build/src/lib/transpile.js +4 -3
  115. package/build/src/lib/transpile.js.map +1 -1
  116. package/build/src/lib/type-check.d.ts +2 -1
  117. package/build/src/lib/type-check.d.ts.map +1 -1
  118. package/build/src/lib/type-check.js +22 -4
  119. package/build/src/lib/type-check.js.map +1 -1
  120. package/build/src/lib/type-declaration-engine.d.ts.map +1 -1
  121. package/build/src/lib/type-declaration-engine.js +57 -30
  122. package/build/src/lib/type-declaration-engine.js.map +1 -1
  123. package/build/src/lib/utility.d.ts +2 -2
  124. package/build/src/lib/utility.d.ts.map +1 -1
  125. package/build/src/lib/utility.js +28 -5
  126. package/build/src/lib/utility.js.map +1 -1
  127. package/build/src/presets/eslint/index.d.ts +1 -0
  128. package/build/src/presets/eslint/index.d.ts.map +1 -1
  129. package/build/src/presets/eslint/index.js +1 -0
  130. package/build/src/presets/eslint/index.js.map +1 -1
  131. package/build/src/presets/eslint/nova-rules.d.ts +4 -0
  132. package/build/src/presets/eslint/nova-rules.d.ts.map +1 -0
  133. package/build/src/{rules → presets}/eslint/nova-rules.js +48 -48
  134. package/build/src/presets/eslint/nova-rules.js.map +1 -0
  135. package/build/src/rules/eslint/index.d.ts +0 -1
  136. package/build/src/rules/eslint/index.d.ts.map +1 -1
  137. package/build/src/rules/eslint/index.js +0 -1
  138. package/build/src/rules/eslint/index.js.map +1 -1
  139. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.d.ts.map +1 -1
  140. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.js +2 -1
  141. package/build/src/rules/eslint/jsdoc/require-jsdoc-body.js.map +1 -1
  142. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts.map +1 -1
  143. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js +7 -5
  144. package/build/src/rules/eslint/jsdoc/require-jsdoc-hierarchy.js.map +1 -1
  145. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.d.ts.map +1 -1
  146. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.js +3 -2
  147. package/build/src/rules/eslint/jsdoc/require-jsdoc-presence.js.map +1 -1
  148. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.d.ts +2 -1
  149. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.d.ts.map +1 -1
  150. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.js +87 -1
  151. package/build/src/rules/eslint/jsdoc/require-jsdoc-returns.js.map +1 -1
  152. package/build/src/rules/vitest/dotenv/register.js +1 -1
  153. package/build/src/rules/vitest/dotenv/register.js.map +1 -1
  154. package/build/src/rules/vitest/dotenv/rules.js +2 -2
  155. package/build/src/rules/vitest/dotenv/rules.js.map +1 -1
  156. package/build/src/rules/vitest/frontmatter/register.js +1 -1
  157. package/build/src/rules/vitest/frontmatter/register.js.map +1 -1
  158. package/build/src/rules/vitest/frontmatter/rules.js +2 -2
  159. package/build/src/rules/vitest/frontmatter/rules.js.map +1 -1
  160. package/build/src/rules/vitest/index.d.ts +2 -1
  161. package/build/src/rules/vitest/index.d.ts.map +1 -1
  162. package/build/src/rules/vitest/index.js +1 -0
  163. package/build/src/rules/vitest/index.js.map +1 -1
  164. package/build/src/rules/vitest/internal/active-vitest.d.ts +5 -0
  165. package/build/src/rules/vitest/internal/active-vitest.d.ts.map +1 -0
  166. package/build/src/rules/vitest/internal/active-vitest.js.map +1 -0
  167. package/build/src/rules/vitest/internal/is-enabled.d.ts +3 -0
  168. package/build/src/rules/vitest/internal/is-enabled.d.ts.map +1 -0
  169. package/build/src/rules/vitest/{enable.js → internal/is-enabled.js} +1 -1
  170. package/build/src/rules/vitest/internal/is-enabled.js.map +1 -0
  171. package/build/src/rules/vitest/link/register.js +1 -1
  172. package/build/src/rules/vitest/link/register.js.map +1 -1
  173. package/build/src/rules/vitest/link/rules.js +2 -2
  174. package/build/src/rules/vitest/link/rules.js.map +1 -1
  175. package/build/src/rules/vitest/markdown-table/register.js +1 -1
  176. package/build/src/rules/vitest/markdown-table/register.js.map +1 -1
  177. package/build/src/rules/vitest/markdown-table/rules.js +2 -2
  178. package/build/src/rules/vitest/markdown-table/rules.js.map +1 -1
  179. package/build/src/rules/vitest/package-scripts/register.d.ts +3 -0
  180. package/build/src/rules/vitest/package-scripts/register.d.ts.map +1 -0
  181. package/build/src/rules/vitest/package-scripts/register.js +23 -0
  182. package/build/src/rules/vitest/package-scripts/register.js.map +1 -0
  183. package/build/src/rules/vitest/package-scripts/rules.d.ts +3 -0
  184. package/build/src/rules/vitest/package-scripts/rules.d.ts.map +1 -0
  185. package/build/src/rules/vitest/package-scripts/rules.js +28 -0
  186. package/build/src/rules/vitest/package-scripts/rules.js.map +1 -0
  187. package/build/src/rules/vitest/terminology/register.js +1 -1
  188. package/build/src/rules/vitest/terminology/register.js.map +1 -1
  189. package/build/src/rules/vitest/terminology/rules.js +2 -2
  190. package/build/src/rules/vitest/terminology/rules.js.map +1 -1
  191. package/build/src/rules/vitest/type-declarations/register.js +1 -1
  192. package/build/src/rules/vitest/type-declarations/register.js.map +1 -1
  193. package/build/src/rules/vitest/type-declarations/rules.d.ts.map +1 -1
  194. package/build/src/rules/vitest/type-declarations/rules.js +50 -21
  195. package/build/src/rules/vitest/type-declarations/rules.js.map +1 -1
  196. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +1 -15
  197. package/build/src/types/cli/generate/must-haves/ignore-files.d.ts +56 -0
  198. package/build/src/types/cli/index.d.ts +23 -7
  199. package/build/src/types/cli/recipe/index.d.ts +2 -1
  200. package/build/src/types/cli/recipe/miscellaneous/fix-markdown-tables.d.ts +4 -4
  201. package/build/src/types/cli/recipe/miscellaneous/remove-operating-system-files.d.ts +134 -0
  202. package/build/src/types/cli/recipe/package-json/normalize-tooling.d.ts +33 -17
  203. package/build/src/types/cli/scaffold/app/apple.d.ts +59 -0
  204. package/build/src/types/cli/scaffold/app/astro.d.ts +2 -3
  205. package/build/src/types/cli/scaffold/app/discord-bot.d.ts +1 -2
  206. package/build/src/types/cli/scaffold/app/expressjs.d.ts +2 -2
  207. package/build/src/types/cli/scaffold/app/nextjs.d.ts +2 -2
  208. package/build/src/types/cli/scaffold/app/vite.d.ts +2 -2
  209. package/build/src/types/cli/scaffold/docs/docusaurus.d.ts +4 -4
  210. package/build/src/types/cli/scaffold/package/homebridge.d.ts +1 -2
  211. package/build/src/types/cli/scaffold/tool/serverless.d.ts +51 -0
  212. package/build/src/types/cli/utility/changelog.d.ts +15 -3
  213. package/build/src/types/cli/utility/configure.d.ts +847 -78
  214. package/build/src/types/cli/utility/run-recipes.d.ts +2 -2
  215. package/build/src/types/cli/utility/run-workspaces.d.ts +57 -0
  216. package/build/src/types/lib/corepack.d.ts +19 -0
  217. package/build/src/types/lib/docker-packaging.d.ts +69 -0
  218. package/build/src/types/lib/env-managed-set.d.ts +2 -2
  219. package/build/src/types/lib/env-status.d.ts +2 -2
  220. package/build/src/types/lib/ignore-files.d.ts +86 -0
  221. package/build/src/types/lib/item.d.ts +25 -1
  222. package/build/src/types/lib/nova-config.d.ts +375 -102
  223. package/build/src/types/lib/package-scripts.d.ts +172 -0
  224. package/build/src/types/lib/regex.d.ts +7 -0
  225. package/build/src/types/lib/run-scripts.d.ts +10 -12
  226. package/build/src/types/lib/run-workspaces-cache.d.ts +259 -0
  227. package/build/src/types/lib/run-workspaces.d.ts +664 -0
  228. package/build/src/types/lib/scaffold-presentation.d.ts +6 -4
  229. package/build/src/types/lib/scaffold-versions.d.ts +30 -0
  230. package/build/src/types/lib/scaffold.d.ts +54 -37
  231. package/build/src/types/lib/transpile.d.ts +12 -4
  232. package/build/src/types/lib/type-check.d.ts +20 -3
  233. package/build/src/types/lib/type-declaration-engine.d.ts +54 -12
  234. package/build/src/types/lib/utility.d.ts +14 -0
  235. package/build/src/types/presets/eslint/nova-rules.d.ts +10 -0
  236. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-body.d.ts +2 -0
  237. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-hierarchy.d.ts +4 -0
  238. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-presence.d.ts +2 -0
  239. package/build/src/types/rules/eslint/jsdoc/require-jsdoc-returns.d.ts +71 -0
  240. package/build/src/types/rules/vitest/index.d.ts +56 -0
  241. package/build/src/types/rules/vitest/internal/active-vitest.d.ts +31 -0
  242. package/build/src/types/rules/vitest/internal/is-enabled.d.ts +12 -0
  243. package/build/src/types/rules/vitest/package-scripts/register.d.ts +41 -0
  244. package/build/src/types/rules/vitest/package-scripts/rules.d.ts +24 -0
  245. package/build/src/types/rules/vitest/type-declarations/rules.d.ts +8 -0
  246. package/build/src/types/shared.d.ts +589 -155
  247. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +8 -8
  248. package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +2 -2
  249. package/build/src/types/tests/cli/generate/must-haves/ignore-files.test.d.ts +46 -0
  250. package/build/src/types/tests/cli/index.test.d.ts +57 -24
  251. package/build/src/types/tests/cli/recipe/miscellaneous/remove-operating-system-files.test.d.ts +84 -0
  252. package/build/src/types/tests/cli/recipe/package-json/normalize-tooling.test.d.ts +36 -0
  253. package/build/src/types/tests/cli/scaffold/app/apple.test.d.ts +99 -0
  254. package/build/src/types/tests/cli/scaffold/starter/base.test.d.ts +9 -9
  255. package/build/src/types/tests/cli/scaffold/tool/serverless.test.d.ts +98 -0
  256. package/build/src/types/tests/cli/utility/changelog.test.d.ts +27 -27
  257. package/build/src/types/tests/cli/utility/configure.test.d.ts +237 -1
  258. package/build/src/types/tests/cli/utility/run-workspaces.test.d.ts +193 -0
  259. package/build/src/types/tests/cli/utility/type-check.test.d.ts +13 -0
  260. package/build/src/types/tests/lib/docker-packaging.test.d.ts +43 -0
  261. package/build/src/types/tests/lib/ignore-files.test.d.ts +69 -0
  262. package/build/src/types/tests/lib/item.test.d.ts +7 -0
  263. package/build/src/types/tests/lib/nova-config-ignore-files.test.d.ts +46 -0
  264. package/build/src/types/tests/lib/nova-config-run-workspaces-cache.test.d.ts +31 -0
  265. package/build/src/types/tests/lib/nova-config.test.d.ts +1 -29
  266. package/build/src/types/tests/lib/package-scripts.test.d.ts +32 -0
  267. package/build/src/types/tests/lib/utility.test.d.ts +23 -0
  268. package/build/src/types/tests/lib/workflow-templates.test.d.ts +0 -12
  269. package/build/src/types/tests/presets/eslint/nova-rules.test.d.ts +45 -0
  270. package/build/src/types/tests/rules/vitest/internal/active-vitest.test.d.ts +56 -0
  271. package/build/src/types/tests/rules/vitest/internal/is-enabled.test.d.ts +27 -0
  272. package/build/src/types/tests/rules/vitest/package-scripts.test.d.ts +6 -0
  273. package/build/src/types/tests/scaffold-output-contract.test.d.ts +37 -15
  274. package/build/src/types/tests/scaffold-version-catalog.test.d.ts +101 -0
  275. package/build/src/types/tests/scaffold-version-drift.test.d.ts +9 -3
  276. package/build/src/types/tests/since-version.test.d.ts +3 -1
  277. package/build/src/types/tests/tsconfig-presets.test.d.ts +6 -2
  278. package/build/src/types/tests/type-declarations.test.d.ts +198 -105
  279. package/build/templates/generators/must-haves/ignore-files/cloudflare-astro.assetsignore +5 -0
  280. package/build/templates/generators/must-haves/{gitignore → ignore-files}/gitignore +0 -5
  281. package/build/templates/scaffold/app/android/eslint.config.mts +1 -1
  282. package/build/templates/scaffold/app/android/package.json +10 -10
  283. package/build/templates/scaffold/app/android/vitest.config.mts +1 -0
  284. package/build/templates/scaffold/app/apple/package.json +13 -12
  285. package/build/templates/scaffold/app/apple/project.yml +5 -6
  286. package/build/templates/scaffold/app/apple/scripts/run-apple.mjs +114 -0
  287. package/build/templates/scaffold/app/astro/eslint.config.mts +1 -1
  288. package/build/templates/scaffold/app/astro/package.json +15 -15
  289. package/build/templates/scaffold/app/astro/tsconfig.tests.json +2 -1
  290. package/build/templates/scaffold/app/astro/vitest.config.mts +1 -0
  291. package/build/templates/scaffold/app/discord-bot/eslint.config.mts +1 -1
  292. package/build/templates/scaffold/app/discord-bot/package.json +14 -14
  293. package/build/templates/scaffold/app/express/eslint.config.mts +1 -1
  294. package/build/templates/scaffold/app/express/package.json +15 -15
  295. package/build/templates/scaffold/app/nextjs/eslint.config.mts +1 -1
  296. package/build/templates/scaffold/app/nextjs/package.json +17 -17
  297. package/build/templates/scaffold/app/nextjs/tsconfig.tests.json +2 -1
  298. package/build/templates/scaffold/app/nextjs/vitest.config.mts +1 -0
  299. package/build/templates/scaffold/app/vite/eslint.config.mts +1 -1
  300. package/build/templates/scaffold/app/vite/package.json +13 -13
  301. package/build/templates/scaffold/app/vite/vitest.config.mts +1 -0
  302. package/build/templates/scaffold/docs/docusaurus/eslint.config.mts +1 -1
  303. package/build/templates/scaffold/docs/docusaurus/package.json +22 -22
  304. package/build/templates/scaffold/package/github-action/eslint.config.mts +1 -1
  305. package/build/templates/scaffold/package/github-action/package.json +15 -16
  306. package/build/templates/scaffold/package/homebridge/bin/repl.mjs +33 -0
  307. package/build/templates/scaffold/package/homebridge/bin/test-api.mjs +33 -0
  308. package/build/templates/scaffold/package/homebridge/eslint.config.mts +1 -1
  309. package/build/templates/scaffold/package/homebridge/package.json +23 -14
  310. package/build/templates/scaffold/package/homebridge/src/cli/presentation.ts +65 -0
  311. package/build/templates/scaffold/package/homebridge/src/cli/repl.ts +51 -0
  312. package/build/templates/scaffold/package/homebridge/src/cli/test-api.ts +134 -0
  313. package/build/templates/scaffold/package/homebridge/src/types/cli/presentation.d.ts +21 -0
  314. package/build/templates/scaffold/package/homebridge/src/types/cli/repl.d.ts +12 -0
  315. package/build/templates/scaffold/package/homebridge/src/types/cli/test-api.d.ts +38 -0
  316. package/build/templates/scaffold/package/homebridge/tsconfig.tests.json +2 -1
  317. package/build/templates/scaffold/package/homebridge/vitest.config.mts +1 -0
  318. package/build/templates/scaffold/package/pfsense/eslint.config.mts +1 -1
  319. package/build/templates/scaffold/package/pfsense/package.json +11 -11
  320. package/build/templates/scaffold/package/pfsense/vitest.config.mts +1 -0
  321. package/build/templates/scaffold/starter/base/eslint.config.mts +1 -1
  322. package/build/templates/scaffold/starter/base/tests/project.test.ts +8 -0
  323. package/build/templates/scaffold/{app/cloudflare-workers → tool/serverless}/vitest.config.mts +3 -2
  324. package/build/templates/scaffold-options/app/android-native/app/build.gradle.kts +3 -3
  325. package/build/templates/scaffold-options/app/android-native/gradle/libs.versions.toml +10 -10
  326. package/build/templates/scaffold-options/app/android-native/gradle/wrapper/gradle-wrapper.properties +2 -2
  327. package/build/templates/scaffold-options/app/android-native/settings.gradle.kts +1 -1
  328. package/build/templates/{generators → scaffold-options}/docker-image/astro-node/Dockerfile +2 -2
  329. package/build/templates/{generators → scaffold-options}/docker-image/container-native/Dockerfile +1 -1
  330. package/build/templates/{generators → scaffold-options}/docker-image/nextjs-standalone/Dockerfile +2 -2
  331. package/build/templates/{generators → scaffold-options}/docker-image/node/Dockerfile +2 -2
  332. package/build/templates/{generators → scaffold-options}/docker-image/static-site/Dockerfile +2 -2
  333. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/eslint.config.mts +66 -0
  334. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +67 -0
  335. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/types/worker/index.d.ts +19 -0
  336. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/types/worker/index.test.d.ts +6 -0
  337. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/worker/index.test.ts +23 -0
  338. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/worker/index.ts +28 -0
  339. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/tsconfig.cli.json +26 -0
  340. package/build/templates/{scaffold/app/docker-image → scaffold-options/tool/serverless/cloudflare-workers}/tsconfig.tests.json +2 -0
  341. package/build/templates/{scaffold/app → scaffold-options/tool/serverless}/cloudflare-workers/tsconfig.worker.json +10 -3
  342. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/wrangler.build.toml +3 -0
  343. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/wrangler.toml +3 -0
  344. package/build/templates/scaffold-options/tool/serverless/vercel-functions/api/index.test.ts +23 -0
  345. package/build/templates/scaffold-options/tool/serverless/vercel-functions/api/index.ts +20 -0
  346. package/build/templates/{scaffold/package/node-cli → scaffold-options/tool/serverless/vercel-functions}/eslint.config.mts +5 -3
  347. package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +66 -0
  348. package/build/templates/scaffold-options/tool/serverless/vercel-functions/src/types/api/index.d.ts +8 -0
  349. package/build/templates/scaffold-options/tool/serverless/vercel-functions/src/types/api/index.test.d.ts +6 -0
  350. package/build/templates/scaffold-options/tool/serverless/vercel-functions/tsconfig.cli.json +26 -0
  351. package/build/templates/{scaffold/package/node-cli/tsconfig.source.json → scaffold-options/tool/serverless/vercel-functions/tsconfig.functions.json} +5 -3
  352. package/build/templates/{scaffold/package/node-cli → scaffold-options/tool/serverless/vercel-functions}/tsconfig.tests.json +1 -0
  353. package/build/templates/scaffold-options/tool/serverless/vercel-functions/vercel.json +3 -0
  354. package/package.json +5 -6
  355. package/build/src/cli/generate/docker-image/index.d.ts +0 -9
  356. package/build/src/cli/generate/docker-image/index.d.ts.map +0 -1
  357. package/build/src/cli/generate/docker-image/index.js.map +0 -1
  358. package/build/src/cli/generate/must-haves/gitignore.d.ts +0 -5
  359. package/build/src/cli/generate/must-haves/gitignore.d.ts.map +0 -1
  360. package/build/src/cli/generate/must-haves/gitignore.js +0 -61
  361. package/build/src/cli/generate/must-haves/gitignore.js.map +0 -1
  362. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts +0 -5
  363. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts.map +0 -1
  364. package/build/src/cli/scaffold/app/cloudflare-workers.js +0 -14
  365. package/build/src/cli/scaffold/app/cloudflare-workers.js.map +0 -1
  366. package/build/src/cli/scaffold/app/docker-image.d.ts +0 -6
  367. package/build/src/cli/scaffold/app/docker-image.d.ts.map +0 -1
  368. package/build/src/cli/scaffold/app/docker-image.js +0 -93
  369. package/build/src/cli/scaffold/app/docker-image.js.map +0 -1
  370. package/build/src/cli/scaffold/package/node-cli.d.ts +0 -5
  371. package/build/src/cli/scaffold/package/node-cli.d.ts.map +0 -1
  372. package/build/src/cli/scaffold/package/node-cli.js +0 -14
  373. package/build/src/cli/scaffold/package/node-cli.js.map +0 -1
  374. package/build/src/rules/eslint/nova-rules.d.ts +0 -4
  375. package/build/src/rules/eslint/nova-rules.d.ts.map +0 -1
  376. package/build/src/rules/eslint/nova-rules.js.map +0 -1
  377. package/build/src/rules/vitest/active-vitest.d.ts +0 -5
  378. package/build/src/rules/vitest/active-vitest.d.ts.map +0 -1
  379. package/build/src/rules/vitest/active-vitest.js.map +0 -1
  380. package/build/src/rules/vitest/enable.d.ts +0 -3
  381. package/build/src/rules/vitest/enable.d.ts.map +0 -1
  382. package/build/src/rules/vitest/enable.js.map +0 -1
  383. package/build/src/types/cli/generate/docker-image/index.d.ts +0 -105
  384. package/build/src/types/cli/generate/must-haves/gitignore.d.ts +0 -48
  385. package/build/src/types/cli/scaffold/app/cloudflare-workers.d.ts +0 -27
  386. package/build/src/types/cli/scaffold/app/docker-image.d.ts +0 -47
  387. package/build/src/types/cli/scaffold/package/node-cli.d.ts +0 -22
  388. package/build/src/types/rules/eslint/nova-rules.d.ts +0 -10
  389. package/build/src/types/rules/vitest/active-vitest.d.ts +0 -31
  390. package/build/src/types/rules/vitest/enable.d.ts +0 -12
  391. package/build/src/types/tests/cli/generate/docker-image.test.d.ts +0 -43
  392. package/build/src/types/tests/cli/generate/must-haves/gitignore.test.d.ts +0 -27
  393. package/build/src/types/tests/cli/scaffold/app/cloudflare-workers.test.d.ts +0 -85
  394. package/build/src/types/tests/rules/eslint/nova-rules.test.d.ts +0 -45
  395. package/build/src/types/tests/rules/vitest/active-vitest.test.d.ts +0 -56
  396. package/build/src/types/tests/rules/vitest/enable.test.d.ts +0 -27
  397. package/build/templates/generators/github/workflows/check-sponsor-gated-issues/base.yml +0 -54
  398. package/build/templates/generators/github/workflows/check-sponsor-gated-issues/triggers/issue-comment.yml +0 -5
  399. package/build/templates/generators/github/workflows/check-sponsor-gated-issues/triggers/issues.yml +0 -5
  400. package/build/templates/generators/github/workflows/lock-inactive-issues/base.yml +0 -45
  401. package/build/templates/generators/github/workflows/lock-inactive-issues/triggers/schedule-daily.yml +0 -5
  402. package/build/templates/generators/github/workflows/lock-inactive-issues/triggers/schedule-monthly.yml +0 -5
  403. package/build/templates/generators/github/workflows/lock-inactive-issues/triggers/schedule-weekly.yml +0 -5
  404. package/build/templates/generators/github/workflows/publish/base.yml +0 -61
  405. package/build/templates/generators/github/workflows/publish/targets/cloudflare-pages-docusaurus.yml +0 -29
  406. package/build/templates/generators/github/workflows/publish/targets/cloudflare-workers.yml +0 -36
  407. package/build/templates/generators/github/workflows/publish/targets/docker-hub.yml +0 -48
  408. package/build/templates/generators/github/workflows/publish/targets/ghcr.yml +0 -48
  409. package/build/templates/generators/github/workflows/publish/targets/github-action.yml +0 -122
  410. package/build/templates/generators/github/workflows/publish/targets/github-packages.yml +0 -85
  411. package/build/templates/generators/github/workflows/publish/targets/github-pages-docusaurus.yml +0 -44
  412. package/build/templates/generators/github/workflows/publish/targets/npm.yml +0 -61
  413. package/build/templates/generators/github/workflows/publish/targets/vercel-nextjs.yml +0 -45
  414. package/build/templates/generators/github/workflows/publish/triggers/release.yml +0 -5
  415. package/build/templates/generators/github/workflows/publish/triggers/workflow-run-any.yml +0 -7
  416. package/build/templates/generators/github/workflows/publish/triggers/workflow-run-failure.yml +0 -8
  417. package/build/templates/generators/github/workflows/publish/triggers/workflow-run-success.yml +0 -8
  418. package/build/templates/scaffold/app/android/tests/project.test.ts +0 -24
  419. package/build/templates/scaffold/app/astro/tests/project.test.ts +0 -24
  420. package/build/templates/scaffold/app/cloudflare-workers/eslint.config.mts +0 -42
  421. package/build/templates/scaffold/app/cloudflare-workers/package.json +0 -37
  422. package/build/templates/scaffold/app/cloudflare-workers/src/index.ts +0 -30
  423. package/build/templates/scaffold/app/cloudflare-workers/src/types/index.d.ts +0 -19
  424. package/build/templates/scaffold/app/cloudflare-workers/tests/project.test.ts +0 -24
  425. package/build/templates/scaffold/app/cloudflare-workers/tsconfig.tests.json +0 -20
  426. package/build/templates/scaffold/app/cloudflare-workers/wrangler.toml +0 -3
  427. package/build/templates/scaffold/app/discord-bot/tests/project.test.ts +0 -24
  428. package/build/templates/scaffold/app/docker-image/eslint.config.mts +0 -41
  429. package/build/templates/scaffold/app/docker-image/package.json +0 -33
  430. package/build/templates/scaffold/app/docker-image/tests/project.test.ts +0 -24
  431. package/build/templates/scaffold/app/docker-image/vitest.config.mts +0 -15
  432. package/build/templates/scaffold/app/express/tests/project.test.ts +0 -24
  433. package/build/templates/scaffold/app/nextjs/tests/project.test.ts +0 -24
  434. package/build/templates/scaffold/app/vite/tests/project.test.ts +0 -24
  435. package/build/templates/scaffold/package/homebridge/tests/project.test.ts +0 -24
  436. package/build/templates/scaffold/package/node-cli/package.json +0 -47
  437. package/build/templates/scaffold/package/node-cli/tsconfig.config.json +0 -17
  438. package/build/templates/scaffold/package/node-cli/vitest.config.mts +0 -18
  439. package/build/templates/scaffold/package/pfsense/tests/project.test.ts +0 -56
  440. package/build/templates/scaffold/package/pfsense/tests/types/project.test.d.ts +0 -6
  441. /package/build/src/rules/vitest/{active-vitest.js → internal/active-vitest.js} +0 -0
  442. /package/build/templates/{generators → scaffold-options}/docker-image/astro-node/compose.yml +0 -0
  443. /package/build/templates/{generators → scaffold-options}/docker-image/background-service/compose.yml +0 -0
  444. /package/build/templates/{generators → scaffold-options}/docker-image/container-native/compose.yml +0 -0
  445. /package/build/templates/{generators → scaffold-options}/docker-image/http-service/compose.yml +0 -0
  446. /package/build/templates/{generators → scaffold-options}/docker-image/nextjs-standalone/compose.yml +0 -0
  447. /package/build/templates/{generators → scaffold-options}/docker-image/static-site/compose.yml +0 -0
  448. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/bin/cli.mjs +0 -0
  449. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/src/index.ts +0 -0
  450. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/src/program.ts +0 -0
  451. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/src/status.test.ts +0 -0
  452. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/src/status.ts +0 -0
  453. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/src/types/program.d.ts +0 -0
  454. /package/build/templates/{scaffold/package/node-cli → scaffold-options/package/node-cli-core}/src/types/status.d.ts +0 -0
  455. /package/build/templates/{scaffold/app → scaffold-options/tool/serverless}/cloudflare-workers/tsconfig.config.json +0 -0
  456. /package/build/templates/{scaffold/app/docker-image → scaffold-options/tool/serverless/vercel-functions}/tsconfig.config.json +0 -0
@@ -0,0 +1,33 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { existsSync } from 'node:fs';
4
+ import { dirname, resolve } from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+
7
+ /**
8
+ * Repl - Root.
9
+ *
10
+ * Resolves the generated plugin root from this stable launcher file.
11
+ * Installed and workspace-linked packages therefore share one path strategy.
12
+ *
13
+ * @since 0.0.0
14
+ */
15
+ const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
16
+
17
+ /**
18
+ * Repl - Entry.
19
+ *
20
+ * Resolves the compiled REPL entry point loaded by this launcher.
21
+ * The launcher stays installed even before build output exists.
22
+ *
23
+ * @since 0.0.0
24
+ */
25
+ const entry = resolve(root, 'build', 'cli', 'repl.js');
26
+
27
+ if (existsSync(entry) === false) {
28
+ process.stderr.write('[__WORKSPACE_PACKAGE_NAME__] has not been built yet. Run "npm run build" first.\n');
29
+
30
+ throw new Error('REPL build output not found');
31
+ }
32
+
33
+ await import(entry);
@@ -0,0 +1,33 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { existsSync } from 'node:fs';
4
+ import { dirname, resolve } from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
6
+
7
+ /**
8
+ * Test API - Root.
9
+ *
10
+ * Resolves the generated plugin root from this stable launcher file.
11
+ * Installed and workspace-linked packages therefore share one path strategy.
12
+ *
13
+ * @since 0.0.0
14
+ */
15
+ const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
16
+
17
+ /**
18
+ * Test API - Entry.
19
+ *
20
+ * Resolves the compiled API-test entry point loaded by this launcher.
21
+ * The launcher stays installed even before build output exists.
22
+ *
23
+ * @since 0.0.0
24
+ */
25
+ const entry = resolve(root, 'build', 'cli', 'test-api.js');
26
+
27
+ if (existsSync(entry) === false) {
28
+ process.stderr.write('[__WORKSPACE_PACKAGE_NAME__] has not been built yet. Run "npm run build" first.\n');
29
+
30
+ throw new Error('API test build output not found');
31
+ }
32
+
33
+ await import(entry);
@@ -3,9 +3,9 @@ import {
3
3
  dxIgnore,
4
4
  langJavascript,
5
5
  langTypescript,
6
+ novaRules,
6
7
  runtimeNode,
7
8
  } from '@cbnventures/nova/presets/eslint';
8
- import { novaRules } from '@cbnventures/nova/rules/eslint';
9
9
 
10
10
  import customUiPreset from './config/eslint-custom-ui.js';
11
11
 
@@ -10,38 +10,47 @@
10
10
  "main": "./build/index.js",
11
11
  "type": "module",
12
12
  "files": [
13
+ "bin",
13
14
  "build",
14
15
  "config.schema.json"
15
16
  ],
17
+ "bin": {
18
+ "[__WORKSPACE_PACKAGE_NAME__]-repl": "./bin/repl.mjs",
19
+ "[__WORKSPACE_PACKAGE_NAME__]-test-api": "./bin/test-api.mjs"
20
+ },
16
21
  "scripts": {
17
- "dev": "nova utility run-scripts --parallel --node-env development 'dev:*'",
22
+ "dev": "nova utility run-scripts --parallel --node-env development \"dev:*\"",
18
23
  "dev:watch": "nova utility transpile --project tsconfig.source.json --watch",
19
- "check": "nova utility run-scripts --sequential 'check:*'",
24
+ "prod": "nova utility run-scripts --sequential --node-env production \"prod:*\"",
25
+ "prod:homebridge": "npm run build && homebridge --debug --keep-orphans --plugin-path $(pwd)",
26
+ "check": "nova utility run-scripts --sequential \"check:*\"",
20
27
  "check:lint": "eslint ./ --max-warnings=0",
21
28
  "check:types-source": "nova utility type-check --project tsconfig.source.json",
22
29
  "check:types-config": "nova utility type-check --project tsconfig.config.json",
23
30
  "check:types-tests": "nova utility type-check --project tsconfig.tests.json",
24
31
  "check:test": "vitest run",
25
- "build": "nova utility run-scripts --sequential --node-env production 'build:*'",
32
+ "build": "nova utility run-scripts --sequential --node-env production \"build:*\"",
26
33
  "build:reset": "shx rm -rf ./build",
27
34
  "build:transpile": "nova utility transpile --project tsconfig.source.json",
28
- "clean": "nova utility run-scripts --parallel 'clean:*'",
35
+ "build:permissions": "shx chmod +x ./bin/repl.mjs ./bin/test-api.mjs ./build/cli/repl.js ./build/cli/test-api.js",
36
+ "clean": "nova utility run-scripts --parallel \"clean:*\"",
29
37
  "clean:build": "shx rm -rf ./build",
30
- "start": "homebridge --debug --keep-orphans --plugin-path $(pwd)"
38
+ "repl": "node ./build/cli/repl.js",
39
+ "test-api": "node ./build/cli/test-api.js"
31
40
  },
32
41
  "engines": {
33
- "homebridge": "^1.11.0 || ^2.0.0",
34
- "node": "^22 || ^24"
42
+ "homebridge": "[__SCAFFOLD_VERSION_HOMEBRIDGE_PEER__]",
43
+ "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
35
44
  },
36
45
  "dependencies": {
37
- "@cbnventures/nova": "0.31.1"
46
+ "@cbnventures/nova": "0.32.0"
38
47
  },
39
48
  "devDependencies": {
40
- "@types/node": "24.9.1",
41
- "eslint": "9.39.5",
42
- "homebridge": "2.4.0",
43
- "shx": "0.4.0",
44
- "typescript": "6.0.3",
45
- "vitest": "4.1.11"
49
+ "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
50
+ "eslint": "[__SCAFFOLD_VERSION_ESLINT__]",
51
+ "homebridge": "[__SCAFFOLD_VERSION_HOMEBRIDGE__]",
52
+ "shx": "[__SCAFFOLD_VERSION_SHX__]",
53
+ "typescript": "[__SCAFFOLD_VERSION_TYPESCRIPT__]",
54
+ "vitest": "[__SCAFFOLD_VERSION_VITEST__]"
46
55
  }
47
56
  }
@@ -0,0 +1,65 @@
1
+ import { CLIHeader } from '@cbnventures/nova/toolkit';
2
+
3
+ import packageJson from '../../package.json' with { type: 'json' };
4
+
5
+ import type {
6
+ Cli_Presentation_RenderHeader_Description,
7
+ Cli_Presentation_RenderHeader_Returns,
8
+ Cli_Presentation_WriteHelp_Command,
9
+ Cli_Presentation_WriteHelp_Description,
10
+ Cli_Presentation_WriteHelp_Options,
11
+ Cli_Presentation_WriteHelp_Returns,
12
+ } from '../types/cli/presentation.d.ts';
13
+
14
+ /**
15
+ * Presentation - Render Header.
16
+ *
17
+ * Renders fixed-width package metadata for both generated utility commands.
18
+ * Keeping the presentation shared prevents the two executables from drifting.
19
+ *
20
+ * @param {Cli_Presentation_RenderHeader_Description} description - Description.
21
+ *
22
+ * @returns {Cli_Presentation_RenderHeader_Returns}
23
+ *
24
+ * @since 0.0.0
25
+ */
26
+ export function renderHeader(description: Cli_Presentation_RenderHeader_Description): Cli_Presentation_RenderHeader_Returns {
27
+ return CLIHeader.render(
28
+ [
29
+ `${packageJson['name']} v${packageJson['version']}`,
30
+ description,
31
+ ],
32
+ {
33
+ align: 'center',
34
+ marginBottom: 1,
35
+ marginTop: 0,
36
+ paddingX: 1,
37
+ paddingY: 0,
38
+ style: 'round',
39
+ width: 50,
40
+ },
41
+ );
42
+ }
43
+
44
+ /**
45
+ * Presentation - Write Help.
46
+ *
47
+ * Prints the shared header followed by one concise command-specific help page.
48
+ * Options are supplied as complete lines so each utility owns its public flags.
49
+ *
50
+ * @param {Cli_Presentation_WriteHelp_Command} command - Command.
51
+ * @param {Cli_Presentation_WriteHelp_Description} description - Description.
52
+ * @param {Cli_Presentation_WriteHelp_Options} options - Options.
53
+ *
54
+ * @returns {Cli_Presentation_WriteHelp_Returns}
55
+ *
56
+ * @since 0.0.0
57
+ */
58
+ export function writeHelp(command: Cli_Presentation_WriteHelp_Command, description: Cli_Presentation_WriteHelp_Description, options: Cli_Presentation_WriteHelp_Options): Cli_Presentation_WriteHelp_Returns {
59
+ process.stdout.write(`${renderHeader(description)}\n`);
60
+ process.stdout.write(`Usage: ${command} [options]\n\n`);
61
+ process.stdout.write('Options:\n');
62
+ process.stdout.write(`${options.map((option) => ` ${option}`).join('\n')}\n`);
63
+
64
+ return;
65
+ }
@@ -0,0 +1,51 @@
1
+ import { start } from 'node:repl';
2
+
3
+ import { [__WORKSPACE_IDENTIFIER__]Platform } from '../platform.js';
4
+ import { renderHeader, writeHelp } from './presentation.js';
5
+
6
+ import type {
7
+ Cli_Repl_Arguments,
8
+ Cli_Repl_HasHelpFlag,
9
+ Cli_Repl_Server,
10
+ } from '../types/cli/repl.d.ts';
11
+
12
+ /**
13
+ * Repl - Command Arguments.
14
+ *
15
+ * Captures user arguments without the Node.js executable and launcher paths.
16
+ * The resulting list controls help or interactive execution.
17
+ *
18
+ * @since 0.0.0
19
+ */
20
+ const commandArguments: Cli_Repl_Arguments = process.argv.slice(2);
21
+
22
+ /**
23
+ * Repl - Has Help Flag.
24
+ *
25
+ * Determines whether the command should print help instead of opening a shell.
26
+ * Both conventional short and long flags are supported.
27
+ *
28
+ * @since 0.0.0
29
+ */
30
+ const hasHelpFlag: Cli_Repl_HasHelpFlag = commandArguments.includes('-h') || commandArguments.includes('--help');
31
+
32
+ if (hasHelpFlag === true) {
33
+ writeHelp('[__WORKSPACE_PACKAGE_NAME__]-repl', 'Interactive plugin development shell', ['-h, --help Display the help menu']);
34
+ } else {
35
+ process.stdout.write(`${renderHeader('Interactive plugin development shell')}\n`);
36
+ process.stdout.write('Available values: Platform, platformName, pluginName\n\n');
37
+
38
+ /**
39
+ * Repl - Server.
40
+ *
41
+ * Holds the interactive Node.js shell and its generated plugin context.
42
+ * Consumers can add provider clients or fixtures beside these starter values.
43
+ *
44
+ * @since 0.0.0
45
+ */
46
+ const replServer: Cli_Repl_Server = start({ prompt: '[__WORKSPACE_NAME__]> ' });
47
+
48
+ Reflect.set(replServer.context, 'Platform', [__WORKSPACE_IDENTIFIER__]Platform);
49
+ Reflect.set(replServer.context, 'platformName', '[__WORKSPACE_IDENTIFIER__]');
50
+ Reflect.set(replServer.context, 'pluginName', '[__WORKSPACE_PACKAGE_NAME__]');
51
+ }
@@ -0,0 +1,134 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { homedir } from 'node:os';
3
+ import { join, resolve } from 'node:path';
4
+
5
+ import { Logger } from '@cbnventures/nova/toolkit';
6
+
7
+ import { renderHeader, writeHelp } from './presentation.js';
8
+
9
+ import type {
10
+ Cli_TestApi_Arguments,
11
+ Cli_TestApi_ConfigFlagIndex,
12
+ Cli_TestApi_ConfigPath,
13
+ Cli_TestApi_ConfigRaw,
14
+ Cli_TestApi_ConfigValue,
15
+ Cli_TestApi_HasHelpFlag,
16
+ Cli_TestApi_IsMatchingPlatformConfig_TypeGuard,
17
+ Cli_TestApi_IsMatchingPlatformConfig_Value,
18
+ Cli_TestApi_IsPlatformConfig_TypeGuard,
19
+ Cli_TestApi_IsPlatformConfig_Value,
20
+ Cli_TestApi_PlatformConfig,
21
+ Cli_TestApi_Platforms,
22
+ } from '../types/cli/test-api.d.ts';
23
+
24
+ /**
25
+ * Test API - Is Platform Config.
26
+ *
27
+ * Narrows one Homebridge platform entry before reading its platform identifier.
28
+ * Arrays and null are rejected even though JavaScript reports them as objects.
29
+ *
30
+ * @param {Cli_TestApi_IsPlatformConfig_Value} value - Value.
31
+ *
32
+ * @returns {Cli_TestApi_IsPlatformConfig_TypeGuard}
33
+ *
34
+ * @since 0.0.0
35
+ */
36
+ function isPlatformConfig(value: Cli_TestApi_IsPlatformConfig_Value): value is Cli_TestApi_IsPlatformConfig_TypeGuard {
37
+ return (
38
+ typeof value === 'object'
39
+ && value !== null
40
+ && Array.isArray(value) === false
41
+ );
42
+ }
43
+
44
+ /**
45
+ * Test API - Is Matching Platform Config.
46
+ *
47
+ * Narrows a Homebridge platform entry to the generated platform identifier.
48
+ * This keeps the subsequent config lookup both explicit and type-safe.
49
+ *
50
+ * @param {Cli_TestApi_IsMatchingPlatformConfig_Value} value - Value.
51
+ *
52
+ * @returns {Cli_TestApi_IsMatchingPlatformConfig_TypeGuard}
53
+ *
54
+ * @since 0.0.0
55
+ */
56
+ function isMatchingPlatformConfig(value: Cli_TestApi_IsMatchingPlatformConfig_Value): value is Cli_TestApi_IsMatchingPlatformConfig_TypeGuard {
57
+ return (
58
+ isPlatformConfig(value) === true
59
+ && value['platform'] === '[__WORKSPACE_IDENTIFIER__]'
60
+ );
61
+ }
62
+
63
+ /**
64
+ * Test API - Command Arguments.
65
+ *
66
+ * Captures user arguments without the Node.js executable and launcher paths.
67
+ * The resulting list controls help and explicit config-file selection.
68
+ *
69
+ * @since 0.0.0
70
+ */
71
+ const commandArguments: Cli_TestApi_Arguments = process.argv.slice(2);
72
+
73
+ /**
74
+ * Test API - Has Help Flag.
75
+ *
76
+ * Determines whether the command should print help instead of reading config.
77
+ * Both conventional short and long flags are supported.
78
+ *
79
+ * @since 0.0.0
80
+ */
81
+ const hasHelpFlag: Cli_TestApi_HasHelpFlag = commandArguments.includes('-h') || commandArguments.includes('--help');
82
+
83
+ if (hasHelpFlag === true) {
84
+ writeHelp('[__WORKSPACE_PACKAGE_NAME__]-test-api', 'Homebridge API smoke-test starter', [
85
+ '--config <path> Read a specific Homebridge config.json',
86
+ '-h, --help Display the help menu',
87
+ ]);
88
+ } else {
89
+ process.stdout.write(`${renderHeader('Homebridge API smoke-test starter')}\n`);
90
+
91
+ /**
92
+ * Test API - Config Flag Index.
93
+ *
94
+ * Locates an explicit Homebridge config path when one was supplied.
95
+ * Missing flags fall back to the current user's standard Homebridge config.
96
+ *
97
+ * @since 0.0.0
98
+ */
99
+ const configFlagIndex: Cli_TestApi_ConfigFlagIndex = commandArguments.indexOf('--config');
100
+
101
+ /**
102
+ * Test API - Config Path.
103
+ *
104
+ * Holds the explicit or conventional config file resolved for this smoke test.
105
+ * The path is reported verbatim after the generated platform is found.
106
+ *
107
+ * @since 0.0.0
108
+ */
109
+ const configPath: Cli_TestApi_ConfigPath = (configFlagIndex === -1) ? join(homedir(), '.homebridge', 'config.json') : resolve(commandArguments[configFlagIndex + 1] ?? '');
110
+
111
+ if (configFlagIndex !== -1 && commandArguments[configFlagIndex + 1] === undefined) {
112
+ Logger.error('The --config option requires a file path.');
113
+
114
+ process.exitCode = 1;
115
+ } else {
116
+ try {
117
+ const configRaw: Cli_TestApi_ConfigRaw = await readFile(configPath, 'utf-8');
118
+ const configValue: Cli_TestApi_ConfigValue = JSON.parse(configRaw);
119
+ const platforms: Cli_TestApi_Platforms = (isPlatformConfig(configValue) === true) ? configValue['platforms'] : undefined;
120
+ const platformConfig: Cli_TestApi_PlatformConfig = (Array.isArray(platforms) === true) ? platforms.find(isMatchingPlatformConfig) : undefined;
121
+
122
+ if (platformConfig === undefined) {
123
+ throw new Error('The config does not contain the "[__WORKSPACE_IDENTIFIER__]" platform.');
124
+ }
125
+
126
+ Logger.info(`Validated the "[__WORKSPACE_IDENTIFIER__]" platform in "${configPath}".`);
127
+ Logger.info('Add provider-specific requests to src/cli/test-api.ts when the plugin gains an external API.');
128
+ } catch (error) {
129
+ Logger.error((error instanceof Error) ? error.message : String(error));
130
+
131
+ process.exitCode = 1;
132
+ }
133
+ }
134
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Presentation.
3
+ *
4
+ * @since 0.0.0
5
+ */
6
+ export type Cli_Presentation_RenderHeader_Description = string;
7
+
8
+ export type Cli_Presentation_RenderHeader_Returns = string;
9
+
10
+ /**
11
+ * Presentation.
12
+ *
13
+ * @since 0.0.0
14
+ */
15
+ export type Cli_Presentation_WriteHelp_Command = string;
16
+
17
+ export type Cli_Presentation_WriteHelp_Description = string;
18
+
19
+ export type Cli_Presentation_WriteHelp_Options = string[];
20
+
21
+ export type Cli_Presentation_WriteHelp_Returns = void;
@@ -0,0 +1,12 @@
1
+ import type { start } from 'node:repl';
2
+
3
+ /**
4
+ * Repl.
5
+ *
6
+ * @since 0.0.0
7
+ */
8
+ export type Cli_Repl_Arguments = string[];
9
+
10
+ export type Cli_Repl_HasHelpFlag = boolean;
11
+
12
+ export type Cli_Repl_Server = ReturnType<typeof start>;
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Test API.
3
+ *
4
+ * @since 0.0.0
5
+ */
6
+ export type Cli_TestApi_IsPlatformConfig_Value = unknown;
7
+
8
+ export type Cli_TestApi_IsPlatformConfig_TypeGuard = Record<string, unknown>;
9
+
10
+ /**
11
+ * Test API.
12
+ *
13
+ * @since 0.0.0
14
+ */
15
+ export type Cli_TestApi_IsMatchingPlatformConfig_Value = unknown;
16
+
17
+ export type Cli_TestApi_IsMatchingPlatformConfig_TypeGuard = Record<string, unknown>;
18
+
19
+ /**
20
+ * Test API.
21
+ *
22
+ * @since 0.0.0
23
+ */
24
+ export type Cli_TestApi_Arguments = string[];
25
+
26
+ export type Cli_TestApi_ConfigFlagIndex = number;
27
+
28
+ export type Cli_TestApi_ConfigPath = string;
29
+
30
+ export type Cli_TestApi_ConfigRaw = string;
31
+
32
+ export type Cli_TestApi_ConfigValue = unknown;
33
+
34
+ export type Cli_TestApi_HasHelpFlag = boolean;
35
+
36
+ export type Cli_TestApi_Platforms = unknown;
37
+
38
+ export type Cli_TestApi_PlatformConfig = Record<string, unknown> | undefined;
@@ -13,6 +13,7 @@
13
13
  },
14
14
  "include": [
15
15
  "./src/**/*.test.ts",
16
- "./tests/**/*.test.ts"
16
+ "./tests/**/*.test.ts",
17
+ "./vitest.config.mts"
17
18
  ]
18
19
  }
@@ -14,5 +14,6 @@ export default defineConfig({
14
14
  'src/**/*.test.ts',
15
15
  'tests/**/*.test.ts',
16
16
  ],
17
+ passWithNoTests: true,
17
18
  },
18
19
  });
@@ -3,9 +3,9 @@ import {
3
3
  dxIgnore,
4
4
  langJavascript,
5
5
  langTypescript,
6
+ novaRules,
6
7
  runtimeNode,
7
8
  } from '@cbnventures/nova/presets/eslint';
8
- import { novaRules } from '@cbnventures/nova/rules/eslint';
9
9
 
10
10
  /**
11
11
  * ESLint Configuration.
@@ -11,31 +11,31 @@
11
11
  "build"
12
12
  ],
13
13
  "scripts": {
14
- "check": "nova utility run-scripts --sequential 'check:*'",
14
+ "check": "nova utility run-scripts --sequential \"check:*\"",
15
15
  "check:lint-scripts": "eslint ./ --max-warnings=0",
16
16
  "check:types-scripts": "nova utility type-check --project tsconfig.scripts.json",
17
17
  "check:types-tests": "nova utility type-check --project tsconfig.tests.json",
18
18
  "check:test-scripts": "vitest run",
19
19
  "check:package": "node ./scripts/check-package.mjs",
20
- "build": "nova utility run-scripts --sequential --node-env production 'build:*'",
20
+ "build": "nova utility run-scripts --sequential --node-env production \"build:*\"",
21
21
  "build:reset": "shx rm -rf ./build",
22
22
  "build:stage": "node ./scripts/stage-package.mjs",
23
- "deploy": "nova utility run-scripts --sequential --node-env production 'deploy:*'",
23
+ "deploy": "nova utility run-scripts --sequential --node-env production \"deploy:*\"",
24
24
  "deploy:package": "sh ./scripts/build-package.sh",
25
- "clean": "nova utility run-scripts --parallel 'clean:*'",
25
+ "clean": "nova utility run-scripts --parallel \"clean:*\"",
26
26
  "clean:build": "shx rm -rf ./build"
27
27
  },
28
28
  "engines": {
29
- "node": ">=22.3 <23 || ^24"
29
+ "node": "[__SCAFFOLD_VERSION_NODE_ENGINE_PFSENSE__]"
30
30
  },
31
31
  "dependencies": {
32
- "@cbnventures/nova": "0.31.1"
32
+ "@cbnventures/nova": "0.32.0"
33
33
  },
34
34
  "devDependencies": {
35
- "@types/node": "24.9.1",
36
- "eslint": "9.39.5",
37
- "shx": "0.4.0",
38
- "typescript": "6.0.3",
39
- "vitest": "4.1.11"
35
+ "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
36
+ "eslint": "[__SCAFFOLD_VERSION_ESLINT__]",
37
+ "shx": "[__SCAFFOLD_VERSION_SHX__]",
38
+ "typescript": "[__SCAFFOLD_VERSION_TYPESCRIPT__]",
39
+ "vitest": "[__SCAFFOLD_VERSION_VITEST__]"
40
40
  }
41
41
  }
@@ -11,5 +11,6 @@ import { defineConfig } from 'vitest/config';
11
11
  export default defineConfig({
12
12
  test: {
13
13
  include: ['tests/**/*.test.ts'],
14
+ passWithNoTests: true,
14
15
  },
15
16
  });
@@ -3,9 +3,9 @@ import {
3
3
  dxIgnore,
4
4
  langJavascript,
5
5
  langTypescript,
6
+ novaRules,
6
7
  runtimeNode,
7
8
  } from '@cbnventures/nova/presets/eslint';
8
- import { novaRules } from '@cbnventures/nova/rules/eslint';
9
9
 
10
10
  /**
11
11
  * ESLint Configuration.
@@ -1,3 +1,5 @@
1
+ import { registerPackageScriptsSuite } from '@cbnventures/nova/rules/vitest';
2
+ import * as vitest from 'vitest';
1
3
  import {
2
4
  describe,
3
5
  expect,
@@ -22,3 +24,9 @@ describe('Project root', () => {
22
24
 
23
25
  return;
24
26
  });
27
+
28
+ registerPackageScriptsSuite({
29
+ vitest,
30
+ requireRootScripts: true,
31
+ enable: 'all',
32
+ });
@@ -3,14 +3,15 @@ import { defineConfig } from 'vitest/config';
3
3
  /**
4
4
  * Vitest Configuration.
5
5
  *
6
- * Discovers source-level and workspace-level unit tests.
7
- * Keeps worker checks isolated from neighboring monorepo workspaces.
6
+ * Discovers the CLI and provider tests owned by this serverless tool while
7
+ * keeping checks isolated from neighboring monorepo workspaces.
8
8
  *
9
9
  * @since 0.0.0
10
10
  */
11
11
  export default defineConfig({
12
12
  test: {
13
13
  include: [
14
+ 'api/**/*.test.ts',
14
15
  'src/**/*.test.ts',
15
16
  'tests/**/*.test.ts',
16
17
  ],
@@ -6,12 +6,12 @@ plugins {
6
6
 
7
7
  android {
8
8
  namespace = "[__ANDROID_APPLICATION_ID__]"
9
- compileSdk = 36
9
+ compileSdk = [__SCAFFOLD_VERSION_ANDROID_COMPILE_SDK__]
10
10
 
11
11
  defaultConfig {
12
12
  applicationId = "[__ANDROID_APPLICATION_ID__]"
13
- minSdk = 24
14
- targetSdk = 36
13
+ minSdk = [__SCAFFOLD_VERSION_ANDROID_MIN_SDK__]
14
+ targetSdk = [__SCAFFOLD_VERSION_ANDROID_TARGET_SDK__]
15
15
  versionCode = 1
16
16
  versionName = "1.0"
17
17
  }
@@ -1,14 +1,14 @@
1
1
  [versions]
2
- androidGradlePlugin = "9.0.1"
3
- androidxCore = "1.18.0"
4
- androidxLifecycle = "2.10.0"
5
- androidxActivity = "1.13.0"
6
- androidxComposeBom = "2026.03.01"
7
- coroutines = "1.10.2"
8
- junit = "4.13.2"
9
- kotlin = "2.3.20"
10
- nav3Core = "1.0.1"
11
- lifecycleViewmodelNav3 = "2.10.0"
2
+ androidGradlePlugin = "[__SCAFFOLD_VERSION_ANDROID_GRADLE_PLUGIN__]"
3
+ androidxCore = "[__SCAFFOLD_VERSION_ANDROIDX_CORE__]"
4
+ androidxLifecycle = "[__SCAFFOLD_VERSION_ANDROIDX_LIFECYCLE__]"
5
+ androidxActivity = "[__SCAFFOLD_VERSION_ANDROIDX_ACTIVITY__]"
6
+ androidxComposeBom = "[__SCAFFOLD_VERSION_ANDROIDX_COMPOSE_BOM__]"
7
+ coroutines = "[__SCAFFOLD_VERSION_KOTLIN_COROUTINES__]"
8
+ junit = "[__SCAFFOLD_VERSION_JUNIT__]"
9
+ kotlin = "[__SCAFFOLD_VERSION_KOTLIN__]"
10
+ nav3Core = "[__SCAFFOLD_VERSION_ANDROIDX_NAVIGATION_3__]"
11
+ lifecycleViewmodelNav3 = "[__SCAFFOLD_VERSION_ANDROIDX_LIFECYCLE_NAVIGATION_3__]"
12
12
 
13
13
  [libraries]
14
14
  androidx-core-ktx = { module = "androidx.core:core-ktx", version.ref = "androidxCore" }
@@ -1,7 +1,7 @@
1
1
  distributionBase=GRADLE_USER_HOME
2
2
  distributionPath=wrapper/dists
3
- distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
4
- distributionSha256Sum=a17ddd85a26b6a7f5ddb71ff8b05fc5104c0202c6e64782429790c933686c806
3
+ distributionUrl=https\://services.gradle.org/distributions/gradle-[__SCAFFOLD_VERSION_GRADLE__]-bin.zip
4
+ distributionSha256Sum=[__SCAFFOLD_VERSION_GRADLE_SHA256__]
5
5
  networkTimeout=10000
6
6
  validateDistributionUrl=true
7
7
  zipStoreBase=GRADLE_USER_HOME
@@ -27,7 +27,7 @@ dependencyResolutionManagement {
27
27
  }
28
28
 
29
29
  plugins {
30
- id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
30
+ id("org.gradle.toolchains.foojay-resolver-convention") version "[__SCAFFOLD_VERSION_FOOJAY_RESOLVER__]"
31
31
  }
32
32
 
33
33
  rootProject.name = "[__WORKSPACE_TITLE__]"