@bryanguffey/astro-standard-site 1.0.0

package/dist/comments.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Comment aggregation for standard.site documents
+ *
+ * Fetches replies/comments from various ATProto platforms:
+ * - Bluesky posts that link to your document
+ * - Direct replies to announcement posts (via bskyPostRef)
+ * - Future: Leaflet comments, WhiteWind reactions
+ *
+ * @example
+ * ```ts
+ * import { fetchComments } from 'astro-standard-site/comments';
+ *
+ * const comments = await fetchComments({
+ *   documentUri: 'at://did:plc:xxx/site.standard.document/abc123',
+ *   bskyPostUri: 'at://did:plc:xxx/app.bsky.feed.post/xyz789',
+ * });
+ *
+ * // comments is an array of unified Comment objects
+ * ```
+ */
+export interface Author {
+    did: string;
+    handle: string;
+    displayName?: string;
+    avatar?: string;
+}
+export interface Comment {
+    /** Unique identifier (AT-URI) */
+    uri: string;
+    /** Content ID */
+    cid: string;
+    /** Comment text */
+    text: string;
+    /** Author information */
+    author: Author;
+    /** When the comment was created */
+    createdAt: Date;
+    /** Source platform */
+    source: 'bluesky' | 'leaflet' | 'whitewind' | 'unknown';
+    /** URL to view the comment on its platform */
+    sourceUrl: string;
+    /** Parent comment URI (for threaded replies) */
+    parentUri?: string;
+    /** Like count (if available) */
+    likeCount?: number;
+    /** Reply count (if available) */
+    replyCount?: number;
+    /** Nested replies */
+    replies?: Comment[];
+}
+export interface FetchCommentsOptions {
+    /** AT-URI of the site.standard.document record */
+    documentUri?: string;
+    /** AT-URI of a Bluesky post that announces/links the document */
+    bskyPostUri?: string;
+    /** Canonical URL of the blog post (for finding mentions) */
+    canonicalUrl?: string;
+    /** Maximum depth for nested replies */
+    maxDepth?: number;
+    /** Maximum total comments to fetch */
+    maxComments?: number;
+    /** PDS service for API calls */
+    service?: string;
+}
+/**
+ * Fetch replies to a Bluesky post
+ */
+export declare function fetchBlueskyReplies(postUri: string, options?: {
+    maxDepth?: number;
+    service?: string;
+}): Promise<Comment[]>;
+/**
+ * Search Bluesky for posts mentioning a URL
+ * Useful for finding discussions about your blog post
+ */
+export declare function searchBlueskyMentions(url: string, options?: {
+    maxResults?: number;
+    service?: string;
+}): Promise<Comment[]>;
+/**
+ * Build a tree structure from flat comments
+ */
+export declare function buildCommentTree(comments: Comment[]): Comment[];
+/**
+ * Fetch all comments for a document from multiple sources
+ */
+export declare function fetchComments(options: FetchCommentsOptions): Promise<Comment[]>;
+/**
+ * Flatten a comment tree back to an array (for simple list display)
+ */
+export declare function flattenComments(tree: Comment[]): Comment[];
+/**
+ * Get comment count (including nested replies)
+ */
+export declare function countComments(tree: Comment[]): number;
+export type { FetchCommentsOptions as CommentFetchOptions };
+//# sourceMappingURL=comments.d.ts.map

package/dist/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../src/comments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,sBAAsB;IACtB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACxD,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6DD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,OAAO,CAAC,OAAO,EAAE,CAAC,CAuBpB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,OAAO,CAAC,OAAO,EAAE,CAAC,CAsBpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAsC/D;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,EAAE,CAAC,CA4CpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAc1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAcrD;AAED,YAAY,EAAE,oBAAoB,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/comments.js

