sourcey 3.3.6 → 3.3.8

package/dist/core/markdown-loader.d.ts

@@ -20,7 +20,10 @@ export type { PageHeading } from "../utils/markdown.js";
 export declare function loadMarkdownPage(filePath: string, slug: string): Promise<MarkdownPage>;
 /**
  * Derive a URL slug from a file path.
- * "docs/getting-started.md" → "getting-started"
+ * Preserves directory structure to avoid collisions:
+ * "getting-started.md" → "getting-started"
+ * "run/index.md"       → "run/index"
+ * "run/install.md"     → "run/install"
  */
 export declare function slugFromPath(filePath: string): string;
 //# sourceMappingURL=markdown-loader.d.ts.map

package/dist/core/markdown-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-loader.d.ts","sourceRoot":"","sources":["../../src/core/markdown-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMzF,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAwTxD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"markdown-loader.d.ts","sourceRoot":"","sources":["../../src/core/markdown-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMzF,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAwTxD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAUD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/core/markdown-loader.js

@@ -252,8 +252,13 @@ function extractFirstHeading(md) {
 }
 /**
  * Derive a URL slug from a file path.
- * "docs/getting-started.md" → "getting-started"
+ * Preserves directory structure to avoid collisions:
+ * "getting-started.md" → "getting-started"
+ * "run/index.md"       → "run/index"
+ * "run/install.md"     → "run/install"
  */
 export function slugFromPath(filePath) {
-    return htmlId(basename(filePath, extname(filePath)));
+    const ext = extname(filePath);
+    const stripped = ext ? filePath.slice(0, -ext.length) : filePath;
+    return stripped.split("/").map((s) => htmlId(s)).join("/");
 }

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.8",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {