@cbnventures/nova 0.30.1 → 0.31.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (289) hide show
  1. package/build/package.json +1 -1
  2. package/build/src/cli/generate/docker-image/index.d.ts.map +1 -1
  3. package/build/src/cli/generate/docker-image/index.js +6 -5
  4. package/build/src/cli/generate/docker-image/index.js.map +1 -1
  5. package/build/src/cli/generate/must-haves/dotenv.d.ts +0 -4
  6. package/build/src/cli/generate/must-haves/dotenv.d.ts.map +1 -1
  7. package/build/src/cli/generate/must-haves/dotenv.js +7 -171
  8. package/build/src/cli/generate/must-haves/dotenv.js.map +1 -1
  9. package/build/src/cli/index.js +30 -1
  10. package/build/src/cli/index.js.map +1 -1
  11. package/build/src/cli/scaffold/app/android.d.ts +4 -1
  12. package/build/src/cli/scaffold/app/android.d.ts.map +1 -1
  13. package/build/src/cli/scaffold/app/android.js +91 -39
  14. package/build/src/cli/scaffold/app/android.js.map +1 -1
  15. package/build/src/cli/scaffold/app/apple.d.ts.map +1 -1
  16. package/build/src/cli/scaffold/app/apple.js +1 -0
  17. package/build/src/cli/scaffold/app/apple.js.map +1 -1
  18. package/build/src/cli/scaffold/app/astro.d.ts.map +1 -1
  19. package/build/src/cli/scaffold/app/astro.js +11 -3
  20. package/build/src/cli/scaffold/app/astro.js.map +1 -1
  21. package/build/src/cli/scaffold/app/cloudflare-workers.d.ts.map +1 -1
  22. package/build/src/cli/scaffold/app/cloudflare-workers.js +1 -0
  23. package/build/src/cli/scaffold/app/cloudflare-workers.js.map +1 -1
  24. package/build/src/cli/scaffold/app/discord-bot.d.ts.map +1 -1
  25. package/build/src/cli/scaffold/app/discord-bot.js +38 -0
  26. package/build/src/cli/scaffold/app/discord-bot.js.map +1 -1
  27. package/build/src/cli/scaffold/app/docker-image.d.ts.map +1 -1
  28. package/build/src/cli/scaffold/app/docker-image.js +2 -0
  29. package/build/src/cli/scaffold/app/docker-image.js.map +1 -1
  30. package/build/src/cli/scaffold/app/expressjs.d.ts.map +1 -1
  31. package/build/src/cli/scaffold/app/expressjs.js +21 -0
  32. package/build/src/cli/scaffold/app/expressjs.js.map +1 -1
  33. package/build/src/cli/scaffold/app/nextjs.d.ts.map +1 -1
  34. package/build/src/cli/scaffold/app/nextjs.js +3 -0
  35. package/build/src/cli/scaffold/app/nextjs.js.map +1 -1
  36. package/build/src/cli/scaffold/app/vite.d.ts.map +1 -1
  37. package/build/src/cli/scaffold/app/vite.js +7 -0
  38. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  39. package/build/src/cli/scaffold/docs/docusaurus.d.ts.map +1 -1
  40. package/build/src/cli/scaffold/docs/docusaurus.js +3 -24
  41. package/build/src/cli/scaffold/docs/docusaurus.js.map +1 -1
  42. package/build/src/cli/scaffold/package/github-action.d.ts.map +1 -1
  43. package/build/src/cli/scaffold/package/github-action.js +7 -0
  44. package/build/src/cli/scaffold/package/github-action.js.map +1 -1
  45. package/build/src/cli/scaffold/package/homebridge.d.ts.map +1 -1
  46. package/build/src/cli/scaffold/package/homebridge.js +5 -1
  47. package/build/src/cli/scaffold/package/homebridge.js.map +1 -1
  48. package/build/src/cli/scaffold/package/node-cli.d.ts.map +1 -1
  49. package/build/src/cli/scaffold/package/node-cli.js +1 -0
  50. package/build/src/cli/scaffold/package/node-cli.js.map +1 -1
  51. package/build/src/cli/scaffold/package/pfsense.d.ts.map +1 -1
  52. package/build/src/cli/scaffold/package/pfsense.js +7 -0
  53. package/build/src/cli/scaffold/package/pfsense.js.map +1 -1
  54. package/build/src/cli/scaffold/starter/base.d.ts.map +1 -1
  55. package/build/src/cli/scaffold/starter/base.js +85 -70
  56. package/build/src/cli/scaffold/starter/base.js.map +1 -1
  57. package/build/src/lib/dotenv.d.ts +2 -1
  58. package/build/src/lib/dotenv.d.ts.map +1 -1
  59. package/build/src/lib/dotenv.js +171 -1
  60. package/build/src/lib/dotenv.js.map +1 -1
  61. package/build/src/lib/regex.d.ts +4 -1
  62. package/build/src/lib/regex.d.ts.map +1 -1
  63. package/build/src/lib/regex.js +4 -1
  64. package/build/src/lib/regex.js.map +1 -1
  65. package/build/src/lib/run-scripts.d.ts.map +1 -1
  66. package/build/src/lib/run-scripts.js +102 -19
  67. package/build/src/lib/run-scripts.js.map +1 -1
  68. package/build/src/lib/scaffold-presentation.d.ts +8 -0
  69. package/build/src/lib/scaffold-presentation.d.ts.map +1 -0
  70. package/build/src/lib/scaffold-presentation.js +272 -0
  71. package/build/src/lib/scaffold-presentation.js.map +1 -0
  72. package/build/src/lib/scaffold.d.ts +5 -3
  73. package/build/src/lib/scaffold.d.ts.map +1 -1
  74. package/build/src/lib/scaffold.js +380 -261
  75. package/build/src/lib/scaffold.js.map +1 -1
  76. package/build/src/lib/utility.d.ts +2 -2
  77. package/build/src/lib/utility.d.ts.map +1 -1
  78. package/build/src/lib/utility.js +13 -9
  79. package/build/src/lib/utility.js.map +1 -1
  80. package/build/src/types/cli/generate/docker-image/index.d.ts +3 -0
  81. package/build/src/types/cli/generate/must-haves/dotenv.d.ts +0 -146
  82. package/build/src/types/cli/scaffold/app/android.d.ts +39 -14
  83. package/build/src/types/cli/scaffold/app/apple.d.ts +3 -0
  84. package/build/src/types/cli/scaffold/app/astro.d.ts +3 -0
  85. package/build/src/types/cli/scaffold/app/cloudflare-workers.d.ts +3 -0
  86. package/build/src/types/cli/scaffold/app/discord-bot.d.ts +12 -0
  87. package/build/src/types/cli/scaffold/app/docker-image.d.ts +3 -0
  88. package/build/src/types/cli/scaffold/app/expressjs.d.ts +3 -0
  89. package/build/src/types/cli/scaffold/app/nextjs.d.ts +3 -0
  90. package/build/src/types/cli/scaffold/app/vite.d.ts +3 -0
  91. package/build/src/types/cli/scaffold/docs/docusaurus.d.ts +3 -3
  92. package/build/src/types/cli/scaffold/package/github-action.d.ts +3 -0
  93. package/build/src/types/cli/scaffold/package/homebridge.d.ts +3 -0
  94. package/build/src/types/cli/scaffold/package/node-cli.d.ts +3 -0
  95. package/build/src/types/cli/scaffold/package/pfsense.d.ts +3 -0
  96. package/build/src/types/cli/scaffold/starter/base.d.ts +41 -15
  97. package/build/src/types/lib/dotenv.d.ts +158 -0
  98. package/build/src/types/lib/regex.d.ts +15 -0
  99. package/build/src/types/lib/run-scripts.d.ts +36 -5
  100. package/build/src/types/lib/scaffold-presentation.d.ts +295 -0
  101. package/build/src/types/lib/scaffold.d.ts +323 -105
  102. package/build/src/types/lib/utility.d.ts +2 -0
  103. package/build/src/types/tests/cli/index.test.d.ts +8 -1
  104. package/build/src/types/tests/cli/scaffold/app/android.test.d.ts +36 -0
  105. package/build/src/types/tests/cli/scaffold/app/expressjs.test.d.ts +51 -0
  106. package/build/src/types/tests/cli/scaffold/app/nextjs.test.d.ts +15 -0
  107. package/build/src/types/tests/cli/scaffold/docs/docusaurus.test.d.ts +2 -2
  108. package/build/src/types/tests/cli/scaffold/starter/base.test.d.ts +73 -0
  109. package/build/src/types/tests/cli/utility/run-scripts.test.d.ts +36 -1
  110. package/build/src/types/tests/homebridge-custom-ui.test.d.ts +19 -0
  111. package/build/src/types/tests/lib/scaffold-presentation.test.d.ts +135 -0
  112. package/build/src/types/tests/lib/scaffold.test.d.ts +16 -2
  113. package/build/src/types/tests/scaffold-output-contract.test.d.ts +38 -1
  114. package/build/src/types/tests/scaffold-template-source.test.d.ts +15 -0
  115. package/build/templates/generators/docker-image/astro-node/Dockerfile +4 -4
  116. package/build/templates/generators/docker-image/nextjs-standalone/Dockerfile +4 -4
  117. package/build/templates/generators/docker-image/node/Dockerfile +5 -6
  118. package/build/templates/generators/docker-image/static-site/Dockerfile +4 -4
  119. package/build/templates/generators/github/workflows/publish/targets/docker-hub.yml +2 -2
  120. package/build/templates/generators/github/workflows/publish/targets/ghcr.yml +2 -2
  121. package/build/templates/generators/must-haves/agent-conventions/conventions/documentation.md +2 -2
  122. package/build/templates/scaffold/app/android/package.json +5 -5
  123. package/build/templates/scaffold/app/android/scripts/android-environment.mjs +74 -0
  124. package/build/templates/scaffold/app/android/scripts/run-android.mjs +82 -0
  125. package/build/templates/scaffold/app/android/scripts/run-gradle.mjs +5 -9
  126. package/build/templates/scaffold/app/apple/Sources/App.swift +9 -0
  127. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-ios-1024.png +0 -0
  128. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-128.png +0 -0
  129. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-128@2x.png +0 -0
  130. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-16.png +0 -0
  131. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-16@2x.png +0 -0
  132. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-256.png +0 -0
  133. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-256@2x.png +0 -0
  134. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-32.png +0 -0
  135. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-32@2x.png +0 -0
  136. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-512.png +0 -0
  137. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-512@2x.png +0 -0
  138. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/Contents.json +74 -0
  139. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/Contents.json +6 -0
  140. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/NovaLogo.imageset/Contents.json +16 -0
  141. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/NovaLogo.imageset/nova.svg +5 -0
  142. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialFacebook.imageset/Contents.json +17 -0
  143. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialFacebook.imageset/facebook.svg +1 -0
  144. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialGitHub.imageset/Contents.json +17 -0
  145. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialGitHub.imageset/github.svg +1 -0
  146. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialGooglePlay.imageset/Contents.json +17 -0
  147. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialGooglePlay.imageset/google-play.svg +1 -0
  148. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialInstagram.imageset/Contents.json +17 -0
  149. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialInstagram.imageset/instagram.svg +1 -0
  150. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialLinkedIn.imageset/Contents.json +17 -0
  151. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialLinkedIn.imageset/linkedin.svg +1 -0
  152. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialX.imageset/Contents.json +17 -0
  153. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialX.imageset/x.svg +1 -0
  154. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialYouTube.imageset/Contents.json +17 -0
  155. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/SocialYouTube.imageset/youtube.svg +1 -0
  156. package/build/templates/scaffold/app/apple/Sources/ContentView.swift +415 -9
  157. package/build/templates/scaffold/app/apple/package.json +4 -4
  158. package/build/templates/scaffold/app/apple/project.yml +1 -0
  159. package/build/templates/scaffold/app/astro/package.json +5 -5
  160. package/build/templates/scaffold/app/astro/src/pages/index.astro +88 -5
  161. package/build/templates/scaffold/app/cloudflare-workers/package.json +7 -4
  162. package/build/templates/scaffold/app/cloudflare-workers/wrangler.toml +1 -1
  163. package/build/templates/scaffold/app/discord-bot/package.json +7 -7
  164. package/build/templates/scaffold/app/discord-bot/src/bot.test.ts +48 -0
  165. package/build/templates/scaffold/app/discord-bot/src/bot.ts +128 -0
  166. package/build/templates/scaffold/app/discord-bot/src/index.ts +12 -27
  167. package/build/templates/scaffold/app/discord-bot/src/types/bot.d.ts +34 -0
  168. package/build/templates/scaffold/app/discord-bot/src/types/bot.test.d.ts +8 -0
  169. package/build/templates/scaffold/app/discord-bot/src/types/index.d.ts +6 -0
  170. package/build/templates/scaffold/app/docker-image/package.json +5 -5
  171. package/build/templates/scaffold/app/express/package.json +7 -4
  172. package/build/templates/scaffold/app/express/src/app.test.ts +44 -0
  173. package/build/templates/scaffold/app/express/src/app.ts +72 -0
  174. package/build/templates/scaffold/app/express/src/index.ts +51 -13
  175. package/build/templates/scaffold/app/express/src/types/app.d.ts +32 -0
  176. package/build/templates/scaffold/app/express/src/types/app.test.d.ts +8 -0
  177. package/build/templates/scaffold/app/express/src/types/index.d.ts +20 -0
  178. package/build/templates/scaffold/app/nextjs/package.json +5 -2
  179. package/build/templates/scaffold/app/nextjs/src/app/globals.css +1 -9
  180. package/build/templates/scaffold/app/nextjs/src/app/layout.tsx +6 -2
  181. package/build/templates/scaffold/app/nextjs/src/app/page.tsx +87 -3
  182. package/build/templates/scaffold/app/vite/eslint.config.mts +2 -1
  183. package/build/templates/scaffold/app/vite/index.html +2 -1
  184. package/build/templates/scaffold/app/vite/package.json +5 -2
  185. package/build/templates/scaffold/docs/docusaurus/docs/customize.mdx +38 -0
  186. package/build/templates/scaffold/docs/docusaurus/docs/intro.mdx +22 -1
  187. package/build/templates/scaffold/docs/docusaurus/docusaurus.config.ts +120 -2
  188. package/build/templates/scaffold/docs/docusaurus/package.json +5 -2
  189. package/build/templates/scaffold/docs/docusaurus/sidebars.ts +4 -1
  190. package/build/templates/scaffold/docs/docusaurus/src/pages/index.tsx +109 -0
  191. package/build/templates/scaffold/docs/docusaurus/src/types/pages/index.d.ts +15 -0
  192. package/build/templates/scaffold/docs/docusaurus/static/images/nova.svg +5 -0
  193. package/build/templates/scaffold/package/github-action/package.json +6 -6
  194. package/build/templates/scaffold/package/github-action/src/index.ts +4 -4
  195. package/build/templates/scaffold/package/github-action/src/run.test.ts +56 -2
  196. package/build/templates/scaffold/package/github-action/src/run.ts +46 -2
  197. package/build/templates/scaffold/package/github-action/src/types/run.d.ts +2 -1
  198. package/build/templates/scaffold/package/homebridge/eslint.config.mts +3 -6
  199. package/build/templates/scaffold/package/homebridge/package.json +13 -13
  200. package/build/templates/scaffold/package/node-cli/bin/cli.mjs +33 -0
  201. package/build/templates/scaffold/package/node-cli/package.json +13 -10
  202. package/build/templates/scaffold/package/node-cli/src/index.ts +2 -2
  203. package/build/templates/scaffold/package/node-cli/src/program.ts +354 -19
  204. package/build/templates/scaffold/package/node-cli/src/status.test.ts +18 -0
  205. package/build/templates/scaffold/package/node-cli/src/status.ts +39 -0
  206. package/build/templates/scaffold/package/node-cli/src/types/program.d.ts +125 -0
  207. package/build/templates/scaffold/package/node-cli/src/types/status.d.ts +15 -0
  208. package/build/templates/scaffold/package/pfsense/package.json +10 -10
  209. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +14 -7
  210. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml +23 -12
  211. package/build/templates/scaffold/package/pfsense/port/files/usr/local/sbin/[__WORKSPACE_NAME__] +3 -3
  212. package/build/templates/scaffold/package/pfsense/port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/info.xml +2 -1
  213. package/build/templates/scaffold/package/pfsense/port/pkg-descr +4 -3
  214. package/build/templates/scaffold/package/pfsense/tests/project.test.ts +32 -0
  215. package/build/templates/scaffold/package/pfsense/tests/types/project.test.d.ts +6 -0
  216. package/build/templates/scaffold-options/app/android-launchpad/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/Navigation.kt +39 -0
  217. package/build/templates/scaffold-options/app/android-launchpad/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreen.kt +558 -0
  218. package/build/templates/scaffold-options/app/android-native/app/build.gradle.kts +77 -0
  219. package/build/templates/scaffold-options/app/android-native/app/proguard-rules.pro +1 -0
  220. package/build/templates/scaffold-options/app/android-native/app/src/main/AndroidManifest.xml +22 -0
  221. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/MainActivity.kt +29 -0
  222. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/NavigationKeys.kt +6 -0
  223. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/data/DataRepository.kt +12 -0
  224. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Color.kt +11 -0
  225. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Theme.kt +50 -0
  226. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Type.kt +36 -0
  227. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModel.kt +27 -0
  228. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/arrow_up_right.xml +9 -0
  229. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/ic_launcher_background.xml +9 -0
  230. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/ic_launcher_foreground.xml +3 -0
  231. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/nova_logo.xml +9 -0
  232. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_facebook.xml +3 -0
  233. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_github.xml +3 -0
  234. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_google_play.xml +3 -0
  235. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_instagram.xml +3 -0
  236. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_linkedin.xml +3 -0
  237. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_x.xml +3 -0
  238. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/social_youtube.xml +3 -0
  239. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml +6 -0
  240. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml +6 -0
  241. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-hdpi/ic_launcher.webp +0 -0
  242. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp +0 -0
  243. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-mdpi/ic_launcher.webp +0 -0
  244. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp +0 -0
  245. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xhdpi/ic_launcher.webp +0 -0
  246. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp +0 -0
  247. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp +0 -0
  248. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp +0 -0
  249. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp +0 -0
  250. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp +0 -0
  251. package/build/templates/scaffold-options/app/android-native/app/src/main/res/values/strings.xml +3 -0
  252. package/build/templates/scaffold-options/app/android-native/app/src/main/res/values/themes.xml +5 -0
  253. package/build/templates/scaffold-options/app/android-native/app/src/main/res/xml/backup_rules.xml +13 -0
  254. package/build/templates/scaffold-options/app/android-native/app/src/main/res/xml/data_extraction_rules.xml +19 -0
  255. package/build/templates/scaffold-options/app/android-native/app/src/test/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModelTest.kt +27 -0
  256. package/build/templates/scaffold-options/app/android-native/build.gradle.kts +6 -0
  257. package/build/templates/scaffold-options/app/android-native/gradle/libs.versions.toml +33 -0
  258. package/build/templates/scaffold-options/app/android-native/gradle/wrapper/gradle-wrapper.jar +0 -0
  259. package/build/templates/scaffold-options/app/android-native/gradle/wrapper/gradle-wrapper.properties +8 -0
  260. package/build/templates/scaffold-options/app/android-native/gradle.properties +29 -0
  261. package/build/templates/scaffold-options/app/android-native/gradlew +172 -0
  262. package/build/templates/scaffold-options/app/android-native/gradlew.bat +84 -0
  263. package/build/templates/scaffold-options/app/android-native/settings.gradle.kts +34 -0
  264. package/build/templates/scaffold-options/app/vite/framework/react/config/framework-ignore-files.ts +1 -0
  265. package/build/templates/scaffold-options/app/vite/framework/react/src/app.tsx +90 -1
  266. package/build/templates/scaffold-options/app/vite/framework/react/src/main.ts +1 -0
  267. package/build/templates/scaffold-options/app/vite/framework/react/tsconfig.json +1 -0
  268. package/build/templates/scaffold-options/app/vite/framework/svelte/config/framework-ignore-files.ts +1 -0
  269. package/build/templates/scaffold-options/app/vite/framework/svelte/src/app.svelte +72 -5
  270. package/build/templates/scaffold-options/app/vite/framework/svelte/src/main.ts +1 -0
  271. package/build/templates/scaffold-options/app/vite/framework/svelte/tsconfig.json +1 -0
  272. package/build/templates/scaffold-options/app/vite/framework/vanilla/config/framework-ignore-files.ts +1 -0
  273. package/build/templates/scaffold-options/app/vite/framework/vanilla/src/main.ts +45 -1
  274. package/build/templates/scaffold-options/app/vite/framework/vanilla/tsconfig.json +1 -0
  275. package/build/templates/scaffold-options/app/vite/framework/vue/config/framework-ignore-files.ts +1 -0
  276. package/build/templates/scaffold-options/app/vite/framework/vue/src/app.vue +186 -5
  277. package/build/templates/scaffold-options/app/vite/framework/vue/src/main.ts +1 -0
  278. package/build/templates/scaffold-options/app/vite/framework/vue/tsconfig.json +1 -0
  279. package/build/templates/scaffold-options/app/web-launchpad/public/favicon.svg +5 -0
  280. package/build/templates/scaffold-options/app/web-launchpad/public/nova-socials.svg +28 -0
  281. package/build/templates/scaffold-options/app/web-launchpad/src/styles/nova-launchpad.css +397 -0
  282. package/build/templates/scaffold-options/package/homebridge/custom-ui/config/eslint-custom-ui.ts +19 -0
  283. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/index.html +206 -16
  284. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/index.js +252 -2
  285. package/build/templates/scaffold-options/package/homebridge/schema-ui/config/eslint-custom-ui.ts +1 -0
  286. package/package.json +1 -1
  287. package/build/templates/scaffold/docs/docusaurus/src/pages/index.mdx +0 -8
  288. package/build/templates/scaffold/package/node-cli/src/index.test.ts +0 -15
  289. package/build/templates/scaffold-options/package/homebridge/custom-ui/homebridge-ui/public/styles.css +0 -12
