@leafpad/blogs 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './src/blogs.js';
+export * from './src/blog_config.js';
+export * from './src/types.js';
+export * from './src/BlogPostFormat.js';
+export { default as BlogUtils } from './src/BlogUtils.js';
+export { default as BlogApiError } from './src/BlogsError.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Re-export public API from the library's source so consumers can import from the package root.
+export * from './src/blogs.js';
+export * from './src/blog_config.js';
+export * from './src/types.js';
+export * from './src/BlogPostFormat.js';
+export { default as BlogUtils } from './src/BlogUtils.js';
+export { default as BlogApiError } from './src/BlogsError.js';
+// Note: stylesheet (`style.css`) is included in the package files but cannot be exported from JS.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE9D,kGAAkG"}

package/dist/src/BlogPostFormat.d.ts

@@ -0,0 +1,70 @@
+import type { BlogTag, BlogPost } from "./types.js";
+export interface BlogPostHeaderProps {
+    title: string;
+    description: string | undefined;
+    image: string | undefined;
+    tags: BlogTag[] | undefined;
+    author: string;
+    date: string;
+    readTime: string;
+}
+export interface BlogPostContentProps {
+    htmlContent: string;
+}
+export interface BlogPostTagsProps {
+    tags?: BlogTag[];
+}
+export interface BlogPostAuthorProps {
+    author: string;
+    organization?: string;
+}
+export interface BlogPostMetaProps {
+    date: string;
+    readTime: string;
+}
+export declare class BlogPostFormat {
+    static header({ title, description, image, tags, author, date, readTime }: BlogPostHeaderProps): string;
+    static headerImage({ image, title }: {
+        image: string | undefined;
+        title: string;
+    }): string;
+    static headerTitle({ title }: {
+        title: string;
+    }): string;
+    static headerDescription({ description }: {
+        description: string | undefined;
+    }): string;
+    static headerTags({ tags }: {
+        tags: BlogTag[] | undefined;
+    }): string;
+    static headerMeta({ author, date, readTime }: {
+        author: string;
+        date: string;
+        readTime: string;
+    }): string;
+    static content({ htmlContent }: BlogPostContentProps): string;
+    static tags({ tags }: BlogPostTagsProps): string;
+    static author({ author, organization }: BlogPostAuthorProps): string;
+    static meta({ date, readTime }: BlogPostMetaProps): string;
+    static divider(): string;
+    static blogCards({ posts, urlPrefix }: {
+        posts: BlogPost[];
+        urlPrefix?: string;
+    }): string;
+    static blogCard({ post, urlPrefix }: {
+        post: BlogPost;
+        urlPrefix?: string;
+    }): string;
+    static blogPostWithToc({ post }: {
+        post: BlogPost;
+    }): string;
+    static completeBlogPost({ post }: {
+        post: BlogPost;
+    }): string;
+    static toc(tocItems: {
+        level: number;
+        text: string;
+        id: string;
+    }[]): string;
+}
+//# sourceMappingURL=BlogPostFormat.d.ts.map

package/dist/src/BlogPostFormat.d.ts.map

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

package/dist/src/BlogPostFormat.js

