@marvalt/digivalt-core 0.2.29 → 0.2.32

package/docs/SHORTCODES.md

@@ -0,0 +1,39 @@
+# WordPress shortcodes — `@marvalt/digivalt-core`
+
+After install: `node_modules/@marvalt/digivalt-core/docs/SHORTCODES.md`.
+
+The same list lives at the package root as `GLOBAL-SHORTCODES.md`.
+
+Content editors type shortcodes into WordPress. `@marvalt/wparser` finds `[name attr="value"]` in block HTML. `createContentRegistry()` from `@marvalt/digivalt-core/registry` maps package-supported names to React components. `digivalt-init` does not copy a registry file.
+
+**Do not register these as WordPress PHP shortcodes.** They must stay literal in REST content.
+
+## What the app already merges
+
+| Shortcode | Package | Notes |
+|-----------|---------|--------|
+| `[mautic_form id="1"]` | `@marvalt/madapter` `getMauticShortcodeHandlers()` | Optional `title`, `description`. See `node_modules/@marvalt/madapter/docs/SHORTCODES.md`. |
+| `[phplist_subscribe list="1" attrs="firstname,lastname"]` | `@marvalt/plister` `getPhplistShortcodeHandlers()` | Visible fields only. Optional `page`, `title`, `intro`. See `node_modules/@marvalt/plister/docs/SHORTCODES.md`. |
+| `[gf_embed id="1"]` / `[gform …]` | core | Gravity Forms inline. |
+| `[popupbtn_gf …]` / `[popupbtn_mautic …]` | core | Package-local popup controls. |
+
+Full attribute list: package root [GLOBAL-SHORTCODES.md](../GLOBAL-SHORTCODES.md).
+
+## If shortcodes stay as raw text
+
+1. The shortcode is not in `registry.shortcodes` — use `createContentRegistry()` or merge the required custom handler.
+2. Someone registered a PHP shortcode in WordPress — undo that so the token remains in the API response.
+3. Mautic/PHPList JSON was not generated, or `QueryClientProvider` is missing.
+
+## Standalone custom registry
+
+```tsx
+import { getMauticShortcodeHandlers } from '@marvalt/madapter';
+import { getPhplistShortcodeHandlers } from '@marvalt/plister';
+
+Object.assign(
+  registry.shortcodes,
+  getMauticShortcodeHandlers(),
+  getPhplistShortcodeHandlers()
+);
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marvalt/digivalt-core",
-  "version": "0.2.29",
+  "version": "0.2.32",
   "description": "Core glue logic and shared context for DigiVAlt frontend applications",
   "license": "GPL-3.0-or-later",
   "main": "dist/index.cjs",
@@ -42,6 +42,11 @@
       "import": "./dist/seo.esm.js",
       "require": "./dist/seo.cjs"
     },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.esm.js",
+      "require": "./dist/registry.cjs"
+    },
     "./integrations": {
       "types": "./dist/integrations.d.ts",
       "import": "./dist/integrations.esm.js",
@@ -62,6 +67,7 @@
     "README.md",
     "LICENSE",
     "CHANGELOG.md",
+    "GLOBAL-SHORTCODES.md",
     "bin",
     "template"
   ],
@@ -100,24 +106,30 @@
     "typescript": "^5.5.3"
   },
   "peerDependencies": {
+    "@tanstack/react-query": ">=5",
     "react": ">=18",
     "react-dom": ">=18",
     "react-helmet-async": ">=2"
   },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18.0.0",
     "npm": ">=8.0.0"
   },
   "dependencies": {
     "@digivalt/tracker": "^0.1.1",
-    "@marvalt/dstyler": "^0.1.51",
-    "@marvalt/madapter": "^2.3.7",
-    "@marvalt/plister": "^0.2.0",
-    "@marvalt/sadapter": "^0.1.5",
-    "@marvalt/shcoder": "^0.1.35",
-    "@marvalt/tadapter": "^1.0.12",
+    "@marvalt/dstyler": "^0.1.53",
+    "@marvalt/madapter": "^2.3.11",
+    "@marvalt/plister": "^0.3.0",
+    "@marvalt/sadapter": "^0.1.6",
+    "@marvalt/shcoder": "^0.1.37",
+    "@marvalt/tadapter": "^1.0.14",
     "@marvalt/wadapter": "^2.3.61",
-    "@marvalt/wparser": "^0.1.79",
+    "@marvalt/wparser": "^0.1.82",
     "@radix-ui/react-toast": "^1.2.15",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

package/template/DIGIVALT_SETUP.md

@@ -2,9 +2,9 @@
 
 Welcome to your new **DigiVAlt** architecture project!
 
-Because your Lovable interface is completely decoupled from the data pipeline, the `@marvalt/digivalt-core` package securely builds the glue between your frontend and your Cloudflare Worker backend.
+Your Vite interface is decoupled from the data pipeline. `@marvalt/digivalt-core` supplies static generation and runtime helpers for your Cloudflare Pages app.
 
-Follow these instructions strictly to hydrate a brand new Lovable project with real data.
+Follow these instructions to hydrate a new Vite project with real data.
 
 ---
 
@@ -17,7 +17,7 @@ npm install -D vite-node
 ```
 
 ## 🛠️ 2. Wire the Build Scripts
