sourcey 3.3.6 → 3.3.7

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAc/D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0G5F;AA2ID,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAc/D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0G5F;AAgKD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { readFile } from "node:fs/promises";
-import { resolve, extname } from "node:path";
+import { resolve, extname, posix } from "node:path";
 import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.js";
@@ -99,7 +99,7 @@ export async function buildSiteDocs(options = {}) {
     // Resolve internal links in markdown pages.
     // Builds a map from every plausible href to the correct output path,
     // then rewrites matching href attributes in each page's HTML.
-    resolveInternalLinks(sitePages);
+    resolveInternalLinks(sitePages, config);
     // Build search index
     const markdownPagesByTab = new Map();
     for (const tab of tabs) {
@@ -192,7 +192,7 @@ async function resolveAssetUrl(pathOrUrl) {
  * rewrites matching href values so they resolve on static file servers
  * that don't support extensionless URLs.
  */
-function resolveInternalLinks(pages) {
+function resolveInternalLinks(pages, config) {
     // Build a map from every plausible clean path to the output path.
     // e.g. "components" -> "components.html", "config/ref-theme-tokens" -> "config/ref-theme-tokens.html"
     const pathMap = new Map();
@@ -201,6 +201,10 @@ function resolveInternalLinks(pages) {
         const clean = out.replace(/\.html$/, ""); // "components" or "config/ref-theme-tokens"
         pathMap.set(clean, out);
     }
+    // Repo source link base: e.g. "https://github.com/user/repo/tree/main"
+    const repoBase = config.repo?.replace(/\/$/, "");
+    const branch = config.editBranch;
+    const sourceBase = repoBase && branch ? `${repoBase}/tree/${branch}` : undefined;
     for (const page of pages) {
         if (page.currentPage.kind !== "markdown" || !page.currentPage.markdown)
             continue;
@@ -218,8 +222,8 @@ function resolveInternalLinks(pages) {
             // Split off hash fragment
             const [path, hash] = href.split("#", 2);
             const hashSuffix = hash ? `#${hash}` : "";
-            // Normalize: strip leading slash, trailing slash
-            const clean = path.replace(/^\/+/, "").replace(/\/+$/, "");
+            // Normalize: strip leading slash, trailing slash, and .md extension
+            const clean = path.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.md$/, "");
             // Skip if already has .html extension
             if (clean.endsWith(".html"))
                 return _match;
@@ -235,11 +239,25 @@ function resolveInternalLinks(pages) {
                     break;
                 candidate = candidate.substring(slash + 1);
             }
-            if (!target)
-                return _match;
-            // Build relative path from this page to the target
-            const relativePath = toRoot + target;
-            return `href="${relativePath}${hashSuffix}"`;
+            if (target) {
+                // Build relative path from this page to the target
+                const relativePath = toRoot + target;
+                return `href="${relativePath}${hashSuffix}"`;
+            }
+            // If the link contains ../ and we have a repo URL configured,
+            // resolve it relative to the markdown source file. Links to docs
+            // pages are already handled above (pathMap lookup catches them after
+            // .md stripping and prefix stripping). What remains are links to
+            // repo source code outside the docs directory.
+            if (sourceBase && href.includes("../") && md.sourcePath) {
+                const sourceDir = posix.dirname(md.sourcePath);
+                const resolved = posix.normalize(posix.join(sourceDir, path));
+                // Only rewrite if the path stays inside the repo root
+                if (!resolved.startsWith("..")) {
+                    return `href="${sourceBase}/${resolved}${hashSuffix}"`;
+                }
+            }
+            return _match;
         });
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.3.6",
+  "version": "3.3.7",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {