@notionx/create-notionx-app 1.0.0 → 2.0.0

package/dist/provision/notion.js

@@ -563,133 +563,239 @@ function sampleBlocks(input) {
     if (input.locale?.toLowerCase().startsWith("zh")) {
         return [
             {
-                title: "首页 Hero",
+                name: "首页 Hero",
                 slug: "home-hero",
                 type: "hero",
-                description: "首页顶部主视觉区块，适合放标题、副标题与主行动按钮。",
-                pageKeys: ["home"],
                 order: 10,
                 coverSeed: "home-hero-zh",
-                eyebrow: "Notion + Cloudflare",
-                headline: "从一个可以持续编辑的首页开始",
-                subheadline: "把首页的一句话价值、介绍文案和主行动按钮交给 Notion，站点布局继续由代码稳定控制。",
-                primaryCtaLabel: "查看内容列表",
-                primaryCtaHref: "/blog",
-                secondaryCtaLabel: "了解项目",
-                secondaryCtaHref: "/about",
-                alignment: "center",
-                theme: "muted",
+                children: [
+                    {
+                        type: "heading_1",
+                        heading_1: {
+                            rich_text: [{ text: { content: "从一个可以持续编辑的首页开始" } }],
+                        },
+                    },
+                    {
+                        type: "paragraph",
+                        paragraph: {
+                            rich_text: [
+                                {
+                                    text: {
+                                        content: "把首页的一句话价值、介绍文案和主行动按钮交给 Notion，站点布局继续由代码稳定控制。",
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                    {
+                        type: "callout",
+                        callout: {
+                            rich_text: [
+                                { text: { content: "CTA: 查看内容列表 → /blog" } },
+                            ],
+                        },
+                    },
+                ],
             },
             {
-                title: "首页功能展示",
+                name: "首页功能展示",
                 slug: "home-feature-grid",
                 type: "feature-grid",
-                description: "用于首页中段的功能/能力展示区块。",
-                pageKeys: ["home"],
                 order: 20,
                 coverSeed: "home-feature-grid-zh",
-                headline: "把内容、运行时和发布流程串成一个清晰系统",
-                body: "这个区块默认用三列卡片展示项目能力，适合介绍内容工作流、部署基础设施和持续发布能力。",
-                columns: 3,
-                items: [
+                children: [
+                    {
+                        type: "heading_2",
+                        heading_2: {
+                            rich_text: [
+                                { text: { content: "把内容、运行时和发布流程串成一个清晰系统" } },
+                            ],
+                        },
+                    },
                     {
-                        title: "内容编辑",
-                        description: "让编辑直接在 Notion 中维护页面与内容，不需要改代码。",
-                        icon: "pen-square",
-                        href: "/about",
+                        type: "paragraph",
+                        paragraph: {
+                            rich_text: [
+                                {
+                                    text: {
+                                        content: "这个区块默认用三列卡片展示项目能力，适合介绍内容工作流、部署基础设施和持续发布能力。",
+                                    },
+                                },
+                            ],
+                        },
                     },
                     {
-                        title: "云端运行",
-                        description: "基于 Cloudflare Workers、D1 和 KV 提供轻量稳定的运行时能力。",
-                        icon: "cloud",
+                        type: "bulleted_list_item",
+                        bulleted_list_item: {
+                            rich_text: [
+                                { text: { content: "内容编辑：让编辑直接在 Notion 中维护页面与内容。" } },
+                            ],
+                        },
                     },
                     {
-                        title: "持续更新",
-                        description: `${input.contentSourceTitle} 列表可以持续发布新内容，并自动进入站点路由。`,
-                        icon: "newspaper",
-                        href: "/blog",
+                        type: "bulleted_list_item",
+                        bulleted_list_item: {
+                            rich_text: [
+                                { text: { content: "云端运行：基于 Cloudflare Workers、D1 和 KV 提供轻量稳定的运行时。" } },
+                            ],
+                        },
+                    },
+                    {
+                        type: "bulleted_list_item",
+                        bulleted_list_item: {
+                            rich_text: [
+                                { text: { content: `持续更新：${input.contentSourceTitle} 列表可以持续发布新内容。` } },
+                            ],
+                        },
                     },
                 ],
             },
             {
-                title: "首页最新文章",
+                name: "首页最新文章",
                 slug: "home-latest-posts",
                 type: "latest-posts",
-                description: "在首页展示最近发布内容的文章卡片区块。",
-                pageKeys: ["home"],
                 order: 30,
                 coverSeed: "home-latest-posts-zh",
-                headline: "看看最近更新了什么",
-                body: "默认展示最新发布的 6 篇内容，既能丰富首页，也能直接验证博客内容链路是否生效。",
-                count: 6,
-                primaryCtaLabel: "查看全部文章",
-                primaryCtaHref: "/blog",
+                children: [
+                    {
+                        type: "heading_2",
+                        heading_2: {
+                            rich_text: [{ text: { content: "看看最近更新了什么" } }],
+                        },
+                    },
+                    {
+                        type: "paragraph",
+                        paragraph: {
+                            rich_text: [
+                                {
+                                    text: {
+                                        content: "默认展示最新发布的 6 篇内容，既能丰富首页，也能直接验证博客内容链路是否生效。",
+                                    },
+                                },
+                            ],
+                        },
+                    },
+                ],
             },
         ];
     }
     return [
         {
-            title: "Homepage Hero",
+            name: "Homepage Hero",
             slug: "home-hero",
             type: "hero",
-            description: "Homepage hero module for headline, supporting copy, and primary CTA.",
-            pageKeys: ["home"],
             order: 10,
             coverSeed: "home-hero",
-            eyebrow: "Notion + Cloudflare",
-            headline: "Start with a homepage you can keep editing",
-            subheadline: "Keep the layout stable in code while the hero copy, positioning, and primary call to action evolve in Notion.",
-            primaryCtaLabel: "Explore the blog",
-            primaryCtaHref: "/blog",
-            secondaryCtaLabel: "Read the story",
-            secondaryCtaHref: "/about",
-            alignment: "center",
-            theme: "muted",
+            children: [
+                {
+                    type: "heading_1",
+                    heading_1: {
+                        rich_text: [
+                            { text: { content: "Start with a homepage you can keep editing" } },
+                        ],
+                    },
+                },
+                {
+                    type: "paragraph",
+                    paragraph: {
+                        rich_text: [
+                            {
+                                text: {
+                                    content: "Keep the layout stable in code while the hero copy, positioning, and primary call to action evolve in Notion.",
+                                },
+                            },
+                        ],
+                    },
+                },
+                {
+                    type: "callout",
+                    callout: {
+                        rich_text: [{ text: { content: "CTA: Explore the blog → /blog" } }],
+                    },
+                },
+            ],
         },
         {
-            title: "Homepage Feature Grid",
+            name: "Homepage Feature Grid",
             slug: "home-feature-grid",
             type: "feature-grid",
-            description: "Mid-page feature section for capabilities, benefits, or service pillars.",
-            pageKeys: ["home"],
             order: 20,
             coverSeed: "home-feature-grid",
-            headline: "Show the system working together",
-            body: "Use this grid to explain how editing, infrastructure, and publishing fit together without overwhelming the homepage.",
-            columns: 3,
-            items: [
+            children: [
+                {
+                    type: "heading_2",
+                    heading_2: {
+                        rich_text: [
+                            { text: { content: "Show the system working together" } },
+                        ],
+                    },
+                },
+                {
+                    type: "paragraph",
+                    paragraph: {
+                        rich_text: [
+                            {
+                                text: {
+                                    content: "Use this grid to explain how editing, infrastructure, and publishing fit together without overwhelming the homepage.",
+                                },
+                            },
+                        ],
+                    },
+                },
                 {
-                    title: "Editorial workflows",
-                    description: "Use Notion as the editor for pages, posts, and reusable sections.",
-                    icon: "pen-square",
-                    href: "/about",
+                    type: "bulleted_list_item",
+                    bulleted_list_item: {
+                        rich_text: [
+                            { text: { content: "Editorial workflows: Use Notion as the editor for pages, posts, and reusable sections." } },
+                        ],
+                    },
                 },
                 {
-                    title: "Cloudflare runtime",
-                    description: "Ship on Workers with storage and caching primitives ready to grow.",
-                    icon: "cloud",
+                    type: "bulleted_list_item",
+                    bulleted_list_item: {
+                        rich_text: [
+                            { text: { content: "Cloudflare runtime: Ship on Workers with storage and caching primitives ready to grow." } },
+                        ],
+                    },
                 },
                 {
-                    title: `${input.contentSourceTitle} updates`,
-                    description: "Publish new entries and surface them through the generated routes automatically.",
-                    icon: "newspaper",
-                    href: "/blog",
+                    type: "bulleted_list_item",
+                    bulleted_list_item: {
+                        rich_text: [
+                            { text: { content: `${input.contentSourceTitle} updates: Publish new entries and surface them through the generated routes automatically.` } },
+                        ],
+                    },
                 },
             ],
         },
         {
-            title: "Homepage Latest Posts",
+            name: "Homepage Latest Posts",
             slug: "home-latest-posts",
             type: "latest-posts",
-            description: "Homepage latest-posts block for previewing the newest published content.",
-            pageKeys: ["home"],
             order: 30,
             coverSeed: "home-latest-posts",
-            headline: "Read the latest from the blog",
-            body: "Use this section to prove the content model is working with a grid of recent published posts right on the homepage.",
-            count: 6,
-            primaryCtaLabel: "View all posts",
-            primaryCtaHref: "/blog",
+            children: [
+                {
+                    type: "heading_2",
+                    heading_2: {
+                        rich_text: [
+                            { text: { content: "Read the latest from the blog" } },
+                        ],
+                    },
+                },
+                {
+                    type: "paragraph",
+                    paragraph: {
+                        rich_text: [
+                            {
+                                text: {
+                                    content: "Use this section to prove the content model is working with a grid of recent published posts right on the homepage.",
+                                },
+                            },
+                        ],
+                    },
+                },
+            ],
         },
     ];
 }
@@ -1058,7 +1164,7 @@ function findMatchingField(properties, fields, key, fallback) {
         return fallback;
     return configured;
 }
-async function createDatabaseWithProperties(input) {
+export async function createDatabaseWithProperties(input) {
     const titleProp = Object.entries(input.properties).find(([, value]) => notionPropertyDefinitionType(value) === "title");
     const dbTitlePropName = titleProp ? titleProp[0] : "Name";
     const body = {
@@ -1210,7 +1316,7 @@ function buildSamplePage(input) {
         ],
     };
 }
-function buildPageProperties() {
+function buildPageProperties(blocksDatabaseId) {
     return {
         Name: { title: {} },
         Key: { rich_text: {} },
@@ -1230,7 +1336,12 @@ function buildPageProperties() {
         "Footer Group": { select: {} },
         "Footer Order": { number: {} },
         "Content Source": { rich_text: {} },
-        Blocks: { rich_text: {} },
+        // Blocks is a Notion relation to the Blocks database. The
+        // relation array order (set by drag-and-drop in Notion) is
+        // the native sort order for page blocks.
+        Blocks: blocksDatabaseId
+            ? { relation: { single_property: { database_id: blocksDatabaseId } } }
+            : { relation: { database_property: {} } },
         Cover: { files: {} },
     };
 }
@@ -1238,46 +1349,22 @@ function buildBlocksProperties() {
     return {
         Name: { title: {} },
         Slug: { rich_text: {} },
-        Status: { select: {} },
         Type: { select: {} },
-        Description: { rich_text: {} },
-        "Page Keys": { rich_text: {} },
         Order: { number: {} },
         Cover: { files: {} },
-        Eyebrow: { rich_text: {} },
-        Headline: { rich_text: {} },
-        Subheadline: { rich_text: {} },
-        "Primary CTA Label": { rich_text: {} },
-        "Primary CTA Href": { url: {} },
-        "Secondary CTA Label": { rich_text: {} },
-        "Secondary CTA Href": { url: {} },
-        Alignment: { select: {} },
-        Theme: { select: {} },
-        Columns: { number: {} },
-        Count: { number: {} },
-        Items: { rich_text: {} },
-        Body: { rich_text: {} },
-        Quote: { rich_text: {} },
-        "Quote Attribution": { rich_text: {} },
-        "Media Url": { url: {} },
-        Layout: { select: {} },
+        Published: { checkbox: {} },
     };
 }
 function richText(content) {
     return content ? [{ text: { content } }] : [];
 }
-function selectPropertyValue(name) {
-    return name ? { select: { name } } : { select: null };
-}
-function urlPropertyValue(url) {
-    return { url: url ?? null };
-}
-function numberPropertyValue(value) {
-    return { number: value ?? null };
-}
 function buildSitePagePayload(input) {
-    const { databaseId, page, projectName } = input;
+    const { databaseId, page, projectName, blockPageIdsBySlug } = input;
     const coverUrl = `https://picsum.photos/seed/${slugify(projectName)}-${page.coverSeed}/1200/600`;
+    const blockRelationIds = (page.blocks ?? [])
+        .map((ref) => blockPageIdsBySlug?.[ref.slug])
+        .filter((id) => Boolean(id))
+        .map((id) => ({ id }));
     return {
         parent: { type: "database_id", database_id: databaseId },
         cover: {
@@ -1303,9 +1390,9 @@ function buildSitePagePayload(input) {
             "Footer Group": { select: { name: page.footerGroup } },
             "Footer Order": { number: page.footerOrder },
             "Content Source": { rich_text: richText(page.contentSource ?? "") },
-            Blocks: {
-                rich_text: richText(JSON.stringify(page.blocks ?? [])),
-            },
+            ...(blockRelationIds.length > 0
+                ? { Blocks: { relation: blockRelationIds } }
+                : {}),
             Cover: {
                 files: [
                     {
@@ -1351,65 +1438,11 @@ function buildSiteBlockPayload(input) {
             external: { url: coverUrl },
         },
         properties: {
-            Name: { title: richText(block.title) },
+            Name: { title: richText(block.name) },
             Slug: { rich_text: richText(block.slug) },
-            Status: { select: { name: "Published" } },
             Type: { select: { name: block.type } },
-            Description: { rich_text: richText(block.description) },
-            "Page Keys": { rich_text: richText(JSON.stringify(block.pageKeys)) },
             Order: { number: block.order },
-            Eyebrow: {
-                rich_text: richText(block.type === "hero" ? block.eyebrow : ""),
-            },
-            Headline: {
-                rich_text: richText(block.type === "hero" ||
-                    block.type === "feature-grid" ||
-                    block.type === "story" ||
-                    block.type === "latest-posts"
-                    ? block.headline
-                    : ""),
-            },
-            Subheadline: {
-                rich_text: richText(block.type === "hero" ? block.subheadline : ""),
-            },
-            "Primary CTA Label": {
-                rich_text: richText(block.type === "hero"
-                    ? block.primaryCtaLabel
-                    : block.type === "latest-posts"
-                        ? block.primaryCtaLabel
-                        : ""),
-            },
-            "Primary CTA Href": urlPropertyValue(block.type === "hero"
-                ? block.primaryCtaHref
-                : block.type === "latest-posts"
-                    ? block.primaryCtaHref
-                    : undefined),
-            "Secondary CTA Label": {
-                rich_text: richText(block.type === "hero" ? block.secondaryCtaLabel ?? "" : ""),
-            },
-            "Secondary CTA Href": urlPropertyValue(block.type === "hero" ? block.secondaryCtaHref : undefined),
-            Alignment: selectPropertyValue(block.type === "hero" ? block.alignment : undefined),
-            Theme: selectPropertyValue(block.type === "hero" ? block.theme : undefined),
-            Columns: numberPropertyValue(block.type === "feature-grid" ? block.columns : undefined),
-            Count: numberPropertyValue(block.type === "latest-posts" ? block.count : undefined),
-            Items: {
-                rich_text: richText(block.type === "feature-grid" ? JSON.stringify(block.items) : ""),
-            },
-            Body: {
-                rich_text: richText(block.type === "feature-grid" ||
-                    block.type === "story" ||
-                    block.type === "latest-posts"
-                    ? block.body
-                    : ""),
-            },
-            Quote: {
-                rich_text: richText(block.type === "story" ? block.quote ?? "" : ""),
-            },
-            "Quote Attribution": {
-                rich_text: richText(block.type === "story" ? block.quoteAttribution ?? "" : ""),
-            },
-            "Media Url": urlPropertyValue(block.type === "story" ? block.mediaUrl : undefined),
-            Layout: selectPropertyValue(block.type === "story" ? block.layout : undefined),
+            Published: { checkbox: true },
             Cover: {
                 files: [
                     {
@@ -1420,7 +1453,7 @@ function buildSiteBlockPayload(input) {
                 ],
             },
         },
-        children: [],
+        children: block.children,
     };
 }
 /** Probe `ntn` — returns true if it's installed. */
@@ -1537,7 +1570,7 @@ export async function ensureNotionDatabase(input) {
 export async function ensurePagesDatabase(input) {
     const title = `${input.projectName} Pages`;
     const stableKey = "pages:default";
-    const properties = buildPageProperties();
+    const properties = buildPageProperties(input.blocksDatabaseId);
     const existingByStableKey = await findExistingDatabaseByStableKey({
         apiToken: input.apiToken,
         parentPageId: input.parentPageId,
@@ -1590,6 +1623,7 @@ export async function ensurePagesDatabase(input) {
             databaseId,
             projectName: input.projectName,
             page,
+            blockPageIdsBySlug: input.blockPageIdsBySlug,
         });
         const result = await runNtn(["api", "v1/pages", "-d", JSON.stringify(body)], {
             env: { NOTION_API_TOKEN: input.apiToken },
@@ -1661,6 +1695,7 @@ export async function ensureBlocksDatabase(input) {
         stableKey,
     });
     let seeded = 0;
+    const seededPageIdsBySlug = {};
     for (const block of sampleBlocks(input)) {
         const body = buildSiteBlockPayload({
             databaseId,
@@ -1672,6 +1707,17 @@ export async function ensureBlocksDatabase(input) {
         });
         if (result.code === 0) {
             seeded++;
+            // Capture the block page ID so the Pages database can link
+            // to it via the Blocks relation during seeding.
+            try {
+                const created = JSON.parse(result.stdout);
+                if (created.id) {
+                    seededPageIdsBySlug[block.slug] = created.id;
+                }
+            }
+            catch {
+                // Non-fatal: relation seeding is best-effort.
+            }
         }
         else {
             const detail = (result.stderr || result.stdout).trim().slice(0, 500);
@@ -1684,6 +1730,7 @@ export async function ensureBlocksDatabase(input) {
         url,
         created: true,
         seeded,
+        seededPageIdsBySlug,
     };
 }
 async function seedPlaceholderPages(apiToken, databaseId, dataSourceId, title, locale, fields, schema, count) {
@@ -1749,74 +1796,58 @@ export const _internal = {
     mergeDescriptionWithScaffoldMarker,
     missingPropertiesForPatch,
     buildSiteSettingsProperties,
-    buildSiteSettingsSeedPage,
+    buildSiteSettingsSeedPages,
 };
 // ---------------------------------------------------------------------------
-// Site settings (singleton row)
+// Site settings (multi-row key-value)
 //
 // The generated project reads site-level config (name, tagline, description,
-// default locale, social image) from a dedicated Notion data source. The
+// SEO, navigation, theme, footer) from a dedicated Notion data source. The
 // scaffolder creates that data source here, with a fixed schema the runtime
-// loader knows how to read, and seeds a single row pre-populated with the
-// project name + a placeholder description. Operators can edit the row in
-// Notion after scaffolding; changes show up within 5 minutes (KV cache TTL)
-// or immediately via the admin revalidate endpoint.
+// loader knows how to read, and seeds multiple rows — one per setting item —
+// pre-populated with the project name and sensible defaults. Operators can
+// edit rows in Notion after scaffolding; changes show up within 5 minutes
+// (KV cache TTL) or immediately via the admin revalidate endpoint.
 // ---------------------------------------------------------------------------
 /** Field names the runtime loader reads in `lib/site/settings.ts`. */
 export const SITE_SETTINGS_FIELDS = [
-    "Site Name", // title
-    "Tagline", // rich_text
-    "Description", // rich_text
-    "Default Locale", // select
-    "Social Image", // url
+    "Name", // title
+    "Section", // select
+    "Key", // rich_text
+    "Value", // rich_text
+    "Type", // select
+    "Published", // checkbox
 ];
 /**
  * Build the Notion `properties` object for the site-settings data source.
  *
- * Mirrors `siteSettingsSource.fields` in the generated
- * `lib/content/models.ts`:
- *   - `Site Name` → title (Notion's only title column)
- *   - `Tagline`   → rich_text
- *   - `Description` → rich_text
- *   - `Default Locale` → select
- *   - `Social Image` → url
+ * Multi-row key-value design: each row is one setting item grouped by
+ * `Section`. This is more intuitive for operators to edit in Notion —
+ * they see a clean table grouped by section instead of one wide row
+ * with 17 columns.
  *
- * Keep the `SITE_SETTINGS_FIELDS` array in sync with this map. The
- * scaffolder's seed row and the runtime loader both depend on it.
+ * Fields:
+ *   - `Name` (title) — human-readable label, e.g. "Site Name"
+ *   - `Section` (select) — grouping: branding/seo/theme/nav/footer
+ *   - `Key` (rich_text) — machine key: name/tagline/description/...
+ *   - `Value` (rich_text) — the setting value (text, JSON, etc.)
+ *   - `Type` (select) — text/url/json/color/select
+ *   - `Published` (checkbox) — whether this setting is active
  */
 export function buildSiteSettingsProperties() {
-    const props = {
-        // 5 pre-existing
-        "Site Name": { title: {} },
-        Tagline: { rich_text: {} },
-        Description: { rich_text: {} },
-        "Default Locale": { select: {} },
-        "Social Image": { url: {} },
-        // 12 new (0.5.4) — SEO, navigation, theme, footer
-        "Meta Title": { rich_text: {} },
-        "Meta Description": { rich_text: {} },
-        "OG Image": { url: {} },
-        Nav: { rich_text: {} },
-        "Nav CTA": { rich_text: {} },
-        "Primary Color": { select: {} },
-        "Accent Color": { select: {} },
-        "Font Family": { select: {} },
-        "Footer Columns": { rich_text: {} },
-        "Footer Copyright": { rich_text: {} },
-        "Footer Social Links": { rich_text: {} },
-        "Footer Tagline": { rich_text: {} },
+    return {
+        Name: { title: {} },
+        Section: { select: {} },
+        Key: { rich_text: {} },
+        Value: { rich_text: {} },
+        Type: { select: {} },
+        Published: { checkbox: {} },
     };
-    return props;
 }
 /**
- * Build the single seed page for the site-settings data source.
- *
- * The page carries the project name and a placeholder description so
- * the home page renders something useful before the operator customizes
- * it in Notion. The runtime loader falls back to
- * `fallbackSiteConfig` if the row is missing, so an unedited seed
- * page is fine — but a populated one means the very first request
- * after scaffolding already shows the right site name everywhere.
+ * Seed rows for the site-settings data source — one page per setting
+ * item. Each row carries a Section/Key/Value/Type tuple so the
+ * runtime loader can aggregate them into a single `SiteConfig`.
  *
  * `parent` uses `data_source_id` (Notion's 2025-09-03 schema).
  * Passing the legacy `database_id` here silently fails with
@@ -1824,7 +1855,25 @@ export function buildSiteSettingsProperties() {
  * is exactly the bug we hit when the Notion API started requiring
  * data sources for page parents.
  */
-export function buildSiteSettingsSeedPage(input) {
+const SETTINGS_SEED_ROWS = [
+    { name: "Site Name", section: "branding", key: "name", value: "My NotionX Site", type: "text" },
+    { name: "Tagline", section: "branding", key: "tagline", value: "Built with NotionX", type: "text" },
+    { name: "Description", section: "branding", key: "description", value: "", type: "text" },
+    { name: "Meta Title", section: "seo", key: "metaTitle", value: "", type: "text" },
+    { name: "Meta Description", section: "seo", key: "metaDescription", value: "", type: "text" },
+    { name: "Social Image", section: "seo", key: "socialImage", value: "", type: "url" },
+    { name: "OG Image", section: "seo", key: "ogImage", value: "", type: "url" },
+    { name: "Primary Color", section: "theme", key: "primaryColor", value: "blue", type: "select" },
+    { name: "Accent Color", section: "theme", key: "accentColor", value: "green", type: "select" },
+    { name: "Font Family", section: "theme", key: "fontFamily", value: "Inter", type: "select" },
+    { name: "Nav Items", section: "nav", key: "items", value: "[]", type: "json" },
+    { name: "Nav CTA", section: "nav", key: "cta", value: "{}", type: "json" },
+    { name: "Footer Columns", section: "footer", key: "columns", value: "[]", type: "json" },
+    { name: "Footer Copyright", section: "footer", key: "copyright", value: "", type: "text" },
+    { name: "Footer Social Links", section: "footer", key: "socialLinks", value: "[]", type: "json" },
+    { name: "Footer Tagline", section: "footer", key: "footerTagline", value: "", type: "text" },
+];
+export function buildSiteSettingsSeedPages(input) {
     const defaultNav = JSON.stringify([
         { label: "Home", href: "/" },
         { label: "About", href: "/about" },
@@ -1850,57 +1899,53 @@ export function buildSiteSettingsSeedPage(input) {
     const footerCopyright = `© ${new Date().getFullYear()} ${input.projectName}`;
     const socialImageUrl = `https://picsum.photos/seed/${slugify(input.projectName)}-social/1200/630`;
     const tagline = `${input.projectName} on Notion and Cloudflare`;
-    return {
+    // Override seed defaults with project-specific values where
+    // available so the very first request after scaffolding already
+    // shows the right site name everywhere.
+    const valueOverrides = {
+        name: input.projectName,
+        tagline,
+        description: input.description,
+        metaTitle: input.projectName,
+        metaDescription: input.description,
+        socialImage: socialImageUrl,
+        ogImage: socialImageUrl,
+        items: defaultNav,
+        cta: "{}",
+        columns: defaultFooterColumns,
+        copyright: footerCopyright,
+        socialLinks: "[]",
+        footerTagline: tagline,
+    };
+    return SETTINGS_SEED_ROWS.map((row) => ({
         parent: { type: "data_source_id", data_source_id: input.dataSourceId },
         properties: {
-            "Site Name": {
-                title: [{ text: { content: input.projectName } }],
-            },
-            Tagline: {
-                rich_text: [{ text: { content: tagline } }],
-            },
-            Description: {
-                rich_text: [{ text: { content: input.description } }],
-            },
-            "Default Locale": {
-                select: { name: input.defaultLocale },
-            },
-            "Meta Title": {
-                rich_text: [{ text: { content: input.projectName } }],
+            Name: {
+                title: [{ text: { content: row.name } }],
             },
-            "Meta Description": {
-                rich_text: [{ text: { content: input.description } }],
+            Section: {
+                select: { name: row.section },
             },
-            "Social Image": { url: socialImageUrl },
-            "OG Image": { url: socialImageUrl },
-            Nav: {
-                rich_text: [{ text: { content: defaultNav } }],
+            Key: {
+                rich_text: [{ text: { content: row.key } }],
             },
-            "Nav CTA": { rich_text: [] },
-            "Primary Color": { select: { name: "slate" } },
-            "Accent Color": { select: { name: "blue" } },
-            "Font Family": { select: { name: "inter" } },
-            "Footer Columns": {
-                rich_text: [{ text: { content: defaultFooterColumns } }],
-            },
-            "Footer Copyright": {
-                rich_text: [{ text: { content: footerCopyright } }],
-            },
-            "Footer Social Links": {
-                rich_text: [{ text: { content: "[]" } }],
+            Value: {
+                rich_text: [
+                    { text: { content: valueOverrides[row.key] ?? row.value } },
+                ],
             },
-            "Footer Tagline": {
-                rich_text: [{ text: { content: tagline } }],
+            Type: {
+                select: { name: row.type },
             },
+            Published: { checkbox: true },
         },
-    };
+    }));
 }
 /**
  * Create the site-settings data source under the given parent page and
- * insert the seed row. Same Notion API dance as
- * `ensureNotionDatabase`, minus the multi-page seeding — the singleton
- * row is created up front so the home page works before the operator
- * has opened Notion.
+ * insert the seed rows — one page per setting item. Same Notion API
+ * dance as `ensureNotionDatabase`, but with multi-row seeding so the
+ * home page works before the operator has opened Notion.
  */
 export async function ensureSiteSettingsDatabase(input) {
     const stableKey = "site-settings";
@@ -1920,7 +1965,7 @@ export async function ensureSiteSettingsDatabase(input) {
             title,
         }));
     if (existing) {
-        // Make sure the schema has every property the 0.5.4+ schema
+        // Make sure the schema has every property the current schema
         // expects. Notion adds new properties with no destructive
         // effect on existing rows.
         await ensureDataSourceProperties({
@@ -1958,24 +2003,132 @@ export async function ensureSiteSettingsDatabase(input) {
         existingDescription: "",
         stableKey,
     });
-    // 4) Seed the singleton row.
-    const seed = buildSiteSettingsSeedPage({
+    // 4) Seed one page per setting item.
+    const seeds = buildSiteSettingsSeedPages({
         projectName: input.projectName,
         description: input.description,
         defaultLocale: input.defaultLocale,
         dataSourceId,
     });
-    const seedResult = await runNtn(["api", "v1/pages", "-d", JSON.stringify(seed)], { env: { NOTION_API_TOKEN: input.apiToken } });
-    if (seedResult.code !== 0) {
-        const detail = (seedResult.stderr || seedResult.stdout).trim().slice(0, 500);
-        console.warn(`[notion site-settings seed] failed (code ${seedResult.code}): ${detail}`);
+    let seeded = 0;
+    for (const seed of seeds) {
+        const seedResult = await runNtn(["api", "v1/pages", "-d", JSON.stringify(seed)], { env: { NOTION_API_TOKEN: input.apiToken } });
+        if (seedResult.code !== 0) {
+            const detail = (seedResult.stderr || seedResult.stdout).trim().slice(0, 500);
+            console.warn(`[notion site-settings seed] failed (code ${seedResult.code}): ${detail}`);
+        }
+        else {
+            seeded++;
+        }
     }
     return {
         dataSourceId,
         databaseId,
         url,
         reused: false,
-        seeded: seedResult.code === 0 ? 1 : 0,
+        seeded,
+    };
+}
+/**
+ * Build the Notion `properties` object for the blog-translations
+ * data source. Mirrors `blogTranslationFields` in
+ * `@notionx/core/locale-contract/built-in`.
+ *
+ * `Source` is a relation to the base blog data source so each
+ * translation row points at its base post.
+ */
+export function buildBlogTranslationProperties(baseDatabaseId) {
+    return {
+        Title: { title: {} },
+        Source: baseDatabaseId
+            ? { relation: { single_property: { database_id: baseDatabaseId } } }
+            : { relation: { database_property: {} } },
+        Locale: { select: {} },
+        Slug: { rich_text: {} },
+        Description: { rich_text: {} },
+        "SEO Title": { rich_text: {} },
+        "SEO Description": { rich_text: {} },
+        // Body content lives in the translation page's children blocks,
+        // not a rich_text field — removes the 2000-char limit.
+        Published: { checkbox: {} },
     };
 }
+export function buildPageTranslationProperties(baseDatabaseId) {
+    return {
+        Title: { title: {} },
+        Source: baseDatabaseId
+            ? { relation: { single_property: { database_id: baseDatabaseId } } }
+            : { relation: { database_property: {} } },
+        Locale: { select: {} },
+        Slug: { rich_text: {} },
+        Description: { rich_text: {} },
+        "SEO Title": { rich_text: {} },
+        "SEO Description": { rich_text: {} },
+        "Nav Label": { rich_text: {} },
+        "Footer Label": { rich_text: {} },
+        // Body content lives in the translation page's children blocks,
+        // not a rich_text field — removes the 2000-char limit.
+        Published: { checkbox: {} },
+    };
+}
+export function buildBlockTranslationProperties(baseDatabaseId) {
+    return {
+        Title: { title: {} },
+        Source: baseDatabaseId
+            ? { relation: { single_property: { database_id: baseDatabaseId } } }
+            : { relation: { database_property: {} } },
+        Locale: { select: {} },
+        // Body content lives in the translation page's children blocks,
+        // not a rich_text field — removes the 2000-char limit.
+        Published: { checkbox: {} },
+    };
+}
+export function buildSiteSettingsTranslationProperties(baseDatabaseId) {
+    return {
+        Title: { title: {} },
+        Source: baseDatabaseId
+            ? { relation: { single_property: { database_id: baseDatabaseId } } }
+            : { relation: { database_property: {} } },
+        Locale: { select: {} },
+        Value: { rich_text: {} },
+        Published: { checkbox: {} },
+    };
+}
+export async function ensureTranslationDatabase(input) {
+    const title = titleForTranslationModel(input.modelId);
+    const properties = propertiesForTranslationModel(input.modelId, input.baseDatabaseId);
+    const result = await createDatabaseWithProperties({
+        apiToken: input.apiToken,
+        parentPageId: input.parentPageId,
+        title,
+        properties,
+    });
+    return {
+        databaseId: result.databaseId,
+        dataSourceId: result.dataSourceId,
+        url: result.url,
+        reused: false,
+    };
+}
+function titleForTranslationModel(modelId) {
+    const map = {
+        "blog-translations": "Blog Translations",
+        "page-translations": "Page Translations",
+        "block-translations": "Block Translations",
+        "site-settings-translations": "Site Settings Translations",
+    };
+    return map[modelId];
+}
+function propertiesForTranslationModel(modelId, baseDatabaseId) {
+    switch (modelId) {
+        case "blog-translations":
+            return buildBlogTranslationProperties(baseDatabaseId);
+        case "page-translations":
+            return buildPageTranslationProperties(baseDatabaseId);
+        case "block-translations":
+            return buildBlockTranslationProperties(baseDatabaseId);
+        case "site-settings-translations":
+            return buildSiteSettingsTranslationProperties(baseDatabaseId);
+    }
+}
 //# sourceMappingURL=notion.js.map