@codedrifters/configulator 0.0.270 → 0.0.272

package/lib/index.mjs

@@ -26530,8 +26530,8 @@ var FALLBACKS = {
   monorepoLayoutSeedBlock: ""
 };
 var TEMPLATE_RE = /\{\{(\w+(?:\.\w+)*)\}\}/g;
-function getNestedValue(obj, path3) {
-  const parts = path3.split(".");
+function getNestedValue(obj, path4) {
+  const parts = path4.split(".");
   let current = obj;
   for (const part of parts) {
     if (current == null || typeof current !== "object") {
@@ -26757,20 +26757,20 @@ var ClaudeRenderer = class _ClaudeRenderer {
       obj.excludedCommands = [...sandbox.excludedCommands];
     }
     if (sandbox.filesystem) {
-      const fs = {};
+      const fs2 = {};
       if (sandbox.filesystem.allowRead?.length) {
-        fs.allowRead = [...sandbox.filesystem.allowRead];
+        fs2.allowRead = [...sandbox.filesystem.allowRead];
       }
       if (sandbox.filesystem.denyRead?.length) {
-        fs.denyRead = [...sandbox.filesystem.denyRead];
+        fs2.denyRead = [...sandbox.filesystem.denyRead];
       }
       if (sandbox.filesystem.allowWrite?.length) {
-        fs.allowWrite = [...sandbox.filesystem.allowWrite];
+        fs2.allowWrite = [...sandbox.filesystem.allowWrite];
       }
       if (sandbox.filesystem.denyWrite?.length) {
-        fs.denyWrite = [...sandbox.filesystem.denyWrite];
+        fs2.denyWrite = [...sandbox.filesystem.denyWrite];
       }
-      if (Object.keys(fs).length > 0) obj.filesystem = fs;
+      if (Object.keys(fs2).length > 0) obj.filesystem = fs2;
     }
     if (sandbox.network) {
       const net = {};
@@ -28515,8 +28515,125 @@ var AwsDeploymentTarget = class _AwsDeploymentTarget extends Component12 {
   }
 };
 
-// src/docs-sync/tsdoc-coverage/coverage.ts
+// src/docs-sync/reference-extraction/extraction.ts
+import * as fs from "fs";
 import * as path2 from "path";
+import { fromMarkdown } from "mdast-util-from-markdown";
+var DEFAULT_DOCS_ROOT = "docs/src/content/docs";
+var DEFAULT_SYMBOL_PATTERN = /^(?:[a-z][a-zA-Z0-9]*|[A-Z][a-zA-Z0-9]*|[A-Z][A-Z0-9_]*)$/;
+function extractDocReferences(options = {}) {
+  const docsRoot = path2.resolve(options.docsRoot ?? DEFAULT_DOCS_ROOT);
+  const symbolPattern = options.symbolPattern ?? DEFAULT_SYMBOL_PATTERN;
+  const knownSymbols = new Set(options.knownSymbols ?? []);
+  if (!fs.existsSync(docsRoot)) {
+    return [];
+  }
+  const records = [];
+  for (const absolutePath of walkMarkdownFiles(docsRoot)) {
+    const docPath = toPosix(path2.relative(docsRoot, absolutePath));
+    const source = fs.readFileSync(absolutePath, "utf-8");
+    const tree = fromMarkdown(stripYamlFrontmatter(source));
+    collectInlineCode(tree, (symbol, position) => {
+      if (!symbolPattern.test(symbol)) {
+        return;
+      }
+      records.push({
+        docPath,
+        line: position.line,
+        column: position.column,
+        symbol,
+        isKnown: knownSymbols.has(symbol)
+      });
+    });
+  }
+  records.sort((a, b) => {
+    if (a.docPath !== b.docPath) {
+      return a.docPath.localeCompare(b.docPath);
+    }
+    if (a.line !== b.line) {
+      return a.line - b.line;
+    }
+    if (a.column !== b.column) {
+      return a.column - b.column;
+    }
+    return a.symbol.localeCompare(b.symbol);
+  });
+  return records;
+}
+function walkMarkdownFiles(root) {
+  const out = [];
+  const stack = [root];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const full = path2.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(full);
+      } else if (entry.isFile() && full.toLowerCase().endsWith(".md")) {
+        out.push(full);
+      }
+    }
+  }
+  out.sort();
+  return out;
+}
+function collectInlineCode(tree, visit) {
+  walk(tree);
+  function walk(node) {
+    if (node.type === "inlineCode") {
+      const start = node.position?.start;
+      if (!start) {
+        return;
+      }
+      visit(node.value, { line: start.line, column: start.column });
+      return;
+    }
+    if (node.type === "code" || node.type === "html") {
+      return;
+    }
+    const parent = node;
+    if (Array.isArray(parent.children)) {
+      for (const child of parent.children) {
+        walk(child);
+      }
+    }
+  }
+}
+function toPosix(p) {
+  return p.split(path2.sep).join("/");
+}
+function stripYamlFrontmatter(source) {
+  if (!source.startsWith("---")) {
+    return source;
+  }
+  const lines = source.split("\n");
+  if (lines[0] !== "---") {
+    return source;
+  }
+  let endIndex = -1;
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i] === "---") {
+      endIndex = i;
+      break;
+    }
+  }
+  if (endIndex < 0) {
+    return source;
+  }
+  for (let i = 0; i <= endIndex; i++) {
+    lines[i] = "";
+  }
+  return lines.join("\n");
+}
+
+// src/docs-sync/tsdoc-coverage/coverage.ts
+import * as path3 from "path";
 import { TSDocParser } from "@microsoft/tsdoc";
 import * as ts from "typescript";
 var TsDocCoverageKind = {
@@ -28534,8 +28651,8 @@ var DEFAULT_THIN_SUMMARY_WORD_THRESHOLD = 4;
 var DEFAULT_ENTRY_POINT = "src/index.ts";
 function analyzeTsDocCoverage(options) {
   const resolvedOptions = typeof options === "string" ? { packageRoot: options } : options;
-  const packageRoot = path2.resolve(resolvedOptions.packageRoot);
-  const entryPoint = path2.resolve(
+  const packageRoot = path3.resolve(resolvedOptions.packageRoot);
+  const entryPoint = path3.resolve(
     packageRoot,
     resolvedOptions.entryPoint ?? DEFAULT_ENTRY_POINT
   );
@@ -28598,7 +28715,7 @@ function analyzeTsDocCoverage(options) {
 }
 function resolveCompilerOptions(packageRoot, tsconfigPath) {
   if (tsconfigPath) {
-    const absoluteTsconfig = path2.resolve(packageRoot, tsconfigPath);
+    const absoluteTsconfig = path3.resolve(packageRoot, tsconfigPath);
     const configFile = ts.readConfigFile(absoluteTsconfig, ts.sys.readFile);
     if (configFile.error) {
       throw new Error(
@@ -28608,7 +28725,7 @@ function resolveCompilerOptions(packageRoot, tsconfigPath) {
     const parsed = ts.parseJsonConfigFileContent(
       configFile.config,
       ts.sys,
-      path2.dirname(absoluteTsconfig)
+      path3.dirname(absoluteTsconfig)
     );
     return { ...parsed.options, noEmit: true };
   }
@@ -28895,6 +29012,7 @@ var JsiiFaker = class _JsiiFaker extends Component13 {
 
 // src/projects/astro-project.ts
 import { SampleFile as SampleFile2 } from "projen";
+import { merge as merge3 } from "ts-deepmerge";
 
 // src/projects/monorepo-layout.ts
 var MONOREPO_LAYOUT = {
@@ -28916,14 +29034,14 @@ var LAYOUT_ROOT_BY_PROJECT_TYPE = {
 };
 function validateMonorepoLayout(root) {
   const violations = [];
-  const rootOutdir = toPosix(root.outdir);
+  const rootOutdir = toPosix2(root.outdir);
   for (const sub of root.subprojects) {
     const className = sub.constructor.name;
     const expectedRoot = expectedRootFor(sub, className);
     if (expectedRoot === void 0) {
       continue;
     }
-    const relOutdir = relativeOutdir(rootOutdir, toPosix(sub.outdir));
+    const relOutdir = relativeOutdir(rootOutdir, toPosix2(sub.outdir));
     if (!outdirMatchesRoot(relOutdir, expectedRoot)) {
       violations.push({
         projectName: sub.name,
@@ -28982,7 +29100,7 @@ function outdirMatchesRoot(relOutdir, expectedRoot) {
   }
   return segments.length >= 2;
 }
-function toPosix(p) {
+function toPosix2(p) {
   return p.replace(/\\/g, "/");
 }
 function relativeOutdir(rootOutdir, subOutdir) {
@@ -29071,8 +29189,8 @@ var ResetTask = class _ResetTask extends Component14 {
     const resetTask = this.project.tasks.addTask(this.taskName, {
       description: "Delete build artifacts specified by pathsToRemove option, or artifactsDirectory if pathsToRemove is empty"
     });
-    this.pathsToRemove.forEach((path3) => {
-      resetTask.exec(`[ -e "${path3}" ] && rm -rf ${path3} || true`);
+    this.pathsToRemove.forEach((path4) => {
+      resetTask.exec(`[ -e "${path4}" ] && rm -rf ${path4} || true`);
     });
     const rootHasTurbo = TurboRepo.of(this.project.root) !== void 0;
     const isSubproject = this.project !== this.project.root;
@@ -30088,20 +30206,27 @@ var TypeScriptProject = class extends typescript.TypeScriptProject {
 var AstroProject = class extends TypeScriptProject {
   constructor(userOptions) {
     const resolvedOutdir = userOptions.outdir ?? resolveAstroProjectOutdir(userOptions.packageName ?? userOptions.name);
-    const options = {
+    const defaultOptions = {
       testRunner: TestRunner.VITEST,
       // Astro sites don't expose a library API surface — skip the
       // `@microsoft/api-extractor` wiring the TypeScriptProject base adds
       // by default. Callers can opt in with `apiExtractor: { ... }` if a
       // given site genuinely ships typed re-exports.
       apiExtractor: false,
-      ...userOptions,
-      outdir: resolvedOutdir,
+      tsconfig: {
+        compilerOptions: {
+          declaration: false
+        }
+      },
       depsUpgradeOptions: {
-        ...userOptions.depsUpgradeOptions,
-        exclude: [...userOptions.depsUpgradeOptions?.exclude ?? [], "astro"]
+        exclude: ["astro"]
       }
     };
+    const merged = merge3(defaultOptions, userOptions);
+    const options = {
+      ...merged,
+      outdir: resolvedOutdir
+    };
     super(options);
     const astroVersion = options.astroVersion ?? VERSION.ASTRO_VERSION;
     const astroTsconfigExtends = options.astroTsconfigExtends ?? "astro/tsconfigs/strict";
@@ -30153,6 +30278,9 @@ var AstroProject = class extends TypeScriptProject {
       parser: "astro-eslint-parser"
     });
     this.eslint?.addLintPattern("src/**/*.astro");
+    this.eslint?.addRules({
+      "import/no-unresolved": ["error", { ignore: ["^astro:"] }]
+    });
     this.gitignore.addPatterns(".astro", ".vercel", ".netlify");
     const turbo = TurboRepo.of(this);
     if (turbo?.compileTask) {
@@ -30202,7 +30330,7 @@ import {
   UpgradeDependenciesSchedule as UpgradeDependenciesSchedule3
 } from "projen/lib/javascript";
 import { ReleaseTrigger as ReleaseTrigger2 } from "projen/lib/release";
-import { merge as merge3 } from "ts-deepmerge";
+import { merge as merge4 } from "ts-deepmerge";
 
 // src/workflows/aws-deploy-workflow.ts
 var import_utils11 = __toESM(require_lib());
@@ -30772,7 +30900,7 @@ var AwsCdkProject = class extends awscdk.AwsCdkTypeScriptApp {
         paths: [`${resolvedOutdir}/src/**`, `${resolvedOutdir}/package.json`]
       })
     };
-    const options = merge3(defaultOptions, userOptions);
+    const options = merge4(defaultOptions, userOptions);
     super(options);
     this.addDevDeps("@types/node@catalog:");
     this.tsconfig?.addExclude("**/*.test.*");
@@ -30844,7 +30972,7 @@ var AwsCdkProject = class extends awscdk.AwsCdkTypeScriptApp {
         ]
       };
       const userResetTaskOptions = options.resetTaskOptions ?? {};
-      const resetTaskOptions = merge3(
+      const resetTaskOptions = merge4(
         defaultResetTaskOptions,
         {
           ...userResetTaskOptions,
@@ -30921,7 +31049,7 @@ var StarlightProject = class extends AstroProject {
       new SampleFile3(this, "src/content/docs/index.mdx", {
         contents: DEFAULT_INDEX_MDX
       });
-      new SampleFile3(this, "src/content/config.ts", {
+      new SampleFile3(this, "src/content.config.ts", {
         contents: DEFAULT_CONTENT_CONFIG_TS
       });
     }
@@ -30961,15 +31089,16 @@ description: Starlight-powered documentation site.
 Edit \`src/content/docs/index.mdx\` to replace this page.
 `;
 var DEFAULT_CONTENT_CONFIG_TS = `import { defineCollection } from "astro:content";
+import { docsLoader } from "@astrojs/starlight/loaders";
 import { docsSchema } from "@astrojs/starlight/schema";
 
 export const collections = {
-  docs: defineCollection({ schema: docsSchema() }),
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
 };
 `;
 
 // src/typescript/typescript-config.ts
-import { relative as relative4 } from "path";
+import { relative as relative5 } from "path";
 import { Component as Component19 } from "projen";
 import { ensureRelativePathStartsWithDot } from "projen/lib/util/path";
 var TypeScriptConfig = class extends Component19 {
@@ -30988,7 +31117,7 @@ var TypeScriptConfig = class extends Component19 {
         ...tsPaths,
         [dep.name]: [
           ensureRelativePathStartsWithDot(
-            relative4(project.outdir, subproject.outdir)
+            relative5(project.outdir, subproject.outdir)
           )
         ]
       };
@@ -31139,6 +31268,7 @@ export {
   customerProfileBundle,
   docsSyncBundle,
   extractApiProcedure,
+  extractDocReferences,
   formatLayoutViolation,
   formatStarlightSingletonViolation,
   getLatestEligibleVersion,