@x-wave/blog 2.1.0 → 2.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x-wave/blog",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "type": "module",
   "exports": {
     ".": {
@@ -20,8 +20,8 @@
       "types": "./types/index.d.ts"
     },
     "./vite-config": {
-      "import": "./vite-config/index.ts",
-      "types": "./vite-config/index.ts"
+      "import": "./vite-config/index.js",
+      "types": "./vite-config/index.d.ts"
     },
     "./styles": {
       "import": "./styles/index.css"

package/vite-config/blog-discovery.d.ts

@@ -0,0 +1,15 @@
+import type { BlogDiscoveryResult, BlogPostMetadata, BlogSSGConfig } from './types.js';
+/**
+ * Discover all blog posts from Vite glob import
+ *
+ * @param mdxFiles - Object from import.meta.glob('./docs/**\/*.mdx', { query: '?raw', import: 'default', eager: false })
+ * @param config - SSG configuration options
+ * @returns Collection of discovered blog posts organized by language and slug
+ */
+export declare function discoverBlogPosts(mdxFiles: Record<string, () => Promise<unknown>>, _config?: BlogSSGConfig): Promise<BlogDiscoveryResult>;
+/**
+ * Filter blog posts by specific criteria
+ * Useful for separating blog posts from docs
+ */
+export declare function filterBlogPosts(posts: BlogPostMetadata[], predicate: (post: BlogPostMetadata) => boolean): BlogPostMetadata[];
+//# sourceMappingURL=blog-discovery.d.ts.map

package/vite-config/blog-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-discovery.d.ts","sourceRoot":"","sources":["../src/blog-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,MAAM,YAAY,CAAA;AAgFnB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,EAChD,OAAO,GAAE,aAAkB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAqD9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,gBAAgB,EAAE,EACzB,SAAS,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,GAC5C,gBAAgB,EAAE,CAEpB"}

package/vite-config/blog-discovery.js

@@ -0,0 +1,131 @@
+/**
+ * Parse YAML frontmatter from MDX content
+ */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+    if (!match)
+        return {};
+    const frontmatter = {};
+    const frontmatterText = match[1];
+    let currentKey = '';
+    let isArrayContext = false;
+    const arrayValues = [];
+    for (const line of frontmatterText.split('\n')) {
+        const trimmed = line.trim();
+        // Handle array items (lines starting with -)
+        if (trimmed.startsWith('-')) {
+            if (isArrayContext) {
+                const value = trimmed.substring(1).trim();
+                arrayValues.push(value);
+            }
+            continue;
+        }
+        // If we were in array context and hit a non-array line, save the array
+        if (isArrayContext && !trimmed.startsWith('-')) {
+            frontmatter[currentKey] = arrayValues.slice();
+            arrayValues.length = 0;
+            isArrayContext = false;
+        }
+        // Handle key-value pairs
+        if (trimmed?.includes(':')) {
+            const [key, ...valueParts] = trimmed.split(':');
+            const value = valueParts.join(':').trim();
+            currentKey = key.trim();
+            // If value is empty, this might be an array declaration
+            if (!value) {
+                isArrayContext = true;
+                continue;
+            }
+            // Parse boolean values
+            if (value === 'true')
+                frontmatter[currentKey] = true;
+            else if (value === 'false')
+                frontmatter[currentKey] = false;
+            else
+                frontmatter[currentKey] = value;
+        }
+    }
+    // Save any remaining array
+    if (isArrayContext) {
+        frontmatter[currentKey] = arrayValues.slice();
+    }
+    return frontmatter;
+}
+/**
+ * Extract language from file path based on doc structure
+ * Expected: docs/[language]/[slug].mdx
+ */
+function extractLanguageFromPath(filePath) {
+    const match = filePath.match(/\/docs\/([a-z]{2})\//);
+    return match ? match[1] : 'en';
+}
+/**
+ * Extract slug from file path
+ * Expected: docs/[language]/[slug].mdx
+ */
+function extractSlugFromPath(filePath) {
+    const match = filePath.match(/\/([a-z0-9-]+)\.mdx$/);
+    return match ? match[1] : '';
+}
+/**
+ * Discover all blog posts from Vite glob import
+ *
+ * @param mdxFiles - Object from import.meta.glob('./docs/**\/*.mdx', { query: '?raw', import: 'default', eager: false })
+ * @param config - SSG configuration options
+ * @returns Collection of discovered blog posts organized by language and slug
+ */
+export async function discoverBlogPosts(mdxFiles, _config = {}) {
+    const posts = [];
+    const postsByLanguage = {};
+    const postsBySlug = {};
+    // Iterate through all MDX files
+    for (const [filePath, getContent] of Object.entries(mdxFiles)) {
+        try {
+            // Load content
+            const content = (await getContent());
+            // Extract language and slug
+            const language = extractLanguageFromPath(filePath);
+            const slug = extractSlugFromPath(filePath);
+            if (!slug)
+                continue;
+            // Parse frontmatter
+            const frontmatter = parseFrontmatter(content);
+            // Create metadata object
+            const metadata = {
+                slug,
+                title: frontmatter.title || slug,
+                description: frontmatter.description,
+                ogImage: frontmatter.ogImage,
+                keywords: frontmatter.keywords,
+                date: frontmatter.date,
+                author: frontmatter.author,
+                language,
+                filePath,
+            };
+            posts.push(metadata);
+            // Index by language
+            if (!postsByLanguage[language]) {
+                postsByLanguage[language] = [];
+            }
+            postsByLanguage[language].push(metadata);
+            // Index by slug (use [language-slug] composite key to avoid conflicts)
+            postsBySlug[`${language}:${slug}`] = metadata;
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to process ${filePath}:`, error);
+        }
+    }
+    return {
+        posts,
+        postsByLanguage,
+        postsBySlug,
+    };
+}
+/**
+ * Filter blog posts by specific criteria
+ * Useful for separating blog posts from docs
+ */
+export function filterBlogPosts(posts, predicate) {
+    return posts.filter(predicate);
+}
+//# sourceMappingURL=blog-discovery.js.map

package/vite-config/blog-discovery.js.map

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

package/vite-config/index.d.ts

@@ -0,0 +1,5 @@
+export { discoverBlogPosts, filterBlogPosts } from './blog-discovery.js';
+export { generateHtmlWithMetaTags, generateMetaTags, generateMetaTagsObject, type MetaTagsOptions, } from './meta-tags.js';
+export { type SetupSSGOptions, setupSSG } from './setup-ssg.js';
+export { createStaticGenPlugin, type StaticGenPluginOptions, } from './static-gen-plugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGxE,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE/D,OAAO,EACN,qBAAqB,EACrB,KAAK,sBAAsB,GAC3B,MAAM,wBAAwB,CAAA"}

package/vite-config/index.js

@@ -0,0 +1,9 @@
+// Blog discovery
+export { discoverBlogPosts, filterBlogPosts } from './blog-discovery.js';
+// Meta tag generation
+export { generateHtmlWithMetaTags, generateMetaTags, generateMetaTagsObject, } from './meta-tags.js';
+// SSG setup utilities (recommended for consumers)
+export { setupSSG } from './setup-ssg.js';
+// Vite plugin
+export { createStaticGenPlugin, } from './static-gen-plugin.js';
+//# sourceMappingURL=index.js.map

package/vite-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAExE,sBAAsB;AACtB,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,GAEtB,MAAM,gBAAgB,CAAA;AACvB,kDAAkD;AAClD,OAAO,EAAwB,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC/D,cAAc;AACd,OAAO,EACN,qBAAqB,GAErB,MAAM,wBAAwB,CAAA"}

package/vite-config/meta-tags.d.ts

@@ -0,0 +1,28 @@
+import type { BlogPostMetadata } from './types.js';
+export interface MetaTagsOptions {
+    /** Base URL for absolute OG image URLs */
+    baseUrl?: string;
+    /** Default OG image URL if post doesn't have one */
+    defaultOgImage?: string;
+    /** Site title for Twitter Card */
+    siteTitle?: string;
+    /** Site name for OG tags */
+    siteName?: string;
+    /** Twitter handle for Twitter Card */
+    twitterHandle?: string;
+}
+/**
+ * Generate meta tags HTML string from blog post metadata
+ */
+export declare function generateMetaTags(post: BlogPostMetadata, options?: MetaTagsOptions): string;
+/**
+ * Generate an HTML template with injected meta tags
+ * Used for static page generation
+ */
+export declare function generateHtmlWithMetaTags(baseHtml: string, post: BlogPostMetadata, options?: MetaTagsOptions): string;
+/**
+ * Generate meta tags as a JSON object for dynamic injection
+ * Useful if you want to update meta tags on client-side navigation
+ */
+export declare function generateMetaTagsObject(post: BlogPostMetadata, options?: MetaTagsOptions): Record<string, string>;
+//# sourceMappingURL=meta-tags.d.ts.map

package/vite-config/meta-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tags.d.ts","sourceRoot":"","sources":["../src/meta-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,eAAe;IAC/B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,eAAoB,GAC3B,MAAM,CA4DR;AAgBD;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,eAAoB,GAC3B,MAAM,CA8BR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,eAAoB,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuCxB"}

package/vite-config/meta-tags.js

@@ -0,0 +1,129 @@
+/**
+ * Generate meta tags HTML string from blog post metadata
+ */
+export function generateMetaTags(post, options = {}) {
+    const { baseUrl = 'https://docs.staking.polkadot.cloud', defaultOgImage = '/img/og-image.png', siteTitle = 'Polkadot Cloud Staking', siteName = 'Polkadot Cloud Staking Documentation', twitterHandle = '@PolkadotCloud', } = options;
+    const postUrl = `${baseUrl}/${post.language}/docs/${post.slug}`;
+    const ogImage = post.ogImage
+        ? `${baseUrl}${post.ogImage.startsWith('/') ? '' : '/'}${post.ogImage}`
+        : `${baseUrl}${defaultOgImage}`;
+    // Normalize keywords
+    let keywordsString = '';
+    if (post.keywords) {
+        if (Array.isArray(post.keywords)) {
+            keywordsString = post.keywords.join(', ');
+        }
+        else {
+            keywordsString = post.keywords;
+        }
+    }
+    const tags = [
+        // Basic meta tags
+        `<meta name="description" content="${escapeHtml(post.description || siteTitle)}">`,
+        `<meta name="viewport" content="width=device-width, initial-scale=1.0">`,
+        // Open Graph (OG) tags
+        `<meta property="og:type" content="article">`,
+        `<meta property="og:title" content="${escapeHtml(post.title)} | ${escapeHtml(siteName)}">`,
+        `<meta property="og:description" content="${escapeHtml(post.description || siteTitle)}">`,
+        `<meta property="og:url" content="${escapeHtml(postUrl)}">`,
+        `<meta property="og:image" content="${escapeHtml(ogImage)}">`,
+        `<meta property="og:site_name" content="${escapeHtml(siteName)}">`,
+        // Article-specific meta tags
+        `<meta property="article:published_time" content="${post.date || new Date().toISOString()}">`,
+        post.author
+            ? `<meta property="article:author" content="${escapeHtml(post.author)}">`
+            : '',
+        // Twitter Card tags
+        `<meta name="twitter:card" content="summary_large_image">`,
+        `<meta name="twitter:site" content="${twitterHandle}">`,
+        `<meta name="twitter:title" content="${escapeHtml(post.title)} | ${escapeHtml(siteName)}">`,
+        `<meta name="twitter:description" content="${escapeHtml(post.description || siteTitle)}">`,
+        `<meta name="twitter:image" content="${escapeHtml(ogImage)}">`,
+        // Keywords
+        keywordsString
+            ? `<meta name="keywords" content="${escapeHtml(keywordsString)}">`
+            : '',
+        // Canonical URL
+        `<link rel="canonical" href="${escapeHtml(postUrl)}">`,
+    ];
+    return tags.filter(Boolean).join('\n\t');
+}
+/**
+ * Escape HTML special characters in attribute values
+ */
+function escapeHtml(text) {
+    const map = {
+        '&': '&amp;',
+        '<': '&lt;',
+        '>': '&gt;',
+        '"': '&quot;',
+        "'": '&#039;',
+    };
+    return text.replace(/[&<>"']/g, (char) => map[char]);
+}
+/**
+ * Generate an HTML template with injected meta tags
+ * Used for static page generation
+ */
+export function generateHtmlWithMetaTags(baseHtml, post, options = {}) {
+    const metaTags = generateMetaTags(post, options);
+    // Remove default OG and Twitter meta tags to replace them with custom ones
+    let html = baseHtml
+        // Remove default og:* meta tags (handles multiline)
+        .replace(/<meta\s+property="og:[^"]*"[^>]*>/gis, '')
+        // Remove default article:* meta tags (handles multiline)
+        .replace(/<meta\s+property="article:[^"]*"[^>]*>/gis, '')
+        // Remove default twitter:* meta tags with either 'name' or 'property' attribute (handles multiline)
+        .replace(/<meta\s+(?:name|property)="twitter:[^"]*"[^>]*>/gis, '')
+        // Remove default description tag
+        .replace(/<meta\s+name="description"[^>]*>/gis, '')
+        // Remove canonical link if present
+        .replace(/<link\s+rel="canonical"[^>]*>/gis, '');
+    // Clean up excess blank lines left by removed tags
+    html = html.replace(/\n\s*\n\s*\n/g, '\n\n');
+    // Remove orphaned section comments followed by blank lines
+    html = html.replace(/\s*<!--\s*(?:Open Graph|Facebook|Twitter)[^>]*-->\s*\n/g, '');
+    // Final cleanup: remove any remaining multiple blank lines
+    html = html.replace(/\n\s*\n\s*\n/g, '\n\n');
+    // Inject custom meta tags before closing </head> tag
+    return html.replace('</head>', `\t${metaTags}\n</head>`);
+}
+/**
+ * Generate meta tags as a JSON object for dynamic injection
+ * Useful if you want to update meta tags on client-side navigation
+ */
+export function generateMetaTagsObject(post, options = {}) {
+    const { baseUrl = 'https://docs.staking.polkadot.cloud', defaultOgImage = '/img/og-image.png', siteName = 'Polkadot Cloud Staking Documentation', } = options;
+    const postUrl = `${baseUrl}/${post.language}/docs/${post.slug}`;
+    const ogImage = post.ogImage
+        ? `${baseUrl}${post.ogImage.startsWith('/') ? '' : '/'}${post.ogImage}`
+        : `${baseUrl}${defaultOgImage}`;
+    // Normalize keywords
+    let keywordsArray = [];
+    if (post.keywords) {
+        if (Array.isArray(post.keywords)) {
+            keywordsArray = post.keywords;
+        }
+        else {
+            keywordsArray = post.keywords.split(',').map((k) => k.trim());
+        }
+    }
+    return {
+        description: post.description || siteName,
+        'og:type': 'article',
+        'og:title': `${post.title} | ${siteName}`,
+        'og:description': post.description || siteName,
+        'og:url': postUrl,
+        'og:image': ogImage,
+        'og:site_name': siteName,
+        'article:published_time': post.date || new Date().toISOString(),
+        ...(post.author && { 'article:author': post.author }),
+        'twitter:card': 'summary_large_image',
+        'twitter:title': `${post.title} | ${siteName}`,
+        'twitter:description': post.description || siteName,
+        'twitter:image': ogImage,
+        ...(keywordsArray.length > 0 && { keywords: keywordsArray.join(', ') }),
+        canonical: postUrl,
+    };
+}
+//# sourceMappingURL=meta-tags.js.map

package/vite-config/meta-tags.js.map

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

package/vite-config/setup-ssg.d.ts

@@ -0,0 +1,43 @@
+import type { PluginOption } from 'vite';
+import type { MetaTagsOptions } from './meta-tags.js';
+export interface SetupSSGOptions {
+    /** Path to the docs directory (e.g., 'src/docs') */
+    docsPath: string;
+    /** Base path segment for SSG output (e.g., 'blog') */
+    docsBase?: string;
+    /** Output directory for generated static pages */
+    outputDir?: string;
+    /** Meta tags configuration */
+    metaTagsOptions?: MetaTagsOptions;
+}
+/**
+ * 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 declare function setupSSG(options: SetupSSGOptions): Promise<PluginOption | undefined>;
+//# sourceMappingURL=setup-ssg.d.ts.map

package/vite-config/setup-ssg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-ssg.d.ts","sourceRoot":"","sources":["../src/setup-ssg.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD,MAAM,WAAW,eAAe;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAA;CACjC;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA2BnC"}

package/vite-config/setup-ssg.js

@@ -0,0 +1,86 @@
+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, docsBase, outputDir, 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,
+            basePath: docsBase,
+            docsBase,
+            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;AAa9D;;;;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,QAAQ,EAAE,SAAS,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;QAEvE,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,QAAQ,EAAE,QAAQ;YAClB,QAAQ;YACR,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,CAqG7E"}

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

@@ -0,0 +1,77 @@
+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) {
+    // biome-ignore lint/suspicious/noExplicitAny: <ignore>
+    let config;
+    const { posts, outputDir, 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 {
+                const resolvedIndexHtmlPath = path.isAbsolute(indexHtmlPath)
+                    ? indexHtmlPath
+                    : path.resolve(config.build.outDir, indexHtmlPath);
+                const docsBasePath = typeof options.docsBase === 'string'
+                    ? options.docsBase
+                    : typeof options.basePath === 'string'
+                        ? options.basePath
+                        : typeof config.base === 'string'
+                            ? config.base
+                            : '/';
+                const baseSegment = docsBasePath.replace(/^\//, '').replace(/\/$/, '');
+                const defaultOutputDir = baseSegment
+                    ? path.resolve(config.build.outDir, baseSegment)
+                    : config.build.outDir;
+                const resolvedOutputDir = outputDir
+                    ? path.isAbsolute(outputDir)
+                        ? outputDir
+                        : outputDir.startsWith(config.build.outDir)
+                            ? outputDir
+                            : path.resolve(config.build.outDir, outputDir)
+                    : defaultOutputDir;
+                // Read the generated index.html
+                if (!fs.existsSync(resolvedIndexHtmlPath)) {
+                    console.warn(`⚠️  Index HTML not found at ${resolvedIndexHtmlPath}, skipping static generation`);
+                    return;
+                }
+                const indexHtmlContent = fs.readFileSync(resolvedIndexHtmlPath, '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: <outputDir>/[language]/[slug]/index.html
+                    const postDir = path.resolve(resolvedOutputDir, 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":"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"}

package/vite-config/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 (deprecated: use docsBase) */
+    basePath?: string;
+    /** Base path segment for SSG output (e.g., 'blog') */
+    docsBase?: 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,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sDAAsD;IACtD,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"}

package/vite-config/blog-discovery.ts

@@ -1,160 +0,0 @@
-import path from 'node:path'
-import type {
-	BlogDiscoveryResult,
-	BlogPostMetadata,
-	BlogSSGConfig,
-} from './types.ts'
-
-/**
- * Parse YAML frontmatter from MDX content
- */
-function parseFrontmatter(content: string): Record<string, unknown> {
-	const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/)
-
-	if (!match) return {}
-
-	const frontmatter: Record<string, unknown> = {}
-	const frontmatterText = match[1]
-	let currentKey = ''
-	let isArrayContext = false
-	const arrayValues: string[] = []
-
-	for (const line of frontmatterText.split('\n')) {
-		const trimmed = line.trim()
-
-		// Handle array items (lines starting with -)
-		if (trimmed.startsWith('-')) {
-			if (isArrayContext) {
-				const value = trimmed.substring(1).trim()
-				arrayValues.push(value)
-			}
-			continue
-		}
-
-		// If we were in array context and hit a non-array line, save the array
-		if (isArrayContext && !trimmed.startsWith('-')) {
-			frontmatter[currentKey] = arrayValues.slice()
-			arrayValues.length = 0
-			isArrayContext = false
-		}
-
-		// Handle key-value pairs
-		if (trimmed?.includes(':')) {
-			const [key, ...valueParts] = trimmed.split(':')
-			const value = valueParts.join(':').trim()
-			currentKey = key.trim()
-
-			// If value is empty, this might be an array declaration
-			if (!value) {
-				isArrayContext = true
-				continue
-			}
-
-			// Parse boolean values
-			if (value === 'true') frontmatter[currentKey] = true
-			else if (value === 'false') frontmatter[currentKey] = false
-			else frontmatter[currentKey] = value
-		}
-	}
-
-	// Save any remaining array
-	if (isArrayContext) {
-		frontmatter[currentKey] = arrayValues.slice()
-	}
-
-	return frontmatter
-}
-
-/**
- * Extract language from file path based on doc structure
- * Expected: docs/[language]/[slug].mdx
- */
-function extractLanguageFromPath(filePath: string): string {
-	const match = filePath.match(/\/docs\/([a-z]{2})\//)
-	return match ? match[1] : 'en'
-}
-
-/**
- * Extract slug from file path
- * Expected: docs/[language]/[slug].mdx
- */
-function extractSlugFromPath(filePath: string): string {
-	const match = filePath.match(/\/([a-z0-9-]+)\.mdx$/)
-	return match ? match[1] : ''
-}
-
-/**
- * Discover all blog posts from Vite glob import
- *
- * @param mdxFiles - Object from import.meta.glob('./docs/**\/*.mdx', { query: '?raw', import: 'default', eager: false })
- * @param config - SSG configuration options
- * @returns Collection of discovered blog posts organized by language and slug
- */
-export async function discoverBlogPosts(
-	mdxFiles: Record<string, () => Promise<unknown>>,
-	config: BlogSSGConfig = {},
-): Promise<BlogDiscoveryResult> {
-	const posts: BlogPostMetadata[] = []
-	const postsByLanguage: Record<string, BlogPostMetadata[]> = {}
-	const postsBySlug: Record<string, BlogPostMetadata> = {}
-
-	// Iterate through all MDX files
-	for (const [filePath, getContent] of Object.entries(mdxFiles)) {
-		try {
-			// Load content
-			const content = (await getContent()) as string
-
-			// Extract language and slug
-			const language = extractLanguageFromPath(filePath)
-			const slug = extractSlugFromPath(filePath)
-
-			if (!slug) continue
-
-			// Parse frontmatter
-			const frontmatter = parseFrontmatter(content)
-
-			// Create metadata object
-			const metadata: BlogPostMetadata = {
-				slug,
-				title: (frontmatter.title as string) || slug,
-				description: frontmatter.description as string | undefined,
-				ogImage: frontmatter.ogImage as string | undefined,
-				keywords: frontmatter.keywords as string[] | string | undefined,
-				date: frontmatter.date as string | undefined,
-				author: frontmatter.author as string | undefined,
-				language,
-				filePath,
-			}
-
-			posts.push(metadata)
-
-			// Index by language
-			if (!postsByLanguage[language]) {
-				postsByLanguage[language] = []
-			}
-			postsByLanguage[language].push(metadata)
-
-			// Index by slug (use [language-slug] composite key to avoid conflicts)
-			postsBySlug[`${language}:${slug}`] = metadata
-		} catch (error) {
-			console.warn(`Warning: Failed to process ${filePath}:`, error)
-		}
-	}
-
-	return {
-		posts,
-		postsByLanguage,
-		postsBySlug,
-	}
-}
-
-/**
- * Filter blog posts by specific criteria
- * Useful for separating blog posts from docs
- */
-export function filterBlogPosts(
-	posts: BlogPostMetadata[],
-	predicate: (post: BlogPostMetadata) => boolean,
-): BlogPostMetadata[] {
-	return posts.filter(predicate)
-}

package/vite-config/index.ts

@@ -1,17 +0,0 @@
-// Blog discovery
-export { discoverBlogPosts, filterBlogPosts } from './blog-discovery.ts'
-
-// Meta tag generation
-export {
-	generateHtmlWithMetaTags,
-	generateMetaTags,
-	generateMetaTagsObject,
-	type MetaTagsOptions,
-} from './meta-tags.ts'
-// SSG setup utilities (recommended for consumers)
-export { type SetupSSGOptions, setupSSG } from './setup-ssg.ts'
-// Vite plugin
-export {
-	createStaticGenPlugin,
-	type StaticGenPluginOptions,
-} from './static-gen-plugin.ts'

package/vite-config/meta-tags.ts

@@ -1,184 +0,0 @@
-import type { BlogPostMetadata } from './types.ts'
-
-export interface MetaTagsOptions {
-	/** Base URL for absolute OG image URLs */
-	baseUrl?: string
-	/** Default OG image URL if post doesn't have one */
-	defaultOgImage?: string
-	/** Site title for Twitter Card */
-	siteTitle?: string
-	/** Site name for OG tags */
-	siteName?: string
-	/** Twitter handle for Twitter Card */
-	twitterHandle?: string
-}
-
-/**
- * Generate meta tags HTML string from blog post metadata
- */
-export function generateMetaTags(
-	post: BlogPostMetadata,
-	options: MetaTagsOptions = {},
-): string {
-	const {
-		baseUrl = 'https://docs.staking.polkadot.cloud',
-		defaultOgImage = '/img/og-image.png',
-		siteTitle = 'Polkadot Cloud Staking',
-		siteName = 'Polkadot Cloud Staking Documentation',
-		twitterHandle = '@PolkadotCloud',
-	} = options
-
-	const postUrl = `${baseUrl}/${post.language}/docs/${post.slug}`
-	const ogImage = post.ogImage
-		? `${baseUrl}${post.ogImage.startsWith('/') ? '' : '/'}${post.ogImage}`
-		: `${baseUrl}${defaultOgImage}`
-
-	// Normalize keywords
-	let keywordsString = ''
-	if (post.keywords) {
-		if (Array.isArray(post.keywords)) {
-			keywordsString = post.keywords.join(', ')
-		} else {
-			keywordsString = post.keywords
-		}
-	}
-
-	const tags: string[] = [
-		// Basic meta tags
-		`<meta name="description" content="${escapeHtml(post.description || siteTitle)}">`,
-		`<meta name="viewport" content="width=device-width, initial-scale=1.0">`,
-
-		// Open Graph (OG) tags
-		`<meta property="og:type" content="article">`,
-		`<meta property="og:title" content="${escapeHtml(post.title)} | ${escapeHtml(siteName)}">`,
-		`<meta property="og:description" content="${escapeHtml(post.description || siteTitle)}">`,
-		`<meta property="og:url" content="${escapeHtml(postUrl)}">`,
-		`<meta property="og:image" content="${escapeHtml(ogImage)}">`,
-		`<meta property="og:site_name" content="${escapeHtml(siteName)}">`,
-
-		// Article-specific meta tags
-		`<meta property="article:published_time" content="${post.date || new Date().toISOString()}">`,
-		post.author
-			? `<meta property="article:author" content="${escapeHtml(post.author)}">`
-			: '',
-
-		// Twitter Card tags
-		`<meta name="twitter:card" content="summary_large_image">`,
-		`<meta name="twitter:site" content="${twitterHandle}">`,
-		`<meta name="twitter:title" content="${escapeHtml(post.title)} | ${escapeHtml(siteName)}">`,
-		`<meta name="twitter:description" content="${escapeHtml(post.description || siteTitle)}">`,
-		`<meta name="twitter:image" content="${escapeHtml(ogImage)}">`,
-
-		// Keywords
-		keywordsString
-			? `<meta name="keywords" content="${escapeHtml(keywordsString)}">`
-			: '',
-
-		// Canonical URL
-		`<link rel="canonical" href="${escapeHtml(postUrl)}">`,
-	]
-
-	return tags.filter(Boolean).join('\n\t')
-}
-
-/**
- * Escape HTML special characters in attribute values
- */
-function escapeHtml(text: string): string {
-	const map: Record<string, string> = {
-		'&': '&amp;',
-		'<': '&lt;',
-		'>': '&gt;',
-		'"': '&quot;',
-		"'": '&#039;',
-	}
-	return text.replace(/[&<>"']/g, (char) => map[char])
-}
-
-/**
- * Generate an HTML template with injected meta tags
- * Used for static page generation
- */
-export function generateHtmlWithMetaTags(
-	baseHtml: string,
-	post: BlogPostMetadata,
-	options: MetaTagsOptions = {},
-): string {
-	const metaTags = generateMetaTags(post, options)
-
-	// Remove default OG and Twitter meta tags to replace them with custom ones
-	let html = baseHtml
-		// Remove default og:* meta tags (handles multiline)
-		.replace(/<meta\s+property="og:[^"]*"[^>]*>/gis, '')
-		// Remove default article:* meta tags (handles multiline)
-		.replace(/<meta\s+property="article:[^"]*"[^>]*>/gis, '')
-		// Remove default twitter:* meta tags with either 'name' or 'property' attribute (handles multiline)
-		.replace(/<meta\s+(?:name|property)="twitter:[^"]*"[^>]*>/gis, '')
-		// Remove default description tag
-		.replace(/<meta\s+name="description"[^>]*>/gis, '')
-		// Remove canonical link if present
-		.replace(/<link\s+rel="canonical"[^>]*>/gis, '')
-
-	// Clean up excess blank lines left by removed tags
-	html = html.replace(/\n\s*\n\s*\n/g, '\n\n')
-
-	// Remove orphaned section comments followed by blank lines
-	html = html.replace(
-		/\s*<!--\s*(?:Open Graph|Facebook|Twitter)[^>]*-->\s*\n/g,
-		'',
-	)
-
-	// Final cleanup: remove any remaining multiple blank lines
-	html = html.replace(/\n\s*\n\s*\n/g, '\n\n')
-
-	// Inject custom meta tags before closing </head> tag
-	return html.replace('</head>', `\t${metaTags}\n</head>`)
-}
-
-/**
- * Generate meta tags as a JSON object for dynamic injection
- * Useful if you want to update meta tags on client-side navigation
- */
-export function generateMetaTagsObject(
-	post: BlogPostMetadata,
-	options: MetaTagsOptions = {},
-): Record<string, string> {
-	const {
-		baseUrl = 'https://docs.staking.polkadot.cloud',
-		defaultOgImage = '/img/og-image.png',
-		siteName = 'Polkadot Cloud Staking Documentation',
-	} = options
-
-	const postUrl = `${baseUrl}/${post.language}/docs/${post.slug}`
-	const ogImage = post.ogImage
-		? `${baseUrl}${post.ogImage.startsWith('/') ? '' : '/'}${post.ogImage}`
-		: `${baseUrl}${defaultOgImage}`
-
-	// Normalize keywords
-	let keywordsArray: string[] = []
-	if (post.keywords) {
-		if (Array.isArray(post.keywords)) {
-			keywordsArray = post.keywords
-		} else {
-			keywordsArray = post.keywords.split(',').map((k) => k.trim())
-		}
-	}
-
-	return {
-		description: post.description || siteName,
-		'og:type': 'article',
-		'og:title': `${post.title} | ${siteName}`,
-		'og:description': post.description || siteName,
-		'og:url': postUrl,
-		'og:image': ogImage,
-		'og:site_name': siteName,
-		'article:published_time': post.date || new Date().toISOString(),
-		...(post.author && { 'article:author': post.author }),
-		'twitter:card': 'summary_large_image',
-		'twitter:title': `${post.title} | ${siteName}`,
-		'twitter:description': post.description || siteName,
-		'twitter:image': ogImage,
-		...(keywordsArray.length > 0 && { keywords: keywordsArray.join(', ') }),
-		canonical: postUrl,
-	}
-}

package/vite-config/setup-ssg.ts

@@ -1,105 +0,0 @@
-import fs from 'node:fs'
-import path from 'node:path'
-import type { PluginOption } from 'vite'
-import { discoverBlogPosts } from './blog-discovery.ts'
-import type { MetaTagsOptions } from './meta-tags.ts'
-import { createStaticGenPlugin } from './static-gen-plugin.ts'
-
-export interface SetupSSGOptions {
-	/** Path to the docs directory (e.g., 'src/docs') */
-	docsPath: string
-	/** Output directory for generated static pages (default: 'dist/docs') */
-	outputDir?: string
-	/** Meta tags configuration */
-	metaTagsOptions?: MetaTagsOptions
-}
-
-/**
- * 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: string): Record<string, () => Promise<string>> {
-	const mdxFiles: Record<string, () => Promise<string>> = {}
-
-	function walkDir(dir: string, 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: SetupSSGOptions,
-): Promise<PluginOption | undefined> {
-	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
-	}
-}

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

@@ -1,98 +0,0 @@
-import fs from 'node:fs'
-import path from 'node:path'
-import type { Plugin } from 'vite'
-import { generateHtmlWithMetaTags, type MetaTagsOptions } from './meta-tags.ts'
-import type { BlogPostMetadata, BlogSSGConfig } from './types.ts'
-
-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 function createStaticGenPlugin(options: StaticGenPluginOptions): Plugin {
-	let config: any
-	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
-			}
-		},
-	}
-}

package/vite-config/types.ts

@@ -1,32 +0,0 @@
-/**
- * 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
-}