@dreamlake/dockit 0.2.29 → 0.2.30

package/dist/components/TOC.js

@@ -3,6 +3,7 @@ import { useState, useRef, useEffect, useMemo } from "react";
 import { usePageContext } from "vike-react/usePageContext";
 import { normalizePath, findPage } from "../lib/navigation.js";
 import { siteConfig } from "../site-config.js";
+import { useHiddenToggle } from "../lib/use-hidden-toggle.js";
 const TOC_KEY_PREFIX = "toc-collapsed:";
 const X0 = 4;
 const X_INDENT_H3 = 12;
@@ -52,19 +53,21 @@ function scrollToHeading(e, id) {
 function TOC() {
   const { urlPathname } = usePageContext();
   const currentPath = normalizePath(urlPathname);
+  const [showDeveloperLinks] = useHiddenToggle();
   const mdHref = (() => {
     const meta = findPage(urlPathname);
     if (!meta || meta.noindex) return null;
     return currentPath === "/" ? "/index.md" : `${currentPath}.md`;
   })();
   const editHref = (() => {
+    if (!showDeveloperLinks || !siteConfig.docsRepoUrl) return null;
     const meta = findPage(urlPathname);
     if (!meta) return null;
     const slug = currentPath === "/" ? "index" : currentPath.replace(/^\//, "");
     const pagesPath = siteConfig.docsPagesPath ?? "docs/pages";
-    return `${siteConfig.docsRepoUrl}/edit/${siteConfig.docsBranch}/${pagesPath}/${slug}/+Page.mdx`;
+    return `${siteConfig.docsRepoUrl}/edit/${encodeURIComponent(siteConfig.docsBranch)}/${pagesPath}/${slug}/+Page.mdx`;
   })();
-  const issueHref = `${siteConfig.docsRepoUrl}/issues/new`;
+  const issueHref = showDeveloperLinks && siteConfig.docsRepoUrl ? `${siteConfig.docsRepoUrl}/issues/new` : null;
   const [headings, setHeadings] = useState([]);
   const [endPos, setEndPos] = useState(null);
   const [pathD, setPathD] = useState("");
@@ -643,7 +646,7 @@ function TOC() {
                   children: "Edit this page"
                 }
               ),
-              /* @__PURE__ */ jsx(
+              issueHref && /* @__PURE__ */ jsx(
                 "a",
                 {
                   href: issueHref,

package/dist/components/Topbar.js

@@ -38,6 +38,7 @@ const SEARCH_INSET = `max(${SEARCH_GUTTER}px, calc((100vw - ${SEARCH_MAX_W}px) /
 function Topbar({ searchOpen, onOpenSearch, onCloseSearch, query, setQuery }) {
   const { urlPathname } = usePageContext();
   const current = findPage(urlPathname);
+  const [showDeveloperLinks] = useHiddenToggle();
   const hasTabs = TABS.length > 0;
   const activeTab = internalTabs().find((t) => t.id === tabForUrl(urlPathname));
   const versionChips = activeTab?.versionChips ?? siteConfig.versionChips ?? [];
@@ -353,7 +354,7 @@ function Topbar({ searchOpen, onOpenSearch, onCloseSearch, query, setQuery }) {
                 },
                 chip.label
               )),
-              siteConfig.gitHash && /* @__PURE__ */ jsxs(
+              showDeveloperLinks && siteConfig.gitHash && /* @__PURE__ */ jsxs(
                 "span",
                 {
                   className: "hidden md:inline-flex items-center text-doc-template-muted border border-doc-template-faint",
@@ -553,7 +554,7 @@ function Topbar({ searchOpen, onOpenSearch, onCloseSearch, query, setQuery }) {
             className: "flex items-stretch gap-2.5 md:gap-3.5 pr-[14px] md:pr-[22px]",
             style: { gridColumn: 3, gridRow: 1, justifySelf: "end", ...palFade(searchOpen) },
             children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3.5", children: [
-              siteConfig.repoUrl && /* @__PURE__ */ jsx(
+              showDeveloperLinks && siteConfig.repoUrl && /* @__PURE__ */ jsx(
                 "a",
                 {
                   href: siteConfig.repoUrl,

package/dist/lib/dev-metadata-plugin.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from 'vite';
+/** Encode shell metadata before bundling; never include original-source maps. */
+export declare function devMetadataPlugin(): Plugin;

package/dist/lib/dev-metadata-plugin.js

@@ -0,0 +1,81 @@
+import { transformWithEsbuild } from "vite";
+const fields = /* @__PURE__ */ new Set(["repoUrl", "docsRepoUrl", "docsBranch", "docsPagesPath", "gitHash"]);
+function staticString(node) {
+  if (node.type === "Literal" && typeof node.value === "string") return node.value;
+  if (node.type === "TemplateLiteral") {
+    const parts = node.quasis;
+    const expressions = node.expressions;
+    let value = parts[0].value.cooked;
+    for (let i = 0; i < expressions.length; i++) {
+      const part = staticString(expressions[i]);
+      if (part === null) return null;
+      value += part + parts[i + 1].value.cooked;
+    }
+    return value;
+  }
+  return null;
+}
+function devMetadataPlugin() {
+  let define = {};
+  return {
+    name: "dockit-dev-metadata",
+    enforce: "pre",
+    apply: "build",
+    configResolved(config) {
+      define = Object.fromEntries(Object.entries(config.define ?? {}).map(([key, value]) => [
+        key,
+        typeof value === "string" ? value : JSON.stringify(value)
+      ]));
+      if (config.build.sourcemap) {
+        throw new Error("Dockit developer metadata requires build.sourcemap: false");
+      }
+    },
+    async transform(source, id) {
+      if (!/(?:^|\/)site\.config\.[cm]?[jt]s$/.test(id)) return null;
+      const compiled = await transformWithEsbuild(source, id, {
+        loader: "ts",
+        target: "esnext",
+        define,
+        sourcemap: false,
+        legalComments: "none"
+      });
+      const edits = [];
+      const visit = (node) => {
+        if (node.type === "Property") {
+          const key = node.key;
+          const name = key.type === "Identifier" && !node.computed ? key.name : key.value;
+          if (typeof name === "string" && fields.has(name)) {
+            const value = node.value;
+            const text = staticString(value);
+            if (text === null) {
+              this.error(`Dockit ${name} must be a string literal or a build-time define in ${id}`);
+            }
+            const bytes = Array.from({ length: text.length }, (_, i) => text.charCodeAt(i) ^ 90);
+            edits.push({
+              start: value.start,
+              end: value.end,
+              text: `[${bytes.join(",")}].map(n=>String.fromCharCode(n^90)).join("")`
+            });
+            return;
+          }
+        }
+        for (const value of Object.values(node)) {
+          if (Array.isArray(value)) {
+            for (const item of value) if (item?.type) visit(item);
+          } else if (value && typeof value === "object" && "type" in value) {
+            visit(value);
+          }
+        }
+      };
+      visit(this.parse(compiled.code));
+      let code = compiled.code;
+      for (const edit of edits.sort((a, b) => b.start - a.start)) {
+        code = code.slice(0, edit.start) + edit.text + code.slice(edit.end);
+      }
+      return { code, map: { mappings: "" } };
+    }
+  };
+}
+export {
+  devMetadataPlugin
+};

package/dist/vite.js

@@ -1,4 +1,5 @@
 import { mdxFrontmatterLoader } from "./lib/mdx-frontmatter-loader.js";
+import { devMetadataPlugin } from "./lib/dev-metadata-plugin.js";
 import { readFile } from "node:fs/promises";
 import react from "@vitejs/plugin-react";
 import vike from "vike/plugin";
@@ -30,6 +31,7 @@ function mdxRawLoader() {
 }
 function dockit() {
   return [
+    devMetadataPlugin(),
     tailwindcss(),
     mdxRawLoader(),
     mdxFrontmatterLoader(),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dreamlake/dockit",
-  "version": "0.2.29",
-  "description": "The DreamLake documentation shell — Vike + React + Tailwind v4 + MDX docs framework with sidebar, TOC, search, and theming",
+  "version": "0.2.30",
+  "description": "The DreamLake documentation shell \u2014 Vike + React + Tailwind v4 + MDX docs framework with sidebar, TOC, search, and theming",
   "license": "MIT",
   "type": "module",
   "files": [
@@ -38,6 +38,11 @@
     },
     "./styles.css": "./dist/styles.css"
   },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test tests/*.test.mjs"
+  },
   "peerDependencies": {
     "@mdx-js/react": ">=3.0.0",
     "react": ">=19.0.0",
@@ -80,10 +85,5 @@
     "vike-react": "^0.5.0",
     "vite": "^7.0.0",
     "vite-plugin-dts": "^4.3.0"
-  },
-  "scripts": {
-    "build": "vite build",
-    "typecheck": "tsc --noEmit",
-    "test": "node --test tests/*.test.mjs"
   }
-}
+}