domma-cms 0.5.4 → 0.6.1

package/bin/cli.js

@@ -37,21 +37,44 @@ const positional = args.filter(a => !a.startsWith('--'));
 
 if (flags.has('--help') || args.includes('-h')) {
   console.log(`
-  Usage: npx domma-cms <project-name> [options]
+  Usage: npx domma-cms <command> [options]
 
-  Options:
+  Commands:
+    <project-name>   Scaffold a new Domma CMS project
+    update           Update an existing project to the latest version
+
+  Scaffold options:
     --no-install   Skip npm install
     --no-setup     Skip the interactive setup wizard
     --no-seed      Skip seeding default pages, forms, and collections
     --help         Show this help message
 
-  Example:
+  Update options:
+    --yes          Skip confirmation prompt
+    --no-backup    Skip creating a backup before updating
+    --no-install   Skip npm install after updating
+    --dry-run      Preview what would change without writing anything
+
+  Examples:
     npx domma-cms my-blog
     npx domma-cms my-blog --no-install --no-setup
+    npx domma-cms update
+    npx domma-cms update --dry-run
+    npx domma-cms update --yes --no-backup
 `);
   process.exit(0);
 }
 
+// ---------------------------------------------------------------------------
+// Route subcommands
+// ---------------------------------------------------------------------------
+
+if (positional[0] === 'update') {
+  const {default: runUpdate} = await import('./update.js');
+  await runUpdate(positional.slice(1), flags);
+  process.exit(0);
+}
+
 const projectName = positional[0];
 
 if (!projectName) {
@@ -147,6 +170,10 @@ step('Copying plugins');
 copyDir('plugins');
 done();
 
+step('Copying CLAUDE.md');
+cpSync(path.join(PACKAGE_ROOT, 'CLAUDE.md'), path.join(target, 'CLAUDE.md'));
+done();
+
 // ---------------------------------------------------------------------------
 // Reset data files inside copied plugins
 // ---------------------------------------------------------------------------
@@ -292,6 +319,7 @@ const GITIGNORE = `node_modules/
 content/users/
 content/media/
 *.log
+.domma-backups/
 `;
 
 step('Writing .gitignore');
@@ -351,6 +379,19 @@ if (noSeed) {
   console.log('');
 }
 
+// ---------------------------------------------------------------------------
+// Write .domma version marker
+// ---------------------------------------------------------------------------
+
+step('Writing .domma marker');
+const marker = {
+  cmsVersion: sourcePkg.version,
+  scaffoldedAt: new Date().toISOString(),
+  lastUpdatedAt: null
+};
+writeFileSync(path.join(target, '.domma'), JSON.stringify(marker, null, 2) + '\n', 'utf8');
+done();
+
 // ---------------------------------------------------------------------------
 // Success
 // ---------------------------------------------------------------------------

package/bin/lib/config-merge.js

@@ -0,0 +1,44 @@
+/**
+ * Domma CMS — Config Merge Utility
+ * Merges new keys from an upstream config into an existing user config,
+ * without ever overwriting values the user already has.
+ */
+
+/**
+ * Deep-merge new keys from `upstream` into `existing`.
+ * Existing values are never modified — only missing keys are added.
+ *
+ * @param {object} existing - The user's current config object
+ * @param {object} upstream - The upstream (new version) config object
+ * @param {string} [_prefix] - Internal: key path prefix for reporting
+ * @returns {{ merged: object, added: string[] }} Merged object + list of added key paths
+ */
+export function deepMergeNewKeys(existing, upstream, _prefix = '') {
+    const merged = {...existing};
+    const added = [];
+
+    for (const [key, upstreamVal] of Object.entries(upstream)) {
+        const fullKey = _prefix ? `${_prefix}.${key}` : key;
+
+        if (!(key in existing)) {
+            // Key is entirely missing — add it wholesale
+            merged[key] = upstreamVal;
+            added.push(fullKey);
+        } else if (
+            upstreamVal !== null &&
+            typeof upstreamVal === 'object' &&
+            !Array.isArray(upstreamVal) &&
+            typeof existing[key] === 'object' &&
+            existing[key] !== null &&
+            !Array.isArray(existing[key])
+        ) {
+            // Both sides are plain objects — recurse
+            const child = deepMergeNewKeys(existing[key], upstreamVal, fullKey);
+            merged[key] = child.merged;
+            added.push(...child.added);
+        }
+        // Otherwise: existing value wins — no action
+    }
+
+    return {merged, added};
+}

package/bin/update.js

@@ -0,0 +1,547 @@
+#!/usr/bin/env node
+/**
+ * Domma CMS — Project Update
+ * Usage: npx domma-cms update [--yes] [--no-backup] [--no-install] [--dry-run]
+ *
+ * Run from inside an existing Domma CMS project directory.
+ * Pulls upstream changes from the installed CLI package into the project,
+ * preserving all user content, config, and custom plugins.
+ */
+
+import {cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync,} from 'node:fs';
+import {spawnSync} from 'node:child_process';
+import path from 'node:path';
+import {createInterface} from 'node:readline';
+import {fileURLToPath} from 'node:url';
+import {deepMergeNewKeys} from './lib/config-merge.js';
+
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function step(label) {
+    process.stdout.write(`  ${label}…`);
+}
+
+function done(note = '') {
+    console.log(note ? ` done. ${note}` : ' done.');
+}
+
+function info(msg) {
+    console.log(`  ${msg}`);
+}
+
+function warn(msg) {
+    console.log(`  ⚠  ${msg}`);
+}
+
+function readJson(filePath) {
+    return JSON.parse(readFileSync(filePath, 'utf8'));
+}
+
+function writeJson(filePath, obj) {
+    writeFileSync(filePath, JSON.stringify(obj, null, 4) + '\n', 'utf8');
+}
+
+/**
+ * Prompt the user for a yes/no confirmation.
+ * @param {string} question
+ * @returns {Promise<boolean>}
+ */
+function confirm(question) {
+    return new Promise(resolve => {
+        const rl = createInterface({input: process.stdin, output: process.stdout});
+        rl.question(`  ${question} [y/N] `, answer => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+    });
+}
+
+/**
+ * Recursively list all relative file paths under a directory.
+ * @param {string} dir - Absolute directory path
+ * @param {string} [base] - Base path for relative output (defaults to dir)
+ * @returns {string[]}
+ */
+function listFiles(dir, base = dir) {
+    if (!existsSync(dir)) return [];
+    const result = [];
+    for (const entry of readdirSync(dir, {withFileTypes: true})) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            result.push(...listFiles(full, base));
+        } else {
+            result.push(path.relative(base, full));
+        }
+    }
+    return result;
+}
+
+// ---------------------------------------------------------------------------
+// Upstream dirs that are fully replaced on update
+// ---------------------------------------------------------------------------
+
+const UPSTREAM_DIRS = ['server', 'admin', 'public', 'scripts'];
+
+// ---------------------------------------------------------------------------
+// Structural config files that get new-key merging (never full replace)
+// ---------------------------------------------------------------------------
+
+const STRUCTURAL_CONFIGS = [
+    'config/server.json',
+    'config/auth.json',
+    'config/content.json',
+    'config/presets.json',
+];
+
+// ---------------------------------------------------------------------------
+// Main update function
+// ---------------------------------------------------------------------------
+
+/**
+ * @param {string[]} _positional - Remaining positional args (unused)
+ * @param {Set<string>} flags - Parsed CLI flags
+ */
+export default async function update(_positional, flags) {
+    const isDryRun = flags.has('--dry-run');
+    const skipConfirm = flags.has('--yes');
+    const skipBackup = flags.has('--no-backup');
+    const skipInstall = flags.has('--no-install');
+
+    const cwd = process.cwd();
+
+    // -------------------------------------------------------------------------
+    // 1. Detect project
+    // -------------------------------------------------------------------------
+
+    console.log('');
+    console.log('  ┌──────────────────────────────────────────┐');
+    console.log('  │                                          │');
+    console.log('  │   Domma CMS — Project Updater           │');
+    console.log('  │                                          │');
+    console.log('  └──────────────────────────────────────────┘');
+    console.log('');
+
+    // Refuse to run inside the CLI package itself
+    if (path.resolve(cwd) === path.resolve(PACKAGE_ROOT)) {
+        console.error('  ✗ Run this command from inside your scaffolded project, not the CLI package.\n');
+        process.exit(1);
+    }
+
+    const requiredFiles = ['package.json', 'server/server.js', 'config'];
+    for (const f of requiredFiles) {
+        if (!existsSync(path.join(cwd, f))) {
+            console.error(`  ✗ Not a Domma CMS project directory (missing ${f}).\n`);
+            console.error('  Run this command from inside your project folder.\n');
+            process.exit(1);
+        }
+    }
+
+    // Scaffolded projects are always private — reject if not
+    try {
+        const cwdPkg = readJson(path.join(cwd, 'package.json'));
+        if (!cwdPkg.private) {
+            console.error('  ✗ This does not appear to be a scaffolded Domma CMS project (package.json is not private).\n');
+            process.exit(1);
+        }
+    } catch { /* malformed package.json — let it proceed */
+    }
+
+    // -------------------------------------------------------------------------
+    // 2. Read version information
+    // -------------------------------------------------------------------------
+
+    const markerPath = path.join(cwd, '.domma');
+    let installedVersion = 'unknown';
+    let markerData = null;
+
+    if (existsSync(markerPath)) {
+        try {
+            markerData = readJson(markerPath);
+            installedVersion = markerData.cmsVersion ?? 'unknown';
+        } catch {
+            warn('Could not read .domma marker — treating as unknown version.');
+        }
+    } else {
+        warn('No .domma marker found. This project was scaffolded before version tracking was introduced.');
+        warn('The updater will proceed, but cannot guarantee what was previously installed.');
+        console.log('');
+    }
+
+    const sourcePkg = readJson(path.join(PACKAGE_ROOT, 'package.json'));
+    const incomingVersion = sourcePkg.version;
+
+    info(`Current:   ${installedVersion}`);
+    info(`Available: ${incomingVersion}`);
+    console.log('');
+
+    if (installedVersion !== 'unknown' && installedVersion === incomingVersion) {
+        info('✓ Already up to date.');
+        console.log('');
+        process.exit(0);
+    }
+
+    // -------------------------------------------------------------------------
+    // 3. Dry-run mode — preview changes and exit
+    // -------------------------------------------------------------------------
+
+    if (isDryRun) {
+        info('Dry run — no files will be modified.\n');
+
+        info('Upstream directories that would be replaced:');
+        for (const dir of UPSTREAM_DIRS) {
+            info(`  → ${dir}/`);
+        }
+        console.log('');
+
+        info('Structural configs that would be merged (new keys only):');
+        for (const cfg of STRUCTURAL_CONFIGS) {
+            if (existsSync(path.join(cwd, cfg))) {
+                const existing = readJson(path.join(cwd, cfg));
+                const upstream = existsSync(path.join(PACKAGE_ROOT, cfg))
+                    ? readJson(path.join(PACKAGE_ROOT, cfg))
+                    : {};
+                const {added} = deepMergeNewKeys(existing, upstream);
+                if (added.length > 0) {
+                    info(`  ${cfg}: would add ${added.length} key(s): ${added.join(', ')}`);
+                } else {
+                    info(`  ${cfg}: no new keys`);
+                }
+            }
+        }
+        console.log('');
+
+        info('Plugins that would be updated:');
+        const pluginsDirSrc = path.join(PACKAGE_ROOT, 'plugins');
+        const pluginsDirDst = path.join(cwd, 'plugins');
+        if (existsSync(pluginsDirSrc)) {
+            const upstreamPlugins = readdirSync(pluginsDirSrc, {withFileTypes: true})
+                .filter(e => e.isDirectory())
+                .map(e => e.name);
+            for (const name of upstreamPlugins) {
+                const exists = existsSync(path.join(pluginsDirDst, name));
+                info(`  → plugins/${name}/ (${exists ? 'update' : 'add'})`);
+            }
+        }
+        console.log('');
+
+        info('Package.json: CMS deps would be replaced; user-added deps preserved.');
+        console.log('');
+        process.exit(0);
+    }
+
+    // -------------------------------------------------------------------------
+    // 4. Confirmation prompt
+    // -------------------------------------------------------------------------
+
+    if (!skipConfirm) {
+        const confirmed = await confirm(`Update project from ${installedVersion} to ${incomingVersion}?`);
+        if (!confirmed) {
+            info('Update cancelled.');
+            console.log('');
+            process.exit(0);
+        }
+        console.log('');
+    }
+
+    // -------------------------------------------------------------------------
+    // 5. Backup
+    // -------------------------------------------------------------------------
+
+    let backupPath = null;
+
+    if (!skipBackup) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        backupPath = path.join(cwd, '.domma-backups', timestamp);
+        step('Creating backup');
+        mkdirSync(backupPath, {recursive: true});
+
+        // Back up upstream dirs
+        for (const dir of UPSTREAM_DIRS) {
+            const src = path.join(cwd, dir);
+            if (existsSync(src)) {
+                cpSync(src, path.join(backupPath, dir), {recursive: true});
+            }
+        }
+
+        // Back up package.json and structural configs
+        for (const f of ['package.json', ...STRUCTURAL_CONFIGS]) {
+            const src = path.join(cwd, f);
+            if (existsSync(src)) {
+                const dest = path.join(backupPath, f);
+                mkdirSync(path.dirname(dest), {recursive: true});
+                cpSync(src, dest);
+            }
+        }
+
+        // Back up plugins dir (code only, not data)
+        const pluginsDir = path.join(cwd, 'plugins');
+        if (existsSync(pluginsDir)) {
+            cpSync(pluginsDir, path.join(backupPath, 'plugins'), {recursive: true});
+        }
+
+        done();
+    } else {
+        warn('Skipping backup (--no-backup).');
+    }
+
+    // -------------------------------------------------------------------------
+    // 6. Replace upstream directories
+    // -------------------------------------------------------------------------
+
+    step('Replacing upstream code');
+    for (const dir of UPSTREAM_DIRS) {
+        const dest = path.join(cwd, dir);
+        const src = path.join(PACKAGE_ROOT, dir);
+        if (!existsSync(src)) continue;
+        if (existsSync(dest)) rmSync(dest, {recursive: true, force: true});
+        cpSync(src, dest, {recursive: true});
+    }
+    // Replace CLAUDE.md (CMS-owned guidance file)
+    const claudeMdSrc = path.join(PACKAGE_ROOT, 'CLAUDE.md');
+    if (existsSync(claudeMdSrc)) {
+        cpSync(claudeMdSrc, path.join(cwd, 'CLAUDE.md'));
+    }
+    done();
+
+    // -------------------------------------------------------------------------
+    // 7. Update plugins
+    // -------------------------------------------------------------------------
+
+    step('Updating plugins');
+    const pluginsDirSrc = path.join(PACKAGE_ROOT, 'plugins');
+    const pluginsDirDst = path.join(cwd, 'plugins');
+    const newPlugins = [];
+
+    if (existsSync(pluginsDirSrc)) {
+        mkdirSync(pluginsDirDst, {recursive: true});
+        const upstreamPlugins = readdirSync(pluginsDirSrc, {withFileTypes: true})
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+
+        for (const name of upstreamPlugins) {
+            const srcPlugin = path.join(pluginsDirSrc, name);
+            const dstPlugin = path.join(pluginsDirDst, name);
+            const isNew = !existsSync(dstPlugin);
+
+            if (isNew) {
+                // Brand-new plugin — copy wholesale, apply scaffold.reset
+                cpSync(srcPlugin, dstPlugin, {recursive: true});
+                try {
+                    const manifest = readJson(path.join(dstPlugin, 'plugin.json'));
+                    for (const {path: relPath, content} of (manifest.scaffold?.reset ?? [])) {
+                        const absPath = path.join(dstPlugin, relPath);
+                        mkdirSync(path.dirname(absPath), {recursive: true});
+                        writeFileSync(absPath, content + '\n', 'utf8');
+                    }
+                } catch { /* no manifest — skip reset */
+                }
+                newPlugins.push(name);
+            } else {
+                // Existing plugin — identify paths to preserve
+                let preservePaths = new Set(['data']);
+                try {
+                    const manifest = readJson(path.join(srcPlugin, 'plugin.json'));
+                    for (const {path: relPath} of (manifest.scaffold?.reset ?? [])) {
+                        preservePaths.add(relPath);
+                    }
+                } catch { /* no manifest */
+                }
+
+                // Back up preserved paths from current install
+                const preserved = new Map();
+                for (const rel of preservePaths) {
+                    const abs = path.join(dstPlugin, rel);
+                    if (!existsSync(abs)) continue;
+
+                    if (statSync(abs).isDirectory()) {
+                        // Preserve all files under this directory
+                        for (const f of listFiles(abs, dstPlugin)) {
+                            preserved.set(f, readFileSync(path.join(dstPlugin, f)));
+                        }
+                    } else {
+                        // scaffold.reset entry — preserve the single file
+                        preserved.set(rel, readFileSync(abs));
+                    }
+                }
+
+                // Replace plugin directory with upstream
+                rmSync(dstPlugin, {recursive: true, force: true});
+                cpSync(srcPlugin, dstPlugin, {recursive: true});
+
+                // Restore preserved files
+                for (const [rel, content] of preserved) {
+                    const abs = path.join(dstPlugin, rel);
+                    mkdirSync(path.dirname(abs), {recursive: true});
+                    writeFileSync(abs, content);
+                }
+            }
+        }
+    }
+    done();
+
+    // -------------------------------------------------------------------------
+    // 8. Register new plugins in plugins.json (disabled by default)
+    // -------------------------------------------------------------------------
+
+    const pluginsJsonPath = path.join(cwd, 'config/plugins.json');
+    if (newPlugins.length > 0 && existsSync(pluginsJsonPath)) {
+        try {
+            const pluginsCfg = readJson(pluginsJsonPath);
+            for (const name of newPlugins) {
+                if (!(name in pluginsCfg)) {
+                    pluginsCfg[name] = {enabled: false, settings: {}};
+                }
+            }
+            writeJson(pluginsJsonPath, pluginsCfg);
+        } catch { /* if plugins.json is malformed, skip */
+        }
+    }
+
+    // -------------------------------------------------------------------------
+    // 9. Merge structural configs (new keys only)
+    // -------------------------------------------------------------------------
+
+    step('Merging structural configs');
+    const mergedKeys = {};
+
+    for (const cfgFile of STRUCTURAL_CONFIGS) {
+        const dstPath = path.join(cwd, cfgFile);
+        const srcPath = path.join(PACKAGE_ROOT, cfgFile);
+        if (!existsSync(dstPath) || !existsSync(srcPath)) continue;
+
+        try {
+            const existing = readJson(dstPath);
+            const upstream = readJson(srcPath);
+            const {merged, added} = deepMergeNewKeys(existing, upstream);
+            if (added.length > 0) {
+                writeJson(dstPath, merged);
+                mergedKeys[cfgFile] = added;
+            }
+        } catch { /* malformed JSON — skip */
+        }
+    }
+    done();
+
+    // -------------------------------------------------------------------------
+    // 10. Update package.json: replace CMS deps, preserve user-added deps
+    // -------------------------------------------------------------------------
+
+    step('Updating package.json');
+    const projectPkgPath = path.join(cwd, 'package.json');
+    try {
+        const projectPkg = readJson(projectPkgPath);
+        const cmsDeps = sourcePkg.dependencies ?? {};
+        const cmsOptional = sourcePkg.optionalDependencies ?? {};
+        const userDeps = projectPkg.dependencies ?? {};
+
+        // Preserve deps the user added (not in CMS deps at time of scaffold)
+        // We identify "user-added" as: present in project but not in the new upstream CMS deps
+        const userAddedDeps = {};
+        for (const [pkg, ver] of Object.entries(userDeps)) {
+            if (!(pkg in cmsDeps) && !(pkg in cmsOptional)) {
+                userAddedDeps[pkg] = ver;
+            }
+        }
+
+        // Replace CMS scripts, but never copy prepublishOnly
+        const newScripts = {...sourcePkg.scripts};
+        delete newScripts.prepublishOnly;
+
+        projectPkg.dependencies = {...cmsDeps, ...userAddedDeps};
+        projectPkg.optionalDependencies = cmsOptional;
+        projectPkg.scripts = newScripts;
+
+        writeFileSync(projectPkgPath, JSON.stringify(projectPkg, null, 2) + '\n', 'utf8');
+    } catch { /* malformed package.json — skip */
+    }
+    done();
+
+    // -------------------------------------------------------------------------
+    // 11. Ensure .domma-backups/ is in .gitignore
+    // -------------------------------------------------------------------------
+
+    const gitignorePath = path.join(cwd, '.gitignore');
+    const backupEntry = '.domma-backups/';
+    if (existsSync(gitignorePath)) {
+        const current = readFileSync(gitignorePath, 'utf8');
+        if (!current.includes(backupEntry)) {
+            writeFileSync(gitignorePath, current.trimEnd() + '\n' + backupEntry + '\n', 'utf8');
+        }
+    } else {
+        writeFileSync(gitignorePath, backupEntry + '\n', 'utf8');
+    }
+
+    // -------------------------------------------------------------------------
+    // 12. Write updated .domma marker
+    // -------------------------------------------------------------------------
+
+    step('Updating .domma marker');
+    const newMarker = {
+        cmsVersion: incomingVersion,
+        scaffoldedAt: markerData?.scaffoldedAt ?? null,
+        lastUpdatedAt: new Date().toISOString(),
+    };
+    writeFileSync(markerPath, JSON.stringify(newMarker, null, 2) + '\n', 'utf8');
+    done();
+
+    // -------------------------------------------------------------------------
+    // 13. npm install
+    // -------------------------------------------------------------------------
+
+    console.log('');
+
+    if (skipInstall) {
+        warn('Skipping npm install (--no-install).');
+    } else {
+        info('Running npm install…');
+        console.log('');
+        const result = spawnSync('npm', ['install'], {cwd, stdio: 'inherit'});
+        if (result.status !== 0) {
+            console.error('\n  ✗ npm install failed.\n');
+            process.exit(result.status ?? 1);
+        }
+        console.log('');
+    }
+
+    // -------------------------------------------------------------------------
+    // 14. Summary
+    // -------------------------------------------------------------------------
+
+    console.log('  ┌──────────────────────────────────────────┐');
+    console.log('  │   ✓ Update complete!                     │');
+    console.log('  └──────────────────────────────────────────┘');
+    console.log('');
+
+    info(`  ${installedVersion}  →  ${incomingVersion}`);
+    console.log('');
+
+    if (backupPath) {
+        info(`Backup saved to: .domma-backups/${path.basename(backupPath)}/`);
+    }
+
+    if (newPlugins.length > 0) {
+        info(`New plugins added (disabled by default): ${newPlugins.join(', ')}`);
+    }
+
+    const allMergedKeys = Object.entries(mergedKeys);
+    if (allMergedKeys.length > 0) {
+        info('New config keys added:');
+        for (const [file, keys] of allMergedKeys) {
+            info(`  ${file}: ${keys.join(', ')}`);
+        }
+    }
+
+    console.log('');
+    info('Restart your dev server to apply changes:  npm run dev');
+    console.log('');
+}

