svedocs 0.1.0-beta.2

package/dist/mdx/diff.js

@@ -0,0 +1,160 @@
+import { escapeAttribute, escapeHtml } from './utils.js';
+export function createDiffRows(raw) {
+    let oldLine = 0;
+    let newLine = 0;
+    return raw.replace(/\r?\n$/, '').split(/\r?\n/).map((line) => {
+        const hunk = /^@@\s+-(\d+)(?:,\d+)?\s+\+(\d+)(?:,\d+)?\s+@@/.exec(line);
+        if (hunk) {
+            oldLine = Number(hunk[1]) - 1;
+            newLine = Number(hunk[2]) - 1;
+            return {
+                kind: 'meta',
+                content: line
+            };
+        }
+        if (line.startsWith('+++') || line.startsWith('---')) {
+            return {
+                kind: 'meta',
+                content: line
+            };
+        }
+        if (line.startsWith('+')) {
+            newLine += 1;
+            return {
+                kind: 'add',
+                newLine,
+                content: line.slice(1)
+            };
+        }
+        if (line.startsWith('-')) {
+            oldLine += 1;
+            return {
+                kind: 'remove',
+                oldLine,
+                content: line.slice(1)
+            };
+        }
+        oldLine += 1;
+        newLine += 1;
+        return {
+            kind: 'context',
+            oldLine,
+            newLine,
+            content: line.startsWith(' ') ? line.slice(1) : line
+        };
+    });
+}
+export function createDiffSplitRows(rows) {
+    const splitRows = [];
+    let index = 0;
+    while (index < rows.length) {
+        const row = rows[index];
+        if (!row)
+            break;
+        if (row.kind === 'meta') {
+            splitRows.push({ kind: 'meta', content: row.content });
+            index += 1;
+            continue;
+        }
+        if (row.kind === 'context') {
+            splitRows.push({ kind: 'context', old: row, new: row });
+            index += 1;
+            continue;
+        }
+        if (row.kind === 'remove') {
+            const oldRows = [];
+            const newRows = [];
+            while (rows[index]?.kind === 'remove') {
+                oldRows.push(rows[index]);
+                index += 1;
+            }
+            while (rows[index]?.kind === 'add') {
+                newRows.push(rows[index]);
+                index += 1;
+            }
+            pushPairedChangeRows(splitRows, oldRows, newRows);
+            continue;
+        }
+        const newRows = [];
+        while (rows[index]?.kind === 'add') {
+            newRows.push(rows[index]);
+            index += 1;
+        }
+        pushPairedChangeRows(splitRows, [], newRows);
+    }
+    return splitRows;
+}
+export function renderSplitDiffHtml(block) {
+    const title = block.title ?? 'Diff';
+    const rows = block.splitRows.length > 0 ? block.splitRows : createDiffSplitRows(block.diffRows);
+    const counts = [
+        block.addedLines > 0 ? `+${block.addedLines}` : '',
+        block.removedLines > 0 ? `-${block.removedLines}` : ''
+    ].filter(Boolean).join(' ');
+    return `<div class="sd-diff sd-diff-split sd-code" data-language="${escapeAttribute(block.language)}"${block.title ? ` data-title="${escapeAttribute(block.title)}"` : ''} data-diff="true" data-diff-mode="split"${block.addedLines > 0 ? ` data-added-lines="${block.addedLines}"` : ''}${block.removedLines > 0 ? ` data-removed-lines="${block.removedLines}"` : ''} data-copy="${escapeAttribute(block.raw)}">
+  ${renderDiffHeader(title, counts)}
+  <div class="sd-diff-panes" role="table" aria-label="${escapeAttribute(title)} diff">
+    ${renderPane(rows, 'old', 'Before')}
+    ${renderPane(rows, 'new', 'After')}
+  </div>
+</div>`;
+}
+function pushPairedChangeRows(target, oldRows, newRows) {
+    const length = Math.max(oldRows.length, newRows.length);
+    for (let index = 0; index < length; index += 1) {
+        target.push({
+            kind: 'change',
+            ...(oldRows[index] ? { old: oldRows[index] } : {}),
+            ...(newRows[index] ? { new: newRows[index] } : {})
+        });
+    }
+}
+function renderDiffHeader(title, counts) {
+    const stats = counts
+        ? `<span class="sd-code-stats">${counts.split(' ').map(renderDiffStat).join('')}</span>`
+        : '';
+    return `<div class="sd-code-header">
+    <span class="sd-code-language" data-language="diff">Diff</span>
+    <span class="sd-code-title">${escapeHtml(title)}</span>
+    ${stats}
+    <button type="button" class="sd-code-copy" data-sd-copy="" aria-label="Copy diff" title="Copy diff"><svg viewBox="0 0 24 24" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M9 5h9v14H9zM6 8v12h10"/></svg></button>
+  </div>`;
+}
+function renderDiffStat(count) {
+    const className = count.startsWith('+') ? 'sd-code-stat-add' : 'sd-code-stat-remove';
+    return `<span class="${className}">${escapeHtml(count)}</span>`;
+}
+function renderPane(rows, side, label) {
+    return `<section class="sd-diff-pane" data-side="${side}" role="rowgroup" aria-label="${label}">
+    <div class="sd-diff-column-label" role="columnheader" data-side="${side}">${label}</div>
+    <div class="sd-diff-scroll" role="presentation" tabindex="0">
+      <div class="sd-diff-lines">
+        ${rows.map((row) => renderPaneRow(row, side)).join('')}
+      </div>
+    </div>
+  </section>`;
+}
+function renderPaneRow(row, side) {
+    if (row.kind === 'meta') {
+        return `<div class="sd-diff-row sd-diff-meta" role="row">
+      <div class="sd-diff-cell sd-diff-meta-cell" role="cell" data-side="${side}">
+        <span class="sd-diff-line-no" aria-hidden="true"></span>
+        <span class="sd-diff-code">${escapeHtml(row.content ?? '')}</span>
+      </div>
+    </div>`;
+    }
+    return `<div class="sd-diff-row ${row.kind === 'change' ? 'sd-diff-change' : 'sd-diff-context'}" role="row">
+    ${renderSideCell(side === 'old' ? row.old : row.new, side)}
+  </div>`;
+}
+function renderSideCell(row, side) {
+    if (!row) {
+        return `<div class="sd-diff-cell sd-diff-empty" role="cell" data-side="${side}" aria-hidden="true"></div>`;
+    }
+    const line = side === 'old' ? row.oldLine : row.newLine;
+    const kind = row.kind === 'remove' ? 'remove' : row.kind === 'add' ? 'add' : 'context';
+    return `<div class="sd-diff-cell sd-diff-${kind}" role="cell" data-side="${side}" data-line="${line ?? ''}">
+    <span class="sd-diff-line-no">${line ?? ''}</span>
+    <span class="sd-diff-code">${escapeHtml(row.content)}</span>
+  </div>`;
+}