@@ -0,0 +1,125 @@
1
+ import type { ChalkInstance } from 'chalk';
2
+ import type { Command } from 'commander';
3
+
4
+ /**
5
+ * Program - CLI.
6
+ *
7
+ * @since 0.0.0
8
+ */
9
+ export type Program_CLI_Program = Command;
10
+
11
+ /**
12
+ * Program - CLI - Run.
13
+ *
14
+ * @since 0.0.0
15
+ */
16
+ export type Program_CLI_Run_CommandArguments = string[];
17
+
18
+ export type Program_CLI_Run_Returns = Promise<void>;
19
+
20
+ /**
21
+ * Program - CLI - Register Commands.
22
+ *
23
+ * @since 0.0.0
24
+ */
25
+ export type Program_CLI_RegisterCommands_Status = Command;
26
+
27
+ export type Program_CLI_RegisterCommands_Returns = void;
28
+
29
+ /**
30
+ * Program - CLI - Execute Command.
31
+ *
32
+ * @since 0.0.0
33
+ */
34
+ export type Program_CLI_ExecuteCommand_Target = () => void | Promise<void>;
35
+
36
+ export type Program_CLI_ExecuteCommand_Returns = Promise<void>;
37
+
38
+ export type Program_CLI_ExecuteCommand_CommandLabel = string;
39
+
40
+ /**
41
+ * Program - CLI - Get Header.
42
+ *
43
+ * @since 0.0.0
44
+ */
45
+ export type Program_CLI_GetHeader_Returns = string;
46
+
47
+ /**
48
+ * Program - CLI - Get Command Usage.
49
+ *
50
+ * @since 0.0.0
51
+ */
52
+ export type Program_CLI_GetCommandUsage_Command = Command;
53
+
54
+ export type Program_CLI_GetCommandUsage_Returns = string;
55
+
56
+ export type Program_CLI_GetCommandUsage_CommandName = string;
57
+
58
+ export type Program_CLI_GetCommandUsage_CommandAliases = string[];
59
+
60
+ export type Program_CLI_GetCommandUsage_CommandUsage = string;
61
+
62
+ export type Program_CLI_GetCommandUsage_FullCommand = string[];
63
+
64
+ export type Program_CLI_GetCommandUsage_UsagePipeSeparator = string;
65
+
66
+ export type Program_CLI_GetCommandUsage_AliasCommand = string[];
67
+
68
+ export type Program_CLI_GetCommandUsage_ParentCommand = Command | null;
69
+
70
+ export type Program_CLI_GetCommandUsage_ParentCommandName = string;
71
+
72
+ export type Program_CLI_GetCommandUsage_ParentCommandAliases = string[];
73
+
74
+ export type Program_CLI_GetCommandUsage_FullLine = string;
75
+
76
+ export type Program_CLI_GetCommandUsage_AliasLine = string;
77
+
78
+ /**
79
+ * Program - CLI - Get Subcommand Term.
80
+ *
81
+ * @since 0.0.0
82
+ */
83
+ export type Program_CLI_GetSubcommandTerm_Command = Command;
84
+
85
+ export type Program_CLI_GetSubcommandTerm_Returns = string;
86
+
87
+ export type Program_CLI_GetSubcommandTerm_Category = 'commands' | 'subcommands';
88
+
89
+ export type Program_CLI_GetSubcommandTerm_CategoryPipeSeparator = string;
90
+
91
+ export type Program_CLI_GetSubcommandTerm_Names = string;
92
+
93
+ export type Program_CLI_GetSubcommandTerm_Usage = string;
94
+
95
+ /**
96
+ * Program - CLI - Style Text.
97
+ *
98
+ * @since 0.0.0
99
+ */
100
+ export type Program_CLI_StyleText_Type = 'commands' | 'description' | 'subcommands' | 'title' | 'usage';
101
+
102
+ export type Program_CLI_StyleText_Text = string;
103
+
104
+ export type Program_CLI_StyleText_Returns = string;
105
+
106
+ export type Program_CLI_StyleText_CategoryStyles = Record<Program_CLI_StyleText_Type, ChalkInstance[]>;
107
+
108
+ export type Program_CLI_StyleText_TitleStyles = Record<string, ChalkInstance[]>;
109
+
110
+ export type Program_CLI_StyleText_CategoryFunctions = ChalkInstance[];
111
+
112
+ export type Program_CLI_StyleText_TitleFunctions = ChalkInstance[];
113
+
114
+ export type Program_CLI_StyleText_ColoredText = string;
115
+
116
+ /**
117
+ * Program - CLI - Handle CLI Error.
118
+ *
119
+ * @since 0.0.0
120
+ */
121
+ export type Program_CLI_HandleCliError_Text = string;
122
+
123
+ export type Program_CLI_HandleCliError_Returns = void;
124
+
125
+ export type Program_CLI_HandleCliError_ProcessedText = string;
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Status - Create Status Message.
3
+ *
4
+ * @since 0.0.0
5
+ */
6
+ export type Status_CreateStatusMessage_Returns = string;
7
+
8
+ /**
9
+ * Status - Run Status.
10
+ *
11
+ * @since 0.0.0
12
+ */
13
+ export type Status_RunStatus_Message = string;
14
+
15
+ export type Status_RunStatus_Returns = void;
@@ -1,6 +1,11 @@
1
1
  {
2
2
  "name": "[__WORKSPACE_PACKAGE_NAME__]",
3
3
  "version": "0.0.0",
4
+ "keywords": [
5
+ "freebsd",
6
+ "pfsense",
7
+ "pfsense-package"
8
+ ],
4
9
  "type": "module",
5
10
  "files": [
6
11
  "build"
@@ -20,8 +25,11 @@
20
25
  "clean": "nova utility run-scripts --parallel 'clean:*'",
21
26
  "clean:build": "shx rm -rf ./build"
22
27
  },
28
+ "engines": {
29
+ "node": ">=22.3 <23 || ^24"
30
+ },
23
31
  "dependencies": {
24
- "@cbnventures/nova": "0.30.1"
32
+ "@cbnventures/nova": "0.31.1"
25
33
  },
26
34
  "devDependencies": {
27
35
  "@types/node": "24.9.1",
@@ -29,13 +37,5 @@
29
37
  "shx": "0.4.0",
30
38
  "typescript": "6.0.3",
31
39
  "vitest": "4.1.11"
32
- },
33
- "engines": {
34
- "node": ">=22.3 <23 || ^24"
35
- },
36
- "keywords": [
37
- "freebsd",
38
- "pfsense",
39
- "pfsense-package"
40
- ]
40
+ }
41
41
  }