@@ -0,0 +1,221 @@
+/**
+ * Comment aggregation for standard.site documents
+ *
+ * Fetches replies/comments from various ATProto platforms:
+ * - Bluesky posts that link to your document
+ * - Direct replies to announcement posts (via bskyPostRef)
+ * - Future: Leaflet comments, WhiteWind reactions
+ *
+ * @example
+ * ```ts
+ * import { fetchComments } from 'astro-standard-site/comments';
+ *
+ * const comments = await fetchComments({
+ *   documentUri: 'at://did:plc:xxx/site.standard.document/abc123',
+ *   bskyPostUri: 'at://did:plc:xxx/app.bsky.feed.post/xyz789',
+ * });
+ *
+ * // comments is an array of unified Comment objects
+ * ```
+ */
+import { AtpAgent } from '@atproto/api';
+/**
+ * Convert a Bluesky post to our unified Comment format
+ */
+function bskyPostToComment(post, depth = 0) {
+    const author = {
+        did: post.author.did,
+        handle: post.author.handle,
+        displayName: post.author.displayName,
+        avatar: post.author.avatar,
+    };
+    // Build the Bluesky URL
+    const postId = post.uri.split('/').pop();
+    const sourceUrl = `https://bsky.app/profile/${post.author.handle}/post/${postId}`;
+    const comment = {
+        uri: post.uri,
+        cid: post.cid,
+        text: post.record?.text || '',
+        author,
+        createdAt: new Date(post.record?.createdAt || post.indexedAt),
+        source: 'bluesky',
+        sourceUrl,
+        likeCount: post.likeCount,
+        replyCount: post.replyCount,
+    };
+    // Extract parent if this is a reply
+    if (post.record?.reply?.parent?.uri) {
+        comment.parentUri = post.record.reply.parent.uri;
+    }
+    return comment;
+}
+/**
+ * Recursively process a thread tree from Bluesky
+ */
+function processThread(thread, maxDepth, currentDepth = 0) {
+    const comments = [];
+    if (!thread || currentDepth > maxDepth)
+        return comments;
+    // Process the current post if it's a reply (not the root)
+    if (thread.post && currentDepth > 0) {
+        comments.push(bskyPostToComment(thread.post, currentDepth));
+    }
+    // Process replies
+    if (thread.replies && Array.isArray(thread.replies)) {
+        for (const reply of thread.replies) {
+            const replyComments = processThread(reply, maxDepth, currentDepth + 1);
+            comments.push(...replyComments);
+        }
+    }
+    return comments;
+}
+/**
+ * Fetch replies to a Bluesky post
+ */
+export async function fetchBlueskyReplies(postUri, options = {}) {
+    const { maxDepth = 3, service = 'https://public.api.bsky.app' } = options;
+    const agent = new AtpAgent({ service });
+    try {
+        const response = await agent.api.app.bsky.feed.getPostThread({
+            uri: postUri,
+            depth: maxDepth,
+        });
+        if (!response.data.thread || response.data.thread.$type === 'app.bsky.feed.defs#notFoundPost') {
+            return [];
+        }
+        // Process the thread, skipping the root post (we only want replies)
+        const comments = processThread(response.data.thread, maxDepth, 0);
+        return comments;
+    }
+    catch (error) {
+        console.error('Failed to fetch Bluesky replies:', error);
+        return [];
+    }
+}
+/**
+ * Search Bluesky for posts mentioning a URL
+ * Useful for finding discussions about your blog post
+ */
+export async function searchBlueskyMentions(url, options = {}) {
+    const { maxResults = 25, service = 'https://public.api.bsky.app' } = options;
+    const agent = new AtpAgent({ service });
+    try {
+        // Search for posts containing the URL
+        const response = await agent.api.app.bsky.feed.searchPosts({
+            q: url,
+            limit: maxResults,
+        });
+        if (!response.data.posts) {
+            return [];
+        }
+        // Convert to our Comment format
+        return response.data.posts.map(post => bskyPostToComment(post));
+    }
+    catch (error) {
+        console.error('Failed to search Bluesky mentions:', error);
+        return [];
+    }
+}
+/**
+ * Build a tree structure from flat comments
+ */
+export function buildCommentTree(comments) {
+    const commentMap = new Map();
+    const rootComments = [];
+    // First pass: index all comments
+    for (const comment of comments) {
+        commentMap.set(comment.uri, { ...comment, replies: [] });
+    }
+    // Second pass: build tree
+    for (const comment of comments) {
+        const node = commentMap.get(comment.uri);
+        if (comment.parentUri && commentMap.has(comment.parentUri)) {
+            const parent = commentMap.get(comment.parentUri);
+            parent.replies = parent.replies || [];
+            parent.replies.push(node);
+        }
+        else {
+            rootComments.push(node);
+        }
+    }
+    // Sort by date (oldest first for conversations)
+    const sortByDate = (a, b) => a.createdAt.getTime() - b.createdAt.getTime();
+    const sortTree = (comments) => {
+        comments.sort(sortByDate);
+        for (const comment of comments) {
+            if (comment.replies?.length) {
+                sortTree(comment.replies);
+            }
+        }
+    };
+    sortTree(rootComments);
+    return rootComments;
+}
+/**
+ * Fetch all comments for a document from multiple sources
+ */
+export async function fetchComments(options) {
+    const { bskyPostUri, canonicalUrl, maxDepth = 3, maxComments = 100, service = 'https://public.api.bsky.app', } = options;
+    const allComments = [];
+    // Fetch replies to the announcement post
+    if (bskyPostUri) {
+        const replies = await fetchBlueskyReplies(bskyPostUri, { maxDepth, service });
+        allComments.push(...replies);
+    }
+    // Search for mentions of the canonical URL
+    if (canonicalUrl) {
+        const mentions = await searchBlueskyMentions(canonicalUrl, {
+            maxResults: Math.max(10, maxComments - allComments.length),
+            service,
+        });
+        // Filter out duplicates and the original post
+        const existingUris = new Set(allComments.map(c => c.uri));
+        if (bskyPostUri)
+            existingUris.add(bskyPostUri);
+        for (const mention of mentions) {
+            if (!existingUris.has(mention.uri)) {
+                allComments.push(mention);
+                existingUris.add(mention.uri);
+            }
+        }
+    }
+    // Future: Add Leaflet comment fetching
+    // Future: Add WhiteWind reaction fetching
+    // Limit total comments
+    const limitedComments = allComments.slice(0, maxComments);
+    // Build into a tree structure
+    return buildCommentTree(limitedComments);
+}
+/**
+ * Flatten a comment tree back to an array (for simple list display)
+ */
+export function flattenComments(tree) {
+    const flat = [];
+    const walk = (comments, depth = 0) => {
+        for (const comment of comments) {
+            flat.push({ ...comment, replies: undefined });
+            if (comment.replies?.length) {
+                walk(comment.replies, depth + 1);
+            }
+        }
+    };
+    walk(tree);
+    return flat;
+}
+/**
+ * Get comment count (including nested replies)
+ */
+export function countComments(tree) {
+    let count = 0;
+    const walk = (comments) => {
+        for (const comment of comments) {
+            count++;
+            if (comment.replies?.length) {
+                walk(comment.replies);
+            }
+        }
+    };
+    walk(tree);
+    return count;
+}
+//# sourceMappingURL=comments.js.map