package/dist/mdx/utils.d.ts

@@ -0,0 +1,10 @@
+export declare function markdownToPlainText(markdown: string): string;
+export declare function stripInlineMarkdown(value: string): string;
+export declare function parseLineSet(value: string | undefined): number[];
+export declare function readQuotedMeta(meta: string, key: string): string | undefined;
+export declare function mergeHtmlClass(attrs: string, className: string): string;
+export declare function mergeClassNames(value: unknown, className: string): string[];
+export declare function normalizeShikiLanguage(language: string): string;
+export declare function escapeHtml(value: string): string;
+export declare function escapeAttribute(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/mdx/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/mdx/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAahE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/mdx/utils.js

@@ -0,0 +1,64 @@
+export function markdownToPlainText(markdown) {
+    return markdown
+        .replace(/```[\s\S]*?```/g, ' ')
+        .replace(/`([^`]+)`/g, '$1')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/!\[[^\]]*\]\([^)]+\)/g, ' ')
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .replace(/[#>*_\-|~]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function stripInlineMarkdown(value) {
+    return value
+        .replace(/`([^`]+)`/g, '$1')
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .replace(/[*_~]/g, '')
+        .trim();
+}
+export function parseLineSet(value) {
+    if (!value)
+        return [];
+    const lines = new Set();
+    for (const part of value.split(',')) {
+        const [startRaw, endRaw] = part.trim().split('-');
+        const start = Number(startRaw);
+        const end = Number(endRaw ?? startRaw);
+        if (!Number.isInteger(start) || !Number.isInteger(end))
+            continue;
+        for (let line = Math.min(start, end); line <= Math.max(start, end); line += 1) {
+            if (line > 0)
+                lines.add(line);
+        }
+    }
+    return [...lines].sort((a, b) => a - b);
+}
+export function readQuotedMeta(meta, key) {
+    const match = new RegExp(`${key}=("[^"]+"|'[^']+'|[^\\s]+)`).exec(meta);
+    return match?.[1]?.replace(/^["']|["']$/g, '');
+}
+export function mergeHtmlClass(attrs, className) {
+    const match = /class="([^"]*)"/.exec(attrs);
+    const classes = new Set([...(match?.[1]?.split(/\s+/).filter(Boolean) ?? []), className]);
+    return [...classes].join(' ');
+}
+export function mergeClassNames(value, className) {
+    const classes = Array.isArray(value) ? value.map(String) : typeof value === 'string' ? value.split(/\s+/) : [];
+    return [...new Set([...classes, className])];
+}
+export function normalizeShikiLanguage(language) {
+    if (language === 'txt')
+        return 'text';
+    if (language === 'sh' || language === 'shell')
+        return 'bash';
+    return language || 'text';
+}
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+export function escapeAttribute(value) {
+    return escapeHtml(value).replace(/"/g, '&quot;');
+}

package/dist/og/image.d.ts

@@ -0,0 +1,21 @@
+import type { SvedocsPage, SvedocsResolvedConfig } from '../core.js';
+import type { OgImageInput, OgImageOptions, OgRenderer, OgRenderOptions, OgTemplate, OgTemplateNode } from './types.js';
+export declare const defaultOgTemplate: {
+    readonly name: "default";
+    readonly render: typeof createDefaultOgTemplateNode;
+};
+export declare function createPageOgImagePath(page: SvedocsPage, format?: 'svg' | 'png'): string;
+export declare function createConfiguredOgImageFormat(config: SvedocsResolvedConfig): 'svg' | 'png';
+export declare function createConfiguredOgImageRenderer(config: SvedocsResolvedConfig): OgRenderer;
+export declare function createConfiguredOgImageTemplate(config: SvedocsResolvedConfig): OgTemplate | undefined;
+export declare function createPageOgImageEntries(pages: SvedocsPage[], format?: 'svg' | 'png'): Array<{
+    path: string;
+}>;
+export declare function createPageOgImageResponse(config: SvedocsResolvedConfig, page: SvedocsPage, options?: OgImageOptions): Promise<Response>;
+export declare function createOgImageInput(config: SvedocsResolvedConfig, page: SvedocsPage): OgImageInput;
+export declare function createOgSvg(input: OgImageInput): string;
+export declare function createDefaultOgTemplateNode(input: OgImageInput): OgTemplateNode;
+export declare function createSatoriOgSvg(input: OgImageInput, options: OgRenderOptions): Promise<string>;
+export declare function createOgImage(input: OgImageInput, options?: OgImageOptions): Promise<string | Uint8Array>;
+export declare function createOgPng(input: OgImageInput, options?: OgRenderOptions): Promise<Uint8Array>;
+//# sourceMappingURL=image.d.ts.map

package/dist/og/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/og/image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,GAAE,KAAK,GAAG,KAAa,GAAG,MAAM,CAG9F;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,GAAG,KAAK,CAE1F;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,qBAAqB,GAAG,UAAU,CAEzF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAIrG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,GAAE,KAAK,GAAG,KAAa,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAIrH;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY,CAMjG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAYvD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CA2D/E;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAYtG;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAEnH;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CASzG"}

package/dist/og/image.js

@@ -0,0 +1,216 @@
+export const defaultOgTemplate = {
+    name: 'default',
+    render: createDefaultOgTemplateNode
+};
+export function createPageOgImagePath(page, format = 'svg') {
+    const name = page.routePath === '/' ? 'index' : page.routePath.replace(/^\/+/, '').replace(/[^a-zA-Z0-9]+/g, '-');
+    return `/og/${name}.${format}`;
+}
+export function createConfiguredOgImageFormat(config) {
+    return config.seo.ogImage === false ? 'svg' : config.seo.ogImage.format;
+}
+export function createConfiguredOgImageRenderer(config) {
+    return config.seo.ogImage === false ? 'svg' : config.seo.ogImage.renderer;
+}
+export function createConfiguredOgImageTemplate(config) {
+    return config.seo.ogImage !== false && typeof config.seo.ogImage.template === 'function'
+        ? config.seo.ogImage.template
+        : undefined;
+}
+export function createPageOgImageEntries(pages, format = 'svg') {
+    return pages
+        .filter((page) => !page.hidden)
+        .map((page) => ({ path: createPageOgImagePath(page, format).replace(/^\/og\//, '') }));
+}
+export async function createPageOgImageResponse(config, page, options = {}) {
+    const format = options.format ?? createConfiguredOgImageFormat(config);
+    const template = options.template ?? createConfiguredOgImageTemplate(config);
+    const asset = await createOgImage(createOgImageInput(config, page), {
+        ...options,
+        format,
+        renderer: options.renderer ?? createConfiguredOgImageRenderer(config),
+        ...(template ? { template } : {})
+    });
+    const body = typeof asset === 'string' ? asset : new Blob([toArrayBuffer(asset)], { type: 'image/png' });
+    return new Response(body, {
+        headers: {
+            'content-type': format === 'png' ? 'image/png' : 'image/svg+xml; charset=utf-8',
+            'cache-control': 'public, max-age=31536000, immutable'
+        }
+    });
+}
+export function createOgImageInput(config, page) {
+    return {
+        title: page.seo.title,
+        description: page.seo.description ?? config.site.description,
+        siteName: config.site.name
+    };
+}
+export function createOgSvg(input) {
+    const title = escapeHtml(input.title);
+    const description = escapeHtml(input.description ?? input.siteName ?? 'svedocs');
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630">
+  <rect width="1200" height="630" fill="#11130f"/>
+  <path d="M0 84h1200M0 168h1200M0 252h1200M0 336h1200M0 420h1200M0 504h1200M120 0v630M240 0v630M360 0v630M480 0v630M600 0v630M720 0v630M840 0v630M960 0v630M1080 0v630" stroke="#2f332d" stroke-width="2"/>
+  <rect x="84" y="84" width="96" height="96" fill="#50d6b3"/>
+  <rect x="180" y="180" width="96" height="96" fill="#ff8a66"/>
+  <rect x="84" y="276" width="96" height="96" fill="#f4f1e8"/>
+  <text x="300" y="270" fill="#f4f1e8" font-family="Arial, sans-serif" font-size="78" font-weight="800">${title}</text>
+  <text x="306" y="352" fill="#aaa698" font-family="Arial, sans-serif" font-size="34">${description}</text>
+</svg>`;
+}
+export function createDefaultOgTemplateNode(input) {
+    return {
+        type: 'div',
+        props: {
+            style: {
+                display: 'flex',
+                width: '1200px',
+                height: '630px',
+                background: '#11130f',
+                color: '#f4f1e8',
+                position: 'relative',
+                fontFamily: 'Inter',
+                overflow: 'hidden'
+            },
+            children: [
+                gridLayer(),
+                pixelMark(),
+                {
+                    type: 'div',
+                    props: {
+                        style: {
+                            display: 'flex',
+                            position: 'absolute',
+                            left: '300px',
+                            top: '200px',
+                            width: '780px',
+                            flexDirection: 'column'
+                        },
+                        children: [
+                            {
+                                type: 'div',
+                                props: {
+                                    style: {
+                                        fontSize: 78,
+                                        fontWeight: 800,
+                                        lineHeight: 1,
+                                        color: '#f4f1e8'
+                                    },
+                                    children: input.title
+                                }
+                            },
+                            {
+                                type: 'div',
+                                props: {
+                                    style: {
+                                        marginTop: 28,
+                                        fontSize: 34,
+                                        lineHeight: 1.25,
+                                        color: '#aaa698'
+                                    },
+                                    children: input.description ?? input.siteName ?? 'svedocs'
+                                }
+                            }
+                        ]
+                    }
+                }
+            ]
+        }
+    };
+}
+export async function createSatoriOgSvg(input, options) {
+    if (!options.fonts?.length) {
+        throw new Error('Satori OG rendering requires at least one font.');
+    }
+    const { default: satori } = await importOptionalOgModule('satori');
+    return satori((options.template ?? createDefaultOgTemplateNode)(input), {
+        width: 1200,
+        height: 630,
+        fonts: options.fonts
+    });
+}
+export async function createOgImage(input, options = {}) {
+    return options.format === 'png' ? createOgPng(input, options) : renderOgSvg(input, options);
+}
+export async function createOgPng(input, options = {}) {
+    const { Resvg } = await importOptionalOgModule('@resvg/resvg-js');
+    const renderer = new Resvg(await renderOgSvg(input, options), {
+        fitTo: {
+            mode: 'width',
+            value: 1200
+        }
+    });
+    return renderer.render().asPng();
+}
+function gridLayer() {
+    return {
+        type: 'div',
+        props: {
+            style: {
+                display: 'flex',
+                position: 'absolute',
+                inset: 0,
+                backgroundImage: 'linear-gradient(#2f332d 2px, transparent 2px), linear-gradient(90deg, #2f332d 2px, transparent 2px)',
+                backgroundSize: '120px 84px'
+            }
+        }
+    };
+}
+function pixelMark() {
+    return {
+        type: 'div',
+        props: {
+            style: {
+                display: 'flex',
+                position: 'absolute',
+                left: '84px',
+                top: '84px',
+                width: '192px',
+                height: '288px',
+                flexWrap: 'wrap'
+            },
+            children: [
+                colorBlock('#50d6b3'),
+                colorBlock('transparent'),
+                colorBlock('transparent'),
+                colorBlock('#ff8a66'),
+                colorBlock('#f4f1e8'),
+                colorBlock('transparent')
+            ]
+        }
+    };
+}
+function colorBlock(color) {
+    return {
+        type: 'div',
+        props: {
+            style: {
+                width: '96px',
+                height: '96px',
+                background: color
+            }
+        }
+    };
+}
+async function renderOgSvg(input, options) {
+    return options.renderer === 'satori' ? createSatoriOgSvg(input, options) : createOgSvg(input);
+}
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function toArrayBuffer(value) {
+    return value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength);
+}
+function importOptionalOgModule(specifier) {
+    if (typeof process !== 'undefined' && process.versions?.node) {
+        return import(specifier);
+    }
+    // Keep optional Node-only OG renderers out of edge bundles unless the caller actually uses them.
+    const dynamicImport = new Function('specifier', 'return import(specifier)');
+    return dynamicImport(specifier);
+}

package/dist/og/metadata.d.ts

@@ -0,0 +1,7 @@
+import type { SvedocsPage, SvedocsResolvedConfig } from '../core.js';
+import type { SvedocsPageAlternate, SvedocsPageMetadata } from './types.js';
+export declare function createPageMetadata(config: SvedocsResolvedConfig, page: SvedocsPage): SvedocsPageMetadata;
+export declare function createSitemapXml(config: SvedocsResolvedConfig, pages: SvedocsPage[]): string;
+export declare function createPageAlternates(config: SvedocsResolvedConfig, page: SvedocsPage, pages: SvedocsPage[]): SvedocsPageAlternate[];
+export declare function createRobotsTxt(config: SvedocsResolvedConfig): string;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/og/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/og/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,GAAG,mBAAmB,CAwCxG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAe5F;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,EAAE,GACnB,oBAAoB,EAAE,CA+BxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAOrE"}

package/dist/og/metadata.js

@@ -0,0 +1,160 @@
+import { createConfiguredOgImageFormat, createPageOgImagePath } from './image.js';
+export function createPageMetadata(config, page) {
+    const title = page.routePath === '/' ? page.seo.title : `${page.seo.title} | ${config.site.name}`;
+    const description = page.seo.description ?? config.site.description;
+    const canonical = page.seo.canonical ?? createAbsoluteUrl(config, page.routePath);
+    const generatedImage = config.seo.ogImage === false
+        ? undefined
+        : createAbsoluteUrl(config, createPageOgImagePath(page, createConfiguredOgImageFormat(config)));
+    const image = page.seo.image ? createAbsoluteUrl(config, page.seo.image) : generatedImage;
+    const type = page.seo.type ?? (page.kind === 'doc' ? 'article' : 'website');
+    const author = page.seo.author ?? config.seo.defaultAuthor;
+    const updatedTime = page.seo.updatedTime ?? page.lastUpdated;
+    return {
+        title,
+        description,
+        ...(canonical ? { canonical } : {}),
+        ...(image ? { image } : {}),
+        openGraph: {
+            title,
+            description,
+            type,
+            ...(canonical ? { url: canonical } : {}),
+            ...(image ? { image } : {}),
+            siteName: config.site.name,
+            ...(author ? { author } : {}),
+            ...(page.seo.publishedTime ? { publishedTime: page.seo.publishedTime } : {}),
+            ...(updatedTime ? { updatedTime } : {})
+        },
+        twitter: {
+            card: image ? 'summary_large_image' : 'summary',
+            title,
+            description,
+            ...(image ? { image } : {})
+        },
+        jsonLd: createPageJsonLd(config, page, {
+            title,
+            description,
+            ...(canonical ? { canonical } : {}),
+            ...(image ? { image } : {})
+        })
+    };
+}
+export function createSitemapXml(config, pages) {
+    const urls = pages
+        .filter((page) => !page.hidden)
+        .map((page) => {
+        const loc = page.seo.canonical ?? createAbsoluteUrl(config, page.routePath) ?? page.routePath;
+        const lastmod = page.seo.updatedTime ?? page.lastUpdated;
+        return [
+            '  <url>',
+            `    <loc>${escapeXml(loc)}</loc>`,
+            ...(lastmod ? [`    <lastmod>${escapeXml(lastmod)}</lastmod>`] : []),
+            '  </url>'
+        ].join('\n');
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urls}\n</urlset>\n`;
+}
+export function createPageAlternates(config, page, pages) {
+    if (config.i18n.locales.length === 0)
+        return [];
+    const candidates = pages
+        .filter((candidate) => !candidate.hidden)
+        .filter((candidate) => candidate.scopePath === page.scopePath);
+    const alternates = [];
+    for (const candidate of candidates) {
+        if (!candidate.locale)
+            continue;
+        const href = candidate.seo.canonical ?? createAbsoluteUrl(config, candidate.routePath);
+        if (!href)
+            continue;
+        alternates.push({
+            lang: candidate.locale,
+            href,
+            locale: candidate.locale
+        });
+    }
+    const defaultLocale = config.i18n.defaultLocale;
+    const defaultPage = defaultLocale
+        ? candidates.find((candidate) => candidate.locale === defaultLocale)
+        : undefined;
+    const defaultHref = defaultPage?.seo.canonical ?? (defaultPage ? createAbsoluteUrl(config, defaultPage.routePath) : undefined);
+    const defaultAlternate = defaultHref
+        ? [
+            {
+                lang: 'x-default',
+                href: defaultHref,
+                ...(defaultLocale ? { locale: defaultLocale } : {})
+            }
+        ]
+        : [];
+    return uniqueAlternates([...alternates, ...defaultAlternate]);
+}
+export function createRobotsTxt(config) {
+    const sitemap = createAbsoluteUrl(config, '/sitemap.xml');
+    return [
+        'User-agent: *',
+        'Allow: /',
+        ...(sitemap ? [`Sitemap: ${sitemap}`] : [])
+    ].join('\n') + '\n';
+}
+function uniqueAlternates(alternates) {
+    const seen = new Set();
+    return alternates.filter((alternate) => {
+        const key = `${alternate.lang}:${alternate.href}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function createPageJsonLd(config, page, metadata) {
+    const graph = {
+        '@context': 'https://schema.org',
+        '@type': page.kind === 'doc' ? 'TechArticle' : 'WebPage',
+        headline: metadata.title,
+        description: metadata.description,
+        isPartOf: {
+            '@type': 'WebSite',
+            name: config.site.name,
+            ...(config.site.url ? { url: config.site.url } : {})
+        }
+    };
+    if (metadata.canonical)
+        graph.url = metadata.canonical;
+    if (metadata.image)
+        graph.image = metadata.image;
+    const author = page.seo.author ?? config.seo.defaultAuthor;
+    const updatedTime = page.seo.updatedTime ?? page.lastUpdated;
+    if (author) {
+        graph.author = {
+            '@type': 'Person',
+            name: author
+        };
+    }
+    if (page.seo.publishedTime)
+        graph.datePublished = page.seo.publishedTime;
+    if (updatedTime)
+        graph.dateModified = updatedTime;
+    if (page.kind === 'doc') {
+        graph.position = page.order;
+        graph.about = page.headings.map((heading) => heading.text);
+    }
+    return graph;
+}
+function createAbsoluteUrl(config, value) {
+    if (/^https?:\/\//.test(value))
+        return value;
+    if (!config.site.url)
+        return undefined;
+    return new URL(value, config.site.url).href;
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}