-`digivalt-init` now preflights your app and patches safe script cases automatically. In a standard Lovable/Vite app, it should add or update the DigiVAlt build wiring for you.
+`digivalt-init` preflights your app and patches safe script cases automatically. In a standard Vite app, it should add or update the DigiValt build wiring for you.
 
 Still verify your `package.json` after running init. The expected result is:
 
@@ -58,7 +58,7 @@ VITE_GRAVITY_FORMS_SECRET="your_cs_secret"
 # Local Execution Mode (Set to "direct" internally so your local UI bypasses Cloudflare)
 VITE_AUTH_MODE="direct"
 ```
-*⚠️ **CRITICAL WARNING:** NEVER place `VITE_IS_LOVABLE=true` inside `.env.local` locally! That variable instructs the application to mute API traffic completely, pretending the data does not exist.*
+*⚠️ **CRITICAL WARNING:** Never enable fixture mode (`VITE_IS_LOVABLE=true`) in `.env.local` when you need live generation. The backwards-compatible flag skips API traffic and uses committed data.*
 
 ## 🌩️ 5. Deploy Infrastructure to Cloudflare
 Once you connect this GitHub repository to the Cloudflare Pages dashboard:
@@ -77,15 +77,21 @@ Init will:
 - refresh older DigiVAlt-managed `scripts/generate.ts` files
 - reconcile the DigiValt-managed sections inside `.env.example` and `.env.local.example`
 - warn instead of overwriting custom build logic or custom generator scripts
-- report stale legacy workarounds that may no longer be needed
+- report stale legacy workarounds and local registry files that may no longer be needed
+
+## App chrome and WordPress page bodies
+
+Use `DigiValtProviders`, `DigiValtWpPage`, and `createContentRegistry` from `@marvalt/digivalt-core/registry`. Read static chrome content with `getAppChrome()` from `@marvalt/digivalt-core/static`.
+
+> Build Header/Footer in the app. Read menus, logo, and copy from WordPress static data (`getAppChrome()`). Apply the app’s layout and Tailwind. Do not render the WordPress header/footer template part and do not pipe `footer.blocks` / `header.blocks` through wparser.
 
 ## 7. SEO and PageSpeed (optional)
 
 1. Install **`react-helmet-async`** and wrap your app with **`HelmetProvider`** at the root (next to the router).
 2. Set at least **`VITE_SEO_SITE_URL`** (no trailing slash), **`VITE_SEO_SITE_NAME`**, **`VITE_SEO_DEFAULT_TITLE`**, **`VITE_SEO_DEFAULT_DESCRIPTION`**, and **`VITE_SEO_DEFAULT_OG_IMAGE`** in Cloudflare Pages / `.env.local`.
-3. Import **`DigiValtSeoHead`** and **`JsonLd`** from **`@marvalt/digivalt-core/seo`** in your layouts or page components; pass **`pathname`** per route for correct canonical URLs.
-4. **Sitemap:** **`/sitemap.xml`** is served by **`functions/sitemap.xml.ts`**. **`public/sitemap-paths.json`** is **generated** when you run **`npm run build`** (or `generate`): it merges (a) **`public/sitemap-static-paths.json`** — edit this for Lovable/SPA-only routes, (b) URLs from **`navigation_menu`** in **`wordpress-data.json`**, (c) **`link`** pathnames from CPT/post arrays listed under **`config.post_types`**. Only CMS links whose host matches **`VITE_WORDPRESS_API_URL`** / **`WORDPRESS_API_URL`** are included. Canonical `<loc>` values use **`VITE_SEO_SITE_URL`** (or **`SITE_URL`**). Do not add **`public/sitemap.xml`** (it would shadow the Function). With **`VITE_IS_LOVABLE=true`**, static fetch is skipped but sitemap paths are still regenerated from committed JSON.
-5. Read the full guide shipped with the package: **`node_modules/@marvalt/digivalt-core/docs/SEO-PERFORMANCE.md`** (or in the repo: `digivalt-npm-packages/digivalt-core/docs/SEO-PERFORMANCE.md`).
+3. Import **`DigiValtRouteSeo`** (or **`DigiValtSeoHead`** / **`JsonLd`**) from **`@marvalt/digivalt-core/seo`**; pass **`pathname`** per route.
+4. **Sitemap / robots / prerender:** **`/sitemap.xml`** and **`/robots.txt`** are Pages Functions. **`public/sitemap-paths.json`** and **`seo-manifest.json`** are generated on `generate` / `build`. After `vite build`, run **`scripts/prerender-seo.ts`**. Edit **`public/sitemap-static-paths.json`** for app-only indexable routes. Do not add **`public/sitemap.xml`** or **`public/robots.txt`**. Per-URL meta lives in the **DigiValt SEO** WordPress plugin; site identity stays in **`VITE_SEO_*`**. Optional **`VITE_SEO_ROUTE_PREFIXES`** maps CPT REST slugs to app path prefixes. See **`docs/SEO-PERFORMANCE.md`**.
+5. Read the full guide shipped with the package: **`node_modules/@marvalt/digivalt-core/docs/SEO-PERFORMANCE.md`**.
 
 ## 8. Analytics (Google Analytics / Matomo)
 

package/template/functions/robots.txt.ts

@@ -0,0 +1,27 @@
+/**
+ * Serves /robots.txt with a Sitemap directive using VITE_SEO_SITE_URL when set.
+ */
+
+function normalizeBase(raw: string | undefined): string | null {
+  if (!raw || typeof raw !== 'string') return null;
+  const t = raw.trim().replace(/\/+$/, '');
+  return t || null;
+}
+
+export async function onRequestGet(context: { request: Request; env: Record<string, string | undefined> }) {
+  const { request, env } = context;
+  const fromEnv = normalizeBase(env.VITE_SEO_SITE_URL || env.SITE_URL);
+  const origin = new URL(request.url).origin.replace(/\/+$/, '');
+  const base = fromEnv || origin;
+  const body = `User-agent: *
+Allow: /
+
+Sitemap: ${base}/sitemap.xml
+`;
+  return new Response(body, {
+    headers: {
+      'Content-Type': 'text/plain; charset=utf-8',
+      'Cache-Control': 'public, max-age=300',
+    },
+  });
+}

package/template/functions/sitemap.xml.ts

@@ -1,65 +1,143 @@
-/**
- * Serves /sitemap.xml from canonical site URL + public/sitemap-paths.json (generated at build).
- * Set VITE_SEO_SITE_URL (or SITE_URL) on Cloudflare Pages for production canonical hosts.
- */
-
-function normalizeBase(raw: string | undefined): string | null {
-  if (!raw || typeof raw !== 'string') return null;
-  const t = raw.trim().replace(/\/+$/, '');
-  return t || null;
-}
-
-function escapeXml(s: string): string {
-  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
-}
-
-async function loadPaths(request: Request): Promise<string[]> {
-  try {
-    const jsonUrl = new URL('/sitemap-paths.json', request.url);
-    const res = await fetch(jsonUrl.toString());
-    if (!res.ok) return ['/'];
-    const data: unknown = await res.json();
-    const list: string[] = [];
-    if (Array.isArray(data)) {
-      for (const p of data) {
-        if (typeof p === 'string' && p.startsWith('/')) list.push(p);
-      }
-    } else if (data && typeof data === 'object' && Array.isArray((data as { paths?: unknown }).paths)) {
-      for (const p of (data as { paths: unknown[] }).paths) {
-        if (typeof p === 'string' && p.startsWith('/')) list.push(p);
-      }
-    }
-    return list.length ? list : ['/'];
-  } catch {
-    return ['/'];
-  }
-}
-
-function buildSitemap(base: string, paths: string[]): string {
-  const lines = paths.map((p) => {
-    const loc = p === '/' ? base : `${base}${p.startsWith('/') ? p : `/${p}`}`;
-    return `  <url><loc>${escapeXml(loc)}</loc></url>`;
-  });
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${lines.join('\n')}
-</urlset>`;
-}
-
-export async function onRequestGet(context: { request: Request; env: Record<string, string | undefined> }) {
-  const { request, env } = context;
-  const fromEnv = normalizeBase(env.VITE_SEO_SITE_URL || env.SITE_URL);
-  const origin = new URL(request.url).origin.replace(/\/+$/, '');
-  const base = fromEnv || origin;
-
-  const rawPaths = await loadPaths(request);
-  const paths = [...new Set(rawPaths.length ? rawPaths : ['/'])];
-
-  const xml = buildSitemap(base, paths);
-  return new Response(xml, {
-    headers: {
-      'Content-Type': 'application/xml; charset=utf-8',
-      'Cache-Control': 'public, max-age=300',
-    },
-  });
-}
+/**
+ * Serves /sitemap.xml from canonical site URL + public/sitemap-paths.json (generated at build).
+ * Set VITE_SEO_SITE_URL (or SITE_URL) on Cloudflare Pages for production canonical hosts.
+ */
+
+const IMAGE_NS = 'http://www.google.com/schemas/sitemap-image/1.1';
+
+function normalizeBase(raw: string | undefined): string | null {
+  if (!raw || typeof raw !== 'string') return null;
+  const t = raw.trim().replace(/\/+$/, '');
+  return t || null;
+}
+
+function escapeXml(s: string): string {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+
+type SitemapUrl = { path: string; lastmod?: string; image?: string };
+
+function asUrls(data: unknown): SitemapUrl[] {
+  if (!data || typeof data !== 'object') return [];
+  const rec = data as { urls?: unknown; paths?: unknown };
+  if (Array.isArray(rec.urls)) {
+    return rec.urls
+      .map((u) => {
+        if (typeof u === 'string' && u.startsWith('/')) return { path: u };
+        if (u && typeof u === 'object' && typeof (u as { path?: unknown }).path === 'string') {
+          const row = u as { path: string; lastmod?: unknown; image?: unknown };
+          return {
+            path: row.path,
+            lastmod: typeof row.lastmod === 'string' ? row.lastmod : undefined,
+            image: typeof row.image === 'string' ? row.image : undefined,
+          };
+        }
+        return null;
+      })
+      .filter((u): u is SitemapUrl => !!u && u.path.startsWith('/'));
+  }
+  if (Array.isArray(rec.paths)) {
+    return rec.paths.filter((p): p is string => typeof p === 'string' && p.startsWith('/')).map((path) => ({ path }));
+  }
+  return [];
+}
+
+async function fetchJson(request: Request, pathname: string): Promise<unknown> {
+  const jsonUrl = new URL(pathname, request.url);
+  const res = await fetch(jsonUrl.toString());
+  if (!res.ok) return null;
+  return res.json();
+}
+
+async function loadUrls(request: Request): Promise<SitemapUrl[]> {
+  try {
+    const data = await fetchJson(request, '/sitemap-paths.json');
+    if (!data || typeof data !== 'object') return [{ path: '/' }];
+    const rec = data as { index?: unknown; parts?: unknown };
+    if (rec.index === true && typeof rec.parts === 'number' && rec.parts > 1) {
+      const partParam = new URL(request.url).searchParams.get('part');
+      if (partParam === null) {
+        return [];
+      }
+      const part = Number(partParam);
+      if (!Number.isInteger(part) || part < 0 || part >= rec.parts) return [{ path: '/' }];
+      const shard = await fetchJson(request, `/sitemap-paths-${part}.json`);
+      const urls = asUrls(shard);
+      return urls.length ? urls : [{ path: '/' }];
+    }
+    const urls = asUrls(data);
+    return urls.length ? urls : [{ path: '/' }];
+  } catch {
+    return [{ path: '/' }];
+  }
+}
+
+async function loadIndexParts(request: Request): Promise<number | null> {
+  try {
+    const data = await fetchJson(request, '/sitemap-paths.json');
+    if (data && typeof data === 'object') {
+      const rec = data as { index?: unknown; parts?: unknown };
+      if (rec.index === true && typeof rec.parts === 'number' && rec.parts > 1) return rec.parts;
+    }
+  } catch {
+    /* ignore */
+  }
+  return null;
+}
+
+function locFor(base: string, p: string): string {
+  return p === '/' ? base : `${base}${p.startsWith('/') ? p : `/${p}`}`;
+}
+
+function buildUrlset(base: string, urls: SitemapUrl[]): string {
+  const lines = urls.map((u) => {
+    const loc = locFor(base, u.path);
+    const lastmod = u.lastmod ? `\n    <lastmod>${escapeXml(u.lastmod)}</lastmod>` : '';
+    const image = u.image
+      ? `\n    <image:image>\n      <image:loc>${escapeXml(u.image)}</image:loc>\n    </image:image>`
+      : '';
+    return `  <url>\n    <loc>${escapeXml(loc)}</loc>${lastmod}${image}\n  </url>`;
+  });
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:image="${IMAGE_NS}">
+${lines.join('\n')}
+</urlset>`;
+}
+
+function buildIndex(base: string, parts: number): string {
+  const items = [];
+  for (let i = 0; i < parts; i++) {
+    items.push(`  <sitemap><loc>${escapeXml(`${base}/sitemap.xml?part=${i}`)}</loc></sitemap>`);
+  }
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${items.join('\n')}
+</sitemapindex>`;
+}
+
+export async function onRequestGet(context: { request: Request; env: Record<string, string | undefined> }) {
+  const { request, env } = context;
+  const fromEnv = normalizeBase(env.VITE_SEO_SITE_URL || env.SITE_URL);
+  const origin = new URL(request.url).origin.replace(/\/+$/, '');
+  const base = fromEnv || origin;
+  const part = new URL(request.url).searchParams.get('part');
+
+  const indexParts = await loadIndexParts(request);
+  if (indexParts && part === null) {
+    return new Response(buildIndex(base, indexParts), {
+      headers: {
+        'Content-Type': 'application/xml; charset=utf-8',
+        'Cache-Control': 'public, max-age=300',
+      },
+    });
+  }
+
+  const urls = await loadUrls(request);
+  const xml = buildUrlset(base, urls.length ? urls : [{ path: '/' }]);
+  return new Response(xml, {
+    headers: {
+      'Content-Type': 'application/xml; charset=utf-8',
+      'Cache-Control': 'public, max-age=300',
+    },
+  });
+}

package/template/scripts/generate.ts

@@ -1,15 +1,7 @@
-import { generateAllData, generateSitemapPathsSafe } from '@marvalt/digivalt-core/generators';
+import { generateAllData, generateSitemapPathsSafe, generateSeoManifestSafe } from '@marvalt/digivalt-core/generators';
 
 async function runGenerators() {
-  console.log('🚀 Starting DigiVAlt static data generation for Landing Project...');
-
-  if (process.env.VITE_IS_LOVABLE === 'true') {
-    console.log(
-      '⚡ Lovable Environment Detected (VITE_IS_LOVABLE). Skipping static data fetch; refreshing sitemap paths from committed JSON.'
-    );
-    await generateSitemapPathsSafe();
-    return;
-  }
+  console.log('🚀 Starting DigiVAlt static data generation...');
 
   try {
     await generateAllData();
@@ -17,6 +9,7 @@ async function runGenerators() {
   } catch (error) {
     console.error('❌ Data fetching encountered an error, but continuing build gracefully:', error);
     await generateSitemapPathsSafe();
+    await generateSeoManifestSafe();
   }
 }
 

package/template/scripts/prerender-seo.ts

@@ -0,0 +1,10 @@
+import { prerenderSeoHtml } from '@marvalt/digivalt-core/generators';
+
+async function run() {
+  await prerenderSeoHtml();
+}
+
+run().catch((e) => {
+  console.error('❌ SEO prerender failed:', e);
+  process.exit(1);
+});

package/docs/LOVABLE-MASTER-PROMPT.md

@@ -1,140 +0,0 @@
-# AI master prompt — DigiVAlt full local WordPress control
-
-Use this as a single copy-paste master prompt in Cursor, Claude Code, Antigravity, Lovable, or similar AI coding tools.
-
-The objective is a DigiValt app scaffold that is production-shaped from day one, where after generation a human only needs to set `.env` / `.env.local` values before first local run:
-
-```bash
-npm run build && npm run dev
-```
-
-## Scope
-
-- **AI responsibilities:** scaffold code, install/wire dependencies, run `digivalt-init`, ensure scripts/files are correct, keep cloud/function wiring and SEO enabled, and build a WordPress-driven shell.
-- **Human responsibilities:** set real env values on local PC and cloud dashboard, run first local build/dev, replace placeholder static data with real generated exports as needed.
-
-## Canonical sources
-
-- [README.md](../README.md)
-- [template/DIGIVALT_SETUP.md](../template/DIGIVALT_SETUP.md)
-- [template/scripts/generate.ts](../template/scripts/generate.ts)
-- [docs/SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md)
-- [digivalt-landing/DIGIVALT_SETUP.md](../../../digivalt-landing/DIGIVALT_SETUP.md)
-
----
-
-## Master prompt text (paste below into your AI tool)
-
-You are a senior full-stack engineer scaffolding a DigiValt consumer app (Vite + React + TypeScript) with full WordPress-controlled static content behavior. This workflow must work the same whether run from Cursor, Claude Code, Antigravity, Lovable, or another AI assistant.
-
-### Non-negotiables
-
-- Install `@marvalt/digivalt-core@latest`.
-- Use `npx digivalt-init` to enforce DigiValt-managed scaffold files and scripts.
-- Keep Cloudflare Pages Functions + `wrangler.toml` enabled.
-- Keep SEO enabled by default (Helmet provider + DigiValt SEO helpers).
-- Keep local secrets out of git and ignore `.env`, `.env.local`, `.env.*.local`, `.dev.vars`.
-- Do not hand-maintain `public/sitemap-paths.json`; it is generated.
-- Do not create `public/sitemap.xml` when using `functions/sitemap.xml.ts`.
-
-### File/path requirements
-
-Use these exact static data paths:
-
-- `public/wordpress-data.json`
-- `public/gravity-forms-data.json`
-- `src/data/mautic-data.json`
-
-If real exports are unavailable, use template starter fixtures (or equivalent minimal placeholders) so the app boots. Mark placeholders clearly.
-
-### Build wiring requirements
-
-Ensure these commands exist and are used:
-
-```bash
-npm install @marvalt/digivalt-core@latest
-npm install -D vite-node
-npx digivalt-init
-npm install react-helmet-async
-```
-
-Expected scripts:
-
-- `generate`: `npx vite-node --options.deps.inline="@marvalt/digivalt-core/generators" scripts/generate.ts`
-- `build`: `npx vite-node --options.deps.inline="@marvalt/digivalt-core/generators" scripts/generate.ts && vite build`
-- `build:dev`: `npx vite-node --options.deps.inline="@marvalt/digivalt-core/generators" scripts/generate.ts && vite build --mode development`
-- `dev`: `vite`
-
-### `scripts/generate.ts` behavior
-
-Import from `@marvalt/digivalt-core/generators` only:
-
-- In hosted fixture mode (`VITE_IS_LOVABLE=true`): skip fetch, run `generateSitemapPathsSafe()`.
-- In normal local mode (default): run `generateAllData()` then sitemap; on fetch failure still run sitemap safe fallback.
-
-### WordPress-driven runtime wiring (must implement)
-
-After `loadWordPressData()` from `@marvalt/digivalt-core/static`, wire the app shell and routes using WordPress static data:
-
-1. Menus from `getNavigationMenu()` / `getFooterNavigationMenu()` / `getMenuById()` (+ `getParsedHeader()` / `getHeaderMenuId()` / `getFooterMenuId()`). Assign classic menus in WP under **Appearance → Menus → Manage Locations** (`{frontendId}-header|footer`, then `default-*`).
-2. Optional header/footer template blocks from `getHeader()` / `getFooter()` (legacy). Prefer app-owned chrome + location menus for multi-frontend.
-3. Site identity from `getSiteSettings()` / `getLogoUrl()` / `getSiteIconUrl()`.
-4. Theme styles from `getWordPressData().theme_styles` mapped into app styling/tokens.
-5. Pages/posts/CPT routes from `getWordPressPages()`, `getWordPressPageBySlug()`, `getWordPressPosts()`, and `front_page`.
-
-For forms, support Gravity Forms and Mautic via `@marvalt/digivalt-core/services` and/or JSON static stores.
-
-### Cloudflare and sitemap requirements
-
-- Keep `functions/sitemap.xml.ts`.
-- Keep `functions/api/*` handlers from template and keep `wrangler.toml`.
-- Ensure sitemap flow is active:
-  - input: `public/sitemap-static-paths.json`
-  - generated output: `public/sitemap-paths.json`
-  - runtime endpoint: `/sitemap.xml` from Pages Function
-
-### AI output constraints
-
-- Do not request humans to hand-edit code before first run.
-- After scaffolding, the only required manual step before first run is env values in `.env` / `.env.local`.
-- Provide a final validation checklist and commands:
-  - `npm run build`
-  - `npm run dev`
-
----
-
-## Built-in defaults (use unless humans override later)
-
-- Package: `@marvalt/digivalt-core@latest`
-- Static data: template starter fixtures for WordPress, Gravity Forms, Mautic
-- SEO: ON
-- Cloudflare Functions + `wrangler.toml`: ON
-- Form/page mapping: derive from WordPress content and shortcodes first
-
----
-
-## Pre-flight checklist
-
-| Step | Done |
-|------|------|
-| `@marvalt/digivalt-core@latest` installed | ☐ |
-| `digivalt-init` run and scripts verified | ☐ |
-| Required static data files exist (`wordpress`, `gravity-forms`, `mautic`) | ☐ |
-| `sitemap-static-paths.json` exists and `sitemap-paths.json` is generated | ☐ |
-| Cloudflare functions/wrangler files present | ☐ |
-| SEO imports + `HelmetProvider` wired | ☐ |
-| `.gitignore` excludes local secret files | ☐ |
-
----
-
-## Reference paths in this monorepo
-
-| Concern | File |
-|---------|------|
-| Local setup baseline | [digivalt-landing/DIGIVALT_SETUP.md](../../../digivalt-landing/DIGIVALT_SETUP.md) |
-| Template setup baseline | [template/DIGIVALT_SETUP.md](../template/DIGIVALT_SETUP.md) |
-| Init behavior and script expectations | [README.md](../README.md) |
-| Generator script template | [template/scripts/generate.ts](../template/scripts/generate.ts) |
-| Landing generator implementation | [digivalt-landing/scripts/generate.ts](../../../digivalt-landing/scripts/generate.ts) |
-| SEO and sitemap behavior | [docs/SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md) |
-| WP static getters and shell helpers | [src/static/wpStatic.ts](../src/static/wpStatic.ts) |