docmedown 0.1.6 → 0.1.9

package/dist/cli.js

@@ -31,7 +31,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "docmedown",
-  version: "0.1.6",
+  version: "0.1.9",
   description: "The simplest MarkDown documenter yet. CLI & Web Script React SPA documentation engine.",
   main: "./dist/docmedown.cjs",
   module: "./dist/docmedown.mjs",
@@ -80,6 +80,7 @@ var package_default = {
     test: "npx tsx --test tests/parser.test.ts tests/scanner.test.ts tests/theme-schema.test.ts tests/runtime-integration.test.ts tests/package-smoke.test.ts tests/hosting.test.ts tests/deploy.test.ts tests/home.test.ts",
     "test:artifacts": "npx tsx --test tests/offline-artifact.test.ts",
     "test:release": "npm run typecheck && npm run lint && npm run test && npm run build && npm run build:docs && npm run test:artifacts && npm pack --dry-run",
+    login: "npm login",
     deploy: "node ./scripts/deploy.mjs",
     "deploy:dry-run": "npm run deploy -- --dry-run",
     prepublishOnly: "npm run test:release"
@@ -240,6 +241,9 @@ var docSearchConfigSchema = import_zod.z.object({
   placeholder: import_zod.z.string().optional(),
   maxResults: import_zod.z.number().int().positive().max(100).optional()
 }).strict();
+var docOfflineConfigSchema = import_zod.z.object({
+  embedNestedDocs: import_zod.z.boolean().optional()
+}).strict();
 var docConfigSchema = import_zod.z.object({
   $schema: import_zod.z.string().url("Must be an absolute URL.").optional(),
   name: nonEmptyString.optional(),
@@ -260,6 +264,7 @@ var docConfigSchema = import_zod.z.object({
     defaultCollapsed: import_zod.z.boolean().optional()
   }).strict().optional(),
   search: docSearchConfigSchema.optional(),
+  offline: docOfflineConfigSchema.optional(),
   footer: import_zod.z.object({
     copyright: import_zod.z.string().optional(),
     links: import_zod.z.array(navLinkSchema).optional(),
@@ -314,6 +319,9 @@ var DEFAULT_CONFIG = {
     placeholder: "Search documentation...",
     maxResults: 10
   },
+  offline: {
+    embedNestedDocs: true
+  },
   footer: {
     copyright: `\xA9 ${(/* @__PURE__ */ new Date()).getFullYear()} DocMeDown. All rights reserved.`,
     showBuiltWith: true
@@ -345,6 +353,10 @@ function normalizeConfig(userConfig = {}) {
       ...DEFAULT_CONFIG.search,
       ...parsedConfig.search
     },
+    offline: {
+      ...DEFAULT_CONFIG.offline,
+      ...parsedConfig.offline
+    },
     footer: {
       ...DEFAULT_CONFIG.footer,
       ...parsedConfig.footer
@@ -366,7 +378,7 @@ function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 function createCompressedOfflineHtml(encodedGzip, title) {
-  const bootstrap = `(async()=>{try{const b=Uint8Array.from(atob(document.getElementById("d").textContent.trim()),c=>c.charCodeAt(0)),s=await new Response(new Blob([b]).stream().pipeThrough(new DecompressionStream("gzip"))).text(),e=JSON.parse(s);if(e.version!==${OFFLINE_FORMAT_VERSION})throw new Error("Unsupported offline format");window.__DOCMEDOWN_OFFLINE__=true;window.__DOCMEDOWN_DATA__=e.data;window.__DOCMEDOWN_CONFIG__=e.data.manifest.config;const u=URL.createObjectURL(new Blob([e.runtime],{type:"text/javascript"})),j=document.createElement("script");j.src=u;j.onload=()=>URL.revokeObjectURL(u);j.onerror=()=>{URL.revokeObjectURL(u);throw new Error("Runtime bootstrap failed")};document.head.appendChild(j)}catch(e){document.getElementById("dmd-app").textContent="Could not open this offline documentation copy: "+e.message}})();`;
+  const bootstrap = `(async()=>{try{const b=Uint8Array.from(atob(document.getElementById("d").textContent.trim()),c=>c.charCodeAt(0)),s=await new Response(new Blob([b]).stream().pipeThrough(new DecompressionStream("gzip"))).text(),e=JSON.parse(s);if(e.version!==${OFFLINE_FORMAT_VERSION})throw new Error("Unsupported offline format");window.__DOCMEDOWN_OFFLINE__=true;window.__DOCMEDOWN_DATA__=e.data;window.__DOCMEDOWN_CONFIG__=e.data.manifest.config;const u=URL.createObjectURL(new Blob([e.runtime],{type:"text/javascript"}));window.__DOCMEDOWN_RUNTIME_URL__=u;const j=document.createElement("script");j.src=u;j.onerror=()=>{URL.revokeObjectURL(u);throw new Error("Runtime bootstrap failed")};document.head.appendChild(j)}catch(e){document.getElementById("dmd-app").textContent="Could not open this offline documentation copy: "+e.message}})();`;
   return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="icon" href="data:,"><title>${escapeHtml(title)}</title></head><body><div id="dmd-app">Opening offline documentation\u2026</div><script id="d" type="application/octet-stream">${encodedGzip}</script><script>${bootstrap}</script></body></html>`;
 }
 
@@ -485,6 +497,49 @@ function mapManualSidebar(items) {
   });
 }
 
+// src/runtime/markdown/inline-text.ts
+var NAMED_HTML_ENTITIES = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  nbsp: " ",
+  copy: "\xA9",
+  reg: "\xAE",
+  trade: "\u2122",
+  middot: "\xB7",
+  hellip: "\u2026",
+  mdash: "\u2014",
+  ndash: "\u2013",
+  bull: "\u2022",
+  deg: "\xB0",
+  times: "\xD7",
+  plusmn: "\xB1",
+  laquo: "\xAB",
+  raquo: "\xBB",
+  sect: "\xA7",
+  para: "\xB6"
+};
+function codePointToChar(code) {
+  return Number.isInteger(code) && code > 0 && code <= 1114111 ? String.fromCodePoint(code) : "";
+}
+function decodeHtmlEntities(value) {
+  return value.replace(/&#x([0-9a-f]+);/gi, (_match, hex) => codePointToChar(parseInt(hex, 16))).replace(/&#([0-9]+);/g, (_match, dec) => codePointToChar(Number(dec))).replace(/&([a-z][a-z0-9]*);/gi, (match, name) => NAMED_HTML_ENTITIES[name.toLowerCase()] ?? match);
+}
+var IMAGE_PATTERN = /!\[([^\]]*)\]\([^)]*\)/g;
+var LINK_PATTERN = /\[([^\]]+)\]\([^)]*\)/g;
+var CODE_PATTERN = /`([^`]+)`/g;
+var BOLD_PATTERN = /\*\*([^*\n]+)\*\*/g;
+var UNDERSCORE_BOLD_PATTERN = /__([^_\n]+)__/g;
+var ITALIC_PATTERN = /\*([^*\n]+)\*/g;
+var STRIKETHROUGH_PATTERN = /~~([^~\n]+)~~/g;
+function inlineHeadingToPlainText(raw) {
+  return decodeHtmlEntities(
+    raw.replace(IMAGE_PATTERN, "$1").replace(LINK_PATTERN, "$1").replace(CODE_PATTERN, "$1").replace(BOLD_PATTERN, "$1").replace(UNDERSCORE_BOLD_PATTERN, "$1").replace(ITALIC_PATTERN, "$1").replace(STRIKETHROUGH_PATTERN, "$1")
+  ).replace(/\s+/g, " ").trim();
+}
+
 // src/cli/utils/scanner.ts
 function extractHeadings(content) {
   const headings = [];
@@ -493,8 +548,9 @@ function extractHeadings(content) {
     const match = line.match(/^(#{1,4})\s+(.+)$/);
     if (match) {
       const level = match[1].length;
-      const text = match[2].trim().replace(/[#*`_]/g, "");
-      const id = text.toLowerCase().replace(/[^\w\s-]/g, "").trim().replace(/[\s_-]+/g, "-");
+      const rawHeading = match[2].trim();
+      const text = inlineHeadingToPlainText(rawHeading);
+      const id = rawHeading.replace(/[#*`_]/g, "").toLowerCase().replace(/[^\w\s-]/g, "").trim().replace(/[\s_-]+/g, "-");
       headings.push({ level, text, id });
     }
   }
@@ -615,11 +671,40 @@ function findNestedDocumentationRoots(targetDir) {
   visit(targetDir);
   return roots;
 }
+function collectNestedOfflineSites(targetDir) {
+  const sites = {};
+  for (const nestedRoot of findNestedDocumentationRoots(targetDir)) {
+    const key = import_node_path2.default.relative(targetDir, nestedRoot).replace(/\\/g, "/");
+    const nestedConfigPath = import_node_path2.default.join(nestedRoot, "docs.json");
+    let nestedConfig = normalizeConfig();
+    if (import_node_fs2.default.existsSync(nestedConfigPath)) {
+      nestedConfig = normalizeConfig(parseDocConfigJson(import_node_fs2.default.readFileSync(nestedConfigPath, "utf-8"), nestedConfigPath));
+    }
+    const nestedDocs = {};
+    for (const file of scanDirectory(nestedRoot)) {
+      const raw = import_node_fs2.default.readFileSync(import_node_path2.default.join(nestedRoot, file), "utf-8");
+      const slug = file.replace(/\.(md|mdx)$/i, "");
+      const cleanSlug = slug.toLowerCase() === "readme" || slug.toLowerCase() === "index" ? "README" : slug;
+      nestedDocs[cleanSlug] = raw;
+      nestedDocs[file] = raw;
+    }
+    sites[key] = {
+      name: nestedConfig.name || key,
+      manifest: generateManifest(nestedRoot, nestedConfig),
+      docs: nestedDocs,
+      componentsSource: bundleCustomComponents(import_node_path2.default.join(nestedRoot, ".dmd", "components.js"))
+    };
+  }
+  return sites;
+}
 function shouldWatchDocumentationSource(rootDir, changedPath) {
   const relativePath = import_node_path2.default.relative(rootDir, changedPath).replace(/\\/g, "/");
-  const firstSegment = relativePath.split("/")[0];
+  const segments = relativePath.split("/");
+  const firstSegment = segments[0];
+  const baseName = segments[segments.length - 1];
   const isCustomComponentModule = /(^|\/)\.dmd\/(components|index)\.js$/i.test(relativePath);
-  return Boolean(relativePath) && !relativePath.startsWith("..") && (!relativePath.startsWith(".") || isCustomComponentModule) && !GENERATED_DOC_OUTPUTS.includes(relativePath) && firstSegment !== "node_modules" && firstSegment !== "dist";
+  const isGeneratedOutput = baseName === ".nojekyll" || GENERATED_DOC_OUTPUTS.includes(baseName) || segments.includes(".dist");
+  return Boolean(relativePath) && !relativePath.startsWith("..") && (!relativePath.startsWith(".") || isCustomComponentModule) && !isGeneratedOutput && !GENERATED_DOC_OUTPUTS.includes(relativePath) && firstSegment !== "node_modules" && firstSegment !== "dist";
 }
 async function buildCommand(targetDirArg = "./docs", options = {}) {
   const targetDir = import_node_path2.default.resolve(process.cwd(), targetDirArg);
@@ -682,9 +767,24 @@ async function buildCommand(targetDirArg = "./docs", options = {}) {
     } else {
       console.warn(import_chalk.default.yellow("  \u26A0 Local runtime bundle not found, linking CDN script."));
     }
+    const embedNestedDocs = config.offline?.embedNestedDocs !== false;
+    const nestedSites = embedNestedDocs && options.buildNested !== false ? collectNestedOfflineSites(targetDir) : void 0;
+    const nestedCount = nestedSites ? Object.keys(nestedSites).length : 0;
+    if (nestedCount > 0) {
+      console.log(
+        import_chalk.default.green(
+          `  \u2714 Embedded ${nestedCount} nested documentation site${nestedCount === 1 ? "" : "s"} into the offline bundle`
+        )
+      );
+    }
     const envelope = {
       version: OFFLINE_FORMAT_VERSION,
-      data: { manifest, docs: docsMap, componentsSource },
+      data: {
+        manifest,
+        docs: docsMap,
+        componentsSource,
+        ...nestedSites && nestedCount > 0 ? { nestedSites } : {}
+      },
       runtime: bundleJs
     };
     const encodedEnvelope = encodeCompressedOfflineEnvelope(envelope);
@@ -728,10 +828,11 @@ async function watchBuildCommand(targetDirArg = "./docs", options = {}) {
   console.log(import_chalk.default.dim("  Source changes rebuild serveable files and .dist/index.html. Press Ctrl+C to stop.\n"));
   const watcher = import_chokidar.default.watch(targetDir, {
     ignored: [
-      "**/node_modules/**",
-      "**/.git/**",
       "**/dist/**",
       "**/.dist/**",
+      "**/node_modules/**",
+      "**/.git/**",
+      "**/.nojekyll",
       "**/_manifest.json",
       "**/_docs.js",
       "**/docmedown.iife.js"
@@ -1027,6 +1128,7 @@ function startDevServer(options) {
         "**/.git/**",
         "**/dist/**",
         "**/.dist/**",
+        "**/.nojekyll",
         "**/_manifest.json",
         "**/_docs.js",
         "**/docmedown.iife.js"