@@ -0,0 +1,129 @@
+import BlogUtils from "./BlogUtils.js";
+import { renderTOCHTML } from "./createToc.js";
+export class BlogPostFormat {
+    static header({ title, description, image, tags, author, date, readTime }) {
+        return `
+      <header class="blog-post-header">
+        ${BlogPostFormat.headerImage({ image, title })}
+        ${BlogPostFormat.headerTitle({ title })}
+        ${BlogPostFormat.headerDescription({ description })}
+        ${BlogPostFormat.headerTags({ tags })}
+        ${BlogPostFormat.headerMeta({ author, date, readTime })}
+      </header>
+    `;
+    }
+    static headerImage({ image, title }) {
+        return image ? `<img src='${image}' alt='${title}' class="blog-post-header-image" />` : "";
+    }
+    static headerTitle({ title }) {
+        return `<h1 class="blog-post-title" id="${BlogUtils.slugify(title)}">${title}</h1>`;
+    }
+    static headerDescription({ description }) {
+        return description ? `<p class="blog-post-description">${description}</p>` : "";
+    }
+    static headerTags({ tags }) {
+        let tagsArr = Array.isArray(tags) ? tags : [];
+        if (!tagsArr.length)
+            return "";
+        return `<div class="blog-post-tags">${tagsArr.map(tag => `<span class="blog-post-tag">${tag.name}</span>`).join("")}</div>`;
+    }
+    static headerMeta({ author, date, readTime }) {
+        return `<div class="blog-post-meta">
+      <span class="blog-post-date">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-calendar" aria-hidden="true"><path d="M8 2v4"></path><path d="M16 2v4"></path><rect width="18" height="18" x="3" y="4" rx="2"></rect><path d="M3 10h18"></path></svg>
+        ${date}
+      </span>
+      <span class="blog-post-readtime">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-clock" aria-hidden="true"><path d="M12 6v6l4 2"></path><circle cx="12" cy="12" r="10"></circle></svg>
+        ${readTime}
+      </span>
+    </div>`;
+    }
+    static content({ htmlContent }) {
+        return `
+      <section class="blog-post-content">
+        <div>${htmlContent}</div>
+      </section>
+    `;
+    }
+    static tags({ tags }) {
+        let tagsArr = Array.isArray(tags) ? tags : [];
+        if (!tagsArr.length)
+            return "";
+        return `
+      <section class="blog-post-tags-section">
+        <h3 class="blog-post-tags-title">Tags</h3>
+        <div class="blog-post-tags">
+          ${tagsArr.map(tag => `<span class="blog-post-tag">${tag.name}</span>`).join("")}
+        </div>
+      </section>
+    `;
+    }
+    static author({ author, organization }) {
+        return `<div class="blog-post-author-section">
+      <div class="blog-post-author-avatar">
+        ${author.charAt(0).toUpperCase()}
+      </div>
+      <div>
+        <div class="blog-post-author-name">${author}</div>
+        <div class="blog-post-author-organization">
+          Published in ${organization}
+        </div>
+      </div>
+    </div>`;
+    }
+    static meta({ date, readTime }) {
+        return `<div class="blog-post-meta-section"><span class="blog-post-date">${date}</span><span class="blog-post-readtime">${readTime}</span></div>`;
+    }
+    static divider() {
+        return '<hr class="blog-post-divider" />';
+    }
+    static blogCards({ posts, urlPrefix = "/blog" }) {
+        return `<div class="blog-cards-container">
+      ${posts.map(post => this.blogCard({ post, urlPrefix })).join("")}
+    </div>`;
+    }
+    static blogCard({ post, urlPrefix = "/blog" }) {
+        return `<div class="blog-card">
+        <div class="image-container"> 
+          ${BlogPostFormat.headerImage({ image: post.seo?.image || "", title: post.name })}
+        </div>
+        <h4 class="post-title">${post.name}</h4>
+        <p class="post-excerpt">${post.seo?.description || post.textContent ||
+            (post.htmlContent ? BlogUtils.extractTextFromHtml(post.htmlContent, 150) : '')}</p>
+        ${BlogPostFormat.headerMeta({ author: post.createdByUser.name, date: BlogUtils.formatDate(post.createdAt), readTime: BlogUtils.calculateReadTime(post.htmlContent || "") })}
+        <a href="${urlPrefix}/${post.slug}" class="btn btn-outline btn-sm">Read More</a>
+        </div>`;
+    }
+    static blogPostWithToc({ post }) {
+        const htmlContent = this.completeBlogPost({ post });
+        const tocHtml = this.toc(post.tocItems);
+        return `<div class="blog-post-with-toc">
+        ${htmlContent}
+      <aside class="blog-post-toc" id="toc">
+        <h3 class="blog-post-toc-title">Table of Contents</h3>
+        <nav>${tocHtml}</nav>
+      </aside>
+    </div>`;
+    }
+    static completeBlogPost({ post }) {
+        const headerHtml = [
+            BlogPostFormat.headerTitle({ title: post.name }),
+            BlogPostFormat.headerDescription({ description: post.seo?.description || "" }),
+            BlogPostFormat.headerMeta({ author: post.createdByUser.name, date: BlogUtils.formatDate(post.updatedAt), readTime: BlogUtils.calculateReadTime(post.htmlContent || "") }),
+            BlogPostFormat.author({ author: post.createdByUser.name, organization: post.organization.name }),
+            // BlogPostFormat.headerTags({ tags }),
+            BlogPostFormat.divider(),
+            BlogPostFormat.headerImage({ image: post.seo?.image || "", title: post.name }),
+        ].join("");
+        return [
+            `<div class="blogs-container"><header class="blog-post-header">${headerHtml}</header>`,
+            BlogPostFormat.content({ htmlContent: post.htmlContent || "" }),
+            BlogPostFormat.tags({ tags: post.tags || [] }) + "</div>",
+        ].join("");
+    }
+    static toc(tocItems) {
+        return renderTOCHTML(tocItems);
+    }
+}
+//# sourceMappingURL=BlogPostFormat.js.map

package/dist/src/BlogPostFormat.js.map

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

package/dist/src/BlogUtils.d.ts

