@theholocron/holocron-config 7.25.5 → 7.26.0

package/dist/configs/monorepo.d.ts

@@ -0,0 +1,28 @@
+import { HolocronPreset } from "./node.js";
+//#region configs/monorepo.d.ts
+/**
+ * Extension that wraps any base preset with monorepo-specific overrides.
+ * Not a standalone preset — always takes a base (e.g. `monorepo(nextjs())`).
+ *
+ * Overrides: `uses_external_packages: true` (workspaces pull in many deps).
+ * Per-repo still provides: storybook-projects array, chromatic project
+ * definitions, workspace-specific required checks.
+ *
+ * @example
+ * const { repo, workflows, providers, org, domain } = monorepo(nextjs());
+ * export default defineConfig({
+ *   org,
+ *   domain,
+ *   repo: { ...repo, name: "theholocron/my-monorepo" },
+ *   workflows: [
+ *     ...workflows,
+ *     { name: "test", with: { "run-chromatic": { projects: [{ tokenName: "WEB", workingDir: "apps/web" }] } } },
+ *     "sync",
+ *     { name: "deploy", with: { docs: true, "storybook-projects": [{ name: "web", workingDir: "apps/web" }] } },
+ *   ],
+ *   providers,
+ * });
+ */
+declare function monorepo<T extends HolocronPreset>(base: T): T;
+//#endregion
+export { monorepo };

package/dist/configs/monorepo.js

@@ -0,0 +1,38 @@
+//#region configs/monorepo.ts
+/**
+* Extension that wraps any base preset with monorepo-specific overrides.
+* Not a standalone preset — always takes a base (e.g. `monorepo(nextjs())`).
+*
+* Overrides: `uses_external_packages: true` (workspaces pull in many deps).
+* Per-repo still provides: storybook-projects array, chromatic project
+* definitions, workspace-specific required checks.
+*
+* @example
+* const { repo, workflows, providers, org, domain } = monorepo(nextjs());
+* export default defineConfig({
+*   org,
+*   domain,
+*   repo: { ...repo, name: "theholocron/my-monorepo" },
+*   workflows: [
+*     ...workflows,
+*     { name: "test", with: { "run-chromatic": { projects: [{ tokenName: "WEB", workingDir: "apps/web" }] } } },
+*     "sync",
+*     { name: "deploy", with: { docs: true, "storybook-projects": [{ name: "web", workingDir: "apps/web" }] } },
+*   ],
+*   providers,
+* });
+*/
+function monorepo(base) {
+	return {
+		...base,
+		repo: {
+			...base.repo,
+			properties: {
+				...base.repo.properties,
+				uses_external_packages: true
+			}
+		}
+	};
+}
+//#endregion
+export { monorepo };

package/dist/configs/nextjs.d.ts

@@ -0,0 +1,29 @@
+import { HolocronPreset } from "./node.js";
+//#region configs/nextjs.d.ts
+/**
+ * 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.
+ *
+ * @example
+ * const { repo, workflows, providers, org, domain } = nextjs();
+ * 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 & {
+  org: string;
+  domain: string;
+};
+//#endregion
+export { nextjs };

package/dist/configs/nextjs.js

@@ -0,0 +1,79 @@
+import { node } from "./node.js";
+//#region configs/nextjs.ts
+const REQUIRED_CHECKS = [
+	"Lint / Conclusion",
+	"Test / Conclusion",
+	"Typecheck / Conclusion",
+	"audit / Conclusion",
+	"codecov/patch",
+	"codecov/project",
+	"Storybook Publish",
+	"UI Review",
+	"UI Tests",
+	"lhci/url/"
+];
+/**
+* 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.
+*
+* @example
+* const { repo, workflows, providers, org, domain } = nextjs();
+* 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() {
+	const base = node();
+	return {
+		...base,
+		org: "theholocron",
+		domain: "theholocron.dev",
+		providers: {
+			...base.providers,
+			deployment: "vercel",
+			secrets: "github"
+		},
+		repo: {
+			...base.repo,
+			properties: {
+				...base.repo.properties,
+				runtime_environment: "browser",
+				uses_external_packages: false
+			},
+			requiredChecks: REQUIRED_CHECKS
+		},
+		workflows: [
+			...base.workflows,
+			{
+				name: "audit",
+				with: {
+					"run-knip": true,
+					"run-performance": true,
+					"lighthouse-config": "lighthouse.config.cjs"
+				}
+			},
+			{
+				name: "test",
+				with: {
+					"run-unit": false,
+					"run-storybook": true,
+					"run-interaction": true,
+					"run-user-flow": true
+				}
+			}
+		]
+	};
+}
+//#endregion
+export { nextjs };

package/dist/configs/node-docs.d.ts

@@ -0,0 +1,37 @@
+import { HolocronPreset } from "./node.js";
+import { HolocronConfig } from "@theholocron/cli";
+//#region configs/node-docs.d.ts
+interface NodeDocsPreset extends HolocronPreset {
+  org: string;
+  domain: string;
+  docs: NonNullable<HolocronConfig["docs"]>;
+  repo: HolocronPreset["repo"] & {
+    requiredChecks: string[];
+  };
+}
+/**
+ * Extends `node()` for repos that publish a documentation site and deploy
+ * previews via Cloudflare Pages. Adds org/domain, Cloudflare providers,
+ * deploy+preview workflow, and the Conclusion required checks.
+ *
+ * @example
+ * 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-pkg"],
+ *   },
+ *   workflows: [...workflows, "audit", { name: "release", with: { "run-build": true } }, "sync"],
+ *   providers: { ...providers, secrets: "github" },
+ * });
+ */
+declare function nodeDocs(): NodeDocsPreset;
+//#endregion
+export { NodeDocsPreset, nodeDocs };

