@stati/core 1.26.2 → 1.27.0

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

@@ -9,6 +9,8 @@ export { propValue } from './template.utils.js';
 export { slugify } from './slugify.utils.js';
 export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.utils.js';
 export { createValidatingPartialsProxy } from './partial-validation.utils.js';
+export { createValidatingContextProxy, isPassthroughProperty, parseUnknownPropertyMessage, UnknownTemplatePropertyError, } from './context-validation.utils.js';
+export { editDistance, findSimilarNames } from './similarity.utils.js';
 export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials.utils.js';
 export type { CallablePartial } from './callable-partials.utils.js';
 export { TemplateError, parseEtaError, createTemplateError } from './template-errors.utils.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,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,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,+BAA+B,CAAC;AAGvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,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,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,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,+BAA+B,CAAC;AAGvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAG9E,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/core/utils/index.js

@@ -16,6 +16,10 @@ export { slugify } from './slugify.utils.js';
 export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.utils.js';
 // Partial validation utilities
 export { createValidatingPartialsProxy } from './partial-validation.utils.js';
+// Template context validation utilities
+export { createValidatingContextProxy, isPassthroughProperty, parseUnknownPropertyMessage, UnknownTemplatePropertyError, } from './context-validation.utils.js';
+// String similarity utilities
+export { editDistance, findSimilarNames } from './similarity.utils.js';
 // Callable partial utilities
 export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials.utils.js';
 // Template error utilities

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

@@ -1 +1 @@
-{"version":3,"file":"partial-validation.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partial-validation.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA8FpE;;;;;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"}
+{"version":3,"file":"partial-validation.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partial-validation.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAqDpE;;;;;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,CA4DnB"}

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

@@ -1,4 +1,6 @@
 import { isProduction } from '../../env.js';
+import { isPassthroughProperty } from './context-validation.utils.js';
+import { findSimilarNames } from './similarity.utils.js';
 /**
  * Creates inline error overlay HTML for missing partials
  */
@@ -6,82 +8,45 @@ function createInlineErrorOverlay(partialName, suggestions) {
     const suggestionText = suggestions.length > 0
         ? `Did you mean: ${suggestions.map((s) => `"${s}"`).join(', ')}?`
         : 'No similar partials found';
+    // Inline styles only: this toast is injected into the user's own page, so it
+    // carries the Stati dark slate palette rather than relying on page styles.
     return `
 <!-- Stati Development Error Overlay -->
-<div style="
+<div role="alert" style="
   position: fixed;
-  top: 20px;
-  right: 20px;
-  z-index: 999999;
-  background: #dc2626;
-  color: white;
-  padding: 16px;
+  top: 16px;
+  right: 16px;
+  z-index: 2147483647;
+  box-sizing: border-box;
+  width: min(24rem, calc(100vw - 32px));
+  margin: 0;
+  padding: 14px 16px;
+  background: #0f172a;
+  color: #f1f5f9;
+  border: 1px solid #475569;
   border-radius: 8px;
-  box-shadow: 0 4px 12px rgba(0,0,0,0.3);
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  font-family: Inter, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
   font-size: 14px;
-  line-height: 1.4;
-  max-width: 400px;
-  border: 2px solid #fca5a5;
+  font-weight: 400;
+  line-height: 1.5;
+  text-align: left;
 ">
-  <div style="font-weight: 600; margin-bottom: 8px; font-size: 16px;">
-    ⚠️ Template Error
+  <div style="display: flex; align-items: center; gap: 8px; margin-bottom: 6px; font-size: 13px; font-weight: 600; color: #f87171;">
+    <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="flex: none;"><path d="M12 9v4M12 17h.01M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z"/></svg>
+    Template Error
   </div>
-  <div style="margin-bottom: 8px;">
-    <strong>Partial "${partialName}" not found</strong>
+  <div style="font-weight: 600; overflow-wrap: anywhere;">
+    Partial "${partialName}" not found
   </div>
-  <div style="color: #fca5a5; font-size: 13px;">
+  <div style="margin-top: 2px; font-size: 13px; color: #94a3b8; overflow-wrap: anywhere;">
     ${suggestionText}
   </div>
-  <div style="margin-top: 12px; padding-top: 8px; border-top: 1px solid #fca5a5; font-size: 12px; opacity: 0.8;">
+  <div style="margin-top: 12px; padding-top: 10px; border-top: 1px solid #1e293b; font-size: 12px; color: #8391a7;">
     Fix the partial name in your template to dismiss this error
   </div>
 </div>
 <!-- End Stati Error Overlay -->`;
 }
