@brillout/docpress 0.7.0 → 0.7.2

package/config/resolveHeadingsData.ts

@@ -13,6 +13,7 @@ import { NavigationData, NavItem } from '../navigation/Navigation'
 import type { LinkData } from '../components'
 import type { Exports, PageContextOriginal } from './resolvePageContext'
 import pc from '@brillout/picocolors'
+import { parseTitle } from '../parseTitle'
 
 type PageSectionResolved = {
   url: string | null
@@ -130,7 +131,7 @@ function getTitles(
 
   const { title } = activeHeading
   let pageTitle = isLandingPage ? null : title
-  let documentTitle = activeHeading.titleDocument || jsxToTextContent(title)
+  let documentTitle = activeHeading.titleDocument || jsxToTextContent(parseTitle(title))
 
   if (!isLandingPage) {
     documentTitle += ' | ' + config.projectInfo.projectName

package/dist/config/resolveHeadingsData.js

@@ -22,6 +22,7 @@ export { resolveHeadingsData };
 import { assert, jsxToTextContent } from '../utils/server';
 import { getConfig } from './getConfig';
 import pc from '@brillout/picocolors';
+import { parseTitle } from '../parseTitle';
 function resolveHeadingsData(pageContext) {
     var config = getConfig();
     {
@@ -111,7 +112,7 @@ function getTitles(activeHeading, pageContext, config) {
     var isLandingPage = url === '/';
     var title = activeHeading.title;
     var pageTitle = isLandingPage ? null : title;
-    var documentTitle = activeHeading.titleDocument || jsxToTextContent(title);
+    var documentTitle = activeHeading.titleDocument || jsxToTextContent(parseTitle(title));
     if (!isLandingPage) {
         documentTitle += ' | ' + config.projectInfo.projectName;
     }

package/dist/utils/assert.js

@@ -1,6 +1,24 @@
 export { assert };
 export { assertUsage };
 export { assertWarning };
+var devModeKey = '__docpress_dev_mode';
+if (isBrowser()) {
+    ;
+    window.toggleDevMode = toggleDevMode;
+    console.log([
+        '[@brillout/docpress] DEV MODE',
+        isDevMode() ? 'enabled' : 'disabled',
+        !isLocalhost() && 'run window.toggleDevMode() to toggle DEV MODE',
+    ]
+        .filter(Boolean)
+        .join(' '));
+    if (isDevMode()) {
+        window.onerror = function (err) {
+            alert(err);
+            window.onerror = null;
+        };
+    }
+}
 function assert(condition, debugInfo) {
     if (condition) {
         return;
@@ -17,8 +35,8 @@ function assert(condition, debugInfo) {
         errMsg += ' Debug info: ' + String(debugInfo);
     }
     var err = new Error(errMsg);
-    if (isBrowserAndDev()) {
-        alert(err.stack);
+    if (isBrowser() && isDevMode()) {
+        window.alert(err.stack);
     }
     throw err;
 }
@@ -27,14 +45,32 @@ function assertUsage(condition, msg) {
         return;
     }
     var err = new Error('[DocPress][Wrong Usage] ' + msg);
-    if (isBrowserAndDev()) {
-        alert(err.stack);
+    if (isBrowser() && isDevMode()) {
+        window.alert(err.stack);
     }
     throw err;
 }
-function isBrowserAndDev() {
+function isBrowser() {
+    return typeof window !== 'undefined';
+}
+function isDevMode() {
+    return !!window.localStorage[devModeKey] || isLocalhost();
+}
+function isLocalhost() {
     var _a;
-    return typeof window !== 'undefined' && ((_a = window === null || window === void 0 ? void 0 : window.location) === null || _a === void 0 ? void 0 : _a.port) !== '';
+    return ((_a = window === null || window === void 0 ? void 0 : window.location) === null || _a === void 0 ? void 0 : _a.port) !== '';
+}
+function toggleDevMode() {
+    if (isLocalhost())
+        throw new Error('On localhost DEV MODE is always on.');
+    var isEnabled = function () { return window.localStorage[devModeKey]; };
+    if (!isEnabled()) {
+        window.localStorage[devModeKey] = 'true';
+    }
+    else {
+        delete window.localStorage[devModeKey];
+    }
+    console.log("DEV MODE ".concat(isEnabled() ? 'enabled' : 'disabled'));
 }
 function assertWarning(condition, msg) {
     if (condition) {
@@ -42,7 +78,7 @@ function assertWarning(condition, msg) {
     }
     msg = '[DocPress][Warning] ' + msg;
     console.warn(msg);
-    if (isBrowserAndDev()) {
-        alert(msg);
+    if (isBrowser() && isDevMode()) {
+        window.alert(msg);
     }
 }

package/dist/utils/jsxToTextContent.d.ts

@@ -1,2 +1,2 @@
 export { jsxToTextContent };
-declare function jsxToTextContent(node: JSX.Element | string): string;
+declare function jsxToTextContent(node: JSX.Element): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brillout/docpress",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "scripts": {
     "======== Build": "",

package/renderer/onRenderClient.tsx

@@ -20,6 +20,7 @@ initOnLinkClick()
 
 let root: ReactDOM.Root
 function onRenderClient(pageContext: PageContextClient) {
+  // TODO: stop using any
   const pageContextResolved: PageContextResolved = (pageContext as any).pageContextResolved
   let page = getPageElement(pageContext, pageContextResolved)
   page = <OnRenderDoneHook>{page}</OnRenderDoneHook>
@@ -32,6 +33,16 @@ function onRenderClient(pageContext: PageContextClient) {
     }
     root.render(page)
   }
+
+  if (!pageContext.isHydration) {
+    applyHead(pageContext)
+  }
+}
+
+function applyHead(pageContext: PageContextClient) {
+  // TODO: stop using any
+  const pageContextResolved: PageContextResolved = (pageContext as any).pageContextResolved
+  document.title = pageContextResolved.documentTitle
 }
 
 function onRenderDone() {

package/renderer/onRenderHtml.tsx

@@ -3,11 +3,14 @@ export { onRenderHtml }
 import ReactDOMServer from 'react-dom/server'
 import { escapeInject, dangerouslySkipEscape } from 'vike/server'
 import { assert } from '../utils/server'
-import type { PageContextServer } from 'vike/types'
 import type { PageContextResolved } from '../config/resolvePageContext'
 import { getPageElement } from './getPageElement'
+import type { OnRenderHtmlAsync } from 'vike/types'
 
-async function onRenderHtml(pageContext: PageContextServer) {
+const onRenderHtml: OnRenderHtmlAsync = async (
+  pageContext,
+): // TODO: Why is Promise<Awaited<>> needed?
+Promise<Awaited<ReturnType<OnRenderHtmlAsync>>> => {
   const pageContextResolved: PageContextResolved = (pageContext as any).pageContextResolved
 
   const page = getPageElement(pageContext, pageContextResolved)

package/utils/assert.ts

@@ -2,6 +2,27 @@ export { assert }
 export { assertUsage }
 export { assertWarning }
 
+const devModeKey = '__docpress_dev_mode'
+
+if (isBrowser()) {
+  ;(window as any).toggleDevMode = toggleDevMode
+  console.log(
+    [
+      '[@brillout/docpress] DEV MODE',
+      isDevMode() ? 'enabled' : 'disabled',
+      !isLocalhost() && 'run window.toggleDevMode() to toggle DEV MODE',
+    ]
+      .filter(Boolean)
+      .join(' '),
+  )
+  if (isDevMode()) {
+    window.onerror = (err) => {
+      alert(err)
+      window.onerror = null
+    }
+  }
+}
+
 function assert(condition: unknown, debugInfo?: unknown): asserts condition {
   if (condition) {
     return
@@ -18,8 +39,8 @@ function assert(condition: unknown, debugInfo?: unknown): asserts condition {
     errMsg += ' Debug info: ' + String(debugInfo)
   }
   const err = new Error(errMsg)
-  if (isBrowserAndDev()) {
-    alert(err.stack)
+  if (isBrowser() && isDevMode()) {
+    window.alert(err.stack)
   }
   throw err
 }
@@ -29,14 +50,30 @@ function assertUsage(condition: unknown, msg: string): asserts condition {
     return
   }
   const err = new Error('[DocPress][Wrong Usage] ' + msg)
-  if (isBrowserAndDev()) {
-    alert(err.stack)
+  if (isBrowser() && isDevMode()) {
+    window.alert(err.stack)
   }
   throw err
 }
 
-function isBrowserAndDev() {
-  return typeof window !== 'undefined' && window?.location?.port !== ''
+function isBrowser() {
+  return typeof window !== 'undefined'
+}
+function isDevMode() {
+  return !!window.localStorage[devModeKey] || isLocalhost()
+}
+function isLocalhost() {
+  return window?.location?.port !== ''
+}
+function toggleDevMode() {
+  if (isLocalhost()) throw new Error('On localhost DEV MODE is always on.')
+  const isEnabled = () => window.localStorage[devModeKey]
+  if (!isEnabled()) {
+    window.localStorage[devModeKey] = 'true'
+  } else {
+    delete window.localStorage[devModeKey]
+  }
+  console.log(`DEV MODE ${isEnabled() ? 'enabled' : 'disabled'}`)
 }
 
 function assertWarning(condition: unknown, msg: string): asserts condition {
@@ -45,7 +82,7 @@ function assertWarning(condition: unknown, msg: string): asserts condition {
   }
   msg = '[DocPress][Warning] ' + msg
   console.warn(msg)
-  if (isBrowserAndDev()) {
-    alert(msg)
+  if (isBrowser() && isDevMode()) {
+    window.alert(msg)
   }
 }

package/utils/jsxToTextContent.ts

@@ -3,7 +3,7 @@ import { assert } from './assert'
 export { jsxToTextContent }
 
 // https://stackoverflow.com/questions/34204975/react-is-there-something-similar-to-node-textcontent/60564620#60564620
-function jsxToTextContent(node: JSX.Element | string): string {
+function jsxToTextContent(node: JSX.Element): string {
   if (['string', 'number'].includes(typeof node)) return String(node)
   if (node instanceof Array) return node.map(jsxToTextContent).join('')
   if (typeof node === 'object' && node) return jsxToTextContent(node.props.children)