@stati/core 1.27.2 → 1.29.0

package/dist/core/collections.d.ts

@@ -0,0 +1,139 @@
+import type { PageModel, CollectionData, PaginationData, GeneratedPageData, StatiConfig } from '../types/index.js';
+/**
+ * Front matter fields of the collection summary when `collections.summaryFields` is not set.
+ */
+export declare const DEFAULT_SUMMARY_FIELDS: readonly string[];
+/**
+ * The collections of a page list.
+ */
+export interface CollectionIndex {
+    /** Collection data by the URL of its index page */
+    byPath: Map<string, CollectionData>;
+}
+/**
+ * What a render read from data shared between pages. Filled in while the page renders.
+ */
+export interface PageReads {
+    /** The page read `stati.collection` */
+    collection: boolean;
+    /** The page read the navigation tree (`stati.nav` or `stati.page.navNode`) */
+    nav: boolean;
+}
+/**
+ * Returns the collections of a page list, computing them once per array.
+ *
+ * @param allPages - All pages of the build
+ * @returns The collections by index page URL
+ */
+export declare function getCollections(allPages: PageModel[]): CollectionIndex;
+/**
+ * Computes every collection of a page list in one pass.
+ *
+ * A collection belongs to a collection index page (see `isCollectionIndexPage`), or to a page
+ * loaded from an `index.md`, whose collection is empty while its folder holds no pages. The
+ * root collection holds the top-level pages; any other collection holds every page below its
+ * folder, at any depth. The index page itself, generated pages and pagination pages are
+ * never members.
+ *
+ * @param allPages - All pages of the build
+ * @returns The collections by index page URL
+ */
+export declare function buildCollections(allPages: PageModel[]): CollectionIndex;
+/**
+ * Sorts pages by publishedAt date (most recent first), falling back to alphabetical by title.
+ *
+ * @param pages - Pages to sort, in place
+ * @returns The sorted array
+ */
+export declare function sortPagesByDate(pages: PageModel[]): PageModel[];
+/**
+ * Finds the collection a `collection` front matter value names. Accepts the index page URL
+ * with or without a leading or trailing slash: `posts`, `/posts` and `/posts/` all name the
+ * collection of `site/posts/index.md`.
+ *
+ * @param index - The collections of the build
+ * @param value - The front matter value
+ * @returns The index page URL, or undefined when the value names no collection
+ */
+export declare function findCollectionPath(index: CollectionIndex, value: unknown): string | undefined;
+/**
+ * Finds the collection a page reads as `stati.collection`:
+ *
+ * 1. The collection its `collection` front matter field names, when that collection exists.
+ * 2. Its own collection, when the page is a collection index page or an `index.md`, even
+ *    when that collection is empty.
+ * 3. Otherwise the nearest collection with pages that the page belongs to: `/blog/post` reads
+ *    `/blog`, and a top-level page reads the root collection.
+ *
+ * Pagination pages after the first read the collection of the first page. Generated pages
+ * read only the collection their template names; expansion sets it in their front matter.
+ *
+ * @param page - The page
+ * @param allPages - All pages of the build
+ * @returns The index page URL of the collection, or undefined when the page has none
+ */
+export declare function resolveCollectionPath(page: PageModel, allPages: PageModel[]): string | undefined;
+/**
+ * Returns the front matter fields of the collection summary.
+ *
+ * @param config - Stati configuration
+ * @returns `collections.summaryFields`, or the default fields
+ */
+export declare function resolveSummaryFields(config: StatiConfig): readonly string[];
+/**
+ * Hashes what a listing shows of a list of pages: each page's URL, publish date and summary
+ * fields, in list order. The Markdown body only counts when `fields` includes `content`.
+ *
+ * @param pages - The listed pages
+ * @param fields - Front matter fields to include
+ * @returns A `sha256-…` hash
+ */
+export declare function computePagesSummaryHash(pages: readonly PageModel[], fields: readonly string[]): string;
+/**
+ * Collection summary hashes for one build, computed at most once per collection.
+ */
+export interface SummaryHasher {
+    /** Summary hash of a collection, or `'none'` when there is no such collection */
+    collection(path: string): string;
+    /** Summary hash of a list of pages */
+    pages(pages: readonly PageModel[]): string;
+}
+/**
+ * Creates the summary hasher of a build. Call it after the `beforeAll` hook, which can change
+ * the front matter the summaries include.
+ *
+ * @param allPages - All pages of the build
+ * @param fields - Summary fields
+ * @returns The hasher
+ */
+export declare function createSummaryHasher(allPages: PageModel[], fields: readonly string[]): SummaryHasher;
+/**
+ * Wraps collection data for one render. Reading any of its properties sets `reads.collection`,
+ * so the cache knows the page depends on the collection. Arrays and objects are copied on
+ * first read, so a template that sorts or changes them cannot affect other pages, which share
+ * the collection data within a build.
+ *
+ * The properties are accessors on a plain object, not a Proxy, so spreading the template
+ * context (as callable partials do) passes the view along without reading it.
+ *
+ * @param data - The shared collection data
+ * @param reads - The render's read flags
+ * @returns The view for `stati.collection`
+ */
+export declare function createCollectionView(data: CollectionData, reads: PageReads): CollectionData;
+/**
+ * Copies a page's pagination data for `stati.pagination`, so a template that changes the
+ * lists cannot change what the cache hashes.
+ *
+ * @param data - The page's pagination data
+ * @returns A copy with its own arrays
+ */
+export declare function copyPaginationData(data: PaginationData): PaginationData;
+/**
+ * Copies a page's generated data for `stati.generated`.
+ *
+ * @param data - The page's generated data
+ * @returns A copy with its own items array
+ */
+export declare function copyGeneratedData(data: GeneratedPageData): GeneratedPageData;
+//# sourceMappingURL=collections.d.ts.map

