@sigx/ssg 0.1.26 → 0.2.1

package/dist/{virtual-entries-sVkqKMAM.js → virtual-entries-TuNN2It1.js}

@@ -2,6 +2,29 @@ import path from "node:path";
 import fsSync from "node:fs";
 import fg from "fast-glob";
 import matter from "gray-matter";
+//#region src/config.ts
+/**
+* SSG Configuration helper
+*/
+/**
+* Define SSG configuration with type safety
+*
+* @example
+* ```ts
+* // ssg.config.ts
+* import { defineSSGConfig } from '@sigx/ssg';
+*
+* export default defineSSGConfig({
+*     pages: 'src/pages',
+*     layouts: 'src/layouts',
+*     theme: '@sigx/ssg-theme-daisyui',
+*     site: {
+*         title: 'My Site',
+*         description: 'A SignalX-powered static site'
+*     }
+* });
+* ```
+*/
 function defineSSGConfig(config) {
 	return {
 		pages: "src/pages",
@@ -28,6 +51,9 @@ function defineSSGConfig(config) {
 		}
 	};
 }
+/**
+* Load SSG config from file
+*/
 async function loadConfig(configPath) {
 	const fsPath = await import("node:path");
 	const fs = await import("node:fs");
@@ -77,6 +103,9 @@ async function loadConfig(configPath) {
 		return defineSSGConfig({});
 	}
 }
