@cudoment/cudoc 0.1.0 → 0.3.0

package/dist/sections.d.ts

@@ -0,0 +1,15 @@
+import type { Heading, Root } from "mdast";
+export type SectionSelection = {
+    anchors?: string[];
+    titles?: string[];
+    depth?: number | number[];
+    includeChildren?: boolean;
+};
+export type CollectedSection = {
+    anchorId: string;
+    title: string;
+    tree: Root;
+    heading: Heading;
+};
+export declare function collectSections(tree: Root, select?: SectionSelection): CollectedSection[];
+//# sourceMappingURL=sections.d.ts.map

package/dist/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../src/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAS1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AACD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,gBAAqB,GAC5B,gBAAgB,EAAE,CA8CpB"}

package/dist/sections.js

@@ -0,0 +1,40 @@
+import { visit } from "unist-util-visit";
+import { getHeadingAnchorId, sliceSectionByAnchorId, } from "./internal/core/query/sections.js";
+import { getNodeText } from "./internal/core/query/nodes.js";
+export function collectSections(tree, select = {}) {
+    const result = [];
+    const depths = select.depth === undefined
+        ? undefined
+        : Array.isArray(select.depth)
+            ? select.depth
+            : [select.depth];
+    if (depths?.some((d) => !Number.isInteger(d) || d < 1 || d > 6))
+        throw new TypeError("cudoc: section depth must be 1-6");
+    visit(tree, "heading", (heading) => {
+        const anchorId = getHeadingAnchorId(heading);
+        const title = getNodeText(heading.children.filter((n) => !["badge", "permalink"].includes(n.data?.cudoc?.kind ?? ""))).trim();
+        if (!anchorId ||
+            (select.anchors &&
+                !select.anchors.map((id) => id.replace(/^#/, "")).includes(anchorId)) ||
+            (select.titles && !select.titles.includes(title)) ||
+            (depths && !depths.includes(heading.depth)))
+            return;
+        const section = structuredClone(sliceSectionByAnchorId(tree, anchorId));
+        if (select.includeChildren === false) {
+            const end = section.children.findIndex((n, i) => i > 0 && n.type === "heading");
+            if (end >= 0)
+                section.children = [
+                    ...section.children.slice(0, end),
+                    ...section.children
+                        .slice(end)
+                        .filter((n) => n.type === "definition" || n.type === "footnoteDefinition"),
+                ];
+        }
+        result.push({ anchorId, title, tree: section, heading });
+    });
+    for (const id of select.anchors ?? [])
+        if (!result.some((s) => s.anchorId === id.replace(/^#/, "")))
+            throw new Error(`cudoc: missing section: ${id}`);
+    return result;
+}
+//# sourceMappingURL=sections.js.map

package/dist/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../src/sections.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cudoment/cudoc",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Reusable document ASTs: validation, queries, export and loading for cross-document embedding.",
   "keywords": [
     "cudoc",
@@ -63,12 +63,58 @@
     "./node/paths": {
       "types": "./dist/node/paths.d.ts",
       "default": "./dist/node/paths.js"
-    }
+    },
+    "./transforms/*": {
+      "types": "./dist/internal/transforms/*.d.ts",
+      "default": "./dist/internal/transforms/*.js"
+    },
+    "./document": {
+      "types": "./dist/document.d.ts",
+      "default": "./dist/document.js"
+    },
+    "./markdown": {
+      "types": "./dist/markdown.d.ts",
+      "default": "./dist/markdown.js"
+    },
+    "./render": {
+      "types": "./dist/render.d.ts",
+      "default": "./dist/render.js"
+    },
+    "./sections": {
+      "types": "./dist/sections.d.ts",
+      "default": "./dist/sections.js"
+    },
+    "./dataset": {
+      "types": "./dist/dataset.d.ts",
+      "default": "./dist/dataset.js"
+    },
+    "./node/library": {
+      "types": "./dist/node/library.d.ts",
+      "default": "./dist/node/library.js"
+    },
+    "./node/dataset": {
+      "types": "./dist/node/dataset.d.ts",
+      "default": "./dist/node/dataset.js"
+    },
+    "./node/resolve-embed": {
+      "types": "./dist/node/resolve-embed.d.ts",
+      "default": "./dist/node/resolve-embed.js"
+    },
+    "./node/storage": {
+      "types": "./dist/node/storage.d.ts",
+      "default": "./dist/node/storage.js"
+    },
+    "./node/prepare-embeds": {
+      "types": "./dist/node/prepare-embeds.d.ts",
+      "default": "./dist/node/prepare-embeds.js"
+    },
+    "./styles.css": "./styles.css"
   },
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "styles.css"
   ],
   "engines": {
     "node": ">=20"
@@ -78,10 +124,22 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
+    "@mdx-js/mdx": "^3.1.1",
+    "estree-util-value-to-estree": "^3.5.0",
+    "github-slugger": "^2.0.0",
+    "hast-util-from-html": "^2.0.3",
+    "hast-util-to-html": "^9.0.5",
     "mdast-util-mdx-jsx": "^3.2.0",
-    "unist-util-visit": "^5.0.0",
+    "mdast-util-to-hast": "^13.2.1",
+    "remark-directive": "^4.0.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx": "^3.1.1",
+    "remark-parse": "^11.0.0",
     "unified": "^11.0.5",
-    "vfile": "^6.0.3"
+    "unist-util-visit": "^5.0.0",
+    "vfile": "^6.0.3",
+    "yaml": "^2.9.0"
   },
   "peerDependencies": {
     "@types/mdast": "^4.0.4"
@@ -90,5 +148,8 @@
     "@types/mdast": {
       "optional": true
     }
+  },
+  "bin": {
+    "cudoc": "./dist/node/cli.js"
   }
 }

package/styles.css

@@ -0,0 +1,90 @@
+/**
+ * Callout, badge and embed styles for a host site.
+ *
+ * This stylesheet lives inside someone else's page, so its properties are
+ * namespaced and it never sets a text colour: the body colour is inherited from
+ * the host's own theme. Only the surfaces and accents flip, which keeps the
+ * components readable whether the host renders light or dark.
+ *
+ * Three theme signals are honoured, because a host may follow the system
+ * setting or expose its own toggle: `prefers-color-scheme`, a `dark`/`light`
+ * class (VitePress, Nextra) and `data-theme` (Docusaurus).
+ */
+:root {
+  --cudoc-wash: #f1f5f9;
+  --cudoc-line: #e2e8f0;
+  --cudoc-accent: #1d4ed8;
+  --cudoc-accent-soft: #dbeafe;
+  --cudoc-warn: #b45309;
+  --cudoc-warn-wash: #fef6e7;
+  --cudoc-danger: #b91c1c;
+  --cudoc-danger-wash: #fdeeee;
+}
+@media (prefers-color-scheme: dark) {
+  :root:not(.light):not([data-theme="light"]) {
+    --cudoc-wash: #1b2336;
+    --cudoc-line: #334155;
+    --cudoc-accent: #7cb0fb;
+    --cudoc-accent-soft: #1e3252;
+    --cudoc-warn: #fbbf24;
+    --cudoc-warn-wash: #2b2110;
+    --cudoc-danger: #f87171;
+    --cudoc-danger-wash: #2c1618;
+  }
+}
+:root.dark,
+:root[data-theme="dark"] {
+  --cudoc-wash: #1b2336;
+  --cudoc-line: #334155;
+  --cudoc-accent: #7cb0fb;
+  --cudoc-accent-soft: #1e3252;
+  --cudoc-warn: #fbbf24;
+  --cudoc-warn-wash: #2b2110;
+  --cudoc-danger: #f87171;
+  --cudoc-danger-wash: #2c1618;
+}
+
+.cudoc-badge {
+  display: inline-block;
+  margin-left: 0.35em;
+  padding: 0.1em 0.5em;
+  border-radius: 0.75em;
+  background: var(--cudoc-accent-soft);
+  color: var(--cudoc-accent);
+  font-size: 0.8em;
+  font-weight: 600;
+  white-space: nowrap;
+  vertical-align: 0.08em;
+}
+.cudoc-callout {
+  margin: 1.5rem 0;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--cudoc-line);
+  border-left: 3px solid var(--cudoc-accent);
+  border-radius: 0.375rem;
+  background: var(--cudoc-wash);
+}
+.cudoc-callout > :first-child {
+  margin-top: 0;
+}
+.cudoc-callout > :last-child {
+  margin-bottom: 0;
+}
+.cudoc-callout-title {
+  display: block;
+  margin-bottom: 0.25rem;
+  font-weight: 700;
+}
+.cudoc-callout-warning,
+.cudoc-callout-caution {
+  border-left-color: var(--cudoc-warn);
+  background: var(--cudoc-warn-wash);
+}
+.cudoc-callout-danger,
+.cudoc-callout-error {
+  border-left-color: var(--cudoc-danger);
+  background: var(--cudoc-danger-wash);
+}
+.cudoc-embed {
+  min-width: 0;
+}