mechanica 2.0.0-alpha.7 → 2.0.0-alpha.8

package/dist/chunks/{page-assets-BjIm0jws.js → page-assets-BCUAuOlo.js}

@@ -658,8 +658,40 @@ function listPages(mechDir, options = {}) {
 		}
 		items.push(item);
 	}
+	if (options.generated?.length) items.push(...generatedPageItems(options.generated, options, config));
 	return items.sort(comparePages);
 }
+/** File-less pages → list rows: one per logical path, with a `locales` union. */
+function generatedPageItems(generated, options, config) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const vp of generated) {
+		const arr = groups.get(vp.path);
+		if (arr) arr.push(vp);
+		else groups.set(vp.path, [vp]);
+	}
+	const items = [];
+	for (const [path, vps] of groups) {
+		const locales = config ? vps.map((v) => v.locale).filter(Boolean) : [];
+		if (options.locale && !locales.includes(options.locale)) continue;
+		const source = (options.locale ? vps.find((v) => v.locale === options.locale) : void 0) ?? (config ? vps.find((v) => v.locale === config.default) : void 0) ?? vps[0];
+		const embedded = {};
+		for (const dataEntry of options.data ?? []) embedded[dataEntry.id] = source.data?.[dataEntry.id] ?? {};
+		const dir = path.slice(1).split("/").slice(0, -1).join("/");
+		const item = {
+			path,
+			name: (typeof source.meta?.title === "string" ? source.meta.title : void 0) ?? path.split("/").pop() ?? path,
+			folderPath: dir === "" ? null : dir,
+			order: 0,
+			orderAfter: null,
+			draft: false,
+			generated: true,
+			...embedded
+		};
+		if (config) item.locales = config.all.filter((code) => locales.includes(code));
+		items.push(item);
+	}
+	return items;
+}
 /** Ordering: by folder, then explicit `orderAfter`, then `order`, then path. */
 function comparePages(a, b) {
 	if (a.folderPath === b.folderPath) {

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { B as readImageManifest, C as getPagePath, I as UPLOADS_PREFIX, J as hasSharp, L as assetFileOf, N as setPageCodec, R as isDerivedAsset, T as listPages, U as updateImageManifest, Y as isRasterImage, a as toBlockMeta, d as readFolderData, f as readFoldersData, i as composedBlockMeta, m as readSiteLocaleOverride, n as blockAssetLinks, p as readSiteData, q as analyzeImageBuffer, r as buildRichTextCodec, t as BLOCKS_MANIFEST_FILE } from "./chunks/page-assets-BjIm0jws.js";
+import { B as readImageManifest, C as getPagePath, I as UPLOADS_PREFIX, J as hasSharp, L as assetFileOf, N as setPageCodec, R as isDerivedAsset, T as listPages, U as updateImageManifest, Y as isRasterImage, a as toBlockMeta, d as readFolderData, f as readFoldersData, i as composedBlockMeta, m as readSiteLocaleOverride, n as blockAssetLinks, p as readSiteData, q as analyzeImageBuffer, r as buildRichTextCodec, t as BLOCKS_MANIFEST_FILE } from "./chunks/page-assets-BCUAuOlo.js";
 import fs from "node:fs";
 import { dirname, join, parse, relative } from "node:path";
 import { applySeoTags, auditPageHtml, buildRobotsTxt, buildSitemap, findUnknownBlocks, generateProject, isPaginatedQuery, localePath, mergeTranslation, migrateContent, paginationVariantPath, registerFieldSchemas, resolveQueryKey, templateBlockIds, validateLinks, walkSchema, walkTree } from "mechanica-shared";
@@ -367,7 +367,10 @@ async function exportProject(cwd, ssr, options = {}) {
 	}
 	setPageCodec(richText);
 	const querySource = {
-		listPages: (opts) => listPages(join(cwd, ".mech"), opts),
+		listPages: (opts) => listPages(join(cwd, ".mech"), {
+			...opts,
+			generated: ssr.generatedPages
+		}),
 		fetchJson: async ({ url, ...init }) => {
 			const res = await fetch(url, init);
 			if (!res.ok) throw new Error(`${url} responded ${res.status}`);

package/dist/editor.css

@@ -4802,7 +4802,7 @@ from {
   justify-content: flex-end;
   gap: 8px;
   margin-top: 4px;
-}.mech-pages[data-v-e750b5bb] {
+}.mech-pages[data-v-5f70933a] {
   display: flex;
   align-items: stretch;
   justify-content: center;
@@ -4811,7 +4811,7 @@ from {
   max-width: 1200px;
   height: min(620px, 82vh);
 }
-.mech-pages__card[data-v-e750b5bb] {
+.mech-pages__card[data-v-5f70933a] {
   display: flex;
   flex-direction: column;
   flex: 0 1 840px;
@@ -4821,20 +4821,20 @@ from {
   box-shadow: var(--mech-shadow-dialog);
   overflow: hidden;
 }
-.mech-pages__header[data-v-e750b5bb] {
+.mech-pages__header[data-v-5f70933a] {
   display: flex;
   align-items: center;
   gap: 10px;
   padding: 18px 14px 12px 24px;
   flex: none;
 }
-.mech-pages__title[data-v-e750b5bb] {
+.mech-pages__title[data-v-5f70933a] {
   margin: 0;
   font-size: 16px;
   font-weight: 600;
   letter-spacing: -0.01em;
 }
-.mech-pages__count[data-v-e750b5bb] {
+.mech-pages__count[data-v-5f70933a] {
   padding: 2px 8px;
   border-radius: var(--mech-radius-pill);
   background: var(--mech-active);
@@ -4842,7 +4842,7 @@ from {
   font-size: 11.5px;
   font-weight: 600;
 }
-.mech-pages__close[data-v-e750b5bb] {
+.mech-pages__close[data-v-5f70933a] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -4855,25 +4855,25 @@ from {
   border-radius: var(--mech-radius-pill);
   cursor: pointer;
 }
-.mech-pages__close .vicon[data-v-e750b5bb] {
+.mech-pages__close .vicon[data-v-5f70933a] {
   width: 18px;
   height: 18px;
 }
-.mech-pages__close[data-v-e750b5bb]:hover {
+.mech-pages__close[data-v-5f70933a]:hover {
   background: var(--mech-hover);
   color: var(--mech-fg);
 }
-.mech-pages__toolbar[data-v-e750b5bb] {
+.mech-pages__toolbar[data-v-5f70933a] {
   display: flex;
   gap: 8px;
   padding: 0 24px 14px;
   flex: none;
 }
-.mech-pages__search-wrap[data-v-e750b5bb] {
+.mech-pages__search-wrap[data-v-5f70933a] {
   position: relative;
   flex: 1;
 }
-.mech-pages__search-icon[data-v-e750b5bb] {
+.mech-pages__search-icon[data-v-5f70933a] {
   position: absolute;
   left: 12px;
   top: 50%;
@@ -4883,18 +4883,18 @@ from {
   color: var(--mech-muted);
   pointer-events: none;
 }
-.mech-pages__search[data-v-e750b5bb] {
+.mech-pages__search[data-v-5f70933a] {
   width: 100%;
   padding-left: 36px;
 }
-.mech-pages__content[data-v-e750b5bb] {
+.mech-pages__content[data-v-5f70933a] {
   display: flex;
   gap: 14px;
   flex: 1;
   min-height: 0;
   padding: 0 24px 20px;
 }
-.mech-pages__rail[data-v-e750b5bb] {
+.mech-pages__rail[data-v-5f70933a] {
   flex: none;
   width: 172px;
   display: flex;
@@ -4903,7 +4903,7 @@ from {
   overflow-y: auto;
   padding-right: 2px;
 }
-.mech-pages__rail-item[data-v-e750b5bb] {
+.mech-pages__rail-item[data-v-5f70933a] {
   display: flex;
   align-items: center;
   gap: 8px;
@@ -4917,51 +4917,51 @@ from {
   color: var(--mech-fg-alt);
   cursor: pointer;
 }
-.mech-pages__rail-item .vicon[data-v-e750b5bb] {
+.mech-pages__rail-item .vicon[data-v-5f70933a] {
   flex: none;
   width: 15px;
   height: 15px;
   color: var(--mech-muted);
 }
-.mech-pages__rail-item[data-v-e750b5bb]:hover {
+.mech-pages__rail-item[data-v-5f70933a]:hover {
   background: var(--mech-hover);
 }
-.mech-pages__rail-item.is-active[data-v-e750b5bb] {
+.mech-pages__rail-item.is-active[data-v-5f70933a] {
   background: var(--mech-accent-soft);
   color: var(--mech-accent);
   font-weight: 500;
 }
-.mech-pages__rail-item.is-active .vicon[data-v-e750b5bb] {
+.mech-pages__rail-item.is-active .vicon[data-v-5f70933a] {
   color: var(--mech-accent);
 }
-.mech-pages__rail-name[data-v-e750b5bb] {
+.mech-pages__rail-name[data-v-5f70933a] {
   flex: 1;
   min-width: 0;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
-.mech-pages__rail-count[data-v-e750b5bb] {
+.mech-pages__rail-count[data-v-5f70933a] {
   flex: none;
   font-size: 11px;
   color: var(--mech-placeholder);
 }
-.mech-pages__rail-item.is-active .mech-pages__rail-count[data-v-e750b5bb] {
+.mech-pages__rail-item.is-active .mech-pages__rail-count[data-v-5f70933a] {
   color: var(--mech-accent);
   opacity: 0.7;
 }
-.mech-pages__list[data-v-e750b5bb] {
+.mech-pages__list[data-v-5f70933a] {
   flex: 1;
   min-width: 0;
   overflow-y: auto;
 }
-.mech-pages__row[data-v-e750b5bb], .mech-pages__thead[data-v-e750b5bb] {
+.mech-pages__row[data-v-5f70933a], .mech-pages__thead[data-v-5f70933a] {
   display: grid;
   grid-template-columns: minmax(0, 1.1fr) minmax(0, 1fr) 96px;
   align-items: center;
   column-gap: 12px;
 }
-.mech-pages__thead[data-v-e750b5bb] {
+.mech-pages__thead[data-v-5f70933a] {
   position: sticky;
   top: 0;
   z-index: 1;
@@ -4969,14 +4969,14 @@ from {
   background: var(--mech-bg);
   box-shadow: 0 1px 0 var(--mech-border);
 }
-.mech-pages__thead span[data-v-e750b5bb] {
+.mech-pages__thead span[data-v-5f70933a] {
   font-size: 10.5px;
   font-weight: 600;
   text-transform: uppercase;
   letter-spacing: 0.05em;
   color: var(--mech-muted);
 }
-.mech-pages__group[data-v-e750b5bb] {
+.mech-pages__group[data-v-5f70933a] {
   display: flex;
   align-items: center;
   gap: 7px;
@@ -4995,36 +4995,36 @@ from {
   border-radius: var(--mech-radius-sm);
   cursor: pointer;
 }
-.mech-pages__group .vicon[data-v-e750b5bb] {
+.mech-pages__group .vicon[data-v-5f70933a] {
   width: 13px;
   height: 13px;
 }
-.mech-pages__group[data-v-e750b5bb]:hover {
+.mech-pages__group[data-v-5f70933a]:hover {
   color: var(--mech-fg);
 }
-.mech-pages__row[data-v-e750b5bb] {
+.mech-pages__row[data-v-5f70933a] {
   padding: 0 10px;
   height: 38px;
   border-radius: var(--mech-radius-sm);
   cursor: pointer;
 }
-.mech-pages__row.is-active[data-v-e750b5bb] {
+.mech-pages__row.is-active[data-v-5f70933a] {
   background: var(--mech-accent-soft);
 }
-.mech-pages__cell-name[data-v-e750b5bb] {
+.mech-pages__cell-name[data-v-5f70933a] {
   display: flex;
   align-items: center;
   gap: 8px;
   min-width: 0;
 }
-.mech-pages__name[data-v-e750b5bb] {
+.mech-pages__name[data-v-5f70933a] {
   font-size: 13.5px;
   font-weight: 500;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
-.mech-pages__badge[data-v-e750b5bb] {
+.mech-pages__badge[data-v-5f70933a] {
   flex: none;
   font-size: 10px;
   font-weight: 600;
@@ -5036,17 +5036,17 @@ from {
   border-radius: var(--mech-radius-pill);
   padding: 1px 7px;
 }
-.mech-pages__badge.is-draft[data-v-e750b5bb] {
+.mech-pages__badge.is-draft[data-v-5f70933a] {
   color: var(--mech-muted);
 }
-.mech-pages__locales[data-v-e750b5bb] {
+.mech-pages__locales[data-v-5f70933a] {
   flex: none;
   display: inline-flex;
   align-items: center;
   gap: 3px;
   margin-left: 2px;
 }
-.mech-pages__loc[data-v-e750b5bb] {
+.mech-pages__loc[data-v-5f70933a] {
   min-width: 15px;
   padding: 1px 4px;
   border-radius: var(--mech-radius-sm);
@@ -5060,12 +5060,12 @@ from {
   letter-spacing: 0.02em;
   opacity: 0.5;
 }
-.mech-pages__loc.is-on[data-v-e750b5bb] {
+.mech-pages__loc.is-on[data-v-5f70933a] {
   background: var(--mech-accent-soft);
   color: var(--mech-accent);
   opacity: 1;
 }
-.mech-pages__cell-path[data-v-e750b5bb] {
+.mech-pages__cell-path[data-v-5f70933a] {
   min-width: 0;
   overflow: hidden;
   text-overflow: ellipsis;
@@ -5073,16 +5073,16 @@ from {
   font-size: 12.5px;
   color: var(--mech-muted);
 }
-.mech-pages__actions[data-v-e750b5bb] {
+.mech-pages__actions[data-v-5f70933a] {
   display: flex;
   justify-content: flex-end;
   gap: 1px;
   opacity: 0;
 }
-.mech-pages__row.is-active .mech-pages__actions[data-v-e750b5bb], .mech-pages__row:hover .mech-pages__actions[data-v-e750b5bb] {
+.mech-pages__row.is-active .mech-pages__actions[data-v-5f70933a], .mech-pages__row:hover .mech-pages__actions[data-v-5f70933a] {
   opacity: 1;
 }
-.mech-pages__actions button[data-v-e750b5bb] {
+.mech-pages__actions button[data-v-5f70933a] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -5095,24 +5095,24 @@ from {
   cursor: pointer;
   line-height: 1;
 }
-.mech-pages__actions button .vicon[data-v-e750b5bb] {
+.mech-pages__actions button .vicon[data-v-5f70933a] {
   width: 15px;
   height: 15px;
 }
-.mech-pages__actions button[data-v-e750b5bb]:hover {
+.mech-pages__actions button[data-v-5f70933a]:hover {
   background: var(--mech-active);
   color: var(--mech-fg);
 }
-.mech-pages__actions button.is-danger[data-v-e750b5bb]:hover {
+.mech-pages__actions button.is-danger[data-v-5f70933a]:hover {
   color: var(--mech-error);
 }
-.mech-pages__empty[data-v-e750b5bb] {
+.mech-pages__empty[data-v-5f70933a] {
   padding: 24px 10px;
   margin: 0;
   color: var(--mech-muted);
   font-size: 13px;
 }
-.mech-pages__preview[data-v-e750b5bb] {
+.mech-pages__preview[data-v-5f70933a] {
   flex: none;
   align-self: flex-start;
   max-height: 100%;
@@ -5124,18 +5124,18 @@ from {
   box-shadow: var(--mech-shadow-dialog);
   overflow: hidden;
 }
-.mech-pages__preview-frame[data-v-e750b5bb] {
+.mech-pages__preview-frame[data-v-5f70933a] {
   flex: 0 1 auto;
   min-height: 0;
   overflow: hidden;
   background: var(--mech-app-bg);
 }
-.mech-pages__preview-frame img[data-v-e750b5bb] {
+.mech-pages__preview-frame img[data-v-5f70933a] {
   display: block;
   width: 100%;
   height: auto;
 }
-.mech-pages__preview-empty[data-v-e750b5bb] {
+.mech-pages__preview-empty[data-v-5f70933a] {
   display: flex;
   flex-direction: column;
   align-items: center;
@@ -5144,16 +5144,16 @@ from {
   padding: 48px 16px;
   color: var(--mech-muted);
 }
-.mech-pages__preview-empty p[data-v-e750b5bb] {
+.mech-pages__preview-empty p[data-v-5f70933a] {
   margin: 8px 0 0;
   font-size: 13px;
   font-weight: 500;
 }
-.mech-pages__preview-empty code[data-v-e750b5bb] {
+.mech-pages__preview-empty code[data-v-5f70933a] {
   font-size: 11.5px;
   color: var(--mech-placeholder);
 }
-.mech-pages__preview-monogram[data-v-e750b5bb] {
+.mech-pages__preview-monogram[data-v-5f70933a] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -5164,7 +5164,7 @@ from {
   font-size: 22px;
   font-weight: 600;
 }
-.mech-pages__preview-caption[data-v-e750b5bb] {
+.mech-pages__preview-caption[data-v-5f70933a] {
   flex: none;
   display: flex;
   flex-direction: column;
@@ -5172,14 +5172,14 @@ from {
   padding: 12px 16px 14px;
   border-top: 1px solid var(--mech-border);
 }
-.mech-pages__preview-name[data-v-e750b5bb] {
+.mech-pages__preview-name[data-v-5f70933a] {
   font-size: 13px;
   font-weight: 600;
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
-.mech-pages__preview-path[data-v-e750b5bb] {
+.mech-pages__preview-path[data-v-5f70933a] {
   font-size: 11.5px;
   color: var(--mech-muted);
   overflow: hidden;
@@ -5187,7 +5187,7 @@ from {
   white-space: nowrap;
 }
 @media (max-width: 1160px) {
-.mech-pages__preview[data-v-e750b5bb] {
+.mech-pages__preview[data-v-5f70933a] {
     display: none;
 }
 }.mech-pagebar[data-v-a0f85ad0] {

package/dist/editor.js

@@ -1913,31 +1913,35 @@ var _hoisted_18 = {
 };
 var _hoisted_19 = {
 	key: 2,
+	class: "mech-pages__badge"
+};
+var _hoisted_20 = {
+	key: 3,
 	class: "mech-pages__locales"
 };
-var _hoisted_20 = ["title"];
-var _hoisted_21 = { class: "mech-pages__cell-path" };
-var _hoisted_22 = ["onClick"];
+var _hoisted_21 = ["title"];
+var _hoisted_22 = { class: "mech-pages__cell-path" };
 var _hoisted_23 = ["onClick"];
 var _hoisted_24 = ["onClick"];
-var _hoisted_25 = {
+var _hoisted_25 = ["onClick"];
+var _hoisted_26 = {
 	key: 0,
 	class: "mech-pages__empty"
 };
-var _hoisted_26 = { class: "mech-pages__preview" };
-var _hoisted_27 = { class: "mech-pages__preview-frame" };
-var _hoisted_28 = ["src", "data-path"];
-var _hoisted_29 = {
+var _hoisted_27 = { class: "mech-pages__preview" };
+var _hoisted_28 = { class: "mech-pages__preview-frame" };
+var _hoisted_29 = ["src", "data-path"];
+var _hoisted_30 = {
 	key: 1,
 	class: "mech-pages__preview-empty"
 };
-var _hoisted_30 = { class: "mech-pages__preview-monogram" };
-var _hoisted_31 = {
+var _hoisted_31 = { class: "mech-pages__preview-monogram" };
+var _hoisted_32 = {
 	key: 0,
 	class: "mech-pages__preview-caption"
 };
-var _hoisted_32 = { class: "mech-pages__preview-name" };
-var _hoisted_33 = { class: "mech-pages__preview-path" };
+var _hoisted_33 = { class: "mech-pages__preview-name" };
+var _hoisted_34 = { class: "mech-pages__preview-path" };
 //#endregion
 //#region src/editor/dialogs/PagesDialog.vue
 var PagesDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__ */ defineComponent({
@@ -2035,6 +2039,13 @@ var PagesDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__
 		function onRowMenu(event, page) {
 			if (!contextMenu) return;
 			activePath.value = page.path;
+			if (page.generated) {
+				contextMenu.openAt(event, [{
+					label: "Open",
+					onClick: () => open(page)
+				}]);
+				return;
+			}
 			contextMenu.openAt(event, [
 				{
 					label: "Open",
@@ -2199,17 +2210,19 @@ var PagesDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__
 								createElementVNode("span", _hoisted_15, [
 									createElementVNode("span", _hoisted_16, toDisplayString(page.name || page.path), 1),
 									page.draft ? (openBlock(), createElementBlock("span", _hoisted_17, "Draft")) : createCommentVNode("", true),
-									page.path === currentLogical.value ? (openBlock(), createElementBlock("span", _hoisted_18, "Current")) : createCommentVNode("", true),
-									unref(localeConfig) && page.locales ? (openBlock(), createElementBlock("span", _hoisted_19, [(openBlock(true), createElementBlock(Fragment, null, renderList(unref(localeCodes), (code) => {
+									page.generated ? (openBlock(), createElementBlock("span", _hoisted_18, "Generated")) : createCommentVNode("", true),
+									page.path === currentLogical.value ? (openBlock(), createElementBlock("span", _hoisted_19, "Current")) : createCommentVNode("", true),
+									unref(localeConfig) && page.locales ? (openBlock(), createElementBlock("span", _hoisted_20, [(openBlock(true), createElementBlock(Fragment, null, renderList(unref(localeCodes), (code) => {
 										return openBlock(), createElementBlock("span", {
 											key: code,
 											class: normalizeClass(["mech-pages__loc", { "is-on": page.locales.includes(code) }]),
 											title: `${localeName(code)}: ${page.locales.includes(code) ? "translated" : "not translated"}`
-										}, toDisplayString(code), 11, _hoisted_20);
+										}, toDisplayString(code), 11, _hoisted_21);
 									}), 128))])) : createCommentVNode("", true)
 								]),
-								createElementVNode("span", _hoisted_21, toDisplayString(page.path), 1),
-								createElementVNode("span", {
+								createElementVNode("span", _hoisted_22, toDisplayString(page.path), 1),
+								!page.generated ? (openBlock(), createElementBlock("span", {
+									key: 0,
 									class: "mech-pages__actions",
 									onClick: _cache[3] || (_cache[3] = withModifiers(() => {}, ["stop"]))
 								}, [
@@ -2217,34 +2230,34 @@ var PagesDialog_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__
 										type: "button",
 										title: "Rename",
 										onClick: ($event) => startEdit(page)
-									}, [createVNode(VIcon_default, { name: "pencil" })], 8, _hoisted_22),
+									}, [createVNode(VIcon_default, { name: "pencil" })], 8, _hoisted_23),
 									createElementVNode("button", {
 										type: "button",
 										title: "Duplicate",
 										onClick: ($event) => startDuplicate(page)
-									}, [createVNode(VIcon_default, { name: "copy" })], 8, _hoisted_23),
+									}, [createVNode(VIcon_default, { name: "copy" })], 8, _hoisted_24),
 									createElementVNode("button", {
 										type: "button",
 										title: "Delete",
 										class: "is-danger",
 										onClick: ($event) => confirmRemove(page)
-									}, [createVNode(VIcon_default, { name: "trash" })], 8, _hoisted_24)
-								])
+									}, [createVNode(VIcon_default, { name: "trash" })], 8, _hoisted_25)
+								])) : createCommentVNode("", true)
 							], 42, _hoisted_14);
 						}), 128))], 64);
 					}), 128)),
-					!rows.value.length ? (openBlock(), createElementBlock("p", _hoisted_25, toDisplayString(query.value ? `No pages match “${query.value}”.` : "No pages yet."), 1)) : createCommentVNode("", true)
+					!rows.value.length ? (openBlock(), createElementBlock("p", _hoisted_26, toDisplayString(query.value ? `No pages match “${query.value}”.` : "No pages yet."), 1)) : createCommentVNode("", true)
 				], 512)])
-			]), createElementVNode("aside", _hoisted_26, [createElementVNode("div", _hoisted_27, [previewPage.value && !thumbFailed.has(previewPage.value.path) ? (openBlock(), createElementBlock("img", {
+			]), createElementVNode("aside", _hoisted_27, [createElementVNode("div", _hoisted_28, [previewPage.value && !thumbFailed.has(previewPage.value.path) ? (openBlock(), createElementBlock("img", {
 				key: previewPage.value.path,
 				src: thumbSrc(previewPage.value),
 				"data-path": previewPage.value.path,
 				alt: "",
 				onError: onThumbError
-			}, null, 40, _hoisted_28)) : (openBlock(), createElementBlock("div", _hoisted_29, [createElementVNode("span", _hoisted_30, toDisplayString(monogram.value), 1), previewPage.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [_cache[8] || (_cache[8] = createElementVNode("p", null, "No preview yet", -1)), _cache[9] || (_cache[9] = createElementVNode("code", null, "mechanica thumbs", -1))], 64)) : createCommentVNode("", true)]))]), previewPage.value ? (openBlock(), createElementBlock("div", _hoisted_31, [createElementVNode("span", _hoisted_32, toDisplayString(previewPage.value.name || previewPage.value.path), 1), createElementVNode("span", _hoisted_33, toDisplayString(previewPage.value.path), 1)])) : createCommentVNode("", true)])]);
+			}, null, 40, _hoisted_29)) : (openBlock(), createElementBlock("div", _hoisted_30, [createElementVNode("span", _hoisted_31, toDisplayString(monogram.value), 1), previewPage.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [_cache[8] || (_cache[8] = createElementVNode("p", null, "No preview yet", -1)), _cache[9] || (_cache[9] = createElementVNode("code", null, "mechanica thumbs", -1))], 64)) : createCommentVNode("", true)]))]), previewPage.value ? (openBlock(), createElementBlock("div", _hoisted_32, [createElementVNode("span", _hoisted_33, toDisplayString(previewPage.value.name || previewPage.value.path), 1), createElementVNode("span", _hoisted_34, toDisplayString(previewPage.value.path), 1)])) : createCommentVNode("", true)])]);
 		};
 	}
-}), [["__scopeId", "data-v-e750b5bb"]]);
+}), [["__scopeId", "data-v-5f70933a"]]);
 //#endregion
 //#region src/editor/components/PageBar.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$3 = { class: "mech-pagebar__icon" };

package/dist/plugin.js

@@ -1,4 +1,4 @@
-import { A as renamePage, D as pageUrlOf, E as movePage, F as translationsOf, G as wasRecentlyMutated, H as saveUpload, K as writeFileAtomic, M as setPageBlocks, N as setPageCodec, O as pageVersion, P as setPageDraft, S as fillImageMeta, T as listPages, V as saveDerivedAsset, W as markMutated, _ as createTranslation, a as toBlockMeta, b as duplicatePage, c as mergeLocaleFolderData, d as readFolderData, g as createPage, h as PageExistsError, i as composedBlockMeta, j as savePage, k as readPage, l as mergeLocaleSiteData, o as folderOf, p as readSiteData, r as buildRichTextCodec, s as mergeFolderData, t as BLOCKS_MANIFEST_FILE, u as mergeSiteData, v as deletePage, w as listFolders, x as fillContentDefaults, y as deleteTranslation, z as listImages } from "./chunks/page-assets-BjIm0jws.js";
+import { A as renamePage, D as pageUrlOf, E as movePage, F as translationsOf, G as wasRecentlyMutated, H as saveUpload, K as writeFileAtomic, M as setPageBlocks, N as setPageCodec, O as pageVersion, P as setPageDraft, S as fillImageMeta, T as listPages, V as saveDerivedAsset, W as markMutated, _ as createTranslation, a as toBlockMeta, b as duplicatePage, c as mergeLocaleFolderData, d as readFolderData, g as createPage, h as PageExistsError, i as composedBlockMeta, j as savePage, k as readPage, l as mergeLocaleSiteData, o as folderOf, p as readSiteData, r as buildRichTextCodec, s as mergeFolderData, t as BLOCKS_MANIFEST_FILE, u as mergeSiteData, v as deletePage, w as listFolders, x as fillContentDefaults, y as deleteTranslation, z as listImages } from "./chunks/page-assets-BCUAuOlo.js";
 import fs, { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, join, relative, resolve, sep } from "node:path";
 import { parseVueRequest } from "@vitejs/plugin-vue";
@@ -796,11 +796,15 @@ function generateSsrEntry(options) {
 /**
 * The dev server's {@link QuerySource}: pages come live from the `.mech`
 * store; `useFetch` URLs are fetched server-side (no CORS, matching how the
-* export resolves them at build time).
+* export resolves them at build time). `generated` pages (plugin `generatePages`)
+* are merged into the page listing so `usePages()` sees them, like the export.
 */
-function devQuerySource(mechDir) {
+function devQuerySource(mechDir, generated) {
 	return {
-		listPages: (options) => listPages(mechDir, options),
+		listPages: (options) => listPages(mechDir, {
+			...options,
+			generated
+		}),
 		fetchJson: async ({ url, ...init }) => {
 			const res = await fetch(url, init);
 			if (!res.ok) throw new Error(`${url} responded ${res.status}`);
@@ -813,8 +817,8 @@ function devQuerySource(mechDir) {
 * form `"<type>.<json-args>"` (the same encoding the runtime composables use);
 * `context.page` selects the chunk of a paginated query.
 */
-function resolveDevQuery(mechDir, key, context = {}) {
-	return resolveQueryKey(devQuerySource(mechDir), key, context);
+function resolveDevQuery(mechDir, key, context = {}, generated) {
+	return resolveQueryKey(devQuerySource(mechDir, generated), key, context);
 }
 //#endregion
 //#region src/vite/dev/page-state.ts
@@ -1082,6 +1086,15 @@ function createDevMiddleware(mechDir, options = {}) {
 			return fs.createReadStream(file).pipe(res);
 		};
 		try {
+			const gen = options.generated ? await options.generated() : null;
+			/** Reject a mutation targeting a file-less generated page. */
+			const blockGenerated = (path) => {
+				if (path && gen?.logical.has(path)) {
+					json({ error: "This page is generated and read-only" }, 409);
+					return true;
+				}
+				return false;
+			};
 			if (pathname.startsWith("/assets/")) return serveFrom("assets", "/assets/");
 			if (pathname.startsWith("/thumbs/")) {
 				res.setHeader("cache-control", "no-cache");
@@ -1095,7 +1108,7 @@ function createDevMiddleware(mechDir, options = {}) {
 				return json(await resolveDevQuery(mechDir, key, {
 					page: Number(query.get("page") ?? "") || void 0,
 					locale: variantCode(query.get("locale"))
-				}));
+				}, gen?.pages));
 			}
 			if (pathname === "/upload" && req.method === "POST") {
 				const body = await readBody(req);
@@ -1111,11 +1124,14 @@ function createDevMiddleware(mechDir, options = {}) {
 				const pathParam = query.get("path");
 				if (!pathParam) return json({ error: "Missing path" }, 400);
 				await options.ready?.();
-				const generated = (await options.generated?.())?.byServed.get(pathParam);
+				const generated = gen?.byServed.get(pathParam);
 				if (generated) return json(buildGeneratedState(mechDir, generated, config));
 				return json(buildPageState(mechDir, pathParam, config));
 			}
-			if (pathname === "/pages" && req.method === "GET") return json(listPages(mechDir, config ? { locales: config } : {}));
+			if (pathname === "/pages" && req.method === "GET") return json(listPages(mechDir, {
+				...config ? { locales: config } : {},
+				generated: gen?.pages
+			}));
 			if (pathname === "/blocks" && req.method === "GET") {
 				if (!options.blocks) return json({ error: "Block listing unavailable" }, 503);
 				return json(await options.blocks());
@@ -1123,11 +1139,13 @@ function createDevMiddleware(mechDir, options = {}) {
 			if (pathname === "/pages" && req.method === "DELETE") {
 				const pathParam = query.get("path");
 				if (!pathParam) return json({ error: "Missing path" }, 400);
+				if (blockGenerated(pathParam)) return;
 				return json({ success: deletePage(mechDir, pathParam) });
 			}
 			if (pathname === "/pages/draft" && req.method === "POST") {
 				const pathParam = query.get("path");
 				if (!pathParam) return json({ error: "Missing path" }, 400);
+				if (blockGenerated(pathParam)) return;
 				const body = JSON.parse((await readBody(req)).toString("utf-8"));
 				setPageDraft(mechDir, pathParam, body.draft === true, variantCode(query.get("locale")));
 				return json({
@@ -1139,6 +1157,7 @@ function createDevMiddleware(mechDir, options = {}) {
 				const pathParam = query.get("path");
 				const locale = query.get("locale");
 				if (!pathParam || !locale) return json({ error: "Missing path or locale" }, 400);
+				if (blockGenerated(pathParam)) return;
 				if (!config || locale === config.default || !config.all.includes(locale)) return json({ error: "Unknown locale" }, 400);
 				try {
 					createTranslation(mechDir, pathParam, locale);
@@ -1152,11 +1171,13 @@ function createDevMiddleware(mechDir, options = {}) {
 				const pathParam = query.get("path");
 				const locale = query.get("locale");
 				if (!pathParam || !locale) return json({ error: "Missing path or locale" }, 400);
+				if (blockGenerated(pathParam)) return;
 				return json({ success: deleteTranslation(mechDir, pathParam, locale) });
 			}
 			if (pathname === "/pages/duplicate" && req.method === "POST") {
 				const pathParam = query.get("path");
 				if (!pathParam) return json({ error: "Missing path" }, 400);
+				if (blockGenerated(pathParam)) return;
 				const body = JSON.parse((await readBody(req)).toString("utf-8"));
 				if (!body.path || !body.name) return json({ error: "path and name are required" }, 400);
 				try {
@@ -1169,16 +1190,19 @@ function createDevMiddleware(mechDir, options = {}) {
 			if (pathname === "/pages" && req.method === "POST") {
 				const body = JSON.parse((await readBody(req)).toString("utf-8"));
 				const pathParam = query.get("path");
-				if (pathParam) try {
-					const path = typeof body.path === "string" && body.path.trim() && body.path.trim() !== pathParam ? movePage(mechDir, pathParam, body.path).path : pathParam;
-					if (body.name) renamePage(mechDir, path, body.name);
-					return json({
-						success: true,
-						path
-					});
-				} catch (error) {
-					if (error instanceof PageExistsError) return json({ error: { path: "Page already exists" } }, 400);
-					throw error;
+				if (pathParam) {
+					if (blockGenerated(pathParam)) return;
+					try {
+						const path = typeof body.path === "string" && body.path.trim() && body.path.trim() !== pathParam ? movePage(mechDir, pathParam, body.path).path : pathParam;
+						if (body.name) renamePage(mechDir, path, body.name);
+						return json({
+							success: true,
+							path
+						});
+					} catch (error) {
+						if (error instanceof PageExistsError) return json({ error: { path: "Page already exists" } }, 400);
+						throw error;
+					}
 				}
 				if (!body.path || !body.name) return json({ error: "path and name are required" }, 400);
 				if (config) {
@@ -1195,7 +1219,7 @@ function createDevMiddleware(mechDir, options = {}) {
 			if (pathname === "/save" && req.method === "POST") {
 				const pathParam = query.get("path");
 				if (!pathParam) return json({ error: "Missing path" }, 400);
-				if ((await options.generated?.())?.logical.has(pathParam)) return json({ error: "This page is generated and read-only" }, 409);
+				if (blockGenerated(pathParam)) return;
 				const locale = variantCode(query.get("locale"));
 				const body = JSON.parse((await readBody(req)).toString("utf-8"));
 				if (!body.force && typeof body.version === "string") {
@@ -1473,6 +1497,7 @@ function mechanica(options = {}) {
 				logical.add(page.path);
 			}
 			return {
+				pages,
 				byServed,
 				logical
 			};

package/dist/types/editor/lib/page-list.d.ts

@@ -10,6 +10,8 @@ export interface PageItem {
      * sites — for the language coverage badges. Absent when i18n is off.
      */
     locales?: string[];
+    /** A programmatically generated page (plugin `generatePages`) — read-only, no file. */
+    generated?: boolean;
 }
 /**
  * Fetch the project's pages from the dev server, memoized for the session so

package/dist/types/vite/dev/middleware.d.ts

@@ -14,11 +14,13 @@ export interface DevMiddlewareOptions {
     /** The site's locale config (multi-language sites); null/absent = i18n off. */
     locales?: LocalesConfig | null;
     /**
-     * Generated routes (plugin `generatePages`): a served-path → page map (for
-     * `/state`) and the set of their logical paths (for the read-only `/save`
-     * guard). Absent when no providers are configured.
+     * Generated routes (plugin `generatePages`): the baked page list (for the
+     * `/pages` + `/query` listings), a served-path → page map (for `/state`), and
+     * the set of their logical paths (for the read-only mutation guards). Absent
+     * when no providers are configured.
      */
     generated?: () => Promise<{
+        pages: VirtualPage[];
         byServed: Map<string, VirtualPage>;
         logical: Set<string>;
     }>;

package/dist/types/vite/dev/pages-store.d.ts

@@ -1,4 +1,4 @@
-import { type Block, type ContentBlock, type LocalesConfig } from 'mechanica-shared';
+import { type Block, type ContentBlock, type LocalesConfig, type VirtualPage } from 'mechanica-shared';
 import { type PageDoc, type RichTextCodec } from 'mechanica-shared/page-format';
 /** Shape of a page file under `<mech>/pages` (the parsed `.page.md` document). */
 export type PageFile = PageDoc;
@@ -49,6 +49,12 @@ export interface PageListItem {
      * i18n is off. Translation files never get their own list row.
      */
     locales?: string[];
+    /**
+     * True for a programmatically generated page ({@link VirtualPage} from the
+     * plugin's `generatePages`): it has no file, so the editor lists it read-only
+     * (no rename / duplicate / delete / translate).
+     */
+    generated?: boolean;
     [key: string]: unknown;
 }
 /** Thrown by {@link createPage} when the target page already exists. */
@@ -150,4 +156,5 @@ export declare function listPages(mechDir: string, options?: {
     }[];
     locales?: LocalesConfig;
     locale?: string;
+    generated?: VirtualPage[];
 }): PageListItem[];

package/dist/types/vite/dev/query-dev.d.ts

@@ -1,13 +1,14 @@
-import { type QueryContext, type QuerySource } from 'mechanica-shared';
+import { type QueryContext, type QuerySource, type VirtualPage } from 'mechanica-shared';
 /**
  * The dev server's {@link QuerySource}: pages come live from the `.mech`
  * store; `useFetch` URLs are fetched server-side (no CORS, matching how the
- * export resolves them at build time).
+ * export resolves them at build time). `generated` pages (plugin `generatePages`)
+ * are merged into the page listing so `usePages()` sees them, like the export.
  */
-export declare function devQuerySource(mechDir: string): QuerySource;
+export declare function devQuerySource(mechDir: string, generated?: VirtualPage[]): QuerySource;
 /**
  * Resolve a dev-mode query key against the local `.mech` store. Keys are of the
  * form `"<type>.<json-args>"` (the same encoding the runtime composables use);
  * `context.page` selects the chunk of a paginated query.
  */
-export declare function resolveDevQuery(mechDir: string, key: string, context?: QueryContext): Promise<unknown>;
+export declare function resolveDevQuery(mechDir: string, key: string, context?: QueryContext, generated?: VirtualPage[]): Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mechanica",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.0-alpha.8",
   "description": "Build Vue 3 websites with a visual block editor",
   "license": "MIT",
   "repository": {
@@ -63,7 +63,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "mechanica-shared": "2.0.0-alpha.4",
+    "mechanica-shared": "2.0.0-alpha.8",
     "@vue/compiler-sfc": "^3.5.38",
     "compact-json-schema": "^0.1.5",
     "estree-walker": "^3.0.3",

package/src/cli/export.ts

@@ -474,7 +474,7 @@ export async function exportProject(
   // installed so page data read by `listPages` matches what pages render with.
   setPageCodec(richText)
   const querySource: QuerySource = {
-    listPages: (opts) => listPages(join(cwd, '.mech'), opts),
+    listPages: (opts) => listPages(join(cwd, '.mech'), { ...opts, generated: ssr.generatedPages }),
     fetchJson: async ({ url, ...init }) => {
       const res = await fetch(url, init as RequestInit)
       if (!res.ok) throw new Error(`${url} responded ${res.status}`)

package/src/editor/dialogs/PagesDialog.vue

@@ -83,6 +83,7 @@
               <span class="mech-pages__cell-name">
                 <span class="mech-pages__name">{{ page.name || page.path }}</span>
                 <span v-if="page.draft" class="mech-pages__badge is-draft">Draft</span>
+                <span v-if="page.generated" class="mech-pages__badge">Generated</span>
                 <span v-if="page.path === currentLogical" class="mech-pages__badge">Current</span>
                 <span v-if="localeConfig && page.locales" class="mech-pages__locales">
                   <span
@@ -96,7 +97,8 @@
                 </span>
               </span>
               <span class="mech-pages__cell-path">{{ page.path }}</span>
-              <span class="mech-pages__actions" @click.stop>
+              <!-- Generated pages have no file — they're read-only (no edit actions). -->
+              <span v-if="!page.generated" class="mech-pages__actions" @click.stop>
                 <button type="button" title="Rename" @click="startEdit(page)"><VIcon name="pencil" /></button>
                 <button type="button" title="Duplicate" @click="startDuplicate(page)"><VIcon name="copy" /></button>
                 <button type="button" title="Delete" class="is-danger" @click="confirmRemove(page)">
@@ -275,6 +277,11 @@ const open = (page: PageItem) => openPath(page.path)
 function onRowMenu(event: MouseEvent, page: PageItem) {
   if (!contextMenu) return
   activePath.value = page.path
+  // Generated pages have no file — offer only "Open" (read-only view).
+  if (page.generated) {
+    contextMenu.openAt(event, [{ label: 'Open', onClick: () => open(page) }])
+    return
+  }
   contextMenu.openAt(event, [
     { label: 'Open', onClick: () => open(page) },
     { label: 'Rename', onClick: () => startEdit(page) },

package/src/editor/lib/page-list.ts

@@ -10,6 +10,8 @@ export interface PageItem {
    * sites — for the language coverage badges. Absent when i18n is off.
    */
   locales?: string[]
+  /** A programmatically generated page (plugin `generatePages`) — read-only, no file. */
+  generated?: boolean
 }
 
 let pagesPromise: Promise<PageItem[]> | null = null

package/src/vite/dev/middleware.ts

@@ -53,11 +53,12 @@ export interface DevMiddlewareOptions {
   /** The site's locale config (multi-language sites); null/absent = i18n off. */
   locales?: LocalesConfig | null
   /**
-   * Generated routes (plugin `generatePages`): a served-path → page map (for
-   * `/state`) and the set of their logical paths (for the read-only `/save`
-   * guard). Absent when no providers are configured.
+   * Generated routes (plugin `generatePages`): the baked page list (for the
+   * `/pages` + `/query` listings), a served-path → page map (for `/state`), and
+   * the set of their logical paths (for the read-only mutation guards). Absent
+   * when no providers are configured.
    */
-  generated?: () => Promise<{ byServed: Map<string, VirtualPage>; logical: Set<string> }>
+  generated?: () => Promise<{ pages: VirtualPage[]; byServed: Map<string, VirtualPage>; logical: Set<string> }>
 }
 
 /**
@@ -105,6 +106,18 @@ export function createDevMiddleware(
     }
 
     try {
+      // Generated pages (plugin `generatePages`), resolved once (cached
+      // upstream): used to serve their state, list them, and reject writes.
+      const gen = options.generated ? await options.generated() : null
+      /** Reject a mutation targeting a file-less generated page. */
+      const blockGenerated = (path: string | null): boolean => {
+        if (path && gen?.logical.has(path)) {
+          json({ error: 'This page is generated and read-only' }, 409)
+          return true
+        }
+        return false
+      }
+
       if (pathname.startsWith('/assets/')) return serveFrom('assets', '/assets/')
       if (pathname.startsWith('/thumbs/')) {
         // Regenerated in place by `mechanica thumbs` — always revalidate.
@@ -121,7 +134,9 @@ export function createDevMiddleware(
         // `page` selects the chunk of a paginated query (variant URLs like /blog/2);
         // `locale` scopes a `getPages` listing to a translation.
         const page = Number(query.get('page') ?? '') || undefined
-        return json(await resolveDevQuery(mechDir, key, { page, locale: variantCode(query.get('locale')) }))
+        return json(
+          await resolveDevQuery(mechDir, key, { page, locale: variantCode(query.get('locale')) }, gen?.pages),
+        )
       }
 
       if (pathname === '/upload' && req.method === 'POST') {
@@ -144,13 +159,13 @@ export function createDevMiddleware(
         const pathParam = query.get('path')
         if (!pathParam) return json({ error: 'Missing path' }, 400)
         await options.ready?.()
-        const generated = (await options.generated?.())?.byServed.get(pathParam)
+        const generated = gen?.byServed.get(pathParam)
         if (generated) return json(buildGeneratedState(mechDir, generated, config))
         return json(buildPageState(mechDir, pathParam, config))
       }
 
       if (pathname === '/pages' && req.method === 'GET') {
-        return json(listPages(mechDir, config ? { locales: config } : {}))
+        return json(listPages(mechDir, { ...(config ? { locales: config } : {}), generated: gen?.pages }))
       }
 
       if (pathname === '/blocks' && req.method === 'GET') {
@@ -161,12 +176,14 @@ export function createDevMiddleware(
       if (pathname === '/pages' && req.method === 'DELETE') {
         const pathParam = query.get('path')
         if (!pathParam) return json({ error: 'Missing path' }, 400)
+        if (blockGenerated(pathParam)) return
         return json({ success: deletePage(mechDir, pathParam) })
       }
 
       if (pathname === '/pages/draft' && req.method === 'POST') {
         const pathParam = query.get('path')
         if (!pathParam) return json({ error: 'Missing path' }, 400)
+        if (blockGenerated(pathParam)) return
         const body = JSON.parse((await readBody(req)).toString('utf-8'))
         setPageDraft(mechDir, pathParam, body.draft === true, variantCode(query.get('locale')))
         return json({ success: true, draft: body.draft === true })
@@ -178,6 +195,7 @@ export function createDevMiddleware(
         const pathParam = query.get('path')
         const locale = query.get('locale')
         if (!pathParam || !locale) return json({ error: 'Missing path or locale' }, 400)
+        if (blockGenerated(pathParam)) return
         if (!config || locale === config.default || !config.all.includes(locale)) {
           return json({ error: 'Unknown locale' }, 400)
         }
@@ -194,12 +212,14 @@ export function createDevMiddleware(
         const pathParam = query.get('path')
         const locale = query.get('locale')
         if (!pathParam || !locale) return json({ error: 'Missing path or locale' }, 400)
+        if (blockGenerated(pathParam)) return
         return json({ success: deleteTranslation(mechDir, pathParam, locale) })
       }
 
       if (pathname === '/pages/duplicate' && req.method === 'POST') {
         const pathParam = query.get('path')
         if (!pathParam) return json({ error: 'Missing path' }, 400)
+        if (blockGenerated(pathParam)) return
         const body = JSON.parse((await readBody(req)).toString('utf-8'))
         if (!body.path || !body.name) return json({ error: 'path and name are required' }, 400)
         try {
@@ -214,6 +234,7 @@ export function createDevMiddleware(
         const body = JSON.parse((await readBody(req)).toString('utf-8'))
         const pathParam = query.get('path')
         if (pathParam) {
+          if (blockGenerated(pathParam)) return
           // Editing an existing page: optionally move it (new path) and/or rename it.
           try {
             const wantsMove = typeof body.path === 'string' && body.path.trim() && body.path.trim() !== pathParam
@@ -248,9 +269,7 @@ export function createDevMiddleware(
         if (!pathParam) return json({ error: 'Missing path' }, 400)
         // Generated pages (plugin `generatePages`) have no file — reject a save
         // rather than writing a stray `.page.md` at their path.
-        if ((await options.generated?.())?.logical.has(pathParam)) {
-          return json({ error: 'This page is generated and read-only' }, 409)
-        }
+        if (blockGenerated(pathParam)) return
         // A non-default `locale` writes to that translation's variant file; the
         // default locale (or i18n off) writes the base page.
         const locale = variantCode(query.get('locale'))

package/src/vite/dev/pages-store.ts

@@ -9,6 +9,7 @@ import {
   type Block,
   type ContentBlock,
   type LocalesConfig,
+  type VirtualPage,
 } from 'mechanica-shared'
 import { parsePage, serializePage, type PageDoc, type RichTextCodec } from 'mechanica-shared/page-format'
 import { applyImageManifest, harvestImageMeta, readImageManifest, updateImageManifest } from './assets-store'
@@ -128,6 +129,12 @@ export interface PageListItem {
    * i18n is off. Translation files never get their own list row.
    */
   locales?: string[]
+  /**
+   * True for a programmatically generated page ({@link VirtualPage} from the
+   * plugin's `generatePages`): it has no file, so the editor lists it read-only
+   * (no rename / duplicate / delete / translate).
+   */
+  generated?: boolean
   [key: string]: unknown
 }
 
@@ -451,7 +458,7 @@ export function listFolders(mechDir: string): { id: string; path: string; name:
  */
 export function listPages(
   mechDir: string,
-  options: { data?: { id: string }[]; locales?: LocalesConfig; locale?: string } = {},
+  options: { data?: { id: string }[]; locales?: LocalesConfig; locale?: string; generated?: VirtualPage[] } = {},
 ): PageListItem[] {
   const pagesDir = join(mechDir, 'pages')
   if (!fs.existsSync(pagesDir)) return []
@@ -509,9 +516,57 @@ export function listPages(
     items.push(item)
   }
 
+  // Programmatically generated pages (plugin `generatePages`) join the listing —
+  // one read-only row per logical path — so they show in the editor's page
+  // browser, resolve in `usePages()` queries, and pass `mechanica shot`'s
+  // page-exists check, just like file pages.
+  if (options.generated?.length) items.push(...generatedPageItems(options.generated, options, config))
+
   return items.sort(comparePages)
 }
 
+/** File-less pages → list rows: one per logical path, with a `locales` union. */
+function generatedPageItems(
+  generated: VirtualPage[],
+  options: { data?: { id: string }[]; locale?: string },
+  config: LocalesConfig | null,
+): PageListItem[] {
+  const groups = new Map<string, VirtualPage[]>()
+  for (const vp of generated) {
+    const arr = groups.get(vp.path)
+    if (arr) arr.push(vp)
+    else groups.set(vp.path, [vp])
+  }
+
+  const items: PageListItem[] = []
+  for (const [path, vps] of groups) {
+    const locales = config ? (vps.map((v) => v.locale).filter(Boolean) as string[]) : []
+    // Locale-scoped listing (a translated query): skip a page absent in it.
+    if (options.locale && !locales.includes(options.locale)) continue
+    const source =
+      (options.locale ? vps.find((v) => v.locale === options.locale) : undefined) ??
+      (config ? vps.find((v) => v.locale === config.default) : undefined) ??
+      vps[0]!
+    const embedded: Record<string, unknown> = {}
+    for (const dataEntry of options.data ?? []) embedded[dataEntry.id] = source.data?.[dataEntry.id] ?? {}
+
+    const dir = path.slice(1).split('/').slice(0, -1).join('/')
+    const item: PageListItem = {
+      path,
+      name: (typeof source.meta?.title === 'string' ? source.meta.title : undefined) ?? path.split('/').pop() ?? path,
+      folderPath: dir === '' ? null : dir,
+      order: 0,
+      orderAfter: null,
+      draft: false,
+      generated: true,
+      ...embedded,
+    }
+    if (config) item.locales = config.all.filter((code) => locales.includes(code))
+    items.push(item)
+  }
+  return items
+}
+
 /** Ordering: by folder, then explicit `orderAfter`, then `order`, then path. */
 function comparePages(a: PageListItem, b: PageListItem): number {
   if (a.folderPath === b.folderPath) {

package/src/vite/dev/query-dev.ts

@@ -1,14 +1,15 @@
-import { resolveQueryKey, type QueryContext, type QuerySource } from 'mechanica-shared'
+import { resolveQueryKey, type QueryContext, type QuerySource, type VirtualPage } from 'mechanica-shared'
 import { listPages } from './pages-store'
 
 /**
  * The dev server's {@link QuerySource}: pages come live from the `.mech`
  * store; `useFetch` URLs are fetched server-side (no CORS, matching how the
- * export resolves them at build time).
+ * export resolves them at build time). `generated` pages (plugin `generatePages`)
+ * are merged into the page listing so `usePages()` sees them, like the export.
  */
-export function devQuerySource(mechDir: string): QuerySource {
+export function devQuerySource(mechDir: string, generated?: VirtualPage[]): QuerySource {
   return {
-    listPages: (options) => listPages(mechDir, options),
+    listPages: (options) => listPages(mechDir, { ...options, generated }),
     fetchJson: async ({ url, ...init }) => {
       const res = await fetch(url, init as RequestInit)
       if (!res.ok) throw new Error(`${url} responded ${res.status}`)
@@ -22,6 +23,11 @@ export function devQuerySource(mechDir: string): QuerySource {
  * form `"<type>.<json-args>"` (the same encoding the runtime composables use);
  * `context.page` selects the chunk of a paginated query.
  */
-export function resolveDevQuery(mechDir: string, key: string, context: QueryContext = {}): Promise<unknown> {
-  return resolveQueryKey(devQuerySource(mechDir), key, context)
+export function resolveDevQuery(
+  mechDir: string,
+  key: string,
+  context: QueryContext = {},
+  generated?: VirtualPage[],
+): Promise<unknown> {
+  return resolveQueryKey(devQuerySource(mechDir, generated), key, context)
 }

package/src/vite/plugin.ts

@@ -165,8 +165,13 @@ export function mechanica(options: MechanicaPluginOptions = {}): Plugin {
     }
     return generatedPagesCache
   }
-  let generatedIndexCache: Promise<{ byServed: Map<string, VirtualPage>; logical: Set<string> }> | null = null
-  const loadGeneratedIndex = (): Promise<{ byServed: Map<string, VirtualPage>; logical: Set<string> }> => {
+  interface GeneratedIndex {
+    pages: VirtualPage[]
+    byServed: Map<string, VirtualPage>
+    logical: Set<string>
+  }
+  let generatedIndexCache: Promise<GeneratedIndex> | null = null
+  const loadGeneratedIndex = (): Promise<GeneratedIndex> => {
     if (!generatedIndexCache) {
       generatedIndexCache = loadGeneratedPages().then((pages) => {
         const byServed = new Map<string, VirtualPage>()
@@ -175,7 +180,7 @@ export function mechanica(options: MechanicaPluginOptions = {}): Plugin {
           byServed.set(generatedServedPath(page, locales), page)
           logical.add(page.path)
         }
-        return { byServed, logical }
+        return { pages, byServed, logical }
       })
     }
     return generatedIndexCache