@x-wave/blog 2.0.0 → 2.1.1

package/vite-config/setup-ssg.js

@@ -0,0 +1,84 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { discoverBlogPosts } from './blog-discovery.js';
+import { createStaticGenPlugin } from './static-gen-plugin.js';
+/**
+ * Read all MDX files from a docs directory
+ * @param docsDir - Path to the docs directory
+ * @returns Object mapping file paths to content loaders
+ */
+function readMdxFiles(docsDir) {
+    const mdxFiles = {};
+    function walkDir(dir, relativePath = '') {
+        if (!fs.existsSync(dir))
+            return;
+        const files = fs.readdirSync(dir);
+        for (const file of files) {
+            const fullPath = path.join(dir, file);
+            const relPath = path.join(relativePath, file);
+            const stat = fs.statSync(fullPath);
+            if (stat.isDirectory()) {
+                walkDir(fullPath, relPath);
+            }
+            else if (file.endsWith('.mdx')) {
+                // Create a lazy loader function
+                mdxFiles[path.join(docsDir, relPath)] = async () => fs.readFileSync(fullPath, 'utf-8');
+            }
+        }
+    }
+    walkDir(docsDir);
+    return mdxFiles;
+}
+/**
+ * Setup static site generation for blog posts
+ *
+ * This is a convenience function that handles the entire SSG setup process.
+ * It discovers blog posts from your docs directory and creates a Vite plugin.
+ *
+ * @example
+ * ```typescript
+ * import { setupSSG } from '@x-wave/blog/vite-config'
+ *
+ * export default defineConfig(async (env) => {
+ *   const ssgPlugin = env.command === 'build'
+ *     ? await setupSSG({
+ *         docsPath: 'src/docs',
+ *         outputDir: 'dist/docs',
+ *         metaTagsOptions: {
+ *           baseUrl: 'https://example.com',
+ *           siteName: 'My Documentation',
+ *         }
+ *       })
+ *     : undefined
+ *
+ *   return {
+ *     plugins: [react(), ssgPlugin].filter(Boolean),
+ *     // ... rest of config
+ *   }
+ * })
+ * ```
+ */
+export async function setupSSG(options) {
+    try {
+        const { docsPath, outputDir = 'dist/docs', metaTagsOptions = {} } = options;
+        const mdxFiles = readMdxFiles(docsPath);
+        const { posts } = await discoverBlogPosts(mdxFiles, {
+            blogContentPath: docsPath,
+        });
+        if (posts.length === 0) {
+            console.log('📝 No blog posts found, SSG disabled');
+            return undefined;
+        }
+        console.log(`📝 Discovered ${posts.length} blog posts for SSG`);
+        return createStaticGenPlugin({
+            posts,
+            outputDir,
+            metaTagsOptions,
+        });
+    }
+    catch (error) {
+        console.warn('⚠️  SSG initialization failed:', error);
+        return undefined;
+    }
+}
+//# sourceMappingURL=setup-ssg.js.map

package/vite-config/setup-ssg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-ssg.js","sourceRoot":"","sources":["../src/setup-ssg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAW9D;;;;GAIG;AACH,SAAS,YAAY,CAAC,OAAe;IACpC,MAAM,QAAQ,GAA0C,EAAE,CAAA;IAE1D,SAAS,OAAO,CAAC,GAAW,EAAE,YAAY,GAAG,EAAE;QAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAM;QAE/B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;YAC7C,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAElC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAC3B,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,gCAAgC;gBAChC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,IAAI,EAAE,CAClD,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACpC,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,CAAA;IAChB,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,OAAwB;IAExB,IAAI,CAAC;QACJ,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,WAAW,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;QAE3E,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACvC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE;YACnD,eAAe,EAAE,QAAQ;SACzB,CAAC,CAAA;QAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAA;YACnD,OAAO,SAAS,CAAA;QACjB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,MAAM,qBAAqB,CAAC,CAAA;QAE/D,OAAO,qBAAqB,CAAC;YAC5B,KAAK;YACL,SAAS;YACT,eAAe;SACf,CAAC,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAA;QACrD,OAAO,SAAS,CAAA;IACjB,CAAC;AACF,CAAC"}

package/vite-config/static-gen-plugin.d.ts

@@ -0,0 +1,19 @@
+import type { Plugin } from 'vite';
+import { type MetaTagsOptions } from './meta-tags.js';
+import type { BlogPostMetadata, BlogSSGConfig } from './types.js';
+export interface StaticGenPluginOptions extends BlogSSGConfig {
+    /** Blog posts to generate static pages for */
+    posts: BlogPostMetadata[];
+    /** Meta tag generation options */
+    metaTagsOptions?: MetaTagsOptions;
+    /** Reference to original index.html path */
+    indexHtmlPath?: string;
+}
+/**
+ * Vite plugin for static site generation of blog posts
+ *
+ * Generates individual HTML files for each blog post with injected meta tags
+ * These files are created after the main build completes
+ */
+export declare function createStaticGenPlugin(options: StaticGenPluginOptions): Plugin;
+//# sourceMappingURL=static-gen-plugin.d.ts.map

package/vite-config/static-gen-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-gen-plugin.d.ts","sourceRoot":"","sources":["../src/static-gen-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEjE,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC5D,8CAA8C;IAC9C,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,kCAAkC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CA4E7E"}

package/vite-config/static-gen-plugin.js