@@ -0,0 +1,20 @@
+export default class BlogUtils {
+    /**
+   * Utility: Calculate reading time for content
+   */
+    static calculateReadTime(content: string): string;
+    /**
+     * Utility: Format date for display
+     */
+    static formatDate(dateString: string, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Utility: Extract text content from HTML
+     */
+    static extractTextFromHtml(html: string, maxLength?: number): string;
+    static slugify(text: string): string;
+    static attachTocListener(tocId?: string): {
+        observer: IntersectionObserver;
+        destroy: () => void;
+    };
+}
+//# sourceMappingURL=BlogUtils.d.ts.map

package/dist/src/BlogUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogUtils.d.ts","sourceRoot":"","sources":["../../src/BlogUtils.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B;;KAEC;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAOjD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM;IAanF;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAQpE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASpC,MAAM,CAAC,iBAAiB,CAAC,KAAK,GAAE,MAAc;;;;CAG/C"}

package/dist/src/BlogUtils.js

@@ -0,0 +1,49 @@
+import { attachObserverToTOCLinks } from "./createToc.js";
+export default class BlogUtils {
+    /**
+   * Utility: Calculate reading time for content
+   */
+    static calculateReadTime(content) {
+        if (!content)
+            return '1 min read';
+        const words = content.replace(/<[^>]*>/g, '').split(/\s+/).length;
+        const minutes = Math.ceil(words / 100);
+        return `${minutes} min read`;
+    }
+    /**
+     * Utility: Format date for display
+     */
+    static formatDate(dateString, options) {
+        const defaultOptions = {
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric'
+        };
+        return new Date(dateString).toLocaleDateString('en-US', {
+            ...defaultOptions,
+            ...options
+        });
+    }
+    /**
+     * Utility: Extract text content from HTML
+     */
+    static extractTextFromHtml(html, maxLength) {
+        const text = html.replace(/<[^>]*>/g, '').trim();
+        if (maxLength && text.length > maxLength) {
+            return text.slice(0, maxLength) + '...';
+        }
+        return text;
+    }
+    static slugify(text) {
+        return text
+            .toLowerCase()
+            .trim()
+            .replace(/[^\w\s-]/g, '') // Remove special characters except spaces and hyphens
+            .replace(/[\s_-]+/g, '-') // Replace spaces and underscores with hyphens
+            .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+    }
+    static attachTocListener(tocId = 'toc') {
+        return attachObserverToTOCLinks(tocId);
+    }
+}
+//# sourceMappingURL=BlogUtils.js.map

package/dist/src/BlogUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogUtils.js","sourceRoot":"","sources":["../../src/BlogUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B;;KAEC;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAe;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,YAAY,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;QACvC,OAAO,GAAG,OAAO,WAAW,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAoC;QACxE,MAAM,cAAc,GAA+B;YACjD,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,SAAS;SACf,CAAC;QAEF,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;YACtD,GAAG,cAAc;YACjB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAY,EAAE,SAAkB;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,OAAO,IAAI;aACV,WAAW,EAAE;aACb,IAAI,EAAE;aACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,sDAAsD;aAC/E,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,8CAA8C;aACvE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC;IAC9D,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,QAAgB,KAAK;QAC5C,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/src/BlogsError.d.ts

@@ -0,0 +1,6 @@
+export default class BlogApiError extends Error {
+    status?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+//# sourceMappingURL=BlogsError.d.ts.map

package/dist/src/BlogsError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogsError.d.ts","sourceRoot":"","sources":["../../src/BlogsError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,KAAK;IAGpC,MAAM,CAAC,EAAE,MAAM;IACf,IAAI,CAAC,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM,EACR,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB"}

package/dist/src/BlogsError.js

@@ -0,0 +1,11 @@
+export default class BlogApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'BlogApiError';
+    }
+}
+//# sourceMappingURL=BlogsError.js.map

package/dist/src/BlogsError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogsError.js","sourceRoot":"","sources":["../../src/BlogsError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,KAAK;IAGpC;IACA;IAHT,YACE,OAAe,EACR,MAAe,EACf,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/src/blog_config.d.ts

@@ -0,0 +1,23 @@
+export type BlogsConfigType = {
+    baseUrl?: string;
+    apiPath?: string;
+    defaultLimit?: number;
+    maxPostsForFiltering?: number;
+    cacheRevalidateInterval?: number;
+    staticParamsRevalidateInterval?: number;
+    wordsPerMinute?: number;
+    timeout?: number;
+    retries?: number;
+};
+export declare const BLOG_CONFIG: {
+    readonly baseUrl: "https://leafpad.io";
+    readonly apiPath: "/api/public/v1/post";
+    readonly defaultLimit: 10;
+    readonly maxPostsForFiltering: 50;
+    readonly cacheRevalidateInterval: 300;
+    readonly staticParamsRevalidateInterval: 3600;
+    readonly wordsPerMinute: 200;
+    readonly timeout: 10000;
+    readonly retries: 3;
+};
+//# sourceMappingURL=blog_config.d.ts.map

package/dist/src/blog_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog_config.d.ts","sourceRoot":"","sources":["../../src/blog_config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC"}

package/dist/src/blog_config.js

