@theholocron/holocron-config 7.26.0 → 7.27.0

package/README.md

@@ -40,3 +40,49 @@ export default defineConfig({
 | `providers` | `source: "github"`, `ci: "github"`, `issues: ["github", { labels: … }]`                              |
 
 Everything else — `name`, `repo.name`, `repo.topics`, and any per-repo workflow overrides (e.g. `release`) — stays in the consuming repo's config.
+
+## Presets
+
+### `nodeDocs()`
+
+Extends `node()` for repos that publish a documentation site and deploy Cloudflare Pages previews on PRs.
+
+```ts
+import { defineConfig } from "@theholocron/cli";
+import { nodeDocs } from "@theholocron/holocron-config";
+
+const { repo, workflows, providers, org, domain, docs } = nodeDocs();
+export default defineConfig({
+  description: "...",
+  homepage: "https://docs.theholocron.dev/my-lib/",
+  org,
+  domain,
+  docs,
+  repo: {
+    ...repo,
+    name: "theholocron/my-lib",
+    topics: ["typescript"],
+    requiredChecks: [...repo.requiredChecks, "codecov/patch/my-package", "codecov/project/my-package"],
+  },
+  workflows: [...workflows, "audit", { name: "release", with: { "run-build": true } }, "sync"],
+  providers: { ...providers, secrets: "github" },
+});
+```
+
+Adds on top of `node()`:
+
+| Fragment               | Contents                                                                                                                                 |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `org`                  | `"theholocron"`                                                                                                                          |
+| `domain`               | `"theholocron.dev"`                                                                                                                      |
+| `docs`                 | `{ build: "workflow", https: true }`                                                                                                     |
+| `providers.deployment` | `["cloudflare", { accountId: "9c558af98664d13fc89b7e0a0d93d5a8" }]`                                                                      |
+| `providers.dns`        | `"cloudflare"`                                                                                                                           |
+| `workflows`            | adds `{ name: "deploy", with: { docs: true, preview: true } }`                                                                           |
+| `repo.requiredChecks`  | `"Lint / Conclusion"`, `"Test / Conclusion"`, `"Typecheck / Conclusion"`, `"audit / Conclusion"`, `"codecov/patch"`, `"codecov/project"` |
+
+Per-repo extends `requiredChecks` with its own `codecov/patch/<package>` entries.
+
+### `nextjs()` · `react()` · `monorepo(base)`
+
+See [`.notes/preset-system.md`](../../.notes/preset-system.md) for the full preset hierarchy and usage examples for browser app repos.

package/dist/configs/nextjs.d.ts

@@ -1,29 +1,37 @@
 import { HolocronPreset } from "./node.js";
 //#region configs/nextjs.d.ts
+interface NextjsOptions {
+  /** Extra `with:` inputs merged into the `test` workflow entry (e.g. wait-on-url, run-chromatic). */
+  test?: Record<string, unknown>;
+}
 /**
  * Preset for single-package Next.js application repos. Includes Vercel
  * deployment, Lighthouse audit, Storybook + interaction + user-flow tests,
- * and the Conclusion required checks. Per-repo still provides: chromatic
- * project config, wait-on-url, storybook deploy config, sync workflow.
+ * and the Conclusion required checks.
+ *
+ * Pass `test` overrides to merge repo-specific options (e.g. `wait-on-url`,
+ * `run-chromatic`) into the single test workflow entry so the sync tool sees
+ * one complete entry rather than two conflicting ones.
  *
  * @example
- * const { repo, workflows, providers, org, domain } = nextjs();
+ * const { repo, workflows, providers, org, domain } = nextjs({
+ *   test: { "wait-on-url": "http://localhost:3000", "run-chromatic": true },
+ * });
  * export default defineConfig({
  *   org,
  *   domain,
  *   repo: { ...repo, name: "theholocron/my-app", topics: ["nextjs"] },
  *   workflows: [
  *     ...workflows,
- *     { name: "test", with: { "run-chromatic": true, "wait-on-url": "http://localhost:3000" } },
  *     "sync",
  *     { name: "deploy", with: { docs: true, storybook: [{ name: "" }] } },
  *   ],
  *   providers,
  * });
  */
-declare function nextjs(): HolocronPreset & {
+declare function nextjs({ test: testOverrides }?: NextjsOptions): HolocronPreset & {
   org: string;
   domain: string;
 };
 //#endregion
-export { nextjs };
+export { NextjsOptions, nextjs };

package/dist/configs/nextjs.js

@@ -15,25 +15,29 @@ const REQUIRED_CHECKS = [
 /**
 * Preset for single-package Next.js application repos. Includes Vercel
 * deployment, Lighthouse audit, Storybook + interaction + user-flow tests,
-* and the Conclusion required checks. Per-repo still provides: chromatic
-* project config, wait-on-url, storybook deploy config, sync workflow.
+* and the Conclusion required checks.
+*
+* Pass `test` overrides to merge repo-specific options (e.g. `wait-on-url`,
+* `run-chromatic`) into the single test workflow entry so the sync tool sees
+* one complete entry rather than two conflicting ones.
 *
 * @example
-* const { repo, workflows, providers, org, domain } = nextjs();
+* const { repo, workflows, providers, org, domain } = nextjs({
+*   test: { "wait-on-url": "http://localhost:3000", "run-chromatic": true },
+* });
 * export default defineConfig({
 *   org,
 *   domain,
 *   repo: { ...repo, name: "theholocron/my-app", topics: ["nextjs"] },
 *   workflows: [
 *     ...workflows,
-*     { name: "test", with: { "run-chromatic": true, "wait-on-url": "http://localhost:3000" } },
 *     "sync",
 *     { name: "deploy", with: { docs: true, storybook: [{ name: "" }] } },
 *   ],
 *   providers,
 * });
 */
-function nextjs() {
+function nextjs({ test: testOverrides = {} } = {}) {
 	const base = node();
 	return {
 		...base,
@@ -69,7 +73,8 @@ function nextjs() {
 					"run-unit": false,
 					"run-storybook": true,
 					"run-interaction": true,
-					"run-user-flow": true
+					"run-user-flow": true,
+					...testOverrides
 				}
 			}
 		]

package/dist/configs/node-docs.js

@@ -43,7 +43,7 @@ function nodeDocs() {
 		},
 		providers: {
 			...base.providers,
-			deployment: "cloudflare",
+			deployment: ["cloudflare", { accountId: "9c558af98664d13fc89b7e0a0d93d5a8" }],
 			dns: "cloudflare"
 		},
 		repo: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-config",
-  "version": "7.26.0",
+  "version": "7.27.0",
   "description": "Shareable holocron configuration presets for theholocron repositories.",
   "homepage": "https://github.com/theholocron/configs/tree/main/packages/holocron-config#readme",
   "bugs": "https://github.com/theholocron/configs/issues",
@@ -18,13 +18,13 @@
   ],
   "type": "module",
   "devDependencies": {
-    "@theholocron/cli": "^3.17.0",
+    "@theholocron/cli": "^3.37.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
     "@vitest/coverage-v8": "^4.1.10",
-    "@theholocron/tsconfig": "7.26.0",
-    "@theholocron/vitest-config": "7.26.0"
+    "@theholocron/vitest-config": "7.27.0",
+    "@theholocron/tsconfig": "7.27.0"
   },
   "peerDependencies": {
     "@theholocron/cli": ">=2.0.0-alpha.1"