@@ -13,21 +13,22 @@ require_once('services.inc');
13
13
  */
14
14
  function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings(): array
15
15
  {
16
- $settings = config_get_path('installedpackages/[__WORKSPACE_NAME__]/config/0', []);
16
+ $settings = config_get_path('installedpackages/[__PFSENSE_CONFIG_NAME__]/config/0', []);
17
17
 
18
18
  return is_array($settings) ? $settings : [];
19
19
  }
20
20
 
21
21
  /**
22
- * Maps the WebGUI schedule value to cron fields.
22
+ * Maps the WebGUI task frequency to cron fields.
23
23
  *
24
- * @param string $schedule Selected schedule.
24
+ * @param string $frequency Selected frequency.
25
25
  *
26
26
  * @return array{string, string, string, string, string} Cron fields.
27
27
  */
28
- function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSchedule(string $schedule): array
28
+ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetCronFields(string $frequency): array
29
29
  {
30
- return match ($schedule) {
30
+ return match ($frequency) {
31
+ 'minute' => ['*', '*', '*', '*', '*'],
31
32
  'daily' => ['0', '0', '*', '*', '*'],
32
33
  'weekly' => ['0', '0', '*', '*', '0'],
33
34
  default => ['0', '*', '*', '*', '*'],
@@ -49,7 +50,13 @@ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync(): void
49
50
  return;
50
51
  }
51
52
 
52
- [$minute, $hour, $dayOfMonth, $month, $dayOfWeek] = pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSchedule((string) ($settings['schedule'] ?? 'hourly'));
53
+ $taskFrequency = $settings['task_frequency'] ?? 'hourly';
54
+
55
+ if (is_array($taskFrequency)) {
56
+ $taskFrequency = $taskFrequency[0] ?? 'hourly';
57
+ }
58
+
59
+ [$minute, $hour, $dayOfMonth, $month, $dayOfWeek] = pfsensePackage[__WORKSPACE_IDENTIFIER__]GetCronFields((string) $taskFrequency);
53
60
 
54
61
  install_cron_job($command, true, $minute, $hour, $dayOfMonth, $month, $dayOfWeek, 'root');
55
62
  }
@@ -73,6 +80,6 @@ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Validate(array $post, array &$i
73
80
  $message = trim((string) ($post['message'] ?? ''));
74
81
 
75
82
  if ($message === '') {
76
- $inputErrors[] = 'The task message cannot be empty.';
83
+ $inputErrors[] = 'The example log message cannot be empty.';
77
84
  }
78
85
  }
@@ -10,46 +10,57 @@
10
10
  */
11
11
  ]]>