@@ -0,0 +1,12 @@
+export const BLOG_CONFIG = {
+    baseUrl: "https://leafpad.io",
+    apiPath: '/api/public/v1/post',
+    defaultLimit: 10,
+    maxPostsForFiltering: 50,
+    cacheRevalidateInterval: 300, // 5 minutes
+    staticParamsRevalidateInterval: 3600, // 1 hour
+    wordsPerMinute: 200,
+    timeout: 10000, // 10 seconds
+    retries: 3
+};
+//# sourceMappingURL=blog_config.js.map

package/dist/src/blog_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog_config.js","sourceRoot":"","sources":["../../src/blog_config.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,oBAAoB;IAC7B,OAAO,EAAE,qBAAqB;IAC9B,YAAY,EAAE,EAAE;IAChB,oBAAoB,EAAE,EAAE;IACxB,uBAAuB,EAAE,GAAG,EAAE,YAAY;IAC1C,8BAA8B,EAAE,IAAI,EAAE,SAAS;IAC/C,cAAc,EAAE,GAAG;IACnB,OAAO,EAAE,KAAK,EAAE,aAAa;IAC7B,OAAO,EAAE,CAAC;CACF,CAAC"}

package/dist/src/blogs.d.ts

@@ -0,0 +1,19 @@
+import { type BlogsConfigType } from './blog_config.js';
+import type { BlogPost, FetchPostOptions, FetchPostsOptions, BlogApiResponse, DocsResponse } from './types.js';
+export declare class BlogsService {
+    private config;
+    constructor(organizationSlug: string, blogsConfig?: BlogsConfigType);
+    /**
+     * Build the API URL for blog posts
+     */
+    private buildUrl;
+    private makeRequest;
+    private fetchItems;
+    fetchDocs(options?: FetchPostsOptions): Promise<DocsResponse>;
+    /**
+     * Fetch multiple blog posts with pagination and filtering
+     */
+    fetchPosts(options?: FetchPostsOptions): Promise<BlogApiResponse>;
+    fetchBlog(slug: string, options?: FetchPostOptions): Promise<BlogPost | null>;
+}
+//# sourceMappingURL=blogs.d.ts.map

package/dist/src/blogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blogs.d.ts","sourceRoot":"","sources":["../../src/blogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAiB,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAW,MAAM,YAAY,CAAC;AAIvI,qBAAa,YAAY;IAEvB,OAAO,CAAC,MAAM,CAAyB;gBAE3B,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe;IAQnE;;OAEG;IACH,OAAO,CAAC,QAAQ;YAMF,WAAW;YAwDX,UAAU;IA6BlB,SAAS,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;IA+CvE;;OAEG;IACG,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAiBxF"}

package/dist/src/blogs.js

