@tinyvolt/pie 0.0.0-stage → 0.2.0

package/src/routes/pages/index.tsx

@@ -0,0 +1,20 @@
+import { For } from 'solid-js';
+import { PageMeta } from '~/components/PageMeta';
+import { slugs } from '~/lib/markdown/pages';
+
+export default function Pages() {
+  return (
+    <main>
+      <PageMeta title="Pages" />
+      <ul>
+        <For each={slugs}>
+          {slug => (
+            <li>
+              <a href={`/${slug}`}>{slug}</a>
+            </li>
+          )}
+        </For>
+      </ul>
+    </main>
+  );
+}

package/styles/theme.css

@@ -0,0 +1,27 @@
+/*
+ * Site theme. Change these values to restyle the site.
+ * Every `.css` file in `/styles` loads after the built-in `src/app.css`,
+ * so rules added here (or in another file in this folder) override the defaults.
+ */
+:root {
+  /* Colors */
+  --color-text: #1a1a1a;
+  --color-bg: #fff;
+  --color-muted: #555;       /* nav links, blockquotes */
+  --color-subtle: #666;      /* buttons, editor status and notes */
+  --color-hover: #000;       /* links and buttons on hover */
+  --color-border: #ddd;
+  --color-border-hover: #999;
+  --color-code-bg: #f4f4f4;
+  --color-error: #c00;
+
+  /* Fonts */
+  --font-ui: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;   /* header, editor */
+  --font-body: Georgia, "Times New Roman", serif;                        /* page text */
+  --font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; /* code */
+  --font-size-body: 1.125rem;
+  --line-height: 1.6;
+
+  /* Layout */
+  --content-width: 40rem;    /* page text column, about 70 characters */
+}

package/vite.ts

@@ -0,0 +1,96 @@
+// `pie()`: every Vite plugin a pie-ssg site needs. A site's `vite.config.ts` is `plugins: [pie()]`.
+import fs from 'node:fs';
+import path from 'node:path';
+import type { Plugin, PluginOption } from 'vite';
+import { nitro } from 'nitro/vite';
+import type { NitroModule } from 'nitro/types';
+import { solidStart } from '@solidjs/start/config';
+import { APP_DIR } from './src/lib/appDir';
+import { checkPageRoutes, markdownPages } from './src/lib/markdown/vitePlugin';
+import { checkFunctions } from './src/lib/nodes/functions/vitePlugin';
+import { checkLayouts } from './src/lib/layouts/vitePlugin';
+import { parseSite, siteConfig } from './src/lib/site/vitePlugin';
+
+/**
+ * `~/...` in a site's own files (`functions/`, `nodes/`, `layouts/`) means the app's `src/`.
+ * SolidStart's `~` alias skips files outside the app's package, which a site's files are.
+ */
+function siteAlias(): Plugin {
+  return {
+    name: 'pie-site-alias',
+    enforce: 'pre',
+    async resolveId(id, importer, options) {
+      if (id !== '~' && !id.startsWith('~/')) return null;
+      const target = path.join(APP_DIR, id.slice(1));
+      return (await this.resolve(target, importer, { ...options, skipSelf: true })) ?? target;
+    },
+  };
+}
+
+/** Pre-bundles SolidStart's `@jridgewell/trace-mapping`, reached through `@tinyvolt/pie` in a site. */
+function optimizeDeps(): Plugin {
+  return {
+    name: 'pie-optimize-deps',
+    config(config) {
+      const inRepo = path.resolve(config.root ?? process.cwd()) === path.dirname(APP_DIR);
+      const dep = '@solidjs/start > @jridgewell/trace-mapping';
+      return { optimizeDeps: { include: [inRepo ? dep : `@tinyvolt/pie > ${dep}`] } };
+    },
+  };
+}
+
+/**
+ * Bundles one copy of `solid-js`: the site's. `@solidjs/start` can install its own, newer copy,
+ * and two copies in the browser break `<Suspense>` ("Cannot read properties of null (reading 'push')").
+ */
+function dedupeSolid(): Plugin {
+  return {
+    name: 'pie-dedupe-solid',
+    config() {
+      return { resolve: { dedupe: ['solid-js'] } };
+    },
+  };
+}
+
+/**
+ * After prerendering, writes `sitemap.xml` (every prerendered page) and `robots.txt` (pointing to it).
+ * Both need `site.yml`'s `url`; without it they are skipped with a warning. A site's own `public/` file wins.
+ */
+function seoFiles(): NitroModule {
+  return {
+    name: 'pie-seo-files',
+    setup(nitro) {
+      nitro.hooks.hook('prerender:done', ({ prerenderedRoutes }) => {
+        const { url } = parseSite('site.yml', fs.readFileSync(path.join(nitro.options.rootDir, 'site.yml'), 'utf8'));
+        if (!url) {
+          nitro.logger.warn('site.yml has no `url`: skipped sitemap.xml, robots.txt, canonical links and og:url. Add e.g. `url: https://example.com` before deploying.');
+          return;
+        }
+        const pages = prerenderedRoutes.filter(route => route.fileName?.endsWith('.html')).map(route => route.route).sort();
+        const escape = (s: string) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        const write = (name: string, contents: string) => {
+          const file = path.join(nitro.options.output.publicDir, name);
+          if (!fs.existsSync(file)) fs.writeFileSync(file, contents);
+        };
+        write('sitemap.xml', [
+          '<?xml version="1.0" encoding="UTF-8"?>',
+          '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+          ...pages.map(page => `  <url><loc>${escape(url + page)}</loc></url>`),
+          '</urlset>',
+          '',
+        ].join('\n'));
+        write('robots.txt', `User-agent: *\nAllow: /\n\nSitemap: ${url}/sitemap.xml\n`);
+      });
+    },
+  };
+}
+
+export function pie(): PluginOption[] {
+  return [
+    siteAlias(), optimizeDeps(), dedupeSolid(),
+    markdownPages(), checkPageRoutes(), checkFunctions(), checkLayouts(), siteConfig(),
+    // SolidStart resolves `appRoot` against the working directory.
+    solidStart({ appRoot: path.relative(process.cwd(), APP_DIR) }),
+    nitro({ prerender: { crawlLinks: true, routes: ['/', '/pages'] }, modules: [seoFiles()] }),
+  ];
+}