@brillout/docpress 0.6.21-commit-c920754 → 0.7.0

package/dist/navigation/Navigation.js

@@ -51,7 +51,13 @@ function NavItemComponent(_a) {
     }
     else {
         var sectionTitle = jsxToTextContent(titleJsx);
-        assertWarning(navItem.url, "".concat(jsxToTextContent(titleInNavJsx), " is missing a URL hash. Use `<h2 id=\"url-hash\">").concat(sectionTitle, "</h2>` instead of `## ").concat(sectionTitle, "`."));
+        assertWarning(navItem.url, [
+            "".concat(jsxToTextContent(titleInNavJsx), " is missing a URL hash."),
+            "Add a URL hash with: `## ".concat(sectionTitle, "{#some-hash}`."),
+            /* TODO/eventually: not implemented yet.
+            `Use \`<h2 id="url-hash">${sectionTitle}</h2>\` instead of \`## ${sectionTitle}\`.`,
+            */
+        ].join(' '));
     }
     return (React.createElement("a", { className: [
             'nav-item',

package/dist/parsePageSections.js

@@ -73,7 +73,11 @@ function transform(code) {
         if (isCodeBlock) {
             return line;
         }
-        if (line.startsWith('#')) {
+        if (line.startsWith('#')
+        /* TODO/eventually: implement.
+        || line.startsWith('<h2')
+        */
+        ) {
             var _a = parsePageSection(line), pageSectionId = _a.pageSectionId, pageSectionLevel = _a.pageSectionLevel, pageSectionTitle = _a.pageSectionTitle, headingHtml = _a.headingHtml;
             pageSections.push({ pageSectionId: pageSectionId, pageSectionLevel: pageSectionLevel, pageSectionTitle: pageSectionTitle });
             return headingHtml;

package/navigation/Navigation.tsx

@@ -101,9 +101,13 @@ function NavItemComponent({
     const sectionTitle = jsxToTextContent(titleJsx)
     assertWarning(
       navItem.url,
-      `${jsxToTextContent(
-        titleInNavJsx,
-      )} is missing a URL hash. Use \`<h2 id="url-hash">${sectionTitle}</h2>\` instead of \`## ${sectionTitle}\`.`,
+      [
+        `${jsxToTextContent(titleInNavJsx)} is missing a URL hash.`,
+        `Add a URL hash with: \`## ${sectionTitle}{#some-hash}\`.`,
+        /* TODO/eventually: not implemented yet.
+        `Use \`<h2 id="url-hash">${sectionTitle}</h2>\` instead of \`## ${sectionTitle}\`.`,
+        */
+      ].join(' '),
     )
   }
   return (

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "@brillout/docpress",
-  "version": "0.6.21-commit-c920754",
+  "version": "0.7.0",
   "type": "module",
   "scripts": {
-    "// Build vite.config.ts and +config.ts": "",
+    "======== Build": "",
+    "// Build vite.config.ts and +config.ts (other files don't need to be built as @brillout/docpress is noExternal)": "",
     "build": "rm -rf dist/ && tsc --project tsconfig.config.json",
-    "// Development": "",
+    "======== Develop": "",
     "dev": "tsc --watch --project tsconfig.config.json",
-    "// Check types while developing": "",
+    "// Check types of all source files while developing": "",
     "typecheck": "tsc --noEmit --watch",
-    "// Release": "",
+    "========= Release": "",
     "release": "release-me patch",
-    "release:commit": "release-me commit",
-    "release:breaking-change": "release-me minor"
+    "release:minor": "release-me minor",
+    "release:commit": "release-me commit"
   },
   "dependencies": {
     "@brillout/picocolors": "^1.0.10",

package/parsePageSections.ts

@@ -44,7 +44,12 @@ function transform(code: string) {
         return line
       }
 
-      if (line.startsWith('#')) {
+      if (
+        line.startsWith('#')
+        /* TODO/eventually: implement.
+        || line.startsWith('<h2')
+        */
+      ) {
         const { pageSectionId, pageSectionLevel, pageSectionTitle, headingHtml } = parsePageSection(line)
         pageSections.push({ pageSectionId, pageSectionLevel, pageSectionTitle })
         return headingHtml

package/tsconfig.config.json

@@ -1,6 +1,6 @@
 {
   "extends": "./tsconfig.json",
-  "include": ["vite.config.ts", "+config.ts"],
+  "files": ["vite.config.ts", "+config.ts"],
   "compilerOptions": {
     "outDir": "./dist/"
   }