@uniweb/core 0.26.1 → 0.26.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/src/page.js +17 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@uniweb/core",
3
- "version": "0.26.1",
3
+ "version": "0.26.2",
4
4
  "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
5
5
  "type": "module",
6
6
  "exports": {
package/src/page.js CHANGED
@@ -600,11 +600,23 @@ export default class Page {
600
600
  * is "give me the page to render *here*," not "give me the next URL
601
601
  * with content."
602
602
  *
603
- * Used by SSR paths (Cloudflare Worker isolate today; framework SSG
604
- * pre-handles this differently via expandDynamicPages) to avoid
605
- * rendering nothing when an author requests `/docs` and the page is
606
- * a folder whose actual landing content lives in `/docs/intro` flagged
607
- * as `isIndex: true`.
603
+ * The case it exists for: an author requests `/docs`, the page is a folder
604
+ * with no content of its own, and its actual landing content lives in
605
+ * `/docs/intro` flagged `isIndex: true`.
606
+ *
607
+ * ⭐ **ONE CALLER, AND IT IS THE RULE FOR BOTH OF THE RENDERER'S TARGET FORMS:**
608
+ * `createPageRenderer().render()` (`@uniweb/runtime`) applies this after
609
+ * resolving, so a route and an already-resolved Page promote identically.
610
+ * Ruled 2026-09-12 [Diego], closing an asymmetry in which the same page rendered
611
+ * differently depending on which form the caller held — silently, with no error
612
+ * on either path.
613
+ *
614
+ * ⚠️ **It briefly had NO caller** (2026-09-12), after an SSR consumer replaced its
615
+ * hand-composed sequence with `render()`. An earlier version of this paragraph
616
+ * named that consumer and claimed the static build "pre-handles this differently
617
+ * via expandDynamicPages"; **both halves were wrong** — the static build never
618
+ * called this at all: it emits a redirect to the first descendant with content
619
+ * (`getNavigableRoute`) rather than promoting anything.
608
620
  *
609
621
  * @returns {Page} The page to render — `this` or its index child.
610
622
  */