12
12
  </copyright>
13
- <name>[__WORKSPACE_NAME__]</name>
13
+ <name>[__PFSENSE_CONFIG_NAME__]</name>
14
14
  <version>%%PKGVERSION%%</version>
15
15
  <title>Services: [__WORKSPACE_TITLE__]</title>
16
16
  <include_file>/usr/local/pkg/[__WORKSPACE_NAME__].inc</include_file>
17
- <aftersaveredirect>/pkg.php?xml=[__WORKSPACE_NAME__].xml</aftersaveredirect>
17
+ <addedit_string>[__WORKSPACE_TITLE__]: saved settings</addedit_string>
18
18
  <menu>
19
19
  <name>[__WORKSPACE_TITLE__]</name>
20
20
  <section>Services</section>
21
21
  <configfile>[__WORKSPACE_NAME__].xml</configfile>
22
- <url>/pkg.php?xml=[__WORKSPACE_NAME__].xml</url>
22
+ <url>/pkg_edit.php?xml=[__WORKSPACE_NAME__].xml&amp;id=0</url>
23
23
  </menu>
24
24
  <fields>
25
25
  <field>
26
26
  <type>listtopic</type>
27
- <name>[__WORKSPACE_TITLE__] Settings</name>
27
+ <name>Getting Started</name>
28
28
  </field>