package/dist/comments.js.map

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

package/dist/content.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Content transformation utilities for standard.site
+ *
+ * Converts Astro blog post content into formats suitable for ATProto:
+ * - Strips markdown to plain text for `textContent` (search/indexing)
+ * - Converts custom sidenotes to standard markdown
+ * - Resolves relative links to absolute URLs
+ *
+ * @example
+ * ```ts
+ * import { transformContent, stripToPlainText } from 'astro-standard-site/content';
+ *
+ * const result = transformContent(markdown, {
+ *   siteUrl: 'https://bryanguffey.com',
+ *   postPath: '/blog/my-post',
+ * });
+ *
+ * // result.markdown - cleaned markdown for ATProto
+ * // result.textContent - plain text for search
+ * ```
+ */
+export interface TransformOptions {
+    /** Base URL of your site (e.g., 'https://bryanguffey.com') */
+    siteUrl: string;
+    /** Path to the current post (e.g., '/blog/my-post') */
+    postPath?: string;
+}
+export interface TransformResult {
+    /** Transformed markdown suitable for ATProto */
+    markdown: string;
+    /** Plain text version for textContent field */
+    textContent: string;
+    /** Word count */
+    wordCount: number;
+    /** Estimated reading time in minutes */
+    readingTime: number;
+}
+/**
+ * Convert HTML sidenotes to markdown blockquotes
+ *
+ * Transforms:
+ * ```html
+ * <div class="sidenote sidenote--tip">
+ *   <span class="sidenote-label">Tip</span>
+ *   <p>Content here</p>
+ * </div>
+ * ```
+ *
+ * Into:
+ * ```markdown
+ * > **Tip:** Content here
+ * ```
+ */
+export declare function convertSidenotes(markdown: string): string;
+/**
+ * Convert HTML sidenotes (multi-paragraph) to markdown
+ * Handles more complex sidenote structures
+ */
+export declare function convertComplexSidenotes(markdown: string): string;
+/**
+ * Resolve relative URLs to absolute URLs
+ *
+ * Converts:
+ * - `[Link](/page)` → `[Link](https://example.com/page)`
+ * - `![Image](/img.png)` → `![Image](https://example.com/img.png)`
+ */
+export declare function resolveRelativeLinks(markdown: string, siteUrl: string): string;
+/**
+ * Strip markdown to plain text for indexing/search
+ *
+ * Removes:
+ * - Markdown formatting (**, *, #, etc.)
+ * - Links (keeps link text)
+ * - Images
+ * - Code blocks
+ * - HTML tags
+ */
+export declare function stripToPlainText(markdown: string): string;
+/**
+ * Calculate word count from text
+ */
+export declare function countWords(text: string): number;
+/**
+ * Calculate reading time in minutes (assuming 200 words per minute)
+ */
+export declare function calculateReadingTime(wordCount: number, wordsPerMinute?: number): number;
+/**
+ * Full content transformation pipeline
+ *
+ * Takes raw markdown (with HTML sidenotes) and produces:
+ * - Clean markdown suitable for ATProto platforms
+ * - Plain text for search/indexing
+ * - Metadata (word count, reading time)
+ */
+export declare function transformContent(rawMarkdown: string, options: TransformOptions): TransformResult;
+/**
+ * Transform an Astro blog post entry for standard.site
+ *
+ * @example
+ * ```ts
+ * import { getCollection } from 'astro:content';
+ * import { transformPost } from 'astro-standard-site/content';
+ *
+ * const posts = await getCollection('blog');
+ * for (const post of posts) {
+ *   const standardDoc = transformPost(post, {
+ *     siteUrl: 'https://bryanguffey.com',
+ *   });
+ *   await publisher.publishDocument(standardDoc);
+ * }
+ * ```
+ */
+export interface AstroBlogPost {
+    slug: string;
+    body: string;
+    data: {
+        title: string;
+        description?: string;
+        date: Date;
+        tags?: string[];
+        draft?: boolean;
+    };
+}
+export interface StandardSiteDocumentInput {
+    site: string;
+    title: string;
+    publishedAt: string;
+    path?: string;
+    description?: string;
+    tags?: string[];
+    textContent?: string;
+    content?: {
+        $type: string;
+        text: string;
+        version?: string;
+    };
+}
+export declare function transformPost(post: AstroBlogPost, options: {
+    siteUrl: string;
+}): StandardSiteDocumentInput;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqChE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAY9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0CzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,SAAM,GAAG,MAAM,CAEpF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAuBjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,IAAI,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3B,yBAAyB,CAuB3B"}

