@cbnventures/nova 0.38.0 → 0.39.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 (174) hide show
  1. package/build/package.json +1 -1
  2. package/build/scaffold-versions.json +20 -0
  3. package/build/src/api/app-store-connect.d.ts +17 -2
  4. package/build/src/api/app-store-connect.d.ts.map +1 -1
  5. package/build/src/api/app-store-connect.js +654 -171
  6. package/build/src/api/app-store-connect.js.map +1 -1
  7. package/build/src/api/github-runner-images.d.ts +13 -0
  8. package/build/src/api/github-runner-images.d.ts.map +1 -0
  9. package/build/src/api/github-runner-images.js +238 -0
  10. package/build/src/api/github-runner-images.js.map +1 -0
  11. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +2 -2
  12. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -1
  13. package/build/src/cli/generate/github/workflows-blueprint-validate.js +210 -3
  14. package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -1
  15. package/build/src/cli/generate/github/workflows-blueprint.d.ts +6 -4
  16. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  17. package/build/src/cli/generate/github/workflows-blueprint.js +685 -70
  18. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  19. package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map +1 -1
  20. package/build/src/cli/generate/must-haves/agent-conventions.js +1 -0
  21. package/build/src/cli/generate/must-haves/agent-conventions.js.map +1 -1
  22. package/build/src/cli/index.js +12 -1
  23. package/build/src/cli/index.js.map +1 -1
  24. package/build/src/cli/integration/app-store-connect.d.ts +10 -0
  25. package/build/src/cli/integration/app-store-connect.d.ts.map +1 -1
  26. package/build/src/cli/integration/app-store-connect.js +701 -80
  27. package/build/src/cli/integration/app-store-connect.js.map +1 -1
  28. package/build/src/cli/scaffold/package/pfsense.d.ts +3 -0
  29. package/build/src/cli/scaffold/package/pfsense.d.ts.map +1 -1
  30. package/build/src/cli/scaffold/package/pfsense.js +140 -6
  31. package/build/src/cli/scaffold/package/pfsense.js.map +1 -1
  32. package/build/src/cli/scaffold/tool/serverless.d.ts +2 -0
  33. package/build/src/cli/scaffold/tool/serverless.d.ts.map +1 -1
  34. package/build/src/cli/scaffold/tool/serverless.js +35 -1
  35. package/build/src/cli/scaffold/tool/serverless.js.map +1 -1
  36. package/build/src/cli/utility/changelog.d.ts +7 -0
  37. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  38. package/build/src/cli/utility/changelog.js +800 -7
  39. package/build/src/cli/utility/changelog.js.map +1 -1
  40. package/build/src/cli/utility/configure.d.ts +3 -1
  41. package/build/src/cli/utility/configure.d.ts.map +1 -1
  42. package/build/src/cli/utility/configure.js +196 -20
  43. package/build/src/cli/utility/configure.js.map +1 -1
  44. package/build/src/lib/docker-packaging.d.ts +1 -0
  45. package/build/src/lib/docker-packaging.d.ts.map +1 -1
  46. package/build/src/lib/docker-packaging.js +39 -2
  47. package/build/src/lib/docker-packaging.js.map +1 -1
  48. package/build/src/lib/env-namespace.d.ts.map +1 -1
  49. package/build/src/lib/env-namespace.js +2 -1
  50. package/build/src/lib/env-namespace.js.map +1 -1
  51. package/build/src/lib/item.d.ts +2 -1
  52. package/build/src/lib/item.d.ts.map +1 -1
  53. package/build/src/lib/item.js +18 -0
  54. package/build/src/lib/item.js.map +1 -1
  55. package/build/src/lib/nova-config.d.ts.map +1 -1
  56. package/build/src/lib/nova-config.js +46 -2
  57. package/build/src/lib/nova-config.js.map +1 -1
  58. package/build/src/lib/regex.d.ts +14 -0
  59. package/build/src/lib/regex.d.ts.map +1 -1
  60. package/build/src/lib/regex.js +14 -0
  61. package/build/src/lib/regex.js.map +1 -1
  62. package/build/src/lib/scaffold.d.ts +3 -3
  63. package/build/src/lib/scaffold.d.ts.map +1 -1
  64. package/build/src/lib/scaffold.js +111 -8
  65. package/build/src/lib/scaffold.js.map +1 -1
  66. package/build/src/lib/workflow-templates.d.ts +4 -1
  67. package/build/src/lib/workflow-templates.d.ts.map +1 -1
  68. package/build/src/lib/workflow-templates.js +60 -2
  69. package/build/src/lib/workflow-templates.js.map +1 -1
  70. package/build/src/types/api/app-store-connect.d.ts +476 -33
  71. package/build/src/types/api/github-runner-images.d.ts +199 -0
  72. package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +69 -8
  73. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +132 -9
  74. package/build/src/types/cli/integration/app-store-connect.d.ts +470 -6
  75. package/build/src/types/cli/scaffold/package/pfsense.d.ts +83 -0
  76. package/build/src/types/cli/scaffold/tool/serverless.d.ts +30 -0
  77. package/build/src/types/cli/utility/changelog.d.ts +327 -1
  78. package/build/src/types/cli/utility/configure.d.ts +92 -4
  79. package/build/src/types/lib/docker-packaging.d.ts +25 -1
  80. package/build/src/types/lib/env-namespace.d.ts +4 -1
  81. package/build/src/types/lib/item.d.ts +7 -0
  82. package/build/src/types/lib/nova-config.d.ts +24 -0
  83. package/build/src/types/lib/regex.d.ts +91 -0
  84. package/build/src/types/lib/scaffold.d.ts +48 -4
  85. package/build/src/types/lib/workflow-templates.d.ts +26 -0
  86. package/build/src/types/shared.d.ts +241 -2
  87. package/build/src/types/tests/api/app-store-connect.test.d.ts +162 -0
  88. package/build/src/types/tests/api/github-runner-images.test.d.ts +113 -0
  89. package/build/src/types/tests/cli/generate/github/workflows-blueprint-generate.test.d.ts +19 -0
  90. package/build/src/types/tests/cli/generate/github/workflows-blueprint-parity.test.d.ts +0 -9
  91. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +109 -26
  92. package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +123 -30
  93. package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +45 -0
  94. package/build/src/types/tests/cli/generate/github/workflows-version-contract.test.d.ts +2 -2
  95. package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +2 -0
  96. package/build/src/types/tests/cli/integration/app-store-connect.test.d.ts +876 -0
  97. package/build/src/types/tests/cli/scaffold/tool/serverless.test.d.ts +21 -0
  98. package/build/src/types/tests/cli/utility/changelog-android.test.d.ts +14 -0
  99. package/build/src/types/tests/cli/utility/changelog-apple.test.d.ts +21 -0
  100. package/build/src/types/tests/cli/utility/changelog-fold.test.d.ts +350 -0
  101. package/build/src/types/tests/cli/utility/changelog.test.d.ts +50 -0
  102. package/build/src/types/tests/cli/utility/configure.test.d.ts +55 -0
  103. package/build/src/types/tests/lib/nova-config.test.d.ts +28 -0
  104. package/build/src/types/tests/lib/scaffold.test.d.ts +59 -2
  105. package/build/src/types/tests/scaffold-output-contract.test.d.ts +79 -0
  106. package/build/templates/generators/must-haves/agent-conventions/AGENTS.md +1 -0
  107. package/build/templates/generators/must-haves/agent-conventions/CLAUDE.md +1 -0
  108. package/build/templates/generators/must-haves/agent-conventions/conventions/pfsense.md +311 -0
  109. package/build/templates/scaffold/app/android/package.json +1 -1
  110. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-ios-1024.png +0 -0
  111. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-128.png +0 -0
  112. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-128@2x.png +0 -0
  113. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-16.png +0 -0
  114. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-16@2x.png +0 -0
  115. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-256.png +0 -0
  116. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-256@2x.png +0 -0
  117. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-32.png +0 -0
  118. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-32@2x.png +0 -0
  119. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-512.png +0 -0
  120. package/build/templates/scaffold/app/apple/Sources/Assets.xcassets/AppIcon.appiconset/AppIcon-mac-512@2x.png +0 -0
  121. package/build/templates/scaffold/app/apple/package.json +1 -1
  122. package/build/templates/scaffold/app/astro/package.json +1 -1
  123. package/build/templates/scaffold/app/discord-bot/package.json +1 -1
  124. package/build/templates/scaffold/app/express/package.json +1 -1
  125. package/build/templates/scaffold/app/nextjs/package.json +1 -1
  126. package/build/templates/scaffold/app/vite/package.json +1 -1
  127. package/build/templates/scaffold/docs/docusaurus/package.json +2 -2
  128. package/build/templates/scaffold/package/github-action/package.json +1 -1
  129. package/build/templates/scaffold/package/homebridge/package.json +1 -1
  130. package/build/templates/scaffold/package/pfsense/package.json +1 -1
  131. package/build/templates/scaffold/package/pfsense/port/Makefile.template +16 -1
  132. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__]/FileLock.php +93 -0
  133. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__]/PackagePaths.php +40 -0
  134. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__]/UpdateManager.php +1667 -0
  135. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +161 -13
  136. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].xml +37 -0
  137. package/build/templates/scaffold/package/pfsense/port/files/usr/local/sbin/[__WORKSPACE_NAME__] +203 -8
  138. package/build/templates/scaffold/package/pfsense/port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/logo.svg +12 -0
  139. package/build/templates/scaffold/package/pfsense/port/files/usr/local/share/pfSense-pkg-[__WORKSPACE_IDENTIFIER__]/release-signing.pub +9 -0
  140. package/build/templates/scaffold/package/pfsense/port/files/usr/local/www/[__WORKSPACE_NAME__]-about.php +437 -0
  141. package/build/templates/scaffold/package/pfsense/port/pkg-plist +6 -0
  142. package/build/templates/scaffold/package/pfsense/scripts/build-package.sh +54 -0
  143. package/build/templates/scaffold/package/pfsense/scripts/check-package.mjs +114 -1
  144. package/build/templates/scaffold/package/pfsense/scripts/regex.mjs +10 -0
  145. package/build/templates/scaffold/package/pfsense/tests/updates.php +695 -0
  146. package/build/templates/scaffold-options/app/android-native/app/src/main/res/drawable/ic_launcher_background.xml +1 -1
  147. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-hdpi/ic_launcher.webp +0 -0
  148. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp +0 -0
  149. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-mdpi/ic_launcher.webp +0 -0
  150. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp +0 -0
  151. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xhdpi/ic_launcher.webp +0 -0
  152. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp +0 -0
  153. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp +0 -0
  154. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp +0 -0
  155. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp +0 -0
  156. package/build/templates/scaffold-options/app/android-native/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp +0 -0
  157. package/build/templates/scaffold-options/docker-image/common/Dockerfile +7 -0
  158. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +1 -1
  159. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/types/worker/index.test.d.ts +40 -2
  160. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/types/worker/landing-page.d.ts +23 -0
  161. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/worker/index.test.ts +119 -4
  162. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/worker/index.ts +25 -3
  163. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/src/worker/landing-page.ts +278 -0
  164. package/build/templates/scaffold-options/tool/serverless/vercel-functions/api/index.test.ts +121 -6
  165. package/build/templates/scaffold-options/tool/serverless/vercel-functions/api/index.ts +49 -12
  166. package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +3 -1
  167. package/build/templates/scaffold-options/tool/serverless/vercel-functions/src/function/landing-page.ts +278 -0
  168. package/build/templates/scaffold-options/tool/serverless/vercel-functions/src/types/api/index.d.ts +17 -2
  169. package/build/templates/scaffold-options/tool/serverless/vercel-functions/src/types/api/index.test.d.ts +40 -2
  170. package/build/templates/scaffold-options/tool/serverless/vercel-functions/src/types/function/landing-page.d.ts +23 -0
  171. package/build/templates/scaffold-options/tool/serverless/vercel-functions/tsconfig.functions.json +3 -1
  172. package/build/templates/scaffold-options/tool/serverless/vercel-functions/vercel.json +7 -1
  173. package/package.json +1 -1
  174. package/build/templates/scaffold/package/pfsense-root/.github/workflows/pfsense-[__WORKSPACE_NAME__].yml +0 -62
