domma-cms 0.1.0

package/scripts/seed.js

@@ -0,0 +1,666 @@
+#!/usr/bin/env node
+/**
+ * Domma CMS — Seed Demo Content
+ * Creates sample pages and updates navigation.
+ * Safe to run multiple times — overwrites seed paths only.
+ * Run: npm run seed
+ */
+import {mkdir, writeFile} from 'node:fs/promises';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT      = path.resolve(__dirname, '..');
+
+const PAGES_DIR = path.join(ROOT, 'content', 'pages');
+const NAV_CFG   = path.join(ROOT, 'config', 'navigation.json');
+
+const now = new Date().toISOString();
+
+// ---------------------------------------------------------------------------
+// Seed navigation
+// ---------------------------------------------------------------------------
+
+const SEED_NAV = {
+    brand: { text: 'My Site', logo: null, url: '/' },
+    items: [
+        { text: 'Home',    url: '/',        icon: 'home'      },
+        { text: 'About',   url: '/about',   icon: 'info'      },
+        { text: 'Blog',    url: '/blog',    icon: 'book-open' },
+      {text: 'Contact', url: '/contact', icon: 'mail'},
+      {
+        text: 'Resources', url: '/resources', icon: 'book-open',
+        items: [
+          {text: 'Overview', url: '/resources', icon: 'grid'},
+          {text: 'Typography', url: '/resources/typography', icon: 'type'},
+          {text: 'Grid System', url: '/resources/grid', icon: 'layout'},
+          {text: 'Cards', url: '/resources/cards', icon: 'credit-card'},
+          {text: 'Shortcode Reference', url: '/resources/shortcodes', icon: 'code'}
+        ]
+      }
+    ],
+    variant:  'dark',
+    position: 'sticky'
+};
+
+// ---------------------------------------------------------------------------
+// Page definitions
+// ---------------------------------------------------------------------------
+
+const PAGES = [
+    {
+        file: 'index.md',
+        fm: {
+            title: 'Welcome', slug: 'index',
+            description: 'Your new website, powered by Domma CMS',
+            layout: 'default', status: 'published',
+            sortOrder: 1, showInNav: false, sidebar: false,
+            seo: { title: 'Welcome', description: 'Your new website, powered by Domma CMS' },
+            createdAt: now, updatedAt: now
+        },
+        body: `# Welcome
+
+This is your new website, powered by **Domma CMS**.
+
+Edit this page from the [admin panel](/admin/), or modify \`content/pages/index.md\` directly.
+
+## What you can do
+
+- **Write pages** — create and publish content in Markdown
+- **Manage navigation** — build your site's menu from the admin panel
+- **Upload media** — attach images and files to your pages
+- **Choose a theme** — pick from 16 built-in colour schemes
+
+[Sign in to the admin panel →](/admin/)
+`
+    },
+    {
+        file: 'about.md',
+        fm: {
+            title: 'About', slug: 'about',
+            description: 'Learn more about us',
+            layout: 'default', status: 'published',
+            sortOrder: 2, showInNav: true, sidebar: false,
+            seo: { title: 'About', description: 'Learn more about us' },
+            createdAt: now, updatedAt: now
+        },
+        body: `# About
+
+This is the About page — tell your visitors who you are, what you do, and why it matters.
+
+## Our story
+
+Replace this content with your own. Edit it any time from the [admin panel](/admin/).
+
+## What we do
+
+Add your services, mission statement, or team information here.
+`
+    },
+    {
+        file: 'contact.md',
+        fm: {
+            title: 'Contact', slug: 'contact',
+            description: 'Get in touch',
+            layout: 'default', status: 'published',
+            sortOrder: 4, showInNav: true, sidebar: false,
+            seo: { title: 'Contact', description: 'Get in touch with us' },
+            createdAt: now, updatedAt: now
+        },
+        body: `# Contact
+
+Get in touch — we'd love to hear from you.
+
+## How to reach us
+
+Replace this with your contact details, a form, or whatever works best for your site.
+
+Edit this page from the [admin panel](/admin/).
+`
+    },
+    {
+        file: path.join('blog', 'index.md'),
+        fm: {
+            title: 'Blog', slug: 'blog',
+            description: 'News, updates and articles',
+            layout: 'default', status: 'published',
+            sortOrder: 3, showInNav: true, sidebar: false,
+            seo: { title: 'Blog', description: 'News, updates and articles' },
+            createdAt: now, updatedAt: now
+        },
+        body: `# Blog
+
+Welcome to the blog. Read on for articles, updates and news.
+
+---
+
+- [Hello, World!](/blog/hello-world) — Your first post
+`
+    },
+    {
+        file: path.join('blog', 'hello-world.md'),
+        fm: {
+            title: 'Hello, World!', slug: 'hello-world',
+            description: 'The first post on this site',
+            layout: 'default', status: 'published',
+            sortOrder: 1, showInNav: false, sidebar: false,
+            seo: { title: 'Hello, World!', description: 'The first post on this site' },
+            createdAt: now, updatedAt: now
+        },
+        body: `# Hello, World!
+
+Welcome to your first blog post, created by the Domma CMS seed script.
+
+Edit or delete this from the [admin panel](/admin/), then start writing your own content.
+
+## Writing in Markdown
+
+Domma CMS uses **Markdown** for all page content:
+
+- **Bold** with \`**double asterisks**\`
+- *Italic* with \`*single asterisks*\`
+- \`Inline code\` with backticks
+- [Links](https://example.com) with \`[text](url)\`
+
+> Blockquotes with \`>\`
+
+\`\`\`
+Code blocks with triple backticks
+\`\`\`
+
+Happy writing!
+`
+    },
+
+  // ----- Resources -----
+
+  {
+    file: path.join('resources', 'index.md'),
+    fm: {
+      title: 'Resources', slug: 'resources',
+      description: 'Reference pages showing the Domma CMS kit — typography, grid, cards, and shortcodes.',
+      layout: 'default', status: 'published',
+      sortOrder: 10, showInNav: false, sidebar: false,
+      seo: {title: 'Resources', description: 'Domma CMS component and shortcode reference'},
+      createdAt: now, updatedAt: now
+    },
+    body: `# Resources
+
+Reference pages for content authors and developers working with Domma CMS.
+
+[grid cols="2" gap="4"]
+[col]
+[card title="Typography"]
+Headings, paragraphs, lists, blockquotes, inline code, and all standard Markdown elements.
+
+[Read more →](/resources/typography)
+[/card]
+[/col]
+[col]
+[card title="Grid System"]
+Equal columns, column spanning, gap sizes, and flexbox rows using the \`[grid]\`, \`[row]\`, and \`[col]\` shortcodes.
+
+[Read more →](/resources/grid)
+[/card]
+[/col]
+[col]
+[card title="Cards"]
+Card shortcode variants — basic, titled, collapsible, and cards inside grid layouts.
+
+[Read more →](/resources/cards)
+[/card]
+[/col]
+[col]
+[card title="Shortcode Reference"]
+Full reference for every shortcode supported in the editor, including all attributes and examples.
+
+[Read more →](/resources/shortcodes)
+[/card]
+[/col]
+[/grid]
+`
+  },
+  {
+    file: path.join('resources', 'typography.md'),
+    fm: {
+      title: 'Typography', slug: 'typography',
+      description: 'Headings, paragraphs, lists, blockquotes, code, and all standard text elements.',
+      layout: 'default', status: 'published',
+      sortOrder: 11, showInNav: false, sidebar: false,
+      seo: {title: 'Typography — Resources', description: 'Typography reference for Domma CMS'},
+      createdAt: now, updatedAt: now
+    },
+    body: `# Typography
+
+Everything you can express with standard Markdown in the Domma CMS editor.
+
+---
+
+## Headings
+
+# Heading 1
+## Heading 2
+### Heading 3
+#### Heading 4
+##### Heading 5
+###### Heading 6
+
+---
+
+## Paragraphs & Inline Styles
+
+This is a regular paragraph. You can make text **bold**, _italic_, or ~~strikethrough~~. Combine them: **_bold and italic_**.
+
+You can also write \`inline code\` using backticks.
+
+---
+
+## Blockquotes
+
+> A blockquote stands out from body text and is useful for callouts, pull quotes, or attributed statements.
+
+> Blockquotes can contain **inline formatting** and span multiple lines.
+
+---
+
+## Lists
+
+### Unordered
+
+- First item
+- Second item
+  - Nested item
+  - Another nested item
+- Third item
+
+### Ordered
+
+1. Step one
+2. Step two
+3. Step three
+   1. Sub-step
+   2. Sub-step
+
+---
+
+## Code
+
+Inline code uses single backticks: \`npm run dev\`
+
+Fenced code blocks use triple backticks:
+
+\`\`\`js
+function greet(name) {
+  return \\\`Hello, \\\${name}!\\\`;
+}
+\`\`\`
+
+---
+
+## Tables
+
+| Column A | Column B | Column C |
+|----------|----------|----------|
+| Cell 1   | Cell 2   | Cell 3   |
+| Cell 4   | Cell 5   | Cell 6   |
+
+---
+
+← [Back to Resources](/resources)
+`
+  },
+  {
+    file: path.join('resources', 'grid.md'),
+    fm: {
+      title: 'Grid System', slug: 'grid',
+      description: 'Equal columns, column spanning, gap sizes, and flexbox rows using grid shortcodes.',
+      layout: 'default', status: 'published',
+      sortOrder: 12, showInNav: false, sidebar: false,
+      seo: {title: 'Grid System — Resources', description: 'Domma CMS grid shortcode reference'},
+      createdAt: now, updatedAt: now
+    },
+    body: `# Grid System
+
+Domma uses native CSS Grid via shortcodes. Use \`[grid]\`, \`[row]\`, and \`[col]\` in the editor — no HTML needed.
+
+---
+
+## Equal Columns
+
+### 2 Columns
+
+[grid cols="2" gap="4"]
+[col]
+**Left column**
+Each \`[col]\` fills one track of the grid automatically.
+[/col]
+[col]
+**Right column**
+No extra attributes needed for equal widths.
+[/col]
+[/grid]
+
+### 3 Columns
+
+[grid cols="3" gap="4"]
+[col]**One** — first of three.[/col]
+[col]**Two** — second of three.[/col]
+[col]**Three** — third of three.[/col]
+[/grid]
+
+### 4 Columns
+
+[grid cols="4" gap="3"]
+[col]Alpha[/col]
+[col]Beta[/col]
+[col]Gamma[/col]
+[col]Delta[/col]
+[/grid]
+
+---
+
+## Column Spanning
+
+Use \`span="N"\` on a \`[col]\` to make it span more than one track. Values must add up to \`cols\`.
+
+### 8 / 4 split
+
+[grid cols="12" gap="4"]
+[col span="8"]**span="8"** — main content area (two-thirds).[/col]
+[col span="4"]**span="4"** — sidebar (one-third).[/col]
+[/grid]
+
+### 6 / 6 (halves)
+
+[grid cols="12" gap="4"]
+[col span="6"]**span="6"** — left half.[/col]
+[col span="6"]**span="6"** — right half.[/col]
+[/grid]
+
+### 9 / 3
+
+[grid cols="12" gap="4"]
+[col span="9"]**span="9"** — wide column.[/col]
+[col span="3"]**span="3"** — narrow aside.[/col]
+[/grid]
+
+---
+
+## Gap Sizes
+
+**gap="1"**
+[grid cols="4" gap="1"]
+[col]One[/col][col]Two[/col][col]Three[/col][col]Four[/col]
+[/grid]
+
+**gap="3"**
+[grid cols="4" gap="3"]
+[col]One[/col][col]Two[/col][col]Three[/col][col]Four[/col]
+[/grid]
+
+**gap="6"**
+[grid cols="4" gap="6"]
+[col]One[/col][col]Two[/col][col]Three[/col][col]Four[/col]
+[/grid]
+
+---
+
+## Row (Flexbox)
+
+\`[row]\` uses flexbox — columns share available space equally without specifying a count.
+
+[row gap="4"]
+[col]**Flex col 1**[/col]
+[col]**Flex col 2**[/col]
+[col]**Flex col 3**[/col]
+[/row]
+
+---
+
+← [Back to Resources](/resources)
+`
+  },
+  {
+    file: path.join('resources', 'cards.md'),
+    fm: {
+      title: 'Cards', slug: 'cards',
+      description: 'Card shortcode variants — basic, titled, collapsible, and cards in grid layouts.',
+      layout: 'default', status: 'published',
+      sortOrder: 13, showInNav: false, sidebar: false,
+      seo: {title: 'Cards — Resources', description: 'Domma CMS card shortcode reference'},
+      createdAt: now, updatedAt: now
+    },
+    body: `# Cards
+
+The \`[card]\` shortcode wraps content in a styled card. Cards support full Markdown inside them, including other shortcodes.
+
+---
+
+## Basic Card (no header)
+
+[card]
+This is a basic card with no title. Useful for callout blocks or highlighted sections.
+
+It supports **bold**, _italic_, and \`inline code\`.
+[/card]
+
+---
+
+## Card with Title
+
+[card title="Card Title"]
+This card has a header. The \`title\` attribute sets the text in the card's top bar.
+[/card]
+
+---
+
+## Collapsible Card
+
+Add \`collapsible="true"\` to make the body toggle on header click. Starts collapsed.
+
+[card title="Click to expand" collapsible="true"]
+This content is hidden by default and revealed when the header is clicked.
+[/card]
+
+---
+
+## Cards in a Grid
+
+[grid cols="3" gap="4"]
+[col]
+[card title="Feature One"]
+Describe the first feature here. One or two sentences works well in a three-column layout.
+[/card]
+[/col]
+[col]
+[card title="Feature Two"]
+Cards in a grid automatically share the same height within a row.
+[/card]
+[/col]
+[col]
+[card title="Feature Three"]
+Add a link if this feature has its own dedicated page.
+[/card]
+[/col]
+[/grid]
+
+---
+
+## Grid Inside a Card
+
+[card title="Two-column layout inside a card"]
+[grid cols="2" gap="4"]
+[col]
+Use the left column for a description or introductory copy.
+[/col]
+[col]
+Use the right column for a list or supplementary detail.
+
+- Point A
+- Point B
+- Point C
+[/col]
+[/grid]
+[/card]
+
+---
+
+← [Back to Resources](/resources)
+`
+  },
+  {
+    file: path.join('resources', 'shortcodes.md'),
+    fm: {
+      title: 'Shortcode Reference', slug: 'shortcodes',
+      description: 'Full reference for every shortcode supported in the Domma CMS editor.',
+      layout: 'default', status: 'published',
+      sortOrder: 14, showInNav: false, sidebar: false,
+      seo: {title: 'Shortcode Reference — Resources', description: 'Complete shortcode reference for Domma CMS'},
+      createdAt: now, updatedAt: now
+    },
+    body: `# Shortcode Reference
+
+Shortcodes extend Markdown with layout and component capabilities. Mix them freely with regular Markdown.
+
+**Syntax:** \`[shortcode attribute="value"]…[/shortcode]\`
+
+---
+
+## [\`grid\`]
+
+Creates a CSS Grid container.
+
+| Attribute | Required | Description |
+|-----------|----------|-------------|
+| \`cols\` | Yes | Number of columns (1–12) |
+| \`gap\` | No | Gap between cells (1–6) |
+| \`class\` | No | Extra CSS classes |
+
+[grid cols="3" gap="4"]
+[col]**cols="3"**[/col]
+[col]**gap="4"**[/col]
+[col]**Equal widths**[/col]
+[/grid]
+
+---
+
+## [\`row\`]
+
+Flexbox row — columns share available width equally, no \`cols\` needed.
+
+| Attribute | Required | Description |
+|-----------|----------|-------------|
+| \`gap\` | No | Gap between columns (1–6) |
+| \`class\` | No | Extra CSS classes |
+
+[row gap="4"]
+[col]**Left**[/col]
+[col]**Right**[/col]
+[/row]
+
+---
+
+## [\`col\`]
+
+A column inside \`[grid]\` or \`[row]\`. Content is rendered as Markdown.
+
+| Attribute | Required | Description |
+|-----------|----------|-------------|
+| \`span\` | No | Columns to span (values must sum to grid \`cols\`) |
+| \`class\` | No | Extra CSS classes |
+
+[grid cols="12" gap="4"]
+[col span="8"]**span="8"** — main content[/col]
+[col span="4"]**span="4"** — sidebar[/col]
+[/grid]
+
+---
+
+## [\`card\`]
+
+Wraps content in a styled card.
+
+| Attribute | Required | Description |
+|-----------|----------|-------------|
+| \`title\` | No | Card header text |
+| \`collapsible\` | No | \`"true"\` to toggle body on header click |
+| \`class\` | No | Extra CSS classes |
+
+[card title="Example card"]
+Markdown **works** inside cards, including _italic_, \`code\`, and shortcodes.
+[/card]
+
+[card title="Collapsible" collapsible="true"]
+This body starts collapsed.
+[/card]
+
+---
+
+## Embedding a Form
+
+Paste this HTML anywhere in your Markdown to embed a form:
+
+\`\`\`html
+<div data-form="your-form-slug"></div>
+\`\`\`
+
+Replace \`your-form-slug\` with the slug from the Form Builder. Example:
+
+\`\`\`html
+<div data-form="contact"></div>
+\`\`\`
+
+---
+
+← [Back to Resources](/resources)
+`
+    }
+];
+
+// ---------------------------------------------------------------------------
+// Serialise frontmatter + body to .md string
+// Produces the same YAML-frontmatter format gray-matter reads.
+// ---------------------------------------------------------------------------
+
+function toMarkdown(fm, body) {
+    const lines = [];
+    for (const [k, v] of Object.entries(fm)) {
+        if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+            lines.push(`${k}:`);
+            for (const [nk, nv] of Object.entries(v)) {
+                lines.push(`  ${nk}: ${JSON.stringify(nv)}`);
+            }
+        } else {
+            lines.push(`${k}: ${JSON.stringify(v)}`);
+        }
+    }
+    return `---\n${lines.join('\n')}\n---\n\n${body}`;
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+console.log('');
+console.log('  ┌──────────────────────────────────┐');
+console.log('  │   Domma CMS — Seed Demo Content  │');
+console.log('  └──────────────────────────────────┘');
+console.log('');
+
+for (const page of PAGES) {
+    const filePath = path.join(PAGES_DIR, page.file);
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, toMarkdown(page.fm, page.body), 'utf8');
+    const urlLabel = '/' + page.file.replace(/\\/g, '/').replace(/index\.md$/, '').replace(/\.md$/, '');
+    console.log(`  ✓ ${urlLabel || '/'}`);
+}
+
+process.stdout.write('  Updating navigation…');
+await writeFile(NAV_CFG, JSON.stringify(SEED_NAV, null, 4) + '\n', 'utf8');
+console.log(' done.');
+
+console.log('');
+console.log(`  ✓ Seed complete — ${PAGES.length} pages created, navigation updated.`);
+console.log('  Visit your site at http://localhost:3050/');
+console.log('  Resources section available at http://localhost:3050/resources');
+console.log('');