@codedrifters/configulator 0.0.270 → 0.0.271

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 };
   }
@@ -28916,14 +29033,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 +29099,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 +29188,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;
@@ -30969,7 +31086,7 @@ export const collections = {
 `;
 
 // 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 +31105,7 @@ var TypeScriptConfig = class extends Component19 {
         ...tsPaths,
         [dep.name]: [
           ensureRelativePathStartsWithDot(
-            relative4(project.outdir, subproject.outdir)
+            relative5(project.outdir, subproject.outdir)
           )
         ]
       };
@@ -31139,6 +31256,7 @@ export {
   customerProfileBundle,
   docsSyncBundle,
   extractApiProcedure,
+  extractDocReferences,
   formatLayoutViolation,
   formatStarlightSingletonViolation,
   getLatestEligibleVersion,