package/config/server.json

@@ -1,6 +1,10 @@
-{
-  "port": 4096,
-    "host": "0.0.0.0",
-    "cors": { "origin": false },
-    "uploads": { "maxFileSize": 10485760 }
-}
+{
+  "port": 4096,
+    "host": "0.0.0.0",
+  "cors": {
+    "origin": false
+  },
+  "uploads": {
+    "maxFileSize": 10485760
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domma-cms",
-  "version": "0.5.4",
+  "version": "0.6.1",
   "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
   "type": "module",
   "main": "server/server.js",
@@ -22,7 +22,8 @@
     "plugins/",
     "scripts/",
     "docs/",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "CLAUDE.md"
   ],
   "scripts": {
     "build": "node scripts/build.js",

package/public/css/site.css

@@ -1 +1 @@
-body,button,input,select,textarea{font-family:Roboto,sans-serif}.site-main{min-height:calc(100vh - 60px);padding-top:2rem;padding-bottom:4rem}.site-main.with-sidebar{display:grid;grid-template-columns:260px 1fr;gap:0}.site-sidebar{min-height:100%;border-right:1px solid var(--border-color, rgba(255,255,255,.08))}.site-content{overflow:hidden}.table-responsive{overflow-x:auto;-webkit-overflow-scrolling:touch}.container{max-width:860px;margin:0 auto;padding:0 1.5rem}.page-title{font-size:2rem;font-weight:700;margin-bottom:1.5rem;line-height:1.2}.page-body{line-height:1.7;font-size:1rem}.page-body h1,.page-body h2,.page-body h3,.page-body h4{margin-top:2rem;margin-bottom:.75rem;font-weight:600}.page-body h2{font-size:1.5rem}.page-body h3{font-size:1.25rem}.page-body p{margin-bottom:1rem}.page-body ul,.page-body ol{margin-bottom:1rem;padding-left:1.5rem}.page-body a{color:var(--primary, #5b8cff)}.page-body a:hover{text-decoration:underline}.page-body code{font-family:Fira Code,Courier New,monospace;font-size:.9em;background:#ffffff0f;padding:.15em .35em;border-radius:3px}.page-body pre{background:#0000004d;border:1px solid rgba(255,255,255,.08);border-radius:6px;padding:1rem;overflow-x:auto;margin-bottom:1rem}.page-body pre code{background:none;padding:0}.page-body img{max-width:100%;border-radius:6px}.page-body blockquote{border-left:3px solid var(--primary, #5b8cff);margin:1.5rem 0;padding:.75rem 1rem;background:#5b8cff0f;border-radius:0 6px 6px 0}h3.accordion-header{margin:0}.accordion-button{all:unset;display:flex;align-items:center;justify-content:space-between;width:100%;cursor:pointer;font:inherit}.page-body .card-header h2{margin:0;font-size:1rem;font-weight:600;line-height:1.4}.card[data-collapsible] .card-header{cursor:pointer;user-select:none;display:flex;align-items:center;justify-content:space-between}.card[data-collapsible] .card-header:after{content:"\25be";font-size:1.1em;line-height:1;display:inline-block;transition:transform .25s ease;flex-shrink:0}.card[data-collapsible].is-collapsed .card-header:after{transform:rotate(-90deg)}.card[data-collapsible] .card-body{overflow:hidden;max-height:4000px;opacity:1;transition:max-height .3s ease,opacity .25s ease}.card[data-collapsible].is-collapsed .card-body{max-height:0;opacity:0}.navbar-link span[data-icon],.navbar-link svg,.navbar-dropdown-toggle span[data-icon],.navbar-dropdown-toggle svg,.navbar-dropdown-item span[data-icon],.navbar-dropdown-item svg{width:13px!important;height:13px!important;margin-right:10px!important}.navbar-dropdown-toggle{font-size:var(--dm-font-size-base)}@media(min-width:993px){.navbar-dropdown-toggle{font-size:var(--dm-font-size-sm)}}@media(min-width:1201px){.navbar-dropdown-toggle{font-size:var(--dm-font-size-xs)}}.dm-reduced-motion *,.dm-reduced-motion *:before,.dm-reduced-motion *:after{animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important;scroll-behavior:auto!important}.page-footer{border-top:1px solid var(--border-color, rgba(255,255,255,.08));padding:1.5rem 0}.footer-inner{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:1rem}.footer-inner p{margin:0;color:var(--text-muted, #888);font-size:.875rem}.footer-links{display:flex;gap:1.25rem}.footer-links a{color:var(--text-muted, #888);font-size:.875rem;text-decoration:none}.footer-links a:hover{color:var(--text, #eee)}.footer-social{display:flex;gap:.5rem;align-items:center}.footer-social-link{display:inline-flex;align-items:center;justify-content:center;width:1.75rem;height:1.75rem;color:var(--text-muted, #888);transition:color .15s}.footer-social-link:hover{color:var(--text, #eee)}.footer-social-link svg{width:1rem;height:1rem}.footer-motion-switch{font-size:.8rem;color:var(--text-muted, #888);white-space:nowrap}.footer-motion-switch .form-switch-label{color:var(--text-muted, #888)}.footer-motion-switch .form-switch-input{width:2rem;height:1.125rem}.footer-motion-switch .form-switch-input:after{width:.875rem;height:.875rem}.footer-motion-switch .form-switch-input:checked:after{transform:translate(.875rem)}.dm-slideover-header{display:flex;align-items:center;justify-content:space-between;padding:.875rem 1.25rem;border-bottom:1px solid var(--border-color, rgba(255, 255, 255, .08));flex-shrink:0}.dm-slideover-title{margin:0;font-size:1rem;font-weight:600;line-height:1.4}.dm-slideover-body{padding:1.25rem;overflow-y:auto;flex:1}@media(max-width:768px){.site-main.with-sidebar{grid-template-columns:1fr}.site-sidebar{display:none}}.dm-spacer{display:block;width:100%}.hero-breakout{width:calc(100vw - 2rem);margin-left:calc(50% - 50vw + 1rem);margin-right:calc(50% - 50vw + 1rem)}.site-main:has(.page-body>.hero-breakout:first-child){padding-top:0}body[data-layout=landing]>.site-main{padding-top:0}body[data-layout=landing]>.site-main .container{max-width:none;padding:0}body[data-layout=landing] .page-body{padding-left:1.5rem;padding-right:1.5rem}body[data-layout=landing] .page-body>p,body[data-layout=landing] .page-body>h1,body[data-layout=landing] .page-body>h2,body[data-layout=landing] .page-body>h3,body[data-layout=landing] .page-body>ul,body[data-layout=landing] .page-body>ol,body[data-layout=landing] .page-body>blockquote{max-width:860px;margin-left:auto;margin-right:auto}body[data-layout=landing] .page-body .hero-breakout{width:calc(100% + 3rem);margin-left:-1.5rem;margin-right:-1.5rem}body[data-layout=landing] .page-body .grid-breakout{width:calc(100% + 3rem);margin-left:-1.5rem;margin-right:-1.5rem;padding-left:1.5rem;padding-right:1.5rem}.page-body .card{transition:transform .2s ease,box-shadow .2s ease}.page-body .card:hover{transform:translateY(-3px);box-shadow:0 8px 24px #00000059}.page-body .card-header-icon-inline{display:flex;align-items:center;gap:.6rem}.page-body .card-header-icon-inline [data-icon]{flex-shrink:0;line-height:0}.page-body .card-header-icon-inline [data-icon] svg,.page-body .card-header-icon-inline>svg{display:block;width:1.25rem;height:1.25rem}.page-body .card-header-icon-stacked{display:flex;flex-direction:column;align-items:center;text-align:center;gap:.35rem;padding-top:.25rem}.page-body .card-header-icon-stacked [data-icon],.page-body .card-header-icon-stacked svg{width:2rem;height:2rem}.hero.hero-dark{background:linear-gradient(135deg,#1f2937,#111827);color:#e2e8f0}.hero .hero-content{position:relative;z-index:2}.hero.hero-left .hero-content{text-align:left;align-items:flex-start;max-width:62%}@media(max-width:768px){.hero.hero-left .hero-content{max-width:100%}}.hero .hero-cta{display:flex;gap:.85rem;flex-wrap:wrap;margin-top:1.75rem}.hero .hero-cta a{display:inline-flex;align-items:center;gap:.4rem;padding:.55rem 1.35rem;border-radius:6px;font-size:.95rem;font-weight:500;text-decoration:none;transition:background .2s ease,border-color .2s ease,transform .15s ease,box-shadow .2s ease}.hero .hero-cta a:first-child{background:#ffffffeb;color:#111;border:1px solid transparent}.hero .hero-cta a:first-child:hover{background:#fff;box-shadow:0 4px 16px #00000040;transform:translateY(-2px)}.hero .hero-cta a:last-child{background:transparent;color:#fff;border:1px solid rgba(255,255,255,.4)}.hero .hero-cta a:last-child:hover{border-color:#ffffffbf;background:#ffffff14;transform:translateY(-2px)}.hero .hero-label{display:inline-block;margin-bottom:.9rem;padding:.2rem .8rem;border-radius:999px;font-size:.72rem;font-weight:600;letter-spacing:.07em;text-transform:uppercase;color:#ffffffb3;border:1px solid rgba(255,255,255,.22)}.grid-breakout{width:calc(100vw - 2rem);margin-left:calc(50% - 50vw + 1rem);margin-right:calc(50% - 50vw + 1rem)}.dm-breadcrumbs{position:fixed;z-index:200;display:inline-flex;align-items:center;gap:.2rem;padding:.3rem .8rem;border-radius:999px;backdrop-filter:blur(14px);-webkit-backdrop-filter:blur(14px);background:#00000047;border:1px solid rgba(255,255,255,.11);box-shadow:0 2px 10px #00000038;font-size:.72rem;font-weight:500;letter-spacing:.01em;line-height:1.4;max-width:calc(100vw - 2rem);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.dm-breadcrumbs .dm-breadcrumbs-item{color:#ffffffa6}.dm-breadcrumbs .dm-breadcrumbs-link{display:inline-flex;align-items:center;gap:.25rem;color:#ffffff8c;text-decoration:none;transition:color .15s}.dm-breadcrumbs .dm-breadcrumbs-home-icon{flex-shrink:0;vertical-align:middle}.dm-breadcrumbs .dm-breadcrumbs-link:hover{color:#fffffff2}.dm-breadcrumbs .dm-breadcrumbs-current{color:#ffffffeb;font-weight:600}.dm-breadcrumbs .dm-breadcrumbs-separator{color:#ffffff47;font-size:.8em;line-height:1;margin:0 .05rem}[data-mode=light] .dm-breadcrumbs{background:#ffffff8c;border-color:#00000012;box-shadow:0 2px 10px #00000014}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-item,[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-link{color:#0000008c}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-link:hover{color:#000000e6}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-current{color:#000000d9}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-separator{color:#00000040}.dm-collection-display{margin:1.5rem 0}.dm-collection-list{display:flex;flex-direction:column;gap:0}.dm-collection-list-item{padding:1rem 0;border-bottom:1px solid var(--border-color, rgba(255, 255, 255, .08))}.dm-collection-list-item:last-child{border-bottom:none}.dm-collection-list-item strong{display:block;font-size:1rem;margin-bottom:.25rem}.dm-collection-list-item p{margin:0;color:var(--text-muted, #888);font-size:.9rem}.dm-collection-empty p{color:var(--text-muted, #888);font-style:italic}
+body,button,input,select,textarea{font-family:Roboto,sans-serif}.site-main{min-height:calc(100vh - 60px);padding-top:2rem;padding-bottom:4rem}.site-main.with-sidebar{display:grid;grid-template-columns:260px 1fr;gap:0}.site-sidebar{min-height:100%;border-right:1px solid var(--border-color, rgba(255,255,255,.08))}.site-content{overflow:hidden}.table-responsive{overflow-x:auto;-webkit-overflow-scrolling:touch}.container{max-width:860px;margin:0 auto;padding:0 1.5rem}.page-title{font-size:2rem;font-weight:700;margin-bottom:1.5rem;line-height:1.2}.page-body{line-height:1.7;font-size:1rem}.page-body h1,.page-body h2,.page-body h3,.page-body h4{margin-top:2rem;margin-bottom:.75rem;font-weight:600}.page-body h2{font-size:1.5rem}.page-body h3{font-size:1.25rem}.page-body p{margin-bottom:1rem}.page-body ul,.page-body ol{margin-bottom:1rem;padding-left:1.5rem}.page-body a{color:var(--primary, #5b8cff)}.page-body a:hover{text-decoration:underline}.page-body code{font-family:Fira Code,Courier New,monospace;font-size:.9em;background:#ffffff0f;padding:.15em .35em;border-radius:3px}.page-body pre{background:#0000004d;border:1px solid rgba(255,255,255,.08);border-radius:6px;padding:1rem;overflow-x:auto;margin-bottom:1rem}.page-body pre code{background:none;padding:0}.page-body img{max-width:100%;border-radius:6px}.page-body blockquote{border-left:3px solid var(--primary, #5b8cff);margin:1.5rem 0;padding:.75rem 1rem;background:#5b8cff0f;border-radius:0 6px 6px 0}h3.accordion-header{margin:0}.accordion-button{all:unset;display:flex;align-items:center;justify-content:space-between;width:100%;cursor:pointer;font:inherit}.page-body .card-header h2{margin:0;font-size:1rem;font-weight:600;line-height:1.4}.card[data-collapsible] .card-header{cursor:pointer;user-select:none;display:flex;align-items:center;justify-content:space-between}.card[data-collapsible] .card-header:after{content:"\25be";font-size:1.1em;line-height:1;display:inline-block;transition:transform .25s ease;flex-shrink:0}.card[data-collapsible].is-collapsed .card-header:after{transform:rotate(-90deg)}.card[data-collapsible] .card-body{overflow:hidden;max-height:4000px;opacity:1;transition:max-height .3s ease,opacity .25s ease}.card[data-collapsible].is-collapsed .card-body{max-height:0;opacity:0}.navbar-link span[data-icon],.navbar-link svg,.navbar-dropdown-toggle span[data-icon],.navbar-dropdown-toggle svg,.navbar-dropdown-item span[data-icon],.navbar-dropdown-item svg{width:13px!important;height:13px!important;margin-right:10px!important}.navbar-dropdown-toggle{font-size:var(--dm-font-size-base)}@media(min-width:993px){.navbar-dropdown-toggle{font-size:var(--dm-font-size-sm)}}@media(min-width:1201px){.navbar-dropdown-toggle{font-size:var(--dm-font-size-xs)}}.dm-reduced-motion *,.dm-reduced-motion *:before,.dm-reduced-motion *:after{animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important;scroll-behavior:auto!important}.page-footer{border-top:1px solid var(--border-color, rgba(255,255,255,.08));padding:1.5rem 0}.footer-inner{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:1rem}.footer-inner p{margin:0;color:var(--text-muted, #888);font-size:.875rem}.footer-links{display:flex;gap:1.25rem}.footer-links a{color:var(--text-muted, #888);font-size:.875rem;text-decoration:none}.footer-links a:hover{color:var(--text, #eee)}.footer-social{display:flex;gap:.5rem;align-items:center}.footer-social-link{display:inline-flex;align-items:center;justify-content:center;width:1.75rem;height:1.75rem;color:var(--text-muted, #888);transition:color .15s}.footer-social-link:hover{color:var(--text, #eee)}.footer-social-link svg{width:1rem;height:1rem}.footer-motion-switch{font-size:.8rem;color:var(--text-muted, #888);white-space:nowrap}.footer-motion-switch .form-switch-label{color:var(--text-muted, #888)}.footer-motion-switch .form-switch-input{width:2rem;height:1.125rem}.footer-motion-switch .form-switch-input:after{width:.875rem;height:.875rem}.footer-motion-switch .form-switch-input:checked:after{transform:translate(.875rem)}.dm-slideover-header{display:flex;align-items:center;justify-content:space-between;padding:.875rem 1.25rem;border-bottom:1px solid var(--border-color, rgba(255, 255, 255, .08));flex-shrink:0}.dm-slideover-title{margin:0;font-size:1rem;font-weight:600;line-height:1.4}.dm-slideover-body{padding:1.25rem;overflow-y:auto;flex:1}@media(max-width:768px){.site-main.with-sidebar{grid-template-columns:1fr}.site-sidebar{display:none}}.dm-spacer{display:block;width:100%}.hero-breakout{width:calc(100vw - 2rem);margin-left:calc(50% - 50vw + 1rem);margin-right:calc(50% - 50vw + 1rem)}.site-main:has(.page-body>.hero-breakout:first-child){padding-top:0}body[data-layout=landing]>.site-main{padding-top:0}body[data-layout=landing]>.site-main .container{max-width:none;padding:0}body[data-layout=landing] .page-body{padding-left:1.5rem;padding-right:1.5rem}body[data-layout=landing] .page-body>p,body[data-layout=landing] .page-body>h1,body[data-layout=landing] .page-body>h2,body[data-layout=landing] .page-body>h3,body[data-layout=landing] .page-body>ul,body[data-layout=landing] .page-body>ol,body[data-layout=landing] .page-body>blockquote{max-width:860px;margin-left:auto;margin-right:auto}body[data-layout=landing] .page-body .hero-breakout{width:calc(100% + 3rem);margin-left:-1.5rem;margin-right:-1.5rem}body[data-layout=landing] .page-body .grid-breakout{width:calc(100% + 3rem);margin-left:-1.5rem;margin-right:-1.5rem;padding-left:1.5rem;padding-right:1.5rem}.page-body .card{transition:transform .2s ease,box-shadow .2s ease}.page-body .card:hover{transform:translateY(-3px);box-shadow:0 8px 24px #00000059}.page-body .card-header-icon-inline{display:flex;align-items:center;gap:.6rem}.page-body .card-header-icon-inline [data-icon]{flex-shrink:0;line-height:0}.page-body .card-header-icon-inline [data-icon] svg,.page-body .card-header-icon-inline>svg{display:block;width:1.25rem;height:1.25rem}.page-body .card-header-icon-stacked{display:flex;flex-direction:column;align-items:center;text-align:center;gap:.35rem;padding-top:.25rem}.page-body .card-header-icon-stacked [data-icon],.page-body .card-header-icon-stacked svg{width:2rem;height:2rem}.hero.hero-dark{background:linear-gradient(135deg,#1f2937,#111827);color:#e2e8f0}.hero .hero-content{position:relative;z-index:2}.hero.hero-left .hero-content{text-align:left;align-items:flex-start;max-width:62%}@media(max-width:768px){.hero.hero-left .hero-content{max-width:100%}}.hero .hero-cta{display:flex;gap:.85rem;flex-wrap:wrap;margin-top:1.75rem}.hero .hero-cta a{display:inline-flex;align-items:center;gap:.4rem;padding:.55rem 1.35rem;border-radius:6px;font-size:.95rem;font-weight:500;text-decoration:none;transition:background .2s ease,border-color .2s ease,transform .15s ease,box-shadow .2s ease}.hero .hero-cta a:first-child{background:#ffffffeb;color:#111;border:1px solid transparent}.hero .hero-cta a:first-child:hover{background:#fff;box-shadow:0 4px 16px #00000040;transform:translateY(-2px)}.hero .hero-cta a:last-child{background:transparent;color:#fff;border:1px solid rgba(255,255,255,.4)}.hero .hero-cta a:last-child:hover{border-color:#ffffffbf;background:#ffffff14;transform:translateY(-2px)}.hero .hero-label{display:inline-block;margin-bottom:.9rem;padding:.2rem .8rem;border-radius:999px;font-size:.72rem;font-weight:600;letter-spacing:.07em;text-transform:uppercase;color:#ffffffb3;border:1px solid rgba(255,255,255,.22)}.grid-breakout{width:calc(100vw - 2rem);margin-left:calc(50% - 50vw + 1rem);margin-right:calc(50% - 50vw + 1rem)}.dm-breadcrumbs{position:fixed;z-index:200;display:inline-flex;align-items:center;gap:.2rem;padding:.3rem .8rem;border-radius:999px;backdrop-filter:blur(14px);-webkit-backdrop-filter:blur(14px);background:#00000047;border:1px solid rgba(255,255,255,.11);box-shadow:0 2px 10px #00000038;font-size:.72rem;font-weight:500;letter-spacing:.01em;line-height:1.4;max-width:calc(100vw - 2rem);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.dm-breadcrumbs .dm-breadcrumbs-item{color:#ffffffa6}.dm-breadcrumbs .dm-breadcrumbs-link{display:inline-flex;align-items:center;gap:.25rem;color:#ffffff8c;text-decoration:none;transition:color .15s}.dm-breadcrumbs .dm-breadcrumbs-home-icon{flex-shrink:0;vertical-align:middle}.dm-breadcrumbs .dm-breadcrumbs-link:hover{color:#fffffff2}.dm-breadcrumbs .dm-breadcrumbs-current{color:#ffffffeb;font-weight:600}.dm-breadcrumbs .dm-breadcrumbs-separator{color:#ffffff47;font-size:.8em;line-height:1;margin:0 .05rem}[data-mode=light] .dm-breadcrumbs{background:#ffffff8c;border-color:#00000012;box-shadow:0 2px 10px #00000014}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-item,[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-link{color:#0000008c}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-link:hover{color:#000000e6}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-current{color:#000000d9}[data-mode=light] .dm-breadcrumbs .dm-breadcrumbs-separator{color:#00000040}.dm-collection-display{margin:1.5rem 0}.dm-collection-list{display:flex;flex-direction:column;gap:0}.dm-collection-list-item{padding:1rem 0;border-bottom:1px solid var(--border-color, rgba(255, 255, 255, .08))}.dm-collection-list-item:last-child{border-bottom:none}.dm-collection-list-item strong{display:block;font-size:1rem;margin-bottom:.25rem}.dm-collection-list-item p{margin:0;color:var(--text-muted, #888);font-size:.9rem}.dm-collection-empty p{color:var(--text-muted, #888);font-style:italic}.hero-gradient-purple{background:linear-gradient(135deg,#ede9fe,#ddd6fe);color:#1e1b4b}.hero-gradient-blue{background:linear-gradient(135deg,#dbeafe,#bfdbfe);color:#1e3a5f}.hero-gradient-green{background:linear-gradient(135deg,#d1fae5,#a7f3d0);color:#064e3b}.hero-gradient-sunset{background:linear-gradient(135deg,#fef3c7,#fde68a);color:#78350f}.hero-gradient-ocean{background:linear-gradient(135deg,#e0f2fe,#bae6fd);color:#0c4a6e}.hero-gradient-rose{background:linear-gradient(135deg,#fce7f3,#fbcfe8);color:#831843}.hero-gradient-forest{background:linear-gradient(135deg,#dcfce7,#bbf7d0);color:#14532d}.hero-gradient-night{background:linear-gradient(135deg,#334155,#1e293b);color:#e2e8f0}.hero-gradient-ocean-light{background:linear-gradient(135deg,#e0f2fe,#caf0f8);color:#1e293b}.hero-gradient-ocean-dark{background:linear-gradient(135deg,#0c4a6e,#164e63);color:#e2e8f0}.hero-gradient-forest-light{background:linear-gradient(135deg,#d1fae5,#c6f6dc);color:#1e293b}.hero-gradient-forest-dark{background:linear-gradient(135deg,#1a4731,#166534);color:#e2e8f0}.hero-gradient-sunset-light{background:linear-gradient(135deg,#fde8d8,#fddcc9);color:#1e293b}.hero-gradient-sunset-dark{background:linear-gradient(135deg,#6b3727,#7c4036);color:#f5ede8}.hero-gradient-royal-light{background:linear-gradient(135deg,#e8f0fd,#dce8fc);color:#1e293b}.hero-gradient-royal-dark{background:linear-gradient(135deg,#1e3465,#263d7a);color:#e2e8f0}.hero-gradient-lemon-light{background:linear-gradient(135deg,#fefce8,#fef9c3);color:#1e293b}.hero-gradient-lemon-dark{background:linear-gradient(135deg,#5c4d1a,#6b5920);color:#fefce8}.hero-gradient-silver-light{background:linear-gradient(135deg,#f1f5f9,#e2e8f0);color:#1e293b}.hero-gradient-silver-dark{background:linear-gradient(135deg,#2d3748,#374151);color:#e2e8f0}.hero-gradient-charcoal-light{background:linear-gradient(135deg,#eceff1,#e1e7eb);color:#1e293b}.hero-gradient-charcoal-dark{background:linear-gradient(135deg,#2c3843,#374451);color:#e2e8f0}.hero-gradient-christmas-light{background:linear-gradient(135deg,#fde8ea,#fdd5d8);color:#1e293b}.hero-gradient-christmas-dark{background:linear-gradient(135deg,#5c0f1d,#7a1525);color:#fde8ea}.hero-gradient-unicorn-light{background:linear-gradient(135deg,#f5e8fd,#edd6fb);color:#1e293b}.hero-gradient-unicorn-dark{background:linear-gradient(135deg,#3d1a5a,#4a2068);color:#f5e8fd}.hero-gradient-dreamy-light{background:linear-gradient(135deg,#f5ede8,#eeddd4);color:#1e293b}.hero-gradient-dreamy-dark{background:linear-gradient(135deg,#3d2820,#503328);color:#f5ede8}.hero-gradient-grayve-light{background:linear-gradient(135deg,#e0f7f9,#cbf2f5);color:#1e293b}.hero-gradient-grayve-dark{background:linear-gradient(135deg,#00363d,#00444d);color:#e0f7f9}.hero-gradient-mint-light{background:linear-gradient(135deg,#d8f5ea,#c5efdd);color:#1e293b}.hero-gradient-mint-dark{background:linear-gradient(135deg,#134d33,#195f3f);color:#d8f5ea}.hero-gradient-wedding-light{background:linear-gradient(135deg,#faf3e0,#f5e9c7);color:#1e293b}.hero-gradient-wedding-dark{background:linear-gradient(135deg,#5c4418,#6f5320);color:#faf3e0}

package/server/services/markdown.js

@@ -964,8 +964,14 @@ function processTableBlocks(markdown) {
  *   title   - Hero heading (.hero-title)
  *   tagline - Subtitle text (.hero-subtitle)
  *   size    - "sm", "lg", "full" → .hero-sm / .hero-lg / .hero-full
- *   variant - "dark", "primary", "gradient-blue", "gradient-purple",
- *             "gradient-sunset", "gradient-ocean" → .hero-{variant}
+ *   variant - "dark", "primary",
+ *             upstream 8: "gradient-purple", "gradient-blue", "gradient-green",
+ *               "gradient-sunset", "gradient-ocean", "gradient-rose",
+ *               "gradient-forest", "gradient-night"
+ *             theme-specific (26): "gradient-{theme}-{mode}" where theme is one of
+ *               ocean, forest, sunset, royal, lemon, silver, charcoal, christmas,
+ *               unicorn, dreamy, grayve, mint, wedding — and mode is light or dark
+ *             → .hero-{variant}
  *   image   - URL for background-image + adds .hero-cover
  *   overlay - "light", "dark", "darker", "gradient", "gradient-reverse" → .hero-overlay-{overlay}
  *   align   - "center" (default) or "left" → .hero-center / .hero-left