@emirotin/zerp 0.1.0

package/AGENTS.md

@@ -0,0 +1,28 @@
+# AGENTS.md
+
+## Repository Purpose
+
+`zerp` is the reusable presentation framework extracted from slide decks. The framework owns assembly, default styles, runtime navigation, serving, build output, and package metadata. Presentations should be able to live as a `slides/` folder plus package-level dependency wiring outside this repo.
+
+## Working Rules
+
+- Keep the authored deck contract minimal: `slides/**/*.html` plus optional assets under `slides/`.
+- Prefer zero-config behavior over introducing per-deck files.
+- Preserve support for inline interactive slide scripts.
+- Keep the package ready for both local `file:` installs and registry publishing.
+- Default styles should stay useful out of the box, but generic enough for reuse.
+- Treat `dist/` as tracked release output. Source edits belong under `src/` and `scripts/`; `dist/` is regenerated by the build.
+- The default browser runtime and CSS live in `src/assets/` and are inlined by `src/presentation.ts` during `serve` and `build`.
+- `examples/**/index.html` is generated and should not be edited by hand.
+- Pre-commit rebuilds `dist/`, so source and generated output must stay in sync.
+
+## Commands
+
+```bash
+pnpm install
+pnpm build
+pnpm check
+pnpm lint
+pnpm format:check
+pnpm exec zerp serve examples/casino
+```

package/CLAUDE.md

@@ -0,0 +1,39 @@
+# CLAUDE.md
+
+This repository contains the `zerp` presentation framework.
+
+## Architecture
+
+- `src/index.ts` exposes the framework API.
+- `src/cli.ts` provides the publishable CLI.
+- `src/presentation.ts` assembles slide files into one HTML document.
+- `src/server.ts` serves a deck and static assets from a target directory.
+- `src/assets/default-styles.css` contains the default presentation styles.
+- `src/assets/default-runtime.js` contains the browser navigation/runtime logic.
+- `scripts/build.mjs` builds TypeScript output into `dist/`, copies assets, and formats generated files.
+- `dist/` is tracked and represents the publishable package contents.
+
+## Deck Contract
+
+- A deck is discovered from a directory containing `slides/`.
+- `slides/**/*.html` files are ordered lexicographically.
+- Non-HTML assets can live anywhere under `slides/`.
+- Relative asset references inside slide HTML are rewritten relative to the deck root, so slide-local paths continue to work after assembly.
+- Generated `index.html` output is not source-of-truth for example decks.
+
+## Tooling
+
+- Node and pnpm are pinned in `package.json` via Volta metadata and `packageManager`.
+- `oxlint` and `oxfmt` are the standard lint/format tools.
+- `husky` runs `lint-staged`, rebuilds `dist/`, and stages regenerated output on every commit.
+- `.zed/settings.json` and `.zed/format.sh` wire Zed to `oxfmt`.
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm check
+pnpm lint
+pnpm format:check
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eugene Mirotin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# zerp
+
+`zerp` is a zero-config HTML presentation framework.
+
+Each presentation can be authored as just a `slides/` folder:
+
+```text
+my-deck/
+  slides/
+    00-title.html
+    10-intro.html
+    images/
+      cover.jpg
+```
+
+`zerp` finds `slides/**/*.html`, sorts them by filename, rewrites relative asset URLs so slide-local assets keep working, injects default styles/runtime, and serves or builds a single-page deck.
+
+## Maintainer Policy
+
+I use `zerp` myself and find it useful, which is why I am making it public as free open-source software.
+
+That does not mean I am available for general collaboration. Issues and pull requests are intentionally disabled. I do not have the capacity to debug other people's problems for free, and I do not want to spend time triaging low-signal or AI-generated contributions.
+
+If you want to use the project as-is, please do. If you need a fix, a feature, or help integrating it into your workflow, contact me directly for paid support.
+
+## Usage
+
+Install from a local checkout:
+
+```bash
+pnpm add -D file:../zerp
+pnpm exec zerp serve .
+```
+
+Or from a registry:
+
+```bash
+pnpm add -D @emirotin/zerp
+pnpm exec zerp build .
+```
+
+Commands:
+
+```bash
+pnpm exec zerp serve          # serve the current deck on http://localhost:8000
+pnpm exec zerp serve 3000     # current deck, custom port
+pnpm exec zerp serve . 3000   # explicit deck dir
+pnpm exec zerp build          # write ./index.html for the current deck
+```
+
+## Tooling
+
+This repo pins Node and pnpm via Volta metadata in `package.json`:
+
+```bash
+volta pin node@24.14.1 pnpm@10.33.0
+```
+
+Quality commands:
+
+```bash
+pnpm lint
+pnpm lint:fix
+pnpm format
+pnpm format:check
+```
+
+`husky` runs `lint-staged`, rebuilds `dist/`, and stages the rebuilt package output before each commit.
+
+## Authoring
+
+- Put all authored content in `slides/`.
+- Use filename prefixes for ordering, for example `00-`, `10-`, `20-`.
+- Store deck assets under `slides/` too. Relative links like `src="./images/foo.jpg"` are rewritten automatically.
+- Each `.html` file can contain one or more `<div class="slide">` blocks.
+- The framework default CSS and browser runtime are stored as separate source assets and inlined into generated HTML during `serve` and `build`.
+
+## Library API
+
+```ts
+import { buildPresentationHtml, writePresentation } from "@emirotin/zerp";
+```
+
+## Example
+
+This repository includes a migrated example deck at `examples/casino/`. Its authored source is only `examples/casino/slides/`.

package/dist/assets/default-runtime.js

@@ -0,0 +1,93 @@
+(() => {
+  const slides = Array.from(document.querySelectorAll(".slide"));
+  let current = 0;
+  const total = slides.length;
+  const counter = document.getElementById("counter");
+  const progress = document.getElementById("progress");
+
+  function clamp(index) {
+    return Math.max(0, Math.min(index, total - 1));
+  }
+
+  function show(index) {
+    current = clamp(index);
+    for (const slide of slides) {
+      slide.classList.remove("active");
+    }
+    const active = slides[current];
+    if (!active) {
+      return;
+    }
+    active.classList.add("active");
+    if (counter) {
+      counter.textContent = String(current + 1) + " / " + String(total);
+    }
+    if (progress) {
+      progress.style.width = String(((current + 1) / Math.max(total, 1)) * 100) + "%";
+    }
+    history.replaceState(null, "", "#" + String(current + 1));
+  }
+
+  function next() {
+    show(current + 1);
+  }
+
+  function prev() {
+    show(current - 1);
+  }
+
+  function stepForward() {
+    slides[current]?.dispatchEvent(new Event("slide-next"));
+  }
+
+  function stepBackward() {
+    slides[current]?.dispatchEvent(new Event("slide-prev"));
+  }
+
+  window.next = next;
+  window.prev = prev;
+
+  document.addEventListener("keydown", (event) => {
+    if (event.key === "ArrowRight" || event.key === " " || event.key === "PageDown") {
+      event.preventDefault();
+      next();
+    }
+    if (event.key === "ArrowLeft" || event.key === "PageUp") {
+      event.preventDefault();
+      prev();
+    }
+    if (event.key === "Home") {
+      event.preventDefault();
+      show(0);
+    }
+    if (event.key === "End") {
+      event.preventDefault();
+      show(total - 1);
+    }
+    if (event.key === "ArrowDown") {
+      event.preventDefault();
+      stepForward();
+    }
+    if (event.key === "ArrowUp") {
+      event.preventDefault();
+      stepBackward();
+    }
+  });
+
+  let touchStartX = 0;
+  document.addEventListener("touchstart", (event) => {
+    touchStartX = event.touches[0]?.clientX ?? 0;
+  });
+  document.addEventListener("touchend", (event) => {
+    const delta = touchStartX - (event.changedTouches[0]?.clientX ?? 0);
+    if (Math.abs(delta) > 60) {
+      if (delta > 0) {
+        next();
+      } else {
+        prev();
+      }
+    }
+  });
+
+  show((Number.parseInt(location.hash.slice(1), 10) || 1) - 1);
+})();

package/dist/assets/default-styles.css

