@pretextbook/ptxast-util-to-mdast 0.0.5 → 0.0.7

package/dist/index.cjs

@@ -1,6 +1,7 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("@pretextbook/ptxast"),T=require("mdast-util-to-markdown"),b=require("mdast-util-directive"),w=require("mdast-util-math"),g=new Set([...p.DIVISION_HIERARCHY,"appendix"]),k=new Set(["pretext","book","article","frontmatter","backmatter"]),M=new Map([["theorem",{name:"theorem",category:"theorem-like"}],["lemma",{name:"lemma",category:"theorem-like"}],["corollary",{name:"corollary",category:"theorem-like"}],["proposition",{name:"proposition",category:"theorem-like"}],["claim",{name:"claim",category:"theorem-like"}],["fact",{name:"fact",category:"theorem-like"}],["conjecture",{name:"conjecture",category:"theorem-like"}],["axiom",{name:"axiom",category:"theorem-like"}],["principle",{name:"principle",category:"theorem-like"}],["hypothesis",{name:"hypothesis",category:"theorem-like"}],["algorithm",{name:"algorithm",category:"theorem-like"}],["definition",{name:"definition",category:"definition-like"}],["notation",{name:"notation",category:"definition-like"}],["remark",{name:"remark",category:"remark-like"}],["note",{name:"note",category:"remark-like"}],["observation",{name:"observation",category:"remark-like"}],["warning",{name:"warning",category:"remark-like"}],["insight",{name:"insight",category:"remark-like"}],["assemblage",{name:"assemblage",category:"remark-like"}],["example",{name:"example",category:"example-like"}],["question",{name:"question",category:"example-like"}],["problem",{name:"problem",category:"example-like"}],["exercise",{name:"exercise",category:"example-like"}],["activity",{name:"activity",category:"example-like"}],["exploration",{name:"exploration",category:"example-like"}],["investigation",{name:"investigation",category:"example-like"}],["project",{name:"project",category:"example-like"}],["proof",{name:"proof",category:"proof-like"}],["case",{name:"case",category:"proof-like"}],["solution",{name:"solution",category:"solution-like"}],["hint",{name:"hint",category:"solution-like"}],["answer",{name:"answer",category:"solution-like"}]]),P=new Set(["theorem-like","definition-like"]);function x(e){return{type:"root",children:d(e.children,1)}}function v(e){for(const t of e){if(t.type!=="element")continue;const n=t;if(g.has(n.name))return n.name;if(k.has(n.name)){const i=v(n.children);if(i)return i}}}function d(e,t){const n=[];for(const i of e){if(i.type!=="element")continue;const a=i;if(k.has(a.name))n.push(...d(a.children,t));else if(g.has(a.name))n.push(...E(a,Math.min(t,6)));else{const l=u(a);l!==null&&n.push(l)}}return n}function E(e,t){const n=[],i=e.attributes??{},a=e.children,l=a.find(o=>o.type==="element"&&o.name==="title"),s=a.filter(o=>!(o.type==="element"&&o.name==="title")),r={type:"heading",depth:t,children:l?l.children.map(h).filter(m):[],...i["xml:id"]?{data:{id:i["xml:id"],hProperties:{id:i["xml:id"]}}}:{}};n.push(r);const c=Math.min(t+1,6);return n.push(...d(s,c)),n}function u(e){switch(e.name){case"p":return I(e);case"blockquote":return S(e);case"ol":return y(e,!0);case"ul":return y(e,!1);case"program":return D(e);case"me":case"men":case"md":case"mdn":return N(e);default:{const t=M.get(e.name);return t?q(e,t):null}}}function I(e){return{type:"paragraph",children:e.children.map(h).filter(m)}}function S(e){return{type:"blockquote",children:e.children.filter(t=>t.type==="element").map(t=>u(t)).filter(m)}}function y(e,t){return{type:"list",ordered:t,spread:!1,children:e.children.filter(n=>n.type==="element").map(n=>C(n))}}function C(e){return{type:"listItem",spread:!1,children:e.children.filter(t=>t.type==="element").map(t=>u(t)).filter(m)}}function D(e){return{type:"code",lang:(e.attributes??{}).language??null,value:p.getPtxTextContent(e)}}function N(e){const t=e.children;return t.length>0&&t[0].type==="text"?{type:"math",value:p.getPtxTextContent(e)}:{type:"math",value:t.filter(i=>i.type==="element"&&i.name==="mrow").map(i=>p.getPtxTextContent(i)).join(` \\\\
-`)}}function q(e,t){const n=e.attributes??{},i=e.children,a={};n["xml:id"]&&(a.id=n["xml:id"]);for(const[r,c]of Object.entries(n))r==="xml:id"||c==null||(a[r]=c);const l=i.find(r=>r.type==="element"&&r.name==="title"),s=[];if(l){const r={type:"paragraph",data:{directiveLabel:!0},children:l.children.map(h).filter(m)};s.push(r)}if(P.has(t.category))for(const r of i){if(r.type!=="element")continue;const c=r;if(c.name!=="title")if(c.name==="statement")for(const o of c.children){if(o.type!=="element")continue;const f=u(o);f&&s.push(f)}else{const o=u(c);o&&s.push(o)}}else for(const r of i){if(r.type!=="element")continue;const c=r;if(c.name==="title")continue;const o=u(c);o&&s.push(o)}return{type:"containerDirective",name:t.name,attributes:Object.keys(a).length>0?a:void 0,children:s}}function h(e){if(e.type==="text")return{type:"text",value:e.value??""};if(e.type!=="element")return null;const t=e;switch(t.name){case"em":return{type:"emphasis",children:t.children.map(h).filter(m)};case"alert":return{type:"strong",children:t.children.map(h).filter(m)};case"c":return{type:"inlineCode",value:p.getPtxTextContent(t)};case"m":return{type:"inlineMath",value:p.getPtxTextContent(t)};default:return null}}function m(e){return e!==null}function j(e){const t=x(e),n=T.toMarkdown(t,{extensions:[b.directiveToMarkdown(),w.mathToMarkdown()]}),i=v(e.children);return!i||i==="chapter"?n:`---
-division: ${i}
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("@pretextbook/ptxast"),T=require("mdast-util-to-markdown"),I=require("mdast-util-directive"),S=require("mdast-util-math"),g=new Set([...c.DIVISION_HIERARCHY,...c.EXTRA_DIVISION_TYPES.filter(e=>!c.isTitlelessDivisionType(e))]),k=new Set(c.TITLELESS_DIVISION_TYPES),x=new Set(["pretext","book","article","slideshow","frontmatter","backmatter"]),E=new Map([["theorem",{name:"theorem",category:"theorem-like"}],["lemma",{name:"lemma",category:"theorem-like"}],["corollary",{name:"corollary",category:"theorem-like"}],["proposition",{name:"proposition",category:"theorem-like"}],["claim",{name:"claim",category:"theorem-like"}],["fact",{name:"fact",category:"theorem-like"}],["conjecture",{name:"conjecture",category:"theorem-like"}],["axiom",{name:"axiom",category:"theorem-like"}],["principle",{name:"principle",category:"theorem-like"}],["hypothesis",{name:"hypothesis",category:"theorem-like"}],["algorithm",{name:"algorithm",category:"theorem-like"}],["definition",{name:"definition",category:"definition-like"}],["notation",{name:"notation",category:"definition-like"}],["remark",{name:"remark",category:"remark-like"}],["note",{name:"note",category:"remark-like"}],["observation",{name:"observation",category:"remark-like"}],["warning",{name:"warning",category:"remark-like"}],["insight",{name:"insight",category:"remark-like"}],["assemblage",{name:"assemblage",category:"remark-like"}],["example",{name:"example",category:"example-like"}],["question",{name:"question",category:"example-like"}],["problem",{name:"problem",category:"example-like"}],["exercise",{name:"exercise",category:"example-like"}],["activity",{name:"activity",category:"example-like"}],["exploration",{name:"exploration",category:"example-like"}],["investigation",{name:"investigation",category:"example-like"}],["project",{name:"project",category:"example-like"}],["proof",{name:"proof",category:"proof-like"}],["case",{name:"case",category:"proof-like"}],["solution",{name:"solution",category:"solution-like"}],["hint",{name:"hint",category:"solution-like"}],["answer",{name:"answer",category:"solution-like"}]]),w=new Set(["theorem-like","definition-like"]);function v(e){return{type:"root",children:f(e.children,1)}}function b(e){for(const t of e){if(t.type!=="element")continue;const i=t;if(g.has(i.name)||k.has(i.name)){const n=i.attributes??{},r={};return n["xml:id"]&&(r.xmlid=n["xml:id"]),n.label&&(r.label=n.label),n.component&&(r.component=n.component),{name:i.name,attributes:r}}if(x.has(i.name)){const n=b(i.children);if(n)return n}}}function f(e,t){const i=[];for(const n of e){if(n.type!=="element")continue;const r=n;if(x.has(r.name)||k.has(r.name))i.push(...f(r.children,t));else if(g.has(r.name))i.push(...P(r,Math.min(t,6)));else{const s=p(r);s!==null&&i.push(s)}}return i}function P(e,t){const i=[],n=e.attributes??{},r=e.children,s=r.find(a=>a.type==="element"&&a.name==="title"),m=r.filter(a=>!(a.type==="element"&&a.name==="title")),o={type:"heading",depth:t,children:s?s.children.map(h).filter(u):[],...n["xml:id"]?{data:{id:n["xml:id"],hProperties:{id:n["xml:id"]}}}:{}};i.push(o);const l=Math.min(t+1,6);return i.push(...f(m,l)),i}function p(e){switch(e.name){case"p":return M(e);case"blockquote":return D(e);case"ol":return y(e,!0);case"ul":return y(e,!1);case"program":return N(e);case"me":case"men":case"md":case"mdn":return C(e);default:{const t=E.get(e.name);return t?j(e,t):null}}}function M(e){return{type:"paragraph",children:e.children.map(h).filter(u)}}function D(e){return{type:"blockquote",children:e.children.filter(t=>t.type==="element").map(t=>p(t)).filter(u)}}function y(e,t){return{type:"list",ordered:t,spread:!1,children:e.children.filter(i=>i.type==="element").map(i=>_(i))}}function _(e){return{type:"listItem",spread:!1,children:e.children.filter(t=>t.type==="element").map(t=>p(t)).filter(u)}}function N(e){return{type:"code",lang:(e.attributes??{}).language??null,value:c.getPtxTextContent(e)}}function C(e){const t=e.children;return t.length>0&&t[0].type==="text"?{type:"math",value:c.getPtxTextContent(e)}:{type:"math",value:t.filter(n=>n.type==="element"&&n.name==="mrow").map(n=>c.getPtxTextContent(n)).join(` \\\\
+`)}}function j(e,t){const i=e.attributes??{},n=e.children,r={};i["xml:id"]&&(r.id=i["xml:id"]);for(const[o,l]of Object.entries(i))o==="xml:id"||l==null||(r[o]=l);const s=n.find(o=>o.type==="element"&&o.name==="title"),m=[];if(s){const o={type:"paragraph",data:{directiveLabel:!0},children:s.children.map(h).filter(u)};m.push(o)}if(w.has(t.category))for(const o of n){if(o.type!=="element")continue;const l=o;if(l.name!=="title")if(l.name==="statement")for(const a of l.children){if(a.type!=="element")continue;const d=p(a);d&&m.push(d)}else{const a=p(l);a&&m.push(a)}}else for(const o of n){if(o.type!=="element")continue;const l=o;if(l.name==="title")continue;const a=p(l);a&&m.push(a)}return{type:"containerDirective",name:t.name,attributes:Object.keys(r).length>0?r:void 0,children:m}}function h(e){if(e.type==="text")return{type:"text",value:e.value??""};if(e.type!=="element")return null;const t=e;switch(t.name){case"em":return{type:"emphasis",children:t.children.map(h).filter(u)};case"alert":return{type:"strong",children:t.children.map(h).filter(u)};case"c":return{type:"inlineCode",value:c.getPtxTextContent(t)};case"m":return{type:"inlineMath",value:c.getPtxTextContent(t)};default:return null}}function u(e){return e!==null}function q(e){const t=v(e),i=T.toMarkdown(t,{extensions:[I.directiveToMarkdown(),S.mathToMarkdown()]}),n=b(e.children);if(!n)return i;const r=[];return n.name!=="chapter"&&r.push(`division: ${n.name}`),n.attributes.xmlid&&r.push(`xmlid: ${n.attributes.xmlid}`),n.attributes.label&&r.push(`label: ${n.attributes.label}`),n.attributes.component&&r.push(`component: ${n.attributes.component}`),r.length===0?i:`---
+${r.join(`
+`)}
 ---
 
-${n}`}exports.ptxastToMarkdown=j;exports.ptxastToMdast=x;
+${i}`}exports.ptxastToMarkdown=q;exports.ptxastToMdast=v;