package/dist/content.js

@@ -0,0 +1,202 @@
+/**
+ * Content transformation utilities for standard.site
+ *
+ * Converts Astro blog post content into formats suitable for ATProto:
+ * - Strips markdown to plain text for `textContent` (search/indexing)
+ * - Converts custom sidenotes to standard markdown
+ * - Resolves relative links to absolute URLs
+ *
+ * @example
+ * ```ts
+ * import { transformContent, stripToPlainText } from 'astro-standard-site/content';
+ *
+ * const result = transformContent(markdown, {
+ *   siteUrl: 'https://bryanguffey.com',
+ *   postPath: '/blog/my-post',
+ * });
+ *
+ * // result.markdown - cleaned markdown for ATProto
+ * // result.textContent - plain text for search
+ * ```
+ */
+/**
+ * Convert HTML sidenotes to markdown blockquotes
+ *
+ * Transforms:
+ * ```html
+ * <div class="sidenote sidenote--tip">
+ *   <span class="sidenote-label">Tip</span>
+ *   <p>Content here</p>
+ * </div>
+ * ```
+ *
+ * Into:
+ * ```markdown
+ * > **Tip:** Content here
+ * ```
+ */
+export function convertSidenotes(markdown) {
+    // Match sidenote divs with various formats
+    const sidenoteRegex = /<div\s+class="sidenote(?:\s+sidenote--(warning|tip))?">\s*<span\s+class="sidenote-label">([^<]+)<\/span>\s*<p>([^<]+)<\/p>\s*<\/div>/gi;
+    return markdown.replace(sidenoteRegex, (_, type, label, content) => {
+        // Clean up the content
+        const cleanContent = content.trim();
+        const cleanLabel = label.trim();
+        // Convert to blockquote with label
+        return `\n> **${cleanLabel}:** ${cleanContent}\n`;
+    });
+}
+/**
+ * Convert HTML sidenotes (multi-paragraph) to markdown
+ * Handles more complex sidenote structures
+ */
+export function convertComplexSidenotes(markdown) {
+    // First pass: simple sidenotes
+    let result = convertSidenotes(markdown);
+    // Second pass: sidenotes with multiple paragraphs or nested content
+    const complexSidenoteRegex = /<div\s+class="sidenote[^"]*">([\s\S]*?)<\/div>/gi;
+    result = result.replace(complexSidenoteRegex, (match, innerContent) => {
+        // Extract label if present
+        const labelMatch = innerContent.match(/<span\s+class="sidenote-label">([^<]+)<\/span>/i);
+        const label = labelMatch ? labelMatch[1].trim() : 'Note';
+        // Remove the label span
+        let content = innerContent.replace(/<span\s+class="sidenote-label">[^<]+<\/span>/gi, '');
+        // Convert remaining HTML to plain text with basic formatting
+        content = content
+            .replace(/<p>/gi, '')
+            .replace(/<\/p>/gi, '\n')
+            .replace(/<strong>/gi, '**')
+            .replace(/<\/strong>/gi, '**')
+            .replace(/<em>/gi, '*')
+            .replace(/<\/em>/gi, '*')
+            .replace(/<a\s+href="([^"]+)"[^>]*>([^<]+)<\/a>/gi, '[$2]($1)')
+            .replace(/<[^>]+>/g, '') // Remove any remaining HTML tags
+            .trim();
+        // Format as blockquote
+        const lines = content.split('\n').filter((line) => line.trim());
+        const quotedLines = lines.map((line, i) => i === 0 ? `> **${label}:** ${line}` : `> ${line}`);
+        return '\n' + quotedLines.join('\n') + '\n';
+    });
+    return result;
+}
+/**
+ * Resolve relative URLs to absolute URLs
+ *
+ * Converts:
+ * - `[Link](/page)` → `[Link](https://example.com/page)`
+ * - `![Image](/img.png)` → `![Image](https://example.com/img.png)`
+ */
+export function resolveRelativeLinks(markdown, siteUrl) {
+    const baseUrl = siteUrl.replace(/\/$/, '');
+    // Match markdown links and images with relative URLs
+    // [text](/path) or ![alt](/path)
+    const linkRegex = /(!?\[[^\]]*\])\((?!https?:\/\/|mailto:|#)([^)]+)\)/g;
+    return markdown.replace(linkRegex, (_, prefix, path) => {
+        // Ensure path starts with /
+        const absolutePath = path.startsWith('/') ? path : `/${path}`;
+        return `${prefix}(${baseUrl}${absolutePath})`;
+    });
+}
+/**
+ * Strip markdown to plain text for indexing/search
+ *
+ * Removes:
+ * - Markdown formatting (**, *, #, etc.)
+ * - Links (keeps link text)
+ * - Images
+ * - Code blocks
+ * - HTML tags
+ */
+export function stripToPlainText(markdown) {
+    let text = markdown;
+    // Remove code blocks first (preserve nothing)
+    text = text.replace(/```[\s\S]*?```/g, '');
+    text = text.replace(/`[^`]+`/g, '');
+    // Remove images
+    text = text.replace(/!\[[^\]]*\]\([^)]+\)/g, '');
+    // Convert links to just their text
+    text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1');
+    // Remove HTML tags
+    text = text.replace(/<[^>]+>/g, '');
+    // Remove heading markers
+    text = text.replace(/^#{1,6}\s+/gm, '');
+    // Remove bold/italic markers
+    text = text.replace(/\*\*([^*]+)\*\*/g, '$1');
+    text = text.replace(/\*([^*]+)\*/g, '$1');
+    text = text.replace(/__([^_]+)__/g, '$1');
+    text = text.replace(/_([^_]+)_/g, '$1');
+    // Remove blockquote markers
+    text = text.replace(/^>\s*/gm, '');
+    // Remove list markers
+    text = text.replace(/^[\s]*[-*+]\s+/gm, '');
+    text = text.replace(/^[\s]*\d+\.\s+/gm, '');
+    // Remove horizontal rules
+    text = text.replace(/^[-*_]{3,}$/gm, '');
+    // Collapse multiple newlines
+    text = text.replace(/\n{3,}/g, '\n\n');
+    // Trim whitespace
+    text = text.trim();
+    return text;
+}
+/**
+ * Calculate word count from text
+ */
+export function countWords(text) {
+    return text.split(/\s+/).filter(word => word.length > 0).length;
+}
+/**
+ * Calculate reading time in minutes (assuming 200 words per minute)
+ */
+export function calculateReadingTime(wordCount, wordsPerMinute = 200) {
+    return Math.max(1, Math.ceil(wordCount / wordsPerMinute));
+}
+/**
+ * Full content transformation pipeline
+ *
+ * Takes raw markdown (with HTML sidenotes) and produces:
+ * - Clean markdown suitable for ATProto platforms
+ * - Plain text for search/indexing
+ * - Metadata (word count, reading time)
+ */
+export function transformContent(rawMarkdown, options) {
+    // Step 1: Convert sidenotes from HTML to markdown blockquotes
+    let markdown = convertComplexSidenotes(rawMarkdown);
+    // Step 2: Resolve relative links to absolute URLs
+    markdown = resolveRelativeLinks(markdown, options.siteUrl);
+    // Step 3: Clean up extra whitespace
+    markdown = markdown.replace(/\n{3,}/g, '\n\n').trim();
+    // Step 4: Generate plain text version
+    const textContent = stripToPlainText(markdown);
+    // Step 5: Calculate metadata
+    const wordCount = countWords(textContent);
+    const readingTime = calculateReadingTime(wordCount);
+    return {
+        markdown,
+        textContent,
+        wordCount,
+        readingTime,
+    };
+}
+export function transformPost(post, options) {
+    const postPath = `/blog/${post.slug}`;
+    // Transform the content
+    const transformed = transformContent(post.body, {
+        siteUrl: options.siteUrl,
+        postPath,
+    });
+    return {
+        site: options.siteUrl,
+        title: post.data.title,
+        publishedAt: post.data.date.toISOString(),
+        path: postPath,
+        description: post.data.description,
+        tags: post.data.tags,
+        textContent: transformed.textContent,
+        content: {
+            $type: 'site.standard.content.markdown',
+            text: transformed.markdown,
+            version: '1.0',
+        },
+    };
+}
+//# sourceMappingURL=content.js.map