@anja.codes/vitakit 0.1.0 → 0.2.0

package/dist/shared/vitakit.BxcnlFGP.mjs

@@ -1,325 +0,0 @@
-import { existsSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { z } from 'zod';
-
-const PATH_KEY = "__vitakitPath";
-const isSitePath = (value) => value.startsWith("/") && !value.startsWith("//");
-const sitePathMarker = (path) => ({ [PATH_KEY]: path });
-function isSitePathMarker(value) {
-  return typeof value === "object" && value !== null && PATH_KEY in value;
-}
-function resolveSitePaths(value, resolve) {
-  if (isSitePathMarker(value)) return resolve(value[PATH_KEY]);
-  if (Array.isArray(value)) return value.map((item) => resolveSitePaths(item, resolve));
-  if (typeof value === "object" && value !== null) {
-    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, resolveSitePaths(item, resolve)]));
-  }
-  return value;
-}
-function absoluteSitePath(path, siteUrl) {
-  return siteUrl ? `${siteUrl.replace(/\/?$/, "/")}${path.slice(1)}` : path;
-}
-
-function sourcePath(asset) {
-  return asset === "styles" ? asset : join("src", asset);
-}
-let root;
-function packageRoot() {
-  if (root) return root;
-  let dir = dirname(fileURLToPath(import.meta.url));
-  for (let depth = 0; depth < 6; depth += 1) {
-    if (existsSync(join(dir, "package.json"))) return root = dir;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  throw new Error("vitakit: cannot locate the package root; the installation is incomplete");
-}
-const built = /[/\\]dist[/\\]/.test(import.meta.url);
-function resolveAsset(asset) {
-  const base = packageRoot();
-  const order = built ? ["dist", void 0] : [void 0, "dist"];
-  const candidates = order.map((prefix) => prefix ? join(base, prefix, asset) : join(base, sourcePath(asset)));
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) return candidate;
-  }
-  throw new Error(
-    `vitakit: missing bundled asset "${asset}"; looked in
-` + candidates.map((candidate) => `  ${candidate}`).join("\n") + "\nRun `pnpm build` in the package, or reinstall it."
-  );
-}
-
-class ContentError extends Error {
-  constructor(where, message) {
-    super(`${where}: ${message}`);
-    this.where = where;
-    this.name = "ContentError";
-  }
-}
-function fail(where, message) {
-  throw new ContentError(where, message);
-}
-function messageOf(error) {
-  if (error instanceof ContentError) return error.message.slice(error.where.length + 2);
-  return error instanceof Error ? error.message : String(error);
-}
-function whereOf(error, fallback) {
-  return error instanceof ContentError ? error.where : fallback;
-}
-async function importProjectModule(path, mtimeMs, where) {
-  try {
-    return await import(`${pathToFileURL(path).href}?mtime=${mtimeMs}`);
-  } catch (error) {
-    fail(where, importFailure(error));
-  }
-}
-function importFailure(error, node = process.versions.node) {
-  if (error?.code === "ERR_UNKNOWN_FILE_EXTENSION") {
-    return `cannot load TypeScript on Node ${node}; vitakit needs Node 22.18 or newer`;
-  }
-  return messageOf(error);
-}
-function formatZodIssues(error) {
-  return error.issues.map((issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.message}`).join("\n");
-}
-class Issues {
-  constructor(strict) {
-    this.strict = strict;
-  }
-  list = [];
-  /** Record a problem, or throw it when strict. */
-  record(where, message) {
-    if (this.strict) fail(where, message);
-    this.list.push({ where, message });
-  }
-  /** Run `run`; when lenient, record any failure and use `fallback` instead. */
-  async attempt(where, run, fallback) {
-    try {
-      return await run();
-    } catch (error) {
-      if (this.strict) throw error;
-      this.list.push({ where: whereOf(error, where), message: messageOf(error) });
-      return fallback;
-    }
-  }
-}
-
-const MARKER_KEY = "__vitakitRich";
-function isRichMarker(value) {
-  return typeof value === "object" && value !== null && MARKER_KEY in value;
-}
-function richMarker(value) {
-  return { [MARKER_KEY]: value };
-}
-function renderRichFields(value, renderer, path, where) {
-  if (isRichMarker(value)) {
-    try {
-      return { text: value[MARKER_KEY], html: renderer.inline(value[MARKER_KEY]) };
-    } catch (error) {
-      fail(where, `${path}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
-  if (Array.isArray(value)) {
-    return value.map((item, index) => renderRichFields(item, renderer, `${path}[${index}]`, where));
-  }
-  if (typeof value === "object" && value !== null) {
-    return Object.fromEntries(Object.entries(value).map(
-      ([key, item]) => [key, renderRichFields(item, renderer, path ? `${path}.${key}` : key, where)]
-    ));
-  }
-  return value;
-}
-
-const text = z.string().trim().min(1);
-const richText = text.transform((value) => richMarker(value));
-const absoluteUrl = z.string().trim().refine(
-  // One check, not `.url().refine(...)`: zod runs a refinement even after
-  // `.url()` failed, and `new URL()` then throws instead of reporting.
-  (value) => URL.canParse(value) && ["http:", "https:", "mailto:"].includes(new URL(value).protocol),
-  "expected an http(s) or mailto URL"
-);
-const url = z.string().trim().transform((value, context) => {
-  if (isSitePath(value) && !/\s/.test(value)) return sitePathMarker(value);
-  const parsed = absoluteUrl.safeParse(value);
-  if (parsed.success) return parsed.data;
-  context.addIssue({ code: "custom", message: "expected an http(s) or mailto URL, or a path on the site such as /slides/talk.pdf" });
-  return z.NEVER;
-});
-const DATE = /^(\d{4})(?:-(\d{2}))?(?:-(\d{2}))?$/;
-function parseDatePoint(value, context) {
-  const match = DATE.exec(value);
-  if (!match) {
-    context.addIssue({ code: "custom", message: `expected a date like 2024, 2024-03 or 2024-03-15, got "${value}"` });
-    return void 0;
-  }
-  const [, y, m, d] = match;
-  const year = Number(y);
-  const month = m === void 0 ? void 0 : Number(m);
-  const day = d === void 0 ? void 0 : Number(d);
-  if (month !== void 0 && (month < 1 || month > 12)) {
-    context.addIssue({ code: "custom", message: `month out of range in "${value}"` });
-    return void 0;
-  }
-  if (day !== void 0) {
-    const date = new Date(Date.UTC(year, month - 1, day));
-    if (date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
-      context.addIssue({ code: "custom", message: `"${value}" is not a real date` });
-      return void 0;
-    }
-  }
-  return {
-    raw: value,
-    year,
-    month,
-    day,
-    // Pad missing parts so that 2024 < 2024-03 < 2024-03-15 sorts correctly.
-    sortKey: `${String(year).padStart(4, "0")}-${String(month ?? 1).padStart(2, "0")}-${String(day ?? 1).padStart(2, "0")}`
-  };
-}
-const datePoint = z.union([z.string(), z.number().int()]).transform((value) => String(value));
-const dateRange = z.union([
-  datePoint,
-  z.strictObject({
-    from: datePoint,
-    to: z.union([datePoint, z.literal("present")]).optional()
-  })
-]).transform((value, context) => {
-  const source = typeof value === "string" ? { from: value, to: void 0 } : value;
-  const from = parseDatePoint(source.from, context);
-  const ongoing = source.to === "present";
-  const to = source.to === void 0 || ongoing ? void 0 : parseDatePoint(source.to, context);
-  if (!from || source.to !== void 0 && !ongoing && !to) return z.NEVER;
-  if (to && to.sortKey < from.sortKey) {
-    context.addIssue({ code: "custom", message: `range ends (${to.raw}) before it starts (${from.raw})` });
-    return z.NEVER;
-  }
-  return { from, to, ongoing, point: typeof value === "string" };
-});
-const institution = z.union([
-  text.transform((name) => ({ name })),
-  z.strictObject({ name: text, url: url.optional() })
-]);
-const link = z.union([
-  url.transform((value) => ({
-    label: typeof value === "string" ? value.replace(/^https?:\/\//, "").replace(/\/$/, "") : value[PATH_KEY],
-    url: value
-  })),
-  z.strictObject({ label: text, url })
-]);
-const visibility = z.enum(["public", "cv", "private"]).default("public");
-function entry(shape) {
-  return z.strictObject({ visibility, ...shape });
-}
-function section(shape) {
-  return z.array(entry(shape));
-}
-
-const education = section({
-  date: dateRange,
-  degree: text,
-  institution,
-  thesis: z.strictObject({
-    title: richText,
-    type: text.optional(),
-    supervisor: z.union([text, link]).optional(),
-    url: url.optional()
-  }).optional(),
-  note: text.optional()
-});
-
-const employment = section({
-  date: dateRange,
-  position: text,
-  institution,
-  project: z.strictObject({
-    title: richText,
-    funder: text.optional(),
-    grant: text.optional(),
-    url: url.optional()
-  }).optional(),
-  note: text.optional()
-});
-
-const teaching = section({
-  date: dateRange,
-  title: richText,
-  role: text.optional(),
-  institution: institution.optional(),
-  /** e.g. `2024S`, `Winter 2023/24` -- free text, shown as written. */
-  term: text.optional(),
-  url: url.optional(),
-  note: text.optional()
-});
-
-const talks = section({
-  date: dateRange,
-  /** Markdown, math allowed. */
-  title: richText,
-  event: text.optional(),
-  location: text.optional(),
-  kind: z.enum(["invited", "contributed", "seminar", "poster", "outreach"]).optional(),
-  url: url.optional(),
-  slides: url.optional()
-});
-
-const supervision = section({
-  date: dateRange,
-  student: text,
-  /** A thesis still in progress; shown as such instead of as completed. */
-  ongoing: z.boolean().default(false),
-  /** Markdown, math allowed. */
-  title: richText,
-  degree: text.optional(),
-  institution: institution.optional(),
-  coSupervisor: text.optional()
-});
-
-const profile = z.strictObject({
-  name: text,
-  title: text.optional(),
-  affiliation: institution.optional(),
-  email: z.string().trim().email().optional(),
-  links: z.array(link).default([]),
-  /**
-   * One or two sentences for metadata: the page description and social
-   * previews. Prose belongs in `content/pages/index.md`, which is where a
-   * reader sees it -- this is deliberately not rendered on the page.
-   */
-  summary: text.optional(),
-  /**
-   * Where the website is published, e.g. `https://jane.example.org/` or
-   * `https://jane.github.io/site/`. The PDF needs it to link paths on the site
-   * such as `/slides/talk.pdf`; the website itself does not.
-   */
-  url: absoluteUrl.optional(),
-  /** Path below `public/`, e.g. `/img/portrait.jpg`. */
-  avatar: text.startsWith("/").optional(),
-  /** Navigation, in the order it should appear. */
-  nav: z.array(z.strictObject({ label: text, to: text })).default([]),
-  /** Footer line; inline Markdown. */
-  footer: text.optional()
-});
-const page = z.strictObject({
-  title: text,
-  description: text.optional(),
-  route: text.regex(/^\/(?:[a-z0-9-]+\/)*$/, "expected a route like /research/").optional(),
-  order: z.number().int().default(100)
-});
-const schemas = {
-  education,
-  employment,
-  teaching,
-  talks,
-  supervision
-};
-function extendSection(base, shape) {
-  return z.array(base.element.extend(shape));
-}
-
-const LEVEL = { public: 0, cv: 1, private: 2 };
-function atMost(value, limit) {
-  return LEVEL[value ?? "public"] <= LEVEL[limit];
-}
-
-export { whereOf as A, messageOf as B, page as C, Issues as I, MARKER_KEY as M, employment as a, entry as b, extendSection as c, dateRange as d, education as e, section as f, supervision as g, teaching as h, institution as i, text as j, atMost as k, link as l, fail as m, isSitePath as n, resolveAsset as o, formatZodIssues as p, importProjectModule as q, richText as r, schemas as s, talks as t, url as u, visibility as v, renderRichFields as w, resolveSitePaths as x, profile as y, absoluteSitePath as z };

package/src/bin/vitakit-build-cv.mjs

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-/**
- * Render content/ into cv-tex/generated/ and typeset it.
- */
-import process from 'node:process'
-import { buildCv } from '../../dist/tex.mjs'
-
-const HELP = `vitakit-build-cv — build the PDF documents in cv-tex/
-
-Usage
-  pnpm build:cv [document...] [options]
-
-Renders content/ into cv-tex/generated/<document>/, one .tex file per section,
-then runs latexmk. The finished PDF is written next to its source, as
-cv-tex/<document>.pdf; everything else stays in the generated directory.
-
-  pnpm build:cv                  every document in cv-tex/
-  pnpm build:cv cv               just cv.tex
-  pnpm build:cv cv application   several
-
-Options
-  --no-pdf     write the .tex files but do not run latexmk. Useful without a
-               TeX installation, and to inspect what was generated.
-  --help       this text
-
-A document is a .tex file you own; a copy of cv.tex is a new document. What it
-contains is decided by an optional cv-tex/<document>.yml (visibility, which
-entries, how many). See docs/cv-documents.md.
-
-Requires latexmk and biber, from any current TeX distribution.`
-
-const args = process.argv.slice(2)
-
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(HELP)
-  process.exit(0)
-}
-
-const noPdf = args.includes('--no-pdf')
-const only = args.filter(argument => !argument.startsWith('-'))
-
-try {
-  const outputs = await buildCv({ rootDir: process.cwd(), only, noPdf })
-  console.log(noPdf
-    ? `vitakit: generated .tex for ${only.length ? only.join(', ') : 'all documents'}`
-    : `vitakit: built ${outputs.join(', ')}`)
-} catch (error) {
-  console.error(`\nvitakit: ${error instanceof Error ? error.message : String(error)}\n`)
-  process.exit(1)
-}

package/src/bin/vitakit-check.mjs

@@ -1,57 +0,0 @@
-#!/usr/bin/env node
-/**
- * Assert that the generated site is complete and correct.
- */
-import process from 'node:process'
-import { checkStatic } from '../../dist/check.mjs'
-
-const HELP = `vitakit-check — verify the generated site
-
-Usage
-  pnpm check:static [--out <dir>]
-
-Run after \`nuxt generate\`; \`pnpm check\` does both. Checks the built HTML,
-not your content, because a schema cannot catch a renderer that silently did
-nothing:
-
-  - every page in content/pages/ was generated
-  - mathematics was typeset, and KaTeX reported no errors
-  - the site was built for the deployment base path (NUXT_APP_BASE_URL), and
-    every link and asset (href, src, srcset, poster, …) stays inside it
-  - every link into the site leads to a file or page that was generated,
-    e.g. slides: /slides/talk.pdf to public/slides/talk.pdf
-  - no entry marked \`visibility: cv\` or \`private\` appears anywhere in the site
-  - the bibliography is fully formatted wherever it is shown
-
-Options
-  --out <dir>      the generated site; defaults to .output/public
-  --no-leak-check  skip the check for cv and private entries. It compares their
-                   titles with the text of every page, so a title that is
-                   legitimately public elsewhere looks like a leak.
-  --help           this text
-
-Reports every problem and exits non-zero if there is one, so it can gate a
-deployment.`
-
-const args = process.argv.slice(2)
-
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(HELP)
-  process.exit(0)
-}
-
-const outIndex = args.indexOf('--out')
-
-const { checked, failures } = await checkStatic({
-  rootDir: process.cwd(),
-  outDir: outIndex === -1 ? undefined : args[outIndex + 1],
-  skipLeakCheck: args.includes('--no-leak-check'),
-})
-
-for (const line of checked) console.log(`  ok  ${line}`)
-if (failures.length) {
-  console.error(`\nvitakit-check: ${failures.length} problem(s):`)
-  for (const failure of failures) console.error(`  \u2716 ${failure}`)
-  process.exit(1)
-}
-console.log('\nvitakit-check: generated site looks correct.')