-/**
- * Finds similar partial names to suggest when a partial is not found
- */
-function findSimilarPartialNames(targetName, availableNames) {
-    if (availableNames.length === 0)
-        return [];
-    // Simple similarity check based on common prefixes and substrings
-    const target = targetName.toLowerCase();
-    const suggestions = availableNames
-        .map((name) => {
-        const candidate = name.toLowerCase();
-        let score = 0;
-        // Exact match gets highest score
-        if (candidate === target)
-            return { name, score: 1000 };
-        // Check if one is contained in the other
-        if (candidate.includes(target) || target.includes(candidate)) {
-            score += 100;
-        }
-        // Check common prefix length
-        let prefixLen = 0;
-        for (let i = 0; i < Math.min(target.length, candidate.length); i++) {
-            if (target[i] === candidate[i]) {
-                prefixLen++;
-            }
-            else {
-                break;
-            }
-        }
-        score += prefixLen * 10;
-        // Check common characters
-        const targetChars = new Set(target);
-        const candidateChars = new Set(candidate);
-        const commonChars = [...targetChars].filter((char) => candidateChars.has(char));
-        score += commonChars.length;
-        return { name, score };
-    })
-        .filter((item) => item.score > 0) // Only include items with some similarity
-        .sort((a, b) => b.score - a.score) // Sort by score descending
-        .slice(0, 3) // Top 3 suggestions
-        .map((item) => item.name);
-    return suggestions;
-}
 /**
  * Creates a development-mode Proxy for the partials object that throws errors
  * when accessing non-existent partials instead of returning undefined.
@@ -101,31 +66,15 @@ export function createValidatingPartialsProxy(partials) {
     }
     return new Proxy(partials, {
         get(target, prop, receiver) {
-            // Allow normal object operations
-            if (typeof prop === 'symbol') {
-                return Reflect.get(target, prop, receiver);
-            }
             const propName = String(prop);
-            // Check if the property exists
-            if (propName in target) {
-                return target[propName];
-            }
-            // Special case: allow accessing length, toString, etc.
-            // 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 existing partials, and let symbols, prototype methods, and
+            // serializer/test-tooling probes resolve normally
+            if (propName in target || isPassthroughProperty(prop)) {
                 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);
+            const suggestions = findSimilarNames(propName, availablePartials);
             // In development, render an inline error overlay
             const errorHtml = createInlineErrorOverlay(propName, suggestions);
             // Check if we're dealing with CallablePartials by testing a known partial

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

@@ -0,0 +1,34 @@
+/**
+ * String similarity helpers used to build "did you mean" suggestions.
+ */
+/**
+ * Computes the edit distance between two strings, counting insertions,
+ * deletions, substitutions, and transpositions of adjacent characters
+ * (optimal string alignment distance).
+ *
+ * @example
+ * ```typescript
+ * editDistance('paeg', 'page'); // 1 (transposition)
+ * editDistance('titel', 'title'); // 1
+ * ```
+ */
+export declare function editDistance(a: string, b: string): number;
+/**
+ * Finds the candidates that look like a misspelling of `target`, best match first.
+ *
+ * A candidate matches when its case-insensitive edit distance to the target is at
+ * most a third of the target's length (minimum 1), or when one is a prefix of the
+ * other and both are at least 3 characters long.
+ *
+ * @param target - The name that was not found
+ * @param candidates - The names that do exist
+ * @param limit - Maximum number of suggestions to return
+ *
+ * @example
+ * ```typescript
+ * findSimilarNames('paeg', ['page', 'partials', 'site']); // ['page']
+ * findSimilarNames('head', ['header', 'hero', 'footer']); // ['header']
+ * ```
+ */
+export declare function findSimilarNames(target: string, candidates: Iterable<string>, limit?: number): string[];
+//# sourceMappingURL=similarity.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/similarity.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,KAAK,SAAI,GACR,MAAM,EAAE,CAsBV"}

package/dist/core/utils/similarity.utils.js