package/dist/configs/node-docs.js

@@ -0,0 +1,63 @@
+import { node } from "./node.js";
+//#region configs/node-docs.ts
+const REQUIRED_CHECKS = [
+	"Lint / Conclusion",
+	"Test / Conclusion",
+	"Typecheck / Conclusion",
+	"audit / Conclusion",
+	"codecov/patch",
+	"codecov/project"
+];
+/**
+* Extends `node()` for repos that publish a documentation site and deploy
+* previews via Cloudflare Pages. Adds org/domain, Cloudflare providers,
+* deploy+preview workflow, and the Conclusion required checks.
+*
+* @example
+* 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-pkg"],
+*   },
+*   workflows: [...workflows, "audit", { name: "release", with: { "run-build": true } }, "sync"],
+*   providers: { ...providers, secrets: "github" },
+* });
+*/
+function nodeDocs() {
+	const base = node();
+	return {
+		...base,
+		org: "theholocron",
+		domain: "theholocron.dev",
+		docs: {
+			build: "workflow",
+			https: true
+		},
+		providers: {
+			...base.providers,
+			deployment: "cloudflare",
+			dns: "cloudflare"
+		},
+		repo: {
+			...base.repo,
+			requiredChecks: REQUIRED_CHECKS
+		},
+		workflows: [...base.workflows, {
+			name: "deploy",
+			with: {
+				docs: true,
+				preview: true
+			}
+		}]
+	};
+}
+//#endregion
+export { nodeDocs };

package/dist/configs/node.d.ts

@@ -2,8 +2,13 @@ import { HolocronConfig, RepoConfig } from "@theholocron/cli";
 //#region configs/node.d.ts
 interface HolocronPreset {
   providers: HolocronConfig["providers"];
-  repo: Omit<RepoConfig, "name" | "requiredChecks">;
+  repo: Omit<RepoConfig, "name"> & {
+    requiredChecks?: string[];
+  };
   workflows: NonNullable<HolocronConfig["workflows"]>;
+  org?: string;
+  domain?: string;
+  docs?: HolocronConfig["docs"];
 }
 /**
  * Shared defaults for theholocron Node.js repositories.

package/dist/configs/react.d.ts

@@ -0,0 +1,29 @@
+import { HolocronPreset } from "./node.js";
+//#region configs/react.d.ts
+/**
+ * Preset for single-package React/Vite application repos. Identical to
+ * `nextjs()` except: no Vercel deployment (deploy target is per-repo) and
+ * no `run-user-flow` (Cypress not assumed). Per-repo still provides: chromatic
+ * project config, storybook deploy config, sync workflow.
+ *
+ * @example
+ * const { repo, workflows, providers, org, domain } = react();
+ * export default defineConfig({
+ *   org,
+ *   domain,
+ *   repo: { ...repo, name: "theholocron/my-app", topics: ["react", "vite"] },
+ *   workflows: [
+ *     ...workflows,
+ *     { name: "test", with: { "run-chromatic": { projects: [{ tokenName: "default", workingDir: ".", buildScript: "build:storybook:chromatic" }] } } },
+ *     "sync",
+ *     { name: "deploy", with: { docs: true, storybook: [{ name: "" }] } },
+ *   ],
+ *   providers,
+ * });
+ */
+declare function react(): HolocronPreset & {
+  org: string;
+  domain: string;
+};
+//#endregion
+export { react };