@@ -0,0 +1,56 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { generateHtmlWithMetaTags } from './meta-tags.js';
+/**
+ * Vite plugin for static site generation of blog posts
+ *
+ * Generates individual HTML files for each blog post with injected meta tags
+ * These files are created after the main build completes
+ */
+export function createStaticGenPlugin(options) {
+    let config;
+    const { posts, outputDir = 'dist/docs', metaTagsOptions = {}, indexHtmlPath = 'index.html', } = options;
+    return {
+        name: 'vite-plugin-blog-static-gen',
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+        },
+        async generateBundle() {
+            // This hook runs during the bundle generation phase
+            // We'll actually write files in writeBundle to ensure index.html exists
+        },
+        async writeBundle() {
+            if (!posts || posts.length === 0) {
+                console.log('📝 No blog posts to generate static files for');
+                return;
+            }
+            try {
+                // Read the generated index.html
+                const indexHtmlPath_ = path.resolve(config.build.outDir, 'index.html');
+                if (!fs.existsSync(indexHtmlPath_)) {
+                    console.warn(`⚠️  Index HTML not found at ${indexHtmlPath_}, skipping static generation`);
+                    return;
+                }
+                const indexHtmlContent = fs.readFileSync(indexHtmlPath_, 'utf-8');
+                console.log(`📝 Generating static pages for ${posts.length} blog posts...`);
+                // Create static HTML file for each blog post
+                for (const post of posts) {
+                    const htmlWithMeta = generateHtmlWithMetaTags(indexHtmlContent, post, metaTagsOptions);
+                    // Create directory structure: dist/docs/[language]/[slug]/index.html
+                    const postDir = path.resolve(config.build.outDir, post.language, post.slug);
+                    fs.mkdirSync(postDir, { recursive: true });
+                    // Write the static HTML file
+                    const htmlPath = path.resolve(postDir, 'index.html');
+                    fs.writeFileSync(htmlPath, htmlWithMeta, 'utf-8');
+                    console.log(`  ✓ Generated ${post.language}/${post.slug}/`);
+                }
+                console.log(`✨ Static generation complete for ${posts.length} blog posts`);
+            }
+            catch (error) {
+                console.error('❌ Error generating static blog posts:', error);
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=static-gen-plugin.js.map

package/vite-config/static-gen-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-gen-plugin.js","sourceRoot":"","sources":["../src/static-gen-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,wBAAwB,EAAwB,MAAM,gBAAgB,CAAA;AAY/E;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACpE,IAAI,MAAW,CAAA;IACf,MAAM,EACL,KAAK,EACL,SAAS,GAAG,WAAW,EACvB,eAAe,GAAG,EAAE,EACpB,aAAa,GAAG,YAAY,GAC5B,GAAG,OAAO,CAAA;IAEX,OAAO;QACN,IAAI,EAAE,6BAA6B;QAEnC,cAAc,CAAC,cAAc;YAC5B,MAAM,GAAG,cAAc,CAAA;QACxB,CAAC;QAED,KAAK,CAAC,cAAc;YACnB,oDAAoD;YACpD,wEAAwE;QACzE,CAAC;QAED,KAAK,CAAC,WAAW;YAChB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAA;gBAC5D,OAAM;YACP,CAAC;YAED,IAAI,CAAC;gBACJ,gCAAgC;gBAChC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;gBACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;oBACpC,OAAO,CAAC,IAAI,CACX,+BAA+B,cAAc,8BAA8B,CAC3E,CAAA;oBACD,OAAM;gBACP,CAAC;gBAED,MAAM,gBAAgB,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;gBAEjE,OAAO,CAAC,GAAG,CACV,kCAAkC,KAAK,CAAC,MAAM,gBAAgB,CAC9D,CAAA;gBAED,6CAA6C;gBAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBAC1B,MAAM,YAAY,GAAG,wBAAwB,CAC5C,gBAAgB,EAChB,IAAI,EACJ,eAAe,CACf,CAAA;oBAED,qEAAqE;oBACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,EACnB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,IAAI,CACT,CAAA;oBAED,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;oBAE1C,6BAA6B;oBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;oBACpD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;oBAEjD,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;gBAC5D,CAAC;gBAED,OAAO,CAAC,GAAG,CACV,oCAAoC,KAAK,CAAC,MAAM,aAAa,CAC7D,CAAA;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAA;gBAC7D,MAAM,KAAK,CAAA;YACZ,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC"}

package/vite-config/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared types for blog SSG functionality
+ */
+export interface BlogPostMetadata {
+    slug: string;
+    title: string;
+    description?: string;
+    ogImage?: string;
+    keywords?: string[] | string;
+    date?: string;
+    author?: string;
+    language: string;
+    filePath: string;
+}
+export interface BlogDiscoveryResult {
+    posts: BlogPostMetadata[];
+    postsByLanguage: Record<string, BlogPostMetadata[]>;
+    postsBySlug: Record<string, BlogPostMetadata>;
+}
+export interface BlogSSGConfig {
+    /** Path to blog MDX files relative to app root */
+    blogContentPath?: string;
+    /** Whether to generate static files */
+    generateStatic?: boolean;
+    /** Output directory for generated blog posts */
+    outputDir?: string;
+    /** Base path for blog routes */
+    basePath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/vite-config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAA;IACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,aAAa;IAC7B,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/vite-config/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for blog SSG functionality
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/vite-config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}