29
29
  <field>
30
- <fielddescr>Enable Scheduled Task</fielddescr>
30
+ <fielddescr>Nova × pfSense</fielddescr>
31
+ <type>info</type>
32
+ <description>[__WORKSPACE_TITLE__] starts here. This generated package uses pfSense's native WebGUI controls and includes a replaceable background-task example. Rename these fields and replace the task as the package takes shape.</description>
33
+ </field>
34
+ <field>
35
+ <type>listtopic</type>
36
+ <name>Starter Configuration</name>
37
+ </field>
38
+ <field>
39
+ <fielddescr>Enable Example Background Task</fielddescr>
31
40
  <fieldname>enabled</fieldname>
32
41
  <type>checkbox</type>
33
- <description>Run the package's background task on the selected schedule.</description>
42
+ <description>Turn on the replaceable background-task example.</description>
34
43
  </field>
35
44
  <field>
36
- <fielddescr>Schedule</fielddescr>
37
- <fieldname>schedule</fieldname>
45
+ <fielddescr>Example Task Frequency</fielddescr>
46
+ <fieldname>task_frequency</fieldname>
38
47
  <type>select</type>
39
48
  <options>
49
+ <option><name>Every minute</name><value>minute</value></option>
40
50
  <option><name>Hourly</name><value>hourly</value></option>
