@markless/router 0.3.0 → 0.3.1

package/dist/vite/runtime/create-server-entry.js

@@ -281,7 +281,20 @@ function fillDocumentChildren(documentShell, children) {
 	return documentShell.slice(0, at) + children + documentShell.slice(at + 37);
 }
 async function renderDocumentModule(documentModule, props) {
-	return (await documentModule?.default?.renderSsr?.(props))?.html;
+	const output = await documentModule?.default?.renderSsr?.(props);
+	assertDocumentStorageFree(output);
+	return output?.html;
+}
+function assertDocumentStorageFree(output) {
+	const storage = documentStorageRecords(output?.state);
+	if (storage.length === 0) return;
+	const keys = storage.map((record) => record.key).join(", ");
+	throw new Error(`MARKLESS_ROUTER_DOCUMENT_STORAGE_UNSUPPORTED: the document declares storage cells (${keys}), but the router serves only the document's HTML, so their state payload never reaches the browser and they can never resume. Declare storage() at module scope in a component the page renders instead.`);
+}
+function documentStorageRecords(state) {
+	if (!state || typeof state !== "object") return [];
+	const storage = state.storage;
+	return Array.isArray(storage) ? storage : [];
 }
 function insertHeadHtml(documentHtml, headHtml) {
 	if (!headHtml) return documentHtml;

package/dist/vite/runtime/mdx-route.d.ts

@@ -43,11 +43,20 @@ type MdxRenderDataChild = {
   readonly surface: MdxRenderDataSurface;
 };
 declare function createMdxRenderDataSurface(parts: ReadonlyArray<MdxRoutePart>, children: ReadonlyArray<MdxRenderDataChild>): MdxRenderDataSurface;
+type MdxComputedRecord = {
+  readonly deriveSymbolId?: string;
+  readonly [key: string]: unknown;
+};
+type MdxStorageRecord = {
+  readonly graphNodeId: string;
+  readonly key: string;
+};
 type MdxStatePayload = {
   readonly version: unknown;
   readonly cells?: readonly unknown[];
-  readonly computed?: readonly unknown[];
+  readonly computed?: readonly MdxComputedRecord[];
   readonly sharedDefinitions?: readonly unknown[];
+  readonly storage?: readonly MdxStorageRecord[];
 };
 type MdxLocator = {
   readonly hostNodeId: string;

package/dist/vite/runtime/mdx-route.js

@@ -1,3 +1,7 @@
+function protocolStateVersion(storage) {
+	return (storage?.length ?? 0) > 0 ? 2 : 1;
+}
+//#endregion
 //#region src/vite/runtime/mdx-route.ts
 function createMdxRenderDataSurface(parts, children) {
 	const componentName = "MarklessMdxRoute";
@@ -125,13 +129,18 @@ async function renderMdxChild(children, component, props, child) {
 	return output?.html ?? "";
 }
 function composeMdxState(children) {
-	const childStates = children.map((child) => child.output?.state).filter(isDefined);
+	const childStates = children.map((child) => ({
+		child,
+		state: child.output?.state
+	})).filter((entry) => isDefined(entry.state));
 	if (childStates.length === 0) return;
+	const storage = childStates.flatMap(({ state }) => state.storage ?? []);
 	return {
-		version: childStates[0].version,
-		cells: childStates.flatMap((state) => state.cells ?? []),
-		computed: childStates.flatMap((state) => state.computed ?? []),
-		...childStates.some((state) => state.sharedDefinitions?.length) ? { sharedDefinitions: childStates.flatMap((state) => state.sharedDefinitions ?? []) } : {}
+		version: protocolStateVersion(storage),
+		cells: childStates.flatMap(({ state }) => state.cells ?? []),
+		computed: childStates.flatMap(({ child, state }) => (state.computed ?? []).map((record) => prefixMdxComputedRecord(record, child))),
+		...childStates.some(({ state }) => state.sharedDefinitions?.length) ? { sharedDefinitions: childStates.flatMap(({ state }) => state.sharedDefinitions ?? []) } : {},
+		...storage.length > 0 ? { storage } : {}
 	};
 }
 function composeMdxView(parts, children, initialElementOffset) {
@@ -201,6 +210,12 @@ function appendMdxChildView(context) {
 		hostNodeId: context.child.hostPrefix + handle.hostNodeId
 	});
 }
+function prefixMdxComputedRecord(record, child) {
+	return {
+		...record,
+		...record.deriveSymbolId ? { deriveSymbolId: child.symbolPrefix + record.deriveSymbolId } : {}
+	};
+}
 function prefixMdxSymbolRecord(record, child) {
 	return {
 		...record,

package/dist/vite.js

@@ -728,6 +728,7 @@ async function transformMdxRoute(source, id) {
 		"const marklessMdxRenderData = createMdxRenderDataSurface(marklessMdxParts, []);",
 		"const marklessMdxPage = {",
 		"  renderData: marklessMdxRenderData,",
+		"  storageSeeds: marklessMdxStorageSeeds,",
 		"  renderSsr() {",
 		`    return { html: ${JSON.stringify(html)} };`,
 		"  }",
@@ -746,9 +747,11 @@ function emitComposedMdxRoute(route, id) {
 		`const marklessMdxParts = ${JSON.stringify(route.parts)};`,
 		`const marklessMdxSymbolLoaders = ${renderSymbolLoaders(route.components)};`,
 		`const marklessMdxRenderData = ${renderMdxRenderDataLoader(route.components, id)};`,
+		`const marklessMdxStorageSeeds = ${renderStorageSeeds(route.components)};`,
 		"",
 		"const marklessMdxPage = {",
 		"  renderData: marklessMdxRenderData,",
+		"  storageSeeds: marklessMdxStorageSeeds,",
 		"  loadSymbol: marklessMdxLoadSymbol,",
 		"  async renderSsr(props = {}) {",
 		"    const marklessMdxChildren = [];",
@@ -1031,6 +1034,10 @@ function hastElementTags(nodes) {
 	}
 	return tags;
 }
+function renderStorageSeeds(components) {
+	const localNames = [...new Set(components.map((component) => component.localName))];
+	return localNames.length === 0 ? "[]" : `[${localNames.map((localName) => `...(${localName}.storageSeeds ?? [])`).join(", ")}]`;
+}
 function renderSymbolLoaders(components) {
 	return `[${components.map((component) => `{ prefix: ${JSON.stringify(component.prefix)}, loadSymbol(symbolId) { return import(${JSON.stringify(`${component.specifier}?markless-symbols`)}).then((mod) => mod.loadSymbol(symbolId.slice(${component.prefix.length}))); } }`).join(", ")}]`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markless/router",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Markless router: client-side navigation with SSR streaming and build-time preload maps.",
   "license": "MIT",
   "repository": {
@@ -64,11 +64,11 @@
     "pathe": "^2.0.3",
     "satteri": "0.6.3",
     "ufo": "^1.6.4",
-    "@markless/bundler": "0.3.0",
-    "@markless/web": "0.3.0"
+    "@markless/web": "0.3.1",
+    "@markless/bundler": "0.3.1"
   },
   "devDependencies": {
-    "@markless/analyzer": "0.3.0"
+    "@markless/analyzer": "0.3.1"
   },
   "peerDependencies": {
     "vite": "8.0.16"