@@ -0,0 +1,294 @@
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+:root {
+  --zerp-bg: #0d1117;
+  --zerp-panel: #161b22;
+  --zerp-border: #30363d;
+  --zerp-text: #e6edf3;
+  --zerp-muted: #8b949e;
+  --zerp-faint: #484f58;
+  --zerp-accent: #58a6ff;
+  --zerp-green: #3fb950;
+  --zerp-orange: #f0883e;
+  --zerp-purple: #bc8cff;
+  --zerp-red: #f85149;
+}
+
+html,
+body {
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  background: var(--zerp-bg);
+  color: var(--zerp-text);
+  font-family: "Montserrat", sans-serif;
+}
+
+img,
+video {
+  max-width: 100%;
+}
+
+.slide {
+  display: none;
+  width: 100vw;
+  height: 100vh;
+  padding: 50px 70px;
+  flex-direction: column;
+  justify-content: center;
+  position: relative;
+}
+
+.slide.active {
+  display: flex;
+}
+
+.slide h1 {
+  font-size: 3.2em;
+  font-weight: 900;
+  line-height: 1.15;
+  margin-bottom: 20px;
+}
+
+.slide h2 {
+  font-size: 2.2em;
+  font-weight: 700;
+  line-height: 1.2;
+  margin-bottom: 14px;
+}
+
+.slide h3 {
+  font-size: 1.4em;
+  font-weight: 700;
+  margin-bottom: 10px;
+  color: var(--zerp-muted);
+}
+
+.slide p,
+.slide li {
+  font-size: 1.25em;
+  line-height: 1.5;
+  color: #c9d1d9;
+}
+
+.slide ul {
+  list-style: none;
+  padding: 0;
+}
+
+.slide li {
+  padding: 5px 0;
+}
+
+.slide li::before {
+  content: "→ ";
+  color: var(--zerp-accent);
+}
+
+.accent {
+  color: var(--zerp-accent);
+}
+
+.accent-green {
+  color: var(--zerp-green);
+}
+
+.accent-orange {
+  color: var(--zerp-orange);
+}
+
+.accent-purple {
+  color: var(--zerp-purple);
+}
+
+.accent-red {
+  color: var(--zerp-red);
+}
+
+.big-number {
+  font-size: 3em;
+  font-weight: 900;
+  color: var(--zerp-accent);
+  font-family: "Roboto Mono", monospace;
+}
+
+.img-row {
+  display: flex;
+  gap: 24px;
+  align-items: center;
+  justify-content: center;
+  margin: 24px 0;
+  flex-wrap: wrap;
+}
+
+.img-row img {
+  max-height: 300px;
+  border-radius: 10px;
+  object-fit: contain;
+  background: var(--zerp-panel);
+  padding: 6px;
+}
+
+.two-col {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 40px;
+  align-items: center;
+}
+
+.caption {
+  font-size: 0.8em;
+  color: var(--zerp-muted);
+  text-align: center;
+  margin-top: 4px;
+}
+
+.block-label {
+  position: absolute;
+  top: 24px;
+  left: 70px;
+  font-size: 0.8em;
+  font-weight: 700;
+  color: var(--zerp-faint);
+  text-transform: uppercase;
+  letter-spacing: 3px;
+}
+
+.interactive-badge {
+  display: inline-block;
+  background: #238636;
+  color: white;
+  padding: 5px 16px;
+  border-radius: 20px;
+  font-size: 0.8em;
+  font-weight: 700;
+  margin-bottom: 14px;
+}
+
+.timeline {
+  display: flex;
+  gap: 20px;
+  flex-wrap: wrap;
+  justify-content: center;
+  margin: 16px 0;
+}
+
+.timeline .item {
+  background: var(--zerp-panel);
+  border: 1px solid var(--zerp-border);
+  border-radius: 10px;
+  padding: 14px 18px;
+  text-align: center;
+  min-width: 130px;
+}
+
+.timeline .item .year {
+  font-family: "Roboto Mono", monospace;
+  font-size: 1.3em;
+  font-weight: 700;
+  color: var(--zerp-accent);
+}
+
+.timeline .item .label {
+  font-size: 0.85em;
+  color: #c9d1d9;
+  margin-top: 4px;
+}
+
+.nav {
+  position: fixed;
+  bottom: 24px;
+  right: 36px;
+  display: flex;
+  gap: 10px;
+  z-index: 100;
+}
+
+.nav button {
+  background: none;
+  border: none;
+  color: var(--zerp-faint);
+  padding: 4px 8px;
+  cursor: pointer;
+  font-size: 0.85em;
+  font-family: "Roboto Mono", monospace;
+}
+
+.nav button:hover {
+  color: var(--zerp-muted);
+}
+
+.counter {
+  position: fixed;
+  bottom: 28px;
+  left: 36px;
+  font-size: 0.85em;
+  color: var(--zerp-faint);
+  font-family: "Roboto Mono", monospace;
+  z-index: 100;
+}
+
+.progress {
+  position: fixed;
+  top: 0;
+  left: 0;
+  height: 3px;
+  background: var(--zerp-accent);
+  z-index: 100;
+  transition: width 0.3s;
+}
+
+.quote {
+  border-left: 4px solid var(--zerp-accent);
+  padding: 14px 20px;
+  margin: 16px 0;
+  background: var(--zerp-panel);
+  border-radius: 0 10px 10px 0;
+  font-style: italic;
+  font-size: 1.1em;
+}
+
+.key-thought {
+  background: var(--zerp-panel);
+  border: 2px solid var(--zerp-accent);
+  border-radius: 14px;
+  padding: 28px 36px;
+  margin: 16px 0;
+  text-align: center;
+}
+
+.key-thought p {
+  font-size: 1.4em;
+  font-weight: 700;
+  color: var(--zerp-text);
+}
+
+.grid-demo {
+  display: grid;
+  grid-template-columns: repeat(7, 48px);
+  gap: 3px;
+  justify-content: center;
+  margin: 16px 0;
+}
+
+.grid-demo .cell {
+  width: 48px;
+  height: 48px;
+  border: 2px solid var(--zerp-border);
+  border-radius: 5px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 0.75em;
+  color: var(--zerp-faint);
+}
+
+.grid-demo .cell.filled {
+  background: var(--zerp-red);
+  border-color: var(--zerp-red);
+  color: white;
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { writePresentation } from "./presentation.js";
+import { servePresentation } from "./server.js";
+function printUsage() {
+  process.stderr.write(
+    [
+      "Usage:",
+      "  zerp serve [deck-dir] [port]",
+      "  zerp build [deck-dir]",
+      "",
+      "A deck directory must contain slides/.",
+      "",
+    ].join("\n"),
+  );
+}
+async function main() {
+  const [, , command, firstArg, secondArg] = process.argv;
+  if (!command) {
+    printUsage();
+    process.exitCode = 1;
+    return;
+  }
+  if (command === "build") {
+    const rootDir = path.resolve(firstArg ?? ".");
+    const outFile = await writePresentation({ rootDir });
+    process.stdout.write(`Wrote ${outFile}\n`);
+    return;
+  }
+  if (command === "serve") {
+    const hasExplicitDeckDir = firstArg !== undefined && !/^\d+$/.test(firstArg);
+    const rootDir = path.resolve(hasExplicitDeckDir ? firstArg : ".");
+    const portArg = hasExplicitDeckDir ? secondArg : firstArg;
+    const port = portArg ? Number.parseInt(portArg, 10) : 8000;
+    if (!Number.isInteger(port)) {
+      throw new Error(`Invalid port: ${portArg}`);
+    }
+    await servePresentation(rootDir, port);
+    return;
+  }
+  printUsage();
+  process.exitCode = 1;
+}
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${message}\n`);
+  process.exitCode = 1;
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { buildPresentationHtml, listSlides, writePresentation } from "./presentation.js";
+export type { BuildOptions } from "./presentation.js";
+export { servePresentation } from "./server.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { buildPresentationHtml, listSlides, writePresentation } from "./presentation.js";
+export { servePresentation } from "./server.js";

package/dist/presentation.d.ts

@@ -0,0 +1,14 @@
+export interface BuildOptions {
+  rootDir: string;
+  title?: string;
+  lang?: string;
+  outFile?: string;
+}
+interface SlideFile {
+  absolutePath: string;
+  relativePath: string;
+}
+export declare function listSlides(rootDir: string): Promise<SlideFile[]>;
+export declare function buildPresentationHtml(options: BuildOptions): Promise<string>;
+export declare function writePresentation(options: BuildOptions): Promise<string>;
+export {};

package/dist/presentation.js

@@ -0,0 +1,114 @@
+import { readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+const assetCache = new Map();
+const URL_ATTRS = ["src", "href", "poster"];
+function escapeHtml(value) {
+  return value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+}
+function isExternalUrl(value) {
+  return /^(?:[a-z]+:|#|\/)/i.test(value);
+}
+function rewriteRelativeUrls(html, relativeSlidePath) {
+  const slideRootRelativePath = path.posix.join(
+    "slides",
+    relativeSlidePath.replaceAll(path.sep, "/"),
+  );
+  const slideDir = path.posix.dirname(slideRootRelativePath);
+  const normalizedDir = slideDir === "." ? "" : slideDir;
+  return html.replace(
+    /\b(src|href|poster)\s*=\s*(["'])([^"']+)\2/gi,
+    (_match, attr, quote, value) => {
+      if (!URL_ATTRS.includes(attr.toLowerCase()) || isExternalUrl(value)) {
+        return `${attr}=${quote}${value}${quote}`;
+      }
+      const rewritten = path.posix.normalize(
+        normalizedDir ? path.posix.join(normalizedDir, value) : value,
+      );
+      return `${attr}=${quote}${rewritten}${quote}`;
+    },
+  );
+}
+function readAsset(assetPath) {
+  const cached = assetCache.get(assetPath);
+  if (cached) {
+    return cached;
+  }
+  const contentPromise = readFile(new URL(assetPath, import.meta.url), "utf8");
+  assetCache.set(assetPath, contentPromise);
+  return contentPromise;
+}
+async function collectSlideFiles(slidesDir, prefix = "") {
+  const entries = await readdir(slidesDir, { withFileTypes: true });
+  const files = await Promise.all(
+    entries
+      .filter((entry) => !entry.name.startsWith("."))
+      .sort((left, right) => left.name.localeCompare(right.name))
+      .map(async (entry) => {
+        const relativePath = path.join(prefix, entry.name);
+        const absolutePath = path.join(slidesDir, entry.name);
+        if (entry.isDirectory()) {
+          return collectSlideFiles(absolutePath, relativePath);
+        }
+        if (entry.isFile() && entry.name.endsWith(".html")) {
+          return [{ absolutePath, relativePath }];
+        }
+        return [];
+      }),
+  );
+  return files.flat();
+}
+export async function listSlides(rootDir) {
+  const slidesDir = path.join(rootDir, "slides");
+  return collectSlideFiles(slidesDir);
+}
+export async function buildPresentationHtml(options) {
+  const title = options.title ?? path.basename(path.resolve(options.rootDir));
+  const lang = options.lang ?? "en";
+  const slideFiles = await listSlides(options.rootDir);
+  const [defaultStyles, defaultRuntime] = await Promise.all([
+    readAsset("./assets/default-styles.css"),
+    readAsset("./assets/default-runtime.js"),
+  ]);
+  if (slideFiles.length === 0) {
+    throw new Error(`No slide HTML files found in ${path.join(options.rootDir, "slides")}`);
+  }
+  const slideHtmlParts = await Promise.all(
+    slideFiles.map(async ({ absolutePath, relativePath }) => {
+      const html = await readFile(absolutePath, "utf8");
+      return rewriteRelativeUrls(html, relativePath);
+    }),
+  );
+  return [
+    "<!doctype html>",
+    `<html lang="${escapeHtml(lang)}">`,
+    "  <head>",
+    '    <meta charset="UTF-8" />',
+    '    <meta name="viewport" content="width=device-width, initial-scale=1.0" />',
+    `    <title>${escapeHtml(title)}</title>`,
+    '    <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&family=Roboto+Mono:wght@400;700&display=swap" rel="stylesheet" />',
+    "    <style>",
+    defaultStyles,
+    "    </style>",
+    "  </head>",
+    "  <body>",
+    slideHtmlParts.join("\n"),
+    '    <div class="progress" id="progress"></div>',
+    '    <div class="counter" id="counter"></div>',
+    '    <div class="nav"><button onclick="prev()">←</button><button onclick="next()">→</button></div>',
+    "    <script>",
+    defaultRuntime,
+    "    </script>",
+    "  </body>",
+    "</html>",
+  ].join("\n");
+}
+export async function writePresentation(options) {
+  const outFile = options.outFile ?? path.join(options.rootDir, "index.html");
+  const html = await buildPresentationHtml(options);
+  await writeFile(outFile, html, "utf8");
+  return outFile;
+}

package/dist/server.d.ts

@@ -0,0 +1 @@
+export declare function servePresentation(rootDir: string, port: number): Promise<void>;

package/dist/server.js

@@ -0,0 +1,52 @@
+import { createServer } from "node:http";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { buildPresentationHtml } from "./presentation.js";
+const CONTENT_TYPES = new Map([
+  [".css", "text/css; charset=utf-8"],
+  [".gif", "image/gif"],
+  [".html", "text/html; charset=utf-8"],
+  [".jpeg", "image/jpeg"],
+  [".jpg", "image/jpeg"],
+  [".js", "text/javascript; charset=utf-8"],
+  [".json", "application/json; charset=utf-8"],
+  [".png", "image/png"],
+  [".svg", "image/svg+xml"],
+  [".webp", "image/webp"],
+]);
+function getContentType(filePath) {
+  return CONTENT_TYPES.get(path.extname(filePath).toLowerCase()) ?? "application/octet-stream";
+}
+export async function servePresentation(rootDir, port) {
+  const resolvedRoot = path.resolve(rootDir);
+  const host = "127.0.0.1";
+  const server = createServer(async (req, res) => {
+    try {
+      const requestUrl = new URL(req.url ?? "/", "http://localhost");
+      const pathname = decodeURIComponent(requestUrl.pathname);
+      if (pathname === "/" || pathname === "/index.html") {
+        const html = await buildPresentationHtml({ rootDir: resolvedRoot });
+        res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+        res.end(html);
+        return;
+      }
+      const candidatePath = path.resolve(resolvedRoot, `.${pathname}`);
+      if (!candidatePath.startsWith(resolvedRoot)) {
+        res.writeHead(403);
+        res.end("Forbidden");
+        return;
+      }
+      const content = await readFile(candidatePath);
+      res.writeHead(200, { "content-type": getContentType(candidatePath) });
+      res.end(content);
+    } catch (error) {
+      const status = error.code === "ENOENT" ? 404 : 500;
+      res.writeHead(status, { "content-type": "text/plain; charset=utf-8" });
+      res.end(status === 404 ? "Not found" : "Internal server error");
+    }
+  });
+  await new Promise((resolve) => {
+    server.listen(port, host, resolve);
+  });
+  process.stdout.write(`Serving ${resolvedRoot} at http://${host}:${port}\n`);
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@emirotin/zerp",
+  "version": "0.1.0",
+  "description": "Zero-config HTML presentation framework for slide decks stored in a slides/ folder.",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/emirotin/zerp.git"
+  },
+  "homepage": "https://github.com/emirotin/zerp",
+  "keywords": [
+    "cli",
+    "html",
+    "presentation",
+    "slides",
+    "typescript"
+  ],
+  "license": "MIT",
+  "bin": {
+    "zerp": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "AGENTS.md",
+    "CLAUDE.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
+    "typescript": "^5.9.3"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs,ts}": [
+      "oxfmt --write",
+      "oxlint --fix --deny-warnings --node-plugin --import-plugin"
+    ]
+  },
+  "engines": {
+    "node": "24.14.1",
+    "pnpm": "10.33.0"
+  },
+  "volta": {
+    "node": "24.14.1",
+    "pnpm": "10.33.0"
+  },
+  "scripts": {
+    "build": "node ./scripts/build.mjs",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint --deny-warnings --node-plugin --import-plugin src scripts .zed",
+    "lint:fix": "oxlint --fix --deny-warnings --node-plugin --import-plugin src scripts .zed"
+  }
+}