+/**
+* Resolve paths in config to absolute paths
+*/
 function resolveConfigPaths(config, root) {
 	return {
 		...config,
@@ -86,6 +115,16 @@ function resolveConfigPaths(config, root) {
 		outDir: path.resolve(root, config.outDir || "dist")
 	};
 }
+//#endregion
+//#region src/mdx/frontmatter.ts
+/**
+* Frontmatter parser
+*
+* Extracts and parses YAML frontmatter from Markdown/MDX files.
+*/
+/**
+* Parse frontmatter from content
+*/
 function parseFrontmatter(source) {
 	const { data, content, matter: raw } = matter(source);
 	return {
@@ -95,6 +134,9 @@ function parseFrontmatter(source) {
 		hasFrontmatter: !!raw
 	};
 }
+/**
+* Normalize frontmatter data to PageMeta
+*/
 function normalizeFrontmatter(data) {
 	const meta = {};
 	if (typeof data.title === "string") meta.title = data.title;
@@ -110,16 +152,38 @@ function normalizeFrontmatter(data) {
 	for (const [key, value] of Object.entries(data)) if (!(key in meta)) meta[key] = value;
 	return meta;
 }
+/**
+* Extract title from markdown content if not in frontmatter
+*
+* Looks for the first H1 heading
+*/
 function extractTitleFromContent(content) {
 	const h1Match = content.match(/^#\s+(.+)$/m);
 	return h1Match ? h1Match[1].trim() : null;
 }
+//#endregion
+//#region src/routing/scanner.ts
+/**
+* File-based route scanner
+*
+* Scans a pages directory and generates route definitions from file paths.
+* Supports dynamic routes with [param] and catch-all with [...slug] patterns.
+*/
+/**
+* File extensions to treat as pages
+*/
 var PAGE_EXTENSIONS = [
 	".tsx",
 	".jsx",
 	".mdx",
 	".md"
 ];
+/**
+* Files/directories to exclude from routing
+* 
+* Only exclude common non-page folders at the ROOT of pages directory.
+* Nested folders like /docs/components/ are valid routes.
+*/
 var EXCLUDED_PATTERNS = [
 	"components/**",
 	"hooks/**",
@@ -129,6 +193,9 @@ var EXCLUDED_PATTERNS = [
 	"**/*.test.*",
 	"**/*.spec.*"
 ];
+/**
+* Scan pages directory and generate routes
+*/
 async function scanPages(config, root) {
 	const pagesDir = path.resolve(root, config.pages || "src/pages");
 	const files = await fg(PAGE_EXTENSIONS.map((ext) => `**/*${ext}`), {
@@ -144,6 +211,9 @@ async function scanPages(config, root) {
 	}
 	return sortRoutes(routes);
 }
+/**
+* Convert a file path to a route definition with frontmatter metadata
+*/
 async function fileToRouteWithMeta(filePath, pagesDir) {
 	const route = fileToRoute(filePath, pagesDir);
 	if (!route) return null;
@@ -154,6 +224,9 @@ async function fileToRouteWithMeta(filePath, pagesDir) {
 	} catch (err) {}
 	return route;
 }
+/**
+* Convert a file path to a route definition
+*/
 function fileToRoute(filePath, pagesDir) {
 	const ext = path.extname(filePath);
 	let routePath = filePath.slice(0, -ext.length);
@@ -166,6 +239,14 @@ function fileToRoute(filePath, pagesDir) {
 		name
 	};
 }
+/**
+* Convert file path patterns to route path patterns
+*
+* Examples:
+*   blog/[slug] -> /blog/:slug
+*   docs/[...path] -> /docs/*path
+*   users/[id]/posts -> /users/:id/posts
+*/
 function filePathToRoutePath(filePath) {
 	return filePath.split("/").map((segment) => {
 		if (segment.startsWith("[...") && segment.endsWith("]")) return `*${segment.slice(4, -1)}`;
@@ -175,10 +256,29 @@ function filePathToRoutePath(filePath) {
 		return segment;
 	}).join("/");
 }
+/**
+* Convert route path to a route name
+*
+* Examples:
+*   / -> index
+*   /about -> about
+*   /blog/:slug -> blog-slug
+*   /docs/*path -> docs-path
+*/
 function pathToRouteName(routePath) {
 	if (routePath === "/" || routePath === "") return "index";
 	return routePath.replace(/^\//, "").replace(/\//g, "-").replace(/:/g, "").replace(/\*/g, "").replace(/\?/g, "").replace(/-+/g, "-").replace(/-$/, "");
 }
+/**
+* Sort routes by specificity
+*
+* Order:
+*   1. Static routes (most specific)
+*   2. Dynamic param routes
+*   3. Catch-all routes (least specific)
+*
+* Within each category, longer paths come first
+*/
 function sortRoutes(routes) {
 	return routes.sort((a, b) => {
 		const scoreA = getRouteScore(a.path);
@@ -187,6 +287,9 @@ function sortRoutes(routes) {
 		return b.path.length - a.path.length;
 	});
 }
+/**
+* Calculate specificity score for a route
+*/
 function getRouteScore(routePath) {
 	const segments = routePath.split("/").filter(Boolean);
 	let score = 0;
@@ -195,9 +298,15 @@ function getRouteScore(routePath) {
 	else score += 100;
 	return score;
 }
+/**
+* Check if a route has dynamic segments
+*/
 function isDynamicRoute(route) {
 	return route.path.includes(":") || route.path.includes("*");
 }
+/**
+* Extract parameter names from a route path
+*/
 function extractParams(routePath) {
 	const params = [];
 	const segments = routePath.split("/");
@@ -205,6 +314,9 @@ function extractParams(routePath) {
 	else if (segment.startsWith("*")) params.push(segment.slice(1));
 	return params;
 }
+/**
+* Generate all static paths for a route using getStaticPaths
+*/
 function expandDynamicRoute(route, staticPaths) {
 	const paths = [];
 	for (const { params } of staticPaths) {
@@ -217,11 +329,22 @@ function expandDynamicRoute(route, staticPaths) {
 	}
 	return paths;
 }
-const VIRTUAL_ROUTES_ID = "virtual:ssg-routes";
-const RESOLVED_VIRTUAL_ROUTES_ID = "\0" + VIRTUAL_ROUTES_ID;
+//#endregion
+//#region src/routing/virtual.ts
+/**
+* Virtual module ID for SSG routes
+*/
+var VIRTUAL_ROUTES_ID = "virtual:ssg-routes";
+var RESOLVED_VIRTUAL_ROUTES_ID = "\0" + VIRTUAL_ROUTES_ID;
+/**
+* Normalize file path to use forward slashes (for ES module imports)
+*/
 function normalizePath$1(filePath) {
 	return filePath.replace(/\\/g, "/");
 }
+/**
+* Generate the virtual routes module code
+*/
 function generateRoutesModule(routes, config) {
 	const imports = [];
 	const routeDefinitions = [];
@@ -252,6 +375,9 @@ const routes = [${routeDefinitions.join(",")}
 export default routes;
 `;
 }
+/**
+* Generate lazy-loading routes module (for development with HMR)
+*/
 function generateLazyRoutesModule(routes, config) {
 	const imports = [];
 	const routeDefinitions = [];
@@ -281,6 +407,16 @@ const routes = [${routeDefinitions.join(",")}
 export default routes;
 `;
 }
+//#endregion
+//#region src/routing/navigation.ts
+/**
+* Generate navigation structure from routes for a specific collection path
+*
+* @param routes - Scanned SSG routes
+* @param collectionPath - Path prefix for the collection (e.g., '/docs')
+* @param showDrafts - Whether to show draft pages
+* @param isDev - Whether running in development mode
+*/
 function generateNavigation(routes, collectionPath, showDrafts, isDev) {
 	const navRoutes = routes.filter((route) => {
 		if (!route.path.startsWith(collectionPath)) return false;
@@ -312,6 +448,9 @@ function generateNavigation(routes, collectionPath, showDrafts, isDev) {
 	}
 	return { sidebar: buildSections(context) };
 }
+/**
+* Add an item to a nested category structure
+*/
 function addToCategory(categories, path, item) {
 	if (path.length === 0) return;
 	const [first, ...rest] = path;
@@ -328,6 +467,10 @@ function addToCategory(categories, path, item) {
 	if (rest.length === 0) category.items.push(item);
 	else addToCategory(category.children, rest, item);
 }
+/**
+* Common section ordering for navigation
+* Used for both top-level sections and nested categories
+*/
 var SECTION_ORDER = {
 	"Getting Started": 10,
 	"Core Concepts": 20,
@@ -349,10 +492,16 @@ var SECTION_ORDER = {
 	"Mockup": 160,
 	"Other": 999
 };
+/**
+* Get sort order for a section/category title
+*/
 function getSectionOrder(title, explicitOrder) {
 	if (explicitOrder !== void 0) return explicitOrder;
 	return SECTION_ORDER[title] ?? 50;
 }
+/**
+* Build NavSection array from context
+*/
 function buildSections(context) {
 	const sections = [];
 	for (const [, category] of context.categories) sections.push(buildSection(category));
@@ -370,6 +519,9 @@ function buildSections(context) {
 	});
 	return sections;
 }
+/**
+* Build a NavSection from a category
+*/
 function buildSection(category) {
 	const sortedItems = category.items.sort((a, b) => a.order - b.order || a.title.localeCompare(b.title)).map((item) => ({
 		title: item.title,
@@ -388,6 +540,9 @@ function buildSection(category) {
 		order: category.order
 	};
 }
+/**
+* Build a nested NavItem from a child category
+*/
 function buildNestedSection(category) {
 	const sortedItems = category.items.sort((a, b) => a.order - b.order || a.title.localeCompare(b.title)).map((item) => ({
 		title: item.title,
@@ -402,10 +557,24 @@ function buildNestedSection(category) {
 		order: category.order
 	};
 }
+/**
+* Convert route path to a display title
+*
+* @example '/docs/getting-started' -> 'Getting Started'
+* @example '/docs/api/router' -> 'Router'
+*/
 function routeToTitle(routePath) {
 	const segments = routePath.split("/").filter(Boolean);
 	return (segments[segments.length - 1] || "Home").replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
+/**
+* Generate navigation for all collections
+*
+* @param routes - Scanned SSG routes
+* @param config - SSG configuration
+* @param isDev - Whether running in development mode
+* @returns Record mapping collection names to their navigation
+*/
 function generateAllCollections(routes, config, isDev) {
 	const collections = config.collections || {};
 	const result = {};
@@ -415,8 +584,20 @@ function generateAllCollections(routes, config, isDev) {
 	}
 	return result;
 }
-const VIRTUAL_NAVIGATION_ID = "virtual:ssg-navigation";
-const RESOLVED_VIRTUAL_NAVIGATION_ID = "\0" + VIRTUAL_NAVIGATION_ID;
+//#endregion
+//#region src/routing/virtual-navigation.ts
+/**
+* Virtual module ID for SSG navigation
+*/
+var VIRTUAL_NAVIGATION_ID = "virtual:ssg-navigation";
+var RESOLVED_VIRTUAL_NAVIGATION_ID = "\0" + VIRTUAL_NAVIGATION_ID;
+/**
+* Generate the virtual navigation module code
+*
+* @param routes - Scanned SSG routes with metadata
+* @param config - SSG configuration
+* @param isDev - Whether running in development mode
+*/
 function generateNavigationModule(routes, config, isDev) {
 	const navigation = generateAllCollections(routes, config, isDev);
 	const collections = config.collections || {};
@@ -478,7 +659,21 @@ export function getSidebar(name) {
 export default { navigation, collections, getCollectionNav, detectCollection, getSidebar };
 `;
 }
+//#endregion
+//#region src/layouts/resolver.ts
+/**
+* Layout resolver
+*
+* Resolves layouts from local layouts directory or theme packages.
+* Layouts wrap page content and provide consistent structure.
+*/
+/**
+* Layout extensions to search for
+*/
 var LAYOUT_EXTENSIONS = [".tsx", ".jsx"];
+/**
+* Scan local layouts directory
+*/
 async function scanLocalLayouts(config, root) {
 	const layoutsDir = path.resolve(root, config.layouts || "src/layouts");
 	if (!fsSync.existsSync(layoutsDir)) return [];
@@ -495,6 +690,9 @@ async function scanLocalLayouts(config, root) {
 		};
 	});
 }
+/**
+* Load layouts from a theme package
+*/
 async function loadThemeLayouts(themeName, root) {
 	try {
 		const { createRequire } = await import("node:module");
@@ -515,6 +713,13 @@ async function loadThemeLayouts(themeName, root) {
 		return [];
 	}
 }
+/**
+* Discover all available layouts
+*
+* Priority order:
+* 1. Local layouts (can override theme)
+* 2. Theme layouts
+*/
 async function discoverLayouts(config, root) {
 	const layouts = /* @__PURE__ */ new Map();
 	if (config.theme) {
@@ -525,11 +730,22 @@ async function discoverLayouts(config, root) {
 	for (const layout of localLayouts) layouts.set(layout.name, layout);
 	return Array.from(layouts.values());
 }
-const VIRTUAL_LAYOUTS_ID = "virtual:generated-layouts";
-const RESOLVED_VIRTUAL_LAYOUTS_ID = "\0virtual:generated-layouts";
+//#endregion
+//#region src/layouts/virtual.ts
+/**
+* Virtual module ID for generated layouts
+*/
+var VIRTUAL_LAYOUTS_ID = "virtual:generated-layouts";
+var RESOLVED_VIRTUAL_LAYOUTS_ID = "\0virtual:generated-layouts";
+/**
+* Normalize file path to use forward slashes (for ES module imports)
+*/
 function normalizePath(filePath) {
 	return filePath.replace(/\\/g, "/");
 }
+/**
+* Generate the virtual layouts module code
+*/
 function generateLayoutsModule(layouts, config) {
 	const imports = [];
 	const layoutEntries = [];
@@ -805,11 +1021,26 @@ export function setupLayouts(routes) {
 export default layouts;
 `;
 }
-const VIRTUAL_CLIENT_ID = "virtual:ssg-client";
-const RESOLVED_VIRTUAL_CLIENT_ID = "\0" + VIRTUAL_CLIENT_ID + ".tsx";
-const SSG_CLIENT_ENTRY_PATH = "/@ssg/client.tsx";
-const VIRTUAL_SERVER_ID = "virtual:ssg-server";
-const RESOLVED_VIRTUAL_SERVER_ID = "\0" + VIRTUAL_SERVER_ID + ".tsx";
+//#endregion
+//#region src/vite/virtual-entries.ts
+/**
+* Virtual Entry Point Generation
+* 
+* Generates auto-configured client and server entry points for zero-config mode.
+* Users can override by providing their own entry files.
+*/
+/**
+* Virtual module IDs
+* Note: We use a special path format that Vite can resolve from HTML
+*/
+var VIRTUAL_CLIENT_ID = "virtual:ssg-client";
+var RESOLVED_VIRTUAL_CLIENT_ID = "\0" + VIRTUAL_CLIENT_ID + ".tsx";
+var SSG_CLIENT_ENTRY_PATH = "/@ssg/client.tsx";
+var VIRTUAL_SERVER_ID = "virtual:ssg-server";
+var RESOLVED_VIRTUAL_SERVER_ID = "\0" + VIRTUAL_SERVER_ID + ".tsx";
+/**
+* Detect if user has custom entry points
+*/
 function detectCustomEntries(root, config) {
 	const clientPaths = [
 		"src/main.tsx",
@@ -871,6 +1102,9 @@ function detectCustomEntries(root, config) {
 		globalCssPath
 	};
 }
+/**
+* Generate virtual client entry code
+*/
 function generateClientEntry(config, detection) {
 	const cssImport = detection.globalCssPath ? `import '${detection.globalCssPath}';\n` : "";
 	const additionalImports = (config.clientImports ?? []).map((imp) => `import '${imp}';`).join("\n");
@@ -914,6 +1148,9 @@ ${prefetchEnabled ? `// Enable link prefetching for faster navigation
 setupPrefetch({ delay: ${prefetchDelay} });` : ""}
 `;
 }
+/**
+* Generate virtual server entry code
+*/
 function generateServerEntry(config) {
 	return `/**
  * Auto-generated server entry point
@@ -948,6 +1185,9 @@ export async function render(url, context) {
 }
 `;
 }
+/**
+* Generate virtual HTML template
+*/
 function generateHtmlTemplate(config) {
 	const site = config.site || {};
 	const lang = site.lang || "en";
@@ -998,6 +1238,10 @@ function generateHtmlTemplate(config) {
 </html>
 `;
 }
+/**
+* Generate HTML template for production build
+* Uses the actual client entry path instead of virtual module
+*/
 function generateProductionHtmlTemplate(config, clientEntryPath) {
 	const site = config.site || {};
 	const lang = site.lang || "en";
@@ -1048,6 +1292,7 @@ function generateProductionHtmlTemplate(config, clientEntryPath) {
 </html>
 `;
 }
+//#endregion
 export { resolveConfigPaths as A, extractParams as C, parseFrontmatter as D, extractTitleFromContent as E, defineSSGConfig as O, expandDynamicRoute as S, scanPages as T, generateNavigationModule as _, VIRTUAL_SERVER_ID as a, generateLazyRoutesModule as b, generateHtmlTemplate as c, RESOLVED_VIRTUAL_LAYOUTS_ID as d, VIRTUAL_LAYOUTS_ID as f, VIRTUAL_NAVIGATION_ID as g, RESOLVED_VIRTUAL_NAVIGATION_ID as h, VIRTUAL_CLIENT_ID as i, loadConfig as k, generateProductionHtmlTemplate as l, discoverLayouts as m, RESOLVED_VIRTUAL_SERVER_ID as n, detectCustomEntries as o, generateLayoutsModule as p, SSG_CLIENT_ENTRY_PATH as r, generateClientEntry as s, RESOLVED_VIRTUAL_CLIENT_ID as t, generateServerEntry as u, RESOLVED_VIRTUAL_ROUTES_ID as v, isDynamicRoute as w, generateRoutesModule as x, VIRTUAL_ROUTES_ID as y };
 
-//# sourceMappingURL=virtual-entries-sVkqKMAM.js.map
+//# sourceMappingURL=virtual-entries-TuNN2It1.js.map