reallysimpledocs 1.0.4 → 1.0.6

package/README.md

@@ -28,6 +28,9 @@ export default defineConfig({
       site: {
         title: "Acme Docs",
         description: "Documentation for Acme.",
+        url: "https://docs.example.com",
+        favicon: "favicon.svg",
+        socialImage: "social.png",
       },
     }),
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reallysimpledocs",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "type": "module",
   "exports": {
     ".": "./src/index.js",
@@ -20,7 +20,7 @@
     "build": "rm -rf dist && astro build",
     "preview": "astro preview",
     "smoke:consumer": "node scripts/smoke-consumer.mjs",
-    "check": "npm run build && npm pack --dry-run && npm run smoke:consumer"
+    "check": "npm run build && node scripts/assert-site-output.mjs && npm pack --dry-run && npm run smoke:consumer"
   },
   "dependencies": {
     "@astrojs/markdown-remark": "^7.2.0",
@@ -41,6 +41,7 @@
     "tailwindcss": ">=4.1.17 <5"
   },
   "devDependencies": {
+    "@astrojs/sitemap": "^3.6.0",
     "astro": "^6.4.6",
     "basecoat-css": "^1.0.0-beta.6",
     "htmx.org": "^2.0.10",

package/src/astro/rehype-basecoat-tables.js

@@ -65,6 +65,7 @@ function addHeadingAnchor(node, slugger) {
   if (!id) return;
   node.properties.id = id;
   node.properties.tabIndex ??= -1;
+  if (hasElement(node, "a")) return;
   node.children = [
     {
       type: "element",
@@ -97,6 +98,11 @@ function nodeText(node) {
   return node.children.map(nodeText).join("");
 }
 
+function hasElement(node, tagName) {
+  if (isElement(node, tagName)) return true;
+  return Array.isArray(node?.children) && node.children.some((child) => hasElement(child, tagName));
+}
+
 function isElement(node, tagName) {
   return node?.type === "element" && node.tagName === tagName;
 }

package/src/css/custom.css

@@ -9,7 +9,9 @@
 
   > h2,
   > h3,
-  > h4 {
+  > h4,
+  > h5,
+  > h6 {
     @apply sm:text-lg my-6 scroll-m-18 font-semibold tracking-tight;
 
     > a.header-anchor {

package/src/runtime/components/BaseLayout.astro

@@ -11,9 +11,9 @@ const metaTitle = pagePath === "/" ? `${site.title} | ${metaDescription}` : `${t
 const siteUrl = Astro.site?.toString().replace(/\/$/, "") || site.url || "";
 const absoluteUrl = `${siteUrl}${pagePath}`;
 const assetsBase = config.assetsBase || "/assets";
-const favicon = site.assets?.favicon || site.favicon || "";
-const appleTouchIcon = site.assets?.appleTouchIcon || site.appleTouchIcon || "";
-const socialImage = site.assets?.socialImage || site.socialImage || "";
+const favicon = site.favicon || "";
+const appleTouchIcon = site.appleTouchIcon || "";
+const socialImage = site.socialImage || "";
 const assetPath = (value) => {
   const path = String(value || "");
   if (!path || path.startsWith("http") || path.startsWith("/")) return path;

package/src/runtime/components/mdx/Callout.astro

@@ -2,9 +2,11 @@
 import * as lucideIcons from "lucide-static";
 import { addSvgClass } from "../../lib/html.js";
 
-const { type, title = "Note", icon: iconName, class: className = "" } = Astro.props;
+const { type, title = "Note", icon: iconName, action, class: className = "" } = Astro.props;
 const normalizedType = String(type || "").toLowerCase();
 const calloutType = normalizedType === "warning" || normalizedType === "destructive" ? normalizedType : "";
+const actionLabel = typeof action?.label === "string" ? action.label.trim() : "";
+const actionHref = typeof action?.href === "string" ? action.href.trim() : "";
 
 function resolveNamedIcon(name) {
   if (!name || typeof name !== "string") return "";
@@ -31,4 +33,13 @@ const heading = title;
   <section>
     <slot />
   </section>
+  {
+    actionLabel && actionHref && (
+      <footer>
+        <a class="btn" data-variant="outline" data-size="sm" href={actionHref}>
+          {actionLabel}
+        </a>
+      </footer>
+    )
+  }
 </div>

package/src/runtime/lib/docs.js

@@ -102,7 +102,8 @@ export async function renderDoc(config, page) {
     const headingText = plainText(tokens);
     const id = slugger.slug(headingText);
     if (depth > 1 && depth < 4) headings.push({ depth, id, text: headingText });
-    return `<h${depth} id="${id}" tabindex="-1"><a class="header-anchor" href="#${id}">${text}</a></h${depth}>`;
+    const content = hasTokenType(tokens, "link") ? text : `<a class="header-anchor" href="#${id}">${text}</a>`;
+    return `<h${depth} id="${id}" tabindex="-1">${content}</h${depth}>`;
   };
 
   const tokens = marked.lexer(content);
@@ -432,6 +433,10 @@ function plainText(tokens) {
     .join("");
 }
 
+function hasTokenType(tokens, type) {
+  return tokens.some((token) => token.type === type || (token.tokens && hasTokenType(token.tokens, type)));
+}
+
 function tokensText(tokens) {
   return tokens
     .map((token) => {

package/src/runtime/lib/markdown-export.js

@@ -94,12 +94,14 @@ function serializePreview(attrs, children, context = new Map()) {
 
 function serializeCallout(attrs, children, context = new Map()) {
   const title = getStringAttr(attrs, "title") || calloutTitle(getStringAttr(attrs, "type"));
+  const action = getObjectAttr(attrs, "action");
   const body = normalizeMdxComponents(children, context)
     .trim()
     .split("\n")
     .map((line) => `> ${line}`)
     .join("\n");
-  return `\n\n> **${title}**\n${body ? `${body}\n` : ""}\n`;
+  const footer = action?.label && action?.href ? `> [${action.label}](${action.href})\n` : "";
+  return `\n\n> **${title}**\n${body ? `${body}\n` : ""}${footer}`;
 }
 
 function serializeSteps(_attrs, children, context = new Map()) {
@@ -137,6 +139,14 @@ function getExpressionAttr(attrs, name) {
   return String(attrs || "").match(new RegExp(`${name}=\\{([A-Za-z_$][\\w$]*)\\}`))?.[1] || "";
 }
 
+function getObjectAttr(attrs, name) {
+  const value = String(attrs || "").match(new RegExp(`${name}=\\{\\{([\\s\\S]*?)\\}\\}`))?.[1] || "";
+  if (!value) return null;
+  return Object.fromEntries(
+    [...value.matchAll(/([A-Za-z_$][\w$]*)\s*:\s*["']([^"']*)["']/g)].map(([, key, item]) => [key, item]),
+  );
+}
+
 function getCodeAttr(attrs, context = new Map()) {
   const direct = String(attrs || "").match(/\bcode=\{`([\s\S]*?)`\}/)?.[1] || "";
   if (direct) return direct.replace(/\\n/g, "\n").replace(/\\`/g, "`");