@stati/core 1.8.0 → 1.10.0

package/dist/core/utils/callable-partials.js

@@ -0,0 +1,108 @@
+/**
+ * Creates a callable partial that can be used both as a value and as a function.
+ * This enables both syntaxes:
+ * - Direct usage: <%~ stati.partials.header %>
+ * - With props: <%~ stati.partials.hero({ title: 'Hello' }) %>
+ *
+ * @param eta - The Eta template engine instance
+ * @param partialPath - Absolute path to the partial template file
+ * @param baseContext - The base template context (without props)
+ * @param renderedContent - Pre-rendered content for the no-props case
+ * @returns A callable partial function
+ *
+ * @example
+ * ```typescript
+ * const callable = makeCallablePartial(eta, '/path/to/partial.eta', baseContext, '<div>Header</div>');
+ *
+ * // Use without props (returns pre-rendered content)
+ * const html1 = callable.toString(); // '<div>Header</div>'
+ *
+ * // Use with props (re-renders with merged context)
+ * const html2 = callable({ title: 'Custom Title' }); // Renders with custom props
+ * ```
+ */
+export function makeCallablePartial(eta, partialPath, baseContext, renderedContent) {
+    /**
+     * The main callable function.
+     * When called with props, re-renders the partial with merged context.
+     * When called without props, returns the pre-rendered content.
+     */
+    const callable = (props) => {
+        if (!props || Object.keys(props).length === 0) {
+            // No props provided - return pre-rendered content
+            return renderedContent;
+        }
+        // Props provided - re-render with merged context
+        try {
+            const mergedContext = {
+                ...baseContext,
+                props, // Make props available as stati.props
+            };
+            // Render the partial with the merged context using renderAsync
+            // This is a synchronous call despite the name when used with already-loaded templates
+            const result = eta.render(partialPath, mergedContext);
+            return result || '';
+        }
+        catch (error) {
+            console.error(`Error rendering callable partial ${partialPath} with props:`, error);
+            return `<!-- Error rendering partial with props: ${error instanceof Error ? error.message : String(error)} -->`;
+        }
+    };
+    // Create a Proxy to handle different usage patterns
+    const proxy = new Proxy(callable, {
+        /**
+         * Handle function calls: stati.partials.header({ props })
+         */
+        apply(target, thisArg, args) {
+            return target.apply(thisArg, args);
+        },
+        /**
+         * Handle toString(): When used in template interpolation without parentheses
+         * Example: <%~ stati.partials.header %>
+         */
+        get(target, prop) {
+            if (prop === 'toString' || prop === 'valueOf') {
+                return () => renderedContent;
+            }
+            // Allow other function properties to pass through
+            return Reflect.get(target, prop);
+        },
+    });
+    return proxy;
+}
+/**
+ * Wraps all partials in a record with callable partial wrappers.
+ * This allows partials to be used both as values and as functions.
+ *
+ * @param eta - The Eta template engine instance
+ * @param partials - Record mapping partial names to their rendered content
+ * @param partialPaths - Record mapping partial names to their absolute file paths
+ * @param baseContext - The base template context (without props)
+ * @returns Record of callable partials
+ *
+ * @example
+ * ```typescript
+ * const callablePartials = wrapPartialsAsCallable(
+ *   eta,
+ *   { header: '<div>Header</div>', footer: '<div>Footer</div>' },
+ *   { header: '/path/to/header.eta', footer: '/path/to/footer.eta' },
+ *   baseContext
+ * );
+ *
+ * // Both syntaxes work
+ * callablePartials.header.toString(); // Direct usage
+ * callablePartials.header({ title: 'Custom' }); // With props
+ * ```
+ */
+export function wrapPartialsAsCallable(eta, partials, partialPaths, baseContext) {
+    const callablePartials = {};
+    for (const [name, renderedContent] of Object.entries(partials)) {
+        const partialPath = partialPaths[name];
+        if (!partialPath) {
+            console.warn(`No path found for partial "${name}", skipping callable wrapper`);
+            continue;
+        }
+        callablePartials[name] = makeCallablePartial(eta, partialPath, baseContext, renderedContent);
+    }
+    return callablePartials;
+}

package/dist/core/utils/index.d.ts

@@ -6,8 +6,12 @@ export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir,
 export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, } from './paths.js';
 export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.js';
 export { propValue } from './template-utils.js';
+export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.js';
 export { createValidatingPartialsProxy } from './partial-validation.js';