41
51
  <option><name>Daily at midnight</name><value>daily</value></option>
42
52
  <option><name>Weekly on Sunday</name><value>weekly</value></option>
43
53
  </options>
44
- <description>Choose how often pfSense runs the background task.</description>
54
+ <default_value>hourly</default_value>
55
+ <description>Choose how often pfSense runs the starter background task.</description>
45
56
  </field>
46
57
  <field>
47
- <fielddescr>Task Message</fielddescr>
58
+ <fielddescr>Example Log Message</fielddescr>
48
59
  <fieldname>message</fieldname>
49
60
  <type>input</type>
50
61
  <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>
62
+ <default_value>Example [__WORKSPACE_TITLE__] background task completed.</default_value>
63
+ <description>Starter text written to the pfSense system log. Replace this behavior with the package's actual background work.</description>
53
64
  <required/>
54
65
  </field>
55
66
  </fields>
@@ -6,7 +6,7 @@ declare(strict_types=1);
6
6
  require_once('/etc/inc/config.inc');
7
7
  require_once('/etc/inc/util.inc');
8
8
 
9
- $settings = config_get_path('installedpackages/[__WORKSPACE_NAME__]/config/0', []);
9
+ $settings = config_get_path('installedpackages/[__PFSENSE_CONFIG_NAME__]/config/0', []);
10
10
 
11
11
  if (!is_array($settings) || ($settings['enabled'] ?? '') !== 'on') {
12
12
  exit(0);
@@ -15,7 +15,7 @@ if (!is_array($settings) || ($settings['enabled'] ?? '') !== 'on') {
15
15
  $message = trim((string) ($settings['message'] ?? ''));
16
16
 
17
17
  if ($message === '') {
18
- $message = 'Scheduled [__WORKSPACE_TITLE__] task completed.';
18
+ $message = 'Example [__WORKSPACE_TITLE__] background task completed.';
19
19
  }
20
20
 
21
- log_error(sprintf('[__WORKSPACE_TITLE__]: %s', $message));
21
+ logger(LOG_NOTICE, sprintf('[__WORKSPACE_TITLE__]: %s', $message));
@@ -2,7 +2,8 @@
2
2
  <pfsensepkgs>
3
3
  <package>
4
4
  <name>[__WORKSPACE_TITLE__]</name>
5
- <descr><![CDATA[[__WORKSPACE_TITLE__] adds a WebGUI-managed scheduled task to pfSense.]]></descr>
5
+ <internal_name>[__WORKSPACE_IDENTIFIER__]</internal_name>
6
+ <descr><![CDATA[[__WORKSPACE_TITLE__] is a Nova-generated pfSense package starter with native WebGUI settings and an optional background-task example.]]></descr>
6
7
  <version>%%PKGVERSION%%</version>
7
8
  <configurationfile>[__WORKSPACE_NAME__].xml</configurationfile>
8
9
  </package>
@@ -1,3 +1,4 @@
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.
1
+ [__WORKSPACE_TITLE__] is a Nova-generated pfSense package starter with a native
2
+ WebGUI settings page and an optional background-task example. Configure it from
3
+ Services > [__WORKSPACE_TITLE__], then replace the example with package-specific
4
+ behavior as the project takes shape.
@@ -1,3 +1,5 @@
1
+ import { readFile } from 'node:fs/promises';
2
+
1
3
  import {
2
4
  describe,
3
5
  expect,
@@ -6,6 +8,8 @@ import {
6
8
 
7
9
  import packageJson from '../package.json' with { type: 'json' };
8
10
 
11
+ import type { Project_WebGUIContract_IncludesNativeGuidanceAndTaskSections_PackageGui } from './types/project.test.d.ts';
12
+
9
13
  /**
10
14
  * Project - Workspace Identity.
11
15
  *
@@ -22,3 +26,31 @@ describe('Workspace identity', () => {
22
26
 
23
27
  return;
24
28
  });
29
+
30
+ /**
31
+ * Project - WebGUI Contract.
32
+ *
33
+ * Confirms the generated package presents its starter through pfSense's native
34
+ * XML field system instead of introducing a separate frontend framework.
35
+ *
36
+ * @since 0.0.0
37
+ */
38
+ describe('WebGUI contract', () => {
39
+ it('includes native guidance and task sections', async () => {
40
+ const packageGui: Project_WebGUIContract_IncludesNativeGuidanceAndTaskSections_PackageGui = await readFile(new URL('../port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml', import.meta.url), 'utf-8');
41
+
42
+ expect(packageGui).toContain('<type>info</type>');
43
+
44
+ expect(packageGui).toContain('<name>Getting Started</name>');
45
+
46
+ expect(packageGui).toContain('<name>Starter Configuration</name>');
47
+
48
+ expect(packageGui).toContain('<addedit_string>[__WORKSPACE_TITLE__]: saved settings</addedit_string>');
49
+
50
+ expect(packageGui).toContain('<option><name>Every minute</name><value>minute</value></option>');
51
+
52
+ return;
53
+ });
54
+
55
+ return;
56
+ });
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Project - WebGUI Contract - Includes Native Guidance And Task Sections.
3
+ *
4
+ * @since 0.0.0
5
+ */
6
+ export type Project_WebGUIContract_IncludesNativeGuidanceAndTaskSections_PackageGui = string;
@@ -0,0 +1,39 @@
1
+ package [__ANDROID_APPLICATION_ID__]
2
+
3
+ import androidx.compose.foundation.layout.padding
4
+ import androidx.compose.foundation.layout.safeDrawingPadding
5
+ import androidx.compose.runtime.Composable
6
+ import androidx.compose.ui.Modifier
7
+ import androidx.compose.ui.unit.dp
8
+ import androidx.navigation3.runtime.entryProvider
9
+ import androidx.navigation3.runtime.rememberNavBackStack
10
+ import androidx.navigation3.ui.NavDisplay
11
+ import [__ANDROID_APPLICATION_ID__].ui.main.MainScreen
12
+
13
+ /**
14
+ * Main Navigation.
15
+ *
16
+ * Hosts the generated launch screen inside Nova's Android navigation foundation.
17
+ *
18
+ * @since UNRELEASED
19
+ */
20
+ @Composable
21
+ public fun MainNavigation() {
22
+ val backStack = rememberNavBackStack(Main)
23
+
24
+ NavDisplay(
25
+ backStack = backStack,
26
+ onBack = { backStack.removeLastOrNull() },
27
+ entryProvider =
28
+ entryProvider {
29
+ entry<Main> {
30
+ MainScreen(
31
+ modifier =
32
+ Modifier
33
+ .safeDrawingPadding()
34
+ .padding(20.dp),
35
+ )
36
+ }
37
+ },
38
+ )
39
+ }