mdeck 2.3.0

package/assets/extensions/themes/terminal/styles.css

@@ -0,0 +1,550 @@
+/* Terminal — a real terminal session.
+   JetBrains Mono throughout. Headings read as commands typed at a prompt,
+   the title waits at a blinking cursor, a chapter starts like running a new
+   command, callouts are log lines, and the footer is a tmux status bar.
+   Code is in the same face as the text, so it is set apart by a window
+   frame with a title bar. Dark by default; in light it reads as a printout
+   of the session. Colours come only from the palette roles. */
+
+.slide {
+  --prompt: '~/talk $ ';
+}
+
+/* ─────────────────────────────────────────────
+   HEADER — the organisation as a comment, the section in brackets
+   ───────────────────────────────────────────── */
+.slide-header {
+  font-weight: 400;
+  letter-spacing: 0.04em;
+  color: var(--muted);
+}
+.slide-header .brand { color: var(--muted); }
+.slide-header .brand:not(:empty)::before { content: '# '; color: var(--accent); }
+.slide-header > span:last-child:not(:first-child):not(:empty)::before { content: '['; }
+.slide-header > span:last-child:not(:first-child):not(:empty)::after { content: ']'; }
+
+.slide-logo {
+  position: absolute;
+  top: var(--pad-y);
+  right: var(--pad-x);
+  height: 120px;
+  width: auto;
+  max-width: 480px;
+  object-fit: contain;
+  filter: var(--logo-filter, none);
+  transform: translateY(calc(var(--fs-eyebrow) * 0.5 - 50%));
+}
+
+/* ─────────────────────────────────────────────
+   FOOTER — a tmux status bar across the bottom edge: the session (the
+   deck's title) in the accent on the left, the page number on the right
+   ───────────────────────────────────────────── */
+.slide-footer {
+  font-family: var(--font-body);
+  font-size: var(--fs-small);
+  font-weight: 400;
+  color: var(--ink-soft);
+  background: var(--surface);
+  justify-content: flex-start;
+  gap: 32px;
+  /* Across the bottom edge, in the slide's lower padding, out of the flow
+     (a negative margin would make the slide look overfull to fit.js). */
+  position: absolute;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  z-index: 1;
+  padding: 0 var(--pad-x) 0 0;
+  height: 52px;
+}
+.slide-footer::before {
+  content: '[' var(--meta-title, 'talk') ']';
+  flex: none;
+  align-self: stretch;
+  display: flex;
+  align-items: center;
+  max-width: 900px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  padding: 0 28px 0 var(--pad-x);
+  background: var(--accent);
+  color: var(--on-accent);
+  font-weight: 700;
+}
+.slide-footer > span:last-child:not(:first-child) { margin-left: auto; color: var(--ink); font-weight: 700; }
+
+/* ─────────────────────────────────────────────
+   TYPOGRAPHY HELPERS
+   ───────────────────────────────────────────── */
+.eyebrow {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 400;
+  letter-spacing: 0.04em;
+  color: var(--muted);
+  margin: 0 0 var(--gap-title) 0;
+}
+.eyebrow::before { content: '# '; color: var(--accent); }
+.display {
+  font-family: var(--font-display);
+  font-size: var(--fs-display);
+  font-weight: 800;
+  line-height: 1.05;
+  letter-spacing: -0.04em;
+  margin: 0;
+  color: var(--ink);
+  text-wrap: balance;
+}
+.title {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 700;
+  line-height: 1.15;
+  letter-spacing: -0.03em;
+  margin: 0;
+  color: var(--ink);
+  text-wrap: balance;
+}
+.subtitle {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  line-height: 1.35;
+  color: var(--ink-soft);
+  margin: 0;
+  text-wrap: pretty;
+}
+.body-text {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  font-weight: 400;
+  line-height: 1.55;
+  color: var(--ink-soft);
+  margin: 0;
+  text-wrap: pretty;
+}
+.meta {
+  font-family: var(--font-body);
+  font-size: var(--fs-small);
+  color: var(--muted);
+}
+em {
+  font-style: normal;
+  color: var(--accent);
+}
+strong { color: var(--ink); font-weight: 700; }
+/* Inline code is in the text's own face: a background tells it apart. */
+.slide-body :not(pre) > code {
+  font-family: inherit;
+  font-size: 0.92em;
+  background: var(--surface);
+  color: var(--accent-2);
+  padding: 0.05em 0.3em;
+  border-radius: 0;
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: TITLE — a command line above, the title waiting at a cursor
+   ───────────────────────────────────────────── */
+.slide--title .slide-body {
+  justify-content: center;
+  align-items: flex-start;
+}
+.slide--title .title-text::before {
+  content: '$ ./present';
+  display: block;
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  color: var(--muted);
+  margin-bottom: 48px;
+}
+.slide--title .display {
+  font-size: var(--fs-display);
+  max-width: 1600px;
+}
+.slide--title .display::after {
+  content: '';
+  display: inline-block;
+  width: 0.55em;
+  height: 0.95em;
+  margin-left: 0.15em;
+  vertical-align: -0.12em;
+  background: var(--accent);
+}
+.slide--title .subtitle {
+  margin-top: 44px;
+  max-width: 1300px;
+}
+.slide--title .subtitle::before { content: '> '; color: var(--accent); }
+.slide--title.has-image .slide-body {
+  display: grid;
+  grid-template-columns: 1.15fr 1fr;
+  column-gap: 80px;
+  align-items: center;
+}
+.slide--title.has-image .display { font-size: calc(var(--fs-display) * 0.7); }
+.slide--title.has-image .title-image {
+  width: 100%;
+  height: 600px;
+  object-fit: cover;
+  border: 2px solid var(--rule);
+}
+
+/* The cursor blinks while presenting; never in print or for people who
+   prefer less motion. */
+@media screen and (prefers-reduced-motion: no-preference) {
+  .slide--title .display::after { animation: terminal-blink 1.1s steps(1) infinite; }
+}
+@keyframes terminal-blink { 50% { opacity: 0; } }
+deck-stage[data-deck-static] .slide--title .display::after { animation: none; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: CHAPTER — running a new command: the command line, the part as
+   a comment, then the title large. A faint scanline on screen only.
+   ───────────────────────────────────────────── */
+@media screen {
+  .slide--chapter {
+    background-image: repeating-linear-gradient(to bottom, transparent 0 3px, color-mix(in oklab, var(--ink) 4%, transparent) 3px 4px);
+  }
+}
+.slide--chapter .slide-body {
+  justify-content: center;
+  align-items: flex-start;
+}
+.chapter-num {
+  font-family: var(--font-display);
+  font-size: var(--fs-sub);
+  font-weight: 700;
+  line-height: 1.3;
+  color: var(--ink);
+  margin: 0 0 12px 0;
+}
+.chapter-num::before { content: '$ ./chapter '; color: var(--muted); font-weight: 400; }
+.chapter-meta {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  line-height: 1.3;
+  color: var(--muted);
+  margin: 0 0 56px 0;
+}
+.chapter-meta::before { content: '# '; color: var(--accent); }
+.slide--chapter .chapter-title {
+  font-family: var(--font-display);
+  font-size: var(--fs-title);
+  font-weight: 800;
+  line-height: 1.05;
+  letter-spacing: -0.04em;
+  margin: 0 0 40px 0;
+  color: var(--ink);
+  max-width: 1500px;
+  text-wrap: balance;
+}
+.slide--chapter .chapter-desc {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  line-height: 1.35;
+  color: var(--ink-soft);
+  max-width: 1300px;
+  margin: 0;
+}
+.slide--chapter .chapter-desc::before { content: '> '; color: var(--accent); }
+.slide--chapter.has-image .slide-body {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  column-gap: 80px;
+  align-items: stretch;
+}
+.slide--chapter.has-image .chapter-content {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: flex-start;
+}
+.slide--chapter.has-image .chapter-title { font-size: calc(var(--fs-title) * 0.75); }
+.slide--chapter.has-image .chapter-image {
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  box-sizing: border-box;
+  object-fit: cover;
+  border: 2px solid var(--rule);
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: FOCUS — a statement printed by a command
+   ───────────────────────────────────────────── */
+.slide--focus .slide-body {
+  justify-content: center;
+  align-items: flex-start;
+}
+.focus-eyebrow {
+  font-family: var(--font-body);
+  font-size: var(--fs-eyebrow);
+  font-weight: 400;
+  color: var(--muted);
+  margin: 0 0 24px 0;
+}
+.focus-eyebrow::before { content: '# '; color: var(--accent); }
+.focus-content {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+}
+.focus-content::before {
+  content: '$ cat statement.txt';
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  color: var(--muted);
+  margin-bottom: 40px;
+}
+.focus-statement,
+.slide--focus .focus-content h1,
+.slide--focus .focus-content p {
+  font-family: var(--font-display);
+  font-size: var(--fs-focus);
+  font-weight: 700;
+  line-height: 1.2;
+  letter-spacing: -0.03em;
+  color: var(--ink);
+  max-width: 1550px;
+  margin: 0;
+  text-wrap: balance;
+}
+.focus-attribution {
+  font-family: var(--font-body);
+  font-size: var(--fs-sub);
+  font-weight: 400;
+  color: var(--muted);
+  margin: 48px 0 0 0;
+}
+.focus-attribution::before { content: '# '; color: var(--accent); }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: IMAGE + TEXT
+   ───────────────────────────────────────────── */
+.image-pane {
+  flex: 1.15;
+  min-width: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--surface);
+  border: 2px solid var(--rule);
+  overflow: hidden;
+  position: relative;
+}
+.image-placeholder {
+  width: 100%;
+  height: 100%;
+  background: repeating-linear-gradient(135deg, var(--surface) 0 22px, var(--bg) 22px 44px);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.image-placeholder span {
+  font-family: var(--font-body);
+  font-size: 22px;
+  color: var(--muted);
+  background: var(--bg);
+  padding: 14px 20px;
+  border: 1px solid var(--rule);
+}
+.text-pane .title { font-size: var(--fs-h); }
+.text-pane .body-text + .body-text { margin-top: 8px; }
+.text-pane .eyebrow { margin-bottom: 12px; }
+
+/* ─────────────────────────────────────────────
+   LAYOUT: SPLIT — two panes, divided like a tmux split
+   ───────────────────────────────────────────── */
+.slide--split .split-columns { gap: 0; }
+.slide--split .split-left { padding-right: 56px; }
+.slide--split .split-right { padding-left: 56px; border-left: 2px solid var(--rule); }
+
+/* ─────────────────────────────────────────────
+   LISTS — > for bullets, [1] for numbers
+   ───────────────────────────────────────────── */
+.slide-body ul li {
+  font-weight: 400;
+  line-height: 1.45;
+  padding-left: 1.6em;
+  position: relative;
+}
+.slide-body ul li::before {
+  content: '>';
+  position: absolute;
+  left: 0;
+  top: 0;
+  color: var(--accent);
+  font-weight: 700;
+}
+.slide-body ol li {
+  padding-left: 2.6em;
+  font-weight: 400;
+  line-height: 1.45;
+}
+.slide-body ol li::before {
+  content: '[' counter(slide-ol) ']';
+  position: absolute;
+  left: 0;
+  top: 0;
+  font-weight: 700;
+  color: var(--accent);
+}
+
+/* ─────────────────────────────────────────────
+   LAYOUT: FULL-BLEED IMAGE
+   ───────────────────────────────────────────── */
+.slide--full-bleed-image.has-overlay .slide-bg::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.5);
+}
+.slide--full-bleed-image .overlay-title {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 700;
+  line-height: 1.15;
+  letter-spacing: -0.03em;
+  color: #fff;
+  margin: 0;
+  max-width: 1300px;
+  text-wrap: balance;
+}
+
+/* ─────────────────────────────────────────────
+   GENERIC / CONTENT SLIDE — the heading typed at the prompt
+   ───────────────────────────────────────────── */
+.slide-body h1 {
+  font-family: var(--font-display);
+  font-size: var(--fs-h);
+  font-weight: 700;
+  line-height: 1.15;
+  letter-spacing: -0.03em;
+  color: var(--ink);
+  margin: 0 0 var(--gap-title) 0;
+  max-width: 1600px;
+  text-wrap: balance;
+}
+:is(.slide-body, .split-heading) > h1:first-child::before {
+  content: var(--prompt);
+  color: var(--muted);
+  font-weight: 400;
+  letter-spacing: -0.04em;
+}
+.slide-body h2 {
+  font-family: var(--font-display);
+  font-size: var(--fs-sub);
+  font-weight: 700;
+  line-height: 1.2;
+  letter-spacing: -0.02em;
+  color: var(--ink);
+  margin: 0 0 var(--gap-item) 0;
+}
+.slide-body h2:not(.chapter-title)::before { content: '## '; color: var(--accent); font-weight: 400; }
+.slide-body p {
+  font-family: var(--font-body);
+  font-size: var(--fs-body);
+  font-weight: 400;
+  line-height: 1.55;
+  color: var(--ink-soft);
+  margin: 0 0 var(--gap-item) 0;
+  text-wrap: pretty;
+}
+.slide-body > p { max-width: 1550px; }
+
+/* ─────────────────────────────────────────────
+   CALLOUTS — log lines: a level in brackets, no box
+   ───────────────────────────────────────────── */
+.slide-body .callout {
+  --level: var(--accent);
+  display: flex;
+  align-items: baseline;
+  gap: 0.6em;
+  background: none;
+  border: 0;
+  padding: 0;
+  margin: 36px 0 0;
+}
+.slide-body :is(.callout-warning, .callout-caution, .callout-definition) { --level: var(--accent-2); }
+.slide-body .callout:is(.callout-theorem, .callout-lemma, .callout-corollary, .callout-definition) .callout-title { color: var(--level); }
+.slide-body .callout-important { --level: var(--ink); }
+.slide-body .callout .callout-title {
+  flex: none;
+  font-size: var(--fs-body);
+  font-weight: 700;
+  letter-spacing: 0;
+  text-transform: lowercase;
+  color: var(--level);
+  margin: 0;
+}
+.slide-body .callout .callout-title::before { content: '['; }
+.slide-body .callout .callout-title::after { content: ']'; }
+.slide-body .callout p { padding-left: 0; margin: 0; color: var(--ink); font-size: var(--fs-body); }
+.slide-body .callout > :not(.callout-title) + * { margin-top: 8px; }
+/* A proof is a log line too: [proof] … ∎ */
+.slide-body .callout.callout-proof { display: flex; }
+.slide-body .callout.callout-proof .callout-title { float: none; font-style: normal; text-transform: lowercase; color: var(--muted); }
+.slide-body .callout.callout-proof .callout-title::before { content: '['; }
+.slide-body .callout.callout-proof .callout-title::after { content: ']'; }
+
+/* ─────────────────────────────────────────────
+   CODE BLOCK — a window: a frame in the rule colour and a title bar
+   ───────────────────────────────────────────── */
+.code-block {
+  --code-bg: var(--bg);
+  --code-radius: 0;
+  --code-size: 26px;
+  background: var(--code-bg);
+  border: 2px solid var(--rule);
+  border-top: 0;
+  border-radius: 0;
+  padding: 32px 40px;
+  margin: 0;
+  overflow: hidden;
+  font-size: var(--code-size);
+  font-family: var(--font-body);
+  line-height: 1.6;
+}
+/* The title bar with three window buttons, above the code (outside it, so
+   it stays when tall code scrolls). */
+.code-block-wrapper::before {
+  content: '';
+  display: block;
+  height: 40px;
+  box-sizing: border-box;
+  border: 2px solid var(--rule);
+  background:
+    radial-gradient(circle at 24px 50%, var(--muted) 0 6px, transparent 7px),
+    radial-gradient(circle at 46px 50%, var(--muted) 0 6px, transparent 7px),
+    radial-gradient(circle at 68px 50%, var(--muted) 0 6px, transparent 7px),
+    var(--surface);
+}
+.code-block code {
+  font-family: inherit;
+  font-size: inherit;
+  background: none;
+  padding: 0;
+}
+.code-output { font-family: var(--font-body); border-radius: 0; }
+
+/* ─────────────────────────────────────────────
+   AUDIENCE QUESTIONS — square bars, a framed join code
+   ───────────────────────────────────────────── */
+.slide .poll-track, .slide .poll-fill, .slide .scale-track, .slide .scale-fill { border-radius: 0; }
+.slide .poll-track, .slide .scale-track { background: var(--surface); }
+.slide .question-cards li { border-radius: 0; background: var(--surface); }
+.slide .poll-join { border-radius: 0; border: 2px solid var(--rule); }
+
+/* ─────────────────────────────────────────────
+   MATH (KaTeX)
+   ───────────────────────────────────────────── */
+.slide .katex-display {
+  font-size: var(--fs-sub);
+  margin: 48px 0;
+  overflow-x: auto;
+  overflow-y: hidden;
+}

package/assets/logo/logo-dark.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 560 160" width="560" height="160">
+  <title>mdeck</title>
+  <g transform="translate(16 16) scale(0.25)">
+    <rect width="512" height="512" rx="96" fill="#0d9488"/>
+    <rect x="72" y="136" width="368" height="240" rx="18" fill="#f4f1e8"/>
+    <g fill="#0d9488"><rect x="132" y="176" width="26" height="160" rx="13"/><rect x="184" y="176" width="26" height="160" rx="13"/><rect x="102" y="222" width="140" height="26" rx="13"/><rect x="102" y="266" width="140" height="26" rx="13"/></g>
+    <g fill="#1b1a17" opacity="0.85"><rect x="268" y="226" width="130" height="20" rx="10"/><rect x="268" y="276" width="88" height="20" rx="10"/></g>
+  </g>
+  <text x="172" y="112" font-family="'Inter Tight', 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif" font-weight="800" font-size="96" letter-spacing="-3" fill="#f4f1e8">mdeck</text>
+</svg>

package/assets/logo/logo-light.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 560 160" width="560" height="160">
+  <title>mdeck</title>
+  <g transform="translate(16 16) scale(0.25)">
+    <rect width="512" height="512" rx="96" fill="#0d9488"/>
+    <rect x="72" y="136" width="368" height="240" rx="18" fill="#f4f1e8"/>
+    <g fill="#0d9488"><rect x="132" y="176" width="26" height="160" rx="13"/><rect x="184" y="176" width="26" height="160" rx="13"/><rect x="102" y="222" width="140" height="26" rx="13"/><rect x="102" y="266" width="140" height="26" rx="13"/></g>
+    <g fill="#1b1a17" opacity="0.85"><rect x="268" y="226" width="130" height="20" rx="10"/><rect x="268" y="276" width="88" height="20" rx="10"/></g>
+  </g>
+  <text x="172" y="112" font-family="'Inter Tight', 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif" font-weight="800" font-size="96" letter-spacing="-3" fill="#1b1a17">mdeck</text>
+</svg>

package/assets/logo/mark.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
+  <title>mdeck</title>
+  <rect width="512" height="512" rx="96" fill="#0d9488"/>
+  <rect x="72" y="136" width="368" height="240" rx="18" fill="#f4f1e8"/>
+  <g fill="#0d9488">
+    <rect x="132" y="176" width="26" height="160" rx="13"/>
+    <rect x="184" y="176" width="26" height="160" rx="13"/>
+    <rect x="102" y="222" width="140" height="26" rx="13"/>
+    <rect x="102" y="266" width="140" height="26" rx="13"/>
+  </g>
+  <g fill="#1b1a17" opacity="0.85">
+    <rect x="268" y="226" width="130" height="20" rx="10"/>
+    <rect x="268" y="276" width="88" height="20" rx="10"/>
+  </g>
+</svg>

package/bin/mdeck.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/cli/index.js'

package/docs/README.md

@@ -0,0 +1,8 @@
+# Documentation
+
+- [site/](site/) contains the documentation website and beginner-friendly guides.
+- [reference/](reference/) contains the technical references used by the site and
+  authoring tools.
+
+Run `mdeck docs` to open the guide, or `npm run docs:build` from the repository
+root to build static HTML in `docs/site/dist/`.