package/dist/configs/react.js

@@ -0,0 +1,77 @@
+import { node } from "./node.js";
+//#region configs/react.ts
+const REQUIRED_CHECKS = [
+	"Lint / Conclusion",
+	"Test / Conclusion",
+	"Typecheck / Conclusion",
+	"audit / Conclusion",
+	"codecov/patch",
+	"codecov/project",
+	"Storybook Publish",
+	"UI Review",
+	"UI Tests",
+	"lhci/url/"
+];
+/**
+* Preset for single-package React/Vite application repos. Identical to
+* `nextjs()` except: no Vercel deployment (deploy target is per-repo) and
+* no `run-user-flow` (Cypress not assumed). Per-repo still provides: chromatic
+* project config, storybook deploy config, sync workflow.
+*
+* @example
+* const { repo, workflows, providers, org, domain } = react();
+* export default defineConfig({
+*   org,
+*   domain,
+*   repo: { ...repo, name: "theholocron/my-app", topics: ["react", "vite"] },
+*   workflows: [
+*     ...workflows,
+*     { name: "test", with: { "run-chromatic": { projects: [{ tokenName: "default", workingDir: ".", buildScript: "build:storybook:chromatic" }] } } },
+*     "sync",
+*     { name: "deploy", with: { docs: true, storybook: [{ name: "" }] } },
+*   ],
+*   providers,
+* });
+*/
+function react() {
+	const base = node();
+	return {
+		...base,
+		org: "theholocron",
+		domain: "theholocron.dev",
+		providers: {
+			...base.providers,
+			secrets: "github"
+		},
+		repo: {
+			...base.repo,
+			properties: {
+				...base.repo.properties,
+				runtime_environment: "browser",
+				uses_external_packages: false
+			},
+			requiredChecks: REQUIRED_CHECKS
+		},
+		workflows: [
+			...base.workflows,
+			{
+				name: "audit",
+				with: {
+					"run-knip": true,
+					"run-performance": true,
+					"lighthouse-config": "lighthouse.config.cjs"
+				}
+			},
+			{
+				name: "test",
+				with: {
+					"run-unit": false,
+					"run-storybook": true,
+					"run-interaction": true
+				}
+			}
+		]
+	};
+}
+//#endregion
+export { react };

package/dist/index.d.ts

@@ -1,2 +1,6 @@
 import { HolocronPreset, node } from "./configs/node.js";
-export { type HolocronPreset, node };
+import { monorepo } from "./configs/monorepo.js";
+import { nextjs } from "./configs/nextjs.js";
+import { NodeDocsPreset, nodeDocs } from "./configs/node-docs.js";
+import { react } from "./configs/react.js";
+export { type HolocronPreset, type NodeDocsPreset, monorepo, nextjs, node, nodeDocs, react };

package/dist/index.js

@@ -1,2 +1,6 @@
+import { monorepo } from "./configs/monorepo.js";
 import { node } from "./configs/node.js";
-export { node };
+import { nextjs } from "./configs/nextjs.js";
+import { nodeDocs } from "./configs/node-docs.js";
+import { react } from "./configs/react.js";
+export { monorepo, nextjs, node, nodeDocs, react };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-config",
-  "version": "7.25.5",
+  "version": "7.26.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",
@@ -23,8 +23,8 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
     "@vitest/coverage-v8": "^4.1.10",
-    "@theholocron/tsconfig": "7.25.5",
-    "@theholocron/vitest-config": "7.25.5"
+    "@theholocron/tsconfig": "7.26.0",
+    "@theholocron/vitest-config": "7.26.0"
   },
   "peerDependencies": {
     "@theholocron/cli": ">=2.0.0-alpha.1"
@@ -40,6 +40,26 @@
       "import": "./dist/configs/node.js",
       "default": "./dist/configs/node.js"
     },
+    "./node-docs": {
+      "types": "./dist/configs/node-docs.d.ts",
+      "import": "./dist/configs/node-docs.js",
+      "default": "./dist/configs/node-docs.js"
+    },
+    "./nextjs": {
+      "types": "./dist/configs/nextjs.d.ts",
+      "import": "./dist/configs/nextjs.js",
+      "default": "./dist/configs/nextjs.js"
+    },
+    "./react": {
+      "types": "./dist/configs/react.d.ts",
+      "import": "./dist/configs/react.js",
+      "default": "./dist/configs/react.js"
+    },
+    "./monorepo": {
+      "types": "./dist/configs/monorepo.d.ts",
+      "import": "./dist/configs/monorepo.js",
+      "default": "./dist/configs/monorepo.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [