akceo 0.1.0__py3-none-any.whl

akceo/__init__.py

@@ -0,0 +1 @@
+"""Build self-contained HTML slide decks from Markdown."""

akceo/__main__.py

@@ -0,0 +1,3 @@
+from akceo.cli import main
+
+raise SystemExit(main())

akceo/assets/base.css

@@ -0,0 +1,64 @@
+/* Layout rules. Colors and fonts come from the theme's tokens (see docs/syntax.md#themes). */
+* { box-sizing: border-box; margin: 0; padding: 0; }
+html, body { height: 100%; background: var(--bg); color: var(--text); font-family: var(--font); overflow: hidden; }
+#deck { height: 100%; }
+.slide {
+  position: absolute; inset: 0; display: none; flex-direction: column;
+  justify-content: center; padding: 5.5vh 7vw 8vh; animation: fade .28s ease;
+}
+.slide.active { display: flex; }
+@keyframes fade { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: none; } }
+.kicker { color: var(--accent); font-weight: 700; letter-spacing: .14em; text-transform: uppercase;
+          font-size: clamp(11px, 1.3vw, 15px); margin-bottom: 1.4vh; }
+h1 { font-size: clamp(30px, 5.4vw, 62px); line-height: 1.05; letter-spacing: -.02em; }
+h2 { font-size: clamp(26px, 4vw, 46px); line-height: 1.08; letter-spacing: -.02em; margin-bottom: 2.4vh; }
+.lead { font-size: clamp(20px, 2.7vw, 34px); line-height: 1.32; color: var(--text); max-width: 42ch; }
+.hl { color: var(--accent); }
+.dim { color: var(--muted); }
+.strong { color: var(--strong); }
+p.sub { color: var(--muted); font-size: clamp(15px, 1.7vw, 21px); line-height: 1.5; margin-top: 2.2vh; max-width: 62ch; }
+ul { list-style: none; display: flex; flex-direction: column; gap: 1.5vh; margin-top: 1vh; }
+li { font-size: clamp(15px, 1.9vw, 24px); line-height: 1.34; padding-left: 1.4em; position: relative; max-width: 60ch; }
+li::before { content: "▸"; color: var(--accent); position: absolute; left: 0; top: 0; }
+li b { color: var(--strong); }
+code { font-family: var(--mono); color: var(--accent2); font-size: .92em; }
+.split { display: grid; grid-template-columns: 1fr 1fr; gap: 4vw; align-items: center; height: 100%; }
+.split.img-wide { grid-template-columns: 1.35fr 1fr; }
+.figwrap { height: 82vh; display: flex; align-items: center; justify-content: center; }
+.figwrap img, .figure-full img,
+.figwrap svg.diagram, .figure-full svg.diagram { max-width: 100%; max-height: 100%; object-fit: contain;
+               border-radius: 10px; background: var(--figure-bg); padding: 10px; box-shadow: var(--figure-shadow); }
+.placeholder { width: 100%; max-height: 100%; aspect-ratio: 4 / 3; border: 2px dashed var(--line);
+               border-radius: 10px; }
+.figure-full { flex: 1; min-height: 0; display: flex; align-items: center; justify-content: center; }
+.figure-full .placeholder { width: auto; height: 100%; max-width: 100%; }
+.kicker + .figure-full { margin-top: 2vh; }
+.figwrap img.bare, .figure-full img.bare,
+.figwrap svg.bare, .figure-full svg.bare { background: none; box-shadow: none; padding: 0; border-radius: 0; }
+/* A diagram's source waits hidden until the page script draws it as an <svg class="diagram">. */
+svg.diagram { width: auto; height: auto; }
+.diagram-src { display: none; }
+.diagram.failed { max-width: 100%; padding: 1em; border: 2px dashed var(--line); border-radius: 10px;
+                  color: var(--muted); white-space: pre-wrap; }
+.phase { border-left: 3px solid var(--accent); padding: .3em 0 .3em 1em; margin-bottom: 2.2vh; }
+.phase h3 { font-size: clamp(16px, 2vw, 25px); color: var(--strong); }
+.phase p { color: var(--muted); font-size: clamp(13px, 1.5vw, 19px); line-height: 1.4; margin-top: .3em; }
+.note-inline { color: var(--muted); font-size: clamp(13px, 1.5vw, 18px); margin-top: 2vh; font-style: italic; }
+ol.steps { counter-reset: s; display: flex; flex-direction: column; gap: 1.6vh; margin-top: 1vh; }
+ol.steps li { list-style: none; padding-left: 2.4em; }
+ol.steps li::before { counter-increment: s; content: counter(s); color: var(--bg); background: var(--accent);
+  width: 1.6em; height: 1.6em; border-radius: 50%; display: grid; place-items: center; font-weight: 700;
+  font-size: .8em; left: 0; top: .05em; }
+table { border-collapse: collapse; width: 100%; margin-top: 1vh; font-size: clamp(12px, 1.5vw, 19px); }
+th, td { text-align: left; padding: 1.2vh 1.1vw; border-bottom: 1px solid var(--line); vertical-align: top; }
+th { color: var(--accent); font-size: .8em; letter-spacing: .08em; text-transform: uppercase; }
+td:first-child b { color: var(--strong); }
+.title-wrap { text-align: center; align-items: center; justify-content: center; }
+.title-wrap .meta { color: var(--muted); font-size: clamp(14px, 1.7vw, 20px); margin-top: 3.2vh; }
+.title-wrap .rule { width: 64px; height: 4px; background: var(--accent); border-radius: 2px; margin: 3.4vh auto 0; }
+#hud { position: fixed; bottom: 0; left: 0; right: 0; height: 4px; background: transparent; z-index: 20; }
+#bar { height: 100%; background: var(--accent); width: 0; transition: width .28s ease; }
+#count { position: fixed; bottom: 14px; right: 20px; color: var(--muted); font-size: 13px;
+         font-family: var(--mono); z-index: 20; }
+#hint { position: fixed; bottom: 14px; left: 20px; color: var(--line); font-size: 12px;
+        font-family: var(--mono); z-index: 20; }