package/dist/index.js

@@ -1,17 +1,18 @@
-import { DIVISION_HIERARCHY as x, getPtxTextContent as p } from "@pretextbook/ptxast";
-import { toMarkdown as b } from "mdast-util-to-markdown";
-import { directiveToMarkdown as T } from "mdast-util-directive";
-import { mathToMarkdown as w } from "mdast-util-math";
+import { DIVISION_HIERARCHY as b, EXTRA_DIVISION_TYPES as T, isTitlelessDivisionType as I, TITLELESS_DIVISION_TYPES as S, getPtxTextContent as p } from "@pretextbook/ptxast";
+import { toMarkdown as E } from "mdast-util-to-markdown";
+import { directiveToMarkdown as w } from "mdast-util-directive";
+import { mathToMarkdown as _ } from "mdast-util-math";
 const g = /* @__PURE__ */ new Set([
-  ...x,
-  "appendix"
-]), k = /* @__PURE__ */ new Set([
+  ...b,
+  ...T.filter((e) => !I(e))
+]), k = new Set(S), v = /* @__PURE__ */ new Set([
   "pretext",
   "book",
   "article",
+  "slideshow",
   "frontmatter",
   "backmatter"
-]), E = /* @__PURE__ */ new Map([
+]), P = /* @__PURE__ */ new Map([
   // theorem-like
   ["theorem", { name: "theorem", category: "theorem-like" }],
   ["lemma", { name: "lemma", category: "theorem-like" }],
@@ -50,88 +51,91 @@ const g = /* @__PURE__ */ new Set([
   ["solution", { name: "solution", category: "solution-like" }],
   ["hint", { name: "hint", category: "solution-like" }],
   ["answer", { name: "answer", category: "solution-like" }]
-]), I = /* @__PURE__ */ new Set(["theorem-like", "definition-like"]);
-function M(e) {
+]), D = /* @__PURE__ */ new Set(["theorem-like", "definition-like"]);
+function N(e) {
   return {
     type: "root",
     children: h(e.children, 1)
   };
 }
-function v(e) {
+function x(e) {
   for (const t of e) {
     if (t.type !== "element") continue;
-    const n = t;
-    if (g.has(n.name)) return n.name;
-    if (k.has(n.name)) {
-      const r = v(n.children);
-      if (r) return r;
+    const i = t;
+    if (g.has(i.name) || k.has(i.name)) {
+      const n = i.attributes ?? {}, r = {};
+      return n["xml:id"] && (r.xmlid = n["xml:id"]), n.label && (r.label = n.label), n.component && (r.component = n.component), { name: i.name, attributes: r };
+    }
+    if (v.has(i.name)) {
+      const n = x(i.children);
+      if (n) return n;
     }
   }
 }
 function h(e, t) {
-  const n = [];
-  for (const r of e) {
-    if (r.type !== "element") continue;
-    const a = r;
-    if (k.has(a.name))
-      n.push(...h(a.children, t));
-    else if (g.has(a.name))
-      n.push(...P(a, Math.min(t, 6)));
+  const i = [];
+  for (const n of e) {
+    if (n.type !== "element") continue;
+    const r = n;
+    if (v.has(r.name) || k.has(r.name))
+      i.push(...h(r.children, t));
+    else if (g.has(r.name))
+      i.push(...M(r, Math.min(t, 6)));
     else {
-      const l = u(a);
-      l !== null && n.push(l);
+      const c = u(r);
+      c !== null && i.push(c);
     }
   }
-  return n;
+  return i;
 }
-function P(e, t) {
-  const n = [], r = e.attributes ?? {}, a = e.children, l = a.find(
-    (o) => o.type === "element" && o.name === "title"
-  ), m = a.filter(
-    (o) => !(o.type === "element" && o.name === "title")
-  ), i = {
+function M(e, t) {
+  const i = [], n = e.attributes ?? {}, r = e.children, c = r.find(
+    (a) => a.type === "element" && a.name === "title"
+  ), s = r.filter(
+    (a) => !(a.type === "element" && a.name === "title")
+  ), o = {
     type: "heading",
     depth: t,
-    children: l ? l.children.map(f).filter(s) : [],
-    ...r["xml:id"] ? { data: { id: r["xml:id"], hProperties: { id: r["xml:id"] } } } : {}
+    children: c ? c.children.map(f).filter(m) : [],
+    ...n["xml:id"] ? { data: { id: n["xml:id"], hProperties: { id: n["xml:id"] } } } : {}
   };
-  n.push(i);
-  const c = Math.min(t + 1, 6);
-  return n.push(...h(m, c)), n;
+  i.push(o);
+  const l = Math.min(t + 1, 6);
+  return i.push(...h(s, l)), i;
 }
 function u(e) {
   switch (e.name) {
     case "p":
-      return D(e);
+      return L(e);
     case "blockquote":
-      return N(e);
+      return A(e);
     case "ol":
       return y(e, !0);
     case "ul":
       return y(e, !1);
     case "program":
-      return A(e);
+      return j(e);
     case "me":
     case "men":
     case "md":
     case "mdn":
-      return _(e);
+      return R(e);
     default: {
-      const t = E.get(e.name);
-      return t ? j(e, t) : null;
+      const t = P.get(e.name);
+      return t ? Y(e, t) : null;
     }
   }
 }
-function D(e) {
+function L(e) {
   return {
     type: "paragraph",
-    children: e.children.map(f).filter(s)
+    children: e.children.map(f).filter(m)
   };
 }
-function N(e) {
+function A(e) {
   return {
     type: "blockquote",
-    children: e.children.filter((t) => t.type === "element").map((t) => u(t)).filter(s)
+    children: e.children.filter((t) => t.type === "element").map((t) => u(t)).filter(m)
   };
 }
 function y(e, t) {
@@ -139,73 +143,73 @@ function y(e, t) {
     type: "list",
     ordered: t,
     spread: !1,
-    children: e.children.filter((n) => n.type === "element").map((n) => S(n))
+    children: e.children.filter((i) => i.type === "element").map((i) => O(i))
   };
 }
-function S(e) {
+function O(e) {
   return {
     type: "listItem",
     spread: !1,
-    children: e.children.filter((t) => t.type === "element").map((t) => u(t)).filter(s)
+    children: e.children.filter((t) => t.type === "element").map((t) => u(t)).filter(m)
   };
 }
-function A(e) {
+function j(e) {
   return {
     type: "code",
     lang: (e.attributes ?? {}).language ?? null,
     value: p(e)
   };
 }
-function _(e) {
+function R(e) {
   const t = e.children;
-  return t.length > 0 && t[0].type === "text" ? { type: "math", value: p(e) } : { type: "math", value: t.filter((r) => r.type === "element" && r.name === "mrow").map((r) => p(r)).join(` \\\\
+  return t.length > 0 && t[0].type === "text" ? { type: "math", value: p(e) } : { type: "math", value: t.filter((n) => n.type === "element" && n.name === "mrow").map((n) => p(n)).join(` \\\\
 `) };
 }
-function j(e, t) {
-  const n = e.attributes ?? {}, r = e.children, a = {};
-  n["xml:id"] && (a.id = n["xml:id"]);
-  for (const [i, c] of Object.entries(n))
-    i === "xml:id" || c == null || (a[i] = c);
-  const l = r.find(
-    (i) => i.type === "element" && i.name === "title"
-  ), m = [];
-  if (l) {
-    const i = {
+function Y(e, t) {
+  const i = e.attributes ?? {}, n = e.children, r = {};
+  i["xml:id"] && (r.id = i["xml:id"]);
+  for (const [o, l] of Object.entries(i))
+    o === "xml:id" || l == null || (r[o] = l);
+  const c = n.find(
+    (o) => o.type === "element" && o.name === "title"
+  ), s = [];
+  if (c) {
+    const o = {
       type: "paragraph",
       data: { directiveLabel: !0 },
-      children: l.children.map(f).filter(s)
+      children: c.children.map(f).filter(m)
     };
-    m.push(i);
+    s.push(o);
   }
-  if (I.has(t.category))
-    for (const i of r) {
-      if (i.type !== "element") continue;
-      const c = i;
-      if (c.name !== "title")
-        if (c.name === "statement")
-          for (const o of c.children) {
-            if (o.type !== "element") continue;
-            const d = u(o);
-            d && m.push(d);
+  if (D.has(t.category))
+    for (const o of n) {
+      if (o.type !== "element") continue;
+      const l = o;
+      if (l.name !== "title")
+        if (l.name === "statement")
+          for (const a of l.children) {
+            if (a.type !== "element") continue;
+            const d = u(a);
+            d && s.push(d);
           }
         else {
-          const o = u(c);
-          o && m.push(o);
+          const a = u(l);
+          a && s.push(a);
         }
     }
   else
-    for (const i of r) {
-      if (i.type !== "element") continue;
-      const c = i;
-      if (c.name === "title") continue;
-      const o = u(c);
-      o && m.push(o);
+    for (const o of n) {
+      if (o.type !== "element") continue;
+      const l = o;
+      if (l.name === "title") continue;
+      const a = u(l);
+      a && s.push(a);
     }
   return {
     type: "containerDirective",
     name: t.name,
-    attributes: Object.keys(a).length > 0 ? a : void 0,
-    children: m
+    attributes: Object.keys(r).length > 0 ? r : void 0,
+    children: s
   };
 }
 function f(e) {
@@ -217,12 +221,12 @@ function f(e) {
     case "em":
       return {
         type: "emphasis",
-        children: t.children.map(f).filter(s)
+        children: t.children.map(f).filter(m)
       };
     case "alert":
       return {
         type: "strong",
-        children: t.children.map(f).filter(s)
+        children: t.children.map(f).filter(m)
       };
     case "c":
       return { type: "inlineCode", value: p(t) };
@@ -232,20 +236,23 @@ function f(e) {
       return null;
   }
 }
-function s(e) {
+function m(e) {
   return e !== null;
 }
-function O(e) {
-  const t = M(e), n = b(t, {
-    extensions: [T(), w()]
-  }), r = v(e.children);
-  return !r || r === "chapter" ? n : `---
-division: ${r}
+function H(e) {
+  const t = N(e), i = E(t, {
+    extensions: [w(), _()]
+  }), n = x(e.children);
+  if (!n) return i;
+  const r = [];
+  return n.name !== "chapter" && r.push(`division: ${n.name}`), n.attributes.xmlid && r.push(`xmlid: ${n.attributes.xmlid}`), n.attributes.label && r.push(`label: ${n.attributes.label}`), n.attributes.component && r.push(`component: ${n.attributes.component}`), r.length === 0 ? i : `---
+${r.join(`
+`)}
 ---
 
-${n}`;
+${i}`;
 }
 export {
-  O as ptxastToMarkdown,
-  M as ptxastToMdast
+  H as ptxastToMarkdown,
+  N as ptxastToMdast
 };

package/dist/lib/ptxast-to-mdast.d.ts

@@ -1,6 +1,7 @@
 import { Root as MdastRoot } from 'mdast';
 import { Root, ElementContent } from '@pretextbook/ptxast';
 export declare const DIVISION_TYPE_NAMES: Set<string>;
+export declare const TITLELESS_DIVISION_TYPES: Set<string>;
 /**
  * Structural container types whose content should be recursed into
  * without emitting a heading, and without changing the current depth.
@@ -10,6 +11,23 @@ export declare const DIVISION_TYPE_NAMES: Set<string>;
 export declare const TRANSPARENT_TYPES: Set<string>;
 /** Convert an xast Root (PreTeXt document) to an mdast Root. */
 export declare function ptxastToMdast(root: Root): MdastRoot;
+/** The outermost division's name plus the subset of its attributes that
+ * round-trip through markdown frontmatter (`xmlid`, `label`, `component`). */
+export interface TopLevelDivisionInfo {
+    name: string;
+    attributes: {
+        xmlid?: string;
+        label?: string;
+        component?: string;
+    };
+}
+/**
+ * Find the outermost division in a ptxast tree (skipping transparent
+ * structural wrappers), i.e. the division a depth-1 heading would represent
+ * if this tree were flattened to markdown — along with its `xml:id`/
+ * `label`/`component` attributes, for round-tripping into frontmatter.
+ */
+export declare function findTopLevelDivisionInfo(nodes: ElementContent[]): TopLevelDivisionInfo | undefined;
 /**
  * Find the name of the outermost division in a ptxast tree (skipping
  * transparent structural wrappers), i.e. the division a depth-1 heading

package/dist/lib/ptxast-util-to-mdast.d.ts

@@ -4,8 +4,10 @@ export { ptxastToMdast } from './ptxast-to-mdast.js';
  * Convert an xast Root (PreTeXt document) to a markdown string using the directive
  * syntax for PreTeXt block environments.
  *
- * When the document's outermost division isn't `chapter` (the default a
- * depth-1 heading is assumed to mean), a `division:` frontmatter block is
- * prepended so the markdown can be converted back to PreTeXt unambiguously.
+ * A leading frontmatter block is prepended when the outermost division
+ * carries information that markdown can't otherwise represent: a
+ * `division:` field when it isn't `chapter` (the default a depth-1 heading
+ * is assumed to mean), and `xmlid:`/`label:`/`component:` fields mirroring
+ * that division's `xml:id`/`label`/`component` attributes.
  */
 export declare function ptxastToMarkdown(root: Root): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pretextbook/ptxast-util-to-mdast",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Convert ptxast to mdast (markdown AST) and markdown strings",
   "author": "Oscar Levin",
   "license": "GPL-3.0-or-later",
@@ -39,7 +39,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@pretextbook/ptxast": "^0.0.5",
+    "@pretextbook/ptxast": "^0.0.7",
     "@types/mdast": "^4.0.0",
     "mdast-util-directive": "^3.0.0",
     "mdast-util-math": "^3.0.0",