create-smoodly-app 0.0.45 → 0.0.46

package/templates/lorem-intl/scripts/seed.ts

@@ -24,12 +24,12 @@ loadEnvConfig(process.cwd());
 const { config } = await import("../smoodly/config");
 const { articles, news } = await import("../smoodly/collections");
 const { content, href, node } = await import("../smoodly/server");
-const { Hero } = await import("../components/sections/Hero");
-const { PageHero } = await import("../components/sections/PageHero");
-const { ImageText } = await import("../components/sections/ImageText");
-const { Points } = await import("../components/sections/Points");
-const { FavouriteArticles } = await import("../components/sections/FavouriteArticles");
-const { People } = await import("../components/sections/People");
+const { heroSchema } = await import("../components/sections/Hero.schema");
+const { pageHeroSchema } = await import("../components/sections/PageHero.schema");
+const { imageTextSchema } = await import("../components/sections/ImageText.schema");
+const { pointsSchema } = await import("../components/sections/Points.schema");
+const { favouriteArticlesSchema } = await import("../components/sections/FavouriteArticles.schema");
+const { peopleSchema } = await import("../components/sections/People.schema");
 const c = content();
 
 const EN = config.locales.default;
@@ -262,7 +262,7 @@ const quote: TreeNode = { id: "node-quote", type: "global", fields: { item: "quo
 
 // --- pages ----------------------------------------------------------
 
-const imageText = (locale: string, linkLabel: string) => node(ImageText, {
+const imageText = (locale: string, linkLabel: string) => node(imageTextSchema, {
     image: img.home2,
     heading: "Duis aute irure dolor in reprehenderit",
     text: doc(
@@ -273,7 +273,7 @@ const imageText = (locale: string, linkLabel: string) => node(ImageText, {
   }, { id: "node-intro", settings: { imageSide: "left" } });
 
 const points: TreeNode = {
-  ...node(Points, {
+  ...node(pointsSchema, {
     heading: "Quis autem vel eum",
     points: [
       { icon: "circle", heading: "Iure reprehenderit", text: "Qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat." },
@@ -285,7 +285,7 @@ const points: TreeNode = {
   styles: { spacingBottom: "lg" },
 };
 
-const favourites = (heading: string) => node(FavouriteArticles, { heading, items: [article.id] }, { id: "node-favourites" });
+const favourites = (heading: string) => node(favouriteArticlesSchema, { heading, items: [article.id] }, { id: "node-favourites" });
 
 // The custom section (spec 2026-09-14 §6): the editor's own rows of
 // richtext columns, widths in twelfths; Smoodly renders its layout CSS.
@@ -309,7 +309,7 @@ const homeTree = (locale: string, t: { kicker: string; buttons: [string, string]
   zones: {
     // The locked hero's one node. Pages created in the admin get theirs
     // from the editor (fillLockedZones on load); a seeded tree brings its own.
-    hero: [node(Hero, {
+    hero: [node(heroSchema, {
       kicker: t.kicker,
       heading: "Consectetur adipiscing elit sed do eiusmod",
       text: "Tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip.",
@@ -332,7 +332,7 @@ await seedCodePage("/", {
 // so the mount in the Pages list opens this page. Only a hero; the grid
 // is the view's own fetch.
 const articlesHero = (heading: string, text: string): Tree => ({
-  zones: { hero: [node(PageHero, { heading, text }, { id: "node-articles-hero" })] },
+  zones: { hero: [node(pageHeroSchema, { heading, text }, { id: "node-articles-hero" })] },
 });
 await seedCodePage(`/${articlesSegment(EN)}`, {
   en: articlesHero("Articles", "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt."),
@@ -348,22 +348,22 @@ const company = await seedPage({ slug: "company", title: "Company", template: nu
 // address (spec 2026-09-29 nested paths §3) — it shows under Company in
 // URL only; renaming Company never moves it.
 await seedCodePage(`/${newsAddress(EN)}`, {
-  en: { zones: { hero: [node(PageHero, { heading: "News", text: "Lorem ipsum dolor sit amet — what is new at Lorem Co." }, { id: "node-news-hero" })] } },
-  fi: { zones: { hero: [node(PageHero, { heading: "Uutiset", text: "Lorem ipsum dolor sit amet — mitä Lorem Co:lle kuuluu." }, { id: "node-news-hero" })] } },
+  en: { zones: { hero: [node(pageHeroSchema, { heading: "News", text: "Lorem ipsum dolor sit amet — what is new at Lorem Co." }, { id: "node-news-hero" })] } },
+  fi: { zones: { hero: [node(pageHeroSchema, { heading: "Uutiset", text: "Lorem ipsum dolor sit amet — mitä Lorem Co:lle kuuluu." }, { id: "node-news-hero" })] } },
 });
 
 const aboutTree = (t: { kicker: string; people: string; description: string }): Tree => ({
   fields: { showInNavigation: true },
   meta: { description: t.description },
   zones: {
-    hero: [node(PageHero, {
+    hero: [node(pageHeroSchema, {
       kicker: t.kicker,
       heading: "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
       text: "Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris.",
       image: img.about,
     }, { id: "node-about-hero" })],
     body: [
-      node(ImageText, {
+      node(imageTextSchema, {
           heading: "Duis aute irure dolor in reprehenderit",
           text: doc(
             p("In voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."),
@@ -372,7 +372,7 @@ const aboutTree = (t: { kicker: string; people: string; description: string }):
           ),
       }, { id: "node-about-text", settings: { imageSide: "left" } }),
       quote,
-      node(People, { heading: t.people, people: [jane.id, john.id, anna.id, mark.id] }, { id: "node-people" }),
+      node(peopleSchema, { heading: t.people, people: [jane.id, john.id, anna.id, mark.id] }, { id: "node-people" }),
     ],
   },
 });
@@ -390,8 +390,8 @@ const teamTree = (t: { heading: string; text: string; people: string }): Tree =>
   fields: { showInNavigation: true },
   meta: { description: t.text },
   zones: {
-    hero: [node(PageHero, { kicker: t.heading, heading: t.heading, text: t.text, image: img.about }, { id: "node-team-hero" })],
-    body: [node(People, { heading: t.people, people: [jane.id, john.id, anna.id, mark.id] }, { id: "node-team-people" })],
+    hero: [node(pageHeroSchema, { kicker: t.heading, heading: t.heading, text: t.text, image: img.about }, { id: "node-team-hero" })],
+    body: [node(peopleSchema, { heading: t.people, people: [jane.id, john.id, anna.id, mark.id] }, { id: "node-team-people" })],
   },
 });
 await seedPage(

package/templates/lorem-intl/smoodly/collections.ts

@@ -16,7 +16,7 @@ export const people = smoodly.collection({
 });
 
 // Articles are served at a path that is per locale — /posts/<slug> and
-// /fi/artikkelit/<slug> — and the Articles fixed page (components/pages/Articles.tsx) claims the same
+// /fi/artikkelit/<slug> — and the Articles fixed page claims the same
 // segments, which makes it the collection's index page. Tags are f.tags(),
 // localized as a whole, so the Finnish row carries Finnish tags.
 export const articles = smoodly.collection({
@@ -42,7 +42,7 @@ export const articles = smoodly.collection({
 // News lives under the company: a nested address, owned by code whole
 // (spec 2026-09-29 nested paths). The Company page at /company is an
 // editor's page; renaming it never moves the news. The News fixed page
-// (components/pages/News.tsx) claims the same address, which makes it
+// claims the same address, which makes it
 // the collection's index page.
 export const news = smoodly.collection({
   name: "news",

package/templates/lorem-intl/smoodly/config.ts

@@ -5,19 +5,17 @@ import { sections } from "./sections";
 import { globals } from "./globals";
 import { elements } from "./elements";
 import { article } from "./toolsets";
-import { RichText } from "./richtext";
-import { HomePage } from "@/components/pages/Home";
-import { ArticlesPage } from "@/components/pages/Articles";
-import { StandardPage } from "@/components/pages/Page";
-import { ArticlePage } from "@/components/pages/Article";
-import { NewsPage } from "@/components/pages/News";
-import { NewsPostPage } from "@/components/pages/NewsPost";
+import { homeSchema } from "@/components/pages/Home.schema";
+import { articlesSchema } from "@/components/pages/Articles.schema";
+import { pageSchema } from "@/components/pages/Page.schema";
+import { newsSchema } from "@/components/pages/News.schema";
 
 export { collections, sections, globals, elements };
 
-// The registry and the plain settings, one file. Runtime-free: nothing
-// here imports a route file or Next, so a script, the CLI's template
-// build and (later) the MCP server can load it outside the app. The
+// The registry of schemas and the plain settings, one file. It imports
+// no component, no route file and no Next API, so a script, the CLI and
+// (later) an MCP server can load it outside the app; smoodly/views.ts
+// lists the components that render these schemas. The
 // locale set comes from i18n/routing.ts (plain config, no Next inside) —
 // the proxy runs in the edge runtime and could not import this file the
 // other way round.
@@ -28,7 +26,8 @@ export const config = defineConfig({
     elements,
     collections,
     globals,
-    pages: [HomePage, ArticlesPage, StandardPage, ArticlePage, NewsPage, NewsPostPage],
+    // Page types. The entry pages are views: smoodly/views.ts lists them.
+    pages: [homeSchema, articlesSchema, pageSchema, newsSchema],
   },
   locales: { default: routing.defaultLocale, supported: [...routing.locales] },
   // Editors pick dates and times in this zone; the views format with it (an IANA name, never an offset).
@@ -38,7 +37,7 @@ export const config = defineConfig({
   // Nesting on: an editor can put pages three deep.
   pages: { tree: { depth: 3 } },
   // Smoodly's styles set (spacing, width, align) renders inline from
-  // these CSS values; app/globals.css defines the variables per
+  // these CSS values; the site's stylesheet defines the variables per
   // breakpoint. Default stores nothing — a section looks as written.
   styles: {
     spacing: { sm: "var(--space-sm)", md: "var(--space-md)", lg: "var(--space-lg)" },
@@ -48,7 +47,7 @@ export const config = defineConfig({
   css: true,
   // The custom section (spec 2026-09-14 §6): the editor's own rows of
   // columns. The columns take the article toolset (headings, lists,
-  // images, Callout and Cta) and render through the bound RichText, so
-  // body images go through next/image like everywhere else.
-  custom: { toolset: article, RichText },
+  // images, Callout and Cta); smoodly/views.ts binds the RichText that
+  // renders them, so body images go through next/image like everywhere else.
+  custom: { toolset: article },
 });

package/templates/lorem-intl/smoodly/elements.ts

@@ -1,6 +1,6 @@
-// The site's element registrations, in one list: the config registers
-// them, toolsets embed them by value, and smoodly/richtext.tsx renders them.
-import { Callout } from "@/components/elements/Callout";
-import { Cta } from "@/components/elements/Cta";
+// The element schemas a richtext body may embed; smoodly/views.ts lists
+// the components that render them.
+import { calloutSchema } from "@/components/elements/Callout.schema";
+import { ctaSchema } from "@/components/elements/Cta.schema";
 
-export const elements = [Callout, Cta];
+export const elements = [calloutSchema, ctaSchema];

package/templates/lorem-intl/smoodly/globals.ts

@@ -1,15 +1,17 @@
 // Global content (spec 2026-09-07): code-declared singletons stored as
 // entries. `header` and `footer` are visual — the layout renders them;
 // `contact` is an object the footer reads through the layout; `quote` is
-// visual and placed on pages from the picker's Global group.
+// visual and placed on pages from the picker's Global group. The three
+// the layout renders on every page are `layout: true`: they come with
+// the page's own read, so the layout's reads cost no database call.
 import { f, smoodly } from "smoodly";
-import { Header } from "@/components/sections/Header";
-import { Footer } from "@/components/sections/Footer";
-import { Quote } from "@/components/sections/Quote";
+import { headerSchema } from "@/components/sections/Header.schema";
+import { footerSchema } from "@/components/sections/Footer.schema";
+import { quoteSchema } from "@/components/sections/Quote.schema";
 
-export const header = smoodly.global({ name: "header", title: "Header", section: Header });
+export const header = smoodly.global({ name: "header", title: "Header", section: headerSchema, layout: true });
 
-export const footer = smoodly.global({ name: "footer", title: "Footer", section: Footer });
+export const footer = smoodly.global({ name: "footer", title: "Footer", section: footerSchema, layout: true });
 
 export const contact = smoodly.global({
   name: "contact",
@@ -19,8 +21,9 @@ export const contact = smoodly.global({
     phone: f.text().optional(),
     address: f.text().localized(),
   },
+  layout: true,
 });
 
-export const quote = smoodly.global({ name: "quote", title: "Quote", section: Quote });
+export const quote = smoodly.global({ name: "quote", title: "Quote", section: quoteSchema });
 
 export const globals = [header, footer, contact, quote];

package/templates/lorem-intl/smoodly/richtext.tsx

@@ -1,7 +1,7 @@
-// The site's richtext renderer, bound once: it knows the elements a body
-// may embed and renders body images through <SmoodlyImage>. Sections and
-// entry pages import RichText from here, never from the package root.
+// The site's bound RichText: the element components a body may embed,
+// images through <SmoodlyImage>.
 import { createRichText } from "smoodly/richtext";
-import { elements } from "./elements";
+import { Callout } from "@/components/elements/Callout";
+import { Cta } from "@/components/elements/Cta";
 
-export const RichText = createRichText({ elements, sizes: "(min-width: 900px) 720px, 100vw" });
+export const RichText = createRichText({ elements: [Callout, Cta], sizes: "(min-width: 900px) 720px, 100vw" });

package/templates/lorem-intl/smoodly/sections.ts

@@ -1,19 +1,18 @@
-// The site's section registrations, in one list. config.ts puts it
-// in the registry and re-exports it, so the config, the stores (which walk
-// trees against these schemas) and the renderer all share one array.
+// The site's section schemas, in one list. config.ts puts it in the
+// registry; smoodly/views.ts lists the components that render them.
 // Header and Footer are here because their global items render through
 // them; no zone lists them, so the "+" picker never offers them. Quote
 // is both: its global item renders through it, and the body zones list
 // it so the global quote can be placed (the picker offers a global item
 // only where its section is allowed).
-import { Hero } from "@/components/sections/Hero";
-import { PageHero } from "@/components/sections/PageHero";
-import { ImageText } from "@/components/sections/ImageText";
-import { Points } from "@/components/sections/Points";
-import { FavouriteArticles } from "@/components/sections/FavouriteArticles";
-import { People } from "@/components/sections/People";
-import { Quote } from "@/components/sections/Quote";
-import { Header } from "@/components/sections/Header";
-import { Footer } from "@/components/sections/Footer";
+import { heroSchema } from "@/components/sections/Hero.schema";
+import { pageHeroSchema } from "@/components/sections/PageHero.schema";
+import { imageTextSchema } from "@/components/sections/ImageText.schema";
+import { pointsSchema } from "@/components/sections/Points.schema";
+import { favouriteArticlesSchema } from "@/components/sections/FavouriteArticles.schema";
+import { peopleSchema } from "@/components/sections/People.schema";
+import { quoteSchema } from "@/components/sections/Quote.schema";
+import { headerSchema } from "@/components/sections/Header.schema";
+import { footerSchema } from "@/components/sections/Footer.schema";
 
-export const sections = [Hero, PageHero, ImageText, Points, FavouriteArticles, People, Quote, Header, Footer];
+export const sections = [heroSchema, pageHeroSchema, imageTextSchema, pointsSchema, favouriteArticlesSchema, peopleSchema, quoteSchema, headerSchema, footerSchema];

package/templates/lorem-intl/smoodly/server.ts

@@ -5,23 +5,23 @@
 // SMOODLY_PUBLISHABLE_KEY (the `smoodlyEnv("admin")` calls below); whether the
 // secret is a service-role key or a cloud write key is invisible here.
 //
-// Lazy on purpose, the site and renderer included: config.ts imports the
-// page shapes, and a page shape may import this file to read through
-// `q` (components/pages/Articles.tsx). That is a cycle, and the
-// admin route enters it from config.ts — so nothing here may read the
-// config at module scope.
+// Lazy on purpose: a page component imports this file to read through
+// `q` (components/pages/Articles.tsx), and this file imports the
+// components through ./views. That is a cycle, so nothing here reads
+// views() or the env at module scope.
 import {
-  createSmoodlyClient, createSmoodlySite, presenceConfig, smoodlyEnv, SupabaseAssetStore, SupabaseEntryStore, SupabaseMemberStore, SupabasePageStore, SupabasePathIndex, type PresenceConfig, type SmoodlySite,
+  createSmoodlyClient, createSmoodlySite, createSupabaseStores, presenceConfig, siteOptions, smoodlyEnv,
+  type PresenceConfig, type SmoodlySite, type SupabaseAssetStore, type SupabaseEntryStore, type SupabaseMemberStore, type SupabasePageStore,
 } from "smoodly";
-// The admin gate from `smoodly/admin`, which holds no client code: the site
-// routes import this file, and `smoodly/admin/next` would put the admin
-// shell in every live page's JavaScript.
+// The admin's server pieces: the sign-in check and the content API. No browser code lives in the package's
+// entries; the admin itself is prebuilt and served by app/(smoodly)/admin/[[...segments]]/route.ts.
 import { createSmoodlyContent, supabaseAdminAuth, type AdminAuth, type AuthConfig, type SmoodlyContent } from "smoodly/admin";
-import { createPageRenderer, createSmoodlyQueries, type PageRegistration } from "smoodly/next";
+import { createPageRenderer, createSmoodlyQueries } from "smoodly/next";
 import { connection } from "next/server";
 import type { SupabaseClient } from "@supabase/supabase-js";
 import { getPathname } from "@/i18n/navigation";
-import { collections, config, elements, sections, globals } from "./config";
+import { collections, config, globals } from "./config";
+import { views } from "./views";
 
 type Renderer = ReturnType<typeof createPageRenderer>;
 type Queries = ReturnType<typeof createSmoodlyQueries<typeof collections, typeof globals>>;
@@ -35,49 +35,27 @@ function bound(): Bound {
   if (cached) return cached;
   const env = smoodlyEnv();
   const db = createSmoodlyClient(env);
-  // ONE path index for both stores: pages and entries share the URL space.
-  // The index reads the code-owned addresses from the config (spec 2026-09-29 anchored paths §2).
-  const paths = new SupabasePathIndex(db, config.anchors);
-  const locales = config.locales;
-  const entries = new SupabaseEntryStore(db, collections, { paths, locales, globals, elements });
-  const pages = new SupabasePageStore(db, {
-    sections, elements, entries, paths, locales,
-    // The custom section's columns toolset, so a column's images count as usage (spec 2026-09-14 §6).
-    custom: config.custom,
-    homePageSlug: config.homePageSlug,
-    // Code-owned addresses by owner: a fixed page's or a collection's path (spec 2026-09-29 nested paths §3).
-    addresses: config.addresses,
-    tree: config.pages?.tree,
-  });
-  // The media library: rows in `assets`, bytes in the public `media` bucket.
-  const assets = new SupabaseAssetStore(db);
-  // The admission table, read by the Members page (spec 2026-09-25 §4).
-  const members = new SupabaseMemberStore(db);
+  // The stores, read off the config: pages, entries, the media library and the admission table.
+  const { pages, entries, assets, members, published } = createSupabaseStores(db, config);
   const auth = supabaseAdminAuth({ authUrl: env.authUrl, authKey: env.authKey, db });
-  // The site layer's own view of the stores; nothing outside this file reads them.
-  const stores = () => ({ pages, entries, assets });
   // The site layer: (locale, path) → page or entry, and the content API
   // `q` wraps below. Not exported — the app reads through `q`, which adds
   // draft awareness and the cache.
-  const site = createSmoodlySite({ stores, collections, globals, sections, elements, locales, homePageSlug: config.homePageSlug, styles: config.styles, custom: config.custom, pages: config.registry.pages ?? [] });
-  const renderer = createPageRenderer({
-    site,
-    sections,
-    elements,
-    pages: (config.registry.pages ?? []) as PageRegistration[],
-    href,
-  });
+  const site = createSmoodlySite(siteOptions(config, () => ({ pages, entries, assets, published })));
+  // The components, checked against the config's schemas here, on first use.
+  const renderer = createPageRenderer({ site, ...views(), href });
   // The read API (spec 2026-09-11): typed by the registry, draft-aware, cached under tags the admin expires.
   const q = createSmoodlyQueries({ site, collections, globals });
   cached = { db, pages, entries, assets, members, auth, site, renderer, q };
   return cached;
 }
 
-/** The admin's wiring, for `smoodly/ops.ts` only. Scripts write through `content()`. */
+/** The admin's wiring, for the admin route only. Scripts write through `content()`. */
 export function adminDeps() {
   smoodlyEnv("admin"); // the admin signs in with the publishable key: a missing one is named here, not on a live page
-  const { pages, entries, assets, members, auth } = bound();
-  return { pages, entries, assets, members, auth, href };
+  const { pages, entries, assets, members, auth, site } = bound();
+  // The projector: a publish writes the finished documents a live page reads.
+  return { pages, entries, assets, members, auth, href, projector: site.projector };
 }
 
 /** Write content from code — seeds, migrations, route handlers (spec 2026-09-30 tester findings §1).
@@ -85,8 +63,8 @@ export function adminDeps() {
  *  throws `SmoodlyContentError`. `content().pages.create(…)`, `.entries.create(…)`, `.globals.set(…)`,
  *  `.media.upload(…)`; build tree nodes with `node(Section, fields)`. */
 export function content(): SmoodlyContent {
-  const { pages, entries, assets, members } = bound();
-  return createSmoodlyContent({ config, pages, entries, assets, members, href });
+  const { pages, entries, assets, members, site } = bound();
+  return createSmoodlyContent({ config, pages, entries, assets, members, href, projector: site.projector });
 }
 
 export { node } from "smoodly";

package/templates/lorem-intl/smoodly/toolsets.ts

@@ -6,11 +6,11 @@
 // template build, which runs outside the app where the `@/` alias has
 // no mapping.
 import { smoodly } from "smoodly";
-import { Callout } from "../components/elements/Callout";
-import { Cta } from "../components/elements/Cta";
+import { calloutSchema } from "../components/elements/Callout.schema";
+import { ctaSchema } from "../components/elements/Cta.schema";
 
 export const article = smoodly.toolset({
   marks: ["bold", "italic", "link"],
   nodes: ["h2", "h3", "h4", "bulletList", "orderedList", "blockquote", "image"],
-  elements: [Callout, Cta],
+  elements: [calloutSchema, ctaSchema],
 });

package/templates/lorem-intl/smoodly/views.ts

@@ -0,0 +1,33 @@
+// The components that render the registered schemas. A function, not a
+// value: a page component imports smoodly/server.ts, which imports this
+// file, so the list must not be read while those modules are still
+// loading. defineViews names a schema with no component, and a component
+// with no schema, the first time the site renders.
+import { defineViews } from "smoodly/react";
+import { config } from "./config";
+import { RichText } from "./richtext";
+import { Hero } from "@/components/sections/Hero";
+import { PageHero } from "@/components/sections/PageHero";
+import { ImageText } from "@/components/sections/ImageText";
+import { Points } from "@/components/sections/Points";
+import { FavouriteArticles } from "@/components/sections/FavouriteArticles";
+import { People } from "@/components/sections/People";
+import { Quote } from "@/components/sections/Quote";
+import { Header } from "@/components/sections/Header";
+import { Footer } from "@/components/sections/Footer";
+import { Callout } from "@/components/elements/Callout";
+import { Cta } from "@/components/elements/Cta";
+import { HomePage } from "@/components/pages/Home";
+import { ArticlesPage } from "@/components/pages/Articles";
+import { StandardPage } from "@/components/pages/Page";
+import { ArticlePage } from "@/components/pages/Article";
+import { NewsPage } from "@/components/pages/News";
+import { NewsPostPage } from "@/components/pages/NewsPost";
+
+export const views = () =>
+  defineViews(config, {
+    sections: [Hero, PageHero, ImageText, Points, FavouriteArticles, People, Quote, Header, Footer],
+    elements: [Callout, Cta],
+    pages: [HomePage, ArticlesPage, StandardPage, ArticlePage, NewsPage, NewsPostPage],
+    RichText,
+  });

package/templates/lorem-intl/supabase/migrations/20261007120000_smoodly_v8.sql

@@ -0,0 +1,154 @@
+-- Smoodly core schema, version 8 (docs/superpowers/specs/2026-10-07-delivery-model-design.md).
+-- Shipped in the smoodly package; `npx smoodly migrate` copies it into supabase/migrations/.
+-- Never edit a published file: the next change is the next file.
+-- The delta over version 7: the delivery model's two derived tables,
+-- published_pages and published_entries, with the space trigger and the
+-- write-key-only policies every content table has (no row cap: they are
+-- derived), smoodly_list_published over the raw published snapshot, and
+-- the published_routes view, one lookup for any address.
+
+set client_min_messages = warning;
+
+-- The delivery model (spec 2026-10-07): Publish writes the finished document of a page, an entry
+-- or a global here; a live read is one lookup. Derived and rebuildable from the editing tables.
+create table if not exists "published_pages" (
+  "space_id" uuid not null default '00000000-0000-0000-0000-000000000000',
+  "page_id" uuid not null references "pages" ("id") on delete cascade,
+  "locale" text not null,
+  "parent_id" uuid,
+  "sort" numeric,
+  "path" text,
+  "title" text not null,
+  "has_page" boolean not null,
+  "link_fields" jsonb not null default '{}'::jsonb,
+  "document" jsonb,
+  "tags" text[] not null default '{}',
+  "model" text not null,
+  "stale" boolean not null default false,
+  "published_at" timestamptz not null default now(),
+  primary key ("page_id", "locale")
+);
+create unique index if not exists "published_pages_address_idx"
+  on "published_pages" ("space_id", "locale", "path") where "path" is not null;
+create index if not exists "published_pages_tree_idx"
+  on "published_pages" ("space_id", "locale", "parent_id", "sort");
+
+create table if not exists "published_entries" (
+  "space_id" uuid not null default '00000000-0000-0000-0000-000000000000',
+  "entry_id" uuid not null references "entries" ("id") on delete cascade,
+  "locale" text not null,
+  "collection" text not null,
+  "parent_id" uuid,
+  "sort" numeric,
+  "slug" text,
+  "path" text,
+  "created_at" timestamptz not null,
+  "updated_at" timestamptz not null,
+  "fields" jsonb not null,
+  "document" jsonb not null,
+  "tags" text[] not null default '{}',
+  "model" text not null,
+  "stale" boolean not null default false,
+  "published_at" timestamptz not null default now(),
+  primary key ("entry_id", "locale")
+);
+create index if not exists "published_entries_list_idx"
+  on "published_entries" ("space_id", "collection", "locale");
+create unique index if not exists "published_entries_address_idx"
+  on "published_entries" ("space_id", "locale", "path") where "path" is not null;
+create index if not exists "published_entries_fields_idx"
+  on "published_entries" using gin ("fields");
+
+alter table "published_pages" enable row level security;
+alter table "published_entries" enable row level security;
+
+-- smoodly_list_entries without the draft branch, over the delivery table (spec 2026-10-07 §3):
+-- `where` and `order` read the raw published snapshot, the row answers with its document.
+-- Invoker rights, so RLS decides what a key sees.
+create or replace function "smoodly_list_published"(
+  p_collection text, p_locale text, p_where jsonb, p_order jsonb,
+  p_limit integer, p_parent uuid, p_has_parent boolean, p_ids uuid[]
+) returns table ("id" uuid, "document" jsonb, "model" text, "stale" boolean) language sql stable set search_path = public as $$
+  with shown as (
+    select p."entry_id" as "id", p."sort", p."created_at", p."updated_at", p."fields", p."document", p."model", p."stale"
+    from "published_entries" p
+    where p."collection" = p_collection and p."locale" = p_locale
+      and (not p_has_parent or p."parent_id" is not distinct from p_parent)
+      and (p_ids is null or p."entry_id" = any(p_ids))
+  )
+  select s."id", s."document", s."model", s."stale" from shown s
+  where not exists (
+    select 1 from jsonb_each(coalesce(p_where, '{}'::jsonb)) w
+    where not (case when w.value ? 'in'
+                    then (s."fields" ->> w.key) = any (select jsonb_array_elements_text(w.value -> 'in'))
+                    else s."fields" @> jsonb_build_object(w.key, w.value -> 'contains') end))
+  order by
+    case when p_order ->> 'by' = 'manual' then s."sort" end asc nulls last,
+    case when p_order ->> 'direction' = 'asc' then
+      case p_order ->> 'by' when 'createdAt' then to_jsonb(s."created_at") when 'updatedAt' then to_jsonb(s."updated_at")
+           when 'manual' then null else nullif(nullif(s."fields" -> (p_order ->> 'by'), 'null'::jsonb), '""'::jsonb) end end asc nulls last,
+    case when p_order ->> 'direction' = 'desc' then
+      case p_order ->> 'by' when 'createdAt' then to_jsonb(s."created_at") when 'updatedAt' then to_jsonb(s."updated_at")
+           when 'manual' then null else nullif(nullif(s."fields" -> (p_order ->> 'by'), 'null'::jsonb), '""'::jsonb) end end desc nulls last,
+    s."created_at" asc, s."id" asc
+  limit p_limit;
+$$;
+
+-- One lookup for any address (spec 2026-10-07 §3): a page or an entry, under the caller's own policies.
+create or replace view "published_routes" with (security_invoker = true) as
+  select "space_id", "locale", "path", 'page' as "kind", "page_id" as "id", "document", "model", "stale", "tags", null::text as "collection"
+  from "published_pages" where "path" is not null and "has_page"
+  union all
+  select "space_id", "locale", "path", 'entry' as "kind", "entry_id" as "id", "document", "model", "stale", "tags", "collection"
+  from "published_entries" where "path" is not null;
+
+-- Stamped with the caller's space on insert, as every content table.
+drop trigger if exists "smoodly_a_set_space" on "published_pages";
+create trigger "smoodly_a_set_space" before insert on "published_pages"
+  for each row execute function "smoodly_set_space"();
+
+drop trigger if exists "smoodly_a_set_space" on "published_entries";
+create trigger "smoodly_a_set_space" before insert on "published_entries"
+  for each row execute function "smoodly_set_space"();
+
+-- A write key reads and writes its own space; no other key reads (spec 2026-09-29 content API contract §8).
+drop policy if exists "smoodly_write" on "published_pages";
+
+drop policy if exists "smoodly_insert" on "published_pages";
+create policy "smoodly_insert" on "published_pages" for insert
+  with check ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_update" on "published_pages";
+create policy "smoodly_update" on "published_pages" for update
+  using ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write')
+  with check ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_delete" on "published_pages";
+create policy "smoodly_delete" on "published_pages" for delete
+  using ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_read" on "published_pages";
+create policy "smoodly_read" on "published_pages" for select
+  using ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_write" on "published_entries";
+
+drop policy if exists "smoodly_insert" on "published_entries";
+create policy "smoodly_insert" on "published_entries" for insert
+  with check ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_update" on "published_entries";
+create policy "smoodly_update" on "published_entries" for update
+  using ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write')
+  with check ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_delete" on "published_entries";
+create policy "smoodly_delete" on "published_entries" for delete
+  using ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+drop policy if exists "smoodly_read" on "published_entries";
+create policy "smoodly_read" on "published_entries" for select
+  using ("space_id" = (select "smoodly_current_space"()) and not (select "smoodly_space_key_revoked"()) and (select "smoodly_key_kind"()) = 'write');
+
+insert into "smoodly_meta" ("key", "value") values ('schema_version', '8')
+  on conflict ("key") do update set "value" = excluded."value";