akceo/assets/deck.js

@@ -0,0 +1,33 @@
+var slides = Array.prototype.slice.call(document.querySelectorAll('.slide'));
+var i = 0;
+var bar = document.getElementById('bar');
+var count = document.getElementById('count');
+function render() {
+  slides.forEach(function(s, n){ s.classList.toggle('active', n === i); });
+  bar.style.width = (slides.length > 1 ? i / (slides.length - 1) * 100 : 100) + '%';
+  count.textContent = (i + 1) + ' / ' + slides.length;
+  // replaceState keeps slide steps out of the browser history and doesn't fire hashchange.
+  history.replaceState(null, '', '#' + (i + 1));
+}
+function go(n){ i = Math.max(0, Math.min(slides.length - 1, n)); render(); }
+// The hash holds the 1-based slide number, so a link or a reload opens that slide.
+function fromHash(){
+  var m = location.hash.match(/^#(\d+)$/);
+  return m ? parseInt(m[1], 10) - 1 : 0;
+}
+window.addEventListener('hashchange', function(){ go(fromHash()); });
+document.addEventListener('keydown', function(e){
+  if (e.key === 'ArrowRight' || e.key === ' ' || e.key === 'PageDown') { e.preventDefault(); go(i + 1); }
+  else if (e.key === 'ArrowLeft' || e.key === 'PageUp') { e.preventDefault(); go(i - 1); }
+  else if (e.key === 'Home') { go(0); }
+  else if (e.key === 'End') { go(slides.length - 1); }
+  else if (e.key === 'f' || e.key === 'F') {
+    if (!document.fullscreenElement) document.documentElement.requestFullscreen();
+    else document.exitFullscreen();
+  }
+});
+document.addEventListener('click', function(e){
+  if (String(window.getSelection())) return;
+  if (e.clientX > window.innerWidth * 0.5) go(i + 1); else go(i - 1);
+});
+go(fromHash());

akceo/assets/diagrams.js

@@ -0,0 +1,60 @@
+// Draw each Mermaid diagram as inline SVG in place of its source. The build has already checked
+// every diagram's syntax, so a failure here is one that only shows when drawing, such as a bad date.
+(function() {
+  var diagrams = Array.prototype.slice.call(document.querySelectorAll('.diagram'));
+  var theme = JSON.parse(document.getElementById('mermaid-theme').textContent);
+  // Mermaid sizes its SVG as width="100%" with an inline max-width. Give it a pixel size from its
+  // viewBox instead, so it scales to fit the frame the way an <img> does, under the same CSS rules.
+  function sized(markup, node) {
+    var holder = document.createElement('div');
+    holder.innerHTML = markup;
+    var svg = holder.querySelector('svg');
+    if (!svg) throw new Error('Mermaid returned no SVG');
+    var box = svg.viewBox && svg.viewBox.baseVal;
+    if (box && box.width && box.height) {
+      svg.setAttribute('width', Math.round(box.width));
+      svg.setAttribute('height', Math.round(box.height));
+      svg.style.maxWidth = '';
+    }
+    // The page's Content-Security-Policy blocks every outside load, and the build rejects outside
+    // links. Drop any link that still gets through, so a click can't leave the deck.
+    svg.querySelectorAll('*').forEach(function(el) {
+      Array.prototype.slice.call(el.attributes).forEach(function(attr) {
+        if (/^(xlink:)?href$/i.test(attr.name) && !/^\s*#/.test(attr.value)) el.removeAttributeNode(attr);
+      });
+    });
+    node.classList.forEach(function(name){ svg.classList.add(name); });
+    svg.setAttribute('role', 'img');
+    svg.setAttribute('aria-label', node.getAttribute('aria-label'));
+    return svg;
+  }
+  function failed(node, e) {
+    // The image role and its label would hide this text from screen readers.
+    node.removeAttribute('role');
+    node.removeAttribute('aria-label');
+    node.classList.add('failed');
+    node.textContent = 'Mermaid could not draw this diagram: ' + ((e && e.message) || e);
+  }
+  // Never rejects: any error, from Mermaid or from sizing, marks this diagram failed and leaves the
+  // rest to draw.
+  function draw(node, n) {
+    return Promise.resolve().then(function() {
+      var source = node.querySelector('.diagram-src').textContent;
+      // An unframed diagram takes the theme's colors; one in a frame keeps Mermaid's defaults.
+      // initialize starts again from Mermaid's defaults each time, so one diagram can't leak into
+      // the next. suppressErrorRendering stops Mermaid leaving its own error graphic in the page.
+      var colors = node.dataset.mermaid === 'theme' ? theme : {};
+      mermaid.initialize(Object.assign({ startOnLoad: false, suppressErrorRendering: true }, colors));
+      return mermaid.render('diagram-' + n, source);
+    }).then(function(result) {
+      node.replaceWith(sized(result.svg, node));
+    }).catch(function(e) {
+      failed(node, e);
+    });
+  }
+  // The theme's fonts change the size of the text, so wait for them before Mermaid measures it.
+  // One at a time, because initialize sets Mermaid's config for the whole page.
+  diagrams.reduce(function(done, node, n) {
+    return done.then(function() { return draw(node, n); });
+  }, document.fonts.ready);
+})();

akceo/assets/md-viewer.html

@@ -0,0 +1,257 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Markdown Viewer</title>
+<style>
+  :root{
+    --bg:#0b0f16; --panel:#111925; --line:#22314a; --text:#e8eef6; --muted:#93a4bd;
+    --accent:#5eead4; --accent2:#fbbf24; --warn:#f87171; --fs:18px;
+    --sans:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
+    --mono:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
+  }
+  *{box-sizing:border-box;margin:0;padding:0}
+  html,body{height:100%}
+  body{background:var(--bg);color:var(--text);font-family:var(--sans);display:flex;flex-direction:column}
+  header{display:flex;align-items:center;gap:14px;padding:10px 18px;border-bottom:1px solid var(--line);
+         background:var(--panel);position:sticky;top:0;z-index:5;flex:none}
+  header .name{color:var(--accent);font-family:var(--mono);font-size:13px;overflow:hidden;
+               text-overflow:ellipsis;white-space:nowrap;flex:1}
+  header .name .idle{color:var(--muted)}
+  button{font:inherit;font-size:13px;color:var(--text);background:#1b2740;border:1px solid var(--line);
+         border-radius:7px;padding:6px 12px;cursor:pointer}
+  button:hover{border-color:var(--accent);color:#fff}
+  button.accent{background:var(--accent);color:#06231d;border-color:var(--accent);font-weight:600}
+  .fsz{display:flex;gap:4px}
+  .fsz button{padding:6px 10px}
+  #status{color:var(--muted);font-size:12px;font-family:var(--mono)}
+  #status.on{color:var(--accent2)}
+  #status.warn{color:var(--warn)}
+  main{flex:1;overflow-y:auto}
+  #empty{height:100%;display:flex;flex-direction:column;align-items:center;justify-content:center;
+         gap:14px;color:var(--muted);text-align:center;padding:40px}
+  #empty .big{font-size:22px;color:var(--text)}
+  #content{max-width:80ch;margin:0 auto;padding:40px 48px 120px;font-size:var(--fs);line-height:1.62;display:none}
+  #content h1{font-size:1.9em;margin:.2em 0 .5em;letter-spacing:-.01em;border-bottom:1px solid var(--line);padding-bottom:.2em}
+  #content h2{font-size:1.5em;margin:1.4em 0 .5em;letter-spacing:-.01em}
+  #content h3{font-size:1.2em;margin:1.5em 0 .4em;color:#fff}
+  #content h3 em{color:var(--accent2);font-style:normal;font-size:.82em;font-family:var(--mono)}
+  #content h4{font-size:1.02em;margin:1.2em 0 .3em;color:var(--muted);text-transform:uppercase;letter-spacing:.06em}
+  #content p{margin:.7em 0}
+  #content ul,#content ol{margin:.6em 0 .6em 1.5em}
+  #content li{margin:.32em 0}
+  #content li>ul,#content li>ol{margin:.2em 0 .2em 1.3em}
+  #content img{max-width:100%;height:auto;border-radius:8px}
+  #content strong{color:#fff}
+  #content em{color:var(--text)}
+  #content a{color:var(--accent);text-decoration:none;border-bottom:1px solid rgba(94,234,212,.3)}
+  #content a:hover{border-bottom-color:var(--accent)}
+  #content code{font-family:var(--mono);font-size:.88em;background:#182338;color:var(--accent2);
+                padding:2px 6px;border-radius:5px}
+  #content pre{background:#0e1626;border:1px solid var(--line);border-radius:10px;padding:16px;
+               overflow-x:auto;margin:1em 0}
+  #content pre code{background:none;color:#cdd8e6;padding:0;font-size:.86em}
+  #content blockquote{border-left:3px solid var(--accent);background:#0e1626;margin:1em 0;padding:.6em 1.1em;
+                      color:var(--muted);border-radius:0 8px 8px 0}
+  #content hr{border:none;border-top:1px solid var(--line);margin:2em 0}
+  #content table{border-collapse:collapse;width:100%;margin:1em 0;font-size:.92em;display:block;overflow-x:auto}
+  #content th,#content td{border:1px solid var(--line);padding:9px 12px;text-align:left;vertical-align:top}
+  #content th{background:#0e1626;color:var(--accent);font-size:.85em;letter-spacing:.04em;text-transform:uppercase}
+  #drop{position:fixed;inset:0;background:rgba(11,15,22,.92);border:3px dashed var(--accent);
+        display:none;align-items:center;justify-content:center;font-size:26px;color:var(--accent);z-index:20}
+  #drop.show{display:flex}
+</style>
+</head>
+<body>
+<header>
+  <span class="name"><span class="idle">No file loaded</span></span>
+  <span id="status" role="status"></span>
+  <div class="fsz"><button id="minus" title="Smaller text">A&minus;</button><button id="plus" title="Larger text">A+</button></div>
+  <button id="open" class="accent">Open .md</button>
+  <input id="file" type="file" accept=".md,.markdown,.txt,text/markdown" hidden>
+</header>
+<main>
+  <div id="empty">
+    <div class="big">Open or drop a Markdown file</div>
+    <div id="hint"></div>
+  </div>
+  <article id="content"></article>
+</main>
+<div id="drop">Drop to open</div>
+
+<script>
+(function(){
+  var nameEl=document.querySelector('.name'), statusEl=document.getElementById('status'),
+      main=document.querySelector('main'), content=document.getElementById('content'),
+      empty=document.getElementById('empty'), drop=document.getElementById('drop'),
+      input=document.getElementById('file');
+  // File System Access API: Chrome and Edge, including pages opened from file://.
+  var canWatch=!!window.showOpenFilePicker;
+  document.getElementById('hint').textContent=canWatch
+    ?'It refreshes by itself whenever you save the file.'
+    :'This browser can\'t watch files, so drop the file again to refresh after edits.';
+
+  var fs=parseInt(localStorage.getItem('mdv_fs')||'18',10); applyFontSize();
+  function applyFontSize(){document.documentElement.style.setProperty('--fs',fs+'px');localStorage.setItem('mdv_fs',fs);}
+  document.getElementById('plus').onclick=function(){fs=Math.min(30,fs+1);applyFontSize();};
+  document.getElementById('minus').onclick=function(){fs=Math.max(12,fs-1);applyFontSize();};
+
+  var LIST_ITEM=/^([ \t]*)([-*+]|\d+\.)[ \t]+(.*)$/;
+  function esc(s){return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');}
+  function safeUrl(url,schemes){
+    // URL parsers drop control characters and spaces, so "java\tscript:" would still run as javascript:.
+    url=url.replace(/[\u0000-\u0020]/g,'');
+    var scheme=url.match(/^([a-z][a-z0-9+.-]*):/i);
+    return scheme&&!schemes.test(scheme[1])?null:url.replace(/"/g,'&quot;');
+  }
+  function link(text,url){
+    url=safeUrl(url,/^(https?|mailto)$/i);
+    return url===null?text:'<a href="'+url+'" target="_blank" rel="noopener">'+text+'</a>';
+  }
+  function image(alt,url){
+    url=safeUrl(url,/^(https?|data)$/i);
+    if(url===null||(/^data:/i.test(url)&&!/^data:image\//i.test(url)))return alt;
+    return '<img src="'+url+'" alt="'+alt.replace(/"/g,'&quot;')+'">';
+  }
+  // [text](url) and ![alt](src). Parentheses inside the URL are matched in pairs.
+  function links(s,hold){
+    var out='',i=0;
+    while(i<s.length){
+      var open=s.indexOf('[',i);
+      if(open<0)break;
+      var close=s.indexOf(']',open);
+      if(close<0)break;
+      var j=close+2,depth=1;
+      if(s.charAt(close+1)==='('){
+        while(j<s.length){if(s[j]==='(')depth++;else if(s[j]===')'&&--depth===0)break;j++;}
+      }
+      if(s.charAt(close+1)!=='('||depth){out+=s.slice(i,open+1);i=open+1;continue;}
+      var isImage=s.charAt(open-1)==='!',text=s.slice(open+1,close),url=s.slice(close+2,j);
+      out+=s.slice(i,isImage?open-1:open)+hold(isImage?image(text,url):link(text,url));
+      i=j+1;
+    }
+    return out+s.slice(i);
+  }
+  // Items indented deeper than the one before nest under it.
+  function listHtml(items){
+    var out='',open=[];
+    items.forEach(function(it){
+      while(open.length&&it.indent<open[open.length-1].indent)out+='</li></'+open.pop().tag+'>';
+      var top=open[open.length-1];
+      if(top&&it.indent===top.indent&&it.tag===top.tag){out+='</li><li>';}
+      else{
+        if(top&&it.indent===top.indent)out+='</li></'+open.pop().tag+'>';
+        open.push({indent:it.indent,tag:it.tag});out+='<'+it.tag+'><li>';
+      }
+      out+=inline(it.text);
+    });
+    while(open.length)out+='</li></'+open.pop().tag+'>';
+    return out;
+  }
+  function inline(s){
+    var held=[];
+    function hold(html){held.push(html);return '\uE000'+(held.length-1)+'\uE000';}
+    s=esc(s);
+    s=s.replace(/`([^`]+)`/g,function(m,c){return hold('<code>'+c+'</code>');});
+    s=links(s,hold);
+    s=s.replace(/\*\*([^*]+)\*\*/g,'<strong>$1</strong>');
+    s=s.replace(/(^|[^*])\*([^*\s][^*]*?)\*/g,'$1<em>$2</em>');
+    s=s.replace(/(^|[^\w])_([^_\s][^_]*?)_/g,'$1<em>$2</em>');
+    return s.replace(/\uE000(\d+)\uE000/g,function(m,i){return held[i];});
+  }
+  function splitRow(l){return l.trim().replace(/^\|/,'').replace(/\|$/,'').split('|').map(function(c){return c.trim();});}
+  function md(src){
+    var lines=src.replace(/\r\n?/g,'\n').split('\n'),out='',i=0,n=lines.length,para=[];
+    function flush(){if(para.length){out+='<p>'+inline(para.join(' '))+'</p>';para=[];}}
+    while(i<n){
+      var line=lines[i];
+      if(/^```/.test(line)){flush();i++;var code=[];while(i<n&&!/^```/.test(lines[i])){code.push(lines[i]);i++;}i++;out+='<pre><code>'+esc(code.join('\n'))+'</code></pre>';continue;}
+      if(/^\s*$/.test(line)){flush();i++;continue;}
+      var h=line.match(/^(#{1,6})\s+(.*)$/);
+      if(h){flush();out+='<h'+h[1].length+'>'+inline(h[2])+'</h'+h[1].length+'>';i++;continue;}
+      if(/^(-{3,}|\*{3,}|_{3,})\s*$/.test(line)){flush();out+='<hr>';i++;continue;}
+      if(/\|/.test(line)&&i+1<n&&/-/.test(lines[i+1])&&/^\s*\|?[\s:|-]+\|?\s*$/.test(lines[i+1])){
+        flush();var head=splitRow(line);i+=2;var rows=[];
+        while(i<n&&/\|/.test(lines[i])&&!/^\s*$/.test(lines[i])){rows.push(splitRow(lines[i]));i++;}
+        out+='<table><thead><tr>'+head.map(function(c){return '<th>'+inline(c)+'</th>';}).join('')+'</tr></thead><tbody>'+
+             rows.map(function(r){return '<tr>'+r.map(function(c){return '<td>'+inline(c)+'</td>';}).join('')+'</tr>';}).join('')+'</tbody></table>';continue;}
+      if(/^>\s?/.test(line)){flush();var bq=[];while(i<n&&/^>\s?/.test(lines[i])){bq.push(lines[i].replace(/^>\s?/,''));i++;}out+='<blockquote>'+md(bq.join('\n'))+'</blockquote>';continue;}
+      if(LIST_ITEM.test(line)){
+        flush();var items=[];
+        while(i<n){
+          var m=lines[i].match(LIST_ITEM);
+          if(m){items.push({indent:m[1].replace(/\t/g,'    ').length,tag:/\d/.test(m[2])?'ol':'ul',text:m[3]});i++;}
+          else if(/^[ \t]+\S/.test(lines[i])){items[items.length-1].text+=' '+lines[i].trim();i++;}
+          else if(/^\s*$/.test(lines[i])&&i+1<n&&LIST_ITEM.test(lines[i+1])){i++;}
+          else break;
+        }
+        out+=listHtml(items);continue;
+      }
+      para.push(line);i++;
+    }
+    flush();return out;
+  }
+
+  function setStatus(text,cls){statusEl.textContent=text;statusEl.className=cls||'';}
+  function render(text,name,keepScroll){
+    var top=main.scrollTop;
+    content.innerHTML=md(text);
+    content.style.display='block';empty.style.display='none';
+    nameEl.textContent=name||'document';document.title=(name||'Markdown')+' — Viewer';
+    main.scrollTop=keepScroll?top:0;
+  }
+
+  // Reads finish out of order. Each open bumps the generation, and a read only renders if its
+  // generation is still current, so the latest selection always wins.
+  var handle=null,lastMod=0,generation=0,polling=false;
+  function openHandle(h){
+    var gen=++generation;
+    return h.getFile().then(function(f){
+      return f.text().then(function(t){
+        if(gen!==generation)return;
+        handle=h;lastMod=f.lastModified;render(t,f.name,false);setStatus('● watching','on');
+      });
+    });
+  }
+  function openFile(f){
+    var gen=++generation;handle=null;
+    f.text().then(function(t){
+      if(gen!==generation)return;
+      render(t,f.name,false);setStatus(canWatch?'not watching · use Open to watch':'drop again to refresh');
+    });
+  }
+  setInterval(function(){
+    if(!handle||polling)return;
+    var h=handle,gen=generation;polling=true;
+    h.getFile().then(function(f){
+      if(gen!==generation||f.lastModified===lastMod)return;
+      return f.text().then(function(t){if(gen!==generation)return;lastMod=f.lastModified;render(t,f.name,true);});
+    }).catch(function(){if(gen===generation){handle=null;setStatus('file unavailable · open it again','warn');}})
+      .then(function(){polling=false;});
+  },1500);
+
+  document.getElementById('open').onclick=function(){
+    if(!canWatch){input.click();return;}
+    window.showOpenFilePicker({types:[{description:'Markdown',accept:{'text/markdown':['.md','.markdown','.txt']}}]})
+      .then(function(picks){return openHandle(picks[0]);})
+      .catch(function(err){if(err&&err.name!=='AbortError')input.click();});
+  };
+  input.addEventListener('change',function(e){var f=e.target.files[0];if(f)openFile(f);input.value='';});
+
+  window.addEventListener('dragover',function(e){e.preventDefault();drop.classList.add('show');});
+  window.addEventListener('dragleave',function(e){if(e.relatedTarget===null)drop.classList.remove('show');});
+  window.addEventListener('drop',function(e){
+    e.preventDefault();drop.classList.remove('show');
+    // The drop's data is only readable during this event, so take the file and ask for its handle now.
+    var file=e.dataTransfer.files[0],item=e.dataTransfer.items&&e.dataTransfer.items[0];
+    if(!file)return;
+    var pending=item&&item.getAsFileSystemHandle?item.getAsFileSystemHandle():null;
+    if(!pending){openFile(file);return;}
+    pending.then(function(h){return h&&h.kind==='file'?openHandle(h):openFile(file);})
+           .catch(function(){openFile(file);});
+  });
+})();
+</script>
+</body>
+</html>

akceo/assets/mermaid-shims.js

@@ -0,0 +1,76 @@
+// Loaded into V8 before mermaid.min.js so that mermaid.parse() can run without a browser. Only the
+// build-time diagram check uses this file; the built page never includes it.
+
+// DOMPurify, finding no DOM, returns a bare object and sets isSupported = false on it. Catch that
+// assignment and give the object no-op methods: checking syntax never sanitizes anything.
+Object.defineProperty(Function.prototype, "isSupported", {
+  configurable: true,
+  set(value) {
+    Object.defineProperty(this, "isSupported", { value, writable: true, configurable: true });
+    if (!value) {
+      const noop = () => {};
+      Object.assign(this, {
+        addHook: noop, removeHook: noop, removeHooks: noop, removeAllHooks: noop,
+        setConfig: noop, clearConfig: noop, isValidAttribute: () => true, sanitize: (dirty) => dirty,
+      });
+    }
+  },
+});
+
+// The parsers of the newer diagram types (pie, gitGraph, architecture and others) encode text.
+globalThis.TextEncoder = class {
+  get encoding() { return "utf-8"; }
+  encode(text = "") {
+    const out = [];
+    for (const ch of text) {
+      const c = ch.codePointAt(0);
+      if (c < 0x80) out.push(c);
+      else if (c < 0x800) out.push(0xc0 | (c >> 6), 0x80 | (c & 63));
+      else if (c < 0x10000) out.push(0xe0 | (c >> 12), 0x80 | ((c >> 6) & 63), 0x80 | (c & 63));
+      else out.push(0xf0 | (c >> 18), 0x80 | ((c >> 12) & 63), 0x80 | ((c >> 6) & 63), 0x80 | (c & 63));
+    }
+    return new Uint8Array(out);
+  }
+};
+
+// Only plain parse results pass through here, so a recursive copy is enough.
+globalThis.structuredClone = function clone(value) {
+  if (value === null || typeof value !== "object") return value;
+  if (Array.isArray(value)) return value.map(clone);
+  if (value instanceof Map) return new Map([...value].map(([k, v]) => [clone(k), clone(v)]));
+  if (value instanceof Set) return new Set([...value].map(clone));
+  if (value instanceof Date) return new Date(value);
+  return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, clone(v)]));
+};
+
+// A click link's http(s) URL is tidied with new URL(). The check only needs that not to throw.
+globalThis.URL = class URL {
+  constructor(href) {
+    const m = /^([a-z][a-z0-9+.-]*:)\/\/([^/?#]*)(.*)$/i.exec(String(href));
+    if (!m) throw new TypeError("Invalid URL: " + href);
+    [, this.protocol, this.hostname, this.rest] = m;
+  }
+  get href() { return this.protocol + "//" + this.hostname + this.rest; }
+  toString() { return this.href; }
+  static canParse(href) {
+    try { new URL(href); return true; } catch (e) { return false; }
+  }
+};
+
+// Resolves to null when the diagram parses, or to Mermaid's error as JSON. A YAML error from front
+// matter or @{...} shape data counts its line within that snippet, not within the file.
+globalThis.akceoCheck = async (source) => {
+  try {
+    await mermaid.parse(source);
+    return null;
+  } catch (e) {
+    return JSON.stringify({
+      name: String((e && e.name) || "Error"),
+      message: String((e && e.message) || e),
+      yamlLine: e && e.mark && typeof e.mark.line === "number" ? e.mark.line : null,
+    });
+  }
+};
+
+// Mermaid refuses to draw a longer diagram. parse() doesn't check it, so the build does.
+globalThis.akceoMaxTextSize = () => mermaid.mermaidAPI.getConfig().maxTextSize;

akceo/assets/page.html

@@ -0,0 +1,27 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; font-src data:">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>__TITLE__</title>
+<style>
+__STYLE__
+</style>
+</head>
+<body>
+<div id="deck">
+
+__SLIDES__
+
+</div>
+
+<div id="hud"><div id="bar"></div></div>
+<div id="count"></div>
+<div id="hint">&larr; &rarr; move &middot; F full screen</div>
+
+<script>
+__SCRIPT__
+</script>
+__DIAGRAMS__</body>
+</html>

akceo/assets/vendor/mermaid/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 - 2022 Knut Sveidqvist
+
+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.

akceo/assets/vendor/mermaid/README.md

@@ -0,0 +1,56 @@
+# Vendored Mermaid
+
+`mermaid.min.js` is the browser build of [Mermaid](https://mermaid.js.org), taken from the npm
+package. akceo uses it twice:
+
+- At build time, `akceo.mermaid` runs its `parse()` in V8 (through mini-racer) to check each `.mmd`
+  diagram, so syntax errors stop the build.
+- In the built page, it draws each diagram as inline SVG when the deck opens.
+
+`manifest.json` records the version, the tarball it came from, npm's integrity hash, the lockfile
+the notices come from, and the SHA-256 of the file here. A test checks the file against that SHA-256.
+
+## Licenses
+
+Mermaid is MIT licensed; see `LICENSE`. The file also bundles other packages, listed with their
+license texts in `THIRD_PARTY_NOTICES`. The list comes from `pnpm-lock.yaml` in Mermaid's
+repository at the release tag, the lockfile the bundle was built from, so each version matches the
+bundle. It covers Mermaid's production dependencies, optional ones included, plus the
+devDependencies that the linked workspace package `@mermaid-js/parser` compiles into its own output,
+such as langium.
+
+Not covered yet: Mermaid's own devDependencies (about 40). If esbuild inlines one of them into the
+bundle, it is missing from the notices, and the script doesn't notice.
+
+One bundled package, elkjs, is EPL-2.0, which asks that recipients be told where its source is:
+https://github.com/kieler/elkjs. Every built deck that has a diagram carries the notices, and that
+line, in a comment.
+
+## The one change from upstream
+
+A raw control character inside a string literal is replaced with its `\xNN` escape. JavaScript reads
+both forms the same way, but a raw control character is unsafe in an HTML page, and a test checks
+that the packaged assets carry none. `manifest.json` records how many were escaped.
+
+## Updating
+
+```sh
+uv run python scripts/update_mermaid.py 12.0.0   # the new version
+uv run pytest
+```
+
+The script downloads the tarball, checks it against npm's integrity hash, applies the change above
+and builds the notices by downloading each locked package and checking it against the lockfile's
+integrity hash. It writes the folder only after every step succeeds, so a failed update leaves it
+as it was. It stops, and writes nothing, when:
+
+- a linked workspace package (today only `@mermaid-js/parser`) has a devDependency the script
+  hasn't sorted. Check whether that package ends up in `mermaid.min.js`, then add it to
+  `BUNDLED_DEV_DEPENDENCIES` or `BUILD_ONLY_DEV_DEPENDENCIES` in the script.
+- the walk misses a package the bundle certainly holds (`ANCHOR_PACKAGES`), which means the
+  lockfile's layout has changed under the script's reader.
+- a package has no license file. Find its copyright notice, then add it to `NO_LICENSE_FILE`.
+
+Then run the full test suite: `tests/test_mermaid.py` runs the real parser, so a Mermaid release
+that no longer works with the stand-ins in `assets/mermaid-shims.js` fails there. Build
+`examples/demo/deck.md` and look at the diagram slide too, since drawing isn't covered by the tests.