+export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials.js';
+export type { CallablePartial } from './callable-partials.js';
 export { TemplateError, parseEtaError, createTemplateError } from './template-errors.js';
+export { createNavigationHelpers } from './navigation-helpers.js';
 export { resolvePrettyUrl } from './server.js';
 export type { PrettyUrlResult } from './server.js';
 export { createErrorOverlay, parseErrorDetails } from './error-overlay.js';

package/dist/core/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/utils/index.js

@@ -10,10 +10,16 @@ export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolv
 export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.js';
 // Template utilities
 export { propValue } from './template-utils.js';
+// Tailwind inventory utilities
+export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.js';
 // Partial validation utilities
 export { createValidatingPartialsProxy } from './partial-validation.js';
+// Callable partial utilities
+export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials.js';
 // Template error utilities
 export { TemplateError, parseEtaError, createTemplateError } from './template-errors.js';
+// Navigation helper utilities
+export { createNavigationHelpers } from './navigation-helpers.js';
 // Server utilities
 export { resolvePrettyUrl } from './server.js';
 // Error overlay utilities

package/dist/core/utils/navigation-helpers.d.ts

@@ -0,0 +1,124 @@
+import type { NavNode, PageModel } from '../../types/index.js';
+/**
+ * Navigation helper utilities for template context.
+ * Provides methods for querying and traversing the navigation tree.
+ */
+/**
+ * Finds a navigation node by its path or URL.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path or URL to find
+ * @returns The found node or undefined
+ */
+export declare function findNode(tree: NavNode[], path: string): NavNode | undefined;
+/**
+ * Gets the children of a specific navigation node by path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path of the parent node
+ * @returns Array of child nodes or empty array if not found or no children
+ */
+export declare function getChildren(tree: NavNode[], path: string): NavNode[];
+/**
+ * Gets the parent node of a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to find parent for
+ * @returns The parent node or undefined
+ */
+export declare function getParent(tree: NavNode[], path: string): NavNode | undefined;
+/**
+ * Gets the siblings of a specific path (nodes at the same level).
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to find siblings for
+ * @param includeSelf - Whether to include the node itself in the results
+ * @returns Array of sibling nodes or empty array
+ */
+export declare function getSiblings(tree: NavNode[], path: string, includeSelf?: boolean): NavNode[];
+/**
+ * Gets a subtree starting from a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Root path for the subtree
+ * @returns The subtree as an array (single node with its children) or empty array
+ */
+export declare function getSubtree(tree: NavNode[], path: string): NavNode[];
+/**
+ * Gets the breadcrumb trail from root to a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to get breadcrumbs for
+ * @returns Array of nodes from root to the target path
+ */
+export declare function getBreadcrumbs(tree: NavNode[], path: string): NavNode[];
+/**
+ * Finds the current page's navigation node.
+ *
+ * @param tree - Navigation tree to search
+ * @param currentPage - Current page model
+ * @returns The navigation node for the current page or undefined
+ */
+export declare function getCurrentNode(tree: NavNode[], currentPage: PageModel): NavNode | undefined;
+/**
+ * Creates a navigation helpers object for template context.
+ *
+ * @param tree - The full navigation tree
+ * @param currentPage - The current page being rendered
+ * @returns Object with navigation helper methods
+ */
+export declare function createNavigationHelpers(tree: NavNode[], currentPage: PageModel): {
+    /**
+     * The full navigation tree.
+     * Use stati.nav.tree to access the global navigation.
+     */
+    tree: NavNode[];
+    /**
+     * Gets the full navigation tree.
+     * @returns The complete navigation tree
+     */
+    getTree: () => NavNode[];
+    /**
+     * Finds a navigation node by path or URL.
+     * @param path - The path or URL to find
+     * @returns The found node or undefined
+     */
+    findNode: (path: string) => NavNode | undefined;
+    /**
+     * Gets the children of a navigation node.
+     * @param path - The path of the parent node
+     * @returns Array of child navigation nodes
+     */
+    getChildren: (path: string) => NavNode[];
+    /**
+     * Gets the parent of a navigation node.
+     * @param path - The path to find the parent for (defaults to current page)
+     * @returns The parent node or undefined
+     */
+    getParent: (path?: string) => NavNode | undefined;
+    /**
+     * Gets the siblings of a navigation node.
+     * @param path - The path to find siblings for (defaults to current page)
+     * @param includeSelf - Whether to include the node itself
+     * @returns Array of sibling nodes
+     */
+    getSiblings: (path?: string, includeSelf?: boolean) => NavNode[];
+    /**
+     * Gets a subtree starting from a specific path.
+     * @param path - The root path for the subtree
+     * @returns Array containing the subtree
+     */
+    getSubtree: (path: string) => NavNode[];
+    /**
+     * Gets the breadcrumb trail for a path.
+     * @param path - The path to get breadcrumbs for (defaults to current page)
+     * @returns Array of nodes from root to the target
+     */
+    getBreadcrumbs: (path?: string) => NavNode[];
+    /**
+     * Gets the current page's navigation node.
+     * @returns The navigation node for the current page or undefined
+     */
+    getCurrentNode: () => NavNode | undefined;
+};
+//# sourceMappingURL=navigation-helpers.d.ts.map