@@ -0,0 +1,73 @@
+/**
+ * String similarity helpers used to build "did you mean" suggestions.
+ */
+/**
+ * Computes the edit distance between two strings, counting insertions,
+ * deletions, substitutions, and transpositions of adjacent characters
+ * (optimal string alignment distance).
+ *
+ * @example
+ * ```typescript
+ * editDistance('paeg', 'page'); // 1 (transposition)
+ * editDistance('titel', 'title'); // 1
+ * ```
+ */
+export function editDistance(a, b) {
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const d = Array.from({ length: rows }, (_, i) => {
+        const row = new Array(cols).fill(0);
+        row[0] = i;
+        return row;
+    });
+    for (let j = 0; j < cols; j++) {
+        d[0][j] = j;
+    }
+    for (let i = 1; i < rows; i++) {
+        for (let j = 1; j < cols; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            let value = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                value = Math.min(value, d[i - 2][j - 2] + 1);
+            }
+            d[i][j] = value;
+        }
+    }
+    return d[a.length][b.length];
+}
+/**
+ * Finds the candidates that look like a misspelling of `target`, best match first.
+ *
+ * A candidate matches when its case-insensitive edit distance to the target is at
+ * most a third of the target's length (minimum 1), or when one is a prefix of the
+ * other and both are at least 3 characters long.
+ *
+ * @param target - The name that was not found
+ * @param candidates - The names that do exist
+ * @param limit - Maximum number of suggestions to return
+ *
+ * @example
+ * ```typescript
+ * findSimilarNames('paeg', ['page', 'partials', 'site']); // ['page']
+ * findSimilarNames('head', ['header', 'hero', 'footer']); // ['header']
+ * ```
+ */
+export function findSimilarNames(target, candidates, limit = 3) {
+    const normalizedTarget = target.toLowerCase();
+    const maxDistance = Math.max(1, Math.floor(normalizedTarget.length / 3));
+    const matches = [];
+    for (const name of new Set(candidates)) {
+        const candidate = name.toLowerCase();
+        const distance = editDistance(normalizedTarget, candidate);
+        const isPrefix = Math.min(candidate.length, normalizedTarget.length) >= 3 &&
+            (candidate.startsWith(normalizedTarget) || normalizedTarget.startsWith(candidate));
+        if (distance <= maxDistance || isPrefix) {
+            // Prefix matches win ties against plain edit-distance matches
+            matches.push({ name, score: distance - (isPrefix ? 0.5 : 0) });
+        }
+    }
+    return matches
+        .sort((a, b) => a.score - b.score || a.name.localeCompare(b.name))
+        .slice(0, limit)
+        .map((match) => match.name);
+}

package/dist/core/utils/template-errors.utils.d.ts

