sourcey 3.3.8 → 3.3.10

package/dist/cli.js

@@ -1,13 +1,9 @@
 #!/usr/bin/env node
 import { defineCommand, runMain } from "citty";
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
 import { buildDocs, buildSiteDocs } from "./index.js";
 import { loadConfig } from "./config.js";
 import { init } from "./init.js";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
+import pkg from "../package.json" with { type: "json" };
 const build = defineCommand({
     meta: {
         name: "build",

package/dist/components/layout/Head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAIA,wBAAgB,IAAI,iCA6EnB"}
+{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAKA,wBAAgB,IAAI,iCA8EnB"}

package/dist/components/layout/Head.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "preact/jsx-ru
 import { useContext } from "preact/hooks";
 import { SpecContext, OptionsContext, PageContext, SiteContext, NavigationContext } from "../../renderer/context.js";
 import { langIconCSS } from "../../utils/lang-icons.js";
+import pkg from "../../../package.json" with { type: "json" };
 export function Head() {
     const site = useContext(SiteContext);
     const spec = useContext(SpecContext);
@@ -51,5 +52,5 @@ export function Head() {
     body { margin: 0; background: rgb(var(--color-background-light)); }
     .dark body { background: rgb(var(--color-background-dark)); }
   `;
-    return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), _jsx("style", { dangerouslySetInnerHTML: { __html: langIconCSS() } }), site.customCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), googleFontsUrl && (_jsxs(_Fragment, { children: [_jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossOrigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: googleFontsUrl })] })), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
+    return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "generator", content: `Sourcey ${pkg.version}` }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), _jsx("style", { dangerouslySetInnerHTML: { __html: langIconCSS() } }), site.customCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), googleFontsUrl && (_jsxs(_Fragment, { children: [_jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossOrigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: googleFontsUrl })] })), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
 }

package/dist/config.d.ts

@@ -147,9 +147,15 @@ export interface ResolvedTab {
     groups?: ResolvedGroup[];
     doxygen?: ResolvedDoxygenConfig;
 }
+export interface ResolvedPage {
+    /** Original config slug (e.g. "run/index") */
+    slug: string;
+    /** Absolute filesystem path to the .md/.mdx file */
+    file: string;
+}
 export interface ResolvedGroup {
     label: string;
-    pages: string[];
+    pages: ResolvedPage[];
 }
 export declare function loadConfig(cwd?: string): Promise<ResolvedConfig>;
 /**

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -1,5 +1,5 @@
 import { access, readdir } from "node:fs/promises";
-import { resolve, dirname, basename, extname } from "node:path";
+import { resolve, relative, dirname, basename, extname } from "node:path";
 import { createJiti } from "jiti";
 export function defineConfig(config) {
     return config;
@@ -181,11 +181,14 @@ async function resolveGroups(groups, tabName, configDir) {
         for (const pageSlug of group.pages) {
             if (pageSlug.includes("*")) {
                 const expanded = await expandGlob(pageSlug, configDir);
-                pages.push(...expanded);
+                for (const file of expanded) {
+                    const rel = relative(configDir, file).replace(/\.[^.]+$/, "");
+                    pages.push({ slug: rel, file });
+                }
             }
             else {
                 const absPath = await resolvePagePath(pageSlug, configDir);
-                pages.push(absPath);
+                pages.push({ slug: pageSlug, file: absPath });
             }
         }
         resolved.push({ label: group.group, pages });

package/dist/core/doxygen-loader.js

@@ -108,18 +108,18 @@ function resolveIndexStyle(configured, groupMap, pages) {
 /**
  * Build index page HTML using sourcey's existing component markup.
  */
-function buildIndexHtml(style, tabSlug, _tabLabel, groupMap, pages) {
+function buildIndexHtml(style, _tabSlug, _tabLabel, groupMap, pages) {
     if (style === "rich")
-        return buildRichIndex(tabSlug, groupMap, pages);
+        return buildRichIndex(groupMap, pages);
     if (style === "structured")
-        return buildStructuredIndex(tabSlug, groupMap, pages);
-    return buildFlatIndex(tabSlug, groupMap);
+        return buildStructuredIndex(groupMap, pages);
+    return buildFlatIndex(groupMap);
 }
 /**
  * Rich: card grid with module name, description, and type count.
  * Uses sourcey's card-group/card-item CSS.
  */
-function buildRichIndex(tabSlug, groupMap, pages) {
+function buildRichIndex(groupMap, pages) {
     const cards = [];
     for (const [, items] of groupMap) {
         const groupEntry = items.find((i) => i.kind === "group");
@@ -129,7 +129,7 @@ function buildRichIndex(tabSlug, groupMap, pages) {
         if (!page)
             continue;
         const typeCount = items.filter((i) => i.kind !== "group" && i.kind !== "namespace").length;
-        const href = `${tabSlug}/${groupEntry.slug}.html`;
+        const href = `${groupEntry.slug}.html`;
         const desc = page.description || "";
         const meta = typeCount > 0
             ? `<p style="margin:0.5rem 0 0;font-size:0.8rem;opacity:0.5">${typeCount} type${typeCount !== 1 ? "s" : ""}</p>`
@@ -149,7 +149,7 @@ function buildRichIndex(tabSlug, groupMap, pages) {
         if (typeCount === 0)
             continue;
         const firstItem = items[0];
-        const href = `${tabSlug}/${firstItem.slug}.html`;
+        const href = `${firstItem.slug}.html`;
         cards.push(`<a href="${href}" class="card-item">` +
             `<div class="card-item-inner">` +
             `<h3 class="card-item-title">${escHtml(key)}</h3>` +
@@ -165,7 +165,7 @@ function buildRichIndex(tabSlug, groupMap, pages) {
  * Structured: grouped list of types by module/namespace.
  * Rendered as markdown headings with link lists.
  */
-function buildStructuredIndex(tabSlug, groupMap, pages) {
+function buildStructuredIndex(groupMap, pages) {
     const sections = [];
     for (const [key, items] of groupMap) {
         const groupEntry = items.find((i) => i.kind === "group");
@@ -175,10 +175,10 @@ function buildStructuredIndex(tabSlug, groupMap, pages) {
             continue;
         const links = [];
         if (groupEntry) {
-            links.push(`- [Overview](${tabSlug}/${groupEntry.slug}.html)`);
+            links.push(`- [Overview](${groupEntry.slug}.html)`);
         }
         for (const t of types) {
-            links.push(`- [${t.title}](${tabSlug}/${t.slug}.html)`);
+            links.push(`- [${t.title}](${t.slug}.html)`);
         }
         sections.push(`### ${title}\n\n${links.join("\n")}`);
     }
@@ -187,7 +187,7 @@ function buildStructuredIndex(tabSlug, groupMap, pages) {
 /**
  * Flat: alphabetical list categorized by kind.
  */
-function buildFlatIndex(tabSlug, groupMap) {
+function buildFlatIndex(groupMap) {
     const byKind = new Map();
     for (const [, items] of groupMap) {
         for (const item of items) {
@@ -202,7 +202,7 @@ function buildFlatIndex(tabSlug, groupMap) {
     const sections = [];
     for (const [label, items] of byKind) {
         const sorted = items.sort((a, b) => a.title.localeCompare(b.title));
-        const links = sorted.map((i) => `- [${i.title}](${tabSlug}/${i.slug}.html)`).join("\n");
+        const links = sorted.map((i) => `- [${i.title}](${i.slug}.html)`).join("\n");
         sections.push(`### ${label}\n\n${links}`);
     }
     return renderMarkdown(sections.join("\n\n"));

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

@@ -19,10 +19,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.
+ * Derive a URL slug from a page path.
  * Preserves directory structure to avoid collisions:
  * "getting-started.md" → "getting-started"
- * "run/index.md"       → "run/index"
+ * "run/index"          → "run/index"
  * "run/install.md"     → "run/install"
  */
 export declare function slugFromPath(filePath: string): string;

package/dist/core/markdown-loader.js

@@ -251,10 +251,10 @@ function extractFirstHeading(md) {
     return match ? match[1].trim() : undefined;
 }
 /**
- * Derive a URL slug from a file path.
+ * Derive a URL slug from a page path.
  * Preserves directory structure to avoid collisions:
  * "getting-started.md" → "getting-started"
- * "run/index.md"       → "run/index"
+ * "run/index"          → "run/index"
  * "run/install.md"     → "run/install"
  */
 export function slugFromPath(filePath) {

package/dist/core/navigation.js

@@ -63,8 +63,8 @@ export function buildNavFromPages(tab, pagesByPath) {
     if (tab.groups) {
         for (const group of tab.groups) {
             const items = [];
-            for (const pagePath of group.pages) {
-                const page = pagesByPath.get(pagePath);
+            for (const rp of group.pages) {
+                const page = pagesByPath.get(rp.slug);
                 if (!page)
                     continue;
                 items.push({

package/dist/dev-server.js

@@ -44,8 +44,8 @@ export async function startDevServer(options) {
             watchPaths.push(tab.doxygen.xml);
         if (tab.groups) {
             for (const group of tab.groups) {
-                for (const pagePath of group.pages) {
-                    watchPaths.push(pagePath);
+                for (const rp of group.pages) {
+                    watchPaths.push(rp.file);
                 }
             }
         }
@@ -62,8 +62,8 @@ export async function startDevServer(options) {
             }
             if (tab.groups) {
                 for (const group of tab.groups) {
-                    for (const pagePath of group.pages) {
-                        map.set(resolve(pagePath), { kind: "markdown", tabSlug: tab.slug, pagePath });
+                    for (const rp of group.pages) {
+                        map.set(resolve(rp.file), { kind: "markdown", tabSlug: tab.slug, pagePath: rp.file, pageSlug: rp.slug });
                     }
                 }
             }
@@ -121,7 +121,7 @@ export async function startDevServer(options) {
         const { data } = snapshot;
         const start = performance.now();
         if (content.kind === "markdown") {
-            const slug = slugFromPath(content.pagePath);
+            const slug = slugFromPath(content.pageSlug);
             log(`reloading ${shortPath(content.pagePath)}`);
             const page = await loadMarkdownPage(content.pagePath, slug);
             if (cache !== snapshot)
@@ -193,12 +193,12 @@ export async function startDevServer(options) {
             return;
         const pagesByPath = new Map();
         for (const group of tab.groups) {
-            for (const pagePath of group.pages) {
-                const slug = slugFromPath(pagePath);
+            for (const rp of group.pages) {
+                const slug = slugFromPath(rp.slug);
                 const pageKey = tabPath(tab.slug, `${slug}.html`);
                 const entry = data.pageMap.get(pageKey);
                 if (entry?.currentPage.kind === "markdown") {
-                    pagesByPath.set(pagePath, entry.currentPage.markdown);
+                    pagesByPath.set(rp.slug, entry.currentPage.markdown);
                 }
             }
         }
@@ -370,10 +370,10 @@ async function loadSiteData(tabs) {
         else if (tab.groups) {
             const pagesByPath = new Map();
             for (const group of tab.groups) {
-                for (const pagePath of group.pages) {
-                    const slug = slugFromPath(pagePath);
-                    const page = await loadMarkdownPage(pagePath, slug);
-                    pagesByPath.set(pagePath, page);
+                for (const rp of group.pages) {
+                    const slug = slugFromPath(rp.slug);
+                    const page = await loadMarkdownPage(rp.file, slug);
+                    pagesByPath.set(rp.slug, page);
                     pageMap.set(tabPath(tab.slug, `${slug}.html`), {
                         spec: primarySpec,
                         currentPage: { kind: "markdown", markdown: page },

package/dist/index.js

@@ -78,10 +78,10 @@ export async function buildSiteDocs(options = {}) {
         else if (tab.groups) {
             const pagesByPath = new Map();
             for (const group of tab.groups) {
-                for (const pagePath of group.pages) {
-                    const slug = slugFromPath(pagePath);
-                    const page = await loadMarkdownPage(pagePath, slug);
-                    pagesByPath.set(pagePath, page);
+                for (const rp of group.pages) {
+                    const slug = slugFromPath(rp.slug);
+                    const page = await loadMarkdownPage(rp.file, slug);
+                    pagesByPath.set(rp.slug, page);
                     sitePages.push({
                         outputPath: tabPath(tab.slug, `${slug}.html`),
                         currentPage: { kind: "markdown", markdown: page },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.3.8",
+  "version": "3.3.10",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {
@@ -63,16 +63,20 @@
     "api",
     "documentation",
     "static-site-generator",
-    "docs"
+    "docs",
+    "markdown",
+    "api-docs",
+    "developer-documentation",
+    "doxygen"
   ],
-  "author": "Kam Low <auscaster@gmail.com> (https://sourcey.com)",
+  "author": "Kam Low <oss@0state.com> (https://sourcey.com)",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nilstate/sourcey.git"
+    "url": "git+https://github.com/sourcey/sourcey.git"
   },
   "bugs": {
-    "url": "https://github.com/nilstate/sourcey/issues"
+    "url": "https://github.com/sourcey/sourcey/issues"
   },
-  "homepage": "https://github.com/nilstate/sourcey#readme"
+  "homepage": "https://sourcey.com"
 }