pagelathe 0.1.0

package/dist/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  buildProgram,
+  cli
+} from "./chunk-LRG7WLGI.js";
+export {
+  buildProgram,
+  cli
+};

package/dist/registry/app/astro.config.mjs

@@ -0,0 +1,7 @@
+import { defineConfig } from "astro/config";
+import tailwind from "@tailwindcss/vite";
+
+export default defineConfig({
+  site: "https://example.com",
+  vite: { plugins: [tailwind()] },
+});

package/dist/registry/app/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@pagelathe/app-engine",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "prebuild": "node ./scripts/vendor-sections.mjs",
+    "build": "astro build",
+    "preview": "astro preview",
+    "clean:sections": "node ./scripts/vendor-sections.mjs --clean"
+  },
+  "dependencies": {
+    "astro": "6.4.8",
+    "@tailwindcss/vite": "4.3.1",
+    "tailwindcss": "4.3.1",
+    "shiki": "^1.29.2",
+    "zod": "^3.24.1"
+  },
+  "comment": "Build-toolchain versions are pinned exactly and vite is overridden to a tested release so a freshly-installed scaffold reproduces a working Astro + Tailwind v4 build (avoids a @tailwindcss/vite <-> vite/rolldown binding mismatch on newer floating versions).",
+  "overrides": {
+    "vite": "7.3.5"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "7.3.5"
+    }
+  }
+}

package/dist/registry/app/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32">
+  <rect width="32" height="32" rx="6" fill="#3a6463"/>
+  <text x="16" y="22" font-size="18" text-anchor="middle" fill="#fafafa" font-family="sans-serif">B</text>
+</svg>

package/dist/registry/app/scripts/vendor-sections.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * vendor-sections.mjs
+ *
+ * Copies registry/sections/<type>/section.astro into
+ * registry/app/src/components/sections/<type>.astro (flattened).
+ *
+ * Run with --clean to remove vendored copies (keeping .gitkeep).
+ *
+ * NOTE: The vendored .astro files contain `import type { propsSchema } from "./schema.js"`.
+ * That import is type-only and is erased at build by esbuild under verbatimModuleSyntax —
+ * the missing ./schema.js is never resolved at build time.
+ */
+
+import { copyFileSync, existsSync, rmSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { join, dirname } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const appRoot = join(__dirname, "..");
+const sectionsRoot = join(appRoot, "..", "sections");
+const destDir = join(appRoot, "src", "components", "sections");
+
+// The 7 R-set section types (mirrors sectionModules order in registry.ts)
+const SECTION_TYPES = ["hero", "header", "footer", "features", "codeDemo", "pricing", "finalCta"];
+
+const isClean = process.argv.includes("--clean");
+
+if (isClean) {
+  for (const type of SECTION_TYPES) {
+    const dest = join(destDir, `${type}.astro`);
+    if (existsSync(dest)) {
+      rmSync(dest);
+      console.log(`[vendor-sections] removed ${type}.astro`);
+    }
+  }
+  console.log("[vendor-sections] clean done");
+} else {
+  for (const type of SECTION_TYPES) {
+    const src = join(sectionsRoot, type, "section.astro");
+    const dest = join(destDir, `${type}.astro`);
+    if (!existsSync(src)) {
+      console.error(`[vendor-sections] ERROR: source not found: ${src}`);
+      process.exit(1);
+    }
+    copyFileSync(src, dest);
+    console.log(`[vendor-sections] copied ${type}.astro`);
+  }
+  console.log("[vendor-sections] done");
+}

package/dist/registry/app/src/components/SectionRenderer.astro

@@ -0,0 +1,23 @@
+---
+interface Props {
+  type: string;
+  props: Record<string, unknown>;
+}
+const { type, props } = Astro.props;
+
+const modules = import.meta.glob("./sections/*.astro", { eager: true }) as Record<
+  string,
+  { default: unknown }
+>;
+const entry = modules[`./sections/${type}.astro`];
+const Component = entry?.default as
+  | ((props: Record<string, unknown>) => unknown)
+  | undefined;
+if (!Component) {
+  console.warn(
+    `[pagelathe] unknown section type "${type}" — no component at ./sections/${type}.astro`,
+  );
+}
+---
+
+{Component ? <Component {...props} /> : null}

package/dist/registry/app/src/content/_schema.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+
+/**
+ * Envelope schema for the landing document. The pagelathe CLI validates every
+ * section's props against its strict per-section schema at generation time;
+ * this app-side schema validates document STRUCTURE so the project builds with
+ * only public dependencies (no private @pagelathe/* package required).
+ */
+export const pageDocumentSchema = z.object({
+  meta: z.object({
+    title: z.string().min(1),
+    description: z.string().min(1),
+    locales: z.array(z.string()).min(1).default(["en"]),
+    primaryGoal: z.string().default("signup"),
+  }),
+  theme: z.object({ tokens: z.record(z.string()).default({}) }).default({ tokens: {} }),
+  archetype: z.string().default("general"),
+  sections: z
+    .array(
+      z.object({
+        type: z.string().min(1),
+        id: z.string().min(1),
+        props: z.record(z.unknown()),
+      }),
+    )
+    .min(1),
+});

package/dist/registry/app/src/content/landing/index.yaml

@@ -0,0 +1,135 @@
+meta:
+  title: "Branchy — Postgres branching for teams"
+  description: "Spin up an isolated database branch per pull request in one command."
+  locales: ["en"]
+  primaryGoal: signup
+theme:
+  tokens:
+    colorPrimary: "#3A6463"
+    radius: "0.5rem"
+    font: "Inter"
+archetype: sdk-infra
+sections:
+  - type: header
+    id: header-1
+    props:
+      brand: "Branchy"
+      links:
+        - label: "Docs"
+          href: "/docs"
+        - label: "Pricing"
+          href: "#pricing"
+      github:
+        href: "https://github.com"
+        stars: "4.2k"
+      cta:
+        label: "Start free"
+        href: "#get-started"
+
+  - type: hero
+    id: hero-1
+    props:
+      variant: code-snippet
+      eyebrow: "Open source"
+      headline: "Postgres branching for teams"
+      subhead: "Spin up an isolated database branch per pull request in one command."
+      ctas:
+        - label: "Start free"
+          href: "#get-started"
+          style: primary
+        - label: "View on GitHub"
+          href: "https://github.com"
+          style: secondary
+      code:
+        lang: bash
+        source: "npx branchy create --from main\n# → branch ready in 1.2s"
+
+  - type: features
+    id: features-1
+    props:
+      heading: "Built for teams that ship"
+      subhead: "Isolated environments, instant reset, zero config."
+      items:
+        - title: "Branch per PR"
+          body: "Every pull request gets an isolated database."
+          emphasis: true
+        - title: "1-second reset"
+          body: "Roll back to a clean state instantly."
+          emphasis: false
+        - title: "Self-host or cloud"
+          body: "Run it your way; data stays yours."
+          emphasis: false
+
+  - type: codeDemo
+    id: codeDemo-1
+    props:
+      heading: "Drop it into your stack"
+      subhead: "Same API across languages."
+      snippets:
+        - lang: python
+          label: "Python"
+          source: "from branchy import Client\nc = Client()\nc.create(\"feat-x\")"
+        - lang: javascript
+          label: "Node"
+          source: "import { Client } from 'branchy'\nawait new Client().create('feat-x')"
+        - lang: go
+          label: "Go"
+          source: "client := branchy.New()\nclient.Create(\"feat-x\")"
+
+  - type: pricing
+    id: pricing-1
+    props:
+      heading: "Honest pricing"
+      subhead: "Start free. No credit card."
+      tiers:
+        - name: "Open source"
+          price: "$0"
+          description: "Self-host, unlimited branches."
+          features:
+            - "Self-hosted"
+            - "Community support"
+            - "Apache-2.0"
+          cta:
+            label: "Get started"
+            href: "#get-started"
+          featured: false
+        - name: "Team"
+          price: "$29"
+          period: "/mo"
+          description: "Managed cloud for small teams."
+          features:
+            - "10 projects"
+            - "Daily backups"
+            - "Email support"
+          cta:
+            label: "Start trial"
+            href: "#trial"
+          featured: true
+
+  - type: finalCta
+    id: finalCta-1
+    props:
+      headline: "Ship your first branch today"
+      subhead: "Free and open source. Self-host in minutes."
+      cta:
+        label: "Start free"
+        href: "#get-started"
+      microcopy: "No credit card · Apache-2.0"
+
+  - type: footer
+    id: footer-1
+    props:
+      brand: "Branchy"
+      tagline: "Database branching for teams."
+      columns:
+        - heading: "Product"
+          links:
+            - label: "Docs"
+              href: "/docs"
+            - label: "Pricing"
+              href: "#pricing"
+        - heading: "Community"
+          links:
+            - label: "GitHub"
+              href: "https://github.com"
+      copyright: "© 2026 Branchy. Apache-2.0."

package/dist/registry/app/src/content.config.ts

@@ -0,0 +1,10 @@
+import { defineCollection } from "astro:content";
+import { glob } from "astro/loaders";
+import { pageDocumentSchema } from "./content/_schema.js";
+
+const landing = defineCollection({
+  loader: glob({ pattern: "**/*.yaml", base: "./src/content/landing" }),
+  schema: pageDocumentSchema,
+});
+
+export const collections = { landing };

package/dist/registry/app/src/layouts/Base.astro

@@ -0,0 +1,24 @@
+---
+import "../styles/global.css";
+
+interface Props {
+  title: string;
+  description: string;
+  locale?: string;
+}
+const { title, description, locale = "en" } = Astro.props;
+---
+
+<!doctype html>
+<html lang={locale}>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{title}</title>
+    <meta name="description" content={description} />
+    <link rel="icon" href="/favicon.svg" />
+  </head>
+  <body class="min-h-screen antialiased">
+    <slot />
+  </body>
+</html>

package/dist/registry/app/src/pages/index.astro

@@ -0,0 +1,13 @@
+---
+import { getEntry } from "astro:content";
+import Base from "../layouts/Base.astro";
+import SectionRenderer from "../components/SectionRenderer.astro";
+
+const page = await getEntry("landing", "index");
+if (!page) throw new Error("Missing src/content/landing/index.yaml");
+const { meta, sections } = page.data;
+---
+
+<Base title={meta.title} description={meta.description} locale={meta.locales[0]}>
+  {sections.map((s) => <SectionRenderer type={s.type} props={s.props} />)}
+</Base>

package/dist/registry/app/src/styles/global.css

@@ -0,0 +1,20 @@
+@import "tailwindcss";
+
+@theme {
+  --color-primary: #3a6463;
+  --radius: 0.5rem;
+  --font-sans: "Inter", ui-sans-serif, system-ui, sans-serif;
+}
+
+:root {
+  color-scheme: dark;
+}
+
+html {
+  font-family: var(--font-sans);
+}
+
+body {
+  background-color: #0a0a0a;
+  color: #fafafa;
+}

package/dist/registry/app/tsconfig.json

@@ -0,0 +1 @@
+{ "extends": "astro/tsconfigs/strict", "include": [".astro", "src"], "exclude": ["dist"] }

package/dist/registry/sections/codeDemo/schema.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import type { SectionManifest } from "../src/manifest.js";
+
+export const snippetSchema = z.object({
+  lang: z.string().min(1),
+  label: z.string().min(1),
+  source: z.string().min(1),
+});
+
+export const propsSchema = z.object({
+  heading: z.string().min(1),
+  subhead: z.string().optional(),
+  snippets: z.array(snippetSchema).min(1).max(6),
+});
+
+export const entrySchema = z.object({
+  type: z.literal("codeDemo"),
+  id: z.string().min(1),
+  props: propsSchema,
+});
+
+export const manifest: SectionManifest = {
+  type: "codeDemo",
+  title: "Code / Integration demo",
+  description: "Multi-language code tabs with shiki highlighting and copy-to-clipboard.",
+  required: true,
+  archetypes: ["sdk-infra", "technical-app"],
+  componentFile: "section.astro",
+  defaultProps: {
+    heading: "Drop it into your stack",
+    subhead: "Same API across languages.",
+    snippets: [
+      {
+        lang: "python",
+        label: "Python",
+        source: 'from branchy import Client\nc = Client()\nc.create("feat-x")',
+      },
+      {
+        lang: "javascript",
+        label: "Node",
+        source: "import { Client } from 'branchy'\nawait new Client().create('feat-x')",
+      },
+      { lang: "go", label: "Go", source: 'client := branchy.New()\nclient.Create("feat-x")' },
+    ],
+  } satisfies z.input<typeof propsSchema>,
+};

package/dist/registry/sections/codeDemo/section.astro

@@ -0,0 +1,55 @@
+---
+import { codeToHtml } from "shiki";
+import type { z } from "zod";
+import type { propsSchema } from "./schema.js";
+
+type Props = z.infer<typeof propsSchema>;
+const { heading, subhead, snippets } = Astro.props as Props;
+
+const rendered = await Promise.all(
+  snippets.map(async (s) => ({
+    label: s.label,
+    html: await codeToHtml(s.source, { lang: s.lang, theme: "github-dark" }),
+  })),
+);
+const groupId = `code-${Math.abs(heading.length * 31 + snippets.length)}`;
+---
+
+<section class="mx-auto max-w-5xl px-6 py-24" data-section="codeDemo">
+  <div class="max-w-2xl">
+    <h2 class="text-3xl font-bold tracking-tight text-white">{heading}</h2>
+    {subhead && <p class="mt-3 text-white/60">{subhead}</p>}
+  </div>
+  <div class="mt-10 overflow-hidden rounded-[var(--radius)] border border-white/10 bg-black/40" data-codetabs={groupId}>
+    <div class="flex gap-1 border-b border-white/10 px-2 pt-2" role="tablist" aria-label="Code language">
+      {rendered.map((r, i) => (
+        <button
+          type="button"
+          role="tab"
+          aria-selected={i === 0 ? "true" : "false"}
+          data-tab={i}
+          class="rounded-t-md px-3 py-1.5 text-sm text-white/60 aria-selected:bg-white/5 aria-selected:text-white"
+        >
+          {r.label}
+        </button>
+      ))}
+    </div>
+    {rendered.map((r, i) => (
+      <div data-panel={i} hidden={i !== 0} class="overflow-x-auto p-4 text-sm [&_pre]:!bg-transparent" set:html={r.html} />
+    ))}
+  </div>
+</section>
+
+<script>
+  for (const group of document.querySelectorAll("[data-codetabs]")) {
+    const tabs = group.querySelectorAll("[data-tab]");
+    const panels = group.querySelectorAll("[data-panel]");
+    for (const tab of tabs) {
+      tab.addEventListener("click", () => {
+        const idx = tab.getAttribute("data-tab");
+        for (const t of tabs) t.setAttribute("aria-selected", t === tab ? "true" : "false");
+        for (const p of panels) (p as HTMLElement).hidden = p.getAttribute("data-panel") !== idx;
+      });
+    }
+  }
+</script>

package/dist/registry/sections/features/schema.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { SectionManifest } from "../src/manifest.js";
+
+export const featureSchema = z.object({
+  title: z.string().min(1),
+  body: z.string().min(1),
+  /** Larger tile = more important feature (first item is the lead). */
+  emphasis: z.boolean().default(false),
+  icon: z.string().optional(),
+});
+
+export const propsSchema = z.object({
+  heading: z.string().min(1),
+  subhead: z.string().optional(),
+  items: z.array(featureSchema).min(2).max(8),
+});
+
+export const entrySchema = z.object({
+  type: z.literal("features"),
+  id: z.string().min(1),
+  props: propsSchema,
+});
+
+export const manifest: SectionManifest = {
+  type: "features",
+  title: "Features / Bento",
+  description: "Feature grid; the emphasized tile is the most important capability.",
+  required: true,
+  archetypes: ["sdk-infra", "technical-app", "general"],
+  componentFile: "section.astro",
+  defaultProps: {
+    heading: "Built for teams that ship",
+    subhead: "Isolated environments, instant reset, zero config.",
+    items: [
+      {
+        title: "Branch per PR",
+        body: "Every pull request gets an isolated database.",
+        emphasis: true,
+      },
+      { title: "1-second reset", body: "Roll back to a clean state instantly." },
+      { title: "Self-host or cloud", body: "Run it your way; data stays yours." },
+    ],
+  } satisfies z.input<typeof propsSchema>,
+};

package/dist/registry/sections/features/section.astro

@@ -0,0 +1,25 @@
+---
+import type { z } from "zod";
+import type { propsSchema } from "./schema.js";
+
+type Props = z.infer<typeof propsSchema>;
+const { heading, subhead, items } = Astro.props as Props;
+---
+
+<section class="mx-auto max-w-6xl px-6 py-24" data-section="features">
+  <div class="max-w-2xl">
+    <h2 class="text-3xl font-bold tracking-tight text-white">{heading}</h2>
+    {subhead && <p class="mt-3 text-white/60">{subhead}</p>}
+  </div>
+  <div class="mt-12 grid gap-5 sm:grid-cols-2 lg:grid-cols-3">
+    {items.map((f) => (
+      <div
+        class={`rounded-[var(--radius)] border border-white/10 bg-white/[0.02] p-6 ${f.emphasis ? "sm:col-span-2 lg:row-span-2" : ""}`}
+      >
+        {f.icon && <div class="mb-3 text-2xl" aria-hidden="true">{f.icon}</div>}
+        <h3 class="text-lg font-semibold text-white">{f.title}</h3>
+        <p class="mt-2 text-sm text-white/60">{f.body}</p>
+      </div>
+    ))}
+  </div>
+</section>

package/dist/registry/sections/finalCta/schema.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { SectionManifest } from "../src/manifest.js";
+
+export const propsSchema = z.object({
+  headline: z.string().min(1),
+  subhead: z.string().optional(),
+  cta: z.object({ label: z.string().min(1), href: z.string().min(1) }),
+  microcopy: z.string().optional(),
+});
+
+export const entrySchema = z.object({
+  type: z.literal("finalCta"),
+  id: z.string().min(1),
+  props: propsSchema,
+});
+
+export const manifest: SectionManifest = {
+  type: "finalCta",
+  title: "Final CTA",
+  description: "Closing call to action with action-specific label and honest microcopy.",
+  required: true,
+  archetypes: ["sdk-infra", "technical-app", "general"],
+  componentFile: "section.astro",
+  defaultProps: {
+    headline: "Ship your first branch today",
+    subhead: "Free and open source. Self-host in minutes.",
+    cta: { label: "Start free", href: "#get-started" },
+    microcopy: "No credit card · Apache-2.0",
+  } satisfies z.input<typeof propsSchema>,
+};

package/dist/registry/sections/finalCta/section.astro

@@ -0,0 +1,18 @@
+---
+import type { z } from "zod";
+import type { propsSchema } from "./schema.js";
+
+type Props = z.infer<typeof propsSchema>;
+const { headline, subhead, cta, microcopy } = Astro.props as Props;
+---
+
+<section class="mx-auto max-w-4xl px-6 py-28 text-center" data-section="finalCta">
+  <h2 class="text-3xl font-bold tracking-tight text-white sm:text-4xl">{headline}</h2>
+  {subhead && <p class="mt-4 text-lg text-white/60">{subhead}</p>}
+  <div class="mt-8">
+    <a href={cta.href} class="inline-flex rounded-[var(--radius)] bg-[var(--color-primary)] px-6 py-3 text-sm font-semibold text-white hover:opacity-90">
+      {cta.label}
+    </a>
+  </div>
+  {microcopy && <p class="mt-4 text-xs text-white/40">{microcopy}</p>}
+</section>

package/dist/registry/sections/footer/schema.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { SectionManifest } from "../src/manifest.js";
+
+export const footerColumnSchema = z.object({
+  heading: z.string().min(1),
+  links: z.array(z.object({ label: z.string().min(1), href: z.string().min(1) })).min(1),
+});
+
+export const propsSchema = z.object({
+  brand: z.string().min(1),
+  tagline: z.string().optional(),
+  columns: z.array(footerColumnSchema).max(4).default([]),
+  copyright: z.string().min(1),
+});
+
+export const entrySchema = z.object({
+  type: z.literal("footer"),
+  id: z.string().min(1),
+  props: propsSchema,
+});
+
+export const manifest: SectionManifest = {
+  type: "footer",
+  title: "Footer",
+  description: "Site footer with link columns and copyright.",
+  required: true,
+  archetypes: ["sdk-infra", "technical-app", "general"],
+  componentFile: "section.astro",
+  defaultProps: {
+    brand: "Branchy",
+    tagline: "Database branching for teams.",
+    columns: [
+      {
+        heading: "Product",
+        links: [
+          { label: "Docs", href: "/docs" },
+          { label: "Pricing", href: "#pricing" },
+        ],
+      },
+      { heading: "Community", links: [{ label: "GitHub", href: "https://github.com" }] },
+    ],
+    copyright: "© 2026 Branchy. Apache-2.0.",
+  } satisfies z.input<typeof propsSchema>,
+};

package/dist/registry/sections/footer/section.astro

@@ -0,0 +1,29 @@
+---
+import type { z } from "zod";
+import type { propsSchema } from "./schema.js";
+
+type Props = z.infer<typeof propsSchema>;
+const { brand, tagline, columns, copyright } = Astro.props as Props;
+---
+
+<footer class="border-t border-white/10 bg-black/40" data-section="footer">
+  <div class="mx-auto grid max-w-6xl gap-8 px-6 py-14 sm:grid-cols-2 lg:grid-cols-4">
+    <div>
+      <p class="text-sm font-bold text-white">{brand}</p>
+      {tagline && <p class="mt-2 text-sm text-white/60">{tagline}</p>}
+    </div>
+    {columns.map((col) => (
+      <div>
+        <p class="text-xs font-semibold uppercase tracking-wide text-white/40">{col.heading}</p>
+        <ul class="mt-3 space-y-2">
+          {col.links.map((l) => (
+            <li><a href={l.href} class="text-sm text-white/70 hover:text-white">{l.label}</a></li>
+          ))}
+        </ul>
+      </div>
+    ))}
+  </div>
+  <div class="border-t border-white/10 px-6 py-6">
+    <p class="mx-auto max-w-6xl text-xs text-white/50">{copyright}</p>
+  </div>
+</footer>