@@ -7,11 +7,13 @@ export declare class TemplateError extends Error {
     readonly line?: number;
     readonly column?: number;
     readonly template?: string;
+    /** Error-specific suggestions shown before the generic ones in the overlay */
+    readonly suggestions?: string[];
     readonly context?: {
         before?: string[];
         after?: string[];
     };
-    constructor(message: string, filePath?: string, line?: number, column?: number, template?: string);
+    constructor(message: string, filePath?: string, line?: number, column?: number, template?: string, suggestions?: string[]);
     /**
      * Converts this template error to ErrorDetails for the overlay.
      */

package/dist/core/utils/template-errors.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-errors.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/template-errors.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,OAAO,CAAC,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;gBAGA,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM;IAUnB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;CAoE9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CA8BhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAMf"}
+{"version":3,"file":"template-errors.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/template-errors.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,8EAA8E;IAC9E,SAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvC,SAAgB,OAAO,CAAC,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;gBAGA,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,EAAE;IAWxB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;CAoE9C;AAsCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAoDhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAMf"}

package/dist/core/utils/template-errors.utils.js

@@ -1,5 +1,6 @@
 import { readFile } from 'fs/promises';
 import { pathExists } from './fs.utils.js';
+import { parseUnknownPropertyMessage } from './context-validation.utils.js';
 /**
  * Enhanced template error that includes file context and suggestions.
  */
@@ -8,8 +9,10 @@ export class TemplateError extends Error {
     line;
     column;
     template;
+    /** Error-specific suggestions shown before the generic ones in the overlay */
+    suggestions;
     context;
-    constructor(message, filePath, line, column, template) {
+    constructor(message, filePath, line, column, template, suggestions) {
         super(message);
         this.name = 'TemplateError';
         if (filePath !== undefined)
@@ -20,12 +23,14 @@ export class TemplateError extends Error {
             this.column = column;
         if (template !== undefined)
             this.template = template;
+        if (suggestions !== undefined)
+            this.suggestions = suggestions;
     }
     /**
      * Converts this template error to ErrorDetails for the overlay.
      */
     async toErrorDetails() {
-        const suggestions = [];
+        const suggestions = [...(this.suggestions ?? [])];
         const message = this.message.toLowerCase();
         // Add specific suggestions based on error type
         if (message.includes('not found') || message.includes('cannot resolve')) {
@@ -87,6 +92,39 @@ export class TemplateError extends Error {
         return errorDetails;
     }
 }
+/**
+ * Header that Eta's debug mode prepends to runtime errors:
+ * `<path>:<line>` (or `line <line>` without a path), a numbered excerpt of the
+ * template, then a blank line and the original message.
+ */
+const ETA_RUNTIME_ERROR_HEADER = /^(?:(.+):(\d+)|line (\d+))\n(?:(?: >> | {4})\d+\|[^\n]*\n)+\n/;
+/**
+ * Root template context properties, used to suggest `stati.<name>` when a
+ * template references one without the `stati.` prefix.
+ */
+const CONTEXT_ROOT_NAMES = new Set([
+    'site',
+    'page',
+    'content',
+    'nav',
+    'partials',
+    'collection',
+    'props',
+    'assets',
+    'generator',
+    'generateSEO',
+    'propValue',
+]);
+function getReferenceErrorSuggestions(message) {
+    const name = message.match(/^(\S+) is not defined$/)?.[1];
+    if (name === 'it') {
+        return ['Stati templates use "stati" instead of Eta\'s default "it", e.g. stati.page.title'];
+    }
+    if (name && CONTEXT_ROOT_NAMES.has(name)) {
+        return [`Did you mean "stati.${name}"?`];
+    }
+    return [];
+}
 /**
  * Parses Eta template errors to extract file location information.
  */
@@ -94,16 +132,38 @@ export function parseEtaError(error, templatePath) {
     let filePath = templatePath;
     let line;
     let column;
-    // Try to parse error location from Eta error messages
-    const message = error.message;
-    // Eta syntax errors often include line/column info
-    const locationMatch = message.match(/at line (\d+), column (\d+)/i);
+    let message = error.message;
+    // Eta's debug mode wraps runtime errors in a header with the template path and
+    // line. A partial rendered inside another template is wrapped once per level,
+    // so unwrap them all and keep the innermost location.
+    let header = message.match(ETA_RUNTIME_ERROR_HEADER);
+    while (header) {
+        if (header[1] !== undefined) {
+            filePath = header[1];
+        }
+        // The regex captures the line in group 2 (with a path) or group 3 (without)
+        line = parseInt(header[2] ?? header[3], 10);
+        column = undefined;
+        message = message.slice(header[0].length);
+        header = message.match(ETA_RUNTIME_ERROR_HEADER);
+    }
+    // Eta syntax errors report "at line N col N"
+    const locationMatch = message.match(/at line (\d+),? col(?:umn)? (\d+)/i);
     if (locationMatch && locationMatch[1] && locationMatch[2]) {
         line = parseInt(locationMatch[1], 10);
         column = parseInt(locationMatch[2], 10);
     }
+    let suggestions = [];
+    const unknownProperty = parseUnknownPropertyMessage(message);
+    if (unknownProperty) {
+        message = unknownProperty.message;
+        suggestions = unknownProperty.suggestions;
+    }
+    else if (error.name === 'ReferenceError') {
+        suggestions = getReferenceErrorSuggestions(message);
+    }
     // Try to extract file path from stack trace if not provided
-    if (!filePath && error.stack) {
+    if (!filePath && line === undefined && error.stack) {
         const stackLines = error.stack.split('\n');
         for (const stackLine of stackLines) {
             const fileMatch = stackLine.match(/at.*\(([^)]+\.eta):(\d+):(\d+)\)/);
@@ -115,7 +175,7 @@ export function parseEtaError(error, templatePath) {
             }
         }
     }
-    return new TemplateError(message, filePath, line, column);
+    return new TemplateError(message, filePath, line, column, undefined, suggestions);
 }
 /**
  * Enhances a generic error with template-specific context.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stati/core",
-  "version": "1.26.2",
+  "version": "1.27.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",