@brillout/docpress 0.15.10 → 0.15.11

package/dist/resolvePageContext.js

@@ -1,75 +1,57 @@
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 export { resolvePageContext };
-import { assert } from './utils/assert';
+import { assert, assertUsage } from './utils/assert';
 import { jsxToTextContent } from './utils/jsxToTextContent';
 import pc from '@brillout/picocolors';
 import { parseMarkdownMini } from './parseMarkdownMini';
 import { determineNavItemsColumnLayout } from './determineNavItemsColumnLayout';
 function resolvePageContext(pageContext) {
-    var _a;
-    var config = pageContext.globalContext.config.docpress;
-    var urlPathname = pageContext.urlPathname;
-    var pageSections = (_a = pageContext.config.pageSectionsExport) !== null && _a !== void 0 ? _a : [];
+    const config = pageContext.globalContext.config.docpress;
+    const { urlPathname } = pageContext;
+    const pageSections = pageContext.config.pageSectionsExport ?? [];
     {
-        var headings = config.headings, headingsDetached = config.headingsDetached;
-        assertHeadingsDefinition(__spreadArray(__spreadArray([], headings, true), headingsDetached, true));
+        const { headings, headingsDetached } = config;
+        assertHeadingsDefinition([...headings, ...headingsDetached]);
     }
-    var ret = getHeadingsResolved(config);
-    var headingsDetachedResolved = ret.headingsDetachedResolved;
-    var headingsResolved = ret.headingsResolved;
-    var _b = getActiveHeading(headingsResolved, headingsDetachedResolved, urlPathname), activeHeading = _b.activeHeading, isDetachedPage = _b.isDetachedPage, activeCategoryName = _b.activeCategoryName;
-    var _c = getTitles(activeHeading, urlPathname, config), documentTitle = _c.documentTitle, isLandingPage = _c.isLandingPage, pageTitle = _c.pageTitle;
-    var pageSectionsResolved = getPageSectionsResolved(pageSections, activeHeading);
-    var linksGlobal = __spreadArray(__spreadArray([], headingsResolved.map(headingToLinkData), true), headingsDetachedResolved.map(headingToLinkData), true);
-    var linksPage = pageSectionsResolved.map(pageSectionToLinkData);
-    var linksAll = __spreadArray(__spreadArray([], linksPage, true), linksGlobal, true);
-    var navItemsAll;
-    var navItemsDetached;
+    const ret = getHeadingsResolved(config);
+    const { headingsDetachedResolved } = ret;
+    let { headingsResolved } = ret;
+    const { activeHeading, isDetachedPage, activeCategoryName } = getActiveHeading(headingsResolved, headingsDetachedResolved, urlPathname);
+    const { documentTitle, isLandingPage, pageTitle } = getTitles(activeHeading, urlPathname, config);
+    const pageSectionsResolved = getPageSectionsResolved(pageSections, activeHeading);
+    const linksGlobal = [
+        ...headingsResolved.map(headingToLinkData),
+        ...headingsDetachedResolved.map(headingToLinkData),
+    ];
+    const linksPage = pageSectionsResolved.map(pageSectionToLinkData);
+    const linksAll = [...linksPage, ...linksGlobal];
+    let navItemsAll;
+    let navItemsDetached;
     {
-        var navItemsPageSections = pageSectionsResolved
-            .filter(function (pageSection) { return pageSection.pageSectionLevel === 2; })
+        const navItemsPageSections = pageSectionsResolved
+            .filter((pageSection) => pageSection.pageSectionLevel === 2)
             .map(pageSectionToNavItem);
         navItemsAll = headingsResolved.map(headingToNavItem);
         determineNavItemsColumnLayout(navItemsAll);
         if (isDetachedPage) {
-            navItemsDetached = __spreadArray([headingToNavItem(activeHeading)], navItemsPageSections, true);
+            navItemsDetached = [headingToNavItem(activeHeading), ...navItemsPageSections];
         }
         else {
-            var activeHeadingIndex_1 = navItemsAll.findIndex(function (navItem) { return navItem.url === urlPathname; });
-            assert(activeHeadingIndex_1 >= 0);
-            navItemsPageSections.forEach(function (navItem, i) {
-                navItemsAll.splice(activeHeadingIndex_1 + 1 + i, 0, navItem);
+            const activeHeadingIndex = navItemsAll.findIndex((navItem) => navItem.url === urlPathname);
+            assert(activeHeadingIndex >= 0);
+            navItemsPageSections.forEach((navItem, i) => {
+                navItemsAll.splice(activeHeadingIndex + 1 + i, 0, navItem);
             });
         }
     }
-    var resolved = {
-        navItemsAll: navItemsAll,
-        navItemsDetached: navItemsDetached,
+    const resolved = {
+        navItemsAll,
+        navItemsDetached,
         pageDesign: activeHeading.pageDesign,
-        linksAll: linksAll,
-        isLandingPage: isLandingPage,
-        pageTitle: pageTitle,
-        documentTitle: documentTitle,
-        activeCategoryName: activeCategoryName,
+        linksAll,
+        isLandingPage,
+        pageTitle,
+        documentTitle,
+        activeCategoryName,
     };
     return resolved;
 }
@@ -109,106 +91,117 @@ function pageSectionToLinkData(pageSection) {
     };
 }
 function getTitles(activeHeading, urlPathname, config) {
-    var isLandingPage = urlPathname === '/';
-    var title = activeHeading.title;
-    var pageTitle = isLandingPage ? null : title;
-    var documentTitle = activeHeading.titleDocument || jsxToTextContent(parseMarkdownMini(title));
+    const isLandingPage = urlPathname === '/';
+    const { title } = activeHeading;
+    let pageTitle = isLandingPage ? null : title;
+    let documentTitle = activeHeading.titleDocument || jsxToTextContent(parseMarkdownMini(title));
     if (!isLandingPage) {
         documentTitle += ' | ' + config.name;
     }
     if (isLandingPage) {
         pageTitle = null;
     }
-    return { documentTitle: documentTitle, isLandingPage: isLandingPage, pageTitle: pageTitle };
+    return { documentTitle, isLandingPage, pageTitle };
 }
 function getActiveHeading(headingsResolved, headingsDetachedResolved, urlPathname) {
-    var _a;
-    var activeHeading = null;
-    var activeCategoryName = 'Miscellaneous';
-    var headingCategory;
+    const URLs = '\n' +
+        [...headingsResolved, ...headingsDetachedResolved]
+            .filter(Boolean)
+            .map((h) => h.url)
+            .sort()
+            .map((url) => `  ${url}`)
+            .join('\n');
+    const errNotFound = `URL ${pc.bold(urlPathname)} not found in following URLs:${URLs}`;
+    const errFoundTwice = `URL ${pc.bold(urlPathname)} found twice in following URLs:${URLs}`;
+    let activeHeading = null;
+    let activeCategoryName = 'Miscellaneous';
+    let headingCategory;
     assert(urlPathname);
-    for (var _i = 0, headingsResolved_1 = headingsResolved; _i < headingsResolved_1.length; _i++) {
-        var heading = headingsResolved_1[_i];
+    for (const heading of headingsResolved) {
         if (heading.level === 1) {
             headingCategory = heading.title;
         }
         if (heading.url === urlPathname) {
+            assertUsage(!activeHeading, errFoundTwice);
             activeHeading = heading;
             assert(headingCategory);
             activeCategoryName = headingCategory;
-            assert(heading.level === 2, { pageUrl: urlPathname, heading: heading });
+            assert(heading.level === 2, { pageUrl: urlPathname, heading });
             break;
         }
     }
-    var isDetachedPage = !activeHeading;
-    if (!activeHeading) {
-        activeHeading = (_a = headingsDetachedResolved.find(function (_a) {
-            var url = _a.url;
-            return urlPathname === url;
-        })) !== null && _a !== void 0 ? _a : null;
-    }
+    const isDetachedPage = !activeHeading;
     if (!activeHeading) {
-        throw new Error([
-            "URL ".concat(pc.bold(urlPathname), " not found in following URLs:"),
-            __spreadArray(__spreadArray([], headingsResolved, true), headingsDetachedResolved, true).filter(Boolean)
-                .map(function (h) { return h.url; })
-                .sort()
-                .map(function (url) { return "  ".concat(url); })
-                .join('\n'),
-        ].join('\n'));
+        const found = headingsDetachedResolved.filter(({ url }) => urlPathname === url);
+        if (found.length > 0) {
+            assertUsage(found.length === 1, errFoundTwice);
+            assertUsage(!activeHeading, errFoundTwice);
+            activeHeading = found[0];
+        }
     }
+    assertUsage(activeHeading, errNotFound);
     if (activeHeading.category)
         activeCategoryName = activeHeading.category;
-    return { activeHeading: activeHeading, isDetachedPage: isDetachedPage, activeCategoryName: activeCategoryName };
+    return { activeHeading, isDetachedPage, activeCategoryName };
 }
 function getPageSectionsResolved(pageSections, activeHeading) {
-    var pageSectionsResolved = pageSections.map(function (pageSection) {
-        var _a;
-        var pageSectionTitle = pageSection.pageSectionTitle;
-        var url = pageSection.pageSectionId === null ? null : '#' + pageSection.pageSectionId;
-        var pageSectionResolved = {
-            url: url,
+    const pageSectionsResolved = pageSections.map((pageSection) => {
+        const { pageSectionTitle } = pageSection;
+        const url = pageSection.pageSectionId === null ? null : '#' + pageSection.pageSectionId;
+        const pageSectionResolved = {
+            url,
             title: pageSectionTitle,
-            linkBreadcrumb: __spreadArray([activeHeading.title], ((_a = activeHeading.linkBreadcrumb) !== null && _a !== void 0 ? _a : []), true),
+            linkBreadcrumb: [activeHeading.title, ...(activeHeading.linkBreadcrumb ?? [])],
             titleInNav: pageSectionTitle,
             pageSectionLevel: pageSection.pageSectionLevel,
         };
         return pageSectionResolved;
     });
-    if (activeHeading === null || activeHeading === void 0 ? void 0 : activeHeading.sectionTitles) {
-        activeHeading.sectionTitles.forEach(function (sectionTitle) {
-            var pageSectionTitles = pageSections.map(function (h) { return h.pageSectionTitle; });
-            assert(pageSectionTitles.includes(sectionTitle), { pageHeadingTitles: pageSectionTitles, sectionTitle: sectionTitle });
+    if (activeHeading?.sectionTitles) {
+        activeHeading.sectionTitles.forEach((sectionTitle) => {
+            const pageSectionTitles = pageSections.map((h) => h.pageSectionTitle);
+            assert(pageSectionTitles.includes(sectionTitle), { pageHeadingTitles: pageSectionTitles, sectionTitle });
         });
     }
     return pageSectionsResolved;
 }
 function getHeadingsResolved(config) {
-    var headingsWithoutBreadcrumb = config.headings.map(function (heading) {
-        var titleInNav = heading.titleInNav || heading.title;
-        var headingResolved = __assign(__assign({}, heading), { titleInNav: titleInNav });
+    const headingsWithoutBreadcrumb = config.headings.map((heading) => {
+        const titleInNav = heading.titleInNav || heading.title;
+        const headingResolved = {
+            ...heading,
+            titleInNav,
+        };
         return headingResolved;
     });
-    var headingsResolved = [];
-    headingsWithoutBreadcrumb.forEach(function (heading) {
-        var linkBreadcrumb = getHeadingsBreadcrumb(heading, headingsResolved);
-        headingsResolved.push(__assign(__assign({}, heading), { linkBreadcrumb: linkBreadcrumb }));
+    const headingsResolved = [];
+    headingsWithoutBreadcrumb.forEach((heading) => {
+        const linkBreadcrumb = getHeadingsBreadcrumb(heading, headingsResolved);
+        headingsResolved.push({
+            ...heading,
+            linkBreadcrumb,
+        });
     });
-    var headingsDetachedResolved = config.headingsDetached.map(function (headingsDetached) {
-        var url = headingsDetached.url;
-        assert(headingsResolved.find(function (heading) { return heading.url === url; }) === undefined, "remove ".concat(headingsDetached.url, " from headingsDetached"));
-        return __assign(__assign({}, headingsDetached), { level: 2, titleInNav: headingsDetached.title, linkBreadcrumb: null });
+    const headingsDetachedResolved = config.headingsDetached.map((headingsDetached) => {
+        const { url } = headingsDetached;
+        assert(headingsResolved.find((heading) => heading.url === url) === undefined, `remove ${headingsDetached.url} from headingsDetached`);
+        return {
+            ...headingsDetached,
+            level: 2,
+            titleInNav: headingsDetached.title,
+            linkBreadcrumb: null,
+        };
     });
-    return { headingsResolved: headingsResolved, headingsDetachedResolved: headingsDetachedResolved };
+    return { headingsResolved, headingsDetachedResolved };
 }
 function getHeadingsBreadcrumb(heading, headings) {
-    var linkBreadcrumb = [];
-    var levelCurrent = heading.level;
+    const linkBreadcrumb = [];
+    let levelCurrent = heading.level;
     headings
         .slice()
         .reverse()
-        .forEach(function (parentCandidate) {
-        var isParent = parentCandidate.level < levelCurrent;
+        .forEach((parentCandidate) => {
+        const isParent = parentCandidate.level < levelCurrent;
         if (isParent) {
             levelCurrent = parentCandidate.level;
             linkBreadcrumb.push(parentCandidate.title);
@@ -217,9 +210,9 @@ function getHeadingsBreadcrumb(heading, headings) {
     return linkBreadcrumb;
 }
 function assertHeadingsDefinition(headings) {
-    headings.forEach(function (heading) {
+    headings.forEach((heading) => {
         if (heading.url) {
-            var url = heading.url;
+            const { url } = heading;
             assert(url.startsWith('/'));
         }
     });

package/dist/utils/Emoji/Emoji.js

@@ -1,22 +1,10 @@
 // Let's eventually remove this. Telefunc is still using this as of 2024-12.
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 import React from 'react';
 import { assert } from '../assert';
 import { iconMechanicalArm, iconShield, iconTypescript, iconEngine } from './assets';
 export { Emoji };
-function Emoji(_a) {
-    var name = _a.name, style = _a.style;
-    var emoji = 
+function Emoji({ name, style }) {
+    const emoji = 
     // ***
     // U+26A0
     // https://emojipedia.org/warning/
@@ -165,22 +153,26 @@ function Emoji(_a) {
       (name === 'left-right-arrow' && Unicode(0xFE0F)) ||
       (name === 'left-right-arrow' && Unicode(0xFE0F, { fontFamily: 'reset' })) ||
       ======================== */
-    assert(emoji, { name: name });
+    assert(emoji, { name });
     return emoji;
     function Unicode(codePoint, styleAddendum) {
-        var text = String.fromCodePoint(codePoint);
+        const text = String.fromCodePoint(codePoint);
         if (style || styleAddendum) {
-            return React.createElement('span', { style: __assign(__assign({}, style), styleAddendum) }, text);
+            return React.createElement('span', { style: { ...style, ...styleAddendum } }, text);
         }
         else {
             return React.createElement(React.Fragment, null, text);
         }
     }
-    function Img(imgSrc, width) {
-        if (width === void 0) { width = '1.15em'; }
-        var props = {
+    function Img(imgSrc, width = '1.15em') {
+        const props = {
             src: imgSrc,
-            style: __assign({ verticalAlign: 'text-top', fontSize: '1em', width: width }, style),
+            style: {
+                verticalAlign: 'text-top',
+                fontSize: '1em',
+                width,
+                ...style,
+            },
         };
         return React.createElement('img', props);
     }

package/dist/utils/assert.js

@@ -2,8 +2,8 @@ export { assert };
 export { assertUsage };
 export { assertWarning };
 import { getGlobalObject } from './getGlobalObject.js';
-var devModeKey = '__docpress_dev_mode';
-var globalObject = getGlobalObject('utils/assert.ts', {
+const devModeKey = '__docpress_dev_mode';
+const globalObject = getGlobalObject('utils/assert.ts', {
     alreadyLogged: new Set(),
 });
 if (isBrowser()) {
@@ -18,7 +18,7 @@ if (isBrowser()) {
         .join(' '));
 }
 if (isDevMode()) {
-    window.onerror = function (err) {
+    window.onerror = (err) => {
         window.alert(err);
         window.onerror = null;
     };
@@ -27,25 +27,25 @@ function assert(condition, debugInfo) {
     if (condition) {
         return;
     }
-    var hasDebugInfo = debugInfo !== undefined;
+    const hasDebugInfo = debugInfo !== undefined;
     if (hasDebugInfo) {
         console.log(debugInfo);
         if (typeof debugInfo === 'object') {
             debugInfo = JSON.stringify(debugInfo);
         }
     }
-    var errMsg = '[DocPress] Bug. Contact DocPress maintainer.';
+    let errMsg = '[DocPress] Bug. Contact DocPress maintainer.';
     if (hasDebugInfo) {
         errMsg += ' Debug info: ' + String(debugInfo);
     }
-    var err = new Error(errMsg);
+    const err = new Error(errMsg);
     throw err;
 }
 function assertUsage(condition, msg) {
     if (condition) {
         return;
     }
-    var err = new Error('[DocPress][Wrong Usage] ' + msg);
+    const err = new Error('[DocPress][Wrong Usage] ' + msg);
     throw err;
 }
 function isBrowser() {
@@ -55,34 +55,32 @@ function isDevMode() {
     return isBrowser() && (!!window.localStorage[devModeKey] || isLocalhost());
 }
 function isLocalhost() {
-    var _a;
-    return ((_a = window === null || window === void 0 ? void 0 : window.location) === null || _a === void 0 ? void 0 : _a.port) !== '';
+    return window?.location?.port !== '';
 }
 function toggleDevMode() {
     if (isLocalhost())
         throw new Error('On localhost DEV MODE is always on.');
-    var isEnabled = function () { return window.localStorage[devModeKey]; };
+    const isEnabled = () => window.localStorage[devModeKey];
     if (!isEnabled()) {
         window.localStorage[devModeKey] = 'true';
     }
     else {
         delete window.localStorage[devModeKey];
     }
-    console.log("DEV MODE ".concat(isEnabled() ? 'enabled' : 'disabled'));
+    console.log(`DEV MODE ${isEnabled() ? 'enabled' : 'disabled'}`);
 }
-function assertWarning(condition, msg, _a) {
-    var _b = _a === void 0 ? {} : _a, _c = _b.onlyOnce, onlyOnce = _c === void 0 ? true : _c, showStackTrace = _b.showStackTrace;
+function assertWarning(condition, msg, { onlyOnce = true, showStackTrace } = {}) {
     if (condition) {
         return;
     }
-    var err = new Error(msg);
+    const err = new Error(msg);
     if (!import.meta.env.DEV) {
         throw err;
     }
     else {
         if (onlyOnce) {
-            var alreadyLogged = globalObject.alreadyLogged;
-            var key = onlyOnce === true ? msg : onlyOnce;
+            const { alreadyLogged } = globalObject;
+            const key = onlyOnce === true ? msg : onlyOnce;
             if (alreadyLogged.has(key))
                 return;
             alreadyLogged.add(key);

package/dist/utils/cls.js

@@ -1,5 +1,5 @@
 export { cls };
 function cls(className) {
-    var classNames = Array.isArray(className) ? className : [className];
+    const classNames = Array.isArray(className) ? className : [className];
     return classNames.filter(Boolean).join(' ');
 }

package/dist/utils/determineSectionUrlHash.js

@@ -4,7 +4,7 @@ export { determineSectionTitle };
 function determineSectionUrlHash(title) {
     title = title.toLowerCase();
     title = removeAccentsAndDiacritics(title);
-    var urlHash = title
+    const urlHash = title
         // \u4E00-\u9FA5 are chinese characters, see https://github.com/brillout/docpress/pull/2
         .split(/[^a-z0-9\u4E00-\u9FA5]+/)
         .filter(Boolean)
@@ -20,11 +20,11 @@ function removeAccentsAndDiacritics(str) {
     return str.normalize('NFD').replace(/[\u0300-\u036f]/g, '');
 }
 function determineSectionTitle(urlWithHash) {
-    assert(urlWithHash.includes('#'), { urlWithHash: urlWithHash });
-    var urlHash = urlWithHash.split('#')[1];
-    var title = urlHash
+    assert(urlWithHash.includes('#'), { urlWithHash });
+    const urlHash = urlWithHash.split('#')[1];
+    const title = urlHash
         .split('-')
-        .map(function (word, i) {
+        .map((word, i) => {
         if (i === 0) {
             return capitalizeFirstLetter(word);
         }

package/dist/utils/filter.js

@@ -1,8 +1,8 @@
 export { filter };
 // https://stackoverflow.com/questions/66341757/typescript-how-to-filter-the-object
 function filter(obj, predicate) {
-    var result = {};
-    Object.keys(obj).forEach(function (name) {
+    const result = {};
+    Object.keys(obj).forEach((name) => {
         if (predicate(obj[name], name)) {
             result[name] = obj[name];
         }

package/dist/utils/getGlobalObject.js

@@ -2,8 +2,8 @@ export function getGlobalObject(
 // We use the filename as key; each `getGlobalObject()` call should live inside a file with a unique filename.
 key, defaultValue) {
     // @ts-ignore
-    var globalObjectsAll = (globalThis[projectKey] = globalThis[projectKey] || {});
-    var globalObject = (globalObjectsAll[key] = globalObjectsAll[key] || defaultValue);
+    const globalObjectsAll = (globalThis[projectKey] = globalThis[projectKey] || {});
+    const globalObject = (globalObjectsAll[key] = globalObjectsAll[key] || defaultValue);
     return globalObject;
 }
-var projectKey = '_docpress';
+const projectKey = '_docpress';

package/dist/vite.config.js

@@ -5,15 +5,20 @@ import { parsePageSections } from './parsePageSections.js';
 import rehypePrettyCode from 'rehype-pretty-code';
 import remarkGfm from 'remark-gfm';
 import { transformerNotationDiff } from '@shikijs/transformers';
-var root = process.cwd();
-var prettyCode = [rehypePrettyCode, { theme: 'github-light', transformers: [transformerNotationDiff()] }];
-var rehypePlugins = [prettyCode];
-var remarkPlugins = [remarkGfm];
-var config = {
-    root: root,
+import { remarkDetype } from './remarkDetype.js';
+import { rehypeMetaToProps } from './rehypeMetaToProps.js';
+const root = process.cwd();
+const prettyCode = [
+    rehypePrettyCode,
+    { theme: 'github-light', keepBackground: false, transformers: [transformerNotationDiff()] },
+];
+const rehypePlugins = [prettyCode, [rehypeMetaToProps]];
+const remarkPlugins = [remarkGfm, remarkDetype];
+const config = {
+    root,
     plugins: [
         parsePageSections(),
-        mdx({ rehypePlugins: rehypePlugins, remarkPlugins: remarkPlugins }),
+        mdx({ rehypePlugins, remarkPlugins, providerImportSource: '@brillout/docpress' }),
         // @vitejs/plugin-react-swc needs to be added *after* the mdx plugins
         react(),
     ],

package/index.ts

@@ -1,3 +1,6 @@
+/**********/
+/* PUBLIC */
+/**********/
 export {
   CodeBlockTransformer,
   Link,
@@ -6,16 +9,23 @@ export {
   FileRemoved,
   ImportMeta,
   Emoji,
+  TypescriptOnly,
 } from './components'
 export { MenuToggle } from './Layout'
-
-// The only place usePageContext() is used at:
-// https://github.com/vikejs/vike/blob/0b1b109f64aafbed23a1c2ac2630e6146a270ec0/packages/vike.dev/components/CommunityNote.tsx#L4
-export { usePageContext } from './renderer/usePageContext'
-
 export * from './components/Note'
 export * from './icons/index'
 export { assert } from './utils/assert'
 export { parseMarkdownMini } from './parseMarkdownMini'
 export type { Config } from './types/Config'
 export type { HeadingDefinition, HeadingDetachedDefinition } from './types/Heading'
+// The only place usePageContext() is used at:
+// https://github.com/vikejs/vike/blob/0b1b109f64aafbed23a1c2ac2630e6146a270ec0/packages/vike.dev/components/CommunityNote.tsx#L4
+export { usePageContext } from './renderer/usePageContext'
+
+// The following are used internally by DocPress — users (should) never use these exports
+/************/
+/* INTERNAL */
+/************/
+// We provide our own `useMDXComponents()` to enable MDX component injection by setting `providerImportSource` to '@brillout/docpress'.
+// https://mdxjs.com/guides/injecting-components/
+export { useMDXComponents } from './components/useMDXComponents'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brillout/docpress",
-  "version": "0.15.10",
+  "version": "0.15.11",
   "type": "module",
   "dependencies": {
     "@brillout/picocolors": "^1.0.10",
@@ -11,9 +11,11 @@
     "@mdx-js/rollup": "3.0.1",
     "@shikijs/transformers": "1.2.0",
     "@vitejs/plugin-react-swc": "^3.10.2",
+    "detype": "^1.1.3",
     "rehype-pretty-code": "0.13.0",
     "remark-gfm": "4.0.0",
     "shiki": "1.2.0",
+    "unist-util-visit": "^5.0.0",
     "vite": "^6.3.5"
   },
   "peerDependencies": {
@@ -58,6 +60,8 @@
   },
   "devDependencies": {
     "@brillout/release-me": "^0.4.8",
+    "@types/hast": "^3.0.4",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^22.5.5",
     "@types/react": "^18.3.8",
     "@types/react-dom": "^18.3.0"