package/dist/core/utils/navigation-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/utils/navigation-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAiB3E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAGpE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5E;AAiCD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,EAAE,CAiBzF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAGnE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAIvE;AAkCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS;IAE3E;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;qBACc,MAAM;IAEvB;;;;OAIG;wBACiB,MAAM;IAE1B;;;;OAIG;uBACgB,MAAM;IAEzB;;;;;OAKG;yBACkB,MAAM;IAG3B;;;;OAIG;uBACgB,MAAM;IAEzB;;;;OAIG;4BACqB,MAAM;IAE9B;;;OAGG;;EAGN"}

package/dist/core/utils/navigation-helpers.js

@@ -0,0 +1,219 @@
+/**
+ * Navigation helper utilities for template context.
+ * Provides methods for querying and traversing the navigation tree.
+ */
+/**
+ * Finds a navigation node by its path or URL.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path or URL to find
+ * @returns The found node or undefined
+ */
+export function findNode(tree, path) {
+    for (const node of tree) {
+        // Check current node
+        if (node.path === path || node.url === path) {
+            return node;
+        }
+        // Recursively search children
+        if (node.children && node.children.length > 0) {
+            const found = findNode(node.children, path);
+            if (found) {
+                return found;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Gets the children of a specific navigation node by path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path of the parent node
+ * @returns Array of child nodes or empty array if not found or no children
+ */
+export function getChildren(tree, path) {
+    const node = findNode(tree, path);
+    return node?.children || [];
+}
+/**
+ * Gets the parent node of a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to find parent for
+ * @returns The parent node or undefined
+ */
+export function getParent(tree, path) {
+    return findParentNode(tree, path, null);
+}
+/**
+ * Helper function to find parent node recursively.
+ *
+ * @param nodes - Current nodes to search
+ * @param targetPath - Path we're looking for
+ * @param parent - Current parent node
+ * @returns The parent node or undefined
+ */
+function findParentNode(nodes, targetPath, parent) {
+    for (const node of nodes) {
+        // Check if this node is the target
+        if (node.path === targetPath || node.url === targetPath) {
+            return parent || undefined;
+        }
+        // Recursively search children with this node as parent
+        if (node.children && node.children.length > 0) {
+            const found = findParentNode(node.children, targetPath, node);
+            if (found !== undefined) {
+                return found;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Gets the siblings of a specific path (nodes at the same level).
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to find siblings for
+ * @param includeSelf - Whether to include the node itself in the results
+ * @returns Array of sibling nodes or empty array
+ */
+export function getSiblings(tree, path, includeSelf = false) {
+    const parent = getParent(tree, path);
+    // If no parent, check if the node is at root level
+    if (!parent) {
+        // Node might be at root level
+        const isAtRoot = tree.some((node) => node.path === path || node.url === path);
+        if (isAtRoot) {
+            return includeSelf ? tree : tree.filter((node) => node.path !== path && node.url !== path);
+        }
+        return [];
+    }
+    const siblings = parent.children || [];
+    return includeSelf
+        ? siblings
+        : siblings.filter((node) => node.path !== path && node.url !== path);
+}
+/**
+ * Gets a subtree starting from a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Root path for the subtree
+ * @returns The subtree as an array (single node with its children) or empty array
+ */
+export function getSubtree(tree, path) {
+    const node = findNode(tree, path);
+    return node ? [node] : [];
+}
+/**
+ * Gets the breadcrumb trail from root to a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to get breadcrumbs for
+ * @returns Array of nodes from root to the target path
+ */
+export function getBreadcrumbs(tree, path) {
+    const trail = [];
+    findBreadcrumbTrail(tree, path, trail);
+    return trail;
+}
+/**
+ * Helper function to build breadcrumb trail recursively.
+ *
+ * @param nodes - Current nodes to search
+ * @param targetPath - Path we're looking for
+ * @param trail - Current breadcrumb trail
+ * @returns True if the target was found in this branch
+ */
+function findBreadcrumbTrail(nodes, targetPath, trail) {
+    for (const node of nodes) {
+        // Add current node to trail
+        trail.push(node);
+        // Check if this is the target
+        if (node.path === targetPath || node.url === targetPath) {
+            return true;
+        }
+        // Check children
+        if (node.children && node.children.length > 0) {
+            if (findBreadcrumbTrail(node.children, targetPath, trail)) {
+                return true;
+            }
+        }
+        // This branch didn't contain the target, remove this node from trail
+        trail.pop();
+    }
+    return false;
+}
+/**
+ * Finds the current page's navigation node.
+ *
+ * @param tree - Navigation tree to search
+ * @param currentPage - Current page model
+ * @returns The navigation node for the current page or undefined
+ */
+export function getCurrentNode(tree, currentPage) {
+    return findNode(tree, currentPage.url);
+}
+/**
+ * Creates a navigation helpers object for template context.
+ *
+ * @param tree - The full navigation tree
+ * @param currentPage - The current page being rendered
+ * @returns Object with navigation helper methods
+ */
+export function createNavigationHelpers(tree, currentPage) {
+    return {
+        /**
+         * The full navigation tree.
+         * Use stati.nav.tree to access the global navigation.
+         */
+        tree,
+        /**
+         * Gets the full navigation tree.
+         * @returns The complete navigation tree
+         */
+        getTree: () => tree,
+        /**
+         * Finds a navigation node by path or URL.
+         * @param path - The path or URL to find
+         * @returns The found node or undefined
+         */
+        findNode: (path) => findNode(tree, path),
+        /**
+         * Gets the children of a navigation node.
+         * @param path - The path of the parent node
+         * @returns Array of child navigation nodes
+         */
+        getChildren: (path) => getChildren(tree, path),
+        /**
+         * Gets the parent of a navigation node.
+         * @param path - The path to find the parent for (defaults to current page)
+         * @returns The parent node or undefined
+         */
+        getParent: (path) => getParent(tree, path || currentPage.url),
+        /**
+         * Gets the siblings of a navigation node.
+         * @param path - The path to find siblings for (defaults to current page)
+         * @param includeSelf - Whether to include the node itself
+         * @returns Array of sibling nodes
+         */
+        getSiblings: (path, includeSelf = false) => getSiblings(tree, path || currentPage.url, includeSelf),
+        /**
+         * Gets a subtree starting from a specific path.
+         * @param path - The root path for the subtree
+         * @returns Array containing the subtree
+         */
+        getSubtree: (path) => getSubtree(tree, path),
+        /**
+         * Gets the breadcrumb trail for a path.
+         * @param path - The path to get breadcrumbs for (defaults to current page)
+         * @returns Array of nodes from root to the target
+         */
+        getBreadcrumbs: (path) => getBreadcrumbs(tree, path || currentPage.url),
+        /**
+         * Gets the current page's navigation node.
+         * @returns The navigation node for the current page or undefined
+         */
+        getCurrentNode: () => getCurrentNode(tree, currentPage),
+    };
+}

package/dist/core/utils/partial-validation.d.ts

@@ -1,6 +1,9 @@
+import { type CallablePartial } from './callable-partials.js';
 /**
  * Creates a development-mode Proxy for the partials object that throws errors
- * when accessing non-existent partials instead of returning undefined
+ * when accessing non-existent partials instead of returning undefined.
+ *
+ * Supports both string partials and CallablePartial.
  */
-export declare function createValidatingPartialsProxy(partials: Record<string, string>): Record<string, string>;
+export declare function createValidatingPartialsProxy<T extends string | CallablePartial>(partials: Record<string, T>): Record<string, T>;
 //# sourceMappingURL=partial-validation.d.ts.map

package/dist/core/utils/partial-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partial-validation.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partial-validation.ts"],"names":[],"mappings":"AA8FA;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmDxB"}
+{"version":3,"file":"partial-validation.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partial-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA8F9D;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,GAAG,eAAe,EAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CA+EnB"}

package/dist/core/utils/partial-validation.js

@@ -84,7 +84,9 @@ function findSimilarPartialNames(targetName, availableNames) {
 }
 /**
  * Creates a development-mode Proxy for the partials object that throws errors
- * when accessing non-existent partials instead of returning undefined
+ * when accessing non-existent partials instead of returning undefined.
+ *
+ * Supports both string partials and CallablePartial.
  */
 export function createValidatingPartialsProxy(partials) {
     // In production, return partials as-is
@@ -92,6 +94,11 @@ export function createValidatingPartialsProxy(partials) {
     if (getEnv() === 'production') {
         return partials;
     }
+    // If there are no partials, return the empty object as-is
+    // This avoids proxy-related issues during test serialization
+    if (Object.keys(partials).length === 0) {
+        return partials;
+    }
     return new Proxy(partials, {
         get(target, prop, receiver) {
             // Allow normal object operations
@@ -104,18 +111,39 @@ export function createValidatingPartialsProxy(partials) {
                 return target[propName];
             }
             // Special case: allow accessing length, toString, etc.
-            if (propName in Object.prototype || propName === 'length') {
+            // Also handle test framework inspection properties
+            if (propName in Object.prototype ||
+                propName === 'length' ||
+                propName === 'constructor' ||
+                propName === 'then' || // Promise detection
+                propName === '$$typeof' || // React inspection
+                propName === 'nodeType' || // DOM node detection
+                propName === 'asymmetricMatch' || // Jest/Vitest matcher
+                propName === 'toJSON' // JSON serialization
+            ) {
                 return Reflect.get(target, prop, receiver);
             }
             // Property doesn't exist - return error overlay HTML instead of throwing
             const availablePartials = Object.keys(target);
             const suggestions = findSimilarPartialNames(propName, availablePartials);
-            // Special case: throw error if no partials are available at all
-            if (availablePartials.length === 0) {
-                throw new Error('No partials are available');
-            }
             // In development, render an inline error overlay
-            return createInlineErrorOverlay(propName, suggestions);
+            const errorHtml = createInlineErrorOverlay(propName, suggestions);
+            // Check if we're dealing with CallablePartials by testing a known partial
+            const samplePartial = Object.values(target)[0];
+            const isCallable = typeof samplePartial === 'function';
+            if (isCallable) {
+                // For CallablePartial, return a function that returns the error HTML
+                // This prevents "string is not a function" errors when templates call missing partials
+                // Accept any arguments to handle props being passed
+                const errorFunction = (..._args) => errorHtml;
+                errorFunction.toString = () => errorHtml;
+                errorFunction.valueOf = () => errorHtml;
+                return errorFunction;
+            }
+            else {
+                // For string partials, return the error HTML directly
+                return errorHtml;
+            }
         },
         has(target, prop) {
             return prop in target;

package/dist/core/utils/server.d.ts

@@ -12,7 +12,7 @@ export interface PrettyUrlResult {
  * This handles common patterns like:
  * - /path/ -> /path/index.html
  * - /path/ -> /path.html (if no index.html exists)
- * - /path -> /path.html (when original path is not found)
+ * - /path -> /path.html (when original path is not found and has no extension)
  *
  * @param outDir The output directory to serve files from
  * @param requestPath The requested URL path

package/dist/core/utils/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/utils/server.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,eAAe,CAAC,CA+C1B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/utils/server.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,eAAe,CAAC,CA2D1B"}

package/dist/core/utils/server.js

@@ -5,7 +5,7 @@ import { stat } from 'fs/promises';
  * This handles common patterns like:
  * - /path/ -> /path/index.html
  * - /path/ -> /path.html (if no index.html exists)
- * - /path -> /path.html (when original path is not found)
+ * - /path -> /path.html (when original path is not found and has no extension)
  *
  * @param outDir The output directory to serve files from
  * @param requestPath The requested URL path
@@ -55,6 +55,19 @@ export async function resolvePrettyUrl(outDir, requestPath, originalFilePath) {
                 // Continue to not found
             }
         }
+        else if (!requestPath.includes('.')) {
+            // For requests without trailing slash and without extension, try .html
+            const htmlPath = join(outDir, `${requestPath}.html`);
+            try {
+                const stats = await stat(htmlPath);
+                if (stats.isFile()) {
+                    return { filePath: htmlPath, found: true };
+                }
+            }
+            catch {
+                // Continue to not found
+            }
+        }
         // No fallback worked
         return { filePath: null, found: false };
     }