@codedrifters/configulator 0.0.243 → 0.0.244

package/lib/index.mjs

@@ -814,7 +814,12 @@ var baseBundle = {
         "- The docs site is monorepo-wide. Sub-project documentation belongs",
         "  inside that single site (under `docs/content/`), not in a per-package",
         "  `docs/` folder.",
-        "- Configulator's `StarlightProject` defaults its `outdir` to `/docs`.",
+        "- Configulator's `StarlightProject` defaults its `outdir` to `/docs` and",
+        '  its `role` to `"docs"`. A second `StarlightProject` with `role: "docs"`',
+        "  fails synth \u2014 the singleton rule is enforced at validate time.",
+        "- Additional Starlight sites (client-facing, marketing, etc.) must set",
+        '  `role: "site"`, which routes them under `sites/<scope>/<name>` just',
+        "  like a plain `AstroProject`.",
         "- `/sites` is reserved for end-user-facing web front ends (marketing",
         "  sites, SPAs, client-facing apps). It deliberately does not host the",
         "  dev-docs site.",
@@ -830,7 +835,8 @@ var baseBundle = {
         "| `TypeScriptProject` | `packages/<scope>/<name>` |",
         "| `AwsCdkProject` | `apps/<scope>/<name>` |",
         "| `AstroProject` | `sites/<scope>/<name>` |",
-        "| `StarlightProject` (role = docs) | `docs/` |",
+        "| `StarlightProject` (role = docs, default) | `docs/` |",
+        "| `StarlightProject` (role = site) | `sites/<scope>/<name>` |",
         "",
         "`<scope>` is parsed from the sub-project's package name (everything",
         "after `@` and before `/`). `<name>` is the unscoped part of the",
@@ -15574,7 +15580,7 @@ function validateMonorepoLayout(root) {
   const rootOutdir = toPosix(root.outdir);
   for (const sub of root.subprojects) {
     const className = sub.constructor.name;
-    const expectedRoot = LAYOUT_ROOT_BY_PROJECT_TYPE[className];
+    const expectedRoot = expectedRootFor(sub, className);
     if (expectedRoot === void 0) {
       continue;
     }
@@ -15590,11 +15596,40 @@ function validateMonorepoLayout(root) {
   }
   return violations;
 }
+function validateStarlightSingleton(root) {
+  const docsRoleProjects = [];
+  for (const sub of root.subprojects) {
+    if (sub.constructor.name !== "StarlightProject") {
+      continue;
+    }
+    if (getStarlightRole(sub) === "docs") {
+      docsRoleProjects.push(sub.name);
+    }
+  }
+  if (docsRoleProjects.length <= 1) {
+    return void 0;
+  }
+  return { projectNames: docsRoleProjects };
+}
+function expectedRootFor(sub, className) {
+  if (className === "StarlightProject") {
+    return getStarlightRole(sub) === "site" ? MONOREPO_LAYOUT.SITES : MONOREPO_LAYOUT.DOCS;
+  }
+  return LAYOUT_ROOT_BY_PROJECT_TYPE[className];
+}
+function getStarlightRole(sub) {
+  const role = sub.role;
+  return role === "site" ? "site" : "docs";
+}
 function formatLayoutViolation(violation) {
   const { projectName, projectType, outdir, expectedRoot } = violation;
   const expectedExample = expectedRoot === MONOREPO_LAYOUT.DOCS ? "docs/" : `${expectedRoot}/<scope>/<name>`;
   return `[monorepo-layout] ${projectType} "${projectName}" has outdir "${outdir}", which is outside the expected root "${expectedRoot}/" (expected e.g. "${expectedExample}"). See docs/requirements/architectural-decisions/ADR-006-monorepo-layout.md.`;
 }
+function formatStarlightSingletonViolation(violation) {
+  const names = violation.projectNames.map((n) => `"${n}"`).join(", ");
+  return `[monorepo-layout] Multiple StarlightProject instances with role: "docs" found (${names}). ADR-006 allows exactly one docs-role Starlight project per MonorepoProject. Either remove the duplicates or set role: "site" on the additional ones so they land under sites/. See docs/requirements/architectural-decisions/ADR-006-monorepo-layout.md.`;
+}
 function outdirMatchesRoot(relOutdir, expectedRoot) {
   const segments = relOutdir.split("/").filter((s) => s.length > 0);
   if (segments.length === 0) {
@@ -16409,10 +16444,20 @@ var MonorepoProject = class extends TypeScriptAppProject {
    * layout contract. Runs in `preSynthesize` so all sub-projects are
    * attached by the time we inspect the tree.
    *
+   * Two checks run in sequence:
+   *
+   * 1. **Outdir-vs-root validation.** Every sub-project's `outdir` must
+   *    live under the root expected for its project type (ADR-006 §4).
+   * 2. **Docs-singleton validation.** At most one `StarlightProject`
+   *    may carry `role: "docs"` (ADR-006 §3).
+   *
    * Behavior is controlled by `layoutEnforcement`:
-   * - `"off"`  — skip validation.
-   * - `"warn"` — log a `console.warn` per violation; continue.
-   * - `"error"` — throw on the first violation.
+   * - `"off"`  — skip both checks.
+   * - `"warn"` — log a `console.warn` per violation; continue. Singleton
+   *   violations also warn in this mode rather than throwing, so all
+   *   layout findings are surfaced consistently.
+   * - `"error"` — throw on the first outdir violation, or on the
+   *   singleton violation if outdir validation passed.
    */
   preSynthesize() {
     super.preSynthesize();
@@ -16420,15 +16465,22 @@ var MonorepoProject = class extends TypeScriptAppProject {
       return;
     }
     const violations = validateMonorepoLayout(this);
-    if (violations.length === 0) {
-      return;
-    }
+    const singletonViolation = validateStarlightSingleton(this);
     if (this.layoutEnforcement === LAYOUT_ENFORCEMENT.ERROR) {
-      throw new Error(formatLayoutViolation(violations[0]));
+      if (violations.length > 0) {
+        throw new Error(formatLayoutViolation(violations[0]));
+      }
+      if (singletonViolation !== void 0) {
+        throw new Error(formatStarlightSingletonViolation(singletonViolation));
+      }
+      return;
     }
     for (const violation of violations) {
       console.warn(formatLayoutViolation(violation));
     }
+    if (singletonViolation !== void 0) {
+      console.warn(formatStarlightSingletonViolation(singletonViolation));
+    }
   }
   /**
    * Allows a sub project to request installation of dependency at the Monorepo root
@@ -17429,8 +17481,13 @@ var AwsCdkProject = class extends awscdk.AwsCdkTypeScriptApp {
 
 // src/projects/starlight-project.ts
 import { SampleFile as SampleFile2 } from "projen";
+var STARLIGHT_ROLE = {
+  DOCS: "docs",
+  SITE: "site"
+};
 var StarlightProject = class extends AstroProject {
   constructor(userOptions) {
+    const role = userOptions.role ?? STARLIGHT_ROLE.DOCS;
     const starlightConfig = buildStarlightConfig(userOptions);
     const starlightSpec = {
       name: "starlight",
@@ -17438,8 +17495,10 @@ var StarlightProject = class extends AstroProject {
       defaultImport: true,
       args: JSON.stringify(starlightConfig, null, 2)
     };
+    const resolvedOutdir = userOptions.outdir ?? (role === STARLIGHT_ROLE.DOCS ? MONOREPO_LAYOUT.DOCS : void 0);
     const mergedOptions = {
       ...userOptions,
+      outdir: resolvedOutdir,
       integrations: [starlightSpec, ...userOptions.integrations ?? []],
       depsUpgradeOptions: {
         ...userOptions.depsUpgradeOptions,
@@ -17451,6 +17510,7 @@ var StarlightProject = class extends AstroProject {
       }
     };
     super(mergedOptions);
+    this.role = role;
     const starlightVersion = userOptions.starlightVersion ?? VERSION.STARLIGHT_VERSION;
     const sharpVersion = userOptions.sharpVersion ?? VERSION.SHARP_VERSION;
     this.addDeps(
@@ -17577,6 +17637,7 @@ export {
   ROOT_CI_TASK_NAME,
   ROOT_TURBO_TASK_NAME,
   ResetTask,
+  STARLIGHT_ROLE,
   StarlightProject,
   TestRunner,
   TurboRepo,
@@ -17596,6 +17657,7 @@ export {
   bcmWriterBundle,
   companyProfileBundle,
   formatLayoutViolation,
+  formatStarlightSingletonViolation,
   getLatestEligibleVersion,
   githubWorkflowBundle,
   industryDiscoveryBundle,
@@ -17622,6 +17684,7 @@ export {
   turborepoBundle,
   typescriptBundle,
   validateMonorepoLayout,
+  validateStarlightSingleton,
   vitestBundle
 };
 //# sourceMappingURL=index.mjs.map