@@ -190,9 +190,9 @@ export type Tests_Lib_Scaffold_ResolveTemplateAnswers_UsesNonInteractiveDefaults
190
190
  /**
191
191
  * Tests - Lib - Scaffold - Workspace Contract - Derives Non Overlapping Environment Prefixes.
192
192
  *
193
- * @since 0.31.0
193
+ * @since 0.39.0
194
194
  */
195
- export type Tests_Lib_Scaffold_WorkspaceContract_DerivesNonOverlappingEnvironmentPrefixes_Returns = void;
195
+ export type Tests_Lib_Scaffold_WorkspaceContract_DerivesNonOverlappingEnvironmentPrefixes_Returns = Promise<void>;
196
196
 
197
197
  /**
198
198
  * Tests - Lib - Scaffold - Workspace Contract - Derives Role Based Package Names.
@@ -201,6 +201,19 @@ export type Tests_Lib_Scaffold_WorkspaceContract_DerivesNonOverlappingEnvironmen
201
201
  */
202
202
  export type Tests_Lib_Scaffold_WorkspaceContract_DerivesRoleBasedPackageNames_Returns = void;
203
203
 
204
+ /**
205
+ * Tests - Lib - Scaffold - Workspace Contract - Disables PfSense Updates For Non GitHub Repositories.
206
+ *
207
+ * @since 0.39.0
208
+ */
209
+ export type Tests_Lib_Scaffold_WorkspaceContract_DisablesPfSenseUpdatesForNonGitHubRepositories_ProjectDirectory = string;
210
+
211
+ export type Tests_Lib_Scaffold_WorkspaceContract_DisablesPfSenseUpdatesForNonGitHubRepositories_ConfigPath = string;
212
+
213
+ export type Tests_Lib_Scaffold_WorkspaceContract_DisablesPfSenseUpdatesForNonGitHubRepositories_ResolveReplacements = (workspaceName: string, configRoot: string) => Promise<Map<RegExp, string> | undefined>;
214
+
215
+ export type Tests_Lib_Scaffold_WorkspaceContract_DisablesPfSenseUpdatesForNonGitHubRepositories_Replacements = Map<RegExp, string> | undefined;
216
+
204
217
  /**
205
218
  * Tests - Lib - Scaffold - Workspace Contract - Merges Required Platforms When Registering Workspaces.
206
219
  *
@@ -226,3 +239,47 @@ export type Tests_Lib_Scaffold_WorkspaceContract_MergesRequiredPlatformsWhenRegi
226
239
  * @since 0.26.0
227
240
  */
228
241
  export type Tests_Lib_Scaffold_WorkspaceContract_NormalizesOnlyWorkspacePathsInsideTheRoot_Returns = void;
242
+
243
+ /**
244
+ * Tests - Lib - Scaffold - Workspace Contract - Registers A Publish Deploy Target.
245
+ *
246
+ * @since 0.39.0
247
+ */
248
+ export type Tests_Lib_Scaffold_WorkspaceContract_RegistersAPublishDeployTarget_ProjectDirectory = string;
249
+
250
+ export type Tests_Lib_Scaffold_WorkspaceContract_RegistersAPublishDeployTarget_WorkspaceDirectory = string;
251
+
252
+ export type Tests_Lib_Scaffold_WorkspaceContract_RegistersAPublishDeployTarget_ConfigPath = string;
253
+
254
+ export type Tests_Lib_Scaffold_WorkspaceContract_RegistersAPublishDeployTarget_ConfigContents = string;
255
+
256
+ export type Tests_Lib_Scaffold_WorkspaceContract_RegistersAPublishDeployTarget_ConfigRaw = string;
257
+
258
+ export type Tests_Lib_Scaffold_WorkspaceContract_RegistersAPublishDeployTarget_Config = Record<string, unknown>;
259
+
260
+ /**
261
+ * Tests - Lib - Scaffold - Workspace Contract - Rejects PfSense Without Author Email.
262
+ *
263
+ * @since 0.39.0
264
+ */
265
+
266
+ export type Tests_Lib_Scaffold_WorkspaceContract_RejectsPfSenseWithoutAuthorEmail_ProjectDirectory = string;
267
+
268
+ export type Tests_Lib_Scaffold_WorkspaceContract_RejectsPfSenseWithoutAuthorEmail_ConfigPath = string;
269
+
270
+ export type Tests_Lib_Scaffold_WorkspaceContract_RejectsPfSenseWithoutAuthorEmail_ResolveReplacements = (workspaceName: string, configRoot: string) => Promise<Map<RegExp, string> | undefined>;
271
+
272
+ export type Tests_Lib_Scaffold_WorkspaceContract_RejectsPfSenseWithoutAuthorEmail_Result = Map<RegExp, string> | undefined;
273
+
274
+ /**
275
+ * Tests - Lib - Scaffold - Workspace Contract - Resolves PfSense Project Metadata.
276
+ *
277
+ * @since 0.39.0
278
+ */
279
+ export type Tests_Lib_Scaffold_WorkspaceContract_ResolvesPfSenseProjectMetadata_ProjectDirectory = string;
280
+
281
+ export type Tests_Lib_Scaffold_WorkspaceContract_ResolvesPfSenseProjectMetadata_ConfigPath = string;
282
+
283
+ export type Tests_Lib_Scaffold_WorkspaceContract_ResolvesPfSenseProjectMetadata_ResolveReplacements = (workspaceName: string, configRoot: string) => Promise<Map<RegExp, string> | undefined>;
284
+
285
+ export type Tests_Lib_Scaffold_WorkspaceContract_ResolvesPfSenseProjectMetadata_Replacements = Map<RegExp, string> | undefined;
@@ -1,3 +1,5 @@
1
+ import type { SpawnSyncReturns } from 'node:child_process';
2
+
1
3
  import type { Shared_ScaffoldOutputContract } from '../shared.d.ts';
2
4
 
3
5
  /**
@@ -47,6 +49,24 @@ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_KeepsEveryTransl
47
49
 
48
50
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_KeepsEveryTranslationReadyScaffoldOnItsNativeLocalizationContract_TranslationReadyContent = string;
49
51
 
52
+ /**
53
+ * Tests - Scaffold Output Contract - Scaffold Output Contract - Keeps The Docker Image OCI Label Contract.
54
+ *
55
+ * @since 0.39.0
56
+ */
57
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_KeepsTheDockerImageOCILabelContract_DockerfilePath = string;
58
+
59
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_KeepsTheDockerImageOCILabelContract_DockerfileContent = string;
60
+
61
+ /**
62
+ * Tests - Scaffold Output Contract - Scaffold Output Contract - Marks pfSense Release Packages For Any FreeBSD Version And Keeps Them Vital.
63
+ *
64
+ * @since 0.39.0
65
+ */
66
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_MarksPfSenseReleasePackagesForAnyFreeBSDVersionAndKeepsThemVital_BuildPackagePath = string;
67
+
68
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_MarksPfSenseReleasePackagesForAnyFreeBSDVersionAndKeepsThemVital_BuildPackageContent = string;
69
+
50
70
  /**
51
71
  * Tests - Scaffold Output Contract - Scaffold Output Contract - Matches Every Template Inventory.
52
72
  *
@@ -82,6 +102,18 @@ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSense
82
102
 
83
103
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_SettingsHandlerContent = string;
84
104
 
105
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_FileLockPath = string;
106
+
107
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_FileLockContent = string;
108
+
109
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackagePathsPath = string;
110
+
111
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackagePathsContent = string;
112
+
113
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_UpdateManagerPath = string;
114
+
115
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_UpdateManagerContent = string;
116
+
85
117
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackageScriptPath = string;
86
118
 
87
119
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackageScriptContent = string;
@@ -90,6 +122,53 @@ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSense
90
122
 
91
123
  export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackageInfoContent = string;
92
124
 
125
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackageLogoPath = string;
126
+
127
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackageLogoContent = string;
128
+
129
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_ReleaseSigningKeyPath = string;
130
+
131
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_ReleaseSigningKeyContent = string;
132
+
133
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_AboutPagePath = string;
134
+
135
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_AboutPageContent = string;
136
+
137
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_MakefilePath = string;
138
+
139
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_MakefileContent = string;
140
+
141
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackagePlistPath = string;
142
+
143
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_PackagePlistContent = string;
144
+
145
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_CheckPackagePath = string;
146
+
147
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_CheckPackageContent = string;
148
+
149
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_UpdateTestsPath = string;
150
+
151
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_RoutesThePfSenseSingleInstanceSettingsPageDirectlyToItsNativeEditor_UpdateTestsContent = string;
152
+
153
+ /**
154
+ * Tests - Scaffold Output Contract - Scaffold Output Contract - Validates pfSense Release Signing Key Files With Line Numbered Diagnostics.
155
+ *
156
+ * @since 0.39.0
157
+ */
158
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_ReleaseSigningFilePath = string;
159
+
160
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_CommentOnlyContent = string;
161
+
162
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_GeneratedWorkspaceDirectory = string;
163
+
164
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_CommentOnlyResult = SpawnSyncReturns<string>;
165
+
166
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_ValidKey = string;
167
+
168
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_ValidKeyResult = SpawnSyncReturns<string>;
169
+
170
+ export type Tests_ScaffoldOutputContract_ScaffoldOutputContract_ValidatesPfSenseReleaseSigningKeyFilesWithLineNumberedDiagnostics_MalformedKeyResult = SpawnSyncReturns<string>;
171
+
93
172
  /**
94
173
  * Tests - Scaffold Output Contract - Verify Generated Output.
95
174
  *
@@ -26,6 +26,7 @@ Read and follow the conventions and rules defined in the files below.
26
26
  - [conventions/go.md](conventions/go.md) — Go conventions (documentation, APIs, ownership, errors, concurrency, and tests).
27
27
  - [conventions/java.md](conventions/java.md) — Java conventions (documentation style, code style).
28
28
  - [conventions/kotlin.md](conventions/kotlin.md) — Kotlin conventions (documentation style, code style).
29
+ - [conventions/pfsense.md](conventions/pfsense.md) — pfSense package WebGUI conventions (spacing model, page skeleton, Form API, tables, buttons, icons, help text).
29
30
  - [conventions/php.md](conventions/php.md) — PHP conventions (documentation style, code style).
30
31
  - [conventions/python.md](conventions/python.md) — Python conventions (documentation style, code style).
31
32
  - [conventions/rust.md](conventions/rust.md) — Rust conventions (documentation, ownership, errors, unsafe code, and tests).
@@ -26,6 +26,7 @@ Read and follow the conventions and rules defined in the files below.
26
26
  - [conventions/go.md](conventions/go.md) — Go conventions (documentation, APIs, ownership, errors, concurrency, and tests).
27
27
  - [conventions/java.md](conventions/java.md) — Java conventions (documentation style, code style).
28
28
  - [conventions/kotlin.md](conventions/kotlin.md) — Kotlin conventions (documentation style, code style).
29
+ - [conventions/pfsense.md](conventions/pfsense.md) — pfSense package WebGUI conventions (spacing model, page skeleton, Form API, tables, buttons, icons, help text).
29
30
  - [conventions/php.md](conventions/php.md) — PHP conventions (documentation style, code style).
30
31
  - [conventions/python.md](conventions/python.md) — Python conventions (documentation style, code style).
31
32
  - [conventions/rust.md](conventions/rust.md) — Rust conventions (documentation, ownership, errors, unsafe code, and tests).
@@ -0,0 +1,311 @@
1
+ # pfSense Conventions
2
+
3
+ Applies to pfSense package WebGUI pages (`/usr/local/www/*.php` and the package's `pkg_edit.php` XML). Build every page out of pfSense's own pieces, the way pfSense's own pages are built. When this file doesn't cover something, open the closest official page on a pfSense install (`/usr/local/www/`) and copy its markup. Don't invent a layout.
4
+
5
+ Reference pages used below, from pfSense CE 2.9.0:
6
+ - **Lists and edit pages:** `firewall_aliases.php`, `firewall_aliases_edit.php`, `services_unbound.php`, `services_unbound_host_edit.php`, `system_gateways.php`
7
+ - **Settings pages:** `services_unbound_advanced.php`, `system_advanced_admin.php`
8
+ - **Search and filter panels:** `pkg_mgr.php`, `status_logs_common.inc`, `diag_tables.php`
9
+ - **Status pages:** `status_services.php`, `status_dhcp_leases.php`
10
+ - **Framework:** `classes/Form.class.php`, `classes/Form/*.class.php`, `guiconfig.inc`, `head.inc`, `css/pfSense.css`, `js/pfSenseHelpers.js`
11
+
12
+ ## Spacing Model
13
+
14
+ pfSense sets `.panel-body { padding: 0px; }` (`pfSense.css`), which cancels Bootstrap's 15px. Anything placed directly in `.panel` or `.panel-body` touches the panel edge. The padding comes from the elements pfSense puts inside, so `.panel-body` may only contain:
15
+
16
+ | Child of `.panel-body` | Padding comes from |
17
+ |--------------------------------------------------------------|------------------------------------------------------------------------|
18
+ | `.form-group` rows (from `Form_Section`, or the same markup) | `.form-group { padding: 7px 5px 5px 5px }` plus the `col-sm-*` gutters |
19
+ | `.table-responsive > table.table` (or `table.table`) | `.table > tbody > tr > td { padding: 6px 4px 6px 10px }` |
20
+ | an alert from `print_info_box()` | Bootstrap's `.alert { padding: 15px }` |
21
+ | `ul.list-group > li.list-group-item` | Bootstrap's `.list-group-item { padding: 10px 15px }` |
22
+
23
+ `.content { padding: 10px }` exists, but only dashboard widgets use it. Don't use it on pages.
24
+
25
+ ```html
26
+ <!-- BAD: text and a button flush against the panel edge -->
27
+ <div class="panel-body">
28
+ <p>Search catalog names.</p>
29
+ <button class="btn btn-primary">Open Catalog</button>
30
+ </div>
31
+ ```
32
+
33
+ ```php
34
+ // GOOD: the same content as a Form API row, which renders a padded .form-group
35
+ $form = new Form(false);
36
+ $section = new Form_Section('Add from Catalog');
37
+
38
+ $button = new Form_Button('open_catalog', gettext('Open Catalog'), null, 'fa-solid fa-search');
39
+ $button->addClass('btn-primary btn-sm');
40
+
41
+ $section->addInput(new Form_StaticText('Catalog', $button))->setHelp('Search catalog names.');
42
+ $form->add($section);
43
+
44
+ print($form);
45
+ ```
46
+
47
+ Prefer the Form API for anything inside a panel. A hand-written `.form-group` row is padded too, but its `.control-label` is only right-aligned inside a `.form-horizontal` ancestor, which the Form API adds. pfSense's own hand-written search panels (`pkg_mgr.php`, `diag_arp.php`) have no such ancestor, so their labels are left-aligned, unlike Form API rows.
48
+
49
+ Don't add `<style>` blocks or inline styles for spacing. pfSense uses inline styles only for `display: none` before JavaScript runs, cell wrapping or no-wrap, cursor hints and data-driven widths.
50
+
51
+ A package widget with no pfSense counterpart, such as a card grid, may ship its own stylesheet. It must:
52
+ - scope every rule to a package class
53
+ - sit inside a padded child from the table above, such as a `.form-group` row
54
+ - never restyle pfSense's own classes
55
+
56
+ ## Page Skeleton
57
+
58
+ ```php
59
+ $pgtitle = array(gettext('Services'), gettext('Example'), gettext('Lists'));
60
+ $pglinks = array('', '/example-lists.php', '@self');
61
+ $shortcut_section = 'example';
62
+
63
+ include('head.inc');
64
+
65
+ if ($input_errors) {
66
+ print_input_errors($input_errors);
67
+ }
68
+
69
+ if ($savemsg) {
70
+ print_info_box($savemsg, 'success');
71
+ }
72
+
73
+ display_top_tabs($tab_array);
74
+
75
+ // Panels, forms, action buttons, help.
76
+
77
+ include('foot.inc');
78
+ ```
79
+
80
+ - **Breadcrumbs:** `$pgtitle` is the crumb trail. In `$pglinks`, `""` means no link and `"@self"` links to the current page. On edit pages, link the middle crumbs back to the list page.
81
+ - **Messages and tabs:** messages come before `display_top_tabs()`. The tab array holds `array(label, active, url)` entries.
82
+ - **Help link:** `head.inc` adds the `?` icon. Don't write one.
83
+ - **Scripts:** queue page JavaScript in `events.push(function () { … });`. `foot.inc` runs it after jQuery and the helpers load.
84
+
85
+ ## Forms
86
+
87
+ Build every settings and edit form with the Form API. Don't hand-write form panels.
88
+
89
+ ```php
90
+ $form = new Form(); // Adds the Save button (btn-primary, fa-save) below the last panel.
91
+
92
+ $section = new Form_Section('General Options');
93
+
94
+ $section->addInput(new Form_Checkbox(
95
+ 'enable',
96
+ 'Enable',
97
+ 'Enable the service',
98
+ $pconfig['enable'],
99
+ ));
100
+
101
+ $section->addInput(new Form_Input(
102
+ 'port',
103
+ 'Listen Port',
104
+ 'number',
105
+ $pconfig['port'],
106
+ ))->setHelp('The port used for answering queries.');
107
+
108
+ $form->add($section);
109
+ $form->addGlobal(new Form_Input('id', null, 'hidden', $id));
110
+
111
+ print($form);
112
+ ```
113
+
114
+ **Structure**
115
+ - Each `Form_Section` renders as `panel panel-default` with a `panel-heading` and `panel-body` full of `.form-group` rows.
116
+ - Labels are `col-sm-2 control-label`, and inputs share `col-sm-10`.
117
+ - `new Form(false)` has no Save button. Use it for search, filter and selector forms.
118
+ - Globals (hidden inputs and extra buttons) render below the last panel, outside it.
119
+
120
+ **Text and help**
121
+ - **Field help:** `->setHelp()` on the input, or on the `Form_Group` for help under the whole row.
122
+ - **A paragraph inside a section:** `new Form_StaticText('', '<span class="help-block">…</span>')`.
123
+ - **A read-only value in a settings section:** `Form_StaticText($title, $html)`. The `.col-sm-10` padding-top lines it up with the label.
124
+
125
+ **Fields**
126
+ - **Required fields:** start the title with `*`.
127
+ - **Several inputs on one row:** use a `Form_Group` with `->setWidth()` on each input. The column widths plus the label's 2 add up to 12.
128
+ - **Repeatable rows:** use a `Form_Group` with class `repeatable`, a `btn-warning` `fa-trash-can` Delete button per row, and a global `btn-success addbtn` `fa-plus` add button.
129
+
130
+ ## Lists, Tables and Edit Pages
131
+
132
+ A list page shows a table panel, then the Add button. Add and the row's pencil open a separate `*_edit.php` page built with the Form API. Saving returns to the list.
133
+
134
+ ```html
135
+ <div class="panel panel-default">
136
+ <div class="panel-heading"><h2 class="panel-title"><?=gettext('Block Lists')?></h2></div>
137
+ <div class="panel-body">
138
+ <div class="table-responsive">
139
+ <table class="table table-striped table-hover table-condensed sortable-theme-bootstrap table-rowdblclickedit" data-sortable>
140
+ <thead>
141
+ <tr>
142
+ <th><?=gettext('Name')?></th>
143
+ <th data-sortable="false"><?=gettext('Actions')?></th>
144
+ </tr>
145
+ </thead>
146
+ <tbody>
147
+ <tr class="disabled"> <!-- Disabled items only. -->
148
+ <td><?=htmlspecialchars($name)?></td>
149
+ <td>
150
+ <a class="fa-solid fa-pencil" title="<?=gettext('Edit list')?>" href="example-lists_edit.php?id=<?=$id?>"></a>
151
+ <a class="fa-regular fa-square-check" title="<?=gettext('Enable list')?>" href="?act=toggle&amp;id=<?=$id?>" usepost></a>
152
+ <a class="fa-solid fa-trash-can" title="<?=gettext('Delete list')?>" href="?act=del&amp;id=<?=$id?>" usepost></a>
153
+ </td>
154
+ </tr>
155
+ </tbody>
156
+ </table>
157
+ </div>
158
+ </div>
159
+ </div>
160
+
161
+ <nav class="action-buttons">
162
+ <a href="example-lists_edit.php" role="button" class="btn btn-success btn-sm">
163
+ <i class="fa-solid fa-plus icon-embed-btn"></i>
164
+ <?=gettext('Add')?>
165
+ </a>
166
+ </nav>
167
+ ```
168
+
169
+ **Table markup**
170
+ - **Classes:** tables always carry `table table-striped table-hover table-condensed`.
171
+ - **Sorting:** add `sortable-theme-bootstrap` and `data-sortable` to sort, and give icon and Actions headers `data-sortable="false"`.
172
+ - **Double-click to edit:** `table-rowdblclickedit` clicks the row's first `.fa-pencil`, so only add it when every row has one.
173
+ - **Disabled items:** the row gets `<tr class="disabled">`.
174
+
175
+ **Row actions**
176
+ - **Markup:** row actions are bare icon anchors with a `title`. The title is the tooltip and the confirm text.
177
+ - **POST:** every state-changing link (delete, enable, disable) has `usepost`, which turns it into a POST with the CSRF token. Edit and copy links stay plain GETs.
178
+ - **Confirm:** `fa-trash-can` with `usepost` confirms by itself. Other actions that need a confirm add `do-confirm`, and actions with their own confirm add `no-confirm`.
179
+ - **Enable and disable icons:** a disabled item shows `fa-regular fa-square-check` (Enable), and an enabled item shows `fa-solid fa-ban` (Disable).
180
+
181
+ **Empty states and layout**
182
+ - **Empty state:** in a table, a `<tr><td colspan="N">No … are configured.</td></tr>` row. With no table, `print_info_box(gettext('No …'), 'warning', false)` in place of the panel, as `diag_tables.php` does. An info box inside a panel body keeps the alert's 20px bottom margin and leaves a blank strip under it. Never show an empty panel.
183
+ - **Action buttons:** they go in `<nav class="action-buttons">` right after the panel closes, never inside it.
184
+ - **Page-wide settings:** these live on the list page as a Form API section below the tables, with one Save.
185
+
186
+ ## Buttons and Icons
187
+
188
+ `.icon-embed-btn` forces the icon to `color: white`. Only use it on a coloured button. On `btn-default` or a bare `.btn` the icon is invisible.
189
+
190
+ ```html
191
+ <!-- BAD: white icon on a white button -->
192
+ <button class="btn btn-default"><i class="fa-solid fa-arrows-rotate icon-embed-btn"></i>Refresh</button>
193
+
194
+ <!-- GOOD -->
195
+ <button class="btn btn-info btn-sm"><i class="fa-solid fa-arrows-rotate icon-embed-btn"></i>Refresh</button>
196
+ ```
197
+
198
+ **Form_Button traps**
199
+ - `new Form_Button($name, $title, null, $icon)` adds no colour class, so always chain `->addClass('btn-…')`.
200
+ - Never pass both a link and an icon: the link form adds `btn-default`, so the icon is white on white.
201
+ - `btn-default` is only for buttons without an icon.
202
+
203
+ | Class | Use for |
204
+ |---------------|-------------------------------------------------------------|
205
+ | `btn-primary` | Save, Search, Import, Export |
206
+ | `btn-success` | Add, Install, Apply Changes, Apply Filter, Update |
207
+ | `btn-info` | Clear, Display Advanced, view switches, Refresh |
208
+ | `btn-warning` | Delete a repeatable row inside a form |
209
+ | `btn-danger` | Destructive actions on data, such as clearing a whole table |
210
+
211
+ | Purpose | FontAwesome 6 icon |
212
+ |-----------------------|--------------------------------|
213
+ | Add | `fa-solid fa-plus` |
214
+ | Edit | `fa-solid fa-pencil` |
215
+ | Delete | `fa-solid fa-trash-can` |
216
+ | Copy | `fa-regular fa-clone` |
217
+ | Save | `fa-solid fa-save` |
218
+ | Search | `fa-solid fa-search` |
219
+ | Clear | `fa-solid fa-undo` |
220
+ | Refresh or update | `fa-solid fa-arrows-rotate` |
221
+ | Filter | `fa-solid fa-filter` |
222
+ | Advanced | `fa-solid fa-cog` |
223
+ | Enable (row action) | `fa-regular fa-square-check` |
224
+ | Disable (row action) | `fa-solid fa-ban` |
225
+ | Locked or managed row | `fa-solid fa-lock text-danger` |
226
+
227
+ Use FontAwesome 6 names with a style prefix (`fa-solid`, `fa-regular`). Never use the bare `fa` class or FontAwesome 4 names.
228
+
229
+ ## Search, Filters and Selectors
230
+
231
+ pfSense has no on/off switch widget and no page that combines a selector, a search box and a group filter. Build those from the patterns below.
232
+
233
+ **Server-side filter (preferred):** `new Form(false)` with a `Form_Section` and one `Form_Group('')`, from `status_logs_common.inc`. Each field's `setHelp()` is its label. Put the button inside a `Form_StaticText` so it sits on the same row.
234
+
235
+ ```php
236
+ $form = new Form(false);
237
+ $section = new Form_Section('Search');
238
+
239
+ $group = new Form_Group('');
240
+ $group->add(new Form_Input('q', null, 'text', $query))->setWidth(6)->setHelp('Name or description');
241
+
242
+ $button = new Form_Button('search', gettext('Search'), null, 'fa-solid fa-search');
243
+ $button->addClass('btn-primary btn-sm');
244
+
245
+ $group->add(new Form_StaticText('', $button));
246
+ $section->add($group);
247
+ $form->add($section);
248
+
249
+ print($form);
250
+ ```
251
+
252
+ **Selector that reloads the page:** `Form(false)` + a `Form_Section` + a `Form_Group` holding a `Form_Select` (from `diag_tables.php`). JavaScript submits on `change`, and an action button can share the group.
253
+
254
+ **Client-side search panel:** copy the `pkg_mgr.php` block exactly. It is a `.form-group` with a `col-sm-2` label, a `col-sm-5` input, a `col-sm-2` select, and a `col-sm-3` column holding Search (`btn-primary`, `fa-search`) and Clear (`btn-info`, `fa-undo`). Help goes in `col-sm-10 col-sm-offset-2`.
255
+
256
+ **On/off choices in a list:** use the row enable/disable icons, or `Form_Checkbox` fields in a form.
257
+
258
+ ## Help Text
259
+
260
+ | Kind | Where |
261
+ |-----------------------------------|------------------------------------------------------------------------------------------------------------|
262
+ | Field help | `->setHelp()` under the field |
263
+ | A paragraph inside a form section | `Form_StaticText('', '<span class="help-block">…</span>')` |
264
+ | A short note under a table panel | `<span class="help-block">` between the panel and its `action-buttons`, outside both |
265
+ | Longer page help | `<div><div class="infoblock">` + `print_info_box($text, 'info', false)` + `</div></div>` below the content |
266
+
267
+ The `infoblock` stays hidden behind an (i) icon that `pfSenseHelpers.js` adds. Add `blockopen` to show it open. Info boxes used as help pass `false` as the third argument, so they have no close button.
268
+
269
+ ## Dependent Fields
270
+
271
+ Hide the rows that don't apply instead of showing every field. Run the check once on load and again on every change.
272
+
273
+ ```js
274
+ events.push(function () {
275
+ function updateScope() {
276
+ var everyone = $('#everyone').prop('checked');
277
+
278
+ hideInput('networks', everyone);
279
+ hideInput('devices', everyone);
280
+ }
281
+
282
+ updateScope();
283
+ $('#everyone').click(updateScope);
284
+ });
285
+ ```
286
+
287
+ A multi-select `Form_Select` (`$allowMultiple = true`) appends `[]` to both its name and its id, so `hideInput('lists', …)` finds nothing. Escape the brackets:
288
+
289
+ ```js
290
+ hideInput('lists\\[\\]', anyList); // BAD without the escapes: hideInput('lists', anyList) hides nothing.
291
+ ```
292
+
293
+ Helpers from `pfSenseHelpers.js`:
294
+ - `hideInput`, `hideCheckbox` and `hideSelect` hide one field's whole row.
295
+ - `hideGroupInput` hides one input inside a multi-input row.
296
+ - `hideClass` hides everything with a class set in PHP through `->addClass()`.
297
+ - `disableInput` disables a field without hiding it.
298
+
299
+ ## Checklist
300
+
301
+ - Nothing sits directly in `.panel` or `.panel-body`. Every child is a `.form-group` row, a table, an info box or a list group.
302
+ - Every settings and edit form is built with the Form API. No form panels are written by hand.
303
+ - Page order: `$pgtitle`/`$pglinks`, then `head.inc`, messages, `display_top_tabs()`, content, then `foot.inc`.
304
+ - List pages: a table panel, then `<nav class="action-buttons">` Add, with Add and Edit opening a `*_edit.php` page.
305
+ - Tables use the standard classes. Disabled rows use `tr.disabled`. Empty tables show a `colspan` row.
306
+ - Row actions are titled icon anchors, with `usepost` on every state change.
307
+ - `icon-embed-btn` only appears on coloured buttons, and every icon `Form_Button` gets a colour class.
308
+ - Icons use FontAwesome 6 names with a style prefix.
309
+ - Help goes in `setHelp()`, a `help-block` or an `infoblock`, never as bare text in a panel.
310
+ - Dependent fields hide with `pfSenseHelpers.js` inside `events.push`.
311
+ - No `<style>` blocks or inline styles for spacing.
@@ -22,7 +22,7 @@
22
22
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
23
23
  },
24
24
  "dependencies": {
25
- "@cbnventures/nova": "0.38.0"
25
+ "@cbnventures/nova": "0.39.0"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
@@ -23,7 +23,7 @@
23
23
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
24
24
  },
25
25
  "dependencies": {
26
- "@cbnventures/nova": "0.38.0"
26
+ "@cbnventures/nova": "0.39.0"
27
27
  },
28
28
  "devDependencies": {
29
29
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",
@@ -23,7 +23,7 @@
23
23
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
24
24
  },
25
25
  "dependencies": {
26
- "@cbnventures/nova": "0.38.0",
26
+ "@cbnventures/nova": "0.39.0",
27
27
  "astro": "[__SCAFFOLD_VERSION_ASTRO__]",
28
28
  "cookie": "[__SCAFFOLD_VERSION_COOKIE__]"
29
29
  },
@@ -24,7 +24,7 @@
24
24
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
25
25
  },
26
26
  "dependencies": {
27
- "@cbnventures/nova": "0.38.0",
27
+ "@cbnventures/nova": "0.39.0",
28
28
  "discord.js": "[__SCAFFOLD_VERSION_DISCORD_JS__]"
29
29
  },
30
30
  "devDependencies": {
@@ -24,7 +24,7 @@
24
24
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
25
25
  },
26
26
  "dependencies": {
27
- "@cbnventures/nova": "0.38.0",
27
+ "@cbnventures/nova": "0.39.0",
28
28
  "express": "[__SCAFFOLD_VERSION_EXPRESS__]"
29
29
  },
30
30
  "devDependencies": {
@@ -24,7 +24,7 @@
24
24
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
25
25
  },
26
26
  "dependencies": {
27
- "@cbnventures/nova": "0.38.0",
27
+ "@cbnventures/nova": "0.39.0",
28
28
  "next": "[__SCAFFOLD_VERSION_NEXT__]",
29
29
  "react": "[__SCAFFOLD_VERSION_REACT__]",
30
30
  "react-dom": "[__SCAFFOLD_VERSION_REACT_DOM__]"
@@ -22,7 +22,7 @@
22
22
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
23
23
  },
24
24
  "dependencies": {
25
- "@cbnventures/nova": "0.38.0"
25
+ "@cbnventures/nova": "0.39.0"
26
26
  },
27
27
  "devDependencies": {
28
28
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_22__]",
@@ -27,8 +27,8 @@
27
27
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
28
28
  },
29
29
  "dependencies": {
30
- "@cbnventures/docusaurus-preset-nova": "0.38.0",
31
- "@cbnventures/nova": "0.38.0",
30
+ "@cbnventures/docusaurus-preset-nova": "0.39.0",
31
+ "@cbnventures/nova": "0.39.0",
32
32
  "@docusaurus/core": "[__SCAFFOLD_VERSION_DOCUSAURUS__]",
33
33
  "react": "[__SCAFFOLD_VERSION_REACT__]",
34
34
  "react-dom": "[__SCAFFOLD_VERSION_REACT_DOM__]"
@@ -26,7 +26,7 @@
26
26
  },
27
27
  "dependencies": {
28
28
  "@actions/core": "[__SCAFFOLD_VERSION_ACTIONS_CORE__]",
29
- "@cbnventures/nova": "0.38.0"
29
+ "@cbnventures/nova": "0.39.0"
30
30
  },
31
31
  "devDependencies": {
32
32
  "@github/local-action": "[__SCAFFOLD_VERSION_GITHUB_LOCAL_ACTION__]",
@@ -43,7 +43,7 @@
43
43
  "node": "[__SCAFFOLD_VERSION_NODE_ENGINE__]"
44
44
  },
45
45
  "dependencies": {
46
- "@cbnventures/nova": "0.38.0"
46
+ "@cbnventures/nova": "0.39.0"
47
47
  },
48
48
  "devDependencies": {
49
49
  "@types/node": "[__SCAFFOLD_VERSION_TYPES_NODE_24__]",