@@ -0,0 +1,139 @@
+import { BLOG_CONFIG } from './blog_config.js';
+import BlogApiError from './BlogsError.js';
+import { attachObserverToTOCLinks } from './createToc.js';
+export class BlogsService {
+    config;
+    constructor(organizationSlug, blogsConfig) {
+        this.config = {
+            organizationSlug,
+            ...BLOG_CONFIG,
+            ...blogsConfig
+        };
+    }
+    /**
+     * Build the API URL for blog posts
+     */
+    buildUrl(endpoint = '', params) {
+        const baseUrl = `${this.config.baseUrl}${this.config.apiPath}/${this.config.organizationSlug}`;
+        const url = endpoint ? `${baseUrl}/${endpoint}` : baseUrl;
+        return params ? `${url}?${params.toString()}` : url;
+    }
+    async makeRequest(url, options = {}) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        let lastError = new Error('Unknown error');
+        for (let attempt = 1; attempt <= this.config.retries; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    ...options,
+                    signal: controller.signal,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...options.headers,
+                    },
+                });
+                console.log('Fetch attempt', attempt, 'for URL:', url);
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    const errorBody = await response.text().catch(() => '');
+                    throw new BlogApiError(`HTTP ${response.status}: ${response.statusText}${errorBody ? ` - ${errorBody}` : ''}`, response.status, `HTTP_${response.status}`);
+                }
+                const data = await response.json();
+                return data;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Don't retry on 4xx errors or abort errors
+                if (error instanceof BlogApiError && error.status && error.status < 500) {
+                    throw error;
+                }
+                if (lastError.name === 'AbortError') {
+                    throw new BlogApiError('Request timeout', undefined, 'TIMEOUT');
+                }
+                // Wait before retry (exponential backoff)
+                if (attempt < this.config.retries) {
+                    await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
+                }
+            }
+        }
+        clearTimeout(timeoutId);
+        throw new BlogApiError(`Failed after ${this.config.retries} attempts: ${lastError.message}`, undefined, 'MAX_RETRIES_EXCEEDED');
+    }
+    async fetchItems(options = {}) {
+        const { page = 1, limit = this.config.defaultLimit, includeHtml = true, tags = [], search = '' } = options;
+        const params = new URLSearchParams();
+        params.append('page', page.toString());
+        params.append('limit', limit.toString());
+        if (includeHtml) {
+            params.append('html', 'true');
+        }
+        if (tags.length > 0) {
+            params.append('tags', tags.join(','));
+        }
+        if (search.trim()) {
+            params.append('search', search.trim());
+        }
+        const url = this.buildUrl('', params);
+        return this.makeRequest(url);
+    }
+    async fetchDocs(options = {}) {
+        const blogsResponse = await this.fetchItems(options);
+        const inPlaceSort = (arr, compareFn) => {
+            arr.sort(compareFn);
+            arr.forEach(item => {
+                if (item.children && item.children.length > 0) {
+                    inPlaceSort(item.children, compareFn);
+                }
+            });
+        };
+        // format response in docs format
+        // nest all blogsResponse.posts into children based on DocItem each item has parentId
+        const items = {};
+        blogsResponse.posts.forEach(post => {
+            items[post.id] = { id: post.id, label: post.name, path: `/docs/${post.slug}`, children: [], parentId: post.parentId };
+        });
+        blogsResponse.posts.forEach(post => {
+            if (post.parentId && items[post.id]) {
+                items[post.parentId]?.children
+                    //@ts-ignore
+                    .push(items[post.id]);
+            }
+        });
+        const docsItems = blogsResponse.posts.filter(post => !post.parentId).map(post => ({
+            id: post.id,
+            label: post.name,
+            path: `/docs/${post.slug}`,
+            children: items[post.id]?.children || []
+        }));
+        // sort all docs by id and all the deep nested children too
+        const sortItems = (a, b) => a.id - b.id > 0 ? 1 : -1;
+        inPlaceSort(docsItems, sortItems);
+        return {
+            items: docsItems,
+            pagination: blogsResponse.pagination,
+            organization: blogsResponse.organization
+        };
+    }
+    /**
+     * Fetch multiple blog posts with pagination and filtering
+     */
+    async fetchPosts(options = {}) {
+        return this.fetchItems(options);
+    }
+    async fetchBlog(slug, options = {}) {
+        const { includeHtml = true } = options;
+        const params = new URLSearchParams();
+        if (includeHtml) {
+            params.append('html', 'true');
+        }
+        try {
+            const url = this.buildUrl(slug, params);
+            const post = await this.makeRequest(url);
+            return post;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=blogs.js.map

package/dist/src/blogs.js.map

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

package/dist/src/createToc.d.ts

@@ -0,0 +1,49 @@
+/**
+ * createTOC(options)
+ *
+ * A small, dependency-free TOC builder for static/dynamically inserted HTML.
+ */
+export type TOCOptions = {
+    contentSelector: string;
+    tocSelector: string;
+    headingSelector?: string;
+    excludeHeadingLevels?: number[];
+    addNumbers?: boolean;
+    activeClass?: string;
+    linkClass?: string;
+    scrollBehavior?: ScrollIntoViewOptions;
+};
+/**
+ * Attach an IntersectionObserver to all anchor links inside the provided
+ * TOC container. The function will lookup each link's target id
+ * (from data-target-id or href) and observe the corresponding element in
+ * the document. When a heading becomes visible, the corresponding link
+ * inside the container will receive the `active` class by default (or a
+ * custom class provided via options.activeClass). Returns the observer and
+ * a destroy() helper to disconnect it when no longer needed.
+ */
+export declare function attachObserverToTOCLinks(tocId: string, options?: {
+    activeClass?: string;
+    root?: Element | null;
+    rootMargin?: string;
+    threshold?: number | number[];
+}): {
+    observer: IntersectionObserver;
+    destroy: () => void;
+};
+type HeadingData = {
+    id: string;
+    text: string;
+    level: number;
+};
+/**
+ * Render TOC as an HTML string from HeadingData array.
+ * This does not touch the DOM — it simply returns the HTML so you can insert it
+ * into your renderer or manipulate it as you wish.
+ */
+export declare function renderTOCHTML(headingsData: HeadingData[], opts?: {
+    addNumbers?: boolean;
+    linkClass?: string;
+}): string;
+export {};
+//# sourceMappingURL=createToc.d.ts.map

package/dist/src/createToc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createToc.d.ts","sourceRoot":"","sources":["../../src/createToc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B,GACA;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAqDzD;AAGD,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,WAAW,EAAE,EAC3B,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,MAAM,CA2BR"}

package/dist/src/createToc.js

@@ -0,0 +1,87 @@
+/**
+ * Attach an IntersectionObserver to all anchor links inside the provided
+ * TOC container. The function will lookup each link's target id
+ * (from data-target-id or href) and observe the corresponding element in
+ * the document. When a heading becomes visible, the corresponding link
+ * inside the container will receive the `active` class by default (or a
+ * custom class provided via options.activeClass). Returns the observer and
+ * a destroy() helper to disconnect it when no longer needed.
+ */
+export function attachObserverToTOCLinks(tocId, options) {
+    const activeClass = options?.activeClass || 'active';
+    const tocContainer = tocId.startsWith('#') ? document.getElementById(tocId.slice(1)) : document.getElementById(tocId);
+    if (!tocContainer) {
+        console.error('TOC container not found: ' + tocId);
+        return { observer: new IntersectionObserver(() => { }), destroy: () => { } };
+    }
+    const obsOpts = { root: null, rootMargin: '10% 0px -35% 0px', threshold: 0, ...(options || {}) };
+    const links = Array.from(tocContainer.querySelectorAll('a'));
+    // map target id -> link element for quick lookup
+    const idToLink = {};
+    for (const link of links) {
+        const idFromData = link.dataset && link.dataset.targetId ? link.dataset.targetId : undefined;
+        const href = link.getAttribute('href') || '';
+        const id = idFromData || (href.startsWith('#') ? href.slice(1) : undefined);
+        if (id)
+            idToLink[id] = link;
+    }
+    const observer = new IntersectionObserver((entries) => {
+        // when a heading becomes visible, mark its corresponding link as active
+        entries.forEach((entry) => {
+            const target = entry.target;
+            if (!target.id)
+                return;
+            if (entry.isIntersecting) {
+                console.log("Intersecting:", target.id);
+                const link = idToLink[target.id];
+                if (link) {
+                    // remove activeClass from all links first
+                    for (const l of links)
+                        l.classList.remove(activeClass);
+                    link.classList.add(activeClass);
+                }
+            }
+        });
+    }, obsOpts);
+    // start observing all existing target elements
+    for (const id of Object.keys(idToLink)) {
+        const el = document.getElementById(id);
+        if (el)
+            observer.observe(el);
+    }
+    const destroy = () => {
+        try {
+            observer.disconnect();
+        }
+        catch (e) {
+            // noop
+        }
+    };
+    return { observer, destroy };
+}
+/**
+ * Render TOC as an HTML string from HeadingData array.
+ * This does not touch the DOM — it simply returns the HTML so you can insert it
+ * into your renderer or manipulate it as you wish.
+ */
+export function renderTOCHTML(headingsData, opts) {
+    const addNumbers = opts?.addNumbers || false;
+    const linkClass = opts?.linkClass || 'toc-link';
+    const escapeHtml = (str) => String(str)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+    const parts = [];
+    for (const hd of headingsData) {
+        const textRaw = hd.text;
+        const text = escapeHtml(textRaw.trim() || 'Untitled');
+        const id = hd.id;
+        const level = hd.level;
+        const padding = (level - 1) * 12 + 8;
+        parts.push(`<a href="#${escapeHtml(id)}" class="${escapeHtml(linkClass)}" data-level="${level}" data-target-id="${escapeHtml(id)}" role="link" style="padding-left: ${padding}px; display:block; font-size:0.875rem; line-height:1.4">${addNumbers ? `${text}` : text}</a>`);
+    }
+    return parts.join('');
+}
+//# sourceMappingURL=createToc.js.map

package/dist/src/createToc.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,98 @@
+export type Pagination = {
+    limit: number;
+    after?: string;
+    before?: string;
+};
+export type BlogsFilterOptions = {};
+export type BlogSearch = {
+    filter: BlogsFilterOptions;
+    pagination?: Pagination;
+};
+export interface BlogApiConfig {
+    organizationSlug: string;
+    baseUrl?: string;
+    apiPath?: string;
+    defaultLimit?: number;
+    maxPostsForFiltering?: number;
+    cacheRevalidateInterval?: number;
+    staticParamsRevalidateInterval?: number;
+    wordsPerMinute?: number;
+    timeout?: number;
+    retries?: number;
+}
+export interface BlogTag {
+    id: number;
+    name: string;
+}
+export interface BlogSEO {
+    title?: string;
+    description?: string;
+    image?: string;
+    keywords?: string[];
+}
+export interface BlogOrganization {
+    id: string;
+    name: string;
+    slug: string;
+}
+export interface BlogPagination {
+    page: number;
+    limit: number;
+    totalCount: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface BlogApiResponse {
+    posts: BlogPost[];
+    pagination: BlogPagination;
+    organization: BlogOrganization;
+}
+export type DocItem = {
+    id: number;
+    label: string;
+    path?: string;
+    children?: DocItem[];
+};
+export interface DocsResponse {
+    items: DocItem[];
+    pagination: BlogPagination;
+    organization: BlogOrganization;
+}
+export interface FetchPostsOptions {
+    page?: number;
+    limit?: number;
+    includeHtml?: boolean;
+    tags?: string[];
+    search?: string;
+}
+export interface BlogPost {
+    id: number;
+    name: string;
+    slug: string;
+    createdAt: string;
+    updatedAt: string;
+    published: boolean;
+    hasChildren: boolean;
+    seo?: BlogSEO;
+    tags: BlogTag[];
+    organization: BlogOrganization;
+    content?: any;
+    parentId?: number;
+    htmlContent?: string;
+    textContent?: string;
+    tocItems: {
+        level: number;
+        text: string;
+        id: string;
+    }[];
+    createdByUser: {
+        name: string;
+        image?: string;
+    };
+}
+export interface FetchPostOptions {
+    includeHtml?: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAyHA,OAAO,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@leafpad/blogs",
+  "version": "0.0.1",
+  "description": "Package to manage blogs generated by leafpad",
+  "keywords": [
+    "leafpad",
+    "blogs"
+  ],
+  "license": "ISC",
+  "author": "@singhey",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "style.css"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "tsx watch ./index.ts",
+    "build": "tsc --outDir dist"
+  },
+  "packageManager": "pnpm@10.4.1+sha512.c753b6c3ad7afa13af388fa6d808035a008e30ea9993f58c6663e2bc5ff21679aa834db094987129aa4d488b86df57f7b634981b2f827cdcacc698cc0cfb88af",
+  "devDependencies": {
+    "tsx": "^4.20.6",
+    "@types/node-fetch": "^2.6.13",
+    "typescript": "^5.9.3"
+  }
+}

package/style.css

@@ -0,0 +1,351 @@
+.blogs-container {
+  width: 100%;
+}
+
+:root {
+  /**
+  * Font Size and heading
+  */
+  --b-text-4xl: 2.25rem;
+  --b-text-3xl: 1.875rem;
+  --b-text-2xl: 1.5rem;
+  --b-text-xl: 1.25rem;
+  --b-text-lg: 1.125rem;
+  --b-text-base: 1rem;
+}
+
+.blogs-container p, .blogs-container ul, .blogs-container ol, .blogs-container li {
+  line-height: 1.7rem;
+  margin-bottom: 1em;
+  color: var(--b-muted);
+}
+
+.blogs-container ul {
+  list-style: disc;
+  padding-left: 1.5em;
+}
+
+.blogs-container a {
+  color: var(--b-primary);
+  text-decoration: underline;
+}
+
+.blogs-container img {
+  max-width: 100%;
+  height: auto;
+  border-radius: 8px;
+  margin: 5em 0;
+}
+
+.blogs-container pre, :not(pre) > code[class*="language-"],
+pre[class*="language-"] {
+  background-color: var(--b-code-background) !important;
+  padding: 1em;
+  border-radius: 8px;
+  overflow-x: auto;
+  margin: 1em 0;
+  border: 1px solid var(--b-border)
+}
+
+.blogs-container hr {
+  border: none;
+  border-top: 1px solid var(--b-border);
+  margin: 2em 0;
+}
+
+.blogs-container h1 {
+  font-size: var(--b-text-4xl);
+  margin-bottom: 1rem;
+  margin-top: 3.5rem;
+  color: var(--b-text);
+  font-weight: bold;
+}
+
+.blogs-container h2 {
+  font-size: var(--b-text-3xl);
+  margin-bottom: 1rem;
+  margin-top: 3rem;
+  color: var(--b-text);
+  font-weight: bold;
+}
+
+.blogs-container h3 {
+  font-size: var(--b-text-2xl);
+  margin-bottom: 1rem;
+  margin-top: 3rem;
+  color: var(--b-text);
+  font-weight: bold;
+}
+
+.blogs-container h4 {
+  font-size: var(--b-text-xl);
+  margin-bottom: 1rem;
+  margin-top: 3rem;
+  color: var(--b-text);
+}
+
+.blogs-container h5 {
+  font-size: var(--b-text-lg);
+  margin-bottom: 1rem;
+  margin-top: 3rem;
+  color: var(--b-text);
+}
+
+.blogs-container h6 {
+  font-size: var(--b-text-base);
+  margin-bottom: 0.5em;
+  color: var(--b-text);
+}
+
+[data-content-type="bulletListItem"] p::before {
+  content: "• ";
+  font-size: x-large;
+  font-weight: bold;
+  position: absolute;
+  left: 4px
+}
+
+[data-content-type="bulletListItem"] p {
+  padding-left: 1.5em;
+  position: relative;
+}
+
+.blog-cards-container {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 1rem;
+}
+
+@media (min-width: 768px) {
+  .blog-cards-container {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+@media (min-width: 1200px) {
+  .blog-cards-container {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+.blog-cards-container .blog-card {
+  border: 1px solid var(--b-border);
+  border-radius: 8px;
+  padding: 1rem;
+  background-color: var(--b-accent);
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  min-height: 420px;
+}
+
+.blog-card .image-container {
+  width: 100%;
+  height: 240px;
+  overflow: hidden;
+  border-radius: 8px;
+  margin-bottom: 1rem;
+  background: #6a11cb;
+}
+
+.blog-card .post-title {
+  display: -webkit-box;
+  -webkit-line-clamp: 1;
+  line-clamp: 1;
+  -webkit-box-orient: vertical;  
+  overflow: hidden;
+} 
+
+.blog-card .post-excerpt {
+  display: -webkit-box;
+  -webkit-line-clamp: 3;
+  line-clamp: 3;
+  -webkit-box-orient: vertical;  
+  overflow: hidden;
+} 
+
+.blog-cards-container img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  transition: transform 0.3s ease;
+  margin: 0
+}
+
+.blog-card a  {
+  text-decoration: none;
+  color: var(--b-button-text);
+  background-color: var(--b-primary);
+  padding: 0.5rem 2rem;
+  border-radius: 8px;
+  display: inline-block;
+  margin-top: 1rem;
+  text-align: center;
+  border: 1px solid var(--b-border);
+}
+
+.blog-card .post-excerpt {
+  font-size: .9rem;
+}
+
+/* Minimal base styles for blog post components */
+
+.blog-post-container {
+  max-width: 880px;
+  margin: 0 auto;
+  padding: 2em;
+  line-height: 1.6;
+}
+
+.blog-post-tags > div {
+  margin: 1rem
+}
+
+.blog-post-tags {
+  margin-top: 1rem;
+  margin-bottom: 1rem;
+}
+
+.blog-post-tag {
+  background-color: var(--b-bg);
+  color: var(--b-secondary-text);
+  padding: 0.3em 0.6em;
+  border-radius: 4px;
+  font-size: 0.875rem;
+  margin-right: 0.5em;
+  border: 1px solid var(--b-border);
+}
+
+.blog-post-readtime, .blog-post-date {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  font-size: 0.875rem;
+  color: var(--b-muted);
+  margin-right: 2rem
+}
+
+.blog-post-readtime svg, .blog-post-date svg {
+  width: 1rem;
+  height: 1rem;
+  stroke: var(--b-muted);
+  margin-right: 0.5rem;
+}
+
+.blog-post-author {
+  display: block;
+}
+
+.blog-post-meta {
+  margin-top: 1rem;
+}
+
+.blog-post-author-section {
+  display: flex;
+  flex-direction: row;
+  margin: 2rem 0;
+}
+
+.blog-post-author-avatar {
+  border-radius: 100%;
+  height: 3rem;
+  width: 3rem;
+  display: flex;
+  margin-right: 1rem;
+  align-items: center;
+  justify-content: center;
+  background-color: var(--b-accent);
+  background: linear-gradient(135deg, #6a11cb 0%, #2575fc 100%);
+}
+
+.blog-post-author-organization {
+  color: var(--b-muted);
+}
+
+/* TOC container basics */
+.toc-link { color: var(--b-muted); text-decoration: none; transition: color .15s ease, border-color .15s ease; border-left: 2px solid var(--b-border); padding: .25rem 0; }
+.toc-link:hover { color: var(--b-primary); border-left-color: var(--b-primary); }
+#toc .active { color: var(--b-primary); border-left-color: var(--b-primary); font-weight: 600; }
+
+/* Layout for pages with a Table of Contents */
+/* Supports both camelCase and kebab-case wrapper classes */
+.blog-post-with-toc {
+  display: grid;
+  grid-template-columns: 1fr; /* single column by default */
+  gap: 8px; /* 8px gap as requested */
+}
+
+/* Hide aside (toc) on small screens */
+.blog-post-with-toc aside {
+  display: none;
+}
+
+.blog-cards-container {
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: 1rem;
+}
+
+@media (min-width: 768px) {
+  .blog-post-with-toc {
+    grid-template-columns: repeat(4, 1fr); /* 4 equal columns */
+  }
+
+  /* Article/content spans 3 of 4 columns */
+  .blog-post-with-toc .blogs-container {
+    grid-column: 1 / span 3;
+  }
+
+  /* TOC occupies the last column */
+  .blog-post-with-toc aside {
+    display: block;
+    grid-column: 4 / span 1;
+    align-self: start;
+  }
+  .blog-cards-container {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+@media (min-width: 1200px) {
+  .blog-cards-container {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+/* Make aside sticky and constrained so it fits below a top header of 56px */
+.blog-post-with-toc aside {
+  position: sticky;
+  top: 56px; /* offset from top as requested */
+  max-height: calc(100vh - 56px);
+  height: fit-content;
+  overflow: auto;
+}
+
+.blog-post-with-toc .blog-post-toc-title {
+  color: var(--b-primary);
+  font-size: var(--b-text-lg);
+  margin-bottom: 16px;
+}
+
+.blogs-container table {
+  border-radius: 4px;
+  border-bottom: 1px solid var(--b-border);
+  margin: 32px 0px;
+  width: 100%;
+}
+
+.blogs-container table td, .blogs-container table th {
+  border-top: 1px solid var(--b-border);
+  padding: 16px 16px;
+}
+
+h4.post-title {
+  font-size: var(--text-xl);
+  font-weight: bold;
+  margin-bottom: 16px;
+}
+
+.blogs-container table p {
+  margin-bottom: 0px
+}