RubyGems - apex-ruby - Versions diffs - 1.0.6 - Mend

apex-ruby 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (501) hide show

data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Limitations-and-Roadmap.html ADDED Viewed

@@ -0,0 +1,1698 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+      <meta charset="UTF-8">
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <meta name="generator" content="Apex 0.1.49">
+      <title>Document</title>
+      <style>
+        body {
+          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+          line-height: 1.6;
+          max-width: 800px;
+          margin: 2rem auto;
+          padding: 0 1rem;
+          color: #333;
+        }
+        pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; }
+        code { background: #f0f0f0; padding: 0.2em 0.4em; border-radius: 3px; }
+        blockquote { border-left: 4px solid #ddd; margin: 0; padding-left: 1rem; color: #666; }
+        table { border-collapse: collapse; width: 100%%; }
+        th, td { border: 1px solid #ddd; padding: 0.5rem; }
+        th { background: #f5f5f5; }
+        tfoot td { background: #e8e8e8; }
+        figure.table-figure { width: fit-content; margin: 1em 0; }
+        figure.table-figure table { width: auto; }
+        figcaption { text-align: center; font-weight: bold; font-size: 0.8em; }
+        .page-break { page-break-after: always; }
+        .callout { padding: 1rem; margin: 1rem 0; border-left: 4px solid; }
+        .callout-note { border-color: #3b82f6; background: #eff6ff; }
+        .callout-warning { border-color: #f59e0b; background: #fffbeb; }
+        .callout-tip { border-color: #10b981; background: #f0fdf4; }
+        .callout-danger { border-color: #ef4444; background: #fef2f2; }
+        ins { background: #d4fcbc; text-decoration: none; }
+        del { background: #fbb6c2; text-decoration: line-through; }
+        mark { background: #fff3cd; }
+        .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
+      </style>
+  <style>
+/* Base styles */
+body {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  font-size: 17px;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+    "Helvetica Neue", Arial, sans-serif;
+  line-height: 1.65;
+  color: #1e293b;
+  background-color: #fff;
+}
+/* Sidebar / Main TOC - wider on larger screens */
+.main-toc,
+.sidebar {
+  position: fixed;
+  left: 0;
+  top: 0;
+  width: auto;
+  min-width: 180px;
+  max-width: 250px;
+  height: 100vh;
+  overflow-y: auto;
+  background: #1e293b;
+  color: rgba(255, 255, 255, 0.9);
+  border-right: 2px solid rgba(255, 255, 255, 0.1);
+  padding: 24px 20px 130px;
+  font-size: 14px;
+  z-index: 100;
+  margin-right: 1rem;
+  box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
+  transition: transform 0.3s ease;
+}
+.main-toc ul,
+.sidebar ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0;
+  padding-bottom: 80px;
+}
+.main-toc ul::after,
+.sidebar ul::after {
+  content: "";
+  display: block;
+  height: 80px;
+}
+.main-toc li,
+.sidebar li {
+  margin: 0.25em 0;
+}
+.main-toc a,
+.sidebar a {
+  color: rgba(255, 255, 255, 0.85);
+  text-decoration: none;
+  display: block;
+  padding: 6px 12px;
+  border-radius: 4px;
+  transition: all 0.15s ease;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.main-toc a:hover,
+.sidebar a:hover {
+  background: #334155;
+  color: #fff;
+}
+.sidebar a.active {
+  color: #0ea5e9;
+  font-weight: 500;
+}
+/* Body margin for sidebar */
+body {
+  margin-left: 270px;
+}
+/* Hamburger menu button */
+.hamburger-menu {
+  display: none;
+  position: fixed;
+  top: 12px;
+  left: 12px;
+  z-index: 200;
+  background: #1e293b;
+  border: 2px solid rgba(255, 255, 255, 0.1);
+  border-radius: 6px;
+  padding: 10px;
+  cursor: pointer;
+  color: rgba(255, 255, 255, 0.9);
+  font-size: 20px;
+  line-height: 1;
+  width: 44px;
+  height: 44px;
+  align-items: center;
+  justify-content: center;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+  transition: all 0.2s ease;
+  opacity: 0.2;
+}
+.hamburger-menu:hover {
+  background: #334155;
+  color: #fff;
+  opacity: 1;
+}
+/* Move hamburger to the right of the sidebar when menu is open */
+.hamburger-menu.active {
+  left: calc(
+    250px + 12px
+  ); /* Position just to the right of sidebar (max-width 250px + 12px padding) */
+}
+.hamburger-menu.active {
+  background: #0ea5e9;
+}
+.hamburger-menu::before {
+  content: "☰";
+}
+.hamburger-menu.active::before {
+  content: "✕";
+}
+/* Mobile menu overlay */
+.mobile-menu-overlay {
+  display: none;
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  z-index: 150;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.3s ease, visibility 0.3s ease;
+}
+.mobile-menu-overlay.active {
+  opacity: 1;
+  visibility: visible;
+}
+/* Page TOC */
+.page-toc {
+  background: #f9f9f9;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  padding: 1rem;
+  margin: 1.5rem 0;
+}
+.page-toc ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0;
+}
+.page-toc > ul {
+  padding-left: 0;
+}
+.page-toc li {
+  margin: 0.25em 0;
+}
+.page-toc a {
+  color: #0066cc;
+  text-decoration: none;
+  display: block;
+  padding: 0.25em 0.5em;
+  border-radius: 3px;
+}
+.page-toc a:hover {
+  background: #e0e0e0;
+  color: #004499;
+}
+.page-toc ul ul {
+  list-style: none;
+  padding-left: 1.5em;
+  margin-top: 0.25em;
+  margin-left: 0;
+}
+.page-toc ul ul ul {
+  padding-left: 1.5em;
+}
+.page-toc ul ul a {
+  font-size: 0.9em;
+  color: #555;
+}
+.page-toc ul ul ul a {
+  font-size: 0.85em;
+  color: #666;
+}
+/* Floating TOC */
+.floating-toc {
+  position: fixed;
+  top: 0;
+  left: 270px;
+  right: 0;
+  z-index: 50;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.2s ease, visibility 0.2s ease;
+  pointer-events: none;
+  display: flex;
+  justify-content: flex-end;
+  padding-right: 2rem;
+}
+.floating-toc.visible {
+  opacity: 1;
+  visibility: visible;
+  pointer-events: auto;
+}
+.floating-toc-container {
+  background: rgba(255, 255, 255, 0.95);
+  backdrop-filter: blur(10px);
+  border-bottom: 1px solid #ddd;
+  border-radius: 0 0 12px 12px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  width: fit-content;
+  max-width: 400px;
+  min-width: 200px;
+  overflow: hidden;
+  transition: max-height 0.3s ease;
+}
+.floating-toc-header {
+  padding: 8px 16px;
+  cursor: pointer;
+  user-select: none;
+  font-size: 14px;
+  font-weight: 500;
+  color: #1e293b;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.floating-toc-header:hover {
+  background: rgba(0, 0, 0, 0.02);
+}
+.floating-toc-content {
+  max-height: 0;
+  overflow: hidden;
+  transition: max-height 0.3s ease;
+}
+.floating-toc-container:hover .floating-toc-content {
+  max-height: 70vh;
+  overflow-y: auto;
+}
+.floating-toc-content ul {
+  list-style: none;
+  padding: 8px 16px 16px;
+  margin: 0;
+}
+.floating-toc-content li {
+  margin: 0.1em 0;
+}
+.floating-toc-content a {
+  color: #0066cc;
+  text-decoration: none;
+  display: block;
+  padding: 0.2em 0.5em;
+  border-radius: 4px;
+  font-size: 13px;
+  transition: background 0.15s ease;
+}
+.floating-toc-content a:hover {
+  background: #e0e0e0;
+  color: #004499;
+}
+.floating-toc-content ul ul {
+  padding-left: 1.2em;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.floating-toc-content ul ul ul {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.floating-toc-content ul ul a {
+  font-size: 12px;
+  color: #555;
+}
+.floating-toc-content ul ul ul a {
+  font-size: 11px;
+  color: #666;
+}
+/* Smooth scrolling */
+html {
+  scroll-behavior: smooth;
+}
+/* Code blocks */
+code {
+  background: #f0f0f0;
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+  font-family: "Monaco", "Menlo", "Ubuntu Mono", monospace;
+  font-size: 0.9em;
+  margin: 0 0.1em;
+}
+pre {
+  background: #f5f5f5;
+  padding: 1rem;
+  overflow-x: auto;
+  border-radius: 4px;
+  margin: 1em 0;
+}
+pre code {
+  background: none;
+  padding: 0;
+  margin: 0;
+}
+/* Rouge syntax highlighting - GitHub theme, scoped to .highlight containers */
+.highlight {
+  color: #24292e;
+}
+.highlight .c {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment */
+.highlight .err {
+  color: #a61717;
+  background-color: #e3d2d2;
+} /* Error */
+.highlight .k {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword */
+.highlight .l {
+  color: #032f62;
+} /* Literal */
+.highlight .n {
+  color: #24292e;
+} /* Name */
+.highlight .o {
+  color: #d73a49;
+} /* Operator */
+.highlight .p {
+  color: #24292e;
+} /* Punctuation */
+.highlight .cm {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment.Multiline */
+.highlight .cp {
+  color: #6a737d;
+  font-weight: bold;
+} /* Comment.Preproc */
+.highlight .c1 {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment.Single */
+.highlight .cs {
+  color: #6a737d;
+  font-weight: bold;
+  font-style: italic;
+} /* Comment.Special */
+.highlight .gd {
+  color: #24292e;
+  background-color: #ffeef0;
+} /* Generic.Deleted */
+.highlight .ge {
+  color: #24292e;
+  font-style: italic;
+} /* Generic.Emph */
+.highlight .gr {
+  color: #aa0000;
+} /* Generic.Error */
+.highlight .gh {
+  color: #999999;
+  font-weight: bold;
+} /* Generic.Heading */
+.highlight .gi {
+  color: #24292e;
+  background-color: #f0fff4;
+} /* Generic.Inserted */
+.highlight .go {
+  color: #888888;
+} /* Generic.Output */
+.highlight .gp {
+  color: #555555;
+} /* Generic.Prompt */
+.highlight .gs {
+  font-weight: bold;
+} /* Generic.Strong */
+.highlight .gu {
+  color: #aaaaaa;
+} /* Generic.Subheading */
+.highlight .gt {
+  color: #aa0000;
+} /* Generic.Traceback */
+.highlight .kc {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Constant */
+.highlight .kd {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Declaration */
+.highlight .kn {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Namespace */
+.highlight .kp {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Pseudo */
+.highlight .kr {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Reserved */
+.highlight .kt {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Type */
+.highlight .ld {
+  color: #032f62;
+} /* Literal.Date */
+.highlight .m {
+  color: #005cc5;
+} /* Literal.Number */
+.highlight .s {
+  color: #032f62;
+} /* Literal.String */
+.highlight .na {
+  color: #6f42c1;
+} /* Name.Attribute */
+.highlight .nb {
+  color: #005cc5;
+} /* Name.Builtin */
+.highlight .nc {
+  color: #6f42c1;
+  font-weight: bold;
+} /* Name.Class */
+.highlight .no {
+  color: #005cc5;
+} /* Name.Constant */
+.highlight .nd {
+  color: #6f42c1;
+  font-weight: bold;
+} /* Name.Decorator */
+.highlight .ni {
+  color: #800080;
+} /* Name.Entity */
+.highlight .ne {
+  color: #990000;
+  font-weight: bold;
+} /* Name.Exception */
+.highlight .nf {
+  color: #6f42c1;
+} /* Name.Function */
+.highlight .nl {
+  color: #990000;
+} /* Name.Label */
+.highlight .nn {
+  color: #555555;
+} /* Name.Namespace */
+.highlight .nx {
+  color: #6f42c1;
+} /* Name.Other */
+.highlight .py {
+  color: #990000;
+} /* Name.Property */
+.highlight .nt {
+  color: #22863a;
+} /* Name.Tag */
+.highlight .nv {
+  color: #e36209;
+} /* Name.Variable */
+.highlight .ow {
+  color: #d73a49;
+  font-weight: bold;
+} /* Operator.Word */
+.highlight .w {
+  color: #bbbbbb;
+} /* Text.Whitespace */
+.highlight .mf {
+  color: #005cc5;
+} /* Literal.Number.Float */
+.highlight .mh {
+  color: #005cc5;
+} /* Literal.Number.Hex */
+.highlight .mi {
+  color: #005cc5;
+} /* Literal.Number.Integer */
+.highlight .mo {
+  color: #005cc5;
+} /* Literal.Number.Oct */
+.highlight .sb {
+  color: #032f62;
+} /* Literal.String.Backtick */
+.highlight .sc {
+  color: #032f62;
+} /* Literal.String.Char */
+.highlight .sd {
+  color: #032f62;
+} /* Literal.String.Doc */
+.highlight .s2 {
+  color: #032f62;
+} /* Literal.String.Double */
+.highlight .se {
+  color: #032f62;
+} /* Literal.String.Escape */
+.highlight .sh {
+  color: #032f62;
+} /* Literal.String.Heredoc */
+.highlight .si {
+  color: #032f62;
+} /* Literal.String.Interpol */
+.highlight .sx {
+  color: #032f62;
+} /* Literal.String.Other */
+.highlight .sr {
+  color: #22863a;
+} /* Literal.String.Regex */
+.highlight .s1 {
+  color: #032f62;
+} /* Literal.String.Single */
+.highlight .ss {
+  color: #032f62;
+} /* Literal.String.Symbol */
+.highlight .bp {
+  color: #005cc5;
+} /* Name.Builtin.Pseudo */
+.highlight .vc {
+  color: #e36209;
+} /* Name.Variable.Class */
+.highlight .vg {
+  color: #e36209;
+} /* Name.Variable.Global */
+.highlight .vi {
+  color: #e36209;
+} /* Name.Variable.Instance */
+.highlight .il {
+  color: #005cc5;
+} /* Literal.Number.Integer.Long */
+/* Additional Rouge token classes that may be used */
+.highlight .token {
+  color: #5670a0;
+}
+.highlight .token.list {
+  color: #546e9f;
+}
+.highlight .token.punctuation {
+  color: #3e8dad;
+}
+.highlight .token.list.punctuation {
+  color: #e05b78;
+}
+.highlight .token.content {
+  padding: 0;
+}
+/* Nested lists in page content */
+ul ul,
+ol ol,
+ul ol,
+ol ul {
+  padding-left: 1.5em;
+  margin-top: 0.25em;
+}
+/* Page footer */
+.page-footer {
+  background: #f5f5f5;
+  border-top: 1px solid #ddd;
+  padding: 1.5rem;
+  margin-top: 3rem;
+  color: #666;
+  font-size: 0.9em;
+}
+.page-footer p {
+  margin: 0.5em 0;
+}
+.page-footer a {
+  color: #0066cc;
+  text-decoration: none;
+}
+.page-footer a:hover {
+  text-decoration: underline;
+}
+/* Mobile responsive */
+@media (max-width: 768px) {
+  .hamburger-menu {
+    display: flex;
+  }
+  .main-toc,
+  .sidebar {
+    transform: translateX(-100%);
+    z-index: 175;
+  }
+  .main-toc.mobile-open,
+  .sidebar.mobile-open {
+    transform: translateX(0);
+  }
+  body {
+    margin-left: 0;
+  }
+  .floating-toc {
+    left: 0;
+  }
+}
+</style></head>
+  <body>
+<div class="floating-toc" id="floating-toc">
+  <div class="floating-toc-container">
+    <div class="floating-toc-header">
+      <span>Table of Contents 🔻</span>
+    </div>
+    <div class="floating-toc-content" id="floating-toc-content">
+      <!-- Content will be populated by JavaScript -->
+    </div>
+  </div>
+</div>
+<button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
+<div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
+<nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
+    <h1 id="limitations-and-roadmap">
+      Limitations and Roadmap
+    </h1>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#limitations-and-roadmap">Limitations and Roadmap</a><ul><li><a href="#known-limitations">Known Limitations</a><ul><li><a href="#current-limitations">Current Limitations</a><ul><li><a href="#1-definition-lists-parsing">1. Definition Lists Parsing</a></li><li><a href="#2-span-level-inline-attribute-lists-ial">2. Span-Level Inline Attribute Lists (IAL)</a></li><li><a href="#3-html-markdown-attributes">3. HTML Markdown Attributes</a></li><li><a href="#4-multimarkdown-transclusion-syntax">4. MultiMarkdown Transclusion Syntax</a></li><li><a href="#5-critic-markup-edge-cases">5. Critic Markup Edge Cases</a></li><li><a href="#6-complete-github-emoji-set">6. Complete GitHub Emoji Set</a></li></ul></li><li><a href="#resolved-limitations">Resolved Limitations</a></li></ul></li><li><a href="#roadmap">Roadmap</a><ul><li><a href="#completed-features-white_check_mark">Completed Features ✅</a></li><li><a href="#high-priority-next-release">High Priority (Next Release)</a></li><li><a href="#medium-priority-future-releases">Medium Priority (Future Releases)</a></li><li><a href="#low-priority-nice-to-have">Low Priority (Nice to Have)</a></li><li><a href="#future-considerations">Future Considerations</a></li></ul></li><li><a href="#version-history">Version History</a><ul><li><a href="#v010-current">v0.1.0 (Current)</a></li><li><a href="#future-versions">Future Versions</a></li></ul></li><li><a href="#contributing">Contributing</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
+    <p>
+      This page documents known limitations of Apex and the planned roadmap for future development.
+    </p>
+    <h2 id="known-limitations">
+      Known Limitations
+    </h2>
+    <h3 id="current-limitations">
+      Current Limitations
+    </h3>
+    <h4 id="1-definition-lists-parsing">
+      1. Definition Lists Parsing
+    </h4>
+    <p>
+<strong>      Status:</strong> Foundation complete, parsing needs enhancement
+    </p>
+    <p>
+<strong>      Details:</strong>
+    </p>
+    <ul>
+      <li>
+        Extension structure and HTML rendering are implemented
+      </li>
+      <li>
+        Parsing logic to detect <code>:</code> lines and convert to definition lists needs completion
+      </li>
+      <li>
+        Block-level content in definitions needs proper parsing
+      </li>
+    </ul>
+    <p>
+<strong>      Workaround:</strong> Use standard lists or HTML for now.
+    </p>
+    <p>
+<strong>      Priority:</strong> Medium
+    </p>
+    <h4 id="2-span-level-inline-attribute-lists-ial">
+      2. Span-Level Inline Attribute Lists (IAL)
+    </h4>
+    <p>
+<strong>      Status:</strong> Not implemented
+    </p>
+    <p>
+<strong>      Details:</strong>
+    </p>
+    <ul>
+      <li>
+        Block-level IAL (<code>{: #id .class}</code>) is fully supported
+      </li>
+      <li>
+        Span-level IAL (<code>*text*{:.class}</code>) is not yet implemented
+      </li>
+    </ul>
+    <p>
+<strong>      Workaround:</strong> Use block-level IAL or HTML attributes.
+    </p>
+    <p>
+<strong>      Priority:</strong> Low
+    </p>
+    <h4 id="3-html-markdown-attributes">
+      3. HTML Markdown Attributes
+    </h4>
+    <p>
+<strong>      Status:</strong> Not implemented
+    </p>
+    <p>
+<strong>      Details:</strong>
+    </p>
+    <ul>
+      <li>
+        Parsing markdown inside HTML tags based on <code>markdown=&quot;1&quot;</code> attribute is not supported
+      </li>
+      <li>
+        This is a complex feature requiring HTML parsing integration
+      </li>
+    </ul>
+    <p>
+<strong>      Workaround:</strong> Use raw HTML or process HTML separately.
+    </p>
+    <p>
+<strong>      Priority:</strong> Low
+    </p>
+    <h4 id="4-multimarkdown-transclusion-syntax">
+      4. MultiMarkdown Transclusion Syntax
+    </h4>
+    <p>
+<strong>      Status:</strong> Partial
+    </p>
+    <p>
+<strong>      Details:</strong>
+    </p>
+    <ul>
+      <li>
+        Marked’s include syntax (<code>, </code>, ``) is fully supported
+      </li>
+      <li>
+        MultiMarkdown’s <code>{{file}}</code> syntax is not yet implemented
+      </li>
+      <li>
+        Wildcard extensions (<code>{{file.*}}</code>) are not supported
+      </li>
+      <li>
+<code>transclude base</code> metadata is not supported
+      </li>
+    </ul>
+    <p>
+<strong>      Workaround:</strong> Use Marked’s include syntax in unified mode.
+    </p>
+    <p>
+<strong>      Priority:</strong> Low
+    </p>
+    <h4 id="5-critic-markup-edge-cases">
+      5. Critic Markup Edge Cases
+    </h4>
+    <p>
+<strong>      Status:</strong> Minor edge cases exist
+    </p>
+    <p>
+<strong>      Details:</strong>
+    </p>
+    <ul>
+      <li>
+        Most critic markup works correctly
+      </li>
+      <li>
+        Some edge cases with nested markup or complex substitutions may have issues
+      </li>
+      <li>
+        Generally works well for typical use cases
+      </li>
+    </ul>
+    <p>
+<strong>      Priority:</strong> Low
+    </p>
+    <h4 id="6-complete-github-emoji-set">
+      6. Complete GitHub Emoji Set
+    </h4>
+    <p>
+<strong>      Status:</strong> Partial (350+ emoji supported)
+    </p>
+    <p>
+<strong>      Details:</strong>
+    </p>
+    <ul>
+      <li>
+        350+ common emoji are supported
+      </li>
+      <li>
+        Full GitHub emoji set (1,800+ emoji) is not yet implemented
+      </li>
+    </ul>
+    <p>
+<strong>      Workaround:</strong> Most common emoji work. Unsupported emoji will appear as text.
+    </p>
+    <p>
+<strong>      Priority:</strong> Very Low
+    </p>
+    <h3 id="resolved-limitations">
+      Resolved Limitations
+    </h3>
+    <p>
+      The following limitations have been resolved:
+    </p>
+    <ul>
+      <li>
+        ✅ <strong>Kramdown IAL</strong> - Full block-level implementation with ALD support
+      </li>
+      <li>
+        ✅ <strong>Advanced Footnotes</strong> - Block-level content in footnotes now supported
+      </li>
+      <li>
+        ✅ <strong>Advanced Tables</strong> - Colspan, rowspan, and captions fully implemented
+      </li>
+      <li>
+        ✅ <strong>Callouts</strong> - All Bear/Obsidian/Xcode styles supported
+      </li>
+      <li>
+        ✅ <strong>File Includes</strong> - Marked syntax fully implemented
+      </li>
+      <li>
+        ✅ <strong>TOC Generation</strong> - All marker formats working
+      </li>
+      <li>
+        ✅ <strong>Abbreviations</strong> - Full support implemented
+      </li>
+      <li>
+        ✅ <strong>Page Breaks</strong> - Both HTML comment and Kramdown styles supported
+      </li>
+    </ul>
+    <h2 id="roadmap">
+      Roadmap
+    </h2>
+    <h3 id="completed-features-white_check_mark">
+      Completed Features ✅
+    </h3>
+    <ul>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Core Markdown parsing (CommonMark + GFM)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Metadata blocks (YAML, MMD, Pandoc)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Metadata variables (<code>[%key]</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Wiki links (<code>[[Page]]</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Math support (<code>$inline$</code> and <code>$$display$$</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Critic Markup (all 5 types)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         GFM tables with alignment
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Strikethrough (<code>~~text~~</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Task lists (<code>- [ ]</code> and <code>- [x]</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Autolinks
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Smart typography
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Footnotes (reference and inline styles)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Abbreviations
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Callouts (Bear/Obsidian/Xcode)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         File includes (<code>, </code>, ``)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         TOC generation (all marker formats)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         GitHub Emoji (350+ common emoji)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Page breaks (<code>&lt;div class=&quot;page-break&quot; style=&quot;page-break-after: always;&quot;&gt;&lt;/div&gt;</code>, <code>&lt;div class=&quot;page-break&quot; style=&quot;page-break-after: always;&quot;&gt;&lt;/div&gt;</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Autoscroll pauses (<code>&lt;!--PAUSE:X--&gt;</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         End of block markers (<code>^</code>)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Kramdown IAL (block-level with ALD)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Advanced footnotes (block-level content)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Advanced tables (colspan, rowspan, captions)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Header ID generation (GFM, MMD, Kramdown formats)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Relaxed tables (no separator rows)
+      </li>
+      <li>
+<input type="checkbox" checked="" disabled="" />         Definition lists foundation (HTML rendering)
+      </li>
+    </ul>
+    <h3 id="high-priority-next-release">
+      High Priority (Next Release)
+    </h3>
+    <ul>
+      <li>
+<input type="checkbox" disabled="" />         Complete definition lists parsing
+        <ul>
+          <li>
+            Detect <code>:</code> lines and convert to definition lists
+          </li>
+          <li>
+            Parse block-level content in definitions
+          </li>
+          <li>
+            Estimated: 1-2 hours
+          </li>
+        </ul>
+      </li>
+    </ul>
+    <h3 id="medium-priority-future-releases">
+      Medium Priority (Future Releases)
+    </h3>
+    <ul>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          MultiMarkdown transclusion syntax (<code>{{file}}</code>)
+        </p>
+        <ul>
+          <li>
+            Add <code>{{file}}</code> syntax for MMD mode compatibility
+          </li>
+          <li>
+            Support wildcard extensions (<code>{{file.*}}</code>)
+          </li>
+          <li>
+            Support <code>transclude base</code> metadata
+          </li>
+          <li>
+            Estimated: 1-2 hours
+          </li>
+        </ul>
+      </li>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Span-level Inline Attribute Lists
+        </p>
+        <ul>
+          <li>
+            Support <code>*text*{:.class}</code> syntax
+          </li>
+          <li>
+            Attach attributes to inline elements
+          </li>
+          <li>
+            Estimated: 2-3 hours
+          </li>
+        </ul>
+      </li>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Expand GitHub Emoji to full set
+        </p>
+        <ul>
+          <li>
+            Add remaining 1,400+ emoji to reach 1,800+ total
+          </li>
+          <li>
+            Estimated: 2-3 hours (mostly data entry)
+          </li>
+        </ul>
+      </li>
+    </ul>
+    <h3 id="low-priority-nice-to-have">
+      Low Priority (Nice to Have)
+    </h3>
+    <ul>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          HTML Markdown Attributes
+        </p>
+        <ul>
+          <li>
+            Parse markdown inside HTML based on <code>markdown=&quot;1&quot;</code> attribute
+          </li>
+          <li>
+            Handle block vs. span contexts
+          </li>
+          <li>
+            Estimated: 3-4 hours
+          </li>
+          <li>
+            Complexity: High
+          </li>
+        </ul>
+      </li>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Pygments syntax highlighting integration
+        </p>
+        <ul>
+          <li>
+            Server-side syntax highlighting using Pygments
+          </li>
+          <li>
+            Cache results for performance
+          </li>
+          <li>
+            Estimated: 4-6 hours
+          </li>
+          <li>
+            Note: Client-side (Prism.js, highlight.js) is recommended instead
+          </li>
+        </ul>
+      </li>
+    </ul>
+    <h3 id="future-considerations">
+      Future Considerations
+    </h3>
+    <ul>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Performance optimizations
+        </p>
+        <ul>
+          <li>
+            Profile and optimize hot paths
+          </li>
+          <li>
+            Memory usage improvements
+          </li>
+          <li>
+            Large document handling
+          </li>
+        </ul>
+      </li>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Additional Markdown extensions
+        </p>
+        <ul>
+          <li>
+            Leanpub syntax support
+          </li>
+          <li>
+            Other processor-specific features based on user demand
+          </li>
+        </ul>
+      </li>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Enhanced error reporting
+        </p>
+        <ul>
+          <li>
+            Better error messages
+          </li>
+          <li>
+            Syntax error highlighting
+          </li>
+          <li>
+            Validation warnings
+          </li>
+        </ul>
+      </li>
+      <li>
+<input type="checkbox" disabled="" />
+        <p>
+          Plugin/extension system
+        </p>
+        <ul>
+          <li>
+            Allow custom extensions
+          </li>
+          <li>
+            Third-party extension support
+          </li>
+        </ul>
+      </li>
+    </ul>
+    <h2 id="version-history">
+      Version History
+    </h2>
+    <h3 id="v010-current">
+      v0.1.0 (Current)
+    </h3>
+    <p>
+<strong>      Status:</strong> Production-ready
+    </p>
+    <p>
+<strong>      Features:</strong>
+    </p>
+    <ul>
+      <li>
+        All core Markdown features
+      </li>
+      <li>
+        GFM compatibility
+      </li>
+      <li>
+        MultiMarkdown compatibility (partial)
+      </li>
+      <li>
+        Kramdown compatibility (partial)
+      </li>
+      <li>
+        Unified mode with all features
+      </li>
+      <li>
+        Header ID generation
+      </li>
+      <li>
+        Relaxed tables
+      </li>
+      <li>
+        Comprehensive CLI tool
+      </li>
+      <li>
+        C API and Objective-C wrapper
+      </li>
+    </ul>
+    <p>
+<strong>      Known Limitations:</strong>
+    </p>
+    <ul>
+      <li>
+        Definition lists parsing incomplete
+      </li>
+      <li>
+        Span-level IAL not implemented
+      </li>
+      <li>
+        MMD transclusion syntax not implemented
+      </li>
+    </ul>
+    <h3 id="future-versions">
+      Future Versions
+    </h3>
+    <p>
+<strong>      v0.2.0 (Planned)</strong>
+    </p>
+    <ul>
+      <li>
+        Complete definition lists
+      </li>
+      <li>
+        MMD transclusion syntax
+      </li>
+      <li>
+        Additional emoji support
+      </li>
+    </ul>
+    <p>
+<strong>      v0.3.0 (Future)</strong>
+    </p>
+    <ul>
+      <li>
+        Span-level IAL
+      </li>
+      <li>
+        HTML markdown attributes
+      </li>
+      <li>
+        Performance improvements
+      </li>
+    </ul>
+    <h2 id="contributing">
+      Contributing
+    </h2>
+    <p>
+      If you’d like to help implement any of these features, please:
+    </p>
+    <ol>
+      <li>
+        Check the <a href="https://github.com/ApexMarkdown/apex">GitHub repository</a> for open issues
+      </li>
+      <li>
+        Review the codebase structure in <code>src/extensions/</code>
+      </li>
+      <li>
+        Follow existing code patterns
+      </li>
+      <li>
+        Add tests for new features
+      </li>
+      <li>
+        Update documentation
+      </li>
+    </ol>
+    <h2 id="related">
+      Related
+    </h2>
+    <ul>
+      <li>
+<a href="Syntax.html">        Syntax</a> - Current syntax support
+      </li>
+      <li>
+<a href="Modes.html">        Modes</a> - Feature availability by mode
+      </li>
+      <li>
+<a href="C-API.html">        C API</a> - Programmatic API
+      </li>
+      <li>
+<a href="Examples.html">        Examples</a> - Usage examples
+      </li>
+    </ul>
+  <script>
+// Hamburger menu functionality
+(function() {
+  function initHamburgerMenu() {
+    var hamburger = document.getElementById('hamburger-menu');
+    var sidebar = document.querySelector('.main-toc, .sidebar');
+    var overlay = document.getElementById('mobile-menu-overlay');
+    if (!hamburger || !sidebar) return;
+    function toggleMenu() {
+      var isOpen = sidebar.classList.contains('mobile-open');
+      if (isOpen) {
+        sidebar.classList.remove('mobile-open');
+        hamburger.classList.remove('active');
+        if (overlay) overlay.classList.remove('active');
+      } else {
+        sidebar.classList.add('mobile-open');
+        hamburger.classList.add('active');
+        if (overlay) overlay.classList.add('active');
+      }
+    }
+    hamburger.addEventListener('click', function(e) {
+      e.stopPropagation();
+      toggleMenu();
+    });
+    if (overlay) {
+      overlay.addEventListener('click', function() {
+        toggleMenu();
+      });
+    }
+    // Close menu when clicking on a sidebar link (mobile only)
+    if (window.innerWidth <= 768) {
+      var sidebarLinks = sidebar.querySelectorAll('a');
+      sidebarLinks.forEach(function(link) {
+        link.addEventListener('click', function() {
+          setTimeout(function() {
+            sidebar.classList.remove('mobile-open');
+            hamburger.classList.remove('active');
+            if (overlay) overlay.classList.remove('active');
+          }, 100);
+        });
+      });
+    }
+    // Close menu on window resize if going to desktop
+    window.addEventListener('resize', function() {
+      if (window.innerWidth > 768) {
+        sidebar.classList.remove('mobile-open');
+        hamburger.classList.remove('active');
+        if (overlay) overlay.classList.remove('active');
+      }
+    });
+  }
+  // Initialize when DOM is ready
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initHamburgerMenu);
+  } else {
+    initHamburgerMenu();
+  }
+})();
+</script>
+<script>
+  (function() {
+    // Clone the page TOC for floating TOC
+    function initFloatingTOC() {
+      var pageTOC = document.getElementById('page-toc-top');
+      var floatingTOCContent = document.getElementById('floating-toc-content');
+      var floatingTOC = document.getElementById('floating-toc');
+      if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
+      // Clone the TOC structure
+      var tocClone = pageTOC.cloneNode(true);
+      tocClone.id = 'floating-toc-clone';
+      floatingTOCContent.appendChild(tocClone);
+      // Update all links to use smooth scrolling
+      var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
+      allTOCLinks.forEach(function(link) {
+        link.addEventListener('click', function(e) {
+          var href = this.getAttribute('href');
+          if (href && href.startsWith('#')) {
+            e.preventDefault();
+            var targetId = href.substring(1);
+            var targetElement = document.getElementById(targetId);
+            if (targetElement) {
+              var offset = 20; // Offset from top
+              // Function to calculate absolute position from document top
+              function getAbsoluteTop(element) {
+                var top = 0;
+                while (element) {
+                  top += element.offsetTop;
+                  element = element.offsetParent;
+                }
+                return top;
+              }
+              var absoluteTop = getAbsoluteTop(targetElement);
+              var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
+              var offsetPosition = absoluteTop - offset;
+              // Only scroll if we're not already at the target position
+              if (Math.abs(scrollTop - offsetPosition) > 10) {
+                window.scrollTo({
+                  top: Math.max(0, offsetPosition),
+                  behavior: 'smooth'
+                });
+              }
+              // Update URL hash without triggering scroll
+              if (history.pushState) {
+                history.pushState(null, null, href);
+              }
+            }
+          }
+        });
+      });
+      // Handle scroll to show/hide floating TOC
+      var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
+      var tocBottom = tocTop + pageTOC.offsetHeight;
+      function updateFloatingTOC() {
+        var scrollY = window.pageYOffset || document.documentElement.scrollTop;
+        if (scrollY > tocBottom) {
+          floatingTOC.classList.add('visible');
+        } else {
+          floatingTOC.classList.remove('visible');
+        }
+      }
+      // Throttle scroll events
+      var ticking = false;
+      window.addEventListener('scroll', function() {
+        if (!ticking) {
+          window.requestAnimationFrame(function() {
+            updateFloatingTOC();
+            ticking = false;
+          });
+          ticking = true;
+        }
+      });
+      // Initial check
+      updateFloatingTOC();
+    }
+    // Initialize when DOM is ready
+    if (document.readyState === 'loading') {
+      document.addEventListener('DOMContentLoaded', initFloatingTOC);
+    } else {
+      initFloatingTOC();
+    }
+  })();
+</script>
+<footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
+</html>