@brillout/docpress 0.12.4 → 0.12.6

package/components/Algolia/Hit.tsx

@@ -14,7 +14,7 @@ type HierarchyType = Exclude<DocSearchHit['type'], 'content'>
 
 function Hit({ hit }: HitProps) {
   return (
-    <a href={hit.type === 'lvl1' ? hit.url.split('#')[0] : hit.url}>
+    <a href={hit.url}>
       <div className="DocSearch-Hit-Container">
         {(hit as InternalDocSearchHit).__docsearch_parent && (
           <svg className="DocSearch-Hit-Tree" viewBox="0 0 24 54">

package/components/Link.tsx

@@ -13,12 +13,14 @@ function Link({
   text,
   noBreadcrumb,
   doNotInferSectionTitle,
+  noWarning,
   children,
 }: {
   href: string
   text?: string | React.ReactNode
-  noBreadcrumb?: true
-  doNotInferSectionTitle?: true
+  noBreadcrumb?: boolean
+  doNotInferSectionTitle?: boolean
+  noWarning?: boolean
   children?: React.ReactNode
 }) {
   const pageContext = usePageContext()
@@ -30,15 +32,18 @@ function Link({
   // assertWarning(!text, 'prop `text` is deprecated')
   text = text ?? children
 
-  const linkTextData = getLinkTextData(href, pageContext, doNotInferSectionTitle)
-  if (!linkTextData) {
-    text = 'LINK-TARGET-NOT-FOUND'
-  } else if (!text) {
-    text = getLinkText({
-      noBreadcrumb,
-      ...linkTextData,
-    })
+  const linkTextData = getLinkTextData({ href, pageContext, doNotInferSectionTitle, noWarning })
+  if (!text) {
+    if (linkTextData) {
+      text = getLinkText({
+        noBreadcrumb,
+        ...linkTextData,
+      })
+    } else {
+      text = 'LINK-TARGET-NOT-FOUND'
+    }
   }
+
   return <a href={href}>{text}</a>
 }
 
@@ -48,7 +53,7 @@ function getLinkText({
   sectionTitle,
   isLinkOnSamePage,
 }: {
-  noBreadcrumb: true | undefined
+  noBreadcrumb: boolean | undefined
   linkData: LinkData
   sectionTitle: React.JSX.Element | null
   isLinkOnSamePage: boolean
@@ -78,10 +83,20 @@ function getLinkText({
   )
 }
 
-function getLinkTextData(href: string, pageContext: PageContextResolved, doNotInferSectionTitle?: boolean) {
+function getLinkTextData({
+  href,
+  pageContext,
+  doNotInferSectionTitle,
+  noWarning,
+}: {
+  href: string
+  pageContext: PageContextResolved
+  doNotInferSectionTitle?: boolean
+  noWarning?: boolean
+}) {
   const { hrefPathname, hrefHash } = parseHref(href)
 
-  const linkData = findLinkData(hrefPathname || pageContext.urlPathname, pageContext)
+  const linkData = findLinkData(hrefPathname || pageContext.urlPathname, { pageContext, noWarning })
   if (!linkData) return null
   const isLinkOnSamePage = linkData.url === pageContext.urlPathname
   if (!hrefPathname) assert(isLinkOnSamePage)
@@ -90,7 +105,7 @@ function getLinkTextData(href: string, pageContext: PageContextResolved, doNotIn
   if (hrefHash) {
     assert(!hrefHash.startsWith('#'))
     if (isLinkOnSamePage) {
-      const linkDataPageSection = findLinkData(`#${hrefHash}`, pageContext)
+      const linkDataPageSection = findLinkData(`#${hrefHash}`, { pageContext, noWarning })
       if (!linkDataPageSection) return null
       sectionTitle = parseMarkdownMini(linkDataPageSection.title)
     } else if ('sectionTitles' in linkData && linkData.sectionTitles) {
@@ -121,29 +136,36 @@ type LinkData = {
   linkBreadcrumb: null | string[]
   sectionTitles?: string[]
 }
-function findLinkData(href: string, pageContext: PageContextResolved): LinkData | null {
+function findLinkData(
+  href: string,
+  { pageContext, noWarning }: { pageContext: PageContextResolved; noWarning?: boolean },
+): LinkData | null {
   assert(href.startsWith('/') || href.startsWith('#'))
   const { linksAll } = pageContext
   const linkData = linksAll.find(({ url }) => href === url)
   if (href.startsWith('#')) {
-    assertWarning(linkData, `Couldn't find ${href} in ${pageContext.urlPathname}, does it exist?`)
+    if (!noWarning) {
+      assertWarning(linkData, `Couldn't find ${href} in ${pageContext.urlPathname}, does it exist?`)
+    }
   } else {
-    assertWarning(
-      linkData,
-      [
-        `Couldn't find page with URL ${pc.bold(href)}`,
-        `— did you define it in`,
+    if (!noWarning) {
+      assertWarning(
+        linkData,
         [
-          pc.cyan('docpress.config.js'),
-          pc.dim('#{'),
-          pc.cyan('headings'),
-          pc.dim(','),
-          pc.cyan('headingsDetached'),
-          pc.dim('}'),
-          '?',
-        ].join(''),
-      ].join(' '),
-    )
+          `Couldn't find page with URL ${pc.bold(href)}`,
+          `— did you define it in`,
+          [
+            pc.cyan('docpress.config.js'),
+            pc.dim('#{'),
+            pc.cyan('headings'),
+            pc.dim(','),
+            pc.cyan('headingsDetached'),
+            pc.dim('}'),
+            '?',
+          ].join(''),
+        ].join(' '),
+      )
+    }
   }
   return linkData ?? null
 }

package/css/code/block.css

@@ -32,18 +32,25 @@ figure[data-rehype-pretty-code-figure] {
     font-size: 0.8em !important;
   }
 }
-@container container-viewport (max-width: 620px) {
-  pre > code {
-    font-size: 0.7em !important;
+/* `@media (pointer: fine)`
+ *  - Further reduce code block font size only on mobile.
+ *  - https://github.com/vikejs/vike/issues/2369#issuecomment-2803046966
+ *  - https://stackoverflow.com/questions/23885255/how-to-remove-ignore-hover-css-style-on-touch-devices/64553121#64553121
+ */
+@media not all and (hover: hover) and (pointer: fine) {
+  @container container-viewport (max-width: 620px) {
+    pre > code {
+      font-size: 0.7em !important;
+    }
   }
-}
-@container container-viewport (max-width: 550px) {
-  pre > code {
-    font-size: 0.6em !important;
+  @container container-viewport (max-width: 550px) {
+    pre > code {
+      font-size: 0.6em !important;
+    }
   }
-}
-@container container-viewport (max-width: 450px) {
-  pre > code {
-    font-size: 0.5em !important;
+  @container container-viewport (max-width: 450px) {
+    pre > code {
+      font-size: 0.5em !important;
+    }
   }
 }

package/dist/components/Link.d.ts

@@ -1,11 +1,12 @@
 export { Link };
 export type { LinkData };
 import React from 'react';
-declare function Link({ href, text, noBreadcrumb, doNotInferSectionTitle, children, }: {
+declare function Link({ href, text, noBreadcrumb, doNotInferSectionTitle, noWarning, children, }: {
     href: string;
     text?: string | React.ReactNode;
-    noBreadcrumb?: true;
-    doNotInferSectionTitle?: true;
+    noBreadcrumb?: boolean;
+    doNotInferSectionTitle?: boolean;
+    noWarning?: boolean;
     children?: React.ReactNode;
 }): React.JSX.Element;
 type LinkData = {

package/dist/components/Link.js

@@ -16,18 +16,20 @@ import { assert, assertUsage, assertWarning, determineSectionTitle, determineSec
 import { parseMarkdownMini } from '../parseMarkdownMini';
 import pc from '@brillout/picocolors';
 function Link(_a) {
-    var href = _a.href, text = _a.text, noBreadcrumb = _a.noBreadcrumb, doNotInferSectionTitle = _a.doNotInferSectionTitle, children = _a.children;
+    var href = _a.href, text = _a.text, noBreadcrumb = _a.noBreadcrumb, doNotInferSectionTitle = _a.doNotInferSectionTitle, noWarning = _a.noWarning, children = _a.children;
     var pageContext = usePageContext();
     assertUsage(href.startsWith('/') || href.startsWith('#'), "<Link href /> prop `href==='".concat(href, "'` but should start with '/' or '#'"));
     assertUsage(!text || !children, 'Cannot use both `text` or `children`');
     // assertWarning(!text, 'prop `text` is deprecated')
     text = text !== null && text !== void 0 ? text : children;
-    var linkTextData = getLinkTextData(href, pageContext, doNotInferSectionTitle);
-    if (!linkTextData) {
-        text = 'LINK-TARGET-NOT-FOUND';
-    }
-    else if (!text) {
-        text = getLinkText(__assign({ noBreadcrumb: noBreadcrumb }, linkTextData));
+    var linkTextData = getLinkTextData({ href: href, pageContext: pageContext, doNotInferSectionTitle: doNotInferSectionTitle, noWarning: noWarning });
+    if (!text) {
+        if (linkTextData) {
+            text = getLinkText(__assign({ noBreadcrumb: noBreadcrumb }, linkTextData));
+        }
+        else {
+            text = 'LINK-TARGET-NOT-FOUND';
+        }
     }
     return React.createElement("a", { href: href }, text);
 }
@@ -51,9 +53,10 @@ function getLinkText(_a) {
             title));
     })));
 }
-function getLinkTextData(href, pageContext, doNotInferSectionTitle) {
-    var _a = parseHref(href), hrefPathname = _a.hrefPathname, hrefHash = _a.hrefHash;
-    var linkData = findLinkData(hrefPathname || pageContext.urlPathname, pageContext);
+function getLinkTextData(_a) {
+    var href = _a.href, pageContext = _a.pageContext, doNotInferSectionTitle = _a.doNotInferSectionTitle, noWarning = _a.noWarning;
+    var _b = parseHref(href), hrefPathname = _b.hrefPathname, hrefHash = _b.hrefHash;
+    var linkData = findLinkData(hrefPathname || pageContext.urlPathname, { pageContext: pageContext, noWarning: noWarning });
     if (!linkData)
         return null;
     var isLinkOnSamePage = linkData.url === pageContext.urlPathname;
@@ -63,7 +66,7 @@ function getLinkTextData(href, pageContext, doNotInferSectionTitle) {
     if (hrefHash) {
         assert(!hrefHash.startsWith('#'));
         if (isLinkOnSamePage) {
-            var linkDataPageSection = findLinkData("#".concat(hrefHash), pageContext);
+            var linkDataPageSection = findLinkData("#".concat(hrefHash), { pageContext: pageContext, noWarning: noWarning });
             if (!linkDataPageSection)
                 return null;
             sectionTitle = parseMarkdownMini(linkDataPageSection.title);
@@ -85,7 +88,8 @@ function getLinkTextData(href, pageContext, doNotInferSectionTitle) {
     }
     return { linkData: linkData, sectionTitle: sectionTitle, isLinkOnSamePage: isLinkOnSamePage };
 }
-function findLinkData(href, pageContext) {
+function findLinkData(href, _a) {
+    var pageContext = _a.pageContext, noWarning = _a.noWarning;
     assert(href.startsWith('/') || href.startsWith('#'));
     var linksAll = pageContext.linksAll;
     var linkData = linksAll.find(function (_a) {
@@ -93,22 +97,26 @@ function findLinkData(href, pageContext) {
         return href === url;
     });
     if (href.startsWith('#')) {
-        assertWarning(linkData, "Couldn't find ".concat(href, " in ").concat(pageContext.urlPathname, ", does it exist?"));
+        if (!noWarning) {
+            assertWarning(linkData, "Couldn't find ".concat(href, " in ").concat(pageContext.urlPathname, ", does it exist?"));
+        }
     }
     else {
-        assertWarning(linkData, [
-            "Couldn't find page with URL ".concat(pc.bold(href)),
-            "\u2014 did you define it in",
-            [
-                pc.cyan('docpress.config.js'),
-                pc.dim('#{'),
-                pc.cyan('headings'),
-                pc.dim(','),
-                pc.cyan('headingsDetached'),
-                pc.dim('}'),
-                '?',
-            ].join(''),
-        ].join(' '));
+        if (!noWarning) {
+            assertWarning(linkData, [
+                "Couldn't find page with URL ".concat(pc.bold(href)),
+                "\u2014 did you define it in",
+                [
+                    pc.cyan('docpress.config.js'),
+                    pc.dim('#{'),
+                    pc.cyan('headings'),
+                    pc.dim(','),
+                    pc.cyan('headingsDetached'),
+                    pc.dim('}'),
+                    '?',
+                ].join(''),
+            ].join(' '));
+        }
     }
     return linkData !== null && linkData !== void 0 ? linkData : null;
 }

package/docsearch/DocSearchInstall.tsx

@@ -21,6 +21,14 @@ function DocSearchInstall() {
         searchParameters={{
           filters: 'is_available:true',
         }}
+        transformItems={(hits) => {
+          hits.map((hit) => {
+            if (hit.type === 'lvl1') {
+              hit.url = hit.url.split('#')[0]
+            }
+          })
+          return hits
+        }}
       />
     </div>
   )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brillout/docpress",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "type": "module",
   "dependencies": {
     "@brillout/picocolors": "^1.0.10",