package/dist/core/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/core/collections.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAU3B;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA8C,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,GAAG,EAAE,OAAO,CAAC;CACd;AASD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe,CAQrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe,CAwBvE;AAwFD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAc/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAc7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,SAAS,CAuBhG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,MAAM,EAAE,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,CAWR;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,sCAAsC;IACtC,KAAK,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,aAAa,CAcf;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,GAAG,cAAc,CAwB3F;AAaD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAE5E"}

package/dist/core/collections.js

@@ -0,0 +1,342 @@
+import { basename } from 'node:path';
+import { getCollectionPathForPage, getFirstPaginationPage, isCollectionIndexPage, isVirtualPage, } from './utils/index.js';
+import { computeContentHash } from './isg/hash.js';
+import { MARKDOWN_EXTENSION } from '../constants.js';
+/**
+ * Front matter fields of the collection summary when `collections.summaryFields` is not set.
+ */
+export const DEFAULT_SUMMARY_FIELDS = ['title', 'description', 'tags', 'draft'];
+/**
+ * Collections per page list, computed at the first lookup for an array and reused after that.
+ * Like the directory prefix index in `isCollectionIndexPage`, the result is a snapshot: in a
+ * build the first lookup happens in the render loop, after the `beforeAll` hook.
+ */
+const collectionCache = new WeakMap();
+/**
+ * Returns the collections of a page list, computing them once per array.
+ *
+ * @param allPages - All pages of the build
+ * @returns The collections by index page URL
+ */
+export function getCollections(allPages) {
+    const cached = collectionCache.get(allPages);
+    if (cached) {
+        return cached;
+    }
+    const index = buildCollections(allPages);
+    collectionCache.set(allPages, index);
+    return index;
+}
+/**
+ * Computes every collection of a page list in one pass.
+ *
+ * A collection belongs to a collection index page (see `isCollectionIndexPage`), or to a page
+ * loaded from an `index.md`, whose collection is empty while its folder holds no pages. The
+ * root collection holds the top-level pages; any other collection holds every page below its
+ * folder, at any depth. The index page itself, generated pages and pagination pages are
+ * never members.
+ *
+ * @param allPages - All pages of the build
+ * @returns The collections by index page URL
+ */
+export function buildCollections(allPages) {
+    const pages = allPages.filter((page) => !isVirtualPage(page));
+    const members = new Map();
+    for (const page of pages) {
+        if (!members.has(page.url) &&
+            (isFolderIndexPage(page) || isCollectionIndexPage(page, allPages))) {
+            members.set(page.url, []);
+        }
+    }
+    for (const page of pages) {
+        for (const path of collectionsContaining(page.url, (path) => members.has(path))) {
+            members.get(path).push(page);
+        }
+    }
+    const byPath = new Map();
+    for (const [path, collectionPages] of members) {
+        byPath.set(path, createCollectionData(path, collectionPages));
+    }
+    return { byPath };
+}
+/**
+ * Whether a page was loaded from a folder's `index.md`. The folder is a collection even before
+ * it holds any pages, so an empty blog lists no posts instead of reading another collection.
+ */
+function isFolderIndexPage(page) {
+    return basename(page.sourcePath, MARKDOWN_EXTENSION) === 'index';
+}
+/**
+ * Lists the collections a URL belongs to, outermost first.
+ *
+ * @param url - A page URL
+ * @param isCollection - Whether a URL is a collection index page
+ * @returns Index page URLs
+ */
+function collectionsContaining(url, isCollection) {
+    const found = [];
+    // Every folder the URL lives in, from the outermost: /blog/2024/recap is in /blog/ and /blog/2024/
+    for (let i = url.indexOf('/', 1); i !== -1; i = url.indexOf('/', i + 1)) {
+        const folder = url.slice(0, i + 1);
+        // A folder's index page is usually /blog, or /blog/ with a trailing-slash permalink
+        for (const path of [folder.slice(0, -1), folder]) {
+            if (path !== url && isCollection(path)) {
+                found.push(path);
+            }
+        }
+    }
+    // The root collection is shallow: only pages whose parent is the root belong to it
+    if (url !== '/' && isCollection('/') && getCollectionPathForPage(url) === '/') {
+        found.push('/');
+    }
+    return found;
+}
+/**
+ * Builds the collection data of one index page from its members.
+ */
+function createCollectionData(collectionPath, collectionPages) {
+    // Direct children are one level below the index page
+    const children = collectionPages.filter((page) => {
+        const relativePath = page.url.substring(collectionPath.length);
+        const cleanPath = relativePath.startsWith('/') ? relativePath.substring(1) : relativePath;
+        return !cleanPath.includes('/');
+    });
+    return {
+        pages: collectionPages,
+        children,
+        recentPages: sortPagesByDate([...collectionPages]),
+        pagesByTag: groupPagesByTags(collectionPages),
+        metadata: {
+            totalPages: collectionPages.length,
+            hasChildren: children.length > 0,
+            collectionPath,
+            collectionName: collectionPath === '/' ? 'Home' : basename(collectionPath),
+        },
+    };
+}
+/**
+ * Groups pages by their tags.
+ *
+ * @param pages - Pages to group
+ * @returns Object mapping tag names to arrays of pages
+ */
+function groupPagesByTags(pages) {
+    // No prototype, so tags such as `constructor` or `__proto__` are keys like any other
+    const pagesByTag = Object.create(null);
+    for (const page of pages) {
+        const tags = page.frontMatter.tags;
+        if (Array.isArray(tags)) {
+            for (const tag of tags) {
+                if (typeof tag === 'string') {
+                    (pagesByTag[tag] ??= []).push(page);
+                }
+            }
+        }
+    }
+    return pagesByTag;
+}
+/**
+ * Sorts pages by publishedAt date (most recent first), falling back to alphabetical by title.
+ *
+ * @param pages - Pages to sort, in place
+ * @returns The sorted array
+ */
+export function sortPagesByDate(pages) {
+    return pages.sort((a, b) => {
+        // Sort by publishedAt (newest first)
+        if (a.publishedAt && b.publishedAt) {
+            return b.publishedAt.getTime() - a.publishedAt.getTime();
+        }
+        if (a.publishedAt && !b.publishedAt)
+            return -1;
+        if (!a.publishedAt && b.publishedAt)
+            return 1;
+        // Fallback to title
+        const titleA = a.frontMatter.title || basename(a.url) || 'Untitled';
+        const titleB = b.frontMatter.title || basename(b.url) || 'Untitled';
+        return titleA.localeCompare(titleB);
+    });
+}
+/**
+ * Finds the collection a `collection` front matter value names. Accepts the index page URL
+ * with or without a leading or trailing slash: `posts`, `/posts` and `/posts/` all name the
+ * collection of `site/posts/index.md`.
+ *
+ * @param index - The collections of the build
+ * @param value - The front matter value
+ * @returns The index page URL, or undefined when the value names no collection
+ */
+export function findCollectionPath(index, value) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    const url = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    if (index.byPath.has(url)) {
+        return url;
+    }
+    if (url === '/') {
+        return undefined;
+    }
+    const alternate = url.endsWith('/') ? url.slice(0, -1) : `${url}/`;
+    return index.byPath.has(alternate) ? alternate : undefined;
+}
+/**
+ * Finds the collection a page reads as `stati.collection`:
+ *
+ * 1. The collection its `collection` front matter field names, when that collection exists.
+ * 2. Its own collection, when the page is a collection index page or an `index.md`, even
+ *    when that collection is empty.
+ * 3. Otherwise the nearest collection with pages that the page belongs to: `/blog/post` reads
+ *    `/blog`, and a top-level page reads the root collection.
+ *
+ * Pagination pages after the first read the collection of the first page. Generated pages
+ * read only the collection their template names; expansion sets it in their front matter.
+ *
+ * @param page - The page
+ * @param allPages - All pages of the build
+ * @returns The index page URL of the collection, or undefined when the page has none
+ */
+export function resolveCollectionPath(page, allPages) {
+    const index = getCollections(allPages);
+    const named = findCollectionPath(index, page.frontMatter.collection);
+    if (named !== undefined) {
+        return named;
+    }
+    if (page.generated) {
+        return undefined;
+    }
+    if ((page.pagination?.pageNumber ?? 1) > 1) {
+        const first = getFirstPaginationPage(page, allPages);
+        return first && !isVirtualPage(first) ? resolveCollectionPath(first, allPages) : undefined;
+    }
+    if (index.byPath.has(page.url)) {
+        return page.url;
+    }
+    // A page always has pages in the collections it belongs to; only a [param].md template can
+    // sit in an empty one, and site/blog/tags/[tag].md reads /blog even with a tags/index.md
+    return collectionsContaining(page.url, (path) => (index.byPath.get(path)?.pages.length ?? 0) > 0).at(-1);
+}
+/**
+ * Returns the front matter fields of the collection summary.
+ *
+ * @param config - Stati configuration
+ * @returns `collections.summaryFields`, or the default fields
+ */
+export function resolveSummaryFields(config) {
+    const fields = config.collections?.summaryFields;
+    if (!Array.isArray(fields)) {
+        return DEFAULT_SUMMARY_FIELDS;
+    }
+    return fields.filter((field) => typeof field === 'string' && field !== '');
+}
+/**
+ * Hashes what a listing shows of a list of pages: each page's URL, publish date and summary
+ * fields, in list order. The Markdown body only counts when `fields` includes `content`.
+ *
+ * @param pages - The listed pages
+ * @param fields - Front matter fields to include
+ * @returns A `sha256-…` hash
+ */
+export function computePagesSummaryHash(pages, fields) {
+    return computeContentHash('', {
+        fields: [...fields],
+        pages: pages.map((page) => [
+            page.url,
+            toIsoDate(page.publishedAt),
+            ...fields.map((field) => field === 'content' ? page.content : (page.frontMatter[field] ?? null)),
+        ]),
+    });
+}
+function toIsoDate(date) {
+    return date instanceof Date && !Number.isNaN(date.getTime()) ? date.toISOString() : null;
+}
+/**
+ * Creates the summary hasher of a build. Call it after the `beforeAll` hook, which can change
+ * the front matter the summaries include.
+ *
+ * @param allPages - All pages of the build
+ * @param fields - Summary fields
+ * @returns The hasher
+ */
+export function createSummaryHasher(allPages, fields) {
+    const memo = new Map();
+    return {
+        collection(path) {
+            let hash = memo.get(path);
+            if (hash === undefined) {
+                const data = getCollections(allPages).byPath.get(path);
+                hash = data ? computePagesSummaryHash(data.pages, fields) : 'none';
+                memo.set(path, hash);
+            }
+            return hash;
+        },
+        pages: (pages) => computePagesSummaryHash(pages, fields),
+    };
+}
+const COLLECTION_KEYS = ['pages', 'children', 'recentPages', 'pagesByTag', 'metadata'];
+/**
+ * Wraps collection data for one render. Reading any of its properties sets `reads.collection`,
+ * so the cache knows the page depends on the collection. Arrays and objects are copied on
+ * first read, so a template that sorts or changes them cannot affect other pages, which share
+ * the collection data within a build.
+ *
+ * The properties are accessors on a plain object, not a Proxy, so spreading the template
+ * context (as callable partials do) passes the view along without reading it.
+ *
+ * @param data - The shared collection data
+ * @param reads - The render's read flags
+ * @returns The view for `stati.collection`
+ */
+export function createCollectionView(data, reads) {
+    const view = {};
+    for (const key of COLLECTION_KEYS) {
+        let value;
+        let copied = false;
+        Object.defineProperty(view, key, {
+            enumerable: true,
+            configurable: true,
+            get() {
+                reads.collection = true;
+                if (!copied) {
+                    value = copyCollectionValue(data[key]);
+                    copied = true;
+                }
+                return value;
+            },
+            set(next) {
+                reads.collection = true;
+                value = next;
+                copied = true;
+            },
+        });
+    }
+    return view;
+}
+function copyCollectionValue(value) {
+    if (Array.isArray(value)) {
+        return [...value];
+    }
+    const copy = Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, Array.isArray(entry) ? [...entry] : entry]));
+    // pagesByTag has no prototype, and neither has its copy, so any tag stays a plain key
+    return Object.setPrototypeOf(copy, Object.getPrototypeOf(value));
+}
+/**
+ * Copies a page's pagination data for `stati.pagination`, so a template that changes the
+ * lists cannot change what the cache hashes.
+ *
+ * @param data - The page's pagination data
+ * @returns A copy with its own arrays
+ */
+export function copyPaginationData(data) {
+    return { ...data, items: [...data.items], urls: [...data.urls] };
+}
+/**
+ * Copies a page's generated data for `stati.generated`.
+ *
+ * @param data - The page's generated data
+ * @returns A copy with its own items array
+ */
+export function copyGeneratedData(data) {
+    return { ...data, items: [...data.items] };
+}

package/dist/core/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/core/content.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAgDtB"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/core/content.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiDtB"}

package/dist/core/content.js

@@ -39,7 +39,8 @@ export async function loadContent(config, includeDrafts) {
         if (frontMatter.draft && !includeDrafts) {
             continue;
         }
-        const relativePath = relative(contentDir, file);
+        // POSIX separators, so a page two folders deep gets /a/b/page on Windows too
+        const relativePath = relative(contentDir, file).replace(/\\/g, '/');
         const slug = computeSlug(relativePath);
         const url = computeUrl(slug, frontMatter);
         const page = {

package/dist/core/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAwC7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAscD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA4hBxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAiC7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAmZD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA4hBxF"}

package/dist/core/dev.js

@@ -8,9 +8,7 @@ import { invalidate } from './invalidate.js';
 import { loadConfig } from '../config/loader.js';
 import { clearTemplateEngineCache } from './templates.js';
 import { clearMarkdownProcessorCache } from './markdown.js';
-import { loadCacheManifest, saveCacheManifest, computeNavigationHash, DevServerLockManager, } from './isg/index.js';
-import { loadContent } from './content.js';
-import { buildNavigation } from './navigation.js';
+import { loadCacheManifest, saveCacheManifest, DevServerLockManager } from './isg/index.js';
 import { resolveDevPaths, resolveCacheDir, resolvePrettyUrl, createErrorOverlay, parseErrorDetails, TemplateError, createFallbackLogger, mergeServerOptions, createTypeScriptWatcher, isEnabledEnvFlag, refreshCssOutputWatcher, normalizePathForComparison, isPathWithinDirectory, assertPortAvailable, toPortUnavailableError, } from './utils/index.js';
 import { setEnv, getEnv } from '../env.js';
 import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST, TEMPLATE_EXTENSION, DEFAULT_OUT_DIR, } from '../constants.js';
@@ -318,67 +316,18 @@ async function handleTemplateChange(templatePath, configPath, logger) {
     }
 }
 /**
- * Handles markdown file changes by comparing navigation hashes.
- * Only performs a full rebuild if navigation structure actually changed.
- * Navigation changes come from frontmatter modifications (title, order, description).
- * Content-only changes use incremental rebuilds.
+ * Handles markdown file changes (added, edited or deleted pages) with an incremental build.
+ * ISG decides what re-renders: the changed page, the pages that list it through a collection,
+ * and the pages that read the navigation when the change altered it. A deleted page's output
+ * is removed by the build.
  */
 async function handleMarkdownChange(_markdownPath, configPath, logger) {
-    const cacheDir = resolveCacheDir();
-    try {
-        // Load existing cache manifest
-        const cacheManifest = await loadCacheManifest(cacheDir);
-        if (!cacheManifest || !cacheManifest.navigationHash) {
-            // No cache or no navigation hash exists, perform full rebuild
-            await build({
-                logger,
-                force: false,
-                clean: false,
-                ...(configPath && { configPath }),
-            });
-            return;
-        }
-        // Load config and content to rebuild navigation tree
-        const config = await loadConfig(configPath);
-        const pages = await loadContent(config);
-        const newNavigation = buildNavigation(pages);
-        const newNavigationHash = computeNavigationHash(newNavigation);
-        // Compare navigation hashes
-        if (newNavigationHash !== cacheManifest.navigationHash) {
-            // Navigation structure changed - clear cache and force full rebuild
-            logger.status('Navigation structure changed, performing full rebuild...');
-            // Force rebuild bypasses ISG cache entirely
-            await build({
-                logger,
-                force: true, // Force rebuild to bypass cache
-                clean: false,
-                ...(configPath && { configPath }),
-            });
-        }
-        else {
-            // Navigation unchanged - use incremental rebuild for content changes
-            await build({
-                logger,
-                force: false,
-                clean: false,
-                ...(configPath && { configPath }),
-            });
-        }
-    }
-    catch (_error) {
-        try {
-            // Fallback to full rebuild
-            await build({
-                logger,
-                force: false,
-                clean: false,
-                ...(configPath && { configPath }),
-            });
-        }
-        catch (fallbackError) {
-            throw fallbackError instanceof Error ? fallbackError : new Error(String(fallbackError));
-        }
-    }
+    await build({
+        logger,
+        force: false,
+        clean: false,
+        ...(configPath && { configPath }),
+    });
 }
 export async function createDevServer(options = {}) {
     const logger